@particle-academy/fancy-flow 0.8.0 → 0.10.0

package/dist/registry.js

@@ -1,5 +1,7 @@
-export { BUILTIN_KINDS, RegistryNode, buildNodeTypes, registerBuiltinKinds } from './chunk-M2XKGQQL.js';
+export { BUILTIN_KINDS, RegistryNode, buildNodeTypes, registerBuiltinKinds } from './chunk-NCPQDVUE.js';
 import './chunk-NF6NPY5N.js';
-export { categoryAccent, defaultConfigFor, getNodeKind, listNodeKinds, onNodeKindsChanged, registerNodeKind, validateConfig } from './chunk-WNVBXXOL.js';
+export { nodeConfig, resolveNodePorts, resolvePortSpec } from './chunk-TITD5W4Y.js';
+export { categoryAccent, defaultConfigFor, getNodeKind, listNodeKinds, onNodeKindsChanged, registerNodeKind, validateConfig } from './chunk-CPSOC27D.js';
+export { RichInputPreview, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerRichInputAdapter } from './chunk-F5RPRB7A.js';
 //# sourceMappingURL=registry.js.map
 //# sourceMappingURL=registry.js.map

package/dist/rich-input.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+var react = require('react');
+var fancyCmsUi = require('@particle-academy/fancy-cms-ui');
+var reactFancy = require('@particle-academy/react-fancy');
+require('react/jsx-runtime');
+
+// src/rich-input.tsx
+var adapter = null;
+var listeners = /* @__PURE__ */ new Set();
+function registerRichInputAdapter(next) {
+  adapter = next;
+  for (const l of listeners) l();
+  return () => {
+    if (adapter === next) {
+      adapter = null;
+      for (const l of listeners) l();
+    }
+  };
+}
+
+// src/rich-input.tsx
+function emptyRichInputDoc(id = "rich-input") {
+  return fancyCmsUi.emptyDoc(id);
+}
+function isPageDoc(value) {
+  if (value === null || typeof value !== "object") return false;
+  const v = value;
+  return Array.isArray(v.sections) && typeof v.nodes === "object" && v.nodes !== null;
+}
+function useFancyCmsForRichInput(options = {}) {
+  return registerRichInputAdapter({
+    FauxClient: reactFancy.FauxClient,
+    // Render the page at a real desktop width and scale it down, rather than
+    // letting it reflow into a card-sized viewport — a preview that reflows
+    // shows a layout the person hitting the step will never see.
+    frameProps: { variant: "browser", width: 1280, scale: "fit", dots: true },
+    // Preview: the CMS's own renderer, so the node card shows exactly what the
+    // person hitting this step will see. Styles are scoped by the frame.
+    renderDocument: (doc) => isPageDoc(doc) ? react.createElement(fancyCmsUi.CmsPage, { doc, registry: options.registry, data: options.data }) : null,
+    // Authoring: the CMS's own WYSIWYG editor, in the config panel.
+    renderEditor: ({ value, onChange }) => react.createElement(fancyCmsUi.Editor, {
+      defaultValue: isPageDoc(value) ? value : emptyRichInputDoc(),
+      onChange,
+      registry: options.registry,
+      data: options.data
+    })
+  });
+}
+useFancyCmsForRichInput();
+
+exports.emptyRichInputDoc = emptyRichInputDoc;
+exports.isPageDoc = isPageDoc;
+exports.useFancyCmsForRichInput = useFancyCmsForRichInput;
+//# sourceMappingURL=rich-input.cjs.map
+//# sourceMappingURL=rich-input.cjs.map

