@neo4j-nvl/base 1.2.0-e691fdb4 → 1.2.0-ec100981

package/dist/types/modules/dataset.d.ts

@@ -8,6 +8,7 @@ export interface DataSet<T> {
     idToPosition: Record<string, Node & Point>;
     idToHtmlOverlay?: Record<string, HTMLElement>;
     version: number;
+    maxDimension: number;
     addChannel: (this: DataSet<T>, channelName: string) => void;
     removeChannel: (this: DataSet<T>, channelName: string) => void;
     clearChannel: (this: DataSet<T>, channelName: string) => void;
@@ -29,7 +30,8 @@ export interface Channel<T> {
     updates: Record<string, T>;
     removes: Record<string, T>;
 }
-export declare const getHtmlProperty: (item: Partial<Node | Relationship>) => HTMLElement | undefined;
+export declare const getHtmlKey: (item: Node | Relationship) => "html" | "captionHtml";
+export declare const getHtmlProperty: (item: Node | Relationship) => HTMLElement | undefined;
 /**
  * Creates an empty dataset in which a graph be stored and updated using mobx actions.
  * @returns A new and empty {@link DataSet}.

package/dist/types/modules/state/types.d.ts

@@ -43,13 +43,26 @@ export interface ForceDirectedOptions {
      */
     intelWorkaround?: boolean;
     /**
-     * @deprecated This option will be removed in a future release. For small datasets, use the d3Force layout instead.
-     * Whether to enable automatic switching to CoseBilkent layout for small graphs.
-     * When enabled, small graphs will automatically use the CoseBilkent layout algorithm
-     * which can provide better initial positioning for smaller datasets.
-     * @defaultValue true
+     * How initial node positions are seeded before the physics simulation runs.
+     * @defaultValue 'box'
+     */
+    seedingMethod?: 'box' | 'circle';
+    /**
+     * @experimental
+     * Milliseconds of synchronous physics simulation to run before the layout is first rendered.
+     * Precompute stops early if the simulation stabilizes before the time budget is reached.
+     * @defaultValue 0
+     * @note Blocks the main thread, so use sparingly. Will be capped at 1000.
      */
-    enableCytoscape?: boolean;
+    precomputeMs?: number;
+    /**
+     * Optional function to group nodes into physical clusters based on a custom identifier.
+     * Nodes returning the same string or number will be grouped together in the layout.
+     * Nodes returning undefined will be treated as independent.
+     *
+     * @note Ensure this function has a stable reference to avoid evaluation on every render.
+     */
+    clusterBy?: (nodeId: string) => string | number | undefined;
 }
 /**
  * The options for the hierarchical layout
@@ -224,17 +237,23 @@ export interface NvlOptions {
         minimapViewportBoxColor?: string;
     };
     /**
-     * @internal
-     * @hidden
-     * Defines a time limit in ms for how long layout iterations may run
-     * before yielding to the renderer.
-     * Higher values let layout stabilisation complete faster
-     * at the cost of less frequent rendering during stabilisation.
-     * Lower values keep rendering smoother at the cost of slower layout movement.
+     * Target minimum presentation fps while layout is active, at the cost of stabilization speed when set higher.
+     * Budgets layout steps only. Actual fps may undershoot when rendering is expensive.
+     *
+     * @defaultValue 3
+     *
+     * @note Will be capped between 1 and 120.
+     */
+    minFps?: number;
+    /**
+     * Target maximum presentation fps while layout is active; extra time in the tick goes to layout stabilization.
+     * Budgets layout steps only. Actual fps may undershoot when rendering is expensive.
+     *
+     * @defaultValue 30
      *
-     * @defaultValue 300
+     * @note Will be capped between 1 and 120.
      */
-    layoutTimeLimit?: number;
+    maxFps?: number;
     /**
      * Disables tracking of library usage
      * @defaultValue false

package/dist/types/renderers/domrenderer/canvasrenderer/arrowDrawing.d.ts

@@ -18,20 +18,6 @@ export declare const calculateLabelDimensions: (fullCaption: string, measureWidt
     label: string;
     width: number;
 };
-/**
- * Calculate label transform including rotation and flip adjustments.
- *
- * @param angle - The base rotation angle in radians
- * @param fontSize - The font size in pixels (including pixel ratio scaling)
- * @param flip - Whether to flip the label (applies additional rotation)
- * @param point - The base point (used to calculate offset in flip case)
- * @returns object with final position and angle
- */
-export declare const calculateLabelTransform: (angle: number, fontSize: number, flip: boolean, point: Point) => {
-    finalX: number;
-    finalY: number;
-    finalAngle: number;
-};
 /**
  * Calculate vertical alignment offset for label based on caption alignment.
  *
@@ -55,7 +41,7 @@ export declare const calculateLabelHeightAlign: (captionAlign: string, fontSize:
  * @param flip - Whether the label is flipped
  * @returns object with position, rotation, width, and height for hit detection
  */
