@nx/angular 23.0.0-pr.35465.2bc2643 → 23.0.0-rc.1

package/dist/src/utils/nx-devkit/route-utils.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addRoute = addRoute;
+exports.addProviderToRoute = addProviderToRoute;
+const js_1 = require("@nx/js");
+const ast_utils_1 = require("./ast-utils");
+const internal_1 = require("@nx/js/internal");
+let tsModule;
+/**
+ * Add a new route to a routes definition
+ * @param tree Virtual Tree
+ * @param routesFile File containing the routes definition
+ * @param route Route to add
+ * @param lazy If Route should be lazy-loaded
+ * @param routesConst Used when eager-loading a route: Class name of the Component
+ * @param importPath Used when eager-loading a route: The import path to the Component
+ */
+function addRoute(tree, routesFile, route, lazy = true, routesConst, importPath) {
+    if (!tree.exists(routesFile)) {
+        throw new Error(`Path to parent routing declaration (${routesFile}) does not exist. Please ensure path is correct.`);
+    }
+    if (!tsModule) {
+        tsModule = (0, internal_1.ensureTypescript)();
+    }
+    const { ast, query } = require('@phenomnomnominal/tsquery');
+    let routesFileContents = tree.read(routesFile, 'utf-8');
+    if (!lazy) {
+        let parentSourceFile = tsModule.createSourceFile(routesFile, routesFileContents, tsModule.ScriptTarget.Latest, true);
+        parentSourceFile = (0, js_1.insertImport)(tree, parentSourceFile, routesFile, routesConst, importPath);
+        routesFileContents = tree.read(routesFile, 'utf-8');
+    }
+    const sourceFile = ast(routesFileContents);
+    const ROUTES_ARRAY_SELECTOR = 'VariableDeclaration:has(ArrayType > TypeReference > Identifier[name=Route], Identifier[name=Routes]) > ArrayLiteralExpression';
+    const routesArrayNodes = query(sourceFile, ROUTES_ARRAY_SELECTOR);
+    const isRoutesArray = routesArrayNodes.length > 0;
+    if (!isRoutesArray) {
+        if (routesFileContents.includes('@NgModule')) {
+            const sourceFile = tsModule.createSourceFile(routesFile, routesFileContents, tsModule.ScriptTarget.Latest, true);
+            (0, ast_utils_1.addRouteToNgModule)(tree, routesFile, sourceFile, route);
+            return;
+        }
+        else {
+            throw new Error(`Routing file (${routesFile}) does not a routing configuration. Please ensure the parent contains a routing configuration.`);
+        }
+    }
+    const newRoutesFileContents = `${routesFileContents.slice(0, routesArrayNodes[0].getStart() + 1)}
+    ${route},${routesFileContents.slice(routesArrayNodes[0].getStart() + 1)}`;
+    tree.write(routesFile, newRoutesFileContents);
+}
+/**
+ * Add a provider to a standalone routes definition
+ * @param tree Virtual Tree
+ * @param routesFile The file containing the routes definition
+ * @param routeToAddProviderTo The route to add the provider to
+ * @param providerToAdd The provider to add to the route
+ */
+function addProviderToRoute(tree, routesFile, routeToAddProviderTo, providerToAdd) {
+    if (!tree.exists(routesFile)) {
+        throw new Error(`Path to parent routing declaration (${routesFile}) does not exist. Please ensure path is correct.`);
+    }
+    (0, internal_1.ensureTypescript)();
+    const { ast, query } = require('@phenomnomnominal/tsquery');
+    let routesFileContents = tree.read(routesFile, 'utf-8');
+    const sourceFile = ast(routesFileContents);
+    const ROUTES_ARRAY_SELECTOR = 'VariableDeclaration:has(ArrayType > TypeReference > Identifier[name=Route], Identifier[name=Routes]) > ArrayLiteralExpression';
+    const routesArrayNodes = query(sourceFile, ROUTES_ARRAY_SELECTOR);
+    const isRoutesArray = routesArrayNodes.length > 0;
+    if (!isRoutesArray) {
+        throw new Error(`Routing file (${routesFile}) does not a routing configuration. Please ensure the parent contains a routing configuration.`);
+    }
+    const ROUTE_SELECTOR = `ObjectLiteralExpression:has(PropertyAssignment:has(Identifier[name=path]) > StringLiteral[value=${routeToAddProviderTo}]):last-child`;
+    const ROUTE_PATH_PROVIDERS_SELECTOR = 'ObjectLiteralExpression > PropertyAssignment:has(Identifier[name=providers])';
+    const selectedRouteNodes = query(routesArrayNodes[0], ROUTE_SELECTOR);
+    if (selectedRouteNodes.length === 0) {
+        throw new Error(`Could not find '${routeToAddProviderTo}' in routes definition.`);
+    }
+    for (const selectedRouteNode of selectedRouteNodes) {
+        const routeProivdersNodes = query(selectedRouteNode, ROUTE_PATH_PROVIDERS_SELECTOR);
+        if (routeProivdersNodes.length === 0) {
+            const newFileContents = `${routesFileContents.slice(0, selectedRouteNode.getEnd() - 1)}${routesFileContents
+                .slice(0, selectedRouteNode.getEnd() - 1)
+                .trim()
+                .endsWith(',')
+                ? ''
+                : ', '}providers: [${providerToAdd}]${routesFileContents.slice(selectedRouteNode.getEnd() - 1, routesFileContents.length)}`;
+            tree.write(routesFile, newFileContents);
+        }
+        else {
+            const newFileContents = `${routesFileContents.slice(0, routeProivdersNodes[0].getEnd() - 1)}, ${providerToAdd}${routesFileContents.slice(routeProivdersNodes[0].getEnd() - 1, routesFileContents.length)}`;
+            tree.write(routesFile, newFileContents);
+        }
+    }
+}

