@loozo/angular-router 0.0.5 → 0.0.7

package/types/loozo-angular-router-_generated.d.ts

@@ -9,7 +9,7 @@ interface RouteSet {
   readonly records: Readonly<Record<string, RecordBinding>>;
   readonly destinations: Readonly<Record<string, () => AnyRoute>>;
   readonly absolute: Readonly<Record<string, string>>;
-  readonly relative: Readonly<Record<string, Readonly<Record<string, string>>>>;
+  readonly parents: Readonly<Record<string, string>>;
 }
 interface Parsed {
   readonly params: Readonly<Record<string, unknown>>;
@@ -106,14 +106,15 @@ type IsUnion<Value, Whole = Value> = Value extends unknown ? [Whole] extends [Va
  * rejects a value it accepted while matching, a programming error.
  *
  * Selectors are single known authored literals, not concrete URLs or string
- * unions. `.` is exact-current; other absolute/relative selections use generated
- * canonical targets. Relative climbs count URL-template segments, not parent
- * edges. Catchall origins permit exact-current, absolute and reference targets,
- * not depth-dependent relative traversal. Every call supplies all target values;
- * there is no current-value reuse, extras argument or implicit query merge.
+ * unions. `.` is exact-current; `..` selects the parent route: the nearest
+ * ancestor with a shorter path, or the root for a top-level route. It and
+ * absolute selectors use generated canonical targets. Every call supplies all
+ * target values; there is no current-value reuse, extras argument or implicit
+ * query merge.
  *
  * @typeParam Target - The bound declaration's schema.
- * @typeParam Selected - Statically admitted literal selectors and target schemas.
+ * @typeParam Absolute - Absolute literal selectors and their target schemas.
+ * @typeParam Parent - The `..` target's schema, or never when there is none.
  * @typeParam Set - The generator's nominal route-set identity.
  * @typeParam References - Exact declarations addressable by same-set references.
  *
@@ -127,7 +128,7 @@ type IsUnion<Value, Whole = Value> = Value extends unknown ? [Whole] extends [Va
  * // Bind link to Angular RouterLink, or call route.navigate with the same values.
  * ```
  */
-export interface Handle<Target extends AnyRoute, Selected extends Record<string, AnyRoute> = {}, Set = unknown, References extends Record<string, AnyRoute> = {}> {
+export interface Handle<Target extends AnyRoute, Absolute extends Record<string, AnyRoute> = {}, Parent extends AnyRoute = never, Set = unknown, References extends Record<string, AnyRoute> = {}> {
   /** Effective positional params of the committed snapshot; kept while a navigation is pending. */
   readonly params: Signal<Readonly<ParamsOf<Target>>>;
   /** Effective declared search, from the same snapshot as params; absent keys have no value or fallback. */
@@ -152,14 +153,23 @@ export interface Handle<Target extends AnyRoute, Selected extends Record<string,
    */
   link<Keys extends keyof SearchOf<Target> = never>(selector: ".", values: UrlValues<Target, Keys>): UrlTree;
   /**
-   * Creates a UrlTree for a statically admitted absolute/relative authored selector.
+   * Creates a UrlTree for a statically admitted absolute authored selector.
    *
    * @param selector - A single known template literal, never a concrete URL.
    * @param values - The selected target's complete explicit values.
    * @returns Router.parseUrl's result without navigating.
    * @throws Synchronously for unknown selectors or invalid URL values.
    */
-  link<const Selector extends keyof Selected & string, Keys extends keyof SearchOf<NoInfer<Selected[Selector]>> = never>(selector: Selector & (IsUnion<Selector> extends true ? never : unknown), values: UrlValues<NoInfer<Selected[Selector]>, Keys>): UrlTree;
+  link<const Selector extends keyof Absolute & string, Keys extends keyof SearchOf<NoInfer<Absolute[Selector]>> = never>(selector: Selector & (IsUnion<Selector> extends true ? never : unknown), values: UrlValues<NoInfer<Absolute[Selector]>, Keys>): UrlTree;
+  /**
+   * Creates a UrlTree for the parent route, when the bound declaration has one.
+   *
+   * @param selector - The literal `..`.
+   * @param values - The parent route's complete explicit values.
+   * @returns Router.parseUrl's result without navigating.
+   * @throws Synchronously for invalid URL values.
+   */
+  link<Keys extends keyof SearchOf<Parent> = never>(selector: [Parent] extends [never] ? never : "..", values: UrlValues<Parent, Keys>): UrlTree;
   /**
    * Creates a UrlTree for a generated reference's own exact declaration.
    *
@@ -187,14 +197,23 @@ export interface Handle<Target extends AnyRoute, Selected extends Record<string,
    */
   navigate<Keys extends keyof SearchOf<Target> = never>(selector: ".", values: UrlValues<Target, Keys>): Promise<boolean>;
   /**
-   * Navigates to a statically admitted absolute/relative authored selector.
+   * Navigates to a statically admitted absolute authored selector.
    *
    * @param selector - A single known template literal, never a concrete URL.
    * @param values - The selected target's complete explicit values.
    * @returns Angular's identical Router.navigateByUrl Promise.
    * @throws Synchronously for unknown selectors or invalid URL values.
    */
-  navigate<const Selector extends keyof Selected & string, Keys extends keyof SearchOf<NoInfer<Selected[Selector]>> = never>(selector: Selector & (IsUnion<Selector> extends true ? never : unknown), values: UrlValues<NoInfer<Selected[Selector]>, Keys>): Promise<boolean>;
+  navigate<const Selector extends keyof Absolute & string, Keys extends keyof SearchOf<NoInfer<Absolute[Selector]>> = never>(selector: Selector & (IsUnion<Selector> extends true ? never : unknown), values: UrlValues<NoInfer<Absolute[Selector]>, Keys>): Promise<boolean>;
+  /**
+   * Navigates to the parent route, when the bound declaration has one.
+   *
+   * @param selector - The literal `..`.
+   * @param values - The parent route's complete explicit values.
+   * @returns Angular's identical Router.navigateByUrl Promise.
+   * @throws Synchronously for invalid URL values.
+   */
+  navigate<Keys extends keyof SearchOf<Parent> = never>(selector: [Parent] extends [never] ? never : "..", values: UrlValues<Parent, Keys>): Promise<boolean>;
   /**
    * Navigates to a generated reference's own exact declaration.
    *
@@ -206,5 +225,5 @@ export interface Handle<Target extends AnyRoute, Selected extends Record<string,
   navigate<const Id extends keyof References & string, Keys extends keyof SearchOf<NoInfer<References[Id]>> = never>(selector: Destination<NoInfer<References[Id]>, Set, Id> & (IsUnion<Id> extends true ? never : unknown), values: UrlValues<NoInfer<References[Id]>, Keys>): Promise<boolean>;
 }
 export declare function nativeOptions(definition: AnyRoute): Record<string, unknown>;
-export declare function injectGeneratedRoute<Target extends AnyRoute, Selected extends Record<string, AnyRoute>, Set, References extends Record<string, AnyRoute>>(set: RouteSet, id: string): Handle<Target, Selected, Set, References>;
+export declare function injectGeneratedRoute<Target extends AnyRoute, Absolute extends Record<string, AnyRoute>, Parent extends AnyRoute, Set, References extends Record<string, AnyRoute>>(set: RouteSet, id: string): Handle<Target, Absolute, Parent, Set, References>;
 export type { RecordBinding, RouteSet };