@skdx/vue 0.26.0 → 0.28.0

package/dist/autocomplete/AutocompleteAnatomy.vue.d.cts

@@ -0,0 +1,33 @@
+import { type AutocompleteOption, type AutocompleteOptionGroup } from './context.cjs';
+/**
+ * Default autocomplete anatomy: input, trigger, Clear button, popup suggestion list.
+ * Filters options by case-insensitive substring match against label.
+ * Groups options when an entry declares its own `options` array, flat otherwise.
+ * @internal
+ */
+type __VLS_Props = {
+    options: AutocompleteOption[] | AutocompleteOptionGroup[];
+    /**
+     * Label for input and list (neither takes a name from content).
+     */
+    ariaLabel?: string;
+    ariaLabelledby?: string;
+};
+declare var __VLS_28: {
+    option: AutocompleteOption;
+}, __VLS_33: {
+    option: AutocompleteOption;
+};
+type __VLS_Slots = {} & {
+    option?: (props: typeof __VLS_28) => any;
+} & {
+    option?: (props: typeof __VLS_33) => 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/autocomplete/AutocompleteAnatomy.vue.d.ts

@@ -0,0 +1,33 @@
+import { type AutocompleteOption, type AutocompleteOptionGroup } from './context.js';
+/**
+ * Default autocomplete anatomy: input, trigger, Clear button, popup suggestion list.
+ * Filters options by case-insensitive substring match against label.
+ * Groups options when an entry declares its own `options` array, flat otherwise.
+ * @internal
+ */
+type __VLS_Props = {
+    options: AutocompleteOption[] | AutocompleteOptionGroup[];
+    /**
+     * Label for input and list (neither takes a name from content).
+     */
+    ariaLabel?: string;
+    ariaLabelledby?: string;
+};
+declare var __VLS_28: {
+    option: AutocompleteOption;
+}, __VLS_33: {
+    option: AutocompleteOption;
+};
+type __VLS_Slots = {} & {
+    option?: (props: typeof __VLS_28) => any;
+} & {
+    option?: (props: typeof __VLS_33) => 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/autocomplete/AutocompleteAnatomy.vue.js

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

package/dist/autocomplete/AutocompleteAnatomy.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const b=require("./context.cjs"),p=require("./AutocompleteClear.vue.cjs"),f=require("./AutocompleteContent.vue.cjs"),m=require("./AutocompleteEmpty.vue.cjs"),q=require("./AutocompleteGroup.vue.cjs"),v=require("./AutocompleteGroupLabel.vue.cjs"),x=require("./AutocompleteInput.vue.cjs"),d=require("./AutocompleteItem.vue.cjs"),g=require("./AutocompleteList.vue.cjs"),k=require("./AutocompletePortal.vue.cjs"),C=require("./AutocompleteTrigger.vue.cjs");let e=require("vue");var _=(0,e.defineComponent)({inheritAttrs:!1,__name:"AutocompleteAnatomy",props:{options:{},ariaLabel:{},ariaLabelledby:{}},setup(u){const i=u,c=(0,e.inject)(b.AUTOCOMPLETE_CONTEXT);function o(a){return"options"in a}function n(a,l){return(a.label??a.value).toLowerCase().includes(l)}const s=(0,e.computed)(()=>{const a=c.inputValue.value.trim().toLowerCase();return a?i.options.flatMap(l=>{if(!o(l))return n(l,a)?[l]:[];const t=l.options.filter(r=>n(r,a));return t.length>0?[{label:l.label,options:t}]:[]}):i.options});return(a,l)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,null,[(0,e.createVNode)(x.default,(0,e.mergeProps)(a.$attrs,{"aria-label":u.ariaLabel,"aria-labelledby":u.ariaLabelledby}),null,16,["aria-label","aria-labelledby"]),(0,e.createVNode)(C.default,{"aria-label":"Toggle suggestions"},{default:(0,e.withCtx)(()=>[...l[0]||(l[0]=[(0,e.createTextVNode)("▾",-1)])]),_:1}),(0,e.createVNode)(p.default,{"aria-label":"Clear"},{default:(0,e.withCtx)(()=>[...l[1]||(l[1]=[(0,e.createTextVNode)("✕",-1)])]),_:1}),(0,e.createVNode)(k.default,null,{default:(0,e.withCtx)(()=>[(0,e.createVNode)(f.default,null,{default:(0,e.withCtx)(()=>[(0,e.createVNode)(g.default,{"aria-label":u.ariaLabel,"aria-labelledby":u.ariaLabelledby},{default:(0,e.withCtx)(()=>[((0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,null,(0,e.renderList)(s.value,t=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,{key:o(t)?t.label:t.value},[o(t)?((0,e.openBlock)(),(0,e.createBlock)(q.default,{key:0},{default:(0,e.withCtx)(()=>[(0,e.createVNode)(v.default,null,{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.label),1)]),_:2},1024),((0,e.openBlock)(!0),(0,e.createElementBlock)(e.Fragment,null,(0,e.renderList)(t.options,r=>((0,e.openBlock)(),(0,e.createBlock)(d.default,{key:r.value,value:r.value,disabled:r.disabled,"text-value":r.label},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(a.$slots,"option",{option:r},()=>[(0,e.createTextVNode)((0,e.toDisplayString)(r.label??r.value),1)])]),_:2},1032,["value","disabled","text-value"]))),128))]),_:2},1024)):((0,e.openBlock)(),(0,e.createBlock)(d.default,{key:1,value:t.value,disabled:t.disabled,"text-value":t.label},{default:(0,e.withCtx)(()=>[(0,e.renderSlot)(a.$slots,"option",{option:t},()=>[(0,e.createTextVNode)((0,e.toDisplayString)(t.label??t.value),1)])]),_:2},1032,["value","disabled","text-value"]))],64))),128))]),_:3},8,["aria-label","aria-labelledby"]),(0,e.createVNode)(m.default,null,{default:(0,e.withCtx)(()=>[...l[2]||(l[2]=[(0,e.createTextVNode)("No suggestions found",-1)])]),_:1})]),_:3})]),_:3})],64))}});exports.default=_;

