react-native-screens 5.0.0-alpha.3 → 5.0.0-alpha.4

package/ios/legacy/RNSScreenStackHeaderConfig.h

@@ -3,6 +3,7 @@
 #if defined(__cplusplus)
 #import <React/RCTConvert.h>
 #endif // __cplusplus
+#import "RNSDefines.h"
 #import "RNSReactBaseView.h"
 #import "RNSScreen.h"
 #import "RNSScreenStackHeaderSubview.h"
@@ -58,6 +59,17 @@ NS_ASSUME_NONNULL_END
                       animated:(BOOL)animated
                     withConfig:(nonnull RNSScreenStackHeaderConfig *)config;
 
+/**
+ * Returns `YES` when screens in the legacy stack are always laid out under the navigation bar
+ * (`edgesForExtendedLayout = UIRectEdgeAll`), also when the header is opaque. In that case the content is inset below
+ * an opaque bar by the `SafeAreaView` rendered by `ScreenStackItem` (JS) and the screen's origin in the navigation
+ * controller's view is always 0. Otherwise (iOS < 26, tvOS, visionOS) a screen with a visible, opaque header is laid
+ * out below the bar (`UIRectEdgeAll - UIRectEdgeTop`).
+ *
+ * Keep in sync with `getSafeAreaEdges` in `src/legacy/components/ScreenStackItem.tsx`.
+ */
++ (BOOL)screensExtendUnderOpaqueNavigationBar;
+
 /**
  * Returns true iff subview of given `type` is present.
  *
@@ -99,6 +111,24 @@ NS_ASSUME_NONNULL_END
  */
 - (void)updateHeaderStateInShadowTreeInContextOfNavigationBar:(nullable UINavigationBar *)navBar;
 
+/**
+ * Requests `updateViewControllerIfNeeded` to be called once, after the current
+ * mounting transaction finishes. Use this instead of calling `updateViewControllerIfNeeded`
+ * directly from subviews, so that a single transaction updating several subviews
+ * re-applies the config only once, with all subviews already updated.
+ */
+- (void)setNeedsViewControllerUpdate;
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+/**
+ * Requests layout of all header subviews attached to the view hierarchy. Header subview updates its state in shadow
+ * tree when it is laid out, therefore this method should be called when `navBar` lays out its subviews - the header
+ * subviews are laid out later in the same layout pass, after UIKit has positioned the content of the navigation bar.
+ * When the content of `navBar` is moved out of the bar (bar minimization on iOS 27+) this method does nothing.
+ */
+- (void)setNeedsLayoutForHeaderSubviewsInNavigationBar:(nonnull UINavigationBar *)navBar;
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+
 @end
 
 #pragma mark - Experimental

package/ios/legacy/RNSScreenStackHeaderConfig.mm

@@ -13,8 +13,8 @@
 #import <react/renderer/components/rnscreens/EventEmitters.h>
 #import <react/renderer/components/rnscreens/Props.h>
 #import <react/renderer/components/rnscreens/RCTComponentViewHelpers.h>
-#import <react/utils/ManagedObjectWrapper.h>
 #import <react/renderer/components/rnscreens/legacy/RNSScreenStackHeaderConfigComponentDescriptor.h>
+#import <react/utils/ManagedObjectWrapper.h>
 #import "RCTImageComponentView+RNSScreenStackHeaderConfig.h"
 #import "RNSBackBarButtonItem.h"
 #import "RNSBarButtonItem.h"
@@ -58,6 +58,9 @@ static const NSNumber *const DEFAULT_TITLE_LARGE_FONT_SIZE = @34;
   /// Whether a react subview has been added / removed in current transaction. This flag is reset after each react
   /// transaction via RCTMountingTransactionObserving protocol.
   bool _addedReactSubviewsInCurrentTransaction;
+  /// Whether a react subview requested the config to be re-applied in current transaction.
+  /// Consumed & reset in `mountingTransactionDidMount:withSurfaceTelemetry:`.
+  bool _needsViewControllerUpdateInCurrentTransaction;
   RCTImageLoader *_imageLoader;
 }
 
@@ -69,6 +72,7 @@ static const NSNumber *const DEFAULT_TITLE_LARGE_FONT_SIZE = @34;
     _show = YES;
     _translucent = NO;
     _addedReactSubviewsInCurrentTransaction = false;
