@nx/angular 24.0.0-pr.37405.acdaf31 → 24.0.0-rc.1

package/dist/src/generators/setup-mf/schema.json

@@ -1,99 +0,0 @@
-{
-  "$schema": "https://json-schema.org/schema",
-  "$id": "GeneratorAngularMFSetup",
-  "cli": "nx",
-  "title": "Generate Module Federation Setup for Angular App",
-  "description": "Create Module Federation configuration files for given Angular Application.",
-  "type": "object",
-  "properties": {
-    "appName": {
-      "type": "string",
-      "description": "The name of the application to generate the Module Federation configuration for.",
-      "$default": {
-        "$source": "argv",
-        "index": 0
-      },
-      "x-prompt": "What app would you like to generate a Module Federation configuration for?",
-      "x-dropdown": "projects"
-    },
-    "mfType": {
-      "type": "string",
-      "enum": ["host", "remote"],
-      "description": "Type of application to generate the Module Federation configuration for.",
-      "default": "remote"
-    },
-    "federationType": {
-      "type": "string",
-      "enum": ["static", "dynamic"],
-      "description": "Use either Static or Dynamic Module Federation pattern for the application.",
-      "default": "static"
-    },
-    "port": {
-      "type": "number",
-      "description": "The port at which the remote application should be served."
-    },
-    "remotes": {
-      "type": "array",
-      "description": "A list of remote application names that the Consumer (host) application should consume.",
-      "alias": "producers"
-    },
-    "host": {
-      "type": "string",
-      "description": "The name of the host application that the remote application will be consumed by.",
-      "alias": "consumer"
-    },
-    "routing": {
-      "type": "boolean",
-      "description": "Generate a routing setup to allow a Consumer (host) application to route to the Producer (remote) application.",
-      "x-priority": "important"
-    },
-    "skipFormat": {
-      "type": "boolean",
-      "description": "Skip formatting the workspace after the generator completes.",
-      "x-priority": "internal"
-    },
-    "skipPackageJson": {
-      "type": "boolean",
-      "default": false,
-      "description": "Do not add dependencies to `package.json`.",
-      "x-priority": "internal"
-    },
-    "skipE2E": {
-      "type": "boolean",
-      "default": false,
-      "description": "Do not set up E2E related config."
-    },
-    "e2eProjectName": {
-      "type": "string",
-      "description": "The project name of the associated E2E project for the application. This is only required for Cypress E2E projects that do not follow the naming convention `<appName>-e2e`."
-    },
-    "prefix": {
-      "type": "string",
-      "description": "The prefix to use for any generated component."
-    },
-    "standalone": {
-      "type": "boolean",
-      "description": "Whether the application is a standalone application.",
-      "default": true
-    },
-    "typescriptConfiguration": {
-      "type": "boolean",
-      "description": "Whether the module federation configuration and webpack configuration files should use TS.",
-      "default": true
-    },
-    "enableTypedLinting": {
-      "type": "boolean",
-      "description": "Whether to enable typed linting. For flat configs, this configures the recommended `parserOptions.projectService` and `tsconfigRootDir`. For legacy `.eslintrc` configs, this configures `parserOptions.project`. We do not enable this by default for lint performance reasons.",
-      "default": false
-    },
-    "setParserOptionsProject": {
-      "type": "boolean",
-      "description": "Deprecated alias for `enableTypedLinting`.",
-      "default": false,
-      "x-deprecated": "Use `enableTypedLinting` instead. This option will be removed in Nx v24."
-    }
-  },
-  "required": ["appName", "mfType"],
-  "additionalProperties": false,
-  "examplesFile": "../../../docs/setup-mf-examples.md"
-}

package/dist/src/generators/setup-mf/setup-mf.d.ts

@@ -1,4 +0,0 @@
-import { type GeneratorCallback, type Tree } from '@nx/devkit';
-import type { Schema } from './schema';
-export declare function setupMf(tree: Tree, rawOptions: Schema): Promise<GeneratorCallback>;
-export default setupMf;

