@loozo/angular-router 0.0.3 → 0.0.5

package/schemas/serve.json

@@ -1,18 +1,153 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema",
-  "$comment": "Every option except poll is an @angular/build:dev-server option, passed through and validated by that builder. Router options come from buildTarget.",
+  "$comment": "Generated by scripts/builder-schemas.mjs from the @angular/build 22.2.2 dev-server schema plus the router options. Do not edit. The @angular/build schema portions are distributed under this license:\n\nThe MIT License\n\nCopyright (c) 2010-2026 Google LLC. https://angular.dev/license\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.",
+  "title": "Dev Server Target",
+  "description": "Dev Server target options for Build Facade.",
   "type": "object",
-  "additionalProperties": true,
-  "required": ["buildTarget"],
   "properties": {
     "buildTarget": {
       "type": "string",
-      "minLength": 1,
-      "description": "A target using @loozo/angular-router:application, as project:target[:configuration]."
+      "description": "A target using @loozo/angular-router:application, as project:target[:configuration]. Router options come from it.",
+      "pattern": "^[^:\\s]*:[^:\\s]*(:[^\\s]+)?$"
+    },
+    "port": {
+      "type": "number",
+      "description": "Port to listen on.",
+      "default": 4200
+    },
+    "host": {
+      "type": "string",
+      "description": "Host to listen on.",
+      "default": "localhost"
+    },
+    "proxyConfig": {
+      "type": "string",
+      "description": "Proxy configuration file. For more information, see https://angular.dev/tools/cli/serve#proxying-to-a-backend-server."
+    },
+    "ssl": {
+      "type": "boolean",
+      "description": "Serve using HTTPS.",
+      "default": false
+    },
+    "sslKey": {
+      "type": "string",
+      "description": "SSL key to use for serving HTTPS."
+    },
+    "sslCert": {
+      "type": "string",
+      "description": "SSL certificate to use for serving HTTPS."
+    },
+    "allowedHosts": {
+      "description": "The hosts that the development server will respond to. This option sets the Vite option of the same name. For further details: https://vite.dev/config/server-options.html#server-allowedhosts",
+      "default": [],
+      "oneOf": [
+        {
+          "type": "array",
+          "description": "A list of hosts that the development server will respond to.",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "boolean",
+          "description": "Indicates that all hosts are allowed. This is not recommended and a security risk."
+        }
+      ]
+    },
+    "define": {
+      "description": "Defines global identifiers that will be replaced with a specified constant value when found in any JavaScript or TypeScript code including libraries. The value will be used directly. String values must be put in quotes. Identifiers within Angular metadata such as Component Decorators will not be replaced.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "headers": {
+      "type": "object",
+      "description": "Custom HTTP headers to be added to all responses.",
+      "propertyNames": {
+        "pattern": "^[-_A-Za-z0-9]+$"
+      },
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "open": {
+      "type": "boolean",
+      "description": "Opens the url in default browser.",
+      "default": false,
+      "alias": "o"
+    },
+    "verbose": {
+      "type": "boolean",
+      "description": "Adds more details to output logging."
+    },
+    "liveReload": {
+      "type": "boolean",
+      "description": "Whether to reload the page on change, using live-reload.",
+      "default": true
+    },
+    "servePath": {
+      "type": "string",
+      "description": "The pathname where the application will be served."
+    },
+    "hmr": {
+      "type": "boolean",
+      "description": "Enable hot module replacement. Defaults to the value of 'liveReload'. Currently, only global and component stylesheets are supported."
+    },
+    "watch": {
+      "type": "boolean",
+      "description": "Rebuild on change.",
+      "default": true
     },
     "poll": {
       "description": "Watch by polling every this many milliseconds. Defaults to 1000 when omitted. false adds no default, so Angular's own configuration applies, including a poll on the build target.",
-      "oneOf": [{ "type": "number", "exclusiveMinimum": 0 }, { "const": false }]
+      "oneOf": [
+        {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        {
+          "const": false
+        }
+      ]
+    },
+    "inspect": {
+      "default": false,
+      "description": "Activate debugging inspector. This option only has an effect when 'SSR' or 'SSG' are enabled.",
+      "oneOf": [
+        {
+          "type": "string",
+          "description": "Activate the inspector on host and port in the format of `[[host:]port]`. See the security warning in https://nodejs.org/docs/latest-v22.x/api/cli.html#warning-binding-inspector-to-a-public-ipport-combination-is-insecure regarding the host parameter usage."
+        },
+        {
+          "type": "boolean"
+        }
+      ]
+    },
+    "prebundle": {
+      "description": "Enable and control the Vite-based development server's prebundling capabilities. To enable prebundling, the Angular CLI cache must also be enabled.",
+      "default": true,
+      "oneOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "exclude": {
+              "description": "List of package imports that should not be prebundled by the development server. The packages will be bundled into the application code itself. Note: specifying `@foo/bar` marks all paths within the `@foo/bar` package as excluded, including sub-paths like `@foo/bar/baz`.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false,
+          "required": ["exclude"]
+        }
+      ]
     }
-  }
+  },
+  "additionalProperties": false,
+  "required": ["buildTarget"]
 }

