feat(angular): support angular cli v20.0.0-rc.3 (#30715)

Add support for the Angular CLI **20.0.0-rc.3** version.

Author: leosvelperez

.prettierignore

@@ -51,3 +51,6 @@ CODEOWNERS
 /.nx/workflows/dynamic-changesets.yaml
 _files
 _solution
+
+# this file uses TS import attributes which the current prettier version does not support
+tools/documentation/create-embeddings/src/main.mts

docs/generated/manifests/nx-api.json

@@ -444,6 +444,66 @@
       }
     },
     "migrations": {
+      "/nx-api/angular/migrations/update-angular-cli-version-20-0-0-rc-3": {
+        "description": "Update the @angular/cli package version to 20.0.0-rc.3.",
+        "file": "generated/packages/angular/migrations/update-angular-cli-version-20-0-0-rc-3.json",
+        "hidden": false,
+        "name": "update-angular-cli-version-20-0-0-rc-3",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "/nx-api/angular/migrations/update-angular-cli-version-20-0-0-rc-3",
+        "type": "migration"
+      },
+      "/nx-api/angular/migrations/migrate-provide-server-rendering-import": {
+        "description": "Migrate imports of `provideServerRendering` from `@angular/platform-server` to `@angular/ssr`.",
+        "file": "generated/packages/angular/migrations/migrate-provide-server-rendering-import.json",
+        "hidden": false,
+        "name": "migrate-provide-server-rendering-import",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "/nx-api/angular/migrations/migrate-provide-server-rendering-import",
+        "type": "migration"
+      },
+      "/nx-api/angular/migrations/replace-provide-server-routing": {
+        "description": "Replace `provideServerRouting` with `provideServerRendering` using `withRoutes`.",
+        "file": "generated/packages/angular/migrations/replace-provide-server-routing.json",
+        "hidden": false,
+        "name": "replace-provide-server-routing",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "/nx-api/angular/migrations/replace-provide-server-routing",
+        "type": "migration"
+      },
+      "/nx-api/angular/migrations/set-generator-defaults-for-previous-style-guide": {
+        "description": "Update the generator defaults to maintain the previous style guide behavior.",
+        "file": "generated/packages/angular/migrations/set-generator-defaults-for-previous-style-guide.json",
+        "hidden": false,
+        "name": "set-generator-defaults-for-previous-style-guide",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "/nx-api/angular/migrations/set-generator-defaults-for-previous-style-guide",
+        "type": "migration"
+      },
+      "/nx-api/angular/migrations/update-module-resolution": {
+        "description": "Update 'moduleResolution' to 'bundler' in TypeScript configurations. You can read more about this here: https://www.typescriptlang.org/tsconfig/#moduleResolution.",
+        "file": "generated/packages/angular/migrations/update-module-resolution.json",
+        "hidden": false,
+        "name": "update-module-resolution",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "/nx-api/angular/migrations/update-module-resolution",
+        "type": "migration"
+      },
+      "/nx-api/angular/migrations/21.2.0-package-updates": {
+        "description": "",
+        "file": "generated/packages/angular/migrations/21.2.0-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "/nx-api/angular/migrations/21.2.0-package-updates",
+        "type": "migration"
+      },
       "/nx-api/angular/migrations/21.1.0-package-updates": {
         "description": "",
         "file": "generated/packages/angular/migrations/21.1.0-package-updates.json",
@@ -1687,6 +1747,26 @@
       }
     },
     "migrations": {
+      "/nx-api/eslint/migrations/21.2.0-typescript-eslint-package-updates": {
+        "description": "",
+        "file": "generated/packages/eslint/migrations/21.2.0-typescript-eslint-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-typescript-eslint-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/eslint",
+        "path": "/nx-api/eslint/migrations/21.2.0-typescript-eslint-package-updates",
+        "type": "migration"
+      },
+      "/nx-api/eslint/migrations/21.2.0-@typescript-eslint-package-updates": {
+        "description": "",
+        "file": "generated/packages/eslint/migrations/21.2.0-@typescript-eslint-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-@typescript-eslint-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/eslint",
+        "path": "/nx-api/eslint/migrations/21.2.0-@typescript-eslint-package-updates",
+        "type": "migration"
+      },
       "/nx-api/eslint/migrations/20.7.0-package-updates": {
         "description": "",
         "file": "generated/packages/eslint/migrations/20.7.0-package-updates.json",
@@ -2454,6 +2534,16 @@
       }
     },
     "migrations": {
+      "/nx-api/js/migrations/21.2.0-package-updates": {
+        "description": "",
+        "file": "generated/packages/js/migrations/21.2.0-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/js",
+        "path": "/nx-api/js/migrations/21.2.0-package-updates",
+        "type": "migration"
+      },
       "/nx-api/js/migrations/20.7.1-beta.0-package-updates": {
         "description": "",
         "file": "generated/packages/js/migrations/20.7.1-beta.0-package-updates.json",
@@ -5724,6 +5814,16 @@
       }
     },
     "migrations": {
+      "/nx-api/workspace/migrations/21.2.0-package-updates": {
+        "description": "",
+        "file": "generated/packages/workspace/migrations/21.2.0-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/workspace",
+        "path": "/nx-api/workspace/migrations/21.2.0-package-updates",
+        "type": "migration"
+      },
       "/nx-api/workspace/migrations/20.4.0-package-updates": {
         "description": "",
         "file": "generated/packages/workspace/migrations/20.4.0-package-updates.json",

docs/generated/packages-metadata.json

@@ -439,6 +439,66 @@
       }
     ],
     "migrations": [
+      {
+        "description": "Update the @angular/cli package version to 20.0.0-rc.3.",
+        "file": "generated/packages/angular/migrations/update-angular-cli-version-20-0-0-rc-3.json",
+        "hidden": false,
+        "name": "update-angular-cli-version-20-0-0-rc-3",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "angular/migrations/update-angular-cli-version-20-0-0-rc-3",
+        "type": "migration"
+      },
+      {
+        "description": "Migrate imports of `provideServerRendering` from `@angular/platform-server` to `@angular/ssr`.",
+        "file": "generated/packages/angular/migrations/migrate-provide-server-rendering-import.json",
+        "hidden": false,
+        "name": "migrate-provide-server-rendering-import",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "angular/migrations/migrate-provide-server-rendering-import",
+        "type": "migration"
+      },
+      {
+        "description": "Replace `provideServerRouting` with `provideServerRendering` using `withRoutes`.",
+        "file": "generated/packages/angular/migrations/replace-provide-server-routing.json",
+        "hidden": false,
+        "name": "replace-provide-server-routing",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "angular/migrations/replace-provide-server-routing",
+        "type": "migration"
+      },
+      {
+        "description": "Update the generator defaults to maintain the previous style guide behavior.",
+        "file": "generated/packages/angular/migrations/set-generator-defaults-for-previous-style-guide.json",
+        "hidden": false,
+        "name": "set-generator-defaults-for-previous-style-guide",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "angular/migrations/set-generator-defaults-for-previous-style-guide",
+        "type": "migration"
+      },
+      {
+        "description": "Update 'moduleResolution' to 'bundler' in TypeScript configurations. You can read more about this here: https://www.typescriptlang.org/tsconfig/#moduleResolution.",
+        "file": "generated/packages/angular/migrations/update-module-resolution.json",
+        "hidden": false,
+        "name": "update-module-resolution",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "angular/migrations/update-module-resolution",
+        "type": "migration"
+      },
+      {
+        "description": "",
+        "file": "generated/packages/angular/migrations/21.2.0-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/angular",
+        "path": "angular/migrations/21.2.0-package-updates",
+        "type": "migration"
+      },
       {
         "description": "",
         "file": "generated/packages/angular/migrations/21.1.0-package-updates.json",
@@ -1675,6 +1735,26 @@
       }
     ],
     "migrations": [
+      {
+        "description": "",
+        "file": "generated/packages/eslint/migrations/21.2.0-typescript-eslint-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-typescript-eslint-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/eslint",
+        "path": "eslint/migrations/21.2.0-typescript-eslint-package-updates",
+        "type": "migration"
+      },
+      {
+        "description": "",
+        "file": "generated/packages/eslint/migrations/21.2.0-@typescript-eslint-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-@typescript-eslint-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/eslint",
+        "path": "eslint/migrations/21.2.0-@typescript-eslint-package-updates",
+        "type": "migration"
+      },
       {
         "description": "",
         "file": "generated/packages/eslint/migrations/20.7.0-package-updates.json",
@@ -2436,6 +2516,16 @@
       }
     ],
     "migrations": [
+      {
+        "description": "",
+        "file": "generated/packages/js/migrations/21.2.0-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/js",
+        "path": "js/migrations/21.2.0-package-updates",
+        "type": "migration"
+      },
       {
         "description": "",
         "file": "generated/packages/js/migrations/20.7.1-beta.0-package-updates.json",
@@ -5686,6 +5776,16 @@
       }
     ],
     "migrations": [
+      {
+        "description": "",
+        "file": "generated/packages/workspace/migrations/21.2.0-package-updates.json",
+        "hidden": false,
+        "name": "21.2.0-package-updates",
+        "version": "21.2.0-beta.0",
+        "originalFilePath": "/packages/workspace",
+        "path": "workspace/migrations/21.2.0-package-updates",
+        "type": "migration"
+      },
       {
         "description": "",
         "file": "generated/packages/workspace/migrations/20.4.0-package-updates.json",

docs/generated/packages/angular/executors/application.json

@@ -54,7 +54,6 @@
         "description": "The full path for the browser entry point to the application, relative to the current workspace."
       },
       "server": {
-        "type": "string",
         "description": "The full path for the server entry point to the application, relative to the current workspace.",
         "oneOf": [
           {
@@ -80,7 +79,7 @@
       },
       "deployUrl": {
         "type": "string",
-        "description": "Customize the base path for the URLs of resources in 'index.html' and component stylesheets. This option is only necessary for specific deployment scenarios, such as with Angular Elements or when utilizing different CDN locations. _Note: this is only supported in Angular versions >= 17.3.0_."
+        "description": "Customize the base path for the URLs of resources in 'index.html' and component stylesheets. This option is only necessary for specific deployment scenarios, such as with Angular Elements or when utilizing different CDN locations."
       },
       "security": {
         "description": "Security features to protect against XSS and other common attacks. _Note: this is only supported in Angular versions >= 19.0.0_.",
@@ -226,7 +225,7 @@
       "clearScreen": {
         "type": "boolean",
         "default": false,
-        "description": "Automatically clear the terminal screen during rebuilds. _Note: this is only supported in Angular versions >= 17.2.0_."
+        "description": "Automatically clear the terminal screen during rebuilds."
       },
       "optimization": {
         "description": "Enables optimization of the build output. Including minification of scripts and styles, tree-shaking, dead-code elimination, inlining of critical CSS and fonts inlining. For more information, see https://angular.dev/reference/configs/workspace-config#optimization-configuration.",
@@ -259,7 +258,7 @@
                       },
                       "removeSpecialComments": {
                         "type": "boolean",
-                        "description": "Remove comments in global CSS that contains '@license' or '@preserve' or that starts with '//!' or '/*!'. _Note: this is only supported in Angular versions >= 17.1.0_.",
+                        "description": "Remove comments in global CSS that contains '@license' or '@preserve' or that starts with '//!' or '/*!'.",
                         "default": true
                       }
                     },
@@ -293,17 +292,22 @@
         ]
       },
       "loader": {
-        "description": "Defines the type of loader to use with a specified file extension when used with a JavaScript `import`. `text` inlines the content as a string; `binary` inlines the content as a Uint8Array; `file` emits the file and provides the runtime location of the file; `empty` considers the content to be empty and not include it in bundles. _Note: this is only supported in Angular versions >= 17.1.0_.",
+        "description": "Defines the type of loader to use with a specified file extension when used with a JavaScript `import`. `text` inlines the content as a string; `binary` inlines the content as a Uint8Array; `file` emits the file and provides the runtime location of the file; `empty` considers the content to be empty and not include it in bundles.",
         "type": "object",
         "patternProperties": {
           "^\\.\\S+$": { "enum": ["text", "binary", "file", "empty"] }
         }
       },
       "define": {
-        "description": "Defines global identifiers that will be replaced with a specified constant value when found in any JavaScript or TypeScript code including libraries. The value will be used directly. String values must be put in quotes. Identifiers within Angular metadata such as Component Decorators will not be replaced. _Note: this is only supported in Angular versions >= 17.2.0_.",
+        "description": "Defines global identifiers that will be replaced with a specified constant value when found in any JavaScript or TypeScript code including libraries. The value will be used directly. String values must be put in quotes. Identifiers within Angular metadata such as Component Decorators will not be replaced.",
         "type": "object",
         "additionalProperties": { "type": "string" }
       },
+      "conditions": {
+        "description": "Custom package resolution conditions used to resolve conditional exports/imports. Defaults to ['module', 'development'/'production']. The following special conditions are always present if the requirements are satisfied: 'default', 'import', 'require', 'browser', 'node'. _Note: this is only supported in Angular versions >= 20.0.0_.",
+        "type": "array",
+        "items": { "type": "string" }
+      },
       "fileReplacements": {
         "description": "Replace compilation source files with other compilation source files in the build.",
         "type": "array",
@@ -322,7 +326,7 @@
         "default": []
       },
       "outputPath": {
-        "description": "Specify the output path relative to workspace root. _Note: the object notation is only supported in Angular versions >= 17.1.0_.",
+        "description": "Specify the output path relative to workspace root.",
         "oneOf": [
           {
             "type": "object",
@@ -387,6 +391,11 @@
                 "type": "boolean",
                 "description": "Resolve vendor packages source maps.",
                 "default": false
+              },
+              "sourcesContent": {
+                "type": "boolean",
+                "description": "Output original source content for files within the source map. _Note: this is only supported in Angular versions >= 20.0.0_.",
+                "default": true
               }
             },
             "additionalProperties": false
@@ -511,7 +520,7 @@
               "preloadInitial": {
                 "type": "boolean",
                 "default": true,
-                "description": "Generates 'preload', 'modulepreload', and 'preconnect' link elements for initial application files and resources. _Note: this is only supported in Angular versions >= 17.1.0_."
+                "description": "Generates 'preload', 'modulepreload', and 'preconnect' link elements for initial application files and resources."
               }
             },
             "required": ["input"]
@@ -694,12 +703,12 @@
         }
       },
       "indexHtmlTransformer": {
-        "description": "Path to a file exposing a default function to transform the `index.html` file. _Note: this is only supported in Angular versions >= 17.1.0_.",
+        "description": "Path to a file exposing a default function to transform the `index.html` file.",
         "type": "string"
       }
     },
     "additionalProperties": false,
-    "required": ["outputPath", "index", "browser", "tsConfig"],
+    "required": ["outputPath", "tsConfig"],
     "definitions": {
       "assetPattern": {
         "oneOf": [