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

package/types_generated/Libraries/StyleSheet/private/_TransformStyle.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<<a59f6c16b7cdebea1514b789d65d7893>>
+ * @generated SignedSource<<6e5d4efd84c6347588341c7e5da390d4>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/StyleSheet/private/_TransformStyle.js
@@ -60,7 +60,7 @@ export type ____TransformStyle_Internal = Readonly<{
     readonly skewY: string | AnimatedNode;
   } | {
     readonly matrix: ReadonlyArray<number | AnimatedNode> | AnimatedNode;
-  }>>>> | string;
+  }>>>> | string | undefined;
   /**
    * `transformOrigin` accepts an array with 3 elements - each element either being
    * a number, or a string of a number ending with `%`. The last element cannot be
@@ -72,5 +72,5 @@ export type ____TransformStyle_Internal = Readonly<{
    *
    * E.g. transformOrigin: '30% 80% 15px'
    */
-  transformOrigin?: [string | number, string | number, string | number] | string;
+  transformOrigin?: [string | number, string | number, string | number] | string | undefined;
 }>;

package/types_generated/Libraries/Text/Text.d.ts

@@ -4,24 +4,28 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<31638ab56a46d6a56a8501eca5d0a86e>>
+ * @generated SignedSource<<1749c3bc6fb6431e1869804bb0563d61>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Text/Text.js
  */
 
+import type { HostInstance } from "../../src/private/types/HostInstance";
 import type { TextProps } from "./TextProps";
-import { NativeSelectableText, NativeText, NativeVirtualText } from "./TextNativeComponent";
 import * as React from "react";
+export type TextInstance = HostInstance;
 export type { TextProps } from "./TextProps";
-type TextForwardRef = React.ComponentRef<typeof NativeText | typeof NativeVirtualText | typeof NativeSelectableText>;
 declare const TextImpl: (props: Omit<TextProps, keyof {
-  ref?: React.Ref<TextForwardRef>;
+  ref?: React.Ref<TextInstance> | undefined;
 }> & {
-  ref?: React.Ref<TextForwardRef>;
+  ref?: React.Ref<TextInstance> | undefined;
 }) => React.ReactNode;
 /**
- * Text is the fundamental component for displaying text.
+ * A React component for displaying text. `Text` supports nesting, styling,
+ * and touch handling.
+ *
+ * `Text` uses text layout instead of flexbox — elements inside wrap at end of
+ * line rather than being positioned as rectangles.
  *
  * @see https://reactnative.dev/docs/text
  */

package/types_generated/Libraries/Text/TextProps.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<<d8d0d92e5af6acdbd8c0883ad0fff77d>>
+ * @generated SignedSource<<0ce802965263b30a11b75a9742ab3ae7>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Text/TextProps.js
@@ -21,32 +21,39 @@ export type PressRetentionOffset = Readonly<{
   right: number;
 }>;
 type TextPointerEventProps = Readonly<{
-  onPointerEnter?: (event: PointerEvent) => void;
-  onPointerLeave?: (event: PointerEvent) => void;
-  onPointerMove?: (event: PointerEvent) => void;
+  onPointerEnter?: ((event: PointerEvent) => void) | undefined;
+  onPointerLeave?: ((event: PointerEvent) => void) | undefined;
+  onPointerMove?: ((event: PointerEvent) => void) | undefined;
 }>;
 export type TextPropsIOS = {
   /**
-   * Specifies whether font should be scaled down automatically to fit given style constraints.
+   * Whether fonts should be scaled down to fit style constraints.
    *
-   * See https://reactnative.dev/docs/text#adjustsfontsizetofit
+   * @default `false`
+   * @platform ios
    */
   adjustsFontSizeToFit?: boolean | undefined;
   /**
-   * The Dynamic Type scale ramp to apply to this element on iOS.
+   * The [Dynamic Type](https://developer.apple.com/documentation/uikit/uifont/textstyle)
+   * ramp to apply.
+   *
+   * @default `'body'`
+   * @platform ios
    */
   dynamicTypeRamp?: ("caption2" | "caption1" | "footnote" | "subheadline" | "callout" | "body" | "headline" | "title3" | "title2" | "title1" | "largeTitle") | undefined;
   /**
    * When `true`, no visual change is made when text is pressed down. By
    * default, a gray oval highlights the text on press down.
    *
-   * See https://reactnative.dev/docs/text#supperhighlighting
+   * @default `false`
+   * @platform ios
    */
   suppressHighlighting?: boolean | undefined;
   /**
-   * Set line break strategy on iOS.
+   * Line break strategy on iOS.
    *
-   * See https://reactnative.dev/docs/text.html#linebreakstrategyios
+   * @default `'none'`
+   * @platform ios
    */
   lineBreakStrategyIOS?: ("none" | "standard" | "hangul-word" | "push-out") | undefined;
 };
