@angular/build 20.0.0-rc.3 → 20.0.0-rc.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "20.0.0-rc.3",
+  "version": "20.0.0-rc.4",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,15 +23,15 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.2000.0-rc.3",
+    "@angular-devkit/architect": "0.2000.0-rc.4",
     "@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.10",
     "@vitejs/plugin-basic-ssl": "2.0.0",
-    "beasties": "0.3.3",
+    "beasties": "0.3.4",
     "browserslist": "^4.23.0",
-    "esbuild": "0.25.4",
+    "esbuild": "0.25.5",
     "https-proxy-agent": "7.0.6",
     "istanbul-lib-instrument": "6.0.3",
     "jsonc-parser": "3.3.1",
@@ -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-rc.3",
+    "@angular/ssr": "^20.0.0-rc.4",
     "karma": "^6.4.0",
     "less": "^4.2.0",
     "ng-packagr": "^20.0.0 || ^20.0.0-next.0",

package/src/builders/dev-server/vite-server.js

@@ -114,13 +114,12 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
         // https://nodejs.org/api/process.html#processsetsourcemapsenabledval
         process.setSourceMapsEnabled(true);
     }
+    const componentsHmrCanBeUsed = browserOptions.aot && serverOptions.liveReload && serverOptions.hmr;
     // Enable to support link-based component style hot reloading (`NG_HMR_CSTYLES=1` can be used to enable)
-    browserOptions.externalRuntimeStyles =
-        serverOptions.liveReload && serverOptions.hmr && environment_options_1.useComponentStyleHmr;
+    browserOptions.externalRuntimeStyles = componentsHmrCanBeUsed && environment_options_1.useComponentStyleHmr;
     // Enable to support component template hot replacement (`NG_HMR_TEMPLATE=0` can be used to disable selectively)
     // This will also replace file-based/inline styles as code if external runtime styles are not enabled.
-    browserOptions.templateUpdates =
-        serverOptions.liveReload && serverOptions.hmr && environment_options_1.useComponentTemplateHmr;
+    browserOptions.templateUpdates = componentsHmrCanBeUsed && environment_options_1.useComponentTemplateHmr;
     browserOptions.incrementalResults = true;
     // Setup the prebundling transformer that will be shared across Vite prebundling requests
     const prebundleTransformer = new internal_1.JavaScriptTransformer(

package/src/tools/esbuild/angular/compiler-plugin.d.ts

@@ -14,6 +14,12 @@ export interface CompilerPluginOptions {
     sourcemap: boolean | 'external';
     tsconfig: string;
     jit?: boolean;
+    /**
+     * Include class metadata and JIT information in built code.
+     * The Angular TestBed APIs require additional metadata for the Angular aspects of the application
+     * such as Components, Modules, Pipes, etc.
+     * TestBed may also leverage JIT capabilities during testing (e.g., overrideComponent).
+     */
     includeTestMetadata?: boolean;
     advancedOptimizations?: boolean;
     thirdPartySourcemaps?: boolean;

package/src/tools/esbuild/angular/compiler-plugin.js

@@ -89,7 +89,7 @@ function createCompilerPlugin(pluginOptions, compilationOrFactory, stylesheetBun
                 sourcemap: !!pluginOptions.sourcemap,
                 thirdPartySourcemaps: pluginOptions.thirdPartySourcemaps,
                 advancedOptimizations: pluginOptions.advancedOptimizations,
-                jit: pluginOptions.jit,
+                jit: pluginOptions.jit || pluginOptions.includeTestMetadata,
             }, environment_options_1.maxWorkers, cacheStore?.createCache('jstransformer'));
             // Setup defines based on the values used by the Angular compiler-cli
             build.initialOptions.define ??= {};
@@ -553,6 +553,7 @@ function createCompilerOptionsTransformer(setupWarnings, pluginOptions, preserve
             externalRuntimeStyles: pluginOptions.externalRuntimeStyles,
             _enableHmr: !!pluginOptions.templateUpdates,
             supportTestBed: !!pluginOptions.includeTestMetadata,
+            supportJitMode: !!pluginOptions.includeTestMetadata,
         };
     };
 }

package/src/tools/esbuild/javascript-transformer-worker.js

@@ -51,6 +51,13 @@ const piscina_1 = __importDefault(require("piscina"));
 const load_esm_1 = require("../../utils/load-esm");
 const textDecoder = new TextDecoder();
 const textEncoder = new TextEncoder();
+/**
+ * The function name prefix for all Angular partial compilation functions.
+ * Used to determine if linking of a JavaScript file is required.
+ * If any additional declarations are added or otherwise changed in the linker,
+ * the names MUST begin with this prefix.
+ */
+const LINKER_DECLARATION_PREFIX = 'ɵɵngDeclare';
 async function transformJavaScript(request) {
     const { filename, data, ...options } = request;
     const textData = typeof data === 'string' ? data : textDecoder.decode(data);
@@ -62,10 +69,6 @@ async function transformJavaScript(request) {
  * Cached instance of the compiler-cli linker's createEs2015LinkerPlugin function.
  */
 let linkerPluginCreator;
-/**
- * Cached instance of the compiler-cli linker's needsLinking function.
- */
-let needsLinking;
 async function transformWithBabel(filename, data, options) {
     const shouldLink = !options.skipLinker && (await requiresLinking(filename, data));
     const useInputSourcemap = options.sourcemap &&
@@ -120,14 +123,10 @@ async function requiresLinking(path, source) {
     if (/[\\/]@angular[\\/](?:compiler|core)|\.tsx?$/.test(path)) {
         return false;
     }
-    if (!needsLinking) {
-        // Load ESM `@angular/compiler-cli/linker` 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.
-        const linkerModule = await (0, load_esm_1.loadEsmModule)('@angular/compiler-cli/linker');
-        needsLinking = linkerModule.needsLinking;
-    }
-    return needsLinking(path, source);
+    // Check if the source code includes one of the declaration functions.
+    // There is a low chance of a false positive but the names are fairly unique
+    // and the result would be an unnecessary no-op additional plugin pass.
+    return source.includes(LINKER_DECLARATION_PREFIX);
 }
 async function createLinkerPlugin(options) {
     linkerPluginCreator ??= (await (0, load_esm_1.loadEsmModule)('@angular/compiler-cli/linker/babel')).createEs2015LinkerPlugin;

package/src/tools/esbuild/javascript-transformer.js

@@ -39,6 +39,9 @@ class JavaScriptTransformer {
         this.#fileCacheKeyBase = Buffer.from(JSON.stringify(this.#commonOptions), 'utf-8');
     }
     #ensureWorkerPool() {
+        if (this.#workerPool) {
+            return this.#workerPool;
+        }
         const workerPoolOptions = {
             filename: require.resolve('./javascript-transformer-worker'),
             maxThreads: this.maxThreads,
@@ -48,7 +51,7 @@ class JavaScriptTransformer {
         if (process.execArgv.length !== filteredExecArgv.length) {
             workerPoolOptions.execArgv = filteredExecArgv;
         }
-        this.#workerPool ??= new worker_pool_1.WorkerPool(workerPoolOptions);
+        this.#workerPool = new worker_pool_1.WorkerPool(workerPoolOptions);
         return this.#workerPool;
     }
     /**

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