@angular-devkit/build-angular 19.0.0-next.0 → 19.0.0-next.10

package/src/builders/karma/browser_builder.js

@@ -0,0 +1,137 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = execute;
+const private_1 = require("@angular/build/private");
+const path = __importStar(require("path"));
+const rxjs_1 = require("rxjs");
+const configs_1 = require("../../tools/webpack/configs");
+const webpack_browser_config_1 = require("../../utils/webpack-browser-config");
+const schema_1 = require("../browser/schema");
+const find_tests_plugin_1 = require("./find-tests-plugin");
+function execute(options, context, karmaOptions, transforms = {}) {
+    return (0, rxjs_1.from)(initializeBrowser(options, context)).pipe((0, rxjs_1.switchMap)(async ([karma, webpackConfig]) => {
+        const projectName = context.target?.project;
+        if (!projectName) {
+            throw new Error(`The 'karma' builder requires a target to be specified.`);
+        }
+        const projectMetadata = await context.getProjectMetadata(projectName);
+        const sourceRoot = (projectMetadata.sourceRoot ?? projectMetadata.root ?? '');
+        if (!options.main) {
+            webpackConfig.entry ??= {};
+            if (typeof webpackConfig.entry === 'object' && !Array.isArray(webpackConfig.entry)) {
+                if (Array.isArray(webpackConfig.entry['main'])) {
+                    webpackConfig.entry['main'].push(getBuiltInMainFile());
+                }
+                else {
+                    webpackConfig.entry['main'] = [getBuiltInMainFile()];
+                }
+            }
+        }
+        webpackConfig.plugins ??= [];
+        webpackConfig.plugins.push(new find_tests_plugin_1.FindTestsPlugin({
+            include: options.include,
+            exclude: options.exclude,
+            workspaceRoot: context.workspaceRoot,
+            projectSourceRoot: path.join(context.workspaceRoot, sourceRoot),
+        }));
+        karmaOptions.buildWebpack = {
+            options,
+            webpackConfig,
+            logger: context.logger,
+        };
+        const parsedKarmaConfig = await karma.config.parseConfig(options.karmaConfig && path.resolve(context.workspaceRoot, options.karmaConfig), transforms.karmaOptions ? transforms.karmaOptions(karmaOptions) : karmaOptions, { promiseConfig: true, throwErrors: true });
+        return [karma, parsedKarmaConfig];
+    }), (0, rxjs_1.switchMap)(([karma, karmaConfig]) => new rxjs_1.Observable((subscriber) => {
+        // Pass onto Karma to emit BuildEvents.
+        karmaConfig.buildWebpack ??= {};
+        if (typeof karmaConfig.buildWebpack === 'object') {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            karmaConfig.buildWebpack.failureCb ??= () => subscriber.next({ success: false });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            karmaConfig.buildWebpack.successCb ??= () => subscriber.next({ success: true });
+        }
+        // Complete the observable once the Karma server returns.
+        const karmaServer = new karma.Server(karmaConfig, (exitCode) => {
+            subscriber.next({ success: exitCode === 0 });
+            subscriber.complete();
+        });
+        const karmaStart = karmaServer.start();
+        // Cleanup, signal Karma to exit.
+        return () => {
+            void karmaStart.then(() => karmaServer.stop());
+        };
+    })), (0, rxjs_1.defaultIfEmpty)({ success: false }));
+}
+async function initializeBrowser(options, context, webpackConfigurationTransformer) {
+    // Purge old build disk cache.
+    await (0, private_1.purgeStaleBuildCache)(context);
+    const karma = await Promise.resolve().then(() => __importStar(require('karma')));
+    const { config } = await (0, webpack_browser_config_1.generateBrowserWebpackConfigFromContext)(
+    // only two properties are missing:
+    // * `outputPath` which is fixed for tests
+    // * `budgets` which might be incorrect due to extra dev libs
+    {
+        ...options,
+        outputPath: '',
+        budgets: undefined,
+        optimization: false,
+        buildOptimizer: false,
+        aot: false,
+        vendorChunk: true,
+        namedChunks: true,
+        extractLicenses: false,
+        outputHashing: schema_1.OutputHashing.None,
+        // The webpack tier owns the watch behavior so we want to force it in the config.
+        // When not in watch mode, webpack-dev-middleware will call `compiler.watch` anyway.
+        // https://github.com/webpack/webpack-dev-middleware/blob/698c9ae5e9bb9a013985add6189ff21c1a1ec185/src/index.js#L65
+        // https://github.com/webpack/webpack/blob/cde1b73e12eb8a77eb9ba42e7920c9ec5d29c2c9/lib/Compiler.js#L379-L388
+        watch: true,
+    }, context, (wco) => [(0, configs_1.getCommonConfig)(wco), (0, configs_1.getStylesConfig)(wco)]);
+    return [karma, (await webpackConfigurationTransformer?.(config)) ?? config];
+}
+function getBuiltInMainFile() {
+    const content = Buffer.from(`
+  import { getTestBed } from '@angular/core/testing';
+  import {
+    BrowserDynamicTestingModule,
+    platformBrowserDynamicTesting,
+   } from '@angular/platform-browser-dynamic/testing';
+
+  // Initialize the Angular testing environment.
+  getTestBed().initTestEnvironment(BrowserDynamicTestingModule, platformBrowserDynamicTesting(), {
+    errorOnUnknownElements: true,
+    errorOnUnknownProperties: true
+  });
+`).toString('base64');
+    return `ng-virtual-main.js!=!data:text/javascript;base64,${content}`;
+}

