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

package/src/fabric/tabs/TabsHostAndroidNativeComponent.ts

@@ -0,0 +1,69 @@
+'use client';
+
+import { codegenNativeComponent } from 'react-native';
+import type { CodegenTypes as CT, ColorValue, ViewProps } from 'react-native';
+
+// #region General helpers
+
+type TabSelectedEvent = {
+  selectedScreenKey: string;
+  provenance: CT.Int32;
+  isRepeated: boolean;
+  hasTriggeredSpecialEffect: boolean;
+  actionOrigin: 'user' | 'programmatic-js' | 'programmatic-native' | 'implicit';
+};
+
+type NavigationStateRequest = {
+  selectedScreenKey: string;
+  baseProvenance: CT.Int32;
+};
+
+type TabSelectionRejectedEvent = Readonly<{
+  selectedScreenKey: string;
+  provenance: CT.Int32;
+  rejectedScreenKey: string;
+  rejectedProvenance: CT.Int32;
+  rejectionReason: 'stale' | 'repeated';
+}>;
+
+type TabSelectionPreventedEvent = Readonly<{
+  selectedScreenKey: string;
+  provenance: CT.Int32;
+  preventedScreenKey: string;
+}>;
+
+type TabsHostColorScheme = 'inherit' | 'light' | 'dark';
+
+// #endregion General helpers
+
+// #region Android-specific helpers
+// No helpers specified so far, but marking the place where these should land.
+// #endregion Android-specific helpers
+
+export interface NativeProps extends ViewProps {
+  // Control
+  navStateRequest: NavigationStateRequest;
+  rejectStaleNavStateUpdates?: CT.WithDefault<boolean, false>;
+
+  // Events
+  onTabSelected?: CT.DirectEventHandler<TabSelectedEvent> | undefined;
+  onTabSelectionRejected?:
+    | CT.DirectEventHandler<TabSelectionRejectedEvent>
+    | undefined;
+  onTabSelectionPrevented?:
+    | CT.DirectEventHandler<TabSelectionPreventedEvent>
+    | undefined;
+
+  // General
+  tabBarHidden?: CT.WithDefault<boolean, false>;
+  nativeContainerBackgroundColor?: ColorValue | undefined;
+  colorScheme?: CT.WithDefault<TabsHostColorScheme, 'inherit'>;
+
+  // Android-specific props
+  tabBarRespectsIMEInsets?: CT.WithDefault<boolean, false>;
+}
+
+export default codegenNativeComponent<NativeProps>('RNSTabsHostAndroid', {
+  interfaceOnly: true,
+  excludedPlatforms: ['iOS'],
+});

package/src/fabric/tabs/TabsHostIOSNativeComponent.ts