package/dist/rich-input.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registry/rich-input.tsx","../src/rich-input.tsx"],"names":["emptyDoc","FauxClient","createElement","CmsPage","Editor"],"mappings":";;;;;;;;AA+CA,IAAI,OAAA,GAAmC,IAAA;AACvC,IAAM,SAAA,uBAAgB,GAAA,EAAgB;AAG/B,SAAS,yBAAyB,IAAA,EAAoC;AAC3E,EAAA,OAAA,GAAU,IAAA;AACV,EAAA,KAAA,MAAW,CAAA,IAAK,WAAW,CAAA,EAAE;AAC7B,EAAA,OAAO,MAAM;AACX,IAAA,IAAI,YAAY,IAAA,EAAM;AACpB,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,KAAA,MAAW,CAAA,IAAK,WAAW,CAAA,EAAE;AAAA,IAC/B;AAAA,EACF,CAAA;AACF;;;ACvBO,SAAS,iBAAA,CAAkB,KAAK,YAAA,EAAuB;AAC5D,EAAA,OAAOA,oBAAS,EAAE,CAAA;AACpB;AAGO,SAAS,UAAU,KAAA,EAAkC;AAC1D,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AACxD,EAAA,MAAM,CAAA,GAAI,KAAA;AACV,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,CAAA,CAAE,QAAQ,CAAA,IAAK,OAAO,CAAA,CAAE,KAAA,KAAU,QAAA,IAAY,CAAA,CAAE,KAAA,KAAU,IAAA;AACjF;AAQO,SAAS,uBAAA,CAAwB,OAAA,GAMpC,EAAC,EAAe;AAClB,EAAA,OAAO,wBAAA,CAAyB;AAAA,gBAC9BC,qBAAA;AAAA;AAAA;AAAA;AAAA,IAIA,UAAA,EAAY,EAAE,OAAA,EAAS,SAAA,EAAW,OAAO,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,IAAA,EAAM,IAAA,EAAK;AAAA;AAAA;AAAA,IAIxE,gBAAgB,CAAC,GAAA,KACf,SAAA,CAAU,GAAG,IACTC,mBAAA,CAAcC,kBAAA,EAAS,EAAE,GAAA,EAAK,UAAU,OAAA,CAAQ,QAAA,EAAU,MAAM,OAAA,CAAQ,IAAA,EAAM,CAAA,GAC9E,IAAA;AAAA;AAAA,IAGN,cAAc,CAAC,EAAE,OAAO,QAAA,EAAS,KAC/BD,oBAAcE,iBAAA,EAAQ;AAAA,MACpB,YAAA,EAAc,SAAA,CAAU,KAAK,CAAA,GAAI,QAAQ,iBAAA,EAAkB;AAAA,MAC3D,QAAA;AAAA,MACA,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,MAAM,OAAA,CAAQ;AAAA,KACf;AAAA,GACJ,CAAA;AACH;AAEA,uBAAA,EAAwB","file":"rich-input.cjs","sourcesContent":["import type { ComponentType, ReactNode } from \"react\";\n\n/**\n * Rich user input — the injection point.\n *\n * `rich_user_input` pauses a run on a fully authored page (long-form content,\n * required reading + confirmation, multi-section forms) rather than a flat\n * field list. That page IS a fancy-cms document — fancy-flow defines no\n * document schema of its own and never re-implements one.\n *\n * The wiring ships in the box. Import the subpath once and the node lights up:\n *\n * ```ts\n * import \"@particle-academy/fancy-flow/rich-input\";\n * ```\n *\n * That module registers fancy-cms's `PageDoc` + `CmsPage` renderer + `Editor`\n * against this seam. It lives on a separate entry so `@particle-academy/\n * fancy-cms-ui` and `@particle-academy/react-fancy` stay OPTIONAL peers — most\n * flows never use a rich input, and a workflow editor should not drag a CMS\n * into every install.\n *\n * The seam stays public so a host can substitute a different document engine,\n * but that is the escape hatch, not the expected path.\n *\n * Until something registers, the node still registers and still round-trips\n * its config — it renders a \"how to enable\" body rather than an empty card.\n */\nexport type RichInputAdapter = {\n  /**\n   * react-fancy's `FauxClient` (or any component with the same shape) — a\n   * frame that mimics a browser window or device and scales its content down\n   * to fit. Used to preview the authored page inside the node card.\n   */\n  FauxClient?: ComponentType<any>;\n  /**\n   * Props for the frame — e.g. `{ variant: \"browser\", width: 1280, scale: \"fit\" }`\n   * so a full-width page renders at its real width and scales down into the\n   * node card instead of reflowing to a cramped layout that misrepresents it.\n   */\n  frameProps?: Record<string, unknown>;\n  /** Render the stored document read-only, for the in-node preview. */\n  renderDocument?: (doc: unknown) => ReactNode;\n  /** Editor mounted in the config panel via `renderDocumentField`. */\n  renderEditor?: (props: { value: unknown; onChange: (next: unknown) => void }) => ReactNode;\n};\n\nlet adapter: RichInputAdapter | null = null;\nconst listeners = new Set<() => void>();\n\n/** Install the host's document editor + preview frame. Returns an unregister fn. */\nexport function registerRichInputAdapter(next: RichInputAdapter): () => void {\n  adapter = next;\n  for (const l of listeners) l();\n  return () => {\n    if (adapter === next) {\n      adapter = null;\n      for (const l of listeners) l();\n    }\n  };\n}\n\n/** The registered adapter, or null when the host hasn't wired one. */\nexport function getRichInputAdapter(): RichInputAdapter | null {\n  return adapter;\n}\n\n/** True once a host has wired an adapter — i.e. the node is usable. */\nexport function isRichInputEnabled(): boolean {\n  return adapter !== null && (adapter.renderDocument !== undefined || adapter.renderEditor !== undefined);\n}\n\n/** Subscribe to adapter changes (so nodes re-render when it lands). */\nexport function onRichInputAdapterChanged(fn: () => void): () => void {\n  listeners.add(fn);\n  return () => listeners.delete(fn);\n}\n\n/**\n * RichInputPreview — the node card body. Shows the authored page inside a\n * FauxClient frame so an author can see, at a glance on the canvas, what the\n * person hitting this step will be looking at.\n *\n * Degrades in two steps rather than one: no adapter at all → install hint;\n * adapter but nothing authored yet → an empty frame with the step title. A\n * blank node body would read as \"broken\" in both cases.\n */\nexport function RichInputPreview({ config }: { config: Record<string, unknown> }) {\n  const a = getRichInputAdapter();\n  const title = typeof config.title === \"string\" && config.title.trim() !== \"\" ? config.title : \"Untitled step\";\n  const doc = config.document;\n\n  if (!a || (!a.renderDocument && !a.renderEditor)) {\n    return (\n      <div className=\"ff-rich-preview\">\n        <span className=\"ff-rich-preview__title\">{title}</span>\n        <div className=\"ff-rich-preview__unavailable\">\n          Add <code>@particle-academy/fancy-cms-ui</code> +{\" \"}\n          <code>@particle-academy/react-fancy</code>, then{\" \"}\n          <code>import \"@particle-academy/fancy-flow/rich-input\"</code>.\n        </div>\n      </div>\n    );\n  }\n\n  const body = doc === undefined || doc === null\n    ? <p className=\"ff-rich-preview__unavailable\">Nothing authored yet.</p>\n    : a.renderDocument?.(doc) ?? null;\n\n  const Frame = a.FauxClient;\n\n  return (\n    <div className=\"ff-rich-preview\">\n      <span className=\"ff-rich-preview__title\">{title}</span>\n      <div className=\"ff-rich-preview__frame\">\n        {Frame ? <Frame {...(a.frameProps ?? { variant: \"browser\" })}>{body}</Frame> : body}\n      </div>\n    </div>\n  );\n}\n","/**\n * `@particle-academy/fancy-flow/rich-input` — wires `rich_user_input` to the\n * real CMS.\n *\n * Import this entry once, anywhere in your app, and the node lights up:\n *\n * ```ts\n * import \"@particle-academy/fancy-flow/rich-input\";\n * ```\n *\n * ## Why this is a separate entry\n *\n * The document a rich input step shows IS a fancy-cms page — same `PageDoc`,\n * same renderer, same editor. fancy-flow declares no document schema of its\n * own and never re-implements one; duplicating the model would guarantee the\n * two drift, and a step authored in fancy-flow would stop being a thing\n * fancy-cms could open.\n *\n * But most flows never use a rich input, and a workflow editor should not drag\n * a CMS into every install. So the dependency lives HERE, on an opt-in\n * subpath, instead of in the main entry. `@particle-academy/fancy-cms-ui` and\n * `@particle-academy/react-fancy` are optional peers: required to import this\n * module, irrelevant if you never do.\n */\nimport { createElement } from \"react\";\nimport { CmsPage, Editor, emptyDoc, type PageDoc } from \"@particle-academy/fancy-cms-ui\";\nimport { FauxClient } from \"@particle-academy/react-fancy\";\nimport { registerRichInputAdapter } from \"./registry/rich-input\";\n\nexport type { PageDoc };\n\n/**\n * A blank page for a step that hasn't been authored yet.\n *\n * `Editor` takes a `defaultValue`, not a nullable doc — so a never-authored\n * step needs a real empty document to open into rather than a blank screen.\n */\nexport function emptyRichInputDoc(id = \"rich-input\"): PageDoc {\n  return emptyDoc(id);\n}\n\n/** True when a stored value is a fancy-cms page document. */\nexport function isPageDoc(value: unknown): value is PageDoc {\n  if (value === null || typeof value !== \"object\") return false;\n  const v = value as Partial<PageDoc>;\n  return Array.isArray(v.sections) && typeof v.nodes === \"object\" && v.nodes !== null;\n}\n\n/**\n * Register fancy-cms as the document engine for `rich_user_input`.\n *\n * Called automatically on import. Exported so a host can re-register after\n * swapping in a custom element registry, and so the call is testable.\n */\nexport function useFancyCmsForRichInput(options: {\n  /** Custom element registry — pass the SAME one you give `CmsPage` at runtime,\n   *  or the edit canvas renders your node types as blank placeholders. */\n  registry?: Parameters<typeof CmsPage>[0][\"registry\"];\n  /** Data context that `{ $bind }` props preview against. */\n  data?: Parameters<typeof CmsPage>[0][\"data\"];\n} = {}): () => void {\n  return registerRichInputAdapter({\n    FauxClient,\n    // Render the page at a real desktop width and scale it down, rather than\n    // letting it reflow into a card-sized viewport — a preview that reflows\n    // shows a layout the person hitting the step will never see.\n    frameProps: { variant: \"browser\", width: 1280, scale: \"fit\", dots: true },\n\n    // Preview: the CMS's own renderer, so the node card shows exactly what the\n    // person hitting this step will see. Styles are scoped by the frame.\n    renderDocument: (doc) =>\n      isPageDoc(doc)\n        ? createElement(CmsPage, { doc, registry: options.registry, data: options.data })\n        : null,\n\n    // Authoring: the CMS's own WYSIWYG editor, in the config panel.\n    renderEditor: ({ value, onChange }) =>\n      createElement(Editor, {\n        defaultValue: isPageDoc(value) ? value : emptyRichInputDoc(),\n        onChange: onChange as (doc: PageDoc) => void,\n        registry: options.registry,\n        data: options.data,\n      }),\n  });\n}\n\nuseFancyCmsForRichInput();\n"]}

