@particle-academy/fancy-flow 0.23.0 → 0.25.0

package/dist/registry.js

@@ -1,10 +1,10 @@
-export { ANY_PORT_TYPE, BUILTIN_KINDS, DEFAULT_MAX_DEPTH, RegistryNode, buildNodeTypes, createConnectionValidator, declaredRoutes, defaultPortCompatibility, llmRouterExecutor as llmBranchExecutor, llmRouterExecutor, registerBuiltinKinds, resolveFallbackPort, subflowExecutor, subflowMode, subflowPorts } from './chunk-AUL4LU63.js';
-import './chunk-ZB4HHQMR.js';
+export { ANY_PORT_TYPE, BUILTIN_KINDS, DEFAULT_MAX_DEPTH, RegistryNode, buildNodeTypes, createConnectionValidator, declaredRoutes, defaultPortCompatibility, llmRouterExecutor as llmBranchExecutor, llmRouterExecutor, registerBuiltinKinds, resolveFallbackPort, subflowExecutor, subflowMode, subflowPorts } from './chunk-ATQXZEVD.js';
+import './chunk-OWENS2H5.js';
 export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman } from './chunk-UEOE6B52.js';
 export { capabilityStatus, getLlmClient, getWorkflowResolver, isResolutionFailure, registerLlmClient, registerWorkflowResolver } from './chunk-USL4FMFU.js';
-import './chunk-KDHLKBL2.js';
+import './chunk-U2VJB7HR.js';
 export { nodeConfig, resolveNodePorts, resolvePortSpec } from './chunk-TITD5W4Y.js';
-export { categoryAccent, defaultConfigFor, getNodeKind, kindIds, listNodeKinds, onNodeKindsChanged, registerNodeKind, resolveKindId, validateConfig } from './chunk-YXRLIV7A.js';
+export { categoryAccent, defaultConfigFor, getNodeKind, kindIds, listNodeKinds, onNodeKindsChanged, registerNodeKind, resolveKindId, validateConfig } from './chunk-Q6IPK64P.js';
 export { RichInputPreview, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerRichInputAdapter } from './chunk-F5RPRB7A.js';
 //# sourceMappingURL=registry.js.map
 //# sourceMappingURL=registry.js.map

package/dist/runtime/index.d.cts

