@cosmos.gl/graph 2.5.0 → 2.6.1

package/dist/config.d.ts

@@ -1,6 +1,6 @@
 import { D3ZoomEvent } from 'd3-zoom';
 import { D3DragEvent } from 'd3-drag';
-import { Hovered } from './modules/Store';
+import { type Hovered } from '@/graph/modules/Store';
 export interface GraphConfigInterface {
     /**
      * If set to `false`, the simulation will not run.
@@ -27,13 +27,15 @@ export interface GraphConfigInterface {
      * in the format `[red, green, blue, alpha]` where each value is a number between 0 and 255.
      * Default value: '#b3b3b3'
      */
+    pointDefaultColor?: string | [number, number, number, number];
+    /** @deprecated Use `pointDefaultColor` instead */
     pointColor?: string | [number, number, number, number];
     /**
      * The color to use for points when they are greyed out (when selection is active).
      * This can be either a hex color string (e.g., '#b3b3b3') or an array of RGBA values
      * in the format `[red, green, blue, alpha]` where each value is a number between 0 and 255.
      *
-     * If not provided, the color will be the same as the `pointColor`,
+     * If not provided, the color will be the same as the point's original color,
      * but darkened or lightened depending on the background color.
      *
      * If `pointGreyoutOpacity` is also defined, it will override the alpha/opacity component
@@ -114,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.
@@ -545,6 +549,7 @@ export declare class GraphConfig implements GraphConfigInterface {
     backgroundColor: string;
     spaceSize: number;
     pointColor: string;
+    pointDefaultColor: undefined;
     pointGreyoutOpacity: undefined;
     pointGreyoutColor: undefined;
     pointSize: number;
@@ -557,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/helper.d.ts

@@ -1,5 +1,5 @@
-import { default as regl } from 'regl';
-import { default as DOMPurify } from 'dompurify';
+import regl from 'regl';
+import 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;

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { GraphConfig, GraphConfigInterface } from './config';
-import { GraphData } from './modules/GraphData';
+import 'd3-transition';
+import { GraphConfig, GraphConfigInterface } from '@/graph/config';
+import { GraphData } from '@/graph/modules/GraphData';
 export declare class Graph {
     config: GraphConfig;
     graph: GraphData;
@@ -237,6 +238,24 @@ export declare class Graph {
      * Example: `new Float32Array([1, 0.4, 0.3])` sets the force coefficient for point 0 to 1, point 1 to 0.4, and point 2 to 0.3.
      */
     setPointClusterStrength(clusterStrength: Float32Array): void;
+    /**
+     * Sets which points are pinned (fixed) in position.
+     *
+     * 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.
      *