@ai-matrx/records-ui 0.95.3 → 0.95.10

package/dist/pickers.d.cts

@@ -10,6 +10,10 @@ interface TableAnywhere {
     organization_name: string;
     kind: string | null;
     kept_by_the_app: boolean;
+    /** When the table last changed (the door's own column) — what tells two same-named tables apart. */
+    updated_at?: string | null;
+    /** Who made it, when the door says. */
+    created_by_name?: string | null;
 }
 interface TablesAnywhere {
     loading: boolean;

package/dist/pickers.d.ts

@@ -10,6 +10,10 @@ interface TableAnywhere {
     organization_name: string;
     kind: string | null;
     kept_by_the_app: boolean;
+    /** When the table last changed (the door's own column) — what tells two same-named tables apart. */
+    updated_at?: string | null;
+    /** Who made it, when the door says. */
+    created_by_name?: string | null;
 }
 interface TablesAnywhere {
     loading: boolean;

package/dist/pickers.js

@@ -5,6 +5,40 @@ import { useEffect as useEffect12, useMemo as useMemo7, useState as useState16 }
 import { RecordsProvider as RecordsProvider2, useFields, useRecords, useTable } from "@ai-matrx/records/react";
 import { Button as Button9, CreatablePicker } from "@ai-matrx/design-system";
 
+// src/askOnce.ts
+var asked = /* @__PURE__ */ new WeakMap();
+function askOnce(client, key, ask, freshMs) {
+  let held = asked.get(client);
+  if (!held) {
+    held = /* @__PURE__ */ new Map();
+    asked.set(client, held);
+  }
+  const now = Date.now();
+  const kept = held.get(key);
+  if (kept && now - kept.at <= freshMs) return kept.answer;
+  const answer = ask().then(
+    (result) => {
+      if (!result.ok) held.delete(key);
+      return result;
+    },
+    (thrown) => {
+      held.delete(key);
+      throw thrown;
+    }
+  );
+  held.set(key, { at: now, answer });
+  return answer;
+}
+function forgetAsked(client, prefix) {
+  const held = asked.get(client);
+  if (!held) return;
+  for (const key of [...held.keys()]) if (key.startsWith(prefix)) held.delete(key);
+}
+var FIELD_OPTIONS_FRESH_MS = 2e3;
+function fieldOptionsOnce(client, fieldId) {
+  return askOnce(client, `field_options:${fieldId}`, () => client.fieldOptions({ field_id: fieldId }), FIELD_OPTIONS_FRESH_MS);
+}
+
 // src/editors.tsx
 import { useCallback as useCallback4, useEffect as useEffect10, useRef as useRef9, useState as useState14 } from "react";
 import { allowsOtherValues, choiceValuesOf, coerceTypedAnswer, newerKindOf as newerKindOf4, decideTypedChoice, isTheChosen, optionKey as optionKey2, rankTypedMatches as rankTypedMatches3, readTypedTime as readTypedTime2, typedDateText as typedDateText2, typedTimeText as typedTimeText2 } from "@ai-matrx/records";
@@ -715,7 +749,12 @@ var REMEDY = {
   unreachable: "Nothing was changed. Check your connection and open this again.",
   needs_approval: "Nothing was changed yet. The people who can approve it have been asked.",
   stale_read: "Open this again in a moment and it will be up to date.",
-  timed_out: "Nothing was changed. Try a smaller page, or try again in a moment.",
+  // 🚨 ONE REMEDY THAT IS TRUE OF EVERY DOOR (lane CHAIR-STORE-PERF, 2026-10-03). The store cancels the
+  // WHOLE statement at its clock, so a timed-out door wrote nothing — a create, a column add and a page
+  // read alike. "Try a smaller page" was written for the page read and was printed to a person adding
+  // one row to a three-row table (clone walk, 2026-10-03; the clock was a lock another lane's
+  // rehearsal held, not the row). A door whose page can shrink says so in its own hint, which wins here.
+  timed_out: "Nothing was changed. Try again in a moment.",
   internal: "Nothing you did caused this. Try again, and tell us if it keeps happening."
 };
 var ENGINEER_TEXT = [
@@ -955,7 +994,7 @@ function tellApart(rows, nameOf) {
 // src/RelationPicker.tsx
 import { Fragment as Fragment2, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 var NO_STORE_ON_THIS_SCREEN_REASON = "This question points at a record in somebody's own data, and a page answered without an account is never allowed to search that. Leave it blank \u2014 whoever receives your answer will fill it in.";
-function RelationPicker({ field, value, onChange, disabled, id, className, allowCreate = true }) {
+function RelationPicker({ field, value, onChange, disabled, id, className, allowCreate = true, onPicked }) {
   const client = useOptionalRecordsClient();
   const [rows, setRows] = useState3(null);
   const [words, setWords] = useState3({});
@@ -1047,8 +1086,10 @@ function RelationPicker({ field, value, onChange, disabled, id, className, allow
   const full = field.multi && field.relation_max !== null && picked.length >= field.relation_max;
   const toggle = (recordId) => {
     if (!field.multi) {
-      onChange(picked[0] === recordId ? null : recordId);
+      const choosing = picked[0] !== recordId;
+      onChange(choosing ? recordId : null);
       setOpen(false);
+      if (choosing && onPicked) setTimeout(onPicked, 0);
       return;
     }
     const next = new Set(picked);
@@ -1324,31 +1365,31 @@ var FILES = /* @__PURE__ */ new WeakMap();
 function signatureFilesOf(client, recordId) {
   let held = SOURCES.get(client);
   if (!held) SOURCES.set(client, held = /* @__PURE__ */ new Map());
-  let asked2 = held.get(recordId);
-  if (!asked2) {
-    asked2 = client.recordValuesVersioned({ record_id: recordId }).then((answered) => {
+  let asked3 = held.get(recordId);
+  if (!asked3) {
+    asked3 = client.recordValuesVersioned({ record_id: recordId }).then((answered) => {
       if (!answered.ok) return {};
       return Object.fromEntries(answered.data.map((v) => [v.field_key, signatureFileOf(v.source)]));
     });
-    held.set(recordId, asked2);
+    held.set(recordId, asked3);
   }
-  return asked2;
+  return asked3;
 }
 function drawingOf(client, fileId) {
   let held = FILES.get(client);
   if (!held) FILES.set(client, held = /* @__PURE__ */ new Map());
-  let asked2 = held.get(fileId);
-  if (!asked2) {
-    asked2 = client.recordRead({ record_id: fileId }).then((answered) => {
+  let asked3 = held.get(fileId);
+  if (!asked3) {
+    asked3 = client.recordRead({ record_id: fileId }).then((answered) => {
       if (!answered.ok) return { src: null, hostFileId: null };
       const doc = answered.data.document ?? {};
       const content = drawnSignatureOf(doc["content"]);
       const hostFileId = typeof doc["file_id"] === "string" && doc["file_id"] !== "" ? doc["file_id"] : null;
       return { src: content, hostFileId };
     });
-    held.set(fileId, asked2);
+    held.set(fileId, asked3);
   }
-  return asked2;
+  return asked3;
 }
 function DrawnImage({ src, inCell }) {
   return /* @__PURE__ */ jsx6(
@@ -1595,7 +1636,7 @@ function RecordLabelProvider({ children }) {
   const [archivedRefs, setArchivedRefs] = useState5({});
   const [settled, setSettled] = useState5({});
   const [waitingLines, setWaitingLines] = useState5({});
-  const asked2 = useRef3(/* @__PURE__ */ new Set());
+  const asked3 = useRef3(/* @__PURE__ */ new Set());
   const chased = useRef3(/* @__PURE__ */ new Set());
   const timers = useRef3(/* @__PURE__ */ new Map());
   const startWaitClock = useCallback((field, target) => {
@@ -1633,12 +1674,12 @@ function RecordLabelProvider({ children }) {
   const want = useCallback(
     (field) => {
       if (!pointsAtRecords(field)) return;
-      if (asked2.current.has(field.id)) return;
-      asked2.current.add(field.id);
+      if (asked3.current.has(field.id)) return;
+      asked3.current.add(field.id);
       startWaitClock(field, null);
       void (async () => {
         if (field.type === "list") {
-          const result = await client.fieldOptions({ field_id: field.id });
+          const result = await fieldOptionsOnce(client, field.id);
           if (result.ok) {
             setNames((current) => {
               const next = { ...current };
@@ -1722,7 +1763,7 @@ function RecordLabelProvider({ children }) {
         const once = choiceKeyName(field.id, id);
         if (settled[field.id] && !rereadFor.current.has(once)) {
           rereadFor.current.add(once);
-          asked2.current.delete(field.id);
+          asked3.current.delete(field.id);
           want(field);
         }
         return null;
@@ -2964,15 +3005,15 @@ function TypedDateHelper({ kind, text, onText, label }) {
 // src/choiceNudge.ts
 import { useEffect as useEffect9, useState as useState13 } from "react";
 import { useOptionalRecordsClient as useOptionalRecordsClient6 } from "@ai-matrx/records/react";
-var asked = /* @__PURE__ */ new WeakMap();
+var asked2 = /* @__PURE__ */ new WeakMap();
 function choiceNudgeOf(client) {
-  let answer = asked.get(client);
+  let answer = asked2.get(client);
   if (!answer) {
     answer = Promise.resolve().then(() => client.choiceNudge()).then(
       (result) => result.ok ? result.data : "ask",
       () => "ask"
     );
-    asked.set(client, answer);
+    asked2.set(client, answer);
   }
   return answer;
 }
@@ -3120,7 +3161,7 @@ function TypedTextControl({ field, value, onChange, disabled, id, onCommit, onCa
   useEffect10(() => {
     if (!needsChoices || !client) return;
     let cancelled = false;
-    void client.fieldOptions({ field_id: field.id }).then((result) => {
+    void fieldOptionsOnce(client, field.id).then((result) => {
       if (!cancelled) setChoices(result.ok ? inTheStoresOrder(result.data ?? []) : []);
     });
     return () => {
@@ -3284,7 +3325,7 @@ function FieldControl({ field, value, onChange, disabled, id, autoOpen, onClose,
       }
       return /* @__PURE__ */ jsx16(RelationPicker, { field, value, onChange, disabled, id: inputId });
     case "relation":
-      return /* @__PURE__ */ jsx16(RelationPicker, { field, value, onChange, disabled, id: inputId });
+      return /* @__PURE__ */ jsx16(RelationPicker, { field, value, onChange, disabled, id: inputId, onPicked: onCommit });
     default:
       if (typeof value === "boolean" || field.config?.["kind"] === "boolean") {
         return /* @__PURE__ */ jsx16(
@@ -3454,7 +3495,7 @@ function OptionControl({ field, value, onChange, disabled, id, autoOpen, onClose
   useEffect10(() => {
     if (!client) return;
     let cancelled = false;
-    void client.fieldOptions({ field_id: field.id }).then((result) => {
+    void fieldOptionsOnce(client, field.id).then((result) => {
       if (cancelled) return;
       if (result.ok) setOptions(inTheStoresOrder(result.data ?? []));
       else setRefusal(result.error);
@@ -3517,7 +3558,10 @@ function OptionControl({ field, value, onChange, disabled, id, autoOpen, onClose
         initialSearch,
         addsChoices,
         allowOther: allowsOtherValues(field),
-        onChoicesChanged: () => setReread((n) => n + 1)
+        onChoicesChanged: () => {
+          if (client) forgetAsked(client, `field_options:${field.id}`);
+          setReread((n) => n + 1);
+        }
       }
     );
   }
@@ -3943,20 +3987,40 @@ function TablePicker({ dataSource, value, onChange, disabled, tables }) {
   const options = tablePickerEntries(
     list.rows.map((t) => ({ ...t, id: t.table_id, name: t.table_name })),
     { keep: value }
-  ).entries.map(({ table: t }) => ({
-    value: t.table_id,
-    // The organization hint already tells two same-named tables apart across organizations.
-    label: t.table_name,
-    hint: t.organization_name,
-    keywords: t.organization_name
-  }));
+  ).entries.map(({ table: t }) => t);
+  const sameName = /* @__PURE__ */ new Map();
+  for (const t of options) {
+    const key = `${t.organization_id}|${t.table_name.trim().toLowerCase()}`;
+    sameName.set(key, (sameName.get(key) ?? 0) + 1);
+  }
+  const pickerOptions = options.map((t) => {
+    const twin = (sameName.get(`${t.organization_id}|${t.table_name.trim().toLowerCase()}`) ?? 0) > 1;
+    const row = t;
+    const second = [
+      row.created_by_name ? `by ${row.created_by_name}` : null,
+      row.updated_at ? `changed ${new Date(row.updated_at).toLocaleDateString()}` : null
+    ].filter(Boolean).join(" \xB7 ");
+    return {
+      value: t.table_id,
+      // The organization hint already tells two same-named tables apart across organizations.
+      label: t.table_name,
+      hint: t.organization_name,
+      keywords: t.organization_name,
+      ...twin && second ? {
+        render: /* @__PURE__ */ jsxs16("span", { className: "flex min-w-0 flex-col", children: [
+          /* @__PURE__ */ jsx19("span", { className: "truncate", children: t.table_name }),
+          /* @__PURE__ */ jsx19("span", { className: "truncate text-[11px] text-muted-foreground", children: second })
+        ] })
+      } : {}
+    };
+  });
   const missing = Boolean(value) && !list.loading && !list.error && !list.rows.some((t) => t.table_id === value);
   return /* @__PURE__ */ jsxs16("div", { className: "flex flex-col gap-1", children: [
     /* @__PURE__ */ jsx19(
       CreatablePicker,
       {
         value: value || null,
-        options,
+        options: pickerOptions,
         onSelect: onChange,
         placeholder: missing ? "Table not available" : "Choose a table",
         searchPlaceholder: "Search tables",
@@ -4478,7 +4542,7 @@ function referencesOf(field, value, kind, labels) {
   }));
 }
 var ARCHIVED_REFERENCE_WORD = "Archived";
-var ARCHIVED_REFERENCE_TIP = "In Trash; restore it to use it again";
+var ARCHIVED_REFERENCE_TIP = "In the Archived view; restore it to use it again";
 function ReferenceChip({ reference, waiting }) {
   const host = useRecordsUi();
   const words = reference.label ?? (reference.token === "record" ? waiting ?? "Loading\u2026" : WITHHELD_ENTITY_LABEL);