@yurialvesbordin/graphium 0.0.0-stage → 2.0.1

package/dist/Graphium.js

@@ -0,0 +1,413 @@
+/**
+ * Implements the main Graphium facade. The class wires the data model,
+ * physics engine, camera, renderer, label layer and pointer controller into
+ * one object, exposes a fluent chainable API with sensible defaults, and
+ * runs an on demand render loop that pauses completely while the simulation
+ * sleeps.
+ */
+import { Emitter } from './core/events.js';
+import { FocusController } from './core/FocusController.js';
+import { GraphEditor } from './core/GraphEditor.js';
+import { GraphModel } from './core/GraphModel.js';
+import { LinkHandle, NodeHandle } from './core/handles.js';
+import { SelectionController } from './core/SelectionController.js';
+import { resolveTheme } from './core/theme.js';
+import { BUILT_IN_THEMES } from './core/themes.js';
+import { InteractionBinder } from './interaction/InteractionBinder.js';
+import { PhysicsEngine } from './physics/PhysicsEngine.js';
+import { Camera } from './render/Camera.js';
+import { LabelLayer } from './render/LabelLayer.js';
+import { RenderLoop } from './render/RenderLoop.js';
+import { Renderer } from './render/Renderer.js';
+import { TextureAtlas } from './render/TextureAtlas.js';
+import { ViewportController } from './render/ViewportController.js';
+export class Graphium {
+    constructor(options = {}) {
+        this.events = new Emitter();
+        this.running = false;
+        this.destroyed = false;
+        this.options = options;
+        this.theme = resolveTheme(options.theme);
+        this.model = new GraphModel({
+            nodeCapacity: options.nodeCapacity,
+            linkCapacity: options.linkCapacity,
+            theme: this.theme,
+        });
+        this.physics = new PhysicsEngine(this.model, options.physics ?? {});
+        this.physics.hash.setCellSize(this.physics.options.repulsionRadius);
+        this.camera = new Camera(options.camera ?? {});
+        const canvas = options.canvas ?? (options.container ? createCanvasIn(options.container) : createCanvasIn(document.body));
+        this.renderer = new Renderer(canvas, this.theme, options.renderer ?? {});
+        this.renderer.setCamera(this.camera);
+        this.atlas = new TextureAtlas(this.renderer.gl);
+        this.renderer.setAtlas(this.atlas);
+        this.atlas.onEvent = event => {
+            this.events.emit(event.type, event);
+            this.invalidate();
+        };
+        const host = canvas.parentElement ?? document.body;
+        this.labels = new LabelLayer(host, this.theme);
+        this.labels.attach(this.model, this.camera);
+        this.loop = new RenderLoop({
+            model: this.model,
+            physics: this.physics,
+            camera: this.camera,
+            renderer: this.renderer,
+            labels: this.labels,
+            atlas: this.atlas,
+            isRunning: () => this.running,
+            isDestroyed: () => this.destroyed,
+            autoFit: options.autoFit ?? false,
+            fitView: () => this.fit(),
+        });
+        this.editor = new GraphEditor({
+            model: this.model,
+            physics: this.physics,
+            events: this.events,
+            resetAutoFit: () => this.loop.resetAutoFit(),
+            invalidate: () => this.invalidate(),
+        });
+        this.selection = new SelectionController(this.model, () => this.invalidate());
+        this.focusController = new FocusController(this.model, () => this.invalidate());
+        this.viewport = new ViewportController({
+            model: this.model,
+            camera: this.camera,
+            renderer: this.renderer,
+            invalidate: () => this.invalidate(),
+        });
+        this.binder = new InteractionBinder({
+            canvas,
+            model: this.model,
+            physics: this.physics,
+            camera: this.camera,
+            hash: this.physics.hash,
+            events: this.events,
+            interaction: options.interaction,
+            selection: this.selection,
+            invalidate: () => this.invalidate(),
+        });
+        this.resize();
+        if (typeof ResizeObserver !== 'undefined' && (options.autoResize ?? true)) {
+            new ResizeObserver(() => this.resize()).observe(canvas);
+        }
+        if (options.autoStart ?? true) {
+            this.start();
+        }
+    }
+    /** Creates a Graphium instance with the supplied configuration. */
+    static create(options = {}) {
+        return new Graphium(options);
+    }
+    /** Subscribes to an event and returns an unsubscribe function. */
+    on(type, listener) {
+        return this.events.on(type, listener);
+    }
+    /** Subscribes to an event exactly once. */
+    once(type, listener) {
+        return this.events.once(type, listener);
+    }
+    /** Removes one listener, or every listener of a type. */
+    off(type, listener) {
+        this.events.off(type, listener);
+        return this;
+    }
+    /** Dispatches an event payload to the registered listeners. */
+    emit(type, payload) {
+        this.events.emit(type, payload);
+        return this;
+    }
+    /** Adds one node and returns the graph for chaining. */
+    addNode(id, options = {}) {
+        this.editor.addNode(id, options);
+        return this;
+    }
+    /** Adds many nodes in one call and returns the graph for chaining. */
+    addNodes(nodes) {
+        this.editor.addNodes(nodes);
+        return this;
+    }
+    link(sourceOrId, target, options = {}) {
+        if (target === undefined) {
+            return this.linkById(sourceOrId);
+        }
+        this.editor.link(sourceOrId, target, options);
+        return this;
+    }
+    /** Adds many links in one call and returns the graph for chaining. */
+    addLinks(links) {
+        this.editor.addLinks(links);
+        return this;
+    }
+    /** Returns a fluent handle for one node, or null when it is missing. */
+    node(id) {
+        const index = this.model.nodeIndexOf(id);
+        return index < 0 ? null : new NodeHandle(this, this.model.nodeIdAt(index));
+    }
+    /** Returns a fluent handle for one link, or null when it is missing. */
+    linkById(id) {
+        const index = this.model.linkIndexOf(id);
+        return index < 0 ? null : new LinkHandle(this, this.model.linkIdAt(index));
+    }
+    /** Replaces the entire graph with the supplied data payload. */
+    setData(data) {
+        this.editor.setData(data);
+        return this;
+    }
+    /** Removes one node together with its links. */
+    removeNode(id) {
+        return this.editor.removeNode(id);
+    }
+    /** Removes one link by id. */
+    removeLink(id) {
+        return this.editor.removeLink(id);
+    }
+    /** Removes every node and link while keeping the current theme. */
+    clear() {
+        this.editor.clear();
+        return this;
+    }
+    /** Returns a snapshot of one node or null when it does not exist. */
+    getNode(id) {
+        const index = this.model.nodeIndexOf(id);
+        return index < 0 ? null : this.model.nodeSnapshot(index);
+    }
+    /** Returns a snapshot of one link or null when it does not exist. */
+    getLink(id) {
+        const index = this.model.linkIndexOf(id);
+        return index < 0 ? null : this.model.linkSnapshot(index);
+    }
+    /** Returns the ids of every node currently in the graph. */
+    nodeIds() {
+        const ids = [];
+        for (let index = 0; index < this.model.nodeCount; index++) {
+            ids.push(this.model.nodeIdAt(index));
+        }
+        return ids;
+    }
+    /** Returns the ids of every link currently in the graph. */
+    linkIds() {
+        const ids = [];
+        for (let index = 0; index < this.model.linkCount; index++) {
+            ids.push(this.model.linkIdAt(index));
+        }
+        return ids;
+    }
+    /** Sets the node image and starts the asynchronous load. */
+    setNodeImage(id, url, mode = 'cover') {
+        this.editor.setNodeImage(id, url, mode);
+        return this;
+    }
+    /** Selects one node, optionally keeping the current selection. */
+    selectNode(id, selected = true, additive = false) {
+        this.selection.selectNode(id, selected, additive);
+        return this;
+    }
+    /** Selects one link, optionally keeping the current selection. */
+    selectLink(id, selected = true, additive = false) {
+        this.selection.selectLink(id, selected, additive);
+        return this;
+    }
+    /** Clears the selection of every node and link. */
+    clearSelection() {
+        this.selection.clear();
+        return this;
+    }
+    /** Returns the ids of every selected node. */
+    selectedNodes() {
+        return this.selection.selectedNodes();
+    }
+    /** Returns the ids of every selected link. */
+    selectedLinks() {
+        return this.selection.selectedLinks();
+    }
+    /** Dims every node and link that is not adjacent to the focus node. */
+    focus(id) {
+        this.focusController.focus(id);
+        return this;
+    }
+    /** Removes all dimming applied by focus. */
+    unfocus() {
+        this.focusController.unfocus();
+        return this;
+    }
+    /** Merges theme values, optionally starting from a built in theme name. */
+    setTheme(theme) {
+        const base = theme.name && BUILT_IN_THEMES[theme.name] ? BUILT_IN_THEMES[theme.name] : this.options.theme ?? {};
+        const merged = { ...base, ...theme };
+        delete merged.name;
+        this.options.theme = merged;
+        this.theme = resolveTheme(merged, this.theme);
+        this.model.palette = this.theme.nodeColorPalette;
+        this.renderer.setTheme(this.theme);
+        this.labels.theme = this.theme;
+        this.labels.applyTheme();
+        this.labels.minZoom = this.theme.labelEnabled ? 0.3 : 2;
+        this.invalidate();
+        return this;
+    }
+    /** Updates physics options live and wakes the simulation. */
+    setPhysics(options) {
+        this.physics.setOptions(options);
+        this.physics.hash.setCellSize(this.physics.options.repulsionRadius);
+        return this;
+    }
+    /** Applies a named physics preset with optional overrides. */
+    usePreset(name, overrides = {}) {
+        this.physics.usePreset(name, overrides);
+        this.physics.hash.setCellSize(this.physics.options.repulsionRadius);
+        return this;
+    }
+    /** Updates interaction options on the live pointer controller. */
+    setInteraction(options) {
+        this.binder.setInteraction(options);
+        return this;
+    }
+    /** Restarts the simulation and returns the graph for chaining. */
+    reboot() {
+        this.physics.reset();
+        return this;
+    }
+    /** Scales the view so the whole graph fits with padding. */
+    fit(padding = 60) {
+        this.viewport.fit(padding);
+        return this;
+    }
+    /** Centers the view on a world point. */
+    centerOn(x, y) {
+        this.viewport.centerOn(x, y);
+        return this;
+    }
+    /** Multiplies the current zoom level. */
+    zoomBy(factor) {
+        this.viewport.zoomBy(factor);
+        return this;
+    }
+    /** Sets an absolute zoom level. */
+    zoomTo(zoom) {
+        this.viewport.zoomTo(zoom);
+        return this;
+    }
+    /** Resizes the renderer to the canvas client size. */
+    resize() {
+        this.viewport.resize();
+        return this;
+    }
+    /** Advances physics and renders once, returning the kinetic energy. */
+    step(dt = 1 / 60) {
+        return this.loop.step(dt);
+    }
+    /** Renders a frame immediately without stepping the simulation. */
+    render() {
+        this.loop.renderNow();
+        return this;
+    }
+    /** Requests a render on the next scheduled frame. */
+    requestRender() {
+        this.loop.requestRender();
+        return this;
+    }
+    /** Marks the view dirty and guarantees a scheduled frame. */
+    invalidate() {
+        this.loop.invalidate();
+    }
+    /** Starts the run loop and returns the graph for chaining. */
+    start() {
+        if (this.running || this.destroyed) {
+            return this;
+        }
+        this.running = true;
+        this.physics.wake();
+        this.events.emit('start', {});
+        this.loop.schedule();
+        return this;
+    }
+    /** Stops the run loop and returns the graph for chaining. */
+    stop() {
+        if (!this.running) {
+            return this;
+        }
+        this.running = false;
+        this.events.emit('stop', {});
+        return this;
+    }
+    /** Resolves when every requested node image finished loading. */
+    loadImages() {
+        return this.atlas.loadAll();
+    }
+    /** Finds the link index closest to a world position within a radius. */
+    pickLinkAt(worldX, worldY, hitRadius = 8) {
+        return this.binder.pickLinkAt(worldX, worldY, hitRadius);
+    }
+    /** Returns the world position under a screen position. */
+    screenToWorld(screenX, screenY) {
+        return this.viewport.screenToWorld(screenX, screenY);
+    }
+    /** Returns a performance statistics snapshot for dashboards. */
+    stats() {
+        return {
+            nodeCount: this.model.nodeCount,
+            linkCount: this.model.linkCount,
+            fps: Math.round(this.loop.fps),
+            frameMs: Math.round(this.loop.frameMs * 100) / 100,
+            physicsMs: Math.round(this.loop.physicsMs * 100) / 100,
+            renderMs: Math.round(this.renderer.lastRenderMs * 100) / 100,
+            sleeping: this.physics.sleeping,
+        };
+    }
+    /** Captures the current canvas contents as a PNG data URL. */
+    screenshot() {
+        this.loop.renderNow();
+        return this.renderer.canvas.toDataURL('image/png');
+    }
+    /** Exports the current graph as a plain JSON friendly object. */
+    toJSON() {
+        return this.editor.toJSON();
+    }
+    /** Releases every resource owned by the instance. */
+    destroy() {
+        if (this.destroyed) {
+            return;
+        }
+        this.destroyed = true;
+        this.running = false;
+        this.loop.cancel();
+        this.binder.destroy();
+        this.labels.destroy();
+        this.atlas.onEvent = null;
+        this.renderer.destroy();
+        this.events.clear();
+        this.model.clear();
+    }
+    /** Returns the number of nodes in the graph. */
+    get nodeCount() {
+        return this.model.nodeCount;
+    }
+    /** Returns the number of links in the graph. */
+    get linkCount() {
+        return this.model.linkCount;
+    }
+    /** Reports whether the physics simulation is currently asleep. */
+    get sleeping() {
+        return this.physics.sleeping;
+    }
+}
+/** Creates a canvas element appended to a host element. */
+function createCanvasIn(host) {
+    const canvas = document.createElement('canvas');
+    Object.assign(canvas.style, {
+        display: 'block',
+        width: '100%',
+        height: '100%',
+        position: 'absolute',
+        top: '0',
+        left: '0',
+        zIndex: '0',
+        touchAction: 'none',
+    });
+    if (host !== document.body) {
+        Object.assign(host.style, { position: 'relative' });
+    }
+    host.appendChild(canvas);
+    return canvas;
+}
+//# sourceMappingURL=Graphium.js.map

