react-native-screens 5.0.0-alpha.1 → 5.0.0-alpha.2

package/android/src/main/java/com/swmansion/rnscreens/stack/header/toolbar/update/StackHeaderToolbarMenuElementUpdate.kt

@@ -0,0 +1,10 @@
+package com.swmansion.rnscreens.stack.header.toolbar.update
+
+/**
+ * A single toolbar menu element update whose icon has already been resolved and merged
+ * into [options], ready to be applied to the toolbar.
+ */
+internal data class StackHeaderToolbarMenuElementUpdate(
+    val id: String,
+    val options: StackHeaderToolbarMenuElementOptions,
+)

package/android/src/main/java/com/swmansion/rnscreens/stack/header/toolbar/update/StackHeaderToolbarMenuIconResolver.kt

@@ -0,0 +1,17 @@
+package com.swmansion.rnscreens.stack.header.toolbar.update
+
+import android.graphics.drawable.Drawable
+import com.swmansion.rnscreens.stack.header.toolbar.model.StackHeaderToolbarMenuItemIconSource
+
+/**
+ * Resolves the icon for a single menu element update.
+ *
+ * [onResolved] must be invoked exactly once — synchronously or asynchronously, always on the
+ * main thread — with the resolved icon to merge into the element's options.
+ */
+internal fun interface StackHeaderToolbarMenuIconResolver {
+    fun resolve(
+        iconSource: StackHeaderToolbarMenuItemIconSource,
+        onResolved: (icon: StackHeaderToolbarFieldUpdate<Drawable>) -> Unit,
+    )
+}

package/android/src/main/java/com/swmansion/rnscreens/stack/header/toolbar/{StackHeaderToolbarMenuUpdateQueue.kt → update/StackHeaderToolbarMenuUpdateQueue.kt}

@@ -1,46 +1,4 @@
-package com.swmansion.rnscreens.stack.header.toolbar
-
-import android.graphics.drawable.Drawable
-
-/**
- * A single toolbar menu element update carried by an `updateToolbarMenuElements`
- * view command, before its icon (if any) has been resolved.
- */
-internal data class StackHeaderToolbarMenuElementRawUpdate(
-    val id: String,
-    val options: StackHeaderToolbarMenuElementOptions,
-    val iconSource: StackHeaderToolbarMenuItemIconSource?,
-)
-
-/**
- * A single toolbar menu element update whose icon has already been resolved and merged
- * into [options], ready to be applied to the toolbar.
- */
-internal data class StackHeaderToolbarMenuElementUpdate(
-    val id: String,
-    val options: StackHeaderToolbarMenuElementOptions,
-)
-
-/**
- * Resolves the icon for a single menu element update.
- *
- * [onResolved] must be invoked exactly once — synchronously or asynchronously, always on the
- * main thread — with the resolved icon to merge into the element's options.
- */
-internal fun interface StackHeaderToolbarMenuIconResolver {
-    fun resolve(
-        iconSource: StackHeaderToolbarMenuItemIconSource,
-        onResolved: (icon: StackHeaderToolbarFieldUpdate<Drawable>) -> Unit,
-    )
-}
-
-/**
- * Receives a fully-resolved batch of menu element updates, to be applied to the toolbar
- * atomically.
- */
-internal fun interface StackHeaderToolbarMenuUpdateQueueDelegate {
-    fun onUpdatesResolved(updates: List<StackHeaderToolbarMenuElementUpdate>)
-}
+package com.swmansion.rnscreens.stack.header.toolbar.update
 
 /**
  * Serial, FIFO queue for `updateToolbarMenuElements` view command batches.

package/android/src/main/java/com/swmansion/rnscreens/stack/header/toolbar/update/StackHeaderToolbarMenuUpdateQueueDelegate.kt

@@ -0,0 +1,9 @@
+package com.swmansion.rnscreens.stack.header.toolbar.update
+
+/**
+ * Receives a fully-resolved batch of menu element updates, to be applied to the toolbar
+ * atomically.
+ */
+internal fun interface StackHeaderToolbarMenuUpdateQueueDelegate {
+    fun onUpdatesResolved(updates: List<StackHeaderToolbarMenuElementUpdate>)
+}

package/android/src/main/java/com/swmansion/rnscreens/stack/screen/StackScreen.kt

