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

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

@@ -0,0 +1,234 @@
+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 = {
+    /**
+     * @summary Valid screen key.
+     *
+     * @description
+     * It must correspond to one of the keys you assign to the `TabsScreens`.
+     */
+    selectedScreenKey: string;
+    /**
+     * @summary A number describing the provenance of the state instance.
+     *
+     * @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:
+     *
+     * 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
+     * A.provenance <= B.provenance.
+     *
+     * This allows us to mitigate and resolve state conflicts that can happen with
+     * asynchronous navigation.
+     *
+     * 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.
+     */
+    provenance: number;
+};
+/**
+ * @summary Payload of the event emitted when a tab selection occurs on the native side.
+ *
+ * @description
+ * This event is emitted both for user-initiated and programmatic tab changes.
+ * It carries the resulting navigation state along with metadata about the selection context.
+ */
+export type TabSelectedEvent = {
+    /** Screen key of the newly selected tab. */
+    selectedScreenKey: string;
+    /** Provenance of the navigation state after the selection. */
+    provenance: number;
+    /** Whether the same tab that was already selected has been selected again. */
+    isRepeated: boolean;
+    /** 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.).
+     */
+    isNativeAction: boolean;
+};
+/**
+ * @summary Reason why a tab selection request was rejected by the native side.
+ *
+ * - `stale` — the update was based on a stale navigation state,
+ *   meaning a newer state has already been applied. Only reported when
+ *   {@link TabsHostPropsBase#rejectStaleNavStateUpdates} is enabled.
+ * - `repeated` — the requested tab is already selected.
+ */
+export type TabSelectionRejectionReason = 'stale' | 'repeated';
+/**
+ * @summary Payload of the event emitted when the native side rejects a tab selection request.
+ *
+ * @description
+ * Contains the currently active navigation state (`selectedScreenKey`, `provenance`)
+ * alongside the rejected request details, so that the JS side can reconcile its state.
+ *
+ * @see {@link TabSelectionRejectionReason} for possible rejection reasons.
+ * @see {@link TabsHostPropsBase#rejectStaleNavStateUpdates}
+ */
+export type TabSelectionRejectedEvent = {
+    /** Screen key of the currently selected (active) tab. */
+    selectedScreenKey: string;
+    /** Provenance of the currently active navigation state. */
+    provenance: number;
+    /** Screen key of the tab whose selection was rejected. */
+    rejectedScreenKey: string;
+    /** Provenance of the rejected navigation state update. */
+    rejectedProvenance: number;
+    /** Reason the selection was rejected. */
+    rejectionReason: TabSelectionRejectionReason;
+};
+/**
+ * @summary Payload of the event emitted when the native side prevents a tab selection
+ * because the target screen has `preventNativeSelection` enabled.
+ */
+export type TabSelectionPreventedEvent = {
+    /** Screen key of the currently selected (active) tab. */
+    selectedScreenKey: string;
+    /** Provenance of the currently active navigation state. */
+    provenance: number;
+    /** Screen key of the tab whose selection was prevented. */
+    preventedScreenKey: string;
+};
+export type TabsHostColorScheme = ColorScheme | 'inherit';
+export type TabsHostDirection = Direction | 'inherit';
+export type TabsHostNativeContainerStyleProps = {
+    /**
+     * @summary Specifies the background color of the native container.
+     *
+     * @platform android, ios
+     */
+    backgroundColor?: ColorValue | undefined;
+};
+export interface TabsHostPropsBase {
+    /**
+     * @summary
+     * Allows to pass desired navigation state request to the native side.
+     * It also determines initial navigation state after first render.
+     *
+     * @description
+     * This prop can be thought of as a "next navigation state suggestion for the native side".
+     * Depending on configuration and the provenance of the update
+     * the update might get accepted or rejected.
+     *
+     * @see {@link TabsHostPropsBase#rejectStaleNavStateUpdates}
+     * @see {@link TabsHostNavState} for description of the type model & accepted values.
+     */
+    navState: TabsHostNavState;
+    /**
+     * @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).
+     * A state is stale, when at the time of executing update, there already had been accepted a newer state
+     * of different origin.
+     *
+     * This can happen, when an update from JS is dispatched, but before it reaches the native
+     * side, another update happens on UI thread, e.g. user selects another tab. For such
+     * situations, where to-be-applied navigation state update had been dispatched w/o
+     * full context of actual navigation state you can toggle this prop. Please note,
+     * that above definition means, that an JS update won't be rejected if you send a series of
+     * udpates with the same provenance, unless some action has been taken by the user "in the meantime".
+     *
+     * If an update is rejected due to being stale, the `onTabSelectionRejected` event will be
+     * emitted with details of the rejected update and the currently active navigation state.
+     *
+     * @default false
+     */
+    rejectStaleNavStateUpdates?: boolean | undefined;
+    children?: ViewProps['children'] | undefined;
+    /**
+     * @summary Hides the tab bar.
+     *
+     * @default false
+     *
+     * @platform android, ios
+     */
+    tabBarHidden?: boolean | undefined;
+    /**
+     * @summary Allows for native container view customization.
+     *
+     * On Android, style is applied to `FrameLayout` that wraps currently focused screen
+     * and `BottomNavigationView`. On iOS, style is applied to `UITabBarController`'s
+     * view.
+     *
+     * @platform android, ios
+     */
+    nativeContainerStyle?: TabsHostNativeContainerStyleProps | undefined;
+    /**
+     * @summary Specifies the layout direction of the native container, its views and child containers.
+     *
+     * The following values are currently supported:
+     *
+     * - `inherit` - uses parent's layout direction,
+     * - `ltr` - forces left-to-right layout direction,
+     * - `rtl` - forces right-to-left layout direction.
+     *
+     * On Android, this property relies on `react-native`'s `style.direction`
+     * (which sets native Android `layoutDirection` View property). Property is
+     * propagated via the view hierarchy. The value will fallback to direction
+     * set on one of the parent views.
+     *
+     * On iOS, this property sets `layoutDirection` trait override for the
+     * native tab bar controller. Property is propagated via the native trait
+     * system. The value will fallback to direction of the **native** app
+     * (`userInterfaceLayoutDirection`), potentially ignoring `react-native`'s
+     * override (e.g. when `forceRTL` is used). To mitigate this, you can pass
+     * `ltr`/`rtl` to this property depending on the value of `I18nManager.isRTL`.
+     *
+     * @default inherit
+     *
+     * @platform android, ios
+     */
+    direction?: TabsHostDirection | undefined;
+    /**
+     * @summary Specifies the color scheme used by the container and any child containers.
+     *
+     * The following values are currently supported:
+     * - `inherit` - the interface style from parent,
+     * - `light` - the light interface style,
+     * - `dark` - the dark interface style.
+     *
+     * @default inherit
+     *
+     * @platform android, ios
+     */
+    colorScheme?: TabsHostColorScheme | undefined;
+    /**
+     * @summary A callback that gets invoked when the selected tab changes.
+     *
+     * @platform android, ios
+     */
+    onTabSelected?: ((event: NativeSyntheticEvent<TabSelectedEvent>) => void) | undefined;
+    /**
+     * @summary
+     * A callback that gets invoked when the native side rejects a tab selection request.
+     *
+     * @see {@link TabSelectionRejectedEvent}
+     */
+    onTabSelectionRejected?: ((event: NativeSyntheticEvent<TabSelectionRejectedEvent>) => void) | undefined;
+    /**
+     * @summary
+     * A callback that gets invoked when the native side prevents a tab selection
+     * because the target screen has `preventNativeSelection` enabled.
+     *
+     * @see {@link TabSelectionPreventedEvent}
+     */
+    onTabSelectionPrevented?: ((event: NativeSyntheticEvent<TabSelectionPreventedEvent>) => void) | undefined;
+}
+export interface TabsHostProps extends TabsHostPropsBase {
+    ios?: TabsHostPropsIOS | undefined;
+    android?: TabsHostPropsAndroid | undefined;
+}
+//# sourceMappingURL=TabsHost.types.d.ts.map

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