package/snippets/angular.json

@@ -0,0 +1,29 @@
+{
+  "version": 1,
+  "projects": {
+    "app": {
+      "projectType": "application",
+      "root": "",
+      "sourceRoot": "src",
+      "architect": {
+        "build": {
+          "builder": "@loozo/angular-router:application",
+          "options": {
+            "tsconfig": "tsconfig.routes.json",
+            "scanDirectories": ["src/routes"],
+            "outDirectory": "generated",
+            "browser": "src/main.ts",
+            "index": "src/index.html",
+            "tsConfig": "tsconfig.app.json",
+            "outputPath": "dist/app"
+          },
+          "configurations": { "ci": { "check": true } }
+        },
+        "serve": {
+          "builder": "@loozo/angular-router:serve",
+          "options": { "buildTarget": "app:build" }
+        }
+      }
+    }
+  }
+}

package/snippets/generated/destinations.generated.ts

@@ -0,0 +1,126 @@
+// @loozo/angular-router routegen: owned destinations.generated.ts
+import type { RouteSet, Handle as GeneratedHandle, Destination as GeneratedDestination } from '@loozo/angular-router/_generated';
+import definition0 from "../src/routes/products/$productId/route.js";
+import definition1 from "../src/routes/reports/$reportId/route.js";
+import definition2 from "../src/routes/teams/$teamId/items/$id/route.js";
+import definition3 from "../src/routes/teams/$teamId/members/$memberId/route.js";
+import definition4 from "../src/routes/teams/$teamId/old-items/$id/route.js";
+import definition5 from "../src/routes/teams/$teamId/route.js";
+
+export type Definitions = {
+"src/routes/products/$productId/route.ts": typeof definition0;
+"src/routes/reports/$reportId/route.ts": typeof definition1;
+"src/routes/teams/$teamId/items/$id/route.ts": typeof definition2;
+"src/routes/teams/$teamId/members/$memberId/route.ts": typeof definition3;
+"src/routes/teams/$teamId/old-items/$id/route.ts": typeof definition4;
+"src/routes/teams/$teamId/route.ts": typeof definition5;
+};
+declare const setIdentity: unique symbol;
+export type AbsoluteTargets = {
+"/products/$productId": "src/routes/products/$productId/route.ts";
+"/reports/$reportId": "src/routes/reports/$reportId/route.ts";
+"/teams/$teamId/items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"/teams/$teamId/members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"/teams/$teamId/old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"/teams/$teamId": "src/routes/teams/$teamId/route.ts";
+};
+export type RelativeTargets = {
+"src/routes/products/$productId/route.ts": {
+"./": "src/routes/products/$productId/route.ts";
+"../$productId": "src/routes/products/$productId/route.ts";
+"../../products/$productId": "src/routes/products/$productId/route.ts";
+"../../reports/$reportId": "src/routes/reports/$reportId/route.ts";
+"../../teams/$teamId/items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../teams/$teamId/members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../teams/$teamId/old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../../teams/$teamId": "src/routes/teams/$teamId/route.ts";
+};
+"src/routes/reports/$reportId/route.ts": {
+"./": "src/routes/reports/$reportId/route.ts";
+"../$reportId": "src/routes/reports/$reportId/route.ts";
+"../../products/$productId": "src/routes/products/$productId/route.ts";
+"../../reports/$reportId": "src/routes/reports/$reportId/route.ts";
+"../../teams/$teamId/items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../teams/$teamId/members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../teams/$teamId/old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../../teams/$teamId": "src/routes/teams/$teamId/route.ts";
+};
+"src/routes/teams/$teamId/items/$id/route.ts": {
+"./": "src/routes/teams/$teamId/items/$id/route.ts";
+"../$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../..": "src/routes/teams/$teamId/route.ts";
+"../../": "src/routes/teams/$teamId/route.ts";
+"../../../$teamId/items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../../$teamId/members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../../$teamId/old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../../../$teamId": "src/routes/teams/$teamId/route.ts";
+"../../../../products/$productId": "src/routes/products/$productId/route.ts";
+"../../../../reports/$reportId": "src/routes/reports/$reportId/route.ts";
+"../../../../teams/$teamId/items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../../../teams/$teamId/members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../../../teams/$teamId/old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../../../../teams/$teamId": "src/routes/teams/$teamId/route.ts";
+};
+"src/routes/teams/$teamId/members/$memberId/route.ts": {
+"./": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../..": "src/routes/teams/$teamId/route.ts";
+"../../": "src/routes/teams/$teamId/route.ts";
+"../../../$teamId/items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../../$teamId/members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../../$teamId/old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../../../$teamId": "src/routes/teams/$teamId/route.ts";
+"../../../../products/$productId": "src/routes/products/$productId/route.ts";
+"../../../../reports/$reportId": "src/routes/reports/$reportId/route.ts";
+"../../../../teams/$teamId/items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../../../teams/$teamId/members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../../../teams/$teamId/old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../../../../teams/$teamId": "src/routes/teams/$teamId/route.ts";
+};
+"src/routes/teams/$teamId/route.ts": {
+"./items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"./members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"./old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"./": "src/routes/teams/$teamId/route.ts";
+"../$teamId/items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../$teamId/members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../$teamId/old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../$teamId": "src/routes/teams/$teamId/route.ts";
+"../../products/$productId": "src/routes/products/$productId/route.ts";
+"../../reports/$reportId": "src/routes/reports/$reportId/route.ts";
+"../../teams/$teamId/items/$id": "src/routes/teams/$teamId/items/$id/route.ts";
+"../../teams/$teamId/members/$memberId": "src/routes/teams/$teamId/members/$memberId/route.ts";
+"../../teams/$teamId/old-items/$id": "src/routes/teams/$teamId/old-items/$id/route.ts";
+"../../teams/$teamId": "src/routes/teams/$teamId/route.ts";
+};
+};
+export type Selected<Id extends keyof RelativeTargets> = {
+  readonly [Expression in keyof AbsoluteTargets | keyof RelativeTargets[Id]]:
+    Definitions[(Expression extends keyof AbsoluteTargets ? AbsoluteTargets[Expression] :
+      Expression extends keyof RelativeTargets[Id] ? RelativeTargets[Id][Expression] : never) & keyof Definitions];
+};
+/** A declaration-bound handle; obtain it through its colocated injectRoute facade. */
+export type Handle<Id extends keyof RelativeTargets> = GeneratedHandle<Definitions[Id], Selected<Id>, typeof setIdentity, Pick<Definitions, keyof RelativeTargets>>;
+/** A same-set nominal reference; use the destination exported by a colocated facade. */
+export type Destination<Id extends keyof RelativeTargets> = GeneratedDestination<Definitions[Id], typeof setIdentity, Id>;
+const routeSet: RouteSet = { records: {
+"src/routes/products/$productId/route.ts": { definition: () => definition0, owners: ["src/routes/products/$productId/route.ts"] },
+"src/routes/reports/$reportId/route.ts": { definition: () => definition1, owners: ["src/routes/reports/$reportId/route.ts"] },
+"src/routes/teams/$teamId/items/$id/route.ts": { definition: () => definition2, owners: ["src/routes/teams/$teamId/route.ts","src/routes/teams/$teamId/items/$id/route.ts"] },
+"src/routes/teams/$teamId/members/$memberId/route.ts": { definition: () => definition3, owners: ["src/routes/teams/$teamId/route.ts","src/routes/teams/$teamId/members/$memberId/route.ts"] },
+"src/routes/teams/$teamId/route.ts": { definition: () => definition5, owners: ["src/routes/teams/$teamId/route.ts"] },
+}, destinations: {
+"src/routes/products/$productId/route.ts": () => definition0,
+"src/routes/reports/$reportId/route.ts": () => definition1,
+"src/routes/teams/$teamId/items/$id/route.ts": () => definition2,
+"src/routes/teams/$teamId/members/$memberId/route.ts": () => definition3,
+"src/routes/teams/$teamId/old-items/$id/route.ts": () => definition4,
+"src/routes/teams/$teamId/route.ts": () => definition5,
+}, absolute: {"/products/$productId":"src/routes/products/$productId/route.ts","/reports/$reportId":"src/routes/reports/$reportId/route.ts","/teams/$teamId/items/$id":"src/routes/teams/$teamId/items/$id/route.ts","/teams/$teamId/members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","/teams/$teamId/old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","/teams/$teamId":"src/routes/teams/$teamId/route.ts"}, relative: {"src/routes/products/$productId/route.ts":{"./":"src/routes/products/$productId/route.ts","../$productId":"src/routes/products/$productId/route.ts","../../products/$productId":"src/routes/products/$productId/route.ts","../../reports/$reportId":"src/routes/reports/$reportId/route.ts","../../teams/$teamId/items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../../teams/$teamId/members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../teams/$teamId/old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../../teams/$teamId":"src/routes/teams/$teamId/route.ts"},"src/routes/reports/$reportId/route.ts":{"./":"src/routes/reports/$reportId/route.ts","../$reportId":"src/routes/reports/$reportId/route.ts","../../products/$productId":"src/routes/products/$productId/route.ts","../../reports/$reportId":"src/routes/reports/$reportId/route.ts","../../teams/$teamId/items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../../teams/$teamId/members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../teams/$teamId/old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../../teams/$teamId":"src/routes/teams/$teamId/route.ts"},"src/routes/teams/$teamId/items/$id/route.ts":{"./":"src/routes/teams/$teamId/items/$id/route.ts","../$id":"src/routes/teams/$teamId/items/$id/route.ts","../../items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../../members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../..":"src/routes/teams/$teamId/route.ts","../../":"src/routes/teams/$teamId/route.ts","../../../$teamId/items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../../../$teamId/members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../../$teamId/old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../../../$teamId":"src/routes/teams/$teamId/route.ts","../../../../products/$productId":"src/routes/products/$productId/route.ts","../../../../reports/$reportId":"src/routes/reports/$reportId/route.ts","../../../../teams/$teamId/items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../../../../teams/$teamId/members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../../../teams/$teamId/old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../../../../teams/$teamId":"src/routes/teams/$teamId/route.ts"},"src/routes/teams/$teamId/members/$memberId/route.ts":{"./":"src/routes/teams/$teamId/members/$memberId/route.ts","../$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../../members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../..":"src/routes/teams/$teamId/route.ts","../../":"src/routes/teams/$teamId/route.ts","../../../$teamId/items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../../../$teamId/members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../../$teamId/old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../../../$teamId":"src/routes/teams/$teamId/route.ts","../../../../products/$productId":"src/routes/products/$productId/route.ts","../../../../reports/$reportId":"src/routes/reports/$reportId/route.ts","../../../../teams/$teamId/items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../../../../teams/$teamId/members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../../../teams/$teamId/old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../../../../teams/$teamId":"src/routes/teams/$teamId/route.ts"},"src/routes/teams/$teamId/route.ts":{"./items/$id":"src/routes/teams/$teamId/items/$id/route.ts","./members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","./old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","./":"src/routes/teams/$teamId/route.ts","../$teamId/items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../$teamId/members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../$teamId/old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../$teamId":"src/routes/teams/$teamId/route.ts","../../products/$productId":"src/routes/products/$productId/route.ts","../../reports/$reportId":"src/routes/reports/$reportId/route.ts","../../teams/$teamId/items/$id":"src/routes/teams/$teamId/items/$id/route.ts","../../teams/$teamId/members/$memberId":"src/routes/teams/$teamId/members/$memberId/route.ts","../../teams/$teamId/old-items/$id":"src/routes/teams/$teamId/old-items/$id/route.ts","../../teams/$teamId":"src/routes/teams/$teamId/route.ts"}} };
+export function getRouteSet(): RouteSet { return routeSet; }

