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

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const internal_1 = require("@nx/devkit/internal");
+function update(tree) {
+    return (0, internal_1.migrateRemovedExecutors)(tree, [
+        '@nx/expo:build',
+        '@nx/expo:export',
+        '@nx/expo:install',
+        '@nx/expo:prebuild',
+        '@nx/expo:run',
+        '@nx/expo:serve',
+        '@nx/expo:start',
+        '@nx/expo:submit',
+        '@nrwl/expo:build',
+        '@nrwl/expo:export',
+        '@nrwl/expo:install',
+        '@nrwl/expo:prebuild',
+        '@nrwl/expo:run',
+        '@nrwl/expo:serve',
+        '@nrwl/expo:start',
+        '@nrwl/expo:submit',
+    ], async (tree, options) => {
+        const { convertToInferred } = require('../../generators/convert-to-inferred/convert-to-inferred');
+        // The callback only prints the options the converter could not carry
+        // over; migrateRemovedExecutors discards it.
+        const flushLogs = await convertToInferred(tree, options);
+        flushLogs();
+    });
+}

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

@@ -0,0 +1,72 @@
+#### Convert `@nx/expo` targets to inferred tasks
+
+Nx 24 removes the `@nx/expo:build`, `@nx/expo:export`, `@nx/expo:install`, `@nx/expo:prebuild`, `@nx/expo:run`, `@nx/expo:serve`, `@nx/expo:start` and `@nx/expo:submit` executors and their `@nrwl` aliases. The migration registers `@nx/expo/plugin` in `nx.json` and converts the targets that use those executors to inferred tasks. Executor options become command-line arguments of the inferred tasks. A target with nothing left to override is removed from project configuration. When several projects share the same remaining options, those options move to a `targetDefaults` entry scoped to the plugin. `targetDefaults` entries keyed by a removed executor are removed once no target uses that executor.
+
+The migration lists the targets the converter cannot convert safely. In agentic runs, an AI prompt finishes them and validates the project graph.
+
+The `@nx/expo:build-list`, `@nx/expo:sync-deps`, `@nx/expo:update` and `@nx/expo:ensure-symlink` executors stay.
+
+The inferred `install` and `prebuild` tasks run `expo install` and `expo prebuild` as they are. `@nx/expo:install` installed packages into the root `package.json` and then synced them into the app's. The inferred `install` runs in the app directory, so packages go into the app's `package.json` and no longer into the root one. To keep dependencies in the root `package.json`, install them there and sync them with the kept `@nx/expo:sync-deps` executor. `@nx/expo:prebuild` ran `expo prebuild --no-install` and then installed packages and CocoaPods itself, which `expo prebuild` does by default.
+
+`@nx/expo:build` copied the root dependencies and lock file into the app before `eas build`. The `add-eas-build-pre-install` migration moves that step to an `eas-build-pre-install` script that EAS Build runs.
+
+#### Sample code changes
+
+The `install` target has no options that differ from the inferred target, so it is removed. The `export` options become CLI arguments.
+
+##### Before
+
+```json title="apps/demo/project.json"
+{
+  "name": "demo",
+  "targets": {
+    "export": {
+      "executor": "@nx/expo:export",
+      "options": {
+        "platform": "all",
+        "outputDir": "dist/demo"
+      }
+    },
+    "install": {
+      "executor": "@nx/expo:install",
+      "options": {}
+    }
+  }
+}
+```
+
+##### After
+
+```json title="apps/demo/project.json"
+{
+  "name": "demo",
+  "targets": {
+    "export": {
+      "options": {
+        "args": ["--output-dir=../../dist/demo", "--platform=all"]
+      }
+    }
+  }
+}
+```
+
+```json title="nx.json"
+{
+  "plugins": [
+    {
+      "plugin": "@nx/expo/plugin",
+      "options": {
+        "buildTargetName": "build",
+        "exportTargetName": "export",
+        "installTargetName": "install",
+        "prebuildTargetName": "prebuild",
+        "runAndroidTargetName": "run-android",
+        "runIosTargetName": "run-ios",
+        "serveTargetName": "serve",
+        "startTargetName": "start",
+        "submitTargetName": "submit"
+      }
+    }
+  ]
+}
+```