package/dist/rich-input.d.cts

@@ -0,0 +1,27 @@
+import { PageDoc, CmsPage } from '@particle-academy/fancy-cms-ui';
+export { PageDoc } from '@particle-academy/fancy-cms-ui';
+
+/**
+ * A blank page for a step that hasn't been authored yet.
+ *
+ * `Editor` takes a `defaultValue`, not a nullable doc — so a never-authored
+ * step needs a real empty document to open into rather than a blank screen.
+ */
+declare function emptyRichInputDoc(id?: string): PageDoc;
+/** True when a stored value is a fancy-cms page document. */
+declare function isPageDoc(value: unknown): value is PageDoc;
+/**
+ * Register fancy-cms as the document engine for `rich_user_input`.
+ *
+ * Called automatically on import. Exported so a host can re-register after
+ * swapping in a custom element registry, and so the call is testable.
+ */
+declare function useFancyCmsForRichInput(options?: {
+    /** Custom element registry — pass the SAME one you give `CmsPage` at runtime,
+     *  or the edit canvas renders your node types as blank placeholders. */
+    registry?: Parameters<typeof CmsPage>[0]["registry"];
+    /** Data context that `{ $bind }` props preview against. */
+    data?: Parameters<typeof CmsPage>[0]["data"];
+}): () => void;
+
+export { emptyRichInputDoc, isPageDoc, useFancyCmsForRichInput };

