react-native-screens 4.0.0-beta.12 → 4.0.0-beta.14

package/README.md

@@ -133,6 +133,9 @@ Here's a table with summary of supported `react-native` versions when Fabric is
 
 ## Usage with [react-navigation](https://github.com/react-navigation/react-navigation)
 
+> [!CAUTION]
+> NativeStack has been moved from react-native-screens/native-stack to @react-navigation/native since version v6. With react-native-screens v4 native stack v5 (react-native-screens/native-stack) is deprecated and marked for removal in the upcoming minor release, react-native-screens v4 will support only @react-navigation/native-stack v7.
+
 Screens support is built into [react-navigation](https://github.com/react-navigation/react-navigation) starting from version [2.14.0](https://github.com/react-navigation/react-navigation/releases/tag/2.14.0) for all the different navigator types (stack, tab, drawer, etc).
 
 To configure react-navigation to use screens instead of plain RN Views for rendering screen views, simply add this library as a dependency to your project:
@@ -184,7 +187,6 @@ You can also disable the usage of native screens per navigator with [`detachInac
 To take advantage of the native stack navigator primitive for React Navigation that leverages `UINavigationController` on iOS and `Fragment` on Android, please refer:
 
 - for React Navigation >= v6 to the [Native Stack Navigator part of React Navigation documentation](https://reactnavigation.org/docs/native-stack-navigator)
-- for React Navigation v5 to the [README in react-native-screens/native-stack](https://github.com/software-mansion/react-native-screens/tree/main/native-stack)
 
 ## `FullWindowOverlay`
 

package/android/CMakeLists.txt

@@ -41,28 +41,37 @@ find_package(ReactAndroid REQUIRED CONFIG)
 if(${RNS_NEW_ARCH_ENABLED})
     find_package(fbjni REQUIRED CONFIG)
     
-    target_link_libraries(
-        rnscreens
+    if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+        target_link_libraries(rnscreens
+            ReactAndroid::reactnative
             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
-    )
+        )
+    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()
 else()
     target_link_libraries(rnscreens
         ReactAndroid::jsi

package/android/src/main/java/com/swmansion/rnscreens/NativeDismissalObserver.kt

@@ -0,0 +1,12 @@
+package com.swmansion.rnscreens
+
+interface NativeDismissalObserver {
+    /**
+     * Observed object should call this observer method when it has been natively dismissed,
+     * e.g. in the result of user gesture or other interaction.
+     *
+     * Prominent usage is for the screen with sheet presentation to notify its wrapper that
+     * it has been hidden and requires dismissal.
+     */
+    fun onNativeDismiss(dismissed: ScreenStackFragmentWrapper)
+}

package/android/src/main/java/com/swmansion/rnscreens/ScreenStackFragment.kt

@@ -24,7 +24,6 @@ import androidx.annotation.RequiresApi
 import androidx.appcompat.widget.Toolbar
 import androidx.coordinatorlayout.widget.CoordinatorLayout
 import androidx.core.view.WindowInsetsCompat
-import androidx.fragment.app.commit
 import com.facebook.react.uimanager.PixelUtil
 import com.facebook.react.uimanager.PointerEvents
 import com.facebook.react.uimanager.ReactPointerEventsView
@@ -35,8 +34,12 @@ import com.google.android.material.bottomsheet.BottomSheetBehavior.BottomSheetCa
 import com.google.android.material.shape.CornerFamily
 import com.google.android.material.shape.MaterialShapeDrawable
 import com.google.android.material.shape.ShapeAppearanceModel
-import com.swmansion.rnscreens.bottomsheet.DimmingFragment
 import com.swmansion.rnscreens.bottomsheet.SheetUtils
+import com.swmansion.rnscreens.bottomsheet.isSheetFitToContents
+import com.swmansion.rnscreens.bottomsheet.useSingleDetent
+import com.swmansion.rnscreens.bottomsheet.useThreeDetents
+import com.swmansion.rnscreens.bottomsheet.useTwoDetents
+import com.swmansion.rnscreens.bottomsheet.usesFormSheetPresentation
 import com.swmansion.rnscreens.ext.recycle
 import com.swmansion.rnscreens.utils.DeviceUtils
 
@@ -53,6 +56,7 @@ class KeyboardVisible(
 class ScreenStackFragment :
     ScreenFragment,
     ScreenStackFragmentWrapper {
+    public var nativeDismissalObserver: NativeDismissalObserver? = null
     private var appBarLayout: AppBarLayout? = null
     private var toolbar: Toolbar? = null
     private var isToolbarShadowHidden = false
@@ -157,30 +161,22 @@ class ScreenStackFragment :
                     screen.notifySheetDetentChange(
                         SheetUtils.detentIndexFromSheetState(
                             lastStableState,
-                            screen.sheetDetents.count()
-                        ), true
+                            screen.sheetDetents.count(),
+                        ),
+                        true,
                     )
                 } else if (newState == BottomSheetBehavior.STATE_DRAGGING) {
                     screen.notifySheetDetentChange(
                         SheetUtils.detentIndexFromSheetState(
                             lastStableState,
-                            screen.sheetDetents.count()
+                            screen.sheetDetents.count(),
                         ),
                         false,
                     )
                 }
 
                 if (newState == BottomSheetBehavior.STATE_HIDDEN) {
-                    // If we are wrapped in DimmingFragment we want it to be removed alongside
-                    // => we use its fragment manager. Otherwise we just remove this fragment.
-                    if (this@ScreenStackFragment.parentFragment is DimmingFragment) {
-                        parentFragmentManager.commit {
-                            setReorderingAllowed(true)
-                            remove(this@ScreenStackFragment)
-                        }
-                    } else {
-                        this@ScreenStackFragment.dismissFromContainer()
-                    }
+                    nativeDismissalObserver?.onNativeDismiss(this@ScreenStackFragment)
                 }
             }
 
@@ -223,7 +219,7 @@ class ScreenStackFragment :
                     LinearLayout.LayoutParams.MATCH_PARENT,
                 ).apply {
                     behavior =
-                        if (screen.stackPresentation == Screen.StackPresentation.FORM_SHEET) {
+                        if (screen.usesFormSheetPresentation()) {
                             createAndConfigureBottomSheetBehaviour()
                         } else if (isToolbarTranslucent) {
                             null
@@ -232,7 +228,7 @@ class ScreenStackFragment :
                         }
                 }
 
-        if (screen.stackPresentation == Screen.StackPresentation.FORM_SHEET) {
+        if (screen.usesFormSheetPresentation()) {
             screen.clipToOutline = true
             // TODO(@kkafar): without this line there is no drawable / outline & nothing shows...? Determine what's going on here
             attachShapeToScreen(screen)
@@ -241,7 +237,7 @@ class ScreenStackFragment :
 
         coordinatorLayout.addView(screen.recycle())
 
-        if (screen.stackPresentation != Screen.StackPresentation.FORM_SHEET) {
+        if (!screen.usesFormSheetPresentation()) {
             appBarLayout =
                 context?.let { AppBarLayout(it) }?.apply {
                     // By default AppBarLayout will have a background color set but since we cover the whole layout
@@ -348,52 +344,39 @@ class ScreenStackFragment :
         return when (keyboardState) {
             is KeyboardNotVisible -> {
                 when (screen.sheetDetents.count()) {
-                    1 -> if (screen.sheetDetents.first() == Screen.SHEET_FIT_TO_CONTENTS) {
-                        behavior.apply {
-                            state = BottomSheetBehavior.STATE_EXPANDED
-                            screen.contentWrapper.get()?.let {
-                                maxHeight = it.height
-                            }
-                            skipCollapsed = true
-                            isFitToContents = true
-                        }
-                    } else {
+                    1 ->
                         behavior.apply {
-                            state = BottomSheetBehavior.STATE_EXPANDED
-                            skipCollapsed = true
-                            isFitToContents = true
-                            maxHeight = (screen.sheetDetents.first() * containerHeight).toInt()
+                            val height =
+                                if (screen.isSheetFitToContents()) {
+                                    screen.contentWrapper.get()?.height
+                                } else {
+                                    (screen.sheetDetents.first() * containerHeight).toInt()
+                                }
+                            useSingleDetent(height = height)
                         }
-                    }
 
                     2 ->
-                        behavior.apply {
+                        behavior.useTwoDetents(
                             state =
                                 SheetUtils.sheetStateFromDetentIndex(
                                     screen.sheetInitialDetentIndex,
                                     screen.sheetDetents.count(),
-                                )
-                            skipCollapsed = false
-                            isFitToContents = true
-                            peekHeight = (screen.sheetDetents[0] * containerHeight).toInt()
-                            maxHeight = (screen.sheetDetents[1] * containerHeight).toInt()
-                        }
+                                ),
+                            firstHeight = (screen.sheetDetents[0] * containerHeight).toInt(),
+                            secondHeight = (screen.sheetDetents[1] * containerHeight).toInt(),
+                        )
 
                     3 ->
-                        behavior.apply {
+                        behavior.useThreeDetents(
                             state =
                                 SheetUtils.sheetStateFromDetentIndex(
                                     screen.sheetInitialDetentIndex,
                                     screen.sheetDetents.count(),
-                                )
-                            skipCollapsed = false
-                            isFitToContents = false
-                            peekHeight = (screen.sheetDetents[0] * containerHeight).toInt()
-                            expandedOffset =
-                                ((1 - screen.sheetDetents[2]) * containerHeight).toInt()
-                            halfExpandedRatio =
-                                (screen.sheetDetents[1] / screen.sheetDetents[2]).toFloat()
-                        }
+                                ),
+                            firstHeight = (screen.sheetDetents[0] * containerHeight).toInt(),
+                            halfExpandedRatio = (screen.sheetDetents[1] / screen.sheetDetents[2]).toFloat(),
+                            expandedOffsetFromTop = ((1 - screen.sheetDetents[2]) * containerHeight).toInt(),
+                        )
 
                     else -> throw IllegalStateException(
                         "[RNScreens] Invalid detent count ${screen.sheetDetents.count()}. Expected at most 3.",
@@ -411,27 +394,24 @@ class ScreenStackFragment :
                 when (screen.sheetDetents.count()) {
                     1 ->
                         behavior.apply {
-                            state = BottomSheetBehavior.STATE_EXPANDED
-                            skipCollapsed = true
-                            isFitToContents = true
-                            maxHeight = newMaxHeight
+                            useSingleDetent(height = newMaxHeight)
                             addBottomSheetCallback(keyboardSheetCallback)
                         }
 
                     2 ->
                         behavior.apply {
-                            state = BottomSheetBehavior.STATE_EXPANDED
-                            skipCollapsed = false
-                            isFitToContents = true
-                            maxHeight = newMaxHeight
+                            useTwoDetents(
+                                state = BottomSheetBehavior.STATE_EXPANDED,
+                                secondHeight = newMaxHeight,
+                            )
                             addBottomSheetCallback(keyboardSheetCallback)
                         }
 
                     3 ->
                         behavior.apply {
-                            state = BottomSheetBehavior.STATE_EXPANDED
-                            skipCollapsed = false
-                            isFitToContents = false
+                            useThreeDetents(
+                                state = BottomSheetBehavior.STATE_EXPANDED,
+                            )
                             maxHeight = newMaxHeight
                             addBottomSheetCallback(keyboardSheetCallback)
                         }
@@ -450,30 +430,23 @@ class ScreenStackFragment :
                 behavior.removeBottomSheetCallback(keyboardSheetCallback)
                 when (screen.sheetDetents.count()) {
                     1 ->
-                        behavior.apply {
-                            skipCollapsed = true
-                            isFitToContents = true
-                            maxHeight = (screen.sheetDetents.first() * containerHeight).toInt()
-                        }
+                        behavior.useSingleDetent(
+                            height = (screen.sheetDetents.first() * containerHeight).toInt(),
+                            forceExpandedState = false,
+                        )
 
                     2 ->
-                        behavior.apply {
-                            skipCollapsed = false
-                            isFitToContents = true
-                            peekHeight = (screen.sheetDetents[0] * containerHeight).toInt()
-                            maxHeight = (screen.sheetDetents[1] * containerHeight).toInt()
-                        }
+                        behavior.useTwoDetents(
+                            firstHeight = (screen.sheetDetents[0] * containerHeight).toInt(),
+                            secondHeight = (screen.sheetDetents[1] * containerHeight).toInt(),
+                        )
 
                     3 ->
-                        behavior.apply {
-                            skipCollapsed = false
-                            isFitToContents = false
-                            peekHeight = (screen.sheetDetents[0] * containerHeight).toInt()
-                            expandedOffset =
-                                ((1 - screen.sheetDetents[2]) * containerHeight).toInt()
-                            halfExpandedRatio =
-                                (screen.sheetDetents[1] / screen.sheetDetents[2]).toFloat()
-                        }
+                        behavior.useThreeDetents(
+                            firstHeight = (screen.sheetDetents[0] * containerHeight).toInt(),
+                            halfExpandedRatio = (screen.sheetDetents[1] / screen.sheetDetents[2]).toFloat(),
+                            expandedOffsetFromTop = ((1 - screen.sheetDetents[2]) * containerHeight).toInt(),
+                        )
 
                     else -> throw IllegalStateException(
                         "[RNScreens] Invalid detent count ${screen.sheetDetents.count()}. Expected at most 3.",
@@ -498,7 +471,10 @@ class ScreenStackFragment :
                     setTopRightCorner(CornerFamily.ROUNDED, cornerSize)
                 }.build()
         val shape = MaterialShapeDrawable(shapeAppearanceModel)
-        shape.setTint((screen.background as? ColorDrawable?)?.color ?: Color.TRANSPARENT)
+        val currentColor =
+            (screen.background as? ColorDrawable?)?.color
+                ?: (screen.background as? MaterialShapeDrawable?)?.tintList?.defaultColor
+        shape.setTint(currentColor ?: Color.TRANSPARENT)
         screen.background = shape
     }
 
@@ -595,8 +571,7 @@ class ScreenStackFragment :
 //    ) : CoordinatorLayout(context), ReactCompoundViewGroup, ReactHitSlopView {
     ) : CoordinatorLayout(context),
         ReactPointerEventsView {
-        override fun onApplyWindowInsets(insets: WindowInsets?): WindowInsets =
-            super.onApplyWindowInsets(insets)
+        override fun onApplyWindowInsets(insets: WindowInsets?): WindowInsets = super.onApplyWindowInsets(insets)
 
         private val animationListener: Animation.AnimationListener =
             object : Animation.AnimationListener {

package/android/src/main/java/com/swmansion/rnscreens/bottomsheet/BottomSheetBehaviorExt.kt

@@ -0,0 +1,42 @@
+package com.swmansion.rnscreens.bottomsheet
+
+import android.view.View
+import com.google.android.material.bottomsheet.BottomSheetBehavior
+
+internal fun <T : View> BottomSheetBehavior<T>.useSingleDetent(height: Int? = null, forceExpandedState: Boolean = true): BottomSheetBehavior<T> {
+    this.skipCollapsed = true
+    this.isFitToContents = true
+    if (forceExpandedState) {
+        this.state = BottomSheetBehavior.STATE_EXPANDED
+    }
+    height?.let { maxHeight = height }
+    return this
+}
+
+internal fun <T : View> BottomSheetBehavior<T>.useTwoDetents(
+    @BottomSheetBehavior.StableState state: Int? = null,
+    firstHeight: Int? = null,
+    secondHeight: Int? = null
+): BottomSheetBehavior<T> {
+    skipCollapsed = false
+    isFitToContents = true
+    state?.let { this.state = state }
+    firstHeight?.let { peekHeight = firstHeight }
+    secondHeight?.let { maxHeight = secondHeight }
+    return this
+}
+
+internal fun <T : View> BottomSheetBehavior<T>.useThreeDetents(
+    @BottomSheetBehavior.StableState state: Int? = null,
+    firstHeight: Int? = null,
+    halfExpandedRatio: Float? = null,
+    expandedOffsetFromTop: Int? = null
+): BottomSheetBehavior<T> {
+    skipCollapsed = false
+    isFitToContents = false
+    state?.let { this.state = state }
+    firstHeight?.let { this.peekHeight = firstHeight }
+    halfExpandedRatio?.let { this.halfExpandedRatio = halfExpandedRatio }
+    expandedOffsetFromTop?.let { this.expandedOffset = expandedOffsetFromTop }
+    return this
+}

package/android/src/main/java/com/swmansion/rnscreens/bottomsheet/DimmingFragment.kt

@@ -27,6 +27,7 @@ import com.swmansion.rnscreens.KeyboardDidHide
 import com.swmansion.rnscreens.KeyboardNotVisible
 import com.swmansion.rnscreens.KeyboardState
 import com.swmansion.rnscreens.KeyboardVisible
+import com.swmansion.rnscreens.NativeDismissalObserver
 import com.swmansion.rnscreens.R
 import com.swmansion.rnscreens.Screen
 import com.swmansion.rnscreens.ScreenContainer
@@ -48,7 +49,8 @@ class DimmingFragment(
     LifecycleEventObserver,
     ScreenStackFragmentWrapper,
     Animation.AnimationListener,
-    OnApplyWindowInsetsListener {
+    OnApplyWindowInsetsListener,
+    NativeDismissalObserver {
     private lateinit var dimmingView: DimmingView
     private lateinit var containerView: GestureTransparentViewGroup
 
@@ -65,8 +67,15 @@ class DimmingFragment(
     private val insetsProxy = InsetsObserverProxy
 
     init {
-        // We register for our child lifecycle as we want to know when it's dismissed via native gesture
-        nestedFragment.fragment.lifecycle.addObserver(this)
+        assert(
+            nestedFragment.fragment is ScreenStackFragment,
+        ) { "[RNScreens] Dimming fragment is intended for use only with ScreenStackFragment" }
+        val fragment = nestedFragment.fragment as ScreenStackFragment
+
+        // We register for our child lifecycle as we want to know when it starts, because bottom sheet
+        // behavior is attached only then & we want to attach our own callbacks to it.
+        fragment.lifecycle.addObserver(this)
+        fragment.nativeDismissalObserver = this
     }
 
     /**
@@ -111,8 +120,8 @@ class DimmingFragment(
                     computeOffsetFromDetentIndex(
                         (screen.sheetLargestUndimmedDetentIndex + 1).coerceIn(
                             0,
-                            screen.sheetDetents.count() - 1
-                        )
+                            screen.sheetDetents.count() - 1,
+                        ),
                     )
                 assert(firstDimmedOffset >= largestUndimmedOffset) {
                     "[RNScreens] Invariant violation: firstDimmedOffset ($firstDimmedOffset) < largestDimmedOffset ($largestUndimmedOffset)"
@@ -173,7 +182,7 @@ class DimmingFragment(
         // We want dimming view to have always fade animation in current usages.
         AnimationUtils.loadAnimation(
             context,
-            if (enter) R.anim.rns_fade_in else R.anim.rns_fade_out
+            if (enter) R.anim.rns_fade_in else R.anim.rns_fade_out,
         )
 
     override fun onCreateView(
@@ -226,10 +235,6 @@ class DimmingFragment(
                 }
             }
 
-            Lifecycle.Event.ON_STOP -> {
-                dismissSelf(emitDismissedEvent = true)
-            }
-
             else -> {}
         }
     }
@@ -350,13 +355,9 @@ class DimmingFragment(
         nestedFragment.onViewAnimationEnd()
     }
 
-    override fun tryGetActivity(): Activity? {
-        return activity
-    }
+    override fun tryGetActivity(): Activity? = activity
 
-    override fun tryGetContext(): ReactContext? {
-        return context as? ReactContext?
-    }
+    override fun tryGetContext(): ReactContext? = context as? ReactContext?
 
     override val fragment: Fragment
         get() = this
@@ -417,7 +418,7 @@ class DimmingFragment(
             screen.sheetBehavior?.let {
                 (nestedFragment as ScreenStackFragment).configureBottomSheetBehaviour(
                     it,
-                    KeyboardVisible(imeInset.bottom)
+                    KeyboardVisible(imeInset.bottom),
                 )
             }
 
@@ -457,12 +458,12 @@ class DimmingFragment(
                 if (isKeyboardVisible) {
                     (nestedFragment as ScreenStackFragment).configureBottomSheetBehaviour(
                         it,
-                        KeyboardDidHide
+                        KeyboardDidHide,
                     )
                 } else if (keyboardState != KeyboardNotVisible) {
                     (nestedFragment as ScreenStackFragment).configureBottomSheetBehaviour(
                         it,
-                        KeyboardNotVisible
+                        KeyboardNotVisible,
                     )
                 } else {
                 }
@@ -485,4 +486,8 @@ class DimmingFragment(
                 ).build()
         }
     }
+
+    override fun onNativeDismiss(dismissed: ScreenStackFragmentWrapper) {
+        dismissSelf(emitDismissedEvent = true)
+    }
 }

package/android/src/main/java/com/swmansion/rnscreens/bottomsheet/SheetUtils.kt

@@ -5,6 +5,7 @@ import com.google.android.material.bottomsheet.BottomSheetBehavior.STATE_COLLAPS
 import com.google.android.material.bottomsheet.BottomSheetBehavior.STATE_EXPANDED
 import com.google.android.material.bottomsheet.BottomSheetBehavior.STATE_HALF_EXPANDED
 import com.google.android.material.bottomsheet.BottomSheetBehavior.STATE_HIDDEN
+import com.swmansion.rnscreens.Screen
 
 object SheetUtils {
     /**
@@ -125,3 +126,10 @@ object SheetUtils {
         return false
     }
 }
+
+fun Screen.isSheetFitToContents(): Boolean =
+    stackPresentation === Screen.StackPresentation.FORM_SHEET &&
+            sheetDetents.count() == 1 &&
+            sheetDetents.first() == Screen.SHEET_FIT_TO_CONTENTS
+
+fun Screen.usesFormSheetPresentation(): Boolean = stackPresentation === Screen.StackPresentation.FORM_SHEET

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

@@ -38,25 +38,34 @@ target_include_directories(
   ${LIB_ANDROID_GENERATED_COMPONENTS_DIR}
 )
 
-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
-)
+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_compile_options(
   ${LIB_TARGET_NAME}

package/ios/RNSConvert.h

@@ -1,12 +1,17 @@
-#ifdef RCT_NEW_ARCH_ENABLED
 #import <UIKit/UIKit.h>
+#ifdef RCT_NEW_ARCH_ENABLED
 #import <react/renderer/components/rnscreens/Props.h>
+#endif // RCT_NEW_ARCH_ENABLED
 #import "RNSEnums.h"
 
+#ifdef RCT_NEW_ARCH_ENABLED
 namespace react = facebook::react;
+#endif // RCT_NEW_ARCH_ENABLED
 
 @interface RNSConvert : NSObject
 
+#ifdef RCT_NEW_ARCH_ENABLED
+
 + (UISemanticContentAttribute)UISemanticContentAttributeFromCppEquivalent:
     (react::RNSScreenStackHeaderConfigDirection)direction;
 
@@ -42,8 +47,12 @@ namespace react = facebook::react;
 
 + (NSMutableArray<NSNumber *> *)arrayFromVector:(const std::vector<CGFloat> &)vector;
 
-+ (UIBlurEffectStyle)UIBlurEffectStyleFromCppEquivalent:(react::RNSScreenStackHeaderConfigBlurEffect)blurEffect;
-
-@end
++ (RNSBlurEffectStyle)RNSBlurEffectStyleFromCppEquivalent:(react::RNSScreenStackHeaderConfigBlurEffect)blurEffect;
 
 #endif // RCT_NEW_ARCH_ENABLED
+
+/// This method fails (by assertion) when `blurEffect == RNSBlurEffectStyleNone` which has no counter part in the UIKit
+/// type.
++ (UIBlurEffectStyle)tryConvertRNSBlurEffectStyleToUIBlurEffectStyle:(RNSBlurEffectStyle)blurEffect;
+
+@end