tempest-react-sdk 0.22.0 → 0.23.0

package/dist/hooks/use-geolocation.js

@@ -0,0 +1,44 @@
+import { useState as u, useEffect as g } from "react";
+function f(s = {}) {
+  const { watch: n = !1, disabled: e = !1, ...t } = s, [c, a] = u({
+    loading: !e,
+    error: null,
+    coords: null,
+    timestamp: null
+  });
+  return g(() => {
+    if (e || typeof navigator > "u" || !navigator.geolocation) {
+      a((o) => ({ ...o, loading: !1 }));
+      return;
+    }
+    const i = (o) => {
+      a({
+        loading: !1,
+        error: null,
+        coords: o.coords,
+        timestamp: o.timestamp
+      });
+    }, r = (o) => {
+      a((l) => ({ ...l, loading: !1, error: o }));
+    };
+    if (n) {
+      const o = navigator.geolocation.watchPosition(
+        i,
+        r,
+        t
+      );
+      return () => navigator.geolocation.clearWatch(o);
+    }
+    navigator.geolocation.getCurrentPosition(i, r, t);
+  }, [
+    e,
+    n,
+    t.enableHighAccuracy,
+    t.maximumAge,
+    t.timeout
+  ]), c;
+}
+export {
+  f as useGeolocation
+};
+//# sourceMappingURL=use-geolocation.js.map

