tempest-react-sdk 0.77.0 → 0.79.0

package/dist/hooks/tab-sequence.js.map

@@ -1 +1 @@
-{"version":3,"file":"tab-sequence.js","names":[],"sources":["../../src/hooks/tab-sequence.ts"],"sourcesContent":["/** Elements that can take keyboard focus — shared by the focus trap and the portal tab order. */\nexport const FOCUSABLE_SELECTOR = [\n    \"a[href]\",\n    \"button:not([disabled])\",\n    \"textarea:not([disabled])\",\n    \"input:not([disabled])\",\n    \"select:not([disabled])\",\n    \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\n/** A portalled panel and the element of the page it was opened from. */\nexport interface PortalLayer {\n    /** Wrapper of the trigger — the spot in the page the panel belongs to. */\n    anchor: HTMLElement;\n    /** The panel, mounted at the end of `body`. */\n    panel: HTMLElement;\n}\n\nconst layers = new Set<PortalLayer>();\n\n/**\n * Declare a portalled panel as belonging to the spot of its anchor.\n *\n * A portal takes the panel out of the subtree it was opened from, so a focus\n * trap around that subtree would see the panel as \"outside\" and pull focus away\n * from it. Registered layers are what {@link tabSequence} and\n * {@link tabRegion} splice back in.\n *\n * @param layer - The anchor and the panel.\n * @returns A function that removes the registration.\n */\nexport function registerPortalLayer(layer: PortalLayer): () => void {\n    layers.add(layer);\n    return () => {\n        layers.delete(layer);\n    };\n}\n\n/**\n * The elements `Tab` can stop on inside `root`, in document order.\n *\n * @param root - Where to look.\n * @returns The tabbable descendants that are not disabled, hidden or removed\n * from the tab order.\n */\nexport function tabbables(root: ParentNode): HTMLElement[] {\n    return Array.from(root.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter((el) => {\n        if (el.tabIndex < 0 || el.hasAttribute(\"aria-hidden\")) return false;\n        const style = window.getComputedStyle(el);\n        return style.display !== \"none\" && style.visibility !== \"hidden\";\n    });\n}\n\n/**\n * Split the layers into those opened from inside `root` and the rest.\n *\n * @param root - The subtree the layers are matched against.\n * @param pending - The layers not yet assigned to a subtree.\n * @returns The layers whose anchor lives in `root` (and whose panel does not),\n * and the remaining ones.\n */\nfunction ownedBy(\n    root: HTMLElement,\n    pending: PortalLayer[],\n): { owned: PortalLayer[]; rest: PortalLayer[] } {\n    const owned = pending.filter(\n        (layer) => root.contains(layer.anchor) && !root.contains(layer.panel),\n    );\n    return { owned, rest: pending.filter((layer) => !owned.includes(layer)) };\n}\n\n/**\n * Every subtree focus may sit in while `root` is trapped: `root` itself plus the\n * panels opened from it, transitively (a popover opened from a popover).\n *\n * @param root - The trapped container.\n * @returns `root` followed by the panels that belong to it.\n */\nexport function tabRegion(root: HTMLElement): HTMLElement[] {\n    const region: HTMLElement[] = [root];\n    let pending = [...layers];\n    for (let index = 0; index < region.length; index += 1) {\n        const { owned, rest } = ownedBy(region[index]!, pending);\n        region.push(...owned.map((layer) => layer.panel));\n        pending = rest;\n    }\n    return region;\n}\n\n/**\n * The order `Tab` walks inside `root`, with each owned portalled panel spliced\n * right after the last stop of its anchor — where it would sit had it rendered\n * in flow. That is the same order `usePortalTabOrder` restores between the\n * trigger and the panel, so the trap wraps at the same ends the user walks.\n *\n * @param root - The trapped container.\n * @param pending - Layers not yet placed; defaults to every registered one.\n * @returns The tab stops of `root` and of its panels, in walking order.\n */\nexport function tabSequence(\n    root: HTMLElement,\n    pending: PortalLayer[] = [...layers],\n): HTMLElement[] {\n    const native = tabbables(root);\n    const { owned, rest } = ownedBy(root, pending);\n    const inserted = new Map<number, HTMLElement[]>();\n    for (const layer of owned) {\n        let at = -1;\n        native.forEach((el, index) => {\n            const precedes =\n                (el.compareDocumentPosition(layer.anchor) & Node.DOCUMENT_POSITION_FOLLOWING) !== 0;\n            if (precedes || layer.anchor.contains(el)) at = index;\n        });\n        inserted.set(at, [...(inserted.get(at) ?? []), ...tabSequence(layer.panel, rest)]);\n    }\n    const sequence: HTMLElement[] = [...(inserted.get(-1) ?? [])];\n    native.forEach((el, index) => {\n        sequence.push(el, ...(inserted.get(index) ?? []));\n    });\n    return sequence;\n}\n"],"mappings":";AACA,IAAa,IAAqB;CAC9B;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC,CAAC,KAAK,GAAG,GAUJ,oBAAS,IAAI,IAAiB;AAapC,SAAgB,EAAoB,GAAgC;CAEhE,OADA,EAAO,IAAI,CAAK,SACH;EACT,EAAO,OAAO,CAAK;CACvB;AACJ;AASA,SAAgB,EAAU,GAAiC;CACvD,OAAO,MAAM,KAAK,EAAK,iBAA8B,CAAkB,CAAC,CAAC,CAAC,QAAQ,MAAO;EACrF,IAAI,EAAG,WAAW,KAAK,EAAG,aAAa,aAAa,GAAG,OAAO;EAC9D,IAAM,IAAQ,OAAO,iBAAiB,CAAE;EACxC,OAAO,EAAM,YAAY,UAAU,EAAM,eAAe;CAC5D,CAAC;AACL;AAUA,SAAS,EACL,GACA,GAC6C;CAC7C,IAAM,IAAQ,EAAQ,QACjB,MAAU,EAAK,SAAS,EAAM,MAAM,KAAK,CAAC,EAAK,SAAS,EAAM,KAAK,CACxE;CACA,OAAO;EAAE;EAAO,MAAM,EAAQ,QAAQ,MAAU,CAAC,EAAM,SAAS,CAAK,CAAC;CAAE;AAC5E;AASA,SAAgB,EAAU,GAAkC;CACxD,IAAM,IAAwB,CAAC,CAAI,GAC/B,IAAU,CAAC,GAAG,CAAM;CACxB,KAAK,IAAI,IAAQ,GAAG,IAAQ,EAAO,QAAQ,KAAS,GAAG;EACnD,IAAM,EAAE,UAAO,YAAS,EAAQ,EAAO,IAAS,CAAO;EAEvD,AADA,EAAO,KAAK,GAAG,EAAM,KAAK,MAAU,EAAM,KAAK,CAAC,GAChD,IAAU;CACd;CACA,OAAO;AACX;AAYA,SAAgB,EACZ,GACA,IAAyB,CAAC,GAAG,CAAM,GACtB;CACb,IAAM,IAAS,EAAU,CAAI,GACvB,EAAE,UAAO,YAAS,EAAQ,GAAM,CAAO,GACvC,oBAAW,IAAI,IAA2B;CAChD,KAAK,IAAM,KAAS,GAAO;EACvB,IAAI,IAAK;EAMT,AALA,EAAO,SAAS,GAAI,MAAU;GAG1B,EADK,EAAG,wBAAwB,EAAM,MAAM,IAAI,KAAK,iCAAiC,KACtE,EAAM,OAAO,SAAS,CAAE,OAAG,IAAK;EACpD,CAAC,GACD,EAAS,IAAI,GAAI,CAAC,GAAI,EAAS,IAAI,CAAE,KAAK,CAAC,GAAI,GAAG,EAAY,EAAM,OAAO,CAAI,CAAC,CAAC;CACrF;CACA,IAAM,IAA0B,CAAC,GAAI,EAAS,IAAI,EAAE,KAAK,CAAC,CAAE;CAI5D,OAHA,EAAO,SAAS,GAAI,MAAU;EAC1B,EAAS,KAAK,GAAI,GAAI,EAAS,IAAI,CAAK,KAAK,CAAC,CAAE;CACpD,CAAC,GACM;AACX"}
+{"version":3,"file":"tab-sequence.js","names":["FOCUSABLE_SELECTOR","layers","registerPortalLayer","layer","tabbables","root","el","style","ownedBy","owned","pending","tabRegion","region","index","rest","tabSequence","native","inserted","at","sequence"],"sources":["../../src/hooks/tab-sequence.ts"],"sourcesContent":["/** Elements that can take keyboard focus — shared by the focus trap and the portal tab order. */\nexport const FOCUSABLE_SELECTOR = [\n    \"a[href]\",\n    \"button:not([disabled])\",\n    \"textarea:not([disabled])\",\n    \"input:not([disabled])\",\n    \"select:not([disabled])\",\n    \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\n/** A portalled panel and the element of the page it was opened from. */\nexport interface PortalLayer {\n    /** Wrapper of the trigger — the spot in the page the panel belongs to. */\n    anchor: HTMLElement;\n    /** The panel, mounted at the end of `body`. */\n    panel: HTMLElement;\n}\n\nconst layers = new Set<PortalLayer>();\n\n/**\n * Declare a portalled panel as belonging to the spot of its anchor.\n *\n * A portal takes the panel out of the subtree it was opened from, so a focus\n * trap around that subtree would see the panel as \"outside\" and pull focus away\n * from it. Registered layers are what {@link tabSequence} and\n * {@link tabRegion} splice back in.\n *\n * @param layer - The anchor and the panel.\n * @returns A function that removes the registration.\n */\nexport function registerPortalLayer(layer: PortalLayer): () => void {\n    layers.add(layer);\n    return () => {\n        layers.delete(layer);\n    };\n}\n\n/**\n * The elements `Tab` can stop on inside `root`, in document order.\n *\n * @param root - Where to look.\n * @returns The tabbable descendants that are not disabled, hidden or removed\n * from the tab order.\n */\nexport function tabbables(root: ParentNode): HTMLElement[] {\n    return Array.from(root.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter((el) => {\n        if (el.tabIndex < 0 || el.hasAttribute(\"aria-hidden\")) return false;\n        const style = window.getComputedStyle(el);\n        return style.display !== \"none\" && style.visibility !== \"hidden\";\n    });\n}\n\n/**\n * Split the layers into those opened from inside `root` and the rest.\n *\n * @param root - The subtree the layers are matched against.\n * @param pending - The layers not yet assigned to a subtree.\n * @returns The layers whose anchor lives in `root` (and whose panel does not),\n * and the remaining ones.\n */\nfunction ownedBy(\n    root: HTMLElement,\n    pending: PortalLayer[],\n): { owned: PortalLayer[]; rest: PortalLayer[] } {\n    const owned = pending.filter(\n        (layer) => root.contains(layer.anchor) && !root.contains(layer.panel),\n    );\n    return { owned, rest: pending.filter((layer) => !owned.includes(layer)) };\n}\n\n/**\n * Every subtree focus may sit in while `root` is trapped: `root` itself plus the\n * panels opened from it, transitively (a popover opened from a popover).\n *\n * @param root - The trapped container.\n * @returns `root` followed by the panels that belong to it.\n */\nexport function tabRegion(root: HTMLElement): HTMLElement[] {\n    const region: HTMLElement[] = [root];\n    let pending = [...layers];\n    for (let index = 0; index < region.length; index += 1) {\n        const { owned, rest } = ownedBy(region[index]!, pending);\n        region.push(...owned.map((layer) => layer.panel));\n        pending = rest;\n    }\n    return region;\n}\n\n/**\n * The order `Tab` walks inside `root`, with each owned portalled panel spliced\n * right after the last stop of its anchor — where it would sit had it rendered\n * in flow. That is the same order `usePortalTabOrder` restores between the\n * trigger and the panel, so the trap wraps at the same ends the user walks.\n *\n * @param root - The trapped container.\n * @param pending - Layers not yet placed; defaults to every registered one.\n * @returns The tab stops of `root` and of its panels, in walking order.\n */\nexport function tabSequence(\n    root: HTMLElement,\n    pending: PortalLayer[] = [...layers],\n): HTMLElement[] {\n    const native = tabbables(root);\n    const { owned, rest } = ownedBy(root, pending);\n    const inserted = new Map<number, HTMLElement[]>();\n    for (const layer of owned) {\n        let at = -1;\n        native.forEach((el, index) => {\n            const precedes =\n                (el.compareDocumentPosition(layer.anchor) & Node.DOCUMENT_POSITION_FOLLOWING) !== 0;\n            if (precedes || layer.anchor.contains(el)) at = index;\n        });\n        inserted.set(at, [...(inserted.get(at) ?? []), ...tabSequence(layer.panel, rest)]);\n    }\n    const sequence: HTMLElement[] = [...(inserted.get(-1) ?? [])];\n    native.forEach((el, index) => {\n        sequence.push(el, ...(inserted.get(index) ?? []));\n    });\n    return sequence;\n}\n"],"mappings":";AACA,IAAaA,IAAqB;CAC9B;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC,CAAC,KAAK,GAAG,GAUJC,oBAAS,IAAI,IAAiB;AAapC,SAAgBC,EAAoB,GAAgC;CAEhE,OADAD,EAAO,IAAIE,CAAK,SACH;EACT,EAAO,OAAOA,CAAK;CACvB;AACJ;AASA,SAAgBC,EAAU,GAAiC;CACvD,OAAO,MAAM,KAAKC,EAAK,iBAA8BL,CAAkB,CAAC,CAAC,CAAC,QAAQ,MAAO;EACrF,IAAIM,EAAG,WAAW,KAAKA,EAAG,aAAa,aAAa,GAAG,OAAO;EAC9D,IAAMC,IAAQ,OAAO,iBAAiBD,CAAE;EACxC,OAAOC,EAAM,YAAY,UAAUA,EAAM,eAAe;CAC5D,CAAC;AACL;AAUA,SAASC,EACL,GACA,GAC6C;CAC7C,IAAMC,IAAQC,EAAQ,QACjB,MAAUL,EAAK,SAASF,EAAM,MAAM,KAAK,CAACE,EAAK,SAASF,EAAM,KAAK,CACxE;CACA,OAAO;EAAE;EAAO,MAAMO,EAAQ,QAAQ,MAAU,CAACD,EAAM,SAASN,CAAK,CAAC;CAAE;AAC5E;AASA,SAAgBQ,EAAU,GAAkC;CACxD,IAAMC,IAAwB,CAACP,CAAI,GAC/BK,IAAU,CAAC,GAAGT,CAAM;CACxB,KAAK,IAAIY,IAAQ,GAAGA,IAAQD,EAAO,QAAQ,KAAS,GAAG;EACnD,IAAM,EAAE,UAAO,YAASJ,EAAQI,EAAOC,IAASH,CAAO;EAEvD,AADAE,EAAO,KAAK,GAAGH,EAAM,KAAK,MAAUN,EAAM,KAAK,CAAC,GAChD,IAAUW;CACd;CACA,OAAOF;AACX;AAYA,SAAgBG,EACZ,GACA,IAAyB,CAAC,GAAGd,CAAM,GACtB;CACb,IAAMe,IAASZ,EAAUC,CAAI,GACvB,EAAE,UAAO,YAASG,EAAQH,GAAMK,CAAO,GACvCO,oBAAW,IAAI,IAA2B;CAChD,KAAK,IAAMd,KAASM,GAAO;EACvB,IAAIS,IAAK;EAMT,AALAF,EAAO,SAAS,GAAI,MAAU;GAG1B,EADKV,EAAG,wBAAwBH,EAAM,MAAM,IAAI,KAAK,iCAAiC,KACtEA,EAAM,OAAO,SAASG,CAAE,OAAG,IAAKO;EACpD,CAAC,GACDI,EAAS,IAAIC,GAAI,CAAC,GAAID,EAAS,IAAIC,CAAE,KAAK,CAAC,GAAI,GAAGH,EAAYZ,EAAM,OAAOW,CAAI,CAAC,CAAC;CACrF;CACA,IAAMK,IAA0B,CAAC,GAAIF,EAAS,IAAI,EAAE,KAAK,CAAC,CAAE;CAI5D,OAHAD,EAAO,SAAS,GAAI,MAAU;EAC1B,EAAS,KAAKV,GAAI,GAAIW,EAAS,IAAIJ,CAAK,KAAK,CAAC,CAAE;CACpD,CAAC,GACMM;AACX"}

package/dist/hooks/use-announce.cjs

