tempest-react-sdk 0.77.0 → 0.79.0

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

@@ -1 +1 @@
-{"version":3,"file":"use-idle.cjs","names":[],"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"],"mappings":"uBAEA,IAAM,EAA2C,CAC7C,YACA,YACA,UACA,aACA,QACA,QACJ,EAMA,SAAgB,EAAQ,EAAU,IAAiB,CAC/C,GAAM,CAAC,EAAM,IAAA,EAAW,EAAA,SAAA,CAAkB,EAAK,EAuB/C,OArBA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAI,EAAQ,eAAiB,EAAQ,EAAI,EAAG,CAAO,EAEnD,SAAS,GAAc,CACnB,EAAQ,EAAK,EACb,aAAa,CAAK,EAClB,EAAQ,eAAiB,EAAQ,EAAI,EAAG,CAAO,CACnD,CAEA,IAAK,IAAM,KAAS,EAChB,OAAO,iBAAiB,EAAO,EAAO,CAAE,QAAS,EAAK,CAAC,EAE3D,UAAa,CACT,aAAa,CAAK,EAClB,IAAK,IAAM,KAAS,EAChB,OAAO,oBAAoB,EAAO,CAAK,CAE/C,CACJ,EAAG,CAAC,CAAO,CAAC,EAEL,CACX"}
+{"version":3,"file":"use-idle.cjs","names":["useState","react","DEFAULT_EVENTS","useIdle","idle","setIdle","timer","timeout","reset","event"],"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"],"mappings":"A,uBAEA,IAAME,EAA2C,CAC7C,YACA,YACA,UACA,aACA,QACA,QACJ,EAMA,SAAgBC,EAAQ,EAAU,IAAiB,CAC/C,GAAM,CAACC,EAAMC,IAAA,EAAWL,EAAAA,SAAAA,CAAkB,EAAK,EAuB/C,OArBA,EAAAC,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAIK,EAAQ,eAAiBD,EAAQ,EAAI,EAAGE,CAAO,EAEnD,SAASC,GAAc,CACnBH,EAAQ,EAAK,EACb,aAAaC,CAAK,EAClB,EAAQ,eAAiBD,EAAQ,EAAI,EAAGE,CAAO,CACnD,CAEA,IAAK,IAAME,KAASP,EAChB,OAAO,iBAAiBO,EAAOD,EAAO,CAAE,QAAS,EAAK,CAAC,EAE3D,UAAa,CACT,aAAaF,CAAK,EAClB,IAAK,IAAMG,KAASP,EAChB,OAAO,oBAAoBO,EAAOD,CAAK,CAE/C,CACJ,EAAG,CAACD,CAAO,CAAC,EAELH,CACX,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-idle.js","names":[],"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"],"mappings":";;AAEA,IAAM,IAA2C;CAC7C;CACA;CACA;CACA;CACA;CACA;AACJ;AAMA,SAAgB,EAAQ,IAAU,KAAiB;CAC/C,IAAM,CAAC,GAAM,KAAW,EAAkB,EAAK;CAuB/C,OArBA,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAI,IAAQ,iBAAiB,EAAQ,EAAI,GAAG,CAAO;EAEnD,SAAS,IAAc;GAGnB,AAFA,EAAQ,EAAK,GACb,aAAa,CAAK,GAClB,IAAQ,iBAAiB,EAAQ,EAAI,GAAG,CAAO;EACnD;EAEA,KAAK,IAAM,KAAS,GAChB,OAAO,iBAAiB,GAAO,GAAO,EAAE,SAAS,GAAK,CAAC;EAE3D,aAAa;GACT,aAAa,CAAK;GAClB,KAAK,IAAM,KAAS,GAChB,OAAO,oBAAoB,GAAO,CAAK;EAE/C;CACJ,GAAG,CAAC,CAAO,CAAC,GAEL;AACX"}
+{"version":3,"file":"use-idle.js","names":["DEFAULT_EVENTS","useIdle","idle","setIdle","useState","useEffect","timer","timeout","reset","event"],"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"],"mappings":";;AAEA,IAAMA,IAA2C;CAC7C;CACA;CACA;CACA;CACA;CACA;AACJ;AAMA,SAAgBC,EAAQ,IAAU,KAAiB;CAC/C,IAAM,CAACC,GAAMC,KAAWC,EAAkB,EAAK;CAuB/C,OArBAC,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAIC,IAAQ,iBAAiBH,EAAQ,EAAI,GAAGI,CAAO;EAEnD,SAASC,IAAc;GAGnB,AAFAL,EAAQ,EAAK,GACb,aAAaG,CAAK,GAClB,IAAQ,iBAAiBH,EAAQ,EAAI,GAAGI,CAAO;EACnD;EAEA,KAAK,IAAME,KAAST,GAChB,OAAO,iBAAiBS,GAAOD,GAAO,EAAE,SAAS,GAAK,CAAC;EAE3D,aAAa;GACT,aAAaF,CAAK;GAClB,KAAK,IAAMG,KAAST,GAChB,OAAO,oBAAoBS,GAAOD,CAAK;EAE/C;CACJ,GAAG,CAACD,CAAO,CAAC,GAELL;AACX"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"use-install-prompt.cjs","names":[],"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\n/**\n * Whether a recorded decline is still inside its cooldown window.\n *\n * Reading is guarded because `localStorage.getItem` **throws** where this hook\n * matters most: Safari private mode and a cross-origin frame with storage\n * blocked. Unguarded, that exception escapes during render and takes the page\n * down — the install CTA is a courtesy, and no courtesy is worth a blank screen.\n *\n * @param key - Storage key holding the decline timestamp.\n * @param cooldownMs - How long a decline suppresses the CTA.\n * @returns Whether the CTA should stay hidden.\n */\nfunction readDecline(key: string, cooldownMs: number): boolean {\n    if (typeof window === \"undefined\") return false;\n    let raw: string | null;\n    try {\n        raw = window.localStorage.getItem(key);\n    } catch {\n        return false;\n    }\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 * Both sides of that persistence are best-effort: `localStorage` throws in\n * Safari private mode and in a cross-origin frame with storage blocked, and an\n * exception raised while resolving an install CTA would take the page down with\n * it. A refused read means \"no decline recorded\"; a refused write means the CTA\n * may come back next visit.\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        try {\n            window.localStorage.setItem(declineStorageKey, String(Date.now()));\n        } catch {\n            /* empty */\n        }\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"],"mappings":"wDASA,IAAM,EAA8B,OAC9B,EAAmC,IACnC,EAA8B,8BAEhC,EAA+C,KAC7C,EAAmB,IAAI,IAEzB,OAAO,OAAW,MAClB,OAAO,iBAAiB,sBAAwB,GAAiB,CAC7D,EAAM,eAAe,EACrB,EAAc,EACd,EAAiB,QAAS,GAAO,EAAG,CAAW,CAAC,CACpD,CAAC,EACD,OAAO,iBAAiB,mBAAsB,CAC1C,EAAc,KACd,EAAiB,QAAS,GAAO,EAAG,IAAI,CAAC,CAC7C,CAAC,GAyEL,SAAS,EAAY,EAAa,EAA6B,CAC3D,GAAI,OAAO,OAAW,IAAa,MAAO,GAC1C,IAAI,EACJ,GAAI,CACA,EAAM,OAAO,aAAa,QAAQ,CAAG,CACzC,MAAQ,CACJ,MAAO,EACX,CACA,GAAI,CAAC,EAAK,MAAO,GACjB,IAAM,EAAK,OAAO,CAAG,EAErB,OADK,OAAO,SAAS,CAAE,EAChB,KAAK,IAAI,EAAI,EAAK,EADQ,EAErC,CA4BA,SAAgB,EAAiB,EAAmC,CAAC,EAA2B,CAC5F,GAAM,CACF,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACxB,EAEE,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAA0C,CAAW,EACzE,CAAC,EAAY,IAAA,EAAiB,EAAA,SAAA,CAAkB,EAAA,aAAa,CAAC,EAC9D,CAAC,EAAgB,IAAA,EAAqB,EAAA,SAAA,CAAkB,EAAK,GAEnE,EAAA,EAAA,UAAA,MACI,EAAiB,IAAI,CAAQ,MAChB,CACT,EAAiB,OAAO,CAAQ,CACpC,GACD,CAAC,CAAC,GAEL,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,EAAK,OAAO,aAAa,4BAA4B,EACrD,MAAsB,EAAc,EAAA,aAAa,CAAC,EAGxD,OAFA,GAAI,mBAAmB,SAAU,CAAO,EACxC,OAAO,iBAAiB,eAAgB,CAAO,MAClC,CACT,GAAI,sBAAsB,SAAU,CAAO,EAC3C,OAAO,oBAAoB,eAAgB,CAAO,CACtD,CACJ,EAAG,CAAC,CAAC,GAEL,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,EAAO,CACP,EAAkB,EAAK,EACvB,MACJ,CACA,IAAM,EAAQ,OAAO,eAAiB,CAC7B,GAAa,EAAkB,EAAI,CAC5C,EAAG,CAAqB,EACxB,UAAa,OAAO,aAAa,CAAK,CAC1C,EAAG,CAAC,EAAO,CAAqB,CAAC,EAEjC,IAAM,EAAM,EAAA,MAAM,EACZ,EAAgB,EAAA,0BAA0B,EAE1C,EAAgB,EAAY,EAAmB,CAAiB,EAElE,EAAwB,OACxB,CAAC,GAAc,CAAC,IACZ,EAAO,EAAS,SACX,EAAK,EAAS,OACd,GAAiB,KAAgB,EAAS,WAGvD,IAAM,MAA4B,CAC1B,YAAO,OAAW,KACtB,GAAI,CACA,OAAO,aAAa,QAAQ,EAAmB,OAAO,KAAK,IAAI,CAAC,CAAC,CACrE,MAAQ,CAER,CACJ,EAYA,MAAO,CACH,eAAgB,EAChB,WAAY,IAAW,OACvB,MAAO,EACP,aAAc,EACd,gBAAiB,EACjB,iBACA,SACA,mBAAoB,EAAA,wBAAwB,EAC5C,iBAnB0C,CAC1C,GAAI,CAAC,EAAO,MAAO,GACnB,MAAM,EAAM,OAAO,EACnB,IAAM,EAAS,MAAM,EAAM,WAI3B,OAHI,EAAO,UAAY,aAAa,EAAc,EAClD,EAAc,KACd,EAAiB,QAAS,GAAO,EAAG,IAAI,CAAC,EAClC,EAAO,UAAY,UAC9B,EAYI,eACJ,CACJ"}
+{"version":3,"file":"use-install-prompt.cjs","names":["useState","isStandalone","isIOS","isAndroidWithoutPromptApi","buildOpenInChromeIntent","require_pwa_env","react","DEFAULT_DECLINE_COOLDOWN_MS","DEFAULT_MANUAL_FALLBACK_DELAY_MS","DEFAULT_DECLINE_STORAGE_KEY","cachedEvent","eventSubscribers","event","fn","readDecline","raw","key","ts","cooldownMs","useInstallPrompt","options","setEvent","standalone","setStandalone","promptTimedOut","setPromptTimedOut","mq","handler","timer","manualFallbackDelayMs","ios","manualAndroid","declineActive","declineStorageKey","declineCooldownMs","method","recordDecline","choice"],"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\n/**\n * Whether a recorded decline is still inside its cooldown window.\n *\n * Reading is guarded because `localStorage.getItem` **throws** where this hook\n * matters most: Safari private mode and a cross-origin frame with storage\n * blocked. Unguarded, that exception escapes during render and takes the page\n * down — the install CTA is a courtesy, and no courtesy is worth a blank screen.\n *\n * @param key - Storage key holding the decline timestamp.\n * @param cooldownMs - How long a decline suppresses the CTA.\n * @returns Whether the CTA should stay hidden.\n */\nfunction readDecline(key: string, cooldownMs: number): boolean {\n    if (typeof window === \"undefined\") return false;\n    let raw: string | null;\n    try {\n        raw = window.localStorage.getItem(key);\n    } catch {\n        return false;\n    }\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 * Both sides of that persistence are best-effort: `localStorage` throws in\n * Safari private mode and in a cross-origin frame with storage blocked, and an\n * exception raised while resolving an install CTA would take the page down with\n * it. A refused read means \"no decline recorded\"; a refused write means the CTA\n * may come back next visit.\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        try {\n            window.localStorage.setItem(declineStorageKey, String(Date.now()));\n        } catch {\n            /* empty */\n        }\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"],"mappings":"A,wDASA,IAAMO,EAA8B,OAC9BC,EAAmC,IACnCC,EAA8B,8BAEhCC,EAA+C,KAC7CC,EAAmB,IAAI,IAEzB,OAAO,OAAW,MAClB,OAAO,iBAAiB,sBAAwB,GAAiB,CAC7DC,EAAM,eAAe,EACrB,EAAcA,EACdD,EAAiB,QAAS,GAAOE,EAAGH,CAAW,CAAC,CACpD,CAAC,EACD,OAAO,iBAAiB,mBAAsB,CAC1C,EAAc,KACdC,EAAiB,QAAS,GAAOE,EAAG,IAAI,CAAC,CAC7C,CAAC,GAyEL,SAASC,EAAY,EAAa,EAA6B,CAC3D,GAAI,OAAO,OAAW,IAAa,MAAO,GAC1C,IAAIC,EACJ,GAAI,CACA,EAAM,OAAO,aAAa,QAAQC,CAAG,CACzC,MAAQ,CACJ,MAAO,EACX,CACA,GAAI,CAACD,EAAK,MAAO,GACjB,IAAME,EAAK,OAAOF,CAAG,EAErB,OADK,OAAO,SAASE,CAAE,EAChB,KAAK,IAAI,EAAIA,EAAKC,EADQ,EAErC,CA4BA,SAAgBC,EAAiB,EAAmC,CAAC,EAA2B,CAC5F,GAAM,CACF,oBAAoBV,EACpB,oBAAoBF,EACpB,wBAAwBC,GACxBY,EAEE,CAACR,EAAOS,IAAA,EAAYrB,EAAAA,SAAAA,CAA0CU,CAAW,EACzE,CAACY,EAAYC,IAAA,EAAiBvB,EAAAA,SAAAA,CAAkBC,EAAAA,aAAa,CAAC,EAC9D,CAACuB,EAAgBC,IAAA,EAAqBzB,EAAAA,SAAAA,CAAkB,EAAK,GAEnE,EAAAM,EAAA,UAAA,MACIK,EAAiB,IAAIU,CAAQ,MAChB,CACTV,EAAiB,OAAOU,CAAQ,CACpC,GACD,CAAC,CAAC,GAEL,EAAAf,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAMoB,EAAK,OAAO,aAAa,4BAA4B,EACrDC,MAAsBJ,EAActB,EAAAA,aAAa,CAAC,EAGxD,OAFAyB,GAAI,mBAAmB,SAAUC,CAAO,EACxC,OAAO,iBAAiB,eAAgBA,CAAO,MAClC,CACTD,GAAI,sBAAsB,SAAUC,CAAO,EAC3C,OAAO,oBAAoB,eAAgBA,CAAO,CACtD,CACJ,EAAG,CAAC,CAAC,GAEL,EAAArB,EAAA,UAAA,KAAgB,CACZ,GAAIM,EAAO,CACPa,EAAkB,EAAK,EACvB,MACJ,CACA,IAAMG,EAAQ,OAAO,eAAiB,CAC7BlB,GAAae,EAAkB,EAAI,CAC5C,EAAGI,CAAqB,EACxB,UAAa,OAAO,aAAaD,CAAK,CAC1C,EAAG,CAAChB,EAAOiB,CAAqB,CAAC,EAEjC,IAAMC,EAAM5B,EAAAA,MAAM,EACZ6B,EAAgB5B,EAAAA,0BAA0B,EAE1C6B,EAAgBlB,EAAYmB,EAAmBC,CAAiB,EAElEC,EAAwB,OACxB,CAACb,GAAc,CAACU,IACZpB,EAAO,EAAS,SACXkB,EAAK,EAAS,OACdC,GAAiBP,KAAgB,EAAS,WAGvD,IAAMY,MAA4B,CAC9B,GAAI,OAAO,OAAW,IACtB,GAAI,CACA,OAAO,aAAa,QAAQH,EAAmB,OAAO,KAAK,IAAI,CAAC,CAAC,CACrE,MAAQ,CAER,CACJ,EAYA,MAAO,CACH,eAAgBrB,EAChB,WAAYuB,IAAW,OACvB,MAAOL,EACP,aAAcR,EACd,gBAAiBS,EACjB,iBACA,SACA,mBAAoB3B,EAAAA,wBAAwB,EAC5C,iBAnB0C,CAC1C,GAAI,CAACQ,EAAO,MAAO,GACnB,MAAMA,EAAM,OAAO,EACnB,IAAMyB,EAAS,MAAMzB,EAAM,WAI3B,OAHIyB,EAAO,UAAY,aAAaD,EAAc,EAClD,EAAc,KACdzB,EAAiB,QAAS,GAAOE,EAAG,IAAI,CAAC,EAClCwB,EAAO,UAAY,UAC9B,EAYI,eACJ,CACJ,C"}

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

