@cosmos.gl/graph 3.0.0-beta.5 → 3.0.0-beta.7

package/dist/modules/Clusters/index.d.ts

@@ -11,6 +11,13 @@ export declare class Clusters extends CoreModule {
     private centermassTexture;
     private pointIndices;
     private clustersTextureSize;
+    /**
+     * Cached result of the last `getCentroidPositions()` computation.
+     * Populated when the simulation is inactive to avoid redundant GPU render passes and readbacks.
+     * Nulled in `create()` and `destroy()` to handle structural changes (e.g. `setPointPositions`,
+     * `setPointClusters`). Positional changes are handled separately via `Points.areClusterCentroidsUpToDate`.
+     */
+    private cachedCentroidPositions;
     private applyForcesVertexCoordBuffer;
     private previousPointsTextureSize;
     private previousClustersTextureSize;
@@ -20,6 +27,8 @@ export declare class Clusters extends CoreModule {
     create(): void;
     initPrograms(): void;
     calculateCentermass(): void;
+    /** Do not mutate the returned array; it may be the internal cache. */
+    getCentroidPositions(): Readonly<number[]>;
     run(): void;
     /**
      * Destruction order matters

package/dist/modules/GraphData/index.d.ts

@@ -1,4 +1,4 @@
-import { GraphConfig } from '../../config';
+import { GraphConfigInterface } from '../../config';
 export declare enum PointShape {
     Circle = 0,
     Square = 1,
@@ -52,7 +52,7 @@ export declare class GraphData {
     inDegree: number[] | undefined;
     outDegree: number[] | undefined;
     private _config;
-    constructor(config: GraphConfig);
+    constructor(config: GraphConfigInterface);
     get pointsNumber(): number | undefined;
     get linksNumber(): number | undefined;
     updatePoints(): void;
@@ -65,9 +65,8 @@ export declare class GraphData {
      */
     updatePointSize(): void;
     /**
-     * Updates the point shapes based on the input data or default shape.
-     * Default behavior: Circle (0).
-    * Images are rendered above shapes.
+     * Updates the point shapes based on the input data or default config value.
+     * Images are rendered above shapes.
      */
     updatePointShape(): void;
     /**

package/dist/modules/Lines/conic-curve-module.d.ts

@@ -0,0 +1,2 @@
+import { ShaderModule } from '@luma.gl/shadertools';
+export declare const conicParametricCurveModule: ShaderModule;

package/dist/modules/Lines/index.d.ts

@@ -3,8 +3,10 @@ import { CoreModule } from '../core-module';
 export declare class Lines extends CoreModule {
     linkIndexFbo: Framebuffer | undefined;
     hoveredLineIndexFbo: Framebuffer | undefined;
+    sampledLinksFbo: Framebuffer | undefined;
     private drawCurveCommand;
     private hoveredLineIndexCommand;
+    private fillSampledLinksFboCommand;
     private pointABuffer;
     private pointBBuffer;
     private colorBuffer;
@@ -16,17 +18,25 @@ export declare class Lines extends CoreModule {
     private quadBuffer;
     private linkIndexTexture;
     private hoveredLineIndexTexture;
+    private fillSampledLinksUniformStore;
     private drawLineUniformStore;
     private hoveredLineIndexUniformStore;
     private previousScreenSize;
     initPrograms(): void;
     draw(renderPass: RenderPass): void;
     updateLinkIndexFbo(): void;
+    updateSampledLinksGrid(): void;
     updatePointsBuffer(): void;
     updateColor(): void;
     updateWidth(): void;
     updateArrow(): void;
     updateCurveLineGeometry(): void;
+    getSampledLinkPositionsMap(): Map<number, [number, number, number]>;
+    getSampledLinks(): {
+        indices: number[];
+        positions: number[];
+        angles: number[];
+    };
     findHoveredLine(): void;
     /**
      * Destruction order matters

package/dist/modules/Points/index.d.ts

@@ -15,6 +15,13 @@ export declare class Points extends CoreModule {
     previousPositionTexture: Texture | undefined;
     velocityTexture: Texture | undefined;
     greyoutStatusTexture: Texture | undefined;
+    /**
+     * Whether the cached cluster centroid positions are still valid.
+     * Set to `false` in `swapFbo()` whenever GPU point positions change (simulation tick or drag).
+     * Set to `true` by `Clusters.getCentroidPositions()` after a fresh computation.
+     * Used together with `Clusters.cachedCentroidPositions` to skip redundant GPU readbacks.
+     */
+    areClusterCentroidsUpToDate: boolean;
     private colorBuffer;
     private sizeBuffer;
     private shapeBuffer;

package/dist/modules/Zoom/index.d.ts

@@ -7,6 +7,10 @@ export declare class Zoom {
     eventTransform: ZoomTransform;
     behavior: import('d3-zoom').ZoomBehavior<HTMLCanvasElement, undefined>;
     isRunning: boolean;
+    /** Per-call override for `enableSimulationDuringZoom` config, set by programmatic zoom methods.
+     * Stale value after transition ends is harmless since `isRunning` is `false` at that point.
+     * Cleared on user-driven zoom start. */
+    shouldEnableSimulationDuringZoomOverride: boolean | undefined;
     constructor(store: Store, config: GraphConfigInterface);
     /**
      * Returns the zoom transform that fits the given point positions into the viewport.

package/dist/variables.d.ts

@@ -1,64 +1,96 @@
-export declare const defaultPointColor = "#b3b3b3";
-export declare const defaultGreyoutPointOpacity: undefined;
-export declare const defaultGreyoutPointColor: undefined;
-export declare const defaultPointOpacity = 1;
-export declare const defaultPointSize = 4;
-export declare const defaultLinkColor = "#666666";
-export declare const defaultGreyoutLinkOpacity = 0.1;
-export declare const defaultLinkOpacity = 1;
-export declare const defaultLinkWidth = 1;
-export declare const defaultBackgroundColor = "#222222";
+import { PointShape } from './modules/GraphData';
+/**
+ * Default values for all graph configuration properties.
+ */
 export declare const defaultConfigValues: {
-    enableSimulation: boolean;
+    enableSimulation: true;
+    backgroundColor: string;
+    /** Setting to 4096 because larger values crash the graph on iOS. More info: https://github.com/cosmosgl/graph/issues/203 */
     spaceSize: number;
+    pointDefaultColor: string;
+    pointDefaultSize: number;
+    pointDefaultShape: PointShape.Circle;
+    pointOpacity: number;
+    pointGreyoutOpacity: undefined;
+    pointGreyoutColor: undefined;
     pointSizeScale: number;
+    scalePointsOnZoom: false;
+    hoveredPointCursor: string;
+    renderHoveredPointRing: false;
+    hoveredPointRingColor: string;
+    focusedPointRingColor: string;
+    focusedPointIndex: undefined;
+    renderLinks: true;
+    linkDefaultColor: string;
+    linkDefaultWidth: number;
+    linkOpacity: number;
+    linkGreyoutOpacity: number;
     linkWidthScale: number;
-    linkArrowsSizeScale: number;
-    renderLinks: boolean;
-    curvedLinks: boolean;
+    scaleLinksOnZoom: false;
+    curvedLinks: false;
     curvedLinkSegments: number;
     curvedLinkWeight: number;
     curvedLinkControlPointDistance: number;
-    linkArrows: boolean;
+    linkDefaultArrows: false;
+    linkArrowsSizeScale: number;
     linkVisibilityDistanceRange: number[];
     linkVisibilityMinTransparency: number;
-    hoveredPointCursor: string;
     hoveredLinkCursor: string;
-    renderHoveredPointRing: boolean;
-    hoveredPointRingColor: string;
     hoveredLinkColor: undefined;
     hoveredLinkWidthIncrease: number;
-    focusedPointRingColor: string;
-    focusedPointIndex: undefined;
-    simulation: {
-        decay: number;
-        gravity: number;
-        center: number;
-        repulsion: number;
-        repulsionTheta: number;
-        linkSpring: number;
-        linkDistance: number;
-        linkDistRandomVariationRange: number[];
-        repulsionFromMouse: number;
-        friction: number;
-        cluster: number;
-    };
-    showFPSMonitor: boolean;
+    simulationDecay: number;
+    simulationGravity: number;
+    simulationCenter: number;
+    simulationRepulsion: number;
+    simulationRepulsionTheta: number;
+    simulationLinkSpring: number;
+    simulationLinkDistance: number;
+    simulationLinkDistRandomVariationRange: number[];
+    simulationRepulsionFromMouse: number;
+    simulationFriction: number;
+    simulationCluster: number;
+    enableRightClickRepulsion: false;
+    onSimulationStart: undefined;
+    onSimulationTick: undefined;
+    onSimulationEnd: undefined;
+    onSimulationPause: undefined;
+    onSimulationUnpause: undefined;
+    onClick: undefined;
+    onPointClick: undefined;
+    onLinkClick: undefined;
+    onBackgroundClick: undefined;
+    onContextMenu: undefined;
+    onPointContextMenu: undefined;
+    onLinkContextMenu: undefined;
+    onBackgroundContextMenu: undefined;
+    onMouseMove: undefined;
+    onPointMouseOver: undefined;
+    onPointMouseOut: undefined;
+    onLinkMouseOver: undefined;
+    onLinkMouseOut: undefined;
+    onZoomStart: undefined;
+    onZoom: undefined;
+    onZoomEnd: undefined;
+    onDragStart: undefined;
+    onDrag: undefined;
+    onDragEnd: undefined;
+    showFPSMonitor: false;
     pixelRatio: number;
-    scalePointsOnZoom: boolean;
-    scaleLinksOnZoom: boolean;
-    enableZoom: boolean;
-    enableSimulationDuringZoom: boolean;
-    enableDrag: boolean;
-    fitViewOnInit: boolean;
+    enableZoom: true;
+    enableSimulationDuringZoom: false;
+    initialZoomLevel: undefined;
+    enableDrag: false;
+    fitViewOnInit: true;
     fitViewDelay: number;
     fitViewPadding: number;
     fitViewDuration: number;
+    fitViewByPointsInRect: undefined;
+    fitViewByPointIndices: undefined;
     pointSamplingDistance: number;
-    attribution: string;
+    linkSamplingDistance: number;
+    randomSeed: undefined;
     rescalePositions: undefined;
-    enableRightClickRepulsion: boolean;
+    attribution: string;
 };
 export declare const hoveredPointRingOpacity = 0.7;
 export declare const focusedPointRingOpacity = 0.95;
-export declare const defaultScaleToZoom = 3;

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@cosmos.gl/graph",
-  "version": "3.0.0-beta.5",
+  "version": "3.0.0-beta.7",
   "description": "GPU-based force graph layout and rendering",
   "jsdelivr": "dist/index.min.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "MIT",
-  "repository": "git://github.com/cosmos.gl/graph.git",
+  "repository": "git://github.com/cosmosgl/graph.git",
   "type": "module",
   "files": [
     "dist",
@@ -35,7 +35,7 @@
   "homepage": "https://cosmosgl.github.io/graph",
   "author": "cosmos.gl",
   "devDependencies": {
-    "@interacta/css-labels": "^0.1.2",
+    "@interacta/css-labels": "^0.6.0",
     "@jls-digital/storybook-addon-code": "^1.0.4",
     "@storybook/addon-essentials": "^8.4.5",
     "@storybook/addon-interactions": "^8.4.5",