@adminiumjs/widgets 0.1.0-rc.1

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

@@ -0,0 +1,30 @@
+import type { CardGalleryConfig, CardThumbnailMode } from './tables-track-f-config.js';
+import type { GalleryCard } from './tables-track-f-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+/**
+ * `card-gallery` (annex §3) — a responsive card grid for entities: an
+ * icon/monogram/doc-preview thumbnail, name, status pill, a meta line, and a
+ * hover-reveal action bar. Powers template/integration/member/file galleries.
+ * Binds to a `record-list` + a card mapping.
+ */
+export { cardGalleryConfigSchema, cardGalleryDemoData } from './tables-track-f-config.js';
+export type { CardGalleryConfig } from './tables-track-f-config.js';
+export type { GalleryCard } from './tables-track-f-types.js';
+export interface CardGalleryProps {
+    cards: readonly GalleryCard[];
+    columns?: number | undefined;
+    thumbnail?: CardThumbnailMode;
+    actions?: {
+        key: string;
+        label: string;
+    }[] | undefined;
+    clickable?: boolean | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onOpen?: ((card: GalleryCard) => void) | undefined;
+    onAction?: ((key: string, card: GalleryCard) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function CardGallery({ cards, columns, thumbnail, actions, clickable, emptyTitle, emptyBody, onOpen, onAction, testId, }: CardGalleryProps): import("react").JSX.Element;
+export declare function CardGalleryWidget({ config, data, onEvent }: WidgetProps<CardGalleryConfig>): import("react").JSX.Element;
+//# sourceMappingURL=CardGallery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CardGallery.d.ts","sourceRoot":"","sources":["../../../src/families/tables/CardGallery.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;GAKG;AAOH,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAQ7D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC;IACvD,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAqBD,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,OAAW,EACX,SAAsB,EACtB,OAAO,EACP,SAAgB,EAChB,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,MAAM,GACP,EAAE,gBAAgB,+BAyElB;AAsBD,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,iBAAiB,CAAC,+BAqB1F"}

package/dist/families/tables/CardGallery.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Avatar, Button, EmptyState, IconTile, StatusPill } from '@adminium/ui';
+import { FileText, LayoutGrid } from 'lucide-react';
+/**
+ * `card-gallery` (annex §3) — a responsive card grid for entities: an
+ * icon/monogram/doc-preview thumbnail, name, status pill, a meta line, and a
+ * hover-reveal action bar. Powers template/integration/member/file galleries.
+ * Binds to a `record-list` + a card mapping.
+ */
+// Config schema + deterministic demo payload live in the pure
+// `tables-track-f-config` module, and the card shape in
+// `tables-track-f-types`, so the registry metadata graph never reaches this
+// component file (04 §2.3). Re-exported here to keep existing import points
+// stable.
+export { cardGalleryConfigSchema, cardGalleryDemoData } from './tables-track-f-config.js';
+const COLUMN_CLASS = {
+    2: 'grid-cols-1 sm:grid-cols-2',
+    3: 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-3',
+    4: 'grid-cols-2 lg:grid-cols-4',
+};
+function Thumbnail({ card, mode }) {
+    const tone = card.tone ?? 'accent';
+    if (mode === 'none')
+        return null;
+    if (mode === 'monogram')
+        return _jsx(Avatar, { name: card.title, size: "lg", shape: "square" });
+    if (mode === 'icon')
+        return _jsx(IconTile, { size: "lg", tone: tone, icon: _jsx(LayoutGrid, {}) });
+    // doc-preview: a generated miniature document skeleton with the real title.
+    return (_jsxs("div", { "aria-hidden": "true", className: "flex h-16 w-full flex-col gap-1 rounded-md border border-border bg-surface-2 p-2", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx(FileText, { className: "size-3 text-fg-subtle" }), _jsx("div", { className: "h-1.5 w-1/2 rounded-full bg-fg-subtle/40" })] }), _jsx("div", { className: "h-1 w-full rounded-full bg-fg-subtle/20" }), _jsx("div", { className: "h-1 w-5/6 rounded-full bg-fg-subtle/20" }), _jsx("div", { className: "h-1 w-2/3 rounded-full bg-fg-subtle/20" })] }));
+}
+export function CardGallery({ cards, columns = 3, thumbnail = 'monogram', actions, clickable = true, emptyTitle, emptyBody, onOpen, onAction, testId, }) {
+    if (cards.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'Nothing to show', body: emptyBody ?? 'Items will appear here as cards.' }));
+    }
+    return (_jsx("div", { "data-widget": "card-gallery", "data-testid": testId, className: "h-full overflow-y-auto p-3", children: _jsx("ul", { className: `grid gap-3 ${COLUMN_CLASS[columns] ?? COLUMN_CLASS[3]}`, children: cards.map((card) => {
+                const inner = (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsx(Thumbnail, { card: card, mode: thumbnail }), card.status !== undefined && (_jsx(StatusPill, { status: card.status, ...(card.statusTone === undefined ? {} : { tone: card.statusTone }) }))] }), _jsxs("div", { className: "mt-3 min-w-0", children: [_jsx("p", { className: "truncate text-body-sm font-semibold text-fg", children: card.title }), card.subtitle !== undefined && _jsx("p", { className: "truncate text-caption text-fg-muted", children: card.subtitle }), card.meta !== undefined && _jsx("p", { className: "mt-0.5 truncate text-caption text-fg-subtle", children: card.meta })] }), actions !== undefined && actions.length > 0 && (_jsx("div", { className: "mt-3 flex flex-wrap gap-1.5 opacity-0 transition-opacity group-hover/card:opacity-100 group-focus-within/card:opacity-100", children: actions.map((action) => (_jsx(Button, { size: "sm", variant: "secondary", onClick: (event) => {
+                                    event.stopPropagation();
+                                    onAction?.(action.key, card);
+                                }, children: action.label }, action.key))) }))] }));
+                return (_jsx("li", { children: clickable ? (_jsx("div", { role: "button", tabIndex: 0, onClick: () => onOpen?.(card), onKeyDown: (event) => {
+                            if (event.key === 'Enter' || event.key === ' ') {
+                                event.preventDefault();
+                                onOpen?.(card);
+                            }
+                        }, className: "group/card flex h-full cursor-pointer flex-col rounded-lg border border-border bg-surface p-3 transition-colors hover:border-border-strong hover:bg-surface-2/40 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: inner })) : (_jsx("div", { className: "group/card flex h-full flex-col rounded-lg border border-border bg-surface p-3", children: inner })) }, card.id));
+            }) }) }));
+}
+function cardsOf(data) {
+    const raw = Array.isArray(data)
+        ? data
+        : typeof data === 'object' && data !== null && Array.isArray(data.data)
+            ? data.data
+            : [];
+    return raw.map((entry, index) => {
+        const row = (entry ?? {});
+        return {
+            id: row['id'] ?? index,
+            title: typeof row['title'] === 'string' ? row['title'] : typeof row['name'] === 'string' ? row['name'] : String(row['title'] ?? ''),
+            subtitle: typeof row['subtitle'] === 'string' ? row['subtitle'] : typeof row['category'] === 'string' ? row['category'] : undefined,
+            meta: typeof row['meta'] === 'string' ? row['meta'] : undefined,
+            status: typeof row['status'] === 'string' ? row['status'] : undefined,
+            statusTone: typeof row['statusTone'] === 'string' ? row['statusTone'] : undefined,
+            tone: typeof row['tone'] === 'string' ? row['tone'] : undefined,
+        };
+    });
+}
+export function CardGalleryWidget({ config, data, onEvent }) {
+    const source = config.binding;
+    const table = source === undefined ? undefined : source.source.schema === undefined ? source.source.name : `${source.source.schema}.${source.source.name}`;
+    return (_jsx(CardGallery, { cards: cardsOf(data), columns: config.columns, thumbnail: config.thumbnail, actions: config.actions, clickable: config.clickAction !== 'none', ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), onOpen: (card) => {
+            if (config.clickAction === 'link' && config.href !== undefined) {
+                onEvent({ type: 'drill-through', href: config.href });
+            }
+            else if (table !== undefined && source !== undefined) {
+                onEvent({ type: 'record-open', connectionId: source.connectionId, table, recordId: card.id });
+            }
+        } }));
+}
+//# sourceMappingURL=CardGallery.js.map

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

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

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