@@ -131,6 +131,7 @@ class StackScreen(
         scrollView: ViewGroup,
     ) {
         containerItemSupport.registerScrollView(scrollView)
+        headerConfig?.onContentScrollViewChanged()
     }
 
     // endregion

package/common/cpp/react/renderer/components/rnscreens/legacy/RNSScreenShadowNode.cpp

@@ -77,7 +77,11 @@ std::optional<float> findHeaderHeight(
   }
 
   jfloat headerHeight = env->CallFloatMethod(
-      packageInstance, computeDummyLayoutID, fontSize, isTitleEmpty, applyTopInset);
+      packageInstance,
+      computeDummyLayoutID,
+      fontSize,
+      isTitleEmpty,
+      applyTopInset);
 
   return {headerHeight};
 }
@@ -103,10 +107,11 @@ void RNSScreenShadowNode::appendChild(
               headerConfigChild->getProps());
 
       // The native CustomToolbar only pads itself with the top inset when
-      // `legacyTopInsetBehavior || consumeTopInset` holds (see CustomToolbar.kt).
-      // The dummy measurement must mirror that condition, otherwise the header
-      // height is over-reported by the top inset whenever a header opts out via
-      // `disableTopInsetApplication` (consumeTopInset == false).
+      // `legacyTopInsetBehavior || consumeTopInset` holds (see
+      // CustomToolbar.kt). The dummy measurement must mirror that condition,
+      // otherwise the header height is over-reported by the top inset whenever
+      // a header opts out via `disableTopInsetApplication` (consumeTopInset ==
+      // false).
       const bool applyTopInset =
           headerProps.legacyTopInsetBehavior || headerProps.consumeTopInset;
 

package/ios/RNSEnums.h

@@ -54,8 +54,6 @@ typedef NS_ENUM(NSInteger, RNSTabsIconType) {
   RNSTabsIconTypeXcasset,
 };
 
-// TODO: investigate objc - swift interop and deduplicate this code
-// This enum needs to be compatible with the RNSOrientationSwift enum.
 typedef NS_ENUM(NSInteger, RNSOrientation) {
   RNSOrientationInherit,
   RNSOrientationAll,

package/ios/RNSOrientationProviding.h

@@ -4,8 +4,6 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-// TODO: investigate objc - swift interop and deduplicate this code
-// This class needs to be compatible with the RNSOrientationProvidingSwift.
 @protocol RNSOrientationProviding
 
 - (RNSOrientation)evaluateOrientation;

package/ios/RNSReactMountingTransactionObserving.h

@@ -0,0 +1,15 @@
+#pragma once
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@protocol RNSReactMountingTransactionObserving
+
+- (void)reactMountingTransactionWillMount;
+
+- (void)reactMountingTransactionDidMount;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/legacy/RNSBarButtonItem.mm

@@ -188,11 +188,18 @@ static UIMenuOptions RNSMakeUIMenuOptionsFromConfig(NSDictionary *config);
                  image = img;
                }];
 
-  return [UIMenu menuWithTitle:dict[@"title"]
-                         image:image
-                    identifier:nil
-                       options:RNSMakeUIMenuOptionsFromConfig(dict)
-                      children:elements];
+  UIMenu *menu = [UIMenu menuWithTitle:dict[@"title"]
+                                 image:image
+                            identifier:nil
+                               options:RNSMakeUIMenuOptionsFromConfig(dict)
+                              children:elements];
+
+  NSString *subtitle = dict[@"subtitle"];
+  if (subtitle != nil) {
+    menu.subtitle = subtitle;
+  }
+
+  return menu;
 }
 
 + (UIAction *)createActionItemFromConfig:(NSDictionary *)dict

package/ios/legacy/RNSScreen.h

@@ -50,7 +50,7 @@ NS_ASSUME_NONNULL_BEGIN
 - (void)calculateAndNotifyHeaderHeightChangeIsModal:(BOOL)isModal;
 - (void)notifyFinishTransitioning;
 - (RNSScreenView *)screenView;
-- (void)setViewToSnapshot;
+- (void)addSnapshotToView;
 - (CGFloat)calculateHeaderHeightIsModal:(BOOL)isModal;
 - (BOOL)isRemovedFromParent;
 - (void)notifyPresentedControllerDismissed;
