@ai-matrx/records-ui 0.9.0 → 0.10.3

package/CHANGELOG.md

@@ -1,5 +1,94 @@
 # Changelog — @ai-matrx/records-ui
 
+## 0.10.3
+
+Reissues the unpublished 0.10.2 candidate. Its live-store release gate exposed
+a race in the field-add smoke harness: it unmounted each panel immediately
+after clicking Save, before the asynchronous declaration had landed. The
+helper now waits until the real store reports the exact new Field before
+proceeding. Package behavior is unchanged.
+
+### Consumer action
+
+None.
+
+## 0.10.2
+
+Reissues the unpublished 0.10.1 candidate after its live-store release gate
+revealed that the demo selector read `document.title` while the actual
+`custom.record` row exposes the record payload as `data.title`. The smoke test
+now selects Acme Industrial from the real row shape; package behavior is unchanged.
+
+### Consumer action
+
+None.
+
+## 0.10.1
+
+Reissues the unpublished 0.10.0 package after its live-store smoke test selected
+the oldest demo record while asserting the identity of Acme Industrial. The
+test now selects that record by title, so re-seeding cannot substitute another
+record. Package behavior is unchanged from the 0.10.0 candidate.
+
+### Consumer action
+
+None.
+
+## 0.10.0
+
+**The three things the 19 September verdict (fifth pass) said a person hits the
+moment they touch a table.**
+
+**A double-click opens the typed editor, on every cell.** The verdict: "only the
+Title column can be opened by double-clicking; double-clicking any other cell
+opens a developer inspector — a floating window showing the record's raw JSON,
+its machine keys, a truncated id, and the headings DOCUMENT, LEVEL and HIDDEN."
+Two things did that. The data table ships a side panel AND a floating window,
+both falling back to `DataRowInspector`; the grid now turns both OFF, because
+this package has a record panel of its own (`Peek`, through `onRowOpen`) and a
+second one beside it is the parallel layer the platform forbids. And a cell now
+FILLS its cell and answers `dblclick` itself — the second press used to land on
+bare table cell after the first had swapped the DOM under the pointer, and a
+bare cell is a row click, which is exactly why a wide column worked and every
+narrow one did not.
+
+**Tab commits the typed value before it moves.** The verdict: "when we tabbed
+along a row, the first five values saved and the last four were silently
+dropped." The draft used to live in the open CELL, and this screen re-renders
+that cell for reasons that have nothing to do with the person typing — every
+accepted write calls `reload()`, which rebuilds the rows, the columns and the
+cells. A cell that remounted mid-edit came back initialised from the stored
+value, so the commit wrote what was already there and the screen correctly
+treated it as "nothing changed". The draft now lives in the editing session,
+beside the address of the open cell and the value it started from; `commit(move)`
+takes no value at all, because there is only one place the typed value can be
+read from. The editor is focused once per opening rather than on every render.
+
+**"Total of linked records" can be added, and a refusal is a sentence.** The
+panel now offers EVERY relation column — including the ones that hold a single
+record, marked "holds one" — because hiding "Crew lead" from the list taught a
+person nothing. `whatIsMissing` asks, in the panel's own words, what has not been
+answered yet ("Crew lead points at one record at a time, so there is nothing to
+total. Tick 'Can hold more than one' on Crew lead, or use Borrowed value to read
+its one value."), the sentence sits under the button, and the panel never sends a
+declaration it already knows the store must refuse.
+
+**A hint written for an engineer never reaches a person.** A store refusal
+carries a message for the person and a hint for whoever has to fix the caller
+("FLD-11: … config.via names a relation Field of this same table, by its key").
+This package printed both. `hintForAPerson` now filters the hint BY SHAPE — a
+contract row id, a schema-qualified database object, a path inside a document,
+a snake_case identifier or a SQLSTATE — and what it filters joins the SQLSTATE on
+the notice's title, for an engineer. A hint in ordinary words is still shown
+verbatim.
+
+New exports: `whatIsMissing`, `hintForAPerson`, `hintIsMachineIdentity`.
+
+### Consumer action
+
+None. `GridEditing.commit` now takes `(move)` instead of `(value, move)` and
+carries `draft` / `type`; nothing outside this package calls it.
+
 ## 0.9.0
 
 **Sharing reaches the record and table screens (SCR-N-5).** `ShareControl` puts a

package/dist/index.cjs

@@ -134,6 +134,8 @@ __export(src_exports, {
   formDocument: () => formDocument,
   formFromRecord: () => formFromRecord,
   groupLabel: () => groupLabel,
+  hintForAPerson: () => hintForAPerson,
+  hintIsMachineIdentity: () => hintIsMachineIdentity,
   humanize: () => humanize,
   idsOf: () => idsOf,
   isId: () => isId,
@@ -166,7 +168,8 @@ __export(src_exports, {
   useViewRecords: () => useViewRecords,
   viewDocument: () => viewDocument,
   viewFromRecord: () => viewFromRecord,
-  viewPatchDocument: () => viewPatchDocument
+  viewPatchDocument: () => viewPatchDocument,
+  whatIsMissing: () => whatIsMissing
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -873,27 +876,49 @@ var TITLE = {
   store_not_served: "The store is not being served",
   internal: "The store said something this package does not recognise"
 };
+var MACHINE_IDENTITY = [
+  /\b[A-Z]{2,4}-\d{1,3}\b/,
+  // FLD-11, REC-29, AGT-7
+  /\b(?:custom|platform|iam|history|public)\.[a-z_]+/,
+  // a database object
+  /\b(?:config|data|document|spec)\.[a-z_]+/,
+  // a path inside a document
+  /\b[a-z]+(?:_[a-z]+)+\b/,
+  // any snake_case identifier
+  // A SQLSTATE: five characters of digits and capitals, at least one a digit —
+  // so `23514` and `PT409` match and an emphatic `NEVER` does not.
+  /\b(?=[0-9A-Z]{5}\b)(?=[0-9A-Z]*\d)[0-9A-Z]{5}\b/
+];
+function hintIsMachineIdentity(hint) {
+  return MACHINE_IDENTITY.some((shape) => shape.test(hint));
+}
+function hintForAPerson(hint) {
+  const said = (hint ?? "").trim();
+  if (said === "") return null;
+  return hintIsMachineIdentity(said) ? null : said;
+}
 function RefusalNotice({
   error,
   className,
   actions
 }) {
+  const hint = hintForAPerson(error.hint);
+  const forEngineers = [
+    error.sqlstate ? `The store's code for this was ${error.sqlstate}.` : null,
+    hint === null && error.hint ? error.hint : null
+  ].filter(Boolean).join(" ");
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
     import_design_system4.Alert,
     {
       variant: "destructive",
       className: (0, import_design_system4.cn)("text-xs", className),
-      ...error.sqlstate ? { title: `The store's code for this was ${error.sqlstate}` } : {},
+      ...forEngineers ? { title: forEngineers } : {},
       children: [
         /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_design_system4.AlertTitle, { className: "text-xs font-medium", children: TITLE[error.code] ?? "The store refused this" }),
         /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_design_system4.AlertDescription, { className: "space-y-1 text-xs", children: [
           /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { children: error.message }),
-          error.hint ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { className: "opacity-80", children: error.hint }) : null,
-          error.sqlstate ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("p", { className: "sr-only", "data-sqlstate": error.sqlstate, children: [
-            "The store's code for this was ",
-            error.sqlstate,
-            "."
-          ] }) : null,
+          hint ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { className: "opacity-80", children: hint }) : null,
+          forEngineers ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { className: "sr-only", ...error.sqlstate ? { "data-sqlstate": error.sqlstate } : {}, children: forEngineers }) : null,
           actions
         ] })
       ]
@@ -901,7 +926,14 @@ function RefusalNotice({
   );
 }
 function RefusalLine({ error, className }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { className: (0, import_design_system4.cn)("text-xs text-destructive", className), title: error.hint ?? void 0, children: error.message });
+  const hint = hintForAPerson(error.hint);
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("p", { className: (0, import_design_system4.cn)("text-xs text-destructive", className), title: error.hint ?? void 0, children: [
+    error.message,
+    hint ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("span", { className: "opacity-80", children: [
+      " ",
+      hint
+    ] }) : null
+  ] });
 }
 
 // src/values.tsx
