@flowdrop/flowdrop 1.14.0 → 1.15.0

package/dist/types/index.d.ts

@@ -202,7 +202,7 @@ export declare function dynamicPortToNodePort(port: DynamicPort, portType: 'inpu
  * Built-in node types for explicit component rendering.
  * These are the node types that ship with FlowDrop.
  */
-export type BuiltinNodeType = 'note' | 'simple' | 'square' | 'tool' | 'gateway' | 'terminal' | 'default';
+export type BuiltinNodeType = 'note' | 'simple' | 'square' | 'atom' | 'tool' | 'gateway' | 'terminal' | 'default';
 /**
  * Node type for component rendering.
  * Includes built-in types and allows custom registered types.
@@ -306,8 +306,13 @@ export interface AutocompleteConfig {
      * If the "account" field currently holds "my-jira", the URL becomes:
      * /api/jira/issue-types?account=my-jira&q=...
      *
-     * When any dependency field changes, the autocomplete clears its
-     * current value and invalidates the suggestion cache.
+     * When a dependency field changes, the component invalidates its cached
+     * suggestions and aborts any in-flight fetch. The dependent field's own
+     * value is cleared by the parent form (`ConfigForm` / `SchemaForm`) on
+     * user-driven edits only — undo/redo, programmatic value replacement, and
+     * collaborative edits flow in via props and preserve dependent values.
+     * Standalone consumers of `FormAutocomplete` outside a FlowDrop form
+     * therefore need to clear dependents themselves.
      */
     params?: Record<string, string>;
 }
