@neo4j-nvl/base 1.2.2 → 2.0.0-1e695738

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

@@ -1,43 +1,43 @@
-import type { Node, Relationship } from '../../../../types/graph-element';
-import type { WaypointPath } from '../types';
-import ArrowBundle from './ArrowBundle';
+import { WaypointPath } from "../types.js";
+import { Node, Relationship } from "../../../../types/graph-element.js";
+import ArrowBundle from "./ArrowBundle.js";
 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
-     * @param rel - The relationship.
-     * @returns The arrow bundle.
-     */
-    getBundle(rel: Relationship): ArrowBundle;
-    /**
-     * Update the data
-     * @param addedRels - The added relations.
-     * @param removedRels - The removed relations.
-     * @param waypoints - The waypoints.
-     */
-    updateData(addedRels: Record<string, Relationship>, removedRels: Record<string, Relationship>, updatedRels: Record<string, Relationship>, waypoints: Record<string, WaypointPath>): void;
-    /**
-     * Updates the positions of the arrow bundles based on the provided `positionMap`.
-     * @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.
-     * @param id2 - The second ID.
-     * @returns A unique ID for the pair of IDs.
-     */
-    private generatePairId;
-}
+  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
+   * @param rel - The relationship.
+   * @returns The arrow bundle.
+   */
+  getBundle(rel: Relationship): ArrowBundle;
+  /**
+   * Update the data
+   * @param addedRels - The added relations.
+   * @param removedRels - The removed relations.
+   * @param waypoints - The waypoints.
+   */
+  updateData(addedRels: Record<string, Relationship>, removedRels: Record<string, Relationship>, updatedRels: Record<string, Relationship>, waypoints: Record<string, WaypointPath>): void;
+  /**
+   * Updates the positions of the arrow bundles based on the provided `positionMap`.
+   * @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.
+   * @param id2 - The second ID.
+   * @returns A unique ID for the pair of IDs.
+   */
+  private generatePairId;
+}

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

