@react-navigation/native-stack 7.0.0-rc.22 → 7.0.0-rc.23

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@react-navigation/native-stack",
   "description": "Native stack navigator using react-native-screens",
-  "version": "7.0.0-rc.22",
+  "version": "7.0.0-rc.23",
   "keywords": [
     "react-native-component",
     "react-component",
@@ -52,12 +52,12 @@
     "clean": "del lib"
   },
   "dependencies": {
-    "@react-navigation/elements": "^2.0.0-rc.19",
+    "@react-navigation/elements": "^2.0.0-rc.20",
     "warn-once": "^0.1.1"
   },
   "devDependencies": {
     "@jest/globals": "^29.7.0",
-    "@react-navigation/native": "^7.0.0-rc.17",
+    "@react-navigation/native": "^7.0.0-rc.18",
     "@testing-library/react-native": "^12.4.3",
     "@types/react": "~18.2.79",
     "del-cli": "^5.1.0",
@@ -68,7 +68,7 @@
     "typescript": "^5.5.2"
   },
   "peerDependencies": {
-    "@react-navigation/native": "^7.0.0-rc.17",
+    "@react-navigation/native": "^7.0.0-rc.18",
     "react": ">= 18.2.0",
     "react-native": ">= 0.72.0",
     "react-native-safe-area-context": ">= 4.0.0",
@@ -99,5 +99,5 @@
       ]
     ]
   },
-  "gitHead": "1a26dd67e4b9625075e6e5229736d1c679c67ccb"
+  "gitHead": "b32550a43d0e2b532cfe100d9cf17837184a636e"
 }

package/src/types.tsx

@@ -339,9 +339,17 @@ export type NativeStackNavigationOptions = {
    *
    * Supported values:
    * - "default" - Displays one of the following depending on the available space: previous screen's title, generic title (e.g. 'Back') or no title (only icon).
-   * - "generic" – Displays one of the following depending on the available space: generic title (e.g. 'Back') or no title (only icon). iOS >= 14 only, falls back to "default" on older iOS versions.
+   * - "generic" – Displays one of the following depending on the available space: generic title (e.g. 'Back') or no title (only icon).
    * - "minimal" – Always displays only the icon without a title.
    *
+   * The "generic" mode is not supported when:
+   * - The iOS version is lower than 14
+   * - Custom back title is set
+   * - Custom back title style is set
+   * - Back button menu is disabled
+   *
+   * In such cases, the "default" mode will be used instead.
+   *
    * @platform ios
    */
   headerBackButtonDisplayMode?: ScreenStackHeaderConfigProps['backButtonDisplayMode'];

package/src/views/HeaderConfig.tsx

@@ -176,8 +176,17 @@ export function HeaderConfig({
       Platform.OS === 'ios' &&
       headerTransparent !== false);
 
-  const isBackButtonDisplayModeAvailableForCurrentPlatform =
-    Platform.OS === 'ios' && parseInt(Platform.Version, 10) >= 14;
+  const isBackButtonDisplayModeAvailable =
+    // On iOS 14+
+    Platform.OS === 'ios' &&
+    parseInt(Platform.Version, 10) >= 14 &&
+    // Doesn't have custom back title
+    headerBackTitle == null &&
+    // Doesn't have custom styling
+    backTitleFontFamily == null &&
+    backTitleFontSize == null &&
+    // Back button menu is not disabled
+    headerBackButtonMenuEnabled !== false;
 
   return (
     <ScreenStackHeaderConfig
@@ -185,12 +194,12 @@ export function HeaderConfig({
       backgroundColor={headerBackgroundColor}
       backTitle={headerBackTitle}
       backTitleVisible={
-        isBackButtonDisplayModeAvailableForCurrentPlatform
+        isBackButtonDisplayModeAvailable
           ? undefined
           : headerBackButtonDisplayMode !== 'minimal'
       }
       backButtonDisplayMode={
-        isBackButtonDisplayModeAvailableForCurrentPlatform
+        isBackButtonDisplayModeAvailable
           ? headerBackButtonDisplayMode
           : undefined
       }