@amazon-devices/react-native-screens 2.0.1758683737 → 3.0.9000000000

package/ios/RNSScreenStackHeaderSubview.h

@@ -20,13 +20,6 @@ NS_ASSUME_NONNULL_BEGIN
 
 @property (nonatomic, weak) UIView *reactSuperview;
 
-@property (nonatomic, weak) RCTBridge *bridge;
-
-#ifdef RCT_NEW_ARCH_ENABLED
-#else
-- (instancetype)initWithBridge:(RCTBridge *)bridge;
-#endif // RCT_NEW_ARCH_ENABLED
-
 @end
 
 @interface RNSScreenStackHeaderSubviewManager : RCTViewManager

package/ios/RNSScreenStackHeaderSubview.mm

@@ -1,5 +1,7 @@
 #import "RNSScreenStackHeaderSubview.h"
 #import "RNSConvert.h"
+#import "RNSDefines.h"
+#import "RNSScreenStackHeaderConfig.h"
 
 #ifdef RCT_NEW_ARCH_ENABLED
 #import <react/renderer/components/rnscreens/ComponentDescriptors.h>
@@ -8,24 +10,65 @@
 
 #import <React/RCTConversions.h>
 #import <React/RCTFabricComponentsPlugins.h>
+
+#import <rnscreens/RNSScreenStackHeaderSubviewComponentDescriptor.h>
 #endif // RCT_NEW_ARCH_ENABLED
 
 #ifdef RCT_NEW_ARCH_ENABLED
 namespace react = facebook::react;
 #endif // RCT_NEW_ARCH_ENABLED
 
-@interface RCTBridge (Private)
-+ (RCTBridge *)currentBridge;
-@end
-
 @implementation RNSScreenStackHeaderSubview
 
 #pragma mark - Common
 
+- (nullable RNSScreenStackHeaderConfig *)getHeaderConfig
+{
+  RNSScreenStackHeaderConfig *headerConfig = (RNSScreenStackHeaderConfig *_Nullable)self.reactSuperview;
+#ifndef NDEBUG
+  if (headerConfig != nil && ![headerConfig isKindOfClass:[RNSScreenStackHeaderConfig class]]) {
+    RCTLogError(@"[RNScreens] Invalid view type, expecting RNSScreenStackHeaderConfig, got: %@", headerConfig);
+    return nil;
+  }
+#endif
+  return headerConfig;
+}
+
+// We're forcing the navigation controller's view to re-layout
+// see: https://github.com/software-mansion/react-native-screens/pull/2385
+- (void)layoutNavigationBar
+{
+  // If we're not attached yet, we should not layout the navigation bar,
+  // because the layout flow won't reach us & we will clear "isLayoutDirty" flags
+  // on view above us, causing subsequent layout request to not reach us.
+  if (self.window == nil) {
+    return;
+  }
+
+  RNSScreenStackHeaderConfig *headerConfig = [self getHeaderConfig];
+  UINavigationController *navctr = headerConfig.screenView.reactViewController.navigationController;
+
+  UIView *toLayoutView = navctr.navigationBar;
+
+  // TODO: It is possible, that this needs to be called only on old architecture.
+  // Make sure that Test432 keeps working.
+  [toLayoutView setNeedsLayout];
+
+  // TODO: Determine why this must be called & deferring layout to next "update cycle"
+  // is not sufficient. See Test2552 and Test432. (Talking Paper here).
+  [toLayoutView layoutIfNeeded];
+}
+
 #ifdef RCT_NEW_ARCH_ENABLED
 
 #pragma mark - Fabric specific
 
+// Needed because of this: https://github.com/facebook/react-native/pull/37274
++ (void)load
+{
+  [super load];
+}
+
 - (instancetype)initWithFrame:(CGRect)frame
 {
   if (self = [super initWithFrame:frame]) {
@@ -56,6 +99,8 @@ namespace react = facebook::react;
   return react::concreteComponentDescriptorProvider<react::RNSScreenStackHeaderSubviewComponentDescriptor>();
 }
 
+RNS_IGNORE_SUPER_CALL_BEGIN
+// System layouts the subviews.
 - (void)updateLayoutMetrics:(const react::LayoutMetrics &)layoutMetrics
            oldLayoutMetrics:(const react::LayoutMetrics &)oldLayoutMetrics
 {
@@ -72,37 +117,29 @@ namespace react = facebook::react;
         self);
   } else {
     self.bounds = CGRect{CGPointZero, frame.size};
+    [self layoutNavigationBar];
   }
 }
