@skdx/vue 0.27.0 → 0.29.0

package/dist/combobox/primitives.d.cts

@@ -0,0 +1,31 @@
+/**
+ * Advanced primitives for `SkdxCombobox` — the parts the recipe composes.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxCombobox, SkdxComboboxContent, SkdxComboboxInput, SkdxComboboxItem, SkdxComboboxPortal } from '@skdx/vue/primitives/combobox';
+ * </script>
+ *
+ * <template>
+ *   <SkdxCombobox v-model:value="value">
+ *     <SkdxComboboxInput aria-label="Framework" />
+ *     <SkdxComboboxPortal>
+ *       <SkdxComboboxContent>
+ *         <SkdxComboboxItem value="ruby">Ruby</SkdxComboboxItem>
+ *       </SkdxComboboxContent>
+ *     </SkdxComboboxPortal>
+ *   </SkdxCombobox>
+ * </template>
+ * ```
+ */
+export { default as SkdxCombobox } from './Combobox.vue.cjs';
+export { default as SkdxComboboxClear } from './ComboboxClear.vue.cjs';
+export { default as SkdxComboboxContent } from './ComboboxContent.vue.cjs';
+export { default as SkdxComboboxEmpty } from './ComboboxEmpty.vue.cjs';
+export { default as SkdxComboboxGroup } from './ComboboxGroup.vue.cjs';
+export { default as SkdxComboboxGroupLabel } from './ComboboxGroupLabel.vue.cjs';
+export { default as SkdxComboboxInput } from './ComboboxInput.vue.cjs';
+export { default as SkdxComboboxItem } from './ComboboxItem.vue.cjs';
+export { default as SkdxComboboxPortal } from './ComboboxPortal.vue.cjs';
+export { default as SkdxComboboxTrigger } from './ComboboxTrigger.vue.cjs';