package/dist/Graphium.js.map

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

package/dist/core/FocusController.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Owns the focus mode: dims every node and link that is not adjacent to
+ * the focused node and restores the graph on unfocus.
+ */
+import { GraphModel } from './GraphModel.js';
+import type { NodeId } from './types.js';
+export declare class FocusController {
+    private readonly model;
+    private readonly invalidate;
+    constructor(model: GraphModel, invalidate: () => void);
+    /** Dims every node and link that is not adjacent to the focus node. */
+    focus(id: NodeId | number): void;
+    /** Removes all dimming applied by focus. */
+    unfocus(): void;
+}
+//# sourceMappingURL=FocusController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FocusController.d.ts","sourceRoot":"","sources":["../../src/core/FocusController.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAsB,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,MAAM,IAAI;IAGzC,uEAAuE;IACvE,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA2BhC,4CAA4C;IAC5C,OAAO,IAAI,IAAI;CAWhB"}

package/dist/core/FocusController.js

@@ -0,0 +1,53 @@
+/**
+ * Owns the focus mode: dims every node and link that is not adjacent to
+ * the focused node and restores the graph on unfocus.
+ */
+import { LINK_DIM, NODE_DIM } from './GraphModel.js';
+export class FocusController {
+    constructor(model, invalidate) {
+        this.model = model;
+        this.invalidate = invalidate;
+    }
+    /** Dims every node and link that is not adjacent to the focus node. */
+    focus(id) {
+        const index = this.model.nodeIndexOf(id);
+        if (index < 0) {
+            return;
+        }
+        const model = this.model;
+        const neighbors = new Set([index]);
+        for (let link = 0; link < model.linkCount; link++) {
+            const touches = model.source[link] === index || model.target[link] === index;
+            if (touches) {
+                neighbors.add(model.source[link]);
+                neighbors.add(model.target[link]);
+            }
+            else {
+                model.linkFlags[link] |= LINK_DIM;
+            }
+        }
+        for (let node = 0; node < model.nodeCount; node++) {
+            if (!neighbors.has(node)) {
+                model.flags[node] |= NODE_DIM;
+            }
+            else {
+                model.flags[node] &= ~NODE_DIM;
+            }
+        }
+        model.appearanceRevision++;
+        this.invalidate();
+    }
+    /** Removes all dimming applied by focus. */
+    unfocus() {
+        const model = this.model;
+        for (let node = 0; node < model.nodeCount; node++) {
+            model.flags[node] &= ~NODE_DIM;
+        }
+        for (let link = 0; link < model.linkCount; link++) {
+            model.linkFlags[link] &= ~LINK_DIM;
+        }
+        model.appearanceRevision++;
+        this.invalidate();
+    }
+}
+//# sourceMappingURL=FocusController.js.map