+    _needsViewControllerUpdateInCurrentTransaction = false;
     _lastSendState = react::RNSScreenStackHeaderConfigState(react::Size{}, react::EdgeInsets{}, react::Point{});
     [self initProps];
   }
@@ -157,11 +161,18 @@ RNS_IGNORE_SUPER_CALL_END
   }
 }
 
+- (void)setNeedsViewControllerUpdate
+{
+  _needsViewControllerUpdateInCurrentTransaction = true;
+}
+
 - (void)layoutNavigationControllerView
 {
-  // We need to layout navigation controller view after translucent prop changes, because otherwise
-  // frame of RNSScreen will not be changed and screen content will remain the same size.
-  // For more details look at https://github.com/software-mansion/react-native-screens/issues/1158
+  // We need to layout navigation controller view after `translucent` / `hidden` prop changes. Below iOS 26 the frame
+  // of RNSScreen depends on them (`edgesForExtendedLayout`), so without the layout pass the screen content would
+  // remain the same size (https://github.com/software-mansion/react-native-screens/issues/1158). On iOS 26+ the frame
+  // does not change, but the layout pass still refreshes the header layout info in the shadow tree and the safe area
+  // insets consumed by the `SafeAreaView` rendered by `ScreenStackItem`.
   UIViewController *vc = _screenView.controller;
   UINavigationController *navctr = vc.navigationController;
   [navctr.view setNeedsLayout];
@@ -194,17 +205,10 @@ RNS_IGNORE_SUPER_CALL_END
     return;
   }
 
+  // Screen's content offset in shadow tree matches its actual native origin (see `-[RNSScreenView updateBounds]`),
+  // therefore navigation bar's frame in screen's coordinate space can be used directly.
   CGRect navBarFrameInScreenView = [navigationBar convertRect:navigationBar.bounds toView:_screenView];
 
-  // On iOS 26+ in landscape mode there is a bug with `edgesForExtendedLayout` for non-transparent
-  // header. We're applying SAV to fix it but we need to take it into account for HeaderConfig's
-  // origin as well.
-#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
-  if (!_translucent && self.shouldHeaderBeVisible) {
-    navBarFrameInScreenView.origin.y -= _screenView.safeAreaInsets.top;
-  }
-#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
-
   [self updateShadowStateWithSize:navigationBar.frame.size
                        edgeInsets:[self computeEdgeInsetsOfNavigationBar:navigationBar]
                       frameOrigin:navBarFrameInScreenView.origin];
@@ -213,6 +217,24 @@ RNS_IGNORE_SUPER_CALL_END
   }
 }
 
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+- (void)setNeedsLayoutForHeaderSubviewsInNavigationBar:(nonnull UINavigationBar *)navigationBar
+{
+  // During the bar minimization (iOS 27+) UIKit moves the content view of the navigation bar above the bar, on each
+  // frame of the scroll. The header subviews are not visible then, therefore we do not follow their position, to
+  // avoid state update on each frame. When the bar is restored, its content view is back at the origin of the bar.
+  if (CGRectGetMinY(navigationBar.rnscreens_findContentView.frame) < 0) {
+    return;
+  }
+
+  for (RNSScreenStackHeaderSubview *subview in self.reactSubviews) {
+    if (subview.window != nil) {
+      [subview setNeedsLayout];
+    }
+  }
+}
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+
 - (NSDirectionalEdgeInsets)computeEdgeInsetsOfNavigationBar:(nonnull UINavigationBar *)navigationBar
 {
   NSDirectionalEdgeInsets navBarMargins = [navigationBar directionalLayoutMargins];
@@ -353,6 +375,18 @@ RNS_IGNORE_SUPER_CALL_END
   return nil;
 }
 
++ (BOOL)screensExtendUnderOpaqueNavigationBar
+{
+#if TARGET_OS_TV || TARGET_OS_VISION
+  return NO;
+#else // TARGET_OS_TV || TARGET_OS_VISION
+  if (@available(iOS 26.0, *)) {
+    return YES;
+  }
+  return NO;
+#endif // TARGET_OS_TV || TARGET_OS_VISION
+}
+
 + (void)willShowViewController:(UIViewController *)vc
                       animated:(BOOL)animated
                     withConfig:(RNSScreenStackHeaderConfig *)config
