@ai-matrx/design-system 0.56.2 → 0.59.0

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # 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
+  draws the built-in row-actions column just to hold the row-copy icon: the copy rides inline at
+  the start of the first visible custom column. Before, records-ui's merged grid showed two
+  actions columns, and the second one, 225 px wide with only the copy icon in it, pushed the
+  grid's own Delete off the right edge. The built-in column is still drawn when the table has
+  standard icon `rowActions` or a window button, and it still holds the copy whenever no custom
+  column is visible. Under `fitToWidth` a custom column now takes its content width (its widest
+  row strip or its header), not a share of the space, and a custom strip gets compact rows'
+  24 px buttons. With no built-in column drawn, a custom column that ends the row takes the
+  built-in column's pin (sticky right from `sm:` up, `data-matrx-table-pinned-actions`), and the
+  sideways scroll control sits clear of it. Guards: `TableIconActions.test.tsx` and `MatrxDataTable.layout-look.test.tsx`
+  (red on 0.56.2).
+
+### Consumer action
+
+- None. A consumer that relied on a copy-only built-in column beside its own custom column sees
+  that column go away; its copy is in the custom column.
+
 ## 0.56.2
 
 - **`BottomSheetHeader`'s Back button has a name.** It was an unnamed icon button (screen
@@ -1239,7 +1292,7 @@ on the server; drop any app-side copy of the palette.
 
 ## 0.38.0 — 2026-09-23
 
-**On desktop a Dialog is a window, not a wall.** (register ARE-006, `common-docs/projects/ai-reachable-everywhere/REGISTER.md`.)
+**On desktop a Dialog is a window, not a wall.** (register ARE-006, `common-docs/systems/platform/ui-shell/projects/ai-reachable-everywhere/REGISTER.md`.)
 
 Arman, on a blocking settings dialog: *"none of the built-in page ai integrations are accessible because the page is totally blocked."* Unless the caller passes `modal`, a desktop `Dialog` no longer blocks the page: no overlay, and the page, its menus and every AI control beside it stay usable. It behaves like a light window:
 

package/README.md

@@ -242,4 +242,8 @@ button event for callers that need modifier keys. A menu, editor or other React
 be declared in its own column: `{ id: "workflow", header: "Workflow", customActions: (row,
 controls) => <WorkflowMenu row={row} controls={controls} /> }`. Custom columns carry live
 record controls, never participate in sort/filter/copy/spreadsheet data, and are not draggable
-(their headers may contain controls). Hidden custom columns stay hidden in mobile cards too.
+(their headers may contain controls). Hidden custom columns stay hidden in mobile cards too. A table with a visible custom column draws ONE actions column: the row copy rides inline at the
+start of the first visible custom column, and the built-in row-actions column is drawn only for
+standard icon `rowActions` or the window button. Under `fitToWidth` a custom column is as wide as
+its widest row strip or its header, never a scaled share; when it ends the row it is pinned right
+like the built-in column.