@vuecs/navigation 3.0.2 → 4.0.1

package/README.md

@@ -3,12 +3,12 @@
 [![npm version](https://badge.fury.io/js/@vuecs%2Fnavigation.svg)](https://badge.fury.io/js/@vuecs%2Fnavigation)
 [![main](https://github.com/Tada5hi/vuecs/actions/workflows/main.yml/badge.svg)](https://github.com/Tada5hi/vuecs/actions/workflows/main.yml)
 
-Multi-level navigation for Vue 3 with `vue-router` integration and a shared NavigationManager for cross-component state. Also ships `<VCStepper>` (built on Reka's `StepperRoot`) for multi-step wizards / checkout / onboarding flows — owns its own state, no NavigationManager dependency.
+Multi-level navigation for Vue 3 with optional `vue-router` integration. Every `<VCNavItems>` owns its items via a `:data` prop; navs opt into publishing to / reading from a shared reactive registry for dependent layouts (e.g. header → sidebar). Also ships `<VCStepper>` (built on Reka's `StepperRoot`) for multi-step wizards / checkout / onboarding flows.
 
 Full documentation:
 
 - [Navigation component](https://vuecs.dev/components/navigation)
-- [Navigation Manager guide](https://vuecs.dev/guide/navigation-manager)
+- [Navigation guide](https://vuecs.dev/guide/navigation)
 - [Stepper component](https://vuecs.dev/components/stepper)
 
 ```bash

package/dist/components/index.d.ts

@@ -1,5 +1,6 @@
 export * from './item/module';
 export * from './items';
+export * from './select-context';
 export * from './stepper';
 export * from './type';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}

package/dist/components/item/module.d.ts

@@ -1,6 +1,6 @@
 import type { ThemeClassesOverride, VariantValues } from '@vuecs/core';
-import type { ExtractPublicPropTypes, PropType, SlotsType } from 'vue';
-import type { NavigationItemNormalized } from '../../types';
+import type { Component, ExtractPublicPropTypes, PropType, SlotsType } from 'vue';
+import type { NavigationItemNormalized, NavigationOrientation, NavigationSubmenuMode } from '../../types';
 import type { NavigationThemeClasses } from '../../helpers/component/types';
 import type { NavItemLinkSlotProps, NavItemSeparatorSlotProps, NavItemSubItemsSlotProps, NavItemSubSlotProps, NavItemSubTitleSlotProps } from '../type';
 declare const navItemProps: {
@@ -8,6 +8,42 @@ declare const navItemProps: {
         type: PropType<NavigationItemNormalized>;
         required: boolean;
     };
+    variant: {
+        type: StringConstructor;
+        default: any;
+    };
+    orientation: {
+        type: PropType<NavigationOrientation>;
+        default: any;
+    };
+    /**
+     * Resolved submenu presentation handed down by the parent
+     * `<VCNavItems>`. `collapse` renders groups as an inline
+     * Reka `Collapsible`; `dropdown` renders them as Reka
+     * `NavigationMenu` flyouts.
+     */
+    submenu: {
+        type: PropType<NavigationSubmenuMode>;
+        default: string;
+    };
+    /**
+     * The tag (or component) this item renders as — its own wrapper
+     * (`<li>` by default). Receives `<VCNavItems>`' `itemAs`. Honored in
+     * collapse mode only.
+     */
+    as: {
+        type: PropType<string | Component>;
+        default: string;
+    };
+    /**
+     * The list-container tag for this item's nested submenu
+     * `<VCNavItems>` (`<ul>` by default). Receives `<VCNavItems>`' `as`.
+     * Honored in collapse mode only.
+     */
+    itemsAs: {
+        type: PropType<string | Component>;
+        default: string;
+    };
     themeClass: {
         type: PropType<ThemeClassesOverride<NavigationThemeClasses>>;
         default: any;
@@ -23,6 +59,42 @@ export declare const VCNavItem: import("vue").DefineComponent<import("vue").Extr
         type: PropType<NavigationItemNormalized>;
         required: boolean;
     };
+    variant: {
+        type: StringConstructor;
+        default: any;
+    };
+    orientation: {
+        type: PropType<NavigationOrientation>;
+        default: any;
+    };
+    /**
+     * Resolved submenu presentation handed down by the parent
+     * `<VCNavItems>`. `collapse` renders groups as an inline
+     * Reka `Collapsible`; `dropdown` renders them as Reka
+     * `NavigationMenu` flyouts.
+     */
+    submenu: {
+        type: PropType<NavigationSubmenuMode>;
+        default: string;
+    };
+    /**
+     * The tag (or component) this item renders as — its own wrapper
+     * (`<li>` by default). Receives `<VCNavItems>`' `itemAs`. Honored in
+     * collapse mode only.
+     */
+    as: {
+        type: PropType<string | Component>;
+        default: string;
+    };
+    /**
+     * The list-container tag for this item's nested submenu
+     * `<VCNavItems>` (`<ul>` by default). Receives `<VCNavItems>`' `as`.
+     * Honored in collapse mode only.
+     */
+    itemsAs: {
+        type: PropType<string | Component>;
+        default: string;
+    };
     themeClass: {
         type: PropType<ThemeClassesOverride<NavigationThemeClasses>>;
         default: any;
@@ -38,6 +110,42 @@ export declare const VCNavItem: import("vue").DefineComponent<import("vue").Extr
         type: PropType<NavigationItemNormalized>;
         required: boolean;
     };
+    variant: {
+        type: StringConstructor;
+        default: any;
+    };
+    orientation: {
+        type: PropType<NavigationOrientation>;
+        default: any;
+    };
+    /**
+     * Resolved submenu presentation handed down by the parent
+     * `<VCNavItems>`. `collapse` renders groups as an inline
+     * Reka `Collapsible`; `dropdown` renders them as Reka
+     * `NavigationMenu` flyouts.
+     */
+    submenu: {
+        type: PropType<NavigationSubmenuMode>;
+        default: string;
+    };
+    /**
+     * The tag (or component) this item renders as — its own wrapper
+     * (`<li>` by default). Receives `<VCNavItems>`' `itemAs`. Honored in
+     * collapse mode only.
+     */
+    as: {
+        type: PropType<string | Component>;
+        default: string;
+    };
+    /**
+     * The list-container tag for this item's nested submenu
+     * `<VCNavItems>` (`<ul>` by default). Receives `<VCNavItems>`' `as`.
+     * Honored in collapse mode only.
+     */
+    itemsAs: {
+        type: PropType<string | Component>;
+        default: string;
+    };
     themeClass: {
         type: PropType<ThemeClassesOverride<NavigationThemeClasses>>;
         default: any;
@@ -47,6 +155,11 @@ export declare const VCNavItem: import("vue").DefineComponent<import("vue").Extr
         default: any;
     };
 }>> & Readonly<{}>, {
+    variant: string;
+    orientation: NavigationOrientation;
+    submenu: NavigationSubmenuMode;
+    as: string;
+    itemsAs: string;
     themeClass: ThemeClassesOverride<NavigationThemeClasses>;
     themeVariant: VariantValues;
 }, SlotsType<{

package/dist/components/item/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/components/item/module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGvE,OAAO,KAAK,EACR,sBAAsB,EACtB,QAAQ,EACR,SAAS,EAEZ,MAAM,KAAK,CAAC;AASb,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAG5E,OAAO,KAAK,EACR,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EAC3B,MAAM,SAAS,CAAC;AAGjB,QAAA,MAAM,YAAY;;cAEM,QAAQ,CAAC,wBAAwB,CAAC;;;;cAIlC,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cAItD,QAAQ,CAAC,aAAa,CAAC;;;CAG9C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvE,eAAO,MAAM,SAAS;;cAfE,QAAQ,CAAC,wBAAwB,CAAC;;;;cAIlC,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cAItD,QAAQ,CAAC,aAAa,CAAC;;;;;;;cARvB,QAAQ,CAAC,wBAAwB,CAAC;;;;cAIlC,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cAItD,QAAQ,CAAC,aAAa,CAAC;;;;;;;eAW5B,yBAAyB;UAC9B,oBAAoB;SACrB,mBAAmB;iBACX,wBAAwB;iBACxB,wBAAwB;yEA4L3C,CAAC"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/components/item/module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAA0B,aAAa,EAAE,MAAM,aAAa,CAAC;AAG/F,OAAO,KAAK,EACR,SAAS,EACT,sBAAsB,EACtB,QAAQ,EACR,SAAS,EAEZ,MAAM,KAAK,CAAC;AAqBb,OAAO,KAAK,EACR,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAG5E,OAAO,KAAK,EACR,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EAC3B,MAAM,SAAS,CAAC;AAIjB,QAAA,MAAM,YAAY;;cAEM,QAAQ,CAAC,wBAAwB,CAAC;;;;;;;;cAQlC,QAAQ,CAAC,qBAAqB,CAAC;;;IAGnD;;;;;OAKG;;cAEiB,QAAQ,CAAC,qBAAqB,CAAC;;;IAGnD;;;;OAIG;;cAE2B,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;IAG1D;;;;OAIG;;cAE2B,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;;cAItC,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cAItD,QAAQ,CAAC,aAAa,CAAC;;;CAG9C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvE,eAAO,MAAM,SAAS;;cAnDE,QAAQ,CAAC,wBAAwB,CAAC;;;;;;;;cAQlC,QAAQ,CAAC,qBAAqB,CAAC;;;IAGnD;;;;;OAKG;;cAEiB,QAAQ,CAAC,qBAAqB,CAAC;;;IAGnD;;;;OAIG;;cAE2B,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;IAG1D;;;;OAIG;;cAE2B,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;;cAItC,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cAItD,QAAQ,CAAC,aAAa,CAAC;;;;;;;cA5CvB,QAAQ,CAAC,wBAAwB,CAAC;;;;;;;;cAQlC,QAAQ,CAAC,qBAAqB,CAAC;;;IAGnD;;;;;OAKG;;cAEiB,QAAQ,CAAC,qBAAqB,CAAC;;;IAGnD;;;;OAIG;;cAE2B,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;IAG1D;;;;OAIG;;cAE2B,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;;cAItC,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cAItD,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;;;eAW5B,yBAAyB;UAC9B,oBAAoB;SACrB,mBAAmB;iBACX,wBAAwB;iBACxB,wBAAwB;yEAmQ3C,CAAC"}

package/dist/components/items/module.d.ts

@@ -1,17 +1,86 @@
 import type { ThemeClassesOverride, VariantValues } from '@vuecs/core';
-import type { ExtractPublicPropTypes, PropType, SlotsType } from 'vue';
-import type { NavigationItemNormalized } from '../../types';
+import type { Component, ExtractPublicPropTypes, PropType, SlotsType, WatchSource } from 'vue';
+import type { NavigationItem, NavigationOrientation, NavigationResolver, NavigationSubmenu } from '../../types';
 import type { NavigationThemeClasses } from '../../helpers/component/types';
 import type { NavItemsItemSlotProps } from '../type';
 declare const navItemsProps: {
-    level: {
-        type: NumberConstructor;
-        default: number;
-    };
+    /**
+     * The source of this nav's items. Plain array, sync fn, or async fn.
+     * A fn receives a NavigationResolverContext and may read reactive
+     * state freely — the nav re-runs it automatically when that state
+     * changes.
+     *
+     * When omitted, the nav checks whether it is a nested submenu of a
+     * parent `<VCNavItem>` (via the {@link NAVIGATION_NODES_KEY} inject)
+     * and, if so, renders that parent's already-scored children as-is.
+     */
     data: {
-        type: PropType<NavigationItemNormalized[]>;
+        type: PropType<NavigationItem[] | NavigationResolver>;
+        default: any;
+    };
+    /** Opt in to publishing this nav's resolved output into the registry. */
+    registry: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** The key under which to publish. Required when `registry` is true. */
+    registryId: {
+        type: StringConstructor;
+        default: any;
+    };
+    /**
+     * Current path for active-state matching. When omitted, the nav softly
+     * reads vue-router's current route (via the `$route` global property)
+     * if a router is installed; router-free apps simply get `undefined`.
+     */
+    path: {
+        type: StringConstructor;
+        default: any;
+    };
+    /**
+     * Extra reactive deps that should retrigger the resolver — for state
+     * read only AFTER the first `await` in an async resolver (auto-track
+     * can't see past an await).
+     */
+    watch: {
+        type: PropType<WatchSource[]>;
+        default: any;
+    };
+    variant: {
+        type: StringConstructor;
+        default: any;
+    };
+    orientation: {
+        type: PropType<NavigationOrientation>;
         default: any;
     };
+    /**
+     * How items with children render their submenu. `auto` derives from
+     * orientation (horizontal → dropdown, otherwise collapse).
+     */
+    submenu: {
+        type: PropType<NavigationSubmenu>;
+        default: string;
+    };
+    /**
+     * The tag (or component) for this nav's list container. Defaults to
+     * `'ul'`. Forwarded unchanged to every nesting level so the whole tree
+     * renders the same container tag. Honored in collapse mode only —
+     * dropdown mode keeps Reka's NavigationMenu primitives.
+     */
+    as: {
+        type: PropType<string | Component>;
+        default: string;
+    };
+    /**
+     * The tag (or component) for each item wrapper. Defaults to `'li'`.
+     * Forwarded unchanged to every nesting level. Honored in collapse mode
+     * only — dropdown mode keeps Reka's NavigationMenu primitives.
+     */
+    itemAs: {
+        type: PropType<string | Component>;
+        default: string;
+    };
     themeClass: {
         type: PropType<ThemeClassesOverride<NavigationThemeClasses>>;
         default: any;
@@ -23,14 +92,83 @@ declare const navItemsProps: {
 };
 export type NavItemsProps = ExtractPublicPropTypes<typeof navItemsProps>;
 export declare const VCNavItems: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    level: {
-        type: NumberConstructor;
-        default: number;
-    };
+    /**
+     * The source of this nav's items. Plain array, sync fn, or async fn.
+     * A fn receives a NavigationResolverContext and may read reactive
+     * state freely — the nav re-runs it automatically when that state
+     * changes.
+     *
+     * When omitted, the nav checks whether it is a nested submenu of a
+     * parent `<VCNavItem>` (via the {@link NAVIGATION_NODES_KEY} inject)
+     * and, if so, renders that parent's already-scored children as-is.
+     */
     data: {
-        type: PropType<NavigationItemNormalized[]>;
+        type: PropType<NavigationItem[] | NavigationResolver>;
+        default: any;
+    };
+    /** Opt in to publishing this nav's resolved output into the registry. */
+    registry: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** The key under which to publish. Required when `registry` is true. */
+    registryId: {
+        type: StringConstructor;
+        default: any;
+    };
+    /**
+     * Current path for active-state matching. When omitted, the nav softly
+     * reads vue-router's current route (via the `$route` global property)
+     * if a router is installed; router-free apps simply get `undefined`.
+     */
+    path: {
+        type: StringConstructor;
+        default: any;
+    };
+    /**
+     * Extra reactive deps that should retrigger the resolver — for state
+     * read only AFTER the first `await` in an async resolver (auto-track
+     * can't see past an await).
+     */
+    watch: {
+        type: PropType<WatchSource[]>;
         default: any;
     };
+    variant: {
+        type: StringConstructor;
+        default: any;
+    };
+    orientation: {
+        type: PropType<NavigationOrientation>;
+        default: any;
+    };
+    /**
+     * How items with children render their submenu. `auto` derives from
+     * orientation (horizontal → dropdown, otherwise collapse).
+     */
+    submenu: {
+        type: PropType<NavigationSubmenu>;
+        default: string;
+    };
+    /**
+     * The tag (or component) for this nav's list container. Defaults to
+     * `'ul'`. Forwarded unchanged to every nesting level so the whole tree
+     * renders the same container tag. Honored in collapse mode only —
+     * dropdown mode keeps Reka's NavigationMenu primitives.
+     */
+    as: {
+        type: PropType<string | Component>;
+        default: string;
+    };
+    /**
+     * The tag (or component) for each item wrapper. Defaults to `'li'`.
+     * Forwarded unchanged to every nesting level. Honored in collapse mode
+     * only — dropdown mode keeps Reka's NavigationMenu primitives.
+     */
+    itemAs: {
+        type: PropType<string | Component>;
+        default: string;
+    };
     themeClass: {
         type: PropType<ThemeClassesOverride<NavigationThemeClasses>>;
         default: any;
@@ -42,14 +180,83 @@ export declare const VCNavItems: import("vue").DefineComponent<import("vue").Ext
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    level: {
-        type: NumberConstructor;
-        default: number;
-    };
+    /**
+     * The source of this nav's items. Plain array, sync fn, or async fn.
+     * A fn receives a NavigationResolverContext and may read reactive
+     * state freely — the nav re-runs it automatically when that state
+     * changes.
+     *
+     * When omitted, the nav checks whether it is a nested submenu of a
+     * parent `<VCNavItem>` (via the {@link NAVIGATION_NODES_KEY} inject)
+     * and, if so, renders that parent's already-scored children as-is.
+     */
     data: {
-        type: PropType<NavigationItemNormalized[]>;
+        type: PropType<NavigationItem[] | NavigationResolver>;
+        default: any;
+    };
+    /** Opt in to publishing this nav's resolved output into the registry. */
+    registry: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** The key under which to publish. Required when `registry` is true. */
+    registryId: {
+        type: StringConstructor;
         default: any;
     };
+    /**
+     * Current path for active-state matching. When omitted, the nav softly
+     * reads vue-router's current route (via the `$route` global property)
+     * if a router is installed; router-free apps simply get `undefined`.
+     */
+    path: {
+        type: StringConstructor;
+        default: any;
+    };
+    /**
+     * Extra reactive deps that should retrigger the resolver — for state
+     * read only AFTER the first `await` in an async resolver (auto-track
+     * can't see past an await).
+     */
+    watch: {
+        type: PropType<WatchSource[]>;
+        default: any;
+    };
+    variant: {
+        type: StringConstructor;
+        default: any;
+    };
+    orientation: {
+        type: PropType<NavigationOrientation>;
+        default: any;
+    };
+    /**
+     * How items with children render their submenu. `auto` derives from
+     * orientation (horizontal → dropdown, otherwise collapse).
+     */
+    submenu: {
+        type: PropType<NavigationSubmenu>;
+        default: string;
+    };
+    /**
+     * The tag (or component) for this nav's list container. Defaults to
+     * `'ul'`. Forwarded unchanged to every nesting level so the whole tree
+     * renders the same container tag. Honored in collapse mode only —
+     * dropdown mode keeps Reka's NavigationMenu primitives.
+     */
+    as: {
+        type: PropType<string | Component>;
+        default: string;
+    };
+    /**
+     * The tag (or component) for each item wrapper. Defaults to `'li'`.
+     * Forwarded unchanged to every nesting level. Honored in collapse mode
+     * only — dropdown mode keeps Reka's NavigationMenu primitives.
+     */
+    itemAs: {
+        type: PropType<string | Component>;
+        default: string;
+    };
     themeClass: {
         type: PropType<ThemeClassesOverride<NavigationThemeClasses>>;
         default: any;
@@ -59,10 +266,18 @@ export declare const VCNavItems: import("vue").DefineComponent<import("vue").Ext
         default: any;
     };
 }>> & Readonly<{}>, {
-    level: number;
-    data: NavigationItemNormalized[];
+    variant: string;
+    orientation: NavigationOrientation;
+    data: NavigationItem[] | NavigationResolver;
+    submenu: NavigationSubmenu;
+    as: string;
     themeClass: ThemeClassesOverride<NavigationThemeClasses>;
     themeVariant: VariantValues;
+    watch: WatchSource[];
+    itemAs: string;
+    registry: boolean;
+    registryId: string;
+    path: string;
 }, SlotsType<{
     item: NavItemsItemSlotProps;
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/items/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/components/items/module.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EACR,sBAAsB,EACtB,QAAQ,EACR,SAAS,EAGZ,MAAM,KAAK,CAAC;AAWb,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGrD,QAAA,MAAM,aAAa;;;;;;cAEQ,QAAQ,CAAC,wBAAwB,EAAE,CAAC;;;;cAC7B,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cACpD,QAAQ,CAAC,aAAa,CAAC;;;CAC1D,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,sBAAsB,CAAC,OAAO,aAAa,CAAC,CAAC;AAEzE,eAAO,MAAM,UAAU;;;;;;cAPI,QAAQ,CAAC,wBAAwB,EAAE,CAAC;;;;cAC7B,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cACpD,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;;cAFhC,QAAQ,CAAC,wBAAwB,EAAE,CAAC;;;;cAC7B,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cACpD,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;UAS7C,qBAAqB;yEAiGjC,CAAC"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/components/items/module.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAA0B,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,KAAK,EACR,SAAS,EACT,sBAAsB,EACtB,QAAQ,EACR,SAAS,EAGT,WAAW,EACd,MAAM,KAAK,CAAC;AAgBb,OAAO,KAAK,EACR,cAAc,EAEd,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAY5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGrD,QAAA,MAAM,aAAa;IACf;;;;;;;;;OASG;;cAE4B,QAAQ,CAAC,cAAc,EAAE,GAAG,kBAAkB,CAAC;;;IAG9E,yEAAyE;;;;;IAEzE,wEAAwE;;;;;IAExE;;;;OAIG;;;;;IAEH;;;;OAIG;;cACqB,QAAQ,CAAC,WAAW,EAAE,CAAC;;;;;;;;cAEhB,QAAQ,CAAC,qBAAqB,CAAC;;;IAC9D;;;OAGG;;cACwB,QAAQ,CAAC,iBAAiB,CAAC;;;IACtD;;;;;OAKG;;cAC6B,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;IAC5D;;;;OAIG;;cACiC,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;;cAClC,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cACpD,QAAQ,CAAC,aAAa,CAAC;;;CAC1D,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,sBAAsB,CAAC,OAAO,aAAa,CAAC,CAAC;AAEzE,eAAO,MAAM,UAAU;IAxDnB;;;;;;;;;OASG;;cAE4B,QAAQ,CAAC,cAAc,EAAE,GAAG,kBAAkB,CAAC;;;IAG9E,yEAAyE;;;;;IAEzE,wEAAwE;;;;;IAExE;;;;OAIG;;;;;IAEH;;;;OAIG;;cACqB,QAAQ,CAAC,WAAW,EAAE,CAAC;;;;;;;;cAEhB,QAAQ,CAAC,qBAAqB,CAAC;;;IAC9D;;;OAGG;;cACwB,QAAQ,CAAC,iBAAiB,CAAC;;;IACtD;;;;;OAKG;;cAC6B,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;IAC5D;;;;OAIG;;cACiC,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;;cAClC,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cACpD,QAAQ,CAAC,aAAa,CAAC;;;;;;IAnDvD;;;;;;;;;OASG;;cAE4B,QAAQ,CAAC,cAAc,EAAE,GAAG,kBAAkB,CAAC;;;IAG9E,yEAAyE;;;;;IAEzE,wEAAwE;;;;;IAExE;;;;OAIG;;;;;IAEH;;;;OAIG;;cACqB,QAAQ,CAAC,WAAW,EAAE,CAAC;;;;;;;;cAEhB,QAAQ,CAAC,qBAAqB,CAAC;;;IAC9D;;;OAGG;;cACwB,QAAQ,CAAC,iBAAiB,CAAC;;;IACtD;;;;;OAKG;;cAC6B,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;IAC5D;;;;OAIG;;cACiC,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;;;;cAClC,QAAQ,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;;;;cACpD,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;;;UAS7C,qBAAqB;yEAqPjC,CAAC"}

package/dist/components/items/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/components/items/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,wBAAwB,CAAC,sBAAsB,CAWpF,CAAC"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/components/items/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,wBAAwB,CAAC,sBAAsB,CAoCpF,CAAC"}

package/dist/components/select-context.d.ts

@@ -0,0 +1,30 @@
+import type { ComputedRef, InjectionKey } from 'vue';
+import type { NavigationItemNormalized } from '../types';
+/**
+ * Channels a `<VCNavItem>`'s already-normalized + scored `children` down
+ * to the nested `<VCNavItems>` that renders its submenu.
+ *
+ * The top-level nav scores the WHOLE tree once; nested lists must render
+ * those results as-is rather than re-resolving / re-scoring a subtree
+ * (which would clobber traces and lose whole-tree active context). The
+ * nested `<VCNavItems>` reads this when it has no own `data` prop —
+ * presence of the injected nodes is what marks it as a nested renderer
+ * rather than a resolving root. Each `<VCNavItem>` re-provides its own
+ * children, so the value is correctly scoped per nesting level.
+ */
+export declare const NAVIGATION_NODES_KEY: InjectionKey<ComputedRef<NavigationItemNormalized[]>>;
+/**
+ * Bridges a clicked `<VCNavItem>` up to the owning root `<VCNavItems>`.
+ *
+ * A url-less item can't navigate, so a click instead "selects" it: the
+ * root nav records the item's trace and folds it into its active-state
+ * derivation, publishing it through the registry's `active` / `activeTrail`.
+ * Dependent navs then react with zero app wiring — exactly as they would
+ * for a route-driven active change.
+ */
+export type NavigationSelectContext = {
+    /** Invoke to mark `item` as the selected (active) item of the root nav. */
+    select: (item: NavigationItemNormalized) => void;
+};
+export declare const NAVIGATION_SELECT_KEY: InjectionKey<NavigationSelectContext>;
+//# sourceMappingURL=select-context.d.ts.map

package/dist/components/select-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-context.d.ts","sourceRoot":"","sources":["../../src/components/select-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,WAAW,CAAC,wBAAwB,EAAE,CAAC,CAAiC,CAAC;AAEzH;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,2EAA2E;IAC3E,MAAM,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,uBAAuB,CAAkC,CAAC"}

package/dist/components/stepper/Stepper.vue.d.ts

@@ -118,11 +118,11 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
 }>> & Readonly<{
     "onUpdate:modelValue"?: (...args: any[]) => any;
 }>, {
+    orientation: "horizontal" | "vertical";
     themeClass: ThemeClassesOverride<StepperThemeClasses>;
     themeVariant: VariantValues;
     modelValue: number;
     defaultValue: number;
-    orientation: "vertical" | "horizontal";
     dir: "ltr" | "rtl";
     linear: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/stepper/StepperDescription.vue.d.ts

@@ -71,9 +71,9 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         default: any;
     };
 }>> & Readonly<{}>, {
+    as: string;
     themeClass: ThemeClassesOverride<StepperThemeClasses>;
     themeVariant: VariantValues;
     asChild: boolean;
-    as: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //# sourceMappingURL=StepperDescription.vue.d.ts.map

package/dist/components/stepper/StepperIndicator.vue.d.ts

@@ -71,9 +71,9 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         default: any;
     };
 }>> & Readonly<{}>, {
+    as: string;
     themeClass: ThemeClassesOverride<StepperThemeClasses>;
     themeVariant: VariantValues;
     asChild: boolean;
-    as: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //# sourceMappingURL=StepperIndicator.vue.d.ts.map

package/dist/components/stepper/StepperSeparator.vue.d.ts

@@ -71,9 +71,9 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         default: any;
     };
 }>> & Readonly<{}>, {
+    as: string;
     themeClass: ThemeClassesOverride<StepperThemeClasses>;
     themeVariant: VariantValues;
     asChild: boolean;
-    as: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //# sourceMappingURL=StepperSeparator.vue.d.ts.map

package/dist/components/stepper/StepperTitle.vue.d.ts

@@ -71,9 +71,9 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         default: any;
     };
 }>> & Readonly<{}>, {
+    as: string;
     themeClass: ThemeClassesOverride<StepperThemeClasses>;
     themeVariant: VariantValues;
     asChild: boolean;
-    as: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //# sourceMappingURL=StepperTitle.vue.d.ts.map

package/dist/components/stepper/StepperTrigger.vue.d.ts

@@ -71,9 +71,9 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         default: any;
     };
 }>> & Readonly<{}>, {
+    as: string;
     themeClass: ThemeClassesOverride<StepperThemeClasses>;
     themeVariant: VariantValues;
     asChild: boolean;
-    as: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //# sourceMappingURL=StepperTrigger.vue.d.ts.map

package/dist/components/type.d.ts

@@ -1,18 +1,25 @@
 import type { NavigationItemNormalized } from '../types';
-export type NavItemSelectFn<META = any> = (value: NavigationItemNormalized<META>) => Promise<void>;
-export type NavItemToggleFn<META = any> = (value: NavigationItemNormalized<META>) => Promise<void>;
+/**
+ * Invoke to select this item: its trace is folded into the owning root
+ * `<VCNavItems>`'s active state and republished through the registry.
+ * The leaf link calls this on click; expose it on custom `#link` slots
+ * to drive url-less section switchers from bespoke markup.
+ */
+export type NavItemSelectFn = () => void;
+/** Invoke to toggle this item's expanded state. */
+export type NavItemToggleFn = () => void;
 export type NavItemSeparatorSlotProps<META = any> = {
     data: NavigationItemNormalized<META>;
 };
 export type NavItemLinkSlotProps<META = any> = {
     data: NavigationItemNormalized<META>;
-    select: NavItemSelectFn<META>;
+    select: NavItemSelectFn;
     isActive?: boolean;
 };
 export type NavItemSubSlotProps<META = any> = {
     data: NavigationItemNormalized<META>;
-    select: NavItemSelectFn<META>;
-    toggle: NavItemToggleFn<META>;
+    select: NavItemSelectFn;
+    toggle: NavItemToggleFn;
 };
 export type NavItemSubTitleSlotProps<META = any> = NavItemSubSlotProps<META>;
 export type NavItemSubItemsSlotProps<META = any> = NavItemSubSlotProps<META>;

package/dist/components/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/components/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,MAAM,eAAe,CAAC,IAAI,GAAG,GAAG,IAAI,CACtC,KAAK,EAAE,wBAAwB,CAAC,IAAI,CAAC,KACpC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,eAAe,CAAC,IAAI,GAAG,GAAG,IAAI,CACtC,KAAK,EAAE,wBAAwB,CAAC,IAAI,CAAC,KACpC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,yBAAyB,CAAC,IAAI,GAAG,GAAG,IAAI;IAChD,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,IAAI,GAAG,GAAG,IAAI;IAC3C,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,IAAI,GAAG,GAAG,IAAI;IAC1C,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,IAAI,GAAG,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAE7E,MAAM,MAAM,wBAAwB,CAAC,IAAI,GAAG,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAE7E,MAAM,MAAM,qBAAqB,CAAC,IAAI,GAAG,GAAG,IAAI;IAC5C,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/components/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC;AAEzC,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC;AAEzC,MAAM,MAAM,yBAAyB,CAAC,IAAI,GAAG,GAAG,IAAI;IAChD,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,IAAI,GAAG,GAAG,IAAI;IAC3C,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,IAAI,GAAG,GAAG,IAAI;IAC1C,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,IAAI,GAAG,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAE7E,MAAM,MAAM,wBAAwB,CAAC,IAAI,GAAG,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAE7E,MAAM,MAAM,qBAAqB,CAAC,IAAI,GAAG,GAAG,IAAI;IAC5C,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC"}

package/dist/helpers/component/types.d.ts

@@ -8,6 +8,12 @@ export type NavigationThemeClasses = {
     linkRoot: string;
     linkIcon: string;
     linkText: string;
+    /** Group title that opens a submenu (Collapsible / NavigationMenu trigger). */
+    trigger: string;
+    /** Submenu panel (CollapsibleContent / NavigationMenuContent). */
+    content: string;
+    /** Edge-aware flyout host for the dropdown submenu (NavigationMenuViewport). */
+    viewport: string;
 };
 declare module '@vuecs/core' {
     interface ThemeElements {