feat: add a headerShown option

Author: satya164

src/types.tsx

@@ -99,6 +99,7 @@ export type HeaderTransitionConfig = {
 export type NavigationStackOptions = {
   title?: string;
   header?: ((props: HeaderProps) => React.ReactNode) | null;
+  headerShown?: boolean;
   headerTitle?:
     | ((props: TextProps & { children?: string }) => React.ReactNode)
     | React.ReactNode;

src/views/Header/Header.tsx

@@ -562,7 +562,7 @@ class Header extends React.PureComponent<Props, State> {
 
   private renderHeader = (props: SubviewProps) => {
     const { options } = props.scene.descriptor;
-    if (options.header === null) {
+    if (options.header === null || options.headerShown === false) {
       return null;
     }
     const left = this.renderLeft(props);

src/views/StackView/StackViewLayout.tsx

@@ -194,15 +194,15 @@ class StackViewLayout extends React.Component<Props, State> {
 
   private renderHeader(scene: Scene, headerMode: HeaderMode) {
     const { options } = scene.descriptor;
-    const { header } = options;
+    const { header, headerShown } = options;
 
     if (__DEV__ && typeof header === 'string') {
       throw new Error(
         `Invalid header value: "${header}". The header option must be a valid React component or null, not a string.`
       );
     }
 
-    if (header === null && headerMode === 'screen') {
+    if ((header === null || headerShown === false) && headerMode === 'screen') {
       return null;
     }