package/dist/src/utils/nx-devkit/testing.d.ts

@@ -0,0 +1,14 @@
+import type { Tree } from '@nx/devkit';
+export interface AppConfig {
+    appName: string;
+    appModule: string;
+}
+export interface LibConfig {
+    name: string;
+    module: string;
+    barrel: string;
+}
+export declare function getAppConfig(): AppConfig;
+export declare function getLibConfig(): LibConfig;
+export declare function createApp(tree: Tree, appName: string, routing?: boolean): void;
+export declare function createLib(tree: Tree, libName: string): void;

package/dist/src/utils/targets.d.ts

@@ -0,0 +1,8 @@
+import type { ProjectConfiguration, Target, TargetConfiguration } from '@nx/devkit';
+export declare function allProjectTargets<T>(project: ProjectConfiguration): Iterable<[name: string, target: TargetConfiguration<T>]>;
+export declare function allTargetOptions<T>(target: TargetConfiguration<T>): Iterable<[string | undefined, T]>;
+/**
+ * Return a Target tuple from a specifier string.
+ * Supports abbreviated target specifiers (examples: `::`, `::development`, or `:build:production`).
+ */
+export declare function targetFromTargetString(specifier: string, abbreviatedProjectName?: string, abbreviatedTargetName?: string): Target;

package/dist/src/utils/test-runners.d.ts

@@ -0,0 +1,11 @@
+export declare enum UnitTestRunner {
+    Jest = "jest",
+    None = "none",
+    VitestAngular = "vitest-angular",
+    VitestAnalog = "vitest-analog"
+}
+export declare enum E2eTestRunner {
+    Cypress = "cypress",
+    Playwright = "playwright",
+    None = "none"
+}

package/dist/src/utils/types.d.ts

@@ -0,0 +1,4 @@
+import type { ProjectConfiguration } from '@nx/devkit';
+export type AngularProjectConfiguration = ProjectConfiguration & {
+    prefix?: string;
+};

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

@@ -0,0 +1,3 @@
+import type { PackageCompatVersions, PackageVersionNames } from './backward-compatible-versions';
+export declare function getPkgVersionForAngularMajorVersion(pkgVersionName: PackageVersionNames, angularMajorVersion: number): string;
+export declare function getPkgVersionsForAngularMajorVersion(angularMajorVersion: number): PackageCompatVersions;

package/dist/src/utils/versions.d.ts

