@angular/build 20.0.0-next.1 → 20.0.0-next.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "20.0.0-next.1",
+  "version": "20.0.0-next.3",
   "description": "Official build system for Angular",
   "keywords": [
     "Angular CLI",
@@ -23,30 +23,31 @@
   "builders": "builders.json",
   "dependencies": {
     "@ampproject/remapping": "2.3.0",
-    "@angular-devkit/architect": "0.2000.0-next.1",
+    "@angular-devkit/architect": "0.2000.0-next.3",
     "@babel/core": "7.26.10",
     "@babel/helper-annotate-as-pure": "7.25.9",
     "@babel/helper-split-export-declaration": "7.24.7",
     "@babel/plugin-syntax-import-attributes": "7.26.0",
-    "@inquirer/confirm": "5.1.7",
+    "@inquirer/confirm": "5.1.8",
     "@vitejs/plugin-basic-ssl": "2.0.0",
     "beasties": "0.2.0",
     "browserslist": "^4.23.0",
     "esbuild": "0.25.1",
     "https-proxy-agent": "7.0.6",
     "istanbul-lib-instrument": "6.0.3",
+    "jsonc-parser": "3.3.1",
     "listr2": "8.2.5",
     "magic-string": "0.30.17",
     "mrmime": "2.0.1",
     "parse5-html-rewriting-stream": "7.0.0",
     "picomatch": "4.0.2",
-    "piscina": "4.8.0",
-    "rollup": "4.35.0",
-    "sass": "1.85.1",
+    "piscina": "4.9.2",
+    "rollup": "4.37.0",
+    "sass": "1.86.0",
     "semver": "7.7.1",
     "source-map-support": "0.5.21",
     "tinyglobby": "0.2.12",
-    "vite": "6.2.1",
+    "vite": "6.2.3",
     "watchpack": "2.4.2"
   },
   "optionalDependencies": {
@@ -56,9 +57,10 @@
     "@angular/compiler": "^20.0.0 || ^20.0.0-next.0",
     "@angular/compiler-cli": "^20.0.0 || ^20.0.0-next.0",
     "@angular/localize": "^20.0.0 || ^20.0.0-next.0",
+    "@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.1",
+    "@angular/ssr": "^20.0.0-next.3",
     "karma": "^6.4.0",
     "less": "^4.2.0",
     "ng-packagr": "^20.0.0 || ^20.0.0-next.0",
@@ -70,6 +72,9 @@
     "@angular/localize": {
       "optional": true
     },
+    "@angular/platform-browser": {
+      "optional": true
+    },
     "@angular/platform-server": {
       "optional": true
     },
@@ -101,7 +106,7 @@
   },
   "packageManager": "pnpm@9.15.6",
   "engines": {
-    "node": "^20.11.1 || >=22.0.0",
+    "node": "^20.11.1 || >=22.11.0",
     "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",
     "yarn": ">= 1.13.0"
   },

package/src/builders/application/index.js

@@ -27,6 +27,7 @@ const build_action_1 = require("./build-action");
 const execute_build_1 = require("./execute-build");
 const options_1 = require("./options");
 const results_1 = require("./results");
+const isNodeV22orHigher = Number(process.versions.node.split('.', 1)[0]) >= 22;
 async function* buildApplicationInternal(options, 
 // TODO: Integrate abort signal support into builder system
 context, extensions) {
@@ -162,7 +163,18 @@ async function* buildApplication(options, context, extensions) {
             }
             else {
                 // Copy file contents
-                await promises_1.default.copyFile(file.inputPath, fullFilePath, promises_1.default.constants.COPYFILE_FICLONE);
+                if (isNodeV22orHigher) {
+                    // Use newer `cp` API on Node.js 22+ (minimum v22 for CLI is 22.11)
+                    await promises_1.default.cp(file.inputPath, fullFilePath, {
+                        mode: promises_1.default.constants.COPYFILE_FICLONE,
+                        preserveTimestamps: true,
+                    });
+                }
+                else {
+                    // For Node.js 20 use `copyFile` (`cp` is not stable for v20)
+                    // TODO: Remove when Node.js 20 is no longer supported
+                    await promises_1.default.copyFile(file.inputPath, fullFilePath, promises_1.default.constants.COPYFILE_FICLONE);
+                }
             }
         });
         // Delete any removed files if incremental

