@cosmos.gl/graph 2.7.0-beta.0 → 2.7.0-beta.1

package/dist/index.d.ts

@@ -239,11 +239,31 @@ export declare class Graph {
      */
     setPointClusterStrength(clusterStrength: Float32Array): void;
     /**
-     * Renders the graph.
+     * Sets which points are pinned (fixed) in position.
      *
-     * @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.
+     * 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.
      */
     render(simulationAlpha?: number): void;
     /**
@@ -440,12 +460,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;
     /**
@@ -460,7 +487,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;
     /**
@@ -495,10 +523,42 @@ export declare class Graph {
      * Graph class decides what device to create with sensible defaults
      */
     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).
+     * 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;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { G as i, P as e, A as r, x as t, v as n, r as o, q as l, C as b, s as c, w as g, z as m, y as p, E as P } from "./index-FUIgayhu.js";
+import { G as i, P as e, A as r, x as t, v as n, r as o, q as l, C as b, s as c, w as g, z as m, y as p, E as P } from "./index-B1_1MjaX.js";
 export {
   i as Graph,
   e as PointShape,