@particle-academy/fancy-flow 0.59.0 → 0.64.0

package/dist/runtime.js

@@ -1,6 +1,6 @@
-export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-LGLOBK6Q.js';
-export { runCohort } from './chunk-A3TLZS5B.js';
-export { RunIdentity, escapeSegment, runFlow } from './chunk-HBE4LVPX.js';
+export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-MBVX4ZRB.js';
+export { runCohort } from './chunk-RIAFHQT5.js';
+export { RunIdentity, escapeSegment, runFlow } from './chunk-JF6WCRBU.js';
 import './chunk-F5RPRB7A.js';
 import './chunk-USL4FMFU.js';
 //# sourceMappingURL=runtime.js.map

package/dist/schema.cjs

@@ -9531,7 +9531,7 @@ function activatedPorts(node, result) {
       return { ports: [r.__port], value: r.value };
     }
     if (typeof r.branch === "string") {
-      return { ports: [r.branch], value: r.value ?? r };
+      return { ports: [r.branch], value: Object.prototype.hasOwnProperty.call(r, "value") ? r.value : r };
     }
   }
   const kind = getNodeKind(node.data?.kind ?? node.type ?? "") ?? void 0;
@@ -9693,8 +9693,9 @@ var KINDS = [
   // ───────────── Triggers ─────────────
   {
     name: "@particle-academy/manual_trigger",
-    // returns the inputs it was started with
-    emits: "input",
+    // Returns the raw inputs MAP, not the `in` port -- flat at an entry
+    // point, port-keyed the moment the node has an inbound edge.
+    emits: "input-map-merged",
     aliases: ["manual_trigger", "@fancy/manual_trigger"],
     category: "trigger",
     label: "Manual",
@@ -9727,8 +9728,9 @@ var KINDS = [
       { path: "cron", type: "string", description: "The cron expression that fired." },
       { path: "timezone", type: "string", description: "The timezone it was evaluated in." }
     ],
-    // merges its inputs into the TOP level beside cron/timezone
-    emits: "inputs-merged",
+    // Merges $ctx->inputs ITSELF beside cron/timezone -- the MAP, whose
+    // shape depends on position, not each port's payload the way `merge` does.
+    emits: "input-map-merged",
     aliases: ["schedule_trigger", "@fancy/schedule_trigger"],
     category: "trigger",
     label: "Schedule",
@@ -10736,6 +10738,55 @@ function categoryAccent(category) {
   }
 }
 
+// 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";
@@ -10883,6 +10934,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"