@depup/react-native 0.86.0-depup.49 → 0.87.0-depup.0

package/types_generated/Libraries/Image/ImageProps.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<<ef26bd5137f29a3aed508e9f185f4e0a>>
+ * @generated SignedSource<<c37e4c04ec1c964faaa072452e43f430>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/Image/ImageProps.js
@@ -43,470 +43,420 @@ export type ImagePropsIOS = Readonly<{
   /**
    * A static image to display while loading the image source.
    *
-   * See https://reactnative.dev/docs/image#defaultsource
+   * @platform ios
    */
   defaultSource?: ImageSource | undefined;
   /**
-   * Invoked when a partial load of the image is complete.
+   * Invoked when a partial load of the image is complete. Definition of what
+   * constitutes a "partial load" is loader specific though this is meant for
+   * progressive JPEG loads.
    *
-   * See https://reactnative.dev/docs/image#onpartialload
+   * @platform ios
    */
   onPartialLoad?: (() => void) | undefined;
   /**
-   * Invoked on download progress with `{nativeEvent: {loaded, total}}`.
+   * Invoked on download progress.
    *
-   * See https://reactnative.dev/docs/image#onprogress
+   * @platform ios
    */
   onProgress?: ((event: ImageProgressEventIOS) => void) | undefined;
 }>;
 export type ImagePropsAndroid = Readonly<{
   /**
-   * similarly to `source`, this property represents the resource used to render
-   * the loading indicator for the image, displayed until image is ready to be
-   * displayed, typically after when it got downloaded from network.
+   * Resource used to render a loading indicator for the image, displayed
+   * until the image is ready to be displayed.
+   *
+   * @platform android
    */
   loadingIndicatorSource?: (number | Readonly<ImageURISource>) | undefined;
+  /**
+   * When `true`, enables progressive JPEG streaming.
+   *
+   * @default `false`
+   * @platform android
+   */
   progressiveRenderingEnabled?: boolean | undefined;
+  /**
+   * Duration of the fade-in animation in milliseconds.
+   *
+   * @default `300`
+   * @platform android
+   */
   fadeDuration?: number | undefined;
   /**
-   * The mechanism that should be used to resize the image when the image's dimensions
-   * differ from the image view's dimensions. Defaults to `auto`.
+   * The mechanism that should be used to resize the image when the image's
+   * dimensions differ from the image view's dimensions.
    *
    * - `auto`: Use heuristics to pick between `resize` and `scale`.
    *
-   * - `resize`: A software operation which changes the encoded image in memory before it
-   * gets decoded. This should be used instead of `scale` when the image is much larger
-   * than the view.
-   *
-   * - `scale`: The image gets drawn downscaled or upscaled. Compared to `resize`, `scale` is
-   * faster (usually hardware accelerated) and produces higher quality images. This
-   * should be used if the image is smaller than the view. It should also be used if the
-   * image is slightly bigger than the view.
+   * - `resize`: A software operation which changes the encoded image in memory
+   *   before it gets decoded. This should be used instead of `scale` when the
+   *   image is much larger than the view.
    *
-   * - `none`: No sampling is performed and the image is displayed in its full resolution. This
-   * should only be used in rare circumstances because it is considered unsafe as Android will
-   * throw a runtime exception when trying to render images that consume too much memory.
+   * - `scale`: The image gets drawn downscaled or upscaled. Compared to
+   *   `resize`, `scale` is faster (usually hardware accelerated) and produces
+   *   higher quality images. This should be used if the image is smaller than
+   *   the view. It should also be used if the image is slightly bigger than
+   *   the view.
    *
-   * More details about `resize` and `scale` can be found at http://frescolib.org/docs/resizing-rotating.html.
+   * - `none`: No sampling is performed and the image is displayed in its full
+   *   resolution. This should only be used in rare circumstances because it is
+   *   considered unsafe as Android throws a runtime exception when trying to
+   *   render images that consume too much memory.
    *
+   * @default `'auto'`
    * @platform android
    */
   resizeMethod?: ("auto" | "resize" | "scale" | "none") | undefined;
   /**
-   * When the `resizeMethod` is set to `resize`, the destination dimensions are
+   * When `resizeMethod` is set to `resize`, the destination dimensions are
    * multiplied by this value. The `scale` method is used to perform the
-   * remainder of the resize.
-   * This is used to produce higher quality images when resizing to small dimensions.
-   * Defaults to 1.0.
+   * remainder of the resize. This is used to produce higher quality images
+   * when resizing to small dimensions.
+   *
+   * @default `1.0`
+   * @platform android
    */
   resizeMultiplier?: number | undefined;
 }>;