@@ -16,6 +16,8 @@ type UseFlowRunReturn = {
     statuses: Record<string, NodeRunStatus>;
     /** Per-node status text (e.g. error message). */
     statusText: Record<string, string | undefined>;
+    /** Latest computed output value per node (for reactive kinds). */
+    outputs: Record<string, unknown>;
     /** Live event log (capped to last N). */
     feed: FlowRunFeedEntry[];
     /** Whether a run is currently in progress. */
@@ -39,6 +41,16 @@ type UseFlowRunOptions = {
  * the per-node status badge renders.
  */
 declare function useFlowRun({ maxFeed }?: UseFlowRunOptions): UseFlowRunReturn;
+/**
+ * Write each reactive kind's latest run output into its `data.output`, so its
+ * card can render the computed value live. Non-reactive kinds are returned
+ * untouched. Pair with `applyStatusesToNodes` before rendering.
+ */
+declare function applyOutputsToNodes<TNode extends {
+    id: string;
+    type?: string;
+    data: any;
+}>(nodes: TNode[], outputs: Record<string, unknown>): TNode[];
 /** Merge runtime statuses into nodes for rendering. */
 declare function applyStatusesToNodes<TNode extends {
     id: string;
@@ -122,4 +134,4 @@ type HistoryController = {
 };
 declare function createHistory(limit?: number): HistoryController;
 
-export { type FlowRunFeedEntry, type HistoryController, RunOptions, RunResult, type UseFlowHistoryReturn, type UseFlowRunOptions, type UseFlowRunReturn, type UseFlowStateReturn, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState };
+export { type FlowRunFeedEntry, type HistoryController, RunOptions, RunResult, type UseFlowHistoryReturn, type UseFlowRunOptions, type UseFlowRunReturn, type UseFlowStateReturn, applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState };

package/dist/runtime/index.d.ts

@@ -16,6 +16,8 @@ type UseFlowRunReturn = {
     statuses: Record<string, NodeRunStatus>;
     /** Per-node status text (e.g. error message). */
     statusText: Record<string, string | undefined>;
+    /** Latest computed output value per node (for reactive kinds). */
+    outputs: Record<string, unknown>;
     /** Live event log (capped to last N). */
     feed: FlowRunFeedEntry[];
     /** Whether a run is currently in progress. */
@@ -39,6 +41,16 @@ type UseFlowRunOptions = {
  * the per-node status badge renders.
  */
 declare function useFlowRun({ maxFeed }?: UseFlowRunOptions): UseFlowRunReturn;
+/**
+ * Write each reactive kind's latest run output into its `data.output`, so its
+ * card can render the computed value live. Non-reactive kinds are returned
+ * untouched. Pair with `applyStatusesToNodes` before rendering.
+ */
+declare function applyOutputsToNodes<TNode extends {
+    id: string;
+    type?: string;
+    data: any;
+}>(nodes: TNode[], outputs: Record<string, unknown>): TNode[];
 /** Merge runtime statuses into nodes for rendering. */
 declare function applyStatusesToNodes<TNode extends {
     id: string;
@@ -122,4 +134,4 @@ type HistoryController = {
 };
 declare function createHistory(limit?: number): HistoryController;
 
-export { type FlowRunFeedEntry, type HistoryController, RunOptions, RunResult, type UseFlowHistoryReturn, type UseFlowRunOptions, type UseFlowRunReturn, type UseFlowStateReturn, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState };
+export { type FlowRunFeedEntry, type HistoryController, RunOptions, RunResult, type UseFlowHistoryReturn, type UseFlowRunOptions, type UseFlowRunReturn, type UseFlowStateReturn, applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState };

package/dist/runtime.cjs

@@ -77,12 +77,14 @@ async function runFlow(graph, executors, onEvent = () => {
         }
       }
       const visualKind = getNodeKind(node.type ?? "");
-      if (node.type === "note" || visualKind?.category === "layout") {
+      const isLayout = visualKind?.category === "layout";
+      const isAnnotation = node.type === "note" || visualKind?.category === "annotation";
+      if (isLayout || isAnnotation) {
         onEvent({
           type: "node-status",
           nodeId: node.id,
           status: "idle",
-          text: visualKind?.category === "layout" ? "lane" : "annotation"
+          text: isLayout ? "lane" : "annotation"
         });
         continue;
       }
@@ -198,6 +200,7 @@ function activatedPorts(node, result) {
 function useFlowRun({ maxFeed = 200 } = {}) {
   const [statuses, setStatuses] = ReactExports.useState({});
   const [statusText, setStatusText] = ReactExports.useState({});
+  const [outputs, setOutputs] = ReactExports.useState({});
   const [feed, setFeed] = ReactExports.useState([]);
   const [running, setRunning] = ReactExports.useState(false);
   const [lastResult, setLastResult] = ReactExports.useState(null);
@@ -211,6 +214,7 @@ function useFlowRun({ maxFeed = 200 } = {}) {
           appendFeed({ level: "status", text: `${e.nodeId} \u2192 ${e.status}${e.text ? ` (${e.text})` : ""}`, nodeId: e.nodeId });
           break;
         case "node-output":
+          setOutputs((o) => ({ ...o, [e.nodeId]: e.value }));
           appendFeed({ level: "info", text: `${e.nodeId}.${e.portId} = ${preview(e.value)}`, nodeId: e.nodeId, detail: e.value });
           break;
         case "log":
@@ -247,6 +251,7 @@ function useFlowRun({ maxFeed = 200 } = {}) {
       for (const n of graph.nodes) idleStatuses[n.id] = "idle";
       setStatuses(idleStatuses);
       setStatusText({});
+      setOutputs({});
       setRunning(true);
       try {
         const result = await runFlow(graph, executors, handleEvent, { ...options, signal: controller.signal });
@@ -263,10 +268,18 @@ function useFlowRun({ maxFeed = 200 } = {}) {
   const reset = ReactExports.useCallback(() => {
     setStatuses({});
     setStatusText({});
+    setOutputs({});
     setFeed([]);
     setLastResult(null);
   }, []);
-  return { statuses, statusText, feed, running, lastResult, run, cancel, reset };
+  return { statuses, statusText, outputs, feed, running, lastResult, run, cancel, reset };
+}
+function applyOutputsToNodes(nodes, outputs) {
+  return nodes.map((n) => {
+    const kind = getNodeKind(n.data?.kind ?? n.type ?? "");
+    if (!kind?.reactive || !(n.id in outputs)) return n;
+    return { ...n, data: { ...n.data, output: outputs[n.id] } };
+  });
 }
 function applyStatusesToNodes(nodes, statuses, statusText) {
   return nodes.map((n) => ({
@@ -9313,6 +9326,7 @@ function useFlowHistory(flow) {
   };
 }
 
+exports.applyOutputsToNodes = applyOutputsToNodes;
 exports.applyStatusesToNodes = applyStatusesToNodes;
 exports.createHistory = createHistory;
 exports.runFlow = runFlow;