@adminiumjs/widgets 0.1.0-rc.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"PaginationFooter.js","sourceRoot":"","sources":["../../../src/families/tables/PaginationFooter.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAgC7D,MAAM,UAAU,gBAAgB,CAAC,EAC/B,UAAU,EACV,QAAQ,EACR,KAAK,EACL,OAAO,EACP,OAAO,EACP,MAAM,EACN,MAAM,EACN,QAAQ,EACR,eAAe,GAAG,iBAAiB,EACnC,gBAAgB,EAChB,QAAQ,GAAG,KAAK,EAChB,MAAM,EACN,MAAM,EACN,MAAM,GACgB;IACtB,4EAA4E;IAC5E,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,QAAQ,KAAK,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,KAAK;QACrB,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,IAAI,QAAQ,CAAC;QAC7B,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAC/C,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,EAAE,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAC1F,EAAE,CAAC;IAEP,OAAO,CACL,4BACY,mBAAmB,iBAChB,MAAM,EACnB,SAAS,EAAC,qFAAqF,aAE/F,KAAC,QAAQ,iBAAW,kBAAkB,EAAC,SAAS,EAAC,4BAA4B,YAC1E,SAAS,GACD,EACX,eAAK,SAAS,EAAC,yBAAyB,aACtC,iBAAO,SAAS,EAAC,sDAAsD,aACpE,MAAM,EAAE,QAAQ,IAAI,MAAM,EAC3B,KAAC,MAAM,kBACO,MAAM,EAAE,QAAQ,IAAI,eAAe,EAC/C,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,EACvB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EACjE,SAAS,EAAC,kBAAkB,YAE3B,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAC7B,iBAAmB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,YACnC,IAAI,IADM,IAAI,CAER,CACV,CAAC,GACK,IACH,EACR,eAAK,SAAS,EAAC,yBAAyB,aACtC,KAAC,UAAU,IACT,IAAI,EAAC,IAAI,EACT,KAAK,EAAE,MAAM,EAAE,IAAI,IAAI,eAAe,EACtC,QAAQ,EAAE,QAAQ,IAAI,CAAC,OAAO,EAC9B,OAAO,EAAE,MAAM,YAEf,KAAC,WAAW,IAAC,SAAS,EAAC,2BAA2B,GAAG,GAC1C,EACb,KAAC,UAAU,IACT,IAAI,EAAC,IAAI,EACT,KAAK,EAAE,MAAM,EAAE,IAAI,IAAI,WAAW,EAClC,QAAQ,EAAE,QAAQ,IAAI,CAAC,OAAO,EAC9B,OAAO,EAAE,MAAM,YAEf,KAAC,YAAY,IAAC,SAAS,EAAC,2BAA2B,GAAG,GAC3C,IACT,IACF,IACF,CACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,41 @@
+import type { Tone } from '@adminium/ui';
+import { rankedEntityListConfigSchema, rankedEntityListDemoData } from './tables-tail-config.js';
+import type { RankedEntityListConfig } from './tables-tail-config.js';
+import type { RankedEntity } from './tables-tail-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { rankedEntityListConfigSchema, rankedEntityListDemoData };
+export type { RankedEntityListConfig, RankedEntity };
+/**
+ * `ranked-entity-list` (annex §3) — rank number, name, value, and a proportional
+ * accent bar (Adminium UI Kit's "top regions", Analytics). Clicking a row can
+ * drive a SIBLING widget (the annex's "map flyTo"): the widget emits the row's
+ * key as a `drill-through`, and the host owns the cross-widget wiring — a widget
+ * never reaches into another widget.
+ *
+ * The bar is scaled against the LARGEST value in the visible slice, not the
+ * grand total, so the leader always fills the track and the rest read as a share
+ * of the leader — the comparison the design makes. `rankRows` still carries the
+ * total-relative `share` for the `percent` value format.
+ *
+ * The bar is a background layer behind the row text (`-z-10` under a relative
+ * row) rather than a sibling column, so long entity names stay full-width and
+ * truncate normally instead of being squeezed by the widest bar.
+ */
+export interface RankedEntityListProps {
+    rows: readonly RankedEntity[];
+    n?: number | undefined;
+    showBar?: boolean | undefined;
+    tone?: Tone | undefined;
+    valueFormat?: 'number' | 'compact' | 'percent' | 'currency' | undefined;
+    currency?: string | undefined;
+    locale?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onSelect?: ((row: RankedEntity) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function RankedEntityList({ rows, n, showBar, tone, valueFormat, currency, locale, emptyTitle, emptyBody, onSelect, testId, }: RankedEntityListProps): import("react").JSX.Element;
+/** Project an untrusted `record-list` onto `RankedEntity`s (04 §3). */
+export declare function rankedEntitiesOf(data: unknown): RankedEntity[];
+export declare function RankedEntityListWidget({ config, data, onEvent }: WidgetProps<RankedEntityListConfig>): import("react").JSX.Element;
+//# sourceMappingURL=RankedEntityList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RankedEntityList.d.ts","sourceRoot":"","sources":["../../../src/families/tables/RankedEntityList.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAWtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,CAAC;AAYrD;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IAC9B,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,CAAK,EACL,OAAc,EACd,IAAe,EACf,WAAuB,EACvB,QAAQ,EACR,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,MAAM,GACP,EAAE,qBAAqB,+BAmEvB;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,EAAE,CAW9D;AAED,wBAAgB,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,sBAAsB,CAAC,+BAmCpG"}

package/dist/families/tables/RankedEntityList.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { EmptyState, MonoText } from '@adminium/ui';
+import { rankedEntityListConfigSchema, rankedEntityListDemoData } from './tables-tail-config.js';
+import { formatMetricValue, formatRank, numberField, rankRows, resolveLocale, stringField, tailRowsOf, tailToneOf, } from './tables-tail-lib.js';
+export { rankedEntityListConfigSchema, rankedEntityListDemoData };
+/** Tone → the proportional bar's soft fill (the row track stays surface-2). */
+const BAR_TONE = {
+    neutral: 'bg-fg-subtle/25',
+    accent: 'bg-accent/25',
+    pos: 'bg-pos/25',
+    warn: 'bg-warn/25',
+    danger: 'bg-danger/25',
+    info: 'bg-info/25',
+};
+export function RankedEntityList({ rows, n = 6, showBar = true, tone = 'accent', valueFormat = 'compact', currency, locale, emptyTitle, emptyBody, onSelect, testId, }) {
+    const tag = resolveLocale(locale);
+    const ranked = rankRows(rows, n);
+    if (ranked.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'Nothing ranked yet', body: emptyBody ?? 'Top entities will appear here once there is data to rank.' }));
+    }
+    return (_jsx("ol", { "data-widget": "ranked-entity-list", "data-testid": testId, className: "h-full overflow-auto px-2 py-1", children: ranked.map((row) => {
+            const rowTone = tailToneOf(row.tone, tone);
+            const value = valueFormat === 'percent'
+                ? formatMetricValue(row.share * 100, tag, { unit: '%' })
+                : formatMetricValue(row.value, tag, {
+                    compact: valueFormat === 'compact',
+                    ...(valueFormat === 'currency' && currency !== undefined ? { currency } : {}),
+                });
+            const content = (_jsxs(_Fragment, { children: [showBar && (
+                    /*
+                      The proportional bar. `inset-y-0` is the BLOCK-axis utility (NOT
+                      `inset-block-0`, which is not a Tailwind utility and silently
+                      emits no CSS); `start-0` is the logical inline start, so the bar
+                      grows from the row's leading edge and mirrors under RTL.
+                    */
+                    _jsx("span", { "aria-hidden": "true", "data-part": "rank-bar", className: `pointer-events-none absolute inset-y-0 start-0 -z-10 rounded-md ${BAR_TONE[rowTone]} w-[var(--rank-bar)]`, style: { '--rank-bar': `${row.pct}%` } })), _jsx(MonoText, { className: "w-6 shrink-0 text-caption font-bold text-fg-subtle", children: formatRank(row.rank, tag) }), _jsx("span", { className: "min-w-0 flex-1 truncate text-body-sm text-fg", children: row.name }), _jsx(MonoText, { className: "shrink-0 text-body-sm font-bold text-fg", children: value })] }));
+            return (_jsx("li", { "data-part": "rank-row", "data-rank": row.rank, className: "relative isolate", children: onSelect === undefined ? (_jsx("div", { className: "flex items-center gap-3 rounded-md px-2 py-2.5", children: content })) : (_jsx("button", { type: "button", onClick: () => onSelect(row), className: "flex w-full items-center gap-3 rounded-md px-2 py-2.5 text-start hover:bg-surface-2/60 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent", children: content })) }, row.id));
+        }) }));
+}
+/** Project an untrusted `record-list` onto `RankedEntity`s (04 §3). */
+export function rankedEntitiesOf(data) {
+    return tailRowsOf(data).map((row, index) => {
+        const id = row.id;
+        return {
+            id: typeof id === 'string' || typeof id === 'number' ? id : index,
+            name: stringField(row, 'name') ?? stringField(row, 'label') ?? `#${index + 1}`,
+            value: numberField(row, 'value') ?? numberField(row, 'count') ?? 0,
+            key: stringField(row, 'key'),
+            tone: stringField(row, 'tone'),
+        };
+    });
+}
+export function RankedEntityListWidget({ config, data, onEvent }) {
+    /*
+     * Row click → a `drill-through` carrying the row key. `linkTarget` names the
+     * SIBLING widget instance the host should drive (annex: "row click can drive
+     * sibling widget (map flyTo)"), so it rides the href as a fragment the host
+     * resolves; with neither `linkTarget` nor `href` the rows stay inert (and
+     * render as plain divs, not dead buttons).
+     */
+    const target = config.linkTarget;
+    const href = config.href;
+    const onSelect = target === undefined && href === undefined
+        ? undefined
+        : (row) => {
+            const key = row.key ?? String(row.id);
+            onEvent({
+                type: 'drill-through',
+                href: target === undefined ? href : `${href ?? ''}#${target}=${encodeURIComponent(key)}`,
+            });
+        };
+    return (_jsx(RankedEntityList, { rows: rankedEntitiesOf(data), n: config.n, showBar: config.showBar, valueFormat: config.valueFormat, ...(config.tone === undefined ? {} : { tone: tailToneOf(config.tone, 'accent') }), ...(config.format?.currency === undefined ? {} : { currency: config.format.currency }), ...(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=RankedEntityList.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RankedEntityList.js","sourceRoot":"","sources":["../../../src/families/tables/RankedEntityList.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,CAAC;AAGlE,+EAA+E;AAC/E,MAAM,QAAQ,GAAyB;IACrC,OAAO,EAAE,iBAAiB;IAC1B,MAAM,EAAE,cAAc;IACtB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,cAAc;IACtB,IAAI,EAAE,YAAY;CACnB,CAAC;AAiCF,MAAM,UAAU,gBAAgB,CAAC,EAC/B,IAAI,EACJ,CAAC,GAAG,CAAC,EACL,OAAO,GAAG,IAAI,EACd,IAAI,GAAG,QAAQ,EACf,WAAW,GAAG,SAAS,EACvB,QAAQ,EACR,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,MAAM,GACgB;IACtB,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CACL,KAAC,UAAU,IACT,OAAO,QACP,MAAM,EAAC,SAAS,EAChB,KAAK,EAAE,UAAU,IAAI,oBAAoB,EACzC,IAAI,EAAE,SAAS,IAAI,2DAA2D,GAC9E,CACH,CAAC;IACJ,CAAC;IAED,OAAO,CACL,4BAAgB,oBAAoB,iBAAc,MAAM,EAAE,SAAS,EAAC,gCAAgC,YACjG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAClB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC3C,MAAM,KAAK,GACT,WAAW,KAAK,SAAS;gBACvB,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;gBACxD,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE;oBAChC,OAAO,EAAE,WAAW,KAAK,SAAS;oBAClC,GAAG,CAAC,WAAW,KAAK,UAAU,IAAI,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9E,CAAC,CAAC;YACT,MAAM,OAAO,GAAG,CACd,8BACG,OAAO,IAAI;oBACV;;;;;sBAKE;oBACF,8BACc,MAAM,eACR,UAAU,EACpB,SAAS,EAAE,mEAAmE,QAAQ,CAAC,OAAO,CAAC,sBAAsB,EACrH,KAAK,EAAE,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,GACtC,CACH,EACD,KAAC,QAAQ,IAAC,SAAS,EAAC,oDAAoD,YACrE,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GACjB,EACX,eAAM,SAAS,EAAC,8CAA8C,YAAE,GAAG,CAAC,IAAI,GAAQ,EAChF,KAAC,QAAQ,IAAC,SAAS,EAAC,yCAAyC,YAAE,KAAK,GAAY,IAC/E,CACJ,CAAC;YACF,OAAO,CACL,0BAA2B,UAAU,eAAY,GAAG,CAAC,IAAI,EAAE,SAAS,EAAC,kBAAkB,YACpF,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,4KAA4K,YAErL,OAAO,GACD,CACV,IAXM,GAAG,CAAC,EAAE,CAYV,CACN,CAAC;QACJ,CAAC,CAAC,GACC,CACN,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAgB,EAAE;QACvD,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;QAClB,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,OAAO,CAAC,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE;YAC9E,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC;YAClE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC;YAC5B,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC;SAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAuC;IACnG;;;;;;OAMG;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;IACjC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,QAAQ,GACZ,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;QACxC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,CAAC,GAAiB,EAAE,EAAE;YACpB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC;gBACN,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAE,IAAe,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,IAAI,MAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE;aACrG,CAAC,CAAC;QACL,CAAC,CAAC;IACR,OAAO,CACL,KAAC,gBAAgB,IACf,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAC5B,CAAC,EAAE,MAAM,CAAC,CAAC,EACX,OAAO,EAAE,MAAM,CAAC,OAAO,EACvB,WAAW,EAAE,MAAM,CAAC,WAAW,KAC3B,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,KAC9E,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,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,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,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAChD,CACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { SchemaTreeConfig } from './tables-track-f-config.js';
+import type { SchemaNode } from './tables-track-f-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+/**
+ * `schema-tree` (annex §3) — an introspected hierarchy explorer:
+ * schema → tables (row counts, view badge) → columns with PK/FK/UQ badges and
+ * pg types. Binds to the `hierarchy/tree` shape from introspection metadata.
+ */
+export { schemaTreeConfigSchema, schemaTreeDemoData } from './tables-track-f-config.js';
+export type { SchemaTreeConfig } from './tables-track-f-config.js';
+export type { SchemaNode, SchemaNodeKind } from './tables-track-f-types.js';
+export interface SchemaTreeProps {
+    roots: readonly SchemaNode[];
+    expandDepth?: number | undefined;
+    showTypes?: boolean | undefined;
+    emptyTitle?: string | undefined;
+    locale?: string | undefined;
+    onSelect?: ((node: SchemaNode) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function SchemaTree({ roots, expandDepth, showTypes, emptyTitle, locale, onSelect, testId, }: SchemaTreeProps): import("react").JSX.Element;
+export declare function SchemaTreeWidget({ config, data, onEvent }: WidgetProps<SchemaTreeConfig>): import("react").JSX.Element;
+//# sourceMappingURL=SchemaTree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaTree.d.ts","sourceRoot":"","sources":["../../../src/families/tables/SchemaTree.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;GAIG;AAOH,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAmB5E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,WAAe,EACf,SAAgB,EAChB,UAAU,EACV,MAAM,EACN,QAAQ,EACR,MAAM,GACP,EAAE,eAAe,+BA0EjB;AAUD,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,gBAAgB,CAAC,+BAexF"}

package/dist/families/tables/SchemaTree.js

@@ -0,0 +1,89 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getFormatters } from '@adminium/i18n';
+import { EmptyState, Tag } from '@adminium/ui';
+import { ChevronRight, Columns3, Database, Eye, Table2 } from 'lucide-react';
+import { useMemo, useState } from 'react';
+/**
+ * `schema-tree` (annex §3) — an introspected hierarchy explorer:
+ * schema → tables (row counts, view badge) → columns with PK/FK/UQ badges and
+ * pg types. Binds to the `hierarchy/tree` shape from introspection metadata.
+ */
+// Config schema + deterministic demo payload live in the pure
+// `tables-track-f-config` module, and the node 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 { schemaTreeConfigSchema, schemaTreeDemoData } from './tables-track-f-config.js';
+const KIND_ICON = {
+    schema: _jsx(Database, { className: "size-3.5 text-fg-subtle" }),
+    table: _jsx(Table2, { className: "size-3.5 text-accent" }),
+    view: _jsx(Eye, { className: "size-3.5 text-info" }),
+    column: _jsx(Columns3, { className: "size-3.5 text-fg-subtle" }),
+};
+function collectOpen(nodes, depth, maxDepth, acc) {
+    if (depth > maxDepth)
+        return;
+    for (const node of nodes) {
+        if (node.children !== undefined && node.children.length > 0) {
+            acc.add(node.id);
+            collectOpen(node.children, depth + 1, maxDepth, acc);
+        }
+    }
+}
+export function SchemaTree({ roots, expandDepth = 1, showTypes = true, emptyTitle, locale, onSelect, testId, }) {
+    const initialOpen = useMemo(() => {
+        const set = new Set();
+        collectOpen(roots, 0, expandDepth, set);
+        return set;
+    }, [roots, expandDepth]);
+    const [open, setOpen] = useState(initialOpen);
+    const [selected, setSelected] = useState(undefined);
+    const numbers = getFormatters(locale ?? 'en-US');
+    if (roots.length === 0) {
+        return _jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'No schema introspected' });
+    }
+    const toggle = (id) => setOpen((prev) => {
+        const next = new Set(prev);
+        if (next.has(id))
+            next.delete(id);
+        else
+            next.add(id);
+        return next;
+    });
+    const renderNode = (node, depth) => {
+        const hasChildren = node.children !== undefined && node.children.length > 0;
+        const isOpen = open.has(node.id);
+        const isSelected = selected === node.id;
+        return (_jsxs("li", { role: "treeitem", "aria-expanded": hasChildren ? isOpen : undefined, "aria-selected": isSelected, children: [_jsxs("div", { tabIndex: 0, "data-selected": isSelected, onClick: () => {
+                        setSelected(node.id);
+                        onSelect?.(node);
+                        if (hasChildren)
+                            toggle(node.id);
+                    }, onKeyDown: (event) => {
+                        if (event.key === 'Enter' || event.key === ' ') {
+                            event.preventDefault();
+                            setSelected(node.id);
+                            onSelect?.(node);
+                            if (hasChildren)
+                                toggle(node.id);
+                        }
+                    }, className: "flex cursor-pointer items-center gap-1.5 rounded-md py-1 pe-2 text-body-sm data-[selected=true]:bg-accent-soft/60 hover:bg-surface-2/60 focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent ps-[calc(var(--adm-depth)*0.75rem+0.25rem)]", style: { '--adm-depth': String(depth) }, children: [_jsx(ChevronRight, { "aria-hidden": "true", className: `size-3 shrink-0 rtl:-scale-x-100 ${hasChildren ? 'text-fg-subtle' : 'invisible'} ${isOpen ? 'rotate-90 rtl:-rotate-90' : ''}` }), KIND_ICON[node.kind], _jsx("span", { className: `truncate ${node.kind === 'column' ? 'text-fg-muted' : 'font-medium text-fg'}`, children: node.label }), node.pk === true && _jsx(Tag, { tone: "accent", mono: true, children: "PK" }), node.fk === true && _jsx(Tag, { tone: "info", mono: true, children: "FK" }), node.unique === true && _jsx(Tag, { tone: "neutral", mono: true, children: "UQ" }), node.kind === 'view' && _jsx(Tag, { tone: "info", children: "view" }), showTypes && node.pgType !== undefined && _jsx(Tag, { tone: "neutral", mono: true, className: "ms-auto", children: node.pgType }), node.rowCount !== undefined && (_jsx("span", { className: "ms-auto font-mono text-caption tabular-nums text-fg-subtle", children: numbers.number(node.rowCount) }))] }), hasChildren && isOpen && (_jsx("ul", { role: "group", children: node.children?.map((child) => renderNode(child, depth + 1)) }))] }, node.id));
+    };
+    return (_jsx("ul", { role: "tree", "aria-label": "Schema", "data-widget": "schema-tree", "data-testid": testId, className: "h-full overflow-auto px-1.5 py-1.5", children: roots.map((node) => renderNode(node, 0)) }));
+}
+function rootsOf(data) {
+    if (typeof data === 'object' && data !== null && Array.isArray(data.roots)) {
+        return data.roots;
+    }
+    if (Array.isArray(data))
+        return data;
+    return [];
+}
+export function SchemaTreeWidget({ config, data, onEvent }) {
+    return (_jsx(SchemaTree, { roots: rootsOf(data), expandDepth: config.expandDepth, showTypes: config.showTypes, ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), onSelect: (node) => {
+            if (node.kind === 'table' || node.kind === 'view') {
+                onEvent({ type: 'drill-through', href: `#/schema/${node.id}` });
+            }
+        } }));
+}
+//# sourceMappingURL=SchemaTree.js.map

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

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

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

@@ -0,0 +1,35 @@
+import { sparklineTableConfigSchema, sparklineTableDemoData } from './tables-tail-config.js';
+import type { SparklineTableConfig } from './tables-tail-config.js';
+import type { SparkMetricRow } from './tables-tail-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { sparklineTableConfigSchema, sparklineTableDemoData };
+export type { SparklineTableConfig, SparkMetricRow };
+/**
+ * `sparkline-table` (annex §3) — metric rows: name + an 8-bar sparkline + a mono
+ * value + a good/bad-aware delta pill. The Analytics / Metrics Dashboard
+ * "metrics at a glance" panel, and the auto-instantiation target for a metrics
+ * table with a name column, a value column, and a period-over-period delta.
+ *
+ * "Good/bad aware" is the whole point of the row: a rising error rate is a
+ * DANGER pill even though the arrow points up, so the polarity comes from the
+ * metric's `goodDirection` (or the config's per-metric override) rather than
+ * from the sign — `DeltaPill`'s `invertGood` does the tone mapping.
+ *
+ * Read-only: the widget renders, it never writes and never fetches.
+ */
+export interface SparklineTableProps {
+    rows: readonly SparkMetricRow[];
+    limit?: number | undefined;
+    sparkWidth?: number | undefined;
+    sparkVariant?: 'bar' | 'line' | undefined;
+    goodDirectionByMetric?: Record<string, string> | undefined;
+    locale?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    testId?: string | undefined;
+}
+export declare function SparklineTable({ rows, limit, sparkWidth, sparkVariant, goodDirectionByMetric, locale, emptyTitle, emptyBody, testId, }: SparklineTableProps): import("react").JSX.Element;
+/** Project an untrusted `record-list` onto `SparkMetricRow`s (04 §3). */
+export declare function sparkRowsOf(data: unknown): SparkMetricRow[];
+export declare function SparklineTableWidget({ config, data }: WidgetProps<SparklineTableConfig>): import("react").JSX.Element;
+//# sourceMappingURL=SparklineTable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SparklineTable.d.ts","sourceRoot":"","sources":["../../../src/families/tables/SparklineTable.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAapE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,CAAC;AAErD;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1C,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAQD,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,KAAS,EACT,UAAe,EACf,YAAoB,EACpB,qBAAqB,EACrB,MAAM,EACN,UAAU,EACV,SAAS,EACT,MAAM,GACP,EAAE,mBAAmB,+BA2DrB;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,EAAE,CAe3D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,oBAAoB,CAAC,+BAcvF"}

package/dist/families/tables/SparklineTable.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Sparkline } from '@adminium/charts';
+import { DeltaPill, EmptyState, MonoText } from '@adminium/ui';
+import { sparklineTableConfigSchema, sparklineTableDemoData } from './tables-tail-config.js';
+import { formatDelta, formatMetricValue, goodDirectionFor, isBadMove, numberField, resolveLocale, seriesField, stringField, tailRowsOf, trendOf, } from './tables-tail-lib.js';
+export { sparklineTableConfigSchema, sparklineTableDemoData };
+/** Bad moves draw a danger spark, good moves a positive one (annex "good/bad aware"). */
+function sparkToneFor(delta, good) {
+    if (delta === undefined || delta === 0)
+        return 'muted';
+    return isBadMove(delta, good) ? 'danger' : 'positive';
+}
+export function SparklineTable({ rows, limit = 6, sparkWidth = 72, sparkVariant = 'bar', goodDirectionByMetric, locale, emptyTitle, emptyBody, testId, }) {
+    const tag = resolveLocale(locale);
+    const slice = rows.slice(0, limit);
+    if (slice.length === 0) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'No metrics to show', body: emptyBody ?? 'Metrics will appear here once there is data to summarize.' }));
+    }
+    return (_jsx("ul", { "data-widget": "sparkline-table", "data-testid": testId, className: "h-full overflow-auto px-2 py-1", children: slice.map((row) => {
+            const good = goodDirectionFor(row.name, row.goodDirection, goodDirectionByMetric);
+            const trend = trendOf(row.delta);
+            const value = formatMetricValue(row.value, tag, {
+                ...(row.currency === undefined ? {} : { currency: row.currency }),
+                ...(row.unit === undefined ? {} : { unit: row.unit }),
+                compact: true,
+            });
+            return (_jsxs("li", { "data-part": "spark-row", "data-metric": row.name, className: "flex items-center gap-3 border-b border-border/60 px-1.5 py-2.5 last:border-b-0", children: [_jsx("span", { className: "min-w-0 flex-1 truncate text-body-sm text-fg", children: row.name }), row.spark !== undefined && row.spark.length > 0 && (
+                    // Decorative: the row's value + delta already carry the meaning in
+                    // text, so an aria-label here would just double every row for a
+                    // screen reader (Sparkline is aria-hidden without `label`).
+                    _jsx(Sparkline, { data: row.spark, variant: sparkVariant, width: sparkWidth, height: 24, tone: sparkToneFor(row.delta, good), className: "shrink-0" })), _jsx(MonoText, { className: "shrink-0 text-body-sm font-bold text-fg", children: value }), _jsx("span", { className: "flex w-16 shrink-0 justify-end", children: row.delta !== undefined && (_jsx(DeltaPill, { "data-part": "spark-delta", trend: trend, invertGood: good === 'down', children: formatDelta(row.delta, tag) })) })] }, row.id));
+        }) }));
+}
+/** Project an untrusted `record-list` onto `SparkMetricRow`s (04 §3). */
+export function sparkRowsOf(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'),
+            goodDirection: stringField(row, 'goodDirection') === 'down' ? 'down' : 'up',
+            spark: seriesField(row, 'spark'),
+            currency: stringField(row, 'currency'),
+            unit: stringField(row, 'unit'),
+        };
+    });
+}
+export function SparklineTableWidget({ config, data }) {
+    return (_jsx(SparklineTable, { rows: sparkRowsOf(data), limit: config.rows, sparkWidth: config.sparkWidth, sparkVariant: config.sparkVariant, ...(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 }) }));
+}
+//# sourceMappingURL=SparklineTable.js.map

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

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

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

