react-native-navigation 8.8.2 → 8.8.3-snapshot.2513

package/src/interfaces/Options.ts

@@ -423,6 +423,14 @@ export interface OptionsTopBarBackButton {
    * @default true
    */
   popStackOnPress?: boolean;
+  /**
+   * (iOS 26+ only) Hide the shared Liquid-Glass / Platter background that
+   * UIKit draws behind the back button. Defaults to true to avoid
+   * double-decorating a back button whose icon already carries its own
+   * iconBackground. Set to false to keep the system-drawn background.
+   * @default true
+   */
+  hideSharedBackground?: boolean;
 }
 
 export interface HardwareBackButtonOptions {
@@ -636,6 +644,15 @@ export interface OptionsTopBarButton {
    * Set testID for reference in E2E tests
    */
   testID?: string;
+  /**
+   * (iOS 26+ only) Hide the shared Liquid-Glass / Platter background that
+   * UIKit draws behind every bar button item. Defaults to true to avoid
+   * double-decorating React-rendered custom views and icons that already
+   * carry their own background. Set to false to keep the system-drawn
+   * background.
+   * @default true
+   */
+  hideSharedBackground?: boolean;
   /**
    * (Android only) Set showAsAction value
    * @see {@link https://developer.android.com/guide/topics/resources/menu-resource|Android developer guide: Menu resource}
@@ -1131,6 +1148,43 @@ export interface OptionsBottomTab {
    * #### (iOS 13+ specific)
    */
   sfSelectedSymbol?: string;
+  /**
+   * Set the tab bar item to a system-provided role.
+   * Uses `UITabBarItem(tabBarSystemItem:)` on iOS.
+   *
+   * By default the system provides the icon and title. You can
+   * override the icon by providing `icon`, `selectedIcon`,
+   * `sfSymbol`, or `sfSelectedSymbol` — they are applied after
+   * creation and replace the system-provided image.
+   * `iconColor` and `selectedIconColor` are applied as a tint
+   * to the custom icon when one is provided.
+   *
+   * **`'search'`** — on iOS 26+ this renders as a floating
+   * Liquid Glass button. Only one tab per `bottomTabs` layout
+   * may use this role; duplicates fall back to a normal tab.
+   *
+   * **`'more'`** — activates UIKit's built-in "More" navigation
+   * controller. Tabs beyond the visible limit are moved into
+   * it automatically.
+   *
+   * Properties that remain ignored for role tabs: `text`,
+   * `fontSize`, `fontFamily`, `fontWeight`, `iconInsets`.
+   *
+   * #### (iOS specific)
+   */
+  role?:
+    | 'search'
+    | 'bookmarks'
+    | 'contacts'
+    | 'downloads'
+    | 'favorites'
+    | 'featured'
+    | 'history'
+    | 'more'
+    | 'mostRecent'
+    | 'mostViewed'
+    | 'recents'
+    | 'topRated';
 }
 
 export interface SideMenuSide {
@@ -1667,6 +1721,12 @@ setRoot: {
    * #### (iOS specific)
    */
   window?: WindowOptions;
+  /**
+   * Show / hide or change the style of the iOS 26 scroll edge effect on every
+   * UIScrollView contained in the screen.
+   * #### (iOS 26+ specific)
+   */
+  scrollEdgeEffect?: OptionsScrollEdgeEffect;
   /**
    * Enable or disable automatically blurring focused input, dismissing keyboard on unmount
    * #### (Android specific)
@@ -1674,3 +1734,52 @@ setRoot: {
    */
   blurOnUnmount?: boolean;
 }
+
+export interface OptionsScrollEdge {
+  /**
+   * Hide the scroll edge effect on this edge.
+   * #### (iOS 26+ specific)
+   */
+  hidden?: boolean;
+  /**
+   * Style of the scroll edge effect on this edge.
+   * #### (iOS 26+ specific)
+   * @default 'automatic'
+   */
+  style?: 'automatic' | 'soft' | 'hard';
+}
+
+export interface OptionsScrollEdgeEffect {
+  /**
+   * Hide the scroll edge effect on all four edges of contained scroll views.
+   * Per-edge values (top / bottom / left / right) take precedence over this.
+   * #### (iOS 26+ specific)
+   */
+  hidden?: boolean;
+  /**
+   * Style of the scroll edge effect on all four edges. Per-edge values take precedence.
+   * #### (iOS 26+ specific)
+   * @default 'automatic'
+   */
+  style?: 'automatic' | 'soft' | 'hard';
+  /**
+   * Per-edge override for the top edge effect. Falls back to the global hidden / style.
+   * #### (iOS 26+ specific)
+   */
+  top?: OptionsScrollEdge;
+  /**
+   * Per-edge override for the bottom edge effect. Falls back to the global hidden / style.
+   * #### (iOS 26+ specific)
+   */
+  bottom?: OptionsScrollEdge;
+  /**
+   * Per-edge override for the left edge effect. Falls back to the global hidden / style.
+   * #### (iOS 26+ specific)
+   */
+  left?: OptionsScrollEdge;
+  /**
+   * Per-edge override for the right edge effect. Falls back to the global hidden / style.
+   * #### (iOS 26+ specific)
+   */
+  right?: OptionsScrollEdge;
+}