package/snippets/generated/routes.generated.ts

@@ -0,0 +1,35 @@
+// @loozo/angular-router routegen: owned routes.generated.ts
+import type { Routes } from '@angular/router';
+import { getRouteSet } from './destinations.generated.js';
+import { nativeOptions, callbacks, redirect } from '@loozo/angular-router/_generated';
+import definition2 from "../src/routes/teams/$teamId/items/$id/route.js";
+import definition4 from "../src/routes/teams/$teamId/old-items/$id/route.js";
+
+/**
+ * Generated native Angular route configuration; install with provideRouter(routes).
+ * Regenerate through the router's Architect companions instead of editing this file.
+ */
+export const routes: Routes = [{ path: "teams/:teamId/old-items/:id",
+pathMatch: 'full',
+data: { __loozoAngularRouterRouteId: "src/routes/teams/$teamId/old-items/$id/route.ts" },
+redirectTo: redirect(() => definition4) },
+{ path: "products/:productId",
+data: { __loozoAngularRouterRouteId: "src/routes/products/$productId/route.ts" },
+...callbacks(getRouteSet(), "src/routes/products/$productId/route.ts"),
+loadComponent: () => import("../src/routes/products/$productId/page") },
+{ path: "reports/:reportId",
+data: { __loozoAngularRouterRouteId: "src/routes/reports/$reportId/route.ts" },
+...callbacks(getRouteSet(), "src/routes/reports/$reportId/route.ts"),
+loadComponent: () => import("../src/routes/reports/$reportId/page") },
+{ path: "teams/:teamId",
+data: { __loozoAngularRouterRouteId: "src/routes/teams/$teamId/route.ts" },
+...callbacks(getRouteSet(), "src/routes/teams/$teamId/route.ts"),
+children: [{ ...nativeOptions(definition2),
+path: "items/:id",
+data: { __loozoAngularRouterRouteId: "src/routes/teams/$teamId/items/$id/route.ts" },
+...callbacks(getRouteSet(), "src/routes/teams/$teamId/items/$id/route.ts"),
+loadComponent: () => import("../src/routes/teams/$teamId/items/$id/page") },
+{ path: "members/:memberId",
+data: { __loozoAngularRouterRouteId: "src/routes/teams/$teamId/members/$memberId/route.ts" },
+...callbacks(getRouteSet(), "src/routes/teams/$teamId/members/$memberId/route.ts"),
+loadComponent: () => import("../src/routes/teams/$teamId/members/$memberId/page") }] }];