@@ -1,7 +1,7 @@
-import type { BorderStyle } from '../../../../modules/state/types';
-import type { Node, Relationship } from '../../../../types/graph-element';
-import type { Point } from '../../../../utils/geometry';
-import type ArrowBundle from './ArrowBundle';
+import { Point } from "../../../../utils/geometry.js";
+import { Node, Relationship } from "../../../../types/graph-element.js";
+import { BorderStyle } from "../../../../modules/state/types.js";
+import ArrowBundle from "./ArrowBundle.js";
 /**
  * This function calculates the difference in radius between two nodes.
  * @param toArrowGap - The gap between the node and the arrow on the to side.
@@ -19,37 +19,37 @@ export declare const getRadiusDifference: (toArrowGap: number, fromArrowGap: num
  * @returns Object containing angles and coordinate points for the self-loop
  */
 export declare const getSelfArrowControlPoints: (rel: Relationship, node: Node, bundle: ArrowBundle) => {
-    angle: number;
-    startAngle: number;
-    endAngle: number;
-    startPoint: {
-        x: number;
-        y: number;
-    };
-    endPoint: {
-        x: number;
-        y: number;
-    };
-    apexPoint: {
-        x: number;
-        y: number;
-    };
-    control1Point: {
-        x: number;
-        y: number;
-    };
-    control2Point: {
-        x: number;
-        y: number;
-    };
-    nodeGap: number;
+  angle: number;
+  startAngle: number;
+  endAngle: number;
+  startPoint: {
+    x: number;
+    y: number;
+  };
+  endPoint: {
+    x: number;
+    y: number;
+  };
+  apexPoint: {
+    x: number;
+    y: number;
+  };
+  control1Point: {
+    x: number;
+    y: number;
+  };
+  control2Point: {
+    x: number;
+    y: number;
+  };
+  nodeGap: 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;
-    flip: boolean;
+  x: number;
+  y: number;
+  angle: number;
+  flip: boolean;
 };
 /**
  * Calculates the padding for selected relationships based on border style
@@ -71,9 +71,9 @@ export declare const getSelectionPadding: (selectedBorderRings?: BorderStyle["ri
  * @returns Object containing x, y position and angle for the label
  */
 export declare const getRelationshipLabelPosition: (points: Point[], fromNode: Node, toNode: Node, drawCurves: boolean, isSelected: boolean, selectedBorderRings: BorderStyle["rings"], captionAlign?: "top" | "bottom") => {
-    x: number;
-    y: number;
-    angle: number;
+  x: number;
+  y: number;
+  angle: number;
 };
 /**
  * This function calculates the coordinates of the via point
@@ -120,7 +120,7 @@ export declare const getRelationshipWidth: (rel: Relationship, defaultWidth: num
  * @returns Object with adjusted points and the tail offset applied (for label positioning)
  */
 export declare const adjustPointsForGaps: (points: Point[], isSelected: boolean, headHeight: number, headSelectedAdjustment: number, selectedBorderRings: BorderStyle["rings"]) => {
-    tailOffset: Point | null;
+  tailOffset: Point | null;
 };
 /**
  * Calculates arrowhead scaling and dimensions for rendering.
@@ -131,12 +131,12 @@ export declare const adjustPointsForGaps: (points: Point[], isSelected: boolean,
  * @returns Object containing all calculated arrowhead dimensions and adjustments
  */
 export declare const calculateArrowheadScaling: (width: number, isSelected: boolean, selectedBorderRings: BorderStyle["rings"]) => {
-    headFactor: number;
-    headHeight: number;
-    headChinHeight: number;
-    headWidth: number;
-    headSelectedAdjustment: number;
-    headPositionOffset: number;
+  headFactor: number;
+  headHeight: number;
+  headChinHeight: number;
+  headWidth: number;
+  headSelectedAdjustment: number;
+  headPositionOffset: number;
 };
 /**
  * Calculates the dimensions of an arrowhead
@@ -147,10 +147,10 @@ export declare const calculateArrowheadScaling: (width: number, isSelected: bool
  * @returns Object containing headHeight, headChinHeight, headWidth, and headSelectedAdjustment
  */
 export declare const getArrowheadDimensions: (relWidth: number, defaultRelWidth: number, isSelected: boolean, selectedBorderRings: BorderStyle["rings"]) => {
-    headHeight: number;
-    headChinHeight: number;
-    headWidth: number;
-    headSelectedAdjustment: number;
+  headHeight: number;
+  headChinHeight: number;
+  headWidth: number;
+  headSelectedAdjustment: number;
 };
 /**
  * Calculates the size of an overlay icon on a relationship
@@ -166,8 +166,8 @@ export declare const getOverlayIconSize: (iconSizeFactor: number) => number;
  * @returns Object with widthAlign and heightAlign offsets
  */
 export declare const getOverlayIconAlignment: (position: [number, number], width: number, height: number) => {
-    widthAlign: number;
-    heightAlign: number;
+  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;
+export declare const getSelfLoopHeightAlign: (captionAlign: string, fontSize: number, lineWidth: number, padding: number, flip: 1 | -1) => number;

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

@@ -30,7 +30,7 @@ export declare const SelfRefLabelMaxWidth = 40;
 export declare const SelectedWidthFactor = 1.5;
 /** The font styles for relationship captions. */
 export declare const Font: {
-    size: number;
-    color: string;
-    face: string;
-};
+  size: number;
+  color: string;
+  face: string;
+};

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

@@ -1,7 +1,7 @@
-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';
+import { TextSegment } from "../types.js";
+import { Node } from "../../../../types/graph-element.js";
+import { BorderStyles } from "../../../../modules/state/types.js";
+import AnimationHandler from "../../canvasrenderer/AnimationHandler.js";
 /**
  * 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.
@@ -35,8 +35,8 @@ export declare const getNodeIconSize: (mainFaceRadius: number, hasCaption: boole
  * @returns Object with iconXPos and iconYPos
  */
 export declare const getNodeIconPosition: (iconSize: number, hasCaption: boolean, captionAlign: string, iconInfoLevel: number, nodeInfoLevel: number) => {
-    iconXPos: number;
-    iconYPos: number;
+  iconXPos: number;
+  iconYPos: number;
 };
 /**
  * Calculates the size of a node overlay icon
@@ -53,8 +53,8 @@ export declare const getNodeOverlayIconSize: (mainFaceDiameter: number, overlayI
  * @returns Object with iconXPos and iconYPos
  */
 export declare const getNodeOverlayIconPosition: (iconSize: number, mainFaceRadius: number, position: [number, number]) => {
-    iconXPos: number;
-    iconYPos: number;
+  iconXPos: number;
+  iconYPos: number;
 };
 /**
  * Returns the caption font size that should be used
@@ -74,7 +74,7 @@ export declare const infoLevelToFontSize: (infoLevel: number, nodeRadius?: numbe
  * @returns The radius in pixels
  */
 export declare const getNodeRadius: (node: {
-    size?: number;
+  size?: number;
 }) => number;
 /**
  * Prepares node caption data for rendering (works for both Canvas and SVG)
@@ -84,15 +84,15 @@ export declare const getNodeRadius: (node: {
  * @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;
+  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.
@@ -105,6 +105,6 @@ export declare const prepareNodeCaptionData: (node: Node, zoomLevel: number, ctx
  * @returns An array of ring styles with computed widths.
  */
 export declare const getRingStyles: (node: Node, nodeBorderStyles: BorderStyles, animationHandler?: AnimationHandler) => {
-    width: number;
-    color: string;
-}[];
+  width: number;
+  color: string;
+}[];

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

