@octaviaflow/core 3.0.13 → 3.0.17-beta.0

package/dist/workflow/types/index.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=index.d.ts.map

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

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

package/dist/workflow/utils/collapse.d.ts

@@ -0,0 +1,26 @@
+import type { WorkflowEdge, WorkflowNode } from "../editor";
+interface CollapseResult {
+    nodes: WorkflowNode[];
+    edges: WorkflowEdge[];
+    /** Per-collapsed-group: how many descendants got hidden. The host UI
+     *  reads this to render a "N steps" badge. */
+    hiddenCountByGroupId: Map<string, number>;
+}
+/**
+ * Given the canonical graph, return a derived graph that respects the
+ * `collapsed` flag on every group node:
+ *
+ *  - Descendants of a collapsed group are marked `hidden`.
+ *  - Edges that crossed the collapse boundary are rewritten: their
+ *    source (or target) becomes the collapsed group's id, and the
+ *    handle is reset to a synthetic perimeter handle (`__group_out` /
+ *    `__group_in`). Internal-to-internal edges are dropped.
+ */
+export declare function collapseFor(nodes: WorkflowNode[], edges: WorkflowEdge[]): CollapseResult;
+/**
+ * Toggle the `data.collapsed` flag on a group node. Returns the patched
+ * nodes array (immutable). Useful in event handlers.
+ */
+export declare function toggleGroupCollapse(groupId: string, nodes: WorkflowNode[]): WorkflowNode[];
+export {};
+//# sourceMappingURL=collapse.d.ts.map

package/dist/workflow/utils/collapse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapse.d.ts","sourceRoot":"","sources":["../../../src/workflow/utils/collapse.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE5D,UAAU,cAAc;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB;kDAC8C;IAC9C,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,cAAc,CA+FxF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAM1F"}

package/dist/workflow/utils/collision.d.ts

@@ -0,0 +1,37 @@
+import type { Position, WorkflowNode } from "../editor";
+export interface CollisionOptions {
+    /** Minimum gap (px) the dragged node must keep from each other node.
+     *
+     *   - `gap >= 0` — the resolver is **enabled**. `gap === 0` means
+     *     "no overlap, zero buffer" (strict no-overlap). `gap > 0` enforces
+     *     a buffer of that many pixels.
+     *   - `gap < 0` — the resolver is **disabled** (returns the proposed
+     *     position unchanged). This is the no-op sentinel used by
+     *     consumers that haven't opted into magnet behaviour. */
+    gap: number;
+    /** Cap iterative resolutions — prevents infinite loops in pathological
+     *  geometries (e.g. four nodes hugging a single corner). Default 8. */
+    maxIterations?: number;
+    /** Node ids that the resolver should ignore — typically the dragged
+     *  node itself plus its descendants (so a parent doesn't collide with
+     *  its own children) and its ancestors (so a child doesn't collide
+     *  with its containing group). */
+    exclude?: Set<string>;
+    /** When true, only consider nodes that share the same `parentId` as
+     *  the dragged node (i.e. its siblings). When false, all non-excluded
+     *  nodes participate. Defaults to true — this is the "rooms" model
+     *  where children of group A never collide with children of group B
+     *  even if their bboxes overlap in flow space.  */
+    scopeToSiblings?: boolean;
+}
+/**
+ * Adjust a proposed (flow-space) position so the node's bbox stays at
+ * least `gap` pixels away from every other (non-excluded) node's bbox.
+ *
+ * The function does NOT mutate the input nodes; it returns a new
+ * `Position`. The caller is responsible for emitting the resulting
+ * change via `onNodesChange` — collision resolution doesn't dispatch
+ * anything on its own.
+ */
+export declare function resolveNodeCollisions(node: WorkflowNode, proposed: Position, others: WorkflowNode[], opts: CollisionOptions): Position;
+//# sourceMappingURL=collision.d.ts.map

package/dist/workflow/utils/collision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision.d.ts","sourceRoot":"","sources":["../../../src/workflow/utils/collision.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGxD,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;iEAO6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ;2EACuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;sCAGkC;IAClC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB;;;;uDAImD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,YAAY,EAAE,EACtB,IAAI,EAAE,gBAAgB,GACrB,QAAQ,CAmFV"}

package/dist/workflow/utils/geometry.d.ts

