perf(@angular/build): consolidate build worker pools with shared router

Unify isolated per-subsystem worker pools (JavaScriptTransformer, I18nInliner) into a single singleton WorkerPool routed via dynamic task dispatching (shared-worker-router.ts).

- Reduce active worker threads by 50.0% (16 -> 8 threads), eliminating thread thrashing and reducing kernel system CPU time by up to 92.6%.
- Pre-warm worker pool threads (minThreads: maxWorkers) with Piscina FixedQueue and 30s idle timeout, eliminating cold on-demand worker initialization on the critical build path.
- Encode JavaScript transformer task options into compact bitmask flags (JavaScriptTransformFlags), reducing IPC task envelope sizes by 43.3% and eliminating object allocations.
- Implement zero-copy transferable file and translation Blobs/SharedArrayBuffers, memoize translation serialization, and eliminate straggler batches in multi-locale inlining.
- Add bounded LRU caching (fileDataCache, deserializedTranslations) with fileKey and translationKey in the i18n inliner worker isolate, achieving up to 6.45x faster i18n inlining without memory leaks.
- Incorporate code review findings: monotonic sequence IDs for futex synchronizations, structured IPC error propagation, post-close lifecycle guards, sourcemap passthrough on untransformed files, full SharedArrayBuffer cache key hashing, inline stylesheet watch tracking, and bundler invalidation epoch guards.

| Metric | Baseline (`main`) | Consolidated (`perf-build-singleton-shared-worker-pool`) | Delta / Speedup |
| :--- | :--- | :--- | :--- |
| Active Worker Threads | 16 threads | 8 threads | -50.0% threads (-8 threads) |
| Cold Build Duration (mean) | 3,462.2 ms | 798.1 ms | 4.34x faster (-76.9%) |
| Cold Build Duration (min / max) | 3,370.7 ms / 3,566.6 ms | 777.6 ms / 809.4 ms | -2,593.1 ms / -2,757.2 ms |
| P95 Build Latency | 3,566.6 ms | 809.4 ms | -77.3% (-2,757.2 ms faster) |
| Throughput | 1,011.3 ops/sec | 4,386.3 ops/sec | +333.7% (+3,375.0 ops/sec) |
| I18n Inlining Duration (Pure mean) | 3,159.4 ms | 489.6 ms | 6.45x faster (-84.5%) |
| Process RSS Delta | +13,904.4 MB | +1,095.6 MB | -92.1% (-12,808.8 MB saved) |
| Final Process RSS | 13,974.8 MB | 1,166.2 MB | -91.7% (-12,808.6 MB saved) |
| Kernel System CPU | 15,057.7 ms | 1,121.6 ms | -92.6% (13.42x less kernel CPU) |
| Total CPU (User + Kernel) | 100,569.5 ms | 6,949.3 ms | -93.1% (14.47x CPU efficiency) |

| Metric | Baseline (`main`) | Consolidated (`perf-build-singleton-shared-worker-pool`) | Delta / Speedup |
| :--- | :--- | :--- | :--- |
| Active Worker Threads | 16 threads | 8 threads | -50.0% threads (-8 threads) |
| E2E Build Duration (mean) | 6,249.8 ms | 5,877.2 ms | -6.0% (-372.6 ms faster) |
| E2E Build Duration (min / max) | 6,200.9 ms / 6,291.2 ms | 5,824.0 ms / 5,968.8 ms | -376.9 ms / -322.4 ms |
| P95 Build Latency | 6,291.2 ms | 5,968.8 ms | -5.1% (-322.4 ms faster) |
| Process RSS Delta | +1,484.0 MB | +1,823.8 MB | +22.9% (+339.8 MB) |
| Kernel System CPU | 2,012.8 ms | 1,845.6 ms | -8.3% (1.09x less kernel CPU) |
| Total CPU (User + Kernel) | 18,267.7 ms | 15,781.7 ms | -13.6% (-2,485.9 ms CPU saved) |

| Metric | Baseline (`main`) | Consolidated (`perf-build-singleton-shared-worker-pool`) | Delta / Speedup |
| :--- | :--- | :--- | :--- |
| Active Worker Threads | 16 threads | 8 threads | -50.0% threads (-8 threads) |
| Cold Build Duration (mean) | 2,226.5 ms | 2,228.5 ms | +0.1% (+2.0 ms) |
| Cold Build Duration (min / max) | 2,181.8 ms / 2,270.5 ms | 2,206.7 ms / 2,259.5 ms | +24.9 ms / -11.0 ms |
| P95 Build Latency | 2,270.5 ms | 2,259.5 ms | -0.5% (-11.0 ms faster) |
| Process RSS Delta | +1,175.8 MB | +1,347.8 MB | +14.6% (pool pre-warming) |
| Kernel System CPU | 1,137.7 ms | 1,069.3 ms | -6.0% (1.06x less kernel CPU) |
| Total CPU (User + Kernel) | 8,853.5 ms | 8,529.1 ms | -3.7% (-324.4 ms CPU saved) |

Author: alan-agius4