package/dist/hooks/use-geolocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-geolocation.js","sources":["../../src/hooks/use-geolocation.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface GeolocationState {\n    loading: boolean;\n    error: GeolocationPositionError | null;\n    coords: GeolocationCoordinates | null;\n    timestamp: number | null;\n}\n\nexport interface UseGeolocationOptions extends PositionOptions {\n    /** Use `watchPosition` instead of one-shot `getCurrentPosition`. Default: false. */\n    watch?: boolean;\n    /** Disable the hook without unmounting. Default: false. */\n    disabled?: boolean;\n}\n\n/**\n * React hook around the Geolocation API.\n *\n * The effect depends on the individual `PositionOptions` fields instead of the\n * rest object, which is a new reference on every render and would restart the\n * watch continuously. `exhaustive-deps` is silenced there because those fields\n * are the whole of what the effect reads from it.\n *\n * @param options - Geolocation options plus `watch` and `disabled` switches.\n * @returns The latest position, error and loading state.\n */\nexport function useGeolocation(options: UseGeolocationOptions = {}): GeolocationState {\n    const { watch = false, disabled = false, ...positionOptions } = options;\n    const [state, setState] = useState<GeolocationState>({\n        loading: !disabled,\n        error: null,\n        coords: null,\n        timestamp: null,\n    });\n\n    useEffect(() => {\n        if (disabled || typeof navigator === \"undefined\" || !navigator.geolocation) {\n            setState((prev) => ({ ...prev, loading: false }));\n            return;\n        }\n\n        const onSuccess = (position: GeolocationPosition): void => {\n            setState({\n                loading: false,\n                error: null,\n                coords: position.coords,\n                timestamp: position.timestamp,\n            });\n        };\n        const onError = (error: GeolocationPositionError): void => {\n            setState((prev) => ({ ...prev, loading: false, error }));\n        };\n\n        if (watch) {\n            const watchId = navigator.geolocation.watchPosition(\n                onSuccess,\n                onError,\n                positionOptions,\n            );\n            return () => navigator.geolocation.clearWatch(watchId);\n        }\n\n        navigator.geolocation.getCurrentPosition(onSuccess, onError, positionOptions);\n        return undefined;\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n        disabled,\n        watch,\n        positionOptions.enableHighAccuracy,\n        positionOptions.maximumAge,\n        positionOptions.timeout,\n    ]);\n\n    return state;\n}\n"],"names":["useGeolocation","options","watch","disabled","positionOptions","state","setState","useState","useEffect","prev","onSuccess","position","onError","error","watchId"],"mappings":";AA2BO,SAASA,EAAeC,IAAiC,IAAsB;AAClF,QAAM,EAAE,OAAAC,IAAQ,IAAO,UAAAC,IAAW,IAAO,GAAGC,MAAoBH,GAC1D,CAACI,GAAOC,CAAQ,IAAIC,EAA2B;AAAA,IACjD,SAAS,CAACJ;AAAA,IACV,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,WAAW;AAAA,EAAA,CACd;AAED,SAAAK,EAAU,MAAM;AACZ,QAAIL,KAAY,OAAO,YAAc,OAAe,CAAC,UAAU,aAAa;AACxE,MAAAG,EAAS,CAACG,OAAU,EAAE,GAAGA,GAAM,SAAS,KAAQ;AAChD;AAAA,IACJ;AAEA,UAAMC,IAAY,CAACC,MAAwC;AACvD,MAAAL,EAAS;AAAA,QACL,SAAS;AAAA,QACT,OAAO;AAAA,QACP,QAAQK,EAAS;AAAA,QACjB,WAAWA,EAAS;AAAA,MAAA,CACvB;AAAA,IACL,GACMC,IAAU,CAACC,MAA0C;AACvD,MAAAP,EAAS,CAACG,OAAU,EAAE,GAAGA,GAAM,SAAS,IAAO,OAAAI,IAAQ;AAAA,IAC3D;AAEA,QAAIX,GAAO;AACP,YAAMY,IAAU,UAAU,YAAY;AAAA,QAClCJ;AAAA,QACAE;AAAA,QACAR;AAAA,MAAA;AAEJ,aAAO,MAAM,UAAU,YAAY,WAAWU,CAAO;AAAA,IACzD;AAEA,cAAU,YAAY,mBAAmBJ,GAAWE,GAASR,CAAe;AAAA,EAGhF,GAAG;AAAA,IACCD;AAAA,IACAD;AAAA,IACAE,EAAgB;AAAA,IAChBA,EAAgB;AAAA,IAChBA,EAAgB;AAAA,EAAA,CACnB,GAEMC;AACX;"}

package/dist/hooks/use-hover.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react");function v(t){const[u,r]=s.useState(!1);return s.useEffect(()=>{const e=t.current;if(!e)return;const n=()=>r(!0),o=()=>r(!1);return e.addEventListener("mouseenter",n),e.addEventListener("mouseleave",o),()=>{e.removeEventListener("mouseenter",n),e.removeEventListener("mouseleave",o)}},[t]),u}exports.useHover=v;
+//# sourceMappingURL=use-hover.cjs.map

package/dist/hooks/use-hover.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hover.cjs","sources":["../../src/hooks/use-hover.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\n/**\n * Track whether the pointer is hovering over the referenced element.\n * Returns `false` on touch-only devices (no pointer hover).\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * const hovered = useHover(ref);\n * return <div ref={ref}>{hovered ? \"✨\" : \"\"}</div>;\n */\nexport function useHover<T extends HTMLElement>(ref: RefObject<T | null>): boolean {\n    const [hovered, setHovered] = useState<boolean>(false);\n\n    useEffect(() => {\n        const node = ref.current;\n        if (!node) return;\n        const onEnter = (): void => setHovered(true);\n        const onLeave = (): void => setHovered(false);\n        node.addEventListener(\"mouseenter\", onEnter);\n        node.addEventListener(\"mouseleave\", onLeave);\n        return () => {\n            node.removeEventListener(\"mouseenter\", onEnter);\n            node.removeEventListener(\"mouseleave\", onLeave);\n        };\n    }, [ref]);\n\n    return hovered;\n}\n"],"names":["useHover","ref","hovered","setHovered","useState","useEffect","node","onEnter","onLeave"],"mappings":"yGAYO,SAASA,EAAgCC,EAAmC,CAC/E,KAAM,CAACC,EAASC,CAAU,EAAIC,EAAAA,SAAkB,EAAK,EAErDC,OAAAA,EAAAA,UAAU,IAAM,CACZ,MAAMC,EAAOL,EAAI,QACjB,GAAI,CAACK,EAAM,OACX,MAAMC,EAAU,IAAYJ,EAAW,EAAI,EACrCK,EAAU,IAAYL,EAAW,EAAK,EAC5C,OAAAG,EAAK,iBAAiB,aAAcC,CAAO,EAC3CD,EAAK,iBAAiB,aAAcE,CAAO,EACpC,IAAM,CACTF,EAAK,oBAAoB,aAAcC,CAAO,EAC9CD,EAAK,oBAAoB,aAAcE,CAAO,CAClD,CACJ,EAAG,CAACP,CAAG,CAAC,EAEDC,CACX"}

package/dist/hooks/use-hover.js

@@ -0,0 +1,16 @@
+import { useState as u, useEffect as v } from "react";
+function m(t) {
+  const [s, n] = u(!1);
+  return v(() => {
+    const e = t.current;
+    if (!e) return;
+    const r = () => n(!0), o = () => n(!1);
+    return e.addEventListener("mouseenter", r), e.addEventListener("mouseleave", o), () => {
+      e.removeEventListener("mouseenter", r), e.removeEventListener("mouseleave", o);
+    };
+  }, [t]), s;
+}
+export {
+  m as useHover
+};
+//# sourceMappingURL=use-hover.js.map

package/dist/hooks/use-hover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hover.js","sources":["../../src/hooks/use-hover.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\n/**\n * Track whether the pointer is hovering over the referenced element.\n * Returns `false` on touch-only devices (no pointer hover).\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * const hovered = useHover(ref);\n * return <div ref={ref}>{hovered ? \"✨\" : \"\"}</div>;\n */\nexport function useHover<T extends HTMLElement>(ref: RefObject<T | null>): boolean {\n    const [hovered, setHovered] = useState<boolean>(false);\n\n    useEffect(() => {\n        const node = ref.current;\n        if (!node) return;\n        const onEnter = (): void => setHovered(true);\n        const onLeave = (): void => setHovered(false);\n        node.addEventListener(\"mouseenter\", onEnter);\n        node.addEventListener(\"mouseleave\", onLeave);\n        return () => {\n            node.removeEventListener(\"mouseenter\", onEnter);\n            node.removeEventListener(\"mouseleave\", onLeave);\n        };\n    }, [ref]);\n\n    return hovered;\n}\n"],"names":["useHover","ref","hovered","setHovered","useState","useEffect","node","onEnter","onLeave"],"mappings":";AAYO,SAASA,EAAgCC,GAAmC;AAC/E,QAAM,CAACC,GAASC,CAAU,IAAIC,EAAkB,EAAK;AAErD,SAAAC,EAAU,MAAM;AACZ,UAAMC,IAAOL,EAAI;AACjB,QAAI,CAACK,EAAM;AACX,UAAMC,IAAU,MAAYJ,EAAW,EAAI,GACrCK,IAAU,MAAYL,EAAW,EAAK;AAC5C,WAAAG,EAAK,iBAAiB,cAAcC,CAAO,GAC3CD,EAAK,iBAAiB,cAAcE,CAAO,GACpC,MAAM;AACT,MAAAF,EAAK,oBAAoB,cAAcC,CAAO,GAC9CD,EAAK,oBAAoB,cAAcE,CAAO;AAAA,IAClD;AAAA,EACJ,GAAG,CAACP,CAAG,CAAC,GAEDC;AACX;"}

package/dist/hooks/use-idle.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react"),u=["mousemove","mousedown","keydown","touchstart","wheel","scroll"];function c(e=6e4){const[i,t]=s.useState(!1);return s.useEffect(()=>{if(typeof window>"u")return;let o=setTimeout(()=>t(!0),e);function r(){t(!1),clearTimeout(o),o=setTimeout(()=>t(!0),e)}for(const n of u)window.addEventListener(n,r,{passive:!0});return()=>{clearTimeout(o);for(const n of u)window.removeEventListener(n,r)}},[e]),i}exports.useIdle=c;
+//# sourceMappingURL=use-idle.cjs.map

package/dist/hooks/use-idle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-idle.cjs","sources":["../../src/hooks/use-idle.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nconst DEFAULT_EVENTS: (keyof WindowEventMap)[] = [\n    \"mousemove\",\n    \"mousedown\",\n    \"keydown\",\n    \"touchstart\",\n    \"wheel\",\n    \"scroll\",\n];\n\n/**\n * Detect when the user has been idle for `timeout` ms (no interaction).\n * Returns `true` once the threshold elapses and back to `false` on activity.\n */\nexport function useIdle(timeout = 60_000): boolean {\n    const [idle, setIdle] = useState<boolean>(false);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        let timer = setTimeout(() => setIdle(true), timeout);\n\n        function reset(): void {\n            setIdle(false);\n            clearTimeout(timer);\n            timer = setTimeout(() => setIdle(true), timeout);\n        }\n\n        for (const event of DEFAULT_EVENTS) {\n            window.addEventListener(event, reset, { passive: true });\n        }\n        return () => {\n            clearTimeout(timer);\n            for (const event of DEFAULT_EVENTS) {\n                window.removeEventListener(event, reset);\n            }\n        };\n    }, [timeout]);\n\n    return idle;\n}\n"],"names":["DEFAULT_EVENTS","useIdle","timeout","idle","setIdle","useState","useEffect","timer","reset","event"],"mappings":"yGAEMA,EAA2C,CAC7C,YACA,YACA,UACA,aACA,QACA,QACJ,EAMO,SAASC,EAAQC,EAAU,IAAiB,CAC/C,KAAM,CAACC,EAAMC,CAAO,EAAIC,EAAAA,SAAkB,EAAK,EAE/CC,OAAAA,EAAAA,UAAU,IAAM,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAIC,EAAQ,WAAW,IAAMH,EAAQ,EAAI,EAAGF,CAAO,EAEnD,SAASM,GAAc,CACnBJ,EAAQ,EAAK,EACb,aAAaG,CAAK,EAClBA,EAAQ,WAAW,IAAMH,EAAQ,EAAI,EAAGF,CAAO,CACnD,CAEA,UAAWO,KAAST,EAChB,OAAO,iBAAiBS,EAAOD,EAAO,CAAE,QAAS,GAAM,EAE3D,MAAO,IAAM,CACT,aAAaD,CAAK,EAClB,UAAWE,KAAST,EAChB,OAAO,oBAAoBS,EAAOD,CAAK,CAE/C,CACJ,EAAG,CAACN,CAAO,CAAC,EAELC,CACX"}

package/dist/hooks/use-idle.js

@@ -0,0 +1,30 @@
+import { useState as i, useEffect as f } from "react";
+const s = [
+  "mousemove",
+  "mousedown",
+  "keydown",
+  "touchstart",
+  "wheel",
+  "scroll"
+];
+function c(e = 6e4) {
+  const [u, t] = i(!1);
+  return f(() => {
+    if (typeof window > "u") return;
+    let o = setTimeout(() => t(!0), e);
+    function r() {
+      t(!1), clearTimeout(o), o = setTimeout(() => t(!0), e);
+    }
+    for (const n of s)
+      window.addEventListener(n, r, { passive: !0 });
+    return () => {
+      clearTimeout(o);
+      for (const n of s)
+        window.removeEventListener(n, r);
+    };
+  }, [e]), u;
+}
+export {
+  c as useIdle
+};
+//# sourceMappingURL=use-idle.js.map

package/dist/hooks/use-idle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-idle.js","sources":["../../src/hooks/use-idle.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nconst DEFAULT_EVENTS: (keyof WindowEventMap)[] = [\n    \"mousemove\",\n    \"mousedown\",\n    \"keydown\",\n    \"touchstart\",\n    \"wheel\",\n    \"scroll\",\n];\n\n/**\n * Detect when the user has been idle for `timeout` ms (no interaction).\n * Returns `true` once the threshold elapses and back to `false` on activity.\n */\nexport function useIdle(timeout = 60_000): boolean {\n    const [idle, setIdle] = useState<boolean>(false);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        let timer = setTimeout(() => setIdle(true), timeout);\n\n        function reset(): void {\n            setIdle(false);\n            clearTimeout(timer);\n            timer = setTimeout(() => setIdle(true), timeout);\n        }\n\n        for (const event of DEFAULT_EVENTS) {\n            window.addEventListener(event, reset, { passive: true });\n        }\n        return () => {\n            clearTimeout(timer);\n            for (const event of DEFAULT_EVENTS) {\n                window.removeEventListener(event, reset);\n            }\n        };\n    }, [timeout]);\n\n    return idle;\n}\n"],"names":["DEFAULT_EVENTS","useIdle","timeout","idle","setIdle","useState","useEffect","timer","reset","event"],"mappings":";AAEA,MAAMA,IAA2C;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ;AAMO,SAASC,EAAQC,IAAU,KAAiB;AAC/C,QAAM,CAACC,GAAMC,CAAO,IAAIC,EAAkB,EAAK;AAE/C,SAAAC,EAAU,MAAM;AACZ,QAAI,OAAO,SAAW,IAAa;AACnC,QAAIC,IAAQ,WAAW,MAAMH,EAAQ,EAAI,GAAGF,CAAO;AAEnD,aAASM,IAAc;AACnB,MAAAJ,EAAQ,EAAK,GACb,aAAaG,CAAK,GAClBA,IAAQ,WAAW,MAAMH,EAAQ,EAAI,GAAGF,CAAO;AAAA,IACnD;AAEA,eAAWO,KAAST;AAChB,aAAO,iBAAiBS,GAAOD,GAAO,EAAE,SAAS,IAAM;AAE3D,WAAO,MAAM;AACT,mBAAaD,CAAK;AAClB,iBAAWE,KAAST;AAChB,eAAO,oBAAoBS,GAAOD,CAAK;AAAA,IAE/C;AAAA,EACJ,GAAG,CAACN,CAAO,CAAC,GAELC;AACX;"}

package/dist/hooks/use-install-prompt.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react"),l=require("./pwa-env.cjs"),D=10080*60*1e3,I=3e3,y="tempest:install-declined-at";let s=null;const c=new Set;typeof window<"u"&&(window.addEventListener("beforeinstallprompt",e=>{e.preventDefault(),s=e,c.forEach(o=>o(s))}),window.addEventListener("appinstalled",()=>{s=null,c.forEach(e=>e(null))}));function O(e,o){if(typeof window>"u")return!1;const u=window.localStorage.getItem(e);if(!u)return!1;const r=Number(u);return Number.isFinite(r)?Date.now()-r<o:!1}function _(e={}){const{declineStorageKey:o=y,declineCooldownMs:u=D,manualFallbackDelayMs:r=I}=e,[n,f]=a.useState(s),[w,L]=a.useState(l.isStandalone()),[m,p]=a.useState(!1);a.useEffect(()=>(c.add(f),()=>{c.delete(f)}),[]),a.useEffect(()=>{if(typeof window>"u")return;const t=window.matchMedia?.("(display-mode: standalone)"),i=()=>L(l.isStandalone());return t?.addEventListener?.("change",i),window.addEventListener("appinstalled",i),()=>{t?.removeEventListener?.("change",i),window.removeEventListener("appinstalled",i)}},[]),a.useEffect(()=>{if(n){p(!1);return}const t=window.setTimeout(()=>{s||p(!0)},r);return()=>window.clearTimeout(t)},[n,r]);const E=l.isIOS(),S=l.isAndroidWithoutPromptApi(),h=O(o,u);let d="none";!w&&!h&&(n?d="native":E?d="ios":(S||m)&&(d="manual"));const v=()=>{typeof window>"u"||window.localStorage.setItem(o,String(Date.now()))},A=async()=>{if(!n)return!1;await n.prompt();const t=await n.userChoice;return t.outcome==="dismissed"&&v(),s=null,c.forEach(i=>i(null)),t.outcome==="accepted"};return{deferredPrompt:n,canInstall:d!=="none",isIOS:E,isStandalone:w,isManualAndroid:S,promptTimedOut:m,method:d,openInChromeIntent:l.buildOpenInChromeIntent(),install:A,recordDecline:v}}exports.useInstallPrompt=_;
+//# sourceMappingURL=use-install-prompt.cjs.map

package/dist/hooks/use-install-prompt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-install-prompt.cjs","sources":["../../src/hooks/use-install-prompt.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport {\n    buildOpenInChromeIntent,\n    isAndroidWithoutPromptApi,\n    isIOS,\n    isStandalone,\n    type BeforeInstallPromptEvent,\n} from \"./pwa-env\";\n\nconst DEFAULT_DECLINE_COOLDOWN_MS = 7 * 24 * 60 * 60 * 1000;\nconst DEFAULT_MANUAL_FALLBACK_DELAY_MS = 3000;\nconst DEFAULT_DECLINE_STORAGE_KEY = \"tempest:install-declined-at\";\n\nlet cachedEvent: BeforeInstallPromptEvent | null = null;\nconst eventSubscribers = new Set<(event: BeforeInstallPromptEvent | null) => void>();\n\nif (typeof window !== \"undefined\") {\n    window.addEventListener(\"beforeinstallprompt\", (event: Event) => {\n        event.preventDefault();\n        cachedEvent = event as BeforeInstallPromptEvent;\n        eventSubscribers.forEach((fn) => fn(cachedEvent));\n    });\n    window.addEventListener(\"appinstalled\", () => {\n        cachedEvent = null;\n        eventSubscribers.forEach((fn) => fn(null));\n    });\n}\n\n/**\n * Strategy the UI should use to install the app:\n *\n * - `\"native\"`: trigger `BeforeInstallPromptEvent.prompt()`.\n * - `\"ios\"`: show iOS Safari Share → Add to Home Screen instructions.\n * - `\"manual\"`: show generic browser-menu instructions (Chromium forks that\n *   strip the prompt API, plus the timeout fallback when no event arrives).\n * - `\"none\"`: nothing to offer (already installed or unsupported runtime).\n */\nexport type InstallMethod = \"native\" | \"ios\" | \"manual\" | \"none\";\n\n/** Options for {@link useInstallPrompt}. */\nexport interface UseInstallPromptOptions {\n    /**\n     * `localStorage` key used to persist the decline timestamp. Defaults to\n     * `\"tempest:install-declined-at\"`.\n     */\n    declineStorageKey?: string;\n    /**\n     * How long, in ms, the install CTA stays hidden after the user declines.\n     * Defaults to 7 days.\n     */\n    declineCooldownMs?: number;\n    /**\n     * How long, in ms, to wait for a `beforeinstallprompt` event before\n     * resolving to the `\"manual\"` method. Defaults to `3000`.\n     */\n    manualFallbackDelayMs?: number;\n}\n\n/** State returned by {@link useInstallPrompt}. */\nexport interface UseInstallPromptResult {\n    /** The cached `beforeinstallprompt` event, or `null` when unavailable. */\n    deferredPrompt: BeforeInstallPromptEvent | null;\n    /** True when the app can be installed through any supported method. */\n    canInstall: boolean;\n    /** True when running on iOS/iPadOS Safari. */\n    isIOS: boolean;\n    /** True when already running as an installed PWA. */\n    isStandalone: boolean;\n    /** True when the browser is an Android Chromium fork with no prompt API. */\n    isManualAndroid: boolean;\n    /** True when no `beforeinstallprompt` arrived within the timeout window. */\n    promptTimedOut: boolean;\n    /** The resolved install strategy the UI should follow. */\n    method: InstallMethod;\n    /** An `intent://` URL to re-open the page in Chrome on Android, else `null`. */\n    openInChromeIntent: string | null;\n    /**\n     * Triggers the native prompt.\n     *\n     * @returns `true` when the user accepted the install, `false` otherwise.\n     */\n    install: () => Promise<boolean>;\n    /** Records that the user declined the CTA, starting the cooldown window. */\n    recordDecline: () => void;\n}\n\nfunction readDecline(key: string, cooldownMs: number): boolean {\n    if (typeof window === \"undefined\") return false;\n    const raw = window.localStorage.getItem(key);\n    if (!raw) return false;\n    const ts = Number(raw);\n    if (!Number.isFinite(ts)) return false;\n    return Date.now() - ts < cooldownMs;\n}\n\n/**\n * React hook that resolves how (and whether) to offer PWA installation.\n *\n * It caches the `beforeinstallprompt` event, detects iOS/iPadOS, detects\n * Android Chromium forks that lack the prompt API, detects standalone display\n * mode, and applies a decline cooldown persisted in `localStorage`. The\n * resulting `method` tells the UI which install affordance to render.\n *\n * The decline persistence is pluggable through\n * {@link UseInstallPromptOptions.declineStorageKey} and\n * {@link UseInstallPromptOptions.declineCooldownMs} — no app-specific storage\n * layer is required, and it is SSR-guarded.\n *\n * @param options - Optional storage key, cooldown, and fallback-delay tuning.\n * @returns The install state plus `install()` and `recordDecline()` actions.\n *\n * @example\n * const { method, install } = useInstallPrompt();\n * if (method === \"native\") return <button onClick={install}>Install</button>;\n */\nexport function useInstallPrompt(options: UseInstallPromptOptions = {}): UseInstallPromptResult {\n    const {\n        declineStorageKey = DEFAULT_DECLINE_STORAGE_KEY,\n        declineCooldownMs = DEFAULT_DECLINE_COOLDOWN_MS,\n        manualFallbackDelayMs = DEFAULT_MANUAL_FALLBACK_DELAY_MS,\n    } = options;\n\n    const [event, setEvent] = useState<BeforeInstallPromptEvent | null>(cachedEvent);\n    const [standalone, setStandalone] = useState<boolean>(isStandalone());\n    const [promptTimedOut, setPromptTimedOut] = useState<boolean>(false);\n\n    useEffect(() => {\n        eventSubscribers.add(setEvent);\n        return () => {\n            eventSubscribers.delete(setEvent);\n        };\n    }, []);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const mq = window.matchMedia?.(\"(display-mode: standalone)\");\n        const handler = (): void => setStandalone(isStandalone());\n        mq?.addEventListener?.(\"change\", handler);\n        window.addEventListener(\"appinstalled\", handler);\n        return () => {\n            mq?.removeEventListener?.(\"change\", handler);\n            window.removeEventListener(\"appinstalled\", handler);\n        };\n    }, []);\n\n    useEffect(() => {\n        if (event) {\n            setPromptTimedOut(false);\n            return;\n        }\n        const timer = window.setTimeout(() => {\n            if (!cachedEvent) setPromptTimedOut(true);\n        }, manualFallbackDelayMs);\n        return () => window.clearTimeout(timer);\n    }, [event, manualFallbackDelayMs]);\n\n    const ios = isIOS();\n    const manualAndroid = isAndroidWithoutPromptApi();\n\n    const declineActive = readDecline(declineStorageKey, declineCooldownMs);\n\n    let method: InstallMethod = \"none\";\n    if (!standalone && !declineActive) {\n        if (event) method = \"native\";\n        else if (ios) method = \"ios\";\n        else if (manualAndroid || promptTimedOut) method = \"manual\";\n    }\n\n    const recordDecline = (): void => {\n        if (typeof window === \"undefined\") return;\n        window.localStorage.setItem(declineStorageKey, String(Date.now()));\n    };\n\n    const install = async (): Promise<boolean> => {\n        if (!event) return false;\n        await event.prompt();\n        const choice = await event.userChoice;\n        if (choice.outcome === \"dismissed\") recordDecline();\n        cachedEvent = null;\n        eventSubscribers.forEach((fn) => fn(null));\n        return choice.outcome === \"accepted\";\n    };\n\n    return {\n        deferredPrompt: event,\n        canInstall: method !== \"none\",\n        isIOS: ios,\n        isStandalone: standalone,\n        isManualAndroid: manualAndroid,\n        promptTimedOut,\n        method,\n        openInChromeIntent: buildOpenInChromeIntent(),\n        install,\n        recordDecline,\n    };\n}\n"],"names":["DEFAULT_DECLINE_COOLDOWN_MS","DEFAULT_MANUAL_FALLBACK_DELAY_MS","DEFAULT_DECLINE_STORAGE_KEY","cachedEvent","eventSubscribers","event","fn","readDecline","key","cooldownMs","raw","ts","useInstallPrompt","options","declineStorageKey","declineCooldownMs","manualFallbackDelayMs","setEvent","useState","standalone","setStandalone","isStandalone","promptTimedOut","setPromptTimedOut","useEffect","mq","handler","timer","ios","isIOS","manualAndroid","isAndroidWithoutPromptApi","declineActive","method","recordDecline","install","choice","buildOpenInChromeIntent"],"mappings":"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"}

package/dist/hooks/use-install-prompt.js

@@ -0,0 +1,69 @@
+import { useState as c, useEffect as u } from "react";
+import { isStandalone as h, isIOS as I, buildOpenInChromeIntent as _, isAndroidWithoutPromptApi as O } from "./pwa-env.js";
+const y = 10080 * 60 * 1e3, C = 3e3, T = "tempest:install-declined-at";
+let r = null;
+const d = /* @__PURE__ */ new Set();
+typeof window < "u" && (window.addEventListener("beforeinstallprompt", (e) => {
+  e.preventDefault(), r = e, d.forEach((o) => o(r));
+}), window.addEventListener("appinstalled", () => {
+  r = null, d.forEach((e) => e(null));
+}));
+function b(e, o) {
+  if (typeof window > "u") return !1;
+  const l = window.localStorage.getItem(e);
+  if (!l) return !1;
+  const a = Number(l);
+  return Number.isFinite(a) ? Date.now() - a < o : !1;
+}
+function F(e = {}) {
+  const {
+    declineStorageKey: o = T,
+    declineCooldownMs: l = y,
+    manualFallbackDelayMs: a = C
+  } = e, [n, f] = c(r), [m, v] = c(h()), [w, p] = c(!1);
+  u(() => (d.add(f), () => {
+    d.delete(f);
+  }), []), u(() => {
+    if (typeof window > "u") return;
+    const t = window.matchMedia?.("(display-mode: standalone)"), i = () => v(h());
+    return t?.addEventListener?.("change", i), window.addEventListener("appinstalled", i), () => {
+      t?.removeEventListener?.("change", i), window.removeEventListener("appinstalled", i);
+    };
+  }, []), u(() => {
+    if (n) {
+      p(!1);
+      return;
+    }
+    const t = window.setTimeout(() => {
+      r || p(!0);
+    }, a);
+    return () => window.clearTimeout(t);
+  }, [n, a]);
+  const E = I(), L = O(), A = b(o, l);
+  let s = "none";
+  !m && !A && (n ? s = "native" : E ? s = "ios" : (L || w) && (s = "manual"));
+  const S = () => {
+    typeof window > "u" || window.localStorage.setItem(o, String(Date.now()));
+  }, D = async () => {
+    if (!n) return !1;
+    await n.prompt();
+    const t = await n.userChoice;
+    return t.outcome === "dismissed" && S(), r = null, d.forEach((i) => i(null)), t.outcome === "accepted";
+  };
+  return {
+    deferredPrompt: n,
+    canInstall: s !== "none",
+    isIOS: E,
+    isStandalone: m,
+    isManualAndroid: L,
+    promptTimedOut: w,
+    method: s,
+    openInChromeIntent: _(),
+    install: D,
+    recordDecline: S
+  };
+}
+export {
+  F as useInstallPrompt
+};
+//# sourceMappingURL=use-install-prompt.js.map

package/dist/hooks/use-install-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-install-prompt.js","sources":["../../src/hooks/use-install-prompt.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport {\n    buildOpenInChromeIntent,\n    isAndroidWithoutPromptApi,\n    isIOS,\n    isStandalone,\n    type BeforeInstallPromptEvent,\n} from \"./pwa-env\";\n\nconst DEFAULT_DECLINE_COOLDOWN_MS = 7 * 24 * 60 * 60 * 1000;\nconst DEFAULT_MANUAL_FALLBACK_DELAY_MS = 3000;\nconst DEFAULT_DECLINE_STORAGE_KEY = \"tempest:install-declined-at\";\n\nlet cachedEvent: BeforeInstallPromptEvent | null = null;\nconst eventSubscribers = new Set<(event: BeforeInstallPromptEvent | null) => void>();\n\nif (typeof window !== \"undefined\") {\n    window.addEventListener(\"beforeinstallprompt\", (event: Event) => {\n        event.preventDefault();\n        cachedEvent = event as BeforeInstallPromptEvent;\n        eventSubscribers.forEach((fn) => fn(cachedEvent));\n    });\n    window.addEventListener(\"appinstalled\", () => {\n        cachedEvent = null;\n        eventSubscribers.forEach((fn) => fn(null));\n    });\n}\n\n/**\n * Strategy the UI should use to install the app:\n *\n * - `\"native\"`: trigger `BeforeInstallPromptEvent.prompt()`.\n * - `\"ios\"`: show iOS Safari Share → Add to Home Screen instructions.\n * - `\"manual\"`: show generic browser-menu instructions (Chromium forks that\n *   strip the prompt API, plus the timeout fallback when no event arrives).\n * - `\"none\"`: nothing to offer (already installed or unsupported runtime).\n */\nexport type InstallMethod = \"native\" | \"ios\" | \"manual\" | \"none\";\n\n/** Options for {@link useInstallPrompt}. */\nexport interface UseInstallPromptOptions {\n    /**\n     * `localStorage` key used to persist the decline timestamp. Defaults to\n     * `\"tempest:install-declined-at\"`.\n     */\n    declineStorageKey?: string;\n    /**\n     * How long, in ms, the install CTA stays hidden after the user declines.\n     * Defaults to 7 days.\n     */\n    declineCooldownMs?: number;\n    /**\n     * How long, in ms, to wait for a `beforeinstallprompt` event before\n     * resolving to the `\"manual\"` method. Defaults to `3000`.\n     */\n    manualFallbackDelayMs?: number;\n}\n\n/** State returned by {@link useInstallPrompt}. */\nexport interface UseInstallPromptResult {\n    /** The cached `beforeinstallprompt` event, or `null` when unavailable. */\n    deferredPrompt: BeforeInstallPromptEvent | null;\n    /** True when the app can be installed through any supported method. */\n    canInstall: boolean;\n    /** True when running on iOS/iPadOS Safari. */\n    isIOS: boolean;\n    /** True when already running as an installed PWA. */\n    isStandalone: boolean;\n    /** True when the browser is an Android Chromium fork with no prompt API. */\n    isManualAndroid: boolean;\n    /** True when no `beforeinstallprompt` arrived within the timeout window. */\n    promptTimedOut: boolean;\n    /** The resolved install strategy the UI should follow. */\n    method: InstallMethod;\n    /** An `intent://` URL to re-open the page in Chrome on Android, else `null`. */\n    openInChromeIntent: string | null;\n    /**\n     * Triggers the native prompt.\n     *\n     * @returns `true` when the user accepted the install, `false` otherwise.\n     */\n    install: () => Promise<boolean>;\n    /** Records that the user declined the CTA, starting the cooldown window. */\n    recordDecline: () => void;\n}\n\nfunction readDecline(key: string, cooldownMs: number): boolean {\n    if (typeof window === \"undefined\") return false;\n    const raw = window.localStorage.getItem(key);\n    if (!raw) return false;\n    const ts = Number(raw);\n    if (!Number.isFinite(ts)) return false;\n    return Date.now() - ts < cooldownMs;\n}\n\n/**\n * React hook that resolves how (and whether) to offer PWA installation.\n *\n * It caches the `beforeinstallprompt` event, detects iOS/iPadOS, detects\n * Android Chromium forks that lack the prompt API, detects standalone display\n * mode, and applies a decline cooldown persisted in `localStorage`. The\n * resulting `method` tells the UI which install affordance to render.\n *\n * The decline persistence is pluggable through\n * {@link UseInstallPromptOptions.declineStorageKey} and\n * {@link UseInstallPromptOptions.declineCooldownMs} — no app-specific storage\n * layer is required, and it is SSR-guarded.\n *\n * @param options - Optional storage key, cooldown, and fallback-delay tuning.\n * @returns The install state plus `install()` and `recordDecline()` actions.\n *\n * @example\n * const { method, install } = useInstallPrompt();\n * if (method === \"native\") return <button onClick={install}>Install</button>;\n */\nexport function useInstallPrompt(options: UseInstallPromptOptions = {}): UseInstallPromptResult {\n    const {\n        declineStorageKey = DEFAULT_DECLINE_STORAGE_KEY,\n        declineCooldownMs = DEFAULT_DECLINE_COOLDOWN_MS,\n        manualFallbackDelayMs = DEFAULT_MANUAL_FALLBACK_DELAY_MS,\n    } = options;\n\n    const [event, setEvent] = useState<BeforeInstallPromptEvent | null>(cachedEvent);\n    const [standalone, setStandalone] = useState<boolean>(isStandalone());\n    const [promptTimedOut, setPromptTimedOut] = useState<boolean>(false);\n\n    useEffect(() => {\n        eventSubscribers.add(setEvent);\n        return () => {\n            eventSubscribers.delete(setEvent);\n        };\n    }, []);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const mq = window.matchMedia?.(\"(display-mode: standalone)\");\n        const handler = (): void => setStandalone(isStandalone());\n        mq?.addEventListener?.(\"change\", handler);\n        window.addEventListener(\"appinstalled\", handler);\n        return () => {\n            mq?.removeEventListener?.(\"change\", handler);\n            window.removeEventListener(\"appinstalled\", handler);\n        };\n    }, []);\n\n    useEffect(() => {\n        if (event) {\n            setPromptTimedOut(false);\n            return;\n        }\n        const timer = window.setTimeout(() => {\n            if (!cachedEvent) setPromptTimedOut(true);\n        }, manualFallbackDelayMs);\n        return () => window.clearTimeout(timer);\n    }, [event, manualFallbackDelayMs]);\n\n    const ios = isIOS();\n    const manualAndroid = isAndroidWithoutPromptApi();\n\n    const declineActive = readDecline(declineStorageKey, declineCooldownMs);\n\n    let method: InstallMethod = \"none\";\n    if (!standalone && !declineActive) {\n        if (event) method = \"native\";\n        else if (ios) method = \"ios\";\n        else if (manualAndroid || promptTimedOut) method = \"manual\";\n    }\n\n    const recordDecline = (): void => {\n        if (typeof window === \"undefined\") return;\n        window.localStorage.setItem(declineStorageKey, String(Date.now()));\n    };\n\n    const install = async (): Promise<boolean> => {\n        if (!event) return false;\n        await event.prompt();\n        const choice = await event.userChoice;\n        if (choice.outcome === \"dismissed\") recordDecline();\n        cachedEvent = null;\n        eventSubscribers.forEach((fn) => fn(null));\n        return choice.outcome === \"accepted\";\n    };\n\n    return {\n        deferredPrompt: event,\n        canInstall: method !== \"none\",\n        isIOS: ios,\n        isStandalone: standalone,\n        isManualAndroid: manualAndroid,\n        promptTimedOut,\n        method,\n        openInChromeIntent: buildOpenInChromeIntent(),\n        install,\n        recordDecline,\n    };\n}\n"],"names":["DEFAULT_DECLINE_COOLDOWN_MS","DEFAULT_MANUAL_FALLBACK_DELAY_MS","DEFAULT_DECLINE_STORAGE_KEY","cachedEvent","eventSubscribers","event","fn","readDecline","key","cooldownMs","raw","ts","useInstallPrompt","options","declineStorageKey","declineCooldownMs","manualFallbackDelayMs","setEvent","useState","standalone","setStandalone","isStandalone","promptTimedOut","setPromptTimedOut","useEffect","mq","handler","timer","ios","isIOS","manualAndroid","isAndroidWithoutPromptApi","declineActive","method","recordDecline","install","choice","buildOpenInChromeIntent"],"mappings":"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"}