@@ -0,0 +1,91 @@
+'use client';
+
+import { codegenNativeComponent } from 'react-native';
+import type { CodegenTypes as CT, ColorValue, ViewProps } from 'react-native';
+
+// #region General helpers
+
+type TabSelectedEvent = Readonly<{
+  selectedScreenKey: string;
+  provenance: CT.Int32;
+  isRepeated: boolean;
+  hasTriggeredSpecialEffect: boolean;
+  actionOrigin: 'user' | 'programmatic-js' | 'programmatic-native' | 'implicit';
+}>;
+
+type NavigationStateRequest = Readonly<{
+  selectedScreenKey: string;
+  baseProvenance: CT.Int32;
+}>;
+
+type TabSelectionRejectedEvent = Readonly<{
+  selectedScreenKey: string;
+  provenance: CT.Int32;
+  rejectedScreenKey: string;
+  rejectedProvenance: CT.Int32;
+  rejectionReason: 'stale' | 'repeated';
+}>;
+
+type TabSelectionPreventedEvent = Readonly<{
+  selectedScreenKey: string;
+  provenance: CT.Int32;
+  preventedScreenKey: string;
+}>;
+
+type MoreTabSelectedEvent = Readonly<{
+  selectedScreenKey: string;
+  provenance: CT.Int32;
+}>;
+
+type TabsHostColorScheme = 'inherit' | 'light' | 'dark';
+
+type LayoutDirection = 'inherit' | 'ltr' | 'rtl';
+
+// #endregion General helpers
+
+// #region iOS-specific helpers
+
+type TabBarMinimizeBehavior =
+  | 'automatic'
+  | 'never'
+  | 'onScrollDown'
+  | 'onScrollUp';
+
+type TabBarControllerMode = 'automatic' | 'tabBar' | 'tabSidebar';
+
+// #endregion iOS-specific helpers
+
+export interface NativeProps extends ViewProps {
+  // Control
+  navStateRequest: NavigationStateRequest;
+  rejectStaleNavStateUpdates?: CT.WithDefault<boolean, false>;
+
+  // Events
+  onTabSelected?: CT.DirectEventHandler<TabSelectedEvent> | undefined;
+  onTabSelectionRejected?:
+    | CT.DirectEventHandler<TabSelectionRejectedEvent>
+    | undefined;
+  onTabSelectionPrevented?:
+    | CT.DirectEventHandler<TabSelectionPreventedEvent>
+    | undefined;
+  onMoreTabSelected?: CT.DirectEventHandler<MoreTabSelectedEvent> | undefined;
+
+  // General
+  tabBarHidden?: CT.WithDefault<boolean, false>;
+  nativeContainerBackgroundColor?: ColorValue | undefined;
+  colorScheme?: CT.WithDefault<TabsHostColorScheme, 'inherit'>;
+
+  // We can't use `direction` name for this prop as it's also used by
+  // direction style View prop.
+  layoutDirection?: CT.WithDefault<LayoutDirection, 'inherit'>;
+
+  // iOS-specific props
+  tabBarTintColor?: ColorValue | undefined;
+  tabBarMinimizeBehavior?: CT.WithDefault<TabBarMinimizeBehavior, 'automatic'>;
+  tabBarControllerMode?: CT.WithDefault<TabBarControllerMode, 'automatic'>;
+}
+
+export default codegenNativeComponent<NativeProps>('RNSTabsHostIOS', {
+  interfaceOnly: true,
+  excludedPlatforms: ['android'],
+});

package/src/fabric/tabs/TabsScreenAndroidNativeComponent.ts

