@ai-matrx/records-ui 0.115.38 → 0.115.39

package/CHANGELOG.md

@@ -1,9 +1,15 @@
 # Changelog — @ai-matrx/records-ui
 
-## 0.115.38
+## 0.115.39
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
-`git diff npm/records-ui/v0.115.37..npm/records-ui/v0.115.38 -- apps/shared/records-ui`).
+`git diff npm/records-ui/v0.115.38..npm/records-ui/v0.115.39 -- apps/shared/records-ui`).
+No source changes intended and no consumer action required.
+
+## 0.115.37
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records-ui/v0.115.36..npm/records-ui/v0.115.37 -- apps/shared/records-ui`).
 No source changes intended and no consumer action required.
 
 ## 0.115.36

package/dist/index.cjs

@@ -11978,6 +11978,9 @@ function useGridEditing({ tableId, fields, rows, reload, reloadAfterWrite, canWr
   const startedFrom = (0, import_react66.useRef)(null);
   const startedStored = (0, import_react66.useRef)(null);
   const host = useRecordsUi();
+  const fieldsRef = (0, import_react66.useRef)(fields);
+  fieldsRef.current = fields;
+  const forceNext = (0, import_react66.useRef)(/* @__PURE__ */ new Set());
   const type = (0, import_react66.useCallback)((value) => {
     typed2.current = value;
     setDraft(value);
@@ -12134,6 +12137,47 @@ function useGridEditing({ tableId, fields, rows, reload, reloadAfterWrite, canWr
         delete next[id];
         return next;
       });
+      const syncedField = fieldsRef.current.find((f) => f.key === key);
+      if (syncedField?.source === "synced" && host.writeSyncedCell) {
+        const force = forceNext.current.delete(id);
+        let outcome;
+        try {
+          outcome = await host.writeSyncedCell({ tableId, recordId: rowId, fieldKey: key, value: shown5, force });
+        } catch (thrown) {
+          outcome = { ok: false, message: thrown instanceof Error ? thrown.message : String(thrown) };
+        }
+        setSaving((held) => {
+          const next = { ...held };
+          delete next[id];
+          return next;
+        });
+        if (outcome.ok && outcome.status === "written") {
+          if (typeof outcome.version === "number") {
+            rememberVersion(versions.current, rowId, outcome.version);
+            source.wrote(rowId, outcome.version);
+          }
+          settling.current.set(id, base2);
+          writtenRef.current?.({ rowId, key, before: base2, after: shown5 });
+          afterWrite();
+          return;
+        }
+        setOptimistic((held) => {
+          const next = { ...held };
+          delete next[id];
+          return next;
+        });
+        const sheetValue = outcome.ok ? outcome.sheetValue : null;
+        setRefusals((held) => ({
+          ...held,
+          [id]: outcome.ok ? {
+            error: { code: "stale_write", message: `The sheet now says "${sheetValue ?? ""}". Retry keeps yours.` },
+            conflict: null,
+            attempted: value,
+            sheet: { value: sheetValue }
+          } : { error: { code: "refused_by_rule", message: outcome.message }, conflict: null, attempted: value }
+        }));
+        return;
+      }
       let written;
       try {
         let version = await versionOf(source, versions.current, versionReads.current, rowId);
@@ -12293,6 +12337,7 @@ function useGridEditing({ tableId, fields, rows, reload, reloadAfterWrite, canWr
     (rowId, key) => {
       const held = refusals[cellKey(rowId, key)];
       if (!held) return;
+      if (held.sheet) forceNext.current.add(cellKey(rowId, key));
       void writeCell(rowId, key, held.attempted, held.conflict?.contested_fields[key]);
     },
     [refusals, writeCell]
@@ -20007,6 +20052,20 @@ function columnForField(field2, editing, mayWriteRow, whyNotRow, look, onAskWhoC
   const name = fieldName(field2);
   const format = cellFormatFor(field2, look?.format);
   const workedOut = workedOutFrom(field2);
+  const syncedMark = field2.source === "synced" ? /* @__PURE__ */ (0, import_jsx_runtime69.jsx)(
+    "span",
+    {
+      "data-records-synced": field2.key,
+      title: `Synced from ${look?.syncedFrom || "its source"}`,
+      "aria-label": `Synced from ${look?.syncedFrom || "its source"}`,
+      className: "text-[10px] text-muted-foreground",
+      children: "\u27F3"
+    }
+  ) : null;
+  const withSynced = (header) => syncedMark ? /* @__PURE__ */ (0, import_jsx_runtime69.jsxs)("span", { className: "inline-flex items-center gap-1", children: [
+    syncedMark,
+    header
+  ] }) : header;
   return {
     id: field2.key,
     /*
@@ -20014,38 +20073,40 @@ function columnForField(field2, editing, mayWriteRow, whyNotRow, look, onAskWhoC
      * (`custom.formula_eval`, on read or on write) and nobody types it — so its header carries
      * the mark, and the formula it is worked out from is one hover away, in its own words.
      */
-    header: look?.rowLabel ? (
-      // THE COLUMN THAT NAMES EACH RECORD says so (tranche 6i, the older grid's key marker).
-      /* @__PURE__ */ (0, import_jsx_runtime69.jsxs)("span", { className: "inline-flex items-center gap-1", children: [
+    header: withSynced(
+      look?.rowLabel ? (
+        // THE COLUMN THAT NAMES EACH RECORD says so (tranche 6i, the older grid's key marker).
+        /* @__PURE__ */ (0, import_jsx_runtime69.jsxs)("span", { className: "inline-flex items-center gap-1", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime69.jsx)(
+            "span",
+            {
+              "data-records-row-label": field2.key,
+              title: "This column names each record",
+              "aria-label": "Names each record",
+              className: "text-[10px] text-muted-foreground",
+              children: "\u26BF"
+            }
+          ),
+          name
+        ] })
+      ) : workedOut && stampMarkOf(field2) ? (
+        // A STAMP OR A RECORD NUMBER (walk 2026-10-08 D7): kept by the store, but nobody wrote a formula
+        // for it, so its header wears its own mark — a clock, a person, a number sign — never "fx".
+        /* @__PURE__ */ (0, import_jsx_runtime69.jsx)("span", { className: "inline-flex items-center", title: workedOut, "data-records-stamp": stampMarkOf(field2), children: withTypeMark(field2, name) })
+      ) : workedOut ? /* @__PURE__ */ (0, import_jsx_runtime69.jsxs)("span", { className: "inline-flex items-center gap-1", children: [
+        name,
         /* @__PURE__ */ (0, import_jsx_runtime69.jsx)(
           "span",
           {
-            "data-records-row-label": field2.key,
-            title: "This column names each record",
-            "aria-label": "Names each record",
-            className: "text-[10px] text-muted-foreground",
-            children: "\u26BF"
+            "data-records-worked-out": field2.key,
+            title: workedOut,
+            "aria-label": workedOut,
+            className: "rounded bg-muted px-1 font-mono text-[10px] font-normal text-muted-foreground",
+            children: "fx"
           }
-        ),
-        name
-      ] })
-    ) : workedOut && stampMarkOf(field2) ? (
-      // A STAMP OR A RECORD NUMBER (walk 2026-10-08 D7): kept by the store, but nobody wrote a formula
-      // for it, so its header wears its own mark — a clock, a person, a number sign — never "fx".
-      /* @__PURE__ */ (0, import_jsx_runtime69.jsx)("span", { className: "inline-flex items-center", title: workedOut, "data-records-stamp": stampMarkOf(field2), children: withTypeMark(field2, name) })
-    ) : workedOut ? /* @__PURE__ */ (0, import_jsx_runtime69.jsxs)("span", { className: "inline-flex items-center gap-1", children: [
-      name,
-      /* @__PURE__ */ (0, import_jsx_runtime69.jsx)(
-        "span",
-        {
-          "data-records-worked-out": field2.key,
-          title: workedOut,
-          "aria-label": workedOut,
-          className: "rounded bg-muted px-1 font-mono text-[10px] font-normal text-muted-foreground",
-          children: "fx"
-        }
-      )
-    ] }) : name,
+        )
+      ] }) : name
+    ),
     label: name,
     accessorFn: (row) => row.document?.[field2.key],
     // A column the store keeps no value for is not offered a sort it would refuse (`sortRefusal`).
@@ -25981,7 +26042,8 @@ function GridBody({
             ...presentation.formats?.[field2.key] ? { format: presentation.formats[field2.key] } : {},
             frozen: frozenKeys.has(field2.key),
             // The column that names each record wears the mark (merged grid, tranche 6i).
-            rowLabel: merged && field2.key === (table.data?.title_field ?? null)
+            rowLabel: merged && field2.key === (table.data?.title_field ?? null),
+            syncedFrom: syncedFromWords(table.data)
           },
           onAskWhoChanged,
           {
@@ -27170,6 +27232,12 @@ function withHeaderMenus(columns, menuFor, filterFor) {
     return filter ? { ...withMenu, ...filter } : withMenu;
   });
 }
+function syncedFromWords(table) {
+  const source = table?.sync_source;
+  if (!source?.provider) return null;
+  const from = source.provider === "google_sheets" ? "Google Sheets" : source.provider === "csv_url" ? "a CSV link" : source.provider === "postgres" ? "an outside database" : source.provider === "matrx_view" ? "another table" : source.provider;
+  return source.label ? `${from} \xB7 ${source.label}` : from;
+}
 function withoutGoneColumns(query, liveKeys, openingSort) {
   const sortGone = Boolean(query.sort && !liveKeys.has(query.sort.id));
   const goneFilters = Object.keys(query.columnFilters ?? {}).filter((key) => !liveKeys.has(key));
@@ -35362,7 +35430,7 @@ function TimelineView({
     try {
       const make = async (current, key, label) => {
         if (current) return current.key;
-        const made = await knobClient.fieldDeclare({ table_id: tableId, spec: { key, label, type: "datetime", kind: "date" } });
+        const made = await knobClient.fieldDeclare({ table_id: tableId, spec: { key, label, parity_type: "datetime", kind: "date" } });
         if (!made.ok) {
           moves.say(refusalSentence(made.error));
           return null;