@vuetify/v0 0.0.18 → 0.0.20

package/dist/constants/index.mjs

@@ -1,5 +1,5 @@
 import { n as SELF_CLOSING_TAGS, r as isSelfClosingTag, t as COMMON_ELEMENTS } from "../htmlElements-CXObxj0V.mjs";
-import { a as SUPPORTS_OBSERVER, c as version, i as SUPPORTS_MUTATION_OBSERVER, n as SUPPORTS_INTERSECTION_OBSERVER, o as SUPPORTS_TOUCH, r as SUPPORTS_MATCH_MEDIA, s as __LOGGER_ENABLED__, t as IN_BROWSER } from "../globals-BGVqrlN7.mjs";
+import { a as SUPPORTS_OBSERVER, c as version, i as SUPPORTS_MUTATION_OBSERVER, n as SUPPORTS_INTERSECTION_OBSERVER, o as SUPPORTS_TOUCH, r as SUPPORTS_MATCH_MEDIA, s as __LOGGER_ENABLED__, t as IN_BROWSER } from "../globals-exvZ8fiO.mjs";
 import "../constants-DypzAkYp.mjs";
 
 export { COMMON_ELEMENTS, IN_BROWSER, SELF_CLOSING_TAGS, SUPPORTS_INTERSECTION_OBSERVER, SUPPORTS_MATCH_MEDIA, SUPPORTS_MUTATION_OBSERVER, SUPPORTS_OBSERVER, SUPPORTS_TOUCH, __LOGGER_ENABLED__, isSelfClosingTag, version };

package/dist/{globals-BGVqrlN7.mjs → globals-exvZ8fiO.mjs}

@@ -5,7 +5,7 @@ const SUPPORTS_MATCH_MEDIA = IN_BROWSER && "matchMedia" in window && typeof wind
 const SUPPORTS_OBSERVER = IN_BROWSER && "ResizeObserver" in window;
 const SUPPORTS_INTERSECTION_OBSERVER = IN_BROWSER && "IntersectionObserver" in window;
 const SUPPORTS_MUTATION_OBSERVER = IN_BROWSER && "MutationObserver" in window;
-const version = "0.0.18";
+const version = "0.0.20";
 const __LOGGER_ENABLED__ = process.env.NODE_ENV !== "production" || process.env.VITE_LOGGER_ENABLED === "true";
 
 //#endregion

package/dist/index-4jSy8KIt.d.mts

@@ -0,0 +1,73 @@
+import { h } from "vue";
+
+//#region src/types/index.d.ts
+
+/**
+ * Valid element types for Vue's `h()` render function
+ *
+ * @remarks
+ * Includes HTML tag names, component definitions, and functional components.
+ * Used by the `Atom` component for polymorphic rendering.
+ */
+type DOMElement = Parameters<typeof h>[0];
+/**
+ * Generic object with string keys and any values
+ *
+ * @remarks
+ * Use sparingly - prefer `UnknownObject` for better type safety.
+ */
+type GenericObject = Record<string, any>;
+/**
+ * Object with string keys and unknown values
+ *
+ * @remarks
+ * Safer alternative to `GenericObject` that requires type narrowing.
+ */
+type UnknownObject = Record<string, unknown>;
+/**
+ * Identifier type used throughout the registry system
+ *
+ * @remarks
+ * All tickets, items, and registrable entities use this type for their `id` property.
+ *
+ * @example
+ * ```ts
+ * const id: ID = 'item-1'     // string
+ * const id: ID = 42           // number
+ * ```
+ */
+type ID = string | number;
+/**
+ * Recursively makes all properties of T optional
+ *
+ * @template T The object type to make deeply partial
+ *
+ * @remarks
+ * Used by `mergeDeep` to type partial source objects.
+ *
+ * @example
+ * ```ts
+ * type User = { name: string; address: { city: string } }
+ * type PartialUser = DeepPartial<User>
+ * // { name?: string; address?: { city?: string } }
+ * ```
+ */
+type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]> } : T;
+/**
+ * Union type that accepts either a single value or an array
+ *
+ * @template T The base type
+ *
+ * @remarks
+ * Used for APIs that accept both single items and arrays.
+ *
+ * @example
+ * ```ts
+ * function process(input: MaybeArray<string>) { ... }
+ * process('single')        // OK
+ * process(['a', 'b', 'c']) // OK
+ * ```
+ */
+type MaybeArray<T> = T | T[];
+//#endregion
+export { MaybeArray as a, ID as i, DeepPartial as n, UnknownObject as o, GenericObject as r, DOMElement as t };

