@depup/react-native 0.86.2-depup.0 → 0.87.1-depup.0

package/types_generated/Libraries/LogBox/Data/LogBoxLog.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<<d957c6f0032ef29dd5393a285e33b802>>
+ * @generated SignedSource<<ae7d74da1108d7dc68c0c7819b1c5f1c>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/LogBox/Data/LogBoxLog.js
@@ -40,7 +40,7 @@ export type LogBoxLogData = Readonly<{
   componentStack: Stack;
   codeFrame?: CodeFrame | undefined;
   isComponentError: boolean;
-  extraData?: unknown;
+  extraData?: unknown | undefined;
   onNotificationPress?: (() => void) | undefined;
 }>;
 declare class LogBoxLog {

package/types_generated/Libraries/LogBox/Data/parseLogBoxLog.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<<7e3e23a2a48dcf27f7de87f099505647>>
+ * @generated SignedSource<<f51e81e4f223304a89189c14cc1f28ee>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/LogBox/Data/parseLogBoxLog.js
@@ -24,7 +24,7 @@ export type CodeFrame = Readonly<{
     column: number;
   } | undefined;
   fileName: string;
-  collapse?: boolean;
+  collapse?: boolean | undefined;
 }>;
 export type Message = Readonly<{
   content: string;

package/types_generated/Libraries/LogBox/LogBox.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<<a8008115fec54c7a2ebc63eb8c3b3b29>>
+ * @generated SignedSource<<0f090a84fb711df39fe495a990c6fcab>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/LogBox/LogBox.js
@@ -24,6 +24,9 @@ interface ILogBox {
   addConsoleLog(level: "warn" | "error", ...args: Array<unknown>): void;
   addException(error: ExtendedExceptionData): void;
 }
+/**
+ * LogBox displays logs in the app.
+ */
 declare const $$LogBox: ILogBox;
 declare type $$LogBox = typeof $$LogBox;
 export default $$LogBox;

package/types_generated/Libraries/Modal/Modal.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<<290bf556cb91838bde67bdc74f739884>>
+ * @generated SignedSource<<f32cf1474c77deea920b5f94b6f5ca3c>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Modal/Modal.js
@@ -15,96 +15,131 @@ import type { ViewProps } from "../Components/View/ViewPropTypes";
 import type { DirectEventHandler } from "../Types/CodegenTypes";
 import { type ColorValue } from "../StyleSheet/StyleSheet";
 import * as React from "react";
-export type PublicModalInstance = HostInstance;
+export type ModalInstance = HostInstance;
 type OrientationChangeEvent = Readonly<{
   orientation: "portrait" | "landscape";
 }>;
-export type ModalBaseProps = {
+export interface 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") | undefined;
   /**
-   * 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 | undefined;
   /**
-   * The `visible` prop determines whether your modal is visible.
+   * Whether the modal is visible.
+   *
+   * @default `true`
    */
   visible?: boolean | undefined;
   /**
-   * 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?: DirectEventHandler<null> | undefined;
   /**
-   * 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?: DirectEventHandler<null> | undefined;
   /**
-   * 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;
+  backdropColor?: ColorValue | undefined;
   /**
    * A ref to the native Modal component.
    */
-  modalRef?: React.Ref<PublicModalInstance>;
-};
+  modalRef?: React.Ref<ModalInstance> | undefined;
+}
 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" | "pageSheet" | "formSheet" | "overFullScreen") | undefined;
   /**
-   * 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" | "portrait-upside-down" | "landscape" | "landscape-left" | "landscape-right"> | undefined;
   /**
-   * 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;
   /**
-   * 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?: DirectEventHandler<OrientationChangeEvent> | undefined;
   /**
-   * 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 | undefined;
 };
 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 | undefined;
   /**
-   *  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 | undefined;
   /**
-   *  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 | undefined;
 };
 export type ModalProps = Omit<ModalBaseProps, keyof ModalPropsIOS | keyof ModalPropsAndroid | keyof ViewProps | keyof {}> & Omit<ModalPropsIOS, keyof ModalPropsAndroid | keyof ViewProps | keyof {}> & Omit<ModalPropsAndroid, keyof ViewProps | keyof {}> & Omit<ViewProps, keyof {}> & {};
 type ModalRefProps = Readonly<{
-  ref?: React.Ref<PublicModalInstance>;
+  ref?: React.Ref<ModalInstance> | undefined;
 }>;
 declare function Wrapper($$PARAM_0$$: Omit<ModalRefProps, keyof ModalProps | keyof {}> & Omit<ModalProps, keyof {}> & {}): React.ReactNode;
+/**
+ * A basic way to present content above an enclosing view.
+ *
+ * @see https://reactnative.dev/docs/modal
+ */
 declare const $$Modal: typeof Wrapper;
 declare type $$Modal = typeof $$Modal;
 export default $$Modal;

