@yurialvesbordin/graphium 0.0.0-stage → 2.0.1

package/dist/core/types.d.ts

@@ -0,0 +1,287 @@
+/**
+ * Defines every public contract used by the Graphium public API, the physics
+ * engine and the renderer. Keeping all option shapes in one module makes the
+ * library surface searchable and refactors predictable.
+ */
+export type NodeId = string | number;
+export type LinkId = string | number;
+export type NodeStateName = 'normal' | 'hover' | 'selected' | 'dragging' | 'fixed' | 'disabled';
+export type LinkStyleName = 'solid' | 'dashed';
+export type ColorInput = string | number | [number, number, number] | [number, number, number, number];
+export interface NodeOptions {
+    id?: NodeId;
+    x?: number;
+    y?: number;
+    label?: string | null;
+    color?: ColorInput;
+    borderColor?: ColorInput;
+    borderWidth?: number;
+    borderOpacity?: number;
+    opacity?: number;
+    radius?: number;
+    visualRadius?: number;
+    mass?: number;
+    image?: string | null;
+    imageMode?: 'cover' | 'contain';
+    fixed?: boolean;
+    state?: NodeStateName;
+    disabled?: boolean;
+    hidden?: boolean;
+    data?: Record<string, unknown>;
+}
+export interface LinkOptions {
+    id?: LinkId;
+    source?: NodeId;
+    target?: NodeId;
+    color?: ColorInput;
+    width?: number;
+    opacity?: number;
+    curvature?: number;
+    style?: LinkStyleName;
+    dashPattern?: [number, number];
+    dashOffset?: number;
+    dashWorldScale?: boolean;
+    arrow?: boolean;
+    arrowSize?: number;
+    arrowWidth?: number;
+    strength?: number;
+    restLength?: number;
+    hidden?: boolean;
+    data?: Record<string, unknown>;
+}
+export interface PhysicsOptions {
+    preset?: PhysicsPresetName;
+    repulsion?: number;
+    repulsionRadius?: number;
+    degreeFactor?: number;
+    degreeExponent?: number;
+    springStrength?: number;
+    gravity?: number;
+    damping?: number;
+    maxSpeed?: number;
+    collisionStrength?: number;
+    positionIterations?: number;
+    temperature?: number;
+    cooling?: number;
+    minTemperature?: number;
+    sleepEnergy?: number;
+    sleepFrames?: number;
+    maxNeighbors?: number;
+    edgeSeparation?: number;
+    dragSmooth?: number;
+    throwFactor?: number;
+}
+export type PhysicsPresetName = 'silk' | 'bouncy' | 'crystal' | 'liquid';
+export interface ThemeOptions {
+    background?: string;
+    node?: {
+        radius?: number;
+        color?: ColorInput;
+        colorPalette?: ColorInput[];
+        borderColor?: ColorInput;
+        borderWidth?: number;
+        borderOpacity?: number;
+        opacity?: number;
+    };
+    edge?: {
+        color?: ColorInput;
+        width?: number;
+        opacity?: number;
+        curvature?: number;
+        style?: LinkStyleName;
+        arrowEnabled?: boolean;
+        arrowSize?: number;
+        arrowWidth?: number;
+    };
+    hoverRing?: {
+        color?: ColorInput;
+        width?: number;
+    };
+    selectedRing?: {
+        color?: ColorInput;
+        width?: number;
+    };
+    fixedRing?: {
+        color?: ColorInput;
+        width?: number;
+    };
+    disabledOpacity?: number;
+    selectedEdge?: {
+        color?: ColorInput;
+        widthMultiplier?: number;
+        opacity?: number;
+    };
+    label?: {
+        enabled?: boolean;
+        position?: 'above' | 'below' | 'center';
+        offset?: number;
+        size?: number;
+        color?: string;
+        font?: string;
+        weight?: number | string;
+        background?: string | null;
+        padding?: [number, number];
+        radius?: number;
+    };
+}
+export interface InteractionOptions {
+    enabled?: boolean;
+    wheelZoomSpeed?: number;
+    dragThreshold?: number;
+    longPressMs?: number;
+    linkHitRadius?: number;
+    hoverEnabled?: boolean;
+    panEnabled?: boolean;
+    zoomEnabled?: boolean;
+    dragEnabled?: boolean;
+}
+export interface RendererOptions {
+    clearColor?: string;
+    antialias?: boolean;
+    maxPixelRatio?: number;
+    fadeZoom?: number;
+}
+export interface GraphiumOptions {
+    canvas?: HTMLCanvasElement | null;
+    container?: HTMLElement | null;
+    autoStart?: boolean;
+    autoResize?: boolean;
+    autoFit?: boolean;
+    nodeCapacity?: number;
+    linkCapacity?: number;
+    physics?: PhysicsOptions;
+    theme?: ThemeOptions;
+    interaction?: boolean | InteractionOptions;
+    renderer?: RendererOptions;
+    camera?: {
+        minZoom?: number;
+        maxZoom?: number;
+        x?: number;
+        y?: number;
+        zoom?: number;
+    };
+}
+export interface GraphData {
+    nodes?: Array<NodeOptions & {
+        id: NodeId;
+    }>;
+    links?: Array<LinkOptions & {
+        source: NodeId;
+        target: NodeId;
+    }>;
+}
+export interface NodeSnapshot {
+    id: NodeId;
+    index: number;
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+    radius: number;
+    visualRadius: number;
+    mass: number;
+    degree: number;
+    color: number;
+    borderColor: number;
+    borderWidth: number;
+    opacity: number;
+    image: string | null;
+    label: string | null;
+    state: NodeStateName;
+    fixed: boolean;
+    hidden: boolean;
+    disabled: boolean;
+    data: Record<string, unknown>;
+}
+export interface LinkSnapshot {
+    id: LinkId;
+    index: number;
+    source: NodeId;
+    target: NodeId;
+    sourceIndex: number;
+    targetIndex: number;
+    color: number;
+    width: number;
+    opacity: number;
+    curvature: number;
+    style: LinkStyleName;
+    dashPattern: [number, number];
+    dashOffset: number;
+    arrow: boolean | undefined;
+    arrowSize: number;
+    arrowWidth: number;
+    strength: number;
+    restLength: number;
+    hidden: boolean;
+    data: Record<string, unknown>;
+}
+export interface PointerEventPayload {
+    type: string;
+    originalEvent: PointerEvent | WheelEvent | MouseEvent;
+    nodeIndex: number;
+    nodeId?: NodeId;
+    linkIndex: number;
+    linkId?: LinkId;
+    screenX: number;
+    screenY: number;
+    worldX: number;
+    worldY: number;
+}
+export interface SelectionEventPayload {
+    nodes: NodeId[];
+    links: LinkId[];
+}
+export interface PhysicsRuntime {
+    energy: number;
+    sleeping: boolean;
+    temperature: number;
+    iteration: number;
+}
+export interface StatsSnapshot {
+    nodeCount: number;
+    linkCount: number;
+    fps: number;
+    frameMs: number;
+    physicsMs: number;
+    renderMs: number;
+    sleeping: boolean;
+}
+export interface ThemeResolved {
+    background: string;
+    nodeRadius: number;
+    nodeColor: number;
+    nodeColorPalette: number[];
+    nodeBorderColor: number;
+    nodeBorderWidth: number;
+    nodeBorderOpacity: number;
+    nodeOpacity: number;
+    edgeColor: number;
+    edgeWidth: number;
+    edgeOpacity: number;
+    edgeCurvature: number;
+    edgeStyle: LinkStyleName;
+    edgeArrowEnabled: boolean;
+    edgeArrowSize: number;
+    edgeArrowWidth: number;
+    hoverRingColor: number;
+    hoverRingWidth: number;
+    selectedRingColor: number;
+    selectedRingWidth: number;
+    fixedRingColor: number;
+    fixedRingWidth: number;
+    disabledOpacity: number;
+    selectedEdgeColor: number;
+    selectedEdgeWidthMultiplier: number;
+    selectedEdgeOpacity: number;
+    labelEnabled: boolean;
+    labelPosition: 'above' | 'below' | 'center';
+    labelOffset: number;
+    labelSize: number;
+    labelColor: string;
+    labelFont: string;
+    labelWeight: number | string;
+    labelBackground: string | null;
+    labelPadding: [number, number];
+    labelRadius: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,7 @@
+/**
+ * Defines every public contract used by the Graphium public API, the physics
+ * engine and the renderer. Keeping all option shapes in one module makes the
+ * library surface searchable and refactors predictable.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Public entry point of the Graphium library. Everything a consumer needs is
+ * re-exported here while internal modules stay private.
+ */
+export { Graphium } from './Graphium.js';
+export { GraphModel, NODE_FIXED, NODE_SELECTED, NODE_DRAGGED, NODE_HIDDEN, NODE_DISABLED, NODE_DIM, LINK_SELECTED, LINK_HIDDEN, LINK_DIM, STATE_NORMAL, STATE_HOVER, STATE_SELECTED, STATE_DRAGGING, STATE_FIXED, STATE_DISABLED } from './core/GraphModel.js';
+export { NodeHandle, LinkHandle } from './core/handles.js';
+export { Emitter } from './core/events.js';
+export { packRGBA, unpackRGBA, deterministicColor } from './core/colors.js';
+export { BUILT_IN_THEMES, themeNames } from './core/themes.js';
+export { PhysicsEngine } from './physics/PhysicsEngine.js';
+export { PRESETS, presetNames } from './physics/presets.js';
+export { SpatialHash } from './physics/SpatialHash.js';
+export { Camera } from './render/Camera.js';
+export { Renderer } from './render/Renderer.js';
+export { TextureAtlas } from './render/TextureAtlas.js';
+export { LabelLayer } from './render/LabelLayer.js';
+export { PointerController } from './interaction/PointerController.js';
+export { controlPoint, bezierPoint, bezierLength, distanceToEdge, distanceToSegment } from './render/geometry.js';
+export type { NodeId, LinkId, NodeStateName, LinkStyleName, ColorInput, NodeOptions, LinkOptions, PhysicsOptions, PhysicsPresetName, ThemeOptions, InteractionOptions, RendererOptions, GraphiumOptions, GraphData, NodeSnapshot, LinkSnapshot, PointerEventPayload, StatsSnapshot, ThemeResolved, } from './core/types.js';
+//# 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;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/P,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAClH,YAAY,EACV,MAAM,EACN,MAAM,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * Public entry point of the Graphium library. Everything a consumer needs is
+ * re-exported here while internal modules stay private.
+ */
+export { Graphium } from './Graphium.js';
+export { GraphModel, NODE_FIXED, NODE_SELECTED, NODE_DRAGGED, NODE_HIDDEN, NODE_DISABLED, NODE_DIM, LINK_SELECTED, LINK_HIDDEN, LINK_DIM, STATE_NORMAL, STATE_HOVER, STATE_SELECTED, STATE_DRAGGING, STATE_FIXED, STATE_DISABLED } from './core/GraphModel.js';
+export { NodeHandle, LinkHandle } from './core/handles.js';
+export { Emitter } from './core/events.js';
+export { packRGBA, unpackRGBA, deterministicColor } from './core/colors.js';
+export { BUILT_IN_THEMES, themeNames } from './core/themes.js';
+export { PhysicsEngine } from './physics/PhysicsEngine.js';
+export { PRESETS, presetNames } from './physics/presets.js';
+export { SpatialHash } from './physics/SpatialHash.js';
+export { Camera } from './render/Camera.js';
+export { Renderer } from './render/Renderer.js';
+export { TextureAtlas } from './render/TextureAtlas.js';
+export { LabelLayer } from './render/LabelLayer.js';
+export { PointerController } from './interaction/PointerController.js';
+export { controlPoint, bezierPoint, bezierLength, distanceToEdge, distanceToSegment } from './render/geometry.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;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/P,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/interaction/InteractionBinder.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Connects user input to graph behavior: builds the pointer controller,
+ * routes pointer and physics events, maintains the hover state and exposes
+ * link hit testing.
+ */
+import type { Emitter } from '../core/events.js';
+import { GraphModel } from '../core/GraphModel.js';
+import type { SelectionController } from '../core/SelectionController.js';
+import type { GraphiumOptions, InteractionOptions } from '../core/types.js';
+import type { PhysicsEngine } from '../physics/PhysicsEngine.js';
+import type { SpatialHash } from '../physics/SpatialHash.js';
+import type { Camera } from '../render/Camera.js';
+/** Collaborators and hooks the binder needs from the main facade. */
+export interface InteractionDeps {
+    canvas: HTMLCanvasElement;
+    model: GraphModel;
+    physics: PhysicsEngine;
+    camera: Camera;
+    hash: SpatialHash;
+    events: Emitter;
+    interaction: GraphiumOptions['interaction'];
+    selection: SelectionController;
+    invalidate: () => void;
+}
+export declare class InteractionBinder {
+    private readonly deps;
+    private pointer;
+    private hoverIndex;
+    constructor(deps: InteractionDeps);
+    /** Updates interaction options on the live pointer controller. */
+    setInteraction(options: InteractionOptions): void;
+    /** Finds the link index closest to a world position within a radius. */
+    pickLinkAt(worldX: number, worldY: number, hitRadius?: number): number;
+    /** Releases the pointer controller. */
+    destroy(): void;
+    /** Builds the pointer controller when interaction is not disabled. */
+    private wirePointer;
+    /** Connects library internal reactions to emitter traffic. */
+    private wireEvents;
+    /** Updates the hovered node and keeps the previous one consistent. */
+    private setHover;
+}
+//# sourceMappingURL=InteractionBinder.d.ts.map

package/dist/interaction/InteractionBinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionBinder.d.ts","sourceRoot":"","sources":["../../src/interaction/InteractionBinder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAA0C,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IAC5C,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,UAAU,CAAM;gBAEK,IAAI,EAAE,eAAe;IAKlD,kEAAkE;IAClE,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAMjD,wEAAwE;IACxE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,MAAM;IAqBjE,uCAAuC;IACvC,OAAO,IAAI,IAAI;IAIf,sEAAsE;IACtE,OAAO,CAAC,WAAW;IAmBnB,8DAA8D;IAC9D,OAAO,CAAC,UAAU;IAoClB,sEAAsE;IACtE,OAAO,CAAC,QAAQ;CAcjB"}

package/dist/interaction/InteractionBinder.js

@@ -0,0 +1,121 @@
+/**
+ * Connects user input to graph behavior: builds the pointer controller,
+ * routes pointer and physics events, maintains the hover state and exposes
+ * link hit testing.
+ */
+import { LINK_HIDDEN, STATE_HOVER, STATE_NORMAL } from '../core/GraphModel.js';
+import { PointerController } from './PointerController.js';
+import { distanceToEdge } from '../render/geometry.js';
+export class InteractionBinder {
+    constructor(deps) {
+        this.deps = deps;
+        this.pointer = null;
+        this.hoverIndex = -1;
+        this.wirePointer();
+        this.wireEvents();
+    }
+    /** Updates interaction options on the live pointer controller. */
+    setInteraction(options) {
+        if (this.pointer) {
+            Object.assign(this.pointer.options, options);
+        }
+    }
+    /** Finds the link index closest to a world position within a radius. */
+    pickLinkAt(worldX, worldY, hitRadius = 8) {
+        const model = this.deps.model;
+        const tolerance = hitRadius / Math.max(this.deps.camera.zoom, 0.0001);
+        let best = -1;
+        let bestDistance = Infinity;
+        for (let link = 0; link < model.linkCount; link++) {
+            if (model.linkFlags[link] & LINK_HIDDEN) {
+                continue;
+            }
+            const source = model.source[link];
+            const target = model.target[link];
+            const distance = distanceToEdge(worldX, worldY, model.x[source], model.y[source], model.x[target], model.y[target], model.linkCurvature[link]);
+            const limit = tolerance + model.linkWidth[link] / Math.max(this.deps.camera.zoom, 0.0001);
+            if (distance <= limit && distance < bestDistance) {
+                best = link;
+                bestDistance = distance;
+            }
+        }
+        return best;
+    }
+    /** Releases the pointer controller. */
+    destroy() {
+        this.pointer?.destroy();
+    }
+    /** Builds the pointer controller when interaction is not disabled. */
+    wirePointer() {
+        const interaction = this.deps.interaction;
+        if (interaction === false) {
+            return;
+        }
+        const settings = interaction === true || interaction === undefined ? {} : interaction;
+        this.pointer = new PointerController(this.deps.canvas, this.deps.camera, this.deps.model, this.deps.physics, this.deps.hash, this.deps.events, {
+            wheelZoomSpeed: settings.wheelZoomSpeed,
+            dragThreshold: settings.dragThreshold,
+            longPressMs: settings.longPressMs,
+            linkHitRadius: settings.linkHitRadius,
+            hoverEnabled: settings.hoverEnabled,
+            panEnabled: settings.panEnabled,
+            zoomEnabled: settings.zoomEnabled,
+            dragEnabled: settings.dragEnabled,
+            pickLink: (worldX, worldY, radius) => this.pickLinkAt(worldX, worldY, radius),
+        });
+    }
+    /** Connects library internal reactions to emitter traffic. */
+    wireEvents() {
+        const { physics, events, selection, invalidate } = this.deps;
+        physics.onSleep = energy => {
+            events.emit('sleep', { energy });
+        };
+        physics.onWake = () => {
+            events.emit('wake', {});
+            invalidate();
+        };
+        events.on('pan', () => invalidate());
+        events.on('zoom', () => invalidate());
+        events.on('pinch', () => invalidate());
+        events.on('hover', payload => {
+            const event = payload;
+            this.setHover(typeof event.nodeIndex === 'number' ? event.nodeIndex : -1);
+            invalidate();
+        });
+        events.on('click', payload => {
+            const event = payload;
+            if (event.linkIndex >= 0) {
+                selection.selectLink(event.linkIndex, true);
+            }
+            else if (event.nodeIndex >= 0) {
+                selection.selectNode(event.nodeIndex, true);
+            }
+            else {
+                selection.clear();
+            }
+            invalidate();
+        });
+        events.on('drag', () => {
+            physics.wake();
+            invalidate();
+        });
+        events.on('dragend', () => invalidate());
+        events.on('imageload', () => invalidate());
+    }
+    /** Updates the hovered node and keeps the previous one consistent. */
+    setHover(index) {
+        const previous = this.hoverIndex;
+        if (previous === index) {
+            return;
+        }
+        const state = this.deps.model.state;
+        if (previous >= 0 && state[previous] === STATE_HOVER) {
+            state[previous] = STATE_NORMAL;
+        }
+        this.hoverIndex = index;
+        if (index >= 0 && state[index] === STATE_NORMAL) {
+            state[index] = STATE_HOVER;
+        }
+    }
+}
+//# sourceMappingURL=InteractionBinder.js.map

package/dist/interaction/InteractionBinder.js.map

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

package/dist/interaction/PointerController.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Translates pointer and wheel activity into graph gestures. The controller
+ * handles node dragging through the physics engine so releases carry
+ * momentum, supports pinch zoom, hover picking, click detection and long
+ * presses, and emits normalized event payloads.
+ */
+import { GraphModel } from '../core/GraphModel.js';
+import type { Emitter } from '../core/events.js';
+import { Camera } from '../render/Camera.js';
+import { PhysicsEngine } from '../physics/PhysicsEngine.js';
+import { SpatialHash } from '../physics/SpatialHash.js';
+export interface PointerOptions {
+    wheelZoomSpeed?: number;
+    dragThreshold?: number;
+    longPressMs?: number;
+    linkHitRadius?: number;
+    hoverEnabled?: boolean;
+    panEnabled?: boolean;
+    zoomEnabled?: boolean;
+    dragEnabled?: boolean;
+    pickLink?: (worldX: number, worldY: number, radius: number) => number;
+}
+export declare class PointerController {
+    options: Required<Omit<PointerOptions, 'pickLink'>> & Pick<PointerOptions, 'pickLink'>;
+    enabled: boolean;
+    private element;
+    private camera;
+    private model;
+    private physics;
+    private hash;
+    private emitter;
+    private pointers;
+    private dragNode;
+    private activeLink;
+    private isPanning;
+    private downX;
+    private downY;
+    private moved;
+    private longPressTimer;
+    private pickBuffer;
+    private world;
+    private lastClickTime;
+    private lastClickButton;
+    private boundDown;
+    private boundMove;
+    private boundUp;
+    private boundWheel;
+    private boundLeave;
+    private boundContext;
+    constructor(element: HTMLElement, camera: Camera, model: GraphModel, physics: PhysicsEngine, hash: SpatialHash, emitter: Emitter, options?: PointerOptions);
+    /** Converts client coordinates into camera space and world space. */
+    private updateWorld;
+    /** Finds the topmost node under a world position. */
+    private pickNode;
+    /** Resolves the link under a world position through the host callback. */
+    private pickLinkAt;
+    /** Emits a normalized payload to the shared event emitter. */
+    private emit;
+    /** Handles pointer press by picking nodes, links or starting a pan. */
+    private onPointerDown;
+    /** Handles pointer motion for dragging, panning, pinching and hovering. */
+    private onPointerMove;
+    private pinchDistance;
+    private pinchCenterX;
+    private pinchCenterY;
+    /** Clears drag flags and lets the physics engine keep the momentum. */
+    private releaseDrag;
+    /** Handles pointer release, click synthesis and double click detection. */
+    private onPointerUp;
+    /** Emits click or dblclick depending on timing of consecutive clicks. */
+    private emitClick;
+    /** Zooms the view around the wheel position. */
+    private onWheel;
+    /** Ends hover tracking when the pointer leaves the canvas. */
+    private onLeave;
+    /** Attaches all DOM listeners and activates gesture handling. */
+    enable(): this;
+    /** Detaches all DOM listeners and stops gesture handling. */
+    disable(): this;
+    /** Fully releases controller resources. */
+    destroy(): void;
+}
+//# sourceMappingURL=PointerController.d.ts.map

package/dist/interaction/PointerController.d.ts.map

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