@mui/x-date-pickers 8.0.0-alpha.6 → 8.0.0-alpha.8

package/modern/internals/hooks/usePicker/usePickerValue.js

@@ -5,106 +5,6 @@ import { useOpenState } from "../useOpenState.js";
 import { useLocalizationContext, useUtils } from "../useUtils.js";
 import { useValidation } from "../../../validation/index.js";
 import { useValueWithTimezone } from "../useValueWithTimezone.js";
-/**
- * Decide if the new value should be published
- * The published value will be passed to `onChange` if defined.
- */
-const shouldPublishValue = params => {
-  const {
-    action,
-    hasChanged,
-    dateState,
-    isControlled
-  } = params;
-  const isCurrentValueTheDefaultValue = !isControlled && !dateState.hasBeenModifiedSinceMount;
-
-  // The field is responsible for only calling `onChange` when needed.
-  if (action.name === 'setValueFromField') {
-    return true;
-  }
-  if (action.name === 'setValueFromAction') {
-    // If the component is not controlled, and the value has not been modified since the mount,
-    // Then we want to publish the default value whenever the user pressed the "Accept", "Today" or "Clear" button.
-    if (isCurrentValueTheDefaultValue && ['accept', 'today', 'clear'].includes(action.pickerAction)) {
-      return true;
-    }
-    return hasChanged(dateState.lastPublishedValue);
-  }
-  if (action.name === 'setValueFromView' && action.selectionState !== 'shallow') {
-    // On the first view,
-    // If the value is not controlled, then clicking on any value (including the one equal to `defaultValue`) should call `onChange`
-    if (isCurrentValueTheDefaultValue) {
-      return true;
-    }
-    return hasChanged(dateState.lastPublishedValue);
-  }
-  if (action.name === 'setValueFromShortcut') {
-    // On the first view,
-    // If the value is not controlled, then clicking on any value (including the one equal to `defaultValue`) should call `onChange`
-    if (isCurrentValueTheDefaultValue) {
-      return true;
-    }
-    return hasChanged(dateState.lastPublishedValue);
-  }
-  return false;
-};
-
-/**
- * Decide if the new value should be committed.
- * The committed value will be passed to `onAccept` if defined.
- * It will also be used as a reset target when calling the `cancel` picker action (when clicking on the "Cancel" button).
- */
-const shouldCommitValue = params => {
-  const {
-    action,
-    hasChanged,
-    dateState,
-    isControlled,
-    closeOnSelect
-  } = params;
-  const isCurrentValueTheDefaultValue = !isControlled && !dateState.hasBeenModifiedSinceMount;
-  if (action.name === 'setValueFromAction') {
-    // If the component is not controlled, and the value has not been modified since the mount,
-    // Then we want to commit the default value whenever the user pressed the "Accept", "Today" or "Clear" button.
-    if (isCurrentValueTheDefaultValue && ['accept', 'today', 'clear'].includes(action.pickerAction)) {
-      return true;
-    }
-    return hasChanged(dateState.lastCommittedValue);
-  }
-  if (action.name === 'setValueFromView' && action.selectionState === 'finish' && closeOnSelect) {
-    // On picker where the 1st view is also the last view,
-    // If the value is not controlled, then clicking on any value (including the one equal to `defaultValue`) should call `onAccept`
-    if (isCurrentValueTheDefaultValue) {
-      return true;
-    }
-    return hasChanged(dateState.lastCommittedValue);
-  }
-  if (action.name === 'setValueFromShortcut') {
-    return action.changeImportance === 'accept' && hasChanged(dateState.lastCommittedValue);
-  }
-  return false;
-};
-
-/**
- * Decide if the picker should be closed after the value is updated.
- */
-const shouldClosePicker = params => {
-  const {
-    action,
-    closeOnSelect
-  } = params;
-  if (action.name === 'setValueFromAction') {
-    return true;
-  }
-  if (action.name === 'setValueFromView') {
-    return action.selectionState === 'finish' && closeOnSelect;
-  }
-  if (action.name === 'setValueFromShortcut') {
-    return action.changeImportance === 'accept';
-  }
-  return false;
-};
-
 /**
  * Manage the value lifecycle of all the pickers.
  */
