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

package/dist/src/generators/ng-add/migrators/builders/angular-eslint-lint.migrator.js

@@ -33,7 +33,6 @@ class AngularEslintLintMigrator extends builder_migrator_1.BuilderMigrator {
         }
     }
     async updateTargetConfiguration(targetName, target) {
-        target.executor = '@nx/eslint:lint';
         if (!target.options) {
             this.logger.warn(`The target "${targetName}" is not specifying any options. Skipping updating the target configuration.`);
             return;
@@ -60,6 +59,18 @@ class AngularEslintLintMigrator extends builder_migrator_1.BuilderMigrator {
                     this.logger.warn(`The lint file pattern "${pattern}" specified in the "${targetName}" target is not contained in the project root or source root. The pattern will not be updated.`);
                     return pattern;
                 });
+        // `@nx/eslint:lint` is gone in v24, so the migrated target runs the ESLint
+        // CLI directly. Patterns were rebased onto the new project root above.
+        const eslintConfig = target.options.eslintConfig && this.newEsLintConfigPath;
+        const patterns = target.options.lintFilePatterns ?? [];
+        delete target.executor;
+        delete target.options;
+        target.command = [
+            'eslint',
+            ...(eslintConfig ? ['--config', eslintConfig] : []),
+            // Quoted so ESLint, not the shell, expands the globs: sh has no globstar.
+            ...patterns.map((pattern) => `"${pattern}"`),
+        ].join(' ');
         (0, devkit_1.updateProjectConfiguration)(this.tree, this.project.name, {
             ...this.projectConfig,
         });

package/dist/src/generators/ng-add/migrators/projects/e2e.migrator.js

@@ -223,9 +223,6 @@ class E2eMigrator extends project_migrator_1.ProjectMigrator {
             tags: [],
             implicitDependencies: [this.appName],
         });
-        const nxJson = (0, devkit_1.readNxJson)(this.tree) ?? {};
-        const addPlugin = process.env.NX_ADD_PLUGINS !== 'false' &&
-            nxJson.useInferencePlugins !== false;
         const { configurationGenerator } = (require('@nx/cypress'));
         await configurationGenerator(this.tree, {
             project: this.project.name,
@@ -234,7 +231,6 @@ class E2eMigrator extends project_migrator_1.ProjectMigrator {
             // any target would do, we replace it later with the target existing in the project being migrated
             devServerTarget: `${this.appName}:serve`,
             baseUrl: 'http://localhost:4200',
-            addPlugin,
         });
         const cypressConfigFilePath = this.updateOrCreateCypressConfigFile(oldCypressConfigFilePath);
         this.updateCypressProjectConfiguration(cypressConfigFilePath);
@@ -284,21 +280,21 @@ class E2eMigrator extends project_migrator_1.ProjectMigrator {
         });
     }
     updateE2eCypressTarget(existingTarget, cypressConfig) {
+        // `@nx/cypress:cypress` is gone in v24, so the migrated target runs the
+        // Cypress CLI directly against the rebased config. `watch` selected the
+        // interactive runner, which is `cypress open`.
+        const isInteractive = existingTarget.options?.watch === true;
+        if (existingTarget.options?.devServerTarget) {
+            this.logger.warn(`The "devServerTarget" option is not supported by the Cypress CLI. Start "${existingTarget.options.devServerTarget}" separately, or set "baseUrl" in "${cypressConfig}".`);
+        }
         const updatedTarget = {
             ...existingTarget,
-            executor: '@nx/cypress:cypress',
-            options: {
-                ...existingTarget.options,
-                cypressConfig,
-            },
+            command: `cypress ${isInteractive ? 'open' : 'run'} --e2e --config-file ${(0, path_1.basename)(cypressConfig)}`,
+            options: { cwd: (0, path_1.dirname)(cypressConfig) },
         };
-        delete updatedTarget.options.configFile;
-        if (updatedTarget.options.tsConfig) {
-            updatedTarget.options.tsConfig = (0, devkit_1.joinPathFragments)(this.project.newRoot, 'tsconfig.json');
-        }
-        else {
-            delete updatedTarget.options.tsConfig;
-        }
+        delete updatedTarget.executor;
+        delete updatedTarget.configurations;
+        delete updatedTarget.defaultConfiguration;
         return updatedTarget;
     }
     cypressConfigGlobToNewGlob(globPattern) {

package/dist/src/generators/ng-add/utilities/workspace.js

@@ -156,9 +156,7 @@ function updatePackageJson(tree) {
     });
 }
 async function updateRootEsLintConfig(tree, existingEsLintConfig, unitTestRunner) {
-    await (0, eslint_1.lintInitGenerator)(tree, {
-        addPlugin: false,
-    });
+    await (0, eslint_1.lintInitGenerator)(tree, {});
     if (!existingEsLintConfig) {
         // There was no eslint config in the root, so we set it up and use it as-is
         (0, internal_1.setupRootEsLint)(tree, { unitTestRunner });

package/dist/src/generators/storybook-configuration/lib/generate-storybook-configuration.js

@@ -13,7 +13,5 @@ async function generateStorybookConfiguration(tree, options) {
         interactionTests: options.interactionTests,
         configureStaticServe: options.configureStaticServe,
         skipFormat: true,
-        addPlugin: false,
-        addExplicitTargets: true,
     });
 }

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

