@particle-academy/fancy-flow 0.35.0 → 0.36.0

package/dist/registry/index.d.cts

@@ -6,7 +6,7 @@ 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-Ru5jIS5H.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

@@ -6,7 +6,7 @@ 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-Df2-bTXZ.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-Ru5jIS5H.d.cts → registry-BADFn97n.d.cts}

@@ -1,5 +1,17 @@
 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
@@ -20,6 +32,34 @@ declare function registerNodeKind<TC = any, TI = any, TO = any>(definition: Node
  * 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. */
@@ -42,4 +82,4 @@ declare function validateConfig(kind: NodeKindDefinition, config: Record<string,
 /** Default accents per category. */
 declare function categoryAccent(category: string): string;
 
-export { resolveKindId as a, categoryAccent as c, defaultConfigFor as d, getNodeKind as g, kindIds as k, listNodeKinds as l, onNodeKindsChanged as o, registerNodeKind as r, validateConfig as v };
+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-Df2-bTXZ.d.ts → registry-DYbFLEcW.d.ts}

@@ -1,5 +1,17 @@
 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
@@ -20,6 +32,34 @@ declare function registerNodeKind<TC = any, TI = any, TO = any>(definition: Node
  * 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. */
@@ -42,4 +82,4 @@ declare function validateConfig(kind: NodeKindDefinition, config: Record<string,
 /** Default accents per category. */
 declare function categoryAccent(category: string): string;
 
-export { resolveKindId as a, categoryAccent as c, defaultConfigFor as d, getNodeKind as g, kindIds as k, listNodeKinds as l, onNodeKindsChanged as o, registerNodeKind as r, validateConfig as v };
+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;