@endora-commerce/admin-kit 0.0.0-stage → 0.100.0

package/dist/components/product-picker/ProductPicker.js

@@ -0,0 +1,143 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
+import { X } from 'lucide-react';
+// `apiClient` comes through the kit's published `lib` **barrel** for the reason
+// `SalesChannelPicker.tsx` records at length: `vi.mock` keys on a resolved
+// module id and the `exports` map declares no deep subpath, so the barrel is
+// the only spelling an admin test outside this package can name.
+import { ApiError, apiClient } from '../../lib/index.js';
+import { useTranslation } from '../../i18n/useTranslation.js';
+import { Badge } from '../../ui/badge.js';
+import { Combobox } from '../../ui/combobox.js';
+function pickName(name, fallback) {
+    if (!name)
+        return fallback;
+    return name['en-US'] ?? Object.values(name)[0] ?? fallback;
+}
+function productToOption(p) {
+    const statusSuffix = p.status === 'active' ? '' : ` · ${p.status}`;
+    return {
+        value: p.id,
+        label: pickName(p.name, p.slug),
+        description: `${p.sku}${statusSuffix}`,
+    };
+}
+const SEARCH_DEBOUNCE_MS = 250;
+const DEFAULT_PAGE_SIZE = 20;
+const UUID_PREFIX_LENGTH = 8;
+export function ProductPicker(props) {
+    const { excludeIds, includeArchived = false, placeholder, disabled = false, id, ariaLabel, pageSize = DEFAULT_PAGE_SIZE, } = props;
+    const t = useTranslation('core');
+    const resolvedPlaceholder = placeholder ?? t('productPicker.searchPlaceholder');
+    const [productCache, setProductCache] = useState(() => new Map());
+    const [options, setOptions] = useState([]);
+    const [searching, setSearching] = useState(false);
+    const [error, setError] = useState(null);
+    const valueKey = props.mode === 'select' ? props.value ?? '' : props.value.join(',');
+    const excludeSet = useMemo(() => {
+        const set = new Set(excludeIds ?? []);
+        if (props.mode === 'multiselect')
+            for (const v of props.value)
+                set.add(v);
+        return set;
+    }, [excludeIds, props.mode, valueKey]);
+    const searchTimerRef = useRef(null);
+    const searchSeqRef = useRef(0);
+    useEffect(() => () => {
+        if (searchTimerRef.current !== null)
+            clearTimeout(searchTimerRef.current);
+    }, []);
+    const runSearch = useCallback(async (query, seq) => {
+        setSearching(true);
+        setError(null);
+        try {
+            const params = new URLSearchParams();
+            params.set('page', '0');
+            params.set('pageSize', String(pageSize));
+            if (includeArchived)
+                params.set('includeArchived', '1');
+            const trimmed = query.trim();
+            if (trimmed.length > 0)
+                params.set('q', trimmed);
+            const res = await apiClient.get(`/api/v1/admin/catalog/products?${params.toString()}`);
+            if (seq !== searchSeqRef.current)
+                return;
+            setProductCache((prev) => {
+                const next = new Map(prev);
+                for (const p of res.data)
+                    next.set(p.id, p);
+                return next;
+            });
+            setOptions(res.data.map(productToOption));
+        }
+        catch (err) {
+            if (seq !== searchSeqRef.current)
+                return;
+            setError(err instanceof ApiError ? err.envelope.error.message : t('productPicker.searchFailed'));
+            setOptions([]);
+        }
+        finally {
+            if (seq === searchSeqRef.current)
+                setSearching(false);
+        }
+    }, [includeArchived, pageSize, t]);
+    const handleSearchChange = useCallback((query) => {
+        if (searchTimerRef.current !== null)
+            clearTimeout(searchTimerRef.current);
+        const seq = ++searchSeqRef.current;
+        searchTimerRef.current = setTimeout(() => {
+            void runSearch(query, seq);
+        }, SEARCH_DEBOUNCE_MS);
+    }, [runSearch]);
+    // Warm the cache for ids in `value` that the user hasn't searched yet —
+    // common when the picker is mounted with an existing selection.
+    const fetchedRef = useRef(new Set());
+    useEffect(() => {
+        const valueIds = props.mode === 'select' ? (props.value ? [props.value] : []) : props.value;
+        const missing = valueIds.filter((vid) => !productCache.has(vid) && !fetchedRef.current.has(vid));
+        if (missing.length === 0)
+            return;
+        for (const vid of missing)
+            fetchedRef.current.add(vid);
+        let alive = true;
+        void Promise.allSettled(missing.map((vid) => apiClient.get(`/api/v1/admin/catalog/products/${vid}`))).then((results) => {
+            if (!alive)
+                return;
+            setProductCache((prev) => {
+                const next = new Map(prev);
+                for (const r of results) {
+                    if (r.status === 'fulfilled')
+                        next.set(r.value.data.id, r.value.data);
+                }
+                return next;
+            });
+        });
+        return () => {
+            alive = false;
+        };
+    }, [valueKey, props.mode, productCache]);
+    const visibleOptions = useMemo(() => options.filter((opt) => !excludeSet.has(opt.value)), [options, excludeSet]);
+    const emptyMessage = error ?? (searching ? t('productPicker.searching') : t('productPicker.empty'));
+    // exactOptionalPropertyTypes: only forward `id`/`ariaLabel` when defined.
+    const optionalProps = {
+        ...(id !== undefined ? { id } : {}),
+        ...(ariaLabel !== undefined ? { ariaLabel } : {}),
+    };
+    if (props.mode === 'select') {
+        const selectedProduct = props.value ? productCache.get(props.value) ?? null : null;
+        return (_jsx(Combobox, { ...optionalProps, options: visibleOptions, value: props.value, selectedLabel: selectedProduct ? pickName(selectedProduct.name, selectedProduct.slug) : '', onChange: (next) => props.onChange(next), onSearchChange: handleSearchChange, manualFilter: true, loading: searching, placeholder: resolvedPlaceholder, disabled: disabled, emptyMessage: emptyMessage }));
+    }
+    const selectedIds = props.value;
+    return (_jsxs("div", { className: "space-y-2", children: [selectedIds.length > 0 ? (_jsx("div", { className: "flex flex-wrap gap-1.5", role: "list", children: selectedIds.map((sid) => {
+                    const p = productCache.get(sid);
+                    const label = p ? pickName(p.name, p.slug) : `${sid.slice(0, UUID_PREFIX_LENGTH)}…`;
+                    return (_jsxs(Badge, { variant: "secondary", className: "gap-1 pl-2 pr-1 font-normal", role: "listitem", children: [_jsx("span", { className: "max-w-[18rem] truncate", children: label }), p?.sku ? (_jsx("span", { className: "font-mono text-[10px] text-muted-foreground", children: p.sku })) : null, _jsx("button", { type: "button", className: "rounded-sm p-0.5 text-muted-foreground hover:bg-muted/60 hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", onClick: () => props.onChange(selectedIds.filter((existing) => existing !== sid)), "aria-label": t('productPicker.remove', { label }), disabled: disabled, children: _jsx(X, { className: "size-3", "aria-hidden": "true" }) })] }, sid));
+                }) })) : null, _jsx(Combobox, { ...optionalProps, options: visibleOptions, value: null, onChange: (next) => {
+                    if (next === null)
+                        return;
+                    if (selectedIds.includes(next))
+                        return;
+                    props.onChange([...selectedIds, next]);
+                }, onSearchChange: handleSearchChange, manualFilter: true, loading: searching, clearable: false, placeholder: resolvedPlaceholder, disabled: disabled, emptyMessage: emptyMessage })] }));
+}
+//# sourceMappingURL=ProductPicker.js.map