@@ -6,6 +6,5 @@ export type AddJestOptions = {
     strict: boolean;
     runtimeTsconfigFileName: 'tsconfig.app.json' | 'tsconfig.lib.json';
     zoneless: boolean;
-    addPlugin?: boolean;
 };
 export declare function addJest(tree: Tree, options: AddJestOptions): Promise<void>;

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

@@ -28,8 +28,6 @@ async function addJest(tree, options) {
         skipSerializers: false,
         skipPackageJson: options.skipPackageJson,
         skipFormat: true,
-        addPlugin: options.addPlugin ?? false,
-        addExplicitTargets: !options.addPlugin,
     });
     const setupFile = (0, devkit_1.joinPathFragments)(options.projectRoot, 'src', 'test-setup.ts');
     if (options.zoneless) {

package/dist/src/generators/utils/add-vitest.d.ts

@@ -12,7 +12,6 @@ export type AddVitestAnalogOptions = {
     skipPackageJson: boolean;
     strict: boolean;
     zoneless: boolean;
-    addPlugin?: boolean;
 };
 export declare function addVitestAngular(tree: Tree, options: AddVitestAngularOptions): Promise<GeneratorCallback>;
 export declare function addVitestAnalog(tree: Tree, options: AddVitestAnalogOptions): Promise<GeneratorCallback>;

package/dist/src/generators/utils/add-vitest.js

@@ -81,7 +81,6 @@ async function addVitestAnalog(tree, options) {
         uiFramework: 'angular',
         testEnvironment: 'jsdom',
         coverageProvider: 'v8',
-        addPlugin: options.addPlugin ?? false,
         skipFormat: options.skipFormat,
         skipPackageJson: options.skipPackageJson,
         zoneless: options.zoneless,

package/dist/src/generators/utils/testing.d.ts

@@ -1,10 +1,6 @@
 import type { Tree } from '@nx/devkit';
 import type { Schema as ApplicationOptions } from '../application/schema';
-import type { Schema as HostOptions } from '../host/schema';
 import type { Schema as LibraryOptions } from '../library/schema';
-import type { Schema as RemoteOptions } from '../remote/schema';
 export declare function generateTestApplication(tree: Tree, options: ApplicationOptions): Promise<void>;
-export declare function generateTestHostApplication(tree: Tree, options: HostOptions): Promise<void>;
-export declare function generateTestRemoteApplication(tree: Tree, options: RemoteOptions): Promise<void>;
 export declare function generateTestLibrary(tree: Tree, options: LibraryOptions): Promise<void>;
 export declare function createStorybookTestWorkspaceForLib(libName: string): Promise<Tree>;

package/dist/src/generators/utils/testing.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateTestApplication = generateTestApplication;
-exports.generateTestHostApplication = generateTestHostApplication;
-exports.generateTestRemoteApplication = generateTestRemoteApplication;
 exports.generateTestLibrary = generateTestLibrary;
 exports.createStorybookTestWorkspaceForLib = createStorybookTestWorkspaceForLib;
 const devkit_1 = require("@nx/devkit");
@@ -11,23 +9,13 @@ const internal_1 = require("@nx/js/internal");
 const test_runners_1 = require("../../utils/test-runners");
 const application_1 = require("../application/application");
 const component_1 = require("../component/component");
-const host_1 = require("../host/host");
 const library_1 = require("../library/library");
-const remote_1 = require("../remote/remote");
 async function generateTestApplication(tree, options) {
     tree.write('.gitignore', '');
     await (0, application_1.applicationGenerator)(tree, {
         ...options,
     });
 }
-async function generateTestHostApplication(tree, options) {
-    tree.write('.gitignore', '');
-    await (0, host_1.host)(tree, { ...options });
-}
-async function generateTestRemoteApplication(tree, options) {
-    tree.write('.gitignore', '');
-    await (0, remote_1.remote)(tree, { ...options });
-}
 async function generateTestLibrary(tree, options) {
     tree.write('.gitignore', '');
     await (0, library_1.libraryGenerator)(tree, {

package/dist/src/migrations/update-23-1-0/add-angular-build.js

@@ -2,8 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = default_1;
 const devkit_1 = require("@nx/devkit");
+const internal_1 = require("@nx/devkit/internal");
 const acknowledge_build_scripts_1 = require("../../generators/utils/acknowledge-build-scripts");
-const versions_1 = require("../../utils/versions");
+const version_utils_1 = require("../../generators/utils/version-utils");
 // The `@nx/angular:application` and `@nx/angular:unit-test` executors import
 // `@angular/build` directly to run the Angular builders, and any
 // `@angular/build:*` executor is provided by that package; it is a required
@@ -12,7 +13,8 @@ const versions_1 = require("../../utils/versions");
 // `@angular-devkit/build-angular`, which isn't reliable (it can be absent from
 // node_modules, e.g. under Yarn Berry), so `require.resolve('@angular/build')`
 // fails and the build breaks. Add it as a direct dependency when an executor
-// needs it, at the version the application generator installs.
+// needs it. Match the version `@angular-devkit/build-angular` pins it to,
+// because a newer `@angular/build` breaks peers such as `@angular/ssr`.
 const angularBuildExecutors = [
     '@nx/angular:application',
     '@nx/angular:unit-test',
@@ -51,5 +53,7 @@ async function default_1(tree) {
         return;
     }
     (0, acknowledge_build_scripts_1.acknowledgeAngularBuildScripts)(tree);
-    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { '@angular/build': versions_1.angularDevkitVersion }, undefined, true);
+    const version = (0, internal_1.getInstalledPackageVersionFromTree)(tree, '@angular-devkit/build-angular') ??
+        (0, version_utils_1.getInstalledAngularVersion)(tree);
+    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { '@angular/build': `~${version}` }, undefined, true);
 }

package/dist/src/migrations/update-23-1-0/add-angular-build.md

@@ -1,6 +1,6 @@
 #### Add `@angular/build` When Used by an Executor
 
-The `@nx/angular:application` and `@nx/angular:unit-test` executors load the Angular builders by importing `@angular/build` directly, and any `@angular/build:*` executor is provided by that package, so `@angular/build` is a required runtime dependency for workspaces using those targets. Nothing declares it as a direct dependency, though: it has only ever been available transitively as a dependency of `@angular-devkit/build-angular`. That is not reliable (for example, under Yarn Berry it can be missing from `node_modules` even when `@angular-devkit/build-angular` is installed), and when `@angular/build` cannot be resolved the build fails with an error like `The "@angular/build" package is required by "@nx/angular:application" but is not installed`. This migration adds `@angular/build` to `devDependencies` when a project uses one of those executors and it is not already installed, at the version the application generator installs. An existing version is preserved.
+The `@nx/angular:application` and `@nx/angular:unit-test` executors load the Angular builders by importing `@angular/build` directly, and any `@angular/build:*` executor is provided by that package, so `@angular/build` is a required runtime dependency for workspaces using those targets. Nothing declares it as a direct dependency, though: it has only ever been available transitively as a dependency of `@angular-devkit/build-angular`. That is not reliable (for example, under Yarn Berry it can be missing from `node_modules` even when `@angular-devkit/build-angular` is installed), and when `@angular/build` cannot be resolved the build fails with an error like `The "@angular/build" package is required by "@nx/angular:application" but is not installed`. This migration adds `@angular/build` to `devDependencies` when a project uses one of those executors and it is not already installed. It uses the installed `@angular-devkit/build-angular` version, which pins `@angular/build` to the same version. When `@angular-devkit/build-angular` isn't installed, it uses the `@angular/core` version declared in `package.json`, limited to that minor (`^22.1.0` becomes `~22.1.0`). An existing version is preserved.
 
 Executor usage is detected on any target using `@nx/angular:application`, `@nx/angular:unit-test`, or an `@angular/build:*` executor. Targets that inherit their executor from an `nx.json` `targetDefaults` entry are detected too.
 

package/dist/src/migrations/update-23-1-0/add-trust-proxy-headers.js

@@ -32,14 +32,21 @@ async function default_1(tree) {
                     ts.isIdentifier(node.expression) &&
                     (node.expression.text === 'AngularNodeAppEngine' ||
                         node.expression.text === 'AngularAppEngine')) {
-                    if (!node.arguments || node.arguments.length === 0) {
+                    if (!node.arguments) {
+                        // `new AngularAppEngine` without parentheses has no argument list.
+                        recorder ??= new file_change_recorder_1.FileChangeRecorder(tree, path);
+                        recorder.insertRight(node.end, `({\n  ${TODO_COMMENT}\n  ${TRUST_PROXY_HEADERS}\n})`);
+                    }
+                    else if (node.arguments.length === 0) {
                         // No options object: insert one before the closing parenthesis.
                         recorder ??= new file_change_recorder_1.FileChangeRecorder(tree, path);
                         recorder.insertRight(node.end - 1, `{\n  ${TODO_COMMENT}\n  ${TRUST_PROXY_HEADERS}\n}`);
                     }
                     else if (ts.isObjectLiteralExpression(node.arguments[0])) {
                         const optionsArg = node.arguments[0];
-                        const hasTrustProxyHeaders = optionsArg.properties.some((prop) => ts.isPropertyAssignment(prop) &&
+                        // Any member kind counts (shorthand, method, accessor): adding the
+                        // property next to one would duplicate the key.
+                        const hasTrustProxyHeaders = optionsArg.properties.some((prop) => prop.name &&
                             (ts.isIdentifier(prop.name) || ts.isStringLiteral(prop.name)) &&
                             prop.name.text === 'trustProxyHeaders');
                         if (!hasTrustProxyHeaders) {

package/dist/src/migrations/update-24-0-0/upgrade-to-angular-22-2.d.ts

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

package/dist/src/migrations/update-24-0-0/upgrade-to-angular-22-2.js

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = upgradeToAngular222;
+const devkit_1 = require("@nx/devkit");
+const internal_1 = require("@nx/devkit/internal");
+const internal_2 = require("@nx/js/internal");
+const path_1 = require("path");
+// Keep these versions pinned; versions.ts advances to later Angular versions.
+const ANGULAR_22_2_VERSIONS = {
+    '@angular/core': '~22.2.0',
+    '@angular/animations': '~22.2.0',
+    '@angular/common': '~22.2.0',
+    '@angular/compiler': '~22.2.0',
+    '@angular/compiler-cli': '~22.2.0',
+    '@angular/elements': '~22.2.0',
+    '@angular/forms': '~22.2.0',
+    '@angular/language-service': '~22.2.0',
+    '@angular/localize': '~22.2.0',
+    '@angular/platform-browser': '~22.2.0',
+    '@angular/platform-browser-dynamic': '~22.2.0',
+    '@angular/platform-server': '~22.2.0',
+    '@angular/router': '~22.2.0',
+    '@angular/service-worker': '~22.2.0',
+    '@angular/upgrade': '~22.2.0',
+    '@angular/cli': '~22.2.0',
+    '@angular/build': '~22.2.0',
+    '@angular/pwa': '~22.2.0',
+    '@angular/ssr': '~22.2.0',
+    '@angular-devkit/build-angular': '~22.2.0',
+    '@angular-devkit/core': '~22.2.0',
+    '@angular-devkit/schematics': '~22.2.0',
+    '@angular-devkit/architect': '~0.2202.0',
+    '@angular-devkit/build-webpack': '~0.2202.0',
+    '@schematics/angular': '~22.2.0',
+    '@angular/aria': '~22.2.0',
+    '@angular/cdk': '~22.2.0',
+    '@angular/cdk-experimental': '~22.2.0',
+    '@angular/google-maps': '~22.2.0',
+    '@angular/material': '~22.2.0',
+    '@angular/material-date-fns-adapter': '~22.2.0',
+    '@angular/material-experimental': '~22.2.0',
+    '@angular/material-luxon-adapter': '~22.2.0',
+    '@angular/material-moment-adapter': '~22.2.0',
+    'ng-packagr': '~22.2.0',
+    'zone.js': '~0.16.2',
+};
+const COMPONENT_TESTING_SPECIFIER = /^(@?cypress\/angular|@nx\/angular\/plugins\/component-testing$)/;
+const MODULE_FEDERATION_SPECIFIER = /^(@module-federation\/(enhanced|node)|@nx\/module-federation|@nx\/angular\/(mf|module-federation))(\/|$)/;
+const MARKER_TEXT = /cypress\/angular|module-federation|@nx\/angular\/(mf|plugins\/component-testing)/;
+const NX_WEBPACK_EXECUTORS = new Set([
+    '@nx/angular:webpack-browser',
+    '@nx/angular:webpack-server',
+    '@nx/angular:module-federation-dev-server',
+    '@nx/angular:module-federation-dev-ssr',
+]);
+const WEBPACK_CONFIG_FILE = /^(webpack[\w.-]*|module-federation\.config)\.[cm]?[jt]s$/;
+const RESOLVE_EXTENSIONS = ['.ts', '.js', '.mjs', '.cjs', '.mts', '.cts'];
+const DEPENDENCY_FIELDS = [
+    'dependencies',
+    'devDependencies',
+    'optionalDependencies',
+    'peerDependencies',
+];
+let ts;
+async function upgradeToAngular222(tree) {
+    const scan = scanWorkspace(tree);
+    const unresolved = [];
+    const moduleFederationConfigs = findModuleFederationConfigs(tree, scan, unresolved);
+    const reasons = [];
+    if (scan.componentTestingFiles.length > 0) {
+        reasons.push(`Cypress component testing (${scan.componentTestingFiles.join(', ')}) fails with the webpack-dev-server 6 that Angular 22.2 installs (https://github.com/cypress-io/cypress/issues/34259)`);
+    }
+    if (moduleFederationConfigs.length > 0) {
+        reasons.push(`Module Federation builds (${moduleFederationConfigs.join(', ')}) fail with the webpack 5.111 that Angular 22.2 installs (https://github.com/module-federation/core/issues/5077)`);
+    }
+    else if (unresolved.length > 0 && scan.moduleFederationFiles.length > 0) {
+        reasons.push(`Module Federation fails with the webpack 5.111 that Angular 22.2 installs (https://github.com/module-federation/core/issues/5077). ${scan.moduleFederationFiles.join(', ')} import it, and the migration could not tell whether an Angular webpack build does: ${unresolved.join('; ')}`);
+    }
+    if (reasons.length > 0) {
+        const nextSteps = [
+            `Kept Angular 22.1. ${reasons.join('. ')}. A later Nx migration updates Angular once these issues are fixed. To update before then, move the Angular packages to 22.2 by hand and work around the issues.`,
+        ];
+        return { nextSteps, agentContext: nextSteps };
+    }
+    const declared = (0, devkit_1.readJson)(tree, 'package.json');
+    const { '@angular/core': core, ...others } = ANGULAR_22_2_VERSIONS;
+    // `@angular/core` goes to `dependencies` when the root does not declare it.
+    (0, devkit_1.addDependenciesToPackageJson)(tree, { '@angular/core': core }, Object.fromEntries(Object.entries(others).filter(([name]) => declared.dependencies?.[name] || declared.devDependencies?.[name])));
+}
+function scanWorkspace(tree) {
+    const scan = {
+        angularJsonPaths: [],
+        workspacePackages: new Set(),
+        declaredDependencies: new Map(),
+        componentTestingFiles: [],
+        moduleFederationFiles: [],
+    };
+    // Shared support libraries and config helpers can hold the imports, so the
+    // whole workspace is scanned.
+    (0, devkit_1.visitNotIgnoredFiles)(tree, '.', (filePath) => {
+        const fileName = (0, path_1.basename)(filePath);
+        if (fileName === 'angular.json') {
+            scan.angularJsonPaths.push(filePath);
+            return;
+        }
+        if (fileName === 'package.json') {
+            // Installs fail on a workspace package.json that doesn't parse, so
+            // skipping one loses no installed or linked package.
+            try {
+                const packageJson = (0, devkit_1.readJson)(tree, filePath);
+                if (typeof packageJson.name === 'string') {
+                    scan.workspacePackages.add(packageJson.name);
+                }
+                scan.declaredDependencies.set((0, path_1.dirname)(filePath), new Set(DEPENDENCY_FIELDS.flatMap((field) => Object.keys(packageJson[field] ?? {}))));
+            }
+            catch { }
+            return;
+        }
+        if (!/\.[cm]?[jt]sx?$/.test(filePath)) {
+            return;
+        }
+        const content = tree.read(filePath, 'utf-8');
+        if (!MARKER_TEXT.test(content)) {
+            return;
+        }
+        const { specifiers } = readModuleSpecifiers(filePath, content);
+        if (specifiers.some((s) => COMPONENT_TESTING_SPECIFIER.test(s))) {
+            scan.componentTestingFiles.push(filePath);
+        }
+        if (specifiers.some((s) => MODULE_FEDERATION_SPECIFIER.test(s))) {
+            scan.moduleFederationFiles.push(filePath);
+        }
+    });
+    return scan;
+}
+// The webpack config files of Angular webpack targets that import Module
+// Federation, following relative imports. An import or config the migration
+// cannot read is recorded in `unresolved`.
+function findModuleFederationConfigs(tree, scan, unresolved) {
+    const configs = new Set();
+    const visited = new Set();
+    const visit = (fromDir, specifier, importer) => {
+        if (MODULE_FEDERATION_SPECIFIER.test(specifier)) {
+            configs.add(importer);
+            return;
+        }
+        if (specifier.startsWith('.')) {
+            const filePath = resolveFile(tree, (0, devkit_1.joinPathFragments)(fromDir, specifier));
+            if (!filePath) {
+                unresolved.push(`${importer} loads "${specifier}", which is missing`);
+                return;
+            }
+            if (visited.has(filePath)) {
+                return;
+            }
+            visited.add(filePath);
+            const { specifiers, computed } = readModuleSpecifiers(filePath, tree.read(filePath, 'utf-8'));
+            if (computed) {
+                unresolved.push(`${filePath} has a computed require or import`);
+            }
+            for (const s of specifiers) {
+                visit((0, path_1.dirname)(filePath), s, filePath);
+            }
+            return;
+        }
+        if (!(0, internal_1.isBuiltinModuleImport)(specifier) &&
+            !isInstalledPackage(tree, fromDir, specifier, scan)) {
+            unresolved.push(`${importer} loads "${specifier}", which is not an installed package`);
+        }
+    };
+    const projectRoots = new Set();
+    const visitTarget = (executor, target, workspaceRoot, projectRoot, label) => {
+        if (!isAngularWebpackExecutor(executor)) {
+            return;
+        }
+        projectRoots.add(projectRoot);
+        for (const options of [
+            target.options,
+            ...Object.values(target.configurations ?? {}),
+        ]) {
+            for (const specifier of getWebpackConfigSpecifiers(executor, options ?? {}, projectRoot)) {
+                visit(workspaceRoot, specifier, label);
+            }
+        }
+    };
+    const targetDefaults = (0, devkit_1.readNxJson)(tree)?.targetDefaults;
+    for (const [projectName, project] of (0, devkit_1.getProjects)(tree)) {
+        for (const [targetName, target] of Object.entries(project.targets ?? {})) {
+            const defaults = (0, internal_1.readTargetDefaultsForTarget)(targetName, targetDefaults, target.executor, {
+                projectName,
+                projectNode: {
+                    name: projectName,
+                    type: project.projectType === 'application' ? 'app' : 'lib',
+                    data: project,
+                },
+            });
+            const merged = defaults
+                ? (0, internal_1.mergeTargetConfigurations)(target, defaults)
+                : target;
+            visitTarget(merged.executor, merged, '.', project.root, `${projectName}:${targetName}`);
+        }
+    }
+    for (const angularJsonPath of scan.angularJsonPaths) {
+        let angularJson;
+        try {
+            angularJson = (0, devkit_1.readJson)(tree, angularJsonPath);
+        }
+        catch {
+            unresolved.push(`${angularJsonPath} could not be parsed`);
+            continue;
+        }
+        const workspaceRoot = (0, path_1.dirname)(angularJsonPath);
+        for (const [projectName, project] of Object.entries(angularJson.projects ?? {})) {
+            const projectRoot = (0, devkit_1.joinPathFragments)(workspaceRoot, project.root ?? '');
+            for (const [targetName, target] of Object.entries(project.architect ?? project.targets ?? {})) {
+                visitTarget(target.builder, target, workspaceRoot, projectRoot, `${angularJsonPath} ${projectName}:${targetName}`);
+            }
+        }
+    }
+    // Configs a target does not reference directly, such as a remote's
+    // module-federation.config, are found by name.
+    for (const projectRoot of projectRoots) {
+        for (const child of tree.children(projectRoot)) {
+            if (WEBPACK_CONFIG_FILE.test(child)) {
+                visit(projectRoot, `./${child}`, projectRoot);
+            }
+        }
+    }
+    return [...configs];
+}
+function isAngularWebpackExecutor(executor) {
+    return (!!executor &&
+        (NX_WEBPACK_EXECUTORS.has(executor) ||
+            executor.startsWith('@angular-builders/custom-webpack:') ||
+            executor.startsWith('ngx-build-plus:')));
+}
+// The webpack config modules a target loads, as specifiers relative to the
+// workspace root.
+function getWebpackConfigSpecifiers(executor, options, projectRoot) {
+    const toSpecifier = (path) => `./${path
+        .replace(/^\{workspaceRoot\}\/?/, '')
+        .replace(/\{projectRoot\}/g, projectRoot)}`;
+    const { customWebpackConfig, extraWebpackConfig, plugin } = options;
+    const specifiers = [];
+    if (typeof customWebpackConfig?.path === 'string') {
+        specifiers.push(toSpecifier(customWebpackConfig.path));
+    }
+    else if (customWebpackConfig &&
+        executor.startsWith('@angular-builders/custom-webpack:')) {
+        specifiers.push('./webpack.config.js');
+    }
+    if (typeof extraWebpackConfig === 'string') {
+        specifiers.push(toSpecifier(extraWebpackConfig));
+    }
+    // ngx-build-plus loads a `~` plugin path from the workspace root and
+    // anything else as a module.
+    if (typeof plugin === 'string' && plugin) {
+        specifiers.push(plugin.startsWith('~') ? toSpecifier(plugin.slice(1)) : plugin);
+    }
+    return specifiers;
+}
+function resolveFile(tree, path) {
+    return [
+        path,
+        ...RESOLVE_EXTENSIONS.map((extension) => `${path}${extension}`),
+        ...RESOLVE_EXTENSIONS.map((extension) => (0, devkit_1.joinPathFragments)(path, `index${extension}`)),
+    ].find((candidate) => tree.isFile(candidate));
+}
+// A package installed in a node_modules folder the importer resolves from, or
+// declared by the importer's nearest package.json for Yarn PnP installs, which
+// have no node_modules. A workspace package or path alias points back into the
+// workspace, so it is not one.
+function isInstalledPackage(tree, fromDir, specifier, scan) {
+    const segments = specifier.split('/');
+    const packageName = segments
+        .slice(0, specifier.startsWith('@') ? 2 : 1)
+        .join('/');
+    if (scan.workspacePackages.has(packageName)) {
+        return false;
+    }
+    let nearestPackageJsonChecked = false;
+    for (let dir = fromDir;; dir = (0, path_1.dirname)(dir)) {
+        if (tree.exists((0, devkit_1.joinPathFragments)(dir, 'node_modules', packageName, 'package.json'))) {
+            return true;
+        }
+        const declared = scan.declaredDependencies.get(dir);
+        if (declared && !nearestPackageJsonChecked) {
+            nearestPackageJsonChecked = true;
+            if (declared.has(packageName)) {
+                return true;
+            }
+        }
+        if (dir === '.') {
+            return false;
+        }
+    }
+}
+// Specifiers of `import`/`export ... from`, `import x = require()`,
+// `import()` and `require()`. `computed` is set when an `import()` or
+// `require()` takes a value other than a string literal.
+function readModuleSpecifiers(filePath, content) {
+    ts ??= (0, internal_2.ensureTypescript)();
+    const sourceFile = ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true);
+    const specifiers = [];
+    let computed = false;
+    const visit = (node) => {
+        if ((ts.isImportDeclaration(node) || ts.isExportDeclaration(node)) &&
+            node.moduleSpecifier &&
+            ts.isStringLiteral(node.moduleSpecifier)) {
+            specifiers.push(node.moduleSpecifier.text);
+        }
+        else if (ts.isExternalModuleReference(node) &&
+            ts.isStringLiteral(node.expression)) {
+            specifiers.push(node.expression.text);
+        }
+        else if (ts.isCallExpression(node) &&
+            (node.expression.kind === ts.SyntaxKind.ImportKeyword ||
+                (ts.isIdentifier(node.expression) &&
+                    node.expression.text === 'require'))) {
+            const [argument] = node.arguments;
+            if (argument && ts.isStringLiteralLike(argument)) {
+                specifiers.push(argument.text);
+            }
+            else {
+                computed = true;
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return { specifiers, computed };
+}

package/dist/src/migrations/update-24-0-0/upgrade-to-angular-22-2.md

@@ -0,0 +1,46 @@
+#### Upgrade Angular to 22.2
+
+Updates the Angular packages of an Angular 22.1 workspace to 22.2, unless the workspace uses Cypress component testing or webpack Module Federation in an Angular project.
+
+Angular 22.2 installs webpack 5.111 and webpack-dev-server 6 through `@angular-devkit/build-angular`. Cypress rejects that webpack-dev-server when it starts Angular component tests ([cypress-io/cypress#34259](https://github.com/cypress-io/cypress/issues/34259)). Module Federation builds fail on that webpack ([module-federation/core#5077](https://github.com/module-federation/core/issues/5077)). The migration keeps the workspace on Angular 22.1 and reports why when it finds either of these:
+
+- An import from `cypress/angular`, `@cypress/angular` or one of their variants, or from `@nx/angular/plugins/component-testing`, in any file of the workspace.
+- An import from `@module-federation/enhanced`, `@module-federation/node`, `@nx/module-federation`, `@nx/angular/mf` or `@nx/angular/module-federation` in the webpack config of an Angular project.
+
+An Angular project is one with an `@nx/angular` webpack or Module Federation executor, an `@angular-builders/custom-webpack` builder or an `ngx-build-plus` builder. Targets are read from `project.json`, including executors inherited from `targetDefaults`, and from every `angular.json`. The migration reads the webpack configs these targets reference, the `webpack*` and `module-federation.config` files in the project root, and every file they import through a relative path. When a config imports something the migration cannot follow, such as a path alias or a workspace package, a Module Federation import anywhere in the workspace also keeps Angular 22.1.
+
+Rspack builds, Native Federation and `@angular-architects/module-federation` don't hold the update. The last one uses the container plugin built into webpack, which works with webpack 5.111.
+
+The migration updates only the packages that the root `package.json` declares, and a catalog reference is updated in the catalog. `@angular/core` is added to `dependencies` when the root doesn't declare it. A later Nx migration updates a workspace kept on Angular 22.1 once the upstream issues are fixed.
+
+#### Examples
+
+##### Before
+
+```jsonc title="package.json"
+{
+  "dependencies": {
+    "@angular/common": "~22.1.0",
+    "@angular/core": "~22.1.0",
+  },
+  "devDependencies": {
+    "@angular/cli": "~22.1.0",
+    "@angular-devkit/build-angular": "~22.1.0",
+  },
+}
+```
+
+##### After
+
+```jsonc title="package.json"
+{
+  "dependencies": {
+    "@angular/common": "~22.2.0",
+    "@angular/core": "~22.2.0",
+  },
+  "devDependencies": {
+    "@angular/cli": "~22.2.0",
+    "@angular-devkit/build-angular": "~22.2.0",
+  },
+}
+```