@realflow/core 0.1.0

package/dist/spatial.js

@@ -0,0 +1,175 @@
+import { rectsIntersect } from './geometry.js';
+/**
+ * A uniform-grid spatial hash for fast viewport culling and hit testing.
+ *
+ * Nodes are bucketed by the grid cells their bounds overlap. Queries visit
+ * only the cells intersecting the query rect, so lookups stay O(result)
+ * instead of O(total nodes) — the key to keeping 10k+ node flows smooth.
+ */
+export class SpatialIndex {
+    cellSize;
+    cells = new Map();
+    bounds = new Map();
+    /**
+     * Rects too large (or non-finite) to bucket sanely. Iterating the grid
+     * cells of, say, a 1e308-wide rect would loop ~1e305 times and hang — a
+     * real DoS vector when an agent/LLM emits a degenerate node size. Such
+     * rects are kept here and always considered by queries/hits instead.
+     */
+    oversized = new Set();
+    /** Max grid cells a single rect may span before it's treated as oversized. */
+    static MAX_CELLS = 4096;
+    constructor(cellSize = 512) {
+        this.cellSize = cellSize;
+    }
+    get size() {
+        return this.bounds.size;
+    }
+    /**
+     * Largest cell index magnitude we bucket. Beyond ~2^40, floating-point
+     * `index++` stops advancing (1 is lost past 2^53), so a `for` loop over
+     * cell keys would never terminate. Cap well below that.
+     */
+    static MAX_CELL_INDEX = 2 ** 40;
+    /** True when a rect can't be bucketed sanely (too big, too far out, or non-finite). */
+    isOversized(r) {
+        if (!Number.isFinite(r.x) ||
+            !Number.isFinite(r.y) ||
+            !Number.isFinite(r.width) ||
+            !Number.isFinite(r.height)) {
+            return true;
+        }
+        const s = this.cellSize;
+        const x0 = Math.floor(r.x / s);
+        const y0 = Math.floor(r.y / s);
+        const x1 = Math.floor((r.x + Math.max(0, r.width)) / s);
+        const y1 = Math.floor((r.y + Math.max(0, r.height)) / s);
+        // Coordinates so large the cell-index loop counter can't increment.
+        const lim = SpatialIndex.MAX_CELL_INDEX;
+        if (Math.abs(x0) > lim ||
+            Math.abs(y0) > lim ||
+            Math.abs(x1) > lim ||
+            Math.abs(y1) > lim) {
+            return true;
+        }
+        return (x1 - x0 + 1) * (y1 - y0 + 1) > SpatialIndex.MAX_CELLS;
+    }
+    *cellKeys(r) {
+        const s = this.cellSize;
+        const x0 = Math.floor(r.x / s);
+        const y0 = Math.floor(r.y / s);
+        const x1 = Math.floor((r.x + r.width) / s);
+        const y1 = Math.floor((r.y + r.height) / s);
+        for (let cx = x0; cx <= x1; cx++) {
+            for (let cy = y0; cy <= y1; cy++) {
+                yield `${cx}:${cy}`;
+            }
+        }
+    }
+    set(id, rect) {
+        const prev = this.bounds.get(id);
+        if (prev &&
+            prev.x === rect.x &&
+            prev.y === rect.y &&
+            prev.width === rect.width &&
+            prev.height === rect.height) {
+            return;
+        }
+        if (prev)
+            this.removeFromCells(id, prev);
+        this.bounds.set(id, { ...rect });
+        if (this.isOversized(rect)) {
+            this.oversized.add(id);
+            return;
+        }
+        this.oversized.delete(id);
+        for (const key of this.cellKeys(rect)) {
+            let cell = this.cells.get(key);
+            if (!cell) {
+                cell = new Set();
+                this.cells.set(key, cell);
+            }
+            cell.add(id);
+        }
+    }
+    delete(id) {
+        const prev = this.bounds.get(id);
+        if (!prev)
+            return;
+        this.removeFromCells(id, prev);
+        this.oversized.delete(id);
+        this.bounds.delete(id);
+    }
+    removeFromCells(id, rect) {
+        // Oversized rects were never bucketed, so there are no cells to clean.
+        if (this.oversized.has(id) || this.isOversized(rect))
+            return;
+        for (const key of this.cellKeys(rect)) {
+            const cell = this.cells.get(key);
+            if (cell) {
+                cell.delete(id);
+                if (cell.size === 0)
+                    this.cells.delete(key);
+            }
+        }
+    }
+    getBounds(id) {
+        return this.bounds.get(id);
+    }
+    /** Ids whose bounds intersect the query rect. */
+    query(rect) {
+        const out = new Set();
+        if (!this.isOversized(rect)) {
+            for (const key of this.cellKeys(rect)) {
+                const cell = this.cells.get(key);
+                if (!cell)
+                    continue;
+                for (const id of cell) {
+                    if (out.has(id))
+                        continue;
+                    const b = this.bounds.get(id);
+                    if (rectsIntersect(b, rect))
+                        out.add(id);
+                }
+            }
+        }
+        else {
+            // Degenerate query rect: fall back to a linear scan (rare).
+            for (const [id, b] of this.bounds)
+                if (rectsIntersect(b, rect))
+                    out.add(id);
+            return out;
+        }
+        // Oversized nodes live outside the grid; test each against the query.
+        for (const id of this.oversized) {
+            if (rectsIntersect(this.bounds.get(id), rect))
+                out.add(id);
+        }
+        return out;
+    }
+    /** Ids whose bounds contain the point. */
+    hit(x, y) {
+        const out = [];
+        const key = `${Math.floor(x / this.cellSize)}:${Math.floor(y / this.cellSize)}`;
+        const cell = this.cells.get(key);
+        if (cell) {
+            for (const id of cell) {
+                const b = this.bounds.get(id);
+                if (x >= b.x && x <= b.x + b.width && y >= b.y && y <= b.y + b.height)
+                    out.push(id);
+            }
+        }
+        for (const id of this.oversized) {
+            const b = this.bounds.get(id);
+            if (x >= b.x && x <= b.x + b.width && y >= b.y && y <= b.y + b.height)
+                out.push(id);
+        }
+        return out;
+    }
+    clear() {
+        this.cells.clear();
+        this.bounds.clear();
+        this.oversized.clear();
+    }
+}
+//# sourceMappingURL=spatial.js.map

