Add screen2GraphCoords to 3D

Author: vasturiano

README.md

@@ -242,7 +242,7 @@ Note that not all props listed below apply to all 4 components. The last 4 colum
 | Method | Arguments | Description | 2D | 3D | VR | AR |
 | --- | :--: | --- | :--: | :--: | :--: | :--: |
 | <b>getGraphBbox</b> | ([<i>nodeFilterFn</i>]) | Returns the current bounding box of the nodes in the graph, formatted as `{ x: [<num>, <num>], y: [<num>, <num>], z: [<num>, <num>] }`. If no nodes are found, returns `null`. Accepts an optional argument to define a custom node filter: `node => <boolean>`, which should return a truthy value if the node is to be included. This can be useful to calculate the bounding box of a portion of the graph. | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
-| <b>screen2GraphCoords</b> | (<i>x</i>, <i>y</i>) | Utility method to translate viewport coordinates to the graph domain. Given a pair of `x`,`y` screen coordinates, returns the current equivalent `{x, y}` in the domain of graph node coordinates. | :heavy_check_mark: | | | |
+| <b>screen2GraphCoords</b> | (<i>x</i>, <i>y</i>[, <i>distance</i>]) | Utility method to translate viewport coordinates to the graph domain. Given a pair of `x`,`y` screen coordinates, and optionally distance from camera for 3D mode, returns the current equivalent `{x, y (, z)}` in the domain of graph node coordinates. | :heavy_check_mark: | :heavy_check_mark: | | |
 | <b>graph2ScreenCoords</b> | (<i>x</i>, <i>y</i>[, <i>z</i>]) | Utility method to translate node coordinates to the viewport domain. Given a set of `x`,`y`(,`z`) graph coordinates, returns the current equivalent `{x, y}` in viewport coordinates. | :heavy_check_mark: | :heavy_check_mark: | | |
 
 ### Input JSON syntax

package.json

@@ -40,7 +40,7 @@
     "dist/**/*"
   ],
   "dependencies": {
-    "3d-force-graph": "^1.68.1",
+    "3d-force-graph": "^1.69.1",
     "3d-force-graph-ar": "^1.6.3",
     "3d-force-graph-vr": "^1.35.3",
     "force-graph": "^1.39.2",

src/packages/react-force-graph-3d/index.d.ts

@@ -149,6 +149,7 @@ export interface ForceGraphMethods {
 
   // Utility
   getGraphBbox(nodeFilter?: (node: NodeObject) => boolean): { x: [number, number], y: [number, number], z: [number, number] };
+  screen2GraphCoords(x: number, y: number, distance: number): Coords;
   graph2ScreenCoords(x: number, y: number, z: number): Coords;
 }
 

src/packages/react-force-graph-3d/index.js

@@ -15,6 +15,7 @@ const ForceGraph3D = fromKapsule(
       'cameraPosition',
       'zoomToFit',
       'getGraphBbox',
+      'screen2GraphCoordinates',
       'graph2ScreenCoords',
       'postProcessingComposer',
       'scene',

src/packages/react-force-graph-3d/package.json

@@ -36,7 +36,7 @@
     "dist/**/*"
   ],
   "dependencies": {
-    "3d-force-graph": "^1.68.1",
+    "3d-force-graph": "^1.69.1",
     "prop-types": "^15.7.2",
     "react-kapsule": "^2.2.1"
   },