@soybeanjs/headless 0.30.0 → 0.40.0-beta.2

package/dist/shared/guard.d.ts

@@ -5,47 +5,46 @@
  * @param value
  * @returns
  */
-declare function isString(value: unknown): value is string;
+export declare function isString(value: unknown): value is string;
 /**
  * Type guard: check if value is a primitive type
  *
  * @param value - The value to check
  * @returns Whether the value is string | number | boolean
  */
-declare function isPrimitive(value: unknown): value is string | number | boolean | null | undefined;
+export declare function isPrimitive(value: unknown): value is string | number | boolean | null | undefined;
 /**
  * Type guard: check if value is a non-null object (excluding arrays)
  *
  * @param value - The value to check
  * @returns Whether the value is a non-null object
  */
-declare function isNonNullObject(value: unknown): value is Record<string, unknown>;
+export declare function isNonNullObject(value: unknown): value is Record<string, unknown>;
 /**
  * Type guard: check if value is an array
  *
  * @param value - The value to check
  * @returns Whether the value is an array
  */
-declare function isArrayValue(value: unknown): value is unknown[];
+export declare function isArrayValue(value: unknown): value is unknown[];
 /**
  * Type guard: check if value is null or undefined
  *
  * @param value - The value to check
  * @returns Whether the value is null or undefined
  */
-declare function isNullish(value: unknown): value is null | undefined;
+export declare function isNullish(value: unknown): value is null | undefined;
 /**
  * Type guard: check if value is an empty string
  *
  * @param value - The value to check
  * @returns Whether the value is an empty string
  */
-declare function isBlankString(value: unknown | undefined): value is string;
-declare function isDateObject(value: unknown): value is Date;
-declare function isObjectType(value: unknown): value is object | null;
-declare function isFunction(value: unknown): value is (...args: any[]) => any;
-declare function isObject(value: unknown): boolean;
-declare function isPromise(value: any): value is PromiseLike<any>;
-declare function keysOf<TRecord extends Record<string, unknown>>(record: TRecord): (keyof TRecord)[];
-//#endregion
-export { isArrayValue, isBlankString, isDateObject, isFunction, isNonNullObject, isNullish, isObject, isObjectType, isPrimitive, isPromise, isString, keysOf };
+export declare function isBlankString(value: unknown | undefined): value is string;
+export declare function isDateObject(value: unknown): value is Date;
+export declare function isObjectType(value: unknown): value is object | null;
+export declare function isFunction(value: unknown): value is (...args: any[]) => any;
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+export declare function isPromise(value: any): value is PromiseLike<any>;
+export declare function keysOf<TRecord extends object>(record: TRecord): (keyof TRecord)[];
+//#endregion

package/dist/shared/index.d.ts

@@ -1,16 +1,20 @@
 import { isArrayValue, isBlankString, isDateObject, isFunction, isNonNullObject, isNullish, isObject, isObjectType, isPrimitive, isPromise, isString, keysOf } from "./guard.js";
-import { appendAt, arrayRemove, chunk, compact, findValuesBetween, flattenChildren, getNextMatch, insertAt, moveAt, omit, pick, prependAt, removeAt, swapAt, updateAt, wrapArray } from "./object.js";
-import { interpolate, isKey, stringToPath } from "./string.js";
+import { appendAt, arrayRemove, chunk, compact, defu, findValuesBetween, flattenChildren, getNextMatch, insertAt, isEqual, klona, moveAt, omit, pick, prependAt, removeAt, swapAt, updateAt, wrapArray } from "./object.js";
+import { camelCase, capitalize, interpolate, isKey, kebabCase, pascalCase, snakeCase, stringToPath } from "./string.js";
+import { arrayMove, filterNullish } from "./array.js";
 import { isValueEqualOrExist } from "./comparison.js";
 import { areColorsEqual, formatChannelValue, formatColor, getAreaBackgroundStyle, getChannelName, getChannelObjectSpace, getChannelRange, getChannelValue, getColorContrast, getColorLabel, getSliderBackgroundStyle, hasVisibleChromaticity, isValidColor, normalizeColor, resolveColorFormat, setChannelValue, setChannelValues, toColorObject } from "./color.js";
 import { clamp, getBinaryCheckedState, getCheckedState, getDisclosureState, getOpenFromSingleOrMultiple, getValue, isIndeterminate, roundToStepPrecision, setValue, snapValueToStep } from "./value.js";
 import { createFieldName, parseArrayValue, parseFormValue, parseObjectValue, parsePrimitiveValue } from "./form.js";
 import { getActiveElement, getAriaLabel, getCollectionItemElements, isElementHasAttribute, isHTMLElement, removeLinks } from "./dom.js";
 import { focus, focusFirstAndSelect, getDirectionAwareKey, getFocusIntent, getTabbableCandidates, getTabbableEdges, removeFromTabOrder, tryFocusFirst } from "./focus.js";
-import { getElFromTemplateRef, getLifeCycleTarget, getMergedRefsValue, getRawChildren, getVueBooleanCasting, isFormControl, transformPropsToContext } from "./vue.js";
-import { isBrowser, isClient, isIOS, refreshIOSDetection } from "./env.js";
+import { FuzzyOptions, FuzzyResult, fuzzySearch } from "./fuzzy.js";
+import { MarkOthersOptions, markOthers } from "./mark-others.js";
+import { fromContext, getElFromTemplateRef, getLifeCycleTarget, getMergedRefsValue, getRawChildren, getVueBooleanCasting, isFormControl, toContext } from "./vue.js";
+import { isBrowser, isClient, isIOS, refreshIOSDetection, supportsInert } from "./env.js";
 import { handleAndDispatchCustomEvent, isMouseEvent } from "./event.js";
 import { getExitSideFromRect, getHull, getPaddedExitPoints, getPointsFromRect, isDeltaInDirection, isPointInPolygon, isPointerInGraceArea } from "./geometry.js";
 import { getTreePaths } from "./tree.js";
+import { TreeNavigationKey, TreeNavigationNode, TreeNavigationResult, getTreeNavigationKey, resolveTreeNavigation } from "./tree-navigation.js";
 import { CreateTimeOptionsProps, FormatTimeValueProps, TimePickerOption, compareTimeValues, createTimeOptions, findClosestTimeOption, formatTimeValue, isTimeBetweenInclusive } from "./time-picker.js";