package/dist/spatial.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,274 @@
+import type { ConnectionCandidate, ConnectionState, Edge, FitViewOptions, FlowSnapshot, Guide, HandleInfo, HandleKind, Node, Rect, StoreOptions, Viewport, XY } from './types.js';
+import { SpatialIndex } from './spatial.js';
+export declare const DEFAULT_NODE_WIDTH = 172;
+export declare const DEFAULT_NODE_HEIGHT = 44;
+type Listener = () => void;
+/**
+ * FlowStore is ReFlow's reactive heart: a Map-backed graph store with
+ * fine-grained topic subscriptions.
+ *
+ * Every mutation notifies only the topics it touches (`node:<id>`,
+ * `edge:<id>`, `viewport`, ...), so a renderer can subscribe each component
+ * to exactly the state it draws — dragging one node re-renders one node,
+ * not the whole flow.
+ */
+export declare class FlowStore {
+    readonly nodes: Map<string, Node<Record<string, unknown>>>;
+    readonly edges: Map<string, Edge<Record<string, unknown>>>;
+    nodeOrder: string[];
+    edgeOrder: string[];
+    viewport: Viewport;
+    readonly selectedNodes: Set<string>;
+    readonly selectedEdges: Set<string>;
+    connection: ConnectionState | null;
+    /** Set while dragging an existing edge's endpoint to a new handle. */
+    reconnecting: {
+        edgeId: string;
+        end: 'source' | 'target';
+    } | null;
+    guides: Guide[];
+    /** Node ids inside the culling viewport (all depths). */
+    visibleNodes: Set<string>;
+    /** Root node ids that should be mounted by a renderer. */
+    visibleRoots: Set<string>;
+    visibleEdges: Set<string>;
+    /** When false (small graphs / no screen yet), everything renders. */
+    cullingActive: boolean;
+    /** Bumped whenever node membership/order changes ('nodes' topic). */
+    nodesVersion: number;
+    /** Bumped whenever edge membership/order changes ('edges' topic). */
+    edgesVersion: number;
+    /** Bumped on every committed mutation boundary ('commit' topic). */
+    commitVersion: number;
+    /** Bumped whenever any node geometry changes ('graph' topic) — lets
+     *  obstacle-dependent renderers (orthogonal edges) re-route live. */
+    graphVersion: number;
+    screen: {
+        width: number;
+        height: number;
+    };
+    options: StoreOptions;
+    readonly spatial: SpatialIndex;
+    /** Renderer-measured sizes, kept apart from node objects so measuring
+     *  never re-creates (and re-renders) a node. node.width/height wins. */
+    private measured;
+    private nodeEdges;
+    private children;
+    private handles;
+    /** Per-edge render versions: bumped when the edge object OR the
+     *  geometry it depends on (endpoint nodes, handles) changes. */
+    private edgeVer;
+    private listeners;
+    private pending;
+    private batchDepth;
+    private undoStack;
+    private redoStack;
+    private txn;
+    private recording;
+    private drag;
+    private cullScheduled;
+    private cullForced;
+    /** Hysteresis: skip viewport-only re-culls while the raw view stays
+     *  inside the last culled region (minus a half-margin buffer). */
+    private lastCullRect;
+    /** Zoom at the last cull. Containment hysteresis only applies while zoom
+     *  is unchanged — zooming IN from an overview shrinks the view inside the
+     *  old region, which must still re-cull or nothing gets culled. */
+    private lastCullZoom;
+    private vpAnim;
+    constructor(options?: StoreOptions);
+    subscribe(topic: string, fn: Listener): () => void;
+    /** Monotonic version for an edge's rendered output. */
+    edgeVersion(id: string): number;
+    private bumpEdge;
+    private bumpNodes;
+    private bumpEdges;
+    private emit;
+    /** Group mutations; duplicate notifications are coalesced. */
+    batch(fn: () => void): void;
+    private commit;
+    private record;
+    /** Group several mutations into a single undo entry. */
+    transact(label: string, fn: () => void): void;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    undo(): void;
+    redo(): void;
+    clearHistory(): void;
+    private _insertNode;
+    private _removeNode;
+    private _replaceNode;
+    private _insertEdge;
+    private _removeEdge;
+    private _replaceEdge;
+    /** Re-index a node and notify it plus every edge touching it. */
+    private touchNode;
+    getNode(id: string): Node | undefined;
+    getEdge(id: string): Edge | undefined;
+    getNodes(): Node[];
+    /** All edges connected to a node. */
+    edgesOf(id: string): Edge[];
+    /** Direct children ids of a node (subflow members). */
+    childrenOf(id: string): string[];
+    getEdges(): Edge[];
+    addNodes(nodes: Node[]): void;
+    addNode(node: Node): void;
+    /**
+     * Remove nodes plus their connected edges. Children of removed nodes are
+     * re-parented to the flow root (keeping their absolute position) instead
+     * of being orphaned.
+     */
+    removeNodes(ids: string[]): void;
+    updateNode(id: string, patch: Partial<Node>): void;
+    updateNodeData(id: string, dataPatch: Record<string, unknown>): void;
+    setNodePosition(id: string, position: XY): void;
+    /** Measured size update from the renderer — not recorded in history. */
+    setNodeSize(id: string, width: number, height: number): void;
+    addEdges(edges: Edge[]): void;
+    addEdge(edge: Edge): void;
+    removeEdges(ids: string[]): void;
+    updateEdge(id: string, patch: Partial<Edge>): void;
+    /**
+     * Diff-sync the whole graph (used by controlled mode and loadSnapshot).
+     * Unchanged elements are left untouched, so selection, measured sizes and
+     * fine-grained subscriptions survive a controlled-props round trip.
+     */
+    setGraph(nodes: Node[], edges: Edge[]): void;
+    /**
+     * Apply a remote collaborative change: upsert/remove specific nodes and
+     * edges WITHOUT recording history and WITHOUT emitting 'commit' (so it
+     * never echoes back through the local broadcast diff). Remote edits aren't
+     * part of your local undo stack — you don't undo a teammate's change.
+     */
+    applyRemotePatch(patch: {
+        nodes?: {
+            upsert?: Node[];
+            remove?: string[];
+        };
+        edges?: {
+            upsert?: Edge[];
+            remove?: string[];
+        };
+    }): void;
+    absolutePosition(id: string): XY;
+    nodeSize(id: string): {
+        width: number;
+        height: number;
+    };
+    /** Absolute rect of a node in flow coordinates. */
+    nodeRect(id: string): Rect;
+    /** Union of all node rects (or the given subset). */
+    nodesBounds(ids?: string[]): Rect;
+    /**
+     * The nearest visible node to `fromId` in a cardinal direction — for
+     * keyboard/screen-reader spatial navigation. Uses a cone test so
+     * "right" prefers nodes actually to the right, breaking ties by distance.
+     */
+    nearestNodeInDirection(fromId: string, dir: 'left' | 'right' | 'up' | 'down'): string | null;
+    /** Nodes whose rects intersect (or are fully inside) the given rect. */
+    nodesInRect(rect: Rect, partially?: boolean): string[];
+    registerHandle(info: HandleInfo): void;
+    unregisterHandle(nodeId: string, handleId: string): void;
+    getHandles(nodeId: string): HandleInfo[];
+    /**
+     * Resolve the handle an edge endpoint attaches to. Falls back to a
+     * synthetic border-midpoint handle when nothing is registered (headless
+     * usage, or nodes without <Handle> children).
+     */
+    resolveHandle(nodeId: string, kind: HandleKind, handleId?: string): HandleInfo;
+    /** Absolute anchor point of a handle. */
+    handleAnchor(h: HandleInfo): XY;
+    /**
+     * Node rectangles an orthogonal edge should route around: nodes near the
+     * edge's bounding box, excluding the two endpoint nodes. Uses the spatial
+     * index so this stays cheap even with thousands of nodes.
+     */
+    edgeObstacles(edge: Edge, margin?: number): Rect[];
+    /** Endpoint geometry for rendering an edge. */
+    edgeGeometry(edge: Edge): {
+        source: XY;
+        sourceSide: HandleInfo['side'];
+        target: XY;
+        targetSide: HandleInfo['side'];
+    } | null;
+    setSelection(nodeIds: Iterable<string>, edgeIds?: Iterable<string>): void;
+    addToSelection(nodeIds: Iterable<string>, edgeIds?: Iterable<string>): void;
+    toggleSelection(nodeId?: string, edgeId?: string): void;
+    clearSelection(): void;
+    selectAll(): void;
+    deleteSelection(): void;
+    /**
+     * Serialize a set of nodes (default: the selection) plus the edges wholly
+     * between them. The result is JSON-serializable — stash it in app state or
+     * the system clipboard.
+     */
+    copy(nodeIds?: string[]): {
+        nodes: Node[];
+        edges: Edge[];
+    };
+    /**
+     * Insert a copied payload with fresh ids, offset so pasted nodes don't sit
+     * exactly on the originals, and select the result. Returns the new ids.
+     * One undo entry.
+     */
+    paste(payload: {
+        nodes: Node[];
+        edges: Edge[];
+    }, offset?: XY): {
+        nodeIds: string[];
+        edgeIds: string[];
+    };
+    /** Copy + paste the selection in one step (⌘D-style). */
+    duplicateSelection(offset?: XY): {
+        nodeIds: string[];
+        edgeIds: string[];
+    };
+    startDrag(ids: string[]): void;
+    /** Move the dragged nodes by a flow-space delta from the drag origin. */
+    dragBy(delta: XY): void;
+    endDrag(): void;
+    get dragging(): boolean;
+    private setGuides;
+    startConnection(nodeId: string, handleId?: string, kind?: HandleKind): void;
+    /**
+     * Begin reconnecting one end of an existing edge. The opposite (anchored)
+     * end becomes the connection origin; dropping on a new handle moves this
+     * edge's endpoint. Dropping on nothing deletes the edge (React Flow's
+     * default reconnect-to-void behavior).
+     */
+    startReconnect(edgeId: string, end: 'source' | 'target'): void;
+    get isReconnecting(): boolean;
+    moveConnection(to: XY): void;
+    /** Complete the pending connection; returns the new/updated edge. */
+    endConnection(): Edge | null;
+    cancelConnection(): void;
+    /** Validate and create an edge (respecting defaultEdgeOptions). */
+    connect(candidate: ConnectionCandidate, props?: Partial<Edge>): Edge | null;
+    /** Returns true, or a string describing why the connection is invalid. */
+    validateCandidate(c: ConnectionCandidate): true | string;
+    handleConnectionCount(h: HandleInfo): number;
+    /** Would adding source→target create a directed cycle? */
+    wouldCreateCycle(source: string, target: string): boolean;
+    /** Nearest compatible opposite-kind handle within `radius` flow px. */
+    findCompatibleHandle(p: XY, radius: number): {
+        handle: HandleInfo;
+        valid: boolean;
+    } | null;
+    setScreenSize(width: number, height: number): void;
+    setViewport(v: Viewport): void;
+    panBy(dx: number, dy: number): void;
+    /** Zoom by factor around a screen-space pivot (defaults to center). */
+    zoomBy(factor: number, pivot?: XY): void;
+    zoomTo(zoom: number, duration?: number): void;
+    fitView(opts?: FitViewOptions): void;
+    /** Center the view on a node (nice for search/jump UX). */
+    centerNode(id: string, duration?: number): void;
+    animateViewport(target: Viewport, duration?: number): void;
+    private scheduleCull;
+    /** Recompute the visible node/edge sets; emits 'visible' on change. */
+    cull(force?: boolean): void;
+    toSnapshot(): FlowSnapshot;
+    loadSnapshot(snap: FlowSnapshot): void;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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