@react-navigation/elements 3.0.0-alpha.5 → 3.0.0-alpha.51

package/src/Container.tsx

@@ -1,18 +1,40 @@
+import * as React from 'react';
 import { Platform, View, type ViewStyle } from 'react-native';
 
 export type Props = {
-  inert?: boolean;
-  style?: React.CSSProperties & ViewStyle;
+  ref?: React.Ref<HTMLDivElement | React.ComponentRef<typeof View>> | undefined;
+  inert?: boolean | undefined;
+  style?:
+    | (ViewStyle &
+        Omit<React.CSSProperties, 'backgroundColor'> & {
+          backgroundColor?: ViewStyle['backgroundColor'] | undefined;
+        })
+    | undefined;
   children: React.ReactNode;
 };
 
-export function Container({ inert, children, style }: Props) {
+export function Container({ ref, inert, children, style }: Props) {
   if (Platform.OS === 'web') {
+    const { backgroundColor, flex, ...rest } = style ?? {};
+
     return (
       <div
+        ref={ref as React.Ref<HTMLDivElement> | undefined}
         inert={inert}
         aria-hidden={inert}
-        style={{ ...DEFAULT_STYLE, ...style }}
+        style={{
+          ...DEFAULT_STYLE,
+          // FIXME: A numeric flex shorthand uses a percentage basis in browsers.
+          // With nested containers, it slows down layout in Safari on iOS 27.
+          // So we explicitly set it to `0` without percentage, which renders 0px.
+          ...(flex !== undefined && flex > 0
+            ? { flexGrow: flex, flexShrink: 1, flexBasis: 0 }
+            : { flex }),
+          ...rest,
+          backgroundColor:
+            // In practice we only get string on web instead of OpaqueValue
+            typeof backgroundColor === 'string' ? backgroundColor : undefined,
+        }}
       >
         {children}
       </div>
@@ -21,6 +43,7 @@ export function Container({ inert, children, style }: Props) {
 
   return (
     <View
+      ref={ref as React.Ref<View> | undefined}
       aria-hidden={inert}
       style={[{ pointerEvents: inert ? 'none' : 'box-none' }, style]}
       collapsable={false}

package/src/Header/Header.tsx

@@ -1,4 +1,8 @@
-import { useNavigation, useTheme } from '@react-navigation/native';
+import {
+  UNSTABLE_CornerInset,
+  useNavigation,
+  useTheme,
+} from '@react-navigation/native';
 import * as React from 'react';
 import {
   Animated,
@@ -30,20 +34,22 @@ type Props = HeaderOptions & {
   /**
    * Options for the back button.
    */
-  back?: {
-    /**
-     * Title of the previous screen.
-     */
-    title: string | undefined;
-    /**
-     * The `href` to use for the anchor tag on web
-     */
-    href: string | undefined;
-  };
+  back?:
+    | {
+        /**
+         * Title of the previous screen.
+         */
+        title: string | undefined;
+        /**
+         * The `href` to use for the anchor tag on web
+         */
+        href: string | undefined;
+      }
+    | undefined;
   /**
    * Whether the header is in a modal
    */
-  modal?: boolean;
+  modal?: boolean | undefined;
   /**
    * Title text for the header.
    */
@@ -79,7 +85,7 @@ export function Header(props: Props) {
   const { colors } = useTheme();
 
   const navigation = useNavigation();
-  const isParentHeaderShown = React.useContext(HeaderShownContext);
+  const isParentHeaderShown = React.use(HeaderShownContext);
 
   const [searchBarVisible, setSearchBarVisible] = React.useState(false);
 
@@ -174,7 +180,7 @@ export function Header(props: Props) {
     transform,
     transformOrigin,
     ...unsafeStyles
-  } = StyleSheet.flatten(customHeaderStyle || {}) as ViewStyle;
+  } = (StyleSheet.flatten(customHeaderStyle) || {}) as ViewStyle;
 
   if (process.env.NODE_ENV !== 'production') {
     warnIfHeaderStylesDefined(unsafeStyles);
@@ -231,12 +237,9 @@ export function Header(props: Props) {
   // Setting a property to undefined triggers default style
   // So we need to filter them out
   // Users can use `null` instead
-  for (const styleProp in safeStyles) {
-    // @ts-expect-error: typescript wrongly complains that styleProp cannot be used to index safeStyles
-    if (safeStyles[styleProp] === undefined) {
-      // @ts-expect-error don't need to care about index signature for deletion
-      // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
-      delete safeStyles[styleProp];
+  for (const [styleProp, value] of Object.entries(safeStyles)) {
+    if (value === undefined) {
+      Reflect.deleteProperty(safeStyles, styleProp);
     }
   }
 
@@ -321,21 +324,21 @@ export function Header(props: Props) {
       return;
     }
 
-    Animated.timing(searchBarVisibleAnim, {
+    const animation = Animated.timing(searchBarVisibleAnim, {
       toValue: searchBarVisible ? 1 : 0,
       duration: 150,
       useNativeDriver,
       easing: Easing.in(Easing.linear),
-    }).start(({ finished }) => {
+    });
+
+    animation.start(({ finished }) => {
       if (finished) {
         setSearchBarRendered(searchBarVisible);
         searchBarVisibleRef.current = searchBarVisible;
       }
     });
 
-    return () => {
-      searchBarVisibleAnim.stopAnimation();
-    };
+    return () => animation.stop();
   }, [searchBarVisible, searchBarVisibleAnim]);
 
   const headerOpacity = searchBarVisibleAnim.interpolate({
@@ -402,6 +405,7 @@ export function Header(props: Props) {
           },
         ]}
       >
+        <UNSTABLE_CornerInset direction="horizontal" edge="left" />
         <View
           style={[
             styles.start,
@@ -458,7 +462,23 @@ export function Header(props: Props) {
                   headerSearchBarOptions?.onOpen?.();
                 }}
               >
-                <HeaderIcon source={searchIcon} tintColor={iconTintColor} />
+                <HeaderIcon
+                  icon={Platform.select({
+                    android: {
+                      type: 'materialSymbol',
+                      name: 'search',
+                    },
+                    ios: {
+                      type: 'sfSymbol',
+                      name: 'magnifyingglass',
+                    },
+                    default: {
+                      type: 'image',
+                      source: searchIcon,
+                    },
+                  })}
+                  color={iconTintColor}
+                />
               </HeaderButton>
             ) : null}
           </HeaderButtonBackground>
@@ -540,7 +560,7 @@ const styles = StyleSheet.create({
     maxWidth: '50%',
   },
   background: {
-    ...StyleSheet.absoluteFillObject,
+    ...StyleSheet.absoluteFill,
     pointerEvents: 'box-none',
   },
 });

package/src/Header/HeaderBackButton.tsx

@@ -12,11 +12,12 @@ import {
   View,
 } from 'react-native';
 
-import backIcon from '../assets/back-icon.png';
+import backIconImage from '../assets/back-icon.png';
 import { isLiquidGlassSupported } from '../LiquidGlassView';
 import type {
   HeaderBackButtonDisplayMode,
   HeaderBackButtonProps,
+  Icon,
 } from '../types';
 import { BUTTON_SIZE, HeaderButton } from './HeaderButton';
 import { HeaderIcon } from './HeaderIcon';
@@ -24,7 +25,7 @@ import { HeaderIcon } from './HeaderIcon';
 export function HeaderBackButton({
   disabled,
   allowFontScaling,
-  backImage,
+  icon,
   label,
   labelStyle,
   displayMode = 'minimal',
@@ -48,17 +49,30 @@ export function HeaderBackButton({
   const isMinimal = displayMode === 'minimal' || measuredMinimal;
 
   const renderBackImage = () => {
-    if (backImage) {
-      return backImage({ tintColor: tintColor ?? colors.text });
-    } else {
-      return (
-        <HeaderIcon
-          source={backIcon}
-          tintColor={tintColor ?? colors.text}
-          style={styles.icon}
-        />
-      );
+    const color = tintColor ?? colors.text;
+
+    if (typeof icon === 'function') {
+      return icon({ tintColor: color });
     }
+
+    const backIcon =
+      icon ??
+      Platform.select<Icon>({
+        ios: {
+          type: 'sfSymbol',
+          name: 'chevron.left',
+        },
+        android: {
+          type: 'materialSymbol',
+          name: 'arrow_back',
+        },
+        default: {
+          type: 'image',
+          source: backIconImage,
+        },
+      });
+
+    return <HeaderIcon icon={backIcon} color={color} style={styles.icon} />;
   };
 
   const handlePress = () => {
@@ -105,11 +119,11 @@ function HeaderBackLabel({
   truncatedLabel,
   onMeasureMinimal,
 }: {
-  allowFontScaling?: boolean;
+  allowFontScaling?: boolean | undefined;
   displayMode: HeaderBackButtonDisplayMode;
   label: string | undefined;
-  labelStyle?: Animated.WithAnimatedValue<StyleProp<TextStyle>>;
-  tintColor?: ColorValue;
+  labelStyle?: Animated.WithAnimatedValue<StyleProp<TextStyle>> | undefined;
+  tintColor?: ColorValue | undefined;
   truncatedLabel: string | undefined;
   onMeasureMinimal: () => void;
 }) {
@@ -121,9 +135,9 @@ function HeaderBackLabel({
     number | null
   >(null);
 
-  const wrapperRef = React.useRef<View | null>(null);
-  const labelRef = React.useRef<Text | null>(null);
-  const truncatedLabelRef = React.useRef<Text | null>(null);
+  const wrapperRef = React.useRef<React.ComponentRef<typeof View>>(null);
+  const labelRef = React.useRef<React.ComponentRef<typeof Text>>(null);
+  const truncatedLabelRef = React.useRef<React.ComponentRef<typeof Text>>(null);
 
   React.useLayoutEffect(() => {
     wrapperRef.current?.measure((_x, _y, width) => {
@@ -231,8 +245,8 @@ function HeaderBackLabel({
 // iOS uses a smaller chevron, Android uses a larger arrow
 const ICON_WIDTH = Platform.OS === 'ios' ? 13 : 24;
 const ICON_SPACING_START = isLiquidGlassSupported
-  ? 13 // Standard distance of chevron from left edge in liquid glass
-  : 0; // Otherwise icon is aligned to the start of the button
+  ? 15 // Standard distance of chevron from left edge in liquid glass
+  : 2; // Otherwise icon is aligned to the start of the button
 
 // Standard distance between chevron and label
 const ICON_LABEL_SPACING = 9;

package/src/Header/HeaderBackground.tsx

@@ -12,9 +12,9 @@ import { BlurEffectBackground } from '../BlurEffectBackground';
 import { type BlurEffectType } from '../getBlurBackgroundColor';
 
 type Props = Omit<ViewProps, 'style'> & {
-  blurEffect?: BlurEffectType | 'none';
-  style?: StyleProp<ViewStyle>;
-  children?: React.ReactNode;
+  blurEffect?: BlurEffectType | 'none' | undefined;
+  style?: StyleProp<ViewStyle> | undefined;
+  children?: React.ReactNode | undefined;
 };
 
 export function HeaderBackground({

package/src/Header/HeaderButton.tsx

@@ -4,20 +4,22 @@ import { Platform, StyleSheet } from 'react-native';
 import { PlatformPressable } from '../PlatformPressable';
 import type { HeaderButtonProps } from '../types';
 
-function HeaderButtonInternal(
-  {
-    disabled,
-    onPress,
-    pressColor,
-    pressOpacity,
-    accessibilityLabel,
-    testID,
-    style,
-    href,
-    children,
-  }: HeaderButtonProps,
-  ref: React.Ref<React.ComponentRef<typeof PlatformPressable>>
-) {
+type Props = HeaderButtonProps & {
+  ref?: React.Ref<React.ComponentRef<typeof PlatformPressable>> | undefined;
+};
+
+export function HeaderButton({
+  disabled,
+  onPress,
+  pressColor,
+  pressOpacity,
+  accessibilityLabel,
+  testID,
+  style,
+  href,
+  children,
+  ref,
+}: Props) {
   return (
     <PlatformPressable
       ref={ref}
@@ -40,10 +42,6 @@ function HeaderButtonInternal(
   );
 }
 
-export const HeaderButton = React.forwardRef(HeaderButtonInternal);
-
-HeaderButton.displayName = 'HeaderButton';
-
 export const BUTTON_SIZE = Platform.OS === 'ios' ? 44 : 48;
 export const BUTTON_SPACING = Platform.OS === 'ios' ? 10 : 8;
 

package/src/Header/HeaderButtonBackground.tsx

@@ -1,15 +1,12 @@
 import { Animated, StyleSheet } from 'react-native';
 
-import { LiquidGlassView } from '../LiquidGlassView';
+import { AnimatedLiquidGlassView } from '../LiquidGlassView';
 import { BUTTON_SIZE } from './HeaderButton';
 
 type Props = React.ComponentProps<typeof Animated.View> & {
   plain?: boolean;
 };
 
-const AnimatedLiquidGlassView =
-  Animated.createAnimatedComponent(LiquidGlassView);
-
 export function HeaderButtonBackground({ plain, style, ...rest }: Props) {
   if (plain) {
     return <Animated.View style={[styles.container, style]} {...rest} />;

package/src/Header/HeaderIcon.tsx

@@ -1,24 +1,37 @@
-import { useLocale, useTheme } from '@react-navigation/native';
-import { Image, type ImageProps, Platform, StyleSheet } from 'react-native';
+import { useLocale } from '@react-navigation/native';
+import {
+  type ColorValue,
+  Platform,
+  type StyleProp,
+  StyleSheet,
+} from 'react-native';
 
-export function HeaderIcon({ source, style, ...rest }: ImageProps) {
-  const { colors } = useTheme();
+import { PlatformIcon, type PlatformIconStyle } from '../PlatformIcon';
+import type { Icon } from '../types';
+
+type Props = {
+  icon: Icon;
+  color: ColorValue;
+  style?: StyleProp<PlatformIconStyle> | undefined;
+};
+
+export function HeaderIcon({ icon, color, style }: Props) {
   const { direction } = useLocale();
 
+  const iconStyle = [styles.icon, direction === 'rtl' && styles.flip, style];
+
   return (
-    <Image
-      source={source}
-      resizeMode="contain"
-      fadeDuration={0}
-      tintColor={colors.text}
-      style={[styles.icon, direction === 'rtl' && styles.flip, style]}
-      {...rest}
+    <PlatformIcon
+      icon={icon}
+      color={color}
+      size={ICON_SIZE}
+      style={iconStyle}
     />
   );
 }
 
-export const ICON_SIZE = Platform.OS === 'ios' ? 21 : 24;
-export const ICON_MARGIN = Platform.OS === 'ios' ? 8 : 3;
+const ICON_SIZE = Platform.OS === 'ios' ? 21 : 24;
+const ICON_MARGIN = Platform.OS === 'ios' ? 8 : 3;
 
 const styles = StyleSheet.create({
   icon: {

package/src/Header/HeaderSearchBar.tsx

@@ -1,11 +1,9 @@
-import { useNavigation, useTheme } from '@react-navigation/native';
+import { SFSymbol, useNavigation, useTheme } from '@react-navigation/native';
 import * as React from 'react';
 import {
   Animated,
   BackHandler,
   type ColorValue,
-  Image,
-  type NativeEventSubscription,
   Platform,
   type StyleProp,
   StyleSheet,
@@ -14,10 +12,7 @@ import {
   type ViewStyle,
 } from 'react-native';
 
-import clearIcon from '../assets/clear-icon.png';
 import closeIcon from '../assets/close-icon.png';
-import searchIcon from '../assets/search-icon.png';
-import searchIconLegacy from '../assets/search-icon-legacy.png';
 import { Color } from '../Color';
 import {
   AnimatedLiquidGlassContainerView,
@@ -34,11 +29,12 @@ import { HeaderIcon } from './HeaderIcon';
 type Props = Omit<HeaderSearchBarOptions, 'ref'> & {
   visible: boolean;
   onClose: () => void;
-  tintColor?: ColorValue;
-  pressColor?: ColorValue;
-  pressOpacity?: number;
+  tintColor?: ColorValue | undefined;
+  pressColor?: ColorValue | undefined;
+  pressOpacity?: number | undefined;
   statusBarHeight: number;
-  style?: Animated.WithAnimatedValue<StyleProp<ViewStyle>>;
+  style?: Animated.WithAnimatedValue<StyleProp<ViewStyle>> | undefined;
+  ref?: React.Ref<HeaderSearchBarRef> | undefined;
 };
 
 const INPUT_TYPE_TO_MODE = {
@@ -50,33 +46,31 @@ const INPUT_TYPE_TO_MODE = {
 
 const useNativeDriver = Platform.OS !== 'web';
 
-function HeaderSearchBarInternal(
-  {
-    visible,
-    inputType,
-    autoFocus = true,
-    autoCapitalize,
-    placeholder = 'Search',
-    enterKeyHint = 'search',
-    cancelButtonText = 'Cancel',
-    onChange,
-    onClose,
-    tintColor,
-    pressColor,
-    pressOpacity,
-    statusBarHeight,
-    style,
-    ...rest
-  }: Props,
-  ref: React.ForwardedRef<HeaderSearchBarRef>
-) {
+export function HeaderSearchBar({
+  visible,
+  inputType,
+  autoFocus = true,
+  autoCapitalize,
+  placeholder = 'Search',
+  enterKeyHint = 'search',
+  cancelButtonText = 'Cancel',
+  onChange,
+  onClose,
+  tintColor,
+  pressColor,
+  pressOpacity,
+  statusBarHeight,
+  style,
+  ref,
+  ...rest
+}: Props) {
   const navigation = useNavigation();
   const { dark, colors, fonts } = useTheme();
   const [value, setValue] = React.useState('');
   const [clearVisibleAnim] = React.useState(() => new Animated.Value(0));
 
   const clearVisibleValueRef = React.useRef(false);
-  const inputRef = React.useRef<TextInput>(null);
+  const inputRef = React.useRef<React.ComponentRef<typeof TextInput>>(null);
 
   const hasText = value !== '';
 
@@ -126,13 +120,17 @@ function HeaderSearchBarInternal(
       }
     };
 
-    let backHandlerSubscription: NativeEventSubscription | undefined;
+    let backHandlerSubscription:
+      | ReturnType<typeof BackHandler.addEventListener>
+      | undefined;
 
     if (Platform.OS === 'web') {
       document?.body?.addEventListener?.('keyup', onKeyup);
     } else {
+      // eslint-disable-next-line @eslint-react/web-api/no-leaked-event-listener
       backHandlerSubscription = BackHandler.addEventListener(
         'hardwareBackPress',
+        // eslint-disable-next-line @eslint-react/web-api/no-leaked-event-listener
         () => {
           cancelSearch();
           return true;
@@ -210,13 +208,14 @@ function HeaderSearchBarInternal(
       ) : null}
       <HeaderButtonBackground style={styles.searchbarContainer}>
         {Platform.OS === 'ios' ? (
-          <HeaderIcon
-            source={isLiquidGlassSupported ? searchIcon : searchIconLegacy}
-            tintColor={textColor}
-            style={[
+          <SFSymbol
+            name="magnifyingglass"
+            size={SEARCH_ICON_SIZE}
+            color={textColor}
+            style={StyleSheet.flatten([
               styles.inputSearchIconIos,
               !isLiquidGlassSupported && styles.inputSearchIconIosLegacy,
-            ]}
+            ])}
           />
         ) : null}
         <TextInput
@@ -263,10 +262,10 @@ function HeaderSearchBarInternal(
               !isLiquidGlassSupported && styles.clearButtonIosLegacy,
             ]}
           >
-            <Image
-              source={clearIcon}
-              resizeMode="contain"
-              tintColor={textColor}
+            <SFSymbol
+              name="xmark.circle.fill"
+              size={CLEAR_ICON_SIZE}
+              color={textColor}
               style={styles.clearIconIos}
             />
           </PlatformPressable>
@@ -278,7 +277,19 @@ function HeaderSearchBarInternal(
           onPress={onClear}
           style={[styles.closeButton, { opacity: clearVisibleAnim }]}
         >
-          <HeaderIcon source={closeIcon} tintColor={textColor} />
+          <HeaderIcon
+            icon={Platform.select({
+              android: {
+                type: 'materialSymbol',
+                name: 'close',
+              },
+              default: {
+                type: 'image',
+                source: closeIcon,
+              },
+            })}
+            color={textColor}
+          />
         </HeaderButton>
       ) : null}
       {Platform.OS === 'ios' ? (
@@ -288,7 +299,7 @@ function HeaderSearchBarInternal(
               accessibilityLabel={cancelButtonText}
               onPress={cancelSearch}
             >
-              <HeaderIcon source={closeIcon} tintColor={textColor} />
+              <SFSymbol name="xmark" color={textColor} />
             </HeaderButton>
           </HeaderButtonBackground>
         ) : (
@@ -332,14 +343,14 @@ const styles = StyleSheet.create({
   },
   inputSearchIconIos: {
     position: 'absolute',
-    opacity: 0.5,
-    top: SEARCHBAR_ICON_SPACING,
-    left: SEARCHBAR_ICON_SPACING,
+    top: '50%',
+    left: BUTTON_SPACING + SEARCHBAR_ICON_SPACING / 2,
+    marginTop: -SEARCH_ICON_SIZE / 2,
     height: SEARCH_ICON_SIZE,
     width: SEARCH_ICON_SIZE,
   },
   inputSearchIconIosLegacy: {
-    top: SEARCHBAR_LEGACY_VERTICAL_OFFSET_IOS,
+    top: SEARCHBAR_ICON_SPACING,
   },
   backButton: {
     alignSelf: 'center',
@@ -417,5 +428,3 @@ const styles = StyleSheet.create({
     }),
   },
 });
-
-export const HeaderSearchBar = React.forwardRef(HeaderSearchBarInternal);

package/src/Header/HeaderTitle.tsx

@@ -10,9 +10,9 @@ import {
 } from 'react-native';
 
 type Props = Omit<TextProps, 'style'> & {
-  tintColor?: ColorValue;
-  children?: string;
-  style?: Animated.WithAnimatedValue<StyleProp<TextStyle>>;
+  tintColor?: ColorValue | undefined;
+  children?: string | undefined;
+  style?: Animated.WithAnimatedValue<StyleProp<TextStyle>> | undefined;
 };
 
 export function HeaderTitle({ tintColor, style, ...rest }: Props) {

package/src/Header/getHeaderTitle.tsx

@@ -1,7 +1,10 @@
 import type { HeaderOptions } from '../types';
 
 export function getHeaderTitle(
-  options: { title?: string; headerTitle?: HeaderOptions['headerTitle'] },
+  options: {
+    title?: string | undefined;
+    headerTitle?: HeaderOptions['headerTitle'];
+  },
   fallback: string
 ): string {
   return typeof options.headerTitle === 'string'

package/src/Header/useHeaderHeight.tsx

@@ -3,7 +3,7 @@ import * as React from 'react';
 import { HeaderHeightContext } from './HeaderHeightContext';
 
 export function useHeaderHeight() {
-  const height = React.useContext(HeaderHeightContext);
+  const height = React.use(HeaderHeightContext);
 
   if (height === undefined) {
     throw new Error(

package/src/Label/getLabel.tsx

@@ -1,5 +1,5 @@
 export function getLabel(
-  options: { label?: string; title?: string },
+  options: { label?: string | undefined; title?: string | undefined },
   fallback: string
 ): string {
   return options.label !== undefined