@@ -494,12 +528,16 @@ RNS_IGNORE_SUPER_CALL_END
   BOOL wasHidden = navctr.navigationBarHidden;
   BOOL shouldHide = config == nil || !config.shouldHeaderBeVisible;
 
-  if (!shouldHide && !config.translucent) {
-    // when nav bar is not translucent we change edgesForExtendedLayout to avoid system laying out
-    // the screen underneath navigation controllers
+  if (!shouldHide && !config.translucent && ![self screensExtendUnderOpaqueNavigationBar]) {
+    // When nav bar is not translucent we change edgesForExtendedLayout to avoid system laying out
+    // the screen underneath navigation controllers.
     vc.edgesForExtendedLayout = UIRectEdgeAll - UIRectEdgeTop;
   } else {
-    // system default is UIRectEdgeAll
+    // System default is UIRectEdgeAll - the screen is laid out under the navigation bar.
+    // On iOS 26+ this is also the case for an opaque header: UIKit does not reliably lay out the screen right below
+    // the bar when the top edge is excluded (it ignores the bar's origin offset, e.g. in landscape or on iPhone Duo),
+    // so we let the screen extend under the bar and inset the content with the `SafeAreaView` rendered by
+    // `ScreenStackItem`. See https://github.com/software-mansion/react-native-screens-labs/issues/1841
     vc.edgesForExtendedLayout = UIRectEdgeAll;
   }
 
@@ -523,6 +561,16 @@ RNS_IGNORE_SUPER_CALL_END
   }
   navitem.largeTitleDisplayMode =
       config.largeTitle ? UINavigationItemLargeTitleDisplayModeAlways : UINavigationItemLargeTitleDisplayModeNever;
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0)
+  if (@available(iOS 27.0, *)) {
+    // Due to native limitations related to opaque header and minimization behavior, we disable it for opaque headers.
+    UIBarMinimization *minimization = [UIBarMinimization new];
+    minimization.minimizationBehavior =
+        config.translucent ? UIBarMinimizationBehaviorAutomatic : UIBarMinimizationBehaviorNever;
+    navitem.navigationBarMinimization = minimization;
+  }
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(27_0)
 #endif
 
   UINavigationBarAppearance *appearance = [self buildAppearance:vc withConfig:config];
@@ -905,8 +953,13 @@ RNS_IGNORE_SUPER_CALL_END
     if (self.shouldHeaderBeVisible) {
       [self layoutNavigationControllerView];
     }
+  } else if (_needsViewControllerUpdateInCurrentTransaction) {
+    // Subviews (e.g. their `visibilityPriority`) changed in this transaction. Re-apply the config once,
+    // now that all of them have already received their new props.
+    [self updateViewControllerIfNeeded];
   }
   _addedReactSubviewsInCurrentTransaction = false;
+  _needsViewControllerUpdateInCurrentTransaction = false;
 }
 
 - (void)replaceNavigationBarViewsWithSnapshotOfSubview:(RNSScreenStackHeaderSubview *)childComponentView

package/ios/legacy/RNSScreenStackHeaderSubview.mm

@@ -21,6 +21,7 @@ namespace react = facebook::react;
   // The cycle is cleared via `invalidateUIBarButtonItem` method, called by `invalidate` callback.
   UIBarButtonItem *_barButtonItem;
   BOOL _hidesSharedBackground;
+  react::RNSScreenStackHeaderSubviewVisibilityPriority _visibilityPriority;
 }
 
 #pragma mark - Common
@@ -112,6 +113,7 @@ namespace react = facebook::react;
     _props = defaultProps;
     _lastScheduledFrame = CGRectZero;
     _synchronousShadowStateUpdatesEnabled = YES;
+    _visibilityPriority = react::RNSScreenStackHeaderSubviewVisibilityPriority::Standard;
   }
 
   return self;
@@ -125,6 +127,7 @@ namespace react = facebook::react;
 
   [self setType:[RNSConvert RNSScreenStackHeaderSubviewTypeFromCppEquivalent:newHeaderSubviewProps.type]];
   [self setHidesSharedBackground:newHeaderSubviewProps.hidesSharedBackground];
+  [self setVisibilityPriority:newHeaderSubviewProps.visibilityPriority];
   [self setSynchronousShadowStateUpdatesEnabled:newHeaderSubviewProps.synchronousShadowStateUpdatesEnabled];
   [super updateProps:props oldProps:oldProps];
 }
