@particle-academy/fancy-flow 0.50.0 → 0.51.1

package/dist/{ConfigFieldRenderer-CrXFq6Eb.d.cts → ConfigFieldRenderer-Bc9Txnql.d.cts}

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { F as FlowGraph } from './types-7cXcSQlx.cjs';
-import { C as ConfigField } from './types-BtMOnb9I.cjs';
+import { F as FlowGraph } from './types-JFYjPJAG.cjs';
+import { C as ConfigField } from './types-3sPauVRT.cjs';
 
 /** What a host renderer is handed. */
 type ConfigFieldRenderContext = {

package/dist/{ConfigFieldRenderer-u3nYHovX.d.ts → ConfigFieldRenderer-Bt3RGT7Z.d.ts}

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { F as FlowGraph } from './types-7cXcSQlx.js';
-import { C as ConfigField } from './types-CDgIIj4c.js';
+import { F as FlowGraph } from './types-JFYjPJAG.js';
+import { C as ConfigField } from './types-s643U1Hi.js';
 
 /** What a host renderer is handed. */
 type ConfigFieldRenderContext = {

package/dist/{FlowViewer-DRgjeWJ7.d.ts → FlowViewer-BI_AyyvU.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { CSSProperties, ReactNode } from 'react';
-import { F as FlowGraph, a as FlowNode } from './types-7cXcSQlx.js';
+import { F as FlowGraph, a as FlowNode } from './types-JFYjPJAG.js';
 
 /** Outcome of one node in a run, for annotating the graph after the fact. */
 type FlowNodeStatus = "ok" | "running" | "failed" | "skipped" | "pending";

package/dist/{FlowViewer-CFSMlCqi.d.cts → FlowViewer-DABx-6A-.d.cts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { CSSProperties, ReactNode } from 'react';
-import { F as FlowGraph, a as FlowNode } from './types-7cXcSQlx.cjs';
+import { F as FlowGraph, a as FlowNode } from './types-JFYjPJAG.cjs';
 
 /** Outcome of one node in a run, for annotating the graph after the fact. */
 type FlowNodeStatus = "ok" | "running" | "failed" | "skipped" | "pending";

package/dist/{capabilities-VzgDApur.d.cts → capabilities-BYa5p5jw.d.cts}

@@ -1,4 +1,4 @@
-import { F as FlowGraph } from './types-7cXcSQlx.cjs';
+import { F as FlowGraph } from './types-JFYjPJAG.cjs';
 
 /**
  * Host capabilities — the services core nodes need but must never depend on.

package/dist/{capabilities-B00VXLUp.d.ts → capabilities-COOXRiNL.d.ts}

@@ -1,4 +1,4 @@
-import { F as FlowGraph } from './types-7cXcSQlx.js';
+import { F as FlowGraph } from './types-JFYjPJAG.js';
 
 /**
  * Host capabilities — the services core nodes need but must never depend on.

package/dist/{chunk-XJMWMU4J.js → chunk-4GO2CHAY.js}

@@ -9301,6 +9301,61 @@ var RunIdentity = class _RunIdentity {
   }
 };
 
+// src/runtime/workflow-props.ts
+function typeOf(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "array";
+  return typeof value;
+}
+function resolveWorkflowProps(declared, passed) {
+  const inputs = declared ?? [];
+  const given = passed ?? {};
+  const byName = new Map(inputs.map((input) => [input.name, input]));
+  for (const name of Object.keys(given)) {
+    if (!byName.has(name)) {
+      const known = inputs.map((input) => input.name);
+      const suffix = known.length === 0 ? "this workflow declares no inputs" : `known inputs: ${known.join(", ")}`;
+      return {
+        ok: false,
+        code: "unknown_input",
+        error: `Unknown workflow input "${name}" \u2014 ${suffix}.`
+      };
+    }
+  }
+  const resolved = {};
+  for (const input of inputs) {
+    const supplied = Object.prototype.hasOwnProperty.call(given, input.name);
+    const hasDefault = Object.prototype.hasOwnProperty.call(input, "default");
+    if (!supplied) {
+      if (hasDefault) {
+        resolved[input.name] = input.default;
+        continue;
+      }
+      if (input.required) {
+        return {
+          ok: false,
+          code: "missing_required",
+          error: `Missing required workflow input "${input.name}"${input.type ? ` (${input.type})` : ""}.`
+        };
+      }
+      continue;
+    }
+    const value = given[input.name];
+    if (input.type !== void 0) {
+      const actual = typeOf(value);
+      if (actual !== input.type) {
+        return {
+          ok: false,
+          code: "type_mismatch",
+          error: `Workflow input "${input.name}" expects ${input.type}, got ${actual}.`
+        };
+      }
+    }
+    resolved[input.name] = value;
+  }
+  return { ok: true, props: resolved };
+}
+
 // src/runtime/run-flow.ts
 async function runFlow(graph, executors, onEvent = () => {
 }, options = {}) {
@@ -9316,6 +9371,13 @@ async function runFlow(graph, executors, onEvent = () => {
     onEvent({ type: "run-error", error: msg });
     return { ok: false, outputs, error: msg };
   }
+  const propsCheck = resolveWorkflowProps(graph.inputs, options.props);
+  if (!propsCheck.ok) {
+    onEvent({ type: "run-error", error: propsCheck.error });
+    return { ok: false, outputs, error: propsCheck.error };
+  }
+  const props = propsCheck.props;
+  const declaresProps = (graph.inputs?.length ?? 0) > 0;
   const incomingByNode = indexIncoming(graph.edges);
   const timer2 = timeoutMs ? setTimeout(() => errors.push(`Run timed out after ${timeoutMs}ms`), timeoutMs) : null;
   onEvent({ type: "run-start" });
@@ -9357,10 +9419,11 @@ async function runFlow(graph, executors, onEvent = () => {
       }
       onEvent({ type: "node-status", nodeId: node.id, status: "running" });
       announce(onEvent, node, "start");
-      const inputs = collectInputs(node, incoming, portValues, initialInputs);
+      const inputs = collectInputs(node, incoming, portValues, initialInputs, props, declaresProps);
       const exec = pickExecutor(executors, node);
       if (!exec) {
-        const msg = `No executor registered for kind=${node.type}`;
+        const tried = executorLookupIds(node);
+        const msg = `No executor registered for kind=${node.type} \u2014 tried ${tried.map((id2) => `"${id2}"`).join(", ")} and the wildcard "*". Key your registry by one of those.`;
         errors.push(msg);
         onEvent({ type: "node-status", nodeId: node.id, status: "error", text: msg });
         onEvent({ type: "log", nodeId: node.id, level: "error", message: msg });
@@ -9434,8 +9497,13 @@ function topoSort(graph) {
   const byId = new Map(graph.nodes.map((n) => [n.id, n]));
   return ordered.map((id2) => byId.get(id2)).filter(Boolean);
 }
-function collectInputs(node, incoming, portValues, initial) {
+function collectInputs(node, incoming, portValues, initial, props, declaresProps) {
   const inputs = { ...initial[node.id] ?? {} };
+  if (incoming.length === 0) {
+    for (const [name, value] of Object.entries(props)) {
+      if (!(name in inputs)) inputs[name] = value;
+    }
+  }
   for (const e of incoming) {
     const portId = e.targetHandle ?? "in";
     const key = `${e.source}:${e.sourceHandle ?? "out"}`;
@@ -9445,16 +9513,31 @@ function collectInputs(node, incoming, portValues, initial) {
       inputs[e.source] = portValues.get(key);
     }
   }
+  if (declaresProps) inputs.$props = props;
   return inputs;
 }
+function executorLookupIds(node) {
+  const ids = [node.id];
+  if (node.type) ids.push(node.type);
+  const declared = node.data?.kind;
+  const kindName = typeof declared === "string" && declared !== "" ? declared : node.type;
+  if (kindName && kindName !== node.type) ids.push(kindName);
+  for (const name of [kindName, node.type]) {
+    const kind = name ? getNodeKind(name) : null;
+    if (!kind) continue;
+    for (const id2 of kindIds(kind)) ids.push(id2);
+  }
+  return [...new Set(ids)];
+}
 function pickExecutor(executors, node) {
   if (executors[node.id]) return executors[node.id];
   if (node.type && executors[node.type]) return executors[node.type];
   const declared = node.data?.kind;
   const kindName = typeof declared === "string" && declared !== "" ? declared : node.type;
   if (kindName && kindName !== node.type && executors[kindName]) return executors[kindName];
-  const kind = kindName ? getNodeKind(kindName) : null;
-  if (kind) {
+  for (const name of [kindName, node.type]) {
+    const kind = name ? getNodeKind(name) : null;
+    if (!kind) continue;
     for (const id2 of kindIds(kind)) {
       if (executors[id2]) return executors[id2];
     }
@@ -10624,5 +10707,5 @@ function LaneNodeInner(props) {
 var LaneNode = memo(LaneNodeInner);
 
 export { BUILTIN_KINDS, Background, BackgroundVariant, Controls, DEFAULT_MAX_DEPTH, FlowEditorProvider, Handle, LaneNode, MiniMap, NodeResizer, NodeToolbar, NoteNode, Position, ReactFlowProvider, RunIdentity, ViewportPortal, addEdge2 as addEdge, applyEdgeChanges, applyNodeChanges, categoryAccent, clearNodeKindOverrides, declaredRoutes, defaultConfigFor, ensureBuiltinKinds, escapeSegment, getNodeKind, index, kindIds, listNodeKinds, llmRouterExecutor, nodeConfig, onNodeKindsChanged, overrideNodeKind, reconnectEdge2 as reconnectEdge, registerBuiltinKinds, registerNodeKind, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, runFlow, subflowExecutor, subflowMode, subflowPorts, useFlowEditor, useFlowEditorOptional, useReactFlow, validateConfig };
-//# sourceMappingURL=chunk-XJMWMU4J.js.map
-//# sourceMappingURL=chunk-XJMWMU4J.js.map
+//# sourceMappingURL=chunk-4GO2CHAY.js.map
+//# sourceMappingURL=chunk-4GO2CHAY.js.map