package/dist/core/FocusController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusController.js","sourceRoot":"","sources":["../../src/core/FocusController.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGjE,MAAM,OAAO,eAAe;IAC1B,YACmB,KAAiB,EACjB,UAAsB;QADtB,UAAK,GAAL,KAAK,CAAY;QACjB,eAAU,GAAV,UAAU,CAAY;IACtC,CAAC;IAEJ,uEAAuE;IACvE,KAAK,CAAC,EAAmB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC;YAC7E,IAAI,OAAO,EAAE,CAAC;gBACZ,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAClC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;YACpC,CAAC;QACH,CAAC;QACD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YAClD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YACjC,CAAC;QACH,CAAC;QACD,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,4CAA4C;IAC5C,OAAO;QACL,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YAClD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QACjC,CAAC;QACD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YAClD,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/core/GraphEditor.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Owns every graph data mutation: node and link CRUD, per element property
+ * updates, custom data attachment and JSON export.
+ */
+import type { Emitter } from './events.js';
+import { GraphModel } from './GraphModel.js';
+import type { PhysicsEngine } from '../physics/PhysicsEngine.js';
+import type { GraphData, LinkId, LinkOptions, NodeId, NodeOptions, NodeStateName } from './types.js';
+/** Collaborators and hooks the editor needs from the main facade. */
+export interface GraphEditorDeps {
+    model: GraphModel;
+    physics: PhysicsEngine;
+    events: Emitter;
+    resetAutoFit(): void;
+    invalidate(): void;
+}
+export declare class GraphEditor {
+    private readonly deps;
+    private linkCounter;
+    constructor(deps: GraphEditorDeps);
+    /** Adds one node. */
+    addNode(id: NodeId, options?: NodeOptions): void;
+    /** Adds many nodes in one call. */
+    addNodes(nodes: Array<NodeOptions & {
+        id: NodeId;
+    }>): void;
+    /** Links two nodes, reusing an existing link with the same auto id. */
+    link(source: NodeId, target: NodeId, options?: LinkOptions): void;
+    /** Adds many links in one call. */
+    addLinks(links: Array<LinkOptions & {
+        source: NodeId;
+        target: NodeId;
+    }>): void;
+    /** Replaces the entire graph with the supplied data payload. */
+    setData(data: GraphData): void;
+    /** Removes one node together with its links. */
+    removeNode(id: NodeId): boolean;
+    /** Removes one link by id. */
+    removeLink(id: LinkId): boolean;
+    /** Removes every node and link while keeping the current theme. */
+    clear(): void;
+    /** Moves a node to a world position. */
+    setNodePosition(id: NodeId | number, x: number, y: number): void;
+    /** Locks or unlocks a node in the solver. */
+    setNodeFixed(id: NodeId | number, fixed: boolean): void;
+    /** Assigns a visual state to a node. */
+    setNodeState(id: NodeId | number, state: NodeStateName): void;
+    /** Updates node appearance properties. */
+    setNodeAppearance(id: NodeId | number, options: NodeOptions): void;
+    /** Updates link appearance properties. */
+    setLinkAppearance(id: LinkId | number, options: LinkOptions): void;
+    /** Sets the node image and starts the asynchronous load. */
+    setNodeImage(id: NodeId | number, url: string | null, mode?: 'cover' | 'contain'): void;
+    /** Replaces the custom data object attached to a node. */
+    setNodeData(id: NodeId | number, data: Record<string, unknown>): void;
+    /** Replaces the custom data object attached to a link. */
+    setLinkData(id: LinkId | number, data: Record<string, unknown>): void;
+    /** Exports the current graph as a plain JSON friendly object. */
+    toJSON(): GraphData;
+}
+//# sourceMappingURL=GraphEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GraphEditor.d.ts","sourceRoot":"","sources":["../../src/core/GraphEditor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAErG,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,IAAI,IAAI,CAAC;IACrB,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,qBAAa,WAAW;IAGV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,WAAW,CAAK;gBAEK,IAAI,EAAE,eAAe;IAElD,qBAAqB;IACrB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI;IASpD,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAQ1D,uEAAuE;IACvE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI;IAOrE,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAU9E,gEAAgE;IAChE,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAQ9B,gDAAgD;IAChD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS/B,8BAA8B;IAC9B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS/B,mEAAmE;IACnE,KAAK,IAAI,IAAI;IAOb,wCAAwC;IACxC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAShE,6CAA6C;IAC7C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IASvD,wCAAwC;IACxC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAQ7D,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAQlE,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAQlE,4DAA4D;IAC5D,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,GAAE,OAAO,GAAG,SAAmB,GAAG,IAAI;IAQhG,0DAA0D;IAC1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWrE,0DAA0D;IAC1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWrE,iEAAiE;IACjE,MAAM,IAAI,SAAS;CAcpB"}