-export { CreateTimeOptionsProps, FormatTimeValueProps, TimePickerOption, appendAt, areColorsEqual, arrayRemove, chunk, clamp, compact, compareTimeValues, createFieldName, createTimeOptions, findClosestTimeOption, findValuesBetween, flattenChildren, focus, focusFirstAndSelect, formatChannelValue, formatColor, formatTimeValue, getActiveElement, getAreaBackgroundStyle, getAriaLabel, getBinaryCheckedState, getChannelName, getChannelObjectSpace, getChannelRange, getChannelValue, getCheckedState, getCollectionItemElements, getColorContrast, getColorLabel, getDirectionAwareKey, getDisclosureState, getElFromTemplateRef, getExitSideFromRect, getFocusIntent, getHull, getLifeCycleTarget, getMergedRefsValue, getNextMatch, getOpenFromSingleOrMultiple, getPaddedExitPoints, getPointsFromRect, getRawChildren, getSliderBackgroundStyle, getTabbableCandidates, getTabbableEdges, getTreePaths, getValue, getVueBooleanCasting, handleAndDispatchCustomEvent, hasVisibleChromaticity, insertAt, interpolate, isArrayValue, isBlankString, isBrowser, isClient, isDateObject, isDeltaInDirection, isElementHasAttribute, isFormControl, isFunction, isHTMLElement, isIOS, isIndeterminate, isKey, isMouseEvent, isNonNullObject, isNullish, isObject, isObjectType, isPointInPolygon, isPointerInGraceArea, isPrimitive, isPromise, isString, isTimeBetweenInclusive, isValidColor, isValueEqualOrExist, keysOf, moveAt, normalizeColor, omit, parseArrayValue, parseFormValue, parseObjectValue, parsePrimitiveValue, pick, prependAt, refreshIOSDetection, removeAt, removeFromTabOrder, removeLinks, resolveColorFormat, roundToStepPrecision, setChannelValue, setChannelValues, setValue, snapValueToStep, stringToPath, swapAt, toColorObject, transformPropsToContext, tryFocusFirst, updateAt, wrapArray };
+export { CreateTimeOptionsProps, FormatTimeValueProps, FuzzyOptions, FuzzyResult, MarkOthersOptions, TimePickerOption, TreeNavigationKey, TreeNavigationNode, TreeNavigationResult, appendAt, areColorsEqual, arrayMove, arrayRemove, camelCase, capitalize, chunk, clamp, compact, compareTimeValues, createFieldName, createTimeOptions, defu, filterNullish, findClosestTimeOption, findValuesBetween, flattenChildren, focus, focusFirstAndSelect, formatChannelValue, formatColor, formatTimeValue, fromContext, fuzzySearch, getActiveElement, getAreaBackgroundStyle, getAriaLabel, getBinaryCheckedState, getChannelName, getChannelObjectSpace, getChannelRange, getChannelValue, getCheckedState, getCollectionItemElements, getColorContrast, getColorLabel, getDirectionAwareKey, getDisclosureState, getElFromTemplateRef, getExitSideFromRect, getFocusIntent, getHull, getLifeCycleTarget, getMergedRefsValue, getNextMatch, getOpenFromSingleOrMultiple, getPaddedExitPoints, getPointsFromRect, getRawChildren, getSliderBackgroundStyle, getTabbableCandidates, getTabbableEdges, getTreeNavigationKey, getTreePaths, getValue, getVueBooleanCasting, handleAndDispatchCustomEvent, hasVisibleChromaticity, insertAt, interpolate, isArrayValue, isBlankString, isBrowser, isClient, isDateObject, isDeltaInDirection, isElementHasAttribute, isEqual, isFormControl, isFunction, isHTMLElement, isIOS, isIndeterminate, isKey, isMouseEvent, isNonNullObject, isNullish, isObject, isObjectType, isPointInPolygon, isPointerInGraceArea, isPrimitive, isPromise, isString, isTimeBetweenInclusive, isValidColor, isValueEqualOrExist, kebabCase, keysOf, klona, markOthers, moveAt, normalizeColor, omit, parseArrayValue, parseFormValue, parseObjectValue, parsePrimitiveValue, pascalCase, pick, prependAt, refreshIOSDetection, removeAt, removeFromTabOrder, removeLinks, resolveColorFormat, resolveTreeNavigation, roundToStepPrecision, setChannelValue, setChannelValues, setValue, snakeCase, snapValueToStep, stringToPath, supportsInert, swapAt, toColorObject, toContext, tryFocusFirst, updateAt, wrapArray };

package/dist/shared/index.js

