@particle-academy/fancy-flow 0.51.1 → 0.53.0

package/dist/engine.js

@@ -1,8 +1,8 @@
-export { runCohort } from './chunk-VUU3CDBT.js';
+export { runCohort } from './chunk-WCFRKXH5.js';
 import { decodePause } from './chunk-UEOE6B52.js';
 export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman } from './chunk-UEOE6B52.js';
-import { runFlow, getNodeKind, resolveNodePorts } from './chunk-4GO2CHAY.js';
-export { RunIdentity, defaultConfigFor, escapeSegment, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, runFlow, validateConfig } from './chunk-4GO2CHAY.js';
+import { runFlow, getNodeKind, resolveNodePorts } from './chunk-CIBW5ATA.js';
+export { RunIdentity, defaultConfigFor, escapeSegment, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, runFlow, validateConfig } from './chunk-CIBW5ATA.js';
 import './chunk-F5RPRB7A.js';
 import { isResolutionFailure, registerLlmClient, registerWorkflowResolver } from './chunk-USL4FMFU.js';
 

package/dist/index.cjs

@@ -1719,6 +1719,101 @@ var init_layout = __esm({
     init_dagre_esm();
   }
 });
+
+// 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 adapter = null;
 var listeners = /* @__PURE__ */ new Set();
 function registerRichInputAdapter(next) {
@@ -11220,7 +11315,7 @@ async function runFlow(graph, executors, onEvent = () => {
       const exec = pickExecutor(executors, node);
       if (!exec) {
         const tried = executorLookupIds(node);
-        const msg = `No executor registered for kind=${node.type} \u2014 tried ${tried.map((id2) => `"${id2}"`).join(", ")} and the wildcard "*". Key your registry by one of those.`;
+        const msg = `No executor registered for kind=${node.type} \u2014 tried ${tried.map((id2) => `"${id2}"`).join(", ")}. Key your registry by one of those.`;
         errors.push(msg);
         onEvent({ type: "node-status", nodeId: node.id, status: "error", text: msg });
         onEvent({ type: "log", nodeId: node.id, level: "error", message: msg });
@@ -11316,30 +11411,28 @@ function collectInputs(node, incoming, portValues, initial, props, declaresProps
 function executorLookupIds(node) {
   const ids = [node.id];
   if (node.type) ids.push(node.type);
-  const declared = node.data?.kind;
-  const kindName = typeof declared === "string" && declared !== "" ? declared : node.type;
-  if (kindName && kindName !== node.type) ids.push(kindName);
-  for (const name of [kindName, node.type]) {
-    const kind = name ? getNodeKind(name) : null;
-    if (!kind) continue;
-    for (const id2 of kindIds(kind)) ids.push(id2);
+  const typeKind = node.type ? getNodeKind(node.type) : null;
+  if (typeKind) {
+    for (const id2 of kindIds(typeKind)) ids.push(id2);
+  } else {
+    const declared = node.data?.kind;
+    const kindName = typeof declared === "string" && declared !== "" ? declared : null;
+    if (kindName) {
+      ids.push(kindName);
+      const dataKind = getNodeKind(kindName);
+      if (dataKind) {
+        for (const id2 of kindIds(dataKind)) ids.push(id2);
+      }
+    }
   }
+  ids.push("*");
   return [...new Set(ids)];
 }
 function pickExecutor(executors, node) {
-  if (executors[node.id]) return executors[node.id];
-  if (node.type && executors[node.type]) return executors[node.type];
-  const declared = node.data?.kind;
-  const kindName = typeof declared === "string" && declared !== "" ? declared : node.type;
-  if (kindName && kindName !== node.type && executors[kindName]) return executors[kindName];
-  for (const name of [kindName, node.type]) {
-    const kind = name ? getNodeKind(name) : null;
-    if (!kind) continue;
-    for (const id2 of kindIds(kind)) {
-      if (executors[id2]) return executors[id2];
-    }
+  for (const id2 of executorLookupIds(node)) {
+    if (executors[id2]) return executors[id2];
   }
-  return executors["*"];
+  return void 0;
 }
 function activatedPorts(node, result) {
   if (result && typeof result === "object") {
@@ -11450,6 +11543,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)) {
@@ -11547,7 +11654,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",
@@ -11574,14 +11691,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 }]
@@ -14531,24 +14672,28 @@ function buildNodeTypes() {
   }
   return map;
 }
-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: ["text", "textarea", "number", "select", "switch"].includes(f.type) ? f.type : "text",
-    required: !!f.required,
-    placeholder: typeof f.placeholder === "string" ? f.placeholder : void 0,
-    options: Array.isArray(f.options) ? f.options : void 0,
-    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 INPUT_TYPE = {
+  text: "text",
+  number: "number",
+  date: "date",
+  datetime: "datetime-local",
+  time: "time",
+  email: "email",
+  url: "url",
+  tel: "tel",
+  password: "password"
+};
 function initialValues(fields) {
   const v2 = {};
-  for (const f of fields) v2[f.key] = f.type === "switch" ? !!f.default : f.default ?? "";
+  for (const f of fields) {
+    if (f.type === "switch") {
+      v2[f.key] = !!f.default;
+    } else if (f.type === "number") {
+      v2[f.key] = typeof f.default === "number" ? f.default : f.default === void 0 || f.default === "" ? "" : Number(f.default);
+    } else {
+      v2[f.key] = f.default ?? "";
+    }
+  }
   return v2;
 }
 function HumanPrompt({ request, onCancel }) {
@@ -14583,6 +14728,8 @@ function InputBody({
 }) {
   const [values, setValues] = ReactExports.useState(() => initialValues(request.fields));
   const set3 = (k2, v2) => setValues((prev) => ({ ...prev, [k2]: v2 }));
+  const uid = ReactExports.useId();
+  const fieldId = (key) => `${uid}-${key}`;
   const missing = request.fields.filter((f) => f.required && (values[f.key] === void 0 || values[f.key] === ""));
   const submit = () => {
     if (missing.length === 0) request.resolve(values);
@@ -14601,12 +14748,21 @@ function InputBody({
         }
       },
       children: [
-        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-prompt__fields", children: request.fields.map((f, i) => /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "ff-prompt__field", children: [
-          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "ff-prompt__label", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-prompt__fields", children: request.fields.map((f, i) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-prompt__field", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "ff-prompt__label", htmlFor: fieldId(f.key), children: [
             f.label ?? f.key,
-            f.required && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-prompt__req", children: " *" })
+            f.required && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-prompt__req", "aria-hidden": "true", children: " *" })
           ] }),
-          renderControl(f, values[f.key], (v2) => set3(f.key, v2), i === 0 ? firstRef : void 0)
+          /* @__PURE__ */ jsxRuntime.jsx(
+            FieldControl,
+            {
+              field: f,
+              id: fieldId(f.key),
+              value: values[f.key],
+              onChange: (v2) => set3(f.key, v2),
+              autoFocusRef: i === 0 ? firstRef : void 0
+            }
+          )
         ] }, f.key)) }),
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-prompt__actions", children: [
           /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: "ff-prompt__btn ff-prompt__btn--ghost", onClick: onCancel, children: "Cancel" }),
