From a40747e2d88535fe2141455cd758cb4ffc93c56a Mon Sep 17 00:00:00 2001
From: Vincent Riemer <vincentriemer@fb.com>
Date: Mon, 18 Apr 2022 15:47:55 -0700
Subject: [PATCH] Add experimental disclaimers to pointer event APIs

Summary: Changelog: [Internal] - Add experimental disclaimers to pointer event APIs

Reviewed By: lunaleaps, p-sun

Differential Revision: D35682318

fbshipit-source-id: e85a37a2eb9568df636352e170bd42a3bb30a2f6
---
 Libraries/Components/View/ViewPropTypes.js          | 1 +
 Libraries/NativeComponent/BaseViewConfig.android.js | 2 ++
 Libraries/NativeComponent/BaseViewConfig.ios.js     | 2 +-
 React/Views/RCTViewManager.m                        | 2 +-
 4 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/Libraries/Components/View/ViewPropTypes.js b/Libraries/Components/View/ViewPropTypes.js
index 2dc20750fe..0d6753be9f 100644
--- a/Libraries/Components/View/ViewPropTypes.js
+++ b/Libraries/Components/View/ViewPropTypes.js
@@ -89,6 +89,7 @@ type MouseEventProps = $ReadOnly<{|
   onMouseLeave?: ?(event: MouseEvent) => void,
 |}>;
 
+// Experimental/Work in Progress Pointer Event Callbacks (not yet ready for use)
 type PointerEventProps = $ReadOnly<{|
   onPointerEnter?: ?(event: PointerEvent) => void,
   onPointerLeave?: ?(event: PointerEvent) => void,
diff --git a/Libraries/NativeComponent/BaseViewConfig.android.js b/Libraries/NativeComponent/BaseViewConfig.android.js
index f68885b469..400ca064f7 100644
--- a/Libraries/NativeComponent/BaseViewConfig.android.js
+++ b/Libraries/NativeComponent/BaseViewConfig.android.js
@@ -50,6 +50,8 @@ const bubblingEventTypes = {
       bubbled: 'onTouchMove',
     },
   },
+
+  // Experimental/Work in Progress Pointer Events (not yet ready for use)
   topPointerCancel: {
     phasedRegistrationNames: {
       captured: 'onPointerCancelCapture',
diff --git a/Libraries/NativeComponent/BaseViewConfig.ios.js b/Libraries/NativeComponent/BaseViewConfig.ios.js
index d600ee030c..620c915d21 100644
--- a/Libraries/NativeComponent/BaseViewConfig.ios.js
+++ b/Libraries/NativeComponent/BaseViewConfig.ios.js
@@ -86,7 +86,7 @@ const bubblingEventTypes = {
     },
   },
 
-  // Pointer Events
+  // Experimental/Work in Progress Pointer Events (not yet ready for use)
   topPointerCancel: {
     phasedRegistrationNames: {
       captured: 'onPointerCancelCapture',
diff --git a/React/Views/RCTViewManager.m b/React/Views/RCTViewManager.m
index 0af349726a..5dd39c0687 100644
--- a/React/Views/RCTViewManager.m
+++ b/React/Views/RCTViewManager.m
@@ -445,7 +445,7 @@ RCT_CUSTOM_VIEW_PROPERTY(onTouchMove, BOOL, RCTView) {}
 RCT_CUSTOM_VIEW_PROPERTY(onTouchEnd, BOOL, RCTView) {}
 RCT_CUSTOM_VIEW_PROPERTY(onTouchCancel, BOOL, RCTView) {}
 
-// Pointer Events
+// Experimental/WIP Pointer Events (not yet ready for use)
 RCT_EXPORT_VIEW_PROPERTY(onPointerCancel, RCTBubblingEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onPointerDown, RCTBubblingEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onPointerMove2, RCTBubblingEventBlock)