@@ -1081,6 +1113,8 @@ async function versionOf(client, cache, recordId) {
 function useGridEditing({ tableId, fields, rows, reload, canWrite }) {
   const client = (0, import_react11.useRecordsClient)();
   const [editing, setEditing] = (0, import_react10.useState)(null);
+  const [draft, setDraft] = (0, import_react10.useState)(null);
+  const startedFrom = (0, import_react10.useRef)(null);
   const [optimistic, setOptimistic] = (0, import_react10.useState)({});
   const [saving, setSaving] = (0, import_react10.useState)({});
   const [refusals, setRefusals] = (0, import_react10.useState)({});
@@ -1112,15 +1146,31 @@ function useGridEditing({ tableId, fields, rows, reload, canWrite }) {
     (rowId, key) => refusals[cellKey(rowId, key)] ?? null,
     [refusals]
   );
+  const shownValue = (0, import_react10.useCallback)(
+    (rowId, key) => {
+      const held = optimistic[cellKey(rowId, key)];
+      if (held !== void 0) return held;
+      return rows.find((r) => r.id === rowId)?.document?.[key];
+    },
+    [optimistic, rows]
+  );
   const begin = (0, import_react10.useCallback)(
     (address) => {
       if (!canWrite) return;
+      if (editing && editing.rowId === address.rowId && editing.key === address.key) return;
+      const current = shownValue(address.rowId, address.key);
+      startedFrom.current = current;
+      setDraft(current);
       setEditing(address);
       void versionOf(client, versions.current, address.rowId);
     },
-    [canWrite, client]
+    [canWrite, client, editing, shownValue]
   );
-  const cancel = (0, import_react10.useCallback)(() => setEditing(null), []);
+  const cancel = (0, import_react10.useCallback)(() => {
+    setEditing(null);
+    setDraft(null);
+    startedFrom.current = null;
+  }, []);
   const writeCellNow = (0, import_react10.useCallback)(
     async (rowId, key, value2) => {
       const id = cellKey(rowId, key);
@@ -1182,21 +1232,31 @@ function useGridEditing({ tableId, fields, rows, reload, canWrite }) {
     [client, reload]
   );
   const commit = (0, import_react10.useCallback)(
-    (value2, move = null) => {
+    (move = null) => {
       const open = editing;
       if (!open) return;
-      const row = rows.find((r) => r.id === open.rowId);
-      const unchanged = row !== void 0 && sameValue(row.document?.[open.key], value2);
-      if (!unchanged) void writeCell(open.rowId, open.key, value2);
+      const value2 = draft;
+      if (!sameValue(startedFrom.current, value2)) void writeCell(open.rowId, open.key, value2);
       if (!move) {
         setEditing(null);
+        setDraft(null);
+        startedFrom.current = null;
         return;
       }
       const next = step(open, order, rowIds, move);
+      if (!next) {
+        setEditing(null);
+        setDraft(null);
+        startedFrom.current = null;
+        return;
+      }
+      const starting = shownValue(next.rowId, next.key);
+      startedFrom.current = starting;
+      setDraft(starting);
       setEditing(next);
-      if (next) void versionOf(client, versions.current, next.rowId);
+      void versionOf(client, versions.current, next.rowId);
     },
-    [editing, rows, writeCell, order, rowIds, client]
+    [editing, draft, writeCell, order, rowIds, client, shownValue]
   );
   const retry = (0, import_react10.useCallback)(
     (rowId, key) => {
@@ -1251,12 +1311,18 @@ function useGridEditing({ tableId, fields, rows, reload, canWrite }) {
     }
     reload();
     const first = order[0];
-    if (first) setEditing({ rowId: written.data, key: first });
+    if (first) {
+      startedFrom.current = void 0;
+      setDraft(void 0);
+      setEditing({ rowId: written.data, key: first });
+    }
     return null;
   }, [client, tableId, reload, order]);
   return {
     valueFor,
     editing,
+    draft,
+    type: setDraft,
     stateOf,
     refusalOf,
     begin,
@@ -1319,27 +1385,40 @@ function GridCell({
       OpenCell,
       {
         field,
-        value: value2,
-        onCommit: (next, move) => editing.commit(next, move),
+        draft: editing.draft,
+        onType: editing.type,
+        onCommit: (move) => editing.commit(move),
         onCancel: editing.cancel
       }
     );
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { "data-matrx-cell-control": "", className: "flex min-w-0 flex-col gap-0.5", children: [
+  const openThisCell = (event) => {
+    event.preventDefault();
+    event.stopPropagation();
+    editing.begin({ rowId: row.id, key: field.key });
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { "data-matrx-cell-control": "", className: "flex w-full min-w-0 flex-col gap-0.5", children: [
     /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
       "span",
       {
         role: editable ? "button" : void 0,
         tabIndex: editable ? 0 : void 0,
         "aria-label": editable ? `Edit ${fieldName(field)}` : void 0,
-        title: editable ? `${fieldName(field)} \u2014 press Enter to edit` : void 0,
+        title: editable ? `${fieldName(field)} \u2014 click or press Enter to edit` : `${fieldName(field)} is worked out by the system, so it cannot be typed in`,
         className: (0, import_design_system6.cn)(
-          "block min-w-0 truncate rounded px-1 py-0.5",
+          // `w-full` so the whole cell is the control. A gap beside it is bare
+          // table cell, and a click there is a row click.
+          "block w-full min-w-0 truncate rounded px-1 py-0.5",
           editable ? "cursor-text hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring" : "",
           state === "saving" ? "opacity-60" : "",
           state === "refused" ? "ring-1 ring-destructive" : ""
         ),
-        onClick: editable ? () => editing.begin({ rowId: row.id, key: field.key }) : void 0,
+        onClick: editable ? openThisCell : void 0,
+        onDoubleClick: (event) => {
+          event.preventDefault();
+          event.stopPropagation();
+          if (editable) editing.begin({ rowId: row.id, key: field.key });
+        },
         onKeyDown: editable ? (event) => {
           if (event.key === "Enter" || event.key === "F2") {
             event.preventDefault();
@@ -1382,11 +1461,11 @@ function closesOnBlur(field) {
 }
 function OpenCell({
   field,
-  value: value2,
+  draft,
+  onType,
   onCommit,
   onCancel
 }) {
-  const [draft, setDraft] = (0, import_react10.useState)(value2);
   const multiline = editorKindFor(field) === "long_text";
   const blurCommits = closesOnBlur(field);
   const done = (0, import_react10.useRef)(false);
@@ -1395,22 +1474,24 @@ function OpenCell({
     done.current = true;
     run();
   };
+  const host = (0, import_react10.useRef)(null);
+  (0, import_react10.useEffect)(() => {
+    const control = host.current?.querySelector("input, textarea, [role='combobox'], button");
+    if (control && document.activeElement !== control) control.focus();
+  }, [field.id]);
   const blur = blurCommits ? {
     onBlur: (event) => {
       if (event.currentTarget.contains(event.relatedTarget)) return;
-      once(() => onCommit(draft, null));
+      once(() => onCommit(null));
     }
   } : {};
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
     "span",
     {
+      ref: host,
       "data-matrx-cell-control": "",
-      className: "flex min-w-[10rem] flex-col gap-1",
-      ref: (node) => {
-        if (!node) return;
-        const control = node.querySelector("input, textarea, [role='combobox'], button");
-        if (control && document.activeElement !== control) control.focus();
-      },
+      className: "flex w-full min-w-[10rem] flex-col gap-1",
+      onDoubleClick: (event) => event.stopPropagation(),
       onKeyDown: (event) => {
         if (event.key === "Escape") {
           event.preventDefault();
@@ -1421,20 +1502,20 @@ function OpenCell({
         if (event.key === "Tab") {
           event.preventDefault();
           event.stopPropagation();
-          once(() => onCommit(draft, event.shiftKey ? "previous" : "next"));
+          once(() => onCommit(event.shiftKey ? "previous" : "next"));
           return;
         }
         if (event.key === "Enter" && (!multiline || event.metaKey || event.ctrlKey)) {
           event.preventDefault();
           event.stopPropagation();
-          once(() => onCommit(draft, null));
+          once(() => onCommit(null));
         }
       },
       ...blur,
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(FieldControl, { field, value: draft, onChange: setDraft, id: `cell-${field.id}` }),
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(FieldControl, { field, value: draft, onChange: onType, id: `cell-${field.id}` }),
         blurCommits ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("span", { className: "text-[10px] text-muted-foreground", children: multiline ? "\u2318\u23CE saves \xB7 Esc cancels \xB7 Tab next" : "\u23CE saves \xB7 Esc cancels \xB7 Tab next" }) : /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("span", { className: "flex items-center gap-1", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_design_system6.Button, { size: "sm", onClick: () => once(() => onCommit(draft, null)), children: "Save" }),
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_design_system6.Button, { size: "sm", onClick: () => once(() => onCommit(null)), children: "Save" }),
           /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_design_system6.Button, { size: "sm", variant: "ghost", onClick: () => once(onCancel), children: "Cancel" })
         ] })
       ]
@@ -1523,6 +1604,8 @@ function Grid({
         tableId: `records-grid-${tableId}`,
         stickyHeader: true,
         pageSize,
+        detail: { enabled: false },
+        window: { enabled: false },
         ...onOpenRecord ? { onRowOpen: (row) => onOpenRecord(row.id) } : {},
         ...canWrite ? {
           rowActions: (row) => /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
@@ -2326,7 +2409,6 @@ function FieldEditor({ tableId, field, onSaved, onCancel, onRemoved, className }
     [fields.data, field?.id]
   );
   const relations = (0, import_react25.useMemo)(() => others.filter((f) => f.type === "relation"), [others]);
-  const manyRelations = (0, import_react25.useMemo)(() => relations.filter((f) => f.multi), [relations]);
   const choice = fieldTypeChoice(type);
   const editing = Boolean(field);
   const derivedKey = field?.key ?? keyFor(label);
@@ -2334,7 +2416,9 @@ function FieldEditor({ tableId, field, onSaved, onCancel, onRemoved, className }
     return /* @__PURE__ */ (0, import_jsx_runtime14.jsx)("p", { className: (0, import_design_system12.cn)("text-xs text-muted-foreground", className), children: rights.reason });
   }
   const options = optionText.split("\n").map((word) => word.trim()).filter((word) => word !== "");
+  const missing = editing ? null : whatIsMissing({ type, label, options, via, pick, agg, of, relations, formulaFields });
   const save = async () => {
+    if (missing) return;
     if (editing && field) {
       const patch = {
         label,
@@ -2440,7 +2524,6 @@ function FieldEditor({ tableId, field, onSaved, onCancel, onRemoved, className }
         formulaFields,
         setFormulaFields,
         relations,
-        manyRelations,
         others,
         existingOptionsTable: Boolean(field?.options_table_id ?? field?.config?.["options_table_id"])
       }
@@ -2555,8 +2638,17 @@ function FieldEditor({ tableId, field, onSaved, onCancel, onRemoved, className }
       ] }, `${rule.kind}-${index}`))
     ] }),
     mutation.error ? /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(RefusalNotice, { error: mutation.error }) : null,
+    missing ? /* @__PURE__ */ (0, import_jsx_runtime14.jsx)("p", { className: "text-[11px] text-destructive", children: missing }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)("div", { className: "flex flex-wrap items-center gap-2", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(import_design_system12.Button, { size: "sm", disabled: mutation.saving || label.trim() === "", onClick: () => void save(), children: mutation.saving ? "Saving\u2026" : field ? "Save field" : "Add field" }),
+      /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(
+        import_design_system12.Button,
+        {
+          size: "sm",
+          disabled: mutation.saving || missing !== null,
+          onClick: () => void save(),
+          children: mutation.saving ? "Saving\u2026" : field ? "Save field" : "Add field"
+        }
+      ),
       onCancel ? /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(import_design_system12.Button, { size: "sm", variant: "ghost", onClick: onCancel, children: "Cancel" }) : null,
       field ? /* @__PURE__ */ (0, import_jsx_runtime14.jsx)("div", { className: "ml-auto flex items-center gap-2", children: askingToRemove ? /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(import_jsx_runtime14.Fragment, { children: [
         /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)("span", { className: "text-destructive", children: [
@@ -2570,6 +2662,34 @@ function FieldEditor({ tableId, field, onSaved, onCancel, onRemoved, className }
     ] })
   ] });
 }
+function whatIsMissing(state) {
+  const { type, label, options, via, pick, agg, of, relations, formulaFields } = state;
+  if (label.trim() === "") return "Give the column a name.";
+  if (type === "select" || type === "multi_select") {
+    if (options.length === 0) return "Type the choices this column offers, one per line.";
+    return null;
+  }
+  if (type === "lookup" || type === "rollup") {
+    if (relations.length === 0) {
+      return type === "rollup" ? "A total is worked out across the records a column points at, and this table has no column that points at records yet. Add a Person or File column that can hold more than one, then come back." : "A borrowed value is read from a record a column points at, and this table has no column that points at another record yet. Add a Person or File column, then come back.";
+    }
+    const chosen = relations.find((relation) => relation.key === via);
+    if (!chosen) {
+      return type === "rollup" ? "Choose the column whose records this one adds up." : "Choose the column whose record this one reads from.";
+    }
+    if (type === "rollup" && !chosen.multi) {
+      return `${fieldName(chosen)} points at one record at a time, so there is nothing to total. Tick "Can hold more than one" on ${fieldName(chosen)}, or use Borrowed value to read its one value.`;
+    }
+    if (type === "lookup" && pick.trim() === "") {
+      return `Say which value to read from the record ${fieldName(chosen)} points at.`;
+    }
+    if (type === "rollup" && agg !== "count" && of.trim() === "") {
+      return "Say which value of those records to work out.";
+    }
+    return null;
+  }
+  return null;
+}
 function multiApplies(type) {
   return type === "member" || type === "attachment" || type === "text";
 }
@@ -2635,16 +2755,19 @@ function TypeQuestions(props) {
     ] });
   }
   if (type === "lookup" || type === "rollup") {
-    const usable = type === "rollup" ? props.manyRelations : props.relations;
+    const usable = props.relations;
     if (usable.length === 0) {
-      return /* @__PURE__ */ (0, import_jsx_runtime14.jsx)("p", { className: "text-[11px] text-muted-foreground", children: type === "rollup" ? "This kind of column works something out from records this one points at, and this table has no column yet that points at several records. Add a Person or File column that can hold more than one first." : "This kind of column reads a value from a record this one points at, and this table has no column yet that points at another record. Add a Person or File column first." });
+      return /* @__PURE__ */ (0, import_jsx_runtime14.jsx)("p", { className: "text-[11px] text-muted-foreground", children: type === "rollup" ? "This kind of column works something out from the records another column points at, and this table has no column that points at records yet. Add a Person or File column that can hold more than one first." : "This kind of column reads a value from a record another column points at, and this table has no column that points at another record yet. Add a Person or File column first." });
     }
     return /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)("div", { className: "grid gap-3 sm:grid-cols-2", children: [
       /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)("div", { className: "flex flex-col gap-1", children: [
         /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(import_design_system12.Label, { className: "text-xs", children: type === "rollup" ? "Across the records in" : "Read it from" }),
         /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(import_design_system12.Select, { value: props.via, onValueChange: props.setVia, children: [
           /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(import_design_system12.SelectTrigger, { size: "sm", "aria-label": type === "rollup" ? "Across the records in" : "Read it from", children: /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(import_design_system12.SelectValue, { placeholder: "Choose a column" }) }),
-          /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(import_design_system12.SelectContent, { children: usable.map((f) => /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(import_design_system12.SelectItem, { value: f.key, children: fieldName(f) }, f.id)) })
+          /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(import_design_system12.SelectContent, { children: usable.map((f) => /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(import_design_system12.SelectItem, { value: f.key, children: [
+            fieldName(f),
+            type === "rollup" && !f.multi ? " \u2014 holds one" : ""
+          ] }, f.id)) })
         ] })
       ] }),
       type === "lookup" ? /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)("label", { className: "flex flex-col gap-1", children: [