@particle-academy/fancy-flow 0.10.0 → 0.11.0

package/dist/index.cjs

@@ -12,19 +12,33 @@ var ReactExports__default = /*#__PURE__*/_interopDefault(ReactExports);
 
 // src/registry/registry.ts
 var kinds = /* @__PURE__ */ new Map();
+var aliases = /* @__PURE__ */ new Map();
 var listeners = /* @__PURE__ */ new Set();
 function registerNodeKind(definition) {
   kinds.set(definition.name, definition);
+  for (const alias of definition.aliases ?? []) aliases.set(alias, definition.name);
   notify();
   return () => {
     if (kinds.get(definition.name) === definition) {
       kinds.delete(definition.name);
+      for (const alias of definition.aliases ?? []) {
+        if (aliases.get(alias) === definition.name) aliases.delete(alias);
+      }
       notify();
     }
   };
 }
+function resolveKindId(id2) {
+  if (kinds.has(id2)) return id2;
+  const canonical = aliases.get(id2);
+  return canonical && kinds.has(canonical) ? canonical : null;
+}
 function getNodeKind(name) {
-  return kinds.get(name) ?? null;
+  const canonical = resolveKindId(name);
+  return canonical ? kinds.get(canonical) ?? null : null;
+}
+function kindIds(kind) {
+  return [kind.name, ...kind.aliases ?? []];
 }
 function listNodeKinds(category) {
   const all = Array.from(kinds.values());
@@ -244,7 +258,8 @@ var HTTP_METHODS = [
 var KINDS = [
   // ───────────── Triggers ─────────────
   {
-    name: "manual_trigger",
+    name: "@fancy/manual_trigger",
+    aliases: ["manual_trigger"],
     category: "trigger",
     label: "Manual",
     description: "Entry point fired when the user clicks Run.",
@@ -253,7 +268,8 @@ var KINDS = [
     outputs: [{ id: "out" }]
   },
   {
-    name: "webhook_trigger",
+    name: "@fancy/webhook_trigger",
+    aliases: ["webhook_trigger"],
     category: "trigger",
     label: "Webhook",
     description: "Triggered by an inbound HTTP request to a host-provided URL.",
@@ -270,7 +286,8 @@ var KINDS = [
     ]
   },
   {
-    name: "schedule_trigger",
+    name: "@fancy/schedule_trigger",
+    aliases: ["schedule_trigger"],
     category: "trigger",
     label: "Schedule",
     description: "Fires on a cron schedule (host-implemented).",
@@ -290,7 +307,8 @@ var KINDS = [
     ]
   },
   {
-    name: "user_input",
+    name: "@fancy/user_input",
+    aliases: ["user_input"],
     category: "human",
     label: "User Input",
     description: "Pause the flow until the user submits the configured form.",
@@ -330,7 +348,8 @@ var KINDS = [
     ]
   },
   {
-    name: "rich_user_input",
+    name: "@fancy/rich_user_input",
+    aliases: ["rich_user_input"],
     category: "human",
     label: "Rich User Input",
     description: "Pause the flow on a fully authored page \u2014 content, required reading, multi-section forms.",
@@ -355,7 +374,8 @@ var KINDS = [
   },
   // ───────────── Logic ─────────────
   {
-    name: "branch",
+    name: "@fancy/branch",
+    aliases: ["branch"],
     category: "logic",
     label: "Branch",
     description: "Multi-way branch on a condition or value.",
@@ -367,7 +387,8 @@ var KINDS = [
     ]
   },
   {
-    name: "switch_case",
+    name: "@fancy/switch_case",
+    aliases: ["switch_case"],
     category: "logic",
     label: "Switch",
     description: "Route to one of N labelled outputs based on a key.",
@@ -394,7 +415,8 @@ var KINDS = [
     ]
   },
   {
-    name: "for_each",
+    name: "@fancy/for_each",
+    aliases: ["for_each"],
     category: "logic",
     label: "For Each",
     description: "Iterate over a list, emitting each item on `item`.",
@@ -407,7 +429,8 @@ var KINDS = [
     ]
   },
   {
-    name: "merge",
+    name: "@fancy/merge",
+    aliases: ["merge"],
     category: "logic",
     label: "Merge",
     description: "Combine multiple inputs into one object or array.",
@@ -425,7 +448,8 @@ var KINDS = [
     ]
   },
   {
-    name: "wait",
+    name: "@fancy/wait",
+    aliases: ["wait"],
     category: "logic",
     label: "Wait",
     description: "Sleep or wait for an external event.",
@@ -442,7 +466,8 @@ var KINDS = [
     ]
   },
   {
-    name: "transform",
+    name: "@fancy/transform",
+    aliases: ["transform"],
     category: "logic",
     label: "Transform",
     description: "Reshape data with an expression.",
@@ -459,7 +484,8 @@ var KINDS = [
   },
   // ───────────── Data ─────────────
   {
-    name: "memory_store",
+    name: "@fancy/memory_store",
+    aliases: ["memory_store"],
     category: "data",
     label: "Memory Store",
     description: "Read or write per-conversation memory.",
@@ -479,7 +505,8 @@ var KINDS = [
     ]
   },
   {
-    name: "data_store",
+    name: "@fancy/data_store",
+    aliases: ["data_store"],
     category: "data",
     label: "Data Store",
     description: "Key-value or table read/write against a host store.",
@@ -507,7 +534,8 @@ var KINDS = [
     ]
   },
   {
-    name: "variable",
+    name: "@fancy/variable",
+    aliases: ["variable"],
     category: "data",
     label: "Variable",
     description: "Workflow-scoped value used by other nodes.",
@@ -519,7 +547,8 @@ var KINDS = [
   },
   // ───────────── AI ─────────────
   {
-    name: "llm_call",
+    name: "@fancy/llm_call",
+    aliases: ["llm_call"],
     category: "ai",
     label: "LLM Call",
     description: "Send a prompt + context to a model and receive a response.",
@@ -546,7 +575,8 @@ var KINDS = [
     ]
   },
   {
-    name: "llm_branch",
+    name: "@fancy/llm_branch",
+    aliases: ["llm_branch"],
     category: "ai",
     label: "LLM Router",
     description: "Let a model choose which route the flow takes.",
@@ -616,7 +646,8 @@ var KINDS = [
     ]
   },
   {
-    name: "tool_use",
+    name: "@fancy/tool_use",
+    aliases: ["tool_use"],
     category: "ai",
     label: "Tool Use",
     description: "Hand control to a host-registered tool by name.",
@@ -627,7 +658,8 @@ var KINDS = [
     ]
   },
   {
-    name: "embed_search",
+    name: "@fancy/embed_search",
+    aliases: ["embed_search"],
     category: "ai",
     label: "Embed & Search",
     description: "Embed a query and search a vector store.",
@@ -640,7 +672,8 @@ var KINDS = [
   },
   // ───────────── IO ─────────────
   {
-    name: "api_request",
+    name: "@fancy/api_request",
+    aliases: ["api_request"],
     category: "io",
     label: "API Request",
     description: "HTTP request to any URL.",
@@ -654,7 +687,8 @@ var KINDS = [
     ]
   },
   {
-    name: "webhook_out",
+    name: "@fancy/webhook_out",
+    aliases: ["webhook_out"],
     category: "io",
     label: "Send Webhook",
     description: "POST a payload to a configured URL.",
@@ -667,7 +701,8 @@ var KINDS = [
   },
   // ───────────── Human ─────────────
   {
-    name: "human_approval",
+    name: "@fancy/human_approval",
+    aliases: ["human_approval"],
     category: "human",
     label: "Human Approval",
     description: "Pause until a human approves or denies.",
@@ -681,7 +716,8 @@ var KINDS = [
     ]
   },
   {
-    name: "notify",
+    name: "@fancy/notify",
+    aliases: ["notify"],
     category: "human",
     label: "Notify",
     description: "Send a message via Slack / email / SMS / etc.",
@@ -705,7 +741,8 @@ var KINDS = [
   },
   // ───────────── Output ─────────────
   {
-    name: "output",
+    name: "@fancy/output",
+    aliases: ["output"],
     category: "output",
     label: "Output",
     description: "Terminal node \u2014 captures the workflow's result.",
@@ -714,7 +751,8 @@ var KINDS = [
     outputs: []
   },
   {
-    name: "log",
+    name: "@fancy/log",
+    aliases: ["log"],
     category: "output",
     label: "Log",
     description: "Send to the run feed.",
@@ -10540,6 +10578,12 @@ function collectInputs(node, incoming, portValues, initial) {
 function pickExecutor(executors, node) {
   if (executors[node.id]) return executors[node.id];
   if (node.type && executors[node.type]) return executors[node.type];
+  const kind = node.type ? getNodeKind(node.type) : null;
+  if (kind) {
+    for (const id2 of kindIds(kind)) {
+      if (executors[id2]) return executors[id2];
+    }
+  }
   return executors["*"];
 }
 function activatedPorts(node, result) {
@@ -10667,13 +10711,17 @@ function exportWorkflow(graph, metadata, view) {
 }
 function toSchemaNode(n) {
   const data = n.data ?? {};
+  const kindName = data.kind ?? n.type ?? "custom";
+  const ports = resolveNodePorts(n, getNodeKind(kindName) ?? void 0);
   return {
     id: n.id,
-    kind: data.kind ?? n.type ?? "custom",
+    kind: kindName,
     position: { x: n.position.x, y: n.position.y },
     label: data.label,
     description: data.description,
-    config: data.config
+    config: data.config,
+    inputs: ports.inputs,
+    outputs: ports.outputs
   };
 }
 function toSchemaEdge(e) {
@@ -10717,15 +10765,20 @@ function importWorkflow(schema, options = {}) {
         issues.push({ level: "warning", nodeId: n.id, message: `${iss.key}: ${iss.message}` });
       }
     }
+    const kindId = kind?.name ?? n.kind;
     return {
       id: n.id,
-      type: n.kind,
+      type: kindId,
       position: { x: n.position?.x ?? 0, y: n.position?.y ?? 0 },
       data: {
-        kind: n.kind,
+        kind: kindId,
         label: n.label ?? kind?.label ?? n.kind,
         description: n.description,
-        config
+        config,
+        // Carry serialized ports back onto the node so a round-trip is stable
+        // and an unknown kind still routes the way the document described.
+        ...n.inputs ? { inputs: n.inputs } : {},
+        ...n.outputs ? { outputs: n.outputs } : {}
       }
     };
   });
@@ -10871,7 +10924,9 @@ function previewValue(v) {
 // src/registry/index.ts
 function buildNodeTypes() {
   const map = {};
-  for (const k of listNodeKinds()) map[k.name] = RegistryNode;
+  for (const k of listNodeKinds()) {
+    for (const id2 of kindIds(k)) map[id2] = RegistryNode;
+  }
   return map;
 }