[Android] Fix discrete gestures not triggering onFinalize

[m-bert]

Description

Discrete gestures on Android transition to END state before being cancelled by other, higher priority gestures. Our current approach missed case where gestures like Tap end in such transition (5 -> 3), therefore onFinalize callback was never triggered.

Test plan

Tested on the following code:

import React from 'react';
import { StyleSheet, View } from 'react-native';
import {
  GestureDetector,
  useExclusiveGestures,
  useTapGesture,
} from 'react-native-gesture-handler';

export default function EmptyExample() {
  const t1 = useTapGesture({
    onBegin: () => {
      console.log('tap begin');
    },
    onActivate: () => {
      console.log('tap activate');
    },
    onDeactivate: () => {
      console.log('tap deactivate');
    },
    onFinalize: () => {
      console.log('tap finalize');
    },
  });

  const t2 = useTapGesture({
    numberOfTaps: 2,
    onBegin: () => {
      console.log('double tap begin');
    },
    onActivate: () => {
      console.log('double tap activate');
    },
    onDeactivate: () => {
      console.log('double tap deactivate');
    },
    onFinalize: () => {
      console.log('double tap finalize');
    },
  });

  const g = useExclusiveGestures(t2, t1);

  return (
    <View style={styles.container}>
      <GestureDetector gesture={g}>
        <View style={styles.box} />
      </GestureDetector>
    </View>
  );
}

const styles = StyleSheet.create({
  box: {
    width: 100,
    height: 100,
    backgroundColor: 'blue',
    borderRadius: 10,
  },
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
  },
});

[Copilot]

Pull request overview

Fixes an Android edge case where discrete gestures (e.g., Tap) can transition to STATE_END while still “awaiting” another handler, then later get cancelled/failed without ever dispatching the synthetic state change that drives JS onFinalize.

Changes:

• Extend the “awaiting handler finished before activation” synthetic dispatch logic to also cover STATE_END -> STATE_CANCELLED/FAILED transitions.
• Add clarifying comments explaining the discrete-gesture scenario that prompted the change.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.