@ai-matrx/records-ui 0.93.2 → 0.93.3

package/dist/index.d.cts

@@ -1325,6 +1325,13 @@ interface GridEditing {
     rowError: RecordsError | null;
     clearRowError: () => void;
     busy: boolean;
+    /**
+     * EVERYTHING THIS SESSION HOLDS THAT CHANGES HOW ONE ROW DRAWS (lane RENDER-AUDIT, 2026-09-26):
+     * the open cell and what is typed in it, an optimistic value, a save in flight, a refusal. The
+     * grid hands it to the data table as `rowVersion`, so a keystroke, a save or a refusal redraws
+     * the ONE row it belongs to and no other.
+     */
+    rowSignature: (rowId: Uuid$1) => readonly unknown[];
 }
 interface Options {
     tableId: Uuid$1;
@@ -4054,11 +4061,6 @@ interface RecordsMountProps {
     children: ReactNode;
 }
 declare function RecordsMount({ config, host, letTheStoreDecideRights, children, }: RecordsMountProps): react.JSX.Element;
-/**
- * The actor a signed-in person is. `user` is the store's own word (the closed
- * ACTOR_VOCABULARY is `user` · `agent` · `system`), and AGT-N-4 means an agent
- * acting for this person carries exactly this authority and no other.
- */
 declare function personActor(userId: Uuid$1 | null | undefined): RecordsActor;
 /**
  * A supabase-js client AS this package's data seam.

package/dist/index.d.ts

@@ -1325,6 +1325,13 @@ interface GridEditing {
     rowError: RecordsError | null;
     clearRowError: () => void;
     busy: boolean;
+    /**
+     * EVERYTHING THIS SESSION HOLDS THAT CHANGES HOW ONE ROW DRAWS (lane RENDER-AUDIT, 2026-09-26):
+     * the open cell and what is typed in it, an optimistic value, a save in flight, a refusal. The
+     * grid hands it to the data table as `rowVersion`, so a keystroke, a save or a refusal redraws
+     * the ONE row it belongs to and no other.
+     */
+    rowSignature: (rowId: Uuid$1) => readonly unknown[];
 }
 interface Options {
     tableId: Uuid$1;
@@ -4054,11 +4061,6 @@ interface RecordsMountProps {
     children: ReactNode;
 }
 declare function RecordsMount({ config, host, letTheStoreDecideRights, children, }: RecordsMountProps): react.JSX.Element;
-/**
- * The actor a signed-in person is. `user` is the store's own word (the closed
- * ACTOR_VOCABULARY is `user` · `agent` · `system`), and AGT-N-4 means an agent
- * acting for this person carries exactly this authority and no other.
- */
 declare function personActor(userId: Uuid$1 | null | undefined): RecordsActor;
 /**
  * A supabase-js client AS this package's data seam.

package/dist/index.js

@@ -4012,7 +4012,20 @@ function useGridEditing({ tableId, fields, rows, reload, canWrite, mayWriteRow,
     }
     return null;
   }, [client, tableId, reload, order]);
+  const rowSignature = useCallback5(
+    (rowId) => {
+      const out = [];
+      if (editing?.rowId === rowId) out.push("open", editing.key, draft);
+      const prefix = `${rowId}::`;
+      for (const id in optimistic) if (id.startsWith(prefix)) out.push("held", id, optimistic[id]);
+      for (const id in saving) if (id.startsWith(prefix)) out.push("saving", id);
+      for (const id in refusals) if (id.startsWith(prefix)) out.push("refused", id, refusals[id]);
+      return out;
+    },
+    [editing, draft, optimistic, saving, refusals]
+  );
   return {
+    rowSignature,
     valueFor,
     editing,
     draft,
@@ -7936,11 +7949,12 @@ function placePinnedRows(pageRows, pinned, anchors) {
 }
 function withAddRowCells(columns, line) {
   if (line === null) return columns;
+  const draw = () => typeof line === "function" ? line() : line;
   return columns.map((column, index) => {
     const own2 = column.cell;
     return {
       ...column,
-      cell: (row, rowIndex) => row.id === ADD_ROW_ID ? index === 0 ? line : null : own2 ? own2(row, rowIndex) : null
+      cell: (row, rowIndex) => row.id === ADD_ROW_ID ? index === 0 ? draw() : null : own2 ? own2(row, rowIndex) : null
     };
   });
 }
@@ -7963,6 +7977,7 @@ function AddRowLine({ onAdd, busy }) {
     }
   );
 }
+var drawNothing = () => null;
 function addColumnColumn(onAdd) {
   return {
     id: ADD_COLUMN_ID,
@@ -7982,7 +7997,8 @@ function addColumnColumn(onAdd) {
         children: "+"
       }
     ),
-    cell: () => null,
+    // ONE function for the life of the module: a body cell that draws nothing never changes.
+    cell: drawNothing,
     sortable: false,
     filter: false,
     hideable: false,
@@ -10615,6 +10631,8 @@ function HandOrderDialog({
 import { Fragment as Fragment15, jsx as jsx42, jsxs as jsxs36 } from "react/jsx-runtime";
 var NO_COLUMNS_YET = "This table has no columns yet";
 var NO_COLUMNS_WHY = "A column is what a record holds \u2014 a name, a date, an amount, a person. Add the first one and the grid appears with it; everything else on this page works the moment it exists.";
+var NO_SUMMARIES = Object.freeze({});
+var rowIdOf = (row) => row.id;
 function Grid({
   tableId,
   pageSize = 50,
@@ -10764,6 +10782,15 @@ function Grid({
       onEnded: (exit, from, how) => sheetController.current?.endEdit(exit, { rowId: from.rowId, columnId: from.key }, how)
     } : {}
   });
+  const editingNow = useRef14(editing);
+  editingNow.current = editing;
+  const editingHandle = useMemo22(
+    () => new Proxy({}, {
+      get: (_target, key) => editingNow.current[key]
+    }),
+    []
+  );
+  const rowVersion = useCallback16((row) => editingNow.current.rowSignature(row.id), []);
   const undo = useGridUndo({ tableId, reload: records.reload, forget: editing.forget });
   pushWritten.current = (write) => {
     const field2 = (fields.data ?? []).find((f) => f.key === write.key);
@@ -10834,7 +10861,7 @@ function Grid({
   const [selectedIds, setSelectedIds] = useState31([]);
   const offerSelection = canWrite && (merged || tableActions.runnable.length > 0);
   const [reordering, setReordering] = useState31(false);
-  const chosenSummaries = localSummaries ?? presentation.summaries ?? {};
+  const chosenSummaries = localSummaries ?? presentation.summaries ?? NO_SUMMARIES;
   const summaries = useColumnSummaries({ tableId, chosen: chosenSummaries, filter: question.filter, version: records.data });
   const [duplicated, setDuplicated] = useState31(null);
   const duplicate = useCallback16(
@@ -11283,7 +11310,7 @@ function Grid({
     () => ordered.map(
       (field2) => columnForField(
         field2,
-        canWrite ? editing : null,
+        canWrite ? editingHandle : null,
         mayWriteRow,
         whyNotRow,
         {
@@ -11302,7 +11329,7 @@ function Grid({
     [
       ordered,
       canWrite,
-      editing,
+      editingHandle,
       mayWriteRow,
       whyNotRow,
       presentation.formats,
@@ -11314,9 +11341,34 @@ function Grid({
       pinCell
     ]
   );
-  const columns = useMemo22(
-    () => {
-      const drawn = withHeaderMenus(withAddRowCells(withSummaryCells(
+  const footerNow = useRef14({
+    summaryCell: () => null,
+    addLine: () => null
+  });
+  footerNow.current = {
+    summaryCell: (columnId) => {
+      const field2 = ordered.find((f) => f.key === columnId);
+      if (!field2) return null;
+      return /* @__PURE__ */ jsx42(
+        SummaryCell,
+        {
+          field: field2,
+          firstColumn: ordered[0]?.key === columnId,
+          chosen: chosenSummaries[columnId],
+          value: summaries.values[columnId],
+          rowCount: summaries.rowCount,
+          summaries,
+          onChoose: (op2) => chooseSummary(columnId, op2)
+        }
+      );
+    },
+    addLine: () => /* @__PURE__ */ jsx42(AddRowLine, { onAdd: () => void addRowHere(), busy: added.busy })
+  };
+  const addColumnNow = useRef14(controls.addColumn);
+  addColumnNow.current = controls.addColumn;
+  const bodyColumns = useMemo22(
+    () => withAddRowCells(
+      withSummaryCells(
         // THE ONE WAY A ROW OPENS ITS RECORD (VERIFIER-17): an Open control on the first cell,
         // and Space on any cell. Absent when the host cannot open a record.
         withOpenRecord(
@@ -11326,26 +11378,111 @@ function Grid({
           // The merged grid's handle sits at the START of the row, where Airtable's expand sits.
           merged ? "start" : "end"
         ),
-        (columnId) => {
-          const field2 = ordered.find((f) => f.key === columnId);
-          if (!field2) return null;
-          return /* @__PURE__ */ jsx42(
-            SummaryCell,
-            {
-              field: field2,
-              firstColumn: ordered[0]?.key === columnId,
-              chosen: chosenSummaries[columnId],
-              value: summaries.values[columnId],
-              rowCount: summaries.rowCount,
-              summaries,
-              onChoose: (op2) => chooseSummary(columnId, op2)
-            }
-          );
+        (columnId) => footerNow.current.summaryCell(columnId)
+      ),
+      mayAddRow ? () => footerNow.current.addLine() : null
+    ),
+    [fieldColumns, onOpenRecord, table.data, merged, mayAddRow]
+  );
+  const isRowSelectable = useCallback16((row) => row.id !== SUMMARY_ROW.id && mayWriteRow(row.id), [mayWriteRow]);
+  const copyConfig = useMemo22(
+    () => table.data ? gridCopyConfig({
+      tableId,
+      tableName: tableName(table.data),
+      fields: ordered,
+      rowLabel: (row) => recordNameIn(table.data, row.document ?? {})
+    }) : null,
+    [tableId, table.data, ordered]
+  );
+  const tableStyleProp = useMemo22(
+    () => tableStyleIsEmpty2(paint.style) ? null : {
+      style: paint.style,
+      // A choice is read as its OPTION (`paintByOption`): the rule, the value and the
+      // colour a column keeps for it all name the same option, however it is stored.
+      documentOf: (row) => paint.documentOf(row.document ?? {}),
+      // A value its column keeps a colour for wears THAT colour (`choiceLooks.ts`);
+      // any other value still paints from its word.
+      choiceColorFor: paint.choiceColorFor
+    },
+    [paint]
+  );
+  const rowActionsNow = useRef14({ runner, handToAgent, host, table: table.data, duplicate });
+  rowActionsNow.current = { runner, handToAgent, host, table: table.data, duplicate };
+  const offersRowActions = canWrite || Boolean(host.talkToRecord) || Boolean(host.runAgentAction && tableActions.agent.length > 0);
+  const hasTalk = Boolean(host.talkToRecord);
+  const hasAgent = Boolean(host.runAgentAction);
+  const rowActions = useCallback16(
+    (row) => /* @__PURE__ */ jsxs36(Fragment15, { children: [
+      canWrite && mayWriteRow(row.id) ? tableActions.runnable.map((action) => /* @__PURE__ */ jsx42(
+        ActionButton,
+        {
+          action,
+          busy: runner.busy === action.id,
+          onPress: () => rowActionsNow.current.runner.press(action, [row.id])
+        },
+        action.id
+      )) : null,
+      host.runAgentAction ? tableActions.agent.map((action) => /* @__PURE__ */ jsx42(
+        ActionButton,
+        {
+          action,
+          busy: false,
+          onPress: () => rowActionsNow.current.handToAgent(action, row)
+        },
+        action.id
+      )) : null,
+      host.talkToRecord ? /* @__PURE__ */ jsx42(
+        Button27,
+        {
+          size: "sm",
+          variant: "ghost",
+          onClick: () => rowActionsNow.current.host.talkToRecord?.({
+            tableId,
+            recordId: row.id,
+            // ONE NAMING CALL (`names.ts`), not this file's own join
+            // of a Table's title column to a document.
+            title: recordNameIn(
+              rowActionsNow.current.table,
+              row.document ?? {}
+            )
+          }),
+          children: "Talk"
+        }
+      ) : null,
+      Boolean(editable) && rights.write ? /* @__PURE__ */ jsx42(
+        Button27,
+        {
+          size: "sm",
+          variant: "ghost",
+          "data-records-duplicate": row.id,
+          title: "Duplicate this record",
+          onClick: (event) => {
+            event.stopPropagation();
+            void rowActionsNow.current.duplicate(row);
+          },
+          children: "Duplicate"
+        }
+      ) : null,
+      canWrite && mayWriteRow(row.id) ? /* @__PURE__ */ jsx42(
+        Button27,
+        {
+          size: "sm",
+          variant: "ghost",
+          title: "Delete this record",
+          onClick: () => setDeleting(row),
+          children: "Delete"
         }
-      ), mayAddRow ? /* @__PURE__ */ jsx42(AddRowLine, { onAdd: () => void addRowHere(), busy: added.busy }) : null), controls.headerMenuFor, controls.filterFor);
-      return merged && rights.structure && editable ? [...drawn, addColumnColumn(controls.addColumn)] : drawn;
+      ) : null
+    ] }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `hasTalk`/`hasAgent` stand for the host ports the JSX reads; handlers run through `rowActionsNow`.
+    [canWrite, mayWriteRow, tableActions.runnable, tableActions.agent, runner.busy, hasTalk, hasAgent, editable, rights.write]
+  );
+  const columns = useMemo22(
+    () => {
+      const drawn = withHeaderMenus(bodyColumns, controls.headerMenuFor, controls.filterFor);
+      return merged && rights.structure && editable ? [...drawn, addColumnColumn(() => addColumnNow.current())] : drawn;
     },
-    [fieldColumns, onOpenRecord, table.data, ordered, chosenSummaries, summaries, chooseSummary, controls.headerMenuFor, controls.filterFor, mayAddRow, addRowHere, added.busy, merged, rights.structure, editable, controls.addColumn]
+    [bodyColumns, controls.headerMenuFor, controls.filterFor, merged, rights.structure, editable]
   );
   const [localColumns, setLocalColumns] = useState31(
     null
@@ -11579,7 +11716,8 @@ function Grid({
                   ...fills ? { className: "min-h-0 flex-1" } : {},
                   data: rows,
                   columns,
-                  getRowId: (row) => row.id,
+                  getRowId: rowIdOf,
+                  rowVersion,
                   isLoading: nothingToShowYet,
                   isFetching: refreshing,
                   density: host.density ?? "condensed",
@@ -11605,20 +11743,13 @@ function Grid({
                     ];
                     return footerRows.length > 0 ? { footerRows } : {};
                   })(),
-                  ...table.data ? {
-                    copy: gridCopyConfig({
-                      tableId,
-                      tableName: tableName(table.data),
-                      fields: ordered,
-                      rowLabel: (row) => recordNameIn(table.data, row.document ?? {})
-                    })
-                  } : {},
+                  ...copyConfig ? { copy: copyConfig } : {},
                   ...offerSelection ? {
                     selection: {
                       selectedIds,
                       onSelectedIdsChange: setSelectedIds,
                       noun,
-                      isRowSelectable: (row) => row.id !== SUMMARY_ROW.id && mayWriteRow(row.id),
+                      isRowSelectable,
                       actions: (_selected, ids) => /* @__PURE__ */ jsxs36(Fragment15, { children: [
                         merged ? /* @__PURE__ */ jsx42(
                           BulkActions,
@@ -11714,85 +11845,9 @@ function Grid({
                     noun: "record",
                     ...typeof records.data?.total === "number" ? { total: records.data.total } : {}
                   },
-                  ...!tableStyleIsEmpty2(paint.style) ? {
-                    tableStyle: {
-                      style: paint.style,
-                      // A choice is read as its OPTION (`paintByOption`): the rule, the value and the
-                      // colour a column keeps for it all name the same option, however it is stored.
-                      documentOf: (row) => paint.documentOf(row.document ?? {}),
-                      // A value its column keeps a colour for wears THAT colour (`choiceLooks.ts`);
-                      // any other value still paints from its word.
-                      choiceColorFor: paint.choiceColorFor
-                    }
-                  } : {},
+                  ...tableStyleProp ? { tableStyle: tableStyleProp } : {},
                   ...onOpenRecord ? { onRowOpen: (row) => onOpenRecord(row.id) } : {},
-                  ...canWrite || host.talkToRecord || host.runAgentAction && tableActions.agent.length > 0 ? {
-                    // ABSENT, NEVER DEAD: a row this person may not delete carries no
-                    // Delete at all, rather than one that refuses when pressed — and a
-                    // deployment with no chat surface bound carries no Talk.
-                    rowActions: (row) => /* @__PURE__ */ jsxs36(Fragment15, { children: [
-                      canWrite && mayWriteRow(row.id) ? tableActions.runnable.map((action) => /* @__PURE__ */ jsx42(
-                        ActionButton,
-                        {
-                          action,
-                          busy: runner.busy === action.id,
-                          onPress: () => runner.press(action, [row.id])
-                        },
-                        action.id
-                      )) : null,
-                      host.runAgentAction ? tableActions.agent.map((action) => /* @__PURE__ */ jsx42(
-                        ActionButton,
-                        {
-                          action,
-                          busy: false,
-                          onPress: () => handToAgent(action, row)
-                        },
-                        action.id
-                      )) : null,
-                      host.talkToRecord ? /* @__PURE__ */ jsx42(
-                        Button27,
-                        {
-                          size: "sm",
-                          variant: "ghost",
-                          onClick: () => host.talkToRecord?.({
-                            tableId,
-                            recordId: row.id,
-                            // ONE NAMING CALL (`names.ts`), not this file's own join
-                            // of a Table's title column to a document.
-                            title: recordNameIn(
-                              table.data,
-                              row.document ?? {}
-                            )
-                          }),
-                          children: "Talk"
-                        }
-                      ) : null,
-                      Boolean(editable) && rights.write ? /* @__PURE__ */ jsx42(
-                        Button27,
-                        {
-                          size: "sm",
-                          variant: "ghost",
-                          "data-records-duplicate": row.id,
-                          title: "Duplicate this record",
-                          onClick: (event) => {
-                            event.stopPropagation();
-                            void duplicate(row);
-                          },
-                          children: "Duplicate"
-                        }
-                      ) : null,
-                      canWrite && mayWriteRow(row.id) ? /* @__PURE__ */ jsx42(
-                        Button27,
-                        {
-                          size: "sm",
-                          variant: "ghost",
-                          title: "Delete this record",
-                          onClick: () => setDeleting(row),
-                          children: "Delete"
-                        }
-                      ) : null
-                    ] })
-                  } : {},
+                  ...offersRowActions ? { rowActions } : {},
                   emptyState: emptyWords({
                     error: records.error,
                     asked: questionIsAsked({ search: query.search, columnFilters: query.columnFilters, filter }),
@@ -26424,6 +26479,7 @@ function useEmbedHandshake(args) {
 }
 
 // src/RecordsMount.tsx
+import { useRef as useRef26 } from "react";
 import { RecordsProvider } from "@ai-matrx/records/react";
 import { jsx as jsx91 } from "react/jsx-runtime";
 var STORE_DECIDES_REASON = "This host offers exactly what the record store says this person may do: the level comes back with the table on the read door, so a control they cannot use is never drawn in the first place.";
@@ -26436,10 +26492,26 @@ function RecordsMount({
   letTheStoreDecideRights,
   children
 }) {
-  const bound = { ...host ?? {} };
+  const bound = useShallowStableHost(host);
   void letTheStoreDecideRights;
   return /* @__PURE__ */ jsx91(RecordsProvider, { config, children: /* @__PURE__ */ jsx91(RecordsUiProvider, { value: bound, children: /* @__PURE__ */ jsx91(RecordLabelProvider, { children }) }) });
 }
+function useShallowStableHost(host) {
+  const held = useRef26(null);
+  const next = host ?? {};
+  const previous = held.current;
+  if (previous !== null && sameParts(previous, next)) return previous;
+  const bound = { ...next };
+  held.current = bound;
+  return bound;
+}
+function sameParts(a, b) {
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) return false;
+  for (const key of aKeys) if (a[key] !== b[key]) return false;
+  return true;
+}
 function personActor(userId) {
   return userId ? { actor: "user", user_id: userId } : { actor: "user" };
 }
@@ -27042,7 +27114,7 @@ function TablesHome({ onOpenTable, organizationName, makingOnly = false, classNa
 }
 
 // src/TablePage.tsx
-import { useCallback as useCallback51, useEffect as useEffect72, useRef as useRef26, useState as useState84 } from "react";
+import { useCallback as useCallback51, useEffect as useEffect72, useRef as useRef27, useState as useState84 } from "react";
 import { archivedByLine as archivedByLine2 } from "@ai-matrx/records";
 import { useFields as useFields26, useRecordsClient as useRecordsClient64, useTable as useTable24 } from "@ai-matrx/records/react";
 import {
@@ -27684,7 +27756,7 @@ function TablePage({
     lookDiffers: view ? lookDiffers(view, look) : false
   };
   const shownSignature = JSON.stringify(shownReport);
-  const reportRef = useRef26(onShownViewChange);
+  const reportRef = useRef27(onShownViewChange);
   reportRef.current = onShownViewChange;
   useEffect72(() => {
     reportRef.current?.(JSON.parse(shownSignature));