expo-router 6.0.0-beta.5 → 6.0.0-beta.7

package/build/native-tabs/NativeBottomTabs/types.d.ts

@@ -9,18 +9,12 @@ export interface NativeTabOptions extends DefaultRouterOptions {
      * @platform android
      * @platform iOS
      */
-    icon?: SfSymbolOrImageSource & {
-        /**
-         * The name of the drawable resource to use as an icon.
-         * @platform android
-         */
-        drawable?: string;
-    };
+    icon?: SymbolOrImageSource;
     /**
      * The icon to display when the tab is selected.
      * @platform iOS
      */
-    selectedIcon?: SfSymbolOrImageSource;
+    selectedIcon?: SymbolOrImageSource;
     /**
      * Title of the tab screen, displayed in the tab bar item.
      *
@@ -42,43 +36,69 @@ export interface NativeTabOptions extends DefaultRouterOptions {
      * @platform ios
      */
     badgeValue?: string;
-}
-export type SfSymbolOrImageSource = {
     /**
-     * The name of the SF Symbol to use as an icon.
-     * @platform iOS
+     * The style of the tab label when the tab is selected.
      */
-    sf?: SFSymbol;
-} | {
+    selectedLabelStyle?: NativeTabsLabelStyle;
     /**
-     * The image source to use as an icon.
-     * @platform iOS
+     * The style of all the tab labels, when the tab is selected
      */
-    src?: ImageSourcePropType;
-};
-export interface ExtendedNativeTabOptions extends NativeTabOptions {
+    labelStyle?: NativeTabsLabelStyle;
     /**
-     * If true, the tab will be hidden from the tab bar.
+     * System-provided tab bar item with predefined icon and title
+     *
+     * Uses Apple's built-in tab bar items (e.g., bookmarks, contacts, downloads) with
+     * standard iOS styling and localized titles. Custom `icon` or `selectedIcon`
+     * properties will override the system icon, but the system-defined title cannot
+     * be customized.
+     *
+     * @see {@link https://developer.apple.com/documentation/uikit/uitabbaritem/systemitem|UITabBarItem.SystemItem}
+     * @platform ios
      */
-    hidden?: boolean;
-    specialEffects?: BottomTabsScreenProps['specialEffects'];
-}
-type NumericFontWeight = 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
-export interface NativeTabsStyleType {
-    fontFamily?: TextStyle['fontFamily'];
-    fontSize?: TextStyle['fontSize'];
-    fontWeight?: NumericFontWeight | `${NumericFontWeight}`;
-    fontStyle?: TextStyle['fontStyle'];
-    color?: TextStyle['color'];
+    role?: NativeTabsTabBarItemRole;
+    /**
+     * The color of the icon when the tab is selected.
+     */
+    selectedIconColor?: ColorValue;
+    /**
+     * The color of the badge when the tab is selected.
+     */
+    selectedBadgeBackgroundColor?: ColorValue;
+    /**
+     * The color of all the badges when the tab is selected.
+     */
+    badgeBackgroundColor?: ColorValue;
     /**
+     * The color of the badge text.
+     *
      * @platform android
+     * @platform web
+     */
+    badgeTextColor?: ColorValue;
+    /**
+     * The color of the background when the tab is selected.
+     */
+    backgroundColor?: ColorValue;
+    /**
+     * The blur effect to apply when the tab is selected.
+     *
      * @platform iOS
-     * @platform tvOS
+     */
+    blurEffect?: NativeTabsBlurEffect;
+    /**
+     * The color of the icon when the tab is selected.
+     *
+     * On iOS 26+ you can change the icon color in the scroll edge state.
      */
     iconColor?: ColorValue;
-    backgroundColor?: ColorValue;
     /**
-     * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uitabbaritem/titlepositionadjustment)
+     * When set to `true`, the tab bar will not become transparent when scrolled to the edge.
+     *
+     * @platform iOS
+     */
+    disableTransparentOnScrollEdge?: boolean;
+    /**
+     * The position adjustment for all the labels when the tab is selected.
      *
      * @platform iOS
      */
@@ -87,64 +107,68 @@ export interface NativeTabsStyleType {
         vertical?: number;
     };
     /**
-     * Specifies the blur effect applied to the tab bar.
+     * The position adjustment for the label when the tab is selected.
      *
-     * Works with backgroundColor's alpha < 1.
-     *
-     * This property does not affect the tab bar starting from iOS 26.
-     *
-     * The following values are currently supported:
-     *
-     * - `none`: disables blur effect
-     * - `systemDefault`: uses UIKit's default tab bar blur effect
-     * - one of styles mapped from UIKit's UIBlurEffectStyle. For example, `systemUltraThinMaterial`
-     *
-     * Complete list of possible blur effect styles is available in the official UIKit documentation:
-     * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uiblureffect/style)
-     *
-     * @default systemDefault
-     *
-     * @platform iOS ≤ 18
+     * @platform iOS
      */
-    blurEffect?: NativeTabsBlurEffect;
+    selectedTitlePositionAdjustment?: {
+        horizontal?: number;
+        vertical?: number;
+    };
     /**
+     * The color of the tab indicator.
+     *
      * @platform android
-     * @platform iOS
      * @platform web
      */
-    tintColor?: ColorValue;
-    badgeBackgroundColor?: ColorValue;
+    indicatorColor?: ColorValue;
+}
+export type SymbolOrImageSource = {
     /**
-     * @platform android
-     * @platform web
+     * The name of the SF Symbol to use as an icon.
+     * @platform iOS
      */
-    badgeTextColor?: ColorValue;
+    sf?: SFSymbol;
     /**
+     * The name of the drawable resource to use as an icon.
      * @platform android
      */
-    rippleColor?: ColorValue;
+    drawable?: string;
+} | {
     /**
-     * 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
-     *
-     * @see The supported values correspond to the official [Material Components documentation](https://github.com/material-components/material-components-android/blob/master/docs/components/BottomNavigation.md#making-navigation-bar-accessible).
-     *
-     * @default auto
-     * @platform android
+     * The image source to use as an icon.
      */
-    labelVisibilityMode?: NativeTabsTabBarItemLabelVisibilityMode;
+    src?: ImageSourcePropType | Promise<ImageSourcePropType>;
+};
+export interface ExtendedNativeTabOptions extends NativeTabOptions {
     /**
-     * @platform android
-     * @platform web
+     * If true, the tab will be hidden from the tab bar.
      */
-    '&:active'?: NativeTabsActiveStyleType;
+    hidden?: boolean;
+    specialEffects?: BottomTabsScreenProps['specialEffects'];
+}
+type NumericFontWeight = 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+export interface NativeTabsLabelStyle {
+    /**
+     * The font family of the tab label.
+     */
+    fontFamily?: TextStyle['fontFamily'];
+    /**
+     * The font size of the tab label.
+     */
+    fontSize?: TextStyle['fontSize'];
+    /**
+     * The font weight of the tab label.
+     */
+    fontWeight?: NumericFontWeight | `${NumericFontWeight}`;
+    /**
+     * The font style of the tab label.
+     */
+    fontStyle?: TextStyle['fontStyle'];
+    /**
+     * The color of the tab label.
+     */
+    color?: TextStyle['color'];
 }
 export declare const SUPPORTED_BLUR_EFFECTS: readonly ["none", "systemDefault", "extraLight", "light", "dark", "regular", "prominent", "systemUltraThinMaterial", "systemThinMaterial", "systemMaterial", "systemThickMaterial", "systemChromeMaterial", "systemUltraThinMaterialLight", "systemThinMaterialLight", "systemMaterialLight", "systemThickMaterialLight", "systemChromeMaterialLight", "systemUltraThinMaterialDark", "systemThinMaterialDark", "systemMaterialDark", "systemThickMaterialDark", "systemChromeMaterialDark"];
 /**
@@ -177,7 +201,28 @@ export interface NativeTabsActiveStyleType {
     indicatorColor?: ColorValue;
 }
 export interface NativeTabsProps extends PropsWithChildren {
-    style?: NativeTabsStyleType;
+    /**
+     * The style of the every tab label in the tab bar.
+     */
+    labelStyle?: NativeTabsLabelStyle;
+    /**
+     * The color of every tab icon in the tab bar.
+     */
+    iconColor?: ColorValue;
+    /**
+     * The tint color of the tab icon.
+     *
+     * Can be overridden by icon color and label color for each tab individually.
+     */
+    tintColor?: ColorValue;
+    /**
+     * The background color of the tab bar.
+     */
+    backgroundColor?: ColorValue | null;
+    /**
+     * The background color of every badge in the tab bar.
+     */
+    badgeBackgroundColor?: ColorValue;
     /**
      * Specifies the minimize behavior for the tab bar.
      *
@@ -199,6 +244,27 @@ export interface NativeTabsProps extends PropsWithChildren {
      * @platform iOS 26+
      */
     minimizeBehavior?: NativeTabsTabBarMinimizeBehavior;
