[pickers] Adds new source property to onChange and onAccept context object (#20234)

Signed-off-by: michel <jsnerdic@gmail.com>

Author: michelengelen

docs/data/date-pickers/lifecycle/lifecycle.md

@@ -206,8 +206,16 @@ The `onAccept` callback lets you get the final value selected by the user withou
 <DatePicker onAccept={(value) => sendValueToServer(value)} />
 ```
 
-:::success
-You can use the second argument passed to the `onAccept` callback to get the validation error associated with the current value:
+The `onAccept` callback receives a second argument `context` with extra information about why and how the value was accepted.
+
+- `validationError`: the validation result of the accepted value.
+- `source`: string that indicates where a change or acceptance originated from. The value is one of:
+  - `'field'`: committed from the input field (typing, paste, arrow keys, clear, Enter, etc.).
+  - `'view'`: any interaction inside the picker's view
+  - `'unknown'`: unspecified or third‑party triggers.
+- `shortcut` (optional): the shortcut metadata when the value was accepted via a shortcut selection.
+
+For custom error handling, you can use the `validationError` property of the `context` object.
 
 ```tsx
 <DatePicker
@@ -219,7 +227,32 @@ You can use the second argument passed to the `onAccept` callback to get the val
 />
 ```
 
-:::
+The `source` property allows you to implement different behaviors depending on the source of the acceptance.
+
+```tsx
+<DatePicker
+  onAccept={(newValue, context) => {
+    if (context.validationError != null) {
+      return; // ignore invalid values
+    }
+
+    switch (context.source) {
+      case 'view':
+        analytics.track('date_accepted_from_view', {
+          value: newValue,
+          shortcut: context.shortcut?.id,
+        });
+        break;
+      case 'field':
+        analytics.track('date_accepted_from_field', { value: newValue });
+        break;
+      case 'unknown':
+      default:
+        analytics.track('date_accepted_from_unknown', { value: newValue });
+    }
+  }}
+/>
+```
 
 ### When is "onAccept" called?
 
@@ -399,3 +432,37 @@ The following demo shows how to extend the Date Field component by adding an `on
 You can find more information about the `onAccept` prop [in the dedicated doc section](/x/react-date-pickers/lifecycle/#lifecycle-on-pickers-quot-onaccept-quot).
 
 {{"demo": "ServerInteraction.js"}}
+
+### Source values in `context.source`
+
+Pickers expose a simplified `context.source` string that indicates where a change or acceptance originated from.
+The value is one of:
+
+- `'field'`: committed from the input field (typing, paste, arrow keys, clear, Enter, etc.).
+- `'view'`: any interaction inside the picker's view
+- `'unknown'`: unspecified or third‑party triggers.
+
+Example usage:
+
+```tsx
+<DatePicker
+  onAccept={(value, context) => {
+    if (context.validationError) return;
+
+    switch (context.source) {
+      case 'picker':
+        analytics.track('date_accept_from_picker', {
+          value,
+          shortcut: context.shortcut?.id,
+        });
+        break;
+      case 'field':
+        analytics.track('date_accept_from_field', { value });
+        break;
+      case 'unknown':
+      default:
+        analytics.track('date_accept_from_unknown', { value });
+    }
+  }}
+/>
+```

docs/translations/api-docs/date-pickers/date-picker/date-picker.json

@@ -75,7 +75,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this acceptance: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the acceptance. One of &#39;field&#39; | &#39;picker&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the value was accepted via a shortcut selection</p>\n"
         }
       }
     },
@@ -90,7 +90,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this change: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the change. One of &#39;field&#39; | &#39;view&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the change was triggered by a shortcut selection</p>\n"
         }
       }
     },

docs/translations/api-docs/date-pickers/date-range-picker/date-range-picker.json

@@ -87,7 +87,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this acceptance: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the acceptance. One of &#39;field&#39; | &#39;picker&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the value was accepted via a shortcut selection</p>\n"
         }
       }
     },
@@ -102,7 +102,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this change: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the change. One of &#39;field&#39; | &#39;view&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the change was triggered by a shortcut selection</p>\n"
         }
       }
     },

docs/translations/api-docs/date-pickers/date-time-picker/date-time-picker.json

@@ -95,7 +95,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this acceptance: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the acceptance. One of &#39;field&#39; | &#39;picker&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the value was accepted via a shortcut selection</p>\n"
         }
       }
     },
@@ -110,7 +110,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this change: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the change. One of &#39;field&#39; | &#39;view&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the change was triggered by a shortcut selection</p>\n"
         }
       }
     },

docs/translations/api-docs/date-pickers/date-time-range-picker/date-time-range-picker.json

@@ -104,7 +104,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this acceptance: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the acceptance. One of &#39;field&#39; | &#39;picker&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the value was accepted via a shortcut selection</p>\n"
         }
       }
     },
@@ -119,7 +119,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this change: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the change. One of &#39;field&#39; | &#39;view&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the change was triggered by a shortcut selection</p>\n"
         }
       }
     },

docs/translations/api-docs/date-pickers/desktop-date-picker/desktop-date-picker.json

@@ -72,7 +72,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this acceptance: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the acceptance. One of &#39;field&#39; | &#39;picker&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the value was accepted via a shortcut selection</p>\n"
         }
       }
     },
@@ -87,7 +87,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this change: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the change. One of &#39;field&#39; | &#39;view&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the change was triggered by a shortcut selection</p>\n"
         }
       }
     },

docs/translations/api-docs/date-pickers/desktop-date-range-picker/desktop-date-range-picker.json

@@ -84,7 +84,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this acceptance: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the acceptance. One of &#39;field&#39; | &#39;picker&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the value was accepted via a shortcut selection</p>\n"
         }
       }
     },
@@ -99,7 +99,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this change: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the change. One of &#39;field&#39; | &#39;view&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the change was triggered by a shortcut selection</p>\n"
         }
       }
     },

docs/translations/api-docs/date-pickers/desktop-date-time-picker/desktop-date-time-picker.json

@@ -92,7 +92,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this acceptance: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the acceptance. One of &#39;field&#39; | &#39;picker&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the value was accepted via a shortcut selection</p>\n"
         }
       }
     },
@@ -107,7 +107,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this change: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the change. One of &#39;field&#39; | &#39;view&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the change was triggered by a shortcut selection</p>\n"
         }
       }
     },

docs/translations/api-docs/date-pickers/desktop-date-time-range-picker/desktop-date-time-range-picker.json

@@ -101,7 +101,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this acceptance: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the acceptance. One of &#39;field&#39; | &#39;picker&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the value was accepted via a shortcut selection</p>\n"
         }
       }
     },
@@ -116,7 +116,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this change: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the change. One of &#39;field&#39; | &#39;view&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the change was triggered by a shortcut selection</p>\n"
         }
       }
     },

docs/translations/api-docs/date-pickers/desktop-time-picker/desktop-time-picker.json

@@ -61,7 +61,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this acceptance: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the acceptance. One of &#39;field&#39; | &#39;picker&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the value was accepted via a shortcut selection</p>\n"
         }
       }
     },
@@ -76,7 +76,7 @@
         },
         "context": {
           "name": "context",
-          "description": "The context containing the validation result of the current value."
+          "description": "<p>Context about this change: - <code>validationError</code>: validation result of the current value - <code>source</code>: source of the change. One of &#39;field&#39; | &#39;view&#39; | &#39;unknown&#39; - <code>shortcut</code> (optional): the shortcut metadata if the change was triggered by a shortcut selection</p>\n"
         }
       }
     },