react-native-screens 4.25.0-beta.1 → 4.25.0-beta.2

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

@@ -5,29 +5,204 @@ import type { PlatformIconAndroid } from '../../../../types';
 export type StackHeaderTypeAndroid = 'small' | 'medium' | 'large';
 export type StackHeaderBackgroundSubviewCollapseModeAndroid = StackHeaderSubviewCollapseModeAndroid;
 export interface StackHeaderToolbarSubviewAndroid {
-    Component: ReactNode;
+    /**
+     * @summary The React component rendered in this toolbar slot.
+     *
+     * The subview is sized by React Native's layout engine but positioned by the
+     * platform native layout. Each subview is placed independently — subviews do
+     * not participate in a shared flex layout and cannot influence each other's
+     * sizing.
+     *
+     *
+     * @remarks
+     * Intrinsic sizing and explicit dimensions work as expected. Avoid
+     * parent-relative sizing (e.g. `flex: 1`) on the root element — it will
+     * produce incorrect dimensions. Flex layout within a root that has a known
+     * size works as expected.
+     *
+     * @platform android
+     */
+    Component: NonNullable<ReactNode>;
 }
 export interface StackHeaderBackgroundSubviewAndroid {
+    /**
+     * @summary Controls how the background subview behaves when the app bar
+     * collapses.
+     *
+     * The following values are available:
+     * - `off` - the subview scrolls away with the app bar,
+     * - `parallax` - the subview scrolls at a slower rate, creating a parallax
+     *   effect.
+     *
+     * @remarks
+     * `pin` is not currently supported because the background subview is
+     * stretched to match the entire `AppBarLayout`, which causes pinned content
+     * to move immediately rather than staying fixed. Support for `pin` collapse
+     * mode might be added in the future.
+     *
+     * @default off
+     *
+     * @platform android
+     */
     collapseMode?: StackHeaderSubviewCollapseModeAndroid | undefined;
-    Component: ReactNode;
+    /**
+     * @summary The React component rendered as the header background.
+     *
+     * The subview is stretched to match the header (`AppBarLayout`) dimensions,
+     * so parent-relative sizing (e.g. `flex: 1`) works correctly.
+     *
+     * @platform android
+     */
+    Component: NonNullable<ReactNode>;
 }
 export interface StackHeaderConfigPropsAndroid {
+    /**
+     * @summary Specifies the type of the Material 3 app bar.
+     *
+     * The following values are available:
+     * - `small` - small app bar with fixed title,
+     * - `medium` - medium app bar with collapsing title,
+     * - `large` - large app bar with collapsing title.
+     *
+     * @remarks
+     * M3 Expressive headers aren't currently supported (there is no stable
+     * `MDC-Android` version yet).
+     *
+     * @see {@link https://m3.material.io/components/app-bars/overview|Material Design 3: App bars}
+     *
+     * @default small
+     *
+     * @platform android
+     */
     type?: StackHeaderTypeAndroid | undefined;
+    /**
+     * @summary Custom view rendered behind the header content.
+     *
+     * @platform android
+     */
     backgroundSubview?: StackHeaderBackgroundSubviewAndroid | undefined;
+    /**
+     * @summary Custom view placed in the leading (start) slot of the toolbar.
+     *
+     * @platform android
+     */
     leadingSubview?: StackHeaderToolbarSubviewAndroid | undefined;
+    /**
+     * @summary Custom view placed in the center slot of the toolbar.
+     *
+     * @platform android
+     */
     centerSubview?: StackHeaderToolbarSubviewAndroid | undefined;
+    /**
+     * @summary Custom view placed in the trailing (end) slot of the toolbar.
+     *
+     * @platform android
+     */
     trailingSubview?: StackHeaderToolbarSubviewAndroid | undefined;
     /**
-     * Tint color for the back button icon.
-     * - `undefined` — use default tint (for custom images, no tint is applied)
-     * - `ColorValue` — apply a custom tint color
+     * @summary Tint color applied to the back button icon.
+     *
+     * When `undefined`, the default tint color is used. This applies to the
+     * native back arrow and `drawableResource` icons that have an associated
+     * tint. For `imageSource` icons, no tint is applied by default.
+     *
+     * @platform android
      */
     backButtonTintColor?: ColorValue | undefined;
     /**
-     * Custom icon for the back button.
-     * - `undefined` — use the native default back arrow
-     * - `PlatformIconAndroid` — use a custom icon (drawableResource or imageSource)
+     * @summary Custom icon for the back button.
+     *
+     * When `undefined`, the native back arrow (`homeAsUpIndicator`) 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
      */
     backButtonIcon?: PlatformIconAndroid | undefined;
+    /**
+     * @summary Whether the header reacts to nested scroll. Required for any
+     * other `scrollFlag*` prop to take effect.
+     *
+     * When `undefined`, falls back to the type-specific default:
+     * - `small` -> `false`
+     * - `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.
+     *
+     * @platform android
+     */
+    scrollFlagScroll?: boolean | undefined;
+    /**
+     * @summary When enabled, the header re-expands as soon as the user scrolls
+     * back toward the top of the content, regardless of the ScrollView's current
+     * scroll position. Without this flag, the header only begins expanding once
+     * the list has reached the top of its content. Requires `scrollFlagScroll`.
+     *
+     * When `undefined`, falls back to the type-specific default (`false` for
+     * all types).
+     *
+     * @platform android
+     */
+    scrollFlagEnterAlways?: boolean | undefined;
+    /**
+     * @summary Modifies `scrollFlagEnterAlways` so that the initial re-entry
+     * stops at the header's collapsed height (the toolbar); the remainder
+     * expands only after the ScrollView reaches the top of its content. Requires
+     * `scrollFlagEnterAlways`.
+     *
+     * When `undefined`, falls back to the type-specific default (`false` for
+     * all types).
+     *
+     * @remarks
+     * This flag does not have any effect for `small` header.
+     *
+     * @platform android
+     */
+    scrollFlagEnterAlwaysCollapsed?: boolean | undefined;
+    /**
+     * @summary When enabled, the header collapses only until its minimum height
+     * (the toolbar) remains pinned at the top. Without this flag, the entire
+     * header scrolls off the screen. Requires `scrollFlagScroll`.
+     *
+     * When `undefined`, falls back to the type-specific default:
+     * - `small` -> `false`
+     * - `medium` / `large` -> `true`
+     *
+     * @remarks
+     * Setting this flag for `small` header is equivalent to disabling
+     * `scrollFlagScroll`.
+     *
+     * Even when this flag is disabled, a strip with the height of the system top
+     * inset (status bar and display cutout) remains visible at the top.
+     *
+     * @platform android
+     */
+    scrollFlagExitUntilCollapsed?: boolean | undefined;
+    /**
+     * @summary When enabled, the header snaps to its nearest edge (fully
+     * expanded, or fully collapsed as defined by `scrollFlagExitUntilCollapsed`)
+     * after a scroll gesture ends, instead of resting partway. Requires
+     * `scrollFlagScroll`.
+     *
+     * When `undefined`, falls back to the type-specific default:
+     * - `small` -> `false`
+     * - `medium` / `large` -> `true`
+     *
+     * @platform android
+     */
+    scrollFlagSnap?: boolean | undefined;
 }
 //# sourceMappingURL=StackHeaderConfig.android.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StackHeaderConfig.android.types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/gamma/stack/header/StackHeaderConfig.android.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,4CAA4C,CAAC;AACxG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE,MAAM,MAAM,+CAA+C,GACzD,qCAAqC,CAAC;AAExC,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,mCAAmC;IAClD,YAAY,CAAC,EAAE,qCAAqC,GAAG,SAAS,CAAC;IACjE,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC1C,iBAAiB,CAAC,EAAE,mCAAmC,GAAG,SAAS,CAAC;IACpE,cAAc,CAAC,EAAE,gCAAgC,GAAG,SAAS,CAAC;IAC9D,aAAa,CAAC,EAAE,gCAAgC,GAAG,SAAS,CAAC;IAC7D,eAAe,CAAC,EAAE,gCAAgC,GAAG,SAAS,CAAC;IAC/D;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7C;;;;OAIG;IACH,cAAc,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAClD"}