package/dist/src/utils/add-linting.d.ts

@@ -12,7 +12,6 @@ interface NormalizedSchema {
     tsConfigPaths: string[];
     unitTestRunner?: string;
     skipPackageJson?: boolean;
-    addPlugin?: boolean;
     buildable?: boolean;
     isTsSolutionSetup?: boolean;
 }

package/dist/src/utils/add-linting.js

@@ -15,7 +15,6 @@ async function addLinting(host, options) {
         unitTestRunner: options.unitTestRunner,
         skipPackageJson: options.skipPackageJson,
         enableTypedLinting: (0, internal_1.isTypedLintingEnabled)(options),
-        addPlugin: options.addPlugin,
         addPackageJsonDependencyChecks: options.buildable,
     }));
     // Everything below configures ESLint — predefined configs, `extends`, ignore

package/dist/src/utils/jest/add-jest.d.ts

@@ -1,2 +1,2 @@
 import { Tree, type GeneratorCallback } from '@nx/devkit';
-export declare function addJest(host: Tree, unitTestRunner: 'jest' | 'none', projectName: string, appProjectRoot: string, js: boolean, skipPackageJson: boolean, addPlugin: boolean): Promise<GeneratorCallback>;
+export declare function addJest(host: Tree, unitTestRunner: 'jest' | 'none', projectName: string, appProjectRoot: string, js: boolean, skipPackageJson: boolean): Promise<GeneratorCallback>;

package/dist/src/utils/jest/add-jest.js

@@ -6,7 +6,7 @@ const path_1 = require("path");
 const update_tsconfig_files_1 = require("../update-tsconfig-files");
 const versions_1 = require("../versions");
 const version_utils_1 = require("../version-utils");
-async function addJest(host, unitTestRunner, projectName, appProjectRoot, js, skipPackageJson, addPlugin) {
+async function addJest(host, unitTestRunner, projectName, appProjectRoot, js, skipPackageJson) {
     if (unitTestRunner !== 'jest') {
         return () => { };
     }
@@ -20,7 +20,6 @@ async function addJest(host, unitTestRunner, projectName, appProjectRoot, js, sk
         compiler: 'babel',
         skipPackageJson,
         skipFormat: true,
-        addPlugin,
     });
     // Expo SDK 54+ (including 55) use the winter-runtime ImportMetaRegistry mock;
     // only SDK 53 needs the custom Jest resolver.

package/executors.json

@@ -5,26 +5,11 @@
       "schema": "./dist/src/executors/update/schema.json",
       "description": "Start an EAS update for your expo project"
     },
-    "build": {
-      "implementation": "./dist/src/executors/build/build.impl",
-      "schema": "./dist/src/executors/build/schema.json",
-      "description": "Start an EAS build for your expo project"
-    },
     "build-list": {
       "implementation": "./dist/src/executors/build-list/build-list.impl",
       "schema": "./dist/src/executors/build-list/schema.json",
       "description": "List all EAS builds for your Expo project"
     },
-    "run": {
-      "implementation": "./dist/src/executors/run/run.impl",
-      "schema": "./dist/src/executors/run/schema.json",
-      "description": "Run the Android app binary locally or run the iOS app binary locally"
-    },
-    "start": {
-      "implementation": "./dist/src/executors/start/start.impl",
-      "schema": "./dist/src/executors/start/schema.json",
-      "description": "Start a local dev server for the app or start a Webpack dev server for the web app"
-    },
     "sync-deps": {
       "implementation": "./dist/src/executors/sync-deps/sync-deps.impl",
       "schema": "./dist/src/executors/sync-deps/schema.json",
@@ -34,31 +19,6 @@
       "implementation": "./dist/src/executors/ensure-symlink/ensure-symlink.impl",
       "schema": "./dist/src/executors/ensure-symlink/schema.json",
       "description": "Ensure workspace node_modules is symlink under app's node_modules folder."
-    },
-    "prebuild": {
-      "implementation": "./dist/src/executors/prebuild/prebuild.impl",
-      "schema": "./dist/src/executors/prebuild/schema.json",
-      "description": "Create native iOS and Android project files for building natively."
-    },
-    "install": {
-      "implementation": "./dist/src/executors/install/install.impl",
-      "schema": "./dist/src/executors/install/schema.json",
-      "description": "Install a module or other package to a project."
-    },
-    "export": {
-      "implementation": "./dist/src/executors/export/export.impl",
-      "schema": "./dist/src/executors/export/schema.json",
-      "description": "Export the JavaScript and assets for your app using Metro/webpack bundler"
-    },
-    "submit": {
-      "implementation": "./dist/src/executors/submit/submit.impl",
-      "schema": "./dist/src/executors/submit/schema.json",
-      "description": "Submit app binary to App Store and/or Play Store"
-    },
-    "serve": {
-      "implementation": "./dist/src/executors/serve/serve.impl",
-      "schema": "./dist/src/executors/serve/schema.json",
-      "description": "Serve up the Expo web app locally"
     }
   }
 }

