@loozo/angular-router 0.0.2 → 0.0.4

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 });
+    },
+  },
+});

package/snippets/src/routes/teams/$teamId/members/$memberId/page.ts

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

package/snippets/src/routes/teams/$teamId/members/$memberId/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/members/$memberId/route.ts"> = createDestination(() => getRouteSet(), "src/routes/teams/$teamId/members/$memberId/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/members/$memberId/route.ts"> { return injectGeneratedRoute(getRouteSet(), "src/routes/teams/$teamId/members/$memberId/route.ts"); }

package/snippets/src/routes/teams/$teamId/members/$memberId/route.ts

@@ -0,0 +1,7 @@
+import { defineRoute, numberParam } from "@loozo/angular-router";
+import team from "../../route.js";
+
+export default defineRoute("members/$memberId", {
+  parent: team,
+  params: { memberId: numberParam },
+});

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

@@ -0,0 +1,13 @@
+import { defineRoute, numberParam } from "@loozo/angular-router";
+import team from "../../route.js";
+import item from "../../items/$id/route.js";
+
+export default defineRoute("old-items/$id", {
+  parent: team,
+  params: { id: numberParam },
+  redirect: {
+    to: item,
+    search: { mode: "drop" }, // or "preserve", or { mode: "replace", values }
+    fragment: { mode: "drop" }, // or "preserve", or { mode: "replace", value }
+  },
+});

package/snippets/src/routes/teams/$teamId/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/route.ts"> = createDestination(() => getRouteSet(), "src/routes/teams/$teamId/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/route.ts"> { return injectGeneratedRoute(getRouteSet(), "src/routes/teams/$teamId/route.ts"); }

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

@@ -0,0 +1,6 @@
+import { defineRoute, numberParam } from "@loozo/angular-router";
+
+export default defineRoute("teams/$teamId", {
+  params: { teamId: numberParam },
+  search: { score: numberParam },
+});

package/snippets/src/shell.ts

@@ -0,0 +1,9 @@
+import { Component } from "@angular/core";
+import { RouterOutlet } from "@angular/router";
+
+@Component({
+  selector: "app-shell",
+  imports: [RouterOutlet],
+  template: "<router-outlet />",
+})
+export default class Shell {}

package/snippets/src/slug.ts

@@ -0,0 +1,14 @@
+import type { ParamCodec } from "@loozo/angular-router";
+
+export const slug: ParamCodec<string> = {
+  parse(raw) {
+    if (!/^[a-z0-9-]+$/.test(raw)) {
+      throw new Error("invalid slug");
+    }
+
+    return raw;
+  },
+  stringify(value) {
+    return value;
+  },
+};

package/snippets/tsconfig.app.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "lib": ["ES2022", "DOM"],
+    "types": []
+  },
+  "angularCompilerOptions": { "strictTemplates": true },
+  "files": ["src/main.ts"],
+  "include": ["src/**/*.ts", "generated/**/*.ts"]
+}

package/snippets/tsconfig.routes.json

@@ -0,0 +1,5 @@
+{
+  "extends": "./tsconfig.app.json",
+  "files": [],
+  "include": ["src/**/*.ts"]
+}