react-native-windows 0.78.6 → 0.79.0-preview.1

package/Libraries/Pressability/Pressability.windows.js

@@ -8,12 +8,12 @@
  * @format
  */
 
-import type {HostInstance} from '../Renderer/shims/ReactNativeTypes';
+import type {HostInstance} from '../../src/private/types/HostInstance';
 import type {
   BlurEvent,
   FocusEvent,
+  GestureResponderEvent,
   MouseEvent,
-  PressEvent,
   KeyEvent, // [Windows]
 } from '../Types/CoreEventTypes';
 
@@ -28,7 +28,7 @@ import PressabilityPerformanceEventEmitter from './PressabilityPerformanceEventE
 import {type PressabilityTouchSignal as TouchSignal} from './PressabilityTypes.js';
 import invariant from 'invariant';
 
-export type PressabilityConfig = $ReadOnly<{|
+export type PressabilityConfig = $ReadOnly<{
   /**
    * Whether a press gesture can be interrupted by a parent gesture such as a
    * scroll event. Defaults to true.
@@ -119,27 +119,27 @@ export type PressabilityConfig = $ReadOnly<{|
   /**
    * Called when a long press gesture has been triggered.
    */
-  onLongPress?: ?(event: PressEvent) => mixed,
+  onLongPress?: ?(event: GestureResponderEvent) => mixed,
 
   /**
    * Called when a press gesture has been triggered.
    */
-  onPress?: ?(event: PressEvent) => mixed,
+  onPress?: ?(event: GestureResponderEvent) => mixed,
 
   /**
    * Called when the press is activated to provide visual feedback.
    */
-  onPressIn?: ?(event: PressEvent) => mixed,
+  onPressIn?: ?(event: GestureResponderEvent) => mixed,
 
   /**
    * Called when the press location moves. (This should rarely be used.)
    */
-  onPressMove?: ?(event: PressEvent) => mixed,
+  onPressMove?: ?(event: GestureResponderEvent) => mixed,
 
   /**
    * Called when the press is deactivated to undo visual feedback.
    */
-  onPressOut?: ?(event: PressEvent) => mixed,
+  onPressOut?: ?(event: GestureResponderEvent) => mixed,
 
   /**
    * Whether to prevent any other native components from becoming responder
@@ -162,27 +162,27 @@ export type PressabilityConfig = $ReadOnly<{|
    */
   onMouseLeave?: ?(event: MouseEvent) => mixed,
   // Windows]
-|}>;
+}>;
 
-export type EventHandlers = $ReadOnly<{|
+export type EventHandlers = $ReadOnly<{
   onBlur: (event: BlurEvent) => void,
-  onClick: (event: PressEvent) => void,
+  onClick: (event: GestureResponderEvent) => void,
   onFocus: (event: FocusEvent) => void,
   onMouseEnter?: (event: MouseEvent) => void,
   onMouseLeave?: (event: MouseEvent) => void,
   onPointerEnter?: (event: PointerEvent) => void,
   onPointerLeave?: (event: PointerEvent) => void,
-  onResponderGrant: (event: PressEvent) => void | boolean,
-  onResponderMove: (event: PressEvent) => void,
-  onResponderRelease: (event: PressEvent) => void,
-  onResponderTerminate: (event: PressEvent) => void,
+  onResponderGrant: (event: GestureResponderEvent) => void | boolean,
+  onResponderMove: (event: GestureResponderEvent) => void,
+  onResponderRelease: (event: GestureResponderEvent) => void,
+  onResponderTerminate: (event: GestureResponderEvent) => void,
   onResponderTerminationRequest: () => boolean,
   onStartShouldSetResponder: () => boolean,
   // [Windows
   onKeyUp: (event: KeyEvent) => void,
   onKeyDown: (event: KeyEvent) => void,
   // Windows]
-|}>;
+}>;
 
 type TouchState =
   | 'NOT_RESPONDER'