@@ -87,9 +87,16 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic) RNSScrollEdgeEffect rightScrollEdgeEffect;
 @property (nonatomic) RNSScrollEdgeEffect topScrollEdgeEffect;
 @property (nonatomic, readwrite) BOOL synchronousShadowStateUpdatesEnabled;
+@property (nonatomic, readwrite) BOOL iosOrientationInheritanceFixEnabled;
 
 @property (nonatomic, retain) NSNumber *transitionDuration;
 @property (nonatomic, readonly) BOOL dismissed;
+
+/**
+ * Whether React has already deleted this component. The view may still be part of the view
+ * hierarchy at that point, backing the remainder of an ongoing native transition.
+ */
+@property (nonatomic, readonly, getter=isInvalidated) BOOL invalidated;
 @property (nonatomic) BOOL hideKeyboardOnSwipe;
 @property (nonatomic) BOOL customAnimationOnSwipe;
 @property (nonatomic) BOOL preventNativeDismiss;

package/ios/legacy/RNSScreen.mm

@@ -102,6 +102,7 @@ struct ContentWrapperBox {
   _sheetContentHeight = 0.0;
   _markedForUnmountInCurrentTransaction = NO;
   _synchronousShadowStateUpdatesEnabled = YES;
+  _iosOrientationInheritanceFixEnabled = YES;
 }
 
 - (BOOL)getFullScreenSwipeShadowEnabled
@@ -769,6 +770,8 @@ RNS_IGNORE_SUPER_CALL_END
 
 - (void)invalidateImpl
 {
+  _invalidated = YES;
+
   // Since the scroll view might get immediately recycled we remove ourselves
   // immediately.
   if (_sheetsScrollView != nil) {
@@ -1259,6 +1262,8 @@ RNS_IGNORE_SUPER_CALL_END
 
   [self setSynchronousShadowStateUpdatesEnabled:newScreenProps.synchronousShadowStateUpdatesEnabled];
 
+  [self setIosOrientationInheritanceFixEnabled:newScreenProps.iosOrientationInheritanceFixEnabled];
+
 #if !TARGET_OS_TV
   if (newScreenProps.statusBarHidden != oldScreenProps.statusBarHidden) {
     [self setStatusBarHidden:newScreenProps.statusBarHidden];
@@ -1407,7 +1412,6 @@ Class<RCTComponentViewProtocol> RNSScreenCls(void)
 @implementation RNSScreen {
   __weak id _previousFirstResponder;
   CGRect _lastViewFrame;
-  RNSScreenView *_initialView;
   UIView *_fakeView;
   CADisplayLink *_animationTimer;
   CGFloat _currentAlpha;
@@ -1428,7 +1432,6 @@ Class<RCTComponentViewProtocol> RNSScreenCls(void)
     _fakeView = [UIView new];
     _shouldNotify = YES;
     _isRemovedFromParent = NO;
-    _initialView = (RNSScreenView *)view;
   }
   return self;
 }
@@ -1751,9 +1754,13 @@ Class<RCTComponentViewProtocol> RNSScreenCls(void)
 
 - (void)notifyTransitionProgress:(double)progress closing:(BOOL)closing goingForward:(BOOL)goingForward
 {
-  if ([self.view isKindOfClass:[RNSScreenView class]]) {
-    // if the view is already snapshot, there is not sense in sending progress since on JS side
-    // the component is already not present
+  if (![self.view isKindOfClass:[RNSScreenView class]]) {
+    return;
+  }
+
+  // if the screen was already deleted by React, there is no sense in sending progress
+  // since on JS side the component is already not present
+  if (!static_cast<RNSScreenView *>(self.view).isInvalidated) {
     [(RNSScreenView *)self.view notifyTransitionProgress:progress closing:closing goingForward:goingForward];
   }
 }
@@ -1907,11 +1914,9 @@ Class<RCTComponentViewProtocol> RNSScreenCls(void)
   return (int)[[self.screenView.reactSuperview reactSubviews] indexOfObject:view];
 }
 
-// Since the view of the controller can be a snapshot of type `UIView`,
-// when we want to check props of ScreenView, we need to get them from _initialView
 - (RNSScreenView *)screenView
 {
-  return _initialView;
+  return static_cast<RNSScreenView *>(self.view);
 }
 
 - (void)hideHeaderIfNecessary
@@ -1984,6 +1989,19 @@ Class<RCTComponentViewProtocol> RNSScreenCls(void)
     }
   }
 
