@skdx/vue 0.27.0 → 0.29.0

package/dist/mentions/MentionsContent.vue.d.ts

@@ -0,0 +1,75 @@
+import { type Align, type PhysicalSide, type Side } from '../utils/popper.js';
+import { type FocusOutsideEvent, type InteractOutsideEvent } from '../utils/useDismiss.js';
+/** The floating listbox of mentionable items, positioned against the caret rather than the field. */
+type __VLS_Props = {
+    /**
+     * Preferred side of the caret to render on.
+     * @default 'bottom' — hangs below the caret, flips above it only when there is no room.
+     */
+    side?: Side;
+    /**
+     * Alignment along the chosen side, relative to the caret.
+     * @default 'start' — leading edge lines up with the caret.
+     */
+    align?: Align;
+    /**
+     * Distance in pixels between the popup and the caret along `side`.
+     * @default 4
+     */
+    sideOffset?: number;
+    /**
+     * Offset in pixels along `align`, shifting the popup perpendicular to `side`.
+     * @default 0
+     */
+    alignOffset?: number;
+    /**
+     * Flips to the opposite side when there isn't room to render on the preferred side.
+     * @default true
+     */
+    avoidCollisions?: boolean;
+    /**
+     * Minimum distance in pixels kept from the collision boundary (a 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.
+     * @default undefined — the popup's clipping ancestors.
+     */
+    collisionBoundary?: Element | Element[] | null;
+    /**
+     * Keep this popup mounted even while closed, for an exit transition.
+     * @default false — the popup leaves the DOM entirely while closed.
+     */
+    forceMount?: 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, {
+    "focus-outside": (event: FocusOutsideEvent) => any;
+    "escape-key-down": (event: KeyboardEvent) => any;
+    "pointer-down-outside": (event: PointerEvent) => any;
+    "interact-outside": (event: InteractOutsideEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onFocus-outside"?: (event: FocusOutsideEvent) => any;
+    "onEscape-key-down"?: (event: KeyboardEvent) => any;
+    "onPointer-down-outside"?: (event: PointerEvent) => any;
+    "onInteract-outside"?: (event: InteractOutsideEvent) => any;
+}>, {
+    align: Align;
+    forceMount: boolean;
+    side: Side;
+    sideOffset: number;
+    alignOffset: number;
+    avoidCollisions: boolean;
+    collisionPadding: number | Partial<Record<PhysicalSide, number>>;
+}, {}, {}, {}, 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/mentions/MentionsContent.vue.js

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

package/dist/mentions/MentionsContent.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const v=require("../utils/injectRequired.cjs"),g=require("../utils/composeRefs.cjs"),q=require("../utils/useDismiss.cjs"),y=require("../utils/popper.cjs"),k=require("./context.cjs");let e=require("vue");var w=["id","aria-busy","data-loading","data-trigger","data-state","data-side","data-align"],O=(0,e.defineComponent)({__name:"MentionsContent",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(r,{emit:a}){const u=r,o=a,n=v.injectRequired(k.MENTIONS_CONTEXT,"SkdxMentionsContent must be used within SkdxMentions."),i=(0,e.ref)(null),d=g.composeRefs(i,n.contentRef);q.useDismiss({enabled:n.open,onEscapeKeyDown:t=>{o("escape-key-down",t),t.defaultPrevented||n.dismiss()},onPointerDownOutside:t=>{o("pointer-down-outside",t),t.defaultPrevented||n.setOpen(!1)},onFocusOutside:t=>{o("focus-outside",t),t.defaultPrevented||n.setOpen(!1)},onInteractOutside:t=>o("interact-outside",t)},[i,n.fieldRef]);const{style:l,placedSide:c,placedAlign:f,reposition:s}=y.usePopperPosition(n.anchor,i,n.open,()=>({...u,component:"mentions"}));(0,e.watch)(n.token,()=>s(),{flush:"post"}),(0,e.watch)(n.fieldRef,(t,m,_)=>{t&&(t.addEventListener("scroll",s,{passive:!0}),_(()=>t.removeEventListener("scroll",s)))},{immediate:!0});function p(t){t.preventDefault()}return(t,m)=>r.forceMount||(0,e.unref)(n).open.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,id:(0,e.unref)(n).contentId,ref:(0,e.unref)(d),class:"skdx-mentions__content","data-part":"content",role:"listbox","aria-busy":(0,e.unref)(n).loading?!0:void 0,"data-loading":(0,e.unref)(n).loading?"":void 0,"data-trigger":(0,e.unref)(n).token.value?.trigger,"data-state":(0,e.unref)(n).open.value?"open":"closed","data-side":(0,e.unref)(c),"data-align":(0,e.unref)(f),style:(0,e.normalizeStyle)((0,e.unref)(l)),onMousedown:p},[(0,e.renderSlot)(t.$slots,"default")],44,w)):(0,e.createCommentVNode)("",!0)}});exports.default=O;

