@skdx/vue 0.27.0 → 0.29.0

package/dist/menubar/index.d.cts

@@ -1,17 +1,2 @@
 export { default as SkdxMenubar } from './Menubar.vue.cjs';
-export { default as SkdxMenubarArrow } from './MenubarArrow.vue.cjs';
-export { default as SkdxMenubarCheckboxItem } from './MenubarCheckboxItem.vue.cjs';
-export { default as SkdxMenubarContent } from './MenubarContent.vue.cjs';
-export { default as SkdxMenubarGroup } from './MenubarGroup.vue.cjs';
-export { default as SkdxMenubarItem } from './MenubarItem.vue.cjs';
-export { default as SkdxMenubarItemIndicator } from './MenubarItemIndicator.vue.cjs';
-export { default as SkdxMenubarLabel } from './MenubarLabel.vue.cjs';
-export { default as SkdxMenubarMenu } from './MenubarMenu.vue.cjs';
-export { default as SkdxMenubarPortal } from './MenubarPortal.vue.cjs';
-export { default as SkdxMenubarRadioGroup } from './MenubarRadioGroup.vue.cjs';
-export { default as SkdxMenubarRadioItem } from './MenubarRadioItem.vue.cjs';
-export { default as SkdxMenubarSeparator } from './MenubarSeparator.vue.cjs';
-export { default as SkdxMenubarSub } from './MenubarSub.vue.cjs';
-export { default as SkdxMenubarSubContent } from '../utils/MenuSubContent.vue.cjs';
-export { default as SkdxMenubarSubTrigger } from '../utils/MenuSubTrigger.vue.cjs';
-export { default as SkdxMenubarTrigger } from './MenubarTrigger.vue.cjs';
+export type { MenubarMenuDescriptor, MenuItem as MenubarItem } from './types.cjs';

package/dist/menubar/index.d.ts

@@ -1,17 +1,2 @@
 export { default as SkdxMenubar } from './Menubar.vue.js';
-export { default as SkdxMenubarArrow } from './MenubarArrow.vue.js';
-export { default as SkdxMenubarCheckboxItem } from './MenubarCheckboxItem.vue.js';
-export { default as SkdxMenubarContent } from './MenubarContent.vue.js';
-export { default as SkdxMenubarGroup } from './MenubarGroup.vue.js';
-export { default as SkdxMenubarItem } from './MenubarItem.vue.js';
-export { default as SkdxMenubarItemIndicator } from './MenubarItemIndicator.vue.js';
-export { default as SkdxMenubarLabel } from './MenubarLabel.vue.js';
-export { default as SkdxMenubarMenu } from './MenubarMenu.vue.js';
-export { default as SkdxMenubarPortal } from './MenubarPortal.vue.js';
-export { default as SkdxMenubarRadioGroup } from './MenubarRadioGroup.vue.js';
-export { default as SkdxMenubarRadioItem } from './MenubarRadioItem.vue.js';
-export { default as SkdxMenubarSeparator } from './MenubarSeparator.vue.js';
-export { default as SkdxMenubarSub } from './MenubarSub.vue.js';
-export { default as SkdxMenubarSubContent } from '../utils/MenuSubContent.vue.js';
-export { default as SkdxMenubarSubTrigger } from '../utils/MenuSubTrigger.vue.js';
-export { default as SkdxMenubarTrigger } from './MenubarTrigger.vue.js';
+export type { MenubarMenuDescriptor, MenuItem as MenubarItem } from './types.js';

package/dist/menubar/index.js

@@ -1 +1 @@
-import r from"../utils/MenuSubContent.vue.js";import e from"../utils/MenuSubTrigger.vue.js";import u from"./Menubar.vue.js";import a from"./MenubarArrow.vue.js";import o from"./MenubarCheckboxItem.vue.js";import n from"./MenubarContent.vue.js";import b from"./MenubarGroup.vue.js";import m from"./MenubarItem.vue.js";import t from"./MenubarItemIndicator.vue.js";import s from"./MenubarLabel.vue.js";import M from"./MenubarMenu.vue.js";import i from"./MenubarPortal.vue.js";import S from"./MenubarRadioGroup.vue.js";import p from"./MenubarRadioItem.vue.js";import d from"./MenubarSeparator.vue.js";import x from"./MenubarSub.vue.js";import k from"./MenubarTrigger.vue.js";export{u as SkdxMenubar,a as SkdxMenubarArrow,o as SkdxMenubarCheckboxItem,n as SkdxMenubarContent,b as SkdxMenubarGroup,m as SkdxMenubarItem,t as SkdxMenubarItemIndicator,s as SkdxMenubarLabel,M as SkdxMenubarMenu,i as SkdxMenubarPortal,S as SkdxMenubarRadioGroup,p as SkdxMenubarRadioItem,d as SkdxMenubarSeparator,x as SkdxMenubarSub,r as SkdxMenubarSubContent,e as SkdxMenubarSubTrigger,k as SkdxMenubarTrigger};
+import r from"./Menubar.vue.js";export{r as SkdxMenubar};

