@particle-academy/fancy-flow 0.63.0 → 0.64.0

package/dist/index.cjs

@@ -14390,6 +14390,55 @@ function preview(v2) {
   }
 }
 
+// src/analysis/graph-connectivity.ts
+function checkGraphConnectivity(graph) {
+  const { nodes, edges } = graph;
+  const issues = [];
+  const hasIncoming = /* @__PURE__ */ new Set();
+  const hasOutgoing = /* @__PURE__ */ new Set();
+  for (const edge of edges) {
+    hasIncoming.add(edge.target);
+    hasOutgoing.add(edge.source);
+  }
+  const single = nodes.length === 1;
+  for (const node of nodes) {
+    if (single || mayFloat(node)) continue;
+    if (!hasIncoming.has(node.id) && !hasOutgoing.has(node.id)) {
+      issues.push({
+        level: "error",
+        nodeId: node.id,
+        message: `Node "${node.id}" is connected to nothing \u2014 no inbound edge and no outbound edge. It still RUNS (a node with no inbound edge is a root), but it receives nothing from the graph and reaches nobody in it, so it is either unwired or left behind by a deletion. Only a note, an annotation or a lane may float.`
+      });
+    }
+  }
+  const byId = new Map(nodes.map((n) => [n.id, n]));
+  for (const edge of edges) {
+    const source = byId.get(edge.source);
+    if (!source || !isTerminator(source)) continue;
+    issues.push({
+      level: "error",
+      edgeId: edge.id,
+      message: `Edge "${edge.id}" reads from "${edge.source}", which is a TERMINAL node and publishes no output ports at all. Nothing can ever travel this edge: it does not fail at run time, it delivers nothing, and "${edge.target}" runs anyway with an empty input.`
+    });
+  }
+  return issues;
+}
+function mayFloat(node) {
+  const type = node.type;
+  if (!type) return false;
+  if (type === "note") return true;
+  const kind = getNodeKind(type);
+  if (!kind) return true;
+  return kindIds(kind).includes("note") || kind.category === "annotation" || kind.category === "layout";
+}
+function isTerminator(node) {
+  const own = node.data?.outputs;
+  if (Array.isArray(own)) return own.length === 0;
+  const kind = node.type ? getNodeKind(node.type) : null;
+  if (!kind) return false;
+  return Array.isArray(kind.outputs) && kind.outputs.length === 0;
+}
+
 // src/schema/workflow-schema.ts
 var WORKFLOW_SCHEMA_VERSION = 1;
 var WORKFLOW_SCHEMA_URL = "https://particle.academy/schemas/workflow/v1.json";
@@ -14537,6 +14586,7 @@ function importWorkflow(schema, options = {}) {
       label: e.label
     };
   }).filter((e) => e !== null);
+  issues.push(...checkGraphConnectivity({ nodes, edges }));
   const ok = issues.every((i) => i.level !== "error");
   const declaredInputs = Array.isArray(s.inputs) ? s.inputs.filter(
     (input) => input !== null && typeof input === "object" && typeof input.name === "string"