react-native-gesture-handler

Important changes

• [iOS] add SPM build support

• [Android] Add pressOutAfterAnimation prop to Touchable

• [iOS] Implement pressOutAfterAnimation on Touchable

• Rename pressOutAfterAnimation to immediatePressOut

• [Android] Dispatch onPressIn when the native press starts

Improvements

• [Android] Align the alpha traversal gate with iOS

• Scan mount relations directly instead of rebuilding tag arrays

• [Web] Align Tap maxDelay default with native (200 ms)

• [Web] Make ScrollView an intercepting detectors

Bug fixes

• [Android] Cancel detector gestures when a native view above them takes over the touch

• [Android] Fix NPE when a touch cancel callback finishes the handler mid-transition

• Make the detector frame cover transformed children

• [Android] Allow GestureStateManager.activate from the first onTouchesDown

• [iOS] Allow GestureStateManager.activate from the first onTouchesDown

• [Web] Allow GestureStateManager.activate from the first onTouchesDown

• [Web] Introduce key pointer in KeyboardEventManager

• [iOS] Fix manualActivation being ignored after a config update mid-gesture

• [iOS] Skip hidden and transparent buttons in hit testing

• [Web] Keep detector-owned DOM props across a full config replace

• Follow the sign of a SharedValue pan offset on every update

• [Web] Detect composed gesture changes in the detector

• [Android] Prevent Touchable presses when stopping ScrollView flings

• [Android] Don't change state of handlers that haven't received any touches

• [Web] Fix view relative coordinates of trackpad pan events

• [Web] Map event coordinates through the view's full transform

• [General] Link late-mounted gesture objects and skip mount reactions without external relations

• [Android] Fix crash when a Text inside a detector gets an inline View

• [Android] Reset the native DOWN flag for unmanaged buttons

• android: respect pointer events on gesture root views

• Expose animatable ref from legacy GestureDetector Wrap

• [Android] Clear the pending HOVER_EXIT finish when the hover handler is reset

• [Android] Stop nested scroll when the root starts intercepting

• Re-send SharedValue config values from the UI thread after binding

• [Android] Cancel gestures on native ACTION_CANCEL

• [iOS] Keep NativeViewGestureHandler flags across a partial config update

• [Android] Check the overflow ancestor pass against the detector child's bounds

Miscellaneous

• Bump to React Native 0.88

• Expose the module id through a sync TurboModule method instead of a JSI global

• Bump proxy-addr from 2.0.7 to 2.0.8 in /packages/docs-gesture-handler

• Bump joi from 17.13.7 to 17.13.8 in /packages/docs-gesture-handler

• Bump fast-uri from 3.1.7 to 3.1.8 in /packages/docs-gesture-handler

• [GitHub] Remove Architecture from the issue template

• [E2E] Update flows to await console to hide

• [Android] Register all component descriptors in react-native.config.js

• [General] Hide non-serializable gesture fields from enumeration

• [Web] Register the wheel listener as passive and only for Pan

• Allow opt-out from pressOutAfterAnimation in Pressable

• Report a VirtualGestureDetector child that swallows the ref

• Keep the pointerEvents ts-expect-error in emitted spec declarations

• Stop react-native-pager-view from entering the web bundle of the example app

Bug fixes

• Keep ReanimatedSwipeable native handlers stable when event callbacks change

• Forward press handlers as testOnly_* in PressableWithTouchable

• Pass reanimatedEventHandler only when the Reanimated detector is used

• [Android] Fix buttons firing press events when a scroll takes over the touch

• [Android] Fix native handlers attaching to a nested button instead of the detector's child

• Fix ReanimatedDrawerLayout animation speed after rerender

• Fix dead presses in "never" mode when the keyboard belongs to a native field

• Don't pass dependencies to Reanimated hooks on native

• [Web] Activate ScrollView's native gesture on real scroll instead of pointer distance

• [iOS] Detach handlers when the detector view is recycled

• Forward borderless and foreground from android_ripple

• [Android] Don't let an awaiting parent handler cancel the child it is waiting for

• [Web] Reset NativeViewGestureHandler config on a full config replace

• [Web] Restore enabled on a full config replace

• [Web] Refresh the DOM after a full config replace

• Default shouldCancelWhenOutside to true in useTapGesture

• Reset numberOfPointers in LongPressGestureHandler

• Reset enableTrackpadTwoFingerGesture in web PanGestureHandler

• [iOS] Keep button hit testing within its own subtree

• [iOS] Cancel an in-progress press when the button gets disabled

• [Android] Release the press when the button gets disabled

• [Web] Drop a handler from the orchestrator when it gets disabled mid-gesture

• [Web] Drop handlers that never began from the orchestrator

• stop circular GestureStateManagerType import on web

• [iOS] Preserve disabled button targets under box-none parents

• Reset accumulated wheel delta in web WheelEventManager