@@ -0,0 +1,112 @@
+'use client';
+
+import { codegenNativeComponent } from 'react-native';
+import type {
+  CodegenTypes as CT,
+  ImageSource,
+  ProcessedColorValue,
+  ViewProps,
+} from 'react-native';
+
+// #region General helpers
+
+// eslint-disable-next-line @typescript-eslint/ban-types
+type GenericEmptyEvent = Readonly<{}>;
+
+// #endregion General helpers
+
+// #region Android-specific helpers
+
+type TabBarItemLabelVisibilityMode =
+  | 'auto'
+  | 'selected'
+  | 'labeled'
+  | 'unlabeled';
+
+export type ItemStateAppearance = {
+  tabBarItemTitleFontColor?: ProcessedColorValue | null | undefined;
+  tabBarItemIconColor?: ProcessedColorValue | null | undefined;
+};
+
+export type Appearance = {
+  // TabBar - Appearance
+  tabBarBackgroundColor?: ProcessedColorValue | null | undefined;
+
+  // TabBarItem - Ripple
+  tabBarItemRippleColor?: ProcessedColorValue | null | undefined;
+
+  // TabBarItem - Label layout
+  tabBarItemLabelVisibilityMode?: CT.WithDefault<
+    TabBarItemLabelVisibilityMode,
+    'auto'
+  >;
+
+  // TabBarItem - State-dependent appearance
+  normal?: ItemStateAppearance | undefined;
+  selected?: ItemStateAppearance | undefined;
+  focused?: ItemStateAppearance | undefined;
+  disabled?: ItemStateAppearance | undefined;
+
+  // TabBarItem - Active Indicator
+  tabBarItemActiveIndicatorColor?: ProcessedColorValue | null | undefined;
+  tabBarItemActiveIndicatorEnabled?: CT.WithDefault<boolean, true>;
+
+  // TabBarItem - Label
+  tabBarItemTitleFontFamily?: string | undefined;
+  tabBarItemTitleSmallLabelFontSize?: CT.Float | undefined;
+  tabBarItemTitleLargeLabelFontSize?: CT.Float | undefined;
+  tabBarItemTitleFontWeight?: string | undefined;
+  tabBarItemTitleFontStyle?: string | undefined;
+
+  // TabBarItem - Badge
+  tabBarItemBadgeBackgroundColor?: ProcessedColorValue | null | undefined;
+  tabBarItemBadgeTextColor?: ProcessedColorValue | null | undefined;
+};
+
+// #endregion Android-specific helpers
+
+export interface NativeProps extends ViewProps {
+  // Events
+  onWillAppear?: CT.DirectEventHandler<GenericEmptyEvent> | undefined;
+  onDidAppear?: CT.DirectEventHandler<GenericEmptyEvent> | undefined;
+  onWillDisappear?: CT.DirectEventHandler<GenericEmptyEvent> | undefined;
+  onDidDisappear?: CT.DirectEventHandler<GenericEmptyEvent> | undefined;
+
+  // Control
+  screenKey: string;
+  preventNativeSelection?: CT.WithDefault<boolean, false>;
+
+  // General
+  title?: string | undefined | null;
+  badgeValue?: string | undefined;
+
+  // Accessibility
+  tabBarItemTestID?: string | undefined;
+  tabBarItemAccessibilityLabel?: string | undefined;
+
+  // Effects
+  specialEffects?:
+    | {
+        repeatedTabSelection?:
+          | {
+              popToRoot?: CT.WithDefault<boolean, true>;
+              scrollToTop?: CT.WithDefault<boolean, true>;
+            }
+          | undefined;
+      }
+    | undefined;
+
+  // Android-specific props
+  // Image handling
+  drawableIconResourceName?: string | undefined;
+  imageIconResource?: ImageSource | undefined;
+  selectedDrawableIconResourceName?: string | undefined;
+  selectedImageIconResource?: ImageSource | undefined;
+
+  // Appearance
+  standardAppearance?: Appearance | undefined;
+}
+
+export default codegenNativeComponent<NativeProps>('RNSTabsScreenAndroid', {
+  excludedPlatforms: ['iOS'],
+});

package/src/fabric/tabs/TabsScreenIOSNativeComponent.ts

