@ai-matrx/records-ui 0.65.0 → 0.67.0

package/dist/index.js

@@ -80,12 +80,12 @@ var NO_RIGHTS = tableRights(NOT_ANSWERED_YET);
 function tableRightsAt(level) {
   return tableRights(whatYouMayDo(level, true));
 }
-var NO_SAVED_VIEWS_REASON = "No saved-view port is bound, so there is nothing here to subscribe to. A subscription points at a `platform.saved_view`, which the record store has no door onto \u2014 bind `savedViews` on <RecordsUiProvider> with your host's own list and the picker appears.";
-var NO_MEMBERS_REASON = "No membership port is bound, so this question cannot offer anybody. A person field points at the kernel Person Table, and who is in this organization is the platform's answer rather than the record store's \u2014 bind `members` on <RecordsUiProvider> with your host's own roster and the picker appears.";
-var NO_SHARE_REASON = "No share dialog is bound, so this screen offers no Share button rather than one that opens nothing. Bind `share` on <RecordsUiProvider> with the app's own sharing dialog \u2014 AI Matrx has exactly one (features/sharing), and this package deliberately does not ship a second.";
-var NO_OPEN_RECORDS_REASON = "These numbers do not click through yet. Every one of them is a count of real records, and where this app puts its grid is the host's routing rather than this package's \u2014 bind `openRecords` on <RecordsUiProvider> and a bar, a slice or a row opens the records it counted.";
-var NO_REASK_REASON = "Asking for a change in words needs an agent, and this package deliberately reaches one through the host rather than calling a model itself. Bind `onReask` on <RecordsUiProvider> \u2014 it drives `dashboard_propose` on the server's `records` tool with this dashboard's id \u2014 and this box works.";
-var NO_UPLOAD_REASON = "No file store is bound, so this question cannot take a file. Bind `upload` on <RecordsUiProvider> with your host's file service and the chooser appears.";
+var NO_SAVED_VIEWS_REASON = "There are no saved views here yet, so there is nothing to be told about. Save a view of this table first and it will be offered here.";
+var NO_MEMBERS_REASON = "This app cannot offer the people in your organization on this screen yet, so there is nobody to pick. Type the person's name into a text field for now, and tell us \u2014 it is on our list, not yours.";
+var NO_SHARE_REASON = "Sharing is not available on this screen, so there is no Share button here rather than one that opens nothing. Share this table from the tables list instead.";
+var NO_OPEN_RECORDS_REASON = "These numbers do not click through yet. Every one of them is a count of real records \u2014 open the records view and group it by the same field to see them. It is on our list, not yours.";
+var NO_REASK_REASON = "Changing this dashboard by describing it is not switched on here yet, so this box is off rather than one that goes nowhere. Add and remove the blocks by hand above. It is on our list, not yours.";
+var NO_UPLOAD_REASON = "This screen cannot take a file yet, so there is no chooser here rather than one that loses what you pick. Put a link to the file in a text field for now. It is on our list, not yours.";
 var HostContext = createContext(null);
 function RecordsUiProvider({ value, children }) {
   const bound = useMemo(() => value, [value]);
@@ -160,6 +160,10 @@ var TITLE = {
   not_supported: "That cannot be done here",
   store_limit: "This has got as big as it can",
   store_not_served: "This organization does not keep its data here",
+  unreachable: "We could not reach your data",
+  needs_approval: "This is waiting on someone's approval",
+  stale_read: "Your view of this is a moment behind",
+  timed_out: "That took too long to answer",
   internal: "Something went wrong at our end"
 };
 var REMEDY = {
@@ -174,8 +178,35 @@ var REMEDY = {
   not_supported: "There is another way to do this \u2014 ask, and we will point you at it.",
   store_limit: "Split it up, or ask us to raise the ceiling for your organization.",
   store_not_served: "An administrator of this organization turns the record store on from the data settings screen.",
+  // 🚨 NOTHING WAS WRITTEN AND NOTHING WAS REFUSED (lane TAILS-6). The call
+  // never arrived, so "try again" is the honest instruction rather than a
+  // consolation — and saying nothing changed is the half a person actually
+  // worries about.
+  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.",
   internal: "Nothing you did caused this. Try again, and tell us if it keeps happening."
 };
+var ENGINEER_TEXT = [
+  /@ai-matrx\//,
+  /\bSQLSTATE\b/i,
+  /\bPostgREST\b/i,
+  /\bIndexedDB\b/i,
+  // `<RecordsUiProvider>` — a component, on a screen.
+  /<\/?[A-Z][A-Za-z0-9]*\s*\/?>/,
+  // `savedViews`, `openRecords`, `onReask` — an identifier, however it is
+  // quoted. English does not write camelCase; code does.
+  /\b[a-z][a-z0-9]*[A-Z][A-Za-z0-9]*\b/,
+  // A backticked token is a thing you type into an editor, not a thing you do.
+  /`[A-Za-z_][A-Za-z0-9_.]*`/,
+  // "bind X on Y", "pass X", "import X" — an instruction to whoever maintains
+  // the app, arriving on the screen of somebody who cannot act on it.
+  /\bbind\s+[`'"A-Za-z]/i
+];
+function isEngineerText(text) {
+  return ENGINEER_TEXT.some((shape) => shape.test(text));
+}
 function withoutMachineClauses(sentence2) {
   const dropped = [];
   const footnotes = [];
@@ -213,11 +244,17 @@ function refusalForAPerson(error) {
   const message = plainSentence(String(error.message ?? ""));
   const hint = plainSentence(String(error.hint ?? ""));
   const title = TITLE[code] ?? "The store refused this";
-  const remedy = hint.kept ?? REMEDY[code] ?? REMEDY["internal"];
-  const said = (message.kept ?? "").trim();
+  const hintIsForEngineers = isEngineerText(String(error.hint ?? ""));
+  const remedy = (hintIsForEngineers ? null : hint.kept) ?? REMEDY[code] ?? REMEDY["internal"];
+  const messageIsForEngineers = isEngineerText(String(error.message ?? ""));
+  const said = (messageIsForEngineers ? "" : message.kept ?? "").trim();
   const forEngineers = [
     error.sqlstate ? `SQLSTATE ${error.sqlstate}.` : null,
-    error.hint && hint.kept !== error.hint ? `Hint: ${error.hint}` : null,
+    // The client's own note about a class it did not recognise, or a call that
+    // never reached the store. It is rendered out of sight, never as a sentence.
+    error.diagnostic ? error.diagnostic : null,
+    messageIsForEngineers ? `Message: ${error.message}` : null,
+    error.hint && (hintIsForEngineers || hint.kept !== error.hint) ? `Hint: ${error.hint}` : null,
     message.dropped.length > 0 || hint.dropped.length > 0 ? `Dropped from the person's view: ${[...message.dropped, ...hint.dropped].join(" | ")}` : null
   ].filter(Boolean).join(" ");
   return {
@@ -571,6 +608,9 @@ function isRelationFieldType(id) {
 function parityTypesWithNoExplanation() {
   return PARITY_FIELD_TYPES.map((row) => row.parity_type).filter((type) => !BY_ID.has(type));
 }
+var ADD_FIELD_OPEN_LABEL = "Add field";
+var ADD_FIELD_SAVE_LABEL = "Create field";
+var EDIT_FIELD_SAVE_LABEL = "Save field";
 
 // src/parity.ts
 var kernelId = (name) => KERNEL_TABLES.find((t) => t.name === name)?.id ?? "";
@@ -2482,7 +2522,7 @@ import {
   cn as cn8
 } from "@ai-matrx/design-system";
 import { Fragment as Fragment4, jsx as jsx11, jsxs as jsxs7 } from "react/jsx-runtime";
-var NO_ENRICH_REASON = "No enrich port is bound, so this panel does not offer to fill a column it cannot fill. The value has to be written by the SERVER with actor `agent` on behalf of you \u2014 a browser that stamped itself `agent` would be a browser claiming to be one \u2014 so bind `enrich` on <RecordsUiProvider> with a call to the server's own `records` tool (action `enrich_propose`). Everything else on this panel works without it.";
+var NO_ENRICH_REASON = "Having an agent fill this column is not switched on here yet, so this panel does not offer it rather than offering something that cannot happen. Everything else on this panel works. It is on our list, not yours.";
 function cellState(cell) {
   if (!cell || !cell.agent_owned) return "none";
   if (cell.pinned) return "yours";
@@ -4781,7 +4821,7 @@ function FieldEditor({ tableId, field, onSaved, onCancel, onRemoved, className }
           size: "sm",
           disabled: mutation.saving || missing !== null,
           onClick: () => void save(),
-          children: mutation.saving ? "Saving\u2026" : field ? "Save field" : "Add field"
+          children: mutation.saving ? "Saving\u2026" : field ? EDIT_FIELD_SAVE_LABEL : ADD_FIELD_SAVE_LABEL
         }
       ),
       onCancel ? /* @__PURE__ */ jsx17(Button12, { size: "sm", variant: "ghost", onClick: onCancel, children: "Cancel" }) : null,
@@ -5816,7 +5856,7 @@ import { useEffect as useEffect9, useMemo as useMemo14, useState as useState18 }
 import { useRecordsClient as useRecordsClient12 } from "@ai-matrx/records/react";
 import { Skeleton as Skeleton4, cn as cn16 } from "@ai-matrx/design-system";
 import { jsx as jsx21, jsxs as jsxs17 } from "react/jsx-runtime";
-var NO_CHAT_REASON = "No chat port is bound, so this panel is absent rather than showing a composer that goes nowhere. Bind `chat` on <RecordsUiProvider> with your host's own chat surface \u2014 in AI Matrx that is `AgentConversationColumn`, launched through a Mandate \u2014 and this panel becomes that surface with this record as its context. This package deliberately ships no second chat UI.";
+var NO_CHAT_REASON = "Chatting about this record is not switched on here yet, so this panel is empty rather than showing a box that goes nowhere. It is on our list, not yours.";
 function RecordChat({ tableId, recordId, className }) {
   const client = useRecordsClient12();
   const host = useRecordsUi();
@@ -9760,6 +9800,7 @@ function PortalsPanel({ tableId, className }) {
           {
             portalId: portal.portal_id,
             ...tableId ? { tableId } : {},
+            origin,
             onChanged: () => void load()
           }
         ) : null
@@ -9767,7 +9808,7 @@ function PortalsPanel({ tableId, className }) {
     }) })
   ] });
 }