@@ -42,7 +42,7 @@ function f(f = {}) {
 	let S = n(), C = t(), w = d(p, m), T = "none";
 	!v && !w && (g ? T = "native" : S ? T = "ios" : (C || b) && (T = "manual"));
 	let E = () => {
-		if (!(typeof window > "u")) try {
+		if (typeof window < "u") try {
 			window.localStorage.setItem(p, String(Date.now()));
 		} catch {}
 	};

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

@@ -1 +1 @@
-{"version":3,"file":"use-install-prompt.js","names":[],"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\n/**\n * Whether a recorded decline is still inside its cooldown window.\n *\n * Reading is guarded because `localStorage.getItem` **throws** where this hook\n * matters most: Safari private mode and a cross-origin frame with storage\n * blocked. Unguarded, that exception escapes during render and takes the page\n * down — the install CTA is a courtesy, and no courtesy is worth a blank screen.\n *\n * @param key - Storage key holding the decline timestamp.\n * @param cooldownMs - How long a decline suppresses the CTA.\n * @returns Whether the CTA should stay hidden.\n */\nfunction readDecline(key: string, cooldownMs: number): boolean {\n    if (typeof window === \"undefined\") return false;\n    let raw: string | null;\n    try {\n        raw = window.localStorage.getItem(key);\n    } catch {\n        return false;\n    }\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 * Both sides of that persistence are best-effort: `localStorage` throws in\n * Safari private mode and in a cross-origin frame with storage blocked, and an\n * exception raised while resolving an install CTA would take the page down with\n * it. A refused read means \"no decline recorded\"; a refused write means the CTA\n * may come back next visit.\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        try {\n            window.localStorage.setItem(declineStorageKey, String(Date.now()));\n        } catch {\n            /* empty */\n        }\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"],"mappings":";;;AASA,IAAM,IAA8B,QAC9B,IAAmC,KACnC,IAA8B,+BAEhC,IAA+C,MAC7C,oBAAmB,IAAI,IAAsD;AAE/E,OAAO,SAAW,QAClB,OAAO,iBAAiB,wBAAwB,MAAiB;CAG7D,AAFA,EAAM,eAAe,GACrB,IAAc,GACd,EAAiB,SAAS,MAAO,EAAG,CAAW,CAAC;AACpD,CAAC,GACD,OAAO,iBAAiB,sBAAsB;CAE1C,AADA,IAAc,MACd,EAAiB,SAAS,MAAO,EAAG,IAAI,CAAC;AAC7C,CAAC;AAyEL,SAAS,EAAY,GAAa,GAA6B;CAC3D,IAAI,OAAO,SAAW,KAAa,OAAO;CAC1C,IAAI;CACJ,IAAI;EACA,IAAM,OAAO,aAAa,QAAQ,CAAG;CACzC,QAAQ;EACJ,OAAO;CACX;CACA,IAAI,CAAC,GAAK,OAAO;CACjB,IAAM,IAAK,OAAO,CAAG;CAErB,OADK,OAAO,SAAS,CAAE,IAChB,KAAK,IAAI,IAAI,IAAK,IADQ;AAErC;AA4BA,SAAgB,EAAiB,IAAmC,CAAC,GAA2B;CAC5F,IAAM,EACF,uBAAoB,GACpB,uBAAoB,GACpB,2BAAwB,MACxB,GAEE,CAAC,GAAO,KAAY,EAA0C,CAAW,GACzE,CAAC,GAAY,KAAiB,EAAkB,EAAa,CAAC,GAC9D,CAAC,GAAgB,KAAqB,EAAkB,EAAK;CAqBnE,AAnBA,SACI,EAAiB,IAAI,CAAQ,SAChB;EACT,EAAiB,OAAO,CAAQ;CACpC,IACD,CAAC,CAAC,GAEL,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,IAAK,OAAO,aAAa,4BAA4B,GACrD,UAAsB,EAAc,EAAa,CAAC;EAGxD,OAFA,GAAI,mBAAmB,UAAU,CAAO,GACxC,OAAO,iBAAiB,gBAAgB,CAAO,SAClC;GAET,AADA,GAAI,sBAAsB,UAAU,CAAO,GAC3C,OAAO,oBAAoB,gBAAgB,CAAO;EACtD;CACJ,GAAG,CAAC,CAAC,GAEL,QAAgB;EACZ,IAAI,GAAO;GACP,EAAkB,EAAK;GACvB;EACJ;EACA,IAAM,IAAQ,OAAO,iBAAiB;GAClC,AAAK,KAAa,EAAkB,EAAI;EAC5C,GAAG,CAAqB;EACxB,aAAa,OAAO,aAAa,CAAK;CAC1C,GAAG,CAAC,GAAO,CAAqB,CAAC;CAEjC,IAAM,IAAM,EAAM,GACZ,IAAgB,EAA0B,GAE1C,IAAgB,EAAY,GAAmB,CAAiB,GAElE,IAAwB;CAC5B,AAAI,CAAC,KAAc,CAAC,MACZ,IAAO,IAAS,WACX,IAAK,IAAS,SACd,KAAiB,OAAgB,IAAS;CAGvD,IAAM,UAA4B;EAC1B,aAAO,SAAW,MACtB,IAAI;GACA,OAAO,aAAa,QAAQ,GAAmB,OAAO,KAAK,IAAI,CAAC,CAAC;EACrE,QAAQ,CAER;CACJ;CAYA,OAAO;EACH,gBAAgB;EAChB,YAAY,MAAW;EACvB,OAAO;EACP,cAAc;EACd,iBAAiB;EACjB;EACA;EACA,oBAAoB,EAAwB;EAC5C,qBAnB0C;GAC1C,IAAI,CAAC,GAAO,OAAO;GACnB,MAAM,EAAM,OAAO;GACnB,IAAM,IAAS,MAAM,EAAM;GAI3B,OAHI,EAAO,YAAY,eAAa,EAAc,GAClD,IAAc,MACd,EAAiB,SAAS,MAAO,EAAG,IAAI,CAAC,GAClC,EAAO,YAAY;EAC9B;EAYI;CACJ;AACJ"}
+{"version":3,"file":"use-install-prompt.js","names":["DEFAULT_DECLINE_COOLDOWN_MS","DEFAULT_MANUAL_FALLBACK_DELAY_MS","DEFAULT_DECLINE_STORAGE_KEY","cachedEvent","eventSubscribers","event","fn","readDecline","raw","key","ts","cooldownMs","useInstallPrompt","options","setEvent","useState","standalone","setStandalone","isStandalone","promptTimedOut","setPromptTimedOut","useEffect","mq","handler","timer","manualFallbackDelayMs","ios","isIOS","manualAndroid","isAndroidWithoutPromptApi","declineActive","declineStorageKey","declineCooldownMs","method","recordDecline","buildOpenInChromeIntent","choice"],"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\n/**\n * Whether a recorded decline is still inside its cooldown window.\n *\n * Reading is guarded because `localStorage.getItem` **throws** where this hook\n * matters most: Safari private mode and a cross-origin frame with storage\n * blocked. Unguarded, that exception escapes during render and takes the page\n * down — the install CTA is a courtesy, and no courtesy is worth a blank screen.\n *\n * @param key - Storage key holding the decline timestamp.\n * @param cooldownMs - How long a decline suppresses the CTA.\n * @returns Whether the CTA should stay hidden.\n */\nfunction readDecline(key: string, cooldownMs: number): boolean {\n    if (typeof window === \"undefined\") return false;\n    let raw: string | null;\n    try {\n        raw = window.localStorage.getItem(key);\n    } catch {\n        return false;\n    }\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 * Both sides of that persistence are best-effort: `localStorage` throws in\n * Safari private mode and in a cross-origin frame with storage blocked, and an\n * exception raised while resolving an install CTA would take the page down with\n * it. A refused read means \"no decline recorded\"; a refused write means the CTA\n * may come back next visit.\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        try {\n            window.localStorage.setItem(declineStorageKey, String(Date.now()));\n        } catch {\n            /* empty */\n        }\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"],"mappings":";;;AASA,IAAMA,IAA8B,QAC9BC,IAAmC,KACnCC,IAA8B,+BAEhCC,IAA+C,MAC7CC,oBAAmB,IAAI,IAAsD;AAE/E,OAAO,SAAW,QAClB,OAAO,iBAAiB,wBAAwB,MAAiB;CAG7D,AAFAC,EAAM,eAAe,GACrB,IAAcA,GACdD,EAAiB,SAAS,MAAOE,EAAGH,CAAW,CAAC;AACpD,CAAC,GACD,OAAO,iBAAiB,sBAAsB;CAE1C,AADA,IAAc,MACdC,EAAiB,SAAS,MAAOE,EAAG,IAAI,CAAC;AAC7C,CAAC;AAyEL,SAASC,EAAY,GAAa,GAA6B;CAC3D,IAAI,OAAO,SAAW,KAAa,OAAO;CAC1C,IAAIC;CACJ,IAAI;EACA,IAAM,OAAO,aAAa,QAAQC,CAAG;CACzC,QAAQ;EACJ,OAAO;CACX;CACA,IAAI,CAACD,GAAK,OAAO;CACjB,IAAME,IAAK,OAAOF,CAAG;CAErB,OADK,OAAO,SAASE,CAAE,IAChB,KAAK,IAAI,IAAIA,IAAKC,IADQ;AAErC;AA4BA,SAAgBC,EAAiB,IAAmC,CAAC,GAA2B;CAC5F,IAAM,EACF,uBAAoBV,GACpB,uBAAoBF,GACpB,2BAAwBC,MACxBY,GAEE,CAACR,GAAOS,KAAYC,EAA0CZ,CAAW,GACzE,CAACa,GAAYC,KAAiBF,EAAkBG,EAAa,CAAC,GAC9D,CAACC,GAAgBC,KAAqBL,EAAkB,EAAK;CAqBnE,AAnBAM,SACIjB,EAAiB,IAAIU,CAAQ,SAChB;EACT,EAAiB,OAAOA,CAAQ;CACpC,IACD,CAAC,CAAC,GAELO,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAMC,IAAK,OAAO,aAAa,4BAA4B,GACrDC,UAAsBN,EAAcC,EAAa,CAAC;EAGxD,OAFAI,GAAI,mBAAmB,UAAUC,CAAO,GACxC,OAAO,iBAAiB,gBAAgBA,CAAO,SAClC;GAET,AADAD,GAAI,sBAAsB,UAAUC,CAAO,GAC3C,OAAO,oBAAoB,gBAAgBA,CAAO;EACtD;CACJ,GAAG,CAAC,CAAC,GAELF,QAAgB;EACZ,IAAIhB,GAAO;GACP,EAAkB,EAAK;GACvB;EACJ;EACA,IAAMmB,IAAQ,OAAO,iBAAiB;GAClC,AAAKrB,KAAaiB,EAAkB,EAAI;EAC5C,GAAGK,CAAqB;EACxB,aAAa,OAAO,aAAaD,CAAK;CAC1C,GAAG,CAACnB,GAAOoB,CAAqB,CAAC;CAEjC,IAAMC,IAAMC,EAAM,GACZC,IAAgBC,EAA0B,GAE1CC,IAAgBvB,EAAYwB,GAAmBC,CAAiB,GAElEC,IAAwB;CAC5B,AAAI,CAACjB,KAAc,CAACc,MACZzB,IAAO,IAAS,WACXqB,IAAK,IAAS,SACdE,KAAiBT,OAAgB,IAAS;CAGvD,IAAMe,UAA4B;EAC9B,IAAI,OAAO,SAAW,KACtB,IAAI;GACA,OAAO,aAAa,QAAQH,GAAmB,OAAO,KAAK,IAAI,CAAC,CAAC;EACrE,QAAQ,CAER;CACJ;CAYA,OAAO;EACH,gBAAgB1B;EAChB,YAAY4B,MAAW;EACvB,OAAOP;EACP,cAAcV;EACd,iBAAiBY;EACjB;EACA;EACA,oBAAoBO,EAAwB;EAC5C,qBAnB0C;GAC1C,IAAI,CAAC9B,GAAO,OAAO;GACnB,MAAMA,EAAM,OAAO;GACnB,IAAM+B,IAAS,MAAM/B,EAAM;GAI3B,OAHI+B,EAAO,YAAY,eAAaF,EAAc,GAClD,IAAc,MACd9B,EAAiB,SAAS,MAAOE,EAAG,IAAI,CAAC,GAClC8B,EAAO,YAAY;EAC9B;EAYI;CACJ;AACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-intersection-observer.cjs","names":[],"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"],"mappings":"uBAcA,SAAgB,EACZ,EACA,EAA0C,CAAC,EACX,CAChC,GAAM,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAA2C,IAAI,EACnE,CAAE,OAAO,GAAO,OAAM,aAAY,aAAc,EAmBtD,OAjBA,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAS,EAAI,QACnB,GAAI,CAAC,GAAU,OAAO,qBAAyB,IAAa,OAE5D,IAAM,EAAW,IAAI,sBAChB,CAAC,KAAe,CACR,IACL,EAAS,CAAS,EACd,GAAQ,EAAU,gBAAgB,EAAS,UAAU,CAAM,EACnE,EACA,CAAE,OAAM,aAAY,WAAU,CAClC,EAGA,OADA,EAAS,QAAQ,CAAM,MACV,EAAS,WAAW,CACrC,EAAG,CAAC,EAAK,EAAM,EAAM,EAAY,CAAS,CAAC,EAEpC,CACX"}
+{"version":3,"file":"use-intersection-observer.cjs","names":["useState","react","useIntersectionObserver","entry","setEntry","options","target","ref","observer","nextEntry","once","root","rootMargin","threshold"],"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"],"mappings":"A,uBAcA,SAAgBE,EACZ,EACA,EAA0C,CAAC,EACX,CAChC,GAAM,CAACC,EAAOC,IAAA,EAAYJ,EAAAA,SAAAA,CAA2C,IAAI,EACnE,CAAE,OAAO,GAAO,OAAM,aAAY,aAAcK,EAmBtD,OAjBA,EAAAJ,EAAA,UAAA,KAAgB,CACZ,IAAMK,EAASC,EAAI,QACnB,GAAI,CAACD,GAAU,OAAO,qBAAyB,IAAa,OAE5D,IAAME,EAAW,IAAI,sBAChB,CAACC,KAAe,CACRA,IACLL,EAASK,CAAS,EACdC,GAAQD,EAAU,gBAAgBD,EAAS,UAAUF,CAAM,EACnE,EACA,CAAE,OAAM,aAAY,WAAU,CAClC,EAGA,OADAE,EAAS,QAAQF,CAAM,MACVE,EAAS,WAAW,CACrC,EAAG,CAACD,EAAKG,EAAMC,EAAMC,EAAYC,CAAS,CAAC,EAEpCV,CACX,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-intersection-observer.js","names":[],"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"],"mappings":";;AAcA,SAAgB,EACZ,GACA,IAA0C,CAAC,GACX;CAChC,IAAM,CAAC,GAAO,KAAY,EAA2C,IAAI,GACnE,EAAE,UAAO,IAAO,SAAM,eAAY,iBAAc;CAmBtD,OAjBA,QAAgB;EACZ,IAAM,IAAS,EAAI;EACnB,IAAI,CAAC,KAAU,OAAO,uBAAyB,KAAa;EAE5D,IAAM,IAAW,IAAI,sBAChB,CAAC,OAAe;GACR,MACL,EAAS,CAAS,GACd,KAAQ,EAAU,kBAAgB,EAAS,UAAU,CAAM;EACnE,GACA;GAAE;GAAM;GAAY;EAAU,CAClC;EAGA,OADA,EAAS,QAAQ,CAAM,SACV,EAAS,WAAW;CACrC,GAAG;EAAC;EAAK;EAAM;EAAM;EAAY;CAAS,CAAC,GAEpC;AACX"}
+{"version":3,"file":"use-intersection-observer.js","names":["useIntersectionObserver","entry","setEntry","useState","options","useEffect","target","ref","observer","nextEntry","once","root","rootMargin","threshold"],"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"],"mappings":";;AAcA,SAAgBA,EACZ,GACA,IAA0C,CAAC,GACX;CAChC,IAAM,CAACC,GAAOC,KAAYC,EAA2C,IAAI,GACnE,EAAE,UAAO,IAAO,SAAM,eAAY,iBAAcC;CAmBtD,OAjBAC,QAAgB;EACZ,IAAMC,IAASC,EAAI;EACnB,IAAI,CAACD,KAAU,OAAO,uBAAyB,KAAa;EAE5D,IAAME,IAAW,IAAI,sBAChB,CAACC,OAAe;GACb,AAAKA,MACLP,EAASO,CAAS,GACdC,KAAQD,EAAU,kBAAgBD,EAAS,UAAUF,CAAM;EACnE,GACA;GAAE;GAAM;GAAY;EAAU,CAClC;EAGA,OADAE,EAAS,QAAQF,CAAM,SACVE,EAAS,WAAW;CACrC,GAAG;EAACD;EAAKG;EAAMC;EAAMC;EAAYC;CAAS,CAAC,GAEpCZ;AACX"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-interval.cjs","names":[],"sources":["../../src/hooks/use-interval.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\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 = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setInterval(() => fnRef.current(), delay);\n        return () => clearInterval(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":"+DAUA,SAAgB,EAAY,EAAgB,EAA4B,CACpE,IAAM,EAAQ,EAAA,aAAa,CAAE,GAE7B,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,IAAU,KAAM,OACpB,IAAM,EAAK,gBAAkB,EAAM,QAAQ,EAAG,CAAK,EACnD,UAAa,cAAc,CAAE,CACjC,EAAG,CAAC,EAAO,CAAK,CAAC,CACrB"}
+{"version":3,"file":"use-interval.cjs","names":["useLatestRef","require_use_latest_ref","react","useInterval","fnRef","fn","delay","id"],"sources":["../../src/hooks/use-interval.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\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 = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setInterval(() => fnRef.current(), delay);\n        return () => clearInterval(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":"A,+DAUA,SAAgBG,EAAY,EAAgB,EAA4B,CACpE,IAAMC,EAAQJ,EAAAA,aAAaK,CAAE,GAE7B,EAAAH,EAAA,UAAA,KAAgB,CACZ,GAAII,IAAU,KAAM,OACpB,IAAMC,EAAK,gBAAkBH,EAAM,QAAQ,EAAGE,CAAK,EACnD,UAAa,cAAcC,CAAE,CACjC,EAAG,CAACD,EAAOF,CAAK,CAAC,CACrB,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-interval.js","names":[],"sources":["../../src/hooks/use-interval.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\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 = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setInterval(() => fnRef.current(), delay);\n        return () => clearInterval(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":";;;AAUA,SAAgB,EAAY,GAAgB,GAA4B;CACpE,IAAM,IAAQ,EAAa,CAAE;CAE7B,QAAgB;EACZ,IAAI,MAAU,MAAM;EACpB,IAAM,IAAK,kBAAkB,EAAM,QAAQ,GAAG,CAAK;EACnD,aAAa,cAAc,CAAE;CACjC,GAAG,CAAC,GAAO,CAAK,CAAC;AACrB"}
+{"version":3,"file":"use-interval.js","names":["useInterval","fnRef","useLatestRef","fn","delay","id"],"sources":["../../src/hooks/use-interval.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\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 = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setInterval(() => fnRef.current(), delay);\n        return () => clearInterval(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":";;;AAUA,SAAgBA,EAAY,GAAgB,GAA4B;CACpE,IAAMC,IAAQC,EAAaC,CAAE;CAE7B,QAAgB;EACZ,IAAIC,MAAU,MAAM;EACpB,IAAMC,IAAK,kBAAkBJ,EAAM,QAAQ,GAAGG,CAAK;EACnD,aAAa,cAAcC,CAAE;CACjC,GAAG,CAACD,GAAOH,CAAK,CAAC;AACrB"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-is-first-render.cjs","names":[],"sources":["../../src/hooks/use-is-first-render.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- flipping the flag during render IS this hook */\nimport { useRef } from \"react\";\n\n/**\n * Return `true` on the first render of the component and `false` thereafter.\n *\n * Reads *and* flips a ref during render, which the React Compiler rules flag on\n * sight — here it is the entire hook. Under StrictMode's double render in dev the\n * second pass already sees `false`, so treat the result as \"first committed\n * render\" and not as a strict render counter.\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"],"mappings":"uBAaA,SAAgB,GAA4B,CACxC,IAAM,GAAA,EAAU,EAAA,OAAA,CAAgB,EAAI,EAKpC,OAJI,EAAQ,SACR,EAAQ,QAAU,GACX,IAEJ,EACX"}
+{"version":3,"file":"use-is-first-render.cjs","names":["useRef","react","useIsFirstRender","isFirst"],"sources":["../../src/hooks/use-is-first-render.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- flipping the flag during render IS this hook */\nimport { useRef } from \"react\";\n\n/**\n * Return `true` on the first render of the component and `false` thereafter.\n *\n * Reads *and* flips a ref during render, which the React Compiler rules flag on\n * sight — here it is the entire hook. Under StrictMode's double render in dev the\n * second pass already sees `false`, so treat the result as \"first committed\n * render\" and not as a strict render counter.\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"],"mappings":"A,uBAaA,SAAgBE,GAA4B,CACxC,IAAMC,GAAA,EAAUH,EAAAA,OAAAA,CAAgB,EAAI,EAKpC,OAJIG,EAAQ,SACR,EAAQ,QAAU,GACX,IAEJ,EACX,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-is-first-render.js","names":[],"sources":["../../src/hooks/use-is-first-render.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- flipping the flag during render IS this hook */\nimport { useRef } from \"react\";\n\n/**\n * Return `true` on the first render of the component and `false` thereafter.\n *\n * Reads *and* flips a ref during render, which the React Compiler rules flag on\n * sight — here it is the entire hook. Under StrictMode's double render in dev the\n * second pass already sees `false`, so treat the result as \"first committed\n * render\" and not as a strict render counter.\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"],"mappings":";;AAaA,SAAgB,IAA4B;CACxC,IAAM,IAAU,EAAgB,EAAI;CAKpC,OAJI,EAAQ,WACR,EAAQ,UAAU,IACX,MAEJ;AACX"}
+{"version":3,"file":"use-is-first-render.js","names":["useIsFirstRender","isFirst","useRef"],"sources":["../../src/hooks/use-is-first-render.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- flipping the flag during render IS this hook */\nimport { useRef } from \"react\";\n\n/**\n * Return `true` on the first render of the component and `false` thereafter.\n *\n * Reads *and* flips a ref during render, which the React Compiler rules flag on\n * sight — here it is the entire hook. Under StrictMode's double render in dev the\n * second pass already sees `false`, so treat the result as \"first committed\n * render\" and not as a strict render counter.\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"],"mappings":";;AAaA,SAAgBA,IAA4B;CACxC,IAAMC,IAAUC,EAAgB,EAAI;CAKpC,OAJID,EAAQ,WACR,EAAQ,UAAU,IACX,MAEJ;AACX"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-keyboard-shortcut.cjs","names":[],"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"],"mappings":"uBAsBA,SAAS,EAAQ,EAAsB,EAAqC,CACxE,GAAI,EAAM,IAAI,YAAY,IAAM,EAAS,IAAI,YAAY,EAAG,MAAO,GACnE,IAAM,EAAO,CAAC,CAAC,EAAS,KAClB,EAAO,CAAC,CAAC,EAAS,KAClB,EAAQ,CAAC,CAAC,EAAS,MACnB,EAAM,CAAC,CAAC,EAAS,IACvB,GAAI,EAAS,IACL,IAAA,CAAC,EAAM,SAAW,CAAC,EAAM,QAAS,MAAO,EAAA,MAG7C,GADI,EAAM,UAAY,GAClB,EAAM,UAAY,EAAM,MAAO,GAIvC,OAFI,EAAM,WAAa,GACnB,EAAM,SAAW,CAEzB,CAEA,SAAS,EAAW,EAAqC,CACrD,GAAI,EAAE,aAAkB,aAAc,MAAO,GAC7C,IAAM,EAAM,EAAO,QAAQ,YAAY,EAEvC,OADI,IAAQ,SAAW,IAAQ,YAAc,IAAQ,UAC9C,EAAO,iBAClB,CAeA,SAAgB,EACZ,EACA,EACA,EAAsC,CAAC,EACnC,CACJ,GAAM,CAAE,WAAW,GAAO,cAAc,IAAS,GAEjD,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,GAAY,OAAO,OAAW,IAAa,OAC/C,IAAM,EAAY,GAA+B,CACzC,GAAe,EAAW,EAAM,MAAM,GACtC,EAAQ,EAAO,CAAQ,GAAG,EAAQ,CAAK,CAC/C,EAEA,OADA,OAAO,iBAAiB,UAAW,CAAQ,MAC9B,OAAO,oBAAoB,UAAW,CAAQ,CAE/D,EAAG,CACC,EACA,EACA,EAAS,IACT,EAAS,KACT,EAAS,KACT,EAAS,MACT,EAAS,IACT,EAAS,IACT,CACJ,CAAC,CACL"}
+{"version":3,"file":"use-keyboard-shortcut.cjs","names":["react","matches","event","shortcut","ctrl","meta","shift","alt","isEditable","target","tag","useKeyboardShortcut","options","disabled","listener","ignoreInput","handler"],"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"],"mappings":"A,uBAsBA,SAASC,EAAQ,EAAsB,EAAqC,CACxE,GAAIC,EAAM,IAAI,YAAY,IAAMC,EAAS,IAAI,YAAY,EAAG,MAAO,GACnE,IAAMC,EAAO,CAAC,CAACD,EAAS,KAClBE,EAAO,CAAC,CAACF,EAAS,KAClBG,EAAQ,CAAC,CAACH,EAAS,MACnBI,EAAM,CAAC,CAACJ,EAAS,IACvB,GAAIA,EAAS,IACL,IAAA,CAACD,EAAM,SAAW,CAACA,EAAM,QAAS,MAAO,EAAA,MAG7C,GADIA,EAAM,UAAYE,GAClBF,EAAM,UAAYG,EAAM,MAAO,GAIvC,OAFIH,EAAM,WAAaI,GACnBJ,EAAM,SAAWK,CAEzB,CAEA,SAASC,EAAW,EAAqC,CACrD,GAAI,EAAEC,aAAkB,aAAc,MAAO,GAC7C,IAAMC,EAAMD,EAAO,QAAQ,YAAY,EAEvC,OADIC,IAAQ,SAAWA,IAAQ,YAAcA,IAAQ,UAC9CD,EAAO,iBAClB,CAeA,SAAgBE,EACZ,EACA,EACA,EAAsC,CAAC,EACnC,CACJ,GAAM,CAAE,WAAW,GAAO,cAAc,IAASC,GAEjD,EAAAZ,EAAA,UAAA,KAAgB,CACZ,GAAIa,GAAY,OAAO,OAAW,IAAa,OAC/C,IAAMC,EAAY,GAA+B,CACzCC,GAAeP,EAAWN,EAAM,MAAM,GACtCD,EAAQC,EAAOC,CAAQ,GAAGa,EAAQd,CAAK,CAC/C,EAEA,OADA,OAAO,iBAAiB,UAAWY,CAAQ,MAC9B,OAAO,oBAAoB,UAAWA,CAAQ,CAE/D,EAAG,CACCD,EACAE,EACAZ,EAAS,IACTA,EAAS,KACTA,EAAS,KACTA,EAAS,MACTA,EAAS,IACTA,EAAS,IACTa,CACJ,CAAC,CACL,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-keyboard-shortcut.js","names":[],"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"],"mappings":";;AAsBA,SAAS,EAAQ,GAAsB,GAAqC;CACxE,IAAI,EAAM,IAAI,YAAY,MAAM,EAAS,IAAI,YAAY,GAAG,OAAO;CACnE,IAAM,IAAO,CAAC,CAAC,EAAS,MAClB,IAAO,CAAC,CAAC,EAAS,MAClB,IAAQ,CAAC,CAAC,EAAS,OACnB,IAAM,CAAC,CAAC,EAAS;CACvB,IAAI,EAAS,KACL;MAAA,CAAC,EAAM,WAAW,CAAC,EAAM,SAAS,OAAO;CAAA,OAG7C,IADI,EAAM,YAAY,KAClB,EAAM,YAAY,GAAM,OAAO;CAIvC,OAFI,EAAM,aAAa,KACnB,EAAM,WAAW;AAEzB;AAEA,SAAS,EAAW,GAAqC;CACrD,IAAI,EAAE,aAAkB,cAAc,OAAO;CAC7C,IAAM,IAAM,EAAO,QAAQ,YAAY;CAEvC,OADI,MAAQ,WAAW,MAAQ,cAAc,MAAQ,YAC9C,EAAO;AAClB;AAeA,SAAgB,EACZ,GACA,GACA,IAAsC,CAAC,GACnC;CACJ,IAAM,EAAE,cAAW,IAAO,iBAAc,OAAS;CAEjD,QAAgB;EACZ,IAAI,KAAY,OAAO,SAAW,KAAa;EAC/C,IAAM,KAAY,MAA+B;GACzC,KAAe,EAAW,EAAM,MAAM,KACtC,EAAQ,GAAO,CAAQ,KAAG,EAAQ,CAAK;EAC/C;EAEA,OADA,OAAO,iBAAiB,WAAW,CAAQ,SAC9B,OAAO,oBAAoB,WAAW,CAAQ;CAE/D,GAAG;EACC;EACA;EACA,EAAS;EACT,EAAS;EACT,EAAS;EACT,EAAS;EACT,EAAS;EACT,EAAS;EACT;CACJ,CAAC;AACL"}
+{"version":3,"file":"use-keyboard-shortcut.js","names":["matches","event","shortcut","ctrl","meta","shift","alt","isEditable","target","tag","useKeyboardShortcut","options","disabled","listener","ignoreInput","handler"],"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"],"mappings":";;AAsBA,SAASA,EAAQ,GAAsB,GAAqC;CACxE,IAAIC,EAAM,IAAI,YAAY,MAAMC,EAAS,IAAI,YAAY,GAAG,OAAO;CACnE,IAAMC,IAAO,CAAC,CAACD,EAAS,MAClBE,IAAO,CAAC,CAACF,EAAS,MAClBG,IAAQ,CAAC,CAACH,EAAS,OACnBI,IAAM,CAAC,CAACJ,EAAS;CACvB,IAAIA,EAAS,KACL;MAAA,CAACD,EAAM,WAAW,CAACA,EAAM,SAAS,OAAO;CAAA,OAG7C,IADIA,EAAM,YAAYE,KAClBF,EAAM,YAAYG,GAAM,OAAO;CAIvC,OAFIH,EAAM,aAAaI,KACnBJ,EAAM,WAAWK;AAEzB;AAEA,SAASC,EAAW,GAAqC;CACrD,IAAI,EAAEC,aAAkB,cAAc,OAAO;CAC7C,IAAMC,IAAMD,EAAO,QAAQ,YAAY;CAEvC,OADIC,MAAQ,WAAWA,MAAQ,cAAcA,MAAQ,YAC9CD,EAAO;AAClB;AAeA,SAAgBE,EACZ,GACA,GACA,IAAsC,CAAC,GACnC;CACJ,IAAM,EAAE,cAAW,IAAO,iBAAc,OAASC;CAEjD,QAAgB;EACZ,IAAIC,KAAY,OAAO,SAAW,KAAa;EAC/C,IAAMC,KAAY,MAA+B;GAC7C,AAAIC,KAAeP,EAAWN,EAAM,MAAM,KACtCD,EAAQC,GAAOC,CAAQ,KAAGa,EAAQd,CAAK;EAC/C;EAEA,OADA,OAAO,iBAAiB,WAAWY,CAAQ,SAC9B,OAAO,oBAAoB,WAAWA,CAAQ;CAE/D,GAAG;EACCD;EACAE;EACAZ,EAAS;EACTA,EAAS;EACTA,EAAS;EACTA,EAAS;EACTA,EAAS;EACTA,EAAS;EACTa;CACJ,CAAC;AACL"}

package/dist/hooks/use-latest-ref.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-latest-ref.cjs","names":[],"sources":["../../src/hooks/use-latest-ref.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- writing at render time is deliberate; an effect would add a staleness window (see the docstring) */\nimport { useRef, type RefObject } from \"react\";\n\n/**\n * Keeps a ref pointing at the most recent value it was given.\n *\n * The escape hatch for reading fresh state inside something that must not be\n * re-created when that state changes: an interval, a subscription, an event\n * listener registered once on mount. Listing the value in the effect's\n * dependencies would tear the effect down and set it back up on every change;\n * omitting it captures the value from the render that created the closure and\n * never sees another. The ref is neither — a stable object whose `current` is\n * always current.\n *\n * The assignment happens **during render**, for the same reason\n * {@link useStableCallback} does it: moving it into an effect opens a\n * one-commit staleness window, where an effect declared earlier in the same\n * commit reads the previous render's value.\n *\n * Reach for {@link useStableCallback} instead when the value is a function you\n * want to *call* — it hands back a callable with a stable identity, rather than\n * making every call site reach through `.current`.\n *\n * **List the returned ref in your effect's dependencies.** It is a stable object,\n * so the effect never re-runs because of it, but `react-hooks/exhaustive-deps`\n * cannot prove that for a custom hook the way it does for a bare `useRef`.\n * Listing it lets the rule verify the array instead of taking an omission on\n * trust.\n *\n * **Not for holding the previous value.** The write happens during render, so\n * `.current` is already the current value by the time any effect reads it. A hook\n * that wants the value from the *previous* commit — `usePrevious` — needs the\n * effect-based write, and swapping it for this would make it return the present.\n *\n * @typeParam T - The tracked value.\n * @param value - The value to track. Written on every render.\n * @returns A stable ref whose `current` holds the latest `value`.\n *\n * @example\n * const optionsRef = useLatestRef(options);\n *\n * useEffect(() => {\n *   const id = setInterval(() => poll(optionsRef.current), 5_000);\n *   return () => clearInterval(id);\n * }, []); // the interval survives every options change, and still reads the latest\n */\nexport function useLatestRef<T>(value: T): RefObject<T> {\n    const ref = useRef(value);\n    ref.current = value;\n    return ref;\n}\n"],"mappings":"uBA8CA,SAAgB,EAAgB,EAAwB,CACpD,IAAM,GAAA,EAAM,EAAA,OAAA,CAAO,CAAK,EAExB,MADA,GAAI,QAAU,EACP,CACX"}
+{"version":3,"file":"use-latest-ref.cjs","names":["useRef","react","useLatestRef","ref","value"],"sources":["../../src/hooks/use-latest-ref.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- writing at render time is deliberate; an effect would add a staleness window (see the docstring) */\nimport { useRef, type RefObject } from \"react\";\n\n/**\n * Keeps a ref pointing at the most recent value it was given.\n *\n * The escape hatch for reading fresh state inside something that must not be\n * re-created when that state changes: an interval, a subscription, an event\n * listener registered once on mount. Listing the value in the effect's\n * dependencies would tear the effect down and set it back up on every change;\n * omitting it captures the value from the render that created the closure and\n * never sees another. The ref is neither — a stable object whose `current` is\n * always current.\n *\n * The assignment happens **during render**, for the same reason\n * {@link useStableCallback} does it: moving it into an effect opens a\n * one-commit staleness window, where an effect declared earlier in the same\n * commit reads the previous render's value.\n *\n * Reach for {@link useStableCallback} instead when the value is a function you\n * want to *call* — it hands back a callable with a stable identity, rather than\n * making every call site reach through `.current`.\n *\n * **List the returned ref in your effect's dependencies.** It is a stable object,\n * so the effect never re-runs because of it, but `react-hooks/exhaustive-deps`\n * cannot prove that for a custom hook the way it does for a bare `useRef`.\n * Listing it lets the rule verify the array instead of taking an omission on\n * trust.\n *\n * **Not for holding the previous value.** The write happens during render, so\n * `.current` is already the current value by the time any effect reads it. A hook\n * that wants the value from the *previous* commit — `usePrevious` — needs the\n * effect-based write, and swapping it for this would make it return the present.\n *\n * @typeParam T - The tracked value.\n * @param value - The value to track. Written on every render.\n * @returns A stable ref whose `current` holds the latest `value`.\n *\n * @example\n * const optionsRef = useLatestRef(options);\n *\n * useEffect(() => {\n *   const id = setInterval(() => poll(optionsRef.current), 5_000);\n *   return () => clearInterval(id);\n * }, []); // the interval survives every options change, and still reads the latest\n */\nexport function useLatestRef<T>(value: T): RefObject<T> {\n    const ref = useRef(value);\n    ref.current = value;\n    return ref;\n}\n"],"mappings":"A,uBA8CA,SAAgBE,EAAgB,EAAwB,CACpD,IAAMC,GAAA,EAAMH,EAAAA,OAAAA,CAAOI,CAAK,EAExB,MADA,GAAI,QAAUA,EACPD,CACX,C"}

