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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "20.0.0-next.9",
+  "version": "20.0.0-rc.1",
   "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.1",
+    "@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",
+    "@inquirer/confirm": "5.1.10",
     "@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",
-    "sass": "1.87.0",
-    "semver": "7.7.1",
+    "piscina": "5.0.0",
+    "rollup": "4.40.2",
+    "sass": "1.88.0",
+    "semver": "7.7.2",
     "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.1",
     "karma": "^6.4.0",
     "less": "^4.2.0",
     "ng-packagr": "^20.0.0 || ^20.0.0-next.0",
@@ -112,9 +112,9 @@
     "type": "git",
     "url": "https://github.com/angular/angular-cli.git"
   },
-  "packageManager": "pnpm@9.15.6",
+  "packageManager": "pnpm@9.15.9",
   "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

@@ -16,6 +16,7 @@ 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 error_1 = require("../../utils/error");
 const load_esm_1 = require("../../utils/load-esm");
 const application_1 = require("../application");
 const results_1 = require("../application/results");
@@ -27,6 +28,7 @@ const options_1 = require("./options");
 /**
  * @experimental Direct usage of this function is considered experimental.
  */
+// eslint-disable-next-line max-lines-per-function
 async function* execute(options, context, extensions = {}) {
     // Determine project name from builder context target
     const projectName = context.target?.project;
@@ -55,7 +57,19 @@ async function* execute(options, context, extensions = {}) {
     }
     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');
+    let vitestNodeModule;
+    try {
+        vitestNodeModule = await (0, load_esm_1.loadEsmModule)('vitest/node');
+    }
+    catch (error) {
+        (0, error_1.assertIsError)(error);
+        if (error.code !== 'ERR_MODULE_NOT_FOUND') {
+            throw error;
+        }
+        context.logger.error('The `vitest` package was not found. Please install the package and rerun the test command.');
+        return;
+    }
+    const { startVitest } = vitestNodeModule;
     // 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')) {
@@ -65,6 +79,7 @@ async function* execute(options, context, extensions = {}) {
     const buildOptions = {
         ...buildTargetOptions,
         watch: normalizedOptions.watch,
+        incrementalResults: normalizedOptions.watch,
         outputPath,
         index: false,
         browser: undefined,
@@ -89,9 +104,28 @@ async function* execute(options, context, extensions = {}) {
         loadContent: async () => {
             const contents = [
                 // Initialize the Angular testing environment
-                `import { getTestBed } from '@angular/core/testing';`,
+                `import { NgModule } from '@angular/core';`,
+                `import { getTestBed, ɵgetCleanupHook as getCleanupHook } from '@angular/core/testing';`,
                 `import { BrowserTestingModule, platformBrowserTesting } from '@angular/platform-browser/testing';`,
-                `getTestBed().initTestEnvironment(BrowserTestingModule, platformBrowserTesting(), {`,
+                `import { beforeEach, afterEach } from 'vitest';`,
+                '',
+                normalizedOptions.providersFile
+                    ? `import providers from './${node_path_1.default
+                        .relative(projectSourceRoot, normalizedOptions.providersFile)
+                        .replace(/.[mc]?ts$/, '')
+                        .replace(/\\/g, '/')}'`
+                    : 'const providers = [];',
+                '',
+                // Same as https://github.com/angular/angular/blob/05a03d3f975771bb59c7eefd37c01fa127ee2229/packages/core/testing/src/test_hooks.ts#L21-L29
+                `beforeEach(getCleanupHook(false));`,
+                `afterEach(getCleanupHook(true));`,
+                '',
+                `@NgModule({`,
+                `  providers,`,
+                `})`,
+                `export class TestModule {}`,
+                '',
+                `getTestBed().initTestEnvironment([BrowserTestingModule, TestModule], platformBrowserTesting(), {`,
                 `  errorOnUnknownElements: true,`,
                 `  errorOnUnknownProperties: true,`,
                 '});',
@@ -106,59 +140,58 @@ async function* execute(options, context, extensions = {}) {
     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.');
+    const { browser, errors } = setupBrowserConfiguration(normalizedOptions.browsers, projectSourceRoot);
+    if (errors?.length) {
+        errors.forEach((error) => context.logger.error(error));
+        return { success: false };
+    }
+    // Add setup file entries for TestBed initialization and project polyfills
+    const setupFiles = ['init-testbed.js'];
+    if (buildTargetOptions?.polyfills?.length) {
+        setupFiles.unshift('polyfills.js');
+    }
+    try {
+        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 && result.kind !== results_1.ResultKind.Incremental) {
+                node_assert_1.default.fail('A full and/or incremental 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);
+            instance ??= await startVitest('test', undefined /* cliFilters */, undefined /* options */, {
+                test: {
+                    root: outputPath,
+                    globals: true,
+                    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,
+                    reporters: normalizedOptions.reporters ?? ['default'],
+                    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()) };
         }
-        (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');
+    }
+    finally {
+        if (normalizedOptions.watch) {
+            // Vitest will automatically close if not using watch mode
+            await instance?.close();
         }
-        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
+function findBrowserProvider(projectResolver) {
+    // One of these must be installed in the project to use browser testing
     const vitestBuiltinProviders = ['playwright', 'webdriverio'];
     for (const providerName of vitestBuiltinProviders) {
         try {
@@ -168,3 +201,35 @@ function findBrowserProvider(projectSourceRoot) {
         catch { }
     }
 }
+function setupBrowserConfiguration(browsers, projectSourceRoot) {
+    if (browsers === undefined) {
+        return {};
+    }
+    const projectResolver = (0, node_module_1.createRequire)(projectSourceRoot + '/').resolve;
+    let errors;
+    try {
+        projectResolver('@vitest/browser');
+    }
+    catch {
+        errors ??= [];
+        errors.push('The "browsers" option requires the "@vitest/browser" package to be installed within the project.' +
+            ' Please install this package and rerun the test command.');
+    }
+    const provider = findBrowserProvider(projectResolver);
+    if (!provider) {
+        errors ??= [];
+        errors.push('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.');
+    }
+    if (errors) {
+        return { errors };
+    }
+    const browser = {
+        enabled: true,
+        provider,
+        instances: browsers.map((browserName) => ({
+            browser: browserName,
+        })),
+    };
+    return { browser };
+}

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

@@ -22,5 +22,6 @@ export declare function normalizeOptions(context: BuilderContext, projectName: s
     tsConfig: string;
     reporters: string[] | undefined;
     browsers: string[] | undefined;
-    watch: boolean;
+    watch: boolean | undefined;
+    providersFile: string | undefined;
 }>;

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

@@ -26,7 +26,7 @@ async function normalizeOptions(context, projectName, options) {
     // 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;
+    const { codeCoverage, codeCoverageExclude, tsConfig, runner, reporters, browsers, watch } = options;
     return {
         // Project/workspace information
         workspaceRoot,
@@ -43,8 +43,8 @@ async function normalizeOptions(context, projectName, options) {
         tsConfig,
         reporters,
         browsers,
-        // TODO: Implement watch support
-        watch: false,
+        watch,
+        providersFile: options.providersFile && node_path_1.default.join(workspaceRoot, options.providersFile),
     };
 }
 /**

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

@@ -34,6 +34,11 @@ export type Schema = {
      * instead.
      */
     include?: string[];
+    /**
+     * TypeScript file that exports an array of Angular providers to use during test execution.
+     * The array must be a default export.
+     */
+    providersFile?: string;
     /**
      * Test runner reporters to use. Directly passed to the test runner.
      */

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

@@ -65,6 +65,11 @@
       "items": {
         "type": "string"
       }
+    },
+    "providersFile": {
+      "type": "string",
+      "description": "TypeScript file that exports an array of Angular providers to use during test execution. The array must be a default export.",
+      "minLength": 1
     }
   },
   "additionalProperties": false,

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/load-proxy-config.js

@@ -93,7 +93,7 @@ async function loadProxyConfiguration(root, proxyConfig) {
             }
             catch (e) {
                 (0, error_1.assertIsError)(e);
-                if (e.code === 'ERR_REQUIRE_ESM') {
+                if (e.code === 'ERR_REQUIRE_ESM' || e.code === 'ERR_REQUIRE_ASYNC_MODULE') {
                     // Load the ESM configuration file using the TypeScript dynamic import workaround.
                     // Once TypeScript provides support for keeping the dynamic import this workaround can be
                     // changed to a direct dynamic import.

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.1';
 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,
         };