@adminiumjs/widgets 0.1.0-rc.1

package/dist/binding/useWidgetStream.js

@@ -0,0 +1,144 @@
+/**
+ * `useWidgetStream` — the client half of the `stream` binding (04-widget-registry.md
+ * §5.3). A stream widget (realtime-feed, live log-table tail, unread-badge)
+ * calls this with the server-returned `channel` + `snapshot` (bound mode) or a
+ * demo seed (unbound/preview mode); it subscribes over the injected
+ * {@link StreamTransport}, folds events into a bounded newest-first buffer, and
+ * exposes the buffer, an unread counter, a connection flag, pause/resume, and an
+ * optimistic `prepend`.
+ *
+ * Transport is injected via {@link StreamTransportProvider} (bound mode) or
+ * built in-hook from the deterministic demo generator (unbound mode). The hook
+ * itself is transport-agnostic, so it is fully unit-testable with a mock
+ * transport — no socket, no server.
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { DEMO_STREAM_CHANNEL, createDemoStreamTransport } from './demo-stream.js';
+import { DEFAULT_STREAM_MAX, markStreamRead, removeStreamItem, seedStreamBuffer, upsertStreamItem, } from './stream-buffer.js';
+import { useStreamTransport } from './StreamTransportContext.js';
+function defaultSelectItem(payload) {
+    return payload.row !== null && payload.row !== undefined && typeof payload.row === 'object'
+        ? payload.row
+        : null;
+}
+function defaultIsRemoval(payload) {
+    return typeof payload.type === 'string' && payload.type.endsWith('delete');
+}
+export function useWidgetStream(options) {
+    const isDemo = options.channel === undefined && options.demo !== undefined;
+    const channel = options.channel ?? (isDemo ? DEMO_STREAM_CHANNEL : undefined);
+    const contextTransport = useStreamTransport();
+    const demoSeed = options.demo?.seed;
+    const demoInterval = options.demo?.intervalMs;
+    const demoTransport = useMemo(() => (demoSeed !== undefined ? createDemoStreamTransport({ seed: demoSeed, intervalMs: demoInterval }) : null), [demoSeed, demoInterval]);
+    const transport = options.transport ?? (isDemo ? demoTransport : contextTransport);
+    const max = options.max ?? DEFAULT_STREAM_MAX;
+    // --- latest-value refs so the transport callback stays stable --------------
+    const getKeyRef = useRef(options.getKey);
+    getKeyRef.current = options.getKey;
+    const selectItemRef = useRef(options.selectItem ?? (defaultSelectItem));
+    selectItemRef.current = options.selectItem ?? (defaultSelectItem);
+    const isRemovalRef = useRef(options.isRemoval ?? defaultIsRemoval);
+    isRemovalRef.current = options.isRemoval ?? defaultIsRemoval;
+    const maxRef = useRef(max);
+    maxRef.current = max;
+    const [buffer, setBuffer] = useState(() => seedStreamBuffer(options.snapshot ?? [], max));
+    const [connected, setConnected] = useState(false);
+    const [internalPaused, setInternalPaused] = useState(false);
+    const [pendingCount, setPendingCount] = useState(0);
+    const pendingRef = useRef([]);
+    const paused = options.paused ?? internalPaused;
+    const pausedRef = useRef(paused);
+    pausedRef.current = paused;
+    const onPausedChangeRef = useRef(options.onPausedChange);
+    onPausedChangeRef.current = options.onPausedChange;
+    const controlledPaused = options.paused !== undefined;
+    // --- re-seed when the binding (channel) changes ----------------------------
+    const snapshotRef = useRef(options.snapshot);
+    snapshotRef.current = options.snapshot;
+    // Re-seed only on a new binding (channel); the live stream fills subsequent
+    // updates. `snapshot`/`max` are read from refs so a new array identity does
+    // not thrash the buffer.
+    useEffect(() => {
+        setBuffer(seedStreamBuffer(snapshotRef.current ?? [], maxRef.current));
+        pendingRef.current = [];
+        setPendingCount(0);
+    }, [channel]);
+    // --- event application (reads latest values via refs) ----------------------
+    const handleEvent = useRef((event) => {
+        const payload = (event.data ?? {});
+        const item = selectItemRef.current(payload, event);
+        if (isRemovalRef.current(payload)) {
+            if (item === null)
+                return;
+            const key = getKeyRef.current(item);
+            // While paused the feed is frozen — hold the removal too (not just
+            // upserts) so a concurrent delete does not splice a visible row out.
+            if (pausedRef.current) {
+                pendingRef.current = [...pendingRef.current, { kind: 'remove', key }];
+                return;
+            }
+            setBuffer((prev) => removeStreamItem(prev, key, getKeyRef.current));
+            return;
+        }
+        if (item === null)
+            return;
+        if (pausedRef.current) {
+            pendingRef.current = [...pendingRef.current, { kind: 'upsert', item }];
+            setPendingCount((count) => count + 1);
+            return;
+        }
+        setBuffer((prev) => upsertStreamItem(prev, item, { getKey: getKeyRef.current, max: maxRef.current, countUnread: true }));
+    });
+    // --- subscribe / unsubscribe on transport or channel change ----------------
+    useEffect(() => {
+        if (transport === null || transport === undefined || channel === undefined) {
+            setConnected(false);
+            return;
+        }
+        const unsubscribe = transport.subscribe(channel, (event) => handleEvent.current(event), (status) => setConnected(status));
+        return () => {
+            unsubscribe();
+            setConnected(false);
+        };
+    }, [transport, channel]);
+    // --- flush paused-held ops (upserts + removals) on resume, in order --------
+    useEffect(() => {
+        if (paused || pendingRef.current.length === 0)
+            return;
+        const flush = pendingRef.current;
+        pendingRef.current = [];
+        setPendingCount(0);
+        setBuffer((prev) => {
+            let next = prev;
+            for (const op of flush) {
+                next =
+                    op.kind === 'upsert'
+                        ? upsertStreamItem(next, op.item, { getKey: getKeyRef.current, max: maxRef.current, countUnread: true })
+                        : removeStreamItem(next, op.key, getKeyRef.current);
+            }
+            return next;
+        });
+    }, [paused]);
+    const setPaused = useCallback((next) => {
+        if (!controlledPaused)
+            setInternalPaused(next);
+        onPausedChangeRef.current?.(next);
+    }, [controlledPaused]);
+    const markRead = useCallback(() => {
+        setBuffer((prev) => markStreamRead(prev));
+    }, []);
+    const prepend = useCallback((item) => {
+        setBuffer((prev) => upsertStreamItem(prev, item, { getKey: getKeyRef.current, max: maxRef.current, countUnread: false }));
+    }, []);
+    return {
+        items: buffer.items,
+        unread: buffer.unread + pendingCount,
+        connected,
+        paused,
+        setPaused,
+        markRead,
+        prepend,
+    };
+}
+//# sourceMappingURL=useWidgetStream.js.map

package/dist/binding/useWidgetStream.js.map

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

package/dist/families/boards/BoardCard.d.ts

@@ -0,0 +1,48 @@
+import type { Tone } from '@adminium/ui';
+import { boardCardConfigSchema, boardCardDemoData } from './boards-config.js';
+import type { BoardCardConfig } from './boards-config.js';
+import type { BoardCardData } from './board-lib.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { boardCardConfigSchema, boardCardDemoData };
+export type { BoardCardConfig };
+/**
+ * `board-card` presentational body (annex §6) — the draggable card's contents:
+ * a tone/lane-tinted tag pill, a grip affordance, the bold title, optional
+ * client/points/priority rows, a percent label + column-toned progress bar, a
+ * gradient-initials owner avatar, a due chip, and the mono card id. Purely
+ * presentational: dragging/keyboard live in the shell (`DraggableCard`), so this
+ * renders identically in a story, a test, or under a live DndContext.
+ *
+ * It is ALSO a registry widget in its own right (`BoardCardWidget` below): the
+ * annex gives `board-card` its own id, and the surfaces that show exactly one
+ * card against a single `record` — a linked card in a timeline, the builder
+ * palette's preview — instantiate it directly. Same component either way, so a
+ * card is pixel-identical wherever it appears.
+ */
+export interface BoardCardProps {
+    card: BoardCardData;
+    /** Progress-bar + accent tone, normally the card's column tone. */
+    columnTone?: Tone | undefined;
+    locale?: string | undefined;
+    /** Label for the drag grip (localized at the host boundary). */
+    gripLabel?: string | undefined;
+    pointsUnit?: string | undefined;
+    /**
+     * Show the drag grip. True inside a board (the card IS draggable); false for a
+     * standalone `board-card` instance, where a grip would advertise an affordance
+     * that does nothing.
+     */
+    showGrip?: boolean | undefined;
+}
+export declare function BoardCard({ card, columnTone, locale, gripLabel, pointsUnit, showGrip, }: BoardCardProps): import("react").JSX.Element;
+/**
+ * Project a single `record` payload onto a `BoardCardData`, honouring the
+ * config's visible-field allow-list. Hiding a field DROPS it from the data
+ * rather than adding a render flag per slot: `BoardCard` already renders each
+ * slot only when its value is defined, so the allow-list and the "no value"
+ * case collapse to one code path — and the presentational component stays
+ * exactly what the kanban columns render.
+ */
+export declare function boardCardOf(data: unknown, config: BoardCardConfig): BoardCardData | null;
+export declare function BoardCardWidget({ config, data, onEvent }: WidgetProps<BoardCardConfig>): import("react").JSX.Element;
+//# sourceMappingURL=BoardCard.d.ts.map

