@angular/build 20.0.0-next.9 → 20.0.0-rc.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "20.0.0-next.9",
+  "version": "20.0.0-rc.0",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,34 +23,34 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.2000.0-next.9",
-    "@babel/core": "7.26.10",
-    "@babel/helper-annotate-as-pure": "7.25.9",
+    "@angular-devkit/architect": "0.2000.0-rc.0",
+    "@babel/core": "7.27.1",
+    "@babel/helper-annotate-as-pure": "7.27.1",
     "@babel/helper-split-export-declaration": "7.24.7",
     "@inquirer/confirm": "5.1.9",
     "@vitejs/plugin-basic-ssl": "2.0.0",
     "beasties": "0.3.3",
     "browserslist": "^4.23.0",
-    "esbuild": "0.25.3",
+    "esbuild": "0.25.4",
     "https-proxy-agent": "7.0.6",
     "istanbul-lib-instrument": "6.0.3",
     "jsonc-parser": "3.3.1",
-    "listr2": "8.3.2",
+    "listr2": "8.3.3",
     "magic-string": "0.30.17",
     "mrmime": "2.0.1",
     "parse5-html-rewriting-stream": "7.1.0",
     "picomatch": "4.0.2",
-    "piscina": "4.9.2",
-    "rollup": "4.40.1",
+    "piscina": "5.0.0",
+    "rollup": "4.40.2",
     "sass": "1.87.0",
     "semver": "7.7.1",
     "source-map-support": "0.5.21",
     "tinyglobby": "0.2.13",
-    "vite": "6.3.4",
+    "vite": "6.3.5",
     "watchpack": "2.4.2"
   },
   "optionalDependencies": {
-    "lmdb": "3.2.6"
+    "lmdb": "3.3.0"
   },
   "peerDependencies": {
     "@angular/core": "^20.0.0 || ^20.0.0-next.0",
@@ -60,7 +60,7 @@
     "@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.9",
+    "@angular/ssr": "^20.0.0-rc.0",
     "karma": "^6.4.0",
     "less": "^4.2.0",
     "ng-packagr": "^20.0.0 || ^20.0.0-next.0",
@@ -114,7 +114,7 @@
   },
   "packageManager": "pnpm@9.15.6",
   "engines": {
-    "node": "^20.11.1 || >=22.11.0",
+    "node": "^20.11.1 || ^22.11.0 || >=24.0.0",
     "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",
     "yarn": ">= 1.13.0"
   },

package/src/builders/application/execute-build.js