@@ -0,0 +1,171 @@
+'use client';
+
+import { codegenNativeComponent } from 'react-native';
+import type {
+  CodegenTypes as CT,
+  ImageSource,
+  ProcessedColorValue,
+  ViewProps,
+} from 'react-native';
+
+import { UnsafeMixed } from './codegenUtils';
+
+// #region General helpers
+
+// eslint-disable-next-line @typescript-eslint/ban-types
+type GenericEmptyEvent = Readonly<{}>;
+
+// #endregion General helpers
+
+// #region iOS-specific helpers
+
+// iOS-specific: SFSymbol, image as a template usage
+export type IconType = 'image' | 'template' | 'sfSymbol' | 'xcasset';
+
+export type ItemStateAppearance = {
+  tabBarItemTitleFontFamily?: string | undefined;
+  tabBarItemTitleFontSize?: CT.Float | undefined;
+  tabBarItemTitleFontWeight?: string | undefined;
+  tabBarItemTitleFontStyle?: string | undefined;
+  tabBarItemTitleFontColor?: ProcessedColorValue | null | undefined;
+  tabBarItemTitlePositionAdjustment?:
+    | {
+        horizontal?: CT.Float | undefined;
+        vertical?: CT.Float | undefined;
+      }
+    | undefined;
+  tabBarItemIconColor?: ProcessedColorValue | null | undefined;
+  tabBarItemBadgeBackgroundColor?: ProcessedColorValue | null | undefined;
+};
+
+export type ItemAppearance = {
+  normal?: ItemStateAppearance | undefined;
+  selected?: ItemStateAppearance | undefined;
+  focused?: ItemStateAppearance | undefined;
+  disabled?: ItemStateAppearance | undefined;
+};
+
+export type Appearance = {
+  stacked?: ItemAppearance | undefined;
+  inline?: ItemAppearance | undefined;
+  compactInline?: ItemAppearance | undefined;
+
+  tabBarBackgroundColor?: ProcessedColorValue | null | undefined;
+  tabBarShadowColor?: ProcessedColorValue | null | undefined;
+  tabBarBlurEffect?: CT.WithDefault<BlurEffect, 'systemDefault'>;
+};
+
+type BlurEffect =
+  | 'none'
+  | 'systemDefault'
+  | 'extraLight'
+  | 'light'
+  | 'dark'
+  | 'regular'
+  | 'prominent'
+  | 'systemUltraThinMaterial'
+  | 'systemThinMaterial'
+  | 'systemMaterial'
+  | 'systemThickMaterial'
+  | 'systemChromeMaterial'
+  | 'systemUltraThinMaterialLight'
+  | 'systemThinMaterialLight'
+  | 'systemMaterialLight'
+  | 'systemThickMaterialLight'
+  | 'systemChromeMaterialLight'
+  | 'systemUltraThinMaterialDark'
+  | 'systemThinMaterialDark'
+  | 'systemMaterialDark'
+  | 'systemThickMaterialDark'
+  | 'systemChromeMaterialDark';
+
+type Orientation =
+  | 'inherit'
+  | 'all'
+  | 'allButUpsideDown'
+  | 'portrait'
+  | 'portraitUp'
+  | 'portraitDown'
+  | 'landscape'
+  | 'landscapeLeft'
+  | 'landscapeRight';
+
+type SystemItem =
+  | 'none'
+  | 'bookmarks'
+  | 'contacts'
+  | 'downloads'
+  | 'favorites'
+  | 'featured'
+  | 'history'
+  | 'more'
+  | 'mostRecent'
+  | 'mostViewed'
+  | 'recents'
+  | 'search'
+  | 'topRated';
+
+type UserInterfaceStyle = 'unspecified' | 'light' | 'dark';
+
+// #endregion iOS-specific helpers
+
+export interface NativeProps extends ViewProps {
+  // Events
+  onWillAppear?: CT.DirectEventHandler<GenericEmptyEvent> | undefined;
+  onDidAppear?: CT.DirectEventHandler<GenericEmptyEvent> | undefined;
+  onWillDisappear?: CT.DirectEventHandler<GenericEmptyEvent> | undefined;
+  onDidDisappear?: CT.DirectEventHandler<GenericEmptyEvent> | undefined;
+
+  // Control
+  screenKey: string;
+  preventNativeSelection?: CT.WithDefault<boolean, false>;
+
+  // General
+  title?: string | undefined | null;
+  badgeValue?: string | undefined;
+  orientation?: CT.WithDefault<Orientation, 'inherit'>;
+
+  // Accessibility
+  tabBarItemTestID?: string | undefined;
+  tabBarItemAccessibilityLabel?: string | undefined;
+
+  // Effects
+  specialEffects?:
+    | {
+        repeatedTabSelection?:
+          | {
+              popToRoot?: CT.WithDefault<boolean, true>;
+              scrollToTop?: CT.WithDefault<boolean, true>;
+            }
+          | undefined;
+      }
+    | undefined;
+
+  // iOS-specific props
+  // Tab config
+  isTitleUndefined?: CT.WithDefault<boolean, true>;
+  systemItem?: CT.WithDefault<SystemItem, 'none'>;
+
+  // Appearance
+  standardAppearance?: UnsafeMixed<Appearance> | undefined;
+  scrollEdgeAppearance?: UnsafeMixed<Appearance> | undefined;
+
+  // Icons
+  iconType?: CT.WithDefault<IconType, 'sfSymbol'>;
+  iconImageSource?: ImageSource | undefined;
+  iconResourceName?: string | undefined;
+  selectedIconImageSource?: ImageSource | undefined;
+  selectedIconResourceName?: string | undefined;
+
+  // ScrollView interactions
+  overrideScrollViewContentInsetAdjustmentBehavior?: CT.WithDefault<
+    boolean,
+    true
+  >;
+  // Experimental
+  userInterfaceStyle?: CT.WithDefault<UserInterfaceStyle, 'unspecified'>;
+}
+
+export default codegenNativeComponent<NativeProps>('RNSTabsScreenIOS', {
+  excludedPlatforms: ['android'],
+});