@@ -280,6 +283,17 @@ RNS_IGNORE_SUPER_CALL_END
     }
   }
 #endif // RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+
+// tvOS and visionOS are excluded on purpose: `visibilityPriority` exists there, but the only
+// supported value is `standard`, which is already the default.
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0) && !TARGET_OS_TV && !TARGET_OS_VISION
+  if (@available(iOS 27.0, *)) {
+    if (_barButtonItem != nil) {
+      _barButtonItem.visibilityPriority =
+          [RNSConvert UIBarButtonItemVisibilityPriorityFromCppEquivalent:_visibilityPriority];
+    }
+  }
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(27_0) && !TARGET_OS_TV && !TARGET_OS_VISION
 }
 
 - (void)setHidesSharedBackground:(BOOL)hidesSharedBackground
@@ -288,6 +302,25 @@ RNS_IGNORE_SUPER_CALL_END
   [self configureBarButtonItem];
 }
 
+- (void)setVisibilityPriority:(react::RNSScreenStackHeaderSubviewVisibilityPriority)visibilityPriority
+{
+  if (visibilityPriority == _visibilityPriority) {
+    return;
+  }
+
+  _visibilityPriority = visibilityPriority;
+  [self configureBarButtonItem];
+
+  // Changing the priority of an item that is already in the bar is not enough:
+  // the bar only re-evaluates which items fit when it is handed its items again,
+  // which the header does whenever it re-applies its config. We defer that until
+  // the end of the mounting transaction, so that sibling subviews updated in the
+  // same transaction are taken into account & the config is re-applied only once.
+  if (_barButtonItem != nil) {
+    [[self getHeaderConfig] setNeedsViewControllerUpdate];
+  }
+}
+
 #pragma mark - Dynamic frameworks support
 
 // Needed because of this: https://github.com/facebook/react-native/pull/37274

package/ios/safe-area/RNSSafeAreaViewComponentView.mm

@@ -3,7 +3,6 @@
 
 #import "RNSSafeAreaViewComponentView.h"
 #import <React/RCTConversions.h>
-#import <React/RCTUtils.h>
 #import "RNSSafeAreaProviding.h"
 #import "RNSSafeAreaViewNotifications.h"
 
@@ -14,8 +13,6 @@
 
 namespace react = facebook::react;
 
