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

package/dist/layers/edge-layers/edge-arrow-layer.js

@@ -0,0 +1,131 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { CompositeLayer } from '@deck.gl/core';
+import { SimpleMeshLayer } from '@deck.gl/mesh-layers';
+import { Arrow2DGeometry } from './arrow-2d-geometry';
+const DEFAULT_ARROW_GEOMETRY = new Arrow2DGeometry({ length: 1, headWidth: 0.6 });
+const DEFAULT_Z = 0;
+function resolveSize(value) {
+    const numeric = Number(value);
+    return Number.isFinite(numeric) && numeric !== 0 ? numeric : 1;
+}
+function getOffsetComponents(offset) {
+    if (!Array.isArray(offset)) {
+        return { along: 0, perpendicular: 0 };
+    }
+    const along = Number(offset[0]);
+    const perpendicular = Number(offset[1]);
+    return {
+        along: Number.isFinite(along) ? along : 0,
+        perpendicular: Number.isFinite(perpendicular) ? perpendicular : 0
+    };
+}
+export function isEdgeDirected(edge) {
+    if (!edge) {
+        return false;
+    }
+    if (typeof edge.isDirected === 'function') {
+        return Boolean(edge.isDirected());
+    }
+    if (typeof edge.directed === 'boolean') {
+        return edge.directed;
+    }
+    return false;
+}
+function normalizeVector(vector) {
+    const length = Math.hypot(vector[0] ?? 0, vector[1] ?? 0, vector[2] ?? 0);
+    if (length === 0) {
+        return [0, 0, 0];
+    }
+    return [(vector[0] ?? 0) / length, (vector[1] ?? 0) / length, (vector[2] ?? 0) / length];
+}
+function getTerminalDirection({ sourcePosition, targetPosition, controlPoints = [] }) {
+    const anchor = controlPoints.length ? controlPoints[controlPoints.length - 1] : sourcePosition;
+    const direction = [
+        (targetPosition[0] ?? 0) - (anchor?.[0] ?? 0),
+        (targetPosition[1] ?? 0) - (anchor?.[1] ?? 0),
+        (targetPosition[2] ?? DEFAULT_Z) - (anchor?.[2] ?? DEFAULT_Z)
+    ];
+    return { target: targetPosition, direction };
+}
+export function getArrowTransform({ layout, size, offset = null }) {
+    const { target, direction } = getTerminalDirection(layout);
+    const unit = normalizeVector(direction);
+    const hasDirection = unit[0] !== 0 || unit[1] !== 0 || unit[2] !== 0;
+    const resolvedSize = resolveSize(size);
+    const basePosition = [
+        target[0] ?? 0,
+        target[1] ?? 0,
+        target[2] ?? DEFAULT_Z
+    ];
+    if (!hasDirection) {
+        return { position: basePosition, angle: 0 };
+    }
+    const { along, perpendicular } = getOffsetComponents(offset);
+    const alongDistance = resolvedSize * 0.5 + along;
+    const position = [
+        basePosition[0] - unit[0] * alongDistance,
+        basePosition[1] - unit[1] * alongDistance,
+        basePosition[2] - unit[2] * alongDistance
+    ];
+    if (perpendicular) {
+        const perp = [-unit[1], unit[0], 0];
+        position[0] += perp[0] * perpendicular;
+        position[1] += perp[1] * perpendicular;
+        position[2] += perp[2] * perpendicular;
+    }
+    const angle = (Math.atan2(unit[0], unit[1]) * 180) / Math.PI;
+    return { position, angle };
+}
+export class EdgeArrowLayer extends CompositeLayer {
+    static layerName = 'EdgeArrowLayer';
+    renderLayers() {
+        const { data, getLayoutInfo, positionUpdateTrigger = 0, stylesheet } = this.props;
+        const directedEdges = (data || []).filter(isEdgeDirected);
+        if (!directedEdges.length) {
+            return [];
+        }
+        const { getColor, getSize, getOffset } = stylesheet.getDeckGLAccessors();
+        const updateTriggers = stylesheet.getDeckGLUpdateTriggers();
+        return [
+            new SimpleMeshLayer(this.getSubLayerProps({
+                id: '__edge-arrow-layer',
+                data: directedEdges,
+                mesh: DEFAULT_ARROW_GEOMETRY,
+                getColor,
+                getScale: (edge) => {
+                    const size = resolveSize(getSize(edge));
+                    return [size, size, size];
+                },
+                getOrientation: (edge) => {
+                    const layout = getLayoutInfo(edge);
+                    const size = resolveSize(getSize(edge));
+                    const offset = getOffset ? getOffset(edge) : null;
+                    const { angle } = getArrowTransform({ layout, size, offset });
+                    return [0, -angle, 0];
+                },
+                getPosition: (edge) => {
+                    const layout = getLayoutInfo(edge);
+                    const size = resolveSize(getSize(edge));
+                    const offset = getOffset ? getOffset(edge) : null;
+                    const { position } = getArrowTransform({ layout, size, offset });
+                    return position;
+                },
+                parameters: {
+                    depthTest: false
+                },
+                updateTriggers: {
+                    getColor: updateTriggers.getColor,
+                    getScale: updateTriggers.getSize,
+                    getOrientation: [
+                        positionUpdateTrigger,
+                        updateTriggers.getSize,
+                        updateTriggers.getOffset
+                    ],
+                    getPosition: [positionUpdateTrigger, updateTriggers.getSize, updateTriggers.getOffset]
+                }
+            }))
+        ];
+    }
+}

