@skdx/react 0.28.0 → 0.29.0

package/dist/utils/tabbable.d.cts

@@ -1,8 +1,4 @@
-/**
- * The elements a `Tab` press can land on. One definition of what "tabbable"
- * means in this package, for the components that have to walk the tab order by
- * hand.
- */
+/** The elements a `Tab` press can land on — this package's one definition of "tabbable", for components that have to walk the tab order by hand. */
 export declare const TABBABLE_SELECTOR: string;
 /**
  * Every tabbable element inside `container`, in document order. Uses only the

package/dist/utils/tabbable.d.ts

@@ -1,8 +1,4 @@
-/**
- * The elements a `Tab` press can land on. One definition of what "tabbable"
- * means in this package, for the components that have to walk the tab order by
- * hand.
- */
+/** The elements a `Tab` press can land on — this package's one definition of "tabbable", for components that have to walk the tab order by hand. */
 export declare const TABBABLE_SELECTOR: string;
 /**
  * Every tabbable element inside `container`, in document order. Uses only the

package/dist/utils/tabbable.js

@@ -1 +1,2 @@
-var t=["a[href]","button:not([disabled])",'input:not([disabled]):not([type="hidden"])',"select:not([disabled])","textarea:not([disabled])",'[tabindex]:not([tabindex="-1"])'].join(", ");function n(e){return Array.from(e.querySelectorAll(t))}export{t as TABBABLE_SELECTOR,n as tabbablesWithin};
+'use client';
+var e=["a[href]","button:not([disabled])",'input:not([disabled]):not([type="hidden"])',"select:not([disabled])","textarea:not([disabled])",'[tabindex]:not([tabindex="-1"])'].join(", ");function n(t){return Array.from(t.querySelectorAll(e))}export{e as TABBABLE_SELECTOR,n as tabbablesWithin};

package/dist/utils/timer.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var a=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var o=Object.prototype.hasOwnProperty;var u=(i,e)=>{for(var s in e)a(i,s,{get:e[s],enumerable:!0})},p=(i,e,s,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of h(e))!o.call(i,t)&&t!==s&&a(i,t,{get:()=>e[t],enumerable:!(r=d(e,t))||r.enumerable});return i};var c=i=>p(a({},"__esModule",{value:!0}),i);var l={};u(l,{Timer:()=>n});module.exports=c(l);var n=class{constructor(e={}){this.phase="idle";this.accrued=0;this.startedAt=0;this.pausedByPage=!1;this.onVisibilityChange=()=>{document.hidden?this.pauseForPage():this.pausedByPage&&this.resume()};this.onPageHide=()=>{this.pauseForPage()};this.options=e,this.duration=e.duration??Number.POSITIVE_INFINITY,this.tickMs=e.tickMs??0,!(e.pauseWhenHidden===!1||typeof document>"u")&&(document.addEventListener("visibilitychange",this.onVisibilityChange),window.addEventListener("pagehide",this.onPageHide))}get state(){let e=this.measure();return{phase:this.phase,elapsed:e,remaining:this.duration-e,duration:this.duration}}start(e){e!==void 0&&(this.duration=e),this.clearHandles(),this.accrued=0,this.pausedByPage=!1,this.run()}pause(){this.pausedByPage=!1,this.phase==="running"&&(this.accrued=this.measure(),this.clearHandles(),this.setPhase("paused"))}resume(){this.pausedByPage=!1,this.phase==="paused"&&this.run()}reset(){this.clearHandles(),this.accrued=0,this.startedAt=0,this.pausedByPage=!1,this.setPhase("idle")}destroy(){this.clearHandles(),!(this.options.pauseWhenHidden===!1||typeof document>"u")&&(document.removeEventListener("visibilitychange",this.onVisibilityChange),window.removeEventListener("pagehide",this.onPageHide))}measure(){let e=this.phase==="running"?Date.now()-this.startedAt:0;return Math.min(this.accrued+e,this.duration)}run(){this.startedAt=Date.now();let e=this.duration-this.accrued;Number.isFinite(e)&&(this.completion=setTimeout(()=>this.complete(),Math.max(e,0))),this.tickMs>0&&(this.ticker=setInterval(()=>this.options.onTick?.(this.state),this.tickMs)),this.setPhase("running")}complete(){this.clearHandles(),this.accrued=this.duration,this.setPhase("complete"),this.tickMs>0&&this.options.onTick?.(this.state)}setPhase(e){this.phase!==e&&(this.phase=e,this.options.onPhaseChange?.(this.state))}clearHandles(){clearTimeout(this.completion),clearInterval(this.ticker),this.completion=void 0,this.ticker=void 0}pauseForPage(){this.phase==="running"&&(this.pause(),this.pausedByPage=!0)}};0&&(module.exports={Timer});

package/dist/utils/timer.d.cts

@@ -0,0 +1,82 @@
+/** Where the clock stands: never started, running, held by a pause, or finished. */
+export type TimerPhase = 'idle' | 'running' | 'paused' | 'complete';
+/** The clock as a consumer renders it, computed fresh on every read. */
+export interface TimerState {
+    /** Where the clock stands right now, as one of the four phases. */
+    phase: TimerPhase;
+    /** Milliseconds the clock has actually run, never counting paused time. */
+    elapsed: number;
+    /** Milliseconds left before completion, or `Infinity` when counting up. */
+    remaining: number;
+    /** The countdown length in force, `Infinity` for an open-ended count-up. */
+    duration: number;
+}
+/** How one clock is configured; every field has a working default. */
+export interface TimerOptions {
+    /**
+     * Countdown length in milliseconds; leave it out to count up with no end.
+     *
+     * @default Infinity
+     */
+    duration?: number | undefined;
+    /**
+     * Milliseconds between `onTick` calls while running; `0` reports no ticks.
+     *
+     * @default 0
+     */
+    tickMs?: number | undefined;
+    /**
+     * Whether a hidden or unloading page pauses the clock and a returning page resumes it.
+     *
+     * @default true
+     */
+    pauseWhenHidden?: boolean | undefined;
+    /**
+     * Called on every tick and once more at completion, for rendering the clock only.
+     *
+     * Ticks are far too frequent to announce: write them to a progress bar or a
+     * `<time>`, never to a live region.
+     */
+    onTick?: ((state: TimerState) => void) | undefined;
+    /**
+     * Called when the phase changes, and only on an actual change, so it is the one place announcements belong.
+     */
+    onPhaseChange?: ((state: TimerState) => void) | undefined;
+}
+/** A framework-neutral countdown or count-up: `start`, `pause`, `resume`, `reset`, and a completion phase. */
+export declare class Timer {
+    private readonly options;
+    private readonly tickMs;
+    private duration;
+    private phase;
+    private accrued;
+    private startedAt;
+    private completion;
+    private ticker;
+    private pausedByPage;
+    constructor(options?: TimerOptions);
+    /** The phase, elapsed, remaining and duration as they read at this instant. */
+    get state(): TimerState;
+    /**
+     * Runs the clock from zero, replacing whatever it was doing.
+     *
+     * @param duration a new countdown length to adopt, in milliseconds
+     */
+    start(duration?: number): void;
+    /** Holds the clock where it stands; a second call while already paused changes nothing. */
+    pause(): void;
+    /** Runs the clock on from where a pause left it; ignored unless it is paused. */
+    resume(): void;
+    /** Stops the clock and returns it to zero, as it was before the first `start`. */
+    reset(): void;
+    /** Stops the clock and releases every listener and handle it holds. */
+    destroy(): void;
+    private measure;
+    private run;
+    private complete;
+    private setPhase;
+    private clearHandles;
+    private readonly onVisibilityChange;
+    private readonly onPageHide;
+    private pauseForPage;
+}

