@cosmos.gl/graph 3.0.0-beta.1 → 3.0.0-beta.3

package/dist/{src/config.d.ts → config.d.ts}

@@ -349,7 +349,7 @@ export interface GraphConfigInterface {
      * `(index: number | undefined, pointPosition: [number, number] | undefined, event: MouseEvent) => void`.
      * Default value: `undefined`
      */
-    onRightClick?: (index: number | undefined, pointPosition: [number, number] | undefined, event: MouseEvent) => void;
+    onContextMenu?: (index: number | undefined, pointPosition: [number, number] | undefined, event: MouseEvent) => void;
     /**
      * Callback function that will be called when a context menu trigger (typically right click) happens on a point.
      * The point index will be passed as the first argument,
@@ -357,21 +357,21 @@ export interface GraphConfigInterface {
      * `(index: number, pointPosition: [number, number], event: MouseEvent) => void`.
      * Default value: `undefined`
      */
-    onPointRightClick?: (index: number, pointPosition: [number, number], event: MouseEvent) => void;
+    onPointContextMenu?: (index: number, pointPosition: [number, number], event: MouseEvent) => void;
     /**
      * Callback function that will be called when a context menu trigger (typically right click) happens on a link.
      * The link index will be passed as the first argument and the corresponding mouse event as the second argument:
      * `(linkIndex: number, event: MouseEvent) => void`.
      * Default value: `undefined`
      */
-    onLinkRightClick?: (linkIndex: number, event: MouseEvent) => void;
+    onLinkContextMenu?: (linkIndex: number, event: MouseEvent) => void;
     /**
      * Callback function that will be called when a context menu trigger (typically right click) happens on the background (empty space).
      * The mouse event will be passed as the first argument:
      * `(event: MouseEvent) => void`.
      * Default value: `undefined`
      */
-    onBackgroundRightClick?: (event: MouseEvent) => void;
+    onBackgroundContextMenu?: (event: MouseEvent) => void;
     /**
      * Callback function that will be called when mouse movement happens.
      * If the mouse moves over a point, its index will be passed as the first argument,
@@ -383,13 +383,13 @@ export interface GraphConfigInterface {
     /**
      * Callback function that will be called when a point appears under the mouse
      * as a result of a mouse event, zooming and panning, or movement of points.
-     * The point index will be passed as the first argument, position as the second argument
-     * and the corresponding mouse event or D3's zoom event as the third argument:
-     * `(index: number, pointPosition: [number, number], event: MouseEvent | D3DragEvent<HTMLCanvasElement, undefined, Hovered>
-     * | D3ZoomEvent<HTMLCanvasElement, undefined> | undefined) => void`.
+     * The point index will be passed as the first argument, position as the second argument,
+     * the corresponding mouse event or D3's zoom event as the third argument, and whether
+     * the hovered point is selected as the fourth argument:
+     * `(index: number, pointPosition: [number, number], event: MouseEvent | D3DragEvent<HTMLCanvasElement, undefined, Hovered> | D3ZoomEvent<HTMLCanvasElement, undefined> | undefined, isSelected: boolean) => void`.
      * Default value: `undefined`
      */
-    onPointMouseOver?: (index: number, pointPosition: [number, number], event: MouseEvent | D3DragEvent<HTMLCanvasElement, undefined, Hovered> | D3ZoomEvent<HTMLCanvasElement, undefined> | undefined) => void;
+    onPointMouseOver?: (index: number, pointPosition: [number, number], event: MouseEvent | D3DragEvent<HTMLCanvasElement, undefined, Hovered> | D3ZoomEvent<HTMLCanvasElement, undefined> | undefined, isSelected: boolean) => void;
     /**
      * Callback function that will be called when a point is no longer underneath
      * the mouse pointer because of a mouse event, zoom/pan event, or movement of points.
@@ -626,10 +626,10 @@ export declare class GraphConfig implements GraphConfigInterface {
     onPointClick: GraphConfigInterface['onPointClick'];
     onLinkClick: GraphConfigInterface['onLinkClick'];
     onBackgroundClick: GraphConfigInterface['onBackgroundClick'];
-    onRightClick: GraphConfigInterface['onRightClick'];
-    onPointRightClick: GraphConfigInterface['onPointRightClick'];
-    onLinkRightClick: GraphConfigInterface['onLinkRightClick'];
-    onBackgroundRightClick: GraphConfigInterface['onBackgroundRightClick'];
+    onContextMenu: GraphConfigInterface['onContextMenu'];
+    onPointContextMenu: GraphConfigInterface['onPointContextMenu'];
+    onLinkContextMenu: GraphConfigInterface['onLinkContextMenu'];
+    onBackgroundContextMenu: GraphConfigInterface['onBackgroundContextMenu'];
     onMouseMove: GraphConfigInterface['onMouseMove'];
     onPointMouseOver: GraphConfigInterface['onPointMouseOver'];
     onPointMouseOut: GraphConfigInterface['onPointMouseOut'];

package/dist/{src/index.d.ts → index.d.ts}

@@ -4,12 +4,13 @@ import { GraphData } from './modules/GraphData';
 export declare class Graph {
     config: GraphConfig;
     graph: GraphData;
+    /** Promise that resolves with the luma device when the graph is ready. Await or `.then()` to run after init. */
+    readonly deviceInitPromise: Promise<Device>;
     /** Canvas element, assigned asynchronously during device initialization */
     private canvas;
     private attributionDivElement;
     private canvasD3Selection;
     private device;
-    private deviceInitPromise;
     /**
      * Tracks whether this Graph instance owns the device and should destroy it on cleanup.
      * Set to `true` when Graph creates its own device, `false` when using an external device.
@@ -332,16 +333,27 @@ export declare class Graph {
     fitView(duration?: number, padding?: number): void;
     /**
      * Center and zoom in/out the view to fit points by their indices in the scene.
+     * @param indices Point indices to fit in the view.
      * @param duration Duration of the center and zoom in/out animation in milliseconds (`250` by default).
-     * @param padding Padding around the viewport in percentage
+     * @param padding Padding around the viewport in percentage (`0.1` by default).
      */
     fitViewByPointIndices(indices: number[], duration?: number, padding?: number): void;
     /**
      * Center and zoom in/out the view to fit points by their positions in the scene.
+     * @param positions Flat array of point coordinates as `[x0, y0, x1, y1, ...]`.
      * @param duration Duration of the center and zoom in/out animation in milliseconds (`250` by default).
-     * @param padding Padding around the viewport in percentage
+     * @param padding Padding around the viewport in percentage (`0.1` by default).
      */
     fitViewByPointPositions(positions: number[], duration?: number, padding?: number): void;
+    /**
+     * Sets the zoom transform so that the given point positions fit in the viewport, with optional animation.
+     *
+     * @param positions Flat array of point coordinates as `[x0, y0, x1, y1, ...]`.
+     * @param duration Animation duration in milliseconds. Default `250`.
+     * @param scale Optional scale factor; if omitted, scale is chosen to fit the positions.
+     * @param padding Padding around the viewport as a fraction (e.g. `0.1` = 10%). Default `0.1`.
+     */
+    setZoomTransformByPointPositions(positions: Float32Array, duration?: number, scale?: number, padding?: number): void;
     /**
      * Get points indices inside a rectangular area.
      * @param selection - Array of two corner points `[[left, top], [right, bottom]]`.
@@ -595,9 +607,8 @@ export declare class Graph {
     private onClick;
     private updateMousePosition;
     private onMouseMove;
-    private onRightClickMouse;
+    private onContextMenu;
     private resizeCanvas;
-    private setZoomTransformByPointPositions;
     private updateZoomDragBehaviors;
     private findHoveredItem;
     private findHoveredPoint;