tempest-react-sdk 0.65.0 → 0.67.0

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

@@ -1 +1 @@
-{"version":3,"file":"use-sortable.cjs","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        function onKeyDown(event: KeyboardEvent): void {\n            if (event.key === \"Escape\") reset();\n        }\n\n        window.addEventListener(\"pointermove\", onPointerMove);\n        window.addEventListener(\"pointerup\", onPointerUp);\n        window.addEventListener(\"pointercancel\", reset);\n        window.addEventListener(\"keydown\", onKeyDown);\n        return () => {\n            window.removeEventListener(\"pointermove\", onPointerMove);\n            window.removeEventListener(\"pointerup\", onPointerUp);\n            window.removeEventListener(\"pointercancel\", reset);\n            window.removeEventListener(\"keydown\", onKeyDown);\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":"uBA0GA,SAAgB,EAAY,EAAY,EAAc,EAAiB,CACnE,GAAI,IAAS,GAAM,EAAO,GAAK,EAAK,GAAK,GAAQ,EAAM,QAAU,GAAM,EAAM,OACzE,OAAO,EAEX,IAAM,EAAO,EAAM,MAAM,EACnB,CAAC,GAAS,EAAK,OAAO,EAAM,CAAC,EAEnC,OADA,EAAK,OAAO,EAAI,EAAG,CAAK,EACjB,CACX,CAcA,SAAS,EAAc,EAA+B,EAAW,EAA6B,CAC1F,GAAI,CAAC,EAAW,OAAO,KACvB,IAAM,EAAU,GAAkC,CAC9C,IAAM,EAAO,EAAQ,sBAAsB,EAC3C,OAAO,GAAK,EAAK,KAAO,GAAK,EAAK,QAAU,GAAK,EAAK,MAAQ,GAAK,EAAK,KAC5E,EAEA,IAAK,IAAM,KAAQ,MAAM,KACrB,EAAU,iBAA8B,uBAAuB,CACnE,EAAG,CACC,GAAI,CAAC,EAAO,CAAI,EAAG,SACnB,IAAM,EAAQ,OAAO,EAAK,QAAQ,aAAa,EAE/C,OADI,OAAO,MAAM,CAAK,EAAU,KACzB,CAAE,QAAO,MAAO,EAAK,QAAQ,aAAc,CACtD,CAEA,IAAK,IAAM,KAAS,MAAM,KACtB,EAAU,iBAA8B,uBAAuB,CACnE,EACI,GAAI,EAAO,CAAK,EAAG,MAAO,CAAE,MAAO,EAAG,MAAO,EAAM,QAAQ,aAAc,EAG7E,OAAO,IACX,CA6CA,SAAgB,EAAY,EAAgD,CACxE,GAAM,CAAE,YAAW,YAAW,WAAW,GAAO,kBAAkB,iBAAoB,EAEhF,CAAC,EAAa,IAAA,EAAuB,EAAA,SAAA,CAAwB,IAAI,EACjE,CAAC,EAAW,IAAA,EAAqB,EAAA,SAAA,CAAwB,IAAI,EAC7D,GAAA,EAAe,EAAA,OAAA,CAA2B,IAAI,EAC9C,GAAA,EAAe,EAAA,OAAA,CAAO,CAAS,EAU/B,GAAA,EAAY,EAAA,OAAA,CAAsB,IAAI,EACtC,GAAA,EAAU,EAAA,OAAA,CAAsB,IAAI,EACpC,CAAC,EAAa,IAAA,EAAuB,EAAA,SAAA,CAA6B,IAAA,EAAS,EAC3E,CAAC,EAAW,IAAA,EAAqB,EAAA,SAAA,CAA6B,IAAA,EAAS,EACvE,GAAA,EAAiB,EAAA,OAAA,CAA2B,IAAA,EAAS,EACrD,GAAA,EAAe,EAAA,OAAA,CAA2B,IAAA,EAAS,EAEnD,GAAA,EAAiB,EAAA,YAAA,CAAa,GAAoC,CACpE,EAAe,QAAU,EACzB,EAAoB,CAAK,CAC7B,EAAG,CAAC,CAAC,EAEC,GAAA,EAAe,EAAA,YAAA,CAAa,GAAoC,CAClE,EAAa,QAAU,EACvB,EAAkB,CAAK,CAC3B,EAAG,CAAC,CAAC,EAEC,GAAA,EAAiB,EAAA,YAAA,CAAa,GAA+B,CAC/D,EAAU,QAAU,EACpB,EAAoB,CAAK,CAC7B,EAAG,CAAC,CAAC,EAEC,GAAA,EAAe,EAAA,YAAA,CAAa,GAA+B,CAC7D,EAAQ,QAAU,EAClB,EAAkB,CAAK,CAC3B,EAAG,CAAC,CAAC,GAEL,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAa,QAAU,CAC3B,EAAG,CAAC,CAAS,CAAC,EAEd,IAAM,GAAA,EAAQ,EAAA,YAAA,KAAwB,CAClC,EAAe,IAAA,EAAS,EACxB,EAAa,IAAA,EAAS,EACtB,EAAe,IAAI,EACnB,EAAa,IAAI,CACrB,EAAG,CAAC,EAAgB,EAAgB,EAAc,CAAY,CAAC,GAE/D,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAM,CACV,EAAG,CAAC,EAAW,CAAK,CAAC,EAcrB,IAAM,GAAA,EAAS,EAAA,YAAA,EACV,EAAc,EAAY,EAAoB,IAA2B,EAClE,IAAS,GAAM,IAAc,IAC7B,EAAa,QAAQ,CAAE,OAAM,KAAI,YAAW,SAAQ,CAAC,EAEzD,EAAM,CACV,EACA,CAAC,CAAK,CACV,EAEM,GAAA,EAAe,EAAA,YAAA,CAAa,GAAmC,CACjE,EAAa,QAAU,CAC3B,EAAG,CAAC,CAAC,EAEC,GAAA,EAAoB,EAAA,YAAA,EACrB,EAAe,EAA2B,IAAgD,CACnF,IACJ,EAAM,cAAc,oBAAoB,EAAM,SAAS,EACvD,EAAe,CAAK,EACpB,EAAa,CAAK,EAClB,EAAe,CAAK,EACpB,EAAa,CAAK,EACtB,EACA,CAAC,EAAU,EAAgB,EAAgB,EAAc,CAAY,CACzE,GAEA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,IAAgB,KAAM,OAE1B,SAAS,EAAc,EAA2B,CAC9C,IAAM,EAAS,EAAc,EAAa,QAAS,EAAM,QAAS,EAAM,OAAO,EAC1E,IACL,EAAa,EAAO,KAAK,EACzB,EAAa,EAAO,KAAK,EAC7B,CAEA,SAAS,GAAoB,CACzB,IAAM,EAAO,EAAU,QACjB,EAAK,EAAQ,QACf,IAAS,MAAQ,IAAO,KACxB,EAAO,EAAM,EAAI,EAAe,QAAS,EAAa,OAAO,EAE7D,EAAM,CAEd,CAEA,SAAS,EAAU,EAA4B,CACvC,EAAM,MAAQ,UAAU,EAAM,CACtC,CAMA,OAJA,OAAO,iBAAiB,cAAe,CAAa,EACpD,OAAO,iBAAiB,YAAa,CAAW,EAChD,OAAO,iBAAiB,gBAAiB,CAAK,EAC9C,OAAO,iBAAiB,UAAW,CAAS,MAC/B,CACT,OAAO,oBAAoB,cAAe,CAAa,EACvD,OAAO,oBAAoB,YAAa,CAAW,EACnD,OAAO,oBAAoB,gBAAiB,CAAK,EACjD,OAAO,oBAAoB,UAAW,CAAS,CACnD,CACJ,EAAG,CAAC,EAAa,EAAQ,EAAO,EAAc,CAAY,CAAC,EAE3D,IAAM,GAAA,EAAgB,EAAA,YAAA,EAEd,EACA,EACA,IACO,CACP,GAAI,EAAU,OACd,IAAM,EAAS,IAAgB,KAE/B,OAAQ,EAAM,IAAd,CACI,IAAK,IACL,IAAK,QACD,EAAM,eAAe,EAChB,EAKM,IAAc,MACrB,EAAO,EAAa,EAAW,EAAa,CAAS,GALrD,EAAe,CAAK,EACpB,EAAa,CAAK,EAClB,EAAe,CAAK,EACpB,EAAa,CAAK,GAItB,MACJ,IAAK,YACL,IAAK,aACD,GAAI,CAAC,EAAQ,OACb,EAAM,eAAe,EACjB,EAAQ,UAAY,MACpB,EAAa,KAAK,IAAI,EAAQ,QAAU,EAAG,EAAY,CAAC,CAAC,EAE7D,MAEJ,IAAK,UACL,IAAK,YACD,GAAI,CAAC,EAAQ,OACb,EAAM,eAAe,EACjB,EAAQ,UAAY,MACpB,EAAa,KAAK,IAAI,EAAQ,QAAU,EAAG,CAAC,CAAC,EAEjD,MAEJ,IAAK,SACD,GAAI,CAAC,EAAQ,OACb,EAAM,eAAe,EACrB,EAAM,CAId,CACJ,EACA,CACI,EACA,EACA,EACA,EACA,EACA,EACA,EACA,EACA,EACA,EACA,EACA,CACJ,CACJ,EA2BA,MAAO,CACH,cACA,YACA,cACA,YACA,cAAA,EA9BiB,EAAA,YAAA,EAChB,EAAe,KAAuC,CACnD,sBAAuB,EACvB,sBAAuB,EACvB,uBAAyB,IAAgB,GAAS,IAAgB,GAAU,IAAA,GAC5E,cAAgB,GAAU,EAAkB,EAAO,EAAO,CAAK,EAC/D,UAAY,GAAU,EAAc,EAAO,EAAO,CAAK,EACvD,SAAU,EAAW,GAAK,EAC1B,KAAM,SACN,uBAAwB,EACxB,gBAAiB,IAAgB,GAAS,IAAgB,CAC9D,GACA,CAAC,EAAa,EAAa,EAAU,EAAe,EAAmB,CAAe,CAkBtF,EACA,oBAAA,EAhBuB,EAAA,YAAA,CACtB,IAAmB,CAAE,sBAAuB,EAAO,sBAAuB,EAAc,GACzF,CAAC,CAcD,EACA,cAAA,EAZiB,EAAA,YAAA,MACV,CAAE,KAAM,UAAoB,mBAAoB,UAAoB,GAC3E,CAAC,CAUD,EACA,OAAQ,EACR,cACJ,CACJ"}
+{"version":3,"file":"use-sortable.cjs","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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"}