package/dist/families/boards/BoardCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoardCard.d.ts","sourceRoot":"","sources":["../../../src/families/boards/BoardCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,mEAAmE;IACnE,UAAU,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,UAAqB,EACrB,MAAM,EACN,SAAS,EACT,UAAU,EACV,QAAe,GAChB,EAAE,cAAc,+BAkEhB;AAKD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,IAAI,CAuBxF;AAED,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,eAAe,CAAC,+BAkCtF"}

package/dist/families/boards/BoardCard.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Avatar, EmptyState, MonoText, ProgressBar, Tag } from '@adminium/ui';
+import { GripVertical } from 'lucide-react';
+import { boardCardConfigSchema, boardCardDemoData } from './boards-config.js';
+import { boardToneOf, ownerInitials, priorityTone, toBoardCard } from './board-lib.js';
+export { boardCardConfigSchema, boardCardDemoData };
+export function BoardCard({ card, columnTone = 'accent', locale, gripLabel, pointsUnit, showGrip = true, }) {
+    const initials = ownerInitials(card.owner, locale);
+    const hasPct = typeof card.pct === 'number';
+    return (_jsxs("div", { className: "flex flex-col gap-2 rounded-lg border border-border bg-surface-1 p-3 shadow-sm", children: [_jsxs("div", { className: "flex items-start gap-2", children: [card.tag !== undefined && (_jsx(Tag, { tone: boardToneOf(card.tagTone, columnTone), children: card.tag })), card.priority !== undefined && (_jsx(Tag, { tone: priorityTone(card.priority), className: "uppercase", children: card.priority })), card.points !== undefined && (_jsxs(MonoText, { className: "ms-auto text-caption font-semibold text-fg-muted", children: [card.points, pointsUnit === undefined ? '' : ` ${pointsUnit}`] })), showGrip && (_jsx("span", { "aria-hidden": "true", "data-part": "board-card-grip", title: gripLabel, className: (card.points === undefined ? 'ms-auto ' : '') +
+                            'shrink-0 cursor-grab text-fg-subtle', children: _jsx(GripVertical, { className: "size-4" }) }))] }), _jsx("p", { className: "text-body-sm font-semibold leading-snug text-fg", children: card.title }), (card.client !== undefined || card.budget !== undefined) && (_jsxs("div", { className: "flex items-center justify-between gap-2 text-caption text-fg-muted", children: [card.client !== undefined && _jsx("span", { className: "truncate", children: card.client }), card.budget !== undefined && _jsx(MonoText, { className: "shrink-0", children: card.budget })] })), hasPct && (_jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("div", { className: "flex items-center justify-end text-caption text-fg-muted", children: _jsx(MonoText, { className: "font-semibold text-fg", children: `${Math.round(card.pct ?? 0)}%` }) }), _jsx(ProgressBar, { value: card.pct ?? 0, tone: columnTone, animated: false, label: card.title })] })), _jsxs("div", { className: "flex items-center justify-between gap-2 pt-0.5", children: [_jsxs("div", { className: "flex items-center gap-2", children: [initials !== undefined && (_jsx(Avatar, { size: "xs", name: card.owner ?? '', ...(locale === undefined ? {} : { locale }) })), card.due !== undefined && (_jsx(MonoText, { className: "rounded-sm bg-surface-3 px-1.5 py-0.5 text-[10px] text-fg-muted", children: card.due }))] }), _jsx(MonoText, { className: "text-[10px] text-fg-subtle", children: card.id })] })] }));
+}
+/**
+ * Project a single `record` payload onto a `BoardCardData`, honouring the
+ * config's visible-field allow-list. Hiding a field DROPS it from the data
+ * rather than adding a render flag per slot: `BoardCard` already renders each
+ * slot only when its value is defined, so the allow-list and the "no value"
+ * case collapse to one code path — and the presentational component stays
+ * exactly what the kanban columns render.
+ */
+export function boardCardOf(data, config) {
+    const row = (typeof data === 'object' && data !== null ? data.row ?? data.data : undefined);
+    if (typeof row !== 'object' || row === null || Array.isArray(row))
+        return null;
+    const card = toBoardCard(row, 0, {
+        columnField: 'status',
+        titleField: config.titleField,
+    });
+    const fields = config.fields;
+    if (fields === undefined)
+        return card;
+    const visible = new Set(fields);
+    const keep = (field, value) => (visible.has(field) ? value : undefined);
+    return {
+        ...card,
+        id: visible.has('id') ? card.id : '',
+        tag: keep('tag', card.tag),
+        priority: keep('priority', card.priority),
+        points: keep('points', card.points),
+        client: keep('client', card.client),
+        budget: keep('budget', card.budget),
+        pct: keep('pct', card.pct),
+        owner: keep('owner', card.owner),
+        due: keep('due', card.due),
+    };
+}
+export function BoardCardWidget({ config, data, onEvent }) {
+    const card = boardCardOf(data, config);
+    if (card === null) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: config.emptyState?.titleKey ?? 'No card', body: config.emptyState?.bodyKey ?? 'This card has no record bound to it yet.' }));
+    }
+    const href = config.linkTarget ?? config.href;
+    const body = (_jsx(BoardCard, { card: card, showGrip: false, columnTone: boardToneOf(config.columnTone, 'accent'), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.gripLabel === undefined ? {} : { gripLabel: config.gripLabel }), ...(config.pointsUnit === undefined ? {} : { pointsUnit: config.pointsUnit }) }));
+    if (href === undefined)
+        return _jsx("div", { "data-widget": "board-card", children: body });
+    return (_jsx("button", { type: "button", "data-widget": "board-card", onClick: () => onEvent({ type: 'drill-through', href }), className: "block w-full text-start focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: body }));
+}
+//# sourceMappingURL=BoardCard.js.map

package/dist/families/boards/BoardCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoardCard.js","sourceRoot":"","sources":["../../../src/families/boards/BoardCard.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKvF,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC;AAkCpD,MAAM,UAAU,SAAS,CAAC,EACxB,IAAI,EACJ,UAAU,GAAG,QAAQ,EACrB,MAAM,EACN,SAAS,EACT,UAAU,EACV,QAAQ,GAAG,IAAI,GACA;IACf,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC;IAC5C,OAAO,CACL,eAAK,SAAS,EAAC,gFAAgF,aAC7F,eAAK,SAAS,EAAC,wBAAwB,aACpC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,CACzB,KAAC,GAAG,IAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,YAAG,IAAI,CAAC,GAAG,GAAO,CACnE,EACA,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAC9B,KAAC,GAAG,IAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAC,WAAW,YAC1D,IAAI,CAAC,QAAQ,GACV,CACP,EACA,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAC5B,MAAC,QAAQ,IAAC,SAAS,EAAC,kDAAkD,aACnE,IAAI,CAAC,MAAM,EACX,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,IACxC,CACZ,EACA,QAAQ,IAAI,CACX,8BACc,MAAM,eACR,iBAAiB,EAC3B,KAAK,EAAE,SAAS,EAChB,SAAS,EACP,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;4BAC7C,qCAAqC,YAGvC,KAAC,YAAY,IAAC,SAAS,EAAC,QAAQ,GAAG,GAC9B,CACR,IACG,EAEN,YAAG,SAAS,EAAC,iDAAiD,YAAE,IAAI,CAAC,KAAK,GAAK,EAE9E,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,IAAI,CAC3D,eAAK,SAAS,EAAC,oEAAoE,aAChF,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,eAAM,SAAS,EAAC,UAAU,YAAE,IAAI,CAAC,MAAM,GAAQ,EAC5E,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,KAAC,QAAQ,IAAC,SAAS,EAAC,UAAU,YAAE,IAAI,CAAC,MAAM,GAAY,IACjF,CACP,EAEA,MAAM,IAAI,CACT,eAAK,SAAS,EAAC,qBAAqB,aAClC,cAAK,SAAS,EAAC,0DAA0D,YACvE,KAAC,QAAQ,IAAC,SAAS,EAAC,uBAAuB,YAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,GAAY,GACpF,EACN,KAAC,WAAW,IAAC,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,GAAI,IACvF,CACP,EAED,eAAK,SAAS,EAAC,gDAAgD,aAC7D,eAAK,SAAS,EAAC,yBAAyB,aACrC,QAAQ,KAAK,SAAS,IAAI,CACzB,KAAC,MAAM,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,KAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAI,CAC3F,EACA,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,CACzB,KAAC,QAAQ,IAAC,SAAS,EAAC,iEAAiE,YAAE,IAAI,CAAC,GAAG,GAAY,CAC5G,IACG,EACN,KAAC,QAAQ,IAAC,SAAS,EAAC,4BAA4B,YAAE,IAAI,CAAC,EAAE,GAAY,IACjE,IACF,CACP,CAAC;AACJ,CAAC;AAKD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,MAAuB;IAChE,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAE,IAA0C,CAAC,GAAG,IAAK,IAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3J,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,MAAM,IAAI,GAAG,WAAW,CAAC,GAA8B,EAAE,CAAC,EAAE;QAC1D,WAAW,EAAE,QAAQ;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAiB,MAAM,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,CAAK,KAAqB,EAAE,KAAQ,EAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9G,OAAO;QACL,GAAG,IAAI;QACP,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QACpC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;QAC1B,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC;QACzC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACnC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACnC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACnC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;QAC1B,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;QAChC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAgC;IACrF,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,CACL,KAAC,UAAU,IACT,OAAO,QACP,MAAM,EAAC,SAAS,EAChB,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,IAAI,SAAS,EAC/C,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,IAAI,0CAA0C,GAC9E,CACH,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,CACX,KAAC,SAAS,IACR,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,KAAK,EACf,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,KAChD,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAC7E,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,KACvE,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,GAC9E,CACH,CAAC;IACF,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,6BAAiB,YAAY,YAAE,IAAI,GAAO,CAAC;IAC1E,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,iBACD,YAAY,EACxB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,EACvD,SAAS,EAAC,6GAA6G,YAEtH,IAAI,GACE,CACV,CAAC;AACJ,CAAC"}

package/dist/families/boards/InlineComposeCard.d.ts

@@ -0,0 +1,35 @@
+import { inlineComposeCardConfigSchema, inlineComposeCardDemoData } from './boards-config.js';
+import type { InlineComposeCardConfig } from './boards-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { inlineComposeCardConfigSchema, inlineComposeCardDemoData };
+export type { InlineComposeCardConfig };
+/**
+ * `inline-compose-card` (annex §6) — the in-column quick-add: an
+ * accent-bordered card with a text input and Add/Cancel, with Enter to commit
+ * and Escape to cancel (Project Board). The new record gets the column's sane
+ * defaults.
+ *
+ * It emits a `mutate` INSERT *intent* and clears itself — the widget never
+ * writes. The host runs the insert through the CRUD API (undo + audit) and the
+ * board re-renders from the next payload, so there is no optimistic row here to
+ * fall out of sync with the server's generated id/timestamps.
+ *
+ * `keepOpen` (the default) leaves the composer open after Add so a planning
+ * session can type card after card — the behaviour the comp demonstrates.
+ */
+export interface InlineComposeCardProps {
+    placeholder?: string | undefined;
+    addLabel?: string | undefined;
+    cancelLabel?: string | undefined;
+    openLabel?: string | undefined;
+    /** Start expanded (a dedicated compose slot) vs. behind the add affordance. */
+    defaultOpen?: boolean | undefined;
+    /** Keep the composer open after a successful add, for rapid entry. */
+    keepOpen?: boolean | undefined;
+    onAdd?: ((title: string) => void) | undefined;
+    onCancel?: (() => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function InlineComposeCard({ placeholder, addLabel, cancelLabel, openLabel, defaultOpen, keepOpen, onAdd, onCancel, testId, }: InlineComposeCardProps): import("react").JSX.Element;
+export declare function InlineComposeCardWidget({ config, onEvent }: WidgetProps<InlineComposeCardConfig>): import("react").JSX.Element;
+//# sourceMappingURL=InlineComposeCard.d.ts.map

package/dist/families/boards/InlineComposeCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineComposeCard.d.ts","sourceRoot":"","sources":["../../../src/families/boards/InlineComposeCard.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,CAAC;AACpE,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAExC;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,iBAAiB,CAAC,EAChC,WAA2B,EAC3B,QAAgB,EAChB,WAAsB,EACtB,SAAsB,EACtB,WAAmB,EACnB,QAAe,EACf,KAAK,EACL,QAAQ,EACR,MAAM,GACP,EAAE,sBAAsB,+BA+ExB;AAED,wBAAgB,uBAAuB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,uBAAuB,CAAC,+BAwBhG"}

package/dist/families/boards/InlineComposeCard.js

@@ -0,0 +1,65 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from '@adminium/ui';
+import { Plus } from 'lucide-react';
+import { useRef, useState } from 'react';
+import { inlineComposeCardConfigSchema, inlineComposeCardDemoData } from './boards-config.js';
+import { bindingSourceOf } from './board-lib.js';
+export { inlineComposeCardConfigSchema, inlineComposeCardDemoData };
+export function InlineComposeCard({ placeholder = 'Card title…', addLabel = 'Add', cancelLabel = 'Cancel', openLabel = 'Add card', defaultOpen = false, keepOpen = true, onAdd, onCancel, testId, }) {
+    const [open, setOpen] = useState(defaultOpen);
+    const [draft, setDraft] = useState('');
+    const inputRef = useRef(null);
+    const close = () => {
+        setDraft('');
+        setOpen(false);
+        onCancel?.();
+    };
+    const commit = () => {
+        const title = draft.trim();
+        // A whitespace-only draft is not a card: committing it would insert a
+        // titleless row the board renders as "#1".
+        if (title === '')
+            return;
+        onAdd?.(title);
+        setDraft('');
+        if (keepOpen)
+            inputRef.current?.focus();
+        else
+            setOpen(false);
+    };
+    if (!open) {
+        return (_jsxs("button", { type: "button", "data-widget": "inline-compose-card", "data-testid": testId, "data-part": "compose-open", onClick: () => setOpen(true), className: "flex w-full items-center gap-1.5 rounded-lg border border-dashed border-border px-3 py-2 text-body-sm text-fg-muted hover:border-accent hover:bg-accent-soft hover:text-accent focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: [_jsx(Plus, { "aria-hidden": "true", className: "size-4" }), openLabel] }));
+    }
+    return (_jsxs("div", { "data-widget": "inline-compose-card", "data-testid": testId, "data-part": "compose-card", className: "flex flex-col gap-2 rounded-lg border border-accent bg-surface-1 p-2.5 shadow-sm", children: [_jsx("input", { ref: inputRef, type: "text", autoFocus: true, value: draft, "aria-label": placeholder, placeholder: placeholder, onChange: (event) => setDraft(event.target.value), onKeyDown: (event) => {
+                    // Enter commits, Escape cancels (annex). Both stop propagating: this
+                    // composer lives INSIDE a board column, whose own key handler drives
+                    // card drag/drop — an un-stopped Escape would cancel a drag instead.
+                    if (event.key === 'Enter') {
+                        event.preventDefault();
+                        event.stopPropagation();
+                        commit();
+                    }
+                    else if (event.key === 'Escape') {
+                        event.preventDefault();
+                        event.stopPropagation();
+                        close();
+                    }
+                }, className: "w-full rounded-md border border-border bg-surface px-2 py-1.5 text-body-sm text-fg placeholder:text-fg-subtle focus-visible:outline-2 focus-visible:-outline-offset-1 focus-visible:outline-accent" }), _jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx(Button, { size: "sm", variant: "primary", "data-part": "compose-add", disabled: draft.trim() === '', onClick: commit, children: addLabel }), _jsx(Button, { size: "sm", variant: "ghost", "data-part": "compose-cancel", onClick: close, children: cancelLabel })] })] }));
+}
+export function InlineComposeCardWidget({ config, onEvent }) {
+    const source = bindingSourceOf(config.binding);
+    return (_jsx(InlineComposeCard, { defaultOpen: config.defaultOpen, keepOpen: config.keepOpen, ...(config.placeholder === undefined ? {} : { placeholder: config.placeholder }), ...(config.addLabel === undefined ? {} : { addLabel: config.addLabel }), ...(config.cancelLabel === undefined ? {} : { cancelLabel: config.cancelLabel }), ...(config.testId === undefined ? {} : { testId: config.testId }), onAdd: (title) => {
+            if (source === null)
+                return; // unbound: nothing to insert into
+            onEvent({
+                type: 'mutate',
+                intent: 'insert',
+                connectionId: source.connectionId,
+                table: source.table,
+                // Config defaults first so the typed title can never be clobbered by a
+                // stale `defaults: { title: … }` left in a stored config.
+                values: { ...config.defaults, [config.titleField]: title },
+            });
+        } }));
+}
+//# sourceMappingURL=InlineComposeCard.js.map

package/dist/families/boards/InlineComposeCard.js.map

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

package/dist/families/boards/KanbanBoard.d.ts

@@ -0,0 +1,30 @@
+import type { BoardAnnouncements, MoveResult } from './board-dnd.js';
+import type { BoardCardData, ColumnDef } from './board-lib.js';
+import type { KanbanBoardConfig } from './boards-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { kanbanBoardConfigSchema, kanbanBoardDemoData, kanbanColumnDefSchema } from './boards-config.js';
+export type { KanbanBoardConfig };
+export interface KanbanBoardLabels {
+    announcements?: Partial<BoardAnnouncements> | undefined;
+    addLabel?: string | undefined;
+    gripLabel?: string | undefined;
+    pointsUnit?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+}
+export interface KanbanBoardProps {
+    cards: readonly BoardCardData[];
+    columns: readonly ColumnDef[];
+    dir?: 'ltr' | 'rtl' | undefined;
+    locale?: string | undefined;
+    allowAdd?: boolean | undefined;
+    labels?: KanbanBoardLabels | undefined;
+    /** Fired on a committed move; return a promise to enable rollback-on-reject. */
+    onCardMove?: ((cardId: string, fromColumn: string, toColumn: string) => MoveResult) | undefined;
+    onCardOpen?: ((cardId: string) => void) | undefined;
+    onAdd?: ((columnId: string) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function KanbanBoard({ cards, columns, dir, locale, allowAdd, labels, onCardMove, onCardOpen, onAdd, testId, }: KanbanBoardProps): import("react").JSX.Element;
+export declare function KanbanBoardWidget({ config, data, onEvent }: WidgetProps<KanbanBoardConfig>): import("react").JSX.Element;
+//# sourceMappingURL=KanbanBoard.d.ts.map

package/dist/families/boards/KanbanBoard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KanbanBoard.d.ts","sourceRoot":"","sources":["../../../src/families/boards/KanbanBoard.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM3D,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACzG,YAAY,EAAE,iBAAiB,EAAE,CAAC;AA0BlC,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IAC9B,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,gFAAgF;IAChF,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,CAAC,GAAG,SAAS,CAAC;IAChG,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpD,KAAK,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,OAAO,EACP,GAAW,EACX,MAAM,EACN,QAAgB,EAChB,MAAM,EACN,UAAU,EACV,UAAU,EACV,KAAK,EACL,MAAM,GACP,EAAE,gBAAgB,+BA8JlB;AAOD,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,iBAAiB,CAAC,+BA+C1F"}

package/dist/families/boards/KanbanBoard.js

@@ -0,0 +1,141 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { EmptyState } from '@adminium/ui';
+import { DndContext, DragOverlay, PointerSensor, closestCorners, useSensor, useSensors, } from '@dnd-kit/core';
+import { Plus } from 'lucide-react';
+import { useState } from 'react';
+import { BoardCard } from './BoardCard.js';
+import { BoardLiveRegion, DraggableCard, DroppableCell, announcementsFromTemplates, defaultBoardAnnouncements, silentDndAnnouncements, useBoardMoves, useLiveRegion, } from './board-dnd.js';
+import { boardRowsOf, resolveColumns, toBoardCard } from './board-lib.js';
+// Config schema + deterministic demo payload live in the pure `boards-config`
+// module so the registry metadata graph never eagerly pulls dnd-kit (acc #3);
+// re-exported here so the family barrel, stories, and tests keep one import
+// point per widget.
+export { kanbanBoardConfigSchema, kanbanBoardDemoData, kanbanColumnDefSchema } from './boards-config.js';
+/**
+ * `kanban-board` (annex §6) — fixed status columns of draggable cards. Columns
+ * derive from a workflow-enum field; a card dropped in another column emits an
+ * `onCardMove(cardId, fromColumn, toColumn)` the binding fires as an optimistic
+ * UPDATE mutation (rolled back if the mutation promise rejects). Pointer drag
+ * uses dnd-kit; keyboard uses a logical grab → arrow-move → Enter-commit /
+ * Escape-cancel model that mirrors correctly under `dir="rtl"`. Binds to a flat
+ * `record-list` grouped by the status field.
+ *
+ * Ports designs/Project Board.dc.html, Kanban Roadmap.dc.html — closing the
+ * "modal not wired to grid" gap (research/ia-mapping.md §5): a committed move
+ * updates the board state in place rather than only firing a detached modal.
+ */
+/** Column-header status dot tone → token background (no raw hex). */
+const DOT_TONE = {
+    neutral: 'bg-fg-subtle',
+    accent: 'bg-accent',
+    pos: 'bg-pos',
+    warn: 'bg-warn',
+    danger: 'bg-danger',
+    info: 'bg-info',
+};
+export function KanbanBoard({ cards, columns, dir = 'ltr', locale, allowAdd = false, labels, onCardMove, onCardOpen, onAdd, testId, }) {
+    const [activeId, setActiveId] = useState(null);
+    const { message, announce } = useLiveRegion();
+    const announcements = { ...defaultBoardAnnouncements, ...labels?.announcements };
+    const columnById = new Map(columns.map((column) => [column.id, column]));
+    const labelOf = (columnId) => columnById.get(columnId)?.label ?? columnId;
+    const moves = useBoardMoves({
+        cards,
+        naturalCellKey: (card) => card.column,
+        cellLabel: labelOf,
+        onCommit: (cardId, from, to) => onCardMove?.(cardId, from, to),
+        announce,
+        announcements,
+    });
+    const sensors = useSensors(useSensor(PointerSensor, { activationConstraint: { distance: 4 } }));
+    const activeCard = activeId === null ? null : cards.find((card) => card.id === activeId) ?? null;
+    if (columns.length === 0) {
+        return (_jsx(EmptyState, { preset: "no-data", title: labels?.emptyTitle ?? 'No board columns', body: labels?.emptyBody ?? 'Add a status field to group cards into columns.' }));
+    }
+    const onDragStart = (event) => {
+        setActiveId(String(event.active.id));
+    };
+    const onDragEnd = (event) => {
+        setActiveId(null);
+        const over = event.over;
+        if (over === null)
+            return;
+        moves.requestMove(String(event.active.id), String(over.id));
+    };
+    const onCardKeyDown = (event, card) => {
+        const grabbed = moves.isGrabbed(card.id);
+        if (event.key === 'Enter' || event.key === ' ' || event.key === 'Spacebar') {
+            event.preventDefault();
+            if (grabbed)
+                moves.commit();
+            else
+                moves.grab(card.id);
+            return;
+        }
+        if (event.key === 'Escape') {
+            if (grabbed) {
+                event.preventDefault();
+                moves.cancel();
+            }
+            return;
+        }
+        if (!grabbed)
+            return;
+        if (event.key === 'ArrowRight' || event.key === 'ArrowLeft') {
+            event.preventDefault();
+            // Logical step: ArrowRight advances reading order; under RTL that is the
+            // visually-left column, so flip the physical delta by `dir`.
+            const physical = event.key === 'ArrowRight' ? 1 : -1;
+            const logical = physical * (dir === 'rtl' ? -1 : 1);
+            const currentKey = moves.grabTargetKey ?? moves.cellKeyOf(card);
+            const current = columns.findIndex((column) => column.id === currentKey);
+            const nextIndex = Math.min(Math.max(current + logical, 0), columns.length - 1);
+            moves.previewTo(columns[nextIndex].id);
+        }
+    };
+    return (_jsxs("div", { dir: dir, "data-widget": "kanban-board", "data-testid": testId, className: "flex h-full flex-col", children: [_jsx(BoardLiveRegion, { message: message }), _jsxs(DndContext, { sensors: sensors, collisionDetection: closestCorners, accessibility: { announcements: silentDndAnnouncements }, onDragStart: onDragStart, onDragEnd: onDragEnd, onDragCancel: () => setActiveId(null), children: [_jsx("div", { className: "flex h-full min-h-0 flex-1 items-stretch gap-3 overflow-x-auto p-3", children: columns.map((column) => {
+                            const columnCards = cards.filter((card) => moves.cellKeyOf(card) === column.id);
+                            const overWip = column.wip !== undefined && columnCards.length > column.wip;
+                            return (_jsxs("section", { "data-board-column": column.id, className: "flex w-72 shrink-0 flex-col rounded-xl bg-surface-2/60", children: [_jsxs("header", { className: "flex items-center gap-2 px-3 py-2.5", children: [_jsx("span", { "aria-hidden": "true", className: `size-2.5 rounded-full ${DOT_TONE[column.tone]}` }), _jsx("span", { className: "text-body-sm font-semibold text-fg", children: column.label }), _jsx("span", { "data-part": "column-count", className: 'ms-1 inline-flex h-[18px] min-w-[18px] items-center justify-center rounded-full px-1.5 font-mono text-[10.5px] font-bold tabular-nums ' +
+                                                    (overWip ? 'bg-danger text-danger-fg' : 'bg-surface-3 text-fg-muted'), children: column.wip === undefined ? columnCards.length : `${columnCards.length}/${column.wip}` }), allowAdd && (_jsx("button", { type: "button", "data-part": "column-add", onClick: () => onAdd?.(column.id), "aria-label": labels?.addLabel ?? 'Add card', className: "ms-auto flex size-6 items-center justify-center rounded-md text-fg-muted hover:bg-surface-3 hover:text-fg focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent", children: _jsx(Plus, { className: "size-4", "aria-hidden": "true" }) }))] }), _jsx(DroppableCell, { id: column.id, testId: `column-drop-${column.id}`, highlight: moves.grabTargetKey === column.id, className: "flex min-h-16 flex-1 flex-col gap-2 overflow-y-auto px-2 pb-2", children: columnCards.map((card) => (_jsx(DraggableCard, { card: card, grabbed: moves.isGrabbed(card.id), ariaLabel: card.title, className: "rounded-lg focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", onKeyDown: (event) => onCardKeyDown(event, card), ...(onCardOpen === undefined ? {} : { onClick: () => onCardOpen(card.id) }), children: _jsx(BoardCard, { card: card, columnTone: column.tone, ...(locale === undefined ? {} : { locale }), ...(labels?.gripLabel === undefined ? {} : { gripLabel: labels.gripLabel }), ...(labels?.pointsUnit === undefined ? {} : { pointsUnit: labels.pointsUnit }) }) }, card.id))) })] }, column.id));
+                        }) }), _jsx(DragOverlay, { children: activeCard === null ? null : (_jsx("div", { className: "w-72", children: _jsx(BoardCard, { card: activeCard, columnTone: columnById.get(moves.cellKeyOf(activeCard))?.tone ?? 'accent', ...(locale === undefined ? {} : { locale }) }) })) })] })] }));
+}
+function sourceOf(config) {
+    const binding = config.binding;
+    return { connectionId: binding?.connectionId, table: binding?.source?.table ?? 'records' };
+}
+export function KanbanBoardWidget({ config, data, onEvent }) {
+    const rows = boardRowsOf(data);
+    const cards = rows.map((row, index) => toBoardCard(row, index, { columnField: config.columnField, titleField: config.titleField }));
+    const columns = resolveColumns(cards, config.columnDefs);
+    const source = sourceOf(config);
+    const labels = {
+        ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle, emptyBody: config.emptyBody }),
+        ...(config.addLabel === undefined ? {} : { addLabel: config.addLabel }),
+        ...(config.announcements === undefined
+            ? {}
+            : { announcements: announcementsFromTemplates(config.announcements) }),
+    };
+    return (_jsx(KanbanBoard, { cards: cards, columns: columns, allowAdd: config.allowAdd, ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), labels: labels, 
+        // Return the host's result so a rejected `mutate` promise rolls the
+        // optimistic move back and announces the failure (annex §6 a11y).
+        onCardMove: (cardId, _from, toColumn) => onEvent({
+            type: 'mutate',
+            intent: 'update',
+            connectionId: source.connectionId,
+            table: source.table,
+            recordId: cardId,
+            values: { [config.columnField]: toColumn },
+        }), onCardOpen: (cardId) => {
+            onEvent({ type: 'record-open', connectionId: source.connectionId, table: source.table, recordId: cardId });
+        }, onAdd: (columnId) => {
+            onEvent({
+                type: 'mutate',
+                intent: 'insert',
+                connectionId: source.connectionId,
+                table: source.table,
+                values: { [config.columnField]: columnId },
+            });
+        } }));
+}
+//# sourceMappingURL=KanbanBoard.js.map

package/dist/families/boards/KanbanBoard.js.map

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