@particle-academy/fancy-flow 0.34.0 → 0.36.0

package/dist/layout/index.d.cts

@@ -1,4 +1,4 @@
-import { F as FlowGraph, a as FlowNode } from '../types-CMSrWVYM.cjs';
+import { F as FlowGraph, b as FlowNode } from '../types-sOmpCitB.cjs';
 import '@xyflow/react';
 
 type AutoLayoutDirection = "LR" | "TB" | "RL" | "BT";

package/dist/layout/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FlowGraph, a as FlowNode } from '../types-CMSrWVYM.js';
+import { F as FlowGraph, b as FlowNode } from '../types-sOmpCitB.js';
 import '@xyflow/react';
 
 type AutoLayoutDirection = "LR" | "TB" | "RL" | "BT";

package/dist/llm/prism.d.cts

@@ -1,5 +1,5 @@
-import { L as LlmClient } from '../capabilities-BLOeLACV.cjs';
-import '../types-CMSrWVYM.cjs';
+import { L as LlmClient } from '../capabilities-BtJQTbnw.cjs';
+import '../types-sOmpCitB.cjs';
 import '@xyflow/react';
 
 /**

package/dist/llm/prism.d.ts

@@ -1,5 +1,5 @@
-import { L as LlmClient } from '../capabilities-BH7zmSQQ.js';
-import '../types-CMSrWVYM.js';
+import { L as LlmClient } from '../capabilities-CkhKj_U_.js';
+import '../types-sOmpCitB.js';
 import '@xyflow/react';
 
 /**

package/dist/llm/vercel-ai.d.cts

@@ -1,6 +1,6 @@
 import { LanguageModel } from 'ai';
-import { a as LlmRouteRequest, L as LlmClient } from '../capabilities-BLOeLACV.cjs';
-import '../types-CMSrWVYM.cjs';
+import { a as LlmRouteRequest, L as LlmClient } from '../capabilities-BtJQTbnw.cjs';
+import '../types-sOmpCitB.cjs';
 import '@xyflow/react';
 
 /**

package/dist/llm/vercel-ai.d.ts

@@ -1,6 +1,6 @@
 import { LanguageModel } from 'ai';
-import { a as LlmRouteRequest, L as LlmClient } from '../capabilities-BH7zmSQQ.js';
-import '../types-CMSrWVYM.js';
+import { a as LlmRouteRequest, L as LlmClient } from '../capabilities-CkhKj_U_.js';
+import '../types-sOmpCitB.js';
 import '@xyflow/react';
 
 /**

package/dist/registry/index.d.cts

@@ -1,12 +1,12 @@
-import { N as NodeKindDefinition, d as PortSpec } from '../types-DEmDSByY.cjs';
-export { C as ConfigField, g as CredentialConfigField, D as DocumentConfigField, E as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, L as LEGACY_PAUSE_PREFIXES, a as NodeCategory, h as NumberConfigField, b as PAUSE_PREFIX, P as PauseAwaiting, c as PauseSignal, R as RenderBodyContext, j as RepeaterConfigField, k as RepeaterRowField, S as SelectConfigField, l as SwitchConfigField, T as TextConfigField, m as TextareaConfigField, e as decodePause, f as encodePause, i as isPause, p as pauseForHuman } from '../types-DEmDSByY.cjs';
-import { P as PortDescriptor, a as FlowNode, N as NodeExecutor } from '../types-CMSrWVYM.cjs';
+import { d as NodeKindDefinition, j as PortSpec } from '../types-D8Dezh9v.cjs';
+export { a as ConfigField, q as CredentialConfigField, D as DocumentConfigField, E as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, L as LEGACY_PAUSE_PREFIXES, c as NodeCategory, r as NumberConfigField, h as PAUSE_PREFIX, P as PauseAwaiting, i as PauseSignal, R as RenderBodyContext, t as RepeaterConfigField, u as RepeaterRowField, w as SelectConfigField, x as SwitchConfigField, T as TextConfigField, y as TextareaConfigField, m as decodePause, n as encodePause, o as isPause, p as pauseForHuman } from '../types-D8Dezh9v.cjs';
+import { P as PortDescriptor, b as FlowNode, N as NodeExecutor } from '../types-sOmpCitB.cjs';
 import { Connection, Edge, NodeProps, NodeTypes } from '@xyflow/react';
-import { b as LlmRoute } from '../capabilities-BLOeLACV.cjs';
-export { C as CapabilityId, L as LlmClient, c as LlmRouteChoice, a as LlmRouteRequest, W as WorkflowResolution, d as WorkflowResolutionFailure, e as WorkflowResolver, f as capabilityStatus, g as getLlmClient, h as getWorkflowResolver, i as isResolutionFailure, r as registerLlmClient, j as registerWorkflowResolver } from '../capabilities-BLOeLACV.cjs';
+import { b as LlmRoute } from '../capabilities-BtJQTbnw.cjs';
+export { C as CapabilityId, L as LlmClient, c as LlmRouteChoice, a as LlmRouteRequest, W as WorkflowResolution, d as WorkflowResolutionFailure, e as WorkflowResolver, f as capabilityStatus, g as getLlmClient, h as getWorkflowResolver, i as isResolutionFailure, r as registerLlmClient, j as registerWorkflowResolver } from '../capabilities-BtJQTbnw.cjs';
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-export { c as categoryAccent, d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, o as onNodeKindsChanged, r as registerNodeKind, a as resolveKindId, v as validateConfig } from '../registry-qv4gRiuQ.cjs';
+export { N as NodeKindPresentation, c as categoryAccent, b as clearNodeKindOverrides, d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, o as onNodeKindsChanged, e as overrideNodeKind, r as registerNodeKind, a as resolveKindId, v as validateConfig } from '../registry-BADFn97n.cjs';
 
 /**
  * Connection validation — the single rule that decides whether an edge between

package/dist/registry/index.d.ts

@@ -1,12 +1,12 @@
-import { N as NodeKindDefinition, d as PortSpec } from '../types-Bj_ZHwqG.js';
-export { C as ConfigField, g as CredentialConfigField, D as DocumentConfigField, E as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, L as LEGACY_PAUSE_PREFIXES, a as NodeCategory, h as NumberConfigField, b as PAUSE_PREFIX, P as PauseAwaiting, c as PauseSignal, R as RenderBodyContext, j as RepeaterConfigField, k as RepeaterRowField, S as SelectConfigField, l as SwitchConfigField, T as TextConfigField, m as TextareaConfigField, e as decodePause, f as encodePause, i as isPause, p as pauseForHuman } from '../types-Bj_ZHwqG.js';
-import { P as PortDescriptor, a as FlowNode, N as NodeExecutor } from '../types-CMSrWVYM.js';
+import { d as NodeKindDefinition, j as PortSpec } from '../types-D6lsIGoe.js';
+export { a as ConfigField, q as CredentialConfigField, D as DocumentConfigField, E as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, L as LEGACY_PAUSE_PREFIXES, c as NodeCategory, r as NumberConfigField, h as PAUSE_PREFIX, P as PauseAwaiting, i as PauseSignal, R as RenderBodyContext, t as RepeaterConfigField, u as RepeaterRowField, w as SelectConfigField, x as SwitchConfigField, T as TextConfigField, y as TextareaConfigField, m as decodePause, n as encodePause, o as isPause, p as pauseForHuman } from '../types-D6lsIGoe.js';
+import { P as PortDescriptor, b as FlowNode, N as NodeExecutor } from '../types-sOmpCitB.js';
 import { Connection, Edge, NodeProps, NodeTypes } from '@xyflow/react';
-import { b as LlmRoute } from '../capabilities-BH7zmSQQ.js';
-export { C as CapabilityId, L as LlmClient, c as LlmRouteChoice, a as LlmRouteRequest, W as WorkflowResolution, d as WorkflowResolutionFailure, e as WorkflowResolver, f as capabilityStatus, g as getLlmClient, h as getWorkflowResolver, i as isResolutionFailure, r as registerLlmClient, j as registerWorkflowResolver } from '../capabilities-BH7zmSQQ.js';
+import { b as LlmRoute } from '../capabilities-CkhKj_U_.js';
+export { C as CapabilityId, L as LlmClient, c as LlmRouteChoice, a as LlmRouteRequest, W as WorkflowResolution, d as WorkflowResolutionFailure, e as WorkflowResolver, f as capabilityStatus, g as getLlmClient, h as getWorkflowResolver, i as isResolutionFailure, r as registerLlmClient, j as registerWorkflowResolver } from '../capabilities-CkhKj_U_.js';
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
-export { c as categoryAccent, d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, o as onNodeKindsChanged, r as registerNodeKind, a as resolveKindId, v as validateConfig } from '../registry-Dd1Q66uP.js';
+export { N as NodeKindPresentation, c as categoryAccent, b as clearNodeKindOverrides, d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, o as onNodeKindsChanged, e as overrideNodeKind, r as registerNodeKind, a as resolveKindId, v as validateConfig } from '../registry-DYbFLEcW.js';
 
 /**
  * Connection validation — the single rule that decides whether an edge between

package/dist/registry-BADFn97n.d.cts

@@ -0,0 +1,85 @@
+import { d as NodeKindDefinition } from './types-D8Dezh9v.cjs';
+
+/**
+ * The presentation fields a consumer may override on someone else's node kind.
+ *
+ * Deliberately excludes everything behavioural — `executor`, `inputs`,
+ * `outputs`, `configSchema`, `sideEffects`. An "override" that could change
+ * those is not an override, it is a fork wearing a friendly name, and it would
+ * desync the graph from the runtime that executes it.
+ *
+ * `category` IS included: which drawer a node appears in is presentation, and a
+ * consumer regrouping their palette is the same kind of act as renaming.
+ */
+type NodeKindPresentation = Partial<Pick<NodeKindDefinition, "label" | "description" | "icon" | "accent" | "category">>;
+/**
+ * registerNodeKind — install a node kind in the global registry. Returns
+ * an `unregister` function. Calling with the same name replaces the prior
+ * registration (handy for HMR).
+ *
+ * A kind's `name` is its CANONICAL id and is what gets written into saved
+ * documents. Publish namespaced (`@fancy/llm_branch`, `@acme/salesforce_upsert`)
+ * and list any previous bare names in `aliases`, so graphs saved before the
+ * rename keep resolving.
+ */
+declare function registerNodeKind<TC = any, TI = any, TO = any>(definition: NodeKindDefinition<TC, TI, TO>): () => void;
+/**
+ * Resolve any id — canonical or alias — to the canonical one, or null.
+ *
+ * `kind` is persisted inside every saved graph, so a bare name that two
+ * packages could both claim is unfixable after the fact: the ambiguous string
+ * is already in the document. Canonical ids are namespaced; aliases exist so
+ * documents written before namespacing keep opening.
+ */
+declare function resolveKindId(id: string): string | null;
+/**
+ * Rename or re-describe a kind you did not author.
+ *
+ * Before this existed the only way to relabel a builtin was `registerNodeKind`
+ * with a full definition — which REPLACES the kind, so a consumer wanting
+ * "Call an API" instead of "HTTP Request" had to re-declare that node's
+ * configSchema, ports, executor and renderer, and silently forfeited whatever
+ * the builtin gained in the next release. In practice nobody renamed a node,
+ * and the palette could not be localised at all.
+ *
+ * ```ts
+ * const undo = overrideNodeKind("@particle-academy/http_request", {
+ *   label: "Call an API",
+ *   description: "Fetch or post JSON to a URL",
+ * });
+ * ```
+ *
+ * Applies at `getNodeKind()` and `listNodeKinds()`, so one call reaches the
+ * palette, the node cards on the canvas, `FlowViewer`, and anything else that
+ * reads the registry. Returns an unsubscribe, matching `registerNodeKind`.
+ *
+ * Patching an unregistered id is allowed and takes effect if that kind is
+ * registered later — order of module side effects is not something a consumer
+ * should have to reason about.
+ */
+declare function overrideNodeKind(name: string, patch: NodeKindPresentation): () => void;
+/** Remove every presentation override. Mostly for tests. */
+declare function clearNodeKindOverrides(): void;
+/** Get a single kind by canonical id or alias, or null. */
+declare function getNodeKind(name: string): NodeKindDefinition | null;
+/** Every id a kind answers to — canonical first. Used to key node-type maps. */
+declare function kindIds(kind: NodeKindDefinition): string[];
+/** List every registered kind, optionally filtered by category. */
+declare function listNodeKinds(category?: string): NodeKindDefinition[];
+/** Subscribe to registry changes. Returns an unsubscribe function. */
+declare function onNodeKindsChanged(listener: () => void): () => void;
+/** Fill in defaults from a kind's configSchema for newly-created nodes. */
+declare function defaultConfigFor(kind: NodeKindDefinition): Record<string, unknown>;
+/**
+ * Validate a config object against a kind's schema. Returns an array of
+ * issues (empty = valid). Validation is intentionally light — type
+ * coercion + required-field checks. Hosts can layer Zod / Ajv on top.
+ */
+declare function validateConfig(kind: NodeKindDefinition, config: Record<string, unknown>): Array<{
+    key: string;
+    message: string;
+}>;
+/** Default accents per category. */
+declare function categoryAccent(category: string): string;
+
+export { type NodeKindPresentation as N, resolveKindId as a, clearNodeKindOverrides as b, categoryAccent as c, defaultConfigFor as d, overrideNodeKind as e, getNodeKind as g, kindIds as k, listNodeKinds as l, onNodeKindsChanged as o, registerNodeKind as r, validateConfig as v };

