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

package/skills/neo4j-nvl-skill/references/react-wrappers.md

@@ -0,0 +1,88 @@
+# React wrappers
+
+When you need this: you use `<InteractiveNvlWrapper>` or `<BasicNvlWrapper>` from `@neo4j-nvl/react` and something does not react to a prop change, a callback sees stale state, or an interaction does not start.
+
+Verification tags: **source** = `packages/react/src` in the NVL repository, **types** = shipped `.d.ts`, **runtime** = observed in a running app.
+
+## Which wrapper
+
+- `<InteractiveNvlWrapper>`: `<BasicNvlWrapper>` plus every interaction handler, toggled through `mouseEventCallbacks` and `keyboardEventCallbacks`.
+- `<BasicNvlWrapper>`: NVL only. Use it when you wire interactions yourself through the `ref`.
+
+Both forward a `ref` to the `NVL` instance (`useRef<NVL>(null)`) and pass unknown props to the container `<div>`. The container is `height: 100%`, so the **parent** needs an explicit height. *source*
+
+## `mouseEventCallbacks` → handler
+
+A key set to a function enables the handler and registers the callback; `true` enables the handler with no callback; `false` destroys the handler; omitted means off. *source*
+
+| Handler | Keys |
+|---|---|
+| Hover | `onHover` |
+| Click | `onNodeClick`, `onRelationshipClick`, `onCanvasClick`, `onClusterClick`, and the `...DoubleClick` / `...RightClick` variants |
+| Pan | `onPan` |
+| Zoom (wheel) | `onZoomAndPan` |
+| Drag nodes | `onDrag`, `onDragStart`, `onDragEnd` |
+| Draw | `onHoverNodeMargin`, `onDrawStarted`, `onDrawEnded` |
+| Box select | `onBoxStarted`, `onBoxSelect` |
+| Lasso | `onLassoStarted`, `onLassoSelect` |
+| Keyboard (`keyboardEventCallbacks`) | `onKeyDown`, `onKeyUp`, `onNodeFocus`, `onNodeBlur` |
+
+There is no `onZoom` key. `{ onZoom: true }` is ignored and wheel zoom stays off. *source*
+
+Interaction callbacks are re-registered whenever the function identity changes, so they are **not** subject to the stale-closure problem below. *source*
+
+## `nvlCallbacks` are captured once
+
+`BasicNvlWrapper` passes `nvlCallbacks` to the `NVL` constructor and never updates them. A callback that closes over state sees the state from the first render. *source*
+
+```tsx
+const selectedRef = useRef(selected)
+selectedRef.current = selected
+
+const nvlCallbacks = useMemo(() => ({
+  onLayoutDone: () => console.log('layout done, selected:', selectedRef.current)
+}), [])
+```
+
+## Which `nvlOptions` update after creation
+
+Only these are watched by effects: `layout` (`setLayout`), `layoutOptions` (deep-compared, `setLayoutOptions`), `renderer` (`setRenderer`), `disableWebGL` (`setDisableWebGL`). Everything else (`styling`, `minZoom`, `initialZoom`, `disableTelemetry`, `disableWebWorkers`, ...) is read at construction. *source*
+
+Separate props with live effects: `positions` (`setNodePositions`), `zoom` and `pan` (`setZoom` / `setPan` / `setZoomAndPan`). *source*
+
+To change a creation-time option, call `nvlRef.current.restart(newOptions, true)` or remount the wrapper with a `key`.
+
+## `nodes` / `rels` diffing
+
+On every render the wrapper diffs the new arrays against the previous ones by `id`, then calls `addAndUpdateElementsInGraph` for added and changed elements and `removeNodesWithIds` / `removeRelationshipsWithIds` for removed ones. *source*
+
+- Only keys whose value changed are sent, so updates are partial. A key set to `undefined` is sent (and clears the attribute); a key that is omitted is not. *source*
+- Changing `x` / `y` on an existing node does **not** move it; positions are only read on insert. Use the `positions` prop or `setNodePositions`. *source*
+- `pinned` does apply through the diff. *runtime*
+- Keep the arrays referentially stable between renders (`useMemo`) or the diff runs on every render.
+
+## `minimapContainer` must exist first
+
+If `nvlOptions.minimapContainer` is present, NVL is not created until it is non-null. With a plain `useRef` the element is `null` on the first render and NVL never starts; hold the element in state via a callback ref. *source*
+
+```tsx
+const [minimapEl, setMinimapEl] = useState<HTMLDivElement | null>(null)
+const nvlOptions = useMemo(() => ({ minimapContainer: minimapEl }), [minimapEl])
+
+<div ref={setMinimapEl} style={{ width: 200, height: 150 }} />
+<InteractiveNvlWrapper nvlOptions={nvlOptions} ... />
+```
+
+## `interactionOptions` replaces the defaults
+
+The default is `{ selectOnClick: false, drawShadowOnHover: true, selectOnRelease: false, excludeNodeMargin: true }`. Passing the prop replaces this object, so `interactionOptions={{ selectOnClick: true }}` turns the hover shadow off. Pass every option you want. *source*
+
+Keep the object stable (`useMemo`); a new object each render re-runs every interaction effect.
+
+## Selection toggles twice / handlers duplicated
+
+Flipping `selectOnClick` or other `interactionOptions` across renders, or registering your own `container.addEventListener('click')` next to the wrapper's `ClickInteraction`, produces double handling. Set the options once and use the wrapper's callbacks.
+
+## Teardown
+
+The wrappers call `nvl.destroy()` on unmount and destroy their handlers. Only manual `new NVL(...)` in a `useEffect` needs an explicit `return () => nvl.destroy()`.

