@skdx/vue 0.26.0 → 0.28.0

package/dist/context-menu/ContextMenuAnatomy.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{CONTEXT_MENU_CONTEXT as e}from"./context.js";import t from"./ContextMenuContent.vue.js";import o from"./ContextMenuItems.vue.js";import s from"./ContextMenuPortal.vue.js";import n from"./ContextMenuTrigger.vue.js";import{Fragment as a,computed as r,createElementBlock as i,createSlots as m,createVNode as l,defineComponent as u,guardReactiveProps as d,inject as p,mergeProps as c,normalizeProps as f,openBlock as C,renderSlot as x,useAttrs as v,withCtx as M}from"vue";var _=/* @__PURE__ */u({inheritAttrs:!1,__name:"ContextMenuAnatomy",props:{items:{},disabled:{type:Boolean},onItemSelect:{type:Function}},setup(u){const _=p(e);if(!_)throw new Error("ContextMenuAnatomy must be used within SkdxContextMenu.");const j=v(),b=r(()=>j.id&&_.open.value?{"aria-controls":j.id,"aria-owns":j.id}:{});return(e,r)=>(C(),i(a,null,[l(n,c({disabled:u.disabled},b.value),{default:M(()=>[x(e.$slots,"default")]),_:3},16,["disabled"]),l(s,null,{default:M(()=>[l(t,f(d(e.$attrs)),{default:M(()=>[l(o,{items:u.items,"on-item-select":u.onItemSelect},m({_:2},[e.$slots.item?{name:"item",fn:M(t=>[x(e.$slots,"item",f(d(t)))]),key:"0"}:void 0]),1032,["items","on-item-select"])]),_:3},16)]),_:3})],64))}});export{_ as default};

package/dist/context-menu/ContextMenuCheckboxItem.vue.d.cts

