@ai-matrx/records-ui 0.85.15 → 0.85.16

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog — @ai-matrx/records-ui
 
+## 0.85.16
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records-ui/v0.85.15..npm/records-ui/v0.85.16 -- apps/shared/records-ui`).
+No source changes intended and no consumer action required.
+
+## Unreleased — lane VIEW-STATE-PERSONAL (2026-09-25)
+
+Needs `@ai-matrx/records` with `viewLookRead` / `viewLookSet` (Unreleased) and the store doors
+`custom.view_look_read` / `custom.view_look_set` (live on production, 2026-09-25 19:19Z).
+
+### A look at a view is yours until you save it (VERIFIER-23 item 1)
+
+* **Every view-configuration change a person makes while looking is HER look, not the view's.** On
+  production the owner's *Group by → Status* on a board became the tenant liaison's board the next
+  time she opened it: `TablePage` merged every pick onto the shared view (`view_declare`). Now a
+  pick of the board's grouping, the calendar's date field, a sort, a filter, a hidden column, a
+  width, a colour or the layout is kept for that person through `custom.view_look_set` and laid
+  over the view (`applyLook`); a reload keeps it; nobody else sees it. The view row is never
+  written by a pick. (Airtable and Notion's rule; Notion's "Save for everyone" / "Reset".)
+* **One line says so, with its doors** (`[data-view-look]`): *"You changed how this view looks. Only
+  you see it."* · **Save to view** (someone who may edit the table; the one `view_declare`, and the
+  default view's layout stays the person's look — "Make … the default" is that door) · **Save as
+  new view** (editor; the look becomes a view of its own) · **Reset to view** (everyone; the look is
+  archived). A viewer never sees Save to view or Save as new view — absent, not dead.
+* **Reorder is offered only to someone who may edit the table**: a hand-set order is the view's
+  sort for everybody (`view_record_order_set` now needs editor; the store refuses it otherwise).
+* New module `viewLook.ts` (exported): `ViewLook`, `lookPart`, `lookDocument`, `lookFromDocument`,
+  `applyLook`, `lookDiffers`, `saveToViewPlan`, `readLooks`, `keepLook`, `LOOK_WORDS`.
+* Suite `a-look-at-a-view-is-yours-until-you-save-it.test.tsx`: RED 4/6 on the prior `TablePage` /
+  `ViewSwitcher` (the pick sent `view_declare`; no look, no Save / Reset) → GREEN 6/6.
+
 ## 0.85.15 (2026-09-25 — published by PUBLISH-SWEEP-7)
 
 The tagged 0.85.14 never reached npm: its deterministic gate failed on `NeverRecorded … custom.field_declare` (fixture recorded against records 0.58.11). The fixture is re-recorded (below); everything 0.85.14 carried ships here. Needs `@ai-matrx/records` >= 0.58.13 (`viewDesignate` / `custom.view_designate`).

package/dist/index.cjs

@@ -116,6 +116,7 @@ __export(src_exports, {
   LAYOUT_NEEDS: () => LAYOUT_NEEDS,
   LAYOUT_NO_FIELD: () => LAYOUT_NO_FIELD,
   LEVEL_WORD: () => LEVEL_WORD,
+  LOOK_WORDS: () => LOOK_WORDS,
   MACHINE_IDENTITY: () => MACHINE_IDENTITY,
   MAX_ROW_HEIGHT: () => MAX_ROW_HEIGHT,
   MIN_ROW_HEIGHT: () => MIN_ROW_HEIGHT,
@@ -215,6 +216,7 @@ __export(src_exports, {
   actorBadge: () => actorBadge,
   actorWords: () => actorWords,
   addFields: () => import_core11.addFields,
+  applyLook: () => applyLook,
   archivedRowLine: () => archivedRowLine,
   asRefusal: () => asRefusal,
   askableFields: () => askableFields,
@@ -274,11 +276,16 @@ __export(src_exports, {
   isPlainFieldType: () => isPlainFieldType,
   isRelationFieldType: () => isRelationFieldType,
   isSignatureField: () => isSignatureField,
+  keepLook: () => keepLook,
   keptByTheApp: () => keptByTheApp,
   keyFor: () => keyFor,
   kindsWithNoChoice: () => kindsWithNoChoice,
   laneFor: () => laneFor,
   lastChangeSentence: () => lastChangeSentence,
+  lookDiffers: () => lookDiffers,
+  lookDocument: () => lookDocument,
+  lookFromDocument: () => lookFromDocument,
+  lookPart: () => lookPart,
   looksLikeId: () => looksLikeId,
   machineIdentityIn: () => machineIdentityIn,
   mayNotRestoreLine: () => mayNotRestoreLine,
@@ -299,6 +306,7 @@ __export(src_exports, {
   previewWords: () => previewWords,
   publiclyAnswerable: () => publiclyAnswerable,
   railFromParam: () => railFromParam,
+  readLooks: () => readLooks,
   recordName: () => recordName,
   recordNameIn: () => recordNameIn,
   recordsDataSource: () => recordsDataSource,
@@ -312,6 +320,7 @@ __export(src_exports, {
   revokeConsequence: () => revokeConsequence,
   rowName: () => rowName,
   rowNameIn: () => rowNameIn,
+  saveToViewPlan: () => saveToViewPlan,
   saveViewPatch: () => saveViewPatch,
   scalarText: () => scalarText,
   seedIsSatisfied: () => seedIsSatisfied,
@@ -10831,6 +10840,86 @@ function computedInPlainWords(row, field) {
   return `${name} was worked out as ${shown3}${at}.`;
 }
 
+// src/viewLook.ts
+var LOOK_KEYS = [
+  "layout",
+  "groupField",
+  "swimlaneField",
+  "collapsedColumns",
+  "measure",
+  "dateField",
+  "imageField",
+  "sorts",
+  "where",
+  "presentation"
+];
+function lookPart(patch) {
+  const out = {};
+  for (const key of LOOK_KEYS) {
+    if (patch[key] !== void 0) out[key] = patch[key];
+  }
+  return out;
+}
+function lookDocument(look) {
+  return viewSettingsPatch(look);
+}
+function lookFromDocument(doc) {
+  const data = doc ?? {};
+  const read = viewSettings(data);
+  const out = {};
+  const has = (key) => Object.prototype.hasOwnProperty.call(data, key);
+  if (has("layout") && VIEW_LAYOUTS.includes(String(data["layout"]))) {
+    out.layout = data["layout"];
+  }
+  if (has("group_field")) out.groupField = read.groupField;
+  if (has("swimlane_field")) out.swimlaneField = read.swimlaneField;
+  if (has("collapsed_columns")) out.collapsedColumns = read.collapsedColumns;
+  if (has("measure")) out.measure = read.measure;
+  if (has("date_field")) out.dateField = read.dateField;
+  if (has("image_field")) out.imageField = read.imageField;
+  if (has("sorts")) out.sorts = read.sorts;
+  if (has("where")) out.where = read.where;
+  if (has("presentation")) out.presentation = parseGridPresentation(data["presentation"]);
+  return out;
+}
+function applyLook(view, look) {
+  if (!look) return view;
+  return { ...view, ...look };
+}
+function lookDiffers(view, look) {
+  if (!look) return false;
+  const shown3 = applyLook(view, look);
+  return LOOK_KEYS.some(
+    (key) => look[key] !== void 0 && JSON.stringify(shown3[key] ?? null) !== JSON.stringify(view[key] ?? null)
+  );
+}
+function saveToViewPlan(view, look) {
+  const patch = viewPatchFor(view, look);
+  const left = {};
+  if (look.layout !== void 0 && patch.layout === void 0 && look.layout !== view.layout) left.layout = look.layout;
+  return { patch, left: Object.keys(left).length > 0 ? left : null };
+}
+async function readLooks(client, tableId) {
+  const answered = await client.viewLookRead({ table_id: tableId });
+  if (!answered.ok) return answered;
+  const out = {};
+  for (const [viewId, row] of Object.entries(answered.data ?? {})) {
+    out[viewId] = lookFromDocument(row?.look ?? null);
+  }
+  return { ok: true, data: out };
+}
+async function keepLook(client, tableId, viewId, look) {
+  const doc = look ? lookDocument(look) : null;
+  return client.viewLookSet({ table_id: tableId, view_id: viewId, look: doc && Object.keys(doc).length > 0 ? doc : null });
+}
+var LOOK_WORDS = {
+  yours: "You changed how this view looks. Only you see it.",
+  saveToView: "Save to view",
+  saveAsNew: "Save as new view",
+  reset: "Reset to view",
+  newName: "Name for the new view"
+};
+
 // src/ViewSwitcher.tsx
 var import_react67 = require("react");
 var import_react68 = require("@ai-matrx/records/react");
@@ -11726,10 +11815,14 @@ function ViewSwitcher({
             viewId,
             order: local.order !== void 0 ? local.order : view.order ?? null,
             sorts: local.sorts ?? view.sorts ?? [],
-            onPlaced: () => {
-              setLocal((held) => ({ ...held, order: "manual", sorts: [] }));
-              onOrderPlaced?.();
-            },
+            /* Placing the rows saves the VIEW's order, so Reorder is offered only when the
+               host bound it (TablePage: to someone who may edit the table). */
+            ...onOrderPlaced ? {
+              onPlaced: () => {
+                setLocal((held) => ({ ...held, order: "manual", sorts: [] }));
+                onOrderPlaced();
+              }
+            } : {},
             ...onViewChange ? {
               onUseSort: (sort) => change({ sorts: [sort], order: "sorted" })
             } : {}
@@ -22646,6 +22739,21 @@ function TablePage({
   const askedInWords = filter ? filterInWords(filter, pageFields.data ?? []) : null;
   const organizationId = (0, import_react147.useRecordsClient)().config.organizationId;
   const [view, setView] = (0, import_react146.useState)(null);
+  const [looks, setLooks] = (0, import_react146.useState)(void 0);
+  (0, import_react146.useEffect)(() => {
+    let live = true;
+    setLooks(void 0);
+    void readLooks(client, tableId).then((answered) => {
+      if (!live) return;
+      setLooks(answered.ok ? answered.data : {});
+    });
+    return () => {
+      live = false;
+    };
+  }, [client, tableId]);
+  const look = view && looks ? looks[view.id] : void 0;
+  const shown3 = view ? applyLook(view, look) : null;
+  const [viewsEpoch, setViewsEpoch] = (0, import_react146.useState)(0);
   const opening = openingRail(activeRecordId, activeRail);
   const hostLayouts = useRecordsUi().layouts ?? [];
   const hostLayoutFor = (asked) => openingHostLayout(asked, hostLayouts);
@@ -22680,9 +22788,9 @@ function TablePage({
     if (hostFromLink || opened.layout || layoutChosen) return;
     setHostLayout(face.hostLayout);
   }, [face.kind, face.kind === "designated" ? face.hostLayout : null, layoutChosen]);
-  const faceUnknown = !hostFromLink && !opened.layout && (views === void 0 || Array.isArray(views) && views.length > 0 && view === null);
-  const shownLayout = layoutFromLink ?? view?.layout ?? "grid";
-  const shownFilter = filter ?? (view?.where ? view.where : null) ?? (view?.filters && Object.keys(view.filters).length > 0 ? view.filters : null);
+  const faceUnknown = !hostFromLink && !opened.layout && (views === void 0 || Array.isArray(views) && views.length > 0 && (view === null || looks === void 0));
+  const shownLayout = layoutFromLink ?? shown3?.layout ?? "grid";
+  const shownFilter = filter ?? (shown3?.where ? shown3.where : null) ?? (shown3?.filters && Object.keys(shown3.filters).length > 0 ? shown3.filters : null);
   const press = (pressed) => {
     const next = chooseSurface(surface, pressed);
     setSurface(next);
@@ -22737,16 +22845,79 @@ function TablePage({
     async (asked) => {
       const current = view;
       if (!current) return;
-      const patch = viewPatchFor(current, asked);
-      setView({ ...current, ...patch });
-      if (Object.keys(viewPatchDocument(patch)).length === 0 && patch.name === void 0 && patch.filters === void 0) return;
+      const part = lookPart(asked);
+      if (Object.keys(part).length === 0) return;
+      const before = looks?.[current.id];
+      const next = { ...before ?? {}, ...part };
+      setLooks((all) => ({ ...all ?? {}, [current.id]: next }));
       setViewSaveRefused(null);
-      const written = await saveViewPatch(client, tableId, current.id, patch);
-      if (written.ok) return;
-      setViewSaveRefused({ error: written.error, patch, before: current });
+      const kept = await keepLook(client, tableId, current.id, next);
+      if (kept.ok) return;
+      setViewSaveRefused({ error: kept.error, patch: asked, lookBefore: before });
     },
-    [client, tableId, view]
+    [client, tableId, view, looks]
   );
+  const lookShowing = Boolean(view && looks && lookDiffers(view, looks[view.id]));
+  const [lookRefused, setLookRefused] = (0, import_react146.useState)(null);
+  const [namingLook, setNamingLook] = (0, import_react146.useState)(false);
+  const [lookName, setLookName] = (0, import_react146.useState)("");
+  const resetLook = async () => {
+    const current = view;
+    if (!current) return;
+    setLookRefused(null);
+    setViewSaveRefused(null);
+    const before = looks?.[current.id];
+    setLooks((all) => {
+      const { [current.id]: _gone, ...rest } = all ?? {};
+      return rest;
+    });
+    const kept = await keepLook(client, tableId, current.id, null);
+    if (!kept.ok) {
+      setLooks((all) => ({ ...all ?? {}, [current.id]: before ?? {} }));
+      setLookRefused(kept.error);
+    }
+  };
+  const saveLookToView = async () => {
+    const current = view;
+    const mine = current && looks ? looks[current.id] : void 0;
+    if (!current || !mine) return;
+    setLookRefused(null);
+    const { patch, left } = saveToViewPlan(current, mine);
+    if (Object.keys(viewPatchDocument(patch)).length > 0) {
+      const written = await saveViewPatch(client, tableId, current.id, patch);
+      if (!written.ok) {
+        setLookRefused(written.error);
+        return;
+      }
+      setView({ ...current, ...patch });
+    }
+    setLooks((all) => {
+      const { [current.id]: _saved, ...rest } = all ?? {};
+      return left ? { ...rest, [current.id]: left } : rest;
+    });
+    const kept = await keepLook(client, tableId, current.id, left);
+    if (!kept.ok) setLookRefused(kept.error);
+  };
+  const saveLookAsNewView = async (name) => {
+    const current = view;
+    const seen = shown3;
+    if (!current || !seen || name.trim() === "") return;
+    setLookRefused(null);
+    const written = await declareView(client, { ...seen, name: name.trim(), subject: tableId, isDefault: false });
+    if (!written.ok) {
+      setLookRefused(written.error);
+      return;
+    }
+    setNamingLook(false);
+    setLookName("");
+    setLooks((all) => {
+      const { [current.id]: _moved, ...rest } = all ?? {};
+      return rest;
+    });
+    void keepLook(client, tableId, current.id, null);
+    setPickedViewId(written.data);
+    setViewsEpoch((n) => n + 1);
+  };
   const [designateRefused, setDesignateRefused] = (0, import_react146.useState)(null);
   const opensAs = view?.isDefault ? openingLayoutOf(view) : null;
   const canDesignate = Boolean(rights.write && view && layoutShowing && layoutShowing !== opensAs);
@@ -22789,7 +22960,8 @@ function TablePage({
             quietWhenAlone: !showViews,
             seed: seedViews ?? [defaultView(tableId)],
             className: "min-w-0 flex-1"
-          }
+          },
+          viewsEpoch
         ),
         /* @__PURE__ */ (0, import_jsx_runtime79.jsxs)("div", { className: "ml-auto flex shrink-0 items-center gap-1", "data-table-cluster": "", children: [
           chooserInline ? /* @__PURE__ */ (0, import_jsx_runtime79.jsxs)("div", { className: "flex items-center gap-0.5", role: "group", "aria-label": "Layout", children: [
@@ -22816,7 +22988,7 @@ function TablePage({
               `host:${option.id}`
             ))
           ] }) : null,
-          main === "records" && !hostLayout ? /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(ViewFilter, { tableId, view, onApply: (where) => void patchView({ where }) }) : null,
+          main === "records" && !hostLayout ? /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(ViewFilter, { tableId, view: shown3, onApply: (where) => void patchView({ where }) }) : null,
           rights.write && view && main === "records" && !hostLayout && shownLayout !== "grid" ? /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(import_design_system71.Button, { size: "sm", onClick: () => show("new-record"), children: "New record" }) : null,
           openedFromMenu ? /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(
             import_design_system71.Button,
@@ -22916,7 +23088,13 @@ function TablePage({
                 size: "sm",
                 variant: "ghost",
                 onClick: () => {
-                  setView(viewSaveRefused.before);
+                  const current = view;
+                  if (current) {
+                    setLooks((all) => {
+                      const { [current.id]: _dropped, ...rest } = all ?? {};
+                      return viewSaveRefused.lookBefore ? { ...rest, [current.id]: viewSaveRefused.lookBefore } : rest;
+                    });
+                  }
                   setViewSaveRefused(null);
                 },
                 children: "Discard"
@@ -22925,6 +23103,36 @@ function TablePage({
           ] })
         }
       ) : null,
+      lookShowing && main === "records" ? /* @__PURE__ */ (0, import_jsx_runtime79.jsxs)("div", { className: "flex min-w-0 flex-wrap items-center gap-1.5 text-xs text-muted-foreground", "data-view-look": "", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime79.jsx)("span", { className: "truncate", children: LOOK_WORDS.yours }),
+        rights.write && view && Object.keys(viewPatchDocument(saveToViewPlan(view, look ?? {}).patch)).length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(import_design_system71.Button, { size: "sm", variant: "outline", className: "h-7", onClick: () => void saveLookToView(), "data-view-look-save": "", children: LOOK_WORDS.saveToView }) : null,
+        rights.write ? namingLook ? /* @__PURE__ */ (0, import_jsx_runtime79.jsxs)(
+          "form",
+          {
+            className: "flex items-center gap-1",
+            onSubmit: (e) => {
+              e.preventDefault();
+              void saveLookAsNewView(lookName);
+            },
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(
+                import_design_system71.Input,
+                {
+                  autoFocus: true,
+                  "aria-label": LOOK_WORDS.newName,
+                  value: lookName,
+                  onChange: (e) => setLookName(e.target.value),
+                  className: "h-7 w-44 text-xs",
+                  placeholder: "View name"
+                }
+              ),
+              /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(import_design_system71.Button, { size: "sm", type: "submit", className: "h-7", disabled: lookName.trim() === "", children: "Save" })
+            ]
+          }
+        ) : /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(import_design_system71.Button, { size: "sm", variant: "ghost", className: "h-7", onClick: () => setNamingLook(true), "data-view-look-save-new": "", children: LOOK_WORDS.saveAsNew }) : null,
+        /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(import_design_system71.Button, { size: "sm", variant: "ghost", className: "h-7", onClick: () => void resetLook(), "data-view-look-reset": "", children: LOOK_WORDS.reset })
+      ] }) : null,
+      lookRefused ? /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(RefusalNotice, { error: lookRefused }) : null,
       main === "dashboards" ? /* @__PURE__ */ (0, import_jsx_runtime79.jsx)(DashboardCanvas, { tableId, activeDashboardId: activeDashboardId ?? null }) : main === "archived" ? (
         /* THE ROWS THAT LEFT. Restoring one puts it back in the grid, so the
            page returns to the records rather than leaving the person looking
@@ -22960,7 +23168,7 @@ function TablePage({
             chooser: false,
             openExport: () => setRail("export"),
             view: {
-              ...view ?? defaultView(tableId),
+              ...shown3 ?? defaultView(tableId),
               layout: shownLayout,
               // The address's field wins for this visit; silence keeps the
               // saved view's own choice, exactly as it always did.
@@ -22981,7 +23189,12 @@ function TablePage({
             ...view ? { onViewChange: (patch) => void patchView(patch) } : {},
             ...view ? {
               viewId: view.id,
-              onOrderPlaced: () => setView((current) => current ? { ...current, order: "manual", sorts: [] } : current)
+              /* A hand-set order is the VIEW's sort for everybody (VIEW-STATE-PERSONAL): placing
+                 the rows is saving to the view, so it is offered to someone who may edit the
+                 table and is absent otherwise (the store refuses it too). */
+              ...rights.write ? {
+                onOrderPlaced: () => setView((current) => current ? { ...current, order: "manual", sorts: [] } : current)
+              } : {}
             } : {},
             ...rights.write ? { onNewRecordForm: () => setRail("new-record") } : {},
             onOpenRecord: (recordId) => {