package/dist/components/product-picker/ProductPicker.js.map

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

package/dist/components/reorder/ReorderAnnouncer.d.ts

@@ -0,0 +1,29 @@
+import type { ReactNode } from 'react';
+/**
+ * The live region a reorderable list speaks through (FR-069, SC-014).
+ *
+ * Two rules make the difference between this working and this being decoration:
+ *
+ *  - it is **mounted for the lifetime of the list**, never rendered
+ *    conditionally when there is something to say. A region created at the
+ *    moment of its first message is not announced by any screen reader — the
+ *    node has to exist before the text changes inside it.
+ *  - it carries `role="status"` **and** `aria-live="polite"`, because the two
+ *    are honoured inconsistently across the screen-reader/browser matrix and
+ *    together they are what actually works everywhere.
+ *
+ * `aria-atomic` makes the whole sentence read out rather than the diff, which
+ * matters because consecutive moves differ by one word ("position 3 of 23").
+ */
+export interface ReorderAnnouncerProps {
+    /** The current sentence. Empty is fine, and is the normal resting state. */
+    message: string;
+    /**
+     * The keyboard instructions every handle points at through
+     * `aria-describedby`. Rendered once per list, visually hidden.
+     */
+    instructions?: string;
+    instructionsId?: string;
+}
+export declare function ReorderAnnouncer(props: ReorderAnnouncerProps): ReactNode;
+//# sourceMappingURL=ReorderAnnouncer.d.ts.map