package/src/builders/karma/find-tests-plugin.js

@@ -6,39 +6,14 @@
  * 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 (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __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.FindTestsPlugin = void 0;
 const assert_1 = __importDefault(require("assert"));
-const fast_glob_1 = __importStar(require("fast-glob"));
-const fs_1 = require("fs");
 const mini_css_extract_plugin_1 = require("mini-css-extract-plugin");
-const path_1 = require("path");
+const find_tests_1 = require("./find-tests");
 /**
  * The name of the plugin provided to Webpack when tapping Webpack compiler hooks.
  */
@@ -56,7 +31,7 @@ class FindTestsPlugin {
         let originalImport;
         // Add tests files are part of the entry-point.
         webpackOptions.entry = async () => {
-            const specFiles = await findTests(include, exclude, workspaceRoot, projectSourceRoot);
+            const specFiles = await (0, find_tests_1.findTests)(include, exclude, workspaceRoot, projectSourceRoot);
             const entrypoints = await entry;
             const entrypoint = entrypoints['main'];
             if (!entrypoint.import) {
@@ -81,72 +56,3 @@ class FindTestsPlugin {
     }
 }
 exports.FindTestsPlugin = FindTestsPlugin;
-// go through all patterns and find unique list of files
-async function findTests(include, exclude, workspaceRoot, projectSourceRoot) {
-    const matchingTestsPromises = include.map((pattern) => findMatchingTests(pattern, exclude, workspaceRoot, projectSourceRoot));
-    const files = await Promise.all(matchingTestsPromises);
-    // Unique file names
-    return [...new Set(files.flat())];
-}
-const normalizePath = (path) => path.replace(/\\/g, '/');
-const removeLeadingSlash = (pattern) => {
-    if (pattern.charAt(0) === '/') {
-        return pattern.substring(1);
-    }
-    return pattern;
-};
-const removeRelativeRoot = (path, root) => {
-    if (path.startsWith(root)) {
-        return path.substring(root.length);
-    }
-    return path;
-};
-async function findMatchingTests(pattern, ignore, workspaceRoot, projectSourceRoot) {
-    // normalize pattern, glob lib only accepts forward slashes
-    let normalizedPattern = normalizePath(pattern);
-    normalizedPattern = removeLeadingSlash(normalizedPattern);
-    const relativeProjectRoot = normalizePath((0, path_1.relative)(workspaceRoot, projectSourceRoot) + '/');
-    // remove relativeProjectRoot to support relative paths from root
-    // such paths are easy to get when running scripts via IDEs
-    normalizedPattern = removeRelativeRoot(normalizedPattern, relativeProjectRoot);
-    // special logic when pattern does not look like a glob
-    if (!(0, fast_glob_1.isDynamicPattern)(normalizedPattern)) {
-        if (await isDirectory((0, path_1.join)(projectSourceRoot, normalizedPattern))) {
-            normalizedPattern = `${normalizedPattern}/**/*.spec.@(ts|tsx)`;
-        }
-        else {
-            // see if matching spec file exists
-            const fileExt = (0, path_1.extname)(normalizedPattern);
-            // Replace extension to `.spec.ext`. Example: `src/app/app.component.ts`-> `src/app/app.component.spec.ts`
-            const potentialSpec = (0, path_1.join)(projectSourceRoot, (0, path_1.dirname)(normalizedPattern), `${(0, path_1.basename)(normalizedPattern, fileExt)}.spec${fileExt}`);
-            if (await exists(potentialSpec)) {
-                return [potentialSpec];
-            }
-        }
-    }
-    // normalize the patterns in the ignore list
-    const normalizedIgnorePatternList = ignore.map((pattern) => removeRelativeRoot(removeLeadingSlash(normalizePath(pattern)), relativeProjectRoot));
-    return (0, fast_glob_1.default)(normalizedPattern, {
-        cwd: projectSourceRoot,
-        absolute: true,
-        ignore: ['**/node_modules/**', ...normalizedIgnorePatternList],
-    });
-}
-async function isDirectory(path) {
-    try {
-        const stats = await fs_1.promises.stat(path);
-        return stats.isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-async function exists(path) {
-    try {
-        await fs_1.promises.access(path, fs_1.constants.F_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}

package/src/builders/karma/find-tests.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @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 findTests(include: string[], exclude: string[], workspaceRoot: string, projectSourceRoot: string): Promise<string[]>;

package/src/builders/karma/find-tests.js

@@ -0,0 +1,105 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findTests = findTests;
+const fast_glob_1 = __importStar(require("fast-glob"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+/* Go through all patterns and find unique list of files */
+async function findTests(include, exclude, workspaceRoot, projectSourceRoot) {
+    const matchingTestsPromises = include.map((pattern) => findMatchingTests(pattern, exclude, workspaceRoot, projectSourceRoot));
+    const files = await Promise.all(matchingTestsPromises);
+    // Unique file names
+    return [...new Set(files.flat())];
+}
+const normalizePath = (path) => path.replace(/\\/g, '/');
+const removeLeadingSlash = (pattern) => {
+    if (pattern.charAt(0) === '/') {
+        return pattern.substring(1);
+    }
+    return pattern;
+};
+const removeRelativeRoot = (path, root) => {
+    if (path.startsWith(root)) {
+        return path.substring(root.length);
+    }
+    return path;
+};
+async function findMatchingTests(pattern, ignore, workspaceRoot, projectSourceRoot) {
+    // normalize pattern, glob lib only accepts forward slashes
+    let normalizedPattern = normalizePath(pattern);
+    normalizedPattern = removeLeadingSlash(normalizedPattern);
+    const relativeProjectRoot = normalizePath((0, path_1.relative)(workspaceRoot, projectSourceRoot) + '/');
+    // remove relativeProjectRoot to support relative paths from root
+    // such paths are easy to get when running scripts via IDEs
+    normalizedPattern = removeRelativeRoot(normalizedPattern, relativeProjectRoot);
+    // special logic when pattern does not look like a glob
+    if (!(0, fast_glob_1.isDynamicPattern)(normalizedPattern)) {
+        if (await isDirectory((0, path_1.join)(projectSourceRoot, normalizedPattern))) {
+            normalizedPattern = `${normalizedPattern}/**/*.spec.@(ts|tsx)`;
+        }
+        else {
+            // see if matching spec file exists
+            const fileExt = (0, path_1.extname)(normalizedPattern);
+            // Replace extension to `.spec.ext`. Example: `src/app/app.component.ts`-> `src/app/app.component.spec.ts`
+            const potentialSpec = (0, path_1.join)(projectSourceRoot, (0, path_1.dirname)(normalizedPattern), `${(0, path_1.basename)(normalizedPattern, fileExt)}.spec${fileExt}`);
+            if (await exists(potentialSpec)) {
+                return [potentialSpec];
+            }
+        }
+    }
+    // normalize the patterns in the ignore list
+    const normalizedIgnorePatternList = ignore.map((pattern) => removeRelativeRoot(removeLeadingSlash(normalizePath(pattern)), relativeProjectRoot));
+    return (0, fast_glob_1.default)(normalizedPattern, {
+        cwd: projectSourceRoot,
+        absolute: true,
+        ignore: ['**/node_modules/**', ...normalizedIgnorePatternList],
+    });
+}
+async function isDirectory(path) {
+    try {
+        const stats = await fs_1.promises.stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function exists(path) {
+    try {
+        await fs_1.promises.access(path, fs_1.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/src/builders/karma/index.js

@@ -37,122 +37,56 @@ const core_1 = require("@angular-devkit/core");
 const module_1 = require("module");
 const path = __importStar(require("path"));
 const rxjs_1 = require("rxjs");
-const configs_1 = require("../../tools/webpack/configs");
-const webpack_browser_config_1 = require("../../utils/webpack-browser-config");
-const schema_1 = require("../browser/schema");
-const find_tests_plugin_1 = require("./find-tests-plugin");
-async function initialize(options, context, webpackConfigurationTransformer) {
-    // Purge old build disk cache.
-    await (0, private_1.purgeStaleBuildCache)(context);
-    const { config } = await (0, webpack_browser_config_1.generateBrowserWebpackConfigFromContext)(
-    // only two properties are missing:
-    // * `outputPath` which is fixed for tests
-    // * `budgets` which might be incorrect due to extra dev libs
-    {
-        ...options,
-        outputPath: '',
-        budgets: undefined,
-        optimization: false,
-        buildOptimizer: false,
-        aot: false,
-        vendorChunk: true,
-        namedChunks: true,
-        extractLicenses: false,
-        outputHashing: schema_1.OutputHashing.None,
-        // The webpack tier owns the watch behavior so we want to force it in the config.
-        // When not in watch mode, webpack-dev-middleware will call `compiler.watch` anyway.
-        // https://github.com/webpack/webpack-dev-middleware/blob/698c9ae5e9bb9a013985add6189ff21c1a1ec185/src/index.js#L65
-        // https://github.com/webpack/webpack/blob/cde1b73e12eb8a77eb9ba42e7920c9ec5d29c2c9/lib/Compiler.js#L379-L388
-        watch: true,
-    }, context, (wco) => [(0, configs_1.getCommonConfig)(wco), (0, configs_1.getStylesConfig)(wco)]);
-    const karma = await Promise.resolve().then(() => __importStar(require('karma')));
-    return [karma, (await webpackConfigurationTransformer?.(config)) ?? config];
-}
+const schema_1 = require("./schema");
 /**
  * @experimental Direct usage of this function is considered experimental.
  */
 function execute(options, context, transforms = {}) {
     // Check Angular version.
     (0, private_1.assertCompatibleAngularVersion)(context.workspaceRoot);
+    return (0, rxjs_1.from)(getExecuteWithBuilder(options, context)).pipe((0, rxjs_1.mergeMap)(([useEsbuild, executeWithBuilder]) => {
+        const karmaOptions = getBaseKarmaOptions(options, context, useEsbuild);
+        return executeWithBuilder.execute(options, context, karmaOptions, transforms);
+    }));
+}
+function getBaseKarmaOptions(options, context, useEsbuild) {
     let singleRun;
     if (options.watch !== undefined) {
         singleRun = !options.watch;
     }
-    return (0, rxjs_1.from)(initialize(options, context, transforms.webpackConfiguration)).pipe((0, rxjs_1.switchMap)(async ([karma, webpackConfig]) => {
-        // 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);
-        karmaOptions.singleRun = singleRun;
-        // Convert browsers from a string to an array
-        if (typeof options.browsers === 'string' && options.browsers) {
-            karmaOptions.browsers = options.browsers.split(',');
-        }
-        else if (options.browsers === false) {
-            karmaOptions.browsers = [];
-        }
-        if (options.reporters) {
-            // Split along commas to make it more natural, and remove empty strings.
-            const reporters = options.reporters
-                .reduce((acc, curr) => acc.concat(curr.split(',')), [])
-                .filter((x) => !!x);
-            if (reporters.length > 0) {
-                karmaOptions.reporters = reporters;
-            }
-        }
-        if (!options.main) {
-            webpackConfig.entry ??= {};
-            if (typeof webpackConfig.entry === 'object' && !Array.isArray(webpackConfig.entry)) {
-                if (Array.isArray(webpackConfig.entry['main'])) {
-                    webpackConfig.entry['main'].push(getBuiltInMainFile());
-                }
-                else {
-                    webpackConfig.entry['main'] = [getBuiltInMainFile()];
-                }
-            }
-        }
-        const projectMetadata = await context.getProjectMetadata(projectName);
-        const sourceRoot = (projectMetadata.sourceRoot ?? projectMetadata.root ?? '');
-        webpackConfig.plugins ??= [];
-        webpackConfig.plugins.push(new find_tests_plugin_1.FindTestsPlugin({
-            include: options.include,
-            exclude: options.exclude,
-            workspaceRoot: context.workspaceRoot,
-            projectSourceRoot: path.join(context.workspaceRoot, sourceRoot),
-        }));
-        karmaOptions.buildWebpack = {
-            options,
-            webpackConfig,
-            logger: context.logger,
-        };
-        const parsedKarmaConfig = await karma.config.parseConfig(options.karmaConfig && path.resolve(context.workspaceRoot, options.karmaConfig), transforms.karmaOptions ? transforms.karmaOptions(karmaOptions) : karmaOptions, { promiseConfig: true, throwErrors: true });
-        return [karma, parsedKarmaConfig];
-    }), (0, rxjs_1.switchMap)(([karma, karmaConfig]) => new rxjs_1.Observable((subscriber) => {
-        // Pass onto Karma to emit BuildEvents.
-        karmaConfig.buildWebpack ??= {};
-        if (typeof karmaConfig.buildWebpack === 'object') {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            karmaConfig.buildWebpack.failureCb ??= () => subscriber.next({ success: false });
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            karmaConfig.buildWebpack.successCb ??= () => subscriber.next({ success: true });
+    // 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, useEsbuild);
+    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 ?? false; // `singleRun` defaults to `false` per Karma docs.
+    // Convert browsers from a string to an array
+    if (typeof options.browsers === 'string' && options.browsers) {
+        karmaOptions.browsers = options.browsers.split(',');
+    }
+    else if (options.browsers === false) {
+        karmaOptions.browsers = [];
+    }
+    if (options.reporters) {
+        // Split along commas to make it more natural, and remove empty strings.
+        const reporters = options.reporters
+            .reduce((acc, curr) => acc.concat(curr.split(',')), [])
+            .filter((x) => !!x);
+        if (reporters.length > 0) {
+            karmaOptions.reporters = reporters;
         }
-        // Complete the observable once the Karma server returns.
-        const karmaServer = new karma.Server(karmaConfig, (exitCode) => {
-            subscriber.next({ success: exitCode === 0 });
-            subscriber.complete();
-        });
-        const karmaStart = karmaServer.start();
-        // Cleanup, signal Karma to exit.
-        return () => {
-            void karmaStart.then(() => karmaServer.stop());
-        };
-    })), (0, rxjs_1.defaultIfEmpty)({ success: false }));
+    }
+    return karmaOptions;
 }
-function getBuiltInKarmaConfig(workspaceRoot, projectName) {
+function getBuiltInKarmaConfig(workspaceRoot, projectName, useEsbuild) {
     let coverageFolderName = projectName.charAt(0) === '@' ? projectName.slice(1) : projectName;
     if (/[A-Z]/.test(coverageFolderName)) {
         coverageFolderName = core_1.strings.dasherize(coverageFolderName);
@@ -161,17 +95,14 @@ function getBuiltInKarmaConfig(workspaceRoot, projectName) {
     // Any changes to the config here need to be synced to: packages/schematics/angular/config/files/karma.conf.js.template
     return {
         basePath: '',
-        frameworks: ['jasmine', '@angular-devkit/build-angular'],
+        frameworks: ['jasmine', ...(useEsbuild ? [] : ['@angular-devkit/build-angular'])],
         plugins: [
             'karma-jasmine',
             'karma-chrome-launcher',
             'karma-jasmine-html-reporter',
             'karma-coverage',
-            '@angular-devkit/build-angular/plugins/karma',
+            ...(useEsbuild ? [] : ['@angular-devkit/build-angular/plugins/karma']),
         ].map((p) => workspaceRootRequire(p)),
-        client: {
-            clearContext: false, // leave Jasmine Spec Runner output visible in browser
-        },
         jasmineHtmlReporter: {
             suppressAll: true, // removes the duplicated traces
         },
@@ -198,19 +129,36 @@ function getBuiltInKarmaConfig(workspaceRoot, projectName) {
     };
 }
 exports.default = (0, architect_1.createBuilder)(execute);
-function getBuiltInMainFile() {
-    const content = Buffer.from(`
-  import { getTestBed } from '@angular/core/testing';
-  import {
-    BrowserDynamicTestingModule,
-    platformBrowserDynamicTesting,
-   } from '@angular/platform-browser-dynamic/testing';
-
-  // Initialize the Angular testing environment.
-  getTestBed().initTestEnvironment(BrowserDynamicTestingModule, platformBrowserDynamicTesting(), {
-    errorOnUnknownElements: true,
-    errorOnUnknownProperties: true
-  });
-`).toString('base64');
-    return `ng-virtual-main.js!=!data:text/javascript;base64,${content}`;
+async function getExecuteWithBuilder(options, context) {
+    const useEsbuild = await checkForEsbuild(options, context);
+    const executeWithBuilderModule = useEsbuild
+        ? Promise.resolve().then(() => __importStar(require('./application_builder'))) : Promise.resolve().then(() => __importStar(require('./browser_builder')));
+    return [useEsbuild, await executeWithBuilderModule];
+}
+async function checkForEsbuild(options, context) {
+    if (options.builderMode !== schema_1.BuilderMode.Detect) {
+        return options.builderMode === schema_1.BuilderMode.Application;
+    }
+    // Look up the current project's build target using a development configuration.
+    const buildTargetSpecifier = `::development`;
+    const buildTarget = (0, architect_1.targetFromTargetString)(buildTargetSpecifier, context.target?.project, 'build');
+    try {
+        const developmentBuilderName = await context.getBuilderNameForTarget(buildTarget);
+        return isEsbuildBased(developmentBuilderName);
+    }
+    catch (e) {
+        if (!(e instanceof Error) || e.message !== 'Project target does not exist.') {
+            throw e;
+        }
+        // If we can't find a development builder, we can't use 'detect'.
+        throw new Error('Failed to detect the builder used by the application. Please set builderMode explicitly.');
+    }
+}
+function isEsbuildBased(builderName) {
+    if (builderName === '@angular/build:application' ||
+        builderName === '@angular-devkit/build-angular:application' ||
+        builderName === '@angular-devkit/build-angular:browser-esbuild') {
+        return true;
+    }
+    return false;
 }

package/src/builders/karma/init_test_bed.js

@@ -0,0 +1,19 @@
+/**
+ * @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 { getTestBed } from '@angular/core/testing';
+import {
+  BrowserDynamicTestingModule,
+  platformBrowserDynamicTesting,
+} from '@angular/platform-browser-dynamic/testing';
+
+// Initialize the Angular testing environment.
+getTestBed().initTestEnvironment(BrowserDynamicTestingModule, platformBrowserDynamicTesting(), {
+  errorOnUnknownElements: true,
+  errorOnUnknownProperties: true,
+});

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

@@ -10,6 +10,11 @@ export interface Schema {
      * Override which browsers tests are run against. Set to `false` to not use any browser.
      */
     browsers?: Browsers;
+    /**
+     * Determines how to build the code under test. If set to 'detect', attempts to follow the
+     * development builder.
+     */
+    builderMode?: BuilderMode;
     /**
      * Output a code coverage report.
      */
@@ -121,6 +126,15 @@ export interface AssetPatternClass {
  * Override which browsers tests are run against. Set to `false` to not use any browser.
  */
 export type Browsers = boolean | string;
+/**
+ * Determines how to build the code under test. If set to 'detect', attempts to follow the
+ * development builder.
+ */
+export declare enum BuilderMode {
+    Application = "application",
+    Browser = "browser",
+    Detect = "detect"
+}
 export interface FileReplacement {
     replace?: string;
     replaceWith?: string;