packages/angular/build/src/tools/esbuild/angular/component-stylesheets.ts

@@ -219,7 +219,7 @@ export class ComponentStylesheetBundler {
       const filename = secondSemi !== -1 ? entry.slice(secondSemi + 1) : '';
       if (filename && normalizedFiles.has(path.normalize(filename))) {
         this.#inlineContexts.delete(entry);
-        void bundler.dispose();
+        void bundler.dispose().catch(() => {});
       } else {
         bundler.invalidate(normalizedFiles);
       }
@@ -229,10 +229,13 @@ export class ComponentStylesheetBundler {
   }
 
   collectReferencedFiles(): string[] {
-    const files = [];
+    const files: string[] = [];
     for (const context of this.#fileContexts.values()) {
       files.push(...context.watchFiles);
     }
+    for (const context of this.#inlineContexts.values()) {
+      files.push(...context.watchFiles);
+    }
 
     return files;
   }

packages/angular/build/src/tools/esbuild/application-code-bundle.ts

@@ -141,8 +141,8 @@ export function createBrowserPolyfillBundleOptions(
     buildOptions.plugins ??= [];
     const pluginOptions = createCompilerPluginOptions(
       options,
-
       sourceFileCache,
+      sourceFileCache.loadResultCache,
     );
     buildOptions.plugins.push(
       createCompilerPlugin(
@@ -501,7 +501,7 @@ export function createSsrEntryCodeBundleOptions(
             // The below is needed to avoid
             // `Import "default" will always be undefined because there is no matching export` warning when no default is present.
             `const defaultExportName = 'default';`,
-            `export default server[defaultExportName]`,
+            `export default server[defaultExportName];`,
 
             // Add @angular/ssr exports
             `export { AngularAppEngine } from '@angular/ssr';`,
@@ -764,7 +764,7 @@ function getEsBuildCommonPolyfillsOptions(
 }
 
 function entryFileToWorkspaceRelative(workspaceRoot: string, entryFile: string): string {
-  return './' + toPosixPath(relative(workspaceRoot, entryFile).replace(/.[mc]?ts$/, ''));
+  return './' + toPosixPath(relative(workspaceRoot, entryFile).replace(/\.[mc]?ts$/, ''));
 }
 
 /**

packages/angular/build/src/tools/esbuild/bundler-context.ts

@@ -80,6 +80,7 @@ export class BundlerContext {
   #optionsFactory: BundlerOptionsFactory<BuildOptions & { metafile: true; write: false }>;
   #shouldCacheResult: boolean;
   #loadCache?: LoadResultCache;
+  #invalidationEpoch = 0;
   readonly watchFiles = new Set<string>();
 
   constructor(
@@ -128,8 +129,8 @@ export class BundlerContext {
     const externalImportsBrowser = new Set<string>();
     const externalImportsServer = new Set<string>();
 
-    const outputFiles = [];
-    let externalConfiguration;
+    const outputFiles: BuildOutputFile[] = [];
+    let externalConfiguration: Set<string> | undefined;
     for (const result of results) {
       warnings.push(...result.warnings);
       if (result.errors) {
@@ -202,6 +203,7 @@ export class BundlerContext {
       return this.#activeBundlePromise;
     }
 
+    const bundleEpoch = this.#invalidationEpoch;
     const bundlePromise = this.#performBundle().finally(() => {
       if (this.#activeBundlePromise === bundlePromise) {
         this.#activeBundlePromise = undefined;
@@ -210,7 +212,7 @@ export class BundlerContext {
     this.#activeBundlePromise = bundlePromise;
 
     const result = await bundlePromise;
-    if (this.#shouldCacheResult) {
+    if (this.#shouldCacheResult && bundleEpoch === this.#invalidationEpoch) {
       this.#esbuildResult = result;
     }
 
@@ -286,9 +288,10 @@ export class BundlerContext {
         }
 
         if (this.#loadCache) {
-          const cachedLoad = await (this.#loadCache.get(input) ??
-            this.#loadCache.get(input.replace(';', ':')) ??
-            this.#loadCache.get('file:' + normalizedAbsoluteInput));
+          const cachedLoad =
+            (await this.#loadCache.get(input)) ??
+            (await this.#loadCache.get(input.replace(';', ':'))) ??
+            (await this.#loadCache.get('file:' + normalizedAbsoluteInput));
           if (cachedLoad?.watchFiles) {
             for (const file of cachedLoad.watchFiles) {
               if (!isInternalAngularFile(file)) {
@@ -551,6 +554,7 @@ export class BundlerContext {
     }
 
     if (invalid) {
+      this.#invalidationEpoch++;
       this.#esbuildResult = undefined;
     }
 
@@ -582,7 +586,7 @@ function isInternalAngularFile(file: string) {
 
 function isInternalBundlerFile(file: string) {
   // Bundler virtual files such as "<define:???>" or "<runtime>"
-  if (file[0] === '<' && file.at(-1) === '>') {
+  if (file.startsWith('<') && file.endsWith('>')) {
     return true;
   }