-static BOOL UIEdgeInsetsEqualToEdgeInsetsWithThreshold(UIEdgeInsets insets1, UIEdgeInsets insets2, CGFloat threshold);
-
 #pragma mark - View implementation
 
 @implementation RNSSafeAreaViewComponentView {
@@ -87,7 +84,7 @@ static BOOL UIEdgeInsetsEqualToEdgeInsetsWithThreshold(UIEdgeInsets insets1, UIE
 
   UIEdgeInsets safeAreaInsets = _providerView.providerSafeAreaInsets;
 
-  if (UIEdgeInsetsEqualToEdgeInsetsWithThreshold(safeAreaInsets, _currentSafeAreaInsets, 1.0 / RCTScreenScale())) {
+  if (UIEdgeInsetsEqualToEdgeInsets(safeAreaInsets, _currentSafeAreaInsets)) {
     return;
   }
 
@@ -152,14 +149,6 @@ static BOOL UIEdgeInsetsEqualToEdgeInsetsWithThreshold(UIEdgeInsets insets1, UIE
 
 @end
 
-#pragma mark - Utility functions
-
-static BOOL UIEdgeInsetsEqualToEdgeInsetsWithThreshold(UIEdgeInsets insets1, UIEdgeInsets insets2, CGFloat threshold)
-{
-  return ABS(insets1.left - insets2.left) <= threshold && ABS(insets1.right - insets2.right) <= threshold &&
-      ABS(insets1.top - insets2.top) <= threshold && ABS(insets1.bottom - insets2.bottom) <= threshold;
-}
-
 #pragma mark - View class exposure
 
 Class<RCTComponentViewProtocol> RNSSafeAreaView(void)

package/ios/stack/conversion/RNSConversions-Stack.h

@@ -3,8 +3,10 @@
 #if defined(__cplusplus)
 
 #import <react/renderer/components/rnscreens/Props.h>
+#import "RNSDefines.h"
 #import "RNSHeaderItemPlacement.h"
 #import "RNSHeaderItemSpacerPlacement.h"
+#import "RNSHeaderItemVisibilityPriority.h"
 #import "RNSStackScreenComponentView.h"
 
 namespace rnscreens::conversion {
@@ -23,10 +25,38 @@ RNSHeaderItemSpacerPlacement
 RNSHeaderItemSpacerPlacementFromReactRNSStackHeaderItemSpacerIOSPlacement(
     react::RNSStackHeaderItemSpacerIOSPlacement placement);
 
+UIBarButtonItemStyle UIBarButtonItemStyleFromReactRNSStackHeaderItemIOSVariant(
+    react::RNSStackHeaderItemIOSVariant variant);
+
 UINavigationItemBackButtonDisplayMode
 UINavigationItemBackButtonDisplayModeFromReactRNSStackHeaderConfigIOSBackButtonDisplayMode(
     react::RNSStackHeaderConfigIOSBackButtonDisplayMode displayMode);
 
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0)
+
+API_AVAILABLE(ios(27.0))
+UIBarMinimizationBehavior
+UIBarMinimizationBehaviorFromReactRNSStackHeaderConfigIOSMinimizationBehavior(
+    react::RNSStackHeaderConfigIOSMinimizationBehavior minimizationBehavior);
+
+API_AVAILABLE(ios(27.0))
+UIBarMinimizationRestorationBehavior
+UIBarMinimizationRestorationBehaviorFromReactRNSStackHeaderConfigIOSRestorationBehavior(
+    react::RNSStackHeaderConfigIOSRestorationBehavior restorationBehavior);
+
+#endif // Check for iOS >= 27
+  
+RNSHeaderItemVisibilityPriority
+RNSHeaderItemVisibilityPriorityFromReactRNSStackHeaderItemIOSVisibilityPriority(
+    react::RNSStackHeaderItemIOSVisibilityPriority visibilityPriority);
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0) && !TARGET_OS_TV && !TARGET_OS_VISION
+API_AVAILABLE(ios(27.0))
+UIBarButtonItemVisibilityPriority
+UIBarButtonItemVisibilityPriorityFromRNSHeaderItemVisibilityPriority(
+    RNSHeaderItemVisibilityPriority visibilityPriority);
+#endif // Check for iOS >= 27 && !TARGET_OS_TV && !TARGET_OS_VISION
+
 }; // namespace rnscreens::conversion
 
 #endif // defined(__cplusplus)

package/ios/stack/conversion/RNSConversions-Stack.mm

@@ -1,4 +1,5 @@
 #import "RNSConversions-Stack.h"
+#import "RNSDefines.h"
 
 namespace rnscreens::conversion {
 
@@ -27,6 +28,23 @@ RNSHeaderItemPlacement RNSHeaderItemPlacementFromReactRNSStackHeaderItemIOSPlace
   }
 }
 
+UIBarButtonItemStyle UIBarButtonItemStyleFromReactRNSStackHeaderItemIOSVariant(
+    react::RNSStackHeaderItemIOSVariant variant)
+{
+  switch (variant) {
+    case react::RNSStackHeaderItemIOSVariant::Plain:
+      return UIBarButtonItemStylePlain;
+    case react::RNSStackHeaderItemIOSVariant::Prominent:
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+      if (@available(iOS 26.0, *)) {
+        return UIBarButtonItemStyleProminent;
+      }
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(26_0)
+      // Bold text look, closest counterpart of prominent style before iOS 26
+      return UIBarButtonItemStyleDone;
+  }
+}
+
 RNSHeaderItemSpacerPlacement RNSHeaderItemSpacerPlacementFromReactRNSStackHeaderItemSpacerIOSPlacement(
     react::RNSStackHeaderItemSpacerIOSPlacement placement)
 {
@@ -52,4 +70,65 @@ UINavigationItemBackButtonDisplayModeFromReactRNSStackHeaderConfigIOSBackButtonD
   }
 }
 
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0)
+
+UIBarMinimizationBehavior UIBarMinimizationBehaviorFromReactRNSStackHeaderConfigIOSMinimizationBehavior(
+    react::RNSStackHeaderConfigIOSMinimizationBehavior minimizationBehavior)
+{
+  switch (minimizationBehavior) {
+    case react::RNSStackHeaderConfigIOSMinimizationBehavior::Automatic:
+      return UIBarMinimizationBehaviorAutomatic;
+    case react::RNSStackHeaderConfigIOSMinimizationBehavior::Never:
+      return UIBarMinimizationBehaviorNever;
+    case react::RNSStackHeaderConfigIOSMinimizationBehavior::OnScrollDown:
+      return UIBarMinimizationBehaviorOnScrollDown;
+    case react::RNSStackHeaderConfigIOSMinimizationBehavior::OnScrollUp:
+      return UIBarMinimizationBehaviorOnScrollUp;
+  }
+}
+
+UIBarMinimizationRestorationBehavior
+UIBarMinimizationRestorationBehaviorFromReactRNSStackHeaderConfigIOSRestorationBehavior(
+    react::RNSStackHeaderConfigIOSRestorationBehavior restorationBehavior)
+{
+  switch (restorationBehavior) {
+    case react::RNSStackHeaderConfigIOSRestorationBehavior::Automatic:
+      return UIBarMinimizationRestorationBehaviorAutomatic;
+    case react::RNSStackHeaderConfigIOSRestorationBehavior::AtScrollEdge:
+      return UIBarMinimizationRestorationBehaviorAtScrollEdge;
+  }
+}
+
+#endif // Check for iOS >= 27
+  
+RNSHeaderItemVisibilityPriority RNSHeaderItemVisibilityPriorityFromReactRNSStackHeaderItemIOSVisibilityPriority(
+    react::RNSStackHeaderItemIOSVisibilityPriority visibilityPriority)
+{
+  switch (visibilityPriority) {
+    case react::RNSStackHeaderItemIOSVisibilityPriority::Low:
+      return RNSHeaderItemVisibilityPriorityLow;
+    case react::RNSStackHeaderItemIOSVisibilityPriority::Standard:
+      return RNSHeaderItemVisibilityPriorityStandard;
+    case react::RNSStackHeaderItemIOSVisibilityPriority::High:
+      return RNSHeaderItemVisibilityPriorityHigh;
+  }
+}
+
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0) && !TARGET_OS_TV && !TARGET_OS_VISION
+API_AVAILABLE(ios(27.0))
+UIBarButtonItemVisibilityPriority UIBarButtonItemVisibilityPriorityFromRNSHeaderItemVisibilityPriority(
+    RNSHeaderItemVisibilityPriority visibilityPriority)
+{
+  switch (visibilityPriority) {
+    case RNSHeaderItemVisibilityPriorityLow:
+      return UIBarButtonItemVisibilityPriorityLow;
+    case RNSHeaderItemVisibilityPriorityStandard:
+      return UIBarButtonItemVisibilityPriorityStandard;
+    case RNSHeaderItemVisibilityPriorityHigh:
+      return UIBarButtonItemVisibilityPriorityHigh;
+  }
+}
+#endif // RNS_IPHONE_OS_VERSION_AVAILABLE(27_0) && !TARGET_OS_TV && !TARGET_OS_VISION
+
 }; // namespace rnscreens::conversion

