@particle-academy/fancy-flow 0.7.0 → 0.9.0

package/dist/types-BocBFh6l.d.ts

@@ -0,0 +1,221 @@
+import { ReactNode } from 'react';
+import { P as PortDescriptor, N as NodeExecutor } from './types-BS3Gwnkq.js';
+
+/** Categories used by the palette for grouping. */
+type NodeCategory = "trigger" | "logic" | "data" | "ai" | "io" | "human" | "output" | "custom";
+/**
+ * Tagged-union of config-field shapes the auto-form knows how to render.
+ * Each variant has a `key` (the config object property it writes to) and
+ * a `label`. Hosts can render fully custom panels via the kind's
+ * `renderPanel` instead.
+ */
+type ConfigField = TextConfigField | TextareaConfigField | NumberConfigField | SelectConfigField | SwitchConfigField | JsonConfigField | ExpressionConfigField | CredentialConfigField | RepeaterConfigField | KeyValueConfigField | DocumentConfigField;
+/**
+ * Field types that may appear inside a `repeater` row. Excludes `repeater`
+ * itself — a row of rows has no sane form rendering, and the nesting would
+ * make the config shape hard for an agent to emit.
+ */
+type RepeaterRowField = Exclude<ConfigField, RepeaterConfigField>;
+type ConfigFieldBase = {
+    key: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+};
+type TextConfigField = ConfigFieldBase & {
+    type: "text";
+    placeholder?: string;
+    default?: string;
+    /**
+     * Optional fixed choices. When present the field renders as a select
+     * instead of a free-text input — the same field declaration serves both a
+     * free-form value and a constrained one, so a kind can gain choices later
+     * without changing its `type` or migrating stored config.
+     *
+     * Bare strings are shorthand for `{ value, label: value }`.
+     *
+     * Unlike `type: "select"`, a stored value outside the list is preserved and
+     * shown rather than rejected — choices can change after configs are saved,
+     * and silently dropping an author's value is worse than showing a stale one.
+     */
+    choices?: Array<string | {
+        value: string;
+        label?: string;
+    }>;
+};
+type TextareaConfigField = ConfigFieldBase & {
+    type: "textarea";
+    placeholder?: string;
+    rows?: number;
+    default?: string;
+};
+type NumberConfigField = ConfigFieldBase & {
+    type: "number";
+    min?: number;
+    max?: number;
+    step?: number;
+    default?: number;
+};
+type SelectConfigField = ConfigFieldBase & {
+    type: "select";
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+    default?: string;
+};
+type SwitchConfigField = ConfigFieldBase & {
+    type: "switch";
+    default?: boolean;
+};
+type JsonConfigField = ConfigFieldBase & {
+    type: "json";
+    language?: "json" | "yaml" | "javascript";
+    rows?: number;
+    default?: unknown;
+};
+type ExpressionConfigField = ConfigFieldBase & {
+    type: "expression";
+    /** A short example string shown as placeholder, e.g. "{{ $json.name }}". */
+    example?: string;
+    default?: string;
+};
+type CredentialConfigField = ConfigFieldBase & {
+    type: "credential";
+    /** Logical credential type. The host implements lookup / picker. */
+    credentialType: string;
+};
+/**
+ * Repeater — an editable list of objects, each row authored with its own
+ * sub-schema of ConfigFields. This is what a node kind should reach for
+ * instead of `type: "json"` whenever its config is list-shaped (form field
+ * lists, router routes, tool bindings). Keeping it declarative is what lets
+ * `NodeConfigPanel` stay the single authoring surface for humans AND keeps
+ * the shape introspectable for agents.
+ *
+ * Value shape: `Array<Record<string, unknown>>`.
+ */
+type RepeaterConfigField = ConfigFieldBase & {
+    type: "repeater";
+    /** Schema applied to every row. */
+    fields: RepeaterRowField[];
+    /**
+     * Row field whose value titles the row in the editor. Falls back to the
+     * first field's value, then to "Item N".
+     */
+    titleKey?: string;
+    /** Label for the add button. Default: "Add". */
+    addLabel?: string;
+    /** Bounds enforced by validation + the add/remove controls. */
+    minItems?: number;
+    maxItems?: number;
+    default?: Array<Record<string, unknown>>;
+};
+/**
+ * Key/value map — an editable `Record<string, string>`. Use for filter maps,
+ * input bindings, header maps, and case→port tables.
+ *
+ * Value shape: `Record<string, string>`.
+ */
+type KeyValueConfigField = ConfigFieldBase & {
+    type: "keyvalue";
+    keyLabel?: string;
+    valueLabel?: string;
+    keyPlaceholder?: string;
+    valuePlaceholder?: string;
+    /** Constrain values to a fixed set (e.g. the node's own port ids). */
+    valueOptions?: Array<{
+        value: string;
+        label: string;
+    }>;
+    addLabel?: string;
+    default?: Record<string, string>;
+};
+/**
+ * Document — an opaque rich/structured document stored in node config and
+ * edited by a HOST-SUPPLIED editor, wired through
+ * `NodeConfigPanel`'s `renderDocumentField`.
+ *
+ * fancy-flow deliberately does not know what a document *is* — same
+ * arrangement as `credential`. That keeps rich human-input surfaces (authored
+ * pages, required-reading steps, multi-section forms) possible without the
+ * editor taking a dependency on any particular document model or CMS.
+ */
+type DocumentConfigField = ConfigFieldBase & {
+    type: "document";
+    /**
+     * Logical document format, passed through to the host renderer so one host
+     * can serve several (e.g. "stages", "markdown", "portable-text").
+     */
+    documentType?: string;
+    default?: unknown;
+};
+/**
+ * Port declaration — either a fixed list, or a function of the node's config
+ * for kinds whose branches ARE their config (switch cases, router routes).
+ *
+ * Declaring the function form keeps the canvas ports, the config, and the
+ * ports the runtime activates in lockstep automatically; a static list forces
+ * every consumer to hand-sync `data.outputs` from config in a custom renderer,
+ * and forgetting to breaks routing silently at execution time.
+ */
+type PortSpec<TConfig = unknown> = PortDescriptor[] | ((config: TConfig) => PortDescriptor[]);
+/**
+ * Context passed to a kind's optional `renderBody`. Hosts can read the
+ * resolved config + node id to render whatever fancy-* component they
+ * want inside the node card.
+ */
+type RenderBodyContext<TConfig = unknown> = {
+    nodeId: string;
+    config: TConfig;
+    selected: boolean;
+};
+/**
+ * NodeKindDefinition — declares an authorable node type. Register one
+ * via `registerNodeKind()`. Hosts (and the agent bridge) introspect the
+ * registry to know what's authorable.
+ */
+type NodeKindDefinition<TConfig = Record<string, unknown>, TIn = any, TOut = any> = {
+    /** Stable identifier — used as the xyflow node `type` and the schema export key. */
+    name: string;
+    /** Palette grouping. */
+    category: NodeCategory;
+    /** Display label. */
+    label: string;
+    /** One-line summary surfaced in the palette + agent bridge. */
+    description?: string;
+    /**
+     * Icon rendered in the node header and the palette row. A glyph string is
+     * fine; any ReactNode works, so a brand SVG can be dropped in directly.
+     */
+    icon?: ReactNode;
+    /** Hex / CSS color for the header bar. Falls back to a category default. */
+    accent?: string;
+    /** Declarative form schema for the config panel. */
+    configSchema?: ConfigField[];
+    /** Default config values used when a node of this kind is created. */
+    defaultConfig?: TConfig;
+    /** Input ports. Defaults vary by category. See `PortSpec`. */
+    inputs?: PortSpec<TConfig>;
+    /** Output ports. Defaults vary by category. See `PortSpec`. */
+    outputs?: PortSpec<TConfig>;
+    /** Optional custom body rendered inside the node card. */
+    renderBody?: (ctx: RenderBodyContext<TConfig>) => ReactNode;
+    /**
+     * Optional override for the config panel. Receives the current config and
+     * an onChange to update it. Defaults to the auto-generated form.
+     */
+    renderPanel?: (props: {
+        config: TConfig;
+        onChange: (next: TConfig) => void;
+        nodeId: string;
+    }) => ReactNode;
+    /**
+     * Executor — host-implemented function that runs at flow execution.
+     * Optional: built-in agentic kinds ship without one so the host wires
+     * the actual work (memory store backend, LLM client, HTTP fetcher, etc.).
+     */
+    executor?: NodeExecutor<TIn, TOut>;
+};
+
+export type { ConfigField as C, DocumentConfigField as D, ExpressionConfigField as E, JsonConfigField as J, KeyValueConfigField as K, NodeCategory as N, PortSpec as P, RenderBodyContext as R, SelectConfigField as S, TextConfigField as T, NodeKindDefinition as a, CredentialConfigField as b, NumberConfigField as c, RepeaterConfigField as d, RepeaterRowField as e, SwitchConfigField as f, TextareaConfigField as g };

