@angular/ssr 19.1.6 → 19.2.0-next.0

package/index.d.ts

@@ -1,9 +1,7 @@
 import type { ApplicationRef } from '@angular/core';
 import { default as default_2 } from 'beasties';
-import { DefaultExport } from '@angular/router';
 import { EnvironmentProviders } from '@angular/core';
-import { Provider } from '@angular/core';
-import { Type } from '@angular/core';
+import type { Type } from '@angular/core';
 
 /**
  * Angular server application engine.
@@ -535,31 +533,13 @@ export declare enum PrerenderFallback {
  *
  * @see {@link ServerRoute}
  * @see {@link ServerRoutesConfigOptions}
- * @see {@link provideServerRouting}
- * @deprecated use `provideServerRouting`. This will be removed in version 20.
  * @developerPreview
  */
 export declare function provideServerRoutesConfig(routes: ServerRoute[], options?: ServerRoutesConfigOptions): EnvironmentProviders;
 
-/**
- * Sets up the necessary providers for configuring server routes.
- * This function accepts an array of server routes and optional configuration
- * options, returning an `EnvironmentProviders` object that encapsulates
- * the server routes and configuration settings.
- *
- * @param routes - An array of server routes to be provided.
- * @param features - (Optional) server routes features.
- * @returns An `EnvironmentProviders` instance with the server routes configuration.
- *
- * @see {@link ServerRoute}
- * @see {@link withAppShell}
- * @developerPreview
- */
-export declare function provideServerRouting(routes: ServerRoute[], ...features: ServerRoutesFeature<ServerRoutesFeatureKind>[]): EnvironmentProviders;
-
 /**
  * Different rendering modes for server routes.
- * @see {@link provideServerRouting}
+ * @see {@link provideServerRoutesConfig}
  * @see {@link ServerRoute}
  * @developerPreview
  */
@@ -596,6 +576,12 @@ declare class RouteTree<AdditionalMetadata extends Record<string, unknown> = {}>
      * All routes are stored and accessed relative to this root node.
      */
     private readonly root;
+    /**
+     * A counter that tracks the order of route insertion.
+     * This ensures that routes are matched in the order they were defined,
+     * with earlier routes taking precedence.
+     */
+    private insertionIndexCounter;
     /**
      * Inserts a new route into the route tree.
      * The route is broken down into segments, and each segment is added to the tree.
@@ -655,14 +641,21 @@ declare class RouteTree<AdditionalMetadata extends Record<string, unknown> = {}>
      * This function prioritizes exact segment matches first, followed by wildcard matches (`*`),
      * and finally deep wildcard matches (`**`) that consume all segments.
      *
-     * @param segments - The array of route path segments to match against the route tree.
-     * @param node - The current node in the route tree to start traversal from. Defaults to the root node.
-     * @param currentIndex - The index of the segment in `remainingSegments` currently being matched.
-     * Defaults to `0` (the first segment).
+     * @param remainingSegments - The remaining segments of the route path to match.
+     * @param node - The current node in the route tree to start traversal from.
      *
      * @returns The node that best matches the remaining segments or `undefined` if no match is found.
      */
     private traverseBySegments;
