feat: support interactableDescendants to shortcut traversing the scene graph when interacting with instanced UIs for example

Author: bbohlender

packages/pointer-events/src/intersections/utils.ts

@@ -80,10 +80,15 @@ export function intersectPointerEventTargets(
     }
   }
 
-  const childrenLength = object.children.length
-  for (let i = 0; i < childrenLength; i++) {
+  if (object.intersectChildren === false) {
+    return
+  }
+
+  const descendants = object.interactableDescendants ?? object.children
+  const descendantsLength = descendants.length
+  for (let i = 0; i < descendantsLength; i++) {
     intersectPointerEventTargets(
-      object.children[i],
+      descendants[i],
       pointers,
       hasListener,
       pointerEvents,

packages/pointer-events/src/pointer.ts

@@ -89,6 +89,9 @@ declare module 'three' {
     setPointerCapture(pointerId: number): void
     releasePointerCapture(pointerId: number): void
     hasPointerCapture(pointerId: number): boolean
+
+    intersectChildren?: boolean
+    interactableDescendants?: Array<Object3D>
   }
 }