react-native-tvos 0.86.0-2 → 0.87.0-0

package/Libraries/Modal/Modal.js

@@ -36,7 +36,7 @@ type ModalEventDefinitions = {
   modalDismissed: [{modalID: number}],
 };
 
-export type PublicModalInstance = HostInstance;
+export type ModalInstance = HostInstance;
 
 const ModalEventEmitter =
   Platform.OS === 'ios' && NativeModalManager != null
@@ -47,12 +47,6 @@ const ModalEventEmitter =
       )
     : null;
 
-/**
- * The Modal component is a simple way to present content above an enclosing view.
- *
- * See https://reactnative.dev/docs/modal
- */
-
 // In order to route onDismiss callbacks, we need to uniquely identifier each
 // <Modal> on screen. There can be different ones, either nested or as siblings.
 // We cannot pass the onDismiss callback to native as the view will be
@@ -63,56 +57,64 @@ type OrientationChangeEvent = Readonly<{
   orientation: 'portrait' | 'landscape',
 }>;
 
+/** @build-types emit-as-interface Uniwind compatibility */
 export type ModalBaseProps = {
   /**
-   * @deprecated Use animationType instead
-   */
-  animated?: boolean,
-  /**
-   * The `animationType` prop controls how the modal animates.
+   * Controls how the modal animates. `'slide'` slides in from the bottom,
+   * `'fade'` fades into view, `'none'` appears without animation.
    *
-   * - `slide` slides in from the bottom
-   * - `fade` fades into view
-   * - `none` appears without an animation
+   * @default `'none'`
    */
   animationType?: ?('none' | 'slide' | 'fade'),
+
   /**
-   * The `transparent` prop determines whether your modal will fill the entire view.
-   * Setting this to `true` will render the modal over a transparent background.
+   * Whether the modal fills the entire view. Setting to `true` renders the
+   * modal over a transparent background.
+   *
+   * @default `false`
    */
   transparent?: ?boolean,
+
   /**
-   * The `visible` prop determines whether your modal is visible.
+   * Whether the modal is visible.
+   *
+   * @default `true`
    */
   visible?: ?boolean,
+
   /**
-   * The `onRequestClose` callback is called when the user taps the hardware back button on Android, dismisses the sheet using a gesture on iOS (when `allowSwipeDismissal` is set to true) or the menu button on Apple TV.
-   *
-   * This is required on iOS and Android.
+   * Called when the user taps the hardware back button on Android, the menu
+   * button on Apple TV, or the modal is dismissed via drag gesture on iOS
+   * (when `allowSwipeDismissal` is `true`). Required on Android and TV.
    */
   // onRequestClose?: (event: NativeSyntheticEvent<any>) => void;
   onRequestClose?: ?DirectEventHandler<null>,
+
   /**
-   * The `onShow` prop allows passing a function that will be called once the modal has been shown.
+   * Called once the modal has been shown.
    */
   // onShow?: (event: NativeSyntheticEvent<any>) => void;
   onShow?: ?DirectEventHandler<null>,
 
   /**
-   * The `backdropColor` props sets the background color of the modal's container.
-   * Defaults to `white` if not provided and transparent is `false`. Ignored if `transparent` is `true`.
+   * The backdrop color of the modal's container. Defaults to `white` if
+   * `transparent` is `false`. Ignored if `transparent` is `true`.
    */
   backdropColor?: ColorValue,
 
   /**
    * A ref to the native Modal component.
    */
-  modalRef?: React.RefSetter<PublicModalInstance>,
+  modalRef?: React.RefSetter<ModalInstance>,
 };
 
 export type ModalPropsIOS = {
   /**
-   * The `presentationStyle` determines the style of modal to show
+   * Controls how the modal appears.
+   *
+   * @default `'fullScreen'` if `transparent` is `false`, `'overFullScreen'` if `transparent` is `true`.
+   *
+   * @platform ios
    */
   presentationStyle?: ?(
     | 'fullScreen'
@@ -122,8 +124,13 @@ export type ModalPropsIOS = {
   ),
 
   /**
-   * The `supportedOrientations` prop allows the modal to be rotated to any of the specified orientations.
-   * On iOS, the modal is still restricted by what's specified in your app's Info.plist's UISupportedInterfaceOrientations field.
+   * Array of orientations the modal can be rotated to. On iOS, the modal is
+   * still restricted by what is specified in your app's Info.plist
+   * `UISupportedInterfaceOrientations` field.
+   *
+   * @default `['portrait']`
+   *
+   * @platform ios
    */
   supportedOrientations?: ?ReadonlyArray<
     | 'portrait'
@@ -134,14 +141,19 @@ export type ModalPropsIOS = {
   >,
 
   /**
-   * The `onDismiss` prop allows passing a function that will be called once the modal has been dismissed.
+   * Called once the modal has been dismissed.
+   *
+   * @platform ios
    */
   // onDismiss?: (() => void) | undefined;
   onDismiss?: ?() => void,
 
   /**
-   * The `onOrientationChange` callback is called when the orientation changes while the modal is being displayed.
-   * The orientation provided is only 'portrait' or 'landscape'. This callback is also called on initial render, regardless of the current orientation.
+   * Called when the orientation changes while the modal is displayed. The
+   * orientation provided is only `'portrait'` or `'landscape'`. This callback
+   * is also called on initial render, regardless of the current orientation.
+   *
+   * @platform ios
    */
   // onOrientationChange?:
   //   | ((event: NativeSyntheticEvent<any>) => void)
@@ -149,25 +161,42 @@ export type ModalPropsIOS = {
   onOrientationChange?: ?DirectEventHandler<OrientationChangeEvent>,
 
   /**
-   * Controls whether the modal can be dismissed by swiping down on iOS.
-   * This requires you to implement the `onRequestClose` prop to handle the dismissal.
+   * Controls whether the modal can be dismissed by swiping down. Requires
+   * `onRequestClose` to be set.
+   *
+   * @default `false`
+   *
+   * @platform ios
    */
   allowSwipeDismissal?: ?boolean,
 };
 
 export type ModalPropsAndroid = {
   /**
-   *  Controls whether to force hardware acceleration for the underlying window.
+   * Controls whether to force hardware acceleration for the underlying window.
+   *
+   * @default `false`
+   *
+   * @platform android
    */
   hardwareAccelerated?: ?boolean,
 
   /**
-   *  Determines whether your modal should go under the system statusbar.
+   * Whether the modal should go under the system statusbar.
+   *
+   * @default `false`
+   *
+   * @platform android
    */
   statusBarTranslucent?: ?boolean,
 
   /**
-   *  Determines whether your modal should go under the system navigationbar.
+   * Whether the modal should go under the system navigation bar.
+   * `statusBarTranslucent` also needs to be `true`.
+   *
+   * @default `false`
+   *
+   * @platform android
    */
   navigationBarTranslucent?: ?boolean,
 };
@@ -217,6 +246,11 @@ type ModalState = {
   isRendered: boolean,
 };
 
+/**
+ * A basic way to present content above an enclosing view.
+ *
+ * @see https://reactnative.dev/docs/modal
+ */
 class Modal extends React.Component<ModalProps, ModalState> {
   static defaultProps: {hardwareAccelerated: boolean, visible: boolean} = {
     visible: true,
@@ -389,7 +423,7 @@ const styles = StyleSheet.create({
 });
 
 type ModalRefProps = Readonly<{
-  ref?: React.RefSetter<PublicModalInstance>,
+  ref?: React.RefSetter<ModalInstance>,
 }>;
 
 // NOTE: This wrapper component is necessary because `Modal` is a class

package/Libraries/Modal/RCTModalHostViewNativeComponent.js

@@ -8,7 +8,7 @@
  * @format
  */
 
-export * from '../../src/private/specs_DEPRECATED/components/RCTModalHostViewNativeComponent';
-import RCTModalHostViewNativeComponent from '../../src/private/specs_DEPRECATED/components/RCTModalHostViewNativeComponent';
+export * from '../../src/private/components/modal/specs/RCTModalHostViewNativeComponent';
+import RCTModalHostViewNativeComponent from '../../src/private/components/modal/specs/RCTModalHostViewNativeComponent';
 
 export default RCTModalHostViewNativeComponent;

package/Libraries/NativeComponent/BaseViewConfig.android.js

@@ -113,6 +113,18 @@ const bubblingEventTypes = {
       bubbled: 'onPointerOver',
     },
   },
+  topGotPointerCapture: {
+    phasedRegistrationNames: {
+      captured: 'onGotPointerCaptureCapture',
+      bubbled: 'onGotPointerCapture',
+    },
+  },
+  topLostPointerCapture: {
+    phasedRegistrationNames: {
+      captured: 'onLostPointerCaptureCapture',
+      bubbled: 'onLostPointerCapture',
+    },
+  },
   topClick: {
     phasedRegistrationNames: {
       captured: 'onClickCapture',
@@ -207,6 +219,7 @@ const validAttributesForNonEventProps = {
   backgroundColor: colorAttribute,
   transform: true,
   transformOrigin: true,
+  backgroundImage: backgroundImageAttribute,
   experimental_backgroundImage: backgroundImageAttribute,
   experimental_backgroundSize: backgroundSizeAttribute,
   experimental_backgroundPosition: backgroundPositionAttribute,
@@ -432,6 +445,10 @@ const validAttributesForEventProps = {
   onPointerOutCapture: true,
   onPointerOver: true,
   onPointerOverCapture: true,
+  onGotPointerCapture: true,
+  onGotPointerCaptureCapture: true,
+  onLostPointerCapture: true,
+  onLostPointerCaptureCapture: true,
 } as const;
 
 /**

package/Libraries/NativeComponent/ViewConfig.js

@@ -43,9 +43,9 @@ export function createViewConfig(
 }
 
 function composeIndexers<T>(
-  maybeA: ?{+[string]: T},
-  maybeB: ?{+[string]: T},
-): {+[string]: T} {
+  maybeA: ?{readonly [string]: T},
+  maybeB: ?{readonly [string]: T},
+): {readonly [string]: T} {
   return maybeA == null || maybeB == null
     ? (maybeA ?? maybeB ?? {})
     : {...maybeA, ...maybeB};

package/Libraries/NativeComponent/ViewConfigIgnore.js

@@ -37,7 +37,7 @@ export function DynamicallyInjectedByGestureHandler<T extends {...}>(
  * TODO(T110872225): Remove this logic, after achieving platform-consistency
  */
 export function ConditionallyIgnoredEventHandlers<
-  const T extends {+[name: string]: true},
+  const T extends {readonly [name: string]: true},
 >(value: T): T | void {
   if (Platform.OS === 'ios') {
     return value;

package/Libraries/Network/RCTHTTPRequestHandler.h

@@ -8,7 +8,7 @@
 #import <React/RCTInvalidating.h>
 #import <React/RCTURLRequestHandler.h>
 
-typedef NSURLSessionConfiguration * (^NSURLSessionConfigurationProvider)(void);
+typedef NSURLSessionConfiguration *_Nullable (^NSURLSessionConfigurationProvider)(void);
 /**
  *  The block provided via this function will provide the NSURLSessionConfiguration for all HTTP requests made by the
  * app.

package/Libraries/Performance/Systrace.js

@@ -8,6 +8,14 @@
  * @format
  */
 
+/**
+ * `Systrace` provides performance tracing for React Native applications.
+ * Methods in this module allow marking synchronous and asynchronous events
+ * that are visualized in supported system tracing tools.
+ *
+ * @see https://reactnative.dev/docs/systrace
+ */
+
 import typeof * as SystraceModule from './Systrace';
 
 const TRACE_TAG_REACT = 1 << 13; // eslint-disable-line no-bitwise
@@ -65,6 +73,33 @@ export function endEvent(args?: EventArgs): void {
   }
 }
 
+/**
+ * Traces the execution of the given function by marking its start with
+ * `beginEvent` and its end with `endEvent`, even if the function throws.
+ *
+ * @example
+ * Systrace.trace('myEvent', () => {
+ *   // logic to trace
+ * });
+ */
+export function trace<T>(
+  eventName: EventName,
+  fn: () => T,
+  args?: EventArgs,
+): T {
+  if (isEnabled()) {
+    const eventNameString =
+      typeof eventName === 'function' ? eventName() : eventName;
+    global.nativeTraceBeginSection(TRACE_TAG_REACT, eventNameString, args);
+    try {
+      return fn();
+    } finally {
+      global.nativeTraceEndSection(TRACE_TAG_REACT);
+    }
+  }
+  return fn();
+}
+
 /**
  * Marks the start of a potentially asynchronous event. The end of this event
  * should be marked calling the `endAsyncEvent` function with the cookie
@@ -128,6 +163,7 @@ if (__DEV__) {
     setEnabled,
     beginEvent,
     endEvent,
+    trace,
     beginAsyncEvent,
     endAsyncEvent,
     counterEvent,

package/Libraries/PermissionsAndroid/PermissionsAndroid.d.ts

@@ -58,7 +58,8 @@ export type Permission =
   | 'android.permission.READ_PHONE_NUMBERS'
   | 'android.permission.UWB_RANGING'
   | 'android.permission.POST_NOTIFICATIONS'
-  | 'android.permission.NEARBY_WIFI_DEVICES';
+  | 'android.permission.NEARBY_WIFI_DEVICES'
+  | 'android.permission.ACCESS_LOCAL_NETWORK';
 
 export type PermissionStatus = 'granted' | 'denied' | 'never_ask_again';
 
@@ -116,7 +117,8 @@ export interface PermissionsAndroidStatic {
       | 'READ_PHONE_NUMBERS'
       | 'UWB_RANGING'
       | 'POST_NOTIFICATIONS'
-      | 'NEARBY_WIFI_DEVICES']: Permission;
+      | 'NEARBY_WIFI_DEVICES'
+      | 'ACCESS_LOCAL_NETWORK']: Permission;
   };
   new (): PermissionsAndroidStatic;
   /**

package/Libraries/PermissionsAndroid/PermissionsAndroid.js

@@ -75,6 +75,7 @@ type PermissionsType = Readonly<{
   UWB_RANGING: 'android.permission.UWB_RANGING',
   POST_NOTIFICATIONS: 'android.permission.POST_NOTIFICATIONS',
   NEARBY_WIFI_DEVICES: 'android.permission.NEARBY_WIFI_DEVICES',
+  ACCESS_LOCAL_NETWORK: 'android.permission.ACCESS_LOCAL_NETWORK',
 }>;
 
 export type PermissionStatus = 'granted' | 'denied' | 'never_ask_again';
@@ -125,15 +126,18 @@ const PERMISSIONS = Object.freeze({
   UWB_RANGING: 'android.permission.UWB_RANGING',
   POST_NOTIFICATIONS: 'android.permission.POST_NOTIFICATIONS',
   NEARBY_WIFI_DEVICES: 'android.permission.NEARBY_WIFI_DEVICES',
+  ACCESS_LOCAL_NETWORK: 'android.permission.ACCESS_LOCAL_NETWORK',
 }) as PermissionsType;
 
-/**
- * `PermissionsAndroid` provides access to Android M's new permissions model.
- *
- * See https://reactnative.dev/docs/permissionsandroid
- */
 class PermissionsAndroidImpl {
+  /**
+   * A list of specified "dangerous" permissions that require prompting the user.
+   */
   PERMISSIONS: PermissionsType = PERMISSIONS;
+
+  /**
+   * Possible results of a permission request.
+   */
   RESULTS: Readonly<{
     DENIED: 'denied',
     GRANTED: 'granted',
@@ -168,10 +172,8 @@ class PermissionsAndroidImpl {
   }
 
   /**
-   * Returns a promise resolving to a boolean value as to whether the specified
-   * permissions has been granted
-   *
-   * See https://reactnative.dev/docs/permissionsandroid#check
+   * Check whether the specified permission has been granted. Returns a
+   * `Promise` resolving to a boolean.
    */
   check(permission: Permission): Promise<boolean> {
     if (Platform.OS !== 'android') {
@@ -222,10 +224,13 @@ class PermissionsAndroidImpl {
   }
 
   /**
-   * Prompts the user to enable a permission and returns a promise resolving to a
-   * string value indicating whether the user allowed or denied the request
+   * Prompt the user to enable a permission. Returns a `Promise` resolving to a
+   * `PermissionStatus` string indicating whether the user allowed or denied the
+   * request.
    *
-   * See https://reactnative.dev/docs/permissionsandroid#request
+   * If the optional `rationale` argument is provided, this function first
+   * checks with the OS whether it is necessary to show an explanatory dialog
+   * before presenting the system permission prompt.
    */
   async request(
     permission: Permission,
@@ -273,11 +278,9 @@ class PermissionsAndroidImpl {
   }
 
   /**
-   * Prompts the user to enable multiple permissions in the same dialog and
-   * returns an object with the permissions as keys and strings as values
-   * indicating whether the user allowed or denied the request
-   *
-   * See https://reactnative.dev/docs/permissionsandroid#requestmultiple
+   * Prompt the user to enable multiple permissions in a single dialog. Returns
+   * a `Promise` resolving to an object mapping each requested permission to its
+   * `PermissionStatus`.
    */
   requestMultiple(
     permissions: Array<Permission>,
@@ -298,6 +301,15 @@ class PermissionsAndroidImpl {
   }
 }
 
+/**
+ * Provides access to Android M's (API 23+) permissions model. Handles prompts
+ * for "dangerous" permissions that require explicit user approval. On devices
+ * before SDK 23, permissions are automatically granted if listed in the
+ * manifest.
+ *
+ * @see https://reactnative.dev/docs/permissionsandroid
+ * @platform android
+ */
 const PermissionsAndroidInstance: PermissionsAndroidImpl =
   new PermissionsAndroidImpl();
 export default PermissionsAndroidInstance;

package/Libraries/Pressability/Pressability.js

@@ -710,7 +710,7 @@ export default class Pressability {
                     );
                     if (delayHoverOut > 0) {
                       event.persist();
-                      this._hoverInDelayTimeout = setTimeout(() => {
+                      this._hoverOutDelayTimeout = setTimeout(() => {
                         onHoverOut(event);
                       }, delayHoverOut);
                     } else {

package/Libraries/PushNotificationIOS/PushNotificationIOS.js

@@ -185,6 +185,10 @@ class PushNotificationIOS {
   _remoteNotificationCompleteCallbackCalled: boolean;
   _threadID: string;
 
+  /**
+   * iOS fetch results that best describe the result of a finished remote notification handler.
+   * For a list of possible values, see `PushNotificationIOS.FetchResult`.
+   */
   static FetchResult: FetchResult = {
     NewData: 'UIBackgroundFetchResultNewData',
     NoData: 'UIBackgroundFetchResultNoData',

package/Libraries/ReactNative/AppContainer-dev.js

@@ -47,7 +47,9 @@ if (reactDevToolsHook) {
 
 type ExternalInspection = {
   externalInspectingEnabled: boolean,
-  +reportToExternalInspection: (viewData: TouchedViewDataAtPoint) => void,
+  readonly reportToExternalInspection: (
+    viewData: TouchedViewDataAtPoint,
+  ) => void,
 };
 
 type InspectorDeferredProps = {

package/Libraries/ReactNative/AppRegistry.flow.js

@@ -44,5 +44,6 @@ export type Registry = {
 };
 export type WrapperComponentProvider = (
   appParameters: Object,
+  appKey?: string,
 ) => React.ComponentType<any>;
 export type RootViewStyleProvider = (appParameters: Object) => ViewStyleProp;

package/Libraries/ReactNative/AppRegistry.js

@@ -9,11 +9,6 @@
  */
 
 import registerCallableModule from '../Core/registerCallableModule';
-/**
- * `AppRegistry` is the JavaScript entry point to running all React Native apps.
- *
- * See https://reactnative.dev/docs/appregistry
- */
 import * as AppRegistry from './AppRegistryImpl';
 
 // Register LogBox as a default surface
@@ -29,12 +24,21 @@ AppRegistry.registerComponent('LogBox', () => {
 
 global.RN$AppRegistry = AppRegistry;
 
-// Backwards compat with SurfaceRegistry, remove me later
-global.RN$SurfaceRegistry = {
-  renderSurface: AppRegistry.runApplication,
-  setSurfaceProps: AppRegistry.setSurfaceProps,
-};
-
 registerCallableModule('AppRegistry', AppRegistry);
 
+/**
+ * `AppRegistry` is the JS entry point to running all React Native apps. Root
+ * components register themselves with `AppRegistry.registerComponent`, then
+ * the native system can load the bundle for the app and run it when ready by
+ * invoking `AppRegistry.runApplication`.
+ *
+ * To stop an application when a view should be destroyed, call
+ * `AppRegistry.unmountApplicationComponentAtRootTag` with the tag that was
+ * passed into `runApplication`. These should always be used as a pair.
+ *
+ * `AppRegistry` should be required early in the require sequence to make sure
+ * the JS execution environment is set up before other modules are required.
+ *
+ * @see https://reactnative.dev/docs/appregistry
+ */
 export {AppRegistry};