package/dist/layers/edge-layers/edge-arrow-layer.js.map

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

package/dist/layers/edge-layers/edge-label-layer.d.ts

@@ -1,7 +1,6 @@
 import { CompositeLayer } from '@deck.gl/core';
-import { ZoomableTextLayer } from "../common-layers/zoomable-text-layer/zoomable-text-layer.js";
+import { ZoomableTextLayer } from '../common-layers/zoomable-text-layer/zoomable-text-layer';
 export declare class EdgeLabelLayer extends CompositeLayer {
     static layerName: string;
     renderLayers(): ZoomableTextLayer[];
 }
-//# sourceMappingURL=edge-label-layer.d.ts.map

package/dist/layers/edge-layers/edge-label-layer.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 import { CompositeLayer } from '@deck.gl/core';
-import { ZoomableTextLayer } from "../common-layers/zoomable-text-layer/zoomable-text-layer.js";
+import { ZoomableTextLayer } from '../common-layers/zoomable-text-layer/zoomable-text-layer';
 export class EdgeLabelLayer extends CompositeLayer {
     static layerName = 'EdgeLabelLayer';
     renderLayers() {
@@ -40,4 +40,3 @@ export class EdgeLabelLayer extends CompositeLayer {
         ];
     }
 }
-//# sourceMappingURL=edge-label-layer.js.map

package/dist/layers/edge-layers/flow-layer.d.ts

@@ -1,7 +1,6 @@
 import { CompositeLayer } from '@deck.gl/core';
-import { FlowPathLayer } from "../common-layers/flow-path-layer/flow-path-layer.js";
+import { FlowPathLayer } from '../common-layers/flow-path-layer/flow-path-layer';
 export declare class FlowLayer extends CompositeLayer {
     static layerName: string;
     renderLayers(): FlowPathLayer[];
 }
-//# sourceMappingURL=flow-layer.d.ts.map

package/dist/layers/edge-layers/flow-layer.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 import { CompositeLayer } from '@deck.gl/core';
-import { FlowPathLayer } from "../common-layers/flow-path-layer/flow-path-layer.js";
+import { FlowPathLayer } from '../common-layers/flow-path-layer/flow-path-layer';
 export class FlowLayer extends CompositeLayer {
     static layerName = 'FlowLayer';
     renderLayers() {
@@ -26,4 +26,3 @@ export class FlowLayer extends CompositeLayer {
         ];
     }
 }
-//# sourceMappingURL=flow-layer.js.map

package/dist/layers/edge-layers/path-edge-layer.d.ts

@@ -4,4 +4,3 @@ export declare class PathEdgeLayer extends CompositeLayer {
     static layerName: string;
     renderLayers(): PathLayer<any, {}>[];
 }
-//# sourceMappingURL=path-edge-layer.d.ts.map

package/dist/layers/edge-layers/path-edge-layer.js

@@ -25,4 +25,3 @@ export class PathEdgeLayer extends CompositeLayer {
         ];
     }
 }
-//# sourceMappingURL=path-edge-layer.js.map

package/dist/layers/edge-layers/straight-line-edge-layer.d.ts

@@ -4,4 +4,3 @@ export declare class StraightLineEdgeLayer extends CompositeLayer {
     static layerName: string;
     renderLayers(): LineLayer<any, {}>[];
 }
-//# sourceMappingURL=straight-line-edge-layer.d.ts.map

package/dist/layers/edge-layers/straight-line-edge-layer.js

@@ -24,4 +24,3 @@ export class StraightLineEdgeLayer extends CompositeLayer {
         ];
     }
 }
-//# sourceMappingURL=straight-line-edge-layer.js.map

package/dist/layers/graph-layer.d.ts

@@ -1,32 +1,50 @@
 import type { CompositeLayerProps } from '@deck.gl/core';
 import { CompositeLayer } from '@deck.gl/core';