package/types_generated/Libraries/Network/FormData.d.ts

@@ -4,15 +4,15 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<c205d77babb8cdb2d968dab954e769c6>>
+ * @generated SignedSource<<7d7b5927d28d9c8735610b07371e1607>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Network/FormData.js
  */
 
 type FormDataValue = string | {
-  name?: string;
-  type?: string;
+  name?: string | undefined;
+  type?: string | undefined;
   uri: string;
 };
 type Headers = {
@@ -24,8 +24,8 @@ type FormDataPart = {
 } | {
   uri: string;
   headers: Headers;
-  name?: string;
-  type?: string;
+  name?: string | undefined;
+  type?: string | undefined;
 };
 /**
  * Polyfill for XMLHttpRequest2 FormData API, allowing multipart POST requests

package/types_generated/Libraries/Performance/Systrace.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<<5d9a7f4dc6f05ba16b47e8c51b105081>>
+ * @generated SignedSource<<cbc7488c6296f4672cc2473cb6b8bac5>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Performance/Systrace.js
@@ -44,6 +44,16 @@ export declare function beginEvent(eventName: EventName, args?: EventArgs): void
  * Marks the end of a synchronous event started in the same stack frame.
  */
 export declare 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 declare function trace<T>(eventName: EventName, fn: () => T, args?: EventArgs): T;
 /**
  * Marks the start of a potentially asynchronous event. The end of this event
  * should be marked calling the `endAsyncEvent` function with the cookie

package/types_generated/Libraries/PermissionsAndroid/PermissionsAndroid.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<<31f3b3dff02e24160d4bd83ee6954750>>
+ * @generated SignedSource<<691f77a6fe276e14f15dd37227eaf2ae>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/PermissionsAndroid/PermissionsAndroid.js
@@ -13,9 +13,9 @@
 export type Rationale = {
   title: string;
   message: string;
-  buttonPositive?: string;
-  buttonNegative?: string;
-  buttonNeutral?: string;
+  buttonPositive?: string | undefined;
+  buttonNegative?: string | undefined;
+  buttonNeutral?: string | undefined;
 };
 type PermissionsType = Readonly<{
   READ_CALENDAR: "android.permission.READ_CALENDAR";
@@ -61,16 +61,18 @@ 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";
 export type Permission = PermissionsType[keyof PermissionsType];
-/**
- * `PermissionsAndroid` provides access to Android M's new permissions model.
- *
- * See https://reactnative.dev/docs/permissionsandroid
- */
 declare class PermissionsAndroidImpl {
+  /**
+   * A list of specified "dangerous" permissions that require prompting the user.
+   */
   PERMISSIONS: PermissionsType;
+  /**
+   * Possible results of a permission request.
+   */
   RESULTS: Readonly<{
     DENIED: "denied";
     GRANTED: "granted";
@@ -86,10 +88,8 @@ declare class PermissionsAndroidImpl {
    */
   checkPermission(permission: Permission): Promise<boolean>;
   /**
-   * 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>;
   /**
@@ -108,22 +108,32 @@ declare class PermissionsAndroidImpl {
    */
   requestPermission(permission: Permission, rationale?: Rationale): Promise<boolean>;
   /**
-   * 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.
    */
   request(permission: Permission, rationale?: Rationale): Promise<PermissionStatus>;
   /**
-   * 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>): Promise<{ [permission in Permission]: PermissionStatus }>;
 }
 declare const PermissionsAndroidInstance: 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
+ */
 declare const $$PermissionsAndroid: typeof PermissionsAndroidInstance;
 declare type $$PermissionsAndroid = typeof $$PermissionsAndroid;
 export default $$PermissionsAndroid;

package/types_generated/Libraries/Pressability/Pressability.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<<6cae938ab3445397118526a8514e4686>>
+ * @generated SignedSource<<05c3b91ff22fcaf753700e6ebe61c052>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Pressability/Pressability.js
@@ -106,10 +106,10 @@ export type EventHandlers = Readonly<{
   onBlur: (event: BlurEvent) => 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;
+  onMouseEnter?: ((event: MouseEvent) => void) | undefined;
+  onMouseLeave?: ((event: MouseEvent) => void) | undefined;
+  onPointerEnter?: ((event: PointerEvent) => void) | undefined;
+  onPointerLeave?: ((event: PointerEvent) => void) | undefined;
   onResponderGrant: (event: GestureResponderEvent) => void | boolean;
   onResponderMove: (event: GestureResponderEvent) => void;
   onResponderRelease: (event: GestureResponderEvent) => void;

package/types_generated/Libraries/PushNotificationIOS/PushNotificationIOS.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<<d54b1b17c6b4b14e25647351f753dd55>>
+ * @generated SignedSource<<33bdeef78c820699fadea6c9130ffffc>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/PushNotificationIOS/PushNotificationIOS.js
@@ -18,19 +18,19 @@ export type PushNotificationPermissions = {
 };
 type PresentLocalNotificationDetails = {
   alertBody: string;
-  alertAction?: string;
-  alertTitle?: string;
-  soundName?: string;
-  category?: string;
-  userInfo?: Object;
-  applicationIconBadgeNumber?: number;
-  fireDate?: number;
-  isSilent?: boolean;
+  alertAction?: string | undefined;
+  alertTitle?: string | undefined;
+  soundName?: string | undefined;
+  category?: string | undefined;
+  userInfo?: Object | undefined;
+  applicationIconBadgeNumber?: number | undefined;
+  fireDate?: number | undefined;
+  isSilent?: boolean | undefined;
 };
 type ScheduleLocalNotificationDetails = Omit<PresentLocalNotificationDetails, keyof {
-  repeatInterval?: "year" | "month" | "week" | "day" | "hour" | "minute";
+  repeatInterval?: "year" | "month" | "week" | "day" | "hour" | "minute" | undefined;
 }> & {
-  repeatInterval?: "year" | "month" | "week" | "day" | "hour" | "minute";
+  repeatInterval?: "year" | "month" | "week" | "day" | "hour" | "minute" | undefined;
 };
 export type ContentAvailable = 1 | null | void;
 export type FetchResult = {
@@ -115,6 +115,10 @@ export interface PushNotification {
  * @deprecated Use [@react-native-community/push-notification-ios](https://www.npmjs.com/package/@react-native-community/push-notification-ios) instead
  */
 declare class PushNotificationIOS {
+  /**
+   * 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;
   /**
    * Schedules the localNotification for immediate presentation.

package/types_generated/Libraries/ReactNative/AppRegistry.flow.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<<ccf8d135ed3ff1cceb054f570091639a>>
+ * @generated SignedSource<<20ac63d668b0607bd64c067acf2ddbcd>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/ReactNative/AppRegistry.flow.js
@@ -21,9 +21,9 @@ export type ComponentProvider = () => React.ComponentType<any>;
 export type ComponentProviderInstrumentationHook = (component_: ComponentProvider, scopedPerformanceLogger: IPerformanceLogger) => React.ComponentType<any>;
 export type AppConfig = {
   appKey: string;
-  component?: ComponentProvider;
-  run?: Runnable;
-  section?: boolean;
+  component?: ComponentProvider | undefined;
+  run?: Runnable | undefined;
+  section?: boolean | undefined;
 };
 export type AppParameters = {
   initialProps: Readonly<{
@@ -39,5 +39,5 @@ export type Registry = {
   sections: ReadonlyArray<string>;
   runnables: Runnables;
 };
-export type WrapperComponentProvider = (appParameters: Object) => React.ComponentType<any>;
+export type WrapperComponentProvider = (appParameters: Object, appKey?: string) => React.ComponentType<any>;
 export type RootViewStyleProvider = (appParameters: Object) => ViewStyleProp;

package/types_generated/Libraries/ReactNative/AppRegistryImpl.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<<6758b2bb6098688b969d067333e9c6cf>>
+ * @generated SignedSource<<af8e02b079630050ea295466f2517885>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/ReactNative/AppRegistryImpl.js
@@ -14,59 +14,106 @@ import type { RootTag } from "../Types/RootTagTypes";
 import type { AppConfig, AppParameters, ComponentProvider, ComponentProviderInstrumentationHook, Registry, RootViewStyleProvider, Runnable, Runnables, TaskProvider, WrapperComponentProvider } from "./AppRegistry.flow";
 type TaskCanceller = () => void;
 type TaskCancelProvider = () => TaskCanceller;
+/**
+ * Sets a provider for a wrapper component that will wrap the root component
+ * of every registered app.
+ */
 export declare function setWrapperComponentProvider(provider: WrapperComponentProvider): void;
+/**
+ * Sets a provider for styles to be applied to the root view of every
+ * registered app.
+ */
 export declare function setRootViewStyleProvider(provider: RootViewStyleProvider): void;
+/**
+ * Registers multiple apps with a single call by providing an array of app
+ * configurations.
+ */
 export declare function registerConfig(config: Array<AppConfig>): void;
 /**
- * Registers an app's root component.
+ * Registers a root component for the given app key. Once registered, the
+ * native system can run the app by calling `runApplication` with the same
+ * key.
  *
  * See https://reactnative.dev/docs/appregistry#registercomponent
  */
 export declare function registerComponent(appKey: string, componentProvider: ComponentProvider, section?: boolean): string;
+/**
+ * Registers a custom run function for the given app key.
+ */
 export declare function registerRunnable(appKey: string, run: Runnable): string;
+/**
+ * Registers a component as a navigable section.
+ */
 export declare function registerSection(appKey: string, component: ComponentProvider): void;
+/**
+ * Returns the app keys for all registered runnables.
+ */
 export declare function getAppKeys(): ReadonlyArray<string>;
+/**
+ * Returns the keys for all registered sections.
+ */
 export declare function getSectionKeys(): ReadonlyArray<string>;
+/**
+ * Returns a copy of the registered sections map.
+ */
 export declare function getSections(): Runnables;
+/**
+ * Returns the runnable registered for the given app key.
+ */
 export declare function getRunnable(appKey: string): null | undefined | Runnable;
+/**
+ * Returns the full registry of section keys and runnables.
+ */
 export declare function getRegistry(): Registry;
+/**
+ * Sets a hook that is called when a component provider is instrumented
+ * during registration.
+ */
 export declare function setComponentProviderInstrumentationHook(hook: ComponentProviderInstrumentationHook): void;
 /**
- * Loads the JavaScript bundle and runs the app.
+ * Loads the JavaScript bundle and runs the app registered under the given
+ * key. This is called by the native system when it is ready to display the
+ * app.
  *
  * See https://reactnative.dev/docs/appregistry#runapplication
  */
 export declare function runApplication(appKey: string, appParameters: AppParameters, displayMode?: number): void;
 /**
- * Update initial props for a surface that's already rendered
+ * Updates the initial props for a surface that has already been rendered.
  */
 export declare function setSurfaceProps(appKey: string, appParameters: Object, displayMode?: number): void;
 /**
- * Stops an application when a view should be destroyed.
+ * Stops an application when a view should be destroyed. Should always be
+ * called as a counterpart to `runApplication`.
  *
  * See https://reactnative.dev/docs/appregistry#unmountapplicationcomponentatroottag
  */
 export declare function unmountApplicationComponentAtRootTag(rootTag: RootTag): void;
 /**
- * Register a headless task. A headless task is a bit of code that runs without a UI.
+ * Registers a headless task. A headless task is a bit of code that runs
+ * without a UI, e.g. for background sync or push notifications.
  *
  * See https://reactnative.dev/docs/appregistry#registerheadlesstask
  */
 export declare function registerHeadlessTask(taskKey: string, taskProvider: TaskProvider): void;
 /**
- * Register a cancellable headless task. A headless task is a bit of code that runs without a UI.
+ * Registers a cancellable headless task. A headless task is a bit of code
+ * that runs without a UI. Unlike `registerHeadlessTask`, this variant
+ * accepts a cancel provider that can be used to abort the task.
  *
  * See https://reactnative.dev/docs/appregistry#registercancellableheadlesstask
  */
 export declare function registerCancellableHeadlessTask(taskKey: string, taskProvider: TaskProvider, taskCancelProvider: TaskCancelProvider): void;
 /**
- * Only called from native code. Starts a headless task.
+ * Starts a headless task. Called from native code when a registered headless
+ * task should begin execution.
  *
  * See https://reactnative.dev/docs/appregistry#startheadlesstask
  */
 export declare function startHeadlessTask(taskId: number, taskKey: string, data: any): void;
 /**
- * Only called from native code. Cancels a headless task.
+ * Cancels a headless task. Called from native code when a previously started
+ * headless task should be aborted.
  *
  * See https://reactnative.dev/docs/appregistry#cancelheadlesstask
  */

package/types_generated/Libraries/ReactNative/I18nManager.d.ts

@@ -4,19 +4,38 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<6c68fe70868f9b5a459c48ac3609b922>>
+ * @generated SignedSource<<f639a77e34a06e97dba520df67880acf>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/ReactNative/I18nManager.js
  */
 
 import type { I18nManagerConstants } from "./NativeI18nManager";
+/**
+ * Utilities for managing Right-to-Left (RTL) layout support.
+ *
+ * @see https://reactnative.dev/docs/i18nmanager
+ */
 declare const $$I18nManager: {
   getConstants: () => I18nManagerConstants;
+  /**
+   * Allows the app to opt in to RTL layout behavior. Should be called early
+   * in app startup. Takes effect on the next app reload.
+   */
   allowRTL: (shouldAllow: boolean) => void;
+  /**
+   * Forces the app into RTL layout mode, regardless of the device locale.
+   * Takes effect on the next app reload.
+   */
   forceRTL: (shouldForce: boolean) => void;
+  /**
+   * Controls whether `left`/`right` style properties are automatically swapped
+   * in RTL layouts. When enabled, `left` becomes `right` and vice versa.
+   */
   swapLeftAndRightInRTL: (flipStyles: boolean) => void;
+  /** Whether the current layout direction is Right-to-Left. */
   isRTL: I18nManagerConstants["isRTL"];
+  /** Whether left and right style properties are swapped in RTL mode. */
   doLeftAndRightSwapInRTL: I18nManagerConstants["doLeftAndRightSwapInRTL"];
 };
 declare type $$I18nManager = typeof $$I18nManager;