From 0b564910887d83c8045db32f1389f59f1190583c Mon Sep 17 00:00:00 2001
From: Konrad Michalik <konrad.michalik@swmansion.com>
Date: Fri, 3 Jul 2026 14:59:55 +0200
Subject: [PATCH 1/4] feat(Stack v5, iOS): Add `keepsMenuPresented` prop to
 menuItems

---
 .../test-stack-header-menu-ios/index.tsx      | 14 ++++++--
 .../header/RNSStackHeaderMenuCoordinator.mm   | 35 +++++++++++++++----
 .../stack/header/RNSStackHeaderMenuData.h     |  4 ++-
 .../stack/header/RNSStackHeaderMenuData.mm    |  2 ++
 .../stack/header/RNSStackHeaderMenuMapper.mm  |  6 ++--
 .../header/ios/StackHeaderMenu.ios.types.ts   | 15 ++++++++
 .../StackHeaderItemIOSNativeComponent.ts      |  1 +
 7 files changed, 66 insertions(+), 11 deletions(-)

diff --git a/apps/src/tests/single-feature-tests/stack-v5/test-stack-header-menu-ios/index.tsx b/apps/src/tests/single-feature-tests/stack-v5/test-stack-header-menu-ios/index.tsx
index 3ecc4dc07b..45260989ee 100644
--- a/apps/src/tests/single-feature-tests/stack-v5/test-stack-header-menu-ios/index.tsx
+++ b/apps/src/tests/single-feature-tests/stack-v5/test-stack-header-menu-ios/index.tsx
@@ -33,6 +33,7 @@ function TestStackHeaderMenuIOS() {
 function buildHeaderConfig(
   trailingItemsCount: number,
   showToast: (text: string) => void,
+  keepsMenuPresented: boolean,
 ): StackHeaderConfigProps {
   const trailingItems: NonNullable<
     StackHeaderConfigProps['ios']
@@ -58,6 +59,7 @@ function buildHeaderConfig(
             type: 'menuItem',
             itemType: 'action',
             title: `Action ${i}-1`,
+            keepsMenuPresented,
             onPress: () => showToast(`Clicked Action ${i}-1`),
           },
           {
@@ -65,18 +67,21 @@ function buildHeaderConfig(
             type: 'menuItem',
             itemType: 'toggle',
             title: `Toggle ${i}-1`,
+            keepsMenuPresented,
           },
           {
             id: `toggle-${i}-2`,
             type: 'menuItem',
             itemType: 'toggle',
             title: `Toggle ${i}-2`,
+            keepsMenuPresented,
           },
           {
             id: `toggle-${i}-3`,
             type: 'menuItem',
             itemType: 'toggle',
             title: `Toggle ${i}-3`,
+            keepsMenuPresented,
           },
           {
             id: `submenu-${i}`,
@@ -130,6 +135,7 @@ function ConfigScreen() {
   const [trailingItemsCount, setTrailingItemsCount] = useState<number>(
     DEFAULT_TRAILING_ITEMS_COUNT,
   );
+  const [keepsMenuPresented, setKeepsMenuPresented] = useState(false);
 
   const showToast = useCallback(
     (text: string) => {
@@ -140,8 +146,8 @@ function ConfigScreen() {
 
   const { setRouteOptions, routeKey } = navigation;
   const headerConfig = useMemo(
-    () => buildHeaderConfig(trailingItemsCount, showToast),
-    [trailingItemsCount, showToast],
+    () => buildHeaderConfig(trailingItemsCount, showToast, keepsMenuPresented),
+    [trailingItemsCount, showToast, keepsMenuPresented],
   );
 
   useLayoutEffect(() => {
@@ -156,6 +162,10 @@ function ConfigScreen() {
         title={`Toggle trailing items count (${trailingItemsCount}/4)`}
         onPress={() => setTrailingItemsCount(count => (count + 1) % 5)}
       />
+      <Button
+        title={`keepsMenuPresented: ${keepsMenuPresented}`}
+        onPress={() => setKeepsMenuPresented(prev => !prev)}
+      />
       <LongText />
     </ScrollView>
   );
diff --git a/ios/gamma/stack/header/RNSStackHeaderMenuCoordinator.mm b/ios/gamma/stack/header/RNSStackHeaderMenuCoordinator.mm
index f7e4e6da69..6ef4236807 100644
--- a/ios/gamma/stack/header/RNSStackHeaderMenuCoordinator.mm
+++ b/ios/gamma/stack/header/RNSStackHeaderMenuCoordinator.mm
@@ -1,4 +1,5 @@
 #import "RNSStackHeaderMenuCoordinator.h"
+#import "RNSDefines.h"
 
 #import <React/RCTAssert.h>
 
@@ -169,6 +170,8 @@ + (nullable UIMenuElement *)buildToggleFromData:(RNSStackHeaderMenuItemData *)da
               }];
   toggleAction.state = isItemToggledOn ? UIMenuElementStateOn : UIMenuElementStateOff;
 
+  [self decorateActionKeepsMenuPresented:toggleAction withData:data];
+
   return toggleAction;
 }
 
@@ -177,12 +180,16 @@ + (nullable UIMenuElement *)buildActionFromData:(RNSStackHeaderMenuItemData *)da
 {
   __weak id<RNSStackHeaderEventsDelegate> weakDelegate = delegate;
 
-  return [UIAction actionWithTitle:data.title
-                             image:nil
-                        identifier:nil
-                           handler:^(__kindof UIAction *_Nonnull action) {
-                             [weakDelegate didPressMenuItem:data.menuElementId];
-                           }];
+  UIAction *action = [UIAction actionWithTitle:data.title
+                                         image:nil
+                                    identifier:nil
+                                       handler:^(__kindof UIAction *_Nonnull action) {
+                                         [weakDelegate didPressMenuItem:data.menuElementId];
+                                       }];
+
+  [self decorateActionKeepsMenuPresented:action withData:data];
+
+  return action;
 }
 
 #pragma mark - Helpers
@@ -229,4 +236,20 @@ + (void)collectToggleItemsIdsFromMenu:(RNSStackHeaderMenuData *)menu
   }
 }
 
++ (void)decorateActionKeepsMenuPresented:(UIAction *)action withData:(RNSStackHeaderMenuItemData *)data
+{
+  if (data.keepsMenuPresented) {
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(16_0)
+    if (@available(iOS 16.0, *)) {
+      action.attributes |= UIMenuElementAttributesKeepsMenuPresented;
+    }
+#endif
+#if TARGET_OS_TV && __TV_OS_VERSION_MAX_ALLOWED >= 160000
+    if (@available(tvOS 16.0, *)) {
+      action.attributes |= UIMenuElementAttributesKeepsMenuPresented;
+    }
+#endif
+  }
+}
+
 @end
diff --git a/ios/gamma/stack/header/RNSStackHeaderMenuData.h b/ios/gamma/stack/header/RNSStackHeaderMenuData.h
index da2ec41ff0..90c1dcc93e 100644
--- a/ios/gamma/stack/header/RNSStackHeaderMenuData.h
+++ b/ios/gamma/stack/header/RNSStackHeaderMenuData.h
@@ -21,11 +21,13 @@ typedef NS_ENUM(NSInteger, RNSMenuItemType) {
 @property (nonatomic, copy, readonly, nullable) NSString *title;
 @property (nonatomic, readonly) RNSMenuItemType itemType;
 @property (nonatomic, readonly) BOOL initialToggleState;
+@property (nonatomic, readonly) BOOL keepsMenuPresented;
 
 - (instancetype)initWithId:(NSString *)menuElementId
                      title:(nullable NSString *)title
                   itemType:(RNSMenuItemType)itemType
-        initialToggleState:(BOOL)initialToggleState;
+        initialToggleState:(BOOL)initialToggleState
+        keepsMenuPresented:(BOOL)keepsMenuPresented;
 
 @end
 
diff --git a/ios/gamma/stack/header/RNSStackHeaderMenuData.mm b/ios/gamma/stack/header/RNSStackHeaderMenuData.mm
index 8aef0846ae..dc1a6cf1cd 100644
--- a/ios/gamma/stack/header/RNSStackHeaderMenuData.mm
+++ b/ios/gamma/stack/header/RNSStackHeaderMenuData.mm
@@ -8,12 +8,14 @@ - (instancetype)initWithId:(NSString *)menuElementId
                      title:(nullable NSString *)title
                   itemType:(RNSMenuItemType)itemType
         initialToggleState:(BOOL)initialToggleState
+        keepsMenuPresented:(BOOL)keepsMenuPresented
 {
   if (self = [super init]) {
     _menuElementId = [menuElementId copy];
     _title = [title copy];
     _itemType = itemType;
     _initialToggleState = initialToggleState;
+    _keepsMenuPresented = keepsMenuPresented;
   }
   return self;
 }
diff --git a/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm b/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm
index bb68d803b8..fb0fdebfb5 100644
--- a/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm
+++ b/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm
@@ -54,7 +54,8 @@ + (nullable RNSStackHeaderMenuData *)menuFromDictionary:(nullable id)dictionary
                                                     title:[self stringForKey:@"title" in:dict]
                                                  itemType:[self itemTypeFromString:[self stringForKey:@"itemType"
                                                                                                    in:dict]]
-                                       initialToggleState:[self boolForKey:@"initialToggleState" in:dict]];
+                                       initialToggleState:[self boolForKey:@"initialToggleState" in:dict]
+                                       keepsMenuPresented:[self boolForKey:@"keepsMenuPresented" in:dict]];
   }
 
   return nil;
@@ -78,7 +79,8 @@ + (void)validateMenuItemKeys:(NSDictionary *)dict
 {
   for (NSString *key in dict) {
     RCTAssert([key isEqualToString:@"id"] || [key isEqualToString:@"type"] || [key isEqualToString:@"title"] ||
-                  [key isEqualToString:@"itemType"] || [key isEqualToString:@"initialToggleState"],
+                  [key isEqualToString:@"itemType"] || [key isEqualToString:@"initialToggleState"] ||
+                  [key isEqualToString:@"keepsMenuPresented"],
               @"[RNScreens] Invalid key \"%@\" found in menu item",
               key);
   }
diff --git a/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts b/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts
index cc91be26d9..4f223ec517 100644
--- a/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts
+++ b/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts
@@ -75,6 +75,21 @@ export interface StackHeaderMenuItemIOS {
    * @platform ios
    */
   onPress?: () => void | undefined;
+  /**
+   * @summary Keeps the menu presented after this item is selected.
+   *
+   * @description
+   * When enabled, selecting this item will not dismiss the menu,
+   * allowing the user to continue interacting with other items.
+   *
+   * @remarks
+   * This prop should only be used for items in top-level menus. Requires iOS 16.0 or later.
+   *
+   * @default false
+
+   * @platform ios
+   */
+  keepsMenuPresented?: boolean | undefined;
 }
 
 /**
diff --git a/src/fabric/gamma/stack/StackHeaderItemIOSNativeComponent.ts b/src/fabric/gamma/stack/StackHeaderItemIOSNativeComponent.ts
index 827ee75f22..ae4a6d63ee 100644
--- a/src/fabric/gamma/stack/StackHeaderItemIOSNativeComponent.ts
+++ b/src/fabric/gamma/stack/StackHeaderItemIOSNativeComponent.ts
@@ -15,6 +15,7 @@ export type StackHeaderMenuItemIOS = {
   id: string;
   type: 'menuItem';
   title?: string | undefined;
+  keepsMenuPresented?: boolean | undefined;
 };
 
 export type StackHeaderMenuIOS = {

From 786e3f47267b5ac1d8b0c7b48458ae6e4972e18e Mon Sep 17 00:00:00 2001
From: Konrad Michalik <konrad.michalik@swmansion.com>
Date: Fri, 3 Jul 2026 15:11:14 +0200
Subject: [PATCH 2/4] wording

---
 .../gamma/stack/header/ios/StackHeaderMenu.ios.types.ts         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts b/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts
index 4f223ec517..3f787ef5f5 100644
--- a/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts
+++ b/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts
@@ -76,7 +76,7 @@ export interface StackHeaderMenuItemIOS {
    */
   onPress?: () => void | undefined;
   /**
-   * @summary Keeps the menu presented after this item is selected.
+   * @summary Keeps the menu presented after this item is tapped.
    *
    * @description
    * When enabled, selecting this item will not dismiss the menu,

From 94c83c50d410dbf6072cf82412b2095b8fe7ca32 Mon Sep 17 00:00:00 2001
From: Konrad Michalik <konrad.michalik@swmansion.com>
Date: Mon, 6 Jul 2026 12:09:43 +0200
Subject: [PATCH 3/4] fix CR suggestions

---
 .../header/RNSStackHeaderMenuCoordinator.mm      |  9 ++-------
 .../stack/header/RNSStackHeaderMenuMapper.mm     | 16 +++++++---------
 .../header/ios/StackHeaderMenu.ios.types.ts      |  2 +-
 3 files changed, 10 insertions(+), 17 deletions(-)

diff --git a/ios/gamma/stack/header/RNSStackHeaderMenuCoordinator.mm b/ios/gamma/stack/header/RNSStackHeaderMenuCoordinator.mm
index 6ef4236807..2ec97fc283 100644
--- a/ios/gamma/stack/header/RNSStackHeaderMenuCoordinator.mm
+++ b/ios/gamma/stack/header/RNSStackHeaderMenuCoordinator.mm
@@ -239,13 +239,8 @@ + (void)collectToggleItemsIdsFromMenu:(RNSStackHeaderMenuData *)menu
 + (void)decorateActionKeepsMenuPresented:(UIAction *)action withData:(RNSStackHeaderMenuItemData *)data
 {
   if (data.keepsMenuPresented) {
-#if RNS_IPHONE_OS_VERSION_AVAILABLE(16_0)
-    if (@available(iOS 16.0, *)) {
-      action.attributes |= UIMenuElementAttributesKeepsMenuPresented;
-    }
-#endif
-#if TARGET_OS_TV && __TV_OS_VERSION_MAX_ALLOWED >= 160000
-    if (@available(tvOS 16.0, *)) {
+#if RNS_IPHONE_OS_VERSION_AVAILABLE(16_0) || (TARGET_OS_TV && __TV_OS_VERSION_MAX_ALLOWED >= 160000)
+    if (@available(iOS 16.0, tvOS 16.0, *)) {
       action.attributes |= UIMenuElementAttributesKeepsMenuPresented;
     }
 #endif
diff --git a/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm b/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm
index fb0fdebfb5..121c25a792 100644
--- a/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm
+++ b/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm
@@ -3,6 +3,11 @@
 #import <React/RCTAssert.h>
 #import <React/RCTLog.h>
 
+static NSSet<NSString *> *const kAllowedMenuKeys =
+    [NSSet setWithObjects:@"id", @"type", @"title", @"children", @"singleSelection", nil];
+static NSSet<NSString *> *const kAllowedMenuItemKeys =
+    [NSSet setWithObjects:@"id", @"type", @"title", @"itemType", @"initialToggleState", @"keepsMenuPresented", nil];
+
 @implementation RNSStackHeaderMenuMapper
 
 + (nullable RNSStackHeaderMenuData *)menuFromDictionary:(nullable id)dictionary
@@ -66,10 +71,7 @@ + (nullable RNSStackHeaderMenuData *)menuFromDictionary:(nullable id)dictionary
 + (void)validateMenuKeys:(NSDictionary *)dict
 {
   for (NSString *key in dict) {
-    RCTAssert([key isEqualToString:@"id"] || [key isEqualToString:@"type"] || [key isEqualToString:@"title"] ||
-                  [key isEqualToString:@"children"] || [key isEqualToString:@"singleSelection"],
-              @"[RNScreens] Invalid key \"%@\" found in menu",
-              key);
+    RCTAssert([kAllowedMenuKeys containsObject:key], @"[RNScreens] Invalid key \"%@\" found in menu", key);
   }
   RCTAssert(dict[@"children"], @"[RNScreens] missing key \"children\" in menu");
   RCTAssert(dict[@"id"], @"[RNScreens] missing id on one of menu elements");
@@ -78,11 +80,7 @@ + (void)validateMenuKeys:(NSDictionary *)dict
 + (void)validateMenuItemKeys:(NSDictionary *)dict
 {
   for (NSString *key in dict) {
-    RCTAssert([key isEqualToString:@"id"] || [key isEqualToString:@"type"] || [key isEqualToString:@"title"] ||
-                  [key isEqualToString:@"itemType"] || [key isEqualToString:@"initialToggleState"] ||
-                  [key isEqualToString:@"keepsMenuPresented"],
-              @"[RNScreens] Invalid key \"%@\" found in menu item",
-              key);
+    RCTAssert([kAllowedMenuItemKeys containsObject:key], @"[RNScreens] Invalid key \"%@\" found in menu item", key);
   }
   RCTAssert(dict[@"id"], @"[RNScreens] missing id on one of menu elements");
 }
diff --git a/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts b/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts
index 3f787ef5f5..537b198c7d 100644
--- a/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts
+++ b/src/components/gamma/stack/header/ios/StackHeaderMenu.ios.types.ts
@@ -86,7 +86,7 @@ export interface StackHeaderMenuItemIOS {
    * This prop should only be used for items in top-level menus. Requires iOS 16.0 or later.
    *
    * @default false
-
+   *
    * @platform ios
    */
   keepsMenuPresented?: boolean | undefined;

From 13bae3a82e9183b9cef2c7a8637198502ad7fdaa Mon Sep 17 00:00:00 2001
From: Konrad Michalik <konrad.michalik@swmansion.com>
Date: Mon, 6 Jul 2026 12:20:09 +0200
Subject: [PATCH 4/4] rename constants

---
 ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm b/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm
index 121c25a792..d62749dad0 100644
--- a/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm
+++ b/ios/gamma/stack/header/RNSStackHeaderMenuMapper.mm
@@ -3,9 +3,9 @@
 #import <React/RCTAssert.h>
 #import <React/RCTLog.h>
 
-static NSSet<NSString *> *const kAllowedMenuKeys =
+static NSSet<NSString *> *const kRNSAllowedMenuKeys =
     [NSSet setWithObjects:@"id", @"type", @"title", @"children", @"singleSelection", nil];
-static NSSet<NSString *> *const kAllowedMenuItemKeys =
+static NSSet<NSString *> *const kRNSAllowedMenuItemKeys =
     [NSSet setWithObjects:@"id", @"type", @"title", @"itemType", @"initialToggleState", @"keepsMenuPresented", nil];
 
 @implementation RNSStackHeaderMenuMapper
@@ -71,7 +71,7 @@ + (nullable RNSStackHeaderMenuData *)menuFromDictionary:(nullable id)dictionary
 + (void)validateMenuKeys:(NSDictionary *)dict
 {
   for (NSString *key in dict) {
-    RCTAssert([kAllowedMenuKeys containsObject:key], @"[RNScreens] Invalid key \"%@\" found in menu", key);
+    RCTAssert([kRNSAllowedMenuKeys containsObject:key], @"[RNScreens] Invalid key \"%@\" found in menu", key);
   }
   RCTAssert(dict[@"children"], @"[RNScreens] missing key \"children\" in menu");
   RCTAssert(dict[@"id"], @"[RNScreens] missing id on one of menu elements");
@@ -80,7 +80,7 @@ + (void)validateMenuKeys:(NSDictionary *)dict
 + (void)validateMenuItemKeys:(NSDictionary *)dict
 {
   for (NSString *key in dict) {
-    RCTAssert([kAllowedMenuItemKeys containsObject:key], @"[RNScreens] Invalid key \"%@\" found in menu item", key);
+    RCTAssert([kRNSAllowedMenuItemKeys containsObject:key], @"[RNScreens] Invalid key \"%@\" found in menu item", key);
   }
   RCTAssert(dict[@"id"], @"[RNScreens] missing id on one of menu elements");
 }