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

package/README.md

@@ -75,6 +75,25 @@ graph.render()
 
 ---
 
+### What's New in v3.0?
+
+cosmos.gl v3.0 brings a new rendering engine, async initialization, and several new features:
+
+- **luma.gl (WebGL 2)** — rendering ported from regl to [luma.gl](https://luma.gl/), with support for sharing a custom `Device` across multiple graphs via `new Graph(div, config, devicePromise)`.
+- **Async initialization** — the constructor returns immediately; all public methods queue until the device is ready. Use `graph.ready` / `graph.isReady` to know when the graph is usable.
+- **Simulation control** — rendering is now separate from simulation. The simulation starts automatically by default; use `start()`, `stop()`, `pause()`, and `unpause()` to control it independently.
+- **Link sampling** — sample visible links on screen with `getSampledLinks()` and `getSampledLinkPositionsMap()` for rendering labels or overlays along links.
+- **Context menu support** — new callbacks for right-click interactions: `onContextMenu`, `onPointContextMenu`, `onLinkContextMenu`, `onBackgroundContextMenu`.
+- **Fit viewport to points** — `setZoomTransformByPointPositions()` zooms and pans to fit a set of points into view.
+- **Hover improvements** — `onPointMouseOver` now includes an `isSelected` parameter; hover correctly highlights the topmost point when points overlap.
+- **Config API changes** — `setConfig()` now resets all values to defaults before applying; use the new `setConfigPartial()` to update individual properties without resetting the rest.
+- **Init-only config fields** — `enableSimulation`, `initialZoomLevel`, `randomSeed`, and `attribution` can only be set during initialization and are preserved across config updates.
+- **Default point shape** — new `pointDefaultShape` config property lets you set the fallback shape for all points when no per-point shapes are provided. Accepts a `PointShape` enum value (e.g., `PointShape.Star`), a plain number (e.g., `6`), or a numeric string (e.g., `"6"`).
+- **Exported defaults** — `defaultConfigValues` is now part of the public API.
+- **Optimized hover detection** — skips GPU work when the mouse hasn't moved.
+
+Check the [Migration Guide](./migration-notes.md) for upgrading from v2.
+
 ### What's New in v2.0?
 
 cosmos.gl v2.0 introduces significant improvements in performance and data handling:
@@ -86,7 +105,7 @@ cosmos.gl v2.0 introduces significant improvements in performance and data handl
 - New Point Clustering force (`setPointClusters`, `setClusterPositions` and `setPointClusterStrength`).
 - Ability to drag points.
 
-Check the [Migration Guide](./cosmos-2-0-migration-notes.md) for details.
+Check the [Migration Guide](./migration-notes.md) for upgrading from v1.
 
 ---
 
@@ -116,7 +135,7 @@ Check the [Migration Guide](./cosmos-2-0-migration-notes.md) for details.
 - 🧑‍💻 [Quick Start](https://cosmosgl.github.io/graph/?path=/docs/welcome-to-cosmos--docs)
 - 🛠 [Configuration](https://cosmosgl.github.io/graph/?path=/docs/configuration--docs)
 - ⚙️ [API Reference](https://cosmosgl.github.io/graph/?path=/docs/api-reference--docs)
-- 🚀 [Migration Guide](https://github.com/cosmosgl/graph/blob/main/cosmos-2-0-migration-notes.md)
+- 🚀 [Migration Guide](https://github.com/cosmosgl/graph/blob/main/migration-notes.md)
 
 ---
 

package/dist/config.d.ts

@@ -1,54 +1,54 @@
 import { D3ZoomEvent } from 'd3-zoom';
 import { D3DragEvent } from 'd3-drag';
 import { Hovered } from './modules/Store';
+import { PointShape } from './modules/GraphData';
 export interface GraphConfigInterface {
     /**
      * If set to `false`, the simulation will not run.
      * This property will be applied only on component initialization and it
-     * can't be changed using the `setConfig` method.
+     * can't be changed using the `setConfig` or `setConfigPartial` methods.
      * Default value: `true`
      */
-    enableSimulation?: boolean;
+    enableSimulation: boolean;
     /**
      * Canvas background color.
      * Can be either a hex color string (e.g., '#b3b3b3') or an array of RGBA values.
      * Default value: '#222222'
      */
-    backgroundColor?: string | [number, number, number, number];
+    backgroundColor: string | [number, number, number, number];
     /**
-     * Simulation space size (max 8192).
-     * Default value: `8192`
+     * Simulation space size.
+     * Default value: `4096` (larger values may crash on some devices, e.g. iOS; see https://github.com/cosmosgl/graph/issues/203).
      */
-    spaceSize?: number;
+    spaceSize: number;
     /**
      * The default color to use for points when no point colors are provided,
      * or if the color value in the array is `undefined` or `null`.
      * 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.
+     * in the format `[red, green, blue, alpha]` where each value is a number between 0 and 1.
      * Default value: '#b3b3b3'
      */
-    pointDefaultColor?: string | [number, number, number, number];
-    /** @deprecated Use `pointDefaultColor` instead */
-    pointColor?: string | [number, number, number, number];
+    pointDefaultColor: 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.
+     * in the format `[red, green, blue, alpha]` where each value is a number between 0 and 1.
      *
      * 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
+     * If `pointGreyoutOpacity` is also defined, it will be multiplied with the final alpha
      * of this color.
      *
      * Default value: `undefined`
      */
     pointGreyoutColor?: string | [number, number, number, number];
     /**
-     * Opacity value for points when they are greyed out (when selection is active).
+     * Opacity multiplier for points when they are greyed out (when selection is active).
      * Values range from 0 (completely transparent) to 1 (fully opaque).
      *
-     * If defined, this value will override the alpha/opacity component of `pointGreyoutColor`.
+     * When defined, this value is multiplied with the point's final alpha instead of the
+     * default `pointOpacity`. When `undefined`, greyed-out points use `pointOpacity` as their multiplier.
      *
      * Default value: `undefined`
      */
@@ -58,48 +58,53 @@ export interface GraphConfigInterface {
      * if the size value in the array is `undefined` or `null`.
      * Default value: `4`
     */
-    pointDefaultSize?: number;
-    /** @deprecated Use `pointDefaultSize` instead */
-    pointSize?: number;
+    pointDefaultSize: number;
+    /**
+     * The default shape to use for points when no point shapes are provided via `setPointShapes()`,
+     * or if the shape value in the array is `undefined`, `null`, or invalid.
+     * Accepts a `PointShape` enum value (e.g., `PointShape.Circle`), a plain number (e.g., `2`), or a numeric string (e.g., `"2"`).
+     * Default value: `PointShape.Circle`
+     */
+    pointDefaultShape: PointShape | `${PointShape}`;
     /**
      * Universal opacity value applied to all points.
      * This value multiplies with individual point alpha values (if set via setPointColors).
      * Useful for dynamically controlling opacity of all points without updating individual RGBA arrays.
      * Default value: `1.0`
      */
-    pointOpacity?: number;
+    pointOpacity: number;
     /**
      * Scale factor for the point size.
      * Default value: `1`
      */
-    pointSizeScale?: number;
+    pointSizeScale: number;
     /**
      * Cursor style to use when hovering over a point
      * Default value: `auto`
      */
-    hoveredPointCursor?: string;
+    hoveredPointCursor: string;
     /**
      * Cursor style to use when hovering over a link
      * Default value: `auto`
      */
-    hoveredLinkCursor?: string;
+    hoveredLinkCursor: string;
     /**
      * Turns ring rendering around a point on hover on / off
      * Default value: `false`
      */
-    renderHoveredPointRing?: boolean;
+    renderHoveredPointRing: boolean;
     /**
      * Hovered point ring color hex value.
      * Can be either a hex color string (e.g., '#b3b3b3') or an array of RGBA values.
      * Default value: `white`
      */
-    hoveredPointRingColor?: string | [number, number, number, number];
+    hoveredPointRingColor: string | [number, number, number, number];
     /**
      * Focused point ring color hex value.
      * Can be either a hex color string (e.g., '#b3b3b3') or an array of RGBA values.
      * Default value: `white`
      */
-    focusedPointRingColor?: string | [number, number, number, number];
+    focusedPointRingColor: string | [number, number, number, number];
     /**
      * Set focus on a point by index.  A ring will be highlighted around the focused point.
      * When set to `undefined`, no point is focused.
@@ -110,40 +115,36 @@ export interface GraphConfigInterface {
      * Turns link rendering on / off.
      * Default value: `true`
      */
-    renderLinks?: boolean;
+    renderLinks: boolean;
     /**
      * The default color to use for links when no link colors are provided,
      * or if the color value in the array is `undefined` or `null`.
      * This can be either a hex color string (e.g., '#666666') or an array of RGBA values
-     * in the format `[red, green, blue, alpha]` where each value is a number between 0 and 255.
+     * in the format `[red, green, blue, alpha]` where each value is a number between 0 and 1.
      * Default value: '#666666'
      */
-    linkDefaultColor?: string | [number, number, number, number];
-    /** @deprecated Use `linkDefaultColor` instead */
-    linkColor?: string | [number, number, number, number];
+    linkDefaultColor: string | [number, number, number, number];
     /**
      * Universal opacity value applied to all links.
      * This value multiplies with individual link alpha values (if set via setLinkColors).
      * Useful for dynamically controlling opacity of all links without updating individual RGBA arrays.
      * Default value: `1.0`
      */
-    linkOpacity?: number;
+    linkOpacity: number;
     /**
      * Greyed out link opacity value when the selection is active.
      * Default value: `0.1`
     */
-    linkGreyoutOpacity?: number;
+    linkGreyoutOpacity: number;
     /**
      * The default width value to use for links when no link widths are provided or if the width value in the array is `undefined` or `null`.
      * Default value: `1`
     */
-    linkDefaultWidth?: number;
-    /** @deprecated Use `linkDefaultWidth` instead */
-    linkWidth?: number;
+    linkDefaultWidth: number;
     /**
      * The color to use for links when they are hovered.
      * This can be either a hex color string (e.g., '#ff3333') or an array of RGBA values
-     * in the format `[red, green, blue, alpha]` where each value is a number between 0 and 255.
+     * in the format `[red, green, blue, alpha]` where each value is a number between 0 and 1.
      * Default value: `undefined`
      */
     hoveredLinkColor?: string | [number, number, number, number];
@@ -152,51 +153,49 @@ export interface GraphConfigInterface {
      * The hovered width is calculated as: originalWidth + hoveredLinkWidthIncrease
      * Default value: `5`
      */
-    hoveredLinkWidthIncrease?: number;
+    hoveredLinkWidthIncrease: number;
     /**
      * Scale factor for the link width.
      * Default value: `1`
      */
-    linkWidthScale?: number;
+    linkWidthScale: number;
     /**
      * Increase or decrease the size of the links when zooming in or out.
      * Default value: `false`
      */
-    scaleLinksOnZoom?: boolean;
+    scaleLinksOnZoom: boolean;
     /**
      * If set to true, links are rendered as curved lines.
      * Otherwise as straight lines.
      * Default value: `false`
      */
-    curvedLinks?: boolean;
+    curvedLinks: boolean;
     /**
      * Number of segments in a curved line.
      * Default value: `19`.
      */
-    curvedLinkSegments?: number;
+    curvedLinkSegments: number;
     /**
      * Weight affects the shape of the curve.
      * Default value: `0.8`.
      */
-    curvedLinkWeight?: number;
+    curvedLinkWeight: number;
     /**
      * Defines the position of the control point of the curve on the normal from the centre of the line.
      * If set to 1 then the control point is at a distance equal to the length of the line.
      * Default value: `0.5`
      */
-    curvedLinkControlPointDistance?: number;
+    curvedLinkControlPointDistance: number;
     /**
      * The default link arrow value that controls whether or not to display link arrows.
      * Default value: `false`
      */
-    linkDefaultArrows?: boolean;
-    /** @deprecated Use `linkDefaultArrows` instead */
-    linkArrows?: boolean;
+    linkDefaultArrows: boolean;
     /**
      * Scale factor for the link arrows size.
      * Default value: `1`
      */
-    linkArrowsSizeScale?: number;
+    linkArrowsSizeScale: number;
     /**
      * The range defines the minimum and maximum link visibility distance in pixels.
      * The link will be fully opaque when its length is less than the first number in the array,
@@ -206,77 +205,77 @@ export interface GraphConfigInterface {
      * (e.g. links become longer when you zoom in, and shorter when you zoom out).
      * Default value: `[50, 150]`
      */
-    linkVisibilityDistanceRange?: number[];
+    linkVisibilityDistanceRange: number[];
     /**
      * The transparency value that the link will have when its length reaches
      * the maximum link distance value from `linkVisibilityDistanceRange`.
      * Default value: `0.25`
      */
-    linkVisibilityMinTransparency?: number;
+    linkVisibilityMinTransparency: number;
     /**
      * Decay coefficient. Use smaller values if you want the simulation to "cool down" slower.
      * Default value: `5000`
      */
-    simulationDecay?: number;
+    simulationDecay: number;
     /**
    * Gravity force coefficient.
    * Default value: `0.25`
    */
-    simulationGravity?: number;
+    simulationGravity: number;
     /**
      * Centering to center mass force coefficient.
      * Default value: `0`
      */
-    simulationCenter?: number;
+    simulationCenter: number;
     /**
      * Repulsion force coefficient.
      * Default value: `1.0`
      */
-    simulationRepulsion?: number;
+    simulationRepulsion: number;
     /**
      * Decreases / increases the detalization of the Many-Body force calculations.
      * Default value: `1.15`
      */
-    simulationRepulsionTheta?: number;
+    simulationRepulsionTheta: number;
     /**
      * Link spring force coefficient.
      * Default value: `1`
      */
-    simulationLinkSpring?: number;
+    simulationLinkSpring: number;
     /**
      * Minimum link distance.
      * Default value: `10`
      */
-    simulationLinkDistance?: number;
+    simulationLinkDistance: number;
     /**
      * Range of random link distance values.
      * Default value: `[1, 1.2]`
      */
-    simulationLinkDistRandomVariationRange?: number[];
+    simulationLinkDistRandomVariationRange: number[];
     /**
      * Repulsion coefficient from mouse position.
      * The repulsion force is activated by pressing the right mouse button.
      * Default value: `2`
      */
-    simulationRepulsionFromMouse?: number;
+    simulationRepulsionFromMouse: number;
     /**
      * Enable or disable the repulsion force from mouse when right-clicking.
      * When set to `true`, holding the right mouse button will activate the mouse repulsion force.
      * When set to `false`, right-clicking will not trigger any repulsion force.
      * Default value: `false`
      */
-    enableRightClickRepulsion?: boolean;
+    enableRightClickRepulsion: boolean;
     /**
      * Friction coefficient.
      * Values range from 0 (high friction, stops quickly) to 1 (no friction, keeps moving).
      * Default value: `0.85`
      */
-    simulationFriction?: number;
+    simulationFriction: number;
     /**
      * Cluster coefficient.
      * Default value: `0.1`
      */
-    simulationCluster?: number;
+    simulationCluster: number;
     /**
      * Callback function that will be called when the simulation starts.
      * Default value: `undefined`
@@ -301,12 +300,6 @@ export interface GraphConfigInterface {
      * Default value: `undefined`
      */
     onSimulationPause?: () => void;
-    /**
-     * Callback function that will be called when the simulation is restarted.
-     * @deprecated Use `onSimulationUnpause` instead. This callback will be removed in a future version.
-     * Default value: `undefined`
-     */
-    onSimulationRestart?: () => void;
     /**
      * Callback function that will be called when the simulation is unpaused.
      * Default value: `undefined`
@@ -461,64 +454,67 @@ export interface GraphConfigInterface {
      * Show WebGL performance monitor.
      * Default value: `false`
      */
-    showFPSMonitor?: boolean;
+    showFPSMonitor: boolean;
     /**
      * Pixel ratio for the canvas. Higher values use more GPU memory but provide better quality on high-DPI displays.
      * Default value: `window.devicePixelRatio || 2`
      */
-    pixelRatio?: number;
+    pixelRatio: number;
     /**
      * Increase or decrease the size of the points when zooming in or out.
      * Default value: `false`
      */
-    scalePointsOnZoom?: boolean;
+    scalePointsOnZoom: boolean;
     /**
-     * Initial zoom level. Can be set once during graph initialization.
+     * Initial zoom level. This property will be applied only on component initialization and it
+     * can't be changed using the `setConfig` or `setConfigPartial` methods.
      * If set, `fitViewOnInit` value will be ignored.
      * Default value: `undefined`
      */
     initialZoomLevel?: number;
     /**
      * Enables or disables zooming in and out.
-     * Default: `true`
+     * Default value: `true`
      */
-    enableZoom?: boolean;
+    enableZoom: boolean;
     /**
-     * Controls whether the simulation remains active during zoom operations.
+     * Controls whether the simulation remains active during interactive (user-driven) zoom operations.
      * When set to `true`, the simulation continues running while zooming.
      * When set to `false`, the simulation pauses during zoom operations.
+     * Programmatic zoom methods (e.g., `zoomToPointByIndex`, `fitView`) default to running the simulation
+     * regardless of this setting, but can be controlled via their `enableSimulation` parameter.
      * Default value: `false`
      */
-    enableSimulationDuringZoom?: boolean;
+    enableSimulationDuringZoom: boolean;
     /**
      * Enables or disables dragging of points in the graph.
      * Default value: `false`
      */
-    enableDrag?: boolean;
+    enableDrag: boolean;
     /**
      * Whether to center and zoom the view to fit all points in the scene on initialization or not.
      * Ignored if `initialZoomLevel` is set.
      * Default: `true`
      */
-    fitViewOnInit?: boolean;
+    fitViewOnInit: boolean;
     /**
      * Delay in milliseconds before fitting the view when `fitViewOnInit` is enabled.
      * Useful if you want the layout to stabilize a bit before fitting.
      * Default: `250`
      */
-    fitViewDelay?: number;
+    fitViewDelay: number;
     /**
      * Padding to apply when fitting the view to show all points.
-     * This value is added to the calculated bounding box to provide some extra space around the points.
+     * This value should be between 0 and 1, and is added to the calculated bounding box to provide some extra space around the points.
      * This is used when the `fitViewOnInit` option is enabled.
      * Default: `0.1`
      */
-    fitViewPadding?: number;
+    fitViewPadding: number;
     /**
      * Duration in milliseconds for fitting the view to show all points when fitViewOnInit is enabled.
      * Default: `250`
      */
-    fitViewDuration?: number;
+    fitViewDuration: number;
     /**
      * When `fitViewOnInit` is set to `true`, fits the view to show the points within a rectangle
      * defined by its two corner coordinates `[[left, bottom], [right, top]]` in the scene space.
@@ -536,16 +532,22 @@ export interface GraphConfigInterface {
      * the randomness of the layout across different simulation runs.
      * It is useful when you want the graph to always look the same on same datasets.
      * This property will be applied only on component initialization and it
-     * can't be changed using the `setConfig` method.
+     * can't be changed using the `setConfig` or `setConfigPartial` methods.
      * Default value: undefined
      */
     randomSeed?: number | string;
     /**
      * Point sampling distance in pixels between neighboring points when calling the `getSampledPointPositionsMap` method.
      * This parameter determines how many points will be included in the sample.
-     * Default value: `150`
+     * Default value: `100`
     */
-    pointSamplingDistance?: number;
+    pointSamplingDistance: number;
+    /**
+     * Link sampling distance in pixels between neighboring links when calling the `getSampledLinks` method.
+     * This parameter determines how many links will be included in the sample (based on link midpoints in screen space).
+     * Default value: `100`
+     */
+    linkSamplingDistance: number;
     /**
      * Controls automatic position adjustment of points in the visible space.
      *
@@ -557,108 +559,54 @@ export interface GraphConfigInterface {
      * When explicitly set:
      * - `true`: Forces points positions to be rescaled
      * - `false`: Forces points positions to not be rescaled
+     *
+     * Default value: `undefined`
      */
     rescalePositions?: boolean | undefined;
     /**
      * Controls the text shown in the bottom right corner.
      * - When a non-empty string is provided: Displays the string as HTML
      * - When empty string or not provided: No text is displayed
+     *
+     * This property is applied only on component initialization and
+     * can't be changed using the `setConfig` or `setConfigPartial` methods.
+     *
+     * Default value: `''`
      */
-    attribution?: string;
-}
-export declare class GraphConfig implements GraphConfigInterface {
-    enableSimulation: boolean;
-    backgroundColor: string;
-    spaceSize: number;
-    pointColor: string;
-    pointDefaultColor: undefined;
-    pointGreyoutOpacity: undefined;
-    pointGreyoutColor: undefined;
-    pointSize: number;
-    pointDefaultSize: undefined;
-    pointOpacity: number;
-    pointSizeScale: number;
-    hoveredPointCursor: string;
-    hoveredLinkCursor: string;
-    renderHoveredPointRing: boolean;
-    hoveredPointRingColor: string;
-    focusedPointRingColor: string;
-    focusedPointIndex: undefined;
-    linkColor: string;
-    linkDefaultColor: undefined;
-    linkOpacity: number;
-    linkGreyoutOpacity: number;
-    linkWidth: number;
-    linkDefaultWidth: undefined;
-    linkWidthScale: number;
-    hoveredLinkColor: undefined;
-    hoveredLinkWidthIncrease: number;
-    renderLinks: boolean;
-    curvedLinks: boolean;
-    curvedLinkSegments: number;
-    curvedLinkWeight: number;
-    curvedLinkControlPointDistance: number;
-    linkArrows: boolean;
-    linkDefaultArrows: undefined;
-    linkArrowsSizeScale: number;
-    scaleLinksOnZoom: boolean;
-    linkVisibilityDistanceRange: number[];
-    linkVisibilityMinTransparency: number;
-    simulationDecay: number;
-    simulationGravity: number;
-    simulationCenter: number;
-    simulationRepulsion: number;
-    simulationRepulsionTheta: number;
-    simulationLinkSpring: number;
-    simulationLinkDistance: number;
-    simulationLinkDistRandomVariationRange: number[];
-    simulationRepulsionFromMouse: number;
-    enableRightClickRepulsion: boolean;
-    simulationFriction: number;
-    simulationCluster: number;
-    onSimulationStart: GraphConfigInterface['onSimulationStart'];
-    onSimulationTick: GraphConfigInterface['onSimulationTick'];
-    onSimulationEnd: GraphConfigInterface['onSimulationEnd'];
-    onSimulationPause: GraphConfigInterface['onSimulationPause'];
-    onSimulationRestart: GraphConfigInterface['onSimulationRestart'];
-    onSimulationUnpause: GraphConfigInterface['onSimulationUnpause'];
-    onClick: GraphConfigInterface['onClick'];
-    onPointClick: GraphConfigInterface['onPointClick'];
-    onLinkClick: GraphConfigInterface['onLinkClick'];
-    onBackgroundClick: GraphConfigInterface['onBackgroundClick'];
-    onContextMenu: GraphConfigInterface['onContextMenu'];
-    onPointContextMenu: GraphConfigInterface['onPointContextMenu'];
-    onLinkContextMenu: GraphConfigInterface['onLinkContextMenu'];
-    onBackgroundContextMenu: GraphConfigInterface['onBackgroundContextMenu'];
-    onMouseMove: GraphConfigInterface['onMouseMove'];
-    onPointMouseOver: GraphConfigInterface['onPointMouseOver'];
-    onPointMouseOut: GraphConfigInterface['onPointMouseOut'];
-    onLinkMouseOver: GraphConfigInterface['onLinkMouseOver'];
-    onLinkMouseOut: GraphConfigInterface['onLinkMouseOut'];
-    onZoomStart: GraphConfigInterface['onZoomStart'];
-    onZoom: GraphConfigInterface['onZoom'];
-    onZoomEnd: GraphConfigInterface['onZoomEnd'];
-    onDragStart: GraphConfigInterface['onDragStart'];
-    onDrag: GraphConfigInterface['onDrag'];
-    onDragEnd: GraphConfigInterface['onDragEnd'];
-    showFPSMonitor: boolean;
-    pixelRatio: number;
-    scalePointsOnZoom: boolean;
-    initialZoomLevel: undefined;
-    enableZoom: boolean;
-    enableSimulationDuringZoom: boolean;
-    enableDrag: boolean;
-    fitViewOnInit: boolean;
-    fitViewDelay: number;
-    fitViewPadding: number;
-    fitViewDuration: number;
-    fitViewByPointsInRect: undefined;
-    fitViewByPointIndices: undefined;
-    randomSeed: undefined;
-    pointSamplingDistance: number;
     attribution: string;
-    rescalePositions: undefined;
-    init(config: GraphConfigInterface): void;
-    deepMergeConfig<T>(current: T, next: T, key: keyof T): void;
-    private getConfig;
 }
+/**
+ * Requires all keys from T to be present, while preserving
+ * the original value types (including `| undefined` for optional properties).
+ */
+export type Complete<T> = {
+    [K in keyof Required<T>]: T[K];
+};
+/**
+ * Configuration options for the Graph constructor and `setConfig()` method.
+ * All properties are optional — any omitted properties will use their default values.
+ *
+ * Note: calling `setConfig()` fully resets the configuration to defaults before
+ * applying the provided values. Properties not included in the call will revert
+ * to their defaults, not retain their previous values.
+ */
+export type GraphConfig = Partial<GraphConfigInterface>;
+/** Returns a fresh copy of `defaultConfigValues` with arrays cloned to prevent shared references. */
+export declare function createDefaultConfig(): GraphConfigInterface;
+/**
+ * Resets the config object to default values in place, preserving the object reference
+ * so that modules (Zoom, Store, etc.) that hold a reference to it stay in sync.
+ */
+export declare function resetConfigToDefaults(target: GraphConfigInterface): void;
+/**
+ * Applies only the provided `source` values onto `target`, leaving all other
+ * properties unchanged.
+ *
+ * Mutates `target` in place (via `Object.assign`) rather than replacing it,
+ * because multiple modules (Zoom, Store, etc.) hold a reference to the same config object.
+ *
+ * - When `useDefaultsForUndefined` is `false` (default): explicit `undefined` values in `source` are skipped.
+ * - When `useDefaultsForUndefined` is `true`: explicit `undefined` values are replaced with their defaults.
+ * - Array values are shallow-cloned to prevent shared references.
+ */
+export declare function applyConfig(target: GraphConfigInterface, source: GraphConfig, useDefaultsForUndefined?: boolean): void;