package/dist/components/reorder/ReorderAnnouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReorderAnnouncer.d.ts","sourceRoot":"","sources":["../../../src/components/reorder/ReorderAnnouncer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CAcxE"}

package/dist/components/reorder/ReorderAnnouncer.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+export function ReorderAnnouncer(props) {
+    const { message, instructions, instructionsId } = props;
+    return (_jsxs(_Fragment, { children: [_jsx("p", { role: "status", "aria-live": "polite", "aria-atomic": "true", className: "sr-only", children: message }), instructions !== undefined ? (_jsx("p", { id: instructionsId, className: "sr-only", children: instructions })) : null] }));
+}
+//# sourceMappingURL=ReorderAnnouncer.js.map

package/dist/components/reorder/ReorderAnnouncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReorderAnnouncer.js","sourceRoot":"","sources":["../../../src/components/reorder/ReorderAnnouncer.tsx"],"names":[],"mappings":";AA8BA,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IACxD,OAAO,CACL,8BACE,YAAG,IAAI,EAAC,QAAQ,eAAW,QAAQ,iBAAa,MAAM,EAAC,SAAS,EAAC,SAAS,YACvE,OAAO,GACN,EACH,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,CAC5B,YAAG,EAAE,EAAE,cAAc,EAAE,SAAS,EAAC,SAAS,YACvC,YAAY,GACX,CACL,CAAC,CAAC,CAAC,IAAI,IACP,CACJ,CAAC;AACJ,CAAC"}

