[pickers] Add more conformance tests improving API docs precision

docs/pages/x/api/date-pickers/date-field.json

@@ -147,7 +147,7 @@
     }
   ],
   "spread": true,
-  "themeDefaultProps": false,
+  "themeDefaultProps": true,
   "muiName": "MuiDateField",
   "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/DateField/DateField.tsx",

docs/pages/x/api/date-pickers/date-picker.json

@@ -358,9 +358,10 @@
     }
   ],
   "classes": [],
-  "spread": true,
-  "themeDefaultProps": null,
+  "spread": false,
+  "themeDefaultProps": false,
   "muiName": "MuiDatePicker",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/DatePicker/DatePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-picker/\">Date Picker</a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/date-range-picker-day.json

@@ -161,7 +161,7 @@
       "isGlobal": false
     }
   ],
-  "spread": false,
+  "spread": true,
   "themeDefaultProps": false,
   "muiName": "MuiDateRangePickerDay",
   "forwardsRefTo": "HTMLButtonElement",

docs/pages/x/api/date-pickers/date-time-field.json

@@ -162,7 +162,7 @@
     }
   ],
   "spread": true,
-  "themeDefaultProps": false,
+  "themeDefaultProps": true,
   "muiName": "MuiDateTimeField",
   "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/DateTimeField/DateTimeField.tsx",

docs/pages/x/api/date-pickers/date-time-picker.json

@@ -404,9 +404,10 @@
     }
   ],
   "classes": [],
-  "spread": true,
-  "themeDefaultProps": null,
+  "spread": false,
+  "themeDefaultProps": false,
   "muiName": "MuiDateTimePicker",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/DateTimePicker/DateTimePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-time-picker/\">Date Time Picker</a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/desktop-date-picker.json

@@ -336,9 +336,10 @@
     }
   ],
   "classes": [],
-  "spread": true,
-  "themeDefaultProps": null,
+  "spread": false,
+  "themeDefaultProps": false,
   "muiName": "MuiDesktopDatePicker",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/DesktopDatePicker/DesktopDatePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-picker/\">Date Picker</a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/desktop-date-time-picker.json

@@ -382,9 +382,10 @@
     }
   ],
   "classes": [],
-  "spread": true,
-  "themeDefaultProps": null,
+  "spread": false,
+  "themeDefaultProps": false,
   "muiName": "MuiDesktopDateTimePicker",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/DesktopDateTimePicker/DesktopDateTimePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-time-picker/\">Date Time Picker</a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/digital-clock.json

@@ -108,8 +108,8 @@
       "isGlobal": false
     }
   ],
-  "spread": false,
-  "themeDefaultProps": false,
+  "spread": true,
+  "themeDefaultProps": true,
   "muiName": "MuiDigitalClock",
   "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/DigitalClock/DigitalClock.tsx",

docs/pages/x/api/date-pickers/mobile-date-picker.json

@@ -301,9 +301,10 @@
     }
   ],
   "classes": [],
-  "spread": true,
-  "themeDefaultProps": null,
+  "spread": false,
+  "themeDefaultProps": false,
   "muiName": "MuiMobileDatePicker",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/MobileDatePicker/MobileDatePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-picker/\">Date Picker</a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/mobile-date-time-picker.json

@@ -326,9 +326,10 @@
     }
   ],
   "classes": [],
-  "spread": true,
-  "themeDefaultProps": null,
+  "spread": false,
+  "themeDefaultProps": false,
   "muiName": "MuiMobileDateTimePicker",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/MobileDateTimePicker/MobileDateTimePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-time-picker/\">Date Time Picker</a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/multi-input-date-range-field.json

@@ -113,7 +113,10 @@
       "isGlobal": false
     }
   ],
+  "spread": true,
+  "themeDefaultProps": true,
   "muiName": "MuiMultiInputDateRangeField",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers-pro/src/MultiInputDateRangeField/MultiInputDateRangeField.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-range-field/\">Date Range Field <a href=\"/x/introduction/licensing/#pro-plan\" title=\"Pro plan\"><span class=\"plan-pro\"></span></a></a></li>\n<li><a href=\"/x/react-date-pickers/fields/\">Fields component</a></li></ul>",

