@skdx/vue 0.26.0

package/dist/combobox/ComboboxInput.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{reassertValue as e}from"../utils/reassertValue.js";import{POPPER_CONTEXT as a}from"../utils/popper.js";import{COMBOBOX_CONTEXT as t,OPTION_SELECTOR as n}from"./context.js";import{createElementBlock as o,defineComponent as l,inject as i,onBeforeUnmount as u,onMounted as r,openBlock as d,ref as v,unref as s}from"vue";var p=["aria-expanded","aria-controls","aria-activedescendant","readonly","aria-invalid","aria-readonly","aria-busy","data-invalid","data-readonly","data-loading","data-multiple","value"],c=/* @__PURE__ */l({__name:"ComboboxInput",setup(l){const c=i(t);if(!c)throw new Error("SkdxComboboxInput must be used within SkdxCombobox.");const f=c,m=i(a);if(!m)throw new Error("SkdxComboboxInput must be used within SkdxCombobox.");const y=v(null);function x(e){const a=f.contentRef.value;if(!a)return;const t=Array.from(a.querySelectorAll(n));if(0===t.length)return;let o=t.findIndex(e=>e.id===f.activeId.value)+e;o<0&&(o=0),o>=t.length&&(o=t.length-1),f.setActiveId(t[o].id)}function b(a){const t=a.target;f.onInputValueChange(t.value),f.open.value||f.setOpen(!0),e(t,()=>f.inputValue.value)}function h(e){"ArrowDown"===e.key?(e.preventDefault(),f.open.value?x(1):f.openWithHighlight("first")):"ArrowUp"===e.key?(e.preventDefault(),f.open.value?x(-1):f.openWithHighlight("last")):"Enter"===e.key?f.activeId.value?(e.preventDefault(),function(){if(!f.activeId.value)return;const e=f.getItem(f.activeId.value);e&&f.selectItem(e.value,e.text||e.value)}()):f.allowCustomValue&&""!==f.inputValue.value&&(e.preventDefault(),f.selectItem(f.inputValue.value,f.inputValue.value)):"Escape"===e.key&&f.open.value&&!f.contentRef.value&&(e.preventDefault(),f.setOpen(!1))}return r(()=>{f.inputRef.value=y.value,m.setAnchor(y.value)}),u(()=>{m.anchor.value===y.value&&m.setAnchor(null)}),(e,a)=>(d(),o("input",{class:"skdx-combobox__input","data-part":"input",ref_key:"elRef",ref:y,type:"text",role:"combobox","aria-expanded":s(f).open.value,"aria-controls":s(f).contentId,"aria-autocomplete":"list","aria-activedescendant":s(f).activeId.value??void 0,autocomplete:"off",readonly:s(f).readOnly||void 0,"aria-invalid":!!s(f).invalid||void 0,"aria-readonly":!!s(f).readOnly||void 0,"aria-busy":!!s(f).loading.value||void 0,"data-invalid":s(f).invalid?"":void 0,"data-readonly":s(f).readOnly?"":void 0,"data-loading":s(f).loading.value?"":void 0,"data-multiple":s(f).multiple?"":void 0,value:s(f).inputValue.value,onInput:b,onKeydown:h},null,40,p))}});export{c as default};

package/dist/combobox/ComboboxItem.vue.cjs

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

package/dist/combobox/ComboboxItem.vue.d.cts

