Deprecate Touchable components (#3260)

## Description

This PR deprecates `Touchable` components in our repo

## Test plan

Try importing any `Touchable` (or its `props`). After importing look at
the console.

---------

Co-authored-by: Jakub Piasecki <jakub.piasecki@swmansion.com>

Author: m-bert

docs/docs/components/touchables.md

@@ -4,6 +4,10 @@ title: Touchables
 sidebar_label: Touchables
 ---
 
+:::warning
+Touchables will be removed in the future version of Gesture Handler.
+:::
+
 Gesture Handler library provides an implementation of RN's touchable components that are based on [native buttons](buttons.mdx) and does not rely on JS responder system utilized by RN. Our touchable implementation follows the same API and aims to be a drop-in replacement for touchables available in React Native.
 
 React Native's touchables API can be found here:

src/components/touchables/TouchableHighlight.tsx

@@ -19,10 +19,15 @@ interface State {
   };
 }
 
+/**
+ * @deprecated TouchableHighlight will be removed in the future version of Gesture Handler.
+ */
 export type TouchableHighlightProps = RNTouchableHighlightProps &
   GenericTouchableProps;
 
 /**
+ * @deprecated TouchableHighlight will be removed in the future version of Gesture Handler.
+ *
  * TouchableHighlight follows RN's implementation
  */
 export default class TouchableHighlight extends Component<

src/components/touchables/TouchableNativeFeedback.android.tsx

@@ -8,6 +8,8 @@ import {
 } from './TouchableNativeFeedbackProps';
 
 /**
+ * @deprecated TouchableNativeFeedback will be removed in the future version of Gesture Handler.
+ *
  * TouchableNativeFeedback behaves slightly different than RN's TouchableNativeFeedback.
  * There's small difference with handling long press ripple since RN's implementation calls
  * ripple animation via bridge. This solution leaves all animations' handling for native components so

src/components/touchables/TouchableNativeFeedback.tsx

@@ -1,3 +1,22 @@
-import { TouchableNativeFeedback } from 'react-native';
+import React, { useEffect } from 'react';
+import { TouchableNativeFeedback as RNTouchableNativeFeedback } from 'react-native';
+import { tagMessage } from '../../utils';
+
+/**
+ * @deprecated TouchableNativeFeedback will be removed in the future version of Gesture Handler.
+ */
+const TouchableNativeFeedback: React.FC<
+  React.ComponentProps<typeof RNTouchableNativeFeedback>
+> = (props) => {
+  useEffect(() => {
+    console.warn(
+      tagMessage(
+        'TouchableOpacity component will be removed in the future version of Gesture Handler.'
+      )
+    );
+  }, []);
+
+  return <RNTouchableNativeFeedback {...props} />;
+};
 
 export default TouchableNativeFeedback;

src/components/touchables/TouchableNativeFeedbackProps.tsx

@@ -8,5 +8,8 @@ export type TouchableNativeFeedbackExtraProps = {
   foreground?: boolean;
 };
 
+/**
+ * @deprecated TouchableNativeFeedback will be removed in the future version of Gesture Handler.
+ */
 export type TouchableNativeFeedbackProps = RNTouchableNativeFeedbackProps &
   GenericTouchableProps;

src/components/touchables/TouchableOpacity.tsx

@@ -10,12 +10,17 @@ import type { GenericTouchableProps } from './GenericTouchableProps';
 import * as React from 'react';
 import { Component } from 'react';
 
+/**
+ * @deprecated TouchableOpacity will be removed in the future version of Gesture Handler.
+ */
 export type TouchableOpacityProps = RNTouchableOpacityProps &
   GenericTouchableProps & {
     useNativeAnimations?: boolean;
   };
 
 /**
+ * @deprecated TouchableOpacity will be removed in the future version of Gesture Handler.
+ *
  * TouchableOpacity bases on timing animation which has been used in RN's core
  */
 export default class TouchableOpacity extends Component<TouchableOpacityProps> {

src/components/touchables/TouchableWithoutFeedback.tsx

@@ -3,8 +3,14 @@ import { PropsWithChildren } from 'react';
 import GenericTouchable from './GenericTouchable';
 import type { GenericTouchableProps } from './GenericTouchableProps';
 
+/**
+ * @deprecated TouchableWithoutFeedback will be removed in the future version of Gesture Handler.
+ */
 export type TouchableWithoutFeedbackProps = GenericTouchableProps;
 
+/**
+ * @deprecated TouchableWithoutFeedback will be removed in the future version of Gesture Handler.
+ */
 const TouchableWithoutFeedback = React.forwardRef<
   GenericTouchable,
   PropsWithChildren<TouchableWithoutFeedbackProps>