cursedbelt 0.0.0

package/dist/react/hooks/useDragReorder.d.ts

@@ -0,0 +1,70 @@
+import { type FC, type ReactNode } from 'react';
+import type { DragItemApi } from './dragShared';
+/** Layout axis the list flows along — picks the sort strategy + a drag axis-lock. */
+export type DragAxis = 'x' | 'y' | 'both';
+export interface DragReorderOptions<T> {
+    /** Items in their current order. Reordering produces a permutation of this array. */
+    items: T[];
+    /** Stable string key per item (must be unique within the list). */
+    getKey: (item: T) => string;
+    /** Committed on drop, only when the order actually changed, with the next order. */
+    onReorder: (next: T[]) => void;
+    /** Layout axis (default `'y'`). `'both'` = a wrapping grid (free 2-axis drag). */
+    axis?: DragAxis;
+    /** When `true`, only an element wired with `handleProps` initiates the drag (the
+     *  rest of the row stays clickable). When `false` (default) the whole row drags. */
+    handle?: boolean;
+    /** Turn the whole list non-draggable. */
+    disabled?: boolean;
+    /** Optional clone rendered in the body-portal `DragOverlay` so the lifted item
+     *  follows the cursor without being clipped by a scroll container. When omitted,
+     *  the item lifts in place (fine for in-flow lists). */
+    renderOverlay?: (item: T) => ReactNode;
+}
+export interface DragReorderResult<T> {
+    /** The live order (identical to the input `items`; the app owns the data). */
+    items: T[];
+    /** Key of the item currently being dragged, or `null`. */
+    activeKey: string | null;
+    /** Wrap the rendered list in this once. Provides the dnd context + the overlay. */
+    DragContext: FC<{
+        children: ReactNode;
+    }>;
+    /** Render each item through this. The render-prop receives the props to wire the
+     *  row (`setNodeRef`/`style`) and the grab affordance (`handleProps`). */
+    Sortable: FC<{
+        itemKey: string;
+        children: (api: DragItemApi) => ReactNode;
+    }>;
+}
+/**
+ * Pure reorder: move `activeKey` to where `overKey` sits, returning the next item
+ * array (or the same array reference's values when nothing moves). Built on
+ * `arrayMove` so the same-index / boundary cases are handled correctly.
+ */
+export declare function reorderItems<T>(items: T[], getKey: (item: T) => string, activeKey: string, overKey: string): T[];
+/**
+ * Drag-to-reorder a single list, backed by `@dnd-kit/sortable`. Full keyboard
+ * (Tab → Space → arrows → Space) and touch (long-press, no stale-tap) support come
+ * for free from the shared sensors; siblings animate open a gap as the dragged item
+ * passes, and an optional `DragOverlay` clone follows the cursor unclipped.
+ *
+ * ```tsx
+ * const { items, DragContext, Sortable } = useDragReorder({ items: rows, getKey: r => r.id, onReorder: setRows });
+ * return (
+ *   <DragContext>
+ *     <ul>
+ *       {items.map(row => (
+ *         <Sortable key={row.id} itemKey={row.id}>
+ *           {({ setNodeRef, style, handleProps, isDragging }) => (
+ *             <li ref={setNodeRef} style={style} {...handleProps} data-dragging={isDragging}>{row.label}</li>
+ *           )}
+ *         </Sortable>
+ *       ))}
+ *     </ul>
+ *   </DragContext>
+ * );
+ * ```
+ */
+export declare function useDragReorder<T>({ items, getKey, onReorder, axis, handle, disabled, renderOverlay, }: DragReorderOptions<T>): DragReorderResult<T>;
+//# sourceMappingURL=useDragReorder.d.ts.map

package/dist/react/hooks/useDragReorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDragReorder.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useDragReorder.tsx"],"names":[],"mappings":"AAoBA,OAAO,EAAsB,KAAK,EAAE,EAAE,KAAK,SAAS,EAA6B,MAAM,OAAO,CAAC;AAC/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,qFAAqF;AACrF,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;AAE1C,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,qFAAqF;IACrF,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,mEAAmE;IACnE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC5B,oFAAoF;IACpF,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC/B,kFAAkF;IAClF,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;wFACoF;IACpF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;4DAEwD;IACxD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,8EAA8E;IAC9E,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,0DAA0D;IAC1D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mFAAmF;IACnF,WAAW,EAAE,EAAE,CAAC;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACzC;8EAC0E;IAC1E,QAAQ,EAAE,EAAE,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,SAAS,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,CAAC,EAAE,CAKL;AAcD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAChC,KAAK,EACL,MAAM,EACN,SAAS,EACT,IAAU,EACV,MAAc,EACd,QAAgB,EAChB,aAAa,GACd,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAuF9C"}