package/dist/utils/timer.d.ts

@@ -0,0 +1,82 @@
+/** Where the clock stands: never started, running, held by a pause, or finished. */
+export type TimerPhase = 'idle' | 'running' | 'paused' | 'complete';
+/** The clock as a consumer renders it, computed fresh on every read. */
+export interface TimerState {
+    /** Where the clock stands right now, as one of the four phases. */
+    phase: TimerPhase;
+    /** Milliseconds the clock has actually run, never counting paused time. */
+    elapsed: number;
+    /** Milliseconds left before completion, or `Infinity` when counting up. */
+    remaining: number;
+    /** The countdown length in force, `Infinity` for an open-ended count-up. */
+    duration: number;
+}
+/** How one clock is configured; every field has a working default. */
+export interface TimerOptions {
+    /**
+     * Countdown length in milliseconds; leave it out to count up with no end.
+     *
+     * @default Infinity
+     */
+    duration?: number | undefined;
+    /**
+     * Milliseconds between `onTick` calls while running; `0` reports no ticks.
+     *
+     * @default 0
+     */
+    tickMs?: number | undefined;
+    /**
+     * Whether a hidden or unloading page pauses the clock and a returning page resumes it.
+     *
+     * @default true
+     */
+    pauseWhenHidden?: boolean | undefined;
+    /**
+     * Called on every tick and once more at completion, for rendering the clock only.
+     *
+     * Ticks are far too frequent to announce: write them to a progress bar or a
+     * `<time>`, never to a live region.
+     */
+    onTick?: ((state: TimerState) => void) | undefined;
+    /**
+     * Called when the phase changes, and only on an actual change, so it is the one place announcements belong.
+     */
+    onPhaseChange?: ((state: TimerState) => void) | undefined;
+}
+/** A framework-neutral countdown or count-up: `start`, `pause`, `resume`, `reset`, and a completion phase. */
+export declare class Timer {
+    private readonly options;
+    private readonly tickMs;
+    private duration;
+    private phase;
+    private accrued;
+    private startedAt;
+    private completion;
+    private ticker;
+    private pausedByPage;
+    constructor(options?: TimerOptions);
+    /** The phase, elapsed, remaining and duration as they read at this instant. */
+    get state(): TimerState;
+    /**
+     * Runs the clock from zero, replacing whatever it was doing.
+     *
+     * @param duration a new countdown length to adopt, in milliseconds
+     */
+    start(duration?: number): void;
+    /** Holds the clock where it stands; a second call while already paused changes nothing. */
+    pause(): void;
+    /** Runs the clock on from where a pause left it; ignored unless it is paused. */
+    resume(): void;
+    /** Stops the clock and returns it to zero, as it was before the first `start`. */
+    reset(): void;
+    /** Stops the clock and releases every listener and handle it holds. */
+    destroy(): void;
+    private measure;
+    private run;
+    private complete;
+    private setPhase;
+    private clearHandles;
+    private readonly onVisibilityChange;
+    private readonly onPageHide;
+    private pauseForPage;
+}

package/dist/utils/timer.js

@@ -0,0 +1,2 @@
+'use client';
+var i=class{constructor(e={}){this.phase="idle";this.accrued=0;this.startedAt=0;this.pausedByPage=!1;this.onVisibilityChange=()=>{document.hidden?this.pauseForPage():this.pausedByPage&&this.resume()};this.onPageHide=()=>{this.pauseForPage()};this.options=e,this.duration=e.duration??Number.POSITIVE_INFINITY,this.tickMs=e.tickMs??0,!(e.pauseWhenHidden===!1||typeof document>"u")&&(document.addEventListener("visibilitychange",this.onVisibilityChange),window.addEventListener("pagehide",this.onPageHide))}get state(){let e=this.measure();return{phase:this.phase,elapsed:e,remaining:this.duration-e,duration:this.duration}}start(e){e!==void 0&&(this.duration=e),this.clearHandles(),this.accrued=0,this.pausedByPage=!1,this.run()}pause(){this.pausedByPage=!1,this.phase==="running"&&(this.accrued=this.measure(),this.clearHandles(),this.setPhase("paused"))}resume(){this.pausedByPage=!1,this.phase==="paused"&&this.run()}reset(){this.clearHandles(),this.accrued=0,this.startedAt=0,this.pausedByPage=!1,this.setPhase("idle")}destroy(){this.clearHandles(),!(this.options.pauseWhenHidden===!1||typeof document>"u")&&(document.removeEventListener("visibilitychange",this.onVisibilityChange),window.removeEventListener("pagehide",this.onPageHide))}measure(){let e=this.phase==="running"?Date.now()-this.startedAt:0;return Math.min(this.accrued+e,this.duration)}run(){this.startedAt=Date.now();let e=this.duration-this.accrued;Number.isFinite(e)&&(this.completion=setTimeout(()=>this.complete(),Math.max(e,0))),this.tickMs>0&&(this.ticker=setInterval(()=>this.options.onTick?.(this.state),this.tickMs)),this.setPhase("running")}complete(){this.clearHandles(),this.accrued=this.duration,this.setPhase("complete"),this.tickMs>0&&this.options.onTick?.(this.state)}setPhase(e){this.phase!==e&&(this.phase=e,this.options.onPhaseChange?.(this.state))}clearHandles(){clearTimeout(this.completion),clearInterval(this.ticker),this.completion=void 0,this.ticker=void 0}pauseForPage(){this.phase==="running"&&(this.pause(),this.pausedByPage=!0)}};export{i as Timer};

