@cosmos.gl/graph 2.6.2-rc.0 → 2.7.0-beta.0

package/dist/index.d.ts

@@ -6,7 +6,8 @@ export declare class Graph {
     private canvas;
     private attributionDivElement;
     private canvasD3Selection;
-    private reglInstance;
+    private device;
+    private deviceInitPromise;
     private requestAnimationFrameId;
     private isRightClickMouse;
     private store;
@@ -238,31 +239,11 @@ export declare class Graph {
      */
     setPointClusterStrength(clusterStrength: Float32Array): void;
     /**
-     * Sets which points are pinned (fixed) in position.
+     * Renders the graph.
      *
-     * Pinned points:
-     * - Do not move due to physics forces (gravity, repulsion, link forces, etc.)
-     * - Still participate in force calculations (other nodes are attracted to/repelled by them)
-     * - Can still be dragged by the user if `enableDrag` is true
-     *
-     * @param {number[] | null} pinnedIndices - Array of point indices to pin. Set to `[]` or `null` to unpin all points.
-     * @example
-     *   // Pin points 0 and 5
-     *   graph.setPinnedPoints([0, 5])
-     *
-     *   // Unpin all points
-     *   graph.setPinnedPoints([])
-     *   graph.setPinnedPoints(null)
-     */
-    setPinnedPoints(pinnedIndices: number[] | null): void;
-    /**
-     * Renders the graph and starts rendering.
-     * Does NOT modify simulation state - use start(), stop(), pause(), unpause() to control simulation.
-     *
-     * @param {number} [simulationAlpha] - Optional alpha value to set.
-     *   - If 0: Sets alpha to 0, simulation stops after one frame (graph becomes static).
-     *   - If positive: Sets alpha to that value.
-     *   - If undefined: Keeps current alpha value.
+     * @param {number} [simulationAlpha] - Optional value between 0 and 1
+     * that controls the initial energy of the simulation.The higher the value,
+     * the more initial energy the simulation will get. Zero value stops the simulation.
      */
     render(simulationAlpha?: number): void;
     /**
@@ -459,19 +440,12 @@ export declare class Graph {
     getScaleY(): ((y: number) => number) | undefined;
     /**
      * Start the simulation.
-     * This only controls the simulation state, not rendering.
      * @param alpha Value from 0 to 1. The higher the value, the more initial energy the simulation will get.
      */
     start(alpha?: number): void;
-    /**
-     * Stop the simulation. This stops the simulation and resets its state.
-     * Use start() to begin a new simulation cycle.
-     */
-    stop(): void;
     /**
      * Pause the simulation. When paused, the simulation stops running
-     * but preserves its current state (progress, alpha).
-     * Can be resumed using the unpause method.
+     * and can be resumed using the unpause method.
      */
     pause(): void;
     /**
@@ -486,8 +460,7 @@ export declare class Graph {
      */
     restart(): void;
     /**
-     * Run one step of the simulation manually.
-     * Works even when the simulation is paused.
+     * Render only one frame of the simulation (stops the simulation if it was running).
      */
     step(): void;
     /**
@@ -511,41 +484,21 @@ export declare class Graph {
      */
     pair(pointPositions: number[]): [number, number][];
     /**
-     * Updates and recreates the graph visualization based on pending changes.
-     *
-     * @param simulationAlpha - Optional alpha value to set. If not provided, keeps current alpha.
+     * 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 update;
+    private ensureDevice;
     /**
-     * Runs one step of the simulation (forces, position updates, alpha decay).
-     * This is the core simulation logic that can be called by step() or during rendering.
-     *
-     * @param forceExecution - Controls whether to run the simulation step when paused.
-     *   - If true: Always runs the simulation step, even when isSimulationRunning is false.
-     *     Used by step() to allow manual stepping while the simulation is paused.
-     *   - If false: Only runs if isSimulationRunning is true. Used during rendering
-     *     to respect pause/unpause state.
+     * Internal device creation method
+     * Graph class decides what device to create with sensible defaults
      */
-    private runSimulationStep;
+    private createDevice;
+    private update;
     private initPrograms;
-    /**
-     * The rendering loop - schedules itself to run continuously
-     */
     private frame;
-    /**
-     * Renders a single frame (the actual rendering logic).
-     * This does NOT schedule the next frame.
-     */
-    private renderFrame;
     private stopFrames;
-    /**
-     * Starts continuous rendering
-     */
-    private startFrames;
-    /**
-     * Called automatically when simulation completes (alpha < ALPHA_MIN).
-     * Rendering continues after this is called (for rendering/interaction).
-     */
     private end;
     private onClick;
     private updateMousePosition;