@@ -0,0 +1,30 @@
+export declare const nxVersion: any;
+export declare const angularVersion = "~21.2.0";
+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.16.0";
+export declare const tsLibVersion = "^2.3.0";
+export declare const corsVersion = "~2.8.5";
+export declare const typesCorsVersion = "~2.8.5";
+export declare const expressVersion = "^4.21.2";
+export declare const typesExpressVersion = "^4.17.21";
+export declare const browserSyncVersion = "^3.0.0";
+export declare const moduleFederationNodeVersion = "^2.7.21";
+export declare const moduleFederationEnhancedVersion = "^2.1.0";
+export declare const webpackMergeVersion = "^5.8.0";
+export declare const angularEslintVersion = "^21.2.0";
+export declare const typescriptEslintVersion = "^7.16.0";
+export declare const postcssVersion = "^8.4.5";
+export declare const postcssUrlVersion = "~10.1.3";
+export declare const autoprefixerVersion = "^10.4.0";
+export declare const tsNodeVersion = "10.9.1";
+export declare const lessVersion = "^4.3.0";
+export declare const jestPresetAngularVersion = "~16.0.0";
+export declare const typesNodeVersion = "^22.0.0";
+export declare const jasmineMarblesVersion = "^0.9.2";
+export declare const vitestVersion = "^4.0.8";
+export declare const jsdomVersion = "^27.1.0";
+export declare const oxcProjectRuntimeVersion = "^0.115.0";
+export declare const jsoncEslintParserVersion = "^2.1.0";

package/dist/src/utils/versions.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsoncEslintParserVersion = exports.oxcProjectRuntimeVersion = exports.jsdomVersion = exports.vitestVersion = exports.jasmineMarblesVersion = exports.typesNodeVersion = exports.jestPresetAngularVersion = exports.lessVersion = exports.tsNodeVersion = exports.autoprefixerVersion = exports.postcssUrlVersion = exports.postcssVersion = exports.typescriptEslintVersion = exports.angularEslintVersion = exports.webpackMergeVersion = exports.moduleFederationEnhancedVersion = exports.moduleFederationNodeVersion = exports.browserSyncVersion = exports.typesExpressVersion = exports.expressVersion = exports.typesCorsVersion = exports.corsVersion = exports.tsLibVersion = exports.zoneJsVersion = exports.rxjsVersion = exports.ngrxVersion = exports.ngPackagrVersion = exports.angularDevkitVersion = exports.angularVersion = exports.nxVersion = void 0;
+const path_1 = require("path");
+exports.nxVersion = require((0, path_1.join)('@nx/angular', 'package.json')).version;
+exports.angularVersion = '~21.2.0';
+exports.angularDevkitVersion = '~21.2.0';
+exports.ngPackagrVersion = '~21.2.0';
+exports.ngrxVersion = '^21.0.0';
+exports.rxjsVersion = '~7.8.0';
+exports.zoneJsVersion = '~0.16.0';
+exports.tsLibVersion = '^2.3.0';
+exports.corsVersion = '~2.8.5';
+exports.typesCorsVersion = '~2.8.5';
+exports.expressVersion = '^4.21.2';
+exports.typesExpressVersion = '^4.17.21';
+exports.browserSyncVersion = '^3.0.0';
+exports.moduleFederationNodeVersion = '^2.7.21';
+exports.moduleFederationEnhancedVersion = '^2.1.0';
+exports.webpackMergeVersion = '^5.8.0';
+exports.angularEslintVersion = '^21.2.0';
+exports.typescriptEslintVersion = '^7.16.0';
+exports.postcssVersion = '^8.4.5';
+exports.postcssUrlVersion = '~10.1.3';
+exports.autoprefixerVersion = '^10.4.0';
+exports.tsNodeVersion = '10.9.1';
+exports.lessVersion = '^4.3.0';
+exports.jestPresetAngularVersion = '~16.0.0';
+exports.typesNodeVersion = '^22.0.0';
+exports.jasmineMarblesVersion = '^0.9.2';
+exports.vitestVersion = '^4.0.8';
+exports.jsdomVersion = '^27.1.0';
+// `@analogjs/vite-plugin-angular` (vitest-analog path) registers an
+// `angularVitestPlugin` whose `transform` hook downlevels `@angular/*`
+// fesm2022 modules via `vite.transformWithOxc({ target: 'es2016', … })`
+// so Zone.js `fakeAsync` can intercept async/await. The lowered code
+// emits external `@oxc-project/runtime/helpers/*` imports (oxc default
+// `HelperMode = 'Runtime'`). Nothing upstream declares the runtime, so
+// we add it explicitly to user projects.
+exports.oxcProjectRuntimeVersion = '^0.115.0';
+exports.jsoncEslintParserVersion = '^2.1.0';

