react-native-windows 0.70.8 → 0.71.0-preview.1

package/Libraries/Utilities/BackHandler.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+import {NativeEventSubscription} from '../EventEmitter/RCTNativeAppEventEmitter';
+
+export type BackPressEventName = 'hardwareBackPress';
+
+/**
+ * Detect hardware back button presses, and programmatically invoke the
+ * default back button functionality to exit the app if there are no
+ * listeners or if none of the listeners return true.
+ * The event subscriptions are called in reverse order
+ * (i.e. last registered subscription first), and if one subscription
+ * returns true then subscriptions registered earlier
+ * will not be called.
+ *
+ * @see https://reactnative.dev/docs/backhandler
+ */
+export interface BackHandlerStatic {
+  exitApp(): void;
+  addEventListener(
+    eventName: BackPressEventName,
+    handler: () => boolean | null | undefined,
+  ): NativeEventSubscription;
+  removeEventListener(
+    eventName: BackPressEventName,
+    handler: () => boolean | null | undefined,
+  ): void;
+}
+
+export const BackHandler: BackHandlerStatic;
+export type BackHandler = BackHandlerStatic;

package/Libraries/Utilities/BackHandler.windows.js

@@ -97,11 +97,9 @@ const BackHandler: TBackHandler = {
     eventName: BackPressEventName,
     handler: () => ?boolean,
   ): void {
-    if (_backPressSubscriptions.indexOf(handler) !== -1) {
-      _backPressSubscriptions.splice(
-        _backPressSubscriptions.indexOf(handler),
-        1,
-      );
+    const index = _backPressSubscriptions.indexOf(handler);
+    if (index !== -1) {
+      _backPressSubscriptions.splice(index, 1);
     }
   },
 };

package/Libraries/Utilities/DevSettings.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+import {NativeEventEmitter} from '../EventEmitter/NativeEventEmitter';
+
+/**
+ * The DevSettings module exposes methods for customizing settings for developers in development.
+ */
+export interface DevSettingsStatic extends NativeEventEmitter {
+  /**
+   * Adds a custom menu item to the developer menu.
+   *
+   * @param title - The title of the menu item. Is internally used as id and should therefore be unique.
+   * @param handler - The callback invoked when pressing the menu item.
+   */
+  addMenuItem(title: string, handler: () => any): void;
+
+  /**
+   * Reload the application.
+   *
+   * @param reason
+   */
+  reload(reason?: string): void;
+}
+
+export const DevSettings: DevSettingsStatic;

package/Libraries/Utilities/DevSettings.js

@@ -8,8 +8,10 @@
  * @format
  */
 
-import NativeDevSettings from '../NativeModules/specs/NativeDevSettings';
+import type {EventSubscription} from '../vendor/emitter/EventEmitter';
+
 import NativeEventEmitter from '../EventEmitter/NativeEventEmitter';
