@neo4j-nvl/base 0.3.4 → 0.3.5-4ba40ad3

package/dist/base.mjs.LICENSE.txt

@@ -1,5 +1,16 @@
+/*!
+ * The buffer module from node.js, for the browser.
+ *
+ * @author   Feross Aboukhadijeh <https://feross.org>
+ * @license  MIT
+ */
+
+/*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */
+
 /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */
 
+/*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> */
+
 /**
  * @license
  * Lodash <https://lodash.com/>

package/dist/types/index.d.ts

@@ -7,6 +7,7 @@ import type { Node, PartialNode, PartialRelationship, Relationship } from './typ
 import { CompatibilityError } from './utils/errors';
 import type { Point } from './utils/geometry';
 import type { HitTargetNode, HitTargetRelationship, HitTargets } from './utils/hittest';
+import { nvlResultTransformer } from './utils/jsDriverResultTransformer';
 /**
  * Extends the MouseEvent interface with the {@link HitTargets} property.
  * The result of a _.{@link NVL.getHits} call.
@@ -24,10 +25,7 @@ interface NvlMouseEvent extends MouseEvent {
  * const nodes = [{ id: '1' }, { id: '2' }]
  * const relationships = [{ id: '12', from: '1', to: '2' }]
  *
- * const options = {
- *   layout: 'forceDirected',
- *   initialZoom: 0.5
- * }
+ * const options = { initialZoom: 0.5 }
  *
  * const callbacks = {
  *   onLayoutDone: () => console.log('Layout done')
@@ -35,8 +33,6 @@ interface NvlMouseEvent extends MouseEvent {
  *
  * const nvl = new NVL(document.getElementById('frame'), nodes, relationships, options, callbacks)
  * ```
- *
- * For more examples, head to the {@link https://neo4j.com/docs/nvl/current/core-library/ NVL Base documentation page}.
  */
 declare class NVL {
     #private;
@@ -190,7 +186,7 @@ declare class NVL {
      * the zoom level will be set to the closest valid zoom level,
      * even if the given nodes do not fit the viewport yet.
      */
-    fit(nodeIds: string[], zoomOptions: NvlState['zoomOptions']): void;
+    fit(nodeIds: string[], zoomOptions?: NvlState['zoomOptions']): void;
     /**
      * Resets the zoom of the viewport back to the default zoom level of 0.75
      */
@@ -368,4 +364,4 @@ declare const colorMapperFunctions: {
 };
 export default NVL;
 export type { NvlOptions, Renderer, Node, Relationship, PartialNode, PartialRelationship, Layout, LayoutOptions, ForceDirectedOptions, HierarchicalOptions, ExternalCallbacks, HitTargets, HitTargetNode, HitTargetRelationship, Point, NvlMouseEvent, ZoomOptions, StyledCaption, WebGLRendererType, CanvasRendererType };
-export { NVL, colorMapperFunctions, CompatibilityError, ForceDirectedLayoutType, HierarchicalLayoutType, GridLayoutType, FreeLayoutType, d3ForceLayoutType, drawCircleBand };
+export { NVL, colorMapperFunctions, CompatibilityError, ForceDirectedLayoutType, HierarchicalLayoutType, GridLayoutType, FreeLayoutType, d3ForceLayoutType, drawCircleBand, nvlResultTransformer };

package/dist/types/layouts/forcedirectedlayout/ForceCytoLayout.d.ts

@@ -16,7 +16,7 @@ export declare class ForceCytoLayout {
     getShouldUpdate(): boolean;
     getComputing(): boolean;
     updateNodes(positionList: any): void;
-    getNodePositions(data: any): import("../..").Node[];
+    getNodePositions(data: any): import("../../types/graph-element").Node[];
     terminateUpdate(): void;
     destroy(): void;
 }

package/dist/types/layouts/forcedirectedlayout/cosebilkentlayout/CoseBilkentLayout.d.ts

@@ -15,13 +15,13 @@ export declare class CoseBilkentLayout extends AnimatedLayout {
     cytoCompleteCallback: () => void;
     computing: boolean;
     pendingLayoutData: LayoutData;
-    worker: SharedWorker | any;
+    worker: SharedWorker;
     constructor(config: {
         state: NvlState;
         cytoCompleteCallback?: () => void;
         animationCompleteCallback?: () => void;
     });
-    setupWorker(): Promise<unknown>;
+    setupWorker(): Promise<SharedWorker>;
     setOptions(): void;
     update(refreshPositions?: boolean, updateMobXNodes?: Node[], updateMobXRelationships?: Relationship[]): void;
     getShouldUpdate(): boolean;

package/dist/types/layouts/forcedirectedlayout/physlayout/solarmerger/SolarMerger.d.ts

@@ -19,7 +19,7 @@ export default class SolarMerger {
         idToRel: {};
     };
     nodeSortMap: {};
-    coarsenBy(level: any): {
+    coarsenBy(levelToCoarsenBy: any): {
         nodes: any[];
         relationships: any[];
         idToRel: {};

package/dist/types/layouts/gridLayout/GridLayout.d.ts

@@ -7,7 +7,7 @@ export class GridLayout {
     setOptions(options: any): void;
     updateNodes(positionList: any): void;
     update(refreshPositions?: boolean): void;
-    layout(nodes: any, nodeIds: any, idToPosition: any, rels: any): void;
+    layout(mobxNodes: any, nodeIds: any, idToPosition: any, rels: any): void;
     getNodePositions(nodeList: any): any[];
     getShouldUpdate(): boolean;
     getComputing(): boolean;

package/dist/types/layouts/hierarchicallayout/HierarchicalLayout.d.ts

@@ -15,7 +15,7 @@ export declare class HierarchicalLayout extends AnimatedLayout {
     private directionChanged;
     private packingChanged;
     constructor(config: HierarchicalLayoutConfig);
-    setupWorker(): Promise<unknown>;
+    setupWorker(): Promise<SharedWorker>;
     setOptions(options: LayoutOptions): void;
     update(refreshPositions?: boolean): void;
     getShouldUpdate(): boolean;

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

@@ -12,12 +12,15 @@ export interface ExternalCallbacks {
     /** Triggered when a asynchronous layout calculation starts/stops. */
     onLayoutComputing?: (isComputing: boolean) => void;
     onWebGLContextLost?: (webGLContextEvent: WebGLContextEvent) => void;
+    /** Triggered when a zoom transition (e.g. {@link NVL.fit} or {@link NVL.resetZoom}) function is done. */
+    onZoomTransitionDone?: () => void;
     restart?: () => void;
 }
 export declare const isExternalCallback: (callback: unknown) => callback is keyof ExternalCallbacks;
 export default class ExternalCallbackHandler {
     callbacks: ExternalCallbacks;
     constructor(externalCallbacks?: ExternalCallbacks);
+    onZoomTransitionDone(): void;
     onLayoutDone(): void;
     onLayoutStep(p: Node[]): void;
     onLayoutComputing(isComputing: boolean): void;

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

@@ -8,6 +8,7 @@ type SaveToFileOptions = {
     backgroundColor?: string;
 };
 export declare const EVENT_ERROR = "onError";
+export declare const EVENT_ZOOM_TRANSITION_DONE = "onZoomTransitionDone";
 export declare const EVENT_LAYOUT_DONE = "onLayoutDone";
 export declare const EVENT_LAYOUT_STEP = "onLayoutStep";
 export declare const EVENT_LAYOUT_COMPUTING = "onLayoutComputing";
@@ -95,7 +96,7 @@ export default class NvlController {
     setZoomLevel(_newLevel: number): void;
     setPanCoordinates(panX: number, panY: number): void;
     setZoomAndPan(zoom: number, panX: number, panY: number): void;
-    fit(nodeIds: string[], zoomOptions: ZoomOptions): void;
+    fit(nodeIds: string[], zoomOptions?: ZoomOptions): void;
     resetZoom(): void;
     setRenderer(renderer: string): void;
     on(name: keyof ExternalCallbacks, callback: (args: unknown) => void): void;

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

@@ -9,16 +9,14 @@ export default class ZoomTransitionHandler {
     private firstUpdate;
     private readonly state;
     private readonly canvas;
-    private readonly defaultZoomLevel;
     private readonly stateDisposers;
-    constructor({ state, getNodePositions, canvas, defaultZoomLevel }: {
+    constructor({ state, getNodePositions, canvas }: {
         state: NvlState;
         getNodePositions: (data: Node[]) => Node[];
         canvas: HTMLCanvasElement;
-        defaultZoomLevel: number;
     });
     needsToRun(): boolean;
-    update(layoutActive: boolean): void;
+    update(layoutActive: boolean, onTransitionCompleted?: () => void): void;
     destroy(): void;
     private recalculateTarget;
     private allNodesAreVisible;

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

@@ -13,10 +13,10 @@ export default class PerformanceTester {
     /**
      * Starts a performance measurement. Every call to this method must be followed
      * by a call to endTest(). Tests can be nested.
-     * @param  {String} name String identifying this measurement. Only used for printing, so
+     * @param  {String} measurement String identifying this measurement. Only used for printing, so
      *                       keep it human readable.
      */
-    startTest(name: string): void;
+    startTest(measurement: string): void;
     /**
      * Ends the last started test, giving it an end time.
      */

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

@@ -196,6 +196,8 @@ export type ZoomOptions = {
     minZoom?: number;
     /** The maximum zoom value for the fit-to-zoom operation. */
     maxZoom?: number;
+    /** If true, will not animate the zoom/pan transition. */
+    animated?: boolean;
 };
 export interface NvlState {
     zoom: number;

package/dist/types/types/graph-element.d.ts

@@ -65,9 +65,15 @@ interface Node extends GraphElement {
     size?: number;
     /** Whether or not the current node is pinned.*/
     pinned?: boolean;
-    /** The x-coordinate for the position of the node.*/
+    /**
+     * @ignore
+     * The x-coordinate for the position of the node.
+     */
     x?: number;
-    /** The y-coordinate for the position of the node.*/
+    /**
+     * @ignore
+     * The y-coordinate for the position of the node.
+     */
     y?: number;
     /** Whether or not the current node is activated.*/
     activated?: boolean;

package/dist/types/utils/jsDriverResultTransformer.d.ts

@@ -0,0 +1,32 @@
+import type { Node as DriverNode, Relationship as DriverRelationship, Path, Record } from 'neo4j-driver';
+export declare const recordMapper: (record: Record) => any[];
+export declare const recordCollector: (graphElements: (DriverNode | DriverRelationship | Path)[][]) => {
+    recordObjectMap: Map<any, any>;
+    nodes: any[];
+    relationships: any[];
+};
+/**
+ * Result transformer for the Neo4j JavaScript driver results to NVL graph elements.
+ * @example
+ *
+ * ```ts
+ * import neo4j from "neo4j-driver";
+ * import { nvlResultTransformer, NVL } from "@neo4j-nvl/base";
+ *
+ * const driver = neo4j.driver("{uri}", neo4j.auth.basic("{user}", "{password}"));
+ * const nvlGraph = await driver.executeQuery(
+ *   "MATCH (a)-[r]-(b) RETURN a,r,b LIMIT 25",
+ *   {},
+ *   { resultTransformer: nvlResultTransformer }
+ * );
+ *
+ * const nvl = new NVL(document.getElementById('viz'), nvlGraph.nodes, nvlGraph.relationships);
+ * ```
+ *
+ * @see {@link https://neo4j.com/docs/api/javascript-driver/current/class/lib6/result-transformers.js~ResultTransformers.html|ResultTransformers on Neo4j JS Driver API Docs}
+ */
+export declare const nvlResultTransformer: import("neo4j-driver-core/types/result-transformers").ResultTransformer<{
+    recordObjectMap: Map<any, any>;
+    nodes: any[];
+    relationships: any[];
+}>;

package/dist/types/utils/jsDriverResultTransformer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neo4j-nvl/base",
-  "version": "0.3.4",
+  "version": "0.3.5-4ba40ad3",
   "license": "SEE LICENSE IN 'LICENSE.txt'",
   "homepage": "https://neo4j.com/docs/nvl/current/",
   "description": "Base library for the Neo4j Visualization Library",
@@ -19,16 +19,16 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc && webpack",
+    "build": "yarn global:tsc && webpack",
     "watch": "concurrently 'tsc -w' 'webpack -w' -k -n 'tsc,webpack' -c 'cyan,magenta'",
-    "test": "jest",
-    "eslint": "eslint ./src/ --plugin only-warn",
+    "test": "yarn global:jest",
+    "eslint": "yarn global:eslint ./src/",
     "coverage": "yarn test --coverage --silent",
     "prepack": "cp ../../LICENSE.txt ./",
     "postpack": "rm LICENSE.txt"
   },
   "dependencies": {
-    "@neo4j-nvl/layout-workers": "0.3.4",
+    "@neo4j-nvl/layout-workers": "0.3.5-4ba40ad3",
     "@segment/analytics-next": "^1.70.0",
     "color-string": "^1.9.1",
     "d3-force": "^3.0.0",
@@ -50,16 +50,13 @@
     "@types/tinycolor2": "^1.4.6",
     "babel-loader": "^8.2.5",
     "copy-webpack-plugin": "^11.0.0",
-    "eslint": "^8.38.0",
-    "jest": "^29.7.0",
+    "neo4j-driver": "^5.26.0",
     "typedoc": "^0.23.15",
-    "typescript": "^5.4.5",
     "webpack": "^5.75.0",
     "webpack-cli": "^5.0.0"
   },
+  "stableVersion": "0.3.5",
   "peerDependencies": {
-    "eslint": "*",
-    "jest": "*",
-    "typescript": "*"
+    "neo4j-driver": "*"
   }
 }