package/dist/utils/tree-columns.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var a=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var f=(n,e)=>{for(var r in e)a(n,r,{get:e[r],enumerable:!0})},m=(n,e,r,l)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of s(e))!c.call(n,o)&&o!==r&&a(n,o,{get:()=>e[o],enumerable:!(l=i(e,o))||l.enumerable});return n};var h=n=>m(a({},"__esModule",{value:!0}),n);var g={};f(g,{columnIndexOf:()=>p,pathTo:()=>T,treeColumns:()=>C});module.exports=h(g);function C(n,e){let r=new Set(e),l=[{parent:null,nodes:n}],o=new Set,t=n;for(;;){let u=t.find(d=>r.has(d.value)&&!o.has(d.value)&&((d.children?.length??0)>0||d.hasChildren===!0));if(!u)return l;o.add(u.value),t=u.children??[],l.push({parent:u.value,nodes:t})}}function T(n,e){let r=(l,o)=>{for(let t of l){let u=[...o,t.value];if(t.value===e)return u;let d=t.children?r(t.children,u):null;if(d)return d}return null};return r(n,[])??[]}function p(n,e){return n.findIndex(r=>r.nodes.some(l=>l.value===e))}0&&(module.exports={columnIndexOf,pathTo,treeColumns});

package/dist/utils/tree-columns.d.cts

@@ -0,0 +1,48 @@
+/** The minimal node shape the projection reads; the adapters' own node types are supersets of it. */
+export interface TreeColumnNode {
+    value: string;
+    disabled?: boolean | undefined;
+    /** Declares a branch whose children have not loaded yet, so its column exists while still empty. */
+    hasChildren?: boolean | undefined;
+    children?: readonly TreeColumnNode[] | undefined;
+}
+/** One rendered column: the sibling set at a single depth. */
+export interface TreeColumn {
+    /** The branch whose children this column lists, or `null` for the root column. */
+    parent: string | null;
+    /** The column's nodes in collection order; empty while a lazy branch is still loading. */
+    nodes: readonly TreeColumnNode[];
+}
+/**
+ * The columns showing for an expanded set: the roots, then one column per expanded branch along a single open path.
+ *
+ * Columns are a chain, so at most one branch per depth can be open. An
+ * `expanded` set naming two branches at the same depth is not an error: the
+ * first in collection order wins and the rest are ignored, which keeps the
+ * projection total and lets a consumer hand the same `expanded` array to
+ * either layout.
+ *
+ * @param collection the root nodes, each carrying its own children
+ * @param expanded every expanded node's value, in any order
+ * @returns the columns left to right; always at least the root column
+ */
+export declare function treeColumns(collection: readonly TreeColumnNode[], expanded: Iterable<string>): TreeColumn[];
+/**
+ * The chain of values from the root down to `value`, inclusive, or empty when the collection does not hold it.
+ *
+ * This is the expanded set that opens `value`'s own column: passing it to
+ * {@link treeColumns} shows every ancestor's column and closes every branch off
+ * the path. Dropping its last entry is the set that closes `value`'s column
+ * instead, which is what moving back a column needs.
+ *
+ * @param collection the root nodes, each carrying its own children
+ * @param value the node to reach
+ */
+export declare function pathTo(collection: readonly TreeColumnNode[], value: string): string[];
+/**
+ * The index of the column holding `value`, or `-1` when no showing column does.
+ *
+ * @param columns the projection {@link treeColumns} returned
+ * @param value the node to locate
+ */
+export declare function columnIndexOf(columns: readonly TreeColumn[], value: string): number;

package/dist/utils/tree-columns.d.ts

@@ -0,0 +1,48 @@
+/** The minimal node shape the projection reads; the adapters' own node types are supersets of it. */
+export interface TreeColumnNode {
+    value: string;
+    disabled?: boolean | undefined;
+    /** Declares a branch whose children have not loaded yet, so its column exists while still empty. */
+    hasChildren?: boolean | undefined;
+    children?: readonly TreeColumnNode[] | undefined;
+}
+/** One rendered column: the sibling set at a single depth. */
+export interface TreeColumn {
+    /** The branch whose children this column lists, or `null` for the root column. */
+    parent: string | null;
+    /** The column's nodes in collection order; empty while a lazy branch is still loading. */
+    nodes: readonly TreeColumnNode[];
+}
+/**
+ * The columns showing for an expanded set: the roots, then one column per expanded branch along a single open path.
+ *
+ * Columns are a chain, so at most one branch per depth can be open. An
+ * `expanded` set naming two branches at the same depth is not an error: the
+ * first in collection order wins and the rest are ignored, which keeps the
+ * projection total and lets a consumer hand the same `expanded` array to
+ * either layout.
+ *
+ * @param collection the root nodes, each carrying its own children
+ * @param expanded every expanded node's value, in any order
+ * @returns the columns left to right; always at least the root column
+ */
+export declare function treeColumns(collection: readonly TreeColumnNode[], expanded: Iterable<string>): TreeColumn[];
+/**
+ * The chain of values from the root down to `value`, inclusive, or empty when the collection does not hold it.
+ *
+ * This is the expanded set that opens `value`'s own column: passing it to
+ * {@link treeColumns} shows every ancestor's column and closes every branch off
+ * the path. Dropping its last entry is the set that closes `value`'s column
+ * instead, which is what moving back a column needs.
+ *
+ * @param collection the root nodes, each carrying its own children
+ * @param value the node to reach
+ */
+export declare function pathTo(collection: readonly TreeColumnNode[], value: string): string[];
+/**
+ * The index of the column holding `value`, or `-1` when no showing column does.
+ *
+ * @param columns the projection {@link treeColumns} returned
+ * @param value the node to locate
+ */
+export declare function columnIndexOf(columns: readonly TreeColumn[], value: string): number;

