@esmx/router-vue 3.0.0-rc.105 → 3.0.0-rc.107

package/dist/use.d.ts

@@ -219,12 +219,26 @@ export declare function _useRouterViewDepth(isRender?: boolean): number;
  */
 export declare function useRouterViewDepth(): number;
 /**
- * Get injected RouterView depth from a Vue instance's ancestors.
- * Traverses parent chain to find the value provided under ROUTER_VIEW_DEPTH_KEY.
+ * Get the current RouterView depth in nested routing scenarios.
+ * Returns the depth of the current RouterView component in the component tree.
+ * Useful for advanced routing scenarios where you need to know the nesting level.
  *
  * @param instance - Vue component instance to start from
- * @returns Injected RouterView depth value from nearest ancestor
- * @throws {Error} If no ancestor provided ROUTER_VIEW_DEPTH_KEY
+ * @returns Current RouterView depth (0 for root level, 1 for first nested level, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Options API usage
+ * import { defineComponent } from 'vue';
+ * import { getRouterViewDepth } from '@esmx/router-vue';
+ *
+ * export default defineComponent({
+ *   mounted() {
+ *     const depth = getRouterViewDepth(this);
+ *     console.log('Current RouterView depth:', depth); // 0, 1, 2, etc.
+ *   }
+ * });
+ * ```
  */
 export declare function getRouterViewDepth(instance: VueInstance): number;
 /**

package/dist/use.mjs

@@ -113,9 +113,7 @@ export function getRouterViewDepth(instance) {
     if (typeof value === "number") return value;
     current = current.$parent;
   }
-  throw new Error(
-    "[@esmx/router-vue] RouterView depth not found. Please ensure a RouterView exists in ancestor components."
-  );
+  return 0;
 }
 export function useLink(props) {
   const router = useRouter();

package/dist/use.test.mjs

@@ -295,12 +295,12 @@ describe("Router Vue Integration", () => {
       await nextTick();
       expect(observedDepth).toBe(3);
     });
-    it("should throw when no RouterView ancestor exists", async () => {
-      let callDepth;
+    it("should return 0 when no RouterView ancestor exists", async () => {
+      let observedDepth;
       const Probe = defineComponent({
         setup() {
           const p = getCurrentInstance().proxy;
-          callDepth = () => getRouterViewDepth(p);
+          observedDepth = getRouterViewDepth(p);
           return () => h("div");
         }
       });
@@ -313,11 +313,7 @@ describe("Router Vue Integration", () => {
       app = createApp(TestApp);
       app.mount("#app");
       await nextTick();
-      expect(() => callDepth()).toThrow(
-        new Error(
-          "[@esmx/router-vue] RouterView depth not found. Please ensure a RouterView exists in ancestor components."
-        )
-      );
+      expect(observedDepth).toBe(0);
     });
     it("should return 0 for useRouterViewDepth without RouterView", async () => {
       let observed = -1;

package/package.json

@@ -50,7 +50,7 @@
         "vue": "^3.5.0 || ^2.7.0"
     },
     "dependencies": {
-        "@esmx/router": "3.0.0-rc.105"
+        "@esmx/router": "3.0.0-rc.107"
     },
     "devDependencies": {
         "@biomejs/biome": "2.3.7",
@@ -62,7 +62,7 @@
         "vue": "3.5.23",
         "vue2": "npm:vue@2.7.16"
     },
-    "version": "3.0.0-rc.105",
+    "version": "3.0.0-rc.107",
     "type": "module",
     "private": false,
     "exports": {
@@ -81,5 +81,5 @@
         "template",
         "public"
     ],
-    "gitHead": "db0f4a2a8a54a932f900d0b4f09ef0bf1ca9243f"
+    "gitHead": "28155d02a6222ce59a24f3f707359e8e89e4f36d"
 }

package/src/use.test.ts

@@ -381,13 +381,13 @@ describe('Router Vue Integration', () => {
             expect(observedDepth).toBe(3);
         });
 
-        it('should throw when no RouterView ancestor exists', async () => {
-            let callDepth: (() => void) | undefined;
+        it('should return 0 when no RouterView ancestor exists', async () => {
+            let observedDepth: number | undefined;
 
             const Probe = defineComponent({
                 setup() {
                     const p = getCurrentInstance()!.proxy as any;
-                    callDepth = () => getRouterViewDepth(p);
+                    observedDepth = getRouterViewDepth(p);
                     return () => h('div');
                 }
             });
@@ -403,11 +403,7 @@ describe('Router Vue Integration', () => {
             app.mount('#app');
             await nextTick();
 
-            expect(() => callDepth!()).toThrow(
-                new Error(
-                    '[@esmx/router-vue] RouterView depth not found. Please ensure a RouterView exists in ancestor components.'
-                )
-            );
+            expect(observedDepth).toBe(0);
         });
 
         it('should return 0 for useRouterViewDepth without RouterView', async () => {

package/src/use.ts

@@ -358,12 +358,26 @@ export function useRouterViewDepth(): number {
 }
 
 /**
- * Get injected RouterView depth from a Vue instance's ancestors.
- * Traverses parent chain to find the value provided under ROUTER_VIEW_DEPTH_KEY.
+ * Get the current RouterView depth in nested routing scenarios.
+ * Returns the depth of the current RouterView component in the component tree.
+ * Useful for advanced routing scenarios where you need to know the nesting level.
  *
  * @param instance - Vue component instance to start from
- * @returns Injected RouterView depth value from nearest ancestor
- * @throws {Error} If no ancestor provided ROUTER_VIEW_DEPTH_KEY
+ * @returns Current RouterView depth (0 for root level, 1 for first nested level, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Options API usage
+ * import { defineComponent } from 'vue';
+ * import { getRouterViewDepth } from '@esmx/router-vue';
+ *
+ * export default defineComponent({
+ *   mounted() {
+ *     const depth = getRouterViewDepth(this);
+ *     console.log('Current RouterView depth:', depth); // 0, 1, 2, etc.
+ *   }
+ * });
+ * ```
  */
 export function getRouterViewDepth(instance: VueInstance): number {
     let current = instance.$parent;
@@ -372,9 +386,7 @@ export function getRouterViewDepth(instance: VueInstance): number {
         if (typeof value === 'number') return value;
         current = current.$parent;
     }
-    throw new Error(
-        '[@esmx/router-vue] RouterView depth not found. Please ensure a RouterView exists in ancestor components.'
-    );
+    return 0;
 }
 
 /**