@multiplatform.one/node-graph 7.7.2

package/types/index.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Web barrel.
+ *
+ * The model half is NOT re-exported here. It has its own condition
+ * (`@multiplatform.one/node-graph/model`) so a server, a CLI, a Frappe hook or
+ * the CI bench can import it without React or `@xyflow` — re-exporting it from
+ * this file would defeat that by making one import pull the whole editor.
+ *
+ * `css/graph.css` is imported by `NodeGraphWeb`, so a consumer of `NodeGraph`
+ * gets it automatically. A consumer who mounts `ReactFlow` themselves imports
+ * `@multiplatform.one/node-graph/css/graph.css`.
+ */
+export { NodeGraph } from "./NodeGraph";
+export type { NodeGraphProps } from "./NodeGraph";
+export { graphCanvasDefaults, NodeGraphWeb } from "./react-flow/NodeGraphWeb";
+export type { NodeGraphWebProps } from "./react-flow/NodeGraphWeb";
+export { defaultGraphNodeType, useGraphController } from "./react-flow/useGraphController";
+export type { GraphController, GraphRelayoutOptions, UseGraphControllerOptions, } from "./react-flow/useGraphController";
+export { GraphActionsProvider, useGraphActions } from "./react-flow/GraphActions";
+/**
+ * The imperative handle (design §9.1), on the WEB barrel as well as the native
+ * one. Milestone 6: a control is either a sibling on this handle or a
+ * serializable option, and a web story that could not rehearse the native shape
+ * would be a story that proves nothing about the phone.
+ */
+export { graphCommandNames } from "./react-flow/graphHandle";
+export type { GraphCommands, GraphCommandSlot, NodeGraphHandle } from "./react-flow/graphHandle";
+export { GraphCommandBridge } from "./react-flow/GraphCommandBridge";
+export type { GraphCommandBridgeProps } from "./react-flow/GraphCommandBridge";
+export { GraphPaintProbe } from "./react-flow/GraphPaintProbe";
+export { GraphZoomVar, graphZoomVarName } from "./react-flow/GraphZoomVar";
+export { DomOnlyStory, domOnlyStoryDecorator, hasDomRealm } from "./native/DomOnlyStory";
+export type { DomOnlyStoryProps } from "./native/DomOnlyStory";
+/**
+ * The event union, on the WEB barrel too. `NodeGraphWeb.onGraphEvent` hands it
+ * out, so a web consumer needs the type to declare its handler — the same union
+ * that crosses the bridge as JSON on native, which is what lets one story file
+ * read a runner on both.
+ */
+export type { GraphEventWire, LassoPhaseWire, PerfReportWire } from "./dom/wire";
+export type { GraphActions } from "./react-flow/GraphActions";
+export type { GraphFlowNodeData } from "./react-flow/flowAdapter";
+export { toFlowEdges, toFlowNodes } from "./react-flow/flowAdapter";
+export { GraphNodeHost, useGraphHost } from "./react-flow/GraphNodeHost";
+export { ConnectionPuck, connectionPuckLabel } from "./react-flow/ConnectionPuck";
+export type { ConnectionPuckLabel, ConnectionPuckProps } from "./react-flow/ConnectionPuck";
+export { filterLegalCandidates, isLegalTarget, legalTargets } from "./interaction/legalTargets";
+export type { LegalTargetQuery } from "./interaction/legalTargets";
+export { mountedNodeCount, registerMountedNode, resetNodeCensus, subscribeNodeCensus, } from "./react-flow/nodeCensus";
+export { demoControlSchemaId, demoGraphSchemaId } from "./react-flow/fixtures";
+export type { GraphHostValue } from "./react-flow/GraphNodeHost";
+export { GraphEdge, graphEdgeType, graphEdgeTypes } from "./edges/GraphEdge";
+export type { GraphEdgeData } from "./edges/GraphEdge";
+export { builtinEdgeKindNames, builtinEdgeKinds } from "./edges/edgeKinds";
+export type { BuiltinEdgeData, BuiltinEdgeKind } from "./edges/edgeKinds";
+export { dashAnimation, edgeAppearances, edgeMarkerEnd, edgeStrokeWidth, edgeStrokeWidths, resolveEdgeStyle, } from "./edges/edgeStyle";
+export type { EdgeAppearance, EdgeMarker, EdgePathKind, EdgeStyle } from "./edges/edgeStyle";
+export { GraphBootFailure, GraphDiagnostics } from "./diagnostics/GraphDiagnostics";
+export { graphDiagnosticsFromWire } from "./diagnostics/fromWire";
+export type { GraphDiagnosticsProps } from "./diagnostics/GraphDiagnostics";
+export { useGraphDiagnostics } from "./diagnostics/useGraphDiagnostics";
+export { graphErrorGlobalKey, readGraphError, recordGraphError, resetGraphError, } from "./diagnostics/lastError";
+export type { GraphErrorRecord } from "./diagnostics/lastError";
+export type { GraphDiagnostics as GraphDiagnosticsRecord, GraphDiagnosticsInput, GraphFaceDelivery, GraphRenderer, LayoutRunnerKind, } from "./diagnostics/types";
+export { GraphFaces, useGraphFaces } from "./theme/GraphFaces";
+export type { GraphFacesProps, GraphFaceSource, GraphFaceStatus } from "./theme/GraphFaces";
+export { corruptFirstFamily, faceBytes, graphFaceCeilingBytes, graphFaceCss, graphFaces, probeFamily, probeRenderedFamily, splitFontStack, } from "./theme/faces";
+export type { FaceProbe, GraphFaceAsset, GraphFaceCategory, GraphFaceDeclaration, } from "./theme/faces";
+export { generatedGraphFaces } from "./theme/faces.generated";
+export { KnobEnvelopeProvider } from "./knobs/KnobEnvelopeProvider";
+export { resolveEnvelopeThemeName } from "./knobs/KnobEnvelopeProvider";
+export type { KnobEnvelopeProviderProps } from "./knobs/KnobEnvelopeProvider";
+export { knobEnvelopeIdentity, knobEnvelopeSchemaVersion, knobsForEnvelope, } from "./knobs/envelope";
+export type { GraphFontRef, KnobEnvelope } from "./knobs/envelope";
+export { useKnobEnvelope } from "./knobs/useKnobEnvelope";
+export type { UseKnobEnvelopeOptions } from "./knobs/useKnobEnvelope";
+export { useGraphNodeKnobs } from "./knobs/graphKnobs";
+export type { GraphNodeKnobs, UseGraphNodeKnobsOptions } from "./knobs/graphKnobs";
+export { lassoFlowProps, lassoHoldMs, lassoSlopPx, useLassoSelect, } from "./interaction/useLassoSelect";
+export type { GraphInteractionMode, LassoFlowProps, LassoLongPressOptions, LassoSelect, LassoViewportPort, UseLassoSelectOptions, } from "./interaction/useLassoSelect";
+export { installLassoIntercept } from "./interaction/lassoIntercept";
+export type { LassoIntercept, LassoInterceptOptions } from "./interaction/lassoIntercept";
+export { LassoOverlay } from "./react-flow/LassoOverlay";
+export type { LassoOverlayProps } from "./react-flow/LassoOverlay";
+export { GraphToolbar } from "./native/GraphToolbar";
+export type { GraphToolbarProps } from "./native/GraphToolbar";
+export { GraphNode } from "./nodes/GraphNode";
+export type { GraphNodeProps } from "./nodes/GraphNode";
+export { GraphPort } from "./nodes/GraphPort";
+export { defaultOverviewZoom, detailOpacity, isOverview, lodForZoom } from "./nodes/lod";
+export type { GraphRenderMode } from "./nodes/lod";
+export { OverviewNode } from "./nodes/overviewNode";
+export type { OverviewNodeProps } from "./nodes/overviewNode";
+export type { GraphPortProps } from "./nodes/GraphPort";
+export { FINE_PORT_HIT_MIN, paintedPortSize, paintedPortSizePx, portConnectionRadius, portGeometry, portHitSize, portRegionInset, } from "./nodes/handleGeometry";
+export type { PortGeometry, PortRect } from "./nodes/handleGeometry";
+export { containerRadiusPx, defaultNodeMeasure, FINE_PORT_PITCH, graphNodeMeasure, graphNodeMinHeight, graphNodeRadius, graphNodeRadiusPx, graphNodeWidth, nodePanelPaddingPx, nodeRadiusTokenPx, portSpacing, verticalPortCrowd, } from "./nodes/nodeMeasure";
+export type { GraphNodeMeasure, GraphNodePort, GraphNodeRadiusKnob, GraphNodeSizeKnob, GraphNodeSpaceKnob, GraphPortSide, } from "./nodes/nodeMeasure";
+export { GraphVars, graphRootClassName, graphVarsSheet, useGraphCssVars, } from "./theme/GraphVarsStyle";
+export type { GraphVarsProps } from "./theme/GraphVarsStyle";
+export { graphCssVars } from "./theme/graphVars";
+export type { GraphCssVarsOptions, GraphThemeAccess } from "./theme/graphVars";
+/**
+ * The DOM-entry registry, on the WEB barrel too, and that is deliberate.
+ *
+ * A cross-platform app registers its `'use dom'` entry from one shared module
+ * (design §9.3), and a shared module has to resolve on both platforms or the
+ * web build fails on a name only the native barrel carries. The registry itself
+ * is platform-neutral — a module-level slot and two functions, no React Native
+ * import — and on web nothing reads it, because `NodeGraphWeb` mounts React
+ * Flow directly and there is no bridge to cross.
+ */
+export { clearNodeGraphDomEntry, getNodeGraphDomEntry, setNodeGraphDomEntry, } from "./native/domEntryRegistry";
+export type { NodeGraphDomEntry } from "./native/domEntryRegistry";
+export { layoutWithDagre, defaultLayoutSpacing } from "./layout/dagre";
+export { buildLayoutRequest, layout, reconcilePositions } from "./layout/layout";
+export type { GraphLayoutOptions } from "./layout/layout";
+export { createLayoutRunner, defaultProbeTimeoutMs, getLayoutRunner, readLayoutRunnerFallback, resetLayoutRunner, resolveRunner, } from "./layout/runner";
+export type { LayoutRunner, LayoutRunnerFallback, LayoutRunnerOptions } from "./layout/runner";
+export type { LayoutDirection, LayoutEdgeInput, LayoutEngine, LayoutNodeInput, LayoutOptions, LayoutRequest, LayoutResult, LayoutWorkerRequest, LayoutWorkerResponse, } from "./layout/types";
+export { cloneStructured, ensureStructuredClone } from "./layout/structuredCloneShim";
+export { layoutWorkerBytes, layoutWorkerSha256 } from "./layout/worker.generated";
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

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

