@ai-matrx/records-ui 0.42.0 → 0.44.0

package/dist/index.d.cts

@@ -2330,6 +2330,19 @@ interface TablePageProps {
      * it always has.
      */
     activeDashboardId?: Uuid$1 | null | undefined;
+    /**
+     * THE RECORD A LINK NAMED, OPENED ON ARRIVAL.
+     *
+     * 🚨 THE DEAD LINK THIS CLOSES (lane SCREENS-2, 2026-09-20). `ActionInbox` has always
+     * handed its host `onOpenRecord(recordId, tableId)`, and the app has always routed that to
+     * `/data-v2/<table>?record=<record>` — and NOTHING read the parameter. Pressing Open on a
+     * checklist step, an assignment or an agent's proposal landed you on the table with the
+     * record still shut, which is the inbox not finishing the sentence it started. Measured in
+     * the real app on a dental practice's onboarding steps.
+     *
+     * Absent, nothing changes: the page opens exactly as it did.
+     */
+    activeRecordId?: Uuid$1 | null | undefined;
     className?: string | undefined;
 }
 /**
@@ -2371,7 +2384,7 @@ declare const DEFAULT_VIEW_NAME = "All records";
  * it: the bar above saves a view, and from then on the layout is remembered.
  */
 declare const VIEW_NOT_SAVED_YET: string;
-declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, className, }: TablePageProps): react.JSX.Element;
+declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, className, }: TablePageProps): react.JSX.Element;
 
 /** One Field a person asked for, in the words a person uses (FLD-1 / FLD-11). */
 interface NewFieldSpec {

package/dist/index.d.ts

@@ -2330,6 +2330,19 @@ interface TablePageProps {
      * it always has.
      */
     activeDashboardId?: Uuid$1 | null | undefined;
+    /**
+     * THE RECORD A LINK NAMED, OPENED ON ARRIVAL.
+     *
+     * 🚨 THE DEAD LINK THIS CLOSES (lane SCREENS-2, 2026-09-20). `ActionInbox` has always
+     * handed its host `onOpenRecord(recordId, tableId)`, and the app has always routed that to
+     * `/data-v2/<table>?record=<record>` — and NOTHING read the parameter. Pressing Open on a
+     * checklist step, an assignment or an agent's proposal landed you on the table with the
+     * record still shut, which is the inbox not finishing the sentence it started. Measured in
+     * the real app on a dental practice's onboarding steps.
+     *
+     * Absent, nothing changes: the page opens exactly as it did.
+     */
+    activeRecordId?: Uuid$1 | null | undefined;
     className?: string | undefined;
 }
 /**
@@ -2371,7 +2384,7 @@ declare const DEFAULT_VIEW_NAME = "All records";
  * it: the bar above saves a view, and from then on the layout is remembered.
  */
 declare const VIEW_NOT_SAVED_YET: string;
-declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, className, }: TablePageProps): react.JSX.Element;
+declare function TablePage({ tableId, pageSize, seedViews, onLeave, leaveLabel, activeDashboardId, activeRecordId, className, }: TablePageProps): react.JSX.Element;
 
 /** One Field a person asked for, in the words a person uses (FLD-1 / FLD-11). */
 interface NewFieldSpec {

package/dist/index.js

@@ -4898,6 +4898,27 @@ import {
 } from "@ai-matrx/records/react";
 import { Button as Button15, Skeleton as Skeleton5, cn as cn17 } from "@ai-matrx/design-system";
 import { jsx as jsx20, jsxs as jsxs17 } from "react/jsx-runtime";
+var UNPLACED = "\0unplaced";
+function stageOfCard(row, stageKey, stages) {
+  const document2 = row.document ?? {};
+  const choices = document2["_choices"];
+  if (choices && typeof choices === "object") {
+    const chosen = choices[stageKey];
+    if (chosen && typeof chosen === "object") {
+      const key = chosen["key"];
+      if (typeof key === "string" && key !== "") {
+        return stages.some((s) => s.key === key) ? key : null;
+      }
+    }
+  }
+  const raw = document2[stageKey];
+  if (raw === null || raw === void 0 || raw === "") return null;
+  const said = String(raw).trim();
+  const byKey = stages.find((s) => s.key === said);
+  if (byKey) return byKey.key;
+  const byLabel = stages.find((s) => s.label.toLowerCase() === said.toLowerCase());
+  return byLabel ? byLabel.key : null;
+}
 function PipelineBoard({
   tableId,
   rows,
@@ -4947,12 +4968,12 @@ function PipelineBoard({
     const map = /* @__PURE__ */ new Map();
     if (!stageKey) return map;
     for (const row of rows) {
-      const raw = (row.document ?? {})[stageKey];
-      const key = raw === null || raw === void 0 || raw === "" ? "" : String(raw);
-      map.set(key, [...map.get(key) ?? [], row]);
+      const key = stageOfCard(row, stageKey, definition?.stages ?? []);
+      map.set(key ?? UNPLACED, [...map.get(key ?? UNPLACED) ?? [], row]);
     }
     return map;
-  }, [rows, stageKey]);
+  }, [rows, stageKey, definition?.stages]);
+  const unplaced = cardsByStage.get(UNPLACED) ?? [];
   const all = fields.data ?? [];
   const titleField = useMemo14(
     () => all.find((f) => f.key !== stageKey) ?? all[0],
@@ -5099,7 +5120,14 @@ function PipelineBoard({
         },
         stage.key
       );
-    }) })
+    }) }),
+    unplaced.length > 0 ? /* @__PURE__ */ jsxs17("p", { className: "text-xs text-muted-foreground", "data-testid": "pipeline-unplaced", children: [
+      unplaced.length === 1 ? "One record is" : `${unplaced.length} records are`,
+      " not in any of these columns \u2014 ",
+      unplaced.slice(0, 3).map((r) => rowName(r, titleField?.key ?? null, "Untitled")).join(", "),
+      unplaced.length > 3 ? ` and ${unplaced.length - 3} more` : "",
+      ". Their stage is not one this pipeline offers, so nothing here can draw them; open one from the grid to move it."
+    ] }) : null
   ] });
 }
 function formatTotal(total) {
@@ -11776,7 +11804,7 @@ function TablesHome({ onOpenTable, className }) {
 }
 
 // src/TablePage.tsx
-import { useCallback as useCallback32, useState as useState45 } from "react";
+import { useCallback as useCallback32, useEffect as useEffect36, useState as useState45 } from "react";
 import { useRecordsClient as useRecordsClient37, useTable as useTable20 } from "@ai-matrx/records/react";
 import { Button as Button40, Separator as Separator8, Skeleton as Skeleton30, cn as cn45 } from "@ai-matrx/design-system";
 import { Fragment as Fragment21, jsx as jsx49, jsxs as jsxs45 } from "react/jsx-runtime";
@@ -11786,6 +11814,9 @@ var VIEW_NOT_SAVED_YET = "This table has no saved view yet, so the layout you pi
 function defaultView(tableId) {
   return { name: DEFAULT_VIEW_NAME, subject: tableId, layout: "grid", isDefault: true };
 }
+function openingRail(activeRecordId) {
+  return activeRecordId ? { rail: "record", record: activeRecordId } : { rail: "none", record: null };
+}
 function TablePage({
   tableId,
   pageSize = 100,
@@ -11793,6 +11824,7 @@ function TablePage({
   onLeave,
   leaveLabel = "Back to your tables",
   activeDashboardId,
+  activeRecordId,
   className
 }) {
   const client = useRecordsClient37();
@@ -11800,12 +11832,18 @@ function TablePage({
   const rights = useTableRights(table.data);
   const organizationId = useRecordsClient37().config.organizationId;
   const [view, setView] = useState45(null);
-  const [rail, setRail] = useState45("none");
+  const opening = openingRail(activeRecordId);
+  const [rail, setRail] = useState45(opening.rail);
   const [asking, setAsking] = useState45(null);
   const [main, setMain] = useState45(activeDashboardId ? "dashboards" : "records");
-  const [openRecord, setOpenRecord] = useState45(null);
+  const [openRecord, setOpenRecord] = useState45(opening.record);
   const viewVersion = useRecordVersion(view?.id ?? null);
   const show = (next) => setRail((current) => current === next ? "none" : next);
+  useEffect36(() => {
+    if (!activeRecordId) return;
+    setOpenRecord(activeRecordId);
+    setRail("record");
+  }, [activeRecordId]);
   const patchView = useCallback32(
     async (patch) => {
       const current = view;