@callstack/brownfield-cli 3.13.2 → 3.15.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @callstack/brownfield-cli
 
+## 3.15.0
+
+## 3.14.0
+
+### Minor Changes
+
+- [#360](https://github.com/callstack/react-native-brownfield/pull/360) [`10ff597`](https://github.com/callstack/react-native-brownfield/commit/10ff597c057c04aa093b4e5ae8c5334b169d3d56) Thanks [@adamTrz](https://github.com/adamTrz)! - Expo SDK 56 support
+
 ## 3.13.2
 
 ### Patch Changes

package/dist/brownfield/commands/packageIos.d.ts

@@ -1,6 +1,7 @@
 import { Command } from 'commander';
 import { ExampleUsage } from '../../shared/index.js';
 export declare function parseUsePrebuiltRnCoreArgument(value: string | boolean): boolean;
+export declare function parseUsePrebuiltExpoArgument(value: string | boolean): boolean;
 export declare const packageIosCommand: Command;
 export declare const packageIosExample: ExampleUsage;
 //# sourceMappingURL=packageIos.d.ts.map

package/dist/brownfield/commands/packageIos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packageIos.d.ts","sourceRoot":"","sources":["../../../src/brownfield/commands/packageIos.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAM5C,OAAO,EAGL,YAAY,EACb,MAAM,uBAAuB,CAAC;AAiB/B,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,GAAG,OAAO,GACtB,OAAO,CAcT;AAcD,eAAO,MAAM,iBAAiB,SAqQ3B,CAAC;AAEJ,eAAO,MAAM,iBAAiB,cAG7B,CAAC"}
+{"version":3,"file":"packageIos.d.ts","sourceRoot":"","sources":["../../../src/brownfield/commands/packageIos.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAO5C,OAAO,EAGL,YAAY,EACb,MAAM,uBAAuB,CAAC;AA4C/B,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,GAAG,OAAO,GACtB,OAAO,CAET;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GAAG,OAAO,GACtB,OAAO,CAET;AAcD,eAAO,MAAM,iBAAiB,SA8R3B,CAAC;AAEJ,eAAO,MAAM,iBAAiB,cAG7B,CAAC"}

package/dist/brownfield/commands/packageIos.js

@@ -7,6 +7,7 @@ import { Command, Option } from 'commander';
 import { runExpoPrebuildIfNeeded } from '../utils/expo.js';
 import { findProjectRoot } from '../utils/paths.js';
 import { getProjectInfo } from '../utils/project.js';
+import { supportsPrebuiltExpo } from '../utils/supportsPrebuiltExpo.js';
 import { supportsPrebuiltRNCore } from '../utils/supportsPrebuiltRNCore.js';
 import { actionRunner, curryOptions, ExampleUsage, } from '../../shared/index.js';
 import { runBrownieCodegenIfApplicable } from '../../brownie/helpers/runBrownieCodegenIfApplicable.js';
@@ -15,13 +16,19 @@ import { copyDebugBundleToSimulatorSlice } from '../utils/copyDebugBundleToSimul
 import { resolvePackagedFrameworkName } from '../utils/resolvePackagedFrameworkName.js';
 import { stripFrameworkBinary } from '../utils/stripFrameworkBinary.js';
 import { createLocalSpmPackage } from '../utils/createLocalSpmPackage.js';
+import { emitExpoSupportXcframeworks } from '../utils/emitExpoSupportXcframeworks.js';
 import { mergeBrownfieldConfigWithOptions } from '../../config.js';
+import { removeCodeSignatureArtifacts } from '../utils/normalizeCopiedXcframework.js';
 /** Help text for `--use-prebuilt-rn-core` (keep in sync with docs/docs/docs/getting-started/ios.mdx, "React Native Prebuilts" section). */
 const USE_PREBUILT_RN_CORE_HELP = 'Whether the Xcode build for packaging should use React Native Apple prebuilt binaries (via CocoaPods). ' +
     'If you omit this flag, Brownfield follows version-aware defaults: for React Native 0.84 and newer, prebuilts are enabled by default; for RN 0.83, they are disabled unless you opt in. ' +
     'Pass true or false to force either behavior. Use the flag without a value as shorthand for true (same as `--use-prebuilt-rn-core true`). ' +
     'See the Brownfield iOS guide for details: https://oss.callstack.com/react-native-brownfield/docs/getting-started/ios#react-native-prebuilts';
-export function parseUsePrebuiltRnCoreArgument(value) {
+/** Help text for `--use-prebuilt-expo`. */
+const USE_PREBUILT_EXPO_HELP = 'Whether the Xcode build for packaging should use prebuilt Expo support XCFrameworks. ' +
+    'If you omit this flag, Brownfield follows version-aware defaults for supported Expo projects. ' +
+    'Pass true or false to force either behavior. Use the flag without a value as shorthand for true (same as `--use-prebuilt-expo true`).';
+function parseBooleanOptionArgument(flagName, value) {
     if (typeof value === 'boolean') {
         return value;
     }
@@ -32,7 +39,13 @@ export function parseUsePrebuiltRnCoreArgument(value) {
     if (normalized === 'false' || normalized === '0') {
         return false;
     }
-    throw new RockError(`Invalid value for --use-prebuilt-rn-core: expected true or false, received "${value}"`);
+    throw new RockError(`Invalid value for ${flagName}: expected true or false, received "${value}"`);
+}
+export function parseUsePrebuiltRnCoreArgument(value) {
+    return parseBooleanOptionArgument('--use-prebuilt-rn-core', value);
+}
+export function parseUsePrebuiltExpoArgument(value) {
+    return parseBooleanOptionArgument('--use-prebuilt-expo', value);
 }
 function getPackagedFrameworkResolutionFailureMessage({ resolution, candidates, }) {
     return resolution === 'ambiguous'
@@ -49,6 +62,9 @@ export const packageIosCommand = curryOptions(new Command('package:ios').descrip
     .addOption(new Option('--use-prebuilt-rn-core [bool]', USE_PREBUILT_RN_CORE_HELP)
     .preset(true)
     .argParser(parseUsePrebuiltRnCoreArgument))
+    .addOption(new Option('--use-prebuilt-expo [bool]', USE_PREBUILT_EXPO_HELP)
+    .preset(true)
+    .argParser(parseUsePrebuiltExpoArgument))
     .addOption(new Option('--add-spm-package', 'Generate a local Swift Package Manager manifest next to the packaged XCFramework outputs'))
     .action(actionRunner(async (cliOptions) => {
     const options = mergeBrownfieldConfigWithOptions(cliOptions, 'ios');
@@ -56,10 +72,15 @@ export const packageIosCommand = curryOptions(new Command('package:ios').descrip
     await runExpoPrebuildIfNeeded({ projectRoot, platform: 'ios' });
     const { platformConfig, userConfig } = getProjectInfo('ios');
     const prebuiltRNCoreSupport = supportsPrebuiltRNCore({ projectRoot });
+    const prebuiltExpoSupport = supportsPrebuiltExpo({ projectRoot });
     // version-aware default when the flag is omitted (see ios.mdx "React Native Prebuilts")
     options.usePrebuiltRnCore ??= prebuiltRNCoreSupport.supported
         ? prebuiltRNCoreSupport.enabledByDefault
         : false;
+    // version-aware default when the flag is omitted
+    options.usePrebuiltExpo ??= prebuiltExpoSupport.supported
+        ? prebuiltExpoSupport.enabledByDefault
+        : false;
     if (prebuiltRNCoreSupport) {
         logger.info(`${options.usePrebuiltRnCore ? 'Using' : 'Not using'} prebuilt RN core`);
         if (!prebuiltRNCoreSupport.enabledByDefault &&
@@ -70,6 +91,9 @@ export const packageIosCommand = curryOptions(new Command('package:ios').descrip
     if (options.usePrebuiltRnCore && !prebuiltRNCoreSupport.supported) {
         throw new RockError(prebuiltRNCoreSupport.reason);
     }
+    if (options.usePrebuiltExpo && !prebuiltExpoSupport.supported) {
+        throw new RockError(prebuiltExpoSupport.reason);
+    }
     if (!userConfig.project.ios) {
         throw new Error('iOS project not found.');
     }
@@ -106,6 +130,11 @@ export const packageIosCommand = curryOptions(new Command('package:ios').descrip
         skipCache: true, // cache is dependent on existence of Rock config file
         usePrebuiltRNCore: options.usePrebuiltRnCore,
     }, platformConfig);
+    emitExpoSupportXcframeworks({
+        projectRoot,
+        packageDir,
+        usePrebuiltExpo: options.usePrebuiltExpo,
+    });
     const productsPath = path.join(options.buildFolder, 'Build', 'Products');
     const { frameworkName, resolution, candidates } = resolvePackagedFrameworkName({
         explicitScheme: options.scheme,
@@ -178,10 +207,12 @@ export const packageIosCommand = curryOptions(new Command('package:ios').descrip
         stripFrameworkBinary(brownfieldNavigationOutputPath);
         logger.success(`BrownfieldNavigation.xcframework created at ${colorLink(relativeToCwd(brownfieldNavigationOutputPath))}`);
     }
+    removeCodeSignatureArtifacts(packageDir);
     if (options.addSpmPackage) {
         const { packageManifestPath } = createLocalSpmPackage({
             packageDir,
             frameworkName: frameworkName ?? undefined,
+            usePrebuiltExpo: options.usePrebuiltExpo,
         });
         logger.success(`Local SPM package manifest created at ${colorLink(relativeToCwd(packageManifestPath))}`);
         logger.info(`Add the local package folder in Xcode: ${colorLink(relativeToCwd(packageDir))}`);

package/dist/brownfield/utils/createLocalSpmPackage.d.ts

@@ -1,10 +1,11 @@
 type CreateLocalSpmPackageOptions = {
     packageDir: string;
     frameworkName?: string;
+    usePrebuiltExpo?: boolean;
 };
 type CreateLocalSpmPackageResult = {
     packageManifestPath: string;
 };
-export declare function createLocalSpmPackage({ packageDir, frameworkName, }: CreateLocalSpmPackageOptions): CreateLocalSpmPackageResult;
+export declare function createLocalSpmPackage({ packageDir, frameworkName, usePrebuiltExpo, }: CreateLocalSpmPackageOptions): CreateLocalSpmPackageResult;
 export {};
 //# sourceMappingURL=createLocalSpmPackage.d.ts.map

package/dist/brownfield/utils/createLocalSpmPackage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createLocalSpmPackage.d.ts","sourceRoot":"","sources":["../../../src/brownfield/utils/createLocalSpmPackage.ts"],"names":[],"mappings":"AAQA,KAAK,4BAA4B,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAuJF,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,EACV,aAAa,GACd,EAAE,4BAA4B,GAAG,2BAA2B,CAsC5D"}
+{"version":3,"file":"createLocalSpmPackage.d.ts","sourceRoot":"","sources":["../../../src/brownfield/utils/createLocalSpmPackage.ts"],"names":[],"mappings":"AAYA,KAAK,4BAA4B,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AA0JF,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,EACV,aAAa,EACb,eAAsB,GACvB,EAAE,4BAA4B,GAAG,2BAA2B,CA2C5D"}

package/dist/brownfield/utils/createLocalSpmPackage.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { prepareLocalSpmArtifacts, SPM_ARTIFACTS_DIR_NAME, } from './prepareLocalSpmArtifacts.js';
+import { ALL_EXPO_SUPPORT_XCFRAMEWORK_NAMES, getExpoSupportXcframeworkNames, } from './emitExpoSupportXcframeworks.js';
 const RESERVED_FRAMEWORK_NAMES = new Set([
     'hermes',
     'hermesvm',
@@ -9,6 +10,7 @@ const RESERVED_FRAMEWORK_NAMES = new Set([
     'BrownfieldNavigation',
     'React',
     'ReactNativeDependencies',
+    ...ALL_EXPO_SUPPORT_XCFRAMEWORK_NAMES,
 ]);
 function requireXcframework(packageDir, name) {
     const xcframeworkPath = path.join(packageDir, `${name}.xcframework`);
@@ -71,7 +73,9 @@ ${binaryTargets}
 `;
 }
 function renderReadme({ packageName, libraryName, targetNames, }) {
-    const frameworks = targetNames.map((targetName) => `- \`${targetName}\``).join('\n');
+    const frameworks = targetNames
+        .map((targetName) => `- \`${targetName}\``)
+        .join('\n');
     return `# ${packageName}
 
 This is a generated local Swift Package Manager package for the packaged React Native brownfield artifacts.
@@ -103,14 +107,16 @@ If Xcode builds your host app but the simulator installation fails, check the ho
 This folder is generated by \`brownfield package:ios --add-spm-package\`. Re-run that command whenever the packaged XCFrameworks change so this package stays in sync.
 `;
 }
-export function createLocalSpmPackage({ packageDir, frameworkName, }) {
+export function createLocalSpmPackage({ packageDir, frameworkName, usePrebuiltExpo = true, }) {
     const resolvedFrameworkName = resolveAppFrameworkName(packageDir, frameworkName);
+    const expoSupportXcframeworkNames = getExpoSupportXcframeworkNames(usePrebuiltExpo);
     const targetNames = [
         resolvedFrameworkName,
         requireHermesXcframework(packageDir),
         requireXcframework(packageDir, 'ReactBrownfield'),
         optionalXcframework(packageDir, 'Brownie'),
         optionalXcframework(packageDir, 'BrownfieldNavigation'),
+        ...expoSupportXcframeworkNames.map((frameworkName) => optionalXcframework(packageDir, frameworkName)),
         optionalXcframework(packageDir, 'React'),
         optionalXcframework(packageDir, 'ReactNativeDependencies'),
     ].filter((targetName) => targetName !== null);

package/dist/brownfield/utils/emitExpoSupportXcframeworks.d.ts

@@ -0,0 +1,9 @@
+export declare const EXPO_SUPPORT_XCFRAMEWORK_NAMES: readonly ["ExpoModulesJSI", "ExpoFileSystem", "ExpoFont", "ExpoModulesCore", "ExpoImage", "ExpoModulesWorklets"];
+export declare const ALL_EXPO_SUPPORT_XCFRAMEWORK_NAMES: readonly ["ExpoModulesJSI", "ExpoFileSystem", "ExpoFont", "ExpoModulesCore", "ExpoImage", "ExpoModulesWorklets", "SDWebImage", "SDWebImageSVGCoder", "SDWebImageWebPCoder", "SDWebImageAVIFCoder", "libavif"];
+export declare function getExpoSupportXcframeworkNames(usePrebuiltExpo: boolean): readonly ["ExpoModulesJSI", "ExpoFileSystem", "ExpoFont", "ExpoModulesCore", "ExpoImage", "ExpoModulesWorklets", "SDWebImage", "SDWebImageSVGCoder", "SDWebImageWebPCoder", "SDWebImageAVIFCoder", "libavif"] | readonly ["ExpoModulesJSI"];
+export declare function emitExpoSupportXcframeworks({ projectRoot, packageDir, usePrebuiltExpo, }: {
+    projectRoot: string;
+    packageDir: string;
+    usePrebuiltExpo?: boolean;
+}): boolean;
+//# sourceMappingURL=emitExpoSupportXcframeworks.d.ts.map

package/dist/brownfield/utils/emitExpoSupportXcframeworks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitExpoSupportXcframeworks.d.ts","sourceRoot":"","sources":["../../../src/brownfield/utils/emitExpoSupportXcframeworks.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,8BAA8B,kHAOjC,CAAC;AAEX,eAAO,MAAM,kCAAkC,+MAGrC,CAAC;AAEX,wBAAgB,8BAA8B,CAAC,eAAe,EAAE,OAAO,+OAItE;AA8CD,wBAAgB,2BAA2B,CAAC,EAC1C,WAAW,EACX,UAAU,EACV,eAAsB,GACvB,EAAE;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,WAkCA"}

package/dist/brownfield/utils/emitExpoSupportXcframeworks.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { RockError } from '@rock-js/tools';
+import { normalizeCopiedXcframework } from './normalizeCopiedXcframework.js';
+import { getExpoSdkMajor, isExpoProject } from './project.js';
+import { MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO } from './supportsPrebuiltExpo.js';
+/**
+ * Swift support XCFrameworks
+ *
+ * These are required for the Expo Image module to work.
+ *
+ * TODO: This needs investigation and maybe a discussion with the Expo team.
+ */
+const SWIFT_SUPPORT_XCFRAMEWORK_NAMES = [
+    'SDWebImage',
+    'SDWebImageSVGCoder',
+    'SDWebImageWebPCoder',
+    'SDWebImageAVIFCoder',
+    'libavif',
+];
+export const EXPO_SUPPORT_XCFRAMEWORK_NAMES = [
+    'ExpoModulesJSI',
+    'ExpoFileSystem',
+    'ExpoFont',
+    'ExpoModulesCore',
+    'ExpoImage',
+    'ExpoModulesWorklets'
+];
+export const ALL_EXPO_SUPPORT_XCFRAMEWORK_NAMES = [
+    ...EXPO_SUPPORT_XCFRAMEWORK_NAMES,
+    ...SWIFT_SUPPORT_XCFRAMEWORK_NAMES,
+];
+export function getExpoSupportXcframeworkNames(usePrebuiltExpo) {
+    return usePrebuiltExpo
+        ? ALL_EXPO_SUPPORT_XCFRAMEWORK_NAMES
+        : ['ExpoModulesJSI'];
+}
+function resolveExpoFrameworkSourcePath(projectRoot, frameworkName) {
+    if (frameworkName === 'ExpoModulesJSI') {
+        return path.join(projectRoot, 'node_modules', 'expo-modules-jsi', 'apple', 'Products', 'ExpoModulesJSI.xcframework');
+    }
+    if (SWIFT_SUPPORT_XCFRAMEWORK_NAMES.includes(frameworkName)) {
+        return path.join(projectRoot, 'ios', 'Pods', 'ExpoImage', `${frameworkName}.xcframework`);
+    }
+    if (EXPO_SUPPORT_XCFRAMEWORK_NAMES.includes(frameworkName)) {
+        return path.join(projectRoot, 'ios', 'Pods', frameworkName, `${frameworkName}.xcframework`);
+    }
+    throw new RockError(`Unsupported Expo XCFramework: ${frameworkName}`);
+}
+export function emitExpoSupportXcframeworks({ projectRoot, packageDir, usePrebuiltExpo = true, }) {
+    if (!isExpoProject(projectRoot)) {
+        return false;
+    }
+    const expoSdkMajor = getExpoSdkMajor(projectRoot);
+    if (expoSdkMajor === null ||
+        expoSdkMajor < MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO) {
+        return false;
+    }
+    for (const frameworkName of getExpoSupportXcframeworkNames(usePrebuiltExpo)) {
+        const sourcePath = resolveExpoFrameworkSourcePath(projectRoot, frameworkName);
+        if (!fs.existsSync(sourcePath)) {
+            throw new RockError(`Expected Expo SDK ${MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO}+ XCFramework not found: ${frameworkName}.xcframework at ${path.relative(projectRoot, sourcePath)}`);
+        }
+        const destinationPath = path.join(packageDir, `${frameworkName}.xcframework`);
+        fs.rmSync(destinationPath, { recursive: true, force: true });
+        fs.cpSync(sourcePath, destinationPath, { recursive: true });
+        normalizeCopiedXcframework(destinationPath);
+    }
+    return true;
+}

package/dist/brownfield/utils/normalizeCopiedXcframework.d.ts

@@ -0,0 +1,3 @@
+export declare function removeCodeSignatureArtifacts(dirPath: string): void;
+export declare function normalizeCopiedXcframework(xcframeworkPath: string): void;
+//# sourceMappingURL=normalizeCopiedXcframework.d.ts.map

package/dist/brownfield/utils/normalizeCopiedXcframework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeCopiedXcframework.d.ts","sourceRoot":"","sources":["../../../src/brownfield/utils/normalizeCopiedXcframework.ts"],"names":[],"mappings":"AAIA,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,QAkB3D;AAyCD,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,QA0BjE"}

package/dist/brownfield/utils/normalizeCopiedXcframework.js

@@ -0,0 +1,64 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+export function removeCodeSignatureArtifacts(dirPath) {
+    for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
+        const entryPath = path.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === '_CodeSignature') {
+                fs.rmSync(entryPath, { recursive: true, force: true });
+                continue;
+            }
+            removeCodeSignatureArtifacts(entryPath);
+            continue;
+        }
+        if (entry.name === 'CodeResources') {
+            fs.rmSync(entryPath, { force: true });
+        }
+    }
+}
+function resolveFrameworkExecutablePath(frameworkDir, frameworkName) {
+    const directExecutablePath = path.join(frameworkDir, frameworkName);
+    if (fs.existsSync(directExecutablePath)) {
+        return directExecutablePath;
+    }
+    const versionedExecutablePath = path.join(frameworkDir, 'Versions', 'Current', frameworkName);
+    if (fs.existsSync(versionedExecutablePath)) {
+        return versionedExecutablePath;
+    }
+    return null;
+}
+function removeExecutableSignature(executablePath) {
+    try {
+        execFileSync('codesign', ['--remove-signature', executablePath], {
+            stdio: 'pipe',
+        });
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            error.message.includes('code object is not signed at all')) {
+            return;
+        }
+        throw error;
+    }
+}
+export function normalizeCopiedXcframework(xcframeworkPath) {
+    removeCodeSignatureArtifacts(xcframeworkPath);
+    for (const sliceName of fs.readdirSync(xcframeworkPath)) {
+        const slicePath = path.join(xcframeworkPath, sliceName);
+        if (!fs.statSync(slicePath).isDirectory()) {
+            continue;
+        }
+        for (const entry of fs.readdirSync(slicePath)) {
+            if (!entry.endsWith('.framework')) {
+                continue;
+            }
+            const frameworkName = path.basename(entry, '.framework');
+            const frameworkDir = path.join(slicePath, entry);
+            const executablePath = resolveFrameworkExecutablePath(frameworkDir, frameworkName);
+            if (executablePath) {
+                removeExecutableSignature(executablePath);
+            }
+        }
+    }
+}

package/dist/brownfield/utils/prepareLocalSpmArtifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepareLocalSpmArtifacts.d.ts","sourceRoot":"","sources":["../../../src/brownfield/utils/prepareLocalSpmArtifacts.ts"],"names":[],"mappings":"AAIA,KAAK,+BAA+B,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AAyFtD,wBAAgB,wBAAwB,CAAC,EACvC,UAAU,EACV,WAAW,GACZ,EAAE,+BAA+B,UAejC"}
+{"version":3,"file":"prepareLocalSpmArtifacts.d.ts","sourceRoot":"","sources":["../../../src/brownfield/utils/prepareLocalSpmArtifacts.ts"],"names":[],"mappings":"AAKA,KAAK,+BAA+B,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AAEtD,wBAAgB,wBAAwB,CAAC,EACvC,UAAU,EACV,WAAW,GACZ,EAAE,+BAA+B,UAkBjC"}

package/dist/brownfield/utils/prepareLocalSpmArtifacts.js

@@ -1,68 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { execFileSync } from 'node:child_process';
+import { normalizeCopiedXcframework } from './normalizeCopiedXcframework.js';
 export const SPM_ARTIFACTS_DIR_NAME = 'spm-artifacts';
-function removeCodeSignatureArtifacts(dirPath) {
-    for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
-        const entryPath = path.join(dirPath, entry.name);
-        if (entry.isDirectory()) {
-            if (entry.name === '_CodeSignature') {
-                fs.rmSync(entryPath, { recursive: true, force: true });
-                continue;
-            }
-            removeCodeSignatureArtifacts(entryPath);
-            continue;
-        }
-        if (entry.name === 'CodeResources') {
-            fs.rmSync(entryPath, { force: true });
-        }
-    }
-}
-function resolveFrameworkExecutablePath(frameworkDir, frameworkName) {
-    const directExecutablePath = path.join(frameworkDir, frameworkName);
-    if (fs.existsSync(directExecutablePath)) {
-        return directExecutablePath;
-    }
-    const versionedExecutablePath = path.join(frameworkDir, 'Versions', 'Current', frameworkName);
-    if (fs.existsSync(versionedExecutablePath)) {
-        return versionedExecutablePath;
-    }
-    return null;
-}
-function removeExecutableSignature(executablePath) {
-    try {
-        execFileSync('codesign', ['--remove-signature', executablePath], {
-            stdio: 'pipe',
-        });
-    }
-    catch (error) {
-        if (error instanceof Error &&
-            error.message.includes('code object is not signed at all')) {
-            return;
-        }
-        throw error;
-    }
-}
-function normalizeCopiedXcframeworkSignature(xcframeworkPath) {
-    removeCodeSignatureArtifacts(xcframeworkPath);
-    for (const sliceName of fs.readdirSync(xcframeworkPath)) {
-        const slicePath = path.join(xcframeworkPath, sliceName);
-        if (!fs.statSync(slicePath).isDirectory()) {
-            continue;
-        }
-        for (const entry of fs.readdirSync(slicePath)) {
-            if (!entry.endsWith('.framework')) {
-                continue;
-            }
-            const frameworkName = path.basename(entry, '.framework');
-            const frameworkDir = path.join(slicePath, entry);
-            const executablePath = resolveFrameworkExecutablePath(frameworkDir, frameworkName);
-            if (executablePath) {
-                removeExecutableSignature(executablePath);
-            }
-        }
-    }
-}
 export function prepareLocalSpmArtifacts({ packageDir, targetNames, }) {
     const spmArtifactsDir = path.join(packageDir, SPM_ARTIFACTS_DIR_NAME);
     fs.rmSync(spmArtifactsDir, { recursive: true, force: true });
@@ -71,7 +10,7 @@ export function prepareLocalSpmArtifacts({ packageDir, targetNames, }) {
         const sourcePath = path.join(packageDir, `${targetName}.xcframework`);
         const destinationPath = path.join(spmArtifactsDir, `${targetName}.xcframework`);
         fs.renameSync(sourcePath, destinationPath);
-        normalizeCopiedXcframeworkSignature(destinationPath);
+        normalizeCopiedXcframework(destinationPath);
     }
     return spmArtifactsDir;
 }

package/dist/brownfield/utils/supportsPrebuiltExpo.d.ts

@@ -0,0 +1,14 @@
+export declare const MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO = 56;
+export type PrebuiltExpoSupportResult = {
+    supported: true;
+    enabledByDefault: boolean;
+    reason?: never;
+} | {
+    supported: false;
+    enabledByDefault?: never;
+    reason: string;
+};
+export declare function supportsPrebuiltExpo({ projectRoot, }: {
+    projectRoot: string;
+}): PrebuiltExpoSupportResult;
+//# sourceMappingURL=supportsPrebuiltExpo.d.ts.map

package/dist/brownfield/utils/supportsPrebuiltExpo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportsPrebuiltExpo.d.ts","sourceRoot":"","sources":["../../../src/brownfield/utils/supportsPrebuiltExpo.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAEvD,MAAM,MAAM,yBAAyB,GACjC;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GAC9D;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,wBAAgB,oBAAoB,CAAC,EACnC,WAAW,GACZ,EAAE;IACD,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,yBAAyB,CAqB5B"}

package/dist/brownfield/utils/supportsPrebuiltExpo.js

@@ -0,0 +1,20 @@
+import { getExpoSdkMajor, isExpoProject } from './project.js';
+export const MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO = 56;
+export function supportsPrebuiltExpo({ projectRoot, }) {
+    if (!isExpoProject(projectRoot)) {
+        return { supported: true, enabledByDefault: false };
+    }
+    const expoSdkMajor = getExpoSdkMajor(projectRoot);
+    if (expoSdkMajor === null ||
+        expoSdkMajor < MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO) {
+        const sdkLabel = expoSdkMajor === null ? 'unknown' : String(expoSdkMajor);
+        return {
+            supported: false,
+            reason: `--use-prebuilt-expo is unsupported in Expo SDK ${sdkLabel}: packaging brownfield with Expo prebuilts requires Expo SDK ${MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO} or newer.`,
+        };
+    }
+    return {
+        supported: true,
+        enabledByDefault: true,
+    };
+}

package/dist/types.d.ts

@@ -23,6 +23,8 @@ export type BrownieConfig = {
 export type PackageIosOptions = Omit<AppleBuildFlags, 'archive' | 'local'> & {
     /** Set when `--use-prebuilt-rn-core` is passed; omitted when the flag is absent (Rock applies RN version defaults). */
     usePrebuiltRnCore?: boolean;
+    /** Set when `--use-prebuilt-expo` is passed; omitted when the flag is absent (Rock applies Expo version defaults). */
+    usePrebuiltExpo?: boolean;
     /** When set, generate a local Swift Package Manager manifest next to the packaged XCFramework outputs. */
     addSpmPackage?: boolean;
 };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAErF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1C,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC;IAC5C;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG;IAC3E,uHAAuH;IACvH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,0GAA0G;IAC1G,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,uBAAuB,GACnE,OAAO,CAAC,eAAe,CAAC,CAAC;AAC3B,MAAM,MAAM,+BAA+B,GAAG,uBAAuB,GACnE,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAChC,MAAM,MAAM,2BAA2B,GAAG,uBAAuB,GAC/D,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;IAE1D;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,EACxD,MAAM,uBAAuB,CAC9B,GAAG;IACF;;OAEG;IACH,IAAI,CAAC,EAAE,2BAA2B,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,OAAO,CAAC,iBAAiB,CAAC,EAC1B,MAAM,uBAAuB,CAC9B,GAAG;IACF;;OAEG;IACH,IAAI,CAAC,EAAE,uBAAuB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,GACrD,uBAAuB,GACvB,OAAO,CAAC;IACN;;OAEG;IACH,OAAO,EAAE,uBAAuB,CAAC;IAEjC;;OAEG;IACH,GAAG,EAAE,mBAAmB,CAAC;IAEzB;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAErF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1C,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC;IAC5C;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG;IAC3E,uHAAuH;IACvH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,sHAAsH;IACtH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,0GAA0G;IAC1G,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,uBAAuB,GACnE,OAAO,CAAC,eAAe,CAAC,CAAC;AAC3B,MAAM,MAAM,+BAA+B,GAAG,uBAAuB,GACnE,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAChC,MAAM,MAAM,2BAA2B,GAAG,uBAAuB,GAC/D,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;IAE1D;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,EACxD,MAAM,uBAAuB,CAC9B,GAAG;IACF;;OAEG;IACH,IAAI,CAAC,EAAE,2BAA2B,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,OAAO,CAAC,iBAAiB,CAAC,EAC1B,MAAM,uBAAuB,CAC9B,GAAG;IACF;;OAEG;IACH,IAAI,CAAC,EAAE,uBAAuB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,GACrD,uBAAuB,GACvB,OAAO,CAAC;IACN;;OAEG;IACH,OAAO,EAAE,uBAAuB,CAAC;IAEjC;;OAEG;IACH,GAAG,EAAE,mBAAmB,CAAC;IAEzB;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callstack/brownfield-cli",
-  "version": "3.13.2",
+  "version": "3.15.0",
   "license": "MIT",
   "author": "Artur Morys-Magiera <artus9033@gmail.com>",
   "bin": {
@@ -88,11 +88,11 @@
     "@expo/config": "^12.0.13",
     "@react-native-community/cli-config": "^20.0.0",
     "@react-native-community/cli-config-android": "^20.0.0",
-    "@rock-js/platform-android": "^0.13.5",
-    "@rock-js/platform-apple-helpers": "^0.13.5",
-    "@rock-js/plugin-brownfield-android": "^0.13.5",
-    "@rock-js/plugin-brownfield-ios": "^0.13.5",
-    "@rock-js/tools": "^0.13.5",
+    "@rock-js/platform-android": "^0.14.0",
+    "@rock-js/platform-apple-helpers": "^0.14.0",
+    "@rock-js/plugin-brownfield-android": "^0.14.0",
+    "@rock-js/plugin-brownfield-ios": "^0.14.0",
+    "@rock-js/tools": "^0.14.0",
     "ajv": "^8.20.0",
     "commander": "^14.0.3",
     "quicktype-core": "^23.2.6",

package/schema.json

@@ -170,6 +170,10 @@
           "description": "Xcode target to use.",
           "type": "string"
         },
+        "usePrebuiltExpo": {
+          "description": "Set when `--use-prebuilt-expo` is passed; omitted when the flag is absent (Rock applies Expo version defaults).",
+          "type": "boolean"
+        },
         "usePrebuiltRnCore": {
           "description": "Set when `--use-prebuilt-rn-core` is passed; omitted when the flag is absent (Rock applies RN version defaults).",
           "type": "boolean"

package/src/brownfield/commands/packageIos.ts

@@ -19,6 +19,7 @@ import { Command, Option } from 'commander';
 import { runExpoPrebuildIfNeeded } from '../utils/expo.js';
 import { findProjectRoot } from '../utils/paths.js';
 import { getProjectInfo } from '../utils/project.js';
+import { supportsPrebuiltExpo } from '../utils/supportsPrebuiltExpo.js';
 import { supportsPrebuiltRNCore } from '../utils/supportsPrebuiltRNCore.js';
 import {
   actionRunner,
@@ -32,7 +33,9 @@ import { resolvePackagedFrameworkName } from '../utils/resolvePackagedFrameworkN
 import { stripFrameworkBinary } from '../utils/stripFrameworkBinary.js';
 import type { PackageIosOptions } from '../../types.js';
 import { createLocalSpmPackage } from '../utils/createLocalSpmPackage.js';
+import { emitExpoSupportXcframeworks } from '../utils/emitExpoSupportXcframeworks.js';
 import { mergeBrownfieldConfigWithOptions } from '../../config.js';
+import { removeCodeSignatureArtifacts } from '../utils/normalizeCopiedXcframework.js';
 
 /** Help text for `--use-prebuilt-rn-core` (keep in sync with docs/docs/docs/getting-started/ios.mdx, "React Native Prebuilts" section). */
 const USE_PREBUILT_RN_CORE_HELP =
@@ -41,7 +44,14 @@ const USE_PREBUILT_RN_CORE_HELP =
   'Pass true or false to force either behavior. Use the flag without a value as shorthand for true (same as `--use-prebuilt-rn-core true`). ' +
   'See the Brownfield iOS guide for details: https://oss.callstack.com/react-native-brownfield/docs/getting-started/ios#react-native-prebuilts';
 
-export function parseUsePrebuiltRnCoreArgument(
+/** Help text for `--use-prebuilt-expo`. */
+const USE_PREBUILT_EXPO_HELP =
+  'Whether the Xcode build for packaging should use prebuilt Expo support XCFrameworks. ' +
+  'If you omit this flag, Brownfield follows version-aware defaults for supported Expo projects. ' +
+  'Pass true or false to force either behavior. Use the flag without a value as shorthand for true (same as `--use-prebuilt-expo true`).';
+
+function parseBooleanOptionArgument(
+  flagName: string,
   value: string | boolean
 ): boolean {
   if (typeof value === 'boolean') {
@@ -55,10 +65,22 @@ export function parseUsePrebuiltRnCoreArgument(
     return false;
   }
   throw new RockError(
-    `Invalid value for --use-prebuilt-rn-core: expected true or false, received "${value}"`
+    `Invalid value for ${flagName}: expected true or false, received "${value}"`
   );
 }
 
+export function parseUsePrebuiltRnCoreArgument(
+  value: string | boolean
+): boolean {
+  return parseBooleanOptionArgument('--use-prebuilt-rn-core', value);
+}
+
+export function parseUsePrebuiltExpoArgument(
+  value: string | boolean
+): boolean {
+  return parseBooleanOptionArgument('--use-prebuilt-expo', value);
+}
+
 function getPackagedFrameworkResolutionFailureMessage({
   resolution,
   candidates,
@@ -89,6 +111,11 @@ export const packageIosCommand = curryOptions(
       .preset(true)
       .argParser(parseUsePrebuiltRnCoreArgument)
   )
+  .addOption(
+    new Option('--use-prebuilt-expo [bool]', USE_PREBUILT_EXPO_HELP)
+      .preset(true)
+      .argParser(parseUsePrebuiltExpoArgument)
+  )
   .addOption(
     new Option(
       '--add-spm-package',
@@ -105,12 +132,18 @@ export const packageIosCommand = curryOptions(
       const { platformConfig, userConfig } = getProjectInfo('ios');
 
       const prebuiltRNCoreSupport = supportsPrebuiltRNCore({ projectRoot });
+      const prebuiltExpoSupport = supportsPrebuiltExpo({ projectRoot });
 
       // version-aware default when the flag is omitted (see ios.mdx "React Native Prebuilts")
       options.usePrebuiltRnCore ??= prebuiltRNCoreSupport.supported
         ? prebuiltRNCoreSupport.enabledByDefault
         : false;
 
+        // version-aware default when the flag is omitted
+      options.usePrebuiltExpo ??= prebuiltExpoSupport.supported
+        ? prebuiltExpoSupport.enabledByDefault
+        : false;
+
       if (prebuiltRNCoreSupport) {
         logger.info(
           `${options.usePrebuiltRnCore ? 'Using' : 'Not using'} prebuilt RN core`
@@ -130,6 +163,10 @@ export const packageIosCommand = curryOptions(
         throw new RockError(prebuiltRNCoreSupport.reason);
       }
 
+      if (options.usePrebuiltExpo && !prebuiltExpoSupport.supported) {
+        throw new RockError(prebuiltExpoSupport.reason);
+      }
+
       if (!userConfig.project.ios) {
         throw new Error('iOS project not found.');
       }
@@ -184,6 +221,12 @@ export const packageIosCommand = curryOptions(
         platformConfig
       );
 
+      emitExpoSupportXcframeworks({
+        projectRoot,
+        packageDir,
+        usePrebuiltExpo: options.usePrebuiltExpo,
+      });
+
       const productsPath = path.join(options.buildFolder, 'Build', 'Products');
       const { frameworkName, resolution, candidates } =
         resolvePackagedFrameworkName({
@@ -244,6 +287,7 @@ export const packageIosCommand = curryOptions(
         packageDir,
         'ReactBrownfield.xcframework'
       );
+
       if (fs.existsSync(reactBrownfieldXcframeworkPath)) {
         // Strip the binary from ReactBrownfield.xcframework to make it interface-only.
         // This avoids duplicate symbols when consumer apps embed both BrownfieldLib
@@ -315,10 +359,13 @@ export const packageIosCommand = curryOptions(
         );
       }
 
+      removeCodeSignatureArtifacts(packageDir);
+
       if (options.addSpmPackage) {
         const { packageManifestPath } = createLocalSpmPackage({
           packageDir,
           frameworkName: frameworkName ?? undefined,
+          usePrebuiltExpo: options.usePrebuiltExpo,
         });
 
         logger.success(

package/src/brownfield/utils/createLocalSpmPackage.ts

@@ -5,10 +5,15 @@ import {
   prepareLocalSpmArtifacts,
   SPM_ARTIFACTS_DIR_NAME,
 } from './prepareLocalSpmArtifacts.js';
+import {
+  ALL_EXPO_SUPPORT_XCFRAMEWORK_NAMES,
+  getExpoSupportXcframeworkNames,
+} from './emitExpoSupportXcframeworks.js';
 
 type CreateLocalSpmPackageOptions = {
   packageDir: string;
   frameworkName?: string;
+  usePrebuiltExpo?: boolean;
 };
 
 type CreateLocalSpmPackageResult = {
@@ -23,6 +28,7 @@ const RESERVED_FRAMEWORK_NAMES = new Set([
   'BrownfieldNavigation',
   'React',
   'ReactNativeDependencies',
+  ...ALL_EXPO_SUPPORT_XCFRAMEWORK_NAMES,
 ]);
 
 function requireXcframework(packageDir: string, name: string) {
@@ -130,7 +136,9 @@ function renderReadme({
   libraryName: string;
   targetNames: string[];
 }) {
-  const frameworks = targetNames.map((targetName) => `- \`${targetName}\``).join('\n');
+  const frameworks = targetNames
+    .map((targetName) => `- \`${targetName}\``)
+    .join('\n');
 
   return `# ${packageName}
 
@@ -167,17 +175,23 @@ This folder is generated by \`brownfield package:ios --add-spm-package\`. Re-run
 export function createLocalSpmPackage({
   packageDir,
   frameworkName,
+  usePrebuiltExpo = true,
 }: CreateLocalSpmPackageOptions): CreateLocalSpmPackageResult {
   const resolvedFrameworkName = resolveAppFrameworkName(
     packageDir,
     frameworkName
   );
+  const expoSupportXcframeworkNames =
+    getExpoSupportXcframeworkNames(usePrebuiltExpo);
   const targetNames = [
     resolvedFrameworkName,
     requireHermesXcframework(packageDir),
     requireXcframework(packageDir, 'ReactBrownfield'),
     optionalXcframework(packageDir, 'Brownie'),
     optionalXcframework(packageDir, 'BrownfieldNavigation'),
+    ...expoSupportXcframeworkNames.map((frameworkName) =>
+      optionalXcframework(packageDir, frameworkName)
+    ),
     optionalXcframework(packageDir, 'React'),
     optionalXcframework(packageDir, 'ReactNativeDependencies'),
   ].filter((targetName): targetName is string => targetName !== null);

package/src/brownfield/utils/emitExpoSupportXcframeworks.ts

@@ -0,0 +1,132 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { RockError } from '@rock-js/tools';
+
+import { normalizeCopiedXcframework } from './normalizeCopiedXcframework.js';
+import { getExpoSdkMajor, isExpoProject } from './project.js';
+
+import { MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO } from './supportsPrebuiltExpo.js';
+
+/**
+ * Swift support XCFrameworks
+ *
+ * These are required for the Expo Image module to work.
+ * 
+ * TODO: This needs investigation and maybe a discussion with the Expo team.
+ */
+const SWIFT_SUPPORT_XCFRAMEWORK_NAMES = [
+  'SDWebImage',
+  'SDWebImageSVGCoder',
+  'SDWebImageWebPCoder',
+  'SDWebImageAVIFCoder',
+  'libavif',
+] as const;
+
+export const EXPO_SUPPORT_XCFRAMEWORK_NAMES = [
+  'ExpoModulesJSI',
+  'ExpoFileSystem',
+  'ExpoFont',
+  'ExpoModulesCore',
+  'ExpoImage',
+  'ExpoModulesWorklets'
+] as const;
+
+export const ALL_EXPO_SUPPORT_XCFRAMEWORK_NAMES = [
+  ...EXPO_SUPPORT_XCFRAMEWORK_NAMES,
+  ...SWIFT_SUPPORT_XCFRAMEWORK_NAMES,
+] as const;
+
+export function getExpoSupportXcframeworkNames(usePrebuiltExpo: boolean) {
+  return usePrebuiltExpo
+    ? ALL_EXPO_SUPPORT_XCFRAMEWORK_NAMES
+    : (['ExpoModulesJSI'] as const);
+}
+
+type SwiftSupportXcframeworkName =
+  (typeof SWIFT_SUPPORT_XCFRAMEWORK_NAMES)[number];
+
+type ExpoSupportXcframeworkName =
+  (typeof EXPO_SUPPORT_XCFRAMEWORK_NAMES)[number];
+
+function resolveExpoFrameworkSourcePath(
+  projectRoot: string,
+  frameworkName: SwiftSupportXcframeworkName | ExpoSupportXcframeworkName
+) {
+  if (frameworkName === 'ExpoModulesJSI') {
+    return path.join(
+      projectRoot,
+      'node_modules',
+      'expo-modules-jsi',
+      'apple',
+      'Products',
+      'ExpoModulesJSI.xcframework'
+    );
+  }
+
+  if (SWIFT_SUPPORT_XCFRAMEWORK_NAMES.includes(frameworkName as SwiftSupportXcframeworkName)) {
+    return path.join(
+      projectRoot,
+      'ios',
+      'Pods',
+      'ExpoImage',
+      `${frameworkName}.xcframework`
+    );
+  }
+
+  if (EXPO_SUPPORT_XCFRAMEWORK_NAMES.includes(frameworkName as ExpoSupportXcframeworkName)) {
+    return path.join(
+      projectRoot,
+      'ios',
+      'Pods',
+      frameworkName,
+      `${frameworkName}.xcframework`
+    );
+  }
+
+  throw new RockError(`Unsupported Expo XCFramework: ${frameworkName}`);
+}
+
+export function emitExpoSupportXcframeworks({
+  projectRoot,
+  packageDir,
+  usePrebuiltExpo = true,
+}: {
+  projectRoot: string;
+  packageDir: string;
+  usePrebuiltExpo?: boolean;
+}) {
+  if (!isExpoProject(projectRoot)) {
+    return false;
+  }
+
+  const expoSdkMajor = getExpoSdkMajor(projectRoot);
+  if (
+    expoSdkMajor === null ||
+    expoSdkMajor < MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO
+  ) {
+    return false;
+  }
+
+  for (const frameworkName of getExpoSupportXcframeworkNames(usePrebuiltExpo)) {
+    const sourcePath = resolveExpoFrameworkSourcePath(
+      projectRoot,
+      frameworkName
+    );
+    if (!fs.existsSync(sourcePath)) {
+      throw new RockError(
+        `Expected Expo SDK ${MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO}+ XCFramework not found: ${frameworkName}.xcframework at ${path.relative(projectRoot, sourcePath)}`
+      );
+    }
+
+    const destinationPath = path.join(
+      packageDir,
+      `${frameworkName}.xcframework`
+    );
+    fs.rmSync(destinationPath, { recursive: true, force: true });
+    fs.cpSync(sourcePath, destinationPath, { recursive: true });
+    normalizeCopiedXcframework(destinationPath);
+  }
+
+  return true;
+}

package/src/brownfield/utils/normalizeCopiedXcframework.ts

@@ -0,0 +1,90 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+
+export function removeCodeSignatureArtifacts(dirPath: string) {
+  for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
+    const entryPath = path.join(dirPath, entry.name);
+
+    if (entry.isDirectory()) {
+      if (entry.name === '_CodeSignature') {
+        fs.rmSync(entryPath, { recursive: true, force: true });
+        continue;
+      }
+
+      removeCodeSignatureArtifacts(entryPath);
+      continue;
+    }
+
+    if (entry.name === 'CodeResources') {
+      fs.rmSync(entryPath, { force: true });
+    }
+  }
+}
+
+function resolveFrameworkExecutablePath(
+  frameworkDir: string,
+  frameworkName: string
+) {
+  const directExecutablePath = path.join(frameworkDir, frameworkName);
+  if (fs.existsSync(directExecutablePath)) {
+    return directExecutablePath;
+  }
+
+  const versionedExecutablePath = path.join(
+    frameworkDir,
+    'Versions',
+    'Current',
+    frameworkName
+  );
+  if (fs.existsSync(versionedExecutablePath)) {
+    return versionedExecutablePath;
+  }
+
+  return null;
+}
+
+function removeExecutableSignature(executablePath: string) {
+  try {
+    execFileSync('codesign', ['--remove-signature', executablePath], {
+      stdio: 'pipe',
+    });
+  } catch (error) {
+    if (
+      error instanceof Error &&
+      error.message.includes('code object is not signed at all')
+    ) {
+      return;
+    }
+
+    throw error;
+  }
+}
+
+export function normalizeCopiedXcframework(xcframeworkPath: string) {
+  removeCodeSignatureArtifacts(xcframeworkPath);
+
+  for (const sliceName of fs.readdirSync(xcframeworkPath)) {
+    const slicePath = path.join(xcframeworkPath, sliceName);
+    if (!fs.statSync(slicePath).isDirectory()) {
+      continue;
+    }
+
+    for (const entry of fs.readdirSync(slicePath)) {
+      if (!entry.endsWith('.framework')) {
+        continue;
+      }
+
+      const frameworkName = path.basename(entry, '.framework');
+      const frameworkDir = path.join(slicePath, entry);
+      const executablePath = resolveFrameworkExecutablePath(
+        frameworkDir,
+        frameworkName
+      );
+
+      if (executablePath) {
+        removeExecutableSignature(executablePath);
+      }
+    }
+  }
+}

package/src/brownfield/utils/prepareLocalSpmArtifacts.ts

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { execFileSync } from 'node:child_process';
+
+import { normalizeCopiedXcframework } from './normalizeCopiedXcframework.js';
 
 type PrepareLocalSpmArtifactsOptions = {
   packageDir: string;
@@ -9,93 +10,6 @@ type PrepareLocalSpmArtifactsOptions = {
 
 export const SPM_ARTIFACTS_DIR_NAME = 'spm-artifacts';
 
-function removeCodeSignatureArtifacts(dirPath: string) {
-  for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
-    const entryPath = path.join(dirPath, entry.name);
-
-    if (entry.isDirectory()) {
-      if (entry.name === '_CodeSignature') {
-        fs.rmSync(entryPath, { recursive: true, force: true });
-        continue;
-      }
-
-      removeCodeSignatureArtifacts(entryPath);
-      continue;
-    }
-
-    if (entry.name === 'CodeResources') {
-      fs.rmSync(entryPath, { force: true });
-    }
-  }
-}
-
-function resolveFrameworkExecutablePath(
-  frameworkDir: string,
-  frameworkName: string
-) {
-  const directExecutablePath = path.join(frameworkDir, frameworkName);
-  if (fs.existsSync(directExecutablePath)) {
-    return directExecutablePath;
-  }
-
-  const versionedExecutablePath = path.join(
-    frameworkDir,
-    'Versions',
-    'Current',
-    frameworkName
-  );
-  if (fs.existsSync(versionedExecutablePath)) {
-    return versionedExecutablePath;
-  }
-
-  return null;
-}
-
-function removeExecutableSignature(executablePath: string) {
-  try {
-    execFileSync('codesign', ['--remove-signature', executablePath], {
-      stdio: 'pipe',
-    });
-  } catch (error) {
-    if (
-      error instanceof Error &&
-      error.message.includes('code object is not signed at all')
-    ) {
-      return;
-    }
-
-    throw error;
-  }
-}
-
-function normalizeCopiedXcframeworkSignature(xcframeworkPath: string) {
-  removeCodeSignatureArtifacts(xcframeworkPath);
-
-  for (const sliceName of fs.readdirSync(xcframeworkPath)) {
-    const slicePath = path.join(xcframeworkPath, sliceName);
-    if (!fs.statSync(slicePath).isDirectory()) {
-      continue;
-    }
-
-    for (const entry of fs.readdirSync(slicePath)) {
-      if (!entry.endsWith('.framework')) {
-        continue;
-      }
-
-      const frameworkName = path.basename(entry, '.framework');
-      const frameworkDir = path.join(slicePath, entry);
-      const executablePath = resolveFrameworkExecutablePath(
-        frameworkDir,
-        frameworkName
-      );
-
-      if (executablePath) {
-        removeExecutableSignature(executablePath);
-      }
-    }
-  }
-}
-
 export function prepareLocalSpmArtifacts({
   packageDir,
   targetNames,
@@ -107,10 +21,13 @@ export function prepareLocalSpmArtifacts({
 
   for (const targetName of targetNames) {
     const sourcePath = path.join(packageDir, `${targetName}.xcframework`);
-    const destinationPath = path.join(spmArtifactsDir, `${targetName}.xcframework`);
+    const destinationPath = path.join(
+      spmArtifactsDir,
+      `${targetName}.xcframework`
+    );
 
     fs.renameSync(sourcePath, destinationPath);
-    normalizeCopiedXcframeworkSignature(destinationPath);
+    normalizeCopiedXcframework(destinationPath);
   }
 
   return spmArtifactsDir;

package/src/brownfield/utils/supportsPrebuiltExpo.ts

@@ -0,0 +1,34 @@
+import { getExpoSdkMajor, isExpoProject } from './project.js';
+
+export const MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO = 56;
+
+export type PrebuiltExpoSupportResult =
+  | { supported: true; enabledByDefault: boolean; reason?: never }
+  | { supported: false; enabledByDefault?: never; reason: string };
+
+export function supportsPrebuiltExpo({
+  projectRoot,
+}: {
+  projectRoot: string;
+}): PrebuiltExpoSupportResult {
+  if (!isExpoProject(projectRoot)) {
+    return { supported: true, enabledByDefault: false };
+  }
+
+  const expoSdkMajor = getExpoSdkMajor(projectRoot);
+  if (
+    expoSdkMajor === null ||
+    expoSdkMajor < MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO
+  ) {
+    const sdkLabel = expoSdkMajor === null ? 'unknown' : String(expoSdkMajor);
+    return {
+      supported: false,
+      reason: `--use-prebuilt-expo is unsupported in Expo SDK ${sdkLabel}: packaging brownfield with Expo prebuilts requires Expo SDK ${MIN_EXPO_SDK_MAJOR_FOR_PREBUILT_EXPO} or newer.`,
+    };
+  }
+
+  return {
+    supported: true,
+    enabledByDefault: true,
+  };
+}

package/src/types.ts

@@ -33,6 +33,9 @@ export type PackageIosOptions = Omit<AppleBuildFlags, 'archive' | 'local'> & {
   /** Set when `--use-prebuilt-rn-core` is passed; omitted when the flag is absent (Rock applies RN version defaults). */
   usePrebuiltRnCore?: boolean;
 
+  /** Set when `--use-prebuilt-expo` is passed; omitted when the flag is absent (Rock applies Expo version defaults). */
+  usePrebuiltExpo?: boolean;
+
   /** When set, generate a local Swift Package Manager manifest next to the packaged XCFramework outputs. */
   addSpmPackage?: boolean;
 };