package/dist/{index-CH7DpIK8.d.mts → index-BYyEPh1S.d.mts}

@@ -1,5 +1,5 @@
-import { a as MaybeArray, i as ID } from "./index-C5LQZd3v.mjs";
-import { H as ContextTrinity, I as RegistryContext, L as RegistryContextOptions, M as SelectionTicket, R as RegistryOptions, S as GroupContext, T as GroupTicket, c as SingleContext, d as SingleTicket, k as SelectionContext, u as SingleOptions, z as RegistryTicket } from "./index-DaX9-kmY.mjs";
+import { a as MaybeArray, i as ID } from "./index-4jSy8KIt.mjs";
+import { B as RegistryTicket, I as RegistryContext, L as RegistryContextOptions, M as SelectionTicket, S as GroupContext, T as GroupTicket, U as ContextTrinity, c as SingleContext, d as SingleTicket, k as SelectionContext, u as SingleOptions, z as RegistryOptions } from "./index-Gr6XPRWt.mjs";
 import { App, ComputedRef, InjectionKey, MaybeRef, MaybeRefOrGetter, Ref, ShallowRef, UnwrapNestedRefs, WatchSource } from "vue";
 
 //#region src/composables/createContext/index.d.ts
@@ -325,6 +325,115 @@ declare function createBreakpointsPlugin<E extends BreakpointsContext = Breakpoi
  */
 declare function useBreakpoints<E extends BreakpointsContext = BreakpointsContext>(namespace?: string): E;
 //#endregion
+//#region src/composables/useClickOutside/index.d.ts
+type ClickOutsideElement = HTMLElement | null | undefined;
+type ClickOutsideTarget = MaybeRefOrGetter<ClickOutsideElement>;
+type ClickOutsideIgnoreTarget = ClickOutsideTarget | string;
+interface UseClickOutsideOptions {
+  /**
+   * Use capture phase for event listeners.
+   * Ensures detection works even when inner elements call stopPropagation.
+   * @default true
+   */
+  capture?: boolean;
+  /**
+   * Touch movement threshold in pixels.
+   * If finger moves more than this distance, it's treated as a scroll, not a tap.
+   * Only applies to touch interactions.
+   * @default 30
+   */
+  touchScrollThreshold?: number;
+  /**
+   * Detect focus moving to iframes as an outside click.
+   * Useful when iframes are outside the target elements.
+   * @default false
+   */
+  detectIframe?: boolean;
+  /**
+   * Elements to ignore when detecting outside clicks.
+   * Accepts element refs, getters, or CSS selector strings.
+   * Clicks on these elements (or their descendants) won't trigger the handler.
+   *
+   * Note: CSS selectors cannot match across Shadow DOM boundaries due to
+   * browser limitations. Use element refs instead when ignoring shadow hosts.
+   */
+  ignore?: MaybeRefOrGetter<ClickOutsideIgnoreTarget[]>;
+}
+interface UseClickOutsideReturn {
+  /**
+   * Whether the listener is currently active
+   */
+  readonly isActive: Readonly<Ref<boolean>>;
+  /**
+   * Whether the listener is currently paused
+   */
+  readonly isPaused: Readonly<Ref<boolean>>;
+  /**
+   * Pause listening (stops detection but keeps state)
+   */
+  pause: () => void;
+  /**
+   * Resume listening
+   */
+  resume: () => void;
+  /**
+   * Stop listening and clean up
+   */
+  stop: () => void;
+}
+/**
+ * Detects clicks outside of the specified element(s).
+ *
+ * Uses two-phase detection (pointerdown → pointerup) to prevent false positives
+ * when users drag from inside to outside an element.
+ *
+ * @param target Element ref(s) to detect clicks outside of. Accepts a single ref/getter or array of refs/getters.
+ * @param handler Callback invoked when a click outside is detected.
+ * @param options Configuration options.
+ * @returns An object with methods to control the listener.
+ *
+ * @see https://0.vuetifyjs.com/composables/system/use-click-outside
+ *
+ * @example Native element ref
+ * ```ts
+ * const menuRef = useTemplateRef<HTMLElement>('menu')
+ *
+ * useClickOutside(menuRef, () => { isOpen.value = false })
+ * ```
+ *
+ * @example Component ref (e.g., Atom)
+ * ```ts
+ * const atomRef = useTemplateRef<AtomExpose>('atom')
+ *
+ * // Pass the exposed element TemplateRef via getter
+ * useClickOutside(
+ *   () => atomRef.value?.element,
+ *   () => { isOpen.value = false }
+ * )
+ * ```
+ *
+ * @example Multiple targets
+ * ```ts
+ * const popoverRef = useTemplateRef<AtomExpose>('popover')
+ * const anchorRef = useTemplateRef<HTMLElement>('anchor')
+ *
+ * useClickOutside(
+ *   [() => popoverRef.value?.element, anchorRef],
+ *   () => { isOpen.value = false }
+ * )
+ * ```
+ *
+ * @example Ignoring elements (CSS selectors or refs)
+ * ```ts
+ * useClickOutside(
+ *  () => navRef.value?.element,
+ *  () => { isOpen.value = false },
+ *  { ignore: ['[data-app-bar]'] }
+ * )
+ * ```
+ */
+declare function useClickOutside(target: MaybeArray<ClickOutsideTarget>, handler: (event: PointerEvent | FocusEvent) => void, options?: UseClickOutsideOptions): UseClickOutsideReturn;
+//#endregion
 //#region src/composables/useEventListener/index.d.ts
 type CleanupFunction = () => void;
 type EventHandler<E = Event> = (event: E) => void;