package/dist/types-DKqaUjF_.d.cts

@@ -0,0 +1,221 @@
+import { ReactNode } from 'react';
+import { P as PortDescriptor, N as NodeExecutor } from './types-BS3Gwnkq.cjs';
+
+/** Categories used by the palette for grouping. */
+type NodeCategory = "trigger" | "logic" | "data" | "ai" | "io" | "human" | "output" | "custom";
+/**
+ * Tagged-union of config-field shapes the auto-form knows how to render.
+ * Each variant has a `key` (the config object property it writes to) and
+ * a `label`. Hosts can render fully custom panels via the kind's
+ * `renderPanel` instead.
+ */
+type ConfigField = TextConfigField | TextareaConfigField | NumberConfigField | SelectConfigField | SwitchConfigField | JsonConfigField | ExpressionConfigField | CredentialConfigField | RepeaterConfigField | KeyValueConfigField | DocumentConfigField;
+/**
+ * Field types that may appear inside a `repeater` row. Excludes `repeater`
+ * itself — a row of rows has no sane form rendering, and the nesting would
+ * make the config shape hard for an agent to emit.
+ */
+type RepeaterRowField = Exclude<ConfigField, RepeaterConfigField>;
+type ConfigFieldBase = {
+    key: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+};
+type TextConfigField = ConfigFieldBase & {
+    type: "text";
+    placeholder?: string;
+    default?: string;
+    /**
+     * Optional fixed choices. When present the field renders as a select
+     * instead of a free-text input — the same field declaration serves both a
+     * free-form value and a constrained one, so a kind can gain choices later
+     * without changing its `type` or migrating stored config.
+     *
+     * Bare strings are shorthand for `{ value, label: value }`.
+     *
+     * Unlike `type: "select"`, a stored value outside the list is preserved and
+     * shown rather than rejected — choices can change after configs are saved,
+     * and silently dropping an author's value is worse than showing a stale one.
+     */
+    choices?: Array<string | {
+        value: string;
+        label?: string;
+    }>;
+};
+type TextareaConfigField = ConfigFieldBase & {
+    type: "textarea";
+    placeholder?: string;
+    rows?: number;
+    default?: string;
+};
+type NumberConfigField = ConfigFieldBase & {
+    type: "number";
+    min?: number;
+    max?: number;
+    step?: number;
+    default?: number;
+};
+type SelectConfigField = ConfigFieldBase & {
+    type: "select";
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+    default?: string;
+};
+type SwitchConfigField = ConfigFieldBase & {
+    type: "switch";
+    default?: boolean;
+};
+type JsonConfigField = ConfigFieldBase & {
+    type: "json";
+    language?: "json" | "yaml" | "javascript";
+    rows?: number;
+    default?: unknown;
+};
+type ExpressionConfigField = ConfigFieldBase & {
+    type: "expression";
+    /** A short example string shown as placeholder, e.g. "{{ $json.name }}". */
+    example?: string;
+    default?: string;
+};
+type CredentialConfigField = ConfigFieldBase & {
+    type: "credential";
+    /** Logical credential type. The host implements lookup / picker. */
+    credentialType: string;
+};
+/**
+ * Repeater — an editable list of objects, each row authored with its own
+ * sub-schema of ConfigFields. This is what a node kind should reach for
+ * instead of `type: "json"` whenever its config is list-shaped (form field
+ * lists, router routes, tool bindings). Keeping it declarative is what lets
+ * `NodeConfigPanel` stay the single authoring surface for humans AND keeps
+ * the shape introspectable for agents.
+ *
+ * Value shape: `Array<Record<string, unknown>>`.
+ */
+type RepeaterConfigField = ConfigFieldBase & {
+    type: "repeater";
+    /** Schema applied to every row. */
+    fields: RepeaterRowField[];
+    /**
+     * Row field whose value titles the row in the editor. Falls back to the
+     * first field's value, then to "Item N".
+     */
+    titleKey?: string;
+    /** Label for the add button. Default: "Add". */
+    addLabel?: string;
+    /** Bounds enforced by validation + the add/remove controls. */
+    minItems?: number;
+    maxItems?: number;
+    default?: Array<Record<string, unknown>>;
+};
+/**
+ * Key/value map — an editable `Record<string, string>`. Use for filter maps,
+ * input bindings, header maps, and case→port tables.
+ *
+ * Value shape: `Record<string, string>`.
+ */
+type KeyValueConfigField = ConfigFieldBase & {
+    type: "keyvalue";
+    keyLabel?: string;
+    valueLabel?: string;
+    keyPlaceholder?: string;
+    valuePlaceholder?: string;
+    /** Constrain values to a fixed set (e.g. the node's own port ids). */
+    valueOptions?: Array<{
+        value: string;
+        label: string;
+    }>;
+    addLabel?: string;
+    default?: Record<string, string>;
+};
+/**
+ * Document — an opaque rich/structured document stored in node config and
+ * edited by a HOST-SUPPLIED editor, wired through
+ * `NodeConfigPanel`'s `renderDocumentField`.
+ *
+ * fancy-flow deliberately does not know what a document *is* — same
+ * arrangement as `credential`. That keeps rich human-input surfaces (authored
+ * pages, required-reading steps, multi-section forms) possible without the
+ * editor taking a dependency on any particular document model or CMS.
+ */
+type DocumentConfigField = ConfigFieldBase & {
+    type: "document";
+    /**
+     * Logical document format, passed through to the host renderer so one host
+     * can serve several (e.g. "stages", "markdown", "portable-text").
+     */
+    documentType?: string;
+    default?: unknown;
+};
+/**
+ * Port declaration — either a fixed list, or a function of the node's config
+ * for kinds whose branches ARE their config (switch cases, router routes).
+ *
+ * Declaring the function form keeps the canvas ports, the config, and the
+ * ports the runtime activates in lockstep automatically; a static list forces
+ * every consumer to hand-sync `data.outputs` from config in a custom renderer,
+ * and forgetting to breaks routing silently at execution time.
+ */
+type PortSpec<TConfig = unknown> = PortDescriptor[] | ((config: TConfig) => PortDescriptor[]);
+/**
+ * Context passed to a kind's optional `renderBody`. Hosts can read the
+ * resolved config + node id to render whatever fancy-* component they
+ * want inside the node card.
+ */
+type RenderBodyContext<TConfig = unknown> = {
+    nodeId: string;
+    config: TConfig;
+    selected: boolean;
+};
+/**
+ * NodeKindDefinition — declares an authorable node type. Register one
+ * via `registerNodeKind()`. Hosts (and the agent bridge) introspect the
+ * registry to know what's authorable.
+ */
+type NodeKindDefinition<TConfig = Record<string, unknown>, TIn = any, TOut = any> = {
+    /** Stable identifier — used as the xyflow node `type` and the schema export key. */
+    name: string;
+    /** Palette grouping. */
+    category: NodeCategory;
+    /** Display label. */
+    label: string;
+    /** One-line summary surfaced in the palette + agent bridge. */
+    description?: string;
+    /**
+     * Icon rendered in the node header and the palette row. A glyph string is
+     * fine; any ReactNode works, so a brand SVG can be dropped in directly.
+     */
+    icon?: ReactNode;
+    /** Hex / CSS color for the header bar. Falls back to a category default. */
+    accent?: string;
+    /** Declarative form schema for the config panel. */
+    configSchema?: ConfigField[];
+    /** Default config values used when a node of this kind is created. */
+    defaultConfig?: TConfig;
+    /** Input ports. Defaults vary by category. See `PortSpec`. */
+    inputs?: PortSpec<TConfig>;
+    /** Output ports. Defaults vary by category. See `PortSpec`. */
+    outputs?: PortSpec<TConfig>;
+    /** Optional custom body rendered inside the node card. */
+    renderBody?: (ctx: RenderBodyContext<TConfig>) => ReactNode;
+    /**
+     * Optional override for the config panel. Receives the current config and
+     * an onChange to update it. Defaults to the auto-generated form.
+     */
+    renderPanel?: (props: {
+        config: TConfig;
+        onChange: (next: TConfig) => void;
+        nodeId: string;
+    }) => ReactNode;
+    /**
+     * Executor — host-implemented function that runs at flow execution.
+     * Optional: built-in agentic kinds ship without one so the host wires
+     * the actual work (memory store backend, LLM client, HTTP fetcher, etc.).
+     */
+    executor?: NodeExecutor<TIn, TOut>;
+};
+
+export type { ConfigField as C, DocumentConfigField as D, ExpressionConfigField as E, JsonConfigField as J, KeyValueConfigField as K, NodeCategory as N, PortSpec as P, RenderBodyContext as R, SelectConfigField as S, TextConfigField as T, NodeKindDefinition as a, CredentialConfigField as b, NumberConfigField as c, RepeaterConfigField as d, RepeaterRowField as e, SwitchConfigField as f, TextareaConfigField as g };