-export type ImagePropsBase = Readonly<Omit<Omit<ViewProps, "style">, keyof {
+export interface ImagePropsBase extends Readonly<Omit<Omit<ViewProps, "style">, keyof {
   /**
-   * When true, indicates the image is an accessibility element.
-   *
-   * See https://reactnative.dev/docs/image#accessible
+   * When `true`, indicates the image is an accessibility element.
    */
   accessible?: boolean | undefined;
   /**
-   * Internal prop to set an "Analytics Tag" that can will be set on the Image
+   * Internal prop to set an "Analytics Tag" that can will be set on the Image.
    */
   internal_analyticTag?: string | undefined;
   /**
    * The text that's read by the screen reader when the user interacts with
    * the image.
-   *
-   * See https://reactnative.dev/docs/image#accessibilitylabel
    */
   accessibilityLabel?: string | undefined;
   /**
-   * Alias for accessibilityLabel
-   * See https://reactnative.dev/docs/image#accessibilitylabel
+   * Alias for `accessibilityLabel`.
    */
   "aria-label"?: string | undefined;
   /**
-   * Represents the nativeID of the associated label. When the assistive technology focuses on the component with this props.
+   * Represents the `nativeID` of the associated label. When the assistive
+   * technology focuses on the component with this prop.
    *
    * @platform android
    */
   "aria-labelledby"?: string | undefined;
   /**
-   * The text that's read by the screen reader when the user interacts with
-   * the image.
-   *
-   * See https://reactnative.dev/docs/image#alt
+   * Alternative text description of the image, read by the screen reader
+   * when the user interacts with it. Automatically marks the element as
+   * accessible.
    */
   alt?: string | undefined;
   /**
-   * blurRadius: the blur radius of the blur filter added to the image
-   *
-   * See https://reactnative.dev/docs/image#blurradius
+   * The blur radius of the blur filter added to the image. On iOS, needs to
+   * be more than 5.
    */
   blurRadius?: number | undefined;
   /**
-   * See https://reactnative.dev/docs/image#capinsets
+   * When the image is resized, the corners of the size specified by
+   * `capInsets` stay a fixed size, but the center content and borders of
+   * the image are stretched. This is useful for creating resizable rounded
+   * buttons, shadows, and other resizable assets.
+   *
+   * @platform ios
    */
   capInsets?: EdgeInsetsProp | undefined;
   /**
-   * Adds the CORS related header to the request.
-   * Similar to crossorigin from HTML.
+   * CORS mode for fetching the image resource. When unset, the image
+   * request is made without the CORS header.
    *
-   * See https://reactnative.dev/docs/image#crossorigin
+   * @default `'anonymous'`
    */
   crossOrigin?: ("anonymous" | "use-credentials") | undefined;
   /**
    * Height of the image component.
-   *
-   * See https://reactnative.dev/docs/image#height
    */
-  height?: number;
+  height?: number | undefined;
   /**
    * Width of the image component.
-   *
-   * See https://reactnative.dev/docs/image#width
    */
-  width?: number;
+  width?: number | undefined;
   /**
-   * Invoked on load error with `{nativeEvent: {error}}`.
-   *
-   * See https://reactnative.dev/docs/image#onerror
+   * Invoked on load error.
    */
   onError?: ((event: ImageErrorEvent) => void) | undefined;
   /**
-   * onLayout function
-   *
-   * Invoked on mount and layout changes with
-   *
-   * {nativeEvent: { layout: {x, y, width, height} }}.
-   *
-   * See https://reactnative.dev/docs/image#onlayout
+   * Invoked on mount and on layout changes.
    */
-
   onLayout?: ((event: LayoutChangeEvent) => unknown) | undefined;
   /**
    * Invoked when load completes successfully.
-   *
-   * See https://reactnative.dev/docs/image#onload
    */
   onLoad?: ((event: ImageLoadEvent) => void) | undefined;
   /**
    * Invoked when load either succeeds or fails.
-   *
-   * See https://reactnative.dev/docs/image#onloadend
    */
   onLoadEnd?: (() => void) | undefined;
   /**
    * Invoked on load start.
-   *
-   * See https://reactnative.dev/docs/image#onloadstart
    */
   onLoadStart?: (() => void) | undefined;
   /**
    * The image source (either a remote URL or a local file resource).
    *
-   * This prop can also contain several remote URLs, specified together with their width and height and potentially with scale/other URI arguments.
-   * The native side will then choose the best uri to display based on the measured size of the image container.
-   * A cache property can be added to control how networked request interacts with the local cache.
+   * This prop can also contain several remote URLs, specified together with
+   * their width and height and potentially with scale/other URI arguments.
+   * The native side then chooses the best URI to display based on the
+   * measured size of the image container. A `cache` property can be added to
+   * control how networked request interacts with the local cache.
    *
-   * The currently supported formats are png, jpg, jpeg, bmp, gif, webp (Android only), psd (iOS only).
-   *
-   * See https://reactnative.dev/docs/image#source
+   * The currently supported formats are `png`, `jpg`, `jpeg`, `bmp`, `gif`,
+   * `webp` (Android only), and `psd` (iOS only).
    */
   source?: ImageSource | undefined;
   /**
-   * A string indicating which referrer to use when fetching the resource.
-   * Similar to referrerpolicy from HTML.
+   * Which referrer to use when fetching the image resource.
    *
-   * See https://reactnative.dev/docs/image#referrerpolicy
+   * @default `'strict-origin-when-cross-origin'`
    */
   referrerPolicy?: ("no-referrer" | "no-referrer-when-downgrade" | "origin" | "origin-when-cross-origin" | "same-origin" | "strict-origin" | "strict-origin-when-cross-origin" | "unsafe-url") | undefined;
   /**
    * Determines how to resize the image when the frame doesn't match the raw
    * image dimensions.
    *
-   * 'cover': Scale the image uniformly (maintain the image's aspect ratio)
-   * so that both dimensions (width and height) of the image will be equal
-   * to or larger than the corresponding dimension of the view (minus padding).
+   * - `cover`: Scale the image uniformly (maintain the image's aspect ratio)
+   *   so that both dimensions (width and height) of the image are equal to
+   *   or larger than the corresponding dimension of the view (minus padding).
    *
-   * 'contain': Scale the image uniformly (maintain the image's aspect ratio)
-   * so that both dimensions (width and height) of the image will be equal to
-   * or less than the corresponding dimension of the view (minus padding).
+   * - `contain`: Scale the image uniformly (maintain the image's aspect
+   *   ratio) so that both dimensions (width and height) of the image are
+   *   equal to or less than the corresponding dimension of the view (minus
+   *   padding).
    *
-   * 'stretch': Scale width and height independently, This may change the
-   * aspect ratio of the src.
+   * - `stretch`: Scale width and height independently. This may change the
+   *   aspect ratio of the source.
    *
-   * 'repeat': Repeat the image to cover the frame of the view.
-   * The image will keep it's size and aspect ratio. (iOS only)
+   * - `repeat`: Repeat the image to cover the frame of the view. The image
+   *   keeps its size and aspect ratio (iOS only).
    *
-   * 'center': Scale the image down so that it is completely visible,
-   * if bigger than the area of the view.
-   * The image will not be scaled up.
+   * - `center`: Scale the image down so that it is completely visible, if
+   *   bigger than the area of the view. The image is not scaled up.
    *
-   * 'none': Do not resize the image. The image will be displayed at its intrinsic size.
+   * - `none`: Do not resize the image. The image is displayed at its
+   *   intrinsic size.
    *
-   * See https://reactnative.dev/docs/image#resizemode
+   * @default `'cover'`
    */
   resizeMode?: ImageResizeMode | undefined;
-  /**
-   * A unique identifier for this element to be used in UI Automation
-   * testing scripts.
-   *
-   * See https://reactnative.dev/docs/image#testid
-   */
   testID?: string | undefined;
   /**
-   * Changes the color of all the non-transparent pixels to the tintColor.
-   *
-   * See https://reactnative.dev/docs/image#tintcolor
+   * Changes the color of all non-transparent pixels to the `tintColor`.
    */
-  tintColor?: ColorValue;
+  tintColor?: ColorValue | undefined;
   /**
-   * A string representing the resource identifier for the image. Similar to
-   * src from HTML.
-   *
-   * See https://reactnative.dev/docs/image#src
+   * A remote URL string for the image resource. Takes precedence over
+   * `source`.
    */
   src?: string | undefined;
   /**
-   * Similar to srcset from HTML.
-   *
-   * See https://reactnative.dev/docs/image#srcset
+   * Comma-separated list of candidate image sources with pixel density
+   * descriptors.
    */
   srcSet?: string | undefined;
-  children?: never;
-}> & {
+  children?: never | undefined;
+}>> {
   /**
-   * When true, indicates the image is an accessibility element.
-   *
-   * See https://reactnative.dev/docs/image#accessible
+   * When `true`, indicates the image is an accessibility element.
    */
-  accessible?: boolean | undefined;
+  readonly accessible?: boolean | undefined;
   /**
-   * Internal prop to set an "Analytics Tag" that can will be set on the Image
+   * Internal prop to set an "Analytics Tag" that can will be set on the Image.
    */
-  internal_analyticTag?: string | undefined;
+  readonly internal_analyticTag?: string | undefined;
   /**
    * The text that's read by the screen reader when the user interacts with
    * the image.
-   *
-   * See https://reactnative.dev/docs/image#accessibilitylabel
    */
-  accessibilityLabel?: string | undefined;
+  readonly accessibilityLabel?: string | undefined;
   /**
-   * Alias for accessibilityLabel
-   * See https://reactnative.dev/docs/image#accessibilitylabel
+   * Alias for `accessibilityLabel`.
    */
-  "aria-label"?: string | undefined;
+  readonly "aria-label"?: string | undefined;
   /**
-   * Represents the nativeID of the associated label. When the assistive technology focuses on the component with this props.
+   * Represents the `nativeID` of the associated label. When the assistive
+   * technology focuses on the component with this prop.
    *
    * @platform android
    */
-  "aria-labelledby"?: string | undefined;
+  readonly "aria-labelledby"?: string | undefined;
   /**
-   * The text that's read by the screen reader when the user interacts with
-   * the image.
-   *
-   * See https://reactnative.dev/docs/image#alt
+   * Alternative text description of the image, read by the screen reader
+   * when the user interacts with it. Automatically marks the element as
+   * accessible.
    */
-  alt?: string | undefined;
+  readonly alt?: string | undefined;
   /**
-   * blurRadius: the blur radius of the blur filter added to the image
-   *
-   * See https://reactnative.dev/docs/image#blurradius
+   * The blur radius of the blur filter added to the image. On iOS, needs to
+   * be more than 5.
    */
-  blurRadius?: number | undefined;
+  readonly blurRadius?: number | undefined;
   /**
-   * See https://reactnative.dev/docs/image#capinsets
+   * When the image is resized, the corners of the size specified by
+   * `capInsets` stay a fixed size, but the center content and borders of
+   * the image are stretched. This is useful for creating resizable rounded
+   * buttons, shadows, and other resizable assets.
+   *
+   * @platform ios
    */
-  capInsets?: EdgeInsetsProp | undefined;
+  readonly capInsets?: EdgeInsetsProp | undefined;
   /**
-   * Adds the CORS related header to the request.
-   * Similar to crossorigin from HTML.
+   * CORS mode for fetching the image resource. When unset, the image
+   * request is made without the CORS header.
    *
-   * See https://reactnative.dev/docs/image#crossorigin
+   * @default `'anonymous'`
    */
-  crossOrigin?: ("anonymous" | "use-credentials") | undefined;
+  readonly crossOrigin?: ("anonymous" | "use-credentials") | undefined;
   /**
    * Height of the image component.
-   *
-   * See https://reactnative.dev/docs/image#height
    */
-  height?: number;
+  readonly height?: number | undefined;
   /**
    * Width of the image component.
-   *
-   * See https://reactnative.dev/docs/image#width
    */
-  width?: number;
+  readonly width?: number | undefined;
   /**
-   * Invoked on load error with `{nativeEvent: {error}}`.
-   *
-   * See https://reactnative.dev/docs/image#onerror
+   * Invoked on load error.
    */
-  onError?: ((event: ImageErrorEvent) => void) | undefined;
+  readonly onError?: ((event: ImageErrorEvent) => void) | undefined;
   /**
-   * onLayout function
-   *
-   * Invoked on mount and layout changes with
-   *
-   * {nativeEvent: { layout: {x, y, width, height} }}.
-   *
-   * See https://reactnative.dev/docs/image#onlayout
+   * Invoked on mount and on layout changes.
    */
-
-  onLayout?: ((event: LayoutChangeEvent) => unknown) | undefined;
+  readonly onLayout?: ((event: LayoutChangeEvent) => unknown) | undefined;
   /**
    * Invoked when load completes successfully.
-   *
-   * See https://reactnative.dev/docs/image#onload
    */
-  onLoad?: ((event: ImageLoadEvent) => void) | undefined;
+  readonly onLoad?: ((event: ImageLoadEvent) => void) | undefined;
   /**
    * Invoked when load either succeeds or fails.
-   *
-   * See https://reactnative.dev/docs/image#onloadend
    */
-  onLoadEnd?: (() => void) | undefined;
+  readonly onLoadEnd?: (() => void) | undefined;
   /**
    * Invoked on load start.
-   *
-   * See https://reactnative.dev/docs/image#onloadstart
    */
-  onLoadStart?: (() => void) | undefined;
+  readonly onLoadStart?: (() => void) | undefined;
   /**
    * The image source (either a remote URL or a local file resource).
    *
-   * This prop can also contain several remote URLs, specified together with their width and height and potentially with scale/other URI arguments.
-   * The native side will then choose the best uri to display based on the measured size of the image container.
-   * A cache property can be added to control how networked request interacts with the local cache.
-   *
-   * The currently supported formats are png, jpg, jpeg, bmp, gif, webp (Android only), psd (iOS only).
+   * This prop can also contain several remote URLs, specified together with
+   * their width and height and potentially with scale/other URI arguments.
+   * The native side then chooses the best URI to display based on the
+   * measured size of the image container. A `cache` property can be added to
+   * control how networked request interacts with the local cache.
    *
-   * See https://reactnative.dev/docs/image#source
+   * The currently supported formats are `png`, `jpg`, `jpeg`, `bmp`, `gif`,
+   * `webp` (Android only), and `psd` (iOS only).
    */
-  source?: ImageSource | undefined;
+  readonly source?: ImageSource | undefined;
   /**
-   * A string indicating which referrer to use when fetching the resource.
-   * Similar to referrerpolicy from HTML.
+   * Which referrer to use when fetching the image resource.
    *
-   * See https://reactnative.dev/docs/image#referrerpolicy
+   * @default `'strict-origin-when-cross-origin'`
    */
-  referrerPolicy?: ("no-referrer" | "no-referrer-when-downgrade" | "origin" | "origin-when-cross-origin" | "same-origin" | "strict-origin" | "strict-origin-when-cross-origin" | "unsafe-url") | undefined;
+  readonly referrerPolicy?: ("no-referrer" | "no-referrer-when-downgrade" | "origin" | "origin-when-cross-origin" | "same-origin" | "strict-origin" | "strict-origin-when-cross-origin" | "unsafe-url") | undefined;
   /**
    * Determines how to resize the image when the frame doesn't match the raw
    * image dimensions.
    *
-   * 'cover': Scale the image uniformly (maintain the image's aspect ratio)
-   * so that both dimensions (width and height) of the image will be equal
-   * to or larger than the corresponding dimension of the view (minus padding).
-   *
-   * 'contain': Scale the image uniformly (maintain the image's aspect ratio)
-   * so that both dimensions (width and height) of the image will be equal to
-   * or less than the corresponding dimension of the view (minus padding).
+   * - `cover`: Scale the image uniformly (maintain the image's aspect ratio)
+   *   so that both dimensions (width and height) of the image are equal to
+   *   or larger than the corresponding dimension of the view (minus padding).
    *
-   * 'stretch': Scale width and height independently, This may change the
-   * aspect ratio of the src.
+   * - `contain`: Scale the image uniformly (maintain the image's aspect
+   *   ratio) so that both dimensions (width and height) of the image are
+   *   equal to or less than the corresponding dimension of the view (minus
+   *   padding).
    *
-   * 'repeat': Repeat the image to cover the frame of the view.
-   * The image will keep it's size and aspect ratio. (iOS only)
+   * - `stretch`: Scale width and height independently. This may change the
+   *   aspect ratio of the source.
    *
-   * 'center': Scale the image down so that it is completely visible,
-   * if bigger than the area of the view.
-   * The image will not be scaled up.
+   * - `repeat`: Repeat the image to cover the frame of the view. The image
+   *   keeps its size and aspect ratio (iOS only).
    *
-   * 'none': Do not resize the image. The image will be displayed at its intrinsic size.
+   * - `center`: Scale the image down so that it is completely visible, if
+   *   bigger than the area of the view. The image is not scaled up.
    *
-   * See https://reactnative.dev/docs/image#resizemode
-   */
-  resizeMode?: ImageResizeMode | undefined;
-  /**
-   * A unique identifier for this element to be used in UI Automation
-   * testing scripts.
+   * - `none`: Do not resize the image. The image is displayed at its
+   *   intrinsic size.
    *
-   * See https://reactnative.dev/docs/image#testid
+   * @default `'cover'`
    */
-  testID?: string | undefined;
+  readonly resizeMode?: ImageResizeMode | undefined;
+  readonly testID?: string | undefined;
   /**
-   * Changes the color of all the non-transparent pixels to the tintColor.
-   *
-   * See https://reactnative.dev/docs/image#tintcolor
+   * Changes the color of all non-transparent pixels to the `tintColor`.
    */
-  tintColor?: ColorValue;
+  readonly tintColor?: ColorValue | undefined;
   /**
-   * A string representing the resource identifier for the image. Similar to
-   * src from HTML.
-   *
-   * See https://reactnative.dev/docs/image#src
+   * A remote URL string for the image resource. Takes precedence over
+   * `source`.
    */
-  src?: string | undefined;
+  readonly src?: string | undefined;
   /**
-   * Similar to srcset from HTML.
-   *
-   * See https://reactnative.dev/docs/image#srcset
+   * Comma-separated list of candidate image sources with pixel density
+   * descriptors.
    */
-  srcSet?: string | undefined;
-  children?: never;
-}>;
+  readonly srcSet?: string | undefined;
+  readonly children?: never | undefined;
+}
 export type ImageProps = Readonly<Omit<ImagePropsIOS, keyof ImagePropsAndroid | keyof ImagePropsBase | keyof {
   /**
-   * See https://reactnative.dev/docs/image#style
+   * Style applied to the `Image` component.
    */
   style?: ImageStyleProp | undefined;
 }> & Omit<ImagePropsAndroid, keyof ImagePropsBase | keyof {
   /**
-   * See https://reactnative.dev/docs/image#style
+   * Style applied to the `Image` component.
    */
   style?: ImageStyleProp | undefined;
 }> & Omit<ImagePropsBase, keyof {
   /**
-   * See https://reactnative.dev/docs/image#style
+   * Style applied to the `Image` component.
    */
   style?: ImageStyleProp | undefined;
 }> & {
   /**
-   * See https://reactnative.dev/docs/image#style
+   * Style applied to the `Image` component.
    */
   style?: ImageStyleProp | undefined;
 }>;