@@ -495,9 +500,39 @@ export interface ConfigEditOptions {
  * UI-related extension settings for nodes
  * Used to control visual behavior in the workflow editor
  */
+/**
+ * Display/behavior config for minimalist "atom" nodes (Constant, Cast, …).
+ * Lives under `extensions.ui.atom`. The atom renderer reads it to decide what to
+ * show, and `getAllPorts` reads `valueTypeKey` to drive the bound output port's
+ * dataType from config so connection validation stays correct.
+ */
+export interface AtomUIConfig {
+    /** Config key whose value becomes the node body. Falls back to `data.label`. */
+    valueKey?: string;
+    /**
+     * Config key holding the selected value's type (a port dataType id).
+     * The bound output port adopts this dataType.
+     */
+    valueTypeKey?: string;
+    /** Output port id driven by `valueTypeKey`. Defaults to the first output port. */
+    outputPortId?: string;
+    /** Body shape. `'pill'` (default) is fully rounded; `'rectangle'` is lightly rounded. */
+    shape?: 'pill' | 'rectangle';
+    /**
+     * Dimmed affordance rendered before the body (e.g. `'→ '` to mark a transform).
+     * Stays visible while the body value ellipsizes. Hidden in the empty state.
+     */
+    prefix?: string;
+    /** Text shown (dimmed) when the resolved body value is empty/unset. */
+    placeholder?: string;
+    /** Max body width in px before the label ellipsizes. */
+    maxWidth?: number;
+}
 export interface NodeUIExtensions {
     /** Show/hide unconnected handles (ports) to reduce visual noise */
     hideUnconnectedHandles?: boolean;
+    /** Display/behavior config for minimalist atom nodes (Constant, Cast, …) */
+    atom?: AtomUIConfig;
     /**
      * Visual-only port display order (no effect on execution).
      * Arrays of port IDs in the desired render order.

package/dist/utils/formMerge.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Form value merge — shared by `SchemaForm` and `ConfigForm`.
+ *
+ * Produces the view of form values that children read via context. Precedence
+ * per key:
+ *
+ *   1. `key in edits`            → use the user's local edit
+ *   2. `source[key] !== undefined` → use the prop value (including null/0/false/'')
+ *   3. otherwise                  → use the schema field's `default`
+ *
+ * Keeping this separate from the host components means the test pins the same
+ * function the components run, not a parallel implementation.
+ */
+export declare function mergeWithDefaults(schema: {
+    properties?: Record<string, unknown>;
+} | undefined, source: Record<string, unknown>, edits: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Compute the cascade-clear set when a single field changes — shared by
+ * `SchemaForm` and `ConfigForm`.
+ *
+ * When `changedKey` changes, any property whose `autocomplete.params` references
+ * `changedKey` (directly or transitively) should have its value cleared: the
+ * old dependent value was computed against the old parent value and is now
+ * stale.
+ *
+ * Returns a map of `{ dependentKey -> clearValue }` to apply on top of the
+ * caller's edits buffer. Single-value autocompletes clear to `''`; ones with
+ * `multiple: true` clear to `[]`.
+ *
+ * This logic lives in the parent form (not in `FormAutocomplete`) so it only
+ * runs on user-driven changes via `handleFieldChange`, not on undo/redo,
+ * programmatic resets, or collaborative edits (#33).
+ */
+export declare function cascadeClearAutocompleteDependents(schema: {
+    properties?: Record<string, unknown>;
+} | undefined, changedKey: string): Record<string, unknown>;

package/dist/utils/formMerge.js

@@ -0,0 +1,70 @@
+/**
+ * Form value merge — shared by `SchemaForm` and `ConfigForm`.
+ *
+ * Produces the view of form values that children read via context. Precedence
+ * per key:
+ *
+ *   1. `key in edits`            → use the user's local edit
+ *   2. `source[key] !== undefined` → use the prop value (including null/0/false/'')
+ *   3. otherwise                  → use the schema field's `default`
+ *
+ * Keeping this separate from the host components means the test pins the same
+ * function the components run, not a parallel implementation.
+ */
+export function mergeWithDefaults(schema, source, edits) {
+    if (!schema?.properties)
+        return {};
+    const merged = {};
+    for (const [key, field] of Object.entries(schema.properties)) {
+        if (key in edits) {
+            merged[key] = edits[key];
+        }
+        else {
+            const fieldConfig = field;
+            merged[key] = source[key] !== undefined ? source[key] : fieldConfig.default;
+        }
+    }
+    return merged;
+}
+/**
+ * Compute the cascade-clear set when a single field changes — shared by
+ * `SchemaForm` and `ConfigForm`.
+ *
+ * When `changedKey` changes, any property whose `autocomplete.params` references
+ * `changedKey` (directly or transitively) should have its value cleared: the
+ * old dependent value was computed against the old parent value and is now
+ * stale.
+ *
+ * Returns a map of `{ dependentKey -> clearValue }` to apply on top of the
+ * caller's edits buffer. Single-value autocompletes clear to `''`; ones with
+ * `multiple: true` clear to `[]`.
+ *
+ * This logic lives in the parent form (not in `FormAutocomplete`) so it only
+ * runs on user-driven changes via `handleFieldChange`, not on undo/redo,
+ * programmatic resets, or collaborative edits (#33).
+ */
+export function cascadeClearAutocompleteDependents(schema, changedKey) {
+    if (!schema?.properties)
+        return {};
+    const cleared = new Set([changedKey]);
+    const result = {};
+    let added = true;
+    while (added) {
+        added = false;
+        for (const [depKey, depField] of Object.entries(schema.properties)) {
+            if (cleared.has(depKey))
+                continue;
+            const field = depField;
+            const params = field.autocomplete?.params;
+            if (!params)
+                continue;
+            const dependsOnCleared = Object.values(params).some((fieldName) => cleared.has(fieldName));
+            if (dependsOnCleared) {
+                result[depKey] = field.autocomplete?.multiple ? [] : '';
+                cleared.add(depKey);
+                added = true;
+            }
+        }
+    }
+    return result;
+}

package/dist/utils/nodeTypes.js

@@ -18,6 +18,7 @@ const TYPE_DISPLAY_NAMES = {
     note: 'Note (sticky note style)',
     simple: 'Simple (compact layout)',
     square: 'Square (geometric layout)',
+    atom: 'Atom (minimal value/transform)',
     tool: 'Tool (specialized for agent tools)',
     gateway: 'Gateway (branching control flow)',
     terminal: 'Terminal (start/end/exit)',

package/package.json

@@ -3,7 +3,7 @@
   "description": "A drop-in visual workflow editor for any web application. You own the backend. You own the data. You own the orchestration.",
   "license": "MIT",
   "private": false,
-  "version": "1.14.0",
+  "version": "1.15.0",
   "author": "Shibin Das (D34dMan)",
   "bugs": {
     "url": "https://github.com/flowdrop-io/flowdrop/issues"