package/types/index.native.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Native barrel.
+ *
+ * Deliberately NOT a mirror of `index.ts`. What a native consumer gets is the
+ * host, the fallback and the bridge types — the canvas itself lives inside the
+ * WebView and exporting it here would let a consumer mount React Flow on the
+ * Hermes side, where it cannot run.
+ *
+ * The model half stays on its own condition
+ * (`@multiplatform.one/node-graph/model`) on both platforms, so a screen that
+ * only needs the document shape does not pull in a WebView.
+ *
+ * Only `.native.*` twins exist in this package — never a `.web.*` twin (MPO-192).
+ */
+export { NodeGraph } from "./NodeGraph.native";
+export type { NodeGraphProps } from "./NodeGraph.native";
+export { demoControlSchemaId, demoGraphSchemaId } from "./react-flow/fixtures";
+export { NodeGraphNative, readyTimeoutMs } from "./native/NodeGraph.native";
+export type { NodeGraphNativeProps } from "./native/NodeGraph.native";
+export { GraphFallback, graphFallbackDetail } from "./native/GraphFallback.native";
+/**
+ * The toolbar is plain Tamagui and lives on the Hermes side, above the WebView
+ * (design §7.3, §7.6). `useLassoSelect` is deliberately NOT here: it imports
+ * `SelectionMode` from the `@xyflow` boundary, and dragging React Flow onto
+ * Hermes to read one enum is exactly what this barrel exists to prevent. The
+ * mode itself is a string a shell can hold in `useState` and send across the
+ * bridge; only its TYPE crosses, and a type is erased.
+ */
+export { GraphToolbar } from "./native/GraphToolbar";
+export type { GraphToolbarProps } from "./native/GraphToolbar";
+export type { GraphInteractionMode } from "./interaction/useLassoSelect";
+/**
+ * The imperative handle a native SIBLING drives the canvas with (design §9.1).
+ *
+ * This is the milestone-6 surface: `NodeGraph` on native drops children, so a
+ * toolbar, a Tidy button and a perf readout reach the canvas through these
+ * eleven commands and read state back off the wire. Exported here because a
+ * consumer needs the TYPE to declare its ref.
+ */
+export { graphCommandNames } from "./react-flow/graphHandle";
+export type { GraphCommands, GraphCommandSlot, NodeGraphHandle } from "./react-flow/graphHandle";
+export { graphChildrenWarning, resetGraphChildrenWarning, warnOnGraphChildren, } from "./native/graphChildren";
+export { DomOnlyStory, hasDomRealm } from "./native/DomOnlyStory";
+export type { DomOnlyStoryProps } from "./native/DomOnlyStory";
+export type { GraphFallbackProps, GraphFallbackReason } from "./native/GraphFallback.native";
+/**
+ * The DOM entry is NOT re-exported here.
+ *
+ * Design §9.3: the entry is app-owned, and this barrel is imported by native
+ * code. Re-exporting the package's own `'use dom'` module would put a second
+ * DOM bundle into every app that touches the barrel — one nothing renders,
+ * because `NodeGraphNative` refuses to mount an entry that has no config. It
+ * stays reachable at `@multiplatform.one/node-graph/dom` for anyone who wants
+ * to read the reference implementation.
+ *
+ * `NodeGraphDomShell` is absent for a sharper reason: its module body stamps
+ * `__mp_graph_boot` at evaluation, and evaluating it on the Hermes side would
+ * write a boot record for a WebView that does not exist. It lives at
+ * `@multiplatform.one/node-graph/dom-inner`, which only a `'use dom'` file ever
+ * imports. Only its TYPES cross to native.
+ */
+export type { NodeGraphDomHandle, NodeGraphDomOptions, NodeGraphDomProps, NodeGraphDomRealmProps, NodeGraphDomShellProps, } from "./dom/NodeGraphDomShell";
+export { clearNodeGraphDomEntry, getNodeGraphDomEntry, setNodeGraphDomEntry, } from "./native/domEntryRegistry";
+export type { NodeGraphDomEntry } from "./native/domEntryRegistry";
+export { bootStageIndex, bootStages, graphReadySettleMs, readBootElapsedMs, readBootRecord, readBootStage, resetBoot, stampBootStage, } from "./dom/boot";
+export type { BootRecord, BootStage } from "./dom/boot";
+/**
+ * The `ready` payload as design 9.5's record, and the panel that renders it.
+ *
+ * Both are on the NATIVE barrel because native is where they are needed: the
+ * canvas is inside a WebView, so `onReady` is the only way its diagnostics
+ * reach a screen. `LiveGraphDiagnostics` is the story-shaped version of that.
+ */
+export { GraphBootFailure, GraphDiagnostics } from "./diagnostics/GraphDiagnostics";
+export type { GraphDiagnosticsProps } from "./diagnostics/GraphDiagnostics";
+export { graphDiagnosticsFromWire } from "./diagnostics/fromWire";
+export type { GraphDiagnostics as GraphDiagnosticsRecord, GraphFaceDelivery, GraphRenderer, LayoutRunnerKind, } from "./diagnostics/types";
+export { createGraphEventEmitter, createRevEchoGate, decodeGraphEvent, encodeGraphEvent, graphEventEmission, graphEventKinds, isBenignCanvasError, isGraphEventKind, } from "./dom/wire";
+export type { FaceProbeWire, FontFaceWire, GraphDiagnosticsWire, GraphFaceDeliveryWire, GraphErrorPhase, GraphEventEmitter, GraphEventKind, GraphEventThrottle, GraphEventWire, LassoPhaseWire, PerfReportWire, RevEchoGate, } from "./dom/wire";
+export { KnobEnvelopeProvider } from "./knobs/KnobEnvelopeProvider";
+export { resolveEnvelopeThemeName } from "./knobs/KnobEnvelopeProvider";
+export { knobEnvelopeIdentity, knobEnvelopeSchemaVersion, knobsForEnvelope, } from "./knobs/envelope";
+export type { GraphFontRef, KnobEnvelope } from "./knobs/envelope";
+export { useKnobEnvelope } from "./knobs/useKnobEnvelope";
+export type { UseKnobEnvelopeOptions } from "./knobs/useKnobEnvelope";
+//# sourceMappingURL=index.native.d.ts.map

