@nx/angular 23.0.0-beta.20 → 23.0.0-beta.22

package/src/migrations/update-23-0-0/migrate-ngrx-generator-defaults.md

@@ -0,0 +1,46 @@
+#### Split `@nx/angular:ngrx` generator defaults across the replacement generators
+
+Splits any `@nx/angular:ngrx` generator defaults set in `nx.json` or in project-level `project.json` files across the two replacement generators: `@nx/angular:ngrx-root-store` (for root state) and `@nx/angular:ngrx-feature-store` (for feature state). The `@nx/angular:ngrx` generator was removed in Nx v23.
+
+Shared options apply to both keys; `barrels` and `parent` are written only to `@nx/angular:ngrx-feature-store` (the `@nx/angular:ngrx-root-store` schema doesn't accept them). The `minimal` option is written only to `@nx/angular:ngrx-root-store` because its semantics differ between the two new generators (see Notes). The deprecated `module` option is renamed to `parent`. The obsolete `root` toggle is dropped — intent is now expressed by which generator is invoked. Existing defaults already set under the new keys are preserved.
+
+#### Examples
+
+##### Before
+
+```json title="nx.json"
+{
+  "generators": {
+    "@nx/angular:ngrx": {
+      "facade": true,
+      "minimal": true,
+      "barrels": true,
+      "module": "libs/my-lib/src/lib/my-lib-module.ts"
+    }
+  }
+}
+```
+
+##### After
+
+```json title="nx.json"
+{
+  "generators": {
+    "@nx/angular:ngrx-root-store": {
+      "facade": true,
+      "minimal": true
+    },
+    "@nx/angular:ngrx-feature-store": {
+      "facade": true,
+      "barrels": true,
+      "parent": "libs/my-lib/src/lib/my-lib-module.ts"
+    }
+  }
+}
+```
+
+#### Notes
+
+The `minimal` option is intentionally not propagated to `@nx/angular:ngrx-feature-store`. In the deprecated `@nx/angular:ngrx` generator, `minimal` only gated root-state file generation and was a no-op for feature-state usage. In `@nx/angular:ngrx-feature-store`, `minimal: true` skips template generation while still wiring imports to the (now missing) files, which would produce broken modules.
+
+The split is otherwise intentionally inclusive: shared options are written to both new keys so users can trim the ones they don't want. CLI invocations of `@nx/angular:ngrx` (in shell scripts, CI, or `package.json`) are not migrated — update those manually to call `@nx/angular:ngrx-root-store` or `@nx/angular:ngrx-feature-store`.

package/src/migrations/update-23-0-0/migrate-with-mf-import-to-new-package.md

@@ -0,0 +1,27 @@
+#### Update withModuleFederation Import to New Package
+
+Updates the `withModuleFederation` and `withModuleFederationForSSR` imports to use `@nx/module-federation/angular`. The `@nx/angular/module-federation` re-export path was deprecated in Nx v20.2 and is now removed.
+
+#### Examples
+
+##### Before
+
+```ts title="apps/shell/webpack.config.ts"
+import {
+  withModuleFederation,
+  withModuleFederationForSSR,
+} from '@nx/angular/module-federation';
+```
+
+##### After
+
+```ts title="apps/shell/webpack.config.ts"
+import {
+  withModuleFederation,
+  withModuleFederationForSSR,
+} from '@nx/module-federation/angular';
+```
+
+#### Notes
+
+This migration runs for all projects in the workspace that depend on `@nx/angular`, ensuring imports are updated when migrating to Nx v23.

package/src/utils/module-federation-deprecation.d.ts

@@ -0,0 +1,13 @@
+export declare const ANGULAR_HOST_GENERATOR_DEPRECATION_MESSAGE = "The `@nx/angular:host` generator is deprecated and will be removed in Nx v24. Angular Module Federation in Nx is no longer supported. Use `@angular-architects/native-federation` (https://www.npmjs.com/package/@angular-architects/native-federation) for the supported Angular path. See https://nx.dev/docs/technologies/module-federation/consumer-and-provider for the v23 migration guide.";
+export declare const ANGULAR_REMOTE_GENERATOR_DEPRECATION_MESSAGE = "The `@nx/angular:remote` generator is deprecated and will be removed in Nx v24. Angular Module Federation in Nx is no longer supported. Use `@angular-architects/native-federation` (https://www.npmjs.com/package/@angular-architects/native-federation) for the supported Angular path. See https://nx.dev/docs/technologies/module-federation/consumer-and-provider for the v23 migration guide.";
+export declare const ANGULAR_SETUP_MF_GENERATOR_DEPRECATION_MESSAGE = "The `@nx/angular:setup-mf` generator is deprecated and will be removed in Nx v24. Angular Module Federation in Nx is no longer supported. Use `@angular-architects/native-federation` (https://www.npmjs.com/package/@angular-architects/native-federation) for the supported Angular path. See https://nx.dev/docs/technologies/module-federation/consumer-and-provider for the v23 migration guide.";
+export declare const ANGULAR_FEDERATE_MODULE_GENERATOR_DEPRECATION_MESSAGE = "The `@nx/angular:federate-module` generator is deprecated and will be removed in Nx v24. Angular Module Federation in Nx is no longer supported. Use `@angular-architects/native-federation` (https://www.npmjs.com/package/@angular-architects/native-federation) for the supported Angular path. See https://nx.dev/docs/technologies/module-federation/consumer-and-provider for the v23 migration guide.";
+export declare const ANGULAR_MF_DEV_SERVER_EXECUTOR_DEPRECATION_MESSAGE = "The `@nx/angular:module-federation-dev-server` executor is deprecated and will be removed in Nx v24. Angular Module Federation in Nx is no longer supported. Use `@angular-architects/native-federation` (https://www.npmjs.com/package/@angular-architects/native-federation) for the supported Angular path. See https://nx.dev/docs/technologies/module-federation/consumer-and-provider for the v23 migration guide.";
+export declare const ANGULAR_MF_DEV_SSR_EXECUTOR_DEPRECATION_MESSAGE = "The `@nx/angular:module-federation-dev-ssr` executor is deprecated and will be removed in Nx v24. Angular Module Federation in Nx is no longer supported. Use `@angular-architects/native-federation` (https://www.npmjs.com/package/@angular-architects/native-federation) for the supported Angular path. See https://nx.dev/docs/technologies/module-federation/consumer-and-provider for the v23 migration guide.";
+export declare function warnAngularHostGeneratorDeprecation(): void;
+export declare function warnAngularRemoteGeneratorDeprecation(): void;
+export declare function warnAngularSetupMfGeneratorDeprecation(): void;
+export declare function warnAngularFederateModuleGeneratorDeprecation(): void;
+export declare function warnAngularMfDevServerExecutorDeprecation(): void;
+export declare function warnAngularMfDevSsrExecutorDeprecation(): void;
+//# sourceMappingURL=module-federation-deprecation.d.ts.map

package/src/utils/module-federation-deprecation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-federation-deprecation.d.ts","sourceRoot":"","sources":["../../../../../packages/angular/src/utils/module-federation-deprecation.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,0CAA0C,sYAA0G,CAAC;AAElK,eAAO,MAAM,4CAA4C,wYAA4G,CAAC;AAEtK,eAAO,MAAM,8CAA8C,0YAA8G,CAAC;AAE1K,eAAO,MAAM,qDAAqD,iZAAqH,CAAC;AAExL,eAAO,MAAM,kDAAkD,6ZAAiI,CAAC;AAEjM,eAAO,MAAM,+CAA+C,0ZAA8H,CAAC;AAE3L,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D;AAED,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D;AAED,wBAAgB,sCAAsC,IAAI,IAAI,CAE7D;AAED,wBAAgB,6CAA6C,IAAI,IAAI,CAEpE;AAUD,wBAAgB,yCAAyC,IAAI,IAAI,CAKhE;AAED,wBAAgB,sCAAsC,IAAI,IAAI,CAK7D"}

package/src/utils/module-federation-deprecation.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANGULAR_MF_DEV_SSR_EXECUTOR_DEPRECATION_MESSAGE = exports.ANGULAR_MF_DEV_SERVER_EXECUTOR_DEPRECATION_MESSAGE = exports.ANGULAR_FEDERATE_MODULE_GENERATOR_DEPRECATION_MESSAGE = exports.ANGULAR_SETUP_MF_GENERATOR_DEPRECATION_MESSAGE = exports.ANGULAR_REMOTE_GENERATOR_DEPRECATION_MESSAGE = exports.ANGULAR_HOST_GENERATOR_DEPRECATION_MESSAGE = void 0;
+exports.warnAngularHostGeneratorDeprecation = warnAngularHostGeneratorDeprecation;
+exports.warnAngularRemoteGeneratorDeprecation = warnAngularRemoteGeneratorDeprecation;
+exports.warnAngularSetupMfGeneratorDeprecation = warnAngularSetupMfGeneratorDeprecation;
+exports.warnAngularFederateModuleGeneratorDeprecation = warnAngularFederateModuleGeneratorDeprecation;
+exports.warnAngularMfDevServerExecutorDeprecation = warnAngularMfDevServerExecutorDeprecation;
+exports.warnAngularMfDevSsrExecutorDeprecation = warnAngularMfDevSsrExecutorDeprecation;
+const devkit_1 = require("@nx/devkit");
+// TODO(v24): Remove all Angular Module Federation surfaces from @nx/angular.
+// Angular Native Federation (@angular-architects/native-federation) is the
+// supported Angular MF path going forward; the new @nx/module-federation
+// generators are React-only.
+const MIGRATION_URL = 'https://nx.dev/docs/technologies/module-federation/consumer-and-provider';
+const ANGULAR_NATIVE_FED_URL = 'https://www.npmjs.com/package/@angular-architects/native-federation';
+const ANGULAR_MF_TRAILER = `Angular Module Federation in Nx is no longer supported. Use \`@angular-architects/native-federation\` (${ANGULAR_NATIVE_FED_URL}) for the supported Angular path. See ${MIGRATION_URL} for the v23 migration guide.`;
+exports.ANGULAR_HOST_GENERATOR_DEPRECATION_MESSAGE = `The \`@nx/angular:host\` generator is deprecated and will be removed in Nx v24. ${ANGULAR_MF_TRAILER}`;
+exports.ANGULAR_REMOTE_GENERATOR_DEPRECATION_MESSAGE = `The \`@nx/angular:remote\` generator is deprecated and will be removed in Nx v24. ${ANGULAR_MF_TRAILER}`;
+exports.ANGULAR_SETUP_MF_GENERATOR_DEPRECATION_MESSAGE = `The \`@nx/angular:setup-mf\` generator is deprecated and will be removed in Nx v24. ${ANGULAR_MF_TRAILER}`;
+exports.ANGULAR_FEDERATE_MODULE_GENERATOR_DEPRECATION_MESSAGE = `The \`@nx/angular:federate-module\` generator is deprecated and will be removed in Nx v24. ${ANGULAR_MF_TRAILER}`;
+exports.ANGULAR_MF_DEV_SERVER_EXECUTOR_DEPRECATION_MESSAGE = `The \`@nx/angular:module-federation-dev-server\` executor is deprecated and will be removed in Nx v24. ${ANGULAR_MF_TRAILER}`;
+exports.ANGULAR_MF_DEV_SSR_EXECUTOR_DEPRECATION_MESSAGE = `The \`@nx/angular:module-federation-dev-ssr\` executor is deprecated and will be removed in Nx v24. ${ANGULAR_MF_TRAILER}`;
+function warnAngularHostGeneratorDeprecation() {
+    devkit_1.logger.warn(exports.ANGULAR_HOST_GENERATOR_DEPRECATION_MESSAGE);
+}
+function warnAngularRemoteGeneratorDeprecation() {
+    devkit_1.logger.warn(exports.ANGULAR_REMOTE_GENERATOR_DEPRECATION_MESSAGE);
+}
+function warnAngularSetupMfGeneratorDeprecation() {
+    devkit_1.logger.warn(exports.ANGULAR_SETUP_MF_GENERATOR_DEPRECATION_MESSAGE);
+}
+function warnAngularFederateModuleGeneratorDeprecation() {
+    devkit_1.logger.warn(exports.ANGULAR_FEDERATE_MODULE_GENERATOR_DEPRECATION_MESSAGE);
+}
+// Executor warnings fire once per process to avoid flooding dev-server loops.
+const executorWarned = new Set();
+function warnOnce(key, message) {
+    if (executorWarned.has(key))
+        return;
+    executorWarned.add(key);
+    devkit_1.logger.warn(message);
+}
+function warnAngularMfDevServerExecutorDeprecation() {
+    warnOnce('angular-mf-dev-server', exports.ANGULAR_MF_DEV_SERVER_EXECUTOR_DEPRECATION_MESSAGE);
+}
+function warnAngularMfDevSsrExecutorDeprecation() {
+    warnOnce('angular-mf-dev-ssr', exports.ANGULAR_MF_DEV_SSR_EXECUTOR_DEPRECATION_MESSAGE);
+}

package/src/utils/versions.d.ts

@@ -4,7 +4,7 @@ export declare const angularDevkitVersion = "~21.2.0";
 export declare const ngPackagrVersion = "~21.2.0";
 export declare const ngrxVersion = "^21.0.0";
 export declare const rxjsVersion = "~7.8.0";
-export declare const zoneJsVersion = "~0.15.0";
+export declare const zoneJsVersion = "~0.16.0";
 export declare const tsLibVersion = "^2.3.0";
 export declare const corsVersion = "~2.8.5";
 export declare const typesCorsVersion = "~2.8.5";

package/src/utils/versions.js

@@ -7,7 +7,7 @@ exports.angularDevkitVersion = '~21.2.0';
 exports.ngPackagrVersion = '~21.2.0';
 exports.ngrxVersion = '^21.0.0';
 exports.rxjsVersion = '~7.8.0';
-exports.zoneJsVersion = '~0.15.0';
+exports.zoneJsVersion = '~0.16.0';
 exports.tsLibVersion = '^2.3.0';
 exports.corsVersion = '~2.8.5';
 exports.typesCorsVersion = '~2.8.5';