@@ -0,0 +1 @@
+{"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/host/TabsHost.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabsHost.web.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/host/TabsHost.web.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,QAAA,MAAM,QAAQ,aAAO,CAAC;AAEtB,eAAe,QAAQ,CAAC"}

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

@@ -0,0 +1,5 @@
+export { default as TabsHost } from './TabsHost';
+export type * from './TabsHost.types';
+export type * from './TabsHost.android.types';
+export type * from './TabsHost.ios.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD,mBAAmB,kBAAkB,CAAC;AAEtC,mBAAmB,0BAA0B,CAAC;AAC9C,mBAAmB,sBAAsB,CAAC"}

package/lib/typescript/components/tabs/host/useTabsHost.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import { type NativeSyntheticEvent } from 'react-native';
+import type { NativeProps as TabsHostAndroidNativeComponentProps } from '../../../fabric/tabs/TabsHostAndroidNativeComponent';
+import type { NativeProps as TabsHostIOSNativeComponentProps } from '../../../fabric/tabs/TabsHostIOSNativeComponent';
+import type { TabSelectedEvent } from './TabsHost.types';
+type TabsHostPlatformNativeComponentProps = TabsHostAndroidNativeComponentProps | TabsHostIOSNativeComponentProps;
+interface TabsHostConfig<T> {
+    componentNodeRef: React.RefObject<React.Component<T> | null>;
+    onTabSelected?: ((event: NativeSyntheticEvent<TabSelectedEvent>) => void) | undefined;
+}
+export declare function useTabsHost<T extends TabsHostPlatformNativeComponentProps>({ componentNodeRef, onTabSelected, }: TabsHostConfig<T>): {
+    onTabSelected: (event: NativeSyntheticEvent<TabSelectedEvent>) => void;
+};
+export {};
+//# sourceMappingURL=useTabsHost.d.ts.map