package/dist/rich-input.d.ts

@@ -0,0 +1,27 @@
+import { PageDoc, CmsPage } from '@particle-academy/fancy-cms-ui';
+export { PageDoc } from '@particle-academy/fancy-cms-ui';
+
+/**
+ * A blank page for a step that hasn't been authored yet.
+ *
+ * `Editor` takes a `defaultValue`, not a nullable doc — so a never-authored
+ * step needs a real empty document to open into rather than a blank screen.
+ */
+declare function emptyRichInputDoc(id?: string): PageDoc;
+/** True when a stored value is a fancy-cms page document. */
+declare function isPageDoc(value: unknown): value is PageDoc;
+/**
+ * Register fancy-cms as the document engine for `rich_user_input`.
+ *
+ * Called automatically on import. Exported so a host can re-register after
+ * swapping in a custom element registry, and so the call is testable.
+ */
+declare function useFancyCmsForRichInput(options?: {
+    /** Custom element registry — pass the SAME one you give `CmsPage` at runtime,
+     *  or the edit canvas renders your node types as blank placeholders. */
+    registry?: Parameters<typeof CmsPage>[0]["registry"];
+    /** Data context that `{ $bind }` props preview against. */
+    data?: Parameters<typeof CmsPage>[0]["data"];
+}): () => void;
+
+export { emptyRichInputDoc, isPageDoc, useFancyCmsForRichInput };

