@neo4j-nvl/base 1.1.0 → 1.2.0

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

@@ -0,0 +1,109 @@
+import type { BorderStyle, DisabledItemStyles, ShadowStyle } from '../../../modules/state/types';
+import type { Node } from '../../../types/graph-element';
+import type { TextSegment } from '../shared/types';
+import type AnimationHandler from './AnimationHandler';
+/**
+ * Draws borders around a node with a given array of border styles
+ * @param ctx - The canvas context.
+ * @param x - The x coordinate of the node.
+ * @param y - The y coordinate of the node.
+ * @param innerRadius - The inner radius of the node without any border.
+ * @param borderStyles - An array of border styles.
+ * @internal
+ * @hidden
+ */
+export declare const drawCircleBand: (ctx: CanvasRenderingContext2D, x: number, y: number, innerRadius: number, borderStyles: {
+    width: number;
+    color: string;
+}[]) => void;
+/**
+ * Fill a circle band with a gradient from a certain color to transparent
+ * @param ctx - The canvas context.
+ * @param x - The x coordinate of the node.
+ * @param y - The y coordinate of the node.
+ * @param color - The color of the gradient.
+ * @param radius - The inner radius of the node without any border.
+ * @param blur - The blur radius of the gradient.
+ * @param maxOpacity - The maximum opacity of the gradient.
+ */
+export declare const drawGradientCircleBand: (ctx: CanvasRenderingContext2D, x: number, y: number, color: string, radius: number, blur: number, maxOpacity?: number) => void;
+/**
+ * Draw a circle shape with a solid color
+ */
+export declare const drawSolidCircle: (ctx: CanvasRenderingContext2D, x: number, y: number, color: string, size: number) => void;
+/**
+ * Prints the caption for a node
+ */
+export declare const drawNodeCaption: (ctx: CanvasRenderingContext2D, lines: TextSegment[], stylesPerChar: string[][], initialYPos: number, fontSize: number, fontFace: string, lineDistance: number, x: number, y: number, ellipsisWidth: number) => void;
+/**
+ * Calculate pulse animation parameters based on current animation state.
+ * The pulse grows from the node center to 1.88x the node radius, then fades out.
+ * This creates an expanding circle effect.
+ *
+ * @param nodeId - The unique identifier of the node
+ * @param animationHandler - The animation handler managing animation state
+ * @param mainFaceRadius - The radius of the main node circle in pixels
+ * @returns The calculated pulse radius
+ */
+export declare const calculatePulseAnimation: (mainFaceRadius: number) => {
+    pulseRadius: number;
+    pulseVisibility: number;
+};
+/**
+ * Calculate shadow animation parameters based on node state.
+ * Animates shadow width from 0 to target based on selected/hovered state.
+ *
+ * @param nodeId - The unique identifier of the node
+ * @param animationHandler - The animation handler managing animation state
+ * @param selected - Whether the node is selected
+ * @param hovered - Whether the node is hovered
+ * @param shadowStyle - The shadow style configuration
+ * @returns Object with shadowWidth, shadowFade, and shadowColor, or null if no shadow needed
+ */
+export declare const calculateShadowAnimation: (nodeId: string, animationHandler: AnimationHandler, selected: boolean, hovered: boolean, shadowStyle: ShadowStyle) => {
+    shadowWidth: number;
+    shadowColor: string;
+    shadowFade: number;
+};
+/**
+ * Returns an array of styles for the rings of a node.
+ * If the node is selected, it uses the selected ring styles.
+ * Otherwise, it uses the default ring styles.
+ * When no rings are configured, existing ring animations are wound down.
+ *
+ * @param node - The node to get the ring styles for.
+ * @param animationHandler - The animation handler.
+ * @param nodeBorderStyles - The node border styles.
+ * @returns An array of ring styles with computed widths.
+ */
+export type NodeRenderParamsInput = {
+    node: Node;
+    mainFaceRadius: number;
+    disabled: boolean;
+    disabledItemStyles: DisabledItemStyles;
+    selectedBorderStyle: BorderStyle;
+    animationHandler: AnimationHandler;
+    defaultNodeColor: string;
+};
+/**
+ * Calculate all node render parameters at once.
+ * This is the main entry point for preparing node rendering calculations.
+ *
+ * @param input - The input parameters object
+ * @returns object with node render parameters
+ */
+export declare const calculateNodeRenderParams: (input: NodeRenderParamsInput) => {
+    nodeColor: string;
+    fontColor: string;
+    shouldRenderPulse: boolean;
+    pulseAnimation: {
+        pulseColor: string;
+        pulseRadius: number;
+    };
+    shouldRenderShadow: boolean;
+    shadowAnimation: {
+        shadowWidth: number;
+        shadowFade: number;
+        shadowColor: string;
+    };
+};