@@ -0,0 +1,46 @@
+import type { Tone } from '@adminium/ui';
+import { chipCloudConfigSchema, chipCloudDemoData } from './tables-tail-config.js';
+import type { ChipCloudConfig } from './tables-tail-config.js';
+import type { CloudChip } from './tables-tail-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { chipCloudConfigSchema, chipCloudDemoData };
+export type { ChipCloudConfig, CloudChip };
+/**
+ * `chip-cloud` (annex §3) — wrapped mono chips: discovered table names, merge
+ * variables, suggested dashboards (Adminium Console, Connect Database, Email
+ * Templates, Workspace Settings). Optional staggered pop-in, optional
+ * click-to-insert.
+ *
+ * The chips are inert `<span>`s unless a click action is configured, and
+ * interactive `<button>`s when one is — a cloud whose chips do nothing must not
+ * ship focusable, clickable-looking dead controls.
+ *
+ * The stagger is a CSS custom property per chip (`--chip-i`), the sanctioned
+ * escape hatch for a per-item dynamic value (02 §8). It is opt-in and the
+ * animation utility itself is `motion-safe:`, so `prefers-reduced-motion`
+ * viewers get the cloud with no pop-in at all.
+ */
+export interface ChipCloudProps {
+    chips: readonly CloudChip[];
+    clickAction?: 'none' | 'insert' | 'navigate' | undefined;
+    stagger?: boolean | undefined;
+    limit?: number | undefined;
+    tone?: Tone | undefined;
+    locale?: string | undefined;
+    /** "+{n} more" overflow chip label; `{n}` is substituted. */
+    moreLabel?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onSelect?: ((chip: CloudChip) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function ChipCloud({ chips, clickAction, stagger, limit, tone, locale, moreLabel, emptyTitle, emptyBody, onSelect, testId, }: ChipCloudProps): import("react").JSX.Element;
+/**
+ * Project an untrusted `categorical` payload onto `CloudChip`s. The annex's
+ * contract is "string array (+ optional icon per chip)", so a bare
+ * `['a','b']` array — the shape a hand-written binding most often produces —
+ * projects just as well as the canonical `{ items: [{ label }] }` envelope.
+ */
+export declare function cloudChipsOf(data: unknown): CloudChip[];
+export declare function ChipCloudWidget({ config, data, onEvent }: WidgetProps<ChipCloudConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ChipCloud.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChipCloud.d.ts","sourceRoot":"","sources":["../../../src/families/tables/ChipCloud.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACzD,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAMD,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,WAAoB,EACpB,OAAe,EACf,KAAU,EACV,IAAgB,EAChB,MAAM,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,QAAQ,EACR,MAAM,GACP,EAAE,cAAc,+BA+DhB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,CAqBvD;AAED,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,eAAe,CAAC,+BA0BtF"}

package/dist/families/tables/ChipCloud.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { EmptyState, MonoText, Tag } from '@adminium/ui';
+import { chipIcon } from './tables-tail-icons.js';
+import { chipCloudConfigSchema, chipCloudDemoData } from './tables-tail-config.js';
+import { resolveLocale, tailToneOf } from './tables-tail-lib.js';
+export { chipCloudConfigSchema, chipCloudDemoData };
+/** The staggered pop-in, opt-in and `motion-safe`-gated (02 §8, 10 §6). */
+const STAGGER_CLASS = 'motion-safe:animate-in motion-safe:fade-in motion-safe:zoom-in-95 motion-safe:[animation-delay:calc(var(--chip-i)*40ms)] motion-safe:[animation-fill-mode:backwards]';
+export function ChipCloud({ chips, clickAction = 'none', stagger = false, limit = 40, tone = 'neutral', locale, moreLabel, emptyTitle, emptyBody, onSelect, testId, }) {
+    void resolveLocale(locale); // normalize at the boundary (see tables-tail-lib)
+    const slice = chips.slice(0, limit);
+    const overflow = chips.length - slice.length;
+    const interactive = clickAction !== 'none' && onSelect !== undefined;
+    if (slice.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'Nothing discovered yet', body: emptyBody ?? 'Tables and variables will appear here as chips once they are found.' }));
+    }
+    return (_jsxs("div", { "data-widget": "chip-cloud", "data-testid": testId, "data-action": clickAction, className: "flex h-full flex-wrap content-start items-start gap-1.5 overflow-auto p-3", children: [slice.map((chip, index) => {
+                const body = (_jsxs(Tag, { mono: true, tone: tailToneOf(chip.tone, tone), "data-part": "cloud-chip", children: [_jsx("span", { "aria-hidden": "true", className: "me-1 inline-flex size-3 items-center [&>svg]:size-3", children: chipIcon(chip.icon) }), chip.label] }));
+                /*
+                 * The stagger index rides the WRAPPER, not the Tag: `Tag` omits `style`
+                 * from its props by design, and the rule that permits a `style` object
+                 * requires a literal object expression — so `--chip-i` is always set and
+                 * only the class that consumes it is conditional.
+                 */
+                const staggerClass = stagger ? STAGGER_CLASS : '';
+                return interactive ? (_jsx("button", { type: "button", onClick: () => onSelect(chip), style: { '--chip-i': String(index) }, className: `rounded-full focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent ${staggerClass}`, children: body }, `${chip.label}-${index}`)) : (_jsx("span", { style: { '--chip-i': String(index) }, className: staggerClass, children: body }, `${chip.label}-${index}`));
+            }), overflow > 0 && (_jsx(MonoText, { "data-part": "cloud-overflow", className: "self-center px-1.5 text-caption text-fg-subtle", children: (moreLabel ?? '+{n} more').replace('{n}', String(overflow)) }))] }));
+}
+/**
+ * Project an untrusted `categorical` payload onto `CloudChip`s. The annex's
+ * contract is "string array (+ optional icon per chip)", so a bare
+ * `['a','b']` array — the shape a hand-written binding most often produces —
+ * projects just as well as the canonical `{ items: [{ label }] }` envelope.
+ */
+export function cloudChipsOf(data) {
+    const raw = Array.isArray(data)
+        ? data
+        : typeof data === 'object' && data !== null && Array.isArray(data.items)
+            ? (data.items)
+            : [];
+    return raw.flatMap((entry) => {
+        if (typeof entry === 'string')
+            return entry === '' ? [] : [{ label: entry, value: entry }];
+        if (typeof entry !== 'object' || entry === null)
+            return [];
+        const record = entry;
+        const label = record.label ?? record.name ?? record.value;
+        if (typeof label !== 'string' || label === '')
+            return [];
+        return [
+            {
+                label,
+                ...(typeof record.icon === 'string' ? { icon: record.icon } : {}),
+                ...(typeof record.tone === 'string' ? { tone: record.tone } : {}),
+                value: typeof record.value === 'string' ? record.value : label,
+            },
+        ];
+    });
+}
+export function ChipCloudWidget({ config, data, onEvent }) {
+    /*
+     * `insert` is a HOST concern (paste the chip into the focused editor/composer),
+     * so the widget emits nothing for it — the host owns the composer and passes
+     * its own `onSelect` when it mounts the component directly. `navigate` is a
+     * plain drill-through on the configured href + the chip's value.
+     */
+    const onSelect = config.clickAction === 'navigate' && config.href !== undefined
+        ? (chip) => onEvent({ type: 'drill-through', href: `${config.href}${encodeURIComponent(chip.value ?? chip.label)}` })
+        : undefined;
+    return (_jsx(ChipCloud, { chips: cloudChipsOf(data), clickAction: config.clickAction, stagger: config.stagger, limit: config.limit, tone: tailToneOf(config.chipTone, 'neutral'), ...(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 }), ...(onSelect === undefined ? {} : { onSelect }) }));
+}
+//# sourceMappingURL=ChipCloud.js.map

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

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

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