package/dist/mentions/MentionsContent.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{injectRequired as e}from"../utils/injectRequired.js";import{composeRefs as t}from"../utils/composeRefs.js";import{useDismiss as o}from"../utils/useDismiss.js";import{usePopperPosition as s}from"../utils/popper.js";import{MENTIONS_CONTEXT as n}from"./context.js";import{createCommentVNode as a,createElementBlock as i,defineComponent as d,normalizeStyle as l,openBlock as r,ref as u,renderSlot as p,unref as f,watch as c}from"vue";var m=["id","aria-busy","data-loading","data-trigger","data-state","data-side","data-align"],v=/* @__PURE__ */d({__name:"MentionsContent",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 g=d,y=v,k=e(n,"SkdxMentionsContent must be used within SkdxMentions."),w=u(null),O=t(w,k.contentRef);o({enabled:k.open,onEscapeKeyDown:e=>{y("escape-key-down",e),e.defaultPrevented||k.dismiss()},onPointerDownOutside:e=>{y("pointer-down-outside",e),e.defaultPrevented||k.setOpen(!1)},onFocusOutside:e=>{y("focus-outside",e),e.defaultPrevented||k.setOpen(!1)},onInteractOutside:e=>y("interact-outside",e)},[w,k.fieldRef]);const{style:j,placedSide:M,placedAlign:P,reposition:R}=s(k.anchor,w,k.open,()=>({...g,component:"mentions"}));function b(e){e.preventDefault()}return c(k.token,()=>R(),{flush:"post"}),c(k.fieldRef,(e,t,o)=>{e&&(e.addEventListener("scroll",R,{passive:!0}),o(()=>e.removeEventListener("scroll",R)))},{immediate:!0}),(e,t)=>d.forceMount||f(k).open.value?(r(),i("div",{key:0,id:f(k).contentId,ref:f(O),class:"skdx-mentions__content","data-part":"content",role:"listbox","aria-busy":!!f(k).loading||void 0,"data-loading":f(k).loading?"":void 0,"data-trigger":f(k).token.value?.trigger,"data-state":f(k).open.value?"open":"closed","data-side":f(M),"data-align":f(P),style:l(f(j)),onMousedown:b},[p(e.$slots,"default")],44,m)):a("",!0)}});export{v as default};

package/dist/mentions/MentionsEmpty.vue.cjs

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

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

@@ -0,0 +1,14 @@
+/** Shown in place of the item list when the active query matches nothing; renders a div role="presentation". */
+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/mentions/MentionsEmpty.vue.d.ts

@@ -0,0 +1,14 @@
+/** Shown in place of the item list when the active query matches nothing; renders a div role="presentation". */
+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/mentions/MentionsEmpty.vue.js

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

package/dist/mentions/MentionsEmpty.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const r=require("../utils/injectRequired.cjs"),o=require("./context.cjs");let e=require("vue");var u={key:0,class:"skdx-mentions__empty","data-part":"empty",role:"presentation"},i=(0,e.defineComponent)({__name:"MentionsEmpty",setup(s){const t=r.injectRequired(o.MENTIONS_CONTEXT,"SkdxMentionsEmpty must be used within SkdxMentions.");return(n,_)=>(0,e.unref)(t).itemCount.value===0?((0,e.openBlock)(),(0,e.createElementBlock)("div",u,[(0,e.renderSlot)(n.$slots,"default")])):(0,e.createCommentVNode)("",!0)}});exports.default=i;

package/dist/mentions/MentionsEmpty.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{injectRequired as e}from"../utils/injectRequired.js";import{MENTIONS_CONTEXT as t}from"./context.js";import{createCommentVNode as n,createElementBlock as s,defineComponent as o,openBlock as a,renderSlot as r,unref as i}from"vue";var m={key:0,class:"skdx-mentions__empty","data-part":"empty",role:"presentation"},d=/* @__PURE__ */o({__name:"MentionsEmpty",setup(o){const d=e(t,"SkdxMentionsEmpty must be used within SkdxMentions.");return(e,t)=>0===i(d).itemCount.value?(a(),s("div",m,[r(e.$slots,"default")])):n("",!0)}});export{d as default};

package/dist/mentions/MentionsInput.vue.cjs

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

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

@@ -0,0 +1,9 @@
+/** The multi-line field mentions are typed into; renders a `<textarea aria-haspopup="listbox">` with the full ARIA wiring. */
+type __VLS_Props = {};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    /** Moves keyboard focus onto the underlying native textarea. */
+    focus: (options?: FocusOptions) => void | undefined;
+    /** The underlying native `<textarea>` element, for focus and measurement. */
+    el: import("vue").Ref<HTMLTextAreaElement | null, HTMLTextAreaElement | null>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/mentions/MentionsInput.vue.d.ts