@@ -1,2 +1,2 @@
-let e=require("react");var t=7e3,n={position:`absolute`,width:`1px`,height:`1px`,margin:`-1px`,padding:`0`,border:`0`,overflow:`hidden`,clip:`rect(0 0 0 0)`,clipPath:`inset(50%)`,whiteSpace:`nowrap`},r=null,i=new Set;function a(e){let t=document.createElement(`div`);return e===`polite`&&t.setAttribute(`role`,`status`),t.setAttribute(`aria-live`,e),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(`data-tempest-announcer`,e),Object.assign(t.style,n),document.body.appendChild(t),t}function o(){return typeof document>`u`?null:r&&r.polite.isConnected&&r.assertive.isConnected?r:(r?.polite.remove(),r?.assertive.remove(),r={polite:a(`polite`),assertive:a(`assertive`)},r)}function s(e,n=`polite`){if(!e)return;let r=o();if(!r)return;let a=n===`assertive`?r.assertive:r.polite;a.replaceChildren();let s=document.createElement(`div`);s.textContent=e,a.appendChild(s);let c=setTimeout(()=>{i.delete(c),s.isConnected&&s.remove()},t);i.add(c)}function c(){for(let e of i)clearTimeout(e);i.clear(),r?.polite.remove(),r?.assertive.remove(),r=null}function l(){return(0,e.useEffect)(()=>{o()},[]),(0,e.useCallback)((e,t=`polite`)=>s(e,t),[])}exports.announce=s,exports.clearAnnouncer=c,exports.useAnnounce=l;
+let e=require("react");var t=7e3,n={position:`absolute`,width:`1px`,height:`1px`,margin:`-1px`,padding:`0`,border:`0`,overflow:`hidden`,clip:`rect(0 0 0 0)`,clipPath:`inset(50%)`,whiteSpace:`nowrap`},r=null,i=new Set;function a(e){let t=document.createElement(`div`);return e===`polite`&&t.setAttribute(`role`,`status`),t.setAttribute(`aria-live`,e),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(`data-tempest-announcer`,e),Object.assign(t.style,n),document.body.appendChild(t),t}function o(){return typeof document>`u`?null:(r&&r.polite.isConnected&&r.assertive.isConnected||(r?.polite.remove(),r?.assertive.remove(),r={polite:a(`polite`),assertive:a(`assertive`)}),r)}function s(e,n=`polite`){if(!e)return;let r=o();if(!r)return;let a=n===`assertive`?r.assertive:r.polite;a.replaceChildren();let s=document.createElement(`div`);s.textContent=e,a.appendChild(s);let c=setTimeout(()=>{i.delete(c),s.isConnected&&s.remove()},t);i.add(c)}function c(){for(let e of i)clearTimeout(e);i.clear(),r?.polite.remove(),r?.assertive.remove(),r=null}function l(){return(0,e.useEffect)(()=>{o()},[]),(0,e.useCallback)((e,t=`polite`)=>s(e,t),[])}exports.announce=s,exports.clearAnnouncer=c,exports.useAnnounce=l;
 //# sourceMappingURL=use-announce.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-announce.cjs","names":[],"sources":["../../src/hooks/use-announce.ts"],"sourcesContent":["import { useCallback, useEffect } from \"react\";\n\n/**\n * How urgently a screen reader should interrupt.\n *\n * `\"polite\"` waits for a pause in what is being read. `\"assertive\"` cuts in\n * immediately, which is right for an error the user must act on and wrong for\n * everything else — an assertive announcement can truncate the sentence the user\n * was in the middle of.\n */\nexport type AnnouncePoliteness = \"polite\" | \"assertive\";\n\n/** How long an announcement stays in the DOM before it is cleaned up. */\nconst CLEAR_AFTER_MS = 7_000;\n\n/**\n * Inline styles that hide an element visually while leaving it readable.\n *\n * Inline and not a CSS module on purpose: these nodes are created imperatively by\n * a hook, and a hook that only works when the app remembered to import\n * `tempest-react-sdk/styles.css` would drop two visible, unstyled paragraphs into\n * the page — a visual bug caused by an accessibility feature.\n */\nconst HIDDEN_STYLE: Partial<CSSStyleDeclaration> = {\n    position: \"absolute\",\n    width: \"1px\",\n    height: \"1px\",\n    margin: \"-1px\",\n    padding: \"0\",\n    border: \"0\",\n    overflow: \"hidden\",\n    clip: \"rect(0 0 0 0)\",\n    clipPath: \"inset(50%)\",\n    whiteSpace: \"nowrap\",\n};\n\ninterface Regions {\n    polite: HTMLElement;\n    assertive: HTMLElement;\n}\n\nlet regions: Regions | null = null;\nconst timers = new Set<ReturnType<typeof setTimeout>>();\n\n/**\n * Build one live region.\n *\n * The polite region carries `role=\"status\"`; the assertive one carries only\n * `aria-live=\"assertive\"`. `role=\"alert\"` is deliberately **not** used: these\n * regions live in the document for the page's whole life, and an empty element\n * claiming to be an alert is both a lie about its content and a trap for every\n * `getByRole(\"alert\")` in a consuming app's test suite, which would suddenly match\n * two nodes. A bare `aria-live` region is announced by every screen reader that\n * supports live regions at all.\n *\n * @param politeness - Which region to build.\n * @returns The region, already appended to `<body>`.\n */\nfunction createRegion(politeness: AnnouncePoliteness): HTMLElement {\n    const node = document.createElement(\"div\");\n    if (politeness === \"polite\") node.setAttribute(\"role\", \"status\");\n    node.setAttribute(\"aria-live\", politeness);\n    node.setAttribute(\"aria-atomic\", \"true\");\n    node.setAttribute(\"data-tempest-announcer\", politeness);\n    Object.assign(node.style, HIDDEN_STYLE);\n    document.body.appendChild(node);\n    return node;\n}\n\n/**\n * Get the two shared live regions, creating them on first use.\n *\n * **Two regions, not one with a switchable `aria-live`.** Politeness is a property\n * of the region, read when the assistive technology first registers it — flipping\n * the attribute later is honoured by some screen readers, ignored by others, and\n * in the worst case drops the announcement entirely. Two regions that never change\n * are the only version that behaves the same everywhere.\n *\n * **Shared, not one per component.** Every live region on the page is polled;\n * several of them mutating at once is how announcements get dropped or doubled.\n * One pair per document keeps the order deterministic.\n *\n * A pair is replaced as a **pair**, discarding the old one: if only one region was\n * torn out of the DOM (a router that replaced `<body>`, a micro-frontend unmount),\n * keeping its still-attached sibling would leave two regions of that politeness on\n * the page — the exact duplication the shared pair exists to prevent.\n *\n * @returns The polite and assertive regions, or `null` outside a document.\n */\nfunction ensureRegions(): Regions | null {\n    if (typeof document === \"undefined\") return null;\n    if (regions && regions.polite.isConnected && regions.assertive.isConnected) return regions;\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = { polite: createRegion(\"polite\"), assertive: createRegion(\"assertive\") };\n    return regions;\n}\n\n/**\n * Announce a message to screen readers, from anywhere — a hook, an event handler,\n * a plain function outside React.\n *\n * ## Why the same string announces twice\n *\n * Screen readers announce a live region when its **content changes**. Writing the\n * same text again is not a change, so \"Item removido\" twice in a row is read once —\n * the classic reason these announcers are quietly broken. Instead of mutating text,\n * every call replaces the region's child with a **new element**. The DOM mutation is\n * real even when the string is identical, so the second announcement happens, and\n * the reader hears the exact message with no padding characters bolted on.\n *\n * @param message - Text to read out. Empty strings are ignored.\n * @param politeness - `\"polite\"` (default) or `\"assertive\"`.\n *\n * @example\n * announce(`${count} pedidos encontrados`);\n * announce(\"Falha ao salvar\", \"assertive\");\n */\nexport function announce(message: string, politeness: AnnouncePoliteness = \"polite\"): void {\n    if (!message) return;\n    const pair = ensureRegions();\n    if (!pair) return;\n\n    const region = politeness === \"assertive\" ? pair.assertive : pair.polite;\n    region.replaceChildren();\n    const item = document.createElement(\"div\");\n    item.textContent = message;\n    region.appendChild(item);\n\n    const timer = setTimeout(() => {\n        timers.delete(timer);\n        if (item.isConnected) item.remove();\n    }, CLEAR_AFTER_MS);\n    timers.add(timer);\n}\n\n/**\n * Remove the shared regions and cancel pending cleanups.\n *\n * For test teardown and for a micro-frontend being unmounted from a page it does\n * not own. Regular apps never need it — two empty hidden `div`s cost nothing, and\n * tearing them down while another component still announces would lose messages.\n */\nexport function clearAnnouncer(): void {\n    for (const timer of timers) clearTimeout(timer);\n    timers.clear();\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = null;\n}\n\n/**\n * Announce transient messages to screen readers through one shared live region\n * pair.\n *\n * Reach for this when something happened that a sighted user can see and a screen\n * reader user cannot: a filter narrowed a list, a row saved, a copy succeeded, an\n * upload failed. It is **not** for content that is already on screen inside a\n * region with a role — a status pill, a toast that renders as `role=\"status\"`,\n * a form error tied to its input — announcing those again reads them twice.\n *\n * !!! warning \"Never wrap streaming text in a live region\"\n *     A live region over text that grows token by token makes the reader start the\n *     whole answer again on every token. Announce the **edges** instead — \"gerando\n *     resposta\" and \"resposta concluída\" — and leave the transcript in a plain\n *     `role=\"log\"` the user reads at their own pace. `AIChat` does exactly that.\n *\n * Mounting the hook creates the regions even before the first message. That is not\n * tidiness: a live region inserted into the DOM in the same frame as its first\n * content routinely loses that announcement, because the assistive technology has\n * to have registered the region before it can notice a change inside it.\n *\n * @returns A stable `announce(message, politeness?)` function.\n *\n * @example\n * const announce = useAnnounce();\n *\n * function onFilter(rows: Row[]) {\n *     announce(`${rows.length} resultados`);\n * }\n */\nexport function useAnnounce(): (message: string, politeness?: AnnouncePoliteness) => void {\n    useEffect(() => {\n        ensureRegions();\n    }, []);\n\n    return useCallback(\n        (message: string, politeness: AnnouncePoliteness = \"polite\") =>\n            announce(message, politeness),\n        [],\n    );\n}\n"],"mappings":"uBAaA,IAAM,EAAiB,IAUjB,EAA6C,CAC/C,SAAU,WACV,MAAO,MACP,OAAQ,MACR,OAAQ,OACR,QAAS,IACT,OAAQ,IACR,SAAU,SACV,KAAM,gBACN,SAAU,aACV,WAAY,QAChB,EAOI,EAA0B,KACxB,EAAS,IAAI,IAgBnB,SAAS,EAAa,EAA6C,CAC/D,IAAM,EAAO,SAAS,cAAc,KAAK,EAOzC,OANI,IAAe,UAAU,EAAK,aAAa,OAAQ,QAAQ,EAC/D,EAAK,aAAa,YAAa,CAAU,EACzC,EAAK,aAAa,cAAe,MAAM,EACvC,EAAK,aAAa,yBAA0B,CAAU,EACtD,OAAO,OAAO,EAAK,MAAO,CAAY,EACtC,SAAS,KAAK,YAAY,CAAI,EACvB,CACX,CAsBA,SAAS,GAAgC,CAMrC,OALI,OAAO,SAAa,IAAoB,KACxC,GAAW,EAAQ,OAAO,aAAe,EAAQ,UAAU,YAAoB,GACnF,GAAS,OAAO,OAAO,EACvB,GAAS,UAAU,OAAO,EAC1B,EAAU,CAAE,OAAQ,EAAa,QAAQ,EAAG,UAAW,EAAa,WAAW,CAAE,EAC1E,EACX,CAsBA,SAAgB,EAAS,EAAiB,EAAiC,SAAgB,CACvF,GAAI,CAAC,EAAS,OACd,IAAM,EAAO,EAAc,EAC3B,GAAI,CAAC,EAAM,OAEX,IAAM,EAAS,IAAe,YAAc,EAAK,UAAY,EAAK,OAClE,EAAO,gBAAgB,EACvB,IAAM,EAAO,SAAS,cAAc,KAAK,EACzC,EAAK,YAAc,EACnB,EAAO,YAAY,CAAI,EAEvB,IAAM,EAAQ,eAAiB,CAC3B,EAAO,OAAO,CAAK,EACf,EAAK,aAAa,EAAK,OAAO,CACtC,EAAG,CAAc,EACjB,EAAO,IAAI,CAAK,CACpB,CASA,SAAgB,GAAuB,CACnC,IAAK,IAAM,KAAS,EAAQ,aAAa,CAAK,EAC9C,EAAO,MAAM,EACb,GAAS,OAAO,OAAO,EACvB,GAAS,UAAU,OAAO,EAC1B,EAAU,IACd,CAgCA,SAAgB,GAA0E,CAKtF,OAJA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAc,CAClB,EAAG,CAAC,CAAC,GAEL,EAAO,EAAA,YAAA,EACF,EAAiB,EAAiC,WAC/C,EAAS,EAAS,CAAU,EAChC,CAAC,CACL,CACJ"}
+{"version":3,"file":"use-announce.cjs","names":["useCallback","react","CLEAR_AFTER_MS","HIDDEN_STYLE","regions","timers","createRegion","node","politeness","ensureRegions","announce","message","pair","region","item","timer","clearAnnouncer","useAnnounce"],"sources":["../../src/hooks/use-announce.ts"],"sourcesContent":["import { useCallback, useEffect } from \"react\";\n\n/**\n * How urgently a screen reader should interrupt.\n *\n * `\"polite\"` waits for a pause in what is being read. `\"assertive\"` cuts in\n * immediately, which is right for an error the user must act on and wrong for\n * everything else — an assertive announcement can truncate the sentence the user\n * was in the middle of.\n */\nexport type AnnouncePoliteness = \"polite\" | \"assertive\";\n\n/** How long an announcement stays in the DOM before it is cleaned up. */\nconst CLEAR_AFTER_MS = 7_000;\n\n/**\n * Inline styles that hide an element visually while leaving it readable.\n *\n * Inline and not a CSS module on purpose: these nodes are created imperatively by\n * a hook, and a hook that only works when the app remembered to import\n * `tempest-react-sdk/styles.css` would drop two visible, unstyled paragraphs into\n * the page — a visual bug caused by an accessibility feature.\n */\nconst HIDDEN_STYLE: Partial<CSSStyleDeclaration> = {\n    position: \"absolute\",\n    width: \"1px\",\n    height: \"1px\",\n    margin: \"-1px\",\n    padding: \"0\",\n    border: \"0\",\n    overflow: \"hidden\",\n    clip: \"rect(0 0 0 0)\",\n    clipPath: \"inset(50%)\",\n    whiteSpace: \"nowrap\",\n};\n\ninterface Regions {\n    polite: HTMLElement;\n    assertive: HTMLElement;\n}\n\nlet regions: Regions | null = null;\nconst timers = new Set<ReturnType<typeof setTimeout>>();\n\n/**\n * Build one live region.\n *\n * The polite region carries `role=\"status\"`; the assertive one carries only\n * `aria-live=\"assertive\"`. `role=\"alert\"` is deliberately **not** used: these\n * regions live in the document for the page's whole life, and an empty element\n * claiming to be an alert is both a lie about its content and a trap for every\n * `getByRole(\"alert\")` in a consuming app's test suite, which would suddenly match\n * two nodes. A bare `aria-live` region is announced by every screen reader that\n * supports live regions at all.\n *\n * @param politeness - Which region to build.\n * @returns The region, already appended to `<body>`.\n */\nfunction createRegion(politeness: AnnouncePoliteness): HTMLElement {\n    const node = document.createElement(\"div\");\n    if (politeness === \"polite\") node.setAttribute(\"role\", \"status\");\n    node.setAttribute(\"aria-live\", politeness);\n    node.setAttribute(\"aria-atomic\", \"true\");\n    node.setAttribute(\"data-tempest-announcer\", politeness);\n    Object.assign(node.style, HIDDEN_STYLE);\n    document.body.appendChild(node);\n    return node;\n}\n\n/**\n * Get the two shared live regions, creating them on first use.\n *\n * **Two regions, not one with a switchable `aria-live`.** Politeness is a property\n * of the region, read when the assistive technology first registers it — flipping\n * the attribute later is honoured by some screen readers, ignored by others, and\n * in the worst case drops the announcement entirely. Two regions that never change\n * are the only version that behaves the same everywhere.\n *\n * **Shared, not one per component.** Every live region on the page is polled;\n * several of them mutating at once is how announcements get dropped or doubled.\n * One pair per document keeps the order deterministic.\n *\n * A pair is replaced as a **pair**, discarding the old one: if only one region was\n * torn out of the DOM (a router that replaced `<body>`, a micro-frontend unmount),\n * keeping its still-attached sibling would leave two regions of that politeness on\n * the page — the exact duplication the shared pair exists to prevent.\n *\n * @returns The polite and assertive regions, or `null` outside a document.\n */\nfunction ensureRegions(): Regions | null {\n    if (typeof document === \"undefined\") return null;\n    if (regions && regions.polite.isConnected && regions.assertive.isConnected) return regions;\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = { polite: createRegion(\"polite\"), assertive: createRegion(\"assertive\") };\n    return regions;\n}\n\n/**\n * Announce a message to screen readers, from anywhere — a hook, an event handler,\n * a plain function outside React.\n *\n * ## Why the same string announces twice\n *\n * Screen readers announce a live region when its **content changes**. Writing the\n * same text again is not a change, so \"Item removido\" twice in a row is read once —\n * the classic reason these announcers are quietly broken. Instead of mutating text,\n * every call replaces the region's child with a **new element**. The DOM mutation is\n * real even when the string is identical, so the second announcement happens, and\n * the reader hears the exact message with no padding characters bolted on.\n *\n * @param message - Text to read out. Empty strings are ignored.\n * @param politeness - `\"polite\"` (default) or `\"assertive\"`.\n *\n * @example\n * announce(`${count} pedidos encontrados`);\n * announce(\"Falha ao salvar\", \"assertive\");\n */\nexport function announce(message: string, politeness: AnnouncePoliteness = \"polite\"): void {\n    if (!message) return;\n    const pair = ensureRegions();\n    if (!pair) return;\n\n    const region = politeness === \"assertive\" ? pair.assertive : pair.polite;\n    region.replaceChildren();\n    const item = document.createElement(\"div\");\n    item.textContent = message;\n    region.appendChild(item);\n\n    const timer = setTimeout(() => {\n        timers.delete(timer);\n        if (item.isConnected) item.remove();\n    }, CLEAR_AFTER_MS);\n    timers.add(timer);\n}\n\n/**\n * Remove the shared regions and cancel pending cleanups.\n *\n * For test teardown and for a micro-frontend being unmounted from a page it does\n * not own. Regular apps never need it — two empty hidden `div`s cost nothing, and\n * tearing them down while another component still announces would lose messages.\n */\nexport function clearAnnouncer(): void {\n    for (const timer of timers) clearTimeout(timer);\n    timers.clear();\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = null;\n}\n\n/**\n * Announce transient messages to screen readers through one shared live region\n * pair.\n *\n * Reach for this when something happened that a sighted user can see and a screen\n * reader user cannot: a filter narrowed a list, a row saved, a copy succeeded, an\n * upload failed. It is **not** for content that is already on screen inside a\n * region with a role — a status pill, a toast that renders as `role=\"status\"`,\n * a form error tied to its input — announcing those again reads them twice.\n *\n * !!! warning \"Never wrap streaming text in a live region\"\n *     A live region over text that grows token by token makes the reader start the\n *     whole answer again on every token. Announce the **edges** instead — \"gerando\n *     resposta\" and \"resposta concluída\" — and leave the transcript in a plain\n *     `role=\"log\"` the user reads at their own pace. `AIChat` does exactly that.\n *\n * Mounting the hook creates the regions even before the first message. That is not\n * tidiness: a live region inserted into the DOM in the same frame as its first\n * content routinely loses that announcement, because the assistive technology has\n * to have registered the region before it can notice a change inside it.\n *\n * @returns A stable `announce(message, politeness?)` function.\n *\n * @example\n * const announce = useAnnounce();\n *\n * function onFilter(rows: Row[]) {\n *     announce(`${rows.length} resultados`);\n * }\n */\nexport function useAnnounce(): (message: string, politeness?: AnnouncePoliteness) => void {\n    useEffect(() => {\n        ensureRegions();\n    }, []);\n\n    return useCallback(\n        (message: string, politeness: AnnouncePoliteness = \"polite\") =>\n            announce(message, politeness),\n        [],\n    );\n}\n"],"mappings":"A,uBAaA,IAAME,EAAiB,IAUjBC,EAA6C,CAC/C,SAAU,WACV,MAAO,MACP,OAAQ,MACR,OAAQ,OACR,QAAS,IACT,OAAQ,IACR,SAAU,SACV,KAAM,gBACN,SAAU,aACV,WAAY,QAChB,EAOIC,EAA0B,KACxBC,EAAS,IAAI,IAgBnB,SAASC,EAAa,EAA6C,CAC/D,IAAMC,EAAO,SAAS,cAAc,KAAK,EAOzC,OANIC,IAAe,UAAUD,EAAK,aAAa,OAAQ,QAAQ,EAC/DA,EAAK,aAAa,YAAaC,CAAU,EACzCD,EAAK,aAAa,cAAe,MAAM,EACvCA,EAAK,aAAa,yBAA0BC,CAAU,EACtD,OAAO,OAAOD,EAAK,MAAOJ,CAAY,EACtC,SAAS,KAAK,YAAYI,CAAI,EACvBA,CACX,CAsBA,SAASE,GAAgC,CAMrC,OALI,OAAO,SAAa,IAAoB,MACxCL,GAAWA,EAAQ,OAAO,aAAeA,EAAQ,UAAU,cAC/DA,GAAS,OAAO,OAAO,EACvBA,GAAS,UAAU,OAAO,EAC1B,EAAU,CAAE,OAAQE,EAAa,QAAQ,EAAG,UAAWA,EAAa,WAAW,CAAE,GAC1EF,EACX,CAsBA,SAAgBM,EAAS,EAAiB,EAAiC,SAAgB,CACvF,GAAI,CAACC,EAAS,OACd,IAAMC,EAAOH,EAAc,EAC3B,GAAI,CAACG,EAAM,OAEX,IAAMC,EAASL,IAAe,YAAcI,EAAK,UAAYA,EAAK,OAClEC,EAAO,gBAAgB,EACvB,IAAMC,EAAO,SAAS,cAAc,KAAK,EACzC,EAAK,YAAcH,EACnBE,EAAO,YAAYC,CAAI,EAEvB,IAAMC,EAAQ,eAAiB,CAC3BV,EAAO,OAAOU,CAAK,EACfD,EAAK,aAAaA,EAAK,OAAO,CACtC,EAAGZ,CAAc,EACjBG,EAAO,IAAIU,CAAK,CACpB,CASA,SAAgBC,GAAuB,CACnC,IAAK,IAAMD,KAASV,EAAQ,aAAaU,CAAK,EAC9CV,EAAO,MAAM,EACbD,GAAS,OAAO,OAAO,EACvBA,GAAS,UAAU,OAAO,EAC1B,EAAU,IACd,CAgCA,SAAgBa,GAA0E,CAKtF,OAJA,EAAAhB,EAAA,UAAA,KAAgB,CACZQ,EAAc,CAClB,EAAG,CAAC,CAAC,GAEL,EAAOT,EAAAA,YAAAA,EACF,EAAiB,EAAiC,WAC/CU,EAASC,EAASH,CAAU,EAChC,CAAC,CACL,CACJ,C"}

package/dist/hooks/use-announce.js