package/dist/react/hooks/useDragReorder.js

@@ -0,0 +1,134 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { closestCenter, DndContext, DragOverlay, } from '@dnd-kit/core';
+import { restrictToHorizontalAxis, restrictToVerticalAxis } from '@dnd-kit/modifiers';
+import { arrayMove, horizontalListSortingStrategy, rectSortingStrategy, SortableContext, sortableKeyboardCoordinates, useSortable, verticalListSortingStrategy, } from '@dnd-kit/sortable';
+import { CSS } from '@dnd-kit/utilities';
+import { useMemo, useRef, useState } from 'react';
+import { useDndSensors } from './useDndSensors';
+/**
+ * Pure reorder: move `activeKey` to where `overKey` sits, returning the next item
+ * array (or the same array reference's values when nothing moves). Built on
+ * `arrayMove` so the same-index / boundary cases are handled correctly.
+ */
+export function reorderItems(items, getKey, activeKey, overKey) {
+    const from = items.findIndex((it) => getKey(it) === activeKey);
+    const to = items.findIndex((it) => getKey(it) === overKey);
+    if (from < 0 || to < 0 || from === to)
+        return items;
+    return arrayMove(items, from, to);
+}
+const STRATEGY = {
+    y: verticalListSortingStrategy,
+    x: horizontalListSortingStrategy,
+    both: rectSortingStrategy,
+};
+const AXIS_LOCK = {
+    y: [restrictToVerticalAxis],
+    x: [restrictToHorizontalAxis],
+    both: [],
+};
+/**
+ * Drag-to-reorder a single list, backed by `@dnd-kit/sortable`. Full keyboard
+ * (Tab → Space → arrows → Space) and touch (long-press, no stale-tap) support come
+ * for free from the shared sensors; siblings animate open a gap as the dragged item
+ * passes, and an optional `DragOverlay` clone follows the cursor unclipped.
+ *
+ * ```tsx
+ * const { items, DragContext, Sortable } = useDragReorder({ items: rows, getKey: r => r.id, onReorder: setRows });
+ * return (
+ *   <DragContext>
+ *     <ul>
+ *       {items.map(row => (
+ *         <Sortable key={row.id} itemKey={row.id}>
+ *           {({ setNodeRef, style, handleProps, isDragging }) => (
+ *             <li ref={setNodeRef} style={style} {...handleProps} data-dragging={isDragging}>{row.label}</li>
+ *           )}
+ *         </Sortable>
+ *       ))}
+ *     </ul>
+ *   </DragContext>
+ * );
+ * ```
+ */
+export function useDragReorder({ items, getKey, onReorder, axis = 'y', handle = false, disabled = false, renderOverlay, }) {
+    const sensors = useDndSensors(sortableKeyboardCoordinates);
+    const [activeKey, setActiveKey] = useState(null);
+    const keys = useMemo(() => items.map(getKey), [items, getKey]);
+    const activeItem = activeKey == null ? null : (items.find((it) => getKey(it) === activeKey) ?? null);
+    // The wrapper components (`DragContext`/`Sortable`) MUST keep a stable identity
+    // across renders: if they were recreated when `activeKey` changes, React would
+    // remount the `DndContext` mid-drag and abort it. So they're created once and read
+    // live values from this ref, refreshed every render.
+    const cfgValue = {
+        sensors,
+        modifiers: AXIS_LOCK[axis],
+        strategy: STRATEGY[axis],
+        keys,
+        disabled,
+        handle,
+        hasOverlay: Boolean(renderOverlay),
+        renderOverlay,
+        activeItem,
+        items,
+        getKey,
+        onReorder,
+    };
+    const cfg = useRef(cfgValue);
+    cfg.current = cfgValue;
+    const stable = useRef(undefined);
+    if (!stable.current) {
+        const onDragStart = (e) => setActiveKey(String(e.active.id));
+        const onDragCancel = () => setActiveKey(null);
+        const onDragEnd = (e) => {
+            setActiveKey(null);
+            const { active, over } = e;
+            if (!over || active.id === over.id)
+                return;
+            const c = cfg.current;
+            const next = reorderItems(c.items, c.getKey, String(active.id), String(over.id));
+            if (next !== c.items)
+                c.onReorder(next);
+        };
+        const DragContext = ({ children }) => {
+            const c = cfg.current;
+            return (_jsxs(DndContext, { sensors: c.sensors, collisionDetection: closestCenter, modifiers: c.modifiers, onDragStart: onDragStart, onDragEnd: onDragEnd, onDragCancel: onDragCancel, children: [_jsx(SortableContext, { items: c.keys, strategy: c.strategy, disabled: c.disabled, children: children }), c.hasOverlay && (_jsx(DragOverlay, { children: c.activeItem && c.renderOverlay ? c.renderOverlay(c.activeItem) : null }))] }));
+        };
+        const Sortable = ({ itemKey, children, }) => {
+            const c = cfg.current;
+            return (_jsx(SortableRow, { itemKey: itemKey, disabled: c.disabled, hasOverlay: c.hasOverlay, handle: c.handle, children: children }));
+        };
+        stable.current = { DragContext, Sortable };
+    }
+    return {
+        items,
+        activeKey,
+        DragContext: stable.current.DragContext,
+        Sortable: stable.current.Sortable,
+    };
+}
+/** Per-item subscriber: calls `useSortable` and exposes its data via the render-prop. */
+function SortableRow({ itemKey, disabled, hasOverlay, handle, children, }) {
+    const { setNodeRef, setActivatorNodeRef, transform, transition, isDragging, attributes, listeners, } = useSortable({ id: itemKey, disabled });
+    const style = {
+        transform: CSS.Translate.toString(transform),
+        transition,
+        // When a portal overlay carries the clone, hide the in-flow original so only the
+        // gap shows; otherwise the row lifts in place (raised + semi-transparent).
+        ...(isDragging
+            ? hasOverlay
+                ? { opacity: 0 }
+                : { opacity: 0.6, zIndex: 50, position: 'relative', cursor: 'grabbing' }
+            : null),
+        ...(isDragging || transform ? { willChange: 'transform' } : null),
+        ...(handle ? null : { touchAction: 'none' }),
+    };
+    return children({
+        setNodeRef,
+        setActivatorNodeRef,
+        style,
+        handleProps: { ...attributes, ...listeners, ...(handle ? { style: HANDLE_STYLE } : null) },
+        isDragging,
+    });
+}
+const HANDLE_STYLE = { touchAction: 'none', cursor: 'grab' };
+//# sourceMappingURL=useDragReorder.js.map