package/dist/src/generators/setup-mf/setup-mf.js

@@ -1,90 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupMf = setupMf;
-const devkit_1 = require("@nx/devkit");
-const assert_supported_angular_version_1 = require("../../utils/assert-supported-angular-version");
-const versions_1 = require("../../utils/versions");
-const version_utils_1 = require("../utils/version-utils");
-const lib_1 = require("./lib");
-async function setupMf(tree, rawOptions) {
-    (0, assert_supported_angular_version_1.assertSupportedAngularVersion)(tree);
-    const options = (0, lib_1.normalizeOptions)(tree, rawOptions);
-    const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, options.appName);
-    const tasks = [];
-    if (options.mfType === 'remote') {
-        (0, lib_1.addRemoteToHost)(tree, {
-            appName: options.appName,
-            host: options.host,
-            standalone: options.standalone,
-            port: options.port,
-        });
-        (0, lib_1.addRemoteEntry)(tree, options, projectConfig.root);
-        (0, lib_1.removeDeadCodeFromRemote)(tree, options);
-        (0, lib_1.setupTspathForRemote)(tree, options);
-        if (!options.skipPackageJson) {
-            tasks.push((0, devkit_1.addDependenciesToPackageJson)(tree, {
-                '@module-federation/enhanced': versions_1.moduleFederationEnhancedVersion,
-            }, {
-                '@nx/web': versions_1.nxVersion,
-                '@nx/webpack': versions_1.nxVersion,
-                'webpack-merge': versions_1.webpackMergeVersion,
-                '@nx/module-federation': versions_1.nxVersion,
-            }));
-        }
-    }
-    const remotesWithPorts = (0, lib_1.getRemotesWithPorts)(tree, options);
-    (0, lib_1.generateWebpackConfig)(tree, options, projectConfig.root, remotesWithPorts);
-    (0, lib_1.changeBuildTarget)(tree, options);
-    (0, lib_1.updateTsConfig)(tree, options);
-    (0, lib_1.setupServeTarget)(tree, options);
-    if (options.mfType === 'host') {
-        (0, lib_1.setupHostIfDynamic)(tree, options);
-        (0, lib_1.updateHostAppRoutes)(tree, options);
-        for (const { remoteName, port } of remotesWithPorts) {
-            (0, lib_1.addRemoteToHost)(tree, {
-                appName: remoteName,
-                host: options.appName,
-                standalone: options.standalone,
-                port,
-            });
-        }
-        if (!options.skipPackageJson) {
-            tasks.push((0, devkit_1.addDependenciesToPackageJson)(tree, {}, {
-                '@nx/webpack': versions_1.nxVersion,
-                'webpack-merge': versions_1.webpackMergeVersion,
-                '@module-federation/enhanced': versions_1.moduleFederationEnhancedVersion,
-                '@nx/module-federation': versions_1.nxVersion,
-            }));
-        }
-    }
-    (0, lib_1.fixBootstrap)(tree, projectConfig.root, options);
-    if (options.mfType === 'host' || options.federationType === 'dynamic') {
-        /**
-         * Host applications and dynamic federation applications generate runtime
-         * code that depends on the @nx/angular plugin. Ensure that the plugin is
-         * in the production dependencies.
-         */
-        (0, lib_1.moveAngularPluginToDependencies)(tree);
-    }
-    if (!options.skipE2E) {
-        (0, lib_1.addCypressOnErrorWorkaround)(tree, options);
-    }
-    if (!options.skipPackageJson && options.typescriptConfiguration) {
-        // Angular custom-webpack loads webpack.config.ts at build time. Node native
-        // TS strip can't resolve the extensionless `./module-federation.config`
-        // import under strict ESM, so loadTsFile needs ts-node as the fallback.
-        tasks.push((0, devkit_1.addDependenciesToPackageJson)(tree, {}, { 'ts-node': versions_1.tsNodeVersion }, undefined, true));
-    }
-    if (!options.skipPackageJson) {
-        const angularDevkitVersion = (0, version_utils_1.getInstalledAngularDevkitVersion)(tree) ??
-            (0, version_utils_1.versions)(tree).angularDevkitVersion;
-        // the executors used by MF require @angular-devkit/build-angular
-        tasks.push((0, devkit_1.addDependenciesToPackageJson)(tree, {}, { '@angular-devkit/build-angular': angularDevkitVersion }, undefined, true));
-    }
-    // format files
-    if (!options.skipFormat) {
-        await (0, devkit_1.formatFiles)(tree);
-    }
-    return (0, devkit_1.runTasksInSerial)(...tasks);
-}
-exports.default = setupMf;

