@angular/cli 21.0.0-next.3 → 21.0.0-next.4

package/lib/config/schema.json

@@ -4304,23 +4304,23 @@
       "properties": {
         "buildTarget": {
           "type": "string",
-          "description": "A build builder target to serve in the format of `project:target[:configuration]`. You can also pass in more than one configuration name as a comma-separated list. Example: `project:target:production,staging`.",
+          "description": "Specifies the build target to use for the unit test build in the format `project:target[:configuration]`. You can also pass a comma-separated list of configurations. Example: `project:target:production,staging`.",
           "pattern": "^[^:\\s]*:[^:\\s]*(:[^\\s]+)?$"
         },
         "tsConfig": {
           "type": "string",
-          "description": "The name of the TypeScript configuration file."
+          "description": "The path to the TypeScript configuration file, relative to the workspace root."
         },
         "runner": {
           "type": "string",
-          "description": "The name of the test runner to use for test execution.",
+          "description": "Specifies the test runner to use for test execution.",
           "enum": [
             "karma",
             "vitest"
           ]
         },
         "browsers": {
-          "description": "A list of browsers to use for test execution. If undefined, jsdom on Node.js will be used instead of a browser. For Vitest and Karma, browser names ending with 'Headless' (e.g., 'ChromeHeadless') will enable headless mode for that browser.",
+          "description": "Specifies the browsers to use for test execution. When not specified, tests are run in a Node.js environment using jsdom. For both Vitest and Karma, browser names ending with 'Headless' (e.g., 'ChromeHeadless') will enable headless mode.",
           "type": "array",
           "items": {
             "type": "string"
@@ -4335,39 +4335,43 @@
           "default": [
             "**/*.spec.ts"
           ],
-          "description": "Globs of files to include, relative to project root. \nThere are 2 special cases:\n - when a path to directory is provided, all spec files ending \".spec.@(ts|tsx)\" will be included\n - when a path to a file is provided, and a matching spec file exists it will be included instead."
+          "description": "Specifies glob patterns of files to include for testing, relative to the project root. This option also has special handling for directory paths (includes all `.spec.ts` files within) and file paths (includes the corresponding `.spec` file if one exists)."
         },
         "exclude": {
           "type": "array",
           "items": {
             "type": "string"
           },
-          "description": "Globs of files to exclude, relative to the project root."
+          "description": "Specifies glob patterns of files to exclude from testing, relative to the project root."
+        },
+        "filter": {
+          "type": "string",
+          "description": "Specifies a regular expression pattern to match against test suite and test names. Only tests with a name matching the pattern will be executed. For example, `^App` will run only tests in suites beginning with 'App'."
         },
         "watch": {
           "type": "boolean",
-          "description": "Re-run tests when source files change. Defaults to `true` in TTY environments and `false` otherwise."
+          "description": "Enables watch mode, which re-runs tests when source files change. Defaults to `true` in TTY environments and `false` otherwise."
         },
         "debug": {
           "type": "boolean",
-          "description": "Initialize the test runner to support using the Node Inspector for test debugging.",
+          "description": "Enables debugging mode for tests, allowing the use of the Node Inspector.",
           "default": false
         },
         "codeCoverage": {
           "type": "boolean",
-          "description": "Output a code coverage report.",
+          "description": "Enables code coverage reporting for tests.",
           "default": false
         },
         "codeCoverageExclude": {
           "type": "array",
-          "description": "Globs to exclude from code coverage.",
+          "description": "Specifies glob patterns of files to exclude from the code coverage report.",
           "items": {
             "type": "string"
           }
         },
         "codeCoverageReporters": {
           "type": "array",
-          "description": "Reporters to use for code coverage results.",
+          "description": "Specifies the reporters to use for code coverage results. Each reporter can be a string representing its name, or a tuple containing the name and an options object. Built-in reporters include 'html', 'lcov', 'lcovonly', 'text', 'text-summary', 'cobertura', 'json', and 'json-summary'.",
           "items": {
             "oneOf": [
               {
@@ -4391,14 +4395,49 @@
         },
         "reporters": {
           "type": "array",
-          "description": "Test runner reporters to use. Directly passed to the test runner.",
+          "description": "Specifies the reporters to use during test execution. Each reporter can be a string representing its name, or a tuple containing the name and an options object. Built-in reporters include 'default', 'verbose', 'dots', 'json', 'junit', 'tap', 'tap-flat', and 'html'. You can also provide a path to a custom reporter.",
           "items": {
-            "type": "string"
+            "oneOf": [
+              {
+                "anyOf": [
+                  {
+                    "$ref": "#/definitions/AngularBuildBuildersUnitTestSchema/definitions/reporters-enum"
+                  },
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 2,
+                "items": [
+                  {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/AngularBuildBuildersUnitTestSchema/definitions/reporters-enum"
+                      },
+                      {
+                        "type": "string"
+                      }
+                    ]
+                  },
+                  {
+                    "type": "object"
+                  }
+                ]
+              }
+            ]
           }
         },
+        "outputFile": {
+          "type": "string",
+          "description": "Specifies a file path for the test report, applying only to the first reporter. To configure output files for multiple reporters, use the tuple format `['reporter-name', { outputFile: '...' }]` within the `reporters` option. When not provided, output is written to the console."
+        },
         "providersFile": {
           "type": "string",
-          "description": "TypeScript file that exports an array of Angular providers to use during test execution. The array must be a default export.",
+          "description": "Specifies the path to a TypeScript file that provides an array of Angular providers for the test environment. The file must contain a default export of the provider array.",
           "minLength": 1
         },
         "setupFiles": {
@@ -4406,11 +4445,17 @@
           "items": {
             "type": "string"
           },
-          "description": "A list of global setup and configuration files that are included before the test files. The application's polyfills are always included before these files. The Angular Testbed is also initialized prior to the execution of these files."
+          "description": "A list of paths to global setup files that are executed before the test files. The application's polyfills and the Angular TestBed are always initialized before these files."
         },
         "progress": {
           "type": "boolean",
-          "description": "Log progress to the console while building. Defaults to the build target's progress value."
+          "description": "Shows build progress information in the console. Defaults to the `progress` setting of the specified `buildTarget`."
+        },
+        "dumpVirtualFiles": {
+          "type": "boolean",
+          "description": "Dumps build output files to the `.angular/cache` directory for debugging purposes.",
+          "default": false,
+          "visible": false
         }
       },
       "additionalProperties": false,
@@ -4426,6 +4471,19 @@
             "json",
             "json-summary"
           ]
+        },
+        "reporters-enum": {
+          "type": "string",
+          "enum": [
+            "default",
+            "verbose",
+            "dots",
+            "json",
+            "junit",
+            "tap",
+            "tap-flat",
+            "html"
+          ]
         }
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/cli",
-  "version": "21.0.0-next.3",
+  "version": "21.0.0-next.4",
   "description": "CLI tool for Angular",
   "main": "lib/cli/index.js",
   "bin": {
@@ -25,18 +25,18 @@
   },
   "homepage": "https://github.com/angular/angular-cli",
   "dependencies": {
-    "@angular-devkit/architect": "0.2100.0-next.3",
-    "@angular-devkit/core": "21.0.0-next.3",
-    "@angular-devkit/schematics": "21.0.0-next.3",
-    "@inquirer/prompts": "7.8.4",
-    "@listr2/prompt-adapter-inquirer": "3.0.3",
-    "@modelcontextprotocol/sdk": "1.17.5",
-    "@schematics/angular": "21.0.0-next.3",
+    "@angular-devkit/architect": "0.2100.0-next.4",
+    "@angular-devkit/core": "21.0.0-next.4",
+    "@angular-devkit/schematics": "21.0.0-next.4",
+    "@inquirer/prompts": "7.8.6",
+    "@listr2/prompt-adapter-inquirer": "3.0.4",
+    "@modelcontextprotocol/sdk": "1.18.0",
+    "@schematics/angular": "21.0.0-next.4",
     "@yarnpkg/lockfile": "1.1.0",
     "algoliasearch": "5.37.0",
     "ini": "5.0.0",
     "jsonc-parser": "3.3.1",
-    "listr2": "9.0.3",
+    "listr2": "9.0.4",
     "npm-package-arg": "13.0.0",
     "pacote": "21.0.1",
     "resolve": "1.22.10",
@@ -47,17 +47,17 @@
   "ng-update": {
     "migrations": "@schematics/angular/migrations/migration-collection.json",
     "packageGroup": {
-      "@angular/cli": "21.0.0-next.3",
-      "@angular/build": "21.0.0-next.3",
-      "@angular/ssr": "21.0.0-next.3",
-      "@angular-devkit/architect": "0.2100.0-next.3",
-      "@angular-devkit/build-angular": "21.0.0-next.3",
-      "@angular-devkit/build-webpack": "0.2100.0-next.3",
-      "@angular-devkit/core": "21.0.0-next.3",
-      "@angular-devkit/schematics": "21.0.0-next.3"
+      "@angular/cli": "21.0.0-next.4",
+      "@angular/build": "21.0.0-next.4",
+      "@angular/ssr": "21.0.0-next.4",
+      "@angular-devkit/architect": "0.2100.0-next.4",
+      "@angular-devkit/build-angular": "21.0.0-next.4",
+      "@angular-devkit/build-webpack": "0.2100.0-next.4",
+      "@angular-devkit/core": "21.0.0-next.4",
+      "@angular-devkit/schematics": "21.0.0-next.4"
     }
   },
-  "packageManager": "pnpm@10.15.1",
+  "packageManager": "pnpm@10.17.0",
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
     "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",

package/src/commands/mcp/tools/examples.js

@@ -185,7 +185,6 @@ new or evolving features.
 });
 async function createFindExampleHandler({ exampleDatabasePath }) {
     let db;
-    let queryStatement;
     if (process.env['NG_MCP_EXAMPLES_DIR']) {
         db = await setupRuntimeExamples(process.env['NG_MCP_EXAMPLES_DIR']);
     }

package/src/commands/mcp/tools/onpush-zoneless-migration/prompts.js

@@ -148,6 +148,7 @@ function generateZonelessMigrationInstructionsForComponent(filePath) {
   3.  **DO NOT** use \`ChangeDetectionStrategy.OnPush\`. This will be the next step in the migration, but it is not part of this task.
   4.  **DO NOT** modify properties that are already signals or are used with the \`async\` pipe in the template, as they are already zoneless-compatible.
   5.  **DO NOT** make any changes to files other than the component file at \`${filePath}\` and its direct template/style files if necessary.
+  6.  **DO NOT** remove or modify usages of \`NgZone.run\` or \`NgZone.runOutsideAngular\`. These are still required.
 
   ### Final Step
   After you have applied all the required changes and followed all the rules, consult this tool again for the next steps in the migration process.`;

package/src/utilities/version.js

@@ -22,4 +22,4 @@ class Version {
         this.patch = patch;
     }
 }
-exports.VERSION = new Version('21.0.0-next.3');
+exports.VERSION = new Version('21.0.0-next.4');