package/dist/react/hooks/useDragReorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDragReorder.js","sourceRoot":"","sources":["../../../src/react/hooks/useDragReorder.tsx"],"names":[],"mappings":"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"}

package/dist/react/hooks/useDragToMove.d.ts

@@ -0,0 +1,65 @@
+import { type CSSProperties, type FC, type ReactNode } from 'react';
+/** A free 2-D position (in the positioning context's pixels). */
+export interface FreePosition {
+    x: number;
+    y: number;
+}
+export interface DragToMoveOptions {
+    /** Logical group id (unused by the engine; handy for the app's own bookkeeping). */
+    containerId?: string;
+    /** Stable id for this draggable (unique within its {@link FreeDragArea}). */
+    itemId: string;
+    /** The committed position. The element renders at `left/top = position` plus the
+     *  live drag delta; on drop the delta is folded in via `onMoved`. */
+    position: FreePosition;
+    /** Called on drop with the new position (the app owns persistence). */
+    onMoved: (next: FreePosition) => void;
+    /** `'absolute'` (default) positions within the nearest positioned ancestor;
+     *  `'fixed'` positions against the viewport (e.g. a floating dock). */
+    mode?: 'absolute' | 'fixed';
+    disabled?: boolean;
+}
+export interface DragToMoveResult {
+    ref: (el: HTMLElement | null) => void;
+    style: CSSProperties;
+    isDragging: boolean;
+    dragHandleProps: Record<string, unknown>;
+}
+/** The next position after applying a drag `delta` to a committed `position`. Pure. */
+export declare function nextFreePosition(position: FreePosition, delta: {
+    x: number;
+    y: number;
+}): FreePosition;
+/**
+ * Free positional drag for a single element (a layout-canvas node, a file tile, a
+ * floating dock) — no sort order, just "put it where I drop it." Backed by
+ * `@dnd-kit`'s `useDraggable`, so it inherits the shared keyboard + touch support.
+ *
+ * Must render inside a {@link FreeDragArea}, which owns the dnd context, the bounds
+ * constraint, and dispatching the drop to each item's `onMoved`.
+ *
+ * ```tsx
+ * <FreeDragArea bounds='parent'>
+ *   {nodes.map(n => <Node key={n.id} node={n} />)}
+ * </FreeDragArea>
+ * // inside <Node>:
+ * const { ref, style, dragHandleProps, isDragging } = useDragToMove({
+ *   itemId: node.id, position: node.pos, onMoved: pos => save(node.id, pos),
+ * });
+ * return <div ref={ref} style={style} {...dragHandleProps} />;
+ * ```
+ */
+export declare function useDragToMove({ itemId, position, onMoved, mode, disabled, }: DragToMoveOptions): DragToMoveResult;
+export interface FreeDragAreaProps {
+    children: ReactNode;
+    /** Constrain the drag to the parent element or to the viewport (default unbounded). */
+    bounds?: 'parent' | 'window';
+}
+/**
+ * The dnd context every {@link useDragToMove} item lives inside. It configures the
+ * shared sensors + the optional bounds modifier, and on drop reads each dragged
+ * item's `onMoved`/`position` (stashed on its draggable data) to commit the new
+ * position. One provider can host many free-moving items.
+ */
+export declare const FreeDragArea: FC<FreeDragAreaProps>;
+//# sourceMappingURL=useDragToMove.d.ts.map