package/src/flags.ts

@@ -1,11 +1,13 @@
-const RNS_CONTROLLED_BOTTOM_TABS_DEFAULT = false;
 const RNS_SYNCHRONOUS_SCREEN_STATE_UPDATES_DEFAULT = false;
 const RNS_SYNCHRONOUS_HEADER_CONFIG_STATE_UPDATES_DEFAULT = false;
 const RNS_SYNCHRONOUS_HEADER_SUBVIEW_STATE_UPDATES_DEFAULT = false;
+const RNS_ANDROID_LEGACY_TOP_INSET_BEHAVIOR_DEFAULT = false;
 const RNS_ANDROID_RESET_SCREEN_SHADOW_STATE_ON_ORIENTATION_CHANGE_DEFAULT =
   true;
 const RNS_IOS_PREVENT_REATTACHMENT_OF_DISMISSED_SCREENS = true;
+const RNS_IOS_PREVENT_REATTACHMENT_OF_DISMISSED_MODALS = true;
 const RNS_IOS_26_ALLOW_INTERACTIONS_DURING_TRANSITION = true;
+const RNS_DEBUG_LOGGING = false;
 
 // TODO: Migrate freeze here
 
@@ -43,28 +45,57 @@ export const compatibilityFlags = {
    * is in use or not.
    */
   usesNewAndroidHeaderHeightImplementation: true,
+
+  /**
+   * Numerous "breaking changes" in the yet-experimental Tabs API have been
+   * introduced with version 4.25.0 of the library.
+   *
+   * This flag marks the shape of the API that's meant for stabilisation, and
+   * enables downstream to detect these changes.
+   *
+   * See:
+   * * https://github.com/software-mansion/react-native-screens/pull/3888
+   * * https://github.com/software-mansion/react-native-screens/pull/3776
+   * * https://github.com/software-mansion/react-native-screens/pull/3781
+   * * https://github.com/software-mansion/react-native-screens/pull/3756
+   * * https://github.com/software-mansion/react-native-screens/pull/3808
+   * * https://github.com/software-mansion/react-native-screens/pull/3785
+   * * https://github.com/software-mansion/react-native-screens/pull/3789
+   * * https://github.com/software-mansion/react-native-screens/pull/3794
+   * * https://github.com/software-mansion/react-native-screens/pull/3863
+   * * https://github.com/software-mansion/react-native-screens/pull/3875
+   * * https://github.com/software-mansion/react-native-screens/pull/3895
+   * * https://github.com/software-mansion/react-native-screens/pull/3918
+   */
+  usesStableTabsApi: true,
 } as const;
 
 const _featureFlags = {
   experiment: {
-    controlledBottomTabs: RNS_CONTROLLED_BOTTOM_TABS_DEFAULT,
     synchronousScreenUpdatesEnabled:
       RNS_SYNCHRONOUS_SCREEN_STATE_UPDATES_DEFAULT,
     synchronousHeaderConfigUpdatesEnabled:
       RNS_SYNCHRONOUS_HEADER_CONFIG_STATE_UPDATES_DEFAULT,
     synchronousHeaderSubviewUpdatesEnabled:
       RNS_SYNCHRONOUS_HEADER_SUBVIEW_STATE_UPDATES_DEFAULT,
+    androidLegacyTopInsetBehavior:
+      RNS_ANDROID_LEGACY_TOP_INSET_BEHAVIOR_DEFAULT,
     androidResetScreenShadowStateOnOrientationChangeEnabled:
       RNS_ANDROID_RESET_SCREEN_SHADOW_STATE_ON_ORIENTATION_CHANGE_DEFAULT,
     iosPreventReattachmentOfDismissedScreens:
       RNS_IOS_PREVENT_REATTACHMENT_OF_DISMISSED_SCREENS,
+    iosPreventReattachmentOfDismissedModals:
+      RNS_IOS_PREVENT_REATTACHMENT_OF_DISMISSED_MODALS,
     ios26AllowInteractionsDuringTransition:
       RNS_IOS_26_ALLOW_INTERACTIONS_DURING_TRANSITION,
   },
-  stable: {},
+  stable: {
+    debugLogging: RNS_DEBUG_LOGGING,
+  },
 };
 
 type EXPERIMENTAL_FF = keyof typeof _featureFlags.experiment;
