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

package/src/builders/unit-test/runners/vitest/plugins.js

@@ -0,0 +1,131 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVitestPlugins = createVitestPlugins;
+const node_assert_1 = __importDefault(require("node:assert"));
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const assets_middleware_1 = require("../../../../tools/vite/middlewares/assets-middleware");
+const path_1 = require("../../../../utils/path");
+function createVitestPlugins(options, testSetupFiles, browserOptions, pluginOptions) {
+    const { workspaceRoot, projectName, buildResultFiles, testFileToEntryPoint } = pluginOptions;
+    return [
+        {
+            name: 'angular:project-init',
+            // Type is incorrect. This allows a Promise<void>.
+            // eslint-disable-next-line @typescript-eslint/no-misused-promises
+            configureVitest: async (context) => {
+                // Create a subproject that can be configured with plugins for browser mode.
+                // Plugins defined directly in the vite overrides will not be present in the
+                // browser specific Vite instance.
+                await context.injectTestProjects({
+                    test: {
+                        name: projectName,
+                        root: workspaceRoot,
+                        globals: true,
+                        setupFiles: testSetupFiles,
+                        // Use `jsdom` if no browsers are explicitly configured.
+                        // `node` is effectively no "environment" and the default.
+                        environment: browserOptions.browser ? 'node' : 'jsdom',
+                        browser: browserOptions.browser,
+                        include: options.include,
+                        ...(options.exclude ? { exclude: options.exclude } : {}),
+                    },
+                    plugins: [
+                        {
+                            name: 'angular:test-in-memory-provider',
+                            enforce: 'pre',
+                            resolveId: (id, importer) => {
+                                if (importer && (id[0] === '.' || id[0] === '/')) {
+                                    let fullPath;
+                                    if (testFileToEntryPoint.has(importer)) {
+                                        fullPath = (0, path_1.toPosixPath)(node_path_1.default.join(workspaceRoot, id));
+                                    }
+                                    else {
+                                        fullPath = (0, path_1.toPosixPath)(node_path_1.default.join(node_path_1.default.dirname(importer), id));
+                                    }
+                                    const relativePath = node_path_1.default.relative(workspaceRoot, fullPath);
+                                    if (buildResultFiles.has((0, path_1.toPosixPath)(relativePath))) {
+                                        return fullPath;
+                                    }
+                                }
+                                if (testFileToEntryPoint.has(id)) {
+                                    return id;
+                                }
+                                (0, node_assert_1.default)(buildResultFiles.size > 0, 'buildResult must be available for resolving.');
+                                const relativePath = node_path_1.default.relative(workspaceRoot, id);
+                                if (buildResultFiles.has((0, path_1.toPosixPath)(relativePath))) {
+                                    return id;
+                                }
+                            },
+                            load: async (id) => {
+                                (0, node_assert_1.default)(buildResultFiles.size > 0, 'buildResult must be available for in-memory loading.');
+                                // Attempt to load as a source test file.
+                                const entryPoint = testFileToEntryPoint.get(id);
+                                let outputPath;
+                                if (entryPoint) {
+                                    outputPath = entryPoint + '.js';
+                                    // To support coverage exclusion of the actual test file, the virtual
+                                    // test entry point only references the built and bundled intermediate file.
+                                    return {
+                                        code: `import "./${outputPath}";`,
+                                    };
+                                }
+                                else {
+                                    // Attempt to load as a built artifact.
+                                    const relativePath = node_path_1.default.relative(workspaceRoot, id);
+                                    outputPath = (0, path_1.toPosixPath)(relativePath);
+                                }
+                                const outputFile = buildResultFiles.get(outputPath);
+                                if (outputFile) {
+                                    const sourceMapPath = outputPath + '.map';
+                                    const sourceMapFile = buildResultFiles.get(sourceMapPath);
+                                    const code = outputFile.origin === 'memory'
+                                        ? Buffer.from(outputFile.contents).toString('utf-8')
+                                        : await (0, promises_1.readFile)(outputFile.inputPath, 'utf-8');
+                                    const map = sourceMapFile
+                                        ? sourceMapFile.origin === 'memory'
+                                            ? Buffer.from(sourceMapFile.contents).toString('utf-8')
+                                            : await (0, promises_1.readFile)(sourceMapFile.inputPath, 'utf-8')
+                                        : undefined;
+                                    return {
+                                        code,
+                                        map: map ? JSON.parse(map) : undefined,
+                                    };
+                                }
+                            },
+                            configureServer: (server) => {
+                                server.middlewares.use((0, assets_middleware_1.createBuildAssetsMiddleware)(server.config.base, buildResultFiles));
+                            },
+                        },
+                        {
+                            name: 'angular:html-index',
+                            transformIndexHtml: () => {
+                                // Add all global stylesheets
+                                if (buildResultFiles.has('styles.css')) {
+                                    return [
+                                        {
+                                            tag: 'link',
+                                            attrs: { href: 'styles.css', rel: 'stylesheet' },
+                                            injectTo: 'head',
+                                        },
+                                    ];
+                                }
+                                return [];
+                            },
+                        },
+                    ],
+                });
+            },
+        },
+    ];
+}

package/src/builders/unit-test/schema.d.ts