+    /**
+     * Compares two nodes and returns the node with higher priority based on insertion index.
+     * A node with a lower insertion index is prioritized as it was defined earlier.
+     *
+     * @param currentBestMatchNode - The current best match node.
+     * @param candidateNode - The node being evaluated for higher priority based on insertion index.
+     * @returns The node with higher priority (i.e., lower insertion index). If one of the nodes is `undefined`, the other node is returned.
+     */
+    private getHigherPriorityNode;
     /**
      * Creates an empty route tree node.
      * This helper function is used during the tree construction.
@@ -678,6 +671,12 @@ declare class RouteTree<AdditionalMetadata extends Record<string, unknown> = {}>
  * The `AdditionalMetadata` type parameter allows for extending the node metadata with custom data.
  */
 declare interface RouteTreeNode<AdditionalMetadata extends Record<string, unknown>> {
+    /**
+     * The index indicating the order in which the route was inserted into the tree.
+     * This index helps determine the priority of routes during matching, with lower indexes
+     * indicating earlier inserted routes.
+     */
+    insertionIndex: number;
     /**
      * A map of child nodes, keyed by their corresponding route segment or wildcard.
      */
@@ -768,7 +767,7 @@ declare interface ServerAsset {
 
 /**
  * Server route configuration.
- * @see {@link provideServerRouting}
+ * @see {@link provideServerRoutesConfig}
  * @developerPreview
  */
 export declare type ServerRoute = ServerRouteClient | ServerRoutePrerender | ServerRoutePrerenderWithParams | ServerRouteServer;
@@ -860,15 +859,16 @@ export declare interface ServerRoutePrerenderWithParams extends Omit<ServerRoute
  * This interface defines the optional settings available for configuring server routes
  * in the server-side environment, such as specifying a path to the app shell route.
  *
- *
- * @see {@link provideServerRouting}
- * @deprecated use `provideServerRouting`. This will be removed in version 20.
+ * @see {@link provideServerRoutesConfig}
+ * @developerPreview
  */
 export declare interface ServerRoutesConfigOptions {
     /**
      * Defines the route to be used as the app shell, which serves as the main entry
      * point for the application. This route is often used to enable server-side rendering
      * of the application shell for requests that do not match any specific server route.
+     *
+     * @see {@link https://angular.dev/ecosystem/service-workers/app-shell | App shell pattern on Angular.dev}
      */
     appShellRoute?: string;
 }
@@ -883,44 +883,6 @@ export declare interface ServerRouteServer extends ServerRouteCommon {
     renderMode: RenderMode.Server;
 }
 
-/**
- * Helper type to represent a server routes feature.
- * @see {@link ServerRoutesFeatureKind}
- * @developerPreview
- */
-declare interface ServerRoutesFeature<FeatureKind extends ServerRoutesFeatureKind> {
-    ɵkind: FeatureKind;
-    ɵproviders: Provider[];
-}
-
-/**
- * Identifies a particular kind of `ServerRoutesFeatureKind`.
- * @see {@link ServerRoutesFeature}
- * @developerPreview
- */
-declare enum ServerRoutesFeatureKind {
-    AppShell = 0
-}
-
-/**
- * Configures the app shell route with the provided component.
- *
- * The app shell serves as the main entry point for the application and is commonly used
- * to enable server-side rendering (SSR) of the application shell. It handles requests
- * that do not match any specific server route, providing a fallback mechanism and improving
- * perceived performance during navigation.
- *
- * This configuration is particularly useful in applications leveraging Progressive Web App (PWA)
- * patterns, such as service workers, to deliver a seamless user experience.
- *
- * @param component The Angular component to render for the app shell route.
- * @returns A server routes feature configuration for the app shell.
- *
- * @see {@link provideServerRouting}
- * @see {@link https://angular.dev/ecosystem/service-workers/app-shell | App shell pattern on Angular.dev}
- */
-export declare function withAppShell(component: Type<unknown> | (() => Promise<Type<unknown> | DefaultExport<Type<unknown>>>)): ServerRoutesFeature<ServerRoutesFeatureKind.AppShell>;
-
 /**
  * Destroys the existing `AngularServerApp` instance, releasing associated resources and resetting the
  * reference to `undefined`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/ssr",
-  "version": "19.1.6",
+  "version": "19.2.0-next.0",
   "description": "Angular server side rendering utilities",
   "type": "module",
   "license": "MIT",
@@ -17,10 +17,10 @@
     "tslib": "^2.3.0"
   },
   "peerDependencies": {
-    "@angular/common": "^19.0.0",
-    "@angular/core": "^19.0.0",
-    "@angular/platform-server": "^19.0.0",
-    "@angular/router": "^19.0.0"
+    "@angular/common": "^19.0.0 || ^19.2.0-next.0",
+    "@angular/core": "^19.0.0 || ^19.2.0-next.0",
+    "@angular/platform-server": "^19.0.0 || ^19.2.0-next.0",
+    "@angular/router": "^19.0.0 || ^19.2.0-next.0"
   },
   "peerDependenciesMeta": {
     "@angular/platform-server": {
@@ -28,13 +28,13 @@
     }
   },
   "devDependencies": {
-    "@angular/common": "19.1.0-rc.0",
-    "@angular/compiler": "19.1.0-rc.0",
-    "@angular/core": "19.1.0-rc.0",
-    "@angular/platform-browser": "19.1.0-rc.0",
-    "@angular/platform-server": "19.1.0-rc.0",
-    "@angular/router": "19.1.0-rc.0",
-    "@bazel/runfiles": "^5.8.1"
+    "@angular/common": "19.2.0-next.0",
+    "@angular/compiler": "19.2.0-next.0",
+    "@angular/core": "19.2.0-next.0",
+    "@angular/platform-browser": "19.2.0-next.0",
+    "@angular/platform-server": "19.2.0-next.0",
+    "@angular/router": "19.2.0-next.0",
+    "@bazel/runfiles": "^6.0.0"
   },
   "sideEffects": false,
   "schematics": "./schematics/collection.json",

package/third_party/beasties/index.js

@@ -1198,9 +1198,12 @@ function requireNode$1 () {
 	    if (opts.index) {
 	      pos = this.positionInside(opts.index);
 	    } else if (opts.word) {
-	      let stringRepresentation = this.source.input.css.slice(
-	        sourceOffset(this.source.input.css, this.source.start),
-	        sourceOffset(this.source.input.css, this.source.end)
+	      let inputString = ('document' in this.source.input)
+	        ? this.source.input.document
+	        : this.source.input.css;
+	      let stringRepresentation = inputString.slice(
+	        sourceOffset(inputString, this.source.start),
+	        sourceOffset(inputString, this.source.end)
 	      );
 	      let index = stringRepresentation.indexOf(opts.word);
 	      if (index !== -1) pos = this.positionInside(index);
@@ -1211,11 +1214,14 @@ function requireNode$1 () {
 	  positionInside(index) {
 	    let column = this.source.start.column;
 	    let line = this.source.start.line;
-	    let offset = sourceOffset(this.source.input.css, this.source.start);
+	    let inputString = ('document' in this.source.input)
+	      ? this.source.input.document
+	      : this.source.input.css;
+	    let offset = sourceOffset(inputString, this.source.start);
 	    let end = offset + index;
 
 	    for (let i = offset; i < end; i++) {
-	      if (this.source.input.css[i] === '\n') {
+	      if (inputString[i] === '\n') {
 	        column = 1;
 	        line += 1;
 	      } else {
@@ -1248,9 +1254,12 @@ function requireNode$1 () {
 	        };
 
 	    if (opts.word) {
-	      let stringRepresentation = this.source.input.css.slice(
-	        sourceOffset(this.source.input.css, this.source.start),
-	        sourceOffset(this.source.input.css, this.source.end)
+	      let inputString = ('document' in this.source.input)
+	        ? this.source.input.document
+	        : this.source.input.css;
+	      let stringRepresentation = inputString.slice(
+	        sourceOffset(inputString, this.source.start),
+	        sourceOffset(inputString, this.source.end)
 	      );
 	      let index = stringRepresentation.indexOf(opts.word);
 	      if (index !== -1) {
@@ -2232,6 +2241,9 @@ function requireInput () {
 	      this.hasBOM = false;
 	    }
 
+	    this.document = this.css;
+	    if (opts.document) this.document = opts.document.toString();
+
 	    if (opts.from) {
 	      if (
 	        !pathAvailable ||
@@ -4832,7 +4844,7 @@ function requireProcessor () {
 
 	class Processor {
 	  constructor(plugins = []) {
-	    this.version = '8.4.49';
+	    this.version = '8.5.1';
 	    this.plugins = this.normalize(plugins);
 	  }