@cosmos.gl/graph 2.6.0 → 2.6.2-rc.0

package/dist/config.d.ts

@@ -116,6 +116,8 @@ export interface GraphConfigInterface {
      * in the format `[red, green, blue, alpha]` where each value is a number between 0 and 255.
      * Default value: '#666666'
      */
+    linkDefaultColor?: string | [number, number, number, number];
+    /** @deprecated Use `linkDefaultColor` instead */
     linkColor?: string | [number, number, number, number];
     /**
      * Universal opacity value applied to all links.
@@ -560,6 +562,7 @@ export declare class GraphConfig implements GraphConfigInterface {
     focusedPointRingColor: string;
     focusedPointIndex: undefined;
     linkColor: string;
+    linkDefaultColor: undefined;
     linkOpacity: number;
     linkGreyoutOpacity: number;
     linkWidth: number;

package/dist/index.d.ts

@@ -256,11 +256,13 @@ export declare class Graph {
      */
     setPinnedPoints(pinnedIndices: number[] | null): void;
     /**
-     * Renders the graph.
+     * Renders the graph and starts rendering.
+     * Does NOT modify simulation state - use start(), stop(), pause(), unpause() to control simulation.
      *
-     * @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.
+     * @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.
      */
     render(simulationAlpha?: number): void;
     /**
@@ -457,12 +459,19 @@ 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
-     * and can be resumed using the unpause method.
+     * but preserves its current state (progress, alpha).
+     * Can be resumed using the unpause method.
      */
     pause(): void;
     /**
@@ -477,7 +486,8 @@ export declare class Graph {
      */
     restart(): void;
     /**
-     * Render only one frame of the simulation (stops the simulation if it was running).
+     * Run one step of the simulation manually.
+     * Works even when the simulation is paused.
      */
     step(): void;
     /**
@@ -500,10 +510,42 @@ export declare class Graph {
      * @returns An array of tuple positions
      */
     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.
+     */
     private update;
+    /**
+     * 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.
+     */
+    private runSimulationStep;
     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;