package/ios/stack/header/RNSHeaderItemVisibilityPriority.h

@@ -0,0 +1,9 @@
+#pragma once
+
+#import <Foundation/Foundation.h>
+
+typedef NS_ENUM(NSInteger, RNSHeaderItemVisibilityPriority) {
+  RNSHeaderItemVisibilityPriorityLow,
+  RNSHeaderItemVisibilityPriorityStandard,
+  RNSHeaderItemVisibilityPriorityHigh,
+};

package/ios/stack/header/RNSStackHeaderConfigComponentView.h

@@ -23,6 +23,10 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic, readonly, nullable) NSString *largeSubtitle;
 @property (nonatomic, readonly) BOOL largeTitleEnabled;
 @property (nonatomic, readonly, nullable) NSString *prompt;
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0)
+@property (nonatomic, readonly) UIBarMinimizationBehavior minimizationBehavior API_AVAILABLE(ios(27.0));
+@property (nonatomic, readonly) UIBarMinimizationRestorationBehavior restorationBehavior API_AVAILABLE(ios(27.0));
+#endif // Check for iOS >= 27
 @property (nonatomic, readonly, nullable) NSString *backButtonTitle;
 @property (nonatomic, readonly) UINavigationItemBackButtonDisplayMode backButtonDisplayMode;
 @property (nonatomic, readonly) BOOL backButtonMenuEnabled;

package/ios/stack/header/RNSStackHeaderConfigComponentView.mm

