feat: add swipe direction on iOS

[WoLewicki]

Description

Added swipeDirection prop on iOS. Be aware that you need to also apply customAnimationOnSwipe: true in order for the swipe to resolve in the animation of the screen and fullScreenSwipeEnabled since you want the gesture to be recognized on the whole screen most probably. Requested in #946.

Test code and steps to reproduce

Test1260.tsx.

Checklist

• Included code example that can be used to test this change
• Updated TS types
• Updated documentation:
  • https://github.com/software-mansion/react-native-screens/blob/main/guides/GUIDE_FOR_LIBRARY_AUTHORS.md
  • https://github.com/software-mansion/react-native-screens/blob/main/native-stack/README.md
  • https://github.com/software-mansion/react-native-screens/blob/main/createNativeStackNavigator/README.md
  • https://github.com/software-mansion/react-native-screens/blob/main/src/types.tsx
  • https://github.com/software-mansion/react-native-screens/blob/main/src/native-stack/types.tsx
• Ensured that CI passes

[kacperkapusciak]

1. I really like the implementation - it's very simple and elegant 👏

2. On the other hand, the developer experience while using this prop is quite terrible. I'd suggest making all of these props set for the developer automatically by default:

fullScreenSwipeEnabled: true,
customAnimationOnSwipe: true,
stackAnimation: 'slide_from_bottom'

when setting swipeDirection to vertical.

3. I could also see this prop as verticalSwipeEnabled but I'm okay with swipeDirection

[kacperkapusciak]

As vertical swipe doesn't really make sense without fullScreenSwipeEnabled:

Screen.Recording.2022-01-26.at.09.48.44.mov

we should set it to true by default when developer sets swipeDirection to vertical

[hirbod]

swipeDirection is still missing on react-navigation. Also transition duration. @kacperkapusciak would you mind to make a upstream PR?

[dylancom]

@WoLewicki the finish transition seems to be too fast (after finishing swiping). Opposed to the slide_from_bottom animation upon opening and closing it.

[WoLewicki]

@dylancom it might come from the fact that we use linear curve for animation so it does not ease at the end, but it is needed for the animation to correctly follow the fingers movement (see https://github.com/software-mansion/react-native-screens/pull/1260/files#diff-83118208fa3d654be0279bbef93d6715d0912aa6a5abdbf25fc5ee0eb12e1f14R213). But I think it is done the same on interactive slide_from_bottom animation so it seems weird.