package/dist/rich-input.js

@@ -0,0 +1,37 @@
+import { registerRichInputAdapter } from './chunk-F5RPRB7A.js';
+import { createElement } from 'react';
+import { Editor, CmsPage, emptyDoc } from '@particle-academy/fancy-cms-ui';
+import { FauxClient } from '@particle-academy/react-fancy';
+
+function emptyRichInputDoc(id = "rich-input") {
+  return emptyDoc(id);
+}
+function isPageDoc(value) {
+  if (value === null || typeof value !== "object") return false;
+  const v = value;
+  return Array.isArray(v.sections) && typeof v.nodes === "object" && v.nodes !== null;
+}
+function useFancyCmsForRichInput(options = {}) {
+  return registerRichInputAdapter({
+    FauxClient,
+    // Render the page at a real desktop width and scale it down, rather than
+    // letting it reflow into a card-sized viewport — a preview that reflows
+    // shows a layout the person hitting the step will never see.
+    frameProps: { variant: "browser", width: 1280, scale: "fit", dots: true },
+    // Preview: the CMS's own renderer, so the node card shows exactly what the
+    // person hitting this step will see. Styles are scoped by the frame.
+    renderDocument: (doc) => isPageDoc(doc) ? createElement(CmsPage, { doc, registry: options.registry, data: options.data }) : null,
+    // Authoring: the CMS's own WYSIWYG editor, in the config panel.
+    renderEditor: ({ value, onChange }) => createElement(Editor, {
+      defaultValue: isPageDoc(value) ? value : emptyRichInputDoc(),
+      onChange,
+      registry: options.registry,
+      data: options.data
+    })
+  });
+}
+useFancyCmsForRichInput();
+
+export { emptyRichInputDoc, isPageDoc, useFancyCmsForRichInput };
+//# sourceMappingURL=rich-input.js.map
+//# sourceMappingURL=rich-input.js.map