@@ -1,6 +1,6 @@
 #import "RNSStackHeaderConfigComponentView.h"
-#import "RNSConversions.h"
 #import "RNSConversions-Stack.h"
+#import "RNSConversions.h"
 #import "RNSImageLoadingHelper.h"
 #import "RNSStackHeaderAppearanceMapper.h"
 #import "RNSStackHeaderConfigEventEmitter.h"
@@ -21,8 +21,8 @@
 #import <React/RCTLog.h>
 #import <react/renderer/components/rnscreens/Props.h>
 #import <react/renderer/components/rnscreens/RCTComponentViewHelpers.h>
-#import <react/utils/ManagedObjectWrapper.h>
 #import <react/renderer/components/rnscreens/RNSStackHeaderConfigComponentDescriptor.h>
+#import <react/utils/ManagedObjectWrapper.h>
 
 namespace react = facebook::react;
 
@@ -69,6 +69,12 @@ static void RNSAssertIsValidHeaderChild(UIView *child)
   _largeSubtitle = nil;
   _largeTitleEnabled = NO;
   _prompt = nil;
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0)
+  if (@available(iOS 27.0, *)) {
+    _minimizationBehavior = UIBarMinimizationBehaviorAutomatic;
+    _restorationBehavior = UIBarMinimizationRestorationBehaviorAutomatic;
+  }
+#endif // Check for iOS >= 27
   _backButtonTitle = nil;
   _backButtonDisplayMode = UINavigationItemBackButtonDisplayModeDefault;
   _backButtonMenuEnabled = YES;
@@ -305,7 +311,8 @@ static void RNSAssertIsValidHeaderChild(UIView *child)
       [static_cast<RNSStackHeaderItemComponentView *>(locator.headerItem)
           updateMenuElementWithId:menuItemId
                       withElement:newItemData
-                       parentMenu:locator.searchResult.parentMenu];
+                       parentMenu:locator.searchResult.parentMenu
+             inMenuRepresentation:locator.inMenuRepresentation];
       break;
     case RNSMenuElementPositionTitle:
       if (locator.searchResult.parentMenu != nil) {
@@ -351,7 +358,8 @@ static void RNSAssertIsValidHeaderChild(UIView *child)
       [static_cast<RNSStackHeaderItemComponentView *>(locator.headerItem)
           updateMenuElementWithId:menuElementId
                       withElement:newMenuItem
-                       parentMenu:locator.searchResult.parentMenu];
+                       parentMenu:locator.searchResult.parentMenu
+             inMenuRepresentation:locator.inMenuRepresentation];
       break;
     case RNSMenuElementPositionTitle:
       if (locator.searchResult.parentMenu == nil) {
@@ -443,13 +451,39 @@ static void RNSAssertIsValidHeaderChild(UIView *child)
     _prompt = RCTNSStringFromStringNilIfEmpty(newHeaderProps.prompt);
   }
 