@@ -0,0 +1,44 @@
+/**
+ * A single selectable option within `SkdxComboboxContent`. Renders a
+ * `<div role="option">` with `data-value`, `aria-selected`, `data-state`
+ * (`"checked"` | `"unchecked"`), `data-highlighted` (virtual focus, mirrored
+ * by the input's `aria-activedescendant`), and `data-disabled`. Registers
+ * itself — and its text — with the root, so `SkdxComboboxEmpty` knows when the
+ * list is empty and Enter can commit the highlighted option. Click selects the
+ * item, updates the input's draft text to its text, closes the listbox, and
+ * refocuses the input — or, while the root is `multiple`, toggles it, clears
+ * the draft text, and leaves the listbox open. Pointer hover moves the virtual
+ * highlight onto it. Must be used inside `SkdxCombobox`.
+ *
+ * When the root has a `filter` predicate, an item the predicate rejects
+ * renders nothing at all and unregisters itself, so it is absent from the DOM
+ * rather than hidden — a hidden option would still be reachable through
+ * `aria-activedescendant` and would still be counted as a result.
+ */
+type __VLS_Props = {
+    /** Unique identifier committed to the combobox root's value when this option is chosen. */
+    value: string;
+    /**
+     * Excludes this option from selection and pointer highlight.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Text matched by the root's `filter` and written into the input on select;
+     * defaults to the item's rendered text content.
+     * @default undefined — falls back to the item's rendered text content.
+     */
+    textValue?: string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    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>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/combobox/ComboboxItem.vue.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A single selectable option within `SkdxComboboxContent`. Renders a
+ * `<div role="option">` with `data-value`, `aria-selected`, `data-state`
+ * (`"checked"` | `"unchecked"`), `data-highlighted` (virtual focus, mirrored
+ * by the input's `aria-activedescendant`), and `data-disabled`. Registers
+ * itself — and its text — with the root, so `SkdxComboboxEmpty` knows when the
+ * list is empty and Enter can commit the highlighted option. Click selects the
+ * item, updates the input's draft text to its text, closes the listbox, and
+ * refocuses the input — or, while the root is `multiple`, toggles it, clears
+ * the draft text, and leaves the listbox open. Pointer hover moves the virtual
+ * highlight onto it. Must be used inside `SkdxCombobox`.
+ *
+ * When the root has a `filter` predicate, an item the predicate rejects
+ * renders nothing at all and unregisters itself, so it is absent from the DOM
+ * rather than hidden — a hidden option would still be reachable through
+ * `aria-activedescendant` and would still be counted as a result.
+ */
+type __VLS_Props = {
+    /** Unique identifier committed to the combobox root's value when this option is chosen. */
+    value: string;
+    /**
+     * Excludes this option from selection and pointer highlight.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Text matched by the root's `filter` and written into the input on select;
+     * defaults to the item's rendered text content.
+     * @default undefined — falls back to the item's rendered text content.
+     */
+    textValue?: string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    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>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/combobox/ComboboxItem.vue.js

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

package/dist/combobox/ComboboxItem.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const m=require("./context.cjs");let e=require("vue");var x=["id","data-value","aria-selected","data-state","data-highlighted","data-disabled"],p=(0,e.defineComponent)({__name:"ComboboxItem",props:{value:{},disabled:{type:Boolean},textValue:{}},setup(u){const t=u,i=(0,e.inject)(m.COMBOBOX_CONTEXT);if(!i)throw new Error("SkdxComboboxItem must be used within SkdxCombobox.");const a=i,l=m.nextComboboxItemId(),r=(0,e.ref)(null),c=(0,e.computed)(()=>a.isSelected(t.value)),f=(0,e.computed)(()=>a.activeId.value===l),o=(0,e.ref)(t.textValue??null);function s(){const n=t.textValue??r.value?.textContent;n!=null&&n!==o.value&&(o.value=n)}const d=(0,e.computed)(()=>o.value===null||a.matchesFilter(o.value));function v(){d.value?a.registerItem(l,{value:t.value,text:o.value??""}):a.unregisterItem(l)}(0,e.onMounted)(()=>{s(),v()}),(0,e.onUpdated)(s),(0,e.watch)([d,()=>t.value,o],v),(0,e.onBeforeUnmount)(()=>a.unregisterItem(l));function b(){t.disabled||(a.selectItem(t.value,o.value??t.value),a.inputRef.value?.focus())}function h(){t.disabled||a.setActiveId(l)}return(n,_)=>d.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,class:"skdx-combobox__item","data-part":"item",ref_key:"itemRef",ref:r,role:"option",id:(0,e.unref)(l),"data-value":u.value,"aria-selected":c.value,"data-state":c.value?"checked":"unchecked","data-highlighted":f.value?"":void 0,"data-disabled":u.disabled?"":void 0,onClick:b,onPointerenter:h},[(0,e.renderSlot)(n.$slots,"default")],40,x)):(0,e.createCommentVNode)("",!0)}});exports.default=p;

