feat(scenegraph): add global/local point mapping methods

packages/scenegraph/src/index.ts

@@ -152,13 +152,34 @@ export class Node2D implements ISceneNode<Node2D>, IToHiccup {
                     return n;
                 }
             }
-            const q = mulV23([], this.invMat, p);
+            const q = this.mapGlobalPoint(p);
             if (this.containsLocalPoint(q)) {
                 return { node: this, p: q };
             }
         }
     }
 
+    /**
+     * Returns copy of world space point `p`, transformed into this
+     * node's local coordinate system.
+     *
+     * @param p
+     */
+    mapGlobalPoint(p: ReadonlyVec) {
+        return mulV23([], this.invMat, p);
+    }
+
+    /**
+     * Returns copy of node local space point `p`, transformed into the
+     * coordinate system of `dest` node.
+     *
+     * @param dest
+     * @param p
+     */
+    mapLocalPointToNode(dest: Node2D, p: ReadonlyVec) {
+        return mulV23(null, dest.invMat, mulV23([], this.mat, p));
+    }
+
     /**
      * Returns true, if given point is contained within the boundary of
      * this node. Since this class is used as generic base