@octaviaflow/core 3.0.13 → 3.0.17-beta.0

package/dist/workflow/editor.d.ts

@@ -0,0 +1,181 @@
+import type { CSSProperties } from "react";
+export interface Position {
+    x: number;
+    y: number;
+}
+export interface Dimensions {
+    width: number;
+    height: number;
+}
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface Viewport {
+    x: number;
+    y: number;
+    zoom: number;
+}
+export type HandleType = "source" | "target";
+export type HandlePosition = "top" | "right" | "bottom" | "left";
+export type BuiltInNodeKind = "action" | "trigger" | "condition" | "loop" | "parallel" | "wait" | "output" | "error" | "group" | "sticky";
+export type NodeKind = BuiltInNodeKind | string;
+export interface WorkflowNode<TData = unknown> {
+    id: string;
+    /** Registry key — `"action"` etc., or any custom string. */
+    type: NodeKind;
+    /** Always absolute flow-space coordinates (see ADR-003). */
+    position: Position;
+    /** Consumer payload — the node renderer reads from `data`. */
+    data: TData;
+    selected?: boolean;
+    dragging?: boolean;
+    hidden?: boolean;
+    width?: number;
+    height?: number;
+    isConnectable?: boolean;
+    parentId?: string;
+    extent?: "parent" | [Position, Position];
+    zIndex?: number;
+    sourcePosition?: HandlePosition;
+    targetPosition?: HandlePosition;
+    ariaLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+export type BuiltInEdgeKind = "default" | "conditional" | "loop" | "error" | "straight" | "smoothstep";
+export type EdgeKind = BuiltInEdgeKind | string;
+/**
+ * Visual routing for the edge path. Independent of `edge.type` (which
+ * carries semantics like conditional / error). Defaults to "bezier".
+ */
+export type EdgeRouting = "bezier" | "step" | "smoothstep" | "straight";
+export interface WorkflowEdge<TData = unknown> {
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+    /** Semantic type — drives stroke colour and dash pattern. */
+    type?: EdgeKind;
+    /** Visual path routing — bezier (default), step, smoothstep, straight. */
+    routing?: EdgeRouting;
+    data?: TData;
+    selected?: boolean;
+    animated?: boolean;
+    hidden?: boolean;
+    label?: string;
+    zIndex?: number;
+    /** Hit area width — default 16 px on mouse, 32 px on coarse pointers. */
+    interactionWidth?: number;
+    ariaLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+export interface Connection {
+    source: string;
+    target: string;
+    sourceHandle?: string | null;
+    targetHandle?: string | null;
+}
+export interface ConnectStartParams {
+    nodeId: string;
+    handleId: string | null;
+    handleType: HandleType;
+}
+export interface ConnectEndState {
+    /** Was the gesture cancelled (no valid target)? */
+    cancelled: boolean;
+    /** Pixel position where the user released the pointer (screen coords). */
+    position: Position;
+    /** Same position in flow coordinates. Useful for "drop on canvas to spawn a node." */
+    flowPosition: Position;
+    /** The handle the drag started from. */
+    from: ConnectStartParams;
+    /** The handle the drag landed on, if any. */
+    to?: ConnectStartParams;
+}
+export type NodeChange<TData = unknown> = {
+    type: "add";
+    item: WorkflowNode<TData>;
+} | {
+    type: "remove";
+    id: string;
+} | {
+    type: "position";
+    id: string;
+    position: Position;
+    dragging: boolean;
+} | {
+    type: "dimensions";
+    id: string;
+    dimensions: Dimensions;
+} | {
+    type: "select";
+    id: string;
+    selected: boolean;
+} | {
+    type: "replace";
+    id: string;
+    item: WorkflowNode<TData>;
+};
+export type EdgeChange<TData = unknown> = {
+    type: "add";
+    item: WorkflowEdge<TData>;
+} | {
+    type: "remove";
+    id: string;
+} | {
+    type: "select";
+    id: string;
+    selected: boolean;
+} | {
+    type: "replace";
+    id: string;
+    item: WorkflowEdge<TData>;
+};
+export interface SelectionState {
+    nodes: WorkflowNode[];
+    edges: WorkflowEdge[];
+}
+export interface FlowStoreSnapshot {
+    nodes: WorkflowNode[];
+    edges: WorkflowEdge[];
+    viewport: Viewport;
+    selectedNodeIds: ReadonlySet<string>;
+    selectedEdgeIds: ReadonlySet<string>;
+    /** In-flight connection drag, if any. */
+    connection: ConnectStartParams | null;
+}
+export interface FitViewOptions {
+    padding?: number;
+    maxZoom?: number;
+    minZoom?: number;
+    duration?: number;
+    /** Restrict to a subset of nodes. */
+    nodes?: {
+        id: string;
+    }[];
+}
+export type LayoutDirection = "TB" | "BT" | "LR" | "RL";
+export interface LayoutOptions {
+    direction?: LayoutDirection;
+    nodeSpacing?: number;
+    rankSpacing?: number;
+    /** Engine-specific options (typed escape hatch). */
+    engine?: Record<string, unknown>;
+}
+export interface LayoutEngine {
+    name: string;
+    /**
+     * Compute new positions. Engines may skip nodes (e.g. those with
+     * `data.layoutLocked`); the caller patches only the returned ids.
+     */
+    layout(nodes: WorkflowNode[], edges: WorkflowEdge[], options?: LayoutOptions): Promise<{
+        id: string;
+        position: Position;
+    }[]>;
+}
+//# sourceMappingURL=editor.d.ts.map

package/dist/workflow/editor.d.ts.map

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

package/dist/workflow/hooks/useAutoLayout.d.ts

@@ -0,0 +1,35 @@
+import type { LayoutEngine, LayoutOptions, NodeChange, WorkflowEdge, WorkflowNode } from "../editor";
+export interface UseAutoLayoutOptions {
+    /** The engine. Required. */
+    engine: LayoutEngine | null | undefined;
+    /** Current nodes (controlled). */
+    nodes: WorkflowNode[];
+    /** Current edges (controlled). */
+    edges: WorkflowEdge[];
+    /** Where to send position changes. Required. */
+    onNodesChange?: (changes: NodeChange[]) => void;
+    /** Layout options forwarded to the engine. */
+    options?: LayoutOptions;
+    /** Re-run on every graph-shape change (debounced 250ms). Default false. */
+    auto?: boolean;
+    /** Debounce delay for `auto` mode (ms). Default 250. */
+    debounceMs?: number;
+    /** Called after each successful run. */
+    onLayout?: (positions: {
+        id: string;
+        position: {
+            x: number;
+            y: number;
+        };
+    }[]) => void;
+    /** Called when the engine throws (network / worker / library). */
+    onError?: (err: unknown) => void;
+}
+export interface UseAutoLayoutResult {
+    /** Manually trigger a layout pass. Returns the promise of the engine. */
+    runLayout(): Promise<void>;
+    /** True while a layout pass is in flight. */
+    isLaying: boolean;
+}
+export declare function useAutoLayout({ engine, nodes, edges, onNodesChange, options, auto, debounceMs, onLayout, onError, }: UseAutoLayoutOptions): UseAutoLayoutResult;
+//# sourceMappingURL=useAutoLayout.d.ts.map

package/dist/workflow/hooks/useAutoLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoLayout.d.ts","sourceRoot":"","sources":["../../../src/workflow/hooks/useAutoLayout.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACb,MAAM,WAAW,CAAC;AAGnB,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,kCAAkC;IAClC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,kCAAkC;IAClC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,gDAAgD;IAChD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;IAChD,8CAA8C;IAC9C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EAAE,KAAK,IAAI,CAAC;IACrF,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAmBD,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,KAAK,EACL,aAAa,EACb,OAAO,EACP,IAAY,EACZ,UAAgB,EAChB,QAAQ,EACR,OAAO,GACR,EAAE,oBAAoB,GAAG,mBAAmB,CAmH5C"}

package/dist/workflow/hooks/useFlow.d.ts

@@ -0,0 +1,61 @@
+import type { FitViewOptions, Position, Rect, Viewport, WorkflowEdge, WorkflowNode } from "../editor";
+export interface FlowInstance {
+    getViewport(): Viewport;
+    setViewport(viewport: Viewport, opts?: {
+        duration?: number;
+    }): void;
+    setCenter(x: number, y: number, opts?: {
+        duration?: number;
+        zoom?: number;
+    }): void;
+    fitView(opts?: FitViewOptions): Promise<boolean>;
+    zoomIn(opts?: {
+        step?: number;
+    }): void;
+    zoomOut(opts?: {
+        step?: number;
+    }): void;
+    zoomTo(level: number): void;
+    /** Convert a pointer position (relative to the canvas container) into
+     *  flow-space coordinates. */
+    screenToFlowPosition(p: Position): Position;
+    /** Inverse of `screenToFlowPosition`. */
+    flowToScreenPosition(p: Position): Position;
+    getNodes(): WorkflowNode[];
+    getEdges(): WorkflowEdge[];
+    getNode(id: string): WorkflowNode | undefined;
+    getEdge(id: string): WorkflowEdge | undefined;
+    /** Axis-aligned bounding box of the given nodes (or every node when omitted). */
+    getNodesBounds(nodes?: {
+        id: string;
+    }[]): Rect;
+    /** Find every node whose bbox overlaps the given rect.
+     *  `partially=true` includes partial overlaps; `false` requires full containment. */
+    getIntersectingNodes(area: Rect, partially?: boolean): WorkflowNode[];
+    addNodes(nodes: WorkflowNode | WorkflowNode[]): void;
+    addEdges(edges: WorkflowEdge | WorkflowEdge[]): void;
+    /** Merge a partial into the node's existing `data` field. Cheap shorthand
+     *  for the common case of editing a node's payload without rebuilding it. */
+    updateNodeData<TData = unknown>(id: string, partial: Partial<TData>): void;
+    /** Replace the node entirely (use sparingly — usually `updateNodeData` is enough). */
+    updateNode(id: string, partial: Partial<WorkflowNode>): void;
+    /** Imperatively remove nodes and/or edges. Returns false if the host's
+     *  `onBeforeDelete` vetoed; true otherwise. Synchronous for non-async
+     *  vetoes; awaits the promise when the host returns one. */
+    deleteElements(params: {
+        nodes?: {
+            id: string;
+        }[];
+        edges?: {
+            id: string;
+        }[];
+    }): Promise<boolean>;
+}
+export declare const FlowInstanceContext: import("react").Context<FlowInstance>;
+/**
+ * Imperative handle for `<FlowCanvas>`. Throws if called outside the
+ * canvas — the instance is canvas-scoped (not a global singleton) so
+ * multiple canvases on the same page each have their own.
+ */
+export declare function useFlow(): FlowInstance;
+//# sourceMappingURL=useFlow.d.ts.map

package/dist/workflow/hooks/useFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFlow.d.ts","sourceRoot":"","sources":["../../../src/workflow/hooks/useFlow.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,YAAY,EACb,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,YAAY;IAE3B,WAAW,IAAI,QAAQ,CAAC;IACxB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnF,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAG5B;kCAC8B;IAC9B,oBAAoB,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5C,yCAAyC;IACzC,oBAAoB,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAG5C,QAAQ,IAAI,YAAY,EAAE,CAAC;IAC3B,QAAQ,IAAI,YAAY,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC9C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC9C,iFAAiF;IACjF,cAAc,CAAC,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI,CAAC;IAC/C;yFACqF;IACrF,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,YAAY,EAAE,CAAC;IAGtE,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC;IACrD;iFAC6E;IAC7E,cAAc,CAAC,KAAK,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC3E,sFAAsF;IACtF,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC7D;;gEAE4D;IAC5D,cAAc,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClG;AAED,eAAO,MAAM,mBAAmB,uCAA2C,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,YAAY,CAMtC"}

package/dist/workflow/hooks/useFlowState.d.ts

@@ -0,0 +1,33 @@
+import type { EdgeChange, NodeChange, WorkflowEdge, WorkflowNode } from "../editor";
+export interface UseFlowStateOptions<TNData = unknown, TEData = unknown> {
+    initialNodes?: WorkflowNode<TNData>[];
+    initialEdges?: WorkflowEdge<TEData>[];
+}
+/**
+ * Patch type for `updateNodeData` — accepts a partial object that gets
+ * shallow-merged, or a producer function `(prev) => next`.
+ */
+export type NodeDataPatch<TNData> = Partial<TNData> | ((prev: TNData | undefined) => TNData | undefined);
+export interface FlowStateBag<TNData = unknown, TEData = unknown> {
+    nodes: WorkflowNode<TNData>[];
+    edges: WorkflowEdge<TEData>[];
+    onNodesChange: (changes: NodeChange<TNData>[]) => void;
+    onEdgesChange: (changes: EdgeChange<TEData>[]) => void;
+    setNodes: (update: WorkflowNode<TNData>[] | ((prev: WorkflowNode<TNData>[]) => WorkflowNode<TNData>[])) => void;
+    setEdges: (update: WorkflowEdge<TEData>[] | ((prev: WorkflowEdge<TEData>[]) => WorkflowEdge<TEData>[])) => void;
+    /**
+     * Update the `data` slice of a single node by id. Only that node's
+     * reference changes — every other node keeps its previous reference,
+     * so React.memo'd kind components for unrelated nodes do not re-render.
+     * No-ops when `id` is not present in the current nodes array.
+     */
+    updateNodeData: (id: string, patch: NodeDataPatch<TNData>) => void;
+    /**
+     * Read a single node by id from the latest snapshot. Returns undefined
+     * if the id is unknown. Useful inside imperative callbacks that need
+     * the freshest value without subscribing to re-renders.
+     */
+    getNode: (id: string) => WorkflowNode<TNData> | undefined;
+}
+export declare function useFlowState<TNData = unknown, TEData = unknown>(options?: UseFlowStateOptions<TNData, TEData>): FlowStateBag<TNData, TEData>;
+//# sourceMappingURL=useFlowState.d.ts.map

package/dist/workflow/hooks/useFlowState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFlowState.d.ts","sourceRoot":"","sources":["../../../src/workflow/hooks/useFlowState.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGpF,MAAM,WAAW,mBAAmB,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IACrE,YAAY,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,IAC5B,OAAO,CAAC,MAAM,CAAC,GACf,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;AAEvD,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IAC9D,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9B,aAAa,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;IACvD,aAAa,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;IACvD,QAAQ,EAAE,CACR,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,KAAK,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,KACxF,IAAI,CAAC;IACV,QAAQ,EAAE,CACR,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,KAAK,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,KACxF,IAAI,CAAC;IACV;;;;;OAKG;IACH,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACnE;;;;OAIG;IACH,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,YAAY,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CAC3D;AAED,wBAAgB,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAC7D,OAAO,GAAE,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAM,GAChD,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAiD9B"}

package/dist/workflow/index.d.ts

@@ -0,0 +1,25 @@
+export type { BuiltInEdgeKind, BuiltInNodeKind, ConnectEndState, Connection, ConnectStartParams, Dimensions, EdgeChange, EdgeKind, FitViewOptions, HandlePosition, HandleType, LayoutDirection, LayoutEngine, LayoutOptions, NodeChange, NodeKind, Position, Rect, SelectionState, Viewport, WorkflowEdge, WorkflowNode, } from "./editor";
+export { type UseAutoLayoutOptions, type UseAutoLayoutResult, useAutoLayout, } from "./hooks/useAutoLayout";
+export { type FlowInstance, useFlow } from "./hooks/useFlow";
+export { type FlowStateBag, type NodeDataPatch, type UseFlowStateOptions, useFlowState, } from "./hooks/useFlowState";
+export { type CreateDagreEngineOptions, createDagreEngine } from "./layout/dagre";
+export { type CreateElkEngineOptions, createElkEngine } from "./layout/elk";
+export type { DagreGraph, DagreLike, ElkEdge, ElkGraph, ElkLike, } from "./layout/types";
+export { applyEdgeChanges, applyNodeChanges, change } from "./store/changes";
+export { useConnection, useEdgeById, useEdges, useFlowSelector, useIsEdgeSelected, useIsNodeSelected, useNodeById, useNodeData, useNodes, useSelection, useViewport, } from "./store/selectors";
+export { ConfigPanel, type ConfigPanelProps, type ConfigPanelSaveState, type ConfigPanelTab, } from "./components/ConfigPanel/ConfigPanel";
+export { FlowCanvas, type FlowCanvasProps } from "./components/FlowCanvas/FlowCanvas";
+export { FlowEdge, type FlowEdgeProps } from "./components/FlowEdge/FlowEdge";
+export { FlowNode, type FlowNodeProps } from "./components/FlowNode/FlowNode";
+export { type FlowNodeContextValue, useFlowNodeContext, } from "./components/FlowNode/FlowNodeContext";
+export { buildNodeKindRegistry, type NodeKindComponent, type NodeKindProps, type NodeKindRegistry, } from "./components/FlowNode/nodeKinds";
+export { Handle, type HandleProps } from "./components/Handle/Handle";
+export { ActionNode, type BuiltInNodeData, ConditionNode, DEFAULT_NODE_KINDS, ErrorNode, ForEachNode, GroupNode, HttpRequestNode, OutputNode, ParallelNode, StickyNode, TriggerNode, WaitNode, WebhookNode, } from "./components/kinds";
+export { NodeResizer, type NodeResizerProps } from "./components/NodeResizer/NodeResizer";
+export { NodeToolbar, type NodeToolbarProps } from "./components/NodeToolbar/NodeToolbar";
+export type { EdgeRouting } from "./editor";
+export { collapseFor, toggleGroupCollapse } from "./utils/collapse";
+export { bezierPath, DEFAULT_NODE_HEIGHT, DEFAULT_NODE_WIDTH, flowToScreen, handleCentre, screenToFlow, } from "./utils/geometry";
+export { clampToParentExtent, descendantsOf, findAncestor, findContainingGroup, } from "./utils/parenting";
+export { bezierPath as bezierPathFn, buildEdgePath, type EdgeRouting as EdgeRoutingMode, type PathGeometry, smoothStepPath, stepPath, straightPath, } from "./utils/paths";
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/index.d.ts.map

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

package/dist/workflow/layout/dagre.d.ts

@@ -0,0 +1,24 @@
+import type { LayoutEngine, LayoutOptions } from "../editor";
+import type { DagreLike } from "./types";
+export interface CreateDagreEngineOptions {
+    /** Default spacing between nodes within a rank (default 60). */
+    nodeSpacing?: number;
+    /** Default spacing between ranks (default 80). */
+    rankSpacing?: number;
+    /** Default direction — TB, BT, LR, RL. Defaults to TB. */
+    direction?: LayoutOptions["direction"];
+}
+/**
+ * Build a `LayoutEngine` backed by a consumer-supplied `dagre` module.
+ *
+ * `dagre` can be passed as either the default export or the namespace
+ * import (`import * as dagre from "dagre"`). The adapter probes both
+ * shapes so consumers don't have to think about it.
+ */
+export declare function createDagreEngine(dagre: DagreLike | {
+    default: DagreLike;
+} | {
+    graphlib: DagreLike["graphlib"];
+    layout: DagreLike["layout"];
+}, defaults?: CreateDagreEngineOptions): LayoutEngine;
+//# sourceMappingURL=dagre.d.ts.map

package/dist/workflow/layout/dagre.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dagre.d.ts","sourceRoot":"","sources":["../../../src/workflow/layout/dagre.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAwC,MAAM,WAAW,CAAC;AAEnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EACD,SAAS,GACT;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,GACtB;IAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAA;CAAE,EACpE,QAAQ,GAAE,wBAA6B,GACtC,YAAY,CA+Dd"}

package/dist/workflow/layout/elk.d.ts

@@ -0,0 +1,22 @@
+import type { LayoutEngine, LayoutOptions } from "../editor";
+import type { ElkLike } from "./types";
+export interface CreateElkEngineOptions {
+    /** Default direction — TB / BT / LR / RL. Defaults to TB. */
+    direction?: LayoutOptions["direction"];
+    /** Default node-to-node spacing within a layer (default 60). */
+    nodeSpacing?: number;
+    /** Default layer-to-layer spacing (default 80). */
+    rankSpacing?: number;
+    /** Override the algorithm. Defaults to `layered` (Sugiyama). */
+    algorithm?: "layered" | "mrtree" | "force" | "stress" | "radial" | "disco" | "rectpacking" | "box";
+}
+/**
+ * Build a `LayoutEngine` backed by a consumer-supplied `elkjs` instance.
+ *
+ * The consumer is responsible for constructing the ELK instance (which
+ * may or may not run in a Web Worker — that's a `workerUrl` constructor
+ * option on their end). Our adapter just calls `elk.layout(graph)` and
+ * patches positions back.
+ */
+export declare function createElkEngine(elk: ElkLike, defaults?: CreateElkEngineOptions): LayoutEngine;
+//# sourceMappingURL=elk.d.ts.map

package/dist/workflow/layout/elk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elk.d.ts","sourceRoot":"","sources":["../../../src/workflow/layout/elk.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAwC,MAAM,WAAW,CAAC;AAEnG,OAAO,KAAK,EAAqB,OAAO,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IACvC,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,CAAC,EACN,SAAS,GACT,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,aAAa,GACb,KAAK,CAAC;CACX;AASD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,GAAE,sBAA2B,GAAG,YAAY,CAuFjG"}

package/dist/workflow/layout/types.d.ts

@@ -0,0 +1,55 @@
+export type { LayoutDirection, LayoutEngine, LayoutOptions, } from "../editor";
+/**
+ * Minimal Dagre surface we depend on. The consumer passes their imported
+ * `dagre` module (default or namespace). Anything our adapter touches
+ * must be on this shape.
+ */
+export interface DagreLike {
+    graphlib: {
+        Graph: new (opts?: {
+            multigraph?: boolean;
+            compound?: boolean;
+        }) => DagreGraph;
+    };
+    layout(g: DagreGraph): void;
+}
+export interface DagreGraph {
+    setGraph(opts: Record<string, unknown>): DagreGraph;
+    setDefaultEdgeLabel(fn: () => unknown): DagreGraph;
+    setNode(id: string, node: {
+        width: number;
+        height: number;
+        [k: string]: unknown;
+    }): DagreGraph;
+    setEdge(source: string, target: string, label?: Record<string, unknown>): DagreGraph;
+    node(id: string): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
+    nodes(): string[];
+}
+/**
+ * Minimal elkjs surface. The consumer passes either an `ELK` class or an
+ * already-constructed instance — we accept both.
+ */
+export interface ElkLike {
+    layout(graph: ElkGraph, options?: Record<string, unknown>): Promise<ElkGraph>;
+}
+export interface ElkGraph {
+    id: string;
+    layoutOptions?: Record<string, string>;
+    width?: number;
+    height?: number;
+    x?: number;
+    y?: number;
+    children?: ElkGraph[];
+    edges?: ElkEdge[];
+}
+export interface ElkEdge {
+    id: string;
+    sources: string[];
+    targets: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflow/layout/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflow/layout/types.ts"],"names":[],"mappings":"AAOA,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,WAAW,CAAC;AAOnB;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE;QACR,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,KAAK,UAAU,CAAC;KAChF,CAAC;IACF,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC;IACpD,mBAAmB,CAAC,EAAE,EAAE,MAAM,OAAO,GAAG,UAAU,CAAC;IACnD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,UAAU,CAAC;IAC/F,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC;IACrF,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACtF,KAAK,IAAI,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/workflow/store/changes.d.ts

@@ -0,0 +1,34 @@
+import type { EdgeChange, NodeChange, WorkflowEdge, WorkflowNode } from "../editor";
+/**
+ * Apply a batch of node changes to an existing node list. Returns a
+ * **new array** if anything changed, the **same array** otherwise (so
+ * React.memo'd children don't re-render unnecessarily).
+ */
+export declare function applyNodeChanges<TData = unknown>(nodes: WorkflowNode<TData>[], changes: NodeChange<TData>[]): WorkflowNode<TData>[];
+/**
+ * Apply a batch of edge changes. Same shape as `applyNodeChanges`.
+ */
+export declare function applyEdgeChanges<TData = unknown>(edges: WorkflowEdge<TData>[], changes: EdgeChange<TData>[]): WorkflowEdge<TData>[];
+export declare const change: {
+    node: {
+        add<TData>(item: WorkflowNode<TData>): NodeChange<TData>;
+        remove<TData>(id: string): NodeChange<TData>;
+        position<TData>(id: string, position: {
+            x: number;
+            y: number;
+        }, dragging: boolean): NodeChange<TData>;
+        dimensions<TData>(id: string, dimensions: {
+            width: number;
+            height: number;
+        }): NodeChange<TData>;
+        select<TData>(id: string, selected: boolean): NodeChange<TData>;
+        replace<TData>(id: string, item: WorkflowNode<TData>): NodeChange<TData>;
+    };
+    edge: {
+        add<TData>(item: WorkflowEdge<TData>): EdgeChange<TData>;
+        remove<TData>(id: string): EdgeChange<TData>;
+        select<TData>(id: string, selected: boolean): EdgeChange<TData>;
+        replace<TData>(id: string, item: WorkflowEdge<TData>): EdgeChange<TData>;
+    };
+};
+//# sourceMappingURL=changes.d.ts.map

package/dist/workflow/store/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../../src/workflow/store/changes.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEpF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAC9C,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,EAC5B,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,GAC3B,YAAY,CAAC,KAAK,CAAC,EAAE,CA4EvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAC9C,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,EAC5B,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,GAC3B,YAAY,CAAC,KAAK,CAAC,EAAE,CAuDvB;AAMD,eAAO,MAAM,MAAM;;YAEX,KAAK,QAAQ,YAAY,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;eAGjD,KAAK,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;iBAGnC,KAAK,MACR,MAAM,YACA;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,YACxB,OAAO,GAChB,UAAU,CAAC,KAAK,CAAC;mBAGT,KAAK,MACV,MAAM,cACE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAC5C,UAAU,CAAC,KAAK,CAAC;eAGb,KAAK,MAAM,MAAM,YAAY,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;gBAGvD,KAAK,MAAM,MAAM,QAAQ,YAAY,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;;;YAKpE,KAAK,QAAQ,YAAY,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;eAGjD,KAAK,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;eAGrC,KAAK,MAAM,MAAM,YAAY,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;gBAGvD,KAAK,MAAM,MAAM,QAAQ,YAAY,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;;CAI3E,CAAC"}

package/dist/workflow/store/context.d.ts

@@ -0,0 +1,4 @@
+import type { FlowStore } from "./createFlowStore";
+export declare const FlowStoreContext: import("react").Context<FlowStore>;
+export declare function useFlowStore(): FlowStore;
+//# sourceMappingURL=context.d.ts.map

package/dist/workflow/store/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/workflow/store/context.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,oCAAwC,CAAC;AAEtE,wBAAgB,YAAY,IAAI,SAAS,CAQxC"}

package/dist/workflow/store/createFlowStore.d.ts

@@ -0,0 +1,27 @@
+import type { ConnectStartParams, FlowStoreSnapshot, Viewport, WorkflowEdge, WorkflowNode } from "../editor";
+type Listener = () => void;
+export interface FlowStore {
+    /** React subscription hook contract — used by `useSyncExternalStore`. */
+    subscribe(listener: Listener): () => void;
+    /** Cheap snapshot getter — must return the same ref between mutations. */
+    getSnapshot(): FlowStoreSnapshot;
+    /** Imperative setters — called by the canvas internals, never by consumers. */
+    setNodes(nodes: WorkflowNode[]): void;
+    setEdges(edges: WorkflowEdge[]): void;
+    setViewport(viewport: Viewport): void;
+    setSelection(nodes: ReadonlySet<string>, edges: ReadonlySet<string>): void;
+    setConnection(connection: ConnectStartParams | null): void;
+}
+export interface CreateFlowStoreOptions {
+    initialNodes?: WorkflowNode[];
+    initialEdges?: WorkflowEdge[];
+    initialViewport?: Viewport;
+}
+/**
+ * Build a FlowStore for one canvas instance. Designed to be created in
+ * `useState(() => createFlowStore())` inside FlowCanvas so a single
+ * `<FlowCanvas>` owns exactly one store and unmounting cleans it up.
+ */
+export declare function createFlowStore({ initialNodes, initialEdges, initialViewport, }?: CreateFlowStoreOptions): FlowStore;
+export {};
+//# sourceMappingURL=createFlowStore.d.ts.map

package/dist/workflow/store/createFlowStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFlowStore.d.ts","sourceRoot":"","sources":["../../../src/workflow/store/createFlowStore.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,YAAY,EACb,MAAM,WAAW,CAAC;AAEnB,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;IAC1C,0EAA0E;IAC1E,WAAW,IAAI,iBAAiB,CAAC;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACtC,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtC,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3E,aAAa,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,eAAe,CAAC,EAAE,QAAQ,CAAC;CAC5B;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,YAAiB,EACjB,YAAiB,EACjB,eAAkC,GACnC,GAAE,sBAA2B,GAAG,SAAS,CA0DzC"}

package/dist/workflow/store/selectors.d.ts

@@ -0,0 +1,33 @@
+import type { ConnectStartParams, FlowStoreSnapshot, Viewport, WorkflowEdge, WorkflowNode } from "../editor";
+/**
+ * Generic selector hook. Use for one-off reads in tests or rare cases.
+ * Public hooks below cover the common paths.
+ *
+ * NB: `selector` must be stable (referentially equal across renders) or
+ * memoised — otherwise it re-subscribes every render. We do NOT do this
+ * automatically because it would mask the bug.
+ */
+export declare function useFlowSelector<T>(selector: (snapshot: FlowStoreSnapshot) => T, isEqual?: (a: T, b: T) => boolean): T;
+export declare function useNodes(): WorkflowNode[];
+export declare function useEdges(): WorkflowEdge[];
+export declare function useViewport(): Viewport;
+export declare function useNodeById(id: string): WorkflowNode | undefined;
+/**
+ * Subscribe to the `data` slice of a single node by id. Re-renders only
+ * when this specific node's `data` reference changes — no cross-node
+ * leakage. Pair with `FlowStateBag.updateNodeData(id, patch)` to write.
+ *
+ * Returns undefined when the node is not present; consumers should
+ * branch on that. Typed via the generic so callers get their `TData`
+ * shape back without casting.
+ */
+export declare function useNodeData<TData = unknown>(id: string): TData | undefined;
+export declare function useEdgeById(id: string): WorkflowEdge | undefined;
+export declare function useIsNodeSelected(id: string): boolean;
+export declare function useIsEdgeSelected(id: string): boolean;
+export declare function useConnection(): ConnectStartParams | null;
+export declare function useSelection(): {
+    nodes: WorkflowNode[];
+    edges: WorkflowEdge[];
+};
+//# sourceMappingURL=selectors.d.ts.map

package/dist/workflow/store/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../../src/workflow/store/selectors.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,YAAY,EACb,MAAM,WAAW,CAAC;AAGnB;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,CAAC,EAC5C,OAAO,GAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAmB,GAC3C,CAAC,CAYH;AAID,wBAAgB,QAAQ,IAAI,YAAY,EAAE,CAEzC;AAED,wBAAgB,QAAQ,IAAI,YAAY,EAAE,CAEzC;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAI1E;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,aAAa,IAAI,kBAAkB,GAAG,IAAI,CAEzD;AAED,wBAAgB,YAAY,IAAI;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE,CAe/E"}