@angular/ssr 21.0.0-next.0 → 21.0.0-next.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/ssr",
-  "version": "21.0.0-next.0",
+  "version": "21.0.0-next.10",
   "description": "Angular server side rendering utilities",
   "type": "module",
   "license": "MIT",
@@ -29,12 +29,12 @@
   },
   "devDependencies": {
     "@angular-devkit/schematics": "workspace:*",
-    "@angular/common": "21.0.0-next.0",
-    "@angular/compiler": "21.0.0-next.0",
-    "@angular/core": "21.0.0-next.0",
-    "@angular/platform-browser": "21.0.0-next.0",
-    "@angular/platform-server": "21.0.0-next.0",
-    "@angular/router": "21.0.0-next.0",
+    "@angular/common": "21.0.0-rc.0",
+    "@angular/compiler": "21.0.0-rc.0",
+    "@angular/core": "21.0.0-rc.0",
+    "@angular/platform-browser": "21.0.0-rc.0",
+    "@angular/platform-server": "21.0.0-rc.0",
+    "@angular/router": "21.0.0-rc.0",
     "@schematics/angular": "workspace:*",
     "beasties": "0.3.5"
   },
@@ -45,17 +45,17 @@
     "url": "https://github.com/angular/angular-cli.git"
   },
   "module": "./fesm2022/ssr.mjs",
-  "typings": "./index.d.ts",
+  "typings": "./types/ssr.d.ts",
   "exports": {
     "./package.json": {
       "default": "./package.json"
     },
     ".": {
-      "types": "./index.d.ts",
+      "types": "./types/ssr.d.ts",
       "default": "./fesm2022/ssr.mjs"
     },
     "./node": {
-      "types": "./node/index.d.ts",
+      "types": "./types/node.d.ts",
       "default": "./fesm2022/node.mjs"
     }
   }

package/schematics/ng-add/index.js

@@ -9,3 +9,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const schematics_1 = require("@angular-devkit/schematics");
 exports.default = (options) => (0, schematics_1.externalSchematic)('@schematics/angular', 'ssr', options);
+//# sourceMappingURL=index.js.map

package/schematics/ng-add/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAEH,2DAA+D;AAG/D,kBAAe,CAAC,OAAmB,EAAE,EAAE,CAAC,IAAA,8BAAiB,EAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC"}

package/schematics/ng-add/schema.js

@@ -2,3 +2,4 @@
 // THIS FILE IS AUTOMATICALLY GENERATED. TO UPDATE THIS FILE YOU NEED TO CHANGE THE
 // CORRESPONDING JSON SCHEMA FILE, THEN RUN devkit-admin build (or bazel build ...).
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/schematics/ng-add/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["schema.ts"],"names":[],"mappings":";AACA,mFAAmF;AACnF,oFAAoF"}

package/{node/index.d.ts → types/node.d.ts}

@@ -1,10 +1,11 @@
 import { Type, ApplicationRef, StaticProvider } from '@angular/core';
+import { BootstrapContext } from '@angular/platform-browser';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { Http2ServerRequest, Http2ServerResponse } from 'node:http2';
 
 interface CommonEngineOptions {
     /** A method that when invoked returns a promise that returns an `ApplicationRef` instance once resolved or an NgModule. */
-    bootstrap?: Type<{}> | (() => Promise<ApplicationRef>);
+    bootstrap?: Type<{}> | ((context: BootstrapContext) => Promise<ApplicationRef>);
     /** A set of platform level providers for all requests. */
     providers?: StaticProvider[];
     /** Enable request performance profiling data collection and printing the results in the server console. */
@@ -12,7 +13,7 @@ interface CommonEngineOptions {
 }
 interface CommonEngineRenderOptions {
     /** A method that when invoked returns a promise that returns an `ApplicationRef` instance once resolved or an NgModule. */
-    bootstrap?: Type<{}> | (() => Promise<ApplicationRef>);
+    bootstrap?: Type<{}> | ((context: BootstrapContext) => Promise<ApplicationRef>);
     /** A set of platform level providers for the current request. */
     providers?: StaticProvider[];
     url?: string;
@@ -117,7 +118,7 @@ type NodeRequestHandlerFunction = (req: IncomingMessage, res: ServerResponse, ne
  *   } catch (error) {
  *     next(error);
  *   }
- * }));
+ * });
  * ```
  *
  * @example
@@ -127,8 +128,7 @@ type NodeRequestHandlerFunction = (req: IncomingMessage, res: ServerResponse, ne
  * export default createNodeRequestHandler(async (req, res) => {
  *   await app.ready();
  *   app.server.emit('request', req, res);
- *   res.send('Hello from Fastify with Node Next Handler!');
- * }));
+ * });
  * ```
  */
 declare function createNodeRequestHandler<T extends NodeRequestHandlerFunction>(handler: T): T;

package/{index.d.ts → types/ssr.d.ts}

@@ -1,6 +1,7 @@
 import { Type, EnvironmentProviders, Provider, ApplicationRef } from '@angular/core';
 import { DefaultExport } from '@angular/router';