package/dist/menubar/primitives.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../utils/MenuSubContent.vue.cjs"),r=require("../utils/MenuSubTrigger.vue.cjs"),u=require("./MenubarContent.vue.cjs"),a=require("./MenubarCheckboxItem.vue.cjs"),n=require("./MenubarGroup.vue.cjs"),t=require("./MenubarItem.vue.cjs"),o=require("./MenubarItemIndicator.vue.cjs"),i=require("./MenubarLabel.vue.cjs"),b=require("./MenubarRadioGroup.vue.cjs"),d=require("./MenubarRadioItem.vue.cjs"),M=require("./MenubarSeparator.vue.cjs"),q=require("./MenubarShortcut.vue.cjs"),S=require("./MenubarSub.vue.cjs"),c=require("./MenubarMenu.vue.cjs"),l=require("./MenubarPortal.vue.cjs"),k=require("./MenubarTrigger.vue.cjs"),x=require("./MenubarRoot.vue.cjs"),f=require("./MenubarArrow.vue.cjs");exports.SkdxMenubarArrow=f.default;exports.SkdxMenubarCheckboxItem=a.default;exports.SkdxMenubarContent=u.default;exports.SkdxMenubarGroup=n.default;exports.SkdxMenubarItem=t.default;exports.SkdxMenubarItemIndicator=o.default;exports.SkdxMenubarLabel=i.default;exports.SkdxMenubarMenu=c.default;exports.SkdxMenubarPortal=l.default;exports.SkdxMenubarRadioGroup=b.default;exports.SkdxMenubarRadioItem=d.default;exports.SkdxMenubarRoot=x.default;exports.SkdxMenubarSeparator=M.default;exports.SkdxMenubarShortcut=q.default;exports.SkdxMenubarSub=S.default;exports.SkdxMenubarSubContent=e.default;exports.SkdxMenubarSubTrigger=r.default;exports.SkdxMenubarTrigger=k.default;

package/dist/menubar/primitives.d.cts

@@ -0,0 +1,42 @@
+/**
+ * Advanced primitives for `SkdxMenubar` — the parts the recipe composes.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxMenubarContent, SkdxMenubarItem, SkdxMenubarMenu, SkdxMenubarPortal, SkdxMenubarRoot, SkdxMenubarShortcut, SkdxMenubarTrigger } from '@skdx/vue/primitives/menubar';
+ * </script>
+ *
+ * <template>
+ *   <SkdxMenubarRoot aria-label="Main">
+ *     <SkdxMenubarMenu value="file">
+ *       <SkdxMenubarTrigger>File</SkdxMenubarTrigger>
+ *       <SkdxMenubarPortal>
+ *         <SkdxMenubarContent>
+ *           <SkdxMenubarItem>Save<SkdxMenubarShortcut>⌘S</SkdxMenubarShortcut></SkdxMenubarItem>
+ *         </SkdxMenubarContent>
+ *       </SkdxMenubarPortal>
+ *     </SkdxMenubarMenu>
+ *   </SkdxMenubarRoot>
+ * </template>
+ * ```
+ */
+export { default as SkdxMenubarRoot } from './MenubarRoot.vue.cjs';
+export { default as SkdxMenubarMenu } from './MenubarMenu.vue.cjs';
+export { default as SkdxMenubarTrigger } from './MenubarTrigger.vue.cjs';
+export { default as SkdxMenubarPortal } from './MenubarPortal.vue.cjs';
+export { default as SkdxMenubarContent } from './MenubarContent.vue.cjs';
+export { default as SkdxMenubarArrow } from './MenubarArrow.vue.cjs';
+export { default as SkdxMenubarItem } from './MenubarItem.vue.cjs';
+export { default as SkdxMenubarCheckboxItem } from './MenubarCheckboxItem.vue.cjs';
+export { default as SkdxMenubarRadioGroup } from './MenubarRadioGroup.vue.cjs';
+export { default as SkdxMenubarRadioItem } from './MenubarRadioItem.vue.cjs';
+export { default as SkdxMenubarItemIndicator } from './MenubarItemIndicator.vue.cjs';
+export { default as SkdxMenubarGroup } from './MenubarGroup.vue.cjs';
+export { default as SkdxMenubarLabel } from './MenubarLabel.vue.cjs';
+export { default as SkdxMenubarSeparator } from './MenubarSeparator.vue.cjs';
+export { default as SkdxMenubarShortcut } from './MenubarShortcut.vue.cjs';
+export { default as SkdxMenubarSub } from './MenubarSub.vue.cjs';
+export { default as SkdxMenubarSubTrigger } from '../utils/MenuSubTrigger.vue.cjs';
+export { default as SkdxMenubarSubContent } from '../utils/MenuSubContent.vue.cjs';
+export type { MenubarMenuDescriptor, MenuItem } from './types.cjs';

