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<<e611913bdbeb40cc0b2c4fd5b78b0aef>>
  *
  * 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, // cd397533
+  AccessibilityInfo, // 294aa95c
   AccessibilityProps, // 5a2836fc
   AccessibilityRole, // f2f2e066
   AccessibilityState, // b0c2b3f7
   AccessibilityValue, // cf8bcb74
   ActionSheetIOS, // b558559e
   ActionSheetIOSOptions, // 1756eb5a
-  ActivityIndicator, // f06b0687
-  ActivityIndicatorProps, // 5e976856
+  ActivityIndicator, // fea7955e
+  ActivityIndicatorProps, // d33f5896
   Alert, // 5bf12165
   AlertButton, // bf1a3b60
   AlertButtonStyle, // ec9fb242
   AlertOptions, // a0cdac0f
   AlertType, // 5ab91217
   AndroidKeyboardEvent, // e03becc8
-  Animated, // 1a47480c
+  Animated, // ee418763
   AppConfig, // ce4209a7
   AppRegistry, // 5edf0524
   AppState, // 12012be5
@@ -6018,12 +6012,12 @@ export {
   AutoCapitalize, // c0e857a0
   BackHandler, // f139fc69
   BackPressEventName, // 4620fb76
-  BlurEvent, // e6151a1f
+  BlurEvent, // acda2fa7
   BoxShadowValue, // b679703f
-  Button, // 869e5a89
-  ButtonProps, // 349967e6
+  Button, // 4a37f7a6
+  ButtonProps, // 2f6276ab
   Clipboard, // 41addb89
-  CodegenTypes, // 0b8108a8
+  CodegenTypes, // 274af496
   ColorSchemeName, // 6615edd6
   ColorValue, // 98989a8f
   ComponentProvider, // b5c60ddd
@@ -6039,9 +6033,9 @@ export {
   DimensionsPayload, // 653bc26c
   DisplayMetrics, // 1dc35cef
   DisplayMetricsAndroid, // 872e62eb
-  DrawerLayoutAndroid, // eb4bcfa5
-  DrawerLayoutAndroidProps, // 1ddb208e
-  DrawerSlideEvent, // 0256d35a
+  DrawerLayoutAndroid, // 495e19fe
+  DrawerLayoutAndroidProps, // bbf9a4a6
+  DrawerSlideEvent, // ac9c5873
   DropShadowValue, // e9df2606
   DynamicColorIOS, // d96c228c
   DynamicColorIOSTuple, // 023ce58e
@@ -6055,29 +6049,29 @@ export {
   EventSubscription, // b8d084aa
   ExtendedExceptionData, // 5a6ccf5a
   FilterFunction, // bf24c0e3
-  FlatList, // e47faa4e
-  FlatListProps, // 22cacca0
-  FocusEvent, // 62fc1eb8
+  FlatList, // 6c8e0cd3
+  FlatListProps, // b89e1a36
+  FocusEvent, // 2f5267a2
   FontVariant, // 7c7558bb
-  GestureResponderEvent, // f693e9a5
-  GestureResponderHandlers, // cc70e4cb
+  GestureResponderEvent, // 6d2adc14
+  GestureResponderHandlers, // d4c6b431
   Handle, // 2d65285d
-  HostComponent, // 16fccab5
-  HostInstance, // 9b5a9ec2
+  HostComponent, // 8417c81a
+  HostInstance, // e8743de6
   I18nManager, // f9870e00
   IEventEmitter, // fbef6131
   IOSKeyboardEvent, // e67bfe3a
   IgnorePattern, // ec6f6ece
-  Image, // 1891541a
-  ImageBackground, // cf95f60b
-  ImageBackgroundProps, // c68c896d
-  ImageErrorEvent, // d3ee606e
-  ImageLoadEvent, // 6b547ea5
-  ImageProgressEventIOS, // 4c866a82
-  ImageProps, // 801d1e1c
+  Image, // cc4d5771
+  ImageBackground, // 71510b97
+  ImageBackgroundProps, // 9469cca5
+  ImageErrorEvent, // cc4ec63f
+  ImageLoadEvent, // e4ab897f
+  ImageProgressEventIOS, // 1b3108ea
+  ImageProps, // 9d07ff3e
   ImagePropsAndroid, // 9fd9bcbb
-  ImagePropsBase, // 372b652b
-  ImagePropsIOS, // c4ae0c06
+  ImagePropsBase, // 820c59ac
+  ImagePropsIOS, // e257195a
   ImageRequireSource, // 681d683b
   ImageResolvedAssetSource, // f3060931
   ImageSize, // 1c47cf88
@@ -6090,12 +6084,12 @@ export {
   InputModeOptions, // 4e8581b9
   Insets, // e7fe432a
   InteractionManager, // c324d6e3
-  KeyDownEvent, // d4971b72
+  KeyDownEvent, // d43982a0
   KeyEvent, // 20fa4267
-  KeyUpEvent, // bc6bd87b
+  KeyUpEvent, // 6e88850c
   Keyboard, // 49414c97
-  KeyboardAvoidingView, // c8c29c8d
-  KeyboardAvoidingViewProps, // 4114f649
+  KeyboardAvoidingView, // 91bfca69
+  KeyboardAvoidingViewProps, // a57c4e92
   KeyboardEvent, // c3f895d4
   KeyboardEventEasing, // af4091c8
   KeyboardEventName, // 59299ad6
@@ -6108,7 +6102,7 @@ export {
   LayoutAnimationProperty, // 52995f01
   LayoutAnimationType, // 2da0a29b
   LayoutAnimationTypes, // 081b3bde
-  LayoutChangeEvent, // c388ba2b
+  LayoutChangeEvent, // 07f31e40
   LayoutConformanceProps, // 055f03b8
   LayoutRectangle, // 6601b294
   Linking, // 9a6a174d
@@ -6120,34 +6114,34 @@ export {
   MeasureInWindowOnSuccessCallback, // a285f598
   MeasureLayoutOnSuccessCallback, // 3592502a
   MeasureOnSuccessCallback, // 82824e59
-  Modal, // bdd9bb3f
-  ModalBaseProps, // 3cca97dc
-  ModalProps, // aa4211df
+  Modal, // e38bb16e
+  ModalBaseProps, // e6d20773
+  ModalProps, // 6d7ce288
   ModalPropsAndroid, // 515fb173
-  ModalPropsIOS, // 144bbc95
-  ModeChangeEvent, // a5e9864f
-  MouseEvent, // fdce82bc
+  ModalPropsIOS, // 92c587ca
+  ModeChangeEvent, // cebaf08b
+  MouseEvent, // 8b172a2b
   NativeAppEventEmitter, // 08d4c47d
   NativeColorValue, // d2094c29
-  NativeComponentRegistry, // 21481a60
+  NativeComponentRegistry, // 7d971085
   NativeDialogManagerAndroid, // 5be8497e
   NativeEventEmitter, // 27f97c1a
   NativeEventSubscription, // de3942e7
-  NativeMethods, // a2311987
-  NativeMethodsMixin, // a819ef55
+  NativeMethods, // 2aa4f8dc
+  NativeMethodsMixin, // 4570b7e0
   NativeModules, // 4597cd36
-  NativeMouseEvent, // 558d45b0
-  NativePointerEvent, // f1763d80
+  NativeMouseEvent, // 34766845
+  NativePointerEvent, // 2acc483a
   NativeScrollEvent, // caad7f53
-  NativeSyntheticEvent, // 35855c4c
+  NativeSyntheticEvent, // 21ba7467
   NativeTouchEvent, // 59b676df
   NativeUIEvent, // 44ac26ac
   Networking, // bbc5be42
   OpaqueColorValue, // 25f3fa5b
-  PanResponder, // 4320c1ba
-  PanResponderCallbacks, // ed54b109
+  PanResponder, // 33ea3f08
+  PanResponderCallbacks, // c53efe18
   PanResponderGestureState, // 54baf558
-  PanResponderInstance, // 46b4629d
+  PanResponderInstance, // 5faad091
   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, // 7ebff673
+  PressabilityConfig, // 75dfc97f
+  PressabilityEventHandlers, // 0ae1e3bd
+  Pressable, // 38856d22
   PressableAndroidRippleConfig, // ee32eaca
-  PressableProps, // a9048420
+  PressableProps, // ee168252
   PressableStateCallbackType, // 9af36561
   ProcessedColorValue, // 33f74304
-  ProgressBarAndroid, // 00fcd180
-  ProgressBarAndroidProps, // f59f8f03
+  ProgressBarAndroid, // 74634782
+  ProgressBarAndroidProps, // 1118c5ba
   PromiseTask, // 5102c862
   PublicRootInstance, // 8040afd7
-  PublicTextInstance, // cd0d8f8d
+  PublicTextInstance, // c35f1c78
   PushNotificationEventName, // 84e7e150
   PushNotificationIOS, // b4d1fe78
   PushNotificationPermissions, // c2e7ae4f
   Rationale, // 5df1b1c1
   ReactNativeVersion, // abd76827
-  RefreshControl, // ed67a3b2
-  RefreshControlProps, // bfc35644
+  RefreshControl, // 4ad4cabb
+  RefreshControlProps, // fa64b7b5
   RefreshControlPropsAndroid, // 99f64c97
   RefreshControlPropsIOS, // 72a36381
   Registry, // 6c39216d
-  ResponderSyntheticEvent, // fb10247c
+  ResponderSyntheticEvent, // 97b818a2
   ReturnKeyTypeOptions, // afd47ba3
   Role, // af7b889d
   RootTag, // 3cd10504
   RootTagContext, // 38bfc8f6
   RootViewStyleProvider, // d4818465
   Runnable, // 594dd93a
   Runnables, // 4367c557
-  SafeAreaView, // a7cd92bb
+  SafeAreaView, // a6a09f08
   ScaledSize, // 07e417c7
-  ScrollEvent, // 5d529218
-  ScrollResponderType, // 197f0107
+  ScrollEvent, // 5d4c42ac
+  ScrollResponderType, // ac611309
   ScrollToLocationParamsType, // d7ecdad1
-  ScrollView, // 938178e6
-  ScrollViewImperativeMethods, // 27f6b917
-  ScrollViewProps, // d5d9f043
+  ScrollView, // 7004df06
+  ScrollViewImperativeMethods, // 4aae6e61
+  ScrollViewProps, // 579d84f3
   ScrollViewPropsAndroid, // 44210553
-  ScrollViewPropsIOS, // b34b696c
+  ScrollViewPropsIOS, // b45f8013
   ScrollViewScrollToOptions, // 3313411e
   SectionBase, // b376bddc
-  SectionList, // 6b202d76
+  SectionList, // 9b9a8b6e
   SectionListData, // 119baf83
-  SectionListProps, // 6bdbf0ef
+  SectionListProps, // 4210e506
   SectionListRenderItem, // 1fad0435
   SectionListRenderItemInfo, // 745e1992
   Separators, // 6a45f7e3
@@ -6221,66 +6215,66 @@ export {
   StyleProp, // fa0e9b4a
   StyleSheet, // e77dd046
   SubmitBehavior, // c4ddf490
-  Switch, // 015be3f7
-  SwitchChangeEvent, // 63e9c50b
-  SwitchProps, // 0dbf23ea
+  Switch, // 8a5dd325
+  SwitchChangeEvent, // 29e36f52
+  SwitchProps, // 9381f89d
   Systrace, // 626d178c
   TVViewPropsIOS, // 330ce7b5
   TargetedEvent, // 16e98910
   TaskProvider, // 266dedf2
-  Text, // 608149e8
+  Text, // 8b2957a7
   TextContentType, // 239b3ecc
-  TextInput, // 3b7016bb
+  TextInput, // 0b608e71
   TextInputAndroidProps, // 3f09ce49
-  TextInputChangeEvent, // 3ab11bb4
-  TextInputContentSizeChangeEvent, // f71f8571
-  TextInputEndEditingEvent, // e5f70633
-  TextInputFocusEvent, // 020507e6
+  TextInputChangeEvent, // 8ebeab3b
+  TextInputContentSizeChangeEvent, // 95a066bb
+  TextInputEndEditingEvent, // 3680ccf4
+  TextInputFocusEvent, // 45c2aa74
   TextInputIOSProps, // 0d05a855
-  TextInputKeyPressEvent, // 3924ad9b
-  TextInputProps, // 96c07405
-  TextInputSelectionChangeEvent, // d4d10630
-  TextInputSubmitEditingEvent, // 22885c31
-  TextLayoutEvent, // 73ab173e
-  TextProps, // 4c29419c
+  TextInputKeyPressEvent, // c986943c
+  TextInputProps, // 8f74364f
+  TextInputSelectionChangeEvent, // 5f7906d5
+  TextInputSubmitEditingEvent, // e833130c
+  TextLayoutEvent, // 57140552
+  TextProps, // 7e9abf8b
   TextStyle, // bb9b7a58
   ToastAndroid, // 88a8969a
-  Touchable, // da3239ee
-  TouchableHighlight, // 49bbefe7
-  TouchableHighlightProps, // f14a1131
-  TouchableNativeFeedback, // d89b59a8
-  TouchableNativeFeedbackProps, // a88ade2e
-  TouchableOpacity, // 8d1b023b
-  TouchableOpacityProps, // 908e84b9
-  TouchableWithoutFeedback, // 71d446ec
-  TouchableWithoutFeedbackProps, // e0c1c566
+  Touchable, // 4aa582e2
+  TouchableHighlight, // 90d5cc9b
+  TouchableHighlightProps, // f673f0fa
+  TouchableNativeFeedback, // c900c4a5
+  TouchableNativeFeedbackProps, // 628d8b62
+  TouchableOpacity, // 9ea86e83
+  TouchableOpacityProps, // 5bfb00bf
+  TouchableWithoutFeedback, // 0809b337
+  TouchableWithoutFeedbackProps, // a66fa1d6
   TransformsStyle, // 65e70f18
   TurboModule, // dfe29706
   TurboModuleRegistry, // 4ace6db2
   UIManager, // a1a7cc01
   UTFSequence, // ad625158
   Vibration, // 31e4bbf8
-  View, // 234d8db5
-  ViewProps, // 6d644e8b
-  ViewPropsAndroid, // ac650c5c
+  View, // 8af5b18a
+  ViewProps, // 7ebf88bb
+  ViewPropsAndroid, // e377ec69
   ViewPropsIOS, // 58ee19bf
   ViewStyle, // 00a0f8fb
   VirtualViewMode, // 6be59722
   VirtualizedList, // 68c7345e
-  VirtualizedListProps, // 9453ce86
+  VirtualizedListProps, // 9487c00e
   VirtualizedSectionList, // 9fd9cd61
-  VirtualizedSectionListProps, // 7a993da5
+  VirtualizedSectionListProps, // d88c2af1
   WrapperComponentProvider, // 9cf3844c
   codegenNativeCommands, // 628a7c0a
-  codegenNativeComponent, // 2baac257
+  codegenNativeComponent, // ffaf8efe
   findNodeHandle, // 93f80214
   processColor, // 6e877698
   registerCallableModule, // 839c8cfe
-  requireNativeComponent, // 7f7f105a
+  requireNativeComponent, // 84ae9e06
   useAnimatedColor, // e3511f81
   useAnimatedValue, // b18adb63
   useAnimatedValueXY, // c7ee2332
   useColorScheme, // d585efdb
-  usePressability, // b4e21b46
+  usePressability, // d6ab8469
   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;