+RNS_IGNORE_SUPER_CALL_BEGIN
 
-#else
-#pragma mark - Paper specific
-
-- (instancetype)initWithBridge:(RCTBridge *)bridge
++ (BOOL)shouldBeRecycled
 {
-  if (self = [super init]) {
-    _bridge = bridge;
-  }
-  return self;
+  return NO;
 }
 
+#else // RCT_NEW_ARCH_ENABLED
+#pragma mark - Paper specific
+
 - (void)reactSetFrame:(CGRect)frame
 {
   // Block any attempt to set coordinates on RNSScreenStackHeaderSubview. This
   // makes UINavigationBar the only one to control the position of header content.
-  [super reactSetFrame:CGRectMake(0, 0, frame.size.width, frame.size.height)];
+  if (!CGSizeEqualToSize(frame.size, self.frame.size)) {
+    [super reactSetFrame:CGRectMake(0, 0, frame.size.width, frame.size.height)];
+    [self layoutNavigationBar];
+  }
 }
-
-#endif // RCT_NEW_ARCH_ENABLED
-
-- (RCTBridge *)bridge
-{
-#ifdef RCT_NEW_ARCH_ENABLED
-  return [RCTBridge currentBridge];
-#else
-  return _bridge;
 #endif // RCT_NEW_ARCH_ENABLED
-}
 
 @end
 
@@ -116,7 +153,7 @@ RCT_EXPORT_VIEW_PROPERTY(type, RNSScreenStackHeaderSubviewType)
 #else
 - (UIView *)view
 {
-  return [[RNSScreenStackHeaderSubview alloc] initWithBridge:self.bridge];
+  return [RNSScreenStackHeaderSubview new];
 }
 #endif
 

package/ios/RNSScreenWindowTraits.h

@@ -4,7 +4,7 @@
 
 + (void)updateWindowTraits;
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_VISION
 + (void)assertViewControllerBasedStatusBarAppearenceSet;
 #endif
 + (void)updateStatusBarAppearance;

package/ios/RNSScreenWindowTraits.mm

