@nx/angular 17.3.0 → 17.3.2

package/executors.d.ts

@@ -10,6 +10,6 @@ export * from './src/executors/application/application.impl';
 import { executeDevServerBuilder } from './src/builders/dev-server/dev-server.impl';
 export { 
 /**
- * @deprecated Use executeDevServerBuilder instead. It will be removed in Nx v18.
+ * @deprecated Use executeDevServerBuilder instead. It will be removed in Nx v19.
  */
 executeDevServerBuilder as executeWebpackDevServerBuilder, executeDevServerBuilder, };

package/generators.json

@@ -39,6 +39,11 @@
       "schema": "./src/generators/component-test/schema.json",
       "description": "Creates a cypress component test file for a component."
     },
+    "convert-to-application-executor": {
+      "factory": "./src/generators/convert-to-application-executor/convert-to-application-executor",
+      "schema": "./src/generators/convert-to-application-executor/schema.json",
+      "description": "Converts projects to use the `@nx/angular:application` executor or the `@angular-devkit/build-angular:application` builder. _Note: this is only supported in Angular versions >= 17.0.0_."
+    },
     "directive": {
       "factory": "./src/generators/directive/directive",
       "schema": "./src/generators/directive/schema.json",
@@ -81,7 +86,7 @@
       "schema": "./src/generators/move/schema.json",
       "aliases": ["mv"],
       "description": "Moves an Angular application or library to another folder within the workspace and updates the project configuration.",
-      "x-deprecated": "Use the `@nx/workspace:move` generator instead. This generator will be removed in Nx v18."
+      "x-deprecated": "Use the `@nx/workspace:move` generator instead. This generator will be removed in Nx v19."
     },
     "convert-to-with-mf": {
       "factory": "./src/generators/convert-to-with-mf/convert-to-with-mf",

package/migrations.json

@@ -356,6 +356,12 @@
       },
       "description": "Add 'autoprefixer' as dev dependency when '@nx/angular:ng-packagr-lite' or '@nx/angular:package` is used.",
       "factory": "./src/migrations/update-17-3-0/add-autoprefixer-dependency"
+    },
+    "add-module-federation-env-var-to-target-defaults": {
+      "cli": "nx",
+      "version": "18.0.0-beta.0",
+      "description": "Add NX_MF_DEV_SERVER_STATIC_REMOTES to inputs for task hashing when '@nx/angular:webpack-browser' is used for Module Federation.",
+      "factory": "./src/migrations/update-18-0-0/add-mf-env-var-to-target-defaults"
     }
   },
   "packageJsonUpdates": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/angular",
