@angular/build 19.0.2 → 19.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/build",
-  "version": "19.0.2",
+  "version": "19.0.3",
   "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.2",
+    "@angular-devkit/architect": "0.1900.3",
     "@babel/core": "7.26.0",
     "@babel/helper-annotate-as-pure": "7.25.9",
     "@babel/helper-split-export-declaration": "7.24.7",
@@ -57,7 +57,7 @@
     "@angular/localize": "^19.0.0",
     "@angular/platform-server": "^19.0.0",
     "@angular/service-worker": "^19.0.0",
-    "@angular/ssr": "^19.0.2",
+    "@angular/ssr": "^19.0.3",
     "less": "^4.2.0",
     "postcss": "^8.4.0",
     "tailwindcss": "^2.0.0 || ^3.0.0",

package/src/builders/application/execute-post-bundle.js

@@ -37,7 +37,7 @@ async function executePostBundleSteps(options, outputFiles, assetFiles, initialF
     const allErrors = [];
     const allWarnings = [];
     const prerenderedRoutes = {};
-    const { baseHref = '/', serviceWorker, indexHtmlOptions, optimizationOptions, sourcemapOptions, outputMode, serverEntryPoint, prerenderOptions, appShellOptions, workspaceRoot, partialSSRBuild, } = options;
+    const { baseHref = '/', serviceWorker, i18nOptions, indexHtmlOptions, optimizationOptions, sourcemapOptions, outputMode, serverEntryPoint, prerenderOptions, appShellOptions, workspaceRoot, partialSSRBuild, } = options;
     // Index HTML content without CSS inlining to be used for server rendering (AppShell, SSG and SSR).
     // NOTE: Critical CSS inlining is deliberately omitted here, as it will be handled during server rendering.
     // Additionally, when using prerendering or AppShell, the index HTML file may be regenerated.
@@ -56,7 +56,7 @@ async function executePostBundleSteps(options, outputFiles, assetFiles, initialF
     }
     // Create server manifest
     if (serverEntryPoint) {
-        const { manifestContent, serverAssetsChunks } = (0, manifest_1.generateAngularServerAppManifest)(additionalHtmlOutputFiles, outputFiles, optimizationOptions.styles.inlineCritical ?? false, undefined, locale);
+        const { manifestContent, serverAssetsChunks } = (0, manifest_1.generateAngularServerAppManifest)(additionalHtmlOutputFiles, outputFiles, optimizationOptions.styles.inlineCritical ?? false, undefined, locale, baseHref);
         additionalOutputFiles.push(...serverAssetsChunks, (0, utils_1.createOutputFile)(manifest_1.SERVER_APP_MANIFEST_FILENAME, manifestContent, bundler_context_1.BuildOutputFileType.ServerApplication));
     }
     // Pre-render (SSG) and App-shell
@@ -95,7 +95,7 @@ async function executePostBundleSteps(options, outputFiles, assetFiles, initialF
             // Regenerate the manifest to append route tree. This is only needed if SSR is enabled.
             const manifest = additionalOutputFiles.find((f) => f.path === manifest_1.SERVER_APP_MANIFEST_FILENAME);
             (0, node_assert_1.default)(manifest, `${manifest_1.SERVER_APP_MANIFEST_FILENAME} was not found in output files.`);
-            const { manifestContent, serverAssetsChunks } = (0, manifest_1.generateAngularServerAppManifest)(additionalHtmlOutputFiles, outputFiles, optimizationOptions.styles.inlineCritical ?? false, serializableRouteTreeNodeForManifest, locale);
+            const { manifestContent, serverAssetsChunks } = (0, manifest_1.generateAngularServerAppManifest)(additionalHtmlOutputFiles, outputFiles, optimizationOptions.styles.inlineCritical ?? false, serializableRouteTreeNodeForManifest, locale, baseHref);
             for (const chunk of serverAssetsChunks) {
                 const idx = additionalOutputFiles.findIndex(({ path }) => path === chunk.path);
                 if (idx === -1) {

package/src/builders/application/options.js

@@ -194,24 +194,25 @@ async function normalizeOptions(context, projectName, options, extensions) {
         let indexOutput;
         // The output file will be created within the configured output path
         if (typeof options.index === 'string') {
-            /**
-             * If SSR is activated, create a distinct entry file for the `index.html`.
-             * This is necessary because numerous server/cloud providers automatically serve the `index.html` as a static file
-             * if it exists (handling SSG).
-             *
-             * For instance, accessing `foo.com/` would lead to `foo.com/index.html` being served instead of hitting the server.
-             *
-             * This approach can also be applied to service workers, where the `index.csr.html` is served instead of the prerendered `index.html`.
-             */
-            const indexBaseName = node_path_1.default.basename(options.index);
-            indexOutput =
-                (ssrOptions || prerenderOptions) && indexBaseName === 'index.html'
-                    ? exports.INDEX_HTML_CSR
-                    : indexBaseName;
+            indexOutput = options.index;
         }
         else {
             indexOutput = options.index.output || 'index.html';
         }
+        /**
+         * If SSR is activated, create a distinct entry file for the `index.html`.
+         * This is necessary because numerous server/cloud providers automatically serve the `index.html` as a static file
+         * if it exists (handling SSG).
+         *
+         * For instance, accessing `foo.com/` would lead to `foo.com/index.html` being served instead of hitting the server.
+         *
+         * This approach can also be applied to service workers, where the `index.csr.html` is served instead of the prerendered `index.html`.
+         */
+        const indexBaseName = node_path_1.default.basename(indexOutput);
+        indexOutput =
+            (ssrOptions || prerenderOptions) && indexBaseName === 'index.html'
+                ? exports.INDEX_HTML_CSR
+                : indexBaseName;
         indexHtmlOptions = {
             input: node_path_1.default.join(workspaceRoot, typeof options.index === 'string' ? options.index : options.index.input),
             output: indexOutput,

package/src/tools/esbuild/angular/compiler-plugin.js

@@ -386,6 +386,22 @@ function createCompilerPlugin(pluginOptions, stylesheetBundler) {
                     };
                 }, true);
             }));
+            // Add a load handler if there are file replacement option entries for JSON files
+            if (pluginOptions.fileReplacements &&
+                Object.keys(pluginOptions.fileReplacements).some((value) => value.endsWith('.json'))) {
+                build.onLoad({ filter: /\.json$/ }, (0, load_result_cache_1.createCachedLoad)(pluginOptions.loadResultCache, async (args) => {
+                    const replacement = pluginOptions.fileReplacements?.[path.normalize(args.path)];
+                    if (replacement) {
+                        return {
+                            contents: await Promise.resolve().then(() => __importStar(require('fs/promises'))).then(({ readFile }) => readFile(path.normalize(replacement))),
+                            loader: 'json',
+                            watchFiles: [replacement],
+                        };
+                    }
+                    // If no replacement defined, let esbuild handle it directly
+                    return null;
+                }));
+            }
             // Setup bundling of component templates and stylesheets when in JIT mode
             if (pluginOptions.jit) {
                 (0, jit_plugin_callbacks_1.setupJitPluginCallbacks)(build, stylesheetBundler, additionalResults, pluginOptions.loadResultCache);

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

@@ -49,7 +49,7 @@ const virtual_module_plugin_1 = require("./virtual-module-plugin");
  * @returns An esbuild BuildOptions object.
  */
 function createGlobalScriptsBundleOptions(options, target, initial) {
-    const { globalScripts, optimizationOptions, outputNames, preserveSymlinks, sourcemapOptions, jsonLogs, workspaceRoot, } = options;
+    const { globalScripts, optimizationOptions, outputNames, preserveSymlinks, sourcemapOptions, jsonLogs, workspaceRoot, define, } = options;
     const namespace = 'angular:script/global';
     const entryPoints = {};
     let found = false;
@@ -83,6 +83,7 @@ function createGlobalScriptsBundleOptions(options, target, initial) {
             platform: 'neutral',
             target,
             preserveSymlinks,
+            define,
             plugins: [
                 (0, sourcemap_ignorelist_plugin_1.createSourcemapIgnorelistPlugin)(),
                 (0, virtual_module_plugin_1.createVirtualModulePlugin)({

package/src/utils/index-file/augment-index-html.js

@@ -21,7 +21,7 @@ const valid_self_closing_tags_1 = require("./valid-self-closing-tags");
  */
 // eslint-disable-next-line max-lines-per-function
 async function augmentIndexHtml(params) {
-    const { loadOutputFile, files, entrypoints, sri, deployUrl = '', lang, baseHref, html, imageDomains, } = params;
+    const { loadOutputFile, files, entrypoints, sri, deployUrl, lang, baseHref, html, imageDomains } = params;
     const warnings = [];
     const errors = [];
     let { crossOrigin = 'none' } = params;
@@ -57,7 +57,7 @@ async function augmentIndexHtml(params) {
     }
     let scriptTags = [];
     for (const [src, isModule] of scripts) {
-        const attrs = [`src="${deployUrl}${src}"`];
+        const attrs = [`src="${generateUrl(src, deployUrl)}"`];
         // This is also need for non entry-points as they may contain problematic code.
         if (isModule) {
             attrs.push('type="module"');
@@ -77,7 +77,7 @@ async function augmentIndexHtml(params) {
     let headerLinkTags = [];
     let bodyLinkTags = [];
     for (const src of stylesheets) {
-        const attrs = [`rel="stylesheet"`, `href="${deployUrl}${src}"`];
+        const attrs = [`rel="stylesheet"`, `href="${generateUrl(src, deployUrl)}"`];
         if (crossOrigin !== 'none') {
             attrs.push(`crossorigin="${crossOrigin}"`);
         }
@@ -89,7 +89,7 @@ async function augmentIndexHtml(params) {
     }
     if (params.hints?.length) {
         for (const hint of params.hints) {
-            const attrs = [`rel="${hint.mode}"`, `href="${deployUrl}${hint.url}"`];
+            const attrs = [`rel="${hint.mode}"`, `href="${generateUrl(hint.url, deployUrl)}"`];
             if (hint.mode !== 'modulepreload' && crossOrigin !== 'none') {
                 // Value is considered anonymous by the browser when not present or empty
                 attrs.push(crossOrigin === 'anonymous' ? 'crossorigin' : `crossorigin="${crossOrigin}"`);
@@ -215,6 +215,16 @@ function generateSriAttributes(content) {
     const hash = (0, node_crypto_1.createHash)(algo).update(content, 'utf8').digest('base64');
     return `integrity="${algo}-${hash}"`;
 }
+function generateUrl(value, deployUrl) {
+    if (!deployUrl) {
+        return value;
+    }
+    // Skip if root-relative, absolute or protocol relative url
+    if (/^((?:\w+:)?\/\/|data:|chrome:|\/)/.test(value)) {
+        return value;
+    }
+    return `${deployUrl}${value}`;
+}
 function updateAttribute(tag, name, value) {
     const index = tag.attrs.findIndex((a) => a.name === name);
     const newValue = { name, value };

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

package/src/utils/server-rendering/manifest.d.ts

@@ -40,12 +40,14 @@ export declare function generateAngularServerAppEngineManifest(i18nOptions: Norm
  * server-side rendering and routing.
  * @param locale - An optional string representing the locale or language code to be used for
  * the application, helping with localization and rendering content specific to the locale.
+ * @param baseHref - The base HREF for the application. This is used to set the base URL
+ * for all relative URLs in the application.
  *
  * @returns An object containing:
  * - `manifestContent`: A string of the SSR manifest content.
  * - `serverAssetsChunks`: An array of build output files containing the generated assets for the server.
  */
-export declare function generateAngularServerAppManifest(additionalHtmlOutputFiles: Map<string, BuildOutputFile>, outputFiles: BuildOutputFile[], inlineCriticalCss: boolean, routes: readonly unknown[] | undefined, locale: string | undefined): {
+export declare function generateAngularServerAppManifest(additionalHtmlOutputFiles: Map<string, BuildOutputFile>, outputFiles: BuildOutputFile[], inlineCriticalCss: boolean, routes: readonly unknown[] | undefined, locale: string | undefined, baseHref: string): {
     manifestContent: string;
     serverAssetsChunks: BuildOutputFile[];
 };

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

@@ -48,7 +48,7 @@ function escapeUnsafeChars(str) {
  * for all relative URLs in the application.
  */
 function generateAngularServerAppEngineManifest(i18nOptions, baseHref) {
-    const entryPointsContent = [];
+    const entryPoints = {};
     if (i18nOptions.shouldInline) {
         for (const locale of i18nOptions.inlineLocales) {
             const importPath = './' + (i18nOptions.flatOutput ? '' : locale + '/') + MAIN_SERVER_OUTPUT_FILENAME;
@@ -57,18 +57,22 @@ function generateAngularServerAppEngineManifest(i18nOptions, baseHref) {
             const start = localeWithBaseHref[0] === '/' ? 1 : 0;
             const end = localeWithBaseHref[localeWithBaseHref.length - 1] === '/' ? -1 : undefined;
             localeWithBaseHref = localeWithBaseHref.slice(start, end);
-            entryPointsContent.push(`['${localeWithBaseHref}', () => import('${importPath}')]`);
+            entryPoints[localeWithBaseHref] = `() => import('${importPath}')`;
         }
     }
     else {
-        entryPointsContent.push(`['', () => import('./${MAIN_SERVER_OUTPUT_FILENAME}')]`);
+        entryPoints[''] = `() => import('./${MAIN_SERVER_OUTPUT_FILENAME}')`;
     }
     const manifestContent = `
 export default {
   basePath: '${baseHref ?? '/'}',
-  entryPoints: new Map([${entryPointsContent.join(', \n')}]),
+  entryPoints: {
+    ${Object.entries(entryPoints)
+        .map(([key, value]) => `'${key}': ${value}`)
+        .join(',\n    ')}
+  },
 };
-  `;
+`;
     return manifestContent;
 }
 /**
@@ -89,29 +93,37 @@ export default {
  * server-side rendering and routing.
  * @param locale - An optional string representing the locale or language code to be used for
  * the application, helping with localization and rendering content specific to the locale.
+ * @param baseHref - The base HREF for the application. This is used to set the base URL
+ * for all relative URLs in the application.
  *
  * @returns An object containing:
  * - `manifestContent`: A string of the SSR manifest content.
  * - `serverAssetsChunks`: An array of build output files containing the generated assets for the server.
  */
-function generateAngularServerAppManifest(additionalHtmlOutputFiles, outputFiles, inlineCriticalCss, routes, locale) {
+function generateAngularServerAppManifest(additionalHtmlOutputFiles, outputFiles, inlineCriticalCss, routes, locale, baseHref) {
     const serverAssetsChunks = [];
-    const serverAssetsContent = [];
+    const serverAssets = {};
     for (const file of [...additionalHtmlOutputFiles.values(), ...outputFiles]) {
         const extension = (0, node_path_1.extname)(file.path);
         if (extension === '.html' || (inlineCriticalCss && extension === '.css')) {
             const jsChunkFilePath = `assets-chunks/${file.path.replace(/[./]/g, '_')}.mjs`;
             serverAssetsChunks.push((0, utils_1.createOutputFile)(jsChunkFilePath, `export default \`${escapeUnsafeChars(file.text)}\`;`, bundler_context_1.BuildOutputFileType.ServerApplication));
-            serverAssetsContent.push(`['${file.path}', {size: ${file.size}, hash: '${file.hash}', text: () => import('./${jsChunkFilePath}').then(m => m.default)}]`);
+            serverAssets[file.path] =
+                `{size: ${file.size}, hash: '${file.hash}', text: () => import('./${jsChunkFilePath}').then(m => m.default)}`;
         }
     }
     const manifestContent = `
 export default {
   bootstrap: () => import('./main.server.mjs').then(m => m.default),
   inlineCriticalCss: ${inlineCriticalCss},
+  baseHref: '${baseHref}',
+  locale: ${JSON.stringify(locale)},
   routes: ${JSON.stringify(routes, undefined, 2)},
-  assets: new Map([\n${serverAssetsContent.join(', \n')}\n]),
-  locale: ${locale !== undefined ? `'${locale}'` : undefined},
+  assets: {
+    ${Object.entries(serverAssets)
+        .map(([key, value]) => `'${key}': ${value}`)
+        .join(',\n    ')}
+  },
 };
 `;
     return { manifestContent, serverAssetsChunks };

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

@@ -90,7 +90,7 @@ async function prerenderPages(workspaceRoot, baseHref, appShellOptions, prerende
         };
     }
     // Render routes
-    const { errors: renderingErrors, output } = await renderPages(baseHref, sourcemap, serializableRouteTreeNodeForPrerender, maxThreads, workspaceRoot, outputFilesForWorker, assetsReversed, appShellOptions, outputMode, appShellRoute ?? appShellOptions?.route);
+    const { errors: renderingErrors, output } = await renderPages(baseHref, sourcemap, serializableRouteTreeNodeForPrerender, maxThreads, workspaceRoot, outputFilesForWorker, assetsReversed, outputMode, appShellRoute ?? appShellOptions?.route);
     errors.push(...renderingErrors);
     return {
         errors,
@@ -99,7 +99,7 @@ async function prerenderPages(workspaceRoot, baseHref, appShellOptions, prerende
         serializableRouteTreeNode,
     };
 }
-async function renderPages(baseHref, sourcemap, serializableRouteTreeNode, maxThreads, workspaceRoot, outputFilesForWorker, assetFilesForWorker, appShellOptions, outputMode, appShellRoute) {
+async function renderPages(baseHref, sourcemap, serializableRouteTreeNode, maxThreads, workspaceRoot, outputFilesForWorker, assetFilesForWorker, outputMode, appShellRoute) {
     const output = {};
     const errors = [];
     const workerExecArgv = [utils_1.IMPORT_EXEC_ARGV];
@@ -125,7 +125,7 @@ async function renderPages(baseHref, sourcemap, serializableRouteTreeNode, maxTh
         for (const { route, redirectTo, renderMode } of serializableRouteTreeNode) {
             // Remove the base href from the file output path.
             const routeWithoutBaseHref = addTrailingSlash(route).startsWith(baseHrefWithLeadingSlash)
-                ? addLeadingSlash(route.slice(baseHrefWithLeadingSlash.length - 1))
+                ? addLeadingSlash(route.slice(baseHrefWithLeadingSlash.length))
                 : route;
             const outPath = node_path_1.posix.join(removeLeadingSlash(routeWithoutBaseHref), 'index.html');
             if (typeof redirectTo === 'string') {

package/src/utils/server-rendering/routes-extractor-worker.js

@@ -21,7 +21,12 @@ async function extractRoutes() {
     const serverURL = outputMode !== undefined && hasSsrEntry ? await (0, launch_server_1.launchServer)() : launch_server_1.DEFAULT_URL;
     (0, fetch_patch_1.patchFetchToLoadInMemoryAssets)(serverURL);
     const { ɵextractRoutesAndCreateRouteTree: extractRoutesAndCreateRouteTree } = await (0, load_esm_from_memory_1.loadEsmModuleFromMemory)('./main.server.mjs');
-    const { routeTree, appShellRoute, errors } = await extractRoutesAndCreateRouteTree(serverURL, undefined /** manifest */, outputMode !== undefined /** invokeGetPrerenderParams */, outputMode === schema_1.OutputMode.Server /** includePrerenderFallbackRoutes */);
+    const { routeTree, appShellRoute, errors } = await extractRoutesAndCreateRouteTree({
+        url: serverURL,
+        invokeGetPrerenderParams: outputMode !== undefined,
+        includePrerenderFallbackRoutes: outputMode === schema_1.OutputMode.Server,
+        signal: AbortSignal.timeout(30_000),
+    });
     return {
         errors,
         appShellRoute,