package/dist/src/generators/utils/add-mf-env-to-inputs.d.ts

@@ -1,2 +0,0 @@
-import { type Tree } from '@nx/devkit';
-export declare function addMfEnvToTargetDefaultInputs(tree: Tree): void;

package/dist/src/generators/utils/add-mf-env-to-inputs.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addMfEnvToTargetDefaultInputs = addMfEnvToTargetDefaultInputs;
-const devkit_1 = require("@nx/devkit");
-const internal_1 = require("@nx/devkit/internal");
-function addMfEnvToTargetDefaultInputs(tree) {
-    const nxJson = (0, devkit_1.readNxJson)(tree) ?? {};
-    const webpackExecutor = '@nx/angular:webpack-browser';
-    const mfEnvVar = 'NX_MF_DEV_REMOTES';
-    const defaultInputs = [
-        ...(nxJson.namedInputs && 'production' in nxJson.namedInputs
-            ? ['production', '^production']
-            : ['default', '^default']),
-    ];
-    const existing = (0, internal_1.findTargetDefault)(nxJson.targetDefaults, {
-        executor: webpackExecutor,
-    });
-    const inputs = [...(existing?.inputs ?? defaultInputs)];
-    let mfEnvVarExists = false;
-    for (const input of inputs) {
-        if (typeof input === 'object' && input['env'] === mfEnvVar) {
-            mfEnvVarExists = true;
-            break;
-        }
-    }
-    if (!mfEnvVarExists) {
-        inputs.push({ env: mfEnvVar });
-    }
-    (0, internal_1.upsertTargetDefault)(tree, nxJson, {
-        executor: webpackExecutor,
-        cache: true,
-        inputs,
-        dependsOn: existing?.dependsOn ?? ['^build'],
-    });
-    (0, devkit_1.updateNxJson)(tree, nxJson);
-}

package/dist/src/generators/utils/assert-mf-utils.d.ts

@@ -1 +0,0 @@
-export declare function assertRspackIsCSR(bundler: 'webpack' | 'rspack', ssr: boolean): void;

package/dist/src/generators/utils/assert-mf-utils.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertRspackIsCSR = assertRspackIsCSR;
-function assertRspackIsCSR(bundler, ssr) {
-    if (bundler === 'rspack' && ssr) {
-        throw new Error('SSR is not currently supported for Angular Rspack Module Federation. Please use webpack instead.');
-    }
-}

package/dist/src/generators/utils/export-scam.d.ts

@@ -1,11 +0,0 @@
-import type { Tree } from '@nx/devkit';
-export type GenerationOptions = {
-    directory: string;
-    filePath: string;
-    name: string;
-    projectName: string;
-    modulePath: string;
-    export?: boolean;
-    inlineScam?: boolean;
-};
-export declare function exportScam(tree: Tree, options: GenerationOptions): void;

