@orion-ds/react 4.9.2 → 4.9.3

package/dist/hooks/useCopyToClipboard.d.ts

@@ -0,0 +1,72 @@
+/**
+ * useCopyToClipboard Hook
+ *
+ * Provides a function to copy text to clipboard with status tracking.
+ *
+ * @example
+ * ```tsx
+ * const { copy, copied, error } = useCopyToClipboard();
+ *
+ * return (
+ *   <Button onClick={() => copy('Hello!')}>
+ *     {copied ? 'Copied!' : 'Copy'}
+ *   </Button>
+ * );
+ * ```
+ */
+/**
+ * Options for useCopyToClipboard hook
+ */
+export interface UseCopyToClipboardOptions {
+    /**
+     * Duration in ms to show "copied" state
+     * @default 2000
+     */
+    copiedDuration?: number;
+    /**
+     * Callback when copy succeeds
+     */
+    onSuccess?: (text: string) => void;
+    /**
+     * Callback when copy fails
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * Return type for useCopyToClipboard hook
+ */
+export interface UseCopyToClipboardReturn {
+    /**
+     * Function to copy text to clipboard
+     */
+    copy: (text: string) => Promise<boolean>;
+    /**
+     * Whether text was recently copied
+     */
+    copied: boolean;
+    /**
+     * The last copied text
+     */
+    copiedText: string | null;
+    /**
+     * Any error that occurred
+     */
+    error: Error | null;
+    /**
+     * Reset the copied state
+     */
+    reset: () => void;
+}
+/**
+ * Hook to copy text to clipboard
+ *
+ * @param options - Configuration options
+ * @returns Copy function and status
+ */
+export declare function useCopyToClipboard(options?: UseCopyToClipboardOptions): UseCopyToClipboardReturn;
+/**
+ * Simplified hook that just returns the copy function
+ * For simple use cases where you don't need status tracking
+ */
+export declare function useCopy(): (text: string) => Promise<boolean>;
+//# sourceMappingURL=useCopyToClipboard.d.ts.map

package/dist/hooks/useCopyToClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyToClipboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useCopyToClipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CA2E1B;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAG5D"}

package/dist/hooks/useCopyToClipboard.mjs

@@ -0,0 +1,41 @@
+import { useState as s, useRef as C, useEffect as b, useCallback as p } from "react";
+function E(o = {}) {
+  const { copiedDuration: a = 2e3, onSuccess: i, onError: n } = o, [d, c] = s(!1), [y, l] = s(null), [T, t] = s(null), r = C(null);
+  b(() => () => {
+    r.current && clearTimeout(r.current);
+  }, []);
+  const m = p(() => {
+    c(!1), l(null), t(null), r.current && clearTimeout(r.current);
+  }, []);
+  return {
+    copy: p(
+      async (u) => {
+        if (r.current && clearTimeout(r.current), t(null), !navigator?.clipboard) {
+          const e = new Error("Clipboard API not available");
+          return t(e), n?.(e), !1;
+        }
+        try {
+          return await navigator.clipboard.writeText(u), c(!0), l(u), i?.(u), r.current = setTimeout(() => {
+            c(!1);
+          }, a), !0;
+        } catch (e) {
+          const f = e instanceof Error ? e : new Error("Failed to copy");
+          return t(f), n?.(f), !1;
+        }
+      },
+      [a, i, n]
+    ),
+    copied: d,
+    copiedText: y,
+    error: T,
+    reset: m
+  };
+}
+function g() {
+  const { copy: o } = E();
+  return o;
+}
+export {
+  g as useCopy,
+  E as useCopyToClipboard
+};

package/dist/hooks/useDebounce.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react");function g(u,c){const[f,o]=e.useState(u);return e.useEffect(()=>{const l=setTimeout(()=>{o(u)},c);return()=>{clearTimeout(l)}},[u,c]),f}function D(u,c,f={}){const{leading:o=!1,trailing:l=!0,maxWait:a}=f,r=e.useRef(null),s=e.useRef(null),n=e.useRef(null),m=e.useRef(null),i=e.useRef(!1),t=e.useCallback(()=>{r.current&&(clearTimeout(r.current),r.current=null),s.current&&(clearTimeout(s.current),s.current=null),i.current=!1,n.current=null,m.current=null},[]),R=e.useCallback(()=>{i.current&&n.current!==null&&(u(...n.current),t())},[u,t]),d=e.useCallback(()=>i.current,[]),T=e.useCallback((...b)=>{const C=Date.now();n.current=b,m.current=C,i.current=!0,o&&!r.current&&u(...b),r.current&&clearTimeout(r.current),l&&(r.current=setTimeout(()=>{l&&n.current!==null&&u(...n.current),t()},c)),a&&!s.current&&(s.current=setTimeout(()=>{n.current!==null&&u(...n.current),t()},a))},[u,c,o,l,a,t]);return e.useEffect(()=>t,[t]),{callback:T,cancel:t,flush:R,isPending:d}}exports.useDebounce=g;exports.useDebouncedCallback=D;

package/dist/hooks/useDebounce.d.ts

@@ -0,0 +1,58 @@
+/**
+ * useDebounce Hook
+ *
+ * Debounces a value, updating only after a specified delay.
+ *
+ * @example
+ * ```tsx
+ * const [search, setSearch] = useState('');
+ * const debouncedSearch = useDebounce(search, 300);
+ *
+ * useEffect(() => {
+ *   // Only runs 300ms after user stops typing
+ *   fetchResults(debouncedSearch);
+ * }, [debouncedSearch]);
+ * ```
+ */
+/**
+ * Hook to debounce a value
+ *
+ * @param value - Value to debounce
+ * @param delay - Debounce delay in milliseconds
+ * @returns Debounced value
+ */
+export declare function useDebounce<T>(value: T, delay: number): T;
+/**
+ * Options for useDebouncedCallback
+ */
+export interface UseDebouncedCallbackOptions {
+    /**
+     * Whether to call immediately on the leading edge
+     * @default false
+     */
+    leading?: boolean;
+    /**
+     * Whether to call on the trailing edge
+     * @default true
+     */
+    trailing?: boolean;
+    /**
+     * Maximum time to wait before forcing invocation
+     */
+    maxWait?: number;
+}
+/**
+ * Hook to create a debounced callback function
+ *
+ * @param callback - Function to debounce
+ * @param delay - Debounce delay in milliseconds
+ * @param options - Additional options
+ * @returns Debounced callback and control functions
+ */
+export declare function useDebouncedCallback<T extends (...args: unknown[]) => unknown>(callback: T, delay: number, options?: UseDebouncedCallbackOptions): {
+    callback: (...args: Parameters<T>) => void;
+    cancel: () => void;
+    flush: () => void;
+    isPending: () => boolean;
+};
+//# sourceMappingURL=useDebounce.d.ts.map

package/dist/hooks/useDebounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useDebounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAczD;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAC5E,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,2BAAgC,GACxC;IACD,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3C,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B,CAmFA"}

package/dist/hooks/useDebounce.mjs

@@ -0,0 +1,39 @@
+import { useState as p, useEffect as R, useRef as o, useCallback as f } from "react";
+function w(e, u) {
+  const [m, i] = p(e);
+  return R(() => {
+    const c = setTimeout(() => {
+      i(e);
+    }, u);
+    return () => {
+      clearTimeout(c);
+    };
+  }, [e, u]), m;
+}
+function V(e, u, m = {}) {
+  const { leading: i = !1, trailing: c = !0, maxWait: a } = m, t = o(null), l = o(null), r = o(null), T = o(null), s = o(!1), n = f(() => {
+    t.current && (clearTimeout(t.current), t.current = null), l.current && (clearTimeout(l.current), l.current = null), s.current = !1, r.current = null, T.current = null;
+  }, []), b = f(() => {
+    s.current && r.current !== null && (e(...r.current), n());
+  }, [e, n]), g = f(() => s.current, []), C = f(
+    (...d) => {
+      const D = Date.now();
+      r.current = d, T.current = D, s.current = !0, i && !t.current && e(...d), t.current && clearTimeout(t.current), c && (t.current = setTimeout(() => {
+        c && r.current !== null && e(...r.current), n();
+      }, u)), a && !l.current && (l.current = setTimeout(() => {
+        r.current !== null && e(...r.current), n();
+      }, a));
+    },
+    [e, u, i, c, a, n]
+  );
+  return R(() => n, [n]), {
+    callback: C,
+    cancel: n,
+    flush: b,
+    isPending: g
+  };
+}
+export {
+  w as useDebounce,
+  V as useDebouncedCallback
+};

package/dist/hooks/useDisclosure.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react");function O(r={}){const{defaultOpen:i=!1,onOpen:n,onClose:t,onChange:e}=r,[c,l]=o.useState(i),a=o.useCallback(()=>{l(!0),n?.(),e?.(!0)},[n,e]),u=o.useCallback(()=>{l(!1),t?.(),e?.(!1)},[t,e]),p=o.useCallback(()=>{const s=!c;l(s),s?n?.():t?.(),e?.(s)},[c,n,t,e]),f=o.useCallback(s=>{l(s),s?n?.():t?.(),e?.(s)},[n,t,e]);return{isOpen:c,open:a,close:u,onOpen:a,onClose:u,toggle:p,setIsOpen:f}}exports.useDisclosure=O;

package/dist/hooks/useDisclosure.d.ts

@@ -0,0 +1,86 @@
+/**
+ * useDisclosure Hook
+ *
+ * Manages open/close state for modals, drawers, dropdowns, etc.
+ *
+ * @example
+ * ```tsx
+ * // Orion convention (preferred)
+ * const { isOpen, open, close, toggle } = useDisclosure();
+ *
+ * // MUI/Chakra/Radix convention (also works)
+ * const { isOpen, onOpen, onClose, toggle } = useDisclosure();
+ *
+ * return (
+ *   <>
+ *     <Button onClick={toggle}>Toggle Modal</Button>
+ *     <Modal open={isOpen} onClose={close}>
+ *       Content
+ *     </Modal>
+ *   </>
+ * );
+ * ```
+ */
+/**
+ * Options for useDisclosure hook
+ */
+export interface UseDisclosureOptions {
+    /**
+     * Initial open state
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /**
+     * Callback when state changes to open
+     */
+    onOpen?: () => void;
+    /**
+     * Callback when state changes to closed
+     */
+    onClose?: () => void;
+    /**
+     * Callback when state changes (open or close)
+     */
+    onChange?: (isOpen: boolean) => void;
+}
+/**
+ * Return type for useDisclosure hook
+ */
+export interface UseDisclosureReturn {
+    /**
+     * Whether the disclosure is open
+     */
+    isOpen: boolean;
+    /**
+     * Open the disclosure
+     */
+    open: () => void;
+    /**
+     * Close the disclosure
+     */
+    close: () => void;
+    /**
+     * Alias for `open` - familiar for devs from MUI/Chakra/Radix
+     */
+    onOpen: () => void;
+    /**
+     * Alias for `close` - familiar for devs from MUI/Chakra/Radix
+     */
+    onClose: () => void;
+    /**
+     * Toggle the disclosure
+     */
+    toggle: () => void;
+    /**
+     * Set the disclosure state directly
+     */
+    setIsOpen: (value: boolean) => void;
+}
+/**
+ * Hook for managing open/close state
+ *
+ * @param options - Configuration options
+ * @returns Disclosure state and control functions
+ */
+export declare function useDisclosure(options?: UseDisclosureOptions): UseDisclosureReturn;
+//# sourceMappingURL=useDisclosure.d.ts.map

package/dist/hooks/useDisclosure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDisclosure.d.ts","sourceRoot":"","sources":["../../src/hooks/useDisclosure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAoDrB"}

package/dist/hooks/useDisclosure.mjs

@@ -0,0 +1,30 @@
+import { useState as i, useCallback as l } from "react";
+function g(f = {}) {
+  const { defaultOpen: r = !1, onOpen: s, onClose: o, onChange: e } = f, [c, t] = i(r), p = l(() => {
+    t(!0), s?.(), e?.(!0);
+  }, [s, e]), a = l(() => {
+    t(!1), o?.(), e?.(!1);
+  }, [o, e]), u = l(() => {
+    const n = !c;
+    t(n), n ? s?.() : o?.(), e?.(n);
+  }, [c, s, o, e]), O = l(
+    (n) => {
+      t(n), n ? s?.() : o?.(), e?.(n);
+    },
+    [s, o, e]
+  );
+  return {
+    isOpen: c,
+    open: p,
+    close: a,
+    onOpen: p,
+    // alias for MUI/Chakra/Radix convention
+    onClose: a,
+    // alias for MUI/Chakra/Radix convention
+    toggle: u,
+    setIsOpen: O
+  };
+}
+export {
+  g as useDisclosure
+};

package/dist/hooks/useKeyboard.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("react");function h(n,a,f={}){const{ctrl:t=!1,alt:o=!1,shift:c=!1,meta:u=!1,enabled:i=!0,event:e="keydown",preventDefault:m=!0,stopPropagation:l=!1,target:s,targetOnly:p=!1}=f,b=y.useRef(a);b.current=a,y.useEffect(()=>{if(!i)return;const d=r=>{if(!(r.key.toLowerCase()===n.toLowerCase()||r.code===n)||t!==r.ctrlKey||o!==r.altKey||c!==r.shiftKey||u!==r.metaKey||p&&s&&r.target!==s)return;const g=document.activeElement;(g instanceof HTMLInputElement||g instanceof HTMLTextAreaElement||g?.getAttribute("contenteditable")==="true")&&n.toLowerCase()!=="escape"||(m&&r.preventDefault(),l&&r.stopPropagation(),b.current(r))},v=s||document;return v.addEventListener(e,d),()=>{v.removeEventListener(e,d)}},[n,t,o,c,u,i,e,m,l,s,p])}function E(n){const a=n.split("+"),f=a[a.length-1]||n,t={};for(let o=0;o<a.length-1;o++){const c=a[o];if(c)switch(c.toLowerCase()){case"ctrl":case"control":t.ctrl=!0;break;case"alt":case"option":t.alt=!0;break;case"shift":t.shift=!0;break;case"meta":case"cmd":case"command":t.meta=!0;break}}return{key:f,modifiers:t}}function L(n,a={}){const{enabled:f=!0,event:t="keydown",preventDefault:o=!0,stopPropagation:c=!1}=a,u=y.useCallback(()=>Object.entries(n).map(([i,e])=>({...E(i),handler:e})),[n]);y.useEffect(()=>{if(!f)return;const i=e=>{const m=u();for(const{key:l,modifiers:s,handler:p}of m){if(!(e.key.toLowerCase()===l.toLowerCase()||e.code===l)||(s.ctrl??!1)!==e.ctrlKey||(s.alt??!1)!==e.altKey||(s.shift??!1)!==e.shiftKey||(s.meta??!1)!==e.metaKey)continue;const d=document.activeElement;if(!((d instanceof HTMLInputElement||d instanceof HTMLTextAreaElement||d?.getAttribute("contenteditable")==="true")&&l.toLowerCase()!=="escape")){o&&e.preventDefault(),c&&e.stopPropagation(),p();break}}};return document.addEventListener(t,i),()=>{document.removeEventListener(t,i)}},[f,t,o,c,u])}exports.useKeyboard=h;exports.useKeyboardShortcuts=L;

package/dist/hooks/useKeyboard.d.ts

@@ -0,0 +1,101 @@
+/**
+ * useKeyboard Hook
+ *
+ * Handles keyboard shortcuts and key events.
+ *
+ * @example
+ * ```tsx
+ * // Single key
+ * useKeyboard('Escape', () => closeModal());
+ *
+ * // With modifiers
+ * useKeyboard('k', () => openSearch(), { meta: true });
+ * useKeyboard('s', () => save(), { ctrl: true });
+ *
+ * // Multiple keys
+ * useKeyboardShortcuts({
+ *   'Escape': () => closeModal(),
+ *   'Meta+k': () => openSearch(),
+ *   'Ctrl+s': () => save(),
+ * });
+ * ```
+ */
+/**
+ * Key modifier options
+ */
+export interface KeyModifiers {
+    /**
+     * Require Ctrl key
+     * @default false
+     */
+    ctrl?: boolean;
+    /**
+     * Require Alt/Option key
+     * @default false
+     */
+    alt?: boolean;
+    /**
+     * Require Shift key
+     * @default false
+     */
+    shift?: boolean;
+    /**
+     * Require Meta/Cmd key (Mac) or Windows key
+     * @default false
+     */
+    meta?: boolean;
+}
+/**
+ * Options for useKeyboard hook
+ */
+export interface UseKeyboardOptions extends KeyModifiers {
+    /**
+     * Whether the handler is enabled
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Event type to listen for
+     * @default 'keydown'
+     */
+    event?: "keydown" | "keyup" | "keypress";
+    /**
+     * Whether to prevent default browser behavior
+     * @default true
+     */
+    preventDefault?: boolean;
+    /**
+     * Whether to stop event propagation
+     * @default false
+     */
+    stopPropagation?: boolean;
+    /**
+     * Target element (default: document)
+     */
+    target?: HTMLElement | null;
+    /**
+     * Only trigger if target element is focused
+     * @default false
+     */
+    targetOnly?: boolean;
+}
+/**
+ * Hook to handle a single keyboard shortcut
+ *
+ * @param key - Key to listen for (e.g., 'Escape', 'Enter', 'k')
+ * @param handler - Callback when key is pressed
+ * @param options - Additional options
+ */
+export declare function useKeyboard(key: string, handler: (event: KeyboardEvent) => void, options?: UseKeyboardOptions): void;
+/**
+ * Shortcut definition with handler
+ */
+export type KeyboardShortcuts = Record<string, () => void>;
+/**
+ * Hook to handle multiple keyboard shortcuts
+ *
+ * @param shortcuts - Object mapping shortcut strings to handlers
+ * @param options - Common options for all shortcuts
+ */
+export declare function useKeyboardShortcuts(shortcuts: KeyboardShortcuts, options?: Omit<UseKeyboardOptions, keyof KeyModifiers>): void;
+//# sourceMappingURL=useKeyboard.d.ts.map

package/dist/hooks/useKeyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useKeyboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IAEzC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EACvC,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAqFN;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;AA0C3D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,YAAY,CAAM,GACzD,IAAI,CAkEN"}

package/dist/hooks/useKeyboard.mjs

@@ -0,0 +1,99 @@
+import { useRef as E, useEffect as g, useCallback as b } from "react";
+function T(n, a, f = {}) {
+  const {
+    ctrl: t = !1,
+    alt: o = !1,
+    shift: i = !1,
+    meta: u = !1,
+    enabled: c = !0,
+    event: e = "keydown",
+    preventDefault: d = !0,
+    stopPropagation: l = !1,
+    target: s,
+    targetOnly: p = !1
+  } = f, y = E(a);
+  y.current = a, g(() => {
+    if (!c)
+      return;
+    const m = (r) => {
+      if (!(r.key.toLowerCase() === n.toLowerCase() || r.code === n) || t !== r.ctrlKey || o !== r.altKey || i !== r.shiftKey || u !== r.metaKey || p && s && r.target !== s)
+        return;
+      const h = document.activeElement;
+      (h instanceof HTMLInputElement || h instanceof HTMLTextAreaElement || h?.getAttribute("contenteditable") === "true") && n.toLowerCase() !== "escape" || (d && r.preventDefault(), l && r.stopPropagation(), y.current(r));
+    }, v = s || document;
+    return v.addEventListener(e, m), () => {
+      v.removeEventListener(e, m);
+    };
+  }, [
+    n,
+    t,
+    o,
+    i,
+    u,
+    c,
+    e,
+    d,
+    l,
+    s,
+    p
+  ]);
+}
+function L(n) {
+  const a = n.split("+"), f = a[a.length - 1] || n, t = {};
+  for (let o = 0; o < a.length - 1; o++) {
+    const i = a[o];
+    if (i)
+      switch (i.toLowerCase()) {
+        case "ctrl":
+        case "control":
+          t.ctrl = !0;
+          break;
+        case "alt":
+        case "option":
+          t.alt = !0;
+          break;
+        case "shift":
+          t.shift = !0;
+          break;
+        case "meta":
+        case "cmd":
+        case "command":
+          t.meta = !0;
+          break;
+      }
+  }
+  return { key: f, modifiers: t };
+}
+function C(n, a = {}) {
+  const {
+    enabled: f = !0,
+    event: t = "keydown",
+    preventDefault: o = !0,
+    stopPropagation: i = !1
+  } = a, u = b(() => Object.entries(n).map(([c, e]) => ({
+    ...L(c),
+    handler: e
+  })), [n]);
+  g(() => {
+    if (!f)
+      return;
+    const c = (e) => {
+      const d = u();
+      for (const { key: l, modifiers: s, handler: p } of d) {
+        if (!(e.key.toLowerCase() === l.toLowerCase() || e.code === l) || (s.ctrl ?? !1) !== e.ctrlKey || (s.alt ?? !1) !== e.altKey || (s.shift ?? !1) !== e.shiftKey || (s.meta ?? !1) !== e.metaKey) continue;
+        const m = document.activeElement;
+        if (!((m instanceof HTMLInputElement || m instanceof HTMLTextAreaElement || m?.getAttribute("contenteditable") === "true") && l.toLowerCase() !== "escape")) {
+          o && e.preventDefault(), i && e.stopPropagation(), p();
+          break;
+        }
+      }
+    };
+    return document.addEventListener(t, c), () => {
+      document.removeEventListener(t, c);
+    };
+  }, [f, t, o, i, u]);
+}
+export {
+  T as useKeyboard,
+  C as useKeyboardShortcuts
+};

package/dist/hooks/useLocalStorage.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react");function S(e,o,g={}){const{serializer:w=JSON.stringify,deserializer:a=JSON.parse,syncAcrossTabs:i=!0}=g,d=n.useCallback(()=>{if(typeof window>"u")return o;try{const r=window.localStorage.getItem(e);return r?a(r):o}catch(r){return console.warn(`Error reading localStorage key "${e}":`,r),o}},[e,o,a]),[c,u]=n.useState(d),l=n.useCallback(r=>{if(typeof window>"u"){console.warn("localStorage is not available");return}try{const s=r instanceof Function?r(c):r;u(s),window.localStorage.setItem(e,w(s)),window.dispatchEvent(new StorageEvent("storage",{key:e,newValue:w(s)}))}catch(s){console.warn(`Error setting localStorage key "${e}":`,s)}},[e,w,c]),t=n.useCallback(()=>{if(!(typeof window>"u"))try{window.localStorage.removeItem(e),u(o),window.dispatchEvent(new StorageEvent("storage",{key:e,newValue:null}))}catch(r){console.warn(`Error removing localStorage key "${e}":`,r)}},[e,o]);return n.useEffect(()=>{if(!i||typeof window>"u")return;const r=s=>{if(s.key===e)try{const f=s.newValue?a(s.newValue):o;u(f)}catch(f){console.warn(`Error syncing localStorage key "${e}":`,f)}};return window.addEventListener("storage",r),()=>{window.removeEventListener("storage",r)}},[e,o,a,i]),n.useEffect(()=>{u(d())},[]),[c,l,t]}function m(e,o,g={}){const{serializer:w=JSON.stringify,deserializer:a=JSON.parse}=g,i=n.useCallback(()=>{if(typeof window>"u")return o;try{const t=window.sessionStorage.getItem(e);return t?a(t):o}catch(t){return console.warn(`Error reading sessionStorage key "${e}":`,t),o}},[e,o,a]),[d,c]=n.useState(i),u=n.useCallback(t=>{if(!(typeof window>"u"))try{const r=t instanceof Function?t(d):t;c(r),window.sessionStorage.setItem(e,w(r))}catch(r){console.warn(`Error setting sessionStorage key "${e}":`,r)}},[e,w,d]),l=n.useCallback(()=>{if(!(typeof window>"u"))try{window.sessionStorage.removeItem(e),c(o)}catch(t){console.warn(`Error removing sessionStorage key "${e}":`,t)}},[e,o]);return n.useEffect(()=>{c(i())},[]),[d,u,l]}exports.useLocalStorage=S;exports.useSessionStorage=m;

package/dist/hooks/useLocalStorage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * useLocalStorage Hook
+ *
+ * Syncs state with localStorage for persistence across sessions.
+ *
+ * @example
+ * ```tsx
+ * const [theme, setTheme] = useLocalStorage('theme', 'light');
+ * const [user, setUser] = useLocalStorage<User | null>('user', null);
+ *
+ * // Value persists across page refreshes
+ * setTheme('dark');
+ * ```
+ */
+/**
+ * Options for useLocalStorage hook
+ */
+export interface UseLocalStorageOptions<T> {
+    /**
+     * Custom serializer function
+     * @default JSON.stringify
+     */
+    serializer?: (value: T) => string;
+    /**
+     * Custom deserializer function
+     * @default JSON.parse
+     */
+    deserializer?: (value: string) => T;
+    /**
+     * Whether to sync across tabs
+     * @default true
+     */
+    syncAcrossTabs?: boolean;
+}
+/**
+ * Hook to sync state with localStorage
+ *
+ * @param key - localStorage key
+ * @param initialValue - Initial value if key doesn't exist
+ * @param options - Additional options
+ * @returns [value, setValue, removeValue]
+ */
+export declare function useLocalStorage<T>(key: string, initialValue: T, options?: UseLocalStorageOptions<T>): [T, (value: T | ((prev: T) => T)) => void, () => void];
+/**
+ * Hook to sync state with sessionStorage (similar to useLocalStorage)
+ */
+export declare function useSessionStorage<T>(key: string, initialValue: T, options?: Omit<UseLocalStorageOptions<T>, "syncAcrossTabs">): [T, (value: T | ((prev: T) => T)) => void, () => void];
+//# sourceMappingURL=useLocalStorage.d.ts.map

package/dist/hooks/useLocalStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.d.ts","sourceRoot":"","sources":["../../src/hooks/useLocalStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IAElC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;IAEpC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,GACtC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC,CAkHxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAM,GAC9D,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC,CAwDxD"}