@@ -112,7 +12,6 @@ export const usePickerValue = ({
   props,
   valueManager,
   valueType,
-  variant,
   validator
 }) => {
   const {
@@ -120,7 +19,7 @@ export const usePickerValue = ({
     onChange,
     value: inValueWithoutRenderTimezone,
     defaultValue: inDefaultValue,
-    closeOnSelect = variant === 'desktop',
+    closeOnSelect = false,
     timezone: timezoneProp,
     referenceDate
   } = props;
@@ -200,43 +99,49 @@ export const usePickerValue = ({
     value: dateState.draft,
     onError: props.onError
   });
-  const updateDate = useEventCallback(action => {
-    const updaterParams = {
-      action,
-      dateState,
-      hasChanged: comparison => !valueManager.areValuesEqual(utils, action.value, comparison),
-      isControlled,
-      closeOnSelect
-    };
-    const shouldPublish = shouldPublishValue(updaterParams);
-    const shouldCommit = shouldCommitValue(updaterParams);
-    const shouldClose = shouldClosePicker(updaterParams);
+  const setValue = useEventCallback((newValue, options) => {
+    const {
+      changeImportance = 'accept',
+      skipPublicationIfPristine = false,
+      validationError,
+      shortcut
+    } = options ?? {};
+    let shouldPublish;
+    let shouldCommit;
+    if (!skipPublicationIfPristine && !isControlled && !dateState.hasBeenModifiedSinceMount) {
+      // If the value is not controlled and the value has never been modified before,
+      // Then clicking on any value (including the one equal to `defaultValue`) should call `onChange` and `onAccept`
+      shouldPublish = true;
+      shouldCommit = changeImportance === 'accept';
+    } else {
+      shouldPublish = !valueManager.areValuesEqual(utils, newValue, dateState.lastPublishedValue);
+      shouldCommit = changeImportance === 'accept' && !valueManager.areValuesEqual(utils, newValue, dateState.lastCommittedValue);
+    }
     setDateState(prev => _extends({}, prev, {
-      draft: action.value,
-      lastPublishedValue: shouldPublish ? action.value : prev.lastPublishedValue,
-      lastCommittedValue: shouldCommit ? action.value : prev.lastCommittedValue,
+      draft: newValue,
+      lastPublishedValue: shouldPublish ? newValue : prev.lastPublishedValue,
+      lastCommittedValue: shouldCommit ? newValue : prev.lastCommittedValue,
       hasBeenModifiedSinceMount: true
     }));
     let cachedContext = null;
     const getContext = () => {
       if (!cachedContext) {
-        const validationError = action.name === 'setValueFromField' ? action.context.validationError : getValidationErrorForNewValue(action.value);
         cachedContext = {
-          validationError
+          validationError: validationError == null ? getValidationErrorForNewValue(newValue) : validationError
         };
-        if (action.name === 'setValueFromShortcut') {
-          cachedContext.shortcut = action.shortcut;
+        if (shortcut) {
+          cachedContext.shortcut = shortcut;
         }
       }
       return cachedContext;
     };
     if (shouldPublish) {
-      handleValueChange(action.value, getContext());
+      handleValueChange(newValue, getContext());
     }
     if (shouldCommit && onAccept) {
-      onAccept(action.value, getContext());
+      onAccept(newValue, getContext());
     }
-    if (shouldClose) {
+    if (changeImportance === 'accept') {
       setOpen(false);
     }
   });
@@ -251,33 +156,6 @@ export const usePickerValue = ({
       hasBeenModifiedSinceMount: true
     }));
   }
-  const handleChange = useEventCallback((newValue, selectionState = 'partial') => updateDate({
-    name: 'setValueFromView',
-    value: newValue,
-    selectionState
-  }));
-  const handleSelectShortcut = useEventCallback((newValue, changeImportance, shortcut) => updateDate({
-    name: 'setValueFromShortcut',
-    value: newValue,
-    changeImportance,
-    shortcut
-  }));
-  const handleChangeFromField = useEventCallback((newValue, context) => updateDate({
-    name: 'setValueFromField',
-    value: newValue,
-    context
-  }));
-  const fieldResponse = {
-    value: dateState.draft,
-    onChange: handleChangeFromField
-  };
-  const valueWithoutError = React.useMemo(() => valueManager.cleanValue(utils, dateState.draft), [utils, valueManager, dateState.draft]);
-  const viewResponse = {
-    value: valueWithoutError,
-    onChange: handleChange,
-    open,
-    setOpen
-  };
   const isValid = testedValue => {
     const error = validator({
       adapter,
@@ -287,62 +165,61 @@ export const usePickerValue = ({
     });
     return !valueManager.hasError(error);
   };
-  const layoutResponse = {
-    value: valueWithoutError,
-    onChange: handleChange,
-    onSelectShortcut: handleSelectShortcut,
-    isValid
-  };
-  const clearValue = useEventCallback(() => updateDate({
-    value: valueManager.emptyValue,
-    name: 'setValueFromAction',
-    pickerAction: 'clear'
-  }));
-  const setValueToToday = useEventCallback(() => updateDate({
-    value: valueManager.getTodayValue(utils, timezone, valueType),
-    name: 'setValueFromAction',
-    pickerAction: 'today'
-  }));
-  const acceptValueChanges = useEventCallback(() => updateDate({
-    value: dateState.lastPublishedValue,
-    name: 'setValueFromAction',
-    pickerAction: 'accept'
-  }));
-  const cancelValueChanges = useEventCallback(() => updateDate({
-    value: dateState.lastCommittedValue,
-    name: 'setValueFromAction',
-    pickerAction: 'cancel'
+  const clearValue = useEventCallback(() => setValue(valueManager.emptyValue));
+  const setValueToToday = useEventCallback(() => setValue(valueManager.getTodayValue(utils, timezone, valueType)));
+  const acceptValueChanges = useEventCallback(() => setValue(dateState.lastPublishedValue));
+  const cancelValueChanges = useEventCallback(() => setValue(dateState.lastCommittedValue, {
+    skipPublicationIfPristine: true
   }));
   const dismissViews = useEventCallback(() => {
-    updateDate({
-      value: dateState.lastPublishedValue,
-      name: 'setValueFromAction',
-      pickerAction: 'dismiss'
+    setValue(dateState.lastPublishedValue, {
+      skipPublicationIfPristine: true
     });
   });
+  const setValueFromView = useEventCallback((newValue, selectionState = 'partial') => {
+    // TODO: Expose a new method (private?) like `setView` that only updates the draft value.
+    if (selectionState === 'shallow') {
+      setDateState(prev => _extends({}, prev, {
+        draft: newValue,
+        hasBeenModifiedSinceMount: true
+      }));
+    }
+    setValue(newValue, {
+      changeImportance: selectionState === 'finish' && closeOnSelect ? 'accept' : 'set'
+    });
+  });
+  const valueWithoutError = React.useMemo(() => valueManager.cleanValue(utils, dateState.draft), [utils, valueManager, dateState.draft]);
+  const viewResponse = {
+    value: valueWithoutError,
+    onChange: setValueFromView,
+    open,
+    setOpen
+  };
   const actionsContextValue = React.useMemo(() => ({
+    setValue,
     setOpen,
     clearValue,
     setValueToToday,
     acceptValueChanges,
     cancelValueChanges
-  }), [setOpen, clearValue, setValueToToday, acceptValueChanges, cancelValueChanges]);
+  }), [setValue, setOpen, clearValue, setValueToToday, acceptValueChanges, cancelValueChanges]);
   const contextValue = React.useMemo(() => _extends({}, actionsContextValue, {
+    value: dateState.draft,
+    timezone,
     open
-  }), [actionsContextValue, open]);
+  }), [actionsContextValue, timezone, open, dateState.draft]);
   const privateContextValue = React.useMemo(() => ({
     dismissViews
   }), [dismissViews]);
   const providerParams = {
-    value: valueWithoutError,
+    value: dateState.draft,
     contextValue,
     actionsContextValue,
-    privateContextValue
+    privateContextValue,
+    isValidContextValue: isValid
   };
   return {
-    fieldProps: fieldResponse,
     viewProps: viewResponse,
-    layoutProps: layoutResponse,
     provider: providerParams
   };
 };

package/modern/internals/hooks/usePicker/usePickerViews.js

@@ -14,7 +14,7 @@ import { isTimeView } from "../../utils/time-utils.js";
 /**
  * Props used to handle the value of the pickers.
  */
-
+import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Manage the views of all the pickers:
  * - Handles the view switch
@@ -24,9 +24,8 @@ import { isTimeView } from "../../utils/time-utils.js";
 export const usePickerViews = ({
   props,
   propsFromPickerValue,
-  additionalViewProps,
   autoFocusView,
-  rendererInterceptor,
+  rendererInterceptor: RendererInterceptor,
   fieldRef
 }) => {
   const {
@@ -124,15 +123,18 @@ export const usePickerViews = ({
     setFocusedView(newView, true);
   }, [open]); // eslint-disable-line react-hooks/exhaustive-deps
 
-  const contextValue = React.useMemo(() => ({
+  const actionsContextValue = React.useMemo(() => ({
+    setView
+  }), [setView]);
+  const contextValue = React.useMemo(() => _extends({}, actionsContextValue, {
     views,
-    view: popperView,
-    onViewChange: setView
-  }), [views, popperView, setView]);
+    view: popperView
+  }), [actionsContextValue, views, popperView]);
   const providerParams = {
     hasUIView,
     views,
-    contextValue
+    contextValue,
+    actionsContextValue
   };
   return {
     shouldRestoreFocus,
@@ -145,7 +147,7 @@ export const usePickerViews = ({
       if (renderer == null) {
         return null;
       }
-      const rendererProps = _extends({}, propsToForwardToView, additionalViewProps, {
+      const rendererProps = _extends({}, propsToForwardToView, {
         views,
         timezone,
         value,
@@ -157,8 +159,12 @@ export const usePickerViews = ({
         showViewSwitcher: timeViewsCount > 1,
         timeViewsCount
       });
-      if (rendererInterceptor) {
-        return rendererInterceptor(viewRenderers, popperView, rendererProps);
+      if (RendererInterceptor) {
+        return /*#__PURE__*/_jsx(RendererInterceptor, {
+          viewRenderers: viewRenderers,
+          popperView: popperView,
+          rendererProps: rendererProps
+        });
       }
       return renderer(rendererProps);
     }

package/modern/internals/hooks/useStaticPicker/useStaticPicker.js

@@ -39,20 +39,17 @@ export const useStaticPicker = _ref => {
     autoFocus
   } = props;
   const {
-    layoutProps,
     providerProps,
     renderCurrentView
   } = usePicker(_extends({}, pickerParams, {
     props,
     autoFocusView: autoFocus ?? false,
-    fieldRef: undefined,
     localeText,
-    additionalViewProps: {},
     variant: displayStaticWrapperAs
   }));
   const Layout = slots?.layout ?? PickerStaticLayout;
   const renderPicker = () => /*#__PURE__*/_jsx(PickerProvider, _extends({}, providerProps, {
-    children: /*#__PURE__*/_jsx(Layout, _extends({}, layoutProps, slotProps?.layout, {
+    children: /*#__PURE__*/_jsx(Layout, _extends({}, slotProps?.layout, {
       slots: slots,
       slotProps: slotProps,
       sx: [...(Array.isArray(sx) ? sx : [sx]), ...(Array.isArray(slotProps?.layout?.sx) ? slotProps.layout.sx : [slotProps?.layout?.sx])],

package/modern/internals/hooks/useUtils.js

@@ -19,7 +19,7 @@ export const useUtils = () => useLocalizationContext().utils;
 export const useDefaultDates = () => useLocalizationContext().defaultDates;
 export const useNow = timezone => {
   const utils = useUtils();
-  const now = React.useRef();
+  const now = React.useRef(undefined);
   if (now.current === undefined) {
     now.current = utils.date(undefined, timezone);
   }

package/modern/internals/index.js

@@ -1,4 +1,5 @@
 export { PickersArrowSwitcher } from "./components/PickersArrowSwitcher/PickersArrowSwitcher.js";
+export { PickerFieldUI, PickerFieldUIContextProvider, cleanFieldResponse, useFieldTextFieldProps } from "./components/PickerFieldUI.js";
 export { PickerProvider } from "./components/PickerProvider.js";
 export { PickersModalDialog } from "./components/PickersModalDialog.js";
 export { PickersPopper } from "./components/PickersPopper.js";
@@ -11,7 +12,7 @@ export { pickersPopperClasses } from "./components/pickersPopperClasses.js";
 export { PickersToolbarButton } from "./components/PickersToolbarButton.js";
 export { DAY_MARGIN, DIALOG_WIDTH, VIEW_HEIGHT } from "./constants/dimensions.js";
 export { useControlledValueWithTimezone } from "./hooks/useValueWithTimezone.js";
-export { useField, createDateStrForV7HiddenInputFromSections, createDateStrForV6InputFromSections } from "./hooks/useField/index.js";
+export { useField, useFieldInternalPropsWithDefaults, createDateStrForV7HiddenInputFromSections, createDateStrForV6InputFromSections } from "./hooks/useField/index.js";
 export { useFieldOwnerState } from "./hooks/useFieldOwnerState.js";
 export { usePicker } from "./hooks/usePicker/index.js";
 export { usePickerPrivateContext } from "./hooks/usePickerPrivateContext.js";
@@ -20,15 +21,16 @@ export { useToolbarOwnerState } from "./hooks/useToolbarOwnerState.js";
 export { useLocalizationContext, useDefaultDates, useUtils, useNow } from "./hooks/useUtils.js";
 export { useViews } from "./hooks/useViews.js";
 export { usePreviousMonthDisabled, useNextMonthDisabled } from "./hooks/date-helpers-hooks.js";
-export { convertFieldResponseIntoMuiTextFieldProps } from "./utils/convertFieldResponseIntoMuiTextFieldProps.js";
 export { applyDefaultDate, replaceInvalidDateByNull, areDatesEqual, getTodayDate, isDatePickerView, mergeDateAndTime, formatMeridiem } from "./utils/date-utils.js";
 export { resolveTimeViewsResponse, resolveDateTimeFormat } from "./utils/date-time-utils.js";
 export { getDefaultReferenceDate } from "./utils/getDefaultReferenceDate.js";
 export { executeInTheNextEventLoopTick, getActiveElement, onSpaceOrEnter, DEFAULT_DESKTOP_MODE_MEDIA_QUERY } from "./utils/utils.js";
-export { useDefaultizedDateField, useDefaultizedTimeField, useDefaultizedDateTimeField } from "./hooks/defaultizedFieldProps.js";
 export { useDefaultReduceAnimations } from "./hooks/useDefaultReduceAnimations.js";
 export { applyDefaultViewProps } from "./utils/views.js";
 export { DayCalendar } from "../DateCalendar/DayCalendar.js";
 export { useCalendarState } from "../DateCalendar/useCalendarState.js";
 export { isInternalTimeView, isTimeView } from "./utils/time-utils.js";
-export { DateTimePickerToolbarOverrideContext } from "../DateTimePicker/DateTimePickerToolbar.js";
+export { DateTimePickerToolbarOverrideContext } from "../DateTimePicker/DateTimePickerToolbar.js";
+export { getDateFieldInternalPropsDefaults } from "../managers/useDateManager.js";
+export { getTimeFieldInternalPropsDefaults } from "../managers/useTimeManager.js";
+export { getDateTimeFieldInternalPropsDefaults } from "../managers/useDateTimeManager.js";

package/modern/internals/models/index.js

@@ -1,4 +1,5 @@
 export * from "./fields.js";
 export * from "./common.js";
 export * from "./value.js";
-export * from "./formProps.js";
+export * from "./formProps.js";
+export * from "./manager.js";

package/modern/internals/models/manager.js

@@ -0,0 +1 @@
+export {};

package/modern/internals/utils/date-utils.js

@@ -58,7 +58,7 @@ export const findClosestEnabledDate = ({
   }
   return null;
 };
-export const replaceInvalidDateByNull = (utils, value) => value == null || !utils.isValid(value) ? null : value;
+export const replaceInvalidDateByNull = (utils, value) => !utils.isValid(value) ? null : value;
 export const applyDefaultDate = (utils, value, defaultValue) => {
   if (value == null || !utils.isValid(value)) {
     return defaultValue;

package/modern/internals/utils/valueManagers.js

@@ -12,7 +12,7 @@ export const singleItemValueManager = {
         referenceDate
       } = _ref,
       params = _objectWithoutPropertiesLoose(_ref, _excluded);
-    if (value != null && params.utils.isValid(value)) {
+    if (params.utils.isValid(value)) {
       return value;
     }
     if (referenceDate != null) {
@@ -25,11 +25,11 @@ export const singleItemValueManager = {
   isSameError: (a, b) => a === b,
   hasError: error => error != null,
   defaultErrorState: null,
-  getTimezone: (utils, value) => value == null || !utils.isValid(value) ? null : utils.getTimezone(value),
+  getTimezone: (utils, value) => utils.isValid(value) ? utils.getTimezone(value) : null,
   setTimezone: (utils, timezone, value) => value == null ? null : utils.setTimezone(value, timezone)
 };
 export const singleItemFieldValueManager = {
-  updateReferenceValue: (utils, value, prevReferenceValue) => value == null || !utils.isValid(value) ? prevReferenceValue : value,
+  updateReferenceValue: (utils, value, prevReferenceValue) => !utils.isValid(value) ? prevReferenceValue : value,
   getSectionsFromValue: (utils, date, prevSections, getSectionsFromDate) => {
     const shouldReUsePrevDateSections = !utils.isValid(date) && !!prevSections;
     if (shouldReUsePrevDateSections) {
@@ -45,7 +45,7 @@ export const singleItemFieldValueManager = {
     getSections: sections => sections,
     getNewValuesFromNewActiveDate: newActiveDate => ({
       value: newActiveDate,
-      referenceValue: newActiveDate == null || !utils.isValid(newActiveDate) ? state.referenceValue : newActiveDate
+      referenceValue: utils.isValid(newActiveDate) ? newActiveDate : state.referenceValue
     })
   }),
   parseValueStr: (valueStr, referenceValue, parseDate) => parseDate(valueStr.trim(), referenceValue)

package/modern/locales/index.js

@@ -36,4 +36,5 @@ export * from "./urPK.js";
 export * from "./viVN.js";
 export * from "./zhCN.js";
 export * from "./zhHK.js";
+export * from "./zhTW.js";
 export * from "./utils/pickersLocaleTextApi.js";

package/modern/locales/nbNO.js

@@ -16,11 +16,10 @@ const nbNOPickers = {
   // DateRange labels
   start: 'Start',
   end: 'Slutt',
-  // startDate: 'Start date',
-  // startTime: 'Start time',
-  // endDate: 'End date',
-  // endTime: 'End time',
-
+  startDate: 'Startdato',
+  startTime: 'Starttid',
+  endDate: 'Sluttdato',
+  endTime: 'Slutttid',
   // Action bar
   cancelButtonLabel: 'Avbryt',
   clearButtonLabel: 'Fjern',
@@ -46,8 +45,7 @@ const nbNOPickers = {
   // Open picker labels
   openDatePickerDialogue: formattedDate => formattedDate ? `Velg dato, valgt dato er ${formattedDate}` : 'Velg dato',
   openTimePickerDialogue: formattedTime => formattedTime ? `Velg tid, valgt tid er ${formattedTime}` : 'Velg tid',
-  // fieldClearLabel: 'Clear',
-
+  fieldClearLabel: 'Slett',
   // Table labels
   timeTableLabel: 'velg tid',
   dateTableLabel: 'velg dato',
@@ -59,19 +57,17 @@ const nbNOPickers = {
   fieldHoursPlaceholder: () => 'tt',
   fieldMinutesPlaceholder: () => 'mm',
   fieldSecondsPlaceholder: () => 'ss',
-  fieldMeridiemPlaceholder: () => 'aa'
-
+  fieldMeridiemPlaceholder: () => 'aa',
   // View names
-  // year: 'Year',
-  // month: 'Month',
-  // day: 'Day',
-  // weekDay: 'Week day',
-  // hours: 'Hours',
-  // minutes: 'Minutes',
-  // seconds: 'Seconds',
-  // meridiem: 'Meridiem',
-
+  year: 'År',
+  month: 'Måned',
+  day: 'Dag',
+  weekDay: 'Ukedag',
+  hours: 'Timer',
+  minutes: 'Minutter',
+  seconds: 'Sekunder',
+  meridiem: 'Meridiem',
   // Common
-  // empty: 'Empty',
+  empty: 'Tøm'
 };
 export const nbNO = getPickersLocalization(nbNOPickers);

package/modern/locales/utils/getPickersLocalization.js

@@ -9,17 +9,4 @@ export const getPickersLocalization = pickersTranslations => {
       }
     }
   };
-};
-export const buildGetOpenDialogAriaText = params => {
-  const {
-    utils,
-    formatKey,
-    contextTranslation,
-    propsTranslation
-  } = params;
-  return value => {
-    const formattedValue = value !== null && utils.isValid(value) ? utils.format(value, formatKey) : null;
-    const translation = propsTranslation ?? contextTranslation;
-    return translation(formattedValue);
-  };
 };

package/modern/locales/zhTW.js

@@ -0,0 +1,73 @@
+import { getPickersLocalization } from "./utils/getPickersLocalization.js";
+const views = {
+  hours: '小時',
+  minutes: '分鐘',
+  seconds: '秒',
+  meridiem: '十二小時制'
+};
+const zhTWPickers = {
+  // Calendar navigation
+  previousMonth: '上個月',
+  nextMonth: '下個月',
+  // View navigation
+  openPreviousView: '前一個視圖',
+  openNextView: '下一個視圖',
+  calendarViewSwitchingButtonAriaLabel: view => view === 'year' ? '年視圖已打開，切換為日曆視圖' : '日曆視圖已打開，切換為年視圖',
+  // DateRange labels
+  start: '開始',
+  end: '結束',
+  startDate: '開始日期',
+  startTime: '開始時間',
+  endDate: '結束日期',
+  endTime: '結束時間',
+  // Action bar
+  cancelButtonLabel: '取消',
+  clearButtonLabel: '清除',
+  okButtonLabel: '確認',
+  todayButtonLabel: '今天',
+  // Toolbar titles
+  datePickerToolbarTitle: '選擇日期',
+  dateTimePickerToolbarTitle: '選擇日期和時間',
+  timePickerToolbarTitle: '選擇時間',
+  dateRangePickerToolbarTitle: '選擇時間範圍',
+  // Clock labels
+  clockLabelText: (view, formattedTime) => `選擇 ${views[view]}. ${!formattedTime ? '未選擇時間' : `已選擇${formattedTime}`}`,
+  hoursClockNumberText: hours => `${hours}小時`,
+  minutesClockNumberText: minutes => `${minutes}分鐘`,
+  secondsClockNumberText: seconds => `${seconds}秒`,
+  // Digital clock labels
+  selectViewText: view => `選擇 ${views[view]}`,
+  // Calendar labels
+  calendarWeekNumberHeaderLabel: '週數',
+  calendarWeekNumberHeaderText: '#',
+  calendarWeekNumberAriaLabelText: weekNumber => `第${weekNumber}週`,
+  calendarWeekNumberText: weekNumber => `${weekNumber}`,
+  // Open picker labels
+  openDatePickerDialogue: formattedDate => formattedDate ? `選擇日期，已選擇${formattedDate}` : '選擇日期',
+  openTimePickerDialogue: formattedTime => formattedTime ? `選擇時間，已選擇${formattedTime}` : '選擇時間',
+  fieldClearLabel: '清除',
+  // Table labels
+  timeTableLabel: '選擇時間',
+  dateTableLabel: '選擇日期',
+  // Field section placeholders
+  fieldYearPlaceholder: params => 'Y'.repeat(params.digitAmount),
+  fieldMonthPlaceholder: params => params.contentType === 'letter' ? 'MMMM' : 'MM',
+  fieldDayPlaceholder: () => 'DD',
+  fieldWeekDayPlaceholder: params => params.contentType === 'letter' ? 'EEEE' : 'EE',
+  fieldHoursPlaceholder: () => 'hh',
+  fieldMinutesPlaceholder: () => 'mm',
+  fieldSecondsPlaceholder: () => 'ss',
+  fieldMeridiemPlaceholder: () => 'aa',
+  // View names
+  year: '年份',
+  month: '月份',
+  day: '日期',
+  weekDay: '星期',
+  hours: '時',
+  minutes: '分',
+  seconds: '秒',
+  meridiem: '十二小時制',
+  // Common
+  empty: '空'
+};
+export const zhTW = getPickersLocalization(zhTWPickers);