tempest-react-sdk 0.78.0 → 0.79.0

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

@@ -1 +1 @@
-{"version":3,"file":"use-fullscreen.cjs","names":[],"sources":["../../src/hooks/use-fullscreen.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\nimport { getFullscreenElement, useFullscreenElement } from \"./use-fullscreen-element\";\n\n/**\n * The fullscreen members of `document` this hook calls, standard and\n * vendor-prefixed, every one of them optional.\n *\n * `lib.dom` declares the standard members as always present, which is a promise\n * the runtime does not keep: an older WebKit ships only the prefixed pair, and a\n * document inside an `<iframe>` without `allowfullscreen` reports\n * `fullscreenEnabled: false`. Reading through an all-optional shape is what makes\n * `typeof x === \"function\"` a check the compiler agrees is worth making.\n */\ninterface FullscreenDocument {\n    fullscreenEnabled?: boolean;\n    exitFullscreen?: () => Promise<void>;\n    webkitFullscreenEnabled?: boolean;\n    webkitExitFullscreen?: () => Promise<void> | void;\n}\n\n/** The fullscreen members of an element, standard and vendor-prefixed. */\ninterface FullscreenTarget {\n    requestFullscreen?: (options?: FullscreenOptions) => Promise<void>;\n    webkitRequestFullscreen?: () => Promise<void> | void;\n}\n\n/**\n * Resolve which element the hook acts on.\n *\n * `ref.current` when a ref was given, `document.documentElement` when it was not\n * — the whole page, which is what \"go fullscreen\" means with no element named.\n *\n * A missing `ref.current` deliberately resolves to `null` rather than falling\n * back to the page: a caller who named an element and whose element is not\n * mounted yet wants an error, not the entire document blown up to fill the\n * screen behind their video.\n *\n * @param ref - The element to present, or `undefined` for the whole page.\n * @returns The element, or `null` when there is nothing to act on.\n */\nfunction resolveTarget(ref?: RefObject<HTMLElement | null>): HTMLElement | null {\n    if (typeof document === \"undefined\") return null;\n    return ref ? ref.current : document.documentElement;\n}\n\n/**\n * Whether this environment can present anything fullscreen at all.\n *\n * Two independent reasons for `false`, and skipping either one ships a button\n * that does nothing when pressed: the API can be missing (older WebKit, and every\n * browser on iOS for non-`<video>` elements), or present and **disabled** — a\n * document inside an `<iframe>` without the `allowfullscreen` attribute exposes\n * `requestFullscreen` and rejects every call to it, which `fullscreenEnabled`\n * reports up front.\n *\n * An engine that exposes the methods and no flag at all is treated as capable:\n * the flag is the newer half of the API, so its absence says nothing.\n *\n * @returns `true` when a fullscreen request stands a chance of being honoured.\n */\nexport function isFullscreenSupported(): boolean {\n    if (typeof document === \"undefined\") return false;\n    const root: FullscreenTarget = document.documentElement;\n    const doc: FullscreenDocument = document;\n    const reachable =\n        typeof root.requestFullscreen === \"function\" ||\n        typeof root.webkitRequestFullscreen === \"function\";\n    return reachable && (doc.fullscreenEnabled ?? doc.webkitFullscreenEnabled ?? true);\n}\n\n/** Value returned by {@link useFullscreen}. */\nexport interface UseFullscreenResult {\n    /** Whether the target element is the one the browser is presenting right now. */\n    isFullscreen: boolean;\n    /** Whether a request stands a chance at all — hide the control when `false`. */\n    supported: boolean;\n    /** Present the target. Must be called from a user gesture. Rejects if refused. */\n    enter: () => Promise<void>;\n    /** Leave fullscreen. Resolves immediately when nothing is presented. */\n    exit: () => Promise<void>;\n    /** Leave if the target is presented, otherwise enter. Same gesture rule as `enter`. */\n    toggle: () => Promise<void>;\n}\n\n/**\n * Drive an immersive mode whose state stays true to the browser.\n *\n * The mistake this exists to remove is storing `isFullscreen` in state and\n * flipping it inside your own `enter()` / `exit()`. Fullscreen ends in ways your\n * code never sees — `Esc`, the browser's own exit affordance, F11 pressed while an\n * API fullscreen is active — and each of those leaves the flag saying \"sair\" over\n * a page that is already windowed. The only honest source is the\n * `fullscreenchange` event, which fires for every one of them, so that is what\n * this hook reads and what the returned `isFullscreen` reflects. The action\n * callbacks never touch it.\n *\n * The subscription is not this hook's own: it lives in `useFullscreenElement`,\n * shared with `usePortalHost`, which needs the same fact to decide where an\n * overlay mounts while fullscreen is on. Two independent listeners for one event\n * would mean two copies of the WebKit prefix dance and two places to fix the next\n * quirk, so the primitive answers \"which element is presented\" once and each\n * consumer asks its own question of the answer.\n *\n * WebKit's prefixed members are handled throughout — `webkitfullscreenchange`,\n * `webkitFullscreenElement`, `webkitRequestFullscreen`, `webkitExitFullscreen` —\n * because Safari on iPad still ships them and nothing else.\n *\n * `isFullscreen` is identity against the target, not containment: a `<video>`\n * inside your element going fullscreen on its own is not your element being\n * presented, and reporting `true` there would put your exit control inside a\n * subtree the browser is not painting.\n *\n * @param ref - The element to present. Omit it to present the whole page\n * (`document.documentElement`).\n * @returns `{ isFullscreen, supported, enter, exit, toggle }`.\n * @throws Nothing during render. `enter()` and `toggle()` reject with the\n * browser's own error when the request is refused — most often a `TypeError`\n * because the call did not come from a user gesture — and with an `Error` when\n * there is no element to present or the environment ships no Fullscreen API.\n *\n * @example\n * const stage = useRef<HTMLDivElement>(null);\n * const { isFullscreen, supported, toggle } = useFullscreen(stage);\n *\n * <div ref={stage}>\n *   <video src=\"/aula.mp4\" controls />\n *   {supported ? (\n *     <button onClick={() => void toggle().catch(() => setRefused(true))}>\n *       {isFullscreen ? \"Sair da tela cheia\" : \"Tela cheia\"}\n *     </button>\n *   ) : null}\n * </div>\n */\nexport function useFullscreen(ref?: RefObject<HTMLElement | null>): UseFullscreenResult {\n    const element = useFullscreenElement();\n    const [supported] = useState(isFullscreenSupported);\n    const [isFullscreen, setIsFullscreen] = useState(false);\n\n    useEffect(() => {\n        const target = resolveTarget(ref);\n        setIsFullscreen(target !== null && element === target);\n    }, [element, ref]);\n\n    const enter = useCallback(async (): Promise<void> => {\n        const target = resolveTarget(ref);\n        if (target === null) {\n            throw new Error(\n                \"useFullscreen: nothing to present. Either this environment has no document, \" +\n                    \"or the ref was never attached to a mounted element.\",\n            );\n        }\n        const candidate: FullscreenTarget = target;\n        if (typeof candidate.requestFullscreen === \"function\") {\n            await candidate.requestFullscreen();\n            return;\n        }\n        if (typeof candidate.webkitRequestFullscreen === \"function\") {\n            await candidate.webkitRequestFullscreen();\n            return;\n        }\n        throw new Error(\"useFullscreen: this browser exposes no way to enter fullscreen.\");\n    }, [ref]);\n\n    const exit = useCallback(async (): Promise<void> => {\n        if (getFullscreenElement() === null) return;\n        const doc: FullscreenDocument = document;\n        if (typeof doc.exitFullscreen === \"function\") {\n            await doc.exitFullscreen();\n            return;\n        }\n        if (typeof doc.webkitExitFullscreen === \"function\") {\n            await doc.webkitExitFullscreen();\n            return;\n        }\n        throw new Error(\"useFullscreen: this browser exposes no way to leave fullscreen.\");\n    }, []);\n\n    const toggle = useCallback(async (): Promise<void> => {\n        const target = resolveTarget(ref);\n        if (target !== null && getFullscreenElement() === target) {\n            await exit();\n            return;\n        }\n        await enter();\n    }, [enter, exit, ref]);\n\n    return { isFullscreen, supported, enter, exit, toggle };\n}\n"],"mappings":"uEAyCA,SAAS,EAAc,EAAyD,CAE5E,OADI,OAAO,SAAa,IAAoB,KACrC,EAAM,EAAI,QAAU,SAAS,eACxC,CAiBA,SAAgB,GAAiC,CAC7C,GAAI,OAAO,SAAa,IAAa,MAAO,GAC5C,IAAM,EAAyB,SAAS,gBAClC,EAA0B,SAIhC,OAFI,OAAO,EAAK,mBAAsB,YAClC,OAAO,EAAK,yBAA4B,cACvB,EAAI,mBAAqB,EAAI,yBAA2B,GACjF,CAiEA,SAAgB,EAAc,EAA0D,CACpF,IAAM,EAAU,EAAA,qBAAqB,EAC/B,CAAC,IAAA,EAAa,EAAA,SAAA,CAAS,CAAqB,EAC5C,CAAC,EAAc,IAAA,EAAmB,EAAA,SAAA,CAAS,EAAK,GAEtD,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAS,EAAc,CAAG,EAChC,EAAgB,IAAW,MAAQ,IAAY,CAAM,CACzD,EAAG,CAAC,EAAS,CAAG,CAAC,EAEjB,IAAM,GAAA,EAAQ,EAAA,YAAA,CAAY,SAA2B,CACjD,IAAM,EAAS,EAAc,CAAG,EAChC,GAAI,IAAW,KACX,MAAU,MACN,iIAEJ,EAEJ,IAAM,EAA8B,EACpC,GAAI,OAAO,EAAU,mBAAsB,WAAY,CACnD,MAAM,EAAU,kBAAkB,EAClC,MACJ,CACA,GAAI,OAAO,EAAU,yBAA4B,WAAY,CACzD,MAAM,EAAU,wBAAwB,EACxC,MACJ,CACA,MAAU,MAAM,iEAAiE,CACrF,EAAG,CAAC,CAAG,CAAC,EAEF,GAAA,EAAO,EAAA,YAAA,CAAY,SAA2B,CAChD,GAAI,EAAA,qBAAqB,IAAM,KAAM,OACrC,IAAM,EAA0B,SAChC,GAAI,OAAO,EAAI,gBAAmB,WAAY,CAC1C,MAAM,EAAI,eAAe,EACzB,MACJ,CACA,GAAI,OAAO,EAAI,sBAAyB,WAAY,CAChD,MAAM,EAAI,qBAAqB,EAC/B,MACJ,CACA,MAAU,MAAM,iEAAiE,CACrF,EAAG,CAAC,CAAC,EAWL,MAAO,CAAE,eAAc,YAAW,QAAO,OAAM,QAAA,EAThC,EAAA,YAAA,CAAY,SAA2B,CAClD,IAAM,EAAS,EAAc,CAAG,EAChC,GAAI,IAAW,MAAQ,EAAA,qBAAqB,IAAM,EAAQ,CACtD,MAAM,EAAK,EACX,MACJ,CACA,MAAM,EAAM,CAChB,EAAG,CAAC,EAAO,EAAM,CAAG,CAE2B,CAAO,CAC1D"}
+{"version":3,"file":"use-fullscreen.cjs","names":["useFullscreenElement","useState","useCallback","getFullscreenElement","require_use_fullscreen_element","react","resolveTarget","ref","isFullscreenSupported","root","doc","useFullscreen","element","supported","isFullscreen","setIsFullscreen","target","enter","candidate","exit"],"sources":["../../src/hooks/use-fullscreen.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\nimport { getFullscreenElement, useFullscreenElement } from \"./use-fullscreen-element\";\n\n/**\n * The fullscreen members of `document` this hook calls, standard and\n * vendor-prefixed, every one of them optional.\n *\n * `lib.dom` declares the standard members as always present, which is a promise\n * the runtime does not keep: an older WebKit ships only the prefixed pair, and a\n * document inside an `<iframe>` without `allowfullscreen` reports\n * `fullscreenEnabled: false`. Reading through an all-optional shape is what makes\n * `typeof x === \"function\"` a check the compiler agrees is worth making.\n */\ninterface FullscreenDocument {\n    fullscreenEnabled?: boolean;\n    exitFullscreen?: () => Promise<void>;\n    webkitFullscreenEnabled?: boolean;\n    webkitExitFullscreen?: () => Promise<void> | void;\n}\n\n/** The fullscreen members of an element, standard and vendor-prefixed. */\ninterface FullscreenTarget {\n    requestFullscreen?: (options?: FullscreenOptions) => Promise<void>;\n    webkitRequestFullscreen?: () => Promise<void> | void;\n}\n\n/**\n * Resolve which element the hook acts on.\n *\n * `ref.current` when a ref was given, `document.documentElement` when it was not\n * — the whole page, which is what \"go fullscreen\" means with no element named.\n *\n * A missing `ref.current` deliberately resolves to `null` rather than falling\n * back to the page: a caller who named an element and whose element is not\n * mounted yet wants an error, not the entire document blown up to fill the\n * screen behind their video.\n *\n * @param ref - The element to present, or `undefined` for the whole page.\n * @returns The element, or `null` when there is nothing to act on.\n */\nfunction resolveTarget(ref?: RefObject<HTMLElement | null>): HTMLElement | null {\n    if (typeof document === \"undefined\") return null;\n    return ref ? ref.current : document.documentElement;\n}\n\n/**\n * Whether this environment can present anything fullscreen at all.\n *\n * Two independent reasons for `false`, and skipping either one ships a button\n * that does nothing when pressed: the API can be missing (older WebKit, and every\n * browser on iOS for non-`<video>` elements), or present and **disabled** — a\n * document inside an `<iframe>` without the `allowfullscreen` attribute exposes\n * `requestFullscreen` and rejects every call to it, which `fullscreenEnabled`\n * reports up front.\n *\n * An engine that exposes the methods and no flag at all is treated as capable:\n * the flag is the newer half of the API, so its absence says nothing.\n *\n * @returns `true` when a fullscreen request stands a chance of being honoured.\n */\nexport function isFullscreenSupported(): boolean {\n    if (typeof document === \"undefined\") return false;\n    const root: FullscreenTarget = document.documentElement;\n    const doc: FullscreenDocument = document;\n    const reachable =\n        typeof root.requestFullscreen === \"function\" ||\n        typeof root.webkitRequestFullscreen === \"function\";\n    return reachable && (doc.fullscreenEnabled ?? doc.webkitFullscreenEnabled ?? true);\n}\n\n/** Value returned by {@link useFullscreen}. */\nexport interface UseFullscreenResult {\n    /** Whether the target element is the one the browser is presenting right now. */\n    isFullscreen: boolean;\n    /** Whether a request stands a chance at all — hide the control when `false`. */\n    supported: boolean;\n    /** Present the target. Must be called from a user gesture. Rejects if refused. */\n    enter: () => Promise<void>;\n    /** Leave fullscreen. Resolves immediately when nothing is presented. */\n    exit: () => Promise<void>;\n    /** Leave if the target is presented, otherwise enter. Same gesture rule as `enter`. */\n    toggle: () => Promise<void>;\n}\n\n/**\n * Drive an immersive mode whose state stays true to the browser.\n *\n * The mistake this exists to remove is storing `isFullscreen` in state and\n * flipping it inside your own `enter()` / `exit()`. Fullscreen ends in ways your\n * code never sees — `Esc`, the browser's own exit affordance, F11 pressed while an\n * API fullscreen is active — and each of those leaves the flag saying \"sair\" over\n * a page that is already windowed. The only honest source is the\n * `fullscreenchange` event, which fires for every one of them, so that is what\n * this hook reads and what the returned `isFullscreen` reflects. The action\n * callbacks never touch it.\n *\n * The subscription is not this hook's own: it lives in `useFullscreenElement`,\n * shared with `usePortalHost`, which needs the same fact to decide where an\n * overlay mounts while fullscreen is on. Two independent listeners for one event\n * would mean two copies of the WebKit prefix dance and two places to fix the next\n * quirk, so the primitive answers \"which element is presented\" once and each\n * consumer asks its own question of the answer.\n *\n * WebKit's prefixed members are handled throughout — `webkitfullscreenchange`,\n * `webkitFullscreenElement`, `webkitRequestFullscreen`, `webkitExitFullscreen` —\n * because Safari on iPad still ships them and nothing else.\n *\n * `isFullscreen` is identity against the target, not containment: a `<video>`\n * inside your element going fullscreen on its own is not your element being\n * presented, and reporting `true` there would put your exit control inside a\n * subtree the browser is not painting.\n *\n * @param ref - The element to present. Omit it to present the whole page\n * (`document.documentElement`).\n * @returns `{ isFullscreen, supported, enter, exit, toggle }`.\n * @throws Nothing during render. `enter()` and `toggle()` reject with the\n * browser's own error when the request is refused — most often a `TypeError`\n * because the call did not come from a user gesture — and with an `Error` when\n * there is no element to present or the environment ships no Fullscreen API.\n *\n * @example\n * const stage = useRef<HTMLDivElement>(null);\n * const { isFullscreen, supported, toggle } = useFullscreen(stage);\n *\n * <div ref={stage}>\n *   <video src=\"/aula.mp4\" controls />\n *   {supported ? (\n *     <button onClick={() => void toggle().catch(() => setRefused(true))}>\n *       {isFullscreen ? \"Sair da tela cheia\" : \"Tela cheia\"}\n *     </button>\n *   ) : null}\n * </div>\n */\nexport function useFullscreen(ref?: RefObject<HTMLElement | null>): UseFullscreenResult {\n    const element = useFullscreenElement();\n    const [supported] = useState(isFullscreenSupported);\n    const [isFullscreen, setIsFullscreen] = useState(false);\n\n    useEffect(() => {\n        const target = resolveTarget(ref);\n        setIsFullscreen(target !== null && element === target);\n    }, [element, ref]);\n\n    const enter = useCallback(async (): Promise<void> => {\n        const target = resolveTarget(ref);\n        if (target === null) {\n            throw new Error(\n                \"useFullscreen: nothing to present. Either this environment has no document, \" +\n                    \"or the ref was never attached to a mounted element.\",\n            );\n        }\n        const candidate: FullscreenTarget = target;\n        if (typeof candidate.requestFullscreen === \"function\") {\n            await candidate.requestFullscreen();\n            return;\n        }\n        if (typeof candidate.webkitRequestFullscreen === \"function\") {\n            await candidate.webkitRequestFullscreen();\n            return;\n        }\n        throw new Error(\"useFullscreen: this browser exposes no way to enter fullscreen.\");\n    }, [ref]);\n\n    const exit = useCallback(async (): Promise<void> => {\n        if (getFullscreenElement() === null) return;\n        const doc: FullscreenDocument = document;\n        if (typeof doc.exitFullscreen === \"function\") {\n            await doc.exitFullscreen();\n            return;\n        }\n        if (typeof doc.webkitExitFullscreen === \"function\") {\n            await doc.webkitExitFullscreen();\n            return;\n        }\n        throw new Error(\"useFullscreen: this browser exposes no way to leave fullscreen.\");\n    }, []);\n\n    const toggle = useCallback(async (): Promise<void> => {\n        const target = resolveTarget(ref);\n        if (target !== null && getFullscreenElement() === target) {\n            await exit();\n            return;\n        }\n        await enter();\n    }, [enter, exit, ref]);\n\n    return { isFullscreen, supported, enter, exit, toggle };\n}\n"],"mappings":"A,uEAyCA,SAASM,EAAc,EAAyD,CAE5E,OADI,OAAO,SAAa,IAAoB,KACrCC,EAAMA,EAAI,QAAU,SAAS,eACxC,CAiBA,SAAgBC,GAAiC,CAC7C,GAAI,OAAO,SAAa,IAAa,MAAO,GAC5C,IAAMC,EAAyB,SAAS,gBAClCC,EAA0B,SAIhC,OAFI,OAAOD,EAAK,mBAAsB,YAClC,OAAOA,EAAK,yBAA4B,cACvBC,EAAI,mBAAqBA,EAAI,yBAA2B,GACjF,CAiEA,SAAgBC,EAAc,EAA0D,CACpF,IAAMC,EAAUZ,EAAAA,qBAAqB,EAC/B,CAACa,IAAA,EAAaZ,EAAAA,SAAAA,CAASO,CAAqB,EAC5C,CAACM,EAAcC,IAAA,EAAmBd,EAAAA,SAAAA,CAAS,EAAK,GAEtD,EAAAI,EAAA,UAAA,KAAgB,CACZ,IAAMW,EAASV,EAAcC,CAAG,EAChCQ,EAAgBC,IAAW,MAAQJ,IAAYI,CAAM,CACzD,EAAG,CAACJ,EAASL,CAAG,CAAC,EAEjB,IAAMU,GAAA,EAAQf,EAAAA,YAAAA,CAAY,SAA2B,CACjD,IAAMc,EAASV,EAAcC,CAAG,EAChC,GAAIS,IAAW,KACX,MAAU,MACN,iIAEJ,EAEJ,IAAME,EAA8BF,EACpC,GAAI,OAAOE,EAAU,mBAAsB,WACvC,MAAMA,EAAU,kBAAkB,OAGtC,GAAI,OAAOA,EAAU,yBAA4B,WAC7C,MAAMA,EAAU,wBAAwB,OAG5C,MAAU,MAAM,iEAAiE,CACrF,EAAG,CAACX,CAAG,CAAC,EAEFY,GAAA,EAAOjB,EAAAA,YAAAA,CAAY,SAA2B,CAChD,GAAIC,EAAAA,qBAAqB,IAAM,KAAM,OACrC,IAAMO,EAA0B,SAChC,GAAI,OAAOA,EAAI,gBAAmB,WAC9B,MAAMA,EAAI,eAAe,OAG7B,GAAI,OAAOA,EAAI,sBAAyB,WACpC,MAAMA,EAAI,qBAAqB,OAGnC,MAAU,MAAM,iEAAiE,CACrF,EAAG,CAAC,CAAC,EAWL,MAAO,CAAE,eAAc,YAAW,QAAO,OAAM,QAAA,EAThCR,EAAAA,YAAAA,CAAY,SAA2B,CAClD,IAAMc,EAASV,EAAcC,CAAG,EAC5BS,IAAW,MAAQb,EAAAA,qBAAqB,IAAMa,EAC9C,MAAMG,EAAK,EAGf,MAAMF,EAAM,CAChB,EAAG,CAACA,EAAOE,EAAMZ,CAAG,CAE2B,CAAO,CAC1D,C"}