package/dist/combobox/ComboboxItem.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{COMBOBOX_CONTEXT as e,nextComboboxItemId as t}from"./context.js";import{computed as a,createCommentVNode as o,createElementBlock as l,defineComponent as u,inject as d,onBeforeUnmount as n,onMounted as s,onUpdated as i,openBlock as r,ref as c,renderSlot as v,unref as m,watch as f}from"vue";var b=["id","data-value","aria-selected","data-state","data-highlighted","data-disabled"],x=/* @__PURE__ */u({__name:"ComboboxItem",props:{value:{},disabled:{type:Boolean},textValue:{}},setup(u){const x=u,p=d(e);if(!p)throw new Error("SkdxComboboxItem must be used within SkdxCombobox.");const h=p,k=t(),C=c(null),I=a(()=>h.isSelected(x.value)),g=a(()=>h.activeId.value===k),B=c(x.textValue??null);function _(){const e=x.textValue??C.value?.textContent;null!=e&&e!==B.value&&(B.value=e)}const w=a(()=>null===B.value||h.matchesFilter(B.value));function O(){w.value?h.registerItem(k,{value:x.value,text:B.value??""}):h.unregisterItem(k)}function S(){x.disabled||(h.selectItem(x.value,B.value??x.value),h.inputRef.value?.focus())}function V(){x.disabled||h.setActiveId(k)}return s(()=>{_(),O()}),i(_),f([w,()=>x.value,B],O),n(()=>h.unregisterItem(k)),(e,t)=>w.value?(r(),l("div",{key:0,class:"skdx-combobox__item","data-part":"item",ref_key:"itemRef",ref:C,role:"option",id:m(k),"data-value":u.value,"aria-selected":I.value,"data-state":I.value?"checked":"unchecked","data-highlighted":g.value?"":void 0,"data-disabled":u.disabled?"":void 0,onClick:S,onPointerenter:V},[v(e.$slots,"default")],40,b)):o("",!0)}});export{x as default};

package/dist/combobox/ComboboxPortal.vue.cjs

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

package/dist/combobox/ComboboxPortal.vue.d.cts

@@ -0,0 +1,30 @@
+import type { PortalContainer } from '../utils/portal.cjs';
+/**
+ * Teleports `SkdxComboboxContent` to `document.body` (or a custom `container`), so the listbox escapes
+ * any clipping/`overflow` ancestors. Mounts only while open unless
+ * `forceMount` is set. Must be used inside `SkdxCombobox`.
+ */
+type __VLS_Props = {
+    /**
+     * DOM node (or CSS selector) the children are rendered into.
+     * @default document.body
+     */
+    container?: PortalContainer;
+    /** Render (and mount `SkdxComboboxContent`) even while closed, instead of unmounting. */
+    forceMount?: boolean;
+};
+declare var __VLS_5: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_5) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    forceMount: boolean;
+    container: PortalContainer;
+}, {}, {}, {}, 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/combobox/ComboboxPortal.vue.d.ts

