@mui/x-date-pickers 8.17.0 → 8.19.0

package/internals/hooks/usePicker/hooks/useValueAndOpenStates.js

@@ -112,6 +112,7 @@ function useValueAndOpenStates(parameters) {
       skipPublicationIfPristine = false,
       validationError,
       shortcut,
+      source,
       shouldClose = changeImportance === 'accept'
     } = options ?? {};
     let shouldFireOnChange;
@@ -134,8 +135,18 @@ function useValueAndOpenStates(parameters) {
     let cachedContext = null;
     const getContext = () => {
       if (!cachedContext) {
+        let inferredSource;
+        if (source) {
+          inferredSource = source;
+        } else if (shortcut) {
+          inferredSource = 'view';
+        } else {
+          // Default to unknown when not explicitly tagged by a picker call site
+          inferredSource = 'unknown';
+        }
         cachedContext = {
-          validationError: validationError == null ? getValidationErrorForNewValue(newValue) : validationError
+          validationError: validationError == null ? getValidationErrorForNewValue(newValue) : validationError,
+          source: inferredSource
         };
         if (shortcut) {
           cachedContext.shortcut = shortcut;
@@ -172,7 +183,8 @@ function useValueAndOpenStates(parameters) {
       return;
     }
     setValue(newValue, {
-      changeImportance: selectionState === 'finish' && closeOnSelect ? 'accept' : 'set'
+      changeImportance: selectionState === 'finish' && closeOnSelect ? 'accept' : 'set',
+      source: 'view'
     });
   });
 

package/internals/hooks/usePicker/usePicker.js

@@ -118,15 +118,23 @@ const usePicker = ({
     autoFocus: autoFocusView,
     getStepNavigation
   });
-  const clearValue = (0, _useEventCallback.default)(() => setValue(valueManager.emptyValue));
-  const setValueToToday = (0, _useEventCallback.default)(() => setValue(valueManager.getTodayValue(adapter, timezone, valueType)));
-  const acceptValueChanges = (0, _useEventCallback.default)(() => setValue(value));
+  const clearValue = (0, _useEventCallback.default)(() => setValue(valueManager.emptyValue, {
+    source: 'view'
+  }));
+  const setValueToToday = (0, _useEventCallback.default)(() => setValue(valueManager.getTodayValue(adapter, timezone, valueType), {
+    source: 'view'
+  }));
+  const acceptValueChanges = (0, _useEventCallback.default)(() => setValue(value, {
+    source: 'view'
+  }));
   const cancelValueChanges = (0, _useEventCallback.default)(() => setValue(state.lastCommittedValue, {
-    skipPublicationIfPristine: true
+    skipPublicationIfPristine: true,
+    source: 'view'
   }));
   const dismissViews = (0, _useEventCallback.default)(() => {
     setValue(value, {
-      skipPublicationIfPristine: true
+      skipPublicationIfPristine: true,
+      source: 'view'
     });
   });
   const {

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

@@ -28,7 +28,10 @@ export interface UsePickerBaseProps<TValue extends PickerValidValue, TView exten
    * @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 {TValue} value The new value.
-   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
+   * @param {FieldChangeHandlerContext<TError>} context Context about this change:
+   * - `validationError`: validation result of the current value
+   * - `source`: source of the change. One of 'field' | 'view' | 'unknown'
+   * - `shortcut` (optional): the shortcut metadata if the change was triggered by a shortcut selection
    */
   onChange?: (value: TValue, context: PickerChangeHandlerContext<TError>) => void;
   /**
@@ -36,7 +39,10 @@ export interface UsePickerBaseProps<TValue extends PickerValidValue, TView exten
    * @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 {TValue} value The value that was just accepted.
-   * @param {FieldChangeHandlerContext<TError>} context The context containing the validation result of the current value.
+   * @param {FieldChangeHandlerContext<TError>} context Context about this acceptance:
+   * - `validationError`: validation result of the current value
+   * - `source`: source of the acceptance. One of 'field' | 'picker' | 'unknown'
+   * - `shortcut` (optional): the shortcut metadata if the value was accepted via a shortcut selection
    */
   onAccept?: (value: TValue, context: PickerChangeHandlerContext<TError>) => void;
   /**

package/models/pickers.d.ts

@@ -2,6 +2,14 @@ import { PickerOrientation, PickerVariant } from "../internals/models/common.js"
 import type { PickersShortcutsItemContext } from "../PickersShortcuts/index.js";
 export interface PickerChangeHandlerContext<TError> {
   validationError: TError;
+  /**
+   * Source of the change that triggered `onChange` or `onAccept`.
+   * Simplified to one of the following values:
+   * - 'field' (changes coming from the text field)
+   * - 'view' (any interaction inside the picker UI: views, toolbar, action bar, shortcuts, etc.)
+   * - 'unknown' (unspecified or third-party triggers)
+   */
+  source: 'field' | 'view' | 'unknown';
   /**
    * Shortcut causing this `onChange` or `onAccept` call.
    * If the call has not been caused by a shortcut selection, this property will be `undefined`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-date-pickers",
-  "version": "8.17.0",
+  "version": "8.19.0",
   "author": "MUI Team",
   "description": "The community edition of the MUI X Date and Time Picker components.",
   "license": "MIT",
@@ -34,12 +34,12 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.28.4",
-    "@mui/utils": "^7.3.3",
+    "@mui/utils": "^7.3.5",
     "@types/react-transition-group": "^4.4.12",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
     "react-transition-group": "^4.4.5",
-    "@mui/x-internals": "8.17.0"
+    "@mui/x-internals": "8.19.0"
   },
   "peerDependencies": {
     "@emotion/react": "^11.9.0",