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

package/node/internals/hooks/usePicker/usePicker.js

@@ -1,20 +1,20 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.usePicker = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _warning = require("@mui/x-internals/warning");
 var _usePickerValue = require("./usePickerValue");
 var _usePickerViews = require("./usePickerViews");
-var _usePickerLayoutProps = require("./usePickerLayoutProps");
-var _usePickerOwnerState = require("./usePickerOwnerState");
 var _usePickerProvider = require("./usePickerProvider");
 const usePicker = ({
   props,
   valueManager,
   valueType,
-  wrapperVariant,
+  variant,
   additionalViewProps,
   validator,
   autoFocusView,
@@ -31,7 +31,7 @@ const usePicker = ({
     props,
     valueManager,
     valueType,
-    wrapperVariant,
+    variant,
     validator
   });
   const pickerViewsResponse = (0, _usePickerViews.usePickerViews)({
@@ -42,21 +42,13 @@ const usePicker = ({
     propsFromPickerValue: pickerValueResponse.viewProps,
     rendererInterceptor
   });
-  const pickerLayoutResponse = (0, _usePickerLayoutProps.usePickerLayoutProps)({
-    props,
-    wrapperVariant,
-    propsFromPickerValue: pickerValueResponse.layoutProps,
-    propsFromPickerViews: pickerViewsResponse.layoutProps
-  });
-  const pickerOwnerState = (0, _usePickerOwnerState.usePickerOwnerState)({
-    props,
-    pickerValueResponse,
-    valueManager
-  });
   const providerProps = (0, _usePickerProvider.usePickerProvider)({
+    props,
     pickerValueResponse,
-    ownerState: pickerOwnerState,
-    localeText
+    localeText,
+    valueManager,
+    variant,
+    views: pickerViewsResponse.views
   });
   return {
     // Picker value
@@ -68,11 +60,11 @@ const usePicker = ({
     hasUIView: pickerViewsResponse.hasUIView,
     shouldRestoreFocus: pickerViewsResponse.shouldRestoreFocus,
     // Picker layout
-    layoutProps: pickerLayoutResponse.layoutProps,
+    layoutProps: (0, _extends2.default)({}, pickerViewsResponse.layoutProps, pickerValueResponse.layoutProps),
     // Picker provider
     providerProps,
     // Picker owner state
-    ownerState: pickerOwnerState
+    ownerState: providerProps.privateContextValue.ownerState
   };
 };
 exports.usePicker = usePicker;

package/node/internals/hooks/usePicker/usePickerProvider.js

@@ -1,22 +1,76 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.usePickerOrientation = void 0;
 exports.usePickerProvider = usePickerProvider;
 var React = _interopRequireWildcard(require("react"));
+var _useEnhancedEffect = _interopRequireDefault(require("@mui/utils/useEnhancedEffect"));
+var _useUtils = require("../useUtils");
+var _utils = require("../../utils/utils");
+function getOrientation() {
+  if (typeof window === 'undefined') {
+    return 'portrait';
+  }
+  if (window.screen && window.screen.orientation && window.screen.orientation.angle) {
+    return Math.abs(window.screen.orientation.angle) === 90 ? 'landscape' : 'portrait';
+  }
+
+  // Support IOS safari
+  if (window.orientation) {
+    return Math.abs(Number(window.orientation)) === 90 ? 'landscape' : 'portrait';
+  }
+  return 'portrait';
+}
+const usePickerOrientation = (views, customOrientation) => {
+  const [orientation, setOrientation] = React.useState(getOrientation);
+  (0, _useEnhancedEffect.default)(() => {
+    const eventHandler = () => {
+      setOrientation(getOrientation());
+    };
+    window.addEventListener('orientationchange', eventHandler);
+    return () => {
+      window.removeEventListener('orientationchange', eventHandler);
+    };
+  }, []);
+  if ((0, _utils.arrayIncludes)(views, ['hours', 'minutes', 'seconds'])) {
+    // could not display 13:34:44 in landscape mode
+    return 'portrait';
+  }
+  return customOrientation ?? orientation;
+};
+exports.usePickerOrientation = usePickerOrientation;
 function usePickerProvider(parameters) {
   const {
+    props,
     pickerValueResponse,
-    ownerState,
-    localeText
+    valueManager,
+    localeText,
+    variant,
+    views
   } = parameters;
+  const utils = (0, _useUtils.useUtils)();
+  const orientation = usePickerOrientation(views, props.orientation);
+  const ownerState = React.useMemo(() => ({
+    isPickerValueEmpty: valueManager.areValuesEqual(utils, pickerValueResponse.viewProps.value, valueManager.emptyValue),
+    isPickerOpen: pickerValueResponse.open,
+    isPickerDisabled: props.disabled ?? false,
+    isPickerReadOnly: props.readOnly ?? false,
+    pickerOrientation: orientation,
+    pickerVariant: variant
+  }), [utils, valueManager, pickerValueResponse.viewProps.value, pickerValueResponse.open, orientation, variant, props.disabled, props.readOnly]);
   const contextValue = React.useMemo(() => ({
     onOpen: pickerValueResponse.actions.onOpen,
     onClose: pickerValueResponse.actions.onClose,
-    open: pickerValueResponse.open
-  }), [pickerValueResponse.actions.onOpen, pickerValueResponse.actions.onClose, pickerValueResponse.open]);
+    open: pickerValueResponse.open,
+    disabled: props.disabled ?? false,
+    readOnly: props.readOnly ?? false,
+    variant,
+    orientation
+  }), [pickerValueResponse.actions.onOpen, pickerValueResponse.actions.onClose, pickerValueResponse.open, variant, orientation, props.disabled, props.readOnly]);
   const privateContextValue = React.useMemo(() => ({
     ownerState
   }), [ownerState]);
@@ -25,4 +79,9 @@ function usePickerProvider(parameters) {
     contextValue,
     privateContextValue
   };
-}
+}
+
+/**
+ * Props used to create the private context.
+ * Those props are exposed on all the pickers.
+ */

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

@@ -120,7 +120,7 @@ const usePickerValue = ({
   props,
   valueManager,
   valueType,
-  wrapperVariant,
+  variant,
   validator
 }) => {
   const {
@@ -128,8 +128,9 @@ const usePickerValue = ({
     onChange,
     value: inValueWithoutRenderTimezone,
     defaultValue: inDefaultValue,
-    closeOnSelect = wrapperVariant === 'desktop',
-    timezone: timezoneProp
+    closeOnSelect = variant === 'desktop',
+    timezone: timezoneProp,
+    referenceDate
   } = props;
   const {
     current: defaultValue
@@ -137,6 +138,7 @@ const usePickerValue = ({
   const {
     current: isControlled
   } = React.useRef(inValueWithoutRenderTimezone !== undefined);
+  const [previousTimezoneProp, setPreviousTimezoneProp] = React.useState(timezoneProp);
 
   /* eslint-disable react-hooks/rules-of-hooks, react-hooks/exhaustive-deps */
   if (process.env.NODE_ENV !== 'production') {
@@ -167,6 +169,7 @@ const usePickerValue = ({
     timezone: timezoneProp,
     value: inValueWithoutRenderTimezone,
     defaultValue,
+    referenceDate,
     onChange,
     valueManager
   });
@@ -183,10 +186,19 @@ const usePickerValue = ({
       draft: initialValue,
       lastPublishedValue: initialValue,
       lastCommittedValue: initialValue,
-      lastControlledValue: inValueWithTimezoneToRender,
+      lastControlledValue: inValueWithoutRenderTimezone,
       hasBeenModifiedSinceMount: false
     };
   });
+  const timezoneFromDraftValue = valueManager.getTimezone(utils, dateState.draft);
+  if (previousTimezoneProp !== timezoneProp) {
+    setPreviousTimezoneProp(timezoneProp);
+    if (timezoneProp && timezoneFromDraftValue && timezoneProp !== timezoneFromDraftValue) {
+      setDateState(prev => (0, _extends2.default)({}, prev, {
+        draft: valueManager.setTimezone(utils, timezoneProp, prev.draft)
+      }));
+    }
+  }
   const {
     getValidationErrorForNewValue
   } = (0, _validation.useValidation)({
@@ -236,10 +248,10 @@ const usePickerValue = ({
       setIsOpen(false);
     }
   });
-  if (inValueWithTimezoneToRender !== undefined && (dateState.lastControlledValue === undefined || !valueManager.areValuesEqual(utils, dateState.lastControlledValue, inValueWithTimezoneToRender))) {
+  if (dateState.lastControlledValue !== inValueWithoutRenderTimezone) {
     const isUpdateComingFromPicker = valueManager.areValuesEqual(utils, dateState.draft, inValueWithTimezoneToRender);
     setDateState(prev => (0, _extends2.default)({}, prev, {
-      lastControlledValue: inValueWithTimezoneToRender
+      lastControlledValue: inValueWithoutRenderTimezone
     }, isUpdateComingFromPicker ? {} : {
       lastCommittedValue: inValueWithTimezoneToRender,
       lastPublishedValue: inValueWithTimezoneToRender,

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

@@ -141,6 +141,7 @@ const usePickerViews = ({
   };
   return {
     hasUIView,
+    views,
     shouldRestoreFocus,
     layoutProps,
     renderCurrentView: () => {

package/node/internals/hooks/useStaticPicker/useStaticPicker.js

@@ -56,7 +56,7 @@ const useStaticPicker = _ref => {
     fieldRef: undefined,
     localeText,
     additionalViewProps: {},
-    wrapperVariant: displayStaticWrapperAs
+    variant: displayStaticWrapperAs
   }));
   const Layout = slots?.layout ?? PickerStaticLayout;
   const renderPicker = () => /*#__PURE__*/(0, _jsxRuntime.jsx)(_PickerProvider.PickerProvider, (0, _extends2.default)({}, providerProps, {

package/node/internals/hooks/useValueWithTimezone.js

@@ -19,6 +19,7 @@ const useValueWithTimezone = ({
   timezone: timezoneProp,
   value: valueProp,
   defaultValue,
+  referenceDate,
   onChange,
   valueManager
 }) => {
@@ -32,7 +33,16 @@ const useValueWithTimezone = ({
     }
     return valueManager.setTimezone(utils, inputTimezone, newValue);
   });
-  const timezoneToRender = timezoneProp ?? inputTimezone ?? 'default';
+  let timezoneToRender;
+  if (timezoneProp) {
+    timezoneToRender = timezoneProp;
+  } else if (inputTimezone) {
+    timezoneToRender = inputTimezone;
+  } else if (referenceDate) {
+    timezoneToRender = utils.getTimezone(referenceDate);
+  } else {
+    timezoneToRender = 'default';
+  }
   const valueWithTimezoneToRender = React.useMemo(() => valueManager.setTimezone(utils, timezoneToRender, inputValue), [valueManager, utils, timezoneToRender, inputValue]);
   const handleValueChange = (0, _useEventCallback.default)((newValue, ...otherParams) => {
     const newValueWithInputTimezone = setInputTimezone(newValue);
@@ -54,6 +64,7 @@ const useControlledValueWithTimezone = ({
   timezone: timezoneProp,
   value: valueProp,
   defaultValue,
+  referenceDate,
   onChange: onChangeProp,
   valueManager
 }) => {
@@ -71,6 +82,7 @@ const useControlledValueWithTimezone = ({
     timezone: timezoneProp,
     value: valueWithInputTimezone,
     defaultValue: undefined,
+    referenceDate,
     onChange,
     valueManager
   });

package/node/internals/index.js

@@ -261,6 +261,12 @@ Object.defineProperty(exports, "useField", {
     return _useField.useField;
   }
 });
+Object.defineProperty(exports, "useFieldOwnerState", {
+  enumerable: true,
+  get: function () {
+    return _useFieldOwnerState.useFieldOwnerState;
+  }
+});
 Object.defineProperty(exports, "useLocalizationContext", {
   enumerable: true,
   get: function () {
@@ -329,6 +335,7 @@ var _PickersToolbarButton = require("./components/PickersToolbarButton");
 var _dimensions = require("./constants/dimensions");
 var _useValueWithTimezone = require("./hooks/useValueWithTimezone");
 var _useField = require("./hooks/useField");
+var _useFieldOwnerState = require("./hooks/useFieldOwnerState");
 var _usePicker = require("./hooks/usePicker");
 var _usePickerPrivateContext = require("./hooks/usePickerPrivateContext");
 var _useStaticPicker = require("./hooks/useStaticPicker");

package/node/internals/models/pickers.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/node/locales/nlNL.js

@@ -22,10 +22,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',
@@ -56,11 +56,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',
@@ -74,6 +74,6 @@ const nlNLPickers = {
   seconds: 'Seconden',
   meridiem: 'Middag',
   // Common
-  empty: 'Legen'
+  empty: 'Leeg'
 };
 const nlNL = exports.nlNL = (0, _getPickersLocalization.getPickersLocalization)(nlNLPickers);

package/node/validation/useValidation.js

@@ -12,7 +12,7 @@ var _useEventCallback = _interopRequireDefault(require("@mui/utils/useEventCallb
 var _useUtils = require("../internals/hooks/useUtils");
 /**
  * Utility hook to check if a given value is valid based on the provided validation props.
- * @template TValue The value type. It will be either the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
+ * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
  * @template TError The validation error type. It will be either `string` or a `null`. It can be in `[start, end]` format in case of range value.
  * @param {UseValidationOptions<TValue, TError, TValidationProps>} options The options to configure the hook.
  * @param {TValue} options.value The value to validate.

package/node/validation/validateDate.js

@@ -10,6 +10,14 @@ var _valueManagers = require("../internals/utils/valueManagers");
  * Validation props used by the Date Picker, Date Field and Date Calendar components.
  */
 
+/**
+ * Validation props as received by the validateDate method.
+ */
+
+/**
+ * Name of the props that should be defaulted before being passed to the validateDate method.
+ */
+
 const validateDate = ({
   props,
   value,

package/node/validation/validateDateTime.js

@@ -11,6 +11,14 @@ var _valueManagers = require("../internals/utils/valueManagers");
  * Validation props used by the Date Time Picker and Date Time Field components.
  */
 
+/**
+ * Validation props as received by the validateDateTime method.
+ */
+
+/**
+ * Name of the props that should be defaulted before being passed to the validateDateTime method.
+ */
+
 const validateDateTime = ({
   adapter,
   value,

package/node/validation/validateTime.js

@@ -10,6 +10,14 @@ var _valueManagers = require("../internals/utils/valueManagers");
  * Validation props used by the Time Picker, Time Field and Clock components.
  */
 
+/**
+ * Validation props as received by the validateTime method.
+ */
+
+/**
+ * Name of the props that should be defaulted before being passed to the validateTime method.
+ */
+
 const validateTime = ({
   adapter,
   value,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-date-pickers",
-  "version": "8.0.0-alpha.0",
+  "version": "8.0.0-alpha.2",
   "description": "The community edition of the Date and Time Picker components (MUI X).",
   "author": "MUI Team",
   "main": "./node/index.js",
@@ -41,7 +41,7 @@
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
     "react-transition-group": "^4.4.5",
-    "@mui/x-internals": "8.0.0-alpha.0"
+    "@mui/x-internals": "8.0.0-alpha.2"
   },
   "peerDependencies": {
     "@emotion/react": "^11.9.0",
@@ -55,8 +55,8 @@
     "moment": "^2.29.4",
     "moment-hijri": "^2.1.2 || ^3.0.0",
     "moment-jalaali": "^0.7.4 || ^0.8.0 || ^0.9.0 || ^0.10.0",
-    "react": "^17.0.0 || ^18.0.0",
-    "react-dom": "^17.0.0 || ^18.0.0"
+    "react": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "react-dom": "^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
     "@emotion/react": {

package/themeAugmentation/overrides.d.ts

@@ -57,13 +57,13 @@ export interface PickersComponentNameToClassKey {
   MuiPickersCalendarHeader: PickersCalendarHeaderClassKey;
   MuiPickersDay: PickersDayClassKey;
   MuiPickersFadeTransitionGroup: PickersFadeTransitionGroupClassKey;
+  MuiPickersLayout: PickersLayoutClassKey;
   MuiPickersMonth: PickersMonthClassKey;
   MuiPickersPopper: PickersPopperClassKey;
   MuiPickersSlideTransition: PickersSlideTransitionClassKey;
   MuiPickersToolbar: PickersToolbarClassKey;
   MuiPickersToolbarButton: PickersToolbarButtonClassKey;
   MuiPickersToolbarText: PickersToolbarTextClassKey;
-  MuiPickersLayout: PickersLayoutClassKey;
   MuiPickersYear: PickersYearClassKey;
   MuiTimeClock: TimeClockClassKey;
   MuiTimePickerToolbar: TimePickerToolbarClassKey;

package/themeAugmentation/props.d.ts

@@ -52,6 +52,7 @@ import {
   PickersFilledInputProps,
 } from '../PickersTextField';
 import { PickersSectionListProps } from '../PickersSectionList';
+import { PickerValidValue } from '../internals/models';
 
 export interface PickersComponentsPropsList {
   MuiClock: ClockProps;
@@ -77,10 +78,10 @@ export interface PickersComponentsPropsList {
   MuiPickersMonth: ExportedPickersMonthProps;
   MuiPickersPopper: PickerPopperProps;
   MuiPickersSlideTransition: ExportedSlideTransitionProps;
-  MuiPickersToolbar: PickersToolbarProps<unknown, DateOrTimeView>;
+  MuiPickersToolbar: PickersToolbarProps<PickerValidValue, DateOrTimeView>;
   MuiPickersToolbarButton: PickersToolbarButtonProps;
   MuiPickersToolbarText: ExportedPickersToolbarTextProps;
-  MuiPickersLayout: PickersLayoutProps<unknown, DateOrTimeView>;
+  MuiPickersLayout: PickersLayoutProps<PickerValidValue, DateOrTimeView>;
   MuiPickersYear: ExportedPickersYearProps;
   MuiTimeClock: TimeClockProps;
   MuiTimeField: TimeFieldProps<any>;

package/validation/useValidation.d.ts

@@ -1,7 +1,8 @@
 import { MuiPickersAdapterContextValue } from '../LocalizationProvider/LocalizationProvider';
 import { OnErrorProps, PickersTimezone } from '../models';
 import type { PickerValueManager } from '../internals/hooks/usePicker';
-export type Validator<TValue, TError, TValidationProps> = {
+import { PickerValidValue } from '../internals/models';
+export type Validator<TValue extends PickerValidValue, TError, TValidationProps> = {
     (params: {
         adapter: MuiPickersAdapterContextValue;
         value: TValue;
@@ -10,7 +11,7 @@ export type Validator<TValue, TError, TValidationProps> = {
     }): TError;
     valueManager: PickerValueManager<TValue, any>;
 };
-interface UseValidationOptions<TValue, TError, TValidationProps extends {}> extends OnErrorProps<TValue, TError> {
+interface UseValidationOptions<TValue extends PickerValidValue, TError, TValidationProps extends {}> extends OnErrorProps<TValue, TError> {
     /**
      * The value to validate.
      */
@@ -32,7 +33,7 @@ interface UseValidationOptions<TValue, TError, TValidationProps extends {}> exte
      */
     props: TValidationProps;
 }
-interface UseValidationReturnValue<TValue, TError> {
+interface UseValidationReturnValue<TValue extends PickerValidValue, TError> {
     /**
      * The validation error associated to the value passed to the `useValidation` hook.
      */
@@ -46,7 +47,7 @@ interface UseValidationReturnValue<TValue, TError> {
     /**
      * Get the validation error for a new value.
      * This can be used to validate the value in a change handler before updating the state.
-     * @template TValue The value type.
+     * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
      * @param {TValue} newValue The value to validate.
      * @returns {TError} The validation error associated to the new value.
      */
@@ -54,7 +55,7 @@ interface UseValidationReturnValue<TValue, TError> {
 }
 /**
  * Utility hook to check if a given value is valid based on the provided validation props.
- * @template TValue The value type. It will be either the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
+ * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
  * @template TError The validation error type. It will be either `string` or a `null`. It can be in `[start, end]` format in case of range value.
  * @param {UseValidationOptions<TValue, TError, TValidationProps>} options The options to configure the hook.
  * @param {TValue} options.value The value to validate.
@@ -63,5 +64,5 @@ interface UseValidationReturnValue<TValue, TError> {
  * @param {TValidationProps} options.props The validation props, they differ depending on the component.
  * @param {(error: TError, value: TValue) => void} options.onError Callback fired when the error associated with the current value changes.
  */
-export declare function useValidation<TValue, TError, TValidationProps extends {}>(options: UseValidationOptions<TValue, TError, TValidationProps>): UseValidationReturnValue<TValue, TError>;
+export declare function useValidation<TValue extends PickerValidValue, TError, TValidationProps extends {}>(options: UseValidationOptions<TValue, TError, TValidationProps>): UseValidationReturnValue<TValue, TError>;
 export {};

package/validation/useValidation.js

@@ -5,7 +5,7 @@ import useEventCallback from '@mui/utils/useEventCallback';
 import { useLocalizationContext } from "../internals/hooks/useUtils.js";
 /**
  * Utility hook to check if a given value is valid based on the provided validation props.
- * @template TValue The value type. It will be either the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
+ * @template TValue The value type. It will be the same type as `value` or `null`. It can be in `[start, end]` format in case of range value.
  * @template TError The validation error type. It will be either `string` or a `null`. It can be in `[start, end]` format in case of range value.
  * @param {UseValidationOptions<TValue, TError, TValidationProps>} options The options to configure the hook.
  * @param {TValue} options.value The value to validate.

package/validation/validateDate.d.ts

@@ -1,11 +1,20 @@
+import type { MakeRequired } from '@mui/x-internals/types';
 import { Validator } from './useValidation';
 import { BaseDateValidationProps, DayValidationProps, MonthValidationProps, YearValidationProps } from '../internals/models/validation';
-import { DateValidationError, PickerValidDate } from '../models';
+import { DateValidationError } from '../models';
+import { PickerValue } from '../internals/models';
 /**
  * Validation props used by the Date Picker, Date Field and Date Calendar components.
  */
 export interface ExportedValidateDateProps extends DayValidationProps, MonthValidationProps, YearValidationProps, BaseDateValidationProps {
 }
-export interface ValidateDateProps extends DayValidationProps, MonthValidationProps, YearValidationProps, Required<BaseDateValidationProps> {
+/**
+ * Validation props as received by the validateDate method.
+ */
+export interface ValidateDateProps extends MakeRequired<ExportedValidateDateProps, ValidateDatePropsToDefault> {
 }
-export declare const validateDate: Validator<PickerValidDate | null, DateValidationError, ValidateDateProps>;
+/**
+ * Name of the props that should be defaulted before being passed to the validateDate method.
+ */
+export type ValidateDatePropsToDefault = keyof BaseDateValidationProps;
+export declare const validateDate: Validator<PickerValue, DateValidationError, ValidateDateProps>;

package/validation/validateDate.js

@@ -5,6 +5,14 @@ import { singleItemValueManager } from "../internals/utils/valueManagers.js";
  * Validation props used by the Date Picker, Date Field and Date Calendar components.
  */
 
+/**
+ * Validation props as received by the validateDate method.
+ */
+
+/**
+ * Name of the props that should be defaulted before being passed to the validateDate method.
+ */
+
 export const validateDate = ({
   props,
   value,

package/validation/validateDateTime.d.ts

@@ -1,13 +1,21 @@
 import { Validator } from './useValidation';
-import { ExportedValidateDateProps, ValidateDateProps } from './validateDate';
-import { ExportedValidateTimeProps, ValidateTimeProps } from './validateTime';
-import { DateTimeValidationError, PickerValidDate } from '../models';
+import { ExportedValidateDateProps, ValidateDateProps, ValidateDatePropsToDefault } from './validateDate';
+import { ExportedValidateTimeProps, ValidateTimeProps, ValidateTimePropsToDefault } from './validateTime';
+import { DateTimeValidationError } from '../models';
 import { DateTimeValidationProps } from '../internals/models/validation';
+import { PickerValue } from '../internals/models';
 /**
  * Validation props used by the Date Time Picker and Date Time Field components.
  */
 export interface ExportedValidateDateTimeProps extends ExportedValidateDateProps, ExportedValidateTimeProps, DateTimeValidationProps {
 }
+/**
+ * Validation props as received by the validateDateTime method.
+ */
 export interface ValidateDateTimeProps extends ValidateDateProps, ValidateTimeProps {
 }
-export declare const validateDateTime: Validator<PickerValidDate | null, DateTimeValidationError, ValidateDateTimeProps>;
+/**
+ * Name of the props that should be defaulted before being passed to the validateDateTime method.
+ */
+export type ValidateDateTimePropsToDefault = ValidateDatePropsToDefault | ValidateTimePropsToDefault;
+export declare const validateDateTime: Validator<PickerValue, DateTimeValidationError, ValidateDateTimeProps>;

package/validation/validateDateTime.js

@@ -6,6 +6,14 @@ import { singleItemValueManager } from "../internals/utils/valueManagers.js";
  * Validation props used by the Date Time Picker and Date Time Field components.
  */
 
+/**
+ * Validation props as received by the validateDateTime method.
+ */
+
+/**
+ * Name of the props that should be defaulted before being passed to the validateDateTime method.
+ */
+
 export const validateDateTime = ({
   adapter,
   value,

package/validation/validateTime.d.ts

@@ -1,11 +1,20 @@
+import type { MakeRequired } from '@mui/x-internals/types';
 import { Validator } from './useValidation';
 import { BaseTimeValidationProps, TimeValidationProps } from '../internals/models/validation';
-import { PickerValidDate, TimeValidationError } from '../models';
+import { TimeValidationError } from '../models';
+import { PickerValue } from '../internals/models';
 /**
  * Validation props used by the Time Picker, Time Field and Clock components.
  */
 export interface ExportedValidateTimeProps extends BaseTimeValidationProps, TimeValidationProps {
 }
-export interface ValidateTimeProps extends Required<BaseTimeValidationProps>, TimeValidationProps {
+/**
+ * Validation props as received by the validateTime method.
+ */
+export interface ValidateTimeProps extends MakeRequired<ExportedValidateTimeProps, ValidateTimePropsToDefault> {
 }
-export declare const validateTime: Validator<PickerValidDate | null, TimeValidationError, ValidateTimeProps>;
+/**
+ * Name of the props that should be defaulted before being passed to the validateTime method.
+ */
+export type ValidateTimePropsToDefault = keyof BaseTimeValidationProps;
+export declare const validateTime: Validator<PickerValue, TimeValidationError, ValidateTimeProps>;