@@ -0,0 +1,30 @@
+import type { PortalContainer } from '../utils/portal.js';
+/**
+ * Teleports `SkdxComboboxContent` to `document.body` (or a custom `container`), so the listbox escapes
+ * any clipping/`overflow` ancestors. Mounts only while open unless
+ * `forceMount` is set. Must be used inside `SkdxCombobox`.
+ */
+type __VLS_Props = {
+    /**
+     * DOM node (or CSS selector) the children are rendered into.
+     * @default document.body
+     */
+    container?: PortalContainer;
+    /** Render (and mount `SkdxComboboxContent`) even while closed, instead of unmounting. */
+    forceMount?: boolean;
+};
+declare var __VLS_5: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_5) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    forceMount: boolean;
+    container: PortalContainer;
+}, {}, {}, {}, 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/combobox/ComboboxPortal.vue.js

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

package/dist/combobox/ComboboxPortal.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const n=require("../utils/Portal.vue.cjs"),u=require("./context.cjs");let e=require("vue");var a=(0,e.defineComponent)({__name:"ComboboxPortal",props:{container:{default:null},forceMount:{type:Boolean,default:!1}},setup(t){const o=(0,e.inject)(u.COMBOBOX_CONTEXT);if(!o)throw new Error("SkdxComboboxPortal must be used within SkdxCombobox.");return(r,l)=>t.forceMount||(0,e.unref)(o).open.value?((0,e.openBlock)(),(0,e.createBlock)(n.default,{key:0,container:t.container},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(r.$slots,"default")]),_:3},8,["container"])):(0,e.createCommentVNode)("",!0)}});exports.default=a;

package/dist/combobox/ComboboxPortal.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import o from"../utils/Portal.vue.js";import{COMBOBOX_CONTEXT as e}from"./context.js";import{createBlock as t,createCommentVNode as r,defineComponent as a,inject as n,openBlock as s,renderSlot as l,unref as u,withCtx as i}from"vue";var m=/* @__PURE__ */a({__name:"ComboboxPortal",props:{container:{default:null},forceMount:{type:Boolean,default:!1}},setup(a){const m=n(e);if(!m)throw new Error("SkdxComboboxPortal must be used within SkdxCombobox.");return(e,n)=>a.forceMount||u(m).open.value?(s(),t(o,{key:0,container:a.container},{default:i(()=>[l(e.$slots,"default")]),_:3},8,["container"])):r("",!0)}});export{m as default};

package/dist/combobox/context.cjs

@@ -0,0 +1 @@
+const t=require("../utils/id.cjs");var e='[role="option"]:not([data-disabled])',n=Symbol("skdx-combobox-context");function b(){return t.nextId("combobox-content")}function x(){return t.nextId("combobox-item")}function r(o){return`${o} result${o===1?"":"s"} available`}exports.COMBOBOX_CONTEXT=n;exports.OPTION_SELECTOR=e;exports.defaultGetResultCountLabel=r;exports.nextComboboxContentId=b;exports.nextComboboxItemId=x;

package/dist/combobox/context.d.cts