package/types/index.native.d.ts.map

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

package/types/interaction/lassoIntercept.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The long-press interceptor (design §7.3, task 3.7).
+ *
+ * One capture-phase `touchmove` listener on an ancestor, calling
+ * `stopPropagation()`. That is the whole mechanism, and it is small because
+ * the reasoning that led to it is where the work was:
+ *
+ *  - d3-zoom binds `touchmove.zoom` (`d3-zoom/src/zoom.js:80`) as a legacy
+ *    `TouchEvent`, in the BUBBLE phase, on the element `zoom()` was called
+ *    with — `.react-flow__renderer`, which is an ANCESTOR of the pane.
+ *  - `setPointerCapture` retargets `PointerEvent`s only, so it cannot take
+ *    that away.
+ *  - d3 consults its `filter` in `touchstarted` (`:316`) and never again in
+ *    `touchmoved` (`:340`), so flipping `panOnDrag` 350 ms into a hold cannot
+ *    stop the gesture already running.
+ *
+ * A capture listener above the renderer runs BEFORE any of that, and
+ * `stopPropagation()` in the capture phase ends the event's journey there:
+ * it never descends to the target and never bubbles back up. The listener that
+ * would have panned the canvas is not removed, disabled or raced — it is
+ * simply never reached.
+ *
+ * Three properties this deliberately has, each with a spec:
+ *
+ *  - `touchmove` ONLY. `touchcancel` has to get through, because arming
+ *    dispatches one at the pane so d3 ends its gesture cleanly instead of
+ *    sitting on a live `g.touch0`. An interceptor that swallowed everything
+ *    would eat its own escape hatch.
+ *  - never `preventDefault()`. Suppressing the pan is a propagation decision,
+ *    not a default-action one, and the pane already carries
+ *    `touch-action: none` (design §7.5).
+ *  - `passive: false` is passed explicitly. Chrome makes a `touchmove`
+ *    listener on `document` or `window` passive by DEFAULT, and a passive
+ *    listener that later needed `preventDefault` would fail silently. Stating
+ *    it means the listener behaves as written wherever it is installed.
+ *
+ * No React and no `@xyflow` here on purpose: this is the piece design §7.3
+ * calls the one mechanism no spike has run, so it is testable at its own level
+ * rather than only through a canvas.
+ */
+export interface LassoInterceptOptions {
+    /**
+     * Any ancestor of the element d3 is bound to. `.react-flow__renderer` is
+     * itself an ancestor of the pane, so an interceptor on the PANE would be
+     * below the listener it is trying to stop — the hook passes the pane's
+     * `ownerDocument`, which cannot be chosen wrongly.
+     */
+    readonly ancestor: EventTarget;
+    /** Each swallowed event, so the marquee can be drawn from the same stream. */
+    readonly onIntercept?: (event: TouchEvent) => void;
+}
+export interface LassoIntercept {
+    /** Removes the listener. Idempotent, and it never removes anyone else's. */
+    readonly release: () => void;
+    readonly active: boolean;
+}
+export declare function installLassoIntercept(options: LassoInterceptOptions): LassoIntercept;
+//# sourceMappingURL=lassoIntercept.d.ts.map