package/dist/hooks/use-intersection-observer.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react");function a(n,b={}){const[f,v]=u.useState(null),{once:s=!1,root:o,rootMargin:c,threshold:i}=b;return u.useEffect(()=>{const e=n.current;if(!e||typeof IntersectionObserver>"u")return;const r=new IntersectionObserver(([t])=>{t&&(v(t),s&&t.isIntersecting&&r.unobserve(e))},{root:o,rootMargin:c,threshold:i});return r.observe(e),()=>r.disconnect()},[n,s,o,c,i]),f}exports.useIntersectionObserver=a;
+//# sourceMappingURL=use-intersection-observer.cjs.map

package/dist/hooks/use-intersection-observer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-intersection-observer.cjs","sources":["../../src/hooks/use-intersection-observer.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\nexport interface UseIntersectionObserverOptions extends IntersectionObserverInit {\n    /** Stop observing after the first intersection (one-shot). Default: false. */\n    once?: boolean;\n}\n\n/**\n * Track whether the referenced element intersects the viewport. Useful for\n * lazy-loading images, \"load more\" sentinels, and animation triggers.\n *\n * @returns `IntersectionObserverEntry | null`. `null` until the first observation.\n */\nexport function useIntersectionObserver(\n    ref: RefObject<Element | null>,\n    options: UseIntersectionObserverOptions = {},\n): IntersectionObserverEntry | null {\n    const [entry, setEntry] = useState<IntersectionObserverEntry | null>(null);\n    const { once = false, root, rootMargin, threshold } = options;\n\n    useEffect(() => {\n        const target = ref.current;\n        if (!target || typeof IntersectionObserver === \"undefined\") return;\n\n        const observer = new IntersectionObserver(\n            ([nextEntry]) => {\n                if (!nextEntry) return;\n                setEntry(nextEntry);\n                if (once && nextEntry.isIntersecting) observer.unobserve(target);\n            },\n            { root, rootMargin, threshold },\n        );\n\n        observer.observe(target);\n        return () => observer.disconnect();\n    }, [ref, once, root, rootMargin, threshold]);\n\n    return entry;\n}\n"],"names":["useIntersectionObserver","ref","options","entry","setEntry","useState","once","root","rootMargin","threshold","useEffect","target","observer","nextEntry"],"mappings":"yGAcO,SAASA,EACZC,EACAC,EAA0C,GACV,CAChC,KAAM,CAACC,EAAOC,CAAQ,EAAIC,EAAAA,SAA2C,IAAI,EACnE,CAAE,KAAAC,EAAO,GAAO,KAAAC,EAAM,WAAAC,EAAY,UAAAC,GAAcP,EAEtDQ,OAAAA,EAAAA,UAAU,IAAM,CACZ,MAAMC,EAASV,EAAI,QACnB,GAAI,CAACU,GAAU,OAAO,qBAAyB,IAAa,OAE5D,MAAMC,EAAW,IAAI,qBACjB,CAAC,CAACC,CAAS,IAAM,CACRA,IACLT,EAASS,CAAS,EACdP,GAAQO,EAAU,gBAAgBD,EAAS,UAAUD,CAAM,EACnE,EACA,CAAE,KAAAJ,EAAM,WAAAC,EAAY,UAAAC,CAAA,CAAU,EAGlC,OAAAG,EAAS,QAAQD,CAAM,EAChB,IAAMC,EAAS,WAAA,CAC1B,EAAG,CAACX,EAAKK,EAAMC,EAAMC,EAAYC,CAAS,CAAC,EAEpCN,CACX"}

package/dist/hooks/use-intersection-observer.js

@@ -0,0 +1,19 @@
+import { useState as v, useEffect as a } from "react";
+function l(n, u = {}) {
+  const [f, b] = v(null), { once: o = !1, root: s, rootMargin: c, threshold: i } = u;
+  return a(() => {
+    const e = n.current;
+    if (!e || typeof IntersectionObserver > "u") return;
+    const r = new IntersectionObserver(
+      ([t]) => {
+        t && (b(t), o && t.isIntersecting && r.unobserve(e));
+      },
+      { root: s, rootMargin: c, threshold: i }
+    );
+    return r.observe(e), () => r.disconnect();
+  }, [n, o, s, c, i]), f;
+}
+export {
+  l as useIntersectionObserver
+};
+//# sourceMappingURL=use-intersection-observer.js.map

package/dist/hooks/use-intersection-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-intersection-observer.js","sources":["../../src/hooks/use-intersection-observer.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\nexport interface UseIntersectionObserverOptions extends IntersectionObserverInit {\n    /** Stop observing after the first intersection (one-shot). Default: false. */\n    once?: boolean;\n}\n\n/**\n * Track whether the referenced element intersects the viewport. Useful for\n * lazy-loading images, \"load more\" sentinels, and animation triggers.\n *\n * @returns `IntersectionObserverEntry | null`. `null` until the first observation.\n */\nexport function useIntersectionObserver(\n    ref: RefObject<Element | null>,\n    options: UseIntersectionObserverOptions = {},\n): IntersectionObserverEntry | null {\n    const [entry, setEntry] = useState<IntersectionObserverEntry | null>(null);\n    const { once = false, root, rootMargin, threshold } = options;\n\n    useEffect(() => {\n        const target = ref.current;\n        if (!target || typeof IntersectionObserver === \"undefined\") return;\n\n        const observer = new IntersectionObserver(\n            ([nextEntry]) => {\n                if (!nextEntry) return;\n                setEntry(nextEntry);\n                if (once && nextEntry.isIntersecting) observer.unobserve(target);\n            },\n            { root, rootMargin, threshold },\n        );\n\n        observer.observe(target);\n        return () => observer.disconnect();\n    }, [ref, once, root, rootMargin, threshold]);\n\n    return entry;\n}\n"],"names":["useIntersectionObserver","ref","options","entry","setEntry","useState","once","root","rootMargin","threshold","useEffect","target","observer","nextEntry"],"mappings":";AAcO,SAASA,EACZC,GACAC,IAA0C,IACV;AAChC,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAA2C,IAAI,GACnE,EAAE,MAAAC,IAAO,IAAO,MAAAC,GAAM,YAAAC,GAAY,WAAAC,MAAcP;AAEtD,SAAAQ,EAAU,MAAM;AACZ,UAAMC,IAASV,EAAI;AACnB,QAAI,CAACU,KAAU,OAAO,uBAAyB,IAAa;AAE5D,UAAMC,IAAW,IAAI;AAAA,MACjB,CAAC,CAACC,CAAS,MAAM;AACb,QAAKA,MACLT,EAASS,CAAS,GACdP,KAAQO,EAAU,kBAAgBD,EAAS,UAAUD,CAAM;AAAA,MACnE;AAAA,MACA,EAAE,MAAAJ,GAAM,YAAAC,GAAY,WAAAC,EAAA;AAAA,IAAU;AAGlC,WAAAG,EAAS,QAAQD,CAAM,GAChB,MAAMC,EAAS,WAAA;AAAA,EAC1B,GAAG,CAACX,GAAKK,GAAMC,GAAMC,GAAYC,CAAS,CAAC,GAEpCN;AACX;"}

package/dist/hooks/use-interval.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react");function c(t,e){const r=n.useRef(t);r.current=t,n.useEffect(()=>{if(e===null)return;const u=setInterval(()=>r.current(),e);return()=>clearInterval(u)},[e])}exports.useInterval=c;
+//# sourceMappingURL=use-interval.cjs.map

package/dist/hooks/use-interval.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-interval.cjs","sources":["../../src/hooks/use-interval.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\n/**\n * Reactive `setInterval`. Pass `null` as `delay` to pause. `fn` is stored in\n * a ref so inline callbacks don't reset the interval on every render.\n *\n * @example\n * useInterval(() => poll(), enabled ? 5000 : null);\n */\nexport function useInterval(fn: () => void, delay: number | null): void {\n    const fnRef = useRef(fn);\n    fnRef.current = fn;\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setInterval(() => fnRef.current(), delay);\n        return () => clearInterval(id);\n    }, [delay]);\n}\n"],"names":["useInterval","fn","delay","fnRef","useRef","useEffect","id"],"mappings":"yGASO,SAASA,EAAYC,EAAgBC,EAA4B,CACpE,MAAMC,EAAQC,EAAAA,OAAOH,CAAE,EACvBE,EAAM,QAAUF,EAEhBI,EAAAA,UAAU,IAAM,CACZ,GAAIH,IAAU,KAAM,OACpB,MAAMI,EAAK,YAAY,IAAMH,EAAM,QAAA,EAAWD,CAAK,EACnD,MAAO,IAAM,cAAcI,CAAE,CACjC,EAAG,CAACJ,CAAK,CAAC,CACd"}

package/dist/hooks/use-interval.js

@@ -0,0 +1,13 @@
+import { useRef as u, useEffect as c } from "react";
+function o(e, r) {
+  const t = u(e);
+  t.current = e, c(() => {
+    if (r === null) return;
+    const n = setInterval(() => t.current(), r);
+    return () => clearInterval(n);
+  }, [r]);
+}
+export {
+  o as useInterval
+};
+//# sourceMappingURL=use-interval.js.map

package/dist/hooks/use-interval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-interval.js","sources":["../../src/hooks/use-interval.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\n/**\n * Reactive `setInterval`. Pass `null` as `delay` to pause. `fn` is stored in\n * a ref so inline callbacks don't reset the interval on every render.\n *\n * @example\n * useInterval(() => poll(), enabled ? 5000 : null);\n */\nexport function useInterval(fn: () => void, delay: number | null): void {\n    const fnRef = useRef(fn);\n    fnRef.current = fn;\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setInterval(() => fnRef.current(), delay);\n        return () => clearInterval(id);\n    }, [delay]);\n}\n"],"names":["useInterval","fn","delay","fnRef","useRef","useEffect","id"],"mappings":";AASO,SAASA,EAAYC,GAAgBC,GAA4B;AACpE,QAAMC,IAAQC,EAAOH,CAAE;AACvB,EAAAE,EAAM,UAAUF,GAEhBI,EAAU,MAAM;AACZ,QAAIH,MAAU,KAAM;AACpB,UAAMI,IAAK,YAAY,MAAMH,EAAM,QAAA,GAAWD,CAAK;AACnD,WAAO,MAAM,cAAcI,CAAE;AAAA,EACjC,GAAG,CAACJ,CAAK,CAAC;AACd;"}

