refactor(@angular/build): use xxhash-wasm for fast non-cryptographic content hashing

Replace OpenSSL SHA-256 with xxhash-wasm for internal non-cryptographic hashing across the build system. This includes JavaScript transformer cache keys, persistent load result disk caches, incremental TypeScript compiler source file versioning, i18n inlining cache keys, stylesheet compilation configuration hashes, and dev server asset ETags. By utilizing a 64-bit non-cryptographic hash backed by WebAssembly, hashing throughput is significantly increased while eliminating V8 OpenSSL C++ context allocations and garbage collection churn during cold and incremental builds.

Author: clydin

packages/angular/build/BUILD.bazel

@@ -109,6 +109,7 @@ ts_project(
         ":node_modules/vite",
         ":node_modules/vitest",
         ":node_modules/watchpack",
+        ":node_modules/xxhash-wasm",
         "//:node_modules/@angular/common",
         "//:node_modules/@angular/compiler",
         "//:node_modules/@angular/compiler-cli",

packages/angular/build/package.json

@@ -41,7 +41,8 @@
     "source-map-support": "0.5.21",
     "tinyglobby": "0.2.17",
     "vite": "8.2.0",
-    "watchpack": "2.5.2"
+    "watchpack": "2.5.2",
+    "xxhash-wasm": "1.1.0"
   },
   "optionalDependencies": {
     "lmdb": "3.5.6"

packages/angular/build/src/builders/application/build-action.ts

@@ -15,6 +15,7 @@ import { shutdownSassWorkerPool } from '../../tools/esbuild/stylesheets/sass-lan
 import { logMessages, withNoProgress, withSpinner } from '../../tools/esbuild/utils';
 import { ChangedFiles } from '../../tools/esbuild/watcher';
 import { shouldWatchRoot } from '../../utils/environment-options';
+import { initializeHash } from '../../utils/hash';
 import { NormalizedCachedOptions } from '../../utils/normalize-cache';
 import { toPosixPath } from '../../utils/path';
 import { NormalizedApplicationBuildOptions, NormalizedOutputOptions } from './options';
@@ -78,6 +79,8 @@ export async function* runEsBuildBuildAction(
     incrementalResults,
   } = options;
 
+  await initializeHash();
+
   const withProgress: typeof withSpinner = progress ? withSpinner : withNoProgress;
 
   // Initial build

packages/angular/build/src/builders/dev-server/vite/server.ts

@@ -22,6 +22,7 @@ import {
 } from '../../../tools/vite/plugins';
 import { RolldownLoaderOption, getDepOptimizationConfig } from '../../../tools/vite/utils';
 import { loadProxyConfiguration } from '../../../utils';
+import { initializeHash } from '../../../utils/hash';
 import { type ApplicationBuilderInternalOptions, JavaScriptTransformer } from '../internal';
 import type { NormalizedDevServerOptions } from '../options';
 import { DevServerExternalResultMetadata, OutputAssetRecord, OutputFileRecord } from './utils';
@@ -147,6 +148,7 @@ export async function setupServer(
   indexHtmlTransformer?: (content: string) => Promise<string>,
   thirdPartySourcemaps = false,
 ): Promise<Vite.InlineConfig> {
+  await initializeHash();
   const { normalizePath } = (await import('vite' as string)) as typeof Vite;
 
   // Path will not exist on disk and only used to provide separate path for Vite requests

packages/angular/build/src/builders/unit-test/test-discovery.ts

@@ -6,11 +6,11 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
-import { createHash } from 'node:crypto';
 import { type PathLike, constants, promises as fs } from 'node:fs';
 import os from 'node:os';
 import { basename, dirname, extname, isAbsolute, join, relative } from 'node:path';
 import { glob, isDynamicPattern } from 'tinyglobby';
+import { calculateHash, initializeHash } from '../../utils/hash';
 import { toPosixPath } from '../../utils/path';
 
 /**
@@ -41,6 +41,7 @@ export async function findTests(
   workspaceRoot: string,
   projectSourceRoot: string,
 ): Promise<string[]> {
+  await initializeHash();
   const resolvedTestFiles = new Set<string>();
   const dynamicPatterns: string[] = [];
 
@@ -194,7 +195,7 @@ function truncateName(name: string, originalPath: string): string {
     return name;
   }
 
-  const hash = createHash('sha256').update(originalPath).digest('hex').substring(0, 8);
+  const hash = calculateHash(originalPath).substring(0, 8);
   const availableLength = MAX_FILENAME_LENGTH - hash.length - 2; // 2 for '-' separators
   const prefixLength = Math.floor(availableLength / 2);
   const suffixLength = availableLength - prefixLength;

packages/angular/build/src/builders/unit-test/test-discovery_spec.ts

@@ -6,9 +6,14 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
+import { initializeHash } from '../../utils/hash';
 import { generateNameFromPath, getTestEntrypoints } from './test-discovery';
 
 describe('getTestEntrypoints', () => {
+  beforeAll(async () => {
+    await initializeHash();
+  });
+
   const workspaceRoot = '/project';
   const projectSourceRoot = '/project/src';
   const options = { workspaceRoot, projectSourceRoot };
@@ -81,6 +86,10 @@ describe('getTestEntrypoints', () => {
 });
 
 describe('generateNameFromPath', () => {
+  beforeAll(async () => {
+    await initializeHash();
+  });
+
   const roots = ['/project/src/', '/project/'];
 
   it('should generate a dash-cased name from a simple path', () => {
@@ -127,7 +136,7 @@ describe('generateNameFromPath', () => {
 
     expect(result.length).toBeLessThanOrEqual(128);
     expect(result).toBe(
-      'a-very-long-path-that-definitely-exceeds-the-maximum-allowe-9cf40291-me-in-order-to-trigger-the-truncation-logic-in-the-function',
+      'a-very-long-path-that-definitely-exceeds-the-maximum-allowe-4af8113d-me-in-order-to-trigger-the-truncation-logic-in-the-function',
     ); // eslint-disable-line max-len
   });
 

packages/angular/build/src/tools/angular/angular-host.ts

@@ -8,9 +8,9 @@
 
 import type * as ng from '@angular/compiler-cli';
 import assert from 'node:assert';
-import { createHash } from 'node:crypto';
 import nodePath from 'node:path';
 import type ts from 'typescript';
+import { calculateHash } from '../../utils/hash';
 
 export type AngularCompilerOptions = ng.CompilerOptions;
 export type AngularCompilerHost = ng.CompilerHost;
@@ -46,7 +46,7 @@ export function ensureSourceFileVersions(program: ts.Program): void {
 
     for (const file of files) {
       if (file.version === undefined) {
-        file.version = createHash('sha256').update(file.text).digest('hex');
+        file.version = calculateHash(file.text);
       }
     }
 
@@ -227,7 +227,7 @@ export function createAngularCompilerHost(
     // For external stylesheets, create a unique identifier and store the mapping
     let externalId = hostOptions.externalStylesheets.get(resolvedPath);
     if (externalId === undefined) {
-      externalId = createHash('sha256').update(resolvedPath).digest('hex');
+      externalId = calculateHash(resolvedPath);
       hostOptions.externalStylesheets.set(resolvedPath, externalId);
     }
 

packages/angular/build/src/tools/angular/compilation/parallel-worker.ts

@@ -10,6 +10,7 @@ import type { PartialMessage } from 'esbuild';
 import assert from 'node:assert';
 import { randomUUID } from 'node:crypto';
 import { type MessagePort, receiveMessageOnPort } from 'node:worker_threads';
+import { initializeHash } from '../../../utils/hash';
 import { SourceFileCache } from '../../esbuild/angular/source-file-cache';
 import { getAndClearCumulativeDurations } from '../../esbuild/profiling';
 import type { AngularCompilation, DiagnosticModes } from './angular-compilation';
@@ -33,6 +34,7 @@ let compilation: AngularCompilation | undefined;
 const sourceFileCache = new SourceFileCache();
 
 export async function initialize(request: InitRequest) {
+  await initializeHash();
   compilation ??= request.jit
     ? new JitCompilation(request.browserOnlyBuild)
     : new AotCompilation(request.browserOnlyBuild);

packages/angular/build/src/tools/esbuild/angular/compiler-plugin.ts

@@ -18,10 +18,10 @@ import type {
   PluginBuild,
 } from 'esbuild';
 import assert from 'node:assert';
-import { createHash } from 'node:crypto';
 import { readFile } from 'node:fs/promises';
 import * as path from 'node:path';
 import { maxWorkers, useTypeChecking } from '../../../utils/environment-options';
+import { calculateHash, initializeHash } from '../../../utils/hash';
 import { AngularHostOptions } from '../../angular/angular-host';
 import { AngularCompilation, DiagnosticModes, NoopCompilation } from '../../angular/compilation';
 import { type PersistentCacheStore, createPersistentCacheStore } from '../cache';
@@ -149,6 +149,7 @@ export function createCompilerPlugin(
 
       // eslint-disable-next-line max-lines-per-function
       build.onStart(async () => {
+        await initializeHash();
         angularCompilationContext.markAsInProgress();
 
         const result: OnStartResult = {
@@ -205,11 +206,7 @@ export function createCompilerPlugin(
                 // invalid the output and force a full page reload for HMR cases. The containing file and order
                 // of the style within the containing file is used.
                 pluginOptions.externalRuntimeStyles
-                  ? createHash('sha256')
-                      .update(containingFile)
-                      .update((order ?? 0).toString())
-                      .update(className ?? '')
-                      .digest('hex')
+                  ? calculateHash(`${containingFile}${order ?? 0}${className ?? ''}`)
                   : undefined,
               );
               // Adjust result source for inline styles.

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

@@ -7,8 +7,8 @@
  */
 
 import assert from 'node:assert';
-import { createHash } from 'node:crypto';
 import path from 'node:path';
+import { createContentHash } from '../../../utils/hash';
 import { BundleContextResult, BundlerContext } from '../bundler-context';
 import { type BuildOutputFile, BuildOutputFileType } from '../bundler-files';
 import { MemoryCache } from '../cache';
@@ -103,11 +103,10 @@ export class ComponentStylesheetBundler {
   ): Promise<ComponentStylesheetResult> {
     // Use a hash of the inline stylesheet content to ensure a consistent identifier. External stylesheets will resolve
     // to the actual stylesheet file path.
-    // TODO: Consider xxhash instead for hashing
-    const id = createHash('sha256')
-      .update(data)
-      .update(externalId ?? '')
-      .digest('hex');
+    const hasher = createContentHash();
+    hasher.update(data);
+    hasher.update(externalId ?? '');
+    const id = hasher.digest();
     const entry = [language, id, filename].join(';');
 
     const bundlerContext = await this.#inlineContexts.getOrCreate(entry, () => {