angular-typed-router 0.1.1-0

package/README.md

@@ -0,0 +1,208 @@
+# angular-typed-router
+
+## Attention: Still in experimental phase
+
+Type-safe ergonomic primitives on top of Angular's standalone router. Automatically derive a compile‑time union of valid route URL strings (`Path`) and strongly typed navigation command tuples (`Commands`) from the consumer application's `Routes` definition – without generating code or adding runtime weight.
+
+## Why
+
+Angular's router is powerful but untyped for URL literals – a misspelled path or an outdated segment only fails at runtime. This library lets your application declare routes once, then:
+- Navigate with `TypedRouter.navigateByUrl(path)` where `path` is validated at compile time.
+- Use `<a routerLink="...">` with type checking via an augmented `TypedRouterLink` directive.
+- Build command tuples with correct literal segments (`Commands` type).
+
+No decorators, no custom builders, no code generation – just TypeScript type inference and interface augmentation.
+
+## Installation
+
+```bash
+npm install angular-typed-router
+# or
+pnpm add angular-typed-router
+# or
+yarn add angular-typed-router
+```
+
+## Quick Start
+
+1. Define your application routes:
+
+```ts
+// app.routes.ts
+import { Routes } from '@angular/router';
+import { DashboardComponent } from './dashboard.component';
+
+export const appRoutes = [
+  { path: 'dashboard', component: DashboardComponent },
+  { path: 'projects/:id', loadComponent: () => import('./project.component').then(m => m.ProjectComponent) },
+  { path: '**', redirectTo: 'dashboard' }
+] as const satisfies Routes;
+```
+
+2. Create the augmentation file so the library can “see” your routes:
+
+```ts
+// angular-typed-router.d.ts (sibling to main.ts or inside src/ root)
+import type { appRoutes } from './app/app.routes';
+
+declare module 'angular-typed-router' {
+  interface UserTypedRoutes {
+    routes: typeof appRoutes;
+  }
+}
+```
+
+3. Link the augmentation file in your tsconfig so the compiler includes it:
+
+```jsonc
+// tsconfig.app.json
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": { },
+  "include": [
+    "src/**/*.ts",
+    "angular-typed-router.d.ts" // <— add this line
+  ]
+}
+```
+If you have multiple tsconfigs, ensure the specific app tsconfig that drives the build/test includes the file.
+
+4. Use the typed router & link:
+
+```ts
+import { Component, inject } from '@angular/core';
+import { TypedRouter, Path } from 'angular-typed-router';
+
+@Component({
+  selector: 'app-nav',
+  template: `
+    <a routerLink="dashboard">Dashboard</a>
+    <a routerLink="projects/123">Project 123</a>
+  `
+})
+export class NavComponent {
+  private readonly router = inject(TypedRouter);
+
+  go(p: Path) { // p must be one of the inferred paths
+    this.router.navigateByUrl(p);
+  }
+
+  openProject(id: string) {
+    // commands tuple – first literal segment + dynamic param value
+    this.router.navigate(['projects', id]);
+  }
+}
+```
+
+If you try `this.router.navigateByUrl('projcts/123')` (typo) or `<a routerLink="projcts/123">`, TypeScript errors.
+
+## Exports
+
+```ts
+import { TypedRouter, TypedRouterLink, Path, Commands, UserTypedRoutes } from 'angular-typed-router';
+```
+
+- `TypedRouter` – Extends Angular `Router`, overrides `navigateByUrl` & `navigate` signatures to accept `Path` / `Commands`.
+- `TypedRouterLink` – Directive shadowing `[routerLink]` to type its input as `Commands | Path`.
+- `Path` – Union of every reachable concrete URL path produced from your route tree (includes parameterized expansions with `string` in place of `:param` segments).
+- `Commands` – Union of tuple command arrays representing valid `Router.navigate()` inputs (each static segment as a literal, each parameter position as `string`).
+- `UserTypedRoutes` – Empty interface you augment with your `routes` reference.
+- `ExtractPathsFromRoutes<Routes>` – Utility type if you need to compute from an arbitrary `Routes` array manually.
+
+## How It Works
+
+1. You augment `UserTypedRoutes` with the literal `const` route array.
+2. Type utilities recursively walk the route tree (including lazily loaded routes via `loadChildren` returning `Route[]` or `{ routes }`).
+3. Each navigable route (component / loadComponent / redirectTo) contributes a path string. Param segments (`:id`) are replaced by `string` (currently unrestricted – see Limitations).
+4. Child paths are joined with parents to form final concrete path unions.
+5. A tuple transformation creates the `Commands` variants.
+
+All compile-time only; nothing ships to runtime.
+
+## Lazy Routes
+
+Works with any lazy route whose `loadChildren` resolves to:
+- `Promise<Route[]>`
+- `Promise<{ routes: Route[] }>` (Angular v17+ pattern)
+
+Example:
+
+```ts
+{ path: 'admin', loadChildren: () => import('./admin.routes').then(m => m.adminRoutes) }
+```
+
+Those child paths get prefixed (`admin/...`) in `Path` & `Commands`.
+
+## Parameter Segments
+
+A pattern `projects/:id/details/:section` produces a `Path` variant like:
+```
+'projects/' + string + '/details/' + string
+```
+and a `Commands` tuple like:
+```
+['projects', string, 'details', string]
+```
+You pass real runtime values for the `string` positions. Empty string values and values like 'param/still-param' cannot currently be prevented at the type level without hurting DX (see Limitations).
+
+## Usage Patterns
+
+Navigate by full path (typed):
+```ts
+router.navigateByUrl('/dashboard');
+```
+Navigate with commands array:
+```ts
+router.navigate(['/', 'projects', someId]);
+```
+Generate a `UrlTree`:
+```ts
+router.createUrlTree(['/', 'projects', id]);
+```
+Template links:
+```html
+<a routerLink="/projects/42">Project 42</a>
+<a [routerLink]="['/', 'projects', projectId]"></a>
+```
+
+
+## Augmentation Placement
+
+Keep the augmentation in a `.d.ts` that is included by `tsconfig.app.json` (`include` array). If you see `Path` still as `never`, ensure:
+- The augmentation file is included.
+- The `routes` constant is `as const satisfies Routes`.
+- No circular import (augmentation file should only import the routes, nothing else runtime-heavy).
+
+## Limitations & Tradeoffs
+
+| Concern | Status / Rationale                                                                    |
+|---------|---------------------------------------------------------------------------------------|
+| Restrict param values (non-empty) | Not enforced; doing so significantly worsens DX (would reject plain `string` vars).   |
+| Trailing slashes | Not generated unless authored; currently no auto-normalization.                       |
+| `relativeTo` (relative navigation) | Not supported – all inferred `Path` / `Commands` are absolute. Use absolute commands. |
+
+
+## ESLint Recommendation (Optional)
+
+You can use `angular-typed-router-eslint` plugin to forbid untyped navigation calls.
+
+```bash
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---------|-----|
+| `Path` is `never` | Check augmentation file is included in tsconfig. |
+| Lazy children missing | Ensure promise resolves to `Route[]` or `{ routes: Route[] }`. |
+| Template error: unknown routerLink type | Ensure `TypedRouterLink` directive is imported (standalone). |
+
+## Contributing
+
+PRs welcome.
+
+## License
+
+MIT
+
+---
+Happy routing.

package/fesm2022/angular-typed-router.mjs

@@ -0,0 +1,46 @@
+import * as i0 from '@angular/core';
+import { Injectable, Input, Directive } from '@angular/core';
+import { Router, RouterLink } from '@angular/router';
+
+class TypedRouter extends Router {
+    navigate(commands, extras) {
+        return super.navigate(commands, extras);
+    }
+    navigateByUrl(url, extras) {
+        return super.navigateByUrl(url, extras);
+    }
+    createUrlTree(commands, navigationExtras) {
+        return super.createUrlTree(commands, navigationExtras);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: TypedRouter, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: TypedRouter, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: TypedRouter, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
+
+class TypedRouterLink extends RouterLink {
+    set routerLink(commandsOrUrlTree) {
+        super.routerLink = commandsOrUrlTree;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: TypedRouterLink, deps: null, target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.2.4", type: TypedRouterLink, isStandalone: true, selector: "[routerLink]", inputs: { routerLink: "routerLink" }, usesInheritance: true, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: TypedRouterLink, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[routerLink]'
+                }]
+        }], propDecorators: { routerLink: [{
+                type: Input
+            }] } });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { TypedRouter, TypedRouterLink };
+//# sourceMappingURL=angular-typed-router.mjs.map

package/fesm2022/angular-typed-router.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-typed-router.mjs","sources":["../tmp-esm2022/lib/router.js","../tmp-esm2022/lib/router-link.js","../tmp-esm2022/angular-typed-router.js"],"sourcesContent":["import { Injectable } from '@angular/core';\nimport { Router, } from '@angular/router';\nimport * as i0 from \"@angular/core\";\nexport class TypedRouter extends Router {\n    navigate(commands, extras) {\n        return super.navigate(commands, extras);\n    }\n    navigateByUrl(url, extras) {\n        return super.navigateByUrl(url, extras);\n    }\n    createUrlTree(commands, navigationExtras) {\n        return super.createUrlTree(commands, navigationExtras);\n    }\n    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: \"12.0.0\", version: \"20.2.4\", ngImport: i0, type: TypedRouter, deps: null, target: i0.ɵɵFactoryTarget.Injectable });\n    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: \"12.0.0\", version: \"20.2.4\", ngImport: i0, type: TypedRouter, providedIn: 'root' });\n}\ni0.ɵɵngDeclareClassMetadata({ minVersion: \"12.0.0\", version: \"20.2.4\", ngImport: i0, type: TypedRouter, decorators: [{\n            type: Injectable,\n            args: [{\n                    providedIn: 'root',\n                }]\n        }] });\n//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vbGlicy90eXBlZC1yb3V0ZXIvc3JjL2xpYi9yb3V0ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUMzQyxPQUFPLEVBR0wsTUFBTSxHQUdQLE1BQU0saUJBQWlCLENBQUM7O0FBTXpCLE1BQU0sT0FBTyxXQUFZLFNBQVEsTUFBTTtJQUM1QixRQUFRLENBQ2YsUUFBa0IsRUFDbEIsTUFBeUI7UUFFekIsT0FBTyxLQUFLLENBQUMsUUFBUSxDQUFDLFFBQVEsRUFBRSxNQUFNLENBQUMsQ0FBQztJQUMxQyxDQUFDO0lBRVEsYUFBYSxDQUNwQixHQUFTLEVBQ1QsTUFBa0M7UUFFbEMsT0FBTyxLQUFLLENBQUMsYUFBYSxDQUFDLEdBQUcsRUFBRSxNQUFNLENBQUMsQ0FBQztJQUMxQyxDQUFDO0lBRVEsYUFBYSxDQUNwQixRQUFrQixFQUNsQixnQkFBcUM7UUFFckMsT0FBTyxLQUFLLENBQUMsYUFBYSxDQUFDLFFBQVEsRUFBRSxnQkFBZ0IsQ0FBQyxDQUFDO0lBQ3pELENBQUM7dUdBcEJVLFdBQVc7MkdBQVgsV0FBVyxjQUZWLE1BQU07OzJGQUVQLFdBQVc7a0JBSHZCLFVBQVU7bUJBQUM7b0JBQ1YsVUFBVSxFQUFFLE1BQU07aUJBQ25CIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgSW5qZWN0YWJsZSB9IGZyb20gJ0Bhbmd1bGFyL2NvcmUnO1xuaW1wb3J0IHtcbiAgTmF2aWdhdGlvbkJlaGF2aW9yT3B0aW9ucyxcbiAgTmF2aWdhdGlvbkV4dHJhcyxcbiAgUm91dGVyLFxuICBVcmxDcmVhdGlvbk9wdGlvbnMsXG4gIFVybFRyZWUsXG59IGZyb20gJ0Bhbmd1bGFyL3JvdXRlcic7XG5pbXBvcnQgeyBDb21tYW5kcywgUGF0aCB9IGZyb20gJy4vdHlwZWQtcm91dGVzJztcblxuQEluamVjdGFibGUoe1xuICBwcm92aWRlZEluOiAncm9vdCcsXG59KVxuZXhwb3J0IGNsYXNzIFR5cGVkUm91dGVyIGV4dGVuZHMgUm91dGVyIHtcbiAgb3ZlcnJpZGUgbmF2aWdhdGUoXG4gICAgY29tbWFuZHM6IENvbW1hbmRzLFxuICAgIGV4dHJhcz86IE5hdmlnYXRpb25FeHRyYXNcbiAgKTogUHJvbWlzZTxib29sZWFuPiB7XG4gICAgcmV0dXJuIHN1cGVyLm5hdmlnYXRlKGNvbW1hbmRzLCBleHRyYXMpO1xuICB9XG5cbiAgb3ZlcnJpZGUgbmF2aWdhdGVCeVVybChcbiAgICB1cmw6IFBhdGgsXG4gICAgZXh0cmFzPzogTmF2aWdhdGlvbkJlaGF2aW9yT3B0aW9uc1xuICApOiBQcm9taXNlPGJvb2xlYW4+IHtcbiAgICByZXR1cm4gc3VwZXIubmF2aWdhdGVCeVVybCh1cmwsIGV4dHJhcyk7XG4gIH1cblxuICBvdmVycmlkZSBjcmVhdGVVcmxUcmVlKFxuICAgIGNvbW1hbmRzOiBDb21tYW5kcyxcbiAgICBuYXZpZ2F0aW9uRXh0cmFzPzogVXJsQ3JlYXRpb25PcHRpb25zXG4gICk6IFVybFRyZWUge1xuICAgIHJldHVybiBzdXBlci5jcmVhdGVVcmxUcmVlKGNvbW1hbmRzLCBuYXZpZ2F0aW9uRXh0cmFzKTtcbiAgfVxufVxuIl19","import { Directive, Input } from '@angular/core';\nimport { RouterLink } from '@angular/router';\nimport * as i0 from \"@angular/core\";\nexport class TypedRouterLink extends RouterLink {\n    set routerLink(commandsOrUrlTree) {\n        super.routerLink = commandsOrUrlTree;\n    }\n    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: \"12.0.0\", version: \"20.2.4\", ngImport: i0, type: TypedRouterLink, deps: null, target: i0.ɵɵFactoryTarget.Directive });\n    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: \"14.0.0\", version: \"20.2.4\", type: TypedRouterLink, isStandalone: true, selector: \"[routerLink]\", inputs: { routerLink: \"routerLink\" }, usesInheritance: true, ngImport: i0 });\n}\ni0.ɵɵngDeclareClassMetadata({ minVersion: \"12.0.0\", version: \"20.2.4\", ngImport: i0, type: TypedRouterLink, decorators: [{\n            type: Directive,\n            args: [{\n                    selector: '[routerLink]'\n                }]\n        }], propDecorators: { routerLink: [{\n                type: Input\n            }] } });\n//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGVyLWxpbmsuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9saWJzL3R5cGVkLXJvdXRlci9zcmMvbGliL3JvdXRlci1saW5rLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxTQUFTLEVBQUUsS0FBSyxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBQ2pELE9BQU8sRUFBRSxVQUFVLEVBQVcsTUFBTSxpQkFBaUIsQ0FBQzs7QUFNdEQsTUFBTSxPQUFPLGVBQWdCLFNBQVEsVUFBVTtJQUM3QyxJQUNhLFVBQVUsQ0FBQyxpQkFBK0Q7UUFDckYsS0FBSyxDQUFDLFVBQVUsR0FBRyxpQkFBaUIsQ0FBQztJQUN2QyxDQUFDO3VHQUpVLGVBQWU7MkZBQWYsZUFBZTs7MkZBQWYsZUFBZTtrQkFIM0IsU0FBUzttQkFBQztvQkFDVCxRQUFRLEVBQUUsY0FBYztpQkFDekI7OEJBR2MsVUFBVTtzQkFEdEIsS0FBSyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IERpcmVjdGl2ZSwgSW5wdXQgfSBmcm9tICdAYW5ndWxhci9jb3JlJztcbmltcG9ydCB7IFJvdXRlckxpbmssIFVybFRyZWUgfSBmcm9tICdAYW5ndWxhci9yb3V0ZXInO1xuaW1wb3J0IHsgQ29tbWFuZHMsIFBhdGggfSBmcm9tICcuL3R5cGVkLXJvdXRlcyc7XG5cbkBEaXJlY3RpdmUoe1xuICBzZWxlY3RvcjogJ1tyb3V0ZXJMaW5rXSdcbn0pXG5leHBvcnQgY2xhc3MgVHlwZWRSb3V0ZXJMaW5rIGV4dGVuZHMgUm91dGVyTGluayB7XG4gIEBJbnB1dCgpXG4gIG92ZXJyaWRlIHNldCByb3V0ZXJMaW5rKGNvbW1hbmRzT3JVcmxUcmVlOiBDb21tYW5kcyB8IFBhdGggfCBVcmxUcmVlIHwgbnVsbCB8IHVuZGVmaW5lZCkge1xuICAgIHN1cGVyLnJvdXRlckxpbmsgPSBjb21tYW5kc09yVXJsVHJlZTtcbiAgfVxufVxuIl19","/**\n * Generated bundle index. Do not edit.\n */\nexport * from './index';\n//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYW5ndWxhci10eXBlZC1yb3V0ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9saWJzL3R5cGVkLXJvdXRlci9zcmMvYW5ndWxhci10eXBlZC1yb3V0ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFFSCxjQUFjLFNBQVMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogR2VuZXJhdGVkIGJ1bmRsZSBpbmRleC4gRG8gbm90IGVkaXQuXG4gKi9cblxuZXhwb3J0ICogZnJvbSAnLi9pbmRleCc7XG4iXX0="],"names":[],"mappings":";;;;AAGO,MAAM,WAAW,SAAS,MAAM,CAAC;AACxC,IAAI,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;AAC/B,QAAQ,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;AAC/C,IAAI;AACJ,IAAI,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE;AAC/B,QAAQ,OAAO,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC;AAC/C,IAAI;AACJ,IAAI,aAAa,CAAC,QAAQ,EAAE,gBAAgB,EAAE;AAC9C,QAAQ,OAAO,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC;AAC9D,IAAI;AACJ,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC;AACxK,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC,qBAAqB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAC7I;AACA,EAAE,CAAC,wBAAwB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACrH,YAAY,IAAI,EAAE,UAAU;AAC5B,YAAY,IAAI,EAAE,CAAC;AACnB,oBAAoB,UAAU,EAAE,MAAM;AACtC,iBAAiB;AACjB,SAAS,CAAC,EAAE,CAAC;;AClBN,MAAM,eAAe,SAAS,UAAU,CAAC;AAChD,IAAI,IAAI,UAAU,CAAC,iBAAiB,EAAE;AACtC,QAAQ,KAAK,CAAC,UAAU,GAAG,iBAAiB;AAC5C,IAAI;AACJ,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC;AAC3K,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AACtO;AACA,EAAE,CAAC,wBAAwB,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;AACzH,YAAY,IAAI,EAAE,SAAS;AAC3B,YAAY,IAAI,EAAE,CAAC;AACnB,oBAAoB,QAAQ,EAAE;AAC9B,iBAAiB;AACjB,SAAS,CAAC,EAAE,cAAc,EAAE,EAAE,UAAU,EAAE,CAAC;AAC3C,gBAAgB,IAAI,EAAE;AACtB,aAAa,CAAC,EAAE,EAAE,CAAC;;ACjBnB;AACA;AACA;;;;"}

package/index.d.ts

@@ -0,0 +1,66 @@
+import { Route, Router, NavigationExtras, NavigationBehaviorOptions, UrlCreationOptions, UrlTree, RouterLink } from '@angular/router';
+import * as i0 from '@angular/core';
+
+type _Normalize<S extends string> = string extends S ? string : S;
+type PathToTuple<P extends string> = P extends `${infer Head}/${infer Rest}` ? [_Normalize<Head>, ...PathToTuple<Rest>] : P extends '' ? [] : [_Normalize<P>];
+
+type IsNavigable<R extends Route> = R extends {
+    component: any;
+} ? true : R extends {
+    loadComponent: any;
+} ? true : R extends {
+    redirectTo: any;
+} ? true : false;
+
+declare const __rootCatchAll: unique symbol;
+type RootCatchAll = string & {
+    readonly [__rootCatchAll]: true;
+};
+type AllowedRouteParamValue<S extends string> = Exclude<S, '' | `${string}/${string}`>;
+type _ReplaceParams<S extends string> = S extends `${infer Start}:${string}/${infer Rest}` ? `${Start}${AllowedRouteParamValue<string>}/${_ReplaceParams<Rest>}` : S extends `${infer Start}:${string}` ? `${Start}${AllowedRouteParamValue<string>}` : S extends `${infer Start}**/${infer Rest}` ? `${Start}${string}/${_ReplaceParams<Rest>}` : S extends `${infer Start}**` ? Start extends '' ? RootCatchAll : `${Start}${string}` : S;
+type ReplaceParams<S extends string> = _ReplaceParams<S>;
+
+type PathOrEmptyString<R extends Route> = R['path'] extends string ? R['path'] : '';
+
+type ExtractLazyChildRoutes<R extends Route> = R['loadChildren'] extends (...args: any) => Promise<infer M> ? M extends readonly Route[] ? M : M extends {
+    routes: readonly Route[];
+} ? M['routes'] : [] : [];
+
+type JoinPathSegments<A extends string, B extends string> = A extends '' ? B : B extends '' ? A : `${A}/${B}`;
+
+type ExtractChildren<Routes extends readonly Route[], Prefix extends string> = Routes[number] extends infer R ? R extends Route ? ExtractPathsFromRoute<R, Prefix> : never : never;
+type ExtractPathsFromRoute<R extends Route, Prefix extends string = ''> = (IsNavigable<R> extends true ? ReplaceParams<JoinPathSegments<Prefix, PathOrEmptyString<R>>> : never) | (R['children'] extends readonly Route[] ? ExtractChildren<R['children'], ReplaceParams<JoinPathSegments<Prefix, PathOrEmptyString<R>>>> : never) | (R['loadChildren'] extends () => Promise<any> ? ExtractChildren<ExtractLazyChildRoutes<R>, ReplaceParams<JoinPathSegments<Prefix, PathOrEmptyString<R>>>> : never);
+
+type ExtractPathsFromRoutes<Routes extends readonly Route[], Prefix extends string = ''> = Routes[number] extends infer R ? R extends Route ? ExtractPathsFromRoute<R, Prefix> : never : never;
+
+type RemoveTrailingSlash<S extends string> = S extends '/' ? S : S extends `${infer T}/` ? RemoveTrailingSlash<T> : S;
+
+/**
+ * Merge target. Consumer augments this interface:
+ * declare module 'angular-typed-router' { interface UserTypedRoutes { routes: typeof routes; } }`
+ */
+interface UserTypedRoutes {
+}
+type ProvidedRoutes = UserTypedRoutes extends {
+    routes: readonly Route[];
+} ? UserTypedRoutes['routes'] : [];
+type Path = RemoveTrailingSlash<`/${ExtractPathsFromRoutes<ProvidedRoutes>}`>;
+type CommandPath = ExtractPathsFromRoutes<ProvidedRoutes>;
+type Commands = ['/', ...PathToTuple<CommandPath>];
+
+declare class TypedRouter extends Router {
+    navigate(commands: Commands, extras?: NavigationExtras): Promise<boolean>;
+    navigateByUrl(url: Path, extras?: NavigationBehaviorOptions): Promise<boolean>;
+    createUrlTree(commands: Commands, navigationExtras?: UrlCreationOptions): UrlTree;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TypedRouter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TypedRouter>;
+}
+
+declare class TypedRouterLink extends RouterLink {
+    set routerLink(commandsOrUrlTree: Commands | Path | UrlTree | null | undefined);
+    static ɵfac: i0.ɵɵFactoryDeclaration<TypedRouterLink, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<TypedRouterLink, "[routerLink]", never, { "routerLink": { "alias": "routerLink"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+export { TypedRouter, TypedRouterLink };
+export type { Commands, ExtractPathsFromRoutes, Path, UserTypedRoutes };

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "angular-typed-router",
+  "version": "0.1.1-0",
+  "peerDependencies": {
+    "@angular/common": "^20.2.0",
+    "@angular/core": "^20.2.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/angular-typed-router.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/angular-typed-router.mjs"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}