@particle-academy/fancy-flow 0.3.1 → 0.4.1

package/dist/{chunk-OZPQAUZD.js → engine.cjs}

@@ -1,5 +1,4 @@
-import { applyNodeChanges, applyEdgeChanges, addEdge } from './chunk-GJSFZR6J.js';
-import { useState, useRef, useCallback } from 'react';
+'use strict';
 
 // src/runtime/run-flow.ts
 async function runFlow(graph, executors, onEvent = () => {
@@ -135,113 +134,7 @@ function activatedPorts(node, result) {
   const declared = node.data.outputs?.map((p) => p.id) ?? ["out"];
   return { ports: declared, value: result };
 }
-function useFlowRun({ maxFeed = 200 } = {}) {
-  const [statuses, setStatuses] = useState({});
-  const [statusText, setStatusText] = useState({});
-  const [feed, setFeed] = useState([]);
-  const [running, setRunning] = useState(false);
-  const [lastResult, setLastResult] = useState(null);
-  const abortRef = useRef(null);
-  const handleEvent = useCallback(
-    (e) => {
-      switch (e.type) {
-        case "node-status":
-          setStatuses((s) => ({ ...s, [e.nodeId]: e.status }));
-          setStatusText((t) => ({ ...t, [e.nodeId]: e.text }));
-          appendFeed({ level: "status", text: `${e.nodeId} \u2192 ${e.status}${e.text ? ` (${e.text})` : ""}`, nodeId: e.nodeId });
-          break;
-        case "node-output":
-          appendFeed({ level: "info", text: `${e.nodeId}.${e.portId} = ${preview(e.value)}`, nodeId: e.nodeId, detail: e.value });
-          break;
-        case "log":
-          appendFeed({ level: e.level, text: e.message, nodeId: e.nodeId, detail: e.detail });
-          break;
-        case "run-start":
-          appendFeed({ level: "info", text: "\u25B6 run started" });
-          break;
-        case "run-end":
-          appendFeed({ level: e.ok ? "info" : "error", text: e.ok ? "\u2713 run complete" : "\u2717 run failed" });
-          break;
-        case "run-error":
-          appendFeed({ level: "error", text: e.error });
-          break;
-      }
-      function appendFeed(partial) {
-        setFeed((f) => {
-          const entry = { id: `${Date.now()}_${f.length}`, at: Date.now(), ...partial };
-          const next = [...f, entry];
-          return next.length > maxFeed ? next.slice(next.length - maxFeed) : next;
-        });
-      }
-    },
-    [maxFeed]
-  );
-  const run = useCallback(
-    async (graph, executors, options = {}) => {
-      if (running) {
-        return { ok: false, outputs: {}, error: "another run is already in progress" };
-      }
-      const controller = new AbortController();
-      abortRef.current = controller;
-      const idleStatuses = {};
-      for (const n of graph.nodes) idleStatuses[n.id] = "idle";
-      setStatuses(idleStatuses);
-      setStatusText({});
-      setRunning(true);
-      try {
-        const result = await runFlow(graph, executors, handleEvent, { ...options, signal: controller.signal });
-        setLastResult(result);
-        return result;
-      } finally {
-        setRunning(false);
-        abortRef.current = null;
-      }
-    },
-    [handleEvent, running]
-  );
-  const cancel = useCallback(() => abortRef.current?.abort(), []);
-  const reset = useCallback(() => {
-    setStatuses({});
-    setStatusText({});
-    setFeed([]);
-    setLastResult(null);
-  }, []);
-  return { statuses, statusText, feed, running, lastResult, run, cancel, reset };
-}
-function applyStatusesToNodes(nodes, statuses, statusText) {
-  return nodes.map((n) => ({
-    ...n,
-    data: {
-      ...n.data,
-      status: statuses[n.id] ?? n.data?.status ?? "idle",
-      statusText: statusText[n.id] ?? n.data?.statusText
-    }
-  }));
-}
-function preview(v) {
-  try {
-    const s = JSON.stringify(v);
-    return s && s.length > 60 ? s.slice(0, 57) + "\u2026" : s ?? String(v);
-  } catch {
-    return String(v);
-  }
-}
-function useFlowState(initial) {
-  const [nodes, setNodes] = useState(initial.nodes);
-  const [edges, setEdges] = useState(initial.edges);
-  const onNodesChange = useCallback((changes) => {
-    setNodes((ns) => applyNodeChanges(changes, ns));
-  }, []);
-  const onEdgesChange = useCallback((changes) => {
-    setEdges((es) => applyEdgeChanges(changes, es));
-  }, []);
-  const onConnect = useCallback((connection) => {
-    setEdges((es) => addEdge(connection, es));
-  }, []);
-  const toGraph = useCallback(() => ({ nodes, edges }), [nodes, edges]);
-  return { nodes, edges, setNodes, setEdges, onNodesChange, onEdgesChange, onConnect, toGraph };
-}
 
-export { applyStatusesToNodes, runFlow, useFlowRun, useFlowState };
-//# sourceMappingURL=chunk-OZPQAUZD.js.map
-//# sourceMappingURL=chunk-OZPQAUZD.js.map
+exports.runFlow = runFlow;
+//# sourceMappingURL=engine.cjs.map
+//# sourceMappingURL=engine.cjs.map

package/dist/engine.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/run-flow.ts"],"names":[],"mappings":"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","file":"engine.cjs","sourcesContent":["import type {\n  ExecutorRegistry,\n  FlowEdge,\n  FlowGraph,\n  FlowNode,\n  NodeExecutor,\n  RunEvent,\n} from \"../types\";\n\nexport type RunOptions = {\n  /** Stop the run after this many ms. Default: no timeout. */\n  timeoutMs?: number;\n  /** Abort signal — host can cancel the run. */\n  signal?: AbortSignal;\n  /** Initial inputs supplied to entry-point nodes (no incoming edges). */\n  initialInputs?: Record<string, Record<string, unknown>>;\n};\n\nexport type RunResult = {\n  ok: boolean;\n  /** Outputs collected per node, keyed by node id. */\n  outputs: Record<string, unknown>;\n  /** Error captured if any node threw. */\n  error?: string;\n};\n\n/**\n * runFlow — topological execution of a FlowGraph against an ExecutorRegistry.\n *\n * Each node runs once, when all upstream nodes have produced outputs on the\n * connected ports. Decision nodes (or any executor that returns `{ branch:\n * 'true' }`) can short-circuit specific output ports — only edges leaving\n * an \"active\" port propagate to downstream nodes.\n *\n * Cycles are detected and abort the run with an error.\n *\n * The `onEvent` callback receives a stream of `RunEvent`s — wire it to a\n * status feed, log panel, or store.\n */\nexport async function runFlow(\n  graph: FlowGraph,\n  executors: ExecutorRegistry,\n  onEvent: (event: RunEvent) => void = () => {},\n  options: RunOptions = {},\n): Promise<RunResult> {\n  const { signal, initialInputs = {}, timeoutMs } = options;\n  const outputs: Record<string, unknown> = {};\n  const portValues = new Map<string, unknown>(); // key: `${nodeId}:${portId}`\n  const completed = new Set<string>();\n  const errors: string[] = [];\n\n  // Topological order via Kahn's algorithm. We allow nodes to run as soon\n  // as their incoming edges' source ports have produced values, so the\n  // order here is just a deterministic baseline used for cycle detection.\n  const order = topoSort(graph);\n  if (order === null) {\n    const msg = \"Cycle detected in flow graph — aborting.\";\n    onEvent({ type: \"run-error\", error: msg });\n    return { ok: false, outputs, error: msg };\n  }\n\n  const incomingByNode = indexIncoming(graph.edges);\n  const timer = timeoutMs ? setTimeout(() => errors.push(`Run timed out after ${timeoutMs}ms`), timeoutMs) : null;\n\n  onEvent({ type: \"run-start\" });\n\n  try {\n    for (const node of order) {\n      if (signal?.aborted) throw new Error(\"aborted\");\n      if (errors.length) break;\n\n      const incoming = incomingByNode.get(node.id) ?? [];\n\n      // Skip nodes whose upstream wasn't activated (e.g. a Decision routed\n      // to a different branch).\n      if (incoming.length > 0) {\n        const allActive = incoming.every((e) => portValues.has(`${e.source}:${e.sourceHandle ?? \"out\"}`));\n        if (!allActive) {\n          onEvent({ type: \"node-status\", nodeId: node.id, status: \"idle\", text: \"skipped\" });\n          continue;\n        }\n      }\n\n      // Note nodes are annotations — never executed.\n      if (node.type === \"note\") {\n        onEvent({ type: \"node-status\", nodeId: node.id, status: \"idle\", text: \"annotation\" });\n        continue;\n      }\n\n      onEvent({ type: \"node-status\", nodeId: node.id, status: \"running\" });\n\n      const inputs = collectInputs(node, incoming, portValues, initialInputs);\n      const exec = pickExecutor(executors, node);\n      if (!exec) {\n        const msg = `No executor registered for kind=${node.type}`;\n        errors.push(msg);\n        onEvent({ type: \"node-status\", nodeId: node.id, status: \"error\", text: msg });\n        onEvent({ type: \"log\", nodeId: node.id, level: \"error\", message: msg });\n        break;\n      }\n\n      try {\n        const result = await Promise.resolve(\n          exec({\n            node,\n            inputs,\n            abort: (reason) => { throw new Error(reason ?? \"aborted\"); },\n            emit: onEvent,\n          }),\n        );\n        outputs[node.id] = result;\n\n        // Decide which output ports were activated. Three conventions:\n        //  1) If result is `{ __port: \"out\", value: x }`, only that port emits.\n        //  2) If result has `branch: <portId>`, only that port emits (decision sugar).\n        //  3) Otherwise, the value is published on every declared output port.\n        const activated = activatedPorts(node, result);\n        for (const portId of activated.ports) {\n          portValues.set(`${node.id}:${portId}`, activated.value);\n          onEvent({ type: \"node-output\", nodeId: node.id, portId, value: activated.value });\n        }\n        completed.add(node.id);\n        onEvent({ type: \"node-status\", nodeId: node.id, status: \"done\" });\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        errors.push(msg);\n        onEvent({ type: \"node-status\", nodeId: node.id, status: \"error\", text: msg });\n        onEvent({ type: \"log\", nodeId: node.id, level: \"error\", message: msg });\n        break;\n      }\n    }\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n\n  const ok = errors.length === 0;\n  onEvent({ type: \"run-end\", ok });\n  return ok ? { ok, outputs } : { ok, outputs, error: errors[0] };\n}\n\nfunction indexIncoming(edges: FlowEdge[]): Map<string, FlowEdge[]> {\n  const map = new Map<string, FlowEdge[]>();\n  for (const e of edges) {\n    const list = map.get(e.target) ?? [];\n    list.push(e);\n    map.set(e.target, list);\n  }\n  return map;\n}\n\nfunction topoSort(graph: FlowGraph): FlowNode[] | null {\n  const inDegree = new Map<string, number>();\n  for (const n of graph.nodes) inDegree.set(n.id, 0);\n  for (const e of graph.edges) inDegree.set(e.target, (inDegree.get(e.target) ?? 0) + 1);\n  const queue: string[] = [];\n  for (const [id, d] of inDegree) if (d === 0) queue.push(id);\n  const ordered: string[] = [];\n  while (queue.length) {\n    const id = queue.shift()!;\n    ordered.push(id);\n    for (const e of graph.edges) {\n      if (e.source !== id) continue;\n      const next = (inDegree.get(e.target) ?? 0) - 1;\n      inDegree.set(e.target, next);\n      if (next === 0) queue.push(e.target);\n    }\n  }\n  if (ordered.length !== graph.nodes.length) return null;\n  const byId = new Map(graph.nodes.map((n) => [n.id, n]));\n  return ordered.map((id) => byId.get(id)!).filter(Boolean);\n}\n\nfunction collectInputs(\n  node: FlowNode,\n  incoming: FlowEdge[],\n  portValues: Map<string, unknown>,\n  initial: Record<string, Record<string, unknown>>,\n): Record<string, unknown> {\n  const inputs: Record<string, unknown> = { ...(initial[node.id] ?? {}) };\n  for (const e of incoming) {\n    const portId = e.targetHandle ?? \"in\";\n    const val = portValues.get(`${e.source}:${e.sourceHandle ?? \"out\"}`);\n    inputs[portId] = val;\n  }\n  return inputs;\n}\n\nfunction pickExecutor(\n  executors: ExecutorRegistry,\n  node: FlowNode,\n): NodeExecutor | undefined {\n  if (executors[node.id]) return executors[node.id];\n  if (node.type && executors[node.type]) return executors[node.type];\n  return executors[\"*\"];\n}\n\nfunction activatedPorts(node: FlowNode, result: unknown): { ports: string[]; value: unknown } {\n  if (result && typeof result === \"object\") {\n    const r = result as Record<string, unknown>;\n    if (typeof r.__port === \"string\") {\n      return { ports: [r.__port], value: r.value };\n    }\n    if (typeof r.branch === \"string\") {\n      return { ports: [r.branch], value: r.value ?? r };\n    }\n  }\n  const declared = node.data.outputs?.map((p) => p.id) ?? [\"out\"];\n  return { ports: declared, value: result };\n}\n"]}