package/dist/utils/tree-columns.js

@@ -0,0 +1,2 @@
+'use client';
+function a(o,u){let l=new Set(u),t=[{parent:null,nodes:o}],d=new Set,e=o;for(;;){let n=e.find(r=>l.has(r.value)&&!d.has(r.value)&&((r.children?.length??0)>0||r.hasChildren===!0));if(!n)return t;d.add(n.value),e=n.children??[],t.push({parent:n.value,nodes:e})}}function i(o,u){let l=(t,d)=>{for(let e of t){let n=[...d,e.value];if(e.value===u)return n;let r=e.children?l(e.children,n):null;if(r)return r}return null};return l(o,[])??[]}function s(o,u){return o.findIndex(l=>l.nodes.some(t=>t.value===u))}export{s as columnIndexOf,i as pathTo,a as treeColumns};

package/dist/utils/typeahead.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var s=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var T=(t,e)=>{for(var i in e)s(t,i,{get:e[i],enumerable:!0})},g=(t,e,i,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of l(e))!b.call(t,r)&&r!==i&&s(t,r,{get:()=>e[r],enumerable:!(o=c(e,r))||o.enumerable});return t};var y=t=>g(s({},"__esModule",{value:!0}),t);var K={};T(K,{TYPEAHEAD_TIMEOUT_MS:()=>p,Typeahead:()=>a,isTypeaheadKey:()=>x,itemText:()=>E});module.exports=y(K);var p=1e3;function x(t){return t.key.length===1&&!t.ctrlKey&&!t.metaKey&&!t.altKey}function E(t){return t.getAttribute("data-text-value")??t.textContent??""}var a=class{constructor(){this.buffer=""}match(e,i,o){if(e===" "&&this.buffer==="")return-1;clearTimeout(this.timer),this.buffer+=e.toLowerCase(),this.timer=setTimeout(()=>this.buffer="",1e3);let r=this.buffer,f=r.length>1&&[...r].every(n=>n===r[0]),m=f?r[0]:r,h=f||r.length===1?o+1:o;for(let n=0;n<i.length;n++){let u=(Math.max(h,0)+n)%i.length;if(i[u].trim().toLowerCase().startsWith(m))return u}return-1}clear(){clearTimeout(this.timer),this.buffer=""}};0&&(module.exports={TYPEAHEAD_TIMEOUT_MS,Typeahead,isTypeaheadKey,itemText});

package/dist/utils/typeahead.d.cts

@@ -0,0 +1,27 @@
+/** How long successive keys keep merging into one search before the buffer resets. */
+export declare const TYPEAHEAD_TIMEOUT_MS = 1000;
+/** Plain printable character, not a shortcut or named key. */
+export declare function isTypeaheadKey(event: {
+    key: string;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    altKey: boolean;
+}): boolean;
+/**
+ * Text typeahead matches: explicit `data-text-value`, else rendered text, since raw `textContent` fails for items rendering beyond their label.
+ * @internal
+ */
+export declare function itemText(el: Element): string;
+/** Letter-key search like native `<select>` (accumulating buffer and timer), shared by every collection and menu family. */
+export declare class Typeahead {
+    private buffer;
+    private timer?;
+    /**
+     * Matches `key` against the label collection, accumulating a 1s buffer (`"s"` + `"a"` = `"sa"`); repeating one letter cycles through matches.
+     *
+     * @returns the index to move to, or `-1` for no match.
+     */
+    match(key: string, labels: string[], currentIndex: number): number;
+    /** Drops the pending buffer and its timer. Call when the owner unmounts or closes. */
+    clear(): void;
+}

package/dist/utils/typeahead.d.ts

@@ -0,0 +1,27 @@
+/** How long successive keys keep merging into one search before the buffer resets. */
+export declare const TYPEAHEAD_TIMEOUT_MS = 1000;
+/** Plain printable character, not a shortcut or named key. */
+export declare function isTypeaheadKey(event: {
+    key: string;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    altKey: boolean;
+}): boolean;
+/**
+ * Text typeahead matches: explicit `data-text-value`, else rendered text, since raw `textContent` fails for items rendering beyond their label.
+ * @internal
+ */
+export declare function itemText(el: Element): string;
+/** Letter-key search like native `<select>` (accumulating buffer and timer), shared by every collection and menu family. */
+export declare class Typeahead {
+    private buffer;
+    private timer?;
+    /**
+     * Matches `key` against the label collection, accumulating a 1s buffer (`"s"` + `"a"` = `"sa"`); repeating one letter cycles through matches.
+     *
+     * @returns the index to move to, or `-1` for no match.
+     */
+    match(key: string, labels: string[], currentIndex: number): number;
+    /** Drops the pending buffer and its timer. Call when the owner unmounts or closes. */
+    clear(): void;
+}

package/dist/utils/typeahead.js

