feat(Android, Tabs): add prop to hide the tab bar (#3344)

## Description

Adds support for `tabBarHidden` prop in `TabsHost`.


https://github.com/user-attachments/assets/35fccc4b-e457-4f53-9a1a-17c3ee188fba

## Changes

- handle `tabBarHidden` prop on Android
- update SAV interface insets on tab bar visibility change

## Test code and steps to reproduce

Run `TestBottomTabs`, add `tabBarHidden` prop, observe dynamic changes.

## Checklist

- [x] Included code example that can be used to test this change
- [x] Updated TS types
- [x] Updated documentation: <!-- For adding new props to native-stack
-->
- [ ]
https://github.com/software-mansion/react-native-screens/blob/main/guides/GUIDE_FOR_LIBRARY_AUTHORS.md
- [ ]
https://github.com/software-mansion/react-native-screens/blob/main/native-stack/README.md
- [ ]
https://github.com/software-mansion/react-native-screens/blob/main/src/types.tsx
- [ ]
https://github.com/software-mansion/react-native-screens/blob/main/src/native-stack/types.tsx
- [x] Ensured that CI passes

Author: kligarski

android/src/main/java/com/swmansion/rnscreens/gamma/tabs/TabsHost.kt

@@ -193,6 +193,13 @@ class TabsHost(
         updateNavigationMenuIfNeeded(oldValue, newValue)
     }
 
+    var tabBarHidden: Boolean by Delegates.observable(false) { _, oldValue, newValue ->
+        if (newValue != oldValue) {
+            updateInterfaceInsets()
+            updateNavigationMenuIfNeeded(oldValue, newValue)
+        }
+    }
+
     private fun <T> updateNavigationMenuIfNeeded(
         oldValue: T,
         newValue: T,
@@ -491,9 +498,15 @@ class TabsHost(
         val newHeight = bottom - top
 
         if (newHeight != oldHeight) {
-            interfaceInsetsChangeListener?.apply {
-                this.onInterfaceInsetsChange(EdgeInsets(0.0f, 0.0f, 0.0f, newHeight.toFloat()))
-            }
+            updateInterfaceInsets(newHeight)
+        }
+    }
+
+    private fun updateInterfaceInsets(newHeight: Int? = null) {
+        val height = if (tabBarHidden) 0 else (newHeight ?: bottomNavigationView.height)
+
+        interfaceInsetsChangeListener?.apply {
+            this.onInterfaceInsetsChange(EdgeInsets(0.0f, 0.0f, 0.0f, height.toFloat()))
         }
     }
 

android/src/main/java/com/swmansion/rnscreens/gamma/tabs/TabsHostAppearanceApplicator.kt

@@ -26,7 +26,7 @@ class TabsHostAppearanceApplicator(
     }
 
     fun updateSharedAppearance(tabsHost: TabsHost) {
-        bottomNavigationView.isVisible = true
+        bottomNavigationView.isVisible = !tabsHost.tabBarHidden
         bottomNavigationView.setBackgroundColor(
             tabsHost.tabBarBackgroundColor
                 ?: resolveColorAttr(com.google.android.material.R.attr.colorSurfaceContainer),

android/src/main/java/com/swmansion/rnscreens/gamma/tabs/TabsHostViewManager.kt

@@ -142,10 +142,13 @@ class TabsHostViewManager :
         value: String?,
     ) = Unit
 
+    @ReactProp(name = "tabBarHidden")
     override fun setTabBarHidden(
         view: TabsHost,
         value: Boolean,
-    ) = Unit
+    ) {
+        view.tabBarHidden = value
+    }
 
     // Android additional
 

src/components/bottom-tabs/BottomTabs.types.ts

@@ -38,6 +38,15 @@ export interface BottomTabsProps extends ViewProps {
   ) => void;
   // #endregion Events
 
+  // #region General
+  /**
+   * @summary Hides the tab bar.
+   *
+   * @default false
+   */
+  tabBarHidden?: boolean;
+  // #endregion General
+
   // #region Android-only appearance
   /**
    * @summary Specifies the background color for the entire tab bar.
@@ -204,14 +213,6 @@ export interface BottomTabsProps extends ViewProps {
    * @supported iOS 18 or higher
    */
   tabBarControllerMode?: TabBarControllerMode;
-  /**
-   * @summary Hides the tab bar.
-   *
-   * @default false
-   *
-   * @platform ios
-   */
-  tabBarHidden?: boolean;
   // #endregion iOS-only appearance
 
   // #region Experimental support