package/dist/menubar/primitives.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Advanced primitives for `SkdxMenubar` — the parts the recipe composes.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxMenubarContent, SkdxMenubarItem, SkdxMenubarMenu, SkdxMenubarPortal, SkdxMenubarRoot, SkdxMenubarShortcut, SkdxMenubarTrigger } from '@skdx/vue/primitives/menubar';
+ * </script>
+ *
+ * <template>
+ *   <SkdxMenubarRoot aria-label="Main">
+ *     <SkdxMenubarMenu value="file">
+ *       <SkdxMenubarTrigger>File</SkdxMenubarTrigger>
+ *       <SkdxMenubarPortal>
+ *         <SkdxMenubarContent>
+ *           <SkdxMenubarItem>Save<SkdxMenubarShortcut>⌘S</SkdxMenubarShortcut></SkdxMenubarItem>
+ *         </SkdxMenubarContent>
+ *       </SkdxMenubarPortal>
+ *     </SkdxMenubarMenu>
+ *   </SkdxMenubarRoot>
+ * </template>
+ * ```
+ */
+export { default as SkdxMenubarRoot } from './MenubarRoot.vue.js';
+export { default as SkdxMenubarMenu } from './MenubarMenu.vue.js';
+export { default as SkdxMenubarTrigger } from './MenubarTrigger.vue.js';
+export { default as SkdxMenubarPortal } from './MenubarPortal.vue.js';
+export { default as SkdxMenubarContent } from './MenubarContent.vue.js';
+export { default as SkdxMenubarArrow } from './MenubarArrow.vue.js';
+export { default as SkdxMenubarItem } from './MenubarItem.vue.js';
+export { default as SkdxMenubarCheckboxItem } from './MenubarCheckboxItem.vue.js';
+export { default as SkdxMenubarRadioGroup } from './MenubarRadioGroup.vue.js';
+export { default as SkdxMenubarRadioItem } from './MenubarRadioItem.vue.js';
+export { default as SkdxMenubarItemIndicator } from './MenubarItemIndicator.vue.js';
+export { default as SkdxMenubarGroup } from './MenubarGroup.vue.js';
+export { default as SkdxMenubarLabel } from './MenubarLabel.vue.js';
+export { default as SkdxMenubarSeparator } from './MenubarSeparator.vue.js';
+export { default as SkdxMenubarShortcut } from './MenubarShortcut.vue.js';
+export { default as SkdxMenubarSub } from './MenubarSub.vue.js';
+export { default as SkdxMenubarSubTrigger } from '../utils/MenuSubTrigger.vue.js';
+export { default as SkdxMenubarSubContent } from '../utils/MenuSubContent.vue.js';
+export type { MenubarMenuDescriptor, MenuItem } from './types.js';

package/dist/menubar/primitives.js

@@ -0,0 +1 @@
+import r from"../utils/MenuSubContent.vue.js";import e from"../utils/MenuSubTrigger.vue.js";import u from"./MenubarContent.vue.js";import a from"./MenubarCheckboxItem.vue.js";import o from"./MenubarGroup.vue.js";import t from"./MenubarItem.vue.js";import n from"./MenubarItemIndicator.vue.js";import b from"./MenubarLabel.vue.js";import m from"./MenubarRadioGroup.vue.js";import s from"./MenubarRadioItem.vue.js";import M from"./MenubarSeparator.vue.js";import i from"./MenubarShortcut.vue.js";import S from"./MenubarSub.vue.js";import p from"./MenubarMenu.vue.js";import d from"./MenubarPortal.vue.js";import x from"./MenubarTrigger.vue.js";import k from"./MenubarRoot.vue.js";import f from"./MenubarArrow.vue.js";export{f as SkdxMenubarArrow,a as SkdxMenubarCheckboxItem,u as SkdxMenubarContent,o as SkdxMenubarGroup,t as SkdxMenubarItem,n as SkdxMenubarItemIndicator,b as SkdxMenubarLabel,p as SkdxMenubarMenu,d as SkdxMenubarPortal,m as SkdxMenubarRadioGroup,s as SkdxMenubarRadioItem,k as SkdxMenubarRoot,M as SkdxMenubarSeparator,i as SkdxMenubarShortcut,S as SkdxMenubarSub,r as SkdxMenubarSubContent,e as SkdxMenubarSubTrigger,x as SkdxMenubarTrigger};

package/dist/menubar/types.d.cts

@@ -0,0 +1,132 @@
+/** Menubar menu item; action items have no `type`, narrowed via `'type' in item`. */
+export type MenuItem = {
+    /** Text rendered inside the derived `SkdxMenubarItem`. */
+    label: string;
+    /**
+     * Activated when item is selected.
+     * @default undefined
+     */
+    onSelect?: () => void;
+    /**
+     * Keyboard hint rendered as SkdxMenubarShortcut.
+     * @default undefined
+     */
+    shortcut?: string;
+    /**
+     * Whether item is disabled; aria-disabled, stays focusable.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Text for typeahead; reflected to data-text-value.
+     * @default undefined
+     */
+    textValue?: string;
+} | {
+    /** Discriminant: renders a `SkdxMenubarSeparator`. */
+    type: 'separator';
+} | {
+    /** Discriminant: renders a `SkdxMenubarCheckboxItem`. */
+    type: 'checkbox';
+    /** Text rendered inside the derived `SkdxMenubarCheckboxItem`. */
+    label: string;
+    /**
+     * The checked state, always externally controlled — the item reports the state it wants and never flips itself.
+     * @default false
+     */
+    checked?: boolean;
+    /**
+     * Called with new checked state when toggled.
+     * @default undefined
+     */
+    onCheckedChange?: (checked: boolean) => void;
+    /**
+     * Keyboard hint rendered as SkdxMenubarShortcut.
+     * @default undefined
+     */
+    shortcut?: string;
+    /**
+     * Whether item is disabled; aria-disabled, stays focusable.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Text for typeahead; reflected to data-text-value.
+     * @default undefined
+     */
+    textValue?: string;
+} | {
+    /** Discriminant: renders a `SkdxMenubarRadioGroup` of `SkdxMenubarRadioItem`s. */
+    type: 'radio-group';
+    /**
+     * Selected option value; externally controlled.
+     * @default undefined
+     */
+    value?: string;
+    /**
+     * Called with newly selected option's value.
+     * @default undefined
+     */
+    onValueChange?: (value: string) => void;
+    /** Mutually-exclusive options. */
+    items: {
+        /** Text rendered inside SkdxMenubarRadioItem. */
+        label: string;
+        /** Option identifier, compared against group value. */
+        value: string;
+        /**
+         * Whether option is disabled; aria-disabled.
+         * @default false
+         */
+        disabled?: boolean;
+        /**
+         * Text for typeahead.
+         * @default undefined
+         */
+        textValue?: string;
+    }[];
+} | {
+    /** Discriminant: renders a `SkdxMenubarSub` with its own trigger and panel. */
+    type: 'submenu';
+    /** Text rendered inside the derived sub-trigger. */
+    label: string;
+    /** The submenu's own entries, recursing through the same union. */
+    items: MenuItem[];
+    /**
+     * Whether sub-trigger is disabled; aria-disabled, doesn't open submenu.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Text for typeahead.
+     * @default undefined
+     */
+    textValue?: string;
+} | {
+    /** Discriminant: renders a SkdxMenubarGroup. */
+    type: 'group';
+    /**
+     * Group heading / label.
+     * @default undefined
+     */
+    label?: string;
+    /** The group's entries, recursing through the same union. */
+    items: MenuItem[];
+};
+/** Menu in Menubar: trigger in bar and its panel contents. */
+export interface MenubarMenuDescriptor {
+    /** Trigger text. */
+    label: string;
+    /** Panel entries. */
+    items: MenuItem[];
+    /**
+     * Menu identifier for v-model:menu binding.
+     * @default undefined
+     */
+    value?: string;
+    /**
+     * Whether trigger is disabled; excluded from roving-focus.
+     * @default false
+     */
+    disabled?: boolean;
+}

package/dist/menubar/types.d.ts

@@ -0,0 +1,132 @@
+/** Menubar menu item; action items have no `type`, narrowed via `'type' in item`. */
+export type MenuItem = {
+    /** Text rendered inside the derived `SkdxMenubarItem`. */
+    label: string;
+    /**
+     * Activated when item is selected.
+     * @default undefined
+     */
+    onSelect?: () => void;
+    /**
+     * Keyboard hint rendered as SkdxMenubarShortcut.
+     * @default undefined
+     */
+    shortcut?: string;
+    /**
+     * Whether item is disabled; aria-disabled, stays focusable.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Text for typeahead; reflected to data-text-value.
+     * @default undefined
+     */
+    textValue?: string;
+} | {
+    /** Discriminant: renders a `SkdxMenubarSeparator`. */
+    type: 'separator';
+} | {
+    /** Discriminant: renders a `SkdxMenubarCheckboxItem`. */
+    type: 'checkbox';
+    /** Text rendered inside the derived `SkdxMenubarCheckboxItem`. */
+    label: string;
+    /**
+     * The checked state, always externally controlled — the item reports the state it wants and never flips itself.
+     * @default false
+     */
+    checked?: boolean;
+    /**
+     * Called with new checked state when toggled.
+     * @default undefined
+     */
+    onCheckedChange?: (checked: boolean) => void;
+    /**
+     * Keyboard hint rendered as SkdxMenubarShortcut.
+     * @default undefined
+     */
+    shortcut?: string;
+    /**
+     * Whether item is disabled; aria-disabled, stays focusable.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Text for typeahead; reflected to data-text-value.
+     * @default undefined
+     */
+    textValue?: string;
+} | {
+    /** Discriminant: renders a `SkdxMenubarRadioGroup` of `SkdxMenubarRadioItem`s. */
+    type: 'radio-group';
+    /**
+     * Selected option value; externally controlled.
+     * @default undefined
+     */
+    value?: string;
+    /**
+     * Called with newly selected option's value.
+     * @default undefined
+     */
+    onValueChange?: (value: string) => void;
+    /** Mutually-exclusive options. */
+    items: {
+        /** Text rendered inside SkdxMenubarRadioItem. */
+        label: string;
+        /** Option identifier, compared against group value. */
+        value: string;
+        /**
+         * Whether option is disabled; aria-disabled.
+         * @default false
+         */
+        disabled?: boolean;
+        /**
+         * Text for typeahead.
+         * @default undefined
+         */
+        textValue?: string;
+    }[];
+} | {
+    /** Discriminant: renders a `SkdxMenubarSub` with its own trigger and panel. */
+    type: 'submenu';
+    /** Text rendered inside the derived sub-trigger. */
+    label: string;
+    /** The submenu's own entries, recursing through the same union. */
+    items: MenuItem[];
+    /**
+     * Whether sub-trigger is disabled; aria-disabled, doesn't open submenu.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Text for typeahead.
+     * @default undefined
+     */
+    textValue?: string;
+} | {
+    /** Discriminant: renders a SkdxMenubarGroup. */
+    type: 'group';
+    /**
+     * Group heading / label.
+     * @default undefined
+     */
+    label?: string;
+    /** The group's entries, recursing through the same union. */
+    items: MenuItem[];
+};
+/** Menu in Menubar: trigger in bar and its panel contents. */
+export interface MenubarMenuDescriptor {
+    /** Trigger text. */
+    label: string;
+    /** Panel entries. */
+    items: MenuItem[];
+    /**
+     * Menu identifier for v-model:menu binding.
+     * @default undefined
+     */
+    value?: string;
+    /**
+     * Whether trigger is disabled; excluded from roving-focus.
+     * @default false
+     */
+    disabled?: boolean;
+}

package/dist/navigation-menu/NavigationMenu.vue.d.cts

@@ -1,48 +1,54 @@
-/**
- * The Vue implementation of the shared NavigationMenu contract (see
- * `@skdx/shared`'s `navigationMenuContract`). Owns which item's content is
- * open and `provide()`s hover-intent timers to `SkdxNavigationMenuItem` /
- * `SkdxNavigationMenuTrigger` / `SkdxNavigationMenuContent`. Renders `<nav>`
- * labelled "Main" by default (overridable via attribute fallthrough).
- *
- * Opening a trigger is delayed by `delayDuration` on first hover, but once
- * one item is open, moving to a sibling trigger within `skipDelayDuration`
- * of closing switches instantly. Works controlled (`v-model:value`) or
- * uncontrolled (`default-value`).
- */
+import type { NavigationMenuItem } from './types.cjs';
+/** Renders the navigation menu holder that manages which item's content is open, deriving anatomy from `items` or a slot. */
 type __VLS_Props = {
-    /** Value of the currently open item, for controlled usage via `v-model:value`. */
-    value?: string;
-    /** Initially open item's value, for uncontrolled usage. */
-    defaultValue?: string;
+    /**
+     * Currently open item's value; `v-model:value` for controlled usage.
+     * @default undefined
+     */
+    value?: string | null | undefined;
+    /** Initially open item's value, for uncontrolled usage; `null` starts closed. */
+    defaultValue?: string | null;
     /** Delay before hovering a trigger opens its content (ms). */
     delayDuration?: number;
     /** Window after closing during which re-hovering a sibling trigger opens instantly (ms). */
     skipDelayDuration?: number;
+    /** Pointer grace period (ms) before panel closes (travel gap). */
+    closeDelayDuration?: number;
     /**
-     * Axis the menu runs along. Sets `data-orientation` on the root and the
-     * list, switches roving focus between Left/Right and Up/Down, and is what
-     * the skin keys its vertical layout off. Use `'vertical'` for sidebars,
-     * footer link columns and mobile drawers.
+     * Whether activating a link closes the open panel; `false` keeps it open during navigation.
+     * @default true
      */
+    closeOnSelect?: boolean;
+    /** Menu axis, setting `data-orientation` and the roving focus arrows. */
     orientation?: 'horizontal' | 'vertical';
+    /**
+     * Menu entries (links or trigger/panel pairs).
+     * @default []
+     */
+    items?: NavigationMenuItem[];
 };
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+type __VLS_Slots = {
+    /** Manual composition of the list, triggers and panels, replacing the derived `items` anatomy. */
+    default?(): unknown;
+    /** Body of a derived link or panel, for markup an `items` entry cannot express. */
+    item?(props: {
+        item: NavigationMenuItem;
+    }): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:value": (value: string) => any;
-    "value-change": (value: string) => any;
+    "update:value": (value: string | null) => any;
+    "value-change": (value: string | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:value"?: ((value: string) => any) | undefined;
-    "onValue-change"?: ((value: string) => any) | undefined;
+    "onUpdate:value"?: (value: string | null) => any;
+    "onValue-change"?: (value: string | null) => any;
 }>, {
-    value: string;
-    defaultValue: string;
+    defaultValue: string | null;
     orientation: "horizontal" | "vertical";
+    items: NavigationMenuItem[];
+    closeOnSelect: boolean;
     delayDuration: number;
     skipDelayDuration: number;
+    closeDelayDuration: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/navigation-menu/NavigationMenu.vue.d.ts

@@ -1,48 +1,54 @@
-/**
- * The Vue implementation of the shared NavigationMenu contract (see
- * `@skdx/shared`'s `navigationMenuContract`). Owns which item's content is
- * open and `provide()`s hover-intent timers to `SkdxNavigationMenuItem` /
- * `SkdxNavigationMenuTrigger` / `SkdxNavigationMenuContent`. Renders `<nav>`
- * labelled "Main" by default (overridable via attribute fallthrough).
- *
- * Opening a trigger is delayed by `delayDuration` on first hover, but once
- * one item is open, moving to a sibling trigger within `skipDelayDuration`
- * of closing switches instantly. Works controlled (`v-model:value`) or
- * uncontrolled (`default-value`).
- */
+import type { NavigationMenuItem } from './types.js';
+/** Renders the navigation menu holder that manages which item's content is open, deriving anatomy from `items` or a slot. */
 type __VLS_Props = {
-    /** Value of the currently open item, for controlled usage via `v-model:value`. */
-    value?: string;
-    /** Initially open item's value, for uncontrolled usage. */
-    defaultValue?: string;
+    /**
+     * Currently open item's value; `v-model:value` for controlled usage.
+     * @default undefined
+     */
+    value?: string | null | undefined;
+    /** Initially open item's value, for uncontrolled usage; `null` starts closed. */
+    defaultValue?: string | null;
     /** Delay before hovering a trigger opens its content (ms). */
     delayDuration?: number;
     /** Window after closing during which re-hovering a sibling trigger opens instantly (ms). */
     skipDelayDuration?: number;
+    /** Pointer grace period (ms) before panel closes (travel gap). */
+    closeDelayDuration?: number;
     /**
-     * Axis the menu runs along. Sets `data-orientation` on the root and the
-     * list, switches roving focus between Left/Right and Up/Down, and is what
-     * the skin keys its vertical layout off. Use `'vertical'` for sidebars,
-     * footer link columns and mobile drawers.
+     * Whether activating a link closes the open panel; `false` keeps it open during navigation.
+     * @default true
      */
+    closeOnSelect?: boolean;
+    /** Menu axis, setting `data-orientation` and the roving focus arrows. */
     orientation?: 'horizontal' | 'vertical';
+    /**
+     * Menu entries (links or trigger/panel pairs).
+     * @default []
+     */
+    items?: NavigationMenuItem[];
 };
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+type __VLS_Slots = {
+    /** Manual composition of the list, triggers and panels, replacing the derived `items` anatomy. */
+    default?(): unknown;
+    /** Body of a derived link or panel, for markup an `items` entry cannot express. */
+    item?(props: {
+        item: NavigationMenuItem;
+    }): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:value": (value: string) => any;
-    "value-change": (value: string) => any;
+    "update:value": (value: string | null) => any;
+    "value-change": (value: string | null) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:value"?: ((value: string) => any) | undefined;
-    "onValue-change"?: ((value: string) => any) | undefined;
+    "onUpdate:value"?: (value: string | null) => any;
+    "onValue-change"?: (value: string | null) => any;
 }>, {
-    value: string;
-    defaultValue: string;
+    defaultValue: string | null;
     orientation: "horizontal" | "vertical";
+    items: NavigationMenuItem[];
+    closeOnSelect: boolean;
     delayDuration: number;
     skipDelayDuration: number;
+    closeDelayDuration: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/navigation-menu/NavigationMenu.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const _=require("./context.cjs");let t=require("vue");var g=["data-orientation"],D=150,C=(0,t.defineComponent)({__name:"NavigationMenu",props:{value:{default:void 0},defaultValue:{default:""},delayDuration:{default:200},skipDelayDuration:{default:300},orientation:{default:"horizontal"}},emits:["update:value","value-change"],setup(r,{emit:w}){const n=r,d=w,c=(0,t.ref)(n.defaultValue),m=(0,t.computed)(()=>n.value??c.value);let u=!0,a=0,o=0,l=0;function i(e){n.value===void 0&&(c.value=e),window.clearTimeout(l),e?u=!1:l=window.setTimeout(()=>{u=!0},n.skipDelayDuration),d("update:value",e),d("value-change",e)}(0,t.onBeforeUnmount)(()=>{window.clearTimeout(a),window.clearTimeout(o),window.clearTimeout(l)});function v(e){window.clearTimeout(o),window.clearTimeout(a),u?a=window.setTimeout(()=>i(e),n.delayDuration):i(e)}function s(){window.clearTimeout(a),window.clearTimeout(o),o=window.setTimeout(()=>i(""),D)}function T(){window.clearTimeout(o)}function f(e){window.clearTimeout(a),window.clearTimeout(o),i(e)}function p(){window.clearTimeout(a),window.clearTimeout(o),i("")}return(0,t.provide)(_.NAVIGATION_MENU_CONTEXT,{value:m,orientation:(0,t.computed)(()=>n.orientation),onTriggerEnter:v,onTriggerLeave:s,onContentEnter:T,onContentLeave:s,onItemSelect:f,onClose:p}),(e,k)=>((0,t.openBlock)(),(0,t.createElementBlock)("nav",{class:"skdx-navigation-menu","data-part":"root","data-skdx-component":"navigation-menu","aria-label":"Main","data-orientation":r.orientation},[(0,t.renderSlot)(e.$slots,"default")],8,g))}});exports.default=C;
+const S=require("./context.cjs"),B=require("./NavigationMenuAnatomy.vue.cjs");let t=require("vue");var N=["data-orientation"],q=150,z=(0,t.defineComponent)({__name:"NavigationMenu",props:{value:{},defaultValue:{default:null},delayDuration:{default:200},skipDelayDuration:{default:300},closeDelayDuration:{default:q},closeOnSelect:{type:Boolean,default:!0},orientation:{default:"horizontal"},items:{default:()=>[]}},emits:["update:value","value-change"],setup(m,{emit:y}){const o=m,f=y,v=(0,t.ref)(o.defaultValue),u=(0,t.computed)(()=>o.value===void 0?v.value:o.value);let s=!0,i=0,n=0,c=0;function a(e){e!==u.value&&(o.value===void 0&&(v.value=e),window.clearTimeout(c),e!==null?s=!1:c=window.setTimeout(()=>{s=!0},o.skipDelayDuration),f("update:value",e),f("value-change",e))}(0,t.onBeforeUnmount)(()=>{window.clearTimeout(i),window.clearTimeout(n),window.clearTimeout(c)});function _(e){window.clearTimeout(n),window.clearTimeout(i),s?i=window.setTimeout(()=>a(e),o.delayDuration):a(e)}function w(){window.clearTimeout(i),window.clearTimeout(n),n=window.setTimeout(()=>a(null),o.closeDelayDuration)}function k(){window.clearTimeout(n)}function D(e){window.clearTimeout(i),window.clearTimeout(n),a(e)}function p(){window.clearTimeout(i),window.clearTimeout(n),a(null)}function h(){o.closeOnSelect&&p()}const g=(0,t.useTemplateRef)("rootEl");return(0,t.watchPostEffect)(()=>{const e=g.value;if(!e||u.value===null)return;const d=e.querySelector('[data-skdx-nav-trigger][data-state="open"]');if(!d)return;const l=e.getBoundingClientRect(),r=d.getBoundingClientRect(),T=o.orientation==="horizontal",C=T?r.left-l.left:r.top-l.top,E=T?r.width:r.height;e.style.setProperty("--skdx-navigation-menu-indicator-offset",`${C}px`),e.style.setProperty("--skdx-navigation-menu-indicator-size",`${E}px`)}),(0,t.provide)(S.NAVIGATION_MENU_CONTEXT,{value:u,orientation:(0,t.computed)(()=>o.orientation),onTriggerEnter:_,onTriggerLeave:w,onContentEnter:k,onContentLeave:w,onItemSelect:D,onClose:p,onLinkSelect:h}),(e,d)=>((0,t.openBlock)(),(0,t.createElementBlock)("nav",{ref_key:"rootEl",ref:g,class:"skdx-navigation-menu","data-part":"root","data-skdx-component":"navigation-menu","data-orientation":m.orientation},[(0,t.renderSlot)(e.$slots,"default",{},()=>[(0,t.createVNode)(B.default,{items:o.items},(0,t.createSlots)({_:2},[e.$slots.item?{name:"item",fn:(0,t.withCtx)(l=>[(0,t.renderSlot)(e.$slots,"item",(0,t.normalizeProps)((0,t.guardReactiveProps)(l)))]),key:"0"}:void 0]),1032,["items"])])],8,N))}});exports.default=z;

package/dist/navigation-menu/NavigationMenu.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{NAVIGATION_MENU_CONTEXT as e}from"./context.js";import{computed as o,createElementBlock as a,defineComponent as t,onBeforeUnmount as n,openBlock as i,provide as u,ref as l,renderSlot as r}from"vue";var d=["data-orientation"],w=/* @__PURE__ */t({__name:"NavigationMenu",props:{value:{default:void 0},defaultValue:{default:""},delayDuration:{default:200},skipDelayDuration:{default:300},orientation:{default:"horizontal"}},emits:["update:value","value-change"],setup(t,{emit:w}){const m=t,c=w,s=l(m.defaultValue),v=o(()=>m.value??s.value);let T=!0,f=0,p=0,g=0;function k(e){void 0===m.value&&(s.value=e),window.clearTimeout(g),e?T=!1:g=window.setTimeout(()=>{T=!0},m.skipDelayDuration),c("update:value",e),c("value-change",e)}function D(){window.clearTimeout(f),window.clearTimeout(p),p=window.setTimeout(()=>k(""),150)}return n(()=>{window.clearTimeout(f),window.clearTimeout(p),window.clearTimeout(g)}),u(e,{value:v,orientation:o(()=>m.orientation),onTriggerEnter:function(e){window.clearTimeout(p),window.clearTimeout(f),T?f=window.setTimeout(()=>k(e),m.delayDuration):k(e)},onTriggerLeave:D,onContentEnter:function(){window.clearTimeout(p)},onContentLeave:D,onItemSelect:function(e){window.clearTimeout(f),window.clearTimeout(p),k(e)},onClose:function(){window.clearTimeout(f),window.clearTimeout(p),k("")}}),(e,o)=>(i(),a("nav",{class:"skdx-navigation-menu","data-part":"root","data-skdx-component":"navigation-menu","aria-label":"Main","data-orientation":t.orientation},[r(e.$slots,"default")],8,d))}});export{w as default};
+import{NAVIGATION_MENU_CONTEXT as e}from"./context.js";import t from"./NavigationMenuAnatomy.vue.js";import{computed as o,createElementBlock as a,createSlots as n,createVNode as i,defineComponent as l,guardReactiveProps as u,normalizeProps as r,onBeforeUnmount as s,openBlock as d,provide as c,ref as m,renderSlot as f,useTemplateRef as w,watchPostEffect as v,withCtx as p}from"vue";var T=["data-orientation"],g=/* @__PURE__ */l({__name:"NavigationMenu",props:{value:{},defaultValue:{default:null},delayDuration:{default:200},skipDelayDuration:{default:300},closeDelayDuration:{default:150},closeOnSelect:{type:Boolean,default:!0},orientation:{default:"horizontal"},items:{default:()=>[]}},emits:["update:value","value-change"],setup(l,{emit:g}){const y=l,k=g,x=m(y.defaultValue),D=o(()=>void 0===y.value?x.value:y.value);let h=!0,C=0,E=0,N=0;function S(e){e!==D.value&&(void 0===y.value&&(x.value=e),window.clearTimeout(N),null!==e?h=!1:N=window.setTimeout(()=>{h=!0},y.skipDelayDuration),k("update:value",e),k("value-change",e))}function B(){window.clearTimeout(C),window.clearTimeout(E),E=window.setTimeout(()=>S(null),y.closeDelayDuration)}function _(){window.clearTimeout(C),window.clearTimeout(E),S(null)}s(()=>{window.clearTimeout(C),window.clearTimeout(E),window.clearTimeout(N)});const P=w("rootEl");return v(()=>{const e=P.value;if(!e||null===D.value)return;const t=e.querySelector('[data-skdx-nav-trigger][data-state="open"]');if(!t)return;const o=e.getBoundingClientRect(),a=t.getBoundingClientRect(),n="horizontal"===y.orientation,i=n?a.left-o.left:a.top-o.top,l=n?a.width:a.height;e.style.setProperty("--skdx-navigation-menu-indicator-offset",`${i}px`),e.style.setProperty("--skdx-navigation-menu-indicator-size",`${l}px`)}),c(e,{value:D,orientation:o(()=>y.orientation),onTriggerEnter:function(e){window.clearTimeout(E),window.clearTimeout(C),h?C=window.setTimeout(()=>S(e),y.delayDuration):S(e)},onTriggerLeave:B,onContentEnter:function(){window.clearTimeout(E)},onContentLeave:B,onItemSelect:function(e){window.clearTimeout(C),window.clearTimeout(E),S(e)},onClose:_,onLinkSelect:function(){y.closeOnSelect&&_()}}),(e,o)=>(d(),a("nav",{ref_key:"rootEl",ref:P,class:"skdx-navigation-menu","data-part":"root","data-skdx-component":"navigation-menu","data-orientation":l.orientation},[f(e.$slots,"default",{},()=>[i(t,{items:y.items},n({_:2},[e.$slots.item?{name:"item",fn:p(t=>[f(e.$slots,"item",r(u(t)))]),key:"0"}:void 0]),1032,["items"])])],8,T))}});export{g as default};

package/dist/navigation-menu/NavigationMenuAnatomy.vue.cjs

@@ -0,0 +1 @@
+const e=require("./NavigationMenuAnatomy.vue_vue_type_script_setup_true_lang.cjs");var t=e.default;exports.default=t;

package/dist/navigation-menu/NavigationMenuAnatomy.vue.d.cts

@@ -0,0 +1,18 @@
+import type { NavigationMenuItem } from './types.cjs';
+/** @internal Renders the recipe's default anatomy: a list of entries, either links or trigger/panel pairs. */
+type __VLS_Props = {
+    items: NavigationMenuItem[];
+};
+type __VLS_Slots = {
+    item?(props: {
+        item: NavigationMenuItem;
+    }): unknown;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};