[iOS] Distinguish between mouse and stylus when hovering (#3991)

## Description

<!--
Description and motivation for this PR.

Include 'Fixes #<number>' if this is fixing some issue.
-->

Improves the hover gesture on iOS by distinguishing between a mouse and
a stylus, if possible.

With these changes the handler will now assume a mouse (just like
previously with the enum bug), but if `zOffset` is available (iOS 16.1)
and it is over 0.0 it will instead be recognised as styus.

~*Maybe it makes more sense to invert the logic and assume a mouse as
default, and stylus if > 0. Let me know what you think.*~

See #3977 for more context.

Fixes #3977 

## Test plan

<!--
Describe how did you test this change here.
-->
Here's a small test page that can be added to the basic-example app for
testing;
```jsx
import { useState } from 'react';
import { View, Text } from 'react-native';
import {
  GestureDetector,
  GestureHandlerRootView,
  useHoverGesture,
  useSimultaneousGestures,
  useTapGesture,
} from 'react-native-gesture-handler';
import { runOnJS } from 'react-native-worklets';

const POINTER_TYPES: Record<number, string> = {
  0: "TOUCH",
  1: "STYLUS",
  2: "MOUSE",
  3: "KEY",
  4: "OTHER",
}

export default function Hover() {
  const [hoverPointerType, setHoverPointerType] = useState(-1);
  const [tapPointerType, setTapPointerType] = useState(-1);
  const hoverGesture = useHoverGesture({
    onUpdate: (event) => {
      runOnJS(setHoverPointerType)(event.pointerType);
    },
  });
  const tapGesture = useTapGesture({
    onFinalize: (event) => {
      runOnJS(setTapPointerType)(event.pointerType);
    },
  });
  const gesture = useSimultaneousGestures(hoverGesture, tapGesture);
  return (
    <GestureHandlerRootView
      style={{
        flex: 1,
        backgroundColor: 'white',
        justifyContent: 'center',
        alignItems: 'center',
      }}>
      <Text>Hover pointer type: {POINTER_TYPES[hoverPointerType] ?? "N/A"}</Text>
      <Text>Tap pointer type: {POINTER_TYPES[tapPointerType] ?? "N/A"}</Text>
      <GestureDetector gesture={gesture}>
        <View
          style={{ width: 200, height: 200, backgroundColor: 'salmon' }}></View>
      </GestureDetector>
    </GestureHandlerRootView>
  );
}
```

Mouse is testable in the iPad simulator by enabling `I/O -> Input ->
Send Pointer to Device` in the top menus.
Mouse is also testable on a real iPad by Linking keyboard and mouse to
it from a mac in the Displays settings.
Apple Pencil is only testable with an actual pencil on a real iPad.

---------

Co-authored-by: Michał <michal.bert@swmansion.com>

Author: AndreasHogstrom

packages/react-native-gesture-handler/apple/Handlers/RNFlingHandler.m

@@ -26,7 +26,7 @@ - (id)initWithGestureHandler:(RNGestureHandler *)gestureHandler
 
 - (void)touchesBegan:(NSSet<RNGHUITouch *> *)touches withEvent:(UIEvent *)event
 {
-  [_gestureHandler setCurrentPointerType:event];
+  [_gestureHandler setCurrentPointerTypeForEvent:event];
   _lastPoint = [[[touches allObjects] objectAtIndex:0] locationInView:_gestureHandler.recognizer.view];
   [_gestureHandler reset];
   [super touchesBegan:touches withEvent:event];

packages/react-native-gesture-handler/apple/Handlers/RNForceTouchHandler.m

@@ -40,7 +40,7 @@ - (id)initWithGestureHandler:(RNGestureHandler *)gestureHandler
 
 - (void)touchesBegan:(NSSet<RNGHUITouch *> *)touches withEvent:(UIEvent *)event
 {
-  [_gestureHandler setCurrentPointerType:event];
+  [_gestureHandler setCurrentPointerTypeForEvent:event];
   if (_firstTouch) {
     // ignore rest of fingers
     return;

packages/react-native-gesture-handler/apple/Handlers/RNHoverHandler.m

@@ -40,13 +40,22 @@ @implementation RNBetterHoverGestureRecognizer {
 
 - (id)initWithGestureHandler:(RNGestureHandler *)gestureHandler
 {
-  if ((self = [super initWithTarget:gestureHandler action:@selector(handleGesture:)])) {
+  if ((self = [super initWithTarget:self action:@selector(handleGesture:)])) {
     _gestureHandler = gestureHandler;
     _hoverEffect = RNGestureHandlerHoverEffectNone;
   }
   return self;
 }
 
+- (void)handleGesture:(UIHoverGestureRecognizer *)recognizer
+{
+  if (recognizer.state == UIGestureRecognizerStateBegan) {
+    [_gestureHandler setCurrentPointerType:RNGestureHandlerMouse];
+  }
+
+  [_gestureHandler handleGesture:self];
+}
+
 - (void)triggerAction
 {
   [_gestureHandler handleGesture:self fromReset:NO];
@@ -153,11 +162,22 @@ - (void)updateConfig:(NSDictionary *)config
 #endif
 }
 
+- (void)setCurrentPointerType:(RNGestureHandlerPointerType)pointerType
+{
+  _pointerType = pointerType;
+
+  if (@available(iOS 16.1, *)) {
+    if (((UIHoverGestureRecognizer *)self.recognizer).zOffset > 0.0) {
+      _pointerType = RNGestureHandlerStylus;
+    }
+  }
+}
+
 - (RNGestureHandlerEventExtraData *)eventExtraData:(UIGestureRecognizer *)recognizer
 {
   return [RNGestureHandlerEventExtraData forPosition:[recognizer locationInView:recognizer.view]
                                 withAbsolutePosition:[recognizer locationInView:recognizer.view.window]
-                                     withPointerType:RNGestureHandlerStylus];
+                                     withPointerType:_pointerType];
 }
 
 @end
@@ -173,6 +193,7 @@ - (instancetype)initWithTag:(NSNumber *)tag
 {
   if ((self = [super initWithTag:tag])) {
     _recognizer = [NSGestureRecognizer alloc];
+    _pointerType = RNGestureHandlerMouse;
   }
 
   return self;

packages/react-native-gesture-handler/apple/Handlers/RNLongPressHandler.m

@@ -87,7 +87,7 @@ - (CGPoint)translationInView
 
 - (void)touchesBegan:(NSSet<RNGHUITouch *> *)touches withEvent:(UIEvent *)event
 {
-  [_gestureHandler setCurrentPointerType:event];
+  [_gestureHandler setCurrentPointerTypeForEvent:event];
   [super touchesBegan:touches withEvent:event];
 
   if (self.state == UIGestureRecognizerStatePossible && ![self.delegate gestureRecognizerShouldBegin:self]) {

packages/react-native-gesture-handler/apple/Handlers/RNManualHandler.m

@@ -64,7 +64,7 @@ - (void)interactionsEnded:(NSSet *)touches withEvent:(UIEvent *)event
 #if !TARGET_OS_OSX
 - (void)touchesBegan:(NSSet<RNGHUITouch *> *)touches withEvent:(UIEvent *)event
 {
-  [_gestureHandler setCurrentPointerType:event];
+  [_gestureHandler setCurrentPointerTypeForEvent:event];
   [super touchesBegan:touches withEvent:event];
 
   [self interactionsBegan:touches withEvent:event];

packages/react-native-gesture-handler/apple/Handlers/RNNativeViewHandler.mm

@@ -33,7 +33,7 @@ - (id)initWithGestureHandler:(RNGestureHandler *)gestureHandler
 #if !TARGET_OS_OSX
 - (void)touchesBegan:(NSSet<RNGHUITouch *> *)touches withEvent:(UIEvent *)event
 {
-  [_gestureHandler setCurrentPointerType:event];
+  [_gestureHandler setCurrentPointerTypeForEvent:event];
   [_gestureHandler.pointerTracker touchesBegan:touches withEvent:event];
 }
 
@@ -170,7 +170,7 @@ - (void)unbindFromView
 
 - (void)handleTouchDown:(UIView *)sender forEvent:(UIEvent *)event
 {
-  [self setCurrentPointerType:event];
+  [self setCurrentPointerTypeForEvent:event];
   [self reset];
 
   if (_disallowInterruption) {

packages/react-native-gesture-handler/apple/Handlers/RNPanHandler.m

@@ -238,7 +238,7 @@ - (void)mouseUp:(NSEvent *)event
 
 - (void)touchesBegan:(NSSet<RNGHUITouch *> *)touches withEvent:(UIEvent *)event
 {
-  [_gestureHandler setCurrentPointerType:event];
+  [_gestureHandler setCurrentPointerTypeForEvent:event];
   // super call was moved to interactionsBegan method to keep the
   // original order of calls
   [self interactionsBegan:touches withEvent:event];

packages/react-native-gesture-handler/apple/Handlers/RNPinchHandler.m

@@ -109,7 +109,7 @@ - (void)magnifyWithEvent:(NSEvent *)event
 #else
 - (void)touchesBegan:(NSSet<RNGHUITouch *> *)touches withEvent:(UIEvent *)event
 {
-  [_gestureHandler setCurrentPointerType:event];
+  [_gestureHandler setCurrentPointerTypeForEvent:event];
   [super touchesBegan:touches withEvent:event];
   [self interactionsBegan:touches withEvent:event];
 }

packages/react-native-gesture-handler/apple/Handlers/RNRotationHandler.m

@@ -102,7 +102,7 @@ - (void)rotateWithEvent:(NSEvent *)event
 #else
 - (void)touchesBegan:(NSSet<RNGHUITouch *> *)touches withEvent:(UIEvent *)event
 {
-  [_gestureHandler setCurrentPointerType:event];
+  [_gestureHandler setCurrentPointerTypeForEvent:event];
   [super touchesBegan:touches withEvent:event];
   [self interactionsBegan:touches withEvent:event];
 }

packages/react-native-gesture-handler/apple/Handlers/RNTapHandler.m

@@ -191,7 +191,7 @@ - (void)rightMouseUp:(NSEvent *)event
 
 - (void)touchesBegan:(NSSet<RNGHUITouch *> *)touches withEvent:(UIEvent *)event
 {
-  [_gestureHandler setCurrentPointerType:event];
+  [_gestureHandler setCurrentPointerTypeForEvent:event];
   [super touchesBegan:touches withEvent:event];
   [self interactionsBegan:touches withEvent:event];
 }