react-native-screens 5.0.0-alpha.2 → 5.0.0-alpha.4

package/src/components/stack/header/StackHeaderConfig.android.types.ts

@@ -1,10 +1,24 @@
 import type { ReactElement } from 'react';
-import type { ColorValue } from 'react-native';
+import type { ColorValue, TextStyle } from 'react-native';
 import type { StackHeaderSubviewCollapseModeAndroid } from './android/StackHeaderSubview.android.types';
 import type { PlatformIconAndroid } from '../../shared/types';
 
 export type StackHeaderTypeAndroid = 'small' | 'medium' | 'large';
 
+export type StackHeaderTitleHorizontalGravityAndroid =
+  | 'start'
+  | 'center'
+  | 'end';
+
+export type StackHeaderTitleVerticalGravityAndroid =
+  | 'top'
+  | 'center'
+  | 'bottom';
+
+export type StackHeaderCollapsedTitleGravityModeAndroid =
+  | 'entireSpace'
+  | 'availableSpace';
+
 export type StackHeaderBackgroundSubviewCollapseModeAndroid =
   StackHeaderSubviewCollapseModeAndroid;
 
@@ -81,13 +95,6 @@ export interface StackHeaderToolbarMenuItemBaseAndroid {
   /**
    * @summary Title of the menu element.
    *
-   * @remarks
-   * If `title` is changed for the element of type `menu` by using the
-   * `updateToolbarMenuElements` view command, the menu title (`menuTitle`)
-   * will also be changed to the new title (unless the new title is set to
-   * `undefined`). In order to keep the custom menu title, you should also
-   * include `menuTitle` in the view command.
-   *
    * @platform android
    */
   title?: string | undefined;
@@ -195,6 +202,9 @@ export interface StackHeaderToolbarMenuItemBaseAndroid {
    * The icon will be visible only if the menu element is shown in the
    * Toolbar.
    *
+   * An icon set via the `updateToolbarMenuElements` view command takes
+   * precedence over this one until the next `toolbarMenu` change.
+   *
    * @platform android
    */
   icon?: PlatformIconAndroid | undefined;
@@ -298,6 +308,10 @@ export interface StackHeaderToolbarMenuItemAndroid
    * The initial state does not trigger `onSelectionChange` on
    * the group at mount time.
    *
+   * A `toolbarMenu` prop change restores the selection to this value.
+   * Neither that restore nor a native header rebuild triggers
+   * `onSelectionChange`.
+   *
    * @default false
    * @platform android
    */
@@ -391,10 +405,8 @@ export interface StackHeaderToolbarMenuAndroid
    * `title`, which controls the label shown in the parent menu's item row.
    *
    * @remarks
-   * If `title` is changed by using the `updateToolbarMenuElements` view
-   * command, the menu title will also be changed to the new title (unless the
-   * new title is set to `undefined`). In order to keep the custom menu title,
-   * you should also include `menuTitle` in the view command.
+   * When left unset, the header falls back to `title`; when both are unset,
+   * the popup shows no header.
    *
    * @platform android
    */
@@ -423,7 +435,8 @@ export type StackHeaderToolbarMenuElementOptionsAndroid = Partial<
    *
    * @description
    * Only applies to `type: 'menu'` elements. Ignored if the target is a regular
-   * menu item.
+   * menu item. Setting it to `undefined` drops the `menuTitle` prop as well,
+   * leaving the header to fall back to `title`.
    *
    * @platform android
    */
@@ -465,11 +478,18 @@ export interface StackHeaderConfigCommandsAndroid {
    * overtaken by an earlier one whose icon happened to load late.
    *
    * @remarks
-   * Updates are applied to the live toolbar: they take effect only while the
-   * header is shown, and are discarded whenever the menu is rebuilt from the
-   * `toolbarMenu` prop — whether by a prop change or a structural change such
-   * as hiding and re-showing the header. They persist across unrelated
-   * re-renders. An update whose `id` is not in the current menu is ignored.
+   * Updates persist for the lifetime of the current `toolbarMenu`
+   * configuration: they survive every native header rebuild — an effective
+   * color scheme change, a header `type`, `maxLines` or
+   * `collapsedTitleGravityMode` change, hiding and re-showing the header,
+   * reattaching the screen (e.g. switching tabs) — and unrelated re-renders.
+   * Updates sent while the header is hidden are recorded — and emit their
+   * selection events — as usual, and take effect when the header is next
+   * shown. Only a `toolbarMenu` prop change resets them, dropping the
+   * batches still queued as well (see its docs). An update whose `id` is not
+   * in the current menu is ignored. An `icon` set via this command takes
+   * precedence over the icon declared in `toolbarMenu` until the next
+   * `toolbarMenu` change.
    *
    * @param updates A single update object or an array of updates.
    */
@@ -494,6 +514,9 @@ export interface StackHeaderConfigPropsAndroid {
    * M3 Expressive headers aren't currently supported (there is no stable
    * `MDC-Android` version yet).
    *
+   * Changing this prop at runtime rebuilds the header. Toolbar menu state
+   * survives the rebuild — see `updateToolbarMenuElements`.
+   *
    * @see {@link https://m3.material.io/components/app-bars/overview|Material Design 3: App bars}
    *
    * @default small
@@ -580,6 +603,63 @@ export interface StackHeaderConfigPropsAndroid {
    * @platform android
    */
   backButtonIcon?: PlatformIconAndroid | undefined;
+  /**
+   * @summary Custom icon for the overflow menu button (the three-dots button
+   * that opens the toolbar menu's overflow popup).
+   *
+   * @description
+   * When `undefined`, the Material 3 Expressive default overflow icon is used.
+   *
+   * Supported values:
+   * - `{ type: 'imageSource', imageSource }`
+   *   Uses an image from the provided resource.
+   *
+   *   Remarks: `imageSource` type doesn't support SVGs on Android.
+   *   For loading SVGs use `drawableResource` type.
+   *
+   * - `{ type: 'drawableResource', name }`
+   *   Uses a drawable resource with the given name.
+   *
+   *   Remarks: Requires passing a drawable to resources via Android Studio.
+   *
+   * @platform android
+   */
+  overflowIcon?: PlatformIconAndroid | undefined;
+  /**
+   * @summary Tint color applied to the overflow menu icon in its normal state.
+   *
+   * @description
+   * When `undefined`, the default tint (the Material theme's menu icon color)
+   * is used. This applies to the default overflow icon and `drawableResource`
+   * icons that have an associated tint. For `imageSource` icons, no tint is
+   * applied by default.
+   *
+   * @platform android
+   */
+  overflowIconTintColorNormal?: ColorValue | undefined;
+  /**
+   * @summary Tint color applied to the overflow menu icon when it is pressed.
+   *
+   * @remarks
+   * Due to native platform limitations, if you set this prop, you must also
+   * provide `overflowIconTintColorNormal`. Otherwise, the icon will become
+   * transparent.
+   *
+   * @platform android
+   */
+  overflowIconTintColorPressed?: ColorValue | undefined;
+  /**
+   * @summary Tint color applied to the overflow menu icon when it is focused
+   * (e.g. by keyboard navigation).
+   *
+   * @remarks
+   * Due to native platform limitations, if you set this prop, you must also
+   * provide `overflowIconTintColorNormal`. Otherwise, the icon will become
+   * transparent.
+   *
+   * @platform android
+   */
+  overflowIconTintColorFocused?: ColorValue | undefined;
   /**
    * @summary Whether the header reacts to nested scroll. Required for any
    * other `scrollFlag*` prop to take effect.
@@ -590,9 +670,10 @@ export interface StackHeaderConfigPropsAndroid {
    * - `medium` / `large` -> `true`
    *
    * @remarks
-   * Changing any `scrollFlag*` at runtime forces the header back to
-   * its fully expanded state, which produces a visible snap. Treat these
-   * props as a static configuration.
+   * Changing any `scrollFlag*` at runtime while the header is partially
+   * collapsed snaps it back to its fully expanded state. A fully collapsed
+   * header stays collapsed, unless the new flags do not allow collapsing at
+   * all - then it expands.
    *
    * @platform android
    */
@@ -674,7 +755,8 @@ export interface StackHeaderConfigPropsAndroid {
    * Material `CollapsingToolbarLayout` uses a fade title-collapse mode that
    * installs its own content scrim and disables the app bar's lift-on-scroll,
    * so this prop has no effect there. The collapsed appearance of those headers
-   * is instead controlled by that content scrim, which is not exposed yet.
+   * is instead controlled by that content scrim — see
+   * {@link scrolledBackgroundColor}.
    *
    * Has no effect while the header is `transparent` (there is no scrolling
    * content behavior installed in that mode).
@@ -684,6 +766,72 @@ export interface StackHeaderConfigPropsAndroid {
    * @platform android
    */
   liftOnScroll?: boolean | undefined;
+  /**
+   * @summary Background color of the header.
+   *
+   * @description
+   * Applies to all header types. For `medium` / `large` headers this is the
+   * color of the expanded state — the collapsed state color is controlled by
+   * {@link scrolledBackgroundColor}.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  backgroundColor?: ColorValue | undefined;
+  /**
+   * @summary Background color of the header when content is scrolled beneath
+   * it.
+   *
+   * @description
+   * For the `small` header, this is the lift-on-scroll target color: when
+   * content is scrolled beneath the app bar, the background animates from
+   * {@link backgroundColor} to this color. Requires {@link liftOnScroll}.
+   *
+   * For `medium` / `large` headers, this is the color of the content scrim
+   * that fades in as the header collapses. The scrim is drawn above the
+   * header background (and the `backgroundSubview`, if any) but below the
+   * toolbar content.
+   *
+   * @remarks
+   * A translucent color is composited over the header background instead of
+   * replacing it.
+   *
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  scrolledBackgroundColor?: ColorValue | undefined;
+  /**
+   * @summary Color of the scrim drawn in the status-bar area, masking header
+   * content that scrolls under the status bar in edge-to-edge apps.
+   *
+   * @description
+   * For the `small` header, the scrim is a constant strip pinned to the top of
+   * the window, drawn above the toolbar content. When not provided, the strip
+   * follows the header's effective background color: {@link backgroundColor} at
+   * rest, animating together with the lift-on-scroll transition towards
+   * {@link scrolledBackgroundColor}. An explicit color is applied statically,
+   * without tracking.
+   *
+   * For `medium` / `large` headers, the scrim fades in and out together with
+   * the content scrim as the header collapses. When not provided, it matches
+   * the content scrim color ({@link scrolledBackgroundColor}).
+   *
+   * Set to `'transparent'` to disable the scrim entirely.
+   *
+   * @remarks
+   * The default scrim is installed only when the color it follows resolves to
+   * a fully opaque color; translucent headers stay see-through. An explicit
+   * translucent color is honored and composites over the header background in
+   * the status-bar area (for `medium` / `large` headers the content scrim is
+   * excluded from that area while a scrim is installed, so the two scrims
+   * never stack).
+   *
+   * @platform android
+   */
+  statusBarScrimColor?: ColorValue | undefined;
   /**
    * @summary Toolbar menu configuration.
    *
@@ -692,8 +840,19 @@ export interface StackHeaderConfigPropsAndroid {
    * want to change some property in runtime, use `updateToolbarMenuElements`
    * view command.
    *
-   * Changing this prop in runtime will result in full toolbar menu rebuild.
-   * Any prior changes applied via `updateToolbarMenuElements` will be lost.
+   * Changing this prop at runtime rebuilds the toolbar menu and resets all
+   * of its runtime state: checkbox/radio selections return to their
+   * `initialToggleState` and every change applied via
+   * `updateToolbarMenuElements` is discarded, including batches still
+   * waiting in the queue (e.g. for an icon download). Any real change
+   * counts, even one only swapping an item's icon; re-sending an identical
+   * menu is a no-op and preserves the state.
+   *
+   * An invalid menu is rejected — for example duplicate item or group ids, a
+   * `groupId` that is not declared at the same menu level, or more than one
+   * `initialToggleState` in a single-selection group. The menu is validated
+   * when the prop is set, and a rejected menu leaves the previous one in
+   * effect.
    *
    * @platform android
    */
@@ -710,4 +869,462 @@ export interface StackHeaderConfigPropsAndroid {
    * @supported API 28 or higher
    */
   toolbarMenuGroupDividerEnabled?: boolean | undefined;
+  /**
+   * @summary Horizontally centers the title within the app bar.
+   *
+   * @remarks
+   * Applies to the `small` header only; ignored for `medium` / `large` (use
+   * `expandedTitleHorizontalGravity` / `collapsedTitleHorizontalGravity`
+   * instead). The title is centered independently of the subtitle. Combining
+   * a centered title with left and/or center subviews is not recommended — they
+   * may overlap or be laid out incorrectly.
+   *
+   * @default false
+   * @platform android
+   */
+  titleCentered?: boolean | undefined;
+  /**
+   * @summary Horizontally centers the subtitle within the app bar.
+   *
+   * @remarks
+   * Applies to the `small` header only. The subtitle is centered independently
+   * of the title. See {@link titleCentered}.
+   *
+   * @default false
+   * @platform android
+   */
+  subtitleCentered?: boolean | undefined;
+  /**
+   * @summary Horizontal alignment of the title (and subtitle) in the expanded
+   * state.
+   *
+   * @remarks
+   * Applies to `medium` / `large` headers only; ignored for `small` (use
+   * `titleCentered` instead). The subtitle always follows the title's
+   * alignment.
+   *
+   * @default start
+   * @platform android
+   */
+  expandedTitleHorizontalGravity?:
+    | StackHeaderTitleHorizontalGravityAndroid
+    | undefined;
+  /**
+   * @summary Vertical alignment of the title (and subtitle) in the expanded
+   * state.
+   *
+   * @remarks
+   * Applies to `medium` / `large` headers only; ignored for `small`.
+   *
+   * @default bottom
+   * @platform android
+   */
+  expandedTitleVerticalGravity?:
+    | StackHeaderTitleVerticalGravityAndroid
+    | undefined;
+  /**
+   * @summary Horizontal alignment of the title (and subtitle) in the collapsed
+   * state.
+   *
+   * @remarks
+   * Applies to `medium` / `large` headers only; ignored for `small`. The
+   * subtitle always follows the title's alignment. `center` is further affected
+   * by `collapsedTitleGravityMode`.
+   *
+   * @default start
+   * @platform android
+   */
+  collapsedTitleHorizontalGravity?:
+    | StackHeaderTitleHorizontalGravityAndroid
+    | undefined;
+  /**
+   * @summary Vertical alignment of the title (and subtitle) in the collapsed
+   * state.
+   *
+   * @remarks
+   * Applies to `medium` / `large` headers only; ignored for `small`.
+   *
+   * @default center
+   * @platform android
+   */
+  collapsedTitleVerticalGravity?:
+    | StackHeaderTitleVerticalGravityAndroid
+    | undefined;
+  /**
+   * @summary Anchor used when resolving the collapsed title's horizontal
+   * gravity.
+   *
+   * @description
+   * The following values are available:
+   * - `availableSpace` - gravity is computed over the space left after the
+   *   navigation icon, menu and subviews are laid out,
+   * - `entireSpace` - gravity is computed over the whole app bar, so a centered
+   *   title is centered relative to the app bar and pushed aside only if it
+   *   would overlap another view.
+   *
+   * @remarks
+   * Applies to `medium` / `large` headers only and affects only the collapsed
+   * state; it is only visually meaningful with
+   * `collapsedTitleHorizontalGravity: 'center'`.
+   *
+   * Because the underlying Material field is set at construction time, changing
+   * this prop rebuilds the header.
+   *
+   * If the header is laid out during a screen transition, due to a native bug,
+   * the title and the subtitle might be laid out incorrectly when `entireSpace`
+   * gravity mode is used.
+   *
+   * @default availableSpace
+   * @platform android
+   */
+  collapsedTitleGravityMode?:
+    | StackHeaderCollapsedTitleGravityModeAndroid
+    | undefined;
+  /**
+   * @summary Maximum number of lines for the expanded title and subtitle.
+   *
+   * @description
+   * A single shared value: the same limit applies to both the expanded title
+   * and the expanded subtitle. Text exceeding the limit is ellipsized.
+   *
+   * @remarks
+   * Applies to `medium` / `large` headers only; ignored for `small`. The
+   * collapsed title is always a single line regardless of this value.
+   *
+   * A value less than `1` is invalid and falls back to `1`.
+   *
+   * Changing this value at runtime rebuilds the header. This is required due to
+   * a native platform limitation.
+   *
+   * @default 1
+   * @platform android
+   */
+  maxLines?: number | undefined;
+  /**
+   * @summary Start inset of the toolbar.
+   *
+   * @description
+   * The inset is a minimum: the navigation icon is positioned before it is
+   * applied and is not bounded by it, so the content area starts at whichever
+   * reaches further from the edge — the navigation icon's trailing edge or this
+   * inset. A back button usually wins, which makes this prop inert while one is
+   * visible.
+   *
+   * @remarks
+   * Applies to all header types. On `medium` / `large` it affects the collapsed
+   * title only.
+   *
+   * By default, native platform applies non-zero inset which makes centered
+   * collapsed title look off-center when `collapsedTitleGravityMode:
+   * 'availableSpace'` is used.
+   *
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  contentInsetStart?: number | undefined;
+  /**
+   * @summary End inset of the toolbar content area.
+   *
+   * @remarks
+   * The end-side counterpart of `contentInsetStart`. Applies to all header
+   * types. Like its start-side counterpart it is a minimum, so it is inert
+   * while the toolbar menu shows items that already reach further in.
+   *
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  contentInsetEnd?: number | undefined;
+  /**
+   * @summary Color of the title text. Applies to `small` header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  titleColor?: ColorValue | undefined;
+  /**
+   * @summary Font family of the title text. Applies to `small` header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  titleFontFamily?: TextStyle['fontFamily'] | undefined;
+  /**
+   * @summary Font size (SP) of the title text. Applies to `small` header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  titleFontSize?: TextStyle['fontSize'] | undefined;
+  /**
+   * @summary Font weight of the title text. Applies to `small` header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  titleFontWeight?: TextStyle['fontWeight'] | undefined;
+  /**
+   * @summary Font style of the title text. Applies to `small` header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  titleFontStyle?: TextStyle['fontStyle'] | undefined;
+  /**
+   * @summary Color of the subtitle text. Applies to `small` header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  subtitleColor?: ColorValue | undefined;
+  /**
+   * @summary Font family of the subtitle text. Applies to `small` header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  subtitleFontFamily?: TextStyle['fontFamily'] | undefined;
+  /**
+   * @summary Font size (SP) of the subtitle text. Applies to `small`
+   * header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  subtitleFontSize?: TextStyle['fontSize'] | undefined;
+  /**
+   * @summary Font weight of the subtitle text. Applies to `small` header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  subtitleFontWeight?: TextStyle['fontWeight'] | undefined;
+  /**
+   * @summary Font style of the subtitle text. Applies to `small` header only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  subtitleFontStyle?: TextStyle['fontStyle'] | undefined;
+  /**
+   * @summary Color of the expanded title text. Applies to `medium` and
+   * `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedTitleColor?: ColorValue | undefined;
+  /**
+   * @summary Font family of the expanded title text. Applies to `medium`
+   * and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedTitleFontFamily?: TextStyle['fontFamily'] | undefined;
+  /**
+   * @summary Font size (SP) of the expanded title text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedTitleFontSize?: TextStyle['fontSize'] | undefined;
+  /**
+   * @summary Font weight of the expanded title text. Applies to `medium`
+   * and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedTitleFontWeight?: TextStyle['fontWeight'] | undefined;
+  /**
+   * @summary Font style of the expanded title text. Applies to `medium`
+   * and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedTitleFontStyle?: TextStyle['fontStyle'] | undefined;
+  /**
+   * @summary Color of the collapsed title text. Applies to `medium` and
+   * `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedTitleColor?: ColorValue | undefined;
+  /**
+   * @summary Font family of the collapsed title text. Applies to `medium`
+   * and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedTitleFontFamily?: TextStyle['fontFamily'] | undefined;
+  /**
+   * @summary Font size (SP) of the collapsed title text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedTitleFontSize?: TextStyle['fontSize'] | undefined;
+  /**
+   * @summary Font weight of the collapsed title text. Applies to `medium`
+   * and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedTitleFontWeight?: TextStyle['fontWeight'] | undefined;
+  /**
+   * @summary Font style of the collapsed title text. Applies to `medium`
+   * and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedTitleFontStyle?: TextStyle['fontStyle'] | undefined;
+  /**
+   * @summary Color of the expanded subtitle text. Applies to `medium`
+   * and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedSubtitleColor?: ColorValue | undefined;
+  /**
+   * @summary Font family of the expanded subtitle text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedSubtitleFontFamily?: TextStyle['fontFamily'] | undefined;
+  /**
+   * @summary Font size (SP) of the expanded subtitle text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedSubtitleFontSize?: TextStyle['fontSize'] | undefined;
+  /**
+   * @summary Font weight of the expanded subtitle text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedSubtitleFontWeight?: TextStyle['fontWeight'] | undefined;
+  /**
+   * @summary Font style of the expanded subtitle text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  expandedSubtitleFontStyle?: TextStyle['fontStyle'] | undefined;
+  /**
+   * @summary Color of the collapsed subtitle text. Applies to `medium`
+   * and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedSubtitleColor?: ColorValue | undefined;
+  /**
+   * @summary Font family of the collapsed subtitle text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedSubtitleFontFamily?: TextStyle['fontFamily'] | undefined;
+  /**
+   * @summary Font size (SP) of the collapsed subtitle text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedSubtitleFontSize?: TextStyle['fontSize'] | undefined;
+  /**
+   * @summary Font weight of the collapsed subtitle text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedSubtitleFontWeight?: TextStyle['fontWeight'] | undefined;
+  /**
+   * @summary Font style of the collapsed subtitle text. Applies to
+   * `medium` and `large` headers only.
+   *
+   * @remarks
+   * If value is not provided, falls back to Material's default.
+   *
+   * @platform android
+   */
+  collapsedSubtitleFontStyle?: TextStyle['fontStyle'] | undefined;
 }