@depup/angular__build 21.2.2-depup.0

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

@@ -0,0 +1,96 @@
+"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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_URL = void 0;
+exports.launchServer = launchServer;
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_http_1 = require("node:http");
+const load_esm_from_memory_1 = require("./load-esm-from-memory");
+const utils_1 = require("./utils");
+exports.DEFAULT_URL = new URL('http://ng-localhost/');
+/**
+ * Launches a server that handles local requests.
+ *
+ * @returns A promise that resolves to the URL of the running server.
+ */
+async function launchServer() {
+    const { reqHandler } = await (0, load_esm_from_memory_1.loadEsmModuleFromMemory)('./server.mjs');
+    const { createWebRequestFromNodeRequest, writeResponseToNodeResponse } = (await Promise.resolve(`${'@angular/ssr/node'}`).then(s => __importStar(require(s))));
+    if (!(0, utils_1.isSsrNodeRequestHandler)(reqHandler) && !(0, utils_1.isSsrRequestHandler)(reqHandler)) {
+        return exports.DEFAULT_URL;
+    }
+    const server = (0, node_http_1.createServer)((req, res) => {
+        (async () => {
+            // handle request
+            if ((0, utils_1.isSsrNodeRequestHandler)(reqHandler)) {
+                await reqHandler(req, res, (e) => {
+                    throw e ?? new Error(`Unable to handle request: '${req.url}'.`);
+                });
+            }
+            else {
+                const webRes = await reqHandler(createWebRequestFromNodeRequest(req));
+                if (webRes) {
+                    await writeResponseToNodeResponse(webRes, res);
+                }
+                else {
+                    res.statusCode = 501;
+                    res.end('Not Implemented.');
+                }
+            }
+        })().catch((e) => {
+            res.statusCode = 500;
+            res.end('Internal Server Error.');
+            // eslint-disable-next-line no-console
+            console.error(e);
+        });
+    });
+    server.unref();
+    await new Promise((resolve) => server.listen(0, 'localhost', resolve));
+    const serverAddress = server.address();
+    (0, node_assert_1.default)(serverAddress, 'Server address should be defined.');
+    (0, node_assert_1.default)(typeof serverAddress !== 'string', 'Server address should not be a string.');
+    return new URL(`http://localhost:${serverAddress.port}/`);
+}
+//# sourceMappingURL=launch-server.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launch-server.js","sourceRoot":"","sources":["launch-server.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcH,oCA2CC;AAvDD,8DAAiC;AACjC,yCAAyC;AACzC,iEAAiE;AACjE,mCAAuE;AAE1D,QAAA,WAAW,GAAG,IAAI,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAE3D;;;;GAIG;AACI,KAAK,UAAU,YAAY;IAChC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,8CAAuB,EAAC,cAAc,CAAC,CAAC;IACrE,MAAM,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,GAAG,CAAC,yBACxE,mBAA6B,uCAC9B,CAAkF,CAAC;IAEpF,IAAI,CAAC,IAAA,+BAAuB,EAAC,UAAU,CAAC,IAAI,CAAC,IAAA,2BAAmB,EAAC,UAAU,CAAC,EAAE,CAAC;QAC7E,OAAO,mBAAW,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACvC,CAAC,KAAK,IAAI,EAAE;YACV,iBAAiB;YACjB,IAAI,IAAA,+BAAuB,EAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;oBAC/B,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;gBAClE,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,+BAA+B,CAAC,GAAG,CAAC,CAAC,CAAC;gBACtE,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,2BAA2B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACjD,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;oBACrB,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YACf,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YAClC,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,EAAE,CAAC;IAEf,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7E,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IACvC,IAAA,qBAAM,EAAC,aAAa,EAAE,mCAAmC,CAAC,CAAC;IAC3D,IAAA,qBAAM,EAAC,OAAO,aAAa,KAAK,QAAQ,EAAE,wCAAwC,CAAC,CAAC;IAEpF,OAAO,IAAI,GAAG,CAAC,oBAAoB,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/src/utils/server-rendering/load-esm-from-memory.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 { ApplicationRef, Type } from '@angular/core';
+import type { BootstrapContext } from '@angular/platform-browser';
+import type { ɵextractRoutesAndCreateRouteTree, ɵgetOrCreateAngularServerApp } from '@angular/ssr';
+/**
+ * Represents the exports available from the main server bundle.
+ */
+interface MainServerBundleExports {
+    default: ((context: BootstrapContext) => Promise<ApplicationRef>) | Type<unknown>;
+    ɵextractRoutesAndCreateRouteTree: typeof ɵextractRoutesAndCreateRouteTree;
+    ɵgetOrCreateAngularServerApp: typeof ɵgetOrCreateAngularServerApp;
+}
+/**
+ * Represents the exports available from the server bundle.
+ */
+interface ServerBundleExports {
+    reqHandler?: unknown;
+}
+export declare function loadEsmModuleFromMemory(path: './main.server.mjs'): Promise<MainServerBundleExports>;
+export declare function loadEsmModuleFromMemory(path: './server.mjs'): Promise<ServerBundleExports>;
+export {};

