tempest-react-sdk 0.25.0 → 0.26.1

package/dist/components/VirtualTable/VirtualTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualTable.js","names":[],"sources":["../../../src/components/VirtualTable/VirtualTable.tsx"],"sourcesContent":["import {\n    type HTMLAttributes,\n    type ReactNode,\n    useCallback,\n    useEffect,\n    useMemo,\n    useRef,\n    useState,\n} from \"react\";\n\nimport { cn } from \"@/utils/cn\";\nimport { compareValues } from \"@/utils/compare-values\";\n\nimport type { TableAlign } from \"../Table\";\nimport styles from \"./VirtualTable.module.css\";\n\nexport type VirtualTableSortDirection = \"asc\" | \"desc\";\n\nexport interface VirtualTableSort<T> {\n    key: keyof T;\n    direction: VirtualTableSortDirection;\n}\n\nexport interface VirtualTableColumn<T> {\n    /** Property of the row this column reads from. Doubles as the cell key. */\n    key: keyof T;\n    /** Column heading. */\n    header: ReactNode;\n    /** Custom cell renderer. Defaults to `row[key]`. */\n    render?: (row: T, index: number) => ReactNode;\n    /** Enable click-to-sort on this column's header. */\n    sortable?: boolean;\n    /** Text alignment. */\n    align?: TableAlign;\n    /**\n     * Column width. Recommended for every column: virtualized rows enter and\n     * leave the DOM as you scroll, so letting the browser auto-size columns from\n     * whatever is currently rendered makes them jump mid-scroll.\n     */\n    width?: string | number;\n}\n\nexport interface VirtualTableProps<T> extends Omit<HTMLAttributes<HTMLDivElement>, \"children\"> {\n    /** Full dataset. Every row is accounted for; only the visible ones render. */\n    data: T[];\n    /** Column definitions. */\n    columns: VirtualTableColumn<T>[];\n    /**\n     * Row height in px. Must be uniform and must match what the CSS produces,\n     * because it is what maps scroll offset to row index.\n     */\n    rowHeight: number;\n    /** Height of the scroll viewport — a number of px or any CSS length. */\n    height: number | string;\n    /** Rows rendered above and below the viewport. Default `4`. */\n    overscan?: number;\n    /** Stable key extractor. Defaults to the row's index in `data`. */\n    rowKey?: (row: T, index: number) => string | number;\n    /** Sort applied before any header interaction. */\n    initialSort?: VirtualTableSort<T>;\n    /** Called when a row is activated by click, `Enter` or `Space`. */\n    onRowClick?: (row: T, index: number) => void;\n    /** Content shown when `data` is empty. */\n    emptyMessage?: ReactNode;\n    /** Accessible name for the table. Rendered as a visually hidden `<caption>`. */\n    caption?: ReactNode;\n    /** Scroll this row into view whenever it changes. */\n    scrollToIndex?: number;\n}\n\n/** Resolve a column's alignment to its CSS module class. */\nfunction alignClass(align: TableAlign | undefined): string | undefined {\n    if (align === \"right\") return styles.alignRight;\n    if (align === \"center\") return styles.alignCenter;\n    return undefined;\n}\n\n/**\n * A table that stays responsive at 10k+ rows by rendering only the visible window.\n *\n * `Table` renders every row it is given and `DataTable` paginates to keep that\n * count small; neither has an answer for \"show me all 40 000 rows in one\n * scrollable grid\". This does, at the cost of one constraint: **`rowHeight` must\n * be uniform**, since mapping a scroll offset to a row index is what makes the\n * window computable without measuring anything.\n *\n * It stays a real `<table>`. The window is produced by two spacer rows — one\n * above the visible slice, one below — instead of absolutely positioning rows.\n * That is deliberate: `position: absolute` on `<tr>` collapses table layout, so\n * every column width would have to be computed by hand, and the element would\n * stop being a table for assistive technology. With spacer rows the browser keeps\n * doing column layout and screen readers keep announcing a grid.\n *\n * Because only a slice is in the DOM, `aria-rowcount` on the table and\n * `aria-rowindex` on each row carry the real numbers — without them a screen\n * reader announces \"row 3 of 20\" while the user is on row 5003 of 40 000.\n *\n * @example\n * <VirtualTable\n *     data={rows}\n *     columns={[\n *         { key: \"id\", header: \"#\", width: 80, sortable: true },\n *         { key: \"name\", header: \"Nome\", width: 240, sortable: true },\n *         { key: \"total\", header: \"Total\", align: \"right\", width: 120, sortable: true },\n *     ]}\n *     rowHeight={40}\n *     height={480}\n *     rowKey={(row) => row.id}\n * />\n */\nexport function VirtualTable<T>({\n    data,\n    columns,\n    rowHeight,\n    height,\n    overscan = 4,\n    rowKey,\n    initialSort,\n    onRowClick,\n    emptyMessage = \"Nenhum registro encontrado.\",\n    caption,\n    scrollToIndex,\n    className,\n    ...rest\n}: VirtualTableProps<T>) {\n    const scrollRef = useRef<HTMLDivElement>(null);\n    const [scrollTop, setScrollTop] = useState<number>(0);\n    const [viewport, setViewport] = useState<number>(0);\n    const [sort, setSort] = useState<VirtualTableSort<T> | null>(initialSort ?? null);\n\n    useEffect(() => {\n        const element = scrollRef.current;\n        if (!element) return;\n        setViewport(element.clientHeight);\n        if (typeof ResizeObserver === \"undefined\") return;\n        const observer = new ResizeObserver(() => setViewport(element.clientHeight));\n        observer.observe(element);\n        return () => observer.disconnect();\n    }, []);\n\n    useEffect(() => {\n        const element = scrollRef.current;\n        if (!element || scrollToIndex == null) return;\n        element.scrollTop = Math.max(0, Math.min(scrollToIndex, data.length - 1)) * rowHeight;\n    }, [scrollToIndex, rowHeight, data.length]);\n\n    const sorted = useMemo<T[]>(() => {\n        if (!sort) return data;\n        const factor = sort.direction === \"asc\" ? 1 : -1;\n        return [...data].sort((a, b) => compareValues(a[sort.key], b[sort.key]) * factor);\n    }, [data, sort]);\n\n    const start = Math.max(0, Math.floor(scrollTop / rowHeight) - overscan);\n    const windowSize = Math.ceil(viewport / rowHeight) + overscan * 2;\n    const end = Math.min(sorted.length, start + windowSize);\n    const slice = sorted.slice(start, end);\n\n    /**\n     * Advance a column through asc → desc → unsorted, and jump back to the top.\n     *\n     * The scroll reset happens here rather than in an effect keyed on the sort\n     * state for two reasons: this is the actual event that invalidates the offset\n     * (keeping it would leave the user at the same pixel of a different dataset,\n     * which reads as the table having jumped somewhere random), and an effect would\n     * also fire on mount — clobbering an initial `scrollToIndex`.\n     */\n    const toggleSort = useCallback((key: keyof T): void => {\n        setSort((current) => {\n            if (!current || current.key !== key) return { key, direction: \"asc\" };\n            if (current.direction === \"asc\") return { key, direction: \"desc\" };\n            return null;\n        });\n        const element = scrollRef.current;\n        if (element) element.scrollTop = 0;\n        setScrollTop(0);\n    }, []);\n\n    return (\n        <div\n            ref={scrollRef}\n            className={cn(styles.scroll, className)}\n            style={{ height }}\n            onScroll={(event) => setScrollTop(event.currentTarget.scrollTop)}\n            {...rest}\n        >\n            <table className={styles.table} aria-rowcount={sorted.length}>\n                {caption ? <caption className={styles.caption}>{caption}</caption> : null}\n                <thead className={styles.head}>\n                    <tr>\n                        {columns.map((column) => {\n                            const isSorted = sort?.key === column.key;\n                            return (\n                                <th\n                                    key={String(column.key)}\n                                    scope=\"col\"\n                                    className={cn(styles.th, alignClass(column.align))}\n                                    style={{ width: column.width }}\n                                    aria-sort={\n                                        isSorted\n                                            ? sort?.direction === \"asc\"\n                                                ? \"ascending\"\n                                                : \"descending\"\n                                            : column.sortable\n                                              ? \"none\"\n                                              : undefined\n                                    }\n                                >\n                                    {column.sortable ? (\n                                        <button\n                                            type=\"button\"\n                                            className={styles.sortButton}\n                                            onClick={() => toggleSort(column.key)}\n                                        >\n                                            {column.header}\n                                            <span className={styles.sortIndicator} aria-hidden>\n                                                {isSorted\n                                                    ? sort?.direction === \"asc\"\n                                                        ? \"▲\"\n                                                        : \"▼\"\n                                                    : \"↕\"}\n                                            </span>\n                                        </button>\n                                    ) : (\n                                        column.header\n                                    )}\n                                </th>\n                            );\n                        })}\n                    </tr>\n                </thead>\n                <tbody>\n                    {sorted.length === 0 ? (\n                        <tr>\n                            <td className={styles.emptyRow} colSpan={columns.length}>\n                                {emptyMessage}\n                            </td>\n                        </tr>\n                    ) : (\n                        <>\n                            {start > 0 && <tr aria-hidden style={{ height: start * rowHeight }} />}\n                            {slice.map((row, offset) => {\n                                const index = start + offset;\n                                return (\n                                    <tr\n                                        key={rowKey ? rowKey(row, index) : index}\n                                        aria-rowindex={index + 1}\n                                        className={cn(styles.tr, onRowClick && styles.clickable)}\n                                        style={{ height: rowHeight }}\n                                        tabIndex={onRowClick ? 0 : undefined}\n                                        onClick={\n                                            onRowClick ? () => onRowClick(row, index) : undefined\n                                        }\n                                        onKeyDown={\n                                            onRowClick\n                                                ? (event) => {\n                                                      if (\n                                                          event.key === \"Enter\" ||\n                                                          event.key === \" \"\n                                                      ) {\n                                                          event.preventDefault();\n                                                          onRowClick(row, index);\n                                                      }\n                                                  }\n                                                : undefined\n                                        }\n                                    >\n                                        {columns.map((column) => (\n                                            <td\n                                                key={String(column.key)}\n                                                className={cn(styles.td, alignClass(column.align))}\n                                                style={{ width: column.width }}\n                                            >\n                                                {column.render\n                                                    ? column.render(row, index)\n                                                    : ((row[column.key] as ReactNode) ?? null)}\n                                            </td>\n                                        ))}\n                                    </tr>\n                                );\n                            })}\n                            {end < sorted.length && (\n                                <tr\n                                    aria-hidden\n                                    style={{ height: (sorted.length - end) * rowHeight }}\n                                />\n                            )}\n                        </>\n                    )}\n                </tbody>\n            </table>\n        </div>\n    );\n}\n"],"mappings":"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"}

package/dist/components/VirtualTable/VirtualTable.module.cjs

@@ -0,0 +1,2 @@
+var e=`tempest_scroll_XOPRs`,t=`tempest_table_wbJg-`,n=`tempest_caption_Dt-O5`,r=`tempest_head_9xVmx`,i=`tempest_th_-xzNL`,a=`tempest_td_Crp7i`,o=`tempest_alignRight_uxhpx`,s=`tempest_alignCenter_9B3Sb`,c=`tempest_sortButton_4h-vK`,l=`tempest_sortIndicator_-WpMp`,u=`tempest_tr_EI3uW`,d=`tempest_clickable_4AfSX`,f=`tempest_emptyRow_4kIiT`,p={scroll:e,table:t,caption:n,head:r,th:i,td:a,alignRight:o,alignCenter:s,sortButton:c,sortIndicator:l,tr:u,clickable:d,emptyRow:f};exports.alignCenter=s,exports.alignRight=o,exports.caption=n,exports.clickable=d,exports.default=p,exports.emptyRow=f,exports.head=r,exports.scroll=e,exports.sortButton=c,exports.sortIndicator=l,exports.table=t,exports.td=a,exports.th=i,exports.tr=u;
+//# sourceMappingURL=VirtualTable.module.cjs.map