package/dist/combobox/primitives.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Advanced primitives for `SkdxCombobox` — the parts the recipe composes.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxCombobox, SkdxComboboxContent, SkdxComboboxInput, SkdxComboboxItem, SkdxComboboxPortal } from '@skdx/vue/primitives/combobox';
+ * </script>
+ *
+ * <template>
+ *   <SkdxCombobox v-model:value="value">
+ *     <SkdxComboboxInput aria-label="Framework" />
+ *     <SkdxComboboxPortal>
+ *       <SkdxComboboxContent>
+ *         <SkdxComboboxItem value="ruby">Ruby</SkdxComboboxItem>
+ *       </SkdxComboboxContent>
+ *     </SkdxComboboxPortal>
+ *   </SkdxCombobox>
+ * </template>
+ * ```
+ */
+export { default as SkdxCombobox } from './Combobox.vue.js';
+export { default as SkdxComboboxClear } from './ComboboxClear.vue.js';
+export { default as SkdxComboboxContent } from './ComboboxContent.vue.js';
+export { default as SkdxComboboxEmpty } from './ComboboxEmpty.vue.js';
+export { default as SkdxComboboxGroup } from './ComboboxGroup.vue.js';
+export { default as SkdxComboboxGroupLabel } from './ComboboxGroupLabel.vue.js';
+export { default as SkdxComboboxInput } from './ComboboxInput.vue.js';
+export { default as SkdxComboboxItem } from './ComboboxItem.vue.js';
+export { default as SkdxComboboxPortal } from './ComboboxPortal.vue.js';
+export { default as SkdxComboboxTrigger } from './ComboboxTrigger.vue.js';

package/dist/combobox/primitives.js

@@ -0,0 +1 @@
+import o from"./ComboboxContent.vue.js";import m from"./ComboboxEmpty.vue.js";import b from"./ComboboxGroup.vue.js";import r from"./ComboboxGroupLabel.vue.js";import x from"./ComboboxInput.vue.js";import C from"./ComboboxItem.vue.js";import t from"./ComboboxPortal.vue.js";import e from"./Combobox.vue.js";import s from"./ComboboxClear.vue.js";import p from"./ComboboxTrigger.vue.js";export{e as SkdxCombobox,s as SkdxComboboxClear,o as SkdxComboboxContent,m as SkdxComboboxEmpty,b as SkdxComboboxGroup,r as SkdxComboboxGroupLabel,x as SkdxComboboxInput,C as SkdxComboboxItem,t as SkdxComboboxPortal,p as SkdxComboboxTrigger};

package/dist/command/Command.vue.d.cts

@@ -1,68 +1,80 @@
 import { type CommandFilter } from './context.cjs';
-/**
- * Root of a cmdk-style command palette: owns virtual focus
- * (`aria-activedescendant`-based, so real DOM focus always stays on
- * `SkdxCommandInput`) and item bookkeeping, and hands both down to
- * `SkdxCommandInput` / `SkdxCommandList` / `SkdxCommandEmpty` /
- * `SkdxCommandGroup` / `SkdxCommandItem` / `SkdxCommandLoading` /
- * `SkdxCommandSeparator` via context. Renders a plain `<div>`.
- *
- * Not popper-anchored — mount it inside a `SkdxDialog` for a classic ⌘K
- * palette, or render it standalone.
- *
- * `SkdxCommandInput` writes what the user types into the root's `search`, and
- * the root filters its own items with a case-insensitive substring match on
- * each item's `value`. Pass `filter` to replace the matcher, or
- * `filter="manual"` to go back to mounting only the matching items yourself
- * (matching `SkdxCombobox`). `value` names the highlighted item and is
- * controllable via `v-model:value`, and `loading` mounts `SkdxCommandLoading`
- * while keeping `SkdxCommandEmpty` hidden.
- */
+import type { CommandGroup, CommandItem } from './types.cjs';
+/** Root of a cmdk-style command palette: owns virtual focus and item state, rendering a derived layout or slotted content. */
 type __VLS_Props = {
     /** Value of the highlighted item, for controlled usage via `v-model:value`. */
-    value?: string;
+    value?: string | undefined;
     /** Value of the initially highlighted item, for uncontrolled usage. */
-    defaultValue?: string;
+    defaultValue?: string | undefined;
     /** Current search text, for controlled usage via `v-model:search`. */
-    search?: string;
+    search?: string | undefined;
     /** Initial search text, for uncontrolled usage. */
     defaultSearch?: string;
+    /** Custom matcher run per item — return a boolean to filter or a number to filter and rank; `'manual'` disables filtering. */
+    filter?: CommandFilter | undefined;
     /**
-     * Replaces the built-in matcher (case-insensitive substring on the item's
-     * `value`) — return `true` to keep an item mounted for this search — or
-     * `'manual'` to filter nothing, when the consumer already mounts only the
-     * matching items.
+     * Wraps arrow navigation from the last item back to the first, and vice versa.
+     * @default false
      */
-    filter?: CommandFilter;
+    loop?: boolean;
     /**
-     * Marks results as in flight: `data-loading` on the root and
-     * `aria-busy`/`data-loading` on `SkdxCommandList`, mounts
-     * `SkdxCommandLoading`, and keeps `SkdxCommandEmpty` hidden so an in-flight
-     * search never flashes "No results".
+     * Stops pointer hover from moving the highlight, keeping keyboard navigation in control.
+     * @default false
      */
+    disablePointerSelection?: boolean;
+    /** Marks results as in flight: sets `data-loading`/`aria-busy` and mounts `SkdxCommandLoading` while hiding `SkdxCommandEmpty`. */
     loading?: boolean;
+    /**
+     * The palette's commands, in labelled groups.
+     * @default []
+     */
+    groups?: CommandGroup[];
+    /**
+     * Placeholder text on the derived `SkdxCommandInput`.
+     * @default undefined
+     */
+    placeholder?: string | undefined;
+    /**
+     * Text the derived `SkdxCommandEmpty` shows when a search matches nothing.
+     * @default undefined
+     */
+    emptyMessage?: string | undefined;
+    /**
+     * Text the derived `SkdxCommandLoading` announces while `loading` is set.
+     * @default undefined
+     */
+    loadingMessage?: string | undefined;
 };
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+type __VLS_Slots = {
+    /** Manual composition of the input, list and items, replacing the derived `groups` anatomy. */
+    default?(): unknown;
+    /** Body of a derived item row, for markup its `label` string cannot express. */
+    item?(props: {
+        item: CommandItem;
+    }): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (item: CommandItem) => any;
     "update:value": (value: string) => any;
     "value-change": (value: string) => any;
     "update:search": (search: string) => any;
     "search-change": (search: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:value"?: ((value: string) => any) | undefined;
-    "onValue-change"?: ((value: string) => any) | undefined;
-    "onUpdate:search"?: ((search: string) => any) | undefined;
-    "onSearch-change"?: ((search: string) => any) | undefined;
+    onSelect?: (item: CommandItem) => any;
+    "onUpdate:value"?: (value: string) => any;
+    "onValue-change"?: (value: string) => any;
+    "onUpdate:search"?: (search: string) => any;
+    "onSearch-change"?: (search: string) => any;
 }>, {
+    filter: CommandFilter | undefined;
+    search: string | undefined;
     loading: boolean;
-    filter: CommandFilter;
-    search: string;
-    value: string;
-    defaultValue: string;
+    defaultValue: string | undefined;
+    value: string | undefined;
+    loop: boolean;
+    groups: CommandGroup[];
     defaultSearch: string;
+    disablePointerSelection: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/command/Command.vue.d.ts

@@ -1,68 +1,80 @@
 import { type CommandFilter } from './context.js';
-/**
- * Root of a cmdk-style command palette: owns virtual focus
- * (`aria-activedescendant`-based, so real DOM focus always stays on
- * `SkdxCommandInput`) and item bookkeeping, and hands both down to
- * `SkdxCommandInput` / `SkdxCommandList` / `SkdxCommandEmpty` /
- * `SkdxCommandGroup` / `SkdxCommandItem` / `SkdxCommandLoading` /
- * `SkdxCommandSeparator` via context. Renders a plain `<div>`.
- *
- * Not popper-anchored — mount it inside a `SkdxDialog` for a classic ⌘K
- * palette, or render it standalone.
- *
- * `SkdxCommandInput` writes what the user types into the root's `search`, and
- * the root filters its own items with a case-insensitive substring match on
- * each item's `value`. Pass `filter` to replace the matcher, or
- * `filter="manual"` to go back to mounting only the matching items yourself
- * (matching `SkdxCombobox`). `value` names the highlighted item and is
- * controllable via `v-model:value`, and `loading` mounts `SkdxCommandLoading`
- * while keeping `SkdxCommandEmpty` hidden.
- */
+import type { CommandGroup, CommandItem } from './types.js';
+/** Root of a cmdk-style command palette: owns virtual focus and item state, rendering a derived layout or slotted content. */
 type __VLS_Props = {
     /** Value of the highlighted item, for controlled usage via `v-model:value`. */
-    value?: string;
+    value?: string | undefined;
     /** Value of the initially highlighted item, for uncontrolled usage. */
-    defaultValue?: string;
+    defaultValue?: string | undefined;
     /** Current search text, for controlled usage via `v-model:search`. */
-    search?: string;
+    search?: string | undefined;
     /** Initial search text, for uncontrolled usage. */
     defaultSearch?: string;
+    /** Custom matcher run per item — return a boolean to filter or a number to filter and rank; `'manual'` disables filtering. */
+    filter?: CommandFilter | undefined;
     /**
-     * Replaces the built-in matcher (case-insensitive substring on the item's
-     * `value`) — return `true` to keep an item mounted for this search — or
-     * `'manual'` to filter nothing, when the consumer already mounts only the
-     * matching items.
+     * Wraps arrow navigation from the last item back to the first, and vice versa.
+     * @default false
      */
-    filter?: CommandFilter;
+    loop?: boolean;
     /**
-     * Marks results as in flight: `data-loading` on the root and
-     * `aria-busy`/`data-loading` on `SkdxCommandList`, mounts
-     * `SkdxCommandLoading`, and keeps `SkdxCommandEmpty` hidden so an in-flight
-     * search never flashes "No results".
+     * Stops pointer hover from moving the highlight, keeping keyboard navigation in control.
+     * @default false
      */
+    disablePointerSelection?: boolean;
+    /** Marks results as in flight: sets `data-loading`/`aria-busy` and mounts `SkdxCommandLoading` while hiding `SkdxCommandEmpty`. */
     loading?: boolean;
+    /**
+     * The palette's commands, in labelled groups.
+     * @default []
+     */
+    groups?: CommandGroup[];
+    /**
+     * Placeholder text on the derived `SkdxCommandInput`.
+     * @default undefined
+     */
+    placeholder?: string | undefined;
+    /**
+     * Text the derived `SkdxCommandEmpty` shows when a search matches nothing.
+     * @default undefined
+     */
+    emptyMessage?: string | undefined;
+    /**
+     * Text the derived `SkdxCommandLoading` announces while `loading` is set.
+     * @default undefined
+     */
+    loadingMessage?: string | undefined;
 };
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+type __VLS_Slots = {
+    /** Manual composition of the input, list and items, replacing the derived `groups` anatomy. */
+    default?(): unknown;
+    /** Body of a derived item row, for markup its `label` string cannot express. */
+    item?(props: {
+        item: CommandItem;
+    }): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (item: CommandItem) => any;
     "update:value": (value: string) => any;
     "value-change": (value: string) => any;
     "update:search": (search: string) => any;
     "search-change": (search: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:value"?: ((value: string) => any) | undefined;
-    "onValue-change"?: ((value: string) => any) | undefined;
-    "onUpdate:search"?: ((search: string) => any) | undefined;
-    "onSearch-change"?: ((search: string) => any) | undefined;
+    onSelect?: (item: CommandItem) => any;
+    "onUpdate:value"?: (value: string) => any;
+    "onValue-change"?: (value: string) => any;
+    "onUpdate:search"?: (search: string) => any;
+    "onSearch-change"?: (search: string) => any;
 }>, {
+    filter: CommandFilter | undefined;
+    search: string | undefined;
     loading: boolean;
-    filter: CommandFilter;
-    search: string;
-    value: string;
-    defaultValue: string;
+    defaultValue: string | undefined;
+    value: string | undefined;
+    loop: boolean;
+    groups: CommandGroup[];
     defaultSearch: string;
+    disablePointerSelection: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/command/Command.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const d=require("./context.cjs");let a=require("vue");var w=["data-loading"],y=(0,a.defineComponent)({__name:"Command",props:{value:{default:void 0},defaultValue:{default:void 0},search:{default:void 0},defaultSearch:{default:""},filter:{type:[String,Function],default:void 0},loading:{type:Boolean,default:!1}},emits:["update:value","value-change","update:search","search-change"],setup(s,{emit:p}){const t=s,r=p,i=(0,a.ref)(null),u=(0,a.ref)(null),l=(0,a.ref)(new Set),v=(0,a.ref)(new Map),f=(0,a.ref)(t.defaultValue??""),o=(0,a.computed)(()=>t.value===void 0?f.value:t.value),m=(0,a.ref)(t.defaultSearch),c=(0,a.computed)(()=>t.search===void 0?m.value:t.search);function g(e){o.value!==e&&(t.value===void 0&&(f.value=e),r("update:value",e),r("value-change",e))}function S(e){c.value!==e&&(t.search===void 0&&(m.value=e),r("update:search",e),r("search-change",e))}function _(e){return t.filter==="manual"||c.value===""?!0:(typeof t.filter=="function"?t.filter:d.defaultCommandFilter)(e,c.value)}function h(e){u.value=e,g(e?v.value.get(e)?.value??"":"")}function C(e){if(l.value.has(e))return;const n=new Set(l.value);n.add(e),l.value=n}function I(e){if(!l.value.has(e))return;const n=new Set(l.value);n.delete(e),l.value=n,u.value===e&&(u.value=null)}return(0,a.watch)(l,()=>{if(u.value&&l.value.has(u.value))return;const e=i.value?.querySelector(d.OPTION_SELECTOR);h(e?.id??null)},{flush:"post"}),(0,a.watch)([o,u],()=>{if(!o.value||u.value&&v.value.get(u.value)?.value===o.value)return;const e=i.value?.querySelector(`[role="option"][data-value="${CSS.escape(o.value)}"]`);e&&(u.value=e.id)},{flush:"post"}),(0,a.provide)(d.COMMAND_CONTEXT,{listRef:i,listId:d.nextCommandListId(),activeId:u,setActiveId:h,itemMetaRef:v,registerItem:C,unregisterItem:I,itemCount:(0,a.computed)(()=>l.value.size),search:c,setSearch:S,matches:_,loading:(0,a.computed)(()=>t.loading)}),(e,n)=>((0,a.openBlock)(),(0,a.createElementBlock)("div",{class:"skdx-command","data-part":"root","data-skdx-component":"command","data-loading":s.loading?"":void 0},[(0,a.renderSlot)(e.$slots,"default")],8,w))}});exports.default=y;
+const I=require("../utils/scoredFilter.cjs"),d=require("./context.cjs"),k=require("./CommandAnatomy.vue.cjs");let t=require("vue");var P=["data-loading"],T=(0,t.defineComponent)({__name:"Command",props:{value:{default:void 0},defaultValue:{default:void 0},search:{default:void 0},defaultSearch:{default:""},filter:{type:[String,Function],default:void 0},loop:{type:Boolean,default:!1},disablePointerSelection:{type:Boolean,default:!1},loading:{type:Boolean,default:!1},groups:{default:()=>[]},placeholder:{},emptyMessage:{},loadingMessage:{}},emits:["update:value","value-change","update:search","search-change","select"],setup(i,{emit:q}){const l=i,c=q,f=(0,t.ref)(null),u=(0,t.ref)(null),n=(0,t.ref)(new Set),v=(0,t.ref)(new Map),g=(0,t.ref)(l.defaultValue??""),r=(0,t.computed)(()=>l.value===void 0?g.value:l.value),h=(0,t.ref)(l.defaultSearch),s=(0,t.computed)(()=>l.search===void 0?h.value:l.search);function _(e){r.value!==e&&(l.value===void 0&&(g.value=e),c("update:value",e),c("value-change",e))}function b(e){s.value!==e&&(l.search===void 0&&(h.value=e),c("update:search",e),c("search-change",e))}function B(e,a){return l.filter==="manual"||s.value===""?!0:I.filterKeeps((typeof l.filter=="function"?l.filter:d.defaultCommandFilter)(e,s.value,a))}function M(e){if(l.filter==="manual"||s.value==="")return null;const a=v.value.get(e);if(!a)return null;const o=(typeof l.filter=="function"?l.filter:d.defaultCommandFilter)(a.value,s.value,a.keywords);return typeof o=="number"?o:null}function m(){const e=f.value;return e?I.orderByScore(e,d.OPTION_SELECTOR,M):[]}(0,t.watch)([n,s,()=>l.filter],()=>m(),{flush:"post"});function p(e,a){if(!e.contains(a))return;const o=e.getBoundingClientRect(),y=a.getBoundingClientRect(),C=y.top-o.top,w=y.bottom-o.bottom;C<0?e.scrollTop+=C:w>0&&(e.scrollTop+=w)}function S(e){u.value=e,_(e?v.value.get(e)?.value??"":"")}function R(e){if(n.value.has(e))return;const a=new Set(n.value);a.add(e),n.value=a}function O(e){if(!n.value.has(e))return;const a=new Set(n.value);a.delete(e),n.value=a,u.value===e&&(u.value=null)}return(0,t.watch)([n,r],()=>{if(u.value&&n.value.has(u.value))return;const e=f.value,a=r.value?e?.querySelector(`[role="option"][data-value="${CSS.escape(r.value)}"]`):null;if(a){u.value=a.id,e&&p(e,a);return}const o=m()[0];S(o?.id??null),e&&o&&p(e,o)},{flush:"post"}),(0,t.watch)([r,u],()=>{if(!r.value||u.value&&v.value.get(u.value)?.value===r.value)return;const e=f.value,a=e?.querySelector(`[role="option"][data-value="${CSS.escape(r.value)}"]`);a&&(u.value=a.id,e&&p(e,a))},{flush:"post"}),(0,t.provide)(d.COMMAND_CONTEXT,{listRef:f,listId:d.nextCommandListId(),activeId:u,setActiveId:S,itemMetaRef:v,registerItem:R,unregisterItem:O,itemCount:(0,t.computed)(()=>n.value.size),search:s,setSearch:b,matches:B,orderedOptions:m,loop:(0,t.computed)(()=>l.loop),disablePointerSelection:(0,t.computed)(()=>l.disablePointerSelection),loading:(0,t.computed)(()=>l.loading)}),(e,a)=>((0,t.openBlock)(),(0,t.createElementBlock)("div",{class:"skdx-command","data-part":"root","data-skdx-component":"command","data-loading":i.loading?"":void 0},[(0,t.renderSlot)(e.$slots,"default",{},()=>[(0,t.createVNode)(k.default,{groups:l.groups,placeholder:i.placeholder,"empty-message":i.emptyMessage,"loading-message":i.loadingMessage,"on-item-select":o=>c("select",o)},(0,t.createSlots)({_:2},[e.$slots.item?{name:"item",fn:(0,t.withCtx)(o=>[(0,t.renderSlot)(e.$slots,"item",(0,t.normalizeProps)((0,t.guardReactiveProps)(o)))]),key:"0"}:void 0]),1032,["groups","placeholder","empty-message","loading-message","on-item-select"])])],8,P))}});exports.default=T;

package/dist/command/Command.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{COMMAND_CONTEXT as e,OPTION_SELECTOR as a,defaultCommandFilter as t,nextCommandListId as l}from"./context.js";import{computed as u,createElementBlock as n,defineComponent as o,openBlock as d,provide as v,ref as s,renderSlot as i,watch as r}from"vue";var c=["data-loading"],f=/* @__PURE__ */o({__name:"Command",props:{value:{default:void 0},defaultValue:{default:void 0},search:{default:void 0},defaultSearch:{default:""},filter:{type:[String,Function],default:void 0},loading:{type:Boolean,default:!1}},emits:["update:value","value-change","update:search","search-change"],setup(o,{emit:f}){const m=o,p=f,h=s(null),g=s(null),S=s(/* @__PURE__ */new Set),C=s(/* @__PURE__ */new Map),I=s(m.defaultValue??""),w=u(()=>void 0===m.value?I.value:m.value),x=s(m.defaultSearch),y=u(()=>void 0===m.search?x.value:m.search);function O(e){g.value=e,function(e){w.value!==e&&(void 0===m.value&&(I.value=e),p("update:value",e),p("value-change",e))}(e?C.value.get(e)?.value??"":"")}return r(S,()=>{if(g.value&&S.value.has(g.value))return;const e=h.value?.querySelector(a);O(e?.id??null)},{flush:"post"}),r([w,g],()=>{if(!w.value||g.value&&C.value.get(g.value)?.value===w.value)return;const e=h.value?.querySelector(`[role="option"][data-value="${CSS.escape(w.value)}"]`);e&&(g.value=e.id)},{flush:"post"}),v(e,{listRef:h,listId:l(),activeId:g,setActiveId:O,itemMetaRef:C,registerItem:function(e){if(S.value.has(e))return;const a=new Set(S.value);a.add(e),S.value=a},unregisterItem:function(e){if(!S.value.has(e))return;const a=new Set(S.value);a.delete(e),S.value=a,g.value===e&&(g.value=null)},itemCount:u(()=>S.value.size),search:y,setSearch:function(e){y.value!==e&&(void 0===m.search&&(x.value=e),p("update:search",e),p("search-change",e))},matches:function(e){return"manual"===m.filter||""===y.value||("function"==typeof m.filter?m.filter:t)(e,y.value)},loading:u(()=>m.loading)}),(e,a)=>(d(),n("div",{class:"skdx-command","data-part":"root","data-skdx-component":"command","data-loading":o.loading?"":void 0},[i(e.$slots,"default")],8,c))}});export{f as default};
+import{filterKeeps as e,orderByScore as a}from"../utils/scoredFilter.js";import{COMMAND_CONTEXT as t,OPTION_SELECTOR as l,defaultCommandFilter as o,nextCommandListId as u}from"./context.js";import n from"./CommandAnatomy.vue.js";import{computed as s,createElementBlock as r,createSlots as i,createVNode as d,defineComponent as c,guardReactiveProps as v,normalizeProps as f,openBlock as p,provide as m,ref as g,renderSlot as h,watch as S,withCtx as y}from"vue";var C=["data-loading"],B=/* @__PURE__ */c({__name:"Command",props:{value:{default:void 0},defaultValue:{default:void 0},search:{default:void 0},defaultSearch:{default:""},filter:{type:[String,Function],default:void 0},loop:{type:Boolean,default:!1},disablePointerSelection:{type:Boolean,default:!1},loading:{type:Boolean,default:!1},groups:{default:()=>[]},placeholder:{},emptyMessage:{},loadingMessage:{}},emits:["update:value","value-change","update:search","search-change","select"],setup(c,{emit:B}){const M=c,w=B,I=g(null),b=g(null),k=g(/* @__PURE__ */new Set),x=g(/* @__PURE__ */new Map),O=g(M.defaultValue??""),P=s(()=>void 0===M.value?O.value:M.value),R=g(M.defaultSearch),T=s(()=>void 0===M.search?R.value:M.search);function $(e){if("manual"===M.filter||""===T.value)return null;const a=x.value.get(e);if(!a)return null;const t=("function"==typeof M.filter?M.filter:o)(a.value,T.value,a.keywords);return"number"==typeof t?t:null}function _(){const e=I.value;return e?a(e,l,$):[]}function E(e,a){if(!e.contains(a))return;const t=e.getBoundingClientRect(),l=a.getBoundingClientRect(),o=l.top-t.top,u=l.bottom-t.bottom;o<0?e.scrollTop+=o:u>0&&(e.scrollTop+=u)}function N(e){b.value=e,function(e){P.value!==e&&(void 0===M.value&&(O.value=e),w("update:value",e),w("value-change",e))}(e?x.value.get(e)?.value??"":"")}return S([k,T,()=>M.filter],()=>_(),{flush:"post"}),S([k,P],()=>{if(b.value&&k.value.has(b.value))return;const e=I.value,a=P.value?e?.querySelector(`[role="option"][data-value="${CSS.escape(P.value)}"]`):null;if(a)return b.value=a.id,void(e&&E(e,a));const t=_()[0];N(t?.id??null),e&&t&&E(e,t)},{flush:"post"}),S([P,b],()=>{if(!P.value||b.value&&x.value.get(b.value)?.value===P.value)return;const e=I.value,a=e?.querySelector(`[role="option"][data-value="${CSS.escape(P.value)}"]`);a&&(b.value=a.id,e&&E(e,a))},{flush:"post"}),m(t,{listRef:I,listId:u(),activeId:b,setActiveId:N,itemMetaRef:x,registerItem:function(e){if(k.value.has(e))return;const a=new Set(k.value);a.add(e),k.value=a},unregisterItem:function(e){if(!k.value.has(e))return;const a=new Set(k.value);a.delete(e),k.value=a,b.value===e&&(b.value=null)},itemCount:s(()=>k.value.size),search:T,setSearch:function(e){T.value!==e&&(void 0===M.search&&(R.value=e),w("update:search",e),w("search-change",e))},matches:function(a,t){return"manual"===M.filter||""===T.value||e(("function"==typeof M.filter?M.filter:o)(a,T.value,t))},orderedOptions:_,loop:s(()=>M.loop),disablePointerSelection:s(()=>M.disablePointerSelection),loading:s(()=>M.loading)}),(e,a)=>(p(),r("div",{class:"skdx-command","data-part":"root","data-skdx-component":"command","data-loading":c.loading?"":void 0},[h(e.$slots,"default",{},()=>[d(n,{groups:M.groups,placeholder:c.placeholder,"empty-message":c.emptyMessage,"loading-message":c.loadingMessage,"on-item-select":e=>w("select",e)},i({_:2},[e.$slots.item?{name:"item",fn:y(a=>[h(e.$slots,"item",f(v(a)))]),key:"0"}:void 0]),1032,["groups","placeholder","empty-message","loading-message","on-item-select"])])],8,C))}});export{B as default};

package/dist/command/CommandAnatomy.vue.cjs

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

package/dist/command/CommandAnatomy.vue.d.cts

@@ -0,0 +1,25 @@
+import type { CommandGroup, CommandItem } from './types.cjs';
+/**
+ * Default anatomy for `SkdxCommand`: search input, listbox, empty and loading states.
+ * @internal
+ */
+type __VLS_Props = {
+    groups: CommandGroup[];
+    placeholder?: string | undefined;
+    emptyMessage?: string | undefined;
+    loadingMessage?: string | undefined;
+    onItemSelect?: (item: CommandItem) => void;
+};
+type __VLS_Slots = {
+    item?(props: {
+        item: CommandItem;
+    }): 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/command/CommandAnatomy.vue.d.ts

@@ -0,0 +1,25 @@
+import type { CommandGroup, CommandItem } from './types.js';
+/**
+ * Default anatomy for `SkdxCommand`: search input, listbox, empty and loading states.
+ * @internal
+ */
+type __VLS_Props = {
+    groups: CommandGroup[];
+    placeholder?: string | undefined;
+    emptyMessage?: string | undefined;
+    loadingMessage?: string | undefined;
+    onItemSelect?: (item: CommandItem) => void;
+};
+type __VLS_Slots = {
+    item?(props: {
+        item: CommandItem;
+    }): 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/command/CommandAnatomy.vue.js

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

package/dist/command/CommandAnatomy.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const i=require("../utils/injectRequired.cjs"),m=require("./context.cjs"),k=require("./CommandEmpty.vue.cjs"),y=require("./CommandGroup.vue.cjs"),C=require("./CommandInput.vue.cjs"),d=require("./CommandItem.vue.cjs"),b=require("./CommandList.vue.cjs"),B=require("./CommandLoading.vue.cjs");let e=require("vue");var g=(0,e.defineComponent)({__name:"CommandAnatomy",props:{groups:{},placeholder:{},emptyMessage:{},loadingMessage:{},onItemSelect:{type:Function}},setup(l){function o(a,r){a.onSelect?.(),r?.(a)}const c=i.injectRequired(m.COMMAND_CONTEXT,"SkdxCommandAnatomy must be used within SkdxCommand.");function u(a){return a.label!=null&&!a.items.some(r=>c.matches(r.value??r.label,r.keywords))}return(a,r)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,null,[(0,e.createVNode)(C.default,{placeholder:l.placeholder},null,8,["placeholder"]),(0,e.createVNode)(b.default,{"aria-label":l.placeholder},{default:(0,e.withCtx)(()=>[((0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,null,(0,e.renderList)(l.groups,(n,s)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,{key:n.label??s},[n.label&&!u(n)?((0,e.openBlock)(),(0,e.createBlock)(y.default,{key:0,heading:n.label},{default:(0,e.withCtx)(()=>[((0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,null,(0,e.renderList)(n.items,t=>((0,e.openBlock)(),(0,e.createBlock)(d.default,{key:t.value??t.label,value:t.value??t.label,keywords:t.keywords,disabled:t.disabled,onSelect:()=>o(t,l.onItemSelect)},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(a.$slots,"item",{item:t},()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.label),1)])]),_:2},1032,["value","keywords","disabled","onSelect"]))),128))]),_:2},1032,["heading"])):((0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,{key:1},(0,e.renderList)(n.items,t=>((0,e.openBlock)(),(0,e.createBlock)(d.default,{key:t.value??t.label,value:t.value??t.label,keywords:t.keywords,disabled:t.disabled,onSelect:()=>o(t,l.onItemSelect)},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(a.$slots,"item",{item:t},()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.label),1)])]),_:2},1032,["value","keywords","disabled","onSelect"]))),128))],64))),128))]),_:3},8,["aria-label"]),l.loadingMessage?((0,e.openBlock)(),(0,e.createBlock)(B.default,{key:0},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(l.loadingMessage),1)]),_:1})):(0,e.createCommentVNode)("",!0),l.emptyMessage?((0,e.openBlock)(),(0,e.createBlock)(k.default,{key:1},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(l.emptyMessage),1)]),_:1})):(0,e.createCommentVNode)("",!0)],64))}});exports.default=g;

package/dist/command/CommandAnatomy.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{injectRequired as e}from"../utils/injectRequired.js";import{COMMAND_CONTEXT as a}from"./context.js";import l from"./CommandEmpty.vue.js";import o from"./CommandGroup.vue.js";import t from"./CommandInput.vue.js";import s from"./CommandItem.vue.js";import m from"./CommandList.vue.js";import d from"./CommandLoading.vue.js";import{Fragment as n,createBlock as r,createCommentVNode as i,createElementBlock as u,createTextVNode as p,createVNode as c,defineComponent as y,openBlock as b,renderList as f,renderSlot as k,toDisplayString as v,withCtx as g}from"vue";var C=/* @__PURE__ */y({__name:"CommandAnatomy",props:{groups:{},placeholder:{},emptyMessage:{},loadingMessage:{},onItemSelect:{type:Function}},setup(y){function C(e,a){e.onSelect?.(),a?.(e)}const S=e(a,"SkdxCommandAnatomy must be used within SkdxCommand.");function h(e){return null!=e.label&&!e.items.some(e=>S.matches(e.value??e.label,e.keywords))}return(e,a)=>(b(),u(n,null,[c(t,{placeholder:y.placeholder},null,8,["placeholder"]),c(m,{"aria-label":y.placeholder},{default:g(()=>[(b(!0),u(n,null,f(y.groups,(a,l)=>(b(),u(n,{key:a.label??l},[a.label&&!h(a)?(b(),r(o,{key:0,heading:a.label},{default:g(()=>[(b(!0),u(n,null,f(a.items,a=>(b(),r(s,{key:a.value??a.label,value:a.value??a.label,keywords:a.keywords,disabled:a.disabled,onSelect:()=>C(a,y.onItemSelect)},{default:g(()=>[k(e.$slots,"item",{item:a},()=>[p(v(a.label),1)])]),_:2},1032,["value","keywords","disabled","onSelect"]))),128))]),_:2},1032,["heading"])):(b(!0),u(n,{key:1},f(a.items,a=>(b(),r(s,{key:a.value??a.label,value:a.value??a.label,keywords:a.keywords,disabled:a.disabled,onSelect:()=>C(a,y.onItemSelect)},{default:g(()=>[k(e.$slots,"item",{item:a},()=>[p(v(a.label),1)])]),_:2},1032,["value","keywords","disabled","onSelect"]))),128))],64))),128))]),_:3},8,["aria-label"]),y.loadingMessage?(b(),r(d,{key:0},{default:g(()=>[p(v(y.loadingMessage),1)]),_:1})):i("",!0),y.emptyMessage?(b(),r(l,{key:1},{default:g(()=>[p(v(y.emptyMessage),1)]),_:1})):i("",!0)],64))}});export{C as default};

package/dist/command/CommandEmpty.vue.d.cts

@@ -1,11 +1,4 @@
-/**
- * Renders its children (typically "No results found") only when zero
- * `SkdxCommandItem`s are currently mounted inside `SkdxCommandList` — i.e. when
- * the search (or the consumer's own filtering) leaves nothing to show, and
- * never while the root is `loading`: an in-flight search that flashes
- * "No results" and then fills in is worse than showing nothing. Renders
- * `role="presentation"`. Must be used inside `SkdxCommand`.
- */
+/** Renders its children only when zero items are mounted and the root isn't loading, avoiding a "No results" flash. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/command/CommandEmpty.vue.d.ts

@@ -1,11 +1,4 @@
-/**
- * Renders its children (typically "No results found") only when zero
- * `SkdxCommandItem`s are currently mounted inside `SkdxCommandList` — i.e. when
- * the search (or the consumer's own filtering) leaves nothing to show, and
- * never while the root is `loading`: an in-flight search that flashes
- * "No results" and then fills in is worse than showing nothing. Renders
- * `role="presentation"`. Must be used inside `SkdxCommand`.
- */
+/** Renders its children only when zero items are mounted and the root isn't loading, avoiding a "No results" flash. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/command/CommandEmpty.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const r=require("./context.cjs");let e=require("vue");var o={key:0,class:"skdx-command__empty","data-part":"empty",role:"presentation"},a=(0,e.defineComponent)({__name:"CommandEmpty",setup(m){const t=(0,e.inject)(r.COMMAND_CONTEXT);if(!t)throw new Error("SkdxCommandEmpty must be used within SkdxCommand.");return(n,u)=>!(0,e.unref)(t).loading.value&&(0,e.unref)(t).itemCount.value===0?((0,e.openBlock)(),(0,e.createElementBlock)("div",o,[(0,e.renderSlot)(n.$slots,"default")])):(0,e.createCommentVNode)("",!0)}});exports.default=a;
+const n=require("../utils/injectRequired.cjs"),u=require("./context.cjs");let e=require("vue");var a={key:0,class:"skdx-command__empty","data-part":"empty",role:"presentation"},o=(0,e.defineComponent)({__name:"CommandEmpty",setup(m){const t=n.injectRequired(u.COMMAND_CONTEXT,"SkdxCommandEmpty must be used within SkdxCommand.");return(r,d)=>!(0,e.unref)(t).loading.value&&(0,e.unref)(t).itemMetaRef.value.size===0?((0,e.openBlock)(),(0,e.createElementBlock)("div",a,[(0,e.renderSlot)(r.$slots,"default")])):(0,e.createCommentVNode)("",!0)}});exports.default=o;

package/dist/command/CommandEmpty.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{COMMAND_CONTEXT as e}from"./context.js";import{createCommentVNode as t,createElementBlock as a,defineComponent as o,inject as m,openBlock as n,renderSlot as r,unref as s}from"vue";var d={key:0,class:"skdx-command__empty","data-part":"empty",role:"presentation"},l=/* @__PURE__ */o({__name:"CommandEmpty",setup(o){const l=m(e);if(!l)throw new Error("SkdxCommandEmpty must be used within SkdxCommand.");return(e,o)=>s(l).loading.value||0!==s(l).itemCount.value?t("",!0):(n(),a("div",d,[r(e.$slots,"default")]))}});export{l as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{COMMAND_CONTEXT as t}from"./context.js";import{createCommentVNode as a,createElementBlock as m,defineComponent as o,openBlock as s,renderSlot as n,unref as r}from"vue";var d={key:0,class:"skdx-command__empty","data-part":"empty",role:"presentation"},i=/* @__PURE__ */o({__name:"CommandEmpty",setup(o){const i=e(t,"SkdxCommandEmpty must be used within SkdxCommand.");return(e,t)=>r(i).loading.value||0!==r(i).itemMetaRef.value.size?a("",!0):(s(),m("div",d,[n(e.$slots,"default")]))}});export{i as default};

package/dist/command/CommandGroup.vue.d.cts

@@ -1,20 +1,14 @@
-/**
- * Labelled cluster of `SkdxCommandItem`s: renders a `<div role="group">` with
- * an optional non-interactive heading above the items, via the `heading`
- * slot.
- */
+/** Labelled cluster of command items, rendered as a non-interactive `<div role="group">` named by its heading. */
 type __VLS_Props = {
     /**
-     * Non-interactive heading rendered above the group's items.
-     * @default undefined — no heading rendered.
+     * Non-interactive heading rendered above the group's items and used as its accessible name.
+     * @default undefined
      */
     heading?: string;
 };
-declare var __VLS_1: {}, __VLS_3: {};
+declare var __VLS_1: {};
 type __VLS_Slots = {} & {
-    heading?: (props: typeof __VLS_1) => any;
-} & {
-    default?: (props: typeof __VLS_3) => any;
+    default?: (props: typeof __VLS_1) => any;
 };
 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>;

package/dist/command/CommandGroup.vue.d.ts

@@ -1,20 +1,14 @@
-/**
- * Labelled cluster of `SkdxCommandItem`s: renders a `<div role="group">` with
- * an optional non-interactive heading above the items, via the `heading`
- * slot.
- */
+/** Labelled cluster of command items, rendered as a non-interactive `<div role="group">` named by its heading. */
 type __VLS_Props = {
     /**
-     * Non-interactive heading rendered above the group's items.
-     * @default undefined — no heading rendered.
+     * Non-interactive heading rendered above the group's items and used as its accessible name.
+     * @default undefined
      */
     heading?: string;
 };
-declare var __VLS_1: {}, __VLS_3: {};
+declare var __VLS_1: {};
 type __VLS_Slots = {} & {
-    heading?: (props: typeof __VLS_1) => any;
-} & {
-    default?: (props: typeof __VLS_3) => any;
+    default?: (props: typeof __VLS_1) => any;
 };
 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>;

package/dist/command/CommandGroup.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-let e=require("vue");var r={class:"skdx-command__group","data-part":"group",role:"group"},a={key:0,role:"presentation"},n=(0,e.defineComponent)({__name:"CommandGroup",props:{heading:{}},setup(o){return(t,d)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",r,[o.heading!==void 0||t.$slots.heading?((0,e.openBlock)(),(0,e.createElementBlock)("div",a,[(0,e.renderSlot)(t.$slots,"heading",{},()=>[(0,e.createTextVNode)((0,e.toDisplayString)(o.heading),1)])])):(0,e.createCommentVNode)("",!0),(0,e.renderSlot)(t.$slots,"default")]))}});exports.default=n;
+const d=require("./context.cjs");let e=require("vue");var l=["aria-labelledby"],u=["id"],i=(0,e.defineComponent)({__name:"CommandGroup",props:{heading:{}},setup(a){const t=a,o=d.nextCommandGroupHeadingId(),r=(0,e.computed)(()=>t.heading!==void 0);return(n,p)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-command__group","data-part":"group",role:"group","aria-labelledby":r.value?(0,e.unref)(o):void 0},[r.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,id:(0,e.unref)(o),class:"skdx-command__group-label","data-part":"group-label",role:"presentation"},(0,e.toDisplayString)(a.heading),9,u)):(0,e.createCommentVNode)("",!0),(0,e.renderSlot)(n.$slots,"default")],8,l))}});exports.default=i;

package/dist/command/CommandGroup.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{createCommentVNode as e,createElementBlock as a,createTextVNode as o,defineComponent as t,openBlock as s,renderSlot as r,toDisplayString as d}from"vue";var n={class:"skdx-command__group","data-part":"group",role:"group"},p={key:0,role:"presentation"},i=/* @__PURE__ */t({__name:"CommandGroup",props:{heading:{}},setup:t=>(i,l)=>(s(),a("div",n,[void 0!==t.heading||i.$slots.heading?(s(),a("div",p,[r(i.$slots,"heading",{},()=>[o(d(t.heading),1)])])):e("",!0),r(i.$slots,"default")]))});export{i as default};
+import{nextCommandGroupHeadingId as a}from"./context.js";import{computed as e,createCommentVNode as o,createElementBlock as r,defineComponent as d,openBlock as t,renderSlot as l,toDisplayString as n,unref as s}from"vue";var p=["aria-labelledby"],i=["id"],m=/* @__PURE__ */d({__name:"CommandGroup",props:{heading:{}},setup(d){const m=d,u=a(),c=e(()=>void 0!==m.heading);return(a,e)=>(t(),r("div",{class:"skdx-command__group","data-part":"group",role:"group","aria-labelledby":c.value?s(u):void 0},[c.value?(t(),r("div",{key:0,id:s(u),class:"skdx-command__group-label","data-part":"group-label",role:"presentation"},n(d.heading),9,i)):o("",!0),l(a.$slots,"default")],8,p))}});export{m as default};

package/dist/command/CommandInput.vue.d.cts

@@ -1,16 +1,9 @@
-/**
- * The palette's search/filter field: a plain `<input type="text">` wired to
- * `SkdxCommandList` via `aria-controls` and to the currently highlighted item
- * via `aria-activedescendant`. Handles Arrow Up/Down to move the virtual
- * highlight across whichever `SkdxCommandItem`s are currently mounted, and
- * Enter to invoke the highlighted item's `onSelect`. Real DOM focus stays
- * here at all times — filtering the item list as the user types does not
- * need to move focus. Must be used inside `SkdxCommand`.
- *
- * Every keystroke also writes into the root's `search`, which is what drives
- * the root's own filtering. Binding `:value`/`@input` here still works: the
- * consumer's handler runs alongside, not instead of, that.
- */
+/** Search/filter field wired via `aria-controls`/`aria-activedescendant`, handling arrow-key highlight and Enter to select. */
 type __VLS_Props = {};
-declare const _default: 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: import("vue").DefineComponent<__VLS_Props, {
+    /** Moves keyboard focus onto the underlying native search input. */
+    focus: (options?: FocusOptions) => void | undefined;
+    /** The underlying native `<input>` element, for focus and measurement. */
+    el: import("vue").Ref<HTMLInputElement | null, HTMLInputElement | null>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/command/CommandInput.vue.d.ts

@@ -1,16 +1,9 @@
-/**
- * The palette's search/filter field: a plain `<input type="text">` wired to
- * `SkdxCommandList` via `aria-controls` and to the currently highlighted item
- * via `aria-activedescendant`. Handles Arrow Up/Down to move the virtual
- * highlight across whichever `SkdxCommandItem`s are currently mounted, and
- * Enter to invoke the highlighted item's `onSelect`. Real DOM focus stays
- * here at all times — filtering the item list as the user types does not
- * need to move focus. Must be used inside `SkdxCommand`.
- *
- * Every keystroke also writes into the root's `search`, which is what drives
- * the root's own filtering. Binding `:value`/`@input` here still works: the
- * consumer's handler runs alongside, not instead of, that.
- */
+/** Search/filter field wired via `aria-controls`/`aria-activedescendant`, handling arrow-key highlight and Enter to select. */
 type __VLS_Props = {};
-declare const _default: 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: import("vue").DefineComponent<__VLS_Props, {
+    /** Moves keyboard focus onto the underlying native search input. */
+    focus: (options?: FocusOptions) => void | undefined;
+    /** The underlying native `<input>` element, for focus and measurement. */
+    el: import("vue").Ref<HTMLInputElement | null, HTMLInputElement | null>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/command/CommandInput.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const c=require("./context.cjs");let a=require("vue");var f=["aria-controls","aria-activedescendant"],p=(0,a.defineComponent)({__name:"CommandInput",setup(v){const o=(0,a.inject)(c.COMMAND_CONTEXT);if(!o)throw new Error("SkdxCommandInput must be used within SkdxCommand.");const t=o;function u(e){const n=t.listRef.value;if(!n)return;const r=Array.from(n.querySelectorAll(c.OPTION_SELECTOR));if(r.length===0)return;let i=r.findIndex(s=>s.id===t.activeId.value)+e;i<0&&(i=0),i>=r.length&&(i=r.length-1),t.setActiveId(r[i].id)}function l(e){t.setSearch(e.target.value)}function d(e){if(e.key==="ArrowDown")e.preventDefault(),u(1);else if(e.key==="ArrowUp")e.preventDefault(),u(-1);else if(e.key==="Enter"){if(!t.activeId.value)return;const n=t.itemMetaRef.value.get(t.activeId.value);n&&!n.disabled&&(e.preventDefault(),n.onSelect?.(n.value))}}return(e,n)=>((0,a.openBlock)(),(0,a.createElementBlock)("input",{class:"skdx-command__input","data-part":"input",type:"text","aria-controls":(0,a.unref)(t).listId,"aria-activedescendant":(0,a.unref)(t).activeId.value??void 0,autocomplete:"off",onInput:l,onKeydown:d},null,40,f))}});exports.default=p;
+const m=require("../utils/injectRequired.cjs"),v=require("./context.cjs");let r=require("vue");var _=["aria-controls","aria-activedescendant","value"],I=(0,r.defineComponent)({__name:"CommandInput",setup(k,{expose:s}){const n=m.injectRequired(v.COMMAND_CONTEXT,"SkdxCommandInput must be used within SkdxCommand."),o=(0,r.ref)(null);function i(){return n.orderedOptions()}function l(e){const t=i();if(t.length===0)return;const a=t.findIndex(p=>p.id===n.activeId.value);let u=a;a===-1&&(u=e===1?-1:0);const c=t[n.loop.value?(u+e+t.length)%t.length:Math.min(t.length-1,Math.max(0,u+e))];n.setActiveId(c.id),c.scrollIntoView?.({block:"nearest"})}function d(e){n.setSearch(e.target.value)}function f(e){if(e.key==="ArrowDown")e.preventDefault(),l(1);else if(e.key==="ArrowUp")e.preventDefault(),l(-1);else if(e.key==="Home"||e.key==="End"){const t=i();if(t.length===0)return;e.preventDefault();const a=e.key==="Home"?t[0]:t[t.length-1];n.setActiveId(a.id),a.scrollIntoView?.({block:"nearest"})}else if(e.key==="Enter"){if(!n.activeId.value)return;const t=n.itemMetaRef.value.get(n.activeId.value);t&&!t.disabled&&(e.preventDefault(),t.onSelect?.(t.value))}}return s({focus:e=>o.value?.focus(e),el:o}),(e,t)=>((0,r.openBlock)(),(0,r.createElementBlock)("input",{ref_key:"elRef",ref:o,class:"skdx-command__input","data-part":"input",type:"text","aria-controls":(0,r.unref)(n).listId,"aria-activedescendant":(0,r.unref)(n).activeId.value??void 0,autocomplete:"off",value:(0,r.unref)(n).search.value,onInput:d,onKeydown:f},null,40,_))}});exports.default=I;