docs/pages/x/api/date-pickers/multi-input-date-time-range-field.json

@@ -128,7 +128,10 @@
       "isGlobal": false
     }
   ],
+  "spread": true,
+  "themeDefaultProps": true,
   "muiName": "MuiMultiInputDateTimeRangeField",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers-pro/src/MultiInputDateTimeRangeField/MultiInputDateTimeRangeField.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-time-range-field/\">Date Time Range Field <a href=\"/x/introduction/licensing/#pro-plan\" title=\"Pro plan\"><span class=\"plan-pro\"></span></a></a></li>\n<li><a href=\"/x/react-date-pickers/fields/\">Fields component</a></li></ul>",

docs/pages/x/api/date-pickers/multi-input-time-range-field.json

@@ -116,7 +116,10 @@
       "isGlobal": false
     }
   ],
+  "spread": true,
+  "themeDefaultProps": true,
   "muiName": "MuiMultiInputTimeRangeField",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers-pro/src/MultiInputTimeRangeField/MultiInputTimeRangeField.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/fields/\">Fields component</a></li>\n<li><a href=\"/x/react-date-pickers/time-range-field/\">Time Range Field <a href=\"/x/introduction/licensing/#pro-plan\" title=\"Pro plan\"><span class=\"plan-pro\"></span></a></a></li></ul>",

docs/pages/x/api/date-pickers/multi-section-digital-clock.json

@@ -120,8 +120,8 @@
       "isGlobal": false
     }
   ],
-  "spread": false,
-  "themeDefaultProps": false,
+  "spread": true,
+  "themeDefaultProps": true,
   "muiName": "MuiMultiSectionDigitalClock",
   "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/MultiSectionDigitalClock/MultiSectionDigitalClock.tsx",

docs/pages/x/api/date-pickers/pickers-calendar-header.json

@@ -84,7 +84,10 @@
       "isGlobal": false
     }
   ],
+  "spread": true,
+  "themeDefaultProps": true,
   "muiName": "MuiPickersCalendarHeader",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/PickersCalendarHeader/PickersCalendarHeader.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/custom-components/\">Custom slots and subcomponents</a></li></ul>",

docs/pages/x/api/date-pickers/pickers-range-calendar-header.json

@@ -63,7 +63,10 @@
       "isGlobal": false
     }
   ],
+  "spread": true,
+  "themeDefaultProps": false,
   "muiName": "MuiPickersRangeCalendarHeader",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers-pro/src/PickersRangeCalendarHeader/PickersRangeCalendarHeader.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/custom-components/\">Custom slots and subcomponents</a></li></ul>",

docs/pages/x/api/date-pickers/single-input-date-range-field.json

@@ -131,7 +131,7 @@
     }
   ],
   "spread": true,
-  "themeDefaultProps": false,
+  "themeDefaultProps": true,
   "muiName": "MuiSingleInputDateRangeField",
   "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers-pro/src/SingleInputDateRangeField/SingleInputDateRangeField.tsx",

docs/pages/x/api/date-pickers/single-input-date-time-range-field.json

@@ -146,7 +146,7 @@
     }
   ],
   "spread": true,
-  "themeDefaultProps": false,
+  "themeDefaultProps": true,
   "muiName": "MuiSingleInputDateTimeRangeField",
   "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers-pro/src/SingleInputDateTimeRangeField/SingleInputDateTimeRangeField.tsx",

docs/pages/x/api/date-pickers/single-input-time-range-field.json

@@ -134,7 +134,7 @@
     }
   ],
   "spread": true,
-  "themeDefaultProps": false,
+  "themeDefaultProps": true,
   "muiName": "MuiSingleInputTimeRangeField",
   "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers-pro/src/SingleInputTimeRangeField/SingleInputTimeRangeField.tsx",

docs/pages/x/api/date-pickers/static-date-picker.json

@@ -252,9 +252,10 @@
     }
   ],
   "classes": [],
-  "spread": true,
-  "themeDefaultProps": null,
+  "spread": false,
+  "themeDefaultProps": false,
   "muiName": "MuiStaticDatePicker",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/StaticDatePicker/StaticDatePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-picker/\">Date Picker</a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/static-date-range-picker.json

