react-native-gesture-handler 2.27.0 → 2.27.2

package/src/components/ReanimatedSwipeable.tsx

@@ -1,811 +0,0 @@
-// Similarily to the DrawerLayout component this deserves to be put in a
-// separate repo. Although, keeping it here for the time being will allow us to
-// move faster and fix possible issues quicker
-
-import React, {
-  ForwardedRef,
-  forwardRef,
-  useCallback,
-  useImperativeHandle,
-  useMemo,
-} from 'react';
-import { GestureObjects as Gesture } from '../handlers/gestures/gestureObjects';
-import { GestureDetector } from '../handlers/gestures/GestureDetector';
-import {
-  GestureStateChangeEvent,
-  GestureUpdateEvent,
-} from '../handlers/gestureHandlerCommon';
-import type { PanGestureHandlerProps } from '../handlers/PanGestureHandler';
-import type { PanGestureHandlerEventPayload } from '../handlers/GestureHandlerEventPayload';
-import Animated, {
-  ReduceMotion,
-  SharedValue,
-  interpolate,
-  measure,
-  runOnJS,
-  runOnUI,
-  useAnimatedRef,
-  useAnimatedStyle,
-  useSharedValue,
-  withSpring,
-} from 'react-native-reanimated';
-import {
-  I18nManager,
-  LayoutChangeEvent,
-  StyleProp,
-  StyleSheet,
-  View,
-  ViewStyle,
-} from 'react-native';
-import { applyRelationProp, RelationPropName, RelationPropType } from './utils';
-
-const DRAG_TOSS = 0.05;
-
-type SwipeableExcludes = Exclude<
-  keyof PanGestureHandlerProps,
-  'onGestureEvent' | 'onHandlerStateChange'
->;
-
-enum SwipeDirection {
-  LEFT = 'left',
-  RIGHT = 'right',
-}
-
-export interface SwipeableProps
-  extends Pick<PanGestureHandlerProps, SwipeableExcludes> {
-  /**
-   * Enables two-finger gestures on supported devices, for example iPads with
-   * trackpads. If not enabled the gesture will require click + drag, with
-   * `enableTrackpadTwoFingerGesture` swiping with two fingers will also trigger
-   * the gesture.
-   */
-  enableTrackpadTwoFingerGesture?: boolean;
-
-  /**
-   * Specifies how much the visual interaction will be delayed compared to the
-   * gesture distance. e.g. value of 1 will indicate that the swipeable panel
-   * should exactly follow the gesture, 2 means it is going to be two times
-   * "slower".
-   */
-  friction?: number;
-
-  /**
-   * Distance from the left edge at which released panel will animate to the
-   * open state (or the open panel will animate into the closed state). By
-   * default it's a half of the panel's width.
-   */
-  leftThreshold?: number;
-
-  /**
-   * Distance from the right edge at which released panel will animate to the
-   * open state (or the open panel will animate into the closed state). By
-   * default it's a half of the panel's width.
-   */
-  rightThreshold?: number;
-
-  /**
-   * Distance that the panel must be dragged from the left edge to be considered
-   * a swipe. The default value is 10.
-   */
-  dragOffsetFromLeftEdge?: number;
-
-  /**
-   * Distance that the panel must be dragged from the right edge to be considered
-   * a swipe. The default value is 10.
-   */
-  dragOffsetFromRightEdge?: number;
-
-  /**
-   * Value indicating if the swipeable panel can be pulled further than the left
-   * actions panel's width. It is set to true by default as long as the left
-   * panel render method is present.
-   */
-  overshootLeft?: boolean;
-
-  /**
-   * Value indicating if the swipeable panel can be pulled further than the
-   * right actions panel's width. It is set to true by default as long as the
-   * right panel render method is present.
-   */
-  overshootRight?: boolean;
-
-  /**
-   * Specifies how much the visual interaction will be delayed compared to the
-   * gesture distance at overshoot. Default value is 1, it mean no friction, for
-   * a native feel, try 8 or above.
-   */
-  overshootFriction?: number;
-
-  /**
-   * Called when action panel gets open (either right or left).
-   */
-  onSwipeableOpen?: (
-    direction: SwipeDirection.LEFT | SwipeDirection.RIGHT
-  ) => void;
-
-  /**
-   * Called when action panel is closed.
-   */
-  onSwipeableClose?: (
-    direction: SwipeDirection.LEFT | SwipeDirection.RIGHT
-  ) => void;
-
-  /**
-   * Called when action panel starts animating on open (either right or left).
-   */
-  onSwipeableWillOpen?: (
-    direction: SwipeDirection.LEFT | SwipeDirection.RIGHT
-  ) => void;
-
-  /**
-   * Called when action panel starts animating on close.
-   */
-  onSwipeableWillClose?: (
-    direction: SwipeDirection.LEFT | SwipeDirection.RIGHT
-  ) => void;
-
-  /**
-   * Called when action panel starts being shown on dragging to open.
-   */
-  onSwipeableOpenStartDrag?: (
-    direction: SwipeDirection.LEFT | SwipeDirection.RIGHT
-  ) => void;
-
-  /**
-   * Called when action panel starts being shown on dragging to close.
-   */
-  onSwipeableCloseStartDrag?: (
-    direction: SwipeDirection.LEFT | SwipeDirection.RIGHT
-  ) => void;
-
-  /**
-   * `progress`: Equals `0` when `swipeable` is closed, `1` when `swipeable` is opened.
-   *  - When the element overshoots it's opened position the value tends towards `Infinity`.
-   *  - Goes back to `1` when `swipeable` is released.
-   *
-   * `translation`: a horizontal offset of the `swipeable` relative to its closed position.\
-   * `swipeableMethods`: provides an object exposing methods for controlling the `swipeable`.
-   *
-   * To support `rtl` flexbox layouts use `flexDirection` styling.
-   * */
-  renderLeftActions?: (
-    progress: SharedValue<number>,
-    translation: SharedValue<number>,
-    swipeableMethods: SwipeableMethods
-  ) => React.ReactNode;
-
-  /**
-   * `progress`: Equals `0` when `swipeable` is closed, `1` when `swipeable` is opened.
-   *  - When the element overshoots it's opened position the value tends towards `Infinity`.
-   *  - Goes back to `1` when `swipeable` is released.
-   *
-   * `translation`: a horizontal offset of the `swipeable` relative to its closed position.\
-   * `swipeableMethods`: provides an object exposing methods for controlling the `swipeable`.
-   *
-   * To support `rtl` flexbox layouts use `flexDirection` styling.
-   * */
-  renderRightActions?: (
-    progress: SharedValue<number>,
-    translation: SharedValue<number>,
-    swipeableMethods: SwipeableMethods
-  ) => React.ReactNode;
-
-  animationOptions?: Record<string, unknown>;
-
-  /**
-   * Style object for the container (`Animated.View`), for example to override
-   * `overflow: 'hidden'`.
-   */
-  containerStyle?: StyleProp<ViewStyle>;
-
-  /**
-   * Style object for the children container (`Animated.View`), for example to
-   * apply `flex: 1`
-   */
-  childrenContainerStyle?: StyleProp<ViewStyle>;
-
-  /**
-   * A gesture object or an array of gesture objects containing the configuration and callbacks to be
-   * used with the swipeable's gesture handler.
-   */
-  simultaneousWithExternalGesture?: RelationPropType;
-
-  /**
-   * A gesture object or an array of gesture objects containing the configuration and callbacks to be
-   * used with the swipeable's gesture handler.
-   */
-  requireExternalGestureToFail?: RelationPropType;
-
-  /**
-   * A gesture object or an array of gesture objects containing the configuration and callbacks to be
-   * used with the swipeable's gesture handler.
-   */
-  blocksExternalGesture?: RelationPropType;
-}
-
-export interface SwipeableMethods {
-  close: () => void;
-  openLeft: () => void;
-  openRight: () => void;
-  reset: () => void;
-}
-
-const Swipeable = forwardRef<SwipeableMethods, SwipeableProps>(
-  function Swipeable(
-    props: SwipeableProps,
-    ref: ForwardedRef<SwipeableMethods>
-  ) {
-    const defaultProps = {
-      friction: 1,
-      overshootFriction: 1,
-      dragOffset: 10,
-      enableTrackpadTwoFingerGesture: false,
-    };
-
-    const {
-      leftThreshold,
-      rightThreshold,
-      enabled,
-      containerStyle,
-      childrenContainerStyle,
-      animationOptions,
-      overshootLeft,
-      overshootRight,
-      testID,
-      children,
-      enableTrackpadTwoFingerGesture = defaultProps.enableTrackpadTwoFingerGesture,
-      dragOffsetFromLeftEdge = defaultProps.dragOffset,
-      dragOffsetFromRightEdge = defaultProps.dragOffset,
-      friction = defaultProps.friction,
-      overshootFriction = defaultProps.overshootFriction,
-      onSwipeableOpenStartDrag,
-      onSwipeableCloseStartDrag,
-      onSwipeableWillOpen,
-      onSwipeableWillClose,
-      onSwipeableOpen,
-      onSwipeableClose,
-      renderLeftActions,
-      renderRightActions,
-      simultaneousWithExternalGesture,
-      requireExternalGestureToFail,
-      blocksExternalGesture,
-      hitSlop,
-      ...remainingProps
-    } = props;
-
-    const relationProps = {
-      simultaneousWithExternalGesture,
-      requireExternalGestureToFail,
-      blocksExternalGesture,
-    };
-
-    const rowState = useSharedValue<number>(0);
-
-    const userDrag = useSharedValue<number>(0);
-
-    const appliedTranslation = useSharedValue<number>(0);
-
-    const rowWidth = useSharedValue<number>(0);
-    const leftWidth = useSharedValue<number>(0);
-    const rightWidth = useSharedValue<number>(0);
-
-    const showLeftProgress = useSharedValue<number>(0);
-    const showRightProgress = useSharedValue<number>(0);
-
-    const updateAnimatedEvent = useCallback(() => {
-      'worklet';
-
-      const shouldOvershootLeft = overshootLeft ?? leftWidth.value > 0;
-      const shouldOvershootRight = overshootRight ?? rightWidth.value > 0;
-
-      const startOffset =
-        rowState.value === 1
-          ? leftWidth.value
-          : rowState.value === -1
-            ? -rightWidth.value
-            : 0;
-
-      const offsetDrag = userDrag.value / friction + startOffset;
-
-      appliedTranslation.value = interpolate(
-        offsetDrag,
-        [
-          -rightWidth.value - 1,
-          -rightWidth.value,
-          leftWidth.value,
-          leftWidth.value + 1,
-        ],
-        [
-          -rightWidth.value -
-            (shouldOvershootRight ? 1 / overshootFriction : 0),
-          -rightWidth.value,
-          leftWidth.value,
-          leftWidth.value + (shouldOvershootLeft ? 1 / overshootFriction : 0),
-        ]
-      );
-
-      showLeftProgress.value =
-        leftWidth.value > 0
-          ? interpolate(
-              appliedTranslation.value,
-              [-1, 0, leftWidth.value],
-              [0, 0, 1]
-            )
-          : 0;
-
-      showRightProgress.value =
-        rightWidth.value > 0
-          ? interpolate(
-              appliedTranslation.value,
-              [-rightWidth.value, 0, 1],
-              [1, 0, 0]
-            )
-          : 0;
-    }, [
-      appliedTranslation,
-      friction,
-      leftWidth,
-      overshootFriction,
-      rightWidth,
-      rowState,
-      showLeftProgress,
-      showRightProgress,
-      userDrag,
-      overshootLeft,
-      overshootRight,
-    ]);
-
-    const dispatchImmediateEvents = useCallback(
-      (fromValue: number, toValue: number) => {
-        'worklet';
-
-        if (onSwipeableWillOpen && toValue !== 0) {
-          runOnJS(onSwipeableWillOpen)(
-            toValue > 0 ? SwipeDirection.RIGHT : SwipeDirection.LEFT
-          );
-        }
-
-        if (onSwipeableWillClose && toValue === 0) {
-          runOnJS(onSwipeableWillClose)(
-            fromValue > 0 ? SwipeDirection.LEFT : SwipeDirection.RIGHT
-          );
-        }
-      },
-      [onSwipeableWillClose, onSwipeableWillOpen, rowState]
-    );
-
-    const dispatchEndEvents = useCallback(
-      (fromValue: number, toValue: number) => {
-        'worklet';
-
-        if (onSwipeableOpen && toValue !== 0) {
-          runOnJS(onSwipeableOpen)(
-            toValue > 0 ? SwipeDirection.RIGHT : SwipeDirection.LEFT
-          );
-        }
-
-        if (onSwipeableClose && toValue === 0) {
-          runOnJS(onSwipeableClose)(
-            fromValue > 0 ? SwipeDirection.LEFT : SwipeDirection.RIGHT
-          );
-        }
-      },
-      [onSwipeableClose, onSwipeableOpen]
-    );
-
-    const animateRow: (toValue: number, velocityX?: number) => void =
-      useCallback(
-        (toValue: number, velocityX?: number) => {
-          'worklet';
-
-          const translationSpringConfig = {
-            mass: 2,
-            damping: 1000,
-            stiffness: 700,
-            velocity: velocityX,
-            overshootClamping: true,
-            reduceMotion: ReduceMotion.System,
-            ...animationOptions,
-          };
-
-          const isClosing = toValue === 0;
-          const moveToRight = isClosing ? rowState.value < 0 : toValue > 0;
-
-          const usedWidth = isClosing
-            ? moveToRight
-              ? rightWidth.value
-              : leftWidth.value
-            : moveToRight
-              ? leftWidth.value
-              : rightWidth.value;
-
-          const progressSpringConfig = {
-            ...translationSpringConfig,
-            restDisplacementThreshold: 0.01,
-            restSpeedThreshold: 0.01,
-            velocity:
-              velocityX &&
-              interpolate(velocityX, [-usedWidth, usedWidth], [-1, 1]),
-          };
-
-          const frozenRowState = rowState.value;
-
-          appliedTranslation.value = withSpring(
-            toValue,
-            translationSpringConfig,
-            (isFinished) => {
-              if (isFinished) {
-                dispatchEndEvents(frozenRowState, toValue);
-              }
-            }
-          );
-
-          const progressTarget = toValue === 0 ? 0 : 1 * Math.sign(toValue);
-
-          showLeftProgress.value = withSpring(
-            Math.max(progressTarget, 0),
-            progressSpringConfig
-          );
-
-          showRightProgress.value = withSpring(
-            Math.max(-progressTarget, 0),
-            progressSpringConfig
-          );
-
-          dispatchImmediateEvents(frozenRowState, toValue);
-
-          rowState.value = Math.sign(toValue);
-        },
-        [
-          rowState,
-          animationOptions,
-          appliedTranslation,
-          showLeftProgress,
-          leftWidth,
-          showRightProgress,
-          rightWidth,
-          dispatchImmediateEvents,
-          dispatchEndEvents,
-        ]
-      );
-
-    const leftLayoutRef = useAnimatedRef();
-    const leftWrapperLayoutRef = useAnimatedRef();
-    const rightLayoutRef = useAnimatedRef();
-
-    const updateElementWidths = useCallback(() => {
-      'worklet';
-      const leftLayout = measure(leftLayoutRef);
-      const leftWrapperLayout = measure(leftWrapperLayoutRef);
-      const rightLayout = measure(rightLayoutRef);
-      leftWidth.value =
-        (leftLayout?.pageX ?? 0) - (leftWrapperLayout?.pageX ?? 0);
-
-      rightWidth.value =
-        rowWidth.value -
-        (rightLayout?.pageX ?? rowWidth.value) +
-        (leftWrapperLayout?.pageX ?? 0);
-    }, [
-      leftLayoutRef,
-      leftWrapperLayoutRef,
-      rightLayoutRef,
-      leftWidth,
-      rightWidth,
-      rowWidth,
-    ]);
-
-    const swipeableMethods = useMemo<SwipeableMethods>(
-      () => ({
-        close() {
-          'worklet';
-          if (_WORKLET) {
-            animateRow(0);
-            return;
-          }
-          runOnUI(() => {
-            animateRow(0);
-          })();
-        },
-        openLeft() {
-          'worklet';
-          if (_WORKLET) {
-            updateElementWidths();
-            animateRow(leftWidth.value);
-            return;
-          }
-          runOnUI(() => {
-            updateElementWidths();
-            animateRow(leftWidth.value);
-          })();
-        },
-        openRight() {
-          'worklet';
-          if (_WORKLET) {
-            updateElementWidths();
-            animateRow(-rightWidth.value);
-            return;
-          }
-          runOnUI(() => {
-            updateElementWidths();
-            animateRow(-rightWidth.value);
-          })();
-        },
-        reset() {
-          'worklet';
-          userDrag.value = 0;
-          showLeftProgress.value = 0;
-          appliedTranslation.value = 0;
-          rowState.value = 0;
-        },
-      }),
-      [
-        animateRow,
-        updateElementWidths,
-        leftWidth,
-        rightWidth,
-        userDrag,
-        showLeftProgress,
-        appliedTranslation,
-        rowState,
-      ]
-    );
-
-    const onRowLayout = useCallback(
-      ({ nativeEvent }: LayoutChangeEvent) => {
-        rowWidth.value = nativeEvent.layout.width;
-      },
-      [rowWidth]
-    );
-
-    // As stated in `Dimensions.get` docstring, this function should be called on every render
-    // since dimensions may change (e.g. orientation change)
-
-    const leftActionAnimation = useAnimatedStyle(() => {
-      return {
-        opacity: showLeftProgress.value === 0 ? 0 : 1,
-      };
-    });
-
-    const leftElement = useCallback(
-      () => (
-        <Animated.View
-          ref={leftWrapperLayoutRef}
-          style={[styles.leftActions, leftActionAnimation]}>
-          {renderLeftActions?.(
-            showLeftProgress,
-            appliedTranslation,
-            swipeableMethods
-          )}
-          <Animated.View ref={leftLayoutRef} />
-        </Animated.View>
-      ),
-      [
-        appliedTranslation,
-        leftActionAnimation,
-        leftLayoutRef,
-        leftWrapperLayoutRef,
-        renderLeftActions,
-        showLeftProgress,
-        swipeableMethods,
-      ]
-    );
-
-    const rightActionAnimation = useAnimatedStyle(() => {
-      return {
-        opacity: showRightProgress.value === 0 ? 0 : 1,
-      };
-    });
-
-    const rightElement = useCallback(
-      () => (
-        <Animated.View style={[styles.rightActions, rightActionAnimation]}>
-          {renderRightActions?.(
-            showRightProgress,
-            appliedTranslation,
-            swipeableMethods
-          )}
-          <Animated.View ref={rightLayoutRef} />
-        </Animated.View>
-      ),
-      [
-        appliedTranslation,
-        renderRightActions,
-        rightActionAnimation,
-        rightLayoutRef,
-        showRightProgress,
-        swipeableMethods,
-      ]
-    );
-
-    const handleRelease = useCallback(
-      (event: GestureStateChangeEvent<PanGestureHandlerEventPayload>) => {
-        'worklet';
-        const { velocityX } = event;
-        userDrag.value = event.translationX;
-
-        const leftThresholdProp = leftThreshold ?? leftWidth.value / 2;
-        const rightThresholdProp = rightThreshold ?? rightWidth.value / 2;
-
-        const translationX =
-          (userDrag.value + DRAG_TOSS * velocityX) / friction;
-
-        let toValue = 0;
-
-        if (rowState.value === 0) {
-          if (translationX > leftThresholdProp) {
-            toValue = leftWidth.value;
-          } else if (translationX < -rightThresholdProp) {
-            toValue = -rightWidth.value;
-          }
-        } else if (rowState.value === 1) {
-          // Swiped to left
-          if (translationX > -leftThresholdProp) {
-            toValue = leftWidth.value;
-          }
-        } else {
-          // Swiped to right
-          if (translationX < rightThresholdProp) {
-            toValue = -rightWidth.value;
-          }
-        }
-
-        animateRow(toValue, velocityX / friction);
-      },
-      [
-        animateRow,
-        friction,
-        leftThreshold,
-        leftWidth,
-        rightThreshold,
-        rightWidth,
-        rowState,
-        userDrag,
-      ]
-    );
-
-    const close = useCallback(() => {
-      'worklet';
-      animateRow(0);
-    }, [animateRow]);
-
-    const dragStarted = useSharedValue<boolean>(false);
-
-    const tapGesture = useMemo(() => {
-      const tap = Gesture.Tap()
-        .shouldCancelWhenOutside(true)
-        .onStart(() => {
-          if (rowState.value !== 0) {
-            close();
-          }
-        });
-
-      Object.entries(relationProps).forEach(([relationName, relation]) => {
-        applyRelationProp(
-          tap,
-          relationName as RelationPropName,
-          relation as RelationPropType
-        );
-      });
-
-      return tap;
-    }, [close, rowState, simultaneousWithExternalGesture]);
-
-    const panGesture = useMemo(() => {
-      const pan = Gesture.Pan()
-        .enabled(enabled !== false)
-        .enableTrackpadTwoFingerGesture(enableTrackpadTwoFingerGesture)
-        .activeOffsetX([-dragOffsetFromRightEdge, dragOffsetFromLeftEdge])
-        .onStart(updateElementWidths)
-        .onUpdate(
-          (event: GestureUpdateEvent<PanGestureHandlerEventPayload>) => {
-            userDrag.value = event.translationX;
-
-            const direction =
-              rowState.value === -1
-                ? SwipeDirection.RIGHT
-                : rowState.value === 1
-                  ? SwipeDirection.LEFT
-                  : event.translationX > 0
-                    ? SwipeDirection.RIGHT
-                    : SwipeDirection.LEFT;
-
-            if (!dragStarted.value) {
-              dragStarted.value = true;
-              if (rowState.value === 0 && onSwipeableOpenStartDrag) {
-                runOnJS(onSwipeableOpenStartDrag)(direction);
-              } else if (onSwipeableCloseStartDrag) {
-                runOnJS(onSwipeableCloseStartDrag)(direction);
-              }
-            }
-
-            updateAnimatedEvent();
-          }
-        )
-        .onEnd(
-          (event: GestureStateChangeEvent<PanGestureHandlerEventPayload>) => {
-            handleRelease(event);
-          }
-        )
-        .onFinalize(() => {
-          dragStarted.value = false;
-        });
-
-      Object.entries(relationProps).forEach(([relationName, relation]) => {
-        applyRelationProp(
-          pan,
-          relationName as RelationPropName,
-          relation as RelationPropType
-        );
-      });
-
-      return pan;
-    }, [
-      dragOffsetFromLeftEdge,
-      dragOffsetFromRightEdge,
-      dragStarted,
-      enableTrackpadTwoFingerGesture,
-      enabled,
-      handleRelease,
-      onSwipeableCloseStartDrag,
-      onSwipeableOpenStartDrag,
-      rowState,
-      updateAnimatedEvent,
-      updateElementWidths,
-      userDrag,
-      simultaneousWithExternalGesture,
-    ]);
-
-    useImperativeHandle(ref, () => swipeableMethods, [swipeableMethods]);
-
-    const animatedStyle = useAnimatedStyle(
-      () => ({
-        transform: [{ translateX: appliedTranslation.value }],
-        pointerEvents: rowState.value === 0 ? 'auto' : 'box-only',
-      }),
-      [appliedTranslation, rowState]
-    );
-
-    const swipeableComponent = (
-      <GestureDetector gesture={panGesture} touchAction="pan-y">
-        <Animated.View
-          {...remainingProps}
-          onLayout={onRowLayout}
-          hitSlop={hitSlop ?? undefined}
-          style={[styles.container, containerStyle]}>
-          {leftElement()}
-          {rightElement()}
-          <GestureDetector gesture={tapGesture} touchAction="pan-y">
-            <Animated.View style={[animatedStyle, childrenContainerStyle]}>
-              {children}
-            </Animated.View>
-          </GestureDetector>
-        </Animated.View>
-      </GestureDetector>
-    );
-
-    return testID ? (
-      <View testID={testID}>{swipeableComponent}</View>
-    ) : (
-      swipeableComponent
-    );
-  }
-);
-
-export default Swipeable;
-export type SwipeableRef = ForwardedRef<SwipeableMethods>;
-
-const styles = StyleSheet.create({
-  container: {
-    overflow: 'hidden',
-  },
-  leftActions: {
-    ...StyleSheet.absoluteFillObject,
-    flexDirection: I18nManager.isRTL ? 'row-reverse' : 'row',
-    overflow: 'hidden',
-  },
-  rightActions: {
-    ...StyleSheet.absoluteFillObject,
-    flexDirection: I18nManager.isRTL ? 'row' : 'row-reverse',
-    overflow: 'hidden',
-  },
-});