feat: support setting object.defaultPointerEvents for setting the defaultPointerEvents to "auto" for user interfaces to replicate html pointer events behavior

Author: bbohlender

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

@@ -59,7 +59,7 @@ export function intersectPointerEventTargets(
   parentPointerEventsOrder?: number,
 ): void {
   const hasListener = parentHasListener || hasObjectListeners(object)
-  const pointerEvents = object.pointerEvents ?? parentPointerEvents ?? 'listener'
+  const pointerEvents = object.pointerEvents ?? parentPointerEvents ?? object.defaultPointerEvents ?? 'listener'
   const pointerEventsType = object.pointerEventsType ?? parentPointerEventsType ?? 'all'
   const pointerEventsOrder = object.pointerEventsOrder ?? parentPointerEventsOrder ?? 0
 

packages/pointer-events/src/pointer.ts

@@ -27,9 +27,13 @@ declare module 'three' {
   interface Object3D {
     _listeners?: Record<string, Array<(event: unknown) => void> | undefined>
     /**
-     * @default "listener"
+     * @default parent.pointerEvents ?? this.defaultPointerEvents
      */
     pointerEvents?: AllowedPointerEvents
+    /**
+     * @default "listener"
+     */
+    defaultPointerEvents?: AllowedPointerEvents
     /**
      * @default "all"
      */