@@ -14616,45 +14772,68 @@ function InputBody({
     }
   );
 }
-function renderControl(f, value, onChange, ref) {
-  const common = { className: "ff-prompt__input", placeholder: f.placeholder };
-  if (f.type === "textarea") {
+function FieldControl({
+  field,
+  id: id2,
+  value,
+  onChange,
+  autoFocusRef
+}) {
+  const handle = { id: id2, "data-ff-field": field.key };
+  if (field.type === "textarea") {
     return /* @__PURE__ */ jsxRuntime.jsx(
       "textarea",
       {
-        ...common,
-        ref,
+        ...handle,
+        className: "ff-prompt__input",
+        placeholder: field.placeholder,
+        ref: autoFocusRef,
         rows: 3,
         value: String(value ?? ""),
         onChange: (e) => onChange(e.target.value)
       }
     );
   }
-  if (f.type === "switch") {
+  if (field.type === "switch") {
     return /* @__PURE__ */ jsxRuntime.jsx(
       "input",
       {
+        ...handle,
         type: "checkbox",
         className: "ff-prompt__switch",
+        ref: autoFocusRef,
         checked: !!value,
         onChange: (e) => onChange(e.target.checked)
       }
     );
   }
-  if (f.type === "select" && f.options && f.options.length) {
-    return /* @__PURE__ */ jsxRuntime.jsxs("select", { className: "ff-prompt__input", value: String(value ?? ""), onChange: (e) => onChange(e.target.value), children: [
-      /* @__PURE__ */ jsxRuntime.jsx("option", { value: "", disabled: true, children: "Choose\u2026" }),
-      f.options.map((o) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: o.value, children: o.label }, o.value))
-    ] });
+  if (field.type === "select") {
+    const options = field.options ?? [];
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "select",
+      {
+        ...handle,
+        className: "ff-prompt__input",
+        ref: autoFocusRef,
+        value: String(value ?? ""),
+        onChange: (e) => onChange(e.target.value),
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx("option", { value: "", disabled: true, children: options.length ? "Choose\u2026" : "No choices configured" }),
+          options.map((o) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: o.value, children: o.label }, o.value))
+        ]
+      }
+    );
   }
   return /* @__PURE__ */ jsxRuntime.jsx(
     "input",
     {
-      ...common,
-      ref,
-      type: f.type === "number" ? "number" : "text",
+      ...handle,
+      className: "ff-prompt__input",
+      placeholder: field.placeholder,
+      ref: autoFocusRef,
+      type: INPUT_TYPE[field.type ?? "text"] ?? "text",
       value: String(value ?? ""),
-      onChange: (e) => onChange(f.type === "number" ? e.target.value === "" ? "" : Number(e.target.value) : e.target.value)
+      onChange: (e) => onChange(field.type === "number" ? e.target.value === "" ? "" : Number(e.target.value) : e.target.value)
     }
   );
 }