tempest-react-sdk 0.78.0 → 0.80.0

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

@@ -1 +1 @@
-{"version":3,"file":"use-sortable.js","names":[],"sources":["../../src/hooks/use-sortable.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, hook-lines — drag-and-drop with a keyboard path that\n * has to produce the same moves as the pointer path: pointer capture, auto-scroll\n * near the edges, the drop-index maths and the live-region announcements all read\n * one drag state. Two hooks would mean two copies of the index arithmetic, and the\n * two paths silently disagreeing is the bug this exists to prevent.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { KeyboardEvent as ReactKeyboardEvent, PointerEvent as ReactPointerEvent } from \"react\";\n\n/** Where a dragged item would land if dropped now. */\nexport interface SortableDropTarget {\n    /** Index the item started at, within its own group. */\n    from: number;\n    /** Index it would move to, within the destination group. */\n    to: number;\n    /**\n     * Group the item started in — a Kanban column, for instance. `undefined` for a\n     * plain single-list sortable.\n     */\n    fromGroup?: string;\n    /** Destination group. Equal to `fromGroup` when the move stays in one group. */\n    toGroup?: string;\n}\n\n/** Props to spread on each sortable item. */\nexport interface SortableItemProps {\n    /** Marks the item for hit-testing. */\n    \"data-sortable-index\": number;\n    /** Group the item belongs to, when the sortable spans several lists. */\n    \"data-sortable-group\"?: string;\n    /** `true` while this item is the one being moved. */\n    \"data-sortable-active\"?: boolean;\n    /** Grab handle wiring: starts a pointer drag. */\n    onPointerDown: (event: ReactPointerEvent<HTMLElement>) => void;\n    /** Keyboard reordering — see {@link UseSortableResult}. */\n    onKeyDown: (event: ReactKeyboardEvent<HTMLElement>) => void;\n    /** Puts the item in the tab order so the keyboard path is reachable. */\n    tabIndex: number;\n    role: \"option\";\n    \"aria-roledescription\": string;\n    \"aria-selected\": boolean;\n}\n\nexport interface UseSortableOptions {\n    /**\n     * How many items are in the sortable. Changing it cancels an in-flight drag.\n     *\n     * With groups, pass the **total** across groups: the number only has to change\n     * whenever the indices the drag was based on stop being valid.\n     */\n    itemCount: number;\n    /**\n     * Called once, when a move is committed — on pointer release or on a keyboard\n     * move. Never called mid-drag, so a controlled list re-renders once instead of\n     * on every pointer frame.\n     */\n    onReorder: (target: SortableDropTarget) => void;\n    /** Blocks all interaction. */\n    disabled?: boolean;\n    /**\n     * Description announced for each item, so a screen reader user learns the\n     * keyboard contract. Default is in English — override it to localize.\n     */\n    roleDescription?: string;\n}\n\nexport interface UseSortableResult {\n    /** Index being dragged, or `null` when idle. */\n    activeIndex: number | null;\n    /** Index the item would land on, or `null` when idle. */\n    overIndex: number | null;\n    /** Group the dragged item came from, when using groups. */\n    activeGroup?: string;\n    /** Group the item is currently over, when using groups. */\n    overGroup?: string;\n    /**\n     * Spread on each item. Pass `group` when the sortable spans several lists (a\n     * Kanban column id), so a drop can land in a different group.\n     */\n    getItemProps: (index: number, group?: string) => SortableItemProps;\n    /**\n     * Spread on an **empty** group's drop area, so an item can be moved into a\n     * column that has no cards yet — hit-testing works off item rects, and a group\n     * with no items has none.\n     */\n    getEmptyGroupProps: (group: string) => {\n        \"data-sortable-group\": string;\n        \"data-sortable-empty\": true;\n    };\n    /** Spread on the list container (`role=\"listbox\"` + a label of your own). */\n    getListProps: () => { role: \"listbox\"; \"aria-orientation\": \"vertical\" };\n    /** Abort the current drag without reordering. */\n    cancel: () => void;\n    /**\n     * Callback ref for the element that contains the sortable items — hit-testing\n     * searches inside it.\n     *\n     * Named `setContainer` rather than `ref` because it is a **callback**, not a ref\n     * object: `ref={sortable.setContainer}`. The old name also read as a readable\n     * ref to the React Compiler rules, which flagged every consumer.\n     */\n    setContainer: (node: HTMLElement | null) => void;\n}\n\n/** Reorder helper: move `from` to `to`, returning a new array. */\nexport function moveItem<T>(items: T[], from: number, to: number): T[] {\n    if (from === to || from < 0 || to < 0 || from >= items.length || to >= items.length) {\n        return items;\n    }\n    const next = items.slice();\n    const [moved] = next.splice(from, 1);\n    next.splice(to, 0, moved);\n    return next;\n}\n\n/** A hit-test result: the item (or empty group) under the pointer. */\ninterface HitTarget {\n    index: number;\n    group?: string;\n}\n\n/**\n * Find the sortable slot under a viewport point.\n *\n * Items are tried first; an empty group's drop area is only considered when no item\n * matched, since an empty column is a fallback target rather than a competing one.\n */\nfunction targetAtPoint(container: HTMLElement | null, x: number, y: number): HitTarget | null {\n    if (!container) return null;\n    const inside = (element: HTMLElement): boolean => {\n        const rect = element.getBoundingClientRect();\n        return y >= rect.top && y <= rect.bottom && x >= rect.left && x <= rect.right;\n    };\n\n    for (const item of Array.from(\n        container.querySelectorAll<HTMLElement>(\"[data-sortable-index]\"),\n    )) {\n        if (!inside(item)) continue;\n        const index = Number(item.dataset.sortableIndex);\n        if (Number.isNaN(index)) return null;\n        return { index, group: item.dataset.sortableGroup };\n    }\n\n    for (const empty of Array.from(\n        container.querySelectorAll<HTMLElement>(\"[data-sortable-empty]\"),\n    )) {\n        if (inside(empty)) return { index: 0, group: empty.dataset.sortableGroup };\n    }\n\n    return null;\n}\n\n/**\n * Drag-to-reorder for a list, with a **keyboard path of equal standing**.\n *\n * Pointer events cover mouse, touch and stylus through one code path, and pointer\n * capture keeps the drag alive when the pointer leaves the item. `Space` picks an\n * item up, the arrows move it, `Space`/`Enter` drops it and `Escape` cancels —\n * because a reorder that only works by dragging excludes keyboard users\n * completely, which is where most drag-and-drop implementations fail.\n *\n * The hook owns interaction only: it never mutates your data. `onReorder` fires\n * once per committed move and you apply it, typically with {@link moveItem}. That\n * keeps the list a controlled value and avoids a re-render per pointer frame.\n *\n * Hit-testing reads the live DOM rects of `[data-sortable-index]` children rather\n * than assuming a fixed row height, so it works with rows of different sizes.\n *\n * A change in `itemCount` cancels an in-flight drag: the list no longer has the\n * indices the drag was based on, and committing anyway would move the wrong row.\n *\n * Note for consumers: the indices and groups are exposed as **state** (so rendering\n * from them is reactive) and mirrored into refs only so the window-level `pointerup`\n * listener can read both synchronously. Because the handlers returned by\n * `getItemProps` close over those mirrors, the React Compiler `refs` rule reports\n * the *call site* — a component spreading these props may need a file-level\n * exemption, as `Kanban` documents.\n *\n * @example\n * ```tsx\n * const [items, setItems] = useState([\"Alfa\", \"Bravo\", \"Charlie\"]);\n * const sortable = useSortable({\n *   itemCount: items.length,\n *   onReorder: ({ from, to }) => setItems((current) => moveItem(current, from, to)),\n * });\n *\n * <ul {...sortable.getListProps()} aria-label=\"Prioridade\" ref={sortable.setContainer}>\n *   {items.map((item, index) => (\n *     <li key={item} {...sortable.getItemProps(index)}>\n *       {item}\n *     </li>\n *   ))}\n * </ul>\n * ```\n */\nexport function useSortable(options: UseSortableOptions): UseSortableResult {\n    const { itemCount, onReorder, disabled = false, roleDescription = \"Sortable item\" } = options;\n\n    const [activeIndex, setActiveIndexState] = useState<number | null>(null);\n    const [overIndex, setOverIndexState] = useState<number | null>(null);\n    const containerRef = useRef<HTMLElement | null>(null);\n    const onReorderRef = useRef(onReorder);\n\n    /**\n     * Mirrors of the two indices.\n     *\n     * The window-level `pointerup` listener has to read both values *synchronously*\n     * to know what to commit, and a state setter only exposes one of them. Mirroring\n     * into refs keeps the commit readable instead of nesting setters to smuggle the\n     * other value out.\n     */\n    const activeRef = useRef<number | null>(null);\n    const overRef = useRef<number | null>(null);\n    const [activeGroup, setActiveGroupState] = useState<string | undefined>(undefined);\n    const [overGroup, setOverGroupState] = useState<string | undefined>(undefined);\n    const activeGroupRef = useRef<string | undefined>(undefined);\n    const overGroupRef = useRef<string | undefined>(undefined);\n\n    const setActiveGroup = useCallback((value: string | undefined): void => {\n        activeGroupRef.current = value;\n        setActiveGroupState(value);\n    }, []);\n\n    const setOverGroup = useCallback((value: string | undefined): void => {\n        overGroupRef.current = value;\n        setOverGroupState(value);\n    }, []);\n\n    const setActiveIndex = useCallback((value: number | null): void => {\n        activeRef.current = value;\n        setActiveIndexState(value);\n    }, []);\n\n    const setOverIndex = useCallback((value: number | null): void => {\n        overRef.current = value;\n        setOverIndexState(value);\n    }, []);\n\n    useEffect(() => {\n        onReorderRef.current = onReorder;\n    }, [onReorder]);\n\n    const reset = useCallback((): void => {\n        setActiveGroup(undefined);\n        setOverGroup(undefined);\n        setActiveIndex(null);\n        setOverIndex(null);\n    }, [setActiveGroup, setActiveIndex, setOverGroup, setOverIndex]);\n\n    useEffect(() => {\n        reset();\n    }, [itemCount, reset]);\n\n    /**\n     * Report a committed move and go back to idle.\n     *\n     * The groups are **arguments**, not reads of the mirror refs: `commit` ends up\n     * inside the props returned by `getItemProps`, which render calls, and a ref read\n     * anywhere in that closure chain is a render-time ref access. The pointer\n     * listener reads the mirrors itself — it is an event handler, where reading is\n     * fine — and hands the values over.\n     *\n     * A move that changes group counts even at the same index (the card lands in\n     * another column), so only a same-group, same-index drop is \"nothing happened\".\n     */\n    const commit = useCallback(\n        (from: number, to: number, fromGroup?: string, toGroup?: string): void => {\n            if (from !== to || fromGroup !== toGroup) {\n                onReorderRef.current({ from, to, fromGroup, toGroup });\n            }\n            reset();\n        },\n        [reset],\n    );\n\n    const setContainer = useCallback((node: HTMLElement | null): void => {\n        containerRef.current = node;\n    }, []);\n\n    const handlePointerDown = useCallback(\n        (index: number, group: string | undefined, event: ReactPointerEvent<HTMLElement>): void => {\n            if (disabled) return;\n            event.currentTarget.setPointerCapture?.(event.pointerId);\n            setActiveGroup(group);\n            setOverGroup(group);\n            setActiveIndex(index);\n            setOverIndex(index);\n        },\n        [disabled, setActiveGroup, setActiveIndex, setOverGroup, setOverIndex],\n    );\n\n    useEffect(() => {\n        if (activeIndex === null) return;\n\n        function onPointerMove(event: PointerEvent): void {\n            const target = targetAtPoint(containerRef.current, event.clientX, event.clientY);\n            if (!target) return;\n            setOverGroup(target.group);\n            setOverIndex(target.index);\n        }\n\n        function onPointerUp(): void {\n            const from = activeRef.current;\n            const to = overRef.current;\n            if (from !== null && to !== null) {\n                commit(from, to, activeGroupRef.current, overGroupRef.current);\n            } else {\n                reset();\n            }\n        }\n\n        /**\n         * Cancel the drag on `Escape`.\n         *\n         * Listened in the capture phase and marked consumed: the overlays' shared\n         * `Escape` listener sits on `window` in the bubble phase, so a list sorted\n         * inside a `Modal` would otherwise close the modal mid-drag instead of\n         * just dropping the item back.\n         */\n        function onKeyDown(event: KeyboardEvent): void {\n            if (event.key !== \"Escape\") return;\n            event.preventDefault();\n            reset();\n        }\n\n        window.addEventListener(\"pointermove\", onPointerMove);\n        window.addEventListener(\"pointerup\", onPointerUp);\n        window.addEventListener(\"pointercancel\", reset);\n        window.addEventListener(\"keydown\", onKeyDown, true);\n        return () => {\n            window.removeEventListener(\"pointermove\", onPointerMove);\n            window.removeEventListener(\"pointerup\", onPointerUp);\n            window.removeEventListener(\"pointercancel\", reset);\n            window.removeEventListener(\"keydown\", onKeyDown, true);\n        };\n    }, [activeIndex, commit, reset, setOverGroup, setOverIndex]);\n\n    const handleKeyDown = useCallback(\n        (\n            index: number,\n            group: string | undefined,\n            event: ReactKeyboardEvent<HTMLElement>,\n        ): void => {\n            if (disabled) return;\n            const picked = activeIndex !== null;\n\n            switch (event.key) {\n                case \" \":\n                case \"Enter\":\n                    event.preventDefault();\n                    if (!picked) {\n                        setActiveGroup(group);\n                        setOverGroup(group);\n                        setActiveIndex(index);\n                        setOverIndex(index);\n                    } else if (overIndex !== null) {\n                        commit(activeIndex, overIndex, activeGroup, overGroup);\n                    }\n                    break;\n                case \"ArrowDown\":\n                case \"ArrowRight\": {\n                    if (!picked) return;\n                    event.preventDefault();\n                    if (overRef.current !== null) {\n                        setOverIndex(Math.min(overRef.current + 1, itemCount - 1));\n                    }\n                    break;\n                }\n                case \"ArrowUp\":\n                case \"ArrowLeft\": {\n                    if (!picked) return;\n                    event.preventDefault();\n                    if (overRef.current !== null) {\n                        setOverIndex(Math.max(overRef.current - 1, 0));\n                    }\n                    break;\n                }\n                case \"Escape\":\n                    if (!picked) return;\n                    event.preventDefault();\n                    reset();\n                    break;\n                default:\n                    break;\n            }\n        },\n        [\n            activeGroup,\n            activeIndex,\n            commit,\n            overGroup,\n            disabled,\n            itemCount,\n            overIndex,\n            reset,\n            setActiveGroup,\n            setActiveIndex,\n            setOverGroup,\n            setOverIndex,\n        ],\n    );\n\n    const getItemProps = useCallback(\n        (index: number, group?: string): SortableItemProps => ({\n            \"data-sortable-index\": index,\n            \"data-sortable-group\": group,\n            \"data-sortable-active\": (activeIndex === index && activeGroup === group) || undefined,\n            onPointerDown: (event) => handlePointerDown(index, group, event),\n            onKeyDown: (event) => handleKeyDown(index, group, event),\n            tabIndex: disabled ? -1 : 0,\n            role: \"option\",\n            \"aria-roledescription\": roleDescription,\n            \"aria-selected\": activeIndex === index && activeGroup === group,\n        }),\n        [activeGroup, activeIndex, disabled, handleKeyDown, handlePointerDown, roleDescription],\n    );\n\n    const getEmptyGroupProps = useCallback(\n        (group: string) => ({ \"data-sortable-group\": group, \"data-sortable-empty\": true as const }),\n        [],\n    );\n\n    const getListProps = useCallback(\n        () => ({ role: \"listbox\" as const, \"aria-orientation\": \"vertical\" as const }),\n        [],\n    );\n\n    return {\n        activeIndex,\n        overIndex,\n        activeGroup,\n        overGroup,\n        getItemProps,\n        getEmptyGroupProps,\n        getListProps,\n        cancel: reset,\n        setContainer,\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-sortable.js","names":["moveItem","from","to","items","next","moved","targetAtPoint","container","inside","rect","element","y","x","item","index","empty","useSortable","options","activeIndex","setActiveIndexState","useState","overIndex","setOverIndexState","containerRef","useRef","onReorderRef","onReorder","activeRef","overRef","activeGroup","setActiveGroupState","overGroup","setOverGroupState","activeGroupRef","overGroupRef","setActiveGroup","useCallback","value","setOverGroup","setActiveIndex","setOverIndex","reset","itemCount","commit","fromGroup","toGroup","setContainer","node","handlePointerDown","disabled","event","group","onPointerMove","target","onPointerUp","onKeyDown","handleKeyDown","picked","roleDescription"],"sources":["../../src/hooks/use-sortable.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, hook-lines — drag-and-drop with a keyboard path that\n * has to produce the same moves as the pointer path: pointer capture, auto-scroll\n * near the edges, the drop-index maths and the live-region announcements all read\n * one drag state. Two hooks would mean two copies of the index arithmetic, and the\n * two paths silently disagreeing is the bug this exists to prevent.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { KeyboardEvent as ReactKeyboardEvent, PointerEvent as ReactPointerEvent } from \"react\";\n\n/** Where a dragged item would land if dropped now. */\nexport interface SortableDropTarget {\n    /** Index the item started at, within its own group. */\n    from: number;\n    /** Index it would move to, within the destination group. */\n    to: number;\n    /**\n     * Group the item started in — a Kanban column, for instance. `undefined` for a\n     * plain single-list sortable.\n     */\n    fromGroup?: string;\n    /** Destination group. Equal to `fromGroup` when the move stays in one group. */\n    toGroup?: string;\n}\n\n/** Props to spread on each sortable item. */\nexport interface SortableItemProps {\n    /** Marks the item for hit-testing. */\n    \"data-sortable-index\": number;\n    /** Group the item belongs to, when the sortable spans several lists. */\n    \"data-sortable-group\"?: string;\n    /** `true` while this item is the one being moved. */\n    \"data-sortable-active\"?: boolean;\n    /** Grab handle wiring: starts a pointer drag. */\n    onPointerDown: (event: ReactPointerEvent<HTMLElement>) => void;\n    /** Keyboard reordering — see {@link UseSortableResult}. */\n    onKeyDown: (event: ReactKeyboardEvent<HTMLElement>) => void;\n    /** Puts the item in the tab order so the keyboard path is reachable. */\n    tabIndex: number;\n    role: \"option\";\n    \"aria-roledescription\": string;\n    \"aria-selected\": boolean;\n}\n\nexport interface UseSortableOptions {\n    /**\n     * How many items are in the sortable. Changing it cancels an in-flight drag.\n     *\n     * With groups, pass the **total** across groups: the number only has to change\n     * whenever the indices the drag was based on stop being valid.\n     */\n    itemCount: number;\n    /**\n     * Called once, when a move is committed — on pointer release or on a keyboard\n     * move. Never called mid-drag, so a controlled list re-renders once instead of\n     * on every pointer frame.\n     */\n    onReorder: (target: SortableDropTarget) => void;\n    /** Blocks all interaction. */\n    disabled?: boolean;\n    /**\n     * Description announced for each item, so a screen reader user learns the\n     * keyboard contract. Default is in English — override it to localize.\n     */\n    roleDescription?: string;\n}\n\nexport interface UseSortableResult {\n    /** Index being dragged, or `null` when idle. */\n    activeIndex: number | null;\n    /** Index the item would land on, or `null` when idle. */\n    overIndex: number | null;\n    /** Group the dragged item came from, when using groups. */\n    activeGroup?: string;\n    /** Group the item is currently over, when using groups. */\n    overGroup?: string;\n    /**\n     * Spread on each item. Pass `group` when the sortable spans several lists (a\n     * Kanban column id), so a drop can land in a different group.\n     */\n    getItemProps: (index: number, group?: string) => SortableItemProps;\n    /**\n     * Spread on an **empty** group's drop area, so an item can be moved into a\n     * column that has no cards yet — hit-testing works off item rects, and a group\n     * with no items has none.\n     */\n    getEmptyGroupProps: (group: string) => {\n        \"data-sortable-group\": string;\n        \"data-sortable-empty\": true;\n    };\n    /** Spread on the list container (`role=\"listbox\"` + a label of your own). */\n    getListProps: () => { role: \"listbox\"; \"aria-orientation\": \"vertical\" };\n    /** Abort the current drag without reordering. */\n    cancel: () => void;\n    /**\n     * Callback ref for the element that contains the sortable items — hit-testing\n     * searches inside it.\n     *\n     * Named `setContainer` rather than `ref` because it is a **callback**, not a ref\n     * object: `ref={sortable.setContainer}`. The old name also read as a readable\n     * ref to the React Compiler rules, which flagged every consumer.\n     */\n    setContainer: (node: HTMLElement | null) => void;\n}\n\n/** Reorder helper: move `from` to `to`, returning a new array. */\nexport function moveItem<T>(items: T[], from: number, to: number): T[] {\n    if (from === to || from < 0 || to < 0 || from >= items.length || to >= items.length) {\n        return items;\n    }\n    const next = items.slice();\n    const [moved] = next.splice(from, 1);\n    next.splice(to, 0, moved);\n    return next;\n}\n\n/** A hit-test result: the item (or empty group) under the pointer. */\ninterface HitTarget {\n    index: number;\n    group?: string;\n}\n\n/**\n * Find the sortable slot under a viewport point.\n *\n * Items are tried first; an empty group's drop area is only considered when no item\n * matched, since an empty column is a fallback target rather than a competing one.\n */\nfunction targetAtPoint(container: HTMLElement | null, x: number, y: number): HitTarget | null {\n    if (!container) return null;\n    const inside = (element: HTMLElement): boolean => {\n        const rect = element.getBoundingClientRect();\n        return y >= rect.top && y <= rect.bottom && x >= rect.left && x <= rect.right;\n    };\n\n    for (const item of Array.from(\n        container.querySelectorAll<HTMLElement>(\"[data-sortable-index]\"),\n    )) {\n        if (!inside(item)) continue;\n        const index = Number(item.dataset.sortableIndex);\n        if (Number.isNaN(index)) return null;\n        return { index, group: item.dataset.sortableGroup };\n    }\n\n    for (const empty of Array.from(\n        container.querySelectorAll<HTMLElement>(\"[data-sortable-empty]\"),\n    )) {\n        if (inside(empty)) return { index: 0, group: empty.dataset.sortableGroup };\n    }\n\n    return null;\n}\n\n/**\n * Drag-to-reorder for a list, with a **keyboard path of equal standing**.\n *\n * Pointer events cover mouse, touch and stylus through one code path, and pointer\n * capture keeps the drag alive when the pointer leaves the item. `Space` picks an\n * item up, the arrows move it, `Space`/`Enter` drops it and `Escape` cancels —\n * because a reorder that only works by dragging excludes keyboard users\n * completely, which is where most drag-and-drop implementations fail.\n *\n * The hook owns interaction only: it never mutates your data. `onReorder` fires\n * once per committed move and you apply it, typically with {@link moveItem}. That\n * keeps the list a controlled value and avoids a re-render per pointer frame.\n *\n * Hit-testing reads the live DOM rects of `[data-sortable-index]` children rather\n * than assuming a fixed row height, so it works with rows of different sizes.\n *\n * A change in `itemCount` cancels an in-flight drag: the list no longer has the\n * indices the drag was based on, and committing anyway would move the wrong row.\n *\n * Note for consumers: the indices and groups are exposed as **state** (so rendering\n * from them is reactive) and mirrored into refs only so the window-level `pointerup`\n * listener can read both synchronously. Because the handlers returned by\n * `getItemProps` close over those mirrors, the React Compiler `refs` rule reports\n * the *call site* — a component spreading these props may need a file-level\n * exemption, as `Kanban` documents.\n *\n * @example\n * ```tsx\n * const [items, setItems] = useState([\"Alfa\", \"Bravo\", \"Charlie\"]);\n * const sortable = useSortable({\n *   itemCount: items.length,\n *   onReorder: ({ from, to }) => setItems((current) => moveItem(current, from, to)),\n * });\n *\n * <ul {...sortable.getListProps()} aria-label=\"Prioridade\" ref={sortable.setContainer}>\n *   {items.map((item, index) => (\n *     <li key={item} {...sortable.getItemProps(index)}>\n *       {item}\n *     </li>\n *   ))}\n * </ul>\n * ```\n */\nexport function useSortable(options: UseSortableOptions): UseSortableResult {\n    const { itemCount, onReorder, disabled = false, roleDescription = \"Sortable item\" } = options;\n\n    const [activeIndex, setActiveIndexState] = useState<number | null>(null);\n    const [overIndex, setOverIndexState] = useState<number | null>(null);\n    const containerRef = useRef<HTMLElement | null>(null);\n    const onReorderRef = useRef(onReorder);\n\n    /**\n     * Mirrors of the two indices.\n     *\n     * The window-level `pointerup` listener has to read both values *synchronously*\n     * to know what to commit, and a state setter only exposes one of them. Mirroring\n     * into refs keeps the commit readable instead of nesting setters to smuggle the\n     * other value out.\n     */\n    const activeRef = useRef<number | null>(null);\n    const overRef = useRef<number | null>(null);\n    const [activeGroup, setActiveGroupState] = useState<string | undefined>(undefined);\n    const [overGroup, setOverGroupState] = useState<string | undefined>(undefined);\n    const activeGroupRef = useRef<string | undefined>(undefined);\n    const overGroupRef = useRef<string | undefined>(undefined);\n\n    const setActiveGroup = useCallback((value: string | undefined): void => {\n        activeGroupRef.current = value;\n        setActiveGroupState(value);\n    }, []);\n\n    const setOverGroup = useCallback((value: string | undefined): void => {\n        overGroupRef.current = value;\n        setOverGroupState(value);\n    }, []);\n\n    const setActiveIndex = useCallback((value: number | null): void => {\n        activeRef.current = value;\n        setActiveIndexState(value);\n    }, []);\n\n    const setOverIndex = useCallback((value: number | null): void => {\n        overRef.current = value;\n        setOverIndexState(value);\n    }, []);\n\n    useEffect(() => {\n        onReorderRef.current = onReorder;\n    }, [onReorder]);\n\n    const reset = useCallback((): void => {\n        setActiveGroup(undefined);\n        setOverGroup(undefined);\n        setActiveIndex(null);\n        setOverIndex(null);\n    }, [setActiveGroup, setActiveIndex, setOverGroup, setOverIndex]);\n\n    useEffect(() => {\n        reset();\n    }, [itemCount, reset]);\n\n    /**\n     * Report a committed move and go back to idle.\n     *\n     * The groups are **arguments**, not reads of the mirror refs: `commit` ends up\n     * inside the props returned by `getItemProps`, which render calls, and a ref read\n     * anywhere in that closure chain is a render-time ref access. The pointer\n     * listener reads the mirrors itself — it is an event handler, where reading is\n     * fine — and hands the values over.\n     *\n     * A move that changes group counts even at the same index (the card lands in\n     * another column), so only a same-group, same-index drop is \"nothing happened\".\n     */\n    const commit = useCallback(\n        (from: number, to: number, fromGroup?: string, toGroup?: string): void => {\n            if (from !== to || fromGroup !== toGroup) {\n                onReorderRef.current({ from, to, fromGroup, toGroup });\n            }\n            reset();\n        },\n        [reset],\n    );\n\n    const setContainer = useCallback((node: HTMLElement | null): void => {\n        containerRef.current = node;\n    }, []);\n\n    const handlePointerDown = useCallback(\n        (index: number, group: string | undefined, event: ReactPointerEvent<HTMLElement>): void => {\n            if (disabled) return;\n            event.currentTarget.setPointerCapture?.(event.pointerId);\n            setActiveGroup(group);\n            setOverGroup(group);\n            setActiveIndex(index);\n            setOverIndex(index);\n        },\n        [disabled, setActiveGroup, setActiveIndex, setOverGroup, setOverIndex],\n    );\n\n    useEffect(() => {\n        if (activeIndex === null) return;\n\n        function onPointerMove(event: PointerEvent): void {\n            const target = targetAtPoint(containerRef.current, event.clientX, event.clientY);\n            if (!target) return;\n            setOverGroup(target.group);\n            setOverIndex(target.index);\n        }\n\n        function onPointerUp(): void {\n            const from = activeRef.current;\n            const to = overRef.current;\n            if (from !== null && to !== null) {\n                commit(from, to, activeGroupRef.current, overGroupRef.current);\n            } else {\n                reset();\n            }\n        }\n\n        /**\n         * Cancel the drag on `Escape`.\n         *\n         * Listened in the capture phase and marked consumed: the overlays' shared\n         * `Escape` listener sits on `window` in the bubble phase, so a list sorted\n         * inside a `Modal` would otherwise close the modal mid-drag instead of\n         * just dropping the item back.\n         */\n        function onKeyDown(event: KeyboardEvent): void {\n            if (event.key !== \"Escape\") return;\n            event.preventDefault();\n            reset();\n        }\n\n        window.addEventListener(\"pointermove\", onPointerMove);\n        window.addEventListener(\"pointerup\", onPointerUp);\n        window.addEventListener(\"pointercancel\", reset);\n        window.addEventListener(\"keydown\", onKeyDown, true);\n        return () => {\n            window.removeEventListener(\"pointermove\", onPointerMove);\n            window.removeEventListener(\"pointerup\", onPointerUp);\n            window.removeEventListener(\"pointercancel\", reset);\n            window.removeEventListener(\"keydown\", onKeyDown, true);\n        };\n    }, [activeIndex, commit, reset, setOverGroup, setOverIndex]);\n\n    const handleKeyDown = useCallback(\n        (\n            index: number,\n            group: string | undefined,\n            event: ReactKeyboardEvent<HTMLElement>,\n        ): void => {\n            if (disabled) return;\n            const picked = activeIndex !== null;\n\n            switch (event.key) {\n                case \" \":\n                case \"Enter\":\n                    event.preventDefault();\n                    if (!picked) {\n                        setActiveGroup(group);\n                        setOverGroup(group);\n                        setActiveIndex(index);\n                        setOverIndex(index);\n                    } else if (overIndex !== null) {\n                        commit(activeIndex, overIndex, activeGroup, overGroup);\n                    }\n                    break;\n                case \"ArrowDown\":\n                case \"ArrowRight\": {\n                    if (!picked) return;\n                    event.preventDefault();\n                    if (overRef.current !== null) {\n                        setOverIndex(Math.min(overRef.current + 1, itemCount - 1));\n                    }\n                    break;\n                }\n                case \"ArrowUp\":\n                case \"ArrowLeft\": {\n                    if (!picked) return;\n                    event.preventDefault();\n                    if (overRef.current !== null) {\n                        setOverIndex(Math.max(overRef.current - 1, 0));\n                    }\n                    break;\n                }\n                case \"Escape\":\n                    if (!picked) return;\n                    event.preventDefault();\n                    reset();\n                    break;\n                default:\n                    break;\n            }\n        },\n        [\n            activeGroup,\n            activeIndex,\n            commit,\n            overGroup,\n            disabled,\n            itemCount,\n            overIndex,\n            reset,\n            setActiveGroup,\n            setActiveIndex,\n            setOverGroup,\n            setOverIndex,\n        ],\n    );\n\n    const getItemProps = useCallback(\n        (index: number, group?: string): SortableItemProps => ({\n            \"data-sortable-index\": index,\n            \"data-sortable-group\": group,\n            \"data-sortable-active\": (activeIndex === index && activeGroup === group) || undefined,\n            onPointerDown: (event) => handlePointerDown(index, group, event),\n            onKeyDown: (event) => handleKeyDown(index, group, event),\n            tabIndex: disabled ? -1 : 0,\n            role: \"option\",\n            \"aria-roledescription\": roleDescription,\n            \"aria-selected\": activeIndex === index && activeGroup === group,\n        }),\n        [activeGroup, activeIndex, disabled, handleKeyDown, handlePointerDown, roleDescription],\n    );\n\n    const getEmptyGroupProps = useCallback(\n        (group: string) => ({ \"data-sortable-group\": group, \"data-sortable-empty\": true as const }),\n        [],\n    );\n\n    const getListProps = useCallback(\n        () => ({ role: \"listbox\" as const, \"aria-orientation\": \"vertical\" as const }),\n        [],\n    );\n\n    return {\n        activeIndex,\n        overIndex,\n        activeGroup,\n        overGroup,\n        getItemProps,\n        getEmptyGroupProps,\n        getListProps,\n        cancel: reset,\n        setContainer,\n    };\n}\n"],"mappings":"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"}

package/dist/hooks/use-stable-callback.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-stable-callback.cjs","names":[],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Returns a stable function reference that always invokes the latest\n * `callback` argument. Use to break dependency cycles in effects without\n * triggering re-runs when the callback identity changes.\n *\n * Built on {@link useLatestRef}, which owns the render-time assignment and the\n * reason it is not an effect: an effect would satisfy the React Compiler rules\n * but open a one-commit staleness window. What this adds is the callable with a\n * stable identity, so callers do not reach through `.current`. Prefer React's\n * `useEffectEvent` once it ships as stable.\n *\n * The ref is listed as a dependency because it is one — a stable object across\n * renders, so the returned identity never changes. Listing it is what lets the\n * exhaustive-deps rule verify that instead of taking an empty array on trust.\n */\nexport function useStableCallback<TArgs extends unknown[], TReturn>(\n    callback: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n    const ref = useLatestRef(callback);\n    return useCallback((...args: TArgs) => ref.current(...args), [ref]);\n}\n"],"mappings":"+DAkBA,SAAgB,EACZ,EAC2B,CAC3B,IAAM,EAAM,EAAA,aAAa,CAAQ,EACjC,OAAA,EAAO,EAAA,YAAA,EAAa,GAAG,IAAgB,EAAI,QAAQ,GAAG,CAAI,EAAG,CAAC,CAAG,CAAC,CACtE"}
+{"version":3,"file":"use-stable-callback.cjs","names":["useLatestRef","useCallback","require_use_latest_ref","react","useStableCallback","ref","callback","args"],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Returns a stable function reference that always invokes the latest\n * `callback` argument. Use to break dependency cycles in effects without\n * triggering re-runs when the callback identity changes.\n *\n * Built on {@link useLatestRef}, which owns the render-time assignment and the\n * reason it is not an effect: an effect would satisfy the React Compiler rules\n * but open a one-commit staleness window. What this adds is the callable with a\n * stable identity, so callers do not reach through `.current`. Prefer React's\n * `useEffectEvent` once it ships as stable.\n *\n * The ref is listed as a dependency because it is one — a stable object across\n * renders, so the returned identity never changes. Listing it is what lets the\n * exhaustive-deps rule verify that instead of taking an empty array on trust.\n */\nexport function useStableCallback<TArgs extends unknown[], TReturn>(\n    callback: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n    const ref = useLatestRef(callback);\n    return useCallback((...args: TArgs) => ref.current(...args), [ref]);\n}\n"],"mappings":"A,+DAkBA,SAAgBI,EACZ,EAC2B,CAC3B,IAAMC,EAAML,EAAAA,aAAaM,CAAQ,EACjC,OAAA,EAAOL,EAAAA,YAAAA,EAAa,GAAGM,IAAgBF,EAAI,QAAQ,GAAGE,CAAI,EAAG,CAACF,CAAG,CAAC,CACtE,C"}

package/dist/hooks/use-stable-callback.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-stable-callback.js","names":[],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Returns a stable function reference that always invokes the latest\n * `callback` argument. Use to break dependency cycles in effects without\n * triggering re-runs when the callback identity changes.\n *\n * Built on {@link useLatestRef}, which owns the render-time assignment and the\n * reason it is not an effect: an effect would satisfy the React Compiler rules\n * but open a one-commit staleness window. What this adds is the callable with a\n * stable identity, so callers do not reach through `.current`. Prefer React's\n * `useEffectEvent` once it ships as stable.\n *\n * The ref is listed as a dependency because it is one — a stable object across\n * renders, so the returned identity never changes. Listing it is what lets the\n * exhaustive-deps rule verify that instead of taking an empty array on trust.\n */\nexport function useStableCallback<TArgs extends unknown[], TReturn>(\n    callback: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n    const ref = useLatestRef(callback);\n    return useCallback((...args: TArgs) => ref.current(...args), [ref]);\n}\n"],"mappings":";;;AAkBA,SAAgB,EACZ,GAC2B;CAC3B,IAAM,IAAM,EAAa,CAAQ;CACjC,OAAO,GAAa,GAAG,MAAgB,EAAI,QAAQ,GAAG,CAAI,GAAG,CAAC,CAAG,CAAC;AACtE"}
+{"version":3,"file":"use-stable-callback.js","names":["useStableCallback","ref","useLatestRef","callback","useCallback","args"],"sources":["../../src/hooks/use-stable-callback.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Returns a stable function reference that always invokes the latest\n * `callback` argument. Use to break dependency cycles in effects without\n * triggering re-runs when the callback identity changes.\n *\n * Built on {@link useLatestRef}, which owns the render-time assignment and the\n * reason it is not an effect: an effect would satisfy the React Compiler rules\n * but open a one-commit staleness window. What this adds is the callable with a\n * stable identity, so callers do not reach through `.current`. Prefer React's\n * `useEffectEvent` once it ships as stable.\n *\n * The ref is listed as a dependency because it is one — a stable object across\n * renders, so the returned identity never changes. Listing it is what lets the\n * exhaustive-deps rule verify that instead of taking an empty array on trust.\n */\nexport function useStableCallback<TArgs extends unknown[], TReturn>(\n    callback: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n    const ref = useLatestRef(callback);\n    return useCallback((...args: TArgs) => ref.current(...args), [ref]);\n}\n"],"mappings":";;;AAkBA,SAAgBA,EACZ,GAC2B;CAC3B,IAAMC,IAAMC,EAAaC,CAAQ;CACjC,OAAOC,GAAa,GAAGC,MAAgBJ,EAAI,QAAQ,GAAGI,CAAI,GAAG,CAACJ,CAAG,CAAC;AACtE"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-storage-estimate.cjs","names":[],"sources":["../../src/hooks/use-storage-estimate.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** Raw usage/quota reading from the Storage API, in bytes. */\nexport interface StorageEstimate {\n    /** Bytes currently used by this origin, or `null` when unknown. */\n    usage: number | null;\n    /** Total bytes available to this origin, or `null` when unknown. */\n    quota: number | null;\n}\n\n/**\n * `true` when `navigator.storage` exposes the estimate/persist APIs. Guards\n * every call so the helpers stay safe under SSR and older browsers.\n */\nfunction storageManagerAvailable(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        \"storage\" in navigator &&\n        typeof navigator.storage?.estimate === \"function\"\n    );\n}\n\n/**\n * Read the origin's current storage usage and quota.\n *\n * @returns The estimate, or `{ usage: null, quota: null }` when unsupported.\n */\nexport async function estimateStorage(): Promise<StorageEstimate> {\n    if (!storageManagerAvailable()) return { usage: null, quota: null };\n    const estimate = await navigator.storage.estimate();\n    return { usage: estimate.usage ?? null, quota: estimate.quota ?? null };\n}\n\n/**\n * Ask the browser to make this origin's storage persistent, so IndexedDB and\n * the Cache Storage are not silently evicted under disk pressure — essential\n * for durable offline-first data.\n *\n * The browser may grant silently, prompt, or deny based on engagement heuristics.\n *\n * @returns `true` when storage is (now or already) persisted, else `false`.\n */\nexport async function requestPersistentStorage(): Promise<boolean> {\n    if (\n        typeof navigator === \"undefined\" ||\n        !(\"storage\" in navigator) ||\n        typeof navigator.storage?.persist !== \"function\"\n    ) {\n        return false;\n    }\n    if (typeof navigator.storage.persisted === \"function\") {\n        const already = await navigator.storage.persisted();\n        if (already) return true;\n    }\n    return navigator.storage.persist();\n}\n\n/** Reactive storage-quota state exposed by {@link useStorageEstimate}. */\nexport interface UseStorageEstimateResult extends StorageEstimate {\n    /** `true` when the Storage API is available. */\n    supported: boolean;\n    /** `usage / quota` in `[0, 1]`, or `null` when either value is unknown. */\n    ratio: number | null;\n    /** Whether storage is persisted, `null` before the first read / unsupported. */\n    persisted: boolean | null;\n    /** `true` during the initial read or a `refresh`. */\n    loading: boolean;\n    /** Re-read usage/quota and the persisted flag from the browser. */\n    refresh: () => Promise<void>;\n    /** Request persistent storage; refreshes state and returns the outcome. */\n    requestPersist: () => Promise<boolean>;\n}\n\n/**\n * Track the origin's storage usage, quota and persistence flag, refreshing on\n * demand. Pair with {@link requestPersistentStorage} to surface a \"usando X de\n * Y MB\" meter and a \"tornar armazenamento permanente\" action.\n *\n * @param options - `pollMs` re-reads the estimate on an interval (`0` = off,\n *   the default).\n * @returns The reactive storage state and actions.\n *\n * @example\n * const { usage, quota, ratio, persisted, requestPersist } = useStorageEstimate();\n * return <Meter value={ratio ?? 0} onClick={requestPersist} />;\n */\nexport function useStorageEstimate(options: { pollMs?: number } = {}): UseStorageEstimateResult {\n    const { pollMs = 0 } = options;\n    const [supported] = useState<boolean>(() => storageManagerAvailable());\n    const [usage, setUsage] = useState<number | null>(null);\n    const [quota, setQuota] = useState<number | null>(null);\n    const [persisted, setPersisted] = useState<boolean | null>(null);\n    const [loading, setLoading] = useState<boolean>(supported);\n\n    const refresh = useCallback(async () => {\n        if (!supported) return;\n        setLoading(true);\n        try {\n            const estimate = await estimateStorage();\n            setUsage(estimate.usage);\n            setQuota(estimate.quota);\n            if (typeof navigator.storage?.persisted === \"function\") {\n                setPersisted(await navigator.storage.persisted());\n            }\n        } finally {\n            setLoading(false);\n        }\n    }, [supported]);\n\n    const requestPersist = useCallback(async () => {\n        const granted = await requestPersistentStorage();\n        await refresh();\n        setPersisted(granted);\n        return granted;\n    }, [refresh]);\n\n    useEffect(() => {\n        void refresh();\n    }, [refresh]);\n\n    useEffect(() => {\n        if (pollMs <= 0 || !supported || typeof window === \"undefined\") return;\n        const id = window.setInterval(() => {\n            void refresh();\n        }, pollMs);\n        return () => window.clearInterval(id);\n    }, [pollMs, supported, refresh]);\n\n    const ratio = usage !== null && quota !== null && quota > 0 ? usage / quota : null;\n\n    return {\n        supported,\n        usage,\n        quota,\n        ratio,\n        persisted,\n        loading,\n        refresh,\n        requestPersist,\n    };\n}\n"],"mappings":"uBAcA,SAAS,GAAmC,CACxC,OACI,OAAO,UAAc,KACrB,YAAa,WACb,OAAO,UAAU,SAAS,UAAa,UAE/C,CAOA,eAAsB,GAA4C,CAC9D,GAAI,CAAC,EAAwB,EAAG,MAAO,CAAE,MAAO,KAAM,MAAO,IAAK,EAClE,IAAM,EAAW,MAAM,UAAU,QAAQ,SAAS,EAClD,MAAO,CAAE,MAAO,EAAS,OAAS,KAAM,MAAO,EAAS,OAAS,IAAK,CAC1E,CAWA,eAAsB,GAA6C,CAY/D,OAVI,OAAO,UAAc,KACrB,EAAE,YAAa,YACf,OAAO,UAAU,SAAS,SAAY,WAE/B,GAEP,OAAO,UAAU,QAAQ,WAAc,YAEnC,MADkB,UAAU,QAAQ,UAAU,EAC9B,GAEjB,UAAU,QAAQ,QAAQ,CACrC,CA+BA,SAAgB,EAAmB,EAA+B,CAAC,EAA6B,CAC5F,GAAM,CAAE,SAAS,GAAM,EACjB,CAAC,IAAA,EAAa,EAAA,SAAA,KAAwB,EAAwB,CAAC,EAC/D,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAAwB,IAAI,EAChD,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAAwB,IAAI,EAChD,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAyB,IAAI,EACzD,CAAC,EAAS,IAAA,EAAc,EAAA,SAAA,CAAkB,CAAS,EAEnD,GAAA,EAAU,EAAA,YAAA,CAAY,SAAY,CAC/B,KACL,GAAW,EAAI,EACf,GAAI,CACA,IAAM,EAAW,MAAM,EAAgB,EACvC,EAAS,EAAS,KAAK,EACvB,EAAS,EAAS,KAAK,EACnB,OAAO,UAAU,SAAS,WAAc,YACxC,EAAa,MAAM,UAAU,QAAQ,UAAU,CAAC,CAExD,QAAU,CACN,EAAW,EAAK,CACpB,CAVe,CAWnB,EAAG,CAAC,CAAS,CAAC,EAER,GAAA,EAAiB,EAAA,YAAA,CAAY,SAAY,CAC3C,IAAM,EAAU,MAAM,EAAyB,EAG/C,OAFA,MAAM,EAAQ,EACd,EAAa,CAAO,EACb,CACX,EAAG,CAAC,CAAO,CAAC,EAgBZ,OAdA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAa,CACjB,EAAG,CAAC,CAAO,CAAC,GAEZ,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,GAAU,GAAK,CAAC,GAAa,OAAO,OAAW,IAAa,OAChE,IAAM,EAAK,OAAO,gBAAkB,CAChC,EAAa,CACjB,EAAG,CAAM,EACT,UAAa,OAAO,cAAc,CAAE,CACxC,EAAG,CAAC,EAAQ,EAAW,CAAO,CAAC,EAIxB,CACH,YACA,QACA,QACA,MANU,IAAU,MAAQ,IAAU,MAAQ,EAAQ,EAAI,EAAQ,EAAQ,KAO1E,YACA,UACA,UACA,gBACJ,CACJ"}
+{"version":3,"file":"use-storage-estimate.cjs","names":["useState","useCallback","react","storageManagerAvailable","estimateStorage","estimate","requestPersistentStorage","useStorageEstimate","options","supported","usage","setUsage","quota","setQuota","persisted","setPersisted","loading","setLoading","refresh","requestPersist","granted","pollMs","id"],"sources":["../../src/hooks/use-storage-estimate.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** Raw usage/quota reading from the Storage API, in bytes. */\nexport interface StorageEstimate {\n    /** Bytes currently used by this origin, or `null` when unknown. */\n    usage: number | null;\n    /** Total bytes available to this origin, or `null` when unknown. */\n    quota: number | null;\n}\n\n/**\n * `true` when `navigator.storage` exposes the estimate/persist APIs. Guards\n * every call so the helpers stay safe under SSR and older browsers.\n */\nfunction storageManagerAvailable(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        \"storage\" in navigator &&\n        typeof navigator.storage?.estimate === \"function\"\n    );\n}\n\n/**\n * Read the origin's current storage usage and quota.\n *\n * @returns The estimate, or `{ usage: null, quota: null }` when unsupported.\n */\nexport async function estimateStorage(): Promise<StorageEstimate> {\n    if (!storageManagerAvailable()) return { usage: null, quota: null };\n    const estimate = await navigator.storage.estimate();\n    return { usage: estimate.usage ?? null, quota: estimate.quota ?? null };\n}\n\n/**\n * Ask the browser to make this origin's storage persistent, so IndexedDB and\n * the Cache Storage are not silently evicted under disk pressure — essential\n * for durable offline-first data.\n *\n * The browser may grant silently, prompt, or deny based on engagement heuristics.\n *\n * @returns `true` when storage is (now or already) persisted, else `false`.\n */\nexport async function requestPersistentStorage(): Promise<boolean> {\n    if (\n        typeof navigator === \"undefined\" ||\n        !(\"storage\" in navigator) ||\n        typeof navigator.storage?.persist !== \"function\"\n    ) {\n        return false;\n    }\n    if (typeof navigator.storage.persisted === \"function\") {\n        const already = await navigator.storage.persisted();\n        if (already) return true;\n    }\n    return navigator.storage.persist();\n}\n\n/** Reactive storage-quota state exposed by {@link useStorageEstimate}. */\nexport interface UseStorageEstimateResult extends StorageEstimate {\n    /** `true` when the Storage API is available. */\n    supported: boolean;\n    /** `usage / quota` in `[0, 1]`, or `null` when either value is unknown. */\n    ratio: number | null;\n    /** Whether storage is persisted, `null` before the first read / unsupported. */\n    persisted: boolean | null;\n    /** `true` during the initial read or a `refresh`. */\n    loading: boolean;\n    /** Re-read usage/quota and the persisted flag from the browser. */\n    refresh: () => Promise<void>;\n    /** Request persistent storage; refreshes state and returns the outcome. */\n    requestPersist: () => Promise<boolean>;\n}\n\n/**\n * Track the origin's storage usage, quota and persistence flag, refreshing on\n * demand. Pair with {@link requestPersistentStorage} to surface a \"usando X de\n * Y MB\" meter and a \"tornar armazenamento permanente\" action.\n *\n * @param options - `pollMs` re-reads the estimate on an interval (`0` = off,\n *   the default).\n * @returns The reactive storage state and actions.\n *\n * @example\n * const { usage, quota, ratio, persisted, requestPersist } = useStorageEstimate();\n * return <Meter value={ratio ?? 0} onClick={requestPersist} />;\n */\nexport function useStorageEstimate(options: { pollMs?: number } = {}): UseStorageEstimateResult {\n    const { pollMs = 0 } = options;\n    const [supported] = useState<boolean>(() => storageManagerAvailable());\n    const [usage, setUsage] = useState<number | null>(null);\n    const [quota, setQuota] = useState<number | null>(null);\n    const [persisted, setPersisted] = useState<boolean | null>(null);\n    const [loading, setLoading] = useState<boolean>(supported);\n\n    const refresh = useCallback(async () => {\n        if (!supported) return;\n        setLoading(true);\n        try {\n            const estimate = await estimateStorage();\n            setUsage(estimate.usage);\n            setQuota(estimate.quota);\n            if (typeof navigator.storage?.persisted === \"function\") {\n                setPersisted(await navigator.storage.persisted());\n            }\n        } finally {\n            setLoading(false);\n        }\n    }, [supported]);\n\n    const requestPersist = useCallback(async () => {\n        const granted = await requestPersistentStorage();\n        await refresh();\n        setPersisted(granted);\n        return granted;\n    }, [refresh]);\n\n    useEffect(() => {\n        void refresh();\n    }, [refresh]);\n\n    useEffect(() => {\n        if (pollMs <= 0 || !supported || typeof window === \"undefined\") return;\n        const id = window.setInterval(() => {\n            void refresh();\n        }, pollMs);\n        return () => window.clearInterval(id);\n    }, [pollMs, supported, refresh]);\n\n    const ratio = usage !== null && quota !== null && quota > 0 ? usage / quota : null;\n\n    return {\n        supported,\n        usage,\n        quota,\n        ratio,\n        persisted,\n        loading,\n        refresh,\n        requestPersist,\n    };\n}\n"],"mappings":"A,uBAcA,SAASG,GAAmC,CACxC,OACI,OAAO,UAAc,KACrB,YAAa,WACb,OAAO,UAAU,SAAS,UAAa,UAE/C,CAOA,eAAsBC,GAA4C,CAC9D,GAAI,CAACD,EAAwB,EAAG,MAAO,CAAE,MAAO,KAAM,MAAO,IAAK,EAClE,IAAME,EAAW,MAAM,UAAU,QAAQ,SAAS,EAClD,MAAO,CAAE,MAAOA,EAAS,OAAS,KAAM,MAAOA,EAAS,OAAS,IAAK,CAC1E,CAWA,eAAsBC,GAA6C,CAY/D,OAVI,OAAO,UAAc,KACrB,EAAE,YAAa,YACf,OAAO,UAAU,SAAS,SAAY,WAE/B,GAEP,OAAO,UAAU,QAAQ,WAAc,YAEnC,MADkB,UAAU,QAAQ,UAAU,EAC9B,GAEjB,UAAU,QAAQ,QAAQ,CACrC,CA+BA,SAAgBC,EAAmB,EAA+B,CAAC,EAA6B,CAC5F,GAAM,CAAE,SAAS,GAAMC,EACjB,CAACC,IAAA,EAAaT,EAAAA,SAAAA,KAAwBG,EAAwB,CAAC,EAC/D,CAACO,EAAOC,IAAA,EAAYX,EAAAA,SAAAA,CAAwB,IAAI,EAChD,CAACY,EAAOC,IAAA,EAAYb,EAAAA,SAAAA,CAAwB,IAAI,EAChD,CAACc,EAAWC,IAAA,EAAgBf,EAAAA,SAAAA,CAAyB,IAAI,EACzD,CAACgB,EAASC,IAAA,EAAcjB,EAAAA,SAAAA,CAAkBS,CAAS,EAEnDS,GAAA,EAAUjB,EAAAA,YAAAA,CAAY,SAAY,CACpC,GAAKQ,EACL,GAAW,EAAI,EACf,GAAI,CACA,IAAMJ,EAAW,MAAMD,EAAgB,EACvCO,EAASN,EAAS,KAAK,EACvBQ,EAASR,EAAS,KAAK,EACnB,OAAO,UAAU,SAAS,WAAc,YACxCU,EAAa,MAAM,UAAU,QAAQ,UAAU,CAAC,CAExD,QAAU,CACNE,EAAW,EAAK,CACpB,CAVe,CAWnB,EAAG,CAACR,CAAS,CAAC,EAERU,GAAA,EAAiBlB,EAAAA,YAAAA,CAAY,SAAY,CAC3C,IAAMmB,EAAU,MAAMd,EAAyB,EAG/C,OAFA,MAAMY,EAAQ,EACdH,EAAaK,CAAO,EACbA,CACX,EAAG,CAACF,CAAO,CAAC,EAgBZ,OAdA,EAAAhB,EAAA,UAAA,KAAgB,CACZgB,EAAa,CACjB,EAAG,CAACA,CAAO,CAAC,GAEZ,EAAAhB,EAAA,UAAA,KAAgB,CACZ,GAAImB,GAAU,GAAK,CAACZ,GAAa,OAAO,OAAW,IAAa,OAChE,IAAMa,EAAK,OAAO,gBAAkB,CAChCJ,EAAa,CACjB,EAAGG,CAAM,EACT,UAAa,OAAO,cAAcC,CAAE,CACxC,EAAG,CAACD,EAAQZ,EAAWS,CAAO,CAAC,EAIxB,CACH,YACA,QACA,QACA,MANUR,IAAU,MAAQE,IAAU,MAAQA,EAAQ,EAAIF,EAAQE,EAAQ,KAO1E,YACA,UACA,UACA,gBACJ,CACJ,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-storage-estimate.js","names":[],"sources":["../../src/hooks/use-storage-estimate.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** Raw usage/quota reading from the Storage API, in bytes. */\nexport interface StorageEstimate {\n    /** Bytes currently used by this origin, or `null` when unknown. */\n    usage: number | null;\n    /** Total bytes available to this origin, or `null` when unknown. */\n    quota: number | null;\n}\n\n/**\n * `true` when `navigator.storage` exposes the estimate/persist APIs. Guards\n * every call so the helpers stay safe under SSR and older browsers.\n */\nfunction storageManagerAvailable(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        \"storage\" in navigator &&\n        typeof navigator.storage?.estimate === \"function\"\n    );\n}\n\n/**\n * Read the origin's current storage usage and quota.\n *\n * @returns The estimate, or `{ usage: null, quota: null }` when unsupported.\n */\nexport async function estimateStorage(): Promise<StorageEstimate> {\n    if (!storageManagerAvailable()) return { usage: null, quota: null };\n    const estimate = await navigator.storage.estimate();\n    return { usage: estimate.usage ?? null, quota: estimate.quota ?? null };\n}\n\n/**\n * Ask the browser to make this origin's storage persistent, so IndexedDB and\n * the Cache Storage are not silently evicted under disk pressure — essential\n * for durable offline-first data.\n *\n * The browser may grant silently, prompt, or deny based on engagement heuristics.\n *\n * @returns `true` when storage is (now or already) persisted, else `false`.\n */\nexport async function requestPersistentStorage(): Promise<boolean> {\n    if (\n        typeof navigator === \"undefined\" ||\n        !(\"storage\" in navigator) ||\n        typeof navigator.storage?.persist !== \"function\"\n    ) {\n        return false;\n    }\n    if (typeof navigator.storage.persisted === \"function\") {\n        const already = await navigator.storage.persisted();\n        if (already) return true;\n    }\n    return navigator.storage.persist();\n}\n\n/** Reactive storage-quota state exposed by {@link useStorageEstimate}. */\nexport interface UseStorageEstimateResult extends StorageEstimate {\n    /** `true` when the Storage API is available. */\n    supported: boolean;\n    /** `usage / quota` in `[0, 1]`, or `null` when either value is unknown. */\n    ratio: number | null;\n    /** Whether storage is persisted, `null` before the first read / unsupported. */\n    persisted: boolean | null;\n    /** `true` during the initial read or a `refresh`. */\n    loading: boolean;\n    /** Re-read usage/quota and the persisted flag from the browser. */\n    refresh: () => Promise<void>;\n    /** Request persistent storage; refreshes state and returns the outcome. */\n    requestPersist: () => Promise<boolean>;\n}\n\n/**\n * Track the origin's storage usage, quota and persistence flag, refreshing on\n * demand. Pair with {@link requestPersistentStorage} to surface a \"usando X de\n * Y MB\" meter and a \"tornar armazenamento permanente\" action.\n *\n * @param options - `pollMs` re-reads the estimate on an interval (`0` = off,\n *   the default).\n * @returns The reactive storage state and actions.\n *\n * @example\n * const { usage, quota, ratio, persisted, requestPersist } = useStorageEstimate();\n * return <Meter value={ratio ?? 0} onClick={requestPersist} />;\n */\nexport function useStorageEstimate(options: { pollMs?: number } = {}): UseStorageEstimateResult {\n    const { pollMs = 0 } = options;\n    const [supported] = useState<boolean>(() => storageManagerAvailable());\n    const [usage, setUsage] = useState<number | null>(null);\n    const [quota, setQuota] = useState<number | null>(null);\n    const [persisted, setPersisted] = useState<boolean | null>(null);\n    const [loading, setLoading] = useState<boolean>(supported);\n\n    const refresh = useCallback(async () => {\n        if (!supported) return;\n        setLoading(true);\n        try {\n            const estimate = await estimateStorage();\n            setUsage(estimate.usage);\n            setQuota(estimate.quota);\n            if (typeof navigator.storage?.persisted === \"function\") {\n                setPersisted(await navigator.storage.persisted());\n            }\n        } finally {\n            setLoading(false);\n        }\n    }, [supported]);\n\n    const requestPersist = useCallback(async () => {\n        const granted = await requestPersistentStorage();\n        await refresh();\n        setPersisted(granted);\n        return granted;\n    }, [refresh]);\n\n    useEffect(() => {\n        void refresh();\n    }, [refresh]);\n\n    useEffect(() => {\n        if (pollMs <= 0 || !supported || typeof window === \"undefined\") return;\n        const id = window.setInterval(() => {\n            void refresh();\n        }, pollMs);\n        return () => window.clearInterval(id);\n    }, [pollMs, supported, refresh]);\n\n    const ratio = usage !== null && quota !== null && quota > 0 ? usage / quota : null;\n\n    return {\n        supported,\n        usage,\n        quota,\n        ratio,\n        persisted,\n        loading,\n        refresh,\n        requestPersist,\n    };\n}\n"],"mappings":";;AAcA,SAAS,IAAmC;CACxC,OACI,OAAO,YAAc,OACrB,aAAa,aACb,OAAO,UAAU,SAAS,YAAa;AAE/C;AAOA,eAAsB,IAA4C;CAC9D,IAAI,CAAC,EAAwB,GAAG,OAAO;EAAE,OAAO;EAAM,OAAO;CAAK;CAClE,IAAM,IAAW,MAAM,UAAU,QAAQ,SAAS;CAClD,OAAO;EAAE,OAAO,EAAS,SAAS;EAAM,OAAO,EAAS,SAAS;CAAK;AAC1E;AAWA,eAAsB,IAA6C;CAY/D,OAVI,OAAO,YAAc,OACrB,EAAE,aAAa,cACf,OAAO,UAAU,SAAS,WAAY,aAE/B,KAEP,OAAO,UAAU,QAAQ,aAAc,cAEnC,MADkB,UAAU,QAAQ,UAAU,IAC9B,KAEjB,UAAU,QAAQ,QAAQ;AACrC;AA+BA,SAAgB,EAAmB,IAA+B,CAAC,GAA6B;CAC5F,IAAM,EAAE,YAAS,MAAM,GACjB,CAAC,KAAa,QAAwB,EAAwB,CAAC,GAC/D,CAAC,GAAO,KAAY,EAAwB,IAAI,GAChD,CAAC,GAAO,KAAY,EAAwB,IAAI,GAChD,CAAC,GAAW,KAAgB,EAAyB,IAAI,GACzD,CAAC,GAAS,KAAc,EAAkB,CAAS,GAEnD,IAAU,EAAY,YAAY;EAC/B,OACL;KAAW,EAAI;GACf,IAAI;IACA,IAAM,IAAW,MAAM,EAAgB;IAGvC,AAFA,EAAS,EAAS,KAAK,GACvB,EAAS,EAAS,KAAK,GACnB,OAAO,UAAU,SAAS,aAAc,cACxC,EAAa,MAAM,UAAU,QAAQ,UAAU,CAAC;GAExD,UAAU;IACN,EAAW,EAAK;GACpB;EAVe;CAWnB,GAAG,CAAC,CAAS,CAAC,GAER,IAAiB,EAAY,YAAY;EAC3C,IAAM,IAAU,MAAM,EAAyB;EAG/C,OAFA,MAAM,EAAQ,GACd,EAAa,CAAO,GACb;CACX,GAAG,CAAC,CAAO,CAAC;CAgBZ,OAdA,QAAgB;EACZ,EAAa;CACjB,GAAG,CAAC,CAAO,CAAC,GAEZ,QAAgB;EACZ,IAAI,KAAU,KAAK,CAAC,KAAa,OAAO,SAAW,KAAa;EAChE,IAAM,IAAK,OAAO,kBAAkB;GAChC,EAAa;EACjB,GAAG,CAAM;EACT,aAAa,OAAO,cAAc,CAAE;CACxC,GAAG;EAAC;EAAQ;EAAW;CAAO,CAAC,GAIxB;EACH;EACA;EACA;EACA,OANU,MAAU,QAAQ,MAAU,QAAQ,IAAQ,IAAI,IAAQ,IAAQ;EAO1E;EACA;EACA;EACA;CACJ;AACJ"}
+{"version":3,"file":"use-storage-estimate.js","names":["storageManagerAvailable","estimateStorage","estimate","requestPersistentStorage","useStorageEstimate","options","supported","useState","usage","setUsage","quota","setQuota","persisted","setPersisted","loading","setLoading","refresh","useCallback","requestPersist","granted","useEffect","pollMs","id"],"sources":["../../src/hooks/use-storage-estimate.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** Raw usage/quota reading from the Storage API, in bytes. */\nexport interface StorageEstimate {\n    /** Bytes currently used by this origin, or `null` when unknown. */\n    usage: number | null;\n    /** Total bytes available to this origin, or `null` when unknown. */\n    quota: number | null;\n}\n\n/**\n * `true` when `navigator.storage` exposes the estimate/persist APIs. Guards\n * every call so the helpers stay safe under SSR and older browsers.\n */\nfunction storageManagerAvailable(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        \"storage\" in navigator &&\n        typeof navigator.storage?.estimate === \"function\"\n    );\n}\n\n/**\n * Read the origin's current storage usage and quota.\n *\n * @returns The estimate, or `{ usage: null, quota: null }` when unsupported.\n */\nexport async function estimateStorage(): Promise<StorageEstimate> {\n    if (!storageManagerAvailable()) return { usage: null, quota: null };\n    const estimate = await navigator.storage.estimate();\n    return { usage: estimate.usage ?? null, quota: estimate.quota ?? null };\n}\n\n/**\n * Ask the browser to make this origin's storage persistent, so IndexedDB and\n * the Cache Storage are not silently evicted under disk pressure — essential\n * for durable offline-first data.\n *\n * The browser may grant silently, prompt, or deny based on engagement heuristics.\n *\n * @returns `true` when storage is (now or already) persisted, else `false`.\n */\nexport async function requestPersistentStorage(): Promise<boolean> {\n    if (\n        typeof navigator === \"undefined\" ||\n        !(\"storage\" in navigator) ||\n        typeof navigator.storage?.persist !== \"function\"\n    ) {\n        return false;\n    }\n    if (typeof navigator.storage.persisted === \"function\") {\n        const already = await navigator.storage.persisted();\n        if (already) return true;\n    }\n    return navigator.storage.persist();\n}\n\n/** Reactive storage-quota state exposed by {@link useStorageEstimate}. */\nexport interface UseStorageEstimateResult extends StorageEstimate {\n    /** `true` when the Storage API is available. */\n    supported: boolean;\n    /** `usage / quota` in `[0, 1]`, or `null` when either value is unknown. */\n    ratio: number | null;\n    /** Whether storage is persisted, `null` before the first read / unsupported. */\n    persisted: boolean | null;\n    /** `true` during the initial read or a `refresh`. */\n    loading: boolean;\n    /** Re-read usage/quota and the persisted flag from the browser. */\n    refresh: () => Promise<void>;\n    /** Request persistent storage; refreshes state and returns the outcome. */\n    requestPersist: () => Promise<boolean>;\n}\n\n/**\n * Track the origin's storage usage, quota and persistence flag, refreshing on\n * demand. Pair with {@link requestPersistentStorage} to surface a \"usando X de\n * Y MB\" meter and a \"tornar armazenamento permanente\" action.\n *\n * @param options - `pollMs` re-reads the estimate on an interval (`0` = off,\n *   the default).\n * @returns The reactive storage state and actions.\n *\n * @example\n * const { usage, quota, ratio, persisted, requestPersist } = useStorageEstimate();\n * return <Meter value={ratio ?? 0} onClick={requestPersist} />;\n */\nexport function useStorageEstimate(options: { pollMs?: number } = {}): UseStorageEstimateResult {\n    const { pollMs = 0 } = options;\n    const [supported] = useState<boolean>(() => storageManagerAvailable());\n    const [usage, setUsage] = useState<number | null>(null);\n    const [quota, setQuota] = useState<number | null>(null);\n    const [persisted, setPersisted] = useState<boolean | null>(null);\n    const [loading, setLoading] = useState<boolean>(supported);\n\n    const refresh = useCallback(async () => {\n        if (!supported) return;\n        setLoading(true);\n        try {\n            const estimate = await estimateStorage();\n            setUsage(estimate.usage);\n            setQuota(estimate.quota);\n            if (typeof navigator.storage?.persisted === \"function\") {\n                setPersisted(await navigator.storage.persisted());\n            }\n        } finally {\n            setLoading(false);\n        }\n    }, [supported]);\n\n    const requestPersist = useCallback(async () => {\n        const granted = await requestPersistentStorage();\n        await refresh();\n        setPersisted(granted);\n        return granted;\n    }, [refresh]);\n\n    useEffect(() => {\n        void refresh();\n    }, [refresh]);\n\n    useEffect(() => {\n        if (pollMs <= 0 || !supported || typeof window === \"undefined\") return;\n        const id = window.setInterval(() => {\n            void refresh();\n        }, pollMs);\n        return () => window.clearInterval(id);\n    }, [pollMs, supported, refresh]);\n\n    const ratio = usage !== null && quota !== null && quota > 0 ? usage / quota : null;\n\n    return {\n        supported,\n        usage,\n        quota,\n        ratio,\n        persisted,\n        loading,\n        refresh,\n        requestPersist,\n    };\n}\n"],"mappings":";;AAcA,SAASA,IAAmC;CACxC,OACI,OAAO,YAAc,OACrB,aAAa,aACb,OAAO,UAAU,SAAS,YAAa;AAE/C;AAOA,eAAsBC,IAA4C;CAC9D,IAAI,CAACD,EAAwB,GAAG,OAAO;EAAE,OAAO;EAAM,OAAO;CAAK;CAClE,IAAME,IAAW,MAAM,UAAU,QAAQ,SAAS;CAClD,OAAO;EAAE,OAAOA,EAAS,SAAS;EAAM,OAAOA,EAAS,SAAS;CAAK;AAC1E;AAWA,eAAsBC,IAA6C;CAY/D,OAVI,OAAO,YAAc,OACrB,EAAE,aAAa,cACf,OAAO,UAAU,SAAS,WAAY,aAE/B,KAEP,OAAO,UAAU,QAAQ,aAAc,cAEnC,MADkB,UAAU,QAAQ,UAAU,IAC9B,KAEjB,UAAU,QAAQ,QAAQ;AACrC;AA+BA,SAAgBC,EAAmB,IAA+B,CAAC,GAA6B;CAC5F,IAAM,EAAE,YAAS,MAAMC,GACjB,CAACC,KAAaC,QAAwBP,EAAwB,CAAC,GAC/D,CAACQ,GAAOC,KAAYF,EAAwB,IAAI,GAChD,CAACG,GAAOC,KAAYJ,EAAwB,IAAI,GAChD,CAACK,GAAWC,KAAgBN,EAAyB,IAAI,GACzD,CAACO,GAASC,KAAcR,EAAkBD,CAAS,GAEnDU,IAAUC,EAAY,YAAY;EACpC,IAAKX,GACL;KAAW,EAAI;GACf,IAAI;IACA,IAAMJ,IAAW,MAAMD,EAAgB;IAGvC,AAFAQ,EAASP,EAAS,KAAK,GACvBS,EAAST,EAAS,KAAK,GACnB,OAAO,UAAU,SAAS,aAAc,cACxCW,EAAa,MAAM,UAAU,QAAQ,UAAU,CAAC;GAExD,UAAU;IACN,EAAW,EAAK;GACpB;EAVe;CAWnB,GAAG,CAACP,CAAS,CAAC,GAERY,IAAiBD,EAAY,YAAY;EAC3C,IAAME,IAAU,MAAMhB,EAAyB;EAG/C,OAFA,MAAMa,EAAQ,GACdH,EAAaM,CAAO,GACbA;CACX,GAAG,CAACH,CAAO,CAAC;CAgBZ,OAdAI,QAAgB;EACZ,EAAa;CACjB,GAAG,CAACJ,CAAO,CAAC,GAEZI,QAAgB;EACZ,IAAIC,KAAU,KAAK,CAACf,KAAa,OAAO,SAAW,KAAa;EAChE,IAAMgB,IAAK,OAAO,kBAAkB;GAChC,EAAa;EACjB,GAAGD,CAAM;EACT,aAAa,OAAO,cAAcC,CAAE;CACxC,GAAG;EAACD;EAAQf;EAAWU;CAAO,CAAC,GAIxB;EACH;EACA;EACA;EACA,OANUR,MAAU,QAAQE,MAAU,QAAQA,IAAQ,IAAIF,IAAQE,IAAQ;EAO1E;EACA;EACA;EACA;CACJ;AACJ"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-throttle.cjs","names":[],"sources":["../../src/hooks/use-throttle.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\n/**\n * Return a value that updates at most once every `delay` ms. Complements\n * `useDebounce` — throttle emits on the leading edge and again after the\n * interval; debounce only emits after a period of stillness.\n *\n * @example\n * const throttledScroll = useThrottle(scrollY, 100);\n */\nexport function useThrottle<T>(value: T, delay: number): T {\n    const [throttled, setThrottled] = useState<T>(value);\n    const lastEmitRef = useRef<number>(0);\n    const pendingRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    useEffect(() => {\n        const now = Date.now();\n        const elapsed = now - lastEmitRef.current;\n        if (elapsed >= delay) {\n            lastEmitRef.current = now;\n            setThrottled(value);\n        } else {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n            pendingRef.current = setTimeout(() => {\n                lastEmitRef.current = Date.now();\n                setThrottled(value);\n            }, delay - elapsed);\n        }\n        return () => {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n        };\n    }, [value, delay]);\n\n    return throttled;\n}\n"],"mappings":"uBAUA,SAAgB,EAAe,EAAU,EAAkB,CACvD,GAAM,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAY,CAAK,EAC7C,GAAA,EAAc,EAAA,OAAA,CAAe,CAAC,EAC9B,GAAA,EAAa,EAAA,OAAA,CAA6C,IAAI,EAoBpE,OAlBA,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAM,KAAK,IAAI,EACf,EAAU,EAAM,EAAY,QAWlC,OAVI,GAAW,GACX,EAAY,QAAU,EACtB,EAAa,CAAK,IAEd,EAAW,SAAS,aAAa,EAAW,OAAO,EACvD,EAAW,QAAU,eAAiB,CAClC,EAAY,QAAU,KAAK,IAAI,EAC/B,EAAa,CAAK,CACtB,EAAG,EAAQ,CAAO,OAET,CACL,EAAW,SAAS,aAAa,EAAW,OAAO,CAC3D,CACJ,EAAG,CAAC,EAAO,CAAK,CAAC,EAEV,CACX"}
+{"version":3,"file":"use-throttle.cjs","names":["useState","useRef","react","useThrottle","throttled","setThrottled","value","lastEmitRef","pendingRef","now","elapsed","delay"],"sources":["../../src/hooks/use-throttle.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\n/**\n * Return a value that updates at most once every `delay` ms. Complements\n * `useDebounce` — throttle emits on the leading edge and again after the\n * interval; debounce only emits after a period of stillness.\n *\n * @example\n * const throttledScroll = useThrottle(scrollY, 100);\n */\nexport function useThrottle<T>(value: T, delay: number): T {\n    const [throttled, setThrottled] = useState<T>(value);\n    const lastEmitRef = useRef<number>(0);\n    const pendingRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    useEffect(() => {\n        const now = Date.now();\n        const elapsed = now - lastEmitRef.current;\n        if (elapsed >= delay) {\n            lastEmitRef.current = now;\n            setThrottled(value);\n        } else {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n            pendingRef.current = setTimeout(() => {\n                lastEmitRef.current = Date.now();\n                setThrottled(value);\n            }, delay - elapsed);\n        }\n        return () => {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n        };\n    }, [value, delay]);\n\n    return throttled;\n}\n"],"mappings":"A,uBAUA,SAAgBG,EAAe,EAAU,EAAkB,CACvD,GAAM,CAACC,EAAWC,IAAA,EAAgBL,EAAAA,SAAAA,CAAYM,CAAK,EAC7CC,GAAA,EAAcN,EAAAA,OAAAA,CAAe,CAAC,EAC9BO,GAAA,EAAaP,EAAAA,OAAAA,CAA6C,IAAI,EAoBpE,OAlBA,EAAAC,EAAA,UAAA,KAAgB,CACZ,IAAMO,EAAM,KAAK,IAAI,EACfC,EAAUD,EAAMF,EAAY,QAWlC,OAVIG,GAAWC,GACX,EAAY,QAAUF,EACtBJ,EAAaC,CAAK,IAEdE,EAAW,SAAS,aAAaA,EAAW,OAAO,EACvD,EAAW,QAAU,eAAiB,CAClC,EAAY,QAAU,KAAK,IAAI,EAC/BH,EAAaC,CAAK,CACtB,EAAGK,EAAQD,CAAO,OAET,CACLF,EAAW,SAAS,aAAaA,EAAW,OAAO,CAC3D,CACJ,EAAG,CAACF,EAAOK,CAAK,CAAC,EAEVP,CACX,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-throttle.js","names":[],"sources":["../../src/hooks/use-throttle.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\n/**\n * Return a value that updates at most once every `delay` ms. Complements\n * `useDebounce` — throttle emits on the leading edge and again after the\n * interval; debounce only emits after a period of stillness.\n *\n * @example\n * const throttledScroll = useThrottle(scrollY, 100);\n */\nexport function useThrottle<T>(value: T, delay: number): T {\n    const [throttled, setThrottled] = useState<T>(value);\n    const lastEmitRef = useRef<number>(0);\n    const pendingRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    useEffect(() => {\n        const now = Date.now();\n        const elapsed = now - lastEmitRef.current;\n        if (elapsed >= delay) {\n            lastEmitRef.current = now;\n            setThrottled(value);\n        } else {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n            pendingRef.current = setTimeout(() => {\n                lastEmitRef.current = Date.now();\n                setThrottled(value);\n            }, delay - elapsed);\n        }\n        return () => {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n        };\n    }, [value, delay]);\n\n    return throttled;\n}\n"],"mappings":";;AAUA,SAAgB,EAAe,GAAU,GAAkB;CACvD,IAAM,CAAC,GAAW,KAAgB,EAAY,CAAK,GAC7C,IAAc,EAAe,CAAC,GAC9B,IAAa,EAA6C,IAAI;CAoBpE,OAlBA,QAAgB;EACZ,IAAM,IAAM,KAAK,IAAI,GACf,IAAU,IAAM,EAAY;EAWlC,OAVI,KAAW,KACX,EAAY,UAAU,GACtB,EAAa,CAAK,MAEd,EAAW,WAAS,aAAa,EAAW,OAAO,GACvD,EAAW,UAAU,iBAAiB;GAElC,AADA,EAAY,UAAU,KAAK,IAAI,GAC/B,EAAa,CAAK;EACtB,GAAG,IAAQ,CAAO,UAET;GACT,AAAI,EAAW,WAAS,aAAa,EAAW,OAAO;EAC3D;CACJ,GAAG,CAAC,GAAO,CAAK,CAAC,GAEV;AACX"}
+{"version":3,"file":"use-throttle.js","names":["useThrottle","throttled","setThrottled","useState","value","lastEmitRef","useRef","pendingRef","useEffect","now","elapsed","delay"],"sources":["../../src/hooks/use-throttle.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\n/**\n * Return a value that updates at most once every `delay` ms. Complements\n * `useDebounce` — throttle emits on the leading edge and again after the\n * interval; debounce only emits after a period of stillness.\n *\n * @example\n * const throttledScroll = useThrottle(scrollY, 100);\n */\nexport function useThrottle<T>(value: T, delay: number): T {\n    const [throttled, setThrottled] = useState<T>(value);\n    const lastEmitRef = useRef<number>(0);\n    const pendingRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    useEffect(() => {\n        const now = Date.now();\n        const elapsed = now - lastEmitRef.current;\n        if (elapsed >= delay) {\n            lastEmitRef.current = now;\n            setThrottled(value);\n        } else {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n            pendingRef.current = setTimeout(() => {\n                lastEmitRef.current = Date.now();\n                setThrottled(value);\n            }, delay - elapsed);\n        }\n        return () => {\n            if (pendingRef.current) clearTimeout(pendingRef.current);\n        };\n    }, [value, delay]);\n\n    return throttled;\n}\n"],"mappings":";;AAUA,SAAgBA,EAAe,GAAU,GAAkB;CACvD,IAAM,CAACC,GAAWC,KAAgBC,EAAYC,CAAK,GAC7CC,IAAcC,EAAe,CAAC,GAC9BC,IAAaD,EAA6C,IAAI;CAoBpE,OAlBAE,QAAgB;EACZ,IAAMC,IAAM,KAAK,IAAI,GACfC,IAAUD,IAAMJ,EAAY;EAWlC,OAVIK,KAAWC,KACX,EAAY,UAAUF,GACtBP,EAAaE,CAAK,MAEdG,EAAW,WAAS,aAAaA,EAAW,OAAO,GACvD,EAAW,UAAU,iBAAiB;GAElC,AADA,EAAY,UAAU,KAAK,IAAI,GAC/BL,EAAaE,CAAK;EACtB,GAAGO,IAAQD,CAAO,UAET;GACT,AAAIH,EAAW,WAAS,aAAaA,EAAW,OAAO;EAC3D;CACJ,GAAG,CAACH,GAAOO,CAAK,CAAC,GAEVV;AACX"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-timeout.cjs","names":[],"sources":["../../src/hooks/use-timeout.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Run a callback after `delay` ms. Pass `null` to disable. Resets when\n * `delay` changes; the callback ref always points at the latest closure.\n *\n * @example\n * useTimeout(() => setShow(false), show ? 3000 : null);\n */\nexport function useTimeout(fn: () => void, delay: number | null): void {\n    const fnRef = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setTimeout(() => fnRef.current(), delay);\n        return () => clearTimeout(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":"+DAUA,SAAgB,EAAW,EAAgB,EAA4B,CACnE,IAAM,EAAQ,EAAA,aAAa,CAAE,GAE7B,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,IAAU,KAAM,OACpB,IAAM,EAAK,eAAiB,EAAM,QAAQ,EAAG,CAAK,EAClD,UAAa,aAAa,CAAE,CAChC,EAAG,CAAC,EAAO,CAAK,CAAC,CACrB"}
+{"version":3,"file":"use-timeout.cjs","names":["useLatestRef","require_use_latest_ref","react","useTimeout","fnRef","fn","delay","id"],"sources":["../../src/hooks/use-timeout.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Run a callback after `delay` ms. Pass `null` to disable. Resets when\n * `delay` changes; the callback ref always points at the latest closure.\n *\n * @example\n * useTimeout(() => setShow(false), show ? 3000 : null);\n */\nexport function useTimeout(fn: () => void, delay: number | null): void {\n    const fnRef = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setTimeout(() => fnRef.current(), delay);\n        return () => clearTimeout(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":"A,+DAUA,SAAgBG,EAAW,EAAgB,EAA4B,CACnE,IAAMC,EAAQJ,EAAAA,aAAaK,CAAE,GAE7B,EAAAH,EAAA,UAAA,KAAgB,CACZ,GAAII,IAAU,KAAM,OACpB,IAAMC,EAAK,eAAiBH,EAAM,QAAQ,EAAGE,CAAK,EAClD,UAAa,aAAaC,CAAE,CAChC,EAAG,CAACD,EAAOF,CAAK,CAAC,CACrB,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-timeout.js","names":[],"sources":["../../src/hooks/use-timeout.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Run a callback after `delay` ms. Pass `null` to disable. Resets when\n * `delay` changes; the callback ref always points at the latest closure.\n *\n * @example\n * useTimeout(() => setShow(false), show ? 3000 : null);\n */\nexport function useTimeout(fn: () => void, delay: number | null): void {\n    const fnRef = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setTimeout(() => fnRef.current(), delay);\n        return () => clearTimeout(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":";;;AAUA,SAAgB,EAAW,GAAgB,GAA4B;CACnE,IAAM,IAAQ,EAAa,CAAE;CAE7B,QAAgB;EACZ,IAAI,MAAU,MAAM;EACpB,IAAM,IAAK,iBAAiB,EAAM,QAAQ,GAAG,CAAK;EAClD,aAAa,aAAa,CAAE;CAChC,GAAG,CAAC,GAAO,CAAK,CAAC;AACrB"}
+{"version":3,"file":"use-timeout.js","names":["useTimeout","fnRef","useLatestRef","fn","delay","id"],"sources":["../../src/hooks/use-timeout.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\n/**\n * Run a callback after `delay` ms. Pass `null` to disable. Resets when\n * `delay` changes; the callback ref always points at the latest closure.\n *\n * @example\n * useTimeout(() => setShow(false), show ? 3000 : null);\n */\nexport function useTimeout(fn: () => void, delay: number | null): void {\n    const fnRef = useLatestRef(fn);\n\n    useEffect(() => {\n        if (delay === null) return;\n        const id = setTimeout(() => fnRef.current(), delay);\n        return () => clearTimeout(id);\n    }, [delay, fnRef]);\n}\n"],"mappings":";;;AAUA,SAAgBA,EAAW,GAAgB,GAA4B;CACnE,IAAMC,IAAQC,EAAaC,CAAE;CAE7B,QAAgB;EACZ,IAAIC,MAAU,MAAM;EACpB,IAAMC,IAAK,iBAAiBJ,EAAM,QAAQ,GAAGG,CAAK;EAClD,aAAa,aAAaC,CAAE;CAChC,GAAG,CAACD,GAAOH,CAAK,CAAC;AACrB"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-toggle.cjs","names":[],"sources":["../../src/hooks/use-toggle.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\n\nexport interface ToggleHelpers {\n    toggle: () => void;\n    setTrue: () => void;\n    setFalse: () => void;\n    set: (next: boolean) => void;\n}\n\n/**\n * Boolean state with `toggle`/`setTrue`/`setFalse` helpers.\n *\n * @param initial - initial value (default `false`).\n * @returns Tuple `[value, helpers]`.\n */\nexport function useToggle(initial = false): [boolean, ToggleHelpers] {\n    const [value, setValue] = useState<boolean>(initial);\n\n    const toggle = useCallback((): void => setValue((current) => !current), []);\n    const setTrue = useCallback((): void => setValue(true), []);\n    const setFalse = useCallback((): void => setValue(false), []);\n    const set = useCallback((next: boolean): void => setValue(next), []);\n\n    return [value, { toggle, setTrue, setFalse, set }];\n}\n"],"mappings":"uBAeA,SAAgB,EAAU,EAAU,GAAiC,CACjE,GAAM,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAAkB,CAAO,EAOnD,MAAO,CAAC,EAAO,CAAE,QAAA,EALF,EAAA,YAAA,KAAwB,EAAU,GAAY,CAAC,CAAO,EAAG,CAAC,CAKxD,EAAQ,SAAA,EAJT,EAAA,YAAA,KAAwB,EAAS,EAAI,EAAG,CAAC,CAIhC,EAAS,UAAA,EAHjB,EAAA,YAAA,KAAwB,EAAS,EAAK,EAAG,CAAC,CAGzB,EAAU,KAAA,EAFhC,EAAA,YAAA,CAAa,GAAwB,EAAS,CAAI,EAAG,CAAC,CAEtB,CAAI,CAAC,CACrD"}
+{"version":3,"file":"use-toggle.cjs","names":["useState","useCallback","react","useToggle","value","setValue","initial","current","next"],"sources":["../../src/hooks/use-toggle.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\n\nexport interface ToggleHelpers {\n    toggle: () => void;\n    setTrue: () => void;\n    setFalse: () => void;\n    set: (next: boolean) => void;\n}\n\n/**\n * Boolean state with `toggle`/`setTrue`/`setFalse` helpers.\n *\n * @param initial - initial value (default `false`).\n * @returns Tuple `[value, helpers]`.\n */\nexport function useToggle(initial = false): [boolean, ToggleHelpers] {\n    const [value, setValue] = useState<boolean>(initial);\n\n    const toggle = useCallback((): void => setValue((current) => !current), []);\n    const setTrue = useCallback((): void => setValue(true), []);\n    const setFalse = useCallback((): void => setValue(false), []);\n    const set = useCallback((next: boolean): void => setValue(next), []);\n\n    return [value, { toggle, setTrue, setFalse, set }];\n}\n"],"mappings":"A,uBAeA,SAAgBG,EAAU,EAAU,GAAiC,CACjE,GAAM,CAACC,EAAOC,IAAA,EAAYL,EAAAA,SAAAA,CAAkBM,CAAO,EAOnD,MAAO,CAACF,EAAO,CAAE,QAAA,EALFH,EAAAA,YAAAA,KAAwBI,EAAU,GAAY,CAACE,CAAO,EAAG,CAAC,CAKxD,EAAQ,SAAA,EAJTN,EAAAA,YAAAA,KAAwBI,EAAS,EAAI,EAAG,CAAC,CAIhC,EAAS,UAAA,EAHjBJ,EAAAA,YAAAA,KAAwBI,EAAS,EAAK,EAAG,CAAC,CAGzB,EAAU,KAAA,EAFhCJ,EAAAA,YAAAA,CAAa,GAAwBI,EAASG,CAAI,EAAG,CAAC,CAEtB,CAAI,CAAC,CACrD,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-toggle.js","names":[],"sources":["../../src/hooks/use-toggle.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\n\nexport interface ToggleHelpers {\n    toggle: () => void;\n    setTrue: () => void;\n    setFalse: () => void;\n    set: (next: boolean) => void;\n}\n\n/**\n * Boolean state with `toggle`/`setTrue`/`setFalse` helpers.\n *\n * @param initial - initial value (default `false`).\n * @returns Tuple `[value, helpers]`.\n */\nexport function useToggle(initial = false): [boolean, ToggleHelpers] {\n    const [value, setValue] = useState<boolean>(initial);\n\n    const toggle = useCallback((): void => setValue((current) => !current), []);\n    const setTrue = useCallback((): void => setValue(true), []);\n    const setFalse = useCallback((): void => setValue(false), []);\n    const set = useCallback((next: boolean): void => setValue(next), []);\n\n    return [value, { toggle, setTrue, setFalse, set }];\n}\n"],"mappings":";;AAeA,SAAgB,EAAU,IAAU,IAAiC;CACjE,IAAM,CAAC,GAAO,KAAY,EAAkB,CAAO;CAOnD,OAAO,CAAC,GAAO;EAAE,QALF,QAAwB,GAAU,MAAY,CAAC,CAAO,GAAG,CAAC,CAKxD;EAAQ,SAJT,QAAwB,EAAS,EAAI,GAAG,CAAC,CAIhC;EAAS,UAHjB,QAAwB,EAAS,EAAK,GAAG,CAAC,CAGzB;EAAU,KAFhC,GAAa,MAAwB,EAAS,CAAI,GAAG,CAAC,CAEtB;CAAI,CAAC;AACrD"}
+{"version":3,"file":"use-toggle.js","names":["useToggle","value","setValue","useState","initial","useCallback","current","next"],"sources":["../../src/hooks/use-toggle.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\n\nexport interface ToggleHelpers {\n    toggle: () => void;\n    setTrue: () => void;\n    setFalse: () => void;\n    set: (next: boolean) => void;\n}\n\n/**\n * Boolean state with `toggle`/`setTrue`/`setFalse` helpers.\n *\n * @param initial - initial value (default `false`).\n * @returns Tuple `[value, helpers]`.\n */\nexport function useToggle(initial = false): [boolean, ToggleHelpers] {\n    const [value, setValue] = useState<boolean>(initial);\n\n    const toggle = useCallback((): void => setValue((current) => !current), []);\n    const setTrue = useCallback((): void => setValue(true), []);\n    const setFalse = useCallback((): void => setValue(false), []);\n    const set = useCallback((next: boolean): void => setValue(next), []);\n\n    return [value, { toggle, setTrue, setFalse, set }];\n}\n"],"mappings":";;AAeA,SAAgBA,EAAU,IAAU,IAAiC;CACjE,IAAM,CAACC,GAAOC,KAAYC,EAAkBC,CAAO;CAOnD,OAAO,CAACH,GAAO;EAAE,QALFI,QAAwBH,GAAU,MAAY,CAACI,CAAO,GAAG,CAAC,CAKxD;EAAQ,SAJTD,QAAwBH,EAAS,EAAI,GAAG,CAAC,CAIhC;EAAS,UAHjBG,QAAwBH,EAAS,EAAK,GAAG,CAAC,CAGzB;EAAU,KAFhCG,GAAa,MAAwBH,EAASK,CAAI,GAAG,CAAC,CAEtB;CAAI,CAAC;AACrD"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-typewriter.cjs","names":[],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * How far the reveal got is derived rather than stored: a `speedMs` of `0` reads\n * as \"all of it\" without a state write, and `useInterval` pausing on a `null`\n * delay is what stops the timer at the end. Both used to need an effect that\n * cleared its own interval from inside a state updater.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    const revealed = speedMs > 0 ? Math.min(count, safeText.length) : safeText.length;\n\n    useInterval(\n        () => setCount((current) => current + 1),\n        speedMs > 0 && revealed < safeText.length ? speedMs : null,\n    );\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, revealed),\n        isComplete: revealed >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":"6DAuCA,SAAgB,EAAc,EAAc,EAAsC,CAC9E,IAAM,EAAW,GAAQ,GACnB,EAAe,EAAU,EAAI,EAAI,EAAS,OAE1C,CAAC,EAAc,IAAA,EAAmB,EAAA,SAAA,CAAS,CAAQ,EACnD,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAAS,CAAY,EAE3C,IAAiB,IACjB,EAAgB,CAAQ,EACxB,EAAS,CAAY,GAGzB,IAAM,EAAW,EAAU,EAAI,KAAK,IAAI,EAAO,EAAS,MAAM,EAAI,EAAS,OAE3E,EAAA,gBACU,EAAU,GAAY,EAAU,CAAC,EACvC,EAAU,GAAK,EAAW,EAAS,OAAS,EAAU,IAC1D,EAEA,IAAM,GAAA,EAAO,EAAA,YAAA,KAAkB,EAAS,EAAS,MAAM,EAAG,CAAC,EAAS,MAAM,CAAC,EAE3E,MAAO,CACH,cAAe,EAAS,MAAM,EAAG,CAAQ,EACzC,WAAY,GAAY,EAAS,OACjC,MACJ,CACJ"}
+{"version":3,"file":"use-typewriter.cjs","names":["useState","useCallback","require_use_interval","react","useTypewriter","safeText","text","initialCount","speedMs","renderedText","setRenderedText","count","setCount","revealed","current","skip"],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * How far the reveal got is derived rather than stored: a `speedMs` of `0` reads\n * as \"all of it\" without a state write, and `useInterval` pausing on a `null`\n * delay is what stops the timer at the end. Both used to need an effect that\n * cleared its own interval from inside a state updater.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    const revealed = speedMs > 0 ? Math.min(count, safeText.length) : safeText.length;\n\n    useInterval(\n        () => setCount((current) => current + 1),\n        speedMs > 0 && revealed < safeText.length ? speedMs : null,\n    );\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, revealed),\n        isComplete: revealed >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":"A,6DAuCA,SAAgBI,EAAc,EAAc,EAAsC,CAC9E,IAAMC,EAAWC,GAAQ,GACnBC,EAAeC,EAAU,EAAI,EAAIH,EAAS,OAE1C,CAACI,EAAcC,IAAA,EAAmBV,EAAAA,SAAAA,CAASK,CAAQ,EACnD,CAACM,EAAOC,IAAA,EAAYZ,EAAAA,SAAAA,CAASO,CAAY,EAE3CE,IAAiBJ,IACjBK,EAAgBL,CAAQ,EACxBO,EAASL,CAAY,GAGzB,IAAMM,EAAWL,EAAU,EAAI,KAAK,IAAIG,EAAON,EAAS,MAAM,EAAIA,EAAS,OAE3EH,EAAA,gBACUU,EAAU,GAAYE,EAAU,CAAC,EACvCN,EAAU,GAAKK,EAAWR,EAAS,OAASG,EAAU,IAC1D,EAEA,IAAMO,GAAA,EAAOd,EAAAA,YAAAA,KAAkBW,EAASP,EAAS,MAAM,EAAG,CAACA,EAAS,MAAM,CAAC,EAE3E,MAAO,CACH,cAAeA,EAAS,MAAM,EAAGQ,CAAQ,EACzC,WAAYA,GAAYR,EAAS,OACjC,MACJ,CACJ,C"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-typewriter.js","names":[],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * How far the reveal got is derived rather than stored: a `speedMs` of `0` reads\n * as \"all of it\" without a state write, and `useInterval` pausing on a `null`\n * delay is what stops the timer at the end. Both used to need an effect that\n * cleared its own interval from inside a state updater.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    const revealed = speedMs > 0 ? Math.min(count, safeText.length) : safeText.length;\n\n    useInterval(\n        () => setCount((current) => current + 1),\n        speedMs > 0 && revealed < safeText.length ? speedMs : null,\n    );\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, revealed),\n        isComplete: revealed >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":";;;AAuCA,SAAgB,EAAc,GAAc,GAAsC;CAC9E,IAAM,IAAW,KAAQ,IACnB,IAAe,IAAU,IAAI,IAAI,EAAS,QAE1C,CAAC,GAAc,KAAmB,EAAS,CAAQ,GACnD,CAAC,GAAO,KAAY,EAAS,CAAY;CAE/C,AAAI,MAAiB,MACjB,EAAgB,CAAQ,GACxB,EAAS,CAAY;CAGzB,IAAM,IAAW,IAAU,IAAI,KAAK,IAAI,GAAO,EAAS,MAAM,IAAI,EAAS;CAE3E,QACU,GAAU,MAAY,IAAU,CAAC,GACvC,IAAU,KAAK,IAAW,EAAS,SAAS,IAAU,IAC1D;CAEA,IAAM,IAAO,QAAkB,EAAS,EAAS,MAAM,GAAG,CAAC,EAAS,MAAM,CAAC;CAE3E,OAAO;EACH,eAAe,EAAS,MAAM,GAAG,CAAQ;EACzC,YAAY,KAAY,EAAS;EACjC;CACJ;AACJ"}
+{"version":3,"file":"use-typewriter.js","names":["useTypewriter","safeText","text","initialCount","speedMs","renderedText","setRenderedText","useState","count","setCount","revealed","current","skip","useCallback"],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport { useInterval } from \"./use-interval\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * How far the reveal got is derived rather than stored: a `speedMs` of `0` reads\n * as \"all of it\" without a state write, and `useInterval` pausing on a `null`\n * delay is what stops the timer at the end. Both used to need an effect that\n * cleared its own interval from inside a state updater.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    const revealed = speedMs > 0 ? Math.min(count, safeText.length) : safeText.length;\n\n    useInterval(\n        () => setCount((current) => current + 1),\n        speedMs > 0 && revealed < safeText.length ? speedMs : null,\n    );\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, revealed),\n        isComplete: revealed >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":";;;AAuCA,SAAgBA,EAAc,GAAc,GAAsC;CAC9E,IAAMC,IAAWC,KAAQ,IACnBC,IAAeC,IAAU,IAAI,IAAIH,EAAS,QAE1C,CAACI,GAAcC,KAAmBC,EAASN,CAAQ,GACnD,CAACO,GAAOC,KAAYF,EAASJ,CAAY;CAE/C,AAAIE,MAAiBJ,MACjBK,EAAgBL,CAAQ,GACxBQ,EAASN,CAAY;CAGzB,IAAMO,IAAWN,IAAU,IAAI,KAAK,IAAII,GAAOP,EAAS,MAAM,IAAIA,EAAS;CAE3E,QACUQ,GAAU,MAAYE,IAAU,CAAC,GACvCP,IAAU,KAAKM,IAAWT,EAAS,SAASG,IAAU,IAC1D;CAEA,IAAMQ,IAAOC,QAAkBJ,EAASR,EAAS,MAAM,GAAG,CAACA,EAAS,MAAM,CAAC;CAE3E,OAAO;EACH,eAAeA,EAAS,MAAM,GAAGS,CAAQ;EACzC,YAAYA,KAAYT,EAAS;EACjC;CACJ;AACJ"}

package/dist/hooks/use-window-size.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-window-size.cjs","names":[],"sources":["../../src/hooks/use-window-size.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface WindowSize {\n    width: number;\n    height: number;\n}\n\n/**\n * Reactive window dimensions. SSR-safe — returns `{ width: 0, height: 0 }`\n * until the first client render.\n *\n * @example\n * const { width, height } = useWindowSize();\n * const columns = width < 640 ? 1 : width < 1024 ? 2 : 3;\n */\nexport function useWindowSize(): WindowSize {\n    const [size, setSize] = useState<WindowSize>(() =>\n        typeof window === \"undefined\"\n            ? { width: 0, height: 0 }\n            : { width: window.innerWidth, height: window.innerHeight },\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void =>\n            setSize({ width: window.innerWidth, height: window.innerHeight });\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    return size;\n}\n"],"mappings":"uBAeA,SAAgB,GAA4B,CACxC,GAAM,CAAC,EAAM,IAAA,EAAW,EAAA,SAAA,KACpB,OAAO,OAAW,IACZ,CAAE,MAAO,EAAG,OAAQ,CAAE,EACtB,CAAE,MAAO,OAAO,WAAY,OAAQ,OAAO,WAAY,CACjE,EAWA,OATA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,MACF,EAAQ,CAAE,MAAO,OAAO,WAAY,OAAQ,OAAO,WAAY,CAAC,EAGpE,OAFA,EAAS,EACT,OAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,MAChD,OAAO,oBAAoB,SAAU,CAAQ,CAC9D,EAAG,CAAC,CAAC,EAEE,CACX"}
+{"version":3,"file":"use-window-size.cjs","names":["useState","react","useWindowSize","size","setSize","onResize"],"sources":["../../src/hooks/use-window-size.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface WindowSize {\n    width: number;\n    height: number;\n}\n\n/**\n * Reactive window dimensions. SSR-safe — returns `{ width: 0, height: 0 }`\n * until the first client render.\n *\n * @example\n * const { width, height } = useWindowSize();\n * const columns = width < 640 ? 1 : width < 1024 ? 2 : 3;\n */\nexport function useWindowSize(): WindowSize {\n    const [size, setSize] = useState<WindowSize>(() =>\n        typeof window === \"undefined\"\n            ? { width: 0, height: 0 }\n            : { width: window.innerWidth, height: window.innerHeight },\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void =>\n            setSize({ width: window.innerWidth, height: window.innerHeight });\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    return size;\n}\n"],"mappings":"A,uBAeA,SAAgBE,GAA4B,CACxC,GAAM,CAACC,EAAMC,IAAA,EAAWJ,EAAAA,SAAAA,KACpB,OAAO,OAAW,IACZ,CAAE,MAAO,EAAG,OAAQ,CAAE,EACtB,CAAE,MAAO,OAAO,WAAY,OAAQ,OAAO,WAAY,CACjE,EAWA,OATA,EAAAC,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAMI,MACFD,EAAQ,CAAE,MAAO,OAAO,WAAY,OAAQ,OAAO,WAAY,CAAC,EAGpE,OAFAC,EAAS,EACT,OAAO,iBAAiB,SAAUA,EAAU,CAAE,QAAS,EAAK,CAAC,MAChD,OAAO,oBAAoB,SAAUA,CAAQ,CAC9D,EAAG,CAAC,CAAC,EAEEF,CACX,C"}

package/dist/hooks/use-window-size.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-window-size.js","names":[],"sources":["../../src/hooks/use-window-size.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface WindowSize {\n    width: number;\n    height: number;\n}\n\n/**\n * Reactive window dimensions. SSR-safe — returns `{ width: 0, height: 0 }`\n * until the first client render.\n *\n * @example\n * const { width, height } = useWindowSize();\n * const columns = width < 640 ? 1 : width < 1024 ? 2 : 3;\n */\nexport function useWindowSize(): WindowSize {\n    const [size, setSize] = useState<WindowSize>(() =>\n        typeof window === \"undefined\"\n            ? { width: 0, height: 0 }\n            : { width: window.innerWidth, height: window.innerHeight },\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void =>\n            setSize({ width: window.innerWidth, height: window.innerHeight });\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    return size;\n}\n"],"mappings":";;AAeA,SAAgB,IAA4B;CACxC,IAAM,CAAC,GAAM,KAAW,QACpB,OAAO,SAAW,MACZ;EAAE,OAAO;EAAG,QAAQ;CAAE,IACtB;EAAE,OAAO,OAAO;EAAY,QAAQ,OAAO;CAAY,CACjE;CAWA,OATA,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,UACF,EAAQ;GAAE,OAAO,OAAO;GAAY,QAAQ,OAAO;EAAY,CAAC;EAGpE,OAFA,EAAS,GACT,OAAO,iBAAiB,UAAU,GAAU,EAAE,SAAS,GAAK,CAAC,SAChD,OAAO,oBAAoB,UAAU,CAAQ;CAC9D,GAAG,CAAC,CAAC,GAEE;AACX"}
+{"version":3,"file":"use-window-size.js","names":["useWindowSize","size","setSize","useState","useEffect","onResize"],"sources":["../../src/hooks/use-window-size.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport interface WindowSize {\n    width: number;\n    height: number;\n}\n\n/**\n * Reactive window dimensions. SSR-safe — returns `{ width: 0, height: 0 }`\n * until the first client render.\n *\n * @example\n * const { width, height } = useWindowSize();\n * const columns = width < 640 ? 1 : width < 1024 ? 2 : 3;\n */\nexport function useWindowSize(): WindowSize {\n    const [size, setSize] = useState<WindowSize>(() =>\n        typeof window === \"undefined\"\n            ? { width: 0, height: 0 }\n            : { width: window.innerWidth, height: window.innerHeight },\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void =>\n            setSize({ width: window.innerWidth, height: window.innerHeight });\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    return size;\n}\n"],"mappings":";;AAeA,SAAgBA,IAA4B;CACxC,IAAM,CAACC,GAAMC,KAAWC,QACpB,OAAO,SAAW,MACZ;EAAE,OAAO;EAAG,QAAQ;CAAE,IACtB;EAAE,OAAO,OAAO;EAAY,QAAQ,OAAO;CAAY,CACjE;CAWA,OATAC,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAMC,UACFH,EAAQ;GAAE,OAAO,OAAO;GAAY,QAAQ,OAAO;EAAY,CAAC;EAGpE,OAFAG,EAAS,GACT,OAAO,iBAAiB,UAAUA,GAAU,EAAE,SAAS,GAAK,CAAC,SAChD,OAAO,oBAAoB,UAAUA,CAAQ;CAC9D,GAAG,CAAC,CAAC,GAEEJ;AACX"}

package/dist/http/api-client.cjs

@@ -1,2 +1,2 @@
-const e=require("../utils/ids.cjs"),t=require("./build-url.cjs"),n=require("./credential-scope.cjs"),r=require("./csrf.cjs"),i=require("./decode-response.cjs"),a=require("./errors.cjs"),o=require("./retry.cjs"),s=require("./timeout.cjs");var c=new Set([`GET`,`HEAD`,`OPTIONS`]);function l(e,t){return!c.has(t)||!(e instanceof a.TempestApiError)?!1:a.isRetriableStatus(e.status)}function u(e){return e?e===!0?{}:e:null}var d=15e3,f=3e5;function p(e){return typeof FormData<`u`&&e instanceof FormData}function m(e){return Math.round(performance.now()-e)}async function h(e,t){let n;try{n=await e.clone().json()}catch{try{n=await e.text()}catch{n=null}}return new a.TempestApiError(a.buildApiError(e.status,n,e.headers,t))}function g(c){let g=c.fetcher??globalThis.fetch.bind(globalThis);function _(e,t){if(t)return{};let r=c.getToken?.();return r?n.isTrustedCredentialTarget(e,c.baseURL,c.trustedOrigins)?{Authorization:`Bearer ${r}`}:(n.reportSuppressedCredential(e,c.baseURL),{}):{}}async function v(e,n,i,o){let{body:l,params:u,headers:m,signal:h,timeout:v,...y}=n,b=p(l),x=b?c.uploadTimeout:c.timeout,S=v===void 0?x===void 0?b?f:d:x:v,C=t.buildApiUrl(c.baseURL,e,{prefix:c.prefix,params:u}),w=m,T={...b?{}:{"Content-Type":`application/json`},...i?{"X-Request-ID":i}:{},...c.headers,..._(C,o),...r.csrfHeaders({method:y.method??`GET`,url:C,reference:c.baseURL,csrf:c.csrf,trustedOrigins:c.trustedOrigins,headers:{...c.headers,...w}}),...w},E=s.withTimeout(h,S),D={...y,signal:E.signal,headers:T,credentials:c.withCredentials?`include`:y.credentials,body:l==null?void 0:b?l:JSON.stringify(l)};try{return await g(C,D)}catch(e){throw E.timedOut()?new a.TempestApiError({status:0,detail:`A requisição excedeu ${S}ms e foi abandonada.`}):e}finally{E.dispose()}}async function y(e,t,n,r,i){let a=c.logger;if(!a)return v(e,t,n,i);let o=performance.now();try{let s=await v(e,t,n,i),c={requestId:n,status:s.status,ms:m(o)},l=`${r} ${e} → ${s.status}`;return s.status>=400?a.warn(l,c):a.debug(l,c),s}catch(t){throw a.warn(`${r} ${e} → no response`,{requestId:n,ms:m(o),error:t}),t}}async function b(e,t,n){if(c.onUnauthorized){c.logger?.warn(`unauthorized — calling onUnauthorized`,{requestId:t,status:e.status});try{await c.onUnauthorized(e,n)}catch(n){if(n instanceof a.SessionSupersededError)throw n;c.logger?.warn(`onUnauthorized threw — keeping the original response error`,{requestId:t,status:e.status,error:n})}}}function x(e){return{token:e?null:c.getToken?.()??null,epoch:c.getSessionEpoch?.()??null}}async function S(t,n,r){let{skipAuth:i=!1,skipAuthRetry:o=!1,...s}=n,l=c.requestId?c.requestId():e.randomId(),u=(s.method??`GET`).toUpperCase(),d=x(i),f=await y(t,s,l,u,i);if(f.status===401&&!i&&!o){if(c.refresh){let e;try{await c.refresh(d),e=x(i),f=await y(t,s,l,u,i)}catch(e){throw e instanceof a.SessionSupersededError?e:(await b(f,l,d),await h(f,l))}f.status===401&&await b(f,l,e)}else await b(f,l,d)}if(!f.ok)throw await h(f,l);return r(f)}async function C(e,t,n){let{retry:r,...i}=t,a=u(r===void 0?c.retry:r);if(!a)return S(e,i,n);let s=(i.method??`GET`).toUpperCase();return o.retry(()=>S(e,i,n),{...a,shouldRetry:a.shouldRetry??(e=>l(e,s))})}async function w(e,t={}){return C(e,t,i.decodeByContentType)}async function T(e,t,n=`POST`,r){return w(e,{...r,method:n,body:t})}return{request:w,get:(e,t)=>w(e,{...t,method:`GET`}),post:(e,t)=>w(e,{...t,method:`POST`}),put:(e,t)=>w(e,{...t,method:`PUT`}),patch:(e,t)=>w(e,{...t,method:`PATCH`}),delete:(e,t)=>w(e,{...t,method:`DELETE`}),blob:(e,t)=>C(e,{...t},e=>e.blob()),arrayBuffer:(e,t)=>C(e,{...t},e=>e.arrayBuffer()),upload:T}}exports.createApiClient=g;
+const e=require("../utils/ids.cjs"),t=require("./build-url.cjs"),n=require("./credential-scope.cjs"),r=require("./csrf.cjs"),i=require("./decode-response.cjs"),a=require("./errors.cjs"),o=require("./retry.cjs"),s=require("./timeout.cjs");var c=new Set([`GET`,`HEAD`,`OPTIONS`]);function l(e,t){return!c.has(t)||!(e instanceof a.TempestApiError)?!1:a.isRetriableStatus(e.status)}function u(e){return e?e===!0?{}:e:null}var d=15e3,f=3e5;function p(e){return typeof FormData<`u`&&e instanceof FormData}function m(e){return Math.round(performance.now()-e)}async function h(e,t){let n;try{n=await e.clone().json()}catch{try{n=await e.text()}catch{n=null}}return new a.TempestApiError(a.buildApiError(e.status,n,e.headers,t))}function g(c){let g=c.fetcher??globalThis.fetch.bind(globalThis);function _(e,t){if(t)return{};let r=c.getToken?.();return r?n.isTrustedCredentialTarget(e,c.baseURL,c.trustedOrigins)?{Authorization:`Bearer ${r}`}:(n.reportSuppressedCredential(e,c.baseURL),{}):{}}async function v(e,n,i,o){let{body:l,params:u,headers:m,signal:h,timeout:v,...y}=n,b=p(l),x=b?c.uploadTimeout:c.timeout,S=v===void 0?x===void 0?b?f:d:x:v,C=t.buildApiUrl(c.baseURL,e,{prefix:c.prefix,params:u}),w=m,T={...b?{}:{"Content-Type":`application/json`},...i?{"X-Request-ID":i}:{},...c.headers,..._(C,o),...r.csrfHeaders({method:y.method??`GET`,url:C,reference:c.baseURL,csrf:c.csrf,trustedOrigins:c.trustedOrigins,headers:{...c.headers,...w}}),...w},E=s.withTimeout(h,S),D={...y,signal:E.signal,headers:T,credentials:c.withCredentials?`include`:y.credentials,body:l==null?void 0:b?l:JSON.stringify(l)};try{return await g(C,D)}catch(e){throw E.timedOut()?new a.TempestApiError({status:0,detail:`A requisição excedeu ${S}ms e foi abandonada.`}):e}finally{E.dispose()}}async function y(e,t,n,r,i){let a=c.logger;if(!a)return v(e,t,n,i);let o=performance.now();try{let s=await v(e,t,n,i),c={requestId:n,status:s.status,ms:m(o)},l=`${r} ${e} → ${s.status}`;return s.status>=400?a.warn(l,c):a.debug(l,c),s}catch(t){throw a.warn(`${r} ${e} → no response`,{requestId:n,ms:m(o),error:t}),t}}async function b(e,t,n){if(c.onUnauthorized){c.logger?.warn(`unauthorized — calling onUnauthorized`,{requestId:t,status:e.status});try{await c.onUnauthorized(e,n)}catch(n){if(n instanceof a.SessionSupersededError)throw n;c.logger?.warn(`onUnauthorized threw — keeping the original response error`,{requestId:t,status:e.status,error:n})}}}function x(e){return{token:e?null:c.getToken?.()??null,epoch:c.getSessionEpoch?.()??null}}async function S(t,n,r){let{skipAuth:i=!1,skipAuthRetry:o=!1,...s}=n,l=c.requestId?c.requestId():e.randomId(),u=(s.method??`GET`).toUpperCase(),d=x(i),f=await y(t,s,l,u,i);if(f.status===401&&!i&&!o){if(c.refresh){let e;try{await c.refresh(d),e=x(i),f=await y(t,s,l,u,i)}catch(e){throw e instanceof a.SessionSupersededError?e:(await b(f,l,d),await h(f,l))}f.status===401&&await b(f,l,e)}else await b(f,l,d)}if(!f.ok)throw await h(f,l);return r(f)}async function C(e,t,n){let{retry:r,...i}=t,a=u(r===void 0?c.retry:r);if(!a)return S(e,i,n);let s=(i.method??`GET`).toUpperCase();return o.retry(()=>S(e,i,n),{...a,shouldRetry:a.shouldRetry??(e=>l(e,s))})}async function w(e,t={}){return C(e,t,i.decodeByContentType)}async function T(e,t,n=`POST`,r){return w(e,{...r,method:n,body:t})}return{request:w,get:(e,t)=>w(e,{...t,method:`GET`}),post:(e,t)=>w(e,{...t,method:`POST`}),put:(e,t)=>w(e,{...t,method:`PUT`}),patch:(e,t)=>w(e,{...t,method:`PATCH`}),delete:(e,t)=>w(e,{...t,method:`DELETE`}),blob:(e,t)=>C(e,{...t},e=>e.blob()),arrayBuffer:(e,t)=>C(e,{...t},e=>e.arrayBuffer()),upload:T,url:(e,n)=>t.buildApiUrl(c.baseURL,e,{prefix:c.prefix,params:n})}}exports.createApiClient=g;
 //# sourceMappingURL=api-client.cjs.map

package/dist/http/api-client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.cjs","names":[],"sources":["../../src/http/api-client.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — createApiClient is over the limit and every line\n * is a request-lifecycle concern the client cannot delegate: base URL joining, the\n * auth header, the 401 refresh-and-replay, the opt-in retry wrapper and the response\n * parsing that turns a failure into a typed error.\n */\nimport { randomId } from \"../utils\";\nimport { buildApiUrl } from \"./build-url\";\nimport { isTrustedCredentialTarget, reportSuppressedCredential } from \"./credential-scope\";\nimport { csrfHeaders } from \"./csrf\";\nimport { decodeByContentType } from \"./decode-response\";\nimport type { ResponseDecoder } from \"./decode-response\";\nimport {\n    buildApiError,\n    SessionSupersededError,\n    TempestApiError,\n    isRetriableStatus,\n} from \"./errors\";\nimport { retry as retryWithBackoff } from \"./retry\";\nimport type { RetryOptions } from \"./retry\";\nimport { withTimeout } from \"./timeout\";\nimport type { ApiClient, ApiClientConfig, RequestAuthContext, RequestOptions } from \"./types\";\n\n/**\n * Methods the built-in retry policy will replay.\n *\n * `PUT` and `DELETE` are idempotent on paper but stay out: a backend that logs,\n * bills, or fires a webhook per call still sees two, so replaying them is a\n * decision the caller makes through `shouldRetry`, not a default.\n */\nconst IDEMPOTENT_METHODS: ReadonlySet<string> = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\n/**\n * Sub-500 statuses worth a second attempt: a network failure (status `0`), a\n * request timeout, a too-early replay, and a rate limit — which usually carries\n * the `Retry-After` the backoff already honours.\n */\n\n/**\n * The built-in retry policy, used when `retry` is `true` or is options carrying\n * no `shouldRetry` of their own.\n *\n * Conservative on purpose. Replaying a write can duplicate it, and replaying a\n * `400` or a `403` cannot fix a bad payload or a permission the caller does not\n * have — it only spends the user's time before showing the same error.\n *\n * @param error - Whatever the attempt threw.\n * @param method - The upper-cased HTTP method of the request.\n * @returns Whether the client should try again.\n */\nfunction isRetriableFailure(error: unknown, method: string): boolean {\n    if (!IDEMPOTENT_METHODS.has(method)) return false;\n    if (!(error instanceof TempestApiError)) return false;\n    return isRetriableStatus(error.status);\n}\n\n/**\n * Normalize the `retry` config into options, or `null` when retrying is off.\n *\n * @param config - The `retry` field as the caller wrote it.\n * @returns Retry options to use, or `null` to run a single attempt.\n */\nfunction resolveRetry(config: boolean | RetryOptions | undefined): RetryOptions | null {\n    if (!config) return null;\n    return config === true ? {} : config;\n}\n\n/** Default milliseconds before a request is abandoned. */\nconst DEFAULT_TIMEOUT = 15_000;\n\n/** Default milliseconds before a `FormData` request is abandoned. */\nconst DEFAULT_UPLOAD_TIMEOUT = 300_000;\n\nfunction isFormData(body: unknown): body is FormData {\n    return typeof FormData !== \"undefined\" && body instanceof FormData;\n}\n\n/**\n * Milliseconds since a `performance.now()` reading, rounded.\n *\n * `performance.now()` rather than `Date.now()` because this measures a\n * duration: the wall clock can step sideways mid-request (an NTP correction, a\n * VM resuming, the user changing the clock) and turn a 40 ms call into a\n * negative number. The monotonic clock cannot.\n *\n * @param startedAt - The reading taken before the work started.\n * @returns Whole milliseconds elapsed.\n */\nfunction elapsedMs(startedAt: number): number {\n    return Math.round(performance.now() - startedAt);\n}\n\nasync function parseError(response: Response, sentRequestId?: string): Promise<TempestApiError> {\n    let body: unknown;\n    try {\n        body = await response.clone().json();\n    } catch {\n        try {\n            body = await response.text();\n        } catch {\n            body = null;\n        }\n    }\n    return new TempestApiError(\n        buildApiError(response.status, body, response.headers, sentRequestId),\n    );\n}\n\n/**\n * Create a typed HTTP client backed by `fetch`.\n *\n * Handles JSON serialization, query params, bearer auth via `getToken`, uploads\n * via `FormData`, and throws a typed `ApiError` on any non-2xx response.\n *\n * **Expired sessions.** A `401` with `refresh` configured awaits the refresh and\n * replays the request once. `onUnauthorized` fires whenever that path ends\n * unauthorized anyway — the refresh threw, or the replay came back `401` — which\n * is the signal to clear the session. Without `refresh`, the first `401` calls\n * it directly.\n *\n * **Binary bodies** have their own methods — `blob()` and `arrayBuffer()` — which\n * run the same pipeline and skip the parse. `request()` no longer decodes an\n * unknown `Content-Type` as text either: it returns a `Blob` and says so once in\n * a development build, because reading `image/jpeg` as UTF-8 destroyed the bytes\n * on the way in.\n *\n * **The bearer token is scoped to `baseURL`'s origin** since 0.66.0. A path may\n * be an absolute URL, which overrides the base entirely, so without a scope the\n * destination of a credentialed request could come from a value read off the\n * network. A request to another origin still goes out; it goes without the\n * header, and a development build says so once. Declare the exceptions in\n * {@link ApiClientConfig.trustedOrigins}.\n *\n * **CSRF** is off unless you set `csrf`. With it, every unsafe request (anything\n * but `GET`/`HEAD`/`OPTIONS`/`TRACE`) echoes the `csrf_token` cookie in an\n * `X-CSRF-Token` header — the double-submit contract of `tempest-fastapi-sdk`'s\n * `CSRFMiddleware` — scoped to the same origins as the bearer token and sent on\n * `skipAuth` requests too. See {@link ApiClientConfig.csrf}.\n *\n * **Retries** are off unless you set `retry`. See {@link ApiClientConfig.retry}\n * for the built-in policy; it never replays a write. A single call overrides it\n * with {@link RequestOptions.retry}, and opts out of auth entirely with\n * {@link RequestOptions.skipAuth}.\n *\n * **Logging** is off unless you pass a `logger`. With one, every finished attempt\n * writes a line — `debug` under 400, `warn` from 400 up, plus a `warn` when\n * `onUnauthorized` fires — carrying `requestId`, `status` and elapsed `ms`, and\n * never a body, header or query string. The level and the destination belong to\n * the logger, not to a boolean here.\n *\n * @example\n * const api = createApiClient({\n *     baseURL: import.meta.env.VITE_API_URL,\n *     getToken: () => useAuthStore.getState().token,\n *     refresh,\n *     onUnauthorized: () => useAuthStore.getState().logout(),\n *     logger: createLogger({ level: import.meta.env.DEV ? \"debug\" : \"warn\" }).child(\"http\"),\n *     retry: true,\n * });\n *\n * @param config - Base URL plus the optional auth, retry and fetch hooks.\n * @returns A client with `request`/`get`/`post`/`put`/`patch`/`delete`/`blob`/\n * `arrayBuffer`/`upload`.\n */\nexport function createApiClient(config: ApiClientConfig): ApiClient {\n    const fetcher = config.fetcher ?? globalThis.fetch.bind(globalThis);\n\n    /**\n     * The `Authorization` header for a request, or nothing.\n     *\n     * Takes the resolved URL rather than reading `config.baseURL`, because an\n     * absolute path overrides the base entirely (see `buildApiUrl`) and the\n     * credential is scoped to an origin, not to a client.\n     *\n     * @param url - The absolute URL the request is going to.\n     * @param skipAuth - Whether the caller opted this request out of auth.\n     * @returns The header, or an empty object.\n     */\n    function authHeaders(url: string, skipAuth: boolean): Record<string, string> {\n        if (skipAuth) return {};\n        const token = config.getToken?.();\n        if (!token) return {};\n        if (!isTrustedCredentialTarget(url, config.baseURL, config.trustedOrigins)) {\n            reportSuppressedCredential(url, config.baseURL);\n            return {};\n        }\n        return { Authorization: `Bearer ${token}` };\n    }\n\n    async function rawRequest(\n        path: string,\n        options: RequestOptions,\n        requestId: string | undefined,\n        skipAuth: boolean,\n    ): Promise<Response> {\n        const { body, params, headers, signal, timeout, ...rest } = options;\n        const isForm = isFormData(body);\n        const configured = isForm ? config.uploadTimeout : config.timeout;\n        const fallback = isForm ? DEFAULT_UPLOAD_TIMEOUT : DEFAULT_TIMEOUT;\n        const limit =\n            timeout !== undefined ? timeout : configured !== undefined ? configured : fallback;\n\n        const url = buildApiUrl(config.baseURL, path, { prefix: config.prefix, params });\n\n        const callerHeaders = headers as Record<string, string> | undefined;\n        const finalHeaders: Record<string, string> = {\n            ...(isForm ? {} : { \"Content-Type\": \"application/json\" }),\n            ...(requestId ? { \"X-Request-ID\": requestId } : {}),\n            ...config.headers,\n            ...authHeaders(url, skipAuth),\n            ...csrfHeaders({\n                method: rest.method ?? \"GET\",\n                url,\n                reference: config.baseURL,\n                csrf: config.csrf,\n                trustedOrigins: config.trustedOrigins,\n                headers: { ...config.headers, ...callerHeaders },\n            }),\n            ...callerHeaders,\n        };\n\n        const timed = withTimeout(signal, limit);\n        const init: RequestInit = {\n            ...rest,\n            signal: timed.signal,\n            headers: finalHeaders,\n            credentials: config.withCredentials ? \"include\" : rest.credentials,\n            body:\n                body === undefined || body === null\n                    ? undefined\n                    : isForm\n                      ? (body as FormData)\n                      : JSON.stringify(body),\n        };\n\n        try {\n            return await fetcher(url, init);\n        } catch (cause) {\n            if (timed.timedOut()) {\n                throw new TempestApiError({\n                    status: 0,\n                    detail: `A requisição excedeu ${limit}ms e foi abandonada.`,\n                });\n            }\n            throw cause;\n        } finally {\n            timed.dispose();\n        }\n    }\n\n    async function send(\n        path: string,\n        options: RequestOptions,\n        requestId: string,\n        method: string,\n        skipAuth: boolean,\n    ): Promise<Response> {\n        const log = config.logger;\n        if (!log) return rawRequest(path, options, requestId, skipAuth);\n\n        const startedAt = performance.now();\n        try {\n            const response = await rawRequest(path, options, requestId, skipAuth);\n            const entry = { requestId, status: response.status, ms: elapsedMs(startedAt) };\n            const line = `${method} ${path} → ${response.status}`;\n            if (response.status >= 400) log.warn(line, entry);\n            else log.debug(line, entry);\n            return response;\n        } catch (error) {\n            log.warn(`${method} ${path} → no response`, {\n                requestId,\n                ms: elapsedMs(startedAt),\n                error,\n            });\n            throw error;\n        }\n    }\n\n    /**\n     * Call `onUnauthorized`, keeping the request's own error unless the hook\n     * says the attempt belongs to an ended session.\n     *\n     * @param response - The `401` that ended the attempt.\n     * @param requestId - Correlation id for the log.\n     * @param context - The credential and session the attempt left with.\n     * @throws {SessionSupersededError} When `onUnauthorized` threw it.\n     */\n    async function notifyUnauthorized(\n        response: Response,\n        requestId: string,\n        context: RequestAuthContext,\n    ): Promise<void> {\n        if (!config.onUnauthorized) return;\n        config.logger?.warn(`unauthorized — calling onUnauthorized`, {\n            requestId,\n            status: response.status,\n        });\n        try {\n            await config.onUnauthorized(response, context);\n        } catch (error) {\n            if (error instanceof SessionSupersededError) throw error;\n            config.logger?.warn(`onUnauthorized threw — keeping the original response error`, {\n                requestId,\n                status: response.status,\n                error,\n            });\n        }\n    }\n\n    /**\n     * The credential and session an attempt leaves with, read just before it is\n     * sent.\n     *\n     * @param skipAuth - Whether the attempt goes out without credentials.\n     * @returns The context handed to `refresh` and `onUnauthorized`.\n     */\n    function authContext(skipAuth: boolean): RequestAuthContext {\n        return {\n            token: skipAuth ? null : (config.getToken?.() ?? null),\n            epoch: config.getSessionEpoch?.() ?? null,\n        };\n    }\n\n    async function attempt<T>(\n        path: string,\n        options: RequestOptions,\n        decode: ResponseDecoder<T>,\n    ): Promise<T> {\n        const { skipAuth = false, skipAuthRetry = false, ...init } = options;\n        const requestId = config.requestId ? config.requestId() : randomId();\n        const method = (init.method ?? \"GET\").toUpperCase();\n        const sent = authContext(skipAuth);\n        let response = await send(path, init, requestId, method, skipAuth);\n\n        if (response.status === 401 && !skipAuth && !skipAuthRetry) {\n            if (config.refresh) {\n                let replayed: RequestAuthContext;\n                try {\n                    await config.refresh(sent);\n                    replayed = authContext(skipAuth);\n                    response = await send(path, init, requestId, method, skipAuth);\n                } catch (error) {\n                    if (error instanceof SessionSupersededError) throw error;\n                    await notifyUnauthorized(response, requestId, sent);\n                    throw await parseError(response, requestId);\n                }\n                if (response.status === 401) {\n                    await notifyUnauthorized(response, requestId, replayed);\n                }\n            } else {\n                await notifyUnauthorized(response, requestId, sent);\n            }\n        }\n\n        if (!response.ok) {\n            throw await parseError(response, requestId);\n        }\n\n        return decode(response);\n    }\n\n    async function run<T>(\n        path: string,\n        options: RequestOptions,\n        decode: ResponseDecoder<T>,\n    ): Promise<T> {\n        const { retry: perRequest, ...rest } = options;\n        const retryOptions = resolveRetry(perRequest !== undefined ? perRequest : config.retry);\n        if (!retryOptions) return attempt<T>(path, rest, decode);\n\n        const method = (rest.method ?? \"GET\").toUpperCase();\n        return retryWithBackoff(() => attempt<T>(path, rest, decode), {\n            ...retryOptions,\n            shouldRetry:\n                retryOptions.shouldRetry ?? ((error: unknown) => isRetriableFailure(error, method)),\n        });\n    }\n\n    async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n        return run<T>(path, options, decodeByContentType);\n    }\n\n    async function upload<T>(\n        path: string,\n        formData: FormData,\n        method: \"POST\" | \"PUT\" | \"PATCH\" = \"POST\",\n        options?: Omit<RequestOptions, \"body\" | \"method\">,\n    ): Promise<T> {\n        return request<T>(path, { ...options, method, body: formData });\n    }\n\n    return {\n        request,\n        get: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"GET\" }),\n        post: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"POST\" }),\n        put: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PUT\" }),\n        patch: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PATCH\" }),\n        delete: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"DELETE\" }),\n        blob: (path: string, options?: RequestOptions) =>\n            run<Blob>(path, { ...options }, (response) => response.blob()),\n        arrayBuffer: (path: string, options?: RequestOptions) =>\n            run<ArrayBuffer>(path, { ...options }, (response) => response.arrayBuffer()),\n        upload,\n    };\n}\n"],"mappings":"8OA8BA,IAAM,EAA0C,IAAI,IAAI,CAAC,MAAO,OAAQ,SAAS,CAAC,EAoBlF,SAAS,EAAmB,EAAgB,EAAyB,CAGjE,MAFI,CAAC,EAAmB,IAAI,CAAM,GAC9B,EAAE,aAAiB,EAAA,iBAAyB,GACzC,EAAA,kBAAkB,EAAM,MAAM,CACzC,CAQA,SAAS,EAAa,EAAiE,CAEnF,OADK,EACE,IAAW,GAAO,CAAC,EAAI,EADV,IAExB,CAGA,IAAM,EAAkB,KAGlB,EAAyB,IAE/B,SAAS,EAAW,EAAiC,CACjD,OAAO,OAAO,SAAa,KAAe,aAAgB,QAC9D,CAaA,SAAS,EAAU,EAA2B,CAC1C,OAAO,KAAK,MAAM,YAAY,IAAI,EAAI,CAAS,CACnD,CAEA,eAAe,EAAW,EAAoB,EAAkD,CAC5F,IAAI,EACJ,GAAI,CACA,EAAO,MAAM,EAAS,MAAM,CAAC,CAAC,KAAK,CACvC,MAAQ,CACJ,GAAI,CACA,EAAO,MAAM,EAAS,KAAK,CAC/B,MAAQ,CACJ,EAAO,IACX,CACJ,CACA,OAAO,IAAI,EAAA,gBACP,EAAA,cAAc,EAAS,OAAQ,EAAM,EAAS,QAAS,CAAa,CACxE,CACJ,CA0DA,SAAgB,EAAgB,EAAoC,CAChE,IAAM,EAAU,EAAO,SAAW,WAAW,MAAM,KAAK,UAAU,EAalE,SAAS,EAAY,EAAa,EAA2C,CACzE,GAAI,EAAU,MAAO,CAAC,EACtB,IAAM,EAAQ,EAAO,WAAW,EAMhC,OALK,EACA,EAAA,0BAA0B,EAAK,EAAO,QAAS,EAAO,cAAc,EAIlE,CAAE,cAAe,UAAU,GAAQ,GAHtC,EAAA,2BAA2B,EAAK,EAAO,OAAO,EACvC,CAAC,GAHO,CAAC,CAMxB,CAEA,eAAe,EACX,EACA,EACA,EACA,EACiB,CACjB,GAAM,CAAE,OAAM,SAAQ,UAAS,SAAQ,UAAS,GAAG,GAAS,EACtD,EAAS,EAAW,CAAI,EACxB,EAAa,EAAS,EAAO,cAAgB,EAAO,QAEpD,EACF,IAAY,IAAA,GAAsB,IAAe,IAAA,GAFpC,EAAS,EAAyB,EAEc,EAArC,EAEtB,EAAM,EAAA,YAAY,EAAO,QAAS,EAAM,CAAE,OAAQ,EAAO,OAAQ,QAAO,CAAC,EAEzE,EAAgB,EAChB,EAAuC,CACzC,GAAI,EAAS,CAAC,EAAI,CAAE,eAAgB,kBAAmB,EACvD,GAAI,EAAY,CAAE,eAAgB,CAAU,EAAI,CAAC,EACjD,GAAG,EAAO,QACV,GAAG,EAAY,EAAK,CAAQ,EAC5B,GAAG,EAAA,YAAY,CACX,OAAQ,EAAK,QAAU,MACvB,MACA,UAAW,EAAO,QAClB,KAAM,EAAO,KACb,eAAgB,EAAO,eACvB,QAAS,CAAE,GAAG,EAAO,QAAS,GAAG,CAAc,CACnD,CAAC,EACD,GAAG,CACP,EAEM,EAAQ,EAAA,YAAY,EAAQ,CAAK,EACjC,EAAoB,CACtB,GAAG,EACH,OAAQ,EAAM,OACd,QAAS,EACT,YAAa,EAAO,gBAAkB,UAAY,EAAK,YACvD,KACI,GAA+B,KACzB,IAAA,GACA,EACG,EACD,KAAK,UAAU,CAAI,CACnC,EAEA,GAAI,CACA,OAAO,MAAM,EAAQ,EAAK,CAAI,CAClC,OAAS,EAAO,CAOZ,MANI,EAAM,SAAS,EACT,IAAI,EAAA,gBAAgB,CACtB,OAAQ,EACR,OAAQ,wBAAwB,EAAM,qBAC1C,CAAC,EAEC,CACV,QAAU,CACN,EAAM,QAAQ,CAClB,CACJ,CAEA,eAAe,EACX,EACA,EACA,EACA,EACA,EACiB,CACjB,IAAM,EAAM,EAAO,OACnB,GAAI,CAAC,EAAK,OAAO,EAAW,EAAM,EAAS,EAAW,CAAQ,EAE9D,IAAM,EAAY,YAAY,IAAI,EAClC,GAAI,CACA,IAAM,EAAW,MAAM,EAAW,EAAM,EAAS,EAAW,CAAQ,EAC9D,EAAQ,CAAE,YAAW,OAAQ,EAAS,OAAQ,GAAI,EAAU,CAAS,CAAE,EACvE,EAAO,GAAG,EAAO,GAAG,EAAK,KAAK,EAAS,SAG7C,OAFI,EAAS,QAAU,IAAK,EAAI,KAAK,EAAM,CAAK,EAC3C,EAAI,MAAM,EAAM,CAAK,EACnB,CACX,OAAS,EAAO,CAMZ,MALA,EAAI,KAAK,GAAG,EAAO,GAAG,EAAK,gBAAiB,CACxC,YACA,GAAI,EAAU,CAAS,EACvB,OACJ,CAAC,EACK,CACV,CACJ,CAWA,eAAe,EACX,EACA,EACA,EACa,CACR,KAAO,eACZ,GAAO,QAAQ,KAAK,wCAAyC,CACzD,YACA,OAAQ,EAAS,MACrB,CAAC,EACD,GAAI,CACA,MAAM,EAAO,eAAe,EAAU,CAAO,CACjD,OAAS,EAAO,CACZ,GAAI,aAAiB,EAAA,uBAAwB,MAAM,EACnD,EAAO,QAAQ,KAAK,6DAA8D,CAC9E,YACA,OAAQ,EAAS,OACjB,OACJ,CAAC,CACL,CAVC,CAWL,CASA,SAAS,EAAY,EAAuC,CACxD,MAAO,CACH,MAAO,EAAW,KAAQ,EAAO,WAAW,GAAK,KACjD,MAAO,EAAO,kBAAkB,GAAK,IACzC,CACJ,CAEA,eAAe,EACX,EACA,EACA,EACU,CACV,GAAM,CAAE,WAAW,GAAO,gBAAgB,GAAO,GAAG,GAAS,EACvD,EAAY,EAAO,UAAY,EAAO,UAAU,EAAI,EAAA,SAAS,EAC7D,GAAU,EAAK,QAAU,MAAA,CAAO,YAAY,EAC5C,EAAO,EAAY,CAAQ,EAC7B,EAAW,MAAM,EAAK,EAAM,EAAM,EAAW,EAAQ,CAAQ,EAEjE,GAAI,EAAS,SAAW,KAAO,CAAC,GAAY,CAAC,EAAe,CACxD,GAAI,EAAO,QAAS,CAChB,IAAI,EACJ,GAAI,CACA,MAAM,EAAO,QAAQ,CAAI,EACzB,EAAW,EAAY,CAAQ,EAC/B,EAAW,MAAM,EAAK,EAAM,EAAM,EAAW,EAAQ,CAAQ,CACjE,OAAS,EAAO,CAGZ,MAFI,aAAiB,EAAA,uBAA8B,GACnD,MAAM,EAAmB,EAAU,EAAW,CAAI,EAC5C,MAAM,EAAW,EAAU,CAAS,EAC9C,CACI,EAAS,SAAW,KACpB,MAAM,EAAmB,EAAU,EAAW,CAAQ,CAE9D,MACI,MAAM,EAAmB,EAAU,EAAW,CAAI,CAE1D,CAEA,GAAI,CAAC,EAAS,GACV,MAAM,MAAM,EAAW,EAAU,CAAS,EAG9C,OAAO,EAAO,CAAQ,CAC1B,CAEA,eAAe,EACX,EACA,EACA,EACU,CACV,GAAM,CAAE,MAAO,EAAY,GAAG,GAAS,EACjC,EAAe,EAAa,IAAe,IAAA,GAAyB,EAAO,MAApB,CAAyB,EACtF,GAAI,CAAC,EAAc,OAAO,EAAW,EAAM,EAAM,CAAM,EAEvD,IAAM,GAAU,EAAK,QAAU,MAAA,CAAO,YAAY,EAClD,OAAO,EAAA,UAAuB,EAAW,EAAM,EAAM,CAAM,EAAG,CAC1D,GAAG,EACH,YACI,EAAa,cAAiB,GAAmB,EAAmB,EAAO,CAAM,EACzF,CAAC,CACL,CAEA,eAAe,EAAW,EAAc,EAA0B,CAAC,EAAe,CAC9E,OAAO,EAAO,EAAM,EAAS,EAAA,mBAAmB,CACpD,CAEA,eAAe,EACX,EACA,EACA,EAAmC,OACnC,EACU,CACV,OAAO,EAAW,EAAM,CAAE,GAAG,EAAS,SAAQ,KAAM,CAAS,CAAC,CAClE,CAEA,MAAO,CACH,UACA,KAAS,EAAc,IACnB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,KAAM,CAAC,EAClD,MAAU,EAAc,IACpB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,MAAO,CAAC,EACnD,KAAS,EAAc,IACnB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,KAAM,CAAC,EAClD,OAAW,EAAc,IACrB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,OAAQ,CAAC,EACpD,QAAY,EAAc,IACtB,EAAW,EAAM,CAAE,GAAG,EAAS,OAAQ,QAAS,CAAC,EACrD,MAAO,EAAc,IACjB,EAAU,EAAM,CAAE,GAAG,CAAQ,EAAI,GAAa,EAAS,KAAK,CAAC,EACjE,aAAc,EAAc,IACxB,EAAiB,EAAM,CAAE,GAAG,CAAQ,EAAI,GAAa,EAAS,YAAY,CAAC,EAC/E,QACJ,CACJ"}
+{"version":3,"file":"api-client.cjs","names":["TempestApiError","isRetriableStatus","buildApiError","isTrustedCredentialTarget","buildApiUrl","csrfHeaders","withTimeout","SessionSupersededError","randomId","retryWithBackoff","decodeByContentType","require_ids","require_build_url","require_credential_scope","require_csrf","require_decode_response","require_errors","require_retry","require_timeout","IDEMPOTENT_METHODS","isRetriableFailure","method","error","resolveRetry","config","DEFAULT_TIMEOUT","DEFAULT_UPLOAD_TIMEOUT","isFormData","body","elapsedMs","startedAt","parseError","response","sentRequestId","createApiClient","fetcher","authHeaders","skipAuth","token","url","rawRequest","rest","options","isForm","configured","limit","timeout","path","callerHeaders","headers","finalHeaders","requestId","timed","signal","init","cause","send","log","entry","line","notifyUnauthorized","context","authContext","attempt","sent","skipAuthRetry","replayed","decode","run","perRequest","retryOptions","request","upload","formData"],"sources":["../../src/http/api-client.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — createApiClient is over the limit and every line\n * is a request-lifecycle concern the client cannot delegate: base URL joining, the\n * auth header, the 401 refresh-and-replay, the opt-in retry wrapper and the response\n * parsing that turns a failure into a typed error.\n */\nimport { randomId } from \"../utils\";\nimport { buildApiUrl } from \"./build-url\";\nimport { isTrustedCredentialTarget, reportSuppressedCredential } from \"./credential-scope\";\nimport { csrfHeaders } from \"./csrf\";\nimport { decodeByContentType } from \"./decode-response\";\nimport type { ResponseDecoder } from \"./decode-response\";\nimport {\n    buildApiError,\n    SessionSupersededError,\n    TempestApiError,\n    isRetriableStatus,\n} from \"./errors\";\nimport { retry as retryWithBackoff } from \"./retry\";\nimport type { RetryOptions } from \"./retry\";\nimport { withTimeout } from \"./timeout\";\nimport type { ApiClient, ApiClientConfig, RequestAuthContext, RequestOptions } from \"./types\";\n\n/**\n * Methods the built-in retry policy will replay.\n *\n * `PUT` and `DELETE` are idempotent on paper but stay out: a backend that logs,\n * bills, or fires a webhook per call still sees two, so replaying them is a\n * decision the caller makes through `shouldRetry`, not a default.\n */\nconst IDEMPOTENT_METHODS: ReadonlySet<string> = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\n/**\n * Sub-500 statuses worth a second attempt: a network failure (status `0`), a\n * request timeout, a too-early replay, and a rate limit — which usually carries\n * the `Retry-After` the backoff already honours.\n */\n\n/**\n * The built-in retry policy, used when `retry` is `true` or is options carrying\n * no `shouldRetry` of their own.\n *\n * Conservative on purpose. Replaying a write can duplicate it, and replaying a\n * `400` or a `403` cannot fix a bad payload or a permission the caller does not\n * have — it only spends the user's time before showing the same error.\n *\n * @param error - Whatever the attempt threw.\n * @param method - The upper-cased HTTP method of the request.\n * @returns Whether the client should try again.\n */\nfunction isRetriableFailure(error: unknown, method: string): boolean {\n    if (!IDEMPOTENT_METHODS.has(method)) return false;\n    if (!(error instanceof TempestApiError)) return false;\n    return isRetriableStatus(error.status);\n}\n\n/**\n * Normalize the `retry` config into options, or `null` when retrying is off.\n *\n * @param config - The `retry` field as the caller wrote it.\n * @returns Retry options to use, or `null` to run a single attempt.\n */\nfunction resolveRetry(config: boolean | RetryOptions | undefined): RetryOptions | null {\n    if (!config) return null;\n    return config === true ? {} : config;\n}\n\n/** Default milliseconds before a request is abandoned. */\nconst DEFAULT_TIMEOUT = 15_000;\n\n/** Default milliseconds before a `FormData` request is abandoned. */\nconst DEFAULT_UPLOAD_TIMEOUT = 300_000;\n\nfunction isFormData(body: unknown): body is FormData {\n    return typeof FormData !== \"undefined\" && body instanceof FormData;\n}\n\n/**\n * Milliseconds since a `performance.now()` reading, rounded.\n *\n * `performance.now()` rather than `Date.now()` because this measures a\n * duration: the wall clock can step sideways mid-request (an NTP correction, a\n * VM resuming, the user changing the clock) and turn a 40 ms call into a\n * negative number. The monotonic clock cannot.\n *\n * @param startedAt - The reading taken before the work started.\n * @returns Whole milliseconds elapsed.\n */\nfunction elapsedMs(startedAt: number): number {\n    return Math.round(performance.now() - startedAt);\n}\n\nasync function parseError(response: Response, sentRequestId?: string): Promise<TempestApiError> {\n    let body: unknown;\n    try {\n        body = await response.clone().json();\n    } catch {\n        try {\n            body = await response.text();\n        } catch {\n            body = null;\n        }\n    }\n    return new TempestApiError(\n        buildApiError(response.status, body, response.headers, sentRequestId),\n    );\n}\n\n/**\n * Create a typed HTTP client backed by `fetch`.\n *\n * Handles JSON serialization, query params, bearer auth via `getToken`, uploads\n * via `FormData`, and throws a typed `ApiError` on any non-2xx response.\n *\n * **Expired sessions.** A `401` with `refresh` configured awaits the refresh and\n * replays the request once. `onUnauthorized` fires whenever that path ends\n * unauthorized anyway — the refresh threw, or the replay came back `401` — which\n * is the signal to clear the session. Without `refresh`, the first `401` calls\n * it directly.\n *\n * **Binary bodies** have their own methods — `blob()` and `arrayBuffer()` — which\n * run the same pipeline and skip the parse. `request()` no longer decodes an\n * unknown `Content-Type` as text either: it returns a `Blob` and says so once in\n * a development build, because reading `image/jpeg` as UTF-8 destroyed the bytes\n * on the way in.\n *\n * **The bearer token is scoped to `baseURL`'s origin** since 0.66.0. A path may\n * be an absolute URL, which overrides the base entirely, so without a scope the\n * destination of a credentialed request could come from a value read off the\n * network. A request to another origin still goes out; it goes without the\n * header, and a development build says so once. Declare the exceptions in\n * {@link ApiClientConfig.trustedOrigins}.\n *\n * **CSRF** is off unless you set `csrf`. With it, every unsafe request (anything\n * but `GET`/`HEAD`/`OPTIONS`/`TRACE`) echoes the `csrf_token` cookie in an\n * `X-CSRF-Token` header — the double-submit contract of `tempest-fastapi-sdk`'s\n * `CSRFMiddleware` — scoped to the same origins as the bearer token and sent on\n * `skipAuth` requests too. See {@link ApiClientConfig.csrf}.\n *\n * **Retries** are off unless you set `retry`. See {@link ApiClientConfig.retry}\n * for the built-in policy; it never replays a write. A single call overrides it\n * with {@link RequestOptions.retry}, and opts out of auth entirely with\n * {@link RequestOptions.skipAuth}.\n *\n * **Logging** is off unless you pass a `logger`. With one, every finished attempt\n * writes a line — `debug` under 400, `warn` from 400 up, plus a `warn` when\n * `onUnauthorized` fires — carrying `requestId`, `status` and elapsed `ms`, and\n * never a body, header or query string. The level and the destination belong to\n * the logger, not to a boolean here.\n *\n * @example\n * const api = createApiClient({\n *     baseURL: import.meta.env.VITE_API_URL,\n *     getToken: () => useAuthStore.getState().token,\n *     refresh,\n *     onUnauthorized: () => useAuthStore.getState().logout(),\n *     logger: createLogger({ level: import.meta.env.DEV ? \"debug\" : \"warn\" }).child(\"http\"),\n *     retry: true,\n * });\n *\n * @param config - Base URL plus the optional auth, retry and fetch hooks.\n * @returns A client with `request`/`get`/`post`/`put`/`patch`/`delete`/`blob`/\n * `arrayBuffer`/`upload`.\n */\nexport function createApiClient(config: ApiClientConfig): ApiClient {\n    const fetcher = config.fetcher ?? globalThis.fetch.bind(globalThis);\n\n    /**\n     * The `Authorization` header for a request, or nothing.\n     *\n     * Takes the resolved URL rather than reading `config.baseURL`, because an\n     * absolute path overrides the base entirely (see `buildApiUrl`) and the\n     * credential is scoped to an origin, not to a client.\n     *\n     * @param url - The absolute URL the request is going to.\n     * @param skipAuth - Whether the caller opted this request out of auth.\n     * @returns The header, or an empty object.\n     */\n    function authHeaders(url: string, skipAuth: boolean): Record<string, string> {\n        if (skipAuth) return {};\n        const token = config.getToken?.();\n        if (!token) return {};\n        if (!isTrustedCredentialTarget(url, config.baseURL, config.trustedOrigins)) {\n            reportSuppressedCredential(url, config.baseURL);\n            return {};\n        }\n        return { Authorization: `Bearer ${token}` };\n    }\n\n    async function rawRequest(\n        path: string,\n        options: RequestOptions,\n        requestId: string | undefined,\n        skipAuth: boolean,\n    ): Promise<Response> {\n        const { body, params, headers, signal, timeout, ...rest } = options;\n        const isForm = isFormData(body);\n        const configured = isForm ? config.uploadTimeout : config.timeout;\n        const fallback = isForm ? DEFAULT_UPLOAD_TIMEOUT : DEFAULT_TIMEOUT;\n        const limit =\n            timeout !== undefined ? timeout : configured !== undefined ? configured : fallback;\n\n        const url = buildApiUrl(config.baseURL, path, { prefix: config.prefix, params });\n\n        const callerHeaders = headers as Record<string, string> | undefined;\n        const finalHeaders: Record<string, string> = {\n            ...(isForm ? {} : { \"Content-Type\": \"application/json\" }),\n            ...(requestId ? { \"X-Request-ID\": requestId } : {}),\n            ...config.headers,\n            ...authHeaders(url, skipAuth),\n            ...csrfHeaders({\n                method: rest.method ?? \"GET\",\n                url,\n                reference: config.baseURL,\n                csrf: config.csrf,\n                trustedOrigins: config.trustedOrigins,\n                headers: { ...config.headers, ...callerHeaders },\n            }),\n            ...callerHeaders,\n        };\n\n        const timed = withTimeout(signal, limit);\n        const init: RequestInit = {\n            ...rest,\n            signal: timed.signal,\n            headers: finalHeaders,\n            credentials: config.withCredentials ? \"include\" : rest.credentials,\n            body:\n                body === undefined || body === null\n                    ? undefined\n                    : isForm\n                      ? (body as FormData)\n                      : JSON.stringify(body),\n        };\n\n        try {\n            return await fetcher(url, init);\n        } catch (cause) {\n            if (timed.timedOut()) {\n                throw new TempestApiError({\n                    status: 0,\n                    detail: `A requisição excedeu ${limit}ms e foi abandonada.`,\n                });\n            }\n            throw cause;\n        } finally {\n            timed.dispose();\n        }\n    }\n\n    async function send(\n        path: string,\n        options: RequestOptions,\n        requestId: string,\n        method: string,\n        skipAuth: boolean,\n    ): Promise<Response> {\n        const log = config.logger;\n        if (!log) return rawRequest(path, options, requestId, skipAuth);\n\n        const startedAt = performance.now();\n        try {\n            const response = await rawRequest(path, options, requestId, skipAuth);\n            const entry = { requestId, status: response.status, ms: elapsedMs(startedAt) };\n            const line = `${method} ${path} → ${response.status}`;\n            if (response.status >= 400) log.warn(line, entry);\n            else log.debug(line, entry);\n            return response;\n        } catch (error) {\n            log.warn(`${method} ${path} → no response`, {\n                requestId,\n                ms: elapsedMs(startedAt),\n                error,\n            });\n            throw error;\n        }\n    }\n\n    /**\n     * Call `onUnauthorized`, keeping the request's own error unless the hook\n     * says the attempt belongs to an ended session.\n     *\n     * @param response - The `401` that ended the attempt.\n     * @param requestId - Correlation id for the log.\n     * @param context - The credential and session the attempt left with.\n     * @throws {SessionSupersededError} When `onUnauthorized` threw it.\n     */\n    async function notifyUnauthorized(\n        response: Response,\n        requestId: string,\n        context: RequestAuthContext,\n    ): Promise<void> {\n        if (!config.onUnauthorized) return;\n        config.logger?.warn(`unauthorized — calling onUnauthorized`, {\n            requestId,\n            status: response.status,\n        });\n        try {\n            await config.onUnauthorized(response, context);\n        } catch (error) {\n            if (error instanceof SessionSupersededError) throw error;\n            config.logger?.warn(`onUnauthorized threw — keeping the original response error`, {\n                requestId,\n                status: response.status,\n                error,\n            });\n        }\n    }\n\n    /**\n     * The credential and session an attempt leaves with, read just before it is\n     * sent.\n     *\n     * @param skipAuth - Whether the attempt goes out without credentials.\n     * @returns The context handed to `refresh` and `onUnauthorized`.\n     */\n    function authContext(skipAuth: boolean): RequestAuthContext {\n        return {\n            token: skipAuth ? null : (config.getToken?.() ?? null),\n            epoch: config.getSessionEpoch?.() ?? null,\n        };\n    }\n\n    async function attempt<T>(\n        path: string,\n        options: RequestOptions,\n        decode: ResponseDecoder<T>,\n    ): Promise<T> {\n        const { skipAuth = false, skipAuthRetry = false, ...init } = options;\n        const requestId = config.requestId ? config.requestId() : randomId();\n        const method = (init.method ?? \"GET\").toUpperCase();\n        const sent = authContext(skipAuth);\n        let response = await send(path, init, requestId, method, skipAuth);\n\n        if (response.status === 401 && !skipAuth && !skipAuthRetry) {\n            if (config.refresh) {\n                let replayed: RequestAuthContext;\n                try {\n                    await config.refresh(sent);\n                    replayed = authContext(skipAuth);\n                    response = await send(path, init, requestId, method, skipAuth);\n                } catch (error) {\n                    if (error instanceof SessionSupersededError) throw error;\n                    await notifyUnauthorized(response, requestId, sent);\n                    throw await parseError(response, requestId);\n                }\n                if (response.status === 401) {\n                    await notifyUnauthorized(response, requestId, replayed);\n                }\n            } else {\n                await notifyUnauthorized(response, requestId, sent);\n            }\n        }\n\n        if (!response.ok) {\n            throw await parseError(response, requestId);\n        }\n\n        return decode(response);\n    }\n\n    async function run<T>(\n        path: string,\n        options: RequestOptions,\n        decode: ResponseDecoder<T>,\n    ): Promise<T> {\n        const { retry: perRequest, ...rest } = options;\n        const retryOptions = resolveRetry(perRequest !== undefined ? perRequest : config.retry);\n        if (!retryOptions) return attempt<T>(path, rest, decode);\n\n        const method = (rest.method ?? \"GET\").toUpperCase();\n        return retryWithBackoff(() => attempt<T>(path, rest, decode), {\n            ...retryOptions,\n            shouldRetry:\n                retryOptions.shouldRetry ?? ((error: unknown) => isRetriableFailure(error, method)),\n        });\n    }\n\n    async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n        return run<T>(path, options, decodeByContentType);\n    }\n\n    async function upload<T>(\n        path: string,\n        formData: FormData,\n        method: \"POST\" | \"PUT\" | \"PATCH\" = \"POST\",\n        options?: Omit<RequestOptions, \"body\" | \"method\">,\n    ): Promise<T> {\n        return request<T>(path, { ...options, method, body: formData });\n    }\n\n    return {\n        request,\n        get: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"GET\" }),\n        post: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"POST\" }),\n        put: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PUT\" }),\n        patch: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PATCH\" }),\n        delete: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"DELETE\" }),\n        blob: (path: string, options?: RequestOptions) =>\n            run<Blob>(path, { ...options }, (response) => response.blob()),\n        arrayBuffer: (path: string, options?: RequestOptions) =>\n            run<ArrayBuffer>(path, { ...options }, (response) => response.arrayBuffer()),\n        upload,\n        url: (path: string, params?: RequestOptions[\"params\"]) =>\n            buildApiUrl(config.baseURL, path, { prefix: config.prefix, params }),\n    };\n}\n"],"mappings":"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"}

package/dist/http/api-client.js

@@ -186,7 +186,11 @@ function b(c) {
 		}),
 		blob: (e, t) => T(e, { ...t }, (e) => e.blob()),
 		arrayBuffer: (e, t) => T(e, { ...t }, (e) => e.arrayBuffer()),
-		upload: D
+		upload: D,
+		url: (e, n) => t(c.baseURL, e, {
+			prefix: c.prefix,
+			params: n
+		})
 	};
 }
 //#endregion