@@ -340,7 +449,7 @@ type EventHandler<E = Event> = (event: E) => void;
  *
  * @see https://0.vuetifyjs.com/composables/system/use-event-listener
  */
-declare function useEventListener<E extends keyof WindowEventMap>(target: Window, event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: Window, event: WindowEventMap[E]) => any>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
+declare function useEventListener<E extends keyof WindowEventMap>(target: Window, event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: Window, event: WindowEventMap[E]) => void>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
 /**
  * Attaches an event listener to the document.
  *
@@ -353,7 +462,7 @@ declare function useEventListener<E extends keyof WindowEventMap>(target: Window
  *
  * @see https://0.vuetifyjs.com/composables/system/use-event-listener
  */
-declare function useEventListener<E extends keyof DocumentEventMap>(target: Document, event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: Document, event: DocumentEventMap[E]) => any>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
+declare function useEventListener<E extends keyof DocumentEventMap>(target: Document, event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: Document, event: DocumentEventMap[E]) => void>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
 /**
  * Attaches an event listener to an HTML element.
  *
@@ -366,7 +475,7 @@ declare function useEventListener<E extends keyof DocumentEventMap>(target: Docu
  *
  * @see https://0.vuetifyjs.com/composables/system/use-event-listener
  */
-declare function useEventListener<E extends keyof HTMLElementEventMap>(target: MaybeRefOrGetter<HTMLElement | null | undefined>, event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: HTMLElement, event: HTMLElementEventMap[E]) => any>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
+declare function useEventListener<E extends keyof HTMLElementEventMap>(target: MaybeRefOrGetter<HTMLElement | null | undefined>, event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: HTMLElement, event: HTMLElementEventMap[E]) => void>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
 /**
  * Attaches an event listener to an event target.
  *
@@ -391,7 +500,7 @@ declare function useEventListener<EventType = Event>(target: MaybeRefOrGetter<Ev
  *
  * @see https://0.vuetifyjs.com/composables/system/use-event-listener
  */
-declare function useWindowEventListener<E extends keyof WindowEventMap>(event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: Window, event: WindowEventMap[E]) => any>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
+declare function useWindowEventListener<E extends keyof WindowEventMap>(event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: Window, event: WindowEventMap[E]) => void>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
 /**
  * Attaches an event listener to the document.
  *
@@ -403,7 +512,7 @@ declare function useWindowEventListener<E extends keyof WindowEventMap>(event: M
  *
  * @see https://0.vuetifyjs.com/composables/system/use-event-listener
  */
