@burdenoff/fluidgrids-fe-sdk 2026.1105.4 → 2026.1106.1

package/README.md

@@ -256,6 +256,10 @@ import { WorkflowPreviewCanvas, previewCanvasFromDefinition, previewRevealOrder
 - `resolveNodeMeta(nodeType)` (optional, keep it stable) supplies registry names
   and icons; without it a card uses the node's saved manifest, then a name and
   icon derived from its type.
+- Edges follow the builder's rule: an edge whose source or target handle the
+  builder's card for that node does not have (read from the node's stored data,
+  as the builder reads it) is not drawn, so the preview never shows a
+  connection the builder drops.
 - Nodes cannot be dragged, connected, selected or deleted; pan and zoom work.
 - `prefers-reduced-motion: reduce` turns every animation off.
 

package/dist/workflow-preview.d.ts

@@ -93,9 +93,16 @@ declare function fallbackNodeIcon(nodeType: string): string;
 declare function previewCardModel(raw: Node, resolveMeta?: WorkflowPreviewNodeMetaResolver): PreviewCardModel;
 /**
  * The preview canvas of a stored definition, or `null` when it carries no
- * canvas. Sticky notes are annotations, not steps, so they are left out; an
- * edge to a node the preview does not draw is dropped, and a target handle
- * the target card does not have falls back to its first input.
+ * canvas. Sticky notes are annotations, not steps, so they are left out, with
+ * any edge to one.
+ *
+ * ★ An edge is drawn only when the builder draws it (`builderCardPorts`): one
+ * whose source or target handle the builder's card does not have (an
+ * assistant-written `handle('output')` on a node whose only output is
+ * `source`, or any edge into a trigger) is left out, never given a port of its
+ * own. The preview used to invent a labelled port for every unknown handle,
+ * so it showed connections the builder silently drops (BOFF-9806). The rule
+ * needs no node registry because the builder's does not use one either.
  */
 declare function previewCanvasFromDefinition(definitionJson: unknown, resolveMeta?: WorkflowPreviewNodeMetaResolver): PreviewCanvasModel | null;
 /**

package/dist/workflow-preview.js

@@ -1,5 +1,5 @@
 import { canvasFromDefinition } from './chunk-6VIG44VF.js';
-import { LogicNodeCard, NodeCard, NodeCardHeader, NodeCardBody, InputHandles, OutputHandles, STICKY_NOTE_TYPE, outputHandlesSpacerHeight, isNodeTrigger, resolveOutputHandles, resolveInputHandles, resolveOperationName, WAIT_FOR_SIGNAL_NODE_TYPE, CODE_WORKFLOW_NODE_TYPE, readSignalName } from './chunk-TGWDFLEX.js';
+import { LogicNodeCard, NodeCard, NodeCardHeader, NodeCardBody, InputHandles, OutputHandles, STICKY_NOTE_TYPE, isNodeTrigger, resolveOutputHandles, resolveInputHandles, resolveOperationName, outputHandlesSpacerHeight, WAIT_FOR_SIGNAL_NODE_TYPE, CODE_WORKFLOW_NODE_TYPE, readSignalName } from './chunk-TGWDFLEX.js';
 import './chunk-Y7FKJJMF.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { memo, useMemo, useState, useCallback, useSyncExternalStore, useRef, useEffect } from 'react';
@@ -119,27 +119,14 @@ function previewCardModel(raw, resolveMeta) {
     )
   };
 }
-function branchTone(id) {
-  const key = id.toLowerCase();
-  if (key === "true" || key === "success" || key === "approved")
-    return "success";
-  if (key === "false" || key === "done") return "neutral";
-  if (key === "error" || key === "failed" || key === "declined") return "error";
-  return void 0;
-}
-function withEdgeSourceHandles(card, edgeHandleIds) {
+function withAdapterPorts(card, edgeHandleIds) {
   const known = new Set(card.outputHandles.map((handle) => handle.id));
   const missing = [...new Set(edgeHandleIds)].filter((id) => !known.has(id));
   if (missing.length === 0) return card;
-  const isDefault = card.outputHandles.length === 1 && card.outputHandles[0]?.label === "";
-  const named = missing.map((id) => ({
-    id,
-    label: id,
-    tone: branchTone(id)
-  }));
-  if (isDefault && named.length === 1)
-    return { ...card, outputHandles: [{ id: named[0].id, label: "" }] };
-  const outputHandles = isDefault ? named : [...card.outputHandles, ...named];
+  const outputHandles = [
+    ...card.outputHandles,
+    ...missing.map((id) => ({ id, label: id }))
+  ];
   return {
     ...card,
     outputHandles,
@@ -148,28 +135,82 @@ function withEdgeSourceHandles(card, edgeHandleIds) {
     )
   };
 }
+function adapterPortNames(data) {
+  const manifest = isRecord(data.nodeData) ? data.nodeData : {};
+  const adapters = Array.isArray(manifest.nodeAdapters) ? manifest.nodeAdapters : [];
+  return adapters.map((adapter) => isRecord(adapter) ? adapter.name : void 0).filter((name) => typeof name === "string" && !!name);
+}
+function builderCardPorts(nodes, edges, cards) {
+  const adapters = /* @__PURE__ */ new Map();
+  for (const node of nodes)
+    adapters.set(node.id, adapterPortNames(cardData(node)));
+  const adapterSets = new Map(
+    [...adapters].map(([id, names]) => [id, new Set(names)])
+  );
+  const subNodes = /* @__PURE__ */ new Set();
+  for (const node of nodes) {
+    if (cardData(node).isAdapterInstance) subNodes.add(node.id);
+  }
+  for (const edge of edges) {
+    const handle = edge.sourceHandle;
+    if (!handle || handle === "source") continue;
+    if (adapterSets.get(edge.source)?.has(handle)) subNodes.add(edge.target);
+  }
+  const ports = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const card = cards.get(node.id);
+    if (!card) continue;
+    const own = adapters.get(node.id) ?? [];
+    if (subNodes.has(node.id)) {
+      ports.set(node.id, { sources: own, targets: ["target"] });
+      continue;
+    }
+    const hasInputs = card.variant === "logic" || !card.trigger;
+    ports.set(node.id, {
+      sources: [...card.outputHandles.map((handle) => handle.id), ...own],
+      targets: hasInputs ? card.inputHandles.map((handle) => handle.id) : []
+    });
+  }
+  return ports;
+}
+function builderHandle(ports, handle) {
+  if (!handle) return ports[0] ?? null;
+  return ports.includes(handle) ? handle : null;
+}
 function previewCanvasFromDefinition(definitionJson, resolveMeta) {
   const canvas = canvasFromDefinition(definitionJson);
   if (!canvas) return null;
   const steps = canvas.nodes.filter((node) => node.type !== STICKY_NOTE_TYPE);
   const ids = new Set(steps.map((node) => node.id));
-  const rawEdges = canvas.edges.filter(
+  const betweenSteps = canvas.edges.filter(
     (edge) => ids.has(edge.source) && ids.has(edge.target)
   );
+  const resolved = /* @__PURE__ */ new Map();
+  for (const raw of steps)
+    resolved.set(raw.id, previewCardModel(raw, resolveMeta));
+  const ports = builderCardPorts(steps, betweenSteps, resolved);
+  const rawEdges = betweenSteps.flatMap((edge) => {
+    const sourceHandle = builderHandle(
+      ports.get(edge.source)?.sources ?? [],
+      edge.sourceHandle
+    );
+    const targetHandle = builderHandle(
+      ports.get(edge.target)?.targets ?? [],
+      edge.targetHandle
+    );
+    return sourceHandle && targetHandle ? [{ ...edge, sourceHandle, targetHandle }] : [];
+  });
   const sourceHandles = /* @__PURE__ */ new Map();
   for (const edge of rawEdges) {
-    if (!edge.sourceHandle) continue;
     const list = sourceHandles.get(edge.source) ?? [];
     list.push(edge.sourceHandle);
     sourceHandles.set(edge.source, list);
   }
-  const cards = /* @__PURE__ */ new Map();
   const nodes = steps.map((raw) => {
-    const card = withEdgeSourceHandles(
-      previewCardModel(raw, resolveMeta),
+    const card = withAdapterPorts(
+      resolved.get(raw.id) ?? previewCardModel(raw, resolveMeta),
       sourceHandles.get(raw.id) ?? []
     );
-    cards.set(raw.id, card);
     const position = isRecord(raw.position) ? raw.position : {};
     return {
       id: raw.id,
@@ -185,23 +226,17 @@ function previewCanvasFromDefinition(definitionJson, resolveMeta) {
       deletable: false
     };
   });
-  const edges = rawEdges.map((edge) => {
-    const sourceCard = cards.get(edge.source);
-    const targetCard = cards.get(edge.target);
-    const targetHandle = edge.targetHandle && targetCard?.inputHandles.some((h) => h.id === edge.targetHandle) ? edge.targetHandle : targetCard?.inputHandles[0]?.id ?? null;
-    const sourceHandle = edge.sourceHandle ?? sourceCard?.outputHandles[0]?.id ?? null;
-    return {
-      id: edge.id,
-      source: edge.source,
-      target: edge.target,
-      sourceHandle,
-      targetHandle,
-      type: PREVIEW_EDGE_TYPE,
-      selectable: false,
-      deletable: false,
-      focusable: false
-    };
-  });
+  const edges = rawEdges.map((edge) => ({
+    id: edge.id,
+    source: edge.source,
+    target: edge.target,
+    sourceHandle: edge.sourceHandle,
+    targetHandle: edge.targetHandle,
+    type: PREVIEW_EDGE_TYPE,
+    selectable: false,
+    deletable: false,
+    focusable: false
+  }));
   return { nodes, edges };
 }
 function previewRevealOrder(nodes, shown = /* @__PURE__ */ new Set()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fluidgrids-fe-sdk",
-  "version": "2026.1105.4",
+  "version": "2026.1106.1",
   "description": "FluidGrids Workflow Builder SDK - Embeddable visual workflow automation",
   "type": "module",
   "imports": {