@charcuterie/ui 3.0.0 → 3.1.0

package/dist/Board/BoardCard.js.map

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

package/dist/Board/BoardLaneList.d.ts

@@ -0,0 +1,103 @@
+import type { ReactNode } from "react";
+import type { BoardItem } from "./BoardCard.tsx";
+export type BoardLane = {
+    /**
+     * Lane-level controls, beside the count — Docket's *"Accept all"*
+     * on the review lane. `Button`s, usually.
+     */
+    actions?: ReactNode;
+    /**
+     * Shown instead of the rows when the lane is empty. Defaults to a
+     * real `EmptyState`, because *"Real empty states"* was a stated
+     * requirement and an empty lane is the one a person sees most.
+     */
+    emptyState?: ReactNode;
+    /**
+     * The **true** size of the lane, when `items` is a truncated page
+     * of it. This is what the count badge shows, and the difference
+     * between it and `items.length` is what the "+ n more" line says.
+     *
+     * Defaults to `items.length`, so a consumer that does not truncate
+     * says nothing about truncation.
+     */
+    itemCount?: number;
+    items: readonly BoardItem[];
+    key: string;
+    label: string;
+    /**
+     * What "+ n more in this lane" does. With no handler the line is
+     * still shown — the honest count matters more than the
+     * affordance — but it is text rather than a button.
+     */
+    onShowMore?: () => void;
+};
+export type BoardLaneListProps = {
+    /**
+     * Pixels from the top of the list box, or `null` for no
+     * indicator. Absolute rather than a real element between two
+     * cards: an indicator that takes up space moves the cards it is
+     * measured against, and the resulting feedback loop is why so many
+     * hand-rolled boards flicker.
+     */
+    dropIndicatorOffset: number | null;
+    /**
+     * The lane heading's level. The caller's, because only the caller
+     * knows what the board sits under — an `<h3>` directly below the
+     * page's `<h1>` is an axe `heading-order` failure, and a board is
+     * as likely to sit under a section heading as under the page
+     * title.
+     */
+    headingLevel: 2 | 3 | 4 | 5;
+    isVisibleWhenNarrow: boolean;
+    lane: BoardLane;
+    moveIcon?: ReactNode;
+    moveTargets: readonly {
+        key: string;
+        label: string;
+    }[];
+    onMoveToLane?: (itemKey: string, toLaneKey: string) => void;
+    onStartDrag?: (pointerEvent: {
+        clientX: number;
+        clientY: number;
+        currentTarget: EventTarget & Element;
+        pointerId: number;
+    }, origin: {
+        fromIndex: number;
+        itemKey: string;
+    }) => void;
+    registerListElement: (element: HTMLElement | null) => void;
+};
+/**
+ * One lane: a named heading, an honest count, its rows, and what it
+ * says when there are none.
+ *
+ * ### The lane is the container, and that is the whole design
+ *
+ * `@container` sits on a wrapper inside this section, so everything
+ * below it — the panel, its rows — is sized by **the lane**. Three
+ * lanes in a 1600px window are ~500px each; one lane in the Narrow
+ * View is ~360px; the same lane in a docked sidebar is 280px. All
+ * three happen on the same monitor, and no media query can tell
+ * them apart.
+ *
+ * The wrapper is a wrapper because a container query matches
+ * **descendants only**. Declaring `@container` on the panel itself
+ * would compile, generate real CSS, and silently never fire — so
+ * the panel could never take its own frame off at `cq-lg`, which is
+ * the one thing the widest layout asks for.
+ *
+ * This `<section>` is outside all of that: it carries the
+ * hidden/shown classes, and those resolve against the **board's**
+ * container, one level up.
+ *
+ * ### Long lanes truncate; they do not scroll
+ *
+ * *"Long lanes truncate with an honest `+ n more` rather than
+ * scrolling forever."* So the lane never grows a scrollbar and never
+ * virtualises. `itemCount` is the real total and `items` is whatever
+ * the consumer chose to render — which keeps paging, sorting and any
+ * windowing on the side that owns the data, and keeps this component
+ * from pretending to know how many rows are worth painting.
+ */
+export declare const BoardLaneList: ({ dropIndicatorOffset, headingLevel, isVisibleWhenNarrow, lane, moveIcon, moveTargets, onMoveToLane, onStartDrag, registerListElement, }: BoardLaneListProps) => ReactNode;
+//# sourceMappingURL=BoardLaneList.d.ts.map