-import { Graph } from "../graph/graph.js";
-import { GraphLayout } from "../core/graph-layout.js";
-import { GraphEngine } from "../core/graph-engine.js";
-import { InteractionManager } from "../core/interaction-manager.js";
-import { CircleLayer } from "./node-layers/circle-layer.js";
-import { ImageLayer } from "./node-layers/image-layer.js";
-import { LabelLayer } from "./node-layers/label-layer.js";
-import { RectangleLayer } from "./node-layers/rectangle-layer.js";
-import { ZoomableMarkerLayer } from "./node-layers/zoomable-marker-layer.js";
-import { EdgeLayer } from "./edge-layer.js";
-import { EdgeLabelLayer } from "./edge-layers/edge-label-layer.js";
-import { FlowLayer } from "./edge-layers/flow-layer.js";
-export type GraphLayerProps = CompositeLayerProps & _GraphLayerProps;
+import type { Graph } from '../graph/graph';
+import { GraphLayout, type GraphLayoutEventDetail } from '../core/graph-layout';
+import { GraphEngine } from '../core/graph-engine';
+import { type GraphLayerEdgeStyle, type GraphLayerNodeStyle, type GraphLayerStylesheet } from '../style/graph-layer-stylesheet';
+import { EdgeLayer } from './edge-layer';
+import { EdgeLabelLayer } from './edge-layers/edge-label-layer';
+import { FlowLayer } from './edge-layers/flow-layer';
+import { EdgeArrowLayer } from './edge-layers/edge-arrow-layer';
+import { type GridLayerProps } from './common-layers/grid-layer/grid-layer';
+import { InteractionManager } from '../core/interaction-manager';
+import { type LabelAccessor, type RankAccessor } from '../utils/rank-grid';
+type GridLayerOverrides = Partial<Omit<GridLayerProps, 'id' | 'data' | 'direction'>>;
+export type RankGridConfig = {
+    enabled?: boolean;
+    direction?: 'horizontal' | 'vertical';
+    maxLines?: number;
+    rankAccessor?: RankAccessor;
+    labelAccessor?: LabelAccessor;
+    gridProps?: GridLayerOverrides;
+};
+export type GraphLayerRawData = {
+    name?: string;
+    nodes?: unknown[] | null;
+    edges?: unknown[] | null;
+};
+export type GraphLayerDataInput = GraphEngine | Graph | GraphLayerRawData | unknown[] | string | null;
+export type GraphLayerProps = CompositeLayerProps & _GraphLayerProps & {
+    data?: GraphLayerDataInput | Promise<GraphLayerDataInput>;
+};
 export type _GraphLayerProps = {
     graph?: Graph;
     layout?: GraphLayout;
     graphLoader?: (opts: {
-        json: any;
-    }) => Graph;
+        json: unknown;
+    }) => Graph | null;
     engine?: GraphEngine;
-    nodeStyle?: any[];
-    edgeStyle?: {
-        stroke?: string;
-        strokeWidth?: number;
-        /** an array of styles for layers */
-        decorators?: any[];
-    };
+    onLayoutStart?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutChange?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutDone?: (detail?: GraphLayoutEventDetail) => void;
+    onLayoutError?: (error?: unknown) => void;
+    stylesheet?: GraphLayerStylesheet;
+    /** @deprecated Use `stylesheet.nodes`. */
+    nodeStyle?: GraphLayerNodeStyle[];
+    /** @deprecated Use `stylesheet.edges`. */
+    edgeStyle?: GraphLayerEdgeStyle | GraphLayerEdgeStyle[];
     nodeEvents?: {
         onMouseLeave?: () => void;
         onHover?: () => void;
@@ -39,14 +57,28 @@ export type _GraphLayerProps = {
         onHover: () => void;
     };
     enableDragging?: boolean;
+    rankGrid?: boolean | RankGridConfig;
+    resumeLayoutAfterDragging?: boolean;
 };
+/** Composite layer that renders graph nodes, edges, and decorators. */
 export declare class GraphLayer extends CompositeLayer<GraphLayerProps> {
     static layerName: string;
-    static defaultProps: Required<_GraphLayerProps>;
+    static defaultProps: Required<_GraphLayerProps> & {
+        data: {
+            type: string;
+            value: null;
+            async: true;
+        };
+    };
     state: CompositeLayer<GraphLayerProps>['state'] & {
         interactionManager: InteractionManager;
-        graphEngine?: GraphEngine;
+        graphEngine?: GraphEngine | null;
+        layoutVersion: number;
+        layoutState?: string;
+        interactionVersion: number;
     };
+    private readonly _edgeAttachmentHelper;
+    private _suppressNextDeckDataChange;
     forceUpdate: () => void;
     constructor(props: GraphLayerProps & CompositeLayerProps);
     initializeState(): void;
@@ -59,15 +91,39 @@ export declare class GraphLayer extends CompositeLayer<GraphLayerProps> {
         changeFlags: any;
     }): void;
     finalize(): void;