package/dist/components/reorder/useReorderList.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Keyboard-, pointer- and touch-operable list reordering, announced.
+ *
+ * Reorder is already reimplemented ad hoc in several admin surfaces
+ * (`dictionaries/LanguagesTab`, `catalog/ProductEditor`, `megamenu`), each with
+ * its own drag state and none with an announcement. This hook is the shared
+ * version, introduced for feature 067 (FR-069, SC-014) under Principle IX's UX
+ * escape hatch and deliberately placed in `components/` rather than inside the
+ * module that needed it first.
+ *
+ * **Three affordances, one result, all announced.** Pointer drag is native
+ * HTML5 (the in-repo idiom — `@dnd-kit` is not installed and this needs no
+ * dependency); `moveBy` drives `TouchReorderButtons` unchanged; and the handle
+ * implements the ARIA grab-mode keyboard map. A reorder available only through
+ * dragging fails FR-069 outright, and dragging is also the affordance that does
+ * not fire on touch at all.
+ *
+ * **The hook owns no list.** The caller passes `items` and receives
+ * `onReorder(next)`, so the order lives wherever the caller's state does —
+ * usually a draft the operator has not saved yet.
+ *
+ * **All copy is a prop.** The hook carries no strings, so it needs no i18n
+ * namespace of its own and cannot leak one module's vocabulary into another's.
+ */
+export interface ReorderLabelContext {
+    /** The moved item's label, in the operator's own words. */
+    name: string;
+    /** 1-based, because it is read aloud to a human. */
+    index: number;
+    total: number;
+}
+export interface ReorderLabels {
+    grabbed: (context: ReorderLabelContext) => string;
+    moving: (context: ReorderLabelContext) => string;
+    dropped: (context: ReorderLabelContext) => string;
+    cancelled: (context: ReorderLabelContext) => string;
+    moved: (context: ReorderLabelContext) => string;
+    atStart: (context: ReorderLabelContext) => string;
+    atEnd: (context: ReorderLabelContext) => string;
+    /** `aria-label` of the drag handle. */
+    handle: (context: ReorderLabelContext) => string;
+    /** `aria-roledescription` for a row. Defaults to `'sortable item'`. */
+    roleDescription?: string;
+}
+export interface UseReorderListOptions<T> {
+    items: T[];
+    getId: (item: T) => string;
+    getLabel: (item: T) => string;
+    onReorder: (next: T[]) => void;
+    labels: ReorderLabels;
+    /**
+     * Turns every affordance off and announces nothing. Used when the list is
+     * filtered: reordering a subset has no unambiguous meaning, and guessing at
+     * one is worse than refusing (ux-design §3.5).
+     */
+    disabled?: boolean;
+    /** Id of the visually-hidden instructions paragraph, for `aria-describedby`. */
+    instructionsId?: string;
+}
+export interface ReorderItemProps {
+    draggable: boolean;
+    'aria-roledescription': string;
+    'aria-posinset': number;
+    'aria-setsize': number;
+    onDragStart: (event: {
+        dataTransfer?: {
+            effectAllowed?: string;
+        } | null;
+    }) => void;
+    onDragOver: (event: {
+        preventDefault: () => void;
+    }) => void;
+    onDragLeave: () => void;
+    onDrop: (event: {
+        preventDefault: () => void;
+    }) => void;
+    onDragEnd: () => void;
+}
+export interface ReorderHandleProps {
+    ref: (element: HTMLElement | null) => void;
+    type: 'button';
+    tabIndex: 0 | -1;
+    'aria-label': string;
+    'aria-pressed': boolean;
+    'aria-describedby': string | undefined;
+    onKeyDown: (event: ReorderKeyboardEvent) => void;
+    onFocus: () => void;
+}
+/** The slice of a React keyboard event the hook consumes. */
+export interface ReorderKeyboardEvent {
+    key: string;
+    altKey: boolean;
+    preventDefault: () => void;
+    stopPropagation: () => void;
+}
+export interface UseReorderListResult<T> {
+    /** The sentence the live region is currently carrying. */
+    announcement: string;
+    /** Which item the keyboard is holding, if any. */
+    grabbedId: string | null;
+    /** Which item the pointer is dragging, if any. */
+    draggingId: string | null;
+    /** The row a drag is currently over, for the drop indicator. */
+    dropTargetId: string | null;
+    /** The list's single tab stop (the ARIA composite-widget pattern). */
+    activeId: string | null;
+    moveBy: (id: string, delta: number) => void;
+    /** `targetIndex` is 0-based; the announcement says the 1-based position. */
+    moveTo: (id: string, targetIndex: number) => void;
+    onHandleKeyDown: (id: string, event: ReorderKeyboardEvent) => void;
+    onDragStart: (id: string) => void;
+    onDrop: (overId: string) => void;
+    getItemProps: (item: T, index: number) => ReorderItemProps;
+    getHandleProps: (item: T, index: number) => ReorderHandleProps;
+}
+export declare function useReorderList<T>(options: UseReorderListOptions<T>): UseReorderListResult<T>;
+/** Utility for callers that need the same move outside the hook's affordances. */
+export declare function moveItem<T>(items: T[], from: number, to: number): T[];
+/** Also exported for the labels-only consumer that renders `labelOf` elsewhere. */
+export type { UseReorderListOptions as ReorderListOptions };
+//# sourceMappingURL=useReorderList.d.ts.map

package/dist/components/reorder/useReorderList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReorderList.d.ts","sourceRoot":"","sources":["../../../src/components/reorder/useReorderList.ts"],"names":[],"mappings":"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"}

package/dist/components/reorder/useReorderList.js