package/dist/hooks/use-is-first-render.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react");function t(){const e=r.useRef(!0);return e.current?(e.current=!1,!0):!1}exports.useIsFirstRender=t;
+//# sourceMappingURL=use-is-first-render.cjs.map

package/dist/hooks/use-is-first-render.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-first-render.cjs","sources":["../../src/hooks/use-is-first-render.ts"],"sourcesContent":["import { useRef } from \"react\";\n\n/**\n * Return `true` on the first render of the component and `false` thereafter.\n *\n * @returns Whether the current render is the first one.\n */\nexport function useIsFirstRender(): boolean {\n    const isFirst = useRef<boolean>(true);\n    if (isFirst.current) {\n        isFirst.current = false;\n        return true;\n    }\n    return false;\n}\n"],"names":["useIsFirstRender","isFirst","useRef"],"mappings":"yGAOO,SAASA,GAA4B,CACxC,MAAMC,EAAUC,EAAAA,OAAgB,EAAI,EACpC,OAAID,EAAQ,SACRA,EAAQ,QAAU,GACX,IAEJ,EACX"}

package/dist/hooks/use-is-first-render.js

@@ -0,0 +1,9 @@
+import { useRef as e } from "react";
+function s() {
+  const r = e(!0);
+  return r.current ? (r.current = !1, !0) : !1;
+}
+export {
+  s as useIsFirstRender
+};
+//# sourceMappingURL=use-is-first-render.js.map