+import NativeDevSettings from '../NativeModules/specs/NativeDevSettings';
 import Platform from '../Utilities/Platform';
 
 let DevSettings: {
@@ -32,7 +34,7 @@ if (__DEV__) {
     // If you want to use the native module on other platforms, please remove this condition and test its behavior
     Platform.OS !== 'ios' ? null : NativeDevSettings,
   );
-  const subscriptions = new Map();
+  const subscriptions = new Map<string, EventSubscription>();
 
   DevSettings = {
     addMenuItem(title: string, handler: () => mixed): void {

package/Libraries/Utilities/Dimensions.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+import {EmitterSubscription} from '../vendor/emitter/EventEmitter';
+
+// Used by Dimensions below
+export interface ScaledSize {
+  width: number;
+  height: number;
+  scale: number;
+  fontScale: number;
+}
+
+/**
+ * Initial dimensions are set before `runApplication` is called so they should
+ * be available before any other require's are run, but may be updated later.
+ *
+ * Note: Although dimensions are available immediately, they may change (e.g
+ * due to device rotation) so any rendering logic or styles that depend on
+ * these constants should try to call this function on every render, rather
+ * than caching the value (for example, using inline styles rather than
+ * setting a value in a `StyleSheet`).
+ *
+ * Example: `const {height, width} = Dimensions.get('window');`
+ *
+ * @param dim Name of dimension as defined when calling `set`.
+ * @returns Value for the dimension.
+ * @see https://reactnative.dev/docs/dimensions#content
+ */
+export interface Dimensions {
+  /**
+       * Initial dimensions are set before runApplication is called so they
+       * should be available before any other require's are run, but may be
+       * updated later.
+       * Note: Although dimensions are available immediately, they may
+       * change (e.g due to device rotation) so any rendering logic or
+       * styles that depend on these constants should try to call this
+       * function on every render, rather than caching the value (for
+       * example, using inline styles rather than setting a value in a
+       * StyleSheet).
+       * Example: const {height, width} = Dimensions.get('window');
+       @param dim Name of dimension as defined when calling set.
+       @returns Value for the dimension.
+       */
+  get(dim: 'window' | 'screen'): ScaledSize;
+
+  /**
+   * This should only be called from native code by sending the didUpdateDimensions event.
+   * @param dims Simple string-keyed object of dimensions to set
+   */
+  set(dims: {[key: string]: any}): void;
+
+  /**
+   * Add an event listener for dimension changes
+   *
+   * @param type the type of event to listen to
+   * @param handler the event handler
+   */
+  addEventListener(
+    type: 'change',
+    handler: ({
+      window,
+      screen,
+    }: {
+      window: ScaledSize;
+      screen: ScaledSize;
+    }) => void,
+  ): EmitterSubscription;
+}
+
+export function useWindowDimensions(): ScaledSize;
+
+export const Dimensions: Dimensions;

package/Libraries/Utilities/Dimensions.js

@@ -8,14 +8,14 @@
  * @flow
  */
 
+import RCTDeviceEventEmitter from '../EventEmitter/RCTDeviceEventEmitter';
 import EventEmitter, {
   type EventSubscription,
 } from '../vendor/emitter/EventEmitter';
-import RCTDeviceEventEmitter from '../EventEmitter/RCTDeviceEventEmitter';
 import NativeDeviceInfo, {
+  type DimensionsPayload,
   type DisplayMetrics,
   type DisplayMetricsAndroid,
-  type DimensionsPayload,
 } from './NativeDeviceInfo';
 import invariant from 'invariant';
 

package/Libraries/Utilities/GlobalPerformanceLogger.js

@@ -8,9 +8,10 @@
  * @format
  */
 
-import createPerformanceLogger from './createPerformanceLogger';
 import type {IPerformanceLogger} from './createPerformanceLogger';
 
+import createPerformanceLogger from './createPerformanceLogger';
+
 /**
  * This is a global shared instance of IPerformanceLogger that is created with
  * createPerformanceLogger().

package/Libraries/Utilities/HMRClient.js

@@ -8,17 +8,18 @@
  * @flow strict-local
  */
 
+import type {ExtendedError} from '../Core/ExtendedError';
+
+import getDevServer from '../Core/Devtools/getDevServer';
+import LogBox from '../LogBox/LogBox';
+import NativeRedBox from '../NativeModules/specs/NativeRedBox';
+
 const DevSettings = require('./DevSettings');
+const Platform = require('./Platform');
 const invariant = require('invariant');
 const MetroHMRClient = require('metro-runtime/src/modules/HMRClient');
-const Platform = require('./Platform');
 const prettyFormat = require('pretty-format');
 
-import getDevServer from '../Core/Devtools/getDevServer';
-import NativeRedBox from '../NativeModules/specs/NativeRedBox';
-import LogBox from '../LogBox/LogBox';
-import type {ExtendedError} from '../Core/ExtendedError';
-
 const pendingEntryPoints = [];
 let hmrClient = null;
 let hmrUnavailableReason: string | null = null;
@@ -240,9 +241,23 @@ Error: ${e.message}`;
       }
     });
 
-    client.on('close', data => {
+    client.on('close', closeEvent => {
       LoadingView.hide();
-      setHMRUnavailableReason('Disconnected from Metro.');
+
+      // https://www.rfc-editor.org/rfc/rfc6455.html#section-7.4.1
+      // https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5
+      const isNormalOrUnsetCloseReason =
+        closeEvent.code === 1000 ||
+        closeEvent.code === 1005 ||
+        closeEvent.code == null;
+
+      if (isNormalOrUnsetCloseReason) {
+        setHMRUnavailableReason('Disconnected from Metro.');
+      } else {
+        setHMRUnavailableReason(
+          `Disconnected from Metro (${closeEvent.code}: "${closeEvent.reason}").`,
+        );
+      }
     });
 
     if (isEnabled) {

package/Libraries/Utilities/LoadingView.ios.js

@@ -9,8 +9,8 @@
  */
 
 import processColor from '../StyleSheet/processColor';
-import NativeDevLoadingView from './NativeDevLoadingView';
 import Appearance from './Appearance';
+import NativeDevLoadingView from './NativeDevLoadingView';
 
 module.exports = {
   showMessage(message: string, type: 'load' | 'refresh') {

package/Libraries/Utilities/NativeAppearance.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
 export type ColorSchemeName = 'light' | 'dark';

package/Libraries/Utilities/NativeDevLoadingView.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
 export interface Spec extends TurboModule {

package/Libraries/Utilities/NativeDevSplitBundleLoader.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
 export interface Spec extends TurboModule {

package/Libraries/Utilities/NativeDeviceInfo.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
 export type DisplayMetricsAndroid = {|

package/Libraries/Utilities/NativePlatformConstantsAndroid.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
 export interface Spec extends TurboModule {

package/Libraries/Utilities/NativePlatformConstantsIOS.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
 export interface Spec extends TurboModule {

package/Libraries/Utilities/NativePlatformConstantsWin.js

@@ -7,6 +7,7 @@
  */
 
 import type {TurboModule} from '../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
 export interface Spec extends TurboModule {

package/Libraries/Utilities/PerformanceLoggerContext.js

@@ -8,10 +8,11 @@
  * @format
  */
 
+import type {IPerformanceLogger} from './createPerformanceLogger';
+
+import GlobalPerformanceLogger from './GlobalPerformanceLogger';
 import * as React from 'react';
 import {useContext} from 'react';
-import GlobalPerformanceLogger from './GlobalPerformanceLogger';
-import type {IPerformanceLogger} from './createPerformanceLogger';
 
 /**
  * This is a React Context that provides a scoped instance of IPerformanceLogger.

package/Libraries/Utilities/PixelRatio.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+export interface PixelRatioStatic {
+  /*
+          Returns the device pixel density. Some examples:
+              PixelRatio.get() === 1
+              mdpi Android devices (160 dpi)
+              PixelRatio.get() === 1.5
+              hdpi Android devices (240 dpi)
+              PixelRatio.get() === 2
+              iPhone 4, 4S
+              iPhone 5, 5c, 5s
+              iPhone 6
+              xhdpi Android devices (320 dpi)
+              PixelRatio.get() === 3
+              iPhone 6 plus
+              xxhdpi Android devices (480 dpi)
+              PixelRatio.get() === 3.5
+              Nexus 6
+      */
+  get(): number;
+
+  /*
+          Returns the scaling factor for font sizes. This is the ratio that is
+          used to calculate the absolute font size, so any elements that
+          heavily depend on that should use this to do calculations.
+
+          If a font scale is not set, this returns the device pixel ratio.
+
+          Currently this is only implemented on Android and reflects the user
+          preference set in Settings > Display > Font size,
+          on iOS it will always return the default pixel ratio.
+          */
+  getFontScale(): number;
+
+  /**
+   * Converts a layout size (dp) to pixel size (px).
+   * Guaranteed to return an integer number.
+   */
+  getPixelSizeForLayoutSize(layoutSize: number): number;
+
+  /**
+   * Rounds a layout size (dp) to the nearest layout size that
+   * corresponds to an integer number of pixels. For example,
+   * on a device with a PixelRatio of 3,
+   * PixelRatio.roundToNearestPixel(8.4) = 8.33,
+   * which corresponds to exactly (8.33 * 3) = 25 pixels.
+   */
+  roundToNearestPixel(layoutSize: number): number;
+
+  /**
+   * No-op for iOS, but used on the web. Should not be documented. [sic]
+   */
+  startDetecting(): void;
+}
+
+export const PixelRatio: PixelRatioStatic;

package/Libraries/Utilities/Platform.android.js

@@ -10,10 +10,10 @@
 
 import NativePlatformConstantsAndroid from './NativePlatformConstantsAndroid';
 
-export type PlatformSelectSpec<A, N, D> = {
-  android?: A,
-  native?: N,
-  default?: D,
+export type PlatformSelectSpec<T> = {
+  android?: T,
+  native?: T,
+  default?: T,
   ...
 };
 
@@ -22,6 +22,7 @@ const Platform = {
   OS: 'android',
   // $FlowFixMe[unsafe-getters-setters]
   get Version(): number {
+    // $FlowFixMe[object-this-reference]
     return this.constants.Version;
   },
   // $FlowFixMe[unsafe-getters-setters]
@@ -43,23 +44,28 @@ const Platform = {
     Brand: string,
     Manufacturer: string,
   |} {
+    // $FlowFixMe[object-this-reference]
     if (this.__constants == null) {
+      // $FlowFixMe[object-this-reference]
       this.__constants = NativePlatformConstantsAndroid.getConstants();
     }
+    // $FlowFixMe[object-this-reference]
     return this.__constants;
   },
   // $FlowFixMe[unsafe-getters-setters]
   get isTesting(): boolean {
     if (__DEV__) {
+      // $FlowFixMe[object-this-reference]
       return this.constants.isTesting;
     }
     return false;
   },
   // $FlowFixMe[unsafe-getters-setters]
   get isTV(): boolean {
+    // $FlowFixMe[object-this-reference]
     return this.constants.uiMode === 'tv';
   },
-  select: <A, N, D>(spec: PlatformSelectSpec<A, N, D>): A | N | D =>
+  select: <T>(spec: PlatformSelectSpec<T>): T =>
     'android' in spec
       ? // $FlowFixMe[incompatible-return]
         spec.android

package/Libraries/Utilities/Platform.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+/**
+ * @see https://reactnative.dev/docs/platform-specific-code#content
+ */
+export type PlatformOSType =
+  | 'ios'
+  | 'android'
+  | 'macos'
+  | 'windows'
+  | 'web'
+  | 'native';
+type PlatformConstants = {
+  isTesting: boolean;
+  reactNativeVersion: {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease?: number | null | undefined;
+  };
+};
+interface PlatformStatic {
+  isTV: boolean;
+  isTesting: boolean;
+  Version: number | string;
+  constants: PlatformConstants;
+
+  /**
+   * @see https://reactnative.dev/docs/platform-specific-code#content
+   */
+  select<T>(
+    specifics:
+      | ({[platform in PlatformOSType]?: T} & {default: T})
+      | {[platform in PlatformOSType]: T},
+  ): T;
+  select<T>(specifics: {[platform in PlatformOSType]?: T}): T | undefined;
+}
+
+interface PlatformIOSStatic extends PlatformStatic {
+  constants: PlatformConstants & {
+    forceTouchAvailable: boolean;
+    interfaceIdiom: string;
+    osVersion: string;
+    systemName: string;
+  };
+  OS: 'ios';
+  isPad: boolean;
+  isTV: boolean;
+  Version: string;
+}
+
+interface PlatformAndroidStatic extends PlatformStatic {
+  constants: PlatformConstants & {
+    Version: number;
+    Release: string;
+    Serial: string;
+    Fingerprint: string;
+    Model: string;
+    Brand: string;
+    Manufacturer: string;
+    ServerHost?: string | undefined;
+    uiMode: 'car' | 'desk' | 'normal' | 'tv' | 'watch' | 'unknown';
+  };
+  OS: 'android';
+  Version: number;
+}
+
+interface PlatformMacOSStatic extends PlatformStatic {
+  OS: 'macos';
+  Version: string;
+  constants: PlatformConstants & {
+    osVersion: string;
+  };
+}
+
+interface PlatformWindowsOSStatic extends PlatformStatic {
+  OS: 'windows';
+  Version: number;
+  constants: PlatformConstants & {
+    osVersion: number;
+  };
+}
+
+interface PlatformWebStatic extends PlatformStatic {
+  OS: 'web';
+}
+
+export type Platform =
+  | PlatformIOSStatic
+  | PlatformAndroidStatic
+  | PlatformWindowsOSStatic
+  | PlatformMacOSStatic
+  | PlatformWebStatic;
+
+export const Platform: Platform;

package/Libraries/Utilities/Platform.ios.js

@@ -10,10 +10,10 @@
 
 import NativePlatformConstantsIOS from './NativePlatformConstantsIOS';
 
-export type PlatformSelectSpec<D, N, I> = {
-  default?: D,
-  native?: N,
-  ios?: I,
+export type PlatformSelectSpec<T> = {
+  default?: T,
+  native?: T,
+  ios?: T,
   ...
 };
 
@@ -22,6 +22,7 @@ const Platform = {
   OS: 'ios',
   // $FlowFixMe[unsafe-getters-setters]
   get Version(): string {
+    // $FlowFixMe[object-this-reference]
     return this.constants.osVersion;
   },
   // $FlowFixMe[unsafe-getters-setters]
@@ -38,27 +39,33 @@ const Platform = {
     |},
     systemName: string,
   |} {
+    // $FlowFixMe[object-this-reference]
     if (this.__constants == null) {
+      // $FlowFixMe[object-this-reference]
       this.__constants = NativePlatformConstantsIOS.getConstants();
     }
+    // $FlowFixMe[object-this-reference]
     return this.__constants;
   },
   // $FlowFixMe[unsafe-getters-setters]
   get isPad(): boolean {
+    // $FlowFixMe[object-this-reference]
     return this.constants.interfaceIdiom === 'pad';
   },
   // $FlowFixMe[unsafe-getters-setters]
   get isTV(): boolean {
+    // $FlowFixMe[object-this-reference]
     return this.constants.interfaceIdiom === 'tv';
   },
   // $FlowFixMe[unsafe-getters-setters]
   get isTesting(): boolean {
     if (__DEV__) {
+      // $FlowFixMe[object-this-reference]
       return this.constants.isTesting;
     }
     return false;
   },
-  select: <D, N, I>(spec: PlatformSelectSpec<D, N, I>): D | N | I =>
+  select: <T>(spec: PlatformSelectSpec<T>): T =>
     // $FlowFixMe[incompatible-return]
     'ios' in spec ? spec.ios : 'native' in spec ? spec.native : spec.default,
 };