@angular/build 20.1.0 → 20.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "20.1.0",
+  "version": "20.1.1",
   "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.2001.0",
+    "@angular-devkit/architect": "0.2001.1",
     "@babel/core": "7.27.7",
     "@babel/helper-annotate-as-pure": "7.27.3",
     "@babel/helper-split-export-declaration": "7.24.7",
@@ -60,7 +60,7 @@
     "@angular/platform-browser": "^20.0.0",
     "@angular/platform-server": "^20.0.0",
     "@angular/service-worker": "^20.0.0",
-    "@angular/ssr": "^20.1.0",
+    "@angular/ssr": "^20.1.1",
     "karma": "^6.4.0",
     "less": "^4.2.0",
     "ng-packagr": "^20.0.0",

package/src/builders/application/build-action.js

@@ -50,6 +50,7 @@ const bundler_context_1 = require("../../tools/esbuild/bundler-context");
 const sass_language_1 = require("../../tools/esbuild/stylesheets/sass-language");
 const utils_1 = require("../../tools/esbuild/utils");
 const environment_options_1 = require("../../utils/environment-options");
+const path_1 = require("../../utils/path");
 const results_1 = require("./results");
 // Watch workspace for package manager changes
 const packageWatchFiles = [
@@ -91,7 +92,7 @@ async function* runEsBuildBuildAction(action, options) {
             // Ignore the output and cache paths to avoid infinite rebuild cycles
             outputOptions.base,
             cacheOptions.basePath,
-            `${workspaceRoot.replace(/\\/g, '/')}/**/.*/**`,
+            `${(0, path_1.toPosixPath)(workspaceRoot)}/**/.*/**`,
         ];
         // Setup a watcher
         const { createWatcher } = await Promise.resolve().then(() => __importStar(require('../../tools/esbuild/watcher')));

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

@@ -55,6 +55,7 @@ const utils_2 = require("../../utils");
 const environment_options_1 = require("../../utils/environment-options");
 const load_esm_1 = require("../../utils/load-esm");
 const results_1 = require("../application/results");
+const schema_1 = require("../application/schema");
 const internal_1 = require("./internal");
 /**
  * Build options that are also present on the dev server but are only passed
@@ -114,6 +115,13 @@ async function* serveWithVite(serverOptions, builderName, builderAction, context
         // https://nodejs.org/api/process.html#processsetsourcemapsenabledval
         process.setSourceMapsEnabled(true);
     }
+    if (serverOptions.hmr &&
+        (browserOptions.outputHashing === schema_1.OutputHashing.All ||
+            browserOptions.outputHashing === schema_1.OutputHashing.Bundles)) {
+        serverOptions.hmr = false;
+        context.logger.warn(`Hot Module Replacement (HMR) is disabled because the 'outputHashing' option is set to '${browserOptions.outputHashing}'. ` +
+            'HMR is incompatible with this setting.');
+    }
     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 = componentsHmrCanBeUsed && environment_options_1.useComponentStyleHmr;

package/src/builders/karma/find-tests.js

@@ -12,6 +12,7 @@ exports.getTestEntrypoints = getTestEntrypoints;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const tinyglobby_1 = require("tinyglobby");
+const path_1 = require("../../utils/path");
 /* Go through all patterns and find unique list of files */
 async function findTests(include, exclude, workspaceRoot, projectSourceRoot) {
     const matchingTestsPromises = include.map((pattern) => findMatchingTests(pattern, exclude, workspaceRoot, projectSourceRoot));
@@ -39,7 +40,6 @@ function getTestEntrypoints(testFiles, { projectSourceRoot, workspaceRoot }) {
         return [uniqueName, testFile];
     }));
 }