package/skills/neo4j-nvl-skill/references/verifying-nvl-apps.md

@@ -0,0 +1,52 @@
+# Verifying NVL apps
+
+When you need this: you want to check from a test, a script or a headless browser that the graph rendered, the layout finished, or nodes are where you expect.
+
+Verification tags: **source**, **types**, **runtime** (see `SKILL.md`).
+
+## Window hooks
+
+Every NVL instance registers these on `window` (declared in `nvl-window-functions.d.ts`). They are read-only test hooks; `instanceId` is the `nvlOptions.instanceId` you gave (default `'default'`). With several instances and no id, the most recently created one answers. *source*
+
+| Hook | Returns |
+|---|---|
+| `__Nvl_dumpNodes(instanceId?)` | `NodeWithClientPosition[]`: every node with `x`, `y` and `clientPosition` |
+| `__Nvl_dumpRelationships(instanceId?)` | `Relationship[]` |
+| `__Nvl_getNodesOnScreen(instanceId?)` | `{ nodes, rels }` currently inside the viewport |
+| `__Nvl_getZoomLevel(instanceId?)` | current zoom |
+| `__Nvl_registerDoneCallback(cb, instanceId)` | registers `cb` for `onLayoutDone`; note the argument order |
+
+Playwright example (the pattern used by this repository's build-tool tests): *source*
+
+```typescript
+await expect.poll(() => page.evaluate('window.__Nvl_dumpNodes !== undefined')).toBeTruthy()
+await expect.poll(() => page.evaluate(() => window.__Nvl_dumpNodes().length)).toBe(42)
+await page.evaluate(() => new Promise<void>((resolve) => window.__Nvl_registerDoneCallback(resolve, 'default')))
+```
+
+## Detecting a settled layout
+
+- Preferred: `onLayoutDone` (or `__Nvl_registerDoneCallback`).
+- Alternative: poll `__Nvl_dumpNodes()` and compare positions between two polls.
+- `onLayoutComputing(false)` fires when a computation ends; the force-directed layout may compute again after interactions.
+
+## What a screenshot can and cannot show
+
+- The WebGL canvas is not inspectable through the DOM; pixels are the only evidence. Captions are absent with WebGL (see [labels-and-overlays](labels-and-overlays.md)), so a text-based check needs the Canvas renderer or `html` overlays.
+- `getImageDataUrl()` returns the main canvas as PNG for in-process comparisons. *types*
+
+## Headless Chrome and WebGL2
+
+Headless Chrome uses software GL by default. The force-directed GPU simulation then runs so slowly that it looks hung. Launch with hardware GL: *runtime*
+
+```
+--use-angle=gl --use-gl=angle --enable-gpu --ignore-gpu-blocklist --disable-gpu-sandbox
+```
+
+Playwright: pass them in `launchOptions.args`. Allow long timeouts for the first layout. If no GPU is available, set `disableWebGL: true` in the test build so NVL uses the Canvas renderer and CPU layouts.
+
+## Checklist
+
+- Wait for `__Nvl_dumpNodes` to exist, then for the expected node count, then for `onLayoutDone`.
+- Set `instanceId` when a page has more than one graph.
+- Set `disableTelemetry: true` in test builds.

package/skills/neo4j-nvl-skill/references/vite-and-bundlers.md

@@ -0,0 +1,62 @@
+# Vite and other bundlers
+
+When you need this: a layout never finishes in development, the console mentions a worker script, or you set up a new project.
+
+Verification tags: **source**, **types**, **runtime** (see `SKILL.md`).
+
+## What runs in a worker
+
+Only the **hierarchical** layout uses a worker: a `SharedWorker` (`type: 'module'`, name `HierarchicalLayout`) created by `@neo4j-nvl/layout-workers` with `new URL('./HierarchicalLayout.worker.js', import.meta.url)`. The worker imports the CommonJS package `bin-pack`. Force-directed, circular, grid, free and d3Force run on the main thread or the GPU. *source*
+
+If the worker constructor throws, NVL logs a warning and falls back to the synchronous implementation automatically. A worker that is created but fails to **load** does not throw, so there is no fallback and the layout never completes. *source*
+
+## Vite dev server
+
+With Vite 7.3 the hierarchical layout works in `vite` dev without configuration: Vite discovers `bin-pack` from the worker graph and pre-bundles it. *runtime*
+
+**Symptom (reported with older Vite versions and npm-installed packages, not reproduced in this repository):** switching to `hierarchical` fires `onLayoutComputing(true)` and nothing else. The page console is clean; the worker's console (DevTools → Sources → Threads, or `chrome://inspect/#workers`) shows "Failed to fetch a worker script" or a CJS resolution error. `vite build` + `vite preview` works.
+
+**Cause:** Vite pre-bundles CommonJS dependencies found from the main module graph. If the worker graph is not scanned, `bin-pack` reaches the worker un-bundled.
+
+**Fix:**
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  optimizeDeps: { include: ['bin-pack'] }
+})
+```
+
+Restart `vite` after editing `optimizeDeps`; delete `node_modules/.vite` if the change does not take.
+
+With pnpm or other strict hoisting, `bin-pack` is a transitive dependency and not resolvable from the app root. Use Vite's nested syntax (documented by Vite, not exercised in this repository):
+
+```typescript
+optimizeDeps: {
+  include: ['@neo4j-nvl/base > @neo4j-nvl/layout-workers > bin-pack']
+}
+```
+
+## Webpack
+
+Webpack 5 handles `new SharedWorker(new URL(..., import.meta.url))` natively; no configuration is needed. The repository's build-tool tests cover webpack and Vite production builds. *source*
+
+## Other bundlers
+
+Not tested in this repository. Check that the bundler supports `new URL(..., import.meta.url)` in `SharedWorker` constructors and bundles CJS dependencies into worker chunks. If it does not, use `disableWebWorkers`.
+
+## `disableWebWorkers`
+
+```javascript
+new NVL(container, nodes, rels, { disableWebWorkers: true })
+```
+
+Runs the hierarchical layout synchronously on the main thread: same result, blocks the UI for large graphs. Use it when workers are blocked (CSP `worker-src 'none'`, sandboxed iframes) or a bundler cannot be configured. For the Vite dev case prefer `optimizeDeps`. *types, source*
+
+## Telling a worker failure from a slow layout
+
+- `onLayoutComputing(true)` followed by nothing for more than a few seconds on a small graph is a failure, not slowness.
+- `window.__Nvl_registerDoneCallback(cb)` never fires (see [verifying-nvl-apps](verifying-nvl-apps.md)).
+- Switch to `disableWebWorkers: true`: if the layout now completes, the worker is the problem.

package/dist/base.mjs.LICENSE.txt

@@ -1,21 +0,0 @@
-/*!
- * 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/babel/babel/blob/main/packages/babel-helpers/LICENSE */
-
-/*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> */
-
-/**
- * @license
- * Lodash <https://lodash.com/>
- * Copyright OpenJS Foundation and other contributors <https://openjsf.org/>
- * Released under MIT license <https://lodash.com/license>
- * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
- * Copyright Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
- */

package/dist/types/layouts/animatedlayout/AnimatedLayout.test.d.ts

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

package/dist/types/layouts/animatedlayout/animationUtils.test.d.ts

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

package/dist/types/layouts/d3forcelayout/__mocks__/d3ForceLayout.d.ts

@@ -1,10 +0,0 @@
-export declare class D3ForceLayout {
-    update(): void;
-    getNodePositions(items: unknown[]): unknown[];
-    getShouldUpdate(): boolean;
-    getComputing(): boolean;
-    destroy(): void;
-    setOptions(): void;
-    updateNodes(): void;
-    terminateUpdate(): void;
-}

package/dist/types/layouts/d3forcelayout/circularLayout.test.d.ts

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

package/dist/types/layouts/d3forcelayout/d3ForceLayout.test.d.ts

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

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

@@ -1,22 +0,0 @@
-export declare const ForceDirectedLayoutType = "forceDirected";
-export declare const CoseBilkentType = "coseBilkent";
-export declare class ForceCytoLayout {
-    private readonly physLayout;
-    private readonly coseBilkentLayout;
-    private readonly state;
-    private currentLayoutType;
-    private enableCytoscape;
-    private currentLayout;
-    constructor(config: any);
-    setOptions(options: any): void;
-    private getLayout;
-    private setLayout;
-    copyLayoutPositions(nodeList: any, prevLayout: any, nextLayout: any): void;
-    update(refreshPositions?: boolean): void;
-    getShouldUpdate(): boolean;
-    getComputing(): boolean;
-    updateNodes(positionList: any): void;
-    getNodePositions(data: any): import("../..").Node[];
-    terminateUpdate(): void;
-    destroy(): void;
-}

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

@@ -1,33 +0,0 @@
-import type { NvlState } from '../../../modules/state/types';
-import type { Node, Relationship } from '../../../types/graph-element';
-import AnimatedLayout from '../../animatedlayout/AnimatedLayout';
-type LayoutData = {
-    elements: {
-        group: string;
-        data: {
-            id: string;
-        };
-    }[];
-    spacingFactor: number;
-};
-export declare class CoseBilkentLayout extends AnimatedLayout {
-    private stateDisposers;
-    cytoCompleteCallback: () => void;
-    computing: boolean;
-    pendingLayoutData: LayoutData;
-    worker: SharedWorker;
-    private workersDisabled;
-    constructor(config: {
-        state: NvlState;
-        cytoCompleteCallback?: () => void;
-        animationCompleteCallback?: () => void;
-    });
-    setOptions(): void;
-    update(refreshPositions?: boolean, updateMobXNodes?: Node[], updateMobXRelationships?: Relationship[]): void;
-    getShouldUpdate(): boolean;
-    getComputing(): boolean;
-    layout(nodes: Node[], relationships: Relationship[]): void;
-    terminateUpdate(): void;
-    destroy(): void;
-}
-export {};

package/dist/types/layouts/forcedirectedlayout/physlayout/PhysLayout.d.ts

@@ -1,174 +0,0 @@
-import type { ForceDirectedOptions, NvlState } from '../../../modules/state/types';
-import type { Node, Relationship } from '../../../types/graph-element';
-import type { Point } from '../../../utils/geometry';
-export declare class PhysLayout {
-    private physVbo;
-    private physSmallVbo;
-    private physProjection;
-    private physSmallProjection;
-    private gl;
-    private useReadpixelWorkaround;
-    private averageNodeSize;
-    private shouldUpdate;
-    private iterationCount;
-    private lastSpeedValues;
-    private rollingAvgGraphSpeed;
-    private nodeVariation;
-    private nodeCenterPoint;
-    private peakIterationMultiplier;
-    private stateDisposers;
-    private state;
-    private dpr;
-    private intelWorkaround;
-    private simulationStopVelocitySquared;
-    private gravity;
-    private force;
-    private nodeIdToIndex;
-    private nodeIndexToId;
-    private flatRelationshipKeys;
-    private numNodes;
-    private solarMerger;
-    private subGraphs;
-    private nodeSortMap;
-    private firstUpdate;
-    private curPhysData;
-    private apprxRepForceShader;
-    private levelsClusterTexture;
-    private levelsFinestIndexTexture;
-    private initalLevelTexture;
-    private levelsData;
-    private collisionDetectionMultiplier;
-    private physShader;
-    private physData;
-    private workaroundData;
-    private pinData;
-    private updateData;
-    private updateShader;
-    private workaroundShader;
-    private physPositions;
-    private springTexture;
-    private sizeTexture;
-    private offsetTexture;
-    private pinTexture;
-    private addedNodes;
-    private updateTexture;
-    private vaoExt;
-    private physVao;
-    private physSmallVao;
-    private updateVao;
-    private workaroundVao;
-    constructor(config: ForceDirectedOptions & {
-        webGLContext: WebGLRenderingContext;
-        state: NvlState;
-    });
-    /**
-     * Sets the layout options.
-     * @param options - The object with the options.
-     * @param initial - Whether this is the first setting of options.
-     */
-    setOptions(options?: ForceDirectedOptions, initial?: boolean): void;
-    /**
-     * Sets graph data to be used
-     * @param {{ nodes: Node[]; rels: Relationship[] }} data the graph object
-     * @returns The top level graph of the subgraphs created by the solar merger.
-     */
-    setData(data: {
-        nodes: Node[];
-        rels: Relationship[];
-    }): import("./solarmerger/types").CoarsenedGraph;
-    /**
-     * Updates the node's positions for the next step in the physics layout iterations if the layout needs to update
-     * @param refreshPositions whether the entire layout should be reheated
-     * @returns Whether the layout should update in the following step.
-     */
-    update(refreshPositions?: boolean): boolean;
-    /**
-     * Stops the layout
-     */
-    terminateUpdate(): void;
-    /**
-     * Returns whether the current layout needs to be updated in the next iteration step.
-     * @returns Whether the layout should update in the following step.
-     */
-    getShouldUpdate(): boolean;
-    /**
-     * Returns whether the current layout is computing.
-     * Always returns false because the force-directed layout has no computing step
-     * @returns Whether the layout is computing.
-     */
-    getComputing(): boolean;
-    /**
-     * Adds the current x,y coordinates for each node to a given list of nodes.
-     * @param nodeList - The list of nodes to get positions for.
-     * @returns The list of nodes containing the x,y coordinates on each node object.
-     */
-    getNodePositions(nodeList: Node[]): (Node & Point)[];
-    /**
-     * Reheats the layout
-     * @param fullData - The entire graph object.
-     */
-    reheat(fullData: {
-        nodes: Node[];
-        rels?: Relationship[];
-    }): void;
-    /**
-     * Updates the existing nodes of a graph with a given list of updates
-     * @param nodeList - The list of updates.
-     */
-    updateNodes(nodeList: Node[]): void;
-    /**
-     * Adds and removes nodes from the graph based on given updates
-     * @param fullData - The entire graph object.
-     * @param fullData.nodes - The nodes in the graph.
-     * @param fullData.rels - The relationships in the graph.
-     * @param nodeChanges - The changes in the graph.
-     * @param nodeChanges.adds - A list of nodes to be added.
-     * @param nodeChanges.removes - A list of nodes to be removed.
-     */
-    addRemoveData(fullData: {
-        nodes: Node[];
-        rels: Relationship[];
-    }, nodeChanges: {
-        adds: Record<string, Node>;
-        removes: Record<string, Node>;
-    }, relationshipChanges: {
-        adds: Record<string, Relationship>;
-        removes: Record<string, Relationship>;
-    }): import("./solarmerger/types").CoarsenedGraph;
-    /**
-     * Destroys the class and all buffers and textures.
-     */
-    destroy(): void;
-    /**
-     * Takes the new flat key set of relationships and the current relationship changes
-     * and checks whether removed relationships are still in the new flat key set.
-     * and whether added relationships were already in the old flat key set.
-     * @param newFlatKeySet The new flat key set of relationships.
-     * @param relationshipChanges The changes in the relationships.
-     * @returns Whether the relationship flat map has changed.
-     */
-    private hasRelationshipFlatMapChanged;
-    private dumpTexture;
-    private getScaleNumber;
-    private getBaseLength;
-    private checkForUpdates;
-    private getNodePosition;
-    private getMaxSpeedSquared;
-    private getMedianSpeedSquared;
-    private getPhysData;
-    private newTexture;
-    private newFramebuffer;
-    private checkCompatibility;
-    private printGlStats;
-    private adjustToGlSize;
-    private setupSize;
-    private setupSprings;
-    private setupPhysics;
-    private setupPhysicsForNodes;
-    private setupPhysicsForCoarse;
-    private setupPinData;
-    private setupUpdates;
-    private setupReadpixelWorkaround;
-    private doReadpixelWorkaround;
-    private definePhysicsArrays;
-}

package/dist/types/layouts/forcedirectedlayout/physlayout/PhysLayout.test.d.ts

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

package/dist/types/layouts/forcedirectedlayout/physlayout/glwrapper.d.ts

@@ -1,4 +0,0 @@
-export default class GlWrapper {
-    constructor(gl: RenderingContext);
-    private wrapFunction;
-}

package/dist/types/layouts/forcedirectedlayout/physlayout/shaders/multilevel-fragment.d.ts

@@ -1,2 +0,0 @@
-declare const _default: "precision mediump float;\n\nuniform sampler2D u_physData;\nuniform sampler2D u_connections;\nuniform sampler2D u_connectionOffsets;\nuniform sampler2D u_pinnedNodes;\nuniform sampler2D u_sizeTexture;\nuniform float u_baseLength;\nuniform float u_curIteration;\nuniform float u_iterationMultiplier;\nuniform vec2 u_gravityCenter;\nuniform float u_numNodes;\nuniform float u_gravity;\n\nuniform sampler2D u_clusterData;\nuniform sampler2D u_prevForce;\nuniform float u_collisionMultiplier;\n\n\nfloat DAMP = 0.6;\nfloat COOL = 0.99998;\nfloat TEMP = max(0.02, pow(COOL, u_curIteration));\nfloat TIMESTEP = 1.0 / 30.0;\nfloat VELOCITYDECAY = 0.6;\nfloat accLimitLow = 500000.0;\nfloat accLimitHigh = 750000.0;\nfloat accLimitPosHigh = 10000000.0;\n\nconst float denseNodeThreshold = 1000.0;\nconst float MIN_DISTANCE = 0.00000001;\nconst float MAX_DISTANCE = 1000000000.0;\nconst float MAX_ACCELERATION = 50000.0;\n\nvec4 getTextureData(sampler2D texture, float index, float base) {\n  float x = mod(index, base);\n  float y = (index - x) / base;\n  return texture2D(texture, vec2(x + 0.5, y + 0.5) / base);\n}\n\nbool isNan(float val) {\n  return (val < 0.0 || 0.0 < val || val == 0.0) ? false : true;\n}\n\nconst float BIG_NUMBER = 999999999999999999.0;\nbool isInf(float val) {\n  return val > BIG_NUMBER || val < -BIG_NUMBER;\n}\n\nvec2 getDelta(vec2 v1, vec2 v2) {\n  vec2 delta = v1 - v2;\n  float dist = length(delta);\n  if (dist < MIN_DISTANCE || isNan(dist)) {\n    return vec2(MIN_DISTANCE, MIN_DISTANCE);\n  }\n  if (dist > MAX_DISTANCE) {\n    vec2 normDelta = delta / dist;\n    return normDelta * MAX_DISTANCE;\n  }\n  return delta;\n}\n\nvec4 getOtherNodePosition(float i) {\n  return getTextureData(u_physData, i, 256.0);\n}\n\nfloat getCombinedNodeSize(float i, float nodeSize) {\n  float otherNodeSize = getTextureData(u_sizeTexture, i, 256.0).a;\n  return nodeSize + otherNodeSize;\n}\n\nvec2 getSpringForce(float curConnection, float numConnections, float springFScale, vec4 myPosition, float i) {\n  float curSpring = getTextureData(u_connections, curConnection + i, 4096.0).a;\n\n  vec4 otherPosition = getTextureData(u_physData, curSpring, 256.0);\n  float otherDataPosition = getTextureData(u_connectionOffsets, curSpring, 256.0).a;\n  float avgDegree;\n#if INTEL_WORKAROUND\n    avgDegree = max(numConnections, 4.0);\n#else\n    float otherNumConnections = getTextureData(u_connections, otherDataPosition, 4096.0).a;\n    avgDegree = max((otherNumConnections + numConnections * 3.0) / 4.0, 4.0);\n#endif\n\n  vec2 delta = getDelta(myPosition.xy, otherPosition.xy);\n  float dist = length(delta);\n\n  float F = (dist * dist * springFScale) / (u_baseLength * avgDegree);\n  if (u_collisionMultiplier > 0.0) {\n    F *= u_collisionMultiplier;\n  }\n  return (-delta / dist) * F;\n}\n\nvec2 getCollisionForce(float combinedNodeSize, float dist, float fScale, vec2 delta) {\n  float collisionForce = (combinedNodeSize - dist) / (dist);\n  if (u_collisionMultiplier > 0.0) {\n    collisionForce *= u_collisionMultiplier;\n  }\n  return (delta * collisionForce * fScale * combinedNodeSize) / (combinedNodeSize + 1.0);\n}\n\nvec2 getRepulsionForce(float dist, float fScale, vec2 delta) {\n  float F = (u_baseLength * u_baseLength * fScale) / (dist);\n  return (delta / dist) * F * 0.05;\n}\n\nvoid main(void) {\n  float textureSide = 256.0; //#TEXTURE_SIDE#;\n  float index = (gl_FragCoord.x - 0.5) + (gl_FragCoord.y - 0.5) * textureSide;\n\n  if (index >= u_numNodes) {\n    discard;\n  }\n\n  vec4 clusterData = getTextureData(u_clusterData, index, 256.0);\n\n  float clusterIndex = clusterData.x;\n  float clusterStartIndex = clusterData.y;\n  float clusterSize = clusterData.z;\n  float clusterWeight = clusterData.w;\n\n  vec4 myPosition = getTextureData(u_physData, index, 256.0);\n  vec4 previousForce = getTextureData(u_prevForce, clusterIndex, 256.0);\n\n  vec2 acceleration = previousForce.xy;\n\n  float isPinned = getTextureData(u_pinnedNodes, index, 256.0).a;\n  float nodeSize = getTextureData(u_sizeTexture, index, 256.0).a;\n\n  if (isPinned > 0.5) {\n    gl_FragColor = vec4(myPosition.xy, 0.0, 0.0);\n    return;\n  }\n\n  float curConnection = getTextureData(u_connectionOffsets, index, 256.0).a;\n  float numConnections = getTextureData(u_connections, curConnection, 4096.0).a;\n\n  float fScale = 1.0 + sqrt(u_iterationMultiplier);\n  float springFScale = fScale;\n\n  if (numConnections > denseNodeThreshold) {\n    springFScale = sqrt(fScale);\n  }\n\n  float numOfRels = 0.0;\n\n  // Springs\n  for (float i = 1.0; i <= 256.0 * 256.0; i++) {\n    if (numOfRels >= numConnections) {\n      break;\n    }\n    acceleration += getSpringForce(curConnection, numConnections, springFScale, myPosition, i);\n    numOfRels += 1.0;\n  }\n\n  // Repulsion && collision detection\n  if (u_collisionMultiplier > 0.0) {\n    float number_of_collisions = 0.0;\n    for (float i = 0.0; i < 256.0 * 256.0; i++) {\n      if (i >= u_numNodes) {\n        break;\n      }\n\n      if (i == index) {\n        continue;\n      }\n\n      vec4 otherPosition = getOtherNodePosition(i);\n      vec2 delta = getDelta(myPosition.xy, otherPosition.xy);\n      float dist = length(delta);\n      float combinedNodeSize = getCombinedNodeSize(i, nodeSize) * 2.0;\n\n      if (dist < combinedNodeSize && number_of_collisions < 40.0) {\n        number_of_collisions++;\n        acceleration += getCollisionForce(combinedNodeSize, dist, fScale, delta);\n      }\n\n      if (i >= clusterStartIndex && i < clusterStartIndex + clusterSize) {\n        acceleration += getRepulsionForce(dist, fScale, delta);\n      }\n    }\n  } else {\n    for (float i = 0.0; i < 256.0 * 256.0; i++) {\n      if (i >= clusterStartIndex + clusterSize || i >= u_numNodes) {\n        break;\n      }\n\n      if (i < clusterStartIndex || i == index) {\n        continue;\n      }\n\n      vec4 otherPosition = getOtherNodePosition(i);\n      vec2 delta = getDelta(myPosition.xy, otherPosition.xy);\n      float dist = length(delta);\n      float combinedNodeSize = getCombinedNodeSize(i, nodeSize);\n\n      if (dist < combinedNodeSize) {\n        acceleration += getCollisionForce(combinedNodeSize, dist, fScale, delta);\n      }\n\n      acceleration += getRepulsionForce(dist, fScale, delta);\n    }\n  }\n\n  // Gravity\n  vec2 delta = getDelta(u_gravityCenter, myPosition.xy);\n  float dist = length(delta);\n\n  vec2 grav = (delta / dist) * u_gravity * fScale * (dist / 1000.0);\n  acceleration += grav;\n\n  float accMagnitude = length(acceleration);\n  acceleration *= min(MAX_ACCELERATION, accMagnitude) / accMagnitude;\n\n  float iterationFrictionThreshold = 1000.0;\n\n  if (u_curIteration > iterationFrictionThreshold) {\n    float friction = 1.0 + pow((u_curIteration - iterationFrictionThreshold), 2.0) / 100.0;\n    acceleration *= 1.0 / friction;\n  }\n\n  if (u_curIteration == 0.0) {\n    gl_FragColor = vec4(myPosition.xy, myPosition.zw);\n  } else {\n    vec2 prevVelocity = myPosition.zw;\n    vec2 currentPos = myPosition.xy;\n    vec2 prevPos = currentPos - prevVelocity;\n\n    vec2 newPos = currentPos + TEMP * ( DAMP * (prevVelocity) + acceleration * TIMESTEP * TIMESTEP);\n    vec2 newVelocity = newPos - currentPos;\n    gl_FragColor = vec4(newPos, newVelocity);\n  }\n}";
-export default _default;

package/dist/types/layouts/forcedirectedlayout/physlayout/shaders/multilevel-repulsive-fragment.d.ts

@@ -1,2 +0,0 @@
-declare const _default: "precision mediump float;\nuniform sampler2D u_physData;\nuniform sampler2D u_clusterData;\nuniform sampler2D u_finestIndexes;\nuniform sampler2D u_prevForce;\n\nuniform float u_baseLength;\nuniform float u_numNodes;\nuniform float u_iterationMultiplier;\nuniform float u_isTopLevel;\n\nfloat PI = 3.1415926535897932384626433832795;\nfloat TIMESTEP = 1.0 / 30.0;\nfloat VELOCITYDECAY = 1.0;\n\nvec4 getTextureData(sampler2D texture, float index, float base) {\n  float x = mod(index, base);\n  float y = (index - x) / base;\n  return texture2D(texture, vec2(x + 0.5, y + 0.5) / base);\n}\n\nfloat getSquaredLogClusterWeight(float value) {\n  return pow(log(value), 2.0);\n}\n\nvoid main(void) {\n  float index = (gl_FragCoord.x - 0.5) + (gl_FragCoord.y - 0.5) * 256.0;\n\n  if (index >= u_numNodes) {\n    discard;\n  }\n\n  vec4 clusterData = getTextureData(u_clusterData, index, 256.0);\n\n  float clusterIndex = clusterData.x;\n  float clusterStartIndex = clusterData.y;\n  float clusterSize = clusterData.z;\n  float clusterArea = pow(clusterSize + u_baseLength * 2.0, 2.0);\n\n  float finestIndex = getTextureData(u_finestIndexes, index, 256.0).a;\n  vec4 myPosition = getTextureData(u_physData, finestIndex, 256.0);\n  vec4 previousForce = getTextureData(u_prevForce, clusterIndex, 256.0);\n  float fScale = 1.0 + sqrt(u_iterationMultiplier);\n\n  vec2 acceleration = previousForce.xy;\n\n  // Repulsion & Collision Detection\n  for (float i = 0.0; i < 256.0 * 256.0; i++) {\n    if (i >= clusterStartIndex + clusterSize || i >= u_numNodes) {\n      break;\n    }\n    if (i < clusterStartIndex || i == index) {\n      continue;\n    }\n\n    vec4 otherClusterData = getTextureData(u_clusterData, i, 256.0);\n    float otherClusterWeight = getSquaredLogClusterWeight(otherClusterData.w);\n\n    float otherFinestIndex = getTextureData(u_finestIndexes, i, 256.0).a;\n    vec4 otherPosition = getTextureData(u_physData, otherFinestIndex, 256.0);\n\n    vec2 delta = myPosition.xy - otherPosition.xy;\n    float dist = max(length(delta), 0.0000001);\n    float maxDist = 25.0;\n    float repulsionForceScale = 0.1;\n\n    float F = (clusterArea * fScale) / (dist * dist);\n\n    if (u_isTopLevel == 1.0) {\n      repulsionForceScale = 0.2;\n    }\n\n    acceleration += ((delta / sqrt(dist)) * F) * repulsionForceScale * otherClusterWeight;\n\n    if (dist < maxDist) {\n      float collide = (maxDist - dist) / (dist * dist);\n      acceleration += delta * collide * fScale * maxDist / (maxDist + 1.0);\n    }\n  }\n\n  gl_FragColor = vec4(acceleration, vec2(finestIndex, 0));\n}";
-export default _default;

package/dist/types/layouts/forcedirectedlayout/physlayout/shaders/multilevel-update-fragment.d.ts

@@ -1,2 +0,0 @@
-declare const _default: "precision mediump float;\n\nuniform sampler2D u_physData;\nuniform sampler2D u_updateData;\nuniform float u_numNodesNew;\n\nconst float INDEX_FLAG = 999999.0;\n\nvec4 getTextureData(sampler2D texture, float index, float base) {\n  float x = mod(index, base);\n  float y = (index - x) / base;\n  return texture2D(texture, vec2(x + 0.5, y + 0.5) / base);\n}\n\nvoid main(void) {\n  float textureSide = 256.0; //#TEXTURE_SIDE#;\n  float index = (gl_FragCoord.x - 0.5) + (gl_FragCoord.y - 0.5)*textureSide;\n\n  if (index >= u_numNodesNew) {\n    discard;\n  }\n\n  float firstValue = getTextureData(u_updateData, index * 2.0, 256.0).a;\n  float secondValue = getTextureData(u_updateData, index * 2.0 + 1.0, 256.0).a;\n\n  if (secondValue == INDEX_FLAG) {\n    vec4 myPosition = getTextureData(u_physData, firstValue, 256.0);\n    gl_FragColor = myPosition;\n  } else {\n    gl_FragColor = vec4(firstValue, secondValue, 0.0, 0.0);\n  }\n}\n";
-export default _default;

package/dist/types/layouts/forcedirectedlayout/physlayout/shaders/sim-vertex.d.ts

@@ -1,2 +0,0 @@
-declare const _default: "uniform mat4 u_projection;\n\nattribute vec2 a_position;\n//attribute float a_index;\n\n//varying highp float index;\n\nvoid main() {\n//  index = a_index;\n  gl_Position = u_projection * vec4(a_position, 0.0, 1.0);\n}";
-export default _default;

package/dist/types/layouts/forcedirectedlayout/physlayout/shaders/workaround-fragment.d.ts

@@ -1,2 +0,0 @@
-declare const _default: "precision lowp float;\n\nuniform sampler2D u_physData;\nuniform float u_index;\n\nfloat shift_right (float v, float amt) { \n    v = floor(v) + 0.5; \n    return floor(v / exp2(amt)); \n}\n\nfloat shift_left (float v, float amt) { \n    return floor(v * exp2(amt) + 0.5); \n}\n\nfloat mask_last (float v, float bits) { \n    return mod(v, shift_left(1.0, bits)); \n}\n\nfloat extract_bits (float num, float from, float to) { \n    from = floor(from + 0.5); to = floor(to + 0.5); \n    return mask_last(shift_right(num, from), to - from); \n}\n\n// From https://stackoverflow.com/questions/17981163/webgl-read-pixels-from-floating-point-render-target\nvec4 encode_float (float val) { \n    if (val == 0.0) return vec4(0, 0, 0, 0); \n    float sign = val > 0.0 ? 0.0 : 1.0; \n    val = abs(val); \n    float exponent = floor(log2(val)); \n    float biased_exponent = exponent + 127.0; \n    float fraction = ((val / exp2(exponent)) - 1.0) * 8388608.0; \n    float t = biased_exponent / 2.0; \n    float last_bit_of_biased_exponent = fract(t) * 2.0; \n    float remaining_bits_of_biased_exponent = floor(t); \n    float byte4 = extract_bits(fraction, 0.0, 8.0) / 255.0; \n    float byte3 = extract_bits(fraction, 8.0, 16.0) / 255.0; \n    float byte2 = (last_bit_of_biased_exponent * 128.0 + extract_bits(fraction, 16.0, 23.0)) / 255.0; \n    float byte1 = (sign * 128.0 + remaining_bits_of_biased_exponent) / 255.0; \n    return vec4(byte4, byte3, byte2, byte1); \n}\n\nvoid main(void) {\n  vec4 texData = texture2D(u_physData, gl_FragCoord.xy / 255.0);\n  float data;\n  if (u_index == 0.0) {\n    data = texData.x;\n  } else if (u_index == 1.0) {\n    data = texData.y;\n  } else if (u_index == 2.0) {\n    data = texData.z;\n  } else if (u_index == 3.0) {\n    data = texData.w;\n  }\n\n  gl_FragColor = encode_float(data);\n}\n";
-export default _default;

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

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

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

@@ -1,21 +0,0 @@
-import type { Node, Relationship } from '../../../../types/graph-element';
-import type { CoarsenedGraph, SolarRelationship } from './types';
-export default class SolarMerger {
-    graph: {
-        nodes: Node[];
-        relationships: number[][];
-        idToRel: Record<string, SolarRelationship>;
-    };
-    subGraphs: CoarsenedGraph[];
-    sunMap: Record<string, string>;
-    relIdMap: string[][];
-    nodeSortMap?: Record<number, number>;
-    constructor(inputGraph: {
-        nodes: Node[];
-        rels: Relationship[];
-    }, nodeIdToIndex: Record<string, number>);
-    private constructGraphObjects;
-    coarsenTo(targetSize: number): CoarsenedGraph;
-    coarsenBy(levelToCoarsenBy: number): CoarsenedGraph;
-    private coarsen;
-}

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

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

package/dist/types/layouts/forcedirectedlayout/physlayout/solarmerger/solar-placer.d.ts

@@ -1,2 +0,0 @@
-import type { Point } from '../../../../utils/geometry';
-export declare const calculatePositions: (centre: Point, r: number, noOfChildren: number) => any[];

package/dist/types/layouts/forcedirectedlayout/physlayout/solarmerger/solar-placer.test.d.ts

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

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

@@ -1,49 +0,0 @@
-import type { Node } from '../../../../types/graph-element';
-export interface SolarNode extends Omit<Node, 'id' | 'size'> {
-    id: number;
-    weight?: number;
-    finestIndex?: number;
-    originalId: string;
-    position?: {
-        x: number;
-        y: number;
-    };
-    placement?: {
-        x: number;
-        y: number;
-    };
-    size?: number | (() => number);
-}
-export interface SolarRelationship {
-    id: string;
-    from: string;
-    to: string;
-}
-export interface CoarsenedGraph {
-    nodes: SolarNode[];
-    relationships: number[][];
-    idToRel: Record<string, SolarRelationship>;
-}
-export interface Sun extends SolarNode {
-    planets: Planet[];
-    size: () => number;
-    children: () => Planet[];
-    previousIndex: number;
-}
-export interface Planet extends SolarNode {
-    parent: Sun;
-    sunId: number;
-    moons: Moon[];
-    size: () => number;
-    children: () => Moon[];
-}
-export interface Moon extends SolarNode {
-    parent: Planet;
-    sunId: number;
-    size: () => number;
-}
-export type Celestial = Sun | Planet | Moon;
-export declare const isSolarNode: (node: SolarNode | Node) => node is SolarNode;
-export declare const isSun: (node: SolarNode | Celestial) => node is Sun;
-export declare const isPlanet: (node: SolarNode | Celestial) => node is Planet;
-export declare const isMoon: (node: SolarNode | Celestial) => node is Moon;

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

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

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

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

package/dist/types/modules/dataset.test.d.ts

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

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

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

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

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

package/dist/types/renderers/domrenderer/BaseRenderer.test.d.ts

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

package/dist/types/renderers/domrenderer/canvasrenderer/Animation.test.d.ts

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

package/dist/types/renderers/domrenderer/canvasrenderer/CanvasRenderer.test.d.ts

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