@angular/build 19.0.0-next.3 → 19.0.0-next.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "19.0.0-next.3",
+  "version": "19.0.0-next.4",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,7 +23,7 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.1900.0-next.3",
+    "@angular-devkit/architect": "0.1900.0-next.4",
     "@babel/core": "7.25.2",
     "@babel/helper-annotate-as-pure": "7.24.7",
     "@babel/helper-split-export-declaration": "7.24.7",
@@ -53,7 +53,7 @@
     "@angular/localize": "^19.0.0-next.0",
     "@angular/platform-server": "^19.0.0-next.0",
     "@angular/service-worker": "^19.0.0-next.0",
-    "@angular/ssr": "^19.0.0-next.3",
+    "@angular/ssr": "^19.0.0-next.4",
     "less": "^4.2.0",
     "postcss": "^8.4.0",
     "tailwindcss": "^2.0.0 || ^3.0.0",

package/src/builders/dev-server/vite-server.d.ts

@@ -20,6 +20,10 @@ interface OutputFileRecord {
     servable: boolean;
     type: BuildOutputFileType;
 }
+interface DevServerExternalResultMetadata extends Omit<ExternalResultMetadata, 'explicit'> {
+    explicitBrowser: string[];
+    explicitServer: string[];
+}
 export type BuilderAction = (options: ApplicationBuilderInternalOptions, context: BuilderContext, plugins?: Plugin[]) => AsyncIterable<Result>;
 export declare function serveWithVite(serverOptions: NormalizedDevServerOptions, builderName: string, builderAction: BuilderAction, context: BuilderContext, transformers?: {
     indexHtml?: (content: string) => Promise<string>;
@@ -27,6 +31,6 @@ export declare function serveWithVite(serverOptions: NormalizedDevServerOptions,
     middleware?: Connect.NextHandleFunction[];
     buildPlugins?: Plugin[];
 }): AsyncIterableIterator<DevServerBuilderOutput>;
-export declare function setupServer(serverOptions: NormalizedDevServerOptions, outputFiles: Map<string, OutputFileRecord>, assets: Map<string, string>, preserveSymlinks: boolean | undefined, externalMetadata: ExternalResultMetadata, ssr: boolean, prebundleTransformer: JavaScriptTransformer, target: string[], zoneless: boolean, prebundleLoaderExtensions: EsbuildLoaderOption | undefined, extensionMiddleware?: Connect.NextHandleFunction[], indexHtmlTransformer?: (content: string) => Promise<string>, thirdPartySourcemaps?: boolean): Promise<InlineConfig>;
+export declare function setupServer(serverOptions: NormalizedDevServerOptions, outputFiles: Map<string, OutputFileRecord>, assets: Map<string, string>, preserveSymlinks: boolean | undefined, externalMetadata: DevServerExternalResultMetadata, ssr: boolean, prebundleTransformer: JavaScriptTransformer, target: string[], zoneless: boolean, prebundleLoaderExtensions: EsbuildLoaderOption | undefined, extensionMiddleware?: Connect.NextHandleFunction[], indexHtmlTransformer?: (content: string) => Promise<string>, thirdPartySourcemaps?: boolean): Promise<InlineConfig>;
 type EsbuildLoaderOption = Exclude<DepOptimizationConfig['esbuildOptions'], undefined>['loader'];
 export {};

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

@@ -107,7 +107,8 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
     const externalMetadata = {
         implicitBrowser: [],
         implicitServer: [],
-        explicit: [],
+        explicitBrowser: [],
+        explicitServer: [],
     };
     // Add cleanup logic via a builder teardown.
     let deferred;
@@ -187,15 +188,18 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
                 requiresServerRestart = implicitServerFiltered.some((dep) => !previousImplicitServer.has(dep));
             }
             // Empty Arrays to avoid growing unlimited with every re-build.
-            externalMetadata.explicit.length = 0;
+            externalMetadata.explicitBrowser.length = 0;
+            externalMetadata.explicitServer.length = 0;
             externalMetadata.implicitServer.length = 0;
             externalMetadata.implicitBrowser.length = 0;
-            externalMetadata.explicit.push(...explicit);
+            externalMetadata.explicitBrowser.push(...explicit);
+            externalMetadata.explicitServer.push(...explicit, ...nodeJsBuiltinModules);
             externalMetadata.implicitServer.push(...implicitServerFiltered);
             externalMetadata.implicitBrowser.push(...implicitBrowserFiltered);
             // The below needs to be sorted as Vite uses these options are part of the hashing invalidation algorithm.
             // See: https://github.com/vitejs/vite/blob/0873bae0cfe0f0718ad2f5743dd34a17e4ab563d/packages/vite/src/node/optimizer/index.ts#L1203-L1239