@@ -17,10 +17,10 @@ function o(e) {
 	return e === "polite" && t.setAttribute("role", "status"), t.setAttribute("aria-live", e), t.setAttribute("aria-atomic", "true"), t.setAttribute("data-tempest-announcer", e), Object.assign(t.style, r), document.body.appendChild(t), t;
 }
 function s() {
-	return typeof document > "u" ? null : i && i.polite.isConnected && i.assertive.isConnected ? i : (i?.polite.remove(), i?.assertive.remove(), i = {
+	return typeof document > "u" ? null : (i && i.polite.isConnected && i.assertive.isConnected || (i?.polite.remove(), i?.assertive.remove(), i = {
 		polite: o("polite"),
 		assertive: o("assertive")
-	}, i);
+	}), i);
 }
 function c(e, t = "polite") {
 	if (!e) return;

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

@@ -1 +1 @@
-{"version":3,"file":"use-announce.js","names":[],"sources":["../../src/hooks/use-announce.ts"],"sourcesContent":["import { useCallback, useEffect } from \"react\";\n\n/**\n * How urgently a screen reader should interrupt.\n *\n * `\"polite\"` waits for a pause in what is being read. `\"assertive\"` cuts in\n * immediately, which is right for an error the user must act on and wrong for\n * everything else — an assertive announcement can truncate the sentence the user\n * was in the middle of.\n */\nexport type AnnouncePoliteness = \"polite\" | \"assertive\";\n\n/** How long an announcement stays in the DOM before it is cleaned up. */\nconst CLEAR_AFTER_MS = 7_000;\n\n/**\n * Inline styles that hide an element visually while leaving it readable.\n *\n * Inline and not a CSS module on purpose: these nodes are created imperatively by\n * a hook, and a hook that only works when the app remembered to import\n * `tempest-react-sdk/styles.css` would drop two visible, unstyled paragraphs into\n * the page — a visual bug caused by an accessibility feature.\n */\nconst HIDDEN_STYLE: Partial<CSSStyleDeclaration> = {\n    position: \"absolute\",\n    width: \"1px\",\n    height: \"1px\",\n    margin: \"-1px\",\n    padding: \"0\",\n    border: \"0\",\n    overflow: \"hidden\",\n    clip: \"rect(0 0 0 0)\",\n    clipPath: \"inset(50%)\",\n    whiteSpace: \"nowrap\",\n};\n\ninterface Regions {\n    polite: HTMLElement;\n    assertive: HTMLElement;\n}\n\nlet regions: Regions | null = null;\nconst timers = new Set<ReturnType<typeof setTimeout>>();\n\n/**\n * Build one live region.\n *\n * The polite region carries `role=\"status\"`; the assertive one carries only\n * `aria-live=\"assertive\"`. `role=\"alert\"` is deliberately **not** used: these\n * regions live in the document for the page's whole life, and an empty element\n * claiming to be an alert is both a lie about its content and a trap for every\n * `getByRole(\"alert\")` in a consuming app's test suite, which would suddenly match\n * two nodes. A bare `aria-live` region is announced by every screen reader that\n * supports live regions at all.\n *\n * @param politeness - Which region to build.\n * @returns The region, already appended to `<body>`.\n */\nfunction createRegion(politeness: AnnouncePoliteness): HTMLElement {\n    const node = document.createElement(\"div\");\n    if (politeness === \"polite\") node.setAttribute(\"role\", \"status\");\n    node.setAttribute(\"aria-live\", politeness);\n    node.setAttribute(\"aria-atomic\", \"true\");\n    node.setAttribute(\"data-tempest-announcer\", politeness);\n    Object.assign(node.style, HIDDEN_STYLE);\n    document.body.appendChild(node);\n    return node;\n}\n\n/**\n * Get the two shared live regions, creating them on first use.\n *\n * **Two regions, not one with a switchable `aria-live`.** Politeness is a property\n * of the region, read when the assistive technology first registers it — flipping\n * the attribute later is honoured by some screen readers, ignored by others, and\n * in the worst case drops the announcement entirely. Two regions that never change\n * are the only version that behaves the same everywhere.\n *\n * **Shared, not one per component.** Every live region on the page is polled;\n * several of them mutating at once is how announcements get dropped or doubled.\n * One pair per document keeps the order deterministic.\n *\n * A pair is replaced as a **pair**, discarding the old one: if only one region was\n * torn out of the DOM (a router that replaced `<body>`, a micro-frontend unmount),\n * keeping its still-attached sibling would leave two regions of that politeness on\n * the page — the exact duplication the shared pair exists to prevent.\n *\n * @returns The polite and assertive regions, or `null` outside a document.\n */\nfunction ensureRegions(): Regions | null {\n    if (typeof document === \"undefined\") return null;\n    if (regions && regions.polite.isConnected && regions.assertive.isConnected) return regions;\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = { polite: createRegion(\"polite\"), assertive: createRegion(\"assertive\") };\n    return regions;\n}\n\n/**\n * Announce a message to screen readers, from anywhere — a hook, an event handler,\n * a plain function outside React.\n *\n * ## Why the same string announces twice\n *\n * Screen readers announce a live region when its **content changes**. Writing the\n * same text again is not a change, so \"Item removido\" twice in a row is read once —\n * the classic reason these announcers are quietly broken. Instead of mutating text,\n * every call replaces the region's child with a **new element**. The DOM mutation is\n * real even when the string is identical, so the second announcement happens, and\n * the reader hears the exact message with no padding characters bolted on.\n *\n * @param message - Text to read out. Empty strings are ignored.\n * @param politeness - `\"polite\"` (default) or `\"assertive\"`.\n *\n * @example\n * announce(`${count} pedidos encontrados`);\n * announce(\"Falha ao salvar\", \"assertive\");\n */\nexport function announce(message: string, politeness: AnnouncePoliteness = \"polite\"): void {\n    if (!message) return;\n    const pair = ensureRegions();\n    if (!pair) return;\n\n    const region = politeness === \"assertive\" ? pair.assertive : pair.polite;\n    region.replaceChildren();\n    const item = document.createElement(\"div\");\n    item.textContent = message;\n    region.appendChild(item);\n\n    const timer = setTimeout(() => {\n        timers.delete(timer);\n        if (item.isConnected) item.remove();\n    }, CLEAR_AFTER_MS);\n    timers.add(timer);\n}\n\n/**\n * Remove the shared regions and cancel pending cleanups.\n *\n * For test teardown and for a micro-frontend being unmounted from a page it does\n * not own. Regular apps never need it — two empty hidden `div`s cost nothing, and\n * tearing them down while another component still announces would lose messages.\n */\nexport function clearAnnouncer(): void {\n    for (const timer of timers) clearTimeout(timer);\n    timers.clear();\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = null;\n}\n\n/**\n * Announce transient messages to screen readers through one shared live region\n * pair.\n *\n * Reach for this when something happened that a sighted user can see and a screen\n * reader user cannot: a filter narrowed a list, a row saved, a copy succeeded, an\n * upload failed. It is **not** for content that is already on screen inside a\n * region with a role — a status pill, a toast that renders as `role=\"status\"`,\n * a form error tied to its input — announcing those again reads them twice.\n *\n * !!! warning \"Never wrap streaming text in a live region\"\n *     A live region over text that grows token by token makes the reader start the\n *     whole answer again on every token. Announce the **edges** instead — \"gerando\n *     resposta\" and \"resposta concluída\" — and leave the transcript in a plain\n *     `role=\"log\"` the user reads at their own pace. `AIChat` does exactly that.\n *\n * Mounting the hook creates the regions even before the first message. That is not\n * tidiness: a live region inserted into the DOM in the same frame as its first\n * content routinely loses that announcement, because the assistive technology has\n * to have registered the region before it can notice a change inside it.\n *\n * @returns A stable `announce(message, politeness?)` function.\n *\n * @example\n * const announce = useAnnounce();\n *\n * function onFilter(rows: Row[]) {\n *     announce(`${rows.length} resultados`);\n * }\n */\nexport function useAnnounce(): (message: string, politeness?: AnnouncePoliteness) => void {\n    useEffect(() => {\n        ensureRegions();\n    }, []);\n\n    return useCallback(\n        (message: string, politeness: AnnouncePoliteness = \"polite\") =>\n            announce(message, politeness),\n        [],\n    );\n}\n"],"mappings":";;AAaA,IAAM,IAAiB,KAUjB,IAA6C;CAC/C,UAAU;CACV,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,UAAU;CACV,MAAM;CACN,UAAU;CACV,YAAY;AAChB,GAOI,IAA0B,MACxB,oBAAS,IAAI,IAAmC;AAgBtD,SAAS,EAAa,GAA6C;CAC/D,IAAM,IAAO,SAAS,cAAc,KAAK;CAOzC,OANI,MAAe,YAAU,EAAK,aAAa,QAAQ,QAAQ,GAC/D,EAAK,aAAa,aAAa,CAAU,GACzC,EAAK,aAAa,eAAe,MAAM,GACvC,EAAK,aAAa,0BAA0B,CAAU,GACtD,OAAO,OAAO,EAAK,OAAO,CAAY,GACtC,SAAS,KAAK,YAAY,CAAI,GACvB;AACX;AAsBA,SAAS,IAAgC;CAMrC,OALI,OAAO,WAAa,MAAoB,OACxC,KAAW,EAAQ,OAAO,eAAe,EAAQ,UAAU,cAAoB,KACnF,GAAS,OAAO,OAAO,GACvB,GAAS,UAAU,OAAO,GAC1B,IAAU;EAAE,QAAQ,EAAa,QAAQ;EAAG,WAAW,EAAa,WAAW;CAAE,GAC1E;AACX;AAsBA,SAAgB,EAAS,GAAiB,IAAiC,UAAgB;CACvF,IAAI,CAAC,GAAS;CACd,IAAM,IAAO,EAAc;CAC3B,IAAI,CAAC,GAAM;CAEX,IAAM,IAAS,MAAe,cAAc,EAAK,YAAY,EAAK;CAClE,EAAO,gBAAgB;CACvB,IAAM,IAAO,SAAS,cAAc,KAAK;CAEzC,AADA,EAAK,cAAc,GACnB,EAAO,YAAY,CAAI;CAEvB,IAAM,IAAQ,iBAAiB;EAE3B,AADA,EAAO,OAAO,CAAK,GACf,EAAK,eAAa,EAAK,OAAO;CACtC,GAAG,CAAc;CACjB,EAAO,IAAI,CAAK;AACpB;AASA,SAAgB,IAAuB;CACnC,KAAK,IAAM,KAAS,GAAQ,aAAa,CAAK;CAI9C,AAHA,EAAO,MAAM,GACb,GAAS,OAAO,OAAO,GACvB,GAAS,UAAU,OAAO,GAC1B,IAAU;AACd;AAgCA,SAAgB,IAA0E;CAKtF,OAJA,QAAgB;EACZ,EAAc;CAClB,GAAG,CAAC,CAAC,GAEE,GACF,GAAiB,IAAiC,aAC/C,EAAS,GAAS,CAAU,GAChC,CAAC,CACL;AACJ"}
+{"version":3,"file":"use-announce.js","names":["CLEAR_AFTER_MS","HIDDEN_STYLE","regions","timers","createRegion","node","politeness","ensureRegions","announce","message","pair","region","item","timer","clearAnnouncer","useAnnounce","useEffect","useCallback"],"sources":["../../src/hooks/use-announce.ts"],"sourcesContent":["import { useCallback, useEffect } from \"react\";\n\n/**\n * How urgently a screen reader should interrupt.\n *\n * `\"polite\"` waits for a pause in what is being read. `\"assertive\"` cuts in\n * immediately, which is right for an error the user must act on and wrong for\n * everything else — an assertive announcement can truncate the sentence the user\n * was in the middle of.\n */\nexport type AnnouncePoliteness = \"polite\" | \"assertive\";\n\n/** How long an announcement stays in the DOM before it is cleaned up. */\nconst CLEAR_AFTER_MS = 7_000;\n\n/**\n * Inline styles that hide an element visually while leaving it readable.\n *\n * Inline and not a CSS module on purpose: these nodes are created imperatively by\n * a hook, and a hook that only works when the app remembered to import\n * `tempest-react-sdk/styles.css` would drop two visible, unstyled paragraphs into\n * the page — a visual bug caused by an accessibility feature.\n */\nconst HIDDEN_STYLE: Partial<CSSStyleDeclaration> = {\n    position: \"absolute\",\n    width: \"1px\",\n    height: \"1px\",\n    margin: \"-1px\",\n    padding: \"0\",\n    border: \"0\",\n    overflow: \"hidden\",\n    clip: \"rect(0 0 0 0)\",\n    clipPath: \"inset(50%)\",\n    whiteSpace: \"nowrap\",\n};\n\ninterface Regions {\n    polite: HTMLElement;\n    assertive: HTMLElement;\n}\n\nlet regions: Regions | null = null;\nconst timers = new Set<ReturnType<typeof setTimeout>>();\n\n/**\n * Build one live region.\n *\n * The polite region carries `role=\"status\"`; the assertive one carries only\n * `aria-live=\"assertive\"`. `role=\"alert\"` is deliberately **not** used: these\n * regions live in the document for the page's whole life, and an empty element\n * claiming to be an alert is both a lie about its content and a trap for every\n * `getByRole(\"alert\")` in a consuming app's test suite, which would suddenly match\n * two nodes. A bare `aria-live` region is announced by every screen reader that\n * supports live regions at all.\n *\n * @param politeness - Which region to build.\n * @returns The region, already appended to `<body>`.\n */\nfunction createRegion(politeness: AnnouncePoliteness): HTMLElement {\n    const node = document.createElement(\"div\");\n    if (politeness === \"polite\") node.setAttribute(\"role\", \"status\");\n    node.setAttribute(\"aria-live\", politeness);\n    node.setAttribute(\"aria-atomic\", \"true\");\n    node.setAttribute(\"data-tempest-announcer\", politeness);\n    Object.assign(node.style, HIDDEN_STYLE);\n    document.body.appendChild(node);\n    return node;\n}\n\n/**\n * Get the two shared live regions, creating them on first use.\n *\n * **Two regions, not one with a switchable `aria-live`.** Politeness is a property\n * of the region, read when the assistive technology first registers it — flipping\n * the attribute later is honoured by some screen readers, ignored by others, and\n * in the worst case drops the announcement entirely. Two regions that never change\n * are the only version that behaves the same everywhere.\n *\n * **Shared, not one per component.** Every live region on the page is polled;\n * several of them mutating at once is how announcements get dropped or doubled.\n * One pair per document keeps the order deterministic.\n *\n * A pair is replaced as a **pair**, discarding the old one: if only one region was\n * torn out of the DOM (a router that replaced `<body>`, a micro-frontend unmount),\n * keeping its still-attached sibling would leave two regions of that politeness on\n * the page — the exact duplication the shared pair exists to prevent.\n *\n * @returns The polite and assertive regions, or `null` outside a document.\n */\nfunction ensureRegions(): Regions | null {\n    if (typeof document === \"undefined\") return null;\n    if (regions && regions.polite.isConnected && regions.assertive.isConnected) return regions;\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = { polite: createRegion(\"polite\"), assertive: createRegion(\"assertive\") };\n    return regions;\n}\n\n/**\n * Announce a message to screen readers, from anywhere — a hook, an event handler,\n * a plain function outside React.\n *\n * ## Why the same string announces twice\n *\n * Screen readers announce a live region when its **content changes**. Writing the\n * same text again is not a change, so \"Item removido\" twice in a row is read once —\n * the classic reason these announcers are quietly broken. Instead of mutating text,\n * every call replaces the region's child with a **new element**. The DOM mutation is\n * real even when the string is identical, so the second announcement happens, and\n * the reader hears the exact message with no padding characters bolted on.\n *\n * @param message - Text to read out. Empty strings are ignored.\n * @param politeness - `\"polite\"` (default) or `\"assertive\"`.\n *\n * @example\n * announce(`${count} pedidos encontrados`);\n * announce(\"Falha ao salvar\", \"assertive\");\n */\nexport function announce(message: string, politeness: AnnouncePoliteness = \"polite\"): void {\n    if (!message) return;\n    const pair = ensureRegions();\n    if (!pair) return;\n\n    const region = politeness === \"assertive\" ? pair.assertive : pair.polite;\n    region.replaceChildren();\n    const item = document.createElement(\"div\");\n    item.textContent = message;\n    region.appendChild(item);\n\n    const timer = setTimeout(() => {\n        timers.delete(timer);\n        if (item.isConnected) item.remove();\n    }, CLEAR_AFTER_MS);\n    timers.add(timer);\n}\n\n/**\n * Remove the shared regions and cancel pending cleanups.\n *\n * For test teardown and for a micro-frontend being unmounted from a page it does\n * not own. Regular apps never need it — two empty hidden `div`s cost nothing, and\n * tearing them down while another component still announces would lose messages.\n */\nexport function clearAnnouncer(): void {\n    for (const timer of timers) clearTimeout(timer);\n    timers.clear();\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = null;\n}\n\n/**\n * Announce transient messages to screen readers through one shared live region\n * pair.\n *\n * Reach for this when something happened that a sighted user can see and a screen\n * reader user cannot: a filter narrowed a list, a row saved, a copy succeeded, an\n * upload failed. It is **not** for content that is already on screen inside a\n * region with a role — a status pill, a toast that renders as `role=\"status\"`,\n * a form error tied to its input — announcing those again reads them twice.\n *\n * !!! warning \"Never wrap streaming text in a live region\"\n *     A live region over text that grows token by token makes the reader start the\n *     whole answer again on every token. Announce the **edges** instead — \"gerando\n *     resposta\" and \"resposta concluída\" — and leave the transcript in a plain\n *     `role=\"log\"` the user reads at their own pace. `AIChat` does exactly that.\n *\n * Mounting the hook creates the regions even before the first message. That is not\n * tidiness: a live region inserted into the DOM in the same frame as its first\n * content routinely loses that announcement, because the assistive technology has\n * to have registered the region before it can notice a change inside it.\n *\n * @returns A stable `announce(message, politeness?)` function.\n *\n * @example\n * const announce = useAnnounce();\n *\n * function onFilter(rows: Row[]) {\n *     announce(`${rows.length} resultados`);\n * }\n */\nexport function useAnnounce(): (message: string, politeness?: AnnouncePoliteness) => void {\n    useEffect(() => {\n        ensureRegions();\n    }, []);\n\n    return useCallback(\n        (message: string, politeness: AnnouncePoliteness = \"polite\") =>\n            announce(message, politeness),\n        [],\n    );\n}\n"],"mappings":";;AAaA,IAAMA,IAAiB,KAUjBC,IAA6C;CAC/C,UAAU;CACV,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,UAAU;CACV,MAAM;CACN,UAAU;CACV,YAAY;AAChB,GAOIC,IAA0B,MACxBC,oBAAS,IAAI,IAAmC;AAgBtD,SAASC,EAAa,GAA6C;CAC/D,IAAMC,IAAO,SAAS,cAAc,KAAK;CAOzC,OANIC,MAAe,YAAUD,EAAK,aAAa,QAAQ,QAAQ,GAC/DA,EAAK,aAAa,aAAaC,CAAU,GACzCD,EAAK,aAAa,eAAe,MAAM,GACvCA,EAAK,aAAa,0BAA0BC,CAAU,GACtD,OAAO,OAAOD,EAAK,OAAOJ,CAAY,GACtC,SAAS,KAAK,YAAYI,CAAI,GACvBA;AACX;AAsBA,SAASE,IAAgC;CAMrC,OALI,OAAO,WAAa,MAAoB,QACxCL,KAAWA,EAAQ,OAAO,eAAeA,EAAQ,UAAU,gBAC/DA,GAAS,OAAO,OAAO,GACvBA,GAAS,UAAU,OAAO,GAC1B,IAAU;EAAE,QAAQE,EAAa,QAAQ;EAAG,WAAWA,EAAa,WAAW;CAAE,IAC1EF;AACX;AAsBA,SAAgBM,EAAS,GAAiB,IAAiC,UAAgB;CACvF,IAAI,CAACC,GAAS;CACd,IAAMC,IAAOH,EAAc;CAC3B,IAAI,CAACG,GAAM;CAEX,IAAMC,IAASL,MAAe,cAAcI,EAAK,YAAYA,EAAK;CAClE,EAAO,gBAAgB;CACvB,IAAME,IAAO,SAAS,cAAc,KAAK;CAEzC,AADA,EAAK,cAAcH,GACnBE,EAAO,YAAYC,CAAI;CAEvB,IAAMC,IAAQ,iBAAiB;EAE3B,AADAV,EAAO,OAAOU,CAAK,GACfD,EAAK,eAAaA,EAAK,OAAO;CACtC,GAAGZ,CAAc;CACjB,EAAO,IAAIa,CAAK;AACpB;AASA,SAAgBC,IAAuB;CACnC,KAAK,IAAMD,KAASV,GAAQ,aAAaU,CAAK;CAI9C,AAHAV,EAAO,MAAM,GACbD,GAAS,OAAO,OAAO,GACvBA,GAAS,UAAU,OAAO,GAC1B,IAAU;AACd;AAgCA,SAAgBa,IAA0E;CAKtF,OAJAC,QAAgB;EACZ,EAAc;CAClB,GAAG,CAAC,CAAC,GAEEC,GACF,GAAiB,IAAiC,aAC/CT,EAASC,GAASH,CAAU,GAChC,CAAC,CACL;AACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-async.cjs","names":[],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useLatestRef(asyncFn);\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, [fnRef]);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":"+DA6BA,SAAgB,EACZ,EACA,EAA+B,CAAC,EAChC,EAAmC,CAAC,EACnB,CACjB,GAAM,CAAE,YAAY,IAAU,EACxB,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAIvB,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,EAElD,EAAQ,EAAA,aAAa,CAAO,EAC5B,GAAA,EAAY,EAAA,OAAA,CAAe,CAAC,EAC5B,GAAA,EAAa,EAAA,OAAA,CAAgB,EAAI,GAEvC,EAAA,EAAA,UAAA,MACI,EAAW,QAAU,OACR,CACT,EAAW,QAAU,EACzB,GACD,CAAC,CAAC,EAEL,IAAM,GAAA,EAAM,EAAA,YAAA,CAAY,SAAwB,CAC5C,IAAM,EAAS,EAAE,EAAU,QAC3B,EAAU,IAAa,CAAE,GAAG,EAAS,OAAQ,UAAW,MAAO,IAAA,EAAU,EAAE,EAC3E,GAAI,CACA,IAAM,EAAO,MAAM,EAAM,QAAQ,EAIjC,OAHI,EAAW,SAAW,EAAU,UAAY,GAC5C,EAAS,CAAE,OAAQ,UAAW,OAAM,MAAO,IAAA,EAAU,CAAC,EAEnD,CACX,OAAS,EAAO,CAIZ,MAHI,EAAW,SAAW,EAAU,UAAY,GAC5C,EAAS,CAAE,OAAQ,QAAS,KAAM,IAAA,GAAW,OAAM,CAAC,EAElD,CACV,CACJ,EAAG,CAAC,CAAK,CAAC,EAEJ,GAAA,EAAQ,EAAA,YAAA,KAAwB,CAClC,EAAU,UACV,EAAS,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,CAClE,EAAG,CAAC,CAAC,EAUL,OARA,EAAA,EAAA,UAAA,KAAgB,CACP,GACL,EAAI,CAAC,CAAC,UAAY,CAElB,CAAC,CAEL,EAAG,CAAC,EAAW,GAAG,CAAI,CAAC,EAEhB,CACH,OAAQ,EAAM,OACd,KAAM,EAAM,KACZ,MAAO,EAAM,MACb,UAAW,EAAM,SAAW,UAC5B,UAAW,EAAM,SAAW,UAC5B,QAAS,EAAM,SAAW,QAC1B,MACA,OACJ,CACJ"}
+{"version":3,"file":"use-async.cjs","names":["useState","useLatestRef","useRef","useCallback","require_use_latest_ref","react","useAsync","options","state","setState","fnRef","asyncFn","callIdRef","mountedRef","run","callId","current","data","error","reset","immediate","deps"],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useLatestRef(asyncFn);\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, [fnRef]);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":"A,+DA6BA,SAAgBM,EACZ,EACA,EAA+B,CAAC,EAChC,EAAmC,CAAC,EACnB,CACjB,GAAM,CAAE,YAAY,IAAUC,EACxB,CAACC,EAAOC,IAAA,EAAYT,EAAAA,SAAAA,CAIvB,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,EAElDU,EAAQT,EAAAA,aAAaU,CAAO,EAC5BC,GAAA,EAAYV,EAAAA,OAAAA,CAAe,CAAC,EAC5BW,GAAA,EAAaX,EAAAA,OAAAA,CAAgB,EAAI,GAEvC,EAAAG,EAAA,UAAA,MACI,EAAW,QAAU,OACR,CACT,EAAW,QAAU,EACzB,GACD,CAAC,CAAC,EAEL,IAAMS,GAAA,EAAMX,EAAAA,YAAAA,CAAY,SAAwB,CAC5C,IAAMY,EAAS,EAAEH,EAAU,QAC3BH,EAAU,IAAa,CAAE,GAAGO,EAAS,OAAQ,UAAW,MAAO,IAAA,EAAU,EAAE,EAC3E,GAAI,CACA,IAAMC,EAAO,MAAMP,EAAM,QAAQ,EAIjC,OAHIG,EAAW,SAAWD,EAAU,UAAYG,GAC5CN,EAAS,CAAE,OAAQ,UAAW,OAAM,MAAO,IAAA,EAAU,CAAC,EAEnDQ,CACX,OAASC,EAAO,CAIZ,MAHIL,EAAW,SAAWD,EAAU,UAAYG,GAC5CN,EAAS,CAAE,OAAQ,QAAS,KAAM,IAAA,GAAW,OAAM,CAAC,EAElDS,CACV,CACJ,EAAG,CAACR,CAAK,CAAC,EAEJS,GAAA,EAAQhB,EAAAA,YAAAA,KAAwB,CAClC,EAAU,UACVM,EAAS,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,CAClE,EAAG,CAAC,CAAC,EAUL,OARA,EAAAJ,EAAA,UAAA,KAAgB,CACPe,GACLN,EAAI,CAAC,CAAC,UAAY,CAElB,CAAC,CAEL,EAAG,CAACM,EAAW,GAAGC,CAAI,CAAC,EAEhB,CACH,OAAQb,EAAM,OACd,KAAMA,EAAM,KACZ,MAAOA,EAAM,MACb,UAAWA,EAAM,SAAW,UAC5B,UAAWA,EAAM,SAAW,UAC5B,QAASA,EAAM,SAAW,QAC1B,MACA,OACJ,CACJ,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-async.js","names":[],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useLatestRef(asyncFn);\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, [fnRef]);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":";;;AA6BA,SAAgB,EACZ,GACA,IAA+B,CAAC,GAChC,IAAmC,CAAC,GACnB;CACjB,IAAM,EAAE,eAAY,OAAU,GACxB,CAAC,GAAO,KAAY,EAIvB;EAAE,QAAQ;EAAQ,MAAM,KAAA;EAAW,OAAO,KAAA;CAAU,CAAC,GAElD,IAAQ,EAAa,CAAO,GAC5B,IAAY,EAAe,CAAC,GAC5B,IAAa,EAAgB,EAAI;CAEvC,SACI,EAAW,UAAU,UACR;EACT,EAAW,UAAU;CACzB,IACD,CAAC,CAAC;CAEL,IAAM,IAAM,EAAY,YAAwB;EAC5C,IAAM,IAAS,EAAE,EAAU;EAC3B,GAAU,OAAa;GAAE,GAAG;GAAS,QAAQ;GAAW,OAAO,KAAA;EAAU,EAAE;EAC3E,IAAI;GACA,IAAM,IAAO,MAAM,EAAM,QAAQ;GAIjC,OAHI,EAAW,WAAW,EAAU,YAAY,KAC5C,EAAS;IAAE,QAAQ;IAAW;IAAM,OAAO,KAAA;GAAU,CAAC,GAEnD;EACX,SAAS,GAAO;GAIZ,MAHI,EAAW,WAAW,EAAU,YAAY,KAC5C,EAAS;IAAE,QAAQ;IAAS,MAAM,KAAA;IAAW;GAAM,CAAC,GAElD;EACV;CACJ,GAAG,CAAC,CAAK,CAAC,GAEJ,IAAQ,QAAwB;EAElC,AADA,EAAU,WACV,EAAS;GAAE,QAAQ;GAAQ,MAAM,KAAA;GAAW,OAAO,KAAA;EAAU,CAAC;CAClE,GAAG,CAAC,CAAC;CAUL,OARA,QAAgB;EACP,KACL,EAAI,CAAC,CAAC,YAAY,CAElB,CAAC;CAEL,GAAG,CAAC,GAAW,GAAG,CAAI,CAAC,GAEhB;EACH,QAAQ,EAAM;EACd,MAAM,EAAM;EACZ,OAAO,EAAM;EACb,WAAW,EAAM,WAAW;EAC5B,WAAW,EAAM,WAAW;EAC5B,SAAS,EAAM,WAAW;EAC1B;EACA;CACJ;AACJ"}
+{"version":3,"file":"use-async.js","names":["useAsync","options","state","setState","useState","fnRef","useLatestRef","asyncFn","callIdRef","useRef","mountedRef","run","useCallback","callId","current","data","error","reset","useEffect","immediate","deps"],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useLatestRef(asyncFn);\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, [fnRef]);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":";;;AA6BA,SAAgBA,EACZ,GACA,IAA+B,CAAC,GAChC,IAAmC,CAAC,GACnB;CACjB,IAAM,EAAE,eAAY,OAAUC,GACxB,CAACC,GAAOC,KAAYC,EAIvB;EAAE,QAAQ;EAAQ,MAAM,KAAA;EAAW,OAAO,KAAA;CAAU,CAAC,GAElDC,IAAQC,EAAaC,CAAO,GAC5BC,IAAYC,EAAe,CAAC,GAC5BC,IAAaD,EAAgB,EAAI;CAEvC,SACI,EAAW,UAAU,UACR;EACT,EAAW,UAAU;CACzB,IACD,CAAC,CAAC;CAEL,IAAME,IAAMC,EAAY,YAAwB;EAC5C,IAAMC,IAAS,EAAEL,EAAU;EAC3B,GAAU,OAAa;GAAE,GAAGM;GAAS,QAAQ;GAAW,OAAO,KAAA;EAAU,EAAE;EAC3E,IAAI;GACA,IAAMC,IAAO,MAAMV,EAAM,QAAQ;GAIjC,OAHIK,EAAW,WAAWF,EAAU,YAAYK,KAC5CV,EAAS;IAAE,QAAQ;IAAW;IAAM,OAAO,KAAA;GAAU,CAAC,GAEnDY;EACX,SAASC,GAAO;GAIZ,MAHIN,EAAW,WAAWF,EAAU,YAAYK,KAC5CV,EAAS;IAAE,QAAQ;IAAS,MAAM,KAAA;IAAW;GAAM,CAAC,GAElDa;EACV;CACJ,GAAG,CAACX,CAAK,CAAC,GAEJY,IAAQL,QAAwB;EAElC,AADA,EAAU,WACVT,EAAS;GAAE,QAAQ;GAAQ,MAAM,KAAA;GAAW,OAAO,KAAA;EAAU,CAAC;CAClE,GAAG,CAAC,CAAC;CAUL,OARAe,QAAgB;EACZ,AAAKC,KACLR,EAAI,CAAC,CAAC,YAAY,CAElB,CAAC;CAEL,GAAG,CAACQ,GAAW,GAAGC,CAAI,CAAC,GAEhB;EACH,QAAQlB,EAAM;EACd,MAAMA,EAAM;EACZ,OAAOA,EAAM;EACb,WAAWA,EAAM,WAAW;EAC5B,WAAWA,EAAM,WAAW;EAC5B,SAASA,EAAM,WAAW;EAC1B;EACA;CACJ;AACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-before-install-prompt.cjs","names":[],"sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"mappings":"uBAwBA,SAAS,GAA4B,CACjC,GAAI,OAAO,OAAW,IAAa,MAAO,GAE1C,IAAM,EAAqB,CADL,aAAc,aAAc,YACvB,CAAA,CAAa,KACnC,GAAS,OAAO,aAAa,kBAAkB,EAAK,EAAE,CAAC,EAAE,OAC9D,EAEM,EACD,OAAO,UAAmD,aAAe,GAC9E,OAAO,GAAsB,CACjC,CAMA,SAAgB,GAAuD,CACnE,GAAM,CAAC,EAAU,IAAA,EAAe,EAAA,SAAA,CAA0C,IAAI,EACxE,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAkB,EAAK,EACnD,CAAC,EAAc,IAAA,EAAmB,EAAA,SAAA,CAAkB,CAAgB,GAE1E,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,EAAW,GAAuB,CACpC,EAAM,eAAe,EACrB,EAAY,CAAiC,CACjD,EACM,MAA+B,CACjC,EAAY,IAAI,EAChB,EAAa,EAAI,EACjB,EAAgB,EAAI,CACxB,EACM,EAAmB,OAAO,aAAa,4BAA4B,EACnE,MAAiC,EAAgB,EAAiB,CAAC,EAIzE,OAHA,OAAO,iBAAiB,sBAAuB,CAAO,EACtD,OAAO,iBAAiB,eAAgB,CAAgB,EACxD,GAAkB,iBAAiB,SAAU,CAAkB,MAClD,CACT,OAAO,oBAAoB,sBAAuB,CAAO,EACzD,OAAO,oBAAoB,eAAgB,CAAgB,EAC3D,GAAkB,oBAAoB,SAAU,CAAkB,CACtE,CACJ,EAAG,CAAC,CAAC,EAEL,IAAM,GAAA,EAAS,EAAA,YAAA,CAAY,SAA+D,CACtF,GAAI,CAAC,EAAU,MAAO,cACtB,MAAM,EAAS,OAAO,EACtB,IAAM,EAAS,MAAM,EAAS,WAG9B,OAFA,EAAY,IAAI,EACZ,EAAO,UAAY,YAAY,EAAa,EAAI,EAC7C,EAAO,OAClB,EAAG,CAAC,CAAQ,CAAC,EAEb,MAAO,CACH,YAAa,CAAC,CAAC,EACf,YACA,eACA,QACJ,CACJ"}
+{"version":3,"file":"use-before-install-prompt.cjs","names":["useState","useCallback","react","detectStandalone","matchesDisplayMode","mode","iosStandalone","useBeforeInstallPrompt","deferred","setDeferred","installed","setInstalled","isStandalone","setIsStandalone","handler","event","installedHandler","displayModeQuery","displayModeHandler","prompt","result"],"sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"mappings":"A,uBAwBA,SAASG,GAA4B,CACjC,GAAI,OAAO,OAAW,IAAa,MAAO,GAE1C,IAAMC,EAAqB,CADL,aAAc,aAAc,YACvB,CAAA,CAAa,KACnC,GAAS,OAAO,aAAa,kBAAkBC,EAAK,EAAE,CAAC,EAAE,OAC9D,EAEMC,EACD,OAAO,UAAmD,aAAe,GAC9E,OAAOF,GAAsBE,CACjC,CAMA,SAAgBC,GAAuD,CACnE,GAAM,CAACC,EAAUC,IAAA,EAAeT,EAAAA,SAAAA,CAA0C,IAAI,EACxE,CAACU,EAAWC,IAAA,EAAgBX,EAAAA,SAAAA,CAAkB,EAAK,EACnD,CAACY,EAAcC,IAAA,EAAmBb,EAAAA,SAAAA,CAAkBG,CAAgB,GAE1E,EAAAD,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAMY,EAAW,GAAuB,CACpCC,EAAM,eAAe,EACrBN,EAAYM,CAAiC,CACjD,EACMC,MAA+B,CACjCP,EAAY,IAAI,EAChBE,EAAa,EAAI,EACjBE,EAAgB,EAAI,CACxB,EACMI,EAAmB,OAAO,aAAa,4BAA4B,EACnEC,MAAiCL,EAAgBV,EAAiB,CAAC,EAIzE,OAHA,OAAO,iBAAiB,sBAAuBW,CAAO,EACtD,OAAO,iBAAiB,eAAgBE,CAAgB,EACxDC,GAAkB,iBAAiB,SAAUC,CAAkB,MAClD,CACT,OAAO,oBAAoB,sBAAuBJ,CAAO,EACzD,OAAO,oBAAoB,eAAgBE,CAAgB,EAC3DC,GAAkB,oBAAoB,SAAUC,CAAkB,CACtE,CACJ,EAAG,CAAC,CAAC,EAEL,IAAMC,GAAA,EAASlB,EAAAA,YAAAA,CAAY,SAA+D,CACtF,GAAI,CAACO,EAAU,MAAO,cACtB,MAAMA,EAAS,OAAO,EACtB,IAAMY,EAAS,MAAMZ,EAAS,WAG9B,OAFAC,EAAY,IAAI,EACZW,EAAO,UAAY,YAAYT,EAAa,EAAI,EAC7CS,EAAO,OAClB,EAAG,CAACZ,CAAQ,CAAC,EAEb,MAAO,CACH,YAAa,CAAC,CAACA,EACf,YACA,eACA,QACJ,CACJ,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-before-install-prompt.js","names":[],"sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"mappings":";;AAwBA,SAAS,IAA4B;CACjC,IAAI,OAAO,SAAW,KAAa,OAAO;CAE1C,IAAM,IAAqB;EADL;EAAc;EAAc;CACvB,CAAA,CAAa,MACnC,MAAS,OAAO,aAAa,kBAAkB,EAAK,EAAE,CAAC,EAAE,OAC9D,GAEM,IACD,OAAO,UAAmD,eAAe;CAC9E,OAAO,KAAsB;AACjC;AAMA,SAAgB,IAAuD;CACnE,IAAM,CAAC,GAAU,KAAe,EAA0C,IAAI,GACxE,CAAC,GAAW,KAAgB,EAAkB,EAAK,GACnD,CAAC,GAAc,KAAmB,EAAkB,CAAgB;CAE1E,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,KAAW,MAAuB;GAEpC,AADA,EAAM,eAAe,GACrB,EAAY,CAAiC;EACjD,GACM,UAA+B;GAGjC,AAFA,EAAY,IAAI,GAChB,EAAa,EAAI,GACjB,EAAgB,EAAI;EACxB,GACM,IAAmB,OAAO,aAAa,4BAA4B,GACnE,UAAiC,EAAgB,EAAiB,CAAC;EAIzE,OAHA,OAAO,iBAAiB,uBAAuB,CAAO,GACtD,OAAO,iBAAiB,gBAAgB,CAAgB,GACxD,GAAkB,iBAAiB,UAAU,CAAkB,SAClD;GAGT,AAFA,OAAO,oBAAoB,uBAAuB,CAAO,GACzD,OAAO,oBAAoB,gBAAgB,CAAgB,GAC3D,GAAkB,oBAAoB,UAAU,CAAkB;EACtE;CACJ,GAAG,CAAC,CAAC;CAEL,IAAM,IAAS,EAAY,YAA+D;EACtF,IAAI,CAAC,GAAU,OAAO;EACtB,MAAM,EAAS,OAAO;EACtB,IAAM,IAAS,MAAM,EAAS;EAG9B,OAFA,EAAY,IAAI,GACZ,EAAO,YAAY,cAAY,EAAa,EAAI,GAC7C,EAAO;CAClB,GAAG,CAAC,CAAQ,CAAC;CAEb,OAAO;EACH,aAAa,CAAC,CAAC;EACf;EACA;EACA;CACJ;AACJ"}
+{"version":3,"file":"use-before-install-prompt.js","names":["detectStandalone","matchesDisplayMode","mode","iosStandalone","useBeforeInstallPrompt","deferred","setDeferred","useState","installed","setInstalled","isStandalone","setIsStandalone","handler","event","installedHandler","displayModeQuery","displayModeHandler","prompt","useCallback","result"],"sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"mappings":";;AAwBA,SAASA,IAA4B;CACjC,IAAI,OAAO,SAAW,KAAa,OAAO;CAE1C,IAAMC,IAAqB;EADL;EAAc;EAAc;CACvB,CAAA,CAAa,MACnC,MAAS,OAAO,aAAa,kBAAkBC,EAAK,EAAE,CAAC,EAAE,OAC9D,GAEMC,IACD,OAAO,UAAmD,eAAe;CAC9E,OAAOF,KAAsBE;AACjC;AAMA,SAAgBC,IAAuD;CACnE,IAAM,CAACC,GAAUC,KAAeC,EAA0C,IAAI,GACxE,CAACC,GAAWC,KAAgBF,EAAkB,EAAK,GACnD,CAACG,GAAcC,KAAmBJ,EAAkBP,CAAgB;CAE1E,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAMY,KAAW,MAAuB;GAEpC,AADAC,EAAM,eAAe,GACrBP,EAAYO,CAAiC;EACjD,GACMC,UAA+B;GAGjC,AAFAR,EAAY,IAAI,GAChBG,EAAa,EAAI,GACjBE,EAAgB,EAAI;EACxB,GACMI,IAAmB,OAAO,aAAa,4BAA4B,GACnEC,UAAiCL,EAAgBX,EAAiB,CAAC;EAIzE,OAHA,OAAO,iBAAiB,uBAAuBY,CAAO,GACtD,OAAO,iBAAiB,gBAAgBE,CAAgB,GACxDC,GAAkB,iBAAiB,UAAUC,CAAkB,SAClD;GAGT,AAFA,OAAO,oBAAoB,uBAAuBJ,CAAO,GACzD,OAAO,oBAAoB,gBAAgBE,CAAgB,GAC3DC,GAAkB,oBAAoB,UAAUC,CAAkB;EACtE;CACJ,GAAG,CAAC,CAAC;CAEL,IAAMC,IAASC,EAAY,YAA+D;EACtF,IAAI,CAACb,GAAU,OAAO;EACtB,MAAMA,EAAS,OAAO;EACtB,IAAMc,IAAS,MAAMd,EAAS;EAG9B,OAFAC,EAAY,IAAI,GACZa,EAAO,YAAY,cAAYV,EAAa,EAAI,GAC7CU,EAAO;CAClB,GAAG,CAACd,CAAQ,CAAC;CAEb,OAAO;EACH,aAAa,CAAC,CAACA;EACf;EACA;EACA;CACJ;AACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-breakpoint.cjs","names":[],"sources":["../../src/hooks/use-breakpoint.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Breakpoint keys exposed by the SDK. Values mirror the CSS tokens\n * `--tempest-bp-xs|sm|md|lg|xl|2xl` defined in `styles/colors.css`.\n */\nexport type Breakpoint = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\";\n\n/** Pixel value paired with each breakpoint key. */\nexport const BREAKPOINTS: Record<Breakpoint, number> = {\n    xs: 480,\n    sm: 640,\n    md: 768,\n    lg: 1024,\n    xl: 1280,\n    \"2xl\": 1536,\n};\n\nconst ORDER: readonly Breakpoint[] = [\"xs\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n\nfunction resolveCurrent(width: number): Breakpoint {\n    let current: Breakpoint = \"xs\";\n    for (const key of ORDER) {\n        if (width >= BREAKPOINTS[key]) {\n            current = key;\n        }\n    }\n    return current;\n}\n\nexport interface BreakpointHelpers {\n    /** Current breakpoint key (the largest one whose min-width is matched). */\n    current: Breakpoint;\n    /** Window width in pixels at last update. `0` when SSR. */\n    width: number;\n    /** True when viewport width is `>=` the given breakpoint. */\n    above: (bp: Breakpoint) => boolean;\n    /** True when viewport width is `<` the given breakpoint. */\n    below: (bp: Breakpoint) => boolean;\n    /** Convenience flags mapping to typical device shapes. */\n    isMobile: boolean;\n    isTablet: boolean;\n    isDesktop: boolean;\n}\n\n/**\n * Reactive viewport-breakpoint hook.\n *\n * Returns the current breakpoint key plus `above` / `below` helpers and\n * `isMobile` / `isTablet` / `isDesktop` flags. SSR-safe — returns `xs` /\n * `width: 0` on the server, then updates after mount.\n */\nexport function useBreakpoint(): BreakpointHelpers {\n    const [width, setWidth] = useState<number>(() =>\n        typeof window === \"undefined\" ? 0 : window.innerWidth,\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void => setWidth(window.innerWidth);\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    const current = resolveCurrent(width);\n    const above = (bp: Breakpoint): boolean => width >= BREAKPOINTS[bp];\n    const below = (bp: Breakpoint): boolean => width < BREAKPOINTS[bp];\n\n    return {\n        current,\n        width,\n        above,\n        below,\n        isMobile: below(\"md\"),\n        isTablet: above(\"md\") && below(\"lg\"),\n        isDesktop: above(\"lg\"),\n    };\n}\n"],"mappings":"uBASA,IAAa,EAA0C,CACnD,GAAI,IACJ,GAAI,IACJ,GAAI,IACJ,GAAI,KACJ,GAAI,KACJ,MAAO,IACX,EAEM,EAA+B,CAAC,KAAM,KAAM,KAAM,KAAM,KAAM,KAAK,EAEzE,SAAS,EAAe,EAA2B,CAC/C,IAAI,EAAsB,KAC1B,IAAK,IAAM,KAAO,EACV,GAAS,EAAY,KACrB,EAAU,GAGlB,OAAO,CACX,CAwBA,SAAgB,GAAmC,CAC/C,GAAM,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,KACtB,OAAO,OAAW,IAAc,EAAI,OAAO,UAC/C,GAEA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,MAAuB,EAAS,OAAO,UAAU,EAGvD,OAFA,EAAS,EACT,OAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,MAChD,OAAO,oBAAoB,SAAU,CAAQ,CAC9D,EAAG,CAAC,CAAC,EAEL,IAAM,EAAU,EAAe,CAAK,EAC9B,EAAS,GAA4B,GAAS,EAAY,GAC1D,EAAS,GAA4B,EAAQ,EAAY,GAE/D,MAAO,CACH,UACA,QACA,QACA,QACA,SAAU,EAAM,IAAI,EACpB,SAAU,EAAM,IAAI,GAAK,EAAM,IAAI,EACnC,UAAW,EAAM,IAAI,CACzB,CACJ"}
+{"version":3,"file":"use-breakpoint.cjs","names":["useState","react","BREAKPOINTS","ORDER","resolveCurrent","current","key","width","useBreakpoint","setWidth","onResize","above","bp","below"],"sources":["../../src/hooks/use-breakpoint.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Breakpoint keys exposed by the SDK. Values mirror the CSS tokens\n * `--tempest-bp-xs|sm|md|lg|xl|2xl` defined in `styles/colors.css`.\n */\nexport type Breakpoint = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\";\n\n/** Pixel value paired with each breakpoint key. */\nexport const BREAKPOINTS: Record<Breakpoint, number> = {\n    xs: 480,\n    sm: 640,\n    md: 768,\n    lg: 1024,\n    xl: 1280,\n    \"2xl\": 1536,\n};\n\nconst ORDER: readonly Breakpoint[] = [\"xs\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n\nfunction resolveCurrent(width: number): Breakpoint {\n    let current: Breakpoint = \"xs\";\n    for (const key of ORDER) {\n        if (width >= BREAKPOINTS[key]) {\n            current = key;\n        }\n    }\n    return current;\n}\n\nexport interface BreakpointHelpers {\n    /** Current breakpoint key (the largest one whose min-width is matched). */\n    current: Breakpoint;\n    /** Window width in pixels at last update. `0` when SSR. */\n    width: number;\n    /** True when viewport width is `>=` the given breakpoint. */\n    above: (bp: Breakpoint) => boolean;\n    /** True when viewport width is `<` the given breakpoint. */\n    below: (bp: Breakpoint) => boolean;\n    /** Convenience flags mapping to typical device shapes. */\n    isMobile: boolean;\n    isTablet: boolean;\n    isDesktop: boolean;\n}\n\n/**\n * Reactive viewport-breakpoint hook.\n *\n * Returns the current breakpoint key plus `above` / `below` helpers and\n * `isMobile` / `isTablet` / `isDesktop` flags. SSR-safe — returns `xs` /\n * `width: 0` on the server, then updates after mount.\n */\nexport function useBreakpoint(): BreakpointHelpers {\n    const [width, setWidth] = useState<number>(() =>\n        typeof window === \"undefined\" ? 0 : window.innerWidth,\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void => setWidth(window.innerWidth);\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    const current = resolveCurrent(width);\n    const above = (bp: Breakpoint): boolean => width >= BREAKPOINTS[bp];\n    const below = (bp: Breakpoint): boolean => width < BREAKPOINTS[bp];\n\n    return {\n        current,\n        width,\n        above,\n        below,\n        isMobile: below(\"md\"),\n        isTablet: above(\"md\") && below(\"lg\"),\n        isDesktop: above(\"lg\"),\n    };\n}\n"],"mappings":"A,uBASA,IAAaE,EAA0C,CACnD,GAAI,IACJ,GAAI,IACJ,GAAI,IACJ,GAAI,KACJ,GAAI,KACJ,MAAO,IACX,EAEMC,EAA+B,CAAC,KAAM,KAAM,KAAM,KAAM,KAAM,KAAK,EAEzE,SAASC,EAAe,EAA2B,CAC/C,IAAIC,EAAsB,KAC1B,IAAK,IAAMC,KAAOH,EACVI,GAASL,EAAYI,KACrB,EAAUA,GAGlB,OAAOD,CACX,CAwBA,SAAgBG,GAAmC,CAC/C,GAAM,CAACD,EAAOE,IAAA,EAAYT,EAAAA,SAAAA,KACtB,OAAO,OAAW,IAAc,EAAI,OAAO,UAC/C,GAEA,EAAAC,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAMS,MAAuBD,EAAS,OAAO,UAAU,EAGvD,OAFAC,EAAS,EACT,OAAO,iBAAiB,SAAUA,EAAU,CAAE,QAAS,EAAK,CAAC,MAChD,OAAO,oBAAoB,SAAUA,CAAQ,CAC9D,EAAG,CAAC,CAAC,EAEL,IAAML,EAAUD,EAAeG,CAAK,EAC9BI,EAAS,GAA4BJ,GAASL,EAAYU,GAC1DC,EAAS,GAA4BN,EAAQL,EAAYU,GAE/D,MAAO,CACH,UACA,QACA,QACA,QACA,SAAUC,EAAM,IAAI,EACpB,SAAUF,EAAM,IAAI,GAAKE,EAAM,IAAI,EACnC,UAAWF,EAAM,IAAI,CACzB,CACJ,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-breakpoint.js","names":[],"sources":["../../src/hooks/use-breakpoint.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Breakpoint keys exposed by the SDK. Values mirror the CSS tokens\n * `--tempest-bp-xs|sm|md|lg|xl|2xl` defined in `styles/colors.css`.\n */\nexport type Breakpoint = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\";\n\n/** Pixel value paired with each breakpoint key. */\nexport const BREAKPOINTS: Record<Breakpoint, number> = {\n    xs: 480,\n    sm: 640,\n    md: 768,\n    lg: 1024,\n    xl: 1280,\n    \"2xl\": 1536,\n};\n\nconst ORDER: readonly Breakpoint[] = [\"xs\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n\nfunction resolveCurrent(width: number): Breakpoint {\n    let current: Breakpoint = \"xs\";\n    for (const key of ORDER) {\n        if (width >= BREAKPOINTS[key]) {\n            current = key;\n        }\n    }\n    return current;\n}\n\nexport interface BreakpointHelpers {\n    /** Current breakpoint key (the largest one whose min-width is matched). */\n    current: Breakpoint;\n    /** Window width in pixels at last update. `0` when SSR. */\n    width: number;\n    /** True when viewport width is `>=` the given breakpoint. */\n    above: (bp: Breakpoint) => boolean;\n    /** True when viewport width is `<` the given breakpoint. */\n    below: (bp: Breakpoint) => boolean;\n    /** Convenience flags mapping to typical device shapes. */\n    isMobile: boolean;\n    isTablet: boolean;\n    isDesktop: boolean;\n}\n\n/**\n * Reactive viewport-breakpoint hook.\n *\n * Returns the current breakpoint key plus `above` / `below` helpers and\n * `isMobile` / `isTablet` / `isDesktop` flags. SSR-safe — returns `xs` /\n * `width: 0` on the server, then updates after mount.\n */\nexport function useBreakpoint(): BreakpointHelpers {\n    const [width, setWidth] = useState<number>(() =>\n        typeof window === \"undefined\" ? 0 : window.innerWidth,\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void => setWidth(window.innerWidth);\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    const current = resolveCurrent(width);\n    const above = (bp: Breakpoint): boolean => width >= BREAKPOINTS[bp];\n    const below = (bp: Breakpoint): boolean => width < BREAKPOINTS[bp];\n\n    return {\n        current,\n        width,\n        above,\n        below,\n        isMobile: below(\"md\"),\n        isTablet: above(\"md\") && below(\"lg\"),\n        isDesktop: above(\"lg\"),\n    };\n}\n"],"mappings":";;AASA,IAAa,IAA0C;CACnD,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,OAAO;AACX,GAEM,IAA+B;CAAC;CAAM;CAAM;CAAM;CAAM;CAAM;AAAK;AAEzE,SAAS,EAAe,GAA2B;CAC/C,IAAI,IAAsB;CAC1B,KAAK,IAAM,KAAO,GACd,AAAI,KAAS,EAAY,OACrB,IAAU;CAGlB,OAAO;AACX;AAwBA,SAAgB,IAAmC;CAC/C,IAAM,CAAC,GAAO,KAAY,QACtB,OAAO,SAAW,MAAc,IAAI,OAAO,UAC/C;CAEA,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,UAAuB,EAAS,OAAO,UAAU;EAGvD,OAFA,EAAS,GACT,OAAO,iBAAiB,UAAU,GAAU,EAAE,SAAS,GAAK,CAAC,SAChD,OAAO,oBAAoB,UAAU,CAAQ;CAC9D,GAAG,CAAC,CAAC;CAEL,IAAM,IAAU,EAAe,CAAK,GAC9B,KAAS,MAA4B,KAAS,EAAY,IAC1D,KAAS,MAA4B,IAAQ,EAAY;CAE/D,OAAO;EACH;EACA;EACA;EACA;EACA,UAAU,EAAM,IAAI;EACpB,UAAU,EAAM,IAAI,KAAK,EAAM,IAAI;EACnC,WAAW,EAAM,IAAI;CACzB;AACJ"}
+{"version":3,"file":"use-breakpoint.js","names":["BREAKPOINTS","ORDER","resolveCurrent","current","key","width","useBreakpoint","setWidth","useState","onResize","above","bp","below"],"sources":["../../src/hooks/use-breakpoint.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Breakpoint keys exposed by the SDK. Values mirror the CSS tokens\n * `--tempest-bp-xs|sm|md|lg|xl|2xl` defined in `styles/colors.css`.\n */\nexport type Breakpoint = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\";\n\n/** Pixel value paired with each breakpoint key. */\nexport const BREAKPOINTS: Record<Breakpoint, number> = {\n    xs: 480,\n    sm: 640,\n    md: 768,\n    lg: 1024,\n    xl: 1280,\n    \"2xl\": 1536,\n};\n\nconst ORDER: readonly Breakpoint[] = [\"xs\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n\nfunction resolveCurrent(width: number): Breakpoint {\n    let current: Breakpoint = \"xs\";\n    for (const key of ORDER) {\n        if (width >= BREAKPOINTS[key]) {\n            current = key;\n        }\n    }\n    return current;\n}\n\nexport interface BreakpointHelpers {\n    /** Current breakpoint key (the largest one whose min-width is matched). */\n    current: Breakpoint;\n    /** Window width in pixels at last update. `0` when SSR. */\n    width: number;\n    /** True when viewport width is `>=` the given breakpoint. */\n    above: (bp: Breakpoint) => boolean;\n    /** True when viewport width is `<` the given breakpoint. */\n    below: (bp: Breakpoint) => boolean;\n    /** Convenience flags mapping to typical device shapes. */\n    isMobile: boolean;\n    isTablet: boolean;\n    isDesktop: boolean;\n}\n\n/**\n * Reactive viewport-breakpoint hook.\n *\n * Returns the current breakpoint key plus `above` / `below` helpers and\n * `isMobile` / `isTablet` / `isDesktop` flags. SSR-safe — returns `xs` /\n * `width: 0` on the server, then updates after mount.\n */\nexport function useBreakpoint(): BreakpointHelpers {\n    const [width, setWidth] = useState<number>(() =>\n        typeof window === \"undefined\" ? 0 : window.innerWidth,\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void => setWidth(window.innerWidth);\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    const current = resolveCurrent(width);\n    const above = (bp: Breakpoint): boolean => width >= BREAKPOINTS[bp];\n    const below = (bp: Breakpoint): boolean => width < BREAKPOINTS[bp];\n\n    return {\n        current,\n        width,\n        above,\n        below,\n        isMobile: below(\"md\"),\n        isTablet: above(\"md\") && below(\"lg\"),\n        isDesktop: above(\"lg\"),\n    };\n}\n"],"mappings":";;AASA,IAAaA,IAA0C;CACnD,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,OAAO;AACX,GAEMC,IAA+B;CAAC;CAAM;CAAM;CAAM;CAAM;CAAM;AAAK;AAEzE,SAASC,EAAe,GAA2B;CAC/C,IAAIC,IAAsB;CAC1B,KAAK,IAAMC,KAAOH,GACd,AAAII,KAASL,EAAYI,OACrB,IAAUA;CAGlB,OAAOD;AACX;AAwBA,SAAgBG,IAAmC;CAC/C,IAAM,CAACD,GAAOE,KAAYC,QACtB,OAAO,SAAW,MAAc,IAAI,OAAO,UAC/C;CAEA,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAMC,UAAuBF,EAAS,OAAO,UAAU;EAGvD,OAFAE,EAAS,GACT,OAAO,iBAAiB,UAAUA,GAAU,EAAE,SAAS,GAAK,CAAC,SAChD,OAAO,oBAAoB,UAAUA,CAAQ;CAC9D,GAAG,CAAC,CAAC;CAEL,IAAMN,IAAUD,EAAeG,CAAK,GAC9BK,KAAS,MAA4BL,KAASL,EAAYW,IAC1DC,KAAS,MAA4BP,IAAQL,EAAYW;CAE/D,OAAO;EACH;EACA;EACA;EACA;EACA,UAAUC,EAAM,IAAI;EACpB,UAAUF,EAAM,IAAI,KAAKE,EAAM,IAAI;EACnC,WAAWF,EAAM,IAAI;CACzB;AACJ"}

