material-ui

Apr 1, 2018

Big thanks to the 4 contributors who made this release possible.

Here are some highlights ✨:

• React 16.3.0 support (#10867).
• Many bug fixes on the Tooltip component (#10843) @shssoichiro.
• A much better navigation experience on the docs (#10859).

Breaking change

• [Tooltip] Portal the component to the body (#10843) @shssoichiro

We take advantage of the latest features of React 16.x.
React is allowing us to return an array of elements in the render method.
We have removed the useless root div element.
Nothing has changed for people using React 15.x.

Component Fixes / Enhancements

• [FormControlLabel] Enable disabled label CSS modifications (#10841) @vkentta
• [Select] Throw when the non native select is not controlled (#10860) @oliviertassinari
• [Drawer] Back to 100% test coverage (#10861) @oliviertassinari
• [core] Work on React 16.3.0 support (#10867) @oliviertassinari

Docs

• [docs] typo: reponse => response (#10850) @luminaxster
• [docs] Remove dead code (#10855) @oliviertassinari
• [docs] Much better navigation experience (#10859) @oliviertassinari
• [examples] Demonstrate how to use the icons CDN (#10874) @oliviertassinari

Core

• [core] Remove the addEventListener module (#10856) @oliviertassinari
• [core] Upgrade the dependencies (#10853) @oliviertassinari
• [core] Rename .spec.js to .test.js (#10854) @oliviertassinari

Mar 28, 2018

Big thanks to the 25 contributors who made this release possible.

Here are some highlights ✨:

• Add a swipeable drawer component (#9730) @leMaik.
• Add a StackBlitz edit link (#10758).
• Add a new npm package: @material-ui/docs (#10699).
• And many more bug fixes and documentation improvements.

Breaking change

• [Grid] Change the default spacing value: 0 (#10768) @oliviertassinari

The negative margin implementation solution currently used comes with serious limitations.
Material-UI is the only library with a non-zero default spacing between the items.
Having zero spacing by default will ease the usage of the component.

-<Grid />
+<Grid spacing={16} />

• [Tooltip] Rename disableTriggerX (#10700) @oliviertassinari

For consistency with the removeEventListener Web API and the Snackbar disableWindowBlurListener property.

<Tooltip
- disableTriggerFocus
- disableTriggerHover
- disableTriggerTouch
+ disableFocusListener
+ disableHoverListener
+ disableTouchListener
/>

• [InputLabel] Rename FormControlClasses property (#10796) @oliviertassinari

I have made a mistake in #8108. The property isn't applied on a FormControl but on a FormLabel component.

-<InputLabel FormControlClasses={classes} />
+<InputLabel FormLabelClasses={classes} />

Component Fixes / Enhancements

• [Switch] Add missing TypeScript class keys (#10691) @wenduzer
• [ClickAwayListener] Add mouseEvent and touchEvent property (#10694) @tgrowden
• [Switch] Add default color (#10697) @oliviertassinari
• [StepButton] Support vertical stepper (#10698) @danieljuhl
• [TextField] Update defaultValue prop types (#10703) @moondef
• [Input] Rename isDirty to isEmpty (#10704) @oliviertassinari
• [Select] Perfom the layout computation as soon as possible (#10706) @oliviertassinari
• [Stepper] Add error prop to StepIcon and StepLabel (#10705) @nicoffee
• [Grid] Add zeroMinWidth to Typescript definition (#10712) @cvanem
• [Select] Fix data-value value (#10723) @a-x-
• [Tooltip] Update error message (#10742) @MoonDawg92
• [TextField] Apply onFocus and onBlur on the input (#10746) @oliviertassinari
• [TextField] Remove dead code (#10757) @oliviertassinari
• [Checkbox] Add checkedPrimary and checkedSecondary to Typescript definition (#10747) @cvanem
• [️MuiThemeProvider] TypeScript disableStylesGeneration (#10759) @djeeg
• [Input] Relax inputProps and inputComponent Types (#10767) @pelotom
• [Tabs] Warn on invalid combination (#10788) @oliviertassinari
• [Select] Better document event.target.value (#10791) @oliviertassinari
• [Drawer] Add Swipeable feature (#9730) @leMaik
• [Select] Add support for autoFocus (#10792) @nicoffee
• [Icon] Fix typing by taking out fontSize property (#10821) @franklixuefei

Docs

• [docs] Add new npm package: @material-ui/docs (#10699) @oliviertassinari
• [docs] Use buttonRef instead of ref in anchor playground example (#10708) @pelotom
• [docs] Fix "Edit this page" button (#10722) @SebastianSchmidt
• [docs] Add search shortcut (#10725) @oliviertassinari
• [docs] Make navigation look more like the material guidelines (#10709) @leMaik
• [docs] Clarify discrepancies from default theme (#10732) @yihangho
• [examples] Update next.js PWA color (#10749) @blainegarrett
• [docs] Add StackBlitz demo link (#10758) @oliviertassinari
• [docs] Fix typo TextField demo (#10766) @elertan
• [docs] Better CssBaseline documentation (#10770) @oliviertassinari
• [docs] Remove flow warning (#10780) @rosskevin
• [docs] Minor typographical fix (#10786) @samdenty99
• [docs] Selection control, customization example (#10787) @oliviertassinari
• [docs] Fix typo (#10794) @dylangarcia
• [examples] Update Flow Example (#10799) @prastut
• [docs] Material Dashboard Pro React (#10832) @oliviertassinari

Core

• [core] Upgrade the dev dependencies (#10702) @oliviertassinari
• [typings] Fix mixins.gutter signature (argument is optional) (#10814) @sebald

Mar 17, 2018

Big thanks to the 19 contributors who made this release possible.

This release comes with important theme upgrades. Here are some highlights ✨:

• Introduction of a Premium Themes section (#10616).
• A props theme key to globally inject properties on components (#10671).
• A theme option to change the font-size (#10687).
• And many more bug fixes and documentation improvements.

Breaking change

N/A

Component Fixes / Enhancements

• [Select] Fix chip alignment (#10611) @adamszeptycki
• [Tabs] Add 'scrollButtons' and 'indicator' to TabsClassKey Typescript defintion (#10618) @cvanem
• [TablePagination] Add SelectProps property (#10629) @mrahman1122
• [ListItemSecondaryAction] Vertically center (#10628) @jedwards1211
• [Select] Add visual tests to prevent future regression (#10642) @oliviertassinari
• [Popover] Update anchorEl type (#10645) @nicoffee
• [styles] Better color manipulator warning (#10652) @oliviertassinari
• [Autocomplete] Show how to use the label (#10653) @oliviertassinari
• [ButtonBase] Update class keys (#10659) @lukePeavey
• [FromHelperText] Add missing component prop definition (#10658) @franklixuefei
• [theme] Reduce the negative margin (#10672) @oliviertassinari
• [theme] Add a props theme key (#10671) @oliviertassinari
• [DialogActions] Add missing TypeScript property (#10674) @youngnicks
• [GridList] Should allow optional children (#10680) @rosskevin
• [DialogContentText] Extend the Typography component (#10683) @oliviertassinari
• [theme] Allow changing the font-size (#10687) @oliviertassinari
• [Stepper] Soft ripple background (#10690) @oliviertassinari

Docs

• [docs] Add project to showcase (#10614) @jdupont
• [docs] Fix typo (#10621) @prastut
• [docs] Updating the TS example to use CssBaseline (#10633) @yuchen-w
• [docs] Better support of multiline for downshift (#10641) @oliviertassinari
• [docs] Simplify LongMenu demo (#10646) @RichardLindhout
• [docs] Improve the onboarding (#10639) @oliviertassinari
• [docs] Fix usage of CssBaseline/Reboot in the CDN example (#10655) @SebastianSchmidt
• [docs] Fix reference to CssBaseline component (#10654) @SebastianSchmidt
• [themes] Introduce a themes website ⚡️ (#10616) @oliviertassinari
• [docs] Fix reference to FAQ (#10660) @SebastianSchmidt
• [docs] Fix reference to Popover demo (#10661) @SebastianSchmidt
• [docs] Fix reference to Modal demo (#10662) @SebastianSchmidt
• [docs] Add Rung to showcase (#10669) @vitorebatista
• [docs] Add Bit as a sponsor ❤️ (#10673) @oliviertassinari
• [docs] Third iteration on the homepage (#10670) @oliviertassinari
• [docs] Add Team SC into showcase (#10676) @Losses
• [docs] Handle optional params (#10685) @oliviertassinari
• [docs] Customized tables (#10686) @oliviertassinari

Core

• [typescript] Remove xxxClassName props from type declarations (#10644) @lukePeavey
• [typescript] Add inline style prop to transition (#10650) @nmchaves

Mar 11, 2018

Big thanks to the 13 contributors who made this release possible.

Here are some highlights ✨:

• An important fix of the focus/blur logic of the Select (#10538) @oliviertassinari.
• A multiple selection downshift example (#10550) @oliviertassinari.
• A new parcel example (#10575) @oliviertassinari.
• And many more bug fixes and documentation improvements.

Breaking change

• [classes] Move the XXXClassName to the classes property (#10600) @oliviertassinari

These properties were introduced before classes.
Exposing a single pattern makes things more predictable and easier to work with.

-<Tabs buttonClassName="foo" indicatorClassName="bar" />
+<Tabs classes={{ scrollButtons: 'foo', indicator: 'bar' }} />

-<TextField labelClassName="foo" helperTextClassName="bar" />
+<TextField InputLabelProps={{ className: 'foo' }} FormHelperTextProps={{ className: 'bar' }} />

• [CssBaseline] Rename from Reboot (#10605}

The new wording should clarify the purpose of the component.
For instance, it's not about adding JavaScript polyfills.

-<Reboot />
+<CssBaseline />

Component Fixes / Enhancements

• [Select] Fix wrong onBlur onFocus logic (#10538) @oliviertassinari
• [ExpansionPanel] Fix controlled behavior (#10546) @oliviertassinari
• [Autocomplete] Add multiple downshift example (#10550) @oliviertassinari
• [Autocomplete] selectedItem can be null (#10565) @caub
• [core] Improve IE11 support (#10568) @oliviertassinari
• [TextField] Better inputComponent demo (#10573) @oliviertassinari
• [typescript] Add a test case for ListItemIcon (#10593) @oliviertassinari
• [ListItemText] Make the children an alias of the primary property (#10591) @caub
• [Button] Fix Button variant prop description (#10578) @teekwak
• [Table] Fix table pagination example empty row height (#10588) @amcgee
• [Icon] Fix a bug in Chrome 64.0 (#10594) @caub
• [List] use theme for margin in ListItemText (#10597) @caub
• [StepIcon] enable CSS modifications of active step (#10599) @vkentta
• [Tooltip] Add enterTouchDelay and leaveTouchDelay props (#10577) @petegivens

Docs

• [docs] Simplify the CDN example (6e4cc723689961582ede16db421cbdf24ac7c4b9) @oliviertassinari
• [docs] Add showcase to readme - componofy (#10541) @DalerAsrorov
• [docs] Add Cryptoverview to the showcase (#10545) @leMaik
• [docs] Add menu Collapse example (#10548) @oliviertassinari
• [docs] Add PersonalBlog Gatsby starter to Showcase (#10566) @greglobinski
• [docs] Add parcel example (#10575) @oliviertassinari
• [docs] Fix typo in contributing readme (#10586) @chiragmongia
• [docs] Fix next.js example to enable styled-jsx with material-ui (#10580) @shibukawa
• [docs] Add the latest backers (#10602) @oliviertassinari
• [docs] Add Planalyze to Showcase (#10603) @dancastellon
• [docs] Improve the htmlFontSize documentation (#10604) @oliviertassinari

Core

• [core] Fix type definitions (#10553) @stefanorie
• [core] Better overrides merge support (#10606) @oliviertassinari

Mar 5, 2018

Big thanks to the 14 contributors who made this release possible.

Here are some highlights ✨:

• We have started the effort toward supporting the async API of [email protected] (#10489, #10523) @oliviertassinari.
• Document how to use Material-UI with a CDN (#10514) @zelinf.
• And many more bug fixes and documentation improvements.

Breaking change

• [SvgIcon] Allow changing the width with the font-size (#10446) @oliviertassinari

Remove the fontSize property. The SvgIcon behavior is closer to the Icon behavior.

-<Icon fontSize />
-<SvgIcon fontSize />
+<Icon />
+<SvgIcon />

Now, you can use the font-size style property to change the size of the icon.

• [classes] Normalize the classes names (#10457) @oliviertassinari

This is an effort in order to harmonize the classes API.
The best way to recover from this breaking change is to check the warnings in the console and to check the added documentation around the design rules around this API.

Component Fixes / Enhancements

• [Table] Default display style for all table components (#10447) @caub
• [Collapse] Fix description (#10454) @onurkose
• [ButtonBase] Add a TouchRippleProps property (#10470) @christophediprima
• [Select] Ensure label is shrinked when using startAdornment (#10474) @carab
• [Card][List] Implement responsive gutters (#10477) @lukePeavey
• [icon] Add "side-effects": false to material-ui-icons (#10482) @b1f6c1c4
• [IconButton] Fix theme.spacing.unit size dependency (#10486) @oliviertassinari
• [ListItem] Avoid li > li issue (#10484) @oliviertassinari
• [ListItem] Fix ContainerProps.className propagation (#10488) @oliviertassinari
• [Textarea] Prepare React 16.3.0 (#10489) @oliviertassinari
• [icon] Add build:es for material-ui-icons (#10497) @b1f6c1c4
• [ButtonBase] Fix the ripple on Edge (#10512) @oliviertassinari
• [Autocomplete] Update the demos so people can stack the components (#10524) @oliviertassinari
• [Button] Add override support for sizeLarge and sizeSmall (#10526) @wenduzer
• [Modal] Use prototype functions in ModalManager (#10528) @ianschmitz

Docs

• [docs] Fix Roadmap docs formatting (#10501) @cherniavskii
• [docs] EnhancedTable Demo (#10491) @kgregory
• [docs] Add new Showcase project (#10509) @chriswardo
• [Select] Document when the value is required (#10505) @MichaelArnoldOwens
• [Select] Document the renderValue signature (#10513) @oliviertassinari
• [docs] Add a CDN example (#10514) @oliviertassinari
• [docs] Fix SSR rendering in Gatsby example (#10536) @LegNeato

Core

• [core] Prepare the async API (#10523) @oliviertassinari
• [core] Upgrade the dev dependencies (#10456) @oliviertassinari
• [core] Upgrade the dev dependencies (#10515) @oliviertassinari

Feb 24, 2018

Big thanks to the 20 contributors who made this release possible.

Here are some highlights ✨:

• A new lab npm package (#10288) @mbrookes.
• A breaking changes ROADMAP before v1 (#10348) @oliviertassinari.
• And many more bug fixes and documentation improvements.

Breaking change

N/A

Component Fixes / Enhancements

• [Stepper] Add style override types (#10334) @vkentta
• [Input] Reset the line-height (#10346) @oliviertassinari
• [Select] Revert #9964 (#10347) @oliviertassinari
• [lab] Create lab package, add SpeedDial (#10288) @mbrookes
• [Button] Update Button mini description (#10355) @lorensr
• [SpeedDial] Fix onClick target element (#10368) @mbrookes
• [IconButton] Fix class key types (#10374) @vkentta
• [Chip] Ignore events generated by descendants (#10372) @maxdubrinsky
• [CardHeader] Add missing "action" classes key definition (#10379) @chubbsMcfly
• [Dialog] Consistent description (#10377) @oliviertassinari
• [Select] Fix the vertical-align (#10380) @oliviertassinari
• [Snackbar] Disable pausing of auto hide when window loses focus (#10390) @SebastianSchmidt
• [Select] Add SelectDisplayProps prop (#10408) @noah-potter
• [SelectInput] Add tabIndex prop (#10345) @keenondrums
• [Select] Make 'type' prop able to be overwritten (#10361) @fabijanski
• [Select] Set type undefined rather than null (#10430) @caub
• [ButtonBase] Fix accessibility (#10434) @oliviertassinari
• [SwitchBase] Fix defaultChecked issue (#10444) @tanmayrajani
• [SwitchBase] Prevent defaultChecked regression (#10445) @oliviertassinari

Docs

• [Transitions] Document transition style prop handling (#10322) @AdamGorkoz
• [Drawer] Add clipped navigation drawer demo (#10330) @AdamGorkoz
• [docs] Fix demo links for new util components (#10337) @jprince
• [docs] Add react-final-form to Related Projects (#10352) @mbrookes
• [docs] rename theme-default to default-theme (#10356) @mbrookes
• [docs] Fix modal page link (#10360) @tanmayrajani
• [docs] Plan the breaking changes before v1 (#10348) @oliviertassinari
• [docs] Fix IE 11 and W3C warnings (#10394) @oliviertassinari
• [docs] Sort the pages by path and ignore dashes (#10396) @leMaik
• [docs] Autocomplete migration (#10397) @oliviertassinari
• [docs] Add AudioNodes to the showcase (#10407) @JohnWeisz
• [docs] Breaking changes feedback notification (#10413) @mbrookes
• [docs] Improve readability (#10412) @oliviertassinari
• [docs] Add material-ui-autosuggest to related projects (#10415) @tgrowden
• [docs] Update transitions.md (#10417) @caub
• [docs] Fix minor typo in breaking-changes notification (#10418) @phazor
• [docs] Description of how component will render (#10432) @oliviertassinari
• [docs] Add CSSGrid comparison example (#10433) @caub

Core

• [core] Upgrade some dependency to start looking into React 16.3 (#10338) @oliviertassinari
• [core] Remove direct references to window/document objects (#10328) @ianschmitz
• [core] Use tabIndex as number (#10431) @oliviertassinari

Feb 17, 2018

Big thanks to the 21 contributors who made this release possible.

Here are some highlights ✨:

• Checkbox, Radio, Switch update to follow the spec and be consistent with the Input (#10196, #10138) @phsantiago, @mbrookes.
• The documentation works offline (#10267) @msiadak.
• Better styled-components documentation (#10266) @rocketraman.
• And many more bug fixes and documentation improvements.

Breaking change

• [Checkbox, Radio, Switch] Fix id in internal input (#10196) @phsantiago

For consistency between the Input and the Checkbox, Switch, Radio the following small breaking changes have been done:

The usage of the inputProps property is no longer needed to apply an id to the input. The id is applied to the input instead of the root.

-<Checkbox inputProps={{ id: 'id' }} />
+<Checkbox id="id" />

The inputType property was renamed type.

-<Checkbox inputType="text" />
+<Checkbox type="text" />

• [Checkbox, Radio, Switch] Change default color, add color prop (#10138) @mbrookes

The Material Design specification says that selection controls elements should use the application's secondary color.

-<Checkbox />
-<Switch />
-<Radio />
+<Checkbox color="primary" />
+<Switch color="primary" />
+<Radio color="primary" />

Component Fixes / Enhancements

• [Input] Fix infinite loop (#10229) @oliviertassinari
• [CircularProgress] Add static variant (#10228) @oliviertassinari
• [Transition] Add the missing teardown logic (#10244) @oliviertassinari
• [Avatar] Use theme.spacing.unit (#10268) @cherniavskii
• [InputLabel] Add inheritance docs (#10282) @oliviertassinari
• [Input][ExpansionPane] Remove the use of legacy easing-curve (#10290) @strayiker
• [TableCell] Add "scope" attribute for th (#10277) @z-ax
• [styles] Fix typo (#10303) @strayiker
• [Button] Add fullWidth to ButtonClassKey (#10310) @stefanorie
• [TextField] Fix wrong SSR height of the textarea (#10315) @oliviertassinari
• [ClickAwayListener] Fix interaction with SVGElement (#10318) @KEMBL
• [Icon] Add fontSize to typings (#10317) @clentfort
• [Slide] Work with SVG too (#10325) @oliviertassinari

Docs

• [docs] Update links on showcase.md (#10227) @klyburke
• [docs] Remove dead code in Drawers (#10230) @oliviertassinari
• [docs] Add utils section, document transitions (#10239) @mbrookes
• [docs] Fix small issues (#10245) @oliviertassinari
• [docs] Add transform-origin and timeout to Grow demo #10246 @mbrookes
• [docs] Add modole.io to showcase (#10247) @mweiss
• [docs] Better API generator (#10249) @oliviertassinari
• [docs] Use non-breaking space (#10252) @oliviertassinari
• [example] TypeScript instructions (a81e5f9e54fdcc4648ffe6bdc08eaa596fb0a9bc) @oliviertassinari
• [docs] Fix the migration guide doc page (#10257) @nicolasiensen
• [docs] Update example in README.md (#10259) @nikoladev
• [docs] Fix typo in button component demo (#10260) @bmuenzenmeyer
• [docs] styled components non-root components (#10266) @rocketraman
• [Selection Control] Symmetry between the demos (#10279) @oliviertassinari
• [docs] Remove StepConnector from Steppers demo (#10301) @jdupont
• [docs] Add precaching Service Worker to exported docs builds (#10267) @msiadak
• [docs] Add missing rel=noopener (#10307) @oliviertassinari
• [docs] Add the average response time (#10308) @oliviertassinari
• [docs] Update TextFields.js (#10313) @Primajin
• [docs] Add toggling with react-popper (#10302) @caub
• [docs] Add the latest backers ♥ (#10323) @oliviertassinari
• [docs] Expose the theme as a global object (#10326) @oliviertassinari
• [docs] Add an example with Google Web Fonts (#10332) @oliviertassinari

Core

• [core] Fix the es distribution (#10254) @NMinhNguyen
• [typescript] Add missing exports in index.d.ts (#10295) @Andy4ward
• [core] Upgrade react-popper (#10299) @oliviertassinari

Feb 10, 2018

Big thanks to the 16 contributors who made this release possible.

Here are some highlights ✨:

• A documentation section on the component property (#10128) @sebald.
• A Snackbar / FAB animation integration example (#10188) @mbrookes.
• The Select open state can be controlled (#10205) @oliviertassinari.
• And many more bug fixes and documentation improvements.

Breaking change

N/A

Component Fixes / Enhancements

• [typescript] Use Partial props in TypeScript definitions (#10170) @ianschmitz
• [GridList] Allow null children in GridListTile (#10179) @caub
• [Grid] Small performance improvement (#10180) @oliviertassinari
• [TextField] Correct typo in TypeScript export declaration (#10186) @caghand
• [Switch] Increase the box shadow when checked (#10187) @leMaik
• [Stepper] Mobile Stepper variant determinate (#10190) @KeKs0r
• [MenuItem] Better :hover and .selected logic (#10199) @oliviertassinari
• [LinearProgress] Property definition grammar fix (#10201) @madison-kerndt
• [MuiThemeProvider] Forward the options when nested (#10176) @Aetherall
• [Select] Simpler controlled open property (#10205) @oliviertassinari
• [typescript] Use types from react-transition-group/Transition (#10129) @sebald
• [typescript] Export WithTheme from index (#10209) @clekili
• [Stepper] Increase StepButton space for click (#10204) @AlbertLucianto
• [ButtonBase] Use parent Window of ButtonBase when listening for keyboard events (#10224) @ianschmitz
• [StepLabel] Give more flexibility to the style of span surrounding label (#10218) @seanchambo
• [ButtonBase] Save one line of code (#10225) @oliviertassinari

Docs

• [examples] Rename type to variant (#10167) @oliviertassinari
• [docs] Using "component" prop to customize rendering (#10128) @sebald
• [docs] Fix the restore focus logic of the Popover demo (#10184) @oliviertassinari
• [docs] Fix react-select chip on mobile (#10185) @oliviertassinari
• [docs] Add Snackbar / FAB animation integration example (#10188) @mbrookes
• [docs] Add LocalMonero to showcase (#10195) @mbrookes
• [docs] Fix typo Selet to Select (#10207) @Justkant
• [docs] Change negative to positive (#10211) @harvitronix
• [docs] Add project to showcase (#10217) @klyburke

Core

• [core] Upgrade Next.js (#10181) @oliviertassinari
• [test] Remove the mockPortal workaround (#10208) @leMaik

Feb 4, 2018

Big thanks to the 12 contributors who made this release possible.

Here are some highlights ✨:

• Rename the type property to variant (#10088, #10086, #10084, #10101) @mbrookes.
• Simplify the implementation of the transitions (#10137, #10151) @oliviertassinari.
• Add support for position="sticky" with the AppBar (#10090) @scottastrophic.
• And many more bug fixes and documentation improvements.

Breaking change

• [API] Complete type to variant migration (#10101) @mbrookes

These breaking changes aim at providing a systematic solution to the boolean vs enum naming problem.

We have documented our approach to solving the problem in #10023. Basically, we enforce the following rule:

• We use a boolean when the degrees of freedom required is 2.
• We use an enum when the degrees of freedom required is > 2.

This is what motivated the button breaking change. Unfortunately type has its own meaning in the HTML specification. You can use it on the following elements: <button>, <input>, <command>, <embed>, <object>, <script>, <source>, <style>, <menu>.
We are using a more generic name to avoid the confusion: variant.

Umbrella pull-request for: #10084, #10086, #10088.

<Button
- raised
+ variant="raised"

<Button
- fab
+ variant="fab"

<Typography
- type="title"
+ variant="title"

<MobileStepper
- type="dots"
+ variant="dots"

<Drawer
- type="persistent"
+ variant="persistent"

<LinearProgress
- mode="determinate"
+ variant="determinate"

<CircularProgress
- mode="determinate"
+ variant="determinate"

• [transition] Standardize the components (#10151)

           <Zoom
             in={in}
-            enterDelay={transitionDuration.exit}
+            style={{
+              transitionDelay: in ? transitionDuration.exit : 0,
+            }}

Component Fixes / Enhancements

• [AppBar] Remove one dead CSS property (#10096) @oliviertassinari
• [AppBar] Add support for position="sticky" (#10090) @scottastrophic
• [CircularProgress] Improve animation & update example (#10079) @mbrookes
• [API] Rename type prop to variant (#10088) @mbrookes
• [Button] Move bool props to variant (#10086) @mbrookes
• [Progress] Rename mode prop to variant (#10084) @mbrookes
• [Drawer] Add PaperProps property (#10118) @oliviertassinari
• [TextField] Small refinement (#10117) @oliviertassinari
• [Stepper] Add StepIcon to Stepper exports (#10119) @melissanoelle
• [ButtonBase] Fix keyDown handled (#10136) @strayiker
• [Fade] Simplify implementation (#10137) @oliviertassinari
• [typescript] Add missing ExpansionPanel style overrides (#10142) @simonvizzini
• [Dialog] PaperProps TypeScript definition (#10143) @daniel-rabe
• [InputAdornment] Remove hack (#10157) @oliviertassinari
• [Hidden] css implementation handle custom className (#10165) @Vincz

Docs

• [docs] Minor CSP edit (#10089) @oliviertassinari
• [docs] Avoid anchor id conflict in Progress (#10095) @oliviertassinari
• [docs] Remove last flow annotations (#10099) @oliviertassinari
• [docs] Alternative APIs theme (#10100) @oliviertassinari
• [docs] Add How do I use react-router? in FAQ (#10103) @oliviertassinari
• [examples] Update README for CRA with JSS (#10105) @kgregory
• [docs] Add more examples for the Badge (#10114) @oliviertassinari
• [docs] Rename IntegrationAutosuggest to IntegrationDownshift (#10116) @kentcdodds
• [docs] Better color prop description (#10133) @mbrookes
• [docs] Fix duplicated id issue (#10135) @oliviertassinari
• [docs] Document approach for progress indicator delay (#10145) @mbrookes
• [docs] Simplify delayed progress indicator example (#10147) @mbrookes
• [docs] Improve the performance of the homepage (#10152) @oliviertassinari
• [docs] Allow Demo to specify only required deps (#10150) @caub
• [docs] Add mui-downshift (#10156) @oliviertassinari
• [docs] Demo codesandbox deps (#10158) @caub

Core

• [core] Add the license in the release (#10102) @oliviertassinari
• [test] Fix AppBar test assert messages (#10109) @cherniavskii

Jan 21, 2018

Big thanks to the 14 contributors who made this release possible.

Here are some highlights ✨:

• Further simplification & standardization with the palette (#10015) @mbrookes.
• A Content Security Policy Guide (#10074) @dav-is.
• Document the withStyles alternative APIs (#9981) @oliviertassinari.
• A react-select integration example (#10070) @oliviertassinari.
• And many more bug fixes and documentation improvements.

Fun facts:

• Our first alpha release was 1 year ago: Jan 28, 2017 🎂!
• We have done 53 pre-releases of the v1.x, one every week for a year 🛥.

Breaking change

• [Icon] Remove icon ligature "magic" support (#9983) @mbrookes

We have removed the "magic" <Icon> wrapping logic. It should be done explicitly now.
It's making our components less biased around the svg icon vs font icon choice.

+import Icon from 'material-ui/Icon';

-      <IconButton>comment</IconButton>
+      <IconButton>
+        <Icon>comment</Icon>
+      </IconButton>

• [theme] Further simplification & standardization (#10015) @mbrookes

  • Most component specific theme.palette.background colors have been removed. The affected components use theme.palette.grey instead. Shift the values of theme.palette.grey if you wish to lighten or darken these as a whole; this will maintain the contrast relationship between them. (Paper remains in the theme, as it is used across multiple components.)
  • theme.palette.common.fullBlack and fullWhite have been removed. Components that used these values now use theme.palette.common.black and white instead.
  • theme.palette.common.transparent has been removed. Components that used this value now use 'transparent' directly.
  • Chip has been corrected to use theme.palette.grey. If you have customized the values of grey, the appearance of Chip in your app may change.

• [core] Remove the rootRef properties as unneeded (#10025)

-import ReactDOM from 'react-dom';

<IconButton
- rootRef={node => {
-   this.button = ReactDOM.findDOMNode(node);
+ buttonRef={node => {
+   this.button = node;
  }}
>

• [Button] Add size property (#10009) @oliviertassinari

-<Button dense>
+<Button size="small">

• [palette] Remove the palette.types from the theme (#10040) @oliviertassinari

In order to keep the palette simple to understand, we have removed the types from the palette object.
The motivation is the following. The theme & palette should only store
the information needed to display one UI context.
Having the types object in the palette encourage people to rely on it.
No, we want people to do it the other way around.

For instance, instead of doing:

const theme = createMuiTheme({
  palette: {
    type: 'dark',
    types: {
      dark: {
        background: {
          default: '#000',
        },
      },
      light: {
        background: {
          default: '#fff',
        },
      },
    },
  },
});

We would rather see people doing:

const types = {
  dark: {
    background: {
      default: '#000',
    },
  },
  light: {
    background: {
      default: '#fff',
    },
  },
};

const theme = createMuiTheme({
  palette: {
    type: 'dark',
    ...types.dark,
  },
});

Component Fixes / Enhancements

• [Input] Make sure our previous or updated context is available (#9986) @yoiang
• [Dialog] Add PaperProps property (#9985) @nbdaaron
• [FormControl] Fix w3c issue (#9996) @oliviertassinari
• [typescript] Add divider to palette type defs (#10008) @xaviergonz
• [Badge] Add error as a palette option (#10004) @t49tran
• [Tab] Add textColor inherit default props to Tab (#10005) @x0fma
• [Menu] Fix dark selected color (#10026) @oliviertassinari
• [SnackbarContent] Change backgroundColor approach (#10027) @mbrookes
• [Backdrop] Allow setting of onTouchMove (#10001) @daniel-rabe
• [Popover] Should default to use anchorEl's parent body (#10049) @ianschmitz
• [Popover] Respect anchorEl's parent window when calculating position (#10048) @ianschmitz
• [TableCell] Add sortDirection TypeScript definition (#10057) @cvanem
• [palette] Fix error color defaults (#10058) @pelotom
• [ButtonBase] Avoid race condition with react-router (#10061) @oliviertassinari
• [Modal] Remove dead logic (#10062) @oliviertassinari
• [List] Fix w3c issues (#10050) @oliviertassinari
• [jss] Fix the last w3c issue I'm aware of (#10063) @oliviertassinari
• [LinearProgress] Add ARIA role & fix bugs (#10069) @mbrookes
• [ButtonBase] Add buttonRef property (#10082) @oliviertassinari

Docs

• [docs] Edit css injection order docs for create-react-app users (#9990) @PTaylour
• [docs] withStyles alternative APIs (#9981) @oliviertassinari
• [docs] Switch the Lightbulb UI (#9995) @oliviertassinari
• [docs] Use Simple over Basic (#10024) @oliviertassinari
• [docs] boolean vs enum API (#10023) @oliviertassinari
• [docs] Improve the typeface-roboto npm instructions (#10039) @oliviertassinari
• [docs] Add zero click example of Wrapping components (#10041) @oliviertassinari
• [docs] Reach the AA contrast ratio level (#10053) @oliviertassinari
• [docs] Misc fixes (#10055) @mbrookes
• [examples] Add missing typescript dependency (#10031) @QuantumInformation
• [docs] Add Content Security Policy Guide (#10074) @dav-is
• [docs] Add react-select example (#10070) @oliviertassinari

Core

• [core] Two small fixes looking at #10005 (#10014) @oliviertassinari
• [core] Use the official react-docgen package (#10054) @oliviertassinari
• [core] Upgrade the dependencies (#10060) @oliviertassinari

Jan 21, 2018

Big thanks to the 12 contributors who made this release possible.

Here are some highlights ✨:

• A revamp of the palette usage. We want it to be as simple as possible (#9876, #9918, #9970).
  We are pretty happy with the outcome. +80% of the story has been completed.
• A better w3c compliance, we will keep working on it in for the next release @sambhav-gore.
• An improved breakpoints documentation section (#9949).
• A new notification system for the documentation (#9974) @mbrookes.
• And many more bug fixes and documentation improvements.

Breaking change

• [palette] Keep simplifying the solution (#9876) @oliviertassinari
  • Remove the contrast color from our API. This color variation hasn't proven itself to be useful enough.

  -<Button color="contrast" />
  +<Button />
  

  Instead, you can use the color="inherit" property or use the theme.palette.XXX.contrastText value.
  • Rename accent to secondary. We have removed the accent indirection to be closer to the object people are providing to customize the palette.

  -<Button color="accent" />
  +<Button color="secondary" />
  

  <Tabs
  - indicatorColor="accent"
  - textColor="accent"
  + indicatorColor="secondary"
  + textColor="secondary"
  >
  

  • Rename old secondary to textSecondary. secondary and textSecondary are two valid color value.

  -<Typography color="secondary" />
  +<Typography color="textSecondary" />
  

• [palette] Standardize the secondary color (#9918) @oliviertassinari

The secondary color now behaves the same way than the other colors (primary, error). We always use the main tone by default instead of the light tone.
It's unclear if this change is making the implementation follow the specification more closely. The direct win is simplicity and predictability.

• [palette] Normalize the usage of the palette (#9970) @oliviertassinari
  • Remove theme.palette.input object.
  • Remove theme.palette.text.icon color.
  • Remove theme.palette.background.contentFrame, it was only used in the documentation.
  • Move theme.palette.text.divider to theme.palette.divider, it's not a text color.
  • Remove theme.palette.text.lightDivider, there is no reference to is in the specification, better keep things simple.

Component Fixes / Enhancements

• [Button] Fix secondary contrastText color (#9913) @ValentinH
• [FormTextHelper] Add component prop (#9917) @sambhav-gore
• [core] Fix some w3c validation errors (#9906) @oliviertassinari
• [TableCell] Fix TypeScript definition (#9926) @ljvanschie
• [Divider] Add component property (#9927) @oliviertassinari
• [FormControl] Fix alternating focus change bug (#9909) @dapetcu21
• [CircularProgress] Fix animation on Edge 16 and below (#9938) @oliviertassinari
• [ListItemText] Update Typings for primary and secondary text class keys (#9946) @spallister
• [palette] ShadeBackground interface updated (#9955) @daniel-rabe
• [TableCell] Fix TypeScript definition (#9959) @ljvanschie
• [Select] Fix a small vertical alignement issue (#9964) @oliviertassinari
• [IconButton] Better follow the spec (#9967) @oliviertassinari
• [Select] Add inputProps property (#9979) @oliviertassinari
• [typescript] Palette typing fixes and error augmentation (#9973) @pelotom
• [Grid] minWidth for type item (#9972) @sambhav-gore

Docs

• [docs] Add a section about how to test changes locally (#9935) @nicolasiensen
• [docs] Style Library Interoperability v2 (#9939) @oliviertassinari
• [docs] Fix markdown list (#9948) @yuchi
• [docs] Remove one DOM element in the Card actions (#9952) @maprihoda
• [docs] Improve the documentation on the breakpoints (#9949) @oliviertassinari
• [docs] Apply Matt's requested changes (#9963) @oliviertassinari
• [docs] Using TypeScript & withStyles for class component w/union props (#9975) @nmchaves
• [docs] Add notifications (#9974) @mbrookes

Core

N/A

Jan 16, 2018

Big thanks to the 9 contributors who made this release possible.

We are making a release earlier than expected. The release schedule norm has been so far: one every weekend. 1.0.0-beta.28 has introduced important pain points we want to address quickly:

• The 1.0.0-beta.28 palette change was made non-breaking (#9889) @mbrookes
• The JSS issues have been fixed
• The TypeScript definitions have been updated

Breaking change

N/A

Component Fixes / Enhancements

• [TextField] Add fullWidth propagation to Input (#9888) @enbyted
• [Chip] Add component property (#9890) @caub
• [palette] Update the TypeScript definitions (#9896) @oliviertassinari

Docs

• [examples] Update for revised theme approach (#9878) @mbrookes
• [examples] Update Gatsby example to work (#9877) @magicmark
• [docs] Additional corrections to palette code sample (#9883) @mbrookes
• [docs] Update showcase.md (#9894) @gerges-beshay

Core

• [core] Fix w3c validation errors (#9899) @sambhav-gore
• [core] Make palette change non-breaking (#9889) @mbrookes
• [core] Fix some w3c issues (#9872) @oliviertassinari
• [core] Upgrade jss to 9.5.0 (#9885) @cesardeazevedo
• [core] Fix some w3c validation errors (#9895) @sambhav-gore
• [typescript] Remove JSS stub module declaration (#9898) @pelotom
• [typescript] Move @types/react-transition-group from devDependencies to dependencies (#9897) @pelotom
• [typescript] Remove generic object and function types (#9822) @pelotom
• [core] Go back to jss-vendor-prefixer@7 (#9904) @oliviertassinari

Jan 14, 2018

Big thanks to the 22 contributors who made this release possible.

Here are some highlights ✨:

• A new theme palette system (#9794) @mbrookes. It's an important simplification.
• More flexible and customization friendly table components (#9852) @kgregory.
• A new gold sponsor: Creative Tim, thank you!
• And many more bug fixes and documentation improvements.

Breaking change

• [core] Revise the theme.palette.primary & secondary approach (#9794) @mbrookes

It's an important simplification of the palette system. You can now directly use the “official” Color Tool.

• Instead of using a rich color object of 14 different keys, we rely on an object of 4 different keys: light, main, dark and contrastText.
• Providing the full-color object used to be required. Now, we will provide a nice default to the different values using the main value.

import { createMuiTheme } from 'material-ui/styles';
import blue from 'material-ui/colors/blue';
import pink from 'material-ui/colors/pink';

const theme = createMuiTheme({
  palette: {
-   primary: blue,
-   secondary: pink,
+   primary: {
+     light: blue[300],
+     main: blue[500],
+     dark: blue[700],
+   },
+   secondary: {
+     light: pink[300],
+     main: pink[500],
+     dark: pink[700],
+   }
    type: theme.paletteType,
  },
});

• [ListItemText] Add extra class to style secondary text (#9759) @t49tran

<ListItem
  classes={{
-   text: 'my-class',
+   textPrimary: 'my-class',
  }}
/>

• [CardHeader] Remove CardContent inheritance (#9764) @oliviertassinari

Rename ListItemText classes for consistency with the CardHeader component:

-- `textPrimary`
-- `textSecondary`
+- `primary`
+- `secondary`

• [TableCell] Add type property (#9852) @kgregory

TableHead, TableBody and TableFooter no longer offer a CSS API, which means their root classes are no longer available.
To style the root element in these components, a className prop can be passed, as all non-API props will be spread to the root element.

Component Fixes / Enhancements

• [Tooltip] Zero-length titles string are never displayed (#9766) @oliviertassinari
• [Chip] Replace instrinic CSS 'fit-content' with 'inline-flex' (#9767) @gregnb
• [Slide] Fix an animation regression (#9773) @oliviertassinari
• [Select] Remove the input warning (#9774) @oliviertassinari
• [Tabs] Add action property (#9780) @gregnb
• [StepButton] Fix TypeScript definition (#9796) @hapood
• [CardContent] Add component property (#9789) @caub
• [TablePagination] Add an Actions property (#9785) @axlider
• [SwitchBase] Enable React input warning (#9814) @oliviertassinari
• [SwitchBase] Remove duplicate typescript definitions inherited (#9816) @rosskevin
• [Hidden] Update initialWidth propTypes (#9815) @djeeg
• [Transition] Extend children propTypes (#9819) @oliviertassinari
• [TablePagination] Remove dead code (#9831) @leMaik
• [theme] Polish background scale (#9829) @oliviertassinari
• [ExpansionPanel] Fix typescript definitions of onChange event (#9832) @Jocaetano
• [GridList] Remove named export (#9836) @remcohaszing
• [GridList] Export through main index.js (#9833) @remcohaszing
• [Portal] Document default value (#9841) @oliviertassinari
• [Button] Add fullWidth boolean property (#9842) @oliviertassinari
• [Select] Improve vertical alignment (#9827) @jedwards1211
• [GridListTile] Fix error when overriding classes (#9862) @KevinAsher
• [transitions] Improve the style override logic (#9858) @caub
• [Select] Add open, onClose and onOpen properties (#9844) @caub

Docs

• [docs] Add Expand All switch to default theme tree (#9762) @mbrookes
• [docs] Remove unneeded dependencies from examples (#9746) @cherniavskii
• [docs] Clarify the usage of innerRef property of withStyles (#9765) @nareshbhatia
• [docs] Improve color / theme docs (#9771) @mbrookes
• [docs] Add How can I access the DOM element? in the FAQ (#9768) @oliviertassinari
• [examples] Add a Gatsby example (#9779) @oliviertassinari
• [docs] Alternatives to CRA (#9810) @oliviertassinari
• [docs] Add missing code from example (#9830) @RyanTaite
• [docs] Add Global CSS override section (#9843) @oliviertassinari
• [docs] Add example for Select with Checkbox in MenuItems (#9835) @caub
• [docs] Add SlidesUp to the Showcase (#9854) @bhatiak
• [docs] Track the bundle size (#9853) @oliviertassinari
• [docs] Display the default theme (#9859) @oliviertassinari
• [docs] Add paragraph on withStyles with multiple classes (#9851) @clentfort
• [docs] Add new backers (#9863) @oliviertassinari

Core

• [core] Remove contastDefaultColor (#9772) @mbrookes
• [core] Revise theme contrastText approach, remove contrastDefaultColor (#9063) @mbrookes
• [color] Add a warning when an invalid value is provided (#9783) @oliviertassinari
• [typescript] Add TouchRipple typings (#9812) @msiadak
• [test] Enforce 100% test coverage in Codecov (#9813) @leMaik
• [typescript] Move @types/jss from devDependencies to dependencies (#9817) @pelotom
• [core] Upgrade the dependencies 😢 (#9828)

Jan 6, 2018

Big thanks to the 19 contributors who made this release possible.

Here are some highlights ✨:

• A strong focus on the documentation.
• Add a new Zoom component (#9693) @mbrookes
• Better vertical alignment of our components (#9709) @oliviertassinari
• And many more bug fixes and documentation improvements.

Breaking change

• [core] Remove some rootRef properties (#9676) @cherniavskii

Remove the rootRef property from the Grow and List component.
Instead, you can use the ref property in combination with findDOMNode() or a RootRef helper.

• [Popover] New transition property (#9682) @oliviertassinari

Remove the transitionClasses property of the Popover component. Instead, you can provide a transition component.

• [BottomNavigation] Rename BottomNavigationButton to BottomNavigationAction (#9692) @mbrookes

-import BottomNavigation, { BottomNavigationButton } from 'material-ui/BottomNavigation';
+import BottomNavigation, { BottomNavigationAction } from 'material-ui/BottomNavigation';

• [core] Update jss plugins dependencies (#9732) @cherniavskii

You might be relying on the transitive dependency of Material-UI: jss-preset-default.
If you do, you need to declare the dependency in your package.json. Material-UI will no longer install it for you.
Alternatively, you can use our preset to save bundle size.

-import preset from 'jss-preset-default';
+import { jssPreset } from 'material-ui/styles';

Component Fixes / Enhancements

• [Menu] Better select, hover, focus logic (#9570) @Skaronator
• [CircularProgress] Accept as string size property (#9700) @jedwards1211
• [Zoom] New transition component (#9693) @mbrookes
• [Modal] Add TransitionHandlers to Modal props TypeScript definitions (#9723) @pvdstel
• [style] Add vertical-align: middle (#9709) @oliviertassinari
• [Dialog] Allow fullWidth option of false (#9724) @gregnb
• [SvgIcon] Add a nativeColor property (#9740) @oliviertassinari
• [typescript] Make Modal-/SlideProps on Drawer Partial (#9743) @DaIgeb
• [typescript] Use React.ReactType instead of string | ComponentType (#9686) @pelotom
• [typescript] Style/replace object and function in typedef (#9678) @t49tran
• [typescript] Update zIndex props to latest changes (#9720) @radicand
• [FormControlLabel] Allow highlighted options to be selectable (#9713) @Chopinsky

Docs

• [flow] Update the documentation and the example (#9679) @oliviertassinari
• [docs] Fix missing sandbox files (#9685) @lukePeavey
• [Portal] Fix typo (#9688) @ifndefdeadmau5
• [examples] Use Reboot (#9691) @oliviertassinari
• [docs] Add a fallback ad (#9694) @oliviertassinari
• [examples] Keep working on the Next.js example (#9695) @oliviertassinari
• [docs] Hide sandbox button on more demos (#9696) @lukePeavey
• [docs] Minor Markdown Fix: Update SUPPORT.md (#9702) @TorzuoliH
• [docs] Move 'Default Theme' to it's own section (#9697) @mbrookes
• [docs] Reorder Drawer items (#9704) @mbrookes
• [docs] Bite the bullet and go for v1-beta (#9706) @oliviertassinari
• [docs] Add project in showcase.md (#9725) @shady831213
• [docs] Fix error in overriding with classes (#9726) @rubencosta
• [docs] Tweak Dialog maxWidth prop description (#9729) @mbrookes
• [docs] Add a reference to create-react-app-with-flow (#9735) @oliviertassinari
• [docs] Fix link of "How to override the look and feel of the components." (#9739) @enavarrocu
• [docs] Fix Chip onDelete property (#9741) @vkentta
• [docs] Reduce the api docs table cell padding (#9752) @mbrookes
• [docs] Misc docs fixes (#9747) @mbrookes
• [docs] Fix two small regressions (#9753) @oliviertassinari
• [docs] Tidy up Tooltips demos (#9755) @mbrookes

Core

• [core] Fix typo in size:overhead:why script (#9728) @cherniavskii
• [core] Follow the React HOC convention (#9733) @oliviertassinari
• [github] Add Support Requests bot config file (#9751) @mbrookes

Dec 30, 2017

Big thanks to the 12 contributors who made this release possible.

Here are some highlights ✨:

• @kgregory has made the breakpoint down behavior more intuitive. As of now, it's inclusive (#9632).
• We have introduced a new component to kickstart an elegant, consistent, and simple baseline to build upon: Reboot (#9661).
• The Portal and Modal components have been revamped to solve the core issues raised by the community (#9613). Those components are now documented.

Breaking change

• [Portal] Second iteration on the component (#9613)

Some properties have been renamed:

<Dialog
- ignoreBackdropClick
- ignoreEscapeKeyUp
+ disableBackdropClick
+ disableEscapeKeyDown

<Modal
- show
- disableBackdrop
- ignoreBackdropClick
- ignoreEscapeKeyUp
- modalManager
+ open
+ hideBackdrop
+ disableBackdropClick
+ disableEscapeKeyDown
+ manager

The zIndex object has been updated to match the usage.

  const zIndex = {
-  mobileStepper: 900,
-  menu: 1000,
+  mobileStepper: 1000,
   appBar: 1100,
-  drawerOverlay: 1200,
-  navDrawer: 1300,
-  dialogOverlay: 1400,
-  dialog: 1500,
-  layer: 2000,
-  popover: 2100,
-  snackbar: 2900,
-  tooltip: 3000,
+  drawer: 1200,
+  modal: 1300,
+  snackbar: 1400,
+  tooltip: 1500,
  };

• [breakpoint] Down properties are now inclusive (#9632) @kgregory
  • createBreakpoints.down() is now inclusive of the specified breakpoint
  • isWidthDown() is now inclusive of the specified breakpoint by default
  • <Hidden /> will include the breakpoints associated with its Down properties regardless of whether CSS or JS is used.

Component Fixes / Enhancements

• [TextField] Add inputProps back (#9604) @oliviertassinari
• [TextField] Accessibility improvements (#9617) @cherniavskii
• [ListItemText] Fix noWrap primary text ellipsis (#9631) @dr-js
• [Typography] Remove children required constraint (#9633) @hendratommy
• [CardHeader] Add component property (#9634) @oliviertassinari
• [Snackbar] Clarify that autoHideDuration calls onClose (#9628) @evantrimboli
• [Table] Add aria-label's to pagination left/right arrows (#9622) @gregnb
• [Input] More predictible value behavior (#9647) @oliviertassinari
• [styles] Make sure to escape whitespace (#9644) @jedwards1211
• [Reboot] New component (#9661) @oliviertassinari
• [Snackbar] Allow consecutive messages to display (#9670) @tkvw
• [styles] Reduce the likeliness of conflict (#9671) @oliviertassinari
• [typescript] Make Tabs onChange prop optional (#9668) @pelotom
• [Avatar] Handle non-square images (#9672) @oliviertassinari

Docs

• [docs] Fix AppBar and Demo button labels (#9607) @mbrookes
• [docs] Fix 414 HTTP issue (#9635) @oliviertassinari
• [docs] Update backers.md (#9636) @oliviertassinari
• [docs] Add a missing codesandbox demo (#9657) @oliviertassinari
• [docs] Interoperability guide: Fix grammar and rework structure (#9658) @mbrookes
• [docs] Remove dead code in generateMarkdown (#9662) @oliviertassinari
• [docs] Interop guide: change Global CSS link from API to description (#9664) @oliviertassinari
• [docs] Add mui-datatables (#9667) @gregnb
• [docs] Small tweaks (#9669) @oliviertassinari

Core

• [test] Document the ImageMagick / GraphicsMagick dependancy (#9608) @mbrookes
• [typescript] re-declare isMuiElement and isMuiComponent as typeguard (#9630) @SSW-SCIENTIFIC
• [core] Upgrade the dependencies (#9642) @oliviertassinari

Dec 22, 2017

Big thanks to the 16 contributors who made this release possible.

Here are some highlights ✨:

• 100% test coverage. Thanks @leMaik for the last mile #9596!
• The first introduction of Global CSS 😱.
  We have introduced a dangerouslyUseGlobalCSS option to the class name generator #9558.
  We discourage people from using this option in production.
  However, it can be a quick escape hatch when prototyping.
  It's making the class names predictable, for instance:

-c291
+MuiButton-raised

• And many more bug fixes and documentation improvements.

Breaking change

None, merry christmas 🎄.

Component Fixes / Enhancements

• [typescript] Add Typography pxToRem (#9547) @jaredpetker
• [Select] Typo fix (#9567) @bordagabor
• [CardHeader] Add conditional rendering of the subheader (#9572) @jwwisgerhof
• [Tooltip] children should be an element (#9568) @oliviertassinari
• [BottomNavigationButton] onClick and onChange handler overwritten (#9564) @kgregory
• [typescript] Add typings to reactHelpers (#9565) @SSW-SCIENTIFIC
• [TablePagination] Make onChangeRowsPerPage optional (#9563) @evantrimboli
• [Toolbar] Make the children optional (#9581) @oliviertassinari
• [withWidth] Add withTheme option (#9586) @oliviertassinari
• [docs] Add more interoperability examples (#9558) @oliviertassinari
• [TextField] Make TextField's "value" prop type match Input (#9594) @jaminthorns
• [Popover] Add action property (#9588) @gregnb
• [Modal] Increase test coverage (#9596) @leMaik

Docs

• [docs] Second iteration on the ad placement (#9524) @oliviertassinari
• [docs] Remove unused styes object from ChipsArray demo (#9540) @mbrookes
• [docs] Hide sandbox button on drawer and grid-list demos (#9537) @lukePeavey
• [docs] Fix typo masterial-ui to material-ui (#9544) @Ginkoid
• [docs] Add two new members (#9543) @oliviertassinari
• [docs] Fix dark theme toggle of website home page content (#9560) @Tuaniwan
• [docs] Improve migration guide (#9566) @fonzy2013
• [examples] Fix after the latest breaking changes (#9553) @Tuaniwan
• [docs] Fix basic typos in copy text (#9591) @hathix

Core

• [test] Report the potential svg-icon test error (#9559) @oliviertassinari
• [.editorconfig] Add max_line_length (#9580) @mbrookes
• [core] Move svg-icons to the internal folder (#9601) @oliviertassinari
• [core] Upgrade the dependencies (#9606) @oliviertassinari

Dec 17, 2017

Big thanks to the 16 contributors who made this release possible.

Here are some highlights ✨:

• We have removed Flow from the core components in (#9453).
  You can learn more about the motivations in the pull-request.
  This changes two important things:
  • We have reduced the size of the bundle by ~8 kB gzipped.
  • The propTypes runtime checks are back. You might experience new warnings.
• We have introduced 4 breaking changes.
• You can support me on Patreon and the community on OpenCollective (#9460).
  Blog posts are coming.
• And many more bug fixes and documentation improvements.

Breaking change

• [Hidden] Fix js/css implementation inconsistency (#9450) @oliviertassinari

This change is making the js and css breakpoint utils behaving the same way.
The default parameter of withWidth.isWidthDown(breakpoint, width, inclusive) changed:

-inclusive = true
+inclusive = false

You might want to update the usage of the API by increasing the breakpoing used on the Hidden component:

-<Hidden implementation="js" mdDown>
+<Hidden implementation="js" lgDown>

Or by going back to the previous behavior:

-isWidthDown(breakpoint, width)
+isWidthDown(breakpoint, width, true)

• [API] Use onClose over onRequestClose (#9451) @oliviertassinari

Most of our components are stateless by default. It wasn't the case with v0.x. Let's translate this default behavior in the property names of v1.

-onRequestClose
-onRequestOpen
-onRequestDelete
+onClose
+onOpen
+onDelete

• [TextField] Remove inputClassName property (#9509) @kgregory

The existing InputProps property can be used to set the className on the input element, making inputClassName redundant. Issue #9508 exposed some conflicting behavior between the two properties and it was decided that removing inputClassName would result in a cleaner API.

-  /**
-   * The CSS class name of the `input` element.
-   */
-  inputClassName: PropTypes.string,

The configuration of the wrapped Input component and its input element should be done through InputProps. To specify a className on the input element:

<TextField InputProps={{ inputProps: { className: 'foo' } }} />

• [Stepper] "Optional" label in StepLabel should be localizable (#9489) @karaggeorge

There is no logic attached to the optional boolean property. So, we can reduce the abstraction cost. The property is provided closer to where it's needed, and people have full control over how it should be displayed. By chance, it matches the specification.

-<Step optional>
-  <StepLabel>
+<Step>
+  <StepLabel optional={<Typography type="caption">Optional Text</Typography>}>
     Label
   </StepLabel>
 </Step>

Component Fixes / Enhancements

• [Popover] Fix warning formatting (27bab8022545c0cda8cbc80bf9b6df1566b14226) @oliviertassinari
• [Hidden] Add only array support in the CSS implementation (#9457) @Chopinsky
• [TextField] Fix disabled logic handling (#9472) @oliviertassinari
• [Dialog] Improve accessibility (#9461) @ianschmitz
• [TableFooter] Fix text overlapping pagination drop-down (#9497) @mbrookes
• [ButtonBase] Avoid unnecessary rerender (#9502) @ojab
• [Chip] Fix color contrast against default dark background (#9501) @mbrookes
• [Button] Document how to use a third-party routing library (#9506) @nikoladev
• [MuiThemeProvider] Add a new warning (#9518) @oliviertassinari
• [TextField] Improve the API documentation (#9514) @oliviertassinari
• [TableCell] Add missing aria-sort (#9504) @gregnb
• [ExpansionPanelSummary] Eliminate extra invocation of onClick (#9523) @kgregory

Docs

• [docs] Update sentence which might be misinterpreted (#9459) @senthuran16
• [docs] Correct list API default value (#9462) @t49tran
• [docs] Fix doc layout when an ad is present (#9473) @zachwolf
• [docs] Update breakpoint info to be in line with code (#9486) @nikoladev
• [docs] Fix broken sandbox in docs (#9491) @ajay2507
• [docs] Add new showcase (#9490) @liganok
• [docs] Add see source button (#9499) @oliviertassinari
• [docs] Add a BACKERS.md (#9460) @oliviertassinari
• [docs] Add Governance page (#9512) @oliviertassinari
• [docs] Demo options as JSON (#9521) @oliviertassinari

Core

• Add Governance Document (#9423) @hai-cea
• [core] Upgrade to flow 61 (#9471) @rsolomon
• [core] Remove FlowType from the components implementation (#9453) @oliviertassinari
• [core] Upgrade the dependencies (#9515) @oliviertassinari
• [core] Fix wrong usage of the API (#9519) @oliviertassinari
• [core] Use the same react pattern everywhere (#9520) @oliviertassinari

Dec 9, 2017

Big thanks to the 26 contributors who made this release possible.

Here are some highlights ✨:

• The TypeScript definitions keep getting better thanks to @pelotom, @rosskevin, @PavelPZ, @alitaheri, @ianschmitz, @smacpherson64, @brandonlee781
• We keep investing in improving the documentation.
  For instance, you can find a CodeSandbox edit button on all our demos.

Breaking change

• [TextField] API disamiguation/consistency (#9382) @rosskevin
  Some of the convenience properties exposed were confusing and have been removed (inputProps | InputClassName). For advanced configuration any Input through TextField, use TextField.InputProps to pass any property accepted by the Input.

Component Fixes / Enhancements

• [Switch] Update missed div to span for valid HTML (#9334) @mikeriley131
• [Modal] Resolve cordova issues (#9315) @sakulstra
• [Drawer] Missing ModalProps typescript (#9352) @rosskevin
• [theme] Fix TypographyOptions type (#9364) @keenondrums
• [styles] createMuiTheme should accept a deep partial (#9368) @keenondrums
• [Table] Add missing component props (#9378) @pelotom
• [typescript] Use correct types for TextFieldProps (#9321) @pelotom
• [typescript] Provide accurate typings for theme overrides (#9314) @pelotom
• [typescript] Add missing direction to theme (#9327) @alitaheri
• [typescript] Update onChange types for selection controls (#9339) @rosskevin
• [typescript] Allow function to be passed as MuiThemeProvider theme prop (#9354) @ianschmitz
• [typescript] Extract WithTheme for external use (#9363) @rosskevin
• [Input] Fix input shrink issue in Firefox (#9384) @t-cst
• [SvgIcon] Add color property (#9367) @kale5in
• [typescript] Wrong default export in shadows.d.ts and transitions.d.ts (#9395) @PavelPZ
• [typescript] Add "component" to FormLabelProps (#9398) @smacpherson64
• [typescript] Rename overloaded type "Icon" in StepButton and StepConnector (#9397) @PavelPZ
• [typescript] Fix definition mismatching on ColorObject (#9409) @kinisn
• [Tabs] Fix SSR regression (#9413) @oliviertassinari
• [theme] Fix mixins.gutter override (#9417) @oliviertassinari
• [ButtonBase] Remove some code (#9419) @oliviertassinari
• [ExpansionPanel] Prevent call onChange event from the root element (#9402) @andrzejbk
• [Hidden] Improve the docs (#9420) @oliviertassinari
• [typescript] Add anchorPosition and anchorReference to PopoverProps (#9428) @brandonlee781
• [Input] Specify target FlowType for SyntheticInputEvents (#9394) @dhui
• [Collapse] Fix minHeight behavior (#9438) @Chopinsky
• [Stepper] Add missing style names (#9441) @oliviertassinari
• [Button] Add a mini FAB variant (#9383) @mbrookes

Docs

• [docs] Replace type with interface, document typescript theme customization (#9350) @rosskevin
• [docs] Fix typo in comparison guide (#9357) @ugomeda
• [docs] Simplify TypeScript custom theme example (#9376) @pelotom
• [docs] Add project to showcase (#9346) @samdenty99
• [Dialog] Fix typo and finish incomplete comment (#9379) @willgriffiths
• [docs] Better definition of what withStyles is (#9235) @ajay2507
• [docs] Save 11% on the images (#9400) @oliviertassinari
• [docs] Add a downshift example (#9401) @oliviertassinari
• [docs] Fix Tabs examples typography & standardise code (#9366) @mbrookes
• [docs] Add a Plugins paragraph (#9399) @oliviertassinari
• [docs] Fix code formatting (#9414) @oliviertassinari
• [docs] Add codesandbox edit button (#9416) @oliviertassinari
• [docs] Various documentation improvements (#9403) @oliviertassinari
• [docs] Remove extra spacing (#9418) @oliviertassinari
• [docs] Remove flow from the docs (#9434) @oliviertassinari
• [examples] remove flow from the examples (#9446) @stormasm

Core

• [test] Set codecov threshold to avoid spurious build failures (#9323) @pelotom
• [test] Fix parse error in .codecov.yml (#9355) @pelotom
• [typescript] Update tslint.json "member-ordering" definition (#9359) @seivan
• [typescript] withTheme parameter on wrong function (#9372) @rosskevin
• [typescript] Fix and standardize remaining ThemeOptions typings (#9370) @pelotom
• [test] Add missing platforms (#9412) @oliviertassinari
• [core] Upgrade dependencies (#9415) @oliviertassinari
• [typescript] Remove DeepPartial (#9445) @PavelPZ

Dec 3, 2017

As usual, we are focusing on bug fixes but this time, we introduce an exceptional breaking change,
consistent with the removal of onTouchTapfor onClick in v0.19.0 (#7624).

Big thanks to the 10 contributors who made this release possible.

Breaking Change

• [core] Remove TouchTap in favor of Click throughout library and docs (#9058) @m2mathew

You need to globally replace any references to TouchTap property callbacks with Click.

Component Fixes / Enhancements

• [AutoComplete] Fix undef dataSource.value (#8864) @michalmikolajczyk
• [BottomNavigation] Allow null child (#8925) @MrSaints
• [Menu] Use filtered children on setFocusIndexStartsWith (#9316) @alancasagrande
• [Menu] Fix condition where item is removed from menu before it is used in focus calculation. (#8769) @zentron
• [Slider] Fix Updating min and max props (#9261) @thomaskempel
• [Slider] Fix slider being disabled onKeydown error (#9001) @henryj
• [Stepper] Allow invalid children (#8634) @svengau

Docs

• [docs] Add FlyWeekend in showcase (#8812) @tjl9
• [docs] Add a web app to the showcase (#8767) @maheshj567
• [docs] Update Home h2 text to match v1 (#9060) @m2mathew

Core

• [npm] Upgrade 'inline-style-prefixer' to 3.0.8 (#9320) @m2mathew
• [RenderToLayer] Remove touchstart events, to prevent double call to onRequestClose (#9118) @midan888

Nov 28, 2017

Big thanks to the 26 contributors who made this release possible.

Here are some highlights ✨:

• Wait, what? A new component is coming, again 🎉.
  @andrzejbk has been implementing the ExpansionPanel component with the help of the community. Big thanks to him!
• Support [email protected] (#9124) @pelotom
• Support [email protected] (#8983) @rsolomon, @rosskevin
• A new organization: mui-org @hai-cea
• And many more bug fixes and documentation improvements.

Breaking change

• [Select] Remove InputClasses (#9159) @oliviertassinari
  It's a revert. I have made the unwise call of adding the InputClasses property in an unrelated refactorization pull-request #8942. It was not taking the input classes property into account. It was a breaking change and not needed.
• [core] Reduce bundle size by 2kB gzipped (#9129) @oliviertassinari
  We have removed some jss plugins from the default bundle:
  • jss-expand (1.3 kB)
  • jss-compose (426 B)
  • jss-extend (702 B)
  • jss-template (330 B)

Component Fixes / Enhancements

• [Tooltip] Fix typo in API page (#9128) @mizx
• [Transition] Fix wrong addEndListener logic (#9142) @oliviertassinari
• [TablePagination] export LabelDisplayedRowArgs interface and improve label (#8930) @t49tran
• [Drawer] Hide focus ring (#9147) @rodrigofepy
• [Drawer] Fix classes in typescript definition (#9145) @johnnynia
• [CircularProgress] Fix behavior when dir=rtl (#9151) @alitaheri
• [StepContent] Fix typings (#9150) @alitaheri
• [Dialog] Fix maxWidth=xs (#9162) @oliviertassinari
• [Select] Fix typescript typings (#9153) @alitaheri
• [Slide] No default direction (#9165) @oliviertassinari
• [TablePagination] Improve the API docs page (#9181) @oliviertassinari
• [typescript] Strip keys from GridProps which won't get passed to override component (#9183) @pelotom
• [Input] Fix input height on Firefox (#9184) @oliviertassinari
• [Switch] Fixes non-valid HTML when div used inside of label element (#9188) @mikeriley131
• [FormControlLabel] Fixes non-valid HTML when p used in label element (#9187) @mikeriley131
• [Avatar] Fix alt align (#9193) @mctep
• [Drawer] Fix typo @ignore for theme prop (#9195) @christophehurpeau
• [style] Fix between media-query for xl (#9201) @michaelgruber
• [transitions] Expose the transition components (#9210) @ajay2507
• [Card] Add action prop to CardHeader (#9202) @lukePeavey
• [Select] Add name to the target (#9216) @oliviertassinari
• [TablePagination] Hide the rows per page selector if there are less than two options (#9213) @leMaik
• [ButtonBase] Bookkeep the disable state (#9220) @oliviertassinari
• [TextField] Better select support (#9224) @oliviertassinari
• [TableCell] Use solid version of theme divider (#9229) @mbrookes
• [ExpansionPanel] New component (#7651) @andrzejbk

Docs

• [docs] Additional tweaks (#9122) @mbrookes
• [docs] Improved documentation for Menu style overrides (#9126) @lsemerini
• [docs] Fix display on IE11 (#9166) @oliviertassinari
• [docs] Fix broken link in README.md (#9177) @Primajin
• [docs] Clean up code in IconLabelButton example (#9211) @xfumihiro
• [docs] Fill enhanced table to always have the same height on all pages (#9214) @leMaik
• [docs] Fix broken link to the API#spread (#9219) @oliviertassinari
• [Guide] Add Interoperability guide (#9217) @FjVillar
• [docs] Add a styled-components section (#9225) @oliviertassinari
• [examples] rename organization to mui-org (#9273) @stormasm
• [docs] Fix typo (#9288) @paulzmuda

Core

• [test] Fix flaky popper.js test (#9168) @oliviertassinari
• [typescript] Support TypeScript 2.6 and --strictFunctionTypes (#9124) @pelotom
• [typescript] Fix typing of withWidth (#9125) @pelotom
• [typescript] Eliminate the need for type annotations on callback parameters (#9127) @pelotom
• [core] Reduce bundle size by 2kB gzipped (#9129) @oliviertassinari
• [core] Upgrade enzyme (#9167) @oliviertassinari
• Add support for [email protected] (#8983) @rsolomon
• [test] Avoid unspotted API docs changes (#9212) @oliviertassinari
• [core] Increase the size-limit (#9215) @oliviertassinari
• [flow] Continuation of Flow updates 0.57+ (#9203) @rosskevin
• [flow] Bump react-flow-types version and fix errors (#9232) @rsolomon