package/dist/rich-input.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rich-input.tsx"],"names":[],"mappings":";;;;;AAqCO,SAAS,iBAAA,CAAkB,KAAK,YAAA,EAAuB;AAC5D,EAAA,OAAO,SAAS,EAAE,CAAA;AACpB;AAGO,SAAS,UAAU,KAAA,EAAkC;AAC1D,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AACxD,EAAA,MAAM,CAAA,GAAI,KAAA;AACV,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,CAAA,CAAE,QAAQ,CAAA,IAAK,OAAO,CAAA,CAAE,KAAA,KAAU,QAAA,IAAY,CAAA,CAAE,KAAA,KAAU,IAAA;AACjF;AAQO,SAAS,uBAAA,CAAwB,OAAA,GAMpC,EAAC,EAAe;AAClB,EAAA,OAAO,wBAAA,CAAyB;AAAA,IAC9B,UAAA;AAAA;AAAA;AAAA;AAAA,IAIA,UAAA,EAAY,EAAE,OAAA,EAAS,SAAA,EAAW,OAAO,IAAA,EAAM,KAAA,EAAO,KAAA,EAAO,IAAA,EAAM,IAAA,EAAK;AAAA;AAAA;AAAA,IAIxE,gBAAgB,CAAC,GAAA,KACf,SAAA,CAAU,GAAG,IACT,aAAA,CAAc,OAAA,EAAS,EAAE,GAAA,EAAK,UAAU,OAAA,CAAQ,QAAA,EAAU,MAAM,OAAA,CAAQ,IAAA,EAAM,CAAA,GAC9E,IAAA;AAAA;AAAA,IAGN,cAAc,CAAC,EAAE,OAAO,QAAA,EAAS,KAC/B,cAAc,MAAA,EAAQ;AAAA,MACpB,YAAA,EAAc,SAAA,CAAU,KAAK,CAAA,GAAI,QAAQ,iBAAA,EAAkB;AAAA,MAC3D,QAAA;AAAA,MACA,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,MAAM,OAAA,CAAQ;AAAA,KACf;AAAA,GACJ,CAAA;AACH;AAEA,uBAAA,EAAwB","file":"rich-input.js","sourcesContent":["/**\n * `@particle-academy/fancy-flow/rich-input` — wires `rich_user_input` to the\n * real CMS.\n *\n * Import this entry once, anywhere in your app, and the node lights up:\n *\n * ```ts\n * import \"@particle-academy/fancy-flow/rich-input\";\n * ```\n *\n * ## Why this is a separate entry\n *\n * The document a rich input step shows IS a fancy-cms page — same `PageDoc`,\n * same renderer, same editor. fancy-flow declares no document schema of its\n * own and never re-implements one; duplicating the model would guarantee the\n * two drift, and a step authored in fancy-flow would stop being a thing\n * fancy-cms could open.\n *\n * But most flows never use a rich input, and a workflow editor should not drag\n * a CMS into every install. So the dependency lives HERE, on an opt-in\n * subpath, instead of in the main entry. `@particle-academy/fancy-cms-ui` and\n * `@particle-academy/react-fancy` are optional peers: required to import this\n * module, irrelevant if you never do.\n */\nimport { createElement } from \"react\";\nimport { CmsPage, Editor, emptyDoc, type PageDoc } from \"@particle-academy/fancy-cms-ui\";\nimport { FauxClient } from \"@particle-academy/react-fancy\";\nimport { registerRichInputAdapter } from \"./registry/rich-input\";\n\nexport type { PageDoc };\n\n/**\n * A blank page for a step that hasn't been authored yet.\n *\n * `Editor` takes a `defaultValue`, not a nullable doc — so a never-authored\n * step needs a real empty document to open into rather than a blank screen.\n */\nexport function emptyRichInputDoc(id = \"rich-input\"): PageDoc {\n  return emptyDoc(id);\n}\n\n/** True when a stored value is a fancy-cms page document. */\nexport function isPageDoc(value: unknown): value is PageDoc {\n  if (value === null || typeof value !== \"object\") return false;\n  const v = value as Partial<PageDoc>;\n  return Array.isArray(v.sections) && typeof v.nodes === \"object\" && v.nodes !== null;\n}\n\n/**\n * Register fancy-cms as the document engine for `rich_user_input`.\n *\n * Called automatically on import. Exported so a host can re-register after\n * swapping in a custom element registry, and so the call is testable.\n */\nexport function useFancyCmsForRichInput(options: {\n  /** Custom element registry — pass the SAME one you give `CmsPage` at runtime,\n   *  or the edit canvas renders your node types as blank placeholders. */\n  registry?: Parameters<typeof CmsPage>[0][\"registry\"];\n  /** Data context that `{ $bind }` props preview against. */\n  data?: Parameters<typeof CmsPage>[0][\"data\"];\n} = {}): () => void {\n  return registerRichInputAdapter({\n    FauxClient,\n    // Render the page at a real desktop width and scale it down, rather than\n    // letting it reflow into a card-sized viewport — a preview that reflows\n    // shows a layout the person hitting the step will never see.\n    frameProps: { variant: \"browser\", width: 1280, scale: \"fit\", dots: true },\n\n    // Preview: the CMS's own renderer, so the node card shows exactly what the\n    // person hitting this step will see. Styles are scoped by the frame.\n    renderDocument: (doc) =>\n      isPageDoc(doc)\n        ? createElement(CmsPage, { doc, registry: options.registry, data: options.data })\n        : null,\n\n    // Authoring: the CMS's own WYSIWYG editor, in the config panel.\n    renderEditor: ({ value, onChange }) =>\n      createElement(Editor, {\n        defaultValue: isPageDoc(value) ? value : emptyRichInputDoc(),\n        onChange: onChange as (doc: PageDoc) => void,\n        registry: options.registry,\n        data: options.data,\n      }),\n  });\n}\n\nuseFancyCmsForRichInput();\n"]}

