@neo4j-nvl/base 1.2.0 → 1.2.2

package/dist/types/index.d.ts

@@ -139,7 +139,11 @@ declare class NVL {
     removeRelationshipsWithIds(relationshipIds: string[]): void;
     /**
      * Returns all nodes that is currently stored in the visualisation.
+     * `x` and `y` are client/screen coordinates relative to the canvas.
      * @returns The array of {@link Node nodes}.
+     *
+     * @note In the next major release, `x` and `y` become layout coordinates and
+     * screen coordinates move to a `clientPosition` field.
      */
     getNodes(): Node[];
     /**

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

@@ -5,7 +5,13 @@ import type { Node } from '../types/graph-element';
 export interface ExternalCallbacks {
     /** Triggered when a layout is done moving. */
     onLayoutDone?: () => void;
-    /** Triggered on each step of a layout. */
+    /**
+     * Triggered on each step of a layout.
+     * Node `x` and `y` are client/screen coordinates relative to the canvas.
+     *
+     * @note In the next major release, `x` and `y` become layout coordinates and
+     * screen coordinates move to a `clientPosition` field.
+     */
     onLayoutStep?: (p: Node[]) => void;
     /** Triggered when NVL throws an error after initialization. */
     onError?: (error: Error) => void;

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

@@ -43,6 +43,9 @@ export interface ForceDirectedOptions {
      * rendering problems on Intel graphics hardware.
      *
      * @remarks Requires a restart of NVL as shaders need to be recompiled.
+     *
+     * @deprecated This option will be removed in a future release, where WebGL will be upgraded to WebGL2,
+     * which resolves the compatibility issues with Intel GPUs.
      */
     intelWorkaround?: boolean;
     /**
@@ -223,7 +226,16 @@ export interface NvlOptions {
         disabledItemColor?: string;
         /** The color to use for the labels of the disabled nodes and relationships */
         disabledItemFontColor?: string;
-        /** The color to use for the viewport box in the minimap */
+        /**
+         * Stroke color for overlay UI lines (e.g. minimap viewport box).
+         * Use a dark color on light backgrounds and a light color on dark backgrounds.
+         * @defaultValue `#1A1B1D`
+         */
+        overlayLineColor?: string;
+        /**
+         * The color to use for the viewport box in the minimap.
+         * @deprecated Use {@link overlayLineColor}.
+         */
         minimapViewportBoxColor?: string;
     };
     /**
@@ -317,6 +329,6 @@ export interface NvlState {
     disabledItemStyles: DisabledItemStyles;
     defaultNodeColor: string;
     defaultRelationshipColor: string;
-    minimapViewportBoxColor: string;
+    overlayLineColor: string;
 }
 export {};

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

@@ -6,7 +6,7 @@ import type { NvlOptions } from './types';
  * If both caption and captions are provided, captions takes precedence.
  */
 export declare const processCaptions: (item: Partial<Node | Relationship>) => StyledCaption[];
-export declare const processColorStyles: (styling: NvlOptions["styling"]) => {
+export declare const processColorStyles: (styling?: NvlOptions["styling"]) => {
     nodeBorderStyles: {
         default: {
             rings?: {
@@ -42,5 +42,5 @@ export declare const processColorStyles: (styling: NvlOptions["styling"]) => {
     };
     defaultNodeColor: string;
     defaultRelationshipColor: string;
-    minimapViewportBoxColor: string;
+    overlayLineColor: string;
 };

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neo4j-nvl/base",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "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",
+    "@neo4j-nvl/layout-workers": "1.2.2",
     "@segment/analytics-next": "1.81.1",
     "color-string": "1.9.1",
     "d3-force": "3.0.0",
@@ -42,10 +42,10 @@
     "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",