@@ -1,12 +1,9 @@
 /**
  * A toggleable menu item: `role="menuitemcheckbox"` with `aria-checked` and
- * `data-state` (`checked`/`unchecked`) reflecting `checked`. Selecting it
- * (click or Enter/Space) toggles `checked` — bound with `v-model:checked`
- * (or `@checked-change`), or left unbound so the item tracks its own state
- * from `defaultChecked` — and, unlike `SkdxContextMenuItem`, always keeps the
- * menu open (calls `event.preventDefault()` internally). Wrap a
- * `SkdxContextMenuItemIndicator` inside it to render a check glyph only when
- * checked.
+ * `data-state` reflecting checked state. Selecting it reports state through
+ * `v-model:checked` / `@checked-change`; state is always externally controlled.
+ * Menu stays open on selection. Use `SkdxContextMenuItemIndicator` inside for
+ * a check glyph that renders only while checked.
  */
 type __VLS_Props = {
     /**
@@ -14,10 +11,14 @@ type __VLS_Props = {
      * usage. Pair with `v-model:checked` or `@checked-change`.
      */
     checked?: boolean;
-    /** Initial checked state, for uncontrolled usage. */
-    defaultChecked?: boolean;
-    /** Excludes the item from roving-focus navigation and blocks selection. */
+    /** Marks item aria-disabled and blocks selection, but stays focusable so keyboard users discover it. */
     disabled?: boolean;
+    /**
+     * Text for typeahead matching, instead of rendered text. Reflected to
+     * `data-text-value`. Needed when the item renders more than just text.
+     * @default undefined — typeahead matches the item's rendered text instead.
+     */
+    textValue?: string;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -34,7 +35,6 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
 }>, {
     disabled: boolean;
     checked: boolean;
-    defaultChecked: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/context-menu/ContextMenuCheckboxItem.vue.d.ts

@@ -1,12 +1,9 @@
 /**
  * A toggleable menu item: `role="menuitemcheckbox"` with `aria-checked` and
- * `data-state` (`checked`/`unchecked`) reflecting `checked`. Selecting it
- * (click or Enter/Space) toggles `checked` — bound with `v-model:checked`
- * (or `@checked-change`), or left unbound so the item tracks its own state
- * from `defaultChecked` — and, unlike `SkdxContextMenuItem`, always keeps the
- * menu open (calls `event.preventDefault()` internally). Wrap a
- * `SkdxContextMenuItemIndicator` inside it to render a check glyph only when
- * checked.
+ * `data-state` reflecting checked state. Selecting it reports state through
+ * `v-model:checked` / `@checked-change`; state is always externally controlled.
+ * Menu stays open on selection. Use `SkdxContextMenuItemIndicator` inside for
+ * a check glyph that renders only while checked.
  */
 type __VLS_Props = {
     /**
@@ -14,10 +11,14 @@ type __VLS_Props = {
      * usage. Pair with `v-model:checked` or `@checked-change`.
      */
     checked?: boolean;
-    /** Initial checked state, for uncontrolled usage. */
-    defaultChecked?: boolean;
-    /** Excludes the item from roving-focus navigation and blocks selection. */
+    /** Marks item aria-disabled and blocks selection, but stays focusable so keyboard users discover it. */
     disabled?: boolean;
+    /**
+     * Text for typeahead matching, instead of rendered text. Reflected to
+     * `data-text-value`. Needed when the item renders more than just text.
+     * @default undefined — typeahead matches the item's rendered text instead.
+     */
+    textValue?: string;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -34,7 +35,6 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
 }>, {
     disabled: boolean;
     checked: boolean;
-    defaultChecked: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/context-menu/ContextMenuCheckboxItem.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const v=require("../utils/useMenuItem.cjs"),m=require("./context.cjs");let e=require("vue");var x=["aria-checked","data-state"],_=(0,e.defineComponent)({__name:"ContextMenuCheckboxItem",props:{checked:{type:Boolean,default:void 0},defaultChecked:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1}},emits:["select","update:checked","checked-change"],setup(p,{emit:h}){const o=p,c=h,d=(0,e.inject)(m.CONTEXT_MENU_CONTEXT);if(!d)throw new Error("SkdxContextMenuCheckboxItem must be used within SkdxContextMenu.");const l=(0,e.ref)(o.defaultChecked),a=(0,e.computed)(()=>o.checked!==void 0),u=(0,e.computed)(()=>a.value?o.checked:l.value),{itemAttrs:C,onItemClick:s,onItemKeydown:i,onItemPointerenter:f,onItemPointerleave:k}=v.useMenuItem({disabled:(0,e.toRef)(o,"disabled"),onSelect:r=>{const t=!u.value;a.value||(l.value=t),c("update:checked",t),c("checked-change",t),c("select",r),r.preventDefault()},onSelected:()=>d.setOpen(!1),contentRef:d.contentRef});return(0,e.provide)(m.CONTEXT_MENU_ITEM_INDICATOR_CONTEXT,u),(r,t)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",(0,e.mergeProps)({class:"skdx-context-menu__checkbox-item","data-part":"checkbox-item",role:"menuitemcheckbox","aria-checked":u.value,"data-state":u.value?"checked":"unchecked"},(0,e.unref)(C),{onClick:t[0]||(t[0]=(...n)=>(0,e.unref)(s)&&(0,e.unref)(s)(...n)),onKeydown:t[1]||(t[1]=(...n)=>(0,e.unref)(i)&&(0,e.unref)(i)(...n)),onPointerenter:t[2]||(t[2]=(...n)=>(0,e.unref)(f)&&(0,e.unref)(f)(...n)),onPointerleave:t[3]||(t[3]=(...n)=>(0,e.unref)(k)&&(0,e.unref)(k)(...n))}),[(0,e.renderSlot)(r.$slots,"default")],16,x))}});exports.default=_;
+const x=require("../utils/useMenuItem.cjs"),f=require("./context.cjs");let e=require("vue");var h=["aria-checked","data-state"],C=(0,e.defineComponent)({__name:"ContextMenuCheckboxItem",props:{checked:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1},textValue:{}},emits:["select","update:checked","checked-change"],setup(k,{emit:m}){const u=k,c=m,d=(0,e.inject)(f.CONTEXT_MENU_CONTEXT);if(!d)throw new Error("SkdxContextMenuCheckboxItem must be used within SkdxContextMenu.");const o=(0,e.computed)(()=>u.checked),{itemAttrs:p,onItemClick:a,onItemKeydown:l,onItemPointerenter:s,onItemPointerleave:i}=x.useMenuItem({disabled:(0,e.toRef)(u,"disabled"),textValue:(0,e.toRef)(u,"textValue"),onSelect:r=>{const t=!o.value;c("update:checked",t),c("checked-change",t),c("select",r),r.preventDefault()},onSelected:()=>d.setOpen(!1),contentRef:d.contentRef});return(0,e.provide)(f.CONTEXT_MENU_ITEM_INDICATOR_CONTEXT,o),(r,t)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",(0,e.mergeProps)({class:"skdx-context-menu__checkbox-item","data-part":"checkbox-item",role:"menuitemcheckbox","aria-checked":o.value,"data-state":o.value?"checked":"unchecked"},(0,e.unref)(p),{onClick:t[0]||(t[0]=(...n)=>(0,e.unref)(a)&&(0,e.unref)(a)(...n)),onKeydown:t[1]||(t[1]=(...n)=>(0,e.unref)(l)&&(0,e.unref)(l)(...n)),onPointerenter:t[2]||(t[2]=(...n)=>(0,e.unref)(s)&&(0,e.unref)(s)(...n)),onPointerleave:t[3]||(t[3]=(...n)=>(0,e.unref)(i)&&(0,e.unref)(i)(...n))}),[(0,e.renderSlot)(r.$slots,"default")],16,h))}});exports.default=C;

package/dist/context-menu/ContextMenuCheckboxItem.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{useMenuItem as e}from"../utils/useMenuItem.js";import{CONTEXT_MENU_CONTEXT as t,CONTEXT_MENU_ITEM_INDICATOR_CONTEXT as o}from"./context.js";import{computed as a,createElementBlock as n,defineComponent as c,inject as d,mergeProps as s,openBlock as l,provide as r,ref as u,renderSlot as i,toRef as m,unref as k}from"vue";var h=["aria-checked","data-state"],p=/* @__PURE__ */c({__name:"ContextMenuCheckboxItem",props:{checked:{type:Boolean,default:void 0},defaultChecked:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1}},emits:["select","update:checked","checked-change"],setup(c,{emit:p}){const f=c,v=p,C=d(t);if(!C)throw new Error("SkdxContextMenuCheckboxItem must be used within SkdxContextMenu.");const x=u(f.defaultChecked),I=a(()=>void 0!==f.checked),T=a(()=>I.value?f.checked:x.value),{itemAttrs:_,onItemClick:b,onItemKeydown:E,onItemPointerenter:M,onItemPointerleave:N}=e({disabled:m(f,"disabled"),onSelect:e=>{const t=!T.value;I.value||(x.value=t),v("update:checked",t),v("checked-change",t),v("select",e),e.preventDefault()},onSelected:()=>C.setOpen(!1),contentRef:C.contentRef});return r(o,T),(e,t)=>(l(),n("div",s({class:"skdx-context-menu__checkbox-item","data-part":"checkbox-item",role:"menuitemcheckbox","aria-checked":T.value,"data-state":T.value?"checked":"unchecked"},k(_),{onClick:t[0]||(t[0]=(...e)=>k(b)&&k(b)(...e)),onKeydown:t[1]||(t[1]=(...e)=>k(E)&&k(E)(...e)),onPointerenter:t[2]||(t[2]=(...e)=>k(M)&&k(M)(...e)),onPointerleave:t[3]||(t[3]=(...e)=>k(N)&&k(N)(...e))}),[i(e.$slots,"default")],16,h))}});export{p as default};
+import{useMenuItem as e}from"../utils/useMenuItem.js";import{CONTEXT_MENU_CONTEXT as t,CONTEXT_MENU_ITEM_INDICATOR_CONTEXT as o}from"./context.js";import{computed as n,createElementBlock as a,defineComponent as c,inject as s,mergeProps as d,openBlock as r,provide as l,renderSlot as u,toRef as i,unref as m}from"vue";var k=["aria-checked","data-state"],h=/* @__PURE__ */c({__name:"ContextMenuCheckboxItem",props:{checked:{type:Boolean,default:!1},disabled:{type:Boolean,default:!1},textValue:{}},emits:["select","update:checked","checked-change"],setup(c,{emit:h}){const p=c,x=h,f=s(t);if(!f)throw new Error("SkdxContextMenuCheckboxItem must be used within SkdxContextMenu.");const C=n(()=>p.checked),{itemAttrs:I,onItemClick:v,onItemKeydown:T,onItemPointerenter:_,onItemPointerleave:b}=e({disabled:i(p,"disabled"),textValue:i(p,"textValue"),onSelect:e=>{const t=!C.value;x("update:checked",t),x("checked-change",t),x("select",e),e.preventDefault()},onSelected:()=>f.setOpen(!1),contentRef:f.contentRef});return l(o,C),(e,t)=>(r(),a("div",d({class:"skdx-context-menu__checkbox-item","data-part":"checkbox-item",role:"menuitemcheckbox","aria-checked":C.value,"data-state":C.value?"checked":"unchecked"},m(I),{onClick:t[0]||(t[0]=(...e)=>m(v)&&m(v)(...e)),onKeydown:t[1]||(t[1]=(...e)=>m(T)&&m(T)(...e)),onPointerenter:t[2]||(t[2]=(...e)=>m(_)&&m(_)(...e)),onPointerleave:t[3]||(t[3]=(...e)=>m(b)&&m(b)(...e))}),[u(e.$slots,"default")],16,k))}});export{h as default};

package/dist/context-menu/ContextMenuContent.vue.d.cts

@@ -1,27 +1,16 @@
 import { type FocusOutsideEvent, type InteractOutsideEvent } from '../utils/useDismiss.cjs';
+import { type AutoFocusEvent } from '../utils/useFocusTrap.cjs';
 /**
- * The menu's panel: `role="menu"` with `aria-orientation="vertical"` and
- * `data-state` (`open`/`closed`). Positions itself with `position: fixed`
- * at the triggering pointer's coordinates, clamped by `collisionPadding` so
- * it never overflows the viewport — no popper/`side`/`align` props, since a
- * context menu has no anchor element to float against.
- *
- * Provides roving-focus Up/Down arrow navigation (wrapping unless `loop` is
- * `false`) with typeahead, focuses the first item on open, returns focus to
- * `SkdxContextMenuTrigger` when Escape or Tab closes it, and closes on
- * Escape, an outside interaction (pointer-down or focus moving out), or Tab
- * unless `escape-key-down`/`pointer-down-outside`/`focus-outside`/
- * `interact-outside` call `event.preventDefault()`. `interact-outside` fires
- * for either kind of outside interaction, immediately before the specific
- * event and with the same event object, so one veto covers both. Mounts only
- * while open unless `forceMount` is set. Must be used inside `SkdxContextMenu`.
+ * Context menu panel: `role="menu"` at pointer, fixed position.
+ * Roving-focus navigation with typeahead; closes on Escape / outside / Tab.
+ * Requires `SkdxContextMenu` parent.
  */
 type __VLS_Props = {
-    /** Render the panel even while the menu is closed, instead of unmounting it. */
+    /** Render even when closed instead of unmounting. */
     forceMount?: boolean;
     /** Whether Up/Down arrow-key navigation wraps from the last item back to the first. */
     loop?: boolean;
-    /** Minimum distance (px) kept between the menu and the viewport edge when clamping its position. */
+    /** Minimum px distance to viewport edge when clamping. */
     collisionPadding?: number;
 };
 declare var __VLS_1: {};
@@ -30,11 +19,13 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "focus-outside": (event: FocusOutsideEvent) => any;
+    "close-auto-focus": (event: AutoFocusEvent) => any;
     "escape-key-down": (event: KeyboardEvent) => any;
     "pointer-down-outside": (event: PointerEvent) => any;
     "interact-outside": (event: InteractOutsideEvent) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onFocus-outside"?: ((event: FocusOutsideEvent) => any) | undefined;
+    "onClose-auto-focus"?: ((event: AutoFocusEvent) => any) | undefined;
     "onEscape-key-down"?: ((event: KeyboardEvent) => any) | undefined;
     "onPointer-down-outside"?: ((event: PointerEvent) => any) | undefined;
     "onInteract-outside"?: ((event: InteractOutsideEvent) => any) | undefined;

package/dist/context-menu/ContextMenuContent.vue.d.ts

@@ -1,27 +1,16 @@
 import { type FocusOutsideEvent, type InteractOutsideEvent } from '../utils/useDismiss.js';
+import { type AutoFocusEvent } from '../utils/useFocusTrap.js';
 /**
- * The menu's panel: `role="menu"` with `aria-orientation="vertical"` and
- * `data-state` (`open`/`closed`). Positions itself with `position: fixed`
- * at the triggering pointer's coordinates, clamped by `collisionPadding` so
- * it never overflows the viewport — no popper/`side`/`align` props, since a
- * context menu has no anchor element to float against.
- *
- * Provides roving-focus Up/Down arrow navigation (wrapping unless `loop` is
- * `false`) with typeahead, focuses the first item on open, returns focus to
- * `SkdxContextMenuTrigger` when Escape or Tab closes it, and closes on
- * Escape, an outside interaction (pointer-down or focus moving out), or Tab
- * unless `escape-key-down`/`pointer-down-outside`/`focus-outside`/
- * `interact-outside` call `event.preventDefault()`. `interact-outside` fires
- * for either kind of outside interaction, immediately before the specific
- * event and with the same event object, so one veto covers both. Mounts only
- * while open unless `forceMount` is set. Must be used inside `SkdxContextMenu`.
+ * Context menu panel: `role="menu"` at pointer, fixed position.
+ * Roving-focus navigation with typeahead; closes on Escape / outside / Tab.
+ * Requires `SkdxContextMenu` parent.
  */
 type __VLS_Props = {
-    /** Render the panel even while the menu is closed, instead of unmounting it. */
+    /** Render even when closed instead of unmounting. */
     forceMount?: boolean;
     /** Whether Up/Down arrow-key navigation wraps from the last item back to the first. */
     loop?: boolean;
-    /** Minimum distance (px) kept between the menu and the viewport edge when clamping its position. */
+    /** Minimum px distance to viewport edge when clamping. */
     collisionPadding?: number;
 };
 declare var __VLS_1: {};
@@ -30,11 +19,13 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "focus-outside": (event: FocusOutsideEvent) => any;
+    "close-auto-focus": (event: AutoFocusEvent) => any;
     "escape-key-down": (event: KeyboardEvent) => any;
     "pointer-down-outside": (event: PointerEvent) => any;
     "interact-outside": (event: InteractOutsideEvent) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onFocus-outside"?: ((event: FocusOutsideEvent) => any) | undefined;
+    "onClose-auto-focus"?: ((event: AutoFocusEvent) => any) | undefined;
     "onEscape-key-down"?: ((event: KeyboardEvent) => any) | undefined;
     "onPointer-down-outside"?: ((event: PointerEvent) => any) | undefined;
     "onInteract-outside"?: ((event: InteractOutsideEvent) => any) | undefined;

package/dist/context-menu/ContextMenuContent.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const y=require("../utils/composeRefs.cjs"),w=require("../utils/useDismiss.cjs"),C=require("../utils/useRovingFocus.cjs"),c=require("./context.cjs");let n=require("vue");var M=["id","data-state"],R=(0,n.defineComponent)({__name:"ContextMenuContent",props:{forceMount:{type:Boolean,default:!1},loop:{type:Boolean,default:!0},collisionPadding:{default:8}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside"],setup(l,{emit:d}){const i=l,u=d,t=(0,n.inject)(c.CONTEXT_MENU_CONTEXT);if(!t)throw new Error("SkdxContextMenuContent must be used within SkdxContextMenu.");const r=(0,n.ref)(null),f=y.composeRefs(r,t.contentRef),s=(0,n.ref)(t.point.value),p=C.useRovingFocus({orientation:"vertical",loop:i.loop,itemSelector:c.ITEM_SELECTOR,typeahead:!0});w.useDismiss({enabled:t.open,onEscapeKeyDown:e=>{u("escape-key-down",e),e.defaultPrevented||(t.setOpen(!1),t.triggerRef.value?.focus())},onPointerDownOutside:e=>{u("pointer-down-outside",e),e.defaultPrevented||t.setOpen(!1)},onFocusOutside:e=>{u("focus-outside",e),e.defaultPrevented||t.setOpen(!1)},onInteractOutside:e=>u("interact-outside",e)},[r]),(0,n.watch)(()=>[t.open.value,t.point.value],([e])=>{if(!e)return;const o=r.value;if(!o){s.value=t.point.value;return}const{width:x,height:h}=o.getBoundingClientRect(),_=window.innerWidth-x-i.collisionPadding,g=window.innerHeight-h-i.collisionPadding;s.value={x:Math.max(i.collisionPadding,Math.min(t.point.value.x,Math.max(_,i.collisionPadding))),y:Math.max(i.collisionPadding,Math.min(t.point.value.y,Math.max(g,i.collisionPadding)))}},{immediate:!0,flush:"post"});let a;(0,n.watch)(t.open,e=>{a!==void 0&&cancelAnimationFrame(a),!(!e||typeof document>"u")&&(a=requestAnimationFrame(()=>{const o=r.value;!o||o.contains(document.activeElement)||(o.querySelector('[role^="menuitem"]:not([data-disabled])')??o).focus()}))},{immediate:!0}),(0,n.onBeforeUnmount)(()=>{a!==void 0&&cancelAnimationFrame(a)});const m=(0,n.computed)(()=>({position:"fixed",top:`${s.value.y}px`,left:`${s.value.x}px`}));function v(e){p(e),e.key==="Tab"&&(e.preventDefault(),t.setOpen(!1),t.triggerRef.value?.focus())}return(e,o)=>l.forceMount||(0,n.unref)(t).open.value?((0,n.openBlock)(),(0,n.createElementBlock)("div",{key:0,class:"skdx-context-menu__content","data-part":"content",id:(0,n.unref)(t).contentId,ref:(0,n.unref)(f),role:"menu","aria-orientation":"vertical",tabindex:"-1","data-state":(0,n.unref)(t).open.value?"open":"closed",style:(0,n.normalizeStyle)(m.value),onKeydown:v},[(0,n.renderSlot)(e.$slots,"default")],44,M)):(0,n.createCommentVNode)("",!0)}});exports.default=R;
+const O=require("../utils/composeRefs.cjs"),b=require("../utils/useBodyScrollLock.cjs"),k=require("../utils/useDismiss.cjs"),E=require("../utils/useFocusTrap.cjs"),f=require("../utils/useOutsideInert.cjs"),P=require("../utils/useRovingFocus.cjs"),p=require("./context.cjs");let o=require("vue");var R=["id","aria-labelledby","data-state"],S=(0,o.defineComponent)({__name:"ContextMenuContent",props:{forceMount:{type:Boolean,default:!1},loop:{type:Boolean,default:!0},collisionPadding:{default:8}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside","close-auto-focus"],setup(l,{emit:m}){const i=l,a=m,e=(0,o.inject)(p.CONTEXT_MENU_CONTEXT);if(!e)throw new Error("SkdxContextMenuContent must be used within SkdxContextMenu.");const v=(0,o.useAttrs)(),y=(0,o.computed)(()=>v["aria-label"]===void 0?e.triggerId:void 0),u=(0,o.ref)(null),x=O.composeRefs(u,e.contentRef),s=(0,o.ref)(e.point.value),_=P.useRovingFocus({orientation:"vertical",loop:i.loop,itemSelector:p.ITEM_SELECTOR,scopeSelector:'[role="menu"]',typeahead:!0,includeDisabled:!0}),c=(0,o.computed)(()=>e.open.value&&e.modal.value);f.useOutsideInert(u,c),b.useBodyScrollLock(c),k.useDismiss({enabled:e.open,onEscapeKeyDown:t=>{a("escape-key-down",t),t.defaultPrevented||(e.setOpen(!1),d())},onPointerDownOutside:t=>{a("pointer-down-outside",t),t.defaultPrevented||e.setOpen(!1)},onFocusOutside:t=>{a("focus-outside",t),t.defaultPrevented||e.setOpen(!1)},onInteractOutside:t=>a("interact-outside",t)},[u]),(0,o.watch)(()=>[e.open.value,e.point.value,u.value],([t])=>{if(!t)return;const n=u.value;if(!n){s.value=e.point.value;return}const{width:w,height:q}=n.getBoundingClientRect(),C=window.innerWidth-w-i.collisionPadding,M=window.innerHeight-q-i.collisionPadding;s.value={x:Math.max(i.collisionPadding,Math.min(e.point.value.x,Math.max(C,i.collisionPadding))),y:Math.max(i.collisionPadding,Math.min(e.point.value.y,Math.max(M,i.collisionPadding)))}},{immediate:!0,flush:"post"});let r;(0,o.watch)(e.open,t=>{r!==void 0&&cancelAnimationFrame(r),!(!t||typeof document>"u")&&(r=requestAnimationFrame(()=>{const n=u.value;!n||n.contains(document.activeElement)||(n.querySelector('[role^="menuitem"]')??n).focus()}))},{immediate:!0}),(0,o.onBeforeUnmount)(()=>{r!==void 0&&cancelAnimationFrame(r)});const h=(0,o.computed)(()=>({position:"fixed",top:`${s.value.y}px`,left:`${s.value.x}px`}));function d(){e.modal.value&&f.releaseOutsideInert(),E.autoFocusEvent("close-auto-focus",t=>a("close-auto-focus",t))&&e.triggerRef.value?.focus()}function g(t){_(t),t.key==="Tab"&&(e.setOpen(!1),d())}return(t,n)=>l.forceMount||(0,o.unref)(e).open.value?((0,o.openBlock)(),(0,o.createElementBlock)("div",{key:0,class:"skdx-context-menu__content","data-part":"content",id:(0,o.unref)(e).contentId,ref:(0,o.unref)(x),role:"menu","aria-labelledby":y.value,"aria-orientation":"vertical",tabindex:"-1","data-state":(0,o.unref)(e).open.value?"open":"closed",style:(0,o.normalizeStyle)(h.value),onKeydown:g},[(0,o.renderSlot)(t.$slots,"default")],44,R)):(0,o.createCommentVNode)("",!0)}});exports.default=S;

package/dist/context-menu/ContextMenuContent.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{composeRefs as e}from"../utils/composeRefs.js";import{useDismiss as t}from"../utils/useDismiss.js";import{useRovingFocus as o}from"../utils/useRovingFocus.js";import{CONTEXT_MENU_CONTEXT as n,ITEM_SELECTOR as a}from"./context.js";import{computed as i,createCommentVNode as s,createElementBlock as u,defineComponent as l,inject as d,normalizeStyle as r,onBeforeUnmount as c,openBlock as m,ref as p,renderSlot as f,unref as v,watch as x}from"vue";var g=["id","data-state"],h=/* @__PURE__ */l({__name:"ContextMenuContent",props:{forceMount:{type:Boolean,default:!1},loop:{type:Boolean,default:!0},collisionPadding:{default:8}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside"],setup(l,{emit:h}){const w=l,y=h,M=d(n);if(!M)throw new Error("SkdxContextMenuContent must be used within SkdxContextMenu.");const C=p(null),P=e(C,M.contentRef),E=p(M.point.value),O=o({orientation:"vertical",loop:w.loop,itemSelector:a,typeahead:!0});let k;t({enabled:M.open,onEscapeKeyDown:e=>{y("escape-key-down",e),e.defaultPrevented||(M.setOpen(!1),M.triggerRef.value?.focus())},onPointerDownOutside:e=>{y("pointer-down-outside",e),e.defaultPrevented||M.setOpen(!1)},onFocusOutside:e=>{y("focus-outside",e),e.defaultPrevented||M.setOpen(!1)},onInteractOutside:e=>y("interact-outside",e)},[C]),x(()=>[M.open.value,M.point.value],([e])=>{if(!e)return;const t=C.value;if(!t)return void(E.value=M.point.value);const{width:o,height:n}=t.getBoundingClientRect(),a=window.innerWidth-o-w.collisionPadding,i=window.innerHeight-n-w.collisionPadding;E.value={x:Math.max(w.collisionPadding,Math.min(M.point.value.x,Math.max(a,w.collisionPadding))),y:Math.max(w.collisionPadding,Math.min(M.point.value.y,Math.max(i,w.collisionPadding)))}},{immediate:!0,flush:"post"}),x(M.open,e=>{void 0!==k&&cancelAnimationFrame(k),e&&!(typeof document>"u")&&(k=requestAnimationFrame(()=>{const e=C.value;!e||e.contains(document.activeElement)||(e.querySelector('[role^="menuitem"]:not([data-disabled])')??e).focus()}))},{immediate:!0}),c(()=>{void 0!==k&&cancelAnimationFrame(k)});const R=i(()=>({position:"fixed",top:`${E.value.y}px`,left:`${E.value.x}px`}));function S(e){O(e),"Tab"===e.key&&(e.preventDefault(),M.setOpen(!1),M.triggerRef.value?.focus())}return(e,t)=>l.forceMount||v(M).open.value?(m(),u("div",{key:0,class:"skdx-context-menu__content","data-part":"content",id:v(M).contentId,ref:v(P),role:"menu","aria-orientation":"vertical",tabindex:"-1","data-state":v(M).open.value?"open":"closed",style:r(R.value),onKeydown:S},[f(e.$slots,"default")],44,g)):s("",!0)}});export{h as default};
+import{composeRefs as e}from"../utils/composeRefs.js";import{useBodyScrollLock as o}from"../utils/useBodyScrollLock.js";import{useDismiss as t}from"../utils/useDismiss.js";import{autoFocusEvent as n}from"../utils/useFocusTrap.js";import{releaseOutsideInert as a,useOutsideInert as i}from"../utils/useOutsideInert.js";import{useRovingFocus as s}from"../utils/useRovingFocus.js";import{CONTEXT_MENU_CONTEXT as u,ITEM_SELECTOR as l}from"./context.js";import{computed as d,createCommentVNode as r,createElementBlock as c,defineComponent as m,inject as p,normalizeStyle as f,onBeforeUnmount as v,openBlock as x,ref as y,renderSlot as g,unref as h,useAttrs as w,watch as M}from"vue";var O=["id","aria-labelledby","data-state"],k=/* @__PURE__ */m({__name:"ContextMenuContent",props:{forceMount:{type:Boolean,default:!1},loop:{type:Boolean,default:!0},collisionPadding:{default:8}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside","close-auto-focus"],setup(m,{emit:k}){const C=m,E=k,P=p(u);if(!P)throw new Error("SkdxContextMenuContent must be used within SkdxContextMenu.");const b=w(),S=d(()=>void 0===b["aria-label"]?P.triggerId:void 0),j=y(null),B=e(j,P.contentRef),F=y(P.point.value),R=s({orientation:"vertical",loop:C.loop,itemSelector:l,scopeSelector:'[role="menu"]',typeahead:!0,includeDisabled:!0}),T=d(()=>P.open.value&&P.modal.value);let I;i(j,T),o(T),t({enabled:P.open,onEscapeKeyDown:e=>{E("escape-key-down",e),e.defaultPrevented||(P.setOpen(!1),D())},onPointerDownOutside:e=>{E("pointer-down-outside",e),e.defaultPrevented||P.setOpen(!1)},onFocusOutside:e=>{E("focus-outside",e),e.defaultPrevented||P.setOpen(!1)},onInteractOutside:e=>E("interact-outside",e)},[j]),M(()=>[P.open.value,P.point.value,j.value],([e])=>{if(!e)return;const o=j.value;if(!o)return void(F.value=P.point.value);const{width:t,height:n}=o.getBoundingClientRect(),a=window.innerWidth-t-C.collisionPadding,i=window.innerHeight-n-C.collisionPadding;F.value={x:Math.max(C.collisionPadding,Math.min(P.point.value.x,Math.max(a,C.collisionPadding))),y:Math.max(C.collisionPadding,Math.min(P.point.value.y,Math.max(i,C.collisionPadding)))}},{immediate:!0,flush:"post"}),M(P.open,e=>{void 0!==I&&cancelAnimationFrame(I),e&&!(typeof document>"u")&&(I=requestAnimationFrame(()=>{const e=j.value;!e||e.contains(document.activeElement)||(e.querySelector('[role^="menuitem"]')??e).focus()}))},{immediate:!0}),v(()=>{void 0!==I&&cancelAnimationFrame(I)});const _=d(()=>({position:"fixed",top:`${F.value.y}px`,left:`${F.value.x}px`}));function D(){P.modal.value&&a(),n("close-auto-focus",e=>E("close-auto-focus",e))&&P.triggerRef.value?.focus()}function A(e){R(e),"Tab"===e.key&&(P.setOpen(!1),D())}return(e,o)=>m.forceMount||h(P).open.value?(x(),c("div",{key:0,class:"skdx-context-menu__content","data-part":"content",id:h(P).contentId,ref:h(B),role:"menu","aria-labelledby":S.value,"aria-orientation":"vertical",tabindex:"-1","data-state":h(P).open.value?"open":"closed",style:f(_.value),onKeydown:A},[g(e.$slots,"default")],44,O)):r("",!0)}});export{k as default};

package/dist/context-menu/ContextMenuGroup.vue.d.cts

@@ -1,7 +1,3 @@
-/**
- * Semantic grouping of related items: renders a `<div role="group">`.
- * Pair with a preceding `SkdxContextMenuLabel` to caption the group.
- */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/context-menu/ContextMenuGroup.vue.d.ts

@@ -1,7 +1,3 @@
-/**
- * Semantic grouping of related items: renders a `<div role="group">`.
- * Pair with a preceding `SkdxContextMenuLabel` to caption the group.
- */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/context-menu/ContextMenuGroup.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-let e=require("vue");var r={class:"skdx-context-menu__group","data-part":"group",role:"group"},u=(0,e.defineComponent)({__name:"ContextMenuGroup",setup(o){return(t,_)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",r,[(0,e.renderSlot)(t.$slots,"default")]))}});exports.default=u;
+const a=require("../utils/declaredChildren.cjs"),o=require("../utils/menuGroup.cjs"),n=require("./ContextMenuLabel.vue.cjs");let e=require("vue");var s=["aria-labelledby"],d=(0,e.defineComponent)({__name:"ContextMenuGroup",setup(_){const r=(0,e.useAttrs)(),t=o.useMenuGroupLabel(a.slotDeclares((0,e.useSlots)().default,n.default)),u=(0,e.computed)(()=>r["aria-label"]===void 0?t.value:void 0);return(l,c)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-context-menu__group","data-part":"group",role:"group","aria-labelledby":u.value},[(0,e.renderSlot)(l.$slots,"default")],8,s))}});exports.default=d;

package/dist/context-menu/ContextMenuGroup.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{createElementBlock as e,defineComponent as o,openBlock as t,renderSlot as a}from"vue";var r={class:"skdx-context-menu__group","data-part":"group",role:"group"},n=/* @__PURE__ */o({__name:"ContextMenuGroup",setup:o=>(o,n)=>(t(),e("div",r,[a(o.$slots,"default")]))});export{n as default};
+import{slotDeclares as e}from"../utils/declaredChildren.js";import{useMenuGroupLabel as a}from"../utils/menuGroup.js";import o from"./ContextMenuLabel.vue.js";import{computed as t,createElementBlock as r,defineComponent as l,openBlock as s,renderSlot as u,useAttrs as n,useSlots as d}from"vue";var p=["aria-labelledby"],i=/* @__PURE__ */l({__name:"ContextMenuGroup",setup(l){const i=n(),m=a(e(d().default,o)),c=t(()=>void 0===i["aria-label"]?m.value:void 0);return(e,a)=>(s(),r("div",{class:"skdx-context-menu__group","data-part":"group",role:"group","aria-labelledby":c.value},[u(e.$slots,"default")],8,p))}});export{i as default};

package/dist/context-menu/ContextMenuItem.vue.d.cts

@@ -1,13 +1,20 @@
 /**
- * A single selectable menu item: `role="menuitem"`, participates in the
- * content's roving-focus/typeahead navigation. Selecting it (click, Enter,
- * or Space) fires `select` and closes the menu unless the `select`
- * listener calls `event.preventDefault()`. Set `disabled` to exclude it
- * from navigation and selection.
+ * A single menu item: `role="menuitem"`, participates in roving-focus/typeahead
+ * navigation. Selection (click, Enter, Space) fires `select` and closes the
+ * menu unless `event.preventDefault()` is called.
  */
 type __VLS_Props = {
-    /** Excludes the item from roving-focus navigation and blocks selection. */
+    /** Marks the item aria-disabled and blocks selection. It stays in the roving order and remains focusable, so a keyboard user still discovers the command. */
     disabled?: boolean;
+    /**
+     * Text typeahead matches this item by, instead of its rendered text.
+     * Reflected to `data-text-value`, which every matcher reads ahead of
+     * `textContent` — the default is wrong for any item that renders more than
+     * its label (an item with an indicator reads as "✓Apple") and useless for an
+     * icon-only one.
+     * @default undefined — typeahead matches the item's rendered text instead.
+     */
+    textValue?: string;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/context-menu/ContextMenuItem.vue.d.ts

@@ -1,13 +1,20 @@
 /**
- * A single selectable menu item: `role="menuitem"`, participates in the
- * content's roving-focus/typeahead navigation. Selecting it (click, Enter,
- * or Space) fires `select` and closes the menu unless the `select`
- * listener calls `event.preventDefault()`. Set `disabled` to exclude it
- * from navigation and selection.
+ * A single menu item: `role="menuitem"`, participates in roving-focus/typeahead
+ * navigation. Selection (click, Enter, Space) fires `select` and closes the
+ * menu unless `event.preventDefault()` is called.
  */
 type __VLS_Props = {
-    /** Excludes the item from roving-focus navigation and blocks selection. */
+    /** Marks the item aria-disabled and blocks selection. It stays in the roving order and remains focusable, so a keyboard user still discovers the command. */
     disabled?: boolean;
+    /**
+     * Text typeahead matches this item by, instead of its rendered text.
+     * Reflected to `data-text-value`, which every matcher reads ahead of
+     * `textContent` — the default is wrong for any item that renders more than
+     * its label (an item with an indicator reads as "✓Apple") and useless for an
+     * icon-only one.
+     * @default undefined — typeahead matches the item's rendered text instead.
+     */
+    textValue?: string;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/context-menu/ContextMenuItem.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const x=require("../utils/useMenuItem.cjs"),c=require("./context.cjs");let e=require("vue");var C=(0,e.defineComponent)({__name:"ContextMenuItem",props:{disabled:{type:Boolean,default:!1}},emits:["select"],setup(m,{emit:d}){const f=m,p=d,o=(0,e.inject)(c.CONTEXT_MENU_CONTEXT);if(!o)throw new Error("SkdxContextMenuItem must be used within SkdxContextMenu.");const{itemAttrs:a,onItemClick:u,onItemKeydown:s,onItemPointerenter:i,onItemPointerleave:l}=x.useMenuItem({disabled:(0,e.toRef)(f,"disabled"),onSelect:r=>p("select",r),onSelected:()=>o.setOpen(!1),contentRef:o.contentRef});return(r,t)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",(0,e.mergeProps)({class:"skdx-context-menu__item","data-part":"item",role:"menuitem"},(0,e.unref)(a),{onClick:t[0]||(t[0]=(...n)=>(0,e.unref)(u)&&(0,e.unref)(u)(...n)),onKeydown:t[1]||(t[1]=(...n)=>(0,e.unref)(s)&&(0,e.unref)(s)(...n)),onPointerenter:t[2]||(t[2]=(...n)=>(0,e.unref)(i)&&(0,e.unref)(i)(...n)),onPointerleave:t[3]||(t[3]=(...n)=>(0,e.unref)(l)&&(0,e.unref)(l)(...n))}),[(0,e.renderSlot)(r.$slots,"default")],16))}});exports.default=C;
+const x=require("../utils/useMenuItem.cjs"),c=require("./context.cjs");let e=require("vue");var C=(0,e.defineComponent)({__name:"ContextMenuItem",props:{disabled:{type:Boolean,default:!1},textValue:{}},emits:["select"],setup(d,{emit:f}){const u=d,a=f,o=(0,e.inject)(c.CONTEXT_MENU_CONTEXT);if(!o)throw new Error("SkdxContextMenuItem must be used within SkdxContextMenu.");const{itemAttrs:p,onItemClick:s,onItemKeydown:l,onItemPointerenter:i,onItemPointerleave:m}=x.useMenuItem({disabled:(0,e.toRef)(u,"disabled"),textValue:(0,e.toRef)(u,"textValue"),onSelect:r=>a("select",r),onSelected:()=>o.setOpen(!1),contentRef:o.contentRef});return(r,t)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",(0,e.mergeProps)({class:"skdx-context-menu__item","data-part":"item",role:"menuitem"},(0,e.unref)(p),{onClick:t[0]||(t[0]=(...n)=>(0,e.unref)(s)&&(0,e.unref)(s)(...n)),onKeydown:t[1]||(t[1]=(...n)=>(0,e.unref)(l)&&(0,e.unref)(l)(...n)),onPointerenter:t[2]||(t[2]=(...n)=>(0,e.unref)(i)&&(0,e.unref)(i)(...n)),onPointerleave:t[3]||(t[3]=(...n)=>(0,e.unref)(m)&&(0,e.unref)(m)(...n))}),[(0,e.renderSlot)(r.$slots,"default")],16))}});exports.default=C;

package/dist/context-menu/ContextMenuItem.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{useMenuItem as e}from"../utils/useMenuItem.js";import{CONTEXT_MENU_CONTEXT as t}from"./context.js";import{createElementBlock as n,defineComponent as o,inject as s,mergeProps as r,openBlock as a,renderSlot as m,toRef as i,unref as l}from"vue";var d=/* @__PURE__ */o({__name:"ContextMenuItem",props:{disabled:{type:Boolean,default:!1}},emits:["select"],setup(o,{emit:d}){const u=o,c=d,p=s(t);if(!p)throw new Error("SkdxContextMenuItem must be used within SkdxContextMenu.");const{itemAttrs:f,onItemClick:x,onItemKeydown:C,onItemPointerenter:I,onItemPointerleave:k}=e({disabled:i(u,"disabled"),onSelect:e=>c("select",e),onSelected:()=>p.setOpen(!1),contentRef:p.contentRef});return(e,t)=>(a(),n("div",r({class:"skdx-context-menu__item","data-part":"item",role:"menuitem"},l(f),{onClick:t[0]||(t[0]=(...e)=>l(x)&&l(x)(...e)),onKeydown:t[1]||(t[1]=(...e)=>l(C)&&l(C)(...e)),onPointerenter:t[2]||(t[2]=(...e)=>l(I)&&l(I)(...e)),onPointerleave:t[3]||(t[3]=(...e)=>l(k)&&l(k)(...e))}),[m(e.$slots,"default")],16))}});export{d as default};
+import{useMenuItem as e}from"../utils/useMenuItem.js";import{CONTEXT_MENU_CONTEXT as t}from"./context.js";import{createElementBlock as n,defineComponent as o,inject as s,mergeProps as a,openBlock as r,renderSlot as m,toRef as l,unref as i}from"vue";var u=/* @__PURE__ */o({__name:"ContextMenuItem",props:{disabled:{type:Boolean,default:!1},textValue:{}},emits:["select"],setup(o,{emit:u}){const d=o,c=u,p=s(t);if(!p)throw new Error("SkdxContextMenuItem must be used within SkdxContextMenu.");const{itemAttrs:f,onItemClick:x,onItemKeydown:C,onItemPointerenter:I,onItemPointerleave:k}=e({disabled:l(d,"disabled"),textValue:l(d,"textValue"),onSelect:e=>c("select",e),onSelected:()=>p.setOpen(!1),contentRef:p.contentRef});return(e,t)=>(r(),n("div",a({class:"skdx-context-menu__item","data-part":"item",role:"menuitem"},i(f),{onClick:t[0]||(t[0]=(...e)=>i(x)&&i(x)(...e)),onKeydown:t[1]||(t[1]=(...e)=>i(C)&&i(C)(...e)),onPointerenter:t[2]||(t[2]=(...e)=>i(I)&&i(I)(...e)),onPointerleave:t[3]||(t[3]=(...e)=>i(k)&&i(k)(...e))}),[m(e.$slots,"default")],16))}});export{u as default};

package/dist/context-menu/ContextMenuItemIndicator.vue.d.cts

@@ -1,8 +1,7 @@
 /**
- * Renders its children (typically a check glyph) only while the enclosing
- * `SkdxContextMenuCheckboxItem` or `SkdxContextMenuRadioItem` is checked.
+ * Renders children only while enclosing checkbox/radio item is checked.
  * Exposes `data-state` (`checked`/`unchecked`). Mounts only while checked
- * unless `forceMount` is set.
+ * unless `forceMount` set.
  */
 type __VLS_Props = {
     /** Render even while unchecked, instead of unmounting. */

package/dist/context-menu/ContextMenuItemIndicator.vue.d.ts

@@ -1,8 +1,7 @@
 /**
- * Renders its children (typically a check glyph) only while the enclosing
- * `SkdxContextMenuCheckboxItem` or `SkdxContextMenuRadioItem` is checked.
+ * Renders children only while enclosing checkbox/radio item is checked.
  * Exposes `data-state` (`checked`/`unchecked`). Mounts only while checked
- * unless `forceMount` is set.
+ * unless `forceMount` set.
  */
 type __VLS_Props = {
     /** Render even while unchecked, instead of unmounting. */

package/dist/context-menu/ContextMenuItems.vue.cjs

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

package/dist/context-menu/ContextMenuItems.vue.d.cts

@@ -0,0 +1,25 @@
+import type { MenuItem } from './types.cjs';
+/**
+ * The item list that `ContextMenuAnatomy` draws, recursing for submenus and groups
+ * so roving focus and typeahead see one uniform anatomy at every level.
+ * Not exported from the package.
+ * @internal
+ */
+type __VLS_Props = {
+    items: MenuItem[];
+    /** The recipe's `select`, fired after the item's own `onSelect`. */
+    onItemSelect?: (item: MenuItem) => void;
+};
+type __VLS_Slots = {
+    item?(props: {
+        item: MenuItem;
+    }): 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;
+    };
+};

package/dist/context-menu/ContextMenuItems.vue.d.ts

@@ -0,0 +1,25 @@
+import type { MenuItem } from './types.js';
+/**
+ * The item list that `ContextMenuAnatomy` draws, recursing for submenus and groups
+ * so roving focus and typeahead see one uniform anatomy at every level.
+ * Not exported from the package.
+ * @internal
+ */
+type __VLS_Props = {
+    items: MenuItem[];
+    /** The recipe's `select`, fired after the item's own `onSelect`. */
+    onItemSelect?: (item: MenuItem) => void;
+};
+type __VLS_Slots = {
+    item?(props: {
+        item: MenuItem;
+    }): 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;
+    };
+};

package/dist/context-menu/ContextMenuItems.vue.js

@@ -0,0 +1 @@
+import e from"./ContextMenuItems.vue_vue_type_script_setup_true_lang.js";var t=e;export{t as default};

package/dist/context-menu/ContextMenuItems.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const y=require("../utils/MenuSubContent.vue.cjs"),b=require("../utils/MenuSubTrigger.vue.cjs"),S=require("./ContextMenuCheckboxItem.vue.cjs"),v=require("./ContextMenuLabel.vue.cjs"),B=require("./ContextMenuGroup.vue.cjs"),g=require("./ContextMenuItem.vue.cjs"),u=require("./ContextMenuItemIndicator.vue.cjs"),V=require("./ContextMenuRadioGroup.vue.cjs"),q=require("./ContextMenuRadioItem.vue.cjs"),_=require("./ContextMenuSeparator.vue.cjs"),c=require("./ContextMenuShortcut.vue.cjs"),m=require("./ContextMenuSub.vue.cjs");let e=require("vue");var w=(0,e.defineComponent)({__name:"ContextMenuItems",props:{items:{},onItemSelect:{type:Function}},setup(n){const d=n,s=o=>"type"in o&&o.type==="separator",i=o=>"type"in o&&o.type==="checkbox",k=o=>"type"in o&&o.type==="radio-group",x=o=>"type"in o&&o.type==="submenu",C=o=>"type"in o&&o.type==="group";function f(o,l){return"type"in o?`${o.type}-${l}`:`${o.label}-${l}`}function h(o){o.onSelect?.(),d.onItemSelect?.(o)}return(o,l)=>{const a=(0,e.resolveComponent)("ContextMenuItems",!0);return(0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,null,(0,e.renderList)(n.items,(t,p)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,{key:f(t,p)},[s(t)?((0,e.openBlock)(),(0,e.createBlock)(_.default,{key:0})):i(t)?((0,e.openBlock)(),(0,e.createBlock)(S.default,{key:1,checked:t.checked??!1,disabled:t.disabled,"text-value":t.textValue??t.label,onCheckedChange:r=>t.onCheckedChange?.(r),onSelect:r=>n.onItemSelect?.(t)},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(o.$slots,"item",{item:t},()=>[(0,e.createVNode)(u.default,{"aria-hidden":"true"},{default:(0,e.withCtx)(()=>[...l[0]||(l[0]=[(0,e.createElementVNode)("svg",{viewBox:"0 0 16 16",width:"1em",height:"1em","aria-hidden":"true",focusable:"false"},[(0,e.createElementVNode)("path",{d:"M3 8.5l3 3 7-7",fill:"none",stroke:"currentColor","stroke-width":"1.5","stroke-linecap":"round","stroke-linejoin":"round"})],-1)])]),_:1}),(0,e.createTextVNode)(" "+(0,e.toDisplayString)(t.label)+" ",1),t.shortcut?((0,e.openBlock)(),(0,e.createBlock)(c.default,{key:0},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.shortcut),1)]),_:2},1024)):(0,e.createCommentVNode)("",!0)])]),_:2},1032,["checked","disabled","text-value","onCheckedChange","onSelect"])):k(t)?((0,e.openBlock)(),(0,e.createBlock)(V.default,{key:2,value:t.value,onValueChange:r=>t.onValueChange?.(r)},{default:(0,e.withCtx)(()=>[((0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,null,(0,e.renderList)(t.items,r=>((0,e.openBlock)(),(0,e.createBlock)(q.default,{key:r.value,value:r.value,disabled:r.disabled,"text-value":r.textValue??r.label},{default:(0,e.withCtx)(()=>[(0,e.createVNode)(u.default,{"aria-hidden":"true"},{default:(0,e.withCtx)(()=>[...l[1]||(l[1]=[(0,e.createElementVNode)("svg",{viewBox:"0 0 16 16",width:"1em",height:"1em","aria-hidden":"true",focusable:"false"},[(0,e.createElementVNode)("circle",{cx:"8",cy:"8",r:"3",fill:"currentColor"})],-1)])]),_:1}),(0,e.createTextVNode)(" "+(0,e.toDisplayString)(r.label),1)]),_:2},1032,["value","disabled","text-value"]))),128))]),_:2},1032,["value","onValueChange"])):x(t)?((0,e.openBlock)(),(0,e.createBlock)(m.default,{key:3},{default:(0,e.withCtx)(()=>[(0,e.createVNode)(b.default,{disabled:t.disabled,"text-value":t.textValue??t.label},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.label),1)]),_:2},1032,["disabled","text-value"]),(0,e.createVNode)(y.default,null,{default:(0,e.withCtx)(()=>[(0,e.createVNode)(a,{items:t.items,"on-item-select":n.onItemSelect},(0,e.createSlots)({_:2},[o.$slots.item?{name:"item",fn:(0,e.withCtx)(r=>[(0,e.renderSlot)(o.$slots,"item",(0,e.mergeProps)({ref_for:!0},r))]),key:"0"}:void 0]),1032,["items","on-item-select"])]),_:2},1024)]),_:2},1024)):C(t)?((0,e.openBlock)(),(0,e.createBlock)(B.default,{key:4},{default:(0,e.withCtx)(()=>[t.label?((0,e.openBlock)(),(0,e.createBlock)(v.default,{key:0},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.label),1)]),_:2},1024)):(0,e.createCommentVNode)("",!0),(0,e.createVNode)(a,{items:t.items,"on-item-select":n.onItemSelect},(0,e.createSlots)({_:2},[o.$slots.item?{name:"item",fn:(0,e.withCtx)(r=>[(0,e.renderSlot)(o.$slots,"item",(0,e.mergeProps)({ref_for:!0},r))]),key:"0"}:void 0]),1032,["items","on-item-select"])]),_:2},1024)):((0,e.openBlock)(),(0,e.createBlock)(g.default,{key:5,disabled:t.disabled,"text-value":t.textValue??t.label,onSelect:r=>h(t)},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(o.$slots,"item",{item:t},()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.label)+" ",1),t.shortcut?((0,e.openBlock)(),(0,e.createBlock)(c.default,{key:0},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.shortcut),1)]),_:2},1024)):(0,e.createCommentVNode)("",!0)])]),_:2},1032,["disabled","text-value","onSelect"]))],64))),128)}}});exports.default=w;

