@cosmos.gl/graph 2.6.3 → 2.6.4

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

@@ -213,6 +213,13 @@ export interface GraphConfigInterface {
      * Default value: `0.25`
      */
     linkVisibilityMinTransparency?: number;
+    /**
+     * Use the classic quadtree algorithm for the Many-Body force.
+     * This property will be applied only on component initialization and it
+     * can't be changed using the `setConfig` method.
+     * Default value: `false`
+     */
+    useClassicQuadtree?: boolean;
     /**
      * Decay coefficient. Use smaller values if you want the simulation to "cool down" slower.
      * Default value: `5000`
@@ -235,9 +242,16 @@ export interface GraphConfigInterface {
     simulationRepulsion?: number;
     /**
      * Decreases / increases the detalization of the Many-Body force calculations.
+     * When `useClassicQuadtree` is set to `true`, this property corresponds to the Barnes–Hut approximation criterion.
      * Default value: `1.15`
      */
     simulationRepulsionTheta?: number;
+    /**
+     * Barnes–Hut approximation depth.
+     * Can only be used when `useClassicQuadtree` is set `true`.
+     * Default value: `12`
+     */
+    simulationRepulsionQuadtreeLevels?: number;
     /**
      * Link spring force coefficient.
      * Default value: `1`
@@ -433,8 +447,8 @@ export interface GraphConfigInterface {
      */
     showFPSMonitor?: boolean;
     /**
-     * Pixel ratio for the canvas. Higher values use more GPU memory but provide better quality on high-DPI displays.
-     * Default value: `window.devicePixelRatio || 2`
+     * Canvas pixel ratio.
+     * Default value: `2`
      */
     pixelRatio?: number;
     /**
@@ -574,11 +588,13 @@ export declare class GraphConfig implements GraphConfigInterface {
     scaleLinksOnZoom: boolean;
     linkVisibilityDistanceRange: number[];
     linkVisibilityMinTransparency: number;
+    useClassicQuadtree: boolean;
     simulationDecay: number;
     simulationGravity: number;
     simulationCenter: number;
     simulationRepulsion: number;
     simulationRepulsionTheta: number;
+    simulationRepulsionQuadtreeLevels: number;
     simulationLinkSpring: number;
     simulationLinkDistance: number;
     simulationLinkDistRandomVariationRange: number[];

package/dist/{src/graph → graph}/utils/error-message.d.ts

@@ -3,4 +3,4 @@
  * @param container The HTML element to append the error message to
  * @returns The created error div element
  */
-export declare function createWebGLErrorMessage(container: HTMLElement, error: string): HTMLDivElement;
+export declare function createWebGLErrorMessage(container: HTMLElement): HTMLDivElement;

package/dist/helper.d.ts

@@ -0,0 +1,24 @@
+import { default as regl } from 'regl';
+import { default as DOMPurify } from 'dompurify';
+export declare const isFunction: <T>(a: T) => boolean;
+export declare const isArray: <T>(a: unknown | T[]) => a is T[];
+export declare const isObject: <T>(a: T) => boolean;
+export declare const isAClassInstance: <T>(a: T) => boolean;
+export declare const isPlainObject: <T>(a: T) => boolean;
+export declare function getRgbaColor(value: string | [number, number, number, number]): [number, number, number, number];
+export declare function rgbToBrightness(r: number, g: number, b: number): number;
+export declare function readPixels(reglInstance: regl.Regl, fbo: regl.Framebuffer2D): Float32Array;
+export declare function clamp(num: number, min: number, max: number): number;
+export declare function isNumber(value: number | undefined | null | typeof NaN): boolean;
+/**
+ * Sanitizes HTML content to prevent XSS attacks using DOMPurify
+ *
+ * This function is used internally to sanitize HTML content before setting innerHTML,
+ * such as in attribution text. It uses a safe default configuration that allows
+ * only common safe HTML elements and attributes.
+ *
+ * @param html The HTML string to sanitize
+ * @param options Optional DOMPurify configuration options to override defaults
+ * @returns Sanitized HTML string safe for innerHTML usage
+ */
+export declare function sanitizeHtml(html: string, options?: DOMPurify.Config): string;

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

@@ -1,4 +1,3 @@
-import { Device } from '@luma.gl/core';
 import { GraphConfig, GraphConfigInterface } from './config';
 import { GraphData } from './modules/GraphData';
 export declare class Graph {
@@ -7,8 +6,7 @@ export declare class Graph {
     private canvas;
     private attributionDivElement;
     private canvasD3Selection;
-    private device;
-    private deviceInitPromise;
+    private reglInstance;
     private requestAnimationFrameId;
     private isRightClickMouse;
     private store;
@@ -54,7 +52,7 @@ export declare class Graph {
     private isForceCenterUpdateNeeded;
     private isPointImageSizesUpdateNeeded;
     private _isDestroyed;
-    constructor(div: HTMLDivElement, config?: GraphConfigInterface, devicePromise?: Promise<Device>);
+    constructor(div: HTMLDivElement, config?: GraphConfigInterface);
     /**
      * Returns the current simulation progress
      */
@@ -513,31 +511,10 @@ export declare class Graph {
      */
     pair(pointPositions: number[]): [number, number][];
     /**
-     * Ensures device is initialized before executing a method.
-     * If device is not ready, queues the method to run after initialization.
-     * @param callback - Function to execute once device is ready
-     * @returns true if device was not ready and operation was queued, false if device is ready
-     */
-    private ensureDevice;
-    /**
-     * Validates that a device has the required HTMLCanvasElement canvas context.
-     * Cosmos requires an HTMLCanvasElement canvas context and does not support
-     * OffscreenCanvas or compute-only devices.
-     * @param device - The device to validate
-     * @returns The validated canvas context (guaranteed to be non-null and HTMLCanvasElement type)
-     * @throws Error if the device does not meet Cosmos requirements
-     */
-    private validateDevice;
-    /**
-     * Internal device creation method
-     * Graph class decides what device to create with sensible defaults
+     * Updates and recreates the graph visualization based on pending changes.
+     *
+     * @param simulationAlpha - Optional alpha value to set. If not provided, keeps current alpha.
      */
-    private createDevice;
-    /**
-    * Updates and recreates the graph visualization based on pending changes.
-    *
-    * @param simulationAlpha - Optional alpha value to set. If not provided, keeps current alpha.
-    */
     private update;
     /**
      * Runs one step of the simulation (forces, position updates, alpha decay).