@@ -54,129 +61,89 @@ export type TextPropsAndroid = {
   /**
    * Specifies the disabled state of the text view for testing purposes.
    *
-   * See https://reactnative.dev/docs/text#disabled
+   * @platform android
    */
   disabled?: boolean | undefined;
   /**
-   * The highlight color of the text.
+   * Highlight color of the text when selected.
    *
-   * See https://reactnative.dev/docs/text#selectioncolor
+   * @platform android
    */
   selectionColor?: ColorValue | undefined;
   /**
-   * Determines the types of data converted to clickable URLs in the text element.
-   * By default no data types are detected.
+   * Types of data converted to clickable URLs in the text element.
+   *
+   * @default `'none'`
+   * @platform android
    */
   dataDetectorType?: ("phoneNumber" | "link" | "email" | "none" | "all") | undefined;
   /**
-   * Set text break strategy on Android API Level 23+
-   * default is `highQuality`.
+   * Text break strategy on Android.
    *
-   * See https://reactnative.dev/docs/text#textbreakstrategy
+   * @default `'highQuality'`
+   * @platform android
    */
   textBreakStrategy?: ("balanced" | "highQuality" | "simple") | undefined;
-  /**
-   * iOS Only
-   */
   adjustsFontSizeToFit?: boolean | undefined;
   /**
-   * Specifies smallest possible scale a font can reach when adjustsFontSizeToFit is enabled. (values 0.01-1.0).
+   * Smallest possible font scale when `adjustsFontSizeToFit` is enabled
+   * (values 0.01-1.0).
    *
-   * See https://reactnative.dev/docs/text#minimumfontscale
+   * @platform ios
    */
   minimumFontScale?: number | undefined;
 };
 type TextBaseProps = Readonly<{
   onAccessibilityAction?: ((event: AccessibilityActionEvent) => unknown) | undefined;
+  /**
+   * Controls whether the `Text` can be the target of touch events.
+   */
+  pointerEvents?: ("auto" | "box-none" | "box-only" | "none") | undefined;
   /**
    * Whether fonts should scale to respect Text Size accessibility settings.
-   * The default is `true`.
    *
-   * See https://reactnative.dev/docs/text#allowfontscaling
+   * @default `true`
    */
   allowFontScaling?: boolean | undefined;
   /**
-   * Set hyphenation strategy on Android.
+   * Sets automatic hyphenation frequency.
    *
+   * @default `'none'`
+   * @platform android
    */
   android_hyphenationFrequency?: ("normal" | "none" | "full") | undefined;
   children?: React.ReactNode | undefined;
   /**
-   * When `numberOfLines` is set, this prop defines how text will be
-   * truncated.
-   *
-   * This can be one of the following values:
-   *
-   * - `head` - The line is displayed so that the end fits in the container and the missing text
-   * at the beginning of the line is indicated by an ellipsis glyph. e.g., "...wxyz"
-   * - `middle` - The line is displayed so that the beginning and end fit in the container and the
-   * missing text in the middle is indicated by an ellipsis glyph. "ab...yz"
-   * - `tail` - The line is displayed so that the beginning fits in the container and the
-   * missing text at the end of the line is indicated by an ellipsis glyph. e.g., "abcd..."
-   * - `clip` - Lines are not drawn past the edge of the text container.
-   *
-   * The default is `tail`.
+   * How text is truncated when `numberOfLines` is set. On Android with
+   * `numberOfLines` greater than 1, only `'tail'` works correctly.
    *
-   * `numberOfLines` must be set in conjunction with this prop.
-   *
-   * > `clip` is working only for iOS
-   *
-   * See https://reactnative.dev/docs/text#ellipsizemode
+   * @default `'tail'`
    */
   ellipsizeMode?: ("clip" | "head" | "middle" | "tail") | undefined;
+  id?: string | undefined;
   /**
-   * Used to reference react managed views 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
+   * Largest possible font scale when `allowFontScaling` is enabled.
+   * `null`/`undefined` inherits from the parent node or the global default (0).
+   * `0` means no max (ignores parent/global default). `>= 1` sets the
+   * `maxFontSizeMultiplier` of this node to this value.
    */
   maxFontSizeMultiplier?: number | undefined;
-  /**
-   * Used to locate this view from native code.
-   *
-   * See https://reactnative.dev/docs/text#nativeid
-   */
   nativeID?: string | undefined;
   /**
-   * Used to truncate the text with an ellipsis after computing the text
-   * layout, including line wrapping, such that the total number of lines
-   * does not exceed this number.
-   *
-   * This prop is commonly used with `ellipsizeMode`.
+   * Truncate text with an ellipsis after this many lines. `0` means no
+   * restriction.
    *
-   * See https://reactnative.dev/docs/text#numberoflines
+   * @default `0`
    */
   numberOfLines?: number | undefined;
-  /**
-   * Invoked on mount and layout changes.
-   *
-   * {nativeEvent: { layout: {x, y, width, height}}}.
-   *
-   * See https://reactnative.dev/docs/text#onlayout
-   */
   onLayout?: ((event: LayoutChangeEvent) => unknown) | undefined;
-  /**
-   * This function is called on long press.
-   * e.g., `onLongPress={this.increaseSize}>`
-   *
-   * See https://reactnative.dev/docs/text#onlongpress
-   */
+  /** Called on long press. */
   onLongPress?: ((event: GestureResponderEvent) => unknown) | undefined;
-  /**
-   * This function is called on press.
-   * Text intrinsically supports press handling with a default highlight state (which can be disabled with suppressHighlighting).
-   *
-   * See https://reactnative.dev/docs/text#onpress
-   */
+  /** Called on press, triggered after `onPressOut`. */
   onPress?: ((event: GestureResponderEvent) => unknown) | undefined;
+  /** Called immediately when a touch is engaged. */
   onPressIn?: ((event: GestureResponderEvent) => unknown) | undefined;
+  /** Called when a touch is released. */
   onPressOut?: ((event: GestureResponderEvent) => unknown) | undefined;
   onResponderGrant?: ((event: GestureResponderEvent) => void) | undefined;
   onResponderMove?: ((event: GestureResponderEvent) => void) | undefined;
@@ -185,12 +152,11 @@ type TextBaseProps = Readonly<{
   onResponderTerminationRequest?: (() => boolean) | undefined;
   onStartShouldSetResponder?: (() => boolean) | undefined;
   onMoveShouldSetResponder?: (() => boolean) | undefined;
+  /** Invoked on text layout change. */
   onTextLayout?: ((event: TextLayoutEvent) => unknown) | undefined;
   /**
    * Defines how far your touch may move off of the button, before
    * deactivating the button.
-   *
-   * See https://reactnative.dev/docs/text#pressretentionoffset
    */
   pressRetentionOffset?: PressRetentionOffset | undefined;
   /**
@@ -198,23 +164,12 @@ type TextBaseProps = Readonly<{
    */
   role?: Role | undefined;
   /**
-   * Lets the user select text.
+   * Lets the user select text for native copy and paste.
    *
-   * See https://reactnative.dev/docs/text#selectable
+   * @default `false`
    */
   selectable?: boolean | undefined;
-  /**
-   * @see https://reactnative.dev/docs/text#style
-   */
   style?: TextStyleProp | undefined;
-  /**
-   * Used to locate this view in end-to-end tests.
-   *
-   * See https://reactnative.dev/docs/text#testid
-   */
   testID?: string | undefined;
 }>;
-/**
- * @see https://reactnative.dev/docs/text#reference
- */
-export type TextProps = Readonly<Omit<TextPointerEventProps, keyof TextPropsIOS | keyof TextPropsAndroid | keyof TextBaseProps | keyof AccessibilityProps | keyof {}> & Omit<TextPropsIOS, keyof TextPropsAndroid | keyof TextBaseProps | keyof AccessibilityProps | keyof {}> & Omit<TextPropsAndroid, keyof TextBaseProps | keyof AccessibilityProps | keyof {}> & Omit<TextBaseProps, keyof AccessibilityProps | keyof {}> & Omit<AccessibilityProps, keyof {}> & {}>;
+export interface TextProps extends Readonly<Omit<TextPointerEventProps, keyof TextPropsIOS | keyof TextPropsAndroid | keyof TextBaseProps | keyof AccessibilityProps | keyof {}> & Omit<TextPropsIOS, keyof TextPropsAndroid | keyof TextBaseProps | keyof AccessibilityProps | keyof {}> & Omit<TextPropsAndroid, keyof TextBaseProps | keyof AccessibilityProps | keyof {}> & Omit<TextBaseProps, keyof AccessibilityProps | keyof {}> & Omit<AccessibilityProps, keyof {}>> {}

package/types_generated/Libraries/TurboModule/RCTExport.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<<654f6446016351de4614a9cd0f8d47ce>>
+ * @generated SignedSource<<d129f41846a6af6fd928908dcad92b6f>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/TurboModule/RCTExport.js
@@ -29,7 +29,7 @@
  */
 
 export interface DEPRECATED_RCTExport<T extends void = void> {
-  readonly getConstants?: () => {};
+  readonly getConstants?: (() => {}) | undefined;
 }
 export interface TurboModule extends DEPRECATED_RCTExport<void> {}
 export type { RootTag } from "../Types/RootTagTypes.js";

package/types_generated/Libraries/Types/CoreEventTypes.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<<4da3aadedac8d4a8ac1051dfab06b9f2>>
+ * @generated SignedSource<<5108c866e2d2ff8cc72ab0892dff41fe>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Types/CoreEventTypes.js
@@ -90,6 +90,12 @@ export type TextLayoutLine = Readonly<Omit<LayoutRectangle, keyof {
 export type LayoutChangeEvent = NativeSyntheticEvent<Readonly<{
   layout: LayoutRectangle;
 }>>;
+/**
+ * @deprecated Use `TextLayoutEvent` instead.
+ */
+/**
+ * @deprecated Use `TextLayoutEvent` instead.
+ */
 type TextLayoutEventData = Readonly<{
   lines: Array<TextLayoutLine>;
 }>;
@@ -236,7 +242,7 @@ export type NativeTouchEvent = Readonly<{
    * 3D Touch reported force
    * @platform ios
    */
-  force?: number;
+  force?: number | undefined;
   /**
    * The ID of the touch
    */
@@ -294,13 +300,13 @@ export type NativeScrollEvent = Readonly<{
   contentOffset: NativeScrollPoint;
   contentSize: NativeScrollSize;
   layoutMeasurement: NativeScrollSize;
-  velocity?: NativeScrollVelocity;
-  zoomScale?: number;
-  responderIgnoreScroll?: boolean;
+  velocity?: NativeScrollVelocity | undefined;
+  zoomScale?: number | undefined;
+  responderIgnoreScroll?: boolean | undefined;
   /**
    * @platform ios
    */
-  targetContentOffset?: NativeScrollPoint;
+  targetContentOffset?: NativeScrollPoint | undefined;
 }>;
 export type ScrollEvent = NativeSyntheticEvent<NativeScrollEvent>;
 export type TargetedEvent = Readonly<{
@@ -334,12 +340,12 @@ export type KeyEvent = Readonly<{
    * A boolean value that is true if the given key is being held down such that it is automatically repeating.
    * @see https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/repeat
    */
-  repeat?: boolean;
+  repeat?: boolean | undefined;
   /**
    * Returns a boolean value indicating if the event is fired within a composition session
    * @see https://developer.mozilla.org/en-US/docs/Web/API/CompositionEvent/isComposing
    */
-  isComposing?: boolean;
+  isComposing?: boolean | undefined;
 }>;
 export type KeyUpEvent = NativeSyntheticEvent<KeyEvent>;
 export type KeyDownEvent = NativeSyntheticEvent<KeyEvent>;

package/types_generated/Libraries/Utilities/Appearance.d.ts

@@ -4,28 +4,40 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<973777f7e7b81f89c3a18fe80b4e24b0>>
+ * @generated SignedSource<<fc35ca9d6dba58fbebac115111ea5de0>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Utilities/Appearance.js
  */
 
 import type { EventSubscription } from "../vendor/emitter/EventEmitter";
-import type { AppearancePreferences, ColorSchemeName } from "./NativeAppearance";
-export type { AppearancePreferences };
+import type { ColorSchemeName, ColorSchemeOverride } from "./NativeAppearance";
+export type { ColorSchemeName, ColorSchemeOverride };
+export type AppearancePreferences = {
+  colorScheme: ColorSchemeName | null;
+};
 /**
- * Returns the current color scheme preference. This value may change, so the
- * value should not be cached without either listening to changes or using
- * the `useColorScheme` hook.
+ * Returns the active color scheme (`'light'` or `'dark'`). This value may
+ * change at runtime, either at the system level (e.g. scheduled color scheme
+ * change at sunrise or sunset) or when overridden at the app level via
+ * `setColorScheme()`.
+ *
+ * Prefer `useColorScheme()` in React components.
+ *
+ * Notes:
+ * - `null` will only be returned if the native Appearance module is unavailable
+ *   (out of tree platforms).
  */
-export declare function getColorScheme(): null | undefined | ColorSchemeName;
+export declare function getColorScheme(): ColorSchemeName | null;
 /**
- * Updates the current color scheme to the supplied value.
+ * Force the application to always adopt a light or dark interface style. Pass
+ * `'auto'` to reset and follow the system default (removes any override).
+ * This does not affect the system UI, only the application.
  */
-export declare function setColorScheme(colorScheme: ColorSchemeName): void;
+export declare function setColorScheme(colorScheme: ColorSchemeOverride): void;
 /**
- * Add an event handler that is fired when appearance preferences change.
+ * Subscribe to color scheme changes. The listener receives the new appearance
+ * preferences whenever the color scheme changes, whether from a system event
+ * or a call to `setColorScheme()`.
  */
-export declare function addChangeListener(listener: ($$PARAM_0$$: {
-  colorScheme: ColorSchemeName | undefined;
-}) => void): EventSubscription;
+export declare function addChangeListener(listener: (preferences: AppearancePreferences) => void): EventSubscription;

package/types_generated/Libraries/Utilities/BackHandler.d.ts

@@ -4,13 +4,18 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<ffb7c8fc1d5ecb2abb92291338cb7144>>
+ * @generated SignedSource<<052dcf752ab637296040b0f00b22cf85>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Utilities/BackHandler.js.flow
  */
 
 export type BackPressEventName = "backPress" | "hardwareBackPress";
+/**
+ * Event dispatched when the hardware back button is pressed.
+ * The `timeStamp` property reflects the native timestamp captured
+ * when the back press was emitted.
+ */
 export interface HardwareBackPressEvent {
   readonly type: string;
   readonly timeStamp: number;
@@ -22,6 +27,17 @@ type TBackHandler = {
   };
 };
 declare const BackHandler: TBackHandler;
+/**
+ * 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
+ */
 declare const $$BackHandler: typeof BackHandler;
 declare type $$BackHandler = typeof $$BackHandler;
 export default $$BackHandler;

package/types_generated/Libraries/Utilities/DevSettings.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<<cd56eca2d7e1cb1fbd6902e04ad9a2f9>>
+ * @generated SignedSource<<cdcfe35ae8c7017de20fe2321033fa24>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Utilities/DevSettings.js
@@ -24,10 +24,17 @@ declare let DevSettings: {
    * @param reason
    */
   reload(reason?: string): void;
+  /**
+   * Notify the native side that a Fast Refresh has occurred.
+   */
   onFastRefresh(): void;
 };
 /**
- * The DevSettings module exposes methods for customizing settings for developers in development.
+ * The `DevSettings` module exposes methods for customizing settings for
+ * developers in development mode. This module is a no-op in production
+ * builds.
+ *
+ * @see https://reactnative.dev/docs/devsettings
  */
 declare const $$DevSettings: typeof DevSettings;
 declare type $$DevSettings = typeof $$DevSettings;

package/types_generated/Libraries/Utilities/Dimensions.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<<2e4a7a54bd52073009b34dc474d51913>>
+ * @generated SignedSource<<7471aa3da6bb64a8be4de0a5dd5bec8a>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Utilities/Dimensions.js
@@ -15,18 +15,23 @@ import { type DimensionsPayload, type DisplayMetrics, type DisplayMetricsAndroid
 export type { DimensionsPayload, DisplayMetrics, DisplayMetricsAndroid };
 /** @deprecated Use DisplayMetrics */
 export type ScaledSize = DisplayMetrics;
+/**
+ * Provides the application window's width and height. Prefer
+ * `useWindowDimensions` in React components.
+ *
+ * @see https://reactnative.dev/docs/dimensions
+ */
 declare class Dimensions {
   /**
-   * NOTE: `useWindowDimensions` is the preferred API for React components.
+   * Returns the current dimensions for `'window'` or `'screen'`. On Android,
+   * `'window'` dimensions exclude the status bar and navigation bar.
    *
-   * 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: `useWindowDimensions` is the preferred API for React components.
    *
-   * 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`).
+   * 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.
    *
    * Example: `const {height, width} = Dimensions.get('window');`
    *
@@ -44,10 +49,11 @@ declare class Dimensions {
   /**
    * Add an event handler. Supported events:
    *
-   * - `change`: Fires when a property within the `Dimensions` object changes. The argument
-   *   to the event handler is an object with `window` and `screen` properties whose values
-   *   are the same as the return values of `Dimensions.get('window')` and
-   *   `Dimensions.get('screen')`, respectively.
+   * - `change`: Fires when a property within the `Dimensions` object changes,
+   *   such as on device rotation or foldable device state changes. The argument
+   *   to the event handler is a `DimensionsPayload` object with `window` and
+   *   `screen` properties whose values are the same as the return values of
+   *   `Dimensions.get('window')` and `Dimensions.get('screen')`, respectively.
    */
   static addEventListener(type: "change", handler: Function): EventSubscription;
 }

package/types_generated/Libraries/Utilities/PixelRatio.d.ts

@@ -4,14 +4,14 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<2efc1c34b33064bf09d0aa2a68105cf6>>
+ * @generated SignedSource<<06730ea4b97e51b757153d2e553f34df>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Utilities/PixelRatio.js
  */
 
 /**
- * PixelRatio class gives access to the device pixel density.
+ * Provides access to the device's pixel density and font scale.
  *
  * ## Fetching a correctly sized image
  *
@@ -19,7 +19,9 @@
  * device. A good rule of thumb is to multiply the size of the image you display
  * by the pixel ratio.
  *
- * ```
+ * Example:
+ *
+ * ```tsx
  * var image = getImage({
  *   width: PixelRatio.getPixelSizeForLayoutSize(200),
  *   height: PixelRatio.getPixelSizeForLayoutSize(100),
@@ -53,6 +55,7 @@
  * rounding is done relative to the root rather than the parent, again to avoid
  * accumulating rounding errors.
  *
+ * @see https://reactnative.dev/docs/pixelratio
  */
 declare class PixelRatio {
   /**

package/types_generated/Libraries/Utilities/Platform.d.ts

@@ -4,13 +4,17 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<b15fc15091a678dad4a314e406db84a9>>
+ * @generated SignedSource<<82fb2905bce742b135187c8fa1b1be85>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Utilities/Platform.js.flow
  */
 
 import type { PlatformType } from "./PlatformTypes";
+/**
+ * Provides information about the platform the app is running on and utility
+ * methods for platform-specific logic.
+ */
 declare const $$Platform: PlatformType;
 declare type $$Platform = typeof $$Platform;
 export default $$Platform;