@cocorof/graphier 1.4.1 → 1.4.2

package/README.md

@@ -39,12 +39,14 @@ const ref = useRef<NetworkGraph3DRef>(null);
 <GraphMinimap graphRef={ref} width={200} height={140} />
 ```
 
-- `layout.dimensions: 2` — simulation runs in 2D (z locked to 0); camera locks to pan/zoom (drag pans, wheel/pinch zooms, rotation off).
+- `layout.dimensions: 2` — flat Obsidian-style plane: simulation runs in 2D (z locked to 0). Left-drag pans, right-drag tilts/orbits the world, wheel/pinch zooms, arrows/WASD pan and z/x zoom (v1.4.1).
+- `enableNodeDrag={false}` — left-drag always reaches the camera even over nodes; essential for dense graphs (v1.4.1).
 - `layout.clusterBy: "type" | "group"` + `clusterStrength` — pulls same-key nodes toward a shared centroid so categories form visible clusters.
 - `linkVisibility={(link) => bool}` — reheat-free per-edge filter (e.g. hide a link type).
 - `visibleNodeIds` — client-side filter; hidden nodes/edges/labels vanish via per-instance scale + collapsed segments. Positions are preserved: toggling filters never reheats the simulation.
 - `hoverHighlight` / `hoverHighlightHops` — Obsidian-style neighborhood emphasis on hover (selection wins while active).
 - `theme="paper"` — light background preset; edge blending switches to normal automatically (additive lines vanish on white) and highlight/dim directions invert.
+- `renderer.navigation` — remap pointer/keyboard navigation per consumer, e.g. `{ leftButton: "pan", rightButton: "rotate", keyboard: "pan" }` for pan-first 3D graphs (v1.4.2).
 - `GraphMinimap` — 2D-canvas overview (no second WebGL context): draws all visible nodes + the camera viewport rectangle, click/drag to pan. Powered by `ref.getGraphSnapshot()` / `ref.getViewportRect()` / `ref.panTo(x, y)`.
 
 ## Install

package/dist/index.cjs

@@ -2284,34 +2284,38 @@ function createScene(container, backgroundColor, style, rendererConfig) {
     flags
   };
 }
-function applyCameraMode2D(state, is2D) {
+const MOUSE_ACTION = {
+  rotate: THREE__namespace.MOUSE.ROTATE,
+  pan: THREE__namespace.MOUSE.PAN
+};
+function applyNavigationMode(state, is2D, nav) {
   const { controls, camera, keyboard } = state;
   state.flags.is2D = is2D;
-  controls.enableRotate = true;
+  const left = (nav == null ? void 0 : nav.leftButton) ?? (is2D ? "pan" : "rotate");
+  const right = (nav == null ? void 0 : nav.rightButton) ?? (is2D ? "rotate" : "pan");
+  controls.mouseButtons = {
+    LEFT: MOUSE_ACTION[left],
+    MIDDLE: THREE__namespace.MOUSE.DOLLY,
+    RIGHT: MOUSE_ACTION[right]
+  };
+  controls.enableRotate = left === "rotate" || right === "rotate";
+  controls.touches = left === "pan" ? { ONE: THREE__namespace.TOUCH.PAN, TWO: THREE__namespace.TOUCH.DOLLY_PAN } : { ONE: THREE__namespace.TOUCH.ROTATE, TWO: THREE__namespace.TOUCH.DOLLY_PAN };
   controls.enableZoom = is2D;
   controls.screenSpacePanning = is2D;
-  keyboard.setEnabled(true);
-  keyboard.setMode(is2D ? "pan" : state.flags.keyboardMode3D);
+  const kb = (nav == null ? void 0 : nav.keyboard) ?? (is2D ? "pan" : state.flags.keyboardMode3D);
+  if (kb === "off") {
+    keyboard.setEnabled(false);
+  } else {
+    keyboard.setEnabled(true);
+    keyboard.setMode(kb);
+  }
   if (is2D) {
-    controls.mouseButtons = {
-      LEFT: THREE__namespace.MOUSE.PAN,
-      MIDDLE: THREE__namespace.MOUSE.DOLLY,
-      RIGHT: THREE__namespace.MOUSE.ROTATE
-    };
-    controls.touches = { ONE: THREE__namespace.TOUCH.PAN, TWO: THREE__namespace.TOUCH.DOLLY_PAN };
     const t = controls.target;
     const dist = Math.max(camera.position.distanceTo(t), 50);
     t.z = 0;
     camera.up.set(0, 1, 0);
     camera.position.set(t.x, t.y, dist);
     camera.lookAt(t);
-  } else {
-    controls.mouseButtons = {
-      LEFT: THREE__namespace.MOUSE.ROTATE,
-      MIDDLE: THREE__namespace.MOUSE.DOLLY,
-      RIGHT: THREE__namespace.MOUSE.PAN
-    };
-    controls.touches = { ONE: THREE__namespace.TOUCH.ROTATE, TWO: THREE__namespace.TOUCH.DOLLY_PAN };
   }
   controls.update();
 }
@@ -3518,10 +3522,11 @@ function NetworkGraph3DInner(props, ref) {
       );
     }
   }, [visibleSet, linkVisibility, mergedData]);
+  const navKey = JSON.stringify((rendererProp == null ? void 0 : rendererProp.navigation) ?? null);
   react.useEffect(() => {
     const s = sceneRef.current;
-    if (s) applyCameraMode2D(s, is2D);
-  }, [is2D]);
+    if (s) applyNavigationMode(s, is2D, rendererProp == null ? void 0 : rendererProp.navigation);
+  }, [is2D, navKey]);
   react.useEffect(() => {
     const gObj = graphObjRef.current;
     const sceneState = sceneRef.current;
@@ -3773,11 +3778,12 @@ function NetworkGraph3DInner(props, ref) {
       const s = sceneRef.current;
       if (!s) return null;
       const cam = s.camera;
-      const dist = Math.abs(cam.position.z);
+      const t = s.controls.target;
+      const dist = Math.max(cam.position.distanceTo(t), 1);
       const halfH = Math.tan(cam.fov * Math.PI / 360) * dist;
       return {
-        cx: cam.position.x,
-        cy: cam.position.y,
+        cx: t.x,
+        cy: t.y,
         halfW: halfH * cam.aspect,
         halfH
       };