Hide ReactNativeElement constructor from public API (#57028)

Summary:

Mark `ReactNativeElement` as non-user-constructible in the generated TypeScript definitions by selectively stripping the constructor on this type.

**Motivation**

- Correctness — like web DOM elements (`HTMLElement`, etc.), `ReactNativeElement` instances are created by the React Native runtime, not in user space.
- Reduce public API surface (in particular, since this is also aliased to the `HostInstance` type).

**Changes**

- Adds a new `build-types omit-constructor` directive and corresponding `build-types` post-transform.
- Applies directive to `ReactNativeElement`.
- Also extracts shared `build-types` directive helpers into `transforms/typescript/utils/buildDirectives.js`.

Changelog: [Internal]

Differential Revision: D107119545

Author: huntie

packages/react-native/ReactNativeApi.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<a438af540f18c77572f05cef9481b7a6>>
+ * @generated SignedSource<<00cb2351bba6e33a8d2f129e6ccdf4c0>>
  *
  * This file was generated by scripts/js-api/build-types/index.js.
  */
@@ -4047,12 +4047,6 @@ declare class ReactNativeElement_default
   implements NativeMethods
 {
   blur(): void
-  constructor(
-    tag: number,
-    viewConfig: ViewConfig,
-    instanceHandle: InstanceHandle,
-    ownerDocument: ReactNativeDocument_default,
-  )
   focus(): void
   measure(callback: MeasureOnSuccessCallback): void
   measureInWindow(callback: MeasureInWindowOnSuccessCallback): void
@@ -5992,23 +5986,23 @@ declare type WrapperComponentProvider = (
   appParameters: Object,
 ) => React.ComponentType<any>
 export {
-  AccessibilityActionEvent, // 5c5928b9
-  AccessibilityInfo, // 539eb4b3
+  AccessibilityActionEvent, // 33aba12a
+  AccessibilityInfo, // 54271401
   AccessibilityProps, // 5a2836fc
   AccessibilityRole, // f2f2e066
   AccessibilityState, // b0c2b3f7
   AccessibilityValue, // cf8bcb74
   ActionSheetIOS, // b558559e
   ActionSheetIOSOptions, // 1756eb5a
-  ActivityIndicator, // f06b0687
-  ActivityIndicatorProps, // 5e976856
+  ActivityIndicator, // c37376bf
+  ActivityIndicatorProps, // 9e338734
   Alert, // 5bf12165
   AlertButton, // bf1a3b60
   AlertButtonStyle, // ec9fb242
   AlertOptions, // a0cdac0f
   AlertType, // 5ab91217
   AndroidKeyboardEvent, // e03becc8
-  Animated, // 1a47480c
+  Animated, // 47b79675
   AppConfig, // ce4209a7
   AppRegistry, // 5edf0524
   AppState, // 12012be5
@@ -6018,12 +6012,12 @@ export {
   AutoCapitalize, // c0e857a0
   BackHandler, // f139fc69
   BackPressEventName, // 4620fb76
-  BlurEvent, // e6151a1f
+  BlurEvent, // 780c86b3
   BoxShadowValue, // b679703f
-  Button, // 869e5a89
-  ButtonProps, // 349967e6
+  Button, // ef9592c5
+  ButtonProps, // 314e63c6
   Clipboard, // 41addb89
-  CodegenTypes, // 0b8108a8
+  CodegenTypes, // 449fadfa
   ColorSchemeName, // 6615edd6
   ColorValue, // 98989a8f
   ComponentProvider, // b5c60ddd
@@ -6039,9 +6033,9 @@ export {
   DimensionsPayload, // 653bc26c
   DisplayMetrics, // 1dc35cef
   DisplayMetricsAndroid, // 872e62eb
-  DrawerLayoutAndroid, // eb4bcfa5
-  DrawerLayoutAndroidProps, // 1ddb208e
-  DrawerSlideEvent, // 0256d35a
+  DrawerLayoutAndroid, // 94e81861
+  DrawerLayoutAndroidProps, // 9ff4484a
+  DrawerSlideEvent, // d175a538
   DropShadowValue, // e9df2606
   DynamicColorIOS, // d96c228c
   DynamicColorIOSTuple, // 023ce58e
@@ -6055,29 +6049,29 @@ export {
   EventSubscription, // b8d084aa
   ExtendedExceptionData, // 5a6ccf5a
   FilterFunction, // bf24c0e3
-  FlatList, // e47faa4e
-  FlatListProps, // 22cacca0
-  FocusEvent, // 62fc1eb8
+  FlatList, // c05cd406
+  FlatListProps, // ccbb7cbf
+  FocusEvent, // 62f32376
   FontVariant, // 7c7558bb
-  GestureResponderEvent, // f693e9a5
-  GestureResponderHandlers, // cc70e4cb
+  GestureResponderEvent, // e63debf2
+  GestureResponderHandlers, // 2b92c86d
   Handle, // 2d65285d
-  HostComponent, // 16fccab5
-  HostInstance, // 9b5a9ec2
+  HostComponent, // 03bfd9f4
+  HostInstance, // ca179e31
   I18nManager, // f9870e00
   IEventEmitter, // fbef6131
   IOSKeyboardEvent, // e67bfe3a
   IgnorePattern, // ec6f6ece
-  Image, // 1891541a
-  ImageBackground, // cf95f60b
-  ImageBackgroundProps, // c68c896d
-  ImageErrorEvent, // d3ee606e
-  ImageLoadEvent, // 6b547ea5
-  ImageProgressEventIOS, // 4c866a82
-  ImageProps, // 801d1e1c
+  Image, // fd93f5d1
+  ImageBackground, // 4fe27d63
+  ImageBackgroundProps, // b2720e58
+  ImageErrorEvent, // 786fdfcc
+  ImageLoadEvent, // bef775c1
+  ImageProgressEventIOS, // 7aff2128
+  ImageProps, // 918d8ffe
   ImagePropsAndroid, // 9fd9bcbb
-  ImagePropsBase, // 372b652b
-  ImagePropsIOS, // c4ae0c06
+  ImagePropsBase, // 085d3f57
+  ImagePropsIOS, // 872d46ca
   ImageRequireSource, // 681d683b
   ImageResolvedAssetSource, // f3060931
   ImageSize, // 1c47cf88
@@ -6090,12 +6084,12 @@ export {
   InputModeOptions, // 4e8581b9
   Insets, // e7fe432a
   InteractionManager, // c324d6e3
-  KeyDownEvent, // d4971b72
+  KeyDownEvent, // b97b3b72
   KeyEvent, // 20fa4267
-  KeyUpEvent, // bc6bd87b
+  KeyUpEvent, // c0fda285
   Keyboard, // 49414c97
-  KeyboardAvoidingView, // c8c29c8d
-  KeyboardAvoidingViewProps, // 4114f649
+  KeyboardAvoidingView, // 4cfb12da
+  KeyboardAvoidingViewProps, // 399d87a5
   KeyboardEvent, // c3f895d4
   KeyboardEventEasing, // af4091c8
   KeyboardEventName, // 59299ad6
@@ -6108,7 +6102,7 @@ export {
   LayoutAnimationProperty, // 52995f01
   LayoutAnimationType, // 2da0a29b
   LayoutAnimationTypes, // 081b3bde
-  LayoutChangeEvent, // c388ba2b
+  LayoutChangeEvent, // 37529b47
   LayoutConformanceProps, // 055f03b8
   LayoutRectangle, // 6601b294
   Linking, // 9a6a174d
@@ -6120,34 +6114,34 @@ export {
   MeasureInWindowOnSuccessCallback, // a285f598
   MeasureLayoutOnSuccessCallback, // 3592502a
   MeasureOnSuccessCallback, // 82824e59
-  Modal, // bdd9bb3f
-  ModalBaseProps, // 3cca97dc
-  ModalProps, // aa4211df
+  Modal, // 22be095d
+  ModalBaseProps, // a278cadf
+  ModalProps, // 63861662
   ModalPropsAndroid, // 515fb173
-  ModalPropsIOS, // 144bbc95
-  ModeChangeEvent, // a5e9864f
-  MouseEvent, // fdce82bc
+  ModalPropsIOS, // ac424bbd
+  ModeChangeEvent, // 679fe81e
+  MouseEvent, // 8e5523a5
   NativeAppEventEmitter, // 08d4c47d
   NativeColorValue, // d2094c29
-  NativeComponentRegistry, // 21481a60
+  NativeComponentRegistry, // 616e1846
   NativeDialogManagerAndroid, // 5be8497e
   NativeEventEmitter, // 27f97c1a
   NativeEventSubscription, // de3942e7
-  NativeMethods, // a2311987
-  NativeMethodsMixin, // a819ef55
+  NativeMethods, // 53965456
+  NativeMethodsMixin, // 263e85c9
   NativeModules, // 4597cd36
-  NativeMouseEvent, // 558d45b0
-  NativePointerEvent, // f1763d80
+  NativeMouseEvent, // 723e899b
+  NativePointerEvent, // e28e3782
   NativeScrollEvent, // caad7f53
-  NativeSyntheticEvent, // 35855c4c
+  NativeSyntheticEvent, // cb87886b
   NativeTouchEvent, // 59b676df
   NativeUIEvent, // 44ac26ac
   Networking, // bbc5be42
   OpaqueColorValue, // 25f3fa5b
-  PanResponder, // 4320c1ba
-  PanResponderCallbacks, // ed54b109
+  PanResponder, // f95255ab
+  PanResponderCallbacks, // d54e3183
   PanResponderGestureState, // 54baf558
-  PanResponderInstance, // 46b4629d
+  PanResponderInstance, // 957e6213
   Permission, // 06473f4f
   PermissionStatus, // 4b7de97b
   PermissionsAndroid, // db2a401e
@@ -6157,52 +6151,52 @@ export {
   PlatformOSType, // 0a17561e
   PlatformSelectSpec, // 09ed7758
   PointValue, // 69db075f
-  PointerEvent, // fe3989a1
-  PressabilityConfig, // 6dedcb61
-  PressabilityEventHandlers, // 3e6c0f56
-  Pressable, // 0241ba70
+  PointerEvent, // 4af4b669
+  PressabilityConfig, // ad5b865f
+  PressabilityEventHandlers, // 28f81d78
+  Pressable, // 6a0232e2
   PressableAndroidRippleConfig, // ee32eaca
-  PressableProps, // a9048420
+  PressableProps, // 2410d681
   PressableStateCallbackType, // 9af36561
   ProcessedColorValue, // 33f74304
-  ProgressBarAndroid, // 00fcd180
-  ProgressBarAndroidProps, // f59f8f03
+  ProgressBarAndroid, // a4af8a30
+  ProgressBarAndroidProps, // 07dcdf0d
   PromiseTask, // 5102c862
   PublicRootInstance, // 8040afd7
-  PublicTextInstance, // cd0d8f8d
+  PublicTextInstance, // 9fcf80fb
   PushNotificationEventName, // 84e7e150
   PushNotificationIOS, // b4d1fe78
   PushNotificationPermissions, // c2e7ae4f
   Rationale, // 5df1b1c1
   ReactNativeVersion, // abd76827
-  RefreshControl, // ed67a3b2
-  RefreshControlProps, // bfc35644
+  RefreshControl, // 047bfe27
+  RefreshControlProps, // b50092cb
   RefreshControlPropsAndroid, // 99f64c97
   RefreshControlPropsIOS, // 72a36381
   Registry, // 6c39216d
-  ResponderSyntheticEvent, // fb10247c
+  ResponderSyntheticEvent, // adf32caa
   ReturnKeyTypeOptions, // afd47ba3
   Role, // af7b889d
   RootTag, // 3cd10504
   RootTagContext, // 38bfc8f6
   RootViewStyleProvider, // d4818465
   Runnable, // 594dd93a
   Runnables, // 4367c557
-  SafeAreaView, // a7cd92bb
+  SafeAreaView, // cb3671f3
   ScaledSize, // 07e417c7
-  ScrollEvent, // 5d529218
-  ScrollResponderType, // 197f0107
+  ScrollEvent, // 759fc8e1
+  ScrollResponderType, // 316d87b4
   ScrollToLocationParamsType, // d7ecdad1
-  ScrollView, // 938178e6
-  ScrollViewImperativeMethods, // 27f6b917
-  ScrollViewProps, // d5d9f043
+  ScrollView, // 1051f16e
+  ScrollViewImperativeMethods, // c8dcbb4a
+  ScrollViewProps, // 3b182fce
   ScrollViewPropsAndroid, // 44210553
-  ScrollViewPropsIOS, // b34b696c
+  ScrollViewPropsIOS, // 60c9a301
   ScrollViewScrollToOptions, // 3313411e
   SectionBase, // b376bddc
-  SectionList, // 6b202d76
+  SectionList, // 7f74e8c2
   SectionListData, // 119baf83
-  SectionListProps, // 6bdbf0ef
+  SectionListProps, // f38d74b2
   SectionListRenderItem, // 1fad0435
   SectionListRenderItemInfo, // 745e1992
   Separators, // 6a45f7e3
@@ -6221,66 +6215,66 @@ export {
   StyleProp, // fa0e9b4a
   StyleSheet, // e77dd046
   SubmitBehavior, // c4ddf490
-  Switch, // 015be3f7
-  SwitchChangeEvent, // 63e9c50b
-  SwitchProps, // 0dbf23ea
+  Switch, // 51333910
+  SwitchChangeEvent, // 8634990d
+  SwitchProps, // 73fbe487
   Systrace, // 626d178c
   TVViewPropsIOS, // 330ce7b5
   TargetedEvent, // 16e98910
   TaskProvider, // 266dedf2
-  Text, // 608149e8
+  Text, // 1e6955ef
   TextContentType, // 239b3ecc
-  TextInput, // 3b7016bb
+  TextInput, // 1962fa97
   TextInputAndroidProps, // 3f09ce49
-  TextInputChangeEvent, // 3ab11bb4
-  TextInputContentSizeChangeEvent, // f71f8571
-  TextInputEndEditingEvent, // e5f70633
-  TextInputFocusEvent, // 020507e6
+  TextInputChangeEvent, // 9e0264a8
+  TextInputContentSizeChangeEvent, // c0485b00
+  TextInputEndEditingEvent, // 5bab0db2
+  TextInputFocusEvent, // acd57d4f
   TextInputIOSProps, // 0d05a855
-  TextInputKeyPressEvent, // 3924ad9b
-  TextInputProps, // 96c07405
-  TextInputSelectionChangeEvent, // d4d10630
-  TextInputSubmitEditingEvent, // 22885c31
-  TextLayoutEvent, // 73ab173e
-  TextProps, // 4c29419c
+  TextInputKeyPressEvent, // 3e9cd7e9
+  TextInputProps, // 719dad29
+  TextInputSelectionChangeEvent, // f4aee983
+  TextInputSubmitEditingEvent, // 69f5aed4
+  TextLayoutEvent, // 44ce8450
+  TextProps, // c5c6ea95
   TextStyle, // bb9b7a58
   ToastAndroid, // 88a8969a
-  Touchable, // da3239ee
-  TouchableHighlight, // 49bbefe7
-  TouchableHighlightProps, // f14a1131
-  TouchableNativeFeedback, // d89b59a8
-  TouchableNativeFeedbackProps, // a88ade2e
-  TouchableOpacity, // 8d1b023b
-  TouchableOpacityProps, // 908e84b9
-  TouchableWithoutFeedback, // 71d446ec
-  TouchableWithoutFeedbackProps, // e0c1c566
+  Touchable, // 761abfef
+  TouchableHighlight, // c83e68c2
+  TouchableHighlightProps, // e1dcb561
+  TouchableNativeFeedback, // 44c0e01f
+  TouchableNativeFeedbackProps, // 3b815822
+  TouchableOpacity, // 2047870f
+  TouchableOpacityProps, // e24c059e
+  TouchableWithoutFeedback, // 989607ab
+  TouchableWithoutFeedbackProps, // d6aa3eec
   TransformsStyle, // 65e70f18
   TurboModule, // dfe29706
   TurboModuleRegistry, // 4ace6db2
   UIManager, // a1a7cc01
   UTFSequence, // ad625158
   Vibration, // 31e4bbf8
-  View, // 234d8db5
-  ViewProps, // 6d644e8b
-  ViewPropsAndroid, // ac650c5c
+  View, // d70ecdb5
+  ViewProps, // ee6b9e68
+  ViewPropsAndroid, // 5f51df6e
   ViewPropsIOS, // 58ee19bf
   ViewStyle, // 00a0f8fb
   VirtualViewMode, // 6be59722
   VirtualizedList, // 68c7345e
-  VirtualizedListProps, // 9453ce86
+  VirtualizedListProps, // 037e96db
   VirtualizedSectionList, // 9fd9cd61
-  VirtualizedSectionListProps, // 7a993da5
+  VirtualizedSectionListProps, // 6d45e684
   WrapperComponentProvider, // 9cf3844c
   codegenNativeCommands, // 628a7c0a
-  codegenNativeComponent, // 2baac257
+  codegenNativeComponent, // 2121cbfd
   findNodeHandle, // 93f80214
   processColor, // 6e877698
   registerCallableModule, // 839c8cfe
-  requireNativeComponent, // 7f7f105a
+  requireNativeComponent, // 319187c5
   useAnimatedColor, // e3511f81
   useAnimatedValue, // b18adb63
   useAnimatedValueXY, // c7ee2332
   useColorScheme, // d585efdb
-  usePressability, // b4e21b46
+  usePressability, // 60593cad
   useWindowDimensions, // bb4b683f
 }

packages/react-native/src/private/webapis/dom/nodes/ReactNativeElement.js

@@ -67,6 +67,7 @@ const noop = () => {};
 // was slower than this method because the engine has to create an object than
 // we then discard to create a new one.
 
+/** @build-types omit-constructor */
 class ReactNativeElement extends ReadOnlyElement implements NativeMethods {
   // These need to be accessible from `ReactFabricPublicInstanceUtils`.
   __nativeTag: number;