package/dist/context-menu/ContextMenuItems.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import e from"../utils/MenuSubContent.vue.js";import t from"../utils/MenuSubTrigger.vue.js";import o from"./ContextMenuCheckboxItem.vue.js";import l from"./ContextMenuLabel.vue.js";import a from"./ContextMenuGroup.vue.js";import n from"./ContextMenuItem.vue.js";import u from"./ContextMenuItemIndicator.vue.js";import s from"./ContextMenuRadioGroup.vue.js";import r from"./ContextMenuRadioItem.vue.js";import i from"./ContextMenuSeparator.vue.js";import m from"./ContextMenuShortcut.vue.js";import d from"./ContextMenuSub.vue.js";import{Fragment as c,createBlock as p,createCommentVNode as f,createElementBlock as v,createElementVNode as b,createSlots as h,createTextVNode as x,createVNode as C,defineComponent as k,mergeProps as y,openBlock as _,renderList as S,renderSlot as g,resolveComponent as M,toDisplayString as j,withCtx as I}from"vue";var V=/* @__PURE__ */k({__name:"ContextMenuItems",props:{items:{},onItemSelect:{type:Function}},setup(k){const V=k,$=e=>"type"in e&&"separator"===e.type,w=e=>"type"in e&&"checkbox"===e.type,B=e=>"type"in e&&"radio-group"===e.type,N=e=>"type"in e&&"submenu"===e.type,E=e=>"type"in e&&"group"===e.type;function F(e,t){return"type"in e?`${e.type}-${t}`:`${e.label}-${t}`}return(G,L)=>{const R=M("ContextMenuItems",!0);return _(!0),v(c,null,S(k.items,(M,T)=>(_(),v(c,{key:F(M,T)},[$(M)?(_(),p(i,{key:0})):w(M)?(_(),p(o,{key:1,checked:M.checked??!1,disabled:M.disabled,"text-value":M.textValue??M.label,onCheckedChange:e=>M.onCheckedChange?.(e),onSelect:e=>k.onItemSelect?.(M)},{default:I(()=>[g(G.$slots,"item",{item:M},()=>[C(u,{"aria-hidden":"true"},{default:I(()=>[...L[0]||(L[0]=[b("svg",{viewBox:"0 0 16 16",width:"1em",height:"1em","aria-hidden":"true",focusable:"false"},[b("path",{d:"M3 8.5l3 3 7-7",fill:"none",stroke:"currentColor","stroke-width":"1.5","stroke-linecap":"round","stroke-linejoin":"round"})],-1)])]),_:1}),x(" "+j(M.label)+" ",1),M.shortcut?(_(),p(m,{key:0},{default:I(()=>[x(j(M.shortcut),1)]),_:2},1024)):f("",!0)])]),_:2},1032,["checked","disabled","text-value","onCheckedChange","onSelect"])):B(M)?(_(),p(s,{key:2,value:M.value,onValueChange:e=>M.onValueChange?.(e)},{default:I(()=>[(_(!0),v(c,null,S(M.items,e=>(_(),p(r,{key:e.value,value:e.value,disabled:e.disabled,"text-value":e.textValue??e.label},{default:I(()=>[C(u,{"aria-hidden":"true"},{default:I(()=>[...L[1]||(L[1]=[b("svg",{viewBox:"0 0 16 16",width:"1em",height:"1em","aria-hidden":"true",focusable:"false"},[b("circle",{cx:"8",cy:"8",r:"3",fill:"currentColor"})],-1)])]),_:1}),x(" "+j(e.label),1)]),_:2},1032,["value","disabled","text-value"]))),128))]),_:2},1032,["value","onValueChange"])):N(M)?(_(),p(d,{key:3},{default:I(()=>[C(t,{disabled:M.disabled,"text-value":M.textValue??M.label},{default:I(()=>[x(j(M.label),1)]),_:2},1032,["disabled","text-value"]),C(e,null,{default:I(()=>[C(R,{items:M.items,"on-item-select":k.onItemSelect},h({_:2},[G.$slots.item?{name:"item",fn:I(e=>[g(G.$slots,"item",y({ref_for:!0},e))]),key:"0"}:void 0]),1032,["items","on-item-select"])]),_:2},1024)]),_:2},1024)):E(M)?(_(),p(a,{key:4},{default:I(()=>[M.label?(_(),p(l,{key:0},{default:I(()=>[x(j(M.label),1)]),_:2},1024)):f("",!0),C(R,{items:M.items,"on-item-select":k.onItemSelect},h({_:2},[G.$slots.item?{name:"item",fn:I(e=>[g(G.$slots,"item",y({ref_for:!0},e))]),key:"0"}:void 0]),1032,["items","on-item-select"])]),_:2},1024)):(_(),p(n,{key:5,disabled:M.disabled,"text-value":M.textValue??M.label,onSelect:e=>function(e){e.onSelect?.(),V.onItemSelect?.(e)}(M)},{default:I(()=>[g(G.$slots,"item",{item:M},()=>[x(j(M.label)+" ",1),M.shortcut?(_(),p(m,{key:0},{default:I(()=>[x(j(M.shortcut),1)]),_:2},1024)):f("",!0)])]),_:2},1032,["disabled","text-value","onSelect"]))],64))),128)}}});export{V as default};