@@ -209,7 +209,7 @@
   "spread": false,
   "themeDefaultProps": false,
   "muiName": "MuiStaticDateRangePicker",
-  "forwardsRefTo": "undefined",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers-pro/src/StaticDateRangePicker/StaticDateRangePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-range-picker/\">Date Range Picker <a href=\"/x/introduction/licensing/#pro-plan\" title=\"Pro plan\"><span class=\"plan-pro\"></span></a></a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/static-date-time-picker.json

@@ -277,9 +277,10 @@
     }
   ],
   "classes": [],
-  "spread": true,
-  "themeDefaultProps": null,
+  "spread": false,
+  "themeDefaultProps": false,
   "muiName": "MuiStaticDateTimePicker",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/StaticDateTimePicker/StaticDateTimePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/date-time-picker/\">Date Time Picker</a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/static-time-picker.json

@@ -168,7 +168,7 @@
   "spread": false,
   "themeDefaultProps": false,
   "muiName": "MuiStaticTimePicker",
-  "forwardsRefTo": "undefined",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/StaticTimePicker/StaticTimePicker.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/time-picker/\">Time Picker</a></li>\n<li><a href=\"/x/react-date-pickers/validation/\">Date and Time Pickers - Validation</a></li></ul>",

docs/pages/x/api/date-pickers/time-field.json

@@ -134,8 +134,9 @@
     }
   ],
   "spread": true,
-  "themeDefaultProps": null,
+  "themeDefaultProps": true,
   "muiName": "MuiTimeField",
+  "forwardsRefTo": "HTMLDivElement",
   "filename": "/packages/x-date-pickers/src/TimeField/TimeField.tsx",
   "inheritance": null,
   "demos": "<ul><li><a href=\"/x/react-date-pickers/fields/\">Fields component</a></li>\n<li><a href=\"/x/react-date-pickers/time-field/\">Time Field</a></li></ul>",

packages/x-date-pickers-pro/src/DateRangePicker/describes.DateRangePicker.test.tsx

@@ -19,7 +19,6 @@ describe('<DateRangePicker /> - Describes', () => {
       'themeVariants',
       'mergeClassName',
       'propsSpread',
-      'rootClass',
     ],
   }));
 });

packages/x-date-pickers-pro/src/DateRangePickerDay/DateRangePickerDay.test.tsx

@@ -36,8 +36,6 @@ describe('<DateRangePickerDay />', () => {
         'rootClass', // forwards classes to DateRangePickerDayDay, but applies root class on DateRangePickerDayRoot
         'mergeClassName', // forwards other props (i.e. data-test-id) to the DateRangePickerDayDay, but `className` is applied on the root
         'componentsProp',
-        'propsSpread',
-        'refForwarding',
         // TODO: Fix DateRangePickerDays is not spreading props on root
         'themeDefaultProps',
         'themeVariants',

packages/x-date-pickers-pro/src/DateTimeRangePicker/tests/describes.DateTimeRangePicker.test.tsx

@@ -19,7 +19,6 @@ describe('<DateTimeRangePicker /> - Describes', () => {
       'themeVariants',
       'mergeClassName',
       'propsSpread',
-      'rootClass',
     ],
   }));
 });

packages/x-date-pickers-pro/src/DesktopDateRangePicker/tests/describes.DesktopDateRangePicker.test.tsx

@@ -42,7 +42,6 @@ describe('<DesktopDateRangePicker /> - Describes', () => {
       'themeVariants',
       'mergeClassName',
       'propsSpread',
-      'rootClass',
     ],
   }));
 

packages/x-date-pickers-pro/src/DesktopDateTimeRangePicker/tests/describes.DesktopDateTimeRangePicker.test.tsx

@@ -43,7 +43,6 @@ describe('<DesktopDateTimeRangePicker /> - Describes', () => {
       'themeVariants',
       'mergeClassName',
       'propsSpread',
-      'rootClass',
     ],
   }));
 

packages/x-date-pickers-pro/src/MobileDateRangePicker/tests/describes.MobileDateRangePicker.test.tsx