package/migrations.json

@@ -84,6 +84,19 @@
       },
       "description": "Update Jest test-setup for the Expo SDK 56 winter runtime",
       "factory": "./dist/src/migrations/update-23-1-0/update-jest-winter-runtime-for-expo-56"
+    },
+    "remove-deprecated-executors": {
+      "version": "24.0.0-beta.3",
+      "description": "Converts targets using the removed `@nx/expo` executors to inferred tasks; an AI prompt finishes the targets the converter cannot convert safely and validates the project graph.",
+      "implementation": "./dist/src/migrations/update-24-0-0/remove-deprecated-executors",
+      "prompt": "./dist/src/migrations/update-24-0-0/finish-inferred-conversion.md",
+      "documentation": "./dist/src/migrations/update-24-0-0/remove-deprecated-executors.md"
+    },
+    "add-eas-build-pre-install": {
+      "version": "24.0.0-beta.3",
+      "description": "Adds an `eas-build-pre-install` script to Expo apps with an `eas.json`, which copies the root dependencies and lock file into the app on EAS Build as the removed `@nx/expo:build` executor did locally.",
+      "implementation": "./dist/src/migrations/update-24-0-0/add-eas-build-pre-install",
+      "documentation": "./dist/src/migrations/update-24-0-0/add-eas-build-pre-install.md"
     }
   },
   "packageJsonUpdates": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/expo",