package/src/builders/application/options.js

@@ -163,7 +163,7 @@ async function normalizeOptions(context, projectName, options, extensions) {
             route: 'shell',
         };
     }
-    const outputPath = options.outputPath;
+    const outputPath = options.outputPath ?? node_path_1.default.join(workspaceRoot, 'dist', projectName);
     const outputOptions = {
         browser: 'browser',
         server: 'server',

package/src/builders/application/schema.d.ts

@@ -128,7 +128,7 @@ export type Schema = {
     /**
      * Specify the output path relative to workspace root.
      */
-    outputPath: OutputPathUnion;
+    outputPath?: OutputPathUnion;
     /**
      * Enable and define the file watching poll time period in milliseconds.
      */
@@ -513,6 +513,10 @@ export type SourceMapClass = {
      * Output source maps for all scripts.
      */
     scripts?: boolean;
+    /**
+     * Output original source content for files within the source map.
+     */
+    sourcesContent?: boolean;
     /**
      * Output source maps for all styles.
      */

package/src/builders/application/schema.json

@@ -370,6 +370,11 @@
               "type": "boolean",
               "description": "Resolve vendor packages source maps.",
               "default": false
+            },
+            "sourcesContent": {
+              "type": "boolean",
+              "description": "Output original source content for files within the source map.",
+              "default": true
             }
           },
           "additionalProperties": false
@@ -605,7 +610,7 @@
     }
   },
   "additionalProperties": false,
