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

package/CHANGELOG.md

@@ -2,6 +2,72 @@
 
 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/).
 
+## [Unreleased]
+
+This release adds keyboard actions for moving nodes, ships an agent skill for NVL, and makes all packages loadable as ESM in Node.js without a bundler.
+
+### Added
+
+* Keyboard interaction handler actions for moving nodes with the arrow keys, with a new `onNodeMove` callback.
+* Agent skill files for NVL, shipped with `@neo4j-nvl/base`.
+
+### Changed
+
+* `@neo4j-nvl/react` and `@neo4j-nvl/interaction-handlers` are now spec-compliant ESM with `"type": "module"` and an `exports` map. Note that deep imports into `lib/` will no longer work.
+* Replaced `lodash` with `lodash-es` in `@neo4j-nvl/react` and `@neo4j-nvl/interaction-handlers` (Jest users transforming `@neo4j-nvl/*` also need to transform `lodash-es`).
+* Type declarations of `@neo4j-nvl/base` now resolve correctly with `moduleResolution: "nodenext"`.
+* Container resizing uses the native `ResizeObserver` instead of the `resizelistener` dependency.
+* Default `height` and `outline` styles of NVL containers can now be overridden by stylesheets.
+
+### Fixed
+
+* `fit()` zooms out beyond `minZoom` when `allowDynamicMinZoom` is `true` and the graph does not fit the viewport.
+* `onHover` callback's `element` parameter is now typed as possibly `undefined`, matching the runtime behaviour.
+* Added missing caret for the React 18 peer dependency range in `@neo4j-nvl/react`.
+
+## [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.

package/README.md

@@ -36,6 +36,14 @@ const nvl = new NVL(document.getElementById('frame'), nodes, relationships, opti
 
 You can find more instructions and examples on how to use NVL in the [docs](https://neo4j.com/docs/nvl/current/).
 
+### Agent skills
+
+This package ships an agent skill for NVL (`neo4j-nvl-skill`) that helps AI coding assistants write correct NVL code for the version you have installed. To make the skill available to your agent, run:
+
+```bash
+npx skills experimental_sync
+```
+
 ### Product analytics
 
 In order to improve the library we are collecting some information about the usage of NVL. If you prefer to disable this behavior set the parameter `disableTelemetry=true` as a parameter in `nvlOptions`.