@nx/angular 21.5.0-beta.1 → 21.5.0-beta.2

package/migrations.json

@@ -357,6 +357,23 @@
       "version": "21.5.0-beta.0",
       "description": "Set the 'tsConfig' option to build and test targets to help with Angular migration issues.",
       "factory": "./src/migrations/update-21-5-0/set-tsconfig-option"
+    },
+    "update-angular-cli-version-20-2-0": {
+      "cli": "nx",
+      "version": "21.5.0-beta.2",
+      "requires": {
+        "@angular/core": ">=20.2.0"
+      },
+      "description": "Update the @angular/cli package version to ~20.2.0.",
+      "factory": "./src/migrations/update-21-5-0/update-angular-cli"
+    },
+    "remove-default-karma-configuration-files": {
+      "version": "21.5.0-beta.2",
+      "requires": {
+        "@angular/core": ">=20.2.0"
+      },
+      "description": "Remove any Karma configuration files that only contain the default content. The default configuration is automatically available without a specific project configurationfile.",
+      "factory": "./src/migrations/update-21-5-0/remove-default-karma-configuration-files"
     }
   },
   "packageJsonUpdates": {
@@ -1915,6 +1932,158 @@
           "alwaysAddToPackageJson": false
         }
       }
+    },
+    "21.5.0": {
+      "version": "21.5.0-beta.2",
+      "x-prompt": "Do you want to update the Angular version to v20.2?",
+      "requires": {
+        "@angular/core": ">=20.1.0 <20.2.0"
+      },
+      "packages": {
+        "@angular-devkit/build-angular": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-devkit/core": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-devkit/schematics": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular/build": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular/pwa": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular/ssr": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@schematics/angular": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-devkit/architect": {
+          "version": "~0.2002.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-devkit/build-webpack": {
+          "version": "~0.2002.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular/core": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": true
+        },
+        "@angular/material": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular/cdk": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular/google-maps": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "ng-packagr": {
+          "version": "~20.2.0",
+          "alwaysAddToPackageJson": false
+        }
+      }
+    },
+    "21.5.0-angular-eslint": {
+      "version": "21.5.0-beta.2",
+      "requires": {
+        "@angular/core": ">= 20.0.0 < 21.0.0",
+        "typescript-eslint": "^8.0.0",
+        "eslint": "^8.57.0 || ^9.0.0"
+      },
+      "packages": {
+        "angular-eslint": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/eslint-plugin": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/eslint-plugin-template": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/template-parser": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/utils": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/schematics": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/test-utils": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/builder": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/bundled-angular-compiler": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        }
+      }
+    },
+    "21.5.0-@angular-eslint": {
+      "version": "21.5.0-beta.2",
+      "requires": {
+        "@angular/core": ">= 20.0.0 < 21.0.0",
+        "eslint": "^8.57.0 || ^9.0.0"
+      },
+      "packages": {
+        "@angular-eslint/eslint-plugin": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/eslint-plugin-template": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/template-parser": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/utils": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/schematics": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/test-utils": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/builder": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@angular-eslint/bundled-angular-compiler": {
+          "version": "^20.2.0",
+          "alwaysAddToPackageJson": false
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/angular",
-  "version": "21.5.0-beta.1",
+  "version": "21.5.0-beta.2",
   "private": false,
   "description": "The Nx Plugin for Angular contains executors, generators, and utilities for managing Angular applications and libraries within an Nx workspace. It provides: \n\n- Integration with libraries such as Storybook, Jest, ESLint, Tailwind CSS, Playwright and Cypress. \n\n- Generators to help scaffold code quickly (like: Micro Frontends, Libraries, both internal to your codebase and publishable to npm) \n\n- Single Component Application Modules (SCAMs) \n\n- NgRx helpers. \n\n- Utilities for automatic workspace refactoring.",
   "repository": {
@@ -58,14 +58,14 @@
     "migrations": "./migrations.json"
   },
   "dependencies": {
-    "@nx/devkit": "21.5.0-beta.1",
-    "@nx/eslint": "21.5.0-beta.1",
-    "@nx/js": "21.5.0-beta.1",
-    "@nx/module-federation": "21.5.0-beta.1",
-    "@nx/rspack": "21.5.0-beta.1",
-    "@nx/web": "21.5.0-beta.1",
-    "@nx/webpack": "21.5.0-beta.1",
-    "@nx/workspace": "21.5.0-beta.1",
+    "@nx/devkit": "21.5.0-beta.2",
+    "@nx/eslint": "21.5.0-beta.2",
+    "@nx/js": "21.5.0-beta.2",
+    "@nx/module-federation": "21.5.0-beta.2",
+    "@nx/rspack": "21.5.0-beta.2",
+    "@nx/web": "21.5.0-beta.2",
+    "@nx/webpack": "21.5.0-beta.2",
+    "@nx/workspace": "21.5.0-beta.2",
     "@phenomnomnominal/tsquery": "~5.0.1",
     "@typescript-eslint/type-utils": "^8.0.0",
     "enquirer": "~2.3.6",

package/spec/src/migrations/update-21-5-0/remove-default-karma-configuration-files.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=remove-default-karma-configuration-files.spec.d.ts.map

package/spec/src/migrations/update-21-5-0/remove-default-karma-configuration-files.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-default-karma-configuration-files.spec.d.ts","sourceRoot":"","sources":["../../../../../../../packages/angular/src/migrations/update-21-5-0/remove-default-karma-configuration-files.spec.ts"],"names":[],"mappings":""}

package/spec/src/migrations/update-21-5-0/update-angular-cli.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=update-angular-cli.spec.d.ts.map

package/spec/src/migrations/update-21-5-0/update-angular-cli.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-angular-cli.spec.d.ts","sourceRoot":"","sources":["../../../../../../../packages/angular/src/migrations/update-21-5-0/update-angular-cli.spec.ts"],"names":[],"mappings":""}

package/src/generators/convert-to-rspack/convert-to-rspack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert-to-rspack.d.ts","sourceRoot":"","sources":["../../../../../../packages/angular/src/generators/convert-to-rspack/convert-to-rspack.ts"],"names":[],"mappings":"AAAA,OAAO,EAcL,KAAK,iBAAiB,EAEtB,KAAK,IAAI,EACV,MAAM,YAAY,CAAC;AAiBpB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AA6StD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,qBAAqB,8BA+X9B;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"convert-to-rspack.d.ts","sourceRoot":"","sources":["../../../../../../packages/angular/src/generators/convert-to-rspack/convert-to-rspack.ts"],"names":[],"mappings":"AAAA,OAAO,EAcL,KAAK,iBAAiB,EAEtB,KAAK,IAAI,EACV,MAAM,YAAY,CAAC;AAapB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AA6StD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,qBAAqB,8BAuY9B;AAED,eAAe,eAAe,CAAC"}

package/src/generators/convert-to-rspack/convert-to-rspack.js

@@ -8,6 +8,7 @@ const enquirer_1 = require("enquirer");
 const path_1 = require("path");
 const posix_1 = require("path/posix");
 const versions_1 = require("../../utils/versions");
+const version_utils_1 = require("../utils/version-utils");
 const create_config_1 = require("./lib/create-config");
 const get_custom_webpack_config_1 = require("./lib/get-custom-webpack-config");
 const update_tsconfig_1 = require("./lib/update-tsconfig");
@@ -249,6 +250,10 @@ async function convertToRspack(tree, schema) {
     const targetsToRemove = [];
     let customWebpackConfigPath;
     (0, validate_supported_executor_1.validateSupportedBuildExecutor)(Object.values(project.targets));
+    const angularRspackVersion = (0, version_utils_1.getAngularRspackVersion)(tree);
+    if (!angularRspackVersion) {
+        throw new Error('Angular Rspack requires Angular 19 or higher. Please upgrade your Angular version before converting to Rspack.');
+    }
     let projectServePort = DEFAULT_PORT;
     for (const [targetName, target] of Object.entries(project.targets)) {
         if (target.executor === '@angular-devkit/build-angular:browser' ||
@@ -491,10 +496,11 @@ async function convertToRspack(tree, schema) {
         (0, devkit_1.writeJson)(tree, 'package.json', rootPkgJson);
     }
     if (!schema.skipInstall) {
+        const { webpackMergeVersion, tsNodeVersion } = (0, version_utils_1.versions)(tree);
         const installTask = (0, devkit_1.addDependenciesToPackageJson)(tree, {}, {
-            '@nx/angular-rspack': versions_1.angularRspackVersion,
-            'webpack-merge': versions_1.webpackMergeVersion,
-            'ts-node': versions_1.tsNodeVersion,
+            '@nx/angular-rspack': angularRspackVersion,
+            'webpack-merge': webpackMergeVersion,
+            'ts-node': tsNodeVersion,
         });
         tasks.push(installTask);
     }

package/src/generators/setup-mf/lib/fix-bootstrap.js

@@ -20,12 +20,12 @@ function fixBootstrap(tree, appRoot, options) {
         if (tree.exists((0, devkit_1.joinPathFragments)(appRoot, 'public/module-federation.manifest.json'))) {
             manifestPath = '/module-federation.manifest.json';
         }
-        const fetchMFManifestCode = `import { init } from '@module-federation/enhanced/runtime';
+        const fetchMFManifestCode = `import { registerRemotes } from '@module-federation/enhanced/runtime';
 
 fetch('${manifestPath}')
   .then((res) => res.json())
   .then((remotes: Record<string, string>) => Object.entries(remotes).map(([name, entry]) => ({ name,entry})))
-  .then(remotes => init({name: '${options.appName}', remotes}))
+  .then(remotes => registerRemotes(remotes))
   .then(() => ${bootstrapImportCode});`;
         tree.write(mainFilePath, fetchMFManifestCode);
     }

package/src/generators/utils/version-utils.d.ts

@@ -13,4 +13,9 @@ export declare function getInstalledPackageVersionInfo(tree: Tree, pkgName: stri
     version: string;
 };
 export declare function versions(tree: Tree): PackageLatestVersions | PackageCompatVersions;
+/**
+ * Temporary helper to abstract away the version of angular-rspack to be installed
+ * until we stop supporting Angular 19.
+ */
+export declare function getAngularRspackVersion(tree: Tree): string | null;
 //# sourceMappingURL=version-utils.d.ts.map

package/src/generators/utils/version-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/angular/src/generators/utils/version-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC3B,MAAM,0CAA0C,CAAC;AAIlD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAK1E;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAgB7D;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAElE;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,IAAI;;;EAOxD;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAKf;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM;;;EAIzE;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,IAAI,GACT,qBAAqB,GAAG,qBAAqB,CAU/C"}
+{"version":3,"file":"version-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/angular/src/generators/utils/version-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC3B,MAAM,0CAA0C,CAAC;AAIlD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAK1E;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAgB7D;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAElE;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,IAAI;;;EAOxD;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAKf;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM;;;EAIzE;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,IAAI,GACT,qBAAqB,GAAG,qBAAqB,CAU/C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAcjE"}

package/src/generators/utils/version-utils.js

@@ -7,6 +7,7 @@ exports.getInstalledAngularVersionInfo = getInstalledAngularVersionInfo;
 exports.getInstalledPackageVersion = getInstalledPackageVersion;
 exports.getInstalledPackageVersionInfo = getInstalledPackageVersionInfo;
 exports.versions = versions;
+exports.getAngularRspackVersion = getAngularRspackVersion;
 const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
 const semver_1 = require("semver");
@@ -57,3 +58,20 @@ function versions(tree) {
             return latestVersions;
     }
 }
+/**
+ * Temporary helper to abstract away the version of angular-rspack to be installed
+ * until we stop supporting Angular 19.
+ */
+function getAngularRspackVersion(tree) {
+    const majorAngularVersion = getInstalledAngularMajorVersion(tree);
+    if (majorAngularVersion === 19) {
+        return backward_compatible_versions_1.backwardCompatibleVersions.angularV19.angularRspackVersion;
+    }
+    if (majorAngularVersion >= 20) {
+        // Starting with Angular 20, we can use an Angular Rspack version that is
+        // aligned with the Nx version
+        return latestVersions.nxVersion;
+    }
+    // Lower versions of Angular are not supported
+    return null;
+}

package/src/migrations/update-21-5-0/remove-default-karma-configuration-files.d.ts

@@ -0,0 +1,3 @@
+import { type Tree } from '@nx/devkit';
+export default function (tree: Tree): Promise<void>;
+//# sourceMappingURL=remove-default-karma-configuration-files.d.ts.map

package/src/migrations/update-21-5-0/remove-default-karma-configuration-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-default-karma-configuration-files.d.ts","sourceRoot":"","sources":["../../../../../../packages/angular/src/migrations/update-21-5-0/remove-default-karma-configuration-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,IAAI,EACV,MAAM,YAAY,CAAC;AAQpB,yBAA+B,IAAI,EAAE,IAAI,iBA4DxC"}

package/src/migrations/update-21-5-0/remove-default-karma-configuration-files.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const devkit_1 = require("@nx/devkit");
+const targets_1 = require("../../utils/targets");
+const karma_config_analyzer_1 = require("./utils/karma-config-analyzer");
+const karma_config_comparer_1 = require("./utils/karma-config-comparer");
+async function default_1(tree) {
+    const removableKarmaConfigs = new Map();
+    const projects = (0, devkit_1.getProjects)(tree);
+    for (const [projectName, project] of projects) {
+        for (const [, target] of (0, targets_1.allProjectTargets)(project)) {
+            let needDevkitPlugin = false;
+            switch (target.executor) {
+                case '@angular-devkit/build-angular:karma':
+                    needDevkitPlugin = true;
+                    break;
+                case '@angular/build:karma':
+                    break;
+                default:
+                    continue;
+            }
+            for (const [, options] of (0, targets_1.allTargetOptions)(target)) {
+                const karmaConfig = options['karmaConfig'];
+                if (typeof karmaConfig !== 'string') {
+                    continue;
+                }
+                let isRemovable = removableKarmaConfigs.get(karmaConfig);
+                if (isRemovable === undefined && tree.exists(karmaConfig)) {
+                    const content = tree.read(karmaConfig, 'utf-8');
+                    const analysis = (0, karma_config_analyzer_1.analyzeKarmaConfig)(content);
+                    if (analysis.hasUnsupportedValues) {
+                        // Cannot safely determine if the file is removable.
+                        isRemovable = false;
+                    }
+                    else {
+                        const diff = await (0, karma_config_comparer_1.compareKarmaConfigToDefault)(analysis, projectName, karmaConfig, needDevkitPlugin);
+                        isRemovable = !(0, karma_config_comparer_1.hasDifferences)(diff) && diff.isReliable;
+                    }
+                    removableKarmaConfigs.set(karmaConfig, isRemovable);
+                    if (isRemovable) {
+                        tree.delete(karmaConfig);
+                    }
+                }
+                if (isRemovable) {
+                    delete options['karmaConfig'];
+                    (0, devkit_1.updateProjectConfiguration)(tree, projectName, project);
+                }
+            }
+        }
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}

package/src/migrations/update-21-5-0/update-angular-cli.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+export declare const angularCliVersion = "~20.2.0";
+export default function (tree: Tree): Promise<void>;
+//# sourceMappingURL=update-angular-cli.d.ts.map

package/src/migrations/update-21-5-0/update-angular-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-angular-cli.d.ts","sourceRoot":"","sources":["../../../../../../packages/angular/src/migrations/update-21-5-0/update-angular-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,IAAI,EAAc,MAAM,YAAY,CAAC;AAE3D,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,yBAA+B,IAAI,EAAE,IAAI,iBAkBxC"}

package/src/migrations/update-21-5-0/update-angular-cli.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angularCliVersion = void 0;
+exports.default = default_1;
+const devkit_1 = require("@nx/devkit");
+exports.angularCliVersion = '~20.2.0';
+async function default_1(tree) {
+    let shouldFormat = false;
+    (0, devkit_1.updateJson)(tree, 'package.json', (json) => {
+        if (json.devDependencies?.['@angular/cli']) {
+            json.devDependencies['@angular/cli'] = exports.angularCliVersion;
+            shouldFormat = true;
+        }
+        else if (json.dependencies?.['@angular/cli']) {
+            json.dependencies['@angular/cli'] = exports.angularCliVersion;
+            shouldFormat = true;
+        }
+        return json;
+    });
+    if (shouldFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+}

package/src/migrations/update-21-5-0/utils/karma-config-analyzer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+export interface RequireInfo {
+    module: string;
+    export?: string;
+    isCall?: boolean;
+    arguments?: KarmaConfigValue[];
+}
+export type KarmaConfigValue = string | boolean | number | KarmaConfigValue[] | {
+    [key: string]: KarmaConfigValue;
+} | RequireInfo | undefined;
+export interface KarmaConfigAnalysis {
+    settings: Map<string, KarmaConfigValue>;
+    hasUnsupportedValues: boolean;
+}
+/**
+ * Analyzes the content of a Karma configuration file to extract its settings.
+ *
+ * @param content The string content of the `karma.conf.js` file.
+ * @returns An object containing the configuration settings and a flag indicating if unsupported values were found.
+ */
+export declare function analyzeKarmaConfig(content: string): KarmaConfigAnalysis;
+//# sourceMappingURL=karma-config-analyzer.d.ts.map

package/src/migrations/update-21-5-0/utils/karma-config-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"karma-config-analyzer.d.ts","sourceRoot":"","sources":["../../../../../../../packages/angular/src/migrations/update-21-5-0/utils/karma-config-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,OAAO,GACP,MAAM,GACN,gBAAgB,EAAE,GAClB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,GACnC,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxC,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CA+HvE"}

package/src/migrations/update-21-5-0/utils/karma-config-analyzer.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeKarmaConfig = analyzeKarmaConfig;
+/**
+ * Adapts the private utility from Angular CLI to be used in the migration.
+ */
+const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
+let ts;
+/**
+ * Analyzes the content of a Karma configuration file to extract its settings.
+ *
+ * @param content The string content of the `karma.conf.js` file.
+ * @returns An object containing the configuration settings and a flag indicating if unsupported values were found.
+ */
+function analyzeKarmaConfig(content) {
+    if (!ts) {
+        ts = (0, ensure_typescript_1.ensureTypescript)();
+    }
+    const sourceFile = ts.createSourceFile('karma.conf.js', content, ts.ScriptTarget.Latest, true);
+    const settings = new Map();
+    let hasUnsupportedValues = false;
+    function visit(node) {
+        // The Karma configuration is defined within a `config.set({ ... })` call.
+        if (ts.isCallExpression(node) &&
+            ts.isPropertyAccessExpression(node.expression) &&
+            node.expression.expression.getText(sourceFile) === 'config' &&
+            node.expression.name.text === 'set' &&
+            node.arguments.length === 1 &&
+            ts.isObjectLiteralExpression(node.arguments[0])) {
+            // We found `config.set`, now we extract the properties from the object literal.
+            for (const prop of node.arguments[0].properties) {
+                if (isSupportedPropertyAssignment(prop)) {
+                    const key = prop.name.text;
+                    const value = extractValue(prop.initializer);
+                    settings.set(key, value);
+                }
+                else {
+                    hasUnsupportedValues = true;
+                }
+            }
+        }
+        else {
+            ts.forEachChild(node, visit);
+        }
+    }
+    function extractValue(node) {
+        switch (node.kind) {
+            case ts.SyntaxKind.StringLiteral:
+                return node.text;
+            case ts.SyntaxKind.NumericLiteral:
+                return Number(node.text);
+            case ts.SyntaxKind.TrueKeyword:
+                return true;
+            case ts.SyntaxKind.FalseKeyword:
+                return false;
+            case ts.SyntaxKind.Identifier: {
+                const identifier = node.text;
+                if (identifier === '__dirname' || identifier === '__filename') {
+                    return identifier;
+                }
+                break;
+            }
+            case ts.SyntaxKind.CallExpression: {
+                const callExpr = node;
+                // Handle require('...')
+                if (ts.isIdentifier(callExpr.expression) &&
+                    callExpr.expression.text === 'require' &&
+                    callExpr.arguments.length === 1 &&
+                    ts.isStringLiteral(callExpr.arguments[0])) {
+                    return { module: callExpr.arguments[0].text };
+                }
+                // Handle calls on a require, e.g. require('path').join()
+                const calleeValue = extractValue(callExpr.expression);
+                if (isRequireInfo(calleeValue)) {
+                    return {
+                        ...calleeValue,
+                        isCall: true,
+                        arguments: callExpr.arguments.map(extractValue),
+                    };
+                }
+                break;
+            }
+            case ts.SyntaxKind.PropertyAccessExpression: {
+                const propAccessExpr = node;
+                // Handle config constants like `config.LOG_INFO`
+                if (ts.isIdentifier(propAccessExpr.expression) &&
+                    propAccessExpr.expression.text === 'config') {
+                    return `config.${propAccessExpr.name.text}`;
+                }
+                const value = extractValue(propAccessExpr.expression);
+                if (isRequireInfo(value)) {
+                    const currentExport = value.export
+                        ? `${value.export}.${propAccessExpr.name.text}`
+                        : propAccessExpr.name.text;
+                    return { ...value, export: currentExport };
+                }
+                break;
+            }
+            case ts.SyntaxKind.ArrayLiteralExpression:
+                return node.elements.map(extractValue);
+            case ts.SyntaxKind.ObjectLiteralExpression: {
+                const obj = {};
+                for (const prop of node.properties) {
+                    if (isSupportedPropertyAssignment(prop)) {
+                        // Recursively extract values for nested objects.
+                        obj[prop.name.text] = extractValue(prop.initializer);
+                    }
+                    else {
+                        hasUnsupportedValues = true;
+                    }
+                }
+                return obj;
+            }
+        }
+        // For complex expressions (like variables) that we don't need to resolve,
+        // we mark the analysis as potentially incomplete.
+        hasUnsupportedValues = true;
+        return undefined;
+    }
+    visit(sourceFile);
+    return { settings, hasUnsupportedValues };
+}
+function isRequireInfo(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        'module' in value);
+}
+function isSupportedPropertyAssignment(prop) {
+    return (ts.isPropertyAssignment(prop) &&
+        (ts.isIdentifier(prop.name) || ts.isStringLiteral(prop.name)));
+}