• [Android] Stop nested scroll when a native handler's gesture ends

Miscellaneous

• [Android] Remove old Reanimated check

• [Android] Initialize the Handler fields eagerly

• Use stable Reanimated and Worklets

• Fix Errors.test.tsx failing with Reanimated 4.6.0

• [Web] Fix delayTimeout type FlingGestureHandler

• Escape the JSON-LD against early script termination

• Remove stale TODOs

• removed

  Remove REACT_NATIVE_MINOR_VERSION build flag

• Add issue triage comments workflow

• Remove stale todo

• Flatten same-type nested compositions in useComposedGesture

• removed

  [iOS] Remove a stale TODO in State.ts and the unused constants export

• Remove the @ts-ignore TODO from the event pipeline in jestUtils

• Resolve DrawerLayoutAndroid lazily to avoid RN deprecation warning on import

• Update Pressable props

• Fix v3 CI path filter case and remove stale files entry

• [Example] Keep "Basic" in example names, add test ids

• Bump joi from 17.13.4 to 17.13.7 in /packages/docs-gesture-handler

• Bump svgo from 3.3.4 to 3.3.5 in /packages/docs-gesture-handler

• Bump colord from 2.9.3 to 2.10.0 in /packages/docs-gesture-handler

• Bump nanoid from 3.3.16 to 3.3.18 in /packages/docs-gesture-handler

• Bump fast-uri from 3.1.5 to 3.1.7 in /packages/docs-gesture-handler

Important changes

• Adopt AGP v9

• Implement Pressable based on Touchable

• [Android] Add hover callbacks to Touchable

• [iOS] Add hover callbacks to Touchable

• [Web] Add hover callbacks to Touchable

• [Web] Refactor Touchable not to rely on GestureDetector

• [iOS] Refactor Touchable not to rely on GestureDetector

• [Android] Refactor Touchable not to rely on GestureDetector

• Fix fatal crash Cannot read property 'translationX' of undefined when a touch event is serialized without allTouches

Improvements

• [Android] Skip the underlay drawable when it can never be visible

• [Android] Apply the button's managed handler config once per prop transaction

• [Android] Configure the button's handler directly instead of through a ReadableMap

Bug fixes

• [Android] Guard update events to only be dispatched in ACTIVE state

• Pass empty callbacks to UI when runOnJS is true

• [Web] Fix incorrectly calculated timeDelta

• [Web] Fix incorrect Tap offset

• Fix minVelocity props behavior

• [Android] Fix minDistance being reset by partial config updates

• Move Interceptor on ScrollView, not its content

• [iOS] Re-sync layer opacity and transform from retained props when recycling buttons

• [Android] Properly handle requestDisallowInterceptTouchEvent for v3

• Fix Touchable not respecting keyboardShouldPersistTaps="handled"

• [macOS] Fix touch events never being delivered

• crash when mount listener fires after GestureDetector unmount

• [macOS] Fix Pan activation criteria being ignored

• [macOS] Fix manualActivation never blocking gesture activation

• [iOS] Fix touch events never being delivered to VirtualDetector handlers

• [iOS] Fix gestures attached via VirtualGestureDetector never recognizing continuous gestures

• [macOS] Fix Fling not sending touch events and begin/end states consistently

• [Android] Fix handlers cancelled while awaiting leaking in the orchestrator

• [iOS] Fix gesture callback guarantees when view is detached mid-gesture

• [General] Default GestureDetector moduleId to -1

• Clear pending timers on unmount in StatefulPressable

Miscellaneous

• Update types to respect Strict TS API

• Export PressableEvent type

• Update AGENTS.md

• Don't dispatch orphaned touch events

• Get uiRuntime directly from react-native-worklets

• [iOS] Check if enableTrackpadTwoFingerGesture is nil before applying

• [General] Pass null hitSlop instead of coercing it to zero

• Add Imperative Gesture Handler Testing API

• [Android] Fix basic-example hermesc path

• Extract CALLBACK_TYPE to shared module

• Don't evaluate __DEV__ or Reanimated at module scope

• Replace React Native type imports in EventTypes/eventUtils with structural equivalents

• De-couple the web handlers from React Native

• Use globalThis instead of bare global in utils

• Extract the RN-free half of ScrollView interop from ScrollViewResponderInterceptor

• Extract HoverEffect to a standalone module

• Lift ButtonEvent out of the codegen spec into shared types

• Stub the Windows module's Gestures map

• [General] Align pointerType across native and JS

• [Apple] Remove trailing semicolons from RNGHGestureRecognizerState* macros

• [General] Fix stale deprecation messages pointing to Clickable

• [macOS] Downgrade react-native-worklets

• Move hitSlop normalization to JS

• Derive Pressable pressed state from testOnly_pressed

• [Android] Resolve the button event dispatcher by react tag

