@cosmos.gl/graph 2.7.0-beta.2 → 2.7.0-beta.3

package/dist/src/helper.d.ts

@@ -43,8 +43,18 @@ export declare function rgbToBrightness(r: number, g: number, b: number): number
  * - Consider batching the migration to avoid inconsistencies
  *
  * Current status: Deprecated but still functional. Keeping for now until full migration can be planned.
+ *
+ * @note Cosmos currently supports WebGL only; support for other device types will be added later.
  */
 export declare function readPixels(device: Device, fbo: Framebuffer, sourceX?: number, sourceY?: number, sourceWidth?: number, sourceHeight?: number): Float32Array;
+/**
+ * Returns the maximum point size supported by the device, scaled by pixel ratio.
+ * For WebGL devices, reads the limit from the context; for other device types, uses MAX_POINT_SIZE from Store.
+ * @param device - The luma.gl device
+ * @param pixelRatio - Device pixel ratio to scale the result
+ * @returns Maximum point size (device limit / pixelRatio)
+ */
+export declare function getMaxPointSize(device: Device, pixelRatio: number): number;
 export declare function clamp(num: number, min: number, max: number): number;
 export declare function isNumber(value: number | undefined | null | typeof NaN): boolean;
 /**

package/dist/src/index.d.ts

@@ -4,11 +4,18 @@ import { GraphData } from './modules/GraphData';
 export declare class Graph {
     config: GraphConfig;
     graph: GraphData;
+    /** 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.
+     * When `false`, the external device lifecycle is managed by the user.
+     */
+    private shouldDestroyDevice;
     private requestAnimationFrameId;
     private isRightClickMouse;
     private store;
@@ -34,6 +41,21 @@ export declare class Graph {
      * If the mouse is not on the Canvas, the `findHoveredPoint` or `findHoveredLine` method will not be executed.
      */
     private _isMouseOnCanvas;
+    /**
+     * Last mouse position for detecting significant mouse movement
+     */
+    private _lastMouseX;
+    private _lastMouseY;
+    /**
+     * Last checked mouse position for hover detection
+     */
+    private _lastCheckedMouseX;
+    private _lastCheckedMouseY;
+    /**
+     * Force hover detection on next frame, bypassing mouse movement check.
+     * Set when scene changes but mouse stays still (after simulation or zoom ends).
+     */
+    private _shouldForceHoverDetection;
     /**
      * After setting data and render graph at a first time, the fit logic will run
      * */

package/dist/src/modules/Store/index.d.ts

@@ -8,6 +8,11 @@ export declare const MAX_POINT_SIZE = 64;
  * The `findHoveredItem` method will skip actual detection until this count is reached.
  */
 export declare const MAX_HOVER_DETECTION_DELAY = 4;
+/**
+ * Minimum mouse movement threshold (in pixels) to trigger hover detection.
+ * If the mouse moves less than this distance, hover detection will be skipped to save performance.
+ */
+export declare const MIN_MOUSE_MOVEMENT_THRESHOLD = 2;
 export type Hovered = {
     index: number;
     position: [number, number];
@@ -19,7 +24,7 @@ type Focused = {
  * Type alias for a 4x4 matrix stored as a 16-element array in column-major order.
  * Used for std140 uniform buffer layout compatibility.
  */
-type Mat4Array = [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
+export type Mat4Array = [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
 export declare class Store {
     pointsTextureSize: number;
     linksTextureSize: number;

package/dist/{webgl-device-QoBMYpnS.js → webgl-device-BeV8-7_B.js}

@@ -1,7 +1,7 @@
 var je = Object.defineProperty;
 var Qe = (r, t, e) => t in r ? je(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
 var o = (r, t, e) => Qe(r, typeof t != "symbol" ? t + "" : t, e);
-import { i as Me, a as Ye, n as Ke, u as Ze, R as S, l as b, T as B, g as Je, t as We, D as et, b as tt, B as C, S as rt, c as it, d as nt, e as st, f as at, h as ot, j as ct, k as lt, m as pe, o as ut, p as ht } from "./index-CSMQs8iI.js";
+import { i as Me, a as Ye, n as Ke, u as Ze, R as S, l as b, T as B, g as Je, t as We, D as et, b as tt, B as C, S as rt, c as it, d as nt, e as st, f as at, h as ot, j as ct, k as lt, m as pe, o as ut, p as ht } from "./index-u8g06ZrC.js";
 function ft(r) {
   return Me() ? Ye() ? "Electron" : (Ke.userAgent || "").indexOf("Edge") > -1 ? "Edge" : globalThis.chrome ? "Chrome" : globalThis.safari ? "Safari" : globalThis.mozInnerScreenX ? "Firefox" : "Unknown" : "Node";
 }
@@ -3930,4 +3930,4 @@ function Xr(r, t) {
 export {
   jr as WebGLDevice
 };
-//# sourceMappingURL=webgl-device-QoBMYpnS.js.map
+//# sourceMappingURL=webgl-device-BeV8-7_B.js.map