-    _setGraphEngine(graphEngine: GraphEngine): void;
+    private _getResolvedStylesheet;
+    private _createStylesheetEngine;
+    private _refreshEngineFromProps;
+    private _resolveEngineCandidate;
+    private _getEngineFromData;
+    private _getEngineFromEngineProp;
+    private _getEngineFromGraphProp;
+    private _deriveEngineFromData;
+    private _buildEngineFromGraph;
+    private _syncInteractionManager;
+    private _warnGraphProp;
+    private _warnLayoutRequired;
+    private _isGraph;
+    private _coerceGraph;
+    private _convertToClassicGraph;
+    private _updateLayoutSnapshot;
+    private _handleLayoutEvent;
+    _setGraphEngine(graphEngine: GraphEngine | null): void;
     _removeGraphEngine(): void;
-    createNodeLayers(): (CircleLayer | ImageLayer | LabelLayer | RectangleLayer | ZoomableMarkerLayer)[];
-    createEdgeLayers(): (EdgeLayer | (EdgeLabelLayer | FlowLayer)[])[];
+    private _applyGraphEngineCallbacks;
+    private _createRankGridLayer;
+    private _normalizeRankGridConfig;
+    private _resolveRankGridBounds;
+    private _buildRankGridData;
+    private _resolveRankFieldLabel;
+    createNodeLayers(): any[];
+    createEdgeLayers(): (EdgeLayer | EdgeLabelLayer | FlowLayer | EdgeArrowLayer)[];
     onClick(info: any, event: any): boolean;
     onHover(info: any, event: any): boolean;
     onDragStart(info: any, event: any): void;
     onDrag(info: any, event: any): void;
     onDragEnd(info: any, event: any): void;
-    renderLayers(): ((EdgeLayer | (EdgeLabelLayer | FlowLayer)[])[] | (CircleLayer | ImageLayer | LabelLayer | RectangleLayer | ZoomableMarkerLayer)[])[];
+    renderLayers(): any[];
+    private _createChainOverlayLayers;
 }
-//# sourceMappingURL=graph-layer.d.ts.map
+export {};

package/dist/layers/graph-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-layer.d.ts","sourceRoot":"","sources":["../../src/layers/graph-layer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AACvD,OAAO,EAAoB,cAAc,EAAC,MAAM,eAAe,CAAC;AAGhE,OAAO,EAAC,KAAK,EAAC,0BAAuB;AACrC,OAAO,EAAC,WAAW,EAAC,gCAA6B;AACjD,OAAO,EAAC,WAAW,EAAC,gCAA6B;AAIjD,OAAO,EAAC,kBAAkB,EAAC,uCAAoC;AAK/D,OAAO,EAAC,WAAW,EAAC,sCAAmC;AACvD,OAAO,EAAC,UAAU,EAAC,qCAAkC;AACrD,OAAO,EAAC,UAAU,EAAC,qCAAkC;AACrD,OAAO,EAAC,cAAc,EAAC,yCAAsC;AAG7D,OAAO,EAAC,mBAAmB,EAAC,+CAA4C;AAGxE,OAAO,EAAC,SAAS,EAAC,wBAAqB;AACvC,OAAO,EAAC,cAAc,EAAC,0CAAuC;AAC9D,OAAO,EAAC,SAAS,EAAC,oCAAiC;AA0BnD,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAErE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAC,IAAI,EAAE,GAAG,CAAA;KAAC,KAAK,KAAK,CAAC;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;IAGrB,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,oCAAoC;QACpC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC;IACF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,qBAAa,UAAW,SAAQ,cAAc,CAAC,eAAe,CAAC;IAC7D,MAAM,CAAC,SAAS,SAAgB;IAEhC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CA2B7C;IAGF,KAAK,EAAG,cAAc,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,GAAG;QACjD,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,CAAC;IAEF,WAAW,aAKT;gBAEU,KAAK,EAAE,eAAe,GAAG,mBAAmB;IAIxD,eAAe;IAQf,iBAAiB,CAAC,EAAC,WAAW,EAAC;;KAAA;IAI/B,WAAW,CAAC,EAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAC;;;;KAAA;IAqB1C,QAAQ;IAIR,eAAe,CAAC,WAAW,EAAE,WAAW;IAcxC,kBAAkB;IAQlB,gBAAgB;IAmChB,gBAAgB;IA2DhB,OAAO,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA,GAAG,OAAO;IAI7B,OAAO,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA,GAAG,OAAO;IAI7B,WAAW,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA;IAIvB,MAAM,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA;IAIlB,SAAS,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA;IAIrB,YAAY;CAGb"}
+{"version":3,"file":"graph-layer.d.ts","sourceRoot":"","sources":["../../src/layers/graph-layer.ts"],"names":[],"mappings":"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"}