@ai-matrx/records-ui 0.93.8 → 0.93.12

package/dist/index.cjs

@@ -70,7 +70,7 @@ __export(src_exports, {
   ConditionGroup: () => ConditionGroup,
   ConditionRow: () => ConditionRow,
   CustomFieldsSection: () => CustomFieldsSection,
-  DEFAULT_FIELDS: () => import_core15.DEFAULT_FIELDS,
+  DEFAULT_FIELDS: () => import_core16.DEFAULT_FIELDS,
   DEFAULT_FOOTER: () => DEFAULT_FOOTER,
   DEFAULT_VIEW_NAME: () => DEFAULT_VIEW_NAME,
   DUE_STATE_LABEL: () => DUE_STATE_LABEL,
@@ -224,7 +224,7 @@ __export(src_exports, {
   WithheldValue: () => WithheldValue,
   actorBadge: () => actorBadge,
   actorWords: () => actorWords,
-  addFields: () => import_core15.addFields,
+  addFields: () => import_core16.addFields,
   applyLook: () => applyLook,
   archiveConfirmSentence: () => archiveConfirmSentence,
   archivedRowLine: () => archivedRowLine,
@@ -259,7 +259,7 @@ __export(src_exports, {
   dashboardFromSummary: () => dashboardFromSummary,
   dateFormatFor: () => dateFormatFor,
   dateText: () => dateText,
-  declareTable: () => import_core15.declareTable,
+  declareTable: () => import_core16.declareTable,
   declareView: () => declareView,
   defaultViewOf: () => defaultViewOf,
   designatedLayoutOf: () => designatedLayoutOf,
@@ -267,7 +267,7 @@ __export(src_exports, {
   ensureSystemTable: () => ensureSystemTable,
   entityReferenceSpec: () => entityReferenceSpec,
   envelopeFor: () => envelopeFor,
-  fieldDeclarationFor: () => import_core15.fieldDeclarationFor,
+  fieldDeclarationFor: () => import_core16.fieldDeclarationFor,
   fieldIsEditable: () => fieldIsEditable,
   fieldName: () => fieldName,
   fieldToken: () => fieldToken,
@@ -357,7 +357,7 @@ __export(src_exports, {
   tableName: () => tableName,
   tableOpening: () => tableOpening,
   tableRightsAt: () => tableRightsAt,
-  tokenFor: () => import_core15.tokenFor,
+  tokenFor: () => import_core16.tokenFor,
   unknownRailLine: () => unknownRailLine,
   unknownViewLine: () => unknownViewLine,
   useCanShare: () => useCanShare,
@@ -3107,7 +3107,7 @@ function OptionControl({ field: field2, value, onChange, disabled, id, autoOpen,
   if (refusal2)
     return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { id, children: /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(RefusalLine, { error: refusal2 }) });
   if (!options) return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("p", { id, className: "text-xs text-muted-foreground", children: "Reading this field's choices\u2026" });
-  if (CHOICE_EDITOR_ADDS_WHAT_IS_TYPED && (0, import_records5.allowsOtherValues)(field2)) {
+  if (CHOICE_EDITOR_ADDS_WHAT_IS_TYPED && ((0, import_records5.allowsOtherValues)(field2) || !autoOpen)) {
     return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
       OpenChoicePicker,
       {
@@ -3118,6 +3118,7 @@ function OptionControl({ field: field2, value, onChange, disabled, id, autoOpen,
         disabled,
         id,
         addsChoices,
+        allowOther: (0, import_records5.allowsOtherValues)(field2),
         onChoicesChanged: () => setReread((n) => n + 1)
       }
     );
@@ -3190,6 +3191,7 @@ function OpenChoicePicker({
   disabled,
   id,
   addsChoices,
+  allowOther = true,
   onChoicesChanged
 }) {
   const client = (0, import_react18.useOptionalRecordsClient)();
@@ -3207,7 +3209,7 @@ function OpenChoicePicker({
   });
   const q = search.trim();
   const visible = options.filter((o) => q === "" || titleOf(o).toLowerCase().includes(q.toLowerCase()));
-  const decided = (0, import_records5.decideTypedChoice)({ words: q, options, allowOther: true, nudge: nudge ?? "ask" });
+  const decided = (0, import_records5.decideTypedChoice)({ words: q, options, allowOther, nudge: nudge ?? "ask" });
   const choose = (word, addingIt = false) => {
     const pending = held.add.filter((w) => w.toLowerCase() !== word.toLowerCase());
     let next;
@@ -3292,7 +3294,10 @@ function OpenChoicePicker({
           empty: q === "" ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("p", { className: "p-2 text-xs text-muted-foreground", children: "No choices yet \u2014 type one to add it." }) : null,
           add,
           foot,
-          footNote: addRefused ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(RefusalLine, { error: addRefused }) : null
+          footNote: addRefused ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(RefusalLine, { error: addRefused }) : offList && decided.decision === "not_a_choice" ? (
+            // never_add on a column that takes only its choices: said, never a silent nothing.
+            /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("p", { "data-records-typed-refusal": "", className: "p-2 text-xs text-muted-foreground", children: notAChoiceSentence(field2, [q]) })
+          ) : null
         }
       )
     )
@@ -4986,7 +4991,7 @@ var import_react64 = require("react");
 var import_react65 = require("@ai-matrx/records/react");
 var import_records17 = require("@ai-matrx/records");
 var import_data_table9 = require("@ai-matrx/design-system/data-table");
-var import_core8 = require("@ai-matrx/records/core");
+var import_core9 = require("@ai-matrx/records/core");
 
 // src/archiveWords.ts
 function archiveConfirmSentence(what) {
@@ -5226,6 +5231,7 @@ var import_design_system25 = require("@ai-matrx/design-system");
 // src/FieldEditor.tsx
 var import_react36 = require("react");
 var import_react37 = require("@ai-matrx/records/react");
+var import_core4 = require("@ai-matrx/records/core");
 var import_design_system21 = require("@ai-matrx/design-system");
 
 // src/FormulaTextEditor.tsx
@@ -5614,10 +5620,17 @@ function ChoiceListEditor({
   field: field2,
   rows,
   onRows,
-  onStart
+  onStart,
+  allowOther = false,
+  rehome = {},
+  onRehome
 }) {
   const client = (0, import_react35.useRecordsClient)();
   const [refused, setRefused] = (0, import_react34.useState)(null);
+  const [usage, setUsage] = (0, import_react34.useState)(null);
+  const [asking, setAsking] = (0, import_react34.useState)(null);
+  const [moveTo, setMoveTo] = (0, import_react34.useState)("");
+  const [removed, setRemoved] = (0, import_react34.useState)({});
   (0, import_react34.useEffect)(() => {
     if (rows !== null) return;
     let live = true;
@@ -5635,6 +5648,19 @@ function ChoiceListEditor({
       live = false;
     };
   }, [client, field2.id, rows, onRows, onStart]);
+  (0, import_react34.useEffect)(() => {
+    if (!onRehome) return;
+    let live = true;
+    void client.fieldChoiceUsage({ field_id: field2.id }).then(
+      (got) => {
+        if (live && got.ok) setUsage(got.data);
+      },
+      () => void 0
+    );
+    return () => {
+      live = false;
+    };
+  }, [client, field2.id, onRehome]);
   if (refused) {
     return /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("p", { className: "text-[11px] text-muted-foreground", "data-records-choice-list": "", children: [
       "The choices could not be read, so they are left as they are: ",
@@ -5651,6 +5677,37 @@ function ChoiceListEditor({
     onRows(next);
   };
   const named = (r, i) => r.words.trim() === "" ? `choice ${i + 1}` : `\u201C${r.words.trim()}\u201D`;
+  const heldBy = (r) => r.id && onRehome ? usage?.[r.id]?.records ?? 0 : 0;
+  const remove = (i) => {
+    const r = rows[i];
+    if (heldBy(r) > 0) {
+      setAsking(r);
+      setMoveTo("");
+      return;
+    }
+    onRows(rows.filter((_, j) => j !== i));
+  };
+  const answer = (spec) => {
+    if (!asking?.id || !onRehome) return;
+    const index = rows.findIndex((r) => r.id === asking.id);
+    setRemoved({ ...removed, [asking.id]: { row: asking, index: index < 0 ? rows.length : index } });
+    onRows(rows.filter((r) => r.id !== asking.id));
+    onRehome({ ...rehome, [asking.id]: spec });
+    setAsking(null);
+  };
+  const putBack = (id) => {
+    const was = removed[id];
+    if (!was || !onRehome) return;
+    const next = [...rows];
+    next.splice(Math.min(was.index, next.length), 0, was.row);
+    onRows(next);
+    const { [id]: _gone, ...rest } = rehome;
+    onRehome(rest);
+    const { [id]: _was, ...keep } = removed;
+    setRemoved(keep);
+  };
+  const targets = rows.filter((r) => r.id && r.id !== asking?.id && r.words.trim() !== "");
+  const wordsOf = (id) => rows.find((r) => r.id === id)?.words.trim() ?? usage?.[id]?.words ?? "";
   return /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("div", { className: "flex flex-col gap-1", "data-records-choice-list": "", children: [
     /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Label, { className: "text-xs", children: "The choices" }),
     rows.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("p", { className: "text-xs text-muted-foreground", "data-records-choice-list-empty": "", children: "No choices yet. Add the first one here, or type it into a cell and answer Add." }) : null,
@@ -5666,10 +5723,43 @@ function ChoiceListEditor({
       ),
       /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", variant: "ghost", className: "h-7 px-1.5 text-xs", "aria-label": `Move ${named(r, i)} up`, disabled: i === 0, onClick: () => move(i, -1), children: "\u2191" }),
       /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", variant: "ghost", className: "h-7 px-1.5 text-xs", "aria-label": `Move ${named(r, i)} down`, disabled: i === rows.length - 1, onClick: () => move(i, 1), children: "\u2193" }),
-      /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", variant: "ghost", className: "h-7 px-1.5 text-xs", "aria-label": `Remove ${named(r, i)}`, onClick: () => onRows(rows.filter((_, j) => j !== i)), children: "\xD7" })
+      /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", variant: "ghost", className: "h-7 px-1.5 text-xs", "aria-label": `Remove ${named(r, i)}`, onClick: () => remove(i), children: "\xD7" })
     ] }, r.row)) }),
+    asking ? (
+      // THE QUESTION, Notion-style: where do the records that hold it go?
+      /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(
+        "div",
+        {
+          role: "group",
+          "aria-label": (0, import_records10.recordsUseSentence)(heldBy(asking), asking.words.trim()),
+          "data-records-choice-removal-ask": "",
+          className: "flex flex-col gap-1 rounded border bg-muted/40 p-2",
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("p", { className: "text-xs", children: (0, import_records10.recordsUseSentence)(heldBy(asking), asking.words.trim()) }),
+            /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("div", { className: "flex flex-wrap items-center gap-1", children: [
+              targets.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(import_jsx_runtime23.Fragment, { children: [
+                /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", className: "h-7 px-2 text-xs", disabled: moveTo === "", onClick: () => answer({ then: "move", to: moveTo }), children: "Move them to" }),
+                /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(import_design_system19.Select, { value: moveTo, onValueChange: setMoveTo, children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.SelectTrigger, { size: "sm", className: "h-7 w-36 text-xs", "aria-label": "Another choice", children: /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.SelectValue, { placeholder: "Another choice" }) }),
+                  /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.SelectContent, { children: targets.map((r) => /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.SelectItem, { value: r.id, children: r.words.trim() }, r.id)) })
+                ] })
+              ] }) : null,
+              allowOther ? /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", variant: "outline", className: "h-7 px-2 text-xs", onClick: () => answer({ then: "keep" }), children: "Keep the words as other values" }) : null,
+              /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", variant: "outline", className: "h-7 px-2 text-xs", onClick: () => answer({ then: "clear" }), children: "Clear them" }),
+              /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", variant: "ghost", className: "h-7 px-2 text-xs", onClick: () => setAsking(null), children: "Cancel" })
+            ] })
+          ]
+        }
+      )
+    ) : null,
+    Object.entries(rehome).map(
+      ([id, spec]) => removed[id] ? /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("div", { className: "flex items-center justify-between gap-2 text-[11px] text-muted-foreground", "data-records-choice-rehome": "", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("span", { children: (0, import_records10.rehomeSentence)(usage?.[id]?.records ?? 0, removed[id].row.words.trim(), spec, spec.then === "move" ? wordsOf(spec.to) : void 0) }),
+        /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", variant: "ghost", className: "h-6 px-1.5 text-[11px]", onClick: () => putBack(id), children: "Put it back" })
+      ] }, id) : null
+    ),
     /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_design_system19.Button, { type: "button", size: "sm", variant: "outline", className: "h-7 self-start text-xs", onClick: () => onRows([...rows, { id: null, words: "", row: nextRow() }]), children: "Add a choice" }),
-    /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("p", { className: "text-[11px] text-muted-foreground", children: "Changing a choice\u2019s words changes them in every record that holds it. A removed choice is no longer offered; records that hold it keep it." })
+    /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("p", { className: "text-[11px] text-muted-foreground", children: "Changing a choice\u2019s words changes them in every record that holds it. Removing a choice that records hold asks where those records go." })
   ] });
 }
 
@@ -6206,6 +6296,9 @@ function FieldEditor({ tableId, field: field2, onSaved, onCancel, onRemoved, cla
   const [optionText, setOptionText] = (0, import_react36.useState)("");
   const [choiceList, setChoiceList] = (0, import_react36.useState)(null);
   const [choiceListStart, setChoiceListStart] = (0, import_react36.useState)(null);
+  const [rehome, setRehome] = (0, import_react36.useState)({});
+  const [rehomed, setRehomed] = (0, import_react36.useState)(null);
+  const [rehomeRefused, setRehomeRefused] = (0, import_react36.useState)(null);
   const [unit, setUnit] = (0, import_react36.useState)(field2?.unit ?? "$");
   const [withTime, setWithTime] = (0, import_react36.useState)(String(field2?.config?.["kind"] ?? "date") === "datetime");
   const [via, setVia] = (0, import_react36.useState)(String(field2?.config?.["via"] ?? ""));
@@ -6299,6 +6392,20 @@ function FieldEditor({ tableId, field: field2, onSaved, onCancel, onRemoved, cla
         // K2: a re-aimed formula goes WITH its type word, the arm `field_update` reads it in.
         ...type === "formula" && formulaWritten && formulaChanged && formulaText.trim() !== "" ? { type: "formula", formula_text: formulaText.trim() } : {}
       };
+      if (Object.keys(rehome).length > 0 && Array.isArray(patch.options)) {
+        setRehomeRefused(null);
+        const done = await client.fieldUpdateRehomingChoices({ field_id: field2.id, patch, rehome });
+        if (!done.ok) {
+          setRehomeRefused(done.error);
+          return;
+        }
+        (0, import_react37.tableShapeChanged)(tableId);
+        for (const c of done.data.undo.cells_back) (0, import_core4.announceRecordChanged)(c.record_id);
+        const n = done.data.rehomed.reduce((sum, r) => sum + r.records, 0);
+        setRehome({});
+        setRehomed({ said: `Saved. ${n} ${n === 1 ? "record was" : "records were"} changed with the choices.`, undo: done.data.undo });
+        return;
+      }
       const written2 = await mutation.update({ field_id: field2.id, patch });
       if (written2 !== null) onSaved?.();
       return;
@@ -6469,7 +6576,18 @@ function FieldEditor({ tableId, field: field2, onSaved, onCancel, onRemoved, cla
         relations,
         others,
         existingOptionsTable: Boolean(field2?.options_table_id ?? field2?.config?.["options_table_id"]),
-        choiceList: editing && field2 ? /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(ChoiceListEditor, { field: field2, rows: choiceList, onRows: setChoiceList, onStart: setChoiceListStart }) : null,
+        choiceList: editing && field2 ? /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+          ChoiceListEditor,
+          {
+            field: field2,
+            rows: choiceList,
+            onRows: setChoiceList,
+            onStart: setChoiceListStart,
+            allowOther,
+            rehome,
+            onRehome: setRehome
+          }
+        ) : null,
         allowedTypes,
         setAllowedTypes
       }
@@ -6619,6 +6737,36 @@ function FieldEditor({ tableId, field: field2, onSaved, onCancel, onRemoved, cla
         error: refusal("internal", COLUMN_DID_NOT_LAND_SENTENCE, COLUMN_DID_NOT_LAND_REMEDY)
       }
     ) : null,
+    rehomeRefused ? /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(RefusalNotice, { error: rehomeRefused }) : null,
+    rehomed ? /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("div", { "data-records-choice-rehomed": "", className: "flex flex-wrap items-center gap-2 text-[11px]", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("span", { children: rehomed.said }),
+      rehomed.undo ? /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+        import_design_system21.Button,
+        {
+          type: "button",
+          size: "sm",
+          variant: "outline",
+          className: "h-6 px-2 text-xs",
+          onClick: () => {
+            const undo = rehomed.undo;
+            if (!undo || !field2) return;
+            void client.fieldUpdateRehomingChoices({ field_id: field2.id, patch: { options: undo.options }, cells_back: undo.cells_back }).then((back) => {
+              if (!back.ok) {
+                setRehomeRefused(back.error);
+                return;
+              }
+              (0, import_react37.tableShapeChanged)(tableId);
+              for (const c of undo.cells_back) (0, import_core4.announceRecordChanged)(c.record_id);
+              setChoiceList(null);
+              setChoiceListStart(null);
+              setRehomed({ said: "Undone. The choices and the records that held them are back as they were.", undo: null });
+            });
+          },
+          children: "Undo"
+        }
+      ) : null,
+      /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(import_design_system21.Button, { type: "button", size: "sm", className: "h-6 px-2 text-xs", onClick: () => onSaved?.(), children: "Done" })
+    ] }) : null,
     backfillError ? /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("div", { "data-records-autonumber-backfill-refused": "", className: "flex flex-col gap-1", children: [
       /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("p", { className: "text-[11px]", children: "The column is made. The records already in the table were not numbered:" }),
       /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(RefusalNotice, { error: backfillError })
@@ -7803,7 +7951,7 @@ function SummarySheetControls({
 }
 
 // src/pasteValues.ts
-var import_core4 = require("@ai-matrx/records/core");
+var import_core5 = require("@ai-matrx/records/core");
 var import_records14 = require("@ai-matrx/records");
 function wordForStoredChoice(options, value) {
   if (options === void 0 || typeof value !== "string" || value === "") return null;
@@ -7881,7 +8029,7 @@ function planPastedBlock(args) {
       });
       accepted[key] = judged.value;
     }
-    const predicted = (0, import_core4.predictValueRefusals)(args.fields, accepted);
+    const predicted = (0, import_core5.predictValueRefusals)(args.fields, accepted);
     for (const refusal2 of predicted) {
       const key = refusal2.field_key;
       if (key === void 0) continue;
@@ -9863,7 +10011,7 @@ function GridLayoutMenu({
 // src/gridUndo.tsx
 var import_react56 = require("react");
 var import_react57 = require("@ai-matrx/records/react");
-var import_core5 = require("@ai-matrx/records/core");
+var import_core6 = require("@ai-matrx/records/core");
 var import_design_system32 = require("@ai-matrx/design-system");
 var import_data_table8 = require("@ai-matrx/design-system/data-table");
 var import_jsx_runtime38 = require("react/jsx-runtime");
@@ -9931,7 +10079,7 @@ function useGridUndo(args) {
       }
       forget(step2.cells.map((c) => ({ rowId: c.rowId, key: c.key })));
       for (const id of /* @__PURE__ */ new Set([...step2.cells.map((c) => c.rowId), ...step2.created ?? [], ...step2.archived ?? []])) {
-        (0, import_core5.announceRecordChanged)(id);
+        (0, import_core6.announceRecordChanged)(id);
       }
       setHeld(() => {
         let stack = taken.stack;
@@ -10076,7 +10224,7 @@ function undoKey(event) {
 
 // src/gridAssist.tsx
 var import_react59 = require("react");
-var import_core6 = require("@ai-matrx/records/core");
+var import_core7 = require("@ai-matrx/records/core");
 var import_content_transfer = require("@ai-matrx/design-system/content-transfer");
 
 // src/gridAgentContext.ts
@@ -10355,7 +10503,7 @@ function useGridAssist(args) {
       if (!row) return;
       const document2 = row.document ?? {};
       const value = editing.valueFor(row, fieldOf2(key));
-      const pointer = typeof document2[key] === "string" ? (0, import_core6.wholeValueOf)(document2, key) : null;
+      const pointer = typeof document2[key] === "string" ? (0, import_core7.wholeValueOf)(document2, key) : null;
       setWhole({ rowId, key, rowTitle: titleOf(row), value, pointer });
     },
     [rowOf, fieldOf2, titleOf, editing]
@@ -10448,7 +10596,7 @@ function useGridAssist(args) {
 // src/gridBulk.tsx
 var import_react60 = require("react");
 var import_react61 = require("@ai-matrx/records/react");
-var import_core7 = require("@ai-matrx/records/core");
+var import_core8 = require("@ai-matrx/records/core");
 var import_design_system34 = require("@ai-matrx/design-system");
 var import_jsx_runtime41 = require("react/jsx-runtime");
 function countOf(n, one, many) {
@@ -10505,7 +10653,7 @@ function useGridBulk(args) {
         setRefusal(done.error);
         return null;
       }
-      for (const change of changes) if ("record_id" in change && change.record_id) (0, import_core7.announceRecordChanged)(change.record_id);
+      for (const change of changes) if ("record_id" in change && change.record_id) (0, import_core8.announceRecordChanged)(change.record_id);
       return done.data;
     },
     [client, tableId]
@@ -11647,7 +11795,7 @@ function Grid({
         }))
       );
       editing.forget(cells);
-      for (const u of updates) (0, import_core8.announceRecordChanged)(u.row.recordId);
+      for (const u of updates) (0, import_core9.announceRecordChanged)(u.row.recordId);
       const lines = updates.length + creates.length;
       undo.push({ label: `Pasted ${lines} ${lines === 1 ? "row" : "rows"}`, cells, created });
       const expected = [
@@ -12819,7 +12967,7 @@ function withHeaderMenus(columns, menuFor, filterFor) {
 // src/ExportMenu.tsx
 var import_react66 = require("react");
 var import_react67 = require("@ai-matrx/records/react");
-var import_core9 = require("@ai-matrx/records/core");
+var import_core10 = require("@ai-matrx/records/core");
 var import_react68 = require("@ai-matrx/alchemy/react");
 var import_design_system37 = require("@ai-matrx/design-system");
 var import_jsx_runtime44 = require("react/jsx-runtime");
@@ -12838,7 +12986,7 @@ function toRows(fields, records, labels) {
         absent_reason: envelope?.absent ?? null,
         // A VALUE KEPT AS A FILE carries its pointer, so the export writes the whole text
         // (`withWholeValues`), never the first words passed off as the value.
-        source: (0, import_core9.wholeValueOf)(document2, field2.key)
+        source: (0, import_core10.wholeValueOf)(document2, field2.key)
       };
     }
     return row;
@@ -12892,7 +13040,7 @@ function ExportMenu({ tableId, rows, label, className }) {
     );
     const lookup = (field2, id) => labels(field2, id) ?? learned.get(`${field2.id}:${id}`) ?? null;
     const read = host.readFileText;
-    return (0, import_core9.withWholeValues)(toRows(all, records, lookup), read ? (fileId) => read({ fileId }) : null);
+    return (0, import_core10.withWholeValues)(toRows(all, records, lookup), read ? (fileId) => read({ fileId }) : null);
   };
   return /* @__PURE__ */ (0, import_jsx_runtime44.jsxs)("div", { className: (0, import_design_system37.cn)("flex items-center gap-1", className), children: [
     /* @__PURE__ */ (0, import_jsx_runtime44.jsx)(
@@ -12900,7 +13048,7 @@ function ExportMenu({ tableId, rows, label, className }) {
       {
         size: "sm",
         variant: "outline",
-        onClick: () => void exported().then((rows2) => download(`${name}.csv`, "text/csv;charset=utf-8", (0, import_core9.exportCsv)(fields.data ?? [], rows2))).catch(
+        onClick: () => void exported().then((rows2) => download(`${name}.csv`, "text/csv;charset=utf-8", (0, import_core10.exportCsv)(fields.data ?? [], rows2))).catch(
           (thrown) => setFailure(refusalFromThrown(thrown, "The CSV could not be written.", "Try again in a moment."))
         ),
         children: "CSV"
@@ -12921,7 +13069,7 @@ function ExportMenu({ tableId, rows, label, className }) {
           );
           setFailure(null);
           try {
-            exported().then((rows2) => (0, import_core9.exportXlsx)(fields.data ?? [], rows2, name)).then(
+            exported().then((rows2) => (0, import_core10.exportXlsx)(fields.data ?? [], rows2, name)).then(
               (bytes) => download(
                 `${name}.xlsx`,
                 "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
@@ -12942,7 +13090,7 @@ function ExportMenu({ tableId, rows, label, className }) {
         sourceId: `records:${tableId}`,
         size: "xs",
         json: () => records.map((r) => r.document),
-        human: () => (0, import_core9.exportCsv)(fields.data ?? [], toRows(fields.data ?? [], records, labels))
+        human: () => (0, import_core10.exportCsv)(fields.data ?? [], toRows(fields.data ?? [], records, labels))
       }
     ),
     failure ? /* @__PURE__ */ (0, import_jsx_runtime44.jsx)(RefusalLine, { error: failure }) : null
@@ -12952,11 +13100,11 @@ function ExportMenu({ tableId, rows, label, className }) {
 // src/ImportWizard.tsx
 var import_react69 = require("react");
 var import_react70 = require("@ai-matrx/records/react");
-var import_core11 = require("@ai-matrx/records/core");
+var import_core12 = require("@ai-matrx/records/core");
 var import_design_system38 = require("@ai-matrx/design-system");
 
 // src/importRuleCheck.ts
-var import_core10 = require("@ai-matrx/records/core");
+var import_core11 = require("@ai-matrx/records/core");
 function checkImportRules(fields, rows, mapping) {
   const byKey = new Map(fields.map((f) => [f.key, f]));
   const verdicts = [];
@@ -12974,7 +13122,7 @@ function checkImportRules(fields, rows, mapping) {
       let why = null;
       if ("refusal" in meant) why = meant.refusal;
       else {
-        const predicted = (0, import_core10.predictValueRefusals)([field2], { [key]: meant.value }).filter(
+        const predicted = (0, import_core11.predictValueRefusals)([field2], { [key]: meant.value }).filter(
           (p) => p.field_key === void 0 || p.field_key === key
         );
         if (predicted.length > 0) why = predicted[0].message;
@@ -13102,7 +13250,7 @@ function ImportWizard({ tableId, onDone, onWrote, className }) {
       try {
         const xlsx = file.name.toLowerCase().endsWith(".xlsx");
         const bytes = await file.arrayBuffer();
-        const result = xlsx ? await (0, import_core11.importXlsx)(bytes) : (0, import_core11.importCsv)(new TextDecoder().decode(bytes));
+        const result = xlsx ? await (0, import_core12.importXlsx)(bytes) : (0, import_core12.importCsv)(new TextDecoder().decode(bytes));
         setFormat(xlsx ? "xlsx" : "csv");
         setFileName(file.name);
         setFileBytes(file.size);
@@ -13729,11 +13877,12 @@ function CustomFieldsSection({
   const [newLabel, setNewLabel] = (0, import_react71.useState)("");
   const [newType, setNewType] = (0, import_react71.useState)("text");
   const [draft, setDraft] = (0, import_react71.useState)({});
+  const [removing, setRemoving] = (0, import_react71.useState)(null);
   const fields = (0, import_react71.useMemo)(() => read.data?.fields ?? [], [read.data]);
   const mayAdd = rights.data?.may_declare === true;
-  const live = (0, import_react71.useRef)({ fields, rights: rights.data, loading: rights.loading, reload: read.reload });
+  const live = (0, import_react71.useRef)({ fields, rights: rights.data, loading: rights.loading, reload: read.reload, values: read.data?.custom ?? {} });
   (0, import_react71.useEffect)(() => {
-    live.current = { fields, rights: rights.data, loading: rights.loading, reload: read.reload };
+    live.current = { fields, rights: rights.data, loading: rights.loading, reload: read.reload, values: read.data?.custom ?? {} };
   });
   (0, import_react71.useEffect)(() => {
     if (!agentDoor) return;
@@ -13745,7 +13894,8 @@ function CustomFieldsSection({
         entityLabel: now.rights?.label ?? null,
         mayAdd: now.rights ? now.rights.may_declare === true : now.loading ? null : false,
         refusal: now.rights && !now.rights.may_declare ? now.rights.reason ?? null : null,
-        fields: now.fields.map((f) => ({ key: f.key, label: f.label, type: f.type })),
+        fields: now.fields.map((f) => ({ key: f.key, label: f.label, type: f.type, value: now.values[f.key] })),
+        mayFill: now.rights ? now.rights.may_fill_in !== false : now.loading ? null : false,
         types: ADDABLE_TYPES
       };
     };
@@ -13777,7 +13927,39 @@ function CustomFieldsSection({
       }
       return { ok: true, field_id: declared2.data, label, type };
     };
-    return agentDoor({ entityToken, recordId, state, check, addField });
+    const resolveKeys = (values2) => {
+      const now = live.current;
+      const problems = [];
+      const patch = {};
+      const written2 = [];
+      const entries = values2 && typeof values2 === "object" && !Array.isArray(values2) ? Object.entries(values2) : [];
+      if (entries.length === 0) problems.push("Name at least one field and its value.");
+      for (const [name, value] of entries) {
+        const want = name.trim().toLowerCase();
+        const field2 = now.fields.find((f) => f.key.toLowerCase() === want || f.label.trim().toLowerCase() === want);
+        if (!field2) {
+          problems.push(`There is no custom field "${name}". Fields: ${now.fields.map((f) => f.label).join(", ") || "none yet"}.`);
+          continue;
+        }
+        patch[field2.key] = value;
+        written2.push({ key: field2.key, label: field2.label, value });
+      }
+      if (now.rights && now.rights.may_fill_in === false) problems.push("This person may not fill in custom fields on this record.");
+      return { problems, patch, written: written2 };
+    };
+    const checkValues = (values2) => resolveKeys(values2).problems;
+    const setValues = async (values2) => {
+      const { problems, patch, written: written2 } = resolveKeys(values2);
+      if (problems.length > 0) return { ok: false, message: problems.join(" ") };
+      const result = await client.entityValueWrite({ token: entityToken, record_id: recordId, patch });
+      if (!result.ok) {
+        const hint = hintForAPerson(result.error.hint);
+        return { ok: false, message: hint ? `${result.error.message} ${hint}` : result.error.message };
+      }
+      live.current.reload();
+      return { ok: true, written: written2 };
+    };
+    return agentDoor({ entityToken, recordId, state, check, addField, checkValues, setValues });
   }, [agentDoor, client, entityToken, recordId]);
   if (!read.loading && !read.error && fields.length === 0 && !mayAdd) return null;
   if (read.error) return /* @__PURE__ */ (0, import_jsx_runtime46.jsx)(RefusalLine, { error: read.error, className });
@@ -13888,7 +14070,46 @@ function CustomFieldsSection({
       const field2 = asField(f);
       const id = `cf-${recordId}-${f.key}`;
       return /* @__PURE__ */ (0, import_jsx_runtime46.jsxs)("div", { className: "flex min-w-0 flex-col gap-1", children: [
-        /* @__PURE__ */ (0, import_jsx_runtime46.jsx)(FieldLabel, { field: field2, htmlFor: id }),
+        /* @__PURE__ */ (0, import_jsx_runtime46.jsxs)("div", { className: "flex items-center gap-2", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime46.jsx)(FieldLabel, { field: field2, htmlFor: id }),
+          mayAdd && removing !== f.id ? /* @__PURE__ */ (0, import_jsx_runtime46.jsx)(
+            import_design_system39.Button,
+            {
+              size: "sm",
+              variant: "ghost",
+              className: "ml-auto h-6 px-2 text-xs text-muted-foreground",
+              onClick: () => setRemoving(f.id),
+              children: "Remove field"
+            }
+          ) : null
+        ] }),
+        removing === f.id ? /* @__PURE__ */ (0, import_jsx_runtime46.jsxs)("div", { className: "flex flex-wrap items-center gap-2", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime46.jsxs)("span", { className: "text-destructive", children: [
+            archiveConfirmSentence(`the field \u201C${f.label}\u201D`),
+            " It is removed for everyone in this organization; its values stay in every record and come back with it."
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime46.jsx)(
+            import_design_system39.Button,
+            {
+              size: "sm",
+              variant: "destructive",
+              disabled: mutation.saving,
+              onClick: async () => {
+                const gone = await mutation.retire({ field_id: f.id });
+                setRemoving(null);
+                if (gone) {
+                  setDraft((d) => {
+                    const { [f.key]: _dropped, ...rest } = d;
+                    return rest;
+                  });
+                  read.reload();
+                }
+              },
+              children: "Remove it"
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime46.jsx)(import_design_system39.Button, { size: "sm", variant: "ghost", onClick: () => setRemoving(null), children: "Keep it" })
+        ] }) : null,
         /* @__PURE__ */ (0, import_jsx_runtime46.jsx)(
           FieldControl,
           {
@@ -15541,10 +15762,10 @@ var import_design_system48 = require("@ai-matrx/design-system");
 // src/RecordForm.tsx
 var import_react86 = require("react");
 var import_react87 = require("@ai-matrx/records/react");
-var import_core13 = require("@ai-matrx/records/core");
+var import_core14 = require("@ai-matrx/records/core");
 
 // src/writeOnTheWinningVersion.ts
-var import_core12 = require("@ai-matrx/records/core");
+var import_core13 = require("@ai-matrx/records/core");
 function sameStoredValue(left, right) {
   if (left === right) return true;
   const empty = (v) => v === null || v === void 0 || v === "";
@@ -15566,7 +15787,7 @@ async function updateOnTheWinningVersion(client, recordId, patch, expectedVersio
   });
   const first = await send(expectedVersion);
   if (first.ok) return first;
-  const conflict = (0, import_core12.asWriteConflict)(first.error, recordId);
+  const conflict = (0, import_core13.asWriteConflict)(first.error, recordId);
   if (!conflict) return first;
   const untouched = base === "always" || Object.keys(patch).every((key) => sameStoredValue(conflict.contested_fields[key], base[key]));
   if (!untouched) return first;
@@ -15803,7 +16024,7 @@ function RecordForm({
     return out;
   }, [draft]);
   const predicted = (0, import_react86.useMemo)(
-    () => fields.data ? (0, import_core13.predictWriteRefusals)({ fields: fields.data, document: document2, ...recordType ? { recordType } : {} }) : [],
+    () => fields.data ? (0, import_core14.predictWriteRefusals)({ fields: fields.data, document: document2, ...recordType ? { recordType } : {} }) : [],
     [fields.data, document2, recordType]
   );
   if (fields.error) return /* @__PURE__ */ (0, import_jsx_runtime53.jsx)(RefusalNotice, { error: fields.error, className });
@@ -15852,7 +16073,7 @@ function RecordForm({
       setEdit({
         saving: false,
         error: answered2.ok ? null : answered2.error,
-        conflict: answered2.ok ? null : (0, import_core13.asWriteConflict)(answered2.error, recordId)
+        conflict: answered2.ok ? null : (0, import_core14.asWriteConflict)(answered2.error, recordId)
       });
       const moved = answered2.ok ? answered2.data : null;
       if (moved !== null) {
@@ -15958,7 +16179,7 @@ function FieldRow({
 }) {
   const id = `field-${field2.id}`;
   const storedWords = document2?.[field2.key];
-  const whole = typeof storedWords === "string" ? (0, import_core13.wholeValueOf)(document2, field2.key) : null;
+  const whole = typeof storedWords === "string" ? (0, import_core14.wholeValueOf)(document2, field2.key) : null;
   return /* @__PURE__ */ (0, import_jsx_runtime53.jsxs)("div", { className: (0, import_design_system46.cn)("flex min-w-0 flex-col gap-1", whole && "sm:col-span-2"), children: [
     /* @__PURE__ */ (0, import_jsx_runtime53.jsx)(FieldLabel, { field: field2, htmlFor: id, children: /* @__PURE__ */ (0, import_jsx_runtime53.jsx)(ProvenanceBadge, { document: document2, fieldKey: field2.key }) }),
     whole ? (
@@ -24460,7 +24681,7 @@ function SignBlock({ tableId, recordId, render, className }) {
 var import_react144 = require("react");
 var import_recharts = require("recharts");
 var import_records24 = require("@ai-matrx/records");
-var import_core14 = require("@ai-matrx/records/core");
+var import_core15 = require("@ai-matrx/records/core");
 var import_design_system74 = require("@ai-matrx/design-system");
 var import_jsx_runtime82 = require("react/jsx-runtime");
 var priorKey = (key) => `prior__${key}`;
@@ -24517,7 +24738,7 @@ function pretty(n) {
   return Number.isInteger(n) ? n.toLocaleString() : n.toLocaleString(void 0, { maximumFractionDigits: 2 });
 }
 function asRefusal2(block) {
-  return (0, import_core14.mapPgError)(
+  return (0, import_core15.mapPgError)(
     {
       message: block.refused ?? "",
       ...block.sqlstate ? { code: block.sqlstate } : {}
@@ -27191,7 +27412,7 @@ function recordsDataSource(client, fallbackSchema = "custom") {
 // src/TablesHome.tsx
 var import_react170 = require("react");
 var import_react171 = require("@ai-matrx/records/react");
-var import_core16 = require("@ai-matrx/records/core");
+var import_core17 = require("@ai-matrx/records/core");
 var import_records30 = require("@ai-matrx/records");
 var import_design_system86 = require("@ai-matrx/design-system");
 
@@ -27286,7 +27507,7 @@ function ExampleTables({
 }
 
 // src/createTable.ts
-var import_core15 = require("@ai-matrx/records/core");
+var import_core16 = require("@ai-matrx/records/core");
 
 // src/WhereItLives.tsx
 var import_react168 = require("react");
@@ -27565,7 +27786,7 @@ function TablesHome({ onOpenTable, organizationName, makingOnly = false, classNa
     };
   }, [client]);
   const listed = facts.phase === "read" ? (0, import_records30.withTablePlacement)(
-    (0, import_core16.withTableFacts)(tables.data ?? [], facts.rows, me),
+    (0, import_core17.withTableFacts)(tables.data ?? [], facts.rows, me),
     facts.rows
   ) : tables.data ?? [];
   const [showEverything, setShowEverything] = (0, import_react170.useState)(false);
@@ -27609,7 +27830,7 @@ function TablesHome({ onOpenTable, organizationName, makingOnly = false, classNa
       if (!trimmed) return;
       setBusy(true);
       setError(null);
-      const result = await (0, import_core15.declareTable)(client, { name: trimmed, slug: (0, import_core15.tokenFor)(trimmed) });
+      const result = await (0, import_core16.declareTable)(client, { name: trimmed, slug: (0, import_core16.tokenFor)(trimmed) });
       setBusy(false);
       if (!result.ok) {
         setError(result.error);