@@ -0,0 +1,9 @@
+/** The multi-line field mentions are typed into; renders a `<textarea aria-haspopup="listbox">` with the full ARIA wiring. */
+type __VLS_Props = {};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    /** Moves keyboard focus onto the underlying native textarea. */
+    focus: (options?: FocusOptions) => void | undefined;
+    /** The underlying native `<textarea>` element, for focus and measurement. */
+    el: import("vue").Ref<HTMLTextAreaElement | null, HTMLTextAreaElement | null>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/mentions/MentionsInput.vue.js

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

package/dist/mentions/MentionsInput.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const k=require("../utils/injectRequired.cjs"),b=require("../utils/reassertValue.cjs"),x=require("../utils/measure-auto-resize.cjs"),w=require("./context.cjs");let t=require("vue");var I=["aria-controls","aria-activedescendant","rows","name","form","required","disabled","readonly","aria-invalid","aria-readonly","aria-busy","data-trigger","data-invalid","data-readonly","data-loading","data-disabled","data-state","value"],q=(0,t.defineComponent)({__name:"MentionsInput",setup(R,{expose:s}){const e=k.injectRequired(w.MENTIONS_CONTEXT,"SkdxMentionsInput must be used within SkdxMentions."),i=(0,t.ref)(null);let o=!1;function u(){const n=i.value;!n||!e.autoResize||(n.style.height=`${x.measureAutoResizeHeight(n,e.maxRows,e.minRows)}px`)}(0,t.onMounted)(()=>{e.fieldRef.value=i.value,u()}),(0,t.watch)(e.value,()=>{(0,t.nextTick)(u)});function f(n){e.setActiveId(n.id,"keyboard"),n.scrollIntoView?.({block:"nearest"})}function c(n){const a=e.orderedOptions();if(a.length===0)return;const l=a.findIndex(h=>h.id===e.activeId.value);let d=l;l===-1&&(d=n===1?-1:0),f(a[e.loop?(d+n+a.length)%a.length:Math.min(a.length-1,Math.max(0,d+n))])}function v(){const n=e.activeId.value,a=n?e.getItem(n):void 0;return a?(e.insertItem(a.value,a.text||a.value,"keyboard"),!0):!1}function p(n){const a=n.target;e.setValue(a.value,"keyboard",null),u(),!o&&!n.isComposing&&e.detect(),b.reassertValue(a,()=>e.value.value)}function r(n){o||n.isComposing||e.detect()}function m(){o=!0}function y(){o=!1,e.detect()}function g(){e.setOpen(!1)}function _(n){if(e.disabled||o||n.isComposing)return;const a=e.open.value;if(n.key==="ArrowDown"||n.key==="ArrowUp"){if(!a)return;n.preventDefault(),c(n.key==="ArrowDown"?1:-1)}else if(n.key==="Enter"||n.key==="Tab")a&&v()&&n.preventDefault();else if(n.key==="Escape"){if(!a||e.contentRef.value)return;n.preventDefault(),e.dismiss()}}return s({focus:n=>i.value?.focus(n),el:i}),(n,a)=>((0,t.openBlock)(),(0,t.createElementBlock)("textarea",{ref_key:"elRef",ref:i,class:"skdx-mentions__input","data-part":"input","aria-haspopup":"listbox","aria-autocomplete":"list","aria-controls":(0,t.unref)(e).open.value?(0,t.unref)(e).contentId:void 0,"aria-activedescendant":(0,t.unref)(e).activeId.value??void 0,autocomplete:"off",rows:(0,t.unref)(e).autoResize?void 0:(0,t.unref)(e).minRows,name:(0,t.unref)(e).name,form:(0,t.unref)(e).form,required:(0,t.unref)(e).required||void 0,disabled:(0,t.unref)(e).disabled||void 0,readonly:(0,t.unref)(e).readOnly||void 0,"aria-invalid":(0,t.unref)(e).invalid?!0:void 0,"aria-readonly":(0,t.unref)(e).readOnly?!0:void 0,"aria-busy":(0,t.unref)(e).loading?!0:void 0,"data-trigger":(0,t.unref)(e).token.value?.trigger,"data-invalid":(0,t.unref)(e).invalid?"":void 0,"data-readonly":(0,t.unref)(e).readOnly?"":void 0,"data-loading":(0,t.unref)(e).loading?"":void 0,"data-disabled":(0,t.unref)(e).disabled?"":void 0,"data-state":(0,t.unref)(e).open.value?"open":"closed",value:(0,t.unref)(e).value.value,style:(0,t.normalizeStyle)((0,t.unref)(e).autoResize?{overflow:"hidden",resize:"none"}:void 0),onInput:p,onSelect:r,onSelectionchange:r,onClick:r,onKeyup:r,onCompositionstart:m,onCompositionend:y,onKeydown:_,onBlur:g},null,44,I))}});exports.default=q;

