@ai-matrx/records-ui 0.93.29 → 0.93.33

package/dist/index.js

@@ -597,7 +597,7 @@ import {
 
 // src/editors.tsx
 import { useCallback as useCallback3, useEffect as useEffect7, useRef as useRef5, useState as useState9 } from "react";
-import { allowsOtherValues, choiceValuesOf, coerceTypedAnswer, decideTypedChoice, isTheChosen, optionKey } from "@ai-matrx/records";
+import { allowsOtherValues, choiceValuesOf, coerceTypedAnswer, decideTypedChoice, isTheChosen, optionKey as optionKey2 } from "@ai-matrx/records";
 import { useOptionalRecordsClient as useOptionalRecordsClient5 } from "@ai-matrx/records/react";
 import {
   BasicInput as BasicInput5,
@@ -1325,6 +1325,7 @@ import { Badge, Button as Button5 } from "@ai-matrx/design-system";
 // src/labels.tsx
 import { createContext as createContext2, useCallback, useContext as useContext2, useEffect as useEffect3, useMemo as useMemo4, useRef, useState as useState4 } from "react";
 import { useRecordsClient } from "@ai-matrx/records/react";
+import { optionKey } from "@ai-matrx/records";
 import { jsx as jsx6 } from "react/jsx-runtime";
 var LabelContext = createContext2({
   // With no provider the resolver is ABSENT, not silently empty: a caller gets
@@ -1345,6 +1346,9 @@ function idsOf(value) {
   return [];
 }
 var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function choiceKeyName(fieldId, key) {
+  return `${fieldId}\0key\0${key}`;
+}
 function isId(value) {
   return typeof value === "string" && UUID.test(value);
 }
@@ -1411,7 +1415,10 @@ function RecordLabelProvider({ children }) {
             setNames((current) => {
               const next = { ...current };
               for (const option of result.data ?? []) {
-                next[option.id] = recordName(option.data, null, "Unnamed choice");
+                const words2 = recordName(option.data, null, "Unnamed choice");
+                next[option.id] = words2;
+                const key = optionKey(option);
+                if (key) next[choiceKeyName(field2.id, key)] = words2;
               }
               return next;
             });
@@ -1475,14 +1482,26 @@ function RecordLabelProvider({ children }) {
     },
     []
   );
+  const rereadFor = useRef(/* @__PURE__ */ new Set());
   const lookup = useCallback(
     (field2, id) => {
+      if (field2.type === "list" && !isId(id)) {
+        const named = names[choiceKeyName(field2.id, id)];
+        if (named !== void 0) return named;
+        const once = choiceKeyName(field2.id, id);
+        if (settled[field2.id] && !rereadFor.current.has(once)) {
+          rereadFor.current.add(once);
+          asked2.current.delete(field2.id);
+          want(field2);
+        }
+        return null;
+      }
       const known = names[id];
       if (known !== void 0) return known;
       if (settled[field2.id]) chase(field2, id);
       return null;
     },
-    [names, settled, chase]
+    [names, settled, chase, want]
   );
   const waiting = useCallback((field2) => waitingLines[field2.id] ?? null, [waitingLines]);
   const value = useMemo4(() => ({ lookup, want, waiting }), [lookup, want, waiting]);
@@ -2564,7 +2583,7 @@ function TypedTextControl({ field: field2, value, onChange, disabled, id, onComm
       " ",
       needsChoices ? String(
         (Array.isArray(withoutAddition(judged.value).value) ? withoutAddition(judged.value).value : [withoutAddition(judged.value).value]).map((k) => {
-          const option = choices?.find((o) => optionKey(o) === k);
+          const option = choices?.find((o) => optionKey2(o) === k);
           return option ? recordName(option.data, null, String(k)) : String(k);
         }).join(", ")
       ) : (() => {
@@ -2836,18 +2855,18 @@ function OptionControl({ field: field2, value, onChange, disabled, id, autoOpen,
   const titleOf = (option) => recordName(option.data, null, "Unnamed choice");
   if (field2.multi) {
     const chosen = options.filter((option) => choiceValuesOf(value).some((v) => isTheChosen(option, v)));
-    const picked = new Set(chosen.map((option) => optionKey(option)));
+    const picked = new Set(chosen.map((option) => optionKey2(option)));
     const toggles = /* @__PURE__ */ jsx12("div", { id: autoOpen ? void 0 : id, className: "flex flex-wrap gap-1", children: options.map((option) => /* @__PURE__ */ jsx12(
       Button6,
       {
         type: "button",
         size: "sm",
-        variant: picked.has(optionKey(option)) ? "default" : "outline",
+        variant: picked.has(optionKey2(option)) ? "default" : "outline",
         disabled,
         onClick: () => {
           const next = new Set(picked);
-          if (next.has(optionKey(option))) next.delete(optionKey(option));
-          else next.add(optionKey(option));
+          if (next.has(optionKey2(option))) next.delete(optionKey2(option));
+          else next.add(optionKey2(option));
           onChange(next.size === 0 ? null : [...next]);
         },
         children: titleOf(option)
@@ -2873,7 +2892,7 @@ function OptionControl({ field: field2, value, onChange, disabled, id, autoOpen,
   return /* @__PURE__ */ jsxs10(
     Select2,
     {
-      value: current ? optionKey(current) : "",
+      value: current ? optionKey2(current) : "",
       disabled: disabled ?? false,
       onValueChange: (next) => onChange(next === "" ? null : next),
       ...autoOpen ? {
@@ -2885,7 +2904,7 @@ function OptionControl({ field: field2, value, onChange, disabled, id, autoOpen,
       } : {},
       children: [
         /* @__PURE__ */ jsx12(SelectTrigger2, { id, size: "sm", children: /* @__PURE__ */ jsx12(SelectValue2, { placeholder: "Choose" }) }),
-        /* @__PURE__ */ jsx12(SelectContent2, { children: options.map((option) => /* @__PURE__ */ jsx12(SelectItem2, { value: optionKey(option), children: titleOf(option) }, option.id)) })
+        /* @__PURE__ */ jsx12(SelectContent2, { children: options.map((option) => /* @__PURE__ */ jsx12(SelectItem2, { value: optionKey2(option), children: titleOf(option) }, option.id)) })
       ]
     }
   );
@@ -2933,7 +2952,7 @@ function OpenChoicePicker({
     if (field2.multi) {
       const existing = current.map((v) => {
         const option = options.find((o) => isTheChosen(o, v));
-        return option ? optionKey(option) : String(v);
+        return option ? optionKey2(option) : String(v);
       });
       const has = existing.some((v) => v.toLowerCase() === word.toLowerCase());
       const list = has ? existing.filter((v) => v.toLowerCase() !== word.toLowerCase()) : [...existing, word];
@@ -3006,7 +3025,7 @@ function OpenChoicePicker({
           })),
           onPick: (optionId) => {
             const option = options.find((o) => o.id === optionId);
-            if (option) choose(optionKey(option));
+            if (option) choose(optionKey2(option));
           },
           empty: q === "" ? /* @__PURE__ */ jsx12("p", { className: "p-2 text-xs text-muted-foreground", children: "No choices yet \u2014 type one to add it." }) : null,
           add,
@@ -3933,6 +3952,10 @@ function scalarText(field2, value, labels, stillWaitingFor) {
   if (isId(value) && (field2.type === "list" || field2.type === "relation")) {
     return labels?.(field2, String(value)) ?? stillWaitingFor ?? "Loading\u2026";
   }
+  if (field2.type === "list" && typeof value === "string" && labels) {
+    const words2 = labels(field2, value);
+    if (words2) return words2;
+  }
   const shownAs = shownAsOf(field2);
   if (shownAs) {
     const said = formatFieldValue3(value, shownAs);
@@ -4533,6 +4556,13 @@ function GridCell({
   onAskWhoChanged
 }) {
   const ui = useRecordsUi();
+  const saidAt = useRef8(0);
+  const sayWhyNot = () => {
+    if (Date.now() - saidAt.current < 4e3) return;
+    saidAt.current = Date.now();
+    const why = fieldIsEditable(field2) ? `${fieldName(field2)} \u2014 ${whyNot ?? "you cannot change this record"}` : `${fieldName(field2)} is worked out by the system, so it cannot be typed in`;
+    ui.notify?.error(why);
+  };
   const open = Boolean(
     editing && editing.editing?.rowId === row.id && editing.editing.key === field2.key
   );
@@ -4651,6 +4681,7 @@ function GridCell({
                   event.preventDefault();
                   event.stopPropagation();
                   if (editable) editing?.begin({ rowId: row.id, key: field2.key });
+                  else sayWhyNot();
                 },
                 onKeyDown: (event) => {
                   if (editable && (event.key === "Enter" || event.key === "F2")) {
@@ -4666,7 +4697,9 @@ function GridCell({
                   if (editable && isTypedCharacter(event) && typingOpens(field2) !== "none") {
                     event.preventDefault();
                     editing?.begin({ rowId: row.id, key: field2.key }, event.key);
+                    return;
                   }
+                  if (!editable && (event.key === "Enter" || event.key === "F2" || isTypedCharacter(event))) sayWhyNot();
                 },
                 tabIndex: editable || onAskWhoChanged ? 0 : void 0,
                 children: /* @__PURE__ */ jsx18(
@@ -7317,7 +7350,7 @@ function entityReferenceKindsOf(field2) {
 
 // src/gridColors.tsx
 import { useCallback as useCallback8, useEffect as useEffect18, useMemo as useMemo12, useState as useState21 } from "react";
-import { optionKey as optionKey2, optionLabel as optionLabel2 } from "@ai-matrx/records";
+import { optionKey as optionKey3, optionLabel as optionLabel2 } from "@ai-matrx/records";
 import { useRecordsClient as useRecordsClient10 } from "@ai-matrx/records/react";
 import {
   Button as Button15,
@@ -7390,7 +7423,9 @@ function useChoiceOptions(fields, keys) {
   return index;
 }
 function lookOf(option) {
-  return { id: String(option.id), key: optionKey2(option), label: optionLabel2(option) };
+  const raw = option.data?.["color"];
+  const color = typeof raw === "string" && STYLE_COLORS4.includes(raw) ? raw : void 0;
+  return { id: String(option.id), key: optionKey3(option), label: optionLabel2(option), ...color ? { color } : {} };
 }
 function paintByOption(style, fields, index, lookup) {
   if (index.size === 0) return { style, documentOf: (doc) => doc, choiceColorFor: lookup };
@@ -7414,10 +7449,13 @@ function paintByOption(style, fields, index, lookup) {
       }
       return out ?? doc;
     },
+    // A CHOICE PAINTS IN ITS OWN COLOUR (DATA-V2-BASICS-2 C1b): an option kept in its own Table
+    // carries the colour its owner gave it; coloured by Status, a "Verified" (green) row was tinted
+    // pink by the hash. The option's colour first, then the column's stored colours, then the hash.
     choiceColorFor: (fieldKey, value) => {
       const option = optionFor(index.get(fieldKey), value);
       if (!option) return lookup(fieldKey, value);
-      return lookup(fieldKey, option.label) ?? lookup(fieldKey, option.key);
+      return option.color ?? lookup(fieldKey, option.label) ?? lookup(fieldKey, option.key);
     }
   };
 }
@@ -8069,7 +8107,7 @@ function SummarySheetControls({
 
 // src/pasteValues.ts
 import { predictValueRefusals } from "@ai-matrx/records/core";
-import { coerceTypedAnswer as coerceTypedAnswer2, optionKey as optionKey3 } from "@ai-matrx/records";
+import { coerceTypedAnswer as coerceTypedAnswer2, optionKey as optionKey4 } from "@ai-matrx/records";
 function wordForStoredChoice(options, value) {
   if (options === void 0 || typeof value !== "string" || value === "") return null;
   for (const label of options.labels) {
@@ -8082,7 +8120,7 @@ function choiceOptionsOf(options) {
   const labels = [];
   for (const option of options) {
     const id = option.id;
-    const key = optionKey3(option);
+    const key = optionKey4(option);
     const label = recordName(option.data, null, "");
     if (label) {
       labels.push(label);