• Bump fast-uri from 3.1.2 to 3.1.4 in /packages/docs-gesture-handler

• Bump webpack-dev-server from 5.2.5 to 5.2.6 in /packages/docs-gesture-handler

• Bump body-parser from 1.20.4 to 1.20.6 in /packages/docs-gesture-handler

• Bump shell-quote from 1.8.4 to 1.10.0 in /packages/docs-gesture-handler

• Bump svgo from 3.3.3 to 3.3.4 in /packages/docs-gesture-handler

• Bump to React Native 0.87

• Bump json from 2.11.1 to 2.19.9 in /apps/macos-example

• Bump json from 2.12.2 to 2.19.9 in /apps/basic-example

• Bump websocket-driver from 0.7.4 to 0.7.5 in /packages/docs-gesture-handler

Bug fixes

• [Android] Align the alpha traversal gate with iOS

• Fix gesture relations after freeze

• [iOS] Skip hidden and transparent buttons in hit testing

• [iOS] Fix manualActivation being ignored after a config update mid-gesture

• [Web] Introduce key pointer in KeyboardEventManager

• Scan mount relations directly instead of rebuilding tag arrays

• [General] Link late-mounted gesture objects and skip mount reactions without external relations

• [Web] Fix view relative coordinates of trackpad pan events

• [Android] Fix NPE when a touch cancel callback finishes the handler mid-transition

• android: respect pointer events on gesture root views

• Expose animatable ref from legacy GestureDetector Wrap

• [Android] Clear the pending HOVER_EXIT finish when the hover handler is reset

• [Android] Stop nested scroll when the root starts intercepting

• Skip UIManager constants lookup on react-native-windows

Miscellaneous

• [Web] Register the wheel listener as passive and only for Pan

cherry-pick thread: #4597

React Native support

React Native 0.87 is the last React Native version supported by the 2.x line. Support for newer React Native releases continues in Gesture Handler 3.

Important changes

• Support React Native 0.87 on 2.x

• Adopt AGP v9

• Fix fatal crash Cannot read property 'translationX' of undefined when a touch event is serialized without allTouches

Bug fixes

• [Android | Web] Disable pointer events on hidden Swipeable actions container

• [Android] Fix mouse interactions

• crash when mount listener fires after GestureDetector unmount

• Remove opacity from Swipeable action panels

• [Android] Fix text getting selected during gestures

• [Android] Fix ConcurrentModificationException in GestureHandlerOrchestrator

• [iOS] Move Tap cancelation to dispatch_after

• remove UIPointerInteraction from the view when unbinding the hover handler

• [iOS] Fix js responder cancelation in modals

• [iOS] Fix gesture callback guarantees when view is detached mid-gesture

• Fix minVelocity props behavior

• [Web] Fix incorrectly calculated timeDelta

• [Web] Fix incorrect Tap offset

• [Android] Guard update events to only be dispatched in ACTIVE state

• [macOS] Fix Pan activation criteria being ignored

• [macOS] Fix manualActivation never blocking gesture activation

• [macOS] Fix touch events never being delivered

• [macOS] Fix Fling not sending touch events and begin/end states consistently

• [Android] Fix handlers cancelled while awaiting leaking in the orchestrator

• Clear pending timers on unmount in StatefulPressable

• Forward borderless and foreground from android_ripple

• Keep ReanimatedSwipeable native handlers stable when event callbacks change

• Fix ReanimatedDrawerLayout animation speed after rerender

• Don't pass dependencies to Reanimated hooks on native

• [Android] Don't let an awaiting parent handler cancel the child it is waiting for

• Reset numberOfPointers in LongPressGestureHandler

• Reset enableTrackpadTwoFingerGesture in web PanGestureHandler

• Reset accumulated wheel delta in web WheelEventManager

• [Web] Reset NativeViewGestureHandler config on a full config replace

• [Android] Stop nested scroll when a native handler's gesture ends

• [iOS] Keep button hit testing within its own subtree

• [Web] Drop handlers that never began from the orchestrator

• [iOS] Preserve disabled button targets under box-none parents

• stop circular GestureStateManagerType import on web

Miscellaneous

• [Android] Do not set explicit versions in build.gradle

• [Android] Don't delay child pressed state in buttons

• Fix Easing import in LongPress example

• [macOS] Add coordinates to Hover events

• Export PressableEvent type

• Don't dispatch orphaned touch events

• [iOS] Check if enableTrackpadTwoFingerGesture is nil before applying

• [Android] Fix basic-example hermesc path

• [Apple] Remove trailing semicolons from RNGHGestureRecognizerState* macros

• Derive Pressable pressed state from testOnly_pressed

• Update Pressable props

• [General] Align pointerType across native and JS

• Resolve DrawerLayoutAndroid lazily to avoid RN deprecation warning on import

cherry-pick thread: #4498