@@ -3,76 +3,96 @@
  */
 export type Schema = {
     /**
-     * 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.
+     * 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.
      */
     browsers?: string[];
     /**
-     * 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`.
+     * 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`.
      */
     buildTarget: string;
     /**
-     * Output a code coverage report.
+     * Enables code coverage reporting for tests.
      */
     codeCoverage?: boolean;
     /**
-     * Globs to exclude from code coverage.
+     * Specifies glob patterns of files to exclude from the code coverage report.
      */
     codeCoverageExclude?: string[];
     /**
-     * Reporters to use for code coverage results.
+     * 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'.
      */
     codeCoverageReporters?: SchemaCodeCoverageReporter[];
     /**
-     * Initialize the test runner to support using the Node Inspector for test debugging.
+     * Enables debugging mode for tests, allowing the use of the Node Inspector.
      */
     debug?: boolean;
     /**
-     * Globs of files to exclude, relative to the project root.
+     * Dumps build output files to the `.angular/cache` directory for debugging purposes.
+     */
+    dumpVirtualFiles?: boolean;
+    /**
+     * Specifies glob patterns of files to exclude from testing, relative to the project root.
      */
     exclude?: string[];
     /**
-     * Globs of files to include, relative to project root.
-     * There are 2 special cases:
-     * - when a path to directory is provided, all spec files ending ".spec.@(ts|tsx)" will be
-     * included
-     * - when a path to a file is provided, and a matching spec file exists it will be included
-     * instead.
+     * 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'.
+     */
+    filter?: string;
+    /**
+     * 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).
      */
     include?: string[];
     /**
-     * Log progress to the console while building. Defaults to the build target's progress value.
+     * 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.
+     */
+    outputFile?: string;
+    /**
+     * Shows build progress information in the console. Defaults to the `progress` setting of
+     * the specified `buildTarget`.
      */
     progress?: boolean;
     /**
-     * TypeScript file that exports an array of Angular providers to use during test execution.
-     * The array must be a default export.
+     * 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.
      */
     providersFile?: string;
     /**
-     * Test runner reporters to use. Directly passed to the test runner.
+     * 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.
      */
-    reporters?: string[];
+    reporters?: SchemaReporter[];
     /**
-     * The name of the test runner to use for test execution.
+     * Specifies the test runner to use for test execution.
      */
     runner: Runner;
     /**
-     * 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.
+     * 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.
      */
     setupFiles?: string[];
     /**
-     * The name of the TypeScript configuration file.
+     * The path to the TypeScript configuration file, relative to the workspace root.
      */
     tsConfig: string;
     /**
-     * Re-run tests when source files change. Defaults to `true` in TTY environments and `false`
-     * otherwise.
+     * Enables watch mode, which re-runs tests when source files change. Defaults to `true` in
+     * TTY environments and `false` otherwise.
      */
     watch?: boolean;
 };
@@ -90,8 +110,12 @@ export declare enum CoverageReporters {
     Text = "text",
     TextSummary = "text-summary"
 }
+export type SchemaReporter = ReporterReporter[] | string;
+export type ReporterReporter = {
+    [key: string]: any;
+} | string;
 /**
- * The name of the test runner to use for test execution.
+ * Specifies the test runner to use for test execution.
  */
 export declare enum Runner {
     Karma = "karma",

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

@@ -15,7 +15,7 @@ var CoverageReporters;
     CoverageReporters["TextSummary"] = "text-summary";
 })(CoverageReporters || (exports.CoverageReporters = CoverageReporters = {}));
 /**
- * The name of the test runner to use for test execution.
+ * Specifies the test runner to use for test execution.
  */
 var Runner;
 (function (Runner) {

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,39 +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"
       },
-      "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": [
           {
@@ -88,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": {
@@ -103,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,
@@ -124,6 +169,10 @@
         "json",
         "json-summary"
       ]
+    },
+    "reporters-enum": {
+      "type": "string",
+      "enum": ["default", "verbose", "dots", "json", "junit", "tap", "tap-flat", "html"]
     }
   }
 }

package/src/tools/esbuild/application-code-bundle.js

@@ -418,8 +418,6 @@ function getEsBuildCommonOptions(options) {
             packages = 'external';
         }
     }
-    const minifySyntax = optimizationOptions.scripts;
-    const minifyIdentifiers = minifySyntax && environment_options_1.allowMangle;
     return {
         absWorkingDir: workspaceRoot,
         format: 'esm',
@@ -431,10 +429,9 @@ function getEsBuildCommonOptions(options) {
         metafile: true,
         legalComments: options.extractLicenses ? 'none' : 'eof',
         logLevel: options.verbose && !jsonLogs ? 'debug' : 'silent',
-        keepNames: !minifyIdentifiers,
-        minifyIdentifiers,
-        minifySyntax,
-        minifyWhitespace: minifySyntax,
+        minifyIdentifiers: optimizationOptions.scripts && environment_options_1.allowMangle,
+        minifySyntax: optimizationOptions.scripts,
+        minifyWhitespace: optimizationOptions.scripts,
         pure: ['forwardRef'],
         outdir: workspaceRoot,
         outExtension: outExtension ? { '.js': `.${outExtension}` } : undefined,
@@ -451,7 +448,7 @@ function getEsBuildCommonOptions(options) {
             // Only set to false when script optimizations are enabled. It should not be set to true because
             // Angular turns `ngDevMode` into an object for development debugging purposes when not defined
             // which a constant true value would break.
-            ...(minifySyntax ? { 'ngDevMode': 'false' } : undefined),
+            ...(optimizationOptions.scripts ? { 'ngDevMode': 'false' } : undefined),
             'ngJitMode': jit ? 'true' : 'false',
             'ngServerMode': 'false',
             'ngHmrMode': options.templateUpdates ? 'true' : 'false',

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/tools/vite/utils.js

@@ -53,7 +53,6 @@ function getDepOptimizationConfig({ disabled, exclude, include, target, zoneless
         esbuildOptions: {
             // Set esbuild supported targets.
             target,
-            keepNames: true,
             supported: (0, utils_1.getFeatureSupport)(target, zoneless),
             plugins,
             loader,

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.3';
+const VERSION = '21.0.0-next.4';
 function hasCacheMetadata(value) {
     return (!!value &&
         typeof value === 'object' &&

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>;