callstackincubator · thymikee · Jan 12, 2026 · Jan 7, 2026 · Jan 9, 2026 · Jan 9, 2026
diff --git a/.changeset/itchy-nails-visit.md b/.changeset/itchy-nails-visit.md
@@ -0,0 +1,5 @@
+---
+'@rock-js/platform-apple-helpers': patch
+---
+
+fix: debug logs in mergeFrameworks not showing path to removed framework before writing merge output
diff --git a/.changeset/itchy-spoons-trade.md b/.changeset/itchy-spoons-trade.md
@@ -0,0 +1,6 @@
+---
+'@rock-js/plugin-brownfield-android': patch
+'@rock-js/plugin-brownfield-ios': patch
+---
+
+feat: expose logic of brownfield plugin actions
diff --git a/.github/pr-labeler.yml b/.github/pr-labeler.yml
@@ -3,4 +3,4 @@
 'release: bug fix':
   - '/^fix/'
 'release: breaking change':
-  - '/^breaking/'
+  - '/^breaking/'
diff --git a/packages/cli/README.md b/packages/cli/README.md
@@ -32,7 +32,7 @@ Choose your path based on your current situation:
 
 ### Creating a new project
 
-> [!TIP] 
+> [!TIP]
 > For **new projects**, we recommend starting with [Expo](https://expo.dev) for the best developer experience and similar remote caching capabilities. Rock is designed for teams who have outgrown the Community CLI.
 
 To create a fresh React Native app with Rock, open a terminal and run:

diff --git a/packages/cli/src/lib/plugins/fingerprint.ts b/packages/cli/src/lib/plugins/fingerprint.ts
@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import { performance } from 'node:perf_hooks';
 import type { PluginApi } from '@rock-js/config';
-import type { FingerprintInputHash, FingerprintSources } from '@rock-js/tools';
+import type { FingerprintInputHash, FingerprintOptions } from '@rock-js/tools';
 import {
   color,
   intro,
@@ -39,7 +39,7 @@ type NativeFingerprintCommandOptions = {
 
 export async function nativeFingerprintCommand(
   path: string,
-  { extraSources, ignorePaths, env }: FingerprintSources,
+  { extraSources, ignorePaths, env }: FingerprintOptions,
   options: NativeFingerprintCommandOptions,
 ) {
   validateOptions(options);

diff --git a/packages/cli/src/lib/plugins/remoteCache.ts b/packages/cli/src/lib/plugins/remoteCache.ts
@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import type { PluginApi, PluginOutput } from '@rock-js/config';
-import type { FingerprintSources, RemoteBuildCache } from '@rock-js/tools';
+import type { FingerprintOptions, RemoteBuildCache } from '@rock-js/tools';
 import {
   color,
   colorLink,
@@ -48,7 +48,7 @@ async function remoteCache({
   args: Flags;
   remoteCacheProvider: null | (() => RemoteBuildCache);
   projectRoot: string;
-  fingerprintOptions: FingerprintSources;
+  fingerprintOptions: FingerprintOptions;
 }) {
   const isJsonOutput = args.json;
   if (!remoteCacheProvider) {

diff --git a/packages/config/src/lib/config.ts b/packages/config/src/lib/config.ts
@@ -2,7 +2,7 @@ import * as fs from 'node:fs';
 import { createRequire } from 'node:module';
 import * as path from 'node:path';
 import { pathToFileURL } from 'node:url';
-import type { FingerprintSources, RemoteBuildCache } from '@rock-js/tools';
+import type { FingerprintOptions, RemoteBuildCache } from '@rock-js/tools';
 import { colorLink, getReactNativeVersion, logger } from '@rock-js/tools';
 import type { ValidationError } from 'joi';
 import { ConfigTypeSchema } from './schema.js';
@@ -54,7 +54,7 @@ export type PluginApi = {
   getRemoteCacheProvider: () => Promise<
     null | undefined | (() => RemoteBuildCache)
   >;
-  getFingerprintOptions: () => FingerprintSources;
+  getFingerprintOptions: () => FingerprintOptions;
   getBundlerStart: () => ({ args }: { args: DevServerArgs }) => void;
   getUsePrebuiltRNCore: () => number | undefined;
 };
@@ -103,7 +103,7 @@ export type ConfigType = {
     ignorePaths?: string[];
     env?: string[];
   };
-  usePrebuiltRNCore?: number,
+  usePrebuiltRNCore?: number;
 };
 
 export type ConfigOutput = {
@@ -219,7 +219,7 @@ Read more: ${colorLink('https://rockjs.dev/docs/configuration#github-actions-pro
       return validatedConfig.remoteCacheProvider;
     },
     getFingerprintOptions: () =>
-      validatedConfig.fingerprint as FingerprintSources,
+      validatedConfig.fingerprint as FingerprintOptions,
     getBundlerStart:
       () =>
       ({ args }: { args: DevServerArgs }) => {

diff --git a/packages/create-app/src/lib/utils/__tests__/initInExistingProject.test.ts b/packages/create-app/src/lib/utils/__tests__/initInExistingProject.test.ts
@@ -2,7 +2,7 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { cleanup, getTempDirectory, writeFiles } from '@rock-js/test-helpers';
 import * as tools from '@rock-js/tools';
-import { updateAndroidBuildGradle } from "../initInExistingProject.js";
+import { updateAndroidBuildGradle } from '../initInExistingProject.js';
 
 const directory = getTempDirectory('test_updateAndroidBuildGradle');
 
@@ -61,15 +61,23 @@ describe('updateAndroidBuildGradle', () => {
     },
   ];
 
-  it.each(workingCases)('should update the Android build.gradle file when $name', ({ content, expected }) => {
-    const files = {
-      'android/app/build.gradle': content,
-    };
-    writeFiles(directory, files);
-    updateAndroidBuildGradle(directory, 'android');
-
-    expect(fs.readFileSync(path.join(directory, 'android/app/build.gradle'), 'utf8')).toStrictEqual(expected)
-  });
+  it.each(workingCases)(
+    'should update the Android build.gradle file when $name',
+    ({ content, expected }) => {
+      const files = {
+        'android/app/build.gradle': content,
+      };
+      writeFiles(directory, files);
+      updateAndroidBuildGradle(directory, 'android');
+
+      expect(
+        fs.readFileSync(
+          path.join(directory, 'android/app/build.gradle'),
+          'utf8',
+        ),
+      ).toStrictEqual(expected);
+    },
+  );
 
   it('should not update the Android build.gradle file when cliFile is already set', () => {
     const content = `
@@ -84,7 +92,9 @@ describe('updateAndroidBuildGradle', () => {
     writeFiles(directory, files);
     updateAndroidBuildGradle(directory, 'android');
 
-    expect(fs.readFileSync(path.join(directory, 'android/app/build.gradle'), 'utf8')).toStrictEqual(content)
+    expect(
+      fs.readFileSync(path.join(directory, 'android/app/build.gradle'), 'utf8'),
+    ).toStrictEqual(content);
   });
 
   it('should display a warning when unable to update the Android build.gradle file', () => {
@@ -101,10 +111,12 @@ describe('updateAndroidBuildGradle', () => {
     writeFiles(directory, files);
     updateAndroidBuildGradle(directory, 'android');
 
-    expect(fs.readFileSync(path.join(directory, 'android/app/build.gradle'), 'utf8')).toStrictEqual(content)
+    expect(
+      fs.readFileSync(path.join(directory, 'android/app/build.gradle'), 'utf8'),
+    ).toStrictEqual(content);
 
     expect(warn).toHaveBeenCalledWith(
-      expect.stringContaining('Unable to update')
-    )
+      expect.stringContaining('Unable to update'),
+    );
   });
 });
diff --git a/packages/platform-android/src/index.ts b/packages/platform-android/src/index.ts
@@ -5,6 +5,7 @@ export {
   options as packageAarOptions,
 } from './lib/commands/aar/packageAar.js';
 export {
+  type PublishLocalAarFlags,
   publishLocalAar,
   options as publishLocalAarOptions,
 } from './lib/commands/aar/publishLocalAar.js';
diff --git a/packages/platform-android/src/lib/commands/aar/packageAar.ts b/packages/platform-android/src/lib/commands/aar/packageAar.ts
@@ -1,3 +1,4 @@
+import type { RockCLIOptions } from '@rock-js/tools';
 import { outro } from '@rock-js/tools';
 import { runGradleAar } from '../runGradle.js';
 import { toPascalCase } from '../toPascalCase.js';
@@ -12,35 +13,24 @@ export type PackageAarFlags = {
   moduleName?: string;
 };
 
-export async function packageAar(
-  aarProject: AarProject,
-  args: PackageAarFlags,
-) {
-  normalizeArgs(args);
+export async function packageAar(aarProject: AarProject, variant: string) {
+  normalizeVariant(variant);
+  const tasks = [`assemble${toPascalCase(variant)}`];
 
-  const tasks = [`assemble${toPascalCase(args.variant)}`];
-
-  await runGradleAar({ tasks, aarProject, variant: args.variant });
+  await runGradleAar({ tasks, aarProject, variant });
   outro('Success 🎉.');
 }
 
-export async function localPublishAar(
-  aarProject: AarProject,
-  args: PackageAarFlags,
-) {
+export async function localPublishAar(aarProject: AarProject, variant: string) {
   const tasks = ['publishToMavenLocal'];
 
-  await runGradleAar({
-    tasks,
-    aarProject,
-    variant: args.variant,
-  });
+  await runGradleAar({ tasks, aarProject, variant });
   outro('Success 🎉.');
 }
 
-function normalizeArgs(args: PackageAarFlags) {
-  if (!args.variant) {
-    args.variant = 'debug';
+function normalizeVariant(variant: string) {
+  if (!variant) {
+    variant = 'debug';
   }
 }
 
@@ -54,4 +44,4 @@ export const options = [
     name: '--module-name <string>',
     description: 'AAR module name',
   },
-];
+] satisfies RockCLIOptions;
diff --git a/packages/platform-android/src/lib/commands/aar/publishLocalAar.ts b/packages/platform-android/src/lib/commands/aar/publishLocalAar.ts
@@ -1,7 +1,12 @@
+import type { RockCLIOptions } from '@rock-js/tools';
 import { outro } from '@rock-js/tools';
 import { runGradleAar } from '../runGradle.js';
 import type { AarProject } from './packageAar.js';
 
+export type PublishLocalAarFlags = {
+  moduleName?: string;
+};
+
 export async function publishLocalAar(aarProject: AarProject) {
   const tasks = ['publishToMavenLocal'];
 
@@ -17,4 +22,4 @@ export const options = [
     name: '--module-name <string>',
     description: 'AAR module name',
   },
-];
+] satisfies RockCLIOptions;
diff --git a/packages/platform-android/src/lib/commands/buildAndroid/buildAndroid.ts b/packages/platform-android/src/lib/commands/buildAndroid/buildAndroid.ts
@@ -1,8 +1,8 @@
 import type { AndroidProjectConfig } from '@react-native-community/cli-types';
-import type { RemoteBuildCache } from '@rock-js/tools';
+import type { RemoteBuildCache, RockCLIOptions } from '@rock-js/tools';
 import {
   colorLink,
-  type FingerprintSources,
+  type FingerprintOptions,
   formatArtifactName,
   getBinaryPath,
   logger,
@@ -28,7 +28,7 @@ export async function buildAndroid(
   args: BuildFlags,
   projectRoot: string,
   remoteCacheProvider: null | (() => RemoteBuildCache) | undefined,
-  fingerprintOptions: FingerprintSources,
+  fingerprintOptions: FingerprintOptions,
 ) {
   normalizeArgs(args);
   // Use assemble task by default, but bundle if the flag is set
@@ -104,4 +104,4 @@ export const options = [
     name: '--local',
     description: 'Force local build with Gradle wrapper.',
   },
-];
+] satisfies RockCLIOptions;
diff --git a/packages/platform-android/src/lib/commands/runAndroid/__tests__/runAndroid.test.ts b/packages/platform-android/src/lib/commands/runAndroid/__tests__/runAndroid.test.ts
@@ -313,7 +313,7 @@ test.each([['release'], ['debug'], ['staging']])(
       { ...args, variant },
       '/',
       undefined,
-      { extraSources: [], ignorePaths: [], env: [] },
+      { extraSources: [], ignorePaths: [], env: [], platform: 'android' },
       vi.fn(), // startDevServer mock
       '/path/to/react-native', // reactNativePath
       '0.79.0', // reactNativeVersion
@@ -365,7 +365,7 @@ test('runAndroid runs gradle build with custom --appId, --appIdSuffix and --main
     },
     '/',
     undefined,
-    { extraSources: [], ignorePaths: [], env: [] },
+    { extraSources: [], ignorePaths: [], env: [], platform: 'android' },
     vi.fn(), // startDevServer mock
     '/path/to/react-native', // reactNativePath
     '0.79.0', // reactNativeVersion
@@ -395,7 +395,7 @@ test('runAndroid fails to launch an app on not-connected device when specified w
     { ...args, device: 'emulator-5554' },
     '/',
     undefined,
-    { extraSources: [], ignorePaths: [], env: [] },
+    { extraSources: [], ignorePaths: [], env: [], platform: 'android' },
     vi.fn(), // startDevServer mock
     '/path/to/react-native', // reactNativePath
     '0.79.0', // reactNativeVersion
@@ -468,7 +468,7 @@ test.each([['release'], ['debug']])(
       { ...args, device: 'emulator-5554', variant },
       '/',
       undefined,
-      { extraSources: [], ignorePaths: [], env: [] },
+      { extraSources: [], ignorePaths: [], env: [], platform: 'android' },
       vi.fn(), // startDevServer mock
       '/path/to/react-native', // reactNativePath
       '0.79.0', // reactNativeVersion
@@ -538,6 +538,7 @@ test('runAndroid launches an app on all connected devices', async () => {
       extraSources: [],
       ignorePaths: [],
       env: [],
+      platform: 'android',
     },
     vi.fn(),
     '/path/to/react-native',
@@ -609,7 +610,7 @@ test('runAndroid skips building when --binary-path is passed', async () => {
     },
     '/root',
     undefined,
-    { extraSources: [], ignorePaths: [], env: [] },
+    { extraSources: [], ignorePaths: [], env: [], platform: 'android' },
     vi.fn(), // startDevServer mock
     '/path/to/react-native', // reactNativePath
     '0.79.0', // reactNativeVersion

diff --git a/packages/platform-android/src/lib/commands/runAndroid/runAndroid.ts b/packages/platform-android/src/lib/commands/runAndroid/runAndroid.ts
@@ -5,7 +5,7 @@ import type {
   Config,
 } from '@react-native-community/cli-types';
 import type { StartDevServerArgs } from '@rock-js/config';
-import type { FingerprintSources, RemoteBuildCache } from '@rock-js/tools';
+import type { FingerprintOptions, RemoteBuildCache } from '@rock-js/tools';
 import {
   color,
   formatArtifactName,
@@ -50,7 +50,7 @@ export async function runAndroid(
   args: Flags,
   projectRoot: string,
   remoteCacheProvider: null | (() => RemoteBuildCache) | undefined,
-  fingerprintOptions: FingerprintSources,
+  fingerprintOptions: FingerprintOptions,
   startDevServer: (options: StartDevServerArgs) => void,
   reactNativeVersion: string,
   reactNativePath: string,

diff --git a/packages/platform-android/src/lib/commands/runAndroid/tryInstallAppOnDevice.ts b/packages/platform-android/src/lib/commands/runAndroid/tryInstallAppOnDevice.ts
@@ -20,9 +20,7 @@ export async function tryInstallAppOnDevice(
 ) {
   let deviceId: string;
   if (!device.deviceId) {
-    logger.debug(
-      `No "deviceId" for ${device}, skipping launching the app`,
-    );
+    logger.debug(`No "deviceId" for ${device}, skipping launching the app`);
     return;
   } else {
     deviceId = device.deviceId;

diff --git a/packages/platform-android/src/lib/commands/runAndroid/tryLaunchAppOnDevice.ts b/packages/platform-android/src/lib/commands/runAndroid/tryLaunchAppOnDevice.ts
@@ -11,9 +11,7 @@ export async function tryLaunchAppOnDevice(
 ) {
   let deviceId;
   if (!device.deviceId) {
-    logger.debug(
-      `No "deviceId" for ${device}, skipping launching the app`,
-    );
+    logger.debug(`No "deviceId" for ${device}, skipping launching the app`);
     return {};
   } else {
     deviceId = device.deviceId;

diff --git a/packages/platform-apple-helpers/src/lib/commands/build/createBuild.ts b/packages/platform-apple-helpers/src/lib/commands/build/createBuild.ts
@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import type { FingerprintSources, RemoteBuildCache } from '@rock-js/tools';
+import type { FingerprintOptions, RemoteBuildCache } from '@rock-js/tools';
 import {
   colorLink,
   formatArtifactName,
@@ -37,7 +37,7 @@ export const createBuild = async ({
   args: BuildFlags;
   projectRoot: string;
   reactNativePath: string;
-  fingerprintOptions: FingerprintSources;
+  fingerprintOptions: FingerprintOptions;
   remoteCacheProvider: null | (() => RemoteBuildCache) | undefined;
   usePrebuiltRNCore?: number;
 }) => {