asterui 0.11.0 → 0.12.1

package/dist/index97.js

@@ -1,34 +1,49 @@
-import { useState as v, useCallback as i, useEffect as l } from "react";
-function c(n, f = {}) {
-  const { target: u, event: o = "keydown", preventDefault: r = !1 } = f, [a, d] = v(!1), t = i(
+import { useState as u, useCallback as c, useEffect as f } from "react";
+function S(o, t) {
+  const [s, n] = u(() => {
+    if (typeof window > "u")
+      return t;
+    try {
+      const e = window.localStorage.getItem(o);
+      return e ? JSON.parse(e) : t;
+    } catch {
+      return t;
+    }
+  }), d = c(
     (e) => {
-      e.key === n && (r && e.preventDefault(), d(!0));
+      n((r) => {
+        const a = e instanceof Function ? e(r) : e;
+        if (typeof window < "u")
+          try {
+            window.localStorage.setItem(o, JSON.stringify(a));
+          } catch (l) {
+            console.warn(`Failed to save to localStorage key "${o}":`, l);
+          }
+        return a;
+      });
     },
-    [n, r]
-  ), s = i(
-    (e) => {
-      e.key === n && d(!1);
-    },
-    [n]
-  );
-  return l(() => {
-    const e = u ?? window;
-    return o === "keydown" ? (e.addEventListener("keydown", t), e.addEventListener("keyup", s)) : e.addEventListener("keyup", t), () => {
-      e.removeEventListener("keydown", t), e.removeEventListener("keyup", s);
-    };
-  }, [u, o, t, s]), a;
-}
-function y(n, f, u = {}) {
-  const { target: o, event: r = "keydown", preventDefault: a = !1 } = u;
-  l(() => {
-    const d = o ?? window, t = (s) => {
-      s.key === n && (a && s.preventDefault(), f(s));
+    [o]
+  ), w = c(() => {
+    if (typeof window < "u")
+      try {
+        window.localStorage.removeItem(o);
+      } catch (e) {
+        console.warn(`Failed to remove localStorage key "${o}":`, e);
+      }
+    n(t);
+  }, [o, t]);
+  return f(() => {
+    const e = (r) => {
+      if (r.key === o && r.newValue !== null)
+        try {
+          n(JSON.parse(r.newValue));
+        } catch {
+        }
     };
-    return d.addEventListener(r, t), () => d.removeEventListener(r, t);
-  }, [o, n, f, r, a]);
+    return window.addEventListener("storage", e), () => window.removeEventListener("storage", e);
+  }, [o]), [s, d, w];
 }
 export {
-  c as useKeyPress,
-  y as useKeyPressCallback
+  S as useLocalStorage
 };
 //# sourceMappingURL=index97.js.map

package/dist/index97.js.map

@@ -1 +1 @@
-{"version":3,"file":"index97.js","sources":["../src/hooks/useKeyPress.ts"],"sourcesContent":["import { useState, useEffect, useCallback } from 'react'\n\nexport interface UseKeyPressOptions {\n  /** Target element (default: window) */\n  target?: HTMLElement | Window | null\n  /** Event type: 'keydown' | 'keyup' (default: 'keydown') */\n  event?: 'keydown' | 'keyup'\n  /** Prevent default browser behavior */\n  preventDefault?: boolean\n}\n\n/**\n * Hook that detects when a specific key is pressed.\n *\n * @param targetKey - Key to detect (e.g., 'Enter', 'Escape', 'a')\n * @param options - Configuration options\n * @returns Whether the key is currently pressed\n *\n * @example\n * const enterPressed = useKeyPress('Enter')\n * const escapePressed = useKeyPress('Escape')\n *\n * useEffect(() => {\n *   if (escapePressed) closeModal()\n * }, [escapePressed])\n *\n * @example\n * // With callback for immediate action\n * useKeyPress('Escape', { preventDefault: true })\n */\nexport function useKeyPress(\n  targetKey: string,\n  options: UseKeyPressOptions = {}\n): boolean {\n  const { target, event = 'keydown', preventDefault = false } = options\n  const [keyPressed, setKeyPressed] = useState(false)\n\n  const downHandler = useCallback(\n    (e: KeyboardEvent) => {\n      if (e.key === targetKey) {\n        if (preventDefault) e.preventDefault()\n        setKeyPressed(true)\n      }\n    },\n    [targetKey, preventDefault]\n  )\n\n  const upHandler = useCallback(\n    (e: KeyboardEvent) => {\n      if (e.key === targetKey) {\n        setKeyPressed(false)\n      }\n    },\n    [targetKey]\n  )\n\n  useEffect(() => {\n    const targetElement = target ?? window\n\n    if (event === 'keydown') {\n      targetElement.addEventListener('keydown', downHandler as EventListener)\n      targetElement.addEventListener('keyup', upHandler as EventListener)\n    } else {\n      targetElement.addEventListener('keyup', downHandler as EventListener)\n    }\n\n    return () => {\n      targetElement.removeEventListener('keydown', downHandler as EventListener)\n      targetElement.removeEventListener('keyup', upHandler as EventListener)\n    }\n  }, [target, event, downHandler, upHandler])\n\n  return keyPressed\n}\n\n/**\n * Hook that calls a callback when a specific key is pressed.\n *\n * @param targetKey - Key to detect\n * @param callback - Function to call when key is pressed\n * @param options - Configuration options\n *\n * @example\n * useKeyPressCallback('Escape', () => closeModal())\n * useKeyPressCallback('Enter', () => submitForm(), { preventDefault: true })\n */\nexport function useKeyPressCallback(\n  targetKey: string,\n  callback: (event: KeyboardEvent) => void,\n  options: UseKeyPressOptions = {}\n): void {\n  const { target, event = 'keydown', preventDefault = false } = options\n\n  useEffect(() => {\n    const targetElement = target ?? window\n\n    const handler = (e: KeyboardEvent) => {\n      if (e.key === targetKey) {\n        if (preventDefault) e.preventDefault()\n        callback(e)\n      }\n    }\n\n    targetElement.addEventListener(event, handler as EventListener)\n    return () => targetElement.removeEventListener(event, handler as EventListener)\n  }, [target, targetKey, callback, event, preventDefault])\n}\n"],"names":["useKeyPress","targetKey","options","target","event","preventDefault","keyPressed","setKeyPressed","useState","downHandler","useCallback","upHandler","useEffect","targetElement","useKeyPressCallback","callback","handler","e"],"mappings":";AA8BO,SAASA,EACdC,GACAC,IAA8B,IACrB;AACT,QAAM,EAAE,QAAAC,GAAQ,OAAAC,IAAQ,WAAW,gBAAAC,IAAiB,OAAUH,GACxD,CAACI,GAAYC,CAAa,IAAIC,EAAS,EAAK,GAE5CC,IAAcC;AAAA,IAClB,CAAC,MAAqB;AACpB,MAAI,EAAE,QAAQT,MACRI,OAAkB,eAAA,GACtBE,EAAc,EAAI;AAAA,IAEtB;AAAA,IACA,CAACN,GAAWI,CAAc;AAAA,EAAA,GAGtBM,IAAYD;AAAA,IAChB,CAAC,MAAqB;AACpB,MAAI,EAAE,QAAQT,KACZM,EAAc,EAAK;AAAA,IAEvB;AAAA,IACA,CAACN,CAAS;AAAA,EAAA;AAGZ,SAAAW,EAAU,MAAM;AACd,UAAMC,IAAgBV,KAAU;AAEhC,WAAIC,MAAU,aACZS,EAAc,iBAAiB,WAAWJ,CAA4B,GACtEI,EAAc,iBAAiB,SAASF,CAA0B,KAElEE,EAAc,iBAAiB,SAASJ,CAA4B,GAG/D,MAAM;AACX,MAAAI,EAAc,oBAAoB,WAAWJ,CAA4B,GACzEI,EAAc,oBAAoB,SAASF,CAA0B;AAAA,IACvE;AAAA,EACF,GAAG,CAACR,GAAQC,GAAOK,GAAaE,CAAS,CAAC,GAEnCL;AACT;AAaO,SAASQ,EACdb,GACAc,GACAb,IAA8B,CAAA,GACxB;AACN,QAAM,EAAE,QAAAC,GAAQ,OAAAC,IAAQ,WAAW,gBAAAC,IAAiB,OAAUH;AAE9D,EAAAU,EAAU,MAAM;AACd,UAAMC,IAAgBV,KAAU,QAE1Ba,IAAU,CAACC,MAAqB;AACpC,MAAIA,EAAE,QAAQhB,MACRI,OAAkB,eAAA,GACtBU,EAASE,CAAC;AAAA,IAEd;AAEA,WAAAJ,EAAc,iBAAiBT,GAAOY,CAAwB,GACvD,MAAMH,EAAc,oBAAoBT,GAAOY,CAAwB;AAAA,EAChF,GAAG,CAACb,GAAQF,GAAWc,GAAUX,GAAOC,CAAc,CAAC;AACzD;"}
+{"version":3,"file":"index97.js","sources":["../src/hooks/useLocalStorage.ts"],"sourcesContent":["import { useState, useCallback, useEffect } from 'react'\n\n/**\n * Hook for persisting state to localStorage.\n *\n * @param key - localStorage key\n * @param initialValue - Initial value if key doesn't exist\n * @returns [value, setValue, removeValue] tuple\n *\n * @example\n * const [theme, setTheme] = useLocalStorage('theme', 'light')\n * const [user, setUser, removeUser] = useLocalStorage('user', null)\n */\nexport function useLocalStorage<T>(\n  key: string,\n  initialValue: T\n): [T, (value: T | ((prev: T) => T)) => void, () => void] {\n  // Get initial value from localStorage or use default\n  const [storedValue, setStoredValue] = useState<T>(() => {\n    if (typeof window === 'undefined') {\n      return initialValue\n    }\n\n    try {\n      const item = window.localStorage.getItem(key)\n      return item ? (JSON.parse(item) as T) : initialValue\n    } catch {\n      return initialValue\n    }\n  })\n\n  // Update localStorage when value changes\n  const setValue = useCallback(\n    (value: T | ((prev: T) => T)) => {\n      setStoredValue(prev => {\n        const valueToStore = value instanceof Function ? value(prev) : value\n\n        if (typeof window !== 'undefined') {\n          try {\n            window.localStorage.setItem(key, JSON.stringify(valueToStore))\n          } catch (error) {\n            console.warn(`Failed to save to localStorage key \"${key}\":`, error)\n          }\n        }\n\n        return valueToStore\n      })\n    },\n    [key]\n  )\n\n  // Remove from localStorage\n  const removeValue = useCallback(() => {\n    if (typeof window !== 'undefined') {\n      try {\n        window.localStorage.removeItem(key)\n      } catch (error) {\n        console.warn(`Failed to remove localStorage key \"${key}\":`, error)\n      }\n    }\n    setStoredValue(initialValue)\n  }, [key, initialValue])\n\n  // Sync with other tabs/windows\n  useEffect(() => {\n    const handleStorageChange = (e: StorageEvent) => {\n      if (e.key === key && e.newValue !== null) {\n        try {\n          setStoredValue(JSON.parse(e.newValue) as T)\n        } catch {\n          // Ignore parse errors\n        }\n      }\n    }\n\n    window.addEventListener('storage', handleStorageChange)\n    return () => window.removeEventListener('storage', handleStorageChange)\n  }, [key])\n\n  return [storedValue, setValue, removeValue]\n}\n"],"names":["useLocalStorage","key","initialValue","storedValue","setStoredValue","useState","item","setValue","useCallback","value","prev","valueToStore","error","removeValue","useEffect","handleStorageChange","e"],"mappings":";AAaO,SAASA,EACdC,GACAC,GACwD;AAExD,QAAM,CAACC,GAAaC,CAAc,IAAIC,EAAY,MAAM;AACtD,QAAI,OAAO,SAAW;AACpB,aAAOH;AAGT,QAAI;AACF,YAAMI,IAAO,OAAO,aAAa,QAAQL,CAAG;AAC5C,aAAOK,IAAQ,KAAK,MAAMA,CAAI,IAAUJ;AAAA,IAC1C,QAAQ;AACN,aAAOA;AAAA,IACT;AAAA,EACF,CAAC,GAGKK,IAAWC;AAAA,IACf,CAACC,MAAgC;AAC/B,MAAAL,EAAe,CAAAM,MAAQ;AACrB,cAAMC,IAAeF,aAAiB,WAAWA,EAAMC,CAAI,IAAID;AAE/D,YAAI,OAAO,SAAW;AACpB,cAAI;AACF,mBAAO,aAAa,QAAQR,GAAK,KAAK,UAAUU,CAAY,CAAC;AAAA,UAC/D,SAASC,GAAO;AACd,oBAAQ,KAAK,uCAAuCX,CAAG,MAAMW,CAAK;AAAA,UACpE;AAGF,eAAOD;AAAA,MACT,CAAC;AAAA,IACH;AAAA,IACA,CAACV,CAAG;AAAA,EAAA,GAIAY,IAAcL,EAAY,MAAM;AACpC,QAAI,OAAO,SAAW;AACpB,UAAI;AACF,eAAO,aAAa,WAAWP,CAAG;AAAA,MACpC,SAASW,GAAO;AACd,gBAAQ,KAAK,sCAAsCX,CAAG,MAAMW,CAAK;AAAA,MACnE;AAEF,IAAAR,EAAeF,CAAY;AAAA,EAC7B,GAAG,CAACD,GAAKC,CAAY,CAAC;AAGtB,SAAAY,EAAU,MAAM;AACd,UAAMC,IAAsB,CAACC,MAAoB;AAC/C,UAAIA,EAAE,QAAQf,KAAOe,EAAE,aAAa;AAClC,YAAI;AACF,UAAAZ,EAAe,KAAK,MAAMY,EAAE,QAAQ,CAAM;AAAA,QAC5C,QAAQ;AAAA,QAER;AAAA,IAEJ;AAEA,kBAAO,iBAAiB,WAAWD,CAAmB,GAC/C,MAAM,OAAO,oBAAoB,WAAWA,CAAmB;AAAA,EACxE,GAAG,CAACd,CAAG,CAAC,GAED,CAACE,GAAaI,GAAUM,CAAW;AAC5C;"}

package/dist/index98.js

@@ -1,21 +1,16 @@
-import { useState as t, useEffect as d } from "react";
-function r() {
-  const [i, n] = t(() => typeof window > "u" ? { width: 0, height: 0 } : {
-    width: window.innerWidth,
-    height: window.innerHeight
-  });
-  return d(() => {
-    if (typeof window > "u") return;
-    const e = () => {
-      n({
-        width: window.innerWidth,
-        height: window.innerHeight
-      });
+import { useState as r, useEffect as c } from "react";
+function i(e, t = 300) {
+  const [o, u] = r(e);
+  return c(() => {
+    const n = setTimeout(() => {
+      u(e);
+    }, t);
+    return () => {
+      clearTimeout(n);
     };
-    return window.addEventListener("resize", e), () => window.removeEventListener("resize", e);
-  }, []), i;
+  }, [e, t]), o;
 }
 export {
-  r as useWindowSize
+  i as useDebounce
 };
 //# sourceMappingURL=index98.js.map

package/dist/index98.js.map

@@ -1 +1 @@
-{"version":3,"file":"index98.js","sources":["../src/hooks/useWindowSize.ts"],"sourcesContent":["import { useState, useEffect } from 'react'\n\nexport interface WindowSize {\n  width: number\n  height: number\n}\n\n/**\n * Hook that tracks window dimensions.\n * Updates on window resize.\n *\n * @returns Object with current width and height\n *\n * @example\n * const { width, height } = useWindowSize()\n *\n * return (\n *   <div>\n *     Window: {width} x {height}\n *     {width < 768 && <MobileNav />}\n *   </div>\n * )\n */\nexport function useWindowSize(): WindowSize {\n  const [windowSize, setWindowSize] = useState<WindowSize>(() => {\n    if (typeof window === 'undefined') {\n      return { width: 0, height: 0 }\n    }\n    return {\n      width: window.innerWidth,\n      height: window.innerHeight,\n    }\n  })\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return\n\n    const handleResize = () => {\n      setWindowSize({\n        width: window.innerWidth,\n        height: window.innerHeight,\n      })\n    }\n\n    window.addEventListener('resize', handleResize)\n    return () => window.removeEventListener('resize', handleResize)\n  }, [])\n\n  return windowSize\n}\n"],"names":["useWindowSize","windowSize","setWindowSize","useState","useEffect","handleResize"],"mappings":";AAuBO,SAASA,IAA4B;AAC1C,QAAM,CAACC,GAAYC,CAAa,IAAIC,EAAqB,MACnD,OAAO,SAAW,MACb,EAAE,OAAO,GAAG,QAAQ,EAAA,IAEtB;AAAA,IACL,OAAO,OAAO;AAAA,IACd,QAAQ,OAAO;AAAA,EAAA,CAElB;AAED,SAAAC,EAAU,MAAM;AACd,QAAI,OAAO,SAAW,IAAa;AAEnC,UAAMC,IAAe,MAAM;AACzB,MAAAH,EAAc;AAAA,QACZ,OAAO,OAAO;AAAA,QACd,QAAQ,OAAO;AAAA,MAAA,CAChB;AAAA,IACH;AAEA,kBAAO,iBAAiB,UAAUG,CAAY,GACvC,MAAM,OAAO,oBAAoB,UAAUA,CAAY;AAAA,EAChE,GAAG,CAAA,CAAE,GAEEJ;AACT;"}
+{"version":3,"file":"index98.js","sources":["../src/hooks/useDebounce.ts"],"sourcesContent":["import { useState, useEffect } from 'react'\n\n/**\n * Hook that delays updating a value until after a specified delay.\n * Useful for search inputs to avoid excessive API calls.\n *\n * @param value - Value to debounce\n * @param delay - Delay in milliseconds (default: 300)\n * @returns Debounced value\n *\n * @example\n * const [search, setSearch] = useState('')\n * const debouncedSearch = useDebounce(search, 500)\n *\n * useEffect(() => {\n *   // This runs 500ms after user stops typing\n *   fetchResults(debouncedSearch)\n * }, [debouncedSearch])\n */\nexport function useDebounce<T>(value: T, delay = 300): T {\n  const [debouncedValue, setDebouncedValue] = useState<T>(value)\n\n  useEffect(() => {\n    const timer = setTimeout(() => {\n      setDebouncedValue(value)\n    }, delay)\n\n    return () => {\n      clearTimeout(timer)\n    }\n  }, [value, delay])\n\n  return debouncedValue\n}\n"],"names":["useDebounce","value","delay","debouncedValue","setDebouncedValue","useState","useEffect","timer"],"mappings":";AAmBO,SAASA,EAAeC,GAAUC,IAAQ,KAAQ;AACvD,QAAM,CAACC,GAAgBC,CAAiB,IAAIC,EAAYJ,CAAK;AAE7D,SAAAK,EAAU,MAAM;AACd,UAAMC,IAAQ,WAAW,MAAM;AAC7B,MAAAH,EAAkBH,CAAK;AAAA,IACzB,GAAGC,CAAK;AAER,WAAO,MAAM;AACX,mBAAaK,CAAK;AAAA,IACpB;AAAA,EACF,GAAG,CAACN,GAAOC,CAAK,CAAC,GAEVC;AACT;"}