@@ -0,0 +1,41 @@
+import { comparisonMatrixConfigSchema, comparisonMatrixDemoData } from './tables-tail-config.js';
+import type { ComparisonMatrixConfig } from './tables-tail-config.js';
+import type { ComparisonCell, ComparisonColumn, ComparisonMatrixData, ComparisonRow } from './tables-tail-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { comparisonMatrixConfigSchema, comparisonMatrixDemoData };
+export type { ComparisonMatrixConfig, ComparisonCell, ComparisonColumn, ComparisonMatrixData, ComparisonRow };
+/**
+ * `comparison-matrix` (annex §3) — the plan/feature grid: a sticky multi-column
+ * header, grouped category bands, cells rendering a check / an em-dash / mono
+ * text, and one column visually promoted (Pricing, Billing & Usage's plan grid).
+ *
+ * A CSS grid pseudo-table, not a `<table>` — the same call the family's
+ * `data-grid` makes — with explicit ARIA table roles so the semantics survive
+ * the layout choice. The header is `sticky top-0`: `top` is the BLOCK-axis
+ * inset, which does not mirror under RTL and is therefore correct as a physical
+ * utility here (the grid scrolls vertically; the inline axis is what mirrors,
+ * and that is handled by the logical `text-start`/`ps-*` utilities below).
+ *
+ * The promoted column is marked with `data-promoted` + a soft accent wash so the
+ * emphasis is a tone, never a hard-coded colour.
+ */
+export interface ComparisonMatrixProps {
+    columns: readonly ComparisonColumn[];
+    rows: readonly ComparisonRow[];
+    /** Ordered category bands; unlisted bands follow in first-seen order. */
+    groups?: readonly string[] | undefined;
+    promotedColumn?: string | undefined;
+    promotedLabel?: string | undefined;
+    includedLabel?: string | undefined;
+    notIncludedLabel?: string | undefined;
+    locale?: string | undefined;
+    testId?: string | undefined;
+}
+export declare function ComparisonMatrix({ columns, rows, groups, promotedColumn, promotedLabel, includedLabel, notIncludedLabel, locale, testId, }: ComparisonMatrixProps): import("react").JSX.Element;
+/**
+ * Project an untrusted payload onto the matrix shape (annex: "static or
+ * config-driven"), honouring the config's column allow-list/order.
+ */
+export declare function comparisonDataOf(data: unknown, config: ComparisonMatrixConfig): ComparisonMatrixData;
+export declare function ComparisonMatrixWidget({ config, data }: WidgetProps<ComparisonMatrixConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ComparisonMatrix.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComparisonMatrix.d.ts","sourceRoot":"","sources":["../../../src/families/tables/ComparisonMatrix.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,aAAa,EAAE,CAAC;AAE9G;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/B,yEAAyE;IACzE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAwDD,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,IAAI,EACJ,MAAM,EACN,cAAc,EACd,aAAa,EACb,aAA0B,EAC1B,gBAAiC,EACjC,MAAM,EACN,MAAM,GACP,EAAE,qBAAqB,+BAgGvB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,sBAAsB,GAAG,oBAAoB,CAcpG;AAED,wBAAgB,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,sBAAsB,CAAC,+BAa3F"}

package/dist/families/tables/ComparisonMatrix.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { MonoText, Tag } from '@adminium/ui';
+import { Check } from 'lucide-react';
+import { comparisonMatrixConfigSchema, comparisonMatrixDemoData } from './tables-tail-config.js';
+import { resolveLocale } from './tables-tail-lib.js';
+export { comparisonMatrixConfigSchema, comparisonMatrixDemoData };
+/**
+ * Band order: the ungrouped bucket first, then the configured `groups` in their
+ * configured order, then any band the rows add that the config never listed.
+ *
+ * The ungrouped bucket is hoisted deliberately. It is not a band — it is the
+ * un-banded preamble (a plan grid's headline rows), and it carries no group
+ * name, so it can never appear in `groups`. Ordering it by first-seen instead
+ * would strand those rows AFTER the configured bands the moment an author lists
+ * any group at all.
+ */
+function bandsOf(rows, groups) {
+    const seen = [];
+    for (const row of rows) {
+        const band = row.group ?? '';
+        if (!seen.includes(band))
+            seen.push(band);
+    }
+    if (groups === undefined)
+        return seen;
+    const lead = seen.includes('') ? [''] : [];
+    const ordered = groups.filter((group) => seen.includes(group));
+    return [...lead, ...ordered, ...seen.filter((band) => band !== '' && !ordered.includes(band))];
+}
+function Cell({ value, includedLabel, notIncludedLabel, }) {
+    if (value === true) {
+        return (_jsxs(_Fragment, { children: [_jsx(Check, { "aria-hidden": "true", className: "mx-auto size-4 text-pos" }), _jsx("span", { className: "sr-only", children: includedLabel })] }));
+    }
+    if (value === false || value === undefined) {
+        return (_jsxs(_Fragment, { children: [_jsx("span", { "aria-hidden": "true", className: "text-fg-subtle", children: "\u2014" }), _jsx("span", { className: "sr-only", children: notIncludedLabel })] }));
+    }
+    return _jsx(MonoText, { className: "text-caption font-semibold text-fg", children: value });
+}
+export function ComparisonMatrix({ columns, rows, groups, promotedColumn, promotedLabel, includedLabel = 'Included', notIncludedLabel = 'Not included', locale, testId, }) {
+    void resolveLocale(locale); // normalize at the boundary (see tables-tail-lib)
+    const bands = bandsOf(rows, groups);
+    // A feature label column + one column per compared plan.
+    const template = `minmax(10rem, 1.6fr) repeat(${columns.length}, minmax(5rem, 1fr))`;
+    return (_jsxs("div", { "data-widget": "comparison-matrix", "data-testid": testId, role: "table", className: "h-full overflow-auto", children: [_jsxs("div", { role: "row", className: "sticky top-0 z-10 grid items-end gap-x-2 border-b border-border bg-surface-1 px-3 py-2.5 grid-cols-[var(--cmp-cols)]", style: { '--cmp-cols': template }, children: [_jsx("span", { role: "columnheader", className: "text-caption font-bold uppercase tracking-wide text-fg-subtle" }), columns.map((column) => {
+                        const promoted = column.id === promotedColumn;
+                        return (_jsxs("span", { role: "columnheader", "data-part": "cmp-col", "data-promoted": promoted ? '' : undefined, className: `flex flex-col items-center gap-0.5 rounded-t-md px-2 py-1 text-center ${promoted ? 'bg-accent-soft' : ''}`, children: [promoted && promotedLabel !== undefined && (_jsx(Tag, { tone: "accent", className: "mb-0.5 uppercase", children: promotedLabel })), _jsx("span", { className: `text-body-sm font-bold ${promoted ? 'text-accent' : 'text-fg'}`, children: column.label }), column.meta !== undefined && (_jsx(MonoText, { className: "text-caption text-fg-muted", children: column.meta }))] }, column.id));
+                    })] }), bands.map((band) => (_jsxs("div", { "data-part": "cmp-band", "data-band": band === '' ? undefined : band, children: [band !== '' && (_jsx("div", { role: "row", className: "bg-surface-2 px-3 py-1.5", children: _jsx("span", { role: "rowheader", className: "text-caption font-bold uppercase tracking-wide text-fg-muted", children: band }) })), rows
+                        .filter((row) => (row.group ?? '') === band)
+                        .map((row) => (_jsxs("div", { role: "row", "data-part": "cmp-row", className: "grid items-center gap-x-2 border-b border-border/60 px-3 py-2 last:border-b-0 grid-cols-[var(--cmp-cols)]", style: { '--cmp-cols': template }, children: [_jsx("span", { role: "rowheader", className: "truncate text-start text-body-sm text-fg", children: row.label }), columns.map((column) => {
+                                const promoted = column.id === promotedColumn;
+                                return (_jsx("span", { role: "cell", "data-part": "cmp-cell", "data-promoted": promoted ? '' : undefined, className: `flex items-center justify-center px-2 py-1 text-center ${promoted ? 'bg-accent-soft/40' : ''}`, children: _jsx(Cell, { value: row.cells[column.id], includedLabel: includedLabel, notIncludedLabel: notIncludedLabel }) }, column.id));
+                            })] }, row.id)))] }, band === '' ? '__ungrouped' : band)))] }));
+}
+/**
+ * Project an untrusted payload onto the matrix shape (annex: "static or
+ * config-driven"), honouring the config's column allow-list/order.
+ */
+export function comparisonDataOf(data, config) {
+    const envelope = (typeof data === 'object' && data !== null ? data : {});
+    const rawColumns = Array.isArray(envelope.columns) ? envelope.columns : [];
+    const rawRows = Array.isArray(envelope.rows) ? envelope.rows : [];
+    const allow = config.columns;
+    const columns = allow === undefined || allow.length === 0
+        ? rawColumns
+        : allow.flatMap((id) => rawColumns.filter((column) => column.id === id));
+    return {
+        columns,
+        rows: rawRows,
+        ...(config.groups === undefined ? (envelope.groups === undefined ? {} : { groups: envelope.groups }) : { groups: config.groups }),
+    };
+}
+export function ComparisonMatrixWidget({ config, data }) {
+    const matrix = comparisonDataOf(data, config);
+    return (_jsx(ComparisonMatrix, { columns: matrix.columns, rows: matrix.rows, ...(matrix.groups === undefined ? {} : { groups: matrix.groups }), ...(config.promotedColumn === undefined ? {} : { promotedColumn: config.promotedColumn }), ...(config.promotedLabel === undefined ? {} : { promotedLabel: config.promotedLabel }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.testId === undefined ? {} : { testId: config.testId }) }));
+}
+//# sourceMappingURL=ComparisonMatrix.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComparisonMatrix.js","sourceRoot":"","sources":["../../../src/families/tables/ComparisonMatrix.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AASrD,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,CAAC;AAgClE;;;;;;;;;GASG;AACH,SAAS,OAAO,CAAC,IAA8B,EAAE,MAAqC;IACpF,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,IAAI,CAAC,EACZ,KAAK,EACL,aAAa,EACb,gBAAgB,GAKjB;IACC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,CACL,8BACE,KAAC,KAAK,mBAAa,MAAM,EAAC,SAAS,EAAC,yBAAyB,GAAG,EAChE,eAAM,SAAS,EAAC,SAAS,YAAE,aAAa,GAAQ,IAC/C,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO,CACL,8BAGE,8BAAkB,MAAM,EAAC,SAAS,EAAC,gBAAgB,uBAE5C,EACP,eAAM,SAAS,EAAC,SAAS,YAAE,gBAAgB,GAAQ,IAClD,CACJ,CAAC;IACJ,CAAC;IACD,OAAO,KAAC,QAAQ,IAAC,SAAS,EAAC,oCAAoC,YAAE,KAAK,GAAY,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAC/B,OAAO,EACP,IAAI,EACJ,MAAM,EACN,cAAc,EACd,aAAa,EACb,aAAa,GAAG,UAAU,EAC1B,gBAAgB,GAAG,cAAc,EACjC,MAAM,EACN,MAAM,GACgB;IACtB,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,kDAAkD;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,yDAAyD;IACzD,MAAM,QAAQ,GAAG,+BAA+B,OAAO,CAAC,MAAM,sBAAsB,CAAC;IAErF,OAAO,CACL,8BACc,mBAAmB,iBAClB,MAAM,EACnB,IAAI,EAAC,OAAO,EACZ,SAAS,EAAC,sBAAsB,aAEhC,eACE,IAAI,EAAC,KAAK,EACV,SAAS,EAAC,sHAAsH,EAChI,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,aAEjC,eAAM,IAAI,EAAC,cAAc,EAAC,SAAS,EAAC,+DAA+D,GAG5F,EACN,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;wBACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,KAAK,cAAc,CAAC;wBAC9C,OAAO,CACL,gBAEE,IAAI,EAAC,cAAc,eACT,SAAS,mBACJ,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACxC,SAAS,EAAE,yEACT,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAChC,EAAE,aAED,QAAQ,IAAI,aAAa,KAAK,SAAS,IAAI,CAC1C,KAAC,GAAG,IAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,kBAAkB,YAC5C,aAAa,GACV,CACP,EACD,eAAM,SAAS,EAAE,0BAA0B,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAAE,YAAG,MAAM,CAAC,KAAK,GAAQ,EACvG,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAC5B,KAAC,QAAQ,IAAC,SAAS,EAAC,4BAA4B,YAAE,MAAM,CAAC,IAAI,GAAY,CAC1E,KAhBI,MAAM,CAAC,EAAE,CAiBT,CACR,CAAC;oBACJ,CAAC,CAAC,IACE,EAEL,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,4BAAwD,UAAU,eAAY,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,aACzG,IAAI,KAAK,EAAE,IAAI,CACd,cAAK,IAAI,EAAC,KAAK,EAAC,SAAS,EAAC,0BAA0B,YAClD,eAAM,IAAI,EAAC,WAAW,EAAC,SAAS,EAAC,8DAA8D,YAC5F,IAAI,GACA,GACH,CACP,EACA,IAAI;yBACF,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;yBAC3C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACZ,eAEE,IAAI,EAAC,KAAK,eACA,SAAS,EACnB,SAAS,EAAC,2GAA2G,EACrH,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,aAEjC,eAAM,IAAI,EAAC,WAAW,EAAC,SAAS,EAAC,0CAA0C,YACxE,GAAG,CAAC,KAAK,GACL,EACN,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gCACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,KAAK,cAAc,CAAC;gCAC9C,OAAO,CACL,eAEE,IAAI,EAAC,MAAM,eACD,UAAU,mBACL,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACxC,SAAS,EAAE,0DACT,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EACnC,EAAE,YAEF,KAAC,IAAI,IACH,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAC3B,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,gBAAgB,GAClC,IAZG,MAAM,CAAC,EAAE,CAaT,CACR,CAAC;4BACJ,CAAC,CAAC,KA5BG,GAAG,CAAC,EAAE,CA6BP,CACP,CAAC,KA1CI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CA2CtC,CACP,CAAC,IACE,CACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa,EAAE,MAA8B;IAC5E,MAAM,QAAQ,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAkC,CAAC;IAC1G,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;IAC7B,MAAM,OAAO,GACX,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QACvC,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO;QACL,OAAO;QACP,IAAI,EAAE,OAAO;QACb,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;KAClI,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAuC;IAC1F,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,CACL,KAAC,gBAAgB,IACf,OAAO,EAAE,MAAM,CAAC,OAAO,EACvB,IAAI,EAAE,MAAM,CAAC,IAAI,KACb,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,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,KACtF,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,KACnF,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,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAClE,CACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,50 @@
+import type { ReactNode } from 'react';
+import type { CellContext } from './cells.js';
+import type { GridColumnSpec, GridRow } from './column-spec.js';
+/**
+ * `data-grid` — the canonical CRUD table (annex §3): headless
+ * @tanstack/react-table over ui primitives, CSS-grid-free `<table>`-less
+ * layout is NOT required — we keep semantic rows via div grid per comp
+ * (uppercase letter-spaced micro headers on `--surface-2`, hover highlight,
+ * selected tint, checkbox multi-select, type-aware cells).
+ *
+ * Sorting: with `onSortChange` the grid is server-sorted (manualSorting —
+ * the host reissues the query, 09 §7.1); without it, a client-side
+ * type-aware sort applies `compareCellValues`, which coerces numeric columns
+ * through `Number()` — the Data Table string-mrr defect fix
+ * (research/ia-mapping.md §5).
+ */
+export interface DataGridSort {
+    column: string;
+    dir: 'asc' | 'desc';
+}
+export interface DataGridProps {
+    columns: readonly GridColumnSpec[];
+    rows: readonly GridRow[];
+    /** Stable row id; defaults to the specs' PK columns (`rowIdOf`). */
+    rowId?: ((row: GridRow) => string) | undefined;
+    /** Current sort (server mode) or initial sort (client mode). */
+    sort?: DataGridSort | null | undefined;
+    /** Server-sort callback — presence switches the grid to manual sorting. */
+    onSortChange?: ((sort: DataGridSort | null) => void) | undefined;
+    /** Checkbox multi-select. */
+    selectable?: boolean | undefined;
+    selected?: ReadonlySet<string> | undefined;
+    onSelectedChange?: ((ids: ReadonlySet<string>) => void) | undefined;
+    /** Row click → detail (09 §7.1 `rowAction: detail`). */
+    onRowOpen?: ((row: GridRow) => void) | undefined;
+    /** Cell context: FK `record-open` events, PII unmask, format overrides. */
+    cellContext?: CellContext | undefined;
+    density?: 'comfortable' | 'compact' | undefined;
+    /** Trailing per-row slot (kebab menu). */
+    rowEnd?: ((row: GridRow) => ReactNode) | undefined;
+    /** Accessible labels (i18n). */
+    labels?: {
+        selectAll?: string | undefined;
+        selectRow?: string | undefined;
+        sortBy?: string | undefined;
+    } | undefined;
+    testId?: string | undefined;
+}
+export declare function DataGrid({ columns, rows, rowId, sort, onSortChange, selectable, selected, onSelectedChange, onRowOpen, cellContext, density, rowEnd, labels, testId, }: DataGridProps): import("react").JSX.Element;
+//# sourceMappingURL=DataGrid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataGrid.d.ts","sourceRoot":"","sources":["../../../src/families/tables/DataGrid.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhE;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,KAAK,GAAG,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,oEAAoE;IACpE,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IAC/C,gEAAgE;IAChE,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACjE,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3C,gBAAgB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpE,wDAAwD;IACxD,SAAS,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACjD,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,0CAA0C;IAC1C,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;IACnD,gCAAgC;IAChC,MAAM,CAAC,EACH;QACE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7B,GACD,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAID,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,UAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,OAAuB,EACvB,MAAM,EACN,MAAM,EACN,MAAM,GACP,EAAE,aAAa,+BA6Lf"}

package/dist/families/tables/DataGrid.js

@@ -0,0 +1,89 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Checkbox } from '@adminium/ui';
+import { createColumnHelper, flexRender, getCoreRowModel, getSortedRowModel, useReactTable, } from '@tanstack/react-table';
+import { ArrowDown, ArrowUp, ChevronsUpDown } from 'lucide-react';
+import { useMemo, useState } from 'react';
+import { CellValue, cellAlignClass } from './cells.js';
+import { compareCellValues, rowIdOf } from './column-spec.js';
+const columnHelper = createColumnHelper();
+export function DataGrid({ columns, rows, rowId, sort, onSortChange, selectable = false, selected, onSelectedChange, onRowOpen, cellContext, density = 'comfortable', rowEnd, labels, testId, }) {
+    const manualSorting = onSortChange !== undefined;
+    const visibleSpecs = useMemo(() => columns.filter((column) => !column.hidden), [columns]);
+    const getRowId = useMemo(() => rowId ?? ((row) => rowIdOf(columns, row)), [rowId, columns]);
+    const tableColumns = useMemo(() => visibleSpecs.map((spec) => columnHelper.accessor((row) => row[spec.name], {
+        id: spec.name,
+        enableSorting: spec.sortable,
+        // Client-mode type-aware comparator (numeric fix — never lexicographic).
+        sortingFn: (a, b) => compareCellValues(spec, a.original[spec.name], b.original[spec.name]),
+        header: () => spec.label,
+        cell: (info) => _jsx(CellValue, { column: spec, row: info.row.original, context: cellContext ?? {} }),
+    })), [visibleSpecs, cellContext]);
+    const controlledSorting = useMemo(() => (sort === null || sort === undefined ? [] : [{ id: sort.column, desc: sort.dir === 'desc' }]), [sort]);
+    // Client mode (no onSortChange): the grid owns its sorting state — `sort`
+    // only seeds the initial order (the controlled prop would otherwise pin the
+    // rows to server order and clicks would never reorder).
+    const [clientSorting, setClientSorting] = useState(controlledSorting);
+    const sortingState = manualSorting ? controlledSorting : clientSorting;
+    const rowSelection = useMemo(() => {
+        const state = {};
+        if (selected !== undefined)
+            for (const id of selected)
+                state[id] = true;
+        return state;
+    }, [selected]);
+    const table = useReactTable({
+        data: rows,
+        columns: tableColumns,
+        getRowId,
+        state: { sorting: sortingState, rowSelection },
+        manualSorting,
+        enableRowSelection: selectable,
+        onRowSelectionChange: (updater) => {
+            const next = typeof updater === 'function' ? updater(rowSelection) : updater;
+            onSelectedChange?.(new Set(Object.keys(next).filter((id) => next[id] === true)));
+        },
+        onSortingChange: (updater) => {
+            const next = typeof updater === 'function' ? updater(sortingState) : updater;
+            if (manualSorting) {
+                const head = next[0];
+                onSortChange?.(head === undefined ? null : { column: head.id, dir: head.desc ? 'desc' : 'asc' });
+            }
+            else {
+                setClientSorting(next);
+            }
+        },
+        getCoreRowModel: getCoreRowModel(),
+        ...(manualSorting ? {} : { getSortedRowModel: getSortedRowModel() }),
+    });
+    const rowPad = density === 'compact' ? 'px-3 py-1.5' : 'px-3 py-2.5';
+    const headerRows = table.getHeaderGroups();
+    const bodyRows = table.getRowModel().rows;
+    const allSelected = selectable && bodyRows.length > 0 && bodyRows.every((row) => row.getIsSelected());
+    const someSelected = selectable && bodyRows.some((row) => row.getIsSelected());
+    return (_jsxs("div", { "data-testid": testId, "data-part": "data-grid", role: "table", "aria-rowcount": rows.length, className: "min-w-full overflow-x-auto", children: [headerRows.map((headerGroup) => (_jsxs("div", { role: "row", className: "flex items-center border-b border-border bg-surface-2", children: [selectable && (_jsx("div", { role: "columnheader", className: "flex w-10 shrink-0 items-center justify-center py-2", children: _jsx(Checkbox, { "aria-label": labels?.selectAll ?? 'Select all rows', checked: allSelected ? true : someSelected ? 'indeterminate' : false, onCheckedChange: (checked) => {
+                                const next = new Set();
+                                if (checked === true)
+                                    for (const row of bodyRows)
+                                        next.add(row.id);
+                                onSelectedChange?.(next);
+                            } }) })), headerGroup.headers.map((header) => {
+                        const spec = visibleSpecs.find((candidate) => candidate.name === header.column.id);
+                        const sorted = header.column.getIsSorted();
+                        const sortable = header.column.getCanSort();
+                        const label = flexRender(header.column.columnDef.header, header.getContext());
+                        const headerText = (_jsx("span", { className: "truncate text-[10.5px] font-bold uppercase tracking-[0.08em] text-fg-muted", children: label }));
+                        return (_jsx("div", { role: "columnheader", "aria-sort": sorted === 'asc' ? 'ascending' : sorted === 'desc' ? 'descending' : undefined, className: `flex min-w-0 flex-1 items-center ${rowPad} ${cellAlignClass(spec)}`, children: sortable ? (_jsxs("button", { type: "button", onClick: header.column.getToggleSortingHandler(), "aria-label": `${labels?.sortBy ?? 'Sort by'} ${spec.label}`, className: "group inline-flex min-w-0 items-center gap-1 rounded focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: [headerText, sorted === 'asc' ? (_jsx(ArrowUp, { className: "size-3 shrink-0 text-accent", "aria-hidden": "true" })) : sorted === 'desc' ? (_jsx(ArrowDown, { className: "size-3 shrink-0 text-accent", "aria-hidden": "true" })) : (_jsx(ChevronsUpDown, { className: "size-3 shrink-0 text-fg-subtle opacity-0 group-hover:opacity-100", "aria-hidden": "true" }))] })) : (headerText) }, header.id));
+                    }), rowEnd !== undefined && _jsx("div", { role: "columnheader", className: "w-10 shrink-0" })] }, headerGroup.id))), _jsx("div", { role: "rowgroup", className: "divide-y divide-border", children: bodyRows.map((row) => {
+                    const isSelected = row.getIsSelected();
+                    return (_jsxs("div", { role: "row", "aria-selected": selectable ? isSelected : undefined, "data-selected": isSelected ? '' : undefined, onClick: onRowOpen === undefined ? undefined : () => onRowOpen(row.original), onKeyDown: onRowOpen === undefined
+                            ? undefined
+                            : (event) => {
+                                if (event.key === 'Enter' && event.target === event.currentTarget)
+                                    onRowOpen(row.original);
+                            }, tabIndex: onRowOpen === undefined ? undefined : 0, className: `flex items-center transition-colors ${isSelected ? 'bg-accent-soft/60' : 'hover:bg-surface-2/60'} ${onRowOpen === undefined ? '' : 'cursor-pointer focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent'}`, children: [selectable && (_jsx("div", { role: "cell", className: "flex w-10 shrink-0 items-center justify-center py-2", onClick: (event) => event.stopPropagation(), children: _jsx(Checkbox, { "aria-label": labels?.selectRow ?? 'Select row', checked: isSelected, onCheckedChange: () => row.toggleSelected() }) })), row.getVisibleCells().map((cell) => {
+                                const spec = visibleSpecs.find((candidate) => candidate.name === cell.column.id);
+                                return (_jsx("div", { role: "cell", "data-column": spec.name, className: `flex min-w-0 flex-1 items-center text-body-sm text-fg ${rowPad} ${cellAlignClass(spec)}`, children: flexRender(cell.column.columnDef.cell, cell.getContext()) }, cell.id));
+                            }), rowEnd !== undefined && (_jsx("div", { role: "cell", className: "flex w-10 shrink-0 items-center justify-center", onClick: (event) => event.stopPropagation(), children: rowEnd(row.original) }))] }, row.id));
+                }) })] }));
+}
+//# sourceMappingURL=DataGrid.js.map

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

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

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

@@ -0,0 +1,18 @@
+import type { CellContext } from './cells.js';
+import type { GridColumnSpec, GridRow } from './column-spec.js';
+/**
+ * `detail-key-value` (annex §3) — record fields as label/value rows driven by
+ * column specs: mono per-field, FK values as chips (via the shared cell
+ * renderers), key-field emphasis (09 §8.3), optional column-type tags so the
+ * generated UI explains itself (09 §7.1 form keeper, reused on detail).
+ */
+export interface DetailKeyValueProps {
+    columns: readonly GridColumnSpec[];
+    record: GridRow;
+    cellContext?: CellContext | undefined;
+    /** Show mono type tags (`varchar`, `enum`, `→ public.team_members`). */
+    showTypeTags?: boolean | undefined;
+    testId?: string | undefined;
+}
+export declare function DetailKeyValue({ columns, record, cellContext, showTypeTags, testId, }: DetailKeyValueProps): import("react").JSX.Element;
+//# sourceMappingURL=DetailKeyValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DetailKeyValue.d.ts","sourceRoot":"","sources":["../../../src/families/tables/DetailKeyValue.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhE;;;;;GAKG;AAEH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,wEAAwE;IACxE,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAQD,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,MAAM,EACN,WAAW,EACX,YAAoB,EACpB,MAAM,GACP,EAAE,mBAAmB,+BAwBrB"}