@particle-academy/fancy-flow 0.52.0 → 0.54.0

package/dist/{ConfigFieldRenderer-Bc9Txnql.d.cts → HumanPrompt-CPl-Spmp.d.cts}

@@ -89,4 +89,78 @@ type ConfigFieldRendererProps = {
  */
 declare function ConfigFieldRenderer({ field, value, onChange, id, renderCredentialField, renderDocumentField, fieldRenderers, graph, nodeId, }: ConfigFieldRendererProps): react.JSX.Element | null;
 
-export { type ConfigFieldRenderFn as C, type ConfigFieldRenderContext as a, ConfigFieldRenderer as b, type ConfigFieldRendererProps as c };
+/**
+ * The field vocabulary a `user_input` node declares, and the normalizer that
+ * turns whatever was actually written into something renderable.
+ *
+ * ## Why this is a separate module from `HumanPrompt.tsx`
+ *
+ * `src/registry/builtin.ts` needs `humanFieldType` for the `user_input` kind's
+ * `outputShape`, and `builtin.ts` is in the import graph of the `/engine`
+ * entry — the one `tests/core-nodes.test.ts` guards as React-free so a queue
+ * worker or a CLI can register kinds without dragging React in. Importing the
+ * modal's `.tsx` from there put a React module on that path and left the guard
+ * standing only because treeshaking happened to drop it.
+ *
+ * Pure functions over plain data, in a `.ts` file, so the headless path cannot
+ * regress on a future edit to the component.
+ */
+/**
+ * The control a field renders as, after {@link humanInputFields} has resolved
+ * whatever the author, a peer runtime or an agent actually wrote.
+ *
+ * These are the CANONICAL names. The vocabulary an author may write is wider —
+ * see {@link HUMAN_FIELD_TYPE_ALIASES} — because a `fields` array arrives from
+ * three places (the config panel, a hand-written workflow JSON, and the PHP /
+ * Python runtimes) and each has its own habits for spelling "boolean".
+ */
+type HumanFieldType = "text" | "textarea" | "number" | "select" | "switch" | "date" | "datetime" | "time" | "email" | "url" | "tel" | "password";
+/** One choice in a `select` field, after normalization. */
+type HumanFieldOption = {
+    value: string;
+    label: string;
+};
+/** A field the input modal renders. Mirrors a `user_input` `fields` row. */
+type HumanField = {
+    key: string;
+    label?: string;
+    type?: HumanFieldType;
+    required?: boolean;
+    placeholder?: string;
+    options?: HumanFieldOption[];
+    default?: unknown;
+};
+
+/** What a host renderer is handed for one field. */
+type HumanFieldRenderContext = {
+    field: HumanField;
+    /** The id the field's `<label>` points at — put it on your control. */
+    id: string;
+    value: unknown;
+    onChange: (v: unknown) => void;
+    /** Present only on the first field; attach it so the modal autofocuses. */
+    autoFocusRef?: React.RefObject<HTMLElement | null>;
+};
+/**
+ * Render one field, or return `null` to decline it.
+ *
+ * `null` means "not mine" and falls through to the built-in control. That is
+ * what makes a PARTIAL map safe to spread: a host handing over someone else's
+ * renderers does not silently lose every type that map does not cover.
+ */
+type HumanFieldRenderFn = (ctx: HumanFieldRenderContext) => ReactNode | null;
+/**
+ * Host overrides for pause-form controls, keyed by CANONICAL field type
+ * (`"switch"`, not `"boolean"` — aliases are normalised before the lookup, so
+ * one entry covers every spelling of that type).
+ *
+ * The built-ins are deliberately native `--ff-*`-themed elements rather than
+ * react-fancy primitives: react-fancy is an OPTIONAL peer and this modal ships
+ * in the main entry, so importing it here would break a standalone install and
+ * bypass the token layer a host themes `.ff-editor` with. This seam is how a
+ * host that HAS react-fancy gets Fancy controls anyway —
+ * `@particle-academy/fancy-flow/fields/react-fancy` exports a ready map.
+ */
+type HumanFieldRenderers = Partial<Record<HumanFieldType, HumanFieldRenderFn>>;
+
+export { type ConfigFieldRenderFn as C, type HumanFieldRenderers as H, type ConfigFieldRenderContext as a, ConfigFieldRenderer as b, type ConfigFieldRendererProps as c };

package/dist/{ConfigFieldRenderer-Bt3RGT7Z.d.ts → HumanPrompt-DlJSFi3F.d.ts}

@@ -89,4 +89,78 @@ type ConfigFieldRendererProps = {
  */
 declare function ConfigFieldRenderer({ field, value, onChange, id, renderCredentialField, renderDocumentField, fieldRenderers, graph, nodeId, }: ConfigFieldRendererProps): react.JSX.Element | null;
 
-export { type ConfigFieldRenderFn as C, type ConfigFieldRenderContext as a, ConfigFieldRenderer as b, type ConfigFieldRendererProps as c };
+/**
+ * The field vocabulary a `user_input` node declares, and the normalizer that
+ * turns whatever was actually written into something renderable.
+ *
+ * ## Why this is a separate module from `HumanPrompt.tsx`
+ *
+ * `src/registry/builtin.ts` needs `humanFieldType` for the `user_input` kind's
+ * `outputShape`, and `builtin.ts` is in the import graph of the `/engine`
+ * entry — the one `tests/core-nodes.test.ts` guards as React-free so a queue
+ * worker or a CLI can register kinds without dragging React in. Importing the
+ * modal's `.tsx` from there put a React module on that path and left the guard
+ * standing only because treeshaking happened to drop it.
+ *
+ * Pure functions over plain data, in a `.ts` file, so the headless path cannot
+ * regress on a future edit to the component.
+ */
+/**
+ * The control a field renders as, after {@link humanInputFields} has resolved
+ * whatever the author, a peer runtime or an agent actually wrote.
+ *
+ * These are the CANONICAL names. The vocabulary an author may write is wider —
+ * see {@link HUMAN_FIELD_TYPE_ALIASES} — because a `fields` array arrives from
+ * three places (the config panel, a hand-written workflow JSON, and the PHP /
+ * Python runtimes) and each has its own habits for spelling "boolean".
+ */
+type HumanFieldType = "text" | "textarea" | "number" | "select" | "switch" | "date" | "datetime" | "time" | "email" | "url" | "tel" | "password";
+/** One choice in a `select` field, after normalization. */
+type HumanFieldOption = {
+    value: string;
+    label: string;
+};
+/** A field the input modal renders. Mirrors a `user_input` `fields` row. */
+type HumanField = {
+    key: string;
+    label?: string;
+    type?: HumanFieldType;
+    required?: boolean;
+    placeholder?: string;
+    options?: HumanFieldOption[];
+    default?: unknown;
+};
+
+/** What a host renderer is handed for one field. */
+type HumanFieldRenderContext = {
+    field: HumanField;
+    /** The id the field's `<label>` points at — put it on your control. */
+    id: string;
+    value: unknown;
+    onChange: (v: unknown) => void;
+    /** Present only on the first field; attach it so the modal autofocuses. */
+    autoFocusRef?: React.RefObject<HTMLElement | null>;
+};
+/**
+ * Render one field, or return `null` to decline it.
+ *
+ * `null` means "not mine" and falls through to the built-in control. That is
+ * what makes a PARTIAL map safe to spread: a host handing over someone else's
+ * renderers does not silently lose every type that map does not cover.
+ */
+type HumanFieldRenderFn = (ctx: HumanFieldRenderContext) => ReactNode | null;
+/**
+ * Host overrides for pause-form controls, keyed by CANONICAL field type
+ * (`"switch"`, not `"boolean"` — aliases are normalised before the lookup, so
+ * one entry covers every spelling of that type).
+ *
+ * The built-ins are deliberately native `--ff-*`-themed elements rather than
+ * react-fancy primitives: react-fancy is an OPTIONAL peer and this modal ships
+ * in the main entry, so importing it here would break a standalone install and
+ * bypass the token layer a host themes `.ff-editor` with. This seam is how a
+ * host that HAS react-fancy gets Fancy controls anyway —
+ * `@particle-academy/fancy-flow/fields/react-fancy` exports a ready map.
+ */
+type HumanFieldRenderers = Partial<Record<HumanFieldType, HumanFieldRenderFn>>;
+
+export { type ConfigFieldRenderFn as C, type HumanFieldRenderers as H, type ConfigFieldRenderContext as a, ConfigFieldRenderer as b, type ConfigFieldRendererProps as c };

package/dist/{chunk-JOXMAWAI.js → chunk-CIBW5ATA.js}

@@ -9037,6 +9037,101 @@ function NodeToolbar({ nodeId, children: children2, className, style: style2, is
   };
   return jsx(NodeToolbarPortal, { children: jsx("div", { style: wrapperStyle2, className: cc(["react-flow__node-toolbar", className]), ...rest, "data-id": nodesArray.reduce((acc, node) => `${acc}${node.id} `, "").trim(), children: children2 }) });
 }
+
+// src/components/FlowEditor/human-fields.ts
+var HUMAN_FIELD_TYPE_ALIASES = {
+  text: "text",
+  string: "text",
+  str: "text",
+  input: "text",
+  textarea: "textarea",
+  long_text: "textarea",
+  longtext: "textarea",
+  "long-text": "textarea",
+  multiline: "textarea",
+  paragraph: "textarea",
+  markdown: "textarea",
+  number: "number",
+  numeric: "number",
+  integer: "number",
+  int: "number",
+  float: "number",
+  decimal: "number",
+  select: "select",
+  enum: "select",
+  choice: "select",
+  choices: "select",
+  dropdown: "select",
+  options: "select",
+  radio: "select",
+  switch: "switch",
+  bool: "switch",
+  boolean: "switch",
+  checkbox: "switch",
+  toggle: "switch",
+  date: "date",
+  datetime: "datetime",
+  "datetime-local": "datetime",
+  datetimelocal: "datetime",
+  timestamp: "datetime",
+  time: "time",
+  email: "email",
+  "e-mail": "email",
+  url: "url",
+  uri: "url",
+  link: "url",
+  tel: "tel",
+  phone: "tel",
+  telephone: "tel",
+  password: "password",
+  secret: "password"
+};
+function humanFieldType(raw) {
+  if (typeof raw !== "string") return "text";
+  return HUMAN_FIELD_TYPE_ALIASES[raw.trim().toLowerCase()] ?? "text";
+}
+function humanFieldOptions(raw) {
+  const entries = [];
+  if (Array.isArray(raw)) {
+    for (const item of raw) {
+      if (typeof item === "string" || typeof item === "number") {
+        const value = String(item);
+        if (value !== "") entries.push({ value, label: value });
+        continue;
+      }
+      if (item && typeof item === "object") {
+        const value = item.value;
+        if (value === void 0 || value === null || value === "") continue;
+        const label = item.label;
+        entries.push({
+          value: String(value),
+          label: typeof label === "string" && label !== "" ? label : String(value)
+        });
+      }
+    }
+  } else if (raw && typeof raw === "object") {
+    for (const [value, label] of Object.entries(raw)) {
+      if (value === "") continue;
+      entries.push({ value, label: typeof label === "string" && label !== "" ? label : value });
+    }
+  }
+  return entries.length ? entries : void 0;
+}
+function humanInputFields(config) {
+  const raw = Array.isArray(config?.fields) ? config.fields : [];
+  const fields = raw.filter((f) => f && typeof f === "object" && typeof f.key === "string" && f.key).map((f) => ({
+    key: f.key,
+    label: typeof f.label === "string" && f.label ? f.label : f.key,
+    type: humanFieldType(f.type),
+    required: !!f.required,
+    placeholder: typeof f.placeholder === "string" ? f.placeholder : void 0,
+    options: humanFieldOptions(f.options ?? f.choices),
+    default: f.default
+  }));
+  if (fields.length) return fields;
+  const title = typeof config?.title === "string" && config.title ? config.title : "Your answer";
+  return [{ key: "value", label: title, type: "textarea", required: true }];
+}
 var FlowEditorContext = createContext(null);
 var FlowEditorProvider = FlowEditorContext.Provider;
 function useFlowEditor() {
@@ -9651,6 +9746,20 @@ var subflowExecutor = async (ctx) => {
 };
 
 // src/registry/builtin.ts
+var HUMAN_FIELD_OUTPUT_TYPE = {
+  text: "string",
+  textarea: "string",
+  select: "string",
+  date: "string",
+  datetime: "string",
+  time: "string",
+  email: "string",
+  url: "string",
+  tel: "string",
+  password: "string",
+  number: "number",
+  switch: "boolean"
+};
 function casePorts(cases) {
   const byPort = /* @__PURE__ */ new Map();
   if (cases && typeof cases === "object" && !Array.isArray(cases)) {
@@ -9748,7 +9857,17 @@ var KINDS = [
     name: "@particle-academy/user_input",
     // The keys an author declared on THIS node — the case a static list cannot
     // express, and the one issue #5 named.
-    outputShape: (config) => (config.fields ?? []).filter((f) => typeof f.key === "string" && f.key !== "").map((f) => ({ path: f.key, type: "string", description: f.label })),
+    //
+    // The TYPE comes from the same normalizer the form renders with, so the
+    // variable picker agrees with what the run actually resolves. It used to say
+    // `string` for every field, which was wrong the moment a field was a number
+    // or a switch — the picker told an author `{{ $json.age }}` was text while
+    // the form handed the next node a number.
+    outputShape: (config) => (config.fields ?? []).filter((f) => typeof f.key === "string" && f.key !== "").map((f) => ({
+      path: f.key,
+      type: HUMAN_FIELD_OUTPUT_TYPE[humanFieldType(f.type)],
+      description: f.label
+    })),
     aliases: ["user_input", "@fancy/user_input"],
     pausesForHuman: "input",
     category: "human",
@@ -9775,14 +9894,38 @@ var KINDS = [
             key: "type",
             label: "Type",
             default: "text",
+            // Every control `HumanPrompt` can render. A type the form supports
+            // but the panel cannot select is reachable only by hand-editing the
+            // workflow JSON — which is the audience this panel exists for.
             options: [
               { value: "text", label: "Text" },
               { value: "textarea", label: "Long text" },
               { value: "number", label: "Number" },
               { value: "select", label: "Select" },
-              { value: "switch", label: "Switch" }
+              { value: "switch", label: "Switch (yes / no)" },
+              { value: "date", label: "Date" },
+              { value: "datetime", label: "Date + time" },
+              { value: "time", label: "Time" },
+              { value: "email", label: "Email" },
+              { value: "url", label: "URL" },
+              { value: "tel", label: "Phone" },
+              { value: "password", label: "Password" }
             ]
           },
+          {
+            // Without this a panel-authored select had nothing to choose from,
+            // so it rendered an empty dropdown — the type was declarable and
+            // unusable in the same breath.
+            type: "keyvalue",
+            key: "options",
+            label: "Choices",
+            description: "Select fields only. Left is the value the flow receives, right is what the person sees.",
+            keyLabel: "Value",
+            valueLabel: "Label",
+            keyPlaceholder: "small",
+            valuePlaceholder: "Small",
+            addLabel: "Add choice"
+          },
           { type: "switch", key: "required", label: "Required", default: false }
         ],
         default: [{ key: "answer", label: "Your answer", type: "textarea", required: true }]
@@ -10704,6 +10847,6 @@ function LaneNodeInner(props) {
 }
 var LaneNode = memo(LaneNodeInner);
 
-export { BUILTIN_KINDS, Background, BackgroundVariant, Controls, DEFAULT_MAX_DEPTH, FlowEditorProvider, Handle, LaneNode, MiniMap, NodeResizer, NodeToolbar, NoteNode, Position, ReactFlowProvider, RunIdentity, ViewportPortal, addEdge2 as addEdge, applyEdgeChanges, applyNodeChanges, categoryAccent, clearNodeKindOverrides, declaredRoutes, defaultConfigFor, ensureBuiltinKinds, escapeSegment, getNodeKind, index, kindIds, listNodeKinds, llmRouterExecutor, nodeConfig, onNodeKindsChanged, overrideNodeKind, reconnectEdge2 as reconnectEdge, registerBuiltinKinds, registerNodeKind, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, runFlow, subflowExecutor, subflowMode, subflowPorts, useFlowEditor, useFlowEditorOptional, useReactFlow, validateConfig };
-//# sourceMappingURL=chunk-JOXMAWAI.js.map
-//# sourceMappingURL=chunk-JOXMAWAI.js.map
+export { BUILTIN_KINDS, Background, BackgroundVariant, Controls, DEFAULT_MAX_DEPTH, FlowEditorProvider, Handle, LaneNode, MiniMap, NodeResizer, NodeToolbar, NoteNode, Position, ReactFlowProvider, RunIdentity, ViewportPortal, addEdge2 as addEdge, applyEdgeChanges, applyNodeChanges, categoryAccent, clearNodeKindOverrides, declaredRoutes, defaultConfigFor, ensureBuiltinKinds, escapeSegment, getNodeKind, humanInputFields, index, kindIds, listNodeKinds, llmRouterExecutor, nodeConfig, onNodeKindsChanged, overrideNodeKind, reconnectEdge2 as reconnectEdge, registerBuiltinKinds, registerNodeKind, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, runFlow, subflowExecutor, subflowMode, subflowPorts, useFlowEditor, useFlowEditorOptional, useReactFlow, validateConfig };
+//# sourceMappingURL=chunk-CIBW5ATA.js.map
+//# sourceMappingURL=chunk-CIBW5ATA.js.map