@amazon-devices/react-native-gesture-handler 4.0.0 → 4.0.2

package/src/handlers/gestures/GestureDetector/useViewRefHandler.ts

@@ -1,58 +0,0 @@
-import { isFabric, tagMessage } from '../../../utils';
-import { getShadowNodeFromRef } from '../../../getShadowNodeFromRef';
-
-import { GestureDetectorState } from './types';
-import React, { useCallback } from 'react';
-import { Platform } from 'react-native';
-import findNodeHandle from '../../../findNodeHandle';
-
-declare const global: {
-  isViewFlatteningDisabled: (node: unknown) => boolean | null; // JSI function
-};
-
-// Ref handler for the Wrap component attached under the GestureDetector.
-// It's responsible for setting the viewRef on the state and triggering the reattaching of handlers
-// if the view has changed.
-export function useViewRefHandler(
-  state: GestureDetectorState,
-  updateAttachedGestures: (skipConfigUpdate?: boolean) => void
-) {
-  const refHandler = useCallback(
-    (ref: React.Component | null) => {
-      if (ref === null) {
-        return;
-      }
-
-      state.viewRef = ref;
-
-      // if it's the first render, also set the previousViewTag to prevent reattaching gestures when not needed
-      if (state.previousViewTag === -1) {
-        state.previousViewTag = findNodeHandle(state.viewRef) as number;
-      }
-
-      // Pass true as `skipConfigUpdate`. Here we only want to trigger the eventual reattaching of handlers
-      // in case the view has changed. If the view doesn't change, the update will be handled by detector.
-      if (!state.firstRender) {
-        updateAttachedGestures(true);
-      }
-
-      if (__DEV__ && isFabric() && global.isViewFlatteningDisabled) {
-        const node = getShadowNodeFromRef(ref);
-        // amznmod_react - isViewFlatteningDisabled is not available on kepler.
-        // View flattening is not applicable on kepler, skip the check.
-        // @ts-ignore 'kepler' is a valid Platform.OS value on Kepler devices
-        if (Platform.OS !== 'kepler' && global.isViewFlatteningDisabled(node) === false) {
-          console.error(
-            tagMessage(
-              'GestureDetector has received a child that may get view-flattened. ' +
-                '\nTo prevent it from misbehaving you need to wrap the child with a `<View collapsable={false}>`.'
-            )
-          );
-        }
-      }
-    },
-    [state, updateAttachedGestures]
-  );
-
-  return refHandler;
-}

package/src/handlers/gestures/GestureDetector/utils.ts