package/dist/engine.d.cts

@@ -0,0 +1,35 @@
+import { a as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-TemTtb04.cjs';
+export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, b as FlowEdge, F as FlowNode, c as FlowNodeData, d as FlowNodeKind, N as NodeExecutor, e as NodeRunStatus, f as NoteNodeData, O as OutputNodeData, P as PortDescriptor, S as SubgraphNodeData, T as TriggerNodeData } from './types-TemTtb04.cjs';
+import '@xyflow/react';
+
+type RunOptions = {
+    /** Stop the run after this many ms. Default: no timeout. */
+    timeoutMs?: number;
+    /** Abort signal — host can cancel the run. */
+    signal?: AbortSignal;
+    /** Initial inputs supplied to entry-point nodes (no incoming edges). */
+    initialInputs?: Record<string, Record<string, unknown>>;
+};
+type RunResult = {
+    ok: boolean;
+    /** Outputs collected per node, keyed by node id. */
+    outputs: Record<string, unknown>;
+    /** Error captured if any node threw. */
+    error?: string;
+};
+/**
+ * runFlow — topological execution of a FlowGraph against an ExecutorRegistry.
+ *
+ * Each node runs once, when all upstream nodes have produced outputs on the
+ * connected ports. Decision nodes (or any executor that returns `{ branch:
+ * 'true' }`) can short-circuit specific output ports — only edges leaving
+ * an "active" port propagate to downstream nodes.
+ *
+ * Cycles are detected and abort the run with an error.
+ *
+ * The `onEvent` callback receives a stream of `RunEvent`s — wire it to a
+ * status feed, log panel, or store.
+ */
+declare function runFlow(graph: FlowGraph, executors: ExecutorRegistry, onEvent?: (event: RunEvent) => void, options?: RunOptions): Promise<RunResult>;
+
+export { ExecutorRegistry, FlowGraph, RunEvent, type RunOptions, type RunResult, runFlow };