@@ -0,0 +1,69 @@
+import type { InjectionKey, Ref } from 'vue';
+/** @internal CSS selector matching enabled (non-disabled) listbox option elements for keyboard navigation. */
+export declare const OPTION_SELECTOR = "[role=\"option\"]:not([data-disabled])";
+/**
+ * How a Combobox decides which items to show. `'manual'` filters nothing —
+ * the consumer renders only the matches, which is what async or server-side
+ * search needs. A predicate moves filtering inside the component.
+ */
+export type ComboboxFilter = 'manual' | ((itemText: string, inputValue: string) => boolean);
+/** @internal What one registered `SkdxComboboxItem` contributes to the root's collection. */
+export interface ComboboxItemEntry {
+    /** Identifier committed to the root's value when this option is chosen. */
+    value: string;
+    /** The item's `textValue`, or its rendered text — matched by `filter` and written back into the input. */
+    text: string;
+}
+/** @internal Injection key a Combobox provides so its parts can read/drive shared state. */
+export interface ComboboxContext {
+    inputRef: Ref<HTMLElement | null>;
+    contentRef: Ref<HTMLElement | null>;
+    contentId: string;
+    /** Whether more than one option can be selected. */
+    multiple: boolean;
+    /** Every selected value, normalised to an array whether or not `multiple`. */
+    selectedValues: Readonly<Ref<string[]>>;
+    /** Whether one option value is currently selected. */
+    isSelected(value: string): boolean;
+    /**
+     * Commits an option: replaces the selection, writes `text` into the input
+     * and closes — or, when `multiple`, toggles it within the selection, clears
+     * the draft text, and leaves the listbox open.
+     */
+    selectItem(value: string, text: string): void;
+    inputValue: Readonly<Ref<string>>;
+    onInputValueChange(value: string): void;
+    open: Readonly<Ref<boolean>>;
+    setOpen(open: boolean): void;
+    activeId: Readonly<Ref<string | null>>;
+    setActiveId(id: string | null): void;
+    /** Opens the listbox and, once its items are mounted, highlights the first (or last) one. */
+    openWithHighlight(edge: 'first' | 'last'): void;
+    itemCount: Readonly<Ref<number>>;
+    registerItem(id: string, entry: ComboboxItemEntry): void;
+    unregisterItem(id: string): void;
+    /** The registered entry behind an option id, for committing the virtually-focused option. */
+    getItem(id: string): ComboboxItemEntry | undefined;
+    /** Whether an item with this text survives the current `filter` and draft text. */
+    matchesFilter(itemText: string): boolean;
+    invalid: boolean;
+    readOnly: boolean;
+    /** Whether results are in flight — reactive, since a fetch toggles it after mount. */
+    loading: Readonly<Ref<boolean>>;
+    allowCustomValue: boolean;
+}
+/** @internal Injection key the Combobox root provides so its Input, Content, and Items share open, value, input-text, and active-item state. */
+export declare const COMBOBOX_CONTEXT: InjectionKey<ComboboxContext>;
+/** @internal Generates a unique id for a Combobox's content. */
+export declare function nextComboboxContentId(): string;
+/** @internal Generates a unique, stable-per-instance id for a ComboboxItem. */
+export declare function nextComboboxItemId(): string;
+/**
+ * @internal Default `getResultCountLabel`: `"1 result available"` /
+ * `"3 results available"`.
+ *
+ * Lives here rather than in `Combobox.vue` because `withDefaults(defineProps())`
+ * is hoisted out of `setup()`, so it cannot reference a binding declared
+ * locally in the same `<script setup>` — only an imported one.
+ */
+export declare function defaultGetResultCountLabel(count: number): string;

package/dist/combobox/context.d.ts