@@ -1,49 +1,48 @@
-import type { Node, Relationship } from '../../../types/graph-element';
-import type { Point } from '../../../utils/geometry';
+import { Point } from "../../../utils/geometry.js";
+import { Node, Relationship } from "../../../types/graph-element.js";
 export type TextSegment = {
-    hasEllipsisChar?: boolean;
-    hasHyphenChar?: boolean;
-    text: string;
-    overflowed?: boolean;
+  hasEllipsisChar?: boolean;
+  hasHyphenChar?: boolean;
+  text: string;
+  overflowed?: boolean;
 };
 /**
  * The caption text and its text style.
  */
 export type StyledCaption = {
-    /**
-     * The font styles as an array of style keywords.
-     * @example `['bold', 'italic']`
-     */
-    styles?: string[];
-    /** The text value for the caption. */
-    value?: string;
-    /** The identifier key for the caption. */
-    key?: string;
+  /**
+   * The font styles as an array of style keywords, e.g. `['bold', 'italic']`.
+   */
+  styles?: string[];
+  /** The text value for the caption. */
+  value?: string;
+  /** The identifier key for the caption. */
+  key?: string;
 };
 export type StyledCaptionWithChars = StyledCaption & {
-    chars?: string[][];
+  chars?: string[][];
 };
 export type CacheItem = {
-    image?: CacheInfo;
-    inverted?: CacheInfo;
+  image?: CacheInfo;
+  inverted?: CacheInfo;
 };
 export type CacheInfo = {
-    canvas: HTMLCanvasElement;
-    image: HTMLImageElement;
-    drawn: boolean;
+  canvas: HTMLCanvasElement;
+  image: HTMLImageElement;
+  drawn: boolean;
 };
 export type Cache = Record<string, CacheItem>;
 export interface RelationshipToRender extends Relationship {
-    fromNode: Node;
-    toNode: Node;
-    showLabel: boolean;
+  fromNode: Node;
+  toNode: Node;
+  showLabel: boolean;
 }
 export interface WaypointPath {
-    points: Point[];
-    from: Point;
-    to: Point;
+  points: Point[];
+  from: Point;
+  to: Point;
 }
 export interface ArrowBundleGap {
-    size: number;
-    start: number;
-}
+  size: number;
+  start: number;
+}

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

@@ -5,12 +5,12 @@ export declare const fontThresholds: [number, number][];
  */
 export declare const overrideOpacity: (color: string, opacity: number) => string;
 export declare const getIndividualInfoLevels: (r: number, zoomLevel: number) => {
-    nodeInfoLevel: number;
-    fontInfoLevel: number;
-    iconInfoLevel: 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;
+export declare const getNodeIconScreenPx: (iconDrawSize: number, zoom: number) => number;

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

@@ -1,21 +1,21 @@
-import type { Point } from '../../../utils/geometry';
+import { Point } from "../../../utils/geometry.js";
 export declare const add: (v1: Point, v2: Point) => {
-    x: number;
-    y: number;
+  x: number;
+  y: number;
 };
 export declare const sub: (v1: Point, v2: Point) => {
-    x: number;
-    y: number;
+  x: number;
+  y: number;
 };
 export declare const scale: (v: Point, s: number) => {
-    x: number;
-    y: number;
+  x: number;
+  y: number;
 };
 export declare const dot: (v1: Point, v2: Point) => number;
 export declare const getModule: (v1: Point) => number;
 export declare const distance: (v1: Point, v2: Point) => number;
 export declare const angle: (v1: Point, v2: Point) => number;
 export declare const coordFromPolar: (polarAngle: number, polarModule: number) => {
-    x: number;
-    y: number;
-};
+  x: number;
+  y: number;
+};

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

