[DateRangePicker] Introduce new component 🎉

docs/_shared/Code.tsx

@@ -42,7 +42,7 @@ interface CodeProps {
   language?: 'jsx' | 'typescript' | 'markup';
 }
 
-const Code: React.SFC<CodeProps> = ({ language = 'jsx', inline, children, withMargin }) => {
+const Code: React.FC<CodeProps> = ({ language = 'typescript', inline, children, withMargin }) => {
   const classes = useStyles();
   const highlightedCode = highlight(children, language);
 

docs/layout/PageWithContext.tsx

@@ -9,9 +9,15 @@ import { PageContext } from '../utils/getPageContext';
 import { LocalizationProvider } from '@material-ui/pickers';
 import { UtilsContext } from '../_shared/UtilsServiceContext';
 import { NotificationManager } from 'utils/NotificationManager';
-import { Theme, createMuiTheme, CssBaseline } from '@material-ui/core';
 import { createUtilsService, UtilsLib, utilsMap } from '../utils/utilsService';
-import { ThemeProvider, jssPreset, StylesProvider } from '@material-ui/core/styles';
+import {
+  Theme,
+  createMuiTheme,
+  CssBaseline,
+  ThemeProvider,
+  jssPreset,
+  StylesProvider,
+} from '@material-ui/core';
 
 export type ThemeType = 'light' | 'dark';
 export type Direction = Theme['direction'];

docs/next.config.js

@@ -42,7 +42,7 @@ module.exports = withBundleAnalyzer(
 
               // Process examples to inject raw code strings
               config.module.rules.push({
-                test: /\.example\.(js|jsx)$/,
+                test: /\.example\.(js|jsx|tsx|ts)$/,
                 include: [path.resolve(__dirname, 'pages')],
                 use: [
                   { loader: 'next-babel-loader' },

docs/package.json

@@ -26,6 +26,7 @@
     "@material-ui/pickers": "^4.0.0-alpha.1",
     "@types/fuzzy-search": "^2.1.0",
     "@types/isomorphic-fetch": "^0.0.35",
+    "@types/jss": "^10.0.0",
     "@types/luxon": "^1.11.0",
     "@types/next": "^8.0.1",
     "@types/prismjs": "^1.9.1",

docs/pages/demo/datepicker/ServerRequest.example.jsx

@@ -30,7 +30,7 @@ function ServerRequest() {
         renderDay={(day, selectedDate, DayComponentProps) => {
           const date = makeJSDateObject(day); // skip this step, it is required to support date libs
           const isSelected =
-            DayComponentProps.isInCurrentMonth && selectedDays.includes(date.getDate());
+            DayComponentProps.inCurrentMonth && selectedDays.includes(date.getDate());
 
           return (
             <Badge overlap="circle" badgeContent={isSelected ? '🌚' : undefined}>

docs/pages/demo/datepicker/StaticDatePicker.example.jsx

@@ -1,5 +1,12 @@
 import React, { useState } from 'react';
+import isWeekend from 'date-fns/isWeekend';
 import { StaticDatePicker } from '@material-ui/pickers';
+import { makeJSDateObject } from '../../../utils/helpers';
+
+function disableWeekends(date) {
+  // TODO: replace with implementation for your date library
+  return isWeekend(makeJSDateObject(date));
+}
 
 const StaticDatePickerExample = () => {
   const [date, handleDateChange] = useState(new Date());
@@ -18,6 +25,7 @@ const StaticDatePickerExample = () => {
         orientation="landscape"
         openTo="date"
         value={date}
+        shouldDisableDate={disableWeekends}
         onChange={date => handleDateChange(date)}
       />
     </>

docs/pages/demo/daterangepicker/BasicDateRangePicker.example.tsx

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import { DateRangePicker, DateRange } from '@material-ui/pickers';
+
+function BasicDateRangePicker() {
+  const [selectedDate, handleDateChange] = React.useState<DateRange>([null, null]);
+
+  return (
+    <DateRangePicker
+      startText="Check-in"
+      endText="Check-out"
+      value={selectedDate}
+      onChange={date => handleDateChange(date)}
+    />
+  );
+}
+
+export default BasicDateRangePicker;

docs/pages/demo/daterangepicker/CalendarsDateRangePicker.example.tsx

@@ -0,0 +1,32 @@
+import * as React from 'react';
+import { Grid, Typography } from '@material-ui/core';
+import { DateRangePicker, DateRange } from '@material-ui/pickers';
+
+function CalendarsDateRangePicker() {
+  const [selectedDate, handleDateChange] = React.useState<DateRange>([null, null]);
+
+  return (
+    <Grid container direction="column" alignItems="center">
+      <Typography gutterBottom> 1 calendar </Typography>
+      <DateRangePicker
+        calendars={1}
+        value={selectedDate}
+        onChange={date => handleDateChange(date)}
+      />
+      <Typography gutterBottom> 2 calendars</Typography>
+      <DateRangePicker
+        calendars={2}
+        value={selectedDate}
+        onChange={date => handleDateChange(date)}
+      />
+      <Typography gutterBottom> 3 calendars</Typography>
+      <DateRangePicker
+        calendars={3}
+        value={selectedDate}
+        onChange={date => handleDateChange(date)}
+      />
+    </Grid>
+  );
+}
+
+export default CalendarsDateRangePicker;

docs/pages/demo/daterangepicker/MinMaxDateRangePicker.example.tsx

@@ -0,0 +1,27 @@
+import * as React from 'react';
+import addWeeks from 'date-fns/addWeeks';
+import { Dayjs } from 'dayjs';
+import { Moment } from 'moment';
+import { DateTime } from 'luxon';
+import { makeJSDateObject } from '../../../utils/helpers';
+import { DateRangePicker, DateRange } from '@material-ui/pickers';
+
+function getWeeksAfter(date: Moment | DateTime | Dayjs | Date, amount: number) {
+  // TODO: replace with implementation for your date library
+  return date ? addWeeks(makeJSDateObject(date), amount) : undefined;
+}
+
+function MinMaxDateRangePicker() {
+  const [selectedRange, handleDateChange] = React.useState<DateRange>([null, null]);
+
+  return (
+    <DateRangePicker
+      disablePast
+      value={selectedRange}
+      maxDate={getWeeksAfter(selectedRange[0], 4)}
+      onChange={date => handleDateChange(date)}
+    />
+  );
+}
+
+export default MinMaxDateRangePicker;

docs/pages/demo/daterangepicker/ResponsiveDateRangePicker.example.tsx

@@ -0,0 +1,24 @@
+import * as React from 'react';
+import { MobileDateRangePicker, DesktopDateRangePicker, DateRange } from '@material-ui/pickers';
+
+function ResponsiveDateRangePicker() {
+  const [selectedDate, handleDateChange] = React.useState<DateRange>([null, null]);
+
+  return (
+    <>
+      <MobileDateRangePicker
+        startText="Mobile start"
+        value={selectedDate}
+        onChange={date => handleDateChange(date)}
+      />
+
+      <DesktopDateRangePicker
+        startText="Desktop start"
+        value={selectedDate}
+        onChange={date => handleDateChange(date)}
+      />
+    </>
+  );
+}
+
+export default ResponsiveDateRangePicker;

docs/pages/demo/daterangepicker/StaticDateRangePicker.example.tsx

@@ -0,0 +1,24 @@
+import * as React from 'react';
+import { StaticDateRangePicker, DateRange } from '@material-ui/pickers';
+
+function StaticDateRangePickerExample() {
+  const [selectedDate, handleDateChange] = React.useState<DateRange>([null, null]);
+
+  return (
+    <>
+      <StaticDateRangePicker
+        displayStaticWrapperAs="desktop"
+        value={selectedDate}
+        onChange={date => handleDateChange(date)}
+      />
+
+      <StaticDateRangePicker
+        displayStaticWrapperAs="mobile"
+        value={selectedDate}
+        onChange={date => handleDateChange(date)}
+      />
+    </>
+  );
+}
+
+export default StaticDateRangePickerExample;

docs/pages/demo/daterangepicker/index.mdx

@@ -2,8 +2,13 @@ import Ad from '_shared/Ad';
 import Example from '_shared/Example';
 import PageMeta from '_shared/PageMeta';
 import LinkedComponents from '_shared/LinkedComponents';
+import { Hidden } from '@material-ui/core';
 
 import * as BasicDateRangePicker from './BasicDateRangePicker.example';
+import * as ResponsiveDateRangePicker from './ResponsiveDateRangePicker.example';
+import * as MinMaxDateRangePicker from './MinMaxDateRangePicker.example';
+import * as CalendarsDateRangePicker from './CalendarsDateRangePicker.example';
+import * as StaticDateRangePicker from './StaticDateRangePicker.example';
 
 <PageMeta component="Datepicker" />
 
@@ -15,6 +20,33 @@ import * as BasicDateRangePicker from './BasicDateRangePicker.example';
 
 #### Basic usage
 
-Will be rendered to modal dialog on mobile and textfield with popover on desktop.
+Basic DateRangePicker example, make sure that you can pass almost any prop of [DatePicker]('/api/DatePicker')
 
-<Example testId="datepicker-example" source={BasicDateRangePicker} />
+<Example source={BasicDateRangePicker} />
+
+#### Responsiveness
+
+Date/Time pickers experience is extremely different on mobile and desktop. Here is how components will look on different devices.
+The default `DateRangePicker` component is responsive, which means that `Mobile` or `Desktop` mode will be rendered according to device viewport.
+
+<Example source={ResponsiveDateRangePicker} />
+
+#### Different amount of calendars
+
+Make sure that `calendars` prop is working only for desktop mode.
+
+<Example source={CalendarsDateRangePicker} />
+
+#### Disabling dates
+
+Disabling dates performs just like in simple `DatePicker`
+
+<Example source={MinMaxDateRangePicker} />
+
+#### Static mode
+
+It is possible to render any picker without modal or popper. For that use `StaticDateRangePicker`.
+
+<Hidden smDown>
+  <Example paddingBottom source={StaticDateRangePicker} />
+</Hidden>

docs/pages/regression/Regression.tsx

@@ -2,9 +2,10 @@ import React, { useState, useContext } from 'react';
 import LeftArrowIcon from '@material-ui/icons/KeyboardArrowLeft';
 import RightArrowIcon from '@material-ui/icons/KeyboardArrowRight';
 import { Grid, Typography } from '@material-ui/core';
-import { MuiPickersContext } from '@material-ui/pickers';
+import { MuiPickersContext, DateRangePicker } from '@material-ui/pickers';
 import { createRegressionDay as createRegressionDayRenderer } from './RegressionDay';
 import {
+  DateRange,
   MobileDatePicker,
   DesktopDatePicker,
   MobileTimePicker,
@@ -13,6 +14,7 @@ import {
 
 function Regression() {
   const utils = useContext(MuiPickersContext);
+  const [range, changeRange] = useState<DateRange>([new Date('2019-01-01T00:00:00.000'), null]);
   const [date, changeDate] = useState<Date | null>(new Date('2019-01-01T00:00:00.000'));
 
   const sharedProps = {
@@ -64,6 +66,12 @@ function Regression() {
         <MobileTimePicker id="mobile-timepicker" value={date} onChange={changeDate} />
         <DesktopTimePicker id="desktop-timepicker" value={date} onChange={changeDate} />
       </Grid>
+
+      <Typography align="center" variant="h4" component="span" gutterBottom>
+        DateRangePicker
+      </Typography>
+
+      <DateRangePicker id="desktop-range-picker" value={range} onChange={changeRange} />
     </div>
   );
 }