@@ -1,181 +0,0 @@
-import { Platform } from 'react-native';
-
-import { isTestEnv, tagMessage } from '../../../utils';
-import { GestureRef, BaseGesture, GestureType } from '../gesture';
-
-import { flingGestureHandlerProps } from '../../FlingGestureHandler';
-import { forceTouchGestureHandlerProps } from '../../ForceTouchGestureHandler';
-import { longPressGestureHandlerProps } from '../../LongPressGestureHandler';
-import {
-  panGestureHandlerProps,
-  panGestureHandlerCustomNativeProps,
-} from '../../PanGestureHandler';
-import { tapGestureHandlerProps } from '../../TapGestureHandler';
-import { hoverGestureHandlerProps } from '../hoverGesture';
-import { nativeViewGestureHandlerProps } from '../../NativeViewGestureHandler';
-import {
-  HandlerStateChangeEvent,
-  baseGestureHandlerWithDetectorProps,
-} from '../../gestureHandlerCommon';
-import { isNewWebImplementationEnabled } from '../../../EnableNewWebImplementation';
-import { RNRenderer } from '../../../RNRenderer';
-import { useCallback, useRef, useState } from 'react';
-import { Reanimated } from '../reanimatedWrapper';
-import { onGestureHandlerEvent } from '../eventReceiver';
-import { WebEventHandler } from './types';
-
-export const ALLOWED_PROPS = [
-  ...baseGestureHandlerWithDetectorProps,
-  ...tapGestureHandlerProps,
-  ...panGestureHandlerProps,
-  ...panGestureHandlerCustomNativeProps,
-  ...longPressGestureHandlerProps,
-  ...forceTouchGestureHandlerProps,
-  ...flingGestureHandlerProps,
-  ...hoverGestureHandlerProps,
-  ...nativeViewGestureHandlerProps,
-];
-
-function convertToHandlerTag(ref: GestureRef): number {
-  if (typeof ref === 'number') {
-    return ref;
-  } else if (ref instanceof BaseGesture) {
-    return ref.handlerTag;
-  } else {
-    // @ts-ignore in this case it should be a ref either to gesture object or
-    // a gesture handler component, in both cases handlerTag property exists
-    return ref.current?.handlerTag ?? -1;
-  }
-}
-
-function extractValidHandlerTags(interactionGroup: GestureRef[] | undefined) {
-  return (
-    interactionGroup?.map(convertToHandlerTag)?.filter((tag) => tag > 0) ?? []
-  );
-}
-
-export function extractGestureRelations(gesture: GestureType) {
-  const requireToFail = extractValidHandlerTags(gesture.config.requireToFail);
-  const simultaneousWith = extractValidHandlerTags(
-    gesture.config.simultaneousWith
-  );
-  const blocksHandlers = extractValidHandlerTags(gesture.config.blocksHandlers);
-
-  return {
-    waitFor: requireToFail,
-    simultaneousHandlers: simultaneousWith,
-    blocksHandlers: blocksHandlers,
-  };
-}
-
-export function checkGestureCallbacksForWorklets(gesture: GestureType) {
-  if (!__DEV__) {
-    return;
-  }
-  // If a gesture is explicitly marked to run on the JS thread there is no need to check
-  // if callbacks are worklets as the user is aware they will be ran on the JS thread
-  if (gesture.config.runOnJS) {
-    return;
-  }
-
-  const areSomeNotWorklets = gesture.handlers.isWorklet.includes(false);
-  const areSomeWorklets = gesture.handlers.isWorklet.includes(true);
-
-  // If some of the callbacks are worklets and some are not, and the gesture is not
-  // explicitly marked with `.runOnJS(true)` show an error
-  if (areSomeNotWorklets && areSomeWorklets) {
-    console.error(
-      tagMessage(
-        `Some of the callbacks in the gesture are worklets and some are not. Either make sure that all calbacks are marked as 'worklet' if you wish to run them on the UI thread or use '.runOnJS(true)' modifier on the gesture explicitly to run all callbacks on the JS thread.`
-      )
-    );
-  }
-
-  if (Reanimated === undefined) {
-    // If Reanimated is not available, we can't run worklets, so we shouldn't show the warning
-    return;
-  }
-
-  const areAllNotWorklets = !areSomeWorklets && areSomeNotWorklets;
-  // If none of the callbacks are worklets and the gesture is not explicitly marked with
-  // `.runOnJS(true)` show a warning
-  if (areAllNotWorklets && !isTestEnv()) {
-    console.warn(
-      tagMessage(
-        `None of the callbacks in the gesture are worklets. If you wish to run them on the JS thread use '.runOnJS(true)' modifier on the gesture to make this explicit. Otherwise, mark the callbacks as 'worklet' to run them on the UI thread.`
-      )
-    );
-  }
-}
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function validateDetectorChildren(ref: any) {
-  // Finds the first native view under the Wrap component and traverses the fiber tree upwards
-  // to check whether there is more than one native view as a pseudo-direct child of GestureDetector
-  // i.e. this is not ok:
-  //            Wrap
-  //             |
-  //            / \
-  //           /   \
-  //          /     \
-  //         /       \
-  //   NativeView  NativeView
-  //
-  // but this is fine:
-  //            Wrap
-  //             |
-  //         NativeView
-  //             |
-  //            / \
-  //           /   \
-  //          /     \
-  //         /       \
-  //   NativeView  NativeView
-  if (__DEV__ && Platform.OS !== 'web') {
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-    const wrapType =
-      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-      ref._reactInternals.elementType;
-
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-    let instance =
-      RNRenderer.findHostInstance_DEPRECATED(
-        ref
-      )._internalFiberInstanceHandleDEV;
-
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-    while (instance && instance.elementType !== wrapType) {
-      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-      if (instance.sibling) {
-        throw new Error(
-          'GestureDetector has more than one native view as its children. This can happen if you are using a custom component that renders multiple views, like React.Fragment. You should wrap content of GestureDetector with a <View> or <Animated.View>.'
-        );
-      }
-
-      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
-      instance = instance.return;
-    }
-  }
-}
-
-export function useForceRender() {
-  const [renderState, setRenderState] = useState(false);
-  const forceRender = useCallback(() => {
-    setRenderState(!renderState);
-  }, [renderState, setRenderState]);
-
-  return forceRender;
-}
-
-export function useWebEventHandlers() {
-  return useRef<WebEventHandler>({
-    onGestureHandlerEvent: (e: HandlerStateChangeEvent<unknown>) => {
-      onGestureHandlerEvent(e.nativeEvent);
-    },
-    onGestureHandlerStateChange: isNewWebImplementationEnabled()
-      ? (e: HandlerStateChangeEvent<unknown>) => {
-          onGestureHandlerEvent(e.nativeEvent);
-        }
-      : undefined,
-  });
-}