package/dist/types/renderers/domrenderer/canvasrenderer/nodeDrawing.test.d.ts

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

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

@@ -1,7 +1,8 @@
 import type { Cache } from '../shared/types';
 declare class ImageCache {
-    cache: Cache;
-    constructor();
+    readonly cache: Cache;
+    private readonly onImageLoadedCb?;
+    constructor(onImageLoaded?: () => void);
     getImage(src: string, inverted?: boolean): HTMLCanvasElement;
     private getOrCreateEntry;
     private invertCanvas;

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

@@ -19,12 +19,28 @@ export default class ArrowBundle {
     toId: string;
     angles: number[];
     labelInfo: Record<string, LabelGeometry>;
+    relIndexCache: Map<string, number>;
+    relDirectionCache: Map<string, boolean>;
+    private cachedMaxFontSize;
     /**
      * @param key - The key of the arrow bundle.
      * @param fromId - The source node of the arrow bundle.
      * @param toId - The target node of the arrow bundle.
      */
     constructor(key: string, fromId: string, toId: string);
+    /**
+     * Recalculate and cache the maximum font size
+     */
+    updateMaxFontSize(): void;
+    /**
+     * Updates the relationship direction cache with a given relationship
+     * @param rel - The relationship to update the direction for.
+     */
+    updateRelDirection(rel: Relationship): void;
+    /**
+     * Regenerates index cache for rel ids in bundle
+     */
+    updateIndexCache(): void;
     /**
      * Insert a new arrow to the bundle
      * @param rel - The relationship to insert.
@@ -53,7 +69,7 @@ export default class ArrowBundle {
      * @param rel - The relationship to check.
      * @returns True if the relationship is in opposite direction to the bundle.
      */
-    relIsOppositeDirection({ from, to }: Relationship): boolean;
+    relIsOppositeDirection({ id }: Relationship): boolean;
     /**
      * Get the index of a given arrow in the bundle
      * @param rel - The arrow to look for.
@@ -65,7 +81,7 @@ export default class ArrowBundle {
      * @param index - The index of the arrow to get.
      * @returns The arrow at the given index.
      */
-    getRel(index: number): Relationship | null;
+    getRel(index: number): Relationship;
     /**
      * Set the waypoints for the arrow bundle
      * @param waypoints - The waypoints for the arrow bundle.

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

@@ -4,6 +4,7 @@ import ArrowBundle from './ArrowBundle';
 export default class ArrowBundler {
     bundles: Record<string, ArrowBundle>;
     nodeToBundles: Record<string, ArrowBundle[]>;
+    relToBundleKey: Map<string, string>;
     constructor(rels: Relationship[], waypoints: Record<string, WaypointPath>);
     /**
      * Get the arrow bundle for a given relation
@@ -23,6 +24,15 @@ export default class ArrowBundler {
      * @param positionMap A map of node IDs to positions.
      */
     updatePositions(positionMap: Record<string, Node>): void;
+    /**
+     * Remove a bundle reference from the node→bundles index for one node id.
+     */
+    private removeNodeFromMap;
+    /**
+     * Remove a relationship from a bundle.
+     * If the bundle is now empty, remove it from `bundles` and the node index.
+     */
+    private removeRelFromBundle;
     /**
      * Get a unique ID for a pair of IDs
      * @param id1 - The first ID.

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

@@ -1,4 +1,14 @@
+import type { BorderStyles } from '../../../../modules/state/types';
 import type { Node } from '../../../../types/graph-element';
+import type AnimationHandler from '../../canvasrenderer/AnimationHandler';
+import type { TextSegment } from '../types';
+/**
+ * Returns the effective node size, which is either the provided size
+ * if it's a positive and finite number, or the default node size otherwise.
+ * @param size
+ * @returns The effective node size.
+ */
+export declare const getEffectiveNodeSize: (size?: number) => number;
 /**
  * Returns the bounding box of a node with the given x, y, and size properties.
  * If no size is given, the default size is used.
@@ -46,6 +56,16 @@ export declare const getNodeOverlayIconPosition: (iconSize: number, mainFaceRadi
     iconXPos: number;
     iconYPos: number;
 };
+/**
+ * Returns the caption font size that should be used
+ * for the given info level and node diameter.
+ * @param infoLevel {number} - The info level.
+ * @param nodeRadius {number} - The radius of the node.
+ * @param captionSize {number} - The size of the caption.
+ * @param hasIcon {boolean} - Whether the node has an icon.
+ * @returns {number} - The font size.
+ */
+export declare const infoLevelToFontSize: (infoLevel: number, nodeRadius?: number, captionSize?: number, hasIcon?: boolean) => number;
 /**
  * Calculates the rendered radius of a node including pixel ratio
  * @param node - The node object with optional size property
@@ -55,4 +75,36 @@ export declare const getNodeOverlayIconPosition: (iconSize: number, mainFaceRadi
  */
 export declare const getNodeRadius: (node: {
     size?: number;
-}, pixelRatio: number, defaultNodeSize: number) => number;
+}) => number;
+/**
+ * Prepares node caption data for rendering (works for both Canvas and SVG)
+ * @param node - The node to prepare caption data for
+ * @param zoomLevel - Current zoom level
+ * @param ctx - Canvas context for text measurement (optional for SVG, will create one if not provided)
+ * @returns Caption rendering data including lines, styles, positioning, and font info
+ */
+export declare const prepareNodeCaptionData: (node: Node, zoomLevel: number, ctx?: CanvasRenderingContext2D) => {
+    lines: TextSegment[];
+    stylesPerChar: string[][];
+    fullCaption: string;
+    fontSize: number;
+    fontFace: string;
+    fontColor: string;
+    yPos: number;
+    maxNoLines: number;
+    hasContent: boolean;
+};
+/**
+ * Returns an array of styles for the rings of a node.
+ * If the node is selected, it uses the selected ring styles.
+ * Otherwise, it uses the default ring styles.
+ *
+ * @param node - The node to get the ring styles for.
+ * @param nodeBorderStyles - The node border styles.
+ * @param animationHandler - Optional animation handler for animating ring width changes.
+ * @returns An array of ring styles with computed widths.
+ */
+export declare const getRingStyles: (node: Node, nodeBorderStyles: BorderStyles, animationHandler?: AnimationHandler) => {
+    width: number;
+    color: string;
+}[];

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