package/dist/react/hooks/useDragToMove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDragToMove.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useDragToMove.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAe,MAAM,OAAO,CAAC;AAGjF,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf;yEACqE;IACrE,QAAQ,EAAE,YAAY,CAAC;IACvB,uEAAuE;IACvE,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC;2EACuE;IACvE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACtC,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,YAAY,CAEd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAiB,EACjB,QAAgB,GACjB,EAAE,iBAAiB,GAAG,gBAAgB,CAuBtC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB,uFAAuF;IACvF,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC9B;AAOD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAoB9C,CAAC"}

package/dist/react/hooks/useDragToMove.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DndContext, useDraggable } from '@dnd-kit/core';
+import { restrictToParentElement, restrictToWindowEdges } from '@dnd-kit/modifiers';
+import { CSS } from '@dnd-kit/utilities';
+import { useCallback } from 'react';
+import { useDndSensors } from './useDndSensors';
+/** The next position after applying a drag `delta` to a committed `position`. Pure. */
+export function nextFreePosition(position, delta) {
+    return { x: position.x + delta.x, y: position.y + delta.y };
+}
+/**
+ * Free positional drag for a single element (a layout-canvas node, a file tile, a
+ * floating dock) — no sort order, just "put it where I drop it." Backed by
+ * `@dnd-kit`'s `useDraggable`, so it inherits the shared keyboard + touch support.
+ *
+ * Must render inside a {@link FreeDragArea}, which owns the dnd context, the bounds
+ * constraint, and dispatching the drop to each item's `onMoved`.
+ *
+ * ```tsx
+ * <FreeDragArea bounds='parent'>
+ *   {nodes.map(n => <Node key={n.id} node={n} />)}
+ * </FreeDragArea>
+ * // inside <Node>:
+ * const { ref, style, dragHandleProps, isDragging } = useDragToMove({
+ *   itemId: node.id, position: node.pos, onMoved: pos => save(node.id, pos),
+ * });
+ * return <div ref={ref} style={style} {...dragHandleProps} />;
+ * ```
+ */
+export function useDragToMove({ itemId, position, onMoved, mode = 'absolute', disabled = false, }) {
+    const { setNodeRef, transform, isDragging, attributes, listeners } = useDraggable({
+        id: itemId,
+        disabled,
+        data: { onMoved, position },
+    });
+    const style = {
+        position: mode,
+        left: position.x,
+        top: position.y,
+        transform: CSS.Translate.toString(transform),
+        touchAction: 'none',
+        ...(isDragging || transform ? { willChange: 'transform' } : null),
+        ...(isDragging ? { zIndex: 50, cursor: 'grabbing' } : null),
+    };
+    return {
+        ref: setNodeRef,
+        style,
+        isDragging,
+        dragHandleProps: { ...attributes, ...listeners },
+    };
+}
+/**
+ * The dnd context every {@link useDragToMove} item lives inside. It configures the
+ * shared sensors + the optional bounds modifier, and on drop reads each dragged
+ * item's `onMoved`/`position` (stashed on its draggable data) to commit the new
+ * position. One provider can host many free-moving items.
+ */
+export const FreeDragArea = ({ children, bounds }) => {
+    const sensors = useDndSensors();
+    const modifiers = bounds === 'parent'
+        ? [restrictToParentElement]
+        : bounds === 'window'
+            ? [restrictToWindowEdges]
+            : [];
+    const onDragEnd = useCallback((e) => {
+        const data = e.active.data.current;
+        if (!data)
+            return;
+        onMovedFrom(data, e.delta);
+    }, []);
+    return (_jsx(DndContext, { sensors: sensors, modifiers: modifiers, onDragEnd: onDragEnd, children: children }));
+};
+function onMovedFrom(data, delta) {
+    data.onMoved(nextFreePosition(data.position, delta));
+}
+//# sourceMappingURL=useDragToMove.js.map

