@skdx/vue 0.28.0 → 0.30.0

package/dist/utils/mentions.d.ts

@@ -0,0 +1,116 @@
+/** The trigger character a Mentions field uses when it configures none. */
+export declare const DEFAULT_MENTION_TRIGGER = "@";
+/** The mention being typed: its trigger character, the text after it, and the range the pair occupies. */
+export interface MentionToken {
+    /** The trigger character that opened the token. */
+    trigger: string;
+    /** Text between the trigger character and the caret — what the item list is filtered by. */
+    query: string;
+    /** Offset of the trigger character in the field value. */
+    start: number;
+    /** Offset just past the query; always the caret offset the token was found at. */
+    end: number;
+}
+/** Where a trigger character is allowed to open a token, and what abandons one. */
+export interface MentionTokenOptions {
+    /**
+     * Trigger characters, either as an array or as one string read a character at a time.
+     * @defaultValue `'@'`
+     */
+    triggers?: string | readonly string[] | undefined;
+    /**
+     * How many spaces a query may contain before the token is abandoned.
+     * @defaultValue 0
+     */
+    allowedSpaces?: number | undefined;
+    /**
+     * Whether a trigger opens a token only at the start of the value or after a non-word character, so `user@example` is left alone.
+     * @defaultValue true
+     */
+    requireWordBoundary?: boolean | undefined;
+}
+/**
+ * The mention token the caret sits in, found by scanning backwards from the
+ * caret to the nearest trigger character.
+ *
+ * Returns `null` for every condition that ends a mention: no trigger before
+ * the caret, a line break between them, more spaces than `allowedSpaces`, a
+ * trigger that fails the word-boundary rule, or a caret that has moved out of
+ * the token. There is no token to cancel — call this again after every value,
+ * caret or selection change and the answer is the whole state.
+ *
+ * @param value the field's full text
+ * @param caret the caret offset, clamped into the value
+ * @param options the trigger and boundary rules
+ */
+export declare function findMentionToken(value: string, caret: number, options?: MentionTokenOptions): MentionToken | null;
+/**
+ * Whether an Escape recorded at `dismissedAt` still suppresses this token.
+ *
+ * Escape closes the popup while the token is still syntactically alive, so the
+ * offset of the dismissed trigger is held until {@link findMentionToken}
+ * returns `null` — which is the adapter's cue to forget it.
+ *
+ * @param token the token found for the current caret, or `null`
+ * @param dismissedAt the `start` of the token Escape closed, or `null`
+ */
+export declare function isMentionDismissed(token: MentionToken | null, dismissedAt: number | null): boolean;
+/** The field value and caret offset an insertion produces. */
+export interface MentionInsertion {
+    /** The whole field value with the token's range replaced. */
+    value: string;
+    /** Caret offset just past the inserted text, and past the appended space when one was added. */
+    caret: number;
+}
+/**
+ * Replaces a token's range with the serialized mention text.
+ *
+ * @param value the field value the token was found in
+ * @param token the token being replaced, from {@link findMentionToken}
+ * @param text the full replacement including the trigger character
+ * @param appendSpace whether a single space follows the mention, skipped when the value already continues with whitespace
+ */
+export declare function insertMention(value: string, token: MentionToken, text: string, appendSpace?: boolean): MentionInsertion;
+/** The caret's position in viewport coordinates, as an adapter measured it. */
+export interface CaretRect {
+    /** Distance in pixels from the viewport's top edge to the caret's top. */
+    top: number;
+    /** Distance in pixels from the viewport's left edge to the caret. */
+    left: number;
+    /** The caret's height in pixels, normally the field's computed line height. */
+    height: number;
+}
+/** The rectangle floating-ui reads off a positioning reference. */
+export interface AnchorRect {
+    x: number;
+    y: number;
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+    width: number;
+    height: number;
+}
+/** A positioning reference that is a rectangle rather than an element. */
+export interface VirtualAnchor {
+    getBoundingClientRect(): AnchorRect;
+    /** The element the rect lives inside, so floating-ui can observe ancestor scroll and resize. */
+    contextElement: Element;
+}
+/**
+ * Wraps a caret measurement as the zero-width virtual anchor the popup is
+ * positioned against.
+ *
+ * The measurement is re-read on every call, so one anchor survives a moved
+ * caret without being rebuilt, and `contextElement` is what lets floating-ui
+ * observe the ancestor scroll and resize that make it re-read.
+ *
+ * @param measure re-reads the caret rectangle, normally closing over a {@link MeasureCaretRect}, its field and the offset
+ * @param contextElement the field the caret sits in
+ */
+export declare function caretAnchor(measure: () => CaretRect, contextElement: Element): VirtualAnchor;
+/**
+ * The caret measurement each adapter implements with its own DOM work: the
+ * viewport rectangle of the caret at `offset` inside `field`.
+ */
+export type MeasureCaretRect = (field: HTMLTextAreaElement | HTMLInputElement, offset: number) => CaretRect;