package/dist/src/generators/utils/export-scam.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.exportScam = exportScam;
-const devkit_1 = require("@nx/devkit");
-const entry_point_1 = require("./entry-point");
-const path_1 = require("./path");
-function exportScam(tree, options) {
-    if (!options.export) {
-        return;
-    }
-    const { projectType, root, sourceRoot } = (0, devkit_1.readProjectConfiguration)(tree, options.projectName);
-    const projectSourceRoot = sourceRoot ?? (0, devkit_1.joinPathFragments)(root, 'src');
-    if (projectType === 'application') {
-        devkit_1.logger.warn('--export=true was ignored as the project the SCAM is being generated in is not a library.');
-        return;
-    }
-    const entryPointPath = (0, entry_point_1.locateLibraryEntryPointFromDirectory)(tree, options.directory, root, projectSourceRoot);
-    if (!entryPointPath) {
-        // Let's not error, simply warn the user
-        // It's not too much effort to manually do this
-        // It would be more frustrating to have to find the correct path and re-run the command
-        devkit_1.logger.warn(`Could not export SCAM. Unable to determine project's entry point. SCAM has still been created.`);
-        return;
-    }
-    const relativePathFromEntryPoint = (0, path_1.getRelativeImportToFile)(entryPointPath, options.filePath);
-    const entryPointContent = tree.read(entryPointPath, 'utf-8');
-    let updatedEntryPointContent = (0, devkit_1.stripIndents) `${entryPointContent}
-    export * from '${relativePathFromEntryPoint}';`;
-    if (!options.inlineScam) {
-        const relativePathFromModule = (0, path_1.getRelativeImportToFile)(entryPointPath, options.modulePath);
-        updatedEntryPointContent = (0, devkit_1.stripIndents) `${updatedEntryPointContent}
-        export * from '${relativePathFromModule}';`;
-    }
-    tree.write(entryPointPath, updatedEntryPointContent);
-}

package/dist/src/utils/get-mf-projects.d.ts

@@ -1,4 +0,0 @@
-import type { Tree } from '@nx/devkit';
-export declare function getMFProjects(tree: Tree, { legacy }?: {
-    legacy: boolean;
-}): string[];

package/dist/src/utils/get-mf-projects.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMFProjects = getMFProjects;
-const internal_1 = require("@nx/devkit/internal");
-function _getMfProjects(tree, CUSTOM_WEBPACK_OPTION, MODULE_FEDERATION_IDENTIFIER, projects) {
-    return (opts, projectName) => {
-        const webpackPath = opts[CUSTOM_WEBPACK_OPTION]?.path;
-        if (!webpackPath || !tree.exists(webpackPath)) {
-            return;
-        }
-        const webpackConfig = tree.read(webpackPath, 'utf-8');
-        const { ast, query } = require('@phenomnomnominal/tsquery');
-        const sourceFile = ast(webpackConfig);
-        const moduleFederationWebpackConfig = query(sourceFile, MODULE_FEDERATION_IDENTIFIER);
-        if (!moduleFederationWebpackConfig ||
-            moduleFederationWebpackConfig.length === 0) {
-            return;
-        }
-        projects.push(projectName);
-    };
-}
-function getMFProjects(tree, { legacy } = { legacy: false }) {
-    const CUSTOM_WEBPACK_OPTION = 'customWebpackConfig';
-    const MODULE_FEDERATION_IDENTIFIER = legacy
-        ? 'Identifier[name=ModuleFederationPlugin]'
-        : 'Identifier[name=withModuleFederation]';
-    const projects = [];
-    (0, internal_1.forEachExecutorOptions)(tree, '@nx/angular:webpack-browser', _getMfProjects(tree, CUSTOM_WEBPACK_OPTION, MODULE_FEDERATION_IDENTIFIER, projects));
-    (0, internal_1.forEachExecutorOptions)(tree, '@nrwl/angular:webpack-browser', _getMfProjects(tree, CUSTOM_WEBPACK_OPTION, MODULE_FEDERATION_IDENTIFIER, projects));
-    return projects;
-}

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

