@angular/build 19.0.0-next.6 → 19.0.0-next.8

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

@@ -7,7 +7,9 @@
  */
 import { NormalizedApplicationBuildOptions } from '../../builders/application/options';
 import type { BuildOutputFile } from '../../tools/esbuild/bundler-context';
+import { PrerenderedRoutesRecord } from '../../tools/esbuild/bundler-execution-result';
 export declare const SERVER_APP_MANIFEST_FILENAME = "angular-app-manifest.mjs";
+export declare const SERVER_APP_ENGINE_MANIFEST_FILENAME = "angular-app-engine-manifest.mjs";
 /**
  * Generates the server manifest for the App Engine environment.
  *
@@ -19,9 +21,10 @@ export declare const SERVER_APP_MANIFEST_FILENAME = "angular-app-manifest.mjs";
  * includes settings for inlining locales and determining the output structure.
  * @param baseHref - The base HREF for the application. This is used to set the base URL
  * for all relative URLs in the application.
+ * @param perenderedRoutes - A record mapping static paths to their associated data.
  * @returns A string representing the content of the SSR server manifest for App Engine.
  */
-export declare function generateAngularServerAppEngineManifest(i18nOptions: NormalizedApplicationBuildOptions['i18nOptions'], baseHref: string | undefined): string;
+export declare function generateAngularServerAppEngineManifest(i18nOptions: NormalizedApplicationBuildOptions['i18nOptions'], baseHref: string | undefined, perenderedRoutes?: PrerenderedRoutesRecord | undefined): string;
 /**
  * Generates the server manifest for the standard Node.js environment.
  *
@@ -38,7 +41,10 @@ export declare function generateAngularServerAppEngineManifest(i18nOptions: Norm
  * in the server-side rendered pages.
  * @param routes - An optional array of route definitions for the application, used for
  * 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.
+ *
  * @returns A string representing the content of the SSR server manifest for the Node.js
  * environment.
  */
-export declare function generateAngularServerAppManifest(additionalHtmlOutputFiles: Map<string, BuildOutputFile>, outputFiles: BuildOutputFile[], inlineCriticalCss: boolean, routes: readonly unknown[] | undefined): string;
+export declare function generateAngularServerAppManifest(additionalHtmlOutputFiles: Map<string, BuildOutputFile>, outputFiles: BuildOutputFile[], inlineCriticalCss: boolean, routes: readonly unknown[] | undefined, locale: string | undefined): string;

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

@@ -7,12 +7,40 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SERVER_APP_MANIFEST_FILENAME = void 0;
+exports.SERVER_APP_ENGINE_MANIFEST_FILENAME = exports.SERVER_APP_MANIFEST_FILENAME = void 0;
 exports.generateAngularServerAppEngineManifest = generateAngularServerAppEngineManifest;
 exports.generateAngularServerAppManifest = generateAngularServerAppManifest;
 const options_1 = require("../../builders/application/options");
 exports.SERVER_APP_MANIFEST_FILENAME = 'angular-app-manifest.mjs';
+exports.SERVER_APP_ENGINE_MANIFEST_FILENAME = 'angular-app-engine-manifest.mjs';
 const MAIN_SERVER_OUTPUT_FILENAME = 'main.server.mjs';
+/**
+ * A mapping of unsafe characters to their escaped Unicode equivalents.
+ */
+const UNSAFE_CHAR_MAP = {
+    '<': '\\u003C',
+    '>': '\\u003E',
+    '/': '\\u002F',
+    '\\': '\\\\',
+    '\b': '\\b',
+    '\f': '\\f',
+    '\n': '\\n',
+    '\r': '\\r',
+    '\t': '\\t',
+    '\0': '\\0',
+    '\u2028': '\\u2028',
+    '\u2029': '\\u2029',
+};
+/**
+ * Escapes unsafe characters in a given string by replacing them with
+ * their Unicode escape sequences.
+ *
+ * @param str - The string to be escaped.
+ * @returns The escaped string where unsafe characters are replaced.
+ */
+function escapeUnsafeChars(str) {
+    return str.replace(/[<>\b\f\n\r\t\0\u2028\u2029]/g, (c) => UNSAFE_CHAR_MAP[c]);
+}
 /**
  * Generates the server manifest for the App Engine environment.
  *
@@ -24,26 +52,43 @@ const MAIN_SERVER_OUTPUT_FILENAME = 'main.server.mjs';
  * includes settings for inlining locales and determining the output structure.
  * @param baseHref - The base HREF for the application. This is used to set the base URL
  * for all relative URLs in the application.
+ * @param perenderedRoutes - A record mapping static paths to their associated data.
  * @returns A string representing the content of the SSR server manifest for App Engine.
  */