+type STABLE_FF = keyof typeof _featureFlags.stable;
 
 const createExperimentalFeatureFlagAccessor = <T extends EXPERIMENTAL_FF>(
   key: T,
@@ -88,10 +119,28 @@ const createExperimentalFeatureFlagAccessor = <T extends EXPERIMENTAL_FF>(
   };
 };
 
-const controlledBottomTabsAccessor = createExperimentalFeatureFlagAccessor(
-  'controlledBottomTabs',
-  RNS_CONTROLLED_BOTTOM_TABS_DEFAULT,
-);
+const createStableFeatureFlagAccessor = <T extends STABLE_FF>(
+  key: T,
+  defaultValue: (typeof _featureFlags.stable)[T],
+) => {
+  return {
+    get() {
+      return _featureFlags.stable[key];
+    },
+    set(value: (typeof _featureFlags.stable)[T]) {
+      if (
+        value !== _featureFlags.stable[key] &&
+        _featureFlags.stable[key] !== defaultValue
+      ) {
+        console.error(
+          `[RNScreens] ${key} feature flag modified for a second time; this might lead to unexpected effects`,
+        );
+      }
+      _featureFlags.stable[key] = value;
+    },
+  };
+};
+
 const synchronousScreenUpdatesAccessor = createExperimentalFeatureFlagAccessor(
   'synchronousScreenUpdatesEnabled',
   RNS_SYNCHRONOUS_SCREEN_STATE_UPDATES_DEFAULT,
@@ -106,6 +155,11 @@ const synchronousHeaderSubviewUpdatesAccessor =
     'synchronousHeaderSubviewUpdatesEnabled',
     RNS_SYNCHRONOUS_HEADER_SUBVIEW_STATE_UPDATES_DEFAULT,
   );
+const androidLegacyTopInsetBehaviorAccessor =
+  createExperimentalFeatureFlagAccessor(
+    'androidLegacyTopInsetBehavior',
+    RNS_ANDROID_LEGACY_TOP_INSET_BEHAVIOR_DEFAULT,
+  );
 const androidResetScreenShadowStateOnOrientationChangeAccessor =
   createExperimentalFeatureFlagAccessor(
     'androidResetScreenShadowStateOnOrientationChangeEnabled',
@@ -116,11 +170,20 @@ const iosPreventReattachmentOfDismissedScreensAccessor =
     'iosPreventReattachmentOfDismissedScreens',
     RNS_IOS_PREVENT_REATTACHMENT_OF_DISMISSED_SCREENS,
   );
+const iosPreventReattachmentOfDismissedModalsAccessor =
+  createExperimentalFeatureFlagAccessor(
+    'iosPreventReattachmentOfDismissedModals',
+    RNS_IOS_PREVENT_REATTACHMENT_OF_DISMISSED_MODALS,
+  );
 const ios26AllowInteractionsDuringTransitionAccessor =
   createExperimentalFeatureFlagAccessor(
     'ios26AllowInteractionsDuringTransition',
     RNS_IOS_26_ALLOW_INTERACTIONS_DURING_TRANSITION,
   );