@@ -0,0 +1,2 @@
+'use client';
+var h=1e3;function c(t){return t.key.length===1&&!t.ctrlKey&&!t.metaKey&&!t.altKey}function l(t){return t.getAttribute("data-text-value")??t.textContent??""}var f=class{constructor(){this.buffer=""}match(o,i,n){if(o===" "&&this.buffer==="")return-1;clearTimeout(this.timer),this.buffer+=o.toLowerCase(),this.timer=setTimeout(()=>this.buffer="",1e3);let e=this.buffer,s=e.length>1&&[...e].every(r=>r===e[0]),u=s?e[0]:e,m=s||e.length===1?n+1:n;for(let r=0;r<i.length;r++){let a=(Math.max(m,0)+r)%i.length;if(i[a].trim().toLowerCase().startsWith(u))return a}return-1}clear(){clearTimeout(this.timer),this.buffer=""}};export{h as TYPEAHEAD_TIMEOUT_MS,f as Typeahead,c as isTypeaheadKey,l as itemText};

package/dist/utils/useBodyScrollLock.cjs

@@ -1 +1,2 @@
-"use strict";var f=Object.create;var n=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var a=Object.getPrototypeOf,g=Object.prototype.hasOwnProperty;var h=(o,t)=>{for(var e in t)n(o,e,{get:t[e],enumerable:!0})},c=(o,t,e,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let d of s(t))!g.call(o,d)&&d!==e&&n(o,d,{get:()=>t[d],enumerable:!(l=m(t,d))||l.enumerable});return o};var b=(o,t,e)=>(e=o!=null?f(a(o)):{},c(t||!o||!o.__esModule?n(e,"default",{value:o,enumerable:!0}):e,o)),p=o=>c(n({},"__esModule",{value:!0}),o);var R={};h(R,{useBodyScrollLock:()=>w});module.exports=p(R);var y=b(require("react"),1),i=0,r="",u="";function w(o){y.useEffect(()=>{if(o){if(i===0){let t=window.innerWidth-document.documentElement.clientWidth;r=document.body.style.overflow,u=document.body.style.paddingRight,document.body.style.overflow="hidden",t>0&&(document.body.style.paddingRight=`${t}px`)}return i++,()=>{i--,i===0&&(document.body.style.overflow=r,document.body.style.paddingRight=u)}}},[o])}0&&(module.exports={useBodyScrollLock});
+'use client';
+"use strict";var f=Object.create;var i=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var a=Object.getPrototypeOf,g=Object.prototype.hasOwnProperty;var h=(o,t)=>{for(var e in t)i(o,e,{get:t[e],enumerable:!0})},c=(o,t,e,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let d of s(t))!g.call(o,d)&&d!==e&&i(o,d,{get:()=>t[d],enumerable:!(l=m(t,d))||l.enumerable});return o};var b=(o,t,e)=>(e=o!=null?f(a(o)):{},c(t||!o||!o.__esModule?i(e,"default",{value:o,enumerable:!0}):e,o)),p=o=>c(i({},"__esModule",{value:!0}),o);var R={};h(R,{useBodyScrollLock:()=>w});module.exports=p(R);var y=b(require("react"),1),n=0,r="",u="";function w(o){y.useEffect(()=>{if(o){if(n===0){let t=window.innerWidth-document.documentElement.clientWidth;r=document.body.style.overflow,u=document.body.style.paddingRight,document.body.style.overflow="hidden",t>0&&(document.body.style.paddingRight=`${t}px`)}return n++,()=>{n--,n===0&&(document.body.style.overflow=r,document.body.style.paddingRight=u)}}},[o])}0&&(module.exports={useBodyScrollLock});

package/dist/utils/useBodyScrollLock.js

@@ -1 +1,2 @@
-import*as i from"react";var o=0,d="",n="";function l(t){i.useEffect(()=>{if(t){if(o===0){let e=window.innerWidth-document.documentElement.clientWidth;d=document.body.style.overflow,n=document.body.style.paddingRight,document.body.style.overflow="hidden",e>0&&(document.body.style.paddingRight=`${e}px`)}return o++,()=>{o--,o===0&&(document.body.style.overflow=d,document.body.style.paddingRight=n)}}},[t])}export{l as useBodyScrollLock};
+'use client';
+import*as n from"react";var o=0,d="",i="";function l(t){n.useEffect(()=>{if(t){if(o===0){let e=window.innerWidth-document.documentElement.clientWidth;d=document.body.style.overflow,i=document.body.style.paddingRight,document.body.style.overflow="hidden",e>0&&(document.body.style.paddingRight=`${e}px`)}return o++,()=>{o--,o===0&&(document.body.style.overflow=d,document.body.style.paddingRight=i)}}},[t])}export{l as useBodyScrollLock};

package/dist/utils/useCallbackRef.cjs

@@ -1 +1,2 @@
+'use client';
 "use strict";var f=Object.create;var u=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var T=Object.getPrototypeOf,d=Object.prototype.hasOwnProperty;var i=(e,n)=>{for(var t in n)u(e,t,{get:n[t],enumerable:!0})},s=(e,n,t,a)=>{if(n&&typeof n=="object"||typeof n=="function")for(let c of R(n))!d.call(e,c)&&c!==t&&u(e,c,{get:()=>n[c],enumerable:!(a=o(n,c))||a.enumerable});return e};var m=(e,n,t)=>(t=e!=null?f(T(e)):{},s(n||!e||!e.__esModule?u(t,"default",{value:e,enumerable:!0}):t,e)),k=e=>s(u({},"__esModule",{value:!0}),e);var p={};i(p,{useCallbackRef:()=>l});module.exports=k(p);var r=m(require("react"),1);function l(e){let n=r.useRef(e);return r.useEffect(()=>{n.current=e}),r.useMemo(()=>((...t)=>n.current?.(...t)),[])}0&&(module.exports={useCallbackRef});

package/dist/utils/useCallbackRef.d.cts