package/dist/mentions/MentionsInput.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{injectRequired as e}from"../utils/injectRequired.js";import{reassertValue as a}from"../utils/reassertValue.js";import{measureAutoResizeHeight as t}from"../utils/measure-auto-resize.js";import{MENTIONS_CONTEXT as n}from"./context.js";import{createElementBlock as o,defineComponent as i,nextTick as r,normalizeStyle as d,onMounted as s,openBlock as l,ref as u,unref as v,watch as c}from"vue";var f=["aria-controls","aria-activedescendant","rows","name","form","required","disabled","readonly","aria-invalid","aria-readonly","aria-busy","data-trigger","data-invalid","data-readonly","data-loading","data-disabled","data-state","value"],p=/* @__PURE__ */i({__name:"MentionsInput",setup(i,{expose:p}){const m=e(n,"SkdxMentionsInput must be used within SkdxMentions."),y=u(null);let g=!1;function k(){const e=y.value;!e||!m.autoResize||(e.style.height=`${t(e,m.maxRows,m.minRows)}px`)}function b(e){const t=e.target;m.setValue(t.value,"keyboard",null),k(),!g&&!e.isComposing&&m.detect(),a(t,()=>m.value.value)}function w(e){g||e.isComposing||m.detect()}function h(){g=!0}function x(){g=!1,m.detect()}function I(){m.setOpen(!1)}function R(e){if(m.disabled||g||e.isComposing)return;const a=m.open.value;if("ArrowDown"===e.key||"ArrowUp"===e.key){if(!a)return;e.preventDefault(),function(e){const a=m.orderedOptions();if(0===a.length)return;const t=a.findIndex(e=>e.id===m.activeId.value);let n=t;-1===t&&(n=1===e?-1:0),function(e){m.setActiveId(e.id,"keyboard"),e.scrollIntoView?.({block:"nearest"})}(a[m.loop?(n+e+a.length)%a.length:Math.min(a.length-1,Math.max(0,n+e))])}("ArrowDown"===e.key?1:-1)}else if("Enter"===e.key||"Tab"===e.key)a&&function(){const e=m.activeId.value,a=e?m.getItem(e):void 0;return!!a&&(m.insertItem(a.value,a.text||a.value,"keyboard"),!0)}()&&e.preventDefault();else if("Escape"===e.key){if(!a||m.contentRef.value)return;e.preventDefault(),m.dismiss()}}return s(()=>{m.fieldRef.value=y.value,k()}),c(m.value,()=>{r(k)}),p({focus:e=>y.value?.focus(e),el:y}),(e,a)=>(l(),o("textarea",{ref_key:"elRef",ref:y,class:"skdx-mentions__input","data-part":"input","aria-haspopup":"listbox","aria-autocomplete":"list","aria-controls":v(m).open.value?v(m).contentId:void 0,"aria-activedescendant":v(m).activeId.value??void 0,autocomplete:"off",rows:v(m).autoResize?void 0:v(m).minRows,name:v(m).name,form:v(m).form,required:v(m).required||void 0,disabled:v(m).disabled||void 0,readonly:v(m).readOnly||void 0,"aria-invalid":!!v(m).invalid||void 0,"aria-readonly":!!v(m).readOnly||void 0,"aria-busy":!!v(m).loading||void 0,"data-trigger":v(m).token.value?.trigger,"data-invalid":v(m).invalid?"":void 0,"data-readonly":v(m).readOnly?"":void 0,"data-loading":v(m).loading?"":void 0,"data-disabled":v(m).disabled?"":void 0,"data-state":v(m).open.value?"open":"closed",value:v(m).value.value,style:d(v(m).autoResize?{overflow:"hidden",resize:"none"}:void 0),onInput:b,onSelect:w,onSelectionchange:w,onClick:w,onKeyup:w,onCompositionstart:h,onCompositionend:x,onKeydown:R,onBlur:I},null,44,f))}});export{p as default};

package/dist/mentions/MentionsItem.vue.cjs

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

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

@@ -0,0 +1,36 @@
+/** One mentionable entry; renders a `div role="option"` highlighted virtually, never focused, so the caret stays where the user left it. */
+type __VLS_Props = {
+    /** Identifier published as data-value and carried on the value-change detail when this entry is inserted. */
+    value: string;
+    /**
+     * Which trigger character this entry belongs to, so one field can address several collections.
+     * @default undefined — the first configured trigger.
+     */
+    trigger?: string | undefined;
+    /**
+     * Text the `filter` predicate matches and the default `serialize` writes into the field.
+     * @default undefined — falls back to the entry's rendered text content.
+     */
+    textValue?: string | undefined;
+    /**
+     * Excludes this entry from insertion and from pointer or keyboard highlight.
+     * @default false
+     */
+    disabled?: boolean | undefined;
+};
+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<{}>, {
+    disabled: boolean | undefined;
+    trigger: string | undefined;
+    textValue: string | undefined;
+}, {}, {}, {}, 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/mentions/MentionsItem.vue.d.ts

