Merge branch 'pmndrs:main' into fix/xrlayer-uikit-world-matrix

Author: myers

docs/handles/handle-component.md

@@ -62,6 +62,9 @@ In situations where the handle target is placed inside a constantly changing gro
 **multitouch**  
 By default, handles can be interacted with using multiple input devices. By setting `multitouch` to `false`, only the first input device will be used.
 
+**filter**  
+Allows to filter interactions based on the event. Return `false` to ignore the event.
+
 **stopPropagation**  
 By default, events that occur on handles are not propagated upwards and therefore do not reach their ancestors. Setting `stopPropagation` to `false` will re-enable event propagation for events that occur on the handle.
 

packages/handle/src/store.ts

@@ -55,7 +55,10 @@ export type HandleOptions<T> = {
      */
     uniform?: boolean
   }
-  //TODO: filter
+  /**
+   * Filter interaction. Return false to ignore the event.
+   */
+  filter?: (event: PointerEvent) => boolean
   /**
    * @default true
    */
@@ -160,6 +163,9 @@ export class HandleStore<T>
   }
 
   private onPointerDown(event: PointerEvent): void {
+    if (this.getOptions().filter?.(event) === false) {
+      return
+    }
     this.stopPropagation(event)
     if (!this.capturePointer(event.pointerId, event.object)) {
       return