@@ -229,8 +229,9 @@ async function executeBuild(options, context, rebuildState) {
         const result = await (0, execute_post_bundle_1.executePostBundleSteps)(metafile, options, executionResult.outputFiles, executionResult.assetFiles, initialFiles, 
         // Set lang attribute to the defined source locale if present
         i18nOptions.hasDefinedSourceLocale ? i18nOptions.sourceLocale : undefined);
-        executionResult.addErrors(result.errors);
-        executionResult.addWarnings(result.warnings);
+        // Deduplicate and add errors and warnings
+        executionResult.addErrors([...new Set(result.errors)]);
+        executionResult.addWarnings([...new Set(result.warnings)]);
         executionResult.addPrerenderedRoutes(result.prerenderedRoutes);
         executionResult.outputFiles.push(...result.additionalOutputFiles);
         executionResult.assetFiles.push(...result.additionalAssets);

package/src/builders/application/i18n.js

@@ -92,6 +92,21 @@ async function inlineI18n(metafile, options, executionResult, initialFiles) {
     if (!i18nOptions.flatOutput) {
         executionResult.assetFiles = updatedAssetFiles;
     }
+    // Inline any template updates if present
+    if (executionResult.templateUpdates?.size) {
+        // The development server only allows a single locale but issue a warning if used programmatically (experimental)
+        // with multiple locales and template HMR.
+        if (i18nOptions.inlineLocales.size > 1) {
+            inlineResult.warnings.push(`Component HMR updates can only be inlined with a single locale. The first locale will be used.`);
+        }
+        const firstLocale = [...i18nOptions.inlineLocales][0];
+        for (const [id, content] of executionResult.templateUpdates) {
+            const templateUpdateResult = await inliner.inlineTemplateUpdate(firstLocale, i18nOptions.locales[firstLocale].translation, content, id);
+            executionResult.templateUpdates.set(id, templateUpdateResult.code);
+            inlineResult.errors.push(...templateUpdateResult.errors);
+            inlineResult.warnings.push(...templateUpdateResult.warnings);
+        }
+    }
     return inlineResult;
 }
 /**

package/src/builders/application/options.js

@@ -69,7 +69,7 @@ async function normalizeOptions(context, projectName, options, extensions) {
     if (options.forceI18nFlatOutput) {
         i18nOptions.flatOutput = true;
     }
-    const entryPoints = normalizeEntryPoints(workspaceRoot, options.browser, options.entryPoints);
+    const entryPoints = normalizeEntryPoints(workspaceRoot, projectSourceRoot, options.browser, options.entryPoints);
     const tsconfig = node_path_1.default.join(workspaceRoot, options.tsConfig);
     const optimizationOptions = (0, utils_1.normalizeOptimization)(options.optimization);
     const sourcemapOptions = (0, utils_1.normalizeSourceMaps)(options.sourceMap ?? false);
@@ -355,23 +355,22 @@ async function getTailwindConfig(searchDirectories, workspaceRoot, context) {
  * @param entryPoints Set of entry points to use if provided.
  * @returns An object mapping entry point names to their file paths.
  */
-function normalizeEntryPoints(workspaceRoot, browser, entryPoints = new Set()) {
+function normalizeEntryPoints(workspaceRoot, projectSourceRoot, browser, entryPoints) {
     if (browser === '') {
         throw new Error('`browser` option cannot be an empty string.');
     }
     // `browser` and `entryPoints` are mutually exclusive.
-    if (browser && entryPoints.size > 0) {
+    if (browser && entryPoints) {
         throw new Error('Only one of `browser` or `entryPoints` may be provided.');
     }
-    if (!browser && entryPoints.size === 0) {
-        // Schema should normally reject this case, but programmatic usages of the builder might make this mistake.
-        throw new Error('Either `browser` or at least one `entryPoints` value must be provided.');
-    }
-    // Schema types force `browser` to always be provided, but it may be omitted when the builder is invoked programmatically.
     if (browser) {
         // Use `browser` alone.
         return { 'main': node_path_1.default.join(workspaceRoot, browser) };
     }
+    else if (!entryPoints) {
+        // Default browser entry if no explicit entry points
+        return { 'main': node_path_1.default.join(projectSourceRoot, 'main.ts') };
+    }
     else if (entryPoints instanceof Map) {
         return Object.fromEntries(Array.from(entryPoints.entries(), ([name, entryPoint]) => {
             // Get the full file path to a relative entry point input. Leave bare specifiers alone so they are resolved as modules.

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

@@ -27,7 +27,7 @@ export type Schema = {
      * The full path for the browser entry point to the application, relative to the current
      * workspace.
      */
-    browser: string;
+    browser?: string;
     /**
      * Budget thresholds to ensure parts of your application stay within boundaries which you
      * set.

package/src/builders/application/schema.json

@@ -616,7 +616,7 @@
     }
   },
   "additionalProperties": false,
-  "required": ["browser", "tsConfig"],
+  "required": ["tsConfig"],
   "definitions": {
     "assetPattern": {
       "oneOf": [

package/src/builders/karma/application_builder.js

@@ -88,7 +88,7 @@ class AngularAssetsMiddleware {
         }
         switch (file.origin) {
             case 'disk':
-                this.serveFile(file.inputPath, undefined, res);
+                this.serveFile(file.inputPath, undefined, res, undefined, undefined, /* doNotCache */ true);
                 break;
             case 'memory':
                 // Include pathname to help with Content-Type headers.

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

@@ -89,8 +89,14 @@ async function* execute(options, context, extensions = {}) {
         loadContent: async () => {
             const contents = [
                 // Initialize the Angular testing environment
-                `import { getTestBed } from '@angular/core/testing';`,
+                `import { getTestBed, ɵgetCleanupHook as getCleanupHook } from '@angular/core/testing';`,
                 `import { BrowserTestingModule, platformBrowserTesting } from '@angular/platform-browser/testing';`,
+                `import { beforeEach, afterEach } from 'vitest';`,
+                '',
+                // Same as https://github.com/angular/angular/blob/05a03d3f975771bb59c7eefd37c01fa127ee2229/packages/core/testing/src/test_hooks.ts#L21-L29
+                `beforeEach(getCleanupHook(false));`,
+                `afterEach(getCleanupHook(true));`,
+                '',
                 `getTestBed().initTestEnvironment(BrowserTestingModule, platformBrowserTesting(), {`,
                 `  errorOnUnknownElements: true,`,
                 `  errorOnUnknownProperties: true,`,
@@ -144,6 +150,7 @@ async function* execute(options, context, extensions = {}) {
                 environment: browser ? 'node' : 'jsdom',
                 watch: normalizedOptions.watch,
                 browser,
+                reporters: normalizedOptions.reporters ?? ['default'],
                 coverage: {
                     enabled: normalizedOptions.codeCoverage,
                     exclude: normalizedOptions.codeCoverageExclude,

package/src/tools/angular/compilation/aot-compilation.js

@@ -121,10 +121,7 @@ class AotCompilation extends angular_compilation_1.AngularCompilation {
                 const updateId = encodeURIComponent(`${host.getCanonicalFileName(relativePath)}@${node.name?.text}`);
                 const updateText = angularCompiler.emitHmrUpdateModule(node);
                 // If compiler cannot generate an update for the component, prevent template updates.
-                // Also prevent template updates if $localize is directly present which also currently
-                // prevents a template update at runtime.
-                // TODO: Support localized template update modules and remove this check.
-                if (updateText === null || updateText.includes('$localize')) {
+                if (updateText === null) {
                     // Build is needed if a template cannot be updated
                     templateUpdates = undefined;
                     break;

package/src/tools/esbuild/bundler-context.js

@@ -13,6 +13,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BundlerContext = exports.BuildOutputFileType = void 0;
 const esbuild_1 = require("esbuild");
 const node_assert_1 = __importDefault(require("node:assert"));
+const node_module_1 = require("node:module");
 const node_path_1 = require("node:path");
 const load_result_cache_1 = require("./load-result-cache");
 const utils_1 = require("./utils");
@@ -198,10 +199,11 @@ class BundlerContext {
         if (this.incremental) {
             // Add input files except virtual angular files which do not exist on disk
             for (const input of Object.keys(result.metafile.inputs)) {
-                if (!isInternalAngularFile(input)) {
-                    // input file paths are always relative to the workspace root
-                    this.watchFiles.add((0, node_path_1.join)(this.workspaceRoot, input));
+                if (isInternalAngularFile(input) || isInternalBundlerFile(input)) {
+                    continue;
                 }
+                // Input file paths are always relative to the workspace root
+                this.watchFiles.add((0, node_path_1.join)(this.workspaceRoot, input));
             }
         }
         // Return if the build encountered any errors
@@ -380,3 +382,16 @@ exports.BundlerContext = BundlerContext;
 function isInternalAngularFile(file) {
     return file.startsWith('angular:');
 }
+function isInternalBundlerFile(file) {
+    // Bundler virtual files such as "<define:???>" or "<runtime>"
+    if (file[0] === '<' && file.at(-1) === '>') {
+        return true;
+    }
+    const DISABLED_BUILTIN = '(disabled):';
+    // Disabled node builtins such as "/some/path/(disabled):fs"
+    const disabledIndex = file.indexOf(DISABLED_BUILTIN);
+    if (disabledIndex >= 0) {
+        return node_module_1.builtinModules.includes(file.slice(disabledIndex + DISABLED_BUILTIN.length));
+    }
+    return false;
+}

package/src/tools/esbuild/i18n-inliner-worker.d.ts

@@ -8,7 +8,7 @@
 /**
  * The options passed to the inliner for each file request
  */
-interface InlineRequest {
+interface InlineFileRequest {
     /**
      * The filename that should be processed. The data for the file is provided to the Worker
      * during Worker initialization.
@@ -23,14 +23,35 @@ interface InlineRequest {
      */
     translation?: Record<string, unknown>;
 }
+/**
+ * The options passed to the inliner for each code request
+ */
+interface InlineCodeRequest {
+    /**
+     * The code that should be processed.
+     */
+    code: string;
+    /**
+     * The filename to use in error and warning messages for the provided code.
+     */
+    filename: string;
+    /**
+     * The locale specifier that should be used during the inlining process of the file.
+     */
+    locale: string;
+    /**
+     * The translation messages for the locale that should be used during the inlining process of the file.
+     */
+    translation?: Record<string, unknown>;
+}
 /**
  * Inlines the provided locale and translation into a JavaScript file that contains `$localize` usage.
  * This function is the main entry for the Worker's action that is called by the worker pool.
  *
  * @param request An InlineRequest object representing the options for inlining
- * @returns An array containing the inlined file and optional map content.
+ * @returns An object containing the inlined file and optional map content.
  */
-export default function inlineLocale(request: InlineRequest): Promise<{
+export default function inlineFile(request: InlineFileRequest): Promise<{
     file: string;
     code: string;
     map: string | undefined;
@@ -39,4 +60,18 @@ export default function inlineLocale(request: InlineRequest): Promise<{
         message: string;
     }[];
 }>;
+/**
+ * Inlines the provided locale and translation into JavaScript code that contains `$localize` usage.
+ * This function is a secondary entry primarily for use with component HMR update modules.
+ *
+ * @param request An InlineRequest object representing the options for inlining
+ * @returns An object containing the inlined code.
+ */
+export declare function inlineCode(request: InlineCodeRequest): Promise<{
+    output: string;
+    messages: {
+        type: "warning" | "error";
+        message: string;
+    }[];
+}>;
 export {};

package/src/tools/esbuild/i18n-inliner-worker.js

@@ -10,7 +10,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = inlineLocale;
+exports.default = inlineFile;
+exports.inlineCode = inlineCode;
 const remapping_1 = __importDefault(require("@ampproject/remapping"));
 const core_1 = require("@babel/core");
 const node_assert_1 = __importDefault(require("node:assert"));
@@ -25,9 +26,9 @@ const { files, missingTranslation, shouldOptimize } = (node_worker_threads_1.wor
  * This function is the main entry for the Worker's action that is called by the worker pool.
  *
  * @param request An InlineRequest object representing the options for inlining
- * @returns An array containing the inlined file and optional map content.
+ * @returns An object containing the inlined file and optional map content.
  */
-async function inlineLocale(request) {
+async function inlineFile(request) {
     const data = files.get(request.filename);
     (0, node_assert_1.default)(data !== undefined, `Invalid inline request for file '${request.filename}'.`);
     const code = await data.text();
@@ -40,6 +41,20 @@ async function inlineLocale(request) {
         messages: result.diagnostics.messages,
     };
 }
+/**
+ * Inlines the provided locale and translation into JavaScript code that contains `$localize` usage.
+ * This function is a secondary entry primarily for use with component HMR update modules.
+ *
+ * @param request An InlineRequest object representing the options for inlining
+ * @returns An object containing the inlined code.
+ */
+async function inlineCode(request) {
+    const result = await transformWithBabel(request.code, undefined, request);
+    return {
+        output: result.code,
+        messages: result.diagnostics.messages,
+    };
+}
 /**
  * Cached instance of the `@angular/localize/tools` module.
  * This is used to remove the need to repeatedly import the module per file translation.

package/src/tools/esbuild/i18n-inliner.d.ts

@@ -38,6 +38,11 @@ export declare class I18nInliner {
         errors: string[];
         warnings: string[];
     }>;
+    inlineTemplateUpdate(locale: string, translation: Record<string, unknown> | undefined, templateCode: string, templateId: string): Promise<{
+        code: string;
+        errors: string[];
+        warnings: string[];
+    }>;
     /**
      * Stops all active transformation tasks and shuts down all workers.
      * @returns A void promise that resolves when closing is complete.

package/src/tools/esbuild/i18n-inliner.js

@@ -201,6 +201,32 @@ class I18nInliner {
             warnings,
         };
     }
+    async inlineTemplateUpdate(locale, translation, templateCode, templateId) {
+        const hasLocalize = templateCode.includes(LOCALIZE_KEYWORD);
+        if (!hasLocalize) {
+            return {
+                code: templateCode,
+                errors: [],
+                warnings: [],
+            };
+        }
+        const { output, messages } = await this.#workerPool.run({ code: templateCode, filename: templateId, locale, translation }, { name: 'inlineCode' });
+        const errors = [];
+        const warnings = [];
+        for (const message of messages) {
+            if (message.type === 'error') {
+                errors.push(message.message);
+            }
+            else {
+                warnings.push(message.message);
+            }
+        }
+        return {
+            code: output,
+            errors,
+            warnings,
+        };
+    }
     /**
      * Stops all active transformation tasks and shuts down all workers.
      * @returns A void promise that resolves when closing is complete.

package/src/tools/esbuild/utils.js

@@ -315,7 +315,7 @@ function transformSupportedBrowsersToTargets(supportedBrowsers) {
     }
     return transformed;
 }
-const SUPPORTED_NODE_VERSIONS = '^20.11.1 || >=22.11.0';
+const SUPPORTED_NODE_VERSIONS = '^20.11.1 || ^22.11.0 || >=24.0.0';
 /**
  * Transform supported Node.js versions to esbuild target.
  * @see https://esbuild.github.io/api/#target

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

package/src/utils/worker-pool.js

@@ -17,7 +17,7 @@ class WorkerPool extends piscina_1.Piscina {
             idleTimeout: 1000,
             // Web containers do not support transferable objects with receiveOnMessagePort which
             // is used when the Atomics based wait loop is enable.
-            useAtomics: !process.versions.webcontainer,
+            atomics: process.versions.webcontainer ? 'disabled' : 'sync',
             recordTiming: false,
             ...options,
         };