deprecation instead of breaking change

docs/scripts/buildApi.js

@@ -142,6 +142,7 @@ function buildDocs(options) {
   reactAPI.pagesMarkdown = pagesMarkdown;
   reactAPI.src = src;
   reactAPI.spread = spread;
+  reactAPI.props = reactAPI.props || {};
 
   // if (reactAPI.name !== 'TableCell') {
   //   return;

packages/material-ui/src/GridList/GridList.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import { StandardProps } from '..';
+
+export interface GridListProps
+  extends StandardProps<React.HTMLAttributes<HTMLUListElement>, GridListClassKey> {
+  cellHeight?: number | 'auto';
+  cols?: number;
+  component?: React.ElementType<GridListProps>;
+  spacing?: number;
+}
+
+export type GridListClassKey = 'root';
+
+declare const GridList: React.ComponentType<GridListProps>;
+
+export default GridList;

packages/material-ui/src/GridList/GridList.js

@@ -0,0 +1,19 @@
+// @inheritedComponent GridList
+
+import React from 'react';
+import warning from 'warning';
+import ImageList from '../ImageList';
+
+/**
+ * Deprecated, use ImageList instead.
+ */
+export default function GridList(props) {
+  warning(
+    false,
+    [
+      'Material-UI: the GridList component is deprecated.',
+      'The component was renamed to ImageList.',
+    ].join('\n'),
+  );
+  return <ImageList {...props} />;
+}

packages/material-ui/src/GridList/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './GridList';
+export * from './GridList';

packages/material-ui/src/GridList/index.js

@@ -0,0 +1 @@
+export { default } from './GridList';

packages/material-ui/src/GridListTile/GridListTile.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import { StandardProps } from '..';
+
+export interface GridListTileProps
+  extends StandardProps<React.HTMLAttributes<HTMLLIElement>, GridListTileClassKey> {
+  cols?: number;
+  component?: React.ElementType<GridListTileProps>;
+  rows?: number;
+}
+
+export type GridListTileClassKey = 'root' | 'tile' | 'imgFullHeight' | 'imgFullWidth';
+
+declare const GridListTile: React.ComponentType<GridListTileProps>;
+
+export default GridListTile;

packages/material-ui/src/GridListTile/GridListTile.js

@@ -0,0 +1,19 @@
+// @inheritedComponent GridListTile
+
+import React from 'react';
+import warning from 'warning';
+import ImageListTile from '../ImageListTile';
+
+/**
+ * Deprecated, use ImageListTile instead.
+ */
+export default function GridListTile(props) {
+  warning(
+    false,
+    [
+      'Material-UI: the GridListTile component is deprecated.',
+      'The component was renamed to ImageListTile.',
+    ].join('\n'),
+  );
+  return <ImageListTile {...props} />;
+}

packages/material-ui/src/GridListTile/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './GridListTile';
+export * from './GridListTile';

packages/material-ui/src/GridListTile/index.js

@@ -0,0 +1 @@
+export { default } from './GridListTile';

packages/material-ui/src/GridListTileBar/GridListTileBar.d.ts

@@ -0,0 +1,27 @@
+import * as React from 'react';
+import { StandardProps } from '..';
+
+export interface GridListTileBarProps extends StandardProps<{}, GridListTileBarClassKey> {
+  actionIcon?: React.ReactNode;
+  actionPosition?: 'left' | 'right';
+  subtitle?: React.ReactNode;
+  title?: React.ReactNode;
+  titlePosition?: 'top' | 'bottom';
+}
+
+export type GridListTileBarClassKey =
+  | 'root'
+  | 'titlePositionBottom'
+  | 'titlePositionTop'
+  | 'rootSubtitle'
+  | 'titleWrap'
+  | 'titleWrapActionPosLeft'
+  | 'titleWrapActionPosRight'
+  | 'title'
+  | 'subtitle'
+  | 'actionIcon'
+  | 'actionIconActionPosLeft';
+
+declare const GridListTileBar: React.ComponentType<GridListTileBarProps>;
+
+export default GridListTileBar;

packages/material-ui/src/GridListTileBar/GridListTileBar.js

@@ -0,0 +1,19 @@
+// @inheritedComponent GridListTileBar
+
+import React from 'react';
+import warning from 'warning';
+import ImageListTileBar from '../ImageListTileBar';
+
+/**
+ * Deprecated, use ImageListTileBar instead.
+ */
+export default function GridListTileBar(props) {
+  warning(
+    false,
+    [
+      'Material-UI: the GridListTileBar component is deprecated.',
+      'The component was renamed to ImageListTileBar.',
+    ].join('\n'),
+  );
+  return <ImageListTileBar {...props} />;
+}

packages/material-ui/src/GridListTileBar/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './GridListTileBar';
+export * from './GridListTileBar';

packages/material-ui/src/GridListTileBar/index.js

@@ -0,0 +1 @@
+export { default } from './GridListTileBar';

packages/material-ui/src/index.d.ts

@@ -140,6 +140,9 @@ export { default as FormGroup } from './FormGroup';
 export { default as FormHelperText } from './FormHelperText';
 export { default as FormLabel } from './FormLabel';
 export { default as Grid } from './Grid';
+export { default as GridList } from './GridList';
+export { default as GridListTile } from './GridListTile';
+export { default as GridListTileBar } from './GridListTileBar';
 export { default as Grow } from './Grow';
 export { default as Hidden } from './Hidden';
 export { default as Icon } from './Icon';

packages/material-ui/src/index.js

@@ -51,6 +51,9 @@ export { default as FormGroup } from './FormGroup';
 export { default as FormHelperText } from './FormHelperText';
 export { default as FormLabel } from './FormLabel';
 export { default as Grid } from './Grid';
+export { default as GridList } from './GridList';
+export { default as GridListTile } from './GridListTile';
+export { default as GridListTileBar } from './GridListTileBar';
 export { default as Grow } from './Grow';
 export { default as Hidden } from './Hidden';
 export { default as Icon } from './Icon';

packages/material-ui/src/styles/overrides.d.ts

@@ -38,6 +38,9 @@ import { FormGroupClassKey } from '../FormGroup';
 import { FormHelperTextClassKey } from '../FormHelperText';
 import { FormLabelClassKey } from '../FormLabel';
 import { GridClassKey } from '../Grid';
+import { GridListClassKey } from '../GridList';
+import { GridListTileClassKey } from '../GridListTile';
+import { GridListTileBarClassKey } from '../GridListTileBar';
 import { IconButtonClassKey } from '../IconButton';
 import { IconClassKey } from '../Icon';
 import { ImageListClassKey } from '../ImageList';

packages/material-ui/src/styles/props.d.ts

@@ -33,6 +33,9 @@ import { FormGroupProps } from '../FormGroup';
 import { FormHelperTextProps } from '../FormHelperText';
 import { FormLabelProps } from '../FormLabel';
 import { GridProps } from '../Grid';
+import { GridListProps } from '../GridList';
+import { GridListTileBarProps } from '../GridListTileBar';
+import { GridListTileProps } from '../GridListTile';
 import { IconButtonProps } from '../IconButton';
 import { IconProps } from '../Icon';
 import { ImageListProps } from '../ImageList';
@@ -127,6 +130,9 @@ export interface ComponentsPropsList {
   MuiFormHelperText: FormHelperTextProps;
   MuiFormLabel: FormLabelProps;
   MuiGrid: GridProps;
+  MuiGridList: GridListProps;
+  MuiGridListTile: GridListTileProps;
+  MuiGridListTileBar: GridListTileBarProps;
   MuiIcon: IconProps;
   MuiIconButton: IconButtonProps;
   MuiImageList: ImageListProps;

pages/api/grid-list-tile-bar.js

@@ -0,0 +1,11 @@
+import 'docs/src/modules/components/bootstrap';
+// --- Post bootstrap -----
+import React from 'react';
+import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
+import markdown from './grid-list-tile-bar.md';
+
+function Page() {
+  return <MarkdownDocs markdown={markdown} />;
+}
+
+export default Page;

pages/api/grid-list-tile-bar.md

@@ -0,0 +1,28 @@
+---
+filename: /packages/material-ui/src/GridListTileBar/GridListTileBar.js
+---
+
+<!--- This documentation is automatically generated, do not try to edit it. -->
+
+# GridListTileBar API
+
+<p class="description">The API documentation of the GridListTileBar React component. Learn more about the properties and the CSS customization points.</p>
+
+```js
+import GridListTileBar from '@material-ui/core/GridListTileBar';
+```
+
+Deprecated, use ImageListTileBar instead.
+
+## Props
+
+| Name | Type | Default | Description |
+|:-----|:-----|:--------|:------------|
+
+Any other properties supplied will be spread to the root element ([GridListTileBar](/api/grid-list-tile-bar/)).
+
+## Inheritance
+
+The properties of the [GridListTileBar](/api/grid-list-tile-bar/) component are also available.
+You can take advantage of this behavior to [target nested components](/guides/api/#spread).
+

pages/api/grid-list-tile.js

@@ -0,0 +1,11 @@
+import 'docs/src/modules/components/bootstrap';
+// --- Post bootstrap -----
+import React from 'react';
+import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
+import markdown from './grid-list-tile.md';
+
+function Page() {
+  return <MarkdownDocs markdown={markdown} />;
+}
+
+export default Page;

pages/api/grid-list-tile.md

@@ -0,0 +1,28 @@
+---
+filename: /packages/material-ui/src/GridListTile/GridListTile.js
+---
+
+<!--- This documentation is automatically generated, do not try to edit it. -->
+
+# GridListTile API
+
+<p class="description">The API documentation of the GridListTile React component. Learn more about the properties and the CSS customization points.</p>
+
+```js
+import GridListTile from '@material-ui/core/GridListTile';
+```
+
+Deprecated, use ImageListTile instead.
+
+## Props
+
+| Name | Type | Default | Description |
+|:-----|:-----|:--------|:------------|
+
+Any other properties supplied will be spread to the root element ([GridListTile](/api/grid-list-tile/)).
+
+## Inheritance
+
+The properties of the [GridListTile](/api/grid-list-tile/) component are also available.
+You can take advantage of this behavior to [target nested components](/guides/api/#spread).
+

pages/api/grid-list.js

@@ -0,0 +1,11 @@
+import 'docs/src/modules/components/bootstrap';
+// --- Post bootstrap -----
+import React from 'react';
+import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
+import markdown from './grid-list.md';
+
+function Page() {
+  return <MarkdownDocs markdown={markdown} />;
+}
+
+export default Page;

pages/api/grid-list.md

@@ -0,0 +1,28 @@
+---
+filename: /packages/material-ui/src/GridList/GridList.js
+---
+
+<!--- This documentation is automatically generated, do not try to edit it. -->
+
+# GridList API
+
+<p class="description">The API documentation of the GridList React component. Learn more about the properties and the CSS customization points.</p>
+
+```js
+import GridList from '@material-ui/core/GridList';
+```
+
+Deprecated, use ImageList instead.
+
+## Props
+
+| Name | Type | Default | Description |
+|:-----|:-----|:--------|:------------|
+
+Any other properties supplied will be spread to the root element ([GridList](/api/grid-list/)).
+
+## Inheritance
+
+The properties of the [GridList](/api/grid-list/) component are also available.
+You can take advantage of this behavior to [target nested components](/guides/api/#spread).
+