react-native-windows 0.72.13 → 0.73.0-preview.1

package/Libraries/Text/TextProps.windows.js

@@ -0,0 +1,275 @@
+/**
+ * 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.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+'use strict';
+
+import type {
+  AccessibilityActionEvent,
+  AccessibilityActionInfo,
+  AccessibilityRole,
+  AccessibilityState,
+  Role,
+} from '../Components/View/ViewAccessibility';
+import type {TextStyleProp} from '../StyleSheet/StyleSheet';
+import type {
+  LayoutEvent,
+  PointerEvent,
+  PressEvent,
+  TextLayoutEvent,
+} from '../Types/CoreEventTypes';
+import type {Node} from 'react';
+
+export type PressRetentionOffset = $ReadOnly<{|
+  top: number,
+  left: number,
+  bottom: number,
+  right: number,
+|}>;
+
+type PointerEventProps = $ReadOnly<{|
+  onPointerEnter?: (event: PointerEvent) => void,
+  onPointerLeave?: (event: PointerEvent) => void,
+  onPointerMove?: (event: PointerEvent) => void,
+|}>;
+
+/**
+ * @see https://reactnative.dev/docs/text#reference
+ */
+export type TextProps = $ReadOnly<{|
+  ...PointerEventProps,
+
+  /**
+   * Indicates whether the view is an accessibility element.
+   *
+   * See https://reactnative.dev/docs/text#accessible
+   */
+  accessible?: ?boolean,
+  accessibilityActions?: ?$ReadOnlyArray<AccessibilityActionInfo>,
+  onAccessibilityAction?: ?(event: AccessibilityActionEvent) => mixed,
+  accessibilityHint?: ?Stringish,
+  accessibilityLanguage?: ?Stringish,
+  accessibilityLabel?: ?Stringish,
+  accessibilityRole?: ?AccessibilityRole,
+  accessibilityState?: ?AccessibilityState,
+  accessibilityLevel?: ?number, // Windows
+  accessibilityPosInSet?: ?number, // Windows
+  accessibilitySetSize?: ?number, // Windows
+
+  'aria-label'?: ?string,
+
+  /**
+   * Whether font should be scaled down automatically.
+   *
+   * See https://reactnative.dev/docs/text#adjustsfontsizetofit
+   */
+  adjustsFontSizeToFit?: ?boolean,
+
+  /**
+   * Whether fonts should scale to respect Text Size accessibility settings.
+   *
+   * See https://reactnative.dev/docs/text#allowfontscaling
+   */
+  allowFontScaling?: ?boolean,
+
+  /**
+   * Set hyphenation strategy on Android.
+   *
+   */
+  android_hyphenationFrequency?: ?('normal' | 'none' | 'full'),
+
+  /**
+   * alias for accessibilityState
+   *
+   * see https://reactnative.dev/docs/accessibility#accessibilitystate
+   */
+  'aria-busy'?: ?boolean,
+  'aria-checked'?: ?boolean | 'mixed',
+  'aria-disabled'?: ?boolean,
+  'aria-expanded'?: ?boolean,
+  'aria-selected'?: ?boolean,
+  'aria-posinset'?: ?number, // Windows
+  'aria-setsize'?: ?number, // Windows
+  'aria-level'?: ?number, // Windows
+
+  /**
+   * Represents the nativeID of the associated label text. When the assistive technology focuses on the component with this props, the text is read aloud.
+   * This prop is listed for cross-platform reasons and has no real effect on Android or iOS.
+   */
+  'aria-labelledby'?: ?string,
+
+  children?: ?Node,
+
+  /**
+   * When `numberOfLines` is set, this prop defines how text will be
+   * truncated.
+   *
+   * See https://reactnative.dev/docs/text#ellipsizemode
+   */
+  ellipsizeMode?: ?('clip' | 'head' | 'middle' | 'tail'),
+
+  /**
+   * Used to locate this view from native code.
+   *
+   * See https://reactnative.dev/docs/text#nativeid
+   */
+  id?: string,
+
+  /**
+   * Specifies largest possible scale a font can reach when `allowFontScaling` is enabled.
+   * Possible values:
+   * `null/undefined` (default): inherit from the parent node or the global default (0)
+   * `0`: no max, ignore parent/global default
+   * `>= 1`: sets the maxFontSizeMultiplier of this node to this value
+   */
+  maxFontSizeMultiplier?: ?number,
+
+  /**
+   * Used to locate this view from native code.
+   *
+   * See https://reactnative.dev/docs/text#nativeid
+   */
+  nativeID?: ?string,
+
+  /**
+   * Used to truncate the text with an ellipsis.
+   *
+   * See https://reactnative.dev/docs/text#numberoflines
+   */
+  numberOfLines?: ?number,
+
+  /**
+   * Invoked on mount and layout changes.
+   *
+   * See https://reactnative.dev/docs/text#onlayout
+   */
+  onLayout?: ?(event: LayoutEvent) => mixed,
+
+  /**
+   * This function is called on long press.
+   *
+   * See https://reactnative.dev/docs/text#onlongpress
+   */
+  onLongPress?: ?(event: PressEvent) => mixed,
+
+  /**
+   * This function is called on press.
+   *
+   * See https://reactnative.dev/docs/text#onpress
+   */
+  onPress?: ?(event: PressEvent) => mixed,
+  onPressIn?: ?(event: PressEvent) => mixed,
+  onPressOut?: ?(event: PressEvent) => mixed,
+  onResponderGrant?: ?(event: PressEvent) => void,
+  onResponderMove?: ?(event: PressEvent) => void,
+  onResponderRelease?: ?(event: PressEvent) => void,
+  onResponderTerminate?: ?(event: PressEvent) => void,
+  onResponderTerminationRequest?: ?() => boolean,
+  onStartShouldSetResponder?: ?() => boolean,
+  onMoveShouldSetResponder?: ?() => boolean,
+  onTextLayout?: ?(event: TextLayoutEvent) => mixed,
+
+  /**
+   * Defines how far your touch may move off of the button, before
+   * deactivating the button.
+   *
+   * See https://reactnative.dev/docs/text#pressretentionoffset
+   */
+  pressRetentionOffset?: ?PressRetentionOffset,
+
+  /**
+   * Indicates to accessibility services to treat UI component like a specific role.
+   */
+  role?: ?Role,
+
+  /**
+   * Lets the user select text.
+   *
+   * See https://reactnative.dev/docs/text#selectable
+   */
+  selectable?: ?boolean,
+  style?: ?TextStyleProp,
+
+  /**
+   * Used to locate this view in end-to-end tests.
+   *
+   * See https://reactnative.dev/docs/text#testid
+   */
+  testID?: ?string,
+
+  /**
+   * Android Only
+   */
+
+  /**
+   * Specifies the disabled state of the text view for testing purposes.
+   *
+   * See https://reactnative.dev/docs/text#disabled
+   */
+  disabled?: ?boolean,
+
+  /**
+   * The highlight color of the text.
+   *
+   * See https://reactnative.dev/docs/text#selectioncolor
+   */
+  selectionColor?: ?string,
+
+  dataDetectorType?: ?('phoneNumber' | 'link' | 'email' | 'none' | 'all'),
+
+  /**
+   * Set text break strategy on Android.
+   *
+   * See https://reactnative.dev/docs/text#textbreakstrategy
+   */
+  textBreakStrategy?: ?('balanced' | 'highQuality' | 'simple'),
+
+  /**
+   * iOS Only
+   */
+  adjustsFontSizeToFit?: ?boolean,
+
+  /**
+   * The Dynamic Type scale ramp to apply to this element on iOS.
+   */
+  dynamicTypeRamp?: ?(
+    | 'caption2'
+    | 'caption1'
+    | 'footnote'
+    | 'subheadline'
+    | 'callout'
+    | 'body'
+    | 'headline'
+    | 'title3'
+    | 'title2'
+    | 'title1'
+    | 'largeTitle'
+  ),
+
+  /**
+   * Smallest possible scale a font can reach.
+   *
+   * See https://reactnative.dev/docs/text#minimumfontscale
+   */
+  minimumFontScale?: ?number,
+
+  /**
+   * When `true`, no visual change is made when text is pressed down.
+   *
+   * See https://reactnative.dev/docs/text#supperhighlighting
+   */
+  suppressHighlighting?: ?boolean,
+
+  /**
+   * Set line break strategy on iOS.
+   *
+   * See https://reactnative.dev/docs/text.html#linebreakstrategyios
+   */
+  lineBreakStrategyIOS?: ?('none' | 'standard' | 'hangul-word' | 'push-out'),
+|}>;