package/dist/engine.d.ts

@@ -0,0 +1,35 @@
+import { a as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-TemTtb04.js';
+export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, b as FlowEdge, F as FlowNode, c as FlowNodeData, d as FlowNodeKind, N as NodeExecutor, e as NodeRunStatus, f as NoteNodeData, O as OutputNodeData, P as PortDescriptor, S as SubgraphNodeData, T as TriggerNodeData } from './types-TemTtb04.js';
+import '@xyflow/react';
+
+type RunOptions = {
+    /** Stop the run after this many ms. Default: no timeout. */
+    timeoutMs?: number;
+    /** Abort signal — host can cancel the run. */
+    signal?: AbortSignal;
+    /** Initial inputs supplied to entry-point nodes (no incoming edges). */
+    initialInputs?: Record<string, Record<string, unknown>>;
+};
+type RunResult = {
+    ok: boolean;
+    /** Outputs collected per node, keyed by node id. */
+    outputs: Record<string, unknown>;
+    /** Error captured if any node threw. */
+    error?: string;
+};
+/**
+ * runFlow — topological execution of a FlowGraph against an ExecutorRegistry.
+ *
+ * Each node runs once, when all upstream nodes have produced outputs on the
+ * connected ports. Decision nodes (or any executor that returns `{ branch:
+ * 'true' }`) can short-circuit specific output ports — only edges leaving
+ * an "active" port propagate to downstream nodes.
+ *
+ * Cycles are detected and abort the run with an error.
+ *
+ * The `onEvent` callback receives a stream of `RunEvent`s — wire it to a
+ * status feed, log panel, or store.
+ */
+declare function runFlow(graph: FlowGraph, executors: ExecutorRegistry, onEvent?: (event: RunEvent) => void, options?: RunOptions): Promise<RunResult>;
+
+export { ExecutorRegistry, FlowGraph, RunEvent, type RunOptions, type RunResult, runFlow };

package/dist/engine.js

@@ -0,0 +1,3 @@
+export { runFlow } from './chunk-DW66NGU5.js';
+//# sourceMappingURL=engine.js.map
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"engine.js"}