package/dist/autocomplete/AutocompleteAnatomy.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{AUTOCOMPLETE_CONTEXT as e}from"./context.js";import l from"./AutocompleteClear.vue.js";import a from"./AutocompleteContent.vue.js";import t from"./AutocompleteEmpty.vue.js";import o from"./AutocompleteGroup.vue.js";import r from"./AutocompleteGroupLabel.vue.js";import u from"./AutocompleteInput.vue.js";import i from"./AutocompleteItem.vue.js";import s from"./AutocompleteList.vue.js";import n from"./AutocompletePortal.vue.js";import p from"./AutocompleteTrigger.vue.js";import{Fragment as m,computed as b,createBlock as d,createElementBlock as f,createTextVNode as v,createVNode as c,defineComponent as y,inject as A,mergeProps as _,openBlock as g,renderList as j,renderSlot as L,toDisplayString as C,withCtx as x}from"vue";var k=/* @__PURE__ */y({inheritAttrs:!1,__name:"AutocompleteAnatomy",props:{options:{},ariaLabel:{},ariaLabelledby:{}},setup(y){const k=y,T=A(e);function E(e){return"options"in e}function N(e,l){return(e.label??e.value).toLowerCase().includes(l)}const h=b(()=>{const e=T.inputValue.value.trim().toLowerCase();return e?k.options.flatMap(l=>{if(!E(l))return N(l,e)?[l]:[];const a=l.options.filter(l=>N(l,e));return a.length>0?[{label:l.label,options:a}]:[]}):k.options});return(e,b)=>(g(),f(m,null,[c(u,_(e.$attrs,{"aria-label":y.ariaLabel,"aria-labelledby":y.ariaLabelledby}),null,16,["aria-label","aria-labelledby"]),c(p,{"aria-label":"Toggle suggestions"},{default:x(()=>[...b[0]||(b[0]=[v("▾",-1)])]),_:1}),c(l,{"aria-label":"Clear"},{default:x(()=>[...b[1]||(b[1]=[v("✕",-1)])]),_:1}),c(n,null,{default:x(()=>[c(a,null,{default:x(()=>[c(s,{"aria-label":y.ariaLabel,"aria-labelledby":y.ariaLabelledby},{default:x(()=>[(g(!0),f(m,null,j(h.value,l=>(g(),f(m,{key:E(l)?l.label:l.value},[E(l)?(g(),d(o,{key:0},{default:x(()=>[c(r,null,{default:x(()=>[v(C(l.label),1)]),_:2},1024),(g(!0),f(m,null,j(l.options,l=>(g(),d(i,{key:l.value,value:l.value,disabled:l.disabled,"text-value":l.label},{default:x(()=>[L(e.$slots,"option",{option:l},()=>[v(C(l.label??l.value),1)])]),_:2},1032,["value","disabled","text-value"]))),128))]),_:2},1024)):(g(),d(i,{key:1,value:l.value,disabled:l.disabled,"text-value":l.label},{default:x(()=>[L(e.$slots,"option",{option:l},()=>[v(C(l.label??l.value),1)])]),_:2},1032,["value","disabled","text-value"]))],64))),128))]),_:3},8,["aria-label","aria-labelledby"]),c(t,null,{default:x(()=>[...b[2]||(b[2]=[v("No suggestions found",-1)])]),_:1})]),_:3})]),_:3})],64))}});export{k as default};

package/dist/autocomplete/AutocompleteClear.vue.cjs

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

package/dist/autocomplete/AutocompleteClear.vue.d.cts

@@ -0,0 +1,19 @@
+/**
+ * Optional button that empties the draft text and committed value, returning focus
+ * to the Input. Disabled while nothing to clear or when root is disabled/readOnly
+ * (a live clear over an empty field looks broken). tabindex="-1" like Trigger
+ * (input is the widget). Give it an aria-label; "✕" is not an accessible name.
+ */
+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/autocomplete/AutocompleteClear.vue.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Optional button that empties the draft text and committed value, returning focus
+ * to the Input. Disabled while nothing to clear or when root is disabled/readOnly
+ * (a live clear over an empty field looks broken). tabindex="-1" like Trigger
+ * (input is the widget). Give it an aria-label; "✕" is not an accessible name.
+ */
+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/autocomplete/AutocompleteClear.vue.js

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

