@particle-academy/fancy-flow 0.71.0 → 0.72.1

package/dist/{chunk-EVGSL2EM.js → chunk-EX34GCKK.js}

@@ -71,101 +71,6 @@ function resolveNodePorts(node, kind) {
   };
 }
 
-// src/components/FlowEditor/human-fields.ts
-var HUMAN_FIELD_TYPE_ALIASES = {
-  text: "text",
-  string: "text",
-  str: "text",
-  input: "text",
-  textarea: "textarea",
-  long_text: "textarea",
-  longtext: "textarea",
-  "long-text": "textarea",
-  multiline: "textarea",
-  paragraph: "textarea",
-  markdown: "textarea",
-  number: "number",
-  numeric: "number",
-  integer: "number",
-  int: "number",
-  float: "number",
-  decimal: "number",
-  select: "select",
-  enum: "select",
-  choice: "select",
-  choices: "select",
-  dropdown: "select",
-  options: "select",
-  radio: "select",
-  switch: "switch",
-  bool: "switch",
-  boolean: "switch",
-  checkbox: "switch",
-  toggle: "switch",
-  date: "date",
-  datetime: "datetime",
-  "datetime-local": "datetime",
-  datetimelocal: "datetime",
-  timestamp: "datetime",
-  time: "time",
-  email: "email",
-  "e-mail": "email",
-  url: "url",
-  uri: "url",
-  link: "url",
-  tel: "tel",
-  phone: "tel",
-  telephone: "tel",
-  password: "password",
-  secret: "password"
-};
-function humanFieldType(raw) {
-  if (typeof raw !== "string") return "text";
-  return HUMAN_FIELD_TYPE_ALIASES[raw.trim().toLowerCase()] ?? "text";
-}
-function humanFieldOptions(raw) {
-  const entries = [];
-  if (Array.isArray(raw)) {
-    for (const item of raw) {
-      if (typeof item === "string" || typeof item === "number") {
-        const value = String(item);
-        if (value !== "") entries.push({ value, label: value });
-        continue;
-      }
-      if (item && typeof item === "object") {
-        const value = item.value;
-        if (value === void 0 || value === null || value === "") continue;
-        const label = item.label;
-        entries.push({
-          value: String(value),
-          label: typeof label === "string" && label !== "" ? label : String(value)
-        });
-      }
-    }
-  } else if (raw && typeof raw === "object") {
-    for (const [value, label] of Object.entries(raw)) {
-      if (value === "") continue;
-      entries.push({ value, label: typeof label === "string" && label !== "" ? label : value });
-    }
-  }
-  return entries.length ? entries : void 0;
-}
-function humanInputFields(config) {
-  const raw = Array.isArray(config?.fields) ? config.fields : [];
-  const fields = raw.filter((f) => f && typeof f === "object" && typeof f.key === "string" && f.key).map((f) => ({
-    key: f.key,
-    label: typeof f.label === "string" && f.label ? f.label : f.key,
-    type: humanFieldType(f.type),
-    required: !!f.required,
-    placeholder: typeof f.placeholder === "string" ? f.placeholder : void 0,
-    options: humanFieldOptions(f.options ?? f.choices),
-    default: f.default
-  }));
-  if (fields.length) return fields;
-  const title = typeof config?.title === "string" && config.title ? config.title : "Your answer";
-  return [{ key: "value", label: title, type: "textarea", required: true }];
-}
-
 // src/runtime/run-identity.ts
 function escapeSegment(value) {
   return value.replace(/%/g, "%25").replace(/\//g, "%2F").replace(/#/g, "%23");
@@ -276,6 +181,101 @@ var RunIdentity = class _RunIdentity {
   }
 };
 
+// src/components/FlowEditor/human-fields.ts
+var HUMAN_FIELD_TYPE_ALIASES = {
+  text: "text",
+  string: "text",
+  str: "text",
+  input: "text",
+  textarea: "textarea",
+  long_text: "textarea",
+  longtext: "textarea",
+  "long-text": "textarea",
+  multiline: "textarea",
+  paragraph: "textarea",
+  markdown: "textarea",
+  number: "number",
+  numeric: "number",
+  integer: "number",
+  int: "number",
+  float: "number",
+  decimal: "number",
+  select: "select",
+  enum: "select",
+  choice: "select",
+  choices: "select",
+  dropdown: "select",
+  options: "select",
+  radio: "select",
+  switch: "switch",
+  bool: "switch",
+  boolean: "switch",
+  checkbox: "switch",
+  toggle: "switch",
+  date: "date",
+  datetime: "datetime",
+  "datetime-local": "datetime",
+  datetimelocal: "datetime",
+  timestamp: "datetime",
+  time: "time",
+  email: "email",
+  "e-mail": "email",
+  url: "url",
+  uri: "url",
+  link: "url",
+  tel: "tel",
+  phone: "tel",
+  telephone: "tel",
+  password: "password",
+  secret: "password"
+};
+function humanFieldType(raw) {
+  if (typeof raw !== "string") return "text";
+  return HUMAN_FIELD_TYPE_ALIASES[raw.trim().toLowerCase()] ?? "text";
+}
+function humanFieldOptions(raw) {
+  const entries = [];
+  if (Array.isArray(raw)) {
+    for (const item of raw) {
+      if (typeof item === "string" || typeof item === "number") {
+        const value = String(item);
+        if (value !== "") entries.push({ value, label: value });
+        continue;
+      }
+      if (item && typeof item === "object") {
+        const value = item.value;
+        if (value === void 0 || value === null || value === "") continue;
+        const label = item.label;
+        entries.push({
+          value: String(value),
+          label: typeof label === "string" && label !== "" ? label : String(value)
+        });
+      }
+    }
+  } else if (raw && typeof raw === "object") {
+    for (const [value, label] of Object.entries(raw)) {
+      if (value === "") continue;
+      entries.push({ value, label: typeof label === "string" && label !== "" ? label : value });
+    }
+  }
+  return entries.length ? entries : void 0;
+}
+function humanInputFields(config) {
+  const raw = Array.isArray(config?.fields) ? config.fields : [];
+  const fields = raw.filter((f) => f && typeof f === "object" && typeof f.key === "string" && f.key).map((f) => ({
+    key: f.key,
+    label: typeof f.label === "string" && f.label ? f.label : f.key,
+    type: humanFieldType(f.type),
+    required: !!f.required,
+    placeholder: typeof f.placeholder === "string" ? f.placeholder : void 0,
+    options: humanFieldOptions(f.options ?? f.choices),
+    default: f.default
+  }));
+  if (fields.length) return fields;
+  const title = typeof config?.title === "string" && config.title ? config.title : "Your answer";
+  return [{ key: "value", label: title, type: "textarea", required: true }];
+}
+
 // src/runtime/terminal-transcript.ts
 var ESC = String.fromCharCode(27);
 var CSI = String.fromCharCode(155);
@@ -519,6 +519,63 @@ function specForLane(lane) {
   };
 }
 