package/dist/hooks/use-latest-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-latest-ref.js","names":[],"sources":["../../src/hooks/use-latest-ref.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- writing at render time is deliberate; an effect would add a staleness window (see the docstring) */\nimport { useRef, type RefObject } from \"react\";\n\n/**\n * Keeps a ref pointing at the most recent value it was given.\n *\n * The escape hatch for reading fresh state inside something that must not be\n * re-created when that state changes: an interval, a subscription, an event\n * listener registered once on mount. Listing the value in the effect's\n * dependencies would tear the effect down and set it back up on every change;\n * omitting it captures the value from the render that created the closure and\n * never sees another. The ref is neither — a stable object whose `current` is\n * always current.\n *\n * The assignment happens **during render**, for the same reason\n * {@link useStableCallback} does it: moving it into an effect opens a\n * one-commit staleness window, where an effect declared earlier in the same\n * commit reads the previous render's value.\n *\n * Reach for {@link useStableCallback} instead when the value is a function you\n * want to *call* — it hands back a callable with a stable identity, rather than\n * making every call site reach through `.current`.\n *\n * **List the returned ref in your effect's dependencies.** It is a stable object,\n * so the effect never re-runs because of it, but `react-hooks/exhaustive-deps`\n * cannot prove that for a custom hook the way it does for a bare `useRef`.\n * Listing it lets the rule verify the array instead of taking an omission on\n * trust.\n *\n * **Not for holding the previous value.** The write happens during render, so\n * `.current` is already the current value by the time any effect reads it. A hook\n * that wants the value from the *previous* commit — `usePrevious` — needs the\n * effect-based write, and swapping it for this would make it return the present.\n *\n * @typeParam T - The tracked value.\n * @param value - The value to track. Written on every render.\n * @returns A stable ref whose `current` holds the latest `value`.\n *\n * @example\n * const optionsRef = useLatestRef(options);\n *\n * useEffect(() => {\n *   const id = setInterval(() => poll(optionsRef.current), 5_000);\n *   return () => clearInterval(id);\n * }, []); // the interval survives every options change, and still reads the latest\n */\nexport function useLatestRef<T>(value: T): RefObject<T> {\n    const ref = useRef(value);\n    ref.current = value;\n    return ref;\n}\n"],"mappings":";;AA8CA,SAAgB,EAAgB,GAAwB;CACpD,IAAM,IAAM,EAAO,CAAK;CAExB,OADA,EAAI,UAAU,GACP;AACX"}
+{"version":3,"file":"use-latest-ref.js","names":["useLatestRef","ref","useRef","value"],"sources":["../../src/hooks/use-latest-ref.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- writing at render time is deliberate; an effect would add a staleness window (see the docstring) */\nimport { useRef, type RefObject } from \"react\";\n\n/**\n * Keeps a ref pointing at the most recent value it was given.\n *\n * The escape hatch for reading fresh state inside something that must not be\n * re-created when that state changes: an interval, a subscription, an event\n * listener registered once on mount. Listing the value in the effect's\n * dependencies would tear the effect down and set it back up on every change;\n * omitting it captures the value from the render that created the closure and\n * never sees another. The ref is neither — a stable object whose `current` is\n * always current.\n *\n * The assignment happens **during render**, for the same reason\n * {@link useStableCallback} does it: moving it into an effect opens a\n * one-commit staleness window, where an effect declared earlier in the same\n * commit reads the previous render's value.\n *\n * Reach for {@link useStableCallback} instead when the value is a function you\n * want to *call* — it hands back a callable with a stable identity, rather than\n * making every call site reach through `.current`.\n *\n * **List the returned ref in your effect's dependencies.** It is a stable object,\n * so the effect never re-runs because of it, but `react-hooks/exhaustive-deps`\n * cannot prove that for a custom hook the way it does for a bare `useRef`.\n * Listing it lets the rule verify the array instead of taking an omission on\n * trust.\n *\n * **Not for holding the previous value.** The write happens during render, so\n * `.current` is already the current value by the time any effect reads it. A hook\n * that wants the value from the *previous* commit — `usePrevious` — needs the\n * effect-based write, and swapping it for this would make it return the present.\n *\n * @typeParam T - The tracked value.\n * @param value - The value to track. Written on every render.\n * @returns A stable ref whose `current` holds the latest `value`.\n *\n * @example\n * const optionsRef = useLatestRef(options);\n *\n * useEffect(() => {\n *   const id = setInterval(() => poll(optionsRef.current), 5_000);\n *   return () => clearInterval(id);\n * }, []); // the interval survives every options change, and still reads the latest\n */\nexport function useLatestRef<T>(value: T): RefObject<T> {\n    const ref = useRef(value);\n    ref.current = value;\n    return ref;\n}\n"],"mappings":";;AA8CA,SAAgBA,EAAgB,GAAwB;CACpD,IAAMC,IAAMC,EAAOC,CAAK;CAExB,OADA,EAAI,UAAUA,GACPF;AACX"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-list-state.cjs","names":[],"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"],"mappings":"uBA0BA,SAAgB,EAAgB,EAAe,CAAC,EAAgC,CAC5E,GAAM,CAAC,EAAM,IAAA,EAAW,EAAA,SAAA,CAAc,CAAO,EAEvC,GAAA,EAAS,EAAA,YAAA,EAAa,GAAG,IAAqB,CAChD,EAAS,GAAY,CAAC,GAAG,EAAS,GAAG,CAAK,CAAC,CAC/C,EAAG,CAAC,CAAC,EAEC,GAAA,EAAU,EAAA,YAAA,EAAa,GAAG,IAAqB,CACjD,EAAS,GAAY,CAAC,GAAG,EAAO,GAAG,CAAO,CAAC,CAC/C,EAAG,CAAC,CAAC,EAEC,GAAA,EAAS,EAAA,YAAA,EAAa,EAAe,GAAG,IAAqB,CAC/D,EAAS,GAAY,CAAC,GAAG,EAAQ,MAAM,EAAG,CAAK,EAAG,GAAG,EAAO,GAAG,EAAQ,MAAM,CAAK,CAAC,CAAC,CACxF,EAAG,CAAC,CAAC,EAEC,GAAA,EAAS,EAAA,YAAA,EAAa,GAAG,IAA4B,CACvD,IAAM,EAAO,IAAI,IAAI,CAAO,EAC5B,EAAS,GAAY,EAAQ,QAAQ,EAAG,IAAU,CAAC,EAAK,IAAI,CAAK,CAAC,CAAC,CACvE,EAAG,CAAC,CAAC,EAEC,GAAA,EAAU,EAAA,YAAA,EAAa,CAAE,OAAM,QAA+B,CAChE,EAAS,GAAY,CACjB,IAAM,EAAO,CAAC,GAAG,CAAO,EAClB,CAAC,GAAS,EAAK,OAAO,EAAM,CAAC,EAEnC,OADA,EAAK,OAAO,EAAI,EAAG,CAAK,EACjB,CACX,CAAC,CACL,EAAG,CAAC,CAAC,EAEC,GAAA,EAAU,EAAA,YAAA,EAAa,EAAe,IAAkB,CAC1D,EAAS,GAAY,EAAQ,KAAK,EAAO,IAAO,IAAM,EAAQ,EAAO,CAAM,CAAC,CAChF,EAAG,CAAC,CAAC,EAEC,GAAA,EAAW,EAAA,YAAA,CAAa,GAAqB,EAAQ,CAAK,EAAG,CAAC,CAAC,EAE/D,GAAA,EAAQ,EAAA,YAAA,CAAa,GAA4C,CACnE,EAAS,GAAY,EAAQ,IAAI,CAAE,CAAC,CACxC,EAAG,CAAC,CAAC,EAEC,GAAA,EAAQ,EAAA,YAAA,KAAwB,EAAQ,CAAC,CAAC,EAAG,CAAC,CAAC,EAiBrD,MAAO,CAAC,GAAA,EAfS,EAAA,QAAA,MACN,CACH,SACA,UACA,SACA,SACA,UACA,UACA,WACA,QACA,OACJ,GACA,CAAC,EAAQ,EAAS,EAAQ,EAAQ,EAAS,EAAS,EAAU,EAAO,CAAK,CAGhE,CAAQ,CAC1B"}
+{"version":3,"file":"use-list-state.cjs","names":["useState","useCallback","useMemo","react","useListState","list","setList","initial","append","items","current","prepend","insert","index","remove","indices","drop","reorder","next","moved","from","to","setItem","i","item","value","setState","apply","fn","clear"],"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"],"mappings":"A,uBA0BA,SAAgBI,EAAgB,EAAe,CAAC,EAAgC,CAC5E,GAAM,CAACC,EAAMC,IAAA,EAAWN,EAAAA,SAAAA,CAAcO,CAAO,EAEvCC,GAAA,EAASP,EAAAA,YAAAA,EAAa,GAAGQ,IAAqB,CAChDH,EAAS,GAAY,CAAC,GAAGI,EAAS,GAAGD,CAAK,CAAC,CAC/C,EAAG,CAAC,CAAC,EAECE,GAAA,EAAUV,EAAAA,YAAAA,EAAa,GAAGQ,IAAqB,CACjDH,EAAS,GAAY,CAAC,GAAGG,EAAO,GAAGC,CAAO,CAAC,CAC/C,EAAG,CAAC,CAAC,EAECE,GAAA,EAASX,EAAAA,YAAAA,EAAa,EAAe,GAAGQ,IAAqB,CAC/DH,EAAS,GAAY,CAAC,GAAGI,EAAQ,MAAM,EAAGG,CAAK,EAAG,GAAGJ,EAAO,GAAGC,EAAQ,MAAMG,CAAK,CAAC,CAAC,CACxF,EAAG,CAAC,CAAC,EAECC,GAAA,EAASb,EAAAA,YAAAA,EAAa,GAAGc,IAA4B,CACvD,IAAMC,EAAO,IAAI,IAAID,CAAO,EAC5BT,EAAS,GAAYI,EAAQ,QAAQ,EAAG,IAAU,CAACM,EAAK,IAAIH,CAAK,CAAC,CAAC,CACvE,EAAG,CAAC,CAAC,EAECI,GAAA,EAAUhB,EAAAA,YAAAA,EAAa,CAAE,OAAM,QAA+B,CAChEK,EAAS,GAAY,CACjB,IAAMY,EAAO,CAAC,GAAGR,CAAO,EAClB,CAACS,GAASD,EAAK,OAAOE,EAAM,CAAC,EAEnC,OADAF,EAAK,OAAOG,EAAI,EAAGF,CAAK,EACjBD,CACX,CAAC,CACL,EAAG,CAAC,CAAC,EAECI,GAAA,EAAUrB,EAAAA,YAAAA,EAAa,EAAe,IAAkB,CAC1DK,EAAS,GAAYI,EAAQ,KAAK,EAAO,IAAOa,IAAMV,EAAQW,EAAOC,CAAM,CAAC,CAChF,EAAG,CAAC,CAAC,EAECC,GAAA,EAAWzB,EAAAA,YAAAA,CAAa,GAAqBK,EAAQG,CAAK,EAAG,CAAC,CAAC,EAE/DkB,GAAA,EAAQ1B,EAAAA,YAAAA,CAAa,GAA4C,CACnEK,EAAS,GAAYI,EAAQ,IAAIkB,CAAE,CAAC,CACxC,EAAG,CAAC,CAAC,EAECC,GAAA,EAAQ5B,EAAAA,YAAAA,KAAwBK,EAAQ,CAAC,CAAC,EAAG,CAAC,CAAC,EAiBrD,MAAO,CAACD,GAAA,EAfSH,EAAAA,QAAAA,MACN,CACH,SACA,UACA,SACA,SACA,UACA,UACA,WACA,QACA,OACJ,GACA,CAACM,EAAQG,EAASC,EAAQE,EAAQG,EAASK,EAASI,EAAUC,EAAOE,CAAK,CAGhE,CAAQ,CAC1B,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-list-state.js","names":[],"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"],"mappings":";;AA0BA,SAAgB,EAAgB,IAAe,CAAC,GAAgC;CAC5E,IAAM,CAAC,GAAM,KAAW,EAAc,CAAO,GAEvC,IAAS,GAAa,GAAG,MAAqB;EAChD,GAAS,MAAY,CAAC,GAAG,GAAS,GAAG,CAAK,CAAC;CAC/C,GAAG,CAAC,CAAC,GAEC,IAAU,GAAa,GAAG,MAAqB;EACjD,GAAS,MAAY,CAAC,GAAG,GAAO,GAAG,CAAO,CAAC;CAC/C,GAAG,CAAC,CAAC,GAEC,IAAS,GAAa,GAAe,GAAG,MAAqB;EAC/D,GAAS,MAAY;GAAC,GAAG,EAAQ,MAAM,GAAG,CAAK;GAAG,GAAG;GAAO,GAAG,EAAQ,MAAM,CAAK;EAAC,CAAC;CACxF,GAAG,CAAC,CAAC,GAEC,IAAS,GAAa,GAAG,MAA4B;EACvD,IAAM,IAAO,IAAI,IAAI,CAAO;EAC5B,GAAS,MAAY,EAAQ,QAAQ,GAAG,MAAU,CAAC,EAAK,IAAI,CAAK,CAAC,CAAC;CACvE,GAAG,CAAC,CAAC,GAEC,IAAU,GAAa,EAAE,SAAM,YAA+B;EAChE,GAAS,MAAY;GACjB,IAAM,IAAO,CAAC,GAAG,CAAO,GAClB,CAAC,KAAS,EAAK,OAAO,GAAM,CAAC;GAEnC,OADA,EAAK,OAAO,GAAI,GAAG,CAAK,GACjB;EACX,CAAC;CACL,GAAG,CAAC,CAAC,GAEC,IAAU,GAAa,GAAe,MAAkB;EAC1D,GAAS,MAAY,EAAQ,KAAK,GAAO,MAAO,MAAM,IAAQ,IAAO,CAAM,CAAC;CAChF,GAAG,CAAC,CAAC,GAEC,IAAW,GAAa,MAAqB,EAAQ,CAAK,GAAG,CAAC,CAAC,GAE/D,IAAQ,GAAa,MAA4C;EACnE,GAAS,MAAY,EAAQ,IAAI,CAAE,CAAC;CACxC,GAAG,CAAC,CAAC,GAEC,IAAQ,QAAwB,EAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;CAiBrD,OAAO,CAAC,GAfS,SACN;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,IACA;EAAC;EAAQ;EAAS;EAAQ;EAAQ;EAAS;EAAS;EAAU;EAAO;CAAK,CAGhE,CAAQ;AAC1B"}
+{"version":3,"file":"use-list-state.js","names":["useListState","list","setList","useState","initial","append","useCallback","items","current","prepend","insert","index","remove","indices","drop","reorder","next","moved","from","to","setItem","i","item","value","setState","apply","fn","clear","useMemo"],"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"],"mappings":";;AA0BA,SAAgBA,EAAgB,IAAe,CAAC,GAAgC;CAC5E,IAAM,CAACC,GAAMC,KAAWC,EAAcC,CAAO,GAEvCC,IAASC,GAAa,GAAGC,MAAqB;EAChD,GAAS,MAAY,CAAC,GAAGC,GAAS,GAAGD,CAAK,CAAC;CAC/C,GAAG,CAAC,CAAC,GAECE,IAAUH,GAAa,GAAGC,MAAqB;EACjD,GAAS,MAAY,CAAC,GAAGA,GAAO,GAAGC,CAAO,CAAC;CAC/C,GAAG,CAAC,CAAC,GAECE,IAASJ,GAAa,GAAe,GAAGC,MAAqB;EAC/D,GAAS,MAAY;GAAC,GAAGC,EAAQ,MAAM,GAAGG,CAAK;GAAG,GAAGJ;GAAO,GAAGC,EAAQ,MAAMG,CAAK;EAAC,CAAC;CACxF,GAAG,CAAC,CAAC,GAECC,IAASN,GAAa,GAAGO,MAA4B;EACvD,IAAMC,IAAO,IAAI,IAAID,CAAO;EAC5B,GAAS,MAAYL,EAAQ,QAAQ,GAAG,MAAU,CAACM,EAAK,IAAIH,CAAK,CAAC,CAAC;CACvE,GAAG,CAAC,CAAC,GAECI,IAAUT,GAAa,EAAE,SAAM,YAA+B;EAChE,GAAS,MAAY;GACjB,IAAMU,IAAO,CAAC,GAAGR,CAAO,GAClB,CAACS,KAASD,EAAK,OAAOE,GAAM,CAAC;GAEnC,OADAF,EAAK,OAAOG,GAAI,GAAGF,CAAK,GACjBD;EACX,CAAC;CACL,GAAG,CAAC,CAAC,GAECI,IAAUd,GAAa,GAAe,MAAkB;EAC1D,GAAS,MAAYE,EAAQ,KAAK,GAAO,MAAOa,MAAMV,IAAQW,IAAOC,CAAM,CAAC;CAChF,GAAG,CAAC,CAAC,GAECC,IAAWlB,GAAa,MAAqBJ,EAAQK,CAAK,GAAG,CAAC,CAAC,GAE/DkB,IAAQnB,GAAa,MAA4C;EACnE,GAAS,MAAYE,EAAQ,IAAIkB,CAAE,CAAC;CACxC,GAAG,CAAC,CAAC,GAECC,IAAQrB,QAAwBJ,EAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;CAiBrD,OAAO,CAACD,GAfS2B,SACN;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,IACA;EAACvB;EAAQI;EAASC;EAAQE;EAAQG;EAASK;EAASI;EAAUC;EAAOE;CAAK,CAGhE,CAAQ;AAC1B"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"use-local-storage.cjs","names":[],"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 * @tempest-limits empty-catch — the three swallows here are the hook's contract.\n * A write that hits the quota (or Safari private mode) still updates React state,\n * so the session keeps working and only persistence is lost; a `storage` event\n * carrying a value this tab cannot deserialize is another tab's bug, and the\n * useful response is to keep the value already rendered rather than tear the\n * component down over a foreign write.\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                    /* empty */\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            /* empty */\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                /* empty */\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"],"mappings":"uBAOA,IAAM,EAAmB,KAAK,UACxB,EAAyB,GAAmB,KAAK,MAAM,CAAG,EAmBhE,SAAgB,EACZ,EACA,EACA,EAAkC,CAAC,EACmB,CACtD,IAAM,EAAY,EAAQ,WAAa,EACjC,EAAc,EAAQ,aAAe,EAErC,GAAA,EAAO,EAAA,YAAA,KAAqB,CAC9B,GAAI,OAAO,OAAW,IAAa,OAAO,EAC1C,GAAI,CACA,IAAM,EAAM,OAAO,aAAa,QAAQ,CAAG,EAE3C,OADI,IAAQ,KAAa,EAClB,EAAY,CAAG,CAC1B,MAAQ,CACJ,OAAO,CACX,CACJ,EAAG,CAAC,EAAK,EAAc,CAAW,CAAC,EAE7B,CAAC,EAAO,IAAA,EAAa,EAAA,SAAA,CAAY,CAAI,GAE3C,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAU,EAAK,CAAC,CACpB,EAAG,CAAC,CAAI,CAAC,EAET,IAAM,GAAA,EAAW,EAAA,YAAA,CACZ,GAAqC,CAClC,EAAW,GAAY,CACnB,IAAM,EACF,OAAO,GAAS,WAAc,EAAwB,CAAO,EAAI,EACrE,GAAI,CACI,OAAO,OAAW,KAClB,OAAO,aAAa,QAAQ,EAAK,EAAU,CAAQ,CAAC,CAE5D,MAAQ,CAER,CACA,OAAO,CACX,CAAC,CACL,EACA,CAAC,EAAK,CAAS,CACnB,EAEM,GAAA,EAAS,EAAA,YAAA,KAAwB,CACnC,GAAI,CACI,OAAO,OAAW,KAClB,OAAO,aAAa,WAAW,CAAG,CAE1C,MAAQ,CAER,CACA,EAAU,CAAY,CAC1B,EAAG,CAAC,EAAK,CAAY,CAAC,EAoBtB,OAlBA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,EAAa,GAA8B,CACzC,KAAM,MAAQ,EAClB,IAAI,EAAM,WAAa,KAAM,CACzB,EAAU,CAAY,EACtB,MACJ,CACA,GAAI,CACA,EAAU,EAAY,EAAM,QAAQ,CAAC,CACzC,MAAQ,CAER,CALA,CAMJ,EAEA,OADA,OAAO,iBAAiB,UAAW,CAAS,MAC/B,OAAO,oBAAoB,UAAW,CAAS,CAChE,EAAG,CAAC,EAAK,EAAc,CAAW,CAAC,EAE5B,CAAC,EAAO,EAAU,CAAM,CACnC"}
+{"version":3,"file":"use-local-storage.cjs","names":["useCallback","useState","react","defaultSerialize","defaultDeserialize","raw","useLocalStorage","serialize","options","deserialize","read","defaultValue","key","value","setStored","setValue","resolved","next","current","remove","onStorage","event"],"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 * @tempest-limits empty-catch — the three swallows here are the hook's contract.\n * A write that hits the quota (or Safari private mode) still updates React state,\n * so the session keeps working and only persistence is lost; a `storage` event\n * carrying a value this tab cannot deserialize is another tab's bug, and the\n * useful response is to keep the value already rendered rather than tear the\n * component down over a foreign write.\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                    /* empty */\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            /* empty */\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                /* empty */\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"],"mappings":"A,uBAOA,IAAMG,EAAmB,KAAK,UACxBC,EAAyB,GAAmB,KAAK,MAAMC,CAAG,EAmBhE,SAAgBC,EACZ,EACA,EACA,EAAkC,CAAC,EACmB,CACtD,IAAMC,EAAYC,EAAQ,WAAaL,EACjCM,EAAcD,EAAQ,aAAeJ,EAErCM,GAAA,EAAOV,EAAAA,YAAAA,KAAqB,CAC9B,GAAI,OAAO,OAAW,IAAa,OAAOW,EAC1C,GAAI,CACA,IAAMN,EAAM,OAAO,aAAa,QAAQO,CAAG,EAE3C,OADIP,IAAQ,KAAaM,EAClBF,EAAYJ,CAAG,CAC1B,MAAQ,CACJ,OAAOM,CACX,CACJ,EAAG,CAACC,EAAKD,EAAcF,CAAW,CAAC,EAE7B,CAACI,EAAOC,IAAA,EAAab,EAAAA,SAAAA,CAAYS,CAAI,GAE3C,EAAAR,EAAA,UAAA,KAAgB,CACZY,EAAUJ,EAAK,CAAC,CACpB,EAAG,CAACA,CAAI,CAAC,EAET,IAAMK,GAAA,EAAWf,EAAAA,YAAAA,CACZ,GAAqC,CAClCc,EAAW,GAAY,CACnB,IAAME,EACF,OAAOC,GAAS,WAAcA,EAAwBC,CAAO,EAAID,EACrE,GAAI,CACI,OAAO,OAAW,KAClB,OAAO,aAAa,QAAQL,EAAKL,EAAUS,CAAQ,CAAC,CAE5D,MAAQ,CAER,CACA,OAAOA,CACX,CAAC,CACL,EACA,CAACJ,EAAKL,CAAS,CACnB,EAEMY,GAAA,EAASnB,EAAAA,YAAAA,KAAwB,CACnC,GAAI,CACI,OAAO,OAAW,KAClB,OAAO,aAAa,WAAWY,CAAG,CAE1C,MAAQ,CAER,CACAE,EAAUH,CAAY,CAC1B,EAAG,CAACC,EAAKD,CAAY,CAAC,EAoBtB,OAlBA,EAAAT,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAMkB,EAAa,GAA8B,CAC7C,GAAIC,EAAM,MAAQT,EAClB,IAAIS,EAAM,WAAa,KACnBP,EAAUH,CAAY,OAG1B,GAAI,CACAG,EAAUL,EAAYY,EAAM,QAAQ,CAAC,CACzC,MAAQ,CAER,CALA,CAMJ,EAEA,OADA,OAAO,iBAAiB,UAAWD,CAAS,MAC/B,OAAO,oBAAoB,UAAWA,CAAS,CAChE,EAAG,CAACR,EAAKD,EAAcF,CAAW,CAAC,EAE5B,CAACI,EAAOE,EAAUI,CAAM,CACnC,C"}

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