-function generateAngularServerAppEngineManifest(i18nOptions, baseHref) {
+function generateAngularServerAppEngineManifest(i18nOptions, baseHref, perenderedRoutes = {}) {
     const entryPointsContent = [];
     if (i18nOptions.shouldInline) {
         for (const locale of i18nOptions.inlineLocales) {
             const importPath = './' + (i18nOptions.flatOutput ? '' : locale + '/') + MAIN_SERVER_OUTPUT_FILENAME;
-            const localWithBaseHref = (0, options_1.getLocaleBaseHref)('', i18nOptions, locale) || '/';
-            entryPointsContent.push(`['${localWithBaseHref}', () => import('${importPath}')]`);
+            let localeWithBaseHref = (0, options_1.getLocaleBaseHref)('', i18nOptions, locale) || '/';
+            // Remove leading and trailing slashes.
+            const start = localeWithBaseHref[0] === '/' ? 1 : 0;
+            const end = localeWithBaseHref[localeWithBaseHref.length - 1] === '/' ? -1 : undefined;
+            localeWithBaseHref = localeWithBaseHref.slice(start, end);
+            entryPointsContent.push(`['${localeWithBaseHref}', () => import('${importPath}')]`);
         }
     }
     else {
-        entryPointsContent.push(`['/', () => import('./${MAIN_SERVER_OUTPUT_FILENAME}')]`);
+        entryPointsContent.push(`['', () => import('./${MAIN_SERVER_OUTPUT_FILENAME}')]`);
+    }
+    const staticHeaders = [];
+    for (const [path, { headers }] of Object.entries(perenderedRoutes)) {
+        if (!headers) {
+            continue;
+        }
+        const headersValues = [];
+        for (const [name, value] of Object.entries(headers)) {
+            headersValues.push(`['${name}', '${encodeURIComponent(value)}']`);
+        }
+        staticHeaders.push(`['${path}', [${headersValues.join(', ')}]]`);
     }
     const manifestContent = `
-  {
-    basePath: '${baseHref ?? '/'}',
-    entryPoints: new Map([${entryPointsContent.join(', \n')}]),
-  }
-`;
+export default {
+  basePath: '${baseHref ?? '/'}',
+  entryPoints: new Map([${entryPointsContent.join(', \n')}]),
+  staticPathsHeaders: new Map([${staticHeaders.join(', \n')}]),
+};
+  `;
     return manifestContent;
 }
 /**
@@ -62,16 +107,19 @@ function generateAngularServerAppEngineManifest(i18nOptions, baseHref) {
  * in the server-side rendered pages.
  * @param routes - An optional array of route definitions for the application, used for
  * 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.
+ *
  * @returns A string representing the content of the SSR server manifest for the Node.js
  * environment.
  */
-function generateAngularServerAppManifest(additionalHtmlOutputFiles, outputFiles, inlineCriticalCss, routes) {
+function generateAngularServerAppManifest(additionalHtmlOutputFiles, outputFiles, inlineCriticalCss, routes, locale) {
     const serverAssetsContent = [];
     for (const file of [...additionalHtmlOutputFiles.values(), ...outputFiles]) {
         if (file.path === options_1.INDEX_HTML_SERVER ||
             file.path === options_1.INDEX_HTML_CSR ||
             (inlineCriticalCss && file.path.endsWith('.css'))) {
-            serverAssetsContent.push(`['${file.path}', async () => ${JSON.stringify(file.text)}]`);
+            serverAssetsContent.push(`['${file.path}', async () => ${escapeUnsafeChars(JSON.stringify(file.text))}]`);
         }
     }
     const manifestContent = `
@@ -80,6 +128,7 @@ export default {
   inlineCriticalCss: ${inlineCriticalCss},
   routes: ${JSON.stringify(routes, undefined, 2)},
   assets: new Map([${serverAssetsContent.join(', \n')}]),
+  locale: ${locale !== undefined ? `'${locale}'` : undefined},
 };
 `;
     return manifestContent;

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

@@ -0,0 +1,27 @@
+/**
+ * @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
+ */
+import type { RenderMode, ɵextractRoutesAndCreateRouteTree } from '@angular/ssr';
+import { ESMInMemoryFileLoaderWorkerData } from './esm-in-memory-loader/loader-hooks';
+type Writeable<T extends readonly unknown[]> = T extends readonly (infer U)[] ? U[] : never;
+export interface RoutesExtractorWorkerData extends ESMInMemoryFileLoaderWorkerData {
+    assetFiles: Record</** Destination */ string, /** Source */ string>;
+}
+export type SerializableRouteTreeNode = ReturnType<Awaited<ReturnType<typeof ɵextractRoutesAndCreateRouteTree>>['routeTree']['toObject']>;
+export type WritableSerializableRouteTreeNode = Writeable<SerializableRouteTreeNode>;
+export interface RoutersExtractorWorkerResult {
+    serializedRouteTree: SerializableRouteTreeNode;
+    errors: string[];
+}
+/**
+ * Local copy of `RenderMode` exported from `@angular/ssr`.
+ * This constant is needed to handle interop between CommonJS (CJS) and ES Modules (ESM) formats.
+ *
+ * It maps `RenderMode` enum values to their corresponding numeric identifiers.
+ */
+export declare const RouteRenderMode: Record<keyof typeof RenderMode, RenderMode>;
+export {};

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

@@ -0,0 +1,22 @@
+"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.RouteRenderMode = void 0;
+/**
+ * Local copy of `RenderMode` exported from `@angular/ssr`.
+ * This constant is needed to handle interop between CommonJS (CJS) and ES Modules (ESM) formats.
+ *
+ * It maps `RenderMode` enum values to their corresponding numeric identifiers.
+ */
+exports.RouteRenderMode = {
+    AppShell: 0,
+    Server: 1,
+    Client: 2,
+    Prerender: 3,
+};

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

@@ -5,16 +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
  */
+import { NormalizedApplicationBuildOptions } from '../../builders/application/options';
+import { OutputMode } from '../../builders/application/schema';
 import { BuildOutputFile } from '../../tools/esbuild/bundler-context';
 import { BuildOutputAsset } from '../../tools/esbuild/bundler-execution-result';
-import type { RoutersExtractorWorkerResult as SerializableRouteTreeNode } from './routes-extractor-worker';
-interface PrerenderOptions {
-    routesFile?: string;
-    discoverRoutes?: boolean;
-}
-interface AppShellOptions {
-    route?: string;
-}
+import { SerializableRouteTreeNode } from './models';
+type PrerenderOptions = NormalizedApplicationBuildOptions['prerenderOptions'];
+type AppShellOptions = NormalizedApplicationBuildOptions['appShellOptions'];
 /**
  * Represents the output of a prerendering process.
  *
@@ -33,11 +30,10 @@ type PrerenderOutput = Record<string, {
     content: string;
     appShellRoute: boolean;
 }>;
-export declare function prerenderPages(workspaceRoot: string, baseHref: string, appShellOptions: AppShellOptions | undefined, prerenderOptions: PrerenderOptions | undefined, outputFiles: Readonly<BuildOutputFile[]>, assets: Readonly<BuildOutputAsset[]>, sourcemap?: boolean, maxThreads?: number, verbose?: boolean): Promise<{
+export declare function prerenderPages(workspaceRoot: string, baseHref: string, appShellOptions: AppShellOptions | undefined, prerenderOptions: PrerenderOptions | undefined, outputFiles: Readonly<BuildOutputFile[]>, assets: Readonly<BuildOutputAsset[]>, outputMode: OutputMode | undefined, sourcemap?: boolean, maxThreads?: number): Promise<{
     output: PrerenderOutput;
     warnings: string[];
     errors: string[];
-    prerenderedRoutes: Set<string>;
     serializableRouteTreeNode: SerializableRouteTreeNode;
 }>;
 export {};

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

@@ -6,24 +6,24 @@
  * 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
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.prerenderPages = prerenderPages;
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
 const node_url_1 = require("node:url");
-const piscina_1 = __importDefault(require("piscina"));
+const schema_1 = require("../../builders/application/schema");
 const bundler_context_1 = require("../../tools/esbuild/bundler-context");
+const error_1 = require("../error");
 const url_1 = require("../url");
-async function prerenderPages(workspaceRoot, baseHref, appShellOptions = {}, prerenderOptions = {}, outputFiles, assets, sourcemap = false, maxThreads = 1, verbose = false) {
+const worker_pool_1 = require("../worker-pool");
+const models_1 = require("./models");
+async function prerenderPages(workspaceRoot, baseHref, appShellOptions, prerenderOptions, outputFiles, assets, outputMode, sourcemap = false, maxThreads = 1) {
     const outputFilesForWorker = {};
     const serverBundlesSourceMaps = new Map();
     const warnings = [];
     const errors = [];
     for (const { text, path, type } of outputFiles) {
-        if (type !== bundler_context_1.BuildOutputFileType.Server) {
+        if (type !== bundler_context_1.BuildOutputFileType.ServerApplication && type !== bundler_context_1.BuildOutputFileType.ServerRoot) {
             continue;
         }
         // Contains the server runnable application code
@@ -51,39 +51,57 @@ async function prerenderPages(workspaceRoot, baseHref, appShellOptions = {}, pre
         assetsReversed[addLeadingSlash(destination.replace(/\\/g, node_path_1.posix.sep))] = source;
     }
     // Get routes to prerender
-    const { routes: allRoutes, warnings: routesWarnings, errors: routesErrors, serializableRouteTreeNode, } = await getAllRoutes(workspaceRoot, baseHref, outputFilesForWorker, assetsReversed, appShellOptions, prerenderOptions, sourcemap, verbose);
-    if (routesErrors?.length) {
-        errors.push(...routesErrors);
-    }
-    if (routesWarnings?.length) {
-        warnings.push(...routesWarnings);
+    const { errors: extractionErrors, serializedRouteTree: serializableRouteTreeNode } = 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}`,
+            ],
+            serializedRouteTree: [],
+        };
+    });
+    errors.push(...extractionErrors);
+    const serializableRouteTreeNodeForPrerender = [];
+    for (const metadata of serializableRouteTreeNode) {
+        if (outputMode !== schema_1.OutputMode.Static && metadata.redirectTo) {
+            // Skip redirects if output mode is not static.
+            continue;
+        }
+        if (metadata.route.includes('*')) {
+            // Skip catch all routes from prerender.
+            continue;
+        }
+        switch (metadata.renderMode) {
+            case undefined: /* Legacy building mode */
+            case models_1.RouteRenderMode.Prerender:
+            case models_1.RouteRenderMode.AppShell:
+                serializableRouteTreeNodeForPrerender.push(metadata);
+                break;
+            case models_1.RouteRenderMode.Server:
+                if (outputMode === schema_1.OutputMode.Static) {
+                    errors.push(`Route '${metadata.route}' is configured with server render mode, but the build 'outputMode' is set to 'static'.`);
+                }
+                break;
+        }
     }
