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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "21.0.0-next.3",
+  "version": "21.0.0-next.4",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,25 +23,25 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.2100.0-next.3",
+    "@angular-devkit/architect": "0.2100.0-next.4",
     "@babel/core": "7.28.4",
     "@babel/helper-annotate-as-pure": "7.27.3",
     "@babel/helper-split-export-declaration": "7.24.7",
-    "@inquirer/confirm": "5.1.16",
+    "@inquirer/confirm": "5.1.18",
     "@vitejs/plugin-basic-ssl": "2.1.0",
     "beasties": "0.3.5",
-    "browserslist": "^4.23.0",
+    "browserslist": "^4.26.0",
     "esbuild": "0.25.9",
     "https-proxy-agent": "7.0.6",
     "istanbul-lib-instrument": "6.0.3",
     "jsonc-parser": "3.3.1",
-    "listr2": "9.0.3",
+    "listr2": "9.0.4",
     "magic-string": "0.30.19",
     "mrmime": "2.0.1",
     "parse5-html-rewriting-stream": "8.0.0",
     "picomatch": "4.0.3",
     "piscina": "5.1.3",
-    "rolldown": "1.0.0-beta.36",
+    "rolldown": "1.0.0-beta.38",
     "sass": "1.92.1",
     "semver": "7.7.2",
     "source-map-support": "0.5.21",
@@ -60,7 +60,7 @@
     "@angular/platform-browser": "^21.0.0-next.0",
     "@angular/platform-server": "^21.0.0-next.0",
     "@angular/service-worker": "^21.0.0-next.0",
-    "@angular/ssr": "^21.0.0-next.3",
+    "@angular/ssr": "^21.0.0-next.4",
     "karma": "^6.4.0",
     "less": "^4.2.0",
     "ng-packagr": "^21.0.0-next.0",
@@ -112,7 +112,7 @@
     "type": "git",
     "url": "https://github.com/angular/angular-cli.git"
   },
-  "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/builders/application/index.js

@@ -81,7 +81,8 @@ context, extensions) {
             }
             const buildTime = Number(process.hrtime.bigint() - startTime) / 10 ** 9;
             const hasError = result.errors.length > 0;
