refactor: modernize non standard components to the latest MD3 spec

src/components/Avatar/AvatarIcon.tsx

@@ -2,13 +2,11 @@ import { StyleSheet, View } from 'react-native';
 import type { StyleProp, ViewProps, ViewStyle } from 'react-native';
 
 import { useInternalTheme } from '../../core/theming';
-import { white } from '../../theme/colors';
+import { cornerFull } from '../../theme/tokens/sys/shape';
 import type { ThemeProp } from '../../types';
-import getContrastingColor from '../../utils/getContrastingColor';
 import Icon from '../Icon';
 import type { IconSource } from '../Icon';
-
-const defaultSize = 64;
+import { DEFAULT_SIZE, ICON_SIZE_RATIO, resolveAvatarColors } from './utils';
 
 export type Props = ViewProps & {
   /**
@@ -45,33 +43,34 @@ export type Props = ViewProps & {
  */
 const Avatar = ({
   icon,
-  size = defaultSize,
+  size = DEFAULT_SIZE,
   style,
   theme: themeOverrides,
   ...rest
 }: Props) => {
   const theme = useInternalTheme(themeOverrides);
-  const { backgroundColor = theme.colors?.primary, ...restStyle } =
-    StyleSheet.flatten(style) || {};
-  const textColor =
-    rest.color ??
-    getContrastingColor(backgroundColor, white, 'rgba(0, 0, 0, .54)');
+  const { backgroundColor, ...restStyle } = StyleSheet.flatten(style) || {};
+  const { background, textColor } = resolveAvatarColors({
+    theme,
+    backgroundColor,
+    color: rest.color,
+  });
 
   return (
     <View
       style={[
         {
           width: size,
           height: size,
-          borderRadius: size / 2,
-          backgroundColor,
+          borderRadius: cornerFull,
+          backgroundColor: background,
         },
         styles.container,
         restStyle,
       ]}
       {...rest}
     >
-      <Icon source={icon} color={textColor} size={size * 0.6} />
+      <Icon source={icon} color={textColor} size={size * ICON_SIZE_RATIO} />
     </View>
   );
 };

src/components/Avatar/AvatarImage.tsx

@@ -8,11 +8,11 @@ import type {
   ViewStyle,
 } from 'react-native';
 
+import { DEFAULT_SIZE, resolveAvatarColors } from './utils';
 import { useInternalTheme } from '../../core/theming';
+import { cornerFull } from '../../theme/tokens/sys/shape';
 import type { ThemeProp } from '../../types';
 
-const defaultSize = 64;
-
 export type AvatarImageSource =
   | ImageSourcePropType
   | ((props: { size: number }) => React.ReactNode);
@@ -74,7 +74,7 @@ export type Props = ViewProps & {
  * ```
  */
 const AvatarImage = ({
-  size = defaultSize,
+  size = DEFAULT_SIZE,
   source,
   style,
   onError,
@@ -87,17 +87,18 @@ const AvatarImage = ({
   testID,
   ...rest
 }: Props) => {
-  const { colors } = useInternalTheme(themeOverrides);
-  const { backgroundColor = colors?.primary } = StyleSheet.flatten(style) || {};
+  const theme = useInternalTheme(themeOverrides);
+  const { backgroundColor } = StyleSheet.flatten(style) || {};
+  const { background } = resolveAvatarColors({ theme, backgroundColor });
 
   return (
     <View
       style={[
         {
           width: size,
           height: size,
-          borderRadius: size / 2,
-          backgroundColor,
+          borderRadius: cornerFull,
+          backgroundColor: background,
         },
         style,
       ]}
@@ -108,7 +109,7 @@ const AvatarImage = ({
         <Image
           testID={testID}
           source={source}
-          style={{ width: size, height: size, borderRadius: size / 2 }}
+          style={{ width: size, height: size, borderRadius: cornerFull }}
           onError={onError}
           onLayout={onLayout}
           onLoad={onLoad}

src/components/Avatar/AvatarText.tsx

@@ -1,14 +1,12 @@
 import { StyleSheet, useWindowDimensions, View } from 'react-native';
 import type { StyleProp, TextStyle, ViewProps, ViewStyle } from 'react-native';
 
+import { DEFAULT_SIZE, resolveAvatarColors } from './utils';
 import { useInternalTheme } from '../../core/theming';
-import { white } from '../../theme/colors';
+import { cornerFull } from '../../theme/tokens/sys/shape';
 import type { ThemeProp } from '../../types';
-import getContrastingColor from '../../utils/getContrastingColor';
 import Text from '../Typography/Text';
 
-const defaultSize = 64;
-
 export type Props = ViewProps & {
   /**
    * Initials to show as the text in the `Avatar`.
@@ -55,7 +53,7 @@ export type Props = ViewProps & {
  */
 const AvatarText = ({
   label,
-  size = defaultSize,
+  size = DEFAULT_SIZE,
   style,
   labelStyle,
   color: customColor,
@@ -64,11 +62,12 @@ const AvatarText = ({
   ...rest
 }: Props) => {
   const theme = useInternalTheme(themeOverrides);
-  const { backgroundColor = theme.colors?.primary, ...restStyle } =
-    StyleSheet.flatten(style) || {};
-  const textColor =
-    customColor ??
-    getContrastingColor(backgroundColor, white, 'rgba(0, 0, 0, .54)');
+  const { backgroundColor, ...restStyle } = StyleSheet.flatten(style) || {};
+  const { background, textColor } = resolveAvatarColors({
+    theme,
+    backgroundColor,
+    color: customColor,
+  });
   const { fontScale } = useWindowDimensions();
 
   return (
@@ -77,8 +76,8 @@ const AvatarText = ({
         {
           width: size,
           height: size,
-          borderRadius: size / 2,
-          backgroundColor,
+          borderRadius: cornerFull,
+          backgroundColor: background,
         },
         styles.container,
         restStyle,
@@ -88,6 +87,7 @@ const AvatarText = ({
       <Text
         style={[
           styles.text,
+          theme.fonts.titleMedium,
           {
             color: textColor,
             fontSize: size / 2,

src/components/Avatar/utils.ts

@@ -0,0 +1,33 @@
+import type { ColorValue } from 'react-native';
+
+import { white } from '../../theme/colors';
+import type { InternalTheme } from '../../types';
+import getContrastingColor from '../../utils/getContrastingColor';
+
+export const DEFAULT_SIZE = 64;
+export const ICON_SIZE_RATIO = 0.6;
+
+/**
+ * Resolve background and content colors for an avatar.
+ * - No custom background → MD3 container pair (primaryContainer / onPrimaryContainer).
+ * - Custom background → keep luminance-based contrast so arbitrary per-user
+ *   colors stay legible (contentColorFor only handles known theme roles).
+ */
+export const resolveAvatarColors = ({
+  theme,
+  backgroundColor,
+  color,
+}: {
+  theme: InternalTheme;
+  backgroundColor?: ColorValue;
+  color?: string;
+}) => {
+  const usingDefault = backgroundColor == null;
+  const background = backgroundColor ?? theme.colors.primaryContainer;
+  const textColor =
+    color ??
+    (usingDefault
+      ? theme.colors.onPrimaryContainer
+      : getContrastingColor(background, white, 'rgba(0, 0, 0, .54)'));
+  return { background, textColor };
+};

src/components/Banner.tsx

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { Animated, StyleSheet, View } from 'react-native';
+import { Animated, Easing, StyleSheet, View } from 'react-native';
 import type { StyleProp, ViewStyle } from 'react-native';
 import type { LayoutChangeEvent } from 'react-native';
 
@@ -14,6 +14,7 @@ import { useInternalTheme } from '../core/theming';
 import type { $Omit, $RemoveChildren, Theme, ThemeProp } from '../types';
 
 const DEFAULT_MAX_WIDTH = 960;
+const ICON_SIZE = 40;
 
 export type Props = $Omit<$RemoveChildren<typeof Surface>, 'mode'> & {
   /**
@@ -148,7 +149,7 @@ const Banner = ({
   const showCallback = useLatestCallback(onShowAnimationFinished);
   const hideCallback = useLatestCallback(onHideAnimationFinished);
 
-  const { scale } = theme.animation;
+  const { duration, easing } = theme.motion;
 
   const opacity = position.interpolate({
     inputRange: [0, 0.1, 1],
@@ -159,20 +160,22 @@ const Banner = ({
     if (visible) {
       // show
       Animated.timing(position, {
-        duration: 250 * scale,
+        duration: duration.medium1,
         toValue: 1,
         useNativeDriver: false,
+        easing: Easing.bezier(...easing.standard),
       }).start(showCallback);
     } else {
       // hide
       Animated.timing(position, {
-        duration: 200 * scale,
+        duration: duration.short4,
         toValue: 0,
         useNativeDriver: false,
+        easing: Easing.bezier(...easing.standard),
       }).start(hideCallback);
     }
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [visible, position, scale]);
+  }, [visible, position, duration, easing]);
 
   const handleLayout = ({ nativeEvent }: LayoutChangeEvent) => {
     const { height } = nativeEvent.layout;
@@ -221,7 +224,7 @@ const Banner = ({
           <View style={styles.content}>
             {icon ? (
               <View style={styles.icon}>
-                <Icon source={icon} size={40} />
+                <Icon source={icon} size={ICON_SIZE} />
               </View>
             ) : null}
             <Text

src/components/DataTable/DataTableCell.tsx

@@ -105,6 +105,7 @@ const CellContent = ({
 
   return (
     <Text
+      variant="bodyMedium"
       style={textStyle}
       numberOfLines={1}
       maxFontSizeMultiplier={maxFontSizeMultiplier}

src/components/DataTable/DataTablePagination.tsx

@@ -298,6 +298,7 @@ const DataTablePagination = ({
             style={styles.optionsContainer}
           >
             <Text
+              variant="bodySmall"
               style={[styles.label, { color: labelColor }]}
               numberOfLines={3}
               testID="select-page-dropdown-label"
@@ -317,6 +318,7 @@ const DataTablePagination = ({
           </View>
         )}
       <Text
+        variant="bodySmall"
         style={[styles.label, { color: labelColor }]}
         numberOfLines={3}
         aria-label={accessibilityLabel || 'label'}
@@ -352,7 +354,6 @@ const styles = StyleSheet.create({
     marginVertical: 6,
   },
   label: {
-    fontSize: 12,
     marginRight: 16,
   },
   button: {

src/components/DataTable/DataTableTitle.tsx

@@ -1,5 +1,11 @@
 import * as React from 'react';
-import { Animated, PixelRatio, Pressable, StyleSheet } from 'react-native';
+import {
+  Animated,
+  Easing,
+  PixelRatio,
+  Pressable,
+  StyleSheet,
+} from 'react-native';
 import type {
   GestureResponderEvent,
   PressableProps,
@@ -94,13 +100,16 @@ const DataTableTitle = ({
     new Animated.Value(sortDirection === 'ascending' ? 0 : 1)
   );
 
+  const { duration, easing } = theme.motion;
+
   React.useEffect(() => {
     Animated.timing(spinAnim, {
       toValue: sortDirection === 'ascending' ? 0 : 1,
-      duration: 150,
+      duration: duration.short3,
+      easing: Easing.bezier(...easing.standard),
       useNativeDriver: true,
     }).start();
-  }, [sortDirection, spinAnim]);
+  }, [sortDirection, spinAnim, duration, easing]);
 
   const textColor = theme.colors.onSurface;
 
@@ -132,6 +141,7 @@ const DataTableTitle = ({
       {icon}
 
       <Text
+        variant="labelMedium"
         style={[
           styles.cell,
           // height must scale with numberOfLines
@@ -183,10 +193,8 @@ const styles = StyleSheet.create({
   },
 
   cell: {
-    lineHeight: 24,
-    fontSize: 12,
-    fontWeight: '500',
     alignItems: 'center',
+    lineHeight: 24,
   },
 
   sorted: {