@@ -0,0 +1,26 @@
+import type { ToggleCellMode, ToggleMatrixConfig } from './tables-track-f-config.js';
+import type { MatrixData } from './tables-track-f-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+/**
+ * `toggle-matrix` (annex §3) — an interactive boolean grid (rows =
+ * permissions/events, columns = roles/channels/tables) built on the ui
+ * `ToggleMatrix` primitive: tri-state cells, locked columns, grouped iconized
+ * sections, and dirty diff dots. Powers RBAC, RLS, and notification matrices.
+ * Binds to the `matrix` shape; edits emit a mutation intent against
+ * `persistTarget`.
+ */
+export { toggleMatrixConfigSchema, toggleMatrixDemoData } from './tables-track-f-config.js';
+export type { ToggleMatrixConfig } from './tables-track-f-config.js';
+export type { MatrixColumn, MatrixData, MatrixRow } from './tables-track-f-types.js';
+export interface ToggleMatrixGridProps {
+    data: MatrixData;
+    cellMode?: ToggleCellMode;
+    rowHeader?: string | undefined;
+    matrixLabel?: string | undefined;
+    emptyTitle?: string | undefined;
+    onToggle?: ((rowId: string, colId: string, next: boolean) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function ToggleMatrixGrid({ data, cellMode: mode, rowHeader, matrixLabel, emptyTitle, onToggle, testId, }: ToggleMatrixGridProps): import("react").JSX.Element;
+export declare function ToggleMatrixWidget({ config, data, onEvent }: WidgetProps<ToggleMatrixConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ToggleMatrixWidget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleMatrixWidget.d.ts","sourceRoot":"","sources":["../../../src/families/tables/ToggleMatrixWidget.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;GAOG;AAOH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC5F,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAIrF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,QAAQ,EAAE,IAAe,EACzB,SAAS,EACT,WAAW,EACX,UAAU,EACV,QAAQ,EACR,MAAM,GACP,EAAE,qBAAqB,+BAiEvB;AAgBD,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,kBAAkB,CAAC,+BA0B5F"}

package/dist/families/tables/ToggleMatrixWidget.js

@@ -0,0 +1,95 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { EmptyState, ToggleMatrix } from '@adminium/ui';
+import { useMemo, useState } from 'react';
+/**
+ * `toggle-matrix` (annex §3) — an interactive boolean grid (rows =
+ * permissions/events, columns = roles/channels/tables) built on the ui
+ * `ToggleMatrix` primitive: tri-state cells, locked columns, grouped iconized
+ * sections, and dirty diff dots. Powers RBAC, RLS, and notification matrices.
+ * Binds to the `matrix` shape; edits emit a mutation intent against
+ * `persistTarget`.
+ */
+// Config schema + deterministic demo payload live in the pure
+// `tables-track-f-config` module, and the matrix shapes 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 { toggleMatrixConfigSchema, toggleMatrixDemoData } from './tables-track-f-config.js';
+const cellKey = (rowId, colId) => `${rowId}\u0000${colId}`;
+export function ToggleMatrixGrid({ data, cellMode: mode = 'toggle', rowHeader, matrixLabel, emptyTitle, onToggle, testId, }) {
+    const [overrides, setOverrides] = useState(new Map());
+    const groups = useMemo(() => {
+        const order = [];
+        const byGroup = new Map();
+        for (const row of data.rows) {
+            const key = row.group ?? '__ungrouped__';
+            if (!byGroup.has(key)) {
+                byGroup.set(key, []);
+                order.push(key);
+            }
+            byGroup.get(key)?.push(row);
+        }
+        return order.map((key) => ({
+            id: key,
+            ...(key === '__ungrouped__' ? {} : { label: key }),
+            rows: (byGroup.get(key) ?? []).map((row) => ({ id: row.id, label: row.label })),
+        }));
+    }, [data.rows]);
+    const columns = useMemo(() => data.columns.map((column) => ({ id: column.id, label: column.label, ...(column.locked === true ? { locked: true } : {}) })), [data.columns]);
+    if (data.rows.length === 0 || data.columns.length === 0) {
+        return _jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'No matrix configured' });
+    }
+    const baseState = (rowId, colId) => data.cells[rowId]?.[colId] === true;
+    const isLocked = (rowId, colId) => data.locked?.[rowId]?.[colId] === true;
+    const getCellState = (rowId, colId) => {
+        if (isLocked(rowId, colId))
+            return 'locked';
+        const override = overrides.get(cellKey(rowId, colId));
+        const on = override ?? baseState(rowId, colId);
+        return on ? 'on' : 'off';
+    };
+    const isDirty = (rowId, colId) => {
+        const override = overrides.get(cellKey(rowId, colId));
+        return override !== undefined && override !== baseState(rowId, colId);
+    };
+    return (_jsx("div", { "data-widget": "toggle-matrix", "data-testid": testId, className: "h-full overflow-auto p-2", children: _jsx(ToggleMatrix, { label: matrixLabel ?? 'Permissions matrix', rowHeader: rowHeader ?? 'Permission', columns: columns, groups: groups, getCellState: getCellState, isDirty: isDirty, disabled: mode === 'readonly', ...(mode === 'readonly'
+                ? {}
+                : {
+                    onToggle: (rowId, colId, next) => {
+                        setOverrides((prev) => new Map(prev).set(cellKey(rowId, colId), next));
+                        onToggle?.(rowId, colId, next);
+                    },
+                }) }) }));
+}
+function matrixDataOf(data) {
+    const empty = { rowKeys: [], colKeys: [], columns: [], rows: [], cells: {} };
+    if (typeof data !== 'object' || data === null)
+        return empty;
+    const envelope = data;
+    return {
+        rowKeys: Array.isArray(envelope.rowKeys) ? envelope.rowKeys : [],
+        colKeys: Array.isArray(envelope.colKeys) ? envelope.colKeys : [],
+        columns: Array.isArray(envelope.columns) ? envelope.columns : [],
+        rows: Array.isArray(envelope.rows) ? envelope.rows : [],
+        cells: typeof envelope.cells === 'object' && envelope.cells !== null ? envelope.cells : {},
+        ...(envelope.locked === undefined ? {} : { locked: envelope.locked }),
+    };
+}
+export function ToggleMatrixWidget({ config, data, onEvent }) {
+    const source = config.binding;
+    const table = config.persistTarget ??
+        (source === undefined ? undefined : source.source.schema === undefined ? source.source.name : `${source.source.schema}.${source.source.name}`);
+    return (_jsx(ToggleMatrixGrid, { data: matrixDataOf(data), cellMode: config.cellMode, ...(config.rowHeader === undefined ? {} : { rowHeader: config.rowHeader }), ...(config.matrixLabel === undefined ? {} : { matrixLabel: config.matrixLabel }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), onToggle: (rowId, colId, next) => {
+            if (table !== undefined) {
+                onEvent({
+                    type: 'mutate',
+                    intent: 'update',
+                    ...(source === undefined ? {} : { connectionId: source.connectionId }),
+                    table,
+                    recordId: rowId,
+                    values: { [colId]: next },
+                });
+            }
+        } }));
+}
+//# sourceMappingURL=ToggleMatrixWidget.js.map

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

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

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

@@ -0,0 +1,37 @@
+import { topMoversListConfigSchema, topMoversListDemoData } from './tables-tail-config.js';
+import type { TopMoversListConfig } from './tables-tail-config.js';
+import type { MoverRow } from './tables-tail-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { topMoversListConfigSchema, topMoversListDemoData };
+export type { TopMoversListConfig, MoverRow };
+/**
+ * `top-movers-list` (annex §3) — the biggest |delta| rows: a tone-tinted icon
+ * tile, the name, a micro sparkline, the value, and a FIXED-WIDTH arrow delta
+ * pill so the pills form a clean column instead of ragging with each number's
+ * width (annex: "fixed-width arrow delta pill").
+ *
+ * "Danger for bad movers" (annex) is polarity-aware, not sign-aware: the icon
+ * tile and the pill both read `goodDirection`, so a −40% drop in "Checkout
+ * errors" is a POSITIVE mover and a +40% rise in it is a danger one.
+ *
+ * The rows arrive pre-ranked by the binding (annex: "record-list ranked by
+ * |delta|"); the widget re-ranks defensively so a hand-written binding that
+ * forgets the ORDER BY still shows the actual movers.
+ */
+export interface TopMoversListProps {
+    rows: readonly MoverRow[];
+    n?: number | undefined;
+    showSparkline?: boolean | undefined;
+    sparkWidth?: number | undefined;
+    goodDirectionByMetric?: Record<string, string> | undefined;
+    locale?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onSelect?: ((row: MoverRow) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function TopMoversList({ rows, n, showSparkline, sparkWidth, goodDirectionByMetric, locale, emptyTitle, emptyBody, onSelect, testId, }: TopMoversListProps): import("react").JSX.Element;
+/** Project an untrusted `record-list` onto `MoverRow`s (04 §3). */
+export declare function moverRowsOf(data: unknown): MoverRow[];
+export declare function TopMoversListWidget({ config, data, onEvent }: WidgetProps<TopMoversListConfig>): import("react").JSX.Element;
+//# sourceMappingURL=TopMoversList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TopMoversList.d.ts","sourceRoot":"","sources":["../../../src/families/tables/TopMoversList.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAcnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC;AAE9C;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC1B,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,CAAK,EACL,aAAoB,EACpB,UAAe,EACf,qBAAqB,EACrB,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,MAAM,GACP,EAAE,kBAAkB,+BA2EpB;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,CAgBrD;AAED,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,mBAAmB,CAAC,+BAiB9F"}