package/dist/context-menu/ContextMenuLabel.vue.d.cts

@@ -1,7 +1,3 @@
-/**
- * Non-interactive heading for a group of items, typically preceding a
- * `SkdxContextMenuGroup`. Renders a plain `<div>`.
- */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/context-menu/ContextMenuLabel.vue.d.ts

@@ -1,7 +1,3 @@
-/**
- * Non-interactive heading for a group of items, typically preceding a
- * `SkdxContextMenuGroup`. Renders a plain `<div>`.
- */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/context-menu/ContextMenuLabel.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-let e=require("vue");var a={class:"skdx-context-menu__label","data-part":"label"},l=(0,e.defineComponent)({__name:"ContextMenuLabel",setup(_){return(t,n)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",a,[(0,e.renderSlot)(t.$slots,"default")]))}});exports.default=l;
+const n=require("../utils/menuGroup.cjs");let e=require("vue");var r=["id"],l=(0,e.defineComponent)({__name:"ContextMenuLabel",setup(a){const t=n.useMenuLabelId();return(u,_)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{id:(0,e.unref)(t),class:"skdx-context-menu__label","data-part":"label"},[(0,e.renderSlot)(u.$slots,"default")],8,r))}});exports.default=l;

package/dist/context-menu/ContextMenuLabel.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{createElementBlock as e,defineComponent as a,openBlock as t,renderSlot as l}from"vue";var o={class:"skdx-context-menu__label","data-part":"label"},n=/* @__PURE__ */a({__name:"ContextMenuLabel",setup:a=>(a,n)=>(t(),e("div",o,[l(a.$slots,"default")]))});export{n as default};
+import{useMenuLabelId as e}from"../utils/menuGroup.js";import{createElementBlock as a,defineComponent as t,openBlock as s,renderSlot as n,unref as o}from"vue";var l=["id"],r=/* @__PURE__ */t({__name:"ContextMenuLabel",setup(t){const r=e();return(e,t)=>(s(),a("div",{id:o(r),class:"skdx-context-menu__label","data-part":"label"},[n(e.$slots,"default")],8,l))}});export{r as default};

package/dist/context-menu/ContextMenuPortal.vue.d.cts

@@ -1,8 +1,8 @@
 import type { PortalContainer } from '../utils/portal.cjs';
 /**
- * Teleports `SkdxContextMenuContent` to `document.body` (or a custom `container`), so the menu escapes
- * any clipping/`overflow` ancestors. Mounts only while open unless
- * `forceMount` is set. Must be used inside `SkdxContextMenu`.
+ * Teleports `SkdxContextMenuContent` to `document.body` (or custom `container`) to escape
+ * clipping/`overflow` ancestors. Mounts only while open unless `forceMount` is set.
+ * Must be used in `SkdxContextMenu`.
  */
 type __VLS_Props = {
     /**

package/dist/context-menu/ContextMenuPortal.vue.d.ts

@@ -1,8 +1,8 @@
 import type { PortalContainer } from '../utils/portal.js';
 /**
- * Teleports `SkdxContextMenuContent` to `document.body` (or a custom `container`), so the menu escapes
- * any clipping/`overflow` ancestors. Mounts only while open unless
- * `forceMount` is set. Must be used inside `SkdxContextMenu`.
+ * Teleports `SkdxContextMenuContent` to `document.body` (or custom `container`) to escape
+ * clipping/`overflow` ancestors. Mounts only while open unless `forceMount` is set.
+ * Must be used in `SkdxContextMenu`.
  */
 type __VLS_Props = {
     /**

package/dist/context-menu/ContextMenuRadioGroup.vue.d.cts

@@ -1,7 +1,6 @@
 /**
- * Container coordinating a set of mutually-exclusive
- * `SkdxContextMenuRadioItem`s: renders a `<div role="group">` and
- * distributes the selected `value` to its items via context.
+ * Coordinates mutually-exclusive radio items: renders `<div role="group">`
+ * and distributes the selected `value` via context.
  */
 type __VLS_Props = {
     /**
@@ -9,8 +8,6 @@ type __VLS_Props = {
      * `value`. Pair with `v-model:value` or `@value-change`.
      */
     value?: string;
-    /** Initially selected item's value, for uncontrolled usage. */
-    defaultValue?: string;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -24,7 +21,6 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     "onValue-change"?: ((value: string) => any) | undefined;
 }>, {
     value: string;
-    defaultValue: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/context-menu/ContextMenuRadioGroup.vue.d.ts

@@ -1,7 +1,6 @@
 /**
- * Container coordinating a set of mutually-exclusive
- * `SkdxContextMenuRadioItem`s: renders a `<div role="group">` and
- * distributes the selected `value` to its items via context.
+ * Coordinates mutually-exclusive radio items: renders `<div role="group">`
+ * and distributes the selected `value` via context.
  */
 type __VLS_Props = {
     /**
@@ -9,8 +8,6 @@ type __VLS_Props = {
      * `value`. Pair with `v-model:value` or `@value-change`.
      */
     value?: string;
-    /** Initially selected item's value, for uncontrolled usage. */
-    defaultValue?: string;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -24,7 +21,6 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     "onValue-change"?: ((value: string) => any) | undefined;
 }>, {
     value: string;
-    defaultValue: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;