-function CopyLink({ url }) {
+function CopyLink({ url, what }) {
   const [copied, setCopied] = useState33(false);
   const [shown, setShown] = useState33(false);
   return /* @__PURE__ */ jsxs32(Fragment16, { children: [
@@ -9788,7 +9829,7 @@ function CopyLink({ url }) {
             }
           })();
         },
-        children: copied ? "Copied" : "Copy link"
+        children: copied ? "Copied" : what ? `Copy ${what}` : "Copy link"
       }
     ),
     shown ? /* @__PURE__ */ jsxs32("p", { className: "mt-1.5 w-full break-all rounded border border-dashed border-border px-2 py-1 text-xs", children: [
@@ -9800,6 +9841,7 @@ function CopyLink({ url }) {
 function PortalDetail({
   portalId,
   tableId,
+  origin,
   onChanged
 }) {
   const client = useRecordsClient25();
@@ -9849,6 +9891,7 @@ function PortalDetail({
     PortalCardView,
     {
       card,
+      origin,
       ...tableId ? { tableId } : {},
       onRevoke: revoke,
       onPreview: preview,
@@ -9871,6 +9914,7 @@ function PortalCardView({
   onRevoke,
   onPreview,
   invite,
+  origin,
   className
 }) {
   return /* @__PURE__ */ jsxs32("div", { className: cn30("mt-2.5 flex flex-col gap-2.5 border-t border-border pt-2.5", className), children: [
@@ -9901,7 +9945,7 @@ function PortalCardView({
       ] }, exposed.table_id))
     ] }),
     /* @__PURE__ */ jsx36(Separator10, {}),
-    /* @__PURE__ */ jsx36(People, { card, onRevoke, onPreview }),
+    /* @__PURE__ */ jsx36(People, { card, onRevoke, onPreview, origin }),
     invite ? /* @__PURE__ */ jsxs32(Fragment16, { children: [
       /* @__PURE__ */ jsx36(Separator10, {}),
       invite
@@ -9911,8 +9955,10 @@ function PortalCardView({
 function People({
   card,
   onRevoke,
-  onPreview
+  onPreview,
+  origin
 }) {
+  const here = origin ?? (typeof window === "undefined" ? "" : window.location.origin);
   const [askingToRevoke, setAskingToRevoke] = useState33(null);
   const [busy, setBusy] = useState33(false);
   const [said, setSaid] = useState33(null);
@@ -9954,6 +10000,7 @@ function People({
             /* @__PURE__ */ jsx36("p", { className: "mt-0.5 break-all text-muted-foreground", children: person.email }),
             /* @__PURE__ */ jsx36("p", { className: "mt-0.5 text-muted-foreground", children: state.why }),
             person.is_active ? /* @__PURE__ */ jsxs32("div", { className: "mt-1.5 flex flex-wrap gap-1.5", children: [
+              person.accept_path ? /* @__PURE__ */ jsx36(CopyLink, { url: `${here}${person.accept_path}`, what: "their link" }) : null,
               /* @__PURE__ */ jsx36(
                 Button30,
                 {
@@ -9965,6 +10012,11 @@ function People({
               ),
               /* @__PURE__ */ jsx36(Button30, { size: "sm", variant: "ghost", onClick: () => setAskingToRevoke(person), children: "Remove their access" })
             ] }) : null,
+            person.is_active && !person.signed_in && !person.accept_path ? /* @__PURE__ */ jsxs32("p", { className: "mt-1.5 text-muted-foreground", children: [
+              "There is no link to copy for ",
+              person.client || person.email,
+              ": they were asked some other way, or the link they were sent has expired. Invite them again and a fresh one is made."
+            ] }) : null,
             asking ? /* @__PURE__ */ jsxs32("div", { className: "mt-1.5 flex flex-col gap-1.5 rounded border border-destructive/40 px-2 py-1.5", children: [
               /* @__PURE__ */ jsx36("span", { className: "text-destructive", children: revokeConsequence(person, card.title) }),
               /* @__PURE__ */ jsxs32("div", { className: "flex flex-wrap gap-1.5", children: [
@@ -13810,7 +13862,7 @@ function CaptureRun({ sheetId, face: given, className }) {
 // src/CaptureSheet.tsx
 import { Fragment as Fragment25, jsx as jsx52, jsxs as jsxs48 } from "react/jsx-runtime";
 var CAPTURE_MODES = ["reading", "photo", "voice"];
-var IN_MEMORY_QUEUE_REASON = "No capture queue is bound, so anything that cannot be sent right now is held in this page's memory and is lost if the page closes. Bind `captureQueue` on <RecordsUiProvider> with your host's own durable store (IndexedDB in a browser) and a queued capture survives the tab, the reload and the flight. It is said here rather than discovered later.";
+var IN_MEMORY_QUEUE_REASON = "Anything you capture while offline is held only in this page until it can be sent, and it is lost if you close the tab. Keep this page open until you are back on a connection. It is said here rather than discovered later.";
 function mintClientKey() {
   const c = globalThis.crypto;
   if (typeof c?.randomUUID === "function") return `capture:${c.randomUUID()}`;
@@ -14686,6 +14738,10 @@ import { useCallback as useCallback37, useEffect as useEffect41, useState as use
 import { useRecordsClient as useRecordsClient43, useTable as useTable22 } from "@ai-matrx/records/react";
 import { Button as Button48, Separator as Separator12, Skeleton as Skeleton34, cn as cn51 } from "@ai-matrx/design-system";
 import { Fragment as Fragment28, jsx as jsx58, jsxs as jsxs53 } from "react/jsx-runtime";
+function cameFromLine(label, groupField) {
+  const grouped = groupField ? `grouped into the same columns the chart used` : `for this table`;
+  return `You came here from \u201C${label}\u201D. This is every record ${grouped} \u2014 not only the ones that number counted \u2014 so the column you clicked is here with the rest beside it.`;
+}
 var TABLE_NOT_REACHABLE = "This table is not in the organization you are working in, so there is nothing here to show. Switch to the organization that owns it and open it again \u2014 or it may have been deleted.";
 var DEFAULT_VIEW_NAME = "All records";
 var VIEW_NOT_SAVED_YET = "This table has no saved view yet, so the layout you pick here is not being kept. Save one from the bar above and it is remembered.";
@@ -14729,6 +14785,8 @@ function TablePage({
   activeRecordId,
   activeView,
   onViewChanged,
+  activeGroupField,
+  cameFrom,
   className
 }) {
   const client = useRecordsClient43();
@@ -14814,7 +14872,7 @@ function TablePage({
               variant: surfaceChosen(surface, { rail: "field" }) ? "secondary" : "outline",
               "aria-pressed": surfaceChosen(surface, { rail: "field" }),
               onClick: () => press({ rail: "field" }),
-              children: "Add field"
+              children: ADD_FIELD_OPEN_LABEL
             }
           ),
           /* @__PURE__ */ jsx58(
@@ -14922,10 +14980,24 @@ function TablePage({
       ] }),
       main === "dashboards" ? /* @__PURE__ */ jsx58(DashboardCanvas, { tableId, activeDashboardId: activeDashboardId ?? null }) : /* @__PURE__ */ jsxs53(Fragment28, { children: [
         opened.unknown ? /* @__PURE__ */ jsx58("p", { className: "rounded-md border border-amber-600/40 bg-amber-500/5 px-3 py-2 text-xs leading-relaxed text-amber-700 dark:border-amber-400/40 dark:text-amber-300", children: unknownViewLine(opened.unknown) }) : null,
+        cameFrom ? /* @__PURE__ */ jsx58(
+          "p",
+          {
+            "data-testid": "came-from-a-number",
+            className: "rounded-md border px-3 py-2 text-xs leading-relaxed text-muted-foreground",
+            children: cameFromLine(cameFrom, activeGroupField ?? null)
+          }
+        ) : null,
         /* @__PURE__ */ jsx58(
           ViewSwitcher,
           {
-            view: { ...view ?? defaultView(tableId), layout: shownLayout },
+            view: {
+              ...view ?? defaultView(tableId),
+              layout: shownLayout,
+              // The address's field wins for this visit; silence keeps the
+              // saved view's own choice, exactly as it always did.
+              ...activeGroupField ? { groupField: activeGroupField } : {}
+            },
             pageSize,
             onLayoutChange: (layout) => {
               setLayoutFromLink(layout);
@@ -15065,6 +15137,7 @@ export {
   DocRender,
   DocTemplate,
   EMPTY_PRESENTATION,
+  ENGINEER_TEXT,
   EmbedFrame,
   EnrichBadge,
   EnrichPanel,
@@ -15188,6 +15261,7 @@ export {
   blockFromSpec,
   bodyForReading,
   bodyFromKeys,
+  cameFromLine,
   cellState,
   chooseSurface,
   colorFromTheValue,
@@ -15219,6 +15293,7 @@ export {
   hintIsMachineIdentity,
   humanize,
   idsOf,
+  isEngineerText,
   isId,
   isMachineIdentity,
   isPlainFieldType,