@@ -42,7 +42,6 @@ describe('<MobileDateRangePicker /> - Describes', () => {
       'themeVariants',
       'mergeClassName',
       'propsSpread',
-      'rootClass',
     ],
   }));
 

packages/x-date-pickers-pro/src/MobileDateTimeRangePicker/tests/describes.MobileDateTimeRangePicker.test.tsx

@@ -44,7 +44,6 @@ describe('<MobileDateTimeRangePicker /> - Describes', () => {
       'themeVariants',
       'mergeClassName',
       'propsSpread',
-      'rootClass',
     ],
   }));
 

packages/x-date-pickers-pro/src/PickersRangeCalendarHeader/describes.PickersRangeCalendarHeader.test.tsx

@@ -0,0 +1,48 @@
+import * as React from 'react';
+import { pickersCalendarHeaderClasses } from '@mui/x-date-pickers/PickersCalendarHeader';
+import { pickersArrowSwitcherClasses } from '@mui/x-date-pickers/internals';
+import { PickersRangeCalendarHeader } from '@mui/x-date-pickers-pro/PickersRangeCalendarHeader';
+import { ConformanceOptions } from '@mui/internal-test-utils';
+import { adapterToUse, createPickerRenderer } from 'test/utils/pickers';
+import { describeConformance } from 'test/utils/describeConformance';
+
+const CALENDARS_TO_CLASSES_MAP: Record<1 | 2, ConformanceOptions['classes']> = {
+  1: pickersCalendarHeaderClasses,
+  2: pickersArrowSwitcherClasses,
+};
+
+describe('<PickersRangeCalendarHeader /> - Describes', () => {
+  const { render } = createPickerRenderer({ clock: 'fake' });
+
+  Object.entries(CALENDARS_TO_CLASSES_MAP).forEach(([calendars, classes]) => {
+    describeConformance(
+      <PickersRangeCalendarHeader
+        calendars={parseInt(calendars, 10) as 1 | 2}
+        monthIndex={0}
+        month={adapterToUse.date('2018-01-01')}
+        currentMonth={adapterToUse.date('2018-01-01')}
+        minDate={adapterToUse.date('1900-01-01')}
+        maxDate={adapterToUse.date('2100-12-31')}
+        onMonthChange={() => {}}
+        views={['day']}
+        view="day"
+        timezone="system"
+        reduceAnimations
+      />,
+      () => ({
+        classes,
+        inheritComponent: 'div',
+        render,
+        muiName: 'MuiPickersRangeCalendarHeader',
+        refInstanceof: window.HTMLDivElement,
+        skip: [
+          'componentProp',
+          'componentsProp',
+          'themeVariants',
+          'themeDefaultProps',
+          'themeStyleOverrides',
+        ],
+      }),
+    );
+  });
+});

packages/x-date-pickers-pro/src/SingleInputDateRangeField/tests/describes.SingleInputDateRangeField.test.tsx

@@ -13,13 +13,7 @@ describe('<SingleInputDateRangeField /> - Describes', () => {
     render,
     muiName: 'MuiSingleInputDateRangeField',
     refInstanceof: window.HTMLDivElement,
-    skip: [
-      'componentProp',
-      'componentsProp',
-      'themeDefaultProps',
-      'themeStyleOverrides',
-      'themeVariants',
-    ],
+    skip: ['componentProp', 'componentsProp', 'themeVariants', 'themeStyleOverrides'],
   }));
 
   describeRangeValidation(SingleInputDateRangeField, () => ({

packages/x-date-pickers-pro/src/SingleInputDateTimeRangeField/tests/describes.SingleInputDateTimeRangeField.test.tsx

@@ -12,13 +12,7 @@ describe('<SingleInputDateTimeRangeField /> - Describes', () => {
     render,
     muiName: 'MuiSingleInputDateTimeRangeField',
     refInstanceof: window.HTMLDivElement,
-    skip: [
-      'componentProp',
-      'componentsProp',
-      'themeDefaultProps',
-      'themeStyleOverrides',
-      'themeVariants',
-    ],
+    skip: ['componentProp', 'componentsProp', 'themeVariants', 'themeStyleOverrides'],
   }));
 
   describeRangeValidation(SingleInputDateTimeRangeField, () => ({