@neo4j-nvl/base 1.2.2 → 2.0.0-2b04269b

package/skills/neo4j-nvl-skill/references/troubleshooting.md

@@ -0,0 +1,317 @@
+# NVL — Troubleshooting & Gotchas
+
+## Container renders nothing / 0×0
+
+**Cause:** Parent `<div>` has no explicit height. NVL inherits `0` → graph invisible.
+
+```html
+<!-- ❌ -->
+<div id="viz"></div>
+
+<!-- ✅ -->
+<div id="viz" style="width: 100%; height: 600px;"></div>
+```
+
+React: wrap `<InteractiveNvlWrapper>` or `<BasicNvlWrapper>` in a sized parent OR pass `style={{ width, height }}` directly (the wrappers forward `HTMLProps<HTMLDivElement>`).
+
+---
+
+## Driver `EagerResult` rejected by NVL
+
+**Cause:** Default `executeQuery` returns `{ records, summary, keys }` — records are not `Node`/`Relationship` shapes.
+
+```javascript
+// ❌
+const res = await driver.executeQuery('MATCH (a)-[r]-(b) RETURN a,r,b LIMIT 25')
+new NVL(container, res.records, [])    // ids missing, shape wrong
+
+// ✅
+import { nvlResultTransformer } from '@neo4j-nvl/base'
+const { nodes, relationships } = await driver.executeQuery(
+  'MATCH (a)-[r]-(b) RETURN a,r,b LIMIT 25', {},
+  { database: 'neo4j', resultTransformer: nvlResultTransformer }
+)
+new NVL(container, nodes, relationships)
+```
+
+For driver setup → `neo4j-driver-javascript-skill`.
+
+---
+
+## Web Worker construction blocked
+
+**Cause:** NVL's `@neo4j-nvl/layout-workers` spawns Web Workers for the force-directed and hierarchical layouts. Some environments block worker construction — strict CSP (`worker-src 'none'`), sandboxed iframes, custom runtimes, or older build tools that don't bundle workers correctly.
+
+**Fix:** Disable workers — NVL has a synchronous fallback (slower for large graphs, identical output). Applies to any build tool (Vite, Webpack, Rollup, esbuild, Parcel, etc.):
+
+```javascript
+const nvl = new NVL(container, nodes, rels, { disableWebWorkers: true })
+```
+
+React:
+
+```tsx
+<InteractiveNvlWrapper nvlOptions={{ disableWebWorkers: true }} ... />
+```
+
+Most modern bundlers handle worker construction natively — try the default setup first, fall back to `disableWebWorkers: true` only when worker errors actually appear.
+
+---
+
+## Renderer trade-off (Canvas vs WebGL)
+
+| Renderer | Practical ceiling | Captions | Hit-test |
+|---|---|---|---|
+| Canvas (default) | ~1,000 nodes | Full styling | Pixel-perfect |
+| WebGL | 100,000+ nodes | Not supported | Approximate |
+
+NVL 2.0's GPU renderer and physics engine require **WebGL2**. WebGL1 is not supported. WebGL rendering now supports node icons and relationship arrowheads, but not captions.
+
+```javascript
+// At construction
+new NVL(container, nodes, rels, { renderer: 'webgl' })
+
+// At runtime
+nvl.setRenderer('webgl')   // or 'canvas'
+```
+
+Pick based on node count and whether captions are required. Switching at runtime triggers a re-render. Set `disableWebGL: true` to explicitly use non-WebGL rendering and layout implementations.
+
+---
+
+## WebGL captions/labels are missing
+
+**Cause:** Expected NVL 2.0 behavior. The WebGL renderer does not support captions.
+
+**Fix:** Use Canvas when captions are required:
+
+```javascript
+nvl.setRenderer('canvas')
+```
+
+---
+
+## React `layout` or `layoutOptions` has no effect
+
+**Cause:** NVL 2.0 removed the deprecated standalone React wrapper props.
+
+```tsx
+// ❌ removed in 2.0
+<InteractiveNvlWrapper layout="hierarchical" layoutOptions={{ direction: 'down' }} />
+
+// ✅ put both options in nvlOptions
+<InteractiveNvlWrapper
+  nvlOptions={{ layout: 'hierarchical', layoutOptions: { direction: 'down' } }}
+/>
+```
+
+---
+
+## `onZoom` callback no longer fires
+
+**Cause:** NVL 2.0 removed `onZoom`.
+
+**Fix:** Use `onZoomAndPan`, which includes the complete viewport state:
+
+```javascript
+zoom.updateCallback('onZoomAndPan', (zoomLevel, panX, panY, event) => {
+  console.log({ zoomLevel, panX, panY })
+})
+```
+
+For React, set `mouseEventCallbacks={{ onZoomAndPan: callback }}`.
+
+---
+
+## Force-directed clusters do not appear
+
+**Cause:** Force-directed clustering options must be nested under `layoutOptions.clustering`; hierarchical `clusterBy` is placed directly under `layoutOptions`.
+
+```javascript
+// Force-directed
+const options = {
+  layout: 'forceDirected',
+  layoutOptions: {
+    clustering: {
+      clusterBy: (nodeId) => categoryByNodeId[nodeId],
+      drawOutline: true,
+      drawHalo: true
+    }
+  }
+}
+
+// Hierarchical
+const hierarchicalOptions = {
+  layout: 'hierarchical',
+  layoutOptions: {
+    direction: 'down',
+    clusterBy: (nodeId) => categoryByNodeId[nodeId]
+  }
+}
+```
+
+The callback must return the same string or number for nodes in one cluster. Return `undefined` for independent nodes. In React, keep the callback stable with `useCallback`; otherwise changing its identity can cause repeated cluster evaluation.
+
+---
+
+## Cluster click callback misses clicks
+
+**Cause:** `onClusterClick`, `onClusterDoubleClick`, and `onClusterRightClick` apply to empty space inside a force-directed cluster hull. A node or relationship under the pointer takes priority.
+
+**Fix:** Use node/relationship callbacks for direct element hits and cluster callbacks for hull space. For hover, inspect `hitElements.clusters` from `onHover`:
+
+```javascript
+hover.updateCallback('onHover', (_element, hitElements) => {
+  const cluster = hitElements.clusters[0]?.data
+  if (cluster) console.log(cluster.id, cluster.nodeIds)
+})
+```
+
+---
+
+## `onWebGLContextLost` fires
+
+**Cause:** GPU dropped the context (tab backgrounded too long, driver crash, OS swap).
+
+**Fix:** Implement `onWebGLContextLost` callback — call `nvl.setRenderer('canvas')` as recovery, or `nvl.restart(options, true)` to reinitialize while keeping positions:
+
+```javascript
+const nvl = new NVL(container, nodes, rels,
+  { renderer: 'webgl' },
+  { onWebGLContextLost: () => nvl.restart({ renderer: 'canvas' }, true) }
+)
+```
+
+---
+
+## Telemetry — opting out
+
+**Cause:** NVL ships Segment Analytics; runs by default.
+
+**Fix:**
+
+```javascript
+new NVL(container, nodes, rels, { disableTelemetry: true })
+```
+
+Mandatory in regulated / air-gapped / customer-data-sensitive deployments.
+
+---
+
+## Memory leak after route change (React)
+
+**Cause:** Custom `useRef` + manual `new NVL(...)` not torn down on unmount.
+
+**Fix:** Always call `nvl.destroy()` in cleanup:
+
+```tsx
+useEffect(() => {
+  const nvl = new NVL(ref.current!, nodes, rels)
+  return () => nvl.destroy()
+}, [])
+```
+
+`<InteractiveNvlWrapper>` / `<BasicNvlWrapper>` handle this automatically — prefer them over manual refs.
+
+For vanilla, destroy all interaction handlers BEFORE the NVL instance:
+
+```javascript
+for (const h of handlers) h.destroy()
+nvl.destroy()
+```
+
+---
+
+## Layout never settles / `isLayoutMoving` stays true
+
+**Cause:** Graph has competing forces or is unsolvable; or workers disabled and synchronous fallback is throttled.
+
+**Fix options:**
+- Pin anchor nodes: `nvl.pinNode(id)` for known fixed positions
+- Cap iterations: `nvlOptions: { layoutTimeLimit: 3000 }` (ms)
+- Switch layout: `nvl.setLayout('hierarchical')` for DAG-like data
+- Reduce nodes (paginate query, increase `LIMIT`)
+
+---
+
+## Selection callback fires twice
+
+**Cause:** `selectOnClick` toggled mid-render OR both base handler + wrapper handling clicks.
+
+**Fix:** Set `interactionOptions={{ selectOnClick: true }}` once at mount and leave it; don't flip the value across renders. If using vanilla `ClickInteraction`, do not also register a manual `container.addEventListener('click', ...)`.
+
+---
+
+## Hit test misses near node edge
+
+**Cause:** Default `hitNodeMarginWidth: 0` requires pointer strictly inside the node circle.
+
+**Fix:** Widen the hit margin:
+
+```javascript
+const { nvlTargets } = nvl.getHits(evt, ['node', 'relationship'], { hitNodeMarginWidth: 8 })
+```
+
+For pan-on-relationship sensitivity, set `excludeNodeMargin: true` in `PanInteraction` options.
+
+To include cluster hulls when supplying an explicit target list, add `'cluster'`. Cluster hits are included by default when the target list is omitted:
+
+```javascript
+const { nvlTargets } = nvl.getHits(evt, ['node', 'relationship', 'cluster'])
+```
+
+---
+
+## Layout / hierarchy looks wrong
+
+**Cause:** Default `'forceDirected'` not suited for tree / pipeline / circular data.
+
+**Fix:** Pick the right layout up front:
+
+| Data shape | Layout |
+|---|---|
+| Generic network | `'forceDirected'` |
+| Tree / DAG | `'hierarchical'` (set `direction` in `layoutOptions`) |
+| Sorted ring | `'circular'` (provide `sortFunction`) |
+| Manual positioning | `'free'` |
+| Snapped grid | `'grid'` |
+| Force-directed via d3-force | `'d3Force'` |
+
+---
+
+## License pitfall
+
+**Cause:** NVL is licensed under the Neo4j Visualization Library License — for use with Neo4j products only.
+
+**Implication:** Cannot ship NVL inside an application that uses a non-Neo4j graph backend (Neptune, JanusGraph, ArangoDB, etc.) as its primary data store. Refer to the LICENSE.txt in `@neo4j-nvl/base` and confirm with legal before redistribution.
+
+---
+
+## Image export returns blank PNG
+
+**Cause:** Called `saveToFile()` before `onLayoutDone` fires — initial positions still settling.
+
+**Fix:** Trigger export from the callback:
+
+```javascript
+const nvl = new NVL(container, nodes, rels, {},
+  { onLayoutDone: () => nvl.saveToFile({ filename: 'graph.png' }) })
+```
+
+Or `getImageDataUrl()` for in-memory data URL.
+
+---
+
+## `restart()` vs `addAndUpdateElementsInGraph()`
+
+**`restart()`** rebuilds internal state; expensive; resets selection unless `retainPositions=true` is passed AND positions are preserved. Use for option changes (renderer, layout, styling).
+
+**`addAndUpdateElementsInGraph()`** is the correct API for streaming data changes. Use for live updates.
+
+```javascript
+// ❌ data update via restart — full rebuild every tick
+nvl.restart()
+
+// ✅ diff update
+nvl.addAndUpdateElementsInGraph(newNodes, newRels)
+```

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/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/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.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/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[];