package/dist/react/hooks/useDragToMove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDragToMove.js","sourceRoot":"","sources":["../../../src/react/hooks/useDragToMove.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAqB,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAA+C,WAAW,EAAE,MAAM,OAAO,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA+BhD,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAC9B,QAAsB,EACtB,KAA+B;IAE/B,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GAAG,UAAU,EACjB,QAAQ,GAAG,KAAK,GACE;IAClB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC;QAChF,EAAE,EAAE,MAAM;QACV,QAAQ;QACR,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE;KAC5B,CAAC,CAAC;IAEH,MAAM,KAAK,GAAkB;QAC3B,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChB,GAAG,EAAE,QAAQ,CAAC,CAAC;QACf,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC5C,WAAW,EAAE,MAAM;QACnB,GAAG,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;KAC5D,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,UAAU;QACf,KAAK;QACL,UAAU;QACV,eAAe,EAAE,EAAE,GAAG,UAAU,EAAE,GAAG,SAAS,EAAE;KACjD,CAAC;AACJ,CAAC;AAaD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAA0B,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;IAC1E,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,SAAS,GACb,MAAM,KAAK,QAAQ;QACjB,CAAC,CAAC,CAAC,uBAAuB,CAAC;QAC3B,CAAC,CAAC,MAAM,KAAK,QAAQ;YACnB,CAAC,CAAC,CAAC,qBAAqB,CAAC;YACzB,CAAC,CAAC,EAAE,CAAC;IAEX,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAe,EAAE,EAAE;QAChD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAA+B,CAAC;QAC3D,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACL,KAAC,UAAU,IAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,YACrE,QAAQ,GACE,CACd,CAAC;AACJ,CAAC,CAAC;AAEF,SAAS,WAAW,CAAC,IAAc,EAAE,KAA+B;IAClE,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/react/hooks/useEscapeKey.d.ts

@@ -0,0 +1,3 @@
+/** Call `handler` on the Escape key while `active`. */
+export declare const useEscapeKey: (handler: () => void, active?: boolean) => void;
+//# sourceMappingURL=useEscapeKey.d.ts.map

package/dist/react/hooks/useEscapeKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEscapeKey.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useEscapeKey.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,IAAI,EAAE,gBAAa,KAAG,IASjE,CAAC"}

package/dist/react/hooks/useEscapeKey.js