package/dist/registry-DYbFLEcW.d.ts

@@ -0,0 +1,85 @@
+import { d as NodeKindDefinition } from './types-D6lsIGoe.js';
+
+/**
+ * The presentation fields a consumer may override on someone else's node kind.
+ *
+ * Deliberately excludes everything behavioural — `executor`, `inputs`,
+ * `outputs`, `configSchema`, `sideEffects`. An "override" that could change
+ * those is not an override, it is a fork wearing a friendly name, and it would
+ * desync the graph from the runtime that executes it.
+ *
+ * `category` IS included: which drawer a node appears in is presentation, and a
+ * consumer regrouping their palette is the same kind of act as renaming.
+ */
+type NodeKindPresentation = Partial<Pick<NodeKindDefinition, "label" | "description" | "icon" | "accent" | "category">>;
+/**
+ * registerNodeKind — install a node kind in the global registry. Returns
+ * an `unregister` function. Calling with the same name replaces the prior
+ * registration (handy for HMR).
+ *
+ * A kind's `name` is its CANONICAL id and is what gets written into saved
+ * documents. Publish namespaced (`@fancy/llm_branch`, `@acme/salesforce_upsert`)
+ * and list any previous bare names in `aliases`, so graphs saved before the
+ * rename keep resolving.
+ */
+declare function registerNodeKind<TC = any, TI = any, TO = any>(definition: NodeKindDefinition<TC, TI, TO>): () => void;
+/**
+ * Resolve any id — canonical or alias — to the canonical one, or null.
+ *
+ * `kind` is persisted inside every saved graph, so a bare name that two
+ * packages could both claim is unfixable after the fact: the ambiguous string
+ * is already in the document. Canonical ids are namespaced; aliases exist so
+ * documents written before namespacing keep opening.
+ */
+declare function resolveKindId(id: string): string | null;
+/**
+ * Rename or re-describe a kind you did not author.
+ *
+ * Before this existed the only way to relabel a builtin was `registerNodeKind`
+ * with a full definition — which REPLACES the kind, so a consumer wanting
+ * "Call an API" instead of "HTTP Request" had to re-declare that node's
+ * configSchema, ports, executor and renderer, and silently forfeited whatever
+ * the builtin gained in the next release. In practice nobody renamed a node,
+ * and the palette could not be localised at all.
+ *
+ * ```ts
+ * const undo = overrideNodeKind("@particle-academy/http_request", {
+ *   label: "Call an API",
+ *   description: "Fetch or post JSON to a URL",
+ * });
+ * ```
+ *
+ * Applies at `getNodeKind()` and `listNodeKinds()`, so one call reaches the
+ * palette, the node cards on the canvas, `FlowViewer`, and anything else that
+ * reads the registry. Returns an unsubscribe, matching `registerNodeKind`.
+ *
+ * Patching an unregistered id is allowed and takes effect if that kind is
+ * registered later — order of module side effects is not something a consumer
+ * should have to reason about.
+ */
+declare function overrideNodeKind(name: string, patch: NodeKindPresentation): () => void;
+/** Remove every presentation override. Mostly for tests. */
+declare function clearNodeKindOverrides(): void;
+/** Get a single kind by canonical id or alias, or null. */
+declare function getNodeKind(name: string): NodeKindDefinition | null;
+/** Every id a kind answers to — canonical first. Used to key node-type maps. */
+declare function kindIds(kind: NodeKindDefinition): string[];
+/** List every registered kind, optionally filtered by category. */
+declare function listNodeKinds(category?: string): NodeKindDefinition[];
+/** Subscribe to registry changes. Returns an unsubscribe function. */
+declare function onNodeKindsChanged(listener: () => void): () => void;
+/** Fill in defaults from a kind's configSchema for newly-created nodes. */
+declare function defaultConfigFor(kind: NodeKindDefinition): Record<string, unknown>;
+/**
+ * Validate a config object against a kind's schema. Returns an array of
+ * issues (empty = valid). Validation is intentionally light — type
+ * coercion + required-field checks. Hosts can layer Zod / Ajv on top.
+ */
+declare function validateConfig(kind: NodeKindDefinition, config: Record<string, unknown>): Array<{
+    key: string;
+    message: string;
+}>;
+/** Default accents per category. */
+declare function categoryAccent(category: string): string;
+
+export { type NodeKindPresentation as N, resolveKindId as a, clearNodeKindOverrides as b, categoryAccent as c, defaultConfigFor as d, overrideNodeKind as e, getNodeKind as g, kindIds as k, listNodeKinds as l, onNodeKindsChanged as o, registerNodeKind as r, validateConfig as v };