package/dist/hooks/use-click-outside.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-click-outside.cjs","names":[],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, [handlerRef]);\n\n    return ref;\n}\n"],"mappings":"+DAYA,SAAgB,EACZ,EACmB,CACnB,IAAM,GAAA,EAAM,EAAA,OAAA,CAAU,IAAI,EACpB,EAAa,EAAA,aAAa,CAAO,EAmBvC,OAjBA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,SAAa,IAAa,OAErC,IAAM,EAAY,GAAyC,CACvD,IAAM,EAAS,EAAM,OACjB,CAAC,EAAI,SAAY,GAAU,EAAI,QAAQ,SAAS,CAAM,GAC1D,EAAW,QAAQ,CACvB,EAIA,OAFA,SAAS,iBAAiB,YAAa,CAAQ,EAC/C,SAAS,iBAAiB,aAAc,CAAQ,MACnC,CACT,SAAS,oBAAoB,YAAa,CAAQ,EAClD,SAAS,oBAAoB,aAAc,CAAQ,CACvD,CACJ,EAAG,CAAC,CAAU,CAAC,EAER,CACX"}
+{"version":3,"file":"use-click-outside.cjs","names":["useRef","useLatestRef","require_use_latest_ref","react","useClickOutside","ref","handlerRef","handler","listener","target","event"],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, [handlerRef]);\n\n    return ref;\n}\n"],"mappings":"A,+DAYA,SAAgBI,EACZ,EACmB,CACnB,IAAMC,GAAA,EAAML,EAAAA,OAAAA,CAAU,IAAI,EACpBM,EAAaL,EAAAA,aAAaM,CAAO,EAmBvC,OAjBA,EAAAJ,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,SAAa,IAAa,OAErC,IAAMK,EAAY,GAAyC,CACvD,IAAMC,EAASC,EAAM,OACjB,CAACL,EAAI,SAAYI,GAAUJ,EAAI,QAAQ,SAASI,CAAM,GAC1DH,EAAW,QAAQ,CACvB,EAIA,OAFA,SAAS,iBAAiB,YAAaE,CAAQ,EAC/C,SAAS,iBAAiB,aAAcA,CAAQ,MACnC,CACT,SAAS,oBAAoB,YAAaA,CAAQ,EAClD,SAAS,oBAAoB,aAAcA,CAAQ,CACvD,CACJ,EAAG,CAACF,CAAU,CAAC,EAERD,CACX,C"}