package/types/interaction/lassoIntercept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lassoIntercept.d.ts","sourceRoot":"","sources":["../../src/interaction/lassoIntercept.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAqBpF"}

package/types/interaction/legalTargets.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Which ports a connection drag is allowed to land on (design §7.4, §4.4).
+ *
+ * `connectionRadius` is the 44 px hit diameter (task 3.4 H5), so React Flow's
+ * magnetism will snap a drag onto whatever handle is nearest — including one
+ * the schema refuses. That is correct behaviour from React Flow and the wrong
+ * thing to SHOW: a puck naming a target the drop then rejects teaches a user
+ * that the affordance lies. So the candidates get filtered through the same
+ * rule engine the drop will use.
+ *
+ * Pure. No React, no DOM, no `@xyflow` — it runs in vitest under Node, and the
+ * same function answers for the puck, for a keyboard flow, and for a headless
+ * consumer that wants to know what its document permits.
+ *
+ * `validateConnection` and never `validateDrop`. This is the pointer-tick path
+ * and `refuseCycle` is O(V+E); the TYPE refuses it here rather than a comment
+ * asking nicely (design §4.4).
+ */
+import type { ConnectionRule, EdgeKindDefs, GraphDocument, GraphSchema, NodeKindDefs, PortRef } from "../model/index";
+export interface LegalTargetQuery<N extends NodeKindDefs, E extends EdgeKindDefs> {
+    readonly document: GraphDocument<N, E>;
+    readonly schema: GraphSchema<N, E>;
+    /** Where the drag started. An input here yields nothing, by `refuseDirection`. */
+    readonly source: PortRef;
+    /** Defaults to the schema's own rules, which is what the drop will use. */
+    readonly rules?: readonly ConnectionRule<N, E>[];
+}
+/**
+ * Every port `validateConnection` accepts for this source, in DOCUMENT order.
+ *
+ * Order is part of the contract: a candidate list that reshuffles between
+ * pointer ticks would make a highlight flicker between two equally legal ports
+ * on the same node.
+ *
+ * A port on the source node is not special-cased. Whether a self-loop is legal
+ * is the schema's call, made by including or omitting `refuseSelfLoop`, and
+ * this function has no opinion of its own — which is what lets a schema that
+ * wants loops have them without a flag here.
+ */
+export declare function legalTargets<N extends NodeKindDefs, E extends EdgeKindDefs>(query: LegalTargetQuery<N, E>): readonly PortRef[];
+/**
+ * The same answer for ONE candidate, without walking the document.
+ *
+ * What the puck actually calls. React Flow has already told us which handle it
+ * snapped to, so asking about every port to check one is work paid on every
+ * pointer tick of every drag.
+ */
+export declare function isLegalTarget<N extends NodeKindDefs, E extends EdgeKindDefs>(query: LegalTargetQuery<N, E> & {
+    readonly target: PortRef;
+}): boolean;
+/**
+ * React Flow's magnetic candidates, minus the ones the rules refuse.
+ *
+ * Order is the caller's, not the document's: React Flow hands these back
+ * sorted by distance, and re-sorting them into document order would throw away
+ * the "nearest" the magnetism just computed.
+ */
+export declare function filterLegalCandidates<N extends NodeKindDefs, E extends EdgeKindDefs>(candidates: readonly PortRef[], query: LegalTargetQuery<N, E>): readonly PortRef[];
+//# sourceMappingURL=legalTargets.d.ts.map