-import Beasties from './third_party/beasties';
+import { BootstrapContext } from '@angular/platform-browser';
+import Beasties from '../third_party/beasties';
 
 /**
  * Identifies a particular kind of `ServerRenderingFeatureKind`.
@@ -169,19 +170,19 @@ type ServerRoute = ServerRouteClient | ServerRoutePrerender | ServerRoutePrerend
  *
  * const serverRoutes: ServerRoute[] = [
  *   {
- *     route: '', // This renders the "/" route on the client (CSR)
+ *     path: '', // This renders the "/" route on the client (CSR)
  *     renderMode: RenderMode.Client,
  *   },
  *   {
- *     route: 'about', // This page is static, so we prerender it (SSG)
+ *     path: 'about', // This page is static, so we prerender it (SSG)
  *     renderMode: RenderMode.Prerender,
  *   },
  *   {
- *     route: 'profile', // This page requires user-specific data, so we use SSR
+ *     path: 'profile', // This page requires user-specific data, so we use SSR
  *     renderMode: RenderMode.Server,
  *   },
  *   {
- *     route: '**', // All other routes will be rendered on the server (SSR)
+ *     path: '**', // All other routes will be rendered on the server (SSR)
  *     renderMode: RenderMode.Server,
  *   },
  * ];
@@ -249,20 +250,23 @@ declare function withAppShell(component: Type<unknown> | (() => Promise<Type<unk
  * when using the `bootstrapApplication` function:
  *
  * ```ts
- * import { bootstrapApplication } from '@angular/platform-browser';
+ * import { bootstrapApplication, BootstrapContext } from '@angular/platform-browser';
  * import { provideServerRendering, withRoutes, withAppShell } from '@angular/ssr';
  * import { AppComponent } from './app/app.component';
  * import { SERVER_ROUTES } from './app/app.server.routes';
  * import { AppShellComponent } from './app/app-shell.component';
  *
- * bootstrapApplication(AppComponent, {
- *   providers: [
- *      provideServerRendering(
- *         withRoutes(SERVER_ROUTES),
- *         withAppShell(AppShellComponent)
- *      )
- *   ]
- * });
+ * const bootstrap = (context: BootstrapContext) =>
+ *     bootstrapApplication(AppComponent, {
+ *       providers: [
+ *         provideServerRendering(
+ *           withRoutes(SERVER_ROUTES),
+ *           withAppShell(AppShellComponent),
+ *         ),
+ *       ],
+ *     }, context);
+ *
+ * export default bootstrap;
  * ```
  * @see {@link withRoutes} configures server-side routing
  * @see {@link withAppShell} configures the application shell
@@ -435,7 +439,7 @@ declare class RouteTree<AdditionalMetadata extends Record<string, unknown> = {}>
  * - A reference to an Angular component or module (`Type<unknown>`) that serves as the root of the application.
  * - A function that returns a `Promise<ApplicationRef>`, which resolves with the root application reference.
  */
-type AngularBootstrap = Type<unknown> | (() => Promise<ApplicationRef>);
+type AngularBootstrap = Type<unknown> | ((context: BootstrapContext) => Promise<ApplicationRef>);
 
 /**
  * Represents a server asset stored in the manifest.
@@ -782,11 +786,10 @@ declare class AngularServerApp {
      */
     private readonly textDecoder;
     /**
-     * Cache for storing critical CSS for pages.
-     * Stores a maximum of MAX_INLINE_CSS_CACHE_ENTRIES entries.
+     * A cache that stores critical CSS to avoid re-processing for every request, improving performance.
+     * This cache uses a Least Recently Used (LRU) eviction policy.
      *
-     * Uses an LRU (Least Recently Used) eviction policy, meaning that when the cache is full,
-     * the least recently accessed page's critical CSS will be removed to make space for new entries.
+     * @see {@link MAX_INLINE_CSS_CACHE_ENTRIES} for the maximum number of entries this cache can hold.
      */
     private readonly criticalCssLRUCache;
     /**
@@ -808,7 +811,6 @@ declare class AngularServerApp {
      *
      * @param request - The incoming HTTP request for serving a static page.
      * @param matchedRoute - The metadata of the matched route for rendering.
-     * If not provided, the method attempts to find a matching route based on the request URL.
      * @returns A promise that resolves to a `Response` object if the prerendered page is found, or `null`.
      */
     private handleServe;
@@ -818,12 +820,28 @@ declare class AngularServerApp {
      *
      * @param request - The incoming HTTP request to be processed.
      * @param matchedRoute - The metadata of the matched route for rendering.
-     * If not provided, the method attempts to find a matching route based on the request URL.
      * @param requestContext - Optional additional context for rendering, such as request metadata.
      *
      * @returns A promise that resolves to the rendered response, or null if no matching route is found.
      */
     private handleRendering;
+    /**
+     * Inlines critical CSS into the given HTML content.
+     *
+     * @param html The HTML content to process.
+     * @param url The URL associated with the request, for logging purposes.
+     * @returns A promise that resolves to the HTML with inlined critical CSS.
+     */
+    private inlineCriticalCss;
+    /**
+     * Inlines critical CSS into the given HTML content.
+     * This method uses a cache to avoid reprocessing the same HTML content multiple times.
+     *
+     * @param html The HTML content to process.
+     * @param url The URL associated with the request, for logging purposes.
+     * @returns A promise that resolves to the HTML with inlined critical CSS.
+     */
+    private inlineCriticalCssWithCache;
     /**
      * Constructs the asset path on the server based on the provided HTTP request.
      *