@@ -409,16 +409,16 @@ export default class Pressability {
   _pressDelayTimeout: ?TimeoutID = null;
   _pressOutDelayTimeout: ?TimeoutID = null;
   _responderID: ?number | HostInstance = null;
-  _responderRegion: ?$ReadOnly<{|
+  _responderRegion: ?$ReadOnly<{
     bottom: number,
     left: number,
     right: number,
     top: number,
-  |}> = null;
-  _touchActivatePosition: ?$ReadOnly<{|
+  }> = null;
+  _touchActivatePosition: ?$ReadOnly<{
     pageX: number,
     pageY: number,
-  |}>;
+  }>;
   _touchActivateTime: ?number;
   _touchState: TouchState = 'NOT_RESPONDER';
   _isKeyDown: boolean = false;
@@ -483,7 +483,7 @@ export default class Pressability {
         return !disabled ?? true;
       },
 
-      onResponderGrant: (event: PressEvent): void | boolean => {
+      onResponderGrant: (event: GestureResponderEvent): void | boolean => {
         event.persist();
 
         this._cancelPressOutDelayTimeout();
@@ -513,7 +513,7 @@ export default class Pressability {
         return this._config.blockNativeResponder === true;
       },
 
-      onResponderMove: (event: PressEvent): void => {
+      onResponderMove: (event: GestureResponderEvent): void => {
         const {onPressMove} = this._config;
         if (onPressMove != null) {
           onPressMove(event);
@@ -548,11 +548,11 @@ export default class Pressability {
         }
       },
 
-      onResponderRelease: (event: PressEvent): void => {
+      onResponderRelease: (event: GestureResponderEvent): void => {
         this._receiveSignal('RESPONDER_RELEASE', event);
       },
 
-      onResponderTerminate: (event: PressEvent): void => {
+      onResponderTerminate: (event: GestureResponderEvent): void => {
         this._receiveSignal('RESPONDER_TERMINATED', event);
       },
 
@@ -561,7 +561,7 @@ export default class Pressability {
         return cancelable ?? true;
       },
 
-      onClick: (event: PressEvent): void => {
+      onClick: (event: GestureResponderEvent): void => {
         // If event has `pointerType`, it was emitted from a PointerEvent and
         // we should ignore it to avoid triggering `onPress` twice.
         if (event?.nativeEvent?.hasOwnProperty?.('pointerType')) {
@@ -754,7 +754,7 @@ export default class Pressability {
    * Receives a state machine signal, performs side effects of the transition
    * and stores the new state. Validates the transition as well.
    */
-  _receiveSignal(signal: TouchSignal, event: PressEvent): void {
+  _receiveSignal(signal: TouchSignal, event: GestureResponderEvent): void {
     // Especially on iOS, not all events have timestamps associated.
     // For telemetry purposes, this doesn't matter too much, as long as *some* do.
     // Since the native timestamp is integral for logging telemetry, just skip
@@ -802,7 +802,7 @@ export default class Pressability {
     prevState: TouchState,
     nextState: TouchState,
     signal: TouchSignal,
-    event: PressEvent,
+    event: GestureResponderEvent,
   ): void {
     if (isTerminalSignal(signal)) {
       this._touchActivatePosition = null;
@@ -865,7 +865,7 @@ export default class Pressability {
     this._cancelPressDelayTimeout();
   }
 
-  _activate(event: PressEvent): void {
+  _activate(event: GestureResponderEvent): void {
     const {onPressIn} = this._config;
     const {pageX, pageY, button} = getTouchFromPressEvent(event);
     this._touchActivatePosition = {pageX, pageY};
@@ -875,7 +875,7 @@ export default class Pressability {
     }
   }
 
-  _deactivate(event: PressEvent): void {
+  _deactivate(event: GestureResponderEvent): void {
     const {onPressOut} = this._config;
     if (
       onPressOut != null &&
@@ -935,13 +935,13 @@ export default class Pressability {
   };
 
   _isTouchWithinResponderRegion(
-    touch: $PropertyType<PressEvent, 'nativeEvent'>,
-    responderRegion: $ReadOnly<{|
+    touch: $PropertyType<GestureResponderEvent, 'nativeEvent'>,
+    responderRegion: $ReadOnly<{
       bottom: number,
       left: number,
       right: number,
       top: number,
-    |}>,
+    }>,
   ): boolean {
     const hitSlop = normalizeRect(this._config.hitSlop);
     const pressRectOffset = normalizeRect(this._config.pressRectOffset);
@@ -980,7 +980,7 @@ export default class Pressability {
     );
   }
 
-  _handleLongPress(event: PressEvent): void {
+  _handleLongPress(event: GestureResponderEvent): void {
     if (
       this._touchState === 'RESPONDER_ACTIVE_PRESS_IN' ||
       this._touchState === 'RESPONDER_ACTIVE_LONG_PRESS_IN'
@@ -1033,7 +1033,7 @@ function normalizeDelay(
   return Math.max(min, delay ?? fallback);
 }
 
-const getTouchFromPressEvent = (event: PressEvent) => {
+const getTouchFromPressEvent = (event: GestureResponderEvent) => {
   const {changedTouches, touches} = event.nativeEvent;
 
   if (touches != null && touches.length > 0) {

package/Libraries/Pressability/PressabilityDebug.js

@@ -15,10 +15,10 @@ import normalizeColor from '../StyleSheet/normalizeColor';
 import {type RectOrSize, normalizeRect} from '../StyleSheet/Rect';
 import * as React from 'react';
 
-type Props = $ReadOnly<{|
+type Props = $ReadOnly<{
   color: ColorValue,
   hitSlop: ?RectOrSize,
-|}>;
+}>;
 
 /**
  * Displays a debug overlay to visualize press targets when enabled via the

package/Libraries/Pressability/PressabilityPerformanceEventEmitter.js

@@ -10,10 +10,10 @@
 
 import {type PressabilityTouchSignal as TouchSignal} from './PressabilityTypes.js';
 
-export type PressabilityPerformanceEvent = $ReadOnly<{|
+export type PressabilityPerformanceEvent = $ReadOnly<{
   signal: TouchSignal,
   nativeTimestamp: number,
-|}>;
+}>;
 export type PressabilityPerformanceEventListener =
   PressabilityPerformanceEvent => void;
 

package/Libraries/Promise.js

@@ -10,7 +10,7 @@
 
 'use strict';
 
-const Promise = require('promise/setimmediate/es6-extensions');
+import Promise from 'promise/setimmediate/es6-extensions';
 
 require('promise/setimmediate/finally');
 
@@ -20,4 +20,4 @@ if (__DEV__) {
   );
 }
 
-module.exports = Promise;
+export default Promise;

package/Libraries/PushNotificationIOS/NativePushNotificationManagerIOS.js

@@ -8,6 +8,6 @@
  * @format
  */
 
-export * from '../../src/private/specs/modules/NativePushNotificationManagerIOS';
-import NativePushNotificationManagerIOS from '../../src/private/specs/modules/NativePushNotificationManagerIOS';
+export * from '../../src/private/specs_DEPRECATED/modules/NativePushNotificationManagerIOS';
+import NativePushNotificationManagerIOS from '../../src/private/specs_DEPRECATED/modules/NativePushNotificationManagerIOS';
 export default NativePushNotificationManagerIOS;

package/Libraries/PushNotificationIOS/PushNotificationIOS.js

@@ -15,6 +15,30 @@ import Platform from '../Utilities/Platform';
 import NativePushNotificationManagerIOS from './NativePushNotificationManagerIOS';
 import invariant from 'invariant';
 
+export type PushNotificationPermissions = {
+  alert: boolean,
+  badge: boolean,
+  sound: boolean,
+  [key: string]: boolean | number,
+};
+
+type PresentLocalNotificationDetails = {
+  alertBody: string,
+  alertAction?: string,
+  alertTitle?: string,
+  soundName?: string,
+  category?: string,
+  userInfo?: Object,
+  applicationIconBadgeNumber?: number,
+  fireDate?: number,
+  isSilent?: boolean,
+};
+
+type ScheduleLocalNotificationDetails = {
+  ...PresentLocalNotificationDetails,
+  repeatInterval?: 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute',
+};
+
 type NativePushNotificationIOSEventDefinitions = {
   remoteNotificationReceived: [
     {
@@ -56,9 +80,9 @@ const DEVICE_LOCAL_NOTIF_EVENT = 'localNotificationReceived';
 export type ContentAvailable = 1 | null | void;
 
 export type FetchResult = {
-  NewData: string,
-  NoData: string,
-  ResultFailed: string,
+  NewData: 'UIBackgroundFetchResultNewData',
+  NoData: 'UIBackgroundFetchResultNoData',
+  ResultFailed: 'UIBackgroundFetchResultFailed',
   ...
 };
 
@@ -94,6 +118,54 @@ export type PushNotificationEventName = $Keys<{
   ...
 }>;
 
+export interface PushNotification {
+  /**
+   * An alias for `getAlert` to get the notification's main message string
+   */
+  getMessage(): ?string | ?Object;
+
+  /**
+   * Gets the sound string from the `aps` object
+   */
+  getSound(): ?string;
+
+  /**
+   * Gets the category string from the `aps` object
+   */
+  getCategory(): ?string;
+
+  /**
+   * Gets the notification's main message from the `aps` object
+   */
+  getAlert(): ?string | ?Object;
+
+  /**
+   * Gets the content-available number from the `aps` object
+   */
+  getContentAvailable(): ContentAvailable;
+
+  /**
+   * Gets the badge count number from the `aps` object
+   */
+  getBadgeCount(): ?number;
+
+  /**
+   * Gets the data object on the notif
+   */
+  getData(): ?Object;
+
+  /**
+   * Gets the thread ID on the notif
+   */
+  getThreadID(): ?string;
+
+  /**
+   * iOS Only
+   * Signifies remote notification handling is complete
+   */
+  finish(result: string): void;
+}
+
 /**
  *
  * Handle notifications for your app, including scheduling and permissions.
@@ -119,28 +191,50 @@ class PushNotificationIOS {
   };
 
   /**
-   * Schedules a local notification for immediate presentation.
+   * Schedules the localNotification for immediate presentation.
+   * details is an object containing:
+   * alertBody : The message displayed in the notification alert.
+   * alertAction : The "action" displayed beneath an actionable notification. Defaults to "view";
+   * soundName : The sound played when the notification is fired (optional).
+   * category : The category of this notification, required for actionable notifications (optional).
+   * userInfo : An optional object containing additional notification data.
+   * applicationIconBadgeNumber (optional) : The number to display as the app's icon badge. The default value of this property is 0, which means that no badge is displayed.
    *
    * See https://reactnative.dev/docs/pushnotificationios#presentlocalnotification
    */
-  static presentLocalNotification(details: Object): void {
+  static presentLocalNotification(
+    details: PresentLocalNotificationDetails,
+  ): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
     );
+    // $FlowFixMe[prop-missing]
     NativePushNotificationManagerIOS.presentLocalNotification(details);
   }
 
   /**
    * Schedules a local notification for future presentation.
    *
+   * details is an object containing:
+   * fireDate : The date and time when the system should deliver the notification.
+   * alertBody : The message displayed in the notification alert.
+   * alertAction : The "action" displayed beneath an actionable notification. Defaults to "view";
+   * soundName : The sound played when the notification is fired (optional).
+   * category : The category of this notification, required for actionable notifications (optional).
+   * userInfo : An optional object containing additional notification data.
+   * applicationIconBadgeNumber (optional) : The number to display as the app's icon badge. Setting the number to 0 removes the icon badge.
+   *
    * See https://reactnative.dev/docs/pushnotificationios#schedulelocalnotification
    */
-  static scheduleLocalNotification(details: Object): void {
+  static scheduleLocalNotification(
+    details: ScheduleLocalNotificationDetails,
+  ): void {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
     );
+    // $FlowFixMe[prop-missing]
     NativePushNotificationManagerIOS.scheduleLocalNotification(details);
   }
 
@@ -331,12 +425,9 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#requestpermissions
    */
-  static requestPermissions(permissions?: {
-    alert?: boolean,
-    badge?: boolean,
-    sound?: boolean,
-    ...
-  }): Promise<{
+  static requestPermissions(
+    permissions?: PushNotificationPermissions,
+  ): Promise<{
     alert: boolean,
     badge: boolean,
     sound: boolean,
@@ -365,7 +456,13 @@ class PushNotificationIOS {
 
   /**
    * Unregister for all remote notifications received via Apple Push Notification
-   * service. This should be called in rare circumstances only.
+   * service.
+   * You should call this method in rare circumstances only, such as when
+   * a new version of the app removes support for all types of remote
+   * notifications. Users can temporarily prevent apps from receiving
+   * remote notifications through the Notifications section of the
+   * Settings app. Apps unregistered through this method can always
+   * re-register.
    *
    * See https://reactnative.dev/docs/pushnotificationios#abandonpermissions
    */
@@ -381,9 +478,15 @@ class PushNotificationIOS {
    * Check which push permissions are currently enabled. `callback` will be
    * invoked with a `Permissions` object.
    *
+   *  - `alert` :boolean
+   *  - `badge` :boolean
+   *  - `sound` :boolean
+   *
    * See https://reactnative.dev/docs/pushnotificationios#checkpermissions
    */
-  static checkPermissions(callback: Function): void {
+  static checkPermissions(
+    callback: (permissions: PushNotificationPermissions) => void,
+  ): void {
     invariant(typeof callback === 'function', 'Must provide a valid callback');
     invariant(
       NativePushNotificationManagerIOS,
@@ -398,7 +501,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#getinitialnotification
    */
-  static getInitialNotification(): Promise<?PushNotificationIOS> {
+  static getInitialNotification(): Promise<?PushNotification> {
     invariant(
       NativePushNotificationManagerIOS,
       'PushNotificationManager is not available.',
@@ -566,4 +669,4 @@ class PushNotificationIOS {
   }
 }
 
-module.exports = PushNotificationIOS;
+export default PushNotificationIOS;

package/Libraries/ReactNative/AppContainer-dev.js

@@ -33,7 +33,8 @@ const reactDevToolsHook: ReactDevToolsGlobalHook =
 // Required for React DevTools to view / edit React Native styles in Flipper.
 // Flipper doesn't inject these values when initializing DevTools.
 if (reactDevToolsHook) {
-  reactDevToolsHook.resolveRNStyle = require('../StyleSheet/flattenStyle');
+  reactDevToolsHook.resolveRNStyle =
+    require('../StyleSheet/flattenStyle').default;
   reactDevToolsHook.nativeStyleEditorValidAttributes = Object.keys(
     ReactNativeStyleAttributes,
   );
@@ -52,7 +53,7 @@ const InspectorDeferred = ({
 }: InspectorDeferredProps) => {
   // D39382967 adds a require cycle: InitializeCore -> AppContainer -> Inspector -> InspectorPanel -> ScrollView -> InitializeCore
   // We can't remove it yet, fallback to dynamic require for now. This is the only reason why this logic is in a separate function.
-  const Inspector = require('../Inspector/Inspector');
+  const Inspector = require('../../src/private/inspector/Inspector').default;
 
   return (
     <Inspector
@@ -73,7 +74,7 @@ const ReactDevToolsOverlayDeferred = ({
   reactDevToolsAgent,
 }: ReactDevToolsOverlayDeferredProps) => {
   const ReactDevToolsOverlay =
-    require('../Inspector/ReactDevToolsOverlay').default;
+    require('../../src/private/inspector/ReactDevToolsOverlay').default;
 
   return (
     <ReactDevToolsOverlay

package/Libraries/ReactNative/AppContainer.js

@@ -13,7 +13,7 @@ import type {RootTag} from './RootTag';
 
 import * as React from 'react';
 
-export type Props = $ReadOnly<{|
+export type Props = $ReadOnly<{
   children?: React.Node,
   fabric?: boolean,
   rootTag: number | RootTag,
@@ -22,10 +22,10 @@ export type Props = $ReadOnly<{|
   rootViewStyle?: ?ViewStyleProp,
   internal_excludeLogBox?: boolean,
   internal_excludeInspector?: boolean,
-|}>;
+}>;
 
 const AppContainer: component(...Props) = __DEV__
   ? require('./AppContainer-dev').default
   : require('./AppContainer-prod').default;
 
-module.exports = AppContainer;
+export default AppContainer;

package/Libraries/ReactNative/AppRegistry.js

@@ -30,11 +30,11 @@ export type TaskProvider = () => Task;
 type TaskCanceller = () => void;
 type TaskCancelProvider = () => TaskCanceller;
 
-export type ComponentProvider = () => React$ComponentType<any>;
+export type ComponentProvider = () => React.ComponentType<any>;
 export type ComponentProviderInstrumentationHook = (
   component_: ComponentProvider,
   scopedPerformanceLogger: IPerformanceLogger,
-) => React$ComponentType<any>;
+) => React.ComponentType<any>;
 export type AppConfig = {
   appKey: string,
   component?: ComponentProvider,
@@ -59,7 +59,7 @@ export type Registry = {
 };
 export type WrapperComponentProvider = (
   appParameters: Object,
-) => React$ComponentType<any>;
+) => React.ComponentType<any>;
 export type RootViewStyleProvider = (appParameters: Object) => ViewStyleProp;
 
 const runnables: Runnables = {};
@@ -357,4 +357,4 @@ global.RN$SurfaceRegistry = {
 
 registerCallableModule('AppRegistry', AppRegistry);
 
-module.exports = AppRegistry;
+export default AppRegistry;

package/Libraries/ReactNative/BridgelessUIManager.js

@@ -182,14 +182,9 @@ const UIManagerJSPlatformAPIs = Platform.select({
       return [];
     },
     setLayoutAnimationEnabledExperimental: (enabled: boolean): void => {
-      /**
-       * Layout animations are always enabled in the New Architecture.
-       * They cannot be turned off.
-       */
-      if (!enabled) {
-        raiseSoftError(
-          'setLayoutAnimationEnabledExperimental(false)',
-          'Layout animations are always enabled in the New Architecture.',
+      if (__DEV__) {
+        console.warn(
+          'setLayoutAnimationEnabledExperimental is currently a no-op in the New Architecture.',
         );
       }
     },
@@ -416,4 +411,4 @@ if (getUIManagerConstants) {
   }
 }
 
-module.exports = UIManagerJS;
+export default UIManagerJS;

package/Libraries/ReactNative/FabricUIManager.js

@@ -4,18 +4,21 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @flow strict
+ * @flow strict-local
  * @format
  */
 
 'use strict';
 
 import type {
-  InternalInstanceHandle,
-  LayoutAnimationConfig,
   MeasureInWindowOnSuccessCallback,
   MeasureLayoutOnSuccessCallback,
   MeasureOnSuccessCallback,
+} from '../../src/private/types/HostInstance';
+import type {NativeElementReference} from '../../src/private/webapis/dom/nodes/specs/NativeDOM';
+import type {
+  InternalInstanceHandle,
+  LayoutAnimationConfig,
   Node,
 } from '../Renderer/shims/ReactNativeTypes';
 import type {RootTag} from '../Types/RootTagTypes';
@@ -40,14 +43,17 @@ export interface Spec {
   +appendChild: (parentNode: Node, child: Node) => Node;
   +appendChildToSet: (childSet: NodeSet, child: Node) => void;
   +completeRoot: (rootTag: RootTag, childSet: NodeSet) => void;
-  +measure: (node: Node, callback: MeasureOnSuccessCallback) => void;
+  +measure: (
+    node: Node | NativeElementReference,
+    callback: MeasureOnSuccessCallback,
+  ) => void;
   +measureInWindow: (
-    node: Node,
+    node: Node | NativeElementReference,
     callback: MeasureInWindowOnSuccessCallback,
   ) => void;
   +measureLayout: (
-    node: Node,
-    relativeNode: Node,
+    node: Node | NativeElementReference,
+    relativeNode: Node | NativeElementReference,
     onFail: () => void,
     onSuccess: MeasureLayoutOnSuccessCallback,
   ) => void;
@@ -58,7 +64,10 @@ export interface Spec {
   ) => void;
   +sendAccessibilityEvent: (node: Node, eventType: string) => void;
   +findShadowNodeByTag_DEPRECATED: (reactTag: number) => ?Node;
-  +setNativeProps: (node: Node, newProps: NodeProps) => void;
+  +setNativeProps: (
+    node: Node | NativeElementReference,
+    newProps: NodeProps,
+  ) => void;
   +dispatchCommand: (
     node: Node,
     commandName: string,
@@ -70,9 +79,12 @@ export interface Spec {
     locationY: number,
     callback: (instanceHandle: ?InternalInstanceHandle) => void,
   ) => void;
-  +compareDocumentPosition: (node: Node, otherNode: Node) => number;
+  +compareDocumentPosition: (
+    node: Node | NativeElementReference,
+    otherNode: Node | NativeElementReference,
+  ) => number;
   +getBoundingClientRect: (
-    node: Node,
+    node: Node | NativeElementReference,
     includeTransform: boolean,
   ) => ?[
     /* x: */ number,