-export type ImageBackgroundProps = Readonly<Omit<ImageProps, keyof {
-  children?: React.ReactNode;
+export interface ImageBackgroundProps extends Readonly<Omit<ImageProps, keyof {
+  children?: React.ReactNode | undefined;
   /**
-   * Style applied to the outer View component
-   *
-   * See https://reactnative.dev/docs/imagebackground#style
+   * Style applied to the outer `View` wrapper. Accepts `ViewStyle` props
+   * rather than `ImageStyle` props.
    */
   style?: ViewStyleProp | undefined;
   /**
-   * Style applied to the inner Image component
-   *
-   * See https://reactnative.dev/docs/imagebackground#imagestyle
+   * Style applied to the inner `Image` component.
    */
   imageStyle?: ImageStyleProp | undefined;
   /**
-   * Allows to set a reference to the inner Image component
-   *
-   * See https://reactnative.dev/docs/imagebackground#imageref
+   * A ref setter assigned the element node of the inner `Image` component
+   * when mounted.
    */
-  imageRef?: React.Ref<React.ComponentRef<ImageType>>;
-}> & {
-  children?: React.ReactNode;
+  imageRef?: React.Ref<React.ComponentRef<ImageType>> | undefined;
+}>> {
+  readonly children?: React.ReactNode | undefined;
   /**
-   * Style applied to the outer View component
-   *
-   * See https://reactnative.dev/docs/imagebackground#style
+   * Style applied to the outer `View` wrapper. Accepts `ViewStyle` props
+   * rather than `ImageStyle` props.
    */
-  style?: ViewStyleProp | undefined;
+  readonly style?: ViewStyleProp | undefined;
   /**
-   * Style applied to the inner Image component
-   *
-   * See https://reactnative.dev/docs/imagebackground#imagestyle
+   * Style applied to the inner `Image` component.
    */
-  imageStyle?: ImageStyleProp | undefined;
+  readonly imageStyle?: ImageStyleProp | undefined;
   /**
-   * Allows to set a reference to the inner Image component
-   *
-   * See https://reactnative.dev/docs/imagebackground#imageref
+   * A ref setter assigned the element node of the inner `Image` component
+   * when mounted.
    */
-  imageRef?: React.Ref<React.ComponentRef<ImageType>>;
-}>;
+  readonly imageRef?: React.Ref<React.ComponentRef<ImageType>> | undefined;
+}