+// src/runtime/undelivered-edges.ts
+function undeliveredEdgeWarnings(target, incoming, portValues, completed, nodesById) {
+  const events = [];
+  for (const e of incoming) {
+    const handle = e.sourceHandle ?? "out";
+    if (portValues.has(`${e.source}:${handle}`) || !completed.has(e.source)) continue;
+    if (possiblePortIds(nodesById.get(e.source)).includes(handle)) continue;
+    events.push({
+      type: "log",
+      nodeId: target.id,
+      level: "warn",
+      message: undeliveredEdgeMessage(e, target, portValues, nodesById),
+      detail: { edge: e.id, source: e.source, sourceHandle: handle }
+    });
+  }
+  return events;
+}
+function possiblePortIds(node) {
+  if (!node) return ["out"];
+  const own = node.data?.outputs;
+  if (Array.isArray(own)) return own.map((p) => p.id);
+  const kind = getNodeKind(node.data?.kind ?? node.type ?? "");
+  if (!kind) return ["out"];
+  const config = nodeConfig(node);
+  const representative = typeof kind.outputs === "function" && !configDeclaresPorts(kind.name, config);
+  const ids = (resolvePortSpec(kind.outputs, representative ? defaultConfigFor(kind) : config) ?? []).map((p) => p.id);
+  return ids.length > 0 ? ids : ["out"];
+}
+function configDeclaresPorts(kindName, config) {
+  const bare = kindName.startsWith("@") ? kindName.slice(kindName.lastIndexOf("/") + 1) : kindName;
+  if (bare === "switch_case") {
+    const cases = config.cases;
+    return !!cases && typeof cases === "object" && Object.values(cases).some((port) => typeof port === "string" && port !== "");
+  }
+  if (bare === "llm_router") {
+    const routes = config.routes;
+    return Array.isArray(routes) && routes.some((route) => route?.port != null && route.port !== "");
+  }
+  return true;
+}
+function undeliveredEdgeMessage(edge, target, portValues, nodesById) {
+  const handle = edge.sourceHandle ?? "out";
+  const prefix = `${edge.source}:`;
+  const available = [];
+  for (const key of portValues.keys()) {
+    if (key.startsWith(prefix)) available.push(key.slice(prefix.length));
+  }
+  let message = `Edge ${edge.id} reads port "${handle}" from node ${edge.source}, which never publishes it \u2014 nothing would reach ${target.id} at run time.`;
+  if (available.length > 0) message += ` Available: ${available.join(", ")}.`;
+  const source = nodesById.get(edge.source);
+  if (source && outputFieldsFor(source).some((field) => field?.path === handle)) {
+    message += ` Note: "${handle}" is a FIELD this node emits, not a port \u2014 read it downstream as {{ in.${handle} }} rather than naming it as a source handle.`;
+  }
+  if (edge.sourceHandle != null) message += " Leave sourceHandle off to read the node's output.";
+  return message;
+}
+
 // src/runtime/workflow-props.ts
 function typeOf(value) {
   if (value === null) return "null";
@@ -577,7 +634,7 @@ function resolveWorkflowProps(declared, passed) {
 // src/runtime/run-flow.ts
 async function runFlow(graph, executors, onEvent = () => {
 }, options = {}) {
-  const { signal, initialInputs = {}, timeoutMs, depth = 0, resumeOutputs = {}, entryNodes } = options;
+  const { signal, initialInputs = {}, timeoutMs, depth = 0, resumeOutputs = {}, entryNodes, nodeExecutors } = options;
   const run = options.run === void 0 ? void 0 : RunIdentity.from(options.run);
   const outputs = {};
   const portValues = /* @__PURE__ */ new Map();
@@ -640,17 +697,8 @@ async function runFlow(graph, executors, onEvent = () => {
         onEvent({ type: "node-status", nodeId: node.id, status: "idle", text: "skipped" });
         continue;
       }
-      for (const e of incoming) {
-        const handle = e.sourceHandle ?? "out";
-        if (portValues.has(`${e.source}:${handle}`) || !completed.has(e.source)) continue;
-        if (possiblePortIds(nodesById.get(e.source)).includes(handle)) continue;
-        onEvent({
-          type: "log",
-          nodeId: node.id,
-          level: "warn",
-          message: undeliveredEdgeMessage(e, node, portValues, nodesById),
-          detail: { edge: e.id, source: e.source, sourceHandle: handle }
-        });
+      for (const warning of undeliveredEdgeWarnings(node, incoming, portValues, completed, nodesById)) {
+        onEvent(warning);
       }
       if (incoming.length > 0) {
         const anyActive = incoming.some((e) => portValues.has(`${e.source}:${e.sourceHandle ?? "out"}`));
@@ -674,7 +722,7 @@ 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, props, declaresProps);
-      const exec = pickExecutor(executors, node);
+      const exec = pickExecutor(executors, node, nodeExecutors);
       if (!exec) {
         const tried = executorLookupIds(node);
         const msg = `No executor registered for kind=${node.type} \u2014 tried ${tried.map((id) => `"${id}"`).join(", ")}. Key your registry by one of those.`;
@@ -794,7 +842,9 @@ function executorLookupIds(node) {
   ids.push("*");
   return [...new Set(ids)];
 }
-function pickExecutor(executors, node) {
+function pickExecutor(executors, node, nodeExecutors) {
+  const pinned = nodeExecutors && Object.prototype.hasOwnProperty.call(nodeExecutors, node.id) ? nodeExecutors[node.id] : void 0;
+  if (pinned) return pinned;
   for (const id of executorLookupIds(node)) {
     if (executors[id]) return executors[id];
   }
@@ -814,45 +864,6 @@ function activatedPorts(node, result) {
   const declared = resolveNodePorts(node, kind).outputs?.map((p) => p.id);
   return { ports: declared?.length ? declared : ["out"], value: result };
 }
-function possiblePortIds(node) {
-  if (!node) return ["out"];
-  const own = node.data?.outputs;
-  if (Array.isArray(own)) return own.map((p) => p.id);
-  const kind = getNodeKind(node.data?.kind ?? node.type ?? "");
-  if (!kind) return ["out"];
-  const config = nodeConfig(node);
-  const representative = typeof kind.outputs === "function" && !configDeclaresPorts(kind.name, config);
-  const ids = (resolvePortSpec(kind.outputs, representative ? defaultConfigFor(kind) : config) ?? []).map((p) => p.id);
-  return ids.length > 0 ? ids : ["out"];
-}
-function configDeclaresPorts(kindName, config) {
-  const bare = kindName.startsWith("@") ? kindName.slice(kindName.lastIndexOf("/") + 1) : kindName;
-  if (bare === "switch_case") {
-    const cases = config.cases;
-    return !!cases && typeof cases === "object" && Object.values(cases).some((port) => typeof port === "string" && port !== "");
-  }
-  if (bare === "llm_router") {
-    const routes = config.routes;
-    return Array.isArray(routes) && routes.some((route) => route?.port != null && route.port !== "");
-  }
-  return true;
-}
-function undeliveredEdgeMessage(edge, target, portValues, nodesById) {
-  const handle = edge.sourceHandle ?? "out";
-  const prefix = `${edge.source}:`;
-  const available = [];
-  for (const key of portValues.keys()) {
-    if (key.startsWith(prefix)) available.push(key.slice(prefix.length));
-  }
-  let message = `Edge ${edge.id} reads port "${handle}" from node ${edge.source}, which never publishes it \u2014 nothing would reach ${target.id} at run time.`;
-  if (available.length > 0) message += ` Available: ${available.join(", ")}.`;
-  const source = nodesById.get(edge.source);
-  if (source && outputFieldsFor(source).some((field) => field?.path === handle)) {
-    message += ` Note: "${handle}" is a FIELD this node emits, not a port \u2014 read it downstream as {{ in.${handle} }} rather than naming it as a source handle.`;
-  }
-  if (edge.sourceHandle != null) message += " Leave sourceHandle off to read the node's output.";
-  return message;
-}
 function announce(onEvent, node, phase) {
   const data = node.data;
   const raw = phase === "start" ? data?.startingMsg : data?.stoppingMsg;
@@ -2829,6 +2840,6 @@ function describeExpressionGrammar() {
   };
 }
 
-export { BUILTIN_KIND_DATA, DEFAULT_MAX_DEPTH, RunIdentity, UnresolvedPathError, applyKindSchemaOverlay, availableVariables, baseVariables, categoryAccent, clearKindSchemaOverlays, clearNodeKindOverrides, declaredRoutes, defaultConfigFor, describeExpressionGrammar, ensureBuiltinKinds, escapeSegment, evaluateConfig, evaluateExpression, getNodeKind, humanInputFields, kindIds, listNodeKinds, llmRouterExecutor, nodeConfig, onNodeKindsChanged, outputFieldsFor, overrideNodeKind, registerBuiltinKindInternal, registerNodeKind, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePath, resolvePortSpec, runFlow, subflowExecutor, subflowMode, subflowPorts, text, truthy, tryResolvePath, unregisterNodeKind, validateConfig };
-//# sourceMappingURL=chunk-EVGSL2EM.js.map
-//# sourceMappingURL=chunk-EVGSL2EM.js.map
+export { BUILTIN_KIND_DATA, DEFAULT_MAX_DEPTH, RunIdentity, UnresolvedPathError, applyKindSchemaOverlay, availableVariables, baseVariables, categoryAccent, clearKindSchemaOverlays, clearNodeKindOverrides, declaredRoutes, defaultConfigFor, describeExpressionGrammar, ensureBuiltinKinds, escapeSegment, evaluateConfig, evaluateExpression, getNodeKind, humanInputFields, kindIds, listNodeKinds, llmRouterExecutor, nodeConfig, onNodeKindsChanged, outputFieldsFor, overrideNodeKind, registerBuiltinKindInternal, registerNodeKind, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePath, resolvePortSpec, runFlow, subflowExecutor, subflowMode, subflowPorts, text, truthy, tryResolvePath, undeliveredEdgeWarnings, unregisterNodeKind, validateConfig };
+//# sourceMappingURL=chunk-EX34GCKK.js.map
+//# sourceMappingURL=chunk-EX34GCKK.js.map