package/lib/typescript/components/tabs/host/useTabsHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabsHost.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/host/useTabsHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,IAAI,mCAAmC,EAAE,MAAM,qDAAqD,CAAC;AAC9H,OAAO,KAAK,EAAE,WAAW,IAAI,+BAA+B,EAAE,MAAM,iDAAiD,CAAC;AAEtH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,KAAK,oCAAoC,GACrC,mCAAmC,GACnC,+BAA+B,CAAC;AAEpC,UAAU,cAAc,CAAC,CAAC;IACxB,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7D,aAAa,CAAC,EACV,CAAC,CAAC,KAAK,EAAE,oBAAoB,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC,GACzD,SAAS,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,oCAAoC,EAAE,EAC1E,gBAAgB,EAChB,aAAa,GACd,EAAE,cAAc,CAAC,CAAC,CAAC;2BAaR,oBAAoB,CAAC,gBAAgB,CAAC;EAcjD"}

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

@@ -1,14 +1,13 @@
-import TabsHost from './TabsHost';
-import TabsScreen from './TabsScreen';
-export type * from './TabsHost.types';
-export type * from './TabsScreen.types';
-export type { TabsAccessoryEnvironment } from './TabsAccessory.types';
+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 { TabsScreenEventHandler, TabsScreenOrientation, TabsScreenPropsBase, TabsScreenProps, TabBarItemLabelVisibilityMode, TabsScreenItemStateAppearanceAndroid, TabsScreenAppearanceAndroid, TabsScreenPropsAndroid, TabsScreenBlurEffect, TabsScreenSystemItem, TabsScreenAppearanceIOS, TabsScreenItemAppearanceIOS, TabsScreenItemStateAppearanceIOS, TabsScreenPropsIOS, } from './screen';
+export type { TabsBottomAccessoryEnvironment } from './bottom-accessory';
 /**
  * EXPERIMENTAL API, MIGHT CHANGE W/O ANY NOTICE
  */