@@ -0,0 +1,46 @@
+import type { HandlePosition, Position, Viewport, WorkflowNode } from "../editor";
+export declare const DEFAULT_NODE_WIDTH = 368;
+export declare const DEFAULT_NODE_HEIGHT = 96;
+export declare const COLLAPSED_GROUP_HEIGHT = 36;
+export declare const COLLAPSED_FOREACH_HEIGHT = 40;
+/**
+ * The height the node *actually renders at* — accounts for collapsed
+ * containers whose visual height differs from `node.height`. All edge
+ * geometry should go through this helper instead of reading
+ * `node.height` directly.
+ */
+export declare function effectiveHeight(node: WorkflowNode): number;
+/**
+ * Compute the absolute (flow-space) centre of one of a node's handles.
+ *
+ * The handle's logical position (`top`/`right`/`bottom`/`left`) plus its
+ * index among same-side handles determines a deterministic spread along
+ * the relevant edge of the node bbox. We do NOT consult the DOM — the
+ * source of truth is the node's measured (or default) dimensions.
+ *
+ * `total` is the count of handles on that side, `index` is this handle's
+ * 0-based position among them. A single handle centres; multiple spread
+ * evenly with equal margins.
+ */
+export declare function handleCentre(node: WorkflowNode, side: HandlePosition, index: number, total: number): Position;
+/**
+ * Cubic bezier path between two oriented points. The control points are
+ * offset along each port's facing direction so the curve leaves and
+ * enters along the port's axis (the same routing model as v1).
+ */
+export declare function bezierPath(start: Position, startSide: HandlePosition, end: Position, endSide: HandlePosition): {
+    d: string;
+    midX: number;
+    midY: number;
+};
+/**
+ * Convert a screen-space point (pixels relative to the viewport
+ * container's top-left) to flow-space coordinates, given the current
+ * viewport.
+ */
+export declare function screenToFlow(p: Position, vp: Viewport): Position;
+/**
+ * Inverse of `screenToFlow`.
+ */
+export declare function flowToScreen(p: Position, vp: Viewport): Position;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/workflow/utils/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../src/workflow/utils/geometry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAMlF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAQtC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAO1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,QAAQ,CAsBV;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,cAAc,EACzB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,cAAc,GACtB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAU3C;AAeD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAKhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAKhE"}

package/dist/workflow/utils/parenting.d.ts

@@ -0,0 +1,28 @@
+import type { Position, WorkflowNode } from "../editor";
+/**
+ * Returns the transitive descendants of a node — i.e. every node whose
+ * `parentId` chain ends at `nodeId`. Stable order (DFS). The root node
+ * is NOT included.
+ */
+export declare function descendantsOf(nodeId: string, nodes: WorkflowNode[]): WorkflowNode[];
+/**
+ * Walk up the parent chain. Returns the first ancestor that satisfies
+ * `predicate`, or undefined.
+ */
+export declare function findAncestor(node: WorkflowNode, nodes: WorkflowNode[], predicate: (n: WorkflowNode) => boolean): WorkflowNode | undefined;
+/**
+ * Clamp a proposed child position to its parent's bounding box. The
+ * child is kept fully inside the parent — child's bottom-right corner
+ * cannot exceed the parent's bottom-right.
+ *
+ * Returns the original position if the node has no parent or extent
+ * isn't `'parent'`.
+ */
+export declare function clampToParentExtent(node: WorkflowNode, proposed: Position, nodes: WorkflowNode[]): Position;
+/**
+ * Hit-test which group node (if any) currently contains the given point.
+ * Used by Alt-drop to re-parent a node into a group, and by drop-to-add
+ * to scope a new node.
+ */
+export declare function findContainingGroup(point: Position, nodes: WorkflowNode[], exclude?: string[]): WorkflowNode | undefined;
+//# sourceMappingURL=parenting.d.ts.map

package/dist/workflow/utils/parenting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parenting.d.ts","sourceRoot":"","sources":["../../../src/workflow/utils/parenting.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGxD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CA0BnF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,YAAY,EAAE,EACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,GACtC,YAAY,GAAG,SAAS,CAY1B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,YAAY,EAAE,GACpB,QAAQ,CAgBV;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,MAAM,EAAO,GACrB,YAAY,GAAG,SAAS,CAqB1B"}

package/dist/workflow/utils/paths.d.ts

@@ -0,0 +1,19 @@
+import type { HandlePosition, Position } from "../editor";
+export type EdgeRouting = "bezier" | "step" | "smoothstep" | "straight";
+export interface PathGeometry {
+    d: string;
+    midX: number;
+    midY: number;
+    /** Tangent angle (radians) at the midpoint — useful when callers want
+     *  to offset the label/delete chrome along or perpendicular to the path. */
+    midAngle: number;
+}
+export declare function buildEdgePath(routing: EdgeRouting, start: Position, startSide: HandlePosition, end: Position, endSide: HandlePosition, options?: {
+    borderRadius?: number;
+    curvature?: number;
+}): PathGeometry;
+export declare function bezierPath(start: Position, startSide: HandlePosition, end: Position, endSide: HandlePosition, curvature?: number): PathGeometry;
+export declare function stepPath(start: Position, startSide: HandlePosition, end: Position, endSide: HandlePosition): PathGeometry;
+export declare function smoothStepPath(start: Position, startSide: HandlePosition, end: Position, endSide: HandlePosition, borderRadius?: number): PathGeometry;
+export declare function straightPath(start: Position, end: Position): PathGeometry;
+//# sourceMappingURL=paths.d.ts.map

package/dist/workflow/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/workflow/utils/paths.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;gFAC4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,cAAc,EACzB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1D,YAAY,CAWd;AAQD,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,cAAc,EACzB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,cAAc,EACvB,SAAS,SAAO,GACf,YAAY,CA0Bd;AAoDD,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,cAAc,EACzB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,cAAc,GACtB,YAAY,CAOd;AAGD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,cAAc,EACzB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,cAAc,EACvB,YAAY,SAAI,GACf,YAAY,CAwBd;AAGD,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,YAAY,CAQzE"}