package/dist/hooks/use-fullscreen.js

@@ -19,27 +19,15 @@ function s(s) {
 		let e = a(s);
 		if (e === null) throw Error("useFullscreen: nothing to present. Either this environment has no document, or the ref was never attached to a mounted element.");
 		let t = e;
-		if (typeof t.requestFullscreen == "function") {
-			await t.requestFullscreen();
-			return;
-		}
-		if (typeof t.webkitRequestFullscreen == "function") {
-			await t.webkitRequestFullscreen();
-			return;
-		}
-		throw Error("useFullscreen: this browser exposes no way to enter fullscreen.");
+		if (typeof t.requestFullscreen == "function") await t.requestFullscreen();
+		else if (typeof t.webkitRequestFullscreen == "function") await t.webkitRequestFullscreen();
+		else throw Error("useFullscreen: this browser exposes no way to enter fullscreen.");
 	}, [s]), p = n(async () => {
 		if (e() === null) return;
 		let t = document;
-		if (typeof t.exitFullscreen == "function") {
-			await t.exitFullscreen();
-			return;
-		}
-		if (typeof t.webkitExitFullscreen == "function") {
-			await t.webkitExitFullscreen();
-			return;
-		}
-		throw Error("useFullscreen: this browser exposes no way to leave fullscreen.");
+		if (typeof t.exitFullscreen == "function") await t.exitFullscreen();
+		else if (typeof t.webkitExitFullscreen == "function") await t.webkitExitFullscreen();
+		else throw Error("useFullscreen: this browser exposes no way to leave fullscreen.");
 	}, []);
 	return {
 		isFullscreen: u,
@@ -48,11 +36,7 @@ function s(s) {
 		exit: p,
 		toggle: n(async () => {
 			let t = a(s);
-			if (t !== null && e() === t) {
-				await p();
-				return;
-			}
-			await f();
+			t !== null && e() === t ? await p() : await f();
 		}, [
 			f,
 			p,

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

@@ -1 +1 @@
-{"version":3,"file":"use-fullscreen.js","names":[],"sources":["../../src/hooks/use-fullscreen.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\nimport { getFullscreenElement, useFullscreenElement } from \"./use-fullscreen-element\";\n\n/**\n * The fullscreen members of `document` this hook calls, standard and\n * vendor-prefixed, every one of them optional.\n *\n * `lib.dom` declares the standard members as always present, which is a promise\n * the runtime does not keep: an older WebKit ships only the prefixed pair, and a\n * document inside an `<iframe>` without `allowfullscreen` reports\n * `fullscreenEnabled: false`. Reading through an all-optional shape is what makes\n * `typeof x === \"function\"` a check the compiler agrees is worth making.\n */\ninterface FullscreenDocument {\n    fullscreenEnabled?: boolean;\n    exitFullscreen?: () => Promise<void>;\n    webkitFullscreenEnabled?: boolean;\n    webkitExitFullscreen?: () => Promise<void> | void;\n}\n\n/** The fullscreen members of an element, standard and vendor-prefixed. */\ninterface FullscreenTarget {\n    requestFullscreen?: (options?: FullscreenOptions) => Promise<void>;\n    webkitRequestFullscreen?: () => Promise<void> | void;\n}\n\n/**\n * Resolve which element the hook acts on.\n *\n * `ref.current` when a ref was given, `document.documentElement` when it was not\n * — the whole page, which is what \"go fullscreen\" means with no element named.\n *\n * A missing `ref.current` deliberately resolves to `null` rather than falling\n * back to the page: a caller who named an element and whose element is not\n * mounted yet wants an error, not the entire document blown up to fill the\n * screen behind their video.\n *\n * @param ref - The element to present, or `undefined` for the whole page.\n * @returns The element, or `null` when there is nothing to act on.\n */\nfunction resolveTarget(ref?: RefObject<HTMLElement | null>): HTMLElement | null {\n    if (typeof document === \"undefined\") return null;\n    return ref ? ref.current : document.documentElement;\n}\n\n/**\n * Whether this environment can present anything fullscreen at all.\n *\n * Two independent reasons for `false`, and skipping either one ships a button\n * that does nothing when pressed: the API can be missing (older WebKit, and every\n * browser on iOS for non-`<video>` elements), or present and **disabled** — a\n * document inside an `<iframe>` without the `allowfullscreen` attribute exposes\n * `requestFullscreen` and rejects every call to it, which `fullscreenEnabled`\n * reports up front.\n *\n * An engine that exposes the methods and no flag at all is treated as capable:\n * the flag is the newer half of the API, so its absence says nothing.\n *\n * @returns `true` when a fullscreen request stands a chance of being honoured.\n */\nexport function isFullscreenSupported(): boolean {\n    if (typeof document === \"undefined\") return false;\n    const root: FullscreenTarget = document.documentElement;\n    const doc: FullscreenDocument = document;\n    const reachable =\n        typeof root.requestFullscreen === \"function\" ||\n        typeof root.webkitRequestFullscreen === \"function\";\n    return reachable && (doc.fullscreenEnabled ?? doc.webkitFullscreenEnabled ?? true);\n}\n\n/** Value returned by {@link useFullscreen}. */\nexport interface UseFullscreenResult {\n    /** Whether the target element is the one the browser is presenting right now. */\n    isFullscreen: boolean;\n    /** Whether a request stands a chance at all — hide the control when `false`. */\n    supported: boolean;\n    /** Present the target. Must be called from a user gesture. Rejects if refused. */\n    enter: () => Promise<void>;\n    /** Leave fullscreen. Resolves immediately when nothing is presented. */\n    exit: () => Promise<void>;\n    /** Leave if the target is presented, otherwise enter. Same gesture rule as `enter`. */\n    toggle: () => Promise<void>;\n}\n\n/**\n * Drive an immersive mode whose state stays true to the browser.\n *\n * The mistake this exists to remove is storing `isFullscreen` in state and\n * flipping it inside your own `enter()` / `exit()`. Fullscreen ends in ways your\n * code never sees — `Esc`, the browser's own exit affordance, F11 pressed while an\n * API fullscreen is active — and each of those leaves the flag saying \"sair\" over\n * a page that is already windowed. The only honest source is the\n * `fullscreenchange` event, which fires for every one of them, so that is what\n * this hook reads and what the returned `isFullscreen` reflects. The action\n * callbacks never touch it.\n *\n * The subscription is not this hook's own: it lives in `useFullscreenElement`,\n * shared with `usePortalHost`, which needs the same fact to decide where an\n * overlay mounts while fullscreen is on. Two independent listeners for one event\n * would mean two copies of the WebKit prefix dance and two places to fix the next\n * quirk, so the primitive answers \"which element is presented\" once and each\n * consumer asks its own question of the answer.\n *\n * WebKit's prefixed members are handled throughout — `webkitfullscreenchange`,\n * `webkitFullscreenElement`, `webkitRequestFullscreen`, `webkitExitFullscreen` —\n * because Safari on iPad still ships them and nothing else.\n *\n * `isFullscreen` is identity against the target, not containment: a `<video>`\n * inside your element going fullscreen on its own is not your element being\n * presented, and reporting `true` there would put your exit control inside a\n * subtree the browser is not painting.\n *\n * @param ref - The element to present. Omit it to present the whole page\n * (`document.documentElement`).\n * @returns `{ isFullscreen, supported, enter, exit, toggle }`.\n * @throws Nothing during render. `enter()` and `toggle()` reject with the\n * browser's own error when the request is refused — most often a `TypeError`\n * because the call did not come from a user gesture — and with an `Error` when\n * there is no element to present or the environment ships no Fullscreen API.\n *\n * @example\n * const stage = useRef<HTMLDivElement>(null);\n * const { isFullscreen, supported, toggle } = useFullscreen(stage);\n *\n * <div ref={stage}>\n *   <video src=\"/aula.mp4\" controls />\n *   {supported ? (\n *     <button onClick={() => void toggle().catch(() => setRefused(true))}>\n *       {isFullscreen ? \"Sair da tela cheia\" : \"Tela cheia\"}\n *     </button>\n *   ) : null}\n * </div>\n */\nexport function useFullscreen(ref?: RefObject<HTMLElement | null>): UseFullscreenResult {\n    const element = useFullscreenElement();\n    const [supported] = useState(isFullscreenSupported);\n    const [isFullscreen, setIsFullscreen] = useState(false);\n\n    useEffect(() => {\n        const target = resolveTarget(ref);\n        setIsFullscreen(target !== null && element === target);\n    }, [element, ref]);\n\n    const enter = useCallback(async (): Promise<void> => {\n        const target = resolveTarget(ref);\n        if (target === null) {\n            throw new Error(\n                \"useFullscreen: nothing to present. Either this environment has no document, \" +\n                    \"or the ref was never attached to a mounted element.\",\n            );\n        }\n        const candidate: FullscreenTarget = target;\n        if (typeof candidate.requestFullscreen === \"function\") {\n            await candidate.requestFullscreen();\n            return;\n        }\n        if (typeof candidate.webkitRequestFullscreen === \"function\") {\n            await candidate.webkitRequestFullscreen();\n            return;\n        }\n        throw new Error(\"useFullscreen: this browser exposes no way to enter fullscreen.\");\n    }, [ref]);\n\n    const exit = useCallback(async (): Promise<void> => {\n        if (getFullscreenElement() === null) return;\n        const doc: FullscreenDocument = document;\n        if (typeof doc.exitFullscreen === \"function\") {\n            await doc.exitFullscreen();\n            return;\n        }\n        if (typeof doc.webkitExitFullscreen === \"function\") {\n            await doc.webkitExitFullscreen();\n            return;\n        }\n        throw new Error(\"useFullscreen: this browser exposes no way to leave fullscreen.\");\n    }, []);\n\n    const toggle = useCallback(async (): Promise<void> => {\n        const target = resolveTarget(ref);\n        if (target !== null && getFullscreenElement() === target) {\n            await exit();\n            return;\n        }\n        await enter();\n    }, [enter, exit, ref]);\n\n    return { isFullscreen, supported, enter, exit, toggle };\n}\n"],"mappings":";;;AAyCA,SAAS,EAAc,GAAyD;CAE5E,OADI,OAAO,WAAa,MAAoB,OACrC,IAAM,EAAI,UAAU,SAAS;AACxC;AAiBA,SAAgB,IAAiC;CAC7C,IAAI,OAAO,WAAa,KAAa,OAAO;CAC5C,IAAM,IAAyB,SAAS,iBAClC,IAA0B;CAIhC,QAFI,OAAO,EAAK,qBAAsB,cAClC,OAAO,EAAK,2BAA4B,gBACvB,EAAI,qBAAqB,EAAI,2BAA2B;AACjF;AAiEA,SAAgB,EAAc,GAA0D;CACpF,IAAM,IAAU,EAAqB,GAC/B,CAAC,KAAa,EAAS,CAAqB,GAC5C,CAAC,GAAc,KAAmB,EAAS,EAAK;CAEtD,QAAgB;EACZ,IAAM,IAAS,EAAc,CAAG;EAChC,EAAgB,MAAW,QAAQ,MAAY,CAAM;CACzD,GAAG,CAAC,GAAS,CAAG,CAAC;CAEjB,IAAM,IAAQ,EAAY,YAA2B;EACjD,IAAM,IAAS,EAAc,CAAG;EAChC,IAAI,MAAW,MACX,MAAU,MACN,iIAEJ;EAEJ,IAAM,IAA8B;EACpC,IAAI,OAAO,EAAU,qBAAsB,YAAY;GACnD,MAAM,EAAU,kBAAkB;GAClC;EACJ;EACA,IAAI,OAAO,EAAU,2BAA4B,YAAY;GACzD,MAAM,EAAU,wBAAwB;GACxC;EACJ;EACA,MAAU,MAAM,iEAAiE;CACrF,GAAG,CAAC,CAAG,CAAC,GAEF,IAAO,EAAY,YAA2B;EAChD,IAAI,EAAqB,MAAM,MAAM;EACrC,IAAM,IAA0B;EAChC,IAAI,OAAO,EAAI,kBAAmB,YAAY;GAC1C,MAAM,EAAI,eAAe;GACzB;EACJ;EACA,IAAI,OAAO,EAAI,wBAAyB,YAAY;GAChD,MAAM,EAAI,qBAAqB;GAC/B;EACJ;EACA,MAAU,MAAM,iEAAiE;CACrF,GAAG,CAAC,CAAC;CAWL,OAAO;EAAE;EAAc;EAAW;EAAO;EAAM,QAThC,EAAY,YAA2B;GAClD,IAAM,IAAS,EAAc,CAAG;GAChC,IAAI,MAAW,QAAQ,EAAqB,MAAM,GAAQ;IACtD,MAAM,EAAK;IACX;GACJ;GACA,MAAM,EAAM;EAChB,GAAG;GAAC;GAAO;GAAM;EAAG,CAE2B;CAAO;AAC1D"}
+{"version":3,"file":"use-fullscreen.js","names":["resolveTarget","ref","isFullscreenSupported","root","doc","useFullscreen","element","useFullscreenElement","supported","useState","isFullscreen","setIsFullscreen","target","enter","useCallback","candidate","exit","getFullscreenElement"],"sources":["../../src/hooks/use-fullscreen.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\nimport { getFullscreenElement, useFullscreenElement } from \"./use-fullscreen-element\";\n\n/**\n * The fullscreen members of `document` this hook calls, standard and\n * vendor-prefixed, every one of them optional.\n *\n * `lib.dom` declares the standard members as always present, which is a promise\n * the runtime does not keep: an older WebKit ships only the prefixed pair, and a\n * document inside an `<iframe>` without `allowfullscreen` reports\n * `fullscreenEnabled: false`. Reading through an all-optional shape is what makes\n * `typeof x === \"function\"` a check the compiler agrees is worth making.\n */\ninterface FullscreenDocument {\n    fullscreenEnabled?: boolean;\n    exitFullscreen?: () => Promise<void>;\n    webkitFullscreenEnabled?: boolean;\n    webkitExitFullscreen?: () => Promise<void> | void;\n}\n\n/** The fullscreen members of an element, standard and vendor-prefixed. */\ninterface FullscreenTarget {\n    requestFullscreen?: (options?: FullscreenOptions) => Promise<void>;\n    webkitRequestFullscreen?: () => Promise<void> | void;\n}\n\n/**\n * Resolve which element the hook acts on.\n *\n * `ref.current` when a ref was given, `document.documentElement` when it was not\n * — the whole page, which is what \"go fullscreen\" means with no element named.\n *\n * A missing `ref.current` deliberately resolves to `null` rather than falling\n * back to the page: a caller who named an element and whose element is not\n * mounted yet wants an error, not the entire document blown up to fill the\n * screen behind their video.\n *\n * @param ref - The element to present, or `undefined` for the whole page.\n * @returns The element, or `null` when there is nothing to act on.\n */\nfunction resolveTarget(ref?: RefObject<HTMLElement | null>): HTMLElement | null {\n    if (typeof document === \"undefined\") return null;\n    return ref ? ref.current : document.documentElement;\n}\n\n/**\n * Whether this environment can present anything fullscreen at all.\n *\n * Two independent reasons for `false`, and skipping either one ships a button\n * that does nothing when pressed: the API can be missing (older WebKit, and every\n * browser on iOS for non-`<video>` elements), or present and **disabled** — a\n * document inside an `<iframe>` without the `allowfullscreen` attribute exposes\n * `requestFullscreen` and rejects every call to it, which `fullscreenEnabled`\n * reports up front.\n *\n * An engine that exposes the methods and no flag at all is treated as capable:\n * the flag is the newer half of the API, so its absence says nothing.\n *\n * @returns `true` when a fullscreen request stands a chance of being honoured.\n */\nexport function isFullscreenSupported(): boolean {\n    if (typeof document === \"undefined\") return false;\n    const root: FullscreenTarget = document.documentElement;\n    const doc: FullscreenDocument = document;\n    const reachable =\n        typeof root.requestFullscreen === \"function\" ||\n        typeof root.webkitRequestFullscreen === \"function\";\n    return reachable && (doc.fullscreenEnabled ?? doc.webkitFullscreenEnabled ?? true);\n}\n\n/** Value returned by {@link useFullscreen}. */\nexport interface UseFullscreenResult {\n    /** Whether the target element is the one the browser is presenting right now. */\n    isFullscreen: boolean;\n    /** Whether a request stands a chance at all — hide the control when `false`. */\n    supported: boolean;\n    /** Present the target. Must be called from a user gesture. Rejects if refused. */\n    enter: () => Promise<void>;\n    /** Leave fullscreen. Resolves immediately when nothing is presented. */\n    exit: () => Promise<void>;\n    /** Leave if the target is presented, otherwise enter. Same gesture rule as `enter`. */\n    toggle: () => Promise<void>;\n}\n\n/**\n * Drive an immersive mode whose state stays true to the browser.\n *\n * The mistake this exists to remove is storing `isFullscreen` in state and\n * flipping it inside your own `enter()` / `exit()`. Fullscreen ends in ways your\n * code never sees — `Esc`, the browser's own exit affordance, F11 pressed while an\n * API fullscreen is active — and each of those leaves the flag saying \"sair\" over\n * a page that is already windowed. The only honest source is the\n * `fullscreenchange` event, which fires for every one of them, so that is what\n * this hook reads and what the returned `isFullscreen` reflects. The action\n * callbacks never touch it.\n *\n * The subscription is not this hook's own: it lives in `useFullscreenElement`,\n * shared with `usePortalHost`, which needs the same fact to decide where an\n * overlay mounts while fullscreen is on. Two independent listeners for one event\n * would mean two copies of the WebKit prefix dance and two places to fix the next\n * quirk, so the primitive answers \"which element is presented\" once and each\n * consumer asks its own question of the answer.\n *\n * WebKit's prefixed members are handled throughout — `webkitfullscreenchange`,\n * `webkitFullscreenElement`, `webkitRequestFullscreen`, `webkitExitFullscreen` —\n * because Safari on iPad still ships them and nothing else.\n *\n * `isFullscreen` is identity against the target, not containment: a `<video>`\n * inside your element going fullscreen on its own is not your element being\n * presented, and reporting `true` there would put your exit control inside a\n * subtree the browser is not painting.\n *\n * @param ref - The element to present. Omit it to present the whole page\n * (`document.documentElement`).\n * @returns `{ isFullscreen, supported, enter, exit, toggle }`.\n * @throws Nothing during render. `enter()` and `toggle()` reject with the\n * browser's own error when the request is refused — most often a `TypeError`\n * because the call did not come from a user gesture — and with an `Error` when\n * there is no element to present or the environment ships no Fullscreen API.\n *\n * @example\n * const stage = useRef<HTMLDivElement>(null);\n * const { isFullscreen, supported, toggle } = useFullscreen(stage);\n *\n * <div ref={stage}>\n *   <video src=\"/aula.mp4\" controls />\n *   {supported ? (\n *     <button onClick={() => void toggle().catch(() => setRefused(true))}>\n *       {isFullscreen ? \"Sair da tela cheia\" : \"Tela cheia\"}\n *     </button>\n *   ) : null}\n * </div>\n */\nexport function useFullscreen(ref?: RefObject<HTMLElement | null>): UseFullscreenResult {\n    const element = useFullscreenElement();\n    const [supported] = useState(isFullscreenSupported);\n    const [isFullscreen, setIsFullscreen] = useState(false);\n\n    useEffect(() => {\n        const target = resolveTarget(ref);\n        setIsFullscreen(target !== null && element === target);\n    }, [element, ref]);\n\n    const enter = useCallback(async (): Promise<void> => {\n        const target = resolveTarget(ref);\n        if (target === null) {\n            throw new Error(\n                \"useFullscreen: nothing to present. Either this environment has no document, \" +\n                    \"or the ref was never attached to a mounted element.\",\n            );\n        }\n        const candidate: FullscreenTarget = target;\n        if (typeof candidate.requestFullscreen === \"function\") {\n            await candidate.requestFullscreen();\n            return;\n        }\n        if (typeof candidate.webkitRequestFullscreen === \"function\") {\n            await candidate.webkitRequestFullscreen();\n            return;\n        }\n        throw new Error(\"useFullscreen: this browser exposes no way to enter fullscreen.\");\n    }, [ref]);\n\n    const exit = useCallback(async (): Promise<void> => {\n        if (getFullscreenElement() === null) return;\n        const doc: FullscreenDocument = document;\n        if (typeof doc.exitFullscreen === \"function\") {\n            await doc.exitFullscreen();\n            return;\n        }\n        if (typeof doc.webkitExitFullscreen === \"function\") {\n            await doc.webkitExitFullscreen();\n            return;\n        }\n        throw new Error(\"useFullscreen: this browser exposes no way to leave fullscreen.\");\n    }, []);\n\n    const toggle = useCallback(async (): Promise<void> => {\n        const target = resolveTarget(ref);\n        if (target !== null && getFullscreenElement() === target) {\n            await exit();\n            return;\n        }\n        await enter();\n    }, [enter, exit, ref]);\n\n    return { isFullscreen, supported, enter, exit, toggle };\n}\n"],"mappings":";;;AAyCA,SAASA,EAAc,GAAyD;CAE5E,OADI,OAAO,WAAa,MAAoB,OACrCC,IAAMA,EAAI,UAAU,SAAS;AACxC;AAiBA,SAAgBC,IAAiC;CAC7C,IAAI,OAAO,WAAa,KAAa,OAAO;CAC5C,IAAMC,IAAyB,SAAS,iBAClCC,IAA0B;CAIhC,QAFI,OAAOD,EAAK,qBAAsB,cAClC,OAAOA,EAAK,2BAA4B,gBACvBC,EAAI,qBAAqBA,EAAI,2BAA2B;AACjF;AAiEA,SAAgBC,EAAc,GAA0D;CACpF,IAAMC,IAAUC,EAAqB,GAC/B,CAACC,KAAaC,EAASP,CAAqB,GAC5C,CAACQ,GAAcC,KAAmBF,EAAS,EAAK;CAEtD,QAAgB;EACZ,IAAMG,IAASZ,EAAcC,CAAG;EAChC,EAAgBW,MAAW,QAAQN,MAAYM,CAAM;CACzD,GAAG,CAACN,GAASL,CAAG,CAAC;CAEjB,IAAMY,IAAQC,EAAY,YAA2B;EACjD,IAAMF,IAASZ,EAAcC,CAAG;EAChC,IAAIW,MAAW,MACX,MAAU,MACN,iIAEJ;EAEJ,IAAMG,IAA8BH;EACpC,IAAI,OAAOG,EAAU,qBAAsB,YACvC,MAAMA,EAAU,kBAAkB;OAGtC,IAAI,OAAOA,EAAU,2BAA4B,YAC7C,MAAMA,EAAU,wBAAwB;OAG5C,MAAU,MAAM,iEAAiE;CACrF,GAAG,CAACd,CAAG,CAAC,GAEFe,IAAOF,EAAY,YAA2B;EAChD,IAAIG,EAAqB,MAAM,MAAM;EACrC,IAAMb,IAA0B;EAChC,IAAI,OAAOA,EAAI,kBAAmB,YAC9B,MAAMA,EAAI,eAAe;OAG7B,IAAI,OAAOA,EAAI,wBAAyB,YACpC,MAAMA,EAAI,qBAAqB;OAGnC,MAAU,MAAM,iEAAiE;CACrF,GAAG,CAAC,CAAC;CAWL,OAAO;EAAE;EAAc;EAAW;EAAO;EAAM,QAThCU,EAAY,YAA2B;GAClD,IAAMF,IAASZ,EAAcC,CAAG;GAChC,AAAIW,MAAW,QAAQK,EAAqB,MAAML,IAC9C,MAAMI,EAAK,IAGf,MAAMH,EAAM;EAChB,GAAG;GAACA;GAAOG;GAAMf;EAAG,CAE2B;CAAO;AAC1D"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-geolocation.cjs","names":[],"sources":["../../src/hooks/use-geolocation.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface GeolocationState {\n    loading: boolean;\n    error: GeolocationPositionError | null;\n    coords: GeolocationCoordinates | null;\n    timestamp: number | null;\n}\n\nexport interface UseGeolocationOptions extends PositionOptions {\n    /** Use `watchPosition` instead of one-shot `getCurrentPosition`. Default: false. */\n    watch?: boolean;\n    /** Disable the hook without unmounting. Default: false. */\n    disabled?: boolean;\n}\n\n/**\n * React hook around the Geolocation API.\n *\n * The effect depends on the individual `PositionOptions` fields instead of the\n * rest object, which is a new reference on every render and would restart the\n * watch continuously. `exhaustive-deps` is silenced there because those fields\n * are the whole of what the effect reads from it.\n *\n * @param options - Geolocation options plus `watch` and `disabled` switches.\n * @returns The latest position, error and loading state.\n */\nexport function useGeolocation(options: UseGeolocationOptions = {}): GeolocationState {\n    const { watch = false, disabled = false, ...positionOptions } = options;\n    const [state, setState] = useState<GeolocationState>({\n        loading: !disabled,\n        error: null,\n        coords: null,\n        timestamp: null,\n    });\n\n    useEffect(() => {\n        if (disabled || typeof navigator === \"undefined\" || !navigator.geolocation) {\n            setState((prev) => ({ ...prev, loading: false }));\n            return;\n        }\n\n        const onSuccess = (position: GeolocationPosition): void => {\n            setState({\n                loading: false,\n                error: null,\n                coords: position.coords,\n                timestamp: position.timestamp,\n            });\n        };\n        const onError = (error: GeolocationPositionError): void => {\n            setState((prev) => ({ ...prev, loading: false, error }));\n        };\n\n        if (watch) {\n            const watchId = navigator.geolocation.watchPosition(\n                onSuccess,\n                onError,\n                positionOptions,\n            );\n            return () => navigator.geolocation.clearWatch(watchId);\n        }\n\n        navigator.geolocation.getCurrentPosition(onSuccess, onError, positionOptions);\n        return undefined;\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n        disabled,\n        watch,\n        positionOptions.enableHighAccuracy,\n        positionOptions.maximumAge,\n        positionOptions.timeout,\n    ]);\n\n    return state;\n}\n"],"mappings":"uBA2BA,SAAgB,EAAe,EAAiC,CAAC,EAAqB,CAClF,GAAM,CAAE,QAAQ,GAAO,WAAW,GAAO,GAAG,GAAoB,EAC1D,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAA2B,CACjD,QAAS,CAAC,EACV,MAAO,KACP,OAAQ,KACR,UAAW,IACf,CAAC,EAwCD,OAtCA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,GAAY,OAAO,UAAc,KAAe,CAAC,UAAU,YAAa,CACxE,EAAU,IAAU,CAAE,GAAG,EAAM,QAAS,EAAM,EAAE,EAChD,MACJ,CAEA,IAAM,EAAa,GAAwC,CACvD,EAAS,CACL,QAAS,GACT,MAAO,KACP,OAAQ,EAAS,OACjB,UAAW,EAAS,SACxB,CAAC,CACL,EACM,EAAW,GAA0C,CACvD,EAAU,IAAU,CAAE,GAAG,EAAM,QAAS,GAAO,OAAM,EAAE,CAC3D,EAEA,GAAI,EAAO,CACP,IAAM,EAAU,UAAU,YAAY,cAClC,EACA,EACA,CACJ,EACA,UAAa,UAAU,YAAY,WAAW,CAAO,CACzD,CAEA,UAAU,YAAY,mBAAmB,EAAW,EAAS,CAAe,CAGhF,EAAG,CACC,EACA,EACA,EAAgB,mBAChB,EAAgB,WAChB,EAAgB,OACpB,CAAC,EAEM,CACX"}
+{"version":3,"file":"use-geolocation.cjs","names":["useState","react","useGeolocation","positionOptions","options","state","setState","disabled","prev","onSuccess","position","onError","watch","watchId"],"sources":["../../src/hooks/use-geolocation.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface GeolocationState {\n    loading: boolean;\n    error: GeolocationPositionError | null;\n    coords: GeolocationCoordinates | null;\n    timestamp: number | null;\n}\n\nexport interface UseGeolocationOptions extends PositionOptions {\n    /** Use `watchPosition` instead of one-shot `getCurrentPosition`. Default: false. */\n    watch?: boolean;\n    /** Disable the hook without unmounting. Default: false. */\n    disabled?: boolean;\n}\n\n/**\n * React hook around the Geolocation API.\n *\n * The effect depends on the individual `PositionOptions` fields instead of the\n * rest object, which is a new reference on every render and would restart the\n * watch continuously. `exhaustive-deps` is silenced there because those fields\n * are the whole of what the effect reads from it.\n *\n * @param options - Geolocation options plus `watch` and `disabled` switches.\n * @returns The latest position, error and loading state.\n */\nexport function useGeolocation(options: UseGeolocationOptions = {}): GeolocationState {\n    const { watch = false, disabled = false, ...positionOptions } = options;\n    const [state, setState] = useState<GeolocationState>({\n        loading: !disabled,\n        error: null,\n        coords: null,\n        timestamp: null,\n    });\n\n    useEffect(() => {\n        if (disabled || typeof navigator === \"undefined\" || !navigator.geolocation) {\n            setState((prev) => ({ ...prev, loading: false }));\n            return;\n        }\n\n        const onSuccess = (position: GeolocationPosition): void => {\n            setState({\n                loading: false,\n                error: null,\n                coords: position.coords,\n                timestamp: position.timestamp,\n            });\n        };\n        const onError = (error: GeolocationPositionError): void => {\n            setState((prev) => ({ ...prev, loading: false, error }));\n        };\n\n        if (watch) {\n            const watchId = navigator.geolocation.watchPosition(\n                onSuccess,\n                onError,\n                positionOptions,\n            );\n            return () => navigator.geolocation.clearWatch(watchId);\n        }\n\n        navigator.geolocation.getCurrentPosition(onSuccess, onError, positionOptions);\n        return undefined;\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n        disabled,\n        watch,\n        positionOptions.enableHighAccuracy,\n        positionOptions.maximumAge,\n        positionOptions.timeout,\n    ]);\n\n    return state;\n}\n"],"mappings":"A,uBA2BA,SAAgBE,EAAe,EAAiC,CAAC,EAAqB,CAClF,GAAM,CAAE,QAAQ,GAAO,WAAW,GAAO,GAAGC,GAAoBC,EAC1D,CAACC,EAAOC,IAAA,EAAYN,EAAAA,SAAAA,CAA2B,CACjD,QAAS,CAACO,EACV,MAAO,KACP,OAAQ,KACR,UAAW,IACf,CAAC,EAwCD,OAtCA,EAAAN,EAAA,UAAA,KAAgB,CACZ,GAAIM,GAAY,OAAO,UAAc,KAAe,CAAC,UAAU,YAAa,CACxED,EAAU,IAAU,CAAE,GAAGE,EAAM,QAAS,EAAM,EAAE,EAChD,MACJ,CAEA,IAAMC,EAAa,GAAwC,CACvDH,EAAS,CACL,QAAS,GACT,MAAO,KACP,OAAQI,EAAS,OACjB,UAAWA,EAAS,SACxB,CAAC,CACL,EACMC,EAAW,GAA0C,CACvDL,EAAU,IAAU,CAAE,GAAGE,EAAM,QAAS,GAAO,OAAM,EAAE,CAC3D,EAEA,GAAII,EAAO,CACP,IAAMC,EAAU,UAAU,YAAY,cAClCJ,EACAE,EACAR,CACJ,EACA,UAAa,UAAU,YAAY,WAAWU,CAAO,CACzD,CAEA,UAAU,YAAY,mBAAmBJ,EAAWE,EAASR,CAAe,CAGhF,EAAG,CACCI,EACAK,EACAT,EAAgB,mBAChBA,EAAgB,WAChBA,EAAgB,OACpB,CAAC,EAEME,CACX,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-geolocation.js","names":[],"sources":["../../src/hooks/use-geolocation.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface GeolocationState {\n    loading: boolean;\n    error: GeolocationPositionError | null;\n    coords: GeolocationCoordinates | null;\n    timestamp: number | null;\n}\n\nexport interface UseGeolocationOptions extends PositionOptions {\n    /** Use `watchPosition` instead of one-shot `getCurrentPosition`. Default: false. */\n    watch?: boolean;\n    /** Disable the hook without unmounting. Default: false. */\n    disabled?: boolean;\n}\n\n/**\n * React hook around the Geolocation API.\n *\n * The effect depends on the individual `PositionOptions` fields instead of the\n * rest object, which is a new reference on every render and would restart the\n * watch continuously. `exhaustive-deps` is silenced there because those fields\n * are the whole of what the effect reads from it.\n *\n * @param options - Geolocation options plus `watch` and `disabled` switches.\n * @returns The latest position, error and loading state.\n */\nexport function useGeolocation(options: UseGeolocationOptions = {}): GeolocationState {\n    const { watch = false, disabled = false, ...positionOptions } = options;\n    const [state, setState] = useState<GeolocationState>({\n        loading: !disabled,\n        error: null,\n        coords: null,\n        timestamp: null,\n    });\n\n    useEffect(() => {\n        if (disabled || typeof navigator === \"undefined\" || !navigator.geolocation) {\n            setState((prev) => ({ ...prev, loading: false }));\n            return;\n        }\n\n        const onSuccess = (position: GeolocationPosition): void => {\n            setState({\n                loading: false,\n                error: null,\n                coords: position.coords,\n                timestamp: position.timestamp,\n            });\n        };\n        const onError = (error: GeolocationPositionError): void => {\n            setState((prev) => ({ ...prev, loading: false, error }));\n        };\n\n        if (watch) {\n            const watchId = navigator.geolocation.watchPosition(\n                onSuccess,\n                onError,\n                positionOptions,\n            );\n            return () => navigator.geolocation.clearWatch(watchId);\n        }\n\n        navigator.geolocation.getCurrentPosition(onSuccess, onError, positionOptions);\n        return undefined;\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n        disabled,\n        watch,\n        positionOptions.enableHighAccuracy,\n        positionOptions.maximumAge,\n        positionOptions.timeout,\n    ]);\n\n    return state;\n}\n"],"mappings":";;AA2BA,SAAgB,EAAe,IAAiC,CAAC,GAAqB;CAClF,IAAM,EAAE,WAAQ,IAAO,cAAW,IAAO,GAAG,MAAoB,GAC1D,CAAC,GAAO,KAAY,EAA2B;EACjD,SAAS,CAAC;EACV,OAAO;EACP,QAAQ;EACR,WAAW;CACf,CAAC;CAwCD,OAtCA,QAAgB;EACZ,IAAI,KAAY,OAAO,YAAc,OAAe,CAAC,UAAU,aAAa;GACxE,GAAU,OAAU;IAAE,GAAG;IAAM,SAAS;GAAM,EAAE;GAChD;EACJ;EAEA,IAAM,KAAa,MAAwC;GACvD,EAAS;IACL,SAAS;IACT,OAAO;IACP,QAAQ,EAAS;IACjB,WAAW,EAAS;GACxB,CAAC;EACL,GACM,KAAW,MAA0C;GACvD,GAAU,OAAU;IAAE,GAAG;IAAM,SAAS;IAAO;GAAM,EAAE;EAC3D;EAEA,IAAI,GAAO;GACP,IAAM,IAAU,UAAU,YAAY,cAClC,GACA,GACA,CACJ;GACA,aAAa,UAAU,YAAY,WAAW,CAAO;EACzD;EAEA,UAAU,YAAY,mBAAmB,GAAW,GAAS,CAAe;CAGhF,GAAG;EACC;EACA;EACA,EAAgB;EAChB,EAAgB;EAChB,EAAgB;CACpB,CAAC,GAEM;AACX"}
+{"version":3,"file":"use-geolocation.js","names":["useGeolocation","positionOptions","options","state","setState","useState","disabled","useEffect","prev","onSuccess","position","onError","watch","watchId"],"sources":["../../src/hooks/use-geolocation.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface GeolocationState {\n    loading: boolean;\n    error: GeolocationPositionError | null;\n    coords: GeolocationCoordinates | null;\n    timestamp: number | null;\n}\n\nexport interface UseGeolocationOptions extends PositionOptions {\n    /** Use `watchPosition` instead of one-shot `getCurrentPosition`. Default: false. */\n    watch?: boolean;\n    /** Disable the hook without unmounting. Default: false. */\n    disabled?: boolean;\n}\n\n/**\n * React hook around the Geolocation API.\n *\n * The effect depends on the individual `PositionOptions` fields instead of the\n * rest object, which is a new reference on every render and would restart the\n * watch continuously. `exhaustive-deps` is silenced there because those fields\n * are the whole of what the effect reads from it.\n *\n * @param options - Geolocation options plus `watch` and `disabled` switches.\n * @returns The latest position, error and loading state.\n */\nexport function useGeolocation(options: UseGeolocationOptions = {}): GeolocationState {\n    const { watch = false, disabled = false, ...positionOptions } = options;\n    const [state, setState] = useState<GeolocationState>({\n        loading: !disabled,\n        error: null,\n        coords: null,\n        timestamp: null,\n    });\n\n    useEffect(() => {\n        if (disabled || typeof navigator === \"undefined\" || !navigator.geolocation) {\n            setState((prev) => ({ ...prev, loading: false }));\n            return;\n        }\n\n        const onSuccess = (position: GeolocationPosition): void => {\n            setState({\n                loading: false,\n                error: null,\n                coords: position.coords,\n                timestamp: position.timestamp,\n            });\n        };\n        const onError = (error: GeolocationPositionError): void => {\n            setState((prev) => ({ ...prev, loading: false, error }));\n        };\n\n        if (watch) {\n            const watchId = navigator.geolocation.watchPosition(\n                onSuccess,\n                onError,\n                positionOptions,\n            );\n            return () => navigator.geolocation.clearWatch(watchId);\n        }\n\n        navigator.geolocation.getCurrentPosition(onSuccess, onError, positionOptions);\n        return undefined;\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n        disabled,\n        watch,\n        positionOptions.enableHighAccuracy,\n        positionOptions.maximumAge,\n        positionOptions.timeout,\n    ]);\n\n    return state;\n}\n"],"mappings":";;AA2BA,SAAgBA,EAAe,IAAiC,CAAC,GAAqB;CAClF,IAAM,EAAE,WAAQ,IAAO,cAAW,IAAO,GAAGC,MAAoBC,GAC1D,CAACC,GAAOC,KAAYC,EAA2B;EACjD,SAAS,CAACC;EACV,OAAO;EACP,QAAQ;EACR,WAAW;CACf,CAAC;CAwCD,OAtCAC,QAAgB;EACZ,IAAID,KAAY,OAAO,YAAc,OAAe,CAAC,UAAU,aAAa;GACxE,GAAU,OAAU;IAAE,GAAGE;IAAM,SAAS;GAAM,EAAE;GAChD;EACJ;EAEA,IAAMC,KAAa,MAAwC;GACvD,EAAS;IACL,SAAS;IACT,OAAO;IACP,QAAQC,EAAS;IACjB,WAAWA,EAAS;GACxB,CAAC;EACL,GACMC,KAAW,MAA0C;GACvD,GAAU,OAAU;IAAE,GAAGH;IAAM,SAAS;IAAO;GAAM,EAAE;EAC3D;EAEA,IAAII,GAAO;GACP,IAAMC,IAAU,UAAU,YAAY,cAClCJ,GACAE,GACAV,CACJ;GACA,aAAa,UAAU,YAAY,WAAWY,CAAO;EACzD;EAEA,UAAU,YAAY,mBAAmBJ,GAAWE,GAASV,CAAe;CAGhF,GAAG;EACCK;EACAM;EACAX,EAAgB;EAChBA,EAAgB;EAChBA,EAAgB;CACpB,CAAC,GAEME;AACX"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-hover.cjs","names":[],"sources":["../../src/hooks/use-hover.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\n/**\n * Track whether the pointer is hovering over the referenced element.\n * Returns `false` on touch-only devices (no pointer hover).\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * const hovered = useHover(ref);\n * return <div ref={ref}>{hovered ? \"✨\" : \"\"}</div>;\n */\nexport function useHover<T extends HTMLElement>(ref: RefObject<T | null>): boolean {\n    const [hovered, setHovered] = useState<boolean>(false);\n\n    useEffect(() => {\n        const node = ref.current;\n        if (!node) return;\n        const onEnter = (): void => setHovered(true);\n        const onLeave = (): void => setHovered(false);\n        node.addEventListener(\"mouseenter\", onEnter);\n        node.addEventListener(\"mouseleave\", onLeave);\n        return () => {\n            node.removeEventListener(\"mouseenter\", onEnter);\n            node.removeEventListener(\"mouseleave\", onLeave);\n        };\n    }, [ref]);\n\n    return hovered;\n}\n"],"mappings":"uBAYA,SAAgB,EAAgC,EAAmC,CAC/E,GAAM,CAAC,EAAS,IAAA,EAAc,EAAA,SAAA,CAAkB,EAAK,EAerD,OAbA,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAO,EAAI,QACjB,GAAI,CAAC,EAAM,OACX,IAAM,MAAsB,EAAW,EAAI,EACrC,MAAsB,EAAW,EAAK,EAG5C,OAFA,EAAK,iBAAiB,aAAc,CAAO,EAC3C,EAAK,iBAAiB,aAAc,CAAO,MAC9B,CACT,EAAK,oBAAoB,aAAc,CAAO,EAC9C,EAAK,oBAAoB,aAAc,CAAO,CAClD,CACJ,EAAG,CAAC,CAAG,CAAC,EAED,CACX"}
+{"version":3,"file":"use-hover.cjs","names":["useState","react","useHover","hovered","setHovered","node","ref","onEnter","onLeave"],"sources":["../../src/hooks/use-hover.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\n/**\n * Track whether the pointer is hovering over the referenced element.\n * Returns `false` on touch-only devices (no pointer hover).\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * const hovered = useHover(ref);\n * return <div ref={ref}>{hovered ? \"✨\" : \"\"}</div>;\n */\nexport function useHover<T extends HTMLElement>(ref: RefObject<T | null>): boolean {\n    const [hovered, setHovered] = useState<boolean>(false);\n\n    useEffect(() => {\n        const node = ref.current;\n        if (!node) return;\n        const onEnter = (): void => setHovered(true);\n        const onLeave = (): void => setHovered(false);\n        node.addEventListener(\"mouseenter\", onEnter);\n        node.addEventListener(\"mouseleave\", onLeave);\n        return () => {\n            node.removeEventListener(\"mouseenter\", onEnter);\n            node.removeEventListener(\"mouseleave\", onLeave);\n        };\n    }, [ref]);\n\n    return hovered;\n}\n"],"mappings":"A,uBAYA,SAAgBE,EAAgC,EAAmC,CAC/E,GAAM,CAACC,EAASC,IAAA,EAAcJ,EAAAA,SAAAA,CAAkB,EAAK,EAerD,OAbA,EAAAC,EAAA,UAAA,KAAgB,CACZ,IAAMI,EAAOC,EAAI,QACjB,GAAI,CAACD,EAAM,OACX,IAAME,MAAsBH,EAAW,EAAI,EACrCI,MAAsBJ,EAAW,EAAK,EAG5C,OAFAC,EAAK,iBAAiB,aAAcE,CAAO,EAC3CF,EAAK,iBAAiB,aAAcG,CAAO,MAC9B,CACTH,EAAK,oBAAoB,aAAcE,CAAO,EAC9CF,EAAK,oBAAoB,aAAcG,CAAO,CAClD,CACJ,EAAG,CAACF,CAAG,CAAC,EAEDH,CACX,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-hover.js","names":[],"sources":["../../src/hooks/use-hover.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\n/**\n * Track whether the pointer is hovering over the referenced element.\n * Returns `false` on touch-only devices (no pointer hover).\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * const hovered = useHover(ref);\n * return <div ref={ref}>{hovered ? \"✨\" : \"\"}</div>;\n */\nexport function useHover<T extends HTMLElement>(ref: RefObject<T | null>): boolean {\n    const [hovered, setHovered] = useState<boolean>(false);\n\n    useEffect(() => {\n        const node = ref.current;\n        if (!node) return;\n        const onEnter = (): void => setHovered(true);\n        const onLeave = (): void => setHovered(false);\n        node.addEventListener(\"mouseenter\", onEnter);\n        node.addEventListener(\"mouseleave\", onLeave);\n        return () => {\n            node.removeEventListener(\"mouseenter\", onEnter);\n            node.removeEventListener(\"mouseleave\", onLeave);\n        };\n    }, [ref]);\n\n    return hovered;\n}\n"],"mappings":";;AAYA,SAAgB,EAAgC,GAAmC;CAC/E,IAAM,CAAC,GAAS,KAAc,EAAkB,EAAK;CAerD,OAbA,QAAgB;EACZ,IAAM,IAAO,EAAI;EACjB,IAAI,CAAC,GAAM;EACX,IAAM,UAAsB,EAAW,EAAI,GACrC,UAAsB,EAAW,EAAK;EAG5C,OAFA,EAAK,iBAAiB,cAAc,CAAO,GAC3C,EAAK,iBAAiB,cAAc,CAAO,SAC9B;GAET,AADA,EAAK,oBAAoB,cAAc,CAAO,GAC9C,EAAK,oBAAoB,cAAc,CAAO;EAClD;CACJ,GAAG,CAAC,CAAG,CAAC,GAED;AACX"}
+{"version":3,"file":"use-hover.js","names":["useHover","hovered","setHovered","useState","useEffect","node","ref","onEnter","onLeave"],"sources":["../../src/hooks/use-hover.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\n/**\n * Track whether the pointer is hovering over the referenced element.\n * Returns `false` on touch-only devices (no pointer hover).\n *\n * @example\n * const ref = useRef<HTMLDivElement>(null);\n * const hovered = useHover(ref);\n * return <div ref={ref}>{hovered ? \"✨\" : \"\"}</div>;\n */\nexport function useHover<T extends HTMLElement>(ref: RefObject<T | null>): boolean {\n    const [hovered, setHovered] = useState<boolean>(false);\n\n    useEffect(() => {\n        const node = ref.current;\n        if (!node) return;\n        const onEnter = (): void => setHovered(true);\n        const onLeave = (): void => setHovered(false);\n        node.addEventListener(\"mouseenter\", onEnter);\n        node.addEventListener(\"mouseleave\", onLeave);\n        return () => {\n            node.removeEventListener(\"mouseenter\", onEnter);\n            node.removeEventListener(\"mouseleave\", onLeave);\n        };\n    }, [ref]);\n\n    return hovered;\n}\n"],"mappings":";;AAYA,SAAgBA,EAAgC,GAAmC;CAC/E,IAAM,CAACC,GAASC,KAAcC,EAAkB,EAAK;CAerD,OAbAC,QAAgB;EACZ,IAAMC,IAAOC,EAAI;EACjB,IAAI,CAACD,GAAM;EACX,IAAME,UAAsBL,EAAW,EAAI,GACrCM,UAAsBN,EAAW,EAAK;EAG5C,OAFAG,EAAK,iBAAiB,cAAcE,CAAO,GAC3CF,EAAK,iBAAiB,cAAcG,CAAO,SAC9B;GAET,AADAH,EAAK,oBAAoB,cAAcE,CAAO,GAC9CF,EAAK,oBAAoB,cAAcG,CAAO;EAClD;CACJ,GAAG,CAACF,CAAG,CAAC,GAEDL;AACX"}

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"}