@@ -1 +1 @@
-import{isArrayValue as e,isBlankString as t,isDateObject as n,isFunction as r,isNonNullObject as i,isNullish as a,isObject as o,isObjectType as s,isPrimitive as c,isPromise as l,isString as u,keysOf as d}from"./guard.js";import{appendAt as f,arrayRemove as p,chunk as m,compact as h,findValuesBetween as g,flattenChildren as _,getNextMatch as v,insertAt as y,moveAt as b,omit as x,pick as S,prependAt as C,removeAt as w,swapAt as T,updateAt as E,wrapArray as D}from"./object.js";import{interpolate as O,isKey as k,stringToPath as A}from"./string.js";import{isValueEqualOrExist as j}from"./comparison.js";import{areColorsEqual as M,formatChannelValue as N,formatColor as P,getAreaBackgroundStyle as F,getChannelName as I,getChannelObjectSpace as L,getChannelRange as R,getChannelValue as z,getColorContrast as B,getColorLabel as V,getSliderBackgroundStyle as H,hasVisibleChromaticity as U,isValidColor as W,normalizeColor as G,resolveColorFormat as K,setChannelValue as q,setChannelValues as J,toColorObject as Y}from"./color.js";import{clamp as X,getBinaryCheckedState as Z,getCheckedState as Q,getDisclosureState as $,getOpenFromSingleOrMultiple as ee,getValue as te,isIndeterminate as ne,roundToStepPrecision as re,setValue as ie,snapValueToStep as ae}from"./value.js";import{createFieldName as oe,parseArrayValue as se,parseFormValue as ce,parseObjectValue as le,parsePrimitiveValue as ue}from"./form.js";import{getActiveElement as de,getAriaLabel as fe,getCollectionItemElements as pe,isElementHasAttribute as me,isHTMLElement as he,removeLinks as ge}from"./dom.js";import{focus as _e,focusFirstAndSelect as ve,getDirectionAwareKey as ye,getFocusIntent as be,getTabbableCandidates as xe,getTabbableEdges as Se,removeFromTabOrder as Ce,tryFocusFirst as we}from"./focus.js";import{getElFromTemplateRef as Te,getLifeCycleTarget as Ee,getMergedRefsValue as De,getRawChildren as Oe,getVueBooleanCasting as ke,isFormControl as Ae,transformPropsToContext as je}from"./vue.js";import{isBrowser as Me,isClient as Ne,isIOS as Pe,refreshIOSDetection as Fe}from"./env.js";import{handleAndDispatchCustomEvent as Ie,isMouseEvent as Le}from"./event.js";import{getExitSideFromRect as Re,getHull as ze,getPaddedExitPoints as Be,getPointsFromRect as Ve,isDeltaInDirection as He,isPointInPolygon as Ue,isPointerInGraceArea as We}from"./geometry.js";import{getTreePaths as Ge}from"./tree.js";import{compareTimeValues as Ke,createTimeOptions as qe,findClosestTimeOption as Je,formatTimeValue as Ye,isTimeBetweenInclusive as Xe}from"./time-picker.js";export{f as appendAt,M as areColorsEqual,p as arrayRemove,m as chunk,X as clamp,h as compact,Ke as compareTimeValues,oe as createFieldName,qe as createTimeOptions,Je as findClosestTimeOption,g as findValuesBetween,_ as flattenChildren,_e as focus,ve as focusFirstAndSelect,N as formatChannelValue,P as formatColor,Ye as formatTimeValue,de as getActiveElement,F as getAreaBackgroundStyle,fe as getAriaLabel,Z as getBinaryCheckedState,I as getChannelName,L as getChannelObjectSpace,R as getChannelRange,z as getChannelValue,Q as getCheckedState,pe as getCollectionItemElements,B as getColorContrast,V as getColorLabel,ye as getDirectionAwareKey,$ as getDisclosureState,Te as getElFromTemplateRef,Re as getExitSideFromRect,be as getFocusIntent,ze as getHull,Ee as getLifeCycleTarget,De as getMergedRefsValue,v as getNextMatch,ee as getOpenFromSingleOrMultiple,Be as getPaddedExitPoints,Ve as getPointsFromRect,Oe as getRawChildren,H as getSliderBackgroundStyle,xe as getTabbableCandidates,Se as getTabbableEdges,Ge as getTreePaths,te as getValue,ke as getVueBooleanCasting,Ie as handleAndDispatchCustomEvent,U as hasVisibleChromaticity,y as insertAt,O as interpolate,e as isArrayValue,t as isBlankString,Me as isBrowser,Ne as isClient,n as isDateObject,He as isDeltaInDirection,me as isElementHasAttribute,Ae as isFormControl,r as isFunction,he as isHTMLElement,Pe as isIOS,ne as isIndeterminate,k as isKey,Le as isMouseEvent,i as isNonNullObject,a as isNullish,o as isObject,s as isObjectType,Ue as isPointInPolygon,We as isPointerInGraceArea,c as isPrimitive,l as isPromise,u as isString,Xe as isTimeBetweenInclusive,W as isValidColor,j as isValueEqualOrExist,d as keysOf,b as moveAt,G as normalizeColor,x as omit,se as parseArrayValue,ce as parseFormValue,le as parseObjectValue,ue as parsePrimitiveValue,S as pick,C as prependAt,Fe as refreshIOSDetection,w as removeAt,Ce as removeFromTabOrder,ge as removeLinks,K as resolveColorFormat,re as roundToStepPrecision,q as setChannelValue,J as setChannelValues,ie as setValue,ae as snapValueToStep,A as stringToPath,T as swapAt,Y as toColorObject,je as transformPropsToContext,we as tryFocusFirst,E as updateAt,D as wrapArray};
+import{isArrayValue as e,isBlankString as t,isDateObject as n,isFunction as r,isNonNullObject as i,isNullish as a,isObject as o,isObjectType as s,isPrimitive as c,isPromise as l,isString as u,keysOf as d}from"./guard.js";import{appendAt as f,arrayRemove as p,chunk as m,compact as h,defu as g,findValuesBetween as _,flattenChildren as v,getNextMatch as y,insertAt as b,isEqual as x,klona as S,moveAt as C,omit as w,pick as T,prependAt as E,removeAt as D,swapAt as O,updateAt as k,wrapArray as A}from"./object.js";import{camelCase as j,capitalize as M,interpolate as N,isKey as P,kebabCase as F,pascalCase as I,snakeCase as L,stringToPath as R}from"./string.js";import{arrayMove as z,filterNullish as B}from"./array.js";import{isValueEqualOrExist as V}from"./comparison.js";import{areColorsEqual as H,formatChannelValue as U,formatColor as W,getAreaBackgroundStyle as G,getChannelName as K,getChannelObjectSpace as q,getChannelRange as J,getChannelValue as Y,getColorContrast as X,getColorLabel as Z,getSliderBackgroundStyle as Q,hasVisibleChromaticity as $,isValidColor as ee,normalizeColor as te,resolveColorFormat as ne,setChannelValue as re,setChannelValues as ie,toColorObject as ae}from"./color.js";import{clamp as oe,getBinaryCheckedState as se,getCheckedState as ce,getDisclosureState as le,getOpenFromSingleOrMultiple as ue,getValue as de,isIndeterminate as fe,roundToStepPrecision as pe,setValue as me,snapValueToStep as he}from"./value.js";import{createFieldName as ge,parseArrayValue as _e,parseFormValue as ve,parseObjectValue as ye,parsePrimitiveValue as be}from"./form.js";import{getActiveElement as xe,getAriaLabel as Se,getCollectionItemElements as Ce,isElementHasAttribute as we,isHTMLElement as Te,removeLinks as Ee}from"./dom.js";import{focus as De,focusFirstAndSelect as Oe,getDirectionAwareKey as ke,getFocusIntent as Ae,getTabbableCandidates as je,getTabbableEdges as Me,removeFromTabOrder as Ne,tryFocusFirst as Pe}from"./focus.js";import{fuzzySearch as Fe}from"./fuzzy.js";import{isBrowser as Ie,isClient as Le,isIOS as Re,refreshIOSDetection as ze,supportsInert as Be}from"./env.js";import{markOthers as Ve}from"./mark-others.js";import{fromContext as He,getElFromTemplateRef as Ue,getLifeCycleTarget as We,getMergedRefsValue as Ge,getRawChildren as Ke,getVueBooleanCasting as qe,isFormControl as Je,toContext as Ye}from"./vue.js";import{handleAndDispatchCustomEvent as Xe,isMouseEvent as Ze}from"./event.js";import{getExitSideFromRect as Qe,getHull as $e,getPaddedExitPoints as et,getPointsFromRect as tt,isDeltaInDirection as nt,isPointInPolygon as rt,isPointerInGraceArea as it}from"./geometry.js";import{getTreePaths as at}from"./tree.js";import{getTreeNavigationKey as ot,resolveTreeNavigation as st}from"./tree-navigation.js";import{compareTimeValues as ct,createTimeOptions as lt,findClosestTimeOption as ut,formatTimeValue as dt,isTimeBetweenInclusive as ft}from"./time-picker.js";export{f as appendAt,H as areColorsEqual,z as arrayMove,p as arrayRemove,j as camelCase,M as capitalize,m as chunk,oe as clamp,h as compact,ct as compareTimeValues,ge as createFieldName,lt as createTimeOptions,g as defu,B as filterNullish,ut as findClosestTimeOption,_ as findValuesBetween,v as flattenChildren,De as focus,Oe as focusFirstAndSelect,U as formatChannelValue,W as formatColor,dt as formatTimeValue,He as fromContext,Fe as fuzzySearch,xe as getActiveElement,G as getAreaBackgroundStyle,Se as getAriaLabel,se as getBinaryCheckedState,K as getChannelName,q as getChannelObjectSpace,J as getChannelRange,Y as getChannelValue,ce as getCheckedState,Ce as getCollectionItemElements,X as getColorContrast,Z as getColorLabel,ke as getDirectionAwareKey,le as getDisclosureState,Ue as getElFromTemplateRef,Qe as getExitSideFromRect,Ae as getFocusIntent,$e as getHull,We as getLifeCycleTarget,Ge as getMergedRefsValue,y as getNextMatch,ue as getOpenFromSingleOrMultiple,et as getPaddedExitPoints,tt as getPointsFromRect,Ke as getRawChildren,Q as getSliderBackgroundStyle,je as getTabbableCandidates,Me as getTabbableEdges,ot as getTreeNavigationKey,at as getTreePaths,de as getValue,qe as getVueBooleanCasting,Xe as handleAndDispatchCustomEvent,$ as hasVisibleChromaticity,b as insertAt,N as interpolate,e as isArrayValue,t as isBlankString,Ie as isBrowser,Le as isClient,n as isDateObject,nt as isDeltaInDirection,we as isElementHasAttribute,x as isEqual,Je as isFormControl,r as isFunction,Te as isHTMLElement,Re as isIOS,fe as isIndeterminate,P as isKey,Ze as isMouseEvent,i as isNonNullObject,a as isNullish,o as isObject,s as isObjectType,rt as isPointInPolygon,it as isPointerInGraceArea,c as isPrimitive,l as isPromise,u as isString,ft as isTimeBetweenInclusive,ee as isValidColor,V as isValueEqualOrExist,F as kebabCase,d as keysOf,S as klona,Ve as markOthers,C as moveAt,te as normalizeColor,w as omit,_e as parseArrayValue,ve as parseFormValue,ye as parseObjectValue,be as parsePrimitiveValue,I as pascalCase,T as pick,E as prependAt,ze as refreshIOSDetection,D as removeAt,Ne as removeFromTabOrder,Ee as removeLinks,ne as resolveColorFormat,st as resolveTreeNavigation,pe as roundToStepPrecision,re as setChannelValue,ie as setChannelValues,me as setValue,L as snakeCase,he as snapValueToStep,R as stringToPath,Be as supportsInert,O as swapAt,ae as toColorObject,Ye as toContext,Pe as tryFocusFirst,k as updateAt,A as wrapArray};

package/dist/shared/mark-others.d.ts