package/snippets/src/catalog.ts

@@ -0,0 +1,20 @@
+import { InjectionToken } from "@angular/core";
+
+export interface ItemQuery {
+  readonly teamId: number;
+  readonly id: number;
+  readonly score: number | undefined;
+}
+
+export interface Item extends ItemQuery {
+  readonly name: string;
+}
+
+export const ItemCatalog = new InjectionToken<(query: ItemQuery) => Promise<Item>>("ItemCatalog", {
+  providedIn: "root",
+  factory: () => {
+    return async (query) => {
+      return { ...query, name: `Item ${query.id}` };
+    };
+  },
+});

package/snippets/src/docs-url.ts

@@ -0,0 +1,8 @@
+import { createUrl, defineRoute, stringParam } from "@loozo/angular-router";
+
+// #region catchall
+const docs = defineRoute("docs/$segments[]", { params: { segments: stringParam } });
+
+createUrl(docs, { params: { segments: ["guides", "setup"] } }); // "/docs/guides/setup"
+createUrl(docs, { params: { segments: [] } }); // "/docs"
+// #endregion catchall

package/snippets/src/index.html

@@ -0,0 +1,11 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>App</title>
+    <base href="/" />
+  </head>
+  <body>
+    <app-shell></app-shell>
+  </body>
+</html>

