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

package/src/components/gamma/stack/header/StackHeaderConfig.android.tsx

@@ -4,7 +4,10 @@ import type { StackHeaderConfigProps } from './StackHeaderConfig.types';
 import StackHeaderConfigAndroidNativeComponent from '../../../../fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent';
 import type { NativeProps as StackHeaderConfigAndroidNativeComponentProps } from '../../../../fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent';
 import StackHeaderSubview from './android/StackHeaderSubview.android';
-import type { StackHeaderConfigPropsAndroid } from './StackHeaderConfig.android.types';
+import type {
+  StackHeaderConfigPropsAndroid,
+  StackHeaderTypeAndroid,
+} from './StackHeaderConfig.android.types';
 
 /**
  * EXPERIMENTAL API, MIGHT CHANGE W/O ANY NOTICE
@@ -20,10 +23,22 @@ function StackHeaderConfig(props: StackHeaderConfigProps) {
     centerSubview,
     trailingSubview,
     backButtonIcon,
+    scrollFlagScroll,
+    scrollFlagEnterAlways,
+    scrollFlagEnterAlwaysCollapsed,
+    scrollFlagExitUntilCollapsed,
+    scrollFlagSnap,
     ...filteredAndroidProps
   } = android ?? {};
 
   const backButtonIconProps = parseBackButtonIconToNativeProps(backButtonIcon);
+  const scrollFlagProps = resolveScrollFlags(filteredAndroidProps.type, {
+    scrollFlagScroll,
+    scrollFlagEnterAlways,
+    scrollFlagEnterAlwaysCollapsed,
+    scrollFlagExitUntilCollapsed,
+    scrollFlagSnap,
+  });
 
   return (
     <StackHeaderConfigAndroidNativeComponent
@@ -31,7 +46,8 @@ function StackHeaderConfig(props: StackHeaderConfigProps) {
       style={StyleSheet.absoluteFill}
       {...baseProps}
       {...filteredAndroidProps}
-      {...backButtonIconProps}>
+      {...backButtonIconProps}
+      {...scrollFlagProps}>
       {/*
         Please note that the order of the subviews MUST match
         the order in native StackHeaderConfig.getConfigSubviewAt.
@@ -93,4 +109,58 @@ function parseBackButtonIconToNativeProps(
   }
 }
 
+type ScrollFlagFields = {
+  scrollFlagScroll: boolean;
+  scrollFlagEnterAlways: boolean;
+  scrollFlagEnterAlwaysCollapsed: boolean;
+  scrollFlagExitUntilCollapsed: boolean;
+  scrollFlagSnap: boolean;
+};
+
+const SCROLL_FLAG_DEFAULTS_BY_TYPE: Record<
+  StackHeaderTypeAndroid,
+  ScrollFlagFields
+> = {
+  small: {
+    scrollFlagScroll: false,
+    scrollFlagEnterAlways: false,
+    scrollFlagEnterAlwaysCollapsed: false,
+    scrollFlagExitUntilCollapsed: false,
+    scrollFlagSnap: false,
+  },
+  medium: {
+    scrollFlagScroll: true,
+    scrollFlagEnterAlways: false,
+    scrollFlagEnterAlwaysCollapsed: false,
+    scrollFlagExitUntilCollapsed: true,
+    scrollFlagSnap: true,
+  },
+  large: {
+    scrollFlagScroll: true,
+    scrollFlagEnterAlways: false,
+    scrollFlagEnterAlwaysCollapsed: false,
+    scrollFlagExitUntilCollapsed: true,
+    scrollFlagSnap: true,
+  },
+};
+
+function resolveScrollFlags(
+  type: StackHeaderTypeAndroid | undefined,
+  overrides: Pick<StackHeaderConfigPropsAndroid, keyof ScrollFlagFields>,
+): ScrollFlagFields {
+  const defaults = SCROLL_FLAG_DEFAULTS_BY_TYPE[type ?? 'small'];
+  return {
+    scrollFlagScroll: overrides.scrollFlagScroll ?? defaults.scrollFlagScroll,
+    scrollFlagEnterAlways:
+      overrides.scrollFlagEnterAlways ?? defaults.scrollFlagEnterAlways,
+    scrollFlagEnterAlwaysCollapsed:
+      overrides.scrollFlagEnterAlwaysCollapsed ??
+      defaults.scrollFlagEnterAlwaysCollapsed,
+    scrollFlagExitUntilCollapsed:
+      overrides.scrollFlagExitUntilCollapsed ??
+      defaults.scrollFlagExitUntilCollapsed,
+    scrollFlagSnap: overrides.scrollFlagSnap ?? defaults.scrollFlagSnap,
+  };
+}
+
 export default StackHeaderConfig;

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

@@ -9,30 +9,205 @@ 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;
 }

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

@@ -2,9 +2,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;
 }
 

package/src/components/gamma/stack/header/android/StackHeaderSubview.android.types.ts

@@ -9,7 +9,7 @@ export type StackHeaderSubviewTypeAndroid =
 export type StackHeaderSubviewCollapseModeAndroid = 'off' | 'parallax';
 
 export type StackHeaderSubviewProps = {
-  children?: ViewProps['children'] | undefined;
+  children: NonNullable<ViewProps['children']>;
 
   type?: StackHeaderSubviewTypeAndroid | undefined;
   collapseMode?: StackHeaderSubviewCollapseModeAndroid | undefined;

package/src/components/gamma/stack/host/StackHost.types.ts

@@ -3,7 +3,7 @@ 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']>;
   // TODO: Work on these types
   ref?:
     | React.RefObject<

package/src/components/safe-area/SafeAreaView.web.tsx

@@ -2,4 +2,4 @@ import { View } from 'react-native';
 
 const SafeAreaView = View;
 
-export default SafeAreaView;
+export { SafeAreaView };

package/src/components/tabs/host/TabsHost.android.tsx

@@ -25,7 +25,7 @@ function TabsHost(props: TabsHostProps) {
     direction,
     nativeContainerStyle,
     onTabSelected,
-    navState,
+    navStateRequest,
     ...filteredBaseProps
   } = baseProps;
 
@@ -41,7 +41,7 @@ function TabsHost(props: TabsHostProps) {
   return (
     <TabsHostAndroidNativeComponent
       style={[styles.fillParent, { direction }]}
-      navState={navState}
+      navStateRequest={navStateRequest}
       onTabSelected={onTabSelectedCallback}
       nativeContainerBackgroundColor={nativeContainerStyle?.backgroundColor}
       // @ts-ignore suppress ref - debug only

package/src/components/tabs/host/TabsHost.ios.tsx

@@ -28,7 +28,7 @@ function TabsHost(props: TabsHostProps) {
     direction,
     nativeContainerStyle,
     onTabSelected,
-    navState,
+    navStateRequest,
     ...filteredBaseProps
   } = baseProps;
 
@@ -47,7 +47,7 @@ function TabsHost(props: TabsHostProps) {
   return (
     <TabsHostIOSNativeComponent
       style={styles.fillParent}
-      navState={navState}
+      navStateRequest={navStateRequest}
       onTabSelected={onTabSelectedCallback}
       nativeContainerBackgroundColor={nativeContainerStyle?.backgroundColor}
       // @ts-ignore suppress ref - debug only

package/src/components/tabs/host/TabsHost.types.ts

@@ -5,7 +5,7 @@ import type { ColorScheme, Direction } from '../../shared/types';
 
 // #region Control
 
-export type TabsHostNavState = {
+export type TabsHostNavStateRequest = {
   /**
    * @summary Valid screen key.
    *
@@ -14,13 +14,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
@@ -31,12 +30,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;
 };
 
 // #endregion Control
@@ -60,10 +62,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';
 };
 
 /**
@@ -140,15 +150,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.
    *
@@ -167,7 +177,7 @@ export interface TabsHostPropsBase {
   rejectStaleNavStateUpdates?: boolean | undefined;
 
   // General
-  children?: ViewProps['children'] | undefined;
+  children: NonNullable<ViewProps['children']>;
   /**
    * @summary Hides the tab bar.
    *

package/src/components/tabs/index.ts

@@ -2,7 +2,7 @@ import { TabsHost } from './host';
 import { TabsScreen } from './screen';
 
 export type {
-  TabsHostNavState,
+  TabsHostNavStateRequest,
   TabSelectedEvent,
   TabSelectionRejectedEvent,
   TabSelectionRejectionReason,

package/src/fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent.ts

@@ -22,6 +22,12 @@ 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>;
 }
 
 export default codegenNativeComponent<NativeProps>(

package/src/fabric/tabs/TabsHostAndroidNativeComponent.ts

@@ -10,12 +10,12 @@ 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<{
@@ -42,7 +42,7 @@ type TabsHostColorScheme = 'inherit' | 'light' | 'dark';
 
 export interface NativeProps extends ViewProps {
   // Control
-  navState: NavigationState;
+  navStateRequest: NavigationStateRequest;
   rejectStaleNavStateUpdates?: CT.WithDefault<boolean, false>;
 
   // Events

package/src/fabric/tabs/TabsHostIOSNativeComponent.ts

@@ -10,12 +10,12 @@ 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<{
@@ -57,7 +57,7 @@ type TabBarControllerMode = 'automatic' | 'tabBar' | 'tabSidebar';
 
 export interface NativeProps extends ViewProps {
   // Control
-  navState: NavigationState;
+  navStateRequest: NavigationStateRequest;
   rejectStaleNavStateUpdates?: CT.WithDefault<boolean, false>;
 
   // Events

package/src/flags.ts

@@ -65,6 +65,7 @@ export 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
    */
   usesStableTabsApi: true,
 } as const;