@@ -1,5 +1,5 @@
 /**
- * Stable function identity across renders that invokes the latest callback. Prevents re-subscribing listeners.
+ * Stable function identity across renders that invokes the latest callback, preventing re-subscribing listeners.
  *
  * @example
  * ```tsx
@@ -9,5 +9,7 @@
  *   return () => document.removeEventListener('keydown', handleChange);
  * }, [handleChange]); // stable — effect doesn't re-run when `onChange` changes
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
 export declare function useCallbackRef<T extends (...args: never[]) => unknown>(callback: T | undefined): T;

package/dist/utils/useCallbackRef.d.ts

@@ -1,5 +1,5 @@
 /**
- * Stable function identity across renders that invokes the latest callback. Prevents re-subscribing listeners.
+ * Stable function identity across renders that invokes the latest callback, preventing re-subscribing listeners.
  *
  * @example
  * ```tsx
@@ -9,5 +9,7 @@
  *   return () => document.removeEventListener('keydown', handleChange);
  * }, [handleChange]); // stable — effect doesn't re-run when `onChange` changes
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
 export declare function useCallbackRef<T extends (...args: never[]) => unknown>(callback: T | undefined): T;

package/dist/utils/useCallbackRef.js

@@ -1 +1,2 @@
+'use client';
 import*as e from"react";function c(n){let t=e.useRef(n);return e.useEffect(()=>{t.current=n}),e.useMemo(()=>((...r)=>t.current?.(...r)),[])}export{c as useCallbackRef};

package/dist/utils/useControllableState.cjs

@@ -1 +1,2 @@
-"use strict";var p=Object.create;var l=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var v=Object.getPrototypeOf,P=Object.prototype.hasOwnProperty;var h=(e,t)=>{for(var n in t)l(e,n,{get:t[n],enumerable:!0})},T=(e,t,n,c)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of b(t))!P.call(e,o)&&o!==n&&l(e,o,{get:()=>t[o],enumerable:!(c=S(t,o))||c.enumerable});return e};var U=(e,t,n)=>(n=e!=null?p(v(e)):{},T(t||!e||!e.__esModule?l(n,"default",{value:e,enumerable:!0}):n,e)),g=e=>T(l({},"__esModule",{value:!0}),e);var y={};h(y,{useControllableState:()=>k});module.exports=g(y);var a=U(require("react"),1),C=require("./useCallbackRef.cjs");function k({prop:e,defaultProp:t,onChange:n=()=>{}}){let[c,o]=a.useState(t),s=e!==void 0,r=s?e:c,i=(0,C.useCallbackRef)(n),f=a.useRef(r);a.useLayoutEffect(()=>{f.current=r},[r]);let m=a.useCallback(d=>{let R=s?e:f.current,u=typeof d=="function"?d(R):d;u!==R&&(s||(f.current=u,o(u)),i(u))},[s,e,i]);return[r,m]}0&&(module.exports={useControllableState});
+'use client';
+"use strict";var b=Object.create;var d=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var P=Object.getPrototypeOf,y=Object.prototype.hasOwnProperty;var U=(e,t)=>{for(var n in t)d(e,n,{get:t[n],enumerable:!0})},p=(e,t,n,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of h(t))!y.call(e,a)&&a!==n&&d(e,a,{get:()=>t[a],enumerable:!(l=v(t,a))||l.enumerable});return e};var g=(e,t,n)=>(n=e!=null?b(P(e)):{},p(t||!e||!e.__esModule?d(n,"default",{value:e,enumerable:!0}):n,e)),k=e=>p(d({},"__esModule",{value:!0}),e);var D={};U(D,{useControllableState:()=>A});module.exports=k(D);var o=g(require("react"),1),c=require("./controllable.cjs"),m=require("./useCallbackRef.cjs");function A({prop:e,defaultProp:t,onChange:n=()=>{}}){let[l,a]=o.useState(t),r=(0,c.controllableValue)({controlled:e,uncontrolled:l}),f=(0,m.useCallbackRef)(n),u=o.useRef(r);o.useLayoutEffect(()=>{u.current=r},[r]);let C=o.useCallback(i=>{let R={controlled:e,uncontrolled:u.current},S=(0,c.controllableValue)(R),T=typeof i=="function"?i(S):i,s=(0,c.decideControllable)(R,T);s.write&&(u.current=s.value,a(s.value)),s.emit&&f(T)},[e,f]);return[r,C]}0&&(module.exports={useControllableState});

package/dist/utils/useControllableState.d.cts

@@ -5,11 +5,10 @@ interface UseControllableStateParams<T> {
     /** Initial value for uncontrolled usage; ignored once `prop` is defined. */
     defaultProp?: T | undefined;
     /** Called with the next value whenever it changes, in both controlled and uncontrolled modes. */
-    onChange?: (state: T) => void;
+    onChange?: ((state: T) => void) | undefined;
 }
 /**
- * Controlled/uncontrolled pattern. Behaves like `useState` when `prop` is
- * undefined; mirrors it once defined, with `setValue` calling `onChange` instead.
+ * Controlled/uncontrolled pattern that behaves like `useState` when `prop` is undefined, mirroring it once defined with `setValue` calling `onChange` instead.
  *
  * @returns `[value, setValue]` tuple like `useState`.
  * @example
@@ -22,6 +21,11 @@ interface UseControllableStateParams<T> {
  *   });
  * }
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
-export declare function useControllableState<T>({ prop, defaultProp, onChange, }: UseControllableStateParams<T>): readonly [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>];
+export declare function useControllableState<T>({ prop, defaultProp, onChange, }: UseControllableStateParams<T>): readonly [
+    T | undefined,
+    React.Dispatch<React.SetStateAction<T | undefined>>
+];
 export {};

package/dist/utils/useControllableState.d.ts

@@ -5,11 +5,10 @@ interface UseControllableStateParams<T> {
     /** Initial value for uncontrolled usage; ignored once `prop` is defined. */
     defaultProp?: T | undefined;
     /** Called with the next value whenever it changes, in both controlled and uncontrolled modes. */