package/types/interaction/legalTargets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legalTargets.d.ts","sourceRoot":"","sources":["../../src/interaction/legalTargets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,OAAO,EACR,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,YAAY;IAC9E,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;CAClD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,YAAY,EACzE,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC5B,SAAS,OAAO,EAAE,CAUpB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,YAAY,EAC1E,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3D,OAAO,CAGT;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,YAAY,EAClF,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC5B,SAAS,OAAO,EAAE,CAEpB"}

package/types/interaction/snapAlignment.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Alignment snapping, design §7.2. Pure: no DOM, no React, no `@xyflow`, so it
+ * runs in vitest under Node and could run in a worklet or a worker later.
+ *
+ * This is a PORT of the native-first spike's snapper, not a fresh design. Two
+ * things changed on the way in, and both are the whole reason the port was
+ * worth doing rather than copying:
+ *
+ *  - the spike snapped ONE node by its index in a flat position array. This
+ *    takes the dragged selection's **union rect** and its **id set**, so a
+ *    multi-select drag snaps the box and one delta moves every member (S6);
+ *  - the spike compared origins only. This compares the nine line pairs
+ *    (S4), so a node aligns to a neighbour's centre or far edge, which is what
+ *    makes the guides mean anything.
+ *
+ * The threshold arrives in FLOW units and is a screen distance divided by the
+ * zoom (S2). `alignmentThreshold` does that division; the caller owns the zoom.
+ */
+import type { NodeId, Rect, XY } from "../model/document";
+import type { SpatialHash } from "./spatialHash";
+/** Design §7.2: 8 on a mouse, 12 under a finger, both in SCREEN px. */
+export declare const defaultSnapThresholdPx: {
+    readonly fine: 8;
+    readonly coarse: 12;
+};
+/** Design §7.2 S3. How far from the dragged box a neighbour may be and count. */
+export declare const defaultCandidateRadius = 400;
+export interface PositionedNode {
+    readonly id: NodeId;
+    readonly rect: Rect;
+}
+export type SnapAxis = "x" | "y";
+/** The three lines a rect offers per axis: `{left, centerX, right}` in §7.2's words. */
+export type SnapLine = "start" | "center" | "end";
+export interface SnapGuide {
+    readonly axis: SnapAxis;
+    /** The flow coordinate of the line: an x for a vertical guide, a y for a horizontal one. */
+    readonly position: number;
+    /** Where the line starts on the OTHER axis. Spans the moved rect and the neighbour. */
+    readonly start: number;
+    readonly end: number;
+    /** The neighbour it aligned to, so a story can name it and a test can assert it. */
+    readonly nodeId: NodeId;
+    readonly movingLine: SnapLine;
+    readonly candidateLine: SnapLine;
+}
+export interface SnapResult {
+    /** The snapped top-left of the dragged selection's union rect. */
+    readonly position: XY;
+    /** At most two: one per axis. Design §7.2 S10. */
+    readonly guides: readonly SnapGuide[];
+    /** True the frame a guide appears — what haptics fire on, once. */
+    readonly acquired: boolean;
+}
+export interface SnapToAlignmentInput {
+    /** The WHOLE dragged selection. Every member is excluded from candidates (S7). */
+    readonly ids: readonly NodeId[];
+    /** Union bounds of that selection, unsnapped. */
+    readonly rect: Rect;
+    /**
+     * Live geometry. The index is the drag-start snapshot and only picks WHICH
+     * neighbours to consider; this map is what the arithmetic reads, so a node
+     * that moved under a programmatic change is aligned to where it is now.
+     */
+    readonly nodes: ReadonlyMap<NodeId, PositionedNode>;
+    /** Built once at drag start, from every node (S3). */
+    readonly index: SpatialHash;
+    readonly thresholdFlowUnits: number;
+    readonly radius: number;
+}
+/**
+ * Screen px → flow units. A fixed flow-unit threshold is 4 screen px at 0.5×,
+ * which is the "snapping feels dead when I pinch out" bug, so this division is
+ * not a detail (S2).
+ *
+ * A zoom of zero or less returns 0 rather than Infinity: React Flow clamps zoom
+ * well above zero, but a threshold of Infinity would snap the node to the first
+ * neighbour in the index and there would be no way to see why.
+ */
+export declare function alignmentThreshold(options: {
+    readonly thresholdScreenPx: number;
+    readonly zoom: number;
+}): number;
+export declare function snapToAlignment(input: SnapToAlignmentInput): SnapResult;
+//# sourceMappingURL=snapAlignment.d.ts.map