package/dist/hooks/use-click-outside.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-click-outside.js","names":[],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, [handlerRef]);\n\n    return ref;\n}\n"],"mappings":";;;AAYA,SAAgB,EACZ,GACmB;CACnB,IAAM,IAAM,EAAU,IAAI,GACpB,IAAa,EAAa,CAAO;CAmBvC,OAjBA,QAAgB;EACZ,IAAI,OAAO,WAAa,KAAa;EAErC,IAAM,KAAY,MAAyC;GACvD,IAAM,IAAS,EAAM;GACjB,CAAC,EAAI,WAAY,KAAU,EAAI,QAAQ,SAAS,CAAM,KAC1D,EAAW,QAAQ;EACvB;EAIA,OAFA,SAAS,iBAAiB,aAAa,CAAQ,GAC/C,SAAS,iBAAiB,cAAc,CAAQ,SACnC;GAET,AADA,SAAS,oBAAoB,aAAa,CAAQ,GAClD,SAAS,oBAAoB,cAAc,CAAQ;EACvD;CACJ,GAAG,CAAC,CAAU,CAAC,GAER;AACX"}
+{"version":3,"file":"use-click-outside.js","names":["useClickOutside","ref","useRef","handlerRef","useLatestRef","handler","useEffect","listener","target","event"],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, [handlerRef]);\n\n    return ref;\n}\n"],"mappings":";;;AAYA,SAAgBA,EACZ,GACmB;CACnB,IAAMC,IAAMC,EAAU,IAAI,GACpBC,IAAaC,EAAaC,CAAO;CAmBvC,OAjBAC,QAAgB;EACZ,IAAI,OAAO,WAAa,KAAa;EAErC,IAAMC,KAAY,MAAyC;GACvD,IAAMC,IAASC,EAAM;GACrB,AAAI,CAACR,EAAI,WAAYO,KAAUP,EAAI,QAAQ,SAASO,CAAM,KAC1DL,EAAW,QAAQ;EACvB;EAIA,OAFA,SAAS,iBAAiB,aAAaI,CAAQ,GAC/C,SAAS,iBAAiB,cAAcA,CAAQ,SACnC;GAET,AADA,SAAS,oBAAoB,aAAaA,CAAQ,GAClD,SAAS,oBAAoB,cAAcA,CAAQ;EACvD;CACJ,GAAG,CAACJ,CAAU,CAAC,GAERF;AACX"}

package/dist/hooks/use-client-filter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-client-filter.cjs","names":[],"sources":["../../src/hooks/use-client-filter.ts"],"sourcesContent":["import { useMemo } from \"react\";\n\nexport type FilterPredicate<T> = (item: T, search: string) => boolean;\n\n/**\n * Client-side filter helper. Performs a case-insensitive match on the listed\n * keys when no custom predicate is provided.\n *\n * @param items - Source list.\n * @param search - Search string.\n * @param keysOrPredicate - Either a list of keys to match against or a custom predicate.\n * @returns Filtered list (referential identity preserved when search is empty).\n */\nexport function useClientFilter<T extends Record<string, unknown>>(\n    items: T[],\n    search: string,\n    keysOrPredicate: (keyof T)[] | FilterPredicate<T>,\n): T[] {\n    return useMemo(() => {\n        const term = search.trim().toLowerCase();\n        if (!term) return items;\n        if (typeof keysOrPredicate === \"function\") {\n            return items.filter((item) => keysOrPredicate(item, term));\n        }\n        return items.filter((item) =>\n            keysOrPredicate.some((key) => {\n                const value = item[key];\n                return value != null && String(value).toLowerCase().includes(term);\n            }),\n        );\n    }, [items, search, keysOrPredicate]);\n}\n"],"mappings":"uBAaA,SAAgB,EACZ,EACA,EACA,EACG,CACH,OAAA,EAAO,EAAA,QAAA,KAAc,CACjB,IAAM,EAAO,EAAO,KAAK,CAAC,CAAC,YAAY,EAKvC,OAJK,EACD,OAAO,GAAoB,WACpB,EAAM,OAAQ,GAAS,EAAgB,EAAM,CAAI,CAAC,EAEtD,EAAM,OAAQ,GACjB,EAAgB,KAAM,GAAQ,CAC1B,IAAM,EAAQ,EAAK,GACnB,OAAO,GAAS,MAAQ,OAAO,CAAK,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,CAAI,CACrE,CAAC,CACL,EATkB,CAUtB,EAAG,CAAC,EAAO,EAAQ,CAAe,CAAC,CACvC"}
+{"version":3,"file":"use-client-filter.cjs","names":["useMemo","react","useClientFilter","term","search","keysOrPredicate","items","item","value","key"],"sources":["../../src/hooks/use-client-filter.ts"],"sourcesContent":["import { useMemo } from \"react\";\n\nexport type FilterPredicate<T> = (item: T, search: string) => boolean;\n\n/**\n * Client-side filter helper. Performs a case-insensitive match on the listed\n * keys when no custom predicate is provided.\n *\n * @param items - Source list.\n * @param search - Search string.\n * @param keysOrPredicate - Either a list of keys to match against or a custom predicate.\n * @returns Filtered list (referential identity preserved when search is empty).\n */\nexport function useClientFilter<T extends Record<string, unknown>>(\n    items: T[],\n    search: string,\n    keysOrPredicate: (keyof T)[] | FilterPredicate<T>,\n): T[] {\n    return useMemo(() => {\n        const term = search.trim().toLowerCase();\n        if (!term) return items;\n        if (typeof keysOrPredicate === \"function\") {\n            return items.filter((item) => keysOrPredicate(item, term));\n        }\n        return items.filter((item) =>\n            keysOrPredicate.some((key) => {\n                const value = item[key];\n                return value != null && String(value).toLowerCase().includes(term);\n            }),\n        );\n    }, [items, search, keysOrPredicate]);\n}\n"],"mappings":"A,uBAaA,SAAgBE,EACZ,EACA,EACA,EACG,CACH,OAAA,EAAOF,EAAAA,QAAAA,KAAc,CACjB,IAAMG,EAAOC,EAAO,KAAK,CAAC,CAAC,YAAY,EAKvC,OAJKD,EACD,OAAOE,GAAoB,WACpBC,EAAM,OAAQ,GAASD,EAAgBE,EAAMJ,CAAI,CAAC,EAEtDG,EAAM,OAAQ,GACjBD,EAAgB,KAAM,GAAQ,CAC1B,IAAMG,EAAQD,EAAKE,GACnB,OAAOD,GAAS,MAAQ,OAAOA,CAAK,CAAC,CAAC,YAAY,CAAC,CAAC,SAASL,CAAI,CACrE,CAAC,CACL,EATkBG,CAUtB,EAAG,CAACA,EAAOF,EAAQC,CAAe,CAAC,CACvC,C"}

