@nx/expo 24.0.0-beta.2 → 24.0.0-beta.3

package/dist/plugins/plugin.js

@@ -63,7 +63,8 @@ function buildExpoTargets(projectRoot, options, context, pmc) {
     const namedInputs = (0, internal_1.getNamedInputs)(projectRoot, context);
     const targets = {
         [options.startTargetName]: {
-            executor: `@nx/expo:start`,
+            command: `expo start`,
+            options: { cwd: projectRoot },
             continuous: true,
         },
         [options.serveTargetName]: {
@@ -90,15 +91,18 @@ function buildExpoTargets(projectRoot, options, context, pmc) {
             outputs: [getOutputs(projectRoot, 'dist')],
         },
         [options.installTargetName]: {
-            executor: '@nx/expo:install',
+            command: `expo install`,
+            options: { cwd: projectRoot },
             continuous: false,
         },
         [options.prebuildTargetName]: {
-            executor: `@nx/expo:prebuild`,
+            command: `expo prebuild`,
+            options: { cwd: projectRoot },
             continuous: false,
         },
         [options.buildTargetName]: {
-            executor: `@nx/expo:build`,
+            command: `eas build`,
+            options: { cwd: projectRoot },
             continuous: false,
         },
         [options.submitTargetName]: {

package/dist/src/executors/install/{install.impl.d.ts → install-packages.d.ts}

@@ -1,7 +1,3 @@
 import { ExecutorContext } from '@nx/devkit';
 import { ExpoInstallOptions } from './schema';
-export interface ExpoInstallOutput {
-    success: boolean;
-}
-export default function installExecutor(options: ExpoInstallOptions, context: ExecutorContext): AsyncGenerator<ExpoInstallOutput>;
 export declare function installAndUpdatePackageJson(context: ExecutorContext, options: ExpoInstallOptions): Promise<void>;

package/dist/src/executors/install/{install.impl.js → install-packages.js}

@@ -1,26 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = installExecutor;
 exports.installAndUpdatePackageJson = installAndUpdatePackageJson;
 const devkit_1 = require("@nx/devkit");
 const path_1 = require("path");
 const sync_deps_impl_1 = require("../sync-deps/sync-deps.impl");
-const deprecation_1 = require("../../utils/deprecation");
-let childProcess;
-async function* installExecutor(options, context) {
-    (0, deprecation_1.warnExpoExecutorDeprecation)('install');
-    try {
-        await installAndUpdatePackageJson(context, options);
-        yield {
-            success: true,
-        };
-    }
-    finally {
-        if (childProcess) {
-            childProcess.kill();
-        }
-    }
-}
 async function installAndUpdatePackageJson(context, options) {
     const { installAsync } = require('@expo/cli/build/src/install/installAsync');
     const packages = typeof options.packages === 'string'

package/dist/src/executors/update/update.impl.js

@@ -6,12 +6,12 @@ const internal_1 = require("@nx/devkit/internal");
 const path_1 = require("path");
 const child_process_1 = require("child_process");
 const resolve_eas_1 = require("../../utils/resolve-eas");
-const install_impl_1 = require("../install/install.impl");
+const install_packages_1 = require("../install/install-packages");
 let childProcess;
 async function* buildExecutor(options, context) {
     const projectRoot = context.projectsConfigurations.projects[context.projectName].root;
     try {
-        await (0, install_impl_1.installAndUpdatePackageJson)(context, {
+        await (0, install_packages_1.installAndUpdatePackageJson)(context, {
             packages: ['expo-updates'],
         });
         await runCliUpdate(context.root, projectRoot, options);

package/dist/src/generators/application/application.js

@@ -20,7 +20,6 @@ const init_root_babel_config_1 = require("../../utils/init-root-babel-config");
 const versions_1 = require("../../utils/versions");
 async function expoApplicationGenerator(host, schema) {
     return await expoApplicationGeneratorInternal(host, {
-        addPlugin: false,
         useProjectJson: true,
         ...schema,
     });
@@ -28,7 +27,7 @@ async function expoApplicationGenerator(host, schema) {
 async function expoApplicationGeneratorInternal(host, schema) {
     (0, versions_1.assertSupportedExpoVersion)(host);
     const tasks = [];
-    const addTsPlugin = (0, internal_2.shouldConfigureTsSolutionSetup)(host, schema.addPlugin, schema.useTsSolution);
+    const addTsPlugin = (0, internal_2.shouldConfigureTsSolutionSetup)(host, schema.useTsSolution);
     const jsInitTask = await (0, js_1.initGenerator)(host, {
         ...schema,
         skipFormat: true,
@@ -58,7 +57,7 @@ async function expoApplicationGeneratorInternal(host, schema) {
         ],
     });
     tasks.push(lintTask);
-    const jestTask = await (0, add_jest_1.addJest)(host, options.unitTestRunner, options.projectName, options.appProjectRoot, options.js, options.skipPackageJson, options.addPlugin);
+    const jestTask = await (0, add_jest_1.addJest)(host, options.unitTestRunner, options.projectName, options.appProjectRoot, options.js, options.skipPackageJson);
     tasks.push(jestTask);
     const e2eTask = await (0, add_e2e_1.addE2e)(host, options);
     tasks.push(e2eTask);

package/dist/src/generators/application/files/base/package.json.template

@@ -21,6 +21,7 @@
     "react-native-web": "*"
   },
   "scripts": {
+    "eas-build-pre-install": "cd <%= offsetFromRoot %> && node tools/scripts/eas-build-pre-install.mjs . <%= appProjectRoot %>",
     "eas-build-post-install": "cd <%= offsetFromRoot %> && node tools/scripts/eas-build-post-install.mjs . <%= appProjectRoot %>"
   }
 }

package/dist/src/generators/application/lib/add-e2e.js

@@ -15,7 +15,7 @@ async function addE2e(tree, options) {
             targetName: 'serve-static',
         });
     }
-    const e2eWebServerInfo = await getExpoE2EWebServerInfo(tree, options.projectName, (0, devkit_1.joinPathFragments)(options.appProjectRoot, 'app.json'), options.addPlugin);
+    const e2eWebServerInfo = await getExpoE2EWebServerInfo(tree, options.projectName, (0, devkit_1.joinPathFragments)(options.appProjectRoot, 'app.json'));
     switch (options.e2eTestRunner) {
         case 'cypress': {
             const { configurationGenerator } = (0, devkit_1.ensurePackage)('@nx/cypress', versions_1.nxVersion);
@@ -98,7 +98,6 @@ async function addE2e(tree, options) {
                 webServerCommand: e2eWebServerInfo.e2eCiWebServerCommand,
                 webServerAddress: e2eWebServerInfo.e2eCiBaseUrl,
                 rootProject: options.rootProject,
-                addPlugin: options.addPlugin,
             });
             return e2eTask;
         }
@@ -120,9 +119,9 @@ async function addE2e(tree, options) {
             return () => { };
     }
 }
-async function getExpoE2EWebServerInfo(tree, projectName, configFilePath, isPluginBeingAdded) {
+async function getExpoE2EWebServerInfo(tree, projectName, configFilePath) {
     const nxJson = (0, devkit_1.readNxJson)(tree);
-    let e2ePort = isPluginBeingAdded ? 8081 : 4200;
+    let e2ePort = 8081;
     const serveTargetOptions = (0, internal_1.readTargetDefaultsForTarget)('serve', nxJson.targetDefaults)?.options;
     if (serveTargetOptions?.port) {
         e2ePort = serveTargetOptions.port;
@@ -138,5 +137,5 @@ async function getExpoE2EWebServerInfo(tree, projectName, configFilePath, isPlug
         defaultE2EWebServerAddress: `http://localhost:${e2ePort}`,
         defaultE2ECiBaseUrl: 'http://localhost:4200',
         defaultE2EPort: e2ePort,
-    }, isPluginBeingAdded);
+    });
 }

package/dist/src/generators/application/lib/add-eas-scripts.d.ts

@@ -1,2 +1,5 @@
 import type { Tree } from '@nx/devkit';
+export declare const easBuildPreInstallScriptPath = "tools/scripts/eas-build-pre-install.mjs";
+export declare const easBuildPostInstallScriptPath = "tools/scripts/eas-build-post-install.mjs";
+export declare function addEasBuildPreInstallScript(tree: Tree): void;
 export declare function addEasScripts(tree: Tree): void;

package/dist/src/generators/application/lib/add-eas-scripts.js

@@ -1,6 +1,101 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.easBuildPostInstallScriptPath = exports.easBuildPreInstallScriptPath = void 0;
+exports.addEasBuildPreInstallScript = addEasBuildPreInstallScript;
 exports.addEasScripts = addEasScripts;
+exports.easBuildPreInstallScriptPath = 'tools/scripts/eas-build-pre-install.mjs';
+exports.easBuildPostInstallScriptPath = 'tools/scripts/eas-build-post-install.mjs';
+const preInstallScript = `
+/**
+ * This script prepares an Expo app for EAS Build in a workspace without package manager workspaces.
+ * It is run as a eas-build-pre-install script in the 'package.json' of expo app.
+ * It is executed as 'node tools/scripts/eas-build-pre-install.mjs <workspace root> <project root>'
+ * It copies the root dependencies, overrides or resolutions, and lock file into the project,
+ * so EAS installs the versions pinned at the workspace root.
+ */
+
+import { copyFileSync, existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+
+const [workspaceRoot, projectRoot] = process.argv.slice(2);
+
+const lockFiles = {
+  bun: ['bun.lock', 'bun.lockb'],
+  yarn: ['yarn.lock'],
+  pnpm: ['pnpm-lock.yaml'],
+  npm: ['package-lock.json'],
+};
+
+function readJson(path) {
+  return JSON.parse(readFileSync(path, 'utf-8'));
+}
+
+function detectPackageManager() {
+  const nxJsonPath = join(workspaceRoot, 'nx.json');
+  const configured = existsSync(nxJsonPath)
+    ? readJson(nxJsonPath).cli?.packageManager
+    : undefined;
+  if (configured) {
+    return configured;
+  }
+  for (const [packageManager, files] of Object.entries(lockFiles)) {
+    if (files.some((file) => existsSync(join(workspaceRoot, file)))) {
+      return packageManager;
+    }
+  }
+  return 'npm';
+}
+
+function isWorkspacesEnabled(packageManager, rootPackageJson) {
+  if (packageManager === 'pnpm') {
+    const pnpmWorkspacePath = join(workspaceRoot, 'pnpm-workspace.yaml');
+    return (
+      existsSync(pnpmWorkspacePath) &&
+      /^["']?packages["']?\\s*:/m.test(readFileSync(pnpmWorkspacePath, 'utf-8'))
+    );
+  }
+  return !!rootPackageJson.workspaces;
+}
+
+const packageManager = detectPackageManager();
+const rootPackageJson = readJson(join(workspaceRoot, 'package.json'));
+
+if (isWorkspacesEnabled(packageManager, rootPackageJson)) {
+  console.log('Package manager workspaces are enabled, nothing to copy');
+  process.exit(0);
+}
+
+const projectPackageJsonPath = join(projectRoot, 'package.json');
+const projectPackageJson = readJson(projectPackageJsonPath);
+projectPackageJson.dependencies = rootPackageJson.dependencies;
+projectPackageJson.devDependencies = rootPackageJson.devDependencies;
+if (rootPackageJson.overrides) {
+  projectPackageJson.overrides = rootPackageJson.overrides;
+} else if (rootPackageJson.resolutions) {
+  projectPackageJson.resolutions = rootPackageJson.resolutions;
+}
+// EAS installs with a frozen lock file, and pnpm records its settings in the lock file.
+if (rootPackageJson.pnpm) {
+  projectPackageJson.pnpm = rootPackageJson.pnpm;
+}
+// Yarn Berry keys the root workspace by name in the lock file.
+if (packageManager === 'yarn') {
+  projectPackageJson.name = rootPackageJson.name;
+}
+writeFileSync(projectPackageJsonPath, JSON.stringify(projectPackageJson, null, 2));
+
+const lockFile = Object.hasOwn(lockFiles, packageManager)
+  ? lockFiles[packageManager].find((file) =>
+      existsSync(join(workspaceRoot, file))
+    )
+  : undefined;
+if (lockFile) {
+  copyFileSync(join(workspaceRoot, lockFile), join(projectRoot, lockFile));
+  console.log(\`Copied root dependencies and \${lockFile} into \${projectRoot}\`);
+} else {
+  console.log(\`Copied root dependencies into \${projectRoot}, no lock file found\`);
+}
+`;
 const postInstallScript = `
 /**
  * This script is used to patch the '@nx/expo' package to work with EAS Build.
@@ -26,9 +121,14 @@ symlink(join(projectRoot, 'node_modules'), join(workspaceRoot, 'node_modules'),
   }
 });
 `;
+function addEasBuildPreInstallScript(tree) {
+    if (!tree.exists(exports.easBuildPreInstallScriptPath)) {
+        tree.write(exports.easBuildPreInstallScriptPath, preInstallScript);
+    }
+}
 function addEasScripts(tree) {
-    const postInstallScriptPath = 'tools/scripts/eas-build-post-install.mjs';
-    if (!tree.exists(postInstallScriptPath)) {
-        tree.write(postInstallScriptPath, postInstallScript);
+    addEasBuildPreInstallScript(tree);
+    if (!tree.exists(exports.easBuildPostInstallScriptPath)) {
+        tree.write(exports.easBuildPostInstallScriptPath, postInstallScript);
     }
 }

package/dist/src/generators/application/lib/add-project.js

@@ -1,21 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addProject = addProject;
-const internal_1 = require("@nx/devkit/internal");
 const devkit_1 = require("@nx/devkit");
-const has_expo_plugin_1 = require("../../../utils/has-expo-plugin");
-const deprecation_1 = require("../../../utils/deprecation");
 function addProject(host, options) {
-    const hasPlugin = (0, has_expo_plugin_1.hasExpoPlugin)(host);
-    if (!hasPlugin) {
-        (0, deprecation_1.warnExpoExecutorGenerating)();
-        (0, internal_1.addBuildTargetDefaults)(host, '@nx/expo:build');
-    }
     const projectConfiguration = {
         root: options.appProjectRoot,
         sourceRoot: `${options.appProjectRoot}/src`,
         projectType: 'application',
-        targets: hasPlugin ? {} : getTargets(options),
+        targets: {},
         tags: options.parsedTags,
     };
     const templatedPackageJson = (0, devkit_1.readJson)(host, (0, devkit_1.joinPathFragments)(options.appProjectRoot, 'package.json'));
@@ -29,10 +21,6 @@ function addProject(host, options) {
         if (options.importPath !== options.projectName) {
             packageJson.nx = { name: options.projectName };
         }
-        if (!hasPlugin) {
-            packageJson.nx ??= {};
-            packageJson.nx.targets = getTargets(options);
-        }
         if (options.parsedTags?.length) {
             packageJson.nx ??= {};
             packageJson.nx.tags = options.parsedTags;
@@ -45,72 +33,3 @@ function addProject(host, options) {
         (0, devkit_1.writeJson)(host, (0, devkit_1.joinPathFragments)(options.appProjectRoot, 'package.json'), packageJson);
     }
 }
-function getTargets(options) {
-    const architect = {};
-    architect.start = {
-        executor: '@nx/expo:start',
-        dependsOn: ['sync-deps'],
-        options: {},
-    };
-    architect.serve = {
-        executor: '@nx/expo:serve',
-        dependsOn: ['sync-deps'],
-        options: {
-            port: 4200,
-        },
-    };
-    architect['run-ios'] = {
-        executor: '@nx/expo:run',
-        dependsOn: ['sync-deps'],
-        options: {
-            platform: 'ios',
-        },
-    };
-    architect['run-android'] = {
-        executor: '@nx/expo:run',
-        dependsOn: ['sync-deps'],
-        options: {
-            platform: 'android',
-        },
-    };
-    architect['build'] = {
-        executor: '@nx/expo:build',
-        dependsOn: ['sync-deps'],
-        options: {},
-    };
-    architect['submit'] = {
-        executor: '@nx/expo:submit',
-        options: {},
-    };
-    architect['build-list'] = {
-        executor: '@nx/expo:build-list',
-        options: {},
-    };
-    architect['sync-deps'] = {
-        executor: '@nx/expo:sync-deps',
-        options: {},
-    };
-    architect['prebuild'] = {
-        executor: '@nx/expo:prebuild',
-        dependsOn: ['sync-deps'],
-        options: {},
-    };
-    architect['install'] = {
-        executor: '@nx/expo:install',
-        options: {},
-    };
-    architect['update'] = {
-        executor: '@nx/expo:update',
-        options: {},
-    };
-    architect['export'] = {
-        executor: '@nx/expo:export',
-        dependsOn: ['sync-deps'],
-        outputs: ['{options.outputDir}'],
-        options: {
-            platform: 'all',
-            outputDir: `${options.appProjectRoot}/dist`,
-        },
-    };
-    return architect;
-}

package/dist/src/generators/application/lib/normalize-options.js

@@ -11,10 +11,6 @@ async function normalizeOptions(host, options) {
         projectType: 'application',
         directory: options.directory,
     });
-    const nxJson = (0, devkit_1.readNxJson)(host);
-    const addPluginDefault = process.env.NX_ADD_PLUGINS !== 'false' &&
-        nxJson.useInferencePlugins !== false;
-    options.addPlugin ??= addPluginDefault;
     const { className } = (0, devkit_1.names)(projectName);
     const parsedTags = options.tags
         ? options.tags.split(',').map((s) => s.trim())

package/dist/src/generators/application/schema.d.ts

@@ -19,7 +19,6 @@ export interface Schema {
   e2eTestRunner: 'cypress' | 'playwright' | 'detox' | 'none'; // default is none
   skipPackageJson?: boolean; // default is false
   // Internal options
-  addPlugin?: boolean;
   nxCloudToken?: string;
   useTsSolution?: boolean;
   formatter?: 'prettier' | 'oxfmt' | 'none';

package/dist/src/generators/init/init.js

@@ -11,42 +11,28 @@ const versions_1 = require("../../utils/versions");
 const version_utils_1 = require("../../utils/version-utils");
 const add_git_ignore_entry_1 = require("./lib/add-git-ignore-entry");
 function expoInitGenerator(tree, schema) {
-    return expoInitGeneratorInternal(tree, { addPlugin: false, ...schema });
+    return expoInitGeneratorInternal(tree, schema);
 }
 async function expoInitGeneratorInternal(host, schema) {
     (0, versions_1.assertSupportedExpoVersion)(host);
-    const nxJson = (0, devkit_1.readNxJson)(host);
-    const addPluginDefault = process.env.NX_ADD_PLUGINS !== 'false' &&
-        nxJson.useInferencePlugins !== false;
-    schema.addPlugin ??= addPluginDefault;
     (0, add_git_ignore_entry_1.addGitIgnoreEntry)(host);
-    if (schema.addPlugin) {
-        await (0, internal_1.addPlugin)(host, await (0, devkit_1.createProjectGraphAsync)(), '@nx/expo/plugin', plugin_1.createNodesV2, {
-            startTargetName: ['start', 'expo:start', 'expo-start'],
-            buildTargetName: ['build', 'expo:build', 'expo-build'],
-            prebuildTargetName: ['prebuild', 'expo:prebuild', 'expo-prebuild'],
-            serveTargetName: ['serve', 'expo:serve', 'expo-serve'],
-            installTargetName: ['install', 'expo:install', 'expo-install'],
-            exportTargetName: ['export', 'expo:export', 'expo-export'],
-            submitTargetName: ['submit', 'expo:submit', 'expo-submit'],
-            runIosTargetName: ['run-ios', 'expo:run-ios', 'expo-run-ios'],
-            runAndroidTargetName: [
-                'run-android',
-                'expo:run-android',
-                'expo-run-android',
-            ],
-            buildDepsTargetName: [
-                'build-deps',
-                'expo:build-deps',
-                'expo-build-deps',
-            ],
-            watchDepsTargetName: [
-                'watch-deps',
-                'expo:watch-deps',
-                'expo-watch-deps',
-            ],
-        }, schema.updatePackageScripts);
-    }
+    await (0, internal_1.addPlugin)(host, await (0, devkit_1.createProjectGraphAsync)(), '@nx/expo/plugin', plugin_1.createNodesV2, {
+        startTargetName: ['start', 'expo:start', 'expo-start'],
+        buildTargetName: ['build', 'expo:build', 'expo-build'],
+        prebuildTargetName: ['prebuild', 'expo:prebuild', 'expo-prebuild'],
+        serveTargetName: ['serve', 'expo:serve', 'expo-serve'],
+        installTargetName: ['install', 'expo:install', 'expo-install'],
+        exportTargetName: ['export', 'expo:export', 'expo-export'],
+        submitTargetName: ['submit', 'expo:submit', 'expo-submit'],
+        runIosTargetName: ['run-ios', 'expo:run-ios', 'expo-run-ios'],
+        runAndroidTargetName: [
+            'run-android',
+            'expo:run-android',
+            'expo-run-android',
+        ],
+        buildDepsTargetName: ['build-deps', 'expo:build-deps', 'expo-build-deps'],
+        watchDepsTargetName: ['watch-deps', 'expo:watch-deps', 'expo-watch-deps'],
+    }, schema.updatePackageScripts);
     const tasks = [];
     if (!schema.skipPackageJson) {
         tasks.push(moveDependency(host));

package/dist/src/generators/init/schema.d.ts

@@ -3,5 +3,4 @@ export interface Schema {
   skipPackageJson?: boolean; // default is false
   keepExistingVersions?: boolean; // default is true
   updatePackageScripts?: boolean;
-  addPlugin?: boolean;
 }

package/dist/src/generators/library/lib/normalize-options.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeOptions = normalizeOptions;
-const devkit_1 = require("@nx/devkit");
 const internal_1 = require("@nx/devkit/internal");
 const internal_2 = require("@nx/js/internal");
 async function normalizeOptions(host, options) {
@@ -12,10 +11,6 @@ async function normalizeOptions(host, options) {
         directory: options.directory,
         importPath: options.importPath,
     });
-    const nxJson = (0, devkit_1.readNxJson)(host);
-    const addPluginDefault = process.env.NX_ADD_PLUGINS !== 'false' &&
-        nxJson.useInferencePlugins !== false;
-    options.addPlugin ??= addPluginDefault;
     const parsedTags = options.tags
         ? options.tags.split(',').map((s) => s.trim())
         : [];

package/dist/src/generators/library/library.js

@@ -20,7 +20,6 @@ const version_utils_1 = require("../../utils/version-utils");
 const versions_1 = require("../../utils/versions");
 async function expoLibraryGenerator(host, schema) {
     return await expoLibraryGeneratorInternal(host, {
-        addPlugin: false,
         useProjectJson: true,
         ...schema,
     });
@@ -28,7 +27,7 @@ async function expoLibraryGenerator(host, schema) {
 async function expoLibraryGeneratorInternal(host, schema) {
     (0, versions_1.assertSupportedExpoVersion)(host);
     const tasks = [];
-    const addTsPlugin = (0, internal_2.shouldConfigureTsSolutionSetup)(host, schema.addPlugin);
+    const addTsPlugin = (0, internal_2.shouldConfigureTsSolutionSetup)(host);
     const jsInitTask = await (0, js_1.initGenerator)(host, {
         ...schema,
         addTsPlugin,
@@ -84,7 +83,7 @@ async function expoLibraryGeneratorInternal(host, schema) {
         : undefined);
     // Update Jest tsconfig after general tsconfig updates to ensure Jest resolver configuration is preserved
     if (options.unitTestRunner === 'jest') {
-        const jestTask = await (0, add_jest_1.addJest)(host, options.unitTestRunner, options.projectName, options.projectRoot, options.js, options.skipPackageJson, options.addPlugin);
+        const jestTask = await (0, add_jest_1.addJest)(host, options.unitTestRunner, options.projectName, options.projectRoot, options.js, options.skipPackageJson);
         tasks.push(jestTask);
     }
     (0, internal_2.sortPackageJsonFields)(host, options.projectRoot);

package/dist/src/generators/library/schema.d.ts

@@ -22,6 +22,5 @@ export interface Schema {
    */
   setParserOptionsProject?: boolean;
   skipPackageJson?: boolean; // default is false
-  addPlugin?: boolean;
   useProjectJson?: boolean;
 }

package/dist/src/migrations/update-24-0-0/add-eas-build-pre-install.d.ts

@@ -0,0 +1,2 @@
+import { type MigrationReturnObject, type Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<MigrationReturnObject>;

package/dist/src/migrations/update-24-0-0/add-eas-build-pre-install.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const add_eas_scripts_1 = require("../../generators/application/lib/add-eas-scripts");
+const hookName = 'eas-build-pre-install';
+async function update(tree) {
+    const conflicts = [];
+    let changed = false;
+    for (const [, project] of (0, devkit_1.getProjects)(tree)) {
+        const packageJsonPath = (0, devkit_1.joinPathFragments)(project.root, 'package.json');
+        if (!tree.exists((0, devkit_1.joinPathFragments)(project.root, 'eas.json')) ||
+            !tree.exists(packageJsonPath)) {
+            continue;
+        }
+        const hookCommand = `cd ${(0, devkit_1.offsetFromRoot)(project.root)} && node ${add_eas_scripts_1.easBuildPreInstallScriptPath} . ${project.root}`;
+        const existing = (0, devkit_1.readJson)(tree, packageJsonPath).scripts?.[hookName];
+        if (existing === hookCommand) {
+            continue;
+        }
+        if (existing) {
+            conflicts.push(`${packageJsonPath} already defines "${hookName}". Make it also run "${hookCommand}".`);
+            // The reported command runs this script, so it has to exist either way.
+            (0, add_eas_scripts_1.addEasBuildPreInstallScript)(tree);
+            changed = true;
+            continue;
+        }
+        (0, devkit_1.updateJson)(tree, packageJsonPath, (json) => {
+            json.scripts = { ...json.scripts, [hookName]: hookCommand };
+            return json;
+        });
+        (0, add_eas_scripts_1.addEasBuildPreInstallScript)(tree);
+        changed = true;
+    }
+    if (changed) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+    if (conflicts.length) {
+        return { nextSteps: conflicts, agentContext: conflicts };
+    }
+    return { skipAgentic: true };
+}

package/dist/src/migrations/update-24-0-0/add-eas-build-pre-install.md

@@ -0,0 +1,32 @@
+#### Add the EAS Build pre-install script to Expo apps
+
+Nx 24 removes the `@nx/expo:build` executor. In a workspace without package manager workspaces, that executor copied the root `dependencies`, `devDependencies`, `overrides` (or `resolutions`) and lock file into the app before running `eas build`, then restored the app's files. Without that step, EAS installs the app's `"*"` dependencies at whatever versions are latest.
+
+The migration adds an `eas-build-pre-install` script to the `package.json` of every project with an `eas.json`, and writes `tools/scripts/eas-build-pre-install.mjs`. EAS Build runs the script on the build machine before installing dependencies, and it does the same copy there, so your own files are never modified. It also copies the root `pnpm` settings, and with Yarn it gives the app the root package name, because EAS installs with a frozen lock file and both package managers check those against it. A workspace with pnpm `patchedDependencies` still fails to install, because the patch paths resolve from the app directory. With package manager workspaces enabled, the script exits without changes.
+
+A project that already defines `eas-build-pre-install` keeps its script and is listed in the migration's next steps, so you can add the new command to it.
+
+#### Sample code changes
+
+##### Before
+
+```json title="apps/mobile/package.json"
+{
+  "name": "mobile",
+  "scripts": {
+    "eas-build-post-install": "cd ../../ && node tools/scripts/eas-build-post-install.mjs . apps/mobile"
+  }
+}
+```
+
+##### After
+
+```json title="apps/mobile/package.json"
+{
+  "name": "mobile",
+  "scripts": {
+    "eas-build-post-install": "cd ../../ && node tools/scripts/eas-build-post-install.mjs . apps/mobile",
+    "eas-build-pre-install": "cd ../../ && node tools/scripts/eas-build-pre-install.mjs . apps/mobile"
+  }
+}
+```

package/dist/src/migrations/update-24-0-0/finish-inferred-conversion.md

@@ -0,0 +1,12 @@
+# Replace removed @nx/expo executors with inferred tasks
+
+Nx 24 removed `@nx/expo:build`, `@nx/expo:export`, `@nx/expo:install`, `@nx/expo:prebuild`, `@nx/expo:run`, `@nx/expo:serve`, `@nx/expo:start`, `@nx/expo:submit` (including old `@nrwl` aliases).
+
+Before changing anything, check for leftover work: a project target, a package.json target or a `targetDefaults` entry still uses a removed executor, or the advisory context reports a conversion error. If none applies, make no changes and stop. Treat each advisory-context item as pending work.
+
+1. Inspect all affected projects and workspace defaults. Repair config-loading errors first. Do not restore executor registrations or install older Nx packages.
+2. Preserve Expo/EAS profiles, platforms, environment settings and target names. Keep build-list, sync-deps, update and ensure-symlink executors. Inferred `install` runs plain `expo install` in the app directory, so it adds packages to the app's package.json and no longer to the root package.json; where a project relied on root-level installs, install there and use `@nx/expo:sync-deps` to copy them into the app. Do not submit or publish releases as validation; validate local builds where possible.
+3. Register `@nx/expo/plugin` with options/includes that preserve custom target names and mixed inferred/explicit projects. Replace remaining removed-executor targets, including those in package.json and filtered targetDefaults. Transfer their behavior before removing obsolete defaults. Preserve configurations, dependencies, cache inputs/outputs and environment behavior. Do not silently delete unsupported options or unrelated targets. Migrate old @nrwl aliases too.
+4. Run project graph creation with the daemon and graph cache disabled (`NX_DAEMON=false NX_CACHE_PROJECT_GRAPH=false`), using the workspace package manager. Inspect resolved project targets and verify each migrated entrypoint exists and is inferred (a thin alias to an inferred target is acceptable). Resolve graph errors before completing this migration, even if task validation was skipped. Configs must load for subsequent migrations.
+5. By default run relevant real builds/tests with task cache disabled, including alternate configurations. Honor an existing preference to skip expensive task validation; otherwise offer that option when validation is slow. Skipping expensive tasks never skips conversion or the graph check. Report each skipped task as unverified. Never weaken assertions or change application behavior to make checks pass.
+6. Report converted projects, graph validation, task results and any skipped checks. Unconverted targets or a broken graph mean the migration is incomplete. Investigate task failures and distinguish missing environment prerequisites from conversion regressions; do not claim a working workspace with unresolved regressions.

package/dist/src/migrations/update-24-0-0/remove-deprecated-executors.d.ts

@@ -0,0 +1,6 @@
+import type { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<{
+    nextSteps?: string[];
+    agentContext?: string[];
+    skipAgentic?: boolean;
+}>;