feat: add adaptNavigationTheme utility

[lukewalczak]

Summary

PR introduces an adaptNavigationTheme utility function returning provided React Navigation compliant theme, adapted in terms of colors, to the Material Design 3 color system.

• - update doc related to theming with react navigation

Related issues:

• DarkTheme not defined in package or react navigation theming docs is wrong #3380

Example

import { NavigationContainer, DefaultTheme } from '@react-navigation/native';
import { createStackNavigator } from '@react-navigation/stack';
import { Provider, MD3LightTheme, adaptNavigationTheme } from 'react-native-paper';
const Stack = createStackNavigator();
const { LightTheme } = adaptNavigationTheme({ lightTheme: DefaultTheme });
export default function App() {
  return (
    <Provider theme={MD3LightTheme}>
      <NavigationContainer theme={LightTheme}>
        <Stack.Navigator initialRouteName="Home">
          <Stack.Screen name="Home" component={HomeScreen} />
          <Stack.Screen name="Details" component={DetailsScreen} />
        </Stack.Navigator>
      </NavigationContainer>
    </Provider>
  );
}

Test plan

New functionality is covered by unit tests.

[github-actions]

The mobile version of example app from this branch is ready! You can see it here

.

[callstack-bot]

Hey @lukewalczak, thank you for your pull request 🤗. The documentation from this branch can be viewed here.

[github-actions]

The mobile version of example app from this branch is ready! You can see it here

.

[github-actions]

The mobile version of example app from this branch is ready! You can see it here

.

[github-actions]

The mobile version of example app from this branch is ready! You can see it here

.

[github-actions]

The mobile version of example app from this branch is ready! You can see it here

.