package/dist/hooks/use-is-first-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-first-render.js","sources":["../../src/hooks/use-is-first-render.ts"],"sourcesContent":["import { useRef } from \"react\";\n\n/**\n * Return `true` on the first render of the component and `false` thereafter.\n *\n * @returns Whether the current render is the first one.\n */\nexport function useIsFirstRender(): boolean {\n    const isFirst = useRef<boolean>(true);\n    if (isFirst.current) {\n        isFirst.current = false;\n        return true;\n    }\n    return false;\n}\n"],"names":["useIsFirstRender","isFirst","useRef"],"mappings":";AAOO,SAASA,IAA4B;AACxC,QAAMC,IAAUC,EAAgB,EAAI;AACpC,SAAID,EAAQ,WACRA,EAAQ,UAAU,IACX,MAEJ;AACX;"}

package/dist/hooks/use-keyboard-shortcut.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react");function l(e,t){if(e.key.toLowerCase()!==t.key.toLowerCase())return!1;const a=!!t.ctrl,r=!!t.meta,n=!!t.shift,i=!!t.alt;if(t.mod){if(!e.ctrlKey&&!e.metaKey)return!1}else if(e.ctrlKey!==a||e.metaKey!==r)return!1;return!(e.shiftKey!==n||e.altKey!==i)}function o(e){if(!(e instanceof HTMLElement))return!1;const t=e.tagName.toLowerCase();return t==="input"||t==="textarea"||t==="select"?!0:e.isContentEditable}function u(e,t,a={}){const{disabled:r=!1,ignoreInput:n=!0}=a;s.useEffect(()=>{if(r||typeof window>"u")return;const i=f=>{n&&o(f.target)||l(f,e)&&t(f)};return window.addEventListener("keydown",i),()=>window.removeEventListener("keydown",i)},[r,n,e.key,e.ctrl,e.meta,e.shift,e.alt,e.mod,t])}exports.useKeyboardShortcut=u;
+//# sourceMappingURL=use-keyboard-shortcut.cjs.map

package/dist/hooks/use-keyboard-shortcut.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-keyboard-shortcut.cjs","sources":["../../src/hooks/use-keyboard-shortcut.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\nexport interface KeyboardShortcut {\n    /** Key name (`\"k\"`, `\"Enter\"`, `\"Escape\"`, `\"ArrowDown\"`, etc.). Case-insensitive. */\n    key: string;\n    ctrl?: boolean;\n    meta?: boolean;\n    shift?: boolean;\n    alt?: boolean;\n    /** Match either Ctrl or Cmd. Useful for cross-OS shortcuts. */\n    mod?: boolean;\n}\n\nexport interface UseKeyboardShortcutOptions {\n    /** Disable the shortcut without unmounting. Default: false. */\n    disabled?: boolean;\n    /** Listen to the entire window. Pass `false` to scope to a specific element via the handler. Default: true. */\n    global?: boolean;\n    /** Suppress the event from firing inside `<input>`/`<textarea>`/`[contenteditable]`. Default: true. */\n    ignoreInput?: boolean;\n}\n\nfunction matches(event: KeyboardEvent, shortcut: KeyboardShortcut): boolean {\n    if (event.key.toLowerCase() !== shortcut.key.toLowerCase()) return false;\n    const ctrl = !!shortcut.ctrl;\n    const meta = !!shortcut.meta;\n    const shift = !!shortcut.shift;\n    const alt = !!shortcut.alt;\n    if (shortcut.mod) {\n        if (!event.ctrlKey && !event.metaKey) return false;\n    } else {\n        if (event.ctrlKey !== ctrl) return false;\n        if (event.metaKey !== meta) return false;\n    }\n    if (event.shiftKey !== shift) return false;\n    if (event.altKey !== alt) return false;\n    return true;\n}\n\nfunction isEditable(target: EventTarget | null): boolean {\n    if (!(target instanceof HTMLElement)) return false;\n    const tag = target.tagName.toLowerCase();\n    if (tag === \"input\" || tag === \"textarea\" || tag === \"select\") return true;\n    return target.isContentEditable;\n}\n\n/**\n * Bind a global keyboard shortcut. Supports modifier combinations and a\n * cross-OS `mod` key (Ctrl on Windows/Linux, Cmd on macOS).\n *\n * The effect depends on the individual `shortcut` fields rather than on the\n * object itself: callers pass an inline literal (`{ key: \"k\", mod: true }`),\n * which is a fresh reference on every render and would otherwise tear down and\n * re-add the listener each time. `exhaustive-deps` is silenced for that line\n * because the destructured fields are the complete dependency set.\n *\n * @example\n * useKeyboardShortcut({ key: \"k\", mod: true }, () => openSearch());\n */\nexport function useKeyboardShortcut(\n    shortcut: KeyboardShortcut,\n    handler: (event: KeyboardEvent) => void,\n    options: UseKeyboardShortcutOptions = {},\n): void {\n    const { disabled = false, ignoreInput = true } = options;\n\n    useEffect(() => {\n        if (disabled || typeof window === \"undefined\") return;\n        const listener = (event: KeyboardEvent): void => {\n            if (ignoreInput && isEditable(event.target)) return;\n            if (matches(event, shortcut)) handler(event);\n        };\n        window.addEventListener(\"keydown\", listener);\n        return () => window.removeEventListener(\"keydown\", listener);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n        disabled,\n        ignoreInput,\n        shortcut.key,\n        shortcut.ctrl,\n        shortcut.meta,\n        shortcut.shift,\n        shortcut.alt,\n        shortcut.mod,\n        handler,\n    ]);\n}\n"],"names":["matches","event","shortcut","ctrl","meta","shift","alt","isEditable","target","tag","useKeyboardShortcut","handler","options","disabled","ignoreInput","useEffect","listener"],"mappings":"yGAsBA,SAASA,EAAQC,EAAsBC,EAAqC,CACxE,GAAID,EAAM,IAAI,YAAA,IAAkBC,EAAS,IAAI,YAAA,EAAe,MAAO,GACnE,MAAMC,EAAO,CAAC,CAACD,EAAS,KAClBE,EAAO,CAAC,CAACF,EAAS,KAClBG,EAAQ,CAAC,CAACH,EAAS,MACnBI,EAAM,CAAC,CAACJ,EAAS,IACvB,GAAIA,EAAS,KACT,GAAI,CAACD,EAAM,SAAW,CAACA,EAAM,QAAS,MAAO,WAEzCA,EAAM,UAAYE,GAClBF,EAAM,UAAYG,EAAM,MAAO,GAGvC,MADI,EAAAH,EAAM,WAAaI,GACnBJ,EAAM,SAAWK,EAEzB,CAEA,SAASC,EAAWC,EAAqC,CACrD,GAAI,EAAEA,aAAkB,aAAc,MAAO,GAC7C,MAAMC,EAAMD,EAAO,QAAQ,YAAA,EAC3B,OAAIC,IAAQ,SAAWA,IAAQ,YAAcA,IAAQ,SAAiB,GAC/DD,EAAO,iBAClB,CAeO,SAASE,EACZR,EACAS,EACAC,EAAsC,CAAA,EAClC,CACJ,KAAM,CAAE,SAAAC,EAAW,GAAO,YAAAC,EAAc,IAASF,EAEjDG,EAAAA,UAAU,IAAM,CACZ,GAAIF,GAAY,OAAO,OAAW,IAAa,OAC/C,MAAMG,EAAYf,GAA+B,CACzCa,GAAeP,EAAWN,EAAM,MAAM,GACtCD,EAAQC,EAAOC,CAAQ,KAAWD,CAAK,CAC/C,EACA,cAAO,iBAAiB,UAAWe,CAAQ,EACpC,IAAM,OAAO,oBAAoB,UAAWA,CAAQ,CAE/D,EAAG,CACCH,EACAC,EACAZ,EAAS,IACTA,EAAS,KACTA,EAAS,KACTA,EAAS,MACTA,EAAS,IACTA,EAAS,IACTS,CAAA,CACH,CACL"}

package/dist/hooks/use-keyboard-shortcut.js

@@ -0,0 +1,38 @@
+import { useEffect as l } from "react";
+function s(e, t) {
+  if (e.key.toLowerCase() !== t.key.toLowerCase()) return !1;
+  const f = !!t.ctrl, n = !!t.meta, i = !!t.shift, r = !!t.alt;
+  if (t.mod) {
+    if (!e.ctrlKey && !e.metaKey) return !1;
+  } else if (e.ctrlKey !== f || e.metaKey !== n) return !1;
+  return !(e.shiftKey !== i || e.altKey !== r);
+}
+function o(e) {
+  if (!(e instanceof HTMLElement)) return !1;
+  const t = e.tagName.toLowerCase();
+  return t === "input" || t === "textarea" || t === "select" ? !0 : e.isContentEditable;
+}
+function u(e, t, f = {}) {
+  const { disabled: n = !1, ignoreInput: i = !0 } = f;
+  l(() => {
+    if (n || typeof window > "u") return;
+    const r = (a) => {
+      i && o(a.target) || s(a, e) && t(a);
+    };
+    return window.addEventListener("keydown", r), () => window.removeEventListener("keydown", r);
+  }, [
+    n,
+    i,
+    e.key,
+    e.ctrl,
+    e.meta,
+    e.shift,
+    e.alt,
+    e.mod,
+    t
+  ]);
+}
+export {
+  u as useKeyboardShortcut
+};
+//# sourceMappingURL=use-keyboard-shortcut.js.map

