docs: add warning about mixing modal types

README.md

@@ -169,6 +169,8 @@ Defines how the method that should be used to present the given screen. It is a
 - `fullScreenModal` – Explained below.
 - `formSheet` – Explained below.
 
+Using `containedModal` and `containedTransparentModal` with other types of modals in one native stack navigator is not recommended and can result in a freeze or a crash of the application.
+
 For iOS:
 - `modal` will use [`UIModalPresentationAutomatic`](https://developer.apple.com/documentation/uikit/uimodalpresentationstyle/uimodalpresentationautomatic?language=objc) on iOS 13 and later, and will use [`UIModalPresentationFullScreen`](https://developer.apple.com/documentation/uikit/uimodalpresentationstyle/uimodalpresentationfullscreen?language=objc) on iOS 12 and earlier.
 - `fullScreenModal` will use [`UIModalPresentationFullScreen`](https://developer.apple.com/documentation/uikit/uimodalpresentationstyle/uimodalpresentationfullscreen?language=objc)

createNativeStackNavigator/README.md

@@ -165,6 +165,8 @@ How the screen should be presented. Possible values:
 
 Defaults to `push`.
 
+Using `containedModal` and `containedTransparentModal` with other types of modals in one native stack navigator is not recommended and can result in a freeze or a crash of the application.
+
 #### `title`
 
 A string that can be used as a fallback for `headerTitle`.

native-stack/README.md

@@ -206,6 +206,8 @@ How the screen should be presented. Possible values:
 
 Defaults to `push`.
 
+Using `containedModal` and `containedTransparentModal` with other types of modals in one native stack navigator is not recommended and can result in a freeze or a crash of the application.
+
 #### `title`
 
 A string that can be used as a fallback for `headerTitle`.