-    onChange?: (state: T) => void;
+    onChange?: ((state: T) => void) | undefined;
 }
 /**
- * Controlled/uncontrolled pattern. Behaves like `useState` when `prop` is
- * undefined; mirrors it once defined, with `setValue` calling `onChange` instead.
+ * Controlled/uncontrolled pattern that behaves like `useState` when `prop` is undefined, mirroring it once defined with `setValue` calling `onChange` instead.
  *
  * @returns `[value, setValue]` tuple like `useState`.
  * @example
@@ -22,6 +21,11 @@ interface UseControllableStateParams<T> {
  *   });
  * }
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
-export declare function useControllableState<T>({ prop, defaultProp, onChange, }: UseControllableStateParams<T>): readonly [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>];
+export declare function useControllableState<T>({ prop, defaultProp, onChange, }: UseControllableStateParams<T>): readonly [
+    T | undefined,
+    React.Dispatch<React.SetStateAction<T | undefined>>
+];
 export {};

package/dist/utils/useControllableState.js

@@ -1 +1,2 @@
-import*as e from"react";import{useCallbackRef as T}from"./useCallbackRef.js";function m({prop:t,defaultProp:l,onChange:f=()=>{}}){let[d,i]=e.useState(l),n=t!==void 0,a=n?t:d,r=T(f),c=e.useRef(a);e.useLayoutEffect(()=>{c.current=a},[a]);let R=e.useCallback(s=>{let u=n?t:c.current,o=typeof s=="function"?s(u):s;o!==u&&(n||(c.current=o,i(o)),r(o))},[n,t,r]);return[a,R]}export{m as useControllableState};
+'use client';
+import*as e from"react";import{controllableValue as d,decideControllable as m}from"./controllable.js";import{useCallbackRef as C}from"./useCallbackRef.js";function v({prop:o,defaultProp:u,onChange:i=()=>{}}){let[f,R]=e.useState(u),t=d({controlled:o,uncontrolled:f}),l=C(i),a=e.useRef(t);e.useLayoutEffect(()=>{a.current=t},[t]);let T=e.useCallback(c=>{let r={controlled:o,uncontrolled:a.current},p=d(r),s=typeof c=="function"?c(p):c,n=m(r,s);n.write&&(a.current=n.value,R(n.value)),n.emit&&l(s)},[o,l]);return[t,T]}export{v as useControllableState};

package/dist/utils/useDismiss.cjs

@@ -1 +1,2 @@
-"use strict";var N=Object.create;var l=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var R=Object.getPrototypeOf,T=Object.prototype.hasOwnProperty;var g=(e,t)=>{for(var s in t)l(e,s,{get:t[s],enumerable:!0})},F=(e,t,s,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of k(t))!T.call(e,r)&&r!==s&&l(e,r,{get:()=>t[r],enumerable:!(a=P(t,r))||a.enumerable});return e};var x=(e,t,s)=>(s=e!=null?N(R(e)):{},F(t||!e||!e.__esModule?l(s,"default",{value:e,enumerable:!0}):s,e)),K=e=>F(l({},"__esModule",{value:!0}),e);var j={};g(j,{useDismiss:()=>C});module.exports=K(j);var h=x(require("react"),1),u=require("./useCallbackRef.cjs"),d=[];function C({enabled:e,onEscapeKeyDown:t,onPointerDownOutside:s,onFocusOutside:a,onInteractOutside:r,insideSelector:m},L){let p=(0,u.useCallbackRef)(t),O=(0,u.useCallbackRef)(s),w=(0,u.useCallbackRef)(a),v=(0,u.useCallbackRef)(r),f=(0,u.useCallbackRef)(n=>{if(L.some(E=>E.current?.contains(n)))return!1;let c=n.nodeType===Node.ELEMENT_NODE?n:n.parentElement;return!(m&&c?.closest(m))});h.useEffect(()=>{if(!e)return;let n=globalThis.document,c={};d.push(c);let E=o=>{o.key==="Escape"&&d[d.length-1]===c&&p(o)},y=o=>{let i=o.target;i&&f(i)&&(v(o),O(o))},b=o=>{let i=o.target;if(!i||i===n.body||!f(i))return;let D=new CustomEvent("focus-outside",{detail:o,cancelable:!0});v(D),w(D)};n.addEventListener("keydown",E);let I=window.setTimeout(()=>{n.addEventListener("pointerdown",y,!0),n.addEventListener("focusin",b,!0)},0);return()=>{let o=d.indexOf(c);o!==-1&&d.splice(o,1),n.removeEventListener("keydown",E),window.clearTimeout(I),n.removeEventListener("pointerdown",y,!0),n.removeEventListener("focusin",b,!0)}},[e,p,O,w,v,f])}0&&(module.exports={useDismiss});
+'use client';
+"use strict";var R=Object.create;var E=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var K=Object.getOwnPropertyNames;var k=Object.getPrototypeOf,x=Object.prototype.hasOwnProperty;var U=(e,n)=>{for(var s in n)E(e,s,{get:n[s],enumerable:!0})},T=(e,n,s,c)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of K(n))!x.call(e,r)&&r!==s&&E(e,r,{get:()=>n[r],enumerable:!(c=g(n,r))||c.enumerable});return e};var j=(e,n,s)=>(s=e!=null?R(k(e)):{},T(n||!e||!e.__esModule?E(s,"default",{value:e,enumerable:!0}):s,e)),A=e=>T(E({},"__esModule",{value:!0}),e);var M={};U(M,{useDismiss:()=>C});module.exports=A(M);var N=j(require("react"),1),i=require("./dismissal.cjs"),d=require("./useCallbackRef.cjs");function C({enabled:e,onEscapeKeyDown:n,onPointerDownOutside:s,onFocusOutside:c,onInteractOutside:r,insideSelector:l},p){let O=(0,d.useCallbackRef)(n),y=n!==void 0,w=(0,d.useCallbackRef)(()=>p),D=(0,d.useCallbackRef)(s),L=(0,d.useCallbackRef)(c),f=(0,d.useCallbackRef)(r),m=(0,d.useCallbackRef)(t=>{if(p.some(v=>v.current?.contains(t)))return!1;let a=t.nodeType===Node.ELEMENT_NODE?t:t.parentElement;return!(l&&a?.closest(l))});N.useEffect(()=>{if(!e)return;let t=globalThis.document,a={insideElements:()=>w().map(o=>o.current)},v=(0,i.pushDismissLayer)(a),h=o=>{(0,i.handleEscapeKeyDown)(o,a,y?O:void 0)},I=o=>{let u=o.target;u&&m(u)&&(f(o),D(o))},F=o=>{let u=(0,i.focusOutsideTarget)(o);if(!u||!m(u))return;let b=(0,i.focusOutsideEvent)(o);f(b),L(b)};t.addEventListener("keydown",h);let P=window.setTimeout(()=>{t.addEventListener("pointerdown",I,!0),t.addEventListener("focusin",F,!0)},0);return()=>{v(),t.removeEventListener("keydown",h),window.clearTimeout(P),t.removeEventListener("pointerdown",I,!0),t.removeEventListener("focusin",F,!0)}},[e,y,O,D,L,f,m,w])}0&&(module.exports={useDismiss});

package/dist/utils/useDismiss.d.cts

@@ -1,38 +1,27 @@
 import * as React from 'react';
-/**
- * What `onFocusOutside` receives. `focusin` is not cancelable, so handler gets
- * cancelable stand-in carrying the original as its `detail`.
- */
-export type FocusOutsideEvent = CustomEvent<FocusEvent>;
-/** Either flavour of outside interaction, as `onInteractOutside` sees it. */
-export type InteractOutsideEvent = PointerEvent | FocusOutsideEvent;
+import { type FocusOutsideEvent, type InteractOutsideEvent } from './dismissal.cjs';
+export type { FocusOutsideEvent, InteractOutsideEvent } from './dismissal.cjs';
 interface UseDismissOptions {
     /** Whether dismiss listeners are active (usually the open state). */
     enabled: boolean;
     /** Called on Escape keydown. */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    onEscapeKeyDown?: ((event: KeyboardEvent) => void) | undefined;
     /** Called on pointerdown outside every element in `insideRefs`. */
-    onPointerDownOutside?: (event: PointerEvent) => void;
+    onPointerDownOutside?: ((event: PointerEvent) => void) | undefined;
     /** Called when focus moves to an element outside every element in `insideRefs`. */
-    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    onFocusOutside?: ((event: FocusOutsideEvent) => void) | undefined;
     /**
      * Called for either kind of outside interaction, immediately before the
      * specific handler above, with the same event object — so a single
      * `preventDefault()` here vetoes the dismissal either way.
      */
-    onInteractOutside?: (event: InteractOutsideEvent) => void;
+    onInteractOutside?: ((event: InteractOutsideEvent) => void) | undefined;
     /**
      * Extra "inside" region, as a selector matched against the target with
      * `closest()` — for elements `insideRefs` can't reach, like a submenu panel
      * portalled out of the menu it belongs to.
      */
-    insideSelector?: string;
+    insideSelector?: string | undefined;
 }
