update docs

Author: kligarski

guides/GUIDE_FOR_LIBRARY_AUTHORS.md

@@ -523,7 +523,7 @@ Controls the color of the navigation header.
 
 ### `backTitle` (iOS only)
 
-Allows for controlling the string to be rendered next to back button. By default iOS uses the title of the previous screen.
+Allows for controlling the string to be rendered next to back button. For iOS versions prior to 26, the title of the previous screen is used as default.
 
 ### `backTitleFontFamily` (iOS only)
 
@@ -535,6 +535,8 @@ Allows for customizing font size to be used for back button title on iOS.
 
 ### `backTitleVisible` (iOS only)
 
+This prop has been **deprecated**. Setting it has no effect as native code related to this prop has been removed. Kept only for backward compatibility. Will be removed in next major release.
+
 Whether the back button title should be visible. Defaults to `true`.
 
 When set to `false` it works as a "kill switch": it enforces `backButtonDisplayMode=minimal` and ignores `backButtonDisplayMode`, `backTitleFontSize`, `backTitleFontFamily`, `disableBackButtonMenu`, and `backTitle` works only for back button menu.
@@ -553,18 +555,28 @@ Controls whether the stack should be in `rtl` or `ltr` form.
 
 ### `disableBackButtonMenu` (iOS only)
 
-Boolean indicating whether to show the menu on longPress of iOS >= 14 back button.
+Boolean indicating whether to show the menu on longPress of the back button.
 
 ### `backButtonDisplayMode` (iOS only)
 
-Enum value indicating display mode of back button. It is used only when none of: `backTitleFontFamily`, `backTitleFontSize`, `disableBackButtonMenu` and `backTitleVisible=false` is set. The `backTitleVisible` forces `backButtonDisplayMode: minimal` and omits other values. Read more [#2800](https://github.com/software-mansion/react-native-screens/pull/2800). The other props, under the hood, customize `backButtonItem` which overrides `backButtonDisplayMode`. Read more [#2123](https://github.com/software-mansion/react-native-screens/pull/2123).
+Enum value indicating display mode of back button.
 
 Possible options:
 
-- `default` – show given back button previous controller title, system generic or just icon based on available space
-- `generic` – show given system generic or just icon based on available space
+- `default` – show given back button previous controller title, system generic or just icon based on available space and OS version
+- `generic` – show given system generic or just icon based on available space and OS version
 - `minimal` – show just an icon
 
+Starting from iOS 26:
+- the `title` of the previous screen is not used as back button title,
+- `generic` display mode behaves the same as `minimal`.
+
+In order to add text to the back button on iOS 26, use `default` display mode and specify text in `backTitle` property.
+
+On iOS versions prior to 26, using `generic` display mode with `backTitleFontFamily`, `backTitleFontSize`
+or `disableBackButtonMenu` property set is not supported due to limitations in the native platform.
+In such cases, display mode will fallback to `default`.
+
 ### `headerLeftBarButtonItems` / `headerRightBarButtonsItems` (iOS only)
 
 An array of objects describing native bar button items to display on the left or right side of the header. Each item can be:

src/types.tsx

@@ -602,7 +602,7 @@ export interface ScreenStackHeaderConfigProps extends ViewProps {
   backgroundColor?: ColorValue;
   /**
    * Title to display in the back button.
-   * @platform ios.
+   * @platform ios
    */
   backTitle?: string;
   /**
@@ -639,18 +639,28 @@ export interface ScreenStackHeaderConfigProps extends ViewProps {
    */
   direction?: 'rtl' | 'ltr';
   /**
-   * Boolean indicating whether to show the menu on longPress of iOS >= 14 back button.
+   * Boolean indicating whether to show the menu on longPress of the back button.
    * @platform ios
    */
   disableBackButtonMenu?: boolean;
   /**
-   * How the back button behaves. It is used only when none of: `backTitleFontFamily`, `backTitleFontSize`, `disableBackButtonMenu` and `backTitleVisible=false` is set.
+   * How the back button behaves.
    * The following values are currently supported (they correspond to [UINavigationItemBackButtonDisplayMode](https://developer.apple.com/documentation/uikit/uinavigationitembackbuttondisplaymode?language=objc)):
    *
-   * - `default` – show given back button previous controller title, system generic or just icon based on available space
-   * - `generic` – show given system generic or just icon based on available space
+   * - `default` – show given back button previous controller title, system generic or just icon based on available space and OS version
+   * - `generic` – show given system generic or just icon based on available space and OS version
    * - `minimal` – show just an icon
    *
+   * Starting from iOS 26:
+   * - the `title` of the previous screen is not used as back button title,
+   * - `generic` display mode behaves the same as `minimal`.
+   *
+   * In order to add text to the back button on iOS 26, use `default` display mode and specify text in `backTitle` property.
+   *
+   * On iOS versions prior to 26, using `generic` display mode with `backTitleFontFamily`, `backTitleFontSize`
+   * or `disableBackButtonMenu` property set is not supported due to limitations in the native platform.
+   * In such cases, display mode will fallback to `default`.
+   *
    * @platform ios
    */
   backButtonDisplayMode?: BackButtonDisplayMode;