package/snippets/src/main.ts

@@ -0,0 +1,6 @@
+import { bootstrapApplication } from "@angular/platform-browser";
+import { provideRouter } from "@angular/router";
+import Shell from "./shell.js";
+import { routes } from "../generated/routes.generated.js";
+
+void bootstrapApplication(Shell, { providers: [provideRouter(routes)] });

package/snippets/src/product-url.ts

@@ -0,0 +1,8 @@
+import { createUrl } from "@loozo/angular-router";
+import product from "./routes/products/$productId/route.js";
+
+createUrl(product, {
+  params: { productId: 42 },
+  search: { tab: "reviews" },
+  fragment: "summary",
+}); // "/products/42?tab=reviews#summary"

package/snippets/src/routes/products/$productId/page.ts

@@ -0,0 +1,20 @@
+import { Component } from "@angular/core";
+import { RouterLink } from "@angular/router";
+import { injectRoute } from "./route.generated.js";
+
+@Component({
+  imports: [RouterLink],
+  template: `
+    <h1>Product {{ route.params().productId }}</h1>
+    <p>Tab: {{ route.search().tab }}</p>
+    <a [routerLink]="reviews">Reviews</a>
+  `,
+})
+export default class Product {
+  readonly route = injectRoute();
+  readonly reviews = this.route.link({
+    params: { productId: 42 },
+    search: { tab: "reviews" },
+    fragment: "reviews",
+  });
+}