package/dist/hooks/use-client-filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-client-filter.js","names":[],"sources":["../../src/hooks/use-client-filter.ts"],"sourcesContent":["import { useMemo } from \"react\";\n\nexport type FilterPredicate<T> = (item: T, search: string) => boolean;\n\n/**\n * Client-side filter helper. Performs a case-insensitive match on the listed\n * keys when no custom predicate is provided.\n *\n * @param items - Source list.\n * @param search - Search string.\n * @param keysOrPredicate - Either a list of keys to match against or a custom predicate.\n * @returns Filtered list (referential identity preserved when search is empty).\n */\nexport function useClientFilter<T extends Record<string, unknown>>(\n    items: T[],\n    search: string,\n    keysOrPredicate: (keyof T)[] | FilterPredicate<T>,\n): T[] {\n    return useMemo(() => {\n        const term = search.trim().toLowerCase();\n        if (!term) return items;\n        if (typeof keysOrPredicate === \"function\") {\n            return items.filter((item) => keysOrPredicate(item, term));\n        }\n        return items.filter((item) =>\n            keysOrPredicate.some((key) => {\n                const value = item[key];\n                return value != null && String(value).toLowerCase().includes(term);\n            }),\n        );\n    }, [items, search, keysOrPredicate]);\n}\n"],"mappings":";;AAaA,SAAgB,EACZ,GACA,GACA,GACG;CACH,OAAO,QAAc;EACjB,IAAM,IAAO,EAAO,KAAK,CAAC,CAAC,YAAY;EAKvC,OAJK,IACD,OAAO,KAAoB,aACpB,EAAM,QAAQ,MAAS,EAAgB,GAAM,CAAI,CAAC,IAEtD,EAAM,QAAQ,MACjB,EAAgB,MAAM,MAAQ;GAC1B,IAAM,IAAQ,EAAK;GACnB,OAAO,KAAS,QAAQ,OAAO,CAAK,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,CAAI;EACrE,CAAC,CACL,IATkB;CAUtB,GAAG;EAAC;EAAO;EAAQ;CAAe,CAAC;AACvC"}
+{"version":3,"file":"use-client-filter.js","names":["useClientFilter","useMemo","term","search","keysOrPredicate","items","item","value","key"],"sources":["../../src/hooks/use-client-filter.ts"],"sourcesContent":["import { useMemo } from \"react\";\n\nexport type FilterPredicate<T> = (item: T, search: string) => boolean;\n\n/**\n * Client-side filter helper. Performs a case-insensitive match on the listed\n * keys when no custom predicate is provided.\n *\n * @param items - Source list.\n * @param search - Search string.\n * @param keysOrPredicate - Either a list of keys to match against or a custom predicate.\n * @returns Filtered list (referential identity preserved when search is empty).\n */\nexport function useClientFilter<T extends Record<string, unknown>>(\n    items: T[],\n    search: string,\n    keysOrPredicate: (keyof T)[] | FilterPredicate<T>,\n): T[] {\n    return useMemo(() => {\n        const term = search.trim().toLowerCase();\n        if (!term) return items;\n        if (typeof keysOrPredicate === \"function\") {\n            return items.filter((item) => keysOrPredicate(item, term));\n        }\n        return items.filter((item) =>\n            keysOrPredicate.some((key) => {\n                const value = item[key];\n                return value != null && String(value).toLowerCase().includes(term);\n            }),\n        );\n    }, [items, search, keysOrPredicate]);\n}\n"],"mappings":";;AAaA,SAAgBA,EACZ,GACA,GACA,GACG;CACH,OAAOC,QAAc;EACjB,IAAMC,IAAOC,EAAO,KAAK,CAAC,CAAC,YAAY;EAKvC,OAJKD,IACD,OAAOE,KAAoB,aACpBC,EAAM,QAAQ,MAASD,EAAgBE,GAAMJ,CAAI,CAAC,IAEtDG,EAAM,QAAQ,MACjBD,EAAgB,MAAM,MAAQ;GAC1B,IAAMG,IAAQD,EAAKE;GACnB,OAAOD,KAAS,QAAQ,OAAOA,CAAK,CAAC,CAAC,YAAY,CAAC,CAAC,SAASL,CAAI;EACrE,CAAC,CACL,IATkBG;CAUtB,GAAG;EAACA;EAAOF;EAAQC;CAAe,CAAC;AACvC"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-clipboard.cjs","names":[],"sources":["../../src/hooks/use-clipboard.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport interface UseClipboardOptions {\n    /** Time (ms) before the `copied` flag resets back to false. Default: 1500. */\n    resetAfter?: number;\n}\n\nexport interface UseClipboardResult {\n    /** True briefly after a successful copy. */\n    copied: boolean;\n    /** Copy a string to the clipboard. Returns `true` on success. */\n    copy: (text: string) => Promise<boolean>;\n    /** Manually reset the `copied` flag. */\n    reset: () => void;\n}\n\n/**\n * Wrapper around `navigator.clipboard.writeText` with a transient `copied`\n * flag for UI feedback (\"Copied!\" toast). Falls back gracefully when the\n * Clipboard API is unavailable.\n */\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardResult {\n    const { resetAfter = 1500 } = options;\n    const [copied, setCopied] = useState<boolean>(false);\n    const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    const reset = useCallback((): void => {\n        if (timer.current) {\n            clearTimeout(timer.current);\n            timer.current = null;\n        }\n        setCopied(false);\n    }, []);\n\n    useEffect(() => () => reset(), [reset]);\n\n    const copy = useCallback(\n        async (text: string): Promise<boolean> => {\n            try {\n                if (typeof navigator !== \"undefined\" && navigator.clipboard?.writeText) {\n                    await navigator.clipboard.writeText(text);\n                } else if (typeof document !== \"undefined\") {\n                    const textarea = document.createElement(\"textarea\");\n                    textarea.value = text;\n                    textarea.style.position = \"fixed\";\n                    textarea.style.opacity = \"0\";\n                    document.body.appendChild(textarea);\n                    textarea.select();\n                    document.execCommand(\"copy\");\n                    document.body.removeChild(textarea);\n                } else {\n                    return false;\n                }\n                setCopied(true);\n                if (timer.current) clearTimeout(timer.current);\n                timer.current = setTimeout(() => setCopied(false), resetAfter);\n                return true;\n            } catch {\n                return false;\n            }\n        },\n        [resetAfter],\n    );\n\n    return { copied, copy, reset };\n}\n"],"mappings":"uBAqBA,SAAgB,EAAa,EAA+B,CAAC,EAAuB,CAChF,GAAM,CAAE,aAAa,MAAS,EACxB,CAAC,EAAQ,IAAA,EAAa,EAAA,SAAA,CAAkB,EAAK,EAC7C,GAAA,EAAQ,EAAA,OAAA,CAA6C,IAAI,EAEzD,GAAA,EAAQ,EAAA,YAAA,KAAwB,CAClC,AAEI,EAAM,WADN,aAAa,EAAM,OAAO,EACV,MAEpB,EAAU,EAAK,CACnB,EAAG,CAAC,CAAC,EAgCL,OA9BA,EAAA,EAAA,UAAA,SAAsB,EAAM,EAAG,CAAC,CAAK,CAAC,EA8B/B,CAAE,SAAQ,MAAA,EA5BJ,EAAA,YAAA,CACT,KAAO,IAAmC,CACtC,GAAI,CACA,GAAI,OAAO,UAAc,KAAe,UAAU,WAAW,UACzD,MAAM,UAAU,UAAU,UAAU,CAAI,OACrC,GAAI,OAAO,SAAa,IAAa,CACxC,IAAM,EAAW,SAAS,cAAc,UAAU,EAClD,EAAS,MAAQ,EACjB,EAAS,MAAM,SAAW,QAC1B,EAAS,MAAM,QAAU,IACzB,SAAS,KAAK,YAAY,CAAQ,EAClC,EAAS,OAAO,EAChB,SAAS,YAAY,MAAM,EAC3B,SAAS,KAAK,YAAY,CAAQ,CACtC,MACI,MAAO,GAKX,OAHA,EAAU,EAAI,EACV,EAAM,SAAS,aAAa,EAAM,OAAO,EAC7C,EAAM,QAAU,eAAiB,EAAU,EAAK,EAAG,CAAU,EACtD,EACX,MAAQ,CACJ,MAAO,EACX,CACJ,EACA,CAAC,CAAU,CAGE,EAAM,OAAM,CACjC"}
+{"version":3,"file":"use-clipboard.cjs","names":["useState","useRef","useCallback","react","useClipboard","options","copied","setCopied","timer","reset","text","textarea","resetAfter"],"sources":["../../src/hooks/use-clipboard.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport interface UseClipboardOptions {\n    /** Time (ms) before the `copied` flag resets back to false. Default: 1500. */\n    resetAfter?: number;\n}\n\nexport interface UseClipboardResult {\n    /** True briefly after a successful copy. */\n    copied: boolean;\n    /** Copy a string to the clipboard. Returns `true` on success. */\n    copy: (text: string) => Promise<boolean>;\n    /** Manually reset the `copied` flag. */\n    reset: () => void;\n}\n\n/**\n * Wrapper around `navigator.clipboard.writeText` with a transient `copied`\n * flag for UI feedback (\"Copied!\" toast). Falls back gracefully when the\n * Clipboard API is unavailable.\n */\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardResult {\n    const { resetAfter = 1500 } = options;\n    const [copied, setCopied] = useState<boolean>(false);\n    const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    const reset = useCallback((): void => {\n        if (timer.current) {\n            clearTimeout(timer.current);\n            timer.current = null;\n        }\n        setCopied(false);\n    }, []);\n\n    useEffect(() => () => reset(), [reset]);\n\n    const copy = useCallback(\n        async (text: string): Promise<boolean> => {\n            try {\n                if (typeof navigator !== \"undefined\" && navigator.clipboard?.writeText) {\n                    await navigator.clipboard.writeText(text);\n                } else if (typeof document !== \"undefined\") {\n                    const textarea = document.createElement(\"textarea\");\n                    textarea.value = text;\n                    textarea.style.position = \"fixed\";\n                    textarea.style.opacity = \"0\";\n                    document.body.appendChild(textarea);\n                    textarea.select();\n                    document.execCommand(\"copy\");\n                    document.body.removeChild(textarea);\n                } else {\n                    return false;\n                }\n                setCopied(true);\n                if (timer.current) clearTimeout(timer.current);\n                timer.current = setTimeout(() => setCopied(false), resetAfter);\n                return true;\n            } catch {\n                return false;\n            }\n        },\n        [resetAfter],\n    );\n\n    return { copied, copy, reset };\n}\n"],"mappings":"A,uBAqBA,SAAgBI,EAAa,EAA+B,CAAC,EAAuB,CAChF,GAAM,CAAE,aAAa,MAASC,EACxB,CAACC,EAAQC,IAAA,EAAaP,EAAAA,SAAAA,CAAkB,EAAK,EAC7CQ,GAAA,EAAQP,EAAAA,OAAAA,CAA6C,IAAI,EAEzDQ,GAAA,EAAQP,EAAAA,YAAAA,KAAwB,CAClC,AAEIM,EAAM,WADN,aAAaA,EAAM,OAAO,EACV,MAEpBD,EAAU,EAAK,CACnB,EAAG,CAAC,CAAC,EAgCL,OA9BA,EAAAJ,EAAA,UAAA,SAAsBM,EAAM,EAAG,CAACA,CAAK,CAAC,EA8B/B,CAAE,SAAQ,MAAA,EA5BJP,EAAAA,YAAAA,CACT,KAAO,IAAmC,CACtC,GAAI,CACA,GAAI,OAAO,UAAc,KAAe,UAAU,WAAW,UACzD,MAAM,UAAU,UAAU,UAAUQ,CAAI,OACrC,GAAI,OAAO,SAAa,IAAa,CACxC,IAAMC,EAAW,SAAS,cAAc,UAAU,EAClD,EAAS,MAAQD,EACjB,EAAS,MAAM,SAAW,QAC1B,EAAS,MAAM,QAAU,IACzB,SAAS,KAAK,YAAYC,CAAQ,EAClCA,EAAS,OAAO,EAChB,SAAS,YAAY,MAAM,EAC3B,SAAS,KAAK,YAAYA,CAAQ,CACtC,MACI,MAAO,GAKX,OAHAJ,EAAU,EAAI,EACVC,EAAM,SAAS,aAAaA,EAAM,OAAO,EAC7C,EAAM,QAAU,eAAiBD,EAAU,EAAK,EAAGK,CAAU,EACtD,EACX,MAAQ,CACJ,MAAO,EACX,CACJ,EACA,CAACA,CAAU,CAGE,EAAM,OAAM,CACjC,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-clipboard.js","names":[],"sources":["../../src/hooks/use-clipboard.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport interface UseClipboardOptions {\n    /** Time (ms) before the `copied` flag resets back to false. Default: 1500. */\n    resetAfter?: number;\n}\n\nexport interface UseClipboardResult {\n    /** True briefly after a successful copy. */\n    copied: boolean;\n    /** Copy a string to the clipboard. Returns `true` on success. */\n    copy: (text: string) => Promise<boolean>;\n    /** Manually reset the `copied` flag. */\n    reset: () => void;\n}\n\n/**\n * Wrapper around `navigator.clipboard.writeText` with a transient `copied`\n * flag for UI feedback (\"Copied!\" toast). Falls back gracefully when the\n * Clipboard API is unavailable.\n */\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardResult {\n    const { resetAfter = 1500 } = options;\n    const [copied, setCopied] = useState<boolean>(false);\n    const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    const reset = useCallback((): void => {\n        if (timer.current) {\n            clearTimeout(timer.current);\n            timer.current = null;\n        }\n        setCopied(false);\n    }, []);\n\n    useEffect(() => () => reset(), [reset]);\n\n    const copy = useCallback(\n        async (text: string): Promise<boolean> => {\n            try {\n                if (typeof navigator !== \"undefined\" && navigator.clipboard?.writeText) {\n                    await navigator.clipboard.writeText(text);\n                } else if (typeof document !== \"undefined\") {\n                    const textarea = document.createElement(\"textarea\");\n                    textarea.value = text;\n                    textarea.style.position = \"fixed\";\n                    textarea.style.opacity = \"0\";\n                    document.body.appendChild(textarea);\n                    textarea.select();\n                    document.execCommand(\"copy\");\n                    document.body.removeChild(textarea);\n                } else {\n                    return false;\n                }\n                setCopied(true);\n                if (timer.current) clearTimeout(timer.current);\n                timer.current = setTimeout(() => setCopied(false), resetAfter);\n                return true;\n            } catch {\n                return false;\n            }\n        },\n        [resetAfter],\n    );\n\n    return { copied, copy, reset };\n}\n"],"mappings":";;AAqBA,SAAgB,EAAa,IAA+B,CAAC,GAAuB;CAChF,IAAM,EAAE,gBAAa,SAAS,GACxB,CAAC,GAAQ,KAAa,EAAkB,EAAK,GAC7C,IAAQ,EAA6C,IAAI,GAEzD,IAAQ,QAAwB;EAKlC,AAJA,AAEI,EAAM,aADN,aAAa,EAAM,OAAO,GACV,OAEpB,EAAU,EAAK;CACnB,GAAG,CAAC,CAAC;CAgCL,OA9BA,cAAsB,EAAM,GAAG,CAAC,CAAK,CAAC,GA8B/B;EAAE;EAAQ,MA5BJ,EACT,OAAO,MAAmC;GACtC,IAAI;IACA,IAAI,OAAO,YAAc,OAAe,UAAU,WAAW,WACzD,MAAM,UAAU,UAAU,UAAU,CAAI;SACrC,IAAI,OAAO,WAAa,KAAa;KACxC,IAAM,IAAW,SAAS,cAAc,UAAU;KAOlD,AANA,EAAS,QAAQ,GACjB,EAAS,MAAM,WAAW,SAC1B,EAAS,MAAM,UAAU,KACzB,SAAS,KAAK,YAAY,CAAQ,GAClC,EAAS,OAAO,GAChB,SAAS,YAAY,MAAM,GAC3B,SAAS,KAAK,YAAY,CAAQ;IACtC,OACI,OAAO;IAKX,OAHA,EAAU,EAAI,GACV,EAAM,WAAS,aAAa,EAAM,OAAO,GAC7C,EAAM,UAAU,iBAAiB,EAAU,EAAK,GAAG,CAAU,GACtD;GACX,QAAQ;IACJ,OAAO;GACX;EACJ,GACA,CAAC,CAAU,CAGE;EAAM;CAAM;AACjC"}
+{"version":3,"file":"use-clipboard.js","names":["useClipboard","options","copied","setCopied","useState","timer","useRef","reset","useCallback","useEffect","text","textarea","resetAfter"],"sources":["../../src/hooks/use-clipboard.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport interface UseClipboardOptions {\n    /** Time (ms) before the `copied` flag resets back to false. Default: 1500. */\n    resetAfter?: number;\n}\n\nexport interface UseClipboardResult {\n    /** True briefly after a successful copy. */\n    copied: boolean;\n    /** Copy a string to the clipboard. Returns `true` on success. */\n    copy: (text: string) => Promise<boolean>;\n    /** Manually reset the `copied` flag. */\n    reset: () => void;\n}\n\n/**\n * Wrapper around `navigator.clipboard.writeText` with a transient `copied`\n * flag for UI feedback (\"Copied!\" toast). Falls back gracefully when the\n * Clipboard API is unavailable.\n */\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardResult {\n    const { resetAfter = 1500 } = options;\n    const [copied, setCopied] = useState<boolean>(false);\n    const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    const reset = useCallback((): void => {\n        if (timer.current) {\n            clearTimeout(timer.current);\n            timer.current = null;\n        }\n        setCopied(false);\n    }, []);\n\n    useEffect(() => () => reset(), [reset]);\n\n    const copy = useCallback(\n        async (text: string): Promise<boolean> => {\n            try {\n                if (typeof navigator !== \"undefined\" && navigator.clipboard?.writeText) {\n                    await navigator.clipboard.writeText(text);\n                } else if (typeof document !== \"undefined\") {\n                    const textarea = document.createElement(\"textarea\");\n                    textarea.value = text;\n                    textarea.style.position = \"fixed\";\n                    textarea.style.opacity = \"0\";\n                    document.body.appendChild(textarea);\n                    textarea.select();\n                    document.execCommand(\"copy\");\n                    document.body.removeChild(textarea);\n                } else {\n                    return false;\n                }\n                setCopied(true);\n                if (timer.current) clearTimeout(timer.current);\n                timer.current = setTimeout(() => setCopied(false), resetAfter);\n                return true;\n            } catch {\n                return false;\n            }\n        },\n        [resetAfter],\n    );\n\n    return { copied, copy, reset };\n}\n"],"mappings":";;AAqBA,SAAgBA,EAAa,IAA+B,CAAC,GAAuB;CAChF,IAAM,EAAE,gBAAa,SAASC,GACxB,CAACC,GAAQC,KAAaC,EAAkB,EAAK,GAC7CC,IAAQC,EAA6C,IAAI,GAEzDC,IAAQC,QAAwB;EAKlC,AAJA,AAEIH,EAAM,aADN,aAAaA,EAAM,OAAO,GACV,OAEpBF,EAAU,EAAK;CACnB,GAAG,CAAC,CAAC;CAgCL,OA9BAM,cAAsBF,EAAM,GAAG,CAACA,CAAK,CAAC,GA8B/B;EAAE;EAAQ,MA5BJC,EACT,OAAO,MAAmC;GACtC,IAAI;IACA,IAAI,OAAO,YAAc,OAAe,UAAU,WAAW,WACzD,MAAM,UAAU,UAAU,UAAUE,CAAI;SACrC,IAAI,OAAO,WAAa,KAAa;KACxC,IAAMC,IAAW,SAAS,cAAc,UAAU;KAOlD,AANA,EAAS,QAAQD,GACjB,EAAS,MAAM,WAAW,SAC1B,EAAS,MAAM,UAAU,KACzB,SAAS,KAAK,YAAYC,CAAQ,GAClCA,EAAS,OAAO,GAChB,SAAS,YAAY,MAAM,GAC3B,SAAS,KAAK,YAAYA,CAAQ;IACtC,OACI,OAAO;IAKX,OAHAR,EAAU,EAAI,GACVE,EAAM,WAAS,aAAaA,EAAM,OAAO,GAC7C,EAAM,UAAU,iBAAiBF,EAAU,EAAK,GAAGS,CAAU,GACtD;GACX,QAAQ;IACJ,OAAO;GACX;EACJ,GACA,CAACA,CAAU,CAGE;EAAM;CAAM;AACjC"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-countdown.cjs","names":[],"sources":["../../src/hooks/use-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** Options for {@link useCountdown}. */\nexport interface UseCountdownOptions {\n    /**\n     * How often the remaining time is recomputed, in ms. Default `1000`, which\n     * suits a \"try again in 3s\" label; drop it to ~50 to drive a progress bar.\n     */\n    tickMs?: number;\n}\n\n/**\n * Counts down the time left on a window that started at a known instant.\n *\n * Written around a timestamp rather than a decrementing counter on purpose: the\n * remaining time is recomputed from `Date.now()` on every tick, so a throttled\n * background tab, a slow frame or a `setInterval` that drifts cannot make the\n * countdown disagree with the clock. Remounting recovers the correct value too,\n * which a counter held in state cannot do.\n *\n * The interval stops once it reaches zero instead of ticking forever behind a\n * clamp — `useInterval` pauses on a `null` delay, so reaching zero is what tears\n * the timer down.\n *\n * @param durationMs - Length of the window.\n * @param startedAt - Epoch ms the window opened (`Date.now()` when it started).\n * @param options - Tick cadence.\n * @returns Milliseconds remaining, never below `0`.\n *\n * @example\n * const remaining = useCountdown(60_000, lastSentAt);\n *\n * <button disabled={remaining > 0}>\n *   {remaining > 0 ? `Reenviar em ${Math.ceil(remaining / 1000)}s` : \"Reenviar código\"}\n * </button>\n */\nexport function useCountdown(\n    durationMs: number,\n    startedAt: number,\n    options: UseCountdownOptions = {},\n): number {\n    const { tickMs = 1000 } = options;\n\n    const compute = useCallback(\n        () => Math.max(0, durationMs - (Date.now() - startedAt)),\n        [durationMs, startedAt],\n    );\n\n    const [remaining, setRemaining] = useState(compute);\n\n    useEffect(() => {\n        setRemaining(compute());\n    }, [compute]);\n\n    useInterval(() => setRemaining(compute()), remaining > 0 ? tickMs : null);\n\n    return remaining;\n}\n"],"mappings":"6DAqCA,SAAgB,EACZ,EACA,EACA,EAA+B,CAAC,EAC1B,CACN,GAAM,CAAE,SAAS,KAAS,EAEpB,GAAA,EAAU,EAAA,YAAA,KACN,KAAK,IAAI,EAAG,GAAc,KAAK,IAAI,EAAI,EAAU,EACvD,CAAC,EAAY,CAAS,CAC1B,EAEM,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAS,CAAO,EAQlD,OANA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAa,EAAQ,CAAC,CAC1B,EAAG,CAAC,CAAO,CAAC,EAEZ,EAAA,gBAAkB,EAAa,EAAQ,CAAC,EAAG,EAAY,EAAI,EAAS,IAAI,EAEjE,CACX"}
+{"version":3,"file":"use-countdown.cjs","names":["useCallback","useState","require_use_interval","react","useCountdown","options","compute","durationMs","startedAt","remaining","setRemaining","tickMs"],"sources":["../../src/hooks/use-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** Options for {@link useCountdown}. */\nexport interface UseCountdownOptions {\n    /**\n     * How often the remaining time is recomputed, in ms. Default `1000`, which\n     * suits a \"try again in 3s\" label; drop it to ~50 to drive a progress bar.\n     */\n    tickMs?: number;\n}\n\n/**\n * Counts down the time left on a window that started at a known instant.\n *\n * Written around a timestamp rather than a decrementing counter on purpose: the\n * remaining time is recomputed from `Date.now()` on every tick, so a throttled\n * background tab, a slow frame or a `setInterval` that drifts cannot make the\n * countdown disagree with the clock. Remounting recovers the correct value too,\n * which a counter held in state cannot do.\n *\n * The interval stops once it reaches zero instead of ticking forever behind a\n * clamp — `useInterval` pauses on a `null` delay, so reaching zero is what tears\n * the timer down.\n *\n * @param durationMs - Length of the window.\n * @param startedAt - Epoch ms the window opened (`Date.now()` when it started).\n * @param options - Tick cadence.\n * @returns Milliseconds remaining, never below `0`.\n *\n * @example\n * const remaining = useCountdown(60_000, lastSentAt);\n *\n * <button disabled={remaining > 0}>\n *   {remaining > 0 ? `Reenviar em ${Math.ceil(remaining / 1000)}s` : \"Reenviar código\"}\n * </button>\n */\nexport function useCountdown(\n    durationMs: number,\n    startedAt: number,\n    options: UseCountdownOptions = {},\n): number {\n    const { tickMs = 1000 } = options;\n\n    const compute = useCallback(\n        () => Math.max(0, durationMs - (Date.now() - startedAt)),\n        [durationMs, startedAt],\n    );\n\n    const [remaining, setRemaining] = useState(compute);\n\n    useEffect(() => {\n        setRemaining(compute());\n    }, [compute]);\n\n    useInterval(() => setRemaining(compute()), remaining > 0 ? tickMs : null);\n\n    return remaining;\n}\n"],"mappings":"A,6DAqCA,SAAgBI,EACZ,EACA,EACA,EAA+B,CAAC,EAC1B,CACN,GAAM,CAAE,SAAS,KAASC,EAEpBC,GAAA,EAAUN,EAAAA,YAAAA,KACN,KAAK,IAAI,EAAGO,GAAc,KAAK,IAAI,EAAIC,EAAU,EACvD,CAACD,EAAYC,CAAS,CAC1B,EAEM,CAACC,EAAWC,IAAA,EAAgBT,EAAAA,SAAAA,CAASK,CAAO,EAQlD,OANA,EAAAH,EAAA,UAAA,KAAgB,CACZO,EAAaJ,EAAQ,CAAC,CAC1B,EAAG,CAACA,CAAO,CAAC,EAEZJ,EAAA,gBAAkBQ,EAAaJ,EAAQ,CAAC,EAAGG,EAAY,EAAIE,EAAS,IAAI,EAEjEF,CACX,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-countdown.js","names":[],"sources":["../../src/hooks/use-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** Options for {@link useCountdown}. */\nexport interface UseCountdownOptions {\n    /**\n     * How often the remaining time is recomputed, in ms. Default `1000`, which\n     * suits a \"try again in 3s\" label; drop it to ~50 to drive a progress bar.\n     */\n    tickMs?: number;\n}\n\n/**\n * Counts down the time left on a window that started at a known instant.\n *\n * Written around a timestamp rather than a decrementing counter on purpose: the\n * remaining time is recomputed from `Date.now()` on every tick, so a throttled\n * background tab, a slow frame or a `setInterval` that drifts cannot make the\n * countdown disagree with the clock. Remounting recovers the correct value too,\n * which a counter held in state cannot do.\n *\n * The interval stops once it reaches zero instead of ticking forever behind a\n * clamp — `useInterval` pauses on a `null` delay, so reaching zero is what tears\n * the timer down.\n *\n * @param durationMs - Length of the window.\n * @param startedAt - Epoch ms the window opened (`Date.now()` when it started).\n * @param options - Tick cadence.\n * @returns Milliseconds remaining, never below `0`.\n *\n * @example\n * const remaining = useCountdown(60_000, lastSentAt);\n *\n * <button disabled={remaining > 0}>\n *   {remaining > 0 ? `Reenviar em ${Math.ceil(remaining / 1000)}s` : \"Reenviar código\"}\n * </button>\n */\nexport function useCountdown(\n    durationMs: number,\n    startedAt: number,\n    options: UseCountdownOptions = {},\n): number {\n    const { tickMs = 1000 } = options;\n\n    const compute = useCallback(\n        () => Math.max(0, durationMs - (Date.now() - startedAt)),\n        [durationMs, startedAt],\n    );\n\n    const [remaining, setRemaining] = useState(compute);\n\n    useEffect(() => {\n        setRemaining(compute());\n    }, [compute]);\n\n    useInterval(() => setRemaining(compute()), remaining > 0 ? tickMs : null);\n\n    return remaining;\n}\n"],"mappings":";;;AAqCA,SAAgB,EACZ,GACA,GACA,IAA+B,CAAC,GAC1B;CACN,IAAM,EAAE,YAAS,QAAS,GAEpB,IAAU,QACN,KAAK,IAAI,GAAG,KAAc,KAAK,IAAI,IAAI,EAAU,GACvD,CAAC,GAAY,CAAS,CAC1B,GAEM,CAAC,GAAW,KAAgB,EAAS,CAAO;CAQlD,OANA,QAAgB;EACZ,EAAa,EAAQ,CAAC;CAC1B,GAAG,CAAC,CAAO,CAAC,GAEZ,QAAkB,EAAa,EAAQ,CAAC,GAAG,IAAY,IAAI,IAAS,IAAI,GAEjE;AACX"}
+{"version":3,"file":"use-countdown.js","names":["useCountdown","options","compute","useCallback","durationMs","startedAt","remaining","setRemaining","useState","useEffect","useInterval","tickMs"],"sources":["../../src/hooks/use-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** Options for {@link useCountdown}. */\nexport interface UseCountdownOptions {\n    /**\n     * How often the remaining time is recomputed, in ms. Default `1000`, which\n     * suits a \"try again in 3s\" label; drop it to ~50 to drive a progress bar.\n     */\n    tickMs?: number;\n}\n\n/**\n * Counts down the time left on a window that started at a known instant.\n *\n * Written around a timestamp rather than a decrementing counter on purpose: the\n * remaining time is recomputed from `Date.now()` on every tick, so a throttled\n * background tab, a slow frame or a `setInterval` that drifts cannot make the\n * countdown disagree with the clock. Remounting recovers the correct value too,\n * which a counter held in state cannot do.\n *\n * The interval stops once it reaches zero instead of ticking forever behind a\n * clamp — `useInterval` pauses on a `null` delay, so reaching zero is what tears\n * the timer down.\n *\n * @param durationMs - Length of the window.\n * @param startedAt - Epoch ms the window opened (`Date.now()` when it started).\n * @param options - Tick cadence.\n * @returns Milliseconds remaining, never below `0`.\n *\n * @example\n * const remaining = useCountdown(60_000, lastSentAt);\n *\n * <button disabled={remaining > 0}>\n *   {remaining > 0 ? `Reenviar em ${Math.ceil(remaining / 1000)}s` : \"Reenviar código\"}\n * </button>\n */\nexport function useCountdown(\n    durationMs: number,\n    startedAt: number,\n    options: UseCountdownOptions = {},\n): number {\n    const { tickMs = 1000 } = options;\n\n    const compute = useCallback(\n        () => Math.max(0, durationMs - (Date.now() - startedAt)),\n        [durationMs, startedAt],\n    );\n\n    const [remaining, setRemaining] = useState(compute);\n\n    useEffect(() => {\n        setRemaining(compute());\n    }, [compute]);\n\n    useInterval(() => setRemaining(compute()), remaining > 0 ? tickMs : null);\n\n    return remaining;\n}\n"],"mappings":";;;AAqCA,SAAgBA,EACZ,GACA,GACA,IAA+B,CAAC,GAC1B;CACN,IAAM,EAAE,YAAS,QAASC,GAEpBC,IAAUC,QACN,KAAK,IAAI,GAAGC,KAAc,KAAK,IAAI,IAAIC,EAAU,GACvD,CAACD,GAAYC,CAAS,CAC1B,GAEM,CAACC,GAAWC,KAAgBC,EAASN,CAAO;CAQlD,OANAO,QAAgB;EACZ,EAAaP,EAAQ,CAAC;CAC1B,GAAG,CAACA,CAAO,CAAC,GAEZQ,QAAkBH,EAAaL,EAAQ,CAAC,GAAGI,IAAY,IAAIK,IAAS,IAAI,GAEjEL;AACX"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-counter.cjs","names":[],"sources":["../../src/hooks/use-counter.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\n\nexport interface UseCounterOptions {\n    min?: number;\n    max?: number;\n}\n\nexport interface CounterHandlers {\n    increment: () => void;\n    decrement: () => void;\n    set: (value: number) => void;\n    reset: () => void;\n}\n\nconst clamp = (value: number, min: number | undefined, max: number | undefined): number => {\n    let next = value;\n    if (typeof min === \"number\") next = Math.max(min, next);\n    if (typeof max === \"number\") next = Math.min(max, next);\n    return next;\n};\n\n/**\n * Numeric counter clamped to an optional `[min, max]` range.\n *\n * @param initial - initial value (default `0`), clamped to the range.\n * @param options - optional `min` / `max` bounds.\n * @returns Tuple `[count, { increment, decrement, set, reset }]`.\n */\nexport function useCounter(\n    initial = 0,\n    options: UseCounterOptions = {},\n): [number, CounterHandlers] {\n    const { min, max } = options;\n    const [count, setCount] = useState<number>(() => clamp(initial, min, max));\n\n    const increment = useCallback((): void => {\n        setCount((current) => clamp(current + 1, min, max));\n    }, [min, max]);\n\n    const decrement = useCallback((): void => {\n        setCount((current) => clamp(current - 1, min, max));\n    }, [min, max]);\n\n    const set = useCallback(\n        (value: number): void => {\n            setCount(clamp(value, min, max));\n        },\n        [min, max],\n    );\n\n    const reset = useCallback((): void => {\n        setCount(clamp(initial, min, max));\n    }, [initial, min, max]);\n\n    const handlers = useMemo<CounterHandlers>(\n        () => ({ increment, decrement, set, reset }),\n        [increment, decrement, set, reset],\n    );\n\n    return [count, handlers];\n}\n"],"mappings":"uBAcA,IAAM,GAAS,EAAe,EAAyB,IAAoC,CACvF,IAAI,EAAO,EAGX,OAFI,OAAO,GAAQ,WAAU,EAAO,KAAK,IAAI,EAAK,CAAI,GAClD,OAAO,GAAQ,WAAU,EAAO,KAAK,IAAI,EAAK,CAAI,GAC/C,CACX,EASA,SAAgB,EACZ,EAAU,EACV,EAA6B,CAAC,EACL,CACzB,GAAM,CAAE,MAAK,OAAQ,EACf,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,KAAuB,EAAM,EAAS,EAAK,CAAG,CAAC,EAEnE,GAAA,EAAY,EAAA,YAAA,KAAwB,CACtC,EAAU,GAAY,EAAM,EAAU,EAAG,EAAK,CAAG,CAAC,CACtD,EAAG,CAAC,EAAK,CAAG,CAAC,EAEP,GAAA,EAAY,EAAA,YAAA,KAAwB,CACtC,EAAU,GAAY,EAAM,EAAU,EAAG,EAAK,CAAG,CAAC,CACtD,EAAG,CAAC,EAAK,CAAG,CAAC,EAEP,GAAA,EAAM,EAAA,YAAA,CACP,GAAwB,CACrB,EAAS,EAAM,EAAO,EAAK,CAAG,CAAC,CACnC,EACA,CAAC,EAAK,CAAG,CACb,EAEM,GAAA,EAAQ,EAAA,YAAA,KAAwB,CAClC,EAAS,EAAM,EAAS,EAAK,CAAG,CAAC,CACrC,EAAG,CAAC,EAAS,EAAK,CAAG,CAAC,EAOtB,MAAO,CAAC,GAAA,EALS,EAAA,QAAA,MACN,CAAE,YAAW,YAAW,MAAK,OAAM,GAC1C,CAAC,EAAW,EAAW,EAAK,CAAK,CAGtB,CAAQ,CAC3B"}
+{"version":3,"file":"use-counter.cjs","names":["useState","useCallback","useMemo","react","clamp","next","value","min","max","useCounter","options","count","setCount","initial","increment","current","decrement","set","reset"],"sources":["../../src/hooks/use-counter.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\n\nexport interface UseCounterOptions {\n    min?: number;\n    max?: number;\n}\n\nexport interface CounterHandlers {\n    increment: () => void;\n    decrement: () => void;\n    set: (value: number) => void;\n    reset: () => void;\n}\n\nconst clamp = (value: number, min: number | undefined, max: number | undefined): number => {\n    let next = value;\n    if (typeof min === \"number\") next = Math.max(min, next);\n    if (typeof max === \"number\") next = Math.min(max, next);\n    return next;\n};\n\n/**\n * Numeric counter clamped to an optional `[min, max]` range.\n *\n * @param initial - initial value (default `0`), clamped to the range.\n * @param options - optional `min` / `max` bounds.\n * @returns Tuple `[count, { increment, decrement, set, reset }]`.\n */\nexport function useCounter(\n    initial = 0,\n    options: UseCounterOptions = {},\n): [number, CounterHandlers] {\n    const { min, max } = options;\n    const [count, setCount] = useState<number>(() => clamp(initial, min, max));\n\n    const increment = useCallback((): void => {\n        setCount((current) => clamp(current + 1, min, max));\n    }, [min, max]);\n\n    const decrement = useCallback((): void => {\n        setCount((current) => clamp(current - 1, min, max));\n    }, [min, max]);\n\n    const set = useCallback(\n        (value: number): void => {\n            setCount(clamp(value, min, max));\n        },\n        [min, max],\n    );\n\n    const reset = useCallback((): void => {\n        setCount(clamp(initial, min, max));\n    }, [initial, min, max]);\n\n    const handlers = useMemo<CounterHandlers>(\n        () => ({ increment, decrement, set, reset }),\n        [increment, decrement, set, reset],\n    );\n\n    return [count, handlers];\n}\n"],"mappings":"A,uBAcA,IAAMI,GAAS,EAAe,EAAyB,IAAoC,CACvF,IAAIC,EAAOC,EAGX,OAFI,OAAOC,GAAQ,WAAU,EAAO,KAAK,IAAIA,EAAKF,CAAI,GAClD,OAAOG,GAAQ,WAAU,EAAO,KAAK,IAAIA,EAAKH,CAAI,GAC/CA,CACX,EASA,SAAgBI,EACZ,EAAU,EACV,EAA6B,CAAC,EACL,CACzB,GAAM,CAAE,MAAK,OAAQC,EACf,CAACC,EAAOC,IAAA,EAAYZ,EAAAA,SAAAA,KAAuBI,EAAMS,EAASN,EAAKC,CAAG,CAAC,EAEnEM,GAAA,EAAYb,EAAAA,YAAAA,KAAwB,CACtCW,EAAU,GAAYR,EAAMW,EAAU,EAAGR,EAAKC,CAAG,CAAC,CACtD,EAAG,CAACD,EAAKC,CAAG,CAAC,EAEPQ,GAAA,EAAYf,EAAAA,YAAAA,KAAwB,CACtCW,EAAU,GAAYR,EAAMW,EAAU,EAAGR,EAAKC,CAAG,CAAC,CACtD,EAAG,CAACD,EAAKC,CAAG,CAAC,EAEPS,GAAA,EAAMhB,EAAAA,YAAAA,CACP,GAAwB,CACrBW,EAASR,EAAME,EAAOC,EAAKC,CAAG,CAAC,CACnC,EACA,CAACD,EAAKC,CAAG,CACb,EAEMU,GAAA,EAAQjB,EAAAA,YAAAA,KAAwB,CAClCW,EAASR,EAAMS,EAASN,EAAKC,CAAG,CAAC,CACrC,EAAG,CAACK,EAASN,EAAKC,CAAG,CAAC,EAOtB,MAAO,CAACG,GAAA,EALST,EAAAA,QAAAA,MACN,CAAE,YAAW,YAAW,MAAK,OAAM,GAC1C,CAACY,EAAWE,EAAWC,EAAKC,CAAK,CAGtB,CAAQ,CAC3B,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-counter.js","names":[],"sources":["../../src/hooks/use-counter.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\n\nexport interface UseCounterOptions {\n    min?: number;\n    max?: number;\n}\n\nexport interface CounterHandlers {\n    increment: () => void;\n    decrement: () => void;\n    set: (value: number) => void;\n    reset: () => void;\n}\n\nconst clamp = (value: number, min: number | undefined, max: number | undefined): number => {\n    let next = value;\n    if (typeof min === \"number\") next = Math.max(min, next);\n    if (typeof max === \"number\") next = Math.min(max, next);\n    return next;\n};\n\n/**\n * Numeric counter clamped to an optional `[min, max]` range.\n *\n * @param initial - initial value (default `0`), clamped to the range.\n * @param options - optional `min` / `max` bounds.\n * @returns Tuple `[count, { increment, decrement, set, reset }]`.\n */\nexport function useCounter(\n    initial = 0,\n    options: UseCounterOptions = {},\n): [number, CounterHandlers] {\n    const { min, max } = options;\n    const [count, setCount] = useState<number>(() => clamp(initial, min, max));\n\n    const increment = useCallback((): void => {\n        setCount((current) => clamp(current + 1, min, max));\n    }, [min, max]);\n\n    const decrement = useCallback((): void => {\n        setCount((current) => clamp(current - 1, min, max));\n    }, [min, max]);\n\n    const set = useCallback(\n        (value: number): void => {\n            setCount(clamp(value, min, max));\n        },\n        [min, max],\n    );\n\n    const reset = useCallback((): void => {\n        setCount(clamp(initial, min, max));\n    }, [initial, min, max]);\n\n    const handlers = useMemo<CounterHandlers>(\n        () => ({ increment, decrement, set, reset }),\n        [increment, decrement, set, reset],\n    );\n\n    return [count, handlers];\n}\n"],"mappings":";;AAcA,IAAM,KAAS,GAAe,GAAyB,MAAoC;CACvF,IAAI,IAAO;CAGX,OAFI,OAAO,KAAQ,aAAU,IAAO,KAAK,IAAI,GAAK,CAAI,IAClD,OAAO,KAAQ,aAAU,IAAO,KAAK,IAAI,GAAK,CAAI,IAC/C;AACX;AASA,SAAgB,EACZ,IAAU,GACV,IAA6B,CAAC,GACL;CACzB,IAAM,EAAE,QAAK,WAAQ,GACf,CAAC,GAAO,KAAY,QAAuB,EAAM,GAAS,GAAK,CAAG,CAAC,GAEnE,IAAY,QAAwB;EACtC,GAAU,MAAY,EAAM,IAAU,GAAG,GAAK,CAAG,CAAC;CACtD,GAAG,CAAC,GAAK,CAAG,CAAC,GAEP,IAAY,QAAwB;EACtC,GAAU,MAAY,EAAM,IAAU,GAAG,GAAK,CAAG,CAAC;CACtD,GAAG,CAAC,GAAK,CAAG,CAAC,GAEP,IAAM,GACP,MAAwB;EACrB,EAAS,EAAM,GAAO,GAAK,CAAG,CAAC;CACnC,GACA,CAAC,GAAK,CAAG,CACb,GAEM,IAAQ,QAAwB;EAClC,EAAS,EAAM,GAAS,GAAK,CAAG,CAAC;CACrC,GAAG;EAAC;EAAS;EAAK;CAAG,CAAC;CAOtB,OAAO,CAAC,GALS,SACN;EAAE;EAAW;EAAW;EAAK;CAAM,IAC1C;EAAC;EAAW;EAAW;EAAK;CAAK,CAGtB,CAAQ;AAC3B"}
+{"version":3,"file":"use-counter.js","names":["clamp","next","value","min","max","useCounter","options","count","setCount","useState","initial","increment","useCallback","current","decrement","set","reset","useMemo"],"sources":["../../src/hooks/use-counter.ts"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\n\nexport interface UseCounterOptions {\n    min?: number;\n    max?: number;\n}\n\nexport interface CounterHandlers {\n    increment: () => void;\n    decrement: () => void;\n    set: (value: number) => void;\n    reset: () => void;\n}\n\nconst clamp = (value: number, min: number | undefined, max: number | undefined): number => {\n    let next = value;\n    if (typeof min === \"number\") next = Math.max(min, next);\n    if (typeof max === \"number\") next = Math.min(max, next);\n    return next;\n};\n\n/**\n * Numeric counter clamped to an optional `[min, max]` range.\n *\n * @param initial - initial value (default `0`), clamped to the range.\n * @param options - optional `min` / `max` bounds.\n * @returns Tuple `[count, { increment, decrement, set, reset }]`.\n */\nexport function useCounter(\n    initial = 0,\n    options: UseCounterOptions = {},\n): [number, CounterHandlers] {\n    const { min, max } = options;\n    const [count, setCount] = useState<number>(() => clamp(initial, min, max));\n\n    const increment = useCallback((): void => {\n        setCount((current) => clamp(current + 1, min, max));\n    }, [min, max]);\n\n    const decrement = useCallback((): void => {\n        setCount((current) => clamp(current - 1, min, max));\n    }, [min, max]);\n\n    const set = useCallback(\n        (value: number): void => {\n            setCount(clamp(value, min, max));\n        },\n        [min, max],\n    );\n\n    const reset = useCallback((): void => {\n        setCount(clamp(initial, min, max));\n    }, [initial, min, max]);\n\n    const handlers = useMemo<CounterHandlers>(\n        () => ({ increment, decrement, set, reset }),\n        [increment, decrement, set, reset],\n    );\n\n    return [count, handlers];\n}\n"],"mappings":";;AAcA,IAAMA,KAAS,GAAe,GAAyB,MAAoC;CACvF,IAAIC,IAAOC;CAGX,OAFI,OAAOC,KAAQ,aAAU,IAAO,KAAK,IAAIA,GAAKF,CAAI,IAClD,OAAOG,KAAQ,aAAU,IAAO,KAAK,IAAIA,GAAKH,CAAI,IAC/CA;AACX;AASA,SAAgBI,EACZ,IAAU,GACV,IAA6B,CAAC,GACL;CACzB,IAAM,EAAE,QAAK,WAAQC,GACf,CAACC,GAAOC,KAAYC,QAAuBT,EAAMU,GAASP,GAAKC,CAAG,CAAC,GAEnEO,IAAYC,QAAwB;EACtC,GAAU,MAAYZ,EAAMa,IAAU,GAAGV,GAAKC,CAAG,CAAC;CACtD,GAAG,CAACD,GAAKC,CAAG,CAAC,GAEPU,IAAYF,QAAwB;EACtC,GAAU,MAAYZ,EAAMa,IAAU,GAAGV,GAAKC,CAAG,CAAC;CACtD,GAAG,CAACD,GAAKC,CAAG,CAAC,GAEPW,IAAMH,GACP,MAAwB;EACrB,EAASZ,EAAME,GAAOC,GAAKC,CAAG,CAAC;CACnC,GACA,CAACD,GAAKC,CAAG,CACb,GAEMY,IAAQJ,QAAwB;EAClC,EAASZ,EAAMU,GAASP,GAAKC,CAAG,CAAC;CACrC,GAAG;EAACM;EAASP;EAAKC;CAAG,CAAC;CAOtB,OAAO,CAACG,GALSU,SACN;EAAE;EAAW;EAAW;EAAK;CAAM,IAC1C;EAACN;EAAWG;EAAWC;EAAKC;CAAK,CAGtB,CAAQ;AAC3B"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-debounce.cjs","names":[],"sources":["../../src/hooks/use-debounce.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Debounce a fast-changing value. Returns the latest value once `delay` ms\n * have elapsed without further changes.\n *\n * @param value - The value to debounce.\n * @param delay - Delay in milliseconds (default 300).\n * @returns The debounced value.\n */\nexport function useDebounce<T>(value: T, delay = 300): T {\n    const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n    useEffect(() => {\n        const timer = setTimeout(() => setDebouncedValue(value), delay);\n        return () => clearTimeout(timer);\n    }, [value, delay]);\n\n    return debouncedValue;\n}\n"],"mappings":"uBAUA,SAAgB,EAAe,EAAU,EAAQ,IAAQ,CACrD,GAAM,CAAC,EAAgB,IAAA,EAAqB,EAAA,SAAA,CAAY,CAAK,EAO7D,OALA,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAQ,eAAiB,EAAkB,CAAK,EAAG,CAAK,EAC9D,UAAa,aAAa,CAAK,CACnC,EAAG,CAAC,EAAO,CAAK,CAAC,EAEV,CACX"}
+{"version":3,"file":"use-debounce.cjs","names":["useState","react","useDebounce","debouncedValue","setDebouncedValue","value","timer","delay"],"sources":["../../src/hooks/use-debounce.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Debounce a fast-changing value. Returns the latest value once `delay` ms\n * have elapsed without further changes.\n *\n * @param value - The value to debounce.\n * @param delay - Delay in milliseconds (default 300).\n * @returns The debounced value.\n */\nexport function useDebounce<T>(value: T, delay = 300): T {\n    const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n    useEffect(() => {\n        const timer = setTimeout(() => setDebouncedValue(value), delay);\n        return () => clearTimeout(timer);\n    }, [value, delay]);\n\n    return debouncedValue;\n}\n"],"mappings":"A,uBAUA,SAAgBE,EAAe,EAAU,EAAQ,IAAQ,CACrD,GAAM,CAACC,EAAgBC,IAAA,EAAqBJ,EAAAA,SAAAA,CAAYK,CAAK,EAO7D,OALA,EAAAJ,EAAA,UAAA,KAAgB,CACZ,IAAMK,EAAQ,eAAiBF,EAAkBC,CAAK,EAAGE,CAAK,EAC9D,UAAa,aAAaD,CAAK,CACnC,EAAG,CAACD,EAAOE,CAAK,CAAC,EAEVJ,CACX,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-debounce.js","names":[],"sources":["../../src/hooks/use-debounce.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Debounce a fast-changing value. Returns the latest value once `delay` ms\n * have elapsed without further changes.\n *\n * @param value - The value to debounce.\n * @param delay - Delay in milliseconds (default 300).\n * @returns The debounced value.\n */\nexport function useDebounce<T>(value: T, delay = 300): T {\n    const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n    useEffect(() => {\n        const timer = setTimeout(() => setDebouncedValue(value), delay);\n        return () => clearTimeout(timer);\n    }, [value, delay]);\n\n    return debouncedValue;\n}\n"],"mappings":";;AAUA,SAAgB,EAAe,GAAU,IAAQ,KAAQ;CACrD,IAAM,CAAC,GAAgB,KAAqB,EAAY,CAAK;CAO7D,OALA,QAAgB;EACZ,IAAM,IAAQ,iBAAiB,EAAkB,CAAK,GAAG,CAAK;EAC9D,aAAa,aAAa,CAAK;CACnC,GAAG,CAAC,GAAO,CAAK,CAAC,GAEV;AACX"}
+{"version":3,"file":"use-debounce.js","names":["useDebounce","debouncedValue","setDebouncedValue","useState","value","useEffect","timer","delay"],"sources":["../../src/hooks/use-debounce.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Debounce a fast-changing value. Returns the latest value once `delay` ms\n * have elapsed without further changes.\n *\n * @param value - The value to debounce.\n * @param delay - Delay in milliseconds (default 300).\n * @returns The debounced value.\n */\nexport function useDebounce<T>(value: T, delay = 300): T {\n    const [debouncedValue, setDebouncedValue] = useState<T>(value);\n\n    useEffect(() => {\n        const timer = setTimeout(() => setDebouncedValue(value), delay);\n        return () => clearTimeout(timer);\n    }, [value, delay]);\n\n    return debouncedValue;\n}\n"],"mappings":";;AAUA,SAAgBA,EAAe,GAAU,IAAQ,KAAQ;CACrD,IAAM,CAACC,GAAgBC,KAAqBC,EAAYC,CAAK;CAO7D,OALAC,QAAgB;EACZ,IAAMC,IAAQ,iBAAiBJ,EAAkBE,CAAK,GAAGG,CAAK;EAC9D,aAAa,aAAaD,CAAK;CACnC,GAAG,CAACF,GAAOG,CAAK,CAAC,GAEVN;AACX"}

package/dist/hooks/use-deep-memo.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-deep-memo.cjs","names":[],"sources":["../../src/hooks/use-deep-memo.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- the structural cache is read and written during render by design (see the docstring) */\nimport { useRef } from \"react\";\n\n/**\n * Structural equality over plain objects and arrays, the comparison `useDeepMemo`\n * and `useDraftFilters` share. Internal: not re-exported from the barrel.\n *\n * @param a - First value.\n * @param b - Second value.\n * @returns Whether both values have the same shape and leaves.\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) return false;\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) return false;\n        return a.every((value, index) => deepEqual(value, b[index]));\n    }\n    const aKeys = Object.keys(a as object);\n    const bKeys = Object.keys(b as object);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every((key) =>\n        deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n    );\n}\n\n/**\n * Memoize a value with a structural equality check. Use when an object/array\n * created during render is fed to `useEffect` dependencies and you want to\n * avoid spurious effect runs when only the reference changes.\n *\n * The cache is a ref read and written during render. That is flagged by the React\n * Compiler rules and is nonetheless correct here: the write is idempotent — a\n * discarded render either wrote a structurally equal value or nothing at all — so\n * replaying the render cannot change the result.\n */\nexport function useDeepMemo<T>(value: T): T {\n    const ref = useRef<T>(value);\n    if (!deepEqual(ref.current, value)) {\n        ref.current = value;\n    }\n    return ref.current;\n}\n"],"mappings":"uBAWA,SAAgB,EAAU,EAAY,EAAqB,CACvD,GAAI,OAAO,GAAG,EAAG,CAAC,EAAG,MAAO,GAE5B,GADI,OAAO,GAAM,UAAY,OAAO,GAAM,UAAY,IAAM,MAAQ,IAAM,MACtE,MAAM,QAAQ,CAAC,IAAM,MAAM,QAAQ,CAAC,EAAG,MAAO,GAClD,GAAI,MAAM,QAAQ,CAAC,GAAK,MAAM,QAAQ,CAAC,EAEnC,OADI,EAAE,SAAW,EAAE,QACZ,EAAE,OAAO,EAAO,IAAU,EAAU,EAAO,EAAE,EAAM,CAAC,EAE/D,IAAM,EAAQ,OAAO,KAAK,CAAW,EAC/B,EAAQ,OAAO,KAAK,CAAW,EAErC,OADI,EAAM,SAAW,EAAM,QACpB,EAAM,MAAO,GAChB,EAAW,EAA8B,GAAO,EAA8B,EAAI,CACtF,CACJ,CAYA,SAAgB,EAAe,EAAa,CACxC,IAAM,GAAA,EAAM,EAAA,OAAA,CAAU,CAAK,EAI3B,OAHK,EAAU,EAAI,QAAS,CAAK,IAC7B,EAAI,QAAU,GAEX,EAAI,OACf"}
+{"version":3,"file":"use-deep-memo.cjs","names":["useRef","react","deepEqual","a","b","value","index","aKeys","bKeys","key","useDeepMemo","ref"],"sources":["../../src/hooks/use-deep-memo.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- the structural cache is read and written during render by design (see the docstring) */\nimport { useRef } from \"react\";\n\n/**\n * Structural equality over plain objects and arrays, the comparison `useDeepMemo`\n * and `useDraftFilters` share. Internal: not re-exported from the barrel.\n *\n * @param a - First value.\n * @param b - Second value.\n * @returns Whether both values have the same shape and leaves.\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) return false;\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) return false;\n        return a.every((value, index) => deepEqual(value, b[index]));\n    }\n    const aKeys = Object.keys(a as object);\n    const bKeys = Object.keys(b as object);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every((key) =>\n        deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n    );\n}\n\n/**\n * Memoize a value with a structural equality check. Use when an object/array\n * created during render is fed to `useEffect` dependencies and you want to\n * avoid spurious effect runs when only the reference changes.\n *\n * The cache is a ref read and written during render. That is flagged by the React\n * Compiler rules and is nonetheless correct here: the write is idempotent — a\n * discarded render either wrote a structurally equal value or nothing at all — so\n * replaying the render cannot change the result.\n */\nexport function useDeepMemo<T>(value: T): T {\n    const ref = useRef<T>(value);\n    if (!deepEqual(ref.current, value)) {\n        ref.current = value;\n    }\n    return ref.current;\n}\n"],"mappings":"A,uBAWA,SAAgBE,EAAU,EAAY,EAAqB,CACvD,GAAI,OAAO,GAAGC,EAAGC,CAAC,EAAG,MAAO,GAE5B,GADI,OAAOD,GAAM,UAAY,OAAOC,GAAM,UAAYD,IAAM,MAAQC,IAAM,MACtE,MAAM,QAAQD,CAAC,IAAM,MAAM,QAAQC,CAAC,EAAG,MAAO,GAClD,GAAI,MAAM,QAAQD,CAAC,GAAK,MAAM,QAAQC,CAAC,EAEnC,OADID,EAAE,SAAWC,EAAE,QACZD,EAAE,OAAO,EAAO,IAAUD,EAAUG,EAAOD,EAAEE,EAAM,CAAC,EAE/D,IAAMC,EAAQ,OAAO,KAAKJ,CAAW,EAC/BK,EAAQ,OAAO,KAAKJ,CAAW,EAErC,OADIG,EAAM,SAAWC,EAAM,QACpBD,EAAM,MAAO,GAChBL,EAAWC,EAA8BM,GAAOL,EAA8BK,EAAI,CACtF,CACJ,CAYA,SAAgBC,EAAe,EAAa,CACxC,IAAMC,GAAA,EAAMX,EAAAA,OAAAA,CAAUK,CAAK,EAI3B,OAHKH,EAAUS,EAAI,QAASN,CAAK,IAC7B,EAAI,QAAUA,GAEXM,EAAI,OACf,C"}

package/dist/hooks/use-deep-memo.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-deep-memo.js","names":[],"sources":["../../src/hooks/use-deep-memo.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- the structural cache is read and written during render by design (see the docstring) */\nimport { useRef } from \"react\";\n\n/**\n * Structural equality over plain objects and arrays, the comparison `useDeepMemo`\n * and `useDraftFilters` share. Internal: not re-exported from the barrel.\n *\n * @param a - First value.\n * @param b - Second value.\n * @returns Whether both values have the same shape and leaves.\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) return false;\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) return false;\n        return a.every((value, index) => deepEqual(value, b[index]));\n    }\n    const aKeys = Object.keys(a as object);\n    const bKeys = Object.keys(b as object);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every((key) =>\n        deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n    );\n}\n\n/**\n * Memoize a value with a structural equality check. Use when an object/array\n * created during render is fed to `useEffect` dependencies and you want to\n * avoid spurious effect runs when only the reference changes.\n *\n * The cache is a ref read and written during render. That is flagged by the React\n * Compiler rules and is nonetheless correct here: the write is idempotent — a\n * discarded render either wrote a structurally equal value or nothing at all — so\n * replaying the render cannot change the result.\n */\nexport function useDeepMemo<T>(value: T): T {\n    const ref = useRef<T>(value);\n    if (!deepEqual(ref.current, value)) {\n        ref.current = value;\n    }\n    return ref.current;\n}\n"],"mappings":";;AAWA,SAAgB,EAAU,GAAY,GAAqB;CACvD,IAAI,OAAO,GAAG,GAAG,CAAC,GAAG,OAAO;CAE5B,IADI,OAAO,KAAM,YAAY,OAAO,KAAM,YAAY,MAAM,QAAQ,MAAM,QACtE,MAAM,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,GAAG,OAAO;CAClD,IAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAEnC,OADI,EAAE,WAAW,EAAE,UACZ,EAAE,OAAO,GAAO,MAAU,EAAU,GAAO,EAAE,EAAM,CAAC;CAE/D,IAAM,IAAQ,OAAO,KAAK,CAAW,GAC/B,IAAQ,OAAO,KAAK,CAAW;CAErC,OADI,EAAM,WAAW,EAAM,UACpB,EAAM,OAAO,MAChB,EAAW,EAA8B,IAAO,EAA8B,EAAI,CACtF;AACJ;AAYA,SAAgB,EAAe,GAAa;CACxC,IAAM,IAAM,EAAU,CAAK;CAI3B,OAHK,EAAU,EAAI,SAAS,CAAK,MAC7B,EAAI,UAAU,IAEX,EAAI;AACf"}
+{"version":3,"file":"use-deep-memo.js","names":["deepEqual","a","b","value","index","aKeys","bKeys","key","useDeepMemo","ref","useRef"],"sources":["../../src/hooks/use-deep-memo.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- the structural cache is read and written during render by design (see the docstring) */\nimport { useRef } from \"react\";\n\n/**\n * Structural equality over plain objects and arrays, the comparison `useDeepMemo`\n * and `useDraftFilters` share. Internal: not re-exported from the barrel.\n *\n * @param a - First value.\n * @param b - Second value.\n * @returns Whether both values have the same shape and leaves.\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) return false;\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) return false;\n        return a.every((value, index) => deepEqual(value, b[index]));\n    }\n    const aKeys = Object.keys(a as object);\n    const bKeys = Object.keys(b as object);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every((key) =>\n        deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n    );\n}\n\n/**\n * Memoize a value with a structural equality check. Use when an object/array\n * created during render is fed to `useEffect` dependencies and you want to\n * avoid spurious effect runs when only the reference changes.\n *\n * The cache is a ref read and written during render. That is flagged by the React\n * Compiler rules and is nonetheless correct here: the write is idempotent — a\n * discarded render either wrote a structurally equal value or nothing at all — so\n * replaying the render cannot change the result.\n */\nexport function useDeepMemo<T>(value: T): T {\n    const ref = useRef<T>(value);\n    if (!deepEqual(ref.current, value)) {\n        ref.current = value;\n    }\n    return ref.current;\n}\n"],"mappings":";;AAWA,SAAgBA,EAAU,GAAY,GAAqB;CACvD,IAAI,OAAO,GAAGC,GAAGC,CAAC,GAAG,OAAO;CAE5B,IADI,OAAOD,KAAM,YAAY,OAAOC,KAAM,YAAYD,MAAM,QAAQC,MAAM,QACtE,MAAM,QAAQD,CAAC,MAAM,MAAM,QAAQC,CAAC,GAAG,OAAO;CAClD,IAAI,MAAM,QAAQD,CAAC,KAAK,MAAM,QAAQC,CAAC,GAEnC,OADID,EAAE,WAAWC,EAAE,UACZD,EAAE,OAAO,GAAO,MAAUD,EAAUG,GAAOD,EAAEE,EAAM,CAAC;CAE/D,IAAMC,IAAQ,OAAO,KAAKJ,CAAW,GAC/BK,IAAQ,OAAO,KAAKJ,CAAW;CAErC,OADIG,EAAM,WAAWC,EAAM,UACpBD,EAAM,OAAO,MAChBL,EAAWC,EAA8BM,IAAOL,EAA8BK,EAAI,CACtF;AACJ;AAYA,SAAgBC,EAAe,GAAa;CACxC,IAAMC,IAAMC,EAAUP,CAAK;CAI3B,OAHKH,EAAUS,EAAI,SAASN,CAAK,MAC7B,EAAI,UAAUA,IAEXM,EAAI;AACf"}