+{"version":3,"file":"StackHeaderConfig.android.types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/gamma/stack/header/StackHeaderConfig.android.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,4CAA4C,CAAC;AACxG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE,MAAM,MAAM,+CAA+C,GACzD,qCAAqC,CAAC;AAExC,MAAM,WAAW,gCAAgC;IAC/C;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mCAAmC;IAClD;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CAAC,EAAE,qCAAqC,GAAG,SAAS,CAAC;IACjE;;;;;;;OAOG;IACH,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC1C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,mCAAmC,GAAG,SAAS,CAAC;IACpE;;;;OAIG;IACH,cAAc,CAAC,EAAE,gCAAgC,GAAG,SAAS,CAAC;IAC9D;;;;OAIG;IACH,aAAa,CAAC,EAAE,gCAAgC,GAAG,SAAS,CAAC;IAC7D;;;;OAIG;IACH,eAAe,CAAC,EAAE,gCAAgC,GAAG,SAAS,CAAC;IAC/D;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7C;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACjD;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC;;;;;;;;;;OAUG;IACH,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C;;;;;;;;;;;;;OAaG;IACH,8BAA8B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrD;;;;;;;;;;;;;;;;;OAiBG;IACH,4BAA4B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnD;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC"}

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

@@ -1,9 +1,46 @@
 import { StackHeaderConfigPropsAndroid } from './StackHeaderConfig.android.types';
 import { StackHeaderConfigPropsIOS } from './StackHeaderConfig.ios.types';
 export interface StackHeaderConfigPropsBase {
+    /**
+     * @summary Title displayed in the header.
+     *
+     * @platform android, ios
+     */
     title?: string | undefined;
+    /**
+     * @summary Specifies if the header should be hidden.
+     *
+     * @default false
+     *
+     * @platform android, ios
+     */
     hidden?: boolean | undefined;
+    /**
+     * @summary Specifies if the content should be rendered behind the header.
+     *
+     * When `true`, content is rendered behind the header instead of starting
+     * below it.
+     *
+     * On Android:
+     * - The header background color is not affected by this prop.
+     * - Setting this prop to `true` is not supported when header scrolling is
+     *   enabled.
+     *
+     * @default false
+     *
+     * @platform android, ios
+     */
     transparent?: boolean | undefined;
+    /**
+     * @summary Specifies if the back button should be hidden.
+     *
+     * This prop does not apply to the root screen of the stack for which the back
+     * button is always hidden.
+     *
+     * @default false
+     *
+     * @platform android, ios
+     */
     backButtonHidden?: boolean | undefined;
 }
 export interface StackHeaderConfigProps extends StackHeaderConfigPropsBase {

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

@@ -1 +1 @@
-{"version":3,"file":"StackHeaderConfig.types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/gamma/stack/header/StackHeaderConfig.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,sBAAuB,SAAQ,0BAA0B;IACxE,OAAO,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAC;IACpD,GAAG,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CAC7C"}
+{"version":3,"file":"StackHeaderConfig.types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/gamma/stack/header/StackHeaderConfig.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,sBAAuB,SAAQ,0BAA0B;IACxE,OAAO,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAC;IACpD,GAAG,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CAC7C"}

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

@@ -2,7 +2,7 @@ import { ViewProps } from 'react-native';
 export type StackHeaderSubviewTypeAndroid = 'background' | 'leading' | 'center' | 'trailing';
 export type StackHeaderSubviewCollapseModeAndroid = 'off' | 'parallax';
 export type StackHeaderSubviewProps = {
-    children?: ViewProps['children'] | undefined;
+    children: NonNullable<ViewProps['children']>;
     type?: StackHeaderSubviewTypeAndroid | undefined;
     collapseMode?: StackHeaderSubviewCollapseModeAndroid | undefined;
 };

package/lib/typescript/components/gamma/stack/header/android/StackHeaderSubview.android.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StackHeaderSubview.android.types.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/gamma/stack/header/android/StackHeaderSubview.android.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,6BAA6B,GACrC,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,MAAM,qCAAqC,GAAG,KAAK,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAE7C,IAAI,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAC;IACjD,YAAY,CAAC,EAAE,qCAAqC,GAAG,SAAS,CAAC;CAClE,CAAC"}
+{"version":3,"file":"StackHeaderSubview.android.types.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/gamma/stack/header/android/StackHeaderSubview.android.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,6BAA6B,GACrC,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,MAAM,qCAAqC,GAAG,KAAK,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAE7C,IAAI,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAC;IACjD,YAAY,CAAC,EAAE,qCAAqC,GAAG,SAAS,CAAC;CAClE,CAAC"}

package/lib/typescript/components/gamma/stack/host/StackHost.types.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 import type { ReactNativeElement, ViewProps } from 'react-native';
 import { type NativeProps } from '../../../../fabric/gamma/stack/StackHostNativeComponent';
 export type StackHostProps = {
-    children: ViewProps['children'];
+    children: NonNullable<ViewProps['children']>;
     ref?: React.RefObject<(React.Component<NativeProps> & ReactNativeElement) | null> | undefined;
 };
 //# sourceMappingURL=StackHost.types.d.ts.map

package/lib/typescript/components/gamma/stack/host/StackHost.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StackHost.types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/gamma/stack/host/StackHost.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,yDAAyD,CAAC;AAE3F,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAEhC,GAAG,CAAC,EACA,KAAK,CAAC,SAAS,CACb,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,kBAAkB,CAAC,GAAG,IAAI,CAC3D,GACD,SAAS,CAAC;CACf,CAAC"}
+{"version":3,"file":"StackHost.types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/gamma/stack/host/StackHost.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,yDAAyD,CAAC;AAE3F,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAE7C,GAAG,CAAC,EACA,KAAK,CAAC,SAAS,CACb,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,kBAAkB,CAAC,GAAG,IAAI,CAC3D,GACD,SAAS,CAAC;CACf,CAAC"}

package/lib/typescript/components/safe-area/SafeAreaView.web.d.ts

@@ -1,4 +1,4 @@
 import { View } from 'react-native';
 declare const SafeAreaView: typeof View;
-export default SafeAreaView;
+export { SafeAreaView };
 //# sourceMappingURL=SafeAreaView.web.d.ts.map

package/lib/typescript/components/safe-area/SafeAreaView.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SafeAreaView.web.d.ts","sourceRoot":"","sources":["../../../../src/components/safe-area/SafeAreaView.web.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,QAAA,MAAM,YAAY,aAAO,CAAC;AAE1B,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SafeAreaView.web.d.ts","sourceRoot":"","sources":["../../../../src/components/safe-area/SafeAreaView.web.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,QAAA,MAAM,YAAY,aAAO,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/lib/typescript/components/tabs/host/TabsHost.types.d.ts

@@ -2,7 +2,7 @@ import type { ColorValue, NativeSyntheticEvent, ViewProps } from 'react-native';
 import type { TabsHostPropsAndroid } from './TabsHost.android.types';
 import type { TabsHostPropsIOS } from './TabsHost.ios.types';
 import type { ColorScheme, Direction } from '../../shared/types';
-export type TabsHostNavState = {
+export type TabsHostNavStateRequest = {
     /**
      * @summary Valid screen key.
      *
@@ -11,13 +11,12 @@ export type TabsHostNavState = {
      */
     selectedScreenKey: string;
     /**
-     * @summary A number describing the provenance of the state instance.
+     * @summary Provenance of the navigation state this request is derived from.
      *
      * @description
      * The provenance value establishes a relationship between different navigation state instances
-     * held by given state holder. The assumption here is that when the navigation
-     * state is progressed (modified), the provenance number is incremented.
-     * This creates a relationship where we can say that:
+     * held by given state holder. The assumption is that when the navigation state is progressed
+     * (modified), the provenance number is incremented. This creates a relationship where we can say:
      *
      * 1. State with provenance = n + 1 has been derived from state with provenance = n.
      * 2. For two given navigation states A and B, we can say that A *is stale* iff
@@ -28,12 +27,15 @@ export type TabsHostNavState = {
      *
      * Currently, the native implementation of TabsHost is the state holder.
      *
-     * When you use object of this shape to trigger a navigation via {@link TabsHostPropsBase#navState},
-     * pass here THE PROVENANCE OF THE LAST ACKNOWLEDGED state you received from native side
-     * via {@link TabsHostPropsBase#onTabSelected}. In other words this should be the provenance number
-     * of last confirmed state you base your update request on.
+     * Pass here THE PROVENANCE OF THE LAST ACKNOWLEDGED state you received from native side
+     * via {@link TabsHostPropsBase#onTabSelected}. In other words this should be the provenance
+     * number of last confirmed state you base your update request on.
+     *
+     * It is named `baseProvenance` (rather than `provenance`) to disambiguate it from the
+     * `provenance` field on the {@link TabSelectedEvent} payload, which carries the provenance
+     * of the state *resulting* from a transition.
      */
-    provenance: number;
+    baseProvenance: number;
 };
 /**
  * @summary Payload of the event emitted when a tab selection occurs on the native side.
@@ -52,10 +54,18 @@ export type TabSelectedEvent = {
     /** Whether the selection triggered a special effect (e.g. scroll-to-top on repeated selection). */
     hasTriggeredSpecialEffect: boolean;
     /**
-     * False in case the event is a result of JS-driven update. True otherwise, e.g. in case of user action (tap)
-     * or implicit UIKit action (app resize, orientation change, etc.).
+     * @summary Origin (actor) that requested this tab transition.
+     *
+     * @description
+     * - `user` — direct native UI interaction (e.g. tab bar tap, iOS tab drag-and-drop).
+     * - `programmatic-js` — JS-initiated request delivered via the `navStateRequest` prop.
+     * - `programmatic-native` — request initiated from the native side by an actor
+     *   integrating directly against the native container.
+     * - `implicit` — platform side effect not attributable to an explicit actor
+     *   (e.g. UIKit reshuffling the selection during a horizontal size-class transition on iPad).
+     *   Currently only emitted on iOS.
      */
-    isNativeAction: boolean;
+    actionOrigin: 'user' | 'programmatic-js' | 'programmatic-native' | 'implicit';
 };
 /**
  * @summary Reason why a tab selection request was rejected by the native side.
@@ -122,15 +132,15 @@ export interface TabsHostPropsBase {
      * the update might get accepted or rejected.
      *
      * @see {@link TabsHostPropsBase#rejectStaleNavStateUpdates}
-     * @see {@link TabsHostNavState} for description of the type model & accepted values.
+     * @see {@link TabsHostNavStateRequest} for description of the type model & accepted values.
      */
-    navState: TabsHostNavState;
+    navStateRequest: TabsHostNavStateRequest;
     /**
      * @summary If true, the native side will reject any navigation state updates coming from JS
      * if they are stale.
      *
      * @description A navigation state update is considered stale if it is based of an stale state
-     * (@{link TabsHostNavState#provenance} indicates the base state).
+     * ({@link TabsHostNavStateRequest#baseProvenance} indicates the base state).
      * A state is stale, when at the time of executing update, there already had been accepted a newer state
      * of different origin.
      *
@@ -147,7 +157,7 @@ export interface TabsHostPropsBase {
      * @default false
      */
     rejectStaleNavStateUpdates?: boolean | undefined;
-    children?: ViewProps['children'] | undefined;
+    children: NonNullable<ViewProps['children']>;
     /**
      * @summary Hides the tab bar.
      *

package/lib/typescript/components/tabs/host/TabsHost.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TabsHost.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/host/TabsHost.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TabsHost.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/host/TabsHost.types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/components/tabs/index.d.ts

@@ -1,6 +1,6 @@
 import { TabsHost } from './host';
 import { TabsScreen } from './screen';
-export type { TabsHostNavState, TabSelectedEvent, TabSelectionRejectedEvent, TabSelectionRejectionReason, TabsHostColorScheme, TabsHostDirection, TabsHostNativeContainerStyleProps, TabsHostPropsBase, TabsHostProps, TabsHostPropsAndroid, MoreTabSelectedEvent, TabsBottomAccessoryComponentFactory, TabBarMinimizeBehavior, TabBarControllerMode, TabsHostPropsIOS, } from './host';
+export type { TabsHostNavStateRequest, TabSelectedEvent, TabSelectionRejectedEvent, TabSelectionRejectionReason, TabsHostColorScheme, TabsHostDirection, TabsHostNativeContainerStyleProps, TabsHostPropsBase, TabsHostProps, TabsHostPropsAndroid, MoreTabSelectedEvent, TabsBottomAccessoryComponentFactory, TabBarMinimizeBehavior, TabBarControllerMode, TabsHostPropsIOS, } from './host';
 export type { TabsScreenEventHandler, TabsScreenOrientation, TabsScreenPropsBase, TabsScreenProps, TabBarItemLabelVisibilityMode, TabsScreenItemStateAppearanceAndroid, TabsScreenAppearanceAndroid, TabsScreenPropsAndroid, TabsScreenBlurEffect, TabsScreenSystemItem, TabsScreenAppearanceIOS, TabsScreenItemAppearanceIOS, TabsScreenItemStateAppearanceIOS, TabsScreenPropsIOS, } from './screen';
 export type { TabsBottomAccessoryEnvironment } from './bottom-accessory';
 /**

package/lib/typescript/components/tabs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/tabs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,iCAAiC,EACjC,iBAAiB,EACjB,aAAa,EAEb,oBAAoB,EAEpB,oBAAoB,EACpB,mCAAmC,EACnC,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAEhB,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EAEf,6BAA6B,EAC7B,oCAAoC,EACpC,2BAA2B,EAC3B,sBAAsB,EAEtB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,IAAI;;;CAGhB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/tabs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,iCAAiC,EACjC,iBAAiB,EACjB,aAAa,EAEb,oBAAoB,EAEpB,oBAAoB,EACpB,mCAAmC,EACnC,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAEhB,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EAEf,6BAA6B,EAC7B,oCAAoC,EACpC,2BAA2B,EAC3B,sBAAsB,EAEtB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,IAAI;;;CAGhB,CAAC"}

package/lib/typescript/fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent.d.ts

@@ -9,6 +9,11 @@ export interface NativeProps extends ViewProps {
     backButtonTintColor?: ColorValue | undefined;
     backButtonDrawableIconResourceName?: string | undefined;
     backButtonImageIconResource?: ImageSource | undefined;
+    scrollFlagScroll?: CT.WithDefault<boolean, false>;
+    scrollFlagEnterAlways?: CT.WithDefault<boolean, false>;
+    scrollFlagEnterAlwaysCollapsed?: CT.WithDefault<boolean, false>;
+    scrollFlagExitUntilCollapsed?: CT.WithDefault<boolean, false>;
+    scrollFlagSnap?: CT.WithDefault<boolean, false>;
 }
 declare const _default: import("react-native").HostComponent<NativeProps>;
 export default _default;

package/lib/typescript/fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StackHeaderConfigAndroidNativeComponent.d.ts","sourceRoot":"","sources":["../../../../../src/fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,IAAI,EAAE,EAClB,WAAW,EACX,SAAS,EACV,MAAM,cAAc,CAAC;AAGtB,KAAK,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C,gBAAgB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAGlD,IAAI,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IAEvD,mBAAmB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7C,kCAAkC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxD,2BAA2B,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACvD;;AAED,wBAME"}
+{"version":3,"file":"StackHeaderConfigAndroidNativeComponent.d.ts","sourceRoot":"","sources":["../../../../../src/fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,IAAI,EAAE,EAClB,WAAW,EACX,SAAS,EACV,MAAM,cAAc,CAAC;AAGtB,KAAK,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C,gBAAgB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAGlD,IAAI,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IAEvD,mBAAmB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7C,kCAAkC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxD,2BAA2B,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAEtD,gBAAgB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClD,qBAAqB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,8BAA8B,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAChE,4BAA4B,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9D,cAAc,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CACjD;;AAED,wBAME"}

package/lib/typescript/fabric/tabs/TabsHostAndroidNativeComponent.d.ts

@@ -4,11 +4,11 @@ type TabSelectedEvent = {
     provenance: CT.Int32;
     isRepeated: boolean;
     hasTriggeredSpecialEffect: boolean;
-    isNativeAction: boolean;
+    actionOrigin: 'user' | 'programmatic-js' | 'programmatic-native' | 'implicit';
 };
-type NavigationState = {
+type NavigationStateRequest = {
     selectedScreenKey: string;
-    provenance: CT.Int32;
+    baseProvenance: CT.Int32;
 };
 type TabSelectionRejectedEvent = Readonly<{
     selectedScreenKey: string;
@@ -24,7 +24,7 @@ type TabSelectionPreventedEvent = Readonly<{
 }>;
 type TabsHostColorScheme = 'inherit' | 'light' | 'dark';
 export interface NativeProps extends ViewProps {
-    navState: NavigationState;
+    navStateRequest: NavigationStateRequest;
     rejectStaleNavStateUpdates?: CT.WithDefault<boolean, false>;
     onTabSelected?: CT.DirectEventHandler<TabSelectedEvent> | undefined;
     onTabSelectionRejected?: CT.DirectEventHandler<TabSelectionRejectedEvent> | undefined;

package/lib/typescript/fabric/tabs/TabsHostAndroidNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TabsHostAndroidNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/fabric/tabs/TabsHostAndroidNativeComponent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9E,KAAK,gBAAgB,GAAG;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB,EAAE,OAAO,CAAC;IACnC,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;CACtB,CAAC;AAEF,KAAK,yBAAyB,GAAG,QAAQ,CAAC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,EAAE,CAAC,KAAK,CAAC;IAC7B,eAAe,EAAE,OAAO,GAAG,UAAU,CAAC;CACvC,CAAC,CAAC;AAEH,KAAK,0BAA0B,GAAG,QAAQ,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC,CAAC;AAEH,KAAK,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAQxD,MAAM,WAAW,WAAY,SAAQ,SAAS;IAE5C,QAAQ,EAAE,eAAe,CAAC;IAC1B,0BAA0B,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAG5D,aAAa,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACpE,sBAAsB,CAAC,EACnB,EAAE,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,GAChD,SAAS,CAAC;IACd,uBAAuB,CAAC,EACpB,EAAE,CAAC,kBAAkB,CAAC,0BAA0B,CAAC,GACjD,SAAS,CAAC;IAGd,YAAY,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,8BAA8B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACxD,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAG7D,uBAAuB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CAC1D;;AAED,wBAGG"}
+{"version":3,"file":"TabsHostAndroidNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/fabric/tabs/TabsHostAndroidNativeComponent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9E,KAAK,gBAAgB,GAAG;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB,EAAE,OAAO,CAAC;IACnC,YAAY,EAAE,MAAM,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,UAAU,CAAC;CAC/E,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC;CAC1B,CAAC;AAEF,KAAK,yBAAyB,GAAG,QAAQ,CAAC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,EAAE,CAAC,KAAK,CAAC;IAC7B,eAAe,EAAE,OAAO,GAAG,UAAU,CAAC;CACvC,CAAC,CAAC;AAEH,KAAK,0BAA0B,GAAG,QAAQ,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC,CAAC;AAEH,KAAK,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAQxD,MAAM,WAAW,WAAY,SAAQ,SAAS;IAE5C,eAAe,EAAE,sBAAsB,CAAC;IACxC,0BAA0B,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAG5D,aAAa,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACpE,sBAAsB,CAAC,EACnB,EAAE,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,GAChD,SAAS,CAAC;IACd,uBAAuB,CAAC,EACpB,EAAE,CAAC,kBAAkB,CAAC,0BAA0B,CAAC,GACjD,SAAS,CAAC;IAGd,YAAY,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,8BAA8B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACxD,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAG7D,uBAAuB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CAC1D;;AAED,wBAGG"}

package/lib/typescript/fabric/tabs/TabsHostIOSNativeComponent.d.ts

@@ -4,11 +4,11 @@ type TabSelectedEvent = Readonly<{
     provenance: CT.Int32;
     isRepeated: boolean;
     hasTriggeredSpecialEffect: boolean;
-    isNativeAction: boolean;
+    actionOrigin: 'user' | 'programmatic-js' | 'programmatic-native' | 'implicit';
 }>;
-type NavigationState = Readonly<{
+type NavigationStateRequest = Readonly<{
     selectedScreenKey: string;
-    provenance: CT.Int32;
+    baseProvenance: CT.Int32;
 }>;
 type TabSelectionRejectedEvent = Readonly<{
     selectedScreenKey: string;
@@ -31,7 +31,7 @@ type LayoutDirection = 'inherit' | 'ltr' | 'rtl';
 type TabBarMinimizeBehavior = 'automatic' | 'never' | 'onScrollDown' | 'onScrollUp';
 type TabBarControllerMode = 'automatic' | 'tabBar' | 'tabSidebar';
 export interface NativeProps extends ViewProps {
-    navState: NavigationState;
+    navStateRequest: NavigationStateRequest;
     rejectStaleNavStateUpdates?: CT.WithDefault<boolean, false>;
     onTabSelected?: CT.DirectEventHandler<TabSelectedEvent> | undefined;
     onTabSelectionRejected?: CT.DirectEventHandler<TabSelectionRejectedEvent> | undefined;

package/lib/typescript/fabric/tabs/TabsHostIOSNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TabsHostIOSNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/fabric/tabs/TabsHostIOSNativeComponent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9E,KAAK,gBAAgB,GAAG,QAAQ,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB,EAAE,OAAO,CAAC;IACnC,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC,CAAC;AAEH,KAAK,eAAe,GAAG,QAAQ,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;CACtB,CAAC,CAAC;AAEH,KAAK,yBAAyB,GAAG,QAAQ,CAAC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,EAAE,CAAC,KAAK,CAAC;IAC7B,eAAe,EAAE,OAAO,GAAG,UAAU,CAAC;CACvC,CAAC,CAAC;AAEH,KAAK,0BAA0B,GAAG,QAAQ,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC,CAAC;AAEH,KAAK,oBAAoB,GAAG,QAAQ,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;CACtB,CAAC,CAAC;AAEH,KAAK,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAExD,KAAK,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAMjD,KAAK,sBAAsB,GACvB,WAAW,GACX,OAAO,GACP,cAAc,GACd,YAAY,CAAC;AAEjB,KAAK,oBAAoB,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAIlE,MAAM,WAAW,WAAY,SAAQ,SAAS;IAE5C,QAAQ,EAAE,eAAe,CAAC;IAC1B,0BAA0B,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAG5D,aAAa,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACpE,sBAAsB,CAAC,EACnB,EAAE,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,GAChD,SAAS,CAAC;IACd,uBAAuB,CAAC,EACpB,EAAE,CAAC,kBAAkB,CAAC,0BAA0B,CAAC,GACjD,SAAS,CAAC;IACd,iBAAiB,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,GAAG,SAAS,CAAC;IAG5E,YAAY,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,8BAA8B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACxD,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAI7D,eAAe,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAG7D,eAAe,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACzC,sBAAsB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;IAC7E,oBAAoB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;CAC1E;;AAED,wBAGG"}
+{"version":3,"file":"TabsHostIOSNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/fabric/tabs/TabsHostIOSNativeComponent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9E,KAAK,gBAAgB,GAAG,QAAQ,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB,EAAE,OAAO,CAAC;IACnC,YAAY,EAAE,MAAM,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,UAAU,CAAC;CAC/E,CAAC,CAAC;AAEH,KAAK,sBAAsB,GAAG,QAAQ,CAAC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC;CAC1B,CAAC,CAAC;AAEH,KAAK,yBAAyB,GAAG,QAAQ,CAAC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,EAAE,CAAC,KAAK,CAAC;IAC7B,eAAe,EAAE,OAAO,GAAG,UAAU,CAAC;CACvC,CAAC,CAAC;AAEH,KAAK,0BAA0B,GAAG,QAAQ,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC,CAAC;AAEH,KAAK,oBAAoB,GAAG,QAAQ,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC;CACtB,CAAC,CAAC;AAEH,KAAK,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAExD,KAAK,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAMjD,KAAK,sBAAsB,GACvB,WAAW,GACX,OAAO,GACP,cAAc,GACd,YAAY,CAAC;AAEjB,KAAK,oBAAoB,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAIlE,MAAM,WAAW,WAAY,SAAQ,SAAS;IAE5C,eAAe,EAAE,sBAAsB,CAAC;IACxC,0BAA0B,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAG5D,aAAa,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACpE,sBAAsB,CAAC,EACnB,EAAE,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,GAChD,SAAS,CAAC;IACd,uBAAuB,CAAC,EACpB,EAAE,CAAC,kBAAkB,CAAC,0BAA0B,CAAC,GACjD,SAAS,CAAC;IACd,iBAAiB,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,GAAG,SAAS,CAAC;IAG5E,YAAY,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,8BAA8B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACxD,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAI7D,eAAe,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAG7D,eAAe,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACzC,sBAAsB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;IAC7E,oBAAoB,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;CAC1E;;AAED,wBAGG"}

package/lib/typescript/flags.d.ts

@@ -49,6 +49,7 @@ export declare const compatibilityFlags: {
      * * https://github.com/software-mansion/react-native-screens/pull/3863
      * * https://github.com/software-mansion/react-native-screens/pull/3875
      * * https://github.com/software-mansion/react-native-screens/pull/3895
+     * * https://github.com/software-mansion/react-native-screens/pull/3918
      */
     readonly usesStableTabsApi: true;
 };