package/dist/hooks/use-keyboard-shortcut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-keyboard-shortcut.js","sources":["../../src/hooks/use-keyboard-shortcut.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\nexport interface KeyboardShortcut {\n    /** Key name (`\"k\"`, `\"Enter\"`, `\"Escape\"`, `\"ArrowDown\"`, etc.). Case-insensitive. */\n    key: string;\n    ctrl?: boolean;\n    meta?: boolean;\n    shift?: boolean;\n    alt?: boolean;\n    /** Match either Ctrl or Cmd. Useful for cross-OS shortcuts. */\n    mod?: boolean;\n}\n\nexport interface UseKeyboardShortcutOptions {\n    /** Disable the shortcut without unmounting. Default: false. */\n    disabled?: boolean;\n    /** Listen to the entire window. Pass `false` to scope to a specific element via the handler. Default: true. */\n    global?: boolean;\n    /** Suppress the event from firing inside `<input>`/`<textarea>`/`[contenteditable]`. Default: true. */\n    ignoreInput?: boolean;\n}\n\nfunction matches(event: KeyboardEvent, shortcut: KeyboardShortcut): boolean {\n    if (event.key.toLowerCase() !== shortcut.key.toLowerCase()) return false;\n    const ctrl = !!shortcut.ctrl;\n    const meta = !!shortcut.meta;\n    const shift = !!shortcut.shift;\n    const alt = !!shortcut.alt;\n    if (shortcut.mod) {\n        if (!event.ctrlKey && !event.metaKey) return false;\n    } else {\n        if (event.ctrlKey !== ctrl) return false;\n        if (event.metaKey !== meta) return false;\n    }\n    if (event.shiftKey !== shift) return false;\n    if (event.altKey !== alt) return false;\n    return true;\n}\n\nfunction isEditable(target: EventTarget | null): boolean {\n    if (!(target instanceof HTMLElement)) return false;\n    const tag = target.tagName.toLowerCase();\n    if (tag === \"input\" || tag === \"textarea\" || tag === \"select\") return true;\n    return target.isContentEditable;\n}\n\n/**\n * Bind a global keyboard shortcut. Supports modifier combinations and a\n * cross-OS `mod` key (Ctrl on Windows/Linux, Cmd on macOS).\n *\n * The effect depends on the individual `shortcut` fields rather than on the\n * object itself: callers pass an inline literal (`{ key: \"k\", mod: true }`),\n * which is a fresh reference on every render and would otherwise tear down and\n * re-add the listener each time. `exhaustive-deps` is silenced for that line\n * because the destructured fields are the complete dependency set.\n *\n * @example\n * useKeyboardShortcut({ key: \"k\", mod: true }, () => openSearch());\n */\nexport function useKeyboardShortcut(\n    shortcut: KeyboardShortcut,\n    handler: (event: KeyboardEvent) => void,\n    options: UseKeyboardShortcutOptions = {},\n): void {\n    const { disabled = false, ignoreInput = true } = options;\n\n    useEffect(() => {\n        if (disabled || typeof window === \"undefined\") return;\n        const listener = (event: KeyboardEvent): void => {\n            if (ignoreInput && isEditable(event.target)) return;\n            if (matches(event, shortcut)) handler(event);\n        };\n        window.addEventListener(\"keydown\", listener);\n        return () => window.removeEventListener(\"keydown\", listener);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n        disabled,\n        ignoreInput,\n        shortcut.key,\n        shortcut.ctrl,\n        shortcut.meta,\n        shortcut.shift,\n        shortcut.alt,\n        shortcut.mod,\n        handler,\n    ]);\n}\n"],"names":["matches","event","shortcut","ctrl","meta","shift","alt","isEditable","target","tag","useKeyboardShortcut","handler","options","disabled","ignoreInput","useEffect","listener"],"mappings":";AAsBA,SAASA,EAAQC,GAAsBC,GAAqC;AACxE,MAAID,EAAM,IAAI,YAAA,MAAkBC,EAAS,IAAI,YAAA,EAAe,QAAO;AACnE,QAAMC,IAAO,CAAC,CAACD,EAAS,MAClBE,IAAO,CAAC,CAACF,EAAS,MAClBG,IAAQ,CAAC,CAACH,EAAS,OACnBI,IAAM,CAAC,CAACJ,EAAS;AACvB,MAAIA,EAAS;AACT,QAAI,CAACD,EAAM,WAAW,CAACA,EAAM,QAAS,QAAO;AAAA,aAEzCA,EAAM,YAAYE,KAClBF,EAAM,YAAYG,EAAM,QAAO;AAGvC,SADI,EAAAH,EAAM,aAAaI,KACnBJ,EAAM,WAAWK;AAEzB;AAEA,SAASC,EAAWC,GAAqC;AACrD,MAAI,EAAEA,aAAkB,aAAc,QAAO;AAC7C,QAAMC,IAAMD,EAAO,QAAQ,YAAA;AAC3B,SAAIC,MAAQ,WAAWA,MAAQ,cAAcA,MAAQ,WAAiB,KAC/DD,EAAO;AAClB;AAeO,SAASE,EACZR,GACAS,GACAC,IAAsC,CAAA,GAClC;AACJ,QAAM,EAAE,UAAAC,IAAW,IAAO,aAAAC,IAAc,OAASF;AAEjD,EAAAG,EAAU,MAAM;AACZ,QAAIF,KAAY,OAAO,SAAW,IAAa;AAC/C,UAAMG,IAAW,CAACf,MAA+B;AAC7C,MAAIa,KAAeP,EAAWN,EAAM,MAAM,KACtCD,EAAQC,GAAOC,CAAQ,OAAWD,CAAK;AAAA,IAC/C;AACA,kBAAO,iBAAiB,WAAWe,CAAQ,GACpC,MAAM,OAAO,oBAAoB,WAAWA,CAAQ;AAAA,EAE/D,GAAG;AAAA,IACCH;AAAA,IACAC;AAAA,IACAZ,EAAS;AAAA,IACTA,EAAS;AAAA,IACTA,EAAS;AAAA,IACTA,EAAS;AAAA,IACTA,EAAS;AAAA,IACTA,EAAS;AAAA,IACTS;AAAA,EAAA,CACH;AACL;"}

package/dist/hooks/use-list-state.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react");function v(m=[]){const[S,a]=t.useState(m),o=t.useCallback((...e)=>{a(s=>[...s,...e])},[]),r=t.useCallback((...e)=>{a(s=>[...e,...s])},[]),u=t.useCallback((e,...s)=>{a(c=>[...c.slice(0,e),...s,...c.slice(e)])},[]),i=t.useCallback((...e)=>{const s=new Set(e);a(c=>c.filter((l,n)=>!s.has(n)))},[]),p=t.useCallback(({from:e,to:s})=>{a(c=>{const l=[...c],[n]=l.splice(e,1);return l.splice(s,0,n),l})},[]),b=t.useCallback((e,s)=>{a(c=>c.map((l,n)=>n===e?s:l))},[]),k=t.useCallback(e=>a(e),[]),C=t.useCallback(e=>{a(s=>s.map(e))},[]),d=t.useCallback(()=>a([]),[]),f=t.useMemo(()=>({append:o,prepend:r,insert:u,remove:i,reorder:p,setItem:b,setState:k,apply:C,clear:d}),[o,r,u,i,p,b,k,C,d]);return[S,f]}exports.useListState=v;
+//# sourceMappingURL=use-list-state.cjs.map

package/dist/hooks/use-list-state.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-list-state.cjs","sources":["../../src/hooks/use-list-state.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\n\nexport interface ReorderPayload {\n    from: number;\n    to: number;\n}\n\nexport interface ListStateHandlers<T> {\n    append: (...items: T[]) => void;\n    prepend: (...items: T[]) => void;\n    insert: (index: number, ...items: T[]) => void;\n    remove: (...indices: number[]) => void;\n    reorder: (payload: ReorderPayload) => void;\n    setItem: (index: number, item: T) => void;\n    setState: (items: T[]) => void;\n    apply: (fn: (item: T, index: number) => T) => void;\n    clear: () => void;\n}\n\n/**\n * Manage an array as state with a rich set of immutable handlers.\n *\n * @typeParam T - element type.\n * @param initial - initial list (default `[]`).\n * @returns Tuple `[list, handlers]`.\n */\nexport function useListState<T>(initial: T[] = []): [T[], ListStateHandlers<T>] {\n    const [list, setList] = useState<T[]>(initial);\n\n    const append = useCallback((...items: T[]): void => {\n        setList((current) => [...current, ...items]);\n    }, []);\n\n    const prepend = useCallback((...items: T[]): void => {\n        setList((current) => [...items, ...current]);\n    }, []);\n\n    const insert = useCallback((index: number, ...items: T[]): void => {\n        setList((current) => [...current.slice(0, index), ...items, ...current.slice(index)]);\n    }, []);\n\n    const remove = useCallback((...indices: number[]): void => {\n        const drop = new Set(indices);\n        setList((current) => current.filter((_, index) => !drop.has(index)));\n    }, []);\n\n    const reorder = useCallback(({ from, to }: ReorderPayload): void => {\n        setList((current) => {\n            const next = [...current];\n            const [moved] = next.splice(from, 1);\n            next.splice(to, 0, moved);\n            return next;\n        });\n    }, []);\n\n    const setItem = useCallback((index: number, item: T): void => {\n        setList((current) => current.map((value, i) => (i === index ? item : value)));\n    }, []);\n\n    const setState = useCallback((items: T[]): void => setList(items), []);\n\n    const apply = useCallback((fn: (item: T, index: number) => T): void => {\n        setList((current) => current.map(fn));\n    }, []);\n\n    const clear = useCallback((): void => setList([]), []);\n\n    const handlers = useMemo<ListStateHandlers<T>>(\n        () => ({\n            append,\n            prepend,\n            insert,\n            remove,\n            reorder,\n            setItem,\n            setState,\n            apply,\n            clear,\n        }),\n        [append, prepend, insert, remove, reorder, setItem, setState, apply, clear],\n    );\n\n    return [list, handlers];\n}\n"],"names":["useListState","initial","list","setList","useState","append","useCallback","items","current","prepend","insert","index","remove","indices","drop","_","reorder","from","to","next","moved","setItem","item","value","i","setState","apply","fn","clear","handlers","useMemo"],"mappings":"yGA0BO,SAASA,EAAgBC,EAAe,GAAiC,CAC5E,KAAM,CAACC,EAAMC,CAAO,EAAIC,EAAAA,SAAcH,CAAO,EAEvCI,EAASC,EAAAA,YAAY,IAAIC,IAAqB,CAChDJ,EAASK,GAAY,CAAC,GAAGA,EAAS,GAAGD,CAAK,CAAC,CAC/C,EAAG,CAAA,CAAE,EAECE,EAAUH,EAAAA,YAAY,IAAIC,IAAqB,CACjDJ,EAASK,GAAY,CAAC,GAAGD,EAAO,GAAGC,CAAO,CAAC,CAC/C,EAAG,CAAA,CAAE,EAECE,EAASJ,EAAAA,YAAY,CAACK,KAAkBJ,IAAqB,CAC/DJ,EAASK,GAAY,CAAC,GAAGA,EAAQ,MAAM,EAAGG,CAAK,EAAG,GAAGJ,EAAO,GAAGC,EAAQ,MAAMG,CAAK,CAAC,CAAC,CACxF,EAAG,CAAA,CAAE,EAECC,EAASN,EAAAA,YAAY,IAAIO,IAA4B,CACvD,MAAMC,EAAO,IAAI,IAAID,CAAO,EAC5BV,EAASK,GAAYA,EAAQ,OAAO,CAACO,EAAGJ,IAAU,CAACG,EAAK,IAAIH,CAAK,CAAC,CAAC,CACvE,EAAG,CAAA,CAAE,EAECK,EAAUV,EAAAA,YAAY,CAAC,CAAE,KAAAW,EAAM,GAAAC,KAA+B,CAChEf,EAASK,GAAY,CACjB,MAAMW,EAAO,CAAC,GAAGX,CAAO,EAClB,CAACY,CAAK,EAAID,EAAK,OAAOF,EAAM,CAAC,EACnC,OAAAE,EAAK,OAAOD,EAAI,EAAGE,CAAK,EACjBD,CACX,CAAC,CACL,EAAG,CAAA,CAAE,EAECE,EAAUf,EAAAA,YAAY,CAACK,EAAeW,IAAkB,CAC1DnB,EAASK,GAAYA,EAAQ,IAAI,CAACe,EAAOC,IAAOA,IAAMb,EAAQW,EAAOC,CAAM,CAAC,CAChF,EAAG,CAAA,CAAE,EAECE,EAAWnB,EAAAA,YAAaC,GAAqBJ,EAAQI,CAAK,EAAG,EAAE,EAE/DmB,EAAQpB,cAAaqB,GAA4C,CACnExB,EAASK,GAAYA,EAAQ,IAAImB,CAAE,CAAC,CACxC,EAAG,CAAA,CAAE,EAECC,EAAQtB,EAAAA,YAAY,IAAYH,EAAQ,CAAA,CAAE,EAAG,CAAA,CAAE,EAE/C0B,EAAWC,EAAAA,QACb,KAAO,CACH,OAAAzB,EACA,QAAAI,EACA,OAAAC,EACA,OAAAE,EACA,QAAAI,EACA,QAAAK,EACA,SAAAI,EACA,MAAAC,EACA,MAAAE,CAAA,GAEJ,CAACvB,EAAQI,EAASC,EAAQE,EAAQI,EAASK,EAASI,EAAUC,EAAOE,CAAK,CAAA,EAG9E,MAAO,CAAC1B,EAAM2B,CAAQ,CAC1B"}