-    if (allRoutes.size < 1 || errors.length > 0) {
+    if (!serializableRouteTreeNodeForPrerender.length || errors.length > 0) {
         return {
             errors,
             warnings,
             output: {},
             serializableRouteTreeNode,
-            prerenderedRoutes: allRoutes,
         };
     }
     // Render routes
-    const { errors: renderingErrors, output } = await renderPages(baseHref, sourcemap, allRoutes, maxThreads, workspaceRoot, outputFilesForWorker, assetsReversed, appShellOptions);
+    const { errors: renderingErrors, output } = await renderPages(baseHref, sourcemap, serializableRouteTreeNodeForPrerender, maxThreads, workspaceRoot, outputFilesForWorker, assetsReversed, appShellOptions);
     errors.push(...renderingErrors);
     return {
         errors,
         warnings,
         output,
         serializableRouteTreeNode,
-        prerenderedRoutes: allRoutes,
     };
 }
-class RoutesSet extends Set {
-    add(value) {
-        return super.add(addLeadingSlash(value));
-    }
-}
-async function renderPages(baseHref, sourcemap, allRoutes, maxThreads, workspaceRoot, outputFilesForWorker, assetFilesForWorker, appShellOptions) {
+async function renderPages(baseHref, sourcemap, serializableRouteTreeNode, maxThreads, workspaceRoot, outputFilesForWorker, assetFilesForWorker, appShellOptions) {
     const output = {};
     const errors = [];
     const workerExecArgv = [
@@ -94,30 +112,35 @@ async function renderPages(baseHref, sourcemap, allRoutes, maxThreads, workspace
     if (sourcemap) {
         workerExecArgv.push('--enable-source-maps');
     }
-    const renderWorker = new piscina_1.default({
+    const renderWorker = new worker_pool_1.WorkerPool({
         filename: require.resolve('./render-worker'),
-        maxThreads: Math.min(allRoutes.size, maxThreads),
+        maxThreads: Math.min(serializableRouteTreeNode.length, maxThreads),
         workerData: {
             workspaceRoot,
             outputFiles: outputFilesForWorker,
             assetFiles: assetFilesForWorker,
         },
         execArgv: workerExecArgv,
-        recordTiming: false,
     });
     try {
         const renderingPromises = [];
-        const appShellRoute = appShellOptions.route && addLeadingSlash(appShellOptions.route);
+        const appShellRoute = appShellOptions && addLeadingSlash(appShellOptions.route);
         const baseHrefWithLeadingSlash = addLeadingSlash(baseHref);
-        for (const route of allRoutes) {
+        for (const { route, redirectTo, renderMode } of serializableRouteTreeNode) {
             // Remove base href from file output path.
             const routeWithoutBaseHref = addLeadingSlash(route.slice(baseHrefWithLeadingSlash.length - 1));
-            const render = renderWorker.run({ url: route });
+            const outPath = node_path_1.posix.join(removeLeadingSlash(routeWithoutBaseHref), 'index.html');
+            if (typeof redirectTo === 'string') {
+                output[outPath] = { content: generateRedirectStaticPage(redirectTo), appShellRoute: false };
+                continue;
+            }
+            const isAppShellRoute = renderMode === models_1.RouteRenderMode.AppShell ||
+                // Legacy handling
+                (renderMode === undefined && appShellRoute === routeWithoutBaseHref);
+            const render = renderWorker.run({ url: route, isAppShellRoute });
             const renderResult = render
                 .then((content) => {
                 if (content !== null) {
-                    const outPath = node_path_1.posix.join(removeLeadingSlash(routeWithoutBaseHref), 'index.html');
-                    const isAppShellRoute = appShellRoute === routeWithoutBaseHref;
                     output[outPath] = { content, appShellRoute: isAppShellRoute };
                 }
             })
@@ -137,21 +160,24 @@ async function renderPages(baseHref, sourcemap, allRoutes, maxThreads, workspace
         output,
     };
 }
-async function getAllRoutes(workspaceRoot, baseHref, outputFilesForWorker, assetFilesForWorker, appShellOptions, prerenderOptions, sourcemap, verbose) {
-    const { routesFile, discoverRoutes } = prerenderOptions;
-    const routes = new RoutesSet();
-    const { route: appShellRoute } = appShellOptions;
-    if (appShellRoute !== undefined) {
-        routes.add((0, url_1.urlJoin)(baseHref, appShellRoute));
+async function getAllRoutes(workspaceRoot, baseHref, outputFilesForWorker, assetFilesForWorker, appShellOptions, prerenderOptions, sourcemap, outputMode) {
+    const { routesFile, discoverRoutes } = prerenderOptions ?? {};
+    const routes = [];
+    if (appShellOptions) {
+        routes.push({
+            route: (0, url_1.urlJoin)(baseHref, appShellOptions.route),
+        });
     }
     if (routesFile) {
         const routesFromFile = (await (0, promises_1.readFile)(routesFile, 'utf8')).split(/\r?\n/);
         for (const route of routesFromFile) {
-            routes.add((0, url_1.urlJoin)(baseHref, route.trim()));
+            routes.push({
+                route: (0, url_1.urlJoin)(baseHref, route.trim()),
+            });
         }
     }
     if (!discoverRoutes) {
-        return { routes, serializableRouteTreeNode: [] };
+        return { errors: [], serializedRouteTree: routes };
     }
     const workerExecArgv = [
         '--import',
@@ -161,7 +187,7 @@ async function getAllRoutes(workspaceRoot, baseHref, outputFilesForWorker, asset
     if (sourcemap) {
         workerExecArgv.push('--enable-source-maps');
     }
-    const renderWorker = new piscina_1.default({
+    const renderWorker = new worker_pool_1.WorkerPool({
         filename: require.resolve('./routes-extractor-worker'),
         maxThreads: 1,
         workerData: {
@@ -170,41 +196,23 @@ async function getAllRoutes(workspaceRoot, baseHref, outputFilesForWorker, asset
             assetFiles: assetFilesForWorker,
         },
         execArgv: workerExecArgv,
-        recordTiming: false,
     });
-    const errors = [];
-    const serializableRouteTreeNode = await renderWorker
-        .run({})
-        .catch((err) => {
-        errors.push(`An error occurred while extracting routes.\n\n${err.stack}`);
-    })
-        .finally(() => {
-        void renderWorker.destroy();
-    });
-    const skippedRedirects = [];
-    const skippedOthers = [];
-    for (const { route, redirectTo } of serializableRouteTreeNode) {
-        if (redirectTo) {
-            skippedRedirects.push(route);
-        }
-        else if (route.includes('*')) {
-            skippedOthers.push(route);
-        }
-        else {
-            routes.add(route);
-        }
+    try {
+        const { serializedRouteTree, errors } = await renderWorker.run({
+            outputMode,
+        });
+        return { errors, serializedRouteTree: [...routes, ...serializedRouteTree] };
     }
-    let warnings;
-    if (verbose) {
-        if (skippedOthers.length) {
-            (warnings ??= []).push('The following routes were skipped from prerendering because they contain routes with dynamic parameters:\n' +
-                skippedOthers.join('\n'));
-        }
-        if (skippedRedirects.length) {
-            (warnings ??= []).push('The following routes were skipped from prerendering because they contain redirects:\n', skippedRedirects.join('\n'));
-        }
+    catch (err) {
+        (0, error_1.assertIsError)(err);
+        return {
+            errors: [`An error occurred while extracting routes.\n\n${err.stack}`],
+            serializedRouteTree: [],
+        };
+    }
+    finally {
+        void renderWorker.destroy();
     }
-    return { routes, serializableRouteTreeNode, warnings };
 }
 function addLeadingSlash(value) {
     return value.charAt(0) === '/' ? value : '/' + value;
@@ -212,3 +220,27 @@ function addLeadingSlash(value) {
 function removeLeadingSlash(value) {
     return value.charAt(0) === '/' ? value.slice(1) : value;
 }
+/**
+ * Generates a static HTML page with a meta refresh tag to redirect the user to a specified URL.
+ *
+ * This function creates a simple HTML page that performs a redirect using a meta tag.
+ * It includes a fallback link in case the meta-refresh doesn't work.
+ *
+ * @param url - The URL to which the page should redirect.
+ * @returns The HTML content of the static redirect page.
+ */
+function generateRedirectStaticPage(url) {
+    return `
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+    <title>Redirecting</title>
+    <meta http-equiv="refresh" content="0; url=${url}">
+  </head>
+  <body>
+    <pre>Redirecting to <a href="${url}">${url}</a></pre>
+  </body>
+</html>
+`.trim();
+}

package/src/utils/server-rendering/routes-extractor-worker.d.ts

@@ -5,13 +5,12 @@
  * 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 type { ɵextractRoutesAndCreateRouteTree } from '@angular/ssr';
-import type { ESMInMemoryFileLoaderWorkerData } from './esm-in-memory-loader/loader-hooks';
-export interface RoutesExtractorWorkerData extends ESMInMemoryFileLoaderWorkerData {
-    assetFiles: Record</** Destination */ string, /** Source */ string>;
+import { OutputMode } from '../../builders/application/schema';
+import { RoutersExtractorWorkerResult } from './models';
+export interface ExtractRoutesOptions {
+    outputMode?: OutputMode;
 }
-export type RoutersExtractorWorkerResult = ReturnType<Awaited<ReturnType<typeof ɵextractRoutesAndCreateRouteTree>>['toObject']>;
 /** Renders an application based on a provided options. */
-declare function extractRoutes(): Promise<RoutersExtractorWorkerResult>;
+declare function extractRoutes({ outputMode, }: ExtractRoutesOptions): Promise<RoutersExtractorWorkerResult>;
 declare const _default: typeof extractRoutes;
 export default _default;

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

@@ -7,15 +7,17 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+const schema_1 = require("../../builders/application/schema");
 const fetch_patch_1 = require("./fetch-patch");
 const load_esm_from_memory_1 = require("./load-esm-from-memory");
 /** Renders an application based on a provided options. */
-async function extractRoutes() {
+async function extractRoutes({ outputMode, }) {
     const { ɵextractRoutesAndCreateRouteTree: extractRoutesAndCreateRouteTree } = await (0, load_esm_from_memory_1.loadEsmModuleFromMemory)('./main.server.mjs');
-    const routeTree = await extractRoutesAndCreateRouteTree(new URL('http://local-angular-prerender/'), 
-    /** manifest */ undefined, 
-    /** invokeGetPrerenderParams */ true);
-    return routeTree.toObject();
+    const { routeTree, errors } = await extractRoutesAndCreateRouteTree(new URL('http://local-angular-prerender/'), undefined /** manifest */, true /** invokeGetPrerenderParams */, outputMode === schema_1.OutputMode.Server /** includePrerenderFallbackRoutes */);
+    return {
+        errors,
+        serializedRouteTree: routeTree.toObject(),
+    };
 }
 function initialize() {
     (0, fetch_patch_1.patchFetchToLoadInMemoryAssets)();

package/src/utils/worker-pool.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @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
+ */
+import { Piscina } from 'piscina';
+export type WorkerPoolOptions = ConstructorParameters<typeof Piscina>[0];
+export declare class WorkerPool extends Piscina {
+    constructor(options: WorkerPoolOptions);
+}

package/src/utils/worker-pool.js

@@ -0,0 +1,43 @@
+"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.WorkerPool = void 0;
+const node_module_1 = require("node:module");
+const piscina_1 = require("piscina");
+class WorkerPool extends piscina_1.Piscina {
+    constructor(options) {
+        const piscinaOptions = {
+            minThreads: 1,
+            idleTimeout: 1000,
+            // Web containers do not support transferable objects with receiveOnMessagePort which
+            // is used when the Atomics based wait loop is enable.
+            useAtomics: !process.versions.webcontainer,
+            recordTiming: false,
+            ...options,
+        };
+        // Enable compile code caching if enabled for the main process (only exists on Node.js v22.8+).
+        // Skip if running inside Bazel via a RUNFILES environment variable check. The cache does not work
+        // well with Bazel's hermeticity requirements.
+        const compileCacheDirectory = process.env['RUNFILES'] ? undefined : (0, node_module_1.getCompileCacheDir)?.();
+        if (compileCacheDirectory) {
+            if (typeof piscinaOptions.env === 'object') {
+                piscinaOptions.env['NODE_COMPILE_CACHE'] = compileCacheDirectory;
+            }
+            else {
+                // Default behavior of `env` option is to copy current process values
+                piscinaOptions.env = {
+                    ...process.env,
+                    'NODE_COMPILE_CACHE': compileCacheDirectory,
+                };
+            }
+        }
+        super(piscinaOptions);
+    }
+}
+exports.WorkerPool = WorkerPool;

package/src/tools/vite/angular-memory-plugin.d.ts

@@ -1,22 +0,0 @@
-/**
- * @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
- */
-import type { Connect, Plugin } from 'vite';
-import { AngularMemoryOutputFiles } from './utils';
-export interface AngularMemoryPluginOptions {
-    workspaceRoot: string;
-    virtualProjectRoot: string;
-    outputFiles: AngularMemoryOutputFiles;
-    assets: Map<string, string>;
-    ssr: boolean;
-    external?: string[];
-    extensionMiddleware?: Connect.NextHandleFunction[];
-    indexHtmlTransformer?: (content: string) => Promise<string>;
-    normalizePath: (path: string) => string;
-    usedComponentStyles: Map<string, string[]>;
-}
-export declare function createAngularMemoryPlugin(options: AngularMemoryPluginOptions): Plugin;