# Changelog All notable changes to NVL will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). ## [1.2.0] - 2026-05-27 This 1.2.0 release introduces a new keyboard interaction handler and SVG support for the static image wrapper React component. It also includes several performance improvements for clustering and text/icon rendering, as well as several bug fixes. ### Added * SVG format support in the static image wrapper. * Keyboard interaction handlers. ### Changed * Boost performance of graph clustering for force directed layouts. * Optimize Canvas rendering performance by caching expensive operations. * Deprecate Cytoscape support. ### Fixed * Fix Arabic text rendering issues to ensure characters stay connected. * Prevent arrow ends from bouncing by removing position rounding. * Fix issue where D3 layout would occasionally fail to display. * Fix node position loss during a restart when the device pixel ratio changes. * Add missing support for relationship overlay icons within the SVG renderer. * Fix bug where reactive zoom values were not consistently applied. * Correct the pinch-to-zoom speed scaling on the minimap. * Add safety guards against non-finite values to prevent runtime rendering errors. * Ensure fit targets respect `maxZoom` constraints even when omitted from `zoomOptions`. * Force canvas repaint when icon images finish asynchronous loading. ## [1.1.0] - 2026-02-16 This 1.1.0 release introduces new rendering capabilities with the addition of a new SVG export method, alongside a new Circular Layout algorithm and touchpad gestures for zooming. It also includes performance improvements for the renderer and physics engine, as well as various fixes for the React wrappers and Minimap. ### Added - new SVG export functionality. - new circular layout option. - two-finger pinch gesture to zoom with touchpads. - onCanvasDoubleClick callback to the interactive NVL React wrapper. ### Changed - improved minimap handling for React components. - rendering performance improvements. - physics layout performance and gravity improvements. ### Fixed - seed radius calculation in D3 layout for large graphs. - forceDirected layout unnecessarily reheating on switch without changes. - ensure drag operations are always correctly ended on mouse up. - minimap positioning issues. - background color for the 'os' theme in api documentation. ## [1.0.0] - 2025-09-30 This 1.0.0 release is our first major release, with NVL's release strategy fully adopting semantic versioning going forward. Updates in this release include React 19 support for the React wrappers, a UI overhaul of the [examples app](https://neo4j.com/docs/api/nvl/current/examples.html). ### Added * support for React 19 in Nvl React wrappers. * new prop to the React components to provde zoom and pan values. * extend return object of `.getZoomTargetForNodePositions` function to include pan values. ### Changed * updated example application UI. ### Fixed * display remaining captions when one of the values in the caption array is null or undefined. * ensure the computing state for the d3 layout is set correctly. * correctly process Right-to-Left (RTL) text for node captions. ### Removed * `useWebGL` / `setUseWebGLRenderer`, please use [renderer](https://neo4j.com/docs/api/nvl/current/interfaces/_neo4j_nvl_base.NvlOptions.html#renderer) & [setRenderer](https://neo4j.com/docs/api/nvl/current/classes/_neo4j_nvl_base.NVL.html#setRenderer) instead going forward. * `NvlOption.nodeDefaultBorderColor`, `NvlOption.selectedBorderColor`, `NvlOption.disabledItemColor`, `NvlOption.disabledItemFontColor`, please use properties with the same name in [NvlOptions.styling](https://neo4j.com/docs/api/nvl/current/interfaces/_neo4j_nvl_base.NvlOptions.html#styling) object going forward. ## [0.3.9] - 2025-07-23 The 0.3.9 release contains several fixes for NVL's interaction handler and adds a new method to NVL to directly extract image data from an NVL instance: ### Added * new export method for image data url called `.getImageDataUrl` * new callback triggered when NVL is fully initialized called `onInitialization`. ### Changed * updated license agreement in `LICENSE.txt`. * prevent zoom interaction handler to zoom in NVL when ctrl or meta key is pressed. * improve handling of leaving NVL container while performing selection using the lasso and box interaction handlers. ### Fixed * fix error on onDragEnd callback. * fix race condition when hovering over an element that is being dismissed. * fix nodes moving on clicks. * prevent crash when providing non-existent node ids to `.setNodePositions` method. * fix slow zoom speed for touchpads in zoom interaction handler. * Ensure interaction handlers in react component waits for NVL to be initialised first. ## [0.3.8] - 2025-03-18 This release contains a fix for the [NVL result transformer](https://neo4j.com/docs/api/nvl/current/functions/_neo4j_nvl_base.nvlResultTransformer.html). ### Fixed * NVL result transformer to be able to handle deeply nested records ## [0.3.7] - 2025-02-28 ### Added * Export zoom functionalities as a named function * Add a `positions` prop to the react wrapper * Color custimzation options * Aria attributes for NVL canvas and option to disable them * Option to disable web workers ### Changed * Change default threshold when relationship captions are displayed * update default selection color and default node color to be aligned with the Neo4j Design Library ### Deprecated * `selectedBorderColor` - use `styling.selectedBorderColor` instead * `nodeDefaultBorderColor` - use `styling.nodeDefaultBorderColor` instead ### Fixed * Fix icon colors not being inverted for dark node colors * fix bug where selected border color was not processed if a default border color was not provided in options * Address several warnings during initialization * Address multi-select callback inconsistencies * Canvas renderer performance improvements * ensure properties provided via `nvlOptions` are also updated on prop change in React wrappers ## [0.3.6] - 2025-02-21 NVL 0.3.6 improves the API docs and adds a result transformer for the Neo4j JavaScript Driver, as well as small improvements and bug fixes. ### Added - [result transformer for the Neo4j JavaScript Driver](https://neo4j.com/docs/api/nvl/current/functions/_neo4j_nvl_base.nvlResultTransformer.html) - [option](https://neo4j.com/docs/api/nvl/current/types/_neo4j_nvl_base.ZoomOptions.html) to disable transition when fitting nodes ### Fixed - lasso handler issues during initialization ## [0.3.5] - 2025-02-20 NVL 0.3.5 contains several bug fixes and changes the default rendering method of NVL from "webgl" to "canvas". ### Changed - Change default value for renderer to canvas ### Fixed - Self-referring relationship overlay icon rotation position issue - Invalid lasso area calculation when segment from first to last point intersects ## [0.3.4] - 2025-02-19 With this release, we are updating our docs and READMEs and publishing NVL's API documentation and examples on neo4j.com/docs/api/nvl/current. ### Added - NVL's API documentation and examples on [neo4j.com/docs/api/nvl/current](http://neo4j.com/docs/api/nvl/current). - A fallback implementation for web workers when they aren't avilable in the current environment. - A new onDrawStarted callback for the [draw interaction handler](https://neo4j.com/docs/api/nvl/current/classes/_neo4j_nvl_interaction_handlers.DrawInteraction.html) ### Fixed - Issues with lasso shape when parts of it are close to each other - NVL crash when sometimes position map and nodeToBundle are out of sync ## [0.3.3] - 2025-02-18 This is a patch release to address a dependency issue in 0.3.2 ### Fixed - Move Segment dependency from dev dependencies - Ensure workspace version references point to exact version ## [0.3.2] - 2025-02-17 This is our first patch release since going GA in May. ### Added - [Telemetry](https://neo4j.com/docs/api/nvl/current/interfaces/_neo4j_nvl_base.NvlOptions.html#disableTelemetry) - [Examples](https://neo4j.com/docs/api/nvl/current/examples.html) in API documentation - More information in package.json files - Overlay icons for nodes and relationships - Links to documentation websites in readme ### Fixed - Fixed zoom to fit for self relationships - Aalign selected border color - Issues with WebGL error propagation - Issue with key captures on mouse click in draw-interactions - Zoom to fit finishing too early - Improve imagecache error handling - Minimap viewport box not rendering ## [0.3.1] - 2025-02-16 This is our first GA release of NVL. ### Added - Expose callback types through interactive react wrapper - Feature/adv interaction fw drag callbacks amendments - Add [lasso select interaction module](https://neo4j.com/docs/api/nvl/current/classes/_neo4j_nvl_interaction_handlers.LassoInteraction.html) - Configurable node ring styles - Support React concurrent mode in React wrappers - [`renderer`](https://neo4j.com/docs/api/nvl/current/interfaces/_neo4j_nvl_base.NvlOptions.html#renderer) and [`setRenderer`](https://neo4j.com/docs/api/nvl/current/classes/_neo4j_nvl_base.NVL.html#setRenderer) API option and method ### Deprecated - `useWebGL` and `setUseWebGL` (use `renderer` and `setRenderer` instead). ### Changed - Core library is now named "base" library - All packages are published publicly - Refactor rel validation method to improve performance - Convert layout web workers to shared workers - Don't check for WebGL availability if WebGL is disabled by NVL [`disableWebGL`](https://neo4j.com/docs/api/nvl/current/interfaces/_neo4j_nvl_base.NvlOptions.html#disableWebGL) option ### Removed - Remove deprecated elements ### Fixed - Wrong directions in a relationship bundle - Issues with node and relationship id handling when strings are not numeric - Zoom/pan jitter removal - Ensure all interaction handlers return mouse events - Cytoscape behaviour fixes - Drag triggers too early - Fix issue where right clicking sometime also triggers mouseup event - Issues in dynamic zoom boundaries - Don't trigger panning when mouse down was outside of NVL - Only register callbacks if provided - Ensure fit operation does not keep going on when zoom limit is reached - Only update hover effect of elements when graph is not empty - Ensure zoom to fit continues if panning has not finished yet - Improve html overlay scaling - Ensure Webgl context is released when NVL instance is destroyed - Emoji in captions not rendering correctly