package/types/interaction/snapAlignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapAlignment.d.ts","sourceRoot":"","sources":["../../src/interaction/snapAlignment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,uEAAuE;AACvE,eAAO,MAAM,sBAAsB;;;CAAmC,CAAC;AAEvE,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,CAAC;AAEjC,wFAAwF;AACxF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACpD,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAIT;AAqFD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU,CA8BvE"}

package/types/interaction/snapChanges.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Snapping wired into `onNodesChange`, design §7.2 rules S1, S3, S5, S6 and S11.
+ *
+ * Pure, and deliberately structural about its inputs: it names no `@xyflow`
+ * type, so it runs under Node and the boundary in `react-flow/xy.ts` stays the
+ * only import site. `SnapChange` and `SnapChangeNode` are the shape React Flow
+ * happens to hand us, written down rather than imported.
+ *
+ * The three decisions worth reading before changing anything here:
+ *
+ *  - **A live drag only (S1).** A programmatic move — layout, undo, paste — is
+ *    never snapped, or a relayout fights itself.
+ *
+ *    S1's wording says `dragging === true` and nothing else. Taken literally
+ *    that undoes every snap at the moment of release, and it was MEASURED
+ *    doing so in Chrome on `NodeGraph/Snapping → ZoomThreshold`: mid-drag the
+ *    node sat at the aligned 370 with a guide painted, and on mouseup it
+ *    jumped back off the line. The mechanism is `XYDrag`'s `end` handler
+ *    (`@xyflow/system/dist/esm/index.js:2311-2316`) calling
+ *    `updateNodePositions(dragItems, false)`, which re-emits the position
+ *    XYDrag derived from the raw pointer (`:2154`, `x - dragItem.distance.x`).
+ *    Those drag items never saw our rewrite, so the closing frame is the
+ *    unsnapped one and it is also the frame the document commits.
+ *
+ *    So the rule as built is: a position change is snapped when it belongs to
+ *    a LIVE drag — `dragging: true`, or the `dragging: false` frame that
+ *    closes a drag this session was already snapping. A change with `dragging`
+ *    undefined is still never snapped, and neither is a `dragging: false`
+ *    change with no live session, which is what a stray programmatic set looks
+ *    like. That keeps S1's intent and makes the snap survive the mouse button
+ *    coming up.
+ *  - **The index is a drag, not a frame (S3).** It is built once, on the first
+ *    dragging change, from every node NOT in the dragged set, and lives in a
+ *    `SnapSession` the caller owns. Rebuilding it per frame is the difference
+ *    between a query and a re-scan of the whole graph 120 times a second.
+ *  - **Grid first, alignment per axis (S5).** The grid runs on the union rect,
+ *    then alignment runs from THERE, and an axis keeps its grid value unless a
+ *    guide fired on it. Running alignment from the raw pointer instead would
+ *    make a node the grid carried into range fail to align, which reads as the
+ *    snap being flaky rather than as two rules composing.
+ */
+import type { NodeId, Rect, XY } from "../model/document";
+import type { PositionedNode, SnapGuide } from "./snapAlignment";
+import type { SpatialHash, SpatialItem } from "./spatialHash";
+/** Alignment on, grid off — React Flow's own `snapToGrid` defaults off too. */
+export declare const graphSnappingDefaults: {
+    readonly alignment: true;
+    readonly grid: null;
+};
+export interface GraphSnappingOptions {
+    /**
+     * Design §7.2. Off per node via `node.locked`, which React Flow enforces
+     * upstream by refusing to drag a locked node at all.
+     */
+    readonly alignment?: boolean;
+    /** Flow units, or `null` for no grid. */
+    readonly grid?: number | null;
+    /** SCREEN px. Divided by the zoom before use (S2). */
+    readonly thresholdScreenPx?: number;
+}
+/** The subset of a React Flow node change this reads. */
+export interface SnapChange {
+    readonly type: string;
+    readonly id?: NodeId;
+    readonly position?: XY;
+    readonly dragging?: boolean;
+}
+/** The subset of a React Flow node this reads, seeded or measured. */
+export interface SnapChangeNode {
+    readonly id: NodeId;
+    readonly position: XY;
+    readonly measured?: {
+        readonly width?: number | null;
+        readonly height?: number | null;
+    };
+    readonly width?: number | null;
+    readonly height?: number | null;
+    readonly initialWidth?: number | null;
+    readonly initialHeight?: number | null;
+}
+/**
+ * The drag's memory. The caller holds one (a ref) and hands it back every
+ * frame; nothing here is global, so two canvases on one page cannot share an
+ * index built from the other's nodes.
+ */
+export interface SnapSession {
+    index: SpatialHash | null;
+    nodes: ReadonlyMap<NodeId, PositionedNode> | null;
+    /** The dragged id set this index was built against. */
+    key: string | null;
+    /** Diagnostic: how many times the index was built. One per drag. */
+    builds: number;
+}
+export interface SnapContext {
+    readonly nodes: readonly SnapChangeNode[];
+    readonly zoom: number;
+    readonly session: SnapSession;
+    readonly alignment?: boolean;
+    readonly grid?: number | null;
+    readonly thresholdScreenPx?: number;
+    readonly radius?: number;
+    /** Test seam. The spy that proves S3, and nothing else uses it. */
+    readonly buildIndex?: (items: readonly SpatialItem[]) => SpatialHash;
+}
+export interface SnapChangesResult<C> {
+    /** The input array itself when nothing moved, so React sees no new work. */
+    readonly changes: readonly C[];
+    readonly guides: readonly SnapGuide[];
+}
+export declare function createSnapSession(): SnapSession;
+export declare function resetSnapSession(session: SnapSession): void;
+/**
+ * S11, stated as code: motion settings reach `animateGuides` and nothing else.
+ *
+ * Snapping is not motion. `animation: "none"` and OS reduced-motion turn off
+ * the guide's fade; a canvas where the node stops aligning because someone
+ * turned animations off is a different, worse editor.
+ */
+export declare function snapContextOptions(input: {
+    readonly snapping?: GraphSnappingOptions;
+    readonly animation?: string | null;
+    readonly reducedMotion?: boolean;
+    readonly coarsePointer?: boolean;
+}): {
+    readonly alignment: boolean;
+    readonly grid: number | null;
+    readonly thresholdScreenPx: number;
+    readonly animateGuides: boolean;
+};
+/** Measured wins, then a document-set size, then the pre-paint seed (design §5). */
+export declare function snapNodeRect(node: SnapChangeNode): Rect;
+export declare function applySnapToChanges<C extends SnapChange>(changes: readonly C[], context: SnapContext): SnapChangesResult<C>;
+//# sourceMappingURL=snapChanges.d.ts.map