package/dist/components/VirtualTable/VirtualTable.module.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualTable.module.cjs","names":[],"sources":["../../../src/components/VirtualTable/VirtualTable.module.css"],"sourcesContent":[".scroll {\n    width: 100%;\n    overflow: auto;\n    border: 1px solid var(--tempest-border);\n    border-radius: var(--tempest-radius-lg);\n    background-color: var(--tempest-bg);\n    box-shadow: var(--tempest-shadow-xs);\n}\n\n.table {\n    width: 100%;\n    border-collapse: separate;\n    border-spacing: 0;\n    font-family: var(--tempest-font-sans);\n    font-size: var(--tempest-text-base);\n    line-height: var(--tempest-leading-snug);\n    /*\n     * Fixed layout is what keeps columns from jumping mid-scroll: with `auto`,\n     * the browser sizes each column from the rows currently in the DOM, and a\n     * virtualized table swaps those rows out as you scroll.\n     */\n    table-layout: fixed;\n}\n\n.caption {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    padding: 0;\n    margin: -1px;\n    overflow: hidden;\n    clip-path: inset(50%);\n    white-space: nowrap;\n    border-width: 0;\n}\n\n/*\n * `border-collapse: separate` above exists for this: a sticky `<th>` inside a\n * collapsed table loses its bottom border while scrolling, because the shared\n * border belongs to the cell that scrolled away.\n */\n.head .th {\n    position: sticky;\n    top: 0;\n    z-index: 1;\n}\n\n.th,\n.td {\n    padding: 0 var(--tempest-space-4);\n    text-align: left;\n    border-bottom: 1px solid var(--tempest-border);\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n}\n\n.th {\n    padding-block: var(--tempest-space-3);\n    background-color: var(--tempest-surface);\n    color: var(--tempest-text-muted);\n    font-weight: var(--tempest-weight-semibold);\n    font-size: var(--tempest-text-xs);\n    letter-spacing: var(--tempest-tracking-wider);\n    text-transform: uppercase;\n}\n\n.alignRight {\n    text-align: right;\n}\n\n.alignCenter {\n    text-align: center;\n}\n\n.sortButton {\n    display: inline-flex;\n    align-items: center;\n    gap: var(--tempest-space-1);\n    padding: 0;\n    border: none;\n    background: none;\n    color: inherit;\n    font: inherit;\n    letter-spacing: inherit;\n    text-transform: inherit;\n    cursor: pointer;\n}\n\n.sortButton:focus-visible {\n    outline: 2px solid var(--tempest-primary);\n    outline-offset: 2px;\n    border-radius: var(--tempest-radius-sm);\n}\n\n.sortIndicator {\n    font-size: var(--tempest-text-xs);\n    opacity: 0.55;\n}\n\n.tr.clickable {\n    cursor: pointer;\n    transition: background-color var(--tempest-duration-fast) var(--tempest-ease-out);\n}\n\n@media (hover: hover) and (pointer: fine) {\n    .tr.clickable:hover {\n        background-color: var(--tempest-surface);\n    }\n}\n\n.tr.clickable:focus-visible {\n    outline: 2px solid var(--tempest-primary);\n    outline-offset: -2px;\n}\n\n.emptyRow {\n    padding: var(--tempest-space-8) var(--tempest-space-4);\n    text-align: center;\n    color: var(--tempest-text-muted);\n}\n\n@media (prefers-reduced-motion: reduce) {\n    .tr.clickable {\n        transition: none;\n    }\n}\n"],"mappings":""}

package/dist/components/VirtualTable/VirtualTable.module.js

@@ -0,0 +1,20 @@
+//#region src/components/VirtualTable/VirtualTable.module.css
+var e = "tempest_scroll_XOPRs", t = "tempest_table_wbJg-", n = "tempest_caption_Dt-O5", r = "tempest_head_9xVmx", i = "tempest_th_-xzNL", a = "tempest_td_Crp7i", o = "tempest_alignRight_uxhpx", s = "tempest_alignCenter_9B3Sb", c = "tempest_sortButton_4h-vK", l = "tempest_sortIndicator_-WpMp", u = "tempest_tr_EI3uW", d = "tempest_clickable_4AfSX", f = "tempest_emptyRow_4kIiT", p = {
+	scroll: e,
+	table: t,
+	caption: n,
+	head: r,
+	th: i,
+	td: a,
+	alignRight: o,
+	alignCenter: s,
+	sortButton: c,
+	sortIndicator: l,
+	tr: u,
+	clickable: d,
+	emptyRow: f
+};
+//#endregion
+export { s as alignCenter, o as alignRight, n as caption, d as clickable, p as default, f as emptyRow, r as head, e as scroll, c as sortButton, l as sortIndicator, t as table, a as td, i as th, u as tr };
+
+//# sourceMappingURL=VirtualTable.module.js.map

package/dist/components/VirtualTable/VirtualTable.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualTable.module.js","names":[],"sources":["../../../src/components/VirtualTable/VirtualTable.module.css"],"sourcesContent":[".scroll {\n    width: 100%;\n    overflow: auto;\n    border: 1px solid var(--tempest-border);\n    border-radius: var(--tempest-radius-lg);\n    background-color: var(--tempest-bg);\n    box-shadow: var(--tempest-shadow-xs);\n}\n\n.table {\n    width: 100%;\n    border-collapse: separate;\n    border-spacing: 0;\n    font-family: var(--tempest-font-sans);\n    font-size: var(--tempest-text-base);\n    line-height: var(--tempest-leading-snug);\n    /*\n     * Fixed layout is what keeps columns from jumping mid-scroll: with `auto`,\n     * the browser sizes each column from the rows currently in the DOM, and a\n     * virtualized table swaps those rows out as you scroll.\n     */\n    table-layout: fixed;\n}\n\n.caption {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    padding: 0;\n    margin: -1px;\n    overflow: hidden;\n    clip-path: inset(50%);\n    white-space: nowrap;\n    border-width: 0;\n}\n\n/*\n * `border-collapse: separate` above exists for this: a sticky `<th>` inside a\n * collapsed table loses its bottom border while scrolling, because the shared\n * border belongs to the cell that scrolled away.\n */\n.head .th {\n    position: sticky;\n    top: 0;\n    z-index: 1;\n}\n\n.th,\n.td {\n    padding: 0 var(--tempest-space-4);\n    text-align: left;\n    border-bottom: 1px solid var(--tempest-border);\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n}\n\n.th {\n    padding-block: var(--tempest-space-3);\n    background-color: var(--tempest-surface);\n    color: var(--tempest-text-muted);\n    font-weight: var(--tempest-weight-semibold);\n    font-size: var(--tempest-text-xs);\n    letter-spacing: var(--tempest-tracking-wider);\n    text-transform: uppercase;\n}\n\n.alignRight {\n    text-align: right;\n}\n\n.alignCenter {\n    text-align: center;\n}\n\n.sortButton {\n    display: inline-flex;\n    align-items: center;\n    gap: var(--tempest-space-1);\n    padding: 0;\n    border: none;\n    background: none;\n    color: inherit;\n    font: inherit;\n    letter-spacing: inherit;\n    text-transform: inherit;\n    cursor: pointer;\n}\n\n.sortButton:focus-visible {\n    outline: 2px solid var(--tempest-primary);\n    outline-offset: 2px;\n    border-radius: var(--tempest-radius-sm);\n}\n\n.sortIndicator {\n    font-size: var(--tempest-text-xs);\n    opacity: 0.55;\n}\n\n.tr.clickable {\n    cursor: pointer;\n    transition: background-color var(--tempest-duration-fast) var(--tempest-ease-out);\n}\n\n@media (hover: hover) and (pointer: fine) {\n    .tr.clickable:hover {\n        background-color: var(--tempest-surface);\n    }\n}\n\n.tr.clickable:focus-visible {\n    outline: 2px solid var(--tempest-primary);\n    outline-offset: -2px;\n}\n\n.emptyRow {\n    padding: var(--tempest-space-8) var(--tempest-space-4);\n    text-align: center;\n    color: var(--tempest-text-muted);\n}\n\n@media (prefers-reduced-motion: reduce) {\n    .tr.clickable {\n        transition: none;\n    }\n}\n"],"mappings":""}

package/dist/components/Wizard/Wizard.cjs

@@ -1,2 +1,2 @@
-const e=require("../../utils/cn.cjs"),t=require("../Button/Button.cjs"),n=require("../Stepper/Stepper.cjs"),r=require("./Wizard.module.cjs");let i=require("react"),a=require("react/jsx-runtime");function o({steps:o,activeIndex:s,defaultActiveIndex:c=0,onStepChange:l,onComplete:u,nextLabel:d=`Next`,backLabel:f=`Back`,finishLabel:p=`Finish`,clickableSteps:m=!1,renderActions:h,className:g}){let _=s!==void 0,[v,y]=(0,i.useState)(c),[b,x]=(0,i.useState)(!1),S=Math.min(_?s:v,o.length-1),C=o[S],w=(0,i.useCallback)(e=>{_||y(e),l?.(e,o[e])},[_,l,o]),T=(0,i.useCallback)(async e=>{if(!e.validate)return!0;x(!0);try{return await e.validate()}catch{return!1}finally{x(!1)}},[]),E=(0,i.useCallback)(async()=>{if(await T(C)){if(S===o.length-1){await u?.();return}w(S+1)}},[S,w,u,T,C,o.length]),D=(0,i.useCallback)(()=>{S>0&&w(S-1)},[S,w]),O=(0,i.useCallback)(async e=>{let t=Math.max(0,Math.min(e,o.length-1));if(t!==S){if(t<S){w(t);return}for(let e=S;e<t;e+=1)if(!await T(o[e]))return;w(t)}},[S,w,T,o]),k=(0,i.useMemo)(()=>({activeIndex:S,step:C,validating:b,isFirst:S===0,isLast:S===o.length-1,next:E,back:D,goTo:O}),[D,S,O,E,C,o.length,b]),A=(0,i.useMemo)(()=>o.map(e=>({label:e.label,description:e.optional?`${e.description??``} (optional)`.trim():e.description})),[o]);return(0,a.jsxs)(`div`,{className:e.cn(r.default.wizard,g),children:[(0,a.jsx)(n.Stepper,{steps:A,current:S,onStepClick:m?e=>void O(e):void 0}),(0,a.jsx)(`div`,{className:r.default.body,role:`group`,"aria-label":C.label,children:typeof C.content==`function`?C.content(k):C.content}),h?h(k):(0,a.jsxs)(`div`,{className:r.default.actions,children:[(0,a.jsx)(t.Button,{variant:`secondary`,onClick:D,disabled:k.isFirst||b,children:f}),(0,a.jsx)(t.Button,{onClick:()=>void E(),loading:b,children:k.isLast?p:d})]})]})}exports.Wizard=o;
+const e=require("../../utils/cn.cjs"),t=require("../Button/Button.cjs"),n=require("../Stepper/Stepper.cjs"),r=require("./Wizard.module.cjs");let i=require("react"),a=require("react/jsx-runtime");function o({steps:o,activeIndex:s,defaultActiveIndex:c=0,onStepChange:l,onComplete:u,nextLabel:d=`Next`,backLabel:f=`Back`,finishLabel:p=`Finish`,optionalLabel:m=`(optional)`,clickableSteps:h=!1,renderActions:g,className:_}){let v=s!==void 0,[y,b]=(0,i.useState)(c),[x,S]=(0,i.useState)(!1),C=Math.min(v?s:y,o.length-1),w=o[C],T=(0,i.useCallback)(e=>{v||b(e),l?.(e,o[e])},[v,l,o]),E=(0,i.useCallback)(async e=>{if(!e.validate)return!0;S(!0);try{return await e.validate()}catch{return!1}finally{S(!1)}},[]),D=(0,i.useCallback)(async()=>{if(await E(w)){if(C===o.length-1){await u?.();return}T(C+1)}},[C,T,u,E,w,o.length]),O=(0,i.useCallback)(()=>{C>0&&T(C-1)},[C,T]),k=(0,i.useCallback)(async e=>{let t=Math.max(0,Math.min(e,o.length-1));if(t!==C){if(t<C){T(t);return}for(let e=C;e<t;e+=1)if(!await E(o[e]))return;T(t)}},[C,T,E,o]),A=(0,i.useMemo)(()=>({activeIndex:C,step:w,validating:x,isFirst:C===0,isLast:C===o.length-1,next:D,back:O,goTo:k}),[O,C,k,D,w,o.length,x]),j=(0,i.useMemo)(()=>o.map(e=>({label:e.label,description:e.optional?`${e.description??``} ${m}`.trim():e.description})),[m,o]);return(0,a.jsxs)(`div`,{className:e.cn(r.default.wizard,_),children:[(0,a.jsx)(n.Stepper,{steps:j,current:C,onStepClick:h?e=>void k(e):void 0}),(0,a.jsx)(`div`,{className:r.default.body,role:`group`,"aria-label":w.label,children:typeof w.content==`function`?w.content(A):w.content}),g?g(A):(0,a.jsxs)(`div`,{className:r.default.actions,children:[(0,a.jsx)(t.Button,{variant:`secondary`,onClick:O,disabled:A.isFirst||x,children:f}),(0,a.jsx)(t.Button,{onClick:()=>void D(),loading:x,children:A.isLast?p:d})]})]})}exports.Wizard=o;
 //# sourceMappingURL=Wizard.cjs.map

