@mui/x-date-pickers 8.0.0-alpha.0 → 8.0.0-alpha.10

package/internals/models/props/toolbar.d.ts

@@ -1,26 +1,7 @@
 import * as React from 'react';
 import { SxProps } from '@mui/system';
 import { Theme } from '@mui/material/styles';
-import { DateOrTimeViewWithMeridiem } from '../common';
-import { FormProps } from '../formProps';
-export interface BaseToolbarProps<TValue, TView extends DateOrTimeViewWithMeridiem> extends ExportedBaseToolbarProps, FormProps {
-    isLandscape: boolean;
-    onChange: (newValue: TValue) => void;
-    value: TValue;
-    /**
-     * Currently visible picker view.
-     */
-    view: TView;
-    /**
-     * Callback called when a toolbar is clicked
-     * @template TView
-     * @param {TView} view The view to open
-     */
-    onViewChange: (view: TView) => void;
-    /**
-     * Available views.
-     */
-    views: readonly TView[];
+export interface BaseToolbarProps extends ExportedBaseToolbarProps {
     titleId?: string;
 }
 export interface ExportedBaseToolbarProps {

package/internals/models/value.d.ts

@@ -1,3 +1,12 @@
 import { PickerValidDate } from '../../models/pickers';
+/**
+ * The type that the `value` and `defaultValue` props can receive on non-range components (date, time and date-time).
+ */
 export type PickerValue = PickerValidDate | null;
+/**
+ * The type that the `value` and `defaultValue` props can receive on range components (date-range, time-range and date-time-range).
+ */
 export type PickerRangeValue = [PickerValidDate | null, PickerValidDate | null];
+export type PickerNonNullableRangeValue = [PickerValidDate, PickerValidDate];
+export type PickerValidValue = PickerValue | PickerRangeValue;
+export type InferNonNullablePickerValue<TValue extends PickerValidValue> = TValue extends PickerRangeValue ? TValue extends PickerValue ? PickerValidDate | PickerNonNullableRangeValue : PickerNonNullableRangeValue : PickerValidDate;

package/internals/utils/date-utils.d.ts

@@ -1,4 +1,4 @@
-import { DateView, FieldValueType, MuiPickersAdapter, PickersTimezone, PickerValidDate } from '../../models';
+import { DateView, MuiPickersAdapter, PickersTimezone, PickerValidDate, PickerValueType } from '../../models';
 import { DateOrTimeViewWithMeridiem } from '../models';
 export declare const mergeDateAndTime: (utils: MuiPickersAdapter, dateParam: PickerValidDate, timeParam: PickerValidDate) => PickerValidDate;
 interface FindClosestDateParams {
@@ -14,9 +14,9 @@ interface FindClosestDateParams {
 export declare const findClosestEnabledDate: ({ date, disableFuture, disablePast, maxDate, minDate, isDateDisabled, utils, timezone, }: FindClosestDateParams) => PickerValidDate | null;
 export declare const replaceInvalidDateByNull: (utils: MuiPickersAdapter, value: PickerValidDate | null) => PickerValidDate | null;
 export declare const applyDefaultDate: (utils: MuiPickersAdapter, value: PickerValidDate | null | undefined, defaultValue: PickerValidDate) => PickerValidDate;
-export declare const areDatesEqual: (utils: MuiPickersAdapter, a: PickerValidDate, b: PickerValidDate) => boolean;
+export declare const areDatesEqual: (utils: MuiPickersAdapter, a: PickerValidDate | null, b: PickerValidDate | null) => boolean;
 export declare const getMonthsInYear: (utils: MuiPickersAdapter, year: PickerValidDate) => PickerValidDate[];
-export declare const getTodayDate: (utils: MuiPickersAdapter, timezone: PickersTimezone, valueType?: FieldValueType) => PickerValidDate;
+export declare const getTodayDate: (utils: MuiPickersAdapter, timezone: PickersTimezone, valueType?: PickerValueType) => PickerValidDate;
 export declare const formatMeridiem: (utils: MuiPickersAdapter, meridiem: "am" | "pm") => string;
 export declare const isDatePickerView: (view: DateOrTimeViewWithMeridiem) => view is DateView;
 export declare const resolveDateFormat: (utils: MuiPickersAdapter, { format, views }: {

package/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/internals/utils/utils.d.ts

@@ -1,3 +1,5 @@
+import { Theme } from '@mui/material/styles';
+import { SxProps, SystemStyleObject } from '@mui/system';
 import * as React from 'react';
 export declare function arrayIncludes<T>(array: T[] | readonly T[], itemOrItems: T | T[]): boolean;
 export declare const onSpaceOrEnter: (innerFn: (ev: React.MouseEvent<any> | React.KeyboardEvent<any>) => void, externalEvent?: (event: React.KeyboardEvent<any>) => void) => (event: React.KeyboardEvent) => void;
@@ -11,3 +13,4 @@ export declare const getActiveElement: (root?: Document | ShadowRoot) => Element
  */
 export declare const getFocusedListItemIndex: (listElement: HTMLUListElement) => number;
 export declare const DEFAULT_DESKTOP_MODE_MEDIA_QUERY = "@media (pointer: fine)";
+export declare function mergeSx(...sxProps: (SxProps<Theme> | undefined)[]): ReadonlyArray<boolean | SystemStyleObject<Theme> | ((theme: Theme) => SystemStyleObject<Theme>)>;

package/internals/utils/utils.js

@@ -43,4 +43,14 @@ export const getFocusedListItemIndex = listElement => {
   const children = Array.from(listElement.children);
   return children.indexOf(getActiveElement(document));
 };
-export const DEFAULT_DESKTOP_MODE_MEDIA_QUERY = '@media (pointer: fine)';
+export const DEFAULT_DESKTOP_MODE_MEDIA_QUERY = '@media (pointer: fine)';
+export function mergeSx(...sxProps) {
+  return sxProps.reduce((acc, sxProp) => {
+    if (Array.isArray(sxProp)) {
+      acc.push(...sxProp);
+    } else if (sxProp != null) {
+      acc.push(sxProp);
+    }
+    return acc;
+  }, []);
+}

package/internals/utils/valueManagers.d.ts

@@ -1,6 +1,7 @@
 import type { PickerValueManager } from '../hooks/usePicker';
-import { DateValidationError, TimeValidationError, DateTimeValidationError, FieldSection } from '../../models';
+import { DateValidationError, TimeValidationError, DateTimeValidationError } from '../../models';
 import type { FieldValueManager } from '../hooks/useField';
-export type SingleItemPickerValueManager<TValue = any, TError extends DateValidationError | TimeValidationError | DateTimeValidationError = any> = PickerValueManager<TValue, TError>;
+import { PickerValue } from '../models';
+export type SingleItemPickerValueManager<TError extends DateValidationError | TimeValidationError | DateTimeValidationError = any> = PickerValueManager<PickerValue, TError>;
 export declare const singleItemValueManager: SingleItemPickerValueManager;
-export declare const singleItemFieldValueManager: FieldValueManager<any, FieldSection>;
+export declare const singleItemFieldValueManager: FieldValueManager<PickerValue>;

package/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/locales/index.d.ts

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

package/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/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/locales/nlNL.js

@@ -16,10 +16,10 @@ const nlNLPickers = {
   // DateRange labels
   start: 'Start',
   end: 'Einde',
-  startDate: 'Start datum',
-  startTime: 'Start tijd',
-  endDate: 'Eind datum',
-  endTime: 'Eind tijd',
+  startDate: 'Startdatum',
+  startTime: 'Starttijd',
+  endDate: 'Einddatum',
+  endTime: 'Eindtijd',
   // Action bar
   cancelButtonLabel: 'Annuleren',
   clearButtonLabel: 'Resetten',
@@ -50,11 +50,11 @@ const nlNLPickers = {
   timeTableLabel: 'kies tijd',
   dateTableLabel: 'kies datum',
   // Field section placeholders
-  fieldYearPlaceholder: params => 'Y'.repeat(params.digitAmount),
+  fieldYearPlaceholder: params => 'J'.repeat(params.digitAmount),
   fieldMonthPlaceholder: params => params.contentType === 'letter' ? 'MMMM' : 'MM',
   fieldDayPlaceholder: () => 'DD',
   fieldWeekDayPlaceholder: params => params.contentType === 'letter' ? 'EEEE' : 'EE',
-  fieldHoursPlaceholder: () => 'hh',
+  fieldHoursPlaceholder: () => 'uu',
   fieldMinutesPlaceholder: () => 'mm',
   fieldSecondsPlaceholder: () => 'ss',
   fieldMeridiemPlaceholder: () => 'aa',
@@ -68,6 +68,6 @@ const nlNLPickers = {
   seconds: 'Seconden',
   meridiem: 'Middag',
   // Common
-  empty: 'Legen'
+  empty: 'Leeg'
 };
 export const nlNL = getPickersLocalization(nlNLPickers);

package/locales/roRO.js

@@ -17,11 +17,10 @@ const roROPickers = {
   // DateRange labels
   start: 'Început',
   end: 'Sfârșit',
-  // startDate: 'Start date',
-  // startTime: 'Start time',
-  // endDate: 'End date',
-  // endTime: 'End time',
-
+  startDate: 'Data de început',
+  startTime: 'Ora de început',
+  endDate: 'Data de sfârșit',
+  endTime: 'Ora de sfârșit',
   // Action bar
   cancelButtonLabel: 'Anulare',
   clearButtonLabel: 'Ștergere',
@@ -55,23 +54,21 @@ const roROPickers = {
   fieldYearPlaceholder: params => 'A'.repeat(params.digitAmount),
   fieldMonthPlaceholder: params => params.contentType === 'letter' ? 'LLLL' : 'LL',
   fieldDayPlaceholder: () => 'ZZ',
-  // fieldWeekDayPlaceholder: params => params.contentType === 'letter' ? 'EEEE' : 'EE',
+  fieldWeekDayPlaceholder: params => params.contentType === 'letter' ? 'ZZZZ' : 'ZZ',
   fieldHoursPlaceholder: () => 'hh',
   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: 'An',
+  month: 'Luna',
+  day: 'Ziua',
+  weekDay: 'Ziua saptămânii',
+  hours: 'Ore',
+  minutes: 'Minute',
+  seconds: 'Secunde',
+  meridiem: 'Meridiem',
   // Common
-  // empty: 'Empty',
+  empty: 'Gol'
 };
 export const roRO = getPickersLocalization(roROPickers);

package/locales/utils/getPickersLocalization.d.ts

@@ -1,4 +1,3 @@
-import { AdapterFormats, MuiPickersAdapter, PickerValidDate } from '../../models';
 import { PickersLocaleText } from './pickersLocaleTextApi';
 export declare const getPickersLocalization: (pickersTranslations: Partial<PickersLocaleText>) => {
     components: {
@@ -79,9 +78,3 @@ export declare const getPickersLocalization: (pickersTranslations: Partial<Picke
         };
     };
 };
-export declare const buildGetOpenDialogAriaText: (params: {
-    utils: MuiPickersAdapter;
-    formatKey: keyof AdapterFormats;
-    contextTranslation: (formattedValue: string | null) => string;
-    propsTranslation: ((formattedValue: string | null) => string) | undefined;
-}) => (value: PickerValidDate | null) => string;

package/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/locales/zhTW.d.ts

@@ -0,0 +1,80 @@
+import { TimeViewWithMeridiem } from '../internals/models';
+export declare const zhTW: {
+    components: {
+        MuiLocalizationProvider: {
+            defaultProps: {
+                localeText: {
+                    previousMonth?: string | undefined;
+                    nextMonth?: string | undefined;
+                    calendarWeekNumberHeaderLabel?: string | undefined;
+                    calendarWeekNumberHeaderText?: string | undefined;
+                    calendarWeekNumberAriaLabelText?: ((weekNumber: number) => string) | undefined;
+                    calendarWeekNumberText?: ((weekNumber: number) => string) | undefined;
+                    openPreviousView?: string | undefined;
+                    openNextView?: string | undefined;
+                    calendarViewSwitchingButtonAriaLabel?: ((currentView: import("@mui/x-date-pickers/models").DateView) => string) | undefined;
+                    start?: string | undefined;
+                    end?: string | undefined;
+                    startDate?: string | undefined;
+                    startTime?: string | undefined;
+                    endDate?: string | undefined;
+                    endTime?: string | undefined;
+                    cancelButtonLabel?: string | undefined;
+                    clearButtonLabel?: string | undefined;
+                    okButtonLabel?: string | undefined;
+                    todayButtonLabel?: string | undefined;
+                    clockLabelText?: ((view: import("@mui/x-date-pickers/models").TimeView, formattedTime: string | null) => string) | undefined;
+                    hoursClockNumberText?: ((hours: string) => string) | undefined;
+                    minutesClockNumberText?: ((minutes: string) => string) | undefined;
+                    secondsClockNumberText?: ((seconds: string) => string) | undefined;
+                    selectViewText?: ((view: TimeViewWithMeridiem) => string) | undefined;
+                    openDatePickerDialogue?: ((formattedDate: string | null) => string) | undefined;
+                    openTimePickerDialogue?: ((formattedTime: string | null) => string) | undefined;
+                    fieldClearLabel?: string | undefined;
+                    timeTableLabel?: string | undefined;
+                    dateTableLabel?: string | undefined;
+                    fieldYearPlaceholder?: ((params: {
+                        digitAmount: number;
+                        format: string;
+                    }) => string) | undefined;
+                    fieldMonthPlaceholder?: ((params: {
+                        contentType: import("@mui/x-date-pickers/models").FieldSectionContentType;
+                        format: string;
+                    }) => string) | undefined;
+                    fieldDayPlaceholder?: ((params: {
+                        format: string;
+                    }) => string) | undefined;
+                    fieldWeekDayPlaceholder?: ((params: {
+                        contentType: import("@mui/x-date-pickers/models").FieldSectionContentType;
+                        format: string;
+                    }) => string) | undefined;
+                    fieldHoursPlaceholder?: ((params: {
+                        format: string;
+                    }) => string) | undefined;
+                    fieldMinutesPlaceholder?: ((params: {
+                        format: string;
+                    }) => string) | undefined;
+                    fieldSecondsPlaceholder?: ((params: {
+                        format: string;
+                    }) => string) | undefined;
+                    fieldMeridiemPlaceholder?: ((params: {
+                        format: string;
+                    }) => string) | undefined;
+                    year?: string | undefined;
+                    month?: string | undefined;
+                    day?: string | undefined;
+                    weekDay?: string | undefined;
+                    hours?: string | undefined;
+                    minutes?: string | undefined;
+                    seconds?: string | undefined;
+                    meridiem?: string | undefined;
+                    empty?: string | undefined;
+                    datePickerToolbarTitle?: string | undefined;
+                    timePickerToolbarTitle?: string | undefined;
+                    dateTimePickerToolbarTitle?: string | undefined;
+                    dateRangePickerToolbarTitle?: string | undefined;
+                };
+            };
+        };
+    };
+};

package/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);

package/managers/index.d.ts

@@ -0,0 +1,6 @@
+export { useDateManager } from './useDateManager';
+export type { UseDateManagerReturnValue, UseDateManagerParameters, DateManagerFieldInternalProps, } from './useDateManager';
+export { useTimeManager } from './useTimeManager';
+export type { UseTimeManagerReturnValue, UseTimeManagerParameters, TimeManagerFieldInternalProps, } from './useTimeManager';
+export { useDateTimeManager } from './useDateTimeManager';
+export type { UseDateTimeManagerReturnValue, UseDateTimeManagerParameters, DateTimeManagerFieldInternalProps, } from './useDateTimeManager';

package/managers/index.js

@@ -0,0 +1,3 @@
+export { useDateManager } from "./useDateManager.js";
+export { useTimeManager } from "./useTimeManager.js";
+export { useDateTimeManager } from "./useDateTimeManager.js";

package/managers/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "main": "../node/managers/index.js",
+  "types": "./index.d.ts"
+}

package/managers/useDateManager.d.ts

@@ -0,0 +1,27 @@
+import type { MakeOptional } from '@mui/x-internals/types';
+import { PickerManager, DateValidationError } from '../models';
+import { UseFieldInternalProps } from '../internals/hooks/useField';
+import { MuiPickersAdapterContextValue } from '../LocalizationProvider/LocalizationProvider';
+import { ExportedValidateDateProps, ValidateDatePropsToDefault, ValidateDateProps } from '../validation/validateDate';
+import { PickerValue } from '../internals/models';
+export declare function useDateManager<TEnableAccessibleFieldDOMStructure extends boolean = true>(parameters?: UseDateManagerParameters<TEnableAccessibleFieldDOMStructure>): UseDateManagerReturnValue<TEnableAccessibleFieldDOMStructure>;
+/**
+ * Private utility function to get the default internal props for the fields with date editing.
+ * Is used by the `useDateManager` and `useDateRangeManager` hooks.
+ */
+export declare function getDateFieldInternalPropsDefaults(parameters: GetDateFieldInternalPropsDefaultsParameters): GetDateFieldInternalPropsDefaultsReturnValue;
+export interface UseDateManagerParameters<TEnableAccessibleFieldDOMStructure extends boolean> {
+    enableAccessibleFieldDOMStructure?: TEnableAccessibleFieldDOMStructure;
+}
+export type UseDateManagerReturnValue<TEnableAccessibleFieldDOMStructure extends boolean> = PickerManager<PickerValue, TEnableAccessibleFieldDOMStructure, DateValidationError, DateManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure>, DateManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure>>;
+export interface DateManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure extends boolean> extends MakeOptional<UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, DateValidationError>, 'format'>, ExportedValidateDateProps {
+}
+interface DateManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure extends boolean> extends UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, DateValidationError>, ValidateDateProps {
+}
+type DateManagerFieldPropsToDefault = 'format' | ValidateDatePropsToDefault;
+interface GetDateFieldInternalPropsDefaultsParameters extends Pick<MuiPickersAdapterContextValue, 'defaultDates' | 'utils'> {
+    internalProps: Pick<DateManagerFieldInternalProps<true>, DateManagerFieldPropsToDefault>;
+}
+interface GetDateFieldInternalPropsDefaultsReturnValue extends Pick<DateManagerFieldInternalPropsWithDefaults<true>, DateManagerFieldPropsToDefault> {
+}
+export {};

package/managers/useDateManager.js

@@ -0,0 +1,55 @@
+'use client';
+
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import { applyDefaultDate } from "../internals/utils/date-utils.js";
+import { singleItemFieldValueManager, singleItemValueManager } from "../internals/utils/valueManagers.js";
+import { validateDate } from "../validation/index.js";
+export function useDateManager(parameters = {}) {
+  const {
+    enableAccessibleFieldDOMStructure = true
+  } = parameters;
+  return React.useMemo(() => ({
+    valueType: 'date',
+    validator: validateDate,
+    internal_valueManager: singleItemValueManager,
+    internal_fieldValueManager: singleItemFieldValueManager,
+    internal_enableAccessibleFieldDOMStructure: enableAccessibleFieldDOMStructure,
+    internal_applyDefaultsToFieldInternalProps: ({
+      internalProps,
+      utils,
+      defaultDates
+    }) => _extends({}, internalProps, getDateFieldInternalPropsDefaults({
+      defaultDates,
+      utils,
+      internalProps
+    })),
+    internal_getOpenPickerButtonAriaLabel: ({
+      value,
+      utils,
+      localeText
+    }) => {
+      const formattedValue = utils.isValid(value) ? utils.format(value, 'fullDate') : null;
+      return localeText.openDatePickerDialogue(formattedValue);
+    }
+  }), [enableAccessibleFieldDOMStructure]);
+}
+
+/**
+ * Private utility function to get the default internal props for the fields with date editing.
+ * Is used by the `useDateManager` and `useDateRangeManager` hooks.
+ */
+export function getDateFieldInternalPropsDefaults(parameters) {
+  const {
+    defaultDates,
+    utils,
+    internalProps
+  } = parameters;
+  return {
+    format: internalProps.format ?? utils.formats.keyboardDate,
+    disablePast: internalProps.disablePast ?? false,
+    disableFuture: internalProps.disableFuture ?? false,
+    minDate: applyDefaultDate(utils, internalProps.minDate, defaultDates.minDate),
+    maxDate: applyDefaultDate(utils, internalProps.maxDate, defaultDates.maxDate)
+  };
+}

package/managers/useDateTimeManager.d.ts

@@ -0,0 +1,28 @@
+import type { MakeOptional } from '@mui/x-internals/types';
+import { PickerManager, DateTimeValidationError } from '../models';
+import { UseFieldInternalProps } from '../internals/hooks/useField';
+import { MuiPickersAdapterContextValue } from '../LocalizationProvider/LocalizationProvider';
+import { AmPmProps } from '../internals/models/props/time';
+import { ExportedValidateDateTimeProps, ValidateDateTimeProps, ValidateDateTimePropsToDefault } from '../validation/validateDateTime';
+import { PickerValue } from '../internals/models';
+export declare function useDateTimeManager<TEnableAccessibleFieldDOMStructure extends boolean = true>(parameters?: UseDateTimeManagerParameters<TEnableAccessibleFieldDOMStructure>): UseDateTimeManagerReturnValue<TEnableAccessibleFieldDOMStructure>;
+/**
+ * Private utility function to get the default internal props for the field with date time editing.
+ * Is used by the `useDateTimeManager` and `useDateTimeRangeManager` hooks.
+ */
+export declare function getDateTimeFieldInternalPropsDefaults(parameters: GetDateTimeFieldInternalPropsDefaultsParameters): GetDateTimeFieldInternalPropsDefaultsReturnValue;
+export interface UseDateTimeManagerParameters<TEnableAccessibleFieldDOMStructure extends boolean> {
+    enableAccessibleFieldDOMStructure?: TEnableAccessibleFieldDOMStructure;
+}
+export type UseDateTimeManagerReturnValue<TEnableAccessibleFieldDOMStructure extends boolean> = PickerManager<PickerValue, TEnableAccessibleFieldDOMStructure, DateTimeValidationError, DateTimeManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure>, DateTimeManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure>>;
+export interface DateTimeManagerFieldInternalProps<TEnableAccessibleFieldDOMStructure extends boolean> extends MakeOptional<UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, DateTimeValidationError>, 'format'>, ExportedValidateDateTimeProps, AmPmProps {
+}
+interface DateTimeManagerFieldInternalPropsWithDefaults<TEnableAccessibleFieldDOMStructure extends boolean> extends UseFieldInternalProps<PickerValue, TEnableAccessibleFieldDOMStructure, DateTimeValidationError>, ValidateDateTimeProps {
+}
+type DateTimeManagerFieldPropsToDefault = 'format' | 'minTime' | 'maxTime' | ValidateDateTimePropsToDefault;
+interface GetDateTimeFieldInternalPropsDefaultsParameters extends Pick<MuiPickersAdapterContextValue, 'defaultDates' | 'utils'> {
+    internalProps: Pick<DateTimeManagerFieldInternalProps<true>, DateTimeManagerFieldPropsToDefault | 'minDateTime' | 'maxDateTime' | 'ampm'>;
+}
+interface GetDateTimeFieldInternalPropsDefaultsReturnValue extends Pick<DateTimeManagerFieldInternalPropsWithDefaults<true>, DateTimeManagerFieldPropsToDefault | 'disableIgnoringDatePartForTimeValidation'> {
+}
+export {};