package/dist/Board/BoardLaneList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoardLaneList.d.ts","sourceRoot":"","sources":["../../src/Board/BoardLaneList.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,MAAM,MAAM,SAAS,GAAG;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;OAMG;IACH,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC;;;;;;OAMG;IACH,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACtD,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,KACd,IAAI,CAAA;IACT,WAAW,CAAC,EAAE,CACZ,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,aAAa,EAAE,WAAW,GAAG,OAAO,CAAA;QACpC,SAAS,EAAE,MAAM,CAAA;KAClB,EACD,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAC3C,IAAI,CAAA;IACT,mBAAmB,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CAC3D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,aAAa,GAAI,0IAU3B,kBAAkB,KAAG,SAyJvB,CAAA"}

package/dist/Board/BoardLaneList.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useUniqueId } from "@charcuterie/logic";
+import { Badge } from "../Badge/Badge.js";
+import { Button } from "../Button/Button.js";
+import { EmptyState } from "../EmptyState/EmptyState.js";
+import { toClassName } from "../toClassName.js";
+import { BoardCard } from "./BoardCard.js";
+/**
+ * One lane: a named heading, an honest count, its rows, and what it
+ * says when there are none.
+ *
+ * ### The lane is the container, and that is the whole design
+ *
+ * `@container` sits on a wrapper inside this section, so everything
+ * below it — the panel, its rows — is sized by **the lane**. Three
+ * lanes in a 1600px window are ~500px each; one lane in the Narrow
+ * View is ~360px; the same lane in a docked sidebar is 280px. All
+ * three happen on the same monitor, and no media query can tell
+ * them apart.
+ *
+ * The wrapper is a wrapper because a container query matches
+ * **descendants only**. Declaring `@container` on the panel itself
+ * would compile, generate real CSS, and silently never fire — so
+ * the panel could never take its own frame off at `cq-lg`, which is
+ * the one thing the widest layout asks for.
+ *
+ * This `<section>` is outside all of that: it carries the
+ * hidden/shown classes, and those resolve against the **board's**
+ * container, one level up.
+ *
+ * ### Long lanes truncate; they do not scroll
+ *
+ * *"Long lanes truncate with an honest `+ n more` rather than
+ * scrolling forever."* So the lane never grows a scrollbar and never
+ * virtualises. `itemCount` is the real total and `items` is whatever
+ * the consumer chose to render — which keeps paging, sorting and any
+ * windowing on the side that owns the data, and keeps this component
+ * from pretending to know how many rows are worth painting.
+ */
+export const BoardLaneList = ({ dropIndicatorOffset, headingLevel, isVisibleWhenNarrow, lane, moveIcon, moveTargets, onMoveToLane, onStartDrag, registerListElement, }) => {
+    const headingId = useUniqueId();
+    const itemCount = lane.itemCount ?? lane.items.length;
+    const hiddenCount = itemCount - lane.items.length;
+    const Heading = `h${headingLevel}`;
+    return (_jsx("div", { "aria-labelledby": headingId, role: "group", className: toClassName("min-w-0 flex-1 flex-col gap-2", 
+        // Below the board's own `cq-lg`, one lane is on screen and
+        // the rest are chosen with the segmented control above. This
+        // queries the **board**, not the list below — an element
+        // carrying `container-type` still resolves its own container
+        // queries against its nearest ancestor container.
+        isVisibleWhenNarrow ? "flex" : "hidden cq-lg:flex"), children: _jsx("div", { className: "@container", children: _jsxs("div", { className: "flex flex-col gap-2 rounded-lg border border-border-subtle bg-surface-raised px-3 py-2 cq-lg:border-0 cq-lg:bg-transparent cq-lg:p-0", children: [_jsxs("header", { className: "flex items-center gap-2", children: [_jsx(Heading, { className: "font-semibold text-content-primary text-sm", id: headingId, children: lane.label }), _jsx(Badge, { appearance: "soft", intent: "neutral", size: "sm", children: String(itemCount) }), _jsx("span", { className: "flex-1" }), lane.actions] }), _jsxs("ul", { className: "relative flex flex-col", ref: registerListElement, children: [lane.items.length === 0 ? (_jsx("li", { children: lane.emptyState ?? (_jsx(EmptyState, { description: "Nothing is waiting here.", heading: "Nothing here", headingLevel: 
+                                    // One below the lane's own, so the outline
+                                    // stays whole wherever the board is mounted.
+                                    (headingLevel + 1), size: "sm" })) })) : (lane.items.map((item, index) => (_jsx(BoardCard, { item: item, laneLabel: lane.label, moveIcon: moveIcon, moveTargets: moveTargets, onMoveToLane: onMoveToLane
+                                    ? (toLaneKey) => {
+                                        onMoveToLane(item.key, toLaneKey);
+                                    }
+                                    : undefined, onStartDrag: onStartDrag
+                                    ? (pointerEvent) => {
+                                        onStartDrag(pointerEvent, {
+                                            fromIndex: index,
+                                            itemKey: item.key,
+                                        });
+                                    }
+                                    : undefined }, item.key)))), dropIndicatorOffset === null ? null : (_jsx("li", { "aria-hidden": "true", className: "pointer-events-none absolute end-0 start-0 h-0.5 rounded-full bg-intent-accent-solid", style: {
+                                    insetBlockStart: `${dropIndicatorOffset}px`,
+                                } }))] }), hiddenCount > 0 ? (_jsx("p", { className: "text-content-muted text-xs", children: lane.onShowMore ? (_jsx(Button, { appearance: "ghost", intent: "neutral", onClick: lane.onShowMore, size: "sm", children: `+ ${hiddenCount} more in ${lane.label}` })) : (`+ ${hiddenCount} more in ${lane.label}`) })) : null] }) }) }));
+};
+//# sourceMappingURL=BoardLaneList.js.map