package/dist/components/Wizard/Wizard.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Wizard.cjs","names":[],"sources":["../../../src/components/Wizard/Wizard.tsx"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { cn } from \"@/utils/cn\";\nimport { Button } from \"../Button\";\nimport { Stepper } from \"../Stepper\";\nimport styles from \"./Wizard.module.css\";\n\n/** One step of the flow. */\nexport interface WizardStep {\n    /** Stable identifier. */\n    id: string;\n    /** Step label shown in the indicator. */\n    label: string;\n    /** Optional description under the label. */\n    description?: string;\n    /** Step body. A function receives the flow controls, for a \"skip\" link inside the form. */\n    content: ReactNode | ((controls: WizardControls) => ReactNode);\n    /**\n     * Gate for leaving this step forward. Return `false` (or a rejected/`false`\n     * promise) to keep the user here — typically `() => form.trigger()`.\n     * Async is supported: the Next button shows a pending state while it runs.\n     */\n    validate?: () => boolean | Promise<boolean>;\n    /** Marks the step as optional, so `onComplete` can ignore it. */\n    optional?: boolean;\n}\n\n/** Flow controls handed to a step body and to `renderActions`. */\nexport interface WizardControls {\n    /** Zero-based index of the current step. */\n    activeIndex: number;\n    /** The current step. */\n    step: WizardStep;\n    /** `true` while a `validate` promise is pending. */\n    validating: boolean;\n    isFirst: boolean;\n    isLast: boolean;\n    /** Run the current step's `validate` and advance when it passes. */\n    next: () => Promise<void>;\n    /** Go back one step. No validation — going back never blocks. */\n    back: () => void;\n    /** Jump to an index. Forward jumps validate every step in between. */\n    goTo: (index: number) => Promise<void>;\n}\n\nexport interface WizardProps {\n    steps: WizardStep[];\n    /** Controlled active index. */\n    activeIndex?: number;\n    /** Uncontrolled initial index. Default `0`. */\n    defaultActiveIndex?: number;\n    onStepChange?: (index: number, step: WizardStep) => void;\n    /** Called when the last step passes validation. */\n    onComplete?: () => void | Promise<void>;\n    /** Label of the advance button. Default `\"Next\"`. */\n    nextLabel?: string;\n    /** Label of the back button. Default `\"Back\"`. */\n    backLabel?: string;\n    /** Label of the button on the last step. Default `\"Finish\"`. */\n    finishLabel?: string;\n    /**\n     * Allow clicking the indicator to jump. Default `false` — a wizard exists\n     * because order matters, and a free jump skips the gates.\n     */\n    clickableSteps?: boolean;\n    /** Replace the default button row. */\n    renderActions?: (controls: WizardControls) => ReactNode;\n    className?: string;\n}\n\n/**\n * Multi-step flow: step indicator, one body at a time, and navigation that\n * respects per-step validation.\n *\n * `Stepper` draws the indicator; this owns the part every app was rewriting — the\n * active index, the async gate before advancing, the disabled/pending buttons and\n * the completion call.\n *\n * Only the active step's body is mounted. Uncommitted input in a step you leave is\n * therefore lost unless the state lives outside (react-hook-form's `FormProvider`,\n * a store, a parent `useState`) — which is the right place for it anyway, since\n * the last step usually needs to submit everything at once.\n *\n * @example\n * ```tsx\n * const form = useZodForm(schema);\n *\n * <FormProvider {...form}>\n *   <Wizard\n *     steps={[\n *       {\n *         id: \"dados\",\n *         label: \"Dados\",\n *         validate: () => form.trigger([\"nome\", \"email\"]),\n *         content: (\n *           <>\n *             <FormField name=\"nome\" label=\"Nome\"><Input /></FormField>\n *             <FormField name=\"email\" label=\"E-mail\"><Input type=\"email\" /></FormField>\n *           </>\n *         ),\n *       },\n *       { id: \"revisao\", label: \"Revisão\", content: <Review /> },\n *     ]}\n *     onComplete={form.handleSubmit(onSubmit)}\n *   />\n * </FormProvider>\n * ```\n */\nexport function Wizard({\n    steps,\n    activeIndex,\n    defaultActiveIndex = 0,\n    onStepChange,\n    onComplete,\n    nextLabel = \"Next\",\n    backLabel = \"Back\",\n    finishLabel = \"Finish\",\n    clickableSteps = false,\n    renderActions,\n    className,\n}: WizardProps) {\n    const isControlled = activeIndex !== undefined;\n    const [internalIndex, setInternalIndex] = useState(defaultActiveIndex);\n    const [validating, setValidating] = useState(false);\n\n    const current = Math.min(isControlled ? activeIndex : internalIndex, steps.length - 1);\n    const step = steps[current];\n\n    const moveTo = useCallback(\n        (index: number): void => {\n            if (!isControlled) setInternalIndex(index);\n            onStepChange?.(index, steps[index]);\n        },\n        [isControlled, onStepChange, steps],\n    );\n\n    /**\n     * Run a step's gate. A gate that throws counts as \"not allowed\": a `validate`\n     * wired to a network check should not strand the user on a half-advanced flow\n     * when the request fails.\n     */\n    const runValidate = useCallback(async (candidate: WizardStep): Promise<boolean> => {\n        if (!candidate.validate) return true;\n        setValidating(true);\n        try {\n            return await candidate.validate();\n        } catch {\n            return false;\n        } finally {\n            setValidating(false);\n        }\n    }, []);\n\n    const next = useCallback(async (): Promise<void> => {\n        if (!(await runValidate(step))) return;\n        if (current === steps.length - 1) {\n            await onComplete?.();\n            return;\n        }\n        moveTo(current + 1);\n    }, [current, moveTo, onComplete, runValidate, step, steps.length]);\n\n    const back = useCallback((): void => {\n        if (current > 0) moveTo(current - 1);\n    }, [current, moveTo]);\n\n    const goTo = useCallback(\n        async (index: number): Promise<void> => {\n            const target = Math.max(0, Math.min(index, steps.length - 1));\n            if (target === current) return;\n            if (target < current) {\n                moveTo(target);\n                return;\n            }\n            for (let i = current; i < target; i += 1) {\n                if (!(await runValidate(steps[i]))) return;\n            }\n            moveTo(target);\n        },\n        [current, moveTo, runValidate, steps],\n    );\n\n    const controls = useMemo<WizardControls>(\n        () => ({\n            activeIndex: current,\n            step,\n            validating,\n            isFirst: current === 0,\n            isLast: current === steps.length - 1,\n            next,\n            back,\n            goTo,\n        }),\n        [back, current, goTo, next, step, steps.length, validating],\n    );\n\n    const indicatorSteps = useMemo(\n        () =>\n            steps.map((item) => ({\n                label: item.label,\n                description: item.optional\n                    ? `${item.description ?? \"\"} (optional)`.trim()\n                    : item.description,\n            })),\n        [steps],\n    );\n\n    return (\n        <div className={cn(styles.wizard, className)}>\n            <Stepper\n                steps={indicatorSteps}\n                current={current}\n                onStepClick={clickableSteps ? (index) => void goTo(index) : undefined}\n            />\n\n            <div className={styles.body} role=\"group\" aria-label={step.label}>\n                {typeof step.content === \"function\" ? step.content(controls) : step.content}\n            </div>\n\n            {renderActions ? (\n                renderActions(controls)\n            ) : (\n                <div className={styles.actions}>\n                    <Button\n                        variant=\"secondary\"\n                        onClick={back}\n                        disabled={controls.isFirst || validating}\n                    >\n                        {backLabel}\n                    </Button>\n                    <Button onClick={() => void next()} loading={validating}>\n                        {controls.isLast ? finishLabel : nextLabel}\n                    </Button>\n                </div>\n            )}\n        </div>\n    );\n}\n"],"mappings":"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"}
+{"version":3,"file":"Wizard.cjs","names":[],"sources":["../../../src/components/Wizard/Wizard.tsx"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { cn } from \"@/utils/cn\";\nimport { Button } from \"../Button\";\nimport { Stepper } from \"../Stepper\";\nimport styles from \"./Wizard.module.css\";\n\n/** One step of the flow. */\nexport interface WizardStep {\n    /** Stable identifier. */\n    id: string;\n    /** Step label shown in the indicator. */\n    label: string;\n    /** Optional description under the label. */\n    description?: string;\n    /** Step body. A function receives the flow controls, for a \"skip\" link inside the form. */\n    content: ReactNode | ((controls: WizardControls) => ReactNode);\n    /**\n     * Gate for leaving this step forward. Return `false` (or a rejected/`false`\n     * promise) to keep the user here — typically `() => form.trigger()`.\n     * Async is supported: the Next button shows a pending state while it runs.\n     */\n    validate?: () => boolean | Promise<boolean>;\n    /** Marks the step as optional, so `onComplete` can ignore it. */\n    optional?: boolean;\n}\n\n/** Flow controls handed to a step body and to `renderActions`. */\nexport interface WizardControls {\n    /** Zero-based index of the current step. */\n    activeIndex: number;\n    /** The current step. */\n    step: WizardStep;\n    /** `true` while a `validate` promise is pending. */\n    validating: boolean;\n    isFirst: boolean;\n    isLast: boolean;\n    /** Run the current step's `validate` and advance when it passes. */\n    next: () => Promise<void>;\n    /** Go back one step. No validation — going back never blocks. */\n    back: () => void;\n    /** Jump to an index. Forward jumps validate every step in between. */\n    goTo: (index: number) => Promise<void>;\n}\n\nexport interface WizardProps {\n    steps: WizardStep[];\n    /** Controlled active index. */\n    activeIndex?: number;\n    /** Uncontrolled initial index. Default `0`. */\n    defaultActiveIndex?: number;\n    onStepChange?: (index: number, step: WizardStep) => void;\n    /** Called when the last step passes validation. */\n    onComplete?: () => void | Promise<void>;\n    /** Label of the advance button. Default `\"Next\"`. */\n    nextLabel?: string;\n    /** Label of the back button. Default `\"Back\"`. */\n    backLabel?: string;\n    /** Label of the button on the last step. Default `\"Finish\"`. */\n    finishLabel?: string;\n    /**\n     * Suffix appended to an optional step's description in the indicator.\n     * Default `\"(optional)\"` — override it to localize, since the SDK ships no\n     * translation for component-internal copy.\n     */\n    optionalLabel?: string;\n    /**\n     * Allow clicking the indicator to jump. Default `false` — a wizard exists\n     * because order matters, and a free jump skips the gates.\n     */\n    clickableSteps?: boolean;\n    /** Replace the default button row. */\n    renderActions?: (controls: WizardControls) => ReactNode;\n    className?: string;\n}\n\n/**\n * Multi-step flow: step indicator, one body at a time, and navigation that\n * respects per-step validation.\n *\n * `Stepper` draws the indicator; this owns the part every app was rewriting — the\n * active index, the async gate before advancing, the disabled/pending buttons and\n * the completion call.\n *\n * Only the active step's body is mounted. Uncommitted input in a step you leave is\n * therefore lost unless the state lives outside (react-hook-form's `FormProvider`,\n * a store, a parent `useState`) — which is the right place for it anyway, since\n * the last step usually needs to submit everything at once.\n *\n * @example\n * ```tsx\n * const form = useZodForm(schema);\n *\n * <FormProvider {...form}>\n *   <Wizard\n *     steps={[\n *       {\n *         id: \"dados\",\n *         label: \"Dados\",\n *         validate: () => form.trigger([\"nome\", \"email\"]),\n *         content: (\n *           <>\n *             <FormField name=\"nome\" label=\"Nome\"><Input /></FormField>\n *             <FormField name=\"email\" label=\"E-mail\"><Input type=\"email\" /></FormField>\n *           </>\n *         ),\n *       },\n *       { id: \"revisao\", label: \"Revisão\", content: <Review /> },\n *     ]}\n *     onComplete={form.handleSubmit(onSubmit)}\n *   />\n * </FormProvider>\n * ```\n */\nexport function Wizard({\n    steps,\n    activeIndex,\n    defaultActiveIndex = 0,\n    onStepChange,\n    onComplete,\n    nextLabel = \"Next\",\n    backLabel = \"Back\",\n    finishLabel = \"Finish\",\n    optionalLabel = \"(optional)\",\n    clickableSteps = false,\n    renderActions,\n    className,\n}: WizardProps) {\n    const isControlled = activeIndex !== undefined;\n    const [internalIndex, setInternalIndex] = useState(defaultActiveIndex);\n    const [validating, setValidating] = useState(false);\n\n    const current = Math.min(isControlled ? activeIndex : internalIndex, steps.length - 1);\n    const step = steps[current];\n\n    const moveTo = useCallback(\n        (index: number): void => {\n            if (!isControlled) setInternalIndex(index);\n            onStepChange?.(index, steps[index]);\n        },\n        [isControlled, onStepChange, steps],\n    );\n\n    /**\n     * Run a step's gate. A gate that throws counts as \"not allowed\": a `validate`\n     * wired to a network check should not strand the user on a half-advanced flow\n     * when the request fails.\n     */\n    const runValidate = useCallback(async (candidate: WizardStep): Promise<boolean> => {\n        if (!candidate.validate) return true;\n        setValidating(true);\n        try {\n            return await candidate.validate();\n        } catch {\n            return false;\n        } finally {\n            setValidating(false);\n        }\n    }, []);\n\n    const next = useCallback(async (): Promise<void> => {\n        if (!(await runValidate(step))) return;\n        if (current === steps.length - 1) {\n            await onComplete?.();\n            return;\n        }\n        moveTo(current + 1);\n    }, [current, moveTo, onComplete, runValidate, step, steps.length]);\n\n    const back = useCallback((): void => {\n        if (current > 0) moveTo(current - 1);\n    }, [current, moveTo]);\n\n    const goTo = useCallback(\n        async (index: number): Promise<void> => {\n            const target = Math.max(0, Math.min(index, steps.length - 1));\n            if (target === current) return;\n            if (target < current) {\n                moveTo(target);\n                return;\n            }\n            for (let i = current; i < target; i += 1) {\n                if (!(await runValidate(steps[i]))) return;\n            }\n            moveTo(target);\n        },\n        [current, moveTo, runValidate, steps],\n    );\n\n    const controls = useMemo<WizardControls>(\n        () => ({\n            activeIndex: current,\n            step,\n            validating,\n            isFirst: current === 0,\n            isLast: current === steps.length - 1,\n            next,\n            back,\n            goTo,\n        }),\n        [back, current, goTo, next, step, steps.length, validating],\n    );\n\n    const indicatorSteps = useMemo(\n        () =>\n            steps.map((item) => ({\n                label: item.label,\n                description: item.optional\n                    ? `${item.description ?? \"\"} ${optionalLabel}`.trim()\n                    : item.description,\n            })),\n        [optionalLabel, steps],\n    );\n\n    return (\n        <div className={cn(styles.wizard, className)}>\n            <Stepper\n                steps={indicatorSteps}\n                current={current}\n                onStepClick={clickableSteps ? (index) => void goTo(index) : undefined}\n            />\n\n            <div className={styles.body} role=\"group\" aria-label={step.label}>\n                {typeof step.content === \"function\" ? step.content(controls) : step.content}\n            </div>\n\n            {renderActions ? (\n                renderActions(controls)\n            ) : (\n                <div className={styles.actions}>\n                    <Button\n                        variant=\"secondary\"\n                        onClick={back}\n                        disabled={controls.isFirst || validating}\n                    >\n                        {backLabel}\n                    </Button>\n                    <Button onClick={() => void next()} loading={validating}>\n                        {controls.isLast ? finishLabel : nextLabel}\n                    </Button>\n                </div>\n            )}\n        </div>\n    );\n}\n"],"mappings":"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"}

