Introduce bypassActivationConstraints option (#1271)

.changeset/bypass-activation-constraints.md

@@ -0,0 +1,17 @@
+---
+'@dnd-kit/core': minor
+---
+
+Introduce `bypassActivationConstraint()` option for `PointerSensor`, `MouseSensor` and `TouchSensor`. This optional argument can be used to conditionally bypass activation constraints. An example use-case would be to bypass activation constraints when the activator event target is the `activatorNode` of a draggable source.
+
+```tsx
+useSensor(PointerSensor, {
+  activationConstraint: {
+    delay: 250,
+    tolerance: 5,
+  },
+  bypassActivationConstraint({event, activeNode}) {
+    return activeNode.activatorNode.current?.contains(event.target);
+  },
+});
+```

packages/core/src/sensors/pointer/AbstractPointerSensor.ts

@@ -55,6 +55,9 @@ function isDelayConstraint(
 
 export interface AbstractPointerSensorOptions extends SensorOptions {
   activationConstraint?: PointerActivationConstraint;
+  bypassActivationConstraint?(
+    props: Pick<AbstractPointerSensorProps, 'activeNode' | 'event' | 'options'>
+  ): boolean;
   onActivation?({event}: {event: Event}): void;
 }
 
@@ -100,7 +103,7 @@ export class AbstractPointerSensor implements SensorInstance {
     const {
       events,
       props: {
-        options: {activationConstraint},
+        options: {activationConstraint, bypassActivationConstraint},
       },
     } = this;
 
@@ -113,6 +116,16 @@ export class AbstractPointerSensor implements SensorInstance {
     this.documentListeners.add(EventName.Keydown, this.handleKeydown);
 
     if (activationConstraint) {
+      if (
+        bypassActivationConstraint?.({
+          event: this.props.event,
+          activeNode: this.props.activeNode,
+          options: this.props.options,
+        })
+      ) {
+        return this.handleStart();
+      }
+
       if (isDelayConstraint(activationConstraint)) {
         this.timeoutId = setTimeout(
           this.handleStart,