@w6w/ui 0.2.0 → 0.2.54

package/dist/WorkflowFlowEditor.d.ts

@@ -1,12 +1,25 @@
-import { ExpressionOptions, ExpressionStepSource } from './components/ExpressionOptions.tsx';
+import { ExpressionLoopSource, ExpressionOptions, ExpressionStepSource } from './components/ExpressionOptions.tsx';
 import { FlowStep, FlowWorkflow } from './flow-types.ts';
+import { StepStartState } from './provider.tsx';
 import { RunState } from './run-visuals.ts';
+import { StepProblem, StepProblems } from './step-problems.ts';
 import { AppSummary } from './types.ts';
+/** What kind of change an `onChange` reports — see `WorkflowFlowEditorProps.onChange`. */
+export interface FlowChangeMeta {
+    viewportOnly?: true;
+}
 export interface WorkflowFlowEditorProps {
     /** The workflow being edited. The editor re-derives layout when this changes identity. */
     value: FlowWorkflow;
-    /** Fired whenever the user changes the graph — new nodes, edges, or step edits. */
-    onChange: (next: FlowWorkflow) => void;
+    /**
+     * Fired whenever the user changes the graph — new nodes, edges, or step edits.
+     *
+     * `meta.viewportOnly` is `true` when the change is the author's pan/zoom being
+     * written to `settings.viewport` and nothing else. A host that drops the shown
+     * run on an edit (so the run paint stops describing a workflow that changed)
+     * keeps it for these: moving the camera changes nothing that ran.
+     */
+    onChange: (next: FlowWorkflow, meta?: FlowChangeMeta) => void;
     /** Disable all interactions — pans/zooms are still enabled. */
     readOnly?: boolean;
     /** Height of the editor viewport. Defaults to 480px. */
@@ -59,6 +72,14 @@ export interface WorkflowFlowEditorProps {
      * back off a node.
      */
     runState?: RunState;
+    /**
+     * Host-detected per-step problems, keyed by step id — an app step whose bound
+     * connection no longer exists gets an error ring + tooltip. Omitted ⇒ the
+     * canvas renders exactly as today. The host owns detection; this editor never
+     * infers a problem itself. Repaints live (same `value.id`) and is never
+     * persisted: `flowToWorkflow` never reads `data.stepProblems`.
+     */
+    stepProblems?: StepProblems;
     /**
      * Fired the instant a step test starts — the ▶ collect form's Run button, or
      * `StepEditModal`'s footer Test button — before the invoke goes out, so a host
@@ -86,6 +107,31 @@ export interface WorkflowFlowEditorProps {
      * `onChange` and never overwrites the stored viewport.
      */
     fitViewKey?: string | number | boolean;
+    /**
+     * Run from a node: ▶ runs THAT node and then continues through every node downstream of it,
+     * following the edges the way a real run does, and stops BEFORE each paused node
+     * (`ui.paused`). The host enqueues it as a real run (`POST /workflows/:id/nodes/:nodeId/run`
+     * with `continue: true`) and shows it like any run — `runState` + its run log.
+     *
+     * Called from the ▶ collect form's Run button with:
+     * - `stopAt` — every paused node except the start node itself;
+     * - `state` — the upstream outputs the form seeded (saved step tests / the last run), the same
+     *   start state a single-node run is given;
+     * - `input` — the filled values, only when the start node is a trigger.
+     *
+     * Omitted ⇒ ▶ test-runs the single node exactly as before (and flow-control nodes have no ▶).
+     * A rejected promise is shown in the run modal.
+     */
+    onRunFromNode?: (nodeId: string, req: RunFromNodeRequest) => Promise<void> | void;
+}
+/** What {@link WorkflowFlowEditorProps.onRunFromNode} is called with. */
+export interface RunFromNodeRequest {
+    /** Paused node ids the run must stop before (never the start node). */
+    stopAt: string[];
+    /** Upstream outputs seeded from saved step tests / the last run; absent when none. */
+    state?: StepStartState;
+    /** The trigger's filled values — present only when the start node is a trigger. */
+    input?: Record<string, unknown>;
 }
 /** Which view the step edit modal opens in: the tabbed form, raw JSON, or node settings. */
 type EditView = "props" | "json" | "settings";
@@ -95,25 +141,46 @@ type EditView = "props" | "json" | "settings";
  *   - Auto-layouted on load (topological columns + sibling rows).
  *   - Nodes render differently for action steps vs. control steps
  *     (`uses.app === "@w6w/control"`).
- *   - `+ Step` opens a guided builder (pick app → connection → action → params,
+ *   - `+ Node` opens a guided builder (pick app → connection → action → params,
  *     or a flow control). Drag nodes to reposition; connect handles to add edges.
  *   - Selecting a node reveals a toolbar above it: Edit / Duplicate / Delete.
  *   - Edit opens a modal with a Form ⇄ JSON toggle for that step.
  *   - Every meaningful change fires `onChange` with an updated Workflow.
+ *   - Ctrl/Cmd+Z undoes graph edits; Ctrl/Cmd+Shift+Z (or Ctrl+Y) redoes them.
+ *     History is local to the open workflow and excludes tests, samples and viewport changes.
  */
 export declare function WorkflowFlowEditor(props: WorkflowFlowEditorProps): import("react").JSX.Element;
-export declare function StepEditModal({ workflowId, step: initialStep, upstreamSteps, onChange, onClose, readOnly, initialView, fanOutCount, onTestRun, }: {
+/**
+ * The state the Test tab PREVIEWS its resolved params against: the seeded `testStartState`
+ * (what the test will actually send) with, for each upstream `nodes.<id>.output` and the
+ * `trigger.event` that the seeds do not carry, the value the editor already previews in the ƒx
+ * Result (`sampleValues`: a persisted test's kept value or the app's declared `sample`). A seeded
+ * output always wins. Only the PREVIEW reads this; the invoke is still sent `testStartState`.
+ */
+export declare function previewStartState(state: StepStartState | undefined, sampleValues: Record<string, unknown> | undefined): StepStartState | undefined;
+export declare function StepEditModal(props: StepEditModalProps): import("react").JSX.Element;
+interface StepEditModalProps {
     workflowId: string;
     step: FlowStep;
+    /** Refresh authored fields after undo/redo without remounting the Test tab. */
+    restoreVersion?: number;
     /** Graph ancestors of this step (from `upstreamStateSources`); the incoming-state picker seeds from their saved tests. */
     upstreamSteps: ExpressionStepSource[];
+    /** The enclosing For each when this step is in its body: seeds `state.foreach` on Test. */
+    loop?: ExpressionLoopSource;
     onChange: (next: FlowStep) => void;
     onClose: () => void;
     readOnly?: boolean;
     initialView?: EditView;
-    /** Most outgoing edges this step has in one lane; "Run next steps" needs >= 2. */
+    /** Most outgoing edges this node has in one lane; "Run next nodes" needs >= 2. */
     fanOutCount?: number;
+    /** This step's own output field keys, offered by "Write to state" › Pick fields (free text still accepted). */
+    stateOutputFields?: string[];
     /** Fired the instant the footer Test button is clicked, before the test runs (T1.1.1). */
     onTestRun?: () => void;
-}): import("react").JSX.Element;
+    /** Host-supplied problems for this step; a dangling connection locks Configure/Test, a fixable one gets a button. */
+    stepProblems?: StepProblem[];
+    /** The graph's other node ids — a rename onto one of them is refused with a message. */
+    otherStepIds?: string[];
+}
 export {};

package/dist/app-pages.d.ts

@@ -5,6 +5,8 @@ export interface AppsPageQuery {
     q: string;
     /** Server-side category filter (e.g. `"ai"` for the AI tab), or absent. */
     category?: string;
+    /** Server-side id allow-list, or absent. */
+    ids?: string[];
 }
 /**
  * Two queries are the same fetch target when both fields match exactly