package/dist/src/utils/zoneless.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectConfiguration } from 'packages/devkit';
+export declare function isZonelessApp(project: ProjectConfiguration): boolean;

package/dist/tailwind.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @deprecated `@nx/angular/tailwind` will be removed in Nx 24. Migrate to Tailwind CSS v4 which no longer needs glob patterns.
+ * See: https://nx.dev/docs/technologies/angular/guides/using-tailwind-css-with-angular
+ */
+export declare function createGlobPatternsForDependencies(dirPath: string, fileGlobPattern?: string): string[];

package/dist/tailwind.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGlobPatternsForDependencies = createGlobPatternsForDependencies;
+const internal_1 = require("@nx/js/internal");
+let hasWarned = false;
+/**
+ * @deprecated `@nx/angular/tailwind` will be removed in Nx 24. Migrate to Tailwind CSS v4 which no longer needs glob patterns.
+ * See: https://nx.dev/docs/technologies/angular/guides/using-tailwind-css-with-angular
+ */
+function createGlobPatternsForDependencies(dirPath, fileGlobPattern = '/**/!(*.stories|*.spec).{ts,html}') {
+    if (!hasWarned) {
+        hasWarned = true;
+        console.warn(`\nWARNING: "@nx/angular/tailwind" is deprecated and will be removed in Nx 24.\n` +
+            `Migrate to Tailwind CSS v4 which no longer needs glob patterns for content detection.\n` +
+            `See: https://nx.dev/docs/technologies/angular/guides/using-tailwind-css-with-angular\n`);
+    }
+    try {
+        return (0, internal_1.createGlobPatternsForDependencies)(dirPath, fileGlobPattern);
+    }
+    catch (e) {
+        /**
+         * It should not be possible to reach this point when the utility is invoked as part of the normal
+         * lifecycle of Nx executors. However, other tooling, such as the VSCode Tailwind IntelliSense plugin
+         * or JetBrains editors such as WebStorm, may execute the tailwind.config.js file in order to provide
+         * autocomplete features, for example.
+         *
+         * In order to best support that use-case, we therefore do not hard error when the ProjectGraph is
+         * fundamentally unavailable in this tailwind-specific context.
+         */
+        console.warn('\nWARNING: There was an error creating glob patterns, returning an empty array\n' +
+            `${e.message}\n`);
+        return [];
+    }
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"nx-angular-mf.d.ts","sources":["../../mf/mf.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEM;AASN;;AAEG;AACH;AAQA;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACH;AAIA;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACH;AAQA;;;;;;;;;;;;;;AAcG;AACH;;"}

package/executors.json

@@ -1,65 +1,65 @@
 {
   "executors": {
     "delegate-build": {
-      "implementation": "./src/executors/delegate-build/delegate-build.impl",
-      "schema": "./src/executors/delegate-build/schema.json",
+      "implementation": "./dist/src/executors/delegate-build/delegate-build.impl",
+      "schema": "./dist/src/executors/delegate-build/schema.json",
       "description": "Delegates the build to a different target while supporting incremental builds."
     },
     "ng-packagr-lite": {
-      "implementation": "./src/executors/ng-packagr-lite/ng-packagr-lite.impl",
-      "schema": "./src/executors/ng-packagr-lite/schema.json",
+      "implementation": "./dist/src/executors/ng-packagr-lite/ng-packagr-lite.impl",
+      "schema": "./dist/src/executors/ng-packagr-lite/schema.json",
       "description": "Builds an Angular library with support for incremental builds.\n\nThis executor is meant to be used with buildable libraries in an incremental build scenario. It is similar to the `@nx/angular:package` executor but it only produces ESM2022 bundles."
     },
     "package": {
-      "implementation": "./src/executors/package/package.impl",
-      "schema": "./src/executors/package/schema.json",
+      "implementation": "./dist/src/executors/package/package.impl",
+      "schema": "./dist/src/executors/package/schema.json",
       "description": "Builds and packages an Angular library producing an output following the Angular Package Format (APF) to be distributed as an NPM package.\n\nThis executor is a drop-in replacement for the `@angular-devkit/build-angular:ng-packagr` and `@angular/build:ng-packagr` builders, with additional support for incremental builds."
     },
     "browser-esbuild": {
-      "implementation": "./src/executors/browser-esbuild/browser-esbuild.impl",
-      "schema": "./src/executors/browser-esbuild/schema.json",
+      "implementation": "./dist/src/executors/browser-esbuild/browser-esbuild.impl",
+      "schema": "./dist/src/executors/browser-esbuild/schema.json",
       "description": "Builds an Angular application using [esbuild](https://esbuild.github.io/)."
     },
     "module-federation-dev-server": {
-      "implementation": "./src/executors/module-federation-dev-server/module-federation-dev-server.impl",
-      "schema": "./src/executors/module-federation-dev-server/schema.json",
+      "implementation": "./dist/src/executors/module-federation-dev-server/module-federation-dev-server.impl",
+      "schema": "./dist/src/executors/module-federation-dev-server/schema.json",
       "description": "Serves host [Module Federation](https://module-federation.io/) applications ([webpack](https://webpack.js.org/)-based) allowing to specify which remote applications should be served with the host."
     },
     "module-federation-dev-ssr": {
-      "implementation": "./src/executors/module-federation-ssr-dev-server/module-federation-ssr-dev-server.impl",
-      "schema": "./src/executors/module-federation-ssr-dev-server/schema.json",
+      "implementation": "./dist/src/executors/module-federation-ssr-dev-server/module-federation-ssr-dev-server.impl",
+      "schema": "./dist/src/executors/module-federation-ssr-dev-server/schema.json",
       "description": "The module-federation-ssr-dev-server executor is reserved exclusively for use with host SSR Module Federation applications. It allows the user to specify which remote applications should be served with the host."
     },
     "application": {
-      "implementation": "./src/executors/application/application.impl",
-      "schema": "./src/executors/application/schema.json",
+      "implementation": "./dist/src/executors/application/application.impl",
+      "schema": "./dist/src/executors/application/schema.json",
       "description": "Builds an Angular application using [esbuild](https://esbuild.github.io/) with integrated SSR and prerendering capabilities."
     },
     "extract-i18n": {
-      "implementation": "./src/executors/extract-i18n/extract-i18n.impl",
-      "schema": "./src/executors/extract-i18n/schema.json",
+      "implementation": "./dist/src/executors/extract-i18n/extract-i18n.impl",
+      "schema": "./dist/src/executors/extract-i18n/schema.json",
       "description": "Extracts i18n messages from source code."
     },
     "unit-test": {
-      "implementation": "./src/executors/unit-test/unit-test.impl",
-      "schema": "./src/executors/unit-test/schema.json",
+      "implementation": "./dist/src/executors/unit-test/unit-test.impl",
+      "schema": "./dist/src/executors/unit-test/schema.json",
       "description": "Run application unit tests. _Note: this is only supported in Angular versions >= 21.0.0_."
     }
   },
   "builders": {
     "webpack-browser": {
-      "implementation": "./src/builders/webpack-browser/webpack-browser.impl",
-      "schema": "./src/builders/webpack-browser/schema.json",
+      "implementation": "./dist/src/builders/webpack-browser/webpack-browser.impl",
+      "schema": "./dist/src/builders/webpack-browser/schema.json",
       "description": "Builds an Angular application using [webpack](https://webpack.js.org/)."
     },
     "dev-server": {
-      "implementation": "./src/builders/dev-server/dev-server.impl",
-      "schema": "./src/builders/dev-server/schema.json",
+      "implementation": "./dist/src/builders/dev-server/dev-server.impl",
+      "schema": "./dist/src/builders/dev-server/schema.json",
       "description": "Serves an Angular application using [webpack](https://webpack.js.org/) when the build target is using a webpack-based executor, or [Vite](https://vite.dev/) when the build target uses an [esbuild](https://esbuild.github.io/)-based executor."
     },
     "webpack-server": {
-      "implementation": "./src/builders/webpack-server/webpack-server.impl",
-      "schema": "./src/builders/webpack-server/schema.json",
+      "implementation": "./dist/src/builders/webpack-server/webpack-server.impl",
+      "schema": "./dist/src/builders/webpack-server/schema.json",
       "description": "Builds a server Angular application using [webpack](https://webpack.js.org/). This executor is a drop-in replacement for the `@angular-devkit/build-angular:server` builder provided by the Angular CLI. It is usually used in tandem with the `@nx/angular:webpack-browser` executor when your Angular application uses a custom webpack configuration."
     }
   }