-declare function useDocumentEventListener<E extends keyof DocumentEventMap>(event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: Document, event: DocumentEventMap[E]) => any>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
+declare function useDocumentEventListener<E extends keyof DocumentEventMap>(event: MaybeRefOrGetter<MaybeArray<E>>, listener: MaybeRef<MaybeArray<(this: Document, event: DocumentEventMap[E]) => void>>, options?: MaybeRefOrGetter<boolean | AddEventListenerOptions>): CleanupFunction;
 //#endregion
 //#region src/composables/useTokens/index.d.ts
 interface TokenAlias<T = unknown> {
@@ -1032,6 +1141,7 @@ declare function createHydrationPlugin<E extends HydrationContext = HydrationCon
 declare function useHydration<E extends HydrationContext = HydrationContext>(namespace?: string): E;
 //#endregion
 //#region src/composables/useIntersectionObserver/index.d.ts
+type MaybeRef$1<T> = T | Ref<T> | Readonly<Ref<T>> | ShallowRef<T> | Readonly<ShallowRef<T>>;
 interface IntersectionObserverEntry {
   boundingClientRect: DOMRectReadOnly;
   intersectionRatio: number;
@@ -1043,6 +1153,7 @@ interface IntersectionObserverEntry {
 }
 interface IntersectionObserverOptions {
   immediate?: boolean;
+  once?: boolean;
   root?: Element | null;
   rootMargin?: string;
   threshold?: number | number[];
@@ -1112,7 +1223,7 @@ interface UseIntersectionObserverReturn {
  * resume()
  * ```
  */
-declare function useIntersectionObserver(target: Ref<Element | undefined>, callback: (entries: IntersectionObserverEntry[]) => void, options?: IntersectionObserverOptions): UseIntersectionObserverReturn;
+declare function useIntersectionObserver(target: MaybeRef$1<Element | null | undefined>, callback: (entries: IntersectionObserverEntry[]) => void, options?: IntersectionObserverOptions): UseIntersectionObserverReturn;
 interface UseElementIntersectionReturn extends UseIntersectionObserverReturn {
   /**
    * The intersection ratio (0.0 to 1.0) indicating how much of the element is visible
@@ -1147,7 +1258,7 @@ interface UseElementIntersectionReturn extends UseIntersectionObserverReturn {
  * })
  * ```
  */
-declare function useElementIntersection(target: Ref<Element | undefined>, options?: IntersectionObserverOptions): UseElementIntersectionReturn;
+declare function useElementIntersection(target: MaybeRef$1<Element | null | undefined>, options?: IntersectionObserverOptions): UseElementIntersectionReturn;
 //#endregion
 //#region src/composables/useKeydown/index.d.ts
 interface KeyHandler {
@@ -1182,6 +1293,10 @@ interface UseKeydownReturn {
  * ```ts
  * import { useKeydown } from '@vuetify/v0'
  *
+ * // Single handler
+ * useKeydown({ key: 'Escape', handler: () => console.log('Escape pressed') })
+ *
+ * // Multiple handlers
  * const { isActive, start, stop } = useKeydown([
  *   { key: 'Enter', handler: () => console.log('Enter pressed') },
  *   { key: 'Escape', handler: () => console.log('Escape pressed'), preventDefault: true },
@@ -1525,6 +1640,7 @@ interface MutationObserverRecord {
 }
 interface UseMutationObserverOptions {
   immediate?: boolean;
+  once?: boolean;
   childList?: boolean;
   attributes?: boolean;
   characterData?: boolean;
@@ -2216,6 +2332,7 @@ interface ResizeObserverEntry {
 }
 interface ResizeObserverOptions {
   immediate?: boolean;
+  once?: boolean;
   box?: 'content-box' | 'border-box';
 }
 interface UseResizeObserverReturn {
@@ -3246,4 +3363,4 @@ interface VirtualContext<T = unknown> {
  */
 declare function useVirtual<T = unknown>(items: Ref<readonly T[]>, _options?: VirtualOptions): VirtualContext<T>;
 //#endregion
-export { createQueue as $, TokenContext as $n, LocaleAdapter as $t, Vuetify0ThemeAdapter as A, FilterFunction as An, provideContext as Ar, LoggerOptions as At, StorageAdapter as B, useFilterContext as Bn, LoggerAdapter as Bt, ThemePluginOptions as C, FormValidationRule as Cn, toArray as Cr, useOverflow as Ct, createThemeContext as D, useForm as Dn, ContextKey as Dr, useMutationObserver as Dt, createTheme as E, createFormContext as En, createPlugin as Er, UseMutationObserverReturn as Et, StoragePluginOptions as F, FilterResult as Fn, useLogger as Ft, UseElementSizeReturn as G, FeatureTicket as Gn, LocaleRecord as Gt, MemoryAdapter as H, FeatureContextOptions as Hn, LocaleContextOptions as Ht, createStorage as I, Primitive as In, LogLevel as It, useResizeObserver as J, createFeaturesPlugin as Jn, createLocaleContext as Jt, UseResizeObserverReturn as K, createFeatures as Kn, LocaleTicket as Kt, createStorageContext as L, createFilter as Ln, Vuetify0LoggerAdapter as Lt, StorageContext as M, FilterMode as Mn, createLogger as Mt, StorageContextOptions as N, FilterOptions as Nn, createLoggerContext as Nt, createThemePlugin as O, FilterContext as On, CreateContextOptions as Or, LoggerContext as Ot, StorageOptions as P, FilterQuery as Pn, createLoggerPlugin as Pt, QueueTicket as Q, TokenCollection as Qn, Vuetify0LocaleAdapter as Qt, createStoragePlugin as R, createFilterContext as Rn, PinoLoggerAdapter as Rt, ThemeOptions as S, FormValidationResult as Sn, toReactive as Sr, createOverflowContext as St, ThemeTicket as T, createForm as Tn, PluginOptions as Tr, UseMutationObserverOptions as Tt, ResizeObserverEntry as U, FeatureOptions as Un, LocaleOptions as Ut, StorageType as V, FeatureContext as Vn, LocaleContext as Vt, ResizeObserverOptions as W, FeaturePluginOptions as Wn, LocalePluginOptions as Wt, QueueContextOptions as X, FlatTokenCollection as Xn, createLocalePlugin as Xt, QueueContext as Y, useFeatures as Yn, createLocaleFallback as Yt, QueueOptions as Z, TokenAlias as Zn, useLocale as Zt, useTimeline as _, useHydration as _n, BreakpointsPluginOptions as _r, PermissionAdapterInterface as _t, VirtualItem as a, UseElementIntersectionReturn as an, createTokens as ar, ProxyModelOptions as at, ThemeContext as b, FormOptions as bn, createBreakpointsPlugin as br, OverflowOptions as bt, useVirtual as c, useIntersectionObserver as cn, CleanupFunction as cr, PermissionContextOptions as ct, TimelineContext as d, HydrationOptions as dn, useEventListener as dr, PermissionTicket as dt, KeyHandler as en, TokenContextOptions as er, createQueueContext as et, TimelineContextOptions as f, HydrationPluginOptions as fn, useWindowEventListener as fr, createPermissions as ft, createTimelineContext as g, createHydrationPlugin as gn, BreakpointsOptions as gr, PermissionAdapter as gt, createTimeline as h, createHydrationContext as hn, BreakpointsContextOptions as hr, usePermissions as ht, VirtualDirection as i, IntersectionObserverOptions as in, TokenValue as ir, useProxyRegistry as it, ThemeAdapter as j, FilterItem as jn, useContext as jr, LoggerPluginOptions as jt, useTheme as k, FilterContextOptions as kn, createContext as kr, LoggerContextOptions as kt, ToggleScopeControls as l, HydrationContext as ln, EventHandler as lr, PermissionOptions as lt, TimelineTicket as m, createHydration as mn, BreakpointsContext as mr, createPermissionsPlugin as mt, VirtualAnchor as n, useKeydown as nn, TokenPrimitive as nr, ProxyRegistryContext as nt, VirtualOptions as o, UseIntersectionObserverReturn as on, createTokensContext as or, useProxyModel as ot, TimelineOptions as p, createFallbackHydration as pn, BreakpointName as pr, createPermissionsContext as pt, useElementSize as q, createFeaturesContext as qn, createLocale as qt, VirtualContext as r, IntersectionObserverEntry as rn, TokenTicket as rr, ProxyRegistryOptions as rt, VirtualState as s, useElementIntersection as sn, useTokens as sr, PermissionContext as st, ScrollToOptions as t, UseKeydownReturn as tn, TokenOptions as tr, useQueue as tt, useToggleScope as u, HydrationContextOptions as un, useDocumentEventListener as ur, PermissionPluginOptions as ut, Colors as v, FormContext as vn, createBreakpoints as vr, OverflowContext as vt, ThemeRecord as w, FormValue as wn, Plugin as wr, MutationObserverRecord as wt, ThemeContextOptions as x, FormTicket as xn, useBreakpoints as xr, createOverflow as xt, ThemeColors as y, FormContextOptions as yn, createBreakpointsContext as yr, OverflowContextOptions as yt, useStorage as z, useFilter as zn, ConsolaLoggerAdapter as zt };
+export { createQueue as $, TokenCollection as $n, LocaleAdapter as $t, Vuetify0ThemeAdapter as A, FilterContextOptions as An, toArray as Ar, LoggerOptions as At, StorageAdapter as B, useFilter as Bn, LoggerAdapter as Bt, ThemePluginOptions as C, FormValidationResult as Cn, BreakpointsOptions as Cr, useOverflow as Ct, createThemeContext as D, createFormContext as Dn, createBreakpointsPlugin as Dr, useMutationObserver as Dt, createTheme as E, createForm as En, createBreakpointsContext as Er, UseMutationObserverReturn as Et, StoragePluginOptions as F, FilterQuery as Fn, CreateContextOptions as Fr, useLogger as Ft, UseElementSizeReturn as G, FeaturePluginOptions as Gn, LocaleRecord as Gt, MemoryAdapter as H, FeatureContext as Hn, LocaleContextOptions as Ht, createStorage as I, FilterResult as In, createContext as Ir, LogLevel as It, useResizeObserver as J, createFeaturesContext as Jn, createLocaleContext as Jt, UseResizeObserverReturn as K, FeatureTicket as Kn, LocaleTicket as Kt, createStorageContext as L, Primitive as Ln, provideContext as Lr, Vuetify0LoggerAdapter as Lt, StorageContext as M, FilterItem as Mn, PluginOptions as Mr, createLogger as Mt, StorageContextOptions as N, FilterMode as Nn, createPlugin as Nr, createLoggerContext as Nt, createThemePlugin as O, useForm as On, useBreakpoints as Or, LoggerContext as Ot, StorageOptions as P, FilterOptions as Pn, ContextKey as Pr, createLoggerPlugin as Pt, QueueTicket as Q, TokenAlias as Qn, Vuetify0LocaleAdapter as Qt, createStoragePlugin as R, createFilter as Rn, useContext as Rr, PinoLoggerAdapter as Rt, ThemeOptions as S, FormTicket as Sn, BreakpointsContextOptions as Sr, createOverflowContext as St, ThemeTicket as T, FormValue as Tn, createBreakpoints as Tr, UseMutationObserverOptions as Tt, ResizeObserverEntry as U, FeatureContextOptions as Un, LocaleOptions as Ut, StorageType as V, useFilterContext as Vn, LocaleContext as Vt, ResizeObserverOptions as W, FeatureOptions as Wn, LocalePluginOptions as Wt, QueueContextOptions as X, useFeatures as Xn, createLocalePlugin as Xt, QueueContext as Y, createFeaturesPlugin as Yn, createLocaleFallback as Yt, QueueOptions as Z, FlatTokenCollection as Zn, useLocale as Zt, useTimeline as _, createHydrationPlugin as _n, UseClickOutsideOptions as _r, PermissionAdapterInterface as _t, VirtualItem as a, MaybeRef$1 as an, TokenValue as ar, ProxyModelOptions as at, ThemeContext as b, FormContextOptions as bn, BreakpointName as br, OverflowOptions as bt, useVirtual as c, useElementIntersection as cn, useTokens as cr, PermissionContextOptions as ct, TimelineContext as d, HydrationContextOptions as dn, useDocumentEventListener as dr, PermissionTicket as dt, KeyHandler as en, TokenContext as er, createQueueContext as et, TimelineContextOptions as f, HydrationOptions as fn, useEventListener as fr, createPermissions as ft, createTimelineContext as g, createHydrationContext as gn, ClickOutsideTarget as gr, PermissionAdapter as gt, createTimeline as h, createHydration as hn, ClickOutsideIgnoreTarget as hr, usePermissions as ht, VirtualDirection as i, IntersectionObserverOptions as in, TokenTicket as ir, useProxyRegistry as it, ThemeAdapter as j, FilterFunction as jn, Plugin as jr, LoggerPluginOptions as jt, useTheme as k, FilterContext as kn, toReactive as kr, LoggerContextOptions as kt, ToggleScopeControls as l, useIntersectionObserver as ln, CleanupFunction as lr, PermissionOptions as lt, TimelineTicket as m, createFallbackHydration as mn, ClickOutsideElement as mr, createPermissionsPlugin as mt, VirtualAnchor as n, useKeydown as nn, TokenOptions as nr, ProxyRegistryContext as nt, VirtualOptions as o, UseElementIntersectionReturn as on, createTokens as or, useProxyModel as ot, TimelineOptions as p, HydrationPluginOptions as pn, useWindowEventListener as pr, createPermissionsContext as pt, useElementSize as q, createFeatures as qn, createLocale as qt, VirtualContext as r, IntersectionObserverEntry as rn, TokenPrimitive as rr, ProxyRegistryOptions as rt, VirtualState as s, UseIntersectionObserverReturn as sn, createTokensContext as sr, PermissionContext as st, ScrollToOptions as t, UseKeydownReturn as tn, TokenContextOptions as tr, useQueue as tt, useToggleScope as u, HydrationContext as un, EventHandler as ur, PermissionPluginOptions as ut, Colors as v, useHydration as vn, UseClickOutsideReturn as vr, OverflowContext as vt, ThemeRecord as w, FormValidationRule as wn, BreakpointsPluginOptions as wr, MutationObserverRecord as wt, ThemeContextOptions as x, FormOptions as xn, BreakpointsContext as xr, createOverflow as xt, ThemeColors as y, FormContext as yn, useClickOutside as yr, OverflowContextOptions as yt, useStorage as z, createFilterContext as zn, ConsolaLoggerAdapter as zt };

package/dist/index-CjzlIAtF.d.mts

@@ -0,0 +1,296 @@
+import { n as DeepPartial } from "./index-4jSy8KIt.mjs";
+
+//#region src/utilities/helpers.d.ts
+
+/**
+ * Checks if a value is a function
+ *
+ * @param item The value to check
+ * @returns True if the value is a function
+ *
+ * @example
+ * ```ts
+ * isFunction(() => {})  // true
+ * isFunction('string')  // false
+ * ```
+ */
+declare function isFunction(item: unknown): item is Function;
+/**
+ * Checks if a value is a string
+ *
+ * @param item The value to check
+ * @returns True if the value is a string
+ *
+ * @example
+ * ```ts
+ * isString('hello')  // true
+ * isString(123)      // false
+ * ```
+ */
+declare function isString(item: unknown): item is string;
+/**
+ * Checks if a value is a number
+ *
+ * @param item The value to check
+ * @returns True if the value is a number (including NaN)
+ *
+ * @example
+ * ```ts
+ * isNumber(123)       // true
+ * isNumber(NaN)       // true
+ * isNumber('123')     // false
+ * ```
+ *
+ * @see {@link isNaN} to check for NaN specifically
+ */
+declare function isNumber(item: unknown): item is number;
+/**
+ * Checks if a value is a boolean
+ *
+ * @param item The value to check
+ * @returns True if the value is a boolean
+ *
+ * @example
+ * ```ts
+ * isBoolean(true)   // true
+ * isBoolean(false)  // true
+ * isBoolean(0)      // false
+ * ```
+ */
+declare function isBoolean(item: unknown): item is boolean;
+/**
+ * Checks if a value is a plain object (excludes null and arrays)
+ *
+ * @param item The value to check
+ * @returns True if the value is a plain object
+ *
+ * @remarks
+ * Returns false for null and arrays, even though `typeof null === 'object'`
+ * and `typeof [] === 'object'` in JavaScript.
+ *
+ * @example
+ * ```ts
+ * isObject({})        // true
+ * isObject({ a: 1 })  // true
+ * isObject(null)      // false
+ * isObject([])        // false
+ * ```
+ *
+ * @see {@link isArray} to check for arrays
+ * @see {@link isNull} to check for null
+ */
+declare function isObject(item: unknown): item is Record<string, unknown>;
+/**
+ * Checks if a value is an array
+ *
+ * @param item The value to check
+ * @returns True if the value is an array
+ *
+ * @example
+ * ```ts
+ * isArray([])        // true
+ * isArray([1, 2, 3]) // true
+ * isArray('string')  // false
+ * ```
+ */
+declare function isArray(item: unknown): item is unknown[];
+/**
+ * Checks if a value is null
+ *
+ * @param item The value to check
+ * @returns True if the value is null
+ *
+ * @example
+ * ```ts
+ * isNull(null)      // true
+ * isNull(undefined) // false
+ * ```
+ *
+ * @see {@link isUndefined} to check for undefined
+ * @see {@link isNullOrUndefined} to check for either
+ */
+declare function isNull(item: unknown): item is null;
+/**
+ * Checks if a value is null or undefined
+ *
+ * @param item The value to check
+ * @returns True if the value is null or undefined
+ *
+ * @remarks
+ * Uses loose equality (`== null`) which matches both null and undefined.
+ *
+ * @example
+ * ```ts
+ * isNullOrUndefined(null)      // true
+ * isNullOrUndefined(undefined) // true
+ * isNullOrUndefined(0)         // false
+ * isNullOrUndefined('')        // false
+ * ```
+ *
+ * @see {@link isNull} to check for null only
+ * @see {@link isUndefined} to check for undefined only
+ */
+declare function isNullOrUndefined(item: unknown): item is null | undefined;
+/**
+ * Checks if a value is undefined
+ *
+ * @param item The value to check
+ * @returns True if the value is undefined
+ *
+ * @example
+ * ```ts
+ * isUndefined(undefined) // true
+ * isUndefined(null)      // false
+ * ```
+ *
+ * @see {@link isNull} to check for null
+ * @see {@link isNullOrUndefined} to check for either
+ */
+declare function isUndefined(item: unknown): item is undefined;
+/**
+ * Checks if a value is a primitive (string, number, or boolean)
+ *
+ * @param item The value to check
+ * @returns True if the value is a string, number, or boolean
+ *
+ * @example
+ * ```ts
+ * isPrimitive('hello') // true
+ * isPrimitive(123)     // true
+ * isPrimitive(true)    // true
+ * isPrimitive({})      // false
+ * isPrimitive(null)    // false
+ * ```
+ */
+declare function isPrimitive(item: unknown): item is string | number | boolean;
+/**
+ * Checks if a value is a symbol
+ *
+ * @param item The value to check
+ * @returns True if the value is a symbol
+ *
+ * @example
+ * ```ts
+ * isSymbol(Symbol('test')) // true
+ * isSymbol('symbol')       // false
+ * ```
+ */
+declare function isSymbol(item: unknown): item is symbol;
+/**
+ * Checks if a value is NaN (Not a Number)
+ *
+ * @param item The value to check
+ * @returns True if the value is NaN
+ *
+ * @remarks
+ * Uses `Number.isNaN()` which only returns true for the actual NaN value,
+ * unlike the global `isNaN()` which coerces the argument to a number first.
+ *
+ * @example
+ * ```ts
+ * isNaN(NaN)         // true
+ * isNaN(123)         // false
+ * isNaN('hello')     // false (unlike global isNaN)
+ * isNaN(undefined)   // false (unlike global isNaN)
+ * ```
+ *
+ * @see {@link isNumber} to check if a value is a number type
+ */
+declare function isNaN(item: unknown): item is number;
+/**
+ * Deeply merges source objects into a target object
+ *
+ * @param target The target object to merge into (will be mutated)
+ * @param sources One or more source objects to merge from
+ * @returns The mutated target object
+ *
+ * @remarks
+ * - Mutates the target object in place
+ * - Nested objects are recursively merged
+ * - Arrays are replaced, not merged
+ * - Primitives from sources overwrite target values
+ *
+ * @example
+ * ```ts
+ * const target = { a: 1, b: { c: 2 } }
+ * mergeDeep(target, { b: { d: 3 } })
+ * // target is now { a: 1, b: { c: 2, d: 3 } }
+ *
+ * // Multiple sources
+ * mergeDeep({}, { a: 1 }, { b: 2 }) // { a: 1, b: 2 }
+ *
+ * // Arrays are replaced
+ * mergeDeep({ arr: [1, 2] }, { arr: [3] }) // { arr: [3] }
+ * ```
+ */
+declare function mergeDeep<T extends object>(target: T, ...sources: DeepPartial<T>[]): T;
+/**
+ * Generates a random 7-character alphanumeric ID
+ *
+ * @returns A random string of 7 characters (a-z, 0-9)
+ *
+ * @remarks
+ * Uses `Math.random()` converted to base-36. Not cryptographically secure.
+ * Suitable for unique keys in UI components, not for security purposes.
+ *
+ * @example
+ * ```ts
+ * genId() // 'k7x9m2p'
+ * genId() // 'a3b8c1d'
+ * ```
+ */
+declare function genId(): string;
+/**
+ * Clamps a value between a minimum and maximum
+ *
+ * @param value The value to clamp
+ * @param min The minimum value (default: 0)
+ * @param max The maximum value (default: 1)
+ * @returns The clamped value
+ *
+ * @example
+ * ```ts
+ * clamp(5, 0, 10)  // 5
+ * clamp(-5, 0, 10) // 0
+ * clamp(15, 0, 10) // 10
+ * ```
+ */
+declare function clamp(value: number, min?: number, max?: number): number;
+/**
+ * Creates an array of sequential numbers
+ *
+ * @param length The length of the array to create
+ * @param start The starting index (default: 0)
+ * @returns An array of sequential numbers
+ *
+ * @example
+ * ```ts
+ * range(3)     // [0, 1, 2]
+ * range(3, 1)  // [1, 2, 3]
+ * range(5, 10) // [10, 11, 12, 13, 14]
+ * range(0)     // []
+ * ```
+ */
+declare function range(length: number, start?: number): number[];
+/**
+ * Debounces a function call by the specified delay
+ *
+ * @param fn The function to debounce
+ * @param delay The delay in milliseconds
+ * @returns A debounced function with clear and immediate methods
+ *
+ * @example
+ * ```ts
+ * const debouncedFn = debounce(() => console.log('called'), 500)
+ * debouncedFn()        // Will call after 500ms
+ * debouncedFn.clear()  // Cancel pending call
+ * debouncedFn.immediate() // Call immediately
+ * ```
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, delay: number): {
+  (...args: Parameters<T>): void;
+  clear(): void;
+  immediate(...args: Parameters<T>): void;
+};
+//#endregion
+export { range as _, isBoolean as a, isNull as c, isObject as d, isPrimitive as f, mergeDeep as g, isUndefined as h, isArray as i, isNullOrUndefined as l, isSymbol as m, debounce as n, isFunction as o, isString as p, genId as r, isNaN as s, clamp as t, isNumber as u };