package/dist/ux.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/registry/registry.ts","../src/ux.ts"],"names":["createEffectDispatcher","useMemo"],"mappings":";;;;;;;;AAEA,IAAM,KAAA,uBAAY,GAAA,EAA+C;AACjE,IAAM,SAAA,uBAAgB,GAAA,EAAgB;AAO/B,SAAS,iBACd,UAAA,EACY;AACZ,EAAA,KAAA,CAAM,GAAA,CAAI,UAAA,CAAW,IAAA,EAAM,UAA+C,CAAA;AAC1E,EAAA,MAAA,EAAO;AACP,EAAA,OAAO,MAAM;AACX,IAAA,IAAI,KAAA,CAAM,GAAA,CAAI,UAAA,CAAW,IAAI,MAAO,UAAA,EAAoB;AACtD,MAAA,KAAA,CAAM,MAAA,CAAO,WAAW,IAAI,CAAA;AAC5B,MAAA,MAAA,EAAO;AAAA,IACT;AAAA,EACF,CAAA;AACF;AAmBA,SAAS,MAAA,GAAe;AACtB,EAAA,KAAA,MAAW,CAAA,IAAK,WAAW,CAAA,EAAE;AAC/B;;;AC+BA,IAAM,cAAA,GAAiB,CAAC,IAAA,KAAiB,CAAA,GAAA,EAAM,IAAI,CAAA,CAAA;AAG5C,SAAS,mBAAmB,OAAA,EAA4C;AAC7E,EAAA,MAAM;AAAA,IACJ,OAAA;AAAA,IACA,OAAO,EAAC;AAAA,IACR,KAAA,GAAQ,EAAE,EAAA,EAAI,MAAA,EAAQ,QAAQ,MAAA,EAAO;AAAA,IACrC,OAAA,GAAU;AAAA,GACZ,GAAI,OAAA;AAEJ,EAAA,MAAM,aAAaA,sCAAA,CAAuB,OAAA,EAAS,EAAE,KAAA,EAAO,UAAA,EAAY,MAAM,CAAA;AAE9E,EAAA,MAAM,YAA8B,EAAC;AACrC,EAAA,KAAA,MAAW,IAAA,IAAQ,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,EAAG;AACvC,IAAA,SAAA,CAAU,QAAQ,IAAI,CAAC,IAAI,OAAO,EAAE,MAAK,KAA0B;AACjE,MAAA,MAAM,MAAA,GAAU,IAAA,CAAK,IAAA,EAA2D,MAAA,IAAU,EAAC;AAC3F,MAAA,MAAM,MAAA,GAAS,MAAM,UAAA,CAAW,QAAA,CAAS,MAAM,MAAM,CAAA;AAKrD,MAAA,IAAI,UAAU,OAAO,MAAA,KAAW,aAAa,QAAA,IAAY,MAAA,IAAU,YAAY,MAAA,CAAA,EAAS;AACtF,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,OAAO,EAAE,MAAA,EAAQ,IAAA,EAAM,MAAA,EAAO;AAAA,IAChC,CAAA;AAAA,EACF;AAEA,EAAA,MAAM,gBAAgB,MAAM;AAC1B,IAAA,KAAA,MAAW,IAAA,IAAQ,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,EAAG;AACvC,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,IAAI,CAAA,IAAK,EAAC;AACzB,MAAA,gBAAA,CAAiB;AAAA,QACf,IAAA,EAAM,QAAQ,IAAI,CAAA;AAAA,QAClB,QAAA,EAAU,EAAE,QAAA,IAAY,QAAA;AAAA,QACxB,KAAA,EAAO,EAAE,KAAA,IAAS,IAAA;AAAA,QAClB,WAAA,EAAa,CAAA,CAAE,WAAA,IAAe,CAAA,uBAAA,EAA0B,IAAI,CAAA,CAAA,CAAA;AAAA,QAC5D,IAAA,EAAM,EAAE,IAAA,IAAQ,QAAA;AAAA,QAChB,MAAA,EAAQ,EAAE,MAAA,IAAU,SAAA;AAAA,QACpB,MAAA,EAAQ,CAAC,EAAE,EAAA,EAAI,MAAM,CAAA;AAAA,QACrB,SAAS,EAAC;AAAA,QACV,cAAc,CAAA,CAAE;AAAA,OACjB,CAAA;AAAA,IACH;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,SAAA;AAAA,IACA,UAAU,UAAA,CAAW,QAAA;AAAA,IACrB,aAAa,UAAA,CAAW,KAAA;AAAA,IACxB;AAAA,GACF;AACF;AAMO,SAAS,gBAAgB,OAAA,EAA4C;AAC1E,EAAA,MAAM,MAAM,CAAA,EAAG,MAAA,CAAO,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA,CAAE,IAAA,EAAK,CAAE,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA,EAAI,OAAA,CAAQ,KAAA,EAAO,MAAM,MAAM,CAAA,CAAA;AAE3F,EAAA,OAAOC,cAAQ,MAAM,kBAAA,CAAmB,OAAO,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AACzD","file":"ux.cjs","sourcesContent":["import type { ConfigField, NodeKindDefinition } from \"./types\";\n\nconst kinds = new Map<string, NodeKindDefinition<any, any, any>>();\nconst listeners = new Set<() => void>();\n\n/**\n * registerNodeKind — install a node kind in the global registry. Returns\n * an `unregister` function. Calling with the same name replaces the prior\n * registration (handy for HMR).\n */\nexport function registerNodeKind<TC = any, TI = any, TO = any>(\n  definition: NodeKindDefinition<TC, TI, TO>,\n): () => void {\n  kinds.set(definition.name, definition as NodeKindDefinition<any, any, any>);\n  notify();\n  return () => {\n    if (kinds.get(definition.name) === (definition as any)) {\n      kinds.delete(definition.name);\n      notify();\n    }\n  };\n}\n\n/** Get a single kind by name, or null. */\nexport function getNodeKind(name: string): NodeKindDefinition | null {\n  return (kinds.get(name) as NodeKindDefinition) ?? null;\n}\n\n/** List every registered kind, optionally filtered by category. */\nexport function listNodeKinds(category?: string): NodeKindDefinition[] {\n  const all = Array.from(kinds.values()) as NodeKindDefinition[];\n  return category ? all.filter((k) => k.category === category) : all;\n}\n\n/** Subscribe to registry changes. Returns an unsubscribe function. */\nexport function onNodeKindsChanged(listener: () => void): () => void {\n  listeners.add(listener);\n  return () => listeners.delete(listener);\n}\n\nfunction notify(): void {\n  for (const l of listeners) l();\n}\n\n/** Fill in defaults from a kind's configSchema for newly-created nodes. */\nexport function defaultConfigFor(kind: NodeKindDefinition): Record<string, unknown> {\n  const fromKind = kind.defaultConfig ? { ...(kind.defaultConfig as Record<string, unknown>) } : {};\n  for (const field of kind.configSchema ?? []) {\n    if (fromKind[field.key] !== undefined) continue;\n    if (\"default\" in field && (field as any).default !== undefined) {\n      fromKind[field.key] = (field as any).default;\n    }\n  }\n  return fromKind;\n}\n\n/**\n * Validate a config object against a kind's schema. Returns an array of\n * issues (empty = valid). Validation is intentionally light — type\n * coercion + required-field checks. Hosts can layer Zod / Ajv on top.\n */\nexport function validateConfig(\n  kind: NodeKindDefinition,\n  config: Record<string, unknown>,\n): Array<{ key: string; message: string }> {\n  const issues: Array<{ key: string; message: string }> = [];\n  for (const field of kind.configSchema ?? []) {\n    const value = config[field.key];\n    if (field.required && (value === undefined || value === null || value === \"\")) {\n      issues.push({ key: field.key, message: `${field.label} is required` });\n      continue;\n    }\n    if (value === undefined || value === null) continue;\n    const issue = validateField(field, value);\n    if (issue) issues.push({ key: field.key, message: issue });\n  }\n  return issues;\n}\n\nfunction validateField(field: ConfigField, value: unknown): string | null {\n  switch (field.type) {\n    case \"text\":\n    case \"textarea\":\n    case \"expression\":\n    case \"credential\":\n      return typeof value === \"string\" ? null : `${field.label} must be a string`;\n    case \"number\": {\n      if (typeof value !== \"number\" || !Number.isFinite(value)) return `${field.label} must be a number`;\n      if (field.min !== undefined && value < field.min) return `${field.label} must be >= ${field.min}`;\n      if (field.max !== undefined && value > field.max) return `${field.label} must be <= ${field.max}`;\n      return null;\n    }\n    case \"switch\":\n      return typeof value === \"boolean\" ? null : `${field.label} must be a boolean`;\n    case \"select\": {\n      const allowed = field.options.map((o) => o.value);\n      return allowed.includes(String(value)) ? null : `${field.label} must be one of ${allowed.join(\", \")}`;\n    }\n    case \"json\":\n      return null; // permissive — just JSON-shaped\n    default:\n      return null;\n  }\n}\n\n/** Default accents per category. */\nexport function categoryAccent(category: string): string {\n  switch (category) {\n    case \"trigger\": return \"#10b981\";\n    case \"logic\":   return \"#f59e0b\";\n    case \"data\":    return \"#0ea5e9\";\n    case \"ai\":      return \"#8b5cf6\";\n    case \"io\":      return \"#3b82f6\";\n    case \"human\":   return \"#ec4899\";\n    case \"output\":  return \"#a855f7\";\n    default:        return \"#71717a\";\n  }\n}\n","/**\n * FlowRunnerUx — the **flow-driven UX** bridge. The headless counterpart to\n * agent-integrations: where that wires an *agent* to host UI surfaces, this\n * wires a *running flow* to host UX. Both share the same primitives from\n * `@particle-academy/fancy-auto-common` (activity bus, effect dispatch).\n *\n * The host registers named UX effects (toast, navigate, confirm, …); this turns\n * each into a flow executor keyed by a node kind (`ux_<effect>` by default), so\n * dropping a `ux_toast` node into a `<FlowEditor>` and running it fires the\n * host's toast. Every dispatch broadcasts an `AutoActivityEvent` (source:\"flow\")\n * for presence / logging. Human-in-the-loop is free: an effect that returns a\n * Promise (e.g. an approval dialog) pauses the run until the user resolves it.\n *\n *   const ux = createFlowRunnerUx({\n *     effects: {\n *       toast:   ({ message }) => toast({ title: message }),\n *       navigate:({ to })      => router.visit(to),\n *       confirm: ({ prompt })  => new Promise(res => openDialog(prompt, res)), // pauses the run\n *     },\n *   });\n *   ux.registerKinds();                       // adds ux_toast / ux_navigate / ux_confirm to the palette\n *   <FlowEditor initial={graph} executors={ux.executors} />\n */\nimport { useMemo } from \"react\";\nimport {\n  createEffectDispatcher,\n  type DispatchActor,\n  type EffectRegistry,\n} from \"@particle-academy/fancy-auto-common\";\nimport { registerNodeKind } from \"./registry/registry\";\nimport type { ConfigField, NodeCategory } from \"./registry/types\";\nimport type { ExecutorRegistry, FlowNode } from \"./types\";\n\nexport type { AutoActivityEvent } from \"@particle-academy/fancy-auto-common\";\n\n/** Per-effect presentation for the palette node kind that drives it. */\nexport type UxEffectMeta = {\n  /** Palette label. Default: the effect name. */\n  label?: string;\n  /** One-line palette description. */\n  description?: string;\n  /** Emoji / glyph for the node header. */\n  icon?: string;\n  /** Header accent color. */\n  accent?: string;\n  /** Palette grouping. Default \"output\". */\n  category?: NodeCategory;\n  /** Config form fields = the effect's params. */\n  configSchema?: ConfigField[];\n};\n\nexport type FlowRunnerUxOptions = {\n  /** Named host UX effects the flow can invoke. */\n  effects: EffectRegistry;\n  /** Optional per-effect palette metadata (used by `registerKinds`). */\n  meta?: Record<string, UxEffectMeta>;\n  /** Identifies the flow run in emitted activity. Default `{ id: \"flow\", source: \"flow\" }`. */\n  actor?: DispatchActor;\n  /** Map an effect name to its node-kind name. Default `ux_<effect>`. */\n  kindFor?: (effectName: string) => string;\n};\n\nexport type FlowRunnerUx = {\n  /** Executor registry to hand to `<FlowEditor executors>` or `runFlow`. */\n  executors: ExecutorRegistry;\n  /** Invoke an effect imperatively (also emits activity). */\n  dispatch: <R = unknown>(name: string, params?: unknown) => Promise<R>;\n  /** All effect names. */\n  effectNames: () => string[];\n  /** Register a palette node kind per effect (`ux_<effect>`). Idempotent. */\n  registerKinds: () => void;\n};\n\nconst defaultKindFor = (name: string) => `ux_${name}`;\n\n/** Build a FlowRunnerUx from a set of host effects. Framework-agnostic. */\nexport function createFlowRunnerUx(options: FlowRunnerUxOptions): FlowRunnerUx {\n  const {\n    effects,\n    meta = {},\n    actor = { id: \"flow\", source: \"flow\" },\n    kindFor = defaultKindFor,\n  } = options;\n\n  const dispatcher = createEffectDispatcher(effects, { actor, targetKind: \"ux\" });\n\n  const executors: ExecutorRegistry = {};\n  for (const name of Object.keys(effects)) {\n    executors[kindFor(name)] = async ({ node }: { node: FlowNode }) => {\n      const params = (node.data as { config?: Record<string, unknown> } | undefined)?.config ?? {};\n      const result = await dispatcher.dispatch(name, params);\n      // A UX effect can drive flow control: if it returns the decision sugar\n      // (`{ branch }` or `{ __port }`) — e.g. an interactive \"choose\" effect that\n      // awaits a human pick and returns the chosen port — pass it straight\n      // through so runFlow routes on it. Otherwise wrap the result for the feed.\n      if (result && typeof result === \"object\" && (\"branch\" in result || \"__port\" in result)) {\n        return result;\n      }\n      return { effect: name, result };\n    };\n  }\n\n  const registerKinds = () => {\n    for (const name of Object.keys(effects)) {\n      const m = meta[name] ?? {};\n      registerNodeKind({\n        name: kindFor(name),\n        category: m.category ?? \"output\",\n        label: m.label ?? name,\n        description: m.description ?? `Flow-driven UX effect: ${name}.`,\n        icon: m.icon ?? \"✨\",\n        accent: m.accent ?? \"#8b5cf6\",\n        inputs: [{ id: \"in\" }],\n        outputs: [],\n        configSchema: m.configSchema,\n      });\n    }\n  };\n\n  return {\n    executors,\n    dispatch: dispatcher.dispatch as FlowRunnerUx[\"dispatch\"],\n    effectNames: dispatcher.names,\n    registerKinds,\n  };\n}\n\n/**\n * React hook form — memoizes on the effect-name set + actor id so the returned\n * executors keep a stable identity across renders.\n */\nexport function useFlowRunnerUx(options: FlowRunnerUxOptions): FlowRunnerUx {\n  const key = `${Object.keys(options.effects).sort().join(\",\")}|${options.actor?.id ?? \"flow\"}`;\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  return useMemo(() => createFlowRunnerUx(options), [key]);\n}\n"]}
+{"version":3,"sources":["../src/registry/registry.ts","../src/ux.ts"],"names":["createEffectDispatcher","useMemo"],"mappings":"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","file":"ux.cjs","sourcesContent":["import type { ConfigField, NodeKindDefinition } from \"./types\";\n\nconst kinds = new Map<string, NodeKindDefinition<any, any, any>>();\nconst listeners = new Set<() => void>();\n\n/**\n * registerNodeKind — install a node kind in the global registry. Returns\n * an `unregister` function. Calling with the same name replaces the prior\n * registration (handy for HMR).\n */\nexport function registerNodeKind<TC = any, TI = any, TO = any>(\n  definition: NodeKindDefinition<TC, TI, TO>,\n): () => void {\n  kinds.set(definition.name, definition as NodeKindDefinition<any, any, any>);\n  notify();\n  return () => {\n    if (kinds.get(definition.name) === (definition as any)) {\n      kinds.delete(definition.name);\n      notify();\n    }\n  };\n}\n\n/** Get a single kind by name, or null. */\nexport function getNodeKind(name: string): NodeKindDefinition | null {\n  return (kinds.get(name) as NodeKindDefinition) ?? null;\n}\n\n/** List every registered kind, optionally filtered by category. */\nexport function listNodeKinds(category?: string): NodeKindDefinition[] {\n  const all = Array.from(kinds.values()) as NodeKindDefinition[];\n  return category ? all.filter((k) => k.category === category) : all;\n}\n\n/** Subscribe to registry changes. Returns an unsubscribe function. */\nexport function onNodeKindsChanged(listener: () => void): () => void {\n  listeners.add(listener);\n  return () => listeners.delete(listener);\n}\n\nfunction notify(): void {\n  for (const l of listeners) l();\n}\n\n/** Fill in defaults from a kind's configSchema for newly-created nodes. */\nexport function defaultConfigFor(kind: NodeKindDefinition): Record<string, unknown> {\n  const fromKind = kind.defaultConfig ? { ...(kind.defaultConfig as Record<string, unknown>) } : {};\n  for (const field of kind.configSchema ?? []) {\n    if (fromKind[field.key] !== undefined) continue;\n    if (\"default\" in field && (field as any).default !== undefined) {\n      fromKind[field.key] = (field as any).default;\n    }\n  }\n  return fromKind;\n}\n\n/**\n * Validate a config object against a kind's schema. Returns an array of\n * issues (empty = valid). Validation is intentionally light — type\n * coercion + required-field checks. Hosts can layer Zod / Ajv on top.\n */\nexport function validateConfig(\n  kind: NodeKindDefinition,\n  config: Record<string, unknown>,\n): Array<{ key: string; message: string }> {\n  const issues: Array<{ key: string; message: string }> = [];\n  for (const field of kind.configSchema ?? []) {\n    const value = config[field.key];\n    if (field.required && (value === undefined || value === null || value === \"\")) {\n      issues.push({ key: field.key, message: `${field.label} is required` });\n      continue;\n    }\n    if (value === undefined || value === null) continue;\n    const issue = validateField(field, value);\n    if (issue) issues.push({ key: field.key, message: issue });\n  }\n  return issues;\n}\n\nfunction validateField(field: ConfigField, value: unknown): string | null {\n  switch (field.type) {\n    case \"text\":\n    case \"textarea\":\n    case \"expression\":\n    case \"credential\":\n      return typeof value === \"string\" ? null : `${field.label} must be a string`;\n    case \"number\": {\n      if (typeof value !== \"number\" || !Number.isFinite(value)) return `${field.label} must be a number`;\n      if (field.min !== undefined && value < field.min) return `${field.label} must be >= ${field.min}`;\n      if (field.max !== undefined && value > field.max) return `${field.label} must be <= ${field.max}`;\n      return null;\n    }\n    case \"switch\":\n      return typeof value === \"boolean\" ? null : `${field.label} must be a boolean`;\n    case \"select\": {\n      const allowed = field.options.map((o) => o.value);\n      return allowed.includes(String(value)) ? null : `${field.label} must be one of ${allowed.join(\", \")}`;\n    }\n    case \"json\":\n      return null; // permissive — just JSON-shaped\n    case \"repeater\": {\n      if (!Array.isArray(value)) return `${field.label} must be a list`;\n      if (field.minItems !== undefined && value.length < field.minItems) {\n        return `${field.label} needs at least ${field.minItems}`;\n      }\n      if (field.maxItems !== undefined && value.length > field.maxItems) {\n        return `${field.label} allows at most ${field.maxItems}`;\n      }\n      // Surface the first offending row so the author knows WHICH one.\n      for (let i = 0; i < value.length; i++) {\n        const row = value[i];\n        if (!row || typeof row !== \"object\" || Array.isArray(row)) {\n          return `${field.label} item ${i + 1} must be an object`;\n        }\n        for (const sub of field.fields) {\n          const cell = (row as Record<string, unknown>)[sub.key];\n          if (sub.required && (cell === undefined || cell === null || cell === \"\")) {\n            return `${field.label} item ${i + 1}: ${sub.label} is required`;\n          }\n          if (cell === undefined || cell === null) continue;\n          const issue = validateField(sub, cell);\n          if (issue) return `${field.label} item ${i + 1}: ${issue}`;\n        }\n      }\n      return null;\n    }\n    case \"keyvalue\": {\n      if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n        return `${field.label} must be a key/value map`;\n      }\n      const allowed = field.valueOptions?.map((o) => o.value);\n      for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n        if (typeof v !== \"string\") return `${field.label}: \"${k}\" must be a string`;\n        if (allowed && !allowed.includes(v)) {\n          return `${field.label}: \"${k}\" must be one of ${allowed.join(\", \")}`;\n        }\n      }\n      return null;\n    }\n    case \"document\":\n      return null; // opaque to fancy-flow — the host's editor owns its shape\n    default:\n      return null;\n  }\n}\n\n/** Default accents per category. */\nexport function categoryAccent(category: string): string {\n  switch (category) {\n    case \"trigger\": return \"#10b981\";\n    case \"logic\":   return \"#f59e0b\";\n    case \"data\":    return \"#0ea5e9\";\n    case \"ai\":      return \"#8b5cf6\";\n    case \"io\":      return \"#3b82f6\";\n    case \"human\":   return \"#ec4899\";\n    case \"output\":  return \"#a855f7\";\n    default:        return \"#71717a\";\n  }\n}\n","/**\n * FlowRunnerUx — the **flow-driven UX** bridge. The headless counterpart to\n * agent-integrations: where that wires an *agent* to host UI surfaces, this\n * wires a *running flow* to host UX. Both share the same primitives from\n * `@particle-academy/fancy-auto-common` (activity bus, effect dispatch).\n *\n * The host registers named UX effects (toast, navigate, confirm, …); this turns\n * each into a flow executor keyed by a node kind (`ux_<effect>` by default), so\n * dropping a `ux_toast` node into a `<FlowEditor>` and running it fires the\n * host's toast. Every dispatch broadcasts an `AutoActivityEvent` (source:\"flow\")\n * for presence / logging. Human-in-the-loop is free: an effect that returns a\n * Promise (e.g. an approval dialog) pauses the run until the user resolves it.\n *\n *   const ux = createFlowRunnerUx({\n *     effects: {\n *       toast:   ({ message }) => toast({ title: message }),\n *       navigate:({ to })      => router.visit(to),\n *       confirm: ({ prompt })  => new Promise(res => openDialog(prompt, res)), // pauses the run\n *     },\n *   });\n *   ux.registerKinds();                       // adds ux_toast / ux_navigate / ux_confirm to the palette\n *   <FlowEditor initial={graph} executors={ux.executors} />\n */\nimport { useMemo } from \"react\";\nimport {\n  createEffectDispatcher,\n  type DispatchActor,\n  type EffectRegistry,\n} from \"@particle-academy/fancy-auto-common\";\nimport { registerNodeKind } from \"./registry/registry\";\nimport type { ConfigField, NodeCategory } from \"./registry/types\";\nimport type { ExecutorRegistry, FlowNode } from \"./types\";\n\nexport type { AutoActivityEvent } from \"@particle-academy/fancy-auto-common\";\n\n/** Per-effect presentation for the palette node kind that drives it. */\nexport type UxEffectMeta = {\n  /** Palette label. Default: the effect name. */\n  label?: string;\n  /** One-line palette description. */\n  description?: string;\n  /** Emoji / glyph for the node header. */\n  icon?: string;\n  /** Header accent color. */\n  accent?: string;\n  /** Palette grouping. Default \"output\". */\n  category?: NodeCategory;\n  /** Config form fields = the effect's params. */\n  configSchema?: ConfigField[];\n};\n\nexport type FlowRunnerUxOptions = {\n  /** Named host UX effects the flow can invoke. */\n  effects: EffectRegistry;\n  /** Optional per-effect palette metadata (used by `registerKinds`). */\n  meta?: Record<string, UxEffectMeta>;\n  /** Identifies the flow run in emitted activity. Default `{ id: \"flow\", source: \"flow\" }`. */\n  actor?: DispatchActor;\n  /** Map an effect name to its node-kind name. Default `ux_<effect>`. */\n  kindFor?: (effectName: string) => string;\n};\n\nexport type FlowRunnerUx = {\n  /** Executor registry to hand to `<FlowEditor executors>` or `runFlow`. */\n  executors: ExecutorRegistry;\n  /** Invoke an effect imperatively (also emits activity). */\n  dispatch: <R = unknown>(name: string, params?: unknown) => Promise<R>;\n  /** All effect names. */\n  effectNames: () => string[];\n  /** Register a palette node kind per effect (`ux_<effect>`). Idempotent. */\n  registerKinds: () => void;\n};\n\nconst defaultKindFor = (name: string) => `ux_${name}`;\n\n/** Build a FlowRunnerUx from a set of host effects. Framework-agnostic. */\nexport function createFlowRunnerUx(options: FlowRunnerUxOptions): FlowRunnerUx {\n  const {\n    effects,\n    meta = {},\n    actor = { id: \"flow\", source: \"flow\" },\n    kindFor = defaultKindFor,\n  } = options;\n\n  const dispatcher = createEffectDispatcher(effects, { actor, targetKind: \"ux\" });\n\n  const executors: ExecutorRegistry = {};\n  for (const name of Object.keys(effects)) {\n    executors[kindFor(name)] = async ({ node }: { node: FlowNode }) => {\n      const params = (node.data as { config?: Record<string, unknown> } | undefined)?.config ?? {};\n      const result = await dispatcher.dispatch(name, params);\n      // A UX effect can drive flow control: if it returns the decision sugar\n      // (`{ branch }` or `{ __port }`) — e.g. an interactive \"choose\" effect that\n      // awaits a human pick and returns the chosen port — pass it straight\n      // through so runFlow routes on it. Otherwise wrap the result for the feed.\n      if (result && typeof result === \"object\" && (\"branch\" in result || \"__port\" in result)) {\n        return result;\n      }\n      return { effect: name, result };\n    };\n  }\n\n  const registerKinds = () => {\n    for (const name of Object.keys(effects)) {\n      const m = meta[name] ?? {};\n      registerNodeKind({\n        name: kindFor(name),\n        category: m.category ?? \"output\",\n        label: m.label ?? name,\n        description: m.description ?? `Flow-driven UX effect: ${name}.`,\n        icon: m.icon ?? \"✨\",\n        accent: m.accent ?? \"#8b5cf6\",\n        inputs: [{ id: \"in\" }],\n        outputs: [],\n        configSchema: m.configSchema,\n      });\n    }\n  };\n\n  return {\n    executors,\n    dispatch: dispatcher.dispatch as FlowRunnerUx[\"dispatch\"],\n    effectNames: dispatcher.names,\n    registerKinds,\n  };\n}\n\n/**\n * React hook form — memoizes on the effect-name set + actor id so the returned\n * executors keep a stable identity across renders.\n */\nexport function useFlowRunnerUx(options: FlowRunnerUxOptions): FlowRunnerUx {\n  const key = `${Object.keys(options.effects).sort().join(\",\")}|${options.actor?.id ?? \"flow\"}`;\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  return useMemo(() => createFlowRunnerUx(options), [key]);\n}\n"]}