@@ -0,0 +1,15 @@
+import { useEffect } from 'react';
+/** Call `handler` on the Escape key while `active`. */
+export const useEscapeKey = (handler, active = true) => {
+    useEffect(() => {
+        if (!active)
+            return;
+        const onKey = (e) => {
+            if (e.key === 'Escape')
+                handler();
+        };
+        window.addEventListener('keydown', onKey);
+        return () => window.removeEventListener('keydown', onKey);
+    }, [active, handler]);
+};
+//# sourceMappingURL=useEscapeKey.js.map

package/dist/react/hooks/useEscapeKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEscapeKey.js","sourceRoot":"","sources":["../../../src/react/hooks/useEscapeKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAmB,EAAE,MAAM,GAAG,IAAI,EAAQ,EAAE;IACvE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,KAAK,GAAG,CAAC,CAAgB,EAAE,EAAE;YACjC,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;QACpC,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACxB,CAAC,CAAC"}

package/dist/react/hooks/useHasHover.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Whether the device has a hover-capable pointer (mouse/trackpad) rather than a
+ * touch screen. Returns `true` on the server / where `matchMedia` is unavailable,
+ * so hover-only UI degrades to its desktop default instead of flashing a touch
+ * fallback. Reactive: a hybrid device gaining/losing a pointer updates live.
+ * Pairs with Tooltip's touch (`mobile`) behavior.
+ */
+export declare const useHasHover: () => boolean;
+//# sourceMappingURL=useHasHover.d.ts.map

package/dist/react/hooks/useHasHover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHasHover.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useHasHover.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,QAAO,OAgB9B,CAAC"}

package/dist/react/hooks/useHasHover.js

@@ -0,0 +1,39 @@
+import { useEffect, useState } from 'react';
+// A device "has hover" when it exposes a fine pointer that can hover (a mouse or
+// trackpad) — i.e. NOT a touch screen. Testing both axes keeps a hybrid laptop
+// (touchscreen AND trackpad) counted as hover-capable.
+const HOVER_QUERY = '(hover: hover) and (pointer: fine)';
+const detectHasHover = () => {
+    if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
+        return true;
+    return window.matchMedia(HOVER_QUERY).matches;
+};
+/**
+ * Whether the device has a hover-capable pointer (mouse/trackpad) rather than a
+ * touch screen. Returns `true` on the server / where `matchMedia` is unavailable,
+ * so hover-only UI degrades to its desktop default instead of flashing a touch
+ * fallback. Reactive: a hybrid device gaining/losing a pointer updates live.
+ * Pairs with Tooltip's touch (`mobile`) behavior.
+ */
+export const useHasHover = () => {
+    const [hasHover, setHasHover] = useState(detectHasHover);
+    useEffect(() => {
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
+            return;
+        const mql = window.matchMedia(HOVER_QUERY);
+        const onChange = () => setHasHover(mql.matches);
+        onChange();
+        if (typeof mql.addEventListener === 'function')
+            mql.addEventListener('change', onChange);
+        else
+            mql.addListener(onChange);
+        return () => {
+            if (typeof mql.removeEventListener === 'function')
+                mql.removeEventListener('change', onChange);
+            else
+                mql.removeListener(onChange);
+        };
+    }, []);
+    return hasHover;
+};
+//# sourceMappingURL=useHasHover.js.map

package/dist/react/hooks/useHasHover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHasHover.js","sourceRoot":"","sources":["../../../src/react/hooks/useHasHover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,iFAAiF;AACjF,+EAA+E;AAC/E,uDAAuD;AACvD,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEzD,MAAM,cAAc,GAAG,GAAY,EAAE;IACnC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC1F,OAAO,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;AAChD,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAY,EAAE;IACvC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;IACzD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;YAAE,OAAO;QACrF,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,QAAQ,EAAE,CAAC;QACX,IAAI,OAAO,GAAG,CAAC,gBAAgB,KAAK,UAAU;YAAE,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;;YACpF,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE;YACV,IAAI,OAAO,GAAG,CAAC,mBAAmB,KAAK,UAAU;gBAC/C,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;;gBACzC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/react/hooks/useKeyDown.d.ts