@@ -0,0 +1,52 @@
+//#region src/shared/mark-others.d.ts
+/**
+ * Hides everything outside the given elements from assistive technology while a floating
+ * layer is open — the Base UI `markOthers` scheme (the core algorithm inlined and reworked
+ * from the `aria-hidden` package), kept dependency-free here so overlay families never need
+ * the third-party `aria-hidden` package.
+ *
+ * Mechanics:
+ * - Walks from `body` and applies a control attribute (`inert`, else `aria-hidden="true"`)
+ *   to every element outside the keep set (the avoid elements and their ancestor chain).
+ * - Reference counts via WeakMaps plus a global `lockCount`, so stacked / nested layers
+ *   each hold a lock and attributes are only removed when the last lock releases.
+ * - Attributes that already existed before the first lock are recorded as uncontrolled and
+ *   preserved on release.
+ * - `aria-live` regions stay announced: they and their subtrees are excluded from hiding.
+ * - Shadow hosts are corrected through their shadow root; `<script>` elements are skipped.
+ * - The independent `mark` channel tags outside elements with `data-soybean-inert` for CSS
+ *   hooks (dimmed background, disabled text selection) without touching the control
+ *   attribute semantics.
+ */
+type Undo = () => void;
+export interface MarkOthersOptions {
+  /**
+   * Apply `aria-hidden="true"` to elements outside the keep set.
+   *
+   * @defaultValue false
+   */
+  ariaHidden?: boolean;
+  /**
+   * Apply `inert` to elements outside the keep set. Takes precedence over `ariaHidden`
+   * when both are set: `inert` removes content from the accessibility tree and the tab
+   * order at once, so modal layers prefer it where the runtime supports it.
+   *
+   * @defaultValue false
+   */
+  inert?: boolean;
+  /**
+   * Tag outside elements with `data-soybean-inert` (the marker channel).
+   *
+   * @defaultValue true
+   */
+  mark?: boolean;
+}
+/**
+ * Marks every element outside `avoidElements` per `options` and returns the undo function.
+ * Call the undo exactly once per `markOthers` call (usually in a cleanup hook).
+ *
+ * @param avoidElements - Elements (and their ancestor chains) that stay visible and announced.
+ * @param options - Which channels to apply: `inert`, `ariaHidden`, and/or the `mark` tag.
+ */
+export declare function markOthers(avoidElements: Element[], options?: MarkOthersOptions): Undo;
+//#endregion

package/dist/shared/mark-others.js

@@ -0,0 +1 @@
+import{INERT_MARKER_ATTR as e}from"../constants/attr.js";import{isClient as t}from"./env.js";const n={inert:new WeakMap,"aria-hidden":new WeakMap},r={inert:new WeakSet,"aria-hidden":new WeakSet};let i=new WeakMap,a=0;function o(e){return typeof ShadowRoot<`u`&&e instanceof ShadowRoot}function s(e){return(e.nodeName??``).toLowerCase()}function c(e){return e?o(e)?e.host:c(e.parentNode):null}function l(e,t){return t.map(t=>{if(e.contains(t))return t;let n=c(t);return e.contains(n)?n:null}).filter(e=>e!==null)}function u(e){let t=new Set;for(let n of e){let e=n;for(;e&&!t.has(e);)t.add(e),e=e.parentNode}return t}function d(e,t){let n=[];return(e=>{if(e)for(let r of Array.from(e.children))s(r)!==`script`&&(t.has(r)||n.push(r))})(e),n}function f(e,t,i){let a=n[t],o=r[t],s=[],c=l(e,Array.from(e.querySelectorAll(`[aria-live]`))),f=[...i,...c];for(let n of d(e,u(f))){let e=n.getAttribute(t),r=e!==null&&e!==`false`,i=(a.get(n)??0)+1;a.set(n,i),s.push(n),i===1&&r&&o.add(n),r||n.setAttribute(t,t===`inert`?``:`true`)}return{hiddenElements:s,uncontrolledElementsSet:o}}function p(t,n){let r=[];for(let a of d(t,u(n))){let t=(i.get(a)??0)+1;i.set(a,t),r.push(a),t===1&&a.setAttribute(e,``)}return r}function m(t,o,s,c){return()=>{if(t){let e=n[t];for(let n of o){let r=(e.get(n)??0)-1;e.set(n,r),r===0&&(s&&!s.has(n)&&n.removeAttribute(t),s?.delete(n))}}for(let t of c){let n=(i.get(t)??0)-1;i.set(t,n),n===0&&t.removeAttribute(e)}--a,a===0&&(n.inert=new WeakMap,n[`aria-hidden`]=new WeakMap,r.inert=new WeakSet,r[`aria-hidden`]=new WeakSet,i=new WeakMap)}}function h(e,n={}){let{ariaHidden:r=!1,inert:i=!1,mark:o=!0}=n;if(!t||e.length===0)return()=>{};let s=e[0].ownerDocument.body,c=l(s,e),u=i?`inert`:r?`aria-hidden`:null;a+=1;let d=[],h=null;if(u){let e=f(s,u,c);d=e.hiddenElements,h=e.uncontrolledElementsSet}let g=o?p(s,c):[];return m(u,d,h,g)}export{h as markOthers};

package/dist/shared/object.d.ts

@@ -1,4 +1,25 @@
 //#region src/shared/object.d.ts
+/**
+ * Structured deep comparison (covers the common `ohash isEqual` semantics: objects / arrays / Date / NaN).
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns Whether the two values are structurally equal
+ */
+export declare function isEqual(a: unknown, b: unknown): boolean;
+type UnionToIntersection<U> = (U extends unknown ? (arg: U) => void : never) extends ((arg: infer I) => void) ? I : never;
+/**
+ * Recursive defaults merge: `defu({ a: 1 }, { a: 2, b: 3 })` → `{ a: 1, b: 3 }`.
+ * Left side wins; plain objects merge recursively, arrays and other types are taken from the left side.
+ */
+export declare function defu<T extends object, D extends object[]>(source: T | undefined, ...defaults: D): UnionToIntersection<T | D[number]>;
+/**
+ * Structured deep clone (JSON-cloneable values + Date), replacing `klona`.
+ *
+ * @param value - The value to clone
+ * @returns A deep clone of the value
+ */
+export declare function klona<T>(value: T): T;
 /**
  * Select specified properties from an object
  *
@@ -6,7 +27,7 @@
  * @param keys - Array of property keys to select
  * @returns New object containing specified properties
  */
-declare function pick<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+export declare function pick<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
 /**
  * Exclude specified properties from an object
  *
@@ -14,8 +35,8 @@ declare function pick<T extends Record<string, any>, K extends keyof T>(obj: T,
  * @param keys - Array of property keys to exclude
  * @returns New object with specified properties excluded
  */
-declare function omit<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
-declare function compact<T>(value: T[]): T[];
+export declare function omit<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+export declare function compact<T>(value: T[]): T[];
 /**
  * Remove specified element from an array
  *
@@ -23,19 +44,19 @@ declare function compact<T>(value: T[]): T[];
  * @param item - Element to remove
  * @returns New array with element removed
  */
-declare function arrayRemove<T>(array: T[], item: T): T[];
+export declare function arrayRemove<T>(array: T[], item: T): T[];
 /**
  * Wraps an array around itself at a given start index Example: `wrapArray(['a', 'b', 'c', 'd'], 2) === ['c', 'd', 'a',
  * 'b']`
  */
-declare function wrapArray<T>(array: T[], startIndex: number): T[];
-declare function appendAt<T>(data: T[], value: T): T[];
-declare function prependAt<T>(data: T[], value: T): T[];
-declare function removeAt<T>(data: T[], index?: number): T[];
-declare function swapAt<T>(data: T[], indexA: number, indexB: number): void;
-declare function moveAt<T>(data: T[], from: number, to: number): void;
-declare function insertAt<T>(data: T[], index: number, value: T): T[];
-declare function updateAt<T>(data: T[], index: number, value: T): T[];
+export declare function wrapArray<T>(array: T[], startIndex: number): T[];
+export declare function appendAt<T>(data: T[], value: T): T[];
+export declare function prependAt<T>(data: T[], value: T): T[];
+export declare function removeAt<T>(data: T[], index?: number): T[];
+export declare function swapAt<T>(data: T[], indexA: number, indexB: number): void;
+export declare function moveAt<T>(data: T[], from: number, to: number): void;
+export declare function insertAt<T>(data: T[], index: number, value: T): T[];
+export declare function updateAt<T>(data: T[], index: number, value: T): T[];
 /**
  * This is the "meat" of the typeahead matching logic. It takes in all the values, the search and the current match, and
  * returns the next match (or `undefined`).
@@ -50,7 +71,7 @@ declare function updateAt<T>(data: T[], index: number, value: T): T[];
  * otherwise it would be the first to match always and focus would never move. This is as opposed to the regular case,
  * where we don't want focus to move if the current match still matches.
  */