package/snippets/src/routes/products/$productId/route.generated.ts

@@ -0,0 +1,24 @@
+// @loozo/angular-router routegen: owned route.generated.ts
+import { createDestination, injectGeneratedRoute } from '@loozo/angular-router/_generated';
+import { getRouteSet, type Destination, type Handle } from "../../../../generated/destinations.generated.js";
+export { defineRoute } from '@loozo/angular-router';
+/**
+ * Inert reference to this exact declaration for same-set handle link/navigate calls.
+ * No injection context is required; copies and foreign-set references are invalid.
+ * This is not an authored route and cannot be passed to the root createUrl function.
+ */
+export const destination: Destination<"src/routes/products/$productId/route.ts"> = createDestination(() => getRouteSet(), "src/routes/products/$productId/route.ts");
+/**
+ * Injects a typed handle bound to this exact generated activated route record.
+ *
+ * @remarks
+ * Call in an Angular injection context. The handle exposes readonly native
+ * params/search/data Signals and destination-typed link/navigate methods.
+ * Data includes local resolver results only, not static or inherited data.
+ * All navigation values are explicit; current inputs are never reused implicitly.
+ *
+ * @returns A noncallable handle for this declaration.
+ * @throws A synchronous wiring error outside an injection context or when the
+ * activated record does not carry this declaration's own generated identity.
+ */
+export function injectRoute(): Handle<"src/routes/products/$productId/route.ts"> { return injectGeneratedRoute(getRouteSet(), "src/routes/products/$productId/route.ts"); }

package/snippets/src/routes/products/$productId/route.ts

@@ -0,0 +1,7 @@
+import { defineRoute, enumParam, numberParam, withFallback } from "@loozo/angular-router";
+
+export default defineRoute("products/$productId", {
+  params: { productId: numberParam },
+  search: { tab: withFallback(enumParam(["details", "reviews"]), "details") },
+  fragments: ["summary", "reviews"],
+});

package/snippets/src/routes/reports/$reportId/page.ts

@@ -0,0 +1,9 @@
+import { Component } from "@angular/core";
+import { injectRoute } from "./route.generated.js";
+
+@Component({
+  template: `<h1>Report {{ route.params().reportId }}</h1>`,
+})
+export default class Report {
+  readonly route = injectRoute();
+}

package/snippets/src/routes/reports/$reportId/route.generated.ts

@@ -0,0 +1,24 @@
+// @loozo/angular-router routegen: owned route.generated.ts
+import { createDestination, injectGeneratedRoute } from '@loozo/angular-router/_generated';
+import { getRouteSet, type Destination, type Handle } from "../../../../generated/destinations.generated.js";
+export { defineRoute } from '@loozo/angular-router';
+/**
+ * Inert reference to this exact declaration for same-set handle link/navigate calls.
+ * No injection context is required; copies and foreign-set references are invalid.
+ * This is not an authored route and cannot be passed to the root createUrl function.
+ */
+export const destination: Destination<"src/routes/reports/$reportId/route.ts"> = createDestination(() => getRouteSet(), "src/routes/reports/$reportId/route.ts");
+/**
+ * Injects a typed handle bound to this exact generated activated route record.
+ *
+ * @remarks
+ * Call in an Angular injection context. The handle exposes readonly native
+ * params/search/data Signals and destination-typed link/navigate methods.
+ * Data includes local resolver results only, not static or inherited data.
+ * All navigation values are explicit; current inputs are never reused implicitly.
+ *
+ * @returns A noncallable handle for this declaration.
+ * @throws A synchronous wiring error outside an injection context or when the
+ * activated record does not carry this declaration's own generated identity.
+ */
+export function injectRoute(): Handle<"src/routes/reports/$reportId/route.ts"> { return injectGeneratedRoute(getRouteSet(), "src/routes/reports/$reportId/route.ts"); }

package/snippets/src/routes/reports/$reportId/route.ts