package/Libraries/TurboModule/TurboModuleRegistry.js

@@ -16,21 +16,52 @@ const NativeModules = require('../BatchedBridge/NativeModules');
 
 const turboModuleProxy = global.__turboModuleProxy;
 
+const moduleLoadHistory = {
+  NativeModules: ([]: Array<string>),
+  TurboModules: ([]: Array<string>),
+  NotFound: ([]: Array<string>),
+};
+
+function isBridgeless() {
+  return global.RN$Bridgeless === true;
+}
+
+function isTurboModuleInteropEnabled() {
+  return global.RN$TurboInterop === true;
+}
+
+// TODO(154308585): Remove "module not found" debug info logging
+function shouldReportDebugInfo() {
+  return true;
+}
+
+// TODO(148943970): Consider reversing the lookup here:
+// Lookup on __turboModuleProxy, then lookup on nativeModuleProxy
 function requireModule<T: TurboModule>(name: string): ?T {
-  // Bridgeless mode requires TurboModules
-  if (global.RN$Bridgeless !== true) {
+  if (!isBridgeless() || isTurboModuleInteropEnabled()) {
     // Backward compatibility layer during migration.
     const legacyModule = NativeModules[name];
     if (legacyModule != null) {
+      if (shouldReportDebugInfo()) {
+        moduleLoadHistory.NativeModules.push(name);
+      }
       return ((legacyModule: $FlowFixMe): T);
     }
   }
 
   if (turboModuleProxy != null) {
     const module: ?T = turboModuleProxy(name);
-    return module;
+    if (module != null) {
+      if (shouldReportDebugInfo()) {
+        moduleLoadHistory.TurboModules.push(name);
+      }
+      return module;
+    }
   }
 
+  if (shouldReportDebugInfo() && !moduleLoadHistory.NotFound.includes(name)) {
+    moduleLoadHistory.NotFound.push(name);
+  }
   return null;
 }
 
@@ -40,10 +71,19 @@ export function get<T: TurboModule>(name: string): ?T {
 
 export function getEnforcing<T: TurboModule>(name: string): T {
   const module = requireModule<T>(name);
-  invariant(
-    module != null,
+  let message =
     `TurboModuleRegistry.getEnforcing(...): '${name}' could not be found. ` +
-      'Verify that a module by this name is registered in the native binary.',
-  );
+    'Verify that a module by this name is registered in the native binary.';
+
+  if (shouldReportDebugInfo()) {
+    message += 'Bridgeless mode: ' + (isBridgeless() ? 'true' : 'false') + '. ';
+    message +=
+      'TurboModule interop: ' +
+      (isTurboModuleInteropEnabled() ? 'true' : 'false') +
+      '. ';
+    message += 'Modules loaded: ' + JSON.stringify(moduleLoadHistory);
+  }
+
+  invariant(module != null, message);
   return module;
 }

package/Libraries/TurboModule/samples/NativeSampleTurboModule.js

@@ -37,6 +37,12 @@ export interface Spec extends TurboModule {
   +getValue: (x: number, y: string, z: Object) => Object;
   +getValueWithCallback: (callback: (value: string) => void) => void;
   +getValueWithPromise: (error: boolean) => Promise<string>;
+  +voidFuncThrows?: () => void;
+  +getObjectThrows?: (arg: Object) => Object;
+  +promiseThrows?: () => Promise<void>;
+  +voidFuncAssert?: () => void;
+  +getObjectAssert?: (arg: Object) => Object;
+  +promiseAssert?: () => Promise<void>;
 }
 
 export default (TurboModuleRegistry.getEnforcing<Spec>(

package/Libraries/Types/CoreEventTypes.d.ts

@@ -8,7 +8,6 @@
  */
 
 import type * as React from 'react';
-import {NodeHandle} from '../ReactNative/RendererProxy';
 import {HostComponent} from '../../types/public/ReactNativeTypes';
 
 export interface LayoutRectangle {
@@ -42,7 +41,11 @@ export interface TextLayoutEventData extends TargetedEvent {
 
 // Similar to React.SyntheticEvent except for nativeEvent
 export interface NativeSyntheticEvent<T>
-  extends React.BaseSyntheticEvent<T, NodeHandle, NodeHandle> {}
+  extends React.BaseSyntheticEvent<
+    T,
+    React.ElementRef<HostComponent<unknown>>,
+    React.ElementRef<HostComponent<unknown>>
+  > {}
 
 export interface NativeTouchEvent {
   /**

package/Libraries/Utilities/GlobalPerformanceLogger.js

@@ -10,17 +10,8 @@
 
 import type {IPerformanceLogger} from './createPerformanceLogger';
 
-import ReactNativeFeatureFlags from '../ReactNative/ReactNativeFeatureFlags';
-import NativePerformance from '../WebPerformance/NativePerformance';
 import createPerformanceLogger from './createPerformanceLogger';
 
-function isLoggingForWebPerformance(): boolean {
-  return (
-    NativePerformance != null &&
-    ReactNativeFeatureFlags.isGlobalWebPerformanceLoggerEnabled()
-  );
-}
-
 /**
  * This is a global shared instance of IPerformanceLogger that is created with
  * createPerformanceLogger().
@@ -28,8 +19,7 @@ function isLoggingForWebPerformance(): boolean {
  * that are logged during loading bundle. If you want to log something from your
  * React component you should use PerformanceLoggerContext instead.
  */
-const GlobalPerformanceLogger: IPerformanceLogger = createPerformanceLogger(
-  isLoggingForWebPerformance(),
-);
+const GlobalPerformanceLogger: IPerformanceLogger =
+  createPerformanceLogger(true);
 
 module.exports = GlobalPerformanceLogger;

package/Libraries/Utilities/NativeDeviceInfo.js

@@ -34,21 +34,20 @@ export type DimensionsPayload = {|
   screenPhysicalPixels?: DisplayMetricsAndroid,
 |};
 
+export type DeviceInfoConstants = {|
+  +Dimensions: DimensionsPayload,
+  +isIPhoneX_deprecated?: boolean,
+|};
+
 export interface Spec extends TurboModule {
-  +getConstants: () => {|
-    +Dimensions: DimensionsPayload,
-    +isIPhoneX_deprecated?: boolean,
-  |};
+  +getConstants: () => DeviceInfoConstants;
 }
 
 const NativeModule: Spec = TurboModuleRegistry.getEnforcing<Spec>('DeviceInfo');
-let constants = null;
+let constants: ?DeviceInfoConstants = null;
 
 const NativeDeviceInfo = {
-  getConstants(): {|
-    +Dimensions: DimensionsPayload,
-    +isIPhoneX_deprecated?: boolean,
-  |} {
+  getConstants(): DeviceInfoConstants {
     if (constants == null) {
       constants = NativeModule.getConstants();
     }

package/Libraries/Utilities/NativePlatformConstantsAndroid.js

@@ -12,25 +12,30 @@ import type {TurboModule} from '../TurboModule/RCTExport';
 
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
+export type ReactNativeVersionAndroid = {|
+  major: number,
+  minor: number,
+  patch: number,
+  prerelease: ?number,
+|};
+
+export type PlatformConstantsAndroid = {|
+  isTesting: boolean,
+  isDisableAnimations?: boolean,
+  reactNativeVersion: ReactNativeVersionAndroid,
+  Version: number,
+  Release: string,
+  Serial: string,
+  Fingerprint: string,
+  Model: string,
+  ServerHost?: string,
+  uiMode: string,
+  Brand: string,
+  Manufacturer: string,
+|};
+
 export interface Spec extends TurboModule {
-  +getConstants: () => {|
-    isTesting: boolean,
-    reactNativeVersion: {|
-      major: number,
-      minor: number,
-      patch: number,
-      prerelease: ?number,
-    |},
-    Version: number,
-    Release: string,
-    Serial: string,
-    Fingerprint: string,
-    Model: string,
-    ServerHost?: string,
-    uiMode: string,
-    Brand: string,
-    Manufacturer: string,
-  |};
+  +getConstants: () => PlatformConstantsAndroid;
   +getAndroidID: () => string;
 }
 

package/Libraries/Utilities/NativePlatformConstantsIOS.js

@@ -12,20 +12,23 @@ import type {TurboModule} from '../TurboModule/RCTExport';
 
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
+export type PlatformConstantsIOS = {|
+  isTesting: boolean,
+  isDisableAnimations?: boolean,
+  reactNativeVersion: {|
+    major: number,
+    minor: number,
+    patch: number,
+    prerelease: ?number,
+  |},
+  forceTouchAvailable: boolean,
+  osVersion: string,
+  systemName: string,
+  interfaceIdiom: string,
+|};
+
 export interface Spec extends TurboModule {
-  +getConstants: () => {|
-    isTesting: boolean,
-    reactNativeVersion: {|
-      major: number,
-      minor: number,
-      patch: number,
-      prerelease: ?number,
-    |},
-    forceTouchAvailable: boolean,
-    osVersion: string,
-    systemName: string,
-    interfaceIdiom: string,
-  |};
+  +getConstants: () => PlatformConstantsIOS;
 }
 
 export default (TurboModuleRegistry.getEnforcing<Spec>(

package/Libraries/Utilities/NativePlatformConstantsWin.js

@@ -10,17 +10,20 @@ import type {TurboModule} from '../TurboModule/RCTExport';
 
 import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
 
+export type PlatformConstantsWindows = {|
+  isTesting: boolean,
+  isDisableAnimations?: boolean,
+  reactNativeVersion: {|
+    major: number,
+    minor: number,
+    patch: number,
+    prerelease: ?string,
+  |},
+  osVersion: number,
+|};
+
 export interface Spec extends TurboModule {
-  +getConstants: () => {|
-    isTesting: boolean,
-    reactNativeVersion: {|
-      major: number,
-      minor: number,
-      patch: number,
-      prerelease: ?string,
-    |},
-    osVersion: number,
-  |};
+  +getConstants: () => PlatformConstantsWindows;
 }
 
 export default (TurboModuleRegistry.getEnforcing<Spec>(

package/Libraries/Utilities/PerformanceLoggerContext.js

@@ -18,7 +18,7 @@ import {useContext} from 'react';
  * This is a React Context that provides a scoped instance of IPerformanceLogger.
  * We wrap every <AppContainer /> with a Provider for this context so the logger
  * should be available in every component.
- * See React docs about using Context: https://reactjs.org/docs/context.html
+ * See React docs about using Context: https://react.dev/docs/context.html
  */
 const PerformanceLoggerContext: React.Context<IPerformanceLogger> =
   React.createContext(GlobalPerformanceLogger);

package/Libraries/Utilities/Platform.android.js

@@ -8,16 +8,14 @@
  * @flow strict
  */
 
-import NativePlatformConstantsAndroid from './NativePlatformConstantsAndroid';
+import type {
+  Platform as PlatformType,
+  PlatformSelectSpec,
+} from './Platform.flow';
 
-export type PlatformSelectSpec<T> = {
-  android?: T,
-  native?: T,
-  default?: T,
-  ...
-};
+import NativePlatformConstantsAndroid from './NativePlatformConstantsAndroid';
 
-const Platform = {
+const Platform: PlatformType = {
   __constants: null,
   OS: 'android',
   // $FlowFixMe[unsafe-getters-setters]
@@ -28,6 +26,7 @@ const Platform = {
   // $FlowFixMe[unsafe-getters-setters]
   get constants(): {|
     isTesting: boolean,
+    isDisableAnimations?: boolean,
     reactNativeVersion: {|
       major: number,
       minor: number,
@@ -61,6 +60,11 @@ const Platform = {
     return false;
   },
   // $FlowFixMe[unsafe-getters-setters]
+  get isDisableAnimations(): boolean {
+    // $FlowFixMe[object-this-reference]
+    return this.constants.isDisableAnimations ?? this.isTesting;
+  },
+  // $FlowFixMe[unsafe-getters-setters]
   get isTV(): boolean {
     // $FlowFixMe[object-this-reference]
     return this.constants.uiMode === 'tv';

package/Libraries/Utilities/Platform.d.ts

@@ -19,6 +19,7 @@ export type PlatformOSType =
   | 'native';
 type PlatformConstants = {
   isTesting: boolean;
+  isDisableAnimations?: boolean | undefined;
   reactNativeVersion: {
     major: number;
     minor: number;