+const rnsDebugLoggingAccessor = createStableFeatureFlagAccessor(
+  'debugLogging',
+  RNS_DEBUG_LOGGING,
+);
 
 /**
  * Exposes configurable global behaviour of the library.
@@ -132,12 +195,6 @@ export const featureFlags = {
    *  Flags to enable experimental features. These might be removed w/o notice or moved to stable.
    */
   experiment: {
-    get controlledBottomTabs() {
-      return controlledBottomTabsAccessor.get();
-    },
-    set controlledBottomTabs(value: boolean) {
-      controlledBottomTabsAccessor.set(value);
-    },
     get synchronousScreenUpdatesEnabled() {
       return synchronousScreenUpdatesAccessor.get();
     },
@@ -156,6 +213,12 @@ export const featureFlags = {
     set synchronousHeaderSubviewUpdatesEnabled(value: boolean) {
       synchronousHeaderSubviewUpdatesAccessor.set(value);
     },
+    get androidLegacyTopInsetBehavior() {
+      return androidLegacyTopInsetBehaviorAccessor.get();
+    },
+    set androidLegacyTopInsetBehavior(value: boolean) {
+      androidLegacyTopInsetBehaviorAccessor.set(value);
+    },
     get androidResetScreenShadowStateOnOrientationChangeEnabled() {
       return androidResetScreenShadowStateOnOrientationChangeAccessor.get();
     },
@@ -174,6 +237,16 @@ export const featureFlags = {
     set iosPreventReattachmentOfDismissedScreens(value: boolean) {
       iosPreventReattachmentOfDismissedScreensAccessor.set(value);
     },
+    /**
+     * Enables the fix for native / JS state desynchronization for Modals. On by default.
+     * PR: https://github.com/software-mansion/react-native-screens/pull/3760
+     */
+    get iosPreventReattachmentOfDismissedModals() {
+      return iosPreventReattachmentOfDismissedModalsAccessor.get();
+    },
+    set iosPreventReattachmentOfDismissedModals(value: boolean) {
+      iosPreventReattachmentOfDismissedModalsAccessor.set(value);
+    },
     /**
      * Disables the behavior that blocks interactions during Stack Screen transition.
      * The application should immediately react to user gestures, dismissing more screens at once, etc.
@@ -191,7 +264,14 @@ export const featureFlags = {
   /**
    * Section for stable flags, which can be used to configure library behaviour.
    */
-  stable: {},
+  stable: {
+    get debugLogging() {
+      return rnsDebugLoggingAccessor.get();
+    },
+    set debugLogging(value: boolean) {
+      rnsDebugLoggingAccessor.set(value);
+    },
+  },
 };
 
 export default featureFlags;

package/src/index.tsx

@@ -2,7 +2,10 @@
 // is loaded.
 import './fabric/NativeScreensModule';
 
-export * from './types';
+/*
+ * V4 types
+ */
+export type * from './types';
 
 /**
  * Core
@@ -62,4 +65,5 @@ export { default as useTransitionProgress } from './useTransitionProgress';
 /**
  * EXPERIMENTAL API BELOW. MIGHT CHANGE W/O ANY NOTICE
  */
-export { default as Tabs } from './components/tabs';
+export * from './components/tabs';
+export type * from './components/shared/types';

package/src/private/hooks/useRenderDebugInfo.tsx

@@ -1,5 +1,6 @@
 import React from 'react';
 import { findNodeHandle, ReactNativeElement } from 'react-native';
+import { RNSLog } from '../logging';
 
 export type NativeComponentGenericRef = React.Component & ReactNativeElement;
 
@@ -42,5 +43,5 @@ function logMessage(
   nodeHandle: number,
   message: string,
 ) {
-  console.log(`${componentName} [${nodeHandle}] ${message}`);
+  RNSLog.log(`${componentName} [${nodeHandle}] ${message}`);
 }

package/src/private/index.ts

@@ -2,10 +2,7 @@
 export type * from './types';
 
 // Logging
-export {
-  internalEnableDetailedBottomTabsLogging,
-  bottomTabsDebugLog,
-} from './logging';
+export { RNSLog } from './logging';
 
 // Hooks