@@ -0,0 +1,6 @@
+import { defineRoute, numberParam } from "@loozo/angular-router";
+
+export default defineRoute("reports/$reportId", {
+  params: { reportId: numberParam },
+  canActivate: [({ params }) => params.reportId > 0],
+});

package/snippets/src/routes/teams/$teamId/items/$id/inputs.ts

@@ -0,0 +1,15 @@
+// Shows the handle's input types; the README embeds the region below.
+/* oxlint-disable no-unused-expressions */
+
+// #region inputs
+import { injectRoute } from "./route.generated.js";
+
+// injectRoute() needs an injection context, such as a component field initializer.
+export function readInputs() {
+  const route = injectRoute();
+
+  route.params(); // { teamId: number; id: number }
+  route.search(); // { score?: number }
+  route.data(); // { item: Item }, local resolver results only
+}
+// #endregion inputs

package/snippets/src/routes/teams/$teamId/items/$id/links.ts

@@ -0,0 +1,13 @@
+import { destination as report } from "../../../../reports/$reportId/route.generated.js";
+import { injectRoute } from "./route.generated.js";
+
+// injectRoute() needs an injection context, such as a component field initializer.
+export function itemLinks() {
+  const route = injectRoute();
+
+  route.link({ params: { teamId: 7, id: 8 } }); // this route
+  route.link(".", { params: { teamId: 7, id: 8 } }); // same as above
+  route.link("/teams/$teamId/items/$id", { params: { teamId: 7, id: 9 } }); // absolute
+  route.link("../..", { params: { teamId: 7 } }); // relative
+  void route.navigate(report, { params: { reportId: 42 } }); // another route's destination
+}

package/snippets/src/routes/teams/$teamId/items/$id/page.ts

@@ -0,0 +1,9 @@
+import { Component } from "@angular/core";
+import { injectRoute } from "./route.generated.js";
+
+@Component({
+  template: `<h1>{{ route.data().item.name }}</h1>`,
+})
+export default class Item {
+  readonly route = injectRoute();
+}

package/snippets/src/routes/teams/$teamId/items/$id/route.generated.ts

@@ -0,0 +1,24 @@
+// @loozo/angular-router routegen: owned route.generated.ts
+import { createDestination, injectGeneratedRoute } from '@loozo/angular-router/_generated';
+import { getRouteSet, type Destination, type Handle } from "../../../../../../generated/destinations.generated.js";
+export { defineRoute } from '@loozo/angular-router';
+/**
+ * Inert reference to this exact declaration for same-set handle link/navigate calls.
+ * No injection context is required; copies and foreign-set references are invalid.
+ * This is not an authored route and cannot be passed to the root createUrl function.
+ */
+export const destination: Destination<"src/routes/teams/$teamId/items/$id/route.ts"> = createDestination(() => getRouteSet(), "src/routes/teams/$teamId/items/$id/route.ts");
+/**
+ * Injects a typed handle bound to this exact generated activated route record.
+ *
+ * @remarks
+ * Call in an Angular injection context. The handle exposes readonly native
+ * params/search/data Signals and destination-typed link/navigate methods.
+ * Data includes local resolver results only, not static or inherited data.
+ * All navigation values are explicit; current inputs are never reused implicitly.
+ *
+ * @returns A noncallable handle for this declaration.
+ * @throws A synchronous wiring error outside an injection context or when the
+ * activated record does not carry this declaration's own generated identity.
+ */
+export function injectRoute(): Handle<"src/routes/teams/$teamId/items/$id/route.ts"> { return injectGeneratedRoute(getRouteSet(), "src/routes/teams/$teamId/items/$id/route.ts"); }

package/snippets/src/routes/teams/$teamId/items/$id/route.ts

@@ -0,0 +1,18 @@
+import { inject } from "@angular/core";
+import { defineRoute, numberParam } from "@loozo/angular-router";
+import team from "../../route.js";
+import { ItemCatalog } from "../../../../../catalog.js";
+
+export default defineRoute("items/$id", {
+  parent: team,
+  params: { id: numberParam },
+  runGuardsAndResolvers: "paramsOrQueryParamsChange",
+  title: ({ params }) => `Item ${params.id}`,
+  resolve: {
+    item: ({ params, search }) => {
+      const catalog = inject(ItemCatalog);
+
+      return catalog({ teamId: params.teamId, id: params.id, score: search.score });
+    },
+  },
+});