@@ -4,7 +4,7 @@
 
 @implementation RNSScreenWindowTraits
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_VISION
 + (void)assertViewControllerBasedStatusBarAppearenceSet
 {
   static dispatch_once_t once;
@@ -22,21 +22,10 @@
 
 + (void)updateStatusBarAppearance
 {
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_VISION
   [UIView animateWithDuration:0.4
                    animations:^{ // duration based on "Programming iOS 13" p. 311 implementation
-#if defined(__IPHONE_OS_VERSION_MAX_ALLOWED) && defined(__IPHONE_13_0) && \
-    __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_13_0
-                     if (@available(iOS 13, *)) {
-                       UIWindow *firstWindow = [[[UIApplication sharedApplication] windows] firstObject];
-                       if (firstWindow != nil) {
-                         [[firstWindow rootViewController] setNeedsStatusBarAppearanceUpdate];
-                       }
-                     } else
-#endif
-                     {
-                       [UIApplication.sharedApplication.keyWindow.rootViewController setNeedsStatusBarAppearanceUpdate];
-                     }
+                     [RCTKeyWindow().rootViewController setNeedsStatusBarAppearanceUpdate];
                    }];
 #endif
 }
@@ -44,21 +33,7 @@
 + (void)updateHomeIndicatorAutoHidden
 {
 #if !TARGET_OS_TV
-
-#if defined(__IPHONE_OS_VERSION_MAX_ALLOWED) && defined(__IPHONE_13_0) && \
-    __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_13_0
-  if (@available(iOS 13, *)) {
-    UIWindow *firstWindow = [[[UIApplication sharedApplication] windows] firstObject];
-    if (firstWindow != nil) {
-      [[firstWindow rootViewController] setNeedsUpdateOfHomeIndicatorAutoHidden];
-    }
-  } else
-#endif
-  {
-    if (@available(iOS 11.0, *)) {
-      [UIApplication.sharedApplication.keyWindow.rootViewController setNeedsUpdateOfHomeIndicatorAutoHidden];
-    }
-  }
+  [RCTKeyWindow().rootViewController setNeedsUpdateOfHomeIndicatorAutoHidden];
 #endif
 }
 
@@ -134,21 +109,10 @@
 
 + (void)enforceDesiredDeviceOrientation
 {
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_VISION
   dispatch_async(dispatch_get_main_queue(), ^{
-    UIInterfaceOrientationMask orientationMask = UIInterfaceOrientationMaskAllButUpsideDown;
-#if defined(__IPHONE_OS_VERSION_MAX_ALLOWED) && defined(__IPHONE_13_0) && \
-    __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_13_0
-    if (@available(iOS 13, *)) {
-      UIWindow *firstWindow = [[[UIApplication sharedApplication] windows] firstObject];
-      if (firstWindow != nil) {
-        orientationMask = [firstWindow rootViewController].supportedInterfaceOrientations;
-      }
-    } else
-#endif
-    {
-      orientationMask = UIApplication.sharedApplication.keyWindow.rootViewController.supportedInterfaceOrientations;
-    }
+    UIInterfaceOrientationMask orientationMask = [RCTKeyWindow().rootViewController supportedInterfaceOrientations];
+
     UIInterfaceOrientation currentDeviceOrientation =
         [RNSScreenWindowTraits interfaceOrientationFromDeviceOrientation:[[UIDevice currentDevice] orientation]];
     UIInterfaceOrientation currentInterfaceOrientation = [RNSScreenWindowTraits interfaceOrientation];
@@ -178,7 +142,21 @@
     __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_16_0
       if (@available(iOS 16.0, *)) {
         NSArray *array = [[[UIApplication sharedApplication] connectedScenes] allObjects];
-        UIWindowScene *scene = (UIWindowScene *)array[0];
+
+        // when an app supports multiple scenes (e.g. CarPlay), it is possible that
+        // UIWindowScene is not the first scene, or it may not be present at all
+        UIWindowScene *scene = nil;
+        for (id connectedScene in array) {
+          if ([connectedScene isKindOfClass:[UIWindowScene class]]) {
+            scene = connectedScene;
+            break;
+          }
+        }
+
+        if (scene == nil) {
+          return;
+        }
+
         UIWindowSceneGeometryPreferencesIOS *geometryPreferences =
             [[UIWindowSceneGeometryPreferencesIOS alloc] initWithInterfaceOrientations:orientationMask];
         [scene requestGeometryUpdateWithPreferences:geometryPreferences
@@ -211,7 +189,7 @@
   [RNSScreenWindowTraits updateHomeIndicatorAutoHidden];
 }
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_VISION
 // based on
 // https://stackoverflow.com/questions/57965701/statusbarorientation-was-deprecated-in-ios-13-0-when-attempting-to-get-app-ori/61249908#61249908
 + (UIInterfaceOrientation)interfaceOrientation
@@ -219,11 +197,7 @@
 #if defined(__IPHONE_OS_VERSION_MAX_ALLOWED) && defined(__IPHONE_13_0) && \
     __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_13_0
   if (@available(iOS 13.0, *)) {
-    UIWindow *firstWindow = [[[UIApplication sharedApplication] windows] firstObject];
-    if (firstWindow == nil) {
-      return UIInterfaceOrientationUnknown;
-    }
-    UIWindowScene *windowScene = firstWindow.windowScene;
+    UIWindowScene *windowScene = RCTKeyWindow().windowScene;
     if (windowScene == nil) {
       return UIInterfaceOrientationUnknown;
     }

package/ios/RNSSearchBar.h

@@ -29,11 +29,11 @@
 
 #ifdef RCT_NEW_ARCH_ENABLED
 #else
-@property (nonatomic, copy) RCTBubblingEventBlock onChangeText;
-@property (nonatomic, copy) RCTBubblingEventBlock onCancelButtonPress;
-@property (nonatomic, copy) RCTBubblingEventBlock onSearchButtonPress;
-@property (nonatomic, copy) RCTBubblingEventBlock onFocus;
-@property (nonatomic, copy) RCTBubblingEventBlock onBlur;
+@property (nonatomic, copy) RCTDirectEventBlock onChangeText;
+@property (nonatomic, copy) RCTDirectEventBlock onCancelButtonPress;
+@property (nonatomic, copy) RCTDirectEventBlock onSearchButtonPress;
+@property (nonatomic, copy) RCTDirectEventBlock onSearchFocus;
+@property (nonatomic, copy) RCTDirectEventBlock onSearchBlur;
 #endif
 
 @end

package/ios/RNSSearchBar.mm

@@ -37,6 +37,13 @@ namespace react = facebook::react;
 }
 
 #ifdef RCT_NEW_ARCH_ENABLED
+
+// Needed because of this: https://github.com/facebook/react-native/pull/37274
++ (void)load
+{
+  [super load];
+}
+
 - (instancetype)init
 {
   if (self = [super init]) {
@@ -50,7 +57,13 @@ namespace react = facebook::react;
 
 - (void)initCommonProps
 {
+#if !TARGET_OS_TV
   _controller = [[UISearchController alloc] initWithSearchResultsController:nil];
+#else
+  // on TVOS UISearchController must contain searchResultsController.
+  _controller = [[UISearchController alloc] initWithSearchResultsController:[UIViewController new]];
+#endif
+
   _controller.searchBar.delegate = self;
   _hideWhenScrolling = YES;
   _placement = RNSSearchBarPlacementStacked;
@@ -61,11 +74,11 @@ namespace react = facebook::react;
 #ifdef RCT_NEW_ARCH_ENABLED
   if (_eventEmitter != nullptr) {
     std::dynamic_pointer_cast<const react::RNSSearchBarEventEmitter>(_eventEmitter)
-        ->onFocus(react::RNSSearchBarEventEmitter::OnFocus{});
+        ->onSearchFocus(react::RNSSearchBarEventEmitter::OnSearchFocus{});
   }
 #else
-  if (self.onFocus) {
-    self.onFocus(@{});
+  if (self.onSearchFocus) {
+    self.onSearchFocus(@{});
   }
 #endif
 }
@@ -75,11 +88,11 @@ namespace react = facebook::react;
 #ifdef RCT_NEW_ARCH_ENABLED
   if (_eventEmitter != nullptr) {
     std::dynamic_pointer_cast<const react::RNSSearchBarEventEmitter>(_eventEmitter)
-        ->onBlur(react::RNSSearchBarEventEmitter::OnBlur{});
+        ->onSearchBlur(react::RNSSearchBarEventEmitter::OnSearchBlur{});
   }
 #else
-  if (self.onBlur) {
-    self.onBlur(@{});
+  if (self.onSearchBlur) {
+    self.onSearchBlur(@{});
   }
 #endif
 }
@@ -304,6 +317,14 @@ namespace react = facebook::react;
   [_controller.searchBar setText:text];
 }
 
+- (void)cancelSearch
+{
+#if !TARGET_OS_TV
+  [self searchBarCancelButtonClicked:_controller.searchBar];
+  _controller.active = NO;
+#endif
+}
+
 #pragma mark-- Fabric specific
 
 #ifdef RCT_NEW_ARCH_ENABLED
@@ -330,9 +351,11 @@ namespace react = facebook::react;
     [self setPlaceholder:RCTNSStringFromStringNilIfEmpty(newScreenProps.placeholder)];
   }
 
+#if !TARGET_OS_VISION
   if (oldScreenProps.autoCapitalize != newScreenProps.autoCapitalize) {
     [self setAutoCapitalize:[RNSConvert UITextAutocapitalizationTypeFromCppEquivalent:newScreenProps.autoCapitalize]];
   }
+#endif
 
   if (oldScreenProps.tintColor != newScreenProps.tintColor) {
     [self setTintColor:RCTUIColorFromSharedColor(newScreenProps.tintColor)];
@@ -398,11 +421,11 @@ RCT_EXPORT_VIEW_PROPERTY(textColor, UIColor)
 RCT_EXPORT_VIEW_PROPERTY(cancelButtonText, NSString)
 RCT_EXPORT_VIEW_PROPERTY(placement, RNSSearchBarPlacement)
 
-RCT_EXPORT_VIEW_PROPERTY(onChangeText, RCTBubblingEventBlock)
-RCT_EXPORT_VIEW_PROPERTY(onCancelButtonPress, RCTBubblingEventBlock)
-RCT_EXPORT_VIEW_PROPERTY(onSearchButtonPress, RCTBubblingEventBlock)
-RCT_EXPORT_VIEW_PROPERTY(onFocus, RCTBubblingEventBlock)
-RCT_EXPORT_VIEW_PROPERTY(onBlur, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onChangeText, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onCancelButtonPress, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onSearchButtonPress, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onSearchFocus, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onSearchBlur, RCTDirectEventBlock)
 
 #ifndef RCT_NEW_ARCH_ENABLED
 
@@ -446,6 +469,14 @@ RCT_EXPORT_METHOD(setText : (NSNumber *_Nonnull)reactTag text : (NSString *)text
   }];
 }
 
+RCT_EXPORT_METHOD(cancelSearch : (NSNumber *_Nonnull)reactTag)
+{
+  [self.bridge.uiManager addUIBlock:^(__unused RCTUIManager *uiManager, NSDictionary *viewRegistry) {
+    RNSSearchBar *searchBar = viewRegistry[reactTag];
+    [searchBar cancelSearch];
+  }];
+}
+
 #endif /* !RCT_NEW_ARCH_ENABLED */
 
 @end

package/ios/events/RNSHeaderHeightChangeEvent.h

@@ -1,4 +1,3 @@
-#import <React/RCTBridge+Private.h>
 #import <React/RCTEventDispatcherProtocol.h>
 
 @interface RNSHeaderHeightChangeEvent : NSObject <RCTEvent>

package/ios/events/RNSHeaderHeightChangeEvent.mm

@@ -31,6 +31,21 @@ RCT_NOT_IMPLEMENTED(-(instancetype)init)
   return body;
 }
 
+- (BOOL)canCoalesce
+{
+  return YES;
+}
+
+- (uint16_t)coalescingKey
+{
+  return _headerHeight;
+}
+
+- (id<RCTEvent>)coalesceWithEvent:(id<RCTEvent>)newEvent
+{
+  return newEvent;
+}
+
 + (NSString *)moduleDotMethod
 {
   return @"RCTEventEmitter.receiveEvent";

package/ios/events/RNSScreenViewEvent.h

@@ -1,4 +1,3 @@
-#import <React/RCTBridge+Private.h>
 #import <React/RCTEventDispatcherProtocol.h>
 
 @interface RNSScreenViewEvent : NSObject <RCTEvent>

package/ios/utils/RCTSurfaceTouchHandler+RNSUtility.h

@@ -0,0 +1,15 @@
+#ifdef RCT_NEW_ARCH_ENABLED
+
+#import <React/RCTSurfaceTouchHandler.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface RCTSurfaceTouchHandler (RNSUtility)
+
+- (void)rnscreens_cancelTouches;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif // RCT_NEW_ARCH_ENABLED

package/ios/utils/RCTSurfaceTouchHandler+RNSUtility.mm

@@ -0,0 +1,14 @@
+#ifdef RCT_NEW_ARCH_ENABLED
+#import "RCTSurfaceTouchHandler+RNSUtility.h"
+
+@implementation RCTSurfaceTouchHandler (RNSUtility)
+
+- (void)rnscreens_cancelTouches
+{
+  [self setEnabled:NO];
+  [self setEnabled:YES];
+  [self reset];
+}
+
+@end
+#endif // RCT_NEW_ARCH_ENABLED

package/ios/utils/RCTTouchHandler+RNSUtility.h

@@ -0,0 +1,15 @@
+#ifndef RCT_NEW_ARCH_ENABLED
+
+#import <React/RCTTouchHandler.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface RCTTouchHandler (RNSUtility)
+
+- (void)rnscreens_cancelTouches;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif // !RCT_NEW_ARCH_ENABLED

package/ios/utils/RCTTouchHandler+RNSUtility.mm

@@ -0,0 +1,15 @@
+#ifndef RCT_NEW_ARCH_ENABLED
+#import "RCTTouchHandler+RNSUtility.h"
+
+@implementation RCTTouchHandler (RNSUtility)
+
+- (void)rnscreens_cancelTouches
+{
+  [self setEnabled:NO];
+  [self setEnabled:YES];
+  [self reset];
+}
+
+@end
+
+#endif // !RCT_NEW_ARCH_ENABLED

package/ios/utils/RNSDefines.h

@@ -0,0 +1,7 @@
+#pragma once
+
+#define RNS_IGNORE_SUPER_CALL_BEGIN \
+  _Pragma("clang diagnostic push")  \
+      _Pragma("clang diagnostic ignored \"-Wobjc-missing-super-calls\"")
+
+#define RNS_IGNORE_SUPER_CALL_END _Pragma("clang diagnostic pop")

package/ios/utils/RNSUIBarButtonItem.h

@@ -1,3 +1,5 @@
+#import <UIKit/UIKit.h>
+
 @interface RNSUIBarButtonItem : UIBarButtonItem
 
 @property (nonatomic) BOOL menuHidden;

package/ios/utils/UINavigationBar+RNSUtility.h

@@ -0,0 +1,37 @@
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface UINavigationBar (RNSUtility)
+
+/**
+ * Aims to find main content view of the `UINavigationBar`.
+ *
+ * This method relies on internal iOS implementation details (see the implementation)
+ * and might need patches specific to future iOS versions, in case the view hierarchy inside
+ * the navigation bar changes.
+ *
+ * Tested to work reliably on iOS 18.0, 17.5, 15.5.
+ *
+ * @returns `_UINavigationBarContentView` view mounted directly under the navigation bar itself
+ */
+- (nullable UIView *)rnscreens_findContentView;
+
+/**
+ * Aims to find the back button wrapper view of the `UINavigationBar`. This is the view that contains
+ * the back button itself alongside all the margin / padding used to position the back button by the system.
+ *
+ * This method relies on internal iOS implementation details (see the implementation)
+ * and might need patches specific to future iOS versions, in case the view hierarchy inside
+ * the navigation bar changes.
+ *
+ * Tested to work reliably on iOS 18.0, 17.5, 15.5.
+ *
+ * @returns `_UIButtonBarButton` view, if present and mounted in anticipated place;
+ *                      if the back button is not present, this method returns `nil`.
+ */
+- (nullable UIView *)rnscreens_findBackButtonWrapperView;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/utils/UINavigationBar+RNSUtility.mm

@@ -0,0 +1,44 @@
+#import "UINavigationBar+RNSUtility.h"
+
+@implementation UINavigationBar (RNSUtility)
+
+- (nullable UIView *)rnscreens_findContentView
+{
+  // Class names taken from iOS 17.5, tested on iPhone 15 Pro
+  static Class ContentViewClass = NSClassFromString(@"_UINavigationBarContentView");
+
+  // Fast path
+  if (self.subviews.count > 1 && [self.subviews[1] isKindOfClass:ContentViewClass]) {
+    return self.subviews[1];
+  }
+
+  for (UIView *subview in self.subviews) {
+    if ([subview isKindOfClass:ContentViewClass]) {
+      return subview;
+    }
+  }
+
+  return nil;
+}
+
+- (nullable UIView *)rnscreens_findBackButtonWrapperView
+{
+  // Class names taken from iOS 17.5, tested on iPhone 15 Pro
+  static Class BarButtonViewClass = NSClassFromString(@"_UIButtonBarButton");
+
+  UIView *contentView = self.rnscreens_findContentView;
+
+  if (contentView == nil) {
+    return nil;
+  }
+
+  for (UIView *subview in contentView.subviews) {
+    if ([subview isKindOfClass:BarButtonViewClass]) {
+      return subview;
+    }
+  }
+
+  return nil;
+}
+
+@end

package/ios/utils/UIView+RNSUtility.h

@@ -0,0 +1,23 @@
+#import <Foundation/Foundation.h>
+
+#ifdef RCT_NEW_ARCH_ENABLED
+#import <React/RCTSurfaceTouchHandler.h>
+#else
+#import <React/RCTTouchHandler.h>
+#endif // RCT_NEW_ARCH_ENABLED
+
+#ifdef RCT_NEW_ARCH_ENABLED
+#define RNS_TOUCH_HANDLER_ARCH_TYPE RCTSurfaceTouchHandler
+#else
+#define RNS_TOUCH_HANDLER_ARCH_TYPE RCTTouchHandler
+#endif // RCT_NEW_ARCH_ENABLED
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface UIView (RNSUtility)
+
+- (nullable RNS_TOUCH_HANDLER_ARCH_TYPE *)rnscreens_findTouchHandlerInAncestorChain;
+
+@end
+
+NS_ASSUME_NONNULL_END