@mui/x-date-pickers 9.6.0 → 9.8.0

package/internals/components/PickersArrowSwitcher/PickersArrowSwitcher.d.mts

@@ -1,3 +1,3 @@
 import * as React from 'react';
-import { PickersArrowSwitcherProps } from "./PickersArrowSwitcher.types.mjs";
+import type { PickersArrowSwitcherProps } from "./PickersArrowSwitcher.types.mjs";
 export declare const PickersArrowSwitcher: React.ForwardRefExoticComponent<PickersArrowSwitcherProps & React.RefAttributes<HTMLDivElement>>;

package/internals/components/PickersArrowSwitcher/PickersArrowSwitcher.d.ts

@@ -1,3 +1,3 @@
 import * as React from 'react';
-import { PickersArrowSwitcherProps } from "./PickersArrowSwitcher.types.js";
+import type { PickersArrowSwitcherProps } from "./PickersArrowSwitcher.types.js";
 export declare const PickersArrowSwitcher: React.ForwardRefExoticComponent<PickersArrowSwitcherProps & React.RefAttributes<HTMLDivElement>>;

package/internals/components/PickersArrowSwitcher/PickersArrowSwitcher.types.d.mts

@@ -1,9 +1,9 @@
-import * as React from 'react';
-import { SlotComponentProps } from '@mui/utils/types';
-import IconButton from '@mui/material/IconButton';
-import SvgIcon from '@mui/material/SvgIcon';
-import { PickersArrowSwitcherClasses } from "./pickersArrowSwitcherClasses.mjs";
-import { PickerOwnerState } from "../../../models/index.mjs";
+import type * as React from 'react';
+import type { SlotComponentProps } from '@mui/utils/types';
+import type IconButton from '@mui/material/IconButton';
+import type SvgIcon from '@mui/material/SvgIcon';
+import type { PickersArrowSwitcherClasses } from "./pickersArrowSwitcherClasses.mjs";
+import type { PickerOwnerState } from "../../../models/index.mjs";
 export interface ExportedPickersArrowSwitcherProps {
   /**
    * Overridable component slots.

package/internals/components/PickersArrowSwitcher/PickersArrowSwitcher.types.d.ts

@@ -1,9 +1,9 @@
-import * as React from 'react';
-import { SlotComponentProps } from '@mui/utils/types';
-import IconButton from '@mui/material/IconButton';
-import SvgIcon from '@mui/material/SvgIcon';
-import { PickersArrowSwitcherClasses } from "./pickersArrowSwitcherClasses.js";
-import { PickerOwnerState } from "../../../models/index.js";
+import type * as React from 'react';
+import type { SlotComponentProps } from '@mui/utils/types';
+import type IconButton from '@mui/material/IconButton';
+import type SvgIcon from '@mui/material/SvgIcon';
+import type { PickersArrowSwitcherClasses } from "./pickersArrowSwitcherClasses.js";
+import type { PickerOwnerState } from "../../../models/index.js";
 export interface ExportedPickersArrowSwitcherProps {
   /**
    * Overridable component slots.

package/internals/components/PickersModalDialog.d.mts

@@ -1,7 +1,7 @@
 import * as React from 'react';
-import { DialogProps as MuiDialogProps } from '@mui/material/Dialog';
-import { PaperProps as MuiPaperProps } from '@mui/material/Paper';
-import { TransitionProps as MuiTransitionProps } from '@mui/material/transitions';
+import type { DialogProps as MuiDialogProps } from '@mui/material/Dialog';
+import type { PaperProps as MuiPaperProps } from '@mui/material/Paper';
+import type { TransitionProps as MuiTransitionProps } from '@mui/material/transitions';
 export interface PickersModalDialogSlots {
   /**
    * Custom component for the dialog inside which the views are rendered on mobile.

package/internals/components/PickersModalDialog.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
-import { DialogProps as MuiDialogProps } from '@mui/material/Dialog';
-import { PaperProps as MuiPaperProps } from '@mui/material/Paper';
-import { TransitionProps as MuiTransitionProps } from '@mui/material/transitions';
+import type { DialogProps as MuiDialogProps } from '@mui/material/Dialog';
+import type { PaperProps as MuiPaperProps } from '@mui/material/Paper';
+import type { TransitionProps as MuiTransitionProps } from '@mui/material/transitions';
 export interface PickersModalDialogSlots {
   /**
    * Custom component for the dialog inside which the views are rendered on mobile.

package/internals/components/PickersToolbar.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { BaseToolbarProps } from "../models/props/toolbar.mjs";
-import { PickersToolbarClasses } from "./pickersToolbarClasses.mjs";
+import type { BaseToolbarProps } from "../models/props/toolbar.mjs";
+import type { PickersToolbarClasses } from "./pickersToolbarClasses.mjs";
 export interface PickersToolbarProps extends Pick<BaseToolbarProps, 'hidden' | 'titleId'> {
   className?: string;
   landscapeDirection?: 'row' | 'column';

package/internals/components/PickersToolbar.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { BaseToolbarProps } from "../models/props/toolbar.js";
-import { PickersToolbarClasses } from "./pickersToolbarClasses.js";
+import type { BaseToolbarProps } from "../models/props/toolbar.js";
+import type { PickersToolbarClasses } from "./pickersToolbarClasses.js";
 export interface PickersToolbarProps extends Pick<BaseToolbarProps, 'hidden' | 'titleId'> {
   className?: string;
   landscapeDirection?: 'row' | 'column';

package/internals/components/PickersToolbarButton.d.mts

@@ -1,8 +1,8 @@
 import * as React from 'react';
-import { ButtonProps } from '@mui/material/Button';
-import { TypographyProps } from '@mui/material/Typography';
-import { ExtendMui } from "../models/helpers.mjs";
-import { PickersToolbarButtonClasses } from "./pickersToolbarButtonClasses.mjs";
+import type { ButtonProps } from '@mui/material/Button';
+import type { TypographyProps } from '@mui/material/Typography';
+import type { ExtendMui } from "../models/helpers.mjs";
+import type { PickersToolbarButtonClasses } from "./pickersToolbarButtonClasses.mjs";
 export interface PickersToolbarButtonProps extends ExtendMui<ButtonProps, 'value' | 'variant'> {
   align?: TypographyProps['align'];
   selected: boolean;

package/internals/components/PickersToolbarButton.d.ts

@@ -1,8 +1,8 @@
 import * as React from 'react';
-import { ButtonProps } from '@mui/material/Button';
-import { TypographyProps } from '@mui/material/Typography';
-import { ExtendMui } from "../models/helpers.js";
-import { PickersToolbarButtonClasses } from "./pickersToolbarButtonClasses.js";
+import type { ButtonProps } from '@mui/material/Button';
+import type { TypographyProps } from '@mui/material/Typography';
+import type { ExtendMui } from "../models/helpers.js";
+import type { PickersToolbarButtonClasses } from "./pickersToolbarButtonClasses.js";
 export interface PickersToolbarButtonProps extends ExtendMui<ButtonProps, 'value' | 'variant'> {
   align?: TypographyProps['align'];
   selected: boolean;

package/internals/components/PickersToolbarText.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { TypographyProps } from '@mui/material/Typography';
-import { PickersToolbarTextClasses } from "./pickersToolbarTextClasses.mjs";
+import type { TypographyProps } from '@mui/material/Typography';
+import type { PickersToolbarTextClasses } from "./pickersToolbarTextClasses.mjs";
 export interface ExportedPickersToolbarTextProps extends Omit<TypographyProps, 'classes' | 'variant' | 'align'> {
   classes?: Partial<PickersToolbarTextClasses>;
 }

package/internals/components/PickersToolbarText.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { TypographyProps } from '@mui/material/Typography';
-import { PickersToolbarTextClasses } from "./pickersToolbarTextClasses.js";
+import type { TypographyProps } from '@mui/material/Typography';
+import type { PickersToolbarTextClasses } from "./pickersToolbarTextClasses.js";
 export interface ExportedPickersToolbarTextProps extends Omit<TypographyProps, 'classes' | 'variant' | 'align'> {
   classes?: Partial<PickersToolbarTextClasses>;
 }

package/internals/demo/DemoContainer.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { StackProps } from '@mui/material/Stack';
-import { SxProps, Theme } from '@mui/material/styles';
+import type { StackProps } from '@mui/material/Stack';
+import type { SxProps, Theme } from '@mui/material/styles';
 interface DemoGridProps {
   children: React.ReactNode;
   components: string[];

package/internals/demo/DemoContainer.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { StackProps } from '@mui/material/Stack';
-import { SxProps, Theme } from '@mui/material/styles';
+import type { StackProps } from '@mui/material/Stack';
+import type { SxProps, Theme } from '@mui/material/styles';
 interface DemoGridProps {
   children: React.ReactNode;
   components: string[];

package/internals/hooks/PickerDay.types.d.mts

@@ -1,4 +1,4 @@
-import { PickerValidDate } from "../../models/index.mjs";
+import type { PickerValidDate } from "../../models/index.mjs";
 export interface PickerDayOwnerState {
   day: PickerValidDate;
   isDaySelected: boolean;

package/internals/hooks/PickerDay.types.d.ts

@@ -1,4 +1,4 @@
-import { PickerValidDate } from "../../models/index.js";
+import type { PickerValidDate } from "../../models/index.js";
 export interface PickerDayOwnerState {
   day: PickerValidDate;
   isDaySelected: boolean;

package/internals/hooks/date-helpers-hooks.d.mts

@@ -1,6 +1,6 @@
-import { PickerOnChangeFn } from "./useViews.mjs";
-import { PickerSelectionState } from "./usePicker/index.mjs";
-import { PickersTimezone, PickerValidDate } from "../../models/index.mjs";
+import type { PickerOnChangeFn } from "./useViews.mjs";
+import type { PickerSelectionState } from "./usePicker/index.mjs";
+import type { PickersTimezone, PickerValidDate } from "../../models/index.mjs";
 export interface MonthValidationOptions {
   disablePast?: boolean;
   disableFuture?: boolean;

package/internals/hooks/date-helpers-hooks.d.ts

@@ -1,6 +1,6 @@
-import { PickerOnChangeFn } from "./useViews.js";
-import { PickerSelectionState } from "./usePicker/index.js";
-import { PickersTimezone, PickerValidDate } from "../../models/index.js";
+import type { PickerOnChangeFn } from "./useViews.js";
+import type { PickerSelectionState } from "./usePicker/index.js";
+import type { PickersTimezone, PickerValidDate } from "../../models/index.js";
 export interface MonthValidationOptions {
   disablePast?: boolean;
   disableFuture?: boolean;

package/internals/hooks/useClockReferenceDate.d.mts

@@ -1,5 +1,5 @@
-import { MuiPickersAdapter, PickersTimezone, PickerValidDate } from "../../models/index.mjs";
-import { PickerValue } from "../models/index.mjs";
+import type { MuiPickersAdapter, PickersTimezone, PickerValidDate } from "../../models/index.mjs";
+import type { PickerValue } from "../models/index.mjs";
 export declare const useClockReferenceDate: <TProps extends {}>({
   value,
   referenceDate: referenceDateProp,

package/internals/hooks/useClockReferenceDate.d.ts

@@ -1,5 +1,5 @@
-import { MuiPickersAdapter, PickersTimezone, PickerValidDate } from "../../models/index.js";
-import { PickerValue } from "../models/index.js";
+import type { MuiPickersAdapter, PickersTimezone, PickerValidDate } from "../../models/index.js";
+import type { PickerValue } from "../models/index.js";
 export declare const useClockReferenceDate: <TProps extends {}>({
   value,
   referenceDate: referenceDateProp,

package/internals/hooks/useControlledValue.d.mts

@@ -1,6 +1,5 @@
-import type { PickerRangeValue, PickerValueManager } from "../models/index.mjs";
-import { PickersTimezone, PickerValidDate } from "../../models/index.mjs";
-import { PickerValidValue } from "../models/index.mjs";
+import type { PickerRangeValue, PickerValueManager, PickerValidValue } from "../models/index.mjs";
+import type { PickersTimezone, PickerValidDate } from "../../models/index.mjs";
 /**
  * Hooks controlling the value while making sure that:
  * - The value returned by `onChange` always have the timezone of `props.value` or `props.defaultValue` if defined

package/internals/hooks/useControlledValue.d.ts

@@ -1,6 +1,5 @@
-import type { PickerRangeValue, PickerValueManager } from "../models/index.js";
-import { PickersTimezone, PickerValidDate } from "../../models/index.js";
-import { PickerValidValue } from "../models/index.js";
+import type { PickerRangeValue, PickerValueManager, PickerValidValue } from "../models/index.js";
+import type { PickersTimezone, PickerValidDate } from "../../models/index.js";
 /**
  * Hooks controlling the value while making sure that:
  * - The value returned by `onChange` always have the timezone of `props.value` or `props.defaultValue` if defined

package/internals/hooks/useDesktopPicker/useDesktopPicker.d.mts

@@ -1,5 +1,5 @@
-import { UseDesktopPickerParams, UseDesktopPickerProps } from "./useDesktopPicker.types.mjs";
-import { DateOrTimeViewWithMeridiem } from "../../models/index.mjs";
+import type { UseDesktopPickerParams, UseDesktopPickerProps } from "./useDesktopPicker.types.mjs";
+import type { DateOrTimeViewWithMeridiem } from "../../models/index.mjs";
 /**
  * Hook managing all the single-date desktop pickers:
  * - DesktopDatePicker

package/internals/hooks/useDesktopPicker/useDesktopPicker.d.ts

@@ -1,5 +1,5 @@
-import { UseDesktopPickerParams, UseDesktopPickerProps } from "./useDesktopPicker.types.js";
-import { DateOrTimeViewWithMeridiem } from "../../models/index.js";
+import type { UseDesktopPickerParams, UseDesktopPickerProps } from "./useDesktopPicker.types.js";
+import type { DateOrTimeViewWithMeridiem } from "../../models/index.js";
 /**
  * Hook managing all the single-date desktop pickers:
  * - DesktopDatePicker

package/internals/hooks/useDesktopPicker/useDesktopPicker.types.d.mts

@@ -1,13 +1,13 @@
-import * as React from 'react';
-import { MakeRequired, SlotComponentPropsFromProps } from '@mui/x-internals/types';
-import { BasePickerProps } from "../../models/props/basePickerProps.mjs";
-import { PickerPopperSlots, PickerPopperSlotProps } from "../../components/PickerPopper/PickerPopper.mjs";
-import { UsePickerParameters, UsePickerNonStaticProps, UsePickerProps } from "../usePicker/index.mjs";
-import { PickerFieldSlotProps, PickerOwnerState } from "../../../models/index.mjs";
-import { ExportedPickersLayoutSlots, ExportedPickersLayoutSlotProps, PickersLayoutSlotProps } from "../../../PickersLayout/PickersLayout.types.mjs";
-import { DateOrTimeViewWithMeridiem, PickerValue } from "../../models/index.mjs";
-import { PickerFieldUISlotsFromContext, PickerFieldUISlotPropsFromContext } from "../../components/PickerFieldUI.mjs";
-import { PickerStep } from "../../utils/createNonRangePickerStepNavigation.mjs";
+import type * as React from 'react';
+import type { MakeRequired, SlotComponentPropsFromProps } from '@mui/x-internals/types';
+import type { BasePickerProps } from "../../models/props/basePickerProps.mjs";
+import type { PickerPopperSlots, PickerPopperSlotProps } from "../../components/PickerPopper/PickerPopper.mjs";
+import type { UsePickerParameters, UsePickerNonStaticProps, UsePickerProps } from "../usePicker/index.mjs";
+import type { PickerFieldSlotProps, PickerOwnerState } from "../../../models/index.mjs";
+import type { ExportedPickersLayoutSlots, ExportedPickersLayoutSlotProps, PickersLayoutSlotProps } from "../../../PickersLayout/PickersLayout.types.mjs";
+import type { DateOrTimeViewWithMeridiem, PickerValue } from "../../models/index.mjs";
+import type { PickerFieldUISlotsFromContext, PickerFieldUISlotPropsFromContext } from "../../components/PickerFieldUI.mjs";
+import type { PickerStep } from "../../utils/createNonRangePickerStepNavigation.mjs";
 export interface UseDesktopPickerSlots extends Pick<PickerPopperSlots, 'desktopPaper' | 'desktopTransition' | 'desktopTrapFocus' | 'popper'>, ExportedPickersLayoutSlots<PickerValue>, PickerFieldUISlotsFromContext {
   /**
    * Component used to enter the date with the keyboard.

package/internals/hooks/useDesktopPicker/useDesktopPicker.types.d.ts

@@ -1,13 +1,13 @@
-import * as React from 'react';
-import { MakeRequired, SlotComponentPropsFromProps } from '@mui/x-internals/types';
-import { BasePickerProps } from "../../models/props/basePickerProps.js";
-import { PickerPopperSlots, PickerPopperSlotProps } from "../../components/PickerPopper/PickerPopper.js";
-import { UsePickerParameters, UsePickerNonStaticProps, UsePickerProps } from "../usePicker/index.js";
-import { PickerFieldSlotProps, PickerOwnerState } from "../../../models/index.js";
-import { ExportedPickersLayoutSlots, ExportedPickersLayoutSlotProps, PickersLayoutSlotProps } from "../../../PickersLayout/PickersLayout.types.js";
-import { DateOrTimeViewWithMeridiem, PickerValue } from "../../models/index.js";
-import { PickerFieldUISlotsFromContext, PickerFieldUISlotPropsFromContext } from "../../components/PickerFieldUI.js";
-import { PickerStep } from "../../utils/createNonRangePickerStepNavigation.js";
+import type * as React from 'react';
+import type { MakeRequired, SlotComponentPropsFromProps } from '@mui/x-internals/types';
+import type { BasePickerProps } from "../../models/props/basePickerProps.js";
+import type { PickerPopperSlots, PickerPopperSlotProps } from "../../components/PickerPopper/PickerPopper.js";
+import type { UsePickerParameters, UsePickerNonStaticProps, UsePickerProps } from "../usePicker/index.js";
+import type { PickerFieldSlotProps, PickerOwnerState } from "../../../models/index.js";
+import type { ExportedPickersLayoutSlots, ExportedPickersLayoutSlotProps, PickersLayoutSlotProps } from "../../../PickersLayout/PickersLayout.types.js";
+import type { DateOrTimeViewWithMeridiem, PickerValue } from "../../models/index.js";
+import type { PickerFieldUISlotsFromContext, PickerFieldUISlotPropsFromContext } from "../../components/PickerFieldUI.js";
+import type { PickerStep } from "../../utils/createNonRangePickerStepNavigation.js";
 export interface UseDesktopPickerSlots extends Pick<PickerPopperSlots, 'desktopPaper' | 'desktopTransition' | 'desktopTrapFocus' | 'popper'>, ExportedPickersLayoutSlots<PickerValue>, PickerFieldUISlotsFromContext {
   /**
    * Component used to enter the date with the keyboard.

package/internals/hooks/useField/buildSectionsFromFormat.d.mts

@@ -1,5 +1,5 @@
-import { FieldSection, MuiPickersAdapter, PickerValidDate } from "../../../models/index.mjs";
-import { PickersLocaleText } from "../../../locales/index.mjs";
+import type { FieldSection, MuiPickersAdapter, PickerValidDate } from "../../../models/index.mjs";
+import type { PickersLocaleText } from "../../../locales/index.mjs";
 interface BuildSectionsFromFormatParameters {
   adapter: MuiPickersAdapter;
   format: string;

package/internals/hooks/useField/buildSectionsFromFormat.d.ts

@@ -1,5 +1,5 @@
-import { FieldSection, MuiPickersAdapter, PickerValidDate } from "../../../models/index.js";
-import { PickersLocaleText } from "../../../locales/index.js";
+import type { FieldSection, MuiPickersAdapter, PickerValidDate } from "../../../models/index.js";
+import type { PickersLocaleText } from "../../../locales/index.js";
 interface BuildSectionsFromFormatParameters {
   adapter: MuiPickersAdapter;
   format: string;

package/internals/hooks/useField/syncSelectionToDOM.d.mts

@@ -1,6 +1,6 @@
-import { PickerValidValue } from "../../models/index.mjs";
-import { UseFieldDOMGetters } from "./useField.types.mjs";
-import { UseFieldStateReturnValue } from "./useFieldState.mjs";
+import type { PickerValidValue } from "../../models/index.mjs";
+import type { UseFieldDOMGetters } from "./useField.types.mjs";
+import type { UseFieldStateReturnValue } from "./useFieldState.mjs";
 export declare function syncSelectionToDOM<TValue extends PickerValidValue>(parameters: SyncSelectionToDOMParameters<TValue>): void;
 export interface SyncSelectionToDOMParameters<TValue extends PickerValidValue> {
   domGetters: UseFieldDOMGetters;

package/internals/hooks/useField/syncSelectionToDOM.d.ts

@@ -1,6 +1,6 @@
-import { PickerValidValue } from "../../models/index.js";
-import { UseFieldDOMGetters } from "./useField.types.js";
-import { UseFieldStateReturnValue } from "./useFieldState.js";
+import type { PickerValidValue } from "../../models/index.js";
+import type { UseFieldDOMGetters } from "./useField.types.js";
+import type { UseFieldStateReturnValue } from "./useFieldState.js";
 export declare function syncSelectionToDOM<TValue extends PickerValidValue>(parameters: SyncSelectionToDOMParameters<TValue>): void;
 export interface SyncSelectionToDOMParameters<TValue extends PickerValidValue> {
   domGetters: UseFieldDOMGetters;

package/internals/hooks/useField/useField.d.mts

@@ -1,3 +1,3 @@
-import { UseFieldParameters, UseFieldProps, UseFieldReturnValue } from "./useField.types.mjs";
-import { PickerValidValue } from "../../models/index.mjs";
+import type { UseFieldParameters, UseFieldProps, UseFieldReturnValue } from "./useField.types.mjs";
+import type { PickerValidValue } from "../../models/index.mjs";
 export declare const useField: <TValue extends PickerValidValue, TError, TValidationProps extends {}, TProps extends UseFieldProps>(parameters: UseFieldParameters<TValue, TError, TValidationProps, TProps>) => UseFieldReturnValue<TProps>;

package/internals/hooks/useField/useField.d.ts

@@ -1,3 +1,3 @@
-import { UseFieldParameters, UseFieldProps, UseFieldReturnValue } from "./useField.types.js";
-import { PickerValidValue } from "../../models/index.js";
+import type { UseFieldParameters, UseFieldProps, UseFieldReturnValue } from "./useField.types.js";
+import type { PickerValidValue } from "../../models/index.js";
 export declare const useField: <TValue extends PickerValidValue, TError, TValidationProps extends {}, TProps extends UseFieldProps>(parameters: UseFieldParameters<TValue, TError, TValidationProps, TProps>) => UseFieldReturnValue<TProps>;

package/internals/hooks/useField/useField.js

@@ -53,6 +53,7 @@ const useField = parameters => {
     sectionListRef: sectionListRefProp,
     onBlur,
     onClick,
+    onMouseDown,
     onFocus,
     onInput,
     onPaste,
@@ -167,6 +168,22 @@ const useField = parameters => {
     onClick?.(event);
     rootProps.onClick(event);
   });
+  const handleRootMouseDown = (0, _useEventCallback.default)(event => {
+    // The `isDefaultPrevented` check skips mousedowns that have already been
+    // suppressed before this handler runs -- in particular, propagated events
+    // from the clear / open buttons whose own handlers `preventDefault`, and
+    // capture-phase parents that intentionally block field interactions.
+    // Userland `onMouseDown` calling `event.preventDefault()` does *not*
+    // suppress `rootProps.onMouseDown` here: the prevent fires *after* this
+    // check, and `rootProps.onMouseDown` is the section-selection mechanism
+    // for the field -- letting consumers disable it inline would leave the
+    // field unable to focus a section on click.
+    if (event.isDefaultPrevented()) {
+      return;
+    }
+    onMouseDown?.(event);
+    rootProps.onMouseDown(event);
+  });
   const handleRootPaste = (0, _useEventCallback.default)(event => {
     onPaste?.(event);
     rootProps.onPaste(event);
@@ -253,6 +270,7 @@ Learn more about the field accessible DOM structure on the MUI documentation: ht
   return (0, _extends2.default)({}, forwardedProps, rootProps, {
     onBlur: handleRootBlur,
     onClick: handleRootClick,
+    onMouseDown: handleRootMouseDown,
     onFocus: handleRootFocus,
     onInput: handleRootInput,
     onPaste: handleRootPaste,

package/internals/hooks/useField/useField.mjs

@@ -46,6 +46,7 @@ export const useField = parameters => {
     sectionListRef: sectionListRefProp,
     onBlur,
     onClick,
+    onMouseDown,
     onFocus,
     onInput,
     onPaste,
@@ -160,6 +161,22 @@ export const useField = parameters => {
     onClick?.(event);
     rootProps.onClick(event);
   });
+  const handleRootMouseDown = useEventCallback(event => {
+    // The `isDefaultPrevented` check skips mousedowns that have already been
+    // suppressed before this handler runs -- in particular, propagated events
+    // from the clear / open buttons whose own handlers `preventDefault`, and
+    // capture-phase parents that intentionally block field interactions.
+    // Userland `onMouseDown` calling `event.preventDefault()` does *not*
+    // suppress `rootProps.onMouseDown` here: the prevent fires *after* this
+    // check, and `rootProps.onMouseDown` is the section-selection mechanism
+    // for the field -- letting consumers disable it inline would leave the
+    // field unable to focus a section on click.
+    if (event.isDefaultPrevented()) {
+      return;
+    }
+    onMouseDown?.(event);
+    rootProps.onMouseDown(event);
+  });
   const handleRootPaste = useEventCallback(event => {
     onPaste?.(event);
     rootProps.onPaste(event);
@@ -246,6 +263,7 @@ Learn more about the field accessible DOM structure on the MUI documentation: ht
   return _extends({}, forwardedProps, rootProps, {
     onBlur: handleRootBlur,
     onClick: handleRootClick,
+    onMouseDown: handleRootMouseDown,
     onFocus: handleRootFocus,
     onInput: handleRootInput,
     onPaste: handleRootPaste,

package/internals/hooks/useField/useField.types.d.mts

@@ -1,8 +1,8 @@
-import * as React from 'react';
-import { FieldSectionType, FieldSection, FieldSelectedSections, MuiPickersAdapter, TimezoneProps, FieldSectionContentType, PickerValidDate, FieldRef, OnErrorProps, InferFieldSection, PickerManager, PickerValueType } from "../../../models/index.mjs";
-import { InternalPropNames } from "../../../hooks/useSplitFieldProps.mjs";
+import type * as React from 'react';
+import type { FieldSectionType, FieldSection, FieldSelectedSections, MuiPickersAdapter, TimezoneProps, FieldSectionContentType, PickerValidDate, FieldRef, OnErrorProps, InferFieldSection, PickerManager, PickerValueType } from "../../../models/index.mjs";
+import type { InternalPropNames } from "../../../hooks/useSplitFieldProps.mjs";
 import type { PickersSectionElement, PickersSectionListRef } from "../../../PickersSectionList/index.mjs";
-import { FormProps, InferNonNullablePickerValue, PickerRangeValue, PickerValidValue } from "../../models/index.mjs";
+import type { FormProps, InferNonNullablePickerValue, PickerRangeValue, PickerValidValue } from "../../models/index.mjs";
 export interface UseFieldParameters<TValue extends PickerValidValue, TError, TValidationProps extends {}, TProps extends UseFieldProps> {
   manager: PickerManager<TValue, TError, TValidationProps, any>;
   props: TProps;
@@ -92,6 +92,7 @@ export interface UseFieldForwardedProps {
   focused?: boolean;
   sectionListRef?: React.Ref<PickersSectionListRef>;
   onClick?: React.MouseEventHandler;
+  onMouseDown?: React.MouseEventHandler;
   onKeyDown?: React.KeyboardEventHandler;
   onFocus?: React.FocusEventHandler;
   onBlur?: React.FocusEventHandler;

package/internals/hooks/useField/useField.types.d.ts

@@ -1,8 +1,8 @@
-import * as React from 'react';
-import { FieldSectionType, FieldSection, FieldSelectedSections, MuiPickersAdapter, TimezoneProps, FieldSectionContentType, PickerValidDate, FieldRef, OnErrorProps, InferFieldSection, PickerManager, PickerValueType } from "../../../models/index.js";
-import { InternalPropNames } from "../../../hooks/useSplitFieldProps.js";
+import type * as React from 'react';
+import type { FieldSectionType, FieldSection, FieldSelectedSections, MuiPickersAdapter, TimezoneProps, FieldSectionContentType, PickerValidDate, FieldRef, OnErrorProps, InferFieldSection, PickerManager, PickerValueType } from "../../../models/index.js";
+import type { InternalPropNames } from "../../../hooks/useSplitFieldProps.js";
 import type { PickersSectionElement, PickersSectionListRef } from "../../../PickersSectionList/index.js";
-import { FormProps, InferNonNullablePickerValue, PickerRangeValue, PickerValidValue } from "../../models/index.js";
+import type { FormProps, InferNonNullablePickerValue, PickerRangeValue, PickerValidValue } from "../../models/index.js";
 export interface UseFieldParameters<TValue extends PickerValidValue, TError, TValidationProps extends {}, TProps extends UseFieldProps> {
   manager: PickerManager<TValue, TError, TValidationProps, any>;
   props: TProps;
@@ -92,6 +92,7 @@ export interface UseFieldForwardedProps {
   focused?: boolean;
   sectionListRef?: React.Ref<PickersSectionListRef>;
   onClick?: React.MouseEventHandler;
+  onMouseDown?: React.MouseEventHandler;
   onKeyDown?: React.KeyboardEventHandler;
   onFocus?: React.FocusEventHandler;
   onBlur?: React.FocusEventHandler;

package/internals/hooks/useField/useField.utils.d.mts

@@ -1,12 +1,11 @@
-import { FieldSectionsValueBoundaries, SectionOrdering, FieldSectionValueBoundaries, FieldParsedSelectedSections } from "./useField.types.mjs";
-import { FieldSectionType, FieldSection, MuiPickersAdapter, FieldSectionContentType, PickersTimezone, PickerValidDate, FieldSelectedSections, PickerValueType, InferFieldSection } from "../../../models/index.mjs";
-import { PickerValidValue } from "../../models/index.mjs";
+import type { FieldSectionsValueBoundaries, SectionOrdering, FieldSectionValueBoundaries, FieldParsedSelectedSections } from "./useField.types.mjs";
+import type { FieldSectionType, FieldSection, MuiPickersAdapter, FieldSectionContentType, PickersTimezone, PickerValidDate, FieldSelectedSections, PickerValueType, InferFieldSection } from "../../../models/index.mjs";
+import type { PickerValidValue } from "../../models/index.mjs";
 export declare const getDateSectionConfigFromFormatToken: (adapter: MuiPickersAdapter, formatToken: string) => Pick<FieldSection, "type" | "contentType"> & {
   maxLength: number | undefined;
 };
 export declare const getDaysInWeekStr: (adapter: MuiPickersAdapter, format: string) => string[];
 export declare const getLetterEditingOptions: (adapter: MuiPickersAdapter, timezone: PickersTimezone, sectionType: FieldSectionType, format: string) => string[];
-export declare const FORMAT_SECONDS_NO_LEADING_ZEROS = "s";
 export declare const getLocalizedDigits: (adapter: MuiPickersAdapter) => string[];
 export declare const removeLocalizedDigits: (valueStr: string, localizedDigits: string[]) => string;
 export declare const applyLocalizedDigits: (valueStr: string, localizedDigits: string[]) => string;
@@ -30,6 +29,5 @@ export declare const createDateStrForHiddenInputFromSections: (sections: FieldSe
 export declare const getSectionsBoundaries: (adapter: MuiPickersAdapter, localizedDigits: string[], timezone: PickersTimezone) => FieldSectionsValueBoundaries;
 export declare const validateSections: <TValue extends PickerValidValue>(sections: InferFieldSection<TValue>[], valueType: PickerValueType) => void;
 export declare const mergeDateIntoReferenceDate: (adapter: MuiPickersAdapter, dateToTransferFrom: PickerValidDate, sections: FieldSection[], referenceDate: PickerValidDate, shouldLimitToEditedSections: boolean) => PickerValidDate;
-export declare const isAndroid: () => boolean;
 export declare const getSectionOrder: (sections: FieldSection[]) => SectionOrdering;
 export declare const parseSelectedSections: (selectedSections: FieldSelectedSections, sections: FieldSection[]) => FieldParsedSelectedSections;

package/internals/hooks/useField/useField.utils.d.ts

@@ -1,12 +1,11 @@
-import { FieldSectionsValueBoundaries, SectionOrdering, FieldSectionValueBoundaries, FieldParsedSelectedSections } from "./useField.types.js";
-import { FieldSectionType, FieldSection, MuiPickersAdapter, FieldSectionContentType, PickersTimezone, PickerValidDate, FieldSelectedSections, PickerValueType, InferFieldSection } from "../../../models/index.js";
-import { PickerValidValue } from "../../models/index.js";
+import type { FieldSectionsValueBoundaries, SectionOrdering, FieldSectionValueBoundaries, FieldParsedSelectedSections } from "./useField.types.js";
+import type { FieldSectionType, FieldSection, MuiPickersAdapter, FieldSectionContentType, PickersTimezone, PickerValidDate, FieldSelectedSections, PickerValueType, InferFieldSection } from "../../../models/index.js";
+import type { PickerValidValue } from "../../models/index.js";
 export declare const getDateSectionConfigFromFormatToken: (adapter: MuiPickersAdapter, formatToken: string) => Pick<FieldSection, "type" | "contentType"> & {
   maxLength: number | undefined;
 };
 export declare const getDaysInWeekStr: (adapter: MuiPickersAdapter, format: string) => string[];
 export declare const getLetterEditingOptions: (adapter: MuiPickersAdapter, timezone: PickersTimezone, sectionType: FieldSectionType, format: string) => string[];
-export declare const FORMAT_SECONDS_NO_LEADING_ZEROS = "s";
 export declare const getLocalizedDigits: (adapter: MuiPickersAdapter) => string[];
 export declare const removeLocalizedDigits: (valueStr: string, localizedDigits: string[]) => string;
 export declare const applyLocalizedDigits: (valueStr: string, localizedDigits: string[]) => string;
@@ -30,6 +29,5 @@ export declare const createDateStrForHiddenInputFromSections: (sections: FieldSe
 export declare const getSectionsBoundaries: (adapter: MuiPickersAdapter, localizedDigits: string[], timezone: PickersTimezone) => FieldSectionsValueBoundaries;
 export declare const validateSections: <TValue extends PickerValidValue>(sections: InferFieldSection<TValue>[], valueType: PickerValueType) => void;
 export declare const mergeDateIntoReferenceDate: (adapter: MuiPickersAdapter, dateToTransferFrom: PickerValidDate, sections: FieldSection[], referenceDate: PickerValidDate, shouldLimitToEditedSections: boolean) => PickerValidDate;
-export declare const isAndroid: () => boolean;
 export declare const getSectionOrder: (sections: FieldSection[]) => SectionOrdering;
 export declare const parseSelectedSections: (selectedSections: FieldSelectedSections, sections: FieldSection[]) => FieldParsedSelectedSections;

package/internals/hooks/useField/useField.utils.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.validateSections = exports.removeLocalizedDigits = exports.parseSelectedSections = exports.mergeDateIntoReferenceDate = exports.isStringNumber = exports.isAndroid = exports.getSectionsBoundaries = exports.getSectionVisibleValue = exports.getSectionOrder = exports.getLocalizedDigits = exports.getLetterEditingOptions = exports.getDaysInWeekStr = exports.getDateSectionConfigFromFormatToken = exports.getDateFromDateSections = exports.doesSectionFormatHaveLeadingZeros = exports.createDateStrForHiddenInputFromSections = exports.cleanLeadingZeros = exports.cleanDigitSectionValue = exports.changeSectionValueFormat = exports.applyLocalizedDigits = exports.FORMAT_SECONDS_NO_LEADING_ZEROS = void 0;
+exports.validateSections = exports.removeLocalizedDigits = exports.parseSelectedSections = exports.mergeDateIntoReferenceDate = exports.isStringNumber = exports.getSectionsBoundaries = exports.getSectionVisibleValue = exports.getSectionOrder = exports.getLocalizedDigits = exports.getLetterEditingOptions = exports.getDaysInWeekStr = exports.getDateSectionConfigFromFormatToken = exports.getDateFromDateSections = exports.doesSectionFormatHaveLeadingZeros = exports.createDateStrForHiddenInputFromSections = exports.cleanLeadingZeros = exports.cleanDigitSectionValue = exports.changeSectionValueFormat = exports.applyLocalizedDigits = void 0;
 var _formatErrorMessage2 = _interopRequireDefault(require("@mui/x-internals/formatErrorMessage"));
 var _dateUtils = require("../../utils/date-utils");
 var _timeUtils = require("../../utils/time-utils");
@@ -66,7 +66,7 @@ const getLetterEditingOptions = (adapter, timezone, sectionType, format) => {
 // This format should be the same on all the adapters
 // If some adapter does not respect this convention, then we will need to hardcode the format on each adapter.
 exports.getLetterEditingOptions = getLetterEditingOptions;
-const FORMAT_SECONDS_NO_LEADING_ZEROS = exports.FORMAT_SECONDS_NO_LEADING_ZEROS = 's';
+const FORMAT_SECONDS_NO_LEADING_ZEROS = 's';
 const NON_LOCALIZED_DIGITS = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9'];
 const getLocalizedDigits = adapter => {
   const today = adapter.date(undefined);
@@ -452,8 +452,6 @@ const mergeDateIntoReferenceDate = (adapter, dateToTransferFrom, sections, refer
   return mergedDate;
 }, referenceDate);
 exports.mergeDateIntoReferenceDate = mergeDateIntoReferenceDate;
-const isAndroid = () => navigator.userAgent.toLowerCase().includes('android');
-exports.isAndroid = isAndroid;
 const getSectionOrder = sections => {
   const neighbors = {};
   sections.forEach((_, index) => {

package/internals/hooks/useField/useField.utils.mjs

@@ -56,7 +56,7 @@ export const getLetterEditingOptions = (adapter, timezone, sectionType, format)
 
 // This format should be the same on all the adapters
 // If some adapter does not respect this convention, then we will need to hardcode the format on each adapter.
-export const FORMAT_SECONDS_NO_LEADING_ZEROS = 's';
+const FORMAT_SECONDS_NO_LEADING_ZEROS = 's';
 const NON_LOCALIZED_DIGITS = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9'];
 export const getLocalizedDigits = adapter => {
   const today = adapter.date(undefined);
@@ -428,7 +428,6 @@ export const mergeDateIntoReferenceDate = (adapter, dateToTransferFrom, sections
   }
   return mergedDate;
 }, referenceDate);
-export const isAndroid = () => navigator.userAgent.toLowerCase().includes('android');
 export const getSectionOrder = sections => {
   const neighbors = {};
   sections.forEach((_, index) => {

package/internals/hooks/useField/useFieldCharacterEditing.d.mts

@@ -1,5 +1,5 @@
-import { UseFieldStateReturnValue } from "./useFieldState.mjs";
-import { PickerValidValue } from "../../models/index.mjs";
+import type { UseFieldStateReturnValue } from "./useFieldState.mjs";
+import type { PickerValidValue } from "../../models/index.mjs";
 /**
  * Update the active section value when the user pressed a key that is not a navigation key (arrow key for example).
  * This hook has two main editing behaviors

package/internals/hooks/useField/useFieldCharacterEditing.d.ts

@@ -1,5 +1,5 @@
-import { UseFieldStateReturnValue } from "./useFieldState.js";
-import { PickerValidValue } from "../../models/index.js";
+import type { UseFieldStateReturnValue } from "./useFieldState.js";
+import type { PickerValidValue } from "../../models/index.js";
 /**
  * Update the active section value when the user pressed a key that is not a navigation key (arrow key for example).
  * This hook has two main editing behaviors