-export declare const calculateLabelGeometry: (point: Point, angle: number, maxWidth: number, fontSize: number, heightAlign: number, padding: number, pixelRatio: number, flip: boolean) => {
+export declare const calculateLabelGeometry: (point: Point, angle: number, maxWidth: number, fontSize: number, heightAlign: number, padding: number, pixelRatio: number) => {
     position: {
         x: number;
         y: number;
@@ -164,5 +150,5 @@ export declare const drawLoop: (ctx: CanvasRenderingContext2D, fromPoint: Point,
  * @param fontColor - The font color to use
  * @param flip - Whether to flip the label orientation (default false)
  */
-export declare const drawLabel: (ctx: CanvasRenderingContext2D, point: Point, angle: number, maxWidth: number, rel: Relationship, bundle: ArrowBundle, disabledItemStyles: DisabledItemStyles, fontColor: string, flip?: boolean) => void;
+export declare const drawLabel: (ctx: CanvasRenderingContext2D, point: Point, angle: number, maxWidth: number, rel: Relationship, bundle: ArrowBundle, disabledItemStyles: DisabledItemStyles, fontColor: string) => void;
 export {};

package/dist/types/renderers/domrenderer/shared/ImageCache.d.ts

@@ -4,6 +4,7 @@ declare class ImageCache {
     private readonly onImageLoadedCb?;
     constructor(onImageLoaded?: () => void);
     getImage(src: string, inverted?: boolean): HTMLCanvasElement;
+    isDrawn(src: string, inverted?: boolean): boolean;
     private getOrCreateEntry;
     private invertCanvas;
     private loadImage;

package/dist/types/renderers/domrenderer/shared/arrows/arrows.d.ts

@@ -44,12 +44,8 @@ export declare const getSelfArrowControlPoints: (rel: Relationship, node: Node,
     };
     nodeGap: number;
 };
-/**
- * Calculates position, angle and flip for a self-referencing relationship label.
- * Used by both Canvas and SVG renderers to ensure consistent positioning.
- * This function handles all the math internally including headAngle and headSelectedAdjustment calculations.
- */
-export declare const getSelfArrowLabelPosition: (apexPoint: Point, angle: number, endPoint: Point, control2Point: Point, isSelected: boolean, selectionRings: BorderStyle["rings"], relWidth?: number) => {
+/** Calculates anchor position and readable rotation for a self-referencing relationship label. */
+export declare const getSelfArrowLabelPosition: (apexPoint: Point, angle: number, endPoint: Point, control2Point: Point, isSelected: boolean, selectionRings: BorderStyle["rings"], relWidth?: number, captionSize?: number) => {
     x: number;
     y: number;
     angle: number;
@@ -173,3 +169,5 @@ export declare const getOverlayIconAlignment: (position: [number, number], width
     widthAlign: number;
     heightAlign: number;
 };
+/** Vertical offset for a self-loop caption; `top`/`bottom` mean outside/inside the loop. */
+export declare const getSelfLoopHeightAlign: (captionAlign: string, fontSize: number, lineWidth: number, padding: number, flip: 1 | -1) => number;

package/dist/types/renderers/webglrenderer/Controller.d.ts

@@ -10,8 +10,10 @@ export interface ControllerInterface {
     stateDisposers: NvlState['autorun'][];
     state: NvlState;
     needsToRun: () => boolean;
-    renderMainScene: (positionArray: Node[]) => void;
-    renderMinimap: (positionArray: Node[]) => void;
+    renderMainScene: (positionArray: Node[], positionsChanged?: boolean) => void;
+    renderMainSceneFromTexture: (positionTexture: WebGLTexture) => void;
+    setPositionTexelIndices: (map: Readonly<Record<string, number>> | null) => void;
+    renderMinimap: (positionArray: Node[], positionsChanged?: boolean) => void;
     checkForUpdates: (nodes: DataSet<Node>, rels: DataSet<Relationship>) => void;
     onResize: () => void;
     updateMainViewport: (zoom: number, panX: number, panY: number) => void;
@@ -34,8 +36,24 @@ export default class Controller implements ControllerInterface {
         state?: NvlState;
     });
     needsToRun(): boolean;
-    renderMainScene(positionArray: Node[]): void;
-    renderMinimap(positionArray: Node[]): void;
+    renderMainScene(positionArray: Node[], positionsChanged?: boolean): void;
+    /**
+     * Renders the main scene from a GPU position texture instead of a
+     * CPU position array, avoiding the readback + upload round trip.
+     * @param positionTexture - Live GPU node-position texture to render from.
+     */
+    renderMainSceneFromTexture(positionTexture: WebGLTexture): void;
+    /**
+     * Sets the node-id -> texel-index map for the main scene renderer so it
+     * samples a shared position texture in the layout's order. Pass null to use
+     * insertion order.
+     * @param map - The node-id-to-texel-index map, or null.
+     *
+     * @note The minimap renders from its own CPU-uploaded texture and
+     * is left in insertion order.
+     */
+    setPositionTexelIndices(map: Readonly<Record<string, number>> | null): void;
+    renderMinimap(positionArray: Node[], positionsChanged?: boolean): void;
     checkForUpdates(nodes: DataSet<Node>, rels: DataSet<Relationship>): void;
     onResize(): void;
     updateMainViewport(zoom: number, panX: number, panY: number): void;
@@ -52,8 +70,10 @@ export declare class DummyController implements ControllerInterface {
     minimapMouseDown: boolean;
     stateDisposers: NvlState['autorun'][];
     state: NvlState;
-    renderMainScene(positionArray: Node[]): void;
-    renderMinimap(positionArray: Node[]): void;
+    renderMainScene(positionArray: Node[], positionsChanged?: boolean): void;
+    renderMainSceneFromTexture(positionTexture: WebGLTexture): void;
+    setPositionTexelIndices(map: Readonly<Record<string, number>> | null): void;
+    renderMinimap(positionArray: Node[], positionsChanged?: boolean): void;
     checkForUpdates(nodes: DataSet<Node>, rels: DataSet<Relationship>): void;
     onResize(): void;
     updateMainViewport(zoom: number, panX: number, panY: number): void;

package/dist/types/renderers/webglrenderer/IconLayerRegistry.d.ts

@@ -0,0 +1,14 @@
+export declare const MaxIconLayers = 256;
+/**
+ * Maps icon URLs to stable layer indices for a WebGL `sampler2DArray`.
+ * Delegates image loading and rasterization to {@link ImageCache}.
+ */
+export declare class IconLayerRegistry {
+    private readonly imageCache;
+    private readonly layerMap;
+    constructor(onImageLoaded?: () => void);
+    getLayer(url: string, inverted: boolean): number | null;
+    hasLoadingLayers(): boolean;
+    layerCount(): number;
+    getAvailableCanvases(): Map<number, HTMLCanvasElement>;
+}

package/dist/types/renderers/webglrenderer/IconLayerRegistry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/renderers/webglrenderer/Renderer.d.ts

@@ -2,11 +2,17 @@ import { mat4 } from 'gl-matrix';
 import type { DataSet } from '../../modules/dataset';
 import type { NvlState } from '../../modules/state/types';
 import type { Node, Relationship } from '../../types/graph-element';
+export type RendererOptions = {
+    enableIcons?: boolean;
+};
 export default class Renderer {
     private readonly nodeShader;
     private readonly nodeAnimShader;
     private readonly relShader;
+    private readonly arrowShader;
     private relDataBuffer;
+    private arrowDataBuffer;
+    private arrowData;
     private readonly viewportBoxShader;
     private readonly defaultRelColor;
     private readonly defaultNodeColor;
@@ -14,38 +20,73 @@ export default class Renderer {
     private readonly disableNodeColor;
     private readonly gl;
     activeNodes: Record<string, boolean>;
+    numActiveNodes: number;
     readonly canvas: HTMLCanvasElement;
     projection: mat4;
     private idToIndex;
+    /** Node-id → texel-index map for GPU-shared rendering; null falls back to insertion order. */
+    private texelIndexForId;
+    /** texelIndexForId value when vertex buffers were last built; used to detect changes in the texel-index mapping. */
+    private texelMapAtBuild;
+    private lastNodes;
+    private lastBundledRels;
+    private idToSize;
     private posBuffer;
+    private positionsDirty;
     private numRels;
     private numNodes;
     private nodeDataByte;
     private relIdToIndex;
     private relData;
     private viewportBoxBuffer;
+    private readonly viewportBoxVertices;
     private relBuffer;
+    private arrowBuffer;
     private nodeBuffer;
     private posTexture;
+    private iconTexture;
     private nodeVao;
     private relVao;
+    private arrowVao;
     private nodeAnimVao;
-    constructor(gl: WebGL2RenderingContext, nodes: DataSet<Node>, rels: DataSet<Relationship>, state: NvlState);
+    private readonly iconLayers;
+    private uploadedIconLayers;
+    private nodeColors;
+    private nodeDisabled;
+    constructor(gl: WebGL2RenderingContext, nodes: DataSet<Node>, rels: DataSet<Relationship>, state: NvlState, options?: RendererOptions);
     private setShaderUniforms;
     setData(data: {
         nodes: Node[];
         rels: Relationship[];
     }): void;
-    render(positionArray: Node[]): void;
+    /** Sets the texel-index map for GPU-shared rendering, or null for insertion order. */
+    setPositionTexelIndices(map: Readonly<Record<string, number>> | null): void;
+    /** Texel index for a node id; falls back to insertion index, or 0 if the id is unknown. */
+    private getTexelIndex;
+    /**
+     * Rebuilds vertex buffers when the texel-index mapping has changed since the last build.
+     */
+    private rebuildBuffersIfTexelMappingChanged;
+    render(positionArray: Node[], positionsChanged?: boolean): void;
+    /** Renders using a GPU position texture directly as `u_positions` */
+    renderFromGpuTexture(positionTexture: WebGLTexture): void;
+    private renderRelationships;
     renderViewbox(): void;
     updateNodes(updates: Node[]): void;
     updateRelationships(relItems: Relationship[]): void;
     private createPositionTexture;
+    private createIconTexture;
+    private uploadPendingIconLayers;
+    hasPendingIcons(): boolean;
     updateViewportBox(zoom: number, panX: number, panY: number, viewportWidth: number, viewportHeight: number): void;
     updateViewport(zoom: number, panX: number, panY: number): void;
     private setupViewportRendering;
+    private resolveNodeColor;
     private setupNodeRendering;
     private setupRelationshipRendering;
+    private setupArrowRendering;
+    private getRelBufferAttributes;
+    private updateEndpointSizesForNode;
     private renderAnimations;
     destroy(): void;
 }

package/dist/types/renderers/webglrenderer/node-animation-fragment.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "#version 300 es\nprecision lowp float;\n\nuniform mediump float u_zoom;\nuniform lowp float u_animPos;\nuniform mediump float u_glAdjust;\n\nin lowp vec4 color;\nin lowp float varNodeSize;\n\nout vec4 fragColor;\n\nmediump float circleSize = 0.50;\n\nvoid main(void) {\n\n  lowp float dist = distance(gl_PointCoord, vec2(0.5));\n\n  if (dist > 0.51) {\n    discard;\n  }\n  else {\n    lowp float alpha = 1.0 - smoothstep(circleSize - (1.0 / (varNodeSize * 2.0 * u_zoom * u_glAdjust)), circleSize, dist);\n    lowp float pulseAlpha = 0.9 - 0.9 * u_animPos;\n    fragColor = vec4(color.xyz, 1.0) * alpha * pulseAlpha;\n  }\n}\n";
+declare const _default: "#version 300 es\nprecision mediump float;\n\nuniform mediump float u_zoom;\nuniform lowp float u_animPos;\nuniform mediump float u_glAdjust;\n\nin lowp vec4 color;\nin mediump float varNodeSize;\n\nout vec4 fragColor;\n\nconst float pulseCircleEdge = 0.50;\n\nvoid main(void) {\n  float dist = distance(gl_PointCoord, vec2(0.5));\n\n  if (dist > 0.51) {\n    discard;\n  } else {\n    float alpha = 1.0 - smoothstep(pulseCircleEdge - (1.0 / (varNodeSize * 2.0 * u_zoom * u_glAdjust)), pulseCircleEdge, dist);\n    float pulseAlpha = 0.9 - 0.9 * u_animPos;\n    fragColor = vec4(color.xyz, 1.0) * alpha * pulseAlpha;\n  }\n}\n";
 export default _default;

package/dist/types/renderers/webglrenderer/node-animation-vertex.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "#version 300 es\nuniform mat4 u_projection;\nuniform sampler2D u_positions;\nuniform lowp float u_animPos;\nuniform mediump float u_zoom;\nuniform mediump float u_glAdjust;\n\nin float a_size;\nin lowp vec2 a_index;\nin lowp vec4 a_color;\nin lowp float a_active;\n\nout lowp float varNodeSize;\nout lowp vec4 color;\n\nvoid main(void) {\n  vec4 data = texture(u_positions, a_index);\n\n  gl_Position = u_projection * vec4(data.xy, 0.0, 1.0);\n\n  float nodeSize = a_size * u_zoom * u_glAdjust;\n  nodeSize = nodeSize * (0.4 / 0.5); // Remove extra space added for shadow and selection ring\n\n  gl_PointSize = a_active > 0.5\n    ? nodeSize + 0.88 * nodeSize * u_animPos\n    : 0.0;\n\n  color = a_color;\n  varNodeSize = a_size;\n}";
+declare const _default: "#version 300 es\nuniform mat4 u_projection;\nuniform sampler2D u_positions;\nuniform lowp float u_animPos;\nuniform mediump float u_zoom;\nuniform mediump float u_glAdjust;\n\nin float a_size;\nin highp vec2 a_index;\nin lowp vec4 a_color;\nin lowp float a_active;\n\nout mediump float varNodeSize;\nout lowp vec4 color;\n\nvoid main(void) {\n  vec4 data = texture(u_positions, a_index);\n\n  gl_Position = u_projection * vec4(data.xy, 0.0, 1.0);\n\n  float nodeSize = a_size * u_zoom * u_glAdjust;\n  nodeSize = nodeSize * 0.8;\n\n  gl_PointSize = a_active > 0.5\n    ? nodeSize + 0.88 * nodeSize * u_animPos\n    : 0.0;\n\n  color = a_color;\n  varNodeSize = a_size;\n}";
 export default _default;

package/dist/types/renderers/webglrenderer/node-fragment-point.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "#version 300 es\nprecision lowp float;\n\nuniform mediump float u_zoom;\nuniform mediump float u_glAdjust;\n\nin lowp vec4 color;\nin lowp float drawDefaultBorder;\nin lowp vec3 nodeBorderColor;\nin lowp vec3 selectedBorderColor;\nin lowp vec3 selectedInnerBorderColor;\nin lowp vec3 shadowColor;\nin lowp float selected;\nin lowp float hovered;\nin lowp float varNodeSize;\n\nout vec4 fragColor;\n\nmediump float circleSize = 0.40;\nmediump float defaultBoderSize = 0.42;\nmediump float innerSelectedRingSize = 0.43;\nmediump float outerSelectedRingSize = 0.47;\nmediump float shadowSize = 0.51;\n\nlowp float getShadowAlpha(lowp float size, lowp float dist) {\n  return (1.0 - smoothstep(size, shadowSize, dist)) * 0.25;\n}\n\nlowp float getCircleAlpha(lowp float ringSize, lowp float nodeSize, lowp float dist) {\n  return color.w - smoothstep(ringSize - nodeSize, ringSize, dist);\n}\n\nvoid main() {\n  lowp float dist = distance(gl_PointCoord, vec2(0.5));\n\n  if (dist > 0.51) {\n    discard;\n  }\n  else {\n    lowp float nodeSize = 1.0 / varNodeSize;\n    lowp float nodeAlpha = getCircleAlpha(circleSize, nodeSize, dist);\n    lowp float borderAlpha = getCircleAlpha(defaultBoderSize, nodeSize, dist);\n    lowp float ringAlpha = getCircleAlpha(innerSelectedRingSize, nodeSize, dist);\n    lowp vec3 finalColor = color.xyz;\n    lowp float finalAlpha = nodeAlpha;\n\n    if (selected > 0.0) {\n      lowp float shadowAlpha = getShadowAlpha(outerSelectedRingSize, dist);\n      lowp float ringAlpha2 = getCircleAlpha(outerSelectedRingSize, nodeSize, dist);\n\n      if (drawDefaultBorder > 0.0) {\n        finalColor = mix(nodeBorderColor, finalColor, nodeAlpha);\n        finalColor = mix(selectedInnerBorderColor, finalColor, borderAlpha);\n        finalColor = mix(selectedBorderColor, finalColor, ringAlpha);\n        finalColor = mix(shadowColor, finalColor, ringAlpha2);\n        finalAlpha = max(shadowAlpha, max(nodeAlpha, max(borderAlpha, ringAlpha2)));\n      } else {\n        finalColor = mix(selectedInnerBorderColor, finalColor, nodeAlpha);\n        finalColor = mix(selectedBorderColor, finalColor, ringAlpha);\n        finalColor = mix(shadowColor, finalColor, ringAlpha2);\n        finalAlpha = max(shadowAlpha, max(nodeAlpha, max(ringAlpha, ringAlpha2)));\n      }\n    } else if (hovered > 0.0) {\n      if (drawDefaultBorder > 0.0) {\n        lowp float shadowAlpha = getShadowAlpha(defaultBoderSize, dist);\n  \n        finalColor = mix(nodeBorderColor, finalColor, nodeAlpha);\n        finalColor = mix(shadowColor, finalColor, borderAlpha);\n        finalAlpha = max(shadowAlpha, max(nodeAlpha, ringAlpha));\n      } else {\n        lowp float shadowAlpha = getShadowAlpha(circleSize, dist);\n\n        finalColor = mix(shadowColor, finalColor, nodeAlpha);\n        finalAlpha = max(shadowAlpha, nodeAlpha);\n      }\n    } else {\n      if (drawDefaultBorder > 0.0) {\n        finalColor = mix(nodeBorderColor, finalColor, nodeAlpha);\n        finalAlpha = borderAlpha;\n      }\n    }\n    fragColor = vec4(finalColor, 1.0) * finalAlpha;\n  }\n}\n";
+declare const _default: "#version 300 es\nprecision mediump float;\n\nuniform lowp vec3 u_nodeBorderColor;\nuniform lowp vec3 u_selectedBorderColor;\nuniform lowp vec3 u_selectedInnerBorderColor;\nuniform lowp vec3 u_shadowColor;\nuniform lowp float u_drawDefaultBorder;\nuniform lowp sampler2DArray u_icons;\n\nin lowp vec4 color;\nin lowp float selected;\nin lowp float hovered;\nin mediump float varNodeSize;\nin mediump float iconLayer;\nin lowp float hasIcon;\n\nout vec4 fragColor;\n\nconst float circleSize = 0.40;\nconst float defaultBorderSize = 0.42;\nconst float innerSelectedRingSize = 0.43;\nconst float outerSelectedRingSize = 0.47;\nconst float shadowSize = 0.51;\n\nfloat getShadowAlpha(float size, float dist) {\n  return (1.0 - smoothstep(size, shadowSize, dist)) * 0.25;\n}\n\nfloat getCircleAlpha(float ringSize, float nodeSize, float dist) {\n  return color.w - smoothstep(ringSize - nodeSize, ringSize, dist);\n}\n\nvoid main() {\n  float dist = distance(gl_PointCoord, vec2(0.5));\n\n  if (dist > 0.51) {\n    discard;\n  } else {\n    float nodeSize = 1.0 / varNodeSize;\n    float nodeAlpha = getCircleAlpha(circleSize, nodeSize, dist);\n    float borderAlpha = getCircleAlpha(defaultBorderSize, nodeSize, dist);\n    float ringAlpha = getCircleAlpha(innerSelectedRingSize, nodeSize, dist);\n    vec3 finalColor = color.xyz;\n    float finalAlpha = nodeAlpha;\n\n    if (selected > 0.0) {\n      float shadowAlpha = getShadowAlpha(outerSelectedRingSize, dist);\n      float ringAlpha2 = getCircleAlpha(outerSelectedRingSize, nodeSize, dist);\n\n      if (u_drawDefaultBorder > 0.0) {\n        finalColor = mix(u_nodeBorderColor, finalColor, nodeAlpha);\n        finalColor = mix(u_selectedInnerBorderColor, finalColor, borderAlpha);\n        finalColor = mix(u_selectedBorderColor, finalColor, ringAlpha);\n        finalColor = mix(u_shadowColor, finalColor, ringAlpha2);\n        finalAlpha = max(shadowAlpha, max(nodeAlpha, max(borderAlpha, ringAlpha2)));\n      } else {\n        finalColor = mix(u_selectedInnerBorderColor, finalColor, nodeAlpha);\n        finalColor = mix(u_selectedBorderColor, finalColor, ringAlpha);\n        finalColor = mix(u_shadowColor, finalColor, ringAlpha2);\n        finalAlpha = max(shadowAlpha, max(nodeAlpha, max(ringAlpha, ringAlpha2)));\n      }\n    } else if (hovered > 0.0) {\n      if (u_drawDefaultBorder > 0.0) {\n        float shadowAlpha = getShadowAlpha(defaultBorderSize, dist);\n        finalColor = mix(u_nodeBorderColor, finalColor, nodeAlpha);\n        finalColor = mix(u_shadowColor, finalColor, borderAlpha);\n        finalAlpha = max(shadowAlpha, max(nodeAlpha, ringAlpha));\n      } else {\n        float shadowAlpha = getShadowAlpha(circleSize, dist);\n        finalColor = mix(u_shadowColor, finalColor, nodeAlpha);\n        finalAlpha = max(shadowAlpha, nodeAlpha);\n      }\n    } else {\n      if (u_drawDefaultBorder > 0.0) {\n        finalColor = mix(u_nodeBorderColor, finalColor, nodeAlpha);\n        finalAlpha = borderAlpha;\n      }\n    }\n\n    if (hasIcon > 0.5) {\n      vec2 uv = (gl_PointCoord - vec2(0.5)) / circleSize + 0.5;\n\n      float inX = step(0.0, uv.x) - step(1.0, uv.x);\n      float inY = step(0.0, uv.y) - step(1.0, uv.y);\n      float isInside = inX * inY;\n\n      vec4 ic = texture(u_icons, vec3(uv, iconLayer));\n      finalColor = mix(finalColor, ic.rgb, ic.a * isInside);\n    }\n\n    fragColor = vec4(finalColor, 1.0) * finalAlpha;\n  }\n}\n";
 export default _default;

package/dist/types/renderers/webglrenderer/node-vertex-point.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "#version 300 es\nuniform mat4 u_projection;\nuniform sampler2D u_positions;\nuniform mediump float u_zoom;\nuniform mediump float u_glAdjust;\nuniform lowp vec3 u_nodeBorderColor;\nuniform lowp vec3 u_selectedBorderColor;\nuniform lowp vec3 u_selectedInnerBorderColor;\nuniform lowp vec3 u_shadowColor;\nuniform lowp float u_drawDefaultBorder;\n\nin float a_size;\nin lowp vec2 a_index;\nin lowp vec4 a_color;\nin lowp float a_selected;\nin lowp float a_hovered;\n\nout lowp vec4 color;\nout lowp float selected;\nout lowp float hovered;\nout lowp float varNodeSize;\nout lowp vec3 nodeBorderColor;\nout lowp vec3 selectedBorderColor;\nout lowp vec3 selectedInnerBorderColor;\nout lowp vec3 shadowColor;\nout lowp float drawDefaultBorder;\n\nlowp float MinNodeSize = 5.0;\n\nvoid main(void) {\n  vec4 data = texture(u_positions, a_index);\n  gl_Position = u_projection * vec4(data.xy, 0.0, 1.0);\n\n  lowp float nodeSize = a_size * u_zoom * u_glAdjust;\n  if (nodeSize < MinNodeSize) {\n   gl_PointSize = MinNodeSize;\n   varNodeSize = MinNodeSize;\n  } else {\n    gl_PointSize = nodeSize;\n    varNodeSize = nodeSize;\n  }\n\n  color = a_color;\n  selected = a_selected;\n  hovered = a_hovered;\n  nodeBorderColor = u_nodeBorderColor;\n  selectedBorderColor = u_selectedBorderColor;\n  selectedInnerBorderColor = u_selectedInnerBorderColor;\n  shadowColor = u_shadowColor;\n  drawDefaultBorder = u_drawDefaultBorder;\n}";
+declare const _default: "#version 300 es\nuniform mat4 u_projection;\nuniform sampler2D u_positions;\nuniform mediump float u_zoom;\nuniform mediump float u_glAdjust;\n\nin float a_size;\nin highp vec2 a_index;\nin lowp vec4 a_color;\nin lowp float a_selected;\nin lowp float a_hovered;\nin lowp float a_iconLayer;\nin lowp float a_hasIcon;\n\nout lowp vec4 color;\nout lowp float selected;\nout lowp float hovered;\nout mediump float varNodeSize;\nout mediump float iconLayer;\nout lowp float hasIcon;\n\nconst float MinNodeSize = 5.0;\n\nvoid main(void) {\n  vec4 data = texture(u_positions, a_index);\n  gl_Position = u_projection * vec4(data.xy, 0.0, 1.0);\n\n  float nodeSize = max(a_size * u_zoom * u_glAdjust, MinNodeSize);\n  gl_PointSize = nodeSize;\n  varNodeSize = nodeSize;\n\n  color = a_color;\n  selected = a_selected;\n  hovered = a_hovered;\n  iconLayer = a_iconLayer * 255.0;\n  hasIcon = a_hasIcon;\n}";
 export default _default;

package/dist/types/renderers/webglrenderer/rel-glsl-utils.d.ts

@@ -0,0 +1 @@
+export declare const arrowShaderUtilsGLSL = "\nconst float CircleSize = 0.40;\nconst float HeadHalfWidthScale = 4.0;\nconst float HeadLengthScale = 2.5;\nconst float MaxHeadHalfWidthRatio = 0.6;\nconst float MaxHeadLengthRatio = 1.0;\n\n// Self-referencing relationships aren't supported in WebGL yet.\nbool relationshipIsSelfLoop(vec2 fromTexel, vec2 toTexel) {\n  return all(equal(fromTexel, toTexel));\n}\n\nvec2 perpendicular(vec2 dir) {\n  return vec2(-dir.y, dir.x);\n}\n\nfloat nodeRadiusFromSize(float size) {\n  return size * u_glAdjust * CircleSize;\n}\n\nfloat relationshipHalfWidth(float width) {\n  return width * u_glAdjust * 0.25;\n}\n\nfloat naturalArrowHeadHalfWidth(float lineHalfWidth) {\n  return lineHalfWidth * HeadHalfWidthScale + u_glAdjust;\n}\n\nfloat naturalArrowHeadLength(float headHalfWidth) {\n  return headHalfWidth * HeadLengthScale;\n}\n\nfloat clampArrowHeadHalfWidth(float lineHalfWidth, float nodeRadius) {\n  float natural = naturalArrowHeadHalfWidth(lineHalfWidth);\n  float minHalfWidth = lineHalfWidth;\n  float maxHalfWidth = max(minHalfWidth, nodeRadius * MaxHeadHalfWidthRatio);\n  return clamp(natural, minHalfWidth, maxHalfWidth);\n}\n\nfloat clampArrowHeadLength(float headHalfWidth, float nodeRadius) {\n  float natural = naturalArrowHeadLength(headHalfWidth);\n  float maxLength = nodeRadius * MaxHeadLengthRatio;\n  return min(natural, maxLength);\n}\n\nfloat arrowHeadClearance(float lineHalfWidth, float nodeRadius) {\n  float headHalfWidth = clampArrowHeadHalfWidth(lineHalfWidth, nodeRadius);\n  return clampArrowHeadLength(headHalfWidth, nodeRadius);\n}\n";

package/dist/types/renderers/webglrenderer/rel-vertex-arrow.d.ts

@@ -0,0 +1,2 @@
+declare const _default: "#version 300 es\nuniform mat4 u_projection;\nuniform sampler2D u_positions;\nuniform mediump float u_glAdjust;\n\nin vec2 a_from;\nin vec2 a_to;\nin lowp vec4 a_color;\nin float a_width;\nin float a_toSize;\n\nout lowp vec4 color;\n\n\nconst float CircleSize = 0.40;\nconst float HeadHalfWidthScale = 4.0;\nconst float HeadLengthScale = 2.5;\nconst float MaxHeadHalfWidthRatio = 0.6;\nconst float MaxHeadLengthRatio = 1.0;\n\n// Self-referencing relationships aren't supported in WebGL yet.\nbool relationshipIsSelfLoop(vec2 fromTexel, vec2 toTexel) {\n  return all(equal(fromTexel, toTexel));\n}\n\nvec2 perpendicular(vec2 dir) {\n  return vec2(-dir.y, dir.x);\n}\n\nfloat nodeRadiusFromSize(float size) {\n  return size * u_glAdjust * CircleSize;\n}\n\nfloat relationshipHalfWidth(float width) {\n  return width * u_glAdjust * 0.25;\n}\n\nfloat naturalArrowHeadHalfWidth(float lineHalfWidth) {\n  return lineHalfWidth * HeadHalfWidthScale + u_glAdjust;\n}\n\nfloat naturalArrowHeadLength(float headHalfWidth) {\n  return headHalfWidth * HeadLengthScale;\n}\n\nfloat clampArrowHeadHalfWidth(float lineHalfWidth, float nodeRadius) {\n  float natural = naturalArrowHeadHalfWidth(lineHalfWidth);\n  float minHalfWidth = lineHalfWidth;\n  float maxHalfWidth = max(minHalfWidth, nodeRadius * MaxHeadHalfWidthRatio);\n  return clamp(natural, minHalfWidth, maxHalfWidth);\n}\n\nfloat clampArrowHeadLength(float headHalfWidth, float nodeRadius) {\n  float natural = naturalArrowHeadLength(headHalfWidth);\n  float maxLength = nodeRadius * MaxHeadLengthRatio;\n  return min(natural, maxLength);\n}\n\nfloat arrowHeadClearance(float lineHalfWidth, float nodeRadius) {\n  float headHalfWidth = clampArrowHeadHalfWidth(lineHalfWidth, nodeRadius);\n  return clampArrowHeadLength(headHalfWidth, nodeRadius);\n}\n\n\nvoid main(void) {\n  vec4 from = texture(u_positions, a_from);\n  vec4 to = texture(u_positions, a_to);\n\n  if (relationshipIsSelfLoop(a_from, a_to)) {\n    color = a_color;\n    gl_Position = u_projection * vec4(from.xy, 0.0, 1.0);\n    return;\n  }\n\n  vec2 delta = to.xy - from.xy;\n  vec2 dir = normalize(delta);\n  vec2 perp = perpendicular(dir);\n\n  float toRadius = nodeRadiusFromSize(a_toSize);\n  float lineHalfWidth = relationshipHalfWidth(a_width);\n  float headHalfWidth = clampArrowHeadHalfWidth(lineHalfWidth, toRadius);\n  float headLength = clampArrowHeadLength(headHalfWidth, toRadius);\n\n  vec2 tip = to.xy - dir * toRadius;\n  vec2 baseCenter = tip - dir * headLength;\n\n  int corner = gl_VertexID % 3;\n  float isTip = float(corner == 0);\n  float perpSign = float(corner == 1) - float(corner == 2);\n  vec2 basePos = mix(baseCenter, tip, isTip);\n  vec2 vertexPosition = basePos + perp * (headHalfWidth * perpSign);\n\n  color = a_color;\n  gl_Position = u_projection * vec4(vertexPosition, 0.0, 1.0);\n}\n";
+export default _default;

package/dist/types/renderers/webglrenderer/rel-vertex-line.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "#version 300 es\nuniform mat4 u_projection;\nuniform sampler2D u_positions;\nuniform mediump float u_glAdjust;\n\nin vec2 a_from;\nin vec2 a_to;\nin lowp vec4 a_color;\nin lowp float a_triside;\nin float a_width;\n\nout lowp vec4 color;\n\nvoid main(void) {\n  vec4 from = texture(u_positions, a_from);\n  vec4 to = texture(u_positions, a_to);\n  vec2 direction = normalize(to.xy - from.xy);\n  direction = vec2(-direction.y, direction.x);\n\n  float width = a_width * u_glAdjust * 0.5;\n\n  if (a_triside == 0.0) {\n    from.y += (width / 2.0) * direction.y;\n    from.x += (width / 2.0) * direction.x;\n  } else {\n    from.y -= (width / 2.0) * direction.y;\n    from.x -= (width / 2.0) * direction.x;\n  }\n\n  color = a_color;\n  gl_Position = u_projection * vec4(from.xy, 0.0, 1.0);\n}\n";
+declare const _default: "#version 300 es\nuniform mat4 u_projection;\nuniform sampler2D u_positions;\nuniform mediump float u_glAdjust;\n\nin vec2 a_from;\nin vec2 a_to;\nin lowp vec4 a_color;\nin lowp float a_triside;\nin lowp float a_isTarget;\nin float a_endpointSize;\nin float a_otherEndpointSize;\nin float a_width;\n\nout lowp vec4 color;\n\n\nconst float CircleSize = 0.40;\nconst float HeadHalfWidthScale = 4.0;\nconst float HeadLengthScale = 2.5;\nconst float MaxHeadHalfWidthRatio = 0.6;\nconst float MaxHeadLengthRatio = 1.0;\n\n// Self-referencing relationships aren't supported in WebGL yet.\nbool relationshipIsSelfLoop(vec2 fromTexel, vec2 toTexel) {\n  return all(equal(fromTexel, toTexel));\n}\n\nvec2 perpendicular(vec2 dir) {\n  return vec2(-dir.y, dir.x);\n}\n\nfloat nodeRadiusFromSize(float size) {\n  return size * u_glAdjust * CircleSize;\n}\n\nfloat relationshipHalfWidth(float width) {\n  return width * u_glAdjust * 0.25;\n}\n\nfloat naturalArrowHeadHalfWidth(float lineHalfWidth) {\n  return lineHalfWidth * HeadHalfWidthScale + u_glAdjust;\n}\n\nfloat naturalArrowHeadLength(float headHalfWidth) {\n  return headHalfWidth * HeadLengthScale;\n}\n\nfloat clampArrowHeadHalfWidth(float lineHalfWidth, float nodeRadius) {\n  float natural = naturalArrowHeadHalfWidth(lineHalfWidth);\n  float minHalfWidth = lineHalfWidth;\n  float maxHalfWidth = max(minHalfWidth, nodeRadius * MaxHeadHalfWidthRatio);\n  return clamp(natural, minHalfWidth, maxHalfWidth);\n}\n\nfloat clampArrowHeadLength(float headHalfWidth, float nodeRadius) {\n  float natural = naturalArrowHeadLength(headHalfWidth);\n  float maxLength = nodeRadius * MaxHeadLengthRatio;\n  return min(natural, maxLength);\n}\n\nfloat arrowHeadClearance(float lineHalfWidth, float nodeRadius) {\n  float headHalfWidth = clampArrowHeadHalfWidth(lineHalfWidth, nodeRadius);\n  return clampArrowHeadLength(headHalfWidth, nodeRadius);\n}\n\n\nvoid main(void) {\n  vec4 from = texture(u_positions, a_from);\n  vec4 to = texture(u_positions, a_to);\n\n  if (relationshipIsSelfLoop(a_from, a_to)) {\n    color = a_color;\n    gl_Position = u_projection * vec4(from.xy, 0.0, 1.0);\n    return;\n  }\n\n  vec2 delta = from.xy - to.xy;\n  float halfWidth = relationshipHalfWidth(a_width);\n  float ownRadius = nodeRadiusFromSize(a_endpointSize);\n  float otherRadius = nodeRadiusFromSize(a_otherEndpointSize);\n  float toRadius = mix(otherRadius, ownRadius, a_isTarget);\n  float arrowClearance = arrowHeadClearance(halfWidth, toRadius);\n  float endpointClearance = ownRadius + a_isTarget * arrowClearance;\n\n  vec2 along = normalize(delta);\n  from.xy -= along * endpointClearance;\n\n  float sideSign = 1.0 - 2.0 * a_triside;\n  from.xy += sideSign * halfWidth * perpendicular(along);\n\n  color = a_color;\n  gl_Position = u_projection * vec4(from.xy, 0.0, 1.0);\n}\n";
 export default _default;

package/dist/types/renderers/webglrenderer/viewport-box-fragment.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "#version 300 es\nprecision lowp float;\n\nin lowp vec4 minimapViewportBoxColor;\n\nout vec4 fragColor;\n\nvoid main(void) {\n fragColor = minimapViewportBoxColor;\n}\n";
+declare const _default: "#version 300 es\nprecision lowp float;\n\nuniform lowp vec4 u_minimapViewportBoxColor;\n\nout vec4 fragColor;\n\nvoid main(void) {\n  fragColor = u_minimapViewportBoxColor;\n}\n";
 export default _default;

package/dist/types/renderers/webglrenderer/viewport-box-vertex.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "#version 300 es\nin vec2 coordinates;\nuniform mat4 u_projection;\nuniform lowp vec4 u_minimapViewportBoxColor;\n\nout lowp vec4 minimapViewportBoxColor;\n\nvoid main(void) {\n  gl_Position = u_projection * vec4(coordinates, 0.0, 1.0);\n  minimapViewportBoxColor = u_minimapViewportBoxColor;\n}\n";
+declare const _default: "#version 300 es\nin vec2 coordinates;\nuniform mat4 u_projection;\n\nvoid main(void) {\n  gl_Position = u_projection * vec4(coordinates, 0.0, 1.0);\n}\n";
 export default _default;

package/dist/types/types/graph-element.d.ts

@@ -1,4 +1,5 @@
 import type { StyledCaption } from '../renderers/domrenderer/shared/types';
+import type { Point } from '../utils/geometry';
 /**
  * The base type for graph elements.
  * @private
@@ -97,6 +98,13 @@ interface Node extends GraphElement {
      */
     html?: HTMLElement;
 }
+/**
+ * A node returned by {@link NVL.getNodes} with layout coordinates and screen position.
+ * `x` and `y` are canvas/layout space; `clientPosition` is relative to the canvas element.
+ */
+type NodeWithClientPosition = Node & Point & {
+    clientPosition: Point;
+};
 /**
  * A node with only a subset of its properties.
  */
@@ -132,4 +140,4 @@ type PartialRelationship = Partial<Relationship> & {
     /** The id of the relationship. */
     id: string;
 };
-export type { Node, Relationship, PartialNode, PartialRelationship };
+export type { Node, NodeWithClientPosition, Relationship, PartialNode, PartialRelationship };

package/dist/types/types/nvl-window-functions.d.ts

@@ -1,6 +1,6 @@
-import type { Node, Relationship } from './graph-element';
+import type { Node, NodeWithClientPosition, Relationship } from './graph-element';
 export interface NvlWindow {
-    __Nvl_dumpNodes: (instanceId?: string) => Node[];
+    __Nvl_dumpNodes: (instanceId?: string) => NodeWithClientPosition[];
     __Nvl_dumpRelationships: (instanceId?: string) => Relationship[];
     __Nvl_getNodesOnScreen: (instanceId?: string) => {
         nodes: Node[];

package/dist/types/utils/constants.d.ts

@@ -6,8 +6,11 @@ export declare const Gravity = 25;
 export declare const SimulationStopVelocity = 0.25;
 export declare const MappingEnd = 999999;
 export declare const LayoutStepIntervalMs = 13;
-export declare const SmoothFrameBudgetMs = 8;
-export declare const DefaultLayoutTimeLimit = 300;
+export declare const MaxLayoutStepsPerFrame = 20;
+export declare const DefaultMaxFps = 30;
+export declare const DefaultMinFps = 3;
+export declare const MinAllowedFps = 1;
+export declare const MaxAllowedFps = 120;
 export declare const ActiveAnimDuration = 1000;
 export declare const DefaultNodeSize = 25;
 export declare const DefaultNodeColor = "#FFDF81";

package/dist/types/utils/geometry.d.ts

@@ -126,3 +126,19 @@ export declare const getIntersection: (p0: Point, p1: Point, p2: Point, p3: Poin
  * @returns The distance between the point and the curve.
  */
 export declare const getDistanceToQuadratic: (fromCoordinates: Point, toCoordinates: Point, control: Point, point: Point) => number;
+/**
+ * Converts a polar coordinate (radius + angle around a centre) to a cartesian point.
+ * @param centre - The centre of the circle.
+ * @param radius - The radius of the circle.
+ * @param angle - The angle around the circle, in radians.
+ * @returns The point at that angle and radius from the centre.
+ */
+export declare const pointOnCircle: (centre: Point, radius: number, angle: number) => Point;
+/**
+ * Places child points evenly spaced around a circle centred on a point.
+ * @param centre - The centre of the circle.
+ * @param radius - The radius of the circle.
+ * @param noOfChildren - The number of points to place around the circle.
+ * @returns The evenly spaced points.
+ */
+export declare const calculateCirclePositions: (centre: Point, radius: number, noOfChildren: number) => Point[];

package/dist/types/utils/layoutSeeding.d.ts

@@ -0,0 +1,7 @@
+import type { Point } from './geometry';
+export type SeedingMethod = 'box' | 'circle';
+export declare const getCircleSeedRadius: (nodeCount: number, seedSpacing: number) => number;
+export declare const getBoxStartSize: (nodeCount: number) => number;
+export declare const getCirclePositionsForNodeCount: (nodeCount: number, center: Point, radius: number) => Point[];
+export declare const getBoxPositionsForNodeCount: (nodeCount: number, center: Point) => Point[];
+export declare const getSeedPositions: (nodeCount: number, seedingMethod: SeedingMethod, center?: Point) => Point[];

package/dist/types/utils/layoutSeeding.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/utils/webWorkerUtils.d.ts

@@ -1,3 +1,3 @@
-type Layouts = 'CoseBilkentLayout' | 'HierarchicalLayout';
+type Layouts = 'HierarchicalLayout';
 export declare const initializeWorker: (workerName: Layouts, workersDisabled?: boolean) => SharedWorker;
 export {};

package/dist/types/utils/zoomFunctions.d.ts

@@ -1,5 +1,11 @@
 import type { Node } from '../index';
 import type { Point } from './geometry';
+/**
+ * Gets padding for fitting nodes, which is twice the largest node radius.
+ * @param maxNodeRadius - The largest node radius.
+ * @returns The padding for fitting nodes.
+ */
+declare const getFitNodesPadding: (maxNodeRadius?: number) => number;
 declare const getExtremeLimits: (nodePositions: Point[]) => Point[];
 declare const getMaxDistance: (extremeLimits?: Point[]) => number;
 /**
@@ -40,7 +46,8 @@ declare const createZoomTarget: (zoomX: number, zoomY: number, minZoom?: number,
  * @param nodePositions - The node positions.
  * @param containerWidth - The width of the container NVL is displayed in.
  * @param containerHeight - The height of the container NVL is displayed in.
- * @param maxNodeRadius - The maximum node radius, which is added as margin to the scene (defaults to `50`).
+ * @param maxNodeRadius - The maximum node radius, which is added as margin to the scene
+ * (defaults to 2 * {@link DefaultNodeSize}).
  * @returns The zoom and pan targets.
  */
 declare const getZoomTargetForNodePositions: (nodePositions: Point[], containerWidth: number, containerHeight: number, maxNodeRadius?: number) => {
@@ -55,4 +62,4 @@ declare const getFlexibleZoomLimit: (nodePositions: Point[], rect: HTMLCanvasEle
 declare const getNewZoomWithinLimits: (newZoom: number, oldZoom: number, minZoom: number, maxZoom: number) => number;
 declare const isZoomOutAtLimit: (newZoom: number, oldZoom: number, zoomOutLimit: number) => boolean;
 declare const getDynamicZoom: (nodePositions: Point[] & Node[], minZoom: number, maxZoom: number, rect: HTMLCanvasElement, newZoom: number, currentZoom: number) => number;
-export { getFlexibleZoomLimit, getZoomTargetForNodePositions, isZoomOutAtLimit, getNewZoomWithinLimits, getExtremeLimits, getMaxDistance, getPositionBoundaries, getZoomLevel, createZoomTarget, getDynamicZoom };
+export { getFitNodesPadding, getFlexibleZoomLimit, getZoomTargetForNodePositions, isZoomOutAtLimit, getNewZoomWithinLimits, getExtremeLimits, getMaxDistance, getPositionBoundaries, getZoomLevel, createZoomTarget, getDynamicZoom };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neo4j-nvl/base",
-  "version": "1.2.0-e691fdb4",
+  "version": "1.2.0-ec100981",
   "license": "SEE LICENSE IN 'LICENSE.txt'",
   "homepage": "https://neo4j.com/docs/nvl/current/",
   "description": "Base library for the Neo4j Visualization Library",
@@ -30,7 +30,7 @@
     "postpack": "rm LICENSE.txt && rm CHANGELOG.md"
   },
   "dependencies": {
-    "@neo4j-nvl/layout-workers": "1.2.0-e691fdb4",
+    "@neo4j-nvl/layout-workers": "1.2.0-ec100981",
     "@segment/analytics-next": "1.81.1",
     "color-string": "1.9.1",
     "d3-force": "3.0.0",
@@ -38,14 +38,14 @@
     "glsl-inject-defines": "1.0.3",
     "lodash": "4.18.1",
     "loglevel": "1.9.2",
-    "mobx": "3.6.2",
+    "mobx": "6.15.0",
     "node-pid-controller": "1.0.1",
     "resizelistener": "1.1.0",
     "tinycolor2": "1.6.0",
-    "uuid": "14.0.0"
+    "uuid": "14.0.1"
   },
   "devDependencies": {
-    "@babel/core": "7.28.5",
+    "@babel/core": "7.29.7",
     "@types/color-string": "1.5.5",
     "@types/d3-force": "3.0.10",
     "@types/lodash": "4.17.21",

package/dist/types/layouts/forcedirectedlayout/ForceCytoLayout.d.ts

@@ -1,22 +0,0 @@
-export declare const ForceDirectedLayoutType = "forceDirected";
-export declare const CoseBilkentType = "coseBilkent";
-export declare class ForceCytoLayout {
-    private readonly physLayout;
-    private readonly coseBilkentLayout;
-    private readonly state;
-    private currentLayoutType;
-    private enableCytoscape;
-    private currentLayout;
-    constructor(config: any);
-    setOptions(options: any): void;
-    private getLayout;
-    private setLayout;
-    copyLayoutPositions(nodeList: any, prevLayout: any, nextLayout: any): void;
-    update(refreshPositions?: boolean): void;
-    getShouldUpdate(): boolean;
-    getComputing(): boolean;
-    updateNodes(positionList: any): void;
-    getNodePositions(data: any): import("../..").Node[];
-    terminateUpdate(): void;
-    destroy(): void;
-}

package/dist/types/layouts/forcedirectedlayout/cosebilkentlayout/CoseBilkentLayout.d.ts

@@ -1,33 +0,0 @@
-import type { NvlState } from '../../../modules/state/types';
-import type { Node, Relationship } from '../../../types/graph-element';
-import AnimatedLayout from '../../animatedlayout/AnimatedLayout';
-type LayoutData = {
-    elements: {
-        group: string;
-        data: {
-            id: string;
-        };
-    }[];
-    spacingFactor: number;
-};
-export declare class CoseBilkentLayout extends AnimatedLayout {
-    private stateDisposers;
-    cytoCompleteCallback: () => void;
-    computing: boolean;
-    pendingLayoutData: LayoutData;
-    worker: SharedWorker;
-    private workersDisabled;
-    constructor(config: {
-        state: NvlState;
-        cytoCompleteCallback?: () => void;
-        animationCompleteCallback?: () => void;
-    });
-    setOptions(): void;
-    update(refreshPositions?: boolean, updateMobXNodes?: Node[], updateMobXRelationships?: Relationship[]): void;
-    getShouldUpdate(): boolean;
-    getComputing(): boolean;
-    layout(nodes: Node[], relationships: Relationship[]): void;
-    terminateUpdate(): void;
-    destroy(): void;
-}
-export {};