package/lib/typescript/flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/flags.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;;;;OAKG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;OAKG;;IAGH;;;;;;;;;;;;;;;;;;;OAmBG;;CAEK,CAAC;AAqHX;;;;GAIG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;;yCAK0C,OAAO;+CAMD,OAAO;gDAMN,OAAO;uCAMhB,OAAO;iEAOvC,OAAO;QAIhB;;;WAGG;kDAIiD,OAAO;QAG3D;;;WAGG;iDAIgD,OAAO;QAG1D;;;;;;WAMG;gDAI+C,OAAO;;IAI3D;;OAEG;;sBAKuB,OAAO;;CAIlC,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/flags.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;;;;OAKG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;OAKG;;IAGH;;;;;;;;;;;;;;;;;;;;OAoBG;;CAEK,CAAC;AAqHX;;;;GAIG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;;yCAK0C,OAAO;+CAMD,OAAO;gDAMN,OAAO;uCAMhB,OAAO;iEAOvC,OAAO;QAIhB;;;WAGG;kDAIiD,OAAO;QAG3D;;;WAGG;iDAIgD,OAAO;QAG1D;;;;;;WAMG;gDAI+C,OAAO;;IAI3D;;OAEG;;sBAKuB,OAAO;;CAIlC,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-screens",
-  "version": "4.25.0-beta.1",
+  "version": "4.25.0-beta.2",
   "description": "Native navigation primitives for your React Native app.",
   "scripts": {
     "submodules": "git submodule update --init --recursive && (cd react-navigation && yarn && yarn build && cd ../)",

package/src/components/gamma/split/SplitHost.types.ts

@@ -113,7 +113,7 @@ export type SplitHostCommands = {
 };
 
 export interface SplitHostProps extends ViewProps {
-  children?: React.ReactNode | undefined;
+  children: NonNullable<React.ReactNode>;
   ref?: React.Ref<SplitHostCommands> | undefined;
 
   /**