@@ -4,8 +4,13 @@ export declare const fontThresholds: [number, number][];
  * @param color - * @param opacity - * @returns rgba() string with the given opacity.
  */
 export declare const overrideOpacity: (color: string, opacity: number) => string;
-export declare function getIndividualInfoLevels(r: number, zoomLevel: number): {
+export declare const getIndividualInfoLevels: (r: number, zoomLevel: number) => {
     nodeInfoLevel: number;
     fontInfoLevel: number;
     iconInfoLevel: number;
 };
+/**
+ * On-screen size for a node icon drawn at `iconDrawSize` in graph space
+ * under a uniform `scale(zoom)` viewport transform.
+ */
+export declare const getNodeIconScreenPx: (iconDrawSize: number, zoom: number) => number;

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

@@ -36,11 +36,22 @@ export declare const tryWithNumberOfLines: (text: string, measureWidth: (text: s
 export declare const tryBreakingOnSpaces: (text: string, measureWidth: (text: string) => number, getAvailableWidth: (a: number, b: number) => number, numberOfLines: number) => TextSegment[];
 /**
  * @param ctx - = Canvas.2dContext
- * @param rtlAdjustedText - The text to display
+ * @param text - The text to display
  *
  * @return  array of text lines
  */
 export declare const getLines: (ctx: CanvasRenderingContext2D, text: string, fontFace: string, fontSize: string | number, maxWidth: number, hasIcon: boolean, maxNoLines: number, align: string) => TextSegment[];
+/**
+ * Groups consecutive characters with the same style into text spans.
+ * @param lineText - The text of the line to process.
+ * @param stylesPerChar - A 2D array where each entry corresponds to a character.
+ * @param startCharIndex - The index of the first character of lineText in the full caption.
+ * @returns An array of objects, each containing a text span and its associated style string.
+ */
+export declare const getGroupedTextSpans: (lineText: string, stylesPerChar: string[][], startCharIndex: number) => {
+    text: string;
+    style: string;
+}[];
 /**
  * Returns the styles by char for a group of property values.
  * @param captions - = array of captions

package/dist/types/renderers/domrenderer/svgrenderer/SvgRenderer.d.ts

@@ -6,6 +6,7 @@ export default class SvgRenderer extends BaseRenderer {
     private svg;
     private measurementContext;
     constructor(svg: SVGSVGElement, state: NvlState, options?: RendererOptions);
+    clear(): void;
     render(positionArray: Node[], positionBoundaries?: {
         centerX: number;
         centerY: number;
@@ -16,7 +17,4 @@ export default class SvgRenderer extends BaseRenderer {
         backgroundColor?: string;
         showCaptions?: boolean;
     }): void;
-    private renderNodes;
-    private renderRelationships;
-    private getSvgTransform;
 }

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

@@ -0,0 +1,59 @@
+import type { BorderStyles, DisabledItemStyles } from '../../../modules/state/types';
+import type { Point } from '../../../utils/geometry';
+import type ImageCache from '../shared/ImageCache';
+import type ArrowBundler from '../shared/arrows/ArrowBundler';
+import type { RelationshipToRender } from '../shared/types';
+/**
+ * Builds an SVG path string for a self-referencing loop using quadratic curves
+ */
+export declare const buildSelfLoopPath: (startPoint: Point, endPoint: Point, apexPoint: Point, control1Point: Point, control2Point: Point) => string;
+/**
+ * Builds an SVG path string for a polyline with quadratic curves between points
+ */
+export declare const buildQuadraticCurvePath: (points: Point[]) => string;
+/**
+ * Converts an array of points to an SVG polyline points attribute string
+ */
+export declare const pointsToPolylineString: (points: Point[]) => string;
+/**
+ * Creates an SVG arrowhead polygon element with selection rings
+ */
+export declare const createArrowHeadWithRings: (arrowHead: {
+    tip: Point;
+    base1: Point;
+    base2: Point;
+}, fillColor: string, rings: {
+    color: string;
+    width: number;
+}[]) => SVGPolygonElement[];
+/**
+ * Creates an SVG path element with selection rings
+ */
+export declare const createPathWithRings: (pathData: string, strokeColor: string, strokeWidth: number, rings: {
+    color: string;
+    width: number;
+}[]) => SVGPathElement[];
+/**
+ * Creates an SVG polyline element with selection rings
+ */
+export declare const createPolylineWithRings: (points: string, strokeColor: string, strokeWidth: number, rings: {
+    color: string;
+    width: number;
+}[]) => SVGPolylineElement[];
+/**
+ * Calculates the proper angle for relationship labels to prevent upside-down text (SVG-specific)
+ */
+export declare const getCorrectLabelAngle: (angle: number) => number;
+/**
+ * Renders an array of relationships to an SVG element.
+ *
+ * @param relationshipsToRender - Relationships with endpoint data to render
+ * @param svg - The SVG element to append relationship elements to
+ * @param drawCurves - Whether to draw curved paths (true) or polylines (false)
+ * @param arrowBundler - The arrow bundler for resolving relationship bundles
+ * @param disabledItemStyles - Styles for disabled relationships
+ * @param defaultRelationshipColor - Default relationship color
+ * @param relationshipBorderStyles - Border/ring styles for relationships
+ * @param measurementContext - Canvas 2D context for text measurement
+ */
+export declare const renderSvgRelationships: (relationshipsToRender: RelationshipToRender[], svg: SVGElement, drawCurves: boolean, arrowBundler: ArrowBundler, disabledItemStyles: DisabledItemStyles, defaultRelationshipColor: string, relationshipBorderStyles: BorderStyles, measurementContext: CanvasRenderingContext2D, imageCache: ImageCache) => void;

package/dist/types/renderers/domrenderer/svgrenderer/arrowDrawing.test.d.ts

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

package/dist/types/renderers/domrenderer/svgrenderer/nodeDrawing.d.ts

@@ -0,0 +1,16 @@
+import type { BorderStyles, DisabledItemStyles } from '../../../modules/state/types';
+import type { Node } from '../../../types/graph-element';
+import type ImageCache from '../shared/ImageCache';
+/**
+ * Renders an array of nodes to an SVG element.
+ *
+ * @param nodesToRender - Nodes with position data to render
+ * @param svg - The SVG element to append node groups to
+ * @param zoom - Current zoom level
+ * @param idToItem - Map from node IDs to full node data
+ * @param disabledItemStyles - Styles for disabled nodes
+ * @param defaultNodeColor - Default node color
+ * @param nodeBorderStyles - Border/ring styles for nodes
+ * @param imageCache - Image cache for node icons
+ */
+export declare const renderSvgNodes: (nodesToRender: Node[], svg: SVGElement, zoom: number, idToItem: Record<string, Node>, disabledItemStyles: DisabledItemStyles, defaultNodeColor: string, nodeBorderStyles: BorderStyles, imageCache: ImageCache) => void;

package/dist/types/renderers/domrenderer/svgrenderer/nodeDrawing.test.d.ts

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

package/dist/types/renderers/domrenderer/svgrenderer/svgUtils.d.ts

@@ -1,48 +1,40 @@
-import type { Point } from '../../../utils/geometry';
 /**
- * Applies text styles to an SVG tspan element based on a style string
- * @param {SVGTSpanElement} tspanElem - The SVG tspan element to style
- * @param {string} styleStr - Comma-separated style string (e.g., "bold,italic")
- */
-export declare const applySvgTextStyles: (tspanElem: SVGTSpanElement, styleStr: string) => void;
-/**
- * Builds an SVG path string for a self-referencing loop using quadratic curves
- * @param startPoint - The start point of the loop
- * @param endPoint - The end point of the loop
- * @param apexPoint - The apex (top) point of the loop
- * @param control1Point - The first control point
- * @param control2Point - The second control point
- * @returns SVG path string
+ * Creates an SVG image element for an icon
+ *
+ * @param nodeX - The x-coordinate of the node
+ * @param nodeY - The y-coordinate of the node
+ * @param iconXPos - The x-position of the icon relative to the node
+ * @param iconYPos - The y-position of the icon relative to the node
+ * @param iconSize - The size of the icon
+ * @param image - The image to use for the icon
+ * @param isDisabled - Whether the icon should be disabled
  */
-export declare const buildSelfLoopPath: (startPoint: Point, endPoint: Point, apexPoint: Point, control1Point: Point, control2Point: Point) => string;
-/**
- * Builds an SVG path string for a polyline with quadratic curves between points
- * @param points - Array of points along the path
- * @returns SVG path string
- */
-export declare const buildQuadraticCurvePath: (points: Point[]) => string;
+export declare const createSvgIconElement: (options: {
+    nodeX: number;
+    nodeY: number;
+    iconXPos: number;
+    iconYPos: number;
+    iconSize: number;
+    image: HTMLCanvasElement;
+    isDisabled: boolean;
+}) => SVGImageElement;
 /**
- * Converts an array of points to an SVG polyline points attribute string
- * @param points - Array of points
- * @returns String suitable for SVG polyline points attribute
+ * Calculates the SVG transform string for viewport positioning
+ *
+ * @param width - SVG viewport width
+ * @param height - SVG viewport height
+ * @param zoom - Zoom level multiplier
+ * @param panX - Pan offset in X direction
+ * @param panY - Pan offset in Y direction
+ * @returns SVG transform string with translate and scale operations
  */
-export declare const pointsToPolylineString: (points: Point[]) => string;
+export declare const calculateSvgTransform: (width: number, height: number, zoom: number, panX: number, panY: number) => string;
 /**
- * Creates an SVG arrowhead polygon element with selection rings
- * @param arrowHead - Arrowhead geometry (tip, base1, base2 points)
- * @param fillColor - Fill color for the arrowhead
- * @param rings - Selection rings configuration
- * @param pixelRatio - Device pixel ratio
- * @returns Array of SVG polygon elements [rings..., arrowhead]
+ * Applies text styles to an SVG tspan element based on a style string
+ * @param {SVGTSpanElement} tspanElem - The SVG tspan element to style
+ * @param {string} styleStr - Comma-separated style string (e.g., "bold,italic")
  */
-export declare const createArrowHeadWithRings: (arrowHead: {
-    tip: Point;
-    base1: Point;
-    base2: Point;
-}, fillColor: string, rings: Array<{
-    color: string;
-    width: number;
-}>, pixelRatio: number) => SVGPolygonElement[];
+export declare const applySvgTextStyles: (tspanElem: SVGTSpanElement, styleStr: string) => void;
 /**
  * Creates an SVG text element with styled spans
  * @param options - Configuration options for the text element
@@ -66,110 +58,10 @@ export declare const createStyledTextElement: (options: {
     fontColor: string;
     textAnchor: string;
     dominantBaseline: string;
-    lineSpans: Array<{
+    lineSpans: {
         text: string;
         style: string;
-    }>;
+    }[];
     transform?: string;
     fontWeight?: string;
 }) => SVGTextElement;
-/**
- * Creates an SVG path element with selection rings
- * @param pathData - SVG path d attribute
- * @param strokeColor - Stroke color for the path
- * @param strokeWidth - Stroke width for the path
- * @param rings - Selection rings configuration
- * @param pixelRatio - Device pixel ratio
- * @returns Array of SVG path elements [rings..., path]
- */
-export declare const createPathWithRings: (pathData: string, strokeColor: string, strokeWidth: number, rings: Array<{
-    color: string;
-    width: number;
-}>, pixelRatio: number) => SVGPathElement[];
-/**
- * Creates an SVG polyline element with selection rings
- * @param points - Polyline points string
- * @param strokeColor - Stroke color for the polyline
- * @param strokeWidth - Stroke width for the polyline
- * @param rings - Selection rings configuration
- * @param pixelRatio - Device pixel ratio
- * @returns Array of SVG polyline elements [rings..., polyline]
- */
-export declare const createPolylineWithRings: (points: string, strokeColor: string, strokeWidth: number, rings: Array<{
-    color: string;
-    width: number;
-}>, pixelRatio: number) => SVGPolylineElement[];
-/**
- * Calculates arrowhead geometry for relationship endpoints (SVG-specific)
- * @param point1 - First point (direction from)
- * @param point2 - Second point (direction to)
- * @param arrowLength - Length of the arrowhead
- * @param arrowWidth - Width of the arrowhead
- * @param offsetFactor - Factor to offset the tip (default 1/3)
- * @returns Object containing arrowhead points
- */
-export declare const getArrowheadGeometry: (point1: {
-    x: number;
-    y: number;
-}, point2: {
-    x: number;
-    y: number;
-}, arrowLength: number, arrowWidth: number, offsetFactor?: number) => {
-    tip: {
-        x: number;
-        y: number;
-    };
-    base1: {
-        x: number;
-        y: number;
-    };
-    base2: {
-        x: number;
-        y: number;
-    };
-    angle: number;
-};
-/**
- * Calculates the proper angle for relationship labels to prevent upside-down text (SVG-specific)
- * @param angle - The original angle in radians
- * @returns The corrected angle in degrees
- */
-export declare const getCorrectLabelAngle: (angle: number) => number;
-/**
- * Processes caption data for SVG rendering
- * @param captions - Array of caption objects with value and styles
- * @param caption - Legacy single caption string
- * @returns Object with fullCaption and stylesPerChar array
- */
-/**
- * Groups consecutive characters with the same style into text spans
- * @param lineText - The text of the line
- * @param stylesPerChar - Array of style arrays for each character
- * @param startCharIndex - The starting character index in the overall caption
- * @returns Array of text spans with their styles
- */
-export declare const getGroupedTextSpans: (lineText: string, stylesPerChar: string[][], startCharIndex: number) => {
-    text: string;
-    style: string;
-}[];
-/**
- * Creates an SVG image element for node icons
- * @param options - Configuration options for the icon element
- * @param options.nodeX - X coordinate of the node center
- * @param options.nodeY - Y coordinate of the node center
- * @param options.iconXPos - X offset from node center to icon position
- * @param options.iconYPos - Y offset from node center to icon position
- * @param options.iconSize - Size (width and height) of the icon
- * @param options.image - The image from cache (HTMLCanvasElement)
- * @param options.isDisabled - Whether the node is disabled
- * @returns SVG image element
- */
-export declare const createSvgIconElement: (options: {
-    nodeX: number;
-    nodeY: number;
-    iconXPos: number;
-    iconYPos: number;
-    iconSize: number;
-    image: HTMLCanvasElement;
-    isDisabled: boolean;
-}) => SVGImageElement;

package/dist/types/renderers/domrenderer/svgrenderer/svgUtils.test.d.ts

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

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

@@ -3,8 +3,7 @@ export declare const SpringTextureSize = 4096;
 export declare const MaxIndexBuffer = 65536;
 export declare const MinRelLength = 100;
 export declare const Gravity = 25;
-export declare const SimulationStopVelocity = 100;
-export declare const VerletSimulationStopVelocity = 0.25;
+export declare const SimulationStopVelocity = 0.25;
 export declare const MappingEnd = 999999;
 export declare const ActiveAnimDuration = 1000;
 export declare const DefaultNodeSize = 25;
@@ -40,4 +39,6 @@ export declare const GlAdjust: number;
  */
 export declare const getDevicePixelRatio: () => number;
 export declare const HtmlCaptionMinWidthThreshold = 5;
+/** Min on-screen icon size (px) before we skip drawing; avoids unreadable bitmaps when zoomed out. */
+export declare const MinNodeIconScreenPx = 10;
 export declare const allowedWrappers: string[];

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

@@ -9,6 +9,10 @@ export interface Point {
     y: number;
 }
 export declare const isPointDefined: (point: Point | Node) => boolean;
+/**
+ * Returns true when value is a finite number (not NaN or Infinity).
+ */
+export declare const isValidFiniteNumber: (value: unknown) => value is number;
 /**
  * This function checks if the coordinates are defined.
  * @param from - The {@link Node} the edge starts from.

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

@@ -24,7 +24,7 @@ export declare abstract class AnalyticsFunction {
     /**
      * Get/fetch unique segment Id from the localstorage.
      */
-    abstract getSegmentTrackingId(): Record<string, unknown>;
+    abstract getSegmentTrackingId(): string;
     /**
      * Track arbitrary event.
      */
@@ -44,7 +44,7 @@ export declare class SegmentAnalytics implements AnalyticsFunction {
     }): Promise<void>;
     identify(): void;
     loadSavedSegmentId(): string;
-    getSegmentTrackingId(): any;
+    getSegmentTrackingId(): string;
     saveTrackingId(segmentId: string): void;
     private ready;
 }