@ai-matrx/records-ui 0.41.0 → 0.42.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog — @ai-matrx/records-ui
 
+## 0.42.0
+
+**A pipeline table opened as "pick a column", and the board it already had was
+unreachable.**
+
+Measured in the real app (lane SCREENS-2, 2026-09-20) against a real pipeline —
+five stages, a moves rule, a requires rule and a WIP limit of 2.
+`custom.pipeline_read` answered `is_pipeline: true` with `stage_field: "stage"`,
+every rule beside it, and the kanban drew
+
+> A kanban board needs a Field to make its columns from — pick one and the board
+> appears.
+
+Two things stacked. `Board`'s "no grouping field" gate sat ABOVE its pipeline
+branch, and `useIsPipeline` answered `stage.key === groupField` — so a table was
+only a pipeline once somebody had ALREADY guessed which column to group by. The
+store knew the answer the whole time and the screen asked the person for it. A
+board nobody can reach without knowing the answer in advance is not a board.
+
+The stage column is now the TABLE's own answer (`custom.table_stage_field`), used
+both to know the table is a pipeline and to know which column its columns come
+from. A view that names its own grouping column still wins — grouping a pipeline
+by its owner is a real thing to want, and it draws the plain board of that column
+and says so. While the table has not answered, NOTHING is claimed in either
+direction: the "pick one" sentence would be a question about to answer itself.
+
+`src/pipeline-reach.test.tsx` is at the one seam that decides it
+(`boardColumnChoice`, exported for exactly that reason) and all four clauses fail
+on 0.41.0's bytes.
+
+**Consumer action:** none. `ViewSwitcher`'s props are unchanged.
+
 ## 0.41.0
 
 **The last two product screens that could not work at all, rewritten against the

package/dist/index.cjs

@@ -5439,7 +5439,7 @@ function offerableFields(all, want) {
     return kind === "datetime" || kind === "date";
   });
 }
-function useIsPipeline(tableId, groupField) {
+function useStageField(tableId) {
   const client = (0, import_react41.useRecordsClient)();
   const [stage, setStage] = (0, import_react40.useState)({
     asked: false,
@@ -5456,8 +5456,17 @@ function useIsPipeline(tableId, groupField) {
       cancelled = true;
     };
   }, [client, tableId]);
-  if (!stage.asked) return null;
-  return stage.key != null && stage.key === groupField;
+  return stage;
+}
+function boardColumnChoice(fields, chosenKey, stage) {
+  const has = (key) => key != null && fields.some((f) => f.key === key) ? key : null;
+  const chosen = has(chosenKey);
+  if (chosen) {
+    return { groupKey: chosen, isPipeline: stage.asked ? stage.key === chosen : null, stillAsking: false };
+  }
+  if (!stage.asked) return { groupKey: null, isPipeline: null, stillAsking: true };
+  const fromTable = has(stage.key);
+  return { groupKey: fromTable, isPipeline: fromTable != null, stillAsking: false };
 }
 function Board({
   view,
@@ -5469,7 +5478,7 @@ function Board({
 }) {
   const fields = (0, import_react41.useFields)(view.subject);
   const records = useViewRecords(view, pageSize);
-  const isPipeline = useIsPipeline(view.subject, view.groupField);
+  const stage = useStageField(view.subject);
   if (fields.error) return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(RefusalNotice, { error: fields.error });
   if (records.error) return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(RefusalNotice, { error: records.error });
   if (fields.loading || records.loading) return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(import_design_system19.Skeleton, { className: "h-40 w-full" });
@@ -5477,7 +5486,9 @@ function Board({
   const byKey = (key) => all.find((f) => f.key === key);
   const titleField = byKey(view.groupField) ? all.find((f) => f.key !== view.groupField) ?? all[0] : all[0];
   if (view.layout === "kanban") {
-    const groupField = byKey(view.groupField);
+    const choice = boardColumnChoice(all, view.groupField, stage);
+    const groupField = byKey(choice.groupKey);
+    const isPipeline = choice.isPipeline;
     const picker = /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       FieldPicker,
       {
@@ -5489,6 +5500,7 @@ function Board({
         onPick: (key) => onChange({ groupField: key })
       }
     );
+    if (choice.stillAsking) return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(import_design_system19.Skeleton, { className: "h-40 w-full" });
     if (!groupField) return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Needs, { layout: "kanban", picker });
     return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "flex min-h-0 flex-col gap-2", children: [
       picker,