package/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/container/TabsContainerOps.kt

@@ -1,7 +0,0 @@
-package com.swmansion.rnscreens.gamma.tabs.container
-
-internal sealed class TabsContainerOp
-
-internal data class TabSelectOp(
-    val navState: TabsNavState,
-) : TabsContainerOp()

package/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/container/TabsNavState.kt

@@ -1,43 +0,0 @@
-package com.swmansion.rnscreens.gamma.tabs.container
-
-import com.swmansion.rnscreens.gamma.tabs.container.TabsNavStateUpdateRejectionReason.REPEATED
-import com.swmansion.rnscreens.gamma.tabs.container.TabsNavStateUpdateRejectionReason.STALE
-
-/**
- * Describes navigation state of a tabs container.
- *
- * @property selectedKey Screen key of the currently selected tab.
- * @property provenance Monotonically increasing number describing the history (generation) of the state.
- *   State with provenance `N + 1` is derived from state with provenance `N`.
- *   This allows detecting stale updates.
- */
-data class TabsNavState(
-    val selectedKey: String,
-    val provenance: Int,
-) {
-    internal fun isEmpty(): Boolean = this === EMPTY
-
-    internal fun isNotEmpty(): Boolean = !this.isEmpty()
-
-    companion object {
-        val EMPTY = TabsNavState("", Int.MIN_VALUE)
-    }
-}
-
-/**
- * Reason why a navigation state update was rejected by the container.
- *
- * - [STALE] — the update's provenance indicates that it is based on a stale state.
- * - [REPEATED] — the requested tab is already selected.
- */
-enum class TabsNavStateUpdateRejectionReason {
-    STALE,
-    REPEATED,
-    ;
-
-    override fun toString(): String =
-        when (this) {
-            STALE -> "stale"
-            REPEATED -> "repeated"
-        }
-}