@skdx/vue 0.28.0 → 0.29.0

package/dist/loading-overlay/LoadingOverlayRoot.vue.d.cts

@@ -1,33 +1,5 @@
 /**
- * The headless root of a loading overlay (see `@skdx/shared`'s
- * `loadingOverlayContract`). Wraps the covered content, owns visibility
- * (`visible`/`visible-change`), and shares it with `<SkdxLoadingOverlayBackdrop>`
- * and `<SkdxLoadingOverlayContent>` via `provide`. Renders a plain `<div>`:
- * `position: relative` scopes the backdrop to this box; `fullScreen` covers
- * the viewport instead.
- *
- * While visible the root is `aria-busy="true"` and its `covered` wrapper
- * carries `inert`, so pointer and keyboard both stop at the overlay instead
- * of reaching the hidden controls. Deliberately **not** a focus trap — there
- * is nothing inside to focus or dismiss, so trapping would strand the
- * keyboard on a spinner.
- *
- * The two attributes sit on two elements on purpose: `inert` removes its
- * subtree from the accessibility tree, so `aria-busy` beside it would vanish
- * too and the busy state would announce to nobody. The same reasoning routes
- * the announcement through the process-wide live region (see
- * `utils/liveAnnouncer`) instead of the `<SkdxSpinner>` inside, where
- * `role="status"` announces nothing.
- *
- * `delay` exists for the same reason `SkdxTooltip` has one: a request
- * resolving in 80ms should never paint a spinner. The timer cancels if
- * `visible` flips back to false first, or on unmount.
- *
- * `data-state` is `"visible"`/`"hidden"` and reflects the *effective*
- * visibility, i.e. after `delay`.
- *
- * Renders its default slot verbatim inside `covered` and derives nothing —
- * `SkdxLoadingOverlay` is this root plus the derived Backdrop and Content.
+ * Renders the headless root of a loading overlay, sharing `visible` with `<SkdxLoadingOverlayBackdrop>` and `<SkdxLoadingOverlayContent>`.
  *
  * @example With `import * as LoadingOverlay from '@skdx/vue/primitives/loading-overlay'`:
  * ```vue
@@ -40,15 +12,12 @@
  */
 type __VLS_Props = {
     /**
-     * Whether work is in flight for controlled usage. Pair with
-     * `v-model:visible` or `@visible-change`.
+     * Whether work is in flight, for controlled usage via `v-model:visible` or `@visible-change`.
      * @default undefined — uncontrolled, tracks internally.
      */
-    visible?: boolean;
+    visible?: boolean | undefined;
     /**
-     * Cover the viewport instead of the root's box. Emits `data-full-screen`
-     * and locks body scroll while visible; inline overlays never lock the
-     * body.
+     * Covers the viewport instead of the root's box, emitting `data-full-screen` and locking body scroll while visible.
      * @default false — covers only the root's box; body scroll is untouched.
      */
     fullScreen?: boolean;
@@ -59,19 +28,12 @@ type __VLS_Props = {
      */
     loadingLabel?: string;
     /**
-     * Text announced when the overlay hides, closing the loop the appearance
-     * announcement opens (the region became operable again — a change
-     * screen-reader users cannot see). Omitted: the overlay clears its
-     * message from the live region, allowing consecutive loads to announce
-     * twice.
+     * Text announced when the overlay hides; omitted, it clears its own message from the live region instead.
      * @default undefined — hiding announces nothing.
      */
-    loadedLabel?: string;
+    loadedLabel?: string | undefined;
     /**
-     * Milliseconds to wait after `visible` turns true before the overlay
-     * renders. Responses arriving inside this window never render the
-     * overlay, preventing spinner flash on fast requests. The timer cancels
-     * if `visible` flips back to false or on unmount.
+     * Milliseconds to wait after `visible` turns true before the overlay renders, avoiding spinner flash on fast responses.
      * @default 0 — shows immediately; nothing is hidden from a slow connection.
      */
     delay?: number;
@@ -84,13 +46,12 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     "update:visible": (visible: boolean) => any;
     "visible-change": (visible: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:visible"?: ((visible: boolean) => any) | undefined;
-    "onVisible-change"?: ((visible: boolean) => any) | undefined;
+    "onUpdate:visible"?: (visible: boolean) => any;
+    "onVisible-change"?: (visible: boolean) => any;
 }>, {
-    visible: boolean;
+    visible: boolean | undefined;
     loadingLabel: string;
     fullScreen: boolean;
-    loadedLabel: string;
     delay: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/loading-overlay/LoadingOverlayRoot.vue.d.ts

@@ -1,33 +1,5 @@
 /**
- * The headless root of a loading overlay (see `@skdx/shared`'s
- * `loadingOverlayContract`). Wraps the covered content, owns visibility
- * (`visible`/`visible-change`), and shares it with `<SkdxLoadingOverlayBackdrop>`
- * and `<SkdxLoadingOverlayContent>` via `provide`. Renders a plain `<div>`:
- * `position: relative` scopes the backdrop to this box; `fullScreen` covers
- * the viewport instead.
- *
- * While visible the root is `aria-busy="true"` and its `covered` wrapper
- * carries `inert`, so pointer and keyboard both stop at the overlay instead
- * of reaching the hidden controls. Deliberately **not** a focus trap — there
- * is nothing inside to focus or dismiss, so trapping would strand the
- * keyboard on a spinner.
- *
- * The two attributes sit on two elements on purpose: `inert` removes its
- * subtree from the accessibility tree, so `aria-busy` beside it would vanish
- * too and the busy state would announce to nobody. The same reasoning routes
- * the announcement through the process-wide live region (see
- * `utils/liveAnnouncer`) instead of the `<SkdxSpinner>` inside, where
- * `role="status"` announces nothing.
- *
- * `delay` exists for the same reason `SkdxTooltip` has one: a request
- * resolving in 80ms should never paint a spinner. The timer cancels if
- * `visible` flips back to false first, or on unmount.
- *
- * `data-state` is `"visible"`/`"hidden"` and reflects the *effective*
- * visibility, i.e. after `delay`.
- *
- * Renders its default slot verbatim inside `covered` and derives nothing —
- * `SkdxLoadingOverlay` is this root plus the derived Backdrop and Content.
+ * Renders the headless root of a loading overlay, sharing `visible` with `<SkdxLoadingOverlayBackdrop>` and `<SkdxLoadingOverlayContent>`.
  *
  * @example With `import * as LoadingOverlay from '@skdx/vue/primitives/loading-overlay'`:
  * ```vue
@@ -40,15 +12,12 @@
  */
 type __VLS_Props = {
     /**
-     * Whether work is in flight for controlled usage. Pair with
-     * `v-model:visible` or `@visible-change`.
+     * Whether work is in flight, for controlled usage via `v-model:visible` or `@visible-change`.
      * @default undefined — uncontrolled, tracks internally.
      */
-    visible?: boolean;
+    visible?: boolean | undefined;
     /**
-     * Cover the viewport instead of the root's box. Emits `data-full-screen`
-     * and locks body scroll while visible; inline overlays never lock the
-     * body.
+     * Covers the viewport instead of the root's box, emitting `data-full-screen` and locking body scroll while visible.
      * @default false — covers only the root's box; body scroll is untouched.
      */
     fullScreen?: boolean;
@@ -59,19 +28,12 @@ type __VLS_Props = {
      */
     loadingLabel?: string;
     /**
-     * Text announced when the overlay hides, closing the loop the appearance
-     * announcement opens (the region became operable again — a change
-     * screen-reader users cannot see). Omitted: the overlay clears its
-     * message from the live region, allowing consecutive loads to announce
-     * twice.
+     * Text announced when the overlay hides; omitted, it clears its own message from the live region instead.
      * @default undefined — hiding announces nothing.
      */
-    loadedLabel?: string;
+    loadedLabel?: string | undefined;
     /**
-     * Milliseconds to wait after `visible` turns true before the overlay
-     * renders. Responses arriving inside this window never render the
-     * overlay, preventing spinner flash on fast requests. The timer cancels
-     * if `visible` flips back to false or on unmount.
+     * Milliseconds to wait after `visible` turns true before the overlay renders, avoiding spinner flash on fast responses.
      * @default 0 — shows immediately; nothing is hidden from a slow connection.
      */
     delay?: number;
@@ -84,13 +46,12 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     "update:visible": (visible: boolean) => any;
     "visible-change": (visible: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:visible"?: ((visible: boolean) => any) | undefined;
-    "onVisible-change"?: ((visible: boolean) => any) | undefined;
+    "onUpdate:visible"?: (visible: boolean) => any;
+    "onVisible-change"?: (visible: boolean) => any;
 }>, {
-    visible: boolean;
+    visible: boolean | undefined;
     loadingLabel: string;
     fullScreen: boolean;
-    loadedLabel: string;
     delay: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/loading-overlay/LoadingOverlayRoot.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const p=require("../utils/useBodyScrollLock.cjs"),r=require("../utils/liveAnnouncer.cjs"),_=require("./context.cjs");let e=require("vue");var m=["aria-busy","data-state","data-full-screen"],b=["inert"],y=(0,e.defineComponent)({__name:"LoadingOverlayRoot",props:{visible:{type:Boolean,default:void 0},fullScreen:{type:Boolean,default:!1},loadingLabel:{default:"Loading"},loadedLabel:{default:void 0},delay:{default:0}},emits:["update:visible","visible-change"],setup(n,{emit:c}){const a=n,u=c,s=(0,e.computed)(()=>a.visible===void 0?!1:a.visible),o=(0,e.ref)(!1);(0,e.watch)([s,()=>a.delay],([t,i],L,v)=>{if(!t||i<=0)return;const f=setTimeout(()=>{o.value=!0},i);v(()=>{clearTimeout(f),o.value=!1})},{immediate:!0});const l=(0,e.computed)(()=>s.value&&(a.delay<=0||o.value));(0,e.watch)(l,t=>{u("update:visible",t),u("visible-change",t)});let d=!1;return(0,e.watchEffect)(()=>{if(l.value){d=!0,r.announce(a.loadingLabel);return}d&&(d=!1,a.loadedLabel?r.announce(a.loadedLabel):r.clearAnnouncements("polite"))}),p.useBodyScrollLock((0,e.computed)(()=>l.value&&a.fullScreen)),(0,e.provide)(_.LOADING_OVERLAY_CONTEXT,{visible:l,fullScreen:(0,e.computed)(()=>a.fullScreen),loadingLabel:(0,e.computed)(()=>a.loadingLabel)}),(t,i)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-loading-overlay","data-part":"root","data-skdx-component":"loading-overlay","aria-busy":l.value?"true":void 0,"data-state":l.value?"visible":"hidden","data-full-screen":n.fullScreen?"":void 0},[(0,e.createElementVNode)("div",{class:"skdx-loading-overlay__covered","data-part":"covered",style:{display:"contents"},inert:l.value||void 0},[(0,e.renderSlot)(t.$slots,"default")],8,b)],8,m))}});exports.default=y;
+const d=require("../utils/liveAnnouncer.cjs"),p=require("../utils/useBodyScrollLock.cjs"),_=require("./context.cjs");let e=require("vue");var m=["aria-busy","data-state","data-full-screen"],b=["inert"],y=(0,e.defineComponent)({__name:"LoadingOverlayRoot",props:{visible:{type:Boolean,default:void 0},fullScreen:{type:Boolean,default:!1},loadingLabel:{default:"Loading"},loadedLabel:{},delay:{default:0}},emits:["update:visible","visible-change"],setup(n,{emit:c}){const a=n,u=c,s=(0,e.computed)(()=>a.visible===void 0?!1:a.visible),o=(0,e.ref)(!1);(0,e.watch)([s,()=>a.delay],([t,i],L,v)=>{if(!t||i<=0)return;const f=setTimeout(()=>{o.value=!0},i);v(()=>{clearTimeout(f),o.value=!1})},{immediate:!0});const l=(0,e.computed)(()=>s.value&&(a.delay<=0||o.value));(0,e.watch)(l,t=>{u("update:visible",t),u("visible-change",t)});let r=!1;return(0,e.watchEffect)(()=>{if(l.value){r=!0,d.announce(a.loadingLabel);return}r&&(r=!1,a.loadedLabel?d.announce(a.loadedLabel):d.clearAnnouncements("polite"))}),p.useBodyScrollLock((0,e.computed)(()=>l.value&&a.fullScreen)),(0,e.provide)(_.LOADING_OVERLAY_CONTEXT,{visible:l,fullScreen:(0,e.computed)(()=>a.fullScreen),loadingLabel:(0,e.computed)(()=>a.loadingLabel)}),(t,i)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",{class:"skdx-loading-overlay","data-part":"root","data-skdx-component":"loading-overlay","aria-busy":l.value?"true":void 0,"data-state":l.value?"visible":"hidden","data-full-screen":n.fullScreen?"":void 0},[(0,e.createElementVNode)("div",{class:"skdx-loading-overlay__covered","data-part":"covered",style:{display:"contents"},inert:l.value||void 0},[(0,e.renderSlot)(t.$slots,"default")],8,b)],8,m))}});exports.default=y;

package/dist/loading-overlay/LoadingOverlayRoot.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{useBodyScrollLock as e}from"../utils/useBodyScrollLock.js";import{announce as a,clearAnnouncements as l}from"../utils/liveAnnouncer.js";import{LOADING_OVERLAY_CONTEXT as o}from"./context.js";import{computed as t,createElementBlock as i,createElementVNode as d,defineComponent as s,openBlock as n,provide as r,ref as u,renderSlot as v,watch as c,watchEffect as f}from"vue";var m=["aria-busy","data-state","data-full-screen"],p=["inert"],b=/* @__PURE__ */s({__name:"LoadingOverlayRoot",props:{visible:{type:Boolean,default:void 0},fullScreen:{type:Boolean,default:!1},loadingLabel:{default:"Loading"},loadedLabel:{default:void 0},delay:{default:0}},emits:["update:visible","visible-change"],setup(s,{emit:b}){const y=s,L=b,g=t(()=>void 0!==y.visible&&y.visible),S=u(!1);c([g,()=>y.delay],([e,a],l,o)=>{if(!e||a<=0)return;const t=setTimeout(()=>{S.value=!0},a);o(()=>{clearTimeout(t),S.value=!1})},{immediate:!0});const k=t(()=>g.value&&(y.delay<=0||S.value));c(k,e=>{L("update:visible",e),L("visible-change",e)});let B=!1;return f(()=>{if(k.value)return B=!0,void a(y.loadingLabel);B&&(B=!1,y.loadedLabel?a(y.loadedLabel):l("polite"))}),e(t(()=>k.value&&y.fullScreen)),r(o,{visible:k,fullScreen:t(()=>y.fullScreen),loadingLabel:t(()=>y.loadingLabel)}),(e,a)=>(n(),i("div",{class:"skdx-loading-overlay","data-part":"root","data-skdx-component":"loading-overlay","aria-busy":k.value?"true":void 0,"data-state":k.value?"visible":"hidden","data-full-screen":s.fullScreen?"":void 0},[d("div",{class:"skdx-loading-overlay__covered","data-part":"covered",style:{display:"contents"},inert:k.value||void 0},[v(e.$slots,"default")],8,p)],8,m))}});export{b as default};
+import{announce as e,clearAnnouncements as a}from"../utils/liveAnnouncer.js";import{useBodyScrollLock as l}from"../utils/useBodyScrollLock.js";import{LOADING_OVERLAY_CONTEXT as o}from"./context.js";import{computed as t,createElementBlock as i,createElementVNode as d,defineComponent as s,openBlock as n,provide as r,ref as u,renderSlot as c,watch as v,watchEffect as f}from"vue";var m=["aria-busy","data-state","data-full-screen"],p=["inert"],b=/* @__PURE__ */s({__name:"LoadingOverlayRoot",props:{visible:{type:Boolean,default:void 0},fullScreen:{type:Boolean,default:!1},loadingLabel:{default:"Loading"},loadedLabel:{},delay:{default:0}},emits:["update:visible","visible-change"],setup(s,{emit:b}){const y=s,L=b,g=t(()=>void 0!==y.visible&&y.visible),S=u(!1);v([g,()=>y.delay],([e,a],l,o)=>{if(!e||a<=0)return;const t=setTimeout(()=>{S.value=!0},a);o(()=>{clearTimeout(t),S.value=!1})},{immediate:!0});const k=t(()=>g.value&&(y.delay<=0||S.value));v(k,e=>{L("update:visible",e),L("visible-change",e)});let B=!1;return f(()=>{if(k.value)return B=!0,void e(y.loadingLabel);B&&(B=!1,y.loadedLabel?e(y.loadedLabel):a("polite"))}),l(t(()=>k.value&&y.fullScreen)),r(o,{visible:k,fullScreen:t(()=>y.fullScreen),loadingLabel:t(()=>y.loadingLabel)}),(e,a)=>(n(),i("div",{class:"skdx-loading-overlay","data-part":"root","data-skdx-component":"loading-overlay","aria-busy":k.value?"true":void 0,"data-state":k.value?"visible":"hidden","data-full-screen":s.fullScreen?"":void 0},[d("div",{class:"skdx-loading-overlay__covered","data-part":"covered",style:{display:"contents"},inert:k.value||void 0},[c(e.$slots,"default")],8,p)],8,m))}});export{b as default};

package/dist/loading-overlay/context.d.cts

@@ -1,9 +1,7 @@
 import type { ComputedRef, InjectionKey } from 'vue';
 /** @internal Shared state a `SkdxLoadingOverlay` provides to its backdrop and content parts. */
 export interface LoadingOverlayContext {
-    /**
-     * The effective visibility — `visible` after `delay` elapses, not the raw prop.
-     */
+    /** The effective visibility — `visible` after `delay` elapses, not the raw prop. */
     visible: ComputedRef<boolean>;
     fullScreen: ComputedRef<boolean>;
     loadingLabel: ComputedRef<string>;

package/dist/loading-overlay/context.d.ts

@@ -1,9 +1,7 @@
 import type { ComputedRef, InjectionKey } from 'vue';
 /** @internal Shared state a `SkdxLoadingOverlay` provides to its backdrop and content parts. */
 export interface LoadingOverlayContext {
-    /**
-     * The effective visibility — `visible` after `delay` elapses, not the raw prop.
-     */
+    /** The effective visibility — `visible` after `delay` elapses, not the raw prop. */
     visible: ComputedRef<boolean>;
     fullScreen: ComputedRef<boolean>;
     loadingLabel: ComputedRef<string>;

package/dist/loading-overlay/primitives.d.cts

@@ -1,8 +1,5 @@
 /**
  * Advanced primitives for `SkdxLoadingOverlay` — the parts the recipe composes.
- * Use when you need a different structure (e.g., progress bar instead of spinner).
- * `SkdxLoadingOverlayRoot` owns visibility, delay, inert wrapper, announcements;
- * renders content verbatim.
  *
  * @example
  * ```vue

package/dist/loading-overlay/primitives.d.ts

@@ -1,8 +1,5 @@
 /**
  * Advanced primitives for `SkdxLoadingOverlay` — the parts the recipe composes.
- * Use when you need a different structure (e.g., progress bar instead of spinner).
- * `SkdxLoadingOverlayRoot` owns visibility, delay, inert wrapper, announcements;
- * renders content verbatim.
  *
  * @example
  * ```vue

package/dist/mentions/Mentions.vue.cjs

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

package/dist/mentions/Mentions.vue.d.cts

@@ -0,0 +1,210 @@
+import { type MentionsFilter, type MentionsHighlightChangeDetail, type MentionsOption, type MentionsQueryChangeDetail, type MentionsSerializer, type MentionsValueChangeDetail } from './context.cjs';
+/**
+ * A multi-line field whose trigger characters open a caret-anchored listbox, and choosing an item replaces only the typed token.
+ *
+ * @example
+ * ```vue
+ * <SkdxMentions :options="[{ value: 'alice', label: 'Alice' }]" aria-label="Message" />
+ * ```
+ */
+type __VLS_Props = {
+    /**
+     * The field's full text, for controlled usage; pair with `v-model:value`.
+     * @default undefined — uncontrolled, tracks its own text internally.
+     */
+    value?: string | undefined;
+    /**
+     * Initial text of the field, and the text a form reset restores.
+     * @default '' — the field opens empty.
+     */
+    defaultValue?: string;
+    /**
+     * Characters that open a mention when typed at a word boundary, read one character at a time.
+     * @default '@' — a single people-mention trigger.
+     */
+    triggers?: string | readonly string[];
+    /**
+     * Mentionable collection as data, rendered as one Item per entry by the derived anatomy.
+     * @default undefined — the default slot must compose the field itself.
+     */
+    options?: MentionsOption[] | undefined;
+    /**
+     * Narrows Items against the active query: `'manual'` filters nothing, a predicate filters and ranks.
+     * @default 'manual' — with `options` supplied, a case-insensitive match on the query.
+     */
+    filter?: MentionsFilter;
+    /**
+     * Builds the text that replaces the typed token when an item is chosen.
+     * @default (item) => `${item.trigger}${item.textValue}` — the trigger character followed by the item's text.
+     */
+    serialize?: MentionsSerializer;
+    /**
+     * Whether a single space follows an inserted mention, skipped where the text already continues with whitespace.
+     * @default true
+     */
+    appendSpace?: boolean;
+    /**
+     * How many spaces a query may contain before the mention is abandoned.
+     * @default 0 — the first space ends it, which is what a handle needs.
+     */
+    allowedSpaces?: number;
+    /**
+     * Whether a trigger only opens a mention at the start of the value or after a non-word character.
+     * @default true — keeps "user@example.com" from opening a popup mid-address.
+     */
+    requireWordBoundary?: boolean;
+    /**
+     * Controlled open state of the popup; pair with `v-model:open`.
+     * @default undefined — uncontrolled, tracks its own open state internally.
+     */
+    open?: boolean | undefined;
+    /**
+     * Initial open state of the popup, for uncontrolled usage.
+     * @default false — the popup waits for a trigger character.
+     */
+    defaultOpen?: boolean;
+    /**
+     * Keeps the first item highlighted whenever the filtered list changes while open, so Enter always has a target.
+     * @default true — the opposite of Combobox, since a mention popup exists only to be committed.
+     */
+    autoHighlight?: boolean;
+    /**
+     * Wraps arrow navigation around the ends of the item list.
+     * @default true
+     */
+    loop?: boolean;
+    /**
+     * Marks items as in flight, exposed as `aria-busy`/`data-loading`, and suppresses the result-count announcement.
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Grows the field to fit its content instead of showing a scrollbar.
+     * @default false
+     */
+    autoResize?: boolean;
+    /**
+     * The field's opening size, and the floor auto-resize will not shrink below.
+     * @default 2 — the platform's own `rows` default.
+     */
+    minRows?: number;
+    /**
+     * Caps auto-resize growth to this many rows, based on computed line-height.
+     * @default undefined — grows without limit.
+     */
+    maxRows?: number | undefined;
+    /**
+     * Disables the field so no mention can ever open, and no text can be entered.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Makes the field read-only while keeping it focusable; trigger detection is suspended.
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * Marks the field invalid, exposed as `aria-invalid`/`data-invalid` on the Input.
+     * @default false
+     */
+    invalid?: boolean;
+    /**
+     * Form field name the field's full text is submitted under.
+     * @default undefined — the field submits nothing at all.
+     */
+    name?: string | undefined;
+    /**
+     * Id of the `<form>` this field submits into, so it can live outside that form's subtree.
+     * @default undefined — associates with the nearest ancestor `<form>`.
+     */
+    form?: string | undefined;
+    /**
+     * Marks the field required for native constraint validation while its text is empty.
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Formats the polite announcement when the rendered item count changes while open; return an empty string to announce nothing.
+     * @default defaultGetResultCountLabel — e.g. `"3 results available"`.
+     */
+    getResultCountLabel?: (count: number) => string;
+    /**
+     * Accessible name for the derived Input and Content, neither of which takes a name from content.
+     * @default undefined — the Input is unnamed, which axe reports under `aria-input-field-name`.
+     */
+    ariaLabel?: string | undefined;
+    /**
+     * Placeholder text forwarded to the derived Input.
+     * @default undefined
+     */
+    placeholder?: string | undefined;
+};
+type __VLS_Slots = {
+    /** Manual composition of the field, popup and items, replacing the derived `options` anatomy. */
+    default?(): unknown;
+    /** Body of a derived mention row, for markup its `label` string cannot express; `highlighted` is that row's virtual focus state. */
+    option?(props: {
+        option: MentionsOption;
+        highlighted: boolean;
+    }): unknown;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    /** Moves keyboard focus to the text field, which is where this component keeps real DOM focus. */
+    focus: () => void | undefined;
+    /** Reports whether the field satisfies its constraints, delegating to the real textarea; true with none mounted. */
+    checkValidity: () => boolean;
+    /** Like `checkValidity()`, but also shows the browser's validation message. */
+    reportValidity: () => boolean;
+    /** Pushes an externally-computed error onto the real textarea, like `HTMLTextAreaElement.setCustomValidity()`. */
+    setCustomValidity: (message: string) => void | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (open: boolean) => any;
+    "open-change": (open: boolean) => any;
+    "update:value": (value: string) => any;
+    "value-change": (detail: MentionsValueChangeDetail) => any;
+    "open-change-complete": (open: boolean) => any;
+    "highlight-change": (detail: MentionsHighlightChangeDetail) => any;
+    "query-change": (detail: MentionsQueryChangeDetail | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: (open: boolean) => any;
+    "onOpen-change"?: (open: boolean) => any;
+    "onUpdate:value"?: (value: string) => any;
+    "onValue-change"?: (detail: MentionsValueChangeDetail) => any;
+    "onOpen-change-complete"?: (open: boolean) => any;
+    "onHighlight-change"?: (detail: MentionsHighlightChangeDetail) => any;
+    "onQuery-change"?: (detail: MentionsQueryChangeDetail | null) => any;
+}>, {
+    form: string | undefined;
+    filter: MentionsFilter;
+    loading: boolean;
+    disabled: boolean;
+    placeholder: string | undefined;
+    name: string | undefined;
+    open: boolean | undefined;
+    defaultOpen: boolean;
+    defaultValue: string;
+    readOnly: boolean;
+    required: boolean;
+    value: string | undefined;
+    ariaLabel: string | undefined;
+    invalid: boolean;
+    options: MentionsOption[] | undefined;
+    loop: boolean;
+    allowedSpaces: number;
+    requireWordBoundary: boolean;
+    autoResize: boolean;
+    maxRows: number | undefined;
+    minRows: number;
+    autoHighlight: boolean;
+    getResultCountLabel: (count: number) => string;
+    triggers: string | readonly string[];
+    serialize: MentionsSerializer;
+    appendSpace: boolean;
+}, {}, {}, {}, 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;
+    };
+};