package/dist/hooks/use-sortable.js

@@ -78,10 +78,10 @@ function o(i) {
 			e !== null && t !== null ? k(e, t, S.current, C.current) : O();
 		}
 		function n(e) {
-			e.key === "Escape" && O();
+			e.key === "Escape" && (e.preventDefault(), O());
 		}
-		return window.addEventListener("pointermove", e), window.addEventListener("pointerup", t), window.addEventListener("pointercancel", O), window.addEventListener("keydown", n), () => {
-			window.removeEventListener("pointermove", e), window.removeEventListener("pointerup", t), window.removeEventListener("pointercancel", O), window.removeEventListener("keydown", n);
+		return window.addEventListener("pointermove", e), window.addEventListener("pointerup", t), window.addEventListener("pointercancel", O), window.addEventListener("keydown", n, !0), () => {
+			window.removeEventListener("pointermove", e), window.removeEventListener("pointerup", t), window.removeEventListener("pointercancel", O), window.removeEventListener("keydown", n, !0);
 		};
 	}, [
 		u,

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        function onKeyDown(event: KeyboardEvent): void {\n            if (event.key === \"Escape\") reset();\n        }\n\n        window.addEventListener(\"pointermove\", onPointerMove);\n        window.addEventListener(\"pointerup\", onPointerUp);\n        window.addEventListener(\"pointercancel\", reset);\n        window.addEventListener(\"keydown\", onKeyDown);\n        return () => {\n            window.removeEventListener(\"pointermove\", onPointerMove);\n            window.removeEventListener(\"pointerup\", onPointerUp);\n            window.removeEventListener(\"pointercancel\", reset);\n            window.removeEventListener(\"keydown\", onKeyDown);\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":[],"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/http/api-client.cjs

@@ -1,2 +1,2 @@
-const e=require("../utils/ids.cjs"),t=require("./build-url.cjs"),n=require("./decode-response.cjs"),r=require("./errors.cjs"),i=require("./retry.cjs"),a=require("./timeout.cjs");var o=new Set([`GET`,`HEAD`,`OPTIONS`]);function s(e,t){return!o.has(t)||!(e instanceof r.TempestApiError)?!1:r.isRetriableStatus(e.status)}function c(e){return e?e===!0?{}:e:null}var l=15e3,u=3e5;function d(e){return typeof FormData<`u`&&e instanceof FormData}function f(e){return Math.round(performance.now()-e)}async function p(e,t){let n;try{n=await e.clone().json()}catch{try{n=await e.text()}catch{n=null}}return new r.TempestApiError(r.buildApiError(e.status,n,e.headers,t))}function m(o){let m=o.fetcher??globalThis.fetch.bind(globalThis);function h(){let e=o.getToken?.();return e?{Authorization:`Bearer ${e}`}:{}}async function g(e,n,i){let{body:s,params:c,headers:f,signal:p,timeout:g,..._}=n,v=d(s),y=v?o.uploadTimeout:o.timeout,b=g===void 0?y===void 0?v?u:l:y:g,x={...v?{}:{"Content-Type":`application/json`},...i?{"X-Request-ID":i}:{},...o.headers,...h(),...f},S=a.withTimeout(p,b),C={..._,signal:S.signal,headers:x,credentials:o.withCredentials?`include`:_.credentials,body:s==null?void 0:v?s:JSON.stringify(s)},w=t.buildApiUrl(o.baseURL,e,{prefix:o.prefix,params:c});try{return await m(w,C)}catch(e){throw S.timedOut()?new r.TempestApiError({status:0,detail:`A requisição excedeu ${b}ms e foi abandonada.`}):e}finally{S.dispose()}}async function _(e,t,n,r){let i=o.logger;if(!i)return g(e,t,n);let a=performance.now();try{let o=await g(e,t,n),s={requestId:n,status:o.status,ms:f(a)},c=`${r} ${e} → ${o.status}`;return o.status>=400?i.warn(c,s):i.debug(c,s),o}catch(t){throw i.warn(`${r} ${e} → no response`,{requestId:n,ms:f(a),error:t}),t}}async function v(e,t){if(o.onUnauthorized){o.logger?.warn(`unauthorized — calling onUnauthorized`,{requestId:t,status:e.status});try{await o.onUnauthorized(e)}catch(n){o.logger?.warn(`onUnauthorized threw — keeping the original response error`,{requestId:t,status:e.status,error:n})}}}async function y(t,n,r){let i=o.requestId?o.requestId():e.randomId(),a=(n.method??`GET`).toUpperCase(),s=await _(t,n,i,a);if(s.status===401){if(o.refresh){try{await o.refresh(),s=await _(t,n,i,a)}catch{throw await v(s,i),await p(s,i)}s.status===401&&await v(s,i)}else await v(s,i)}if(!s.ok)throw await p(s,i);return r(s)}async function b(e,t,n){let r=c(o.retry);if(!r)return y(e,t,n);let a=(t.method??`GET`).toUpperCase();return i.retry(()=>y(e,t,n),{...r,shouldRetry:r.shouldRetry??(e=>s(e,a))})}async function x(e,t={}){return b(e,t,n.decodeByContentType)}async function S(e,t,n=`POST`,r){return x(e,{...r,method:n,body:t})}return{request:x,get:(e,t)=>x(e,{...t,method:`GET`}),post:(e,t)=>x(e,{...t,method:`POST`}),put:(e,t)=>x(e,{...t,method:`PUT`}),patch:(e,t)=>x(e,{...t,method:`PATCH`}),delete:(e,t)=>x(e,{...t,method:`DELETE`}),blob:(e,t)=>b(e,{...t},e=>e.blob()),arrayBuffer:(e,t)=>b(e,{...t},e=>e.arrayBuffer()),upload:S}}exports.createApiClient=m;
+const e=require("../utils/ids.cjs"),t=require("./build-url.cjs"),n=require("./credential-scope.cjs"),r=require("./decode-response.cjs"),i=require("./errors.cjs"),a=require("./retry.cjs"),o=require("./timeout.cjs");var s=new Set([`GET`,`HEAD`,`OPTIONS`]);function c(e,t){return!s.has(t)||!(e instanceof i.TempestApiError)?!1:i.isRetriableStatus(e.status)}function l(e){return e?e===!0?{}:e:null}var u=15e3,d=3e5;function f(e){return typeof FormData<`u`&&e instanceof FormData}function p(e){return Math.round(performance.now()-e)}async function m(e,t){let n;try{n=await e.clone().json()}catch{try{n=await e.text()}catch{n=null}}return new i.TempestApiError(i.buildApiError(e.status,n,e.headers,t))}function h(s){let h=s.fetcher??globalThis.fetch.bind(globalThis);function g(e,t){if(t)return{};let r=s.getToken?.();return r?n.isTrustedCredentialTarget(e,s.baseURL,s.trustedOrigins)?{Authorization:`Bearer ${r}`}:(n.reportSuppressedCredential(e,s.baseURL),{}):{}}async function _(e,n,r,a){let{body:c,params:l,headers:p,signal:m,timeout:_,...v}=n,y=f(c),b=y?s.uploadTimeout:s.timeout,x=_===void 0?b===void 0?y?d:u:b:_,S=t.buildApiUrl(s.baseURL,e,{prefix:s.prefix,params:l}),C={...y?{}:{"Content-Type":`application/json`},...r?{"X-Request-ID":r}:{},...s.headers,...g(S,a),...p},w=o.withTimeout(m,x),T={...v,signal:w.signal,headers:C,credentials:s.withCredentials?`include`:v.credentials,body:c==null?void 0:y?c:JSON.stringify(c)};try{return await h(S,T)}catch(e){throw w.timedOut()?new i.TempestApiError({status:0,detail:`A requisição excedeu ${x}ms e foi abandonada.`}):e}finally{w.dispose()}}async function v(e,t,n,r,i){let a=s.logger;if(!a)return _(e,t,n,i);let o=performance.now();try{let s=await _(e,t,n,i),c={requestId:n,status:s.status,ms:p(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:p(o),error:t}),t}}async function y(e,t){if(s.onUnauthorized){s.logger?.warn(`unauthorized — calling onUnauthorized`,{requestId:t,status:e.status});try{await s.onUnauthorized(e)}catch(n){s.logger?.warn(`onUnauthorized threw — keeping the original response error`,{requestId:t,status:e.status,error:n})}}}async function b(t,n,r){let{skipAuth:i=!1,skipAuthRetry:a=!1,...o}=n,c=s.requestId?s.requestId():e.randomId(),l=(o.method??`GET`).toUpperCase(),u=await v(t,o,c,l,i);if(u.status===401&&!i&&!a){if(s.refresh){try{await s.refresh(),u=await v(t,o,c,l,i)}catch{throw await y(u,c),await m(u,c)}u.status===401&&await y(u,c)}else await y(u,c)}if(!u.ok)throw await m(u,c);return r(u)}async function x(e,t,n){let{retry:r,...i}=t,o=l(r===void 0?s.retry:r);if(!o)return b(e,i,n);let u=(i.method??`GET`).toUpperCase();return a.retry(()=>b(e,i,n),{...o,shouldRetry:o.shouldRetry??(e=>c(e,u))})}async function S(e,t={}){return x(e,t,r.decodeByContentType)}async function C(e,t,n=`POST`,r){return S(e,{...r,method:n,body:t})}return{request:S,get:(e,t)=>S(e,{...t,method:`GET`}),post:(e,t)=>S(e,{...t,method:`POST`}),put:(e,t)=>S(e,{...t,method:`PUT`}),patch:(e,t)=>S(e,{...t,method:`PATCH`}),delete:(e,t)=>S(e,{...t,method:`DELETE`}),blob:(e,t)=>x(e,{...t},e=>e.blob()),arrayBuffer:(e,t)=>x(e,{...t},e=>e.arrayBuffer()),upload:C}}exports.createApiClient=h;
 //# 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 { decodeByContentType } from \"./decode-response\";\nimport type { ResponseDecoder } from \"./decode-response\";\nimport { buildApiError, TempestApiError, isRetriableStatus } from \"./errors\";\nimport { retry as retryWithBackoff } from \"./retry\";\nimport type { RetryOptions } from \"./retry\";\nimport { withTimeout } from \"./timeout\";\nimport type { ApiClient, ApiClientConfig, 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 * **Retries** are off unless you set `retry`. See {@link ApiClientConfig.retry}\n * for the built-in policy; it never replays a write.\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    function authHeaders(): Record<string, string> {\n        const token = config.getToken?.();\n        return token ? { Authorization: `Bearer ${token}` } : {};\n    }\n\n    async function rawRequest(\n        path: string,\n        options: RequestOptions,\n        requestId?: string,\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 finalHeaders: Record<string, string> = {\n            ...(isForm ? {} : { \"Content-Type\": \"application/json\" }),\n            ...(requestId ? { \"X-Request-ID\": requestId } : {}),\n            ...config.headers,\n            ...authHeaders(),\n            ...(headers as Record<string, string> | undefined),\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        const url = buildApiUrl(config.baseURL, path, { prefix: config.prefix, params });\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    ): Promise<Response> {\n        const log = config.logger;\n        if (!log) return rawRequest(path, options, requestId);\n\n        const startedAt = performance.now();\n        try {\n            const response = await rawRequest(path, options, requestId);\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    async function notifyUnauthorized(response: Response, requestId: string): 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);\n        } catch (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    async function attempt<T>(\n        path: string,\n        options: RequestOptions,\n        decode: ResponseDecoder<T>,\n    ): Promise<T> {\n        const requestId = config.requestId ? config.requestId() : randomId();\n        const method = (options.method ?? \"GET\").toUpperCase();\n        let response = await send(path, options, requestId, method);\n\n        if (response.status === 401) {\n            if (config.refresh) {\n                try {\n                    await config.refresh();\n                    response = await send(path, options, requestId, method);\n                } catch {\n                    await notifyUnauthorized(response, requestId);\n                    throw await parseError(response, requestId);\n                }\n                if (response.status === 401) {\n                    await notifyUnauthorized(response, requestId);\n                }\n            } else {\n                await notifyUnauthorized(response, requestId);\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 retryOptions = resolveRetry(config.retry);\n        if (!retryOptions) return attempt<T>(path, options, decode);\n\n        const method = (options.method ?? \"GET\").toUpperCase();\n        return retryWithBackoff(() => attempt<T>(path, options, 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":"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"}
+{"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 { decodeByContentType } from \"./decode-response\";\nimport type { ResponseDecoder } from \"./decode-response\";\nimport { buildApiError, TempestApiError, isRetriableStatus } from \"./errors\";\nimport { retry as retryWithBackoff } from \"./retry\";\nimport type { RetryOptions } from \"./retry\";\nimport { withTimeout } from \"./timeout\";\nimport type { ApiClient, ApiClientConfig, 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 * **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 finalHeaders: Record<string, string> = {\n            ...(isForm ? {} : { \"Content-Type\": \"application/json\" }),\n            ...(requestId ? { \"X-Request-ID\": requestId } : {}),\n            ...config.headers,\n            ...authHeaders(url, skipAuth),\n            ...(headers as Record<string, string> | undefined),\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    async function notifyUnauthorized(response: Response, requestId: string): 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);\n        } catch (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    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        let response = await send(path, init, requestId, method, skipAuth);\n\n        if (response.status === 401 && !skipAuth && !skipAuthRetry) {\n            if (config.refresh) {\n                try {\n                    await config.refresh();\n                    response = await send(path, init, requestId, method, skipAuth);\n                } catch {\n                    await notifyUnauthorized(response, requestId);\n                    throw await parseError(response, requestId);\n                }\n                if (response.status === 401) {\n                    await notifyUnauthorized(response, requestId);\n                }\n            } else {\n                await notifyUnauthorized(response, requestId);\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":"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"}

package/dist/http/api-client.js

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