feat: add autoHideHomeIndicator option for stack (#11415)

An autoHideHomeIndicator prop exists in native-stack (added in 00b2c24),
and this updates @react-navigation/stack to add an identical prop.

**Motivation**

We have an app using @react-navigation/stack that needs to hide the home
indicator in some cases and switching to native-stack breaks existing
functionality for us.

**Test plan**

Set `autoHideHomeIndicator` to `true` and use iPhone 14 Simulator (or
similar) to observe that the home indicator bar automatically hides
after a few seconds when there is no activity on the screen.

Co-authored-by: Satyajit Sahoo <satyajit.happy@gmail.com>

packages/stack/src/types.tsx

@@ -371,6 +371,12 @@ export type StackNavigationOptions = StackHeaderOptions &
      * Only supported on iOS and Android.
      */
     freezeOnBlur?: boolean;
+    /**
+     * Whether the home indicator should prefer to stay hidden on this screen. Defaults to `false`.
+     *
+     * @platform ios
+     */
+    autoHideHomeIndicator?: boolean;
   };
 
 export type StackNavigationConfig = {

packages/stack/src/views/Screens.tsx

@@ -32,6 +32,7 @@ export const MaybeScreen = ({
   active: 0 | 1 | Animated.AnimatedInterpolation<0 | 1>;
   children: React.ReactNode;
   freezeOnBlur?: boolean;
+  homeIndicatorHidden?: boolean;
 }) => {
   if (Screens != null) {
     return (

packages/stack/src/views/Stack/CardStack.tsx

@@ -665,6 +665,7 @@ export class CardStack extends React.Component<Props, State> {
               headerShown = true,
               headerTransparent,
               freezeOnBlur,
+              autoHideHomeIndicator,
             } = scene.descriptor.options;
 
             const safeAreaInsetTop = insets.top;
@@ -698,6 +699,7 @@ export class CardStack extends React.Component<Props, State> {
                 enabled={detachInactiveScreens}
                 active={isScreenActive}
                 freezeOnBlur={freezeOnBlur}
+                homeIndicatorHidden={autoHideHomeIndicator}
                 pointerEvents="box-none"
               >
                 <CardContainer