-            externalMetadata.explicit.sort();
+            externalMetadata.explicitBrowser.sort();
+            externalMetadata.explicitServer.sort();
             externalMetadata.implicitServer.sort();
             externalMetadata.implicitBrowser.sort();
         }
@@ -433,18 +437,18 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
             },
             // This is needed when `externalDependencies` is used to prevent Vite load errors.
             // NOTE: If Vite adds direct support for externals, this can be removed.
-            preTransformRequests: externalMetadata.explicit.length === 0,
+            preTransformRequests: externalMetadata.explicitBrowser.length === 0,
         },
         ssr: {
             // Note: `true` and `/.*/` have different sematics. When true, the `external` option is ignored.
             noExternal: /.*/,
             // Exclude any Node.js built in module and provided dependencies (currently build defined externals)
-            external: externalMetadata.explicit,
+            external: externalMetadata.explicitServer,
             optimizeDeps: getDepOptimizationConfig({
                 // Only enable with caching since it causes prebundle dependencies to be cached
                 disabled: serverOptions.prebundle === false,
                 // Exclude any explicitly defined dependencies (currently build defined externals and node.js built-ins)
-                exclude: externalMetadata.explicit,
+                exclude: externalMetadata.explicitServer,
                 // Include all implict dependencies from the external packages internal option
                 include: externalMetadata.implicitServer,
                 ssr: true,
@@ -463,19 +467,19 @@ async function setupServer(serverOptions, outputFiles, assets, preserveSymlinks,
                 outputFiles,
                 assets,
                 ssr,
-                external: externalMetadata.explicit,
+                external: externalMetadata.explicitBrowser,
                 indexHtmlTransformer,
                 extensionMiddleware,
                 normalizePath,
             }),
-            (0, id_prefix_plugin_1.createRemoveIdPrefixPlugin)(externalMetadata.explicit),
+            (0, id_prefix_plugin_1.createRemoveIdPrefixPlugin)(externalMetadata.explicitBrowser),
         ],
         // Browser only optimizeDeps. (This does not run for SSR dependencies).
         optimizeDeps: getDepOptimizationConfig({
             // Only enable with caching since it causes prebundle dependencies to be cached
             disabled: serverOptions.prebundle === false,
             // Exclude any explicitly defined dependencies (currently build defined externals)
-            exclude: externalMetadata.explicit,
+            exclude: externalMetadata.explicitBrowser,
             // Include all implict dependencies from the external packages internal option
             include: externalMetadata.implicitBrowser,
             ssr: false,

package/src/tools/angular/compilation/parallel-compilation.d.ts

@@ -22,7 +22,7 @@ export declare class ParallelCompilation extends AngularCompilation {
     #private;
     readonly jit: boolean;
     constructor(jit: boolean);
-    initialize(tsconfig: string, hostOptions: AngularHostOptions, compilerOptionsTransformer?: ((compilerOptions: CompilerOptions) => CompilerOptions) | undefined): Promise<{
+    initialize(tsconfig: string, hostOptions: AngularHostOptions, compilerOptionsTransformer?: (compilerOptions: CompilerOptions) => CompilerOptions): Promise<{
         affectedFiles: ReadonlySet<SourceFile>;
         compilerOptions: CompilerOptions;
         referencedFiles: readonly string[];

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

@@ -40,6 +40,11 @@ class ParallelCompilation extends angular_compilation_1.AngularCompilation {
             useAtomics: !process.versions.webcontainer,
             filename: localRequire.resolve('./parallel-worker'),
             recordTiming: false,
+            env: {
+                ...process.env,
+                // Enable compile code caching if enabled for the main process (only exists on Node.js v22.8+)
+                'NODE_COMPILE_CACHE': (0, node_module_1.getCompileCacheDir)?.(),
+            },
         });
     }
     initialize(tsconfig, hostOptions, compilerOptionsTransformer) {

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

@@ -13,6 +13,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.JavaScriptTransformer = void 0;
 const node_crypto_1 = require("node:crypto");
 const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
 const piscina_1 = __importDefault(require("piscina"));
 /**
  * A class that performs transformation of JavaScript files and raw data.
@@ -48,6 +49,11 @@ class JavaScriptTransformer {
             // Shutdown idle threads after 1 second of inactivity
             idleTimeout: 1000,
             recordTiming: false,
+            env: {
+                ...process.env,
+                // Enable compile code caching if enabled for the main process (only exists on Node.js v22.8+)
+                'NODE_COMPILE_CACHE': (0, node_module_1.getCompileCacheDir)?.(),
+            },
         });
         return this.#workerPool;
     }

package/src/tools/sass/sass-service.js

@@ -64,6 +64,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SassWorkerImplementation = void 0;
 const node_assert_1 = __importDefault(require("node:assert"));
+const node_module_1 = require("node:module");
 const node_url_1 = require("node:url");
 const node_worker_threads_1 = require("node:worker_threads");
 const piscina_1 = require("piscina");
@@ -100,6 +101,11 @@ class SassWorkerImplementation {
             // Shutdown idle threads after 1 second of inactivity
             idleTimeout: 1000,
             recordTiming: false,
+            env: {
+                ...process.env,
+                // Enable compile code caching if enabled for the main process (only exists on Node.js v22.8+)
+                'NODE_COMPILE_CACHE': (0, node_module_1.getCompileCacheDir)?.(),
+            },
         });
         return this.#workerPool;
     }

package/src/tools/sass/worker.d.ts

@@ -5,6 +5,7 @@
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.dev/license
  */
+import { RawSourceMap } from '@ampproject/remapping';
 import { MessagePort } from 'node:worker_threads';
 import { SourceSpan, StringOptions } from 'sass';
 import type { SerializableWarningMessage } from './sass-service';
@@ -38,45 +39,25 @@ interface RenderRequestMessage {
      */
     rebase: boolean;
 }
-export default function renderSassStylesheet(request: RenderRequestMessage): Promise<{
+interface RenderResult {
     warnings: SerializableWarningMessage[] | undefined;
     result: {
-        loadedUrls: string[];
         css: string;
-        sourceMap?: import("source-map-js").RawSourceMap;
+        loadedUrls: string[];
+        sourceMap?: RawSourceMap;
     };
-    error?: undefined;
-} | {
+}
+interface RenderError {
     warnings: SerializableWarningMessage[] | undefined;
     error: {
-        span: Omit<SourceSpan, "url"> & {
+        message: string;
+        stack?: string;
+        span?: Omit<SourceSpan, 'url'> & {
             url?: string;
         };
-        message: string;
-        stack: string | undefined;
-        sassMessage: string;
-        sassStack: string;
-    };
-    result?: undefined;
-} | {
-    warnings: SerializableWarningMessage[] | undefined;
-    error: {
-        message: string;
-        stack: string | undefined;
-        span?: undefined;
-        sassMessage?: undefined;
-        sassStack?: undefined;
+        sassMessage?: string;
+        sassStack?: string;
     };
-    result?: undefined;
-} | {
-    warnings: SerializableWarningMessage[] | undefined;
-    error: {
-        message: string;
-        span?: undefined;
-        stack?: undefined;
-        sassMessage?: undefined;
-        sassStack?: undefined;
-    };
-    result?: undefined;
-}>;
+}
+export default function renderSassStylesheet(request: RenderRequestMessage): Promise<RenderResult | RenderError>;
 export {};

package/src/tools/sass/worker.js

@@ -95,6 +95,7 @@ async function renderSassStylesheet(request) {
             warnings,
             result: {
                 ...result,
+                sourceMap: result.sourceMap,
                 // URL is not serializable so to convert to string here and back to URL in the parent.
                 loadedUrls: result.loadedUrls.map((p) => (0, node_url_1.fileURLToPath)(p)),
             },

package/src/typings.d.ts

@@ -17,3 +17,10 @@
 declare module 'esbuild' {
   export * from 'esbuild-wasm';
 }
+
+/**
+ * Augment the Node.js module builtin types to support the v22.8+ compile cache functions
+ */
+declare module 'node:module' {
+  function getCompileCacheDir(): string | undefined;
+}

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

package/src/utils/server-rendering/manifest.js

@@ -70,15 +70,13 @@ function generateAngularServerAppManifest(additionalHtmlOutputFiles, outputFiles
     for (const file of [...additionalHtmlOutputFiles.values(), ...outputFiles]) {
         if (file.path === options_1.INDEX_HTML_SERVER ||
             file.path === options_1.INDEX_HTML_CSR ||
-            file.path.endsWith('.css')) {
+            (inlineCriticalCss && file.path.endsWith('.css'))) {
             serverAssetsContent.push(`['${file.path}', async () => ${JSON.stringify(file.text)}]`);
         }
     }
     const manifestContent = `
-import bootstrap from './main.server.mjs';
-
 export default {
-  bootstrap: () => bootstrap,
+  bootstrap: () => import('./main.server.mjs').then(m => m.default),
   inlineCriticalCss: ${inlineCriticalCss},
   routes: ${JSON.stringify(routes, undefined, 2)},
   assets: new Map([${serverAssetsContent.join(', \n')}]),