@ai-matrx/records-ui 0.93.2 → 0.93.4

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,
@@ -7699,6 +7712,10 @@ function useMergedGridControls(args) {
     (columnKey) => enabled && fieldOf2(columnKey) ? headerMenuItems(columnKey, ctx) : void 0,
     [enabled, ctx, fieldOf2]
   );
+  const columnsControl = useMemo14(
+    () => enabled ? { order, hidden, onChange: keepColumns } : void 0,
+    [enabled, order, hidden, keepColumns]
+  );
   const close = () => setDialog(null);
   const dialogs = !enabled ? null : /* @__PURE__ */ jsxs24(Fragment8, { children: [
     colours.dialogs,
@@ -7830,7 +7847,7 @@ function useMergedGridControls(args) {
     headerMenuFor,
     filterFor,
     contextMenu,
-    columns: enabled ? { order, hidden, onChange: keepColumns } : void 0,
+    columns: columnsControl,
     dialogs,
     addColumn: () => setDialog({ kind: "insert", anchor: null, side: "right" }),
     sheetTools: enabled ? /* @__PURE__ */ jsxs24(Fragment8, { children: [
@@ -7936,11 +7953,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 +7981,7 @@ function AddRowLine({ onAdd, busy }) {
     }
   );
 }
+var drawNothing = () => null;
 function addColumnColumn(onAdd) {
   return {
     id: ADD_COLUMN_ID,
@@ -7982,7 +8001,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,
@@ -9277,7 +9297,7 @@ function GridLayoutMenu({
 }
 
 // src/gridUndo.tsx
-import { useCallback as useCallback13, useEffect as useEffect21, useMemo as useMemo18, useRef as useRef11, useState as useState26 } from "react";
+import { useCallback as useCallback13, useEffect as useEffect21, useLayoutEffect, useMemo as useMemo18, useRef as useRef11, useState as useState26, useSyncExternalStore } from "react";
 import { useRecordsClient as useRecordsClient16 } from "@ai-matrx/records/react";
 import { announceRecordChanged } from "@ai-matrx/records/core";
 import { Button as Button23 } from "@ai-matrx/design-system";
@@ -9383,7 +9403,43 @@ function useGridUndo(args) {
     [push, undo, redo, held, busy, notice, dismiss]
   );
 }
-function UndoRedoButtons({ undo }) {
+function useUndoSource(undo) {
+  const box = useRef11({
+    undo,
+    face: { back: undo.depth.back, forward: undo.depth.forward, busy: undo.busy },
+    listeners: /* @__PURE__ */ new Set()
+  });
+  box.current.undo = undo;
+  const source = useMemo18(
+    () => ({
+      face: () => box.current.face,
+      subscribe: (listener) => {
+        box.current.listeners.add(listener);
+        return () => {
+          box.current.listeners.delete(listener);
+        };
+      },
+      undo: () => void box.current.undo.undo(),
+      redo: () => void box.current.undo.redo()
+    }),
+    []
+  );
+  const { back, forward } = undo.depth;
+  const busy = undo.busy;
+  useLayoutEffect(() => {
+    const held = box.current.face;
+    if (held.back === back && held.forward === forward && held.busy === busy) return;
+    box.current.face = { back, forward, busy };
+    for (const listener of box.current.listeners) listener();
+  }, [back, forward, busy]);
+  return source;
+}
+function UndoRedoLive({ source }) {
+  const face = useSyncExternalStore(source.subscribe, source.face, source.face);
+  return /* @__PURE__ */ jsx37(UndoRedoPair, { face, onUndo: source.undo, onRedo: source.redo });
+}
+function UndoRedoPair({ face, onUndo, onRedo }) {
+  const undo = { depth: { back: face.back, forward: face.forward }, busy: face.busy };
   if (undo.depth.back === 0 && undo.depth.forward === 0) return null;
   return /* @__PURE__ */ jsxs32(Fragment13, { children: [
     /* @__PURE__ */ jsxs32(
@@ -9395,7 +9451,7 @@ function UndoRedoButtons({ undo }) {
         title: undo.depth.back > 0 ? `Undo (Cmd-Z) \xB7 ${undo.depth.back} ${undo.depth.back === 1 ? "step" : "steps"} back` : "Nothing to undo",
         "aria-label": `Undo, ${undo.depth.back} ${undo.depth.back === 1 ? "step" : "steps"}`,
         disabled: undo.busy || undo.depth.back === 0,
-        onClick: () => void undo.undo(),
+        onClick: onUndo,
         children: [
           "Undo ",
           /* @__PURE__ */ jsx37("span", { className: "ml-1 tabular-nums text-muted-foreground", "data-records-undo-count": "", children: undo.depth.back })
@@ -9411,7 +9467,7 @@ function UndoRedoButtons({ undo }) {
         title: undo.depth.forward > 0 ? `Redo (Shift-Cmd-Z) \xB7 ${undo.depth.forward} ${undo.depth.forward === 1 ? "step" : "steps"} forward` : "Nothing to redo",
         "aria-label": `Redo, ${undo.depth.forward} ${undo.depth.forward === 1 ? "step" : "steps"}`,
         disabled: undo.busy || undo.depth.forward === 0,
-        onClick: () => void undo.redo(),
+        onClick: onRedo,
         children: [
           "Redo ",
           /* @__PURE__ */ jsx37("span", { className: "ml-1 tabular-nums text-muted-foreground", "data-records-redo-count": "", children: undo.depth.forward })
@@ -10615,6 +10671,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,7 +10822,17 @@ 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 });
+  const undoSource = useUndoSource(undo);
   pushWritten.current = (write) => {
     const field2 = (fields.data ?? []).find((f) => f.key === write.key);
     const name = changedRecordName(table.data, rows.find((r) => r.id === write.rowId)?.document ?? {}, write.key, write.after);
@@ -10834,7 +10902,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 +11351,7 @@ function Grid({
     () => ordered.map(
       (field2) => columnForField(
         field2,
-        canWrite ? editing : null,
+        canWrite ? editingHandle : null,
         mayWriteRow,
         whyNotRow,
         {
@@ -11302,7 +11370,7 @@ function Grid({
     [
       ordered,
       canWrite,
-      editing,
+      editingHandle,
       mayWriteRow,
       whyNotRow,
       presentation.formats,
@@ -11314,9 +11382,39 @@ function Grid({
       pinCell
     ]
   );
-  const columns = useMemo22(
-    () => {
-      const drawn = withHeaderMenus(withAddRowCells(withSummaryCells(
+  const footerNow = useRef14({
+    summaryCell: () => null,
+    addLine: () => null,
+    choose: () => void 0,
+    add: () => void 0
+  });
+  footerNow.current = {
+    // The footer is memoised on what it shows (`footerRows` below), so its buttons act through here.
+    choose: chooseSummary,
+    add: () => void addRowHere(),
+    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) => footerNow.current.choose(columnId, op2)
+        }
+      );
+    },
+    addLine: () => /* @__PURE__ */ jsx42(AddRowLine, { onAdd: () => footerNow.current.add(), 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,27 +11424,123 @@ 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"
         }
-      ), 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,
+      canWrite && mayWriteRow(row.id) ? /* @__PURE__ */ jsx42(
+        Button27,
+        {
+          size: "sm",
+          variant: "ghost",
+          title: "Delete this record",
+          onClick: () => setDeleting(row),
+          children: "Delete"
+        }
+      ) : 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 headerHeld = useRef14(/* @__PURE__ */ new Map());
+  const menuLatest = useRef14(/* @__PURE__ */ new Map());
+  const addColumnDef = useMemo22(() => addColumnColumn(() => addColumnNow.current()), []);
+  const drawnColumns = useMemo22(
+    () => {
+      const filterFor = controls.filterFor;
+      const drawn = withHeaderMenus(
+        bodyColumns,
+        (key) => holdHeaderMenu(headerHeld.current, menuLatest.current, key, controls.headerMenuFor(key)),
+        (key) => holdByContent(headerHeld.current, `filter:${key}`, filterFor(key))
+      );
+      return merged && rights.structure && editable ? [...drawn, addColumnDef] : 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, addColumnDef]
   );
+  const columnsHeld = useRef14(null);
+  const columns = columnsHeld.current !== null && sameColumns(columnsHeld.current, drawnColumns) ? columnsHeld.current : drawnColumns;
+  columnsHeld.current = columns;
   const [localColumns, setLocalColumns] = useState31(
     null
   );
@@ -11419,6 +11613,274 @@ function Grid({
       } : {}
     };
   }, [presentation, onPresentationChange, writeLook, merged, phone]);
+  const queryTotal = records.data?.total ?? rows.length;
+  const tableQuery = useMemo22(
+    () => merged ? {
+      // THE STORE ANSWERS THE QUERY (tranche 6k): `data` is already the page.
+      mode: "controlled",
+      state: query,
+      totalItems: queryTotal,
+      onStateChange: setQuery,
+      sourceProcessing: { search: "source", columnFilters: "source", sort: "source" }
+    } : { mode: "controlled-local", state: query, onStateChange: setQuery },
+    [merged, query, queryTotal]
+  );
+  const showAddLine = mayAddRow && rows.length > 0;
+  const showSummaryLine = rows.length > 0 && (!merged || Object.keys(chosenSummaries).length > 0);
+  const footerFace = JSON.stringify([
+    showAddLine ? added.busy : null,
+    showSummaryLine ? [chosenSummaries, summaries.values, summaries.rowCount, summaries.loading] : null
+  ]);
+  const footerRows = useMemo22(
+    () => [...showAddLine ? [ADD_ROW] : [], ...showSummaryLine ? [SUMMARY_ROW] : []],
+    // `footerFace`, `ordered` and the summaries' operations are what the footer's cells draw.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [showAddLine, showSummaryLine, footerFace, ordered, summaries.operations, summaries.askOperations]
+  );
+  const coverageTotal = typeof records.data?.total === "number" ? records.data.total : null;
+  const tableCoverage = useMemo22(
+    () => ({
+      answeredBy: merged ? "source" : "client",
+      ...merged && coverageTotal !== null ? { matched: coverageTotal } : {},
+      noun: "record",
+      ...coverageTotal !== null ? { total: coverageTotal } : {}
+    }),
+    [merged, coverageTotal]
+  );
+  const sheetNow = useRef14({ merged, writeRange, editing, fields: fields.data ?? [], mayWriteRow, notify: host.notify });
+  sheetNow.current = { merged, writeRange, editing, fields: fields.data ?? [], mayWriteRow, notify: host.notify };
+  const hasNotify = Boolean(host.notify);
+  const readOnlyReason = !editable || !rights.known || rights.write ? "Editing is off here, so this table can be copied but not changed." : rights.why("write");
+  const spreadsheetConfig = useMemo22(
+    () => canWrite && editable ? {
+      enabled: true,
+      writableColumnIds: pasteableKeys,
+      onPatch: (patches, intent) => {
+        const now = sheetNow.current;
+        if (now.merged) {
+          void now.writeRange(patches, intent);
+          return;
+        }
+        for (const patch of patches) {
+          now.editing.setCell(patch.rowId, patch.columnId, patch.value);
+        }
+      },
+      ...merged ? { undoDepth: 0, onSelectionChange: followSelection, controllerRef: sheetController } : {},
+      columnRefusal: (columnId) => {
+        const field2 = sheetNow.current.fields.find((f) => f.key === columnId);
+        if (!field2) return `This table has no column called ${columnId}.`;
+        return `${fieldName(field2)} cannot take a pasted value \u2014 ${fieldTypeLabel(field2)} is worked out or chosen, not typed.`;
+      },
+      validateCell: ({ columnId, value }) => {
+        const field2 = sheetNow.current.fields.find((f) => f.key === columnId);
+        if (!field2) return `This table has no column called ${columnId}.`;
+        const judged = valueFromPastedText(field2, value === null ? "" : String(value));
+        return "refusal" in judged ? judged.refusal : void 0;
+      },
+      onPastePlan: receivePastePlan,
+      /*
+       * TYPE-TO-EDIT (design-system 0.43 `onEditRequest`): the cell a person is on
+       * opens ITS OWN editor — the Field's — holding what they typed (a letter, an
+       * IME composition, an Option/AltGr character, dictation). A worked-out column
+       * or a row this person may not write answers false, so nothing is swallowed.
+       */
+      onEditRequest: (address, seed) => {
+        const now = sheetNow.current;
+        const field2 = now.fields.find((f) => f.key === address.columnId);
+        if (!field2 || !fieldIsEditable(field2) || !now.mayWriteRow(address.rowId)) return false;
+        if (seed !== null && seed !== "" && typingOpens(field2) === "none") return false;
+        now.editing.begin({ rowId: address.rowId, key: field2.key }, seed);
+        return true;
+      },
+      ...hasNotify ? { notify: (message) => sheetNow.current.notify?.success(message) } : {}
+    } : {
+      /*
+       * RANGE SELECTION AND COPY FOR A READER (merge step 3, 0.42 `readOnly`). A person
+       * who may not change this table may still drag out a range, select all and press
+       * Cmd-C for a real Excel/Sheets block — the UX walk graded range selection BROKEN
+       * on a table whose writes were refused. Every write gesture (cut, paste, clear,
+       * fill, undo) says why it cannot, in the store's own words.
+       */
+      enabled: true,
+      readOnly: true,
+      ...merged ? { onSelectionChange: followSelection, controllerRef: sheetController } : {},
+      readOnlyReason
+    },
+    [canWrite, editable, pasteableKeys, merged, followSelection, receivePastePlan, hasNotify, readOnlyReason]
+  );
+  const toolbarFields = fields.data;
+  const hasSeveralRows = rows.length > 1;
+  const editingBusy = editing.busy;
+  const addRecord = editing.addRecord;
+  const phoneSheetTools = merged && phone ? controls.sheetTools : null;
+  const tableToolbar = useMemo22(
+    () => ({
+      search: true,
+      searchPlaceholder: "Search records",
+      /*
+       * A PHONE (tranche 6o): search and the one Tools button sit side by side at the START of
+       * the row, so Tools is never scrolled out of reach; the search is the same query.
+       */
+      ...merged && phone ? {
+        customSearch: /* @__PURE__ */ jsx42("div", { className: "flex min-w-0 flex-1 items-center gap-1.5", "data-records-grid-phone-search": "", children: /* @__PURE__ */ jsx42(
+          "input",
+          {
+            type: "search",
+            value: query.search,
+            placeholder: "Search",
+            "aria-label": "Search records",
+            onChange: (event) => {
+              const search = event.target.value;
+              setQuery((held) => ({ ...held, search, page: 1 }));
+            },
+            className: "h-8 w-full min-w-0 rounded-md border border-input bg-background px-2 text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+            style: { fontSize: "16px" }
+          }
+        ) })
+      } : {},
+      /* ONE ROW (lane TABLE-PAGE-CHROME): on a table page the grid's search, columns and
+         sort are drawn INTO the page's toolbar row, never a second bar under it. */
+      ...toolbarSlot !== void 0 ? { portalInto: toolbarSlot, singleRow: true } : {},
+      // SCR-2 / SCR-4: PRESENT for an admin, ABSENT for everyone else.
+      // There is no third state: this package ships no disabled variant of
+      // these controls, so a member cannot be shown a dead one by mistake.
+      /*
+       * WHERE THE GRID'S CONTROLS GO (lane C, review 2026-09-26 D6). Inline when the row has
+       * room; behind the row's "…" once the page row is folded that far (Undo / Redo and New
+       * record stay beside it — the primary action is never folded); on a phone EVERY control
+       * — the table's own (clear, copy/export, group, columns), these, the search, the sort and
+       * the page's filter, layout and share — in ONE "Tools" sheet. Never dropped.
+       */
+      actions: /* @__PURE__ */ jsxs36(Fragment15, { children: [
+        manual ? /* @__PURE__ */ jsx42(
+          SortStateControl,
+          {
+            ...handOrderSortState({
+              sortName: columnSort ? columnLabel(toolbarFields ?? [], columnSort.id) : null,
+              direction: columnSort?.direction ?? null,
+              onBack: () => setQuery((held) => ({ ...held, sort: null, page: 1 })),
+              ...viewOrder?.onUseSort && columnSort ? {
+                onUseSort: () => {
+                  const sort = columnSort;
+                  const chosen = { field: sort.id, direction: sort.direction };
+                  setHeldOrder({ order: "sorted", sorts: [chosen] });
+                  viewOrder.onUseSort?.(chosen);
+                  host.notify?.success(
+                    `Sorted by ${columnLabel(toolbarFields ?? [], sort.id)} ${sortArrow(sort.direction)}. ${MANUAL_SORT.replacedToast}`
+                  );
+                }
+              } : {}
+            })
+          }
+        ) : null,
+        viewId && viewOrder?.onPlaced && hasSeveralRows ? /* @__PURE__ */ jsx42(Button27, { size: "sm", variant: "ghost", onClick: () => setReordering(true), "data-records-reorder-open": "", children: "Reorder" }) : null,
+        !merged && Boolean(editable) && rights.write ? /* @__PURE__ */ jsx42(Button27, { size: "sm", disabled: editingBusy, onClick: () => void addRecord(), children: editingBusy ? "Adding\u2026" : "New record" }) : null,
+        rights.structure && onAddField ? /* @__PURE__ */ jsx42(AddFieldButton, { onClick: onAddField }) : null,
+        /* @__PURE__ */ jsx42(
+          GridLayoutMenu,
+          {
+            look,
+            firstColumn: sortedKeys[0] ? {
+              key: sortedKeys[0],
+              name: (() => {
+                const first = (toolbarFields ?? []).find((f) => f.key === sortedKeys[0]);
+                return first ? fieldName(first) : humanize(sortedKeys[0]);
+              })()
+            } : null,
+            onChange: changeLayout,
+            kept: Boolean(onPresentationChange)
+          }
+        )
+      ] }),
+      ...merged ? {
+        overflow: {
+          mode: phone ? "sheet" : toolbarFold2 >= 3 ? "menu" : "inline",
+          pinned: /* @__PURE__ */ jsxs36(Fragment15, { children: [
+            /* @__PURE__ */ jsx42(UndoRedoLive, { source: undoSource }),
+            Boolean(editable) && rights.write ? /* @__PURE__ */ jsx42(Button27, { size: "sm", className: "shrink-0", disabled: added.busy, onClick: () => addRowRef.current(), children: added.busy ? "Adding\u2026" : "New record" }) : null
+          ] }),
+          ...phone ? {
+            sheetTop: /* @__PURE__ */ jsxs36("div", { className: "flex flex-col gap-1.5 pb-1", "data-records-grid-sheet-top": "", "data-matrx-table-tools-keep-open": "", children: [
+              /* @__PURE__ */ jsx42(
+                "input",
+                {
+                  type: "search",
+                  value: query.search,
+                  placeholder: "Search",
+                  "aria-label": "Search records",
+                  onChange: (event) => {
+                    const search = event.target.value;
+                    setQuery((held) => ({ ...held, search, page: 1 }));
+                  },
+                  className: "h-10 w-full min-w-0 rounded-md border border-input bg-background px-2 text-foreground placeholder:text-muted-foreground",
+                  style: { fontSize: "16px" }
+                }
+              ),
+              /* @__PURE__ */ jsxs36("label", { className: "flex items-center gap-2 text-xs text-muted-foreground", "data-records-grid-sheet-sort": "", children: [
+                /* @__PURE__ */ jsx42("span", { className: "shrink-0", children: "Sort by" }),
+                /* @__PURE__ */ jsxs36(
+                  "select",
+                  {
+                    "aria-label": "Sort by",
+                    value: query.sort ? `${query.sort.id}:${query.sort.direction}` : "",
+                    onChange: (event) => {
+                      const [id, direction] = event.target.value.split(":");
+                      setQuery((held) => ({
+                        ...held,
+                        page: 1,
+                        sort: id ? { id, direction: direction === "desc" ? "desc" : "asc" } : null
+                      }));
+                    },
+                    className: "h-10 min-w-0 flex-1 rounded-md border border-input bg-background px-2 text-foreground",
+                    style: { fontSize: "16px" },
+                    children: [
+                      /* @__PURE__ */ jsx42("option", { value: "", children: "No sort" }),
+                      ordered.flatMap((field2) => [
+                        /* @__PURE__ */ jsx42("option", { value: `${field2.key}:asc`, children: `${fieldName(field2)} \u2191` }, `${field2.key}:asc`),
+                        /* @__PURE__ */ jsx42("option", { value: `${field2.key}:desc`, children: `${fieldName(field2)} \u2193` }, `${field2.key}:desc`)
+                      ])
+                    ]
+                  }
+                )
+              ] }),
+              phoneSheetTools
+            ] }),
+            ...sheetExtras ? { sheetExtras } : {}
+          } : {}
+        }
+      } : {}
+    }),
+    [
+      merged,
+      phone,
+      query.search,
+      query.sort,
+      toolbarSlot,
+      manual,
+      columnSort,
+      toolbarFields,
+      viewOrder,
+      host,
+      viewId,
+      hasSeveralRows,
+      editable,
+      rights.write,
+      rights.structure,
+      editingBusy,
+      addRecord,
+      onAddField,
+      look,
+      sortedKeys,
+      changeLayout,
+      onPresentationChange,
+      toolbarFold2,
+      undoSource,
+      added.busy,
+      ordered,
+      phoneSheetTools,
+      sheetExtras
+    ]
+  );
   const labelOfField = useCallback16(
     (key) => {
       const held = (fields.data ?? []).find((f) => f.key === key);
@@ -11579,46 +12041,27 @@ 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",
                   viewTabs: false,
                   stickyHeader: true,
                   pageSize,
-                  query: merged ? {
-                    // THE STORE ANSWERS THE QUERY (tranche 6k): `data` is already the page.
-                    mode: "controlled",
-                    state: query,
-                    totalItems: records.data?.total ?? rows.length,
-                    onStateChange: setQuery,
-                    sourceProcessing: { search: "source", columnFilters: "source", sort: "source" }
-                  } : { mode: "controlled-local", state: query, onStateChange: setQuery },
+                  query: tableQuery,
                   tableClassName: cn20(
                     !look.wrap && "[&_tbody_td]:max-w-[28rem] [&_tbody_td]:overflow-hidden [&_tbody_td]:text-ellipsis [&_tbody_td]:whitespace-nowrap! [&_tbody_td_*]:whitespace-nowrap!",
                     look.fit === "scroll" && "sm:[&>table]:w-max! sm:[&>table]:max-w-none! sm:[&>table]:min-w-full!"
                   ),
-                  ...(() => {
-                    const footerRows = [
-                      ...mayAddRow && rows.length > 0 ? [ADD_ROW] : [],
-                      ...rows.length > 0 && (!merged || Object.keys(chosenSummaries).length > 0) ? [SUMMARY_ROW] : []
-                    ];
-                    return footerRows.length > 0 ? { footerRows } : {};
-                  })(),
-                  ...table.data ? {
-                    copy: gridCopyConfig({
-                      tableId,
-                      tableName: tableName(table.data),
-                      fields: ordered,
-                      rowLabel: (row) => recordNameIn(table.data, row.document ?? {})
-                    })
-                  } : {},
+                  footerRows,
+                  ...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,
@@ -11645,154 +12088,18 @@ function Grid({
                       ] })
                     }
                   } : {},
-                  detail: { enabled: false },
-                  window: { enabled: false },
+                  detail: DETAIL_OFF,
+                  window: WINDOW_OFF,
                   ...controls.contextMenu ? { contextMenu: controls.contextMenu } : {},
-                  ...canWrite && editable ? {
-                    spreadsheet: {
-                      enabled: true,
-                      writableColumnIds: pasteableKeys,
-                      onPatch: (patches, intent) => {
-                        if (merged) {
-                          void writeRange(patches, intent);
-                          return;
-                        }
-                        for (const patch of patches) {
-                          editing.setCell(patch.rowId, patch.columnId, patch.value);
-                        }
-                      },
-                      ...merged ? { undoDepth: 0, onSelectionChange: followSelection, controllerRef: sheetController } : {},
-                      columnRefusal: (columnId) => {
-                        const field2 = (fields.data ?? []).find((f) => f.key === columnId);
-                        if (!field2) return `This table has no column called ${columnId}.`;
-                        return `${fieldName(field2)} cannot take a pasted value \u2014 ${fieldTypeLabel(field2)} is worked out or chosen, not typed.`;
-                      },
-                      validateCell: ({ columnId, value }) => {
-                        const field2 = (fields.data ?? []).find((f) => f.key === columnId);
-                        if (!field2) return `This table has no column called ${columnId}.`;
-                        const judged = valueFromPastedText(field2, value === null ? "" : String(value));
-                        return "refusal" in judged ? judged.refusal : void 0;
-                      },
-                      onPastePlan: receivePastePlan,
-                      /*
-                       * TYPE-TO-EDIT (design-system 0.43 `onEditRequest`): the cell a person is on
-                       * opens ITS OWN editor — the Field's — holding what they typed (a letter, an
-                       * IME composition, an Option/AltGr character, dictation). A worked-out column
-                       * or a row this person may not write answers false, so nothing is swallowed.
-                       */
-                      onEditRequest: (address, seed) => {
-                        const field2 = (fields.data ?? []).find((f) => f.key === address.columnId);
-                        if (!field2 || !fieldIsEditable(field2) || !mayWriteRow(address.rowId)) return false;
-                        if (seed !== null && seed !== "" && typingOpens(field2) === "none") return false;
-                        editing.begin({ rowId: address.rowId, key: field2.key }, seed);
-                        return true;
-                      },
-                      ...host.notify ? { notify: (message) => host.notify?.success(message) } : {}
-                    }
-                  } : {
-                    /*
-                     * RANGE SELECTION AND COPY FOR A READER (merge step 3, 0.42 `readOnly`). A person
-                     * who may not change this table may still drag out a range, select all and press
-                     * Cmd-C for a real Excel/Sheets block — the UX walk graded range selection BROKEN
-                     * on a table whose writes were refused. Every write gesture (cut, paste, clear,
-                     * fill, undo) says why it cannot, in the store's own words.
-                     */
-                    spreadsheet: {
-                      enabled: true,
-                      readOnly: true,
-                      ...merged ? { onSelectionChange: followSelection, controllerRef: sheetController } : {},
-                      readOnlyReason: !editable || !rights.known || rights.write ? "Editing is off here, so this table can be copied but not changed." : rights.why("write")
-                    }
-                  },
+                  spreadsheet: spreadsheetConfig,
                   ...groupingConfig ? { grouping: groupingConfig } : {},
                   columnState,
                   ...look.rowHeight ? { rowHeight: look.rowHeight } : {},
-                  virtualize: fills ? { threshold: 40 } : true,
-                  coverage: {
-                    answeredBy: merged ? "source" : "client",
-                    ...merged && typeof records.data?.total === "number" ? { matched: records.data.total } : {},
-                    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
-                    }
-                  } : {},
+                  virtualize: fills ? VIRTUALIZE_FILLED : true,
+                  coverage: tableCoverage,
+                  ...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 }),
@@ -11801,142 +12108,7 @@ function Grid({
                     ...mayAddRow ? { addFirst: /* @__PURE__ */ jsx42(AddFirstRowButton, { onAdd: () => void addRowHere(), busy: added.busy }) } : {},
                     emptyDescription: rights.write ? "Add the first one and it appears here." : rights.known ? `Nothing has been written to this table. ${rights.why("write")}` : "Nothing has been written to this table."
                   }),
-                  toolbar: {
-                    search: true,
-                    searchPlaceholder: "Search records",
-                    /*
-                     * A PHONE (tranche 6o): search and the one Tools button sit side by side at the START of
-                     * the row, so Tools is never scrolled out of reach; the search is the same query.
-                     */
-                    ...merged && phone ? {
-                      customSearch: /* @__PURE__ */ jsx42("div", { className: "flex min-w-0 flex-1 items-center gap-1.5", "data-records-grid-phone-search": "", children: /* @__PURE__ */ jsx42(
-                        "input",
-                        {
-                          type: "search",
-                          value: query.search,
-                          placeholder: "Search",
-                          "aria-label": "Search records",
-                          onChange: (event) => {
-                            const search = event.target.value;
-                            setQuery((held) => ({ ...held, search, page: 1 }));
-                          },
-                          className: "h-8 w-full min-w-0 rounded-md border border-input bg-background px-2 text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
-                          style: { fontSize: "16px" }
-                        }
-                      ) })
-                    } : {},
-                    /* ONE ROW (lane TABLE-PAGE-CHROME): on a table page the grid's search, columns and
-                       sort are drawn INTO the page's toolbar row, never a second bar under it. */
-                    ...toolbarSlot !== void 0 ? { portalInto: toolbarSlot, singleRow: true } : {},
-                    // SCR-2 / SCR-4: PRESENT for an admin, ABSENT for everyone else.
-                    // There is no third state: this package ships no disabled variant of
-                    // these controls, so a member cannot be shown a dead one by mistake.
-                    /*
-                     * WHERE THE GRID'S CONTROLS GO (lane C, review 2026-09-26 D6). Inline when the row has
-                     * room; behind the row's "…" once the page row is folded that far (Undo / Redo and New
-                     * record stay beside it — the primary action is never folded); on a phone EVERY control
-                     * — the table's own (clear, copy/export, group, columns), these, the search, the sort and
-                     * the page's filter, layout and share — in ONE "Tools" sheet. Never dropped.
-                     */
-                    actions: /* @__PURE__ */ jsxs36(Fragment15, { children: [
-                      manual ? /* @__PURE__ */ jsx42(
-                        SortStateControl,
-                        {
-                          ...handOrderSortState({
-                            sortName: columnSort ? columnLabel(fields.data ?? [], columnSort.id) : null,
-                            direction: columnSort?.direction ?? null,
-                            onBack: () => setQuery((held) => ({ ...held, sort: null, page: 1 })),
-                            ...viewOrder?.onUseSort && columnSort ? {
-                              onUseSort: () => {
-                                const sort = columnSort;
-                                const chosen = { field: sort.id, direction: sort.direction };
-                                setHeldOrder({ order: "sorted", sorts: [chosen] });
-                                viewOrder.onUseSort?.(chosen);
-                                host.notify?.success(
-                                  `Sorted by ${columnLabel(fields.data ?? [], sort.id)} ${sortArrow(sort.direction)}. ${MANUAL_SORT.replacedToast}`
-                                );
-                              }
-                            } : {}
-                          })
-                        }
-                      ) : null,
-                      viewId && viewOrder?.onPlaced && rows.length > 1 ? /* @__PURE__ */ jsx42(Button27, { size: "sm", variant: "ghost", onClick: () => setReordering(true), "data-records-reorder-open": "", children: "Reorder" }) : null,
-                      !merged && Boolean(editable) && rights.write ? /* @__PURE__ */ jsx42(Button27, { size: "sm", disabled: editing.busy, onClick: () => void editing.addRecord(), children: editing.busy ? "Adding\u2026" : "New record" }) : null,
-                      rights.structure && onAddField ? /* @__PURE__ */ jsx42(AddFieldButton, { onClick: onAddField }) : null,
-                      /* @__PURE__ */ jsx42(
-                        GridLayoutMenu,
-                        {
-                          look,
-                          firstColumn: sortedKeys[0] ? {
-                            key: sortedKeys[0],
-                            name: (() => {
-                              const first = (fields.data ?? []).find((f) => f.key === sortedKeys[0]);
-                              return first ? fieldName(first) : humanize(sortedKeys[0]);
-                            })()
-                          } : null,
-                          onChange: changeLayout,
-                          kept: Boolean(onPresentationChange)
-                        }
-                      )
-                    ] }),
-                    ...merged ? {
-                      overflow: {
-                        mode: phone ? "sheet" : toolbarFold2 >= 3 ? "menu" : "inline",
-                        pinned: /* @__PURE__ */ jsxs36(Fragment15, { children: [
-                          /* @__PURE__ */ jsx42(UndoRedoButtons, { undo }),
-                          Boolean(editable) && rights.write ? /* @__PURE__ */ jsx42(Button27, { size: "sm", className: "shrink-0", disabled: added.busy, onClick: () => void addRowHere(), children: added.busy ? "Adding\u2026" : "New record" }) : null
-                        ] }),
-                        ...phone ? {
-                          sheetTop: /* @__PURE__ */ jsxs36("div", { className: "flex flex-col gap-1.5 pb-1", "data-records-grid-sheet-top": "", "data-matrx-table-tools-keep-open": "", children: [
-                            /* @__PURE__ */ jsx42(
-                              "input",
-                              {
-                                type: "search",
-                                value: query.search,
-                                placeholder: "Search",
-                                "aria-label": "Search records",
-                                onChange: (event) => {
-                                  const search = event.target.value;
-                                  setQuery((held) => ({ ...held, search, page: 1 }));
-                                },
-                                className: "h-10 w-full min-w-0 rounded-md border border-input bg-background px-2 text-foreground placeholder:text-muted-foreground",
-                                style: { fontSize: "16px" }
-                              }
-                            ),
-                            /* @__PURE__ */ jsxs36("label", { className: "flex items-center gap-2 text-xs text-muted-foreground", "data-records-grid-sheet-sort": "", children: [
-                              /* @__PURE__ */ jsx42("span", { className: "shrink-0", children: "Sort by" }),
-                              /* @__PURE__ */ jsxs36(
-                                "select",
-                                {
-                                  "aria-label": "Sort by",
-                                  value: query.sort ? `${query.sort.id}:${query.sort.direction}` : "",
-                                  onChange: (event) => {
-                                    const [id, direction] = event.target.value.split(":");
-                                    setQuery((held) => ({
-                                      ...held,
-                                      page: 1,
-                                      sort: id ? { id, direction: direction === "desc" ? "desc" : "asc" } : null
-                                    }));
-                                  },
-                                  className: "h-10 min-w-0 flex-1 rounded-md border border-input bg-background px-2 text-foreground",
-                                  style: { fontSize: "16px" },
-                                  children: [
-                                    /* @__PURE__ */ jsx42("option", { value: "", children: "No sort" }),
-                                    ordered.flatMap((field2) => [
-                                      /* @__PURE__ */ jsx42("option", { value: `${field2.key}:asc`, children: `${fieldName(field2)} \u2191` }, `${field2.key}:asc`),
-                                      /* @__PURE__ */ jsx42("option", { value: `${field2.key}:desc`, children: `${fieldName(field2)} \u2193` }, `${field2.key}:desc`)
-                                    ])
-                                  ]
-                                }
-                              )
-                            ] }),
-                            controls.sheetTools
-                          ] }),
-                          ...sheetExtras ? { sheetExtras } : {}
-                        } : {}
-                      }
-                    } : {}
-                  }
+                  toolbar: tableToolbar
                 },
                 `records-grid-${tableId}:${openingKey}`
               )
@@ -12038,6 +12210,58 @@ function Grid({
     }
   ) });
 }
+var DETAIL_OFF = { enabled: false };
+var WINDOW_OFF = { enabled: false };
+var VIRTUALIZE_FILLED = { threshold: 40 };
+function menuFace(items) {
+  return JSON.stringify(items, (_key, value) => typeof value === "function" ? "\u0192" : value);
+}
+function menuThroughLatest(items, at, latest) {
+  return items.map((item) => {
+    const path = `${at}/${item.id}`;
+    return {
+      ...item,
+      ...item.onSelect ? { onSelect: () => latest.get(path)?.() } : {},
+      ...item.submenu ? { submenu: menuThroughLatest(item.submenu, path, latest) } : {}
+    };
+  });
+}
+function bindLatest(items, at, latest) {
+  for (const item of items) {
+    const path = `${at}/${item.id}`;
+    if (item.onSelect) latest.set(path, item.onSelect);
+    if (item.submenu) bindLatest(item.submenu, path, latest);
+  }
+}
+function holdHeaderMenu(held, latest, key, items) {
+  if (!items) return items;
+  const at = `menu:${key}`;
+  bindLatest(items, at, latest);
+  const sig = menuFace(items);
+  const was = held.get(at);
+  if (was && was.sig === sig) return was.value;
+  const value = menuThroughLatest(items, at, latest);
+  held.set(at, { sig, value });
+  return value;
+}
+function holdByContent(held, at, value) {
+  if (value === void 0) return value;
+  const sig = JSON.stringify(value);
+  const was = held.get(at);
+  if (was && was.sig === sig) return was.value;
+  held.set(at, { sig, value });
+  return value;
+}
+function sameColumns(a, b) {
+  if (a === b) return true;
+  if (a.length !== b.length) return false;
+  return a.every((column, i) => {
+    const other = b[i];
+    if (column === other) return true;
+    const keys = Object.keys(column);
+    return keys.length === Object.keys(other).length && keys.every((key) => Object.is(column[key], other[key]));
+  });
+}
 function withHeaderMenus(columns, menuFor, filterFor) {
   return columns.map((column) => {
     const items = menuFor(String(column.id));
@@ -26424,6 +26648,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 +26661,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 +27283,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 +27925,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));