package/src/utils/server-rendering/load-esm-from-memory.js

@@ -0,0 +1,26 @@
+"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.loadEsmModuleFromMemory = loadEsmModuleFromMemory;
+const error_1 = require("../error");
+const load_esm_1 = require("../load-esm");
+function loadEsmModuleFromMemory(path) {
+    return (0, load_esm_1.loadEsmModule)(new URL(path, 'memory://')).catch((e) => {
+        (0, error_1.assertIsError)(e);
+        // While the error is an 'instanceof Error', it is extended with non transferable properties
+        // and cannot be transferred from a worker when using `--import`. This results in the error object
+        // displaying as '[Object object]' when read outside of the worker. Therefore, we reconstruct the error message here.
+        const error = new Error(e.message);
+        error.stack = e.stack;
+        error.name = e.name;
+        error.code = e.code;
+        throw error;
+    });
+}
+//# sourceMappingURL=load-esm-from-memory.js.map

package/src/utils/server-rendering/load-esm-from-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-esm-from-memory.js","sourceRoot":"","sources":["load-esm-from-memory.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA4BH,0DAgBC;AAvCD,oCAAyC;AACzC,0CAA4C;AAsB5C,SAAgB,uBAAuB,CACrC,IAA0C;IAE1C,OAAO,IAAA,wBAAa,EAAC,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3D,IAAA,qBAAa,EAAC,CAAC,CAAC,CAAC;QAEjB,4FAA4F;QAC5F,kGAAkG;QAClG,qHAAqH;QACrH,MAAM,KAAK,GAA8B,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC9D,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QACtB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACpB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QAEpB,MAAM,KAAK,CAAC;IACd,CAAC,CAAqC,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * @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 { Metafile } from 'esbuild';
+import { NormalizedApplicationBuildOptions } from '../../builders/application/options';
+import { type BuildOutputFile } from '../../tools/esbuild/bundler-context';
+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.
+ *
+ * This manifest is used to configure the server-side rendering (SSR) setup for the
+ * Angular application when deployed to Google App Engine. It includes the entry points
+ * for different locales and the base HREF for the application.
+ *
+ * @param i18nOptions - The internationalization options for the application build. This
+ * includes settings for inlining locales and determining the output structure.
+ * @param allowedHosts - A list of hosts that are allowed to access the server-side application.
+ * @param baseHref - The base HREF for the application. This is used to set the base URL
+ * for all relative URLs in the application.
+ */
+export declare function generateAngularServerAppEngineManifest(i18nOptions: NormalizedApplicationBuildOptions['i18nOptions'], allowedHosts: string[], baseHref: string | undefined): string;
+/**
+ * Generates the server manifest for the standard Node.js environment.
+ *
+ * This manifest is used to configure the server-side rendering (SSR) setup for the
+ * Angular application when running in a standard Node.js environment. It includes
+ * information about the bootstrap module, whether to inline critical CSS, and any
+ * additional HTML and CSS output files.
+ *
+ * @param additionalHtmlOutputFiles - A map of additional HTML output files generated
+ * during the build process, keyed by their file paths.
+ * @param outputFiles - An array of all output files from the build process, including
+ * JavaScript and CSS files.
+ * @param inlineCriticalCss - A boolean indicating whether critical CSS should be inlined
+ * 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.
+ * @param baseHref - The base HREF for the application. This is used to set the base URL
+ * for all relative URLs in the application.
+ * @param initialFiles - A list of initial files that preload tags have already been added for.
+ * @param metafile - An esbuild metafile object.
+ * @param publicPath - The configured public path.
+ *
+ * @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, baseHref: string, initialFiles: Set<string>, metafile: Metafile, publicPath: string | undefined): {
+    manifestContent: string;
+    serverAssetsChunks: BuildOutputFile[];
+};

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

@@ -0,0 +1,177 @@
+"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.SERVER_APP_ENGINE_MANIFEST_FILENAME = exports.SERVER_APP_MANIFEST_FILENAME = void 0;
+exports.generateAngularServerAppEngineManifest = generateAngularServerAppEngineManifest;
+exports.generateAngularServerAppManifest = generateAngularServerAppManifest;
+const node_path_1 = require("node:path");
+const node_vm_1 = require("node:vm");
+const bundler_context_1 = require("../../tools/esbuild/bundler-context");
+const utils_1 = require("../../tools/esbuild/utils");
+const environment_options_1 = require("../environment-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 = {
+    '`': '\\`',
+    '$': '\\$',
+    '\\': '\\\\',
+};
+/**
+ * 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(/[$`\\]/g, (c) => UNSAFE_CHAR_MAP[c]);
+}
+/**
+ * Generates the server manifest for the App Engine environment.
+ *
+ * This manifest is used to configure the server-side rendering (SSR) setup for the
+ * Angular application when deployed to Google App Engine. It includes the entry points
+ * for different locales and the base HREF for the application.
+ *
+ * @param i18nOptions - The internationalization options for the application build. This
+ * includes settings for inlining locales and determining the output structure.
+ * @param allowedHosts - A list of hosts that are allowed to access the server-side application.
+ * @param baseHref - The base HREF for the application. This is used to set the base URL
+ * for all relative URLs in the application.
+ */
+function generateAngularServerAppEngineManifest(i18nOptions, allowedHosts, baseHref) {
+    const entryPoints = {};
+    const supportedLocales = {};
+    if (i18nOptions.shouldInline && !i18nOptions.flatOutput) {
+        for (const locale of i18nOptions.inlineLocales) {
+            const { subPath } = i18nOptions.locales[locale];
+            const importPath = `${subPath ? `${subPath}/` : ''}${MAIN_SERVER_OUTPUT_FILENAME}`;
+            entryPoints[subPath] = `() => import('./${importPath}')`;
+            supportedLocales[locale] = subPath;
+        }
+    }
+    else {
+        entryPoints[''] = `() => import('./${MAIN_SERVER_OUTPUT_FILENAME}')`;
+        supportedLocales[i18nOptions.sourceLocale] = '';
+    }
+    // Remove trailing slash but retain leading slash.
+    let basePath = baseHref || '/';
+    if (basePath.length > 1 && basePath.at(-1) === '/') {
+        basePath = basePath.slice(0, -1);
+    }
+    const manifestContent = `
+export default {
+  basePath: '${basePath}',
+  allowedHosts: ${JSON.stringify(allowedHosts, undefined, 2)},
+  supportedLocales: ${JSON.stringify(supportedLocales, undefined, 2)},
+  entryPoints: {
+    ${Object.entries(entryPoints)
+        .map(([key, value]) => `'${key}': ${value}`)
+        .join(',\n    ')}
+  },
+};
+`;
+    return manifestContent;
+}
+/**
+ * Generates the server manifest for the standard Node.js environment.
+ *
+ * This manifest is used to configure the server-side rendering (SSR) setup for the
+ * Angular application when running in a standard Node.js environment. It includes
+ * information about the bootstrap module, whether to inline critical CSS, and any
+ * additional HTML and CSS output files.
+ *
+ * @param additionalHtmlOutputFiles - A map of additional HTML output files generated
+ * during the build process, keyed by their file paths.
+ * @param outputFiles - An array of all output files from the build process, including
+ * JavaScript and CSS files.
+ * @param inlineCriticalCss - A boolean indicating whether critical CSS should be inlined
+ * 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.
+ * @param baseHref - The base HREF for the application. This is used to set the base URL
+ * for all relative URLs in the application.
+ * @param initialFiles - A list of initial files that preload tags have already been added for.
+ * @param metafile - An esbuild metafile object.
+ * @param publicPath - The configured public path.
+ *
+ * @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, baseHref, initialFiles, metafile, publicPath) {
+    const serverAssetsChunks = [];
+    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`;
+            const escapedContent = escapeUnsafeChars(file.text);
+            serverAssetsChunks.push((0, utils_1.createOutputFile)(jsChunkFilePath, `export default \`${escapedContent}\`;`, bundler_context_1.BuildOutputFileType.ServerApplication));
+            // This is needed because JavaScript engines script parser convert `\r\n` to `\n` in template literals,
+            // which can result in an incorrect byte length.
+            const size = (0, node_vm_1.runInThisContext)(`new TextEncoder().encode(\`${escapedContent}\`).byteLength`);
+            serverAssets[file.path] =
+                `{size: ${size}, hash: '${file.hash}', text: () => import('./${jsChunkFilePath}').then(m => m.default)}`;
+        }
+    }
+    // When routes have been extracted, mappings are no longer needed, as preloads will be included in the metadata.
+    // When shouldOptimizeChunks is enabled the metadata is no longer correct and thus we cannot generate the mappings.
+    const entryPointToBrowserMapping = routes?.length || environment_options_1.shouldOptimizeChunks
+        ? undefined
+        : generateLazyLoadedFilesMappings(metafile, initialFiles, publicPath);
+    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)},
+  entryPointToBrowserMapping: ${JSON.stringify(entryPointToBrowserMapping, undefined, 2)},
+  assets: {
+    ${Object.entries(serverAssets)
+        .map(([key, value]) => `'${key}': ${value}`)
+        .join(',\n    ')}
+  },
+};
+`;
+    return { manifestContent, serverAssetsChunks };
+}
+/**
+ * Maps entry points to their corresponding browser bundles for lazy loading.
+ *
+ * This function processes a metafile's outputs to generate a mapping between browser-side entry points
+ * and the associated JavaScript files that should be loaded in the browser. It includes the entry-point's
+ * own path and any valid imports while excluding initial files or external resources.
+ */
+function generateLazyLoadedFilesMappings(metafile, initialFiles, publicPath = '') {
+    const entryPointToBundles = {};
+    for (const [fileName, { entryPoint, exports, imports }] of Object.entries(metafile.outputs)) {
+        // Skip files that don't have an entryPoint, no exports, or are not .js
+        if (!entryPoint || exports?.length < 1 || !fileName.endsWith('.js')) {
+            continue;
+        }
+        const importedPaths = [`${publicPath}${fileName}`];
+        for (const { kind, external, path } of imports) {
+            if (external || initialFiles.has(path) || kind !== 'import-statement') {
+                continue;
+            }
+            importedPaths.push(`${publicPath}${path}`);
+        }
+        entryPointToBundles[entryPoint] = importedPaths;
+    }
+    return entryPointToBundles;
+}
+//# sourceMappingURL=manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["manifest.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,28 @@
+/**
+ * @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;
+    appShellRoute?: string;
+    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 = {
+    Server: 0,
+    Client: 1,
+    Prerender: 2,
+};
+//# sourceMappingURL=models.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["models.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAuBH;;;;;GAKG;AACU,QAAA,eAAe,GAAgD;IAC1E,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;CACb,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * @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 { 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 { SerializableRouteTreeNode } from './models';
+type PrerenderOptions = NormalizedApplicationBuildOptions['prerenderOptions'];
+type AppShellOptions = NormalizedApplicationBuildOptions['appShellOptions'];
+/**
+ * Represents the output of a prerendering process.
+ *
+ * The key is the file path, and the value is an object containing the following properties:
+ *
+ * - `content`: The HTML content or output generated for the corresponding file path.
+ * - `appShellRoute`: A boolean flag indicating whether the content is an app shell.
+ *
+ * @example
+ * {
+ *   '/index.html': { content: '<html>...</html>', appShell: false },
+ *   '/shell/index.html': { content: '<html>...</html>', appShellRoute: true }
+ * }
+ */
+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[]>, outputMode: OutputMode | undefined, sourcemap?: boolean, maxThreads?: number): Promise<{
+    output: PrerenderOutput;
+    warnings: string[];
+    errors: string[];
+    serializableRouteTreeNode: SerializableRouteTreeNode;
+}>;
+export {};