package/dist/utils/mentions.js

@@ -0,0 +1 @@
+var t=/[\p{L}\p{N}_]/u;function e(e,n,r={}){const{allowedSpaces:i=0,requireWordBoundary:o=!0}=r,s=function(t){return void 0===t?["@"]:"string"==typeof t?[...t]:t}(r.triggers),l=Math.max(0,Math.min(n,e.length));let u=0;for(let n=l-1;n>=0;n--){const r=e[n];if("\n"===r||"\r"===r)return null;if(s.includes(r)){const i=n>0?e[n-1]:"";return o&&""!==i&&t.test(i)?null:{trigger:r,query:e.slice(n+1,l),start:n,end:l}}if(/\s/.test(r)&&++u>i)return null}return null}function n(t,e){return null!==t&&t.start===e}function r(t,e,n,r=!0){const i=t.slice(e.end),o=r&&!/^\s/.test(i)?" ":"";return{value:t.slice(0,e.start)+n+o+i,caret:e.start+n.length+o.length}}function i(t,e){return{getBoundingClientRect:()=>{const e=t();return{x:e.left,y:e.top,top:e.top,left:e.left,bottom:e.top+e.height,right:e.left,width:0,height:e.height}},contextElement:e}}export{i as caretAnchor,e as findMentionToken,r as insertMention,n as isMentionDismissed};

package/dist/utils/menuGroup.cjs

@@ -1 +1 @@
-const r=require("./id.cjs");let e=require("vue");var n=Symbol("skdx-menu-group-context");function s(u){const t=r.nextId("menu-group-label"),a=(0,e.ref)(!1),l=(0,e.ref)(!1);return(0,e.onMounted)(()=>{l.value=!0}),(0,e.provide)(n,{labelId:t,setHasLabel:o=>{a.value=o}}),(0,e.computed)(()=>a.value||!l.value&&u?t:void 0)}function d(){const u=(0,e.inject)(n);if(u)return u.setHasLabel(!0),(0,e.onUnmounted)(()=>u.setHasLabel(!1)),u.labelId}exports.MENU_GROUP_CONTEXT=n;exports.useMenuGroupLabel=s;exports.useMenuLabelId=d;
+const r=require("./id.cjs");let e=require("vue");var n=Symbol("skdx-menu-group-context");function s(u){const t=r.nextId("menu-group-label"),o=(0,e.ref)(!1),a=(0,e.ref)(!1);return(0,e.onMounted)(()=>{a.value=!0}),(0,e.provide)(n,{labelId:t,setHasLabel:l=>{o.value=l}}),(0,e.computed)(()=>o.value||!a.value&&u()?t:void 0)}function d(){const u=(0,e.inject)(n,void 0);if(u)return u.setHasLabel(!0),(0,e.onUnmounted)(()=>u.setHasLabel(!1)),u.labelId}exports.MENU_GROUP_CONTEXT=n;exports.useMenuGroupLabel=s;exports.useMenuLabelId=d;

package/dist/utils/menuGroup.d.cts

@@ -9,15 +9,9 @@ export interface MenuGroupContext {
     labelId: string;
     setHasLabel(hasLabel: boolean): void;
 }
-/** @internal Injection key a menu Group/RadioGroup provides — shared by DropdownMenu, Menubar and ContextMenu, mirroring React's single MenuGroupProvider. */
+/** @internal Injection key a menu Group/RadioGroup provides — shared by Menu and Menubar. */
 export declare const MENU_GROUP_CONTEXT: InjectionKey<MenuGroupContext>;
-/**
- * @internal Mints Label id, provides registration context. Returns aria-labelledby
- * (undefined until registered). On first render, declaresLabel stands in. Call during setup().
- */
-export declare function useMenuGroupLabel(declaresLabel: boolean): ComputedRef<string | undefined>;
-/**
- * @internal Id for Label to render, registering on mount/unmount.
- * Undefined when standalone. Call during setup().
- */
+/** @internal Mints a Label id and provides registration context; returns `aria-labelledby`, undefined until registered. */
+export declare function useMenuGroupLabel(declaresLabel: () => boolean): ComputedRef<string | undefined>;
+/** @internal Id for Label to render, registering on mount/unmount; `undefined` when standalone. */
 export declare function useMenuLabelId(): string | undefined;

