@ai-matrx/records 0.58.20 → 0.58.22

package/CHANGELOG.md

@@ -1,11 +1,27 @@
 # Changelog — @ai-matrx/records
 
-## 0.58.20
+## 0.58.22 (2026-09-26 — lane data-tables-grid-overhaul)
+
+* **`useTable` re-reads on the table's shape nudge** (`tableShapeChanged`, or the realtime port's
+  table notice) exactly as `useFields` does. A table's own declaration moves with its shape — its
+  row label (`title_field`), name and sort — so an open record panel now names its record by a new
+  row label the moment it changes, instead of only once reopened. No consumer action.
+
+## 0.58.21
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
-`git diff npm/records/v0.58.19..npm/records/v0.58.20 -- apps/shared/records`).
+`git diff npm/records/v0.58.20..npm/records/v0.58.21 -- apps/shared/records`).
 No source changes intended and no consumer action required.
 
+## 0.58.20 (2026-09-26 — cut by the automatic republish; carries lane data-tables-grid-overhaul, merge tranche 6k)
+
+* **`useRecordPage(tableId, { pageSize, page, filter, search, sort, viewId })`** (`/react`) — one page
+  through `client.listPage` (`custom.read_records_page`): the store sorts, searches, filters and
+  counts; `total` is the matching set this reader may see. Realtime-aware exactly like
+  `useRecords`: a notice re-reads only the ids it names and patches them into the page (a row the
+  page does not hold costs one page read). `tableId: null` reads nothing. The realtime half is one
+  shared helper for both hooks. New types `UseRecordPageOptions`, `UseRecordPageState`.
+
 ## 0.58.19
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/react/index.cjs

@@ -8051,13 +8051,17 @@ function useAsync(run, deps, share) {
   return { ...state, reload, setData };
 }
 function useTable(tableId) {
+  const revision = useShapeRevision(tableId);
+  (0, import_react2.useEffect)(() => {
+    if (tableId) registerShapeInterest(tableId);
+  }, [tableId]);
   return useAsync(
     async (client) => {
       if (!tableId) return { ok: true, data: null };
       return client.tableRead({ table_id: tableId });
     },
-    [tableId],
-    tableId ? `table:${tableId}` : null
+    [tableId, revision],
+    tableId ? `table:${tableId}:${revision}` : null
   );
 }
 function useTables() {