@@ -1,6 +1,6 @@
-import type { StyledCaption, TextSegment } from './types';
-export declare const hyphenChar = "\u2010";
-export declare const ellipsisChar = "\u2026";
+import { StyledCaption, TextSegment } from "./types.js";
+export declare const hyphenChar = "‐";
+export declare const ellipsisChar = "…";
 /**
  * Calculates the maximum width for a relationship caption based on the distance
  * between the two center waypoints. Uses Euclidean distance.
@@ -8,8 +8,8 @@ export declare const ellipsisChar = "\u2026";
  * @returns The maximum width for the caption
  */
 export declare const getRelationshipCaptionMaxWidth: (points: {
-    x: number;
-    y: number;
+  x: number;
+  y: number;
 }[]) => number;
 /**
  * This is the main function that tries to fit a text on one or more lines
@@ -49,8 +49,8 @@ export declare const getLines: (ctx: CanvasRenderingContext2D, text: string, fon
  * @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;
+  text: string;
+  style: string;
 }[];
 /**
  * Returns the styles by char for a group of property values.
@@ -58,6 +58,6 @@ export declare const getGroupedTextSpans: (lineText: string, stylesPerChar: stri
  * @return array of list of styles by char
  */
 export declare const getStylesByChar: (captions?: StyledCaption[]) => {
-    stylesPerChar: string[][];
-    fullCaption: string;
-};
+  stylesPerChar: string[][];
+  fullCaption: string;
+};

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

@@ -1,20 +1,19 @@
-import type { NvlState } from '../../../modules/state/types';
-import type { Node } from '../../../types/graph-element';
-import type { RendererOptions } from '../BaseRenderer';
-import BaseRenderer from '../BaseRenderer';
+import { Node } from "../../../types/graph-element.js";
+import { NvlState } from "../../../modules/state/types.js";
+import BaseRenderer, { RendererOptions } from "../BaseRenderer.js";
 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;
-        nodesWidth: number;
-        nodesHeight: number;
-    }, options?: {
-        svg?: SVGSVGElement;
-        backgroundColor?: string;
-        showCaptions?: boolean;
-    }): void;
-}
+  private svg;
+  private measurementContext;
+  constructor(svg: SVGSVGElement, state: NvlState, options?: RendererOptions);
+  clear(): void;
+  render(positionArray: Node[], positionBoundaries?: {
+    centerX: number;
+    centerY: number;
+    nodesWidth: number;
+    nodesHeight: number;
+  }, options?: {
+    svg?: SVGSVGElement;
+    backgroundColor?: string;
+    showCaptions?: boolean;
+  }): void;
+}

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

@@ -1,8 +1,8 @@
-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';
+import { Point } from "../../../utils/geometry.js";
+import { RelationshipToRender } from "../shared/types.js";
+import { BorderStyles, DisabledItemStyles } from "../../../modules/state/types.js";
+import ImageCache from "../shared/ImageCache.js";
+import ArrowBundler from "../shared/arrows/ArrowBundler.js";
 /**
  * Builds an SVG path string for a self-referencing loop using quadratic curves
  */
@@ -19,26 +19,26 @@ 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;
+  tip: Point;
+  base1: Point;
+  base2: Point;
 }, fillColor: string, rings: {
-    color: string;
-    width: number;
+  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;
+  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;
+  color: string;
+  width: number;
 }[]) => SVGPolylineElement[];
 /**
  * Calculates the proper angle for relationship labels to prevent upside-down text (SVG-specific)
@@ -56,4 +56,4 @@ export declare const getCorrectLabelAngle: (angle: number) => number;
  * @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;
+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/nodeDrawing.d.ts

@@ -1,6 +1,6 @@
-import type { BorderStyles, DisabledItemStyles } from '../../../modules/state/types';
-import type { Node } from '../../../types/graph-element';
-import type ImageCache from '../shared/ImageCache';
+import { Node } from "../../../types/graph-element.js";
+import { BorderStyles, DisabledItemStyles } from "../../../modules/state/types.js";
+import ImageCache from "../shared/ImageCache.js";
 /**
  * Renders an array of nodes to an SVG element.
  *
@@ -13,4 +13,4 @@ import type ImageCache from '../shared/ImageCache';
  * @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;
+export declare const renderSvgNodes: (nodesToRender: Node[], svg: SVGElement, zoom: number, idToItem: Record<string, Node>, disabledItemStyles: DisabledItemStyles, defaultNodeColor: string, nodeBorderStyles: BorderStyles, imageCache: ImageCache) => void;