-  "version": "24.0.0-beta.2",
+  "version": "24.0.0-beta.4",
   "private": false,
   "description": "The Expo Plugin for Nx contains executors and generators for managing and developing an expo application within your workspace. For example, you can directly build for different target platforms as well as generate projects and publish your code.",
   "keywords": [
@@ -56,10 +56,10 @@
     }
   },
   "dependencies": {
-    "@nx/devkit": "24.0.0-beta.2",
-    "@nx/eslint": "24.0.0-beta.2",
-    "@nx/js": "24.0.0-beta.2",
-    "@nx/react": "24.0.0-beta.2",
+    "@nx/devkit": "24.0.0-beta.4",
+    "@nx/eslint": "24.0.0-beta.4",
+    "@nx/js": "24.0.0-beta.4",
+    "@nx/react": "24.0.0-beta.4",
     "enhanced-resolve": "^5.8.3",
     "picocolors": "^1.1.0",
     "semver": "^7.6.3",
@@ -67,8 +67,8 @@
     "tslib": "^2.3.0"
   },
   "peerDependencies": {
-    "@nx/cypress": "24.0.0-beta.2",
-    "@nx/playwright": "24.0.0-beta.2",
+    "@nx/cypress": "24.0.0-beta.4",
+    "@nx/playwright": "24.0.0-beta.4",
     "expo": ">=53.0.0",
     "@expo/metro": ">= 55.0.0",
     "metro-config": ">= 0.82.0",
@@ -95,11 +95,11 @@
     }
   },
   "devDependencies": {
-    "nx": "24.0.0-beta.2"
+    "nx": "24.0.0-beta.4"
   },
   "optionalDependencies": {
-    "@nx/detox": "24.0.0-beta.2",
-    "@nx/rollup": "24.0.0-beta.2"
+    "@nx/detox": "24.0.0-beta.4",
+    "@nx/rollup": "24.0.0-beta.4"
   },
   "executors": "./executors.json",
   "ng-update": {

package/dist/docs/export-examples.md

@@ -1,107 +0,0 @@
-`project.json`:
-
-```json
-{
-  "name": "mobile",
-  //...
-  "targets": {
-    //...
-    "export": {
-      "executor": "@nx/expo:export",
-      "options": {
-        "outputs": ["{options.outputDir}"],
-        "platform": "all",
-        "outputDir": "dist/apps/mobile"
-      },
-      "dependsOn": ["sync-deps"]
-    }
-    //...
-  }
-}
-```
-
-```shell
-nx run mobile:export
-```
-
-## Examples
-
-##### Specify outputDir
-
-The `outputDir` option allows you to specify the output directory of your bundle:
-
-```json
-    "export": {
-      "executor": "@nx/expo:export",
-      "outputs": ["{options.outputDir}"],
-      "options": {
-        "platform": "all",
-        "bundler": "metro",
-        "outputDir": "dist/apps/mobile"
-      },
-      "dependsOn": ["sync-deps"]
-    },
-```
-
-or run command: `nx run mobile:export --outputDir=dist/apps/mobile`.
-
-##### Specify the platform
-
-The `platform` option allows you to specify the platform to compile with metro bundler: "ios", "android", "all", and "web".
-
-For example, to bundle for web:
-
-```json
-    "export": {
-      "executor": "@nx/expo:export",
-      "outputs": ["{options.outputDir}"],
-      "options": {
-        "platform": "web",
-        "bundler": "metro",
-        "outputDir": "dist/apps/dogs"
-      },
-      "dependsOn": ["sync-deps"]
-    },
-```
-
-or run command `nx export mobile --platform=web`.
-
-##### Bundle for development
-
-The `dev` option allows you to bundle for development environments.
-
-```json
-    "export": {
-      "executor": "@nx/expo:export",
-      "outputs": ["{options.outputDir}"],
-      "options": {
-        "platform": "web",
-        "bundler": "metro",
-        "outputDir": "dist/apps/dogs",
-        "dev": true
-      },
-      "dependsOn": ["sync-deps"]
-    },
-```
-
-or run command `nx export mobile --dev`.
-
-##### Clear bundle cache
-
-The `clear` option allows you to clear bundle cache.
-
-```json
-    "export": {
-      "executor": "@nx/expo:export",
-      "outputs": ["{options.outputDir}"],
-      "options": {
-        "platform": "web",
-        "bundler": "metro",
-        "outputDir": "dist/apps/dogs",
-        "clear": true
-      },
-      "dependsOn": ["sync-deps"]
-    },
-```
-
-or run command `nx export mobile --clear`.

package/dist/docs/prebuild-examples.md

@@ -1,65 +0,0 @@
-The `prebuild` command generates native code before a native app can compile.
-
-`project.json`:
-
-```json
-{
-  "name": "mobile",
-  //...
-  "targets": {
-    //...
-    "prebuild": {
-      "executor": "@nx/expo:prebuild",
-      "options": {}
-    }
-    //...
-  }
-}
-```
-
-```shell
-nx run mobile:prebuild
-```
-
-## Examples
-
-##### Generate Native Code for Different Platforms
-
-The `platform` option allows you to specify the platform to generate native code for (e.g. android, ios, all).
-
-```json
-    "prebuild": {
-      "executor": "@nx/expo:prebuild",
-      "options": {
-        "platform": "android"
-      }
-    }
-```
-
-##### Regenerate Native Code
-
-The `clean` option allows you to delete the native folders and regenerate them before apply changes.
-
-```json
-    "prebuild": {
-      "executor": "@nx/expo:prebuild",
-      "options": {
-        "clean": true
-      }
-    }
-```
-
-##### Install NPM Packages and CocoaPods
-
-The `install` option allows you to install NPM Packages and CocoaPods.
-
-```json
-    "prebuild": {
-      "executor": "@nx/expo:prebuild",
-      "options": {
-        "install": true
-      }
-    }
-```
-
----

package/dist/docs/run-examples.md

@@ -1,86 +0,0 @@
-The `run` command allows you to compile your app locally.
-
-`project.json`:
-
-```json
-{
-  "name": "mobile",
-  //...
-  "targets": {
-    //...
-    "run-ios": {
-      "executor": "@nx/expo:run",
-      "options": {
-        "platform": "ios"
-      }
-    },
-    "run-android": {
-      "executor": "@nx/expo:run",
-      "options": {
-        "platform": "android"
-      }
-    }
-    //...
-  }
-}
-```
-
-```shell
-nx run mobile:run-ios
-nx run mobile:run-android
-```
-
-## Examples
-
-##### Compile Android with Different Variants
-
-The `variant` option allows you to specify the compile Android app with variants defined in `build.gradle` file (e.g. debug, release).
-
-```json
-    "run-android": {
-      "executor": "@nx/expo:run",
-      "options": {
-        "platform": "android",
-        "variant": "release"
-      }
-    }
-```
-
-##### Compile iOS with Different Configurations
-
-The `xcodeConfiguration` option allows you to specify Xcode configuration to use (e.g. Debug or Release).
-
-```json
-    "run-ios": {
-      "executor": "@nx/expo:run",
-      "options": {
-        "platform": "ios",
-        "xcodeConfiguration": "Release"
-      }
-    }
-```
-
-##### Run on a device
-
-The `device` option allows you to launch your app in a specific device name or UDID.
-To see all your iOS simulators: run `xcrun simctl list devices available`.
-To see all your Android emulators, run: `emulator -list-avds`.
-
-```json
-    "run-ios": {
-      "executor": "@nx/expo:run",
-      "options": {
-        "platform": "ios",
-        "device": "iPhone 14"
-      }
-    },
-    "run-android": {
-      "executor": "@nx/expo:run",
-      "options": {
-        "platform": "android",
-        "device": "Pixel_XL_API_Tiramisu"
-      }
-    }
-```
-
----

package/dist/docs/start-examples.md

@@ -1,100 +0,0 @@
-`project.json`:
-
-```json
-{
-  "name": "mobile",
-  //...
-  "targets": {
-    //...
-    "start": {
-      "executor": "@nx/expo:start",
-      "options": {
-        "port": 8081
-      }
-    }
-    //...
-  }
-}
-```
-
-```shell
-nx run mobile:start
-```
-
-## Examples
-
-##### Specify starting on platform
-
-The `ios`, `android` and `web` option allows you to start the server on different platforms.
-
-Opens your app in Expo Go in a currently running iOS simulator on your computer:
-
-```json
-    "start": {
-      "executor": "@nx/expo:start",
-      "options": {
-        "port": 8081,
-        "ios": true
-      }
-    }
-```
-
-or run command `nx start <your app name> --ios`.
-
-Opens your app in Expo Go on a connected Android device
-
-```json
-    "start": {
-      "executor": "@nx/expo:start",
-      "options": {
-        "port": 8081,
-        "android": true
-      }
-    }
-```
-
-or run command `nx start <your app name> --android`.
-
-Opens your app in a web browser:
-
-```json
-    "start": {
-      "executor": "@nx/expo:start",
-      "options": {
-        "port": 8081,
-        "web": true
-      }
-    }
-```
-
-or run command `nx start <your app name> --web`.
-
-##### Specify the host
-
-The `host` option allows you to specify the type of host to use. `lan` uses the local network; `tunnel` ues any network by tunnel through ngrok; `localhost` connects to the dev server over localhost.
-
-```json
-    "start": {
-      "executor": "@nx/expo:start",
-      "options": {
-        "port": 8081,
-        "host": "localhost"
-      }
-    }
-```
-
-##### Starts the server with cache reset
-
-The `clear` option allows you to remove Metro bundler cache.
-
-```json
-    "start": {
-      "executor": "@nx/expo:start",
-      "options": {
-        "port": 8081,
-        "clear": true
-      }
-    }
-```
-
----

package/dist/src/executors/build/build.impl.d.ts

@@ -1,6 +0,0 @@
-import { ExecutorContext } from '@nx/devkit';
-import { ExpoEasBuildOptions } from './schema';
-export interface ReactNativeBuildOutput {
-    success: boolean;
-}
-export default function buildExecutor(options: ExpoEasBuildOptions, context: ExecutorContext): AsyncGenerator<ReactNativeBuildOutput>;