-declare const Tabs: {
+export declare const Tabs: {
     Host: typeof TabsHost;
     Screen: typeof TabsScreen;
 };
-export default Tabs;
 //# sourceMappingURL=index.d.ts.map

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,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,oBAAoB,CAAC;AACxC,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;GAEG;AACH,QAAA,MAAM,IAAI;;;CAGT,CAAC;AAEF,eAAe,IAAI,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,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"}

package/lib/typescript/components/tabs/screen/TabsScreen.android.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { TabsScreenProps } from '../screen/TabsScreen.types';
+/**
+ * EXPERIMENTAL API, MIGHT CHANGE W/O ANY NOTICE
+ */
+declare function TabsScreen(props: TabsScreenProps): React.JSX.Element;
+export default TabsScreen;
+//# sourceMappingURL=TabsScreen.android.d.ts.map

package/lib/typescript/components/tabs/screen/TabsScreen.android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabsScreen.android.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/screen/TabsScreen.android.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIlE;;GAEG;AACH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,qBAiDzC;AAkHD,eAAe,UAAU,CAAC"}

package/lib/typescript/components/tabs/screen/TabsScreen.android.types.d.ts

@@ -0,0 +1,182 @@
+import type { ColorValue, TextStyle } from 'react-native';
+import type { PlatformIconAndroid } from '../../../types';
+export type TabBarItemLabelVisibilityMode = 'auto' | 'selected' | 'labeled' | 'unlabeled';
+export interface TabsScreenItemStateAppearanceAndroid {
+    /**
+     * @summary Specifies the font color used for the title of each tab bar item.
+     *
+     * @platform android
+     */
+    tabBarItemTitleFontColor?: TextStyle['color'] | undefined;
+    /**
+     * @summary Specifies the icon color for each tab bar item.
+     *
+     * @platform android
+     */
+    tabBarItemIconColor?: ColorValue | undefined;
+}
+export interface TabsScreenAppearanceAndroid {
+    /**
+     * @summary Specifies the background color for the entire tab bar.
+     *
+     * @platform android
+     */
+    tabBarBackgroundColor?: ColorValue | undefined;
+    /**
+     * @summary Specifies the color of each tab bar item's ripple effect.
+     *
+     * @platform android
+     */
+    tabBarItemRippleColor?: ColorValue | undefined;
+    /**
+     * @summary Specifies the label visibility mode.
+     *
+     * The label visibility mode defines when the labels of each item bar should be displayed.
+     *
+     * The following values are available:
+     * - `auto` - the label behaves as in “labeled” mode when there are 3 items or less, or as in “selected” mode when there are 4 items or more
+     * - `selected` - the label is only shown on the selected navigation item
+     * - `labeled` - the label is shown on all navigation items
+     * - `unlabeled` - the label is hidden for all navigation items
+     *
+     * The supported values correspond to the official Material Components documentation:
+     * @see {@link https://github.com/material-components/material-components-android/blob/master/docs/components/BottomNavigation.md#making-navigation-bar-accessible|Material Components documentation}
+     *
+     * @default auto
+     *
+     * @platform android
+     */
+    tabBarItemLabelVisibilityMode?: TabBarItemLabelVisibilityMode | undefined;
+    /**
+     * Defines the colors for all tab bar items which are in their enabled, unselected and unfocused state.
+     * The color scheme is determined by the configuration of the currently selected tab.
+     *
+     * @platform android
+     */
+    normal?: TabsScreenItemStateAppearanceAndroid | undefined;
+    /**
+     * Defines the colors for the tab bar item that is currently active.
+     * The color scheme is determined by the configuration of the currently selected tab itself.
+     * Maps to Android `state_selected=true`.
+     *
+     * @platform android
+     */
+    selected?: TabsScreenItemStateAppearanceAndroid | undefined;
+    /**
+     * Defines the colors for a tab bar item when it receives focus.
+     * The color scheme is determined by the configuration of the currently selected tab.
+     * Maps to Android `state_focused=true` (Used mostly for keyboard navigation).
+     *
+     * @platform android
+     */
+    focused?: TabsScreenItemStateAppearanceAndroid | undefined;
+    /**
+     * Defines the colors for tab bar items when they are disabled.
+     * The color scheme is determined by the configuration of the currently selected tab.
+     * Maps to Android `state_enabled=false`.
+     *
+     * @platform android
+     */
+    disabled?: TabsScreenItemStateAppearanceAndroid | undefined;
+    /**
+     * @summary Specifies the background color of the active indicator.
+     *
+     * @platform android
+     */
+    tabBarItemActiveIndicatorColor?: ColorValue | undefined;
+    /**
+     * @summary Specifies if the active indicator should be used.
+     *
+     * @default true
+     *
+     * @platform android
+     */
+    tabBarItemActiveIndicatorEnabled?: boolean | undefined;
+    /**
+     * @summary Specifies the font family used for the title of each tab bar item.
+     *
+     * @platform android
+     */
+    tabBarItemTitleFontFamily?: TextStyle['fontFamily'] | undefined;
+    /**
+     * @summary Specifies the font size used for the title of unselected tab bar items.
+     *
+     * The size is represented in scale-independent pixels (sp).
+     *
+     * @platform android
+     */
+    tabBarItemTitleSmallLabelFontSize?: TextStyle['fontSize'] | undefined;
+    /**
+     * @summary Specifies the font size used for the title of selected tab bar item.
+     *
+     * The size is represented in scale-independent pixels (sp).
+     *
+     * @platform android
+     */
+    tabBarItemTitleLargeLabelFontSize?: TextStyle['fontSize'] | undefined;
+    /**
+     * @summary Specifies the font weight used for the title of each tab bar item.
+     *
+     * @platform android
+     */
+    tabBarItemTitleFontWeight?: TextStyle['fontWeight'] | undefined;
+    /**
+     * @summary Specifies the font style used for the title of each tab bar item.
+     *
+     * @platform android
+     */
+    tabBarItemTitleFontStyle?: TextStyle['fontStyle'] | undefined;
+    /**
+     * @summary Specifies the background color of the badge.
+     *
+     * @platform android
+     */
+    tabBarItemBadgeBackgroundColor?: ColorValue | undefined;
+    /**
+     * @summary Specifies the text color of the badge.
+     *
+     * @platform android
+     */
+    tabBarItemBadgeTextColor?: ColorValue | undefined;
+}
+export interface TabsScreenPropsAndroid {
+    /**
+     * @summary Specifies the standard tab bar appearance.
+     *
+     * Allows to customize the appearance depending on the tab bar item state
+     * (normal, selected, focused, disabled). Configuration for the Bottom Navigation View
+     * is determined by the currently active tab screen.
+     *
+     * @platform android
+     */
+    standardAppearance?: TabsScreenAppearanceAndroid | undefined;
+    /**
+     * @summary Specifies the icon for the tab bar item.
+     *
+     * 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
+     */
+    icon?: PlatformIconAndroid | undefined;
+    /**
+     * @summary Specifies the icon for tab bar item when it is selected.
+     *
+     * Supports the same values as `icon` property for given platform.
+     *
+     * To use `selectedIcon`, `icon` must also be provided.
+     *
+     * @platform android
+     */
+    selectedIcon?: PlatformIconAndroid | undefined;
+}
+//# sourceMappingURL=TabsScreen.android.types.d.ts.map

package/lib/typescript/components/tabs/screen/TabsScreen.android.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabsScreen.android.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/screen/TabsScreen.android.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,MAAM,6BAA6B,GACrC,MAAM,GACN,UAAU,GACV,SAAS,GACT,WAAW,CAAC;AAEhB,MAAM,WAAW,oCAAoC;IACnD;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1D;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/C;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/C;;;;;;;;;;;;;;;;;OAiBG;IACH,6BAA6B,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAC;IAC1E;;;;;OAKG;IACH,MAAM,CAAC,EAAE,oCAAoC,GAAG,SAAS,CAAC;IAC1D;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,oCAAoC,GAAG,SAAS,CAAC;IAC5D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,oCAAoC,GAAG,SAAS,CAAC;IAC3D;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,oCAAoC,GAAG,SAAS,CAAC;IAC5D;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACxD;;;;;;OAMG;IACH,gCAAgC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvD;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IAChE;;;;;;OAMG;IACH,iCAAiC,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IACtE;;;;;;OAMG;IACH,iCAAiC,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IACtE;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IAChE;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAC9D;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACxD;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;IAC7D;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACvC;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAChD"}

package/lib/typescript/components/tabs/{TabsScreen.d.ts → screen/TabsScreen.ios.d.ts}

@@ -5,4 +5,4 @@ import type { TabsScreenProps } from './TabsScreen.types';
  */
 declare function TabsScreen(props: TabsScreenProps): React.JSX.Element;
 export default TabsScreen;
-//# sourceMappingURL=TabsScreen.d.ts.map
+//# sourceMappingURL=TabsScreen.ios.d.ts.map

package/lib/typescript/components/tabs/screen/TabsScreen.ios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabsScreen.ios.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/screen/TabsScreen.ios.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAmB1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D;;GAEG;AACH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,qBAuDzC;AA8ID,eAAe,UAAU,CAAC"}