@executioncontrolprotocol/format-reactflow 0.12.0

package/dist/ports-from-zod.js

@@ -0,0 +1,169 @@
+import { introspectCapabilitySchema } from "@executioncontrolprotocol/core";
+import { parseStateRef } from "./extract-data-edges.js";
+import { valueSchemaFromEqlLabel, valueSchemasFromCapabilitySchema, } from "./value-schema-hint.js";
+const LITERAL_PREVIEW_MAX = 56;
+function typeLabelFor(eqlTypes, name, required) {
+    const raw = eqlTypes?.[name];
+    if (raw)
+        return raw;
+    return required ? "unknown!" : "unknown";
+}
+function attachValueSchema(port, schemas, typeLabel) {
+    const fromCap = schemas.get(port.name);
+    if (fromCap) {
+        port.valueSchema = fromCap;
+        return;
+    }
+    const fromLabel = valueSchemaFromEqlLabel(typeLabel);
+    if (fromLabel)
+        port.valueSchema = fromLabel;
+}
+function isRefValue(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "$ref" in value &&
+        typeof value.$ref === "string");
+}
+/**
+ * Compact string form of a literal input value (for previews / editors).
+ * @category Encoding
+ */
+export function formatLiteralValue(value) {
+    if (typeof value === "string")
+        return value;
+    if (value === null)
+        return "null";
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Truncate a literal for port row display.
+ * @category Encoding
+ */
+export function truncateLiteralPreview(full, max = LITERAL_PREVIEW_MAX) {
+    if (full.length <= max)
+        return full;
+    return `${full.slice(0, Math.max(0, max - 1))}…`;
+}
+function applyInputBindings(inputs, step) {
+    if (!step.input)
+        return;
+    const byName = new Map(inputs.map((p) => [p.name, p]));
+    for (const [name, value] of Object.entries(step.input)) {
+        let port = byName.get(name);
+        if (!port) {
+            port = { id: name, name, typeLabel: "unknown", required: false };
+            inputs.push(port);
+            byName.set(name, port);
+        }
+        if (isRefValue(value)) {
+            const parsed = parseStateRef(value.$ref);
+            port.binding = "ref";
+            port.refPath = parsed
+                ? parsed.fieldPath
+                    ? `${parsed.asKey}.${parsed.fieldPath}`
+                    : parsed.asKey
+                : value.$ref.replace(/^state\./, "");
+            delete port.valuePreview;
+            delete port.valueTitle;
+            continue;
+        }
+        const full = formatLiteralValue(value);
+        port.binding = "literal";
+        port.valueTitle = full;
+        port.valuePreview = truncateLiteralPreview(full);
+        delete port.refPath;
+    }
+}
+/**
+ * Ensure an output port exists for a data-edge source handle.
+ * @category Encoding
+ */
+export function ensureOutputPort(outputs, handleId) {
+    if (outputs.some((p) => p.id === handleId))
+        return;
+    outputs.push({
+        id: handleId,
+        name: handleId,
+        typeLabel: "unknown",
+    });
+}
+/**
+ * Build input/output ports from capability Zod schemas, with input-key fallback
+ * and literal / `$ref` binding metadata from `step.input`.
+ * @category Encoding
+ */
+export function portsForStep(step, registry) {
+    const cap = registry?.getCapability(String(step.uses));
+    const inputFields = introspectCapabilitySchema(cap?.inputSchema);
+    const outputFields = introspectCapabilitySchema(cap?.outputSchema);
+    const inputSchemas = valueSchemasFromCapabilitySchema(cap?.inputSchema);
+    const outputSchemas = valueSchemasFromCapabilitySchema(cap?.outputSchema);
+    const inputs = [];
+    const seenInputs = new Set();
+    for (const name of inputFields.required) {
+        seenInputs.add(name);
+        const typeLabel = typeLabelFor(inputFields.eqlTypes, name, true);
+        const port = {
+            id: name,
+            name,
+            typeLabel,
+            required: true,
+        };
+        attachValueSchema(port, inputSchemas, typeLabel);
+        inputs.push(port);
+    }
+    for (const name of inputFields.optional) {
+        seenInputs.add(name);
+        const typeLabel = typeLabelFor(inputFields.eqlTypes, name, false);
+        const port = {
+            id: name,
+            name,
+            typeLabel,
+            required: false,
+        };
+        attachValueSchema(port, inputSchemas, typeLabel);
+        inputs.push(port);
+    }
+    if (step.input) {
+        for (const name of Object.keys(step.input)) {
+            if (seenInputs.has(name))
+                continue;
+            const port = {
+                id: name,
+                name,
+                typeLabel: "unknown",
+                required: false,
+            };
+            attachValueSchema(port, inputSchemas, "unknown");
+            inputs.push(port);
+        }
+    }
+    applyInputBindings(inputs, step);
+    const outputs = [];
+    for (const name of [...outputFields.required, ...outputFields.optional]) {
+        const typeLabel = typeLabelFor(outputFields.eqlTypes, name, outputFields.required.includes(name));
+        const port = {
+            id: name,
+            name,
+            typeLabel,
+        };
+        attachValueSchema(port, outputSchemas, typeLabel);
+        outputs.push(port);
+    }
+    if (outputs.length === 0 && step.as) {
+        outputs.push({
+            id: "output",
+            name: "output",
+            typeLabel: "unknown",
+        });
+    }
+    return { inputs, outputs };
+}
+//# sourceMappingURL=ports-from-zod.js.map

package/dist/ports-from-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports-from-zod.js","sourceRoot":"","sources":["../src/ports-from-zod.ts"],"names":[],"mappings":"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"}

package/dist/progress.d.ts

@@ -0,0 +1,19 @@
+import type { ReactFlowRunLifecycleDetail, ReactFlowStepStatus } from "./types.js";
+/** Progress event names. @category Encoding */
+export type ReactFlowProgressEventName = "run:reset" | "step:status" | "run:done";
+/**
+ * Browser-safe progress bus for React Flow run visualization.
+ * Listeners receive CustomEvent with typed detail.
+ * @category Encoding
+ */
+export declare class ReactFlowRunProgress extends EventTarget {
+    /** Emit run reset (all steps pending). */
+    emitReset(detail?: ReactFlowRunLifecycleDetail): void;
+    /** Emit a step status change. */
+    emitStepStatus(stepId: string, status: ReactFlowStepStatus): void;
+    /** Emit run completion. */
+    emitDone(detail?: ReactFlowRunLifecycleDetail): void;
+}
+/** Shared progress bus for the format-reactflow extension hooks. @category Encoding */
+export declare const reactFlowRunProgress: ReactFlowRunProgress;
+//# sourceMappingURL=progress.d.ts.map

package/dist/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,mBAAmB,EAEpB,MAAM,YAAY,CAAA;AAEnB,+CAA+C;AAC/C,MAAM,MAAM,0BAA0B,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAA;AAEjF;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,0CAA0C;IAC1C,SAAS,CAAC,MAAM,GAAE,2BAAgC,GAAG,IAAI;IAIzD,iCAAiC;IACjC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAKjE,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,GAAE,2BAAgC,GAAG,IAAI;CAGzD;AAED,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,sBAA6B,CAAA"}

package/dist/progress.js

@@ -0,0 +1,23 @@
+/**
+ * Browser-safe progress bus for React Flow run visualization.
+ * Listeners receive CustomEvent with typed detail.
+ * @category Encoding
+ */
+export class ReactFlowRunProgress extends EventTarget {
+    /** Emit run reset (all steps pending). */
+    emitReset(detail = {}) {
+        this.dispatchEvent(new CustomEvent("run:reset", { detail }));
+    }
+    /** Emit a step status change. */
+    emitStepStatus(stepId, status) {
+        const detail = { stepId, status };
+        this.dispatchEvent(new CustomEvent("step:status", { detail }));
+    }
+    /** Emit run completion. */
+    emitDone(detail = {}) {
+        this.dispatchEvent(new CustomEvent("run:done", { detail }));
+    }
+}
+/** Shared progress bus for the format-reactflow extension hooks. @category Encoding */
+export const reactFlowRunProgress = new ReactFlowRunProgress();
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,0CAA0C;IAC1C,SAAS,CAAC,SAAsC,EAAE;QAChD,IAAI,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,iCAAiC;IACjC,cAAc,CAAC,MAAc,EAAE,MAA2B;QACxD,MAAM,MAAM,GAA8B,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QAC5D,IAAI,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAChE,CAAC;IAED,2BAA2B;IAC3B,QAAQ,CAAC,SAAsC,EAAE;QAC/C,IAAI,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAC7D,CAAC;CACF;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+/** How a step input is supplied on the graph. @category Encoding */
+export type ReactFlowPortBinding = "literal" | "ref";
+/** Port on a React Flow step node. @category Encoding */
+export interface ReactFlowPort {
+    /** Handle id (matches edge sourceHandle / targetHandle). */
+    id: string;
+    /** Parameter / field name. */
+    name: string;
+    /** Human-readable type (EQL-ish or `unknown`). */
+    typeLabel: string;
+    /**
+     * Portable JSON Schema hint for the port value (primitives + constraints).
+     * Never includes UI widget names — viewers map this to controls.
+     */
+    valueSchema?: Record<string, unknown>;
+    /** Whether the field is required (inputs only). */
+    required?: boolean;
+    /** How this input is supplied (`literal` `.with()` value or `$ref`). */
+    binding?: ReactFlowPortBinding;
+    /** Truncated display for literal values. */
+    valuePreview?: string;
+    /** Full literal string for tooltip / editor seed. */
+    valueTitle?: string;
+    /** Short `$ref` path without `state.` (e.g. `summary.text`). */
+    refPath?: string;
+}
+/** Step node payload. @category Encoding */
+export interface ReactFlowStepData {
+    /** Display label. */
+    label: string;
+    /** Capability id (`uses`). */
+    uses?: string;
+    /** Commit key (`as`). */
+    as?: string;
+    /** Input handles. */
+    inputs: ReactFlowPort[];
+    /** Output handles. */
+    outputs: ReactFlowPort[];
+}
+/**
+ * Group node payload (optional viewer type; encoder emits step nodes only).
+ * @category Encoding
+ */
+export interface ReactFlowGroupData {
+    /** Display label. */
+    label: string;
+    /** Structural kind. */
+    kind: "parallel" | "branch" | "loop" | "workflow";
+}
+/** Workflow I/O projection (`accepts` / `returns`) — not a capability step. @category Encoding */
+export type ReactFlowIoKind = "accepts" | "returns";
+/** Payload for projected Inputs / Outputs nodes. @category Encoding */
+export interface ReactFlowIoData {
+    /** Display label (`Inputs` / `Outputs`). */
+    label: string;
+    /** Which workflow contract this node edits. */
+    kind: ReactFlowIoKind;
+    /** Input handles (Outputs node only). */
+    inputs: ReactFlowPort[];
+    /** Output handles (Inputs node only). */
+    outputs: ReactFlowPort[];
+}
+/** React Flow node. @category Encoding */
+export interface ReactFlowNode {
+    /** Node id (typically a workflow step id). */
+    id: string;
+    /** Node type for the viewer. */
+    type: "ecp-step" | "ecp-group" | "ecp-io";
+    /** Layout position (absolute; canvas is the workflow surface). */
+    position: {
+        x: number;
+        y: number;
+    };
+    /** Node payload. */
+    data: ReactFlowStepData | ReactFlowGroupData | ReactFlowIoData;
+    /** Soft size hint for layout. */
+    style?: {
+        width?: number;
+        height?: number;
+    };
+}
+/** Edge kind. @category Encoding */
+export type ReactFlowEdgeKind = "data" | "control";
+/** React Flow edge. @category Encoding */
+export interface ReactFlowEdge {
+    /** Edge id. */
+    id: string;
+    /** Source node id. */
+    source: string;
+    /** Target node id. */
+    target: string;
+    /** Source handle id. */
+    sourceHandle?: string;
+    /** Target handle id. */
+    targetHandle?: string;
+    /** Edge metadata. */
+    data: {
+        kind: ReactFlowEdgeKind;
+    };
+}
+/** Encoded React Flow document. @category Encoding */
+export interface ReactFlowDocument {
+    /** Nodes. */
+    nodes: ReactFlowNode[];
+    /** Edges. */
+    edges: ReactFlowEdge[];
+}
+/** Encode options. @category Encoding */
+export interface ReactFlowEncodeOptions {
+    /** Rank direction for dagre. Default `LR`. */
+    direction?: "LR" | "TB";
+    /** Node width used for layout. */
+    nodeWidth?: number;
+    /** Node height used for layout. */
+    nodeHeight?: number;
+}
+/** Step run status for progress events. @category Encoding */
+export type ReactFlowStepStatus = "idle" | "pending" | "running" | "completed" | "failed";
+/** Detail for `step:status` progress events. @category Encoding */
+export interface ReactFlowStepStatusDetail {
+    /** Workflow step id. */
+    stepId: string;
+    /** Status. */
+    status: ReactFlowStepStatus;
+}
+/** Detail for `run:reset` / `run:done`. @category Encoding */
+export interface ReactFlowRunLifecycleDetail {
+    /** Run id when available. */
+    runId?: string;
+    /** Terminal outcome when done. */
+    outcome?: "completed" | "failed" | "cancelled";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/value-schema-hint.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+/** JSON Schema fragment used as a portable port type hint. @category Encoding */
+export type ValueSchemaHint = Record<string, unknown>;
+/**
+ * Unwrap Zod wrappers that do not change the value shape for UI hints.
+ * @category Encoding
+ */
+export declare function unwrapZodType(type: z.ZodType): z.ZodType;
+/**
+ * Project a Zod type to a primitive-centered JSON Schema hint.
+ * Enums stay `type: "string"` (or number) with an `enum` constraint — never a widget name.
+ * @category Encoding
+ */
+export declare function valueSchemaFromZod(type: z.ZodType): ValueSchemaHint | undefined;
+/**
+ * Synthesize a minimal valueSchema from an EQL-ish type label (`string!`, `number`, …).
+ * @category Encoding
+ */
+export declare function valueSchemaFromEqlLabel(typeLabel: string): ValueSchemaHint | undefined;
+/**
+ * Pass through a JSON Schema property node as a valueSchema hint (shallow clone).
+ * @category Encoding
+ */
+export declare function valueSchemaFromJsonSchemaProp(prop: unknown): ValueSchemaHint | undefined;
+/**
+ * Build a name → valueSchema map from a capability input/output schema.
+ * Supports Zod objects and JSON Schema objects with `properties`.
+ * @category Encoding
+ */
+export declare function valueSchemasFromCapabilitySchema(schema: unknown): Map<string, ValueSchemaHint>;
+//# sourceMappingURL=value-schema-hint.d.ts.map

package/dist/value-schema-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-schema-hint.d.ts","sourceRoot":"","sources":["../src/value-schema-hint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,iFAAiF;AACjF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAErD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAWxD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,GAAG,eAAe,GAAG,SAAS,CAkE/E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAWtF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAGxF;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,OAAO,GACd,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAwB9B"}

package/dist/value-schema-hint.js

@@ -0,0 +1,156 @@
+import { z } from "zod";
+/**
+ * Unwrap Zod wrappers that do not change the value shape for UI hints.
+ * @category Encoding
+ */
+export function unwrapZodType(type) {
+    if (type instanceof z.ZodOptional) {
+        return unwrapZodType(type.unwrap());
+    }
+    if (type instanceof z.ZodDefault) {
+        return unwrapZodType(type.removeDefault());
+    }
+    if (type instanceof z.ZodNullable) {
+        return unwrapZodType(type.unwrap());
+    }
+    return type;
+}
+/**
+ * Project a Zod type to a primitive-centered JSON Schema hint.
+ * Enums stay `type: "string"` (or number) with an `enum` constraint — never a widget name.
+ * @category Encoding
+ */
+export function valueSchemaFromZod(type) {
+    const inner = unwrapZodType(type);
+    if (inner instanceof z.ZodString) {
+        return { type: "string" };
+    }
+    if (inner instanceof z.ZodNumber) {
+        return { type: "number" };
+    }
+    if (inner instanceof z.ZodBoolean) {
+        return { type: "boolean" };
+    }
+    if (inner instanceof z.ZodNull) {
+        return { type: "null" };
+    }
+    if (inner instanceof z.ZodEnum) {
+        const values = inner.options;
+        return { type: "string", enum: [...values] };
+    }
+    if (inner instanceof z.ZodNativeEnum) {
+        const raw = inner.enum;
+        const values = Object.values(raw).filter((v) => typeof v === "string" || typeof v === "number");
+        const allNumber = values.every((v) => typeof v === "number");
+        return {
+            type: allNumber ? "number" : "string",
+            enum: values,
+        };
+    }
+    if (inner instanceof z.ZodLiteral) {
+        const value = inner.value;
+        if (typeof value === "string")
+            return { type: "string", enum: [value] };
+        if (typeof value === "number")
+            return { type: "number", enum: [value] };
+        if (typeof value === "boolean")
+            return { type: "boolean", enum: [value] };
+        return undefined;
+    }
+    if (inner instanceof z.ZodArray) {
+        const items = valueSchemaFromZod(inner.element);
+        return items ? { type: "array", items } : { type: "array" };
+    }
+    if (inner instanceof z.ZodObject) {
+        const properties = {};
+        for (const [name, field] of Object.entries(inner.shape)) {
+            const child = valueSchemaFromZod(field);
+            if (child)
+                properties[name] = child;
+        }
+        return Object.keys(properties).length > 0
+            ? { type: "object", properties }
+            : { type: "object" };
+    }
+    if (inner instanceof z.ZodRecord) {
+        return { type: "object" };
+    }
+    if (inner instanceof z.ZodUnion || inner instanceof z.ZodDiscriminatedUnion) {
+        const options = inner.options
+            .map((opt) => valueSchemaFromZod(opt))
+            .filter((s) => Boolean(s));
+        if (options.length === 0)
+            return undefined;
+        if (options.length === 1)
+            return options[0];
+        return { oneOf: options };
+    }
+    if (inner instanceof z.ZodAny || inner instanceof z.ZodUnknown) {
+        return {};
+    }
+    return undefined;
+}
+/**
+ * Synthesize a minimal valueSchema from an EQL-ish type label (`string!`, `number`, …).
+ * @category Encoding
+ */
+export function valueSchemaFromEqlLabel(typeLabel) {
+    const base = typeLabel.replace(/!+$/, "").trim().toLowerCase();
+    if (!base || base === "unknown")
+        return undefined;
+    if (base === "string")
+        return { type: "string" };
+    if (base === "number" || base === "float")
+        return { type: "number" };
+    if (base === "int" || base === "integer")
+        return { type: "integer" };
+    if (base === "boolean" || base === "bool")
+        return { type: "boolean" };
+    if (base === "null")
+        return { type: "null" };
+    if (base === "array")
+        return { type: "array" };
+    if (base === "object" || base === "record" || base === "json")
+        return { type: "object" };
+    return undefined;
+}
+/**
+ * Pass through a JSON Schema property node as a valueSchema hint (shallow clone).
+ * @category Encoding
+ */
+export function valueSchemaFromJsonSchemaProp(prop) {
+    if (prop === null || typeof prop !== "object" || Array.isArray(prop))
+        return undefined;
+    return { ...prop };
+}
+/**
+ * Build a name → valueSchema map from a capability input/output schema.
+ * Supports Zod objects and JSON Schema objects with `properties`.
+ * @category Encoding
+ */
+export function valueSchemasFromCapabilitySchema(schema) {
+    const out = new Map();
+    if (schema === null || schema === undefined)
+        return out;
+    if (schema instanceof z.ZodObject) {
+        for (const [name, field] of Object.entries(schema.shape)) {
+            const hint = valueSchemaFromZod(field);
+            if (hint)
+                out.set(name, hint);
+        }
+        return out;
+    }
+    if (typeof schema === "object" && !Array.isArray(schema)) {
+        const obj = schema;
+        const props = obj.properties;
+        if (props && typeof props === "object" && !Array.isArray(props)) {
+            for (const [name, prop] of Object.entries(props)) {
+                const hint = valueSchemaFromJsonSchemaProp(prop);
+                if (hint)
+                    out.set(name, hint);
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=value-schema-hint.js.map

package/dist/value-schema-hint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-schema-hint.js","sourceRoot":"","sources":["../src/value-schema-hint.ts"],"names":[],"mappings":"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"}

package/dist/workflow-to-reactflow.d.ts

@@ -0,0 +1,11 @@
+import type { Registry } from "@executioncontrolprotocol/core";
+import type { WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { ReactFlowDocument, ReactFlowEncodeOptions } from "./types.js";
+/**
+ * Convert a workflow manifest into a positioned React Flow document.
+ * Emits step nodes, projected Inputs / Outputs (`ecp-io`), and **data** edges.
+ * Sequential control edges are used internally for layout, then discarded.
+ * @category Encoding
+ */
+export declare function workflowToReactFlow(manifest: WorkflowManifest, registry?: Registry, options?: ReactFlowEncodeOptions): ReactFlowDocument;
+//# sourceMappingURL=workflow-to-reactflow.d.ts.map

package/dist/workflow-to-reactflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-to-reactflow.d.ts","sourceRoot":"","sources":["../src/workflow-to-reactflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,KAAK,EAAY,gBAAgB,EAAgB,MAAM,iCAAiC,CAAA;AAW/F,OAAO,KAAK,EACV,iBAAiB,EAEjB,sBAAsB,EAGvB,MAAM,YAAY,CAAA;AAwLnB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,CAAC,EAAE,QAAQ,EACnB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,iBAAiB,CA4CnB"}