@ai-matrx/design-system 0.21.14 → 0.22.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 0.22.0 — 2026-09-20
+
+**The data table can paint, format and freeze — so every table in the product can.**
+
+The spreadsheet work built behind one app route (`/data`) lived in that app and could not be
+reached by anything else; the record store's Grid renders through THIS table, so any table that
+wanted a colored row or a money column had to grow its own. Three capabilities move into the
+primitive, and a fourth rung it never had.
+
+- **`tableStyle`** — colors, declaratively. Color by a column, live rules ("when Amount is over
+  1000, tint the row amber"), and manual cell / row / column highlights, with a documented
+  precedence between them. The model is the new `./table-style.ts` — pure, no React, no network —
+  so a consumer owns only where the document is STORED and how a person edits it. Every tint ships
+  its own `dark:` class, and the palette is NAMES, never hex, so a color survives the theme and a
+  retired name degrades to "no color" instead of an unreadable swatch.
+- **`MatrxColumnDef.format`** — `{id, options}` from the new `@ai-matrx/design-system/field-formats`
+  entry point, which is the platform's ONE field-format registry (25 formats: currency, percent,
+  duration, rating, file size, date styles, choice, tags, markdown, …). A formatted column also
+  right-aligns itself when the format is numeric. THE FALLBACK LAW travels with it: a value that
+  does not fit is shown in amber with the reason, never blanked and never thrown.
+- **`MatrxColumnDef.frozen`** — the identity column stays while a wide table scrolls sideways.
+  DESKTOP ONLY (`sm:`) because pinning over a phone table buries the data; only the LEADING RUN,
+  because a column pinned over its own left neighbour lies about where the row is; and **nothing
+  freezes at all when a width the offsets need is unknown**, rather than pinning at a guess.
+- **`cellClassName`** — the rung between `rowClassName` and a column's static `className`. Its
+  absence is why every table that needed to say something about ONE cell had to grow a `cell`
+  render function and paint inside it, where the table can no longer see it.
+- **`TableViewSnapshot.style`** — a saved view carries its colors. Read by `parseTableStyle`, which
+  is tolerant by design, so one stale rule costs that rule and never the whole view.
+
+### Consumer action
+
+None. Every new prop is optional and every default is today's behavior. `MatrxColumnDef.format` is
+ignored when the column already supplies `cell`; a consumer's own renderer can ask for the same
+text with the exported `formatColumnValue(col, value)` instead of writing a second money formatter.
+
+
 ## 0.21.14 — 2026-09-19
 
 Alchemy renders the kit's new `queued` transfer outcome (`@ai-matrx/kit` 0.16.0): a write that was

package/dist/data-table/copy-helpers.d.cts

@@ -1,9 +1,10 @@
 import { AgentPayloadInput } from './copy-types.cjs';
-import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-BgqIKbhq.cjs';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-Sn249eoy.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
 import '../content-transfer/icon.cjs';
+import '../types-BdbvlF9-.cjs';
 
 /**
  * Typed, declared-column capture for MatrxDataTable's built-in Alchemy source.

package/dist/data-table/copy-helpers.d.ts

@@ -1,9 +1,10 @@
 import { AgentPayloadInput } from './copy-types.js';
-import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-emLxze_m.js';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-D-flTpK0.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
 import '../content-transfer/icon.js';
+import '../types-BdbvlF9-.js';
 
 /**
  * Typed, declared-column capture for MatrxDataTable's built-in Alchemy source.

package/dist/data-table/filter-engine.d.cts

@@ -1,9 +1,10 @@
-import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-BgqIKbhq.cjs';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-Sn249eoy.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
 import '../content-transfer/icon.cjs';
 import './copy-types.cjs';
+import '../types-BdbvlF9-.cjs';
 
 /**
  * Sentinel select-filter values for "no value" / "any value" — every select

package/dist/data-table/filter-engine.d.ts

@@ -1,9 +1,10 @@
-import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-emLxze_m.js';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-D-flTpK0.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
 import '../content-transfer/icon.js';
 import './copy-types.js';
+import '../types-BdbvlF9-.js';
 
 /**
  * Sentinel select-filter values for "no value" / "any value" — every select

package/dist/data-table/host.d.cts

@@ -1,11 +1,12 @@
 import * as React from 'react';
 import { ComponentType, ReactNode, MouseEventHandler } from 'react';
-import { b as TableSavedViewsProps, c as MatrxDataTableRecordControls, d as MatrxDataTableDensity } from '../types-BgqIKbhq.cjs';
+import { b as TableSavedViewsProps, c as MatrxDataTableRecordControls, d as MatrxDataTableDensity } from '../types-Sn249eoy.cjs';
 import { CopyControlProps } from './copy-types.cjs';
 export { AgentPayloadInput, AiCustomSource, AiVariant, CopyExportConfig } from './copy-types.cjs';
 import '../content-transfer.cjs';
 import '@ai-matrx/kit/content-transfer';
 import '../content-transfer/icon.cjs';
+import '../types-BdbvlF9-.cjs';
 
 interface TableLinkProps {
     href: string;

package/dist/data-table/host.d.ts

@@ -1,11 +1,12 @@
 import * as React from 'react';
 import { ComponentType, ReactNode, MouseEventHandler } from 'react';
-import { b as TableSavedViewsProps, c as MatrxDataTableRecordControls, d as MatrxDataTableDensity } from '../types-emLxze_m.js';
+import { b as TableSavedViewsProps, c as MatrxDataTableRecordControls, d as MatrxDataTableDensity } from '../types-D-flTpK0.js';
 import { CopyControlProps } from './copy-types.js';
 export { AgentPayloadInput, AiCustomSource, AiVariant, CopyExportConfig } from './copy-types.js';
 import '../content-transfer.js';
 import '@ai-matrx/kit/content-transfer';
 import '../content-transfer/icon.js';
+import '../types-BdbvlF9-.js';
 
 interface TableLinkProps {
     href: string;