Migrate YearPickerModal to a @react-navigation modal screen

src/ONYXKEYS.ts

@@ -632,6 +632,16 @@ const ONYXKEYS = {
     /** Stores the role selected for members being imported from a spreadsheet */
     IMPORTED_SPREADSHEET_MEMBER_ROLE: 'importedSpreadsheetMemberRole',
 
+    /** Generic, `contextID`-routed transient command: the year selected in the year picker, read back and cleared by the CalendarPicker that opened it (any host: DOB, ScheduleCall, Search) */
+    CALENDAR_PICKER_SELECTED_YEAR: 'calendarPickerSelectedYear',
+
+    /**
+     * Search-only companion to `CALENDAR_PICKER_SELECTED_YEAR`: the active Search date-filter sub-view (Custom date/range modifier).
+     * The Search popover unmounts when the year picker screen opens, so this breadcrumb lets it restore the sub-view on return.
+     * Only honoured while a `search*`-context year write-back is pending, and cleared when the user leaves the sub-view.
+     */
+    CALENDAR_PICKER_SELECTED_DATE_MODIFIER: 'calendarPickerSelectedDateModifier',
+
     /** Stores the route to open after changing app permission from settings */
     LAST_ROUTE: 'lastRoute',
 
@@ -1654,6 +1664,8 @@ type OnyxValuesMapping = {
     [ONYXKEYS.IMPORTED_SPREADSHEET]: OnyxTypes.ImportedSpreadsheet;
     [ONYXKEYS.IMPORTED_SPREADSHEET_MEMBER_DATA]: OnyxTypes.ImportedSpreadsheetMemberData[];
     [ONYXKEYS.IMPORTED_SPREADSHEET_MEMBER_ROLE]: ValueOf<typeof CONST.POLICY.ROLE>;
+    [ONYXKEYS.CALENDAR_PICKER_SELECTED_YEAR]: {contextID: string; year: number};
+    [ONYXKEYS.CALENDAR_PICKER_SELECTED_DATE_MODIFIER]: string;
     [ONYXKEYS.LAST_ROUTE]: string;
     [ONYXKEYS.IS_USING_IMPORTED_STATE]: boolean;
     [ONYXKEYS.NVP_EXPENSIFY_COMPANY_CARDS_CUSTOM_NAMES]: Record<string, string>;

src/ROUTES.ts

@@ -156,6 +156,18 @@ const DYNAMIC_ROUTES = {
         path: 'imported-members-role',
         entryScreens: [SCREENS.WORKSPACE.MEMBERS_IMPORTED_CONFIRMATION],
     },
+    YEAR_SELECTOR: {
+        path: 'year-selector',
+        queryParams: ['contextID', 'currentYear', 'minYear', 'maxYear'],
+        // CalendarPicker is a generic component reached from many screens (date input fields,
+        // DateSelectPopup, RangeDatePicker, DatePresetFilterBase, ScheduleCallPage, ...), and the
+        // previous in-place YearPickerModal had no screen restriction. Use '*' so the year selector
+        // remains reachable from every CalendarPicker host and doesn't silently break when new
+        // date-input screens are added (matches KEYBOARD_SHORTCUTS / EXIT_SURVEY_* generic flows).
+        entryScreens: ['*'],
+        getRoute: ({contextID, currentYear, minYear, maxYear}: {contextID: string; currentYear: number; minYear: number; maxYear: number}) =>
+            getUrlWithParams('year-selector', {contextID, currentYear, minYear, maxYear}),
+    },
     REPORT_SETTINGS: {
         path: 'report-settings',
         entryScreens: [SCREENS.REPORT_DETAILS.DYNAMIC_ROOT],

src/SCREENS.ts

@@ -95,6 +95,7 @@ const SCREENS = {
         HELP: 'Settings_Help',
         DYNAMIC_VERIFY_ACCOUNT: 'Dynamic_Verify_Account',
         DYNAMIC_ADD_BANK_ACCOUNT_VERIFY_ACCOUNT: 'Dynamic_Add_Bank_Account_Verify_Account',
+        DYNAMIC_YEAR_SELECTOR: 'Dynamic_Year_Selector',
         DYNAMIC_EXIT_SURVEY_CONFIRM: 'Dynamic_ExitSurvey_Confirm',
         DYNAMIC_EXIT_SURVEY_REASON: 'Dynamic_ExitSurvey_Reason',
         DYNAMIC_KEYBOARD_SHORTCUTS: 'Dynamic_Keyboard_Shortcuts',

src/components/DatePicker/CalendarPicker/DynamicYearSelectorPage.tsx

@@ -0,0 +1,100 @@
+import HeaderWithBackButton from '@components/HeaderWithBackButton';
+import ScreenWrapper from '@components/ScreenWrapper';
+import SelectionList from '@components/SelectionList';
+import SingleSelectListItem from '@components/SelectionList/ListItem/SingleSelectListItem';
+
+import useDynamicBackPath from '@hooks/useDynamicBackPath';
+import useLocalize from '@hooks/useLocalize';
+import useThemeStyles from '@hooks/useThemeStyles';
+
+import {setCalendarPickerSelectedYear} from '@libs/actions/CalendarPicker';
+import Navigation from '@libs/Navigation/Navigation';
+import type {PlatformStackScreenProps} from '@libs/Navigation/PlatformStackNavigation/types';
+
+import type {SettingsNavigatorParamList} from '@navigation/types';
+
+import CONST from '@src/CONST';
+import {DYNAMIC_ROUTES} from '@src/ROUTES';
+import type SCREENS from '@src/SCREENS';
+
+import React, {useMemo, useState} from 'react';
+import {Keyboard} from 'react-native';
+
+import type CalendarPickerListItem from './types';
+
+type DynamicYearSelectorPageProps = PlatformStackScreenProps<SettingsNavigatorParamList, typeof SCREENS.SETTINGS.DYNAMIC_YEAR_SELECTOR>;
+
+function DynamicYearSelectorPage({route}: DynamicYearSelectorPageProps) {
+    const styles = useThemeStyles();
+    const {translate} = useLocalize();
+    const backPath = useDynamicBackPath(DYNAMIC_ROUTES.YEAR_SELECTOR.path);
+
+    const {contextID} = route.params;
+    const currentYear = Number(route.params.currentYear) || new Date().getFullYear();
+    const minYear = Number(route.params.minYear) || CONST.CALENDAR_PICKER.MIN_YEAR;
+    const maxYear = Number(route.params.maxYear) || CONST.CALENDAR_PICKER.MAX_YEAR;
+
+    const [searchText, setSearchText] = useState('');
+
+    const years: CalendarPickerListItem[] = useMemo(
+        () =>
+            Array.from({length: maxYear - minYear + 1}, (value, index) => index + minYear).map((year) => ({
+                text: year.toString(),
+                value: year,
+                keyForList: year.toString(),
+                isSelected: year === currentYear,
+            })),
+        [minYear, maxYear, currentYear],
+    );
+
+    const {data, headerMessage} = useMemo(() => {
+        const yearsList = searchText === '' ? years : years.filter((year) => year.text?.includes(searchText));
+        return {
+            headerMessage: !yearsList.length ? translate('common.noResultsFound') : '',
+            data: yearsList.sort((a, b) => b.value - a.value),
+        };
+    }, [years, searchText, translate]);
+
+    const textInputOptions = useMemo(
+        () => ({
+            label: translate('yearPickerPage.selectYear'),
+            value: searchText,
+            onChangeText: (text: string) => setSearchText(text.replaceAll(CONST.REGEX.NON_NUMERIC, '').trim()),
+            headerMessage,
+            maxLength: 4,
+            inputMode: CONST.INPUT_MODE.NUMERIC,
+        }),
+        [headerMessage, searchText, translate],
+    );
+
+    return (
+        <ScreenWrapper
+            style={[styles.pb0]}
+            includePaddingTop={false}
+            enableEdgeToEdgeBottomSafeAreaPadding
+            testID="DynamicYearSelectorPage"
+        >
+            <HeaderWithBackButton
+                title={translate('yearPickerPage.year')}
+                onBackButtonPress={() => Navigation.goBack(backPath)}
+            />
+            <SelectionList
+                data={data}
+                ListItem={SingleSelectListItem}
+                onSelectRow={(option) => {
+                    Keyboard.dismiss();
+                    setCalendarPickerSelectedYear(contextID, option.value);
+                    Navigation.goBack(backPath);
+                }}
+                textInputOptions={textInputOptions}
+                initiallyFocusedItemKey={currentYear.toString()}
+                disableMaintainingScrollPosition
+                addBottomSafeAreaPadding
+                shouldStopPropagation
+                showScrollIndicator
+            />
+        </ScreenWrapper>
+    );
+}
+
+export default DynamicYearSelectorPage;