+  if (oldHeaderProps.minimizationBehavior != newHeaderProps.minimizationBehavior) {
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0)
+    if (@available(iOS 27.0, *)) {
+      _minimizationBehavior =
+          rnscreens::conversion::UIBarMinimizationBehaviorFromReactRNSStackHeaderConfigIOSMinimizationBehavior(
+              newHeaderProps.minimizationBehavior);
+    } else
+#endif // Check for iOS >= 27
+      if (newHeaderProps.minimizationBehavior != react::RNSStackHeaderConfigIOSMinimizationBehavior::Automatic) {
+        RCTLogWarn(@"[RNScreens] minimizationBehavior is supported for iOS >= 27");
+      }
+  }
+
+  if (oldHeaderProps.restorationBehavior != newHeaderProps.restorationBehavior) {
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0)
+    if (@available(iOS 27.0, *)) {
+      _restorationBehavior = rnscreens::conversion::
+          UIBarMinimizationRestorationBehaviorFromReactRNSStackHeaderConfigIOSRestorationBehavior(
+              newHeaderProps.restorationBehavior);
+    } else
+#endif // Check for iOS >= 27
+      if (newHeaderProps.restorationBehavior != react::RNSStackHeaderConfigIOSRestorationBehavior::Automatic) {
+        RCTLogWarn(@"[RNScreens] restorationBehavior is supported for iOS >= 27");
+      }
+  }
+
   if (oldHeaderProps.backButtonTitle != newHeaderProps.backButtonTitle) {
     _backButtonTitle = RCTNSStringFromStringNilIfEmpty(newHeaderProps.backButtonTitle);
   }
 
   if (oldHeaderProps.backButtonDisplayMode != newHeaderProps.backButtonDisplayMode) {
-    _backButtonDisplayMode =
-        rnscreens::conversion::UINavigationItemBackButtonDisplayModeFromReactRNSStackHeaderConfigIOSBackButtonDisplayMode(
+    _backButtonDisplayMode = rnscreens::conversion::
+        UINavigationItemBackButtonDisplayModeFromReactRNSStackHeaderConfigIOSBackButtonDisplayMode(
             newHeaderProps.backButtonDisplayMode);
   }
 

package/ios/stack/header/RNSStackHeaderConfigDataProviding.h

@@ -1,6 +1,7 @@
 #pragma once
 
 #import <UIKit/UIKit.h>
+#import "RNSDefines.h"
 
 @class RNSStackHeaderMenuData;
 
@@ -15,6 +16,10 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic, readonly, nullable) NSString *largeSubtitle;
 @property (nonatomic, readonly) BOOL largeTitleEnabled;
 @property (nonatomic, readonly, nullable) NSString *prompt;
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(27_0)
+@property (nonatomic, readonly) UIBarMinimizationBehavior minimizationBehavior API_AVAILABLE(ios(27.0));
+@property (nonatomic, readonly) UIBarMinimizationRestorationBehavior restorationBehavior API_AVAILABLE(ios(27.0));
+#endif // Check for iOS >= 27
 @property (nonatomic, readonly, nullable) NSString *backButtonTitle;
 @property (nonatomic, readonly) UINavigationItemBackButtonDisplayMode backButtonDisplayMode;
 @property (nonatomic, readonly) BOOL backButtonMenuEnabled;

package/ios/stack/header/RNSStackHeaderContentFactory.mm

@@ -51,6 +51,9 @@
                                                     action:nil];
   }
 
+  barButtonItem.style = item.style;
+  barButtonItem.enabled = !item.disabled;
+
   if (item.icon != nil) {
     __weak UIBarButtonItem *weakBarButtonItem = barButtonItem;
     UIImage *syncImage = [RNSStackHeaderIconResolver resolveIcon:item.icon

package/ios/stack/header/RNSStackHeaderItemComponentView.h

@@ -16,25 +16,32 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic, readonly, nullable) NSString *title;
 @property (nonatomic, readonly, nullable) RNSStackHeaderIconData *icon;
 @property (nonatomic, readonly, nullable) RNSStackHeaderMenuData *menu;
+@property (nonatomic, readonly, nullable) RNSStackHeaderMenuData *menuRepresentation;
 @property (nonatomic, readonly, nullable) UIView *customView;
+@property (nonatomic, readonly) UIBarButtonItemStyle style;
+@property (nonatomic, readonly) BOOL disabled;
 @property (nonatomic, readonly) BOOL respondsToOnPress;
 @property (nonatomic, readonly) BOOL hidesSharedBackground;
+@property (nonatomic, readonly) RNSHeaderItemVisibilityPriority visibilityPriority;
 
 @property (nonatomic, nullable) NSString *titleProp;
 @property (nonatomic, nullable) RNSStackHeaderIconData *iconProp;
 @property (nonatomic, nullable) RNSStackHeaderMenuData *menuProp;
+@property (nonatomic, nullable) RNSStackHeaderMenuData *menuRepresentationProp;
 
 @property (nonatomic, weak, nullable) id<RNSStackHeaderItemInvalidationDelegate> invalidationDelegate;
 
 - (void)emitOnPress;
 
 /**
- * Replaces a menu element in the item's menu tree with a new element constructed from command options.
+ * Replaces a menu element in the item's menu or menuRepresentation tree with a new element
+ * constructed from command options.
  * If parentMenu is nil, the element is the root menu and is replaced directly.
  */
 - (void)updateMenuElementWithId:(NSString *)elementId
                     withElement:(id<RNSStackHeaderMenuElement>)newElement
-                     parentMenu:(nullable RNSStackHeaderMenuData *)parentMenu;
+                     parentMenu:(nullable RNSStackHeaderMenuData *)parentMenu
+           inMenuRepresentation:(BOOL)inMenuRepresentation;
 
 @end