@@ -0,0 +1,241 @@
+import { useCallback, useMemo, useRef, useState } from 'react';
+export function useReorderList(options) {
+    const { items, getId, getLabel, onReorder, labels, disabled = false } = options;
+    const [announcement, setAnnouncement] = useState('');
+    const [grabbedId, setGrabbedId] = useState(null);
+    const [draggingId, setDraggingId] = useState(null);
+    const [dropTargetId, setDropTargetId] = useState(null);
+    const [focusedId, setFocusedId] = useState(null);
+    /** Where a grabbed item started, so `Escape` can undo the whole gesture. */
+    const grabOriginRef = useRef(null);
+    const handlesRef = useRef(new Map());
+    const ids = useMemo(() => items.map(getId), [items, getId]);
+    const activeId = focusedId && ids.includes(focusedId) ? focusedId : (ids[0] ?? null);
+    const indexOf = useCallback((id) => ids.indexOf(id), [ids]);
+    /**
+     * The single mutation. Everything else — drag, buttons, keyboard, "move to
+     * position…" — funnels through it, which is what keeps one announcement
+     * vocabulary across three affordances that would otherwise drift apart.
+     */
+    const applyMove = useCallback((id, targetIndex, announce) => {
+        if (disabled)
+            return false;
+        const from = indexOf(id);
+        if (from < 0)
+            return false;
+        const total = items.length;
+        const name = getLabel(items[from]);
+        if (targetIndex < 0) {
+            setAnnouncement(labels.atStart({ name, index: 1, total }));
+            return false;
+        }
+        if (targetIndex > total - 1) {
+            setAnnouncement(labels.atEnd({ name, index: total, total }));
+            return false;
+        }
+        if (targetIndex === from)
+            return false;
+        const next = [...items];
+        next.splice(from, 1);
+        next.splice(targetIndex, 0, items[from]);
+        onReorder(next);
+        setAnnouncement(announce({ name, index: targetIndex + 1, total }));
+        // The tab stop follows the item, not the slot: React keys are ids, so the
+        // DOM node travels with it and focus survives without a manual `.focus()`.
+        setFocusedId(id);
+        return true;
+    }, [disabled, indexOf, items, getLabel, labels, onReorder]);
+    const moveBy = useCallback((id, delta) => {
+        applyMove(id, indexOf(id) + delta, labels.moved);
+    }, [applyMove, indexOf, labels.moved]);
+    const moveTo = useCallback((id, targetIndex) => {
+        applyMove(id, targetIndex, labels.moved);
+    }, [applyMove, labels.moved]);
+    const focusHandle = useCallback((id) => {
+        setFocusedId(id);
+        handlesRef.current.get(id)?.focus();
+    }, []);
+    const onHandleKeyDown = useCallback((id, event) => {
+        if (disabled)
+            return;
+        const index = indexOf(id);
+        if (index < 0)
+            return;
+        const total = items.length;
+        const name = getLabel(items[index]);
+        const grabbed = grabbedId === id;
+        // Alt+arrow moves without grabbing — the VS Code / Notion convention an
+        // experienced operator will try first (Jakob's Law).
+        if (event.altKey && (event.key === 'ArrowUp' || event.key === 'ArrowDown')) {
+            event.preventDefault();
+            moveBy(id, event.key === 'ArrowUp' ? -1 : 1);
+            return;
+        }
+        switch (event.key) {
+            case ' ':
+            case 'Spacebar':
+            case 'Enter': {
+                event.preventDefault();
+                if (grabbed) {
+                    setGrabbedId(null);
+                    grabOriginRef.current = null;
+                    setAnnouncement(labels.dropped({ name, index: index + 1, total }));
+                }
+                else {
+                    setGrabbedId(id);
+                    grabOriginRef.current = index;
+                    setFocusedId(id);
+                    setAnnouncement(labels.grabbed({ name, index: index + 1, total }));
+                }
+                return;
+            }
+            case 'ArrowUp':
+            case 'ArrowDown': {
+                event.preventDefault();
+                const delta = event.key === 'ArrowUp' ? -1 : 1;
+                if (grabbed) {
+                    applyMove(id, index + delta, labels.moving);
+                    return;
+                }
+                const neighbour = ids[index + delta];
+                if (neighbour)
+                    focusHandle(neighbour);
+                return;
+            }
+            case 'Home':
+            case 'End': {
+                event.preventDefault();
+                const target = event.key === 'Home' ? ids[0] : ids[ids.length - 1];
+                if (!target)
+                    return;
+                if (grabbed) {
+                    applyMove(id, event.key === 'Home' ? 0 : total - 1, labels.moving);
+                    return;
+                }
+                focusHandle(target);
+                return;
+            }
+            case 'Escape': {
+                if (!grabbed)
+                    return;
+                event.preventDefault();
+                const origin = grabOriginRef.current;
+                setGrabbedId(null);
+                grabOriginRef.current = null;
+                if (origin === null || origin === index)
+                    return;
+                applyMove(id, origin, () => '');
+                setAnnouncement(labels.cancelled({ name, index: origin + 1, total }));
+                return;
+            }
+            default:
+        }
+    }, [
+        disabled,
+        indexOf,
+        items,
+        getLabel,
+        grabbedId,
+        ids,
+        labels,
+        moveBy,
+        applyMove,
+        focusHandle,
+    ]);
+    const onDragStart = useCallback((id) => {
+        if (disabled)
+            return;
+        setDraggingId(id);
+    }, [disabled]);
+    const onDrop = useCallback((overId) => {
+        if (disabled)
+            return;
+        const sourceId = draggingId;
+        setDraggingId(null);
+        setDropTargetId(null);
+        if (!sourceId || sourceId === overId)
+            return;
+        applyMove(sourceId, indexOf(overId), labels.moved);
+    }, [disabled, draggingId, applyMove, indexOf, labels.moved]);
+    const getItemProps = useCallback((item, index) => {
+        const id = getId(item);
+        return {
+            draggable: !disabled,
+            'aria-roledescription': labels.roleDescription ?? 'sortable item',
+            'aria-posinset': index + 1,
+            'aria-setsize': items.length,
+            onDragStart: () => onDragStart(id),
+            onDragOver: (event) => {
+                if (disabled)
+                    return;
+                // Without this the browser never fires `drop` at all.
+                event.preventDefault();
+                setDropTargetId(id);
+            },
+            onDragLeave: () => setDropTargetId((current) => (current === id ? null : current)),
+            onDrop: (event) => {
+                event.preventDefault();
+                onDrop(id);
+            },
+            onDragEnd: () => {
+                setDraggingId(null);
+                setDropTargetId(null);
+            },
+        };
+    }, [disabled, getId, items.length, labels.roleDescription, onDragStart, onDrop]);
+    const getHandleProps = useCallback((item, index) => {
+        const id = getId(item);
+        return {
+            ref: (element) => {
+                handlesRef.current.set(id, element);
+            },
+            type: 'button',
+            // Exactly one tab stop for the whole list: 23 rows × 5 controls would
+            // otherwise be ~115 stops between the search box and the inspector.
+            tabIndex: id === activeId ? 0 : -1,
+            'aria-label': labels.handle({
+                name: getLabel(item),
+                index: index + 1,
+                total: items.length,
+            }),
+            'aria-pressed': grabbedId === id,
+            'aria-describedby': options.instructionsId,
+            onKeyDown: (event) => onHandleKeyDown(id, event),
+            onFocus: () => setFocusedId(id),
+        };
+    }, [
+        getId,
+        getLabel,
+        items.length,
+        activeId,
+        grabbedId,
+        labels,
+        options.instructionsId,
+        onHandleKeyDown,
+    ]);
+    return {
+        announcement,
+        grabbedId,
+        draggingId,
+        dropTargetId,
+        activeId,
+        moveBy,
+        moveTo,
+        onHandleKeyDown,
+        onDragStart,
+        onDrop,
+        getItemProps,
+        getHandleProps,
+    };
+}
+/** Utility for callers that need the same move outside the hook's affordances. */
+export function moveItem(items, from, to) {
+    if (from < 0 || from >= items.length || to < 0 || to >= items.length || from === to) {
+        return items;
+    }
+    const next = [...items];
+    next.splice(from, 1);
+    next.splice(to, 0, items[from]);
+    return next;
+}
+//# sourceMappingURL=useReorderList.js.map

package/dist/components/reorder/useReorderList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReorderList.js","sourceRoot":"","sources":["../../../src/components/reorder/useReorderList.ts"],"names":[],"mappings":"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"}