+  // If flag is enabled, we're doing same evaluation as `[self supportedInterfaceOrientations]`
+  // but we fall back to `RNSOrientationInherit` if orientation is not set in order not to
+  // override parent's orientation. For more details see:
+  // https://github.com/software-mansion/react-native-screens/pull/4408
+  if (self.screenView.iosOrientationInheritanceFixEnabled) {
+    UIViewController *orientationVC = [self findChildVCForConfigAndTrait:RNSWindowTraitOrientation includingModals:YES];
+    if ([orientationVC isKindOfClass:[RNSScreen class]]) {
+      return rnscreens::conversion::RNSOrientationFromUIInterfaceOrientationMask(
+          ((RNSScreen *)orientationVC).screenView.screenOrientation);
+    }
+    return RNSOrientationInherit;
+  }
+
   return rnscreens::conversion::RNSOrientationFromUIInterfaceOrientationMask([self supportedInterfaceOrientations]);
 }
 
@@ -1991,18 +2009,22 @@ Class<RCTComponentViewProtocol> RNSScreenCls(void)
 
 #pragma mark - Fabric specific
 
-- (void)setViewToSnapshot
+- (void)addSnapshotToView
 {
-  UIView *superView = self.view.superview;
   // if we dismissed the view natively, it will already be detached from view hierarchy
-  if (self.view.window != nil) {
-    auto afterUpdates = self.screenView.snapshotAfterUpdates;
-    UIView *snapshot = [self.view snapshotViewAfterScreenUpdates:afterUpdates];
-    snapshot.frame = self.view.frame;
-    [self.view removeFromSuperview];
-    self.view = snapshot;
-    [superView addSubview:snapshot];
+  if (self.view.window == nil) {
+    return;
   }
+
+  // The snapshot is added inside the screen view instead of replacing it, so `self.view` remains
+  // the view UIKit captured for the ongoing transition and is torn down (with the snapshot)
+  // consistently. Replacing the view mid-transition made iOS 26 teardown re-insert the original
+  // view into the hierarchy and remove only the snapshot, leaving a view that blocked all touches.
+  UIView *snapshot = [self.view snapshotViewAfterScreenUpdates:self.screenView.snapshotAfterUpdates];
+  snapshot.frame = self.view.bounds;
+  // fill the whole screen view with the snapshot
+  snapshot.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+  [self.view addSubview:snapshot];
 }
 
 @end

package/ios/legacy/RNSScreenContentWrapper.mm

@@ -16,6 +16,15 @@ namespace react = facebook::react;
 
 @implementation RNSScreenContentWrapper
 
+- (instancetype)initWithFrame:(CGRect)frame
+{
+  if (self = [super initWithFrame:frame]) {
+    static const auto defaultProps = std::make_shared<const react::RNSScreenContentWrapperProps>();
+    _props = defaultProps;
+  }
+  return self;
+}
+
 - (void)notifyDelegateWithFrame:(CGRect)frame
 {
   [self.delegate contentWrapper:self receivedReactFrame:frame];

package/ios/legacy/RNSScreenFooter.mm

@@ -12,6 +12,8 @@
 - (instancetype)init
 {
   if (self = [super init]) {
+    static const auto defaultProps = std::make_shared<const facebook::react::RNSScreenFooterProps>();
+    _props = defaultProps;
     self.translatesAutoresizingMaskIntoConstraints = false;
     _parent = nil;
   }

package/ios/legacy/RNSScreenStack.mm

@@ -244,8 +244,10 @@ namespace react = facebook::react;
       willShowViewController:(UIViewController *)viewController
                     animated:(BOOL)animated
 {
-  if (![viewController.view isKindOfClass:[RNSScreenView class]]) {
-    // if the current view is a snapshot, config was already removed so we don't trigger the method
+  if (![viewController.view isKindOfClass:[RNSScreenView class]] ||
+      static_cast<RNSScreenView *>(viewController.view).isInvalidated) {
+    // if the screen was already deleted by React, its config was already removed
+    // so we don't trigger the method
     return;
   }
   auto *screenView = static_cast<RNSScreenView *>(viewController.view);
@@ -1313,7 +1315,7 @@ RNS_IGNORE_SUPER_CALL_END
 - (void)unmountChildComponentView:(UIView<RCTComponentViewProtocol> *)childComponentView index:(NSInteger)index
 {
   RNSScreenView *screenChildComponent = (RNSScreenView *)childComponentView;
-  [screenChildComponent.controller setViewToSnapshot];
+  [screenChildComponent.controller addSnapshotToView];
 
   RCTAssert(screenChildComponent.reactSuperview == self,
             @"Attempt to unmount a view which is mounted inside different view. (parent: %@, child: %@, index: %@)",
@@ -1330,7 +1332,10 @@ RNS_IGNORE_SUPER_CALL_END
       @([[_reactSubviews objectAtIndex:index] tag]));
   screenChildComponent.reactSuperview = nil;
   [_reactSubviews removeObject:screenChildComponent];
-  [screenChildComponent removeFromSuperview];
+
+  if (screenChildComponent.window == nil) {
+    [screenChildComponent removeFromSuperview];
+  }
 }
 
 - (void)mountingTransactionWillMount:(const facebook::react::MountingTransaction &)transaction

package/ios/modals/form-sheet/RNSFormSheetContentWrapperComponentView.mm

@@ -7,6 +7,15 @@ namespace react = facebook::react;
 
 @implementation RNSFormSheetContentWrapperComponentView
 
+- (instancetype)initWithFrame:(CGRect)frame
+{
+  if (self = [super initWithFrame:frame]) {
+    static const auto defaultProps = std::make_shared<const react::RNSFormSheetContentWrapperProps>();
+    _props = defaultProps;
+  }
+  return self;
+}
+
 #pragma mark - RCTComponentViewProtocol
 
 + (react::ComponentDescriptorProvider)componentDescriptorProvider

package/ios/scroll-to-top-guard/RNSScrollToTopGuard.h

@@ -0,0 +1,17 @@
+#pragma once
+
+#import "RNSReactBaseView.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Backing native view for the experimental, iOS-only `ScrollToTopGuard` component. It wraps its
+ * children and attaches an `RNSScrollToTopGuardGestureRecognizer` to itself on OS versions where
+ * the system "scroll to top" navigation-bar interaction exists (iPadOS 26+, iPhone iOS 27+), so
+ * that tapping the wrapped content does not scroll the underlying scroll view to top.
+ */
+@interface RNSScrollToTopGuard : RNSReactBaseView
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/scroll-to-top-guard/RNSScrollToTopGuard.mm

@@ -0,0 +1,57 @@
+#import "RNSScrollToTopGuard.h"
+#import <react/renderer/components/rnscreens/ComponentDescriptors.h>
+#import <react/renderer/components/rnscreens/EventEmitters.h>
+#import <react/renderer/components/rnscreens/Props.h>
+#import <react/renderer/components/rnscreens/RCTComponentViewHelpers.h>
+#import "RNSDefines.h"
+#import "RNSScrollToTopGuardGestureRecognizer.h"
+
+namespace react = facebook::react;
+
+@implementation RNSScrollToTopGuard
+
+- (instancetype)initWithFrame:(CGRect)frame
+{
+  if (self = [super initWithFrame:frame]) {
+    [self initState];
+  }
+  return self;
+}
+
+- (void)initState
+{
+  static const auto defaultProps = std::make_shared<const react::RNSScrollToTopGuardProps>();
+  _props = defaultProps;
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+  // Attach the guard once on mount, only on OS versions where the system scroll-to-top
+  // interaction exists. On other versions this view is a plain passthrough.
+  if ([RNSScrollToTopGuardGestureRecognizer shouldGuardScrollToTop]) {
+    [RNSScrollToTopGuardGestureRecognizer applyToView:self];
+  }
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+}
+
++ (react::ComponentDescriptorProvider)componentDescriptorProvider
+{
+  return react::concreteComponentDescriptorProvider<react::RNSScrollToTopGuardComponentDescriptor>();
+}
+
+#pragma mark - Dynamic frameworks support
+
+// Needed because of this: https://github.com/facebook/react-native/pull/37274
+#ifdef RCT_DYNAMIC_FRAMEWORKS
++ (void)load
+{
+  [super load];
+}
+#endif // RCT_DYNAMIC_FRAMEWORKS
+
+@end
+
+#pragma mark - View class exposure
+
+Class<RCTComponentViewProtocol> RNSScrollToTopGuardCls(void)
+{
+  return RNSScrollToTopGuard.class;
+}

package/ios/scroll-to-top-guard/RNSScrollToTopGuardGestureRecognizer.h

@@ -0,0 +1,28 @@
+#pragma once
+
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * This gesture recognizer is necessary to handle views placed in the navigation bar area on OS
+ * versions where the system triggers "scroll to top" by tapping that area (iPadOS 26+ and iPhone
+ * iOS 27+). Otherwise, tapping such a view results in a scroll to top action even if there is a
+ * pressable inside it.
+ */
+@interface RNSScrollToTopGuardGestureRecognizer : UITapGestureRecognizer <UIGestureRecognizerDelegate>
+
+/**
+ * Returns YES on OS versions / device idioms where the system scroll-to-top-on-header interaction
+ * exists (iPad: iOS 26+, iPhone: iOS 27+); NO otherwise.
+ */
++ (BOOL)shouldGuardScrollToTop;
+
+/**
+ * Creates the scroll to top guard gesture recognizer and adds it to the given view.
+ */
++ (void)applyToView:(UIView *)view;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/scroll-to-top-guard/RNSScrollToTopGuardGestureRecognizer.mm

@@ -0,0 +1,64 @@
+#import "RNSScrollToTopGuardGestureRecognizer.h"
+#import "RNSDefines.h"
+
+@implementation RNSScrollToTopGuardGestureRecognizer
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+
+- (instancetype)init
+{
+  if (self = [super initWithTarget:self action:nil]) {
+    self.cancelsTouchesInView = NO;
+    self.delegate = self;
+  }
+  return self;
+}
+
+#pragma mark - UIGestureRecognizerDelegate
+
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
+    shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer
+{
+  return YES;
+}
+
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
+    shouldBeRequiredToFailByGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer
+{
+  // We want to target tap gesture recognizers only (one responsible for scroll to top must be one).
+  if (![otherGestureRecognizer isKindOfClass:[UITapGestureRecognizer class]]) {
+    return NO;
+  }
+
+  // We don't know the exact recognizer responsible for scroll to top so we block all
+  // gesture recognizers above us.
+  return ![otherGestureRecognizer.view isDescendantOfView:gestureRecognizer.view];
+}
+
+#pragma mark - Class methods
+
++ (BOOL)shouldGuardScrollToTop
+{
+  // The system scroll-to-top-on-header interaction has been present on iPadOS since iOS 26...
+  if (@available(iOS 26.0, *)) {
+    if (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad) {
+      return YES;
+    }
+  }
+  // ...and was extended to iPhone in iOS 27.
+  if (@available(iOS 27.0, *)) {
+    if (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPhone) {
+      return YES;
+    }
+  }
+  return NO;
+}
+
++ (void)applyToView:(nonnull UIView *)view
+{
+  [view addGestureRecognizer:[RNSScrollToTopGuardGestureRecognizer new]];
+}
+
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+
+@end

package/ios/split/RNSSplitAppearanceApplicator.h

@@ -0,0 +1,36 @@
+#pragma once
+
+#import <Foundation/Foundation.h>
+#import "RNSSplitAppearanceCoordinator.h"
+
+@class RNSSplitHostComponentView;
+@class RNSSplitHostController;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * @brief - Class responsible for applying all upcoming updates to SplitView.
+ *
+ * This class is synchronizing UISplitViewController configuration props which are affecting the SplitView appearance
+ * with props passed to RNSSplitHostComponentView from the ElementTree.
+ */
+@interface RNSSplitAppearanceApplicator : NSObject
+
+/**
+ * @brief Function responsible for applying all updates to SplitView in correct order
+ *
+ * It requests calling proper callbacks with batched SplitView updates on the AppearanceCoordinator object
+ *
+ * @param splitHost The view representing JS component which is sending updates.
+ * @param splitHostController The controller associated with the SplitView component which receives updates and
+ * manages the native layer.
+ * @param appearanceCoordinator The coordinator which is checking whether the update needs to be applied and if so, it
+ * executes the callback passed by this class.
+ */
+- (void)updateAppearanceIfNeeded:(RNSSplitHostComponentView *)splitHost
+             splitHostController:(RNSSplitHostController *)splitHostController
+           appearanceCoordinator:(RNSSplitAppearanceCoordinator *)appearanceCoordinator;
+
+@end
+
+NS_ASSUME_NONNULL_END