@@ -36,11 +36,8 @@ function a(a, o, s = {}) {
 		if (typeof window > "u") return;
 		let e = (e) => {
 			if (e.key === a) {
-				if (e.newValue === null) {
-					f(o);
-					return;
-				}
-				try {
+				if (e.newValue === null) f(o);
+				else try {
 					f(l(e.newValue));
 				} catch {}
 			}

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

@@ -1 +1 @@
-{"version":3,"file":"use-local-storage.js","names":[],"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 * @tempest-limits empty-catch — the three swallows here are the hook's contract.\n * A write that hits the quota (or Safari private mode) still updates React state,\n * so the session keeps working and only persistence is lost; a `storage` event\n * carrying a value this tab cannot deserialize is another tab's bug, and the\n * useful response is to keep the value already rendered rather than tear the\n * component down over a foreign write.\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                    /* empty */\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            /* empty */\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                /* empty */\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"],"mappings":";;AAOA,IAAM,IAAmB,KAAK,WACxB,KAAyB,MAAmB,KAAK,MAAM,CAAG;AAmBhE,SAAgB,EACZ,GACA,GACA,IAAkC,CAAC,GACmB;CACtD,IAAM,IAAY,EAAQ,aAAa,GACjC,IAAc,EAAQ,eAAe,GAErC,IAAO,QAAqB;EAC9B,IAAI,OAAO,SAAW,KAAa,OAAO;EAC1C,IAAI;GACA,IAAM,IAAM,OAAO,aAAa,QAAQ,CAAG;GAE3C,OADI,MAAQ,OAAa,IAClB,EAAY,CAAG;EAC1B,QAAQ;GACJ,OAAO;EACX;CACJ,GAAG;EAAC;EAAK;EAAc;CAAW,CAAC,GAE7B,CAAC,GAAO,KAAa,EAAY,CAAI;CAE3C,QAAgB;EACZ,EAAU,EAAK,CAAC;CACpB,GAAG,CAAC,CAAI,CAAC;CAET,IAAM,IAAW,GACZ,MAAqC;EAClC,GAAW,MAAY;GACnB,IAAM,IACF,OAAO,KAAS,aAAc,EAAwB,CAAO,IAAI;GACrE,IAAI;IACA,AAAI,OAAO,SAAW,OAClB,OAAO,aAAa,QAAQ,GAAK,EAAU,CAAQ,CAAC;GAE5D,QAAQ,CAER;GACA,OAAO;EACX,CAAC;CACL,GACA,CAAC,GAAK,CAAS,CACnB,GAEM,IAAS,QAAwB;EACnC,IAAI;GACA,AAAI,OAAO,SAAW,OAClB,OAAO,aAAa,WAAW,CAAG;EAE1C,QAAQ,CAER;EACA,EAAU,CAAY;CAC1B,GAAG,CAAC,GAAK,CAAY,CAAC;CAoBtB,OAlBA,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,KAAa,MAA8B;GACzC,MAAM,QAAQ,GAClB;QAAI,EAAM,aAAa,MAAM;KACzB,EAAU,CAAY;KACtB;IACJ;IACA,IAAI;KACA,EAAU,EAAY,EAAM,QAAQ,CAAC;IACzC,QAAQ,CAER;GALA;EAMJ;EAEA,OADA,OAAO,iBAAiB,WAAW,CAAS,SAC/B,OAAO,oBAAoB,WAAW,CAAS;CAChE,GAAG;EAAC;EAAK;EAAc;CAAW,CAAC,GAE5B;EAAC;EAAO;EAAU;CAAM;AACnC"}
+{"version":3,"file":"use-local-storage.js","names":["defaultSerialize","defaultDeserialize","raw","useLocalStorage","serialize","options","deserialize","read","useCallback","defaultValue","key","value","setStored","useState","setValue","resolved","next","current","remove","useEffect","onStorage","event"],"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 * @tempest-limits empty-catch — the three swallows here are the hook's contract.\n * A write that hits the quota (or Safari private mode) still updates React state,\n * so the session keeps working and only persistence is lost; a `storage` event\n * carrying a value this tab cannot deserialize is another tab's bug, and the\n * useful response is to keep the value already rendered rather than tear the\n * component down over a foreign write.\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                    /* empty */\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            /* empty */\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                /* empty */\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"],"mappings":";;AAOA,IAAMA,IAAmB,KAAK,WACxBC,KAAyB,MAAmB,KAAK,MAAMC,CAAG;AAmBhE,SAAgBC,EACZ,GACA,GACA,IAAkC,CAAC,GACmB;CACtD,IAAMC,IAAYC,EAAQ,aAAaL,GACjCM,IAAcD,EAAQ,eAAeJ,GAErCM,IAAOC,QAAqB;EAC9B,IAAI,OAAO,SAAW,KAAa,OAAOC;EAC1C,IAAI;GACA,IAAMP,IAAM,OAAO,aAAa,QAAQQ,CAAG;GAE3C,OADIR,MAAQ,OAAaO,IAClBH,EAAYJ,CAAG;EAC1B,QAAQ;GACJ,OAAOO;EACX;CACJ,GAAG;EAACC;EAAKD;EAAcH;CAAW,CAAC,GAE7B,CAACK,GAAOC,KAAaC,EAAYN,CAAI;CAE3C,QAAgB;EACZ,EAAUA,EAAK,CAAC;CACpB,GAAG,CAACA,CAAI,CAAC;CAET,IAAMO,IAAWN,GACZ,MAAqC;EAClC,GAAW,MAAY;GACnB,IAAMO,IACF,OAAOC,KAAS,aAAcA,EAAwBC,CAAO,IAAID;GACrE,IAAI;IACA,AAAI,OAAO,SAAW,OAClB,OAAO,aAAa,QAAQN,GAAKN,EAAUW,CAAQ,CAAC;GAE5D,QAAQ,CAER;GACA,OAAOA;EACX,CAAC;CACL,GACA,CAACL,GAAKN,CAAS,CACnB,GAEMc,IAASV,QAAwB;EACnC,IAAI;GACA,AAAI,OAAO,SAAW,OAClB,OAAO,aAAa,WAAWE,CAAG;EAE1C,QAAQ,CAER;EACA,EAAUD,CAAY;CAC1B,GAAG,CAACC,GAAKD,CAAY,CAAC;CAoBtB,OAlBAU,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAMC,KAAa,MAA8B;GAC7C,IAAIC,EAAM,QAAQX,GAClB;QAAIW,EAAM,aAAa,MACnB,EAAUZ,CAAY;SAG1B,IAAI;KACA,EAAUH,EAAYe,EAAM,QAAQ,CAAC;IACzC,QAAQ,CAER;GALA;EAMJ;EAEA,OADA,OAAO,iBAAiB,WAAWD,CAAS,SAC/B,OAAO,oBAAoB,WAAWA,CAAS;CAChE,GAAG;EAACV;EAAKD;EAAcH;CAAW,CAAC,GAE5B;EAACK;EAAOG;EAAUI;CAAM;AACnC"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-long-press-handlers.cjs","names":[],"sources":["../../src/hooks/use-long-press-handlers.ts"],"sourcesContent":["import { useCallback, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { MouseEvent as ReactMouseEvent, TouchEvent as ReactTouchEvent } from \"react\";\n\n/**\n * DOM event handlers produced by {@link useLongPressHandlers}, ready to spread\n * onto a JSX element (`<div {...handlers}>`).\n */\nexport interface LongPressHandlers {\n    /** Starts the hold timer on mouse press. */\n    onMouseDown: (event: ReactMouseEvent) => void;\n    /** Cancels the pending hold when the mouse is released. */\n    onMouseUp: () => void;\n    /** Cancels the pending hold when the pointer leaves the element. */\n    onMouseLeave: () => void;\n    /** Starts the hold timer on touch start. */\n    onTouchStart: (event: ReactTouchEvent) => void;\n    /** Cancels the pending hold when the touch ends. */\n    onTouchEnd: () => void;\n    /** Cancels the pending hold when the finger moves. */\n    onTouchMove: () => void;\n    /** Fires the long-press immediately (desktop right-click parity). */\n    onContextMenu: (event: ReactMouseEvent) => void;\n}\n\n/** Options accepted by {@link useLongPressHandlers}. */\nexport interface UseLongPressHandlersOptions {\n    /** Hold duration in ms before `onLongPress` fires. Defaults to `500`. */\n    delayMs?: number;\n    /** When `true`, the hook is inert and every handler is a no-op. */\n    disabled?: boolean;\n}\n\n/** Return shape of {@link useLongPressHandlers}. */\nexport type UseLongPressHandlersResult = LongPressHandlers & {\n    /**\n     * Reads whether the most recent interaction fired a long-press. Use it in\n     * the element's `onClick` to suppress the click that follows a long-press.\n     */\n    wasLongPress: () => boolean;\n};\n\n/**\n * Returns DOM event handlers that detect a long press (touch or mouse hold)\n * and invoke `onLongPress` once after `delayMs`.\n *\n * Cancels on touch movement or pointer release. Also wires `contextmenu` to\n * fire `onLongPress` immediately so a right-click on desktop opens selection\n * mode the same way an Android long-press does on mobile.\n *\n * The hook does not `preventDefault` on the underlying click — the consumer\n * decides whether the subsequent click should still fire. Track that with the\n * returned `wasLongPress()` guard to tell \"long-press fired\" apart from a\n * \"regular click\".\n *\n * Unlike {@link useLongPress}, which attaches pointer listeners to a `ref`,\n * this variant returns handler props you spread directly onto an element and\n * exposes a `wasLongPress()` guard.\n *\n * @param onLongPress - Callback invoked once the hold threshold is reached.\n * @param options - Optional `delayMs` and `disabled` flags.\n * @returns The spreadable handlers plus a `wasLongPress()` guard.\n *\n * @example\n * const longPress = useLongPressHandlers(() => enterSelectionMode(), { delayMs: 600 });\n * <button {...longPress} onClick={() => { if (!longPress.wasLongPress()) navigate(); }}>\n *   Item\n * </button>\n */\nexport function useLongPressHandlers(\n    onLongPress: () => void,\n    options: UseLongPressHandlersOptions = {},\n): UseLongPressHandlersResult {\n    const { delayMs = 500, disabled = false } = options;\n    const timerRef = useRef<number | null>(null);\n    const firedRef = useRef<boolean>(false);\n    const callbackRef = useLatestRef(onLongPress);\n\n    const clear = useCallback((): void => {\n        if (timerRef.current !== null) {\n            window.clearTimeout(timerRef.current);\n            timerRef.current = null;\n        }\n    }, []);\n\n    const start = useCallback((): void => {\n        if (disabled) return;\n        firedRef.current = false;\n        clear();\n        timerRef.current = window.setTimeout(() => {\n            firedRef.current = true;\n            callbackRef.current();\n        }, delayMs);\n    }, [disabled, clear, delayMs, callbackRef]);\n\n    const onContextMenu = useCallback(\n        (event: ReactMouseEvent): void => {\n            if (disabled) return;\n            event.preventDefault();\n            firedRef.current = true;\n            callbackRef.current();\n        },\n        [disabled, callbackRef],\n    );\n\n    return {\n        onMouseDown: start,\n        onMouseUp: clear,\n        onMouseLeave: clear,\n        onTouchStart: start,\n        onTouchEnd: clear,\n        onTouchMove: clear,\n        onContextMenu,\n        wasLongPress: () => firedRef.current,\n    };\n}\n"],"mappings":"+DAqEA,SAAgB,EACZ,EACA,EAAuC,CAAC,EACd,CAC1B,GAAM,CAAE,UAAU,IAAK,WAAW,IAAU,EACtC,GAAA,EAAW,EAAA,OAAA,CAAsB,IAAI,EACrC,GAAA,EAAW,EAAA,OAAA,CAAgB,EAAK,EAChC,EAAc,EAAA,aAAa,CAAW,EAEtC,GAAA,EAAQ,EAAA,YAAA,KAAwB,CAC9B,EAAS,UAAY,OACrB,OAAO,aAAa,EAAS,OAAO,EACpC,EAAS,QAAU,KAE3B,EAAG,CAAC,CAAC,EAEC,GAAA,EAAQ,EAAA,YAAA,KAAwB,CAC9B,IACJ,EAAS,QAAU,GACnB,EAAM,EACN,EAAS,QAAU,OAAO,eAAiB,CACvC,EAAS,QAAU,GACnB,EAAY,QAAQ,CACxB,EAAG,CAAO,EACd,EAAG,CAAC,EAAU,EAAO,EAAS,CAAW,CAAC,EAY1C,MAAO,CACH,YAAa,EACb,UAAW,EACX,aAAc,EACd,aAAc,EACd,WAAY,EACZ,YAAa,EACb,eAAA,EAjBkB,EAAA,YAAA,CACjB,GAAiC,CAC1B,IACJ,EAAM,eAAe,EACrB,EAAS,QAAU,GACnB,EAAY,QAAQ,EACxB,EACA,CAAC,EAAU,CAAW,CAUtB,EACA,iBAAoB,EAAS,OACjC,CACJ"}
+{"version":3,"file":"use-long-press-handlers.cjs","names":["useRef","useLatestRef","useCallback","require_use_latest_ref","react","useLongPressHandlers","options","timerRef","firedRef","callbackRef","onLongPress","clear","start","disabled","delayMs","event"],"sources":["../../src/hooks/use-long-press-handlers.ts"],"sourcesContent":["import { useCallback, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { MouseEvent as ReactMouseEvent, TouchEvent as ReactTouchEvent } from \"react\";\n\n/**\n * DOM event handlers produced by {@link useLongPressHandlers}, ready to spread\n * onto a JSX element (`<div {...handlers}>`).\n */\nexport interface LongPressHandlers {\n    /** Starts the hold timer on mouse press. */\n    onMouseDown: (event: ReactMouseEvent) => void;\n    /** Cancels the pending hold when the mouse is released. */\n    onMouseUp: () => void;\n    /** Cancels the pending hold when the pointer leaves the element. */\n    onMouseLeave: () => void;\n    /** Starts the hold timer on touch start. */\n    onTouchStart: (event: ReactTouchEvent) => void;\n    /** Cancels the pending hold when the touch ends. */\n    onTouchEnd: () => void;\n    /** Cancels the pending hold when the finger moves. */\n    onTouchMove: () => void;\n    /** Fires the long-press immediately (desktop right-click parity). */\n    onContextMenu: (event: ReactMouseEvent) => void;\n}\n\n/** Options accepted by {@link useLongPressHandlers}. */\nexport interface UseLongPressHandlersOptions {\n    /** Hold duration in ms before `onLongPress` fires. Defaults to `500`. */\n    delayMs?: number;\n    /** When `true`, the hook is inert and every handler is a no-op. */\n    disabled?: boolean;\n}\n\n/** Return shape of {@link useLongPressHandlers}. */\nexport type UseLongPressHandlersResult = LongPressHandlers & {\n    /**\n     * Reads whether the most recent interaction fired a long-press. Use it in\n     * the element's `onClick` to suppress the click that follows a long-press.\n     */\n    wasLongPress: () => boolean;\n};\n\n/**\n * Returns DOM event handlers that detect a long press (touch or mouse hold)\n * and invoke `onLongPress` once after `delayMs`.\n *\n * Cancels on touch movement or pointer release. Also wires `contextmenu` to\n * fire `onLongPress` immediately so a right-click on desktop opens selection\n * mode the same way an Android long-press does on mobile.\n *\n * The hook does not `preventDefault` on the underlying click — the consumer\n * decides whether the subsequent click should still fire. Track that with the\n * returned `wasLongPress()` guard to tell \"long-press fired\" apart from a\n * \"regular click\".\n *\n * Unlike {@link useLongPress}, which attaches pointer listeners to a `ref`,\n * this variant returns handler props you spread directly onto an element and\n * exposes a `wasLongPress()` guard.\n *\n * @param onLongPress - Callback invoked once the hold threshold is reached.\n * @param options - Optional `delayMs` and `disabled` flags.\n * @returns The spreadable handlers plus a `wasLongPress()` guard.\n *\n * @example\n * const longPress = useLongPressHandlers(() => enterSelectionMode(), { delayMs: 600 });\n * <button {...longPress} onClick={() => { if (!longPress.wasLongPress()) navigate(); }}>\n *   Item\n * </button>\n */\nexport function useLongPressHandlers(\n    onLongPress: () => void,\n    options: UseLongPressHandlersOptions = {},\n): UseLongPressHandlersResult {\n    const { delayMs = 500, disabled = false } = options;\n    const timerRef = useRef<number | null>(null);\n    const firedRef = useRef<boolean>(false);\n    const callbackRef = useLatestRef(onLongPress);\n\n    const clear = useCallback((): void => {\n        if (timerRef.current !== null) {\n            window.clearTimeout(timerRef.current);\n            timerRef.current = null;\n        }\n    }, []);\n\n    const start = useCallback((): void => {\n        if (disabled) return;\n        firedRef.current = false;\n        clear();\n        timerRef.current = window.setTimeout(() => {\n            firedRef.current = true;\n            callbackRef.current();\n        }, delayMs);\n    }, [disabled, clear, delayMs, callbackRef]);\n\n    const onContextMenu = useCallback(\n        (event: ReactMouseEvent): void => {\n            if (disabled) return;\n            event.preventDefault();\n            firedRef.current = true;\n            callbackRef.current();\n        },\n        [disabled, callbackRef],\n    );\n\n    return {\n        onMouseDown: start,\n        onMouseUp: clear,\n        onMouseLeave: clear,\n        onTouchStart: start,\n        onTouchEnd: clear,\n        onTouchMove: clear,\n        onContextMenu,\n        wasLongPress: () => firedRef.current,\n    };\n}\n"],"mappings":"A,+DAqEA,SAAgBK,EACZ,EACA,EAAuC,CAAC,EACd,CAC1B,GAAM,CAAE,UAAU,IAAK,WAAW,IAAUC,EACtCC,GAAA,EAAWP,EAAAA,OAAAA,CAAsB,IAAI,EACrCQ,GAAA,EAAWR,EAAAA,OAAAA,CAAgB,EAAK,EAChCS,EAAcR,EAAAA,aAAaS,CAAW,EAEtCC,GAAA,EAAQT,EAAAA,YAAAA,KAAwB,CAC9BK,EAAS,UAAY,OACrB,OAAO,aAAaA,EAAS,OAAO,EACpC,EAAS,QAAU,KAE3B,EAAG,CAAC,CAAC,EAECK,GAAA,EAAQV,EAAAA,YAAAA,KAAwB,CAC9BW,IACJ,EAAS,QAAU,GACnBF,EAAM,EACN,EAAS,QAAU,OAAO,eAAiB,CACvC,EAAS,QAAU,GACnBF,EAAY,QAAQ,CACxB,EAAGK,CAAO,EACd,EAAG,CAACD,EAAUF,EAAOG,EAASL,CAAW,CAAC,EAY1C,MAAO,CACH,YAAaG,EACb,UAAWD,EACX,aAAcA,EACd,aAAcC,EACd,WAAYD,EACZ,YAAaA,EACb,eAAA,EAjBkBT,EAAAA,YAAAA,CACjB,GAAiC,CAC1BW,IACJE,EAAM,eAAe,EACrB,EAAS,QAAU,GACnBN,EAAY,QAAQ,EACxB,EACA,CAACI,EAAUJ,CAAW,CAUtB,EACA,iBAAoBD,EAAS,OACjC,CACJ,C"}

package/dist/hooks/use-long-press-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-long-press-handlers.js","names":[],"sources":["../../src/hooks/use-long-press-handlers.ts"],"sourcesContent":["import { useCallback, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { MouseEvent as ReactMouseEvent, TouchEvent as ReactTouchEvent } from \"react\";\n\n/**\n * DOM event handlers produced by {@link useLongPressHandlers}, ready to spread\n * onto a JSX element (`<div {...handlers}>`).\n */\nexport interface LongPressHandlers {\n    /** Starts the hold timer on mouse press. */\n    onMouseDown: (event: ReactMouseEvent) => void;\n    /** Cancels the pending hold when the mouse is released. */\n    onMouseUp: () => void;\n    /** Cancels the pending hold when the pointer leaves the element. */\n    onMouseLeave: () => void;\n    /** Starts the hold timer on touch start. */\n    onTouchStart: (event: ReactTouchEvent) => void;\n    /** Cancels the pending hold when the touch ends. */\n    onTouchEnd: () => void;\n    /** Cancels the pending hold when the finger moves. */\n    onTouchMove: () => void;\n    /** Fires the long-press immediately (desktop right-click parity). */\n    onContextMenu: (event: ReactMouseEvent) => void;\n}\n\n/** Options accepted by {@link useLongPressHandlers}. */\nexport interface UseLongPressHandlersOptions {\n    /** Hold duration in ms before `onLongPress` fires. Defaults to `500`. */\n    delayMs?: number;\n    /** When `true`, the hook is inert and every handler is a no-op. */\n    disabled?: boolean;\n}\n\n/** Return shape of {@link useLongPressHandlers}. */\nexport type UseLongPressHandlersResult = LongPressHandlers & {\n    /**\n     * Reads whether the most recent interaction fired a long-press. Use it in\n     * the element's `onClick` to suppress the click that follows a long-press.\n     */\n    wasLongPress: () => boolean;\n};\n\n/**\n * Returns DOM event handlers that detect a long press (touch or mouse hold)\n * and invoke `onLongPress` once after `delayMs`.\n *\n * Cancels on touch movement or pointer release. Also wires `contextmenu` to\n * fire `onLongPress` immediately so a right-click on desktop opens selection\n * mode the same way an Android long-press does on mobile.\n *\n * The hook does not `preventDefault` on the underlying click — the consumer\n * decides whether the subsequent click should still fire. Track that with the\n * returned `wasLongPress()` guard to tell \"long-press fired\" apart from a\n * \"regular click\".\n *\n * Unlike {@link useLongPress}, which attaches pointer listeners to a `ref`,\n * this variant returns handler props you spread directly onto an element and\n * exposes a `wasLongPress()` guard.\n *\n * @param onLongPress - Callback invoked once the hold threshold is reached.\n * @param options - Optional `delayMs` and `disabled` flags.\n * @returns The spreadable handlers plus a `wasLongPress()` guard.\n *\n * @example\n * const longPress = useLongPressHandlers(() => enterSelectionMode(), { delayMs: 600 });\n * <button {...longPress} onClick={() => { if (!longPress.wasLongPress()) navigate(); }}>\n *   Item\n * </button>\n */\nexport function useLongPressHandlers(\n    onLongPress: () => void,\n    options: UseLongPressHandlersOptions = {},\n): UseLongPressHandlersResult {\n    const { delayMs = 500, disabled = false } = options;\n    const timerRef = useRef<number | null>(null);\n    const firedRef = useRef<boolean>(false);\n    const callbackRef = useLatestRef(onLongPress);\n\n    const clear = useCallback((): void => {\n        if (timerRef.current !== null) {\n            window.clearTimeout(timerRef.current);\n            timerRef.current = null;\n        }\n    }, []);\n\n    const start = useCallback((): void => {\n        if (disabled) return;\n        firedRef.current = false;\n        clear();\n        timerRef.current = window.setTimeout(() => {\n            firedRef.current = true;\n            callbackRef.current();\n        }, delayMs);\n    }, [disabled, clear, delayMs, callbackRef]);\n\n    const onContextMenu = useCallback(\n        (event: ReactMouseEvent): void => {\n            if (disabled) return;\n            event.preventDefault();\n            firedRef.current = true;\n            callbackRef.current();\n        },\n        [disabled, callbackRef],\n    );\n\n    return {\n        onMouseDown: start,\n        onMouseUp: clear,\n        onMouseLeave: clear,\n        onTouchStart: start,\n        onTouchEnd: clear,\n        onTouchMove: clear,\n        onContextMenu,\n        wasLongPress: () => firedRef.current,\n    };\n}\n"],"mappings":";;;AAqEA,SAAgB,EACZ,GACA,IAAuC,CAAC,GACd;CAC1B,IAAM,EAAE,aAAU,KAAK,cAAW,OAAU,GACtC,IAAW,EAAsB,IAAI,GACrC,IAAW,EAAgB,EAAK,GAChC,IAAc,EAAa,CAAW,GAEtC,IAAQ,QAAwB;EAClC,AAAI,EAAS,YAAY,SACrB,OAAO,aAAa,EAAS,OAAO,GACpC,EAAS,UAAU;CAE3B,GAAG,CAAC,CAAC,GAEC,IAAQ,QAAwB;EAC9B,MACJ,EAAS,UAAU,IACnB,EAAM,GACN,EAAS,UAAU,OAAO,iBAAiB;GAEvC,AADA,EAAS,UAAU,IACnB,EAAY,QAAQ;EACxB,GAAG,CAAO;CACd,GAAG;EAAC;EAAU;EAAO;EAAS;CAAW,CAAC;CAY1C,OAAO;EACH,aAAa;EACb,WAAW;EACX,cAAc;EACd,cAAc;EACd,YAAY;EACZ,aAAa;EACb,eAjBkB,GACjB,MAAiC;GAC1B,MACJ,EAAM,eAAe,GACrB,EAAS,UAAU,IACnB,EAAY,QAAQ;EACxB,GACA,CAAC,GAAU,CAAW,CAUtB;EACA,oBAAoB,EAAS;CACjC;AACJ"}
+{"version":3,"file":"use-long-press-handlers.js","names":["useLongPressHandlers","options","timerRef","useRef","firedRef","callbackRef","useLatestRef","onLongPress","clear","useCallback","start","disabled","delayMs","event"],"sources":["../../src/hooks/use-long-press-handlers.ts"],"sourcesContent":["import { useCallback, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { MouseEvent as ReactMouseEvent, TouchEvent as ReactTouchEvent } from \"react\";\n\n/**\n * DOM event handlers produced by {@link useLongPressHandlers}, ready to spread\n * onto a JSX element (`<div {...handlers}>`).\n */\nexport interface LongPressHandlers {\n    /** Starts the hold timer on mouse press. */\n    onMouseDown: (event: ReactMouseEvent) => void;\n    /** Cancels the pending hold when the mouse is released. */\n    onMouseUp: () => void;\n    /** Cancels the pending hold when the pointer leaves the element. */\n    onMouseLeave: () => void;\n    /** Starts the hold timer on touch start. */\n    onTouchStart: (event: ReactTouchEvent) => void;\n    /** Cancels the pending hold when the touch ends. */\n    onTouchEnd: () => void;\n    /** Cancels the pending hold when the finger moves. */\n    onTouchMove: () => void;\n    /** Fires the long-press immediately (desktop right-click parity). */\n    onContextMenu: (event: ReactMouseEvent) => void;\n}\n\n/** Options accepted by {@link useLongPressHandlers}. */\nexport interface UseLongPressHandlersOptions {\n    /** Hold duration in ms before `onLongPress` fires. Defaults to `500`. */\n    delayMs?: number;\n    /** When `true`, the hook is inert and every handler is a no-op. */\n    disabled?: boolean;\n}\n\n/** Return shape of {@link useLongPressHandlers}. */\nexport type UseLongPressHandlersResult = LongPressHandlers & {\n    /**\n     * Reads whether the most recent interaction fired a long-press. Use it in\n     * the element's `onClick` to suppress the click that follows a long-press.\n     */\n    wasLongPress: () => boolean;\n};\n\n/**\n * Returns DOM event handlers that detect a long press (touch or mouse hold)\n * and invoke `onLongPress` once after `delayMs`.\n *\n * Cancels on touch movement or pointer release. Also wires `contextmenu` to\n * fire `onLongPress` immediately so a right-click on desktop opens selection\n * mode the same way an Android long-press does on mobile.\n *\n * The hook does not `preventDefault` on the underlying click — the consumer\n * decides whether the subsequent click should still fire. Track that with the\n * returned `wasLongPress()` guard to tell \"long-press fired\" apart from a\n * \"regular click\".\n *\n * Unlike {@link useLongPress}, which attaches pointer listeners to a `ref`,\n * this variant returns handler props you spread directly onto an element and\n * exposes a `wasLongPress()` guard.\n *\n * @param onLongPress - Callback invoked once the hold threshold is reached.\n * @param options - Optional `delayMs` and `disabled` flags.\n * @returns The spreadable handlers plus a `wasLongPress()` guard.\n *\n * @example\n * const longPress = useLongPressHandlers(() => enterSelectionMode(), { delayMs: 600 });\n * <button {...longPress} onClick={() => { if (!longPress.wasLongPress()) navigate(); }}>\n *   Item\n * </button>\n */\nexport function useLongPressHandlers(\n    onLongPress: () => void,\n    options: UseLongPressHandlersOptions = {},\n): UseLongPressHandlersResult {\n    const { delayMs = 500, disabled = false } = options;\n    const timerRef = useRef<number | null>(null);\n    const firedRef = useRef<boolean>(false);\n    const callbackRef = useLatestRef(onLongPress);\n\n    const clear = useCallback((): void => {\n        if (timerRef.current !== null) {\n            window.clearTimeout(timerRef.current);\n            timerRef.current = null;\n        }\n    }, []);\n\n    const start = useCallback((): void => {\n        if (disabled) return;\n        firedRef.current = false;\n        clear();\n        timerRef.current = window.setTimeout(() => {\n            firedRef.current = true;\n            callbackRef.current();\n        }, delayMs);\n    }, [disabled, clear, delayMs, callbackRef]);\n\n    const onContextMenu = useCallback(\n        (event: ReactMouseEvent): void => {\n            if (disabled) return;\n            event.preventDefault();\n            firedRef.current = true;\n            callbackRef.current();\n        },\n        [disabled, callbackRef],\n    );\n\n    return {\n        onMouseDown: start,\n        onMouseUp: clear,\n        onMouseLeave: clear,\n        onTouchStart: start,\n        onTouchEnd: clear,\n        onTouchMove: clear,\n        onContextMenu,\n        wasLongPress: () => firedRef.current,\n    };\n}\n"],"mappings":";;;AAqEA,SAAgBA,EACZ,GACA,IAAuC,CAAC,GACd;CAC1B,IAAM,EAAE,aAAU,KAAK,cAAW,OAAUC,GACtCC,IAAWC,EAAsB,IAAI,GACrCC,IAAWD,EAAgB,EAAK,GAChCE,IAAcC,EAAaC,CAAW,GAEtCC,IAAQC,QAAwB;EAClC,AAAIP,EAAS,YAAY,SACrB,OAAO,aAAaA,EAAS,OAAO,GACpC,EAAS,UAAU;CAE3B,GAAG,CAAC,CAAC,GAECQ,IAAQD,QAAwB;EAClC,AAAIE,MACJ,EAAS,UAAU,IACnBH,EAAM,GACN,EAAS,UAAU,OAAO,iBAAiB;GAEvC,AADA,EAAS,UAAU,IACnBH,EAAY,QAAQ;EACxB,GAAGO,CAAO;CACd,GAAG;EAACD;EAAUH;EAAOI;EAASP;CAAW,CAAC;CAY1C,OAAO;EACH,aAAaK;EACb,WAAWF;EACX,cAAcA;EACd,cAAcE;EACd,YAAYF;EACZ,aAAaA;EACb,eAjBkBC,GACjB,MAAiC;GAC9B,AAAIE,MACJE,EAAM,eAAe,GACrB,EAAS,UAAU,IACnBR,EAAY,QAAQ;EACxB,GACA,CAACM,GAAUN,CAAW,CAUtB;EACA,oBAAoBD,EAAS;CACjC;AACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-long-press.cjs","names":[],"sources":["../../src/hooks/use-long-press.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\nexport interface UseLongPressOptions {\n    /** Press duration in ms. Default `500`. */\n    delay?: number;\n    /** Pixel threshold — finger/mouse movement beyond this cancels the press. Default `10`. */\n    moveThreshold?: number;\n}\n\n/**\n * Detect long-press / long-tap gestures. Fires `fn` after `delay` ms\n * while the element is held. Cancels on move beyond `moveThreshold` or\n * pointer up before `delay`.\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * useLongPress(ref, () => openContextMenu(), { delay: 600 });\n */\nexport function useLongPress<T extends HTMLElement>(\n    ref: RefObject<T | null>,\n    fn: () => void,\n    options: UseLongPressOptions = {},\n): void {\n    const { delay = 500, moveThreshold = 10 } = options;\n    const fnRef = useLatestRef(fn);\n\n    useEffect(() => {\n        const node = ref.current;\n        if (!node) return;\n        let timer: ReturnType<typeof setTimeout> | null = null;\n        let startX = 0;\n        let startY = 0;\n\n        const cancel = (): void => {\n            if (timer) {\n                clearTimeout(timer);\n                timer = null;\n            }\n        };\n\n        const onDown = (event: PointerEvent): void => {\n            startX = event.clientX;\n            startY = event.clientY;\n            cancel();\n            timer = setTimeout(() => {\n                timer = null;\n                fnRef.current();\n            }, delay);\n        };\n\n        const onMove = (event: PointerEvent): void => {\n            if (timer === null) return;\n            const dx = event.clientX - startX;\n            const dy = event.clientY - startY;\n            if (Math.hypot(dx, dy) > moveThreshold) cancel();\n        };\n\n        node.addEventListener(\"pointerdown\", onDown);\n        node.addEventListener(\"pointermove\", onMove);\n        node.addEventListener(\"pointerup\", cancel);\n        node.addEventListener(\"pointercancel\", cancel);\n        node.addEventListener(\"pointerleave\", cancel);\n        return () => {\n            cancel();\n            node.removeEventListener(\"pointerdown\", onDown);\n            node.removeEventListener(\"pointermove\", onMove);\n            node.removeEventListener(\"pointerup\", cancel);\n            node.removeEventListener(\"pointercancel\", cancel);\n            node.removeEventListener(\"pointerleave\", cancel);\n        };\n    }, [ref, delay, moveThreshold, fnRef]);\n}\n"],"mappings":"+DAoBA,SAAgB,EACZ,EACA,EACA,EAA+B,CAAC,EAC5B,CACJ,GAAM,CAAE,QAAQ,IAAK,gBAAgB,IAAO,EACtC,EAAQ,EAAA,aAAa,CAAE,GAE7B,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAO,EAAI,QACjB,GAAI,CAAC,EAAM,OACX,IAAI,EAA8C,KAC9C,EAAS,EACT,EAAS,EAEP,MAAqB,CACvB,AAEI,KADA,aAAa,CAAK,EACV,KAEhB,EAEM,EAAU,GAA8B,CAC1C,EAAS,EAAM,QACf,EAAS,EAAM,QACf,EAAO,EACP,EAAQ,eAAiB,CACrB,EAAQ,KACR,EAAM,QAAQ,CAClB,EAAG,CAAK,CACZ,EAEM,EAAU,GAA8B,CAC1C,GAAI,IAAU,KAAM,OACpB,IAAM,EAAK,EAAM,QAAU,EACrB,EAAK,EAAM,QAAU,EACvB,KAAK,MAAM,EAAI,CAAE,EAAI,GAAe,EAAO,CACnD,EAOA,OALA,EAAK,iBAAiB,cAAe,CAAM,EAC3C,EAAK,iBAAiB,cAAe,CAAM,EAC3C,EAAK,iBAAiB,YAAa,CAAM,EACzC,EAAK,iBAAiB,gBAAiB,CAAM,EAC7C,EAAK,iBAAiB,eAAgB,CAAM,MAC/B,CACT,EAAO,EACP,EAAK,oBAAoB,cAAe,CAAM,EAC9C,EAAK,oBAAoB,cAAe,CAAM,EAC9C,EAAK,oBAAoB,YAAa,CAAM,EAC5C,EAAK,oBAAoB,gBAAiB,CAAM,EAChD,EAAK,oBAAoB,eAAgB,CAAM,CACnD,CACJ,EAAG,CAAC,EAAK,EAAO,EAAe,CAAK,CAAC,CACzC"}
+{"version":3,"file":"use-long-press.cjs","names":["useLatestRef","require_use_latest_ref","react","useLongPress","options","fnRef","fn","node","ref","timer","startX","startY","cancel","onDown","event","delay","onMove","dx","dy","moveThreshold"],"sources":["../../src/hooks/use-long-press.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\nexport interface UseLongPressOptions {\n    /** Press duration in ms. Default `500`. */\n    delay?: number;\n    /** Pixel threshold — finger/mouse movement beyond this cancels the press. Default `10`. */\n    moveThreshold?: number;\n}\n\n/**\n * Detect long-press / long-tap gestures. Fires `fn` after `delay` ms\n * while the element is held. Cancels on move beyond `moveThreshold` or\n * pointer up before `delay`.\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * useLongPress(ref, () => openContextMenu(), { delay: 600 });\n */\nexport function useLongPress<T extends HTMLElement>(\n    ref: RefObject<T | null>,\n    fn: () => void,\n    options: UseLongPressOptions = {},\n): void {\n    const { delay = 500, moveThreshold = 10 } = options;\n    const fnRef = useLatestRef(fn);\n\n    useEffect(() => {\n        const node = ref.current;\n        if (!node) return;\n        let timer: ReturnType<typeof setTimeout> | null = null;\n        let startX = 0;\n        let startY = 0;\n\n        const cancel = (): void => {\n            if (timer) {\n                clearTimeout(timer);\n                timer = null;\n            }\n        };\n\n        const onDown = (event: PointerEvent): void => {\n            startX = event.clientX;\n            startY = event.clientY;\n            cancel();\n            timer = setTimeout(() => {\n                timer = null;\n                fnRef.current();\n            }, delay);\n        };\n\n        const onMove = (event: PointerEvent): void => {\n            if (timer === null) return;\n            const dx = event.clientX - startX;\n            const dy = event.clientY - startY;\n            if (Math.hypot(dx, dy) > moveThreshold) cancel();\n        };\n\n        node.addEventListener(\"pointerdown\", onDown);\n        node.addEventListener(\"pointermove\", onMove);\n        node.addEventListener(\"pointerup\", cancel);\n        node.addEventListener(\"pointercancel\", cancel);\n        node.addEventListener(\"pointerleave\", cancel);\n        return () => {\n            cancel();\n            node.removeEventListener(\"pointerdown\", onDown);\n            node.removeEventListener(\"pointermove\", onMove);\n            node.removeEventListener(\"pointerup\", cancel);\n            node.removeEventListener(\"pointercancel\", cancel);\n            node.removeEventListener(\"pointerleave\", cancel);\n        };\n    }, [ref, delay, moveThreshold, fnRef]);\n}\n"],"mappings":"A,+DAoBA,SAAgBG,EACZ,EACA,EACA,EAA+B,CAAC,EAC5B,CACJ,GAAM,CAAE,QAAQ,IAAK,gBAAgB,IAAOC,EACtCC,EAAQL,EAAAA,aAAaM,CAAE,GAE7B,EAAAJ,EAAA,UAAA,KAAgB,CACZ,IAAMK,EAAOC,EAAI,QACjB,GAAI,CAACD,EAAM,OACX,IAAIE,EAA8C,KAC9CC,EAAS,EACTC,EAAS,EAEPC,MAAqB,CACvB,AAEIH,KADA,aAAaA,CAAK,EACV,KAEhB,EAEMI,EAAU,GAA8B,CAC1C,EAASC,EAAM,QACf,EAASA,EAAM,QACfF,EAAO,EACP,EAAQ,eAAiB,CACrB,EAAQ,KACRP,EAAM,QAAQ,CAClB,EAAGU,CAAK,CACZ,EAEMC,EAAU,GAA8B,CAC1C,GAAIP,IAAU,KAAM,OACpB,IAAMQ,EAAKH,EAAM,QAAUJ,EACrBQ,EAAKJ,EAAM,QAAUH,EACvB,KAAK,MAAMM,EAAIC,CAAE,EAAIC,GAAeP,EAAO,CACnD,EAOA,OALAL,EAAK,iBAAiB,cAAeM,CAAM,EAC3CN,EAAK,iBAAiB,cAAeS,CAAM,EAC3CT,EAAK,iBAAiB,YAAaK,CAAM,EACzCL,EAAK,iBAAiB,gBAAiBK,CAAM,EAC7CL,EAAK,iBAAiB,eAAgBK,CAAM,MAC/B,CACTA,EAAO,EACPL,EAAK,oBAAoB,cAAeM,CAAM,EAC9CN,EAAK,oBAAoB,cAAeS,CAAM,EAC9CT,EAAK,oBAAoB,YAAaK,CAAM,EAC5CL,EAAK,oBAAoB,gBAAiBK,CAAM,EAChDL,EAAK,oBAAoB,eAAgBK,CAAM,CACnD,CACJ,EAAG,CAACJ,EAAKO,EAAOI,EAAed,CAAK,CAAC,CACzC,C"}