package/src/handlers/gestures/eventReceiver.ts

@@ -1,173 +0,0 @@
-import { DeviceEventEmitter, NativeEventEmitter, EmitterSubscription, Platform } from 'react-native';
-import RNGestureHandlerModule from "../../RNGestureHandlerModule";
-import type KeplerGestureHandlerModule from "../../RNGestureHandlerModule.kepler"
-import { State } from '../../State';
-import { TouchEventType } from '../../TouchEventType';
-import {
-  GestureTouchEvent,
-  GestureUpdateEvent,
-  GestureStateChangeEvent,
-} from '../gestureHandlerCommon';
-import { findHandler, findOldGestureHandler } from '../handlersRegistry';
-import { BaseGesture } from './gesture';
-import {
-  GestureStateManager,
-  GestureStateManagerType,
-} from './gestureStateManager';
-
-let gestureHandlerEventSubscription: EmitterSubscription | null = null;
-let gestureHandlerStateChangeEventSubscription: EmitterSubscription | null =
-  null;
-
-const gestureStateManagers: Map<number, GestureStateManagerType> = new Map<
-  number,
-  GestureStateManagerType
->();
-
-const lastUpdateEvent: (GestureUpdateEvent | undefined)[] = [];
-
-function isStateChangeEvent(
-  event: GestureUpdateEvent | GestureStateChangeEvent | GestureTouchEvent
-): event is GestureStateChangeEvent {
-  // @ts-ignore oldState doesn't exist on GestureTouchEvent and that's the point
-  return event.oldState != null;
-}
-
-function isTouchEvent(
-  event: GestureUpdateEvent | GestureStateChangeEvent | GestureTouchEvent
-): event is GestureTouchEvent {
-  return event.eventType != null;
-}
-
-export function onGestureHandlerEvent(
-  event: GestureUpdateEvent | GestureStateChangeEvent | GestureTouchEvent
-) {
-  const handler = findHandler(event.handlerTag) as BaseGesture<
-    Record<string, unknown>
-  >;
-
-  if (handler) {
-    if (isStateChangeEvent(event)) {
-      if (
-        event.oldState === State.UNDETERMINED &&
-        event.state === State.BEGAN
-      ) {
-        handler.handlers.onBegin?.(event);
-      } else if (
-        (event.oldState === State.BEGAN ||
-          event.oldState === State.UNDETERMINED) &&
-        event.state === State.ACTIVE
-      ) {
-        handler.handlers.onStart?.(event);
-        lastUpdateEvent[handler.handlers.handlerTag] = event;
-      } else if (event.oldState !== event.state && event.state === State.END) {
-        if (event.oldState === State.ACTIVE) {
-          handler.handlers.onEnd?.(event, true);
-        }
-        handler.handlers.onFinalize?.(event, true);
-        lastUpdateEvent[handler.handlers.handlerTag] = undefined;
-      } else if (
-        (event.state === State.FAILED || event.state === State.CANCELLED) &&
-        event.oldState !== event.state
-      ) {
-        if (event.oldState === State.ACTIVE) {
-          handler.handlers.onEnd?.(event, false);
-        }
-        handler.handlers.onFinalize?.(event, false);
-        gestureStateManagers.delete(event.handlerTag);
-        lastUpdateEvent[handler.handlers.handlerTag] = undefined;
-      }
-    } else if (isTouchEvent(event)) {
-      if (!gestureStateManagers.has(event.handlerTag)) {
-        gestureStateManagers.set(
-          event.handlerTag,
-          GestureStateManager.create(event.handlerTag)
-        );
-      }
-
-      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-      const manager = gestureStateManagers.get(event.handlerTag)!;
-
-      switch (event.eventType) {
-        case TouchEventType.TOUCHES_DOWN:
-          handler.handlers?.onTouchesDown?.(event, manager);
-          break;
-        case TouchEventType.TOUCHES_MOVE:
-          handler.handlers?.onTouchesMove?.(event, manager);
-          break;
-        case TouchEventType.TOUCHES_UP:
-          handler.handlers?.onTouchesUp?.(event, manager);
-          break;
-        case TouchEventType.TOUCHES_CANCELLED:
-          handler.handlers?.onTouchesCancelled?.(event, manager);
-          break;
-      }
-    } else {
-      handler.handlers.onUpdate?.(event);
-
-      if (handler.handlers.onChange && handler.handlers.changeEventCalculator) {
-        handler.handlers.onChange?.(
-          handler.handlers.changeEventCalculator?.(
-            event,
-            lastUpdateEvent[handler.handlers.handlerTag]
-          )
-        );
-
-        lastUpdateEvent[handler.handlers.handlerTag] = event;
-      }
-    }
-  } else {
-    const oldHandler = findOldGestureHandler(event.handlerTag);
-    if (oldHandler) {
-      const nativeEvent = { nativeEvent: event };
-      if (isStateChangeEvent(event)) {
-        oldHandler.onGestureStateChange(nativeEvent);
-      } else {
-        oldHandler.onGestureEvent(nativeEvent);
-      }
-      return;
-    }
-  }
-}
-
-export function startListening() {
-  stopListening();
-  // @ts-ignore
-  if (Platform.OS === 'kepler') {
-    // @ts-ignore
-    const eventEmitter = new NativeEventEmitter(RNGestureHandlerModule as typeof KeplerGestureHandlerModule)
-
-    gestureHandlerEventSubscription = eventEmitter.addListener(
-      'onGestureHandlerEvent',
-      onGestureHandlerEvent
-    );
- 
-    gestureHandlerStateChangeEventSubscription = eventEmitter.addListener(
-      'onGestureHandlerStateChange',
-      onGestureHandlerEvent
-    );
-  } else {
-    console.log(["[SWM] outside kepler"])
-    gestureHandlerEventSubscription = DeviceEventEmitter.addListener(
-      'onGestureHandlerEvent',
-      onGestureHandlerEvent
-    );
-  
-    gestureHandlerStateChangeEventSubscription = DeviceEventEmitter.addListener(
-      'onGestureHandlerStateChange',
-      onGestureHandlerEvent
-    );
-  }
-}
-
-export function stopListening() {
-  if (gestureHandlerEventSubscription) {
-    gestureHandlerEventSubscription.remove();
-    gestureHandlerEventSubscription = null;
-  }
-
-  if (gestureHandlerStateChangeEventSubscription) {
-    gestureHandlerStateChangeEventSubscription.remove();
-    gestureHandlerStateChangeEventSubscription = null;
-  }
-}