package/dist/utils/menuGroup.d.ts

@@ -9,15 +9,9 @@ export interface MenuGroupContext {
     labelId: string;
     setHasLabel(hasLabel: boolean): void;
 }
-/** @internal Injection key a menu Group/RadioGroup provides — shared by DropdownMenu, Menubar and ContextMenu, mirroring React's single MenuGroupProvider. */
+/** @internal Injection key a menu Group/RadioGroup provides — shared by Menu and Menubar. */
 export declare const MENU_GROUP_CONTEXT: InjectionKey<MenuGroupContext>;
-/**
- * @internal Mints Label id, provides registration context. Returns aria-labelledby
- * (undefined until registered). On first render, declaresLabel stands in. Call during setup().
- */
-export declare function useMenuGroupLabel(declaresLabel: boolean): ComputedRef<string | undefined>;
-/**
- * @internal Id for Label to render, registering on mount/unmount.
- * Undefined when standalone. Call during setup().
- */
+/** @internal Mints a Label id and provides registration context; returns `aria-labelledby`, undefined until registered. */
+export declare function useMenuGroupLabel(declaresLabel: () => boolean): ComputedRef<string | undefined>;
+/** @internal Id for Label to render, registering on mount/unmount; `undefined` when standalone. */
 export declare function useMenuLabelId(): string | undefined;

package/dist/utils/menuGroup.js

@@ -1 +1 @@
-import{nextId as e}from"./id.js";import{computed as a,inject as s,onMounted as o,onUnmounted as u,provide as n,ref as t}from"vue";var l=/* @__PURE__ */Symbol("skdx-menu-group-context");function r(s){const u=e("menu-group-label"),r=t(!1),d=t(!1);return o(()=>{d.value=!0}),n(l,{labelId:u,setHasLabel:e=>{r.value=e}}),a(()=>r.value||!d.value&&s?u:void 0)}function d(){const e=s(l);if(e)return e.setHasLabel(!0),u(()=>e.setHasLabel(!1)),e.labelId}export{l as MENU_GROUP_CONTEXT,r as useMenuGroupLabel,d as useMenuLabelId};
+import{nextId as e}from"./id.js";import{computed as a,inject as o,onMounted as s,onUnmounted as u,provide as n,ref as t}from"vue";var l=/* @__PURE__ */Symbol("skdx-menu-group-context");function r(o){const u=e("menu-group-label"),r=t(!1),d=t(!1);return s(()=>{d.value=!0}),n(l,{labelId:u,setHasLabel:e=>{r.value=e}}),a(()=>r.value||!d.value&&o()?u:void 0)}function d(){const e=o(l,void 0);if(e)return e.setHasLabel(!0),u(()=>e.setHasLabel(!1)),e.labelId}export{l as MENU_GROUP_CONTEXT,r as useMenuGroupLabel,d as useMenuLabelId};

package/dist/utils/menuSub.cjs

@@ -1 +1 @@
-const e=require("./id.cjs");var n='[role^="menuitem"]',t=Symbol("skdx-menu-sub-context");function u(){return e.nextId("menu-sub-content")}function r(){return e.nextId("menu-sub-trigger")}exports.ITEM_SELECTOR=n;exports.MENU_SUB_CONTEXT=t;exports.nextMenuSubContentId=u;exports.nextMenuSubTriggerId=r;
+const n=require("./id.cjs");let u=require("vue");var t='[role^="menuitem"]',r=Symbol("skdx-menu-sub-context"),e=Symbol("skdx-menu-family");function i(){return(0,u.inject)(e,void 0)?.family??"menu"}function M(){return(0,u.inject)(e,void 0)?.label}function m(){return n.nextId("menu-sub-content")}function l(){return n.nextId("menu-sub-trigger")}exports.ITEM_SELECTOR=t;exports.MENU_FAMILY_CONTEXT=e;exports.MENU_SUB_CONTEXT=r;exports.nextMenuSubContentId=m;exports.nextMenuSubTriggerId=l;exports.useMenuFamily=i;exports.useMenuFamilyLabel=M;

package/dist/utils/menuSub.d.cts

@@ -1,25 +1,15 @@
-import type { InjectionKey, Ref } from 'vue';
+import { type Component, type InjectionKey, type Ref } from 'vue';
 /**
- * Nested submenu shared by DropdownMenu, ContextMenu, Menubar; each re-exports
- * under own names. Reuses popper layer with SubTrigger anchor. Renders inline
- * (not portaled) so parent dismissal/typeahead work correctly.
+ * Nested submenu shared by Menu and Menubar, rendered inline (not portaled) so parent dismissal/typeahead keep working.
  * @internal
  */