package/dist/Board/BoardLaneList.js.map

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

package/dist/Board/boardMove.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Everything about a board move that is arithmetic rather than
+ * React — so it can be tested in Node, exhaustively, without a
+ * browser and without a pointer.
+ *
+ * That split is not tidiness. The pointer path is the one part of
+ * this component a test cannot drive convincingly: `userEvent` can
+ * dispatch `pointermove`, but it cannot lay anything out, so every
+ * rectangle it would reason about is `0x0` in a test environment
+ * that has not painted. Pulling the geometry out means the *rule* —
+ * which lane, which index, what happens on a tie — is red/green in
+ * Node, and the browser test is left proving only the wiring.
+ */
+/**
+ * A lane as the drop calculation sees it: a box, a key, and the
+ * boxes of the cards inside it.
+ *
+ * Deliberately plain data rather than elements. `chooseDropTarget`
+ * never touches the DOM, which is why it can be called with
+ * fixtures.
+ */
+export type BoardDropLane = {
+    cardRects: readonly BoardRect[];
+    key: string;
+    rect: BoardRect;
+};
+export type BoardPoint = {
+    x: number;
+    y: number;
+};
+/**
+ * The subset of `DOMRect` this needs. Named rather than reusing
+ * `DOMRect`, because `DOMRect` is a browser global and this module
+ * is imported by the Node test project.
+ */
+export type BoardRect = {
+    height: number;
+    left: number;
+    top: number;
+    width: number;
+};
+export type BoardDropTarget = {
+    index: number;
+    laneKey: string;
+};
+/**
+ * Where in a lane a point lands: the number of cards whose midpoint
+ * is above it.
+ *
+ * Midpoints rather than edges, so the insertion flips when the
+ * pointer passes the *centre* of a card. Against edges, the top
+ * half of every card is a dead zone that means "same place you
+ * already were", and the indicator stutters.
+ */
+export declare const chooseDropIndex: (cardRects: readonly BoardRect[], point: BoardPoint) => number;
+/**
+ * The lane and index a pointer is currently over.
+ *
+ * Hit test first, nearest-lane second, and `null` only when there
+ * are no lanes at all — a drag that started has to end somewhere.
+ */
+export declare const chooseDropTarget: (lanes: readonly BoardDropLane[], point: BoardPoint) => BoardDropTarget | null;
+/**
+ * Whether a move would actually change anything.
+ *
+ * The subtle half is `toIndex`. Taking a card out of its own lane
+ * shifts every card below it up by one, so "drop it back where it
+ * was" arrives as both `fromIndex` and `fromIndex + 1` depending on
+ * which side of its own midpoint the pointer ended on. Both are
+ * no-ops, and a board that fires `onMove` for them makes a consumer
+ * re-render — and, if the consumer is optimistic, flash — for a
+ * drag that went nowhere.
+ */
+export declare const getIsMoveMeaningful: ({ fromIndex, fromLaneKey, toIndex, toLaneKey, }: {
+    fromIndex: number;
+    fromLaneKey: string;
+    toIndex: number;
+    toLaneKey: string;
+}) => boolean;
+/**
+ * Where a card ends up once it has been removed from its old
+ * position.
+ *
+ * A within-lane move is quoted against the list *including* the
+ * card being moved — that is what the pointer was over — but a
+ * consumer splicing an array removes it first, so every index below
+ * the origin is one too high. Folding that here means the consumer's
+ * handler is `splice(from, 1)` then `splice(to, 0, item)` with no
+ * arithmetic of its own, which is the version nobody gets wrong.
+ */
+export declare const toSettledIndex: ({ fromIndex, fromLaneKey, toIndex, toLaneKey, }: {
+    fromIndex: number;
+    fromLaneKey: string;
+    toIndex: number;
+    toLaneKey: string;
+}) => number;
+/**
+ * What the live region says after a move.
+ *
+ * A sentence rather than a status word, and it names the
+ * **destination position** as well as the lane, because "moved to In
+ * Progress" leaves a screen-reader user with no idea whether the
+ * card went to the top of the lane or the bottom of thirty. That is
+ * the single piece of feedback a sighted user gets for free from
+ * watching the card land, and it is the one every drag-and-drop
+ * implementation forgets to say out loud.
+ *
+ * One-based, because it is read to a person.
+ */
+export declare const describeMove: ({ index, laneLabel, laneSize, title, }: {
+    index: number;
+    laneLabel: string;
+    laneSize: number;
+    title: string;
+}) => string;
+//# sourceMappingURL=boardMove.d.ts.map