package/src/handlers/gestures/flingGesture.ts

@@ -1,36 +0,0 @@
-import { BaseGesture, BaseGestureConfig } from './gesture';
-import { FlingGestureConfig } from '../FlingGestureHandler';
-import type { FlingGestureHandlerEventPayload } from '../GestureHandlerEventPayload';
-
-export class FlingGesture extends BaseGesture<FlingGestureHandlerEventPayload> {
-  public config: BaseGestureConfig & FlingGestureConfig = {};
-
-  constructor() {
-    super();
-
-    this.handlerName = 'FlingGestureHandler';
-  }
-
-  /**
-   * Determine exact number of points required to handle the fling gesture.
-   * @param pointers
-   */
-  numberOfPointers(pointers: number) {
-    this.config.numberOfPointers = pointers;
-    return this;
-  }
-
-  /**
-   * Expressed allowed direction of movement.
-   * Expected values are exported as constants in the Directions object.
-   * Arguments can be combined using `|` operator. Default value is set to `Directions.RIGHT`.
-   * @param direction
-   * @see https://docs.swmansion.com/react-native-gesture-handler/docs/gestures/fling-gesture/#directionvalue-directions
-   */
-  direction(direction: number) {
-    this.config.direction = direction;
-    return this;
-  }
-}
-
-export type FlingGestureType = InstanceType<typeof FlingGesture>;