package/dist/ux.d.cts

@@ -1,6 +1,6 @@
 import { EffectRegistry, DispatchActor } from '@particle-academy/fancy-auto-common';
 export { AutoActivityEvent } from '@particle-academy/fancy-auto-common';
-import { N as NodeCategory, C as ConfigField } from './types-C0wdN6QX.cjs';
+import { N as NodeCategory, C as ConfigField } from './types-DKqaUjF_.cjs';
 import { E as ExecutorRegistry } from './types-BS3Gwnkq.cjs';
 import 'react';
 import '@xyflow/react';

package/dist/ux.d.ts

@@ -1,6 +1,6 @@
 import { EffectRegistry, DispatchActor } from '@particle-academy/fancy-auto-common';
 export { AutoActivityEvent } from '@particle-academy/fancy-auto-common';
-import { N as NodeCategory, C as ConfigField } from './types-DnMe9Vsf.js';
+import { N as NodeCategory, C as ConfigField } from './types-BocBFh6l.js';
 import { E as ExecutorRegistry } from './types-BS3Gwnkq.js';
 import 'react';
 import '@xyflow/react';

package/dist/ux.js

@@ -1,4 +1,4 @@
-import { registerNodeKind } from './chunk-WNVBXXOL.js';
+import { registerNodeKind } from './chunk-CPSOC27D.js';
 import { useMemo } from 'react';
 import { createEffectDispatcher } from '@particle-academy/fancy-auto-common';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/fancy-flow",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Workflow editor + runner. Six built-in node kits (trigger / action / decision / output / note / subgraph), tokenized theme, topological execution with per-node status. React-flow bundled; consumers npm install fancy-flow and get nothing extra.",
   "repository": {
     "type": "git",
@@ -81,13 +81,13 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@particle-academy/fancy-auto-common": "^0.1.0",
-    "@xyflow/react": "^12.4.0",
-    "clsx": "^2.1.0"
+    "@particle-academy/fancy-auto-common": "^0.1.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "@xyflow/react": "^12.4.0",
+    "clsx": "^2.1.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "tsup": "^8.0.0",