package/dist/Board/boardMove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boardMove.d.ts","sourceRoot":"","sources":["../../src/Board/boardMove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,SAAS,SAAS,EAAE,CAAA;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,SAAS,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAmDD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,SAAS,SAAS,EAAE,EAC/B,OAAO,UAAU,KAChB,MAGO,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,SAAS,aAAa,EAAE,EAC/B,OAAO,UAAU,KAChB,eAAe,GAAG,IAsBpB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAAI,iDAKjC;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,KAAG,OAEkD,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,iDAK5B;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,KAAG,MAGS,CAAA;AAEb;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,wCAK1B;IACD,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd,KAAG,MACqE,CAAA"}

package/dist/Board/boardMove.js

@@ -0,0 +1,116 @@
+/**
+ * Everything about a board move that is arithmetic rather than
+ * React — so it can be tested in Node, exhaustively, without a
+ * browser and without a pointer.
+ *
+ * That split is not tidiness. The pointer path is the one part of
+ * this component a test cannot drive convincingly: `userEvent` can
+ * dispatch `pointermove`, but it cannot lay anything out, so every
+ * rectangle it would reason about is `0x0` in a test environment
+ * that has not painted. Pulling the geometry out means the *rule* —
+ * which lane, which index, what happens on a tie — is red/green in
+ * Node, and the browser test is left proving only the wiring.
+ */
+/**
+ * `left`/`top` rather than `insetInlineStart`, and that is not a
+ * violation of the logical-properties rule.
+ *
+ * The rule is scoped to `className` literals, because a Tailwind
+ * utility is a *style* and a style has a writing direction.
+ * `getBoundingClientRect()` returns physical pixels in the
+ * viewport's own coordinate space; there is no logical version of it
+ * to prefer, and inventing one here would mean re-deriving a number
+ * the browser already gave us. The lint rule carves this out
+ * explicitly.
+ */
+const getIsPointInside = (rect, point) => point.x >= rect.left &&
+    point.x <= rect.left + rect.width &&
+    point.y >= rect.top &&
+    point.y <= rect.top + rect.height;
+/**
+ * How far a point is from a rectangle, zero when it is inside.
+ *
+ * Used only as a fallback, and the fallback is the reason a drag
+ * feels finished rather than cancelled: a pointer released two
+ * pixels past a lane's edge is a drop *on that lane* as far as the
+ * person doing it is concerned, and returning `null` there is how a
+ * board earns "it just puts the card back sometimes".
+ */
+const getDistanceToRect = (rect, point) => {
+    const dx = Math.max(rect.left - point.x, 0, point.x - (rect.left + rect.width));
+    const dy = Math.max(rect.top - point.y, 0, point.y - (rect.top + rect.height));
+    return Math.sqrt(dx * dx + dy * dy);
+};
+/**
+ * Where in a lane a point lands: the number of cards whose midpoint
+ * is above it.
+ *
+ * Midpoints rather than edges, so the insertion flips when the
+ * pointer passes the *centre* of a card. Against edges, the top
+ * half of every card is a dead zone that means "same place you
+ * already were", and the indicator stutters.
+ */
+export const chooseDropIndex = (cardRects, point) => cardRects.filter((rect) => point.y > rect.top + rect.height / 2).length;
+/**
+ * The lane and index a pointer is currently over.
+ *
+ * Hit test first, nearest-lane second, and `null` only when there
+ * are no lanes at all — a drag that started has to end somewhere.
+ */
+export const chooseDropTarget = (lanes, point) => {
+    if (lanes.length === 0) {
+        return null;
+    }
+    const hitLane = lanes.find((lane) => getIsPointInside(lane.rect, point));
+    const lane = hitLane ??
+        lanes.reduce((nearest, candidate) => getDistanceToRect(candidate.rect, point) <
+            getDistanceToRect(nearest.rect, point)
+            ? candidate
+            : nearest);
+    return {
+        index: chooseDropIndex(lane.cardRects, point),
+        laneKey: lane.key,
+    };
+};
+/**
+ * Whether a move would actually change anything.
+ *
+ * The subtle half is `toIndex`. Taking a card out of its own lane
+ * shifts every card below it up by one, so "drop it back where it
+ * was" arrives as both `fromIndex` and `fromIndex + 1` depending on
+ * which side of its own midpoint the pointer ended on. Both are
+ * no-ops, and a board that fires `onMove` for them makes a consumer
+ * re-render — and, if the consumer is optimistic, flash — for a
+ * drag that went nowhere.
+ */
+export const getIsMoveMeaningful = ({ fromIndex, fromLaneKey, toIndex, toLaneKey, }) => fromLaneKey !== toLaneKey ||
+    (toIndex !== fromIndex && toIndex !== fromIndex + 1);
+/**
+ * Where a card ends up once it has been removed from its old
+ * position.
+ *
+ * A within-lane move is quoted against the list *including* the
+ * card being moved — that is what the pointer was over — but a
+ * consumer splicing an array removes it first, so every index below
+ * the origin is one too high. Folding that here means the consumer's
+ * handler is `splice(from, 1)` then `splice(to, 0, item)` with no
+ * arithmetic of its own, which is the version nobody gets wrong.
+ */
+export const toSettledIndex = ({ fromIndex, fromLaneKey, toIndex, toLaneKey, }) => fromLaneKey === toLaneKey && toIndex > fromIndex
+    ? toIndex - 1
+    : toIndex;
+/**
+ * What the live region says after a move.
+ *
+ * A sentence rather than a status word, and it names the
+ * **destination position** as well as the lane, because "moved to In
+ * Progress" leaves a screen-reader user with no idea whether the
+ * card went to the top of the lane or the bottom of thirty. That is
+ * the single piece of feedback a sighted user gets for free from
+ * watching the card land, and it is the one every drag-and-drop
+ * implementation forgets to say out loud.
+ *
+ * One-based, because it is read to a person.
+ */
+export const describeMove = ({ index, laneLabel, laneSize, title, }) => `Moved ${title} to ${laneLabel}, position ${index + 1} of ${laneSize}.`;
+//# sourceMappingURL=boardMove.js.map