package/dist/hooks/use-list-state.js

@@ -0,0 +1,40 @@
+import { useState as b, useCallback as o, useMemo as k } from "react";
+function x(h = []) {
+  const [v, s] = b(h), p = o((...t) => {
+    s((e) => [...e, ...t]);
+  }, []), a = o((...t) => {
+    s((e) => [...t, ...e]);
+  }, []), l = o((t, ...e) => {
+    s((n) => [...n.slice(0, t), ...e, ...n.slice(t)]);
+  }, []), i = o((...t) => {
+    const e = new Set(t);
+    s((n) => n.filter((c, r) => !e.has(r)));
+  }, []), m = o(({ from: t, to: e }) => {
+    s((n) => {
+      const c = [...n], [r] = c.splice(t, 1);
+      return c.splice(e, 0, r), c;
+    });
+  }, []), u = o((t, e) => {
+    s((n) => n.map((c, r) => r === t ? e : c));
+  }, []), d = o((t) => s(t), []), S = o((t) => {
+    s((e) => e.map(t));
+  }, []), f = o(() => s([]), []), L = k(
+    () => ({
+      append: p,
+      prepend: a,
+      insert: l,
+      remove: i,
+      reorder: m,
+      setItem: u,
+      setState: d,
+      apply: S,
+      clear: f
+    }),
+    [p, a, l, i, m, u, d, S, f]
+  );
+  return [v, L];
+}
+export {
+  x as useListState
+};
+//# sourceMappingURL=use-list-state.js.map

package/dist/hooks/use-list-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-list-state.js","sources":["../../src/hooks/use-list-state.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\n\nexport interface ReorderPayload {\n    from: number;\n    to: number;\n}\n\nexport interface ListStateHandlers<T> {\n    append: (...items: T[]) => void;\n    prepend: (...items: T[]) => void;\n    insert: (index: number, ...items: T[]) => void;\n    remove: (...indices: number[]) => void;\n    reorder: (payload: ReorderPayload) => void;\n    setItem: (index: number, item: T) => void;\n    setState: (items: T[]) => void;\n    apply: (fn: (item: T, index: number) => T) => void;\n    clear: () => void;\n}\n\n/**\n * Manage an array as state with a rich set of immutable handlers.\n *\n * @typeParam T - element type.\n * @param initial - initial list (default `[]`).\n * @returns Tuple `[list, handlers]`.\n */\nexport function useListState<T>(initial: T[] = []): [T[], ListStateHandlers<T>] {\n    const [list, setList] = useState<T[]>(initial);\n\n    const append = useCallback((...items: T[]): void => {\n        setList((current) => [...current, ...items]);\n    }, []);\n\n    const prepend = useCallback((...items: T[]): void => {\n        setList((current) => [...items, ...current]);\n    }, []);\n\n    const insert = useCallback((index: number, ...items: T[]): void => {\n        setList((current) => [...current.slice(0, index), ...items, ...current.slice(index)]);\n    }, []);\n\n    const remove = useCallback((...indices: number[]): void => {\n        const drop = new Set(indices);\n        setList((current) => current.filter((_, index) => !drop.has(index)));\n    }, []);\n\n    const reorder = useCallback(({ from, to }: ReorderPayload): void => {\n        setList((current) => {\n            const next = [...current];\n            const [moved] = next.splice(from, 1);\n            next.splice(to, 0, moved);\n            return next;\n        });\n    }, []);\n\n    const setItem = useCallback((index: number, item: T): void => {\n        setList((current) => current.map((value, i) => (i === index ? item : value)));\n    }, []);\n\n    const setState = useCallback((items: T[]): void => setList(items), []);\n\n    const apply = useCallback((fn: (item: T, index: number) => T): void => {\n        setList((current) => current.map(fn));\n    }, []);\n\n    const clear = useCallback((): void => setList([]), []);\n\n    const handlers = useMemo<ListStateHandlers<T>>(\n        () => ({\n            append,\n            prepend,\n            insert,\n            remove,\n            reorder,\n            setItem,\n            setState,\n            apply,\n            clear,\n        }),\n        [append, prepend, insert, remove, reorder, setItem, setState, apply, clear],\n    );\n\n    return [list, handlers];\n}\n"],"names":["useListState","initial","list","setList","useState","append","useCallback","items","current","prepend","insert","index","remove","indices","drop","_","reorder","from","to","next","moved","setItem","item","value","i","setState","apply","fn","clear","handlers","useMemo"],"mappings":";AA0BO,SAASA,EAAgBC,IAAe,IAAiC;AAC5E,QAAM,CAACC,GAAMC,CAAO,IAAIC,EAAcH,CAAO,GAEvCI,IAASC,EAAY,IAAIC,MAAqB;AAChD,IAAAJ,EAAQ,CAACK,MAAY,CAAC,GAAGA,GAAS,GAAGD,CAAK,CAAC;AAAA,EAC/C,GAAG,CAAA,CAAE,GAECE,IAAUH,EAAY,IAAIC,MAAqB;AACjD,IAAAJ,EAAQ,CAACK,MAAY,CAAC,GAAGD,GAAO,GAAGC,CAAO,CAAC;AAAA,EAC/C,GAAG,CAAA,CAAE,GAECE,IAASJ,EAAY,CAACK,MAAkBJ,MAAqB;AAC/D,IAAAJ,EAAQ,CAACK,MAAY,CAAC,GAAGA,EAAQ,MAAM,GAAGG,CAAK,GAAG,GAAGJ,GAAO,GAAGC,EAAQ,MAAMG,CAAK,CAAC,CAAC;AAAA,EACxF,GAAG,CAAA,CAAE,GAECC,IAASN,EAAY,IAAIO,MAA4B;AACvD,UAAMC,IAAO,IAAI,IAAID,CAAO;AAC5B,IAAAV,EAAQ,CAACK,MAAYA,EAAQ,OAAO,CAACO,GAAGJ,MAAU,CAACG,EAAK,IAAIH,CAAK,CAAC,CAAC;AAAA,EACvE,GAAG,CAAA,CAAE,GAECK,IAAUV,EAAY,CAAC,EAAE,MAAAW,GAAM,IAAAC,QAA+B;AAChE,IAAAf,EAAQ,CAACK,MAAY;AACjB,YAAMW,IAAO,CAAC,GAAGX,CAAO,GAClB,CAACY,CAAK,IAAID,EAAK,OAAOF,GAAM,CAAC;AACnC,aAAAE,EAAK,OAAOD,GAAI,GAAGE,CAAK,GACjBD;AAAA,IACX,CAAC;AAAA,EACL,GAAG,CAAA,CAAE,GAECE,IAAUf,EAAY,CAACK,GAAeW,MAAkB;AAC1D,IAAAnB,EAAQ,CAACK,MAAYA,EAAQ,IAAI,CAACe,GAAOC,MAAOA,MAAMb,IAAQW,IAAOC,CAAM,CAAC;AAAA,EAChF,GAAG,CAAA,CAAE,GAECE,IAAWnB,EAAY,CAACC,MAAqBJ,EAAQI,CAAK,GAAG,EAAE,GAE/DmB,IAAQpB,EAAY,CAACqB,MAA4C;AACnE,IAAAxB,EAAQ,CAACK,MAAYA,EAAQ,IAAImB,CAAE,CAAC;AAAA,EACxC,GAAG,CAAA,CAAE,GAECC,IAAQtB,EAAY,MAAYH,EAAQ,CAAA,CAAE,GAAG,CAAA,CAAE,GAE/C0B,IAAWC;AAAA,IACb,OAAO;AAAA,MACH,QAAAzB;AAAA,MACA,SAAAI;AAAA,MACA,QAAAC;AAAA,MACA,QAAAE;AAAA,MACA,SAAAI;AAAA,MACA,SAAAK;AAAA,MACA,UAAAI;AAAA,MACA,OAAAC;AAAA,MACA,OAAAE;AAAA,IAAA;AAAA,IAEJ,CAACvB,GAAQI,GAASC,GAAQE,GAAQI,GAASK,GAASI,GAAUC,GAAOE,CAAK;AAAA,EAAA;AAG9E,SAAO,CAAC1B,GAAM2B,CAAQ;AAC1B;"}

package/dist/hooks/use-local-storage.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react"),S=JSON.stringify,g=e=>JSON.parse(e);function m(e,r,a={}){const u=a.serialize??S,s=a.deserialize??g,c=n.useCallback(()=>{if(typeof window>"u")return r;try{const t=window.localStorage.getItem(e);return t===null?r:s(t)}catch{return r}},[e,r,s]),[w,o]=n.useState(c);n.useEffect(()=>{o(c())},[c]);const l=n.useCallback(t=>{o(i=>{const d=typeof t=="function"?t(i):t;try{typeof window<"u"&&window.localStorage.setItem(e,u(d))}catch{}return d})},[e,u]),f=n.useCallback(()=>{try{typeof window<"u"&&window.localStorage.removeItem(e)}catch{}o(r)},[e,r]);return n.useEffect(()=>{if(typeof window>"u")return;const t=i=>{if(i.key===e){if(i.newValue===null){o(r);return}try{o(s(i.newValue))}catch{}}};return window.addEventListener("storage",t),()=>window.removeEventListener("storage",t)},[e,r,s]),[w,l,f]}exports.useLocalStorage=m;
+//# sourceMappingURL=use-local-storage.cjs.map

