@angular/build 21.0.0-next.2 → 21.0.0-next.4

package/src/builders/unit-test/schema.json

@@ -6,20 +6,20 @@
   "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"
@@ -32,41 +32,43 @@
         "type": "string"
       },
       "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"
       },
-      "default": [],
-      "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"
-      },
-      "default": []
+      }
     },
     "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": [
           {
@@ -90,14 +92,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/reporters-enum"
+              },
+              {
+                "type": "string"
+              }
+            ]
+          },
+          {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 2,
+            "items": [
+              {
+                "anyOf": [
+                  {
+                    "$ref": "#/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": {
@@ -105,11 +142,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,
@@ -126,6 +169,10 @@
         "json",
         "json-summary"
       ]
+    },
+    "reporters-enum": {
+      "type": "string",
+      "enum": ["default", "verbose", "dots", "json", "junit", "tap", "tap-flat", "html"]
     }
   }
 }

package/src/tools/esbuild/stylesheets/bundle-options.d.ts

@@ -29,7 +29,10 @@ export interface BundleStylesheetOptions {
         file: string;
         package: string;
     };
-    postcssConfiguration?: PostcssConfiguration;
+    postcssConfiguration?: {
+        config: PostcssConfiguration;
+        configPath: string;
+    };
     publicPath?: string;
     cacheOptions: NormalizedCachedOptions;
 }

package/src/tools/esbuild/stylesheets/stylesheet-plugin-factory.d.ts

@@ -46,7 +46,10 @@ export interface StylesheetPluginOptions {
      * initialized and used for every stylesheet. This overrides the tailwind integration
      * and any tailwind usage must be manually configured in the custom postcss usage.
      */
-    postcssConfiguration?: PostcssConfiguration;
+    postcssConfiguration?: {
+        config: PostcssConfiguration;
+        configPath: string;
+    };
     /**
      * Optional Options for configuring Sass behavior.
      */

package/src/tools/esbuild/stylesheets/stylesheet-plugin-factory.js

@@ -46,6 +46,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StylesheetPluginFactory = void 0;
 const node_assert_1 = __importDefault(require("node:assert"));
 const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
 const node_path_1 = require("node:path");
 const tinyglobby_1 = require("tinyglobby");
 const error_1 = require("../../../utils/error");
@@ -143,13 +144,15 @@ class StylesheetPluginFactory {
         node_assert_1.default.equal(++this.initPostcssCallCount, 1, '`initPostcss` was called more than once.');
         const { options } = this;
         if (options.postcssConfiguration) {
-            const postCssInstanceKey = JSON.stringify(options.postcssConfiguration);
+            const { config, configPath } = options.postcssConfiguration;
+            const postCssInstanceKey = JSON.stringify(config);
             let postcssProcessor = postcssProcessors.get(postCssInstanceKey)?.deref();
             if (!postcssProcessor) {
                 postcss ??= (await Promise.resolve().then(() => __importStar(require('postcss')))).default;
                 postcssProcessor = postcss();
-                for (const [pluginName, pluginOptions] of options.postcssConfiguration.plugins) {
-                    const { default: plugin } = await Promise.resolve(`${pluginName}`).then(s => __importStar(require(s)));
+                const postCssPluginRequire = (0, node_module_1.createRequire)((0, node_path_1.dirname)(configPath) + '/');
+                for (const [pluginName, pluginOptions] of config.plugins) {
+                    const plugin = postCssPluginRequire(pluginName);
                     if (typeof plugin !== 'function' || plugin.postcss !== true) {
                         throw new Error(`Attempted to load invalid Postcss plugin: "${pluginName}"`);
                     }

package/src/tools/vite/middlewares/assets-middleware.d.ts

@@ -6,6 +6,7 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 import type { Connect, ViteDevServer } from 'vite';
+import { ResultFile } from '../../../builders/application/results';
 import { AngularMemoryOutputFiles, AngularOutputAssets } from '../utils';
 export interface ComponentStyleRecord {
     rawContent: Uint8Array;
@@ -13,3 +14,4 @@ export interface ComponentStyleRecord {
     reload?: boolean;
 }
 export declare function createAngularAssetsMiddleware(server: ViteDevServer, assets: AngularOutputAssets, outputFiles: AngularMemoryOutputFiles, componentStyles: Map<string, ComponentStyleRecord>, encapsulateStyle: (style: Uint8Array, componentId: string) => string): Connect.NextHandleFunction;
+export declare function createBuildAssetsMiddleware(basePath: string, buildResultFiles: ReadonlyMap<string, ResultFile>, readHandler?: (path: string) => Buffer): Connect.NextHandleFunction;

package/src/tools/vite/middlewares/assets-middleware.js

@@ -8,6 +8,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAngularAssetsMiddleware = createAngularAssetsMiddleware;
+exports.createBuildAssetsMiddleware = createBuildAssetsMiddleware;
 const mrmime_1 = require("mrmime");
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
@@ -171,3 +172,33 @@ function checkAndHandleEtag(req, res, etag) {
     }
     return false;
 }
+function createBuildAssetsMiddleware(basePath, buildResultFiles, readHandler = node_fs_1.readFileSync) {
+    return function buildAssetsMiddleware(req, res, next) {
+        if (req.url === undefined || res.writableEnded) {
+            return;
+        }
+        // Parse the incoming request.
+        // The base of the URL is unused but required to parse the URL.
+        const pathname = (0, utils_1.pathnameWithoutBasePath)(req.url, basePath);
+        const extension = (0, node_path_1.extname)(pathname);
+        if (extension && !/\.[mc]?[jt]s(?:\.map)?$/.test(extension)) {
+            const outputFile = buildResultFiles.get(pathname.slice(1));
+            if (outputFile) {
+                const contents = outputFile.origin === 'memory' ? outputFile.contents : readHandler(outputFile.inputPath);
+                const etag = `W/${(0, node_crypto_1.createHash)('sha256').update(contents).digest('hex')}`;
+                if (checkAndHandleEtag(req, res, etag)) {
+                    return;
+                }
+                const mimeType = (0, mrmime_1.lookup)(extension);
+                if (mimeType) {
+                    res.setHeader('Content-Type', mimeType);
+                }
+                res.setHeader('ETag', etag);
+                res.setHeader('Cache-Control', 'no-cache');
+                res.end(contents);
+                return;
+            }
+        }
+        next();
+    };
+}

package/src/utils/normalize-cache.js

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeCacheOptions = normalizeCacheOptions;
 const node_path_1 = require("node:path");
 /** Version placeholder is replaced during the build process with actual package version */
-const VERSION = '21.0.0-next.2';
+const VERSION = '21.0.0-next.4';
 function hasCacheMetadata(value) {
     return (!!value &&
         typeof value === 'object' &&

package/src/utils/postcss-configuration.d.ts

@@ -14,4 +14,7 @@ export interface SearchDirectory {
 }
 export declare function generateSearchDirectories(roots: string[]): Promise<SearchDirectory[]>;
 export declare function findTailwindConfiguration(searchDirectories: SearchDirectory[]): string | undefined;
-export declare function loadPostcssConfiguration(searchDirectories: SearchDirectory[]): Promise<PostcssConfiguration | undefined>;
+export declare function loadPostcssConfiguration(searchDirectories: SearchDirectory[]): Promise<{
+    configPath: string;
+    config: PostcssConfiguration;
+} | undefined>;

package/src/utils/postcss-configuration.js

@@ -67,7 +67,7 @@ async function loadPostcssConfiguration(searchDirectories) {
                 config.plugins.push(element);
             }
         }
-        return config;
+        return { config, configPath };
     }
     // Normalize plugin object map form
     const entries = Object.entries(raw.plugins);
@@ -81,5 +81,5 @@ async function loadPostcssConfiguration(searchDirectories) {
         }
         config.plugins.push([name, options]);
     }
-    return config;
+    return { config, configPath };
 }

package/src/utils/server-rendering/load-esm-from-memory.d.ts

@@ -6,12 +6,13 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 import type { ApplicationRef, Type } from '@angular/core';
+import type { BootstrapContext } from '@angular/platform-browser';
 import type { ɵextractRoutesAndCreateRouteTree, ɵgetOrCreateAngularServerApp } from '@angular/ssr';
 /**
  * Represents the exports available from the main server bundle.
  */
 interface MainServerBundleExports {
-    default: (() => Promise<ApplicationRef>) | Type<unknown>;
+    default: ((context: BootstrapContext) => Promise<ApplicationRef>) | Type<unknown>;
     ɵextractRoutesAndCreateRouteTree: typeof ɵextractRoutesAndCreateRouteTree;
     ɵgetOrCreateAngularServerApp: typeof ɵgetOrCreateAngularServerApp;
 }

package/src/utils/supported-browsers.js

@@ -12,11 +12,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSupportedBrowsers = getSupportedBrowsers;
 const browserslist_1 = __importDefault(require("browserslist"));
+// The below is replaced by bazel `npm_package`.
+const BASELINE_DATE = '2025-08-20';
 function getSupportedBrowsers(projectRoot, logger) {
     // Read the browserslist configuration containing Angular's browser support policy.
-    const angularBrowserslist = (0, browserslist_1.default)(undefined, {
-        path: require.resolve('../../.browserslistrc'),
-    });
+    const angularBrowserslist = (0, browserslist_1.default)(`baseline widely available on ${getBaselineDate()}`);
     // Use Angular's configuration as the default.
     browserslist_1.default.defaults = angularBrowserslist;
     // Get the minimum set of browser versions supported by Angular.
@@ -50,3 +50,7 @@ function getSupportedBrowsers(projectRoot, logger) {
     }
     return Array.from(browsersFromConfigOrDefault);
 }
+function getBaselineDate() {
+    // Unlike `npm_package`, `ts_project` which is used to run unit tests does not support substitutions.
+    return BASELINE_DATE[0] === 'B' ? '2025-01-01' : BASELINE_DATE;
+}

package/src/utils/test-files.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { ResultFile } from '../builders/application/results';
+/**
+ * Writes a collection of build result files to a specified directory.
+ * This function handles both in-memory and on-disk files, creating subdirectories
+ * as needed.
+ *
+ * @param files A map of file paths to `ResultFile` objects, representing the build output.
+ * @param testDir The absolute path to the directory where the files should be written.
+ */
+export declare function writeTestFiles(files: Record<string, ResultFile>, testDir: string): Promise<void>;

package/src/utils/test-files.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeTestFiles = writeTestFiles;
+const fs = __importStar(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const bundler_context_1 = require("../tools/esbuild/bundler-context");
+const utils_1 = require("../tools/esbuild/utils");
+/**
+ * Writes a collection of build result files to a specified directory.
+ * This function handles both in-memory and on-disk files, creating subdirectories
+ * as needed.
+ *
+ * @param files A map of file paths to `ResultFile` objects, representing the build output.
+ * @param testDir The absolute path to the directory where the files should be written.
+ */
+async function writeTestFiles(files, testDir) {
+    const directoryExists = new Set();
+    // Writes the test related output files to disk and ensures the containing directories are present
+    await (0, utils_1.emitFilesToDisk)(Object.entries(files), async ([filePath, file]) => {
+        if (file.type !== bundler_context_1.BuildOutputFileType.Browser && file.type !== bundler_context_1.BuildOutputFileType.Media) {
+            return;
+        }
+        const fullFilePath = node_path_1.default.join(testDir, filePath);
+        // Ensure output subdirectories exist
+        const fileBasePath = node_path_1.default.dirname(fullFilePath);
+        if (fileBasePath && !directoryExists.has(fileBasePath)) {
+            await fs.mkdir(fileBasePath, { recursive: true });
+            directoryExists.add(fileBasePath);
+        }
+        if (file.origin === 'memory') {
+            // Write file contents
+            await fs.writeFile(fullFilePath, file.contents);
+        }
+        else {
+            // Copy file contents
+            await fs.copyFile(file.inputPath, fullFilePath, fs.constants.COPYFILE_FICLONE);
+        }
+    });
+}

package/.browserslistrc

@@ -1,7 +0,0 @@
-Chrome >= 110
-ChromeAndroid >= 110
-Edge >= 110
-Firefox >= 110
-FirefoxAndroid >= 110
-Safari >= 16
-iOS >= 16

package/src/typings.d.ts

@@ -1,19 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-
-// The `bundled_beasties` causes issues with module mappings in Bazel,
-// leading to unexpected behavior with esbuild. Specifically, the problem occurs
-// when esbuild resolves to a different module or version than expected, due to
-// how Bazel handles module mappings.
-//
-// This change aims to resolve esbuild types correctly and maintain consistency
-// in the Bazel build process.
-
-declare module 'esbuild' {
-  export * from 'esbuild-wasm';
-}