angular-typed-router 0.1.1-3 → 1.0.0

package/README.md

@@ -1,7 +1,5 @@
 # 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
@@ -16,7 +14,7 @@ No decorators, no custom builders, no code generation – just TypeScript type i
 
 ## Installation
 
-`ng add angular-ryped-router` will set up the package and create a declaration file for you.
+`ng add angular-typed-router` will set up the package and create a declaration file for you.
 
 Or install manually:
 
@@ -119,14 +117,13 @@ import { TypedRouter, TypedRouterLink, Path, Commands, UserTypedRoutes, RoutePar
 - `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.
 - `RouteParamTypes` – Interface you can augment to specify types for route parameters by name (e.g. `id: ${number}`).
 
 ## 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).
+3. Each navigable route (component / loadComponent / redirectTo) contributes a path string. Param segments (e.g. `:id`) can be typed through declaration merging of `RouteParamTypes`.
 4. Child paths are joined with parents to form final concrete path unions.
 5. A tuple transformation creates the `Commands` variants.
 
@@ -161,7 +158,7 @@ and a `Commands` tuple like:
 ['projects', IdParamType, 'details', SectionParamType]
 ```
 
-You pass real runtime values for the `IdParamType` and `SectionParamType` positions. Empty string values and values like 'param/still-param' cannot currently be prevented at the type level without hurting DX (see Limitations).
+You pass real runtime values for the `IdParamType` and `SectionParamType` positions.
 
 ## Usage Patterns
 
@@ -195,17 +192,16 @@ Keep the augmentation in a `.d.ts` that is included by `tsconfig.app.json` (`inc
 
 - 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
+## Tradeoffs
 
-| Concern                            | Status / Rationale                                                                    |
-| ---------------------------------- | ------------------------------------------------------------------------------------- |
-| `relativeTo` (relative navigation) | Not supported – all inferred `Path` / `Commands` are absolute. Use absolute commands. |
+| Concern                            | Status / Rationale                                                                              |
+| ---------------------------------- |-------------------------------------------------------------------------------------------------|
+| `relativeTo` (relative navigation) | Not supported – all inferred `Path` / `Commands` are absolute. Use absolute paths and commands. |
 
 ## ESLint Recommendation (Optional)
 
-You can use `angular-typed-router-eslint` plugin to forbid untyped navigation calls.
+You can use `angular-typed-router-eslint` plugin to forbid untyped navigation calls and usage of `relativeTo`.
 
 ## Troubleshooting
 

package/fesm2022/angular-typed-router.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Injectable, Input, Directive } from '@angular/core';
+import { Injectable, forwardRef, Input, Directive } from '@angular/core';
 import { Router, RouterLink } from '@angular/router';
 
 class TypedRouter extends Router {
@@ -12,10 +12,10 @@ class TypedRouter extends Router {
     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' });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.9", ngImport: i0, type: TypedRouter, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.0.9", ngImport: i0, type: TypedRouter, providedIn: 'root' });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: TypedRouter, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.9", ngImport: i0, type: TypedRouter, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
@@ -26,13 +26,24 @@ 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 });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.9", ngImport: i0, type: TypedRouterLink, deps: null, target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "21.0.9", type: TypedRouterLink, isStandalone: true, selector: "[routerLink]", inputs: { routerLink: "routerLink" }, providers: [
+            {
+                provide: RouterLink,
+                useExisting: forwardRef(() => TypedRouterLink),
+            }
+        ], usesInheritance: true, ngImport: i0 });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.4", ngImport: i0, type: TypedRouterLink, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.9", ngImport: i0, type: TypedRouterLink, decorators: [{
             type: Directive,
             args: [{
-                    selector: '[routerLink]'
+                    selector: '[routerLink]',
+                    providers: [
+                        {
+                            provide: RouterLink,
+                            useExisting: forwardRef(() => TypedRouterLink),
+                        }
+                    ]
                 }]
         }], propDecorators: { routerLink: [{
                 type: Input

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

@@ -1 +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;;;;"}
+{"version":3,"file":"angular-typed-router.mjs","sources":["../../../../libs/typed-router/src/lib/router.ts","../../../../libs/typed-router/src/lib/router-link.ts","../../../../libs/typed-router/src/angular-typed-router.ts"],"sourcesContent":["import { Injectable } from '@angular/core';\nimport {\n  NavigationBehaviorOptions,\n  NavigationExtras,\n  Router,\n  UrlCreationOptions,\n  UrlTree,\n} from '@angular/router';\nimport { Commands, Path } from './typed-routes';\n\n@Injectable({\n  providedIn: 'root',\n})\nexport class TypedRouter extends Router {\n  override navigate(\n    commands: Commands,\n    extras?: NavigationExtras\n  ): Promise<boolean> {\n    return super.navigate(commands, extras);\n  }\n\n  override navigateByUrl(\n    url: Path,\n    extras?: NavigationBehaviorOptions\n  ): Promise<boolean> {\n    return super.navigateByUrl(url, extras);\n  }\n\n  override createUrlTree(\n    commands: Commands,\n    navigationExtras?: UrlCreationOptions\n  ): UrlTree {\n    return super.createUrlTree(commands, navigationExtras);\n  }\n}\n","import { Directive, forwardRef, Input } from '@angular/core';\nimport { RouterLink, UrlTree } from '@angular/router';\nimport { Commands, Path } from './typed-routes';\n\n@Directive({\n  selector: '[routerLink]',\n  providers: [\n    {\n      provide: RouterLink,\n      useExisting: forwardRef(() => TypedRouterLink),\n    }\n  ]\n})\nexport class TypedRouterLink extends RouterLink {\n  @Input()\n  override set routerLink(commandsOrUrlTree: Commands | Path | UrlTree | null | undefined) {\n    super.routerLink = commandsOrUrlTree;\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAaM,MAAO,WAAY,SAAQ,MAAM,CAAA;IAC5B,QAAQ,CACf,QAAkB,EAClB,MAAyB,EAAA;QAEzB,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IACzC;IAES,aAAa,CACpB,GAAS,EACT,MAAkC,EAAA;QAElC,OAAO,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC;IACzC;IAES,aAAa,CACpB,QAAkB,EAClB,gBAAqC,EAAA;QAErC,OAAO,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACxD;uGApBW,WAAW,EAAA,IAAA,EAAA,IAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;AAAX,IAAA,OAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,WAAW,cAFV,MAAM,EAAA,CAAA;;2FAEP,WAAW,EAAA,UAAA,EAAA,CAAA;kBAHvB,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA;;;ACCK,MAAO,eAAgB,SAAQ,UAAU,CAAA;IAC7C,IACa,UAAU,CAAC,iBAA+D,EAAA;AACrF,QAAA,KAAK,CAAC,UAAU,GAAG,iBAAiB;IACtC;uGAJW,eAAe,EAAA,IAAA,EAAA,IAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;AAAf,IAAA,OAAA,IAAA,GAAA,EAAA,CAAA,oBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,IAAA,EAAA,eAAe,EAAA,YAAA,EAAA,IAAA,EAAA,QAAA,EAAA,cAAA,EAAA,MAAA,EAAA,EAAA,UAAA,EAAA,YAAA,EAAA,EAAA,SAAA,EAPf;AACT,YAAA;AACE,gBAAA,OAAO,EAAE,UAAU;AACnB,gBAAA,WAAW,EAAE,UAAU,CAAC,MAAM,eAAe,CAAC;AAC/C;AACF,SAAA,EAAA,eAAA,EAAA,IAAA,EAAA,QAAA,EAAA,EAAA,EAAA,CAAA;;2FAEU,eAAe,EAAA,UAAA,EAAA,CAAA;kBAT3B,SAAS;AAAC,YAAA,IAAA,EAAA,CAAA;AACT,oBAAA,QAAQ,EAAE,cAAc;AACxB,oBAAA,SAAS,EAAE;AACT,wBAAA;AACE,4BAAA,OAAO,EAAE,UAAU;AACnB,4BAAA,WAAW,EAAE,UAAU,CAAC,qBAAqB,CAAC;AAC/C;AACF;AACF,iBAAA;;sBAEE;;;ACdH;;AAEG;;;;"}

package/package.json

@@ -1,9 +1,26 @@
 {
   "name": "angular-typed-router",
-  "version": "0.1.1-3",
+  "version": "1.0.0",
+  "description": "Type-safe Angular Router. Compile-time Path union and typed navigation commands inferred from your Routes array. Zero runtime cost.",
+  "keywords": [
+    "angular",
+    "router",
+    "typescript",
+    "type-safe",
+    "typed",
+    "routing",
+    "angular-router"
+  ],
+  "author": "Dominic Bachmann",
+  "license": "MIT",
+  "homepage": "https://github.com/dominicbachmann/angular-typed-router#readme",
+  "bugs": {
+    "url": "https://github.com/dominicbachmann/angular-typed-router/issues"
+  },
   "peerDependencies": {
-    "@angular/common": "^20.0.0",
-    "@angular/core": "^20.0.0"
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0",
+    "@angular/router": "^21.0.0"
   },
   "repository": {
     "type": "git",
@@ -16,13 +33,13 @@
     "save": "dependencies"
   },
   "module": "fesm2022/angular-typed-router.mjs",
-  "typings": "index.d.ts",
+  "typings": "types/angular-typed-router.d.ts",
   "exports": {
     "./package.json": {
       "default": "./package.json"
     },
     ".": {
-      "types": "./index.d.ts",
+      "types": "./types/angular-typed-router.d.ts",
       "default": "./fesm2022/angular-typed-router.mjs"
     }
   },

package/types/angular-typed-router.d.ts

@@ -0,0 +1,195 @@
+import { Route, Router, NavigationExtras, NavigationBehaviorOptions, UrlCreationOptions, UrlTree, RouterLink } from '@angular/router';
+import * as i0 from '@angular/core';
+
+/**
+ * True if a Route is navigable on its own — i.e. it can be reached by a URL
+ * because it renders a component or redirects.
+ *
+ * @example
+ *   IsNavigable<{ path: 'a', component: C }>                    // true
+ *   IsNavigable<{ path: 'a', loadComponent: () => Promise<C> }> // true
+ *   IsNavigable<{ path: 'a', redirectTo: 'b' }>                 // true
+ *   IsNavigable<{ path: 'a', children: [...] }>                 // false
+ */
+type IsNavigable<R extends Route> = R extends {
+    component: any;
+} ? true : R extends {
+    loadComponent: any;
+} ? true : R extends {
+    redirectTo: any;
+} ? true : false;
+
+/**
+ * Reads a Route's `path` property if it's a string, otherwise returns the
+ * empty string. Used so a path-less Route (allowed by Angular) contributes
+ * no segment when joined with its parents or children.
+ *
+ * @example
+ *   RoutePathOrEmpty<{ path: 'home' }>   // 'home'
+ *   RoutePathOrEmpty<{ component: C }>   // ''
+ */
+type RoutePathOrEmpty<R extends Route> = R['path'] extends string ? R['path'] : '';
+
+/**
+ * Unwraps a Route's `loadChildren` to its underlying `Route[]`.
+ *
+ * Returns `[]` if `loadChildren` is missing or returns an unrecognized shape.
+ *
+ * @example
+ *   ExtractLazyChildRoutes<{
+ *     path: 'lazy',
+ *     loadChildren: () => Promise<[{ path: 'sub', component: C }]>
+ *   }>
+ *   // [{ path: 'sub', component: C }]
+ */
+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'] : [] : [];
+
+/**
+ * Joins two path segments with `/`, treating an empty segment as a no-op.
+ * Prevents leading/trailing/double slashes when a route has no path or sits
+ * at the root.
+ *
+ * @example
+ *   JoinPathSegments<'a', 'b'>   // 'a/b'
+ *   JoinPathSegments<'', 'b'>    // 'b'
+ *   JoinPathSegments<'a', ''>    // 'a'
+ *   JoinPathSegments<'', ''>     // ''
+ */
+type JoinPathSegments<A extends string, B extends string> = A extends '' ? B : B extends '' ? A : `${A}/${B}`;
+
+/**
+ * Emits every navigable path reachable from a single Route, with `:paramName`
+ * markers preserved. A Route contributes:
+ *   - itself, if navigable (has component / loadComponent / redirectTo)
+ *   - each of its children, prefixed with its own path
+ *   - each of its lazy-loaded children, prefixed with its own path
+ *
+ * @example
+ *   ExtractRawPathsFromRoute<{
+ *     path: 'parent', component: C,
+ *     children: [{ path: 'child', component: C }]
+ *   }>
+ *   // 'parent' | 'parent/child'
+ */
+type ExtractRawPathsFromRoute<R extends Route, Prefix extends string = ''> = (IsNavigable<R> extends true ? JoinPathSegments<Prefix, RoutePathOrEmpty<R>> : never) | (R['children'] extends readonly Route[] ? ExtractRawPaths<R['children'], JoinPathSegments<Prefix, RoutePathOrEmpty<R>>> : never) | (R['loadChildren'] extends () => Promise<any> ? ExtractRawPaths<ExtractLazyChildRoutes<R>, JoinPathSegments<Prefix, RoutePathOrEmpty<R>>> : never);
+
+/**
+ * Distributes over a Routes array, emitting every navigable path with
+ * `:paramName` markers intact. `Prefix` accumulates the parent path on
+ * each recursion step.
+ *
+ * @example
+ *   ExtractRawPaths<[
+ *     { path: 'home', component: C },
+ *     { path: 'user/:id', component: C }
+ *   ]>
+ *   // 'home' | 'user/:id'
+ */
+type ExtractRawPaths<Routes extends readonly Route[], Prefix extends string = ''> = Routes[number] extends infer R ? R extends Route ? ExtractRawPathsFromRoute<R, Prefix> : never : never;
+
+/**
+ * Augmentation target for declaring concrete value types per route parameter
+ * name. Consumers augment via `'angular-typed-router'`:
+ *
+ *   declare module 'angular-typed-router' {
+ *     interface RouteParamTypes {
+ *       'org-id': OrgId;
+ *       'project-id': ProjectId;
+ *     }
+ *   }
+ *
+ * Each key matches a `:paramName` segment in the consumer's Routes; each value
+ * is the type that the param resolves to in `Path` and `Commands`.
+ */
+interface RouteParamTypes {
+}
+declare const __rootCatchAll: unique symbol;
+/**
+ * Brand for the bare-root `**` catch-all path. Distinguishes a route declared
+ * as `path: '**'` (matches anything from the root) from an arbitrary `string`.
+ */
+type RootCatchAll = string & {
+    readonly [__rootCatchAll]: true;
+};
+
+/**
+ * Resolves a single `:paramName` to its declared value type.
+ *
+ * Returns `never` for undeclared params, so a route with an undeclared
+ * `:param` disappears from both Path and Commands.
+ *
+ * @example
+ *   declare module './route-param-types' {
+ *     interface RouteParamTypes { id: UserId }
+ *   }
+ *   type X = ResolveParam<'id'>      // UserId
+ *   type Y = ResolveParam<'unknown'> // never
+ */
+type ResolveParam<Name extends string> = Name extends keyof RouteParamTypes ? RouteParamTypes[Name] : never;
+
+/**
+ * Substitutes `:paramName` markers with their resolved types, producing a
+ * URL-string template-literal type. Brand types survive as type-level
+ * placeholders (`/user/${UserId}`).
+ *
+ * @example
+ *   RawPathToUrl<'user/:id'>   // `user/${UserId}` (assuming id: UserId)
+ *   RawPathToUrl<'home'>       // 'home'
+ *   RawPathToUrl<'**'>         // RootCatchAll
+ */
+type RawPathToUrl<S extends string> = S extends `${infer Start}:${infer Param}/${infer Rest}` ? `${Start}${ResolveParam<Param>}/${RawPathToUrl<Rest>}` : S extends `${infer Start}:${infer Param}` ? `${Start}${ResolveParam<Param>}` : S extends `${infer Start}**/${infer Rest}` ? `${Start}${string}/${RawPathToUrl<Rest>}` : S extends `${infer Start}**` ? Start extends '' ? RootCatchAll : `${Start}${string}` : S;
+
+/** Collapses a non-literal `string` input to `string` to prevent recursion artifacts. */
+type Normalize<S extends string> = string extends S ? string : S;
+/** Resolves one segment: `:param` → ResolveParam<Param>, literal → itself. */
+type ResolveSegment<S extends string> = S extends `:${infer Name}` ? ResolveParam<Name> : Normalize<S>;
+/**
+ * Splits a raw path on `/` and resolves each `:paramName` segment directly.
+ *
+ * @example
+ *   RawPathToCommands<'user/:id'>   // ['user', UserId]
+ *   RawPathToCommands<'home'>       // ['home']
+ *   RawPathToCommands<''>           // []
+ */
+type RawPathToCommands<P extends string> = P extends string ? P extends `${infer Head}/${infer Rest}` ? ResolveSegment<Head> extends infer H ? H extends string | number ? [H, ...RawPathToCommands<Rest>] : never : never : P extends '' ? [] : ResolveSegment<P> extends infer H ? H extends string | number ? [H] : never : never : never;
+
+/**
+ * Strips a trailing `/` from a string, with one exception: a bare `'/'` (the
+ * root URL) is preserved.
+ *
+ * @example
+ *   RemoveTrailingSlash<'/home/'>   // '/home'
+ *   RemoveTrailingSlash<'/'>        // '/'
+ *   RemoveTrailingSlash<'/home'>    // '/home'
+ */
+type RemoveTrailingSlash<S extends string> = S extends '/' ? S : S extends `${infer T}/` ? RemoveTrailingSlash<T> : S;
+
+/** Augmentation target. Consumers declare their routes here:
+ *  `declare module 'angular-typed-router' { interface UserTypedRoutes { routes: typeof routes } }` */
+interface UserTypedRoutes {
+}
+type ProvidedRoutes = UserTypedRoutes extends {
+    routes: readonly Route[];
+} ? UserTypedRoutes['routes'] : [];
+type RawPaths = ExtractRawPaths<ProvidedRoutes>;
+type Path = RemoveTrailingSlash<`/${RawPathToUrl<RawPaths>}`>;
+type Commands = readonly ['/', ...RawPathToCommands<RawPaths>];
+
+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, Path, RouteParamTypes, UserTypedRoutes };

package/index.d.ts

@@ -1,68 +0,0 @@
-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;
-};
-interface RouteParamTypes {
-}
-type ParamValueType<Name extends string> = Name extends keyof RouteParamTypes ? RouteParamTypes[Name] : never;
-type _ReplaceParams<S extends string> = S extends `${infer Start}:${infer Param}/${infer Rest}` ? `${Start}${ParamValueType<Param>}/${_ReplaceParams<Rest>}` : S extends `${infer Start}:${infer Param}` ? `${Start}${ParamValueType<Param>}` : 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, RouteParamTypes, UserTypedRoutes };