package/dist/autocomplete/AutocompleteClear.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const r=require("./context.cjs");let e=require("vue");var d=["disabled","data-disabled","data-readonly"],c=(0,e.defineComponent)({__name:"AutocompleteClear",setup(i){const o=(0,e.inject)(r.AUTOCOMPLETE_CONTEXT);if(!o)throw new Error("SkdxAutocompleteClear must be used within SkdxAutocomplete.");const t=o,n=(0,e.computed)(()=>t.value.value===""&&t.inputValue.value==="");function u(a){a.preventDefault()}function l(){t.clear("pointer"),t.inputRef.value?.focus()}return(a,s)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-autocomplete__clear","data-part":"clear",type:"button",tabindex:-1,disabled:(0,e.unref)(t).disabled||(0,e.unref)(t).readOnly||n.value||void 0,"data-disabled":(0,e.unref)(t).disabled?"":void 0,"data-readonly":(0,e.unref)(t).readOnly?"":void 0,onMousedown:u,onClick:l},[(0,e.renderSlot)(a.$slots,"default")],40,d))}});exports.default=c;

package/dist/autocomplete/AutocompleteClear.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{AUTOCOMPLETE_CONTEXT as e}from"./context.js";import{computed as a,createElementBlock as t,defineComponent as o,inject as d,openBlock as l,renderSlot as n,unref as r}from"vue";var s=["disabled","data-disabled","data-readonly"],u=/* @__PURE__ */o({__name:"AutocompleteClear",setup(o){const u=d(e);if(!u)throw new Error("SkdxAutocompleteClear must be used within SkdxAutocomplete.");const i=u,c=a(()=>""===i.value.value&&""===i.inputValue.value);function p(e){e.preventDefault()}function m(){i.clear("pointer"),i.inputRef.value?.focus()}return(e,a)=>(l(),t("button",{class:"skdx-autocomplete__clear","data-part":"clear",type:"button",tabindex:-1,disabled:r(i).disabled||r(i).readOnly||c.value||void 0,"data-disabled":r(i).disabled?"":void 0,"data-readonly":r(i).readOnly?"":void 0,onMousedown:p,onClick:m},[n(e.$slots,"default")],40,s))}});export{u as default};

package/dist/autocomplete/AutocompleteContent.vue.d.cts

@@ -1,76 +1,52 @@
 import { type Align, type PhysicalSide, type Side } from '../utils/popper.cjs';
 import { type FocusOutsideEvent, type InteractOutsideEvent } from '../utils/useDismiss.cjs';
 /**
- * The popup shell of an `SkdxAutocomplete`, positioned relative to the input via
- * floating-ui using `side` (defaults to `'bottom'`) / `align` (defaults to
- * `'start'`) / `sideOffset` (defaults to `4`) / `alignOffset`, flipping and
- * shifting to avoid viewport collisions unless `avoidCollisions` is `false`.
- * Renders a plain `<div>` with `data-state`, `data-side` and `data-align`, and
- * — like every popper in this package — writes the four measurement custom
- * properties `--skdx-autocomplete-available-width`,
- * `--skdx-autocomplete-available-height`, `--skdx-autocomplete-trigger-width` and
- * `--skdx-autocomplete-transform-origin` onto itself after each reposition, so
- * the panel can be sized and animated from CSS alone rather than measured again
- * in JavaScript.
- *
- * It carries **no ARIA role**: the listbox is `SkdxAutocompleteList`, one level
- * in, so a header, a footer or an `SkdxAutocompleteEmpty` can sit inside the
- * popup without becoming a bogus role-less child of a listbox. Prevents
- * `mousedown` from stealing focus off the input — real DOM focus must never
- * leave `SkdxAutocompleteInput`, or the blur would commit and close before the
- * click landed.
- *
- * Closes on Escape (putting the last committed text back) or on an outside
- * interaction (pointer-down or focus moving out) 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. Escape is owned here rather than in
- * `SkdxAutocompleteInput` precisely so the veto lands before anything has
- * closed or reverted. Mounts only while open unless `forceMount` is set. Must
- * be used inside `SkdxAutocomplete`.
+ * The popup shell, positioned relative to the input via floating-ui.
+ * Renders a plain `<div>` with data-state/side/align and measurement CSS properties
+ * for sizing/animation. Carries aria-busy/data-loading. Has no ARIA role (the List is
+ * the listbox, so headers/footers/Empty don't become false listbox children). Prevents
+ * mousedown from stealing input focus. Closes on Escape or outside interaction
+ * (one prevent() veto covers both via interact-outside). Must be inside SkdxAutocomplete.
  */
 type __VLS_Props = {
     /**
      * Preferred side of the input to render on.
-     * @default 'bottom' — the popup hangs below the field, flipping above it only when there is no room.
+     * @default 'bottom' — hangs below the field, flips above it only when there is no room.
      */
     side?: Side;
     /**
-     * Alignment of the popup along the chosen side, relative to the input.
-     * @default 'start' — the popup's leading edge lines up with the field's, so the suggestions sit under the text.
+     * Alignment along the chosen side, relative to the input.
+     * @default 'start' — leading edge lines up with the field.
      */
     align?: Align;
     /**
      * Distance in pixels between the popup and the input along `side`.
-     * @default 4 — a small gap, so the popup reads as a separate surface.
+     * @default 4
      */
     sideOffset?: number;
     /**
      * Offset in pixels along `align`, shifting the popup perpendicular to `side`.
-     * @default 0 — no perpendicular shift.
+     * @default 0
      */
     alignOffset?: number;
     /**
      * Flips to the opposite side when there isn't room to render on the preferred side.
-     * @default true — a popup that would render off-screen flips instead.
+     * @default true
      */
     avoidCollisions?: boolean;
     /**
-     * Minimum distance in pixels kept from the collision boundary. A number
-     * applies to every side; an object sets only the sides it names.
+     * Minimum distance in pixels kept from the collision boundary (number applies to all sides).
      * @default 8 — the popup never touches the viewport edge.
      */
     collisionPadding?: number | Partial<Record<PhysicalSide, number>>;
     /**
-     * Element (or elements) collisions are measured against, instead of the
-     * popup's clipping ancestors. Use it to keep the suggestions inside a scroll
-     * container or one pane of a split layout rather than the whole viewport.
+     * Element or elements collisions are measured against instead of the popup's clipping ancestors.
+     * Use it to keep suggestions inside a scroll container or split pane.
      * @default undefined — the popup's clipping ancestors.
      */
     collisionBoundary?: Element | Element[] | null;
     /**
-     * Keep this popup mounted even while closed, instead of unmounting it.
+     * Keep this popup mounted even while closed.
      * @default false — the popup leaves the DOM entirely while closed.
      */
     forceMount?: boolean;
@@ -91,8 +67,8 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     "onInteract-outside"?: ((event: InteractOutsideEvent) => any) | undefined;
 }>, {
     forceMount: boolean;
-    side: Side;
     align: Align;
+    side: Side;
     sideOffset: number;
     alignOffset: number;
     avoidCollisions: boolean;

package/dist/autocomplete/AutocompleteContent.vue.d.ts

@@ -1,76 +1,52 @@
 import { type Align, type PhysicalSide, type Side } from '../utils/popper.js';
 import { type FocusOutsideEvent, type InteractOutsideEvent } from '../utils/useDismiss.js';
 /**
- * The popup shell of an `SkdxAutocomplete`, positioned relative to the input via
- * floating-ui using `side` (defaults to `'bottom'`) / `align` (defaults to
- * `'start'`) / `sideOffset` (defaults to `4`) / `alignOffset`, flipping and
- * shifting to avoid viewport collisions unless `avoidCollisions` is `false`.
- * Renders a plain `<div>` with `data-state`, `data-side` and `data-align`, and
- * — like every popper in this package — writes the four measurement custom
- * properties `--skdx-autocomplete-available-width`,
- * `--skdx-autocomplete-available-height`, `--skdx-autocomplete-trigger-width` and
- * `--skdx-autocomplete-transform-origin` onto itself after each reposition, so
- * the panel can be sized and animated from CSS alone rather than measured again
- * in JavaScript.
- *
- * It carries **no ARIA role**: the listbox is `SkdxAutocompleteList`, one level
- * in, so a header, a footer or an `SkdxAutocompleteEmpty` can sit inside the
- * popup without becoming a bogus role-less child of a listbox. Prevents
- * `mousedown` from stealing focus off the input — real DOM focus must never
- * leave `SkdxAutocompleteInput`, or the blur would commit and close before the
- * click landed.
- *
- * Closes on Escape (putting the last committed text back) or on an outside
- * interaction (pointer-down or focus moving out) 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. Escape is owned here rather than in
- * `SkdxAutocompleteInput` precisely so the veto lands before anything has
- * closed or reverted. Mounts only while open unless `forceMount` is set. Must
- * be used inside `SkdxAutocomplete`.
+ * The popup shell, positioned relative to the input via floating-ui.
+ * Renders a plain `<div>` with data-state/side/align and measurement CSS properties
+ * for sizing/animation. Carries aria-busy/data-loading. Has no ARIA role (the List is
+ * the listbox, so headers/footers/Empty don't become false listbox children). Prevents
+ * mousedown from stealing input focus. Closes on Escape or outside interaction
+ * (one prevent() veto covers both via interact-outside). Must be inside SkdxAutocomplete.
  */
 type __VLS_Props = {
     /**
      * Preferred side of the input to render on.
-     * @default 'bottom' — the popup hangs below the field, flipping above it only when there is no room.
+     * @default 'bottom' — hangs below the field, flips above it only when there is no room.
      */
     side?: Side;
     /**
-     * Alignment of the popup along the chosen side, relative to the input.
-     * @default 'start' — the popup's leading edge lines up with the field's, so the suggestions sit under the text.
+     * Alignment along the chosen side, relative to the input.
+     * @default 'start' — leading edge lines up with the field.
      */
     align?: Align;
     /**
      * Distance in pixels between the popup and the input along `side`.
-     * @default 4 — a small gap, so the popup reads as a separate surface.
+     * @default 4
      */
     sideOffset?: number;
     /**
      * Offset in pixels along `align`, shifting the popup perpendicular to `side`.
-     * @default 0 — no perpendicular shift.
+     * @default 0
      */
     alignOffset?: number;
     /**
      * Flips to the opposite side when there isn't room to render on the preferred side.
-     * @default true — a popup that would render off-screen flips instead.
+     * @default true
      */
     avoidCollisions?: boolean;
     /**
-     * Minimum distance in pixels kept from the collision boundary. A number
-     * applies to every side; an object sets only the sides it names.
+     * Minimum distance in pixels kept from the collision boundary (number applies to all sides).
      * @default 8 — the popup never touches the viewport edge.
      */
     collisionPadding?: number | Partial<Record<PhysicalSide, number>>;
     /**
-     * Element (or elements) collisions are measured against, instead of the
-     * popup's clipping ancestors. Use it to keep the suggestions inside a scroll
-     * container or one pane of a split layout rather than the whole viewport.
+     * Element or elements collisions are measured against instead of the popup's clipping ancestors.
+     * Use it to keep suggestions inside a scroll container or split pane.
      * @default undefined — the popup's clipping ancestors.
      */
     collisionBoundary?: Element | Element[] | null;
     /**
-     * Keep this popup mounted even while closed, instead of unmounting it.
+     * Keep this popup mounted even while closed.
      * @default false — the popup leaves the DOM entirely while closed.
      */
     forceMount?: boolean;
@@ -91,8 +67,8 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     "onInteract-outside"?: ((event: InteractOutsideEvent) => any) | undefined;
 }>, {
     forceMount: boolean;
-    side: Side;
     align: Align;
+    side: Side;
     sideOffset: number;
     alignOffset: number;
     avoidCollisions: boolean;

package/dist/autocomplete/AutocompleteContent.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const w=require("../utils/composeRefs.cjs"),O=require("../utils/useDismiss.cjs"),a=require("../utils/popper.cjs"),v=require("./context.cjs");let e=require("vue");var y=["data-state","data-side","data-align"],C=(0,e.defineComponent)({__name:"AutocompleteContent",props:{side:{default:"bottom"},align:{default:"start"},sideOffset:{default:4},alignOffset:{default:0},avoidCollisions:{type:Boolean,default:!0},collisionPadding:{default:8},collisionBoundary:{},forceMount:{type:Boolean,default:!1}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside"],setup(u,{emit:d}){const c=u,n=d,r=(0,e.inject)(v.AUTOCOMPLETE_CONTEXT);if(!r)throw new Error("SkdxAutocompleteContent must be used within SkdxAutocomplete.");const o=r,i=(0,e.inject)(a.POPPER_CONTEXT);if(!i)throw new Error("SkdxAutocompleteContent must be used within SkdxAutocomplete.");const s=(0,e.ref)(null),l=w.composeRefs(s,o.contentRef);O.useDismiss({enabled:o.open,onEscapeKeyDown:t=>{n("escape-key-down",t),t.defaultPrevented||o.revert()},onPointerDownOutside:t=>{n("pointer-down-outside",t),t.defaultPrevented||o.setOpen(!1)},onFocusOutside:t=>{n("focus-outside",t),t.defaultPrevented||o.setOpen(!1)},onInteractOutside:t=>n("interact-outside",t)},[s,o.inputRef,o.triggerRef]);const{style:f,placedSide:p,placedAlign:m}=a.usePopperPosition(i.anchor,s,o.open,()=>({...c,component:"autocomplete"}));function _(t){t.preventDefault()}return(t,P)=>u.forceMount||(0,e.unref)(o).open.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,class:"skdx-autocomplete__content","data-part":"content",ref:(0,e.unref)(l),"data-state":(0,e.unref)(o).open.value?"open":"closed","data-side":(0,e.unref)(p),"data-align":(0,e.unref)(m),style:(0,e.normalizeStyle)((0,e.unref)(f)),onMousedown:_},[(0,e.renderSlot)(t.$slots,"default")],44,y)):(0,e.createCommentVNode)("",!0)}});exports.default=C;
+const g=require("../utils/composeRefs.cjs"),v=require("../utils/useDismiss.cjs"),r=require("../utils/popper.cjs"),w=require("./context.cjs");let e=require("vue");var y=["aria-busy","data-loading","data-state","data-side","data-align"],O=(0,e.defineComponent)({__name:"AutocompleteContent",props:{side:{default:"bottom"},align:{default:"start"},sideOffset:{default:4},alignOffset:{default:0},avoidCollisions:{type:Boolean,default:!0},collisionPadding:{default:8},collisionBoundary:{},forceMount:{type:Boolean,default:!1}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside"],setup(u,{emit:d}){const l=u,n=d,a=(0,e.inject)(w.AUTOCOMPLETE_CONTEXT);if(!a)throw new Error("SkdxAutocompleteContent must be used within SkdxAutocomplete.");const o=a,i=(0,e.inject)(r.POPPER_CONTEXT);if(!i)throw new Error("SkdxAutocompleteContent must be used within SkdxAutocomplete.");const s=(0,e.ref)(null),c=g.composeRefs(s,o.contentRef);v.useDismiss({enabled:o.open,onEscapeKeyDown:t=>{n("escape-key-down",t),t.defaultPrevented||o.revert()},onPointerDownOutside:t=>{n("pointer-down-outside",t),t.defaultPrevented||o.setOpen(!1)},onFocusOutside:t=>{n("focus-outside",t),t.defaultPrevented||o.setOpen(!1)},onInteractOutside:t=>n("interact-outside",t)},[s,o.inputRef,o.triggerRef]);const{style:f,placedSide:p,placedAlign:m}=r.usePopperPosition(i.anchor,s,o.open,()=>({...l,component:"autocomplete"}));function _(t){t.preventDefault()}return(t,C)=>u.forceMount||(0,e.unref)(o).open.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,class:"skdx-autocomplete__content","data-part":"content",ref:(0,e.unref)(c),"aria-busy":(0,e.unref)(o).loading?!0:void 0,"data-loading":(0,e.unref)(o).loading?"":void 0,"data-state":(0,e.unref)(o).open.value?"open":"closed","data-side":(0,e.unref)(p),"data-align":(0,e.unref)(m),style:(0,e.normalizeStyle)((0,e.unref)(f)),onMousedown:_},[(0,e.renderSlot)(t.$slots,"default")],44,y)):(0,e.createCommentVNode)("",!0)}});exports.default=O;

package/dist/autocomplete/AutocompleteContent.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{POPPER_CONTEXT as o,usePopperPosition as s}from"../utils/popper.js";import{AUTOCOMPLETE_CONTEXT as n}from"./context.js";import{createCommentVNode as a,createElementBlock as i,defineComponent as d,inject as u,normalizeStyle as l,openBlock as r,ref as p,renderSlot as c,unref as f}from"vue";var m=["data-state","data-side","data-align"],w=/* @__PURE__ */d({__name:"AutocompleteContent",props:{side:{default:"bottom"},align:{default:"start"},sideOffset:{default:4},alignOffset:{default:0},avoidCollisions:{type:Boolean,default:!0},collisionPadding:{default:8},collisionBoundary:{},forceMount:{type:Boolean,default:!1}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside"],setup(d,{emit:w}){const O=d,v=w,P=u(n);if(!P)throw new Error("SkdxAutocompleteContent must be used within SkdxAutocomplete.");const k=P,y=u(o);if(!y)throw new Error("SkdxAutocompleteContent must be used within SkdxAutocomplete.");const C=p(null),E=e(C,k.contentRef);t({enabled:k.open,onEscapeKeyDown:e=>{v("escape-key-down",e),e.defaultPrevented||k.revert()},onPointerDownOutside:e=>{v("pointer-down-outside",e),e.defaultPrevented||k.setOpen(!1)},onFocusOutside:e=>{v("focus-outside",e),e.defaultPrevented||k.setOpen(!1)},onInteractOutside:e=>v("interact-outside",e)},[C,k.inputRef,k.triggerRef]);const{style:g,placedSide:x,placedAlign:A}=s(y.anchor,C,k.open,()=>({...O,component:"autocomplete"}));function S(e){e.preventDefault()}return(e,t)=>d.forceMount||f(k).open.value?(r(),i("div",{key:0,class:"skdx-autocomplete__content","data-part":"content",ref:f(E),"data-state":f(k).open.value?"open":"closed","data-side":f(x),"data-align":f(A),style:l(f(g)),onMousedown:S},[c(e.$slots,"default")],44,m)):a("",!0)}});export{w as default};
+import{composeRefs as e}from"../utils/composeRefs.js";import{useDismiss as t}from"../utils/useDismiss.js";import{POPPER_CONTEXT as o,usePopperPosition as n}from"../utils/popper.js";import{AUTOCOMPLETE_CONTEXT as s}from"./context.js";import{createCommentVNode as a,createElementBlock as i,defineComponent as d,inject as l,normalizeStyle as u,openBlock as r,ref as p,renderSlot as c,unref as f}from"vue";var m=["aria-busy","data-loading","data-state","data-side","data-align"],v=/* @__PURE__ */d({__name:"AutocompleteContent",props:{side:{default:"bottom"},align:{default:"start"},sideOffset:{default:4},alignOffset:{default:0},avoidCollisions:{type:Boolean,default:!0},collisionPadding:{default:8},collisionBoundary:{},forceMount:{type:Boolean,default:!1}},emits:["escape-key-down","pointer-down-outside","focus-outside","interact-outside"],setup(d,{emit:v}){const w=d,g=v,y=l(s);if(!y)throw new Error("SkdxAutocompleteContent must be used within SkdxAutocomplete.");const O=y,P=l(o);if(!P)throw new Error("SkdxAutocompleteContent must be used within SkdxAutocomplete.");const k=p(null),C=e(k,O.contentRef);t({enabled:O.open,onEscapeKeyDown:e=>{g("escape-key-down",e),e.defaultPrevented||O.revert()},onPointerDownOutside:e=>{g("pointer-down-outside",e),e.defaultPrevented||O.setOpen(!1)},onFocusOutside:e=>{g("focus-outside",e),e.defaultPrevented||O.setOpen(!1)},onInteractOutside:e=>g("interact-outside",e)},[k,O.inputRef,O.triggerRef]);const{style:E,placedSide:x,placedAlign:A}=n(P.anchor,k,O.open,()=>({...w,component:"autocomplete"}));function S(e){e.preventDefault()}return(e,t)=>d.forceMount||f(O).open.value?(r(),i("div",{key:0,class:"skdx-autocomplete__content","data-part":"content",ref:f(C),"aria-busy":!!f(O).loading||void 0,"data-loading":f(O).loading?"":void 0,"data-state":f(O).open.value?"open":"closed","data-side":f(x),"data-align":f(A),style:u(f(E)),onMousedown:S},[c(e.$slots,"default")],44,m)):a("",!0)}});export{v as default};

package/dist/autocomplete/AutocompleteEmpty.vue.d.cts

@@ -1,17 +1,9 @@
 /**
- * Fallback shown in place of the suggestion list when no `SkdxAutocompleteItem`s
- * are currently rendered — because the consumer's filtered results are empty, or
- * because the root's `filter` predicate rejected every one. Renders a
- * `<div role="presentation">`; renders nothing while at least one suggestion is
- * registered.
- *
- * Word it as "no matches", not "invalid": with the default `allowCustomValue`,
- * an empty list does **not** mean the user's text is rejected — it means nothing
- * was suggested and their own text is the answer.
- *
- * Belongs inside `SkdxAutocompleteContent` and *outside* `SkdxAutocompleteList` —
- * a non-option child of a listbox is a broken listbox. Must be used inside
- * `SkdxAutocomplete`.
+ * Fallback shown when no Items are rendered (empty filter results or filter predicate
+ * rejects all), rendering `<div role="presentation">`. Renders nothing while at least
+ * one suggestion is registered. Word it as "no matches", not "invalid" (empty list
+ * does not mean the user's text is rejected — they can use it). Must be inside
+ * Content and outside List (non-option children of listbox are broken).
  */
 type __VLS_Props = {};
 declare var __VLS_1: {};

package/dist/autocomplete/AutocompleteEmpty.vue.d.ts

@@ -1,17 +1,9 @@
 /**
- * Fallback shown in place of the suggestion list when no `SkdxAutocompleteItem`s
- * are currently rendered — because the consumer's filtered results are empty, or
- * because the root's `filter` predicate rejected every one. Renders a
- * `<div role="presentation">`; renders nothing while at least one suggestion is
- * registered.
- *
- * Word it as "no matches", not "invalid": with the default `allowCustomValue`,
- * an empty list does **not** mean the user's text is rejected — it means nothing
- * was suggested and their own text is the answer.
- *
- * Belongs inside `SkdxAutocompleteContent` and *outside* `SkdxAutocompleteList` —
- * a non-option child of a listbox is a broken listbox. Must be used inside
- * `SkdxAutocomplete`.
+ * Fallback shown when no Items are rendered (empty filter results or filter predicate
+ * rejects all), rendering `<div role="presentation">`. Renders nothing while at least
+ * one suggestion is registered. Word it as "no matches", not "invalid" (empty list
+ * does not mean the user's text is rejected — they can use it). Must be inside
+ * Content and outside List (non-option children of listbox are broken).
  */
 type __VLS_Props = {};
 declare var __VLS_1: {};

package/dist/autocomplete/AutocompleteGroup.vue.cjs

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

package/dist/autocomplete/AutocompleteGroup.vue.d.cts

@@ -0,0 +1,20 @@
+/**
+ * Groups related Items under a GroupLabel, rendering `<div role="group">` with
+ * aria-labelledby pointing at the label's id. Wiring is automatic (like Listbox,
+ * unlike Select): suggestion lists reshuffle sections on every keystroke, so bare
+ * "group" is hard to follow. Purely structural: group registers no suggestions,
+ * takes no part in highlight order.
+ */
+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/autocomplete/AutocompleteGroup.vue.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Groups related Items under a GroupLabel, rendering `<div role="group">` with
+ * aria-labelledby pointing at the label's id. Wiring is automatic (like Listbox,
+ * unlike Select): suggestion lists reshuffle sections on every keystroke, so bare
+ * "group" is hard to follow. Purely structural: group registers no suggestions,
+ * takes no part in highlight order.
+ */
+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/autocomplete/AutocompleteGroup.vue.js

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

package/dist/autocomplete/AutocompleteGroup.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const r=require("./context.cjs");let e=require("vue");var l=["aria-labelledby"],u=(0,e.defineComponent)({__name:"AutocompleteGroup",setup(a){const t=r.nextAutocompleteGroupLabelId();return(0,e.provide)(r.AUTOCOMPLETE_GROUP_CONTEXT,{labelId:t}),(o,p)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-autocomplete__group","data-part":"group",role:"group","aria-labelledby":(0,e.unref)(t)},[(0,e.renderSlot)(o.$slots,"default")],8,l))}});exports.default=u;

package/dist/autocomplete/AutocompleteGroup.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{AUTOCOMPLETE_GROUP_CONTEXT as e,nextAutocompleteGroupLabelId as a}from"./context.js";import{createElementBlock as o,defineComponent as t,openBlock as r,provide as l,renderSlot as s,unref as p}from"vue";var u=["aria-labelledby"],d=/* @__PURE__ */t({__name:"AutocompleteGroup",setup(t){const d=a();return l(e,{labelId:d}),(e,a)=>(r(),o("div",{class:"skdx-autocomplete__group","data-part":"group",role:"group","aria-labelledby":p(d)},[s(e.$slots,"default")],8,u))}});export{d as default};

package/dist/autocomplete/AutocompleteGroupLabel.vue.cjs

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

package/dist/autocomplete/AutocompleteGroupLabel.vue.d.cts

@@ -0,0 +1,18 @@
+/**
+ * The heading naming a Group, rendering a plain `<div>` carrying the id the
+ * group points aria-labelledby at. No role, so the heading is never a suggestion
+ * the arrow keys can land on. Must be used inside SkdxAutocompleteGroup.
+ */
+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/autocomplete/AutocompleteGroupLabel.vue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The heading naming a Group, rendering a plain `<div>` carrying the id the
+ * group points aria-labelledby at. No role, so the heading is never a suggestion
+ * the arrow keys can land on. Must be used inside SkdxAutocompleteGroup.
+ */
+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/autocomplete/AutocompleteGroupLabel.vue.js

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

package/dist/autocomplete/AutocompleteGroupLabel.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const u=require("./context.cjs");let e=require("vue");var l=["id"],a=(0,e.defineComponent)({__name:"AutocompleteGroupLabel",setup(_){const t=(0,e.inject)(u.AUTOCOMPLETE_GROUP_CONTEXT);if(!t)throw new Error("SkdxAutocompleteGroupLabel must be used within SkdxAutocompleteGroup.");const o=t;return(r,n)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-autocomplete__label","data-part":"label",id:(0,e.unref)(o).labelId},[(0,e.renderSlot)(r.$slots,"default")],8,l))}});exports.default=a;

package/dist/autocomplete/AutocompleteGroupLabel.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{AUTOCOMPLETE_GROUP_CONTEXT as e}from"./context.js";import{createElementBlock as t,defineComponent as o,inject as a,openBlock as l,renderSlot as r,unref as s}from"vue";var n=["id"],u=/* @__PURE__ */o({__name:"AutocompleteGroupLabel",setup(o){const u=a(e);if(!u)throw new Error("SkdxAutocompleteGroupLabel must be used within SkdxAutocompleteGroup.");const p=u;return(e,o)=>(l(),t("div",{class:"skdx-autocomplete__label","data-part":"label",id:s(p).labelId},[r(e.$slots,"default")],8,n))}});export{u as default};

package/dist/autocomplete/AutocompleteInput.vue.d.cts

@@ -1,25 +1,10 @@
 /**
- * The free-text field an `SkdxAutocomplete` is built around. Keeps real DOM
- * focus for the whole interaction and doubles as the popper anchor the popup
- * positions against. Renders an `<input type="text" role="combobox">` with
- * `aria-expanded`, `aria-controls` pointing at `SkdxAutocompleteList`,
- * `aria-autocomplete="list"`, `aria-activedescendant` tracking the
- * virtually-focused suggestion, `autocomplete="off"`, and
- * `aria-invalid`/`aria-readonly` plus their `data-*` twins from the root.
- *
- * Keyboard, in full:
- *
- * | Key | Effect |
- * | --- | --- |
- * | Arrow Down / Up | opens the popup, or moves the highlight — **DOM focus never moves** |
- * | Enter | commits the highlighted suggestion; with nothing highlighted, commits the raw text (when `allowCustomValue`) |
- * | Escape | closes and puts the last committed text back — owned by `SkdxAutocompleteContent` whenever one is mounted, so its cancelable `escape-key-down` can veto |
- * | Tab | commits the raw text and moves on — the free-text escape hatch |
- *
- * Blur commits the raw text too, which is the behaviour that separates this
- * family from `SkdxCombobox`: typing "foo" and clicking elsewhere keeps "foo".
- * Give it an accessible name — `aria-label`, `aria-labelledby`, or an
- * `SkdxLabel` pointing at it. Must be used inside `SkdxAutocomplete`.
+ * The free-text field an `SkdxAutocomplete` is built around, with real DOM
+ * focus for the entire interaction. Renders `<input type="text" role="combobox">`
+ * with aria-expanded, aria-controls, aria-autocomplete, aria-activedescendant
+ * (virtual focus), autocomplete="off", and the root's aria-invalid/aria-readonly
+ * plus name/form. Blur commits the raw text, keeping what was typed — the key
+ * difference from Combobox. Must be named and used inside SkdxAutocomplete.
  */
 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>;

package/dist/autocomplete/AutocompleteInput.vue.d.ts

@@ -1,25 +1,10 @@
 /**
- * The free-text field an `SkdxAutocomplete` is built around. Keeps real DOM
- * focus for the whole interaction and doubles as the popper anchor the popup
- * positions against. Renders an `<input type="text" role="combobox">` with
- * `aria-expanded`, `aria-controls` pointing at `SkdxAutocompleteList`,
- * `aria-autocomplete="list"`, `aria-activedescendant` tracking the
- * virtually-focused suggestion, `autocomplete="off"`, and
- * `aria-invalid`/`aria-readonly` plus their `data-*` twins from the root.
- *
- * Keyboard, in full:
- *
- * | Key | Effect |
- * | --- | --- |
- * | Arrow Down / Up | opens the popup, or moves the highlight — **DOM focus never moves** |
- * | Enter | commits the highlighted suggestion; with nothing highlighted, commits the raw text (when `allowCustomValue`) |
- * | Escape | closes and puts the last committed text back — owned by `SkdxAutocompleteContent` whenever one is mounted, so its cancelable `escape-key-down` can veto |
- * | Tab | commits the raw text and moves on — the free-text escape hatch |
- *
- * Blur commits the raw text too, which is the behaviour that separates this
- * family from `SkdxCombobox`: typing "foo" and clicking elsewhere keeps "foo".
- * Give it an accessible name — `aria-label`, `aria-labelledby`, or an
- * `SkdxLabel` pointing at it. Must be used inside `SkdxAutocomplete`.
+ * The free-text field an `SkdxAutocomplete` is built around, with real DOM
+ * focus for the entire interaction. Renders `<input type="text" role="combobox">`
+ * with aria-expanded, aria-controls, aria-autocomplete, aria-activedescendant
+ * (virtual focus), autocomplete="off", and the root's aria-invalid/aria-readonly
+ * plus name/form. Blur commits the raw text, keeping what was typed — the key
+ * difference from Combobox. Must be named and used inside SkdxAutocomplete.
  */
 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>;