-const normalizePath = (path) => path.replace(/\\/g, '/');
 const removeLeadingSlash = (pattern) => {
     if (pattern.charAt(0) === '/') {
         return pattern.substring(1);
@@ -62,9 +62,9 @@ function removeRoots(path, roots) {
 }
 async function findMatchingTests(pattern, ignore, workspaceRoot, projectSourceRoot) {
     // normalize pattern, glob lib only accepts forward slashes
-    let normalizedPattern = normalizePath(pattern);
+    let normalizedPattern = (0, path_1.toPosixPath)(pattern);
     normalizedPattern = removeLeadingSlash(normalizedPattern);
-    const relativeProjectRoot = normalizePath((0, node_path_1.relative)(workspaceRoot, projectSourceRoot) + '/');
+    const relativeProjectRoot = (0, path_1.toPosixPath)((0, node_path_1.relative)(workspaceRoot, projectSourceRoot) + '/');
     // remove relativeProjectRoot to support relative paths from root
     // such paths are easy to get when running scripts via IDEs
     normalizedPattern = removeRelativeRoot(normalizedPattern, relativeProjectRoot);
@@ -84,7 +84,7 @@ async function findMatchingTests(pattern, ignore, workspaceRoot, projectSourceRo
         }
     }
     // normalize the patterns in the ignore list
-    const normalizedIgnorePatternList = ignore.map((pattern) => removeRelativeRoot(removeLeadingSlash(normalizePath(pattern)), relativeProjectRoot));
+    const normalizedIgnorePatternList = ignore.map((pattern) => removeRelativeRoot(removeLeadingSlash((0, path_1.toPosixPath)(pattern)), relativeProjectRoot));
     return (0, tinyglobby_1.glob)(normalizedPattern, {
         cwd: projectSourceRoot,
         absolute: true,

package/src/builders/unit-test/builder.js

@@ -18,6 +18,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const virtual_module_plugin_1 = require("../../tools/esbuild/virtual-module-plugin");
 const error_1 = require("../../utils/error");
 const load_esm_1 = require("../../utils/load-esm");
+const path_1 = require("../../utils/path");
 const application_1 = require("../application");
 const results_1 = require("../application/results");
 const schema_1 = require("../application/schema");
@@ -73,7 +74,7 @@ async function* execute(options, context, extensions = {}) {
     // Setup test file build options based on application build target options
     const buildTargetOptions = (await context.validateOptions(await context.getTargetOptions(normalizedOptions.buildTarget), await context.getBuilderNameForTarget(normalizedOptions.buildTarget)));
     buildTargetOptions.polyfills = (0, options_1.injectTestingPolyfills)(buildTargetOptions.polyfills);
-    const outputPath = node_path_1.default.join(context.workspaceRoot, generateOutputPath());
+    const outputPath = (0, path_1.toPosixPath)(node_path_1.default.join(context.workspaceRoot, generateOutputPath()));
     const buildOptions = {
         ...buildTargetOptions,
         watch: normalizedOptions.watch,
@@ -112,10 +113,9 @@ async function* execute(options, context, extensions = {}) {
                 `import { BrowserTestingModule, platformBrowserTesting } from '@angular/platform-browser/testing';`,
                 '',
                 normalizedOptions.providersFile
-                    ? `import providers from './${node_path_1.default
+                    ? `import providers from './${(0, path_1.toPosixPath)(node_path_1.default
                         .relative(projectSourceRoot, normalizedOptions.providersFile)
-                        .replace(/.[mc]?ts$/, '')
-                        .replace(/\\/g, '/')}'`
+                        .replace(/.[mc]?ts$/, ''))}'`
                     : 'const providers = [];',
                 '',
                 // Same as https://github.com/angular/angular/blob/05a03d3f975771bb59c7eefd37c01fa127ee2229/packages/core/testing/src/test_hooks.ts#L21-L29
@@ -308,7 +308,7 @@ function generateCoverageOption(codeCoverage, workspaceRoot, outputPath) {
     return {
         enabled: true,
         excludeAfterRemap: true,
-        include: [`${node_path_1.default.relative(workspaceRoot, outputPath)}/**`],
+        include: [`${(0, path_1.toPosixPath)(node_path_1.default.relative(workspaceRoot, outputPath))}/**`],
         // Special handling for `reporter` due to an undefined value causing upstream failures
         ...(codeCoverage.reporters
             ? { reporter: codeCoverage.reporters }

package/src/private.d.ts

@@ -5,6 +5,13 @@
  * 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
  */
+/**
+ * @fileoverview
+ * Private exports intended only for use with the @angular-devkit/build-angular package.
+ * All exports are not supported for external use, do not provide SemVer guarantees, and
+ * their existence may change in any future version.
+ */
+import { createAngularCompilation } from './tools/angular/compilation';
 import { CompilerPluginOptions } from './tools/esbuild/angular/compiler-plugin';
 import { BundleStylesheetOptions } from './tools/esbuild/stylesheets/bundle-options';
 export { buildApplicationInternal } from './builders/application';
@@ -25,6 +32,8 @@ export declare function createCompilerPlugin(pluginOptions: CompilerPluginOption
 }, styleOptions: BundleStylesheetOptions & {
     inlineStyleLanguage: string;
 }): import('esbuild').Plugin;
+export type { AngularCompilation } from './tools/angular/compilation';
+export { createAngularCompilation };
 export * from './utils/bundle-calculator';
 export { checkPort } from './utils/check-port';
 export { deleteOutputDir } from './utils/delete-output-dir';

package/src/private.js

@@ -21,7 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadPostcssConfiguration = exports.generateSearchDirectories = exports.findTailwindConfiguration = exports.getTestEntrypoints = exports.findTests = exports.assertCompatibleAngularVersion = exports.getSupportedBrowsers = exports.generateBuildStatsTable = exports.augmentAppWithServiceWorker = exports.purgeStaleBuildCache = exports.createTranslationLoader = exports.loadProxyConfiguration = exports.InlineCriticalCssProcessor = exports.IndexHtmlGenerator = exports.loadTranslations = exports.createI18nOptions = exports.deleteOutputDir = exports.checkPort = exports.JavaScriptTransformer = exports.createJitResourceTransformer = exports.SourceFileCache = exports.SassWorkerImplementation = exports.transformSupportedBrowsersToTargets = exports.emitFilesToDisk = exports.serveWithVite = exports.ResultKind = exports.buildApplicationInternal = void 0;
+exports.loadPostcssConfiguration = exports.generateSearchDirectories = exports.findTailwindConfiguration = exports.getTestEntrypoints = exports.findTests = exports.assertCompatibleAngularVersion = exports.getSupportedBrowsers = exports.generateBuildStatsTable = exports.augmentAppWithServiceWorker = exports.purgeStaleBuildCache = exports.createTranslationLoader = exports.loadProxyConfiguration = exports.InlineCriticalCssProcessor = exports.IndexHtmlGenerator = exports.loadTranslations = exports.createI18nOptions = exports.deleteOutputDir = exports.checkPort = exports.createAngularCompilation = exports.JavaScriptTransformer = exports.createJitResourceTransformer = exports.SourceFileCache = exports.SassWorkerImplementation = exports.transformSupportedBrowsersToTargets = exports.emitFilesToDisk = exports.serveWithVite = exports.ResultKind = exports.buildApplicationInternal = void 0;
 exports.createCompilerPlugin = createCompilerPlugin;
 /**
  * @fileoverview
@@ -30,6 +30,7 @@ exports.createCompilerPlugin = createCompilerPlugin;
  * their existence may change in any future version.
  */
 const compilation_1 = require("./tools/angular/compilation");
+Object.defineProperty(exports, "createAngularCompilation", { enumerable: true, get: function () { return compilation_1.createAngularCompilation; } });
 const compiler_plugin_1 = require("./tools/esbuild/angular/compiler-plugin");
 const component_stylesheets_1 = require("./tools/esbuild/angular/component-stylesheets");
 // Builders

package/src/tools/angular/compilation/factory.d.ts

@@ -14,4 +14,4 @@ import type { AngularCompilation } from './angular-compilation';
  * @param browserOnlyBuild True, for browser only builds; False, for browser and server builds.
  * @returns An instance of an Angular compilation object.
  */
-export declare function createAngularCompilation(jit: boolean, browserOnlyBuild: boolean): Promise<AngularCompilation>;
+export declare function createAngularCompilation(jit: boolean, browserOnlyBuild: boolean, parallel?: boolean): Promise<AngularCompilation>;

package/src/tools/angular/compilation/factory.js

@@ -50,8 +50,8 @@ const environment_options_1 = require("../../../utils/environment-options");
  * @param browserOnlyBuild True, for browser only builds; False, for browser and server builds.
  * @returns An instance of an Angular compilation object.
  */
-async function createAngularCompilation(jit, browserOnlyBuild) {
-    if (environment_options_1.useParallelTs) {
+async function createAngularCompilation(jit, browserOnlyBuild, parallel = environment_options_1.useParallelTs) {
+    if (parallel) {
         const { ParallelCompilation } = await Promise.resolve().then(() => __importStar(require('./parallel-compilation')));
         return new ParallelCompilation(jit, browserOnlyBuild);
     }

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

@@ -20,6 +20,7 @@ const node_crypto_1 = require("node:crypto");
 const node_path_1 = require("node:path");
 const schema_1 = require("../../builders/application/schema");
 const environment_options_1 = require("../../utils/environment-options");
+const path_1 = require("../../utils/path");
 const manifest_1 = require("../../utils/server-rendering/manifest");
 const compilation_1 = require("../angular/compilation");
 const compiler_plugin_1 = require("./angular/compiler-plugin");
@@ -511,9 +512,7 @@ function getEsBuildCommonPolyfillsOptions(options, namespace, tryToResolvePolyfi
                 }));
             }
             // Generate module contents with an import statement per defined polyfill
-            let contents = polyfillPaths
-                .map((file) => `import '${file.replace(/\\/g, '/')}';`)
-                .join('\n');
+            let contents = polyfillPaths.map((file) => `import '${(0, path_1.toPosixPath)(file)}';`).join('\n');
             // The below should be done after loading `$localize` as otherwise the locale will be overridden.
             if (i18nOptions.shouldInline) {
                 // When inlining, a placeholder is used to allow the post-processing step to inject the $localize locale identifier.
@@ -534,8 +533,5 @@ function getEsBuildCommonPolyfillsOptions(options, namespace, tryToResolvePolyfi
     return buildOptions;
 }
 function entryFileToWorkspaceRelative(workspaceRoot, entryFile) {
-    return ('./' +
-        (0, node_path_1.relative)(workspaceRoot, entryFile)
-            .replace(/.[mc]?ts$/, '')
-            .replace(/\\/g, '/'));
+    return './' + (0, path_1.toPosixPath)((0, node_path_1.relative)(workspaceRoot, entryFile).replace(/.[mc]?ts$/, ''));
 }

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

@@ -12,6 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createGlobalStylesBundleOptions = createGlobalStylesBundleOptions;
 const node_assert_1 = __importDefault(require("node:assert"));
+const path_1 = require("../../utils/path");
 const bundle_options_1 = require("./stylesheets/bundle-options");
 const virtual_module_plugin_1 = require("./virtual-module-plugin");
 function createGlobalStylesBundleOptions(options, target, initial) {
@@ -66,7 +67,7 @@ function createGlobalStylesBundleOptions(options, target, initial) {
                 const files = globalStyles.find(({ name }) => name === args.path)?.files;
                 (0, node_assert_1.default)(files, `global style name should always be found [${args.path}]`);
                 return {
-                    contents: files.map((file) => `@import '${file.replace(/\\/g, '/')}';`).join('\n'),
+                    contents: files.map((file) => `@import '${(0, path_1.toPosixPath)(file)}';`).join('\n'),
                     loader: 'css',
                     resolveDir: workspaceRoot,
                 };

package/src/tools/sass/rebasing-importer.js

@@ -17,6 +17,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_url_1 = require("node:url");
 const error_1 = require("../../utils/error");
+const path_1 = require("../../utils/path");
 const lexer_1 = require("./lexer");
 /**
  * A Sass Importer base class that provides the load logic to rebase all `url()` functions
@@ -69,7 +70,7 @@ class UrlRebasingImporter {
             const rebasedPath = (0, node_path_1.relative)(this.entryDirectory, stylesheetDirectory);
             // Normalize path separators and escape characters
             // https://developer.mozilla.org/en-US/docs/Web/CSS/url#syntax
-            const rebasedUrl = rebasedPath.replace(/\\/g, '/').replace(/[()\s'"]/g, '\\$&');
+            const rebasedUrl = (0, path_1.toPosixPath)(rebasedPath).replace(/[()\s'"]/g, '\\$&');
             updatedContents ??= new magic_string_1.default(contents);
             // Always quote the URL to avoid potential downstream parsing problems
             updatedContents.update(start, end, `"${rebasedUrl}||file:${valueNormalized}"`);

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

package/src/utils/path.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * 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
+ */
+/**
+ * Converts a Windows-style file path to a POSIX-compliant path.
+ *
+ * This function replaces all backslashes (`\`) with forward slashes (`/`).
+ * It is a no-op on POSIX systems (e.g., Linux, macOS), as the conversion
+ * only runs on Windows (`win32`).
+ *
+ * @param path - The file path to convert.
+ * @returns The POSIX-compliant file path.
+ *
+ * @example
+ * ```ts
+ * // On a Windows system:
+ * toPosixPath('C:\\Users\\Test\\file.txt');
+ * // => 'C:/Users/Test/file.txt'
+ *
+ * // On a POSIX system (Linux/macOS):
+ * toPosixPath('/home/user/file.txt');
+ * // => '/home/user/file.txt'
+ * ```
+ */
+export declare function toPosixPath(path: string): string;

package/src/utils/path.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPosixPath = toPosixPath;
+const node_path_1 = require("node:path");
+const node_process_1 = require("node:process");
+const WINDOWS_PATH_SEPERATOR_REGEXP = /\\/g;
+/**
+ * Converts a Windows-style file path to a POSIX-compliant path.
+ *
+ * This function replaces all backslashes (`\`) with forward slashes (`/`).
+ * It is a no-op on POSIX systems (e.g., Linux, macOS), as the conversion
+ * only runs on Windows (`win32`).
+ *
+ * @param path - The file path to convert.
+ * @returns The POSIX-compliant file path.
+ *
+ * @example
+ * ```ts
+ * // On a Windows system:
+ * toPosixPath('C:\\Users\\Test\\file.txt');
+ * // => 'C:/Users/Test/file.txt'
+ *
+ * // On a POSIX system (Linux/macOS):
+ * toPosixPath('/home/user/file.txt');
+ * // => '/home/user/file.txt'
+ * ```
+ */
+function toPosixPath(path) {
+    return node_process_1.platform === 'win32' ? path.replace(WINDOWS_PATH_SEPERATOR_REGEXP, node_path_1.posix.sep) : path;
+}

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

@@ -13,6 +13,7 @@ const node_path_1 = require("node:path");
 const schema_1 = require("../../builders/application/schema");
 const bundler_context_1 = require("../../tools/esbuild/bundler-context");
 const error_1 = require("../error");
+const path_1 = require("../path");
 const url_1 = require("../url");
 const worker_pool_1 = require("../worker-pool");
 const utils_1 = require("./esm-in-memory-loader/utils");
@@ -49,7 +50,7 @@ async function prerenderPages(workspaceRoot, baseHref, appShellOptions, prerende
     serverBundlesSourceMaps.clear();
     const assetsReversed = {};
     for (const { source, destination } of assets) {
-        assetsReversed[addLeadingSlash(destination.replace(/\\/g, node_path_1.posix.sep))] = source;
+        assetsReversed[addLeadingSlash((0, path_1.toPosixPath)(destination))] = source;
     }
     // Get routes to prerender
     const { errors: extractionErrors, serializedRouteTree: serializableRouteTreeNode, appShellRoute, } = await getAllRoutes(workspaceRoot, baseHref, outputFilesForWorker, assetsReversed, appShellOptions, prerenderOptions, sourcemap, outputMode).catch((err) => {

package/src/utils/service-worker.js

@@ -49,6 +49,7 @@ const path = __importStar(require("node:path"));
 const bundler_context_1 = require("../tools/esbuild/bundler-context");
 const error_1 = require("./error");
 const load_esm_1 = require("./load-esm");
+const path_1 = require("./path");
 class CliFilesystem {
     fs;
     base;
@@ -81,7 +82,7 @@ class CliFilesystem {
             const stats = await this.fs.stat(entryPath);
             if (stats.isFile()) {
                 // Uses posix paths since the service worker expects URLs
-                items.push('/' + path.relative(this.base, entryPath).replace(/\\/g, '/'));
+                items.push('/' + (0, path_1.toPosixPath)(path.relative(this.base, entryPath)));
             }
             else if (stats.isDirectory()) {
                 subdirectories.push(entryPath);
@@ -98,11 +99,11 @@ class ResultFilesystem {
     constructor(outputFiles, assetFiles) {
         for (const file of outputFiles) {
             if (file.type === bundler_context_1.BuildOutputFileType.Media || file.type === bundler_context_1.BuildOutputFileType.Browser) {
-                this.fileReaders.set('/' + file.path.replace(/\\/g, '/'), async () => file.contents);
+                this.fileReaders.set('/' + (0, path_1.toPosixPath)(file.path), async () => file.contents);
             }
         }
         for (const file of assetFiles) {
-            this.fileReaders.set('/' + file.destination.replace(/\\/g, '/'), () => node_fs_1.promises.readFile(file.source));
+            this.fileReaders.set('/' + (0, path_1.toPosixPath)(file.destination), () => node_fs_1.promises.readFile(file.source));
         }
     }
     async list(dir) {