@@ -0,0 +1,69 @@
+import type { InjectionKey, Ref } from 'vue';
+/** @internal CSS selector matching enabled (non-disabled) listbox option elements for keyboard navigation. */
+export declare const OPTION_SELECTOR = "[role=\"option\"]:not([data-disabled])";
+/**
+ * How a Combobox decides which items to show. `'manual'` filters nothing —
+ * the consumer renders only the matches, which is what async or server-side
+ * search needs. A predicate moves filtering inside the component.
+ */
+export type ComboboxFilter = 'manual' | ((itemText: string, inputValue: string) => boolean);
+/** @internal What one registered `SkdxComboboxItem` contributes to the root's collection. */
+export interface ComboboxItemEntry {
+    /** Identifier committed to the root's value when this option is chosen. */
+    value: string;
+    /** The item's `textValue`, or its rendered text — matched by `filter` and written back into the input. */
+    text: string;
+}
+/** @internal Injection key a Combobox provides so its parts can read/drive shared state. */
+export interface ComboboxContext {
+    inputRef: Ref<HTMLElement | null>;
+    contentRef: Ref<HTMLElement | null>;
+    contentId: string;
+    /** Whether more than one option can be selected. */
+    multiple: boolean;
+    /** Every selected value, normalised to an array whether or not `multiple`. */
+    selectedValues: Readonly<Ref<string[]>>;
+    /** Whether one option value is currently selected. */
+    isSelected(value: string): boolean;
+    /**
+     * Commits an option: replaces the selection, writes `text` into the input
+     * and closes — or, when `multiple`, toggles it within the selection, clears
+     * the draft text, and leaves the listbox open.
+     */
+    selectItem(value: string, text: string): void;
+    inputValue: Readonly<Ref<string>>;
+    onInputValueChange(value: string): void;
+    open: Readonly<Ref<boolean>>;
+    setOpen(open: boolean): void;
+    activeId: Readonly<Ref<string | null>>;
+    setActiveId(id: string | null): void;
+    /** Opens the listbox and, once its items are mounted, highlights the first (or last) one. */
+    openWithHighlight(edge: 'first' | 'last'): void;
+    itemCount: Readonly<Ref<number>>;
+    registerItem(id: string, entry: ComboboxItemEntry): void;
+    unregisterItem(id: string): void;
+    /** The registered entry behind an option id, for committing the virtually-focused option. */
+    getItem(id: string): ComboboxItemEntry | undefined;
+    /** Whether an item with this text survives the current `filter` and draft text. */
+    matchesFilter(itemText: string): boolean;
+    invalid: boolean;
+    readOnly: boolean;
+    /** Whether results are in flight — reactive, since a fetch toggles it after mount. */
+    loading: Readonly<Ref<boolean>>;
+    allowCustomValue: boolean;
+}
+/** @internal Injection key the Combobox root provides so its Input, Content, and Items share open, value, input-text, and active-item state. */
+export declare const COMBOBOX_CONTEXT: InjectionKey<ComboboxContext>;
+/** @internal Generates a unique id for a Combobox's content. */
+export declare function nextComboboxContentId(): string;
+/** @internal Generates a unique, stable-per-instance id for a ComboboxItem. */
+export declare function nextComboboxItemId(): string;
+/**
+ * @internal Default `getResultCountLabel`: `"1 result available"` /
+ * `"3 results available"`.
+ *
+ * Lives here rather than in `Combobox.vue` because `withDefaults(defineProps())`
+ * is hoisted out of `setup()`, so it cannot reference a binding declared
+ * locally in the same `<script setup>` — only an imported one.
+ */
+export declare function defaultGetResultCountLabel(count: number): string;

package/dist/combobox/context.js

@@ -0,0 +1 @@
+import{nextId as o}from"../utils/id.js";var t='[role="option"]:not([data-disabled])',e=/* @__PURE__ */Symbol("skdx-combobox-context");function n(){return o("combobox-content")}function a(){return o("combobox-item")}function b(o){return`${o} result${1===o?"":"s"} available`}export{e as COMBOBOX_CONTEXT,t as OPTION_SELECTOR,b as defaultGetResultCountLabel,n as nextComboboxContentId,a as nextComboboxItemId};

package/dist/combobox/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./Combobox.vue.cjs"),e=require("./ComboboxContent.vue.cjs"),r=require("./ComboboxEmpty.vue.cjs"),t=require("./ComboboxInput.vue.cjs"),b=require("./ComboboxItem.vue.cjs"),u=require("./ComboboxPortal.vue.cjs");exports.SkdxCombobox=o.default;exports.SkdxComboboxContent=e.default;exports.SkdxComboboxEmpty=r.default;exports.SkdxComboboxInput=t.default;exports.SkdxComboboxItem=b.default;exports.SkdxComboboxPortal=u.default;

package/dist/combobox/index.d.cts

@@ -0,0 +1,7 @@
+export { default as SkdxCombobox } from './Combobox.vue.cjs';
+export { default as SkdxComboboxContent } from './ComboboxContent.vue.cjs';
+export { default as SkdxComboboxEmpty } from './ComboboxEmpty.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 type { ComboboxFilter } from './context.cjs';

