@neo4j-nvl/interaction-handlers 2.0.0-ec6fdba7 → 2.1.0

package/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 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]
+## [2.1.0] - 2026-11-10
 
 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.
 
@@ -24,6 +24,7 @@ This release adds keyboard actions for moving nodes, ships an agent skill for NV
 * `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`.
+* Several dependency updates
 
 ## [2.0.0] - 2026-09-15
 

package/README.md

@@ -33,4 +33,12 @@ clickInteraction.updateCallback('onNodeClick', (node) => {
 
 If you are using React and want to add interactivity to your graph, you can also make use of the InteractiveNvlWrapper.
 
+### Agent skills
+
+The agent skill for NVL (`neo4j-nvl-skill`) ships with `@neo4j-nvl/base`, which this package depends on. To make it available to your AI coding assistant, run the following with a recent version of the `skills` CLI:
+
+```bash
+npx skills experimental_sync
+```
+
 You can find more instructions and examples on how to use NVL interaction handlers in the [docs](https://neo4j.com/docs/nvl/current/interaction-handlers/) and [API docs](https://neo4j.com/docs/api/nvl/current/modules/_neo4j_nvl_interaction_handlers.html), as well as in these [NVL code examples](https://neo4j.com/docs/api/nvl/current/examples.html?tab=plain-interaction-module).

package/lib/interaction-handlers/hover-interaction.d.ts

@@ -27,6 +27,10 @@ export type HoverInteractionCallbacks = {
 /**
  * Interaction handler for hovering nodes and relationships.
  *
+ * @remarks Clusters are not hoverable elements: `element` is never a cluster and no hover state is drawn
+ * for hulls. Read `hitElements.clusters` in {@link HoverInteractionCallbacks.onHover}, or call
+ * {@link NVL.getHits} with `['cluster']`, to react to the pointer being inside a cluster hull.
+ *
  * For examples, head to the {@link https://neo4j.com/docs/nvl/current/interaction-handlers/#_hoverinteraction Hover Interaction documentation page}.
  */
 export declare class HoverInteraction extends BaseInteraction<HoverInteractionOptions> {

package/lib/interaction-handlers/hover-interaction.js

@@ -3,6 +3,10 @@ import { BaseInteraction } from "./base.js";
 /**
 * Interaction handler for hovering nodes and relationships.
 *
+* @remarks Clusters are not hoverable elements: `element` is never a cluster and no hover state is drawn
+* for hulls. Read `hitElements.clusters` in {@link HoverInteractionCallbacks.onHover}, or call
+* {@link NVL.getHits} with `['cluster']`, to react to the pointer being inside a cluster hull.
+*
 * For examples, head to the {@link https://neo4j.com/docs/nvl/current/interaction-handlers/#_hoverinteraction Hover Interaction documentation page}.
 */
 var HoverInteraction = class extends BaseInteraction {

package/lib/interaction-handlers/pan-interaction.d.ts

@@ -54,11 +54,12 @@ export declare class PanInteraction extends BaseInteraction<PanInteractionOption
    * By default, panning is hindered by nodes and relationships.
    *
    * @example
-   * ```js
+   * ```ts
    * import { NVL } from '@neo4j-nvl/base'
    * import { PanInteraction } from '@neo4j-nvl/interaction-handlers'
    *
    * const nvl = new NVL(document.createElement('div'), [{ id: '0' }], [])
+   *
    * const panInteraction = new PanInteraction(nvl)
    *
    * // Pan canvas even when dragging on nodes and relationships

package/lib/interaction-handlers/pan-interaction.js

@@ -36,11 +36,12 @@ var PanInteraction = class extends BaseInteraction {
 	* By default, panning is hindered by nodes and relationships.
 	*
 	* @example
-	* ```js
+	* ```ts
 	* import { NVL } from '@neo4j-nvl/base'
 	* import { PanInteraction } from '@neo4j-nvl/interaction-handlers'
 	*
 	* const nvl = new NVL(document.createElement('div'), [{ id: '0' }], [])
+	*
 	* const panInteraction = new PanInteraction(nvl)
 	*
 	* // Pan canvas even when dragging on nodes and relationships

package/lib/interaction-handlers/zoom-interaction.d.ts

@@ -30,6 +30,10 @@ export type ZoomInteractionCallbacks = {
  * - Scrolling the mouse wheel on the canvas
  * - Using trackpad pinch gestures (equivalent to Ctrl/Cmd + scroll)
  *
+ * @remarks
+ * {@link ZoomInteractionCallbacks.onZoomAndPan} is the only callback. Zooming also changes the pan so the
+ * point under the pointer stays fixed. Zoom limits come from {@link NVL.getZoomLimits}.
+ *
  * For examples, head to the {@link https://neo4j.com/docs/nvl/current/interaction-handlers/#_zoominteraction Zoom Interaction documentation page}.
  */
 export declare class ZoomInteraction extends BaseInteraction<ZoomInteractionOptions> {

package/lib/interaction-handlers/zoom-interaction.js

@@ -7,6 +7,10 @@ import { throttle } from "lodash-es";
 * - Scrolling the mouse wheel on the canvas
 * - Using trackpad pinch gestures (equivalent to Ctrl/Cmd + scroll)
 *
+* @remarks
+* {@link ZoomInteractionCallbacks.onZoomAndPan} is the only callback. Zooming also changes the pan so the
+* point under the pointer stays fixed. Zoom limits come from {@link NVL.getZoomLimits}.
+*
 * For examples, head to the {@link https://neo4j.com/docs/nvl/current/interaction-handlers/#_zoominteraction Zoom Interaction documentation page}.
 */
 var ZoomInteraction = class extends BaseInteraction {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neo4j-nvl/interaction-handlers",
-  "version": "2.0.0-ec6fdba7",
+  "version": "2.1.0",
   "license": "SEE LICENSE IN 'LICENSE.txt'",
   "homepage": "https://neo4j.com/docs/nvl/current/",
   "description": "Interaction handlers for the Neo4j Visualization Library",
@@ -39,7 +39,7 @@
     "eslint": "yarn global:eslint ./src/"
   },
   "dependencies": {
-    "@neo4j-nvl/base": "2.0.0-ec6fdba7",
+    "@neo4j-nvl/base": "2.1.0",
     "concaveman": "1.2.1",
     "lodash-es": "4.18.1"
   },
@@ -48,6 +48,5 @@
     "@types/concaveman": "1.1.6",
     "@types/lodash-es": "4.17.12",
     "tsdown": "0.23.1"
-  },
-  "stableVersion": "2.0.0"
+  }
 }