@angular/build 20.0.0-next.7 → 20.0.0-next.9

package/.browserslistrc

@@ -1,6 +1,6 @@
-Chrome >= 105
-ChromeAndroid >= 105
-Edge >= 105
+Chrome >= 107
+ChromeAndroid >= 107
+Edge >= 107
 Firefox >= 104
 FirefoxAndroid >= 104
 Safari >= 16

package/builders.json

@@ -24,6 +24,11 @@
       "implementation": "./src/builders/ng-packagr/index",
       "schema": "./src/builders/ng-packagr/schema.json",
       "description": "Build a library with ng-packagr."
+    },
+    "unit-test": {
+      "implementation": "./src/builders/unit-test",
+      "schema": "./src/builders/unit-test/schema.json",
+      "description": "[EXPERIMENTAL] Run application unit tests."
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "20.0.0-next.7",
+  "version": "20.0.0-next.9",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,7 +23,7 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.2000.0-next.7",
+    "@angular-devkit/architect": "0.2000.0-next.9",
     "@babel/core": "7.26.10",
     "@babel/helper-annotate-as-pure": "7.25.9",
     "@babel/helper-split-export-declaration": "7.24.7",
@@ -41,12 +41,12 @@
     "parse5-html-rewriting-stream": "7.1.0",
     "picomatch": "4.0.2",
     "piscina": "4.9.2",
-    "rollup": "4.40.0",
+    "rollup": "4.40.1",
     "sass": "1.87.0",
     "semver": "7.7.1",
     "source-map-support": "0.5.21",
     "tinyglobby": "0.2.13",
-    "vite": "6.3.2",
+    "vite": "6.3.4",
     "watchpack": "2.4.2"
   },
   "optionalDependencies": {
@@ -60,14 +60,15 @@
     "@angular/platform-browser": "^20.0.0 || ^20.0.0-next.0",
     "@angular/platform-server": "^20.0.0 || ^20.0.0-next.0",
     "@angular/service-worker": "^20.0.0 || ^20.0.0-next.0",
-    "@angular/ssr": "^20.0.0-next.7",
+    "@angular/ssr": "^20.0.0-next.9",
     "karma": "^6.4.0",
     "less": "^4.2.0",
     "ng-packagr": "^20.0.0 || ^20.0.0-next.0",
     "postcss": "^8.4.0",
     "tailwindcss": "^2.0.0 || ^3.0.0 || ^4.0.0",
     "tslib": "^2.3.0",
-    "typescript": ">=5.8 <5.9"
+    "typescript": ">=5.8 <5.9",
+    "vitest": "^3.1.1"
   },
   "peerDependenciesMeta": {
     "@angular/core": {
@@ -102,6 +103,9 @@
     },
     "tailwindcss": {
       "optional": true
+    },
+    "vitest": {
+      "optional": true
     }
   },
   "repository": {

package/src/builders/application/options.js

@@ -23,6 +23,7 @@ const environment_options_1 = require("../../utils/environment-options");
 const i18n_options_1 = require("../../utils/i18n-options");
 const normalize_cache_1 = require("../../utils/normalize-cache");
 const postcss_configuration_1 = require("../../utils/postcss-configuration");
+const project_metadata_1 = require("../../utils/project-metadata");
 const url_1 = require("../../utils/url");
 const schema_1 = require("./schema");
 /**
@@ -58,8 +59,7 @@ async function normalizeOptions(context, projectName, options, extensions) {
             // ref: https://github.com/nodejs/node/issues/7726
             (0, node_fs_1.realpathSync)(context.workspaceRoot);
     const projectMetadata = await context.getProjectMetadata(projectName);
-    const projectRoot = normalizeDirectoryPath(node_path_1.default.join(workspaceRoot, projectMetadata.root ?? ''));
-    const projectSourceRoot = normalizeDirectoryPath(node_path_1.default.join(workspaceRoot, projectMetadata.sourceRoot ?? 'src'));
+    const { projectRoot, projectSourceRoot } = (0, project_metadata_1.getProjectRootPaths)(workspaceRoot, projectMetadata);
     // Gather persistent caching option and provide a project specific cache location
     const cacheOptions = (0, normalize_cache_1.normalizeCacheOptions)(projectMetadata, workspaceRoot);
     cacheOptions.path = node_path_1.default.join(cacheOptions.path, projectName);
@@ -169,7 +169,7 @@ async function normalizeOptions(context, projectName, options, extensions) {
         server: 'server',
         media: 'media',
         ...(typeof outputPath === 'string' ? undefined : outputPath),
-        base: normalizeDirectoryPath(node_path_1.default.resolve(workspaceRoot, typeof outputPath === 'string' ? outputPath : outputPath.base)),
+        base: (0, project_metadata_1.normalizeDirectoryPath)(node_path_1.default.resolve(workspaceRoot, typeof outputPath === 'string' ? outputPath : outputPath.base)),
         clean: options.deleteOutputPath ?? true,
         // For app-shell and SSG server files are not required by users.
         // Omit these when SSR is not enabled.
@@ -406,19 +406,6 @@ function normalizeEntryPoints(workspaceRoot, browser, entryPoints = new Set()) {
         return entryPointPaths;
     }
 }
-/**
- * Normalize a directory path string.
- * Currently only removes a trailing slash if present.
- * @param path A path string.
- * @returns A normalized path string.
- */
-function normalizeDirectoryPath(path) {
-    const last = path[path.length - 1];
-    if (last === '/' || last === '\\') {
-        return path.slice(0, -1);
-    }
-    return path;
-}
 function normalizeGlobalEntries(rawEntries, defaultName) {
     if (!rawEntries?.length) {
         return [];

package/src/builders/karma/application_builder.js

@@ -50,6 +50,7 @@ const tinyglobby_1 = require("tinyglobby");
 const bundler_context_1 = require("../../tools/esbuild/bundler-context");
 const utils_1 = require("../../tools/esbuild/utils");
 const virtual_module_plugin_1 = require("../../tools/esbuild/virtual-module-plugin");
+const project_metadata_1 = require("../../utils/project-metadata");
 const index_1 = require("../application/index");
 const results_1 = require("../application/results");
 const schema_1 = require("../application/schema");
@@ -266,8 +267,8 @@ async function getProjectSourceRoot(context) {
         return context.workspaceRoot;
     }
     const projectMetadata = await context.getProjectMetadata(projectName);
-    const sourceRoot = (projectMetadata.sourceRoot ?? projectMetadata.root ?? '');
-    return path.join(context.workspaceRoot, sourceRoot);
+    const { projectSourceRoot } = (0, project_metadata_1.getProjectRootPaths)(context.workspaceRoot, projectMetadata);
+    return projectSourceRoot;
 }
 function normalizePolyfills(polyfills) {
     if (typeof polyfills === 'string') {

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

@@ -0,0 +1,15 @@
+/**
+ * @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 { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
+import type { ApplicationBuilderExtensions } from '../application/options';
+import type { Schema as UnitTestOptions } from './schema';
+export type { UnitTestOptions };
+/**
+ * @experimental Direct usage of this function is considered experimental.
+ */
+export declare function execute(options: UnitTestOptions, context: BuilderContext, extensions?: ApplicationBuilderExtensions): AsyncIterable<BuilderOutput>;

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

@@ -0,0 +1,170 @@
+"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.execute = execute;
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_crypto_1 = require("node:crypto");
+const node_module_1 = require("node:module");
+const node_path_1 = __importDefault(require("node:path"));
+const virtual_module_plugin_1 = require("../../tools/esbuild/virtual-module-plugin");
+const load_esm_1 = require("../../utils/load-esm");
+const application_1 = require("../application");
+const results_1 = require("../application/results");
+const schema_1 = require("../application/schema");
+const application_builder_1 = require("../karma/application_builder");
+const find_tests_1 = require("../karma/find-tests");
+const karma_bridge_1 = require("./karma-bridge");
+const options_1 = require("./options");
+/**
+ * @experimental Direct usage of this function is considered experimental.
+ */
+async function* execute(options, context, extensions = {}) {
+    // Determine project name from builder context target
+    const projectName = context.target?.project;
+    if (!projectName) {
+        context.logger.error(`The "${context.builder.builderName}" builder requires a target to be specified.`);
+        return;
+    }
+    context.logger.warn(`NOTE: The "${context.builder.builderName}" builder is currently EXPERIMENTAL and not ready for production use.`);
+    const normalizedOptions = await (0, options_1.normalizeOptions)(context, projectName, options);
+    const { projectSourceRoot, workspaceRoot, runnerName } = normalizedOptions;
+    // Translate options and use karma builder directly if specified
+    if (runnerName === 'karma') {
+        const karmaBridge = await (0, karma_bridge_1.useKarmaBuilder)(context, normalizedOptions);
+        yield* karmaBridge;
+        return;
+    }
+    if (runnerName !== 'vitest') {
+        context.logger.error('Unknown test runner: ' + runnerName);
+        return;
+    }
+    // Find test files
+    const testFiles = await (0, find_tests_1.findTests)(normalizedOptions.include, normalizedOptions.exclude, workspaceRoot, projectSourceRoot);
+    if (testFiles.length === 0) {
+        context.logger.error('No tests found.');
+        return { success: false };
+    }
+    const entryPoints = (0, find_tests_1.getTestEntrypoints)(testFiles, { projectSourceRoot, workspaceRoot });
+    entryPoints.set('init-testbed', 'angular:test-bed-init');
+    const { startVitest } = await (0, load_esm_1.loadEsmModule)('vitest/node');
+    // Setup test file build options based on application build target options
+    const buildTargetOptions = (await context.validateOptions(await context.getTargetOptions(normalizedOptions.buildTarget), await context.getBuilderNameForTarget(normalizedOptions.buildTarget)));
+    if (buildTargetOptions.polyfills?.includes('zone.js')) {
+        buildTargetOptions.polyfills.push('zone.js/testing');
+    }
+    const outputPath = node_path_1.default.join(context.workspaceRoot, 'dist/test-out', (0, node_crypto_1.randomUUID)());
+    const buildOptions = {
+        ...buildTargetOptions,
+        watch: normalizedOptions.watch,
+        outputPath,
+        index: false,
+        browser: undefined,
+        server: undefined,
+        localize: false,
+        budgets: [],
+        serviceWorker: false,
+        appShell: false,
+        ssr: false,
+        prerender: false,
+        sourceMap: { scripts: true, vendor: false, styles: false },
+        outputHashing: schema_1.OutputHashing.None,
+        optimization: false,
+        tsConfig: normalizedOptions.tsConfig,
+        entryPoints,
+        externalDependencies: ['vitest', ...(buildTargetOptions.externalDependencies ?? [])],
+    };
+    extensions ??= {};
+    extensions.codePlugins ??= [];
+    const virtualTestBedInit = (0, virtual_module_plugin_1.createVirtualModulePlugin)({
+        namespace: 'angular:test-bed-init',
+        loadContent: async () => {
+            const contents = [
+                // Initialize the Angular testing environment
+                `import { getTestBed } from '@angular/core/testing';`,
+                `import { BrowserTestingModule, platformBrowserTesting } from '@angular/platform-browser/testing';`,
+                `getTestBed().initTestEnvironment(BrowserTestingModule, platformBrowserTesting(), {`,
+                `  errorOnUnknownElements: true,`,
+                `  errorOnUnknownProperties: true,`,
+                '});',
+            ];
+            return {
+                contents: contents.join('\n'),
+                loader: 'js',
+                resolveDir: projectSourceRoot,
+            };
+        },
+    });
+    extensions.codePlugins.unshift(virtualTestBedInit);
+    let instance;
+    // Setup vitest browser options if configured
+    let browser;
+    if (normalizedOptions.browsers) {
+        const provider = findBrowserProvider(projectSourceRoot);
+        if (!provider) {
+            context.logger.error('The "browsers" option requires either "playwright" or "webdriverio" to be installed within the project.' +
+                ' Please install one of these packages and rerun the test command.');
+            return { success: false };
+        }
+        browser = {
+            enabled: true,
+            provider,
+            instances: normalizedOptions.browsers.map((browserName) => ({
+                browser: browserName,
+            })),
+        };
+    }
+    for await (const result of (0, application_1.buildApplicationInternal)(buildOptions, context, extensions)) {
+        if (result.kind === results_1.ResultKind.Failure) {
+            continue;
+        }
+        else if (result.kind !== results_1.ResultKind.Full) {
+            node_assert_1.default.fail('A full build result is required from the application builder.');
+        }
+        (0, node_assert_1.default)(result.files, 'Builder did not provide result files.');
+        await (0, application_builder_1.writeTestFiles)(result.files, outputPath);
+        const setupFiles = ['init-testbed.js'];
+        if (buildTargetOptions?.polyfills?.length) {
+            setupFiles.push('polyfills.js');
+        }
+        instance ??= await startVitest('test', undefined /* cliFilters */, undefined /* options */, {
+            test: {
+                root: outputPath,
+                setupFiles,
+                // Use `jsdom` if no browsers are explicitly configured.
+                // `node` is effectively no "environment" and the default.
+                environment: browser ? 'node' : 'jsdom',
+                watch: normalizedOptions.watch,
+                browser,
+                coverage: {
+                    enabled: normalizedOptions.codeCoverage,
+                    exclude: normalizedOptions.codeCoverageExclude,
+                    excludeAfterRemap: true,
+                },
+            },
+        });
+        // Check if all the tests pass to calculate the result
+        const testModules = instance.state.getTestModules();
+        yield { success: testModules.every((testModule) => testModule.ok()) };
+    }
+}
+function findBrowserProvider(projectSourceRoot) {
+    const projectResolver = (0, node_module_1.createRequire)(projectSourceRoot + '/').resolve;
+    // These must be installed in the project to be used
+    const vitestBuiltinProviders = ['playwright', 'webdriverio'];
+    for (const providerName of vitestBuiltinProviders) {
+        try {
+            projectResolver(providerName);
+            return providerName;
+        }
+        catch { }
+    }
+}

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

@@ -0,0 +1,12 @@
+/**
+ * @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 Builder } from '@angular-devkit/architect';
+import { type UnitTestOptions, execute } from './builder';
+export { type UnitTestOptions, execute };
+declare const builder: Builder<UnitTestOptions>;
+export default builder;

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

@@ -0,0 +1,15 @@
+"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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = void 0;
+const architect_1 = require("@angular-devkit/architect");
+const builder_1 = require("./builder");
+Object.defineProperty(exports, "execute", { enumerable: true, get: function () { return builder_1.execute; } });
+const builder = (0, architect_1.createBuilder)(builder_1.execute);
+exports.default = builder;

package/src/builders/unit-test/karma-bridge.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @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 { BuilderContext, BuilderOutput } from '@angular-devkit/architect';
+import type { NormalizedUnitTestOptions } from './options';
+export declare function useKarmaBuilder(context: BuilderContext, unitTestOptions: NormalizedUnitTestOptions): Promise<AsyncIterable<BuilderOutput>>;

package/src/builders/unit-test/karma-bridge.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useKarmaBuilder = useKarmaBuilder;
+async function useKarmaBuilder(context, unitTestOptions) {
+    const buildTargetOptions = (await context.validateOptions(await context.getTargetOptions(unitTestOptions.buildTarget), await context.getBuilderNameForTarget(unitTestOptions.buildTarget)));
+    const options = {
+        tsConfig: unitTestOptions.tsConfig,
+        polyfills: buildTargetOptions.polyfills,
+        assets: buildTargetOptions.assets,
+        scripts: buildTargetOptions.scripts,
+        styles: buildTargetOptions.styles,
+        inlineStyleLanguage: buildTargetOptions.inlineStyleLanguage,
+        stylePreprocessorOptions: buildTargetOptions.stylePreprocessorOptions,
+        externalDependencies: buildTargetOptions.externalDependencies,
+        loader: buildTargetOptions.loader,
+        define: buildTargetOptions.define,
+        include: unitTestOptions.include,
+        exclude: unitTestOptions.exclude,
+        sourceMap: buildTargetOptions.sourceMap,
+        progress: buildTargetOptions.progress,
+        watch: unitTestOptions.watch,
+        poll: buildTargetOptions.poll,
+        preserveSymlinks: buildTargetOptions.preserveSymlinks,
+        browsers: unitTestOptions.browsers?.join(','),
+        codeCoverage: unitTestOptions.codeCoverage,
+        codeCoverageExclude: unitTestOptions.codeCoverageExclude,
+        fileReplacements: buildTargetOptions.fileReplacements,
+        reporters: unitTestOptions.reporters,
+        webWorkerTsConfig: buildTargetOptions.webWorkerTsConfig,
+        aot: buildTargetOptions.aot,
+    };
+    const { execute } = await Promise.resolve().then(() => __importStar(require('../karma')));
+    return execute(options, context);
+}

package/src/builders/unit-test/options.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 BuilderContext } from '@angular-devkit/architect';
+import type { Schema as UnitTestOptions } from './schema';
+export type NormalizedUnitTestOptions = Awaited<ReturnType<typeof normalizeOptions>>;
+export declare function normalizeOptions(context: BuilderContext, projectName: string, options: UnitTestOptions): Promise<{
+    workspaceRoot: string;
+    projectRoot: string;
+    projectSourceRoot: string;
+    cacheOptions: import("../../utils/normalize-cache").NormalizedCachedOptions;
+    buildTarget: import("@angular-devkit/architect").Target;
+    include: string[];
+    exclude: string[];
+    runnerName: import("./schema").Runner;
+    codeCoverage: boolean | undefined;
+    codeCoverageExclude: string[] | undefined;
+    tsConfig: string;
+    reporters: string[] | undefined;
+    browsers: string[] | undefined;
+    watch: boolean;
+}>;

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

@@ -0,0 +1,62 @@
+"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.normalizeOptions = normalizeOptions;
+const architect_1 = require("@angular-devkit/architect");
+const node_path_1 = __importDefault(require("node:path"));
+const normalize_cache_1 = require("../../utils/normalize-cache");
+const project_metadata_1 = require("../../utils/project-metadata");
+async function normalizeOptions(context, projectName, options) {
+    // Setup base paths based on workspace root and project information
+    const workspaceRoot = context.workspaceRoot;
+    const projectMetadata = await context.getProjectMetadata(projectName);
+    const { projectRoot, projectSourceRoot } = (0, project_metadata_1.getProjectRootPaths)(workspaceRoot, projectMetadata);
+    // Gather persistent caching option and provide a project specific cache location
+    const cacheOptions = (0, normalize_cache_1.normalizeCacheOptions)(projectMetadata, workspaceRoot);
+    cacheOptions.path = node_path_1.default.join(cacheOptions.path, projectName);
+    // Target specifier defaults to the current project's build target using a development configuration
+    const buildTargetSpecifier = options.buildTarget ?? `::development`;
+    const buildTarget = (0, architect_1.targetFromTargetString)(buildTargetSpecifier, projectName, 'build');
+    const { codeCoverage, codeCoverageExclude, tsConfig, runner, reporters, browsers } = options;
+    return {
+        // Project/workspace information
+        workspaceRoot,
+        projectRoot,
+        projectSourceRoot,
+        cacheOptions,
+        // Target/configuration specified options
+        buildTarget,
+        include: options.include ?? ['**/*.spec.ts'],
+        exclude: options.exclude ?? [],
+        runnerName: runner,
+        codeCoverage,
+        codeCoverageExclude,
+        tsConfig,
+        reporters,
+        browsers,
+        // TODO: Implement watch support
+        watch: false,
+    };
+}
+/**
+ * Normalize a directory path string.
+ * Currently only removes a trailing slash if present.
+ * @param path A path string.
+ * @returns A normalized path string.
+ */
+function normalizeDirectoryPath(path) {
+    const last = path[path.length - 1];
+    if (last === '/' || last === '\\') {
+        return path.slice(0, -1);
+    }
+    return path;
+}

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

@@ -0,0 +1,60 @@
+/**
+ * Unit testing options for Angular applications.
+ */
+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.
+     */
+    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`.
+     */
+    buildTarget: string;
+    /**
+     * Output a code coverage report.
+     */
+    codeCoverage?: boolean;
+    /**
+     * Globs to exclude from code coverage.
+     */
+    codeCoverageExclude?: string[];
+    /**
+     * Globs of files to exclude, 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.
+     */
+    include?: string[];
+    /**
+     * Test runner reporters to use. Directly passed to the test runner.
+     */
+    reporters?: string[];
+    /**
+     * The name of the test runner to use for test execution.
+     */
+    runner: Runner;
+    /**
+     * The name of the TypeScript configuration file.
+     */
+    tsConfig: string;
+    /**
+     * Run build when files change.
+     */
+    watch?: boolean;
+};
+/**
+ * The name of the test runner to use for test execution.
+ */
+export declare enum Runner {
+    Karma = "karma",
+    Vitest = "vitest"
+}

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

@@ -0,0 +1,13 @@
+"use strict";
+// THIS FILE IS AUTOMATICALLY GENERATED. TO UPDATE THIS FILE YOU NEED TO CHANGE THE
+// CORRESPONDING JSON SCHEMA FILE, THEN RUN devkit-admin build (or bazel build ...).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Runner = void 0;
+/**
+ * The name of the test runner to use for test execution.
+ */
+var Runner;
+(function (Runner) {
+    Runner["Karma"] = "karma";
+    Runner["Vitest"] = "vitest";
+})(Runner || (exports.Runner = Runner = {}));

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

@@ -0,0 +1,72 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "title": "Unit testing",
+  "description": "Unit testing options for Angular applications.",
+  "type": "object",
+  "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`.",
+      "pattern": "^[^:\\s]*:[^:\\s]*(:[^\\s]+)?$"
+    },
+    "tsConfig": {
+      "type": "string",
+      "description": "The name of the TypeScript configuration file."
+    },
+    "runner": {
+      "type": "string",
+      "description": "The name of 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.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1
+    },
+    "include": {
+      "type": "array",
+      "items": {
+        "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."
+    },
+    "exclude": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": [],
+      "description": "Globs of files to exclude, relative to the project root."
+    },
+    "watch": {
+      "type": "boolean",
+      "description": "Run build when files change."
+    },
+    "codeCoverage": {
+      "type": "boolean",
+      "description": "Output a code coverage report.",
+      "default": false
+    },
+    "codeCoverageExclude": {
+      "type": "array",
+      "description": "Globs to exclude from code coverage.",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    },
+    "reporters": {
+      "type": "array",
+      "description": "Test runner reporters to use. Directly passed to the test runner.",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "additionalProperties": false,
+  "required": ["buildTarget", "tsConfig", "runner"]
+}

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

@@ -37,8 +37,8 @@ const wasm_plugin_1 = require("./wasm-plugin");
 function createBrowserCodeBundleOptions(options, target, sourceFileCache, stylesheetBundler, angularCompilation, templateUpdates) {
     return (loadCache) => {
         const { entryPoints, outputNames, polyfills } = options;
-        const pluginOptions = (0, compiler_plugin_options_1.createCompilerPluginOptions)(options, sourceFileCache, loadCache, templateUpdates);
         const zoneless = (0, utils_1.isZonelessApp)(polyfills);
+        const pluginOptions = (0, compiler_plugin_options_1.createCompilerPluginOptions)(options, sourceFileCache, loadCache, templateUpdates);
         const buildOptions = {
             ...getEsBuildCommonOptions(options),
             platform: 'browser',
@@ -51,22 +51,16 @@ function createBrowserCodeBundleOptions(options, target, sourceFileCache, styles
             entryPoints,
             target,
             supported: (0, utils_1.getFeatureSupport)(target, zoneless),
-            plugins: [
-                (0, loader_import_attribute_plugin_1.createLoaderImportAttributePlugin)(),
-                (0, wasm_plugin_1.createWasmPlugin)({ allowAsync: zoneless, cache: loadCache }),
-                (0, sourcemap_ignorelist_plugin_1.createSourcemapIgnorelistPlugin)(),
-                (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(),
-                (0, compiler_plugin_1.createCompilerPlugin)(
-                // JS/TS options
-                pluginOptions, angularCompilation, 
-                // Component stylesheet bundler
-                stylesheetBundler),
-            ],
         };
+        buildOptions.plugins ??= [];
+        buildOptions.plugins.push((0, wasm_plugin_1.createWasmPlugin)({ allowAsync: zoneless, cache: loadCache }), (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(), (0, compiler_plugin_1.createCompilerPlugin)(
+        // JS/TS options
+        pluginOptions, angularCompilation, 
+        // Component stylesheet bundler
+        stylesheetBundler));
         if (options.plugins) {
-            buildOptions.plugins?.push(...options.plugins);
+            buildOptions.plugins.push(...options.plugins);
         }
-        appendOptionsForExternalPackages(options, buildOptions);
         return buildOptions;
     };
 }
@@ -186,20 +180,15 @@ function createServerMainCodeBundleOptions(options, target, sourceFileCache, sty
             },
             entryPoints,
             supported: (0, utils_1.getFeatureSupport)(target, zoneless),
-            plugins: [
-                (0, wasm_plugin_1.createWasmPlugin)({ allowAsync: zoneless, cache: loadResultCache }),
-                (0, sourcemap_ignorelist_plugin_1.createSourcemapIgnorelistPlugin)(),
-                (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(),
-                (0, compiler_plugin_1.createCompilerPlugin)(
-                // JS/TS options
-                pluginOptions, 
-                // Browser compilation handles the actual Angular code compilation
-                new compilation_1.NoopCompilation(), 
-                // Component stylesheet bundler
-                stylesheetBundler),
-            ],
         };
         buildOptions.plugins ??= [];
+        buildOptions.plugins.push((0, wasm_plugin_1.createWasmPlugin)({ allowAsync: zoneless, cache: loadResultCache }), (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(), (0, compiler_plugin_1.createCompilerPlugin)(
+        // JS/TS options
+        pluginOptions, 
+        // Browser compilation handles the actual Angular code compilation
+        new compilation_1.NoopCompilation(), 
+        // Component stylesheet bundler
+        stylesheetBundler));
         if (!externalPackages) {
             buildOptions.plugins.push((0, rxjs_esm_resolution_plugin_1.createRxjsEsmResolutionPlugin)());
         }
@@ -259,7 +248,6 @@ function createServerMainCodeBundleOptions(options, target, sourceFileCache, sty
         if (options.plugins) {
             buildOptions.plugins.push(...options.plugins);
         }
-        appendOptionsForExternalPackages(options, buildOptions);
         return buildOptions;
     };
 }
@@ -291,19 +279,15 @@ function createSsrEntryCodeBundleOptions(options, target, sourceFileCache, style
                 'server': ssrEntryNamespace,
             },
             supported: (0, utils_1.getFeatureSupport)(target, true),
-            plugins: [
-                (0, sourcemap_ignorelist_plugin_1.createSourcemapIgnorelistPlugin)(),
-                (0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(),
-                (0, compiler_plugin_1.createCompilerPlugin)(
-                // JS/TS options
-                pluginOptions, 
-                // Browser compilation handles the actual Angular code compilation
-                new compilation_1.NoopCompilation(), 
-                // Component stylesheet bundler
-                stylesheetBundler),
-            ],
         };
         buildOptions.plugins ??= [];
+        buildOptions.plugins.push((0, angular_localize_init_warning_plugin_1.createAngularLocalizeInitWarningPlugin)(), (0, compiler_plugin_1.createCompilerPlugin)(
+        // JS/TS options
+        pluginOptions, 
+        // Browser compilation handles the actual Angular code compilation
+        new compilation_1.NoopCompilation(), 
+        // Component stylesheet bundler
+        stylesheetBundler));
         if (!externalPackages) {
             buildOptions.plugins.push((0, rxjs_esm_resolution_plugin_1.createRxjsEsmResolutionPlugin)());
         }
@@ -360,17 +344,16 @@ function createSsrEntryCodeBundleOptions(options, target, sourceFileCache, style
         if (options.plugins) {
             buildOptions.plugins.push(...options.plugins);
         }
-        appendOptionsForExternalPackages(options, buildOptions);
         return buildOptions;
     };
 }
 function getEsBuildServerCommonOptions(options) {
     const isNodePlatform = options.ssrOptions?.platform !== schema_1.ExperimentalPlatform.Neutral;
-    const commonOptons = getEsBuildCommonOptions(options);
-    commonOptons.define ??= {};
-    commonOptons.define['ngServerMode'] = 'true';
+    const commonOptions = getEsBuildCommonOptions(options);
+    commonOptions.define ??= {};
+    commonOptions.define['ngServerMode'] = 'true';
     return {
-        ...commonOptons,
+        ...commonOptions,
         platform: isNodePlatform ? 'node' : 'neutral',
         outExtension: { '.js': '.mjs' },
         // Note: `es2015` is needed for RxJS v6. If not specified, `module` would
@@ -413,14 +396,32 @@ function getEsBuildCommonOptions(options) {
     }
     else {
         // Include default conditions
-        conditions.push('module');
-        conditions.push(optimizationOptions.scripts ? 'production' : 'development');
+        conditions.push('module', optimizationOptions.scripts ? 'production' : 'development');
+    }
+    const plugins = [
+        (0, loader_import_attribute_plugin_1.createLoaderImportAttributePlugin)(),
+        (0, sourcemap_ignorelist_plugin_1.createSourcemapIgnorelistPlugin)(),
+    ];
+    let packages = 'bundle';
+    if (options.externalPackages) {
+        // Package files affected by a customized loader should not be implicitly marked as external
+        if (options.loaderExtensions ||
+            options.plugins ||
+            typeof options.externalPackages === 'object') {
+            // Plugin must be added after custom plugins to ensure any added loader options are considered
+            plugins.push((0, external_packages_plugin_1.createExternalPackagesPlugin)(options.externalPackages !== true ? options.externalPackages : undefined));
+            packages = 'bundle';
+        }
+        else {
+            // Safe to use the packages external option directly
+            packages = 'external';
+        }
     }
     return {
         absWorkingDir: workspaceRoot,
         format: 'esm',
         bundle: true,
-        packages: 'bundle',
+        packages,
         assetNames: outputNames.media,
         conditions,
         resolveExtensions: ['.ts', '.tsx', '.mjs', '.js', '.cjs'],
@@ -453,15 +454,14 @@ function getEsBuildCommonOptions(options) {
         },
         loader: loaderExtensions,
         footer,
+        plugins,
     };
 }
 function getEsBuildCommonPolyfillsOptions(options, namespace, tryToResolvePolyfillsAsRelative, loadResultCache) {
     const { jit, workspaceRoot, i18nOptions } = options;
-    const buildOptions = {
-        ...getEsBuildCommonOptions(options),
-        splitting: false,
-        plugins: [(0, sourcemap_ignorelist_plugin_1.createSourcemapIgnorelistPlugin)()],
-    };
+    const buildOptions = getEsBuildCommonOptions(options);
+    buildOptions.splitting = false;
+    buildOptions.plugins ??= [];
     let polyfills = options.polyfills ? [...options.polyfills] : [];
     // Angular JIT mode requires the runtime compiler
     if (jit) {
@@ -486,12 +486,12 @@ function getEsBuildCommonPolyfillsOptions(options, namespace, tryToResolvePolyfi
         needLocaleDataPlugin = true;
     }
     if (needLocaleDataPlugin) {
-        buildOptions.plugins?.push((0, i18n_locale_plugin_1.createAngularLocaleDataPlugin)());
+        buildOptions.plugins.push((0, i18n_locale_plugin_1.createAngularLocaleDataPlugin)());
     }
     if (polyfills.length === 0) {
         return;
     }
-    buildOptions.plugins?.push((0, virtual_module_plugin_1.createVirtualModulePlugin)({
+    buildOptions.plugins.push((0, virtual_module_plugin_1.createVirtualModulePlugin)({
         namespace,
         cache: loadResultCache,
         loadContent: async (_, build) => {
@@ -539,19 +539,3 @@ function entryFileToWorkspaceRelative(workspaceRoot, entryFile) {
             .replace(/.[mc]?ts$/, '')
             .replace(/\\/g, '/'));
 }
-function appendOptionsForExternalPackages(options, buildOptions) {
-    if (!options.externalPackages) {
-        return;
-    }
-    buildOptions.plugins ??= [];
-    // Package files affected by a customized loader should not be implicitly marked as external
-    if (options.loaderExtensions || options.plugins || typeof options.externalPackages === 'object') {
-        // Plugin must be added after custom plugins to ensure any added loader options are considered
-        buildOptions.plugins.push((0, external_packages_plugin_1.createExternalPackagesPlugin)(options.externalPackages !== true ? options.externalPackages : undefined));
-        buildOptions.packages = undefined;
-    }
-    else {
-        // Safe to use the packages external option directly
-        buildOptions.packages = 'external';
-    }
-}

package/src/tools/vite/middlewares/chrome-devtools-middleware.js

@@ -27,7 +27,7 @@ function createChromeDevtoolsMiddleware(cacheDir, projectRoot) {
         if (!devtoolsConfig) {
             // We store the UUID and re-use it to ensure Chrome does not repeatedly ask for permissions when restarting the dev server.
             try {
-                const devtoolsConfig = (0, node_fs_1.readFileSync)(devtoolsConfigPath, 'utf-8');
+                devtoolsConfig = (0, node_fs_1.readFileSync)(devtoolsConfigPath, 'utf-8');
                 const devtoolsConfigJson = JSON.parse(devtoolsConfig);
                 node_assert_1.default.equal(projectRoot, devtoolsConfigJson?.workspace.root);
             }

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

package/src/utils/project-metadata.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @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
+ */
+/**
+ * Normalize a directory path string.
+ * Currently only removes a trailing slash if present.
+ * @param path A path string.
+ * @returns A normalized path string.
+ */
+export declare function normalizeDirectoryPath(path: string): string;
+export declare function getProjectRootPaths(workspaceRoot: string, projectMetadata: {
+    root?: string;
+    sourceRoot?: string;
+}): {
+    projectRoot: string;
+    projectSourceRoot: string;
+};

package/src/utils/project-metadata.js

@@ -0,0 +1,31 @@
+"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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeDirectoryPath = normalizeDirectoryPath;
+exports.getProjectRootPaths = getProjectRootPaths;
+const node_path_1 = require("node:path");
+/**
+ * Normalize a directory path string.
+ * Currently only removes a trailing slash if present.
+ * @param path A path string.
+ * @returns A normalized path string.
+ */
+function normalizeDirectoryPath(path) {
+    const last = path[path.length - 1];
+    if (last === '/' || last === '\\') {
+        return path.slice(0, -1);
+    }
+    return path;
+}
+function getProjectRootPaths(workspaceRoot, projectMetadata) {
+    const projectRoot = normalizeDirectoryPath((0, node_path_1.join)(workspaceRoot, projectMetadata.root ?? ''));
+    const rawSourceRoot = projectMetadata.sourceRoot;
+    const projectSourceRoot = normalizeDirectoryPath(rawSourceRoot === undefined ? (0, node_path_1.join)(projectRoot, 'src') : (0, node_path_1.join)(workspaceRoot, rawSourceRoot));
+    return { projectRoot, projectSourceRoot };
+}