vue-micro-router 1.0.61 → 1.0.63

package/README.md

@@ -445,6 +445,11 @@ const { stepWisePush, stepWiseBack } = useMicroRouter();
 // Walk through: home → home/onboarding → home/onboarding/step1
 await stepWisePush('/home/onboarding/step1');
 
+// Relative multi-segment paths are type-checked: every segment must be a
+// known route, joined by `/`, in any order and to any depth.
+await stepWisePush('onboarding/step1'); // ✅ each segment validated
+await stepWisePush('onboarding/oops');  // ❌ compile error — unknown segment
+
 // Step back through each page with animation
 await stepWiseBack(3);
 ```

package/dist/index.d.ts

@@ -25,9 +25,7 @@ Defaults: {};
 }, Readonly<TransitionGroupProps>, {}, {}, ComputedOptions, MethodOptions, {}> | null;
 }, any>;
 
-declare const __VLS_component_2: DefineComponent<Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<Props_2> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
-pageRef: HTMLDivElement;
-}, HTMLDivElement>;
+declare const __VLS_component_2: DefineComponent<Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<Props_2> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
 declare const __VLS_component_3: DefineComponent<Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
 close: (path: string) => any;
@@ -60,9 +58,7 @@ declare function __VLS_template_2(): {
     slots: {
         default?(_: {}): any;
     };
-    refs: {
-        pageRef: HTMLDivElement;
-    };
+    refs: {};
     rootEl: HTMLDivElement;
 };
 
@@ -330,9 +326,7 @@ export declare interface MicroControl {
     componentKey?: number;
 }
 
-export declare const MicroControlWrapper: DefineComponent<Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<Props_4> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
-wrapperRef: HTMLDivElement;
-}, HTMLDivElement>;
+export declare const MicroControlWrapper: DefineComponent<Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<Props_4> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 export declare interface MicroDialog {
     /** Unique dialog identifier, e.g. "confirm", "settings-modal" */
@@ -641,6 +635,7 @@ declare interface PluginTypedStepWiseBack {
 
 declare interface PluginTypedStepWisePush<Routes extends string, AttrsMap = {}> {
     <K extends Routes>(targetPath: K, ...args: PropsArgs<K, AttrsMap>): Promise<void>;
+    <S extends string>(targetPath: S & RouteSegmentPath<S, Routes>, props?: Record<string, unknown>): Promise<void>;
     (targetPath: `/${string}`, props?: Record<string, unknown>): Promise<void>;
 }
 
@@ -762,6 +757,15 @@ export declare type RouteMap = Record<string, Record<string, unknown> | undefine
 
 export declare const RoutePage: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
 
+/**
+ * Validate a `/`-joined path where every segment must be a known route.
+ * Returns `S` when valid, else `never`. Given routes `'a' | 'b'`:
+ *   'a' ✓  'a/b' ✓  'b/a/b' ✓  'a/x' ✗ (→ never)  'x' ✗ (→ never)
+ * Walks the string via `infer` (bounded by segment count) — no infinite union,
+ * so it stays cheap for arbitrary depth like `'a/b/c/d/f'`.
+ */
+declare type RouteSegmentPath<S extends string, Routes extends string> = S extends `${infer Head}/${infer Rest}` ? [Head] extends [Routes] ? [RouteSegmentPath<Rest, Routes>] extends [never] ? never : S : never : [S] extends [Routes] ? S : never;
+
 /** Extract route names that don't require props */
 export declare type RoutesWithoutProps<T extends RouteMap> = {
     [K in keyof T]: T[K] extends undefined ? K : never;