package/dist/registry.cjs

@@ -35,6 +35,7 @@ function resolveNodePorts(node, kind) {
 var kinds = /* @__PURE__ */ new Map();
 var aliases = /* @__PURE__ */ new Map();
 var listeners = /* @__PURE__ */ new Set();
+var overrides = /* @__PURE__ */ new Map();
 function registerNodeKind(definition) {
   kinds.set(definition.name, definition);
   for (const alias of definition.aliases ?? []) aliases.set(alias, definition.name);
@@ -54,15 +55,41 @@ function resolveKindId(id2) {
   const canonical = aliases.get(id2);
   return canonical && kinds.has(canonical) ? canonical : null;
 }
+function overrideNodeKind(name, patch) {
+  const canonical = resolveKindId(name) ?? name;
+  const previous = overrides.get(canonical);
+  overrides.set(canonical, { ...previous, ...patch });
+  notify();
+  return () => {
+    if (previous) {
+      overrides.set(canonical, previous);
+    } else {
+      overrides.delete(canonical);
+    }
+    notify();
+  };
+}
+function clearNodeKindOverrides() {
+  if (overrides.size === 0) return;
+  overrides.clear();
+  notify();
+}
+function withOverride(kind) {
+  if (!kind) return null;
+  const patch = overrides.get(kind.name);
+  return patch ? { ...kind, ...patch } : kind;
+}
 function getNodeKind(name) {
   const canonical = resolveKindId(name);
-  return canonical ? kinds.get(canonical) ?? null : null;
+  return canonical ? withOverride(kinds.get(canonical)) : null;
 }
 function kindIds(kind) {
   return [kind.name, ...kind.aliases ?? []];
 }
 function listNodeKinds(category) {
-  const all = Array.from(kinds.values());
+  const all = Array.from(kinds.values()).map(
+    (k) => withOverride(k)
+  );
   return category ? all.filter((k) => k.category === category) : all;
 }
 function onNodeKindsChanged(listener) {
@@ -10681,6 +10708,7 @@ exports.RichInputPreview = RichInputPreview;
 exports.buildNodeTypes = buildNodeTypes;
 exports.capabilityStatus = capabilityStatus;
 exports.categoryAccent = categoryAccent;
+exports.clearNodeKindOverrides = clearNodeKindOverrides;
 exports.createConnectionValidator = createConnectionValidator;
 exports.declaredRoutes = declaredRoutes;
 exports.decodePause = decodePause;
@@ -10701,6 +10729,7 @@ exports.llmRouterExecutor = llmRouterExecutor;
 exports.nodeConfig = nodeConfig;
 exports.onNodeKindsChanged = onNodeKindsChanged;
 exports.onRichInputAdapterChanged = onRichInputAdapterChanged;
+exports.overrideNodeKind = overrideNodeKind;
 exports.pauseForHuman = pauseForHuman;
 exports.registerBuiltinKinds = registerBuiltinKinds;
 exports.registerLlmClient = registerLlmClient;