@neo4j-nvl/base 1.2.1 → 2.0.0-41738c4a

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 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/).
 
+## [2.0.0] - 2026-09-15
+
+This 2.0.0 major release upgrades NVL to WebGL2 for both the renderer and physics engine, unlocking major performance improvements. It also adds new clustering capabilities with visual decorations to the force directed and hierarchical layouts.
+
+### Added
+
+* `clusterBy` layout option for both force-directed and hierarchical layouts.
+* Cluster interaction API for handling events on clustered elements.
+* Support for rendering icons and arrowheads in the WebGL renderer.
+* Configurable minimum and maximum FPS caps for the rendering loop.
+* Circle seeding option for the physics layout.
+
+### Changed
+
+* Upgraded the WebGL renderer and physics engine to use WebGL2.
+* Migrated the hierarchical layout engine dependency to `@dagrejs/dagre` 3.1.1.
+* Greatly optimized physics layout performance and stabalisation speed.
+* Improved rendering performance.
+
+### Fixed
+
+* Added safety guards to harden the renderer against missing X/Y coordinate data.
+
+### Removed
+
+* **BREAKING:** Removed deprecated Cytoscape support settings.
+* **BREAKING:** Removed deprecated standalone `layout` and `layoutOptions` props from the React wrappers in favour of the same props inside `NvlOptions`.
+* **BREAKING:** Removed deprecated `intelWorkaround` layout setting APIs.
+* **BREAKING:** Removed deprecated `onZoom` callback in favour of `onZoomAndPan`.
+
+## [1.2.2] - 2026-09-11
+
+This 1.2.2 patch release adds migration warnings for breaking changes planned for the next major release.
+
+### Added
+* `styling.overlayLineColor` for overlay UI stroke color (e.g. minimap viewport box).
+* Note in documentation on changes to client/screen coordinates on `NVL.getNodes()` and `onLayoutStep` `x`/`y`, moving screen coordinates to `clientPosition`.
+
+### Deprecated
+* `styling.minimapViewportBoxColor` in favour of `styling.overlayLineColor` (old option still works as a fallback).
+* `ForceDirectedOptions.intelWorkaround` (upgrade to WebGL2 in the next major release removes the need for it).
+* Top-level React wrapper `layout` / `layoutOptions` props in favour of `nvlOptions.layout` / `nvlOptions.layoutOptions`.
+
 ## [1.2.1] - 2026-07-28
 
 This 1.2.1 patch release contains several fixes and accessibility improvements.