-/**
- * @internal Menu items including disabled (APG: disabled items must be focusable for discovery).
- */
+/** @internal Menu items including disabled (APG: disabled items must be focusable for discovery). */
 export declare const ITEM_SELECTOR = "[role^=\"menuitem\"]";
-/**
- * @internal Delay (ms) before submenu closes after pointer leaves,
- * preventing accidental close during trigger-to-panel sweep.
- */
+/** @internal Delay (ms) before submenu closes after pointer leaves, preventing accidental close during trigger-to-panel sweep. */
 export declare const CLOSE_DELAY_MS = 150;
 /** @internal Shared submenu state a `MenuSub` provides to its SubTrigger and SubContent. */
 export interface MenuSubContext {
-    /**
-     * Family name so shared parts emit correct CSS class names.
-     * Without it, styles matched nothing and submenus rendered unstyled.
-     */
+    /** Family name so shared parts emit the correct CSS class names. */
     family: string;
     open: Readonly<Ref<boolean>>;
     /** Opens immediately, cancelling any pending close. */
@@ -31,14 +21,24 @@ export interface MenuSubContext {
     triggerRef: Ref<HTMLElement | null>;
     contentRef: Ref<HTMLElement | null>;
     contentId: string;
-    /**
-     * SubTrigger id, wired to SubContent's aria-labelledby
-     * (aria-controls alone left the panel unnamed).
-     */
+    /** SubTrigger id, wired to SubContent's `aria-labelledby` (`aria-controls` alone left the panel unnamed). */
     triggerId: string;
 }
 /** @internal Injection key a `MenuSub` provides so its SubTrigger and SubContent share open state and element refs. */
 export declare const MENU_SUB_CONTEXT: InjectionKey<MenuSubContext>;
+/** @internal Which menu family the parts below a root belong to, so shared parts emit the right class names. */
+export interface MenuFamilyContext {
+    /** `'menu'` or `'menubar'`. */
+    family: string;
+    /** The family's Label component, which a Group looks for in its slot before mount. */
+    label: Component;
+}
+/** @internal Injection key a menu root provides so a nested `MenuSub` can read its family name. */
+export declare const MENU_FAMILY_CONTEXT: InjectionKey<MenuFamilyContext>;
+/** @internal The enclosing family's name; `menu` for a part rendered outside any root. */
+export declare function useMenuFamily(): string;
+/** @internal The enclosing family's Label component, which a Group looks for in its slot before mount. */
+export declare function useMenuFamilyLabel(): Component | undefined;
 /** @internal Generates a unique id for a submenu's content. */
 export declare function nextMenuSubContentId(): string;
 /** @internal Generates a unique id for a submenu's trigger, which its content names itself after. */

package/dist/utils/menuSub.d.ts

@@ -1,25 +1,15 @@
-import type { InjectionKey, Ref } from 'vue';
+import { type Component, type InjectionKey, type Ref } from 'vue';
 /**
- * Nested submenu shared by DropdownMenu, ContextMenu, Menubar; each re-exports
- * under own names. Reuses popper layer with SubTrigger anchor. Renders inline
- * (not portaled) so parent dismissal/typeahead work correctly.
+ * Nested submenu shared by Menu and Menubar, rendered inline (not portaled) so parent dismissal/typeahead keep working.
  * @internal
  */
-/**
- * @internal Menu items including disabled (APG: disabled items must be focusable for discovery).
- */
+/** @internal Menu items including disabled (APG: disabled items must be focusable for discovery). */
 export declare const ITEM_SELECTOR = "[role^=\"menuitem\"]";
-/**
- * @internal Delay (ms) before submenu closes after pointer leaves,
- * preventing accidental close during trigger-to-panel sweep.
- */
+/** @internal Delay (ms) before submenu closes after pointer leaves, preventing accidental close during trigger-to-panel sweep. */
 export declare const CLOSE_DELAY_MS = 150;
 /** @internal Shared submenu state a `MenuSub` provides to its SubTrigger and SubContent. */
 export interface MenuSubContext {
-    /**
-     * Family name so shared parts emit correct CSS class names.
-     * Without it, styles matched nothing and submenus rendered unstyled.
-     */
+    /** Family name so shared parts emit the correct CSS class names. */
     family: string;
     open: Readonly<Ref<boolean>>;
     /** Opens immediately, cancelling any pending close. */
@@ -31,14 +21,24 @@ export interface MenuSubContext {
     triggerRef: Ref<HTMLElement | null>;
     contentRef: Ref<HTMLElement | null>;
     contentId: string;
-    /**
-     * SubTrigger id, wired to SubContent's aria-labelledby
-     * (aria-controls alone left the panel unnamed).
-     */
+    /** SubTrigger id, wired to SubContent's `aria-labelledby` (`aria-controls` alone left the panel unnamed). */
     triggerId: string;
 }
 /** @internal Injection key a `MenuSub` provides so its SubTrigger and SubContent share open state and element refs. */
 export declare const MENU_SUB_CONTEXT: InjectionKey<MenuSubContext>;
+/** @internal Which menu family the parts below a root belong to, so shared parts emit the right class names. */
+export interface MenuFamilyContext {
+    /** `'menu'` or `'menubar'`. */
+    family: string;
+    /** The family's Label component, which a Group looks for in its slot before mount. */
+    label: Component;
+}
+/** @internal Injection key a menu root provides so a nested `MenuSub` can read its family name. */
+export declare const MENU_FAMILY_CONTEXT: InjectionKey<MenuFamilyContext>;
+/** @internal The enclosing family's name; `menu` for a part rendered outside any root. */
+export declare function useMenuFamily(): string;
+/** @internal The enclosing family's Label component, which a Group looks for in its slot before mount. */
+export declare function useMenuFamilyLabel(): Component | undefined;
 /** @internal Generates a unique id for a submenu's content. */
 export declare function nextMenuSubContentId(): string;
 /** @internal Generates a unique id for a submenu's trigger, which its content names itself after. */

package/dist/utils/menuSub.js

@@ -1 +1 @@
-import{nextId as n}from"./id.js";var e='[role^="menuitem"]',t=/* @__PURE__ */Symbol("skdx-menu-sub-context");function u(){return n("menu-sub-content")}function r(){return n("menu-sub-trigger")}export{e as ITEM_SELECTOR,t as MENU_SUB_CONTEXT,u as nextMenuSubContentId,r as nextMenuSubTriggerId};
+import{nextId as e}from"./id.js";import{inject as n}from"vue";var u='[role^="menuitem"]',t=/* @__PURE__ */Symbol("skdx-menu-sub-context"),r=/* @__PURE__ */Symbol("skdx-menu-family");function i(){return n(r,void 0)?.family??"menu"}function m(){return n(r,void 0)?.label}function o(){return e("menu-sub-content")}function s(){return e("menu-sub-trigger")}export{u as ITEM_SELECTOR,r as MENU_FAMILY_CONTEXT,t as MENU_SUB_CONTEXT,o as nextMenuSubContentId,s as nextMenuSubTriggerId,i as useMenuFamily,m as useMenuFamilyLabel};

package/dist/utils/mirroredValues.d.cts

@@ -1,26 +1,15 @@
 /** What {@link mirroredFormValues} needs beyond the selection itself. */
 export interface MirroredFormValuesOptions {
     /**
-     * Whether the control is `required`. An empty selection then still mirrors
-     * one empty-valued control, because `valueMissing` cannot fire on an input
-     * that was never rendered — and that form never submits, so it costs no
-     * spurious entry.
+     * Whether the control is `required`; an empty selection then still mirrors one empty-valued control so `valueMissing` can fire.
      * @defaultValue false
      */
-    required?: boolean;
+    required?: boolean | undefined;
     /**
-     * True for a control that holds at most one value, where an *empty* selection
-     * still submits one empty entry the way a native single `<select>` posts its
-     * empty option. A genuinely array-valued control leaves this off: it submits
-     * no entries at all when nothing is selected.
+     * True for a control that holds at most one value, where an empty selection still submits one empty entry, like a native single `<select>`.
      * @defaultValue false
      */
-    singleValued?: boolean;
+    singleValued?: boolean | undefined;
 }
-/**
- * Array-valued control mirrors one visually-hidden native control per value,
- * all sharing one name. Consumer reads with formData.getAll(name), like native
- * <select multiple>. Never type="hidden" or readonly. Only disabled withholds
- * submission. Web Components use ElementInternals instead.
- */
+/** Mirrors an array-valued control as one visually-hidden native control per value, all sharing one `name`, read via `formData.getAll(name)`. */
 export declare function mirroredFormValues(values: readonly string[], options?: MirroredFormValuesOptions): string[];

package/dist/utils/mirroredValues.d.ts

@@ -1,26 +1,15 @@
 /** What {@link mirroredFormValues} needs beyond the selection itself. */
 export interface MirroredFormValuesOptions {
     /**
-     * Whether the control is `required`. An empty selection then still mirrors
-     * one empty-valued control, because `valueMissing` cannot fire on an input
-     * that was never rendered — and that form never submits, so it costs no
-     * spurious entry.
+     * Whether the control is `required`; an empty selection then still mirrors one empty-valued control so `valueMissing` can fire.
      * @defaultValue false
      */
-    required?: boolean;
+    required?: boolean | undefined;
     /**
-     * True for a control that holds at most one value, where an *empty* selection
-     * still submits one empty entry the way a native single `<select>` posts its
-     * empty option. A genuinely array-valued control leaves this off: it submits
-     * no entries at all when nothing is selected.
+     * True for a control that holds at most one value, where an empty selection still submits one empty entry, like a native single `<select>`.
      * @defaultValue false
      */
-    singleValued?: boolean;
+    singleValued?: boolean | undefined;
 }
-/**
- * Array-valued control mirrors one visually-hidden native control per value,
- * all sharing one name. Consumer reads with formData.getAll(name), like native
- * <select multiple>. Never type="hidden" or readonly. Only disabled withholds
- * submission. Web Components use ElementInternals instead.
- */
+/** Mirrors an array-valued control as one visually-hidden native control per value, all sharing one `name`, read via `formData.getAll(name)`. */
 export declare function mirroredFormValues(values: readonly string[], options?: MirroredFormValuesOptions): string[];

package/dist/utils/numberFormat.d.cts

@@ -1,14 +1,4 @@
-/**
- * `Intl.NumberFormat` display/parse pair for NumberField. Without `locale` or
- * `formatOptions`, the value round-trips through `String`/`Number` unchanged.
- * Percent follows `Intl.NumberFormat` semantics: the value is the fraction, so
- * `0.5` displays as `50%`.
- */
+/** Intl.NumberFormat-based number formatter; without `locale`/`formatOptions`, round-trips through `String` unchanged. */
 export declare function formatNumberValue(value: number, locale?: string, formatOptions?: Intl.NumberFormatOptions): string;
-/**
- * Parses text the user typed or pasted back into a number, tolerating
- * everything {@link formatNumberValue} can emit: group separators, the
- * locale's decimal separator, currency symbols, unit suffixes, `%`, and the
- * Unicode minus sign. Returns `NaN` when the text holds no number.
- */
+/** Parses text into a number, tolerating everything {@link formatNumberValue} can emit; returns `NaN` when the text holds no number. */
 export declare function parseNumberValue(text: string, locale?: string, formatOptions?: Intl.NumberFormatOptions): number;

package/dist/utils/numberFormat.d.ts

@@ -1,14 +1,4 @@
-/**
- * `Intl.NumberFormat` display/parse pair for NumberField. Without `locale` or
- * `formatOptions`, the value round-trips through `String`/`Number` unchanged.
- * Percent follows `Intl.NumberFormat` semantics: the value is the fraction, so
- * `0.5` displays as `50%`.
- */
+/** Intl.NumberFormat-based number formatter; without `locale`/`formatOptions`, round-trips through `String` unchanged. */
 export declare function formatNumberValue(value: number, locale?: string, formatOptions?: Intl.NumberFormatOptions): string;
-/**
- * Parses text the user typed or pasted back into a number, tolerating
- * everything {@link formatNumberValue} can emit: group separators, the
- * locale's decimal separator, currency symbols, unit suffixes, `%`, and the
- * Unicode minus sign. Returns `NaN` when the text holds no number.
- */
+/** Parses text into a number, tolerating everything {@link formatNumberValue} can emit; returns `NaN` when the text holds no number. */
 export declare function parseNumberValue(text: string, locale?: string, formatOptions?: Intl.NumberFormatOptions): number;

package/dist/utils/pin-chars.cjs

@@ -0,0 +1 @@
+var u={text:null,numeric:/^[0-9]$/,alphanumeric:/^[a-zA-Z0-9]$/,alphabetic:/^[a-zA-Z]$/};function c(t,n){if(n){const i=new RegExp(n);return r=>i.test(r)}const e=u[t]??null;return e?i=>e.test(i):()=>!0}function p(t,n){return`Digit ${t} of ${n}`}exports.pinCharAcceptor=c;exports.pinInputDigitLabel=p;

package/dist/utils/pin-chars.d.cts

@@ -0,0 +1,13 @@
+/** The character sets `type` names, in the spelling the contract declares. */
+export type PinInputType = 'text' | 'numeric' | 'alphanumeric' | 'alphabetic';
+/** Builds the per-character predicate used to accept or reject each keystroke. */
+export declare function pinCharAcceptor(type: PinInputType, pattern?: string): (char: string) => boolean;
+/** Returns the pattern source {@link pinCharAcceptor} applies, defaulting to `'.'` for `'text'`. */
+export declare function pinCharPattern(type: PinInputType, pattern?: string): string;
+/**
+ * The default accessible name for a pin box. `index` is 1-based (read aloud).
+ *
+ * @param index the box's position, counting from 1
+ * @param length how many boxes the code has
+ */
+export declare function pinInputDigitLabel(index: number, length: number): string;

package/dist/utils/pin-chars.d.ts

@@ -0,0 +1,13 @@
+/** The character sets `type` names, in the spelling the contract declares. */
+export type PinInputType = 'text' | 'numeric' | 'alphanumeric' | 'alphabetic';
+/** Builds the per-character predicate used to accept or reject each keystroke. */
+export declare function pinCharAcceptor(type: PinInputType, pattern?: string): (char: string) => boolean;
+/** Returns the pattern source {@link pinCharAcceptor} applies, defaulting to `'.'` for `'text'`. */
+export declare function pinCharPattern(type: PinInputType, pattern?: string): string;
+/**
+ * The default accessible name for a pin box. `index` is 1-based (read aloud).
+ *
+ * @param index the box's position, counting from 1
+ * @param length how many boxes the code has
+ */
+export declare function pinInputDigitLabel(index: number, length: number): string;

package/dist/utils/pin-chars.js

@@ -0,0 +1 @@
+var t={text:null,numeric:/^[0-9]$/,alphanumeric:/^[a-zA-Z0-9]$/,alphabetic:/^[a-zA-Z]$/};function n(n,e){if(e){const t=new RegExp(e);return n=>t.test(n)}const i=t[n]??null;return i?t=>i.test(t):()=>!0}function e(t,n){return`Digit ${t} of ${n}`}export{n as pinCharAcceptor,e as pinInputDigitLabel};

package/dist/utils/placement.cjs

@@ -0,0 +1 @@
+function O(t,e){return e==="center"?t:`${t}-${e}`}function g(t){const[e,i="center"]=t.split("-");return[e,i]}var w={start:"0%",center:"50%",end:"100%"};function c(t,e,i){const{availableWidth:r,availableHeight:d,triggerWidth:a,side:n,align:o}=i,s=w[o],p=n==="top"||n==="bottom"?`${s} ${n==="top"?"100%":"0%"}`:`${n==="left"?"100%":"0%"} ${s}`;t.style.setProperty(`--skdx-${e}-available-width`,`${r}px`),t.style.setProperty(`--skdx-${e}-available-height`,`${d}px`),t.style.setProperty(`--skdx-${e}-trigger-width`,`${a}px`),t.style.setProperty(`--skdx-${e}-transform-origin`,p)}var m={top:"bottom",right:"left",bottom:"top",left:"right"};function S(t,e){const i=m[e],r={position:"absolute",left:t?.x!=null?`${t.x}px`:"",top:t?.y!=null?`${t.y}px`:"",right:"",bottom:"",transform:""};return i==="top"&&Object.assign(r,{top:"0px",transform:"translateY(-100%)"}),i==="bottom"&&Object.assign(r,{bottom:"0px",transform:"translateY(100%)"}),i==="left"&&Object.assign(r,{left:"0px",transform:"translateX(-100%)"}),i==="right"&&Object.assign(r,{right:"0px",transform:"translateX(100%)"}),r}function v(t,e){const{sideOffset:i=0,alignOffset:r=0,avoidCollisions:d=!0,collisionPadding:a=8,collisionBoundary:n,component:o,arrow:s,arrowPadding:p=0,hideWhenDetached:f=!1}=e,l=n?{boundary:n}:{};return[t.offset({mainAxis:i,alignmentAxis:r}),...d?[t.flip({padding:a,...l}),t.shift({padding:a,limiter:t.limitShift(),...l})]:[],t.size({padding:a,...l,apply({availableWidth:h,availableHeight:y,elements:b,rects:x,placement:P}){if(!o)return;const[$,u]=g(P);c(b.floating,o,{availableWidth:h,availableHeight:y,triggerWidth:x.reference.width,side:$,align:u})}}),...s?[t.arrow({element:s,padding:p})]:[],...f?[t.hide({strategy:"referenceHidden",...l})]:[]]}exports.OPPOSITE_SIDE=m;exports.arrowStyle=S;exports.placementParts=g;exports.positioningMiddleware=v;exports.setMeasurementProperties=c;exports.toPlacement=O;

package/dist/utils/placement.d.cts

@@ -0,0 +1,102 @@
+/** A physical edge of the anchor. */
+export type PhysicalSide = 'top' | 'right' | 'bottom' | 'left';
+/** Side the floating content is placed against; `start`/`end` are logical and resolve under `dir`. */
+export type Side = PhysicalSide | 'start' | 'end';
+/** Alignment of the floating element along the chosen {@link Side}. */
+export type Align = 'start' | 'center' | 'end';
+/** Minimum distance from the collision boundary, for every side or per side. */
+export type CollisionPadding = number | Partial<Record<PhysicalSide, number>>;
+/** The floating-ui placement string for a resolved side and alignment. */
+export declare function toPlacement(side: PhysicalSide, align: Align): string;
+/** The side and alignment a floating-ui placement string resolved to. */
+export declare function placementParts(placement: string): [PhysicalSide, Align];
+/**
+ * Writes the four `--skdx-<component>-*` measurement properties onto the floating element after a reposition, with the transform origin derived from the resolved side/alignment so a flipped panel grows from the edge it actually sits on.
+ */
+export declare function setMeasurementProperties(floating: HTMLElement, component: string, measurements: {
+    availableWidth: number;
+    availableHeight: number;
+    triggerWidth: number;
+    side: PhysicalSide;
+    align: Align;
+}): void;
+/** The edge an arrow sits on: opposite the side the panel was placed against. */
+export declare const OPPOSITE_SIDE: Record<PhysicalSide, PhysicalSide>;
+/** Inline style for an arrow element given floating-ui's arrow offsets and the resolved side. */
+export declare function arrowStyle(offsets: {
+    x?: number | undefined;
+    y?: number | undefined;
+} | undefined, side: PhysicalSide): {
+    position: 'absolute';
+    left: string;
+    top: string;
+    right: string;
+    bottom: string;
+    transform: string;
+};
+/** Applies {@link arrowStyle} to an arrow element in place. */
+export declare function styleArrow(el: HTMLElement, offsets: {
+    x?: number | undefined;
+    y?: number | undefined;
+} | undefined, side: PhysicalSide): void;
+/** What the `size` middleware reports after flip/shift settled. */
+export interface SizeState {
+    availableWidth: number;
+    availableHeight: number;
+    elements: {
+        floating: HTMLElement;
+    };
+    rects: {
+        reference: {
+            width: number;
+        };
+    };
+    placement: string;
+}
+/** The floating-ui middleware factories an adapter injects — `M` is its `Middleware`, `L` its shift limiter, `E` what its `arrow` accepts as the element. */
+export interface FloatingMiddleware<M, L, E> {
+    offset(options: {
+        mainAxis: number;
+        alignmentAxis: number;
+    }): M;
+    flip(options: {
+        padding: CollisionPadding;
+        boundary?: Element | Element[];
+    }): M;
+    shift(options: {
+        padding: CollisionPadding;
+        limiter: L;
+        boundary?: Element | Element[];
+    }): M;
+    limitShift(): L;
+    size(options: {
+        padding: CollisionPadding;
+        boundary?: Element | Element[];
+        apply(state: SizeState): void;
+    }): M;
+    arrow(options: {
+        element: E;
+        padding: number;
+    }): M;
+    hide(options: {
+        strategy: 'referenceHidden';
+        boundary?: Element | Element[];
+    }): M;
+}
+/** The options {@link positioningMiddleware} turns into a middleware list. */
+export interface PositioningOptions<E> {
+    sideOffset?: number | undefined;
+    alignOffset?: number | undefined;
+    avoidCollisions?: boolean | undefined;
+    collisionPadding?: CollisionPadding | undefined;
+    collisionBoundary?: Element | Element[] | null | undefined;
+    /** Kebab-case component name the measurement properties are written under; omitted, none are written. */
+    component?: string | undefined;
+    arrow?: E | null | undefined;
+    arrowPadding?: number | undefined;
+    hideWhenDetached?: boolean | undefined;
+}
+/**
+ * The one middleware order every panel uses: offset, then flip/shift when collisions are avoided, then `size` (so it measures the placement the content landed on), the arrow, and `hide` last so visibility is judged against the settled placement.
+ */
+export declare function positioningMiddleware<M, L, E>(fu: FloatingMiddleware<M, L, E>, options: PositioningOptions<E>): M[];