@mui/x-date-pickers 8.8.0 → 8.9.0

package/AdapterDayjs/AdapterDayjs.d.ts

@@ -1,6 +1,5 @@
-import defaultDayjs, { Dayjs } from 'dayjs';
+import dayjs, { Dayjs } from 'dayjs';
 import { FieldFormatTokenMap, MuiPickersAdapter, AdapterFormats, AdapterOptions, PickersTimezone, DateBuilderReturnType } from "../models/index.js";
-type Constructor = (...args: Parameters<typeof defaultDayjs>) => Dayjs;
 declare module '@mui/x-date-pickers/models' {
   interface PickerValidDateLookup {
     dayjs: Dayjs;
@@ -35,7 +34,6 @@ export declare class AdapterDayjs implements MuiPickersAdapter<string> {
   isMUIAdapter: boolean;
   isTimezoneCompatible: boolean;
   lib: string;
-  dayjs: Constructor;
   locale?: string;
   formats: AdapterFormats;
   escapedCharacters: {
@@ -67,11 +65,11 @@ export declare class AdapterDayjs implements MuiPickersAdapter<string> {
    */
   private adjustOffset;
   date: <T extends string | null | undefined>(value?: T, timezone?: PickersTimezone) => DateBuilderReturnType<T>;
-  getInvalidDate: () => defaultDayjs.Dayjs;
+  getInvalidDate: () => dayjs.Dayjs;
   getTimezone: (value: Dayjs) => string;
   setTimezone: (value: Dayjs, timezone: PickersTimezone) => Dayjs;
   toJsDate: (value: Dayjs) => Date;
-  parse: (value: string, format: string) => defaultDayjs.Dayjs | null;
+  parse: (value: string, format: string) => dayjs.Dayjs | null;
   getCurrentLocaleCode: () => string;
   is12HourCycleInCurrentLocale: () => boolean;
   expandFormat: (format: string) => string;
@@ -91,21 +89,21 @@ export declare class AdapterDayjs implements MuiPickersAdapter<string> {
   isBeforeYear: (value: Dayjs, comparing: Dayjs) => boolean;
   isBeforeDay: (value: Dayjs, comparing: Dayjs) => boolean;
   isWithinRange: (value: Dayjs, [start, end]: [Dayjs, Dayjs]) => boolean;
-  startOfYear: (value: Dayjs) => defaultDayjs.Dayjs;
-  startOfMonth: (value: Dayjs) => defaultDayjs.Dayjs;
-  startOfWeek: (value: Dayjs) => defaultDayjs.Dayjs;
-  startOfDay: (value: Dayjs) => defaultDayjs.Dayjs;
-  endOfYear: (value: Dayjs) => defaultDayjs.Dayjs;
-  endOfMonth: (value: Dayjs) => defaultDayjs.Dayjs;
-  endOfWeek: (value: Dayjs) => defaultDayjs.Dayjs;
-  endOfDay: (value: Dayjs) => defaultDayjs.Dayjs;
-  addYears: (value: Dayjs, amount: number) => defaultDayjs.Dayjs;
-  addMonths: (value: Dayjs, amount: number) => defaultDayjs.Dayjs;
-  addWeeks: (value: Dayjs, amount: number) => defaultDayjs.Dayjs;
-  addDays: (value: Dayjs, amount: number) => defaultDayjs.Dayjs;
-  addHours: (value: Dayjs, amount: number) => defaultDayjs.Dayjs;
-  addMinutes: (value: Dayjs, amount: number) => defaultDayjs.Dayjs;
-  addSeconds: (value: Dayjs, amount: number) => defaultDayjs.Dayjs;
+  startOfYear: (value: Dayjs) => dayjs.Dayjs;
+  startOfMonth: (value: Dayjs) => dayjs.Dayjs;
+  startOfWeek: (value: Dayjs) => dayjs.Dayjs;
+  startOfDay: (value: Dayjs) => dayjs.Dayjs;
+  endOfYear: (value: Dayjs) => dayjs.Dayjs;
+  endOfMonth: (value: Dayjs) => dayjs.Dayjs;
+  endOfWeek: (value: Dayjs) => dayjs.Dayjs;
+  endOfDay: (value: Dayjs) => dayjs.Dayjs;
+  addYears: (value: Dayjs, amount: number) => dayjs.Dayjs;
+  addMonths: (value: Dayjs, amount: number) => dayjs.Dayjs;
+  addWeeks: (value: Dayjs, amount: number) => dayjs.Dayjs;
+  addDays: (value: Dayjs, amount: number) => dayjs.Dayjs;
+  addHours: (value: Dayjs, amount: number) => dayjs.Dayjs;
+  addMinutes: (value: Dayjs, amount: number) => dayjs.Dayjs;
+  addSeconds: (value: Dayjs, amount: number) => dayjs.Dayjs;
   getYear: (value: Dayjs) => number;
   getMonth: (value: Dayjs) => number;
   getDate: (value: Dayjs) => number;
@@ -113,17 +111,16 @@ export declare class AdapterDayjs implements MuiPickersAdapter<string> {
   getMinutes: (value: Dayjs) => number;
   getSeconds: (value: Dayjs) => number;
   getMilliseconds: (value: Dayjs) => number;
-  setYear: (value: Dayjs, year: number) => defaultDayjs.Dayjs;
-  setMonth: (value: Dayjs, month: number) => defaultDayjs.Dayjs;
-  setDate: (value: Dayjs, date: number) => defaultDayjs.Dayjs;
-  setHours: (value: Dayjs, hours: number) => defaultDayjs.Dayjs;
-  setMinutes: (value: Dayjs, minutes: number) => defaultDayjs.Dayjs;
-  setSeconds: (value: Dayjs, seconds: number) => defaultDayjs.Dayjs;
-  setMilliseconds: (value: Dayjs, milliseconds: number) => defaultDayjs.Dayjs;
+  setYear: (value: Dayjs, year: number) => dayjs.Dayjs;
+  setMonth: (value: Dayjs, month: number) => dayjs.Dayjs;
+  setDate: (value: Dayjs, date: number) => dayjs.Dayjs;
+  setHours: (value: Dayjs, hours: number) => dayjs.Dayjs;
+  setMinutes: (value: Dayjs, minutes: number) => dayjs.Dayjs;
+  setSeconds: (value: Dayjs, seconds: number) => dayjs.Dayjs;
+  setMilliseconds: (value: Dayjs, milliseconds: number) => dayjs.Dayjs;
   getDaysInMonth: (value: Dayjs) => number;
-  getWeekArray: (value: Dayjs) => defaultDayjs.Dayjs[][];
+  getWeekArray: (value: Dayjs) => dayjs.Dayjs[][];
   getWeekNumber: (value: Dayjs) => number;
   getDayOfWeek(value: Dayjs): number;
-  getYearRange: ([start, end]: [Dayjs, Dayjs]) => defaultDayjs.Dayjs[];
-}
-export {};
+  getYearRange: ([start, end]: [Dayjs, Dayjs]) => dayjs.Dayjs[];
+}

package/AdapterDayjs/AdapterDayjs.js

@@ -135,7 +135,6 @@ const defaultFormats = {
 };
 const MISSING_UTC_PLUGIN = ['Missing UTC plugin', 'To be able to use UTC or timezones, you have to enable the `utc` plugin', 'Find more information on https://mui.com/x/react-date-pickers/timezone/#day-js-and-utc'].join('\n');
 const MISSING_TIMEZONE_PLUGIN = ['Missing timezone plugin', 'To be able to use timezones, you have to enable both the `utc` and the `timezone` plugin', 'Find more information on https://mui.com/x/react-date-pickers/timezone/#day-js-and-timezone'].join('\n');
-const withLocale = (dayjs, locale) => !locale ? dayjs : (...args) => dayjs(...args).locale(locale);
 /**
  * Based on `@date-io/dayjs`
  *
@@ -169,7 +168,6 @@ class AdapterDayjs {
     this.isMUIAdapter = true;
     this.isTimezoneCompatible = true;
     this.lib = 'dayjs';
-    this.dayjs = void 0;
     this.locale = void 0;
     this.formats = void 0;
     this.escapedCharacters = {
@@ -210,24 +208,26 @@ class AdapterDayjs {
       }
     };
     this.createSystemDate = value => {
+      let date;
       if (this.hasUTCPlugin() && this.hasTimezonePlugin()) {
         const timezone = _dayjs.default.tz.guess();
-
-        // We can't change the system timezone in the tests
-        /* v8 ignore next 3 */
-        if (timezone !== 'UTC') {
-          return _dayjs.default.tz(value, timezone);
+        if (timezone === 'UTC') {
+          date = (0, _dayjs.default)(value);
+        } /* v8 ignore next 3 */else {
+          // We can't change the system timezone in the tests
+          date = _dayjs.default.tz(value, timezone);
         }
-        return (0, _dayjs.default)(value);
+      } else {
+        date = (0, _dayjs.default)(value);
       }
-      return (0, _dayjs.default)(value);
+      return this.setLocaleToValue(date);
     };
     this.createUTCDate = value => {
       /* v8 ignore next 3 */
       if (!this.hasUTCPlugin()) {
         throw new Error(MISSING_UTC_PLUGIN);
       }
-      return _dayjs.default.utc(value);
+      return this.setLocaleToValue(_dayjs.default.utc(value));
     };
     this.createTZDate = (value, timezone) => {
       /* v8 ignore next 3 */
@@ -240,7 +240,7 @@ class AdapterDayjs {
         throw new Error(MISSING_TIMEZONE_PLUGIN);
       }
       const keepLocalTime = value !== undefined && !value.endsWith('Z');
-      return (0, _dayjs.default)(value).tz(this.cleanTimezone(timezone), keepLocalTime);
+      return this.setLocaleToValue((0, _dayjs.default)(value).tz(this.cleanTimezone(timezone), keepLocalTime));
     };
     this.getLocaleFormats = () => {
       const locales = _dayjs.default.Ls;
@@ -287,18 +287,13 @@ class AdapterDayjs {
       if (value === null) {
         return null;
       }
-      let parsedValue;
       if (timezone === 'UTC') {
-        parsedValue = this.createUTCDate(value);
-      } else if (timezone === 'system' || timezone === 'default' && !this.hasTimezonePlugin()) {
-        parsedValue = this.createSystemDate(value);
-      } else {
-        parsedValue = this.createTZDate(value, timezone);
+        return this.createUTCDate(value);
       }
-      if (this.locale === undefined) {
-        return parsedValue;
+      if (timezone === 'system' || timezone === 'default' && !this.hasTimezonePlugin()) {
+        return this.createSystemDate(value);
       }
-      return parsedValue.locale(this.locale);
+      return this.createTZDate(value, timezone);
     };
     this.getInvalidDate = () => (0, _dayjs.default)(new Date('Invalid date'));
     this.getTimezone = value => {
@@ -340,7 +335,7 @@ class AdapterDayjs {
         /* v8 ignore next */
         throw new Error(MISSING_TIMEZONE_PLUGIN);
       }
-      return _dayjs.default.tz(value, this.cleanTimezone(timezone));
+      return this.setLocaleToValue(_dayjs.default.tz(value, this.cleanTimezone(timezone)));
     };
     this.toJsDate = value => {
       return value.toDate();
@@ -349,7 +344,7 @@ class AdapterDayjs {
       if (value === '') {
         return null;
       }
-      return this.dayjs(value, format, this.locale, true);
+      return (0, _dayjs.default)(value, format, this.locale, true);
     };
     this.getCurrentLocaleCode = () => {
       return this.locale || 'en';
@@ -378,7 +373,7 @@ class AdapterDayjs {
       return this.formatByString(value, this.formats[formatKey]);
     };
     this.formatByString = (value, formatString) => {
-      return this.dayjs(value).format(formatString);
+      return this.setLocaleToValue(value).format(formatString);
     };
     this.formatNumber = numberToFormat => {
       return numberToFormat;
@@ -462,25 +457,25 @@ class AdapterDayjs {
       return this.adjustOffset(value.endOf('day'));
     };
     this.addYears = (value, amount) => {
-      return this.adjustOffset(amount < 0 ? value.subtract(Math.abs(amount), 'year') : value.add(amount, 'year'));
+      return this.adjustOffset(value.add(amount, 'year'));
     };
     this.addMonths = (value, amount) => {
-      return this.adjustOffset(amount < 0 ? value.subtract(Math.abs(amount), 'month') : value.add(amount, 'month'));
+      return this.adjustOffset(value.add(amount, 'month'));
     };
     this.addWeeks = (value, amount) => {
-      return this.adjustOffset(amount < 0 ? value.subtract(Math.abs(amount), 'week') : value.add(amount, 'week'));
+      return this.adjustOffset(value.add(amount, 'week'));
     };
     this.addDays = (value, amount) => {
-      return this.adjustOffset(amount < 0 ? value.subtract(Math.abs(amount), 'day') : value.add(amount, 'day'));
+      return this.adjustOffset(value.add(amount, 'day'));
     };
     this.addHours = (value, amount) => {
-      return this.adjustOffset(amount < 0 ? value.subtract(Math.abs(amount), 'hour') : value.add(amount, 'hour'));
+      return this.adjustOffset(value.add(amount, 'hour'));
     };
     this.addMinutes = (value, amount) => {
-      return this.adjustOffset(amount < 0 ? value.subtract(Math.abs(amount), 'minute') : value.add(amount, 'minute'));
+      return this.adjustOffset(value.add(amount, 'minute'));
     };
     this.addSeconds = (value, amount) => {
-      return this.adjustOffset(amount < 0 ? value.subtract(Math.abs(amount), 'second') : value.add(amount, 'second'));
+      return this.adjustOffset(value.add(amount, 'second'));
     };
     this.getYear = value => {
       return value.year();
@@ -556,7 +551,6 @@ class AdapterDayjs {
       }
       return years;
     };
-    this.dayjs = withLocale(_dayjs.default, _locale);
     this.locale = _locale;
     this.formats = (0, _extends2.default)({}, defaultFormats, formats);
 

package/CHANGELOG.md

@@ -5,6 +5,101 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 8.9.0
+
+_Jul 17, 2025_
+
+We'd like to extend a big thank you to the 10 contributors who made this release possible. Here are some highlights ✨:
+
+- ✨ Improve the drag and drop interaction for Data Grid [row reordering](https://mui.com/x/react-data-grid/row-ordering/) feature. It uses a drop indicator to point to the position the row would be moving to.
+
+  https://github.com/user-attachments/assets/37284c4f-e8d4-4fc6-a6af-a780592905ef
+
+- 🚀 Improve Data Grid Pivoting and Aggregation performance
+
+- 📊 Add `minBarSize` to set a minimum height for bars
+
+Special thanks go out to the community members for their valuable contributions:
+@lauri865
+
+The following are all team members who have contributed to this release:
+@alexfauquette, @arminmeh, @bernardobelchior, @flaviendelangle, @JCQuintas, @LukasTy, @mapache-salvaje, @noraleonte, @MBilalShafi
+
+### Data Grid
+
+#### `@mui/x-data-grid@8.9.0`
+
+Internal changes.
+
+#### `@mui/x-data-grid-pro@8.9.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-data-grid@8.9.0`, plus:
+
+- [DataGridPro] Row reorder using drop indicator (#18627) @MBilalShafi
+
+#### `@mui/x-data-grid-premium@8.9.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-data-grid-pro@8.9.0`, plus:
+
+- [DataGridPremium] Allow group column overrides with pivoting (#18765) @arminmeh
+- [DataGridPremium] Support sort-dependent aggregation and improve performance (#18348) @lauri865
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@8.9.0`
+
+- [pickers] Avoid useless date creation in `AdapterDayjs` (#18429) @flaviendelangle
+- [pickers] Fix `timeSteps` JSDoc (#18807) @LukasTy
+
+#### `@mui/x-date-pickers-pro@8.9.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-date-pickers@8.9.0`.
+
+### Charts
+
+#### `@mui/x-charts@8.9.0`
+
+- [charts] Add `minBarSize` to prevent bars from having 0 height (#18798) @JCQuintas
+- [charts] Add click listener to radar charts (#18773) @alexfauquette
+- [charts] Improve scatter chart pointer move performance (#18775) @bernardobelchior
+- [charts] Simplify radar internal hooks (#18760) @alexfauquette
+- [charts] `minBarSize` now ignores `0` and `null` values (#18816) @JCQuintas
+- [charts] Fix y-axis tick label overlap when using log scale (#18744) @bernardobelchior
+- [charts] Expose <ChartType>Series type for all chart types (#18805) @bernardobelchior
+
+#### `@mui/x-charts-pro@8.9.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-charts@8.9.0` plus:
+
+[charts-pro] Fix issue where charts gestures weren't properly working when inside the shadow-dom (#18837) @JCQuintas
+
+### Tree View
+
+#### `@mui/x-tree-view@8.9.0`
+
+Internal changes.
+
+#### `@mui/x-tree-view-pro@8.9.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-tree-view@8.9.0`.
+
+### Codemod
+
+#### `@mui/x-codemod@8.9.0`
+
+Internal changes.
+
+### Docs
+
+- [data grid][docs] Revise the Pro filter docs (#17929) @mapache-salvaje
+- [charts][docs] Move mark outside clip-path (#18806) @alexfauquette
+
+### Miscellaneous
+
+- [code-infra] Fix ESLint `import` restriction rule for test files (#18669) @LukasTy
+- [code-infra] Remove charts benchmarks dependency on `@testing-library/jest-dom` (#18800) @bernardobelchior
+- [code-infra] Remove duplicate dependency from `eslint-plugin-mui-x` (#18797) @bernardobelchior
+
 ## 8.8.0
 
 _Jul 11, 2025_
@@ -216,6 +311,7 @@ We'd like to extend a big thank you to the 12 contributors who made this release
 - 📅 Add `usePickerAdapter` hook to access the date adapter.
 
   You can use the adapter in your custom components if you need them to work with multiple date libraries — [Learn more](https://mui.com/x/react-date-pickers/custom-components/#access-date-adapter).
+
 - 🌎 Improve Danish (da-DK) locale
 - 🌎 Improve German (de-DE) locale
 
@@ -234,13 +330,13 @@ The following are all team members who have contributed to this release:
 - [l10n] Improve Danish (da-DK) locale (#18428) @ShahrazH
 - [l10n] Improve German (de-DE) locale (#18388) @omalyutin
 
-#### `@mui/x-data-grid-pro@8.6.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link "Pro plan")
+#### `@mui/x-data-grid-pro@8.6.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
 
 Same changes as in `@mui/x-data-grid@8.6.0`, plus:
 
 - [DataGridPro] Fix lazy loading params calculated from rendering context (#18460) @arminmeh
 
-#### `@mui/x-data-grid-premium@8.6.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link "Premium plan")
+#### `@mui/x-data-grid-premium@8.6.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
 
 Same changes as in `@mui/x-data-grid-pro@8.6.0`.
 
@@ -252,7 +348,7 @@ Same changes as in `@mui/x-data-grid-pro@8.6.0`.
 - [pickers] Fix to use latest `value` when updating `lastCommittedValue` in internal state (#18518) @LukasTy
 - [pickers] Use `usePickerAdapter` hook internally instead of `useUtils` (#18465) @LukasTy
 
-#### `@mui/x-date-pickers-pro@8.6.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link "Pro plan")
+#### `@mui/x-date-pickers-pro@8.6.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
 
 Same changes as in `@mui/x-date-pickers@8.6.0`.
 
@@ -269,7 +365,7 @@ Same changes as in `@mui/x-date-pickers@8.6.0`.
 - [charts] Improve touch behavior for polar axis (#18531) @JCQuintas
 - [charts] Add `isElementInside` helper (#18530) @JCQuintas
 
-#### `@mui/x-charts-pro@8.6.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link "Pro plan")
+#### `@mui/x-charts-pro@8.6.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
 
 Same changes as in `@mui/x-charts@8.6.0`, plus:
 
@@ -283,7 +379,7 @@ Same changes as in `@mui/x-charts@8.6.0`, plus:
 
 Internal changes.
 
-#### `@mui/x-tree-view-pro@8.6.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link "Pro plan")
+#### `@mui/x-tree-view-pro@8.6.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
 
 Same changes as in `@mui/x-tree-view@8.6.0`, plus:
 
@@ -1498,7 +1594,6 @@ Same changes as in `@mui/x-date-pickers@8.0.0-beta.3`.
 
 - Removed `react-spring` as a dependency of `@mui/x-charts`.
   A consequence of this change is that the props of some slots have been changed because the `SpringValue` wrapper has been removed. The affected slots and props are:
-
   - the type of the `x`, `y`, `width` and `height` props of the `bar` slot are now `number`;
   - the type of `startAngle`, `endAngle`, `innerRadius`, `outerRadius`, `arcLabelRadius`, `cornerRadius` and `paddingAngle` props of `pieArc` and `pieArcLabel` slot are now `number`.
 
@@ -2066,7 +2161,6 @@ Following are all team members who have contributed to this release:
 - The `slots.baseFormControl` component was removed.
 
 - The "Reset" button in the column visibility panel now resets to the initial column visibility model. Previously it was reset to the model that was active at the time the panel was opened. The reset behavior follows these rules:
-
   1. If an initial `columnVisibilityModel` is provided, it resets to that model.
   2. If a controlled `columnVisibilityModel` is provided, it resets to the first model value.
   3. When the columns are updated (via the `columns` prop or `updateColumns()` API method), the reset reference point updates to the current `columnVisibilityModel`.
@@ -2089,7 +2183,6 @@ Following are all team members who have contributed to this release:
   The `exclude` selection type allows to select all rows except the ones in the `ids` set.
 
   This change impacts the following props:
-
   - `rowSelectionModel`
   - `onRowSelectionModelChange`
   - `initialState.rowSelectionModel`
@@ -2413,7 +2506,6 @@ Same changes as in `@mui/x-data-grid-pro@8.0.0-alpha.12`, plus:
 - The `aria-label` on the `<Clock />` component and Time Picker opening button has been fixed to rely on the set `ampm` property instead of defaulting to the user's locale.
 
 - The following unused formats have been removed from the adapters and can no longer be overridden via the `dateFormats` prop on the `<LocalizationProvider />` component:
-
   - `fullTime` - please use `fullTime12h` and `fullTime24h` instead:
     ```diff
       <LocalizationProvider
@@ -2628,7 +2720,6 @@ Following are all team members who have contributed to this release:
 
 - `viewportInnerSize.width` now includes pinned columns' widths (fixes recursive loops in updating dimensions <-> columns)
 - The Data Grid now has a default background color, and its customization has moved from `theme.mixins.MuiDataGrid` to `theme.palette.DataGrid` with the following properties:
-
   - `bg`: Sets the background color of the entire grid (new property)
   - `headerBg`: Sets the background color of the header (previously named `containerBackground`)
   - `pinnedBg`: Sets the background color of pinned rows and columns (previously named `pinnedBackground`)
@@ -2657,7 +2748,6 @@ Following are all team members who have contributed to this release:
   Only the initial value and the type are updated. Logic that initializes the API and its availability remained the same, which means that if you could access API in a particular line of your code before, you are able to access it as well after this change.
 
   Depending on the context in which the API is being used, you can decide what is the best way to deal with `null` value. Some options are:
-
   - Use optional chaining
   - Use non-null assertion operator if you are sure your code is always executed when the `apiRef` is not `null`
   - Return early if `apiRef` is `null`
@@ -3181,7 +3271,6 @@ Following are all team members who have contributed to this release:
 #### Breaking changes
 
 - Passing additional props (like `data-*`, `aria-*`) directly on the Data Grid component is no longer supported. To pass the props, use `slotProps`:
-
   - For `.root` element, use `slotProps.root`.
   - For `.main` element (the one with `role="grid"`), use `slotProps.main`.
 
@@ -3698,14 +3787,12 @@ Same changes as in `@mui/x-date-pickers@v8.0.0-alpha.1`, plus:
 #### Breaking change
 
 - The DX of the Tooltip customization has been refactored
-
   - The `tooltip` prop has been removed in favor of `slotProps.tooltip` for consistency.
   - The `popper`, `axisContent`, and `itemContent` slots have been removed in favor of the `tooltip` slot which overrides the entire tooltip.
     - To override the tooltip content, use the `useItemTooltip` or `useAxisTooltip` hook to get the data, and wrap your component in `ChartsTooltipContainer` to follow the pointer position.
     - To override the tooltip placement, use the `ChartsItemTooltipContent` or `ChartsItemTooltipContent` to get default data and place them in your custom tooltip.
 
 - The library now uses the SVG `filter` attribute instead of `d3-color` for color manipulation.
-
   - This modification impacts the `LinePlot`, `AreaPlot`, and `BarPlot` components.
     If you've customized the `fill` of those elements, you might need to override it by using the CSS `filter`.
   - The `theme.styleOverride` is removed for `MuiLineElement`, `MuiAreaElement`, and `MuiBarElement` to improve performance.
@@ -3815,14 +3902,12 @@ Same changes as in `@mui/x-data-grid-pro@8.0.0-alpha.0`, plus:
 #### Breaking changes
 
 - The default DOM structure of the field has changed [Learn more](https://mui.com/x/migration/migration-pickers-v7/#new-dom-structure-for-the-field).
-
   - Before version `v8.x`, the fields' DOM structure consisted of an `<input />`, which held the whole value for the component, but unfortunately presents a few limitations in terms of accessibility when managing multiple section values.
   - Starting with version `v8.x`, all the field and picker components come with a new DOM structure that allows the field component to set aria attributes on individual sections, providing a far better experience with screen readers.
 
 - Some translation keys no longer require `utils` and the date object as parameters, but only the formatted value as a string. The keys affected by this changes are: `clockLabelText`, `openDatePickerDialogue` and `openTimePickerDialogue` — [Learn more](https://mui.com/x/migration/migration-pickers-v7/#stop-passing-utils-and-the-date-object-to-some-translation-keys).
 
 - The following types are no longer exported by `@mui/x-date-pickers` and `@mui/x-date-pickers-pro` — [Learn more](https://mui.com/x/migration/migration-pickers-v7/#removed-types).
-
   - `UseDateFieldComponentProps`
   - `UseTimeFieldComponentProps`
   - `UseDateTimeFieldComponentProps`
@@ -3870,7 +3955,6 @@ Same changes as in `@mui/x-date-pickers@8.0.0-alpha.0`.
 - The `slots.legend` does not receive the `drawingArea` prop. You can still access your custom legend with the `useDrawingArea()` hook if your custom legend needs it.
 
 - Removed or renamed multiple props from Series — [Learn more](https://mui.com/x/migration/migration-charts-v7/#series-properties-renaming).
-
   - The `highlighted` and `faded` properties of highlightScope have been deprecated in favor of `highlight` and `fade`.
     The deprecated ones are now removed.
   - The `xAxisKey`, `yAxisKey`, and `zAxisKey` properties have been deprecated in favor of `xAxisId`, `yAxisId`, and `zAxisId`.
@@ -6134,7 +6218,6 @@ We'd like to offer a big thanks to the 12 contributors who made this release pos
   <img width="287" src="https://github.com/user-attachments/assets/78bd83c5-7ce4-4ed7-acf9-be70b2dbce54" alt="Item reordering using drag and drop" />
 
 - 📦 Support CommonJS bundle out of the box on `@mui/x-charts` by adding vendored D3 dependencies.
-
   - This modifies how the package imports D3.js. It will impact you if you use `d3` packages installed by `@mui/x-charts` and don't have them in your `package.json`. You shouldn't be affected otherwise.
   - For more context, the initial issue is caused by D3 only exporting ESM.
 
@@ -7669,7 +7752,6 @@ We'd like to offer a big thanks to the 12 contributors who made this release pos
 #### Breaking changes
 
 - The `density` is a [controlled prop](https://mui.com/x/react-data-grid/accessibility/#set-the-density-programmatically) now, if you were previously passing the `density` prop to the Data Grid, you will need to do one of the following:
-
   1. Move it to the `initialState.density` to initialize it.
 
   ```diff
@@ -8175,7 +8257,6 @@ Same changes as in `@mui/x-data-grid-pro@7.0.0-beta.4`.
   ```
 
 - The following internal types were exported by mistake and have been removed from the public API:
-
   - `UseDateFieldDefaultizedProps`
   - `UseTimeFieldDefaultizedProps`
   - `UseDateTimeFieldDefaultizedProps`
@@ -8416,7 +8497,6 @@ We'd like to offer a big thanks to the 12 contributors who made this release pos
 - 🎁 The Line Chart component now has animation by default (#11620) @alexfauquette
 - 🚀 All charts have click handlers (#11411) @alexfauquette
   Test their respective documentation demonstrations to know more about the data format:
-
   - [Scatter Chart](https://v7.mui.com/x/react-charts/scatter/#click-event)
   - [Line Chart](https://v7.mui.com/x/react-charts/lines/#click-event)
   - [Bar Chart](https://v7.mui.com/x/react-charts/bars/#click-event)
@@ -8696,7 +8776,6 @@ We'd like to offer a big thanks to the 11 contributors who made this release pos
   ```
 
   The most notable changes that might affect your application or tests are:
-
   - The `role="grid"` attribute along with related ARIA attributes are now applied to the inner `div` element instead of the root `div` element:
 
     ```diff
@@ -9247,7 +9326,6 @@ We'd like to offer a big thanks to the 6 contributors who made this release poss
 
 - The filter panel no longer uses the native version of the [`Select`](https://mui.com/material-ui/react-select/) component for all components.
 - The `getOptionValue` and `getOptionLabel` props were removed from the following components:
-
   - `GridEditSingleSelectCell`
   - `GridFilterInputSingleSelect`
   - `GridFilterInputMultipleSingleSelect`
@@ -9661,7 +9739,6 @@ Same changes as in `@mui/x-data-grid-pro@7.0.0-alpha.3`, plus:
 - Add new parameters to the `shortcuts` slot `onChange` callback
 
   The `onChange` callback fired when selecting a shortcut now requires two new parameters (previously they were optional):
-
   - The [`changeImportance`](/x/react-date-pickers/shortcuts/#behavior-when-selecting-a-shortcut) of the shortcut.
   - The `item` containing the entire shortcut object.
 

package/DateCalendar/DateCalendar.js

@@ -466,7 +466,7 @@ process.env.NODE_ENV !== "production" ? DateCalendar.propTypes = {
   onChange: _propTypes.default.func,
   /**
    * Callback fired on focused view change.
-   * @template TView
+   * @template TView Type of the view. It will vary based on the Picker type and the `views` it uses.
    * @param {TView} view The new view to focus or not.
    * @param {boolean} hasFocus `true` if the view should be focused.
    */
@@ -478,7 +478,7 @@ process.env.NODE_ENV !== "production" ? DateCalendar.propTypes = {
   onMonthChange: _propTypes.default.func,
   /**
    * Callback fired on view change.
-   * @template TView
+   * @template TView Type of the view. It will vary based on the Picker type and the `views` it uses.
    * @param {TView} view The new view.
    */
   onViewChange: _propTypes.default.func,

package/DatePicker/DatePicker.js

@@ -226,7 +226,7 @@ process.env.NODE_ENV !== "production" ? DatePicker.propTypes = {
   onSelectedSectionsChange: _propTypes.default.func,
   /**
    * Callback fired on view change.
-   * @template TView
+   * @template TView Type of the view. It will vary based on the Picker type and the `views` it uses.
    * @param {TView} view The new view.
    */
   onViewChange: _propTypes.default.func,

package/DateTimePicker/DateTimePicker.js

@@ -264,7 +264,7 @@ process.env.NODE_ENV !== "production" ? DateTimePicker.propTypes = {
   onSelectedSectionsChange: _propTypes.default.func,
   /**
    * Callback fired on view change.
-   * @template TView
+   * @template TView Type of the view. It will vary based on the Picker type and the `views` it uses.
    * @param {TView} view The new view.
    */
   onViewChange: _propTypes.default.func,
@@ -385,8 +385,8 @@ process.env.NODE_ENV !== "production" ? DateTimePicker.propTypes = {
   thresholdToRenderTimeInASingleColumn: _propTypes.default.number,
   /**
    * The time steps between two time unit options.
-   * For example, if `timeStep.minutes = 8`, then the available minute options will be `[0, 8, 16, 24, 32, 40, 48, 56]`.
-   * When single column time renderer is used, only `timeStep.minutes` will be used.
+   * For example, if `timeSteps.minutes = 8`, then the available minute options will be `[0, 8, 16, 24, 32, 40, 48, 56]`.
+   * When single column time renderer is used, only `timeSteps.minutes` will be used.
    * @default{ hours: 1, minutes: 5, seconds: 5 }
    */
   timeSteps: _propTypes.default.shape({

package/DesktopDatePicker/DesktopDatePicker.js

@@ -237,7 +237,7 @@ DesktopDatePicker.propTypes = {
   onSelectedSectionsChange: _propTypes.default.func,
   /**
    * Callback fired on view change.
-   * @template TView
+   * @template TView Type of the view. It will vary based on the Picker type and the `views` it uses.
    * @param {TView} view The new view.
    */
   onViewChange: _propTypes.default.func,

package/DesktopDateTimePicker/DesktopDateTimePicker.js

@@ -357,7 +357,7 @@ DesktopDateTimePicker.propTypes = {
   onSelectedSectionsChange: _propTypes.default.func,
   /**
    * Callback fired on view change.
-   * @template TView
+   * @template TView Type of the view. It will vary based on the Picker type and the `views` it uses.
    * @param {TView} view The new view.
    */
   onViewChange: _propTypes.default.func,
@@ -478,8 +478,8 @@ DesktopDateTimePicker.propTypes = {
   thresholdToRenderTimeInASingleColumn: _propTypes.default.number,
   /**
    * The time steps between two time unit options.
-   * For example, if `timeStep.minutes = 8`, then the available minute options will be `[0, 8, 16, 24, 32, 40, 48, 56]`.
-   * When single column time renderer is used, only `timeStep.minutes` will be used.
+   * For example, if `timeSteps.minutes = 8`, then the available minute options will be `[0, 8, 16, 24, 32, 40, 48, 56]`.
+   * When single column time renderer is used, only `timeSteps.minutes` will be used.
    * @default{ hours: 1, minutes: 5, seconds: 5 }
    */
   timeSteps: _propTypes.default.shape({

package/DesktopTimePicker/DesktopTimePicker.js

@@ -236,7 +236,7 @@ DesktopTimePicker.propTypes = {
   onSelectedSectionsChange: _propTypes.default.func,
   /**
    * Callback fired on view change.
-   * @template TView
+   * @template TView Type of the view. It will vary based on the Picker type and the `views` it uses.
    * @param {TView} view The new view.
    */
   onViewChange: _propTypes.default.func,
@@ -314,8 +314,8 @@ DesktopTimePicker.propTypes = {
   thresholdToRenderTimeInASingleColumn: _propTypes.default.number,
   /**
    * The time steps between two time unit options.
-   * For example, if `timeStep.minutes = 8`, then the available minute options will be `[0, 8, 16, 24, 32, 40, 48, 56]`.
-   * When single column time renderer is used, only `timeStep.minutes` will be used.
+   * For example, if `timeSteps.minutes = 8`, then the available minute options will be `[0, 8, 16, 24, 32, 40, 48, 56]`.
+   * When single column time renderer is used, only `timeSteps.minutes` will be used.
    * @default{ hours: 1, minutes: 5, seconds: 5 }
    */
   timeSteps: _propTypes.default.shape({