@@ -0,0 +1,36 @@
+/** One mentionable entry; renders a `div role="option"` highlighted virtually, never focused, so the caret stays where the user left it. */
+type __VLS_Props = {
+    /** Identifier published as data-value and carried on the value-change detail when this entry is inserted. */
+    value: string;
+    /**
+     * Which trigger character this entry belongs to, so one field can address several collections.
+     * @default undefined — the first configured trigger.
+     */
+    trigger?: string | undefined;
+    /**
+     * Text the `filter` predicate matches and the default `serialize` writes into the field.
+     * @default undefined — falls back to the entry's rendered text content.
+     */
+    textValue?: string | undefined;
+    /**
+     * Excludes this entry from insertion and from pointer or keyboard highlight.
+     * @default false
+     */
+    disabled?: boolean | undefined;
+};
+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<{}>, {
+    disabled: boolean | undefined;
+    trigger: string | undefined;
+    textValue: string | undefined;
+}, {}, {}, {}, 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/mentions/MentionsItem.vue.js

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

package/dist/mentions/MentionsItem.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const _=require("../utils/injectRequired.cjs"),g=require("./context.cjs");let e=require("vue");var h=["id","data-value","data-trigger","data-highlighted","aria-disabled","data-disabled"],x=(0,e.defineComponent)({__name:"MentionsItem",props:{value:{},trigger:{default:void 0},textValue:{default:void 0},disabled:{type:Boolean,default:!1}},setup(d){const a=d,t=_.injectRequired(g.MENTIONS_CONTEXT,"SkdxMentionsItem must be used within SkdxMentions."),n=g.nextMentionsItemId(),s=(0,e.ref)(null),m=(0,e.computed)(()=>t.activeId.value===n),l=(0,e.computed)(()=>a.disabled||t.disabled||t.readOnly),u=(0,e.computed)(()=>a.trigger??t.defaultTrigger.value),i=(0,e.ref)(a.textValue??null);function v(){const r=a.textValue??s.value?.textContent;r!=null&&r!==i.value&&(i.value=r)}const o=(0,e.computed)(()=>i.value===null?u.value===t.activeTrigger.value:t.isOption(i.value,u.value));function c(){if(!o.value){t.unregisterItem(n);return}t.registerItem(n,{value:a.value,text:i.value??"",trigger:u.value})}(0,e.onMounted)(()=>{v(),c()}),(0,e.onUpdated)(v),(0,e.watch)([o,()=>a.value,i,u],c),(0,e.onBeforeUnmount)(()=>t.unregisterItem(n));function f(){l.value||t.insertItem(a.value,i.value??a.value,"pointer")}function p(){l.value||t.setActiveId(n,"pointer")}return(r,I)=>o.value?((0,e.openBlock)(),(0,e.createElementBlock)("div",{key:0,id:(0,e.unref)(n),ref_key:"itemRef",ref:s,class:"skdx-mentions__item","data-part":"item",role:"option","data-value":d.value,"data-trigger":u.value,"data-highlighted":m.value?"":void 0,"aria-disabled":l.value?!0:void 0,"data-disabled":l.value?"":void 0,onClick:f,onPointerenter:p},[(0,e.renderSlot)(r.$slots,"default")],40,h)):(0,e.createCommentVNode)("",!0)}});exports.default=x;

package/dist/mentions/MentionsItem.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{injectRequired as e}from"../utils/injectRequired.js";import{MENTIONS_CONTEXT as t,nextMentionsItemId as a}from"./context.js";import{computed as l,createCommentVNode as i,createElementBlock as n,defineComponent as u,onBeforeUnmount as d,onMounted as o,onUpdated as r,openBlock as s,ref as v,renderSlot as m,unref as c,watch as g}from"vue";var f=["id","data-value","data-trigger","data-highlighted","aria-disabled","data-disabled"],p=/* @__PURE__ */u({__name:"MentionsItem",props:{value:{},trigger:{default:void 0},textValue:{default:void 0},disabled:{type:Boolean,default:!1}},setup(u){const p=u,x=e(t,"SkdxMentionsItem must be used within SkdxMentions."),I=a(),b=v(null),h=l(()=>x.activeId.value===I),k=l(()=>p.disabled||x.disabled||x.readOnly),M=l(()=>p.trigger??x.defaultTrigger.value),_=v(p.textValue??null);function C(){const e=p.textValue??b.value?.textContent;null!=e&&e!==_.value&&(_.value=e)}const T=l(()=>null===_.value?M.value===x.activeTrigger.value:x.isOption(_.value,M.value));function j(){T.value?x.registerItem(I,{value:p.value,text:_.value??"",trigger:M.value}):x.unregisterItem(I)}function y(){k.value||x.insertItem(p.value,_.value??p.value,"pointer")}function B(){k.value||x.setActiveId(I,"pointer")}return o(()=>{C(),j()}),r(C),g([T,()=>p.value,_,M],j),d(()=>x.unregisterItem(I)),(e,t)=>T.value?(s(),n("div",{key:0,id:c(I),ref_key:"itemRef",ref:b,class:"skdx-mentions__item","data-part":"item",role:"option","data-value":u.value,"data-trigger":M.value,"data-highlighted":h.value?"":void 0,"aria-disabled":!!k.value||void 0,"data-disabled":k.value?"":void 0,onClick:y,onPointerenter:B},[m(e.$slots,"default")],40,f)):i("",!0)}});export{p as default};