package/src/handlers/gestures/forceTouchGesture.ts

@@ -1,95 +0,0 @@
-import { BaseGestureConfig, ContinousBaseGesture } from './gesture';
-import { ForceTouchGestureConfig } from '../ForceTouchGestureHandler';
-import type { ForceTouchGestureHandlerEventPayload } from '../GestureHandlerEventPayload';
-import { GestureUpdateEvent } from '../gestureHandlerCommon';
-
-/**
- * @deprecated ForceTouch gesture is deprecated and will be removed in the future.
- */
-export type ForceTouchGestureChangeEventPayload = {
-  forceChange: number;
-};
-
-function changeEventCalculator(
-  current: GestureUpdateEvent<ForceTouchGestureHandlerEventPayload>,
-  previous?: GestureUpdateEvent<ForceTouchGestureHandlerEventPayload>
-) {
-  'worklet';
-  let changePayload: ForceTouchGestureChangeEventPayload;
-  if (previous === undefined) {
-    changePayload = {
-      forceChange: current.force,
-    };
-  } else {
-    changePayload = {
-      forceChange: current.force - previous.force,
-    };
-  }
-
-  return { ...current, ...changePayload };
-}
-
-/**
- * @deprecated ForceTouch gesture is deprecated and will be removed in the future.
- */
-export class ForceTouchGesture extends ContinousBaseGesture<
-  ForceTouchGestureHandlerEventPayload,
-  ForceTouchGestureChangeEventPayload
-> {
-  public config: BaseGestureConfig & ForceTouchGestureConfig = {};
-
-  constructor() {
-    super();
-
-    this.handlerName = 'ForceTouchGestureHandler';
-  }
-
-  /**
-   * A minimal pressure that is required before gesture can activate.
-   * Should be a value from range [0.0, 1.0]. Default is 0.2.
-   * @param force
-   */
-  minForce(force: number) {
-    this.config.minForce = force;
-    return this;
-  }
-
-  /**
-   * A maximal pressure that could be applied for gesture.
-   * If the pressure is greater, gesture fails. Should be a value from range [0.0, 1.0].
-   * @param force
-   */
-  maxForce(force: number) {
-    this.config.maxForce = force;
-    return this;
-  }
-
-  /**
-   * Value defining if haptic feedback has to be performed on activation.
-   * @param value
-   */
-  feedbackOnActivation(value: boolean) {
-    this.config.feedbackOnActivation = value;
-    return this;
-  }
-
-  onChange(
-    callback: (
-      event: GestureUpdateEvent<
-        GestureUpdateEvent<
-          ForceTouchGestureHandlerEventPayload &
-            ForceTouchGestureChangeEventPayload
-        >
-      >
-    ) => void
-  ) {
-    // @ts-ignore TS being overprotective, ForceTouchGestureHandlerEventPayload is Record
-    this.handlers.changeEventCalculator = changeEventCalculator;
-    return super.onChange(callback);
-  }
-}
-
-/**
- * @deprecated ForceTouch gesture is deprecated and will be removed in the future.
- */
-export type ForceTouchGestureType = InstanceType<typeof ForceTouchGesture>;