@@ -0,0 +1,16 @@
+export interface UseKeyDownOptions {
+    /** Listen only while active (default true). */
+    active?: boolean;
+    /** Call `event.preventDefault()` on match (default true). */
+    preventDefault?: boolean;
+    /** Target to listen on (default `document`). */
+    target?: Pick<Document | HTMLElement, 'addEventListener' | 'removeEventListener'>;
+}
+/**
+ * Run `handler` whenever `key` is pressed. `key` is a friendly alias
+ * (`'enter'`, `'escape'`, `'space'`, the arrows…) or a raw `KeyboardEvent.key`.
+ * The handler is always the latest one (held in a ref), so a closure reading
+ * state never goes stale even though the listener is registered once.
+ */
+export declare const useKeyDown: (key: string, handler: (event: KeyboardEvent) => void, options?: UseKeyDownOptions) => void;
+//# sourceMappingURL=useKeyDown.d.ts.map

package/dist/react/hooks/useKeyDown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyDown.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useKeyDown.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,WAAW,EAAE,kBAAkB,GAAG,qBAAqB,CAAC,CAAC;CACnF;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACrB,KAAK,MAAM,EACX,SAAS,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EACvC,UAAS,iBAAsB,KAC9B,IAmBF,CAAC"}

package/dist/react/hooks/useKeyDown.js

@@ -0,0 +1,42 @@
+import { useEffect, useRef } from 'react';
+// Friendly aliases → the `KeyboardEvent.key` value they map to. Anything not
+// listed is treated as a raw `event.key` (so `useKeyDown('a', …)` works too).
+const KEY_ALIASES = {
+    enter: 'Enter',
+    escape: 'Escape',
+    space: ' ',
+    arrowUp: 'ArrowUp',
+    arrowDown: 'ArrowDown',
+    arrowLeft: 'ArrowLeft',
+    arrowRight: 'ArrowRight',
+    tab: 'Tab',
+    backspace: 'Backspace',
+    delete: 'Delete',
+};
+/**
+ * Run `handler` whenever `key` is pressed. `key` is a friendly alias
+ * (`'enter'`, `'escape'`, `'space'`, the arrows…) or a raw `KeyboardEvent.key`.
+ * The handler is always the latest one (held in a ref), so a closure reading
+ * state never goes stale even though the listener is registered once.
+ */
+export const useKeyDown = (key, handler, options = {}) => {
+    const { active = true, preventDefault = true, target } = options;
+    const targetKey = KEY_ALIASES[key] ?? key;
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+        if (!active)
+            return;
+        const el = target ?? document;
+        const onKeyDown = (event) => {
+            if (event.key === targetKey) {
+                if (preventDefault)
+                    event.preventDefault();
+                handlerRef.current(event);
+            }
+        };
+        el.addEventListener('keydown', onKeyDown);
+        return () => el.removeEventListener('keydown', onKeyDown);
+    }, [targetKey, active, preventDefault, target]);
+};
+//# sourceMappingURL=useKeyDown.js.map

package/dist/react/hooks/useKeyDown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyDown.js","sourceRoot":"","sources":["../../../src/react/hooks/useKeyDown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAM,WAAW,GAA2B;IAC1C,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAWF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,GAAW,EACX,OAAuC,EACvC,UAA6B,EAAE,EACzB,EAAE;IACR,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACjE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IAE1C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,EAAE,GAAG,MAAM,IAAI,QAAQ,CAAC;QAC9B,MAAM,SAAS,GAAG,CAAC,KAAoB,EAAE,EAAE;YACzC,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,cAAc;oBAAE,KAAK,CAAC,cAAc,EAAE,CAAC;gBAC3C,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;QACF,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAA0B,CAAC,CAAC;QAC3D,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAA0B,CAAC,CAAC;IAC7E,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC"}

package/dist/react/hooks/useKeyboardInset.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Publish the on-screen keyboard's height as the CSS variable `--keyboard-inset`
+ * (px) on `<html>`. Install once near the app root — `AppShell` does this.
+ *
+ * The soft keyboard overlays the *layout* viewport: `vh`/`dvh` do NOT shrink for
+ * it (default `interactive-widget` behavior; unsupported on iOS). Only
+ * `window.visualViewport` reflects it. `ScrollArea` reads `--keyboard-inset` to
+ * keep the focused field above the keyboard. No-ops where VisualViewport is
+ * absent; pair with a `--keyboard-inset: 0px` default in your CSS (theme.css).
+ */
+export declare function useKeyboardInset(): void;
+//# sourceMappingURL=useKeyboardInset.d.ts.map