package/dist/runtime.cjs

@@ -8,6 +8,35 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var ReactExports__default = /*#__PURE__*/_interopDefault(ReactExports);
 
+// src/registry/registry.ts
+var kinds = /* @__PURE__ */ new Map();
+function getNodeKind(name) {
+  return kinds.get(name) ?? null;
+}
+
+// src/registry/ports.ts
+function resolvePortSpec(spec, config) {
+  if (spec === void 0) return void 0;
+  if (typeof spec !== "function") return spec;
+  try {
+    const resolved = spec(config);
+    return Array.isArray(resolved) ? resolved : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function nodeConfig(node) {
+  return node.data?.config ?? {};
+}
+function resolveNodePorts(node, kind) {
+  const config = nodeConfig(node);
+  const data = node.data;
+  return {
+    inputs: data?.inputs ?? resolvePortSpec(kind?.inputs, config),
+    outputs: data?.outputs ?? resolvePortSpec(kind?.outputs, config)
+  };
+}
+
 // src/runtime/run-flow.ts
 async function runFlow(graph, executors, onEvent = () => {
 }, options = {}) {
@@ -139,8 +168,9 @@ function activatedPorts(node, result) {
       return { ports: [r.branch], value: r.value ?? r };
     }
   }
-  const declared = node.data.outputs?.map((p) => p.id) ?? ["out"];
-  return { ports: declared, value: result };
+  const kind = getNodeKind(node.data?.kind ?? node.type ?? "") ?? void 0;
+  const declared = resolveNodePorts(node, kind).outputs?.map((p) => p.id);
+  return { ports: declared?.length ? declared : ["out"], value: result };
 }
 function useFlowRun({ maxFeed = 200 } = {}) {
   const [statuses, setStatuses] = ReactExports.useState({});