+    /**
+     * The blur effect applied to the tab bar.
+     *
+     * @platform iOS
+     */
+    blurEffect?: NativeTabsBlurEffect;
+    /**
+     * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uitabbaritem/titlepositionadjustment)
+     *
+     * @platform iOS
+     */
+    titlePositionAdjustment?: {
+        horizontal?: number;
+        vertical?: number;
+    };
+    /**
+     * When set to `true`, the tab bar will not become transparent when scrolled to the edge.
+     *
+     * @platform iOS
+     */
+    disableTransparentOnScrollEdge?: boolean;
     /**
      * Disables the active indicator for the tab bar.
      *
@@ -211,6 +277,34 @@ export interface NativeTabsProps extends PropsWithChildren {
      * @platform android
      */
     backBehavior?: 'none' | 'initialRoute' | 'history';
+    /**
+     * The visibility mode of the tab item label.
+     *
+     * @see [Material Components documentation](https://github.com/material-components/material-components-android/blob/master/docs/components/BottomNavigation.md#making-navigation-bar-accessible)
+     *
+     * @platform android
+     */
+    labelVisibilityMode?: NativeTabsTabBarItemLabelVisibilityMode;
+    /**
+     * The color of the ripple effect when the tab is pressed.
+     *
+     * @platform android
+     */
+    rippleColor?: ColorValue;
+    /**
+     * The color of the tab indicator.
+     *
+     * @platform android
+     * @platform web
+     */
+    indicatorColor?: ColorValue;
+    /**
+     * The color of the badge text.
+     *
+     * @platform android
+     * @platform web
+     */
+    badgeTextColor?: ColorValue;
 }
 export interface NativeTabsViewProps extends NativeTabsProps {
     focusedIndex: number;
@@ -269,6 +363,70 @@ export interface NativeTabTriggerProps {
      * Use `Icon`, `Label`, and `Badge` components to customize the tab.
      */
     children?: React.ReactNode;
+    /**
+     * System-provided tab bar item with predefined icon and title
+     *
+     * Uses Apple's built-in tab bar items (e.g., bookmarks, contacts, downloads) with
+     * standard iOS styling and localized titles. Custom `icon` or `selectedIcon`
+     * properties will override the system icon, but the system-defined title cannot
+     * be customized.
+     *
+     * @see {@link https://developer.apple.com/documentation/uikit/uitabbaritem/systemitem|UITabBarItem.SystemItem}
+     * @platform ios
+     */
+    role?: NativeTabsTabBarItemRole;
+}
+declare const SUPPORTED_TAB_BAR_ITEM_ROLES: readonly ["bookmarks", "contacts", "downloads", "favorites", "featured", "history", "more", "mostRecent", "mostViewed", "recents", "search", "topRated"];
+export type NativeTabsTabBarItemRole = (typeof SUPPORTED_TAB_BAR_ITEM_ROLES)[number];
+export interface NativeTabsTriggerTabBarProps {
+    /**
+     * The style of the every tab label in the tab bar.
+     *
+     * @platform iOS
+     * @platform web
+     */
+    labelStyle?: NativeTabsLabelStyle;
+    /**
+     * The background color of the tab bar, when the tab is selected
+     */
+    backgroundColor?: ColorValue;
+    /**
+     * The color of every tab icon, when the tab is selected
+     *
+     * @platform iOS
+     */
+    iconColor?: ColorValue;
+    /**
+     * The background color of every badge in the tab bar.
+     *
+     * @platform iOS
+     * @platform web
+     */
+    badgeBackgroundColor?: ColorValue;
+    /**
+     * The blur effect applied to the tab bar, when the tab is selected
+     *
+     * @platform iOS
+     */
+    blurEffect?: NativeTabsBlurEffect;
+    /**
+     * When set to `true`, the tab bar will not become transparent when scrolled to the edge.
+     *
+     * @platform iOS
+     */
+    disableTransparentOnScrollEdge?: boolean;
+    /**
+     * The color of the badge text.
+     *
+     * @platform web
+     */
+    badgeTextColor?: ColorValue;
+    /**
+     * The color of the tab indicator.
+     *
+     * @platform web
+     */
+    indicatorColor?: ColorValue;
 }
 export {};
 //# sourceMappingURL=types.d.ts.map

package/build/native-tabs/NativeBottomTabs/types.d.ts.map

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

package/build/native-tabs/NativeBottomTabs/types.js

@@ -37,4 +37,18 @@ exports.SUPPORTED_TAB_BAR_MINIMIZE_BEHAVIORS = [
     'onScrollDown',
     'onScrollUp',
 ];
+const SUPPORTED_TAB_BAR_ITEM_ROLES = [
+    'bookmarks',
+    'contacts',
+    'downloads',
+    'favorites',
+    'featured',
+    'history',
+    'more',
+    'mostRecent',
+    'mostViewed',
+    'recents',
+    'search',
+    'topRated',
+];
 //# sourceMappingURL=types.js.map

package/build/native-tabs/NativeBottomTabs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/native-tabs/NativeBottomTabs/types.ts"],"names":[],"mappings":";;;AAkKa,QAAA,sBAAsB,GAAG;IACpC,MAAM;IACN,eAAe;IACf,YAAY;IACZ,OAAO;IACP,MAAM;IACN,SAAS;IACT,WAAW;IACX,yBAAyB;IACzB,oBAAoB;IACpB,gBAAgB;IAChB,qBAAqB;IACrB,sBAAsB;IACtB,8BAA8B;IAC9B,yBAAyB;IACzB,qBAAqB;IACrB,0BAA0B;IAC1B,2BAA2B;IAC3B,6BAA6B;IAC7B,wBAAwB;IACxB,oBAAoB;IACpB,yBAAyB;IACzB,0BAA0B;CAClB,CAAC;AAkFE,QAAA,6CAA6C,GAAG;IAC3D,MAAM;IACN,UAAU;IACV,SAAS;IACT,WAAW;CACH,CAAC;AAUE,QAAA,oCAAoC,GAAG;IAClD,WAAW;IACX,OAAO;IACP,cAAc;IACd,YAAY;CACJ,CAAC","sourcesContent":["import type {\n  DefaultRouterOptions,\n  ParamListBase,\n  TabNavigationState,\n  TabRouterOptions,\n  useNavigationBuilder,\n} from '@react-navigation/native';\nimport type { PropsWithChildren } from 'react';\nimport type { ColorValue, ImageSourcePropType, TextStyle } from 'react-native';\nimport type { BottomTabsScreenProps } from 'react-native-screens';\nimport type { SFSymbol } from 'sf-symbols-typescript';\n\nexport interface NativeTabOptions extends DefaultRouterOptions {\n  /**\n   * The icon to display in the tab bar.\n   * @platform android\n   * @platform iOS\n   */\n  icon?: SfSymbolOrImageSource & {\n    /**\n     * The name of the drawable resource to use as an icon.\n     * @platform android\n     */\n    drawable?: string;\n  };\n  /**\n   * The icon to display when the tab is selected.\n   * @platform iOS\n   */\n  selectedIcon?: SfSymbolOrImageSource;\n  /**\n   * Title of the tab screen, displayed in the tab bar item.\n   *\n   * @platform android\n   * @platform iOS\n   */\n  title?: string;\n  /**\n   * Specifies content of tab bar item badge.\n   *\n   * On Android, the value is interpreted in the following order:\n   * - If the string can be parsed to integer, displays the value as a number\n   * - Otherwise if the string is empty, displays \"small dot\" badge\n   * - Otherwise, displays the value as a text\n   *\n   * On iOS, badge is displayed as regular string.\n   *\n   * @platform android\n   * @platform ios\n   */\n  badgeValue?: string;\n}\n\nexport type SfSymbolOrImageSource =\n  | {\n      /**\n       * The name of the SF Symbol to use as an icon.\n       * @platform iOS\n       */\n      sf?: SFSymbol;\n    }\n  | {\n      /**\n       * The image source to use as an icon.\n       * @platform iOS\n       */\n      src?: ImageSourcePropType;\n    };\n\nexport interface ExtendedNativeTabOptions extends NativeTabOptions {\n  /**\n   * If true, the tab will be hidden from the tab bar.\n   */\n  hidden?: boolean;\n  specialEffects?: BottomTabsScreenProps['specialEffects'];\n}\n\ntype NumericFontWeight = 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n\nexport interface NativeTabsStyleType {\n  fontFamily?: TextStyle['fontFamily'];\n  fontSize?: TextStyle['fontSize'];\n  fontWeight?: NumericFontWeight | `${NumericFontWeight}`;\n  fontStyle?: TextStyle['fontStyle'];\n  color?: TextStyle['color'];\n  /**\n   * @platform android\n   * @platform iOS\n   * @platform tvOS\n   */\n  iconColor?: ColorValue;\n  backgroundColor?: ColorValue;\n  /**\n   * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uitabbaritem/titlepositionadjustment)\n   *\n   * @platform iOS\n   */\n  titlePositionAdjustment?: {\n    horizontal?: number;\n    vertical?: number;\n  };\n  /**\n   * Specifies the blur effect applied to the tab bar.\n   *\n   * Works with backgroundColor's alpha < 1.\n   *\n   * This property does not affect the tab bar starting from iOS 26.\n   *\n   * The following values are currently supported:\n   *\n   * - `none`: disables blur effect\n   * - `systemDefault`: uses UIKit's default tab bar blur effect\n   * - one of styles mapped from UIKit's UIBlurEffectStyle. For example, `systemUltraThinMaterial`\n   *\n   * Complete list of possible blur effect styles is available in the official UIKit documentation:\n   * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uiblureffect/style)\n   *\n   * @default systemDefault\n   *\n   * @platform iOS ≤ 18\n   */\n  blurEffect?: NativeTabsBlurEffect;\n  /**\n   * @platform android\n   * @platform iOS\n   * @platform web\n   */\n  tintColor?: ColorValue;\n  badgeBackgroundColor?: ColorValue;\n  /**\n   * @platform android\n   * @platform web\n   */\n  badgeTextColor?: ColorValue;\n  /**\n   * @platform android\n   */\n  rippleColor?: ColorValue;\n  /**\n   * Specifies the label visibility mode.\n   *\n   * The label visibility mode defines when the labels of each item bar should be displayed.\n   *\n   * The following values are available:\n   * - `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\n   * - `selected`: the label is only shown on the selected navigation item\n   * - `labeled`: the label is shown on all navigation items\n   * - `unlabeled`: the label is hidden for all navigation items\n   *\n   * @see The supported values correspond to the official [Material Components documentation](https://github.com/material-components/material-components-android/blob/master/docs/components/BottomNavigation.md#making-navigation-bar-accessible).\n   *\n   * @default auto\n   * @platform android\n   */\n  labelVisibilityMode?: NativeTabsTabBarItemLabelVisibilityMode;\n  /**\n   * @platform android\n   * @platform web\n   */\n  '&:active'?: NativeTabsActiveStyleType;\n}\n\nexport const SUPPORTED_BLUR_EFFECTS = [\n  'none',\n  'systemDefault',\n  'extraLight',\n  'light',\n  'dark',\n  'regular',\n  'prominent',\n  'systemUltraThinMaterial',\n  'systemThinMaterial',\n  'systemMaterial',\n  'systemThickMaterial',\n  'systemChromeMaterial',\n  'systemUltraThinMaterialLight',\n  'systemThinMaterialLight',\n  'systemMaterialLight',\n  'systemThickMaterialLight',\n  'systemChromeMaterialLight',\n  'systemUltraThinMaterialDark',\n  'systemThinMaterialDark',\n  'systemMaterialDark',\n  'systemThickMaterialDark',\n  'systemChromeMaterialDark',\n] as const;\n\n/**\n * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uiblureffect/style)\n */\nexport type NativeTabsBlurEffect = (typeof SUPPORTED_BLUR_EFFECTS)[number];\n\n/**\n * @platform android\n * @platform web\n */\nexport interface NativeTabsActiveStyleType {\n  /**\n   * @platform android\n   * @platform web\n   */\n  color?: ColorValue;\n  /**\n   * @platform android\n   * @platform web\n   */\n  fontSize?: TextStyle['fontSize'];\n  /**\n   * @platform android\n   */\n  iconColor?: ColorValue;\n  /**\n   * @platform android\n   * @platform web\n   */\n  indicatorColor?: ColorValue;\n}\n\nexport interface NativeTabsProps extends PropsWithChildren {\n  style?: NativeTabsStyleType;\n  /**\n   * Specifies the minimize behavior for the tab bar.\n   *\n   * Available starting from iOS 26.\n   *\n   * The following values are currently supported:\n   *\n   * - `automatic` - resolves to the system default minimize behavior\n   * - `never` - the tab bar does not minimize\n   * - `onScrollDown` - the tab bar minimizes when scrolling down and\n   *   expands when scrolling back up\n   * - `onScrollUp` - the tab bar minimizes when scrolling up and expands\n   *   when scrolling back down\n   *\n   * @see The supported values correspond to the official [UIKit documentation](https://developer.apple.com/documentation/uikit/uitabbarcontroller/minimizebehavior).\n   *\n   * @default automatic\n   *\n   * @platform iOS 26+\n   */\n  minimizeBehavior?: NativeTabsTabBarMinimizeBehavior;\n  /**\n   * Disables the active indicator for the tab bar.\n   *\n   * @platform android\n   */\n  disableIndicator?: boolean;\n  /**\n   * The behavior when navigating back with the back button.\n   *\n   * @platform android\n   */\n  backBehavior?: 'none' | 'initialRoute' | 'history';\n}\nexport interface NativeTabsViewProps extends NativeTabsProps {\n  focusedIndex: number;\n  builder: ReturnType<\n    typeof useNavigationBuilder<\n      TabNavigationState<ParamListBase>,\n      TabRouterOptions,\n      Record<string, (...args: any) => void>,\n      NativeTabOptions,\n      Record<string, any>\n    >\n  >;\n}\n\nexport const SUPPORTED_TAB_BAR_ITEM_LABEL_VISIBILITY_MODES = [\n  'auto',\n  'selected',\n  'labeled',\n  'unlabeled',\n] as const;\n\n/**\n * @see [Material Components documentation](https://github.com/material-components/material-components-android/blob/master/docs/components/BottomNavigation.md#making-navigation-bar-accessible)\n *\n * @platform android\n */\nexport type NativeTabsTabBarItemLabelVisibilityMode =\n  (typeof SUPPORTED_TAB_BAR_ITEM_LABEL_VISIBILITY_MODES)[number];\n\nexport const SUPPORTED_TAB_BAR_MINIMIZE_BEHAVIORS = [\n  'automatic',\n  'never',\n  'onScrollDown',\n  'onScrollUp',\n] as const;\n\n/**\n * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uitabbarcontroller/minimizebehavior)\n *\n * @platform iOS 26\n */\nexport type NativeTabsTabBarMinimizeBehavior =\n  (typeof SUPPORTED_TAB_BAR_MINIMIZE_BEHAVIORS)[number];\n\nexport interface NativeTabTriggerProps {\n  /**\n   * The name of the route.\n   *\n   * This is required when used inside a Layout component.\n   *\n   * When used in a route it has no effect.\n   */\n  name?: string;\n  /**\n   * If true, the tab will be hidden from the tab bar.\n   */\n  hidden?: boolean;\n  /**\n   * The options for the trigger.\n   *\n   * Use `Icon`, `Label`, and `Badge` components as children to customize the tab, rather then raw options.\n   */\n  options?: NativeTabOptions;\n  /**\n   * If true, the tab will not pop stack to the root when selected again.\n   *\n   * @default false\n   * @platform iOS\n   */\n  disablePopToTop?: boolean;\n  /**\n   * If true, the tab will not scroll to the top when selected again.\n   * @default false\n   *\n   * @platform iOS\n   */\n  disableScrollToTop?: boolean;\n  /**\n   * The children of the trigger.\n   *\n   * Use `Icon`, `Label`, and `Badge` components to customize the tab.\n   */\n  children?: React.ReactNode;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/native-tabs/NativeBottomTabs/types.ts"],"names":[],"mappings":";;;AA0La,QAAA,sBAAsB,GAAG;IACpC,MAAM;IACN,eAAe;IACf,YAAY;IACZ,OAAO;IACP,MAAM;IACN,SAAS;IACT,WAAW;IACX,yBAAyB;IACzB,oBAAoB;IACpB,gBAAgB;IAChB,qBAAqB;IACrB,sBAAsB;IACtB,8BAA8B;IAC9B,yBAAyB;IACzB,qBAAqB;IACrB,0BAA0B;IAC1B,2BAA2B;IAC3B,6BAA6B;IAC7B,wBAAwB;IACxB,oBAAoB;IACpB,yBAAyB;IACzB,0BAA0B;CAClB,CAAC;AA+JE,QAAA,6CAA6C,GAAG;IAC3D,MAAM;IACN,UAAU;IACV,SAAS;IACT,WAAW;CACH,CAAC;AAUE,QAAA,oCAAoC,GAAG;IAClD,WAAW;IACX,OAAO;IACP,cAAc;IACd,YAAY;CACJ,CAAC;AA+DX,MAAM,4BAA4B,GAAG;IACnC,WAAW;IACX,UAAU;IACV,WAAW;IACX,WAAW;IACX,UAAU;IACV,SAAS;IACT,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,QAAQ;IACR,UAAU;CACF,CAAC","sourcesContent":["import type {\n  DefaultRouterOptions,\n  ParamListBase,\n  TabNavigationState,\n  TabRouterOptions,\n  useNavigationBuilder,\n} from '@react-navigation/native';\nimport type { PropsWithChildren } from 'react';\nimport type { ColorValue, ImageSourcePropType, TextStyle } from 'react-native';\nimport type { BottomTabsScreenProps } from 'react-native-screens';\nimport type { SFSymbol } from 'sf-symbols-typescript';\n\nexport interface NativeTabOptions extends DefaultRouterOptions {\n  /**\n   * The icon to display in the tab bar.\n   * @platform android\n   * @platform iOS\n   */\n  icon?: SymbolOrImageSource;\n  /**\n   * The icon to display when the tab is selected.\n   * @platform iOS\n   */\n  selectedIcon?: SymbolOrImageSource;\n  /**\n   * Title of the tab screen, displayed in the tab bar item.\n   *\n   * @platform android\n   * @platform iOS\n   */\n  title?: string;\n  /**\n   * Specifies content of tab bar item badge.\n   *\n   * On Android, the value is interpreted in the following order:\n   * - If the string can be parsed to integer, displays the value as a number\n   * - Otherwise if the string is empty, displays \"small dot\" badge\n   * - Otherwise, displays the value as a text\n   *\n   * On iOS, badge is displayed as regular string.\n   *\n   * @platform android\n   * @platform ios\n   */\n  badgeValue?: string;\n  /**\n   * The style of the tab label when the tab is selected.\n   */\n  selectedLabelStyle?: NativeTabsLabelStyle;\n  /**\n   * The style of all the tab labels, when the tab is selected\n   */\n  labelStyle?: NativeTabsLabelStyle;\n  /**\n   * System-provided tab bar item with predefined icon and title\n   *\n   * Uses Apple's built-in tab bar items (e.g., bookmarks, contacts, downloads) with\n   * standard iOS styling and localized titles. Custom `icon` or `selectedIcon`\n   * properties will override the system icon, but the system-defined title cannot\n   * be customized.\n   *\n   * @see {@link https://developer.apple.com/documentation/uikit/uitabbaritem/systemitem|UITabBarItem.SystemItem}\n   * @platform ios\n   */\n  role?: NativeTabsTabBarItemRole;\n  /**\n   * The color of the icon when the tab is selected.\n   */\n  selectedIconColor?: ColorValue;\n  /**\n   * The color of the badge when the tab is selected.\n   */\n  selectedBadgeBackgroundColor?: ColorValue;\n  /**\n   * The color of all the badges when the tab is selected.\n   */\n  badgeBackgroundColor?: ColorValue;\n  /**\n   * The color of the badge text.\n   *\n   * @platform android\n   * @platform web\n   */\n  badgeTextColor?: ColorValue;\n  /**\n   * The color of the background when the tab is selected.\n   */\n  backgroundColor?: ColorValue;\n  /**\n   * The blur effect to apply when the tab is selected.\n   *\n   * @platform iOS\n   */\n  blurEffect?: NativeTabsBlurEffect;\n  /**\n   * The color of the icon when the tab is selected.\n   *\n   * On iOS 26+ you can change the icon color in the scroll edge state.\n   */\n  iconColor?: ColorValue;\n  /**\n   * When set to `true`, the tab bar will not become transparent when scrolled to the edge.\n   *\n   * @platform iOS\n   */\n  disableTransparentOnScrollEdge?: boolean;\n  /**\n   * The position adjustment for all the labels when the tab is selected.\n   *\n   * @platform iOS\n   */\n  titlePositionAdjustment?: {\n    horizontal?: number;\n    vertical?: number;\n  };\n  /**\n   * The position adjustment for the label when the tab is selected.\n   *\n   * @platform iOS\n   */\n  selectedTitlePositionAdjustment?: {\n    horizontal?: number;\n    vertical?: number;\n  };\n  /**\n   * The color of the tab indicator.\n   *\n   * @platform android\n   * @platform web\n   */\n  indicatorColor?: ColorValue;\n}\n\nexport type SymbolOrImageSource =\n  | {\n      /**\n       * The name of the SF Symbol to use as an icon.\n       * @platform iOS\n       */\n      sf?: SFSymbol;\n      /**\n       * The name of the drawable resource to use as an icon.\n       * @platform android\n       */\n      drawable?: string;\n    }\n  | {\n      /**\n       * The image source to use as an icon.\n       */\n      src?: ImageSourcePropType | Promise<ImageSourcePropType>;\n    };\n\nexport interface ExtendedNativeTabOptions extends NativeTabOptions {\n  /**\n   * If true, the tab will be hidden from the tab bar.\n   */\n  hidden?: boolean;\n  specialEffects?: BottomTabsScreenProps['specialEffects'];\n}\n\ntype NumericFontWeight = 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n\nexport interface NativeTabsLabelStyle {\n  /**\n   * The font family of the tab label.\n   */\n  fontFamily?: TextStyle['fontFamily'];\n  /**\n   * The font size of the tab label.\n   */\n  fontSize?: TextStyle['fontSize'];\n  /**\n   * The font weight of the tab label.\n   */\n  fontWeight?: NumericFontWeight | `${NumericFontWeight}`;\n  /**\n   * The font style of the tab label.\n   */\n  fontStyle?: TextStyle['fontStyle'];\n  /**\n   * The color of the tab label.\n   */\n  color?: TextStyle['color'];\n}\n\nexport const SUPPORTED_BLUR_EFFECTS = [\n  'none',\n  'systemDefault',\n  'extraLight',\n  'light',\n  'dark',\n  'regular',\n  'prominent',\n  'systemUltraThinMaterial',\n  'systemThinMaterial',\n  'systemMaterial',\n  'systemThickMaterial',\n  'systemChromeMaterial',\n  'systemUltraThinMaterialLight',\n  'systemThinMaterialLight',\n  'systemMaterialLight',\n  'systemThickMaterialLight',\n  'systemChromeMaterialLight',\n  'systemUltraThinMaterialDark',\n  'systemThinMaterialDark',\n  'systemMaterialDark',\n  'systemThickMaterialDark',\n  'systemChromeMaterialDark',\n] as const;\n\n/**\n * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uiblureffect/style)\n */\nexport type NativeTabsBlurEffect = (typeof SUPPORTED_BLUR_EFFECTS)[number];\n\n/**\n * @platform android\n * @platform web\n */\nexport interface NativeTabsActiveStyleType {\n  /**\n   * @platform android\n   * @platform web\n   */\n  color?: ColorValue;\n  /**\n   * @platform android\n   * @platform web\n   */\n  fontSize?: TextStyle['fontSize'];\n  /**\n   * @platform android\n   */\n  iconColor?: ColorValue;\n  /**\n   * @platform android\n   * @platform web\n   */\n  indicatorColor?: ColorValue;\n}\n\nexport interface NativeTabsProps extends PropsWithChildren {\n  // #region common props\n  /**\n   * The style of the every tab label in the tab bar.\n   */\n  labelStyle?: NativeTabsLabelStyle;\n  // disabledLabelStyle?: NativeTabsLabelStyle;\n  /**\n   * The color of every tab icon in the tab bar.\n   */\n  iconColor?: ColorValue;\n  /**\n   * The tint color of the tab icon.\n   *\n   * Can be overridden by icon color and label color for each tab individually.\n   */\n  tintColor?: ColorValue;\n  /**\n   * The background color of the tab bar.\n   */\n  backgroundColor?: ColorValue | null;\n  /**\n   * The background color of every badge in the tab bar.\n   */\n  badgeBackgroundColor?: ColorValue;\n  // #endregion common props\n  // #region iOS props\n  /**\n   * Specifies the minimize behavior for the tab bar.\n   *\n   * Available starting from iOS 26.\n   *\n   * The following values are currently supported:\n   *\n   * - `automatic` - resolves to the system default minimize behavior\n   * - `never` - the tab bar does not minimize\n   * - `onScrollDown` - the tab bar minimizes when scrolling down and\n   *   expands when scrolling back up\n   * - `onScrollUp` - the tab bar minimizes when scrolling up and expands\n   *   when scrolling back down\n   *\n   * @see The supported values correspond to the official [UIKit documentation](https://developer.apple.com/documentation/uikit/uitabbarcontroller/minimizebehavior).\n   *\n   * @default automatic\n   *\n   * @platform iOS 26+\n   */\n  minimizeBehavior?: NativeTabsTabBarMinimizeBehavior;\n  /**\n   * The blur effect applied to the tab bar.\n   *\n   * @platform iOS\n   */\n  blurEffect?: NativeTabsBlurEffect;\n  /**\n   * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uitabbaritem/titlepositionadjustment)\n   *\n   * @platform iOS\n   */\n  titlePositionAdjustment?: {\n    horizontal?: number;\n    vertical?: number;\n  };\n  /**\n   * When set to `true`, the tab bar will not become transparent when scrolled to the edge.\n   *\n   * @platform iOS\n   */\n  disableTransparentOnScrollEdge?: boolean;\n  // #endregion iOS props\n  // #region android props\n  /**\n   * Disables the active indicator for the tab bar.\n   *\n   * @platform android\n   */\n  disableIndicator?: boolean;\n  /**\n   * The behavior when navigating back with the back button.\n   *\n   * @platform android\n   */\n  backBehavior?: 'none' | 'initialRoute' | 'history';\n  /**\n   * The visibility mode of the tab item label.\n   *\n   * @see [Material Components documentation](https://github.com/material-components/material-components-android/blob/master/docs/components/BottomNavigation.md#making-navigation-bar-accessible)\n   *\n   * @platform android\n   */\n  labelVisibilityMode?: NativeTabsTabBarItemLabelVisibilityMode;\n  /**\n   * The color of the ripple effect when the tab is pressed.\n   *\n   * @platform android\n   */\n  rippleColor?: ColorValue;\n  /**\n   * The color of the tab indicator.\n   *\n   * @platform android\n   * @platform web\n   */\n  indicatorColor?: ColorValue;\n  /**\n   * The color of the badge text.\n   *\n   * @platform android\n   * @platform web\n   */\n  badgeTextColor?: ColorValue;\n  // #endregion android props\n}\nexport interface NativeTabsViewProps extends NativeTabsProps {\n  focusedIndex: number;\n  builder: ReturnType<\n    typeof useNavigationBuilder<\n      TabNavigationState<ParamListBase>,\n      TabRouterOptions,\n      Record<string, (...args: any) => void>,\n      NativeTabOptions,\n      Record<string, any>\n    >\n  >;\n}\n\nexport const SUPPORTED_TAB_BAR_ITEM_LABEL_VISIBILITY_MODES = [\n  'auto',\n  'selected',\n  'labeled',\n  'unlabeled',\n] as const;\n\n/**\n * @see [Material Components documentation](https://github.com/material-components/material-components-android/blob/master/docs/components/BottomNavigation.md#making-navigation-bar-accessible)\n *\n * @platform android\n */\nexport type NativeTabsTabBarItemLabelVisibilityMode =\n  (typeof SUPPORTED_TAB_BAR_ITEM_LABEL_VISIBILITY_MODES)[number];\n\nexport const SUPPORTED_TAB_BAR_MINIMIZE_BEHAVIORS = [\n  'automatic',\n  'never',\n  'onScrollDown',\n  'onScrollUp',\n] as const;\n\n/**\n * @see [Apple documentation](https://developer.apple.com/documentation/uikit/uitabbarcontroller/minimizebehavior)\n *\n * @platform iOS 26\n */\nexport type NativeTabsTabBarMinimizeBehavior =\n  (typeof SUPPORTED_TAB_BAR_MINIMIZE_BEHAVIORS)[number];\n\nexport interface NativeTabTriggerProps {\n  /**\n   * The name of the route.\n   *\n   * This is required when used inside a Layout component.\n   *\n   * When used in a route it has no effect.\n   */\n  name?: string;\n  /**\n   * If true, the tab will be hidden from the tab bar.\n   */\n  hidden?: boolean;\n  /**\n   * The options for the trigger.\n   *\n   * Use `Icon`, `Label`, and `Badge` components as children to customize the tab, rather then raw options.\n   */\n  options?: NativeTabOptions;\n  /**\n   * If true, the tab will not pop stack to the root when selected again.\n   *\n   * @default false\n   * @platform iOS\n   */\n  disablePopToTop?: boolean;\n  /**\n   * If true, the tab will not scroll to the top when selected again.\n   * @default false\n   *\n   * @platform iOS\n   */\n  disableScrollToTop?: boolean;\n  /**\n   * The children of the trigger.\n   *\n   * Use `Icon`, `Label`, and `Badge` components to customize the tab.\n   */\n  children?: React.ReactNode;\n  /**\n   * System-provided tab bar item with predefined icon and title\n   *\n   * Uses Apple's built-in tab bar items (e.g., bookmarks, contacts, downloads) with\n   * standard iOS styling and localized titles. Custom `icon` or `selectedIcon`\n   * properties will override the system icon, but the system-defined title cannot\n   * be customized.\n   *\n   * @see {@link https://developer.apple.com/documentation/uikit/uitabbaritem/systemitem|UITabBarItem.SystemItem}\n   * @platform ios\n   */\n  role?: NativeTabsTabBarItemRole;\n}\n\nconst SUPPORTED_TAB_BAR_ITEM_ROLES = [\n  'bookmarks',\n  'contacts',\n  'downloads',\n  'favorites',\n  'featured',\n  'history',\n  'more',\n  'mostRecent',\n  'mostViewed',\n  'recents',\n  'search',\n  'topRated',\n] as const;\n\nexport type NativeTabsTabBarItemRole = (typeof SUPPORTED_TAB_BAR_ITEM_ROLES)[number];\n\nexport interface NativeTabsTriggerTabBarProps {\n  /**\n   * The style of the every tab label in the tab bar.\n   *\n   * @platform iOS\n   * @platform web\n   */\n  labelStyle?: NativeTabsLabelStyle;\n  /**\n   * The background color of the tab bar, when the tab is selected\n   */\n  backgroundColor?: ColorValue;\n  /**\n   * The color of every tab icon, when the tab is selected\n   *\n   * @platform iOS\n   */\n  iconColor?: ColorValue;\n  /**\n   * The background color of every badge in the tab bar.\n   *\n   * @platform iOS\n   * @platform web\n   */\n  badgeBackgroundColor?: ColorValue;\n  /**\n   * The blur effect applied to the tab bar, when the tab is selected\n   *\n   * @platform iOS\n   */\n  blurEffect?: NativeTabsBlurEffect;\n  /**\n   * When set to `true`, the tab bar will not become transparent when scrolled to the edge.\n   *\n   * @platform iOS\n   */\n  disableTransparentOnScrollEdge?: boolean;\n  /**\n   * The color of the badge text.\n   *\n   * @platform web\n   */\n  badgeTextColor?: ColorValue;\n  /**\n   * The color of the tab indicator.\n   *\n   * @platform web\n   */\n  indicatorColor?: ColorValue;\n}\n"]}

package/build/native-tabs/common/elements.d.ts

@@ -1,10 +1,12 @@
-import type { ImageSourcePropType } from 'react-native';
+import type { ColorValue, ImageSourcePropType } from 'react-native';
 import type { SFSymbol } from 'sf-symbols-typescript';
+import type { NativeTabsLabelStyle } from '../NativeBottomTabs/types';
 export interface LabelProps {
     /**
      * The text to display as the label for the tab.
      */
     children?: string;
+    selectedStyle?: NativeTabsLabelStyle;
     /**
      * If true, the label will be hidden.
      * @default false
@@ -15,42 +17,65 @@ export declare function Label(props: LabelProps): null;
 export interface SourceIconCombination {
     /**
      * The image source to use as an icon.
+     *
+     * The value can be provided in two ways:
+     * - As an image source
+     * - As an object specifying the default and selected states
+     *
+     * @example
+     * ```tsx
+     * <Icon src={require('./path/to/icon.png')} />
+     * ```
+     *
+     * @example
+     * ```tsx
+     * <Icon src={{ default: require('./path/to/icon.png'), selected: require('./path/to/icon-selected.png') }} />
+     * ```
+     *
+     * @platform Android
      * @platform iOS
      */
-    src?: ImageSourcePropType;
-    /**
-     * The image source to use as an icon when the tab is selected.
-     * @platform iOS
-     */
-    selectedSrc?: ImageSourcePropType;
-    /**
-     * The name of the drawable resource to use as an icon.
-     * @platform android
-     */
-    drawable?: string;
+    src?: ImageSourcePropType | React.ReactElement | {
+        default?: ImageSourcePropType | React.ReactElement;
+        selected: ImageSourcePropType | React.ReactElement;
+    };
+    drawable?: never;
     sf?: never;
-    selectedSf?: never;
 }
 export interface NamedIconCombination {
     /**
      * The name of the SF Symbol to use as an icon.
+     *
+     * The value can be provided in two ways:
+     * - As a string with the SF Symbol name
+     * - As an object specifying the default and selected states
+     *
+     * @example
+     * ```tsx
+     * <Icon sf="magnifyingglass" />
+     * ```
+     *
+     * @example
+     * ```tsx
+     * <Icon sf={{ default: "house", selected: "house.fill" }} />
+     * ```
+     *
      * @platform iOS
      */
-    sf?: SFSymbol;
-    /**
-     * The name of the SF Symbol to use as an icon when the tab is selected.
-     * @platform iOS
-     */
-    selectedSf?: SFSymbol;
+    sf?: SFSymbol | {
+        default?: SFSymbol;
+        selected: SFSymbol;
+    };
     /**
      * The name of the drawable resource to use as an icon.
      * @platform android
      */
     drawable?: string;
     src?: never;
-    selectedSrc?: never;
 }
-export type IconProps = NamedIconCombination | SourceIconCombination;
+export type IconProps = {
+    selectedColor?: ColorValue;
+} & (NamedIconCombination | SourceIconCombination);
 /**
  * Renders an icon for the tab.
  *
@@ -58,6 +83,43 @@ export type IconProps = NamedIconCombination | SourceIconCombination;
  * @platform android
  */
 export declare function Icon(props: IconProps): null;
+export interface VectorIconProps<NameT extends string> {
+    /**
+     * The family of the vector icon.
+     *
+     * @example
+     * ```tsx
+     * import MaterialCommunityIcons from '@expo/vector-icons/MaterialCommunityIcons';
+     * ```
+     */
+    family: {
+        getImageSource: (name: NameT, size: number, color: ColorValue) => Promise<ImageSourcePropType>;
+    };
+    /**
+     * The name of the vector icon.
+     */
+    name: NameT;
+}
+/**
+ * Helper component which can be used to load vector icons for `NativeTabs`.
+ *
+ * @example
+ * ```tsx
+ * import { NativeTabs, VectorIcon } from 'expo-router';
+ * import MaterialCommunityIcons from '@expo/vector-icons/MaterialCommunityIcons';
+ *
+ * export default Layout(){
+ *   return (
+ *     <NativeTabs>
+ *       <NativeTabs.Trigger name="index">
+ *         <Icon src={<VectorIcon family={MaterialCommunityIcons} name="home" />} />
+ *       </NativeTabs.Trigger>
+ *     </NativeTabs>
+ *   );
+ * }
+ * ```
+ */
+export declare function VectorIcon<NameT extends string>(props: VectorIconProps<NameT>): null;
 export interface BadgeProps {
     /**
      * The text to display as the badge for the tab.
@@ -69,6 +131,7 @@ export interface BadgeProps {
      * @default false
      */
     hidden?: boolean;
+    selectedBackgroundColor?: ColorValue;
 }
 export declare function Badge(props: BadgeProps): null;
 //# sourceMappingURL=elements.d.ts.map

package/build/native-tabs/common/elements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../../src/native-tabs/common/elements.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,QAEtC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED,MAAM,MAAM,SAAS,GAAG,oBAAoB,GAAG,qBAAqB,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,QAEpC;AAED,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,QAEtC"}
+{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../../src/native-tabs/common/elements.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,QAEtC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,EACA,mBAAmB,GACnB,KAAK,CAAC,YAAY,GAClB;QACE,OAAO,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAAC;QACnD,QAAQ,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAAC;KACpD,CAAC;IACN,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,EAAE,CAAC,EAAE,KAAK,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;;;;;;;OAkBG;IACH,EAAE,CAAC,EAAE,QAAQ,GAAG;QAAE,OAAO,CAAC,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC3D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,aAAa,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,CACrD,oBAAoB,GACpB,qBAAqB,CACxB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,QAEpC;AAED,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM;IACnD;;;;;;;OAOG;IACH,MAAM,EAAE;QACN,cAAc,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;KAChG,CAAC;IACF;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,QAE7E;AAED,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uBAAuB,CAAC,EAAE,UAAU,CAAC;CACtC;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,QAEtC"}