package/dist/mentions/MentionsPortal.vue.cjs

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

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

@@ -0,0 +1,29 @@
+import type { PortalContainer } from '../utils/portal.cjs';
+/** Teleports its children to document.body (or a custom container) while the popup is open. */
+type __VLS_Props = {
+    /**
+     * DOM node or CSS selector the children are rendered into.
+     * @default document.body
+     */
+    container?: PortalContainer;
+    /**
+     * Mount Content even while closed, for an animation library's exit transition.
+     * @default false — the popup leaves the DOM entirely while closed.
+     */
+    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/mentions/MentionsPortal.vue.d.ts

@@ -0,0 +1,29 @@
+import type { PortalContainer } from '../utils/portal.js';
+/** Teleports its children to document.body (or a custom container) while the popup is open. */
+type __VLS_Props = {
+    /**
+     * DOM node or CSS selector the children are rendered into.
+     * @default document.body
+     */
+    container?: PortalContainer;
+    /**
+     * Mount Content even while closed, for an animation library's exit transition.
+     * @default false — the popup leaves the DOM entirely while closed.
+     */
+    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/mentions/MentionsPortal.vue.js

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

package/dist/mentions/MentionsPortal.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const o=require("../utils/injectRequired.cjs"),u=require("../utils/Portal.vue.cjs"),a=require("./context.cjs");let e=require("vue");var i=(0,e.defineComponent)({__name:"MentionsPortal",props:{container:{default:null},forceMount:{type:Boolean,default:!1}},setup(t){const n=o.injectRequired(a.MENTIONS_CONTEXT,"SkdxMentionsPortal must be used within SkdxMentions.");return(r,l)=>t.forceMount||(0,e.unref)(n).open.value?((0,e.openBlock)(),(0,e.createBlock)(u.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=i;

package/dist/mentions/MentionsPortal.vue_vue_type_script_setup_true_lang.js

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

package/dist/mentions/caret-rect.cjs

@@ -0,0 +1 @@
+var p=["fontFamily","fontSize","fontSizeAdjust","fontStretch","fontStyle","fontVariant","fontWeight","letterSpacing","textTransform","textIndent","wordSpacing","lineHeight","tabSize","paddingTop","paddingRight","paddingBottom","paddingLeft","borderTopWidth","borderRightWidth","borderBottomWidth","borderLeftWidth","boxSizing","width"],s=(e,r)=>{const i=getComputedStyle(e),t=document.createElement("div");t.style.position="absolute",t.style.visibility="hidden",t.style.whiteSpace="pre-wrap",t.style.overflowWrap="break-word";for(const d of p)t.style[d]=i[d];t.style.height="auto",t.textContent=e.value.slice(0,r);const o=document.createElement("span");o.textContent=e.value.slice(r)||".",t.append(o),document.body.append(t);const a=e.getBoundingClientRect(),n=o.getBoundingClientRect(),c=t.getBoundingClientRect(),l={top:a.top+(n.top-c.top)-e.scrollTop,left:a.left+(n.left-c.left)-e.scrollLeft,height:parseFloat(i.lineHeight)||n.height};return t.remove(),l};exports.measureCaretRect=s;

package/dist/mentions/caret-rect.d.cts

@@ -0,0 +1,3 @@
+import type { MeasureCaretRect } from '../utils/mentions.cjs';
+/** @internal The viewport rectangle of the caret at `offset` inside `field`, measured against a hidden mirror of it. */
+export declare const measureCaretRect: MeasureCaretRect;

package/dist/mentions/caret-rect.d.ts

@@ -0,0 +1,3 @@
+import type { MeasureCaretRect } from '../utils/mentions.js';
+/** @internal The viewport rectangle of the caret at `offset` inside `field`, measured against a hidden mirror of it. */
+export declare const measureCaretRect: MeasureCaretRect;

package/dist/mentions/caret-rect.js

@@ -0,0 +1 @@
+var t=["fontFamily","fontSize","fontSizeAdjust","fontStretch","fontStyle","fontVariant","fontWeight","letterSpacing","textTransform","textIndent","wordSpacing","lineHeight","tabSize","paddingTop","paddingRight","paddingBottom","paddingLeft","borderTopWidth","borderRightWidth","borderBottomWidth","borderLeftWidth","boxSizing","width"],e=(e,o)=>{const n=getComputedStyle(e),i=document.createElement("div");i.style.position="absolute",i.style.visibility="hidden",i.style.whiteSpace="pre-wrap",i.style.overflowWrap="break-word";for(const e of t)i.style[e]=n[e];i.style.height="auto",i.textContent=e.value.slice(0,o);const d=document.createElement("span");d.textContent=e.value.slice(o)||".",i.append(d),document.body.append(i);const l=e.getBoundingClientRect(),r=d.getBoundingClientRect(),a=i.getBoundingClientRect(),p={top:l.top+(r.top-a.top)-e.scrollTop,left:l.left+(r.left-a.left)-e.scrollLeft,height:parseFloat(n.lineHeight)||r.height};return i.remove(),p};export{e as measureCaretRect};

package/dist/mentions/context.cjs

@@ -0,0 +1 @@
+const r=require("../utils/id.cjs");var l='[role="option"]:not([data-disabled])';function u(t,e){const n=t.querySelector('[data-part="viewport"]')??t;if(n===e||!n.contains(e))return;const o=n.getBoundingClientRect(),i=e.getBoundingClientRect();n.scrollTop+=i.top-o.top-(o.height-i.height)/2}var s=Symbol("skdx-mentions-context");function a(){return r.nextId("mentions-content")}function c(){return r.nextId("mentions-item")}function d(t){return`${t} result${t===1?"":"s"} available`}function f(t){return`${t.trigger}${t.textValue}`}function I(t,e){return t.toLowerCase().includes(e.trim().toLowerCase())}function p(t){return typeof t=="string"?[...t]:t}exports.MENTIONS_CONTEXT=s;exports.OPTION_SELECTOR=l;exports.defaultGetResultCountLabel=d;exports.defaultMentionSerialize=f;exports.defaultOptionsFilter=I;exports.nextMentionsContentId=a;exports.nextMentionsItemId=c;exports.scrollIntoPopup=u;exports.triggerList=p;

package/dist/mentions/context.d.cts

@@ -0,0 +1,165 @@
+import type { InjectionKey, Ref } from 'vue';
+import type { MentionToken, VirtualAnchor } from '../utils/mentions.cjs';
+/** @internal Selector matching enabled option elements inside the popup. */
+export declare const OPTION_SELECTOR = "[role=\"option\"]:not([data-disabled])";
+/** @internal Scrolls an option into view inside the popup only, so floating-ui's first positioning frame cannot scroll the page. */
+export declare function scrollIntoPopup(content: HTMLElement, option: HTMLElement): void;
+/**
+ * How Items are narrowed against the active query — the substring between the
+ * trigger character and the caret, never the whole field value. `'manual'`
+ * narrows nothing; a predicate returns a boolean to filter or a number to rank.
+ */
+export type MentionsFilter = 'manual' | ((itemText: string, query: string) => boolean | number);
+/** Builds the text that replaces the typed token when an item is chosen. */
+export type MentionsSerializer = (item: {
+    /** The Item's `value`, the identifier the entry is known by. */
+    value: string;
+    /** The Item's `textValue`, or the text it rendered. */
+    textValue: string;
+    /** The trigger character of the token being replaced. */
+    trigger: string;
+}) => string;
+/** What kind of interaction drove a value change. */
+export type MentionsChangeReason = 'keyboard' | 'pointer' | 'programmatic';
+/** Why virtual focus moved; `'auto'` covers filtering, re-seeding and `autoHighlight`. */
+export type MentionsHighlightReason = 'keyboard' | 'pointer' | 'auto';
+/** Payload for the `highlight-change` event, naming what moved and why. */
+export interface MentionsHighlightChangeDetail {
+    /** Item value now holding virtual focus, or null when none does. */
+    value: string | null;
+    /** Item value that held it before, or null. */
+    previousValue: string | null;
+    /** What moved the highlight. */
+    reason: MentionsHighlightReason;
+}
+/** The mention an insertion just wrote, and the range of text it replaced. */
+export interface MentionsInsertedMention {
+    /** Trigger character of the token that was replaced. */
+    trigger: string;
+    /** The chosen Item's `value`. */
+    value: string;
+    /** The text `serialize` produced and the field now contains. */
+    text: string;
+    /** Offset of the replaced token's trigger character. */
+    start: number;
+    /** Offset just past the replaced token's query. */
+    end: number;
+}
+/** Payload for the `value-change` event: the whole field text, never the mention alone. */
+export interface MentionsValueChangeDetail {
+    /** The field's full text after the change. */
+    value: string;
+    /** The field's full text before it, or null when there was none. */
+    previousValue: string | null;
+    /** What kind of interaction drove the change. */
+    reason: MentionsChangeReason;
+    /** The mention just inserted, or null for an ordinary keystroke. */
+    mention: MentionsInsertedMention | null;
+}
+/** Payload for the `query-change` event: the token under the caret, or null once none is being typed. */
+export interface MentionsQueryChangeDetail {
+    /** The active trigger character. */
+    trigger: string;
+    /** Text between the trigger character and the caret. */
+    query: string;
+    /** Offset of the trigger character in the field value. */
+    start: number;
+    /** Offset just past the query, which is the caret offset. */
+    end: number;
+}
+/** One mentionable entry for the `options` recipe. */
+export interface MentionsOption {
+    /** Identifier published as data-value and carried on the value-change detail. */
+    value: string;
+    /** Text matched by `filter` and written by the default `serialize`. @default undefined — falls back to `value`. */
+    label?: string;
+    /** Trigger character this entry belongs to. @default undefined — the first configured trigger. */
+    trigger?: string;
+    /** Excludes this entry from insertion and highlight. @default false */
+    disabled?: boolean;
+}
+/** @internal What one registered Item contributes to the root's collection. */
+export interface MentionsItemEntry {
+    /** The Item's `value`. */
+    value: string;
+    /** The Item's `textValue`, or its rendered text. */
+    text: string;
+    /** The trigger character this entry belongs to. */
+    trigger: string;
+}
+/** @internal Shared state the Mentions root provides to its parts. */
+export interface MentionsContext {
+    /** The real `<textarea>`, which keeps DOM focus for the whole interaction. */
+    fieldRef: Ref<HTMLTextAreaElement | null>;
+    contentRef: Ref<HTMLElement | null>;
+    /** Content's id, which the field's `aria-controls` names while open. */
+    contentId: string;
+    /** The field's full text. */
+    value: Readonly<Ref<string>>;
+    /** Publishes a new field text, tagged with what drove it and the mention it inserted. */
+    setValue(next: string, reason: MentionsChangeReason, mention: MentionsInsertedMention | null): void;
+    open: Readonly<Ref<boolean>>;
+    setOpen(open: boolean): void;
+    /** The token under the caret, or null when no mention is being typed. */
+    token: Readonly<Ref<MentionToken | null>>;
+    /** The trigger character in force: the active token's, or the first configured one. */
+    activeTrigger: Readonly<Ref<string>>;
+    /** The first configured trigger, which an Item declaring none belongs to. */
+    defaultTrigger: Readonly<Ref<string>>;
+    /** Re-derives the token from the field's text and caret, then opens or closes accordingly. */
+    detect(): void;
+    /** Closes the popup for the token being typed, leaving the text and caret untouched. */
+    dismiss(): void;
+    /** Replaces the active token with the serialized mention and puts the caret just past it. */
+    insertItem(value: string, text: string, reason: MentionsChangeReason): void;
+    /** The zero-width rectangle standing on the caret that Content is positioned against; re-measured on every read. */
+    anchor: Readonly<Ref<VirtualAnchor | null>>;
+    activeId: Readonly<Ref<string | null>>;
+    /** Moves virtual focus, tagging the move with what caused it for `highlight-change`. */
+    setActiveId(id: string | null, reason?: MentionsHighlightReason): void;
+    itemCount: Readonly<Ref<number>>;
+    registerItem(id: string, entry: MentionsItemEntry): void;
+    unregisterItem(id: string): void;
+    /** The registered entry behind an option id, for committing the highlighted one. */
+    getItem(id: string): MentionsItemEntry | undefined;
+    /** Whether an entry is an option at all: its trigger matches, and it survives the filter. */
+    isOption(itemText: string, itemTrigger: string): boolean;
+    /** Visible options in traversal order — score-sorted when `filter` ranks, DOM order otherwise. */
+    orderedOptions(): HTMLElement[];
+    /** Whether arrow navigation wraps around the ends of the item list. */
+    loop: boolean;
+    /** Grows the field to fit its content instead of scrolling. */
+    autoResize: boolean;
+    /** The field's opening size and the floor auto-resize will not shrink below. */
+    minRows: number;
+    /** Caps auto-resize growth to this many rows. */
+    maxRows: number | undefined;
+    disabled: boolean;
+    readOnly: boolean;
+    invalid: boolean;
+    required: boolean;
+    /** Whether items are in flight, published as `aria-busy` and `data-loading`. */
+    loading: boolean;
+    /** Form field name the full text is submitted under. */
+    name: string | undefined;
+    /** Id of the `<form>` the field submits into. */
+    form: string | undefined;
+}
+/** @internal Injection key the Mentions root provides its shared state under. */
+export declare const MENTIONS_CONTEXT: InjectionKey<MentionsContext>;
+/** @internal Generates a unique id for a Mentions popup. */
+export declare function nextMentionsContentId(): string;
+/** @internal Generates a unique, stable-per-instance id for a MentionsItem. */
+export declare function nextMentionsItemId(): string;
+/** Default `getResultCountLabel`: "1 result available" / "3 results available". */
+export declare function defaultGetResultCountLabel(count: number): string;
+/** Default `serialize`: the trigger character followed by the entry's text, so "@ali" becomes "@Alice". */
+export declare function defaultMentionSerialize(item: {
+    value: string;
+    textValue: string;
+    trigger: string;
+}): string;
+/** Case-insensitive substring match on the query — the default filter for a derived `options` field. */
+export declare function defaultOptionsFilter(text: string, query: string): boolean;
+/** @internal The configured trigger characters, read one character at a time when given as a string. */
+export declare function triggerList(triggers: string | readonly string[]): readonly string[];