package/dist/Board/boardMove.js.map

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

package/dist/Board/useBoardDrag.d.ts

@@ -0,0 +1,44 @@
+import type { BoardDropLane, BoardDropTarget } from "./boardMove.ts";
+export type BoardDragOrigin = {
+    fromIndex: number;
+    fromLaneKey: string;
+    itemKey: string;
+};
+export type BoardDragState = BoardDragOrigin & {
+    /**
+     * Where the indicator is drawn, in pixels from the top of the
+     * target lane's list box. `null` while the pointer is over no
+     * lane the snapshot knows about.
+     */
+    indicatorOffset: number | null;
+    target: BoardDropTarget | null;
+};
+type LaneSnapshot = BoardDropLane & {
+    gap: number;
+    listTop: number;
+};
+/**
+ * Where the line goes for a given insertion index — the midpoint of
+ * the gap the card would be dropped into, in the list's own
+ * coordinates.
+ *
+ * Split out and exported because it is the one piece of this file
+ * that is pure arithmetic over the snapshot, and the three cases
+ * (before everything, between two, after everything) are exactly
+ * where an off-by-one lives.
+ */
+export declare const getIndicatorOffset: (lane: LaneSnapshot, index: number) => number;
+export declare const useBoardDrag: ({ onDrop, }: {
+    onDrop: (origin: BoardDragOrigin, target: BoardDropTarget) => void;
+}) => {
+    drag: BoardDragState | null;
+    registerLane: (laneKey: string) => (element: HTMLElement | null) => void;
+    startDrag: (pointerEvent: {
+        clientX: number;
+        clientY: number;
+        currentTarget: EventTarget & Element;
+        pointerId: number;
+    }, origin: BoardDragOrigin) => void;
+};
+export {};
+//# sourceMappingURL=useBoardDrag.d.ts.map

package/dist/Board/useBoardDrag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoardDrag.d.ts","sourceRoot":"","sources":["../../src/Board/useBoardDrag.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAEhB,MAAM,gBAAgB,CAAA;AAwDvB,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG;IAC7C;;;;OAIG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,KAAK,YAAY,GAAG,aAAa,GAAG;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAaD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,YAAY,EAClB,OAAO,MAAM,KACZ,MA2BF,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,aAE1B;IACD,MAAM,EAAE,CACN,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,KACpB,IAAI,CAAA;CACV,KAAG;IACF,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;IAC3B,YAAY,EAAE,CACZ,OAAO,EAAE,MAAM,KACZ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IAC1C,SAAS,EAAE,CACT,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,aAAa,EAAE,WAAW,GAAG,OAAO,CAAA;QACpC,SAAS,EAAE,MAAM,CAAA;KAClB,EACD,MAAM,EAAE,eAAe,KACpB,IAAI,CAAA;CA2PV,CAAA"}