package/dist/hooks/use-local-storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-local-storage.cjs","sources":["../../src/hooks/use-local-storage.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\nexport type LocalStorageOptions<T> = {\n    serialize?: (value: T) => string;\n    deserialize?: (raw: string) => T;\n};\n\nconst defaultSerialize = JSON.stringify;\nconst defaultDeserialize = <T>(raw: string): T => JSON.parse(raw) as T;\n\n/**\n * State synced with `localStorage`. SSR-safe — initial render returns the\n * provided default; the stored value is hydrated after mount. Updates to the\n * same key in other tabs are picked up via the `storage` event.\n *\n * @param key - localStorage key.\n * @param defaultValue - value used when nothing is stored or in SSR.\n * @param options - custom `serialize` / `deserialize` (default JSON).\n * @returns Tuple `[value, setValue, remove]`.\n */\nexport function useLocalStorage<T>(\n    key: string,\n    defaultValue: T,\n    options: LocalStorageOptions<T> = {},\n): [T, (value: T | ((prev: T) => T)) => void, () => void] {\n    const serialize = options.serialize ?? defaultSerialize;\n    const deserialize = options.deserialize ?? defaultDeserialize;\n\n    const read = useCallback((): T => {\n        if (typeof window === \"undefined\") return defaultValue;\n        try {\n            const raw = window.localStorage.getItem(key);\n            if (raw === null) return defaultValue;\n            return deserialize(raw);\n        } catch {\n            return defaultValue;\n        }\n    }, [key, defaultValue, deserialize]);\n\n    const [value, setStored] = useState<T>(read);\n\n    useEffect(() => {\n        setStored(read());\n    }, [read]);\n\n    const setValue = useCallback(\n        (next: T | ((prev: T) => T)): void => {\n            setStored((current) => {\n                const resolved =\n                    typeof next === \"function\" ? (next as (prev: T) => T)(current) : next;\n                try {\n                    if (typeof window !== \"undefined\") {\n                        window.localStorage.setItem(key, serialize(resolved));\n                    }\n                } catch {\n                    /* swallow quota/exceptions */\n                }\n                return resolved;\n            });\n        },\n        [key, serialize],\n    );\n\n    const remove = useCallback((): void => {\n        try {\n            if (typeof window !== \"undefined\") {\n                window.localStorage.removeItem(key);\n            }\n        } catch {\n            /* ignore */\n        }\n        setStored(defaultValue);\n    }, [key, defaultValue]);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onStorage = (event: StorageEvent): void => {\n            if (event.key !== key) return;\n            if (event.newValue === null) {\n                setStored(defaultValue);\n                return;\n            }\n            try {\n                setStored(deserialize(event.newValue));\n            } catch {\n                /* ignore malformed remote value */\n            }\n        };\n        window.addEventListener(\"storage\", onStorage);\n        return () => window.removeEventListener(\"storage\", onStorage);\n    }, [key, defaultValue, deserialize]);\n\n    return [value, setValue, remove];\n}\n"],"names":["defaultSerialize","defaultDeserialize","raw","useLocalStorage","key","defaultValue","options","serialize","deserialize","read","useCallback","value","setStored","useState","useEffect","setValue","next","current","resolved","remove","onStorage","event"],"mappings":"yGAOMA,EAAmB,KAAK,UACxBC,EAAyBC,GAAmB,KAAK,MAAMA,CAAG,EAYzD,SAASC,EACZC,EACAC,EACAC,EAAkC,CAAA,EACoB,CACtD,MAAMC,EAAYD,EAAQ,WAAaN,EACjCQ,EAAcF,EAAQ,aAAeL,EAErCQ,EAAOC,EAAAA,YAAY,IAAS,CAC9B,GAAI,OAAO,OAAW,IAAa,OAAOL,EAC1C,GAAI,CACA,MAAMH,EAAM,OAAO,aAAa,QAAQE,CAAG,EAC3C,OAAIF,IAAQ,KAAaG,EAClBG,EAAYN,CAAG,CAC1B,MAAQ,CACJ,OAAOG,CACX,CACJ,EAAG,CAACD,EAAKC,EAAcG,CAAW,CAAC,EAE7B,CAACG,EAAOC,CAAS,EAAIC,EAAAA,SAAYJ,CAAI,EAE3CK,EAAAA,UAAU,IAAM,CACZF,EAAUH,GAAM,CACpB,EAAG,CAACA,CAAI,CAAC,EAET,MAAMM,EAAWL,EAAAA,YACZM,GAAqC,CAClCJ,EAAWK,GAAY,CACnB,MAAMC,EACF,OAAOF,GAAS,WAAcA,EAAwBC,CAAO,EAAID,EACrE,GAAI,CACI,OAAO,OAAW,KAClB,OAAO,aAAa,QAAQZ,EAAKG,EAAUW,CAAQ,CAAC,CAE5D,MAAQ,CAER,CACA,OAAOA,CACX,CAAC,CACL,EACA,CAACd,EAAKG,CAAS,CAAA,EAGbY,EAAST,EAAAA,YAAY,IAAY,CACnC,GAAI,CACI,OAAO,OAAW,KAClB,OAAO,aAAa,WAAWN,CAAG,CAE1C,MAAQ,CAER,CACAQ,EAAUP,CAAY,CAC1B,EAAG,CAACD,EAAKC,CAAY,CAAC,EAEtBS,OAAAA,EAAAA,UAAU,IAAM,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,MAAMM,EAAaC,GAA8B,CAC7C,GAAIA,EAAM,MAAQjB,EAClB,IAAIiB,EAAM,WAAa,KAAM,CACzBT,EAAUP,CAAY,EACtB,MACJ,CACA,GAAI,CACAO,EAAUJ,EAAYa,EAAM,QAAQ,CAAC,CACzC,MAAQ,CAER,EACJ,EACA,cAAO,iBAAiB,UAAWD,CAAS,EACrC,IAAM,OAAO,oBAAoB,UAAWA,CAAS,CAChE,EAAG,CAAChB,EAAKC,EAAcG,CAAW,CAAC,EAE5B,CAACG,EAAOI,EAAUI,CAAM,CACnC"}

package/dist/hooks/use-local-storage.js

@@ -0,0 +1,55 @@
+import { useCallback as c, useState as g, useEffect as f } from "react";
+const m = JSON.stringify, p = (e) => JSON.parse(e);
+function v(e, t, w = {}) {
+  const a = w.serialize ?? m, i = w.deserialize ?? p, s = c(() => {
+    if (typeof window > "u") return t;
+    try {
+      const r = window.localStorage.getItem(e);
+      return r === null ? t : i(r);
+    } catch {
+      return t;
+    }
+  }, [e, t, i]), [u, n] = g(s);
+  f(() => {
+    n(s());
+  }, [s]);
+  const l = c(
+    (r) => {
+      n((o) => {
+        const d = typeof r == "function" ? r(o) : r;
+        try {
+          typeof window < "u" && window.localStorage.setItem(e, a(d));
+        } catch {
+        }
+        return d;
+      });
+    },
+    [e, a]
+  ), S = c(() => {
+    try {
+      typeof window < "u" && window.localStorage.removeItem(e);
+    } catch {
+    }
+    n(t);
+  }, [e, t]);
+  return f(() => {
+    if (typeof window > "u") return;
+    const r = (o) => {
+      if (o.key === e) {
+        if (o.newValue === null) {
+          n(t);
+          return;
+        }
+        try {
+          n(i(o.newValue));
+        } catch {
+        }
+      }
+    };
+    return window.addEventListener("storage", r), () => window.removeEventListener("storage", r);
+  }, [e, t, i]), [u, l, S];
+}
+export {
+  v as useLocalStorage
+};
+//# sourceMappingURL=use-local-storage.js.map

package/dist/hooks/use-local-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-local-storage.js","sources":["../../src/hooks/use-local-storage.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\nexport type LocalStorageOptions<T> = {\n    serialize?: (value: T) => string;\n    deserialize?: (raw: string) => T;\n};\n\nconst defaultSerialize = JSON.stringify;\nconst defaultDeserialize = <T>(raw: string): T => JSON.parse(raw) as T;\n\n/**\n * State synced with `localStorage`. SSR-safe — initial render returns the\n * provided default; the stored value is hydrated after mount. Updates to the\n * same key in other tabs are picked up via the `storage` event.\n *\n * @param key - localStorage key.\n * @param defaultValue - value used when nothing is stored or in SSR.\n * @param options - custom `serialize` / `deserialize` (default JSON).\n * @returns Tuple `[value, setValue, remove]`.\n */\nexport function useLocalStorage<T>(\n    key: string,\n    defaultValue: T,\n    options: LocalStorageOptions<T> = {},\n): [T, (value: T | ((prev: T) => T)) => void, () => void] {\n    const serialize = options.serialize ?? defaultSerialize;\n    const deserialize = options.deserialize ?? defaultDeserialize;\n\n    const read = useCallback((): T => {\n        if (typeof window === \"undefined\") return defaultValue;\n        try {\n            const raw = window.localStorage.getItem(key);\n            if (raw === null) return defaultValue;\n            return deserialize(raw);\n        } catch {\n            return defaultValue;\n        }\n    }, [key, defaultValue, deserialize]);\n\n    const [value, setStored] = useState<T>(read);\n\n    useEffect(() => {\n        setStored(read());\n    }, [read]);\n\n    const setValue = useCallback(\n        (next: T | ((prev: T) => T)): void => {\n            setStored((current) => {\n                const resolved =\n                    typeof next === \"function\" ? (next as (prev: T) => T)(current) : next;\n                try {\n                    if (typeof window !== \"undefined\") {\n                        window.localStorage.setItem(key, serialize(resolved));\n                    }\n                } catch {\n                    /* swallow quota/exceptions */\n                }\n                return resolved;\n            });\n        },\n        [key, serialize],\n    );\n\n    const remove = useCallback((): void => {\n        try {\n            if (typeof window !== \"undefined\") {\n                window.localStorage.removeItem(key);\n            }\n        } catch {\n            /* ignore */\n        }\n        setStored(defaultValue);\n    }, [key, defaultValue]);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onStorage = (event: StorageEvent): void => {\n            if (event.key !== key) return;\n            if (event.newValue === null) {\n                setStored(defaultValue);\n                return;\n            }\n            try {\n                setStored(deserialize(event.newValue));\n            } catch {\n                /* ignore malformed remote value */\n            }\n        };\n        window.addEventListener(\"storage\", onStorage);\n        return () => window.removeEventListener(\"storage\", onStorage);\n    }, [key, defaultValue, deserialize]);\n\n    return [value, setValue, remove];\n}\n"],"names":["defaultSerialize","defaultDeserialize","raw","useLocalStorage","key","defaultValue","options","serialize","deserialize","read","useCallback","value","setStored","useState","useEffect","setValue","next","current","resolved","remove","onStorage","event"],"mappings":";AAOA,MAAMA,IAAmB,KAAK,WACxBC,IAAqB,CAAIC,MAAmB,KAAK,MAAMA,CAAG;AAYzD,SAASC,EACZC,GACAC,GACAC,IAAkC,CAAA,GACoB;AACtD,QAAMC,IAAYD,EAAQ,aAAaN,GACjCQ,IAAcF,EAAQ,eAAeL,GAErCQ,IAAOC,EAAY,MAAS;AAC9B,QAAI,OAAO,SAAW,IAAa,QAAOL;AAC1C,QAAI;AACA,YAAMH,IAAM,OAAO,aAAa,QAAQE,CAAG;AAC3C,aAAIF,MAAQ,OAAaG,IAClBG,EAAYN,CAAG;AAAA,IAC1B,QAAQ;AACJ,aAAOG;AAAA,IACX;AAAA,EACJ,GAAG,CAACD,GAAKC,GAAcG,CAAW,CAAC,GAE7B,CAACG,GAAOC,CAAS,IAAIC,EAAYJ,CAAI;AAE3C,EAAAK,EAAU,MAAM;AACZ,IAAAF,EAAUH,GAAM;AAAA,EACpB,GAAG,CAACA,CAAI,CAAC;AAET,QAAMM,IAAWL;AAAA,IACb,CAACM,MAAqC;AAClC,MAAAJ,EAAU,CAACK,MAAY;AACnB,cAAMC,IACF,OAAOF,KAAS,aAAcA,EAAwBC,CAAO,IAAID;AACrE,YAAI;AACA,UAAI,OAAO,SAAW,OAClB,OAAO,aAAa,QAAQZ,GAAKG,EAAUW,CAAQ,CAAC;AAAA,QAE5D,QAAQ;AAAA,QAER;AACA,eAAOA;AAAA,MACX,CAAC;AAAA,IACL;AAAA,IACA,CAACd,GAAKG,CAAS;AAAA,EAAA,GAGbY,IAAST,EAAY,MAAY;AACnC,QAAI;AACA,MAAI,OAAO,SAAW,OAClB,OAAO,aAAa,WAAWN,CAAG;AAAA,IAE1C,QAAQ;AAAA,IAER;AACA,IAAAQ,EAAUP,CAAY;AAAA,EAC1B,GAAG,CAACD,GAAKC,CAAY,CAAC;AAEtB,SAAAS,EAAU,MAAM;AACZ,QAAI,OAAO,SAAW,IAAa;AACnC,UAAMM,IAAY,CAACC,MAA8B;AAC7C,UAAIA,EAAM,QAAQjB,GAClB;AAAA,YAAIiB,EAAM,aAAa,MAAM;AACzB,UAAAT,EAAUP,CAAY;AACtB;AAAA,QACJ;AACA,YAAI;AACA,UAAAO,EAAUJ,EAAYa,EAAM,QAAQ,CAAC;AAAA,QACzC,QAAQ;AAAA,QAER;AAAA;AAAA,IACJ;AACA,kBAAO,iBAAiB,WAAWD,CAAS,GACrC,MAAM,OAAO,oBAAoB,WAAWA,CAAS;AAAA,EAChE,GAAG,CAAChB,GAAKC,GAAcG,CAAW,CAAC,GAE5B,CAACG,GAAOI,GAAUI,CAAM;AACnC;"}

package/dist/hooks/use-long-press-handlers.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react");function d(o,a={}){const{delayMs:c=500,disabled:n=!1}=a,t=r.useRef(null),u=r.useRef(!1),s=r.useRef(o);s.current=o;const e=r.useCallback(()=>{t.current!==null&&(window.clearTimeout(t.current),t.current=null)},[]),l=r.useCallback(()=>{n||(u.current=!1,e(),t.current=window.setTimeout(()=>{u.current=!0,s.current()},c))},[n,e,c]),f=r.useCallback(i=>{n||(i.preventDefault(),u.current=!0,s.current())},[n]);return{onMouseDown:l,onMouseUp:e,onMouseLeave:e,onTouchStart:l,onTouchEnd:e,onTouchMove:e,onContextMenu:f,wasLongPress:()=>u.current}}exports.useLongPressHandlers=d;
+//# sourceMappingURL=use-long-press-handlers.cjs.map