@lerianstudio/sindarian-ui 1.2.0 → 1.3.0-beta.2

package/dist/enterprise/cursor-pager/index.d.ts

@@ -0,0 +1,21 @@
+export type CursorPagerProps = {
+    /** From the page envelope: more pages exist after this one. */
+    hasMore?: boolean;
+    /** From the page envelope: cursor for the next page. */
+    nextCursor?: string | null;
+    /** From the page envelope: cursor for the previous page. */
+    prevCursor?: string | null;
+    /** Called with the cursor to load (undefined => first page). */
+    onCursorChange: (cursor: string | undefined) => void;
+    /** Disable both controls (e.g. while fetching). */
+    disabled?: boolean;
+    /** Optional summary, e.g. "50 per page" or a loaded-count string. */
+    summary?: string;
+    /** Label for the previous-page control. Defaults to "Previous". */
+    previousLabel?: string;
+    /** Label for the next-page control. Defaults to "Next". */
+    nextLabel?: string;
+    className?: string;
+};
+export declare function CursorPager({ hasMore, nextCursor, prevCursor, onCursorChange, disabled, summary, previousLabel, nextLabel, className }: CursorPagerProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/enterprise/cursor-pager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/enterprise/cursor-pager/index.tsx"],"names":[],"mappings":"AAoBA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,gEAAgE;IAChE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IACpD,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,UAAU,EACV,UAAU,EACV,cAAc,EACd,QAAgB,EAChB,OAAO,EACP,aAA0B,EAC1B,SAAkB,EAClB,SAAS,EACV,EAAE,gBAAgB,+BAmClB"}

package/dist/enterprise/cursor-pager/index.js

@@ -0,0 +1,26 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursorPager = CursorPager;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * CursorPager drives the cursor-pagination envelope
+ *   { items, hasMore, nextCursor, prevCursor, limit }
+ * shared by the console's cursor-paged list endpoints (do not use it on
+ * offset-based endpoints).
+ *
+ * It is controlled: the parent owns the active cursor (the value it passes to
+ * the list hook) and reacts to `onCursorChange`. Pass the page envelope's
+ * `hasMore`, `nextCursor`, `prevCursor`. "Previous" is enabled when the page
+ * reports a `prevCursor`; "Next" when `hasMore` and a `nextCursor` exist.
+ *
+ * `onCursorChange(undefined)` requests the first page (no cursor).
+ */
+const lucide_react_1 = require("lucide-react");
+const button_1 = require("../../components/ui/button");
+const utils_1 = require("../../lib/utils");
+function CursorPager({ hasMore, nextCursor, prevCursor, onCursorChange, disabled = false, summary, previousLabel = 'Previous', nextLabel = 'Next', className }) {
+    const canPrev = !disabled && !!prevCursor;
+    const canNext = !disabled && !!hasMore && !!nextCursor;
+    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, utils_1.cn)('flex items-center justify-between gap-4 pt-3', className), children: [(0, jsx_runtime_1.jsx)("p", { className: "text-muted-foreground text-xs", children: summary ?? '' }), (0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2", children: [(0, jsx_runtime_1.jsx)(button_1.Button, { type: "button", variant: "outline", size: "small", icon: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronLeft, { "aria-hidden": true }), iconPlacement: "start", disabled: !canPrev, onClick: () => onCursorChange(prevCursor ?? undefined), children: previousLabel }), (0, jsx_runtime_1.jsx)(button_1.Button, { type: "button", variant: "outline", size: "small", icon: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronRight, { "aria-hidden": true }), iconPlacement: "end", disabled: !canNext, onClick: () => onCursorChange(nextCursor ?? undefined), children: nextLabel })] })] }));
+}

package/dist/enterprise/data-table/index.d.ts

@@ -0,0 +1,88 @@
+import { type ColumnDef, type OnChangeFn, type RowData, type RowSelectionState } from '@tanstack/react-table';
+import { type EmptyStateProps } from '../empty-state';
+/**
+ * Per-column opt-in for ledger numeric alignment. Set `meta: { numeric: true }`
+ * on a money/number `ColumnDef` and DataTable right-aligns both the header and
+ * its body cells (mono tabular figures).
+ */
+declare module '@tanstack/react-table' {
+    interface ColumnMeta<TData extends RowData, TValue> {
+        numeric?: boolean;
+    }
+}
+/**
+ * Row selection is CONTROLLED-ONLY — the contract sindarian-x shipped: the
+ * component holds no selection state and only mirrors `rowSelection` back into
+ * TanStack. Legacy typed all three props as independently optional, so opting
+ * into `enableRowSelection` without wiring the other two compiled fine and then
+ * rendered checkboxes that could never toggle (state pinned to a constant `{}`,
+ * no updater). Same runtime contract here, honest types: enabling selection
+ * requires the controlled pair, and leaving it off forbids them.
+ */
+type RowSelectionProps<TData> = {
+    enableRowSelection?: false;
+    rowSelection?: never;
+    onRowSelectionChange?: never;
+    getRowSelectionLabel?: never;
+} | {
+    enableRowSelection: true;
+    /** Controlled selection state (TanStack `RowSelectionState`, keyed by row id). */
+    rowSelection: RowSelectionState;
+    /** Controlled selection updater (TanStack `OnChangeFn`). */
+    onRowSelectionChange: OnChangeFn<RowSelectionState>;
+    /**
+     * Accessible name for a row's checkbox. Defaults to `Select row <id>`,
+     * which announces the raw row id (`Select row 0` with the default index
+     * ids) — pass a builder to name the record the way a user recognises it,
+     * e.g. ``(row) => `Select settlement ${row.reference}` ``.
+     */
+    getRowSelectionLabel?: (row: TData) => string;
+};
+type DataTableBaseProps<TData> = {
+    columns: ColumnDef<TData, unknown>[];
+    data: TData[];
+    /** Show skeleton rows instead of data/empty state. */
+    loading?: boolean;
+    /** Number of skeleton rows when loading. Defaults to 8. */
+    skeletonRows?: number;
+    /** Announced by the persistent status region while loading. Defaults to "Loading table rows". */
+    loadingLabel?: string;
+    /** Empty-state config when data resolves to zero rows. */
+    empty?: EmptyStateProps;
+    /** Stable row id accessor; defaults to TanStack's index-based id. */
+    getRowId?: (row: TData, index: number) => string;
+    /**
+     * Drop the rounded-card framing (radius, hairline border, bg-card) so the
+     * table runs full-bleed inside an already-framed surface. Margin tweaks like
+     * `-mx-5` stay the caller's job via `className`.
+     */
+    flush?: boolean;
+    /**
+     * Row density. `comfortable` (default) keeps the table's standard padding;
+     * `compact` tightens cell padding for the veteran "more rows per screen"
+     * view. Applied as a per-cell padding override on THIS table only.
+     */
+    density?: 'comfortable' | 'compact';
+    /**
+     * Opt into the roving-focus keyboard layer. Presence of this callback
+     * enables row tabIndex/focus/keydown handling; Enter calls it with the
+     * focused row's data. DataTable stays router-agnostic — consumers
+     * navigate inside the callback. Default off: rows render exactly as
+     * before, with no tabIndex and no handlers.
+     */
+    onRowActivate?: (row: TData) => void;
+    /**
+     * Optional href builder pairing with `onRowActivate`: when present,
+     * Cmd/Ctrl+Enter on a focused row opens the built href in a new tab via
+     * `window.open(href, '_blank', 'noopener,noreferrer')` — the keyboard twin
+     * of cmd-clicking the row's in-cell link. Build hrefs with the router's
+     * own URL builder, never string concatenation. Sheet-based tables (no
+     * routable destination) simply omit it and keep modified Enter a no-op.
+     */
+    rowHref?: (row: TData) => string;
+    className?: string;
+};
+export type DataTableProps<TData> = DataTableBaseProps<TData> & RowSelectionProps<TData>;
+export declare function DataTable<TData>({ columns, data, loading, skeletonRows, loadingLabel, empty, getRowId, flush, density, enableRowSelection, rowSelection, onRowSelectionChange, getRowSelectionLabel, onRowActivate, rowHref, className }: DataTableProps<TData>): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/enterprise/data-table/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/enterprise/data-table/index.tsx"],"names":[],"mappings":"AAmCA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,UAAU,EAEf,KAAK,OAAO,EACZ,KAAK,iBAAiB,EAEvB,MAAM,uBAAuB,CAAA;AAY9B,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEjE;;;;GAIG;AACH,OAAO,QAAQ,uBAAuB,CAAC;IAIrC,UAAU,UAAU,CAAC,KAAK,SAAS,OAAO,EAAE,MAAM;QAChD,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB;CACF;AAED;;;;;;;;GAQG;AACH,KAAK,iBAAiB,CAAC,KAAK,IACxB;IACE,kBAAkB,CAAC,EAAE,KAAK,CAAA;IAC1B,YAAY,CAAC,EAAE,KAAK,CAAA;IACpB,oBAAoB,CAAC,EAAE,KAAK,CAAA;IAC5B,oBAAoB,CAAC,EAAE,KAAK,CAAA;CAC7B,GACD;IACE,kBAAkB,EAAE,IAAI,CAAA;IACxB,kFAAkF;IAClF,YAAY,EAAE,iBAAiB,CAAA;IAC/B,4DAA4D;IAC5D,oBAAoB,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAA;IACnD;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,MAAM,CAAA;CAC9C,CAAA;AAEL,KAAK,kBAAkB,CAAC,KAAK,IAAI;IAC/B,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAA;IACpC,IAAI,EAAE,KAAK,EAAE,CAAA;IACb,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iGAAiG;IACjG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAChD;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;IACnC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;IACpC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,MAAM,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,cAAc,CAAC,KAAK,IAAI,kBAAkB,CAAC,KAAK,CAAC,GAC3D,iBAAiB,CAAC,KAAK,CAAC,CAAA;AA4E1B,wBAAgB,SAAS,CAAC,KAAK,EAAE,EAC/B,OAAO,EACP,IAAI,EACJ,OAAe,EACf,YAAgB,EAChB,YAAmC,EACnC,KAAK,EACL,QAAQ,EACR,KAAa,EACb,OAAuB,EACvB,kBAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,OAAO,EACP,SAAS,EACV,EAAE,cAAc,CAAC,KAAK,CAAC,+BA+RvB"}

package/dist/enterprise/data-table/index.js

@@ -0,0 +1,245 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataTable = DataTable;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * DataTable — a typed, generic wrapper over TanStack Table v8.
+ *
+ * Pairs with CursorPager (server-driven pagination): pass the page's `items`
+ * as `data`; this component does no client-side paging or sorting by default.
+ * It owns the three render states the list screens need:
+ *   - loading  → header + skeleton rows
+ *   - empty    → EmptyState (data resolved, zero rows)
+ *   - data     → semantic table rows; cells own any links/actions
+ *
+ * Columns are standard TanStack `ColumnDef<T>`; cells receive the row's
+ * `original` value, so screens compose money / date / status cells directly in
+ * their column `cell` renderers.
+ *
+ * Row selection is opt-in and controlled: pass `enableRowSelection` plus
+ * `rowSelection` / `onRowSelectionChange` (TanStack-native types). When
+ * enabled, a checkbox column is prepended — header checkbox selects the
+ * page (indeterminate for partial), checkbox-cell clicks never bubble to
+ * row-level handlers. With the flag off (the default), nothing changes.
+ *
+ * Keyboard navigation is opt-in via `onRowActivate`: when present, rows get
+ * a roving tabindex (Tab enters the table once at the anchor row; the next
+ * Tab moves to the row's first tabbable child if it has one, otherwise out
+ * of the table — no trap), ArrowUp/Down move row focus clamped to the page,
+ * Home/End jump to the page edges, Enter activates the row through the
+ * callback, and Space toggles selection when `enableRowSelection` is on.
+ * Cmd/Ctrl+Enter opens the row's destination in a new tab when the optional
+ * `rowHref` builder is provided (window.open with noopener,noreferrer);
+ * without it, modified Enter stays a deliberate no-op — never a same-tab
+ * activation. Keydown events originating from interactive children (links,
+ * buttons, checkboxes, form fields) are never hijacked.
+ */
+const react_1 = require("react");
+const react_table_1 = require("@tanstack/react-table");
+const table_1 = require("../../components/ui/table");
+const skeleton_1 = require("../../components/ui/skeleton");
+const utils_1 = require("../../lib/utils");
+const empty_state_1 = require("../empty-state");
+const SELECTION_COLUMN_ID = '__select__';
+const CHECKBOX_CLASS = 'accent-primary block size-4';
+/** Right-aligned mono treatment for `meta: { numeric: true }` columns. */
+const NUMERIC_CELL_CLASS = 'text-right font-mono tabular-nums';
+/**
+ * Keydown events whose target sits inside one of these are never hijacked
+ * by the row-level keyboard handler — Space in a checkbox and Enter on an
+ * in-cell link keep their native behavior.
+ */
+const INTERACTIVE_CHILD_SELECTOR = 'a, button, input, select, textarea, [role="checkbox"]';
+/**
+ * Inset focus outline for keyboard-navigable rows. Outline, not Tailwind
+ * ring: ring is box-shadow, which renders unreliably on display: table-row.
+ * `focus-visible`-gated, so mouse users (and visual baselines) see nothing.
+ */
+const ROW_FOCUS_CLASS = 'focus-visible:outline focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-ring';
+function stopPropagation(event) {
+    event.stopPropagation();
+}
+function SelectAllCheckbox({ table }) {
+    const allSelected = table.getIsAllPageRowsSelected();
+    const someSelected = table.getIsSomePageRowsSelected();
+    return ((0, jsx_runtime_1.jsx)("input", { type: "checkbox", className: CHECKBOX_CLASS, "aria-label": "Select all rows on this page", checked: allSelected, ref: (el) => {
+            if (el)
+                el.indeterminate = !allSelected && someSelected;
+        }, onChange: table.getToggleAllPageRowsSelectedHandler() }));
+}
+function RowSelectionCheckbox({ row, getLabel }) {
+    return ((0, jsx_runtime_1.jsx)("input", { type: "checkbox", className: CHECKBOX_CLASS, "aria-label": getLabel ? getLabel(row.original) : `Select row ${row.id}`, checked: row.getIsSelected(), disabled: !row.getCanSelect(), onChange: row.getToggleSelectedHandler() }));
+}
+function createSelectionColumn(getLabel) {
+    return {
+        id: SELECTION_COLUMN_ID,
+        header: ({ table }) => (0, jsx_runtime_1.jsx)(SelectAllCheckbox, { table: table }),
+        cell: ({ row }) => (0, jsx_runtime_1.jsx)(RowSelectionCheckbox, { row: row, getLabel: getLabel })
+    };
+}
+function DataTable({ columns, data, loading = false, skeletonRows = 8, loadingLabel = 'Loading table rows', empty, getRowId, flush = false, density = 'comfortable', enableRowSelection = false, rowSelection, onRowSelectionChange, getRowSelectionLabel, onRowActivate, rowHref, className }) {
+    const tableColumns = (0, react_1.useMemo)(() => enableRowSelection
+        ? [createSelectionColumn(getRowSelectionLabel), ...columns]
+        : columns, [columns, enableRowSelection, getRowSelectionLabel]);
+    const table = (0, react_table_1.useReactTable)({
+        data,
+        columns: tableColumns,
+        getCoreRowModel: (0, react_table_1.getCoreRowModel)(),
+        getRowId,
+        enableRowSelection,
+        // Controlled-only, exactly as sindarian-x shipped it: this component holds
+        // no selection state. The `?? {}` is the JS-consumer safety net; the prop
+        // types make the TS path require the controlled pair whenever selection is
+        // enabled, so the dead-checkbox configuration is now unrepresentable.
+        onRowSelectionChange: enableRowSelection ? onRowSelectionChange : undefined,
+        state: {
+            rowSelection: enableRowSelection ? (rowSelection ?? {}) : undefined
+        }
+    });
+    const colCount = tableColumns.length;
+    const dataRows = table.getRowModel().rows;
+    const rowCount = dataRows.length;
+    // Compact density overrides only THIS table's cell padding (tailwind-merge
+    // lets the later utility win over TableHead/TableCell's defaults).
+    // Comfortable passes nothing, so the default render is unchanged.
+    const compact = density === 'compact';
+    const headDensityClass = compact ? 'h-8 px-2' : undefined;
+    const cellDensityClass = compact ? 'px-2 py-1.5' : undefined;
+    // --- Roving row focus (active only when onRowActivate is provided) ---
+    const keyboardNav = onRowActivate !== undefined;
+    const [focusedIndex, setFocusedIndex] = (0, react_1.useState)(0);
+    // ponytail: rowRefs is keyed by render index, while rows are id-keyed
+    // (`key={row.id}`). This holds only because DataTable is server-driven with
+    // no in-place client reorder, and React 19's per-render ref cleanup defuses
+    // stale entries. If client-side reorder is ever added, re-key this Map by
+    // row.id to keep focus targets aligned with their rows.
+    const rowRefs = (0, react_1.useRef)(new Map());
+    const focusWithinRef = (0, react_1.useRef)(false);
+    const containerRef = (0, react_1.useRef)(null);
+    // Render-time clamp: exactly one anchor row (tabIndex=0) even on the
+    // frame where data shrank but state has not caught up yet.
+    const anchorIndex = rowCount > 0 ? Math.min(focusedIndex, rowCount - 1) : 0;
+    // Data changes clamp the anchor but never steal focus: DOM focus moves
+    // only if focus was already inside the table and the focused row vanished
+    // (e.g. page flip removed it). Never autofocus on mount.
+    (0, react_1.useEffect)(() => {
+        if (!keyboardNav)
+            return;
+        // Clamp the focus target ONCE and drive both the state setter and the
+        // .focus() call from the same value — reading `focusedIndex` separately
+        // after the functional update would use the stale pre-clamp closure value
+        // and try to focus an unmounted row, dropping focus to <body>.
+        const max = Math.max(rowCount - 1, 0);
+        const target = Math.min(focusedIndex, max);
+        setFocusedIndex(target);
+        if (!focusWithinRef.current)
+            return;
+        const active = document.activeElement;
+        if (active && containerRef.current?.contains(active))
+            return;
+        // The target row may have unmounted on a data-shrink frame; walk down to
+        // the nearest existing lower index, falling back to the container, so
+        // focus never escapes the table.
+        for (let i = target; i >= 0; i--) {
+            const rowEl = rowRefs.current.get(i);
+            if (rowEl) {
+                rowEl.focus();
+                return;
+            }
+        }
+        containerRef.current?.focus();
+    }, [keyboardNav, rowCount, focusedIndex, data]);
+    const focusRow = (index) => {
+        rowRefs.current.get(index)?.focus();
+    };
+    const handleRowBlur = (event) => {
+        const next = event.relatedTarget;
+        if (!next || !containerRef.current?.contains(next)) {
+            focusWithinRef.current = false;
+        }
+    };
+    const handleRowKeyDown = (event, row, rowIndex) => {
+        const target = event.target;
+        if (target !== event.currentTarget &&
+            target.closest(INTERACTIVE_CHILD_SELECTOR) !== null) {
+            return;
+        }
+        switch (event.key) {
+            case 'ArrowDown':
+                event.preventDefault();
+                focusRow(Math.min(rowIndex + 1, rowCount - 1));
+                break;
+            case 'ArrowUp':
+                event.preventDefault();
+                focusRow(Math.max(rowIndex - 1, 0));
+                break;
+            case 'Home':
+                event.preventDefault();
+                focusRow(0);
+                break;
+            case 'End':
+                event.preventDefault();
+                focusRow(rowCount - 1);
+                break;
+            case 'Enter':
+                // Modified Enter (Cmd/Ctrl) means "open elsewhere" — a same-tab
+                // activation would destroy the user's context. With rowHref it
+                // opens the row's destination in a new tab; without it (sheet-based
+                // tables), it stays a deliberate no-op.
+                if (event.metaKey || event.ctrlKey) {
+                    if (rowHref) {
+                        window.open(rowHref(row.original), '_blank', 'noopener,noreferrer');
+                    }
+                    break;
+                }
+                onRowActivate?.(row.original);
+                break;
+            case ' ':
+                if (enableRowSelection && row.getCanSelect()) {
+                    event.preventDefault();
+                    row.getToggleSelectedHandler()(event);
+                }
+                break;
+            default:
+                break;
+        }
+    };
+    return ((0, jsx_runtime_1.jsxs)("div", { ref: containerRef, 
+        // tabIndex={-1} (keyboard-nav only) makes the container programmatically
+        // focusable so the focus-restoration fallback can land here when every
+        // row has unmounted, keeping focus inside the table rather than on <body>.
+        tabIndex: keyboardNav ? -1 : undefined, className: (0, utils_1.cn)(!flush &&
+            'border-border bg-card text-card-foreground rounded-lg border', className), children: [(0, jsx_runtime_1.jsx)("span", { className: "sr-only", role: "status", children: loading
+                    ? loadingLabel
+                    : rowCount === 0
+                        ? 'No rows'
+                        : `${rowCount} rows` }), (0, jsx_runtime_1.jsxs)(table_1.Table, { "aria-busy": loading ? 'true' : undefined, children: [(0, jsx_runtime_1.jsx)(table_1.TableHeader, { children: table.getHeaderGroups().map((headerGroup) => ((0, jsx_runtime_1.jsx)(table_1.TableRow, { className: "hover:bg-transparent", children: headerGroup.headers.map((header) => {
+                                const numeric = header.column.columnDef.meta?.numeric;
+                                return ((0, jsx_runtime_1.jsx)(table_1.TableHead, { align: numeric ? 'right' : undefined, className: (0, utils_1.cn)('tracking-wide uppercase', headDensityClass, header.column.id === SELECTION_COLUMN_ID && 'w-10'), children: header.isPlaceholder
+                                        ? null
+                                        : (0, react_table_1.flexRender)(header.column.columnDef.header, header.getContext()) }, header.id));
+                            }) }, headerGroup.id))) }), (0, jsx_runtime_1.jsx)(table_1.TableBody, { children: loading ? (Array.from({ length: skeletonRows }).map((_, rowIndex) => ((0, jsx_runtime_1.jsx)(table_1.TableRow, { className: "hover:bg-transparent", children: Array.from({ length: colCount }).map((__, cellIndex) => ((0, jsx_runtime_1.jsx)(table_1.TableCell, { className: cellDensityClass, children: (0, jsx_runtime_1.jsx)(skeleton_1.Skeleton, { className: "h-4 w-full max-w-[160px]" }) }, `skeleton-${rowIndex}-${cellIndex}`))) }, `skeleton-${rowIndex}`)))) : rowCount === 0 ? ((0, jsx_runtime_1.jsx)(table_1.TableRow, { className: "hover:bg-transparent", children: (0, jsx_runtime_1.jsx)(table_1.TableCell, { colSpan: colCount, className: "p-0", children: (0, jsx_runtime_1.jsx)(empty_state_1.EmptyState, { title: empty?.title ?? 'Nothing here yet', description: empty?.description, icon: empty?.icon, action: empty?.action, 
+                                    // The DataTable renders the ledger register grammar, so its
+                                    // empty surface reads as a ruled page rather than a centered
+                                    // void. Callers can still override via `empty.ruled = false`.
+                                    ruled: empty?.ruled ?? true }) }) })) : (dataRows.map((row, rowIndex) => ((0, jsx_runtime_1.jsx)(table_1.TableRow, { ref: keyboardNav
+                                ? (el) => {
+                                    if (el)
+                                        rowRefs.current.set(rowIndex, el);
+                                    else
+                                        rowRefs.current.delete(rowIndex);
+                                }
+                                : undefined, tabIndex: keyboardNav ? (rowIndex === anchorIndex ? 0 : -1) : undefined, onFocus: keyboardNav
+                                ? () => {
+                                    focusWithinRef.current = true;
+                                    setFocusedIndex(rowIndex);
+                                }
+                                : undefined, onBlur: keyboardNav ? handleRowBlur : undefined, onKeyDown: keyboardNav
+                                ? (event) => handleRowKeyDown(event, row, rowIndex)
+                                : undefined, className: keyboardNav ? ROW_FOCUS_CLASS : undefined, "data-state": enableRowSelection && row.getIsSelected()
+                                ? 'selected'
+                                : undefined, children: row.getVisibleCells().map((cell) => ((0, jsx_runtime_1.jsx)(table_1.TableCell, { className: (0, utils_1.cn)(cell.column.columnDef.meta?.numeric && NUMERIC_CELL_CLASS, cellDensityClass, cell.column.id === SELECTION_COLUMN_ID && 'w-10'), onClick: cell.column.id === SELECTION_COLUMN_ID
+                                    ? stopPropagation
+                                    : undefined, children: (0, react_table_1.flexRender)(cell.column.columnDef.cell, cell.getContext()) }, cell.id))) }, row.id)))) })] })] }));
+}

package/dist/enterprise/date-range-picker/index.d.ts

@@ -0,0 +1,37 @@
+import type { ComponentProps, ReactNode } from 'react';
+import { Calendar } from '../../components/ui/calendar';
+/**
+ * The calendar's locale type, taken straight off the Calendar props so the
+ * public signature stays the react-day-picker/date-fns `Locale` without this
+ * package taking a direct date-fns dependency.
+ */
+type CalendarLocale = ComponentProps<typeof Calendar>['locale'];
+export type DateRangeValue = {
+    /** YYYY-MM-DD or '' when unset. */
+    from: string;
+    /** YYYY-MM-DD or '' when unset. */
+    to: string;
+};
+export type DateRangePickerProps = {
+    value: DateRangeValue;
+    onValueChange: (next: DateRangeValue) => void;
+    /** id (and de-facto testid) of the "from" trigger; the label points at it. */
+    fromId: string;
+    toId: string;
+    fromLabel: ReactNode;
+    toLabel: ReactNode;
+    invalid?: boolean;
+    /** Wired as aria-describedby on both triggers while `invalid` is set. */
+    errorId?: string;
+    /** Trigger placeholder when unset. */
+    placeholder?: string;
+    /** Accessible label for the calendar popover. */
+    ariaLabel?: string;
+    /** Label for the clear button. */
+    clearLabel?: string;
+    /** date-fns locale for the calendar. Defaults to en-US. */
+    locale?: CalendarLocale;
+};
+export declare function DateRangePicker({ value, onValueChange, fromId, toId, fromLabel, toLabel, invalid, errorId, placeholder, ariaLabel, clearLabel, locale }: DateRangePickerProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/enterprise/date-range-picker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/enterprise/date-range-picker/index.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAUnD;;;;GAIG;AACH,KAAK,cAAc,GAAG,cAAc,CAAC,OAAO,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAA;AAE/D,MAAM,MAAM,cAAc,GAAG;IAC3B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,cAAc,CAAA;IACrB,aAAa,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAA;IAC7C,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB,CAAA;AAkCD,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,aAAa,EACb,MAAM,EACN,IAAI,EACJ,SAAS,EACT,OAAO,EACP,OAAe,EACf,OAAO,EACP,WAAwB,EACxB,SAA+B,EAC/B,UAAoB,EACpB,MAAa,EACd,EAAE,oBAAoB,+BAiHtB"}

package/dist/enterprise/date-range-picker/index.js

@@ -0,0 +1,92 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DateRangePicker = DateRangePicker;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * DateRangePicker — a two-segment popover range control.
+ *
+ * Two labelled mono trigger segments (from / to) each open the SAME two-month
+ * react-day-picker range calendar over the same range selection. The external
+ * contract is plain YYYY-MM-DD strings (empty string = unset) so state shapes
+ * that speak `date_from`/`date_to` stay untouched. The picker guarantees
+ * from <= to (react-day-picker reorders inverted picks);
+ * aria-invalid/aria-describedby pass-throughs keep external validation wiring
+ * alive. i18n is via plain string/locale props.
+ *
+ * ONE POPOVER ROOT PER SEGMENT, deliberately. A single `Popover.Root` holds ONE
+ * trigger ref and ONE open state, so wrapping the whole two-button row in a
+ * single `PopoverTrigger asChild` put Radix's dialog attributes
+ * (`aria-haspopup`, `aria-expanded`, `aria-controls`) on a plain, non-focusable
+ * `div` — an aria-allowed-attr violation, two buttons advertising the same
+ * expanded state, and focus that Radix could drop on `document.body` when the
+ * popover closed. Each segment is now a real `PopoverTrigger` button: focusable,
+ * correctly named, and the element Radix returns focus to on dismissal.
+ */
+const react_1 = require("react");
+const lucide_react_1 = require("lucide-react");
+const locale_1 = require("react-day-picker/locale");
+const button_1 = require("../../components/ui/button");
+const calendar_1 = require("../../components/ui/calendar");
+const label_1 = require("../../components/ui/label");
+const popover_1 = require("../../components/ui/popover");
+const typography_1 = require("../../lib/typography");
+const utils_1 = require("../../lib/utils");
+/** Leading YYYY-MM-DD of an ISO date (or date-time) string. */
+const ISO_DAY = /^(\d{4})-(\d{2})-(\d{2})/;
+/**
+ * Parse a YYYY-MM-DD day into a LOCAL-midnight Date — the calendar works in
+ * local time, so building from parts avoids the UTC shift `new Date(string)`
+ * applies to date-only input (which can land the picker a day early).
+ * Rejects impossible calendar days (e.g. 2024-02-31, which would roll over).
+ */
+function parseDay(value) {
+    const match = ISO_DAY.exec(value);
+    if (!match)
+        return undefined;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const parsed = new Date(year, month - 1, day);
+    return parsed.getFullYear() === year &&
+        parsed.getMonth() === month - 1 &&
+        parsed.getDate() === day
+        ? parsed
+        : undefined;
+}
+/** Format a Date back to YYYY-MM-DD in LOCAL time (never via toISOString). */
+function toDayString(value) {
+    if (!value)
+        return '';
+    const year = String(value.getFullYear()).padStart(4, '0');
+    const month = String(value.getMonth() + 1).padStart(2, '0');
+    const day = String(value.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+function DateRangePicker({ value, onValueChange, fromId, toId, fromLabel, toLabel, invalid = false, errorId, placeholder = 'Any date', ariaLabel = 'Select date range', clearLabel = 'Clear', locale = locale_1.enUS }) {
+    // Which segment's popover is open, if any. One root per segment means one open
+    // state per segment; holding the identity of the open one here keeps them
+    // mutually exclusive, so clicking "to" while "from" is open swaps the anchor
+    // instead of stacking two calendars.
+    const [openSegment, setOpenSegment] = (0, react_1.useState)(null);
+    const fromDate = parseDay(value.from);
+    const toDate = parseDay(value.to);
+    const selected = fromDate || toDate ? { from: fromDate, to: toDate } : undefined;
+    // Derived from the RAW strings, not the parsed dates: a value the calendar
+    // cannot parse still needs to be clearable, and gating Clear on `fromDate`
+    // would strand the field holding text the user can no longer remove.
+    const hasValue = value.from !== '' || value.to !== '';
+    const onSelect = (range) => {
+        onValueChange({
+            from: toDayString(range?.from),
+            to: toDayString(range?.to)
+        });
+    };
+    const triggerClass = (0, utils_1.cn)('border-input bg-card hover:bg-secondary focus-visible:ring-ring flex h-9 items-center gap-2 rounded-md border px-3 text-left font-mono text-sm tabular-nums transition-colors duration-150 ease-out focus-visible:ring-2 focus-visible:ring-offset-1 focus-visible:outline-none sm:w-40', invalid && 'border-destructive');
+    // The one calendar, rendered inside whichever segment's popover is open. Both
+    // segments read and write the SAME range selection, so which one you opened
+    // changes only the anchor, never the state.
+    const calendar = ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(calendar_1.Calendar, { mode: "range", numberOfMonths: 2, defaultMonth: fromDate ?? toDate ?? new Date(), selected: selected, onSelect: onSelect, locale: locale }), (0, jsx_runtime_1.jsx)("div", { className: "border-border flex items-center justify-end border-t px-3 py-2", children: (0, jsx_runtime_1.jsx)(button_1.Button, { type: "button", variant: "plain", size: "small", disabled: !hasValue, onClick: () => onValueChange({ from: '', to: '' }), children: clearLabel }) })] }));
+    const renderSegment = (segment, id, label, dateValue) => ((0, jsx_runtime_1.jsxs)(popover_1.Popover, { open: openSegment === segment, onOpenChange: (next) => setOpenSegment(next ? segment : null), children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-1.5", children: [(0, jsx_runtime_1.jsx)(label_1.Label, { htmlFor: id, className: typography_1.SECTION_LABEL_CLASS, children: label }), (0, jsx_runtime_1.jsxs)(popover_1.PopoverTrigger, { type: "button", id: id, className: triggerClass, "aria-invalid": invalid || undefined, "aria-describedby": invalid ? errorId : undefined, children: [(0, jsx_runtime_1.jsx)(lucide_react_1.CalendarDays, { className: "text-muted-foreground size-4 shrink-0", "aria-hidden": true }), dateValue ? ((0, jsx_runtime_1.jsx)("span", { children: dateValue })) : ((0, jsx_runtime_1.jsx)("span", { className: "text-muted-foreground font-sans", children: placeholder }))] })] }), (0, jsx_runtime_1.jsx)(popover_1.PopoverContent, { align: "start", className: "w-auto p-0", "aria-label": ariaLabel, children: calendar })] }, segment));
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col gap-3 sm:flex-row sm:items-end", children: [renderSegment('from', fromId, fromLabel, value.from), renderSegment('to', toId, toLabel, value.to)] }));
+}

package/dist/enterprise/detail-panel/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * DetailPanel — the console's right-side slide-over for inspecting and editing a
+ * single record without leaving the list behind it. Built on Sheet (a Radix
+ * Dialog) with three structural slots:
+ *
+ *   - a STICKY header: the record title, an optional actions cluster, and a
+ *     close affordance, pinned to the top while the body scrolls;
+ *   - a SCROLLABLE body carrying `children`;
+ *   - an optional STICKY footer for the primary/secondary actions
+ *     (e.g. Cancel / Save), pinned to the bottom.
+ *
+ *   <DetailPanel
+ *     open={open}
+ *     onOpenChange={setOpen}
+ *     title="Transaction txn_8f2a"
+ *     footer={<>
+ *       <SheetClose asChild><Button variant="outline">Cancel</Button></SheetClose>
+ *       <Button onClick={save}>Save</Button>
+ *     </>}
+ *   >
+ *     …long body…
+ *   </DetailPanel>
+ *
+ * Controlled only: drive `open` from props and reflect dismissals via
+ * `onOpenChange`. `side` defaults to "right".
+ */
+import * as React from 'react';
+export type DetailPanelProps = {
+    /** Controlled open state. */
+    open: boolean;
+    /** Reflects every dismissal (overlay, Esc, close button) and programmatic toggle. */
+    onOpenChange: (open: boolean) => void;
+    /** Header title; also the accessible dialog name. */
+    title: React.ReactNode;
+    /** Edge the panel slides in from. Defaults to "right". */
+    side?: 'right' | 'left';
+    /** Optional header actions, placed left of the close button. */
+    actions?: React.ReactNode;
+    /** Optional sticky footer (e.g. Cancel / Save). */
+    footer?: React.ReactNode;
+    /** Accessible label for the close button. Defaults to "Close". */
+    closeLabel?: string;
+    /** Scrollable body content. */
+    children?: React.ReactNode;
+    className?: string;
+};
+/**
+ * The slide-over inspector. The header and footer stay pinned; only the body
+ * scrolls. Sheet already renders an overlay, focus trap, and Esc/overlay
+ * dismissal — we suppress its built-in corner close button (`[&>button.absolute]`)
+ * and provide our own inside the header so the layout stays deliberate.
+ */
+export declare function DetailPanel({ open, onOpenChange, title, side, actions, footer, closeLabel, children, className }: DetailPanelProps): React.JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/enterprise/detail-panel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/enterprise/detail-panel/index.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAW9B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAA;IACb,qFAAqF;IACrF,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,qDAAqD;IACrD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,mDAAmD;IACnD,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,YAAY,EACZ,KAAK,EACL,IAAc,EACd,OAAO,EACP,MAAM,EACN,UAAoB,EACpB,QAAQ,EACR,SAAS,EACV,EAAE,gBAAgB,qBA4ClB"}

package/dist/enterprise/detail-panel/index.js

@@ -0,0 +1,20 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DetailPanel = DetailPanel;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const lucide_react_1 = require("lucide-react");
+const sheet_1 = require("../../components/ui/sheet");
+const utils_1 = require("../../lib/utils");
+/**
+ * The slide-over inspector. The header and footer stay pinned; only the body
+ * scrolls. Sheet already renders an overlay, focus trap, and Esc/overlay
+ * dismissal — we suppress its built-in corner close button (`[&>button.absolute]`)
+ * and provide our own inside the header so the layout stays deliberate.
+ */
+function DetailPanel({ open, onOpenChange, title, side = 'right', actions, footer, closeLabel = 'Close', children, className }) {
+    return ((0, jsx_runtime_1.jsx)(sheet_1.Sheet, { open: open, onOpenChange: onOpenChange, children: (0, jsx_runtime_1.jsxs)(sheet_1.SheetContent, { side: side, className: (0, utils_1.cn)(
+            // Reset Sheet's padding/gap and hide its built-in close button; we
+            // own the three-slot layout and the header close affordance here.
+            'flex flex-col gap-0 overflow-hidden p-0', '[&>button.absolute]:hidden', className), children: [(0, jsx_runtime_1.jsxs)("header", { className: "border-border bg-card sticky top-0 z-10 flex shrink-0 items-start justify-between gap-3 border-b px-6 py-4", children: [(0, jsx_runtime_1.jsx)(sheet_1.SheetTitle, { className: "min-w-0 flex-1 truncate text-base font-semibold tracking-tight", children: title }), (0, jsx_runtime_1.jsxs)("div", { className: "flex shrink-0 items-center gap-1.5", children: [actions, (0, jsx_runtime_1.jsx)(sheet_1.SheetClose, { "data-slot": "detail-panel-close", className: "ring-offset-background focus:ring-ring rounded-sm opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:outline-none disabled:pointer-events-none", "aria-label": closeLabel, children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { className: "size-4", "aria-hidden": true }) })] })] }), (0, jsx_runtime_1.jsx)("div", { className: "min-h-0 flex-1 overflow-y-auto", children: (0, jsx_runtime_1.jsx)("div", { className: "px-6 py-5", children: children }) }), footer ? ((0, jsx_runtime_1.jsx)("footer", { className: "border-border bg-card sticky bottom-0 z-10 flex shrink-0 flex-col-reverse gap-2 border-t px-6 py-4 sm:flex-row sm:justify-end", children: footer })) : null] }) }));
+}