@luciole-sh/flow-graph 0.0.0-stage → 0.1.0

package/dist/hooks.d.ts

@@ -0,0 +1,56 @@
+import { type Dispatch, type ReactNode, type SetStateAction } from "react";
+import { FlowStore } from "./store.ts";
+import type { Detail, Edge, EdgeChange, Node, NodeChange, Viewport, XY } from "./types.ts";
+export declare const StoreContext: import("react").Context<FlowStore | null>;
+/** The node a `<Handle>` belongs to. */
+export declare const NodeIdContext: import("react").Context<string | null>;
+/**
+ * Shares one canvas's store with components outside `<Flow>` (a side panel that calls
+ * `fitView`, a toolbar): wrap both in it. Without it, `<Flow>` keeps its own.
+ */
+export declare function FlowProvider({ children, defaultViewport, fitView, }: {
+    children: ReactNode;
+    defaultViewport?: Viewport;
+    fitView?: boolean;
+}): ReactNode;
+export declare function useStore(): FlowStore;
+/** Re-renders on every change of the store; returns it. */
+export declare function useStoreVersion(): FlowStore;
+/** `useState` for nodes, with the `onNodesChange` that applies the canvas's changes. */
+export declare function useNodesState<N extends Node = Node>(initial: N[]): [N[], Dispatch<SetStateAction<N[]>>, (changes: NodeChange<N>[]) => void];
+/** `useState` for edges, with the `onEdgesChange` that applies the canvas's changes. */
+export declare function useEdgesState<E extends Edge = Edge>(initial: E[]): [E[], Dispatch<SetStateAction<E[]>>, (changes: EdgeChange<E>[]) => void];
+export type FlowInstance = {
+    getNodes(): readonly Node[];
+    getNode(id: string): Node | undefined;
+    getEdges(): readonly Edge[];
+    getViewport(): Viewport;
+    setViewport(viewport: Viewport): void;
+    /** The closest zoom level at which every node is seen, centered. */
+    fitView(): void;
+    zoomIn(): void;
+    zoomOut(): void;
+    /** Centers the view on a point in flow coordinates. */
+    setCenter(point: XY, zoom?: number): void;
+    /** Pans just enough to show node `id`. */
+    reveal(id: string): void;
+    /** Proposes removing these nodes (with their edges) and edges. */
+    deleteElements(elements: {
+        nodes?: readonly string[];
+        edges?: readonly string[];
+    }): void;
+    /** Proposes selecting exactly these nodes and edges. */
+    select(elements: {
+        nodes?: readonly string[];
+        edges?: readonly string[];
+    }): void;
+    /** The canvas point at the center of the view, in flow coordinates. */
+    center(): XY;
+};
+/** The canvas's controls, for a component inside `<Flow>` or `<FlowProvider>`. */
+export declare function useFlow(): FlowInstance;
+/** The viewport and the detail it draws nodes at, re-rendering when they change. */
+export declare function useViewport(): Viewport & {
+    detail: Detail;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAG3F,eAAO,MAAM,YAAY,2CAAwC,CAAC;AAClE,wCAAwC;AACxC,eAAO,MAAM,aAAa,wCAAqC,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,eAAe,EACf,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,aAGA;AAED,wBAAgB,QAAQ,IAAI,SAAS,CAIpC;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,IAAI,SAAS,CAI3C;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,EACjD,OAAO,EAAE,CAAC,EAAE,GACX,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAO1E;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,EACjD,OAAO,EAAE,CAAC,EAAE,GACX,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAO1E;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,IAAI,SAAS,IAAI,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,QAAQ,IAAI,SAAS,IAAI,EAAE,CAAC;IAC5B,WAAW,IAAI,QAAQ,CAAC;IACxB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtC,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;IAChB,uDAAuD;IACvD,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,0CAA0C;IAC1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kEAAkE;IAClE,cAAc,CAAC,QAAQ,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACzF,wDAAwD;IACxD,MAAM,CAAC,QAAQ,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACjF,uEAAuE;IACvE,MAAM,IAAI,EAAE,CAAC;CACd,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,OAAO,IAAI,YAAY,CAmBtC;AAED,oFAAoF;AACpF,wBAAgB,WAAW,IAAI,QAAQ,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAG3D"}

package/dist/hooks.js

@@ -0,0 +1,65 @@
+import { jsx as _jsx } from "@opentui/react/jsx-runtime";
+import { createContext, useCallback, useContext, useState, useSyncExternalStore, } from "react";
+import { FlowStore } from "./store.js";
+import { applyEdgeChanges, applyNodeChanges } from "./vendor/xyflow/changes.js";
+export const StoreContext = createContext(null);
+/** The node a `<Handle>` belongs to. */
+export const NodeIdContext = createContext(null);
+/**
+ * Shares one canvas's store with components outside `<Flow>` (a side panel that calls
+ * `fitView`, a toolbar): wrap both in it. Without it, `<Flow>` keeps its own.
+ */
+export function FlowProvider({ children, defaultViewport, fitView, }) {
+    const [store] = useState(() => new FlowStore({ viewport: defaultViewport, fitView }));
+    return _jsx(StoreContext.Provider, { value: store, children: children });
+}
+export function useStore() {
+    const store = useContext(StoreContext);
+    if (!store)
+        throw new Error("useFlow and the canvas components need a <Flow> or <FlowProvider>");
+    return store;
+}
+/** Re-renders on every change of the store; returns it. */
+export function useStoreVersion() {
+    const store = useStore();
+    useSyncExternalStore(store.subscribe, store.getVersion);
+    return store;
+}
+/** `useState` for nodes, with the `onNodesChange` that applies the canvas's changes. */
+export function useNodesState(initial) {
+    const [nodes, setNodes] = useState(initial);
+    const onNodesChange = useCallback((changes) => setNodes((current) => applyNodeChanges(changes, current)), []);
+    return [nodes, setNodes, onNodesChange];
+}
+/** `useState` for edges, with the `onEdgesChange` that applies the canvas's changes. */
+export function useEdgesState(initial) {
+    const [edges, setEdges] = useState(initial);
+    const onEdgesChange = useCallback((changes) => setEdges((current) => applyEdgeChanges(changes, current)), []);
+    return [edges, setEdges, onEdgesChange];
+}
+/** The canvas's controls, for a component inside `<Flow>` or `<FlowProvider>`. */
+export function useFlow() {
+    const store = useStore();
+    const [instance] = useState(() => ({
+        getNodes: () => store.nodes,
+        getNode: (id) => store.nodes.find((n) => n.id === id),
+        getEdges: () => store.edges,
+        getViewport: () => store.viewport,
+        setViewport: (viewport) => store.setViewport(viewport),
+        fitView: () => store.fitView(),
+        zoomIn: () => store.zoom(1),
+        zoomOut: () => store.zoom(-1),
+        setCenter: (point, zoom) => store.setCenter(point, zoom),
+        reveal: (id) => store.reveal(id),
+        deleteElements: (elements) => store.deleteElements(elements),
+        select: (elements) => store.select(elements),
+        center: () => store.toFlow({ x: Math.floor(store.size.width / 2), y: Math.floor(store.size.height / 2) }),
+    }));
+    return instance;
+}
+/** The viewport and the detail it draws nodes at, re-rendering when they change. */
+export function useViewport() {
+    const store = useStoreVersion();
+    return { ...store.viewport, detail: store.detail };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@luciole-sh/flow-graph`: node graphs in the terminal, after React Flow. Use it in a Client
+ * Component (`"use client"`): pan, zoom, drag and selection stay on the Client.
+ */
+export { Flow, type FlowProps } from "./Flow.tsx";
+export { Background, Controls, MiniMap, Panel, type PanelPosition } from "./components.tsx";
+export { DefaultNode, GroupNode, Handle } from "./nodes.tsx";
+export { FlowProvider, useEdgesState, useFlow, useNodesState, useViewport, type FlowInstance, } from "./hooks.tsx";
+export { addEdge, applyEdgeChanges, applyNodeChanges, getEdgeId } from "./vendor/xyflow/changes.ts";
+export { composeFrame, hitTest, type EdgeRoute, type EdgeType, type Frame } from "./frame.ts";
+export { ZOOMS, detailFor, fitViewport, flowBounds } from "./geometry.ts";
+export { Grid, type BackgroundVariant, type EdgeStyle } from "./raster.ts";
+export { defaultTheme, type FlowTheme } from "./theme.ts";
+export type * from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,aAAa,EACb,OAAO,EACP,aAAa,EACb,WAAW,EACX,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * `@luciole-sh/flow-graph`: node graphs in the terminal, after React Flow. Use it in a Client
+ * Component (`"use client"`): pan, zoom, drag and selection stay on the Client.
+ */
+export { Flow } from "./Flow.js";
+export { Background, Controls, MiniMap, Panel } from "./components.js";
+export { DefaultNode, GroupNode, Handle } from "./nodes.js";
+export { FlowProvider, useEdgesState, useFlow, useNodesState, useViewport, } from "./hooks.js";
+export { addEdge, applyEdgeChanges, applyNodeChanges, getEdgeId } from "./vendor/xyflow/changes.js";
+export { composeFrame, hitTest } from "./frame.js";
+export { ZOOMS, detailFor, fitViewport, flowBounds } from "./geometry.js";
+export { Grid } from "./raster.js";
+export { defaultTheme } from "./theme.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAkB,MAAM,WAAY,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAsB,MAAM,iBAAkB,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAa,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,aAAa,EACb,OAAO,EACP,aAAa,EACb,WAAW,GAEZ,MAAM,YAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,OAAO,EAA6C,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,IAAI,EAA0C,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC"}

package/dist/keymap.d.ts

@@ -0,0 +1,11 @@
+import { type ReactNode } from "react";
+/**
+ * The canvas's bindings go through `useBindings` in every case. Inside the application's
+ * `<KeymapProvider>` (luciole's Shell installs one), they join its layers: `<KeyHelp>`
+ * lists them, and the application's own layers can shadow them. Without one, the canvas
+ * provides a keymap of its own on the renderer.
+ */
+export declare function FlowKeymap({ children }: {
+    children: ReactNode;
+}): ReactNode;
+//# sourceMappingURL=keymap.d.ts.map

package/dist/keymap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keymap.d.ts","sourceRoot":"","sources":["../src/keymap.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAiCjD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,aAK/D"}

package/dist/keymap.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx } from "@opentui/react/jsx-runtime";
+import { useState } from "react";
+import { createDefaultOpenTuiKeymap } from "@opentui/keymap/opentui";
+import { KeymapProvider, useKeymap } from "@opentui/keymap/react";
+import { useRenderer } from "@opentui/react";
+/**
+ * The keymap of the application's `<KeymapProvider>`, or null without one.
+ * `@opentui/keymap/react` exports no context, only `useKeymap`, which throws when there is
+ * no provider: the throw comes after its `useContext`, so hooks keep their order.
+ */
+function useOptionalKeymap() {
+    try {
+        return useKeymap();
+    }
+    catch {
+        return null;
+    }
+}
+// A keymap listens to its renderer for good (it has no dispose): one per renderer, shared
+// by every canvas that has no provider, however often they mount.
+const ownKeymaps = new WeakMap();
+function keymapFor(renderer) {
+    const known = ownKeymaps.get(renderer);
+    if (known)
+        return known;
+    const keymap = createDefaultOpenTuiKeymap(renderer);
+    ownKeymaps.set(renderer, keymap);
+    return keymap;
+}
+/**
+ * The canvas's bindings go through `useBindings` in every case. Inside the application's
+ * `<KeymapProvider>` (luciole's Shell installs one), they join its layers: `<KeyHelp>`
+ * lists them, and the application's own layers can shadow them. Without one, the canvas
+ * provides a keymap of its own on the renderer.
+ */
+export function FlowKeymap({ children }) {
+    const outer = useOptionalKeymap();
+    const renderer = useRenderer();
+    const [own] = useState(() => (outer ? null : keymapFor(renderer)));
+    return own ? _jsx(KeymapProvider, { keymap: own, children: children }) : children;
+}
+//# sourceMappingURL=keymap.js.map

package/dist/keymap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keymap.js","sourceRoot":"","sources":["../src/keymap.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAGjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI7C;;;;GAIG;AACH,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,kEAAkE;AAClE,MAAM,UAAU,GAAG,IAAI,OAAO,EAA8B,CAAC;AAC7D,SAAS,SAAS,CAAC,QAAqB;IACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,MAAM,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACpD,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,QAAQ,EAA2B;IAC9D,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,GAAG,CAAC,CAAC,CAAC,KAAC,cAAc,IAAC,MAAM,EAAE,GAAG,YAAG,QAAQ,GAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnF,CAAC"}

package/dist/navigation.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Moving the selection with the keyboard: in reading order (columns left to right, a
+ * column top to bottom, as a left-to-right flow reads), along the edges (downstream,
+ * upstream), among siblings, or to the nearest node on one side. Pure functions of the
+ * graph and the nodes' positions.
+ */
+import type { Edge, Node, Position, XY } from "./types.ts";
+type Located = {
+    id: string;
+    at: XY;
+};
+/** Selectable, visible nodes with their positions, in reading order. */
+export declare function readingOrder(nodes: readonly Node[], positions: ReadonlyMap<string, XY>): {
+    id: string;
+    at: XY;
+}[];
+/** The next (`1`) or previous (`-1`) node after `current` in reading order, cycling. */
+export declare function cycle(order: readonly Located[], current: string | undefined, step: 1 | -1): string | undefined;
+/** The first node `current`'s edges lead to (`down`) or come from (`up`), top first. */
+export declare function follow(edges: readonly Edge[], order: readonly Located[], current: string, direction: "down" | "up"): string;
+/**
+ * The next (`1`) or previous (`-1`) sibling of `current`: another node an upstream node
+ * of `current` leads to, top to bottom, cycling.
+ */
+export declare function sibling(edges: readonly Edge[], order: readonly Located[], current: string, step: 1 | -1): string | undefined;
+/**
+ * The nearest node on `side` of `current`: within a 45° cone first, by distance with rows
+ * counted twice (a row is about two columns tall).
+ */
+export declare function nearest(order: readonly Located[], current: string, side: Position): string | undefined;
+export {};
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAE3D,KAAK,OAAO,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC;AAKtC,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;;;IAKtF;AAED,wFAAwF;AACxF,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,sBAKzF;AAED,wFAAwF;AACxF,wBAAgB,MAAM,CACpB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,UAQzB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,sBAWb;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,sBAgBjF"}

package/dist/navigation.js

@@ -0,0 +1,68 @@
+const byColumn = (a, b) => a.at.x - b.at.x || a.at.y - b.at.y;
+const byRow = (a, b) => a.at.y - b.at.y || a.at.x - b.at.x;
+/** Selectable, visible nodes with their positions, in reading order. */
+export function readingOrder(nodes, positions) {
+    return nodes
+        .filter((n) => !n.hidden && n.selectable !== false && n.type !== "group")
+        .map((n) => ({ id: n.id, at: positions.get(n.id) ?? n.position }))
+        .sort(byColumn);
+}
+/** The next (`1`) or previous (`-1`) node after `current` in reading order, cycling. */
+export function cycle(order, current, step) {
+    if (order.length === 0)
+        return undefined;
+    const index = order.findIndex((n) => n.id === current);
+    if (index < 0)
+        return (step === 1 ? order[0] : order.at(-1))?.id;
+    return order[(index + step + order.length) % order.length]?.id;
+}
+/** The first node `current`'s edges lead to (`down`) or come from (`up`), top first. */
+export function follow(edges, order, current, direction) {
+    const ids = new Set(edges
+        .filter((e) => !e.hidden && (direction === "down" ? e.source : e.target) === current)
+        .map((e) => (direction === "down" ? e.target : e.source)));
+    return order.filter((n) => ids.has(n.id)).sort(byRow)[0]?.id;
+}
+/**
+ * The next (`1`) or previous (`-1`) sibling of `current`: another node an upstream node
+ * of `current` leads to, top to bottom, cycling.
+ */
+export function sibling(edges, order, current, step) {
+    const parents = new Set(edges.filter((e) => e.target === current).map((e) => e.source));
+    const ids = new Set(edges.filter((e) => parents.has(e.source)).map((e) => e.target));
+    // A root's siblings are the other roots.
+    if (parents.size === 0) {
+        const targets = new Set(edges.map((e) => e.target));
+        for (const n of order)
+            if (!targets.has(n.id))
+                ids.add(n.id);
+    }
+    const list = order.filter((n) => ids.has(n.id)).sort(byRow);
+    return list.length > 1 ? cycle(list, current, step) : undefined;
+}
+/**
+ * The nearest node on `side` of `current`: within a 45° cone first, by distance with rows
+ * counted twice (a row is about two columns tall).
+ */
+export function nearest(order, current, side) {
+    const from = order.find((n) => n.id === current);
+    if (!from)
+        return undefined;
+    let best;
+    for (const n of order) {
+        if (n.id === current)
+            continue;
+        const dx = n.at.x - from.at.x;
+        const dy = (n.at.y - from.at.y) * 2;
+        const forward = side === "right" ? dx : side === "left" ? -dx : side === "bottom" ? dy : -dy;
+        const across = side === "left" || side === "right" ? Math.abs(dy) : Math.abs(dx);
+        if (forward <= 0)
+            continue;
+        // Outside the cone costs as much again as the distance across.
+        const score = forward + across * (across > forward ? 2 : 1);
+        if (!best || score < best.score)
+            best = { id: n.id, score };
+    }
+    return best?.id;
+}
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

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

package/dist/nodes.d.ts

@@ -0,0 +1,18 @@
+import type { HandleType, NodeComponent, NodeProps, Position } from "./types.ts";
+/**
+ * Declares where a node's edges attach: a node component renders one per handle. It
+ * draws nothing itself: the canvas marks handles on the node's border when useful (the
+ * selected node's sources, every target while connecting). Handles sharing a side are
+ * spread along it, in the order they are rendered.
+ */
+export declare function Handle({ type, position, id, }: {
+    type: HandleType;
+    position: Position;
+    id?: string | null;
+}): null;
+/** A label in a rounded box, one row tall; its label only when compact. */
+export declare function DefaultNode({ data, id, selected, detail, connectTarget, type }: NodeProps): import("react").ReactNode;
+/** A frame other nodes sit in (`parentId`), sized by the node's `width` and `height`. */
+export declare function GroupNode({ data, id, selected, detail, width, height }: NodeProps): import("react").ReactNode;
+export declare const builtinNodeTypes: Record<string, NodeComponent>;
+//# sourceMappingURL=nodes.d.ts.map

package/dist/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../src/nodes.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjF;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,QAAQ,EACR,EAAS,GACV,EAAE;IACD,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB,QAUA;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,SAAS,6BA6BzF;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,6BAajF;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAK1D,CAAC"}

package/dist/nodes.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "@opentui/react/jsx-runtime";
+import { useContext, useEffect, useId } from "react";
+import { labelOf } from "./geometry.js";
+import { NodeIdContext, useStore } from "./hooks.js";
+import { useFlowTheme } from "./theme.js";
+/**
+ * Declares where a node's edges attach: a node component renders one per handle. It
+ * draws nothing itself: the canvas marks handles on the node's border when useful (the
+ * selected node's sources, every target while connecting). Handles sharing a side are
+ * spread along it, in the order they are rendered.
+ */
+export function Handle({ type, position, id = null, }) {
+    const nodeId = useContext(NodeIdContext);
+    const store = useStore();
+    const key = useId();
+    useEffect(() => {
+        if (!nodeId)
+            return;
+        store.addHandle(nodeId, key, { id, type, position });
+        return () => store.removeHandle(nodeId, key);
+    }, [store, nodeId, key, id, type, position]);
+    return null;
+}
+/** A label in a rounded box, one row tall; its label only when compact. */
+export function DefaultNode({ data, id, selected, detail, connectTarget, type }) {
+    const theme = useFlowTheme();
+    const label = labelOf({ id, data, position: { x: 0, y: 0 } });
+    const color = selected ? theme.selected : connectTarget ? theme.connect : theme.border;
+    if (detail === "compact")
+        return (_jsx("text", { selectable: false, wrapMode: "none", fg: selected || connectTarget ? color : theme.text, bg: theme.panelBg, children: ` ${label} ` }));
+    // An input starts the flow and an output ends it: their border says so.
+    return (_jsx("box", { border: true, borderStyle: type === "input" ? "double" : type === "output" ? "heavy" : "rounded", borderColor: color, paddingX: 1, backgroundColor: theme.panelBg, children: _jsx("text", { selectable: false, fg: theme.text, wrapMode: "none", children: label }) }));
+}
+/** A frame other nodes sit in (`parentId`), sized by the node's `width` and `height`. */
+export function GroupNode({ data, id, selected, detail, width, height }) {
+    const theme = useFlowTheme();
+    const label = labelOf({ id, data, position: { x: 0, y: 0 } });
+    return (_jsx("box", { width: width, height: height, border: true, borderStyle: "single", borderColor: selected ? theme.selected : theme.group, title: detail === "full" ? ` ${label} ` : undefined }));
+}
+export const builtinNodeTypes = {
+    default: DefaultNode,
+    input: DefaultNode,
+    output: DefaultNode,
+    group: GroupNode,
+};
+//# sourceMappingURL=nodes.js.map

package/dist/nodes.js.map

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

package/dist/raster.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Edges drawn on the cell grid. Orthogonal paths (step, smoothstep, aligned straight
+ * edges) set four direction bits per cell; the bits of every edge in a cell are merged,
+ * so a fork reads `├`, two lines meeting `┼`, and a crossing is a `┼` too. Curves
+ * (bezier) and slanted straight lines are drawn in braille dots, two by four per cell.
+ * Pure: the canvas copies the grid into OpenTUI's buffer, tests print it.
+ */
+import type { Position, Rect, XY } from "./types.ts";
+export type Role = "edge" | "selected" | "animated" | "label" | "marker" | "background" | "handle";
+export type Cell = {
+    char: string;
+    role: Role;
+    /** An explicit color, over the role's. */
+    color?: string;
+    /** The edge this cell belongs to, for hit testing. */
+    owner?: string;
+};
+/** An arrow pointing into a node, by the side of the node it enters. */
+export declare const ARROW_INTO: Record<Position, string>;
+export type EdgeStyle = "smoothstep" | "step" | "straight" | "bezier";
+/** An edge, placed: both ends are anchor cells, just outside their nodes. */
+export type EdgeDraw = {
+    id: string;
+    style: EdgeStyle;
+    source: XY;
+    sourcePosition: Position;
+    target: XY;
+    targetPosition: Position;
+    label?: string;
+    animated?: boolean;
+    selected?: boolean;
+    markerEnd?: boolean;
+    markerStart?: boolean;
+    color?: string;
+    /** For custom edge types: the path's corner points, drawn orthogonally. */
+    points?: readonly XY[];
+    /** Overrides the role its state gives it (the connection being made). */
+    role?: Role;
+};
+type BoxCell = {
+    mask: number;
+    rounded: boolean;
+    role: Role;
+    color?: string;
+    owner?: string;
+    /** Index along its edge, for the runner of an animated edge. */
+    index: number;
+    edges: number;
+};
+type DotCell = {
+    bits: number;
+    role: Role;
+    color?: string;
+    owner?: string;
+    index?: number;
+};
+export declare class Grid {
+    readonly width: number;
+    readonly height: number;
+    private readonly cells;
+    private readonly boxes;
+    private readonly dots;
+    constructor(width: number, height: number);
+    inside(x: number, y: number): boolean;
+    get(x: number, y: number): Cell | undefined;
+    set(x: number, y: number, cell: Cell): void;
+    /** Writes `text` from (x, y) on, clipped to the grid. */
+    text(x: number, y: number, text: string, cell: Omit<Cell, "char">): void;
+    /** Adds direction bits to a box cell; the last writer's role and color win. */
+    box(x: number, y: number, bits: number, style: Omit<BoxCell, "mask" | "edges">): void;
+    /** Sets one braille dot at dot coordinates (two per cell across, four down). */
+    dot(dx: number, dy: number, style: Omit<DotCell, "bits">): void;
+    /**
+     * Turns direction bits and dots into characters. Box lines win over dots, and cells
+     * already set (markers, labels) win over both.
+     */
+    resolve(phase?: number): this;
+    /** Rows of text, trailing blanks trimmed: what tests compare. */
+    lines(): string[];
+    /** Each cell that holds something, row by row. */
+    entries(): Generator<[number, number, Cell]>;
+}
+/** Rounds corner points and makes each pair of consecutive points share an axis. */
+export declare function orthogonal(points: readonly XY[]): XY[];
+/** The cells an orthogonal path goes through, in order, both ends included. */
+export declare function pathCells(points: readonly XY[]): XY[];
+/** The corner points of a step edge between two anchor cells. */
+export declare function stepPoints(draw: EdgeDraw): {
+    points: XY[];
+    label: XY;
+};
+/** A cubic bezier's four points between two anchor cells, after xyflow's controls. */
+export declare function bezierControls(draw: EdgeDraw): [XY, XY, XY, XY];
+/** Draws one edge into `grid`; returns where its label goes. */
+export declare function drawEdge(grid: Grid, draw: EdgeDraw): XY;
+/** An edge's label, centered on `at`, over the lines. */
+export declare function drawLabel(grid: Grid, at: XY, text: string, owner: string): void;
+export type BackgroundVariant = "dots" | "lines" | "cross";
+/** Background marks every `gap` flow cells, following the viewport, in the empty cells. */
+export declare function drawBackground(grid: Grid, viewport: {
+    x: number;
+    y: number;
+    zoom: number;
+}, variant: BackgroundVariant, gap: XY): void;
+/** Draws `rects` and a viewport outline, in braille, scaled into `grid`. */
+export declare function drawMiniMap(grid: Grid, world: Rect, rects: readonly {
+    rect: Rect;
+    role: Role;
+    color?: string;
+}[], view: Rect): (cell: XY) => XY;
+export {};
+//# sourceMappingURL=raster.d.ts.map

package/dist/raster.d.ts.map

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