-  "required": ["outputPath", "index", "browser", "tsConfig"],
+  "required": ["index", "browser", "tsConfig"],
   "definitions": {
     "assetPattern": {
       "oneOf": [

package/src/builders/application/setup-bundling.js

@@ -86,6 +86,7 @@ function createComponentStyleBundler(options, target) {
         // the same as being disabled. Disabling has the advantage of avoiding the overhead
         // of sourcemap processing.
         sourcemapOptions.styles && !sourcemapOptions.hidden ? 'linked' : false,
+        sourcesContent: sourcemapOptions.sourcesContent,
         outputNames,
         includePaths: stylePreprocessorOptions?.includePaths,
         // string[] | undefined' is not assignable to type '(Version | DeprecationOrId)[] | undefined'.

package/src/builders/karma/application_builder.js

@@ -54,6 +54,7 @@ const results_1 = require("../application/results");
 const schema_1 = require("../application/schema");
 const find_tests_1 = require("./find-tests");
 const localResolve = (0, node_module_1.createRequire)(__filename).resolve;
+const isWindows = process.platform === 'win32';
 class ApplicationBuildError extends Error {
     constructor(message) {
         super(message);
@@ -74,7 +75,13 @@ class AngularAssetsMiddleware {
         let err = null;
         try {
             const url = new URL(`http://${req.headers['host']}${req.url}`);
-            const file = this.latestBuildFiles.files[url.pathname.slice(1)];
+            // Remove the leading slash from the URL path and convert to platform specific.
+            // The latest build files will use the platform path separator.
+            let pathname = url.pathname.slice(1);
+            if (isWindows) {
+                pathname = pathname.replaceAll(path.posix.sep, path.win32.sep);
+            }
+            const file = this.latestBuildFiles.files[pathname];
             if (file?.origin === 'disk') {
                 this.serveFile(file.inputPath, undefined, res);
                 return;
@@ -350,7 +357,8 @@ async function initializeApplication(options, context, karmaOptions, transforms
     // Write test files
     await writeTestFiles(buildOutput.files, buildOptions.outputPath);
     // We need to add this to the beginning *after* the testing framework has
-    // prepended its files.
+    // prepended its files. The output path is required for each since they are
+    // added later in the test process via a plugin.
     const polyfillsFile = {
         pattern: `${outputPath}/polyfills.js`,
         included: true,
@@ -365,28 +373,29 @@ async function initializeApplication(options, context, karmaOptions, transforms
         type: 'module',
         watched: false,
     };
+    karmaOptions.basePath = outputPath;
     karmaOptions.files ??= [];
     if (options.scripts?.length) {
         // This should be more granular to support named bundles.
         // However, it replicates the behavior of the Karma Webpack-based builder.
         karmaOptions.files.push({
-            pattern: `${outputPath}/scripts.js`,
+            pattern: `scripts.js`,
             watched: false,
             type: 'js',
         });
     }
     karmaOptions.files.push(
     // Serve global setup script.
-    { pattern: `${outputPath}/${mainName}.js`, type: 'module', watched: false }, 
+    { pattern: `${mainName}.js`, type: 'module', watched: false }, 
     // Serve all source maps.
-    { pattern: `${outputPath}/*.map`, included: false, watched: false }, 
+    { pattern: `*.map`, included: false, watched: false }, 
     // These are the test entrypoints.
-    { pattern: `${outputPath}/spec-*.js`, type: 'module', watched: false });
+    { pattern: `spec-*.js`, type: 'module', watched: false });
     if (hasChunkOrWorkerFiles(buildOutput.files)) {
         karmaOptions.files.push(
         // Allow loading of chunk-* files but don't include them all on load.
         {
-            pattern: `${outputPath}/{chunk,worker}-*.js`,
+            pattern: `{chunk,worker}-*.js`,
             type: 'module',
             included: false,
             watched: false,
@@ -394,7 +403,7 @@ async function initializeApplication(options, context, karmaOptions, transforms
     }
     if (options.styles?.length) {
         // Serve CSS outputs on page load, these are the global styles.
-        karmaOptions.files.push({ pattern: `${outputPath}/*.css`, type: 'css', watched: false });
+        karmaOptions.files.push({ pattern: `*.css`, type: 'css', watched: false });
     }
     const parsedKarmaConfig = await karma.config.parseConfig(options.karmaConfig && path.resolve(context.workspaceRoot, options.karmaConfig), transforms.karmaOptions ? transforms.karmaOptions(karmaOptions) : karmaOptions, { promiseConfig: true, throwErrors: true });
     // Remove the webpack plugin/framework:

package/src/builders/karma/polyfills/init_test_bed.js

@@ -7,13 +7,12 @@
  */
 
 import { getTestBed } from '@angular/core/testing';
-import {
-  BrowserDynamicTestingModule,
-  platformBrowserDynamicTesting,
-} from '@angular/platform-browser-dynamic/testing';
+import { platformBrowser } from '@angular/platform-browser';
+import { BrowserTestingModule } from '@angular/platform-browser/testing';
 
+// TODO(alanagius): replace with `platformBrowserTesting` once https://github.com/angular/angular/pull/60480 is released.
 // Initialize the Angular testing environment.
-getTestBed().initTestEnvironment(BrowserDynamicTestingModule, platformBrowserDynamicTesting(), {
+getTestBed().initTestEnvironment(BrowserTestingModule, platformBrowser(), {
   errorOnUnknownElements: true,
   errorOnUnknownProperties: true,
 });

package/src/tools/angular/angular-host.js

@@ -118,6 +118,9 @@ function createAngularCompilerHost(typescript, compilerOptions, hostOptions, pac
     };
     host.resourceNameToFileName = function (resourceName, containingFile) {
         const resolvedPath = node_path_1.default.join(node_path_1.default.dirname(containingFile), resourceName);
+        if (!this.fileExists(resolvedPath)) {
+            return null;
+        }
         // All resource names that have template file extensions are assumed to be templates
         // TODO: Update compiler to provide the resource type to avoid extension matching here.
         if (!hostOptions.externalStylesheets || hasTemplateExtension(resolvedPath)) {

package/src/tools/esbuild/application-code-bundle.js

@@ -416,6 +416,7 @@ function getEsBuildCommonOptions(options) {
         outdir: workspaceRoot,
         outExtension: outExtension ? { '.js': `.${outExtension}` } : undefined,
         sourcemap: sourcemapOptions.scripts && (sourcemapOptions.hidden ? 'external' : true),
+        sourcesContent: sourcemapOptions.sourcesContent,
         splitting: true,
         chunkNames: options.namedChunks ? '[name]-[hash]' : 'chunk-[hash]',
         tsconfig,
@@ -430,6 +431,7 @@ function getEsBuildCommonOptions(options) {
             ...(optimizationOptions.scripts ? { 'ngDevMode': 'false' } : undefined),
             'ngJitMode': jit ? 'true' : 'false',
             'ngServerMode': 'false',
+            'ngHmrMode': options.templateUpdates ? 'true' : 'false',
         },
         loader: loaderExtensions,
         footer,

package/src/tools/esbuild/global-styles.js

@@ -35,6 +35,7 @@ function createGlobalStylesBundleOptions(options, target, initial) {
             optimization: !!optimizationOptions.styles.minify,
             inlineFonts: !!optimizationOptions.fonts.inline,
             sourcemap: !!sourcemapOptions.styles && (sourcemapOptions.hidden ? 'external' : true),
+            sourcesContent: sourcemapOptions.sourcesContent,
             preserveSymlinks,
             target,
             externalDependencies,

package/src/tools/esbuild/stylesheets/bundle-options.d.ts

@@ -16,6 +16,7 @@ export interface BundleStylesheetOptions {
     inlineFonts: boolean;
     preserveSymlinks?: boolean;
     sourcemap: boolean | 'external' | 'inline' | 'linked';
+    sourcesContent?: boolean;
     outputNames: {
         bundles: string;
         media: string;

package/src/tools/esbuild/stylesheets/bundle-options.js

@@ -47,6 +47,7 @@ function createStylesheetBundleOptions(options, cache, inlineComponentData) {
         minify: options.optimization,
         metafile: true,
         sourcemap: options.sourcemap,
+        sourcesContent: options.sourcesContent,
         outdir: options.workspaceRoot,
         write: false,
         platform: 'browser',

package/src/tools/esbuild/stylesheets/sass-language.js

@@ -71,7 +71,8 @@ exports.SassStylesheetLanguage = Object.freeze({
             if (options.containingUrl) {
                 resolveDir = (0, node_path_1.dirname)((0, node_url_1.fileURLToPath)(options.containingUrl));
             }
-            const result = await build.resolve(url, {
+            const path = url.startsWith('pkg:') ? url.slice(4) : url;
+            const result = await build.resolve(path, {
                 kind: 'import-rule',
                 resolveDir,
             });
@@ -81,8 +82,8 @@ exports.SassStylesheetLanguage = Object.freeze({
     },
 });
 function parsePackageName(url) {
-    const parts = url.split('/');
-    const hasScope = parts.length >= 2 && parts[0].startsWith('@');
+    const parts = (url.startsWith('pkg:') ? url.slice(4) : url).split('/');
+    const hasScope = parts.length >= 2 && parts[0][0] === '@';
     const [nameOrScope, nameOrFirstPath, ...pathPart] = parts;
     const packageName = hasScope ? `${nameOrScope}/${nameOrFirstPath}` : nameOrScope;
     return {

package/src/tools/esbuild/utils.js

@@ -315,7 +315,7 @@ function transformSupportedBrowsersToTargets(supportedBrowsers) {
     }
     return transformed;
 }
-const SUPPORTED_NODE_VERSIONS = '^20.11.1 || >=22.0.0';
+const SUPPORTED_NODE_VERSIONS = '^20.11.1 || >=22.11.0';
 /**
  * Transform supported Node.js versions to esbuild target.
  * @see https://esbuild.github.io/api/#target

package/src/tools/vite/middlewares/ssr-middleware.js

@@ -22,11 +22,12 @@ function createAngularSsrInternalMiddleware(server, indexHtmlTransformer) {
             // which must be processed by the runtime linker, even if they are not used.
             await (0, load_esm_1.loadEsmModule)('@angular/compiler');
             const { writeResponseToNodeResponse, createWebRequestFromNodeRequest } = await (0, load_esm_1.loadEsmModule)('@angular/ssr/node');
-            // The following is necessary because accessing the module after invalidation may result in an empty module,
-            // which can trigger a `TypeError: ɵgetOrCreateAngularServerApp is not a function` error.
-            // TODO: look into why.
-            await server.ssrLoadModule('/main.server.mjs');
             const { ɵgetOrCreateAngularServerApp } = (await server.ssrLoadModule('/main.server.mjs'));
+            // `ɵgetOrCreateAngularServerApp` can be undefined right after an error.
+            // See: https://github.com/angular/angular-cli/issues/29907
+            if (!ɵgetOrCreateAngularServerApp) {
+                return next();
+            }
             const angularServerApp = ɵgetOrCreateAngularServerApp({
                 allowStaticRouteRender: true,
             });

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

package/src/utils/normalize-source-maps.js

@@ -13,10 +13,12 @@ function normalizeSourceMaps(sourceMap) {
     const styles = typeof sourceMap === 'object' ? sourceMap.styles : sourceMap;
     const hidden = (typeof sourceMap === 'object' && sourceMap.hidden) || false;
     const vendor = (typeof sourceMap === 'object' && sourceMap.vendor) || false;
+    const sourcesContent = typeof sourceMap === 'object' ? sourceMap.sourcesContent : sourceMap;
     return {
         vendor,
         hidden,
         scripts,
         styles,
+        sourcesContent,
     };
 }

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

@@ -34,7 +34,7 @@ async function launchServer() {
             // handle request
             if ((0, utils_1.isSsrNodeRequestHandler)(reqHandler)) {
                 await reqHandler(req, res, (e) => {
-                    throw e;
+                    throw e ?? new Error(`Unable to handle request: '${req.url}'.`);
                 });
             }
             else {

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

@@ -54,7 +54,7 @@ async function prerenderPages(workspaceRoot, baseHref, appShellOptions, prerende
     // Get routes to prerender
     const { errors: extractionErrors, serializedRouteTree: serializableRouteTreeNode, appShellRoute, } = await getAllRoutes(workspaceRoot, baseHref, outputFilesForWorker, assetsReversed, appShellOptions, prerenderOptions, sourcemap, outputMode).catch((err) => {
         return {
-            errors: [`An error occurred while extracting routes.\n\n${err.stack ?? err.message ?? err}`],
+            errors: [`An error occurred while extracting routes.\n\n${err.message ?? err.stack ?? err}`],
             serializedRouteTree: [],
             appShellRoute: undefined,
         };
@@ -150,7 +150,7 @@ async function renderPages(baseHref, sourcemap, serializableRouteTreeNode, maxTh
                 }
             })
                 .catch((err) => {
-                errors.push(`An error occurred while prerendering route '${route}'.\n\n${err.stack ?? err.message ?? err.code ?? err}`);
+                errors.push(`An error occurred while prerendering route '${route}'.\n\n${err.message ?? err.stack ?? err.code ?? err}`);
                 void renderWorker.destroy();
             });
             renderingPromises.push(renderResult);
@@ -222,7 +222,7 @@ async function getAllRoutes(workspaceRoot, baseHref, outputFilesForWorker, asset
         (0, error_1.assertIsError)(err);
         return {
             errors: [
-                `An error occurred while extracting routes.\n\n${err.stack ?? err.message ?? err.code ?? err}`,
+                `An error occurred while extracting routes.\n\n${err.message ?? err.stack ?? err.code ?? err}`,
             ],
             serializedRouteTree: [],
         };