package/types/interaction/snapChanges.d.ts.map

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

package/types/interaction/spatialHash.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A uniform-grid spatial hash over node rects. Pure: no DOM, no React, no
+ * `@xyflow`, so it runs in vitest under Node and in a worker later.
+ *
+ * Design §7.2 rule S3: the index is built ONCE at drag start from every
+ * non-dragged node, and every frame of the drag queries it. Cell 256 flow
+ * units, which is roughly a node and a gap — small enough that a query touches
+ * a handful of buckets, large enough that a 200-node graph is a few hundred
+ * cells rather than tens of thousands.
+ *
+ * `query` returns the EXACT overlap set, not the bucket contents. A broad phase
+ * that hands back near misses would make every caller re-filter, and the one
+ * caller there is (`snapToAlignment`) would then be the place a shared-edge
+ * off-by-one lived. `rectsOverlap` from the model is the single definition of
+ * touching, so the marquee and the snapper cannot disagree about it.
+ */
+import type { NodeId, Rect } from "../model/document";
+/** 256 flow units: about one node plus its gap. Design §7.2 S3. */
+export declare const defaultCellSize = 256;
+export interface SpatialItem {
+    readonly id: NodeId;
+    readonly rect: Rect;
+}
+export interface SpatialHash {
+    readonly cellSize: number;
+    /** Items handed to `buildSpatialHash`, including any that were unindexable. */
+    readonly size: number;
+    /** Occupied buckets. Diagnostic — a cell size that fits the graph keeps it small. */
+    readonly cellCount: number;
+    /** Every item overlapping `rect`, in insertion order. */
+    query(rect: Rect): readonly SpatialItem[];
+}
+export interface SpatialHashOptions {
+    readonly cellSize?: number;
+}
+export declare function buildSpatialHash(items: Iterable<SpatialItem>, options?: SpatialHashOptions): SpatialHash;
+//# sourceMappingURL=spatialHash.d.ts.map

package/types/interaction/spatialHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatialHash.d.ts","sourceRoot":"","sources":["../../src/interaction/spatialHash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGtD,mEAAmE;AACnE,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,WAAW,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAkCD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC5B,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAkDb"}