-/**
- * Layer dismissal behavior shared by every dismissible overlay. Consumers pass refs
- * of "inside" elements (input-driven families include input and toggle button, not just panel).
- *
- * Hook only reports; caller decides dismissal meaning by checking `event.defaultPrevented`.
- */
+/** Layer dismissal behavior shared by every dismissible overlay; only reports, since the caller decides dismissal meaning by checking `event.defaultPrevented`. */
 export declare function useDismiss({ enabled, onEscapeKeyDown, onPointerDownOutside, onFocusOutside, onInteractOutside, insideSelector, }: UseDismissOptions, insideRefs: Array<React.RefObject<Element | null>>): void;
-export {};

package/dist/utils/useDismiss.d.ts

@@ -1,38 +1,27 @@
 import * as React from 'react';
-/**
- * What `onFocusOutside` receives. `focusin` is not cancelable, so handler gets
- * cancelable stand-in carrying the original as its `detail`.
- */
-export type FocusOutsideEvent = CustomEvent<FocusEvent>;
-/** Either flavour of outside interaction, as `onInteractOutside` sees it. */
-export type InteractOutsideEvent = PointerEvent | FocusOutsideEvent;
+import { type FocusOutsideEvent, type InteractOutsideEvent } from './dismissal.js';
+export type { FocusOutsideEvent, InteractOutsideEvent } from './dismissal.js';
 interface UseDismissOptions {
     /** Whether dismiss listeners are active (usually the open state). */
     enabled: boolean;
     /** Called on Escape keydown. */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    onEscapeKeyDown?: ((event: KeyboardEvent) => void) | undefined;
     /** Called on pointerdown outside every element in `insideRefs`. */
-    onPointerDownOutside?: (event: PointerEvent) => void;
+    onPointerDownOutside?: ((event: PointerEvent) => void) | undefined;
     /** Called when focus moves to an element outside every element in `insideRefs`. */
-    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    onFocusOutside?: ((event: FocusOutsideEvent) => void) | undefined;
     /**
      * Called for either kind of outside interaction, immediately before the
      * specific handler above, with the same event object — so a single
      * `preventDefault()` here vetoes the dismissal either way.
      */
-    onInteractOutside?: (event: InteractOutsideEvent) => void;
+    onInteractOutside?: ((event: InteractOutsideEvent) => void) | undefined;
     /**
      * Extra "inside" region, as a selector matched against the target with
      * `closest()` — for elements `insideRefs` can't reach, like a submenu panel
      * portalled out of the menu it belongs to.
      */
-    insideSelector?: string;
+    insideSelector?: string | undefined;
 }
-/**
- * Layer dismissal behavior shared by every dismissible overlay. Consumers pass refs
- * of "inside" elements (input-driven families include input and toggle button, not just panel).
- *
- * Hook only reports; caller decides dismissal meaning by checking `event.defaultPrevented`.
- */
+/** Layer dismissal behavior shared by every dismissible overlay; only reports, since the caller decides dismissal meaning by checking `event.defaultPrevented`. */
 export declare function useDismiss({ enabled, onEscapeKeyDown, onPointerDownOutside, onFocusOutside, onInteractOutside, insideSelector, }: UseDismissOptions, insideRefs: Array<React.RefObject<Element | null>>): void;
-export {};