package/dist/components/Wizard/Wizard.js

@@ -5,101 +5,101 @@ import r from "./Wizard.module.js";
 import { useCallback as i, useMemo as a, useState as o } from "react";
 import { jsx as s, jsxs as c } from "react/jsx-runtime";
 //#region src/components/Wizard/Wizard.tsx
-function l({ steps: l, activeIndex: u, defaultActiveIndex: d = 0, onStepChange: f, onComplete: p, nextLabel: m = "Next", backLabel: h = "Back", finishLabel: g = "Finish", clickableSteps: _ = !1, renderActions: v, className: y }) {
-	let b = u !== void 0, [x, S] = o(d), [C, w] = o(!1), T = Math.min(b ? u : x, l.length - 1), E = l[T], D = i((e) => {
-		b || S(e), f?.(e, l[e]);
+function l({ steps: l, activeIndex: u, defaultActiveIndex: d = 0, onStepChange: f, onComplete: p, nextLabel: m = "Next", backLabel: h = "Back", finishLabel: g = "Finish", optionalLabel: _ = "(optional)", clickableSteps: v = !1, renderActions: y, className: b }) {
+	let x = u !== void 0, [S, C] = o(d), [w, T] = o(!1), E = Math.min(x ? u : S, l.length - 1), D = l[E], O = i((e) => {
+		x || C(e), f?.(e, l[e]);
 	}, [
-		b,
+		x,
 		f,
 		l
-	]), O = i(async (e) => {
+	]), k = i(async (e) => {
 		if (!e.validate) return !0;
-		w(!0);
+		T(!0);
 		try {
 			return await e.validate();
 		} catch {
 			return !1;
 		} finally {
-			w(!1);
+			T(!1);
 		}
-	}, []), k = i(async () => {
-		if (await O(E)) {
-			if (T === l.length - 1) {
+	}, []), A = i(async () => {
+		if (await k(D)) {
+			if (E === l.length - 1) {
 				await p?.();
 				return;
 			}
-			D(T + 1);
+			O(E + 1);
 		}
 	}, [
-		T,
-		D,
-		p,
-		O,
 		E,
+		O,
+		p,
+		k,
+		D,
 		l.length
-	]), A = i(() => {
-		T > 0 && D(T - 1);
-	}, [T, D]), j = i(async (e) => {
+	]), j = i(() => {
+		E > 0 && O(E - 1);
+	}, [E, O]), M = i(async (e) => {
 		let t = Math.max(0, Math.min(e, l.length - 1));
-		if (t !== T) {
-			if (t < T) {
-				D(t);
+		if (t !== E) {
+			if (t < E) {
+				O(t);
 				return;
 			}
-			for (let e = T; e < t; e += 1) if (!await O(l[e])) return;
-			D(t);
+			for (let e = E; e < t; e += 1) if (!await k(l[e])) return;
+			O(t);
 		}
 	}, [
-		T,
-		D,
+		E,
 		O,
+		k,
 		l
-	]), M = a(() => ({
-		activeIndex: T,
-		step: E,
-		validating: C,
-		isFirst: T === 0,
-		isLast: T === l.length - 1,
-		next: k,
-		back: A,
-		goTo: j
+	]), N = a(() => ({
+		activeIndex: E,
+		step: D,
+		validating: w,
+		isFirst: E === 0,
+		isLast: E === l.length - 1,
+		next: A,
+		back: j,
+		goTo: M
 	}), [
-		A,
-		T,
 		j,
-		k,
 		E,
+		M,
+		A,
+		D,
 		l.length,
-		C
-	]), N = a(() => l.map((e) => ({
+		w
+	]), P = a(() => l.map((e) => ({
 		label: e.label,
-		description: e.optional ? `${e.description ?? ""} (optional)`.trim() : e.description
-	})), [l]);
+		description: e.optional ? `${e.description ?? ""} ${_}`.trim() : e.description
+	})), [_, l]);
 	return /* @__PURE__ */ c("div", {
-		className: e(r.wizard, y),
+		className: e(r.wizard, b),
 		children: [
 			/* @__PURE__ */ s(n, {
-				steps: N,
-				current: T,
-				onStepClick: _ ? (e) => void j(e) : void 0
+				steps: P,
+				current: E,
+				onStepClick: v ? (e) => void M(e) : void 0
 			}),
 			/* @__PURE__ */ s("div", {
 				className: r.body,
 				role: "group",
-				"aria-label": E.label,
-				children: typeof E.content == "function" ? E.content(M) : E.content
+				"aria-label": D.label,
+				children: typeof D.content == "function" ? D.content(N) : D.content
 			}),
-			v ? v(M) : /* @__PURE__ */ c("div", {
+			y ? y(N) : /* @__PURE__ */ c("div", {
 				className: r.actions,
 				children: [/* @__PURE__ */ s(t, {
 					variant: "secondary",
-					onClick: A,
-					disabled: M.isFirst || C,
+					onClick: j,
+					disabled: N.isFirst || w,
 					children: h
 				}), /* @__PURE__ */ s(t, {
-					onClick: () => void k(),
-					loading: C,
-					children: M.isLast ? g : m
+					onClick: () => void A(),
+					loading: w,
+					children: N.isLast ? g : m
 				})]
 			})
 		]

package/dist/components/Wizard/Wizard.js.map

@@ -1 +1 @@
-{"version":3,"file":"Wizard.js","names":[],"sources":["../../../src/components/Wizard/Wizard.tsx"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { cn } from \"@/utils/cn\";\nimport { Button } from \"../Button\";\nimport { Stepper } from \"../Stepper\";\nimport styles from \"./Wizard.module.css\";\n\n/** One step of the flow. */\nexport interface WizardStep {\n    /** Stable identifier. */\n    id: string;\n    /** Step label shown in the indicator. */\n    label: string;\n    /** Optional description under the label. */\n    description?: string;\n    /** Step body. A function receives the flow controls, for a \"skip\" link inside the form. */\n    content: ReactNode | ((controls: WizardControls) => ReactNode);\n    /**\n     * Gate for leaving this step forward. Return `false` (or a rejected/`false`\n     * promise) to keep the user here — typically `() => form.trigger()`.\n     * Async is supported: the Next button shows a pending state while it runs.\n     */\n    validate?: () => boolean | Promise<boolean>;\n    /** Marks the step as optional, so `onComplete` can ignore it. */\n    optional?: boolean;\n}\n\n/** Flow controls handed to a step body and to `renderActions`. */\nexport interface WizardControls {\n    /** Zero-based index of the current step. */\n    activeIndex: number;\n    /** The current step. */\n    step: WizardStep;\n    /** `true` while a `validate` promise is pending. */\n    validating: boolean;\n    isFirst: boolean;\n    isLast: boolean;\n    /** Run the current step's `validate` and advance when it passes. */\n    next: () => Promise<void>;\n    /** Go back one step. No validation — going back never blocks. */\n    back: () => void;\n    /** Jump to an index. Forward jumps validate every step in between. */\n    goTo: (index: number) => Promise<void>;\n}\n\nexport interface WizardProps {\n    steps: WizardStep[];\n    /** Controlled active index. */\n    activeIndex?: number;\n    /** Uncontrolled initial index. Default `0`. */\n    defaultActiveIndex?: number;\n    onStepChange?: (index: number, step: WizardStep) => void;\n    /** Called when the last step passes validation. */\n    onComplete?: () => void | Promise<void>;\n    /** Label of the advance button. Default `\"Next\"`. */\n    nextLabel?: string;\n    /** Label of the back button. Default `\"Back\"`. */\n    backLabel?: string;\n    /** Label of the button on the last step. Default `\"Finish\"`. */\n    finishLabel?: string;\n    /**\n     * Allow clicking the indicator to jump. Default `false` — a wizard exists\n     * because order matters, and a free jump skips the gates.\n     */\n    clickableSteps?: boolean;\n    /** Replace the default button row. */\n    renderActions?: (controls: WizardControls) => ReactNode;\n    className?: string;\n}\n\n/**\n * Multi-step flow: step indicator, one body at a time, and navigation that\n * respects per-step validation.\n *\n * `Stepper` draws the indicator; this owns the part every app was rewriting — the\n * active index, the async gate before advancing, the disabled/pending buttons and\n * the completion call.\n *\n * Only the active step's body is mounted. Uncommitted input in a step you leave is\n * therefore lost unless the state lives outside (react-hook-form's `FormProvider`,\n * a store, a parent `useState`) — which is the right place for it anyway, since\n * the last step usually needs to submit everything at once.\n *\n * @example\n * ```tsx\n * const form = useZodForm(schema);\n *\n * <FormProvider {...form}>\n *   <Wizard\n *     steps={[\n *       {\n *         id: \"dados\",\n *         label: \"Dados\",\n *         validate: () => form.trigger([\"nome\", \"email\"]),\n *         content: (\n *           <>\n *             <FormField name=\"nome\" label=\"Nome\"><Input /></FormField>\n *             <FormField name=\"email\" label=\"E-mail\"><Input type=\"email\" /></FormField>\n *           </>\n *         ),\n *       },\n *       { id: \"revisao\", label: \"Revisão\", content: <Review /> },\n *     ]}\n *     onComplete={form.handleSubmit(onSubmit)}\n *   />\n * </FormProvider>\n * ```\n */\nexport function Wizard({\n    steps,\n    activeIndex,\n    defaultActiveIndex = 0,\n    onStepChange,\n    onComplete,\n    nextLabel = \"Next\",\n    backLabel = \"Back\",\n    finishLabel = \"Finish\",\n    clickableSteps = false,\n    renderActions,\n    className,\n}: WizardProps) {\n    const isControlled = activeIndex !== undefined;\n    const [internalIndex, setInternalIndex] = useState(defaultActiveIndex);\n    const [validating, setValidating] = useState(false);\n\n    const current = Math.min(isControlled ? activeIndex : internalIndex, steps.length - 1);\n    const step = steps[current];\n\n    const moveTo = useCallback(\n        (index: number): void => {\n            if (!isControlled) setInternalIndex(index);\n            onStepChange?.(index, steps[index]);\n        },\n        [isControlled, onStepChange, steps],\n    );\n\n    /**\n     * Run a step's gate. A gate that throws counts as \"not allowed\": a `validate`\n     * wired to a network check should not strand the user on a half-advanced flow\n     * when the request fails.\n     */\n    const runValidate = useCallback(async (candidate: WizardStep): Promise<boolean> => {\n        if (!candidate.validate) return true;\n        setValidating(true);\n        try {\n            return await candidate.validate();\n        } catch {\n            return false;\n        } finally {\n            setValidating(false);\n        }\n    }, []);\n\n    const next = useCallback(async (): Promise<void> => {\n        if (!(await runValidate(step))) return;\n        if (current === steps.length - 1) {\n            await onComplete?.();\n            return;\n        }\n        moveTo(current + 1);\n    }, [current, moveTo, onComplete, runValidate, step, steps.length]);\n\n    const back = useCallback((): void => {\n        if (current > 0) moveTo(current - 1);\n    }, [current, moveTo]);\n\n    const goTo = useCallback(\n        async (index: number): Promise<void> => {\n            const target = Math.max(0, Math.min(index, steps.length - 1));\n            if (target === current) return;\n            if (target < current) {\n                moveTo(target);\n                return;\n            }\n            for (let i = current; i < target; i += 1) {\n                if (!(await runValidate(steps[i]))) return;\n            }\n            moveTo(target);\n        },\n        [current, moveTo, runValidate, steps],\n    );\n\n    const controls = useMemo<WizardControls>(\n        () => ({\n            activeIndex: current,\n            step,\n            validating,\n            isFirst: current === 0,\n            isLast: current === steps.length - 1,\n            next,\n            back,\n            goTo,\n        }),\n        [back, current, goTo, next, step, steps.length, validating],\n    );\n\n    const indicatorSteps = useMemo(\n        () =>\n            steps.map((item) => ({\n                label: item.label,\n                description: item.optional\n                    ? `${item.description ?? \"\"} (optional)`.trim()\n                    : item.description,\n            })),\n        [steps],\n    );\n\n    return (\n        <div className={cn(styles.wizard, className)}>\n            <Stepper\n                steps={indicatorSteps}\n                current={current}\n                onStepClick={clickableSteps ? (index) => void goTo(index) : undefined}\n            />\n\n            <div className={styles.body} role=\"group\" aria-label={step.label}>\n                {typeof step.content === \"function\" ? step.content(controls) : step.content}\n            </div>\n\n            {renderActions ? (\n                renderActions(controls)\n            ) : (\n                <div className={styles.actions}>\n                    <Button\n                        variant=\"secondary\"\n                        onClick={back}\n                        disabled={controls.isFirst || validating}\n                    >\n                        {backLabel}\n                    </Button>\n                    <Button onClick={() => void next()} loading={validating}>\n                        {controls.isLast ? finishLabel : nextLabel}\n                    </Button>\n                </div>\n            )}\n        </div>\n    );\n}\n"],"mappings":";;;;;;;AA4GA,SAAgB,EAAO,EACnB,UACA,gBACA,wBAAqB,GACrB,iBACA,eACA,eAAY,QACZ,eAAY,QACZ,iBAAc,UACd,oBAAiB,IACjB,kBACA,gBACY;CACZ,IAAM,IAAe,MAAgB,KAAA,GAC/B,CAAC,GAAe,KAAoB,EAAS,CAAkB,GAC/D,CAAC,GAAY,KAAiB,EAAS,EAAK,GAE5C,IAAU,KAAK,IAAI,IAAe,IAAc,GAAe,EAAM,SAAS,CAAC,GAC/E,IAAO,EAAM,IAEb,IAAS,GACV,MAAwB;EAErB,AADK,KAAc,EAAiB,CAAK,GACzC,IAAe,GAAO,EAAM,EAAM;CACtC,GACA;EAAC;EAAc;EAAc;CAAK,CACtC,GAOM,IAAc,EAAY,OAAO,MAA4C;EAC/E,IAAI,CAAC,EAAU,UAAU,OAAO;EAChC,EAAc,EAAI;EAClB,IAAI;GACA,OAAO,MAAM,EAAU,SAAS;EACpC,QAAQ;GACJ,OAAO;EACX,UAAU;GACN,EAAc,EAAK;EACvB;CACJ,GAAG,CAAC,CAAC,GAEC,IAAO,EAAY,YAA2B;EAC1C,UAAM,EAAY,CAAI,GAC5B;OAAI,MAAY,EAAM,SAAS,GAAG;IAC9B,MAAM,IAAa;IACnB;GACJ;GACA,EAAO,IAAU,CAAC;EADlB;CAEJ,GAAG;EAAC;EAAS;EAAQ;EAAY;EAAa;EAAM,EAAM;CAAM,CAAC,GAE3D,IAAO,QAAwB;EACjC,AAAI,IAAU,KAAG,EAAO,IAAU,CAAC;CACvC,GAAG,CAAC,GAAS,CAAM,CAAC,GAEd,IAAO,EACT,OAAO,MAAiC;EACpC,IAAM,IAAS,KAAK,IAAI,GAAG,KAAK,IAAI,GAAO,EAAM,SAAS,CAAC,CAAC;EACxD,UAAW,GACf;OAAI,IAAS,GAAS;IAClB,EAAO,CAAM;IACb;GACJ;GACA,KAAK,IAAI,IAAI,GAAS,IAAI,GAAQ,KAAK,GACnC,IAAI,CAAE,MAAM,EAAY,EAAM,EAAE,GAAI;GAExC,EAAO,CAAM;EAJb;CAKJ,GACA;EAAC;EAAS;EAAQ;EAAa;CAAK,CACxC,GAEM,IAAW,SACN;EACH,aAAa;EACb;EACA;EACA,SAAS,MAAY;EACrB,QAAQ,MAAY,EAAM,SAAS;EACnC;EACA;EACA;CACJ,IACA;EAAC;EAAM;EAAS;EAAM;EAAM;EAAM,EAAM;EAAQ;CAAU,CAC9D,GAEM,IAAiB,QAEf,EAAM,KAAK,OAAU;EACjB,OAAO,EAAK;EACZ,aAAa,EAAK,WACZ,GAAG,EAAK,eAAe,GAAG,aAAa,KAAK,IAC5C,EAAK;CACf,EAAE,GACN,CAAC,CAAK,CACV;CAEA,OACI,kBAAC,OAAD;EAAK,WAAW,EAAG,EAAO,QAAQ,CAAS;YAA3C;GACI,kBAAC,GAAD;IACI,OAAO;IACE;IACT,aAAa,KAAkB,MAAU,KAAK,EAAK,CAAK,IAAI,KAAA;GAC/D,CAAA;GAED,kBAAC,OAAD;IAAK,WAAW,EAAO;IAAM,MAAK;IAAQ,cAAY,EAAK;cACtD,OAAO,EAAK,WAAY,aAAa,EAAK,QAAQ,CAAQ,IAAI,EAAK;GACnE,CAAA;GAEJ,IACG,EAAc,CAAQ,IAEtB,kBAAC,OAAD;IAAK,WAAW,EAAO;cAAvB,CACI,kBAAC,GAAD;KACI,SAAQ;KACR,SAAS;KACT,UAAU,EAAS,WAAW;eAE7B;IACG,CAAA,GACR,kBAAC,GAAD;KAAQ,eAAe,KAAK,EAAK;KAAG,SAAS;eACxC,EAAS,SAAS,IAAc;IAC7B,CAAA,CACP;;EAER;;AAEb"}
+{"version":3,"file":"Wizard.js","names":[],"sources":["../../../src/components/Wizard/Wizard.tsx"],"sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { cn } from \"@/utils/cn\";\nimport { Button } from \"../Button\";\nimport { Stepper } from \"../Stepper\";\nimport styles from \"./Wizard.module.css\";\n\n/** One step of the flow. */\nexport interface WizardStep {\n    /** Stable identifier. */\n    id: string;\n    /** Step label shown in the indicator. */\n    label: string;\n    /** Optional description under the label. */\n    description?: string;\n    /** Step body. A function receives the flow controls, for a \"skip\" link inside the form. */\n    content: ReactNode | ((controls: WizardControls) => ReactNode);\n    /**\n     * Gate for leaving this step forward. Return `false` (or a rejected/`false`\n     * promise) to keep the user here — typically `() => form.trigger()`.\n     * Async is supported: the Next button shows a pending state while it runs.\n     */\n    validate?: () => boolean | Promise<boolean>;\n    /** Marks the step as optional, so `onComplete` can ignore it. */\n    optional?: boolean;\n}\n\n/** Flow controls handed to a step body and to `renderActions`. */\nexport interface WizardControls {\n    /** Zero-based index of the current step. */\n    activeIndex: number;\n    /** The current step. */\n    step: WizardStep;\n    /** `true` while a `validate` promise is pending. */\n    validating: boolean;\n    isFirst: boolean;\n    isLast: boolean;\n    /** Run the current step's `validate` and advance when it passes. */\n    next: () => Promise<void>;\n    /** Go back one step. No validation — going back never blocks. */\n    back: () => void;\n    /** Jump to an index. Forward jumps validate every step in between. */\n    goTo: (index: number) => Promise<void>;\n}\n\nexport interface WizardProps {\n    steps: WizardStep[];\n    /** Controlled active index. */\n    activeIndex?: number;\n    /** Uncontrolled initial index. Default `0`. */\n    defaultActiveIndex?: number;\n    onStepChange?: (index: number, step: WizardStep) => void;\n    /** Called when the last step passes validation. */\n    onComplete?: () => void | Promise<void>;\n    /** Label of the advance button. Default `\"Next\"`. */\n    nextLabel?: string;\n    /** Label of the back button. Default `\"Back\"`. */\n    backLabel?: string;\n    /** Label of the button on the last step. Default `\"Finish\"`. */\n    finishLabel?: string;\n    /**\n     * Suffix appended to an optional step's description in the indicator.\n     * Default `\"(optional)\"` — override it to localize, since the SDK ships no\n     * translation for component-internal copy.\n     */\n    optionalLabel?: string;\n    /**\n     * Allow clicking the indicator to jump. Default `false` — a wizard exists\n     * because order matters, and a free jump skips the gates.\n     */\n    clickableSteps?: boolean;\n    /** Replace the default button row. */\n    renderActions?: (controls: WizardControls) => ReactNode;\n    className?: string;\n}\n\n/**\n * Multi-step flow: step indicator, one body at a time, and navigation that\n * respects per-step validation.\n *\n * `Stepper` draws the indicator; this owns the part every app was rewriting — the\n * active index, the async gate before advancing, the disabled/pending buttons and\n * the completion call.\n *\n * Only the active step's body is mounted. Uncommitted input in a step you leave is\n * therefore lost unless the state lives outside (react-hook-form's `FormProvider`,\n * a store, a parent `useState`) — which is the right place for it anyway, since\n * the last step usually needs to submit everything at once.\n *\n * @example\n * ```tsx\n * const form = useZodForm(schema);\n *\n * <FormProvider {...form}>\n *   <Wizard\n *     steps={[\n *       {\n *         id: \"dados\",\n *         label: \"Dados\",\n *         validate: () => form.trigger([\"nome\", \"email\"]),\n *         content: (\n *           <>\n *             <FormField name=\"nome\" label=\"Nome\"><Input /></FormField>\n *             <FormField name=\"email\" label=\"E-mail\"><Input type=\"email\" /></FormField>\n *           </>\n *         ),\n *       },\n *       { id: \"revisao\", label: \"Revisão\", content: <Review /> },\n *     ]}\n *     onComplete={form.handleSubmit(onSubmit)}\n *   />\n * </FormProvider>\n * ```\n */\nexport function Wizard({\n    steps,\n    activeIndex,\n    defaultActiveIndex = 0,\n    onStepChange,\n    onComplete,\n    nextLabel = \"Next\",\n    backLabel = \"Back\",\n    finishLabel = \"Finish\",\n    optionalLabel = \"(optional)\",\n    clickableSteps = false,\n    renderActions,\n    className,\n}: WizardProps) {\n    const isControlled = activeIndex !== undefined;\n    const [internalIndex, setInternalIndex] = useState(defaultActiveIndex);\n    const [validating, setValidating] = useState(false);\n\n    const current = Math.min(isControlled ? activeIndex : internalIndex, steps.length - 1);\n    const step = steps[current];\n\n    const moveTo = useCallback(\n        (index: number): void => {\n            if (!isControlled) setInternalIndex(index);\n            onStepChange?.(index, steps[index]);\n        },\n        [isControlled, onStepChange, steps],\n    );\n\n    /**\n     * Run a step's gate. A gate that throws counts as \"not allowed\": a `validate`\n     * wired to a network check should not strand the user on a half-advanced flow\n     * when the request fails.\n     */\n    const runValidate = useCallback(async (candidate: WizardStep): Promise<boolean> => {\n        if (!candidate.validate) return true;\n        setValidating(true);\n        try {\n            return await candidate.validate();\n        } catch {\n            return false;\n        } finally {\n            setValidating(false);\n        }\n    }, []);\n\n    const next = useCallback(async (): Promise<void> => {\n        if (!(await runValidate(step))) return;\n        if (current === steps.length - 1) {\n            await onComplete?.();\n            return;\n        }\n        moveTo(current + 1);\n    }, [current, moveTo, onComplete, runValidate, step, steps.length]);\n\n    const back = useCallback((): void => {\n        if (current > 0) moveTo(current - 1);\n    }, [current, moveTo]);\n\n    const goTo = useCallback(\n        async (index: number): Promise<void> => {\n            const target = Math.max(0, Math.min(index, steps.length - 1));\n            if (target === current) return;\n            if (target < current) {\n                moveTo(target);\n                return;\n            }\n            for (let i = current; i < target; i += 1) {\n                if (!(await runValidate(steps[i]))) return;\n            }\n            moveTo(target);\n        },\n        [current, moveTo, runValidate, steps],\n    );\n\n    const controls = useMemo<WizardControls>(\n        () => ({\n            activeIndex: current,\n            step,\n            validating,\n            isFirst: current === 0,\n            isLast: current === steps.length - 1,\n            next,\n            back,\n            goTo,\n        }),\n        [back, current, goTo, next, step, steps.length, validating],\n    );\n\n    const indicatorSteps = useMemo(\n        () =>\n            steps.map((item) => ({\n                label: item.label,\n                description: item.optional\n                    ? `${item.description ?? \"\"} ${optionalLabel}`.trim()\n                    : item.description,\n            })),\n        [optionalLabel, steps],\n    );\n\n    return (\n        <div className={cn(styles.wizard, className)}>\n            <Stepper\n                steps={indicatorSteps}\n                current={current}\n                onStepClick={clickableSteps ? (index) => void goTo(index) : undefined}\n            />\n\n            <div className={styles.body} role=\"group\" aria-label={step.label}>\n                {typeof step.content === \"function\" ? step.content(controls) : step.content}\n            </div>\n\n            {renderActions ? (\n                renderActions(controls)\n            ) : (\n                <div className={styles.actions}>\n                    <Button\n                        variant=\"secondary\"\n                        onClick={back}\n                        disabled={controls.isFirst || validating}\n                    >\n                        {backLabel}\n                    </Button>\n                    <Button onClick={() => void next()} loading={validating}>\n                        {controls.isLast ? finishLabel : nextLabel}\n                    </Button>\n                </div>\n            )}\n        </div>\n    );\n}\n"],"mappings":";;;;;;;AAkHA,SAAgB,EAAO,EACnB,UACA,gBACA,wBAAqB,GACrB,iBACA,eACA,eAAY,QACZ,eAAY,QACZ,iBAAc,UACd,mBAAgB,cAChB,oBAAiB,IACjB,kBACA,gBACY;CACZ,IAAM,IAAe,MAAgB,KAAA,GAC/B,CAAC,GAAe,KAAoB,EAAS,CAAkB,GAC/D,CAAC,GAAY,KAAiB,EAAS,EAAK,GAE5C,IAAU,KAAK,IAAI,IAAe,IAAc,GAAe,EAAM,SAAS,CAAC,GAC/E,IAAO,EAAM,IAEb,IAAS,GACV,MAAwB;EAErB,AADK,KAAc,EAAiB,CAAK,GACzC,IAAe,GAAO,EAAM,EAAM;CACtC,GACA;EAAC;EAAc;EAAc;CAAK,CACtC,GAOM,IAAc,EAAY,OAAO,MAA4C;EAC/E,IAAI,CAAC,EAAU,UAAU,OAAO;EAChC,EAAc,EAAI;EAClB,IAAI;GACA,OAAO,MAAM,EAAU,SAAS;EACpC,QAAQ;GACJ,OAAO;EACX,UAAU;GACN,EAAc,EAAK;EACvB;CACJ,GAAG,CAAC,CAAC,GAEC,IAAO,EAAY,YAA2B;EAC1C,UAAM,EAAY,CAAI,GAC5B;OAAI,MAAY,EAAM,SAAS,GAAG;IAC9B,MAAM,IAAa;IACnB;GACJ;GACA,EAAO,IAAU,CAAC;EADlB;CAEJ,GAAG;EAAC;EAAS;EAAQ;EAAY;EAAa;EAAM,EAAM;CAAM,CAAC,GAE3D,IAAO,QAAwB;EACjC,AAAI,IAAU,KAAG,EAAO,IAAU,CAAC;CACvC,GAAG,CAAC,GAAS,CAAM,CAAC,GAEd,IAAO,EACT,OAAO,MAAiC;EACpC,IAAM,IAAS,KAAK,IAAI,GAAG,KAAK,IAAI,GAAO,EAAM,SAAS,CAAC,CAAC;EACxD,UAAW,GACf;OAAI,IAAS,GAAS;IAClB,EAAO,CAAM;IACb;GACJ;GACA,KAAK,IAAI,IAAI,GAAS,IAAI,GAAQ,KAAK,GACnC,IAAI,CAAE,MAAM,EAAY,EAAM,EAAE,GAAI;GAExC,EAAO,CAAM;EAJb;CAKJ,GACA;EAAC;EAAS;EAAQ;EAAa;CAAK,CACxC,GAEM,IAAW,SACN;EACH,aAAa;EACb;EACA;EACA,SAAS,MAAY;EACrB,QAAQ,MAAY,EAAM,SAAS;EACnC;EACA;EACA;CACJ,IACA;EAAC;EAAM;EAAS;EAAM;EAAM;EAAM,EAAM;EAAQ;CAAU,CAC9D,GAEM,IAAiB,QAEf,EAAM,KAAK,OAAU;EACjB,OAAO,EAAK;EACZ,aAAa,EAAK,WACZ,GAAG,EAAK,eAAe,GAAG,GAAG,IAAgB,KAAK,IAClD,EAAK;CACf,EAAE,GACN,CAAC,GAAe,CAAK,CACzB;CAEA,OACI,kBAAC,OAAD;EAAK,WAAW,EAAG,EAAO,QAAQ,CAAS;YAA3C;GACI,kBAAC,GAAD;IACI,OAAO;IACE;IACT,aAAa,KAAkB,MAAU,KAAK,EAAK,CAAK,IAAI,KAAA;GAC/D,CAAA;GAED,kBAAC,OAAD;IAAK,WAAW,EAAO;IAAM,MAAK;IAAQ,cAAY,EAAK;cACtD,OAAO,EAAK,WAAY,aAAa,EAAK,QAAQ,CAAQ,IAAI,EAAK;GACnE,CAAA;GAEJ,IACG,EAAc,CAAQ,IAEtB,kBAAC,OAAD;IAAK,WAAW,EAAO;cAAvB,CACI,kBAAC,GAAD;KACI,SAAQ;KACR,SAAS;KACT,UAAU,EAAS,WAAW;eAE7B;IACG,CAAA,GACR,kBAAC,GAAD;KAAQ,eAAe,KAAK,EAAK;KAAG,SAAS;eACxC,EAAS,SAAS,IAAc;IAC7B,CAAA,CACP;;EAER;;AAEb"}

package/dist/geo/use-position-tracker.cjs

@@ -1,2 +1,2 @@
-const e=require("./create-position-tracker.cjs");let t=require("react");function n(n={}){let{autoStart:r=!1,onError:i,...a}=n,[o,s]=(0,t.useState)([]),[c,l]=(0,t.useState)(0),[u,d]=(0,t.useState)(`idle`),f=(0,t.useRef)(null),p=(0,t.useRef)(i);p.current=i,(0,t.useEffect)(()=>{let t=e.createPositionTracker({...a,onUpdate:e=>{s([...e]),l(t.distanceKm)},onStatusChange:d,onError:e=>p.current?.(e)});return f.current=t,r&&t.start(),()=>{t.stop(),f.current=null}},[]);let m=(0,t.useCallback)(()=>f.current?.start(),[]),h=(0,t.useCallback)(()=>f.current?.stop(),[]),g=(0,t.useCallback)(()=>{f.current?.clear(),l(0)},[]);return{points:o,lastPoint:o.length>0?o[o.length-1]:null,distanceKm:c,status:u,isTracking:u===`tracking`,start:m,stop:h,clear:g}}exports.usePositionTracker=n;
+const e=require("./create-position-tracker.cjs");let t=require("react");function n(n={}){let{autoStart:r=!1,onError:i,...a}=n,[o,s]=(0,t.useState)([]),[c,l]=(0,t.useState)(0),[u,d]=(0,t.useState)(`idle`),f=(0,t.useRef)(null),p=(0,t.useRef)(i);(0,t.useEffect)(()=>{p.current=i},[i]),(0,t.useEffect)(()=>{let t=e.createPositionTracker({...a,onUpdate:e=>{s([...e]),l(t.distanceKm)},onStatusChange:d,onError:e=>p.current?.(e)});return f.current=t,r&&t.start(),()=>{t.stop(),f.current=null}},[]);let m=(0,t.useCallback)(()=>f.current?.start(),[]),h=(0,t.useCallback)(()=>f.current?.stop(),[]),g=(0,t.useCallback)(()=>{f.current?.clear(),l(0)},[]);return{points:o,lastPoint:o.length>0?o[o.length-1]:null,distanceKm:c,status:u,isTracking:u===`tracking`,start:m,stop:h,clear:g}}exports.usePositionTracker=n;
 //# sourceMappingURL=use-position-tracker.cjs.map

package/dist/geo/use-position-tracker.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-position-tracker.cjs","names":[],"sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useRef(onError);\n    onErrorRef.current = onError;\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"mappings":"wEAqDA,SAAgB,EACZ,EAAqC,CAAC,EACd,CACxB,GAAM,CAAE,YAAY,GAAO,UAAS,GAAG,GAAmB,EAEpD,CAAC,EAAQ,IAAA,EAAA,EAAA,SAAA,CAA6C,CAAC,CAAC,EACxD,CAAC,EAAY,IAAA,EAAA,EAAA,SAAA,CAAkC,CAAC,EAChD,CAAC,EAAQ,IAAA,EAAA,EAAA,SAAA,CAAqC,MAAM,EAEpD,GAAA,EAAA,EAAA,OAAA,CAA4C,IAAI,EAChD,GAAA,EAAA,EAAA,OAAA,CAAoB,CAAO,EACjC,EAAW,QAAU,GAErB,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAU,EAAA,sBAAsB,CAClC,GAAG,EACH,SAAW,GAAS,CAChB,EAAU,CAAC,GAAG,CAAI,CAAC,EACnB,EAAc,EAAQ,UAAU,CACpC,EACA,eAAgB,EAChB,QAAU,GAAU,EAAW,UAAU,CAAK,CAClD,CAAC,EAID,MAHA,GAAW,QAAU,EACjB,GAAW,EAAQ,MAAM,MAEhB,CACT,EAAQ,KAAK,EACb,EAAW,QAAU,IACzB,CAIJ,EAAG,CAAC,CAAC,EAEL,IAAM,GAAA,EAAA,EAAA,YAAA,KAAgC,EAAW,SAAS,MAAM,EAAG,CAAC,CAAC,EAC/D,GAAA,EAAA,EAAA,YAAA,KAA+B,EAAW,SAAS,KAAK,EAAG,CAAC,CAAC,EAC7D,GAAA,EAAA,EAAA,YAAA,KAAgC,CAClC,EAAW,SAAS,MAAM,EAC1B,EAAc,CAAC,CACnB,EAAG,CAAC,CAAC,EAEL,MAAO,CACH,SACA,UAAW,EAAO,OAAS,EAAI,EAAO,EAAO,OAAS,GAAK,KAC3D,aACA,SACA,WAAY,IAAW,WACvB,QACA,OACA,OACJ,CACJ"}
+{"version":3,"file":"use-position-tracker.cjs","names":[],"sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useRef(onError);\n    useEffect(() => {\n        onErrorRef.current = onError;\n    }, [onError]);\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"mappings":"wEAqDA,SAAgB,EACZ,EAAqC,CAAC,EACd,CACxB,GAAM,CAAE,YAAY,GAAO,UAAS,GAAG,GAAmB,EAEpD,CAAC,EAAQ,IAAA,EAAA,EAAA,SAAA,CAA6C,CAAC,CAAC,EACxD,CAAC,EAAY,IAAA,EAAA,EAAA,SAAA,CAAkC,CAAC,EAChD,CAAC,EAAQ,IAAA,EAAA,EAAA,SAAA,CAAqC,MAAM,EAEpD,GAAA,EAAA,EAAA,OAAA,CAA4C,IAAI,EAChD,GAAA,EAAA,EAAA,OAAA,CAAoB,CAAO,GACjC,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAW,QAAU,CACzB,EAAG,CAAC,CAAO,CAAC,GAEZ,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAU,EAAA,sBAAsB,CAClC,GAAG,EACH,SAAW,GAAS,CAChB,EAAU,CAAC,GAAG,CAAI,CAAC,EACnB,EAAc,EAAQ,UAAU,CACpC,EACA,eAAgB,EAChB,QAAU,GAAU,EAAW,UAAU,CAAK,CAClD,CAAC,EAID,MAHA,GAAW,QAAU,EACjB,GAAW,EAAQ,MAAM,MAEhB,CACT,EAAQ,KAAK,EACb,EAAW,QAAU,IACzB,CAIJ,EAAG,CAAC,CAAC,EAEL,IAAM,GAAA,EAAA,EAAA,YAAA,KAAgC,EAAW,SAAS,MAAM,EAAG,CAAC,CAAC,EAC/D,GAAA,EAAA,EAAA,YAAA,KAA+B,EAAW,SAAS,KAAK,EAAG,CAAC,CAAC,EAC7D,GAAA,EAAA,EAAA,YAAA,KAAgC,CAClC,EAAW,SAAS,MAAM,EAC1B,EAAc,CAAC,CACnB,EAAG,CAAC,CAAC,EAEL,MAAO,CACH,SACA,UAAW,EAAO,OAAS,EAAI,EAAO,EAAO,OAAS,GAAK,KAC3D,aACA,SACA,WAAY,IAAW,WACvB,QACA,OACA,OACJ,CACJ"}

package/dist/geo/use-position-tracker.js

@@ -3,7 +3,9 @@ import { useCallback as t, useEffect as n, useRef as r, useState as i } from "re
 //#region src/geo/use-position-tracker.ts
 function a(a = {}) {
 	let { autoStart: o = !1, onError: s, ...c } = a, [l, u] = i([]), [d, f] = i(0), [p, m] = i("idle"), h = r(null), g = r(s);
-	g.current = s, n(() => {
+	n(() => {
+		g.current = s;
+	}, [s]), n(() => {
 		let t = e({
 			...c,
 			onUpdate: (e) => {

package/dist/geo/use-position-tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-position-tracker.js","names":[],"sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useRef(onError);\n    onErrorRef.current = onError;\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"mappings":";;;AAqDA,SAAgB,EACZ,IAAqC,CAAC,GACd;CACxB,IAAM,EAAE,eAAY,IAAO,YAAS,GAAG,MAAmB,GAEpD,CAAC,GAAQ,KAAa,EAAgC,CAAC,CAAC,GACxD,CAAC,GAAY,KAAiB,EAAiB,CAAC,GAChD,CAAC,GAAQ,KAAa,EAAwB,MAAM,GAEpD,IAAa,EAA+B,IAAI,GAChD,IAAa,EAAO,CAAO;CAGjC,AAFA,EAAW,UAAU,GAErB,QAAgB;EACZ,IAAM,IAAU,EAAsB;GAClC,GAAG;GACH,WAAW,MAAS;IAEhB,AADA,EAAU,CAAC,GAAG,CAAI,CAAC,GACnB,EAAc,EAAQ,UAAU;GACpC;GACA,gBAAgB;GAChB,UAAU,MAAU,EAAW,UAAU,CAAK;EAClD,CAAC;EAID,OAHA,EAAW,UAAU,GACjB,KAAW,EAAQ,MAAM,SAEhB;GAET,AADA,EAAQ,KAAK,GACb,EAAW,UAAU;EACzB;CAIJ,GAAG,CAAC,CAAC;CAEL,IAAM,IAAQ,QAAwB,EAAW,SAAS,MAAM,GAAG,CAAC,CAAC,GAC/D,IAAO,QAAwB,EAAW,SAAS,KAAK,GAAG,CAAC,CAAC,GAC7D,IAAQ,QAAwB;EAElC,AADA,EAAW,SAAS,MAAM,GAC1B,EAAc,CAAC;CACnB,GAAG,CAAC,CAAC;CAEL,OAAO;EACH;EACA,WAAW,EAAO,SAAS,IAAI,EAAO,EAAO,SAAS,KAAK;EAC3D;EACA;EACA,YAAY,MAAW;EACvB;EACA;EACA;CACJ;AACJ"}
+{"version":3,"file":"use-position-tracker.js","names":[],"sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useRef(onError);\n    useEffect(() => {\n        onErrorRef.current = onError;\n    }, [onError]);\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"mappings":";;;AAqDA,SAAgB,EACZ,IAAqC,CAAC,GACd;CACxB,IAAM,EAAE,eAAY,IAAO,YAAS,GAAG,MAAmB,GAEpD,CAAC,GAAQ,KAAa,EAAgC,CAAC,CAAC,GACxD,CAAC,GAAY,KAAiB,EAAiB,CAAC,GAChD,CAAC,GAAQ,KAAa,EAAwB,MAAM,GAEpD,IAAa,EAA+B,IAAI,GAChD,IAAa,EAAO,CAAO;CAKjC,AAJA,QAAgB;EACZ,EAAW,UAAU;CACzB,GAAG,CAAC,CAAO,CAAC,GAEZ,QAAgB;EACZ,IAAM,IAAU,EAAsB;GAClC,GAAG;GACH,WAAW,MAAS;IAEhB,AADA,EAAU,CAAC,GAAG,CAAI,CAAC,GACnB,EAAc,EAAQ,UAAU;GACpC;GACA,gBAAgB;GAChB,UAAU,MAAU,EAAW,UAAU,CAAK;EAClD,CAAC;EAID,OAHA,EAAW,UAAU,GACjB,KAAW,EAAQ,MAAM,SAEhB;GAET,AADA,EAAQ,KAAK,GACb,EAAW,UAAU;EACzB;CAIJ,GAAG,CAAC,CAAC;CAEL,IAAM,IAAQ,QAAwB,EAAW,SAAS,MAAM,GAAG,CAAC,CAAC,GAC/D,IAAO,QAAwB,EAAW,SAAS,KAAK,GAAG,CAAC,CAAC,GAC7D,IAAQ,QAAwB;EAElC,AADA,EAAW,SAAS,MAAM,GAC1B,EAAc,CAAC;CACnB,GAAG,CAAC,CAAC;CAEL,OAAO;EACH;EACA,WAAW,EAAO,SAAS,IAAI,EAAO,EAAO,SAAS,KAAK;EAC3D;EACA;EACA,YAAY,MAAW;EACvB;EACA;EACA;CACJ;AACJ"}

package/dist/hooks/use-async.cjs

@@ -1,2 +1,2 @@
-let e=require("react");function t(t,n=[],r={}){let{immediate:i=!1}=r,[a,o]=(0,e.useState)({status:`idle`,data:void 0,error:void 0}),s=(0,e.useRef)(t);s.current=t;let c=(0,e.useRef)(0),l=(0,e.useRef)(!0);(0,e.useEffect)(()=>(l.current=!0,()=>{l.current=!1}),[]);let u=(0,e.useCallback)(async()=>{let e=++c.current;o(e=>({...e,status:`pending`,error:void 0}));try{let t=await s.current();return l.current&&c.current===e&&o({status:`success`,data:t,error:void 0}),t}catch(t){throw l.current&&c.current===e&&o({status:`error`,data:void 0,error:t}),t}},[]),d=(0,e.useCallback)(()=>{c.current++,o({status:`idle`,data:void 0,error:void 0})},[]);return(0,e.useEffect)(()=>{i&&u().catch(()=>{})},[i,...n]),{status:a.status,data:a.data,error:a.error,isPending:a.status===`pending`,isSuccess:a.status===`success`,isError:a.status===`error`,run:u,reset:d}}exports.useAsync=t;
+let e=require("react");function t(t,n=[],r={}){let{immediate:i=!1}=r,[a,o]=(0,e.useState)({status:`idle`,data:void 0,error:void 0}),s=(0,e.useRef)(t);(0,e.useEffect)(()=>{s.current=t},[t]);let c=(0,e.useRef)(0),l=(0,e.useRef)(!0);(0,e.useEffect)(()=>(l.current=!0,()=>{l.current=!1}),[]);let u=(0,e.useCallback)(async()=>{let e=++c.current;o(e=>({...e,status:`pending`,error:void 0}));try{let t=await s.current();return l.current&&c.current===e&&o({status:`success`,data:t,error:void 0}),t}catch(t){throw l.current&&c.current===e&&o({status:`error`,data:void 0,error:t}),t}},[]),d=(0,e.useCallback)(()=>{c.current++,o({status:`idle`,data:void 0,error:void 0})},[]);return(0,e.useEffect)(()=>{i&&u().catch(()=>{})},[i,...n]),{status:a.status,data:a.data,error:a.error,isPending:a.status===`pending`,isSuccess:a.status===`success`,isError:a.status===`error`,run:u,reset:d}}exports.useAsync=t;
 //# sourceMappingURL=use-async.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-async.cjs","names":[],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useRef(asyncFn);\n    fnRef.current = asyncFn;\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, []);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":"uBA4BA,SAAgB,EACZ,EACA,EAA+B,CAAC,EAChC,EAAmC,CAAC,EACnB,CACjB,GAAM,CAAE,YAAY,IAAU,EACxB,CAAC,EAAO,IAAA,EAAA,EAAA,SAAA,CAIX,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,EAElD,GAAA,EAAA,EAAA,OAAA,CAAe,CAAO,EAC5B,EAAM,QAAU,EAChB,IAAM,GAAA,EAAA,EAAA,OAAA,CAA2B,CAAC,EAC5B,GAAA,EAAA,EAAA,OAAA,CAA6B,EAAI,GAEvC,EAAA,EAAA,UAAA,MACI,EAAW,QAAU,OACR,CACT,EAAW,QAAU,EACzB,GACD,CAAC,CAAC,EAEL,IAAM,GAAA,EAAA,EAAA,YAAA,CAAkB,SAAwB,CAC5C,IAAM,EAAS,EAAE,EAAU,QAC3B,EAAU,IAAa,CAAE,GAAG,EAAS,OAAQ,UAAW,MAAO,IAAA,EAAU,EAAE,EAC3E,GAAI,CACA,IAAM,EAAO,MAAM,EAAM,QAAQ,EAIjC,OAHI,EAAW,SAAW,EAAU,UAAY,GAC5C,EAAS,CAAE,OAAQ,UAAW,OAAM,MAAO,IAAA,EAAU,CAAC,EAEnD,CACX,OAAS,EAAO,CAIZ,MAHI,EAAW,SAAW,EAAU,UAAY,GAC5C,EAAS,CAAE,OAAQ,QAAS,KAAM,IAAA,GAAW,OAAM,CAAC,EAElD,CACV,CACJ,EAAG,CAAC,CAAC,EAEC,GAAA,EAAA,EAAA,YAAA,KAAgC,CAClC,EAAU,UACV,EAAS,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,CAClE,EAAG,CAAC,CAAC,EAUL,OARA,EAAA,EAAA,UAAA,KAAgB,CACP,GACL,EAAI,CAAC,CAAC,UAAY,CAElB,CAAC,CAEL,EAAG,CAAC,EAAW,GAAG,CAAI,CAAC,EAEhB,CACH,OAAQ,EAAM,OACd,KAAM,EAAM,KACZ,MAAO,EAAM,MACb,UAAW,EAAM,SAAW,UAC5B,UAAW,EAAM,SAAW,UAC5B,QAAS,EAAM,SAAW,QAC1B,MACA,OACJ,CACJ"}
+{"version":3,"file":"use-async.cjs","names":[],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useRef(asyncFn);\n    useEffect(() => {\n        fnRef.current = asyncFn;\n    }, [asyncFn]);\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, []);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":"uBA4BA,SAAgB,EACZ,EACA,EAA+B,CAAC,EAChC,EAAmC,CAAC,EACnB,CACjB,GAAM,CAAE,YAAY,IAAU,EACxB,CAAC,EAAO,IAAA,EAAA,EAAA,SAAA,CAIX,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,EAElD,GAAA,EAAA,EAAA,OAAA,CAAe,CAAO,GAC5B,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAM,QAAU,CACpB,EAAG,CAAC,CAAO,CAAC,EACZ,IAAM,GAAA,EAAA,EAAA,OAAA,CAA2B,CAAC,EAC5B,GAAA,EAAA,EAAA,OAAA,CAA6B,EAAI,GAEvC,EAAA,EAAA,UAAA,MACI,EAAW,QAAU,OACR,CACT,EAAW,QAAU,EACzB,GACD,CAAC,CAAC,EAEL,IAAM,GAAA,EAAA,EAAA,YAAA,CAAkB,SAAwB,CAC5C,IAAM,EAAS,EAAE,EAAU,QAC3B,EAAU,IAAa,CAAE,GAAG,EAAS,OAAQ,UAAW,MAAO,IAAA,EAAU,EAAE,EAC3E,GAAI,CACA,IAAM,EAAO,MAAM,EAAM,QAAQ,EAIjC,OAHI,EAAW,SAAW,EAAU,UAAY,GAC5C,EAAS,CAAE,OAAQ,UAAW,OAAM,MAAO,IAAA,EAAU,CAAC,EAEnD,CACX,OAAS,EAAO,CAIZ,MAHI,EAAW,SAAW,EAAU,UAAY,GAC5C,EAAS,CAAE,OAAQ,QAAS,KAAM,IAAA,GAAW,OAAM,CAAC,EAElD,CACV,CACJ,EAAG,CAAC,CAAC,EAEC,GAAA,EAAA,EAAA,YAAA,KAAgC,CAClC,EAAU,UACV,EAAS,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,CAClE,EAAG,CAAC,CAAC,EAUL,OARA,EAAA,EAAA,UAAA,KAAgB,CACP,GACL,EAAI,CAAC,CAAC,UAAY,CAElB,CAAC,CAEL,EAAG,CAAC,EAAW,GAAG,CAAI,CAAC,EAEhB,CACH,OAAQ,EAAM,OACd,KAAM,EAAM,KACZ,MAAO,EAAM,MACb,UAAW,EAAM,SAAW,UAC5B,UAAW,EAAM,SAAW,UAC5B,QAAS,EAAM,SAAW,QAC1B,MACA,OACJ,CACJ"}

package/dist/hooks/use-async.js

@@ -6,7 +6,9 @@ function i(i, a = [], o = {}) {
 		data: void 0,
 		error: void 0
 	}), u = n(i);
-	u.current = i;
+	t(() => {
+		u.current = i;
+	}, [i]);
 	let d = n(0), f = n(!0);
 	t(() => (f.current = !0, () => {
 		f.current = !1;

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

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

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

@@ -1,2 +1,2 @@
-let e=require("react");function t(t){let n=(0,e.useRef)(null),r=(0,e.useRef)(t);return r.current=t,(0,e.useEffect)(()=>{if(typeof document>`u`)return;let e=e=>{let t=e.target;!n.current||t&&n.current.contains(t)||r.current()};return document.addEventListener(`mousedown`,e),document.addEventListener(`touchstart`,e),()=>{document.removeEventListener(`mousedown`,e),document.removeEventListener(`touchstart`,e)}},[]),n}exports.useClickOutside=t;
+let e=require("react");function t(t){let n=(0,e.useRef)(null),r=(0,e.useRef)(t);return(0,e.useEffect)(()=>{r.current=t},[t]),(0,e.useEffect)(()=>{if(typeof document>`u`)return;let e=e=>{let t=e.target;!n.current||t&&n.current.contains(t)||r.current()};return document.addEventListener(`mousedown`,e),document.addEventListener(`touchstart`,e),()=>{document.removeEventListener(`mousedown`,e),document.removeEventListener(`touchstart`,e)}},[]),n}exports.useClickOutside=t;
 //# sourceMappingURL=use-click-outside.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-click-outside.cjs","names":[],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useRef(handler);\n    handlerRef.current = handler;\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, []);\n\n    return ref;\n}\n"],"mappings":"uBAWA,SAAgB,EACZ,EACmB,CACnB,IAAM,GAAA,EAAA,EAAA,OAAA,CAAgB,IAAI,EACpB,GAAA,EAAA,EAAA,OAAA,CAAoB,CAAO,EAoBjC,MAnBA,GAAW,QAAU,GAErB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,SAAa,IAAa,OAErC,IAAM,EAAY,GAAyC,CACvD,IAAM,EAAS,EAAM,OACjB,CAAC,EAAI,SAAY,GAAU,EAAI,QAAQ,SAAS,CAAM,GAC1D,EAAW,QAAQ,CACvB,EAIA,OAFA,SAAS,iBAAiB,YAAa,CAAQ,EAC/C,SAAS,iBAAiB,aAAc,CAAQ,MACnC,CACT,SAAS,oBAAoB,YAAa,CAAQ,EAClD,SAAS,oBAAoB,aAAc,CAAQ,CACvD,CACJ,EAAG,CAAC,CAAC,EAEE,CACX"}
+{"version":3,"file":"use-click-outside.cjs","names":[],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useRef(handler);\n    useEffect(() => {\n        handlerRef.current = handler;\n    }, [handler]);\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, []);\n\n    return ref;\n}\n"],"mappings":"uBAWA,SAAgB,EACZ,EACmB,CACnB,IAAM,GAAA,EAAA,EAAA,OAAA,CAAgB,IAAI,EACpB,GAAA,EAAA,EAAA,OAAA,CAAoB,CAAO,EAsBjC,OArBA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAW,QAAU,CACzB,EAAG,CAAC,CAAO,CAAC,GAEZ,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,SAAa,IAAa,OAErC,IAAM,EAAY,GAAyC,CACvD,IAAM,EAAS,EAAM,OACjB,CAAC,EAAI,SAAY,GAAU,EAAI,QAAQ,SAAS,CAAM,GAC1D,EAAW,QAAQ,CACvB,EAIA,OAFA,SAAS,iBAAiB,YAAa,CAAQ,EAC/C,SAAS,iBAAiB,aAAc,CAAQ,MACnC,CACT,SAAS,oBAAoB,YAAa,CAAQ,EAClD,SAAS,oBAAoB,aAAc,CAAQ,CACvD,CACJ,EAAG,CAAC,CAAC,EAEE,CACX"}

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

@@ -2,7 +2,9 @@ import { useEffect as e, useRef as t } from "react";
 //#region src/hooks/use-click-outside.ts
 function n(n) {
 	let r = t(null), i = t(n);
-	return i.current = n, e(() => {
+	return e(() => {
+		i.current = n;
+	}, [n]), e(() => {
 		if (typeof document > "u") return;
 		let e = (e) => {
 			let t = e.target;

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"use-deep-memo.cjs","names":[],"sources":["../../src/hooks/use-deep-memo.ts"],"sourcesContent":["import { useRef } from \"react\";\n\nfunction deepEqual(a: unknown, b: unknown): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) return false;\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) return false;\n        return a.every((value, index) => deepEqual(value, b[index]));\n    }\n    const aKeys = Object.keys(a as object);\n    const bKeys = Object.keys(b as object);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every((key) =>\n        deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n    );\n}\n\n/**\n * Memoize a value with a structural equality check. Use when an object/array\n * created during render is fed to `useEffect` dependencies and you want to\n * avoid spurious effect runs when only the reference changes.\n */\nexport function useDeepMemo<T>(value: T): T {\n    const ref = useRef<T>(value);\n    if (!deepEqual(ref.current, value)) {\n        ref.current = value;\n    }\n    return ref.current;\n}\n"],"mappings":"uBAEA,SAAS,EAAU,EAAY,EAAqB,CAChD,GAAI,OAAO,GAAG,EAAG,CAAC,EAAG,MAAO,GAE5B,GADI,OAAO,GAAM,UAAY,OAAO,GAAM,UAAY,IAAM,MAAQ,IAAM,MACtE,MAAM,QAAQ,CAAC,IAAM,MAAM,QAAQ,CAAC,EAAG,MAAO,GAClD,GAAI,MAAM,QAAQ,CAAC,GAAK,MAAM,QAAQ,CAAC,EAEnC,OADI,EAAE,SAAW,EAAE,QACZ,EAAE,OAAO,EAAO,IAAU,EAAU,EAAO,EAAE,EAAM,CAAC,EAE/D,IAAM,EAAQ,OAAO,KAAK,CAAW,EAC/B,EAAQ,OAAO,KAAK,CAAW,EAErC,OADI,EAAM,SAAW,EAAM,QACpB,EAAM,MAAO,GAChB,EAAW,EAA8B,GAAO,EAA8B,EAAI,CACtF,CACJ,CAOA,SAAgB,EAAe,EAAa,CACxC,IAAM,GAAA,EAAA,EAAA,OAAA,CAAgB,CAAK,EAI3B,OAHK,EAAU,EAAI,QAAS,CAAK,IAC7B,EAAI,QAAU,GAEX,EAAI,OACf"}
+{"version":3,"file":"use-deep-memo.cjs","names":[],"sources":["../../src/hooks/use-deep-memo.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- the structural cache is read and written during render by design (see the docstring) */\nimport { useRef } from \"react\";\n\nfunction deepEqual(a: unknown, b: unknown): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) return false;\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) return false;\n        return a.every((value, index) => deepEqual(value, b[index]));\n    }\n    const aKeys = Object.keys(a as object);\n    const bKeys = Object.keys(b as object);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every((key) =>\n        deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n    );\n}\n\n/**\n * Memoize a value with a structural equality check. Use when an object/array\n * created during render is fed to `useEffect` dependencies and you want to\n * avoid spurious effect runs when only the reference changes.\n *\n * The cache is a ref read and written during render. That is flagged by the React\n * Compiler rules and is nonetheless correct here: the write is idempotent — a\n * discarded render either wrote a structurally equal value or nothing at all — so\n * replaying the render cannot change the result.\n */\nexport function useDeepMemo<T>(value: T): T {\n    const ref = useRef<T>(value);\n    if (!deepEqual(ref.current, value)) {\n        ref.current = value;\n    }\n    return ref.current;\n}\n"],"mappings":"uBAGA,SAAS,EAAU,EAAY,EAAqB,CAChD,GAAI,OAAO,GAAG,EAAG,CAAC,EAAG,MAAO,GAE5B,GADI,OAAO,GAAM,UAAY,OAAO,GAAM,UAAY,IAAM,MAAQ,IAAM,MACtE,MAAM,QAAQ,CAAC,IAAM,MAAM,QAAQ,CAAC,EAAG,MAAO,GAClD,GAAI,MAAM,QAAQ,CAAC,GAAK,MAAM,QAAQ,CAAC,EAEnC,OADI,EAAE,SAAW,EAAE,QACZ,EAAE,OAAO,EAAO,IAAU,EAAU,EAAO,EAAE,EAAM,CAAC,EAE/D,IAAM,EAAQ,OAAO,KAAK,CAAW,EAC/B,EAAQ,OAAO,KAAK,CAAW,EAErC,OADI,EAAM,SAAW,EAAM,QACpB,EAAM,MAAO,GAChB,EAAW,EAA8B,GAAO,EAA8B,EAAI,CACtF,CACJ,CAYA,SAAgB,EAAe,EAAa,CACxC,IAAM,GAAA,EAAA,EAAA,OAAA,CAAgB,CAAK,EAI3B,OAHK,EAAU,EAAI,QAAS,CAAK,IAC7B,EAAI,QAAU,GAEX,EAAI,OACf"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-deep-memo.js","names":[],"sources":["../../src/hooks/use-deep-memo.ts"],"sourcesContent":["import { useRef } from \"react\";\n\nfunction deepEqual(a: unknown, b: unknown): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) return false;\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) return false;\n        return a.every((value, index) => deepEqual(value, b[index]));\n    }\n    const aKeys = Object.keys(a as object);\n    const bKeys = Object.keys(b as object);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every((key) =>\n        deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n    );\n}\n\n/**\n * Memoize a value with a structural equality check. Use when an object/array\n * created during render is fed to `useEffect` dependencies and you want to\n * avoid spurious effect runs when only the reference changes.\n */\nexport function useDeepMemo<T>(value: T): T {\n    const ref = useRef<T>(value);\n    if (!deepEqual(ref.current, value)) {\n        ref.current = value;\n    }\n    return ref.current;\n}\n"],"mappings":";;AAEA,SAAS,EAAU,GAAY,GAAqB;CAChD,IAAI,OAAO,GAAG,GAAG,CAAC,GAAG,OAAO;CAE5B,IADI,OAAO,KAAM,YAAY,OAAO,KAAM,YAAY,MAAM,QAAQ,MAAM,QACtE,MAAM,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,GAAG,OAAO;CAClD,IAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAEnC,OADI,EAAE,WAAW,EAAE,UACZ,EAAE,OAAO,GAAO,MAAU,EAAU,GAAO,EAAE,EAAM,CAAC;CAE/D,IAAM,IAAQ,OAAO,KAAK,CAAW,GAC/B,IAAQ,OAAO,KAAK,CAAW;CAErC,OADI,EAAM,WAAW,EAAM,UACpB,EAAM,OAAO,MAChB,EAAW,EAA8B,IAAO,EAA8B,EAAI,CACtF;AACJ;AAOA,SAAgB,EAAe,GAAa;CACxC,IAAM,IAAM,EAAU,CAAK;CAI3B,OAHK,EAAU,EAAI,SAAS,CAAK,MAC7B,EAAI,UAAU,IAEX,EAAI;AACf"}
+{"version":3,"file":"use-deep-memo.js","names":[],"sources":["../../src/hooks/use-deep-memo.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- the structural cache is read and written during render by design (see the docstring) */\nimport { useRef } from \"react\";\n\nfunction deepEqual(a: unknown, b: unknown): boolean {\n    if (Object.is(a, b)) return true;\n    if (typeof a !== \"object\" || typeof b !== \"object\" || a === null || b === null) return false;\n    if (Array.isArray(a) !== Array.isArray(b)) return false;\n    if (Array.isArray(a) && Array.isArray(b)) {\n        if (a.length !== b.length) return false;\n        return a.every((value, index) => deepEqual(value, b[index]));\n    }\n    const aKeys = Object.keys(a as object);\n    const bKeys = Object.keys(b as object);\n    if (aKeys.length !== bKeys.length) return false;\n    return aKeys.every((key) =>\n        deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n    );\n}\n\n/**\n * Memoize a value with a structural equality check. Use when an object/array\n * created during render is fed to `useEffect` dependencies and you want to\n * avoid spurious effect runs when only the reference changes.\n *\n * The cache is a ref read and written during render. That is flagged by the React\n * Compiler rules and is nonetheless correct here: the write is idempotent — a\n * discarded render either wrote a structurally equal value or nothing at all — so\n * replaying the render cannot change the result.\n */\nexport function useDeepMemo<T>(value: T): T {\n    const ref = useRef<T>(value);\n    if (!deepEqual(ref.current, value)) {\n        ref.current = value;\n    }\n    return ref.current;\n}\n"],"mappings":";;AAGA,SAAS,EAAU,GAAY,GAAqB;CAChD,IAAI,OAAO,GAAG,GAAG,CAAC,GAAG,OAAO;CAE5B,IADI,OAAO,KAAM,YAAY,OAAO,KAAM,YAAY,MAAM,QAAQ,MAAM,QACtE,MAAM,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,GAAG,OAAO;CAClD,IAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAEnC,OADI,EAAE,WAAW,EAAE,UACZ,EAAE,OAAO,GAAO,MAAU,EAAU,GAAO,EAAE,EAAM,CAAC;CAE/D,IAAM,IAAQ,OAAO,KAAK,CAAW,GAC/B,IAAQ,OAAO,KAAK,CAAW;CAErC,OADI,EAAM,WAAW,EAAM,UACpB,EAAM,OAAO,MAChB,EAAW,EAA8B,IAAO,EAA8B,EAAI,CACtF;AACJ;AAYA,SAAgB,EAAe,GAAa;CACxC,IAAM,IAAM,EAAU,CAAK;CAI3B,OAHK,EAAU,EAAI,SAAS,CAAK,MAC7B,EAAI,UAAU,IAEX,EAAI;AACf"}

package/dist/hooks/use-event-listener.cjs

@@ -1,2 +1,2 @@
-let e=require("react");function t(t,n,r,i){let a=(0,e.useRef)(n);a.current=n,(0,e.useEffect)(()=>{let e=r===void 0?typeof window>`u`?null:window:`current`in r?r.current??null:r;if(!e?.addEventListener)return;let n=e=>a.current(e);return e.addEventListener(t,n,i),()=>e.removeEventListener(t,n,i)},[t,r,i])}exports.useEventListener=t;
+let e=require("react");function t(t,n,r,i){let a=(0,e.useRef)(n);(0,e.useEffect)(()=>{a.current=n},[n]),(0,e.useEffect)(()=>{let e=r===void 0?typeof window>`u`?null:window:`current`in r?r.current??null:r;if(!e?.addEventListener)return;let n=e=>a.current(e);return e.addEventListener(t,n,i),()=>e.removeEventListener(t,n,i)},[t,r,i])}exports.useEventListener=t;
 //# sourceMappingURL=use-event-listener.cjs.map