@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/tables/TopMoversList.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Sparkline } from '@adminium/charts';
+import { DeltaPill, EmptyState, IconTile, MonoText } from '@adminium/ui';
+import { Minus, TrendingDown, TrendingUp } from 'lucide-react';
+import { topMoversListConfigSchema, topMoversListDemoData } from './tables-tail-config.js';
+import { formatDelta, formatMetricValue, goodDirectionFor, isBadMove, moverTone, numberField, resolveLocale, seriesField, stringField, tailRowsOf, trendOf, } from './tables-tail-lib.js';
+export { topMoversListConfigSchema, topMoversListDemoData };
+export function TopMoversList({ rows, n = 5, showSparkline = true, sparkWidth = 48, goodDirectionByMetric, locale, emptyTitle, emptyBody, onSelect, testId, }) {
+    const tag = resolveLocale(locale);
+    const ranked = [...rows].sort((a, b) => Math.abs(b.delta) - Math.abs(a.delta)).slice(0, Math.max(1, n));
+    if (ranked.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'No movers', body: emptyBody ?? 'Metrics that changed the most will appear here.' }));
+    }
+    return (_jsx("ul", { "data-widget": "top-movers-list", "data-testid": testId, className: "h-full overflow-auto px-2 py-1", children: ranked.map((row) => {
+            const good = goodDirectionFor(row.name, row.goodDirection, goodDirectionByMetric);
+            const bad = isBadMove(row.delta, good);
+            const trend = trendOf(row.delta);
+            const Glyph = trend === 'flat' ? Minus : trend === 'up' ? TrendingUp : TrendingDown;
+            const value = formatMetricValue(row.value, tag, {
+                ...(row.currency === undefined ? {} : { currency: row.currency }),
+                ...(row.unit === undefined ? {} : { unit: row.unit }),
+                compact: true,
+            });
+            const content = (_jsxs(_Fragment, { children: [_jsx(IconTile, { size: "sm", tone: moverTone(row.tone, row.delta, good), icon: _jsx(Glyph, { className: "rtl:-scale-x-100" }) }), _jsx("span", { className: "min-w-0 flex-1 truncate text-body-sm text-fg", children: row.name }), showSparkline && row.spark !== undefined && row.spark.length > 0 && (_jsx(Sparkline, { data: row.spark, variant: "line", width: sparkWidth, height: 20, tone: bad ? 'danger' : 'positive', className: "shrink-0" })), _jsx(MonoText, { className: "shrink-0 text-body-sm font-bold text-fg", children: value }), _jsx("span", { className: "flex w-[68px] shrink-0 justify-end", children: _jsx(DeltaPill, { "data-part": "mover-delta", trend: trend, invertGood: good === 'down', children: formatDelta(row.delta, tag) }) })] }));
+            return (_jsx("li", { "data-part": "mover-row", "data-bad": bad ? '' : undefined, "data-metric": row.name, children: onSelect === undefined ? (_jsx("div", { className: "flex items-center gap-3 rounded-lg px-1.5 py-2", children: content })) : (_jsx("button", { type: "button", onClick: () => onSelect(row), className: "flex w-full items-center gap-3 rounded-lg px-1.5 py-2 text-start hover:bg-surface-2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: content })) }, row.id));
+        }) }));
+}
+/** Project an untrusted `record-list` onto `MoverRow`s (04 §3). */
+export function moverRowsOf(data) {
+    return tailRowsOf(data).map((row, index) => {
+        const id = row.id;
+        const rawValue = row.value;
+        return {
+            id: typeof id === 'string' || typeof id === 'number' ? id : index,
+            name: stringField(row, 'name') ?? stringField(row, 'metric') ?? `#${index + 1}`,
+            value: typeof rawValue === 'string' ? rawValue : (numberField(row, 'value') ?? 0),
+            delta: numberField(row, 'delta') ?? 0,
+            goodDirection: stringField(row, 'goodDirection') === 'down' ? 'down' : 'up',
+            spark: seriesField(row, 'spark'),
+            tone: stringField(row, 'tone'),
+            currency: stringField(row, 'currency'),
+            unit: stringField(row, 'unit'),
+        };
+    });
+}
+export function TopMoversListWidget({ config, data, onEvent }) {
+    return (_jsx(TopMoversList, { rows: moverRowsOf(data), n: config.n, showSparkline: config.showSparkline, sparkWidth: config.sparkWidth, ...(config.goodDirectionByMetric === undefined ? {} : { goodDirectionByMetric: config.goodDirectionByMetric }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), ...(config.testId === undefined ? {} : { testId: config.testId }), ...(config.href === undefined
+            ? {}
+            : { onSelect: () => onEvent({ type: 'drill-through', href: config.href }) }) }));
+}
+//# sourceMappingURL=TopMoversList.js.map

package/dist/families/tables/TopMoversList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopMoversList.js","sourceRoot":"","sources":["../../../src/families/tables/TopMoversList.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,OAAO,GACR,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,CAAC;AA+B5D,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,EACJ,CAAC,GAAG,CAAC,EACL,aAAa,GAAG,IAAI,EACpB,UAAU,GAAG,EAAE,EACf,qBAAqB,EACrB,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,MAAM,GACa;IACnB,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAExG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CACL,KAAC,UAAU,IACT,OAAO,QACP,MAAM,EAAC,SAAS,EAChB,KAAK,EAAE,UAAU,IAAI,WAAW,EAChC,IAAI,EAAE,SAAS,IAAI,iDAAiD,GACpE,CACH,CAAC;IACJ,CAAC;IAED,OAAO,CACL,4BAAgB,iBAAiB,iBAAc,MAAM,EAAE,SAAS,EAAC,gCAAgC,YAC9F,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAClB,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC;YAClF,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,KAAK,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;YACpF,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE;gBAC9C,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACjE,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;gBACrD,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,CACd,8BACE,KAAC,QAAQ,IACP,IAAI,EAAC,IAAI,EACT,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,EAC1C,IAAI,EAAE,KAAC,KAAK,IAAC,SAAS,EAAC,kBAAkB,GAAG,GAC5C,EACF,eAAM,SAAS,EAAC,8CAA8C,YAAE,GAAG,CAAC,IAAI,GAAQ,EAC/E,aAAa,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CACnE,KAAC,SAAS,IACR,IAAI,EAAE,GAAG,CAAC,KAAK,EACf,OAAO,EAAC,MAAM,EACd,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,EAAE,EACV,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,EACjC,SAAS,EAAC,UAAU,GACpB,CACH,EACD,KAAC,QAAQ,IAAC,SAAS,EAAC,yCAAyC,YAAE,KAAK,GAAY,EAKhF,eAAM,SAAS,EAAC,oCAAoC,YAClD,KAAC,SAAS,iBAAW,aAAa,EAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,KAAK,MAAM,YACzE,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAClB,GACP,IACN,CACJ,CAAC;YACF,OAAO,CACL,0BAA2B,WAAW,cAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,iBAAe,GAAG,CAAC,IAAI,YACzF,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CACxB,cAAK,SAAS,EAAC,gDAAgD,YAAE,OAAO,GAAO,CAChF,CAAC,CAAC,CAAC,CACF,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAC5B,SAAS,EAAC,yKAAyK,YAElL,OAAO,GACD,CACV,IAXM,GAAG,CAAC,EAAE,CAYV,CACN,CAAC;QACJ,CAAC,CAAC,GACC,CACN,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAY,EAAE;QACnD,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC;QAC3B,OAAO;YACL,EAAE,EAAE,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK;YACjE,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE;YAC/E,KAAK,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACjF,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC;YACrC,aAAa,EAAE,WAAW,CAAC,GAAG,EAAE,eAAe,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;YAC3E,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC;YAChC,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC;YAC9B,QAAQ,EAAE,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC;YACtC,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC;SAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAoC;IAC7F,OAAO,CACL,KAAC,aAAa,IACZ,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,EACvB,CAAC,EAAE,MAAM,CAAC,CAAC,EACX,aAAa,EAAE,MAAM,CAAC,aAAa,EACnC,UAAU,EAAE,MAAM,CAAC,UAAU,KACzB,CAAC,MAAM,CAAC,qBAAqB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EAAE,CAAC,KAC3G,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,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,KAC1E,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,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAC9D,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;YAC5B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAc,EAAE,CAAC,EAAE,CAAC,GACxF,CACH,CAAC;AACJ,CAAC"}

package/dist/families/tables/cells.d.ts

@@ -0,0 +1,38 @@
+import type { ReactNode } from 'react';
+import type { GridColumnSpec, GridRow } from './column-spec.js';
+import type { WidgetEvent } from '../../registry/types.js';
+/**
+ * Type-aware cell renderers for the `tables` family (annex §3 `data-grid`;
+ * 09-generated-app.md §7.1 list keepers): money → mono end-aligned Intl
+ * currency, status/category enum → pill/badge, FK → avatar chip firing
+ * `record-open`, boolean → ✓/✕ glyph, timestamp → relative + absolute title,
+ * email/url → mono/link, PII → '•••' with an unmask affordance when the
+ * caller may reveal.
+ */
+export interface CellContext {
+    /** Host event sink — FK chips emit `record-open` through it. */
+    onEvent?: ((event: WidgetEvent) => void) | undefined;
+    /** Caller may reveal PII values received unmasked from the server. */
+    canUnmask?: boolean | undefined;
+    connectionId?: string | undefined;
+    /** Per-widget format overrides (shared config `format`). */
+    locale?: string | undefined;
+    currency?: string | undefined;
+    /** Unmask-toggle accessible labels (i18n). */
+    revealLabel?: string | undefined;
+    hideLabel?: string | undefined;
+}
+export declare const MASKED_PLACEHOLDER = "\u2022\u2022\u2022";
+/**
+ * Render one cell's content for a column spec. Pure dispatch on
+ * `semantic`/`logicalType`; interactive treatments (FK chip, unmask toggle)
+ * stop propagation so row-open clicks stay intact.
+ */
+export declare function CellValue({ column, row, context, }: {
+    column: GridColumnSpec;
+    row: GridRow;
+    context?: CellContext | undefined;
+}): ReactNode;
+/** Utility: the flex alignment class for a column (mono numbers end-align). */
+export declare function cellAlignClass(column: GridColumnSpec): string;
+//# sourceMappingURL=cells.d.ts.map

package/dist/families/tables/cells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cells.d.ts","sourceRoot":"","sources":["../../../src/families/tables/cells.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvC,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,eAAO,MAAM,kBAAkB,uBAAQ,CAAC;AAuFxC;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,GAAG,EACH,OAAY,GACb,EAAE;IACD,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACnC,GAAG,SAAS,CAoFZ;AAWD,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE7D"}

package/dist/families/tables/cells.js

@@ -0,0 +1,107 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Avatar, Badge, MonoText, StatusPill } from '@adminium/ui';
+import { Check, Eye, EyeOff, X } from 'lucide-react';
+import { useState } from 'react';
+import { columnAlign, formatAbsoluteTime, formatMoney, formatRelativeTime, maskedColumnsOf, uiToneOf, } from './column-spec.js';
+export const MASKED_PLACEHOLDER = '•••';
+const EMPTY_CELL = _jsx("span", { className: "text-fg-subtle", children: "\u2014" });
+function MaskedCell({ value, revealable, context, }) {
+    const [revealed, setRevealed] = useState(false);
+    if (!revealable) {
+        return (_jsx(MonoText, { "data-part": "cell-masked", className: "text-fg-subtle", children: MASKED_PLACEHOLDER }));
+    }
+    return (_jsxs("span", { "data-part": "cell-masked", className: "inline-flex items-center gap-1.5", children: [_jsx(MonoText, { className: revealed ? undefined : 'text-fg-subtle', children: revealed ? String(value) : MASKED_PLACEHOLDER }), _jsx("button", { type: "button", "aria-label": revealed ? (context.hideLabel ?? 'Hide value') : (context.revealLabel ?? 'Reveal value'), "aria-pressed": revealed, onClick: (event) => {
+                    event.stopPropagation();
+                    setRevealed((current) => !current);
+                }, className: "nb-ib inline-flex size-5 items-center justify-center rounded text-fg-subtle hover:text-fg focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-accent", children: revealed ? _jsx(EyeOff, { className: "size-3", "aria-hidden": "true" }) : _jsx(Eye, { className: "size-3", "aria-hidden": "true" }) })] }));
+}
+function FkChipCell({ column, row, value, context, }) {
+    const fk = column.fk;
+    const displayRaw = fk.displayKey !== undefined ? row[fk.displayKey] : undefined;
+    const display = displayRaw !== null && displayRaw !== undefined && String(displayRaw) !== ''
+        ? String(displayRaw)
+        : String(value);
+    const open = () => {
+        context.onEvent?.({
+            type: 'record-open',
+            connectionId: context.connectionId,
+            table: fk.table,
+            recordId: value,
+        });
+    };
+    return (_jsxs("button", { type: "button", "data-part": "cell-fk-chip", onClick: (event) => {
+            event.stopPropagation();
+            open();
+        }, className: "inline-flex h-6 max-w-full items-center gap-1.5 rounded-full border border-border bg-surface pe-2 ps-0.5 text-caption font-semibold text-fg hover:border-border-strong hover:bg-surface-2 focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-accent", children: [_jsx(Avatar, { name: display, size: "xs" }), _jsx("span", { className: "truncate", children: display })] }));
+}
+function enumTone(column, value) {
+    const tone = column.enumTones?.[value];
+    return tone === undefined ? undefined : uiToneOf(tone);
+}
+/**
+ * Render one cell's content for a column spec. Pure dispatch on
+ * `semantic`/`logicalType`; interactive treatments (FK chip, unmask toggle)
+ * stop propagation so row-open clicks stay intact.
+ */
+export function CellValue({ column, row, context = {}, }) {
+    const value = row[column.name];
+    const maskedByServer = maskedColumnsOf(row).includes(column.name);
+    if (maskedByServer)
+        return _jsx(MaskedCell, { value: null, revealable: false, context: context });
+    if (column.pii && value !== null && value !== undefined) {
+        return _jsx(MaskedCell, { value: value, revealable: context.canUnmask === true, context: context });
+    }
+    if (value === null || value === undefined)
+        return EMPTY_CELL;
+    if (column.semantic === 'money') {
+        return (_jsx(MonoText, { "data-part": "cell-money", className: "font-semibold", children: formatMoney(value, { locale: context.locale, currency: context.currency ?? column.currency }) }));
+    }
+    if (column.fk !== undefined) {
+        return _jsx(FkChipCell, { column: column, row: row, value: value, context: context });
+    }
+    if (column.semantic === 'status-workflow') {
+        const tone = enumTone(column, String(value));
+        return _jsx(StatusPill, { status: String(value), ...(tone === undefined ? {} : { tone }) });
+    }
+    if (column.semantic === 'category-enum' || column.logicalType === 'enum') {
+        return _jsx(Badge, { tone: enumTone(column, String(value)) ?? 'neutral', children: String(value) });
+    }
+    if (column.logicalType === 'boolean') {
+        return value === true ? (_jsx(Check, { "data-part": "cell-bool-true", className: "size-4 text-pos", "aria-label": "true", role: "img" })) : (_jsx(X, { "data-part": "cell-bool-false", className: "size-4 text-fg-subtle", "aria-label": "false", role: "img" }));
+    }
+    if (column.semantic === 'created-at' ||
+        column.semantic === 'updated-at' ||
+        column.semantic === 'event-timestamp' ||
+        column.logicalType === 'timestamp' ||
+        column.logicalType === 'timestamptz') {
+        return (_jsx("span", { "data-part": "cell-timestamp", title: formatAbsoluteTime(value, context.locale), className: "whitespace-nowrap text-fg-muted", children: formatRelativeTime(value, { locale: context.locale }) }));
+    }
+    if (column.semantic === 'email') {
+        return _jsx(MonoText, { "data-part": "cell-email", children: String(value) });
+    }
+    if (column.semantic === 'url' || column.semantic === 'image-url') {
+        return (_jsx("a", { "data-part": "cell-url", href: String(value), target: "_blank", rel: "noreferrer", onClick: (event) => event.stopPropagation(), className: "truncate font-medium text-accent underline decoration-accent/40 underline-offset-2 hover:decoration-accent", children: String(value) }));
+    }
+    if (column.semantic === 'percent') {
+        const amount = typeof value === 'number' ? value : Number(value);
+        return _jsx(MonoText, { "data-part": "cell-percent", children: Number.isFinite(amount) ? `${String(amount)}%` : String(value) });
+    }
+    if (column.logicalType === 'json') {
+        return _jsx(MonoText, { className: "truncate text-caption text-fg-muted", children: JSON.stringify(value) });
+    }
+    if (column.mono || column.semantic === 'pk-id' || column.semantic === 'external-id' || column.logicalType === 'uuid' || isPlainNumber(column)) {
+        return _jsx(MonoText, { children: String(value) });
+    }
+    return _jsx("span", { className: "truncate", children: String(value) });
+}
+function isPlainNumber(column) {
+    return (column.logicalType === 'integer' ||
+        column.logicalType === 'bigint' ||
+        column.logicalType === 'decimal' ||
+        column.logicalType === 'float');
+}
+/** Utility: the flex alignment class for a column (mono numbers end-align). */
+export function cellAlignClass(column) {
+    return columnAlign(column) === 'end' ? 'justify-end text-end' : 'justify-start text-start';
+}
+//# sourceMappingURL=cells.js.map

package/dist/families/tables/cells.js.map

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

package/dist/families/tables/column-spec.d.ts

@@ -0,0 +1,53 @@
+import type { Tone } from '@adminium/ui';
+import type { GridColumnSpec, GridRow, GridTone } from '../../page-config/grid-column-spec.js';
+/**
+ * Column-spec helpers for the `tables` family + `page-crud` template
+ * (research/widget-registry.md §3 "column defs generated from schema";
+ * 01-architecture.md §6.1 `config.columns`).
+ *
+ * The schema + types themselves live in the page-config pure leaf
+ * (`../../page-config/grid-column-spec.ts`) so the generator leaf's crud-body
+ * composer and `@adminium/engine/config` can share them without touching
+ * component code or this module's `@adminium/i18n` dependency. Re-exported
+ * here verbatim — this stays the `tables`-family import site.
+ */
+export { GRID_LOGICAL_TYPES, GRID_SEMANTICS, gridColumnSpecSchema, gridLogicalTypeSchema, type GridColumnSpec, type GridColumnSpecInput, type GridLogicalType, type GridRow, type GridSemantic, type GridTone, } from '../../page-config/grid-column-spec.js';
+/**
+ * Stored `GridTone` → `@adminium/ui` tone. `'muted'` (the generator/LLM
+ * fallback for enum values outside the §7.1 rule-7 keyword map) renders as the
+ * neutral treatment (surface-3 + fg-muted) — the ui vocabulary has no separate
+ * muted tone.
+ */
+export declare function uiToneOf(tone: GridTone): Tone;
+/** Server-mask marker (apps/server/src/crud/mask.ts): masked column names. */
+export declare function maskedColumnsOf(row: GridRow): readonly string[];
+/** Numeric column: numeric logical type or money/percent/score semantics. */
+export declare function isNumericColumn(column: GridColumnSpec): boolean;
+export declare function isTemporalColumn(column: GridColumnSpec): boolean;
+/** End-align money and plain numbers (comp keeper: mono end-aligned). */
+export declare function columnAlign(column: GridColumnSpec): 'start' | 'end';
+/**
+ * Type-aware cell comparator — THE Data Table string-mrr sort fix
+ * (research/ia-mapping.md §5 item 4): pg serializes `int8`/`decimal` as
+ * strings (01 §5 type rules) and client-added rows may carry strings too, so
+ * numeric columns coerce through `Number()` and NEVER fall back to the
+ * lexicographic path ("980" < "6100", not "6100" < "980").
+ */
+export declare function compareCellValues(column: GridColumnSpec, a: unknown, b: unknown): number;
+/** Locale/currency formatting for money cells (Intl, config override wins). */
+export declare function formatMoney(value: unknown, options?: {
+    locale?: string | undefined;
+    currency?: string | undefined;
+}): string;
+/** Relative timestamp ("3h ago") with an absolute ISO fallback for bad input. */
+export declare function formatRelativeTime(value: unknown, options?: {
+    locale?: string | undefined;
+    now?: number | undefined;
+}): string;
+/** Absolute timestamp for the cell `title` tooltip. */
+export declare function formatAbsoluteTime(value: unknown, locale?: string): string;
+/** Stable row id from the spec's PK columns (composite → JSON tuple, §2.7.2). */
+export declare function rowIdOf(columns: readonly GridColumnSpec[], row: GridRow): string;
+/** The row's display value ("key field", 09 §8.3) — confirm words, titles. */
+export declare function displayValueOf(columns: readonly GridColumnSpec[], row: GridRow): string;
+//# sourceMappingURL=column-spec.d.ts.map

package/dist/families/tables/column-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-spec.d.ts","sourceRoot":"","sources":["../../../src/families/tables/column-spec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EACV,cAAc,EAEd,OAAO,EACP,QAAQ,EACT,MAAM,uCAAuC,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,QAAQ,GACd,MAAM,uCAAuC,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAE7C;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAG/D;AAgBD,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAG/D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEhE;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,GAAG,KAAK,CAGnE;AAQD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAmBxF;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvE,MAAM,CAWR;AAUD,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,MAAM,CAe9H;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAKhF;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAOvF"}

package/dist/families/tables/column-spec.js

@@ -0,0 +1,158 @@
+import { getFormatters, latnDataTag } from '@adminium/i18n';
+/**
+ * Column-spec helpers for the `tables` family + `page-crud` template
+ * (research/widget-registry.md §3 "column defs generated from schema";
+ * 01-architecture.md §6.1 `config.columns`).
+ *
+ * The schema + types themselves live in the page-config pure leaf
+ * (`../../page-config/grid-column-spec.ts`) so the generator leaf's crud-body
+ * composer and `@adminium/engine/config` can share them without touching
+ * component code or this module's `@adminium/i18n` dependency. Re-exported
+ * here verbatim — this stays the `tables`-family import site.
+ */
+export { GRID_LOGICAL_TYPES, GRID_SEMANTICS, gridColumnSpecSchema, gridLogicalTypeSchema, } from '../../page-config/grid-column-spec.js';
+/**
+ * Stored `GridTone` → `@adminium/ui` tone. `'muted'` (the generator/LLM
+ * fallback for enum values outside the §7.1 rule-7 keyword map) renders as the
+ * neutral treatment (surface-3 + fg-muted) — the ui vocabulary has no separate
+ * muted tone.
+ */
+export function uiToneOf(tone) {
+    return tone === 'muted' ? 'neutral' : tone;
+}
+/** Server-mask marker (apps/server/src/crud/mask.ts): masked column names. */
+export function maskedColumnsOf(row) {
+    const marker = row['_masked'];
+    return Array.isArray(marker) ? marker : [];
+}
+const NUMERIC_TYPES = new Set([
+    'integer',
+    'bigint',
+    'decimal',
+    'float',
+]);
+const TIME_TYPES = new Set([
+    'date',
+    'time',
+    'timestamp',
+    'timestamptz',
+]);
+/** Numeric column: numeric logical type or money/percent/score semantics. */
+export function isNumericColumn(column) {
+    if (NUMERIC_TYPES.has(column.logicalType))
+        return true;
+    return column.semantic === 'money' || column.semantic === 'percent' || column.semantic === 'score';
+}
+export function isTemporalColumn(column) {
+    return TIME_TYPES.has(column.logicalType) || column.semantic === 'created-at' || column.semantic === 'updated-at' || column.semantic === 'event-timestamp';
+}
+/** End-align money and plain numbers (comp keeper: mono end-aligned). */
+export function columnAlign(column) {
+    if (column.align !== undefined)
+        return column.align;
+    return isNumericColumn(column) ? 'end' : 'start';
+}
+function toEpoch(value) {
+    if (value instanceof Date)
+        return value.getTime();
+    const time = new Date(String(value)).getTime();
+    return Number.isNaN(time) ? 0 : time;
+}
+/**
+ * Type-aware cell comparator — THE Data Table string-mrr sort fix
+ * (research/ia-mapping.md §5 item 4): pg serializes `int8`/`decimal` as
+ * strings (01 §5 type rules) and client-added rows may carry strings too, so
+ * numeric columns coerce through `Number()` and NEVER fall back to the
+ * lexicographic path ("980" < "6100", not "6100" < "980").
+ */
+export function compareCellValues(column, a, b) {
+    const aNull = a === null || a === undefined;
+    const bNull = b === null || b === undefined;
+    if (aNull || bNull)
+        return aNull && bNull ? 0 : aNull ? -1 : 1;
+    if (isNumericColumn(column)) {
+        const an = typeof a === 'number' ? a : Number(a);
+        const bn = typeof b === 'number' ? b : Number(b);
+        const aOk = Number.isFinite(an);
+        const bOk = Number.isFinite(bn);
+        if (aOk && bOk)
+            return an < bn ? -1 : an > bn ? 1 : 0;
+        if (aOk !== bOk)
+            return aOk ? -1 : 1; // malformed values sort last, deterministically
+    }
+    if (column.logicalType === 'boolean') {
+        return Number(a === true) - Number(b === true);
+    }
+    if (isTemporalColumn(column)) {
+        return toEpoch(a) - toEpoch(b);
+    }
+    return String(a).localeCompare(String(b));
+}
+/** Locale/currency formatting for money cells (Intl, config override wins). */
+export function formatMoney(value, options) {
+    const amount = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(amount))
+        return String(value ?? '');
+    // Money is a mono grid cell → data context (latn digits) via the format layer.
+    // `|| 'USD'` (not `??`) so a schema-valid empty currency code coalesces too —
+    // `{ style: 'currency', currency: '' }` would otherwise throw a RangeError.
+    return getFormatters(options?.locale ?? 'en-US').number(amount, {
+        style: 'currency',
+        currency: options?.currency || 'USD',
+        maximumFractionDigits: Number.isInteger(amount) ? 0 : 2,
+    });
+}
+const RELATIVE_STEPS = [
+    { limit: 60_000, divisor: 1000, unit: 'second' },
+    { limit: 3_600_000, divisor: 60_000, unit: 'minute' },
+    { limit: 86_400_000, divisor: 3_600_000, unit: 'hour' },
+    { limit: 2_592_000_000, divisor: 86_400_000, unit: 'day' },
+    { limit: 31_536_000_000, divisor: 2_592_000_000, unit: 'month' },
+];
+/** Relative timestamp ("3h ago") with an absolute ISO fallback for bad input. */
+export function formatRelativeTime(value, options) {
+    const time = value instanceof Date ? value.getTime() : new Date(String(value)).getTime();
+    if (Number.isNaN(time))
+        return String(value ?? '');
+    const delta = time - (options?.now ?? Date.now());
+    const magnitude = Math.abs(delta);
+    // Grid-cell relative time is a mono/data cell → latn digits (§4.2); the
+    // format layer's relative() is prose-only, so pin the numbering here.
+    const formatter = new Intl.RelativeTimeFormat(latnDataTag(options?.locale ?? 'en-US'), {
+        numeric: 'auto',
+        style: 'narrow',
+    });
+    for (const step of RELATIVE_STEPS) {
+        if (magnitude < step.limit)
+            return formatter.format(Math.round(delta / step.divisor), step.unit);
+    }
+    return formatter.format(Math.round(delta / 31_536_000_000), 'year');
+}
+/** Absolute timestamp for the cell `title` tooltip. */
+export function formatAbsoluteTime(value, locale) {
+    const time = value instanceof Date ? value : new Date(String(value));
+    if (Number.isNaN(time.getTime()))
+        return String(value ?? '');
+    // Data context (latn digits + gregorian, §4.2) via the format layer.
+    return getFormatters(locale ?? 'en-US').dateTime(time);
+}
+/** Stable row id from the spec's PK columns (composite → JSON tuple, §2.7.2). */
+export function rowIdOf(columns, row) {
+    const pk = columns.filter((column) => column.primaryKey);
+    if (pk.length === 0)
+        return JSON.stringify(row);
+    if (pk.length === 1)
+        return String(row[pk[0].name]);
+    return JSON.stringify(pk.map((column) => row[column.name]));
+}
+/** The row's display value ("key field", 09 §8.3) — confirm words, titles. */
+export function displayValueOf(columns, row) {
+    const display = columns.find((column) => column.isDisplay) ?? columns.find((column) => column.semantic === 'person-name');
+    if (display !== undefined) {
+        const value = row[display.name];
+        if (value !== null && value !== undefined && String(value) !== '')
+            return String(value);
+    }
+    return rowIdOf(columns, row);
+}
+//# sourceMappingURL=column-spec.js.map

package/dist/families/tables/column-spec.js.map

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

package/dist/families/tables/definitions.d.ts

@@ -0,0 +1,12 @@
+import type { WidgetDefinition } from '../../registry/types.js';
+/**
+ * `tables` family definitions (annex §3 — M4-T03 slice: data-grid,
+ * pagination-footer, bulk-action-toolbar, detail-key-value, mini-table;
+ * grouped-summary-table and the rest land by M7).
+ *
+ * Metadata only — component code lives in `widgets.tsx` (one lazy chunk for
+ * the family, 04 §2.3). Annex grid heights are rows; `sizing` uses 40px
+ * half-row units, so rows × 2 (04 §6.1).
+ */
+export declare const tablesWidgetDefinitions: readonly WidgetDefinition[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/families/tables/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/families/tables/definitions.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,gBAAgB,EAkE9D,CAAC"}

package/dist/families/tables/definitions.js

@@ -0,0 +1,81 @@
+import { lazy } from 'react';
+import { demoCustomerColumns, demoCustomerRows, demoRecordList } from './demo-data.js';
+import { bulkActionToolbarConfigSchema, dataGridConfigSchema, detailKeyValueConfigSchema, miniTableConfigSchema, paginationFooterConfigSchema, } from './tables-config.js';
+import { defineWidget } from '../../registry/types.js';
+/**
+ * `tables` family definitions (annex §3 — M4-T03 slice: data-grid,
+ * pagination-footer, bulk-action-toolbar, detail-key-value, mini-table;
+ * grouped-summary-table and the rest land by M7).
+ *
+ * Metadata only — component code lives in `widgets.tsx` (one lazy chunk for
+ * the family, 04 §2.3). Annex grid heights are rows; `sizing` uses 40px
+ * half-row units, so rows × 2 (04 §6.1).
+ */
+export const tablesWidgetDefinitions = [
+    defineWidget({
+        id: 'data-grid',
+        family: 'tables',
+        component: lazy(() => import('./widgets.js').then((m) => ({ default: m.DataGridWidget }))),
+        configSchema: dataGridConfigSchema,
+        dataContract: 'record-list',
+        sizing: { minW: 6, minH: 6, defaultW: 12, defaultH: 10 }, // annex: min 6×3, default 12×5
+        placement: 'grid',
+        skeleton: 'table',
+        capabilities: { exportCsv: true, editsData: true },
+        demoData: (seed) => ({ ...demoRecordList(seed), columns: demoCustomerColumns }),
+        descriptionKey: 'widgets.tables.dataGrid.description',
+    }),
+    defineWidget({
+        id: 'pagination-footer',
+        family: 'tables',
+        component: lazy(() => import('./widgets.js').then((m) => ({ default: m.PaginationFooterWidget }))),
+        configSchema: paginationFooterConfigSchema,
+        dataContract: 'record-list', // page cursor + total ride the list envelope
+        sizing: { minW: 6, minH: 1, defaultW: 12, defaultH: 1 },
+        placement: 'inline', // attached to data-grid (annex)
+        skeleton: 'block',
+        demoData: (seed) => demoRecordList(seed),
+        descriptionKey: 'widgets.tables.paginationFooter.description',
+    }),
+    defineWidget({
+        id: 'bulk-action-toolbar',
+        family: 'tables',
+        component: lazy(() => import('./widgets.js').then((m) => ({ default: m.BulkActionToolbarWidget }))),
+        configSchema: bulkActionToolbarConfigSchema,
+        dataContract: 'static', // selected-id array from the host grid (annex)
+        sizing: { minW: 6, minH: 1, defaultW: 12, defaultH: 1 },
+        placement: 'inline',
+        skeleton: 'block',
+        capabilities: { editsData: true },
+        demoData: () => ['1', '2', '3'],
+        descriptionKey: 'widgets.tables.bulkActionToolbar.description',
+    }),
+    defineWidget({
+        id: 'detail-key-value',
+        family: 'tables',
+        component: lazy(() => import('./widgets.js').then((m) => ({ default: m.DetailKeyValueWidget }))),
+        configSchema: detailKeyValueConfigSchema,
+        dataContract: 'record',
+        sizing: { minW: 4, minH: 6, defaultW: 4, defaultH: 8 }, // annex: min 4×3, default 4×4
+        placement: 'grid',
+        skeleton: 'list',
+        demoData: (seed) => ({
+            data: demoCustomerRows(seed, 1)[0] ?? {},
+            columns: demoCustomerColumns,
+        }),
+        descriptionKey: 'widgets.tables.detailKeyValue.description',
+    }),
+    defineWidget({
+        id: 'mini-table',
+        family: 'tables',
+        component: lazy(() => import('./widgets.js').then((m) => ({ default: m.MiniTableWidget }))),
+        configSchema: miniTableConfigSchema,
+        dataContract: 'record-list',
+        sizing: { minW: 3, minH: 4, defaultW: 4, defaultH: 6 }, // annex: min 3×2, default 4×3
+        placement: 'grid',
+        skeleton: 'list',
+        demoData: (seed) => ({ data: demoCustomerRows(seed, 5) }),
+        descriptionKey: 'widgets.tables.miniTable.description',
+    }),
+];
+//# sourceMappingURL=definitions.js.map

package/dist/families/tables/definitions.js.map

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

package/dist/families/tables/demo-data.d.ts

@@ -0,0 +1,15 @@
+import type { GridColumnSpec, GridRow } from './column-spec.js';
+/** Column specs for the demo customers table (parsed → defaults applied). */
+export declare const demoCustomerColumns: readonly GridColumnSpec[];
+/** Deterministic `record-list` rows; pg-style: decimal serialized as string. */
+export declare function demoCustomerRows(seed: number, count?: number): GridRow[];
+/** `record-list` envelope for grid-shaped demo contracts. */
+export declare function demoRecordList(seed: number, count?: number): {
+    data: GridRow[];
+    page: {
+        limit: number;
+        offset: number;
+        total: number;
+    };
+};
+//# sourceMappingURL=demo-data.d.ts.map

package/dist/families/tables/demo-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-data.d.ts","sourceRoot":"","sources":["../../../src/families/tables/demo-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAuB,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAqErF,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,EAAE,SAAS,cAAc,EAExD,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,EAAE,CAyBnE;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAGnI"}