@ai-matrx/design-system 0.57.0 → 0.59.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 0.59.0
+
+- **A host's inline functions never redraw the table.** A host that writes `cell`,
+  `customActions`, `getRowId`, `rowClassName` or its handlers inline handed the table new
+  functions on every render, and every row redrew: /artifacts (560 rows) spent ~2.6 s redrawing
+  1,120 rows to open one artifact. Now only a VALUE the rows draw (a width, a flag) redraws every
+  row; a new function or object makes each row compare the elements it would draw with the ones
+  it drew (`row-drawing.ts`). Equal → React skips the row; different → only that row redraws.
+  Every `on[A-Z]` handler inside a row is a stable trampoline to the host's latest function, so a
+  row that was not redrawn never calls an old closure. Render props and component types still
+  compare by identity, so a row never shows what an old closure drew. The default row copy reads
+  its columns when a person copies (`TableRowCopyControl`'s `defaultColumns` is now a getter).
+  Guard: `MatrxDataTable.inline-callbacks.test.tsx` (red on 0.58.0).
+
+### Consumer action
+
+- None required. A host that stabilised its callbacks only to stop row redraws may drop the
+  `useMemo`/ref plumbing; a host whose cell reads state outside the record keeps working without
+  `rowVersion` (the comparison sees what the cell draws).
+
+## 0.58.0
+
+- **`formatPhone` is exported from `./field-formats`** — the Phone format's one look, moved here
+  from records-ui so every surface shows a phone number the same way: ten North-American digits
+  read `(805) 555-1234`, `+1`/eleven digits with the leading 1 read `+1 (805) 555-1234`, anything
+  else (another country's number, an extension, words) is shown as typed. Display only; the
+  stored value is never rewritten. Guard: `src/field-formats/phone-format.test.ts` (red on 0.57.0).
+
+### Consumer action
+
+- None required. A surface that renders a phone value calls `formatPhone(text)` from
+  `@ai-matrx/design-system/field-formats` instead of keeping its own copy.
+
 ## 0.57.0
 
 - **One actions column.** A table that declares its own `customActions` column no longer also