-            result.addLog(`Application bundle generation ${hasError ? 'failed' : 'complete'}. [${buildTime.toFixed(3)} seconds]\n`);
+            result.addLog(`Application bundle generation ${hasError ? 'failed' : 'complete'}.` +
+                ` [${buildTime.toFixed(3)} seconds] - ${new Date().toISOString()}\n`);
         }
         return result;
     }, {

package/src/builders/karma/application_builder.d.ts

@@ -6,8 +6,6 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 import type { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
-import { ResultFile } from '../application/results';
 import { Schema as KarmaBuilderOptions } from './schema';
 import type { KarmaBuilderTransformsOptions } from './index';
 export declare function execute(options: KarmaBuilderOptions, context: BuilderContext, transforms?: KarmaBuilderTransformsOptions): AsyncIterable<BuilderOutput>;
-export declare function writeTestFiles(files: Record<string, ResultFile>, testDir: string): Promise<void>;

package/src/builders/karma/application_builder.js

@@ -44,204 +44,33 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.execute = execute;
-exports.writeTestFiles = writeTestFiles;
 const node_crypto_1 = require("node:crypto");
 const fs = __importStar(require("node:fs/promises"));
-const node_module_1 = require("node:module");
 const node_path_1 = __importDefault(require("node:path"));
-const tinyglobby_1 = require("tinyglobby");
-const bundler_context_1 = require("../../tools/esbuild/bundler-context");
-const utils_1 = require("../../tools/esbuild/utils");
+const web_1 = require("node:stream/web");
 const virtual_module_plugin_1 = require("../../tools/esbuild/virtual-module-plugin");
-const project_metadata_1 = require("../../utils/project-metadata");
+const test_files_1 = require("../../utils/test-files");
 const index_1 = require("../application/index");
 const results_1 = require("../application/results");
 const schema_1 = require("../application/schema");
-const find_tests_1 = require("./find-tests");
+const assets_middleware_1 = require("./assets-middleware");
+const coverage_1 = require("./coverage");
+const karma_config_1 = require("./karma-config");
 const options_1 = require("./options");
-const localResolve = (0, node_module_1.createRequire)(__filename).resolve;
-const isWindows = process.platform === 'win32';
+const polyfills_plugin_1 = require("./polyfills-plugin");
+const progress_reporter_1 = require("./progress-reporter");
+const utils_1 = require("./utils");
 class ApplicationBuildError extends Error {
     constructor(message) {
         super(message);
         this.name = 'ApplicationBuildError';
     }
 }
-const LATEST_BUILD_FILES_TOKEN = 'angularLatestBuildFiles';
-class AngularAssetsMiddleware {
-    serveFile;
-    latestBuildFiles;
-    static $inject = ['serveFile', LATEST_BUILD_FILES_TOKEN];
-    static NAME = 'angular-test-assets';
-    constructor(serveFile, latestBuildFiles) {
-        this.serveFile = serveFile;
-        this.latestBuildFiles = latestBuildFiles;
-    }
-    handle(req, res, next) {
-        const url = new URL(`http://${req.headers['host']}${req.url}`);
-        // Remove the leading slash from the URL path and convert to platform specific.
-        // The latest build files will use the platform path separator.
-        let pathname = url.pathname.slice(1);
-        if (isWindows) {
-            pathname = pathname.replaceAll(node_path_1.default.posix.sep, node_path_1.default.win32.sep);
-        }
-        const file = this.latestBuildFiles.files[pathname];
-        if (!file) {
-            next();
-            return;
-        }
-        // Implementation of serverFile can be found here:
-        // https://github.com/karma-runner/karma/blob/84f85e7016efc2266fa6b3465f494a3fa151c85c/lib/middleware/common.js#L10
-        switch (file.origin) {
-            case 'disk':
-                this.serveFile(file.inputPath, undefined, res, undefined, undefined, /* doNotCache */ true);
-                break;
-            case 'memory':
-                // Include pathname to help with Content-Type headers.
-                this.serveFile(`/unused/${url.pathname}`, undefined, res, undefined, file.contents, 
-                /* doNotCache */ false);
-                break;
-        }
-    }
-    static createPlugin(initialFiles) {
-        return {
-            [LATEST_BUILD_FILES_TOKEN]: ['value', { files: { ...initialFiles.files } }],
-            [`middleware:${AngularAssetsMiddleware.NAME}`]: [
-                'factory',
-                Object.assign((...args) => {
-                    const inst = new AngularAssetsMiddleware(...args);
-                    return inst.handle.bind(inst);
-                }, AngularAssetsMiddleware),
-            ],
-        };
-    }
-}
-class AngularPolyfillsPlugin {
-    static $inject = ['config.files'];
-    static NAME = 'angular-polyfills';
-    static createPlugin(polyfillsFile, jasmineCleanupFiles, scriptsFiles) {
-        return {
-            // This has to be a "reporter" because reporters run _after_ frameworks
-            // and karma-jasmine-html-reporter injects additional scripts that may
-            // depend on Jasmine but aren't modules - which means that they would run
-            // _before_ all module code (including jasmine).
-            [`reporter:${AngularPolyfillsPlugin.NAME}`]: [
-                'factory',
-                Object.assign((files) => {
-                    // The correct order is zone.js -> jasmine -> zone.js/testing.
-                    // Jasmine has to see the patched version of the global `setTimeout`
-                    // function so it doesn't cache the unpatched version. And /testing
-                    // needs to see the global `jasmine` object so it can patch it.
-                    const polyfillsIndex = 0;
-                    files.splice(polyfillsIndex, 0, polyfillsFile);
-                    // Insert just before test_main.js.
-                    const zoneTestingIndex = files.findIndex((f) => {
-                        if (typeof f === 'string') {
-                            return false;
-                        }
-                        return f.pattern.endsWith('/test_main.js');
-                    });
-                    if (zoneTestingIndex === -1) {
-                        throw new Error('Could not find test entrypoint file.');
-                    }
-                    files.splice(zoneTestingIndex, 0, jasmineCleanupFiles);
-                    // We need to ensure that all files are served as modules, otherwise
-                    // the order in the files list gets really confusing: Karma doesn't
-                    // set defer on scripts, so all scripts with type=js will run first,
-                    // even if type=module files appeared earlier in `files`.
-                    for (const f of files) {
-                        if (typeof f === 'string') {
-                            throw new Error(`Unexpected string-based file: "${f}"`);
-                        }
-                        if (f.included === false) {
-                            // Don't worry about files that aren't included on the initial
-                            // page load. `type` won't affect them.
-                            continue;
-                        }
-                        if (f.pattern.endsWith('.js') && 'js' === (f.type ?? 'js')) {
-                            f.type = 'module';
-                        }
-                    }
-                    // Add "scripts" option files as classic scripts
-                    files.unshift(...scriptsFiles);
-                    // Add browser sourcemap support as a classic script
-                    files.unshift({
-                        pattern: localResolve('source-map-support/browser-source-map-support.js'),
-                        included: true,
-                        watched: false,
-                    });
-                    // Karma needs a return value for a factory and Karma's multi-reporter expects an `adapters` array
-                    return { adapters: [] };
-                }, AngularPolyfillsPlugin),
-            ],
-        };
-    }
-}
-function injectKarmaReporter(buildOptions, buildIterator, karmaConfig, controller) {
-    const reporterName = 'angular-progress-notifier';
-    class ProgressNotifierReporter {
-        emitter;
-        latestBuildFiles;
-        static $inject = ['emitter', LATEST_BUILD_FILES_TOKEN];
-        constructor(emitter, latestBuildFiles) {
-            this.emitter = emitter;
-            this.latestBuildFiles = latestBuildFiles;
-            this.startWatchingBuild();
-        }
-        startWatchingBuild() {
-            void (async () => {
-                // This is effectively "for await of but skip what's already consumed".
-                let isDone = false; // to mark the loop condition as "not constant".
-                while (!isDone) {
-                    const { done, value: buildOutput } = await buildIterator.next();
-                    if (done) {
-                        isDone = true;
-                        break;
-                    }
-                    if (buildOutput.kind === results_1.ResultKind.Failure) {
-                        controller.enqueue({ success: false, message: 'Build failed' });
-                    }
-                    else if (buildOutput.kind === results_1.ResultKind.Incremental ||
-                        buildOutput.kind === results_1.ResultKind.Full) {
-                        if (buildOutput.kind === results_1.ResultKind.Full) {
-                            this.latestBuildFiles.files = buildOutput.files;
-                        }
-                        else {
-                            this.latestBuildFiles.files = {
-                                ...this.latestBuildFiles.files,
-                                ...buildOutput.files,
-                            };
-                        }
-                        await writeTestFiles(buildOutput.files, buildOptions.outputPath);
-                        this.emitter.refreshFiles();
-                    }
-                }
-            })();
-        }
-        onRunComplete = function (_browsers, results) {
-            if (results.exitCode === 0) {
-                controller.enqueue({ success: true });
-            }
-            else {
-                controller.enqueue({ success: false });
-            }
-        };
-    }
-    karmaConfig.reporters ??= [];
-    karmaConfig.reporters.push(reporterName);
-    karmaConfig.plugins ??= [];
-    karmaConfig.plugins.push({
-        [`reporter:${reporterName}`]: [
-            'factory',
-            Object.assign((...args) => new ProgressNotifierReporter(...args), ProgressNotifierReporter),
-        ],
-    });
-}
 function execute(options, context, transforms) {
     const normalizedOptions = (0, options_1.normalizeOptions)(context, options);
-    const karmaOptions = getBaseKarmaOptions(normalizedOptions, context);
+    const karmaOptions = (0, karma_config_1.getBaseKarmaOptions)(normalizedOptions, context);
     let karmaServer;
-    return new ReadableStream({
+    return new web_1.ReadableStream({
         async start(controller) {
             let init;
             try {
@@ -259,7 +88,7 @@ function execute(options, context, transforms) {
             // If `--watch` is explicitly enabled or if we are keeping the Karma
             // process running, we should hook Karma into the build.
             if (buildIterator) {
-                injectKarmaReporter(buildOptions, buildIterator, karmaConfig, controller);
+                (0, progress_reporter_1.injectKarmaReporter)(buildOptions, buildIterator, karmaConfig, controller);
             }
             // Close the stream once the Karma server returns.
             karmaServer = new karma.Server(karmaConfig, (exitCode) => {
@@ -273,43 +102,18 @@ function execute(options, context, transforms) {
         },
     });
 }
-async function getProjectSourceRoot(context) {
-    // We have already validated that the project name is set before calling this function.
-    const projectName = context.target?.project;
-    if (!projectName) {
-        return context.workspaceRoot;
-    }
-    const projectMetadata = await context.getProjectMetadata(projectName);
-    const { projectSourceRoot } = (0, project_metadata_1.getProjectRootPaths)(context.workspaceRoot, projectMetadata);
-    return projectSourceRoot;
-}
-function normalizePolyfills(polyfills = []) {
-    const jasmineGlobalEntryPoint = localResolve('./polyfills/jasmine_global.js');
-    const jasmineGlobalCleanupEntrypoint = localResolve('./polyfills/jasmine_global_cleanup.js');
-    const sourcemapEntrypoint = localResolve('./polyfills/init_sourcemaps.js');
-    const zoneTestingEntryPoint = 'zone.js/testing';
-    const polyfillsExludingZoneTesting = polyfills.filter((p) => p !== zoneTestingEntryPoint);
-    return [
-        polyfillsExludingZoneTesting.concat([jasmineGlobalEntryPoint, sourcemapEntrypoint]),
-        polyfillsExludingZoneTesting.length === polyfills.length
-            ? [jasmineGlobalCleanupEntrypoint]
-            : [jasmineGlobalCleanupEntrypoint, zoneTestingEntryPoint],
-    ];
-}
-async function collectEntrypoints(options, context, projectSourceRoot) {
-    // Glob for files to test.
-    const testFiles = await (0, find_tests_1.findTests)(options.include, options.exclude, context.workspaceRoot, projectSourceRoot);
-    return (0, find_tests_1.getTestEntrypoints)(testFiles, { projectSourceRoot, workspaceRoot: context.workspaceRoot });
-}
-// eslint-disable-next-line max-lines-per-function
 async function initializeApplication(options, context, karmaOptions, transforms) {
+    const karma = await Promise.resolve().then(() => __importStar(require('karma')));
+    const projectSourceRoot = await (0, utils_1.getProjectSourceRoot)(context);
     const outputPath = node_path_1.default.join(context.workspaceRoot, 'dist/test-out', (0, node_crypto_1.randomUUID)());
-    const projectSourceRoot = await getProjectSourceRoot(context);
-    const [karma, entryPoints] = await Promise.all([
-        Promise.resolve().then(() => __importStar(require('karma'))),
-        collectEntrypoints(options, context, projectSourceRoot),
-        fs.rm(outputPath, { recursive: true, force: true }),
-    ]);
+    await fs.rm(outputPath, { recursive: true, force: true });
+    const { buildOptions, mainName } = await setupBuildOptions(options, context, projectSourceRoot, outputPath);
+    const [buildOutput, buildIterator] = await runEsbuild(buildOptions, context, projectSourceRoot);
+    const karmaConfig = await configureKarma(karma, context, karmaOptions, options, buildOptions, buildOutput, mainName, transforms);
+    return [karma, karmaConfig, buildOptions, buildIterator];
+}
+async function setupBuildOptions(options, context, projectSourceRoot, outputPath) {
+    const entryPoints = await (0, utils_1.collectEntrypoints)(options, context, projectSourceRoot);
     const mainName = 'test_main';
     if (options.main) {
         entryPoints.set(mainName, options.main);
@@ -318,9 +122,9 @@ async function initializeApplication(options, context, karmaOptions, transforms)
         entryPoints.set(mainName, 'angular:test-bed-init');
     }
     const instrumentForCoverage = options.codeCoverage
-        ? createInstrumentationFilter(projectSourceRoot, getInstrumentationExcludedPaths(context.workspaceRoot, options.codeCoverageExclude ?? []))
+        ? (0, coverage_1.createInstrumentationFilter)(projectSourceRoot, (0, coverage_1.getInstrumentationExcludedPaths)(context.workspaceRoot, options.codeCoverageExclude ?? []))
         : undefined;
-    const [polyfills, jasmineCleanup] = normalizePolyfills(options.polyfills);
+    const [polyfills, jasmineCleanup] = (0, utils_1.normalizePolyfills)(options.polyfills);
     for (let idx = 0; idx < jasmineCleanup.length; ++idx) {
         entryPoints.set(`jasmine-cleanup-${idx}`, jasmineCleanup[idx]);
     }
@@ -348,6 +152,9 @@ async function initializeApplication(options, context, karmaOptions, transforms)
         loader: options.loader,
         externalDependencies: options.externalDependencies,
     };
+    return { buildOptions, mainName };
+}
+async function runEsbuild(buildOptions, context, projectSourceRoot) {
     const virtualTestBedInit = (0, virtual_module_plugin_1.createVirtualModulePlugin)({
         namespace: 'angular:test-bed-init',
         loadContent: async () => {
@@ -358,7 +165,7 @@ async function initializeApplication(options, context, karmaOptions, transforms)
                 `getTestBed().initTestEnvironment(BrowserTestingModule, platformBrowserTesting(), {`,
                 `  errorOnUnknownElements: true,`,
                 `  errorOnUnknownProperties: true,`,
-                '});',
+                `});`,
             ];
             return {
                 contents: contents.join('\n'),
@@ -368,7 +175,7 @@ async function initializeApplication(options, context, karmaOptions, transforms)
         },
     });
     // Build tests with `application` builder, using test files as entry points.
-    const [buildOutput, buildIterator] = await first((0, index_1.buildApplicationInternal)(buildOptions, context, { codePlugins: [virtualTestBedInit] }), { cancel: !buildOptions.watch });
+    const [buildOutput, buildIterator] = await (0, utils_1.first)((0, index_1.buildApplicationInternal)(buildOptions, context, { codePlugins: [virtualTestBedInit] }), { cancel: !buildOptions.watch });
     if (buildOutput.kind === results_1.ResultKind.Failure) {
         throw new ApplicationBuildError('Build failed');
     }
@@ -376,7 +183,11 @@ async function initializeApplication(options, context, karmaOptions, transforms)
         throw new ApplicationBuildError('A full build result is required from the application builder.');
     }
     // Write test files
-    await writeTestFiles(buildOutput.files, buildOptions.outputPath);
+    await (0, test_files_1.writeTestFiles)(buildOutput.files, buildOptions.outputPath);
+    return [buildOutput, buildIterator];
+}
+async function configureKarma(karma, context, karmaOptions, options, buildOptions, buildOutput, mainName, transforms) {
+    const outputPath = buildOptions.outputPath;
     // We need to add this to the beginning *after* the testing framework has
     // prepended its files. The output path is required for each since they are
     // added later in the test process via a plugin.
@@ -422,7 +233,7 @@ async function initializeApplication(options, context, karmaOptions, transforms)
     { pattern: `*.map`, included: false, watched: false }, 
     // These are the test entrypoints.
     { pattern: `spec-*.js`, type: 'module', watched: false });
-    if (hasChunkOrWorkerFiles(buildOutput.files)) {
+    if ((0, utils_1.hasChunkOrWorkerFiles)(buildOutput.files)) {
         karmaOptions.files.push(
         // Allow loading of chunk-* files but don't include them all on load.
         {
@@ -462,12 +273,12 @@ async function initializeApplication(options, context, karmaOptions, transforms)
     if (pluginLengthBefore !== pluginLengthAfter) {
         context.logger.warn(`Ignoring framework "@angular-devkit/build-angular" from karma config file because it's not compatible with the application builder.`);
     }
-    parsedKarmaConfig.plugins.push(AngularAssetsMiddleware.createPlugin(buildOutput));
+    parsedKarmaConfig.plugins.push(assets_middleware_1.AngularAssetsMiddleware.createPlugin(buildOutput));
     parsedKarmaConfig.middleware ??= [];
-    parsedKarmaConfig.middleware.push(AngularAssetsMiddleware.NAME);
-    parsedKarmaConfig.plugins.push(AngularPolyfillsPlugin.createPlugin(polyfillsFile, jasmineCleanupFiles, scriptsFiles));
+    parsedKarmaConfig.middleware.push(assets_middleware_1.AngularAssetsMiddleware.NAME);
+    parsedKarmaConfig.plugins.push(polyfills_plugin_1.AngularPolyfillsPlugin.createPlugin(polyfillsFile, jasmineCleanupFiles, scriptsFiles));
     parsedKarmaConfig.reporters ??= [];
-    parsedKarmaConfig.reporters.push(AngularPolyfillsPlugin.NAME);
+    parsedKarmaConfig.reporters.push(polyfills_plugin_1.AngularPolyfillsPlugin.NAME);
     // Adjust karma junit reporter outDir location to maintain previous (devkit) behavior
     // The base path for the reporter was previously the workspace root.
     // To keep the files in the same location, the reporter's output directory is adjusted
@@ -497,128 +308,5 @@ async function initializeApplication(options, context, karmaOptions, transforms)
         !parsedKarmaConfig.reporters?.some((r) => r === 'coverage' || r === 'coverage-istanbul')) {
         parsedKarmaConfig.reporters = (parsedKarmaConfig.reporters ?? []).concat(['coverage']);
     }
-    return [karma, parsedKarmaConfig, buildOptions, buildIterator];
-}
-function hasChunkOrWorkerFiles(files) {
-    return Object.keys(files).some((filename) => {
-        return /(?:^|\/)(?:worker|chunk)[^/]+\.js$/.test(filename);
-    });
-}
-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);
-        }
-    });
-}
-/** Returns the first item yielded by the given generator and cancels the execution. */
-async function first(generator, { cancel }) {
-    if (!cancel) {
-        const iterator = generator[Symbol.asyncIterator]();
-        const firstValue = await iterator.next();
-        if (firstValue.done) {
-            throw new Error('Expected generator to emit at least once.');
-        }
-        return [firstValue.value, iterator];
-    }
-    for await (const value of generator) {
-        return [value, null];
-    }
-    throw new Error('Expected generator to emit at least once.');
-}
-function createInstrumentationFilter(includedBasePath, excludedPaths) {
-    return (request) => {
-        return (!excludedPaths.has(request) &&
-            !/\.(e2e|spec)\.tsx?$|[\\/]node_modules[\\/]/.test(request) &&
-            request.startsWith(includedBasePath));
-    };
-}
-function getInstrumentationExcludedPaths(root, excludedPaths) {
-    const excluded = new Set();
-    for (const excludeGlob of excludedPaths) {
-        const excludePath = excludeGlob[0] === '/' ? excludeGlob.slice(1) : excludeGlob;
-        (0, tinyglobby_1.globSync)(excludePath, { cwd: root }).forEach((p) => excluded.add(node_path_1.default.join(root, p)));
-    }
-    return excluded;
-}
-function getBaseKarmaOptions(options, context) {
-    // Determine project name from builder context target
-    const projectName = context.target?.project;
-    if (!projectName) {
-        throw new Error(`The 'karma' builder requires a target to be specified.`);
-    }
-    const karmaOptions = options.karmaConfig
-        ? {}
-        : getBuiltInKarmaConfig(context.workspaceRoot, projectName);
-    const singleRun = !options.watch;
-    karmaOptions.singleRun = singleRun;
-    // Workaround https://github.com/angular/angular-cli/issues/28271, by clearing context by default
-    // for single run executions. Not clearing context for multi-run (watched) builds allows the
-    // Jasmine Spec Runner to be visible in the browser after test execution.
-    karmaOptions.client ??= {};
-    karmaOptions.client.clearContext ??= singleRun;
-    // Convert browsers from a string to an array
-    if (options.browsers) {
-        karmaOptions.browsers = options.browsers;
-    }
-    if (options.reporters) {
-        karmaOptions.reporters = options.reporters;
-    }
-    return karmaOptions;
-}
-function getBuiltInKarmaConfig(workspaceRoot, projectName) {
-    let coverageFolderName = projectName.charAt(0) === '@' ? projectName.slice(1) : projectName;
-    coverageFolderName = coverageFolderName.toLowerCase();
-    const workspaceRootRequire = (0, node_module_1.createRequire)(workspaceRoot + '/');
-    // Any changes to the config here need to be synced to: packages/schematics/angular/config/files/karma.conf.js.template
-    return {
-        basePath: '',
-        frameworks: ['jasmine'],
-        plugins: [
-            'karma-jasmine',
-            'karma-chrome-launcher',
-            'karma-jasmine-html-reporter',
-            'karma-coverage',
-        ].map((p) => workspaceRootRequire(p)),
-        jasmineHtmlReporter: {
-            suppressAll: true, // removes the duplicated traces
-        },
-        coverageReporter: {
-            dir: node_path_1.default.join(workspaceRoot, 'coverage', coverageFolderName),
-            subdir: '.',
-            reporters: [{ type: 'html' }, { type: 'text-summary' }],
-        },
-        reporters: ['progress', 'kjhtml'],
-        browsers: ['Chrome'],
-        customLaunchers: {
-            // Chrome configured to run in a bazel sandbox.
-            // Disable the use of the gpu and `/dev/shm` because it causes Chrome to
-            // crash on some environments.
-            // See:
-            //   https://github.com/puppeteer/puppeteer/blob/v1.0.0/docs/troubleshooting.md#tips
-            //   https://stackoverflow.com/questions/50642308/webdriverexception-unknown-error-devtoolsactiveport-file-doesnt-exist-while-t
-            ChromeHeadlessNoSandbox: {
-                base: 'ChromeHeadless',
-                flags: ['--no-sandbox', '--headless', '--disable-gpu', '--disable-dev-shm-usage'],
-            },
-        },
-        restartOnFileChange: true,
-    };
+    return parsedKarmaConfig;
 }

package/src/builders/karma/assets-middleware.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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 type { InlinePluginDef } from 'karma';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ResultFile } from '../application/results';
+interface ServeFileFunction {
+    (filepath: string, rangeHeader: string | string[] | undefined, response: ServerResponse, transform?: (c: string | Uint8Array) => string | Uint8Array, content?: string | Uint8Array, doNotCache?: boolean): void;
+}
+export interface LatestBuildFiles {
+    files: Record<string, ResultFile | undefined>;
+}
+export declare class AngularAssetsMiddleware {
+    private readonly serveFile;
+    private readonly latestBuildFiles;
+    static readonly $inject: string[];
+    static readonly NAME = "angular-test-assets";
+    constructor(serveFile: ServeFileFunction, latestBuildFiles: LatestBuildFiles);
+    handle(req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => unknown): void;
+    static createPlugin(initialFiles: LatestBuildFiles): InlinePluginDef;
+}
+export {};

package/src/builders/karma/assets-middleware.js

@@ -0,0 +1,65 @@
+"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.AngularAssetsMiddleware = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const isWindows = process.platform === 'win32';
+const LATEST_BUILD_FILES_TOKEN = 'angularLatestBuildFiles';
+class AngularAssetsMiddleware {
+    serveFile;
+    latestBuildFiles;
+    static $inject = ['serveFile', LATEST_BUILD_FILES_TOKEN];
+    static NAME = 'angular-test-assets';
+    constructor(serveFile, latestBuildFiles) {
+        this.serveFile = serveFile;
+        this.latestBuildFiles = latestBuildFiles;
+    }
+    handle(req, res, next) {
+        const url = new URL(`http://${req.headers['host'] ?? ''}${req.url ?? ''}`);
+        // Remove the leading slash from the URL path and convert to platform specific.
+        // The latest build files will use the platform path separator.
+        let pathname = url.pathname.slice(1);
+        if (isWindows) {
+            pathname = pathname.replaceAll(node_path_1.default.posix.sep, node_path_1.default.win32.sep);
+        }
+        const file = this.latestBuildFiles.files[pathname];
+        if (!file) {
+            next();
+            return;
+        }
+        // Implementation of serverFile can be found here:
+        // https://github.com/karma-runner/karma/blob/84f85e7016efc2266fa6b3465f494a3fa151c85c/lib/middleware/common.js#L10
+        switch (file.origin) {
+            case 'disk':
+                this.serveFile(file.inputPath, undefined, res, undefined, undefined, /* doNotCache */ true);
+                break;
+            case 'memory':
+                // Include pathname to help with Content-Type headers.
+                this.serveFile(`/unused/${url.pathname}`, undefined, res, undefined, file.contents, 
+                /* doNotCache */ false);
+                break;
+        }
+    }
+    static createPlugin(initialFiles) {
+        return {
+            [LATEST_BUILD_FILES_TOKEN]: ['value', { files: { ...initialFiles.files } }],
+            [`middleware:${AngularAssetsMiddleware.NAME}`]: [
+                'factory',
+                Object.assign((...args) => {
+                    const inst = new AngularAssetsMiddleware(...args);
+                    return inst.handle.bind(inst);
+                }, AngularAssetsMiddleware),
+            ],
+        };
+    }
+}
+exports.AngularAssetsMiddleware = AngularAssetsMiddleware;

package/src/builders/karma/coverage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @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
+ */
+export declare function createInstrumentationFilter(includedBasePath: string, excludedPaths: Set<string>): (request: string) => boolean;
+export declare function getInstrumentationExcludedPaths(root: string, excludedPaths: string[]): Set<string>;