package/dist/react/hooks/useKeyboardInset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardInset.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useKeyboardInset.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAmBvC"}

package/dist/react/hooks/useKeyboardInset.js

@@ -0,0 +1,33 @@
+import { useEffect } from 'react';
+/**
+ * Publish the on-screen keyboard's height as the CSS variable `--keyboard-inset`
+ * (px) on `<html>`. Install once near the app root — `AppShell` does this.
+ *
+ * The soft keyboard overlays the *layout* viewport: `vh`/`dvh` do NOT shrink for
+ * it (default `interactive-widget` behavior; unsupported on iOS). Only
+ * `window.visualViewport` reflects it. `ScrollArea` reads `--keyboard-inset` to
+ * keep the focused field above the keyboard. No-ops where VisualViewport is
+ * absent; pair with a `--keyboard-inset: 0px` default in your CSS (theme.css).
+ */
+export function useKeyboardInset() {
+    useEffect(() => {
+        const vv = typeof window !== 'undefined' ? window.visualViewport : null;
+        if (!vv)
+            return;
+        const root = document.documentElement;
+        const update = () => {
+            // layout viewport minus the visible viewport (and its scroll offset) = the keyboard
+            const inset = Math.max(0, window.innerHeight - vv.height - vv.offsetTop);
+            root.style.setProperty('--keyboard-inset', `${Math.round(inset)}px`);
+        };
+        update();
+        vv.addEventListener('resize', update);
+        vv.addEventListener('scroll', update);
+        return () => {
+            vv.removeEventListener('resize', update);
+            vv.removeEventListener('scroll', update);
+            root.style.setProperty('--keyboard-inset', '0px');
+        };
+    }, []);
+}
+//# sourceMappingURL=useKeyboardInset.js.map

package/dist/react/hooks/useKeyboardInset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardInset.js","sourceRoot":"","sources":["../../../src/react/hooks/useKeyboardInset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB;IAC9B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,oFAAoF;YACpF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACzE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvE,CAAC,CAAC;QACF,MAAM,EAAE,CAAC;QACT,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtC,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,GAAG,EAAE;YACV,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACzC,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/dist/react/hooks/useMediaQuery.d.ts

@@ -0,0 +1,3 @@
+/** SSR-safe media-query hook. e.g. `useMediaQuery('(max-width: 639px)')`. */
+export declare function useMediaQuery(query: string): boolean;
+//# sourceMappingURL=useMediaQuery.d.ts.map

package/dist/react/hooks/useMediaQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaQuery.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useMediaQuery.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAapD"}

package/dist/react/hooks/useMediaQuery.js

@@ -0,0 +1,16 @@
+import { useEffect, useState } from 'react';
+/** SSR-safe media-query hook. e.g. `useMediaQuery('(max-width: 639px)')`. */
+export function useMediaQuery(query) {
+    const [matches, setMatches] = useState(() => typeof window !== 'undefined' ? window.matchMedia(query).matches : false);
+    useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        const mql = window.matchMedia(query);
+        const onChange = () => setMatches(mql.matches);
+        onChange();
+        mql.addEventListener('change', onChange);
+        return () => mql.removeEventListener('change', onChange);
+    }, [query]);
+    return matches;
+}
+//# sourceMappingURL=useMediaQuery.js.map

package/dist/react/hooks/useMediaQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaQuery.js","sourceRoot":"","sources":["../../../src/react/hooks/useMediaQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAC1C,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CACzE,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,QAAQ,EAAE,CAAC;QACX,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACZ,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/react/hooks/useOnlineStatus.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Track the browser's connectivity: seeds from `navigator.onLine` and updates on the
+ * `online`/`offline` window events. Returns `true` when online. Drives "you're
+ * offline" banners and disabling network actions. Re-syncs once on mount so it's
+ * correct even if connectivity changed between render and effect.
+ */
+export declare const useOnlineStatus: () => boolean;
+//# sourceMappingURL=useOnlineStatus.d.ts.map

package/dist/react/hooks/useOnlineStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOnlineStatus.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useOnlineStatus.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAO,OAclC,CAAC"}