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

package/lib/typescript/components/stack/header/StackHeaderConfig.android.types.d.ts

@@ -1,8 +1,11 @@
 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;
 export interface StackHeaderToolbarSubviewAndroid {
     /**
@@ -69,13 +72,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;
@@ -183,6 +179,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;
@@ -280,6 +279,10 @@ export interface StackHeaderToolbarMenuItemAndroid extends StackHeaderToolbarMen
      * 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
      */
@@ -368,10 +371,8 @@ export interface StackHeaderToolbarMenuAndroid extends StackHeaderToolbarMenuIte
      * `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
      */
@@ -394,7 +395,8 @@ export type StackHeaderToolbarMenuElementOptionsAndroid = Partial<Omit<StackHead
      *
      * @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
      */
@@ -434,11 +436,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.
      */
@@ -458,6 +467,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
@@ -544,6 +556,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.
@@ -554,9 +623,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
      */
@@ -638,7 +708,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).
@@ -648,6 +719,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.
      *
@@ -656,8 +793,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
      */
@@ -674,5 +822,453 @@ 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;
 }
 //# sourceMappingURL=StackHeaderConfig.android.types.d.ts.map