feat: add support for transparent large header on iOS

[EvanBacon]

Description

• requires this bug fix fix(iOS): add missing largeTitleBackgroundColor prop #2500
• make it possible to support the stock Apple behavior where the large header is transparent and the collapsed header is blurry with a shadow. This is currently not possible because we inherit the blur effect from the collapsed title, and because there's no way to set the headerLargeTitle blur effect.

With this change, the default iOS behavior can more closely be matched by using the following props:

{
  headerLargeTitle: true,
  headerTransparent: true,
  headerBlurEffect: "systemChromeMaterial",
  headerLargeTitleShadowVisible: false,
  headerShadowVisible: true,
  headerLargeStyle: {
    // NEW: Make the large title transparent to match the background.
    backgroundColor: "transparent",
  },
}

Without the shadow changes, users also need to add this (and adjust for dark mode):

{
  headerStyle: {
    // Hack to ensure the collapsed small header shows the shadow / border.
    backgroundColor: "rgba(255,255,255,0.01)",
  },
}

Changes

Before

This is the best we can currently do.

After

Simulator.Screen.Recording.-.iPhone.16.Pro.Max.-.2024-11-13.at.14.15.39.mp4

Test code and steps to reproduce

Checklist

• Included code example that can be used to test this change
• Updated TS types
• Updated documentation:
  • https://github.com/software-mansion/react-native-screens/blob/main/guides/GUIDE_FOR_LIBRARY_AUTHORS.md
  • https://github.com/software-mansion/react-native-screens/blob/main/native-stack/README.md
  • https://github.com/software-mansion/react-native-screens/blob/main/src/types.tsx
  • https://github.com/software-mansion/react-native-screens/blob/main/src/native-stack/types.tsx
• Ensured that CI passes

[kkafar]

Thanks for the changes!

I have one question that needs to be answered before we can proceed.

[kkafar]

This version makes more sense, thanks!