react-native-screens 4.19.0-nightly-20251202-9e8bf5275 → 4.19.0-nightly-20251204-1746a584e

package/android/CMakeLists.txt

@@ -40,38 +40,12 @@ find_package(ReactAndroid REQUIRED CONFIG)
 
 if(${RNS_NEW_ARCH_ENABLED})
     find_package(fbjni REQUIRED CONFIG)
-    
-    if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
-        target_link_libraries(rnscreens
-            ReactAndroid::reactnative
-            ReactAndroid::jsi
-            fbjni::fbjni
-            android
-        )
-    else()
-        target_link_libraries(
-            rnscreens
-                ReactAndroid::jsi
-                ReactAndroid::react_nativemodule_core
-                ReactAndroid::react_utils
-                ReactAndroid::reactnativejni
-                ReactAndroid::fabricjni
-                ReactAndroid::react_debug
-                ReactAndroid::react_render_core
-                ReactAndroid::runtimeexecutor
-                ReactAndroid::react_render_graphics
-                ReactAndroid::rrc_view
-                ReactAndroid::yoga
-                ReactAndroid::rrc_text
-                ReactAndroid::glog
-                ReactAndroid::react_render_componentregistry
-                ReactAndroid::react_render_consistency
-                ReactAndroid::react_performance_timeline
-                ReactAndroid::react_render_observers_events
-                fbjni::fbjni
-                android
-        )
-    endif()
+    target_link_libraries(rnscreens
+        ReactAndroid::reactnative
+        ReactAndroid::jsi
+        fbjni::fbjni
+        android
+    )
 else()
     target_link_libraries(rnscreens
         ReactAndroid::jsi

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

@@ -252,10 +252,14 @@ class TabsHost(
         bottomNavigationView.setOnItemSelectedListener { item ->
             RNSLog.d(TAG, "Item selected $item")
             val fragment = getFragmentForMenuItemId(item.itemId)
-            if (fragment != currentFocusedTab || !specialEffectsHandler.handleRepeatedTabSelection()) {
-                val tabKey = fragment?.tabScreen?.tabKey ?: "undefined"
-                eventEmitter.emitOnNativeFocusChange(tabKey)
-            }
+            val repeatedSelectionHandledBySpecialEffect =
+                if (fragment == currentFocusedTab) specialEffectsHandler.handleRepeatedTabSelection() else false
+            val tabKey = fragment?.tabScreen?.tabKey ?: "undefined"
+            eventEmitter.emitOnNativeFocusChange(
+                tabKey,
+                item.itemId,
+                repeatedSelectionHandledBySpecialEffect,
+            )
             true
         }
     }
@@ -352,8 +356,11 @@ class TabsHost(
 
         appearanceCoordinator.updateTabAppearance(this)
 
-        bottomNavigationView.selectedItemId =
+        val selectedTabScreenFragmentId =
             checkNotNull(getSelectedTabScreenFragmentId()) { "[RNScreens] A single selected tab must be present" }
+        if (bottomNavigationView.selectedItemId != selectedTabScreenFragmentId) {
+            bottomNavigationView.selectedItemId = selectedTabScreenFragmentId
+        }
 
         post {
             refreshLayout()

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

@@ -8,7 +8,19 @@ internal class TabsHostEventEmitter(
     reactContext: ReactContext,
     viewTag: Int,
 ) : BaseEventEmitter(reactContext, viewTag) {
-    fun emitOnNativeFocusChange(tabKey: String) {
-        reactEventDispatcher.dispatchEvent(TabsHostNativeFocusChangeEvent(surfaceId, viewTag, tabKey))
+    fun emitOnNativeFocusChange(
+        tabKey: String,
+        tabNumber: Int,
+        repeatedSelectionHandledBySpecialEffect: Boolean,
+    ) {
+        reactEventDispatcher.dispatchEvent(
+            TabsHostNativeFocusChangeEvent(
+                surfaceId,
+                viewTag,
+                tabKey,
+                tabNumber,
+                repeatedSelectionHandledBySpecialEffect,
+            ),
+        )
     }
 }

package/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/event/TabsHostNativeFocusChangeEvent.kt

@@ -9,18 +9,27 @@ class TabsHostNativeFocusChangeEvent(
     surfaceId: Int,
     viewId: Int,
     val tabKey: String,
+    val tabNumber: Int,
+    val repeatedSelectionHandledBySpecialEffect: Boolean,
 ) : Event<TabScreenDidAppearEvent>(surfaceId, viewId),
     NamingAwareEventType {
     override fun getEventName() = EVENT_NAME
 
     override fun getEventRegistrationName() = EVENT_REGISTRATION_NAME
 
-    // All events for a given view can be coalesced.
-    override fun getCoalescingKey(): Short = 0
+    // If the user taps currently selected tab 2 times and e.g. scroll to top effect can run,
+    // we should send 2 events [(tabKey, true), (tabKey, false)]. We don't want them to be coalesced
+    // as we would lose information about activation of special effect. That's why we take into
+    // account `repeatedSelectionHandledBySpecialEffect` for coalescingKey.
+    override fun getCoalescingKey(): Short = (tabNumber * 10 + if (repeatedSelectionHandledBySpecialEffect) 1 else 0).toShort()
 
     override fun getEventData(): WritableMap? =
         Arguments.createMap().apply {
             putString(EVENT_KEY_TAB_KEY, tabKey)
+            putBoolean(
+                EVENT_KEY_REPEATED_SELECTION_HANDLED_BY_SPECIAL_EFFECT,
+                repeatedSelectionHandledBySpecialEffect,
+            )
         }
 
     companion object : NamingAwareEventType {
@@ -28,6 +37,8 @@ class TabsHostNativeFocusChangeEvent(
         const val EVENT_REGISTRATION_NAME = "onNativeFocusChange"
 
         private const val EVENT_KEY_TAB_KEY = "tabKey"
+        private const val EVENT_KEY_REPEATED_SELECTION_HANDLED_BY_SPECIAL_EFFECT =
+            "repeatedSelectionHandledBySpecialEffect"
 
         override fun getEventName() = EVENT_NAME
 

package/android/src/main/jni/CMakeLists.txt

@@ -39,34 +39,12 @@ target_include_directories(
   ${LIB_ANDROID_GENERATED_COMPONENTS_DIR}
 )
 
-if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
-  target_link_libraries(
-    ${LIB_TARGET_NAME}
-    ReactAndroid::reactnative
-    ReactAndroid::jsi
-    fbjni::fbjni
-  )
-else()
-  target_link_libraries(
-    ${LIB_TARGET_NAME}
-    fbjni
-    folly_runtime
-    glog
-    jsi
-    react_codegen_rncore
-    react_debug
-    react_nativemodule_core
-    react_render_core
-    react_render_debug
-    react_render_graphics
-    react_render_mapbuffer
-    react_render_componentregistry
-    react_utils
-    rrc_view
-    turbomodulejsijni
-    yoga
-  )
-endif()
+target_link_libraries(
+  ${LIB_TARGET_NAME}
+  ReactAndroid::reactnative
+  ReactAndroid::jsi
+  fbjni::fbjni
+)
 
 if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 80)
   target_compile_reactnative_options(${LIB_TARGET_NAME} PRIVATE)

package/ios/bottom-tabs/host/RNSBottomTabsHostComponentView.h

@@ -72,7 +72,8 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (nonnull RNSBottomTabsHostEventEmitter *)reactEventEmitter;
 
-- (BOOL)emitOnNativeFocusChangeRequestSelectedTabScreen:(nonnull RNSBottomTabsScreenComponentView *)tabScreen;
+- (BOOL)emitOnNativeFocusChangeRequestSelectedTabScreen:(nonnull RNSBottomTabsScreenComponentView *)tabScreen
+                repeatedSelectionHandledBySpecialEffect:(BOOL)repeatedSelectionHandledBySpecialEffect;
 
 #if !RCT_NEW_ARCH_ENABLED
 #pragma mark - LEGACY Event blocks

package/ios/bottom-tabs/host/RNSBottomTabsHostComponentView.mm

@@ -261,9 +261,13 @@ namespace react = facebook::react;
   return _reactEventEmitter;
 }
 
-- (BOOL)emitOnNativeFocusChangeRequestSelectedTabScreen:(RNSBottomTabsScreenComponentView *)tabScreen
+- (BOOL)emitOnNativeFocusChangeRequestSelectedTabScreen:(nonnull RNSBottomTabsScreenComponentView *)tabScreen
+                repeatedSelectionHandledBySpecialEffect:(BOOL)repeatedSelectionHandledBySpecialEffect
 {
-  return [_reactEventEmitter emitOnNativeFocusChange:OnNativeFocusChangePayload{.tabKey = tabScreen.tabKey}];
+  return [_reactEventEmitter
+      emitOnNativeFocusChange:OnNativeFocusChangePayload{
+                                  .tabKey = tabScreen.tabKey,
+                                  .repeatedSelectionHandledBySpecialEffect = repeatedSelectionHandledBySpecialEffect}];
 }
 
 #pragma mark - RCTComponentViewProtocol

package/ios/bottom-tabs/host/RNSBottomTabsHostEventEmitter.h

@@ -18,10 +18,12 @@ NS_ASSUME_NONNULL_BEGIN
 #if defined(__cplusplus)
 struct OnNativeFocusChangePayload {
   NSString *_Nonnull tabKey;
+  BOOL repeatedSelectionHandledBySpecialEffect;
 };
 #else
 typedef struct {
   NSString *_Nonnull tabKey;
+  BOOL repeatedSelectionHandledBySpecialEffect;
 } OnNativeFocusChangePayload;
 #endif
 

package/ios/bottom-tabs/host/RNSBottomTabsHostEventEmitter.mm

@@ -37,7 +37,9 @@ namespace react = facebook::react;
 {
 #if RCT_NEW_ARCH_ENABLED
   if (_reactEventEmitter != nullptr) {
-    _reactEventEmitter->onNativeFocusChange({.tabKey = RCTStringFromNSString(payload.tabKey)});
+    _reactEventEmitter->onNativeFocusChange(
+        {.tabKey = RCTStringFromNSString(payload.tabKey),
+         .repeatedSelectionHandledBySpecialEffect = payload.repeatedSelectionHandledBySpecialEffect});
     return YES;
   } else {
     RCTLogWarn(@"[RNScreens] Skipped OnNativeFocusChange event emission due to nullish emitter");
@@ -45,7 +47,10 @@ namespace react = facebook::react;
   }
 #else
   if (self.onNativeFocusChange) {
-    self.onNativeFocusChange(@{@"tabKey" : payload.tabKey});
+    self.onNativeFocusChange(@{
+      @"tabKey" : payload.tabKey,
+      @"repeatedSelectionHandledBySpecialEffect" : @(payload.repeatedSelectionHandledBySpecialEffect)
+    });
     return YES;
   } else {
     RCTLogWarn(@"[RNScreens] Skipped OnNativeFocusChange event emission due to nullish emitter");

package/ios/bottom-tabs/host/RNSTabBarControllerDelegate.mm

@@ -32,26 +32,20 @@
   }
 #endif // !TARGET_OS_TV
 
-  bool repeatedSelectionHandledNatively = false;
+  // TODO: handle enforcing orientation with natively-driven tabs
 
   // Detect repeated selection and inform tabScreenController
-  if ([tabBarCtrl selectedViewController] == tabScreenCtrl) {
-    repeatedSelectionHandledNatively = [tabScreenCtrl tabScreenSelectedRepeatedly];
-  }
-
-  // TODO: send an event with information about event being handled natively
-  if (!repeatedSelectionHandledNatively) {
-    [tabBarCtrl.tabsHostComponentView
-        emitOnNativeFocusChangeRequestSelectedTabScreen:tabScreenCtrl.tabScreenComponentView];
+  BOOL repeatedSelection = [tabBarCtrl selectedViewController] == tabScreenCtrl;
+  BOOL repeatedSelectionHandledBySpecialEffect =
+      repeatedSelection ? [tabScreenCtrl tabScreenSelectedRepeatedly] : false;
 
-    // TODO: handle overrideScrollViewBehaviorInFirstDescendantChainIfNeeded for natively-driven tabs
-    return ![self shouldPreventNativeTabChangeWithinTabBarController:tabBarCtrl];
-  }
-
-  // TODO: handle enforcing orientation with natively-driven tabs
+  [tabBarCtrl.tabsHostComponentView
+      emitOnNativeFocusChangeRequestSelectedTabScreen:tabScreenCtrl.tabScreenComponentView
+              repeatedSelectionHandledBySpecialEffect:repeatedSelectionHandledBySpecialEffect];
 
-  // As we're selecting the same controller, returning both true and false works here.
-  return true;
+  // On repeated selection we return false to prevent native *pop to root* effect that works only starting from iOS 26
+  // and interferes with our implementation (which is necessary for controlled tabs).
+  return repeatedSelection ? false : ![self shouldPreventNativeTabChangeWithinTabBarController:tabBarCtrl];
 }
 
 - (void)tabBarController:(UITabBarController *)tabBarController

package/ios/bottom-tabs/screen/RNSBottomTabsScreenComponentView.mm

@@ -649,6 +649,30 @@ RNS_IGNORE_SUPER_CALL_END
   _tabBarItemNeedsRecreation = YES;
 }
 
+- (void)setSpecialEffects:(NSDictionary *)specialEffects
+{
+  if (specialEffects == nil || specialEffects[@"repeatedTabSelection"] == nil ||
+      ![specialEffects[@"repeatedTabSelection"] isKindOfClass:[NSDictionary class]]) {
+    _shouldUseRepeatedTabSelectionPopToRootSpecialEffect = YES;
+    _shouldUseRepeatedTabSelectionScrollToTopSpecialEffect = YES;
+    return;
+  }
+
+  NSDictionary *repeatedTabSelection = specialEffects[@"repeatedTabSelection"];
+
+  if (repeatedTabSelection[@"popToRoot"] != nil) {
+    _shouldUseRepeatedTabSelectionPopToRootSpecialEffect = [RCTConvert BOOL:repeatedTabSelection[@"popToRoot"]];
+  } else {
+    _shouldUseRepeatedTabSelectionPopToRootSpecialEffect = YES;
+  }
+
+  if (repeatedTabSelection[@"scrollToTop"] != nil) {
+    _shouldUseRepeatedTabSelectionScrollToTopSpecialEffect = [RCTConvert BOOL:repeatedTabSelection[@"scrollToTop"]];
+  } else {
+    _shouldUseRepeatedTabSelectionScrollToTopSpecialEffect = YES;
+  }
+}
+
 - (void)setOrientation:(RNSOrientation)orientation
 {
   _orientation = orientation;

package/ios/bottom-tabs/screen/RNSBottomTabsScreenComponentViewManager.mm

@@ -33,9 +33,6 @@ RCT_EXPORT_VIEW_PROPERTY(iconSfSymbolName, NSString);
 RCT_EXPORT_VIEW_PROPERTY(selectedIconImageSource, RCTImageSource);
 RCT_EXPORT_VIEW_PROPERTY(selectedIconSfSymbolName, NSString);
 
-RCT_EXPORT_VIEW_PROPERTY(shouldUseRepeatedTabSelectionPopToRootSpecialEffect, BOOL);
-RCT_EXPORT_VIEW_PROPERTY(shouldUseRepeatedTabSelectionScrollToTopSpecialEffect, BOOL);
-
 RCT_EXPORT_VIEW_PROPERTY(overrideScrollViewContentInsetAdjustmentBehavior, BOOL);
 
 RCT_EXPORT_VIEW_PROPERTY(bottomScrollEdgeEffect, RNSScrollEdgeEffect);
@@ -47,6 +44,8 @@ RCT_EXPORT_VIEW_PROPERTY(userInterfaceStyle, UIUserInterfaceStyle);
 
 RCT_EXPORT_VIEW_PROPERTY(systemItem, RNSBottomTabsScreenSystemItem);
 
+RCT_EXPORT_VIEW_PROPERTY(specialEffects, NSDictionary);
+
 RCT_EXPORT_VIEW_PROPERTY(onWillAppear, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onWillDisappear, RCTDirectEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(onDidAppear, RCTDirectEventBlock);

package/lib/commonjs/fabric/bottom-tabs/BottomTabsNativeComponent.js.map

@@ -1 +1 @@
-{"version":3,"names":["Object","defineProperty","exports","value","default","_codegenNativeComponent","_interopRequireDefault","require","e","__esModule","_default","codegenNativeComponent","interfaceOnly"],"sourceRoot":"../../../../src","sources":["fabric/bottom-tabs/BottomTabsNativeComponent.ts"],"mappings":";AAAA,YAAY;;AAEZ;AAAAA,MAAA,CAAAC,cAAA,CAAAC,OAAA;EAAAC,KAAA;AAAA;AAAAD,OAAA,CAAAE,OAAA;AACA,IAAAC,uBAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA6F,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAJ,OAAA,EAAAI,CAAA;AAQ7F;AACA;AACA;AACA;AACA;AACA;AAAA,IAAAE,QAAA,GAAAR,OAAA,CAAAE,OAAA,GA0De,IAAAO,+BAAsB,EAAc,eAAe,EAAE;EAClEC,aAAa,EAAE;AACjB,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["Object","defineProperty","exports","value","default","_codegenNativeComponent","_interopRequireDefault","require","e","__esModule","_default","codegenNativeComponent","interfaceOnly"],"sourceRoot":"../../../../src","sources":["fabric/bottom-tabs/BottomTabsNativeComponent.ts"],"mappings":";AAAA,YAAY;;AAEZ;AAAAA,MAAA,CAAAC,cAAA,CAAAC,OAAA;EAAAC,KAAA;AAAA;AAAAD,OAAA,CAAAE,OAAA;AACA,IAAAC,uBAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA6F,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAJ,OAAA,EAAAI,CAAA;AAQ7F;AACA;AACA;AACA;AACA;AACA;AAAA,IAAAE,QAAA,GAAAR,OAAA,CAAAE,OAAA,GA2De,IAAAO,+BAAsB,EAAc,eAAe,EAAE;EAClEC,aAAa,EAAE;AACjB,CAAC,CAAC","ignoreList":[]}

package/lib/module/fabric/bottom-tabs/BottomTabsNativeComponent.js.map

@@ -1 +1 @@
-{"version":3,"names":["codegenNativeComponent","interfaceOnly"],"sourceRoot":"../../../../src","sources":["fabric/bottom-tabs/BottomTabsNativeComponent.ts"],"mappings":"AAAA,YAAY;;AAEZ;AACA,OAAOA,sBAAsB,MAAM,yDAAyD;;AAQ5F;AACA;AACA;AACA;AACA;AACA;;AA0DA,eAAeA,sBAAsB,CAAc,eAAe,EAAE;EAClEC,aAAa,EAAE;AACjB,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["codegenNativeComponent","interfaceOnly"],"sourceRoot":"../../../../src","sources":["fabric/bottom-tabs/BottomTabsNativeComponent.ts"],"mappings":"AAAA,YAAY;;AAEZ;AACA,OAAOA,sBAAsB,MAAM,yDAAyD;;AAQ5F;AACA;AACA;AACA;AACA;AACA;;AA2DA,eAAeA,sBAAsB,CAAc,eAAe,EAAE;EAClEC,aAAa,EAAE;AACjB,CAAC,CAAC","ignoreList":[]}

package/lib/typescript/components/bottom-tabs/BottomTabs.types.d.ts

@@ -4,6 +4,7 @@ import type { BottomTabsAccessoryEnvironment } from './BottomTabsAccessory.types
 export type BottomAccessoryFn = (environment: BottomTabsAccessoryEnvironment) => ReactNode;
 export type NativeFocusChangeEvent = {
     tabKey: string;
+    repeatedSelectionHandledBySpecialEffect: boolean;
 };
 export type TabBarItemLabelVisibilityMode = 'auto' | 'selected' | 'labeled' | 'unlabeled';
 export type TabBarMinimizeBehavior = 'automatic' | 'never' | 'onScrollDown' | 'onScrollUp';
@@ -19,6 +20,8 @@ export interface BottomTabsProps extends ViewProps {
      * @summary Hides the tab bar.
      *
      * @default false
+     *
+     * @platform android, ios
      */
     tabBarHidden?: boolean;
     /**
@@ -124,6 +127,7 @@ export interface BottomTabsProps extends ViewProps {
      * @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;

package/lib/typescript/components/bottom-tabs/BottomTabs.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BottomTabs.types.d.ts","sourceRoot":"","sources":["../../../../src/components/bottom-tabs/BottomTabs.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,SAAS,EACV,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAElF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,WAAW,EAAE,8BAA8B,KACxC,SAAS,CAAC;AAEf,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF,MAAM,MAAM,6BAA6B,GACrC,MAAM,GACN,UAAU,GACV,SAAS,GACT,WAAW,CAAC;AAGhB,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,OAAO,GACP,cAAc,GACd,YAAY,CAAC;AAGjB,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEzE,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAEhD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CACpB,KAAK,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,KAChD,IAAI,CAAC;IAIV;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAIvB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,UAAU,CAAC;IACnC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACpD;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAChD;;;;;;OAMG;IACH,6BAA6B,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IACtD;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACpD;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAClD;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9C;;;;;;OAMG;IACH,8BAA8B,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACpD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,UAAU,CAAC;IACjC;;;;;;OAMG;IACH,yBAAyB,CAAC,EAAE,UAAU,CAAC;IACvC;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,UAAU,CAAC;IAC5C;;;;;;OAMG;IACH,gCAAgC,CAAC,EAAE,OAAO,CAAC;IAC3C;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,UAAU,CAAC;IACnC;;;;;;;;;;;;;;;;OAgBG;IACH,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;IAI9D;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAI5C;;;;;;;;;;;;;;;;;;OAkBG;IACH,sCAAsC,CAAC,EAAE,OAAO,CAAC;CAElD"}
+{"version":3,"file":"BottomTabs.types.d.ts","sourceRoot":"","sources":["../../../../src/components/bottom-tabs/BottomTabs.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,SAAS,EACV,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAElF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,WAAW,EAAE,8BAA8B,KACxC,SAAS,CAAC;AAEf,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC,EAAE,OAAO,CAAC;CAClD,CAAC;AAGF,MAAM,MAAM,6BAA6B,GACrC,MAAM,GACN,UAAU,GACV,SAAS,GACT,WAAW,CAAC;AAGhB,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,OAAO,GACP,cAAc,GACd,YAAY,CAAC;AAGjB,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEzE,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAEhD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CACpB,KAAK,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,KAChD,IAAI,CAAC;IAIV;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAIvB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,UAAU,CAAC;IACnC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACpD;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAChD;;;;;;OAMG;IACH,6BAA6B,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IACtD;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACpD;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAClD;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9C;;;;;;OAMG;IACH,8BAA8B,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACpD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,UAAU,CAAC;IACjC;;;;;;OAMG;IACH,yBAAyB,CAAC,EAAE,UAAU,CAAC;IACvC;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,UAAU,CAAC;IAC5C;;;;;;OAMG;IACH,gCAAgC,CAAC,EAAE,OAAO,CAAC;IAC3C;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,UAAU,CAAC;IACnC;;;;;;;;;;;;;;;;;OAiBG;IACH,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;IAI9D;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAI5C;;;;;;;;;;;;;;;;;;OAkBG;IACH,sCAAsC,CAAC,EAAE,OAAO,CAAC;CAElD"}

package/lib/typescript/components/bottom-tabs/BottomTabsScreen.types.d.ts

@@ -185,15 +185,6 @@ export interface BottomTabsScreenItemStateAppearance {
     tabBarItemBadgeBackgroundColor?: ColorValue;
 }
 export interface BottomTabsScreenProps {
-    children?: ViewProps['children'];
-    /**
-     * @summary Defines what should be rendered when tab screen is frozen.
-     *
-     * @see {@link https://github.com/software-mansion/react-freeze|`react-freeze`'s GitHub repository} for more information about `react-freeze`.
-     *
-     * @platform android, ios
-     */
-    placeholder?: React.ReactNode | undefined;
     /**
      * @summary Determines selected tab.
      *
@@ -213,6 +204,15 @@ export interface BottomTabsScreenProps {
      * @platform android, ios
      */
     tabKey: string;
+    children?: ViewProps['children'];
+    /**
+     * @summary Defines what should be rendered when tab screen is frozen.
+     *
+     * @see {@link https://github.com/software-mansion/react-freeze|`react-freeze`'s GitHub repository} for more information about `react-freeze`.
+     *
+     * @platform android, ios
+     */
+    placeholder?: React.ReactNode | undefined;
     /**
      * @summary Title of the tab screen, displayed in the tab bar item.
      *
@@ -265,8 +265,60 @@ export interface BottomTabsScreenProps {
      *
      * On iOS, if no `selectedIcon` is provided, this icon will also
      * be used as the selected state icon.
+     *
+     * @platform android, ios
      */
     icon?: PlatformIcon;
+    /**
+     * @summary Specifies which special effects (also known as microinteractions)
+     * are enabled for the tab screen.
+     *
+     * For repeated tab selection (selecting already focused tab bar item),
+     * there are 2 supported special effects:
+     * - `popToRoot` - when Stack is nested inside tab screen and repeated
+     *   selection is detected, the Stack will pop to root screen,
+     * - `scrollToTop` - when there is a ScrollView in first descendant
+     *   chain from tab screen and repeated selection is detected, ScrollView
+     *   will be scrolled to top.
+     *
+     * `popToRoot` has priority over `scrollToTop`.
+     *
+     * @default All special effects are enabled by default.
+     *
+     * @platform android, ios
+     */
+    specialEffects?: {
+        repeatedTabSelection?: {
+            /**
+             * @default true
+             */
+            popToRoot?: boolean;
+            /**
+             * @default true
+             */
+            scrollToTop?: boolean;
+        };
+    };
+    /**
+     * @summary Allows to control whether contents of a tab screen should be frozen or not. This overrides any default behavior.
+     *
+     * @default undefined
+     *
+     * @platform android, ios
+     */
+    freezeContents?: boolean;
+    /**
+     * @summary Specifies the color of the text in the badge.
+     *
+     * @platform android
+     */
+    tabBarItemBadgeTextColor?: ColorValue;
+    /**
+     * @summary Specifies the background color of the badge.
+     *
+     * @platform android
+     */
+    tabBarItemBadgeBackgroundColor?: ColorValue;
     /**
      * @summary Specifies supported orientations for the tab screen.
      *
@@ -316,18 +368,6 @@ export interface BottomTabsScreenProps {
      * @platform ios
      */
     orientation?: BottomTabsScreenOrientation;
-    /**
-     * @summary Specifies the color of the text in the badge.
-     *
-     * @platform android
-     */
-    tabBarItemBadgeTextColor?: ColorValue;
-    /**
-     * @summary Specifies the background color of the badge.
-     *
-     * @platform android
-     */
-    tabBarItemBadgeBackgroundColor?: ColorValue;
     /**
      * @summary Specifies the standard tab bar appearance.
      *
@@ -369,43 +409,10 @@ export interface BottomTabsScreenProps {
      * be customized.
      *
      * @see {@link https://developer.apple.com/documentation/uikit/uitabbaritem/systemitem|UITabBarItem.SystemItem}
+     *
      * @platform ios
      */
     systemItem?: BottomTabsSystemItem;
-    /**
-     * @summary Specifies which special effects (also known as microinteractions)
-     * are enabled for the tab screen.
-     *
-     * For repeated tab selection (selecting already focused tab bar item),
-     * there are 2 supported special effects:
-     * - `popToRoot` - when Stack is nested inside tab screen and repeated
-     *   selection is detected, the Stack will pop to root screen,
-     * - `scrollToTop` - when there is a ScrollView in first descendant
-     *   chain from tab screen and repeated selection is detected, ScrollView
-     *   will be scrolled to top.
-     *
-     * `popToRoot` has priority over `scrollToTop`.
-     *
-     * @default All special effects are enabled by default.
-     */
-    specialEffects?: {
-        repeatedTabSelection?: {
-            /**
-             * @default true
-             */
-            popToRoot?: boolean;
-            /**
-             * @default true
-             */
-            scrollToTop?: boolean;
-        };
-    };
-    /**
-     * @summary Allows to control whether contents of a tab screen should be frozen or not. This overrides any default behavior.
-     *
-     * @default `undefined`
-     */
-    freezeContents?: boolean;
     /**
      * @summary Specifies if `contentInsetAdjustmentBehavior` of first ScrollView
      * in first descendant chain from tab screen should be overridden back from `never`
@@ -470,6 +477,7 @@ export interface BottomTabsScreenProps {
      * @see {@link https://developer.apple.com/documentation/uikit/uiuserinterfacestyle|UIUserInterfaceStyle}
      *
      * @default unspecified
+     *
      * @platform ios
      */
     experimental_userInterfaceStyle?: UserInterfaceStyle;

package/lib/typescript/components/bottom-tabs/BottomTabsScreen.types.d.ts.map

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

package/lib/typescript/fabric/bottom-tabs/BottomTabsNativeComponent.d.ts

@@ -2,6 +2,7 @@ import type { ColorValue, ViewProps } from 'react-native';
 import type { DirectEventHandler, Float, WithDefault } from 'react-native/Libraries/Types/CodegenTypes';
 type NativeFocusChangeEvent = {
     tabKey: string;
+    repeatedSelectionHandledBySpecialEffect: boolean;
 };
 type TabBarItemLabelVisibilityMode = 'auto' | 'selected' | 'labeled' | 'unlabeled';
 type TabBarMinimizeBehavior = 'automatic' | 'never' | 'onScrollDown' | 'onScrollUp';

package/lib/typescript/fabric/bottom-tabs/BottomTabsNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BottomTabsNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/fabric/bottom-tabs/BottomTabsNativeComponent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EACV,kBAAkB,EAClB,KAAK,EACL,WAAW,EACZ,MAAM,2CAA2C,CAAC;AASnD,KAAK,sBAAsB,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,6BAA6B,GAC9B,MAAM,GACN,UAAU,GACV,SAAS,GACT,WAAW,CAAC;AAEhB,KAAK,sBAAsB,GACvB,WAAW,GACX,OAAO,GACP,cAAc,GACd,YAAY,CAAC;AAEjB,KAAK,oBAAoB,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAElE,MAAM,WAAW,WAAY,SAAQ,SAAS;IAE5C,mBAAmB,CAAC,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IAMjE,qBAAqB,CAAC,EAAE,UAAU,CAAC;IACnC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,KAAK,CAAC;IAChC,6BAA6B,CAAC,EAAE,KAAK,CAAC;IACtC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,wBAAwB,CAAC,EAAE,UAAU,CAAC;IACtC,8BAA8B,CAAC,EAAE,UAAU,CAAC;IAC5C,mBAAmB,CAAC,EAAE,UAAU,CAAC;IACjC,yBAAyB,CAAC,EAAE,UAAU,CAAC;IACvC,8BAA8B,CAAC,EAAE,UAAU,CAAC;IAC5C,gCAAgC,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9D,qBAAqB,CAAC,EAAE,UAAU,CAAC;IACnC,6BAA6B,CAAC,EAAE,WAAW,CACzC,6BAA6B,EAC7B,MAAM,CACP,CAAC;IAGF,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,sBAAsB,CAAC,EAAE,WAAW,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;IAC1E,oBAAoB,CAAC,EAAE,WAAW,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAK3C,0BAA0B,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CAC1D;;AAED,wBAEG"}
+{"version":3,"file":"BottomTabsNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/fabric/bottom-tabs/BottomTabsNativeComponent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EACV,kBAAkB,EAClB,KAAK,EACL,WAAW,EACZ,MAAM,2CAA2C,CAAC;AASnD,KAAK,sBAAsB,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC,EAAE,OAAO,CAAC;CAClD,CAAC;AAEF,KAAK,6BAA6B,GAC9B,MAAM,GACN,UAAU,GACV,SAAS,GACT,WAAW,CAAC;AAEhB,KAAK,sBAAsB,GACvB,WAAW,GACX,OAAO,GACP,cAAc,GACd,YAAY,CAAC;AAEjB,KAAK,oBAAoB,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAElE,MAAM,WAAW,WAAY,SAAQ,SAAS;IAE5C,mBAAmB,CAAC,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IAMjE,qBAAqB,CAAC,EAAE,UAAU,CAAC;IACnC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,KAAK,CAAC;IAChC,6BAA6B,CAAC,EAAE,KAAK,CAAC;IACtC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,wBAAwB,CAAC,EAAE,UAAU,CAAC;IACtC,8BAA8B,CAAC,EAAE,UAAU,CAAC;IAC5C,mBAAmB,CAAC,EAAE,UAAU,CAAC;IACjC,yBAAyB,CAAC,EAAE,UAAU,CAAC;IACvC,8BAA8B,CAAC,EAAE,UAAU,CAAC;IAC5C,gCAAgC,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9D,qBAAqB,CAAC,EAAE,UAAU,CAAC;IACnC,6BAA6B,CAAC,EAAE,WAAW,CACzC,6BAA6B,EAC7B,MAAM,CACP,CAAC;IAGF,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,sBAAsB,CAAC,EAAE,WAAW,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;IAC1E,oBAAoB,CAAC,EAAE,WAAW,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAK3C,0BAA0B,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CAC1D;;AAED,wBAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-screens",
-  "version": "4.19.0-nightly-20251202-9e8bf5275",
+  "version": "4.19.0-nightly-20251204-1746a584e",
   "description": "Native navigation primitives for your React Native app.",
   "scripts": {
     "submodules": "git submodule update --init --recursive && (cd react-navigation && yarn && yarn build && cd ../)",

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

@@ -13,6 +13,7 @@ export type BottomAccessoryFn = (
 
 export type NativeFocusChangeEvent = {
   tabKey: string;
+  repeatedSelectionHandledBySpecialEffect: boolean;
 };
 
 // Android-specific
@@ -49,11 +50,13 @@ export interface BottomTabsProps extends ViewProps {
    * @summary Hides the tab bar.
    *
    * @default false
+   *
+   * @platform android, ios
    */
   tabBarHidden?: boolean;
   // #endregion General
 
-  // #region Android-only appearance
+  // #region Android-only
   /**
    * @summary Specifies the background color for the entire tab bar.
    *
@@ -157,12 +160,13 @@ export interface BottomTabsProps extends ViewProps {
    * @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;
-  // #endregion Android-only appearance
+  // #endregion Android-only
 
-  // #region iOS-only appearance
+  // #region iOS-only
   /**
    * @summary Specifies the color used for selected tab's text and icon color.
    *
@@ -249,7 +253,7 @@ export interface BottomTabsProps extends ViewProps {
    * @supported iOS 18 or higher
    */
   tabBarControllerMode?: TabBarControllerMode;
-  // #endregion iOS-only appearance
+  // #endregion iOS-only
 
   // #region Experimental support
   /**

package/src/components/bottom-tabs/BottomTabsScreen.types.ts

@@ -256,16 +256,6 @@ export interface BottomTabsScreenItemStateAppearance {
 }
 
 export interface BottomTabsScreenProps {
-  children?: ViewProps['children'];
-  /**
-   * @summary Defines what should be rendered when tab screen is frozen.
-   *
-   * @see {@link https://github.com/software-mansion/react-freeze|`react-freeze`'s GitHub repository} for more information about `react-freeze`.
-   *
-   * @platform android, ios
-   */
-  placeholder?: React.ReactNode | undefined;
-
   // #region Control
   /**
    * @summary Determines selected tab.
@@ -289,6 +279,15 @@ export interface BottomTabsScreenProps {
   // #endregion
 
   // #region General
+  children?: ViewProps['children'];
+  /**
+   * @summary Defines what should be rendered when tab screen is frozen.
+   *
+   * @see {@link https://github.com/software-mansion/react-freeze|`react-freeze`'s GitHub repository} for more information about `react-freeze`.
+   *
+   * @platform android, ios
+   */
+  placeholder?: React.ReactNode | undefined;
   /**
    * @summary Title of the tab screen, displayed in the tab bar item.
    *
@@ -341,8 +340,66 @@ export interface BottomTabsScreenProps {
    *
    * On iOS, if no `selectedIcon` is provided, this icon will also
    * be used as the selected state icon.
+   *
+   * @platform android, ios
    */
   icon?: PlatformIcon;
+  /**
+   * @summary Specifies which special effects (also known as microinteractions)
+   * are enabled for the tab screen.
+   *
+   * For repeated tab selection (selecting already focused tab bar item),
+   * there are 2 supported special effects:
+   * - `popToRoot` - when Stack is nested inside tab screen and repeated
+   *   selection is detected, the Stack will pop to root screen,
+   * - `scrollToTop` - when there is a ScrollView in first descendant
+   *   chain from tab screen and repeated selection is detected, ScrollView
+   *   will be scrolled to top.
+   *
+   * `popToRoot` has priority over `scrollToTop`.
+   *
+   * @default All special effects are enabled by default.
+   *
+   * @platform android, ios
+   */
+  specialEffects?: {
+    repeatedTabSelection?: {
+      /**
+       * @default true
+       */
+      popToRoot?: boolean;
+      /**
+       * @default true
+       */
+      scrollToTop?: boolean;
+    };
+  };
+  /**
+   * @summary Allows to control whether contents of a tab screen should be frozen or not. This overrides any default behavior.
+   *
+   * @default undefined
+   *
+   * @platform android, ios
+   */
+  freezeContents?: boolean;
+  // #endregion General
+
+  // #region Android-only
+  /**
+   * @summary Specifies the color of the text in the badge.
+   *
+   * @platform android
+   */
+  tabBarItemBadgeTextColor?: ColorValue;
+  /**
+   * @summary Specifies the background color of the badge.
+   *
+   * @platform android
+   */
+  tabBarItemBadgeBackgroundColor?: ColorValue;
+  // #endregion Android-only
+
+  // #region iOS-only
   /**
    * @summary Specifies supported orientations for the tab screen.
    *
@@ -392,22 +449,6 @@ export interface BottomTabsScreenProps {
    * @platform ios
    */
   orientation?: BottomTabsScreenOrientation;
-  // #endregion General
-  /**
-   * @summary Specifies the color of the text in the badge.
-   *
-   * @platform android
-   */
-  tabBarItemBadgeTextColor?: ColorValue;
-  /**
-   * @summary Specifies the background color of the badge.
-   *
-   * @platform android
-   */
-  tabBarItemBadgeBackgroundColor?: ColorValue;
-  // #endregion Android-only appearance
-
-  // #region iOS-only appearance
   /**
    * @summary Specifies the standard tab bar appearance.
    *
@@ -449,43 +490,10 @@ export interface BottomTabsScreenProps {
    * be customized.
    *
    * @see {@link https://developer.apple.com/documentation/uikit/uitabbaritem/systemitem|UITabBarItem.SystemItem}
+   *
    * @platform ios
    */
   systemItem?: BottomTabsSystemItem;
-  /**
-   * @summary Specifies which special effects (also known as microinteractions)
-   * are enabled for the tab screen.
-   *
-   * For repeated tab selection (selecting already focused tab bar item),
-   * there are 2 supported special effects:
-   * - `popToRoot` - when Stack is nested inside tab screen and repeated
-   *   selection is detected, the Stack will pop to root screen,
-   * - `scrollToTop` - when there is a ScrollView in first descendant
-   *   chain from tab screen and repeated selection is detected, ScrollView
-   *   will be scrolled to top.
-   *
-   * `popToRoot` has priority over `scrollToTop`.
-   *
-   * @default All special effects are enabled by default.
-   */
-  specialEffects?: {
-    repeatedTabSelection?: {
-      /**
-       * @default true
-       */
-      popToRoot?: boolean;
-      /**
-       * @default true
-       */
-      scrollToTop?: boolean;
-    };
-  };
-  /**
-   * @summary Allows to control whether contents of a tab screen should be frozen or not. This overrides any default behavior.
-   *
-   * @default `undefined`
-   */
-  freezeContents?: boolean;
   /**
    * @summary Specifies if `contentInsetAdjustmentBehavior` of first ScrollView
    * in first descendant chain from tab screen should be overridden back from `never`
@@ -550,10 +558,11 @@ export interface BottomTabsScreenProps {
    * @see {@link https://developer.apple.com/documentation/uikit/uiuserinterfacestyle|UIUserInterfaceStyle}
    *
    * @default unspecified
+   *
    * @platform ios
    */
   experimental_userInterfaceStyle?: UserInterfaceStyle;
-  // #endregion iOS-only appearance
+  // #endregion iOS-only
 
   // #region Events
   /**

package/src/fabric/bottom-tabs/BottomTabsNativeComponent.ts

@@ -18,6 +18,7 @@ import type {
 
 type NativeFocusChangeEvent = {
   tabKey: string;
+  repeatedSelectionHandledBySpecialEffect: boolean;
 };
 
 type TabBarItemLabelVisibilityMode =