-  "version": "17.3.0",
+  "version": "17.3.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, 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- Upgrading AngularJS applications \n\n- Single Component Application Modules (SCAMs) \n\n- NgRx helpers. \n\n- Utilities for automatic workspace refactoring.",
   "repository": {
@@ -74,20 +74,20 @@
     "ignore": "^5.0.4",
     "magic-string": "~0.30.2",
     "minimatch": "9.0.3",
-    "semver": "7.5.3",
+    "semver": "^7.5.3",
     "tslib": "^2.3.0",
     "webpack": "^5.80.0",
     "webpack-merge": "^5.8.0",
-    "@nx/devkit": "17.3.0",
-    "@nx/cypress": "17.3.0",
-    "@nx/jest": "17.3.0",
-    "@nx/js": "17.3.0",
-    "@nx/eslint": "17.3.0",
-    "@nx/webpack": "17.3.0",
-    "@nx/web": "17.3.0",
-    "@nx/workspace": "17.3.0",
+    "@nx/devkit": "17.3.2",
+    "@nx/cypress": "17.3.2",
+    "@nx/jest": "17.3.2",
+    "@nx/js": "17.3.2",
+    "@nx/eslint": "17.3.2",
+    "@nx/webpack": "17.3.2",
+    "@nx/web": "17.3.2",
+    "@nx/workspace": "17.3.2",
     "piscina": "^4.2.1",
-    "@nrwl/angular": "17.3.0"
+    "@nrwl/angular": "17.3.2"
   },
   "peerDependencies": {
     "@angular-devkit/build-angular": ">= 15.0.0 < 18.0.0",

package/plugins/component-testing.d.ts

@@ -29,8 +29,9 @@ export declare function nxComponentTestingPreset(pathToConfig: string, options?:
                     customWebpackConfig?: {
                         path: string;
                     };
-                    indexFileTransformer?: string;
+                    indexHtmlTransformer?: string;
                     buildLibsFromSource?: boolean;
+                    indexFileTransformer?: string;
                 } & {
                     workspaceRoot: string;
                 };

package/src/builders/dev-server/dev-server.impl.js

@@ -16,7 +16,7 @@ const buildable_libs_1 = require("../utilities/buildable-libs");
 const webpack_1 = require("../utilities/webpack");
 const lib_1 = require("./lib");
 function executeDevServerBuilder(rawOptions, context) {
-    if (rawOptions.esbuildMiddleware) {
+    if (rawOptions.esbuildMiddleware?.length > 0) {
         const { major: angularMajorVersion, version: angularVersion } = (0, angular_version_utils_1.getInstalledAngularVersionInfo)();
         if (angularMajorVersion < 17) {
             throw new Error((0, devkit_1.stripIndents) `The "esbuildMiddleware" option is only supported in Angular >= 17.0.0. You are currently using "${angularVersion}".
@@ -54,9 +54,11 @@ function executeDevServerBuilder(rawOptions, context) {
             throw new Error(`Custom Webpack Config File Not Found!\nTo use a custom webpack config, please ensure the path to the custom webpack file is correct: \n${pathToWebpackConfig}`);
         }
     }
+    const normalizedIndexHtmlTransformer = buildTargetOptions.indexHtmlTransformer ??
+        buildTargetOptions.indexFileTransformer;
     let pathToIndexFileTransformer;
-    if (buildTargetOptions.indexFileTransformer) {
-        pathToIndexFileTransformer = (0, devkit_1.joinPathFragments)(context.workspaceRoot, buildTargetOptions.indexFileTransformer);
+    if (normalizedIndexHtmlTransformer) {
+        pathToIndexFileTransformer = (0, devkit_1.joinPathFragments)(context.workspaceRoot, normalizedIndexHtmlTransformer);
         if (pathToIndexFileTransformer && !(0, fs_1.existsSync)(pathToIndexFileTransformer)) {
             throw new Error(`File containing Index File Transformer function Not Found!\n Please ensure the path to the file containing the function is correct: \n${pathToIndexFileTransformer}`);
         }
@@ -184,6 +186,7 @@ function patchBuilderContext(context, isUsingEsbuildBuilder, buildTarget) {
 function cleanBuildTargetOptions(options) {
     delete options.buildLibsFromSource;
     delete options.customWebpackConfig;
+    delete options.indexHtmlTransformer;
     delete options.indexFileTransformer;
     delete options.plugins;
     return options;

package/src/builders/dev-server/schema.json

@@ -17,7 +17,7 @@
       "type": "string",
       "description": "A browser builder target to serve in the format of `project:target[:configuration]`. Ignored if `buildTarget` is set.",
       "pattern": "^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$",
-      "x-deprecated": "Use 'buildTarget' instead. It will be removed in Nx v18."
+      "x-deprecated": "Use 'buildTarget' instead. It will be removed in Nx v19."
     },
     "buildTarget": {
       "type": "string",

package/src/builders/webpack-browser/schema.d.ts

@@ -4,6 +4,10 @@ export type BrowserBuilderSchema = Schema & {
   customWebpackConfig?: {
     path: string;
   };
-  indexFileTransformer?: string;
+  indexHtmlTransformer?: string;
   buildLibsFromSource?: boolean;
+  /**
+   * @deprecated Use `indexHtmlTransformer` instead. It will be removed in Nx 19.
+   */
+  indexFileTransformer?: string;
 };

package/src/builders/webpack-browser/schema.json

@@ -458,9 +458,10 @@
       "x-priority": "important",
       "additionalProperties": false
     },
-    "indexFileTransformer": {
+    "indexHtmlTransformer": {
       "description": "Path to transformer function to transform the index.html",
-      "type": "string"
+      "type": "string",
+      "alias": "indexFileTransformer"
     },
     "buildLibsFromSource": {
       "type": "boolean",

package/src/builders/webpack-browser/webpack-browser.impl.js

@@ -24,7 +24,7 @@ function shouldSkipInitialTargetRun(projectGraph, project, target) {
 }
 function executeWebpackBrowserBuilder(options, context) {
     options.buildLibsFromSource ??= true;
-    const { buildLibsFromSource, customWebpackConfig, indexFileTransformer, ...delegateBuilderOptions } = options;
+    const { buildLibsFromSource, customWebpackConfig, indexHtmlTransformer, indexFileTransformer, ...delegateBuilderOptions } = options;
     process.env.NX_BUILD_LIBS_FROM_SOURCE = `${buildLibsFromSource}`;
     process.env.NX_BUILD_TARGET = (0, devkit_1.targetToTargetString)({ ...context.target });
     const pathToWebpackConfig = customWebpackConfig?.path &&
@@ -32,8 +32,9 @@ function executeWebpackBrowserBuilder(options, context) {
     if (pathToWebpackConfig && !(0, fs_1.existsSync)(pathToWebpackConfig)) {
         throw new Error(`Custom Webpack Config File Not Found!\nTo use a custom webpack config, please ensure the path to the custom webpack file is correct: \n${pathToWebpackConfig}`);
     }
-    const pathToIndexFileTransformer = indexFileTransformer &&
-        (0, devkit_1.joinPathFragments)(context.workspaceRoot, indexFileTransformer);
+    const normalizedIndexHtmlTransformer = indexHtmlTransformer ?? indexFileTransformer;
+    const pathToIndexFileTransformer = normalizedIndexHtmlTransformer &&
+        (0, devkit_1.joinPathFragments)(context.workspaceRoot, normalizedIndexHtmlTransformer);
     if (pathToIndexFileTransformer && !(0, fs_1.existsSync)(pathToIndexFileTransformer)) {
         throw new Error(`File containing Index File Transformer function Not Found!\n Please ensure the path to the file containing the function is correct: \n${pathToIndexFileTransformer}`);
     }

package/src/executors/module-federation-dev-server/schema.json

@@ -15,7 +15,7 @@
       "type": "string",
       "description": "A browser builder target to serve in the format of `project:target[:configuration]`.",
       "pattern": "^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$",
-      "x-deprecated": "Use 'buildTarget' instead. It will be removed in Nx v18."
+      "x-deprecated": "Use 'buildTarget' instead. It will be removed in Nx v19."
     },
     "buildTarget": {
       "type": "string",

package/src/executors/ng-packagr-lite/schema.json

@@ -1,7 +1,7 @@
 {
   "version": 2,
   "outputCapture": "direct-nodejs",
-  "$schema": "http://json-schema.org/schema",
+  "$schema": "https://json-schema.org/schema",
   "title": "ng-packagr Target",
   "description": "Builds a 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 with some key differences:\n- For supported Angular versions lower than v16, it doesn't run `ngcc` automatically (`ngcc` is no longer available from Angular v16 onwards, for lower versions, it needs to be run separately beforehand if needed, this can be done in a `postinstall` hook on `package.json`).\n- It only produces ESM2022 bundles (ESM2020 for supported Angular versions lower than v16).",
   "cli": "nx",

package/src/executors/package/schema.json

@@ -1,7 +1,7 @@
 {
   "version": 2,
   "outputCapture": "direct-nodejs",
-  "$schema": "http://json-schema.org/schema",
+  "$schema": "https://json-schema.org/schema",
   "title": "ng-packagr Target",
   "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 similar to the `@angular-devkit/build-angular:ng-packagr` with additional support for incremental builds.",
   "cli": "nx",

package/src/generators/add-linting/schema.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "http://json-schema.org/schema",
+  "$schema": "https://json-schema.org/schema",
   "$id": "NxAngularAddLintingGenerator",
   "title": "Add linting to an Angular project.",
   "description": "Adds linting configuration to an Angular project.",

package/src/generators/application/files/ng-module/src/app/nx-welcome.component.ts__tpl__

@@ -746,6 +746,25 @@ nx g @nx/angular:lib ui
 <span># Add a component</span>
 nx g &#64;nx/angular:component ui/src/lib/button</pre>
           </details>
+          <details>
+            <summary>
+              <svg
+                fill="none"
+                stroke="currentColor"
+                viewBox="0 0 24 24"
+                xmlns="http://www.w3.org/2000/svg"
+              >
+                <path
+                  strokeLinecap="round"
+                  strokeLinejoin="round"
+                  strokeWidth="2"
+                  d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"
+                />
+              </svg>
+              View project details
+            </summary>
+            <pre>nx show project <%= appName %> --web</pre>
+          </details>
           <details>
             <summary>
               <svg

package/src/generators/application/files/standalone-components/src/app/nx-welcome.component.ts__tpl__

@@ -749,6 +749,25 @@ nx g @nx/angular:lib ui
 <span># Add a component</span>
 nx g &#64;nx/angular:component ui/src/lib/button</pre>
           </details>
+          <details>
+            <summary>
+              <svg
+                fill="none"
+                stroke="currentColor"
+                viewBox="0 0 24 24"
+                xmlns="http://www.w3.org/2000/svg"
+              >
+                <path
+                  strokeLinecap="round"
+                  strokeLinejoin="round"
+                  strokeWidth="2"
+                  d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"
+                />
+              </svg>
+              View project details
+            </summary>
+            <pre>nx show project <%= appName %> --web</pre>
+          </details>
           <details>
             <summary>
               <svg

package/src/generators/application/schema.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "http://json-schema.org/schema",
+  "$schema": "https://json-schema.org/schema",
   "$id": "GeneratorNxApp",
   "title": "Creates an Angular application.",
   "description": "Creates an Angular application.",
@@ -41,15 +41,15 @@
           },
           {
             "value": "scss",
-            "label": "SASS(.scss)  [ http://sass-lang.com   ]"
+            "label": "SASS(.scss)  [ https://sass-lang.com   ]"
           },
           {
             "value": "sass",
-            "label": "SASS(.sass)  [ http://sass-lang.com   ]"
+            "label": "SASS(.sass)  [ https://sass-lang.com   ]"
           },
           {
             "value": "less",
-            "label": "LESS         [ http://lesscss.org     ]"
+            "label": "LESS         [ https://lesscss.org     ]"
           }
         ]
       }

package/src/generators/component/schema.d.ts

@@ -22,15 +22,15 @@ export interface Schema {
   skipFormat?: boolean;
 
   /**
-   * @deprecated Provide the `directory` option instead and use the `as-provided` format. It will be removed in Nx v18.
+   * @deprecated Provide the `directory` option instead and use the `as-provided` format. It will be removed in Nx v19.
    */
   flat?: boolean;
   /**
-   * @deprecated Provide the `directory` option instead. It will be removed in Nx v18.
+   * @deprecated Provide the `directory` option instead. It will be removed in Nx v19.
    */
   path?: string;
   /**
-   * @deprecated Provide the `directory` option instead. The project will be determined from the directory provided. It will be removed in Nx v18.
+   * @deprecated Provide the `directory` option instead. The project will be determined from the directory provided. It will be removed in Nx v19.
    */
   project?: string;
 }

package/src/generators/component/schema.json

@@ -34,7 +34,7 @@
         "$source": "projectName"
       },
       "x-dropdown": "projects",
-      "x-deprecated": "Provide the `directory` option instead and use the `as-provided` format. The project will be determined from the directory provided. It will be removed in Nx v18."
+      "x-deprecated": "Provide the `directory` option instead and use the `as-provided` format. The project will be determined from the directory provided. It will be removed in Nx v19."
     },
     "prefix": {
       "type": "string",
@@ -98,7 +98,7 @@
       "type": "boolean",
       "description": "Create the new files at the top level of the current project.",
       "default": false,
-      "x-deprecated": "Provide the `directory` option instead and use the `as-provided` format. It will be removed in Nx v18."
+      "x-deprecated": "Provide the `directory` option instead and use the `as-provided` format. It will be removed in Nx v19."
     },
     "skipImport": {
       "type": "boolean",

package/src/generators/component-cypress-spec/schema.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "http://json-schema.org/schema",
+  "$schema": "https://json-schema.org/schema",
   "$id": "NxAngularComponentCypressSpecGenerator",
   "type": "object",
   "cli": "nx",

package/src/generators/component-test/schema.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "http://json-schema.org/schema",
+  "$schema": "https://json-schema.org/schema",
   "$id": "NxAngularComponentTestGenerator",
   "type": "object",
   "cli": "nx",

package/src/generators/convert-to-application-executor/convert-to-application-executor.d.ts

@@ -0,0 +1,4 @@
+import { type Tree } from '@nx/devkit';
+import type { GeneratorOptions } from './schema';
+export declare function convertToApplicationExecutor(tree: Tree, options: GeneratorOptions): Promise<() => void>;
+export default convertToApplicationExecutor;

package/src/generators/convert-to-application-executor/convert-to-application-executor.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToApplicationExecutor = void 0;
+const devkit_1 = require("@nx/devkit");
+const posix_1 = require("node:path/posix");
+const semver_1 = require("semver");
+const targets_1 = require("../../utils/targets");
+const setup_ssr_1 = require("../setup-ssr/setup-ssr");
+const validations_1 = require("../utils/validations");
+const version_utils_1 = require("../utils/version-utils");
+const executorsToConvert = new Set([
+    '@angular-devkit/build-angular:browser',
+    '@angular-devkit/build-angular:browser-esbuild',
+    '@nx/angular:webpack-browser',
+    '@nx/angular:browser-esbuild',
+]);
+const serverTargetExecutors = new Set([
+    '@angular-devkit/build-angular:server',
+    '@nx/angular:webpack-server',
+]);
+const redundantExecutors = new Set([
+    '@angular-devkit/build-angular:server',
+    '@angular-devkit/build-angular:prerender',
+    '@angular-devkit/build-angular:app-shell',
+    '@angular-devkit/build-angular:ssr-dev-server',
+    '@nx/angular:webpack-server',
+]);
+async function convertToApplicationExecutor(tree, options) {
+    const { major: angularMajorVersion, version: angularVersion } = (0, version_utils_1.getInstalledAngularVersionInfo)(tree);
+    if (angularMajorVersion < 17) {
+        throw new Error(`The "convert-to-application-executor" generator is only supported in Angular >= 17.0.0. You are currently using "${angularVersion}".`);
+    }
+    let didAnySucceed = false;
+    if (options.project) {
+        (0, validations_1.validateProject)(tree, options.project);
+        didAnySucceed = await convertProjectTargets(tree, options.project, angularVersion, true);
+    }
+    else {
+        const projects = (0, devkit_1.getProjects)(tree);
+        for (const [projectName] of projects) {
+            devkit_1.logger.info(`Converting project "${projectName}"...`);
+            const success = await convertProjectTargets(tree, projectName, angularVersion);
+            if (success) {
+                devkit_1.logger.info(`Project "${projectName}" converted successfully.`);
+            }
+            else {
+                devkit_1.logger.info(`Project "${projectName}" could not be converted. See above for more information.`);
+            }
+            devkit_1.logger.info('');
+            didAnySucceed = didAnySucceed || success;
+        }
+    }
+    if (!options.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+    return didAnySucceed ? () => (0, devkit_1.installPackagesTask)(tree) : () => { };
+}
+exports.convertToApplicationExecutor = convertToApplicationExecutor;
+async function convertProjectTargets(tree, projectName, angularVersion, isProvidedProject = false) {
+    function warnIfProvided(message) {
+        if (isProvidedProject) {
+            devkit_1.logger.warn(message);
+        }
+    }
+    let project = (0, devkit_1.readProjectConfiguration)(tree, projectName);
+    if (project.projectType !== 'application') {
+        warnIfProvided(`The provided project "${projectName}" is not an application. Skipping conversion.`);
+        return false;
+    }
+    const { buildTargetName, serverTargetName } = getTargetsToConvert(project.targets);
+    if (!buildTargetName) {
+        warnIfProvided(`The provided project "${projectName}" does not have any targets using on of the ` +
+            `'@angular-devkit/build-angular:browser', '@angular-devkit/build-angular:browser-esbuild', ` +
+            `'@nx/angular:browser' and '@nx/angular:browser-esbuild' executors. Skipping conversion.`);
+        return false;
+    }
+    const useNxExecutor = project.targets[buildTargetName].executor.startsWith('@nx/angular:');
+    const newExecutor = useNxExecutor
+        ? '@nx/angular:application'
+        : '@angular-devkit/build-angular:application';
+    const buildTarget = project.targets[buildTargetName];
+    buildTarget.executor = newExecutor;
+    if ((0, semver_1.gte)(angularVersion, '17.1.0') && buildTarget.outputs) {
+        buildTarget.outputs = buildTarget.outputs.map((output) => output === '{options.outputPath}' ? '{options.outputPath.base}' : output);
+    }
+    for (const [, options] of (0, targets_1.allTargetOptions)(buildTarget)) {
+        if (options['index'] === '') {
+            options['index'] = false;
+        }
+        // Rename and transform options
+        options['browser'] = options['main'];
+        if (serverTargetName && typeof options['browser'] === 'string') {
+            options['server'] = (0, posix_1.dirname)(options['browser']) + '/main.server.ts';
+        }
+        options['serviceWorker'] =
+            options['ngswConfigPath'] ?? options['serviceWorker'];
+        if (typeof options['polyfills'] === 'string') {
+            options['polyfills'] = [options['polyfills']];
+        }
+        let outputPath = options['outputPath'];
+        if ((0, semver_1.lt)(angularVersion, '17.1.0')) {
+            options['outputPath'] = outputPath?.replace(/\/browser\/?$/, '');
+        }
+        else if (typeof outputPath === 'string') {
+            if (!/\/browser\/?$/.test(outputPath)) {
+                devkit_1.logger.warn(`The output location of the browser build has been updated from "${outputPath}" to ` +
+                    `"${(0, posix_1.join)(outputPath, 'browser')}". ` +
+                    'You might need to adjust your deployment pipeline or, as an alternative, ' +
+                    'set outputPath.browser to "" in order to maintain the previous functionality.');
+            }
+            else {
+                outputPath = outputPath.replace(/\/browser\/?$/, '');
+            }
+            options['outputPath'] = {
+                base: outputPath,
+            };
+            if (typeof options['resourcesOutputPath'] === 'string') {
+                const media = options['resourcesOutputPath'].replaceAll('/', '');
+                if (media && media !== 'media') {
+                    options['outputPath'] = {
+                        base: outputPath,
+                        media: media,
+                    };
+                }
+            }
+        }
+        // Delete removed options
+        delete options['deployUrl'];
+        delete options['vendorChunk'];
+        delete options['commonChunk'];
+        delete options['resourcesOutputPath'];
+        delete options['buildOptimizer'];
+        delete options['main'];
+        delete options['ngswConfigPath'];
+    }
+    // Merge browser and server tsconfig
+    if (serverTargetName) {
+        const browserTsConfigPath = buildTarget?.options?.tsConfig;
+        const serverTsConfigPath = project.targets['server']?.options?.tsConfig;
+        if (typeof browserTsConfigPath !== 'string') {
+            devkit_1.logger.warn(`Cannot update project "${projectName}" to use the application executor ` +
+                `as the browser tsconfig cannot be located.`);
+        }
+        if (typeof serverTsConfigPath !== 'string') {
+            devkit_1.logger.warn(`Cannot update project "${projectName}" to use the application executor ` +
+                `as the server tsconfig cannot be located.`);
+        }
+        const browserTsConfigJson = (0, devkit_1.readJson)(tree, browserTsConfigPath);
+        const serverTsConfigJson = (0, devkit_1.readJson)(tree, serverTsConfigPath);
+        const files = new Set([
+            ...(browserTsConfigJson.files ?? []),
+            ...(serverTsConfigJson.files ?? []),
+        ]);
+        // Server file will be added later by the setup-ssr generator
+        files.delete('server.ts');
+        browserTsConfigJson.files = Array.from(files);
+        browserTsConfigJson.compilerOptions ?? {};
+        browserTsConfigJson.compilerOptions.types = Array.from(new Set([
+            ...(browserTsConfigJson.compilerOptions.types ?? []),
+            ...(serverTsConfigJson.compilerOptions?.types ?? []),
+        ]));
+        // Delete server tsconfig
+        tree.delete(serverTsConfigPath);
+    }
+    // Update project main tsconfig
+    const projectRootTsConfigPath = (0, posix_1.join)(project.root, 'tsconfig.json');
+    if (tree.exists(projectRootTsConfigPath)) {
+        const rootTsConfigJson = (0, devkit_1.readJson)(tree, projectRootTsConfigPath);
+        rootTsConfigJson.compilerOptions ?? {};
+        rootTsConfigJson.compilerOptions.esModuleInterop = true;
+        rootTsConfigJson.compilerOptions.downlevelIteration = undefined;
+        rootTsConfigJson.compilerOptions.allowSyntheticDefaultImports = undefined;
+        (0, devkit_1.writeJson)(tree, projectRootTsConfigPath, rootTsConfigJson);
+    }
+    // Update server file
+    const ssrMainFile = project.targets['server']?.options?.['main'];
+    if (typeof ssrMainFile === 'string') {
+        tree.delete(ssrMainFile);
+        // apply changes so the setup-ssr generator can access the updated project
+        (0, devkit_1.updateProjectConfiguration)(tree, projectName, project);
+        await (0, setup_ssr_1.setupSsr)(tree, { project: projectName, skipFormat: true });
+        // re-read project configuration as it might have changed
+        project = (0, devkit_1.readProjectConfiguration)(tree, projectName);
+    }
+    // Delete all redundant targets
+    for (const [targetName, target] of Object.entries(project.targets)) {
+        if (redundantExecutors.has(target.executor)) {
+            delete project.targets[targetName];
+        }
+    }
+    (0, devkit_1.updateProjectConfiguration)(tree, projectName, project);
+    return true;
+}
+function getTargetsToConvert(targets) {
+    let buildTargetName;
+    let serverTargetName;
+    for (const target of Object.keys(targets)) {
+        if (targets[target].executor === '@nx/angular:application' ||
+            targets[target].executor === '@angular-devkit/build-angular:application') {
+            devkit_1.logger.warn('The project is already using the application builder. Skipping conversion.');
+            return {};
+        }
+        // build target
+        if (executorsToConvert.has(targets[target].executor)) {
+            for (const [, options] of (0, targets_1.allTargetOptions)(targets[target])) {
+                if (options.deployUrl) {
+                    devkit_1.logger.warn(`The project is using the "deployUrl" option which is not available in the application builder. Skipping conversion.`);
+                    return {};
+                }
+                if (options.customWebpackConfig) {
+                    devkit_1.logger.warn(`The project is using a custom webpack configuration which is not supported by the esbuild-based application executor. Skipping conversion.`);
+                    return {};
+                }
+            }
+            if (buildTargetName) {
+                devkit_1.logger.warn('The project has more than one build target. Skipping conversion.');
+                return {};
+            }
+            buildTargetName = target;
+        }
+        // server target
+        if (serverTargetExecutors.has(targets[target].executor)) {
+            if (targets[target].executor === '@nx/angular:webpack-server') {
+                for (const [, options] of (0, targets_1.allTargetOptions)(targets[target])) {
+                    if (options.customWebpackConfig) {
+                        devkit_1.logger.warn(`The project is using a custom webpack configuration which is not supported by the esbuild-based application executor. Skipping conversion.`);
+                        return {};
+                    }
+                }
+            }
+            if (serverTargetName) {
+                devkit_1.logger.warn('The project has more than one server target. Skipping conversion.');
+                return {};
+            }
+            serverTargetName = target;
+        }
+    }
+    return { buildTargetName, serverTargetName };
+}
+exports.default = convertToApplicationExecutor;

package/src/generators/convert-to-application-executor/schema.d.ts

@@ -0,0 +1,4 @@
+export interface GeneratorOptions {
+  project?: string;
+  skipFormat?: boolean;
+}

package/src/generators/convert-to-application-executor/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "NxAngularConvertToApplicationExecutorGenerator",
+  "cli": "nx",
+  "title": "Converts projects to use the `@nx/angular:application` executor or the `@angular-devkit/build-angular:application` builder. _Note: this is only supported in Angular versions >= 17.0.0_.",
+  "description": "Converts a project or all projects using one of the `@angular-devkit/build-angular:browser`, `@angular-devkit/build-angular:browser-esbuild`, `@nx/angular:browser` and `@nx/angular:browser-esbuild` executors to use the `@nx/angular:application` executor or the `@angular-devkit/build-angular:application` builder. If the converted target is using one of the `@nx/angular` executors, the `@nx/angular:application` executor will be used. Otherwise, the `@angular-devkit/build-angular:application` builder will be used.",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "Name of the Angular application project to convert. It has to contain a target using one of the `@angular-devkit/build-angular:browser`, `@angular-devkit/build-angular:browser-esbuild`, `@nx/angular:browser` and `@nx/angular:browser-esbuild` executors. If not specified, all projects with such targets will be converted.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-priority": "important"
+    },
+    "skipFormat": {
+      "description": "Skip formatting files.",
+      "type": "boolean",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "additionalProperties": false
+}