-declare function getNextMatch(values?: string[], search?: string, currentMatch?: string): string | undefined;
+export declare function getNextMatch(values?: string[], search?: string, currentMatch?: string): string | undefined;
 /**
  * The function `findValuesBetween` takes an array and two values, then returns a subarray containing elements between
  * the first occurrence of the start value and the first occurrence of the end value in the array.
@@ -65,10 +86,9 @@ declare function getNextMatch(values?: string[], search?: string, currentMatch?:
  *   `start` and `end` values (inclusive). If either the `start` or `end` values are not found in the input array, an
  *   empty array is returned.
  */
-declare function findValuesBetween<T>(array: T[], start: T, end: T): T[];
-declare function flattenChildren<T extends {
+export declare function findValuesBetween<T>(array: T[], start: T, end: T): T[];
+export declare function flattenChildren<T extends {
   children?: any[];
 }>(items?: T[]): Omit<T, "children">[];
-declare function chunk<T>(array: T[], size: number): T[][];
-//#endregion
-export { appendAt, arrayRemove, chunk, compact, findValuesBetween, flattenChildren, getNextMatch, insertAt, moveAt, omit, pick, prependAt, removeAt, swapAt, updateAt, wrapArray };
+export declare function chunk<T>(array: T[], size: number): T[][];
+//#endregion

package/dist/shared/object.js

@@ -1 +1 @@
-import{isEqual as e}from"ohash";function t(e,t){let n={};for(let r of t)n[r]=e[r];return n}function n(e,t){let n={};for(let r in e){let i=r;t.includes(i)||(n[i]=e[i])}return n}function r(e){return Array.isArray(e)?e.filter(Boolean):[]}function i(e,t){let n=[...e],r=n.indexOf(t);return r!==-1&&n.splice(r,1),n}function a(e,t){if(e.length===0)return[];let n=(t%e.length+e.length)%e.length;return e.map((t,r)=>e[(n+r)%e.length])}function o(e,t){return[...e,t]}function s(e,t){return[t,...e]}function c(e,t){if(t===void 0)return[];let n=[...e];return n.splice(t,1),n}function l(e,t,n){let r=e[t];e[t]=e[n],e[n]=r}function u(e,t,n){let[r]=e.splice(t,1);e.splice(n,0,r)}function d(e,t,n){return[...e.slice(0,t),n,...e.slice(t)]}function f(e,t,n){let r=[...e];return r[t]=n,r}function p(e,t,n){if(!e?.length||!t)return;let r=t.length>1&&t[0]?.repeat(t.length)===t?t[0]:t,i=r.toLowerCase(),a=r.length===1,o=n?e.indexOf(n):-1,s=Math.max(o,0),c=e.length;for(let t=0;t<c;t++){let r=e[(s+t)%c];if((!a||r!==n)&&r?.toLowerCase().startsWith(i))return r===n?void 0:r}}function m(t,n,r){let i=t.findIndex(t=>e(t,n)),a=t.findIndex(t=>e(t,r));if(i===-1||a===-1)return[];let[o,s]=[i,a].sort((e,t)=>e-t);return t.slice(o,s+1)}function h(e){return e?e.reduce((e,t)=>(e.push(t),t.children&&e.push(...h(t.children)),e),[]):[]}function g(e,t){if(t<=0)throw RangeError(`chunk size must be greater than 0`);let n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n}export{o as appendAt,i as arrayRemove,g as chunk,r as compact,m as findValuesBetween,h as flattenChildren,p as getNextMatch,d as insertAt,u as moveAt,n as omit,t as pick,s as prependAt,c as removeAt,l as swapAt,f as updateAt,a as wrapArray};
+import{isObject as e}from"./guard.js";function t(n,r){if(n===r)return!0;if(typeof n==`number`&&typeof r==`number`)return Number.isNaN(n)&&Number.isNaN(r);if(n instanceof Date&&r instanceof Date)return n.getTime()===r.getTime();if(Array.isArray(n)&&Array.isArray(r))return n.length===r.length&&n.every((e,n)=>t(e,r[n]));if(e(n)&&e(r)){let e=Object.keys(n),i=Object.keys(r);return e.length===i.length&&e.every(e=>e in r&&t(n[e],r[e]))}return!1}function n(t,...r){let i={};for(let a of[t,...r])if(e(a))for(let t of Object.keys(a)){let r=a[t],o=i[t];o===void 0?i[t]=r:e(o)&&e(r)&&(i[t]=n(o,r))}return i}function r(t){if(t instanceof Date)return new Date(t.getTime());if(Array.isArray(t))return t.map(e=>r(e));if(e(t)){let e={};for(let n of Object.keys(t))e[n]=r(t[n]);return e}return t}function i(e,t){let n={};for(let r of t)n[r]=e[r];return n}function a(e,t){let n={};for(let r in e){let i=r;t.includes(i)||(n[i]=e[i])}return n}function o(e){return Array.isArray(e)?e.filter(Boolean):[]}function s(e,t){let n=[...e],r=n.indexOf(t);return r!==-1&&n.splice(r,1),n}function c(e,t){if(e.length===0)return[];let n=(t%e.length+e.length)%e.length;return e.map((t,r)=>e[(n+r)%e.length])}function l(e,t){return[...e,t]}function u(e,t){return[t,...e]}function d(e,t){if(t===void 0)return[];let n=[...e];return n.splice(t,1),n}function f(e,t,n){let r=e[t];e[t]=e[n],e[n]=r}function p(e,t,n){let[r]=e.splice(t,1);e.splice(n,0,r)}function m(e,t,n){return[...e.slice(0,t),n,...e.slice(t)]}function h(e,t,n){let r=[...e];return r[t]=n,r}function g(e,t,n){if(!e?.length||!t)return;let r=t.length>1&&t[0]?.repeat(t.length)===t?t[0]:t,i=r.toLowerCase(),a=r.length===1,o=n?e.indexOf(n):-1,s=Math.max(o,0),c=e.length;for(let t=0;t<c;t++){let r=e[(s+t)%c];if((!a||r!==n)&&r?.toLowerCase().startsWith(i))return r===n?void 0:r}}function _(e,n,r){let i=e.findIndex(e=>t(e,n)),a=e.findIndex(e=>t(e,r));if(i===-1||a===-1)return[];let[o,s]=[i,a].sort((e,t)=>e-t);return e.slice(o,s+1)}function v(e){return e?e.reduce((e,t)=>(e.push(t),t.children&&e.push(...v(t.children)),e),[]):[]}function y(e,t){if(t<=0)throw RangeError(`chunk size must be greater than 0`);let n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n}export{l as appendAt,s as arrayRemove,y as chunk,o as compact,n as defu,_ as findValuesBetween,v as flattenChildren,g as getNextMatch,m as insertAt,t as isEqual,r as klona,p as moveAt,a as omit,i as pick,u as prependAt,d as removeAt,f as swapAt,h as updateAt,c as wrapArray};

package/dist/shared/string.d.ts

@@ -1,22 +1,34 @@
 //#region src/shared/string.d.ts
+export declare function capitalize(str: string): string;
+/** 'helloWorld' | 'hello_world' | 'Hello World' | 'SButton' → 'hello-world' | 's-button' */
+export declare function kebabCase(str: string): string;
+/**
+ * 'hello-world' | 'hello_world' | 'hello world' | 'SButton' | 'HTTPRequest' → 'HelloWorld' | 'SButton' | 'HTTPRequest'
+ *
+ * Splits on both separators and camel-case boundaries so already-cased names
+ * (e.g. 'SButton', 'AccordionRoot') keep their inner capitals.
+ */
+export declare function pascalCase(str: string): string;
+/** 'hello-world' | 'hello_world' | 'Hello World' → 'helloWorld' */
+export declare function camelCase(str: string): string;
+export declare function snakeCase(str: string): string;
 /**
  * Convert string to path
  *
  * @param str - The string to convert
  * @returns Path
  */
-declare function stringToPath(str: string): string[];
+export declare function stringToPath(str: string): string[];
 /**
  * Check if string is a key
  *
  * @param str - The string to check
  * @returns Whether the string is a key
  */
-declare function isKey(str: string): boolean;
+export declare function isKey(str: string): boolean;
 /**
  * Replace `{key}` placeholders in a template string with values from `params`.
  * Unknown keys are left as-is.
  */
-declare function interpolate(template: string, params: Record<string, string>): string;
-//#endregion
-export { interpolate, isKey, stringToPath };
+export declare function interpolate(template: string, params: Record<string, string>): string;
+//#endregion

package/dist/shared/string.js

@@ -1 +1 @@
-import{compact as e}from"./object.js";function t(t){return e(t.replace(/["|']|\]/g,``).split(/\.|\[/))}function n(e){return/^\w*$/.test(e)}function r(e,t){return e.replace(/\{(\w+)\}/g,(e,n)=>t[n]??e)}export{r as interpolate,n as isKey,t as stringToPath};
+import{compact as e}from"./object.js";function t(e){return e&&e.charAt(0).toUpperCase()+e.slice(1)}function n(e){return e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).replace(/([A-Z]+)([A-Z][a-z])/g,`$1-$2`).replace(/[\s_]+/g,`-`).replace(/-+/g,`-`).replace(/^-|-$/g,``).toLowerCase()}function r(e){return(e.match(/[A-Z]{2,}(?=[A-Z][a-z]+|\b)|[A-Z]?[a-z]+|[A-Z]|\d+/g)??[]).map(e=>t(e)).join(``)}function i(e){let t=r(e);return t.charAt(0).toLowerCase()+t.slice(1)}function a(e){return n(e).replace(/-/g,`_`)}function o(t){return e(t.replace(/["|']|\]/g,``).split(/\.|\[/))}function s(e){return/^\w*$/.test(e)}function c(e,t){return e.replace(/\{(\w+)\}/g,(e,n)=>t[n]??e)}export{i as camelCase,t as capitalize,c as interpolate,s as isKey,n as kebabCase,r as pascalCase,a as snakeCase,o as stringToPath};

package/dist/shared/time-picker.d.ts

@@ -2,29 +2,28 @@ import { DateStep, HourCycle, TimeGranularity, TimeMatcher, TimeValue } from "..
 import { Formatter } from "../date/formatter.js";
 import "../date/index.js";
 //#region src/shared/time-picker.d.ts
-interface TimePickerOption {
+export interface TimePickerOption {
   value: TimeValue;
   label: string;
   key: string;
 }
-interface FormatTimeValueProps {
+export interface FormatTimeValueProps {
   formatter: Formatter;
   granularity: TimeGranularity;
   hideTimeZone?: boolean;
   hourCycle?: HourCycle;
   value: TimeValue;
 }
-interface CreateTimeOptionsProps extends Omit<FormatTimeValueProps, 'value'> {
+export interface CreateTimeOptionsProps extends Omit<FormatTimeValueProps, 'value'> {
   isTimeUnavailable?: TimeMatcher;
   maxValue?: TimeValue;
   minValue?: TimeValue;
   reference: TimeValue;
   step?: DateStep;
 }
-declare function compareTimeValues(a: TimeValue, b: TimeValue): number;
-declare function isTimeBetweenInclusive(date: TimeValue, start: TimeValue, end: TimeValue): boolean;
-declare function formatTimeValue(props: FormatTimeValueProps): string;
-declare function createTimeOptions(props: CreateTimeOptionsProps): TimePickerOption[];
-declare function findClosestTimeOption(options: TimePickerOption[], value: TimeValue | undefined): TimePickerOption;
-//#endregion
-export { CreateTimeOptionsProps, FormatTimeValueProps, TimePickerOption, compareTimeValues, createTimeOptions, findClosestTimeOption, formatTimeValue, isTimeBetweenInclusive };
+export declare function compareTimeValues(a: TimeValue, b: TimeValue): number;
+export declare function isTimeBetweenInclusive(date: TimeValue, start: TimeValue, end: TimeValue): boolean;
+export declare function formatTimeValue(props: FormatTimeValueProps): string;
+export declare function createTimeOptions(props: CreateTimeOptionsProps): TimePickerOption[];
+export declare function findClosestTimeOption(options: TimePickerOption[], value: TimeValue | undefined): TimePickerOption;
+//#endregion

package/dist/shared/time-picker.js

@@ -1 +1 @@
-import{isAfter as e,isAfterOrSame as t,isBefore as n,isBeforeOrSame as r,isEqualValue as i,isTime as a,isZonedDateTime as o}from"../date/comparators.js";import{getOptsByGranularity as s}from"../date/utils.js";import"../date/index.js";function c(t,r){return n(t,r)?-1:+!!e(t,r)}function l(e,n,i){return t(e,n)&&r(e,i)}function u(e){return e.formatter.toParts(e.value,s(e.granularity,e.hourCycle,!0)).filter(t=>t.type!==`timeZoneName`||!e.hideTimeZone&&!a(e.value)&&o(e.value)).map(e=>e.value).join(``)}function d(t){let r=p(t.granularity,t.step),i=Math.ceil(86400/r);return Array.from({length:i},(e,n)=>{let i=n*r,a=Math.floor(i/3600)%24,o=Math.floor(i%3600/60),s=i%60,c=t.reference.set({hour:a,minute:o,second:s,millisecond:0});return{value:c,label:u({formatter:t.formatter,granularity:t.granularity,hideTimeZone:t.hideTimeZone,hourCycle:t.hourCycle,value:c}),key:c.toString()}}).filter(r=>!(t.minValue&&n(r.value,t.minValue)||t.maxValue&&e(r.value,t.maxValue)||t.isTimeUnavailable?.(r.value)))}function f(e,t){return t?e.find(e=>i(e.value,t))??e[0]:e[0]}function p(e,t){let n=(t?.hour??0)*3600+(t?.minute??0)*60+(t?.second??0);return n>0?n:e===`hour`?3600:e===`second`?30:1800}export{c as compareTimeValues,d as createTimeOptions,f as findClosestTimeOption,u as formatTimeValue,l as isTimeBetweenInclusive};
+import{isAfter as e,isAfterOrSame as t,isBefore as n,isBeforeOrSame as r,isEqualValue as i,isTime as a,isZonedDateTime as o}from"../date/comparators.js";import{getOptsByGranularity as s}from"../date/utils.js";function c(t,r){return n(t,r)?-1:+!!e(t,r)}function l(e,n,i){return t(e,n)&&r(e,i)}function u(e){return e.formatter.toParts(e.value,s(e.granularity,e.hourCycle,!0)).filter(t=>t.type!==`timeZoneName`||!e.hideTimeZone&&!a(e.value)&&o(e.value)).map(e=>e.value).join(``)}function d(t){let r=p(t.granularity,t.step),i=Math.ceil(86400/r);return Array.from({length:i},(e,n)=>{let i=n*r,a=Math.floor(i/3600)%24,o=Math.floor(i%3600/60),s=i%60,c=t.reference.set({hour:a,minute:o,second:s,millisecond:0});return{value:c,label:u({formatter:t.formatter,granularity:t.granularity,hideTimeZone:t.hideTimeZone,hourCycle:t.hourCycle,value:c}),key:c.toString()}}).filter(r=>!(t.minValue&&n(r.value,t.minValue)||t.maxValue&&e(r.value,t.maxValue)||t.isTimeUnavailable?.(r.value)))}function f(e,t){return t?e.find(e=>i(e.value,t))??e[0]:e[0]}function p(e,t){let n=(t?.hour??0)*3600+(t?.minute??0)*60+(t?.second??0);return n>0?n:e===`hour`?3600:e===`second`?30:1800}export{c as compareTimeValues,d as createTimeOptions,f as findClosestTimeOption,u as formatTimeValue,l as isTimeBetweenInclusive};

package/dist/shared/tree-navigation.d.ts

@@ -0,0 +1,59 @@
+import { Direction } from "../types/common.js";
+import "../types/index.js";
+//#region src/shared/tree-navigation.d.ts
+/**
+ * A single visible node of a tree flattened for keyboard navigation.
+ *
+ * Only nodes that are currently rendered (every ancestor branch expanded) take
+ * part in navigation, aligned with the WAI-ARIA tree pattern.
+ */
+export interface TreeNavigationNode {
+  /** Unique value of the node. */
+  value: string;
+  /** Depth of the node inside the visible tree (0 = root level). */
+  level: number;
+  /** Whether the node renders children. */
+  hasChildren: boolean;
+  /** Whether the node's children are currently expanded. */
+  expanded: boolean;
+  /** Whether the node cannot receive focus. */
+  disabled?: boolean;
+}
+/**
+ * Logical navigation keys of a tree.
+ *
+ * `left`/`right` are the physical keys; RTL mapping happens inside
+ * `resolveTreeNavigation` so callers can forward the raw event key.
+ */
+export type TreeNavigationKey = 'up' | 'down' | 'left' | 'right' | 'home' | 'end';
+/**
+ * Result of resolving a tree navigation key.
+ *
+ * - `targetValue`: move focus to the node carrying this value.
+ * - `toggleExpand`: expand or collapse the current node instead of moving focus.
+ */
+export interface TreeNavigationResult {
+  targetValue?: string;
+  toggleExpand?: boolean;
+}
+/**
+ * Extract the logical tree navigation key from a keyboard event.
+ *
+ * Returns `null` for every non-navigation key so callers can bail out early.
+ */
+export declare function getTreeNavigationKey(event: KeyboardEvent): TreeNavigationKey | null;
+/**
+ * Resolve a tree navigation key against the flattened visible tree.
+ *
+ * Rules follow the WAI-ARIA APG tree pattern:
+ *
+ * - `up`/`down`: move to the previous/next visible node, skipping disabled
+ *   nodes, without wrapping around.
+ * - `right` (or `left` in RTL): closed branches expand (focus stays); expanded
+ *   branches move focus to their first focusable child; leaves are no-ops.
+ * - `left` (or `right` in RTL): expanded branches collapse; leaves and closed
+ *   branches move focus to the parent; root-level nodes are no-ops.
+ * - `home`/`end`: move to the first/last focusable visible node.
+ */
+export declare function resolveTreeNavigation(nodes: TreeNavigationNode[], currentValue: string, key: TreeNavigationKey, dir?: Direction): TreeNavigationResult | null;
+//#endregion

package/dist/shared/tree-navigation.js

@@ -0,0 +1 @@
+const e={ArrowUp:`up`,ArrowDown:`down`,ArrowLeft:`left`,ArrowRight:`right`,Home:`home`,End:`end`};function t(t){return e[t.key]??null}function n(e,t,n){for(let r=t;r>=0&&r<e.length;r+=n){let t=e[r];if(!t.disabled)return t.value}}function r(e,t){let n=e[t];for(let r=t+1;r<e.length;r+=1){let t=e[r];if(t.level<=n.level)return;if(t.level===n.level+1&&!t.disabled)return t.value}}function i(e,t){let n=e[t];for(let r=t-1;r>=0;--r){let t=e[r];if(t.level<n.level-1)return;if(t.level===n.level-1)return t.disabled?void 0:t.value}}function a(e,t,a,o=`ltr`){let s=e.findIndex(e=>e.value===t);if(s===-1)return null;let c=e[s];switch(a){case`up`:{let t=n(e,s-1,-1);return t?{targetValue:t}:null}case`down`:{let t=n(e,s+1,1);return t?{targetValue:t}:null}case`home`:{let t=n(e,0,1);return t?{targetValue:t}:null}case`end`:{let t=n(e,e.length-1,-1);return t?{targetValue:t}:null}default:{if(o===`rtl`?a===`left`:a===`right`){if(!c.hasChildren)return null;if(!c.expanded)return{toggleExpand:!0};let t=r(e,s);return t?{targetValue:t}:null}if(c.hasChildren&&c.expanded)return{toggleExpand:!0};let t=i(e,s);return t?{targetValue:t}:null}}}export{t as getTreeNavigationKey,a as resolveTreeNavigation};

package/dist/shared/tree.d.ts

@@ -7,6 +7,5 @@ interface BaseTree<T extends DefinedValue = DefinedValue> {
 type Tree<T extends DefinedValue = DefinedValue, S extends BaseTree<T> = BaseTree<T>> = BaseTree<T> & {
   children?: S[];
 };
-declare function getTreePaths<T extends DefinedValue = DefinedValue, S extends BaseTree<T> = BaseTree<T>>(targetValue: T, items: Tree<T, S>[]): T[];
-//#endregion
-export { getTreePaths };
+export declare function getTreePaths<T extends DefinedValue = DefinedValue, S extends BaseTree<T> = BaseTree<T>>(targetValue: T, items: Tree<T, S>[]): T[];
+//#endregion

package/dist/shared/value.d.ts

@@ -1,9 +1,9 @@
 import { CheckedState, DefinedValue, MaybeArray } from "../types/common.js";
 import "../types/index.js";
 //#region src/shared/value.d.ts
-declare function isIndeterminate(checked?: CheckedState | null): checked is 'indeterminate';
-declare function getCheckedState(checked?: CheckedState | null): "checked" | "unchecked" | "indeterminate";
-declare function getBinaryCheckedState(checked?: CheckedState | null): "checked" | "unchecked";
+export declare function isIndeterminate(checked?: CheckedState | null): checked is 'indeterminate';
+export declare function getCheckedState(checked?: CheckedState | null): "checked" | "unchecked" | "indeterminate";
+export declare function getBinaryCheckedState(checked?: CheckedState | null): "checked" | "unchecked";
 /**
  * Check if value is enabled based on single or multiple selection mode
  *
@@ -12,14 +12,14 @@ declare function getBinaryCheckedState(checked?: CheckedState | null): "checked"
  * @param isSingle - Whether it's single selection mode
  * @returns Whether it's enabled
  */
-declare function getOpenFromSingleOrMultiple(value: DefinedValue, modelValue: MaybeArray<DefinedValue> | undefined, isMultiple: boolean): boolean;
+export declare function getOpenFromSingleOrMultiple(value: DefinedValue, modelValue: MaybeArray<DefinedValue> | undefined, isMultiple: boolean): boolean;
 /**
  * Return corresponding string based on open state
  *
  * @param open - Whether it's open
  * @returns 'open' or 'closed'
  */
-declare function getDisclosureState(open?: boolean): "open" | "closed";
+export declare function getDisclosureState(open?: boolean): "open" | "closed";
 /**
  * The `clamp` function restricts a number within a specified range by returning the value itself if it falls within the
  * range, or the closest boundary value if it exceeds the range.
@@ -31,7 +31,7 @@ declare function getDisclosureState(open?: boolean): "open" | "closed";
  * @param {number} max - If the `value` parameter is greater than the `max` value, the function will return `max`.
  * @returns The `clamp` function returns the value of `value` constrained within the range defined by `min` and `max`.
  */
-declare function clamp(value: number, min?: number, max?: number): number;
+export declare function clamp(value: number, min?: number, max?: number): number;
 /**
  * The function `roundToStepPrecision` rounds a number to a specified precision step.
  *
@@ -41,7 +41,7 @@ declare function clamp(value: number, min?: number, max?: number): number;
  *   you want to round the `value`. For example, if `step` is 0.5, the `value` will be rounded to the nearest half.
  * @returns the `roundedValue` after rounding it to the precision specified by the `step`.
  */
-declare function roundToStepPrecision(value: number, step: number): number;
+export declare function roundToStepPrecision(value: number, step: number): number;
 /**
  * The function `snapValueToStep` snaps a given value to the nearest step within a specified range.
  *
@@ -57,8 +57,7 @@ declare function roundToStepPrecision(value: number, step: number): number;
  * @returns a number that has been snapped to the nearest step value within the specified range of minimum and maximum
  *   values.
  */
-declare function snapValueToStep(value: number, min: number | undefined, max: number | undefined, step: number): number;
-declare function setValue(obj: Record<string, any>, path: string, value?: any): Record<string, any>;
-declare function getValue<T>(obj: T, path: string, defaultValue?: unknown): any;
-//#endregion
-export { clamp, getBinaryCheckedState, getCheckedState, getDisclosureState, getOpenFromSingleOrMultiple, getValue, isIndeterminate, roundToStepPrecision, setValue, snapValueToStep };
+export declare function snapValueToStep(value: number, min: number | undefined, max: number | undefined, step: number): number;
+export declare function setValue(obj: Record<string, any>, path: string, value?: any): Record<string, any>;
+export declare function getValue<T>(obj: T, path: string, defaultValue?: unknown): any;
+//#endregion

package/dist/shared/vue.d.ts

@@ -1,14 +1,27 @@
-import { PropsToContext, VNodeRef } from "../types/vue.js";
+import { ToContext, VNodeRef } from "../types/vue.js";
 import "../types/index.js";
 import { MaybeRefOrGetter, VNode } from "vue";
 //#region src/shared/vue.d.ts
-declare function getLifeCycleTarget(target?: any): any;
-declare function getRawChildren(children: VNode[]): VNode[];
-declare function getElFromTemplateRef<T extends HTMLElement>(nodeRef: VNodeRef): T | undefined;
-declare function transformPropsToContext<T extends Record<string, any>, K extends keyof T = keyof T>(props: T, keys?: K[]): PropsToContext<T, K>;
-declare function isFormControl(el?: HTMLElement | null): boolean;
+export declare function getLifeCycleTarget(target?: any): any;
+export declare function getRawChildren(children: VNode[]): VNode[];
+export declare function getElFromTemplateRef<T extends HTMLElement>(nodeRef: VNodeRef): T | undefined;
+/**
+ * Builds a reactive context value map (`ComputedRef` per key) from a source object.
+ *
+ * `source` accepts anything `toValue` understands — a reactive object such as `props`, a
+ * ref / computed of an object, or a getter returning one. Values are taken as-is, so a
+ * function-valued key stays a function in the context. Keys default to every own key of
+ * the resolved source.
+ */
+export declare function toContext<T extends object, K extends keyof T = keyof T>(source: MaybeRefOrGetter<T>, keys?: K[]): ToContext<T, K>;
+/**
+ * Snapshots a `toContext`-built context back into plain values (all own keys by default).
+ * A nullish context yields an empty object, whose missing keys behave like `undefined`
+ * ones in `defu` resolution chains.
+ */
+export declare function fromContext<T extends object, K extends keyof T = keyof T>(context: ToContext<T, K> | null | undefined, keys?: K[]): Partial<T>;
+export declare function isFormControl(el?: HTMLElement | null): boolean;
 type RefToValue<T extends MaybeRefOrGetter> = T extends MaybeRefOrGetter<infer V> ? V : never;
-declare const getMergedRefsValue: <T extends Record<string, MaybeRefOrGetter>>(refs: T) => { [K in keyof T]: RefToValue<T[K]>; };
-declare const getVueBooleanCasting: (value?: boolean | "") => boolean;
-//#endregion
-export { getElFromTemplateRef, getLifeCycleTarget, getMergedRefsValue, getRawChildren, getVueBooleanCasting, isFormControl, transformPropsToContext };
+export declare const getMergedRefsValue: <T extends Record<string, MaybeRefOrGetter>>(refs: T) => { [K in keyof T]: RefToValue<T[K]>; };
+export declare const getVueBooleanCasting: (value?: boolean | "") => boolean;
+//#endregion

package/dist/shared/vue.js

@@ -1 +1 @@
-import{Comment as e,Fragment as t,computed as n,getCurrentInstance as r,toValue as i}from"vue";const a={KEYED_FRAGMENT:128,BAIL:-2};function o(e){return e||r()}function s(n){let r=[],i=0;for(let o=0;o<n.length;o++){let c=n[o];c.type===t?((c.patchFlag??0)===a.KEYED_FRAGMENT&&i++,r=r.concat(s(c.children))):c.type!==e&&r.push(c)}if(i>1)for(let e=0;e<r.length;e++)r[e].patchFlag=a.BAIL;return r}function c(e){let t=e?.$el??e;return t&&t.nodeType!==1&&(t=void 0),t}function l(e,t){return(t??Object.keys(e)).reduce((t,r)=>(t[r]=n(()=>typeof e[r]==`function`?e[r]():e[r]),t),{})}function u(e){return!e||`classList`in e&&e.classList.contains(`form`)}const d=e=>{let t={};for(let n in e)t[n]=i(e[n]);return t},f=e=>!!e||e===``;export{c as getElFromTemplateRef,o as getLifeCycleTarget,d as getMergedRefsValue,s as getRawChildren,f as getVueBooleanCasting,u as isFormControl,l as transformPropsToContext};
+import{Comment as e,Fragment as t,computed as n,getCurrentInstance as r,toValue as i}from"vue";const a={KEYED_FRAGMENT:128,BAIL:-2};function o(e){return e||r()}function s(n){let r=[],i=0;for(let o=0;o<n.length;o++){let c=n[o];c.type===t?((c.patchFlag??0)===a.KEYED_FRAGMENT&&i++,r=r.concat(s(c.children))):c.type!==e&&r.push(c)}if(i>1)for(let e=0;e<r.length;e++)r[e].patchFlag=a.BAIL;return r}function c(e){let t=e?.$el??e;return t&&t.nodeType!==1&&(t=void 0),t}function l(e,t){return(t??Object.keys(i(e))).reduce((t,r)=>(t[r]=n(()=>i(e)[r]),t),{})}function u(e,t){return e?(t??Object.keys(e)).reduce((t,n)=>(t[n]=e[n].value,t),{}):{}}function d(e){return!e||`classList`in e&&e.classList.contains(`form`)}const f=e=>{let t={};for(let n in e)t[n]=i(e[n]);return t},p=e=>!!e||e===``;export{u as fromContext,c as getElFromTemplateRef,o as getLifeCycleTarget,f as getMergedRefsValue,s as getRawChildren,p as getVueBooleanCasting,d as isFormControl,l as toContext};

package/dist/types/color.d.ts

@@ -1,15 +1,14 @@
 import { AnyColor, HslColor, HsvColor, OklchColor, RgbColor } from "@soybeanjs/colord";
 //#region src/types/color.d.ts
-type ColorValue = AnyColor;
-type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'oklch';
-type ColorSpace = 'hsl' | 'hsv' | 'oklch';
-type ColorObjectSpace = 'rgb' | ColorSpace;
-type ColorChannel = 'hue' | 'saturation' | 'lightness' | 'brightness' | 'red' | 'green' | 'blue' | 'alpha' | 'chroma';
-interface ColorChannelRange {
+export type ColorValue = AnyColor;
+export type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'oklch';
+export type ColorSpace = 'hsl' | 'hsv' | 'oklch';
+export type ColorObjectSpace = 'rgb' | ColorSpace;
+export type ColorChannel = 'hue' | 'saturation' | 'lightness' | 'brightness' | 'red' | 'green' | 'blue' | 'alpha' | 'chroma';
+export interface ColorChannelRange {
   min: number;
   max: number;
   step: number;
 }
-type NormalizedColor = RgbColor | HslColor | HsvColor | OklchColor;
-//#endregion
-export { ColorChannel, ColorChannelRange, ColorFormat, ColorObjectSpace, ColorSpace, ColorValue, NormalizedColor };
+export type NormalizedColor = RgbColor | HslColor | HsvColor | OklchColor;
+//#endregion