@@ -1,4 +0,0 @@
-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 warnAngularMfDevServerExecutorDeprecation(): void;
-export declare function warnAngularMfDevSsrExecutorDeprecation(): void;

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

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ANGULAR_MF_DEV_SSR_EXECUTOR_DEPRECATION_MESSAGE = exports.ANGULAR_MF_DEV_SERVER_EXECUTOR_DEPRECATION_MESSAGE = void 0;
-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_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}`;
-// 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/dist/types/nx-angular-mf.d.ts

@@ -1,72 +0,0 @@
-type ResolveRemoteUrlFunction = (remoteName: string) => string | Promise<string>;
-/**
- * @deprecated Use Runtime Helpers from '@module-federation/enhanced/runtime' instead. This will be removed in Nx 22.
- */
-declare function setRemoteUrlResolver(_resolveRemoteUrl: ResolveRemoteUrlFunction): void;
-/**
- * @deprecated Use init() from '@module-federation/enhanced/runtime' instead. This will be removed in Nx 22.
- * If you have a remote app called `my-remote-app` and you want to use the `http://localhost:4201/mf-manifest.json` as the remote url, you should change it from:
- * ```ts
- * import { setRemoteDefinitions } from '@nx/angular/mf';
- *
- * setRemoteDefinitions({
- *   'my-remote-app': 'http://localhost:4201/mf-manifest.json'
- * });
- * ```
- * to use init():
- * ```ts
- * import { init } from '@module-federation/enhanced/runtime';
- *
- * init({
- *   name: 'host',
- *   remotes: [{
- *     name: 'my-remote-app',
- *     entry: 'http://localhost:4201/mf-manifest.json'
- *   }]
- * });
- * ```
- */
-declare function setRemoteDefinitions(definitions: Record<string, string>): void;
-/**
- * @deprecated Use registerRemotes() from '@module-federation/enhanced/runtime' instead. This will be removed in Nx 22.
- * If you set a remote app with `setRemoteDefinition` such as:
- * ```ts
- * import { setRemoteDefinition } from '@nx/angular/mf';
- *
- * setRemoteDefinition(
- *   'my-remote-app',
- *   'http://localhost:4201/mf-manifest.json'
- * );
- * ```
- * change it to use registerRemotes():
- * ```ts
- * import { registerRemotes } from '@module-federation/enhanced/runtime';
- *
- * registerRemotes([
- *  {
- *     name: 'my-remote-app',
- *     entry: 'http://localhost:4201/mf-manifest.json'
- *   }
- * ]);
- * ```
- */
-declare function setRemoteDefinition(remoteName: string, remoteUrl: string): void;
-/**
- * @deprecated Use loadRemote() from '@module-federation/enhanced/runtime' instead. This will be removed in Nx 22.
- * If you set a load a remote with `loadRemoteModule` such as:
- * ```ts
- * import { loadRemoteModule } from '@nx/angular/mf';
- *
- * loadRemoteModule('my-remote-app', './Module').then(m => m.RemoteEntryModule);
- * ```
- * change it to use loadRemote():
- * ```ts
- * import { loadRemote } from '@module-federation/enhanced/runtime';
- *
- * loadRemote<typeof import('my-remote-app/Module')>('my-remote-app/Module').then(m => m.RemoteEntryModule);
- * ```
- */
-declare function loadRemoteModule(remoteName: string, moduleName: string): Promise<any>;
-
-export { loadRemoteModule, setRemoteDefinition, setRemoteDefinitions, setRemoteUrlResolver };
-//# sourceMappingURL=nx-angular-mf.d.ts.map

package/dist/types/nx-angular-mf.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"nx-angular-mf.d.ts","sources":["../../mf/mf.ts"],"mappings":"AAEM,KAAM,wBAAwB,oCAEtB,OAAO;AAOrB;;AAEG;AACH,iBAAgB,oBAAoB,oBACf,wBAAwB;AAO7C;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACH,iBAAgB,oBAAoB,cAAc,MAAM;AAIxD;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACH,iBAAgB,mBAAmB;AAQnC;;;;;;;;;;;;;;AAcG;AACH,iBAAsB,gBAAgB,0CAAuC,OAAA;;;;","names":[]}

package/dist/types/nx-angular.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"nx-angular.d.ts","sources":[],"mappings":"","names":[]}