package/dist/combobox/index.d.ts

@@ -0,0 +1,7 @@
+export { default as SkdxCombobox } from './Combobox.vue.js';
+export { default as SkdxComboboxContent } from './ComboboxContent.vue.js';
+export { default as SkdxComboboxEmpty } from './ComboboxEmpty.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 type { ComboboxFilter } from './context.js';

package/dist/combobox/index.js

@@ -0,0 +1 @@
+import o from"./Combobox.vue.js";import m from"./ComboboxContent.vue.js";import b from"./ComboboxEmpty.vue.js";import t from"./ComboboxInput.vue.js";import x from"./ComboboxItem.vue.js";import r from"./ComboboxPortal.vue.js";export{o as SkdxCombobox,m as SkdxComboboxContent,b as SkdxComboboxEmpty,t as SkdxComboboxInput,x as SkdxComboboxItem,r as SkdxComboboxPortal};

package/dist/command/Command.vue.cjs

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

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

@@ -0,0 +1,73 @@
+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.
+ */
+type __VLS_Props = {
+    /** Value of the highlighted item, for controlled usage via `v-model:value`. */
+    value?: string;
+    /** Value of the initially highlighted item, for uncontrolled usage. */
+    defaultValue?: string;
+    /** Current search text, for controlled usage via `v-model:search`. */
+    search?: string;
+    /** Initial search text, for uncontrolled usage. */
+    defaultSearch?: string;
+    /**
+     * 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.
+     */
+    filter?: CommandFilter;
+    /**
+     * 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".
+     */
+    loading?: boolean;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:value": (value: string) => any;
+    "value-change": (value: string) => any;
+    "update: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;
+}>, {
+    loading: boolean;
+    filter: CommandFilter;
+    search: string;
+    value: string;
+    defaultValue: string;
+    defaultSearch: string;
+}, {}, {}, {}, 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/Command.vue.d.ts

@@ -0,0 +1,73 @@
+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.
+ */
+type __VLS_Props = {
+    /** Value of the highlighted item, for controlled usage via `v-model:value`. */
+    value?: string;
+    /** Value of the initially highlighted item, for uncontrolled usage. */
+    defaultValue?: string;
+    /** Current search text, for controlled usage via `v-model:search`. */
+    search?: string;
+    /** Initial search text, for uncontrolled usage. */
+    defaultSearch?: string;
+    /**
+     * 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.
+     */
+    filter?: CommandFilter;
+    /**
+     * 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".
+     */
+    loading?: boolean;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:value": (value: string) => any;
+    "value-change": (value: string) => any;
+    "update: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;
+}>, {
+    loading: boolean;
+    filter: CommandFilter;
+    search: string;
+    value: string;
+    defaultValue: string;
+    defaultSearch: string;
+}, {}, {}, {}, 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/Command.vue.js

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

package/dist/command/Command.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +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;

package/dist/command/Command.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +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};

package/dist/command/CommandEmpty.vue.cjs

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

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

@@ -0,0 +1,21 @@
+/**
+ * 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`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    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>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,21 @@
+/**
+ * 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`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    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>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/command/CommandEmpty.vue.js

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

package/dist/command/CommandEmpty.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +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;

package/dist/command/CommandEmpty.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +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};

package/dist/command/CommandGroup.vue.cjs

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

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

@@ -0,0 +1,26 @@
+/**
+ * Labelled cluster of `SkdxCommandItem`s: renders a `<div role="group">` with
+ * an optional non-interactive heading above the items, via the `heading`
+ * slot.
+ */
+type __VLS_Props = {
+    /**
+     * Non-interactive heading rendered above the group's items.
+     * @default undefined — no heading rendered.
+     */
+    heading?: string;
+};
+declare var __VLS_1: {}, __VLS_3: {};
+type __VLS_Slots = {} & {
+    heading?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_3) => 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>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};