@deck.gl-community/graph-layers 9.2.0-beta.2 → 9.2.0-beta.3

package/dist/core/graph-engine.d.ts

@@ -1,28 +1,61 @@
 import type { Bounds2D } from '@math.gl/types';
-import type { Node } from '../graph/node';
-import { Edge } from '../graph/edge';
-import { Graph } from '../graph/graph';
-import { GraphLayout } from './graph-layout';
-export type GraphEngineProps = {
+import type { Graph, EdgeInterface, NodeInterface } from '../graph/graph';
+import { ClassicGraph } from '../graph/classic-graph';
+import { GraphLayout, type GraphLayoutEventDetail } from './graph-layout';
+import { GraphStylesheetEngine, type GraphStylesheet } from '../style/graph-style-engine';
+type ClassicGraphEngineProps = {
+    graph: ClassicGraph;
+    layout: GraphLayout;
+    onLayoutStart?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutChange?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutDone?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutError?: (error?: unknown) => void;
+    onTransactionStart?: () => void;
+    onTransactionEnd?: () => void;
+    onNodeAdded?: (node: NodeInterface) => void;
+    onNodeRemoved?: (node: NodeInterface) => void;
+    onNodeUpdated?: (node: NodeInterface) => void;
+    onEdgeAdded?: (edge: EdgeInterface) => void;
+    onEdgeRemoved?: (edge: EdgeInterface) => void;
+    onEdgeUpdated?: (edge: EdgeInterface) => void;
+};
+type InterfaceGraphEngineProps = {
     graph: Graph;
     layout: GraphLayout;
+    onLayoutStart?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutChange?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutDone?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutError?: (error?: unknown) => void;
+    onTransactionStart?: () => void;
+    onTransactionEnd?: () => void;
+    onNodeAdded?: (node: NodeInterface) => void;
+    onNodeRemoved?: (node: NodeInterface) => void;
+    onNodeUpdated?: (node: NodeInterface) => void;
+    onEdgeAdded?: (edge: EdgeInterface) => void;
+    onEdgeRemoved?: (edge: EdgeInterface) => void;
+    onEdgeUpdated?: (edge: EdgeInterface) => void;
 };
+export type GraphEngineProps = ClassicGraphEngineProps | InterfaceGraphEngineProps;
 /** Graph engine controls the graph data and layout calculation */
-export declare class GraphEngine extends EventTarget {
-    props: Readonly<Required<GraphEngineProps>>;
+export declare class GraphEngine {
+    private _props;
     private readonly _graph;
     private readonly _layout;
     private readonly _cache;
     private _layoutDirty;
     private _transactionInProgress;
+    private _graphCallbacksAttached;
+    private _layoutCallbacksAttached;
     constructor(props: GraphEngineProps);
     /** @deprecated Use props constructor: new GraphEngine(props) */
-    constructor(graph: Graph, layout: GraphLayout);
+    constructor(graph: ClassicGraph, layout: GraphLayout);
+    get props(): GraphEngineProps;
+    setProps(props: Partial<Omit<GraphEngineProps, 'graph' | 'layout'>>): void;
     /** Getters */
-    getNodes: () => Node[];
-    getEdges: () => Edge[];
-    getNodePosition: (node: Node) => [number, number];
-    getEdgePosition: (edge: Edge) => {
+    getNodes: () => NodeInterface[];
+    getEdges: () => EdgeInterface[];
+    getNodePosition: (node: NodeInterface) => [number, number];
+    getEdgePosition: (edge: EdgeInterface) => {
         type: string;
         sourcePosition: number[];
         targetPosition: number[];
@@ -33,33 +66,42 @@ export declare class GraphEngine extends EventTarget {
     getLayoutState: () => import("./graph-layout").GraphLayoutState;
     getLayoutBounds: () => Bounds2D | null;
     /** Operations on the graph */
-    lockNodePosition: (node: any, x: any, y: any) => void;
-    unlockNodePosition: (node: any) => void;
+    lockNodePosition: (node: NodeInterface, x: number, y: number) => void;
+    unlockNodePosition: (node: NodeInterface) => void;
+    findNode(nodeId: string | number): NodeInterface | undefined;
+    createStylesheetEngine(style: GraphStylesheet, options?: {
+        stateUpdateTrigger?: unknown;
+    }): GraphStylesheetEngine;
     /**
      * @fires GraphEngine#onLayoutStart
      */
-    _onLayoutStart: (event: Event) => void;
+    _onLayoutStart: (detail?: GraphLayoutEventDetail) => void;
     /**
      * @fires GraphEngine#onLayoutChange
      */
-    _onLayoutChange: (event: Event) => void;
+    _onLayoutChange: (detail?: GraphLayoutEventDetail) => void;
     /**
      * @fires GraphEngine#onLayoutDone
      */
-    _onLayoutDone: (event: Event) => void;
+    _onLayoutDone: (detail?: GraphLayoutEventDetail) => void;
     /**
      * @fires GraphEngine#onLayoutError
      */
-    _onLayoutError: (event: Event) => void;
-    _onGraphStructureChanged: (entity: any) => void;
+    _onLayoutError: (error?: unknown) => void;
+    _onGraphStructureChanged: () => void;
     _onTransactionStart: () => void;
     _onTransactionEnd: () => void;
     /** Layout calculations */
     run: () => void;
     clear: () => void;
-    resume: () => any;
-    stop: () => any;
+    resume: () => void;
+    stop: () => void;
     _graphChanged: () => void;
     _updateLayout: () => void;
     _updateCache(key: any, updateValue: any): void;
+    private _attachGraphCallbacks;
+    private _detachGraphCallbacks;
+    private _attachLayoutCallbacks;
+    private _detachLayoutCallbacks;
 }
+export {};

package/dist/core/graph-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-engine.d.ts","sourceRoot":"","sources":["../../src/core/graph-engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAC,IAAI,EAAC,yBAAsB;AACxC,OAAO,EAAC,IAAI,EAAC,yBAAsB;AACnC,OAAO,EAAC,KAAK,EAAC,0BAAuB;AACrC,OAAO,EAAC,WAAW,EAA8B,0BAAuB;AAIxE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,kEAAkE;AAClE,qBAAa,WAAY,SAAQ,WAAW;IAC1C,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAE5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;IAC1E,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,KAAK,EAAE,gBAAgB;IACnC,gEAAgE;gBACpD,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW;IAgB7C,cAAc;IAEd,QAAQ,QAAO,IAAI,EAAE,CAMnB;IAEF,QAAQ,QAK6B,IAAI,EAAE,CACzC;IAEF,eAAe,GAAI,MAAM,IAAI,sBAAwC;IAErE,eAAe,GAAI,MAAM,IAAI;;;;;MAAwC;IAErE,eAAe,eAA6B;IAE5C,mBAAmB,eAA8B;IAEjD,cAAc,kDAA4B;IAE1C,eAAe,QAAO,QAAQ,GAAG,IAAI,CAA6B;IAElE,8BAA8B;IAE9B,gBAAgB,GAAI,SAAI,EAAE,MAAC,EAAE,MAAC,UAA+C;IAE7E,kBAAkB,GAAI,SAAI,UAA2C;IAErE;;OAEG;IACH,cAAc,GAAI,OAAO,KAAK,UAQ5B;IAEF;;OAEG;IACH,eAAe,GAAI,OAAO,KAAK,UAQ7B;IAEF;;OAEG;IACH,aAAa,GAAI,OAAO,KAAK,UAQ3B;IAEF;;OAEG;IACH,cAAc,GAAI,OAAO,KAAK,UAO5B;IAEF,wBAAwB,GAAI,WAAM,UAGhC;IAEF,mBAAmB,aAEjB;IAEF,iBAAiB,aAGf;IAEF,0BAA0B;IAE1B,GAAG,aAkBD;IAEF,KAAK,aAaH;IAEF,MAAM,YAA+B;IAErC,IAAI,YAA6B;IAEjC,aAAa,aAIX;IAEF,aAAa,aAKX;IAEF,YAAY,CAAC,GAAG,KAAA,EAAE,WAAW,KAAA;CAG9B"}
+{"version":3,"file":"graph-engine.d.ts","sourceRoot":"","sources":["../../src/core/graph-engine.ts"],"names":[],"mappings":"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"}

package/dist/core/graph-engine.js

@@ -1,137 +1,145 @@
 // deck.gl-community
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
-import { Graph } from '../graph/graph';
+import { ClassicGraph } from '../graph/classic-graph';
+import { GraphLayout } from './graph-layout';
 import { Cache } from './cache';
 import { log } from '../utils/log';
+import { GraphStylesheetEngine } from '../style/graph-style-engine';
 /** Graph engine controls the graph data and layout calculation */
-export class GraphEngine extends EventTarget {
-    props;
+export class GraphEngine {
+    _props;
     _graph;
     _layout;
     _cache = new Cache();
     _layoutDirty = false;
     _transactionInProgress = false;
+    _graphCallbacksAttached = false;
+    _layoutCallbacksAttached = false;
     constructor(props, layout) {
-        super();
-        if (props instanceof Graph) {
-            props = {
-                graph: props,
-                layout
-            };
+        let normalizedProps;
+        if (props instanceof ClassicGraph) {
+            if (!(layout instanceof GraphLayout)) {
+                throw new Error('GraphEngine: legacy graphs require a GraphLayout instance.');
+            }
+            normalizedProps = { graph: props, layout };
         }
-        this.props = props;
-        this._graph = props.graph;
-        this._layout = props.layout;
+        else {
+            normalizedProps = props;
+        }
+        this._props = { ...normalizedProps };
+        this._graph = normalizedProps.graph;
+        this._layout = normalizedProps.layout;
+    }
+    get props() {
+        return { ...this._props };
+    }
+    setProps(props) {
+        this._props = {
+            ...this._props,
+            ...props,
+            graph: this._props.graph,
+            layout: this._props.layout
+        };
     }
     /** Getters */
     getNodes = () => {
-        this._updateCache('nodes', () => this._graph.getNodes().filter((node) => this.getNodePosition(node)));
-        return this._cache.get('nodes');
+        this._updateCache('nodes', () => Array.from(this._graph.getNodes()).filter((node) => {
+            const position = this.getNodePosition(node);
+            return position !== null && position !== undefined;
+        }));
+        return this._cache.get('nodes') ?? [];
     };
     getEdges = () => {
-        this._updateCache('edges', () => this._graph.getEdges().filter((edge) => this.getEdgePosition(edge)));
-        return this._cache.get('edges');
+        this._updateCache('edges', () => Array.from(this._graph.getEdges()).filter((edge) => {
+            const layout = this.getEdgePosition(edge);
+            return layout !== null && layout !== undefined;
+        }));
+        return this._cache.get('edges') ?? [];
+    };
+    getNodePosition = (node) => {
+        return this._layout.getNodePosition(node) ?? null;
+    };
+    getEdgePosition = (edge) => {
+        return this._layout.getEdgePosition(edge) ?? null;
     };
-    getNodePosition = (node) => this._layout.getNodePosition(node);
-    getEdgePosition = (edge) => this._layout.getEdgePosition(edge);
     getGraphVersion = () => this._graph.version;
     getLayoutLastUpdate = () => this._layout.version;
     getLayoutState = () => this._layout.state;
-    getLayoutBounds = () => this._layout.getBounds();
+    getLayoutBounds = () => this._layout.getBounds() ?? null;
     /** Operations on the graph */
-    lockNodePosition = (node, x, y) => this._layout.lockNodePosition(node, x, y);
-    unlockNodePosition = (node) => this._layout.unlockNodePosition(node);
+    lockNodePosition = (node, x, y) => {
+        this._layout.lockNodePosition(node, x, y);
+    };
+    unlockNodePosition = (node) => {
+        this._layout.unlockNodePosition(node);
+    };
+    findNode(nodeId) {
+        return this._graph.findNode?.(nodeId) ?? this._graph.findNodeById?.(nodeId);
+    }
+    createStylesheetEngine(style, options = {}) {
+        return new GraphStylesheetEngine(style, options);
+    }
     /**
      * @fires GraphEngine#onLayoutStart
      */
-    _onLayoutStart = (event) => {
+    _onLayoutStart = (detail) => {
         log.log(0, 'GraphEngine: layout start')();
-        const detail = event instanceof CustomEvent ? event.detail : undefined;
-        /**
-         * @event GraphEngine#onLayoutStart
-         * @type {CustomEvent}
-         */
-        this.dispatchEvent(new CustomEvent('onLayoutStart', { detail }));
+        this._props.onLayoutStart?.(detail);
     };
     /**
      * @fires GraphEngine#onLayoutChange
      */
-    _onLayoutChange = (event) => {
+    _onLayoutChange = (detail) => {
         log.log(0, 'GraphEngine: layout update event')();
-        const detail = event instanceof CustomEvent ? event.detail : undefined;
-        /**
-         * @event GraphEngine#onLayoutChange
-         * @type {CustomEvent}
-         */
-        this.dispatchEvent(new CustomEvent('onLayoutChange', { detail }));
+        this._props.onLayoutChange?.(detail);
     };
     /**
      * @fires GraphEngine#onLayoutDone
      */
-    _onLayoutDone = (event) => {
+    _onLayoutDone = (detail) => {
         log.log(0, 'GraphEngine: layout end')();
-        const detail = event instanceof CustomEvent ? event.detail : undefined;
-        /**
-         * @event GraphEngine#onLayoutDone
-         * @type {CustomEvent}
-         */
-        this.dispatchEvent(new CustomEvent('onLayoutDone', { detail }));
+        this._props.onLayoutDone?.(detail);
     };
     /**
      * @fires GraphEngine#onLayoutError
      */
-    _onLayoutError = (event) => {
-        const detail = event instanceof CustomEvent ? event.detail : undefined;
-        /**
-         * @event GraphEngine#onLayoutError
-         * @type {CustomEvent}
-         */
-        this.dispatchEvent(new CustomEvent('onLayoutError', { detail }));
-    };
-    _onGraphStructureChanged = (entity) => {
+    _onLayoutError = (error) => {
+        this._props.onLayoutError?.(error);
+    };
+    _onGraphStructureChanged = () => {
         this._layoutDirty = true;
         this._graphChanged();
     };
     _onTransactionStart = () => {
         this._transactionInProgress = true;
+        this._props.onTransactionStart?.();
     };
     _onTransactionEnd = () => {
         this._transactionInProgress = false;
         this._graphChanged();
+        this._props.onTransactionEnd?.();
     };
     /** Layout calculations */
     run = () => {
         log.log(1, 'GraphEngine: run');
         // TODO: throw if running on a cleared engine
-        this._graph.addEventListener('transactionStart', this._onTransactionStart);
-        this._graph.addEventListener('transactionEnd', this._onTransactionEnd);
-        this._graph.addEventListener('onNodeAdded', this._onGraphStructureChanged);
-        this._graph.addEventListener('onNodeRemoved', this._onGraphStructureChanged);
-        this._graph.addEventListener('onEdgeAdded', this._onGraphStructureChanged);
-        this._graph.addEventListener('onEdgeRemoved', this._onGraphStructureChanged);
-        this._layout.addEventListener('onLayoutStart', this._onLayoutStart);
-        this._layout.addEventListener('onLayoutChange', this._onLayoutChange);
-        this._layout.addEventListener('onLayoutDone', this._onLayoutDone);
-        this._layout.addEventListener('onLayoutError', this._onLayoutError);
+        this._attachGraphCallbacks();
+        this._attachLayoutCallbacks();
         this._layout.initializeGraph(this._graph);
         this._layout.start();
     };
     clear = () => {
         log.log(1, 'GraphEngine: end');
-        this._graph.removeEventListener('transactionStart', this._onTransactionStart);
-        this._graph.removeEventListener('transactionEnd', this._onTransactionEnd);
-        this._graph.removeEventListener('onNodeAdded', this._onGraphStructureChanged);
-        this._graph.removeEventListener('onNodeRemoved', this._onGraphStructureChanged);
-        this._graph.removeEventListener('onEdgeAdded', this._onGraphStructureChanged);
-        this._graph.removeEventListener('onEdgeRemoved', this._onGraphStructureChanged);
-        this._layout.removeEventListener('onLayoutStart', this._onLayoutStart);
-        this._layout.removeEventListener('onLayoutChange', this._onLayoutChange);
-        this._layout.removeEventListener('onLayoutDone', this._onLayoutDone);
-        this._layout.removeEventListener('onLayoutError', this._onLayoutError);
-    };
-    resume = () => this._layout.resume();
-    stop = () => this._layout.stop();
+        this._detachGraphCallbacks();
+        this._detachLayoutCallbacks();
+    };
+    resume = () => {
+        this._layout.resume();
+    };
+    stop = () => {
+        this._layout.stop();
+    };
     _graphChanged = () => {
         if (this._layoutDirty && !this._transactionInProgress) {
             this._updateLayout();
@@ -144,6 +152,78 @@ export class GraphEngine extends EventTarget {
         this._layoutDirty = false;
     };
     _updateCache(key, updateValue) {
-        this._cache.set(key, updateValue, this._graph.version + this._layout.version);
+        this._cache.set(key, updateValue, this.getGraphVersion() + this.getLayoutLastUpdate());
+    }
+    _attachGraphCallbacks() {
+        if (this._graphCallbacksAttached) {
+            return;
+        }
+        this._graph.updateProps({
+            onTransactionStart: this._onTransactionStart,
+            onTransactionEnd: this._onTransactionEnd,
+            onNodeAdded: (node) => {
+                this._onGraphStructureChanged();
+                this._props.onNodeAdded?.(node);
+            },
+            onNodeRemoved: (node) => {
+                this._onGraphStructureChanged();
+                this._props.onNodeRemoved?.(node);
+            },
+            onNodeUpdated: (node) => {
+                this._props.onNodeUpdated?.(node);
+            },
+            onEdgeAdded: (edge) => {
+                this._onGraphStructureChanged();
+                this._props.onEdgeAdded?.(edge);
+            },
+            onEdgeRemoved: (edge) => {
+                this._onGraphStructureChanged();
+                this._props.onEdgeRemoved?.(edge);
+            },
+            onEdgeUpdated: (edge) => {
+                this._props.onEdgeUpdated?.(edge);
+            }
+        });
+        this._graphCallbacksAttached = true;
+    }
+    _detachGraphCallbacks() {
+        if (!this._graphCallbacksAttached) {
+            return;
+        }
+        this._graph.updateProps({
+            onTransactionStart: undefined,
+            onTransactionEnd: undefined,
+            onNodeAdded: undefined,
+            onNodeRemoved: undefined,
+            onNodeUpdated: undefined,
+            onEdgeAdded: undefined,
+            onEdgeRemoved: undefined,
+            onEdgeUpdated: undefined
+        });
+        this._graphCallbacksAttached = false;
+    }
+    _attachLayoutCallbacks() {
+        if (this._layoutCallbacksAttached) {
+            return;
+        }
+        this._layout.setProps({
+            onLayoutStart: this._onLayoutStart,
+            onLayoutChange: this._onLayoutChange,
+            onLayoutDone: this._onLayoutDone,
+            onLayoutError: this._onLayoutError
+        });
+        this._layoutCallbacksAttached = true;
+    }
+    _detachLayoutCallbacks() {
+        if (!this._layoutCallbacksAttached) {
+            return;
+        }
+        this._layout.setProps({
+            onLayoutStart: undefined,
+            onLayoutChange: undefined,
+            onLayoutDone: undefined,
+            onLayoutError: undefined
+        });
+        this._layoutCallbacksAttached = false;
     }
 }

package/dist/core/graph-engine.js.map

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

package/dist/core/graph-layout.d.ts

@@ -1,18 +1,20 @@
 import type { Bounds2D } from '@math.gl/types';
-import type { Graph } from '../graph/graph';
-import type { Node } from '../graph/node';
-import type { Edge } from '../graph/edge';
+import type { Graph, NodeInterface, EdgeInterface } from '../graph/graph';
 export type GraphLayoutState = 'init' | 'start' | 'calculating' | 'done' | 'error';
 export type GraphLayoutEventDetail = {
     bounds: Bounds2D | null;
 };
-export type GraphLayoutProps = {};
-/** All the layout classes are extended from this base layout class. */
-export declare abstract class GraphLayout<OptionsT extends GraphLayoutProps = GraphLayoutProps> extends EventTarget {
-    /** Name of the layout. */
-    protected readonly _name: string;
-    /** Extra configuration options of the layout. */
-    protected _options: OptionsT;
+export type GraphLayoutProps = {
+    onLayoutStart?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutChange?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutDone?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutError?: (error?: unknown) => void;
+};
+export declare abstract class GraphLayout<PropsT extends GraphLayoutProps = GraphLayoutProps> {
+    static defaultProps: Readonly<Required<GraphLayoutProps>>;
+    get [Symbol.toStringTag](): string;
+    /** Extra configuration props of the layout. */
+    protected props: Required<PropsT>;
     /**
      * Last computed layout bounds in local layout coordinates.
      *
@@ -24,9 +26,11 @@ export declare abstract class GraphLayout<OptionsT extends GraphLayoutProps = Gr
     state: GraphLayoutState;
     /**
      * Constructor of GraphLayout
-     * @param options extra configuration options of the layout
+     * @param props extra configuration props of the layout
      */
-    constructor(options: OptionsT);
+    constructor(props: PropsT, defaultProps?: Required<PropsT>);
+    getProps(): PropsT;
+    setProps(props: Partial<PropsT>): void;
     /**
      * Check the equality of two layouts
      * @param layout - The layout to be compared.
@@ -34,9 +38,9 @@ export declare abstract class GraphLayout<OptionsT extends GraphLayoutProps = Gr
      */
     equals(layout: GraphLayout): boolean;
     /** access the position of the node in the layout */
-    getNodePosition(node: Node): [number, number];
+    getNodePosition(node: NodeInterface): [number, number];
     /** access the layout information of the edge */
-    getEdgePosition(edge: Edge): {
+    getEdgePosition(edge: EdgeInterface): {
         type: string;
         sourcePosition: number[];
         targetPosition: number[];
@@ -48,19 +52,19 @@ export declare abstract class GraphLayout<OptionsT extends GraphLayoutProps = Gr
      * @param  x    x coordinate
      * @param  y    y coordinate
      */
-    lockNodePosition(node: Node, x: number, y: number): void;
+    lockNodePosition(node: NodeInterface, x: number, y: number): void;
     /**
      * Unlock the node, the node will be able to move freely.
      * @param  {Object} node Node to be unlocked
      */
-    unlockNodePosition(node: Node): void;
+    unlockNodePosition(node: NodeInterface): void;
     /** Returns the last computed layout bounds, if available. */
     getBounds(): Bounds2D | null;
     /** virtual functions: will be implemented in the child class */
     /** first time to pass the graph data into this layout */
-    abstract initializeGraph(graph: Graph): any;
+    abstract initializeGraph(graph: Graph): void;
     /** update the existing graph */
-    abstract updateGraph(graph: Graph): any;
+    abstract updateGraph(graph: Graph): void;
     /** start the layout calculation */
     abstract start(): any;
     /** update the layout calculation */

package/dist/core/graph-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-layout.d.ts","sourceRoot":"","sources":["../../src/core/graph-layout.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAC,KAAK,EAAC,0BAAuB;AAC1C,OAAO,KAAK,EAAC,IAAI,EAAC,yBAAsB;AACxC,OAAO,KAAK,EAAC,IAAI,EAAC,yBAAsB;AAMxC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAElC,uEAAuE;AACvE,8BAAsB,WAAW,CAC/B,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB,CACpD,SAAQ,WAAW;IACnB,0BAA0B;IAC1B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAiB;IACjD,iDAAiD;IACjD,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE7B;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAEnC,OAAO,SAAK;IACZ,KAAK,EAAE,gBAAgB,CAAU;IAExC;;;OAGG;gBACS,OAAO,EAAE,QAAQ;IAK7B;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IASpC,oDAAoD;IACpD,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAI7C,gDAAgD;IAChD,eAAe,CAAC,IAAI,EAAE,IAAI;;;;;;IAS1B;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAEjD;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,IAAI;IAE7B,6DAA6D;IAC7D,SAAS,IAAI,QAAQ,GAAG,IAAI;IAI1B,gEAAgE;IAElE,yDAAyD;IACzD,QAAQ,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK;IACrC,gCAAgC;IAChC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK;IACjC,mCAAmC;IACnC,QAAQ,CAAC,KAAK;IACd,oCAAoC;IACpC,QAAQ,CAAC,MAAM;IACf,oCAAoC;IACpC,QAAQ,CAAC,MAAM;IACf,kCAAkC;IAClC,QAAQ,CAAC,IAAI;IAKb,qEAAqE;IAErE,SAAS,CAAC,aAAa,IAAI,IAAI;IAE/B;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CACxB,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GACjE,QAAQ,GAAG,IAAI;IAiClB;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAmBrE,OAAO,CAAC,eAAe;IAIvB,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,gBAAgB;IAK9C,uCAAuC;IACvC,SAAS,CAAC,cAAc,QAAO,IAAI,CAYjC;IAEF,wCAAwC;IACxC,SAAS,CAAC,eAAe,QAAO,IAAI,CAYlC;IAEF,sCAAsC;IACtC,SAAS,CAAC,aAAa,QAAO,IAAI,CAYhC;IAEF,uCAAuC;IACvC,SAAS,CAAC,cAAc,QAAO,IAAI,CASjC;CACH"}
+{"version":3,"file":"graph-layout.d.ts","sourceRoot":"","sources":["../../src/core/graph-layout.ts"],"names":[],"mappings":"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"}