@skdx/vue 0.28.0 → 0.30.0

package/dist/autocomplete/AutocompleteList.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{AUTOCOMPLETE_CONTEXT as t}from"./context.js";import{createElementBlock as e,defineComponent as o,inject as s,openBlock as a,renderSlot as r,unref as l}from"vue";var i=["id"],n=/* @__PURE__ */o({__name:"AutocompleteList",setup(o){const n=s(t);if(!n)throw new Error("SkdxAutocompleteList must be used within SkdxAutocomplete.");return(t,o)=>(a(),e("div",{class:"skdx-autocomplete__list","data-part":"list",role:"listbox",id:l(n).listId},[r(t.$slots,"default")],8,i))}});export{n as default};
+import{injectRequired as t}from"../utils/injectRequired.js";import{AUTOCOMPLETE_CONTEXT as e}from"./context.js";import{createElementBlock as o,defineComponent as s,openBlock as i,renderSlot as a,unref as l}from"vue";var r=["id"],d=/* @__PURE__ */s({__name:"AutocompleteList",setup(s){const d=t(e,"SkdxAutocompleteList must be used within SkdxAutocomplete.");return(t,e)=>(i(),o("div",{id:l(d).listId,class:"skdx-autocomplete__list","data-part":"list",role:"listbox"},[a(t.$slots,"default")],8,r))}});export{d as default};

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

@@ -1,9 +1,5 @@
 import type { PortalContainer } from '../utils/portal.cjs';
-/**
- * Teleports its children to document.body (or a custom container) while the
- * popup is open, so suggestions escape clipping and overflow. Renders nothing
- * while closed unless forceMount is set. Must be used inside SkdxAutocomplete.
- */
+/** 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.

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

@@ -1,9 +1,5 @@
 import type { PortalContainer } from '../utils/portal.js';
-/**
- * Teleports its children to document.body (or a custom container) while the
- * popup is open, so suggestions escape clipping and overflow. Renders nothing
- * while closed unless forceMount is set. Must be used inside SkdxAutocomplete.
- */
+/** 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.

package/dist/autocomplete/AutocompletePortal.vue_vue_type_script_setup_true_lang.cjs

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

package/dist/autocomplete/AutocompletePortal.vue_vue_type_script_setup_true_lang.js

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

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

@@ -1,9 +1,4 @@
-/**
- * Optional button that toggles the suggestion popup (the "▾" affordance).
- * Renders `<button type="button">` with aria-expanded and aria-controls, tabindex="-1"
- * (the input is the widget; Arrow Down is the keyboard path). Give it an aria-label;
- * a glyph is not an accessible name. Must be used inside SkdxAutocomplete.
- */
+/** Optional button that toggles the suggestion popup; renders a button with aria-expanded and aria-controls. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

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

@@ -1,9 +1,4 @@
-/**
- * Optional button that toggles the suggestion popup (the "▾" affordance).
- * Renders `<button type="button">` with aria-expanded and aria-controls, tabindex="-1"
- * (the input is the widget; Arrow Down is the keyboard path). Give it an aria-label;
- * a glyph is not an accessible name. Must be used inside SkdxAutocomplete.
- */
+/** Optional button that toggles the suggestion popup; renders a button with aria-expanded and aria-controls. */
 type __VLS_Props = {};
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/autocomplete/AutocompleteTrigger.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const l=require("./context.cjs");let e=require("vue");var d=["aria-expanded","aria-controls","disabled","data-disabled","data-readonly","data-state"],i=(0,e.defineComponent)({__name:"AutocompleteTrigger",setup(s){const n=(0,e.inject)(l.AUTOCOMPLETE_CONTEXT);if(!n)throw new Error("SkdxAutocompleteTrigger must be used within SkdxAutocomplete.");const t=n,r=(0,e.ref)(null);(0,e.onMounted)(()=>{t.triggerRef.value=r.value}),(0,e.onBeforeUnmount)(()=>{t.triggerRef.value===r.value&&(t.triggerRef.value=null)});function o(a){a.preventDefault()}function u(){t.readOnly||(t.setOpen(!t.open.value),t.inputRef.value?.focus())}return(a,c)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-autocomplete__trigger","data-part":"trigger",ref_key:"elRef",ref:r,type:"button",tabindex:-1,"aria-expanded":(0,e.unref)(t).open.value,"aria-controls":(0,e.unref)(t).listId,disabled:(0,e.unref)(t).disabled||void 0,"data-disabled":(0,e.unref)(t).disabled?"":void 0,"data-readonly":(0,e.unref)(t).readOnly?"":void 0,"data-state":(0,e.unref)(t).open.value?"open":"closed",onMousedown:o,onClick:u},[(0,e.renderSlot)(a.$slots,"default")],40,d))}});exports.default=i;
+const u=require("../utils/injectRequired.cjs"),d=require("./context.cjs");let t=require("vue");var l=["aria-expanded","aria-controls","disabled","data-disabled","data-readonly","data-state"],i=(0,t.defineComponent)({__name:"AutocompleteTrigger",setup(s){const e=u.injectRequired(d.AUTOCOMPLETE_CONTEXT,"SkdxAutocompleteTrigger must be used within SkdxAutocomplete."),r=(0,t.ref)(null);(0,t.onMounted)(()=>{e.triggerRef.value=r.value}),(0,t.onBeforeUnmount)(()=>{e.triggerRef.value===r.value&&(e.triggerRef.value=null)});function n(a){a.preventDefault()}function o(){e.readOnly||(e.setOpen(!e.open.value),e.inputRef.value?.focus())}return(a,c)=>((0,t.openBlock)(),(0,t.createElementBlock)("button",{ref_key:"elRef",ref:r,class:"skdx-autocomplete__trigger","data-part":"trigger",type:"button",tabindex:-1,"aria-expanded":(0,t.unref)(e).open.value,"aria-controls":(0,t.unref)(e).listId,disabled:(0,t.unref)(e).disabled||void 0,"data-disabled":(0,t.unref)(e).disabled?"":void 0,"data-readonly":(0,t.unref)(e).readOnly?"":void 0,"data-state":(0,t.unref)(e).open.value?"open":"closed",onMousedown:n,onClick:o},[(0,t.renderSlot)(a.$slots,"default")],40,l))}});exports.default=i;

package/dist/autocomplete/AutocompleteTrigger.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{AUTOCOMPLETE_CONTEXT as e}from"./context.js";import{createElementBlock as a,defineComponent as t,inject as o,onBeforeUnmount as n,onMounted as r,openBlock as d,ref as l,renderSlot as s,unref as i}from"vue";var u=["aria-expanded","aria-controls","disabled","data-disabled","data-readonly","data-state"],p=/* @__PURE__ */t({__name:"AutocompleteTrigger",setup(t){const p=o(e);if(!p)throw new Error("SkdxAutocompleteTrigger must be used within SkdxAutocomplete.");const f=p,c=l(null);function v(e){e.preventDefault()}function g(){f.readOnly||(f.setOpen(!f.open.value),f.inputRef.value?.focus())}return r(()=>{f.triggerRef.value=c.value}),n(()=>{f.triggerRef.value===c.value&&(f.triggerRef.value=null)}),(e,t)=>(d(),a("button",{class:"skdx-autocomplete__trigger","data-part":"trigger",ref_key:"elRef",ref:c,type:"button",tabindex:-1,"aria-expanded":i(f).open.value,"aria-controls":i(f).listId,disabled:i(f).disabled||void 0,"data-disabled":i(f).disabled?"":void 0,"data-readonly":i(f).readOnly?"":void 0,"data-state":i(f).open.value?"open":"closed",onMousedown:v,onClick:g},[s(e.$slots,"default")],40,u))}});export{p as default};
+import{injectRequired as e}from"../utils/injectRequired.js";import{AUTOCOMPLETE_CONTEXT as a}from"./context.js";import{createElementBlock as t,defineComponent as o,onBeforeUnmount as n,onMounted as r,openBlock as d,ref as l,renderSlot as s,unref as i}from"vue";var u=["aria-expanded","aria-controls","disabled","data-disabled","data-readonly","data-state"],p=/* @__PURE__ */o({__name:"AutocompleteTrigger",setup(o){const p=e(a,"SkdxAutocompleteTrigger must be used within SkdxAutocomplete."),f=l(null);function c(e){e.preventDefault()}function m(){p.readOnly||(p.setOpen(!p.open.value),p.inputRef.value?.focus())}return r(()=>{p.triggerRef.value=f.value}),n(()=>{p.triggerRef.value===f.value&&(p.triggerRef.value=null)}),(e,a)=>(d(),t("button",{ref_key:"elRef",ref:f,class:"skdx-autocomplete__trigger","data-part":"trigger",type:"button",tabindex:-1,"aria-expanded":i(p).open.value,"aria-controls":i(p).listId,disabled:i(p).disabled||void 0,"data-disabled":i(p).disabled?"":void 0,"data-readonly":i(p).readOnly?"":void 0,"data-state":i(p).open.value?"open":"closed",onMousedown:c,onClick:m},[s(e.$slots,"default")],40,u))}});export{p as default};

package/dist/autocomplete/context.cjs

@@ -1 +1 @@
-const n=require("../utils/id.cjs");var r='[role="option"]:not([data-disabled])';function c(t,o){const e=t.querySelector('[data-part="viewport"]')??t;if(e===o||!e.contains(o))return;const l=e.getBoundingClientRect(),u=o.getBoundingClientRect();e.scrollTop+=u.top-l.top-(l.height-u.height)/2}var i=Symbol("skdx-autocomplete-group-context");function a(){return n.nextId("autocomplete-group-label")}var p=Symbol("skdx-autocomplete-context");function s(){return n.nextId("autocomplete-list")}function T(){return n.nextId("autocomplete-item")}function d(t){return`${t} suggestion${t===1?"":"s"} available`}exports.AUTOCOMPLETE_CONTEXT=p;exports.AUTOCOMPLETE_GROUP_CONTEXT=i;exports.OPTION_SELECTOR=r;exports.defaultGetSuggestionCountLabel=d;exports.nextAutocompleteGroupLabelId=a;exports.nextAutocompleteItemId=T;exports.nextAutocompleteListId=s;exports.scrollIntoPopup=c;
+const n=require("../utils/id.cjs");var r='[role="option"]:not([data-disabled])';function c(t,e){const o=t.querySelector('[data-part="viewport"]')??t;if(o===e||!o.contains(e))return;const l=o.getBoundingClientRect(),u=e.getBoundingClientRect();o.scrollTop+=u.top-l.top-(l.height-u.height)/2}var i=Symbol("skdx-autocomplete-group-context");function a(){return n.nextId("autocomplete-group-label")}var p=Symbol("skdx-autocomplete-context");function s(){return n.nextId("autocomplete-list")}function d(){return n.nextId("autocomplete-item")}function O(t){return`${t} suggestion${t===1?"":"s"} available`}function T(t,e){return t.toLowerCase().includes(e.trim().toLowerCase())}exports.AUTOCOMPLETE_CONTEXT=p;exports.AUTOCOMPLETE_GROUP_CONTEXT=i;exports.OPTION_SELECTOR=r;exports.defaultGetSuggestionCountLabel=O;exports.defaultOptionsFilter=T;exports.nextAutocompleteGroupLabelId=a;exports.nextAutocompleteItemId=d;exports.nextAutocompleteListId=s;exports.scrollIntoPopup=c;

package/dist/autocomplete/context.d.cts

@@ -1,22 +1,11 @@
 import type { InjectionKey, Ref } from 'vue';
 /** @internal Selector for enabled option elements in keyboard navigation. */
 export declare const OPTION_SELECTOR = "[role=\"option\"]:not([data-disabled])";
-/**
- * @internal Scroll option into view inside popup only, centered like native
- * `<select>`. Not `scrollIntoView()` (which walks ancestors; on popup open
- * floating-ui hasn't measured yet, sitting at y=0, so it takes the whole page).
- * Positions via rects to avoid offset-parent dependency. Copied from SelectContent.
- */
+/** @internal Scrolls the option into view inside the popup only, centered like a native select. */
 export declare function scrollIntoPopup(content: HTMLElement, option: HTMLElement): void;
-/**
- * Filter strategy for suggestions: `'manual'` (default, no filtering),
- * predicate (returns boolean or number for ranking), or omitted (= `'manual'`).
- */
+/** Filter strategy for suggestions: 'manual' (default, no filtering) or a ranking predicate. */
 export type AutocompleteFilter = 'manual' | ((itemText: string, inputValue: string) => boolean | number);
-/**
- * `value-change` event payload (Enter, suggestion click, Tab, and blur
- * carry the same event shape).
- */
+/** Payload the value-change event carries; Enter, a suggestion click, Tab, and blur all use this shape. */
 export interface AutocompleteValueChangeDetail {
     /** New committed value. */
     value: string;
@@ -53,10 +42,7 @@ export interface AutocompleteItemEntry {
 /** @internal Shared state from Autocomplete to parts. */
 export interface AutocompleteContext {
     inputRef: Ref<HTMLElement | null>;
-    /**
-     * Optional Trigger ref. Dismissal layer needs it to distinguish
-     * trigger clicks from outside pointer-down.
-     */
+    /** Optional Trigger ref, so the dismissal layer can distinguish trigger clicks from outside pointer-down. */
     triggerRef: Ref<HTMLElement | null>;
     contentRef: Ref<HTMLElement | null>;
     /** List id (`aria-controls` target). */
@@ -83,22 +69,13 @@ export interface AutocompleteContext {
     matchesFilter(itemText: string): boolean;
     /** Visible suggestions in traversal order (score-sorted or DOM order). */
     orderedOptions(): HTMLElement[];
-    /**
-     * Commit suggestion: write text to input, value to field, close.
-     * `reason` travels in emitted `value-change`.
-     */
+    /** Commit a suggestion: write text to input, value to field, close, and emit value-change. */
     commitItem(value: string, text: string, reason: AutocompleteValueChangeDetail['reason']): void;
-    /**
-     * Commit draft text as value (Tab, blur) or restore last committed
-     * (if `allowCustomValue` is off).
-     */
+    /** Commit draft text as value (Tab, blur), or restore the last committed value if allowCustomValue is off. */
     commitInputValue(reason: AutocompleteValueChangeDetail['reason']): void;
     /** Close and restore last committed text to input (Escape). */
     revert(): void;
-    /**
-     * Empty draft and value together, clearing remembered value so blur
-     * cannot restore it (like Clear does).
-     */
+    /** Empty draft and value together, clearing the remembered value so blur cannot restore it. */
     clear(reason: AutocompleteValueChangeDetail['reason']): void;
     allowCustomValue: boolean;
     openOnFocus: boolean;
@@ -129,9 +106,7 @@ export declare const AUTOCOMPLETE_CONTEXT: InjectionKey<AutocompleteContext>;
 export declare function nextAutocompleteListId(): string;
 /** @internal Generates a unique, stable-per-instance id for an AutocompleteItem. */
 export declare function nextAutocompleteItemId(): string;
-/**
- * @internal Default suggestion count label: `"1 suggestion available"` / `"3 suggestions available"`.
- * Exported here because `withDefaults(defineProps())` is hoisted and cannot
- * reference local bindings.
- */
+/** @internal Default suggestion count label: "1 suggestion available" / "3 suggestions available". */
 export declare function defaultGetSuggestionCountLabel(count: number): string;
+/** Case-insensitive substring match — the default filter for a derived `options` autocomplete. */
+export declare function defaultOptionsFilter(text: string, inputValue: string): boolean;

package/dist/autocomplete/context.d.ts

@@ -1,22 +1,11 @@
 import type { InjectionKey, Ref } from 'vue';
 /** @internal Selector for enabled option elements in keyboard navigation. */
 export declare const OPTION_SELECTOR = "[role=\"option\"]:not([data-disabled])";
-/**
- * @internal Scroll option into view inside popup only, centered like native
- * `<select>`. Not `scrollIntoView()` (which walks ancestors; on popup open
- * floating-ui hasn't measured yet, sitting at y=0, so it takes the whole page).
- * Positions via rects to avoid offset-parent dependency. Copied from SelectContent.
- */
+/** @internal Scrolls the option into view inside the popup only, centered like a native select. */
 export declare function scrollIntoPopup(content: HTMLElement, option: HTMLElement): void;
-/**
- * Filter strategy for suggestions: `'manual'` (default, no filtering),
- * predicate (returns boolean or number for ranking), or omitted (= `'manual'`).
- */
+/** Filter strategy for suggestions: 'manual' (default, no filtering) or a ranking predicate. */
 export type AutocompleteFilter = 'manual' | ((itemText: string, inputValue: string) => boolean | number);
-/**
- * `value-change` event payload (Enter, suggestion click, Tab, and blur
- * carry the same event shape).
- */
+/** Payload the value-change event carries; Enter, a suggestion click, Tab, and blur all use this shape. */
 export interface AutocompleteValueChangeDetail {
     /** New committed value. */
     value: string;
@@ -53,10 +42,7 @@ export interface AutocompleteItemEntry {
 /** @internal Shared state from Autocomplete to parts. */
 export interface AutocompleteContext {
     inputRef: Ref<HTMLElement | null>;
-    /**
-     * Optional Trigger ref. Dismissal layer needs it to distinguish
-     * trigger clicks from outside pointer-down.
-     */
+    /** Optional Trigger ref, so the dismissal layer can distinguish trigger clicks from outside pointer-down. */
     triggerRef: Ref<HTMLElement | null>;
     contentRef: Ref<HTMLElement | null>;
     /** List id (`aria-controls` target). */
@@ -83,22 +69,13 @@ export interface AutocompleteContext {
     matchesFilter(itemText: string): boolean;
     /** Visible suggestions in traversal order (score-sorted or DOM order). */
     orderedOptions(): HTMLElement[];
-    /**
-     * Commit suggestion: write text to input, value to field, close.
-     * `reason` travels in emitted `value-change`.
-     */
+    /** Commit a suggestion: write text to input, value to field, close, and emit value-change. */
     commitItem(value: string, text: string, reason: AutocompleteValueChangeDetail['reason']): void;
-    /**
-     * Commit draft text as value (Tab, blur) or restore last committed
-     * (if `allowCustomValue` is off).
-     */
+    /** Commit draft text as value (Tab, blur), or restore the last committed value if allowCustomValue is off. */
     commitInputValue(reason: AutocompleteValueChangeDetail['reason']): void;
     /** Close and restore last committed text to input (Escape). */
     revert(): void;
-    /**
-     * Empty draft and value together, clearing remembered value so blur
-     * cannot restore it (like Clear does).
-     */
+    /** Empty draft and value together, clearing the remembered value so blur cannot restore it. */
     clear(reason: AutocompleteValueChangeDetail['reason']): void;
     allowCustomValue: boolean;
     openOnFocus: boolean;
@@ -129,9 +106,7 @@ export declare const AUTOCOMPLETE_CONTEXT: InjectionKey<AutocompleteContext>;
 export declare function nextAutocompleteListId(): string;
 /** @internal Generates a unique, stable-per-instance id for an AutocompleteItem. */
 export declare function nextAutocompleteItemId(): string;
-/**
- * @internal Default suggestion count label: `"1 suggestion available"` / `"3 suggestions available"`.
- * Exported here because `withDefaults(defineProps())` is hoisted and cannot
- * reference local bindings.
- */
+/** @internal Default suggestion count label: "1 suggestion available" / "3 suggestions available". */
 export declare function defaultGetSuggestionCountLabel(count: number): string;
+/** Case-insensitive substring match — the default filter for a derived `options` autocomplete. */
+export declare function defaultOptionsFilter(text: string, inputValue: string): boolean;

package/dist/autocomplete/context.js

@@ -1 +1 @@
-import{nextId as t}from"../utils/id.js";var e='[role="option"]:not([data-disabled])';function o(t,e){const o=t.querySelector('[data-part="viewport"]')??t;if(o===e||!o.contains(e))return;const n=o.getBoundingClientRect(),a=e.getBoundingClientRect();o.scrollTop+=a.top-n.top-(n.height-a.height)/2}var n=/* @__PURE__ */Symbol("skdx-autocomplete-group-context");function a(){return t("autocomplete-group-label")}var u=/* @__PURE__ */Symbol("skdx-autocomplete-context");function l(){return t("autocomplete-list")}function r(){return t("autocomplete-item")}function i(t){return`${t} suggestion${1===t?"":"s"} available`}export{u as AUTOCOMPLETE_CONTEXT,n as AUTOCOMPLETE_GROUP_CONTEXT,e as OPTION_SELECTOR,i as defaultGetSuggestionCountLabel,a as nextAutocompleteGroupLabelId,r as nextAutocompleteItemId,l as nextAutocompleteListId,o as scrollIntoPopup};
+import{nextId as t}from"../utils/id.js";var e='[role="option"]:not([data-disabled])';function o(t,e){const o=t.querySelector('[data-part="viewport"]')??t;if(o===e||!o.contains(e))return;const n=o.getBoundingClientRect(),a=e.getBoundingClientRect();o.scrollTop+=a.top-n.top-(n.height-a.height)/2}var n=/* @__PURE__ */Symbol("skdx-autocomplete-group-context");function a(){return t("autocomplete-group-label")}var u=/* @__PURE__ */Symbol("skdx-autocomplete-context");function r(){return t("autocomplete-list")}function l(){return t("autocomplete-item")}function i(t){return`${t} suggestion${1===t?"":"s"} available`}function s(t,e){return t.toLowerCase().includes(e.trim().toLowerCase())}export{u as AUTOCOMPLETE_CONTEXT,n as AUTOCOMPLETE_GROUP_CONTEXT,e as OPTION_SELECTOR,i as defaultGetSuggestionCountLabel,s as defaultOptionsFilter,a as nextAutocompleteGroupLabelId,l as nextAutocompleteItemId,r as nextAutocompleteListId,o as scrollIntoPopup};

package/dist/autocomplete/primitives.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./AutocompleteClear.vue.cjs"),t=require("./AutocompleteContent.vue.cjs"),o=require("./AutocompleteEmpty.vue.cjs"),u=require("./AutocompleteGroup.vue.cjs"),r=require("./AutocompleteGroupLabel.vue.cjs"),l=require("./AutocompleteInput.vue.cjs"),c=require("./AutocompleteItem.vue.cjs"),p=require("./AutocompleteList.vue.cjs"),i=require("./AutocompletePortal.vue.cjs"),m=require("./AutocompleteTrigger.vue.cjs"),d=require("./Autocomplete.vue.cjs");exports.SkdxAutocomplete=d.default;exports.SkdxAutocompleteClear=e.default;exports.SkdxAutocompleteContent=t.default;exports.SkdxAutocompleteEmpty=o.default;exports.SkdxAutocompleteGroup=u.default;exports.SkdxAutocompleteGroupLabel=r.default;exports.SkdxAutocompleteInput=l.default;exports.SkdxAutocompleteItem=c.default;exports.SkdxAutocompleteList=p.default;exports.SkdxAutocompletePortal=i.default;exports.SkdxAutocompleteTrigger=m.default;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./AutocompleteClear.vue.cjs"),t=require("./AutocompleteContent.vue.cjs"),o=require("./AutocompleteEmpty.vue.cjs"),u=require("./AutocompleteGroup.vue.cjs"),r=require("./AutocompleteGroupLabel.vue.cjs"),l=require("./AutocompleteInput.vue.cjs"),c=require("./AutocompleteItem.vue.cjs"),p=require("./AutocompleteList.vue.cjs"),i=require("./AutocompletePortal.vue.cjs"),m=require("./Autocomplete.vue.cjs"),d=require("./AutocompleteTrigger.vue.cjs");exports.SkdxAutocomplete=m.default;exports.SkdxAutocompleteClear=e.default;exports.SkdxAutocompleteContent=t.default;exports.SkdxAutocompleteEmpty=o.default;exports.SkdxAutocompleteGroup=u.default;exports.SkdxAutocompleteGroupLabel=r.default;exports.SkdxAutocompleteInput=l.default;exports.SkdxAutocompleteItem=c.default;exports.SkdxAutocompleteList=p.default;exports.SkdxAutocompletePortal=i.default;exports.SkdxAutocompleteTrigger=d.default;

package/dist/autocomplete/primitives.d.cts

@@ -1,6 +1,5 @@
 /**
  * Advanced primitives for `SkdxAutocomplete` — the parts the recipe composes.
- * Use when you need a different structure.
  *
  * @example
  * ```vue
@@ -14,7 +13,7 @@
  *     <SkdxAutocompletePortal>
  *       <SkdxAutocompleteContent>
  *         <SkdxAutocompleteList>
- *           <SkdxAutocompleteItem value="react">React</SkdxAutocompleteItem>
+ *           <SkdxAutocompleteItem value="ruby">Ruby</SkdxAutocompleteItem>
  *         </SkdxAutocompleteList>
  *       </SkdxAutocompleteContent>
  *     </SkdxAutocompletePortal>

package/dist/autocomplete/primitives.d.ts

@@ -1,6 +1,5 @@
 /**
  * Advanced primitives for `SkdxAutocomplete` — the parts the recipe composes.
- * Use when you need a different structure.
  *
  * @example
  * ```vue
@@ -14,7 +13,7 @@
  *     <SkdxAutocompletePortal>
  *       <SkdxAutocompleteContent>
  *         <SkdxAutocompleteList>
- *           <SkdxAutocompleteItem value="react">React</SkdxAutocompleteItem>
+ *           <SkdxAutocompleteItem value="ruby">Ruby</SkdxAutocompleteItem>
  *         </SkdxAutocompleteList>
  *       </SkdxAutocompleteContent>
  *     </SkdxAutocompletePortal>

package/dist/autocomplete/primitives.js

@@ -1 +1 @@
-import o from"./AutocompleteClear.vue.js";import t from"./AutocompleteContent.vue.js";import e from"./AutocompleteEmpty.vue.js";import m from"./AutocompleteGroup.vue.js";import p from"./AutocompleteGroupLabel.vue.js";import u from"./AutocompleteInput.vue.js";import r from"./AutocompleteItem.vue.js";import l from"./AutocompleteList.vue.js";import s from"./AutocompletePortal.vue.js";import c from"./AutocompleteTrigger.vue.js";import A from"./Autocomplete.vue.js";export{A as SkdxAutocomplete,o as SkdxAutocompleteClear,t as SkdxAutocompleteContent,e as SkdxAutocompleteEmpty,m as SkdxAutocompleteGroup,p as SkdxAutocompleteGroupLabel,u as SkdxAutocompleteInput,r as SkdxAutocompleteItem,l as SkdxAutocompleteList,s as SkdxAutocompletePortal,c as SkdxAutocompleteTrigger};
+import o from"./AutocompleteClear.vue.js";import t from"./AutocompleteContent.vue.js";import e from"./AutocompleteEmpty.vue.js";import m from"./AutocompleteGroup.vue.js";import p from"./AutocompleteGroupLabel.vue.js";import u from"./AutocompleteInput.vue.js";import r from"./AutocompleteItem.vue.js";import l from"./AutocompleteList.vue.js";import s from"./AutocompletePortal.vue.js";import c from"./Autocomplete.vue.js";import A from"./AutocompleteTrigger.vue.js";export{c as SkdxAutocomplete,o as SkdxAutocompleteClear,t as SkdxAutocompleteContent,e as SkdxAutocompleteEmpty,m as SkdxAutocompleteGroup,p as SkdxAutocompleteGroupLabel,u as SkdxAutocompleteInput,r as SkdxAutocompleteItem,l as SkdxAutocompleteList,s as SkdxAutocompletePortal,A as SkdxAutocompleteTrigger};

package/dist/avatar/Avatar.vue.d.cts

@@ -1,15 +1,11 @@
-/**
- * The Vue implementation of the shared Avatar contract. Owns image-loading status and provides it to `<SkdxAvatarImage>` / `<SkdxAvatarFallback>` so the fallback can appear while the image loads or fails. Renders a plain `<span>`.
- *
- * The status is published as `data-load-status`. Given no default slot content it derives an Image from `src` and a Fallback showing `name`'s initials. Given one, that content is the body and nothing is derived.
- */
+/** The Vue implementation of the shared Avatar contract; owns image-loading status and renders a plain span. */
 type __VLS_Props = {
     /**
      * The avatar's accessible name, applied as `aria-label` on the root and used
      * as the image's default `alt`.
      * @default undefined — the name is whatever the Image's `alt` or the Fallback's text happens to be.
      */
-    label?: string;
+    label?: string | undefined;
     /**
      * Marks the avatar decorative: `aria-hidden="true"` on the root and `alt=""` on the image.
      * @default false
@@ -19,28 +15,34 @@ type __VLS_Props = {
      * Image URL for the derived Image. When absent the derived Fallback renders directly.
      * @default undefined
      */
-    src?: string;
+    src?: string | undefined;
     /**
      * Drives the derived Fallback's initials and, when `label` is absent, the accessible name.
      * @default undefined
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Delay before the derived Fallback appears, to avoid a flash on fast-loading images.
      * @default undefined — the fallback renders immediately.
      */
-    fallbackDelayMs?: number;
+    fallbackDelayMs?: number | undefined;
+    /**
+     * Outline the skin gives the avatar, reflected as `data-shape`.
+     * @default undefined — falls back to a `data-shape` attribute.
+     */
+    shape?: 'circle' | 'rounded' | 'square' | (string & {}) | undefined;
+    /**
+     * Size rung the skin renders the avatar at, reflected as `data-size`.
+     * @default undefined — falls back to a `data-size` attribute.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
 };
 type __VLS_Slots = {
     /** Full manual composition — an Image plus a Fallback part. */
     default?(): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    label: string;
-    name: string;
-    src: string;
     decorative: boolean;
-    fallbackDelayMs: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/avatar/Avatar.vue.d.ts

@@ -1,15 +1,11 @@
-/**
- * The Vue implementation of the shared Avatar contract. Owns image-loading status and provides it to `<SkdxAvatarImage>` / `<SkdxAvatarFallback>` so the fallback can appear while the image loads or fails. Renders a plain `<span>`.
- *
- * The status is published as `data-load-status`. Given no default slot content it derives an Image from `src` and a Fallback showing `name`'s initials. Given one, that content is the body and nothing is derived.
- */
+/** The Vue implementation of the shared Avatar contract; owns image-loading status and renders a plain span. */
 type __VLS_Props = {
     /**
      * The avatar's accessible name, applied as `aria-label` on the root and used
      * as the image's default `alt`.
      * @default undefined — the name is whatever the Image's `alt` or the Fallback's text happens to be.
      */
-    label?: string;
+    label?: string | undefined;
     /**
      * Marks the avatar decorative: `aria-hidden="true"` on the root and `alt=""` on the image.
      * @default false
@@ -19,28 +15,34 @@ type __VLS_Props = {
      * Image URL for the derived Image. When absent the derived Fallback renders directly.
      * @default undefined
      */
-    src?: string;
+    src?: string | undefined;
     /**
      * Drives the derived Fallback's initials and, when `label` is absent, the accessible name.
      * @default undefined
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Delay before the derived Fallback appears, to avoid a flash on fast-loading images.
      * @default undefined — the fallback renders immediately.
      */
-    fallbackDelayMs?: number;
+    fallbackDelayMs?: number | undefined;
+    /**
+     * Outline the skin gives the avatar, reflected as `data-shape`.
+     * @default undefined — falls back to a `data-shape` attribute.
+     */
+    shape?: 'circle' | 'rounded' | 'square' | (string & {}) | undefined;
+    /**
+     * Size rung the skin renders the avatar at, reflected as `data-size`.
+     * @default undefined — falls back to a `data-size` attribute.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
 };
 type __VLS_Slots = {
     /** Full manual composition — an Image plus a Fallback part. */
     default?(): unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    label: string;
-    name: string;
-    src: string;
     decorative: boolean;
-    fallbackDelayMs: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/avatar/Avatar.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const r=require("./context.cjs"),o=require("./AvatarAnatomy.vue.cjs");let e=require("vue");var n=["data-load-status","role","aria-label","aria-hidden"],u=(0,e.defineComponent)({__name:"Avatar",props:{label:{default:void 0},decorative:{type:Boolean,default:!1},src:{default:void 0},name:{default:void 0},fallbackDelayMs:{default:void 0}},setup(a){const t=a,l=(0,e.ref)("idle");return(0,e.provide)(r.AVATAR_CONTEXT,{imageLoadingStatus:l,label:(0,e.computed)(()=>t.label??t.name),decorative:(0,e.computed)(()=>t.decorative)}),(d,i)=>((0,e.openBlock)(),(0,e.createElementBlock)("span",{class:"skdx-avatar","data-part":"root","data-skdx-component":"avatar","data-load-status":l.value,role:a.label??a.name?"img":void 0,"aria-label":a.label??a.name,"aria-hidden":a.decorative?"true":void 0},[(0,e.renderSlot)(d.$slots,"default",{},()=>[(0,e.createVNode)(o.default,{src:a.src,name:a.name,"fallback-delay-ms":a.fallbackDelayMs},null,8,["src","name","fallback-delay-ms"])])],8,n))}});exports.default=u;
+const n=require("../utils/appearance.cjs"),d=require("./context.cjs"),s=require("./AvatarAnatomy.vue.cjs");let a=require("vue");var i=["data-load-status","role","aria-label","aria-hidden"],c=(0,a.defineComponent)({inheritAttrs:!1,__name:"Avatar",props:{label:{},decorative:{type:Boolean,default:!1},src:{},name:{},fallbackDelayMs:{},shape:{},size:{}},setup(e){const t=e,l=(0,a.ref)("idle");return(0,a.provide)(d.AVATAR_CONTEXT,{imageLoadingStatus:l,label:(0,a.computed)(()=>t.label??t.name),decorative:(0,a.computed)(()=>t.decorative)}),(r,o)=>((0,a.openBlock)(),(0,a.createElementBlock)("span",(0,a.mergeProps)({class:"skdx-avatar","data-part":"root","data-skdx-component":"avatar","data-load-status":l.value,role:e.label??e.name?"img":void 0,"aria-label":e.label??e.name,"aria-hidden":e.decorative?"true":void 0},{...r.$attrs,...(0,a.unref)(n.appearanceAttrs)({shape:e.shape,size:e.size},r.$attrs)}),[(0,a.renderSlot)(r.$slots,"default",{},()=>[(0,a.createVNode)(s.default,{src:e.src,name:e.name,"fallback-delay-ms":e.fallbackDelayMs},null,8,["src","name","fallback-delay-ms"])])],16,i))}});exports.default=c;

package/dist/avatar/Avatar.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{AVATAR_CONTEXT as a}from"./context.js";import e from"./AvatarAnatomy.vue.js";import{computed as l,createElementBlock as t,createVNode as o,defineComponent as d,openBlock as r,provide as s,ref as n,renderSlot as i}from"vue";var m=["data-load-status","role","aria-label","aria-hidden"],c=/* @__PURE__ */d({__name:"Avatar",props:{label:{default:void 0},decorative:{type:Boolean,default:!1},src:{default:void 0},name:{default:void 0},fallbackDelayMs:{default:void 0}},setup(d){const c=d,v=n("idle");return s(a,{imageLoadingStatus:v,label:l(()=>c.label??c.name),decorative:l(()=>c.decorative)}),(a,l)=>(r(),t("span",{class:"skdx-avatar","data-part":"root","data-skdx-component":"avatar","data-load-status":v.value,role:d.label??d.name?"img":void 0,"aria-label":d.label??d.name,"aria-hidden":d.decorative?"true":void 0},[i(a.$slots,"default",{},()=>[o(e,{src:d.src,name:d.name,"fallback-delay-ms":d.fallbackDelayMs},null,8,["src","name","fallback-delay-ms"])])],8,m))}});export{c as default};
+import{appearanceAttrs as a}from"../utils/appearance.js";import{AVATAR_CONTEXT as e}from"./context.js";import t from"./AvatarAnatomy.vue.js";import{computed as s,createElementBlock as r,createVNode as l,defineComponent as o,mergeProps as d,openBlock as n,provide as i,ref as m,renderSlot as p,unref as c}from"vue";var u=["data-load-status","role","aria-label","aria-hidden"],v=/* @__PURE__ */o({inheritAttrs:!1,__name:"Avatar",props:{label:{},decorative:{type:Boolean,default:!1},src:{},name:{},fallbackDelayMs:{},shape:{},size:{}},setup(o){const v=o,f=m("idle");return i(e,{imageLoadingStatus:f,label:s(()=>v.label??v.name),decorative:s(()=>v.decorative)}),(e,s)=>(n(),r("span",d({class:"skdx-avatar","data-part":"root","data-skdx-component":"avatar","data-load-status":f.value,role:o.label??o.name?"img":void 0,"aria-label":o.label??o.name,"aria-hidden":o.decorative?"true":void 0},{...e.$attrs,...c(a)({shape:o.shape,size:o.size},e.$attrs)}),[p(e.$slots,"default",{},()=>[l(t,{src:o.src,name:o.name,"fallback-delay-ms":o.fallbackDelayMs},null,8,["src","name","fallback-delay-ms"])])],16,u))}});export{v as default};

package/dist/avatar/AvatarAnatomy.vue.d.cts

@@ -1,16 +1,12 @@
-/**
- * Default anatomy for `SkdxAvatar`: Image for `src`, and Fallback showing
- * initials while loading, errored, or absent.
- * @internal
- */
+/** @internal Default anatomy for SkdxAvatar: Image for src, and Fallback showing initials while loading, errored, or absent. */
 type __VLS_Props = {
-    src?: string;
-    name?: string;
-    fallbackDelayMs?: number;
+    src?: string | undefined;
+    name?: string | undefined;
+    fallbackDelayMs?: number | undefined;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    name: string;
-    src: string;
-    fallbackDelayMs: number;
+    name: string | undefined;
+    src: string | undefined;
+    fallbackDelayMs: number | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/avatar/AvatarAnatomy.vue.d.ts

@@ -1,16 +1,12 @@
-/**
- * Default anatomy for `SkdxAvatar`: Image for `src`, and Fallback showing
- * initials while loading, errored, or absent.
- * @internal
- */
+/** @internal Default anatomy for SkdxAvatar: Image for src, and Fallback showing initials while loading, errored, or absent. */
 type __VLS_Props = {
-    src?: string;
-    name?: string;
-    fallbackDelayMs?: number;
+    src?: string | undefined;
+    name?: string | undefined;
+    fallbackDelayMs?: number | undefined;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    name: string;
-    src: string;
-    fallbackDelayMs: number;
+    name: string | undefined;
+    src: string | undefined;
+    fallbackDelayMs: number | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/avatar/AvatarAnatomy.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const u=require("./AvatarFallback.vue.cjs"),n=require("./AvatarImage.vue.cjs");let e=require("vue");var i=(0,e.defineComponent)({__name:"AvatarAnatomy",props:{src:{default:void 0},name:{default:void 0},fallbackDelayMs:{default:void 0}},setup(t){function l(a){return a?a.trim().split(/\s+/).slice(0,2).map(r=>r[0]).join("").toUpperCase():""}return(a,r)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,null,[(0,e.createVNode)(n.default,{src:t.src},null,8,["src"]),(0,e.createVNode)(u.default,{"delay-ms":t.fallbackDelayMs},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(l(t.name)),1)]),_:1},8,["delay-ms"])],64))}});exports.default=i;
+const n=require("./AvatarFallback.vue.cjs"),u=require("./AvatarImage.vue.cjs");let e=require("vue");var c=(0,e.defineComponent)({__name:"AvatarAnatomy",props:{src:{default:void 0},name:{default:void 0},fallbackDelayMs:{default:void 0}},setup(a){function l(r){if(!r)return"";const t=r.trim().split(/\s+/).filter(Boolean);return t.length===0?"":(t[0].charAt(0)+(t.length>1?t[t.length-1].charAt(0):"")).toUpperCase()}return(r,t)=>((0,e.openBlock)(),(0,e.createElementBlock)(e.Fragment,null,[(0,e.createVNode)(u.default,{src:a.src},null,8,["src"]),(0,e.createVNode)(n.default,{"delay-ms":a.fallbackDelayMs},{default:(0,e.withCtx)(()=>[(0,e.createTextVNode)((0,e.toDisplayString)(l(a.name)),1)]),_:1},8,["delay-ms"])],64))}});exports.default=c;

package/dist/avatar/AvatarAnatomy.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import a from"./AvatarFallback.vue.js";import e from"./AvatarImage.vue.js";import{Fragment as t,createElementBlock as r,createTextVNode as s,createVNode as l,defineComponent as o,openBlock as m,toDisplayString as n,withCtx as i}from"vue";var c=/* @__PURE__ */o({__name:"AvatarAnatomy",props:{src:{default:void 0},name:{default:void 0},fallbackDelayMs:{default:void 0}},setup(o){function c(a){return a?a.trim().split(/\s+/).slice(0,2).map(a=>a[0]).join("").toUpperCase():""}return(p,u)=>(m(),r(t,null,[l(e,{src:o.src},null,8,["src"]),l(a,{"delay-ms":o.fallbackDelayMs},{default:i(()=>[s(n(c(o.name)),1)]),_:1},8,["delay-ms"])],64))}});export{c as default};
+import a from"./AvatarFallback.vue.js";import e from"./AvatarImage.vue.js";import{Fragment as t,createElementBlock as r,createTextVNode as l,createVNode as s,defineComponent as o,openBlock as n,toDisplayString as m,withCtx as c}from"vue";var i=/* @__PURE__ */o({__name:"AvatarAnatomy",props:{src:{default:void 0},name:{default:void 0},fallbackDelayMs:{default:void 0}},setup(o){function i(a){if(!a)return"";const e=a.trim().split(/\s+/).filter(Boolean);return 0===e.length?"":(e[0].charAt(0)+(e.length>1?e[e.length-1].charAt(0):"")).toUpperCase()}return(u,f)=>(n(),r(t,null,[s(e,{src:o.src},null,8,["src"]),s(a,{"delay-ms":o.fallbackDelayMs},{default:c(()=>[l(m(i(o.name)),1)]),_:1},8,["delay-ms"])],64))}});export{i as default};

package/dist/avatar/AvatarFallback.vue.d.cts

@@ -1,14 +1,10 @@
-/**
- * Renders while the image is idle, loading, or errored. With `delayMs`, waits
- * that long to avoid a flash on quick loads. Must be used inside
- * `<SkdxAvatar>`.
- */
+/** Renders while the image is idle, loading, or errored; with delayMs, waits to avoid a flash on quick loads. */
 type __VLS_Props = {
     /**
      * Delay before showing the fallback, to avoid a flash on fast connections.
      * @default undefined — renders immediately, with no delay.
      */
-    delayMs?: number;
+    delayMs?: number | undefined;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/avatar/AvatarFallback.vue.d.ts

@@ -1,14 +1,10 @@
-/**
- * Renders while the image is idle, loading, or errored. With `delayMs`, waits
- * that long to avoid a flash on quick loads. Must be used inside
- * `<SkdxAvatar>`.
- */
+/** Renders while the image is idle, loading, or errored; with delayMs, waits to avoid a flash on quick loads. */
 type __VLS_Props = {
     /**
      * Delay before showing the fallback, to avoid a flash on fast connections.
      * @default undefined — renders immediately, with no delay.
      */
-    delayMs?: number;
+    delayMs?: number | undefined;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {

package/dist/avatar/AvatarFallback.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const d=require("./context.cjs");let e=require("vue");var i={key:0,class:"skdx-avatar__fallback","data-part":"fallback"},c=(0,e.defineComponent)({__name:"AvatarFallback",props:{delayMs:{}},setup(u){const n=u,o=(0,e.inject)(d.AVATAR_CONTEXT);if(!o)throw new Error("<SkdxAvatarFallback> must be used inside <SkdxAvatar>.");const l=o,a=(0,e.ref)(n.delayMs===void 0);let t;return(0,e.watch)(()=>n.delayMs,r=>{if(!(typeof window>"u")){if(t!==void 0&&window.clearTimeout(t),r===void 0){a.value=!0;return}a.value=!1,t=window.setTimeout(()=>{a.value=!0},r)}},{immediate:!0}),(0,e.onUnmounted)(()=>{t!==void 0&&window.clearTimeout(t)}),(r,s)=>a.value&&(0,e.unref)(l).imageLoadingStatus.value!=="loaded"?((0,e.openBlock)(),(0,e.createElementBlock)("span",i,[(0,e.renderSlot)(r.$slots,"default")])):(0,e.createCommentVNode)("",!0)}});exports.default=c;
+const o=require("../utils/injectRequired.cjs"),d=require("./context.cjs");let e=require("vue");var l={key:0,class:"skdx-avatar__fallback","data-part":"fallback"},c=(0,e.defineComponent)({__name:"AvatarFallback",props:{delayMs:{}},setup(n){const u=n,i=o.injectRequired(d.AVATAR_CONTEXT,"<SkdxAvatarFallback> must be used inside <SkdxAvatar>."),a=(0,e.ref)(u.delayMs===void 0);let t;return(0,e.watch)(()=>u.delayMs,r=>{if(!(typeof window>"u")){if(t!==void 0&&window.clearTimeout(t),r===void 0){a.value=!0;return}a.value=!1,t=window.setTimeout(()=>{a.value=!0},r)}},{immediate:!0}),(0,e.onUnmounted)(()=>{t!==void 0&&window.clearTimeout(t)}),(r,s)=>a.value&&(0,e.unref)(i).imageLoadingStatus.value!=="loaded"?((0,e.openBlock)(),(0,e.createElementBlock)("span",l,[(0,e.renderSlot)(r.$slots,"default")])):(0,e.createCommentVNode)("",!0)}});exports.default=c;

package/dist/avatar/AvatarFallback.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{AVATAR_CONTEXT as a}from"./context.js";import{createCommentVNode as e,createElementBlock as t,defineComponent as o,inject as s,onUnmounted as d,openBlock as l,ref as r,renderSlot as n,unref as i,watch as u}from"vue";var m={key:0,class:"skdx-avatar__fallback","data-part":"fallback"},c=/* @__PURE__ */o({__name:"AvatarFallback",props:{delayMs:{}},setup(o){const c=o,v=s(a);if(!v)throw new Error("<SkdxAvatarFallback> must be used inside <SkdxAvatar>.");const f=v,p=r(void 0===c.delayMs);let w;return u(()=>c.delayMs,a=>{if(!(typeof window>"u")){if(void 0!==w&&window.clearTimeout(w),void 0===a)return void(p.value=!0);p.value=!1,w=window.setTimeout(()=>{p.value=!0},a)}},{immediate:!0}),d(()=>{void 0!==w&&window.clearTimeout(w)}),(a,o)=>p.value&&"loaded"!==i(f).imageLoadingStatus.value?(l(),t("span",m,[n(a.$slots,"default")])):e("",!0)}});export{c as default};
+import{injectRequired as a}from"../utils/injectRequired.js";import{AVATAR_CONTEXT as e}from"./context.js";import{createCommentVNode as t,createElementBlock as o,defineComponent as s,onUnmounted as d,openBlock as i,ref as l,renderSlot as r,unref as n,watch as u}from"vue";var m={key:0,class:"skdx-avatar__fallback","data-part":"fallback"},c=/* @__PURE__ */s({__name:"AvatarFallback",props:{delayMs:{}},setup(s){const c=s,v=a(e,"<SkdxAvatarFallback> must be used inside <SkdxAvatar>."),f=l(void 0===c.delayMs);let p;return u(()=>c.delayMs,a=>{if(!(typeof window>"u")){if(void 0!==p&&window.clearTimeout(p),void 0===a)return void(f.value=!0);f.value=!1,p=window.setTimeout(()=>{f.value=!0},a)}},{immediate:!0}),d(()=>{void 0!==p&&window.clearTimeout(p)}),(a,e)=>f.value&&"loaded"!==n(v).imageLoadingStatus.value?(i(),o("span",m,[r(a.$slots,"default")])):t("",!0)}});export{c as default};

package/dist/avatar/AvatarImage.vue.d.cts

@@ -1,18 +1,13 @@
 import { type ImageLoadingStatus } from './context.cjs';
-/**
- * Loads src independently, renders <img> only after successful load.
- * Shows fallback while loading/error/omitted. Use inside <SkdxAvatar>.
- */
+/** Loads src independently, rendering an img only after a successful load; shows fallback otherwise. */
 type __VLS_Props = {
     /**
-     * Image URL to load. Falls back to `<AvatarFallback>` while it loads, on error, or when omitted.
-     * @default undefined — no image, always shows the fallback.
+     * Image URL to load. Falls back to `<AvatarFallback>` while it loads, on error, or when omitted with no `srcset` either.
+     * @default undefined — no image, always shows the fallback (unless `srcset` is given).
      */
-    src?: string;
+    src?: string | undefined;
     /**
-     * Candidate set for a responsive image, forwarded to the rendered `<img>`
-     * *and* to the internal probe, so the status describes the same resource
-     * that ends up displayed.
+     * Candidate set for a responsive image, forwarded to the rendered img and to the internal probe.
      * @default undefined
      */
     srcset?: string;
@@ -22,8 +17,7 @@ type __VLS_Props = {
      */
     sizes?: string;
     /**
-     * Alternative text. Defaults to the root's `label`, and is forced to `''`
-     * when the root is `decorative`.
+     * Alternative text; defaults to the root's label, forced to '' when the root is decorative.
      * @default undefined — the root's `label`, or `''`
      */
     alt?: string;
@@ -31,6 +25,6 @@ type __VLS_Props = {
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "loading-status-change": (status: ImageLoadingStatus) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onLoading-status-change"?: ((status: ImageLoadingStatus) => any) | undefined;
+    "onLoading-status-change"?: (status: ImageLoadingStatus) => any;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;