Merge branch 'master' into disable-body-scroll

Author: crisbeto

.gitignore

@@ -3,7 +3,6 @@
 # compiled output
 /dist
 /tmp
-/typings
 /deploy
 
 # dependencies

.travis.yml

@@ -24,6 +24,7 @@ env:
   - BROWSER_STACK_ACCESS_KEY=BWCd4SynLzdDcv8xtzsB
   - ARCH=linux-x64
   - BROWSER_PROVIDER_READY_FILE=/tmp/angular-material2-build/readyfile
+  - BROWSER_PROVIDER_ERROR_FILE=/tmp/angular-material2-build/errorfile
   # GITHUB_TOKEN_ANGULAR
   - secure: "fq/U7VDMWO8O8SnAQkdbkoSe2X92PVqg4d044HmRYVmcf6YbO48+xeGJ8yOk0pCBwl3ISO4Q2ot0x546kxfiYBuHkZetlngZxZCtQiFT9kyId8ZKcYdXaIW9OVdw3Gh3tQyUwDucfkVhqcs52D6NZjyE2aWZ4/d1V4kWRO/LMgo="
   matrix:
@@ -51,6 +52,9 @@ before_script:
 script:
   - ./scripts/ci/build-and-test.sh
 
+after_success:
+  - ./scripts/ci/after-success.sh
+
 cache:
   directories:
     - node_modules

CHANGELOG.md

@@ -3,7 +3,7 @@
 
 ## Code style
 
-The [Google JavaScript Style Guide](https://google.github.io/styleguide/javascriptguide.xml) is the
+The [Google JavaScript Style Guide](https://google.github.io/styleguide/jsguide.html) is the
 basis for our coding style, with additional guidance here where that style guide is not aligned with
 ES6 or TypeScript.
 

CODING_STANDARDS.md

@@ -237,7 +237,7 @@ changes to be accepted, the CLA must be signed. It's a quick process, we promise
 [github]: https://github.com/angular/material2
 [gitter]: https://gitter.im/angular/material2
 [individual-cla]: http://code.google.com/legal/individual-cla-v1.0.html
-[js-style-guide]: https://google.github.io/styleguide/javascriptguide.xml
+[js-style-guide]: https://google.github.io/styleguide/jsguide.html
 [codepen]: http://codepen.io/
 [jsbin]: http://jsbin.com/
 [jsfiddle]: http://jsfiddle.net/

CONTRIBUTING.md

@@ -25,5 +25,5 @@ To run lint, run `gulp lint`.
 ### Running benchmarks
 Not yet implemented.
 
-### Running screenshot diff tests.
+### Running screenshot diff tests
 Not yet implemented.

DEV_ENVIRONMENT.md

@@ -10,33 +10,42 @@ This is the home for the Angular team's Material Design components built on top
 [Contributing](https://github.com/angular/material2/blob/master/CONTRIBUTING.md),
 [Plunker Template](http://plnkr.co/edit/o077B6uEiiIgkC0S06dd?p=preview)
 
-### Getting started 
+### Installation
 
-See our [Getting Started Guide](https://github.com/angular/material2/blob/master/GETTING_STARTED.md)
+The latest release of Angular Material can be installed from npm
+
+`npm install @angular/material`
+
+Playing with the latest changes from [master](https://github.com/angular/material2/tree/master) is also possible
+
+`npm install https://github.com/angular/material2-builds.git`
+
+### Getting started
+
+See our [Getting Started Guide][getting-started]
 if you're building your first project with Angular Material 2.
 
 ### Project status
-Angular Material 2 is currently in alpha and under active development. 
-During alpha, breaking API and behavior changes will be occurring regularly.
+Angular Material 2 is currently in beta and under active development.
+During beta, new features will be added regularly and APIs will evolve based on user feedback.
 
-Check out our [directory of design documents](https://github.com/angular/material2/wiki/Design-doc-directory) 
+Check out our [directory of design documents](https://github.com/angular/material2/wiki/Design-doc-directory)
 for more insight into our process.
 
-If you'd like to contribute, you must follow our [contributing guidelines](https://github.com/angular/material2/blob/master/CONTRIBUTING.md). 
-You can look through the issues (which should be up-to-date on who is working on which features 
-and which pieces are blocked) and make a comment. 
-Also see our [`Good for community contribution`](https://github.com/angular/material2/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+for+community+contribution%22) 
+If you'd like to contribute, you must follow our [contributing guidelines](https://github.com/angular/material2/blob/master/CONTRIBUTING.md).
+You can look through the issues (which should be up-to-date on who is working on which features
+and which pieces are blocked) and make a comment.
+Also see our [`Good for community contribution`](https://github.com/angular/material2/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+for+community+contribution%22)
 label.
 
-High level items planned for November 2016:
-* Initial version of md-select
-* Continued bug bashing
-* Initial versions of autocomplete and chips
-* AoT compile e2e app
-* Continue work on https://material.angular.io site
-* Major refactoring for md-input
-* Tabs animations
-* Expanding e2e test coverage
+High level items planned for January 2017:
+* Initial version of md-autocomplete
+* Prototyping for data-table
+* Improvements to https://material.angular.io
+* Continued expanding e2e test coverage
+* More work on scroll / resize handling for overlays
+* Screenshot tests
+* Better development automation
 
 
 #### Feature status:
@@ -53,35 +62,35 @@ High level items planned for November 2016:
 | list             |                           Available | [README][8]  |   [#107][0107] |
 | grid-list        |                           Available | [README][9]  |              - |
 | icon             |                           Available | [README][10] |              - |
-| progress-circle  |                           Available | [README][11] |              - |
+| progress-spinner |                           Available | [README][11] |              - |
 | progress-bar     |                           Available | [README][12] |              - |
 | tabs             |                           Available | [README][13] |              - |
 | slide-toggle     |                           Available | [README][14] |              - |
 | button-toggle    |                           Available | [README][15] |              - |
 | slider           |                           Available | [README][16] |              - |
 | menu             |                           Available | [README][17] |   [#119][0119] |
-| tooltip          | Initial version, needs enhancements | [README][18] |              - |
+| tooltip          |                           Available | [README][18] |              - |
 | ripples          |                           Available | [README][19] |   [#108][0108] |
 | dialog           |                           Available | [README][22] |   [#114][0114] |
 | snackbar / toast |                           Available | [README][21] |   [#115][0115] |
-| select           |        Will be released in alpha.11 |           -  |   [#118][0118] |
-| textarea         |                             Started |           -  |   [#546][0546] |
-| autocomplete     |                      Design started |           -  |   [#117][0117] |
-| chips            |                             Started |           -  |   [#120][0120] |
+| select           |                           Available |           -  |   [#118][0118] |
+| textarea         |                           Available |           -  |              - |
+| autocomplete     |                         In-progress |           -  |   [#117][0117] |
+| chips            |  Initial version, features evolving |           -  |   [#120][0120] |
 | theming          |   Available, need guidance overlays | [Guide][20]  |              - |
-| prod build       |                         Not started |           -  |              - |
 | docs site        |   UX design and tooling in progress |           -  |              - |
 | typography       |                         Not started |           -  |   [#205][0205] |
-| layout           |      Design in-progress, prototyped |           -  |              - |
 | fab speed-dial   |                         Not started |           -  |   [#860][0860] |
 | fab toolbar      |                         Not started |           -  |              - |
 | bottom-sheet     |                         Not started |           -  |              - |
 | bottom-nav       |                         Not started |           -  |   [#408][0408] |
 | virtual-repeat   |                         Not started |           -  |   [#823][0823] |
 | datepicker       |                         Not started |           -  |   [#675][0675] |
-| data-table       |                         Not started |           -  |   [#581][0581] |
+| data-table       |                  Design in-progress |           -  |   [#581][0581] |
 | stepper          |                         Not started |           -  |   [#508][0508] |
+| layout           |   see [angular/flex-layout][lay_rp] |           -  |              - |
 
+ [lay_rp]:  https://github.com/angular/flex-layout
  [1]: https://github.com/angular/material2/blob/master/src/lib/button/README.md
  [2]: https://github.com/angular/material2/blob/master/src/lib/card/README.md
  [3]: https://github.com/angular/material2/blob/master/src/lib/checkbox/README.md
@@ -92,7 +101,7 @@ High level items planned for November 2016:
  [8]: https://github.com/angular/material2/blob/master/src/lib/list/README.md
  [9]: https://github.com/angular/material2/blob/master/src/lib/grid-list/README.md
 [10]: https://github.com/angular/material2/blob/master/src/lib/icon/README.md
-[11]: https://github.com/angular/material2/blob/master/src/lib/progress-circle/README.md
+[11]: https://github.com/angular/material2/blob/master/src/lib/progress-spinner/README.md
 [12]: https://github.com/angular/material2/blob/master/src/lib/progress-bar/README.md
 [13]: https://github.com/angular/material2/blob/master/src/lib/tabs/README.md
 [14]: https://github.com/angular/material2/blob/master/src/lib/slide-toggle/README.md
@@ -101,7 +110,7 @@ High level items planned for November 2016:
 [17]: https://github.com/angular/material2/blob/master/src/lib/menu/README.md
 [18]: https://github.com/angular/material2/blob/master/src/lib/tooltip/README.md
 [19]: https://github.com/angular/material2/blob/master/src/lib/core/ripple/README.md
-[20]: https://github.com/angular/material2/blob/master/docs/theming.md
+[20]: https://github.com/angular/material2/blob/master/guides/theming.md
 [21]: https://github.com/angular/material2/blob/master/src/lib/snack-bar/README.md
 [22]: https://github.com/angular/material2/blob/master/src/lib/dialog/README.md
 
@@ -123,13 +132,16 @@ High level items planned for November 2016:
 [0675]: https://github.com/angular/material2/issues/675
 [0581]: https://github.com/angular/material2/issues/581
 
+[getting-started]: https://github.com/angular/material2/blob/master/guides/getting-started.md
+[theming]: https://github.com/angular/material2/blob/master/guides/theming.md
+
 
 "Available" means that the components or feature is published and available for use, but may still
 be missing some behaviors or polish.
 
 ## The goal of Angular Material
-Our goal is to build a set of high-quality UI components built with Angular 2 and TypeScript, 
-following the Material Design spec. These 
+Our goal is to build a set of high-quality UI components built with Angular 2 and TypeScript,
+following the Material Design spec. These
 components will serve as an example of how to write Angular code following best practices.
 
 ### What do we mean by "high-quality"?
@@ -142,7 +154,7 @@ components will serve as an example of how to write Angular code following best
 * Code is clean and well-documented to serve as an example for Angular devs.
 
 ## Browser and screen reader support
-Angular Material supports the most recent two versions of all major browsers: 
+Angular Material supports the most recent two versions of all major browsers:
 Chrome (including Android), Firefox, Safari (including iOS), and IE11 / Edge
 
 We also aim for great user experience with the following screen readers:

README.md

@@ -1,3 +1,5 @@
+import {browser, by, element} from 'protractor';
+
 describe('button', function () {
   describe('disabling behavior', function () {
     beforeEach(function() {

e2e/components/button/button.e2e.ts

@@ -1,18 +1,41 @@
+import {browser, by, element, Key} from 'protractor';
+
 describe('checkbox', function () {
+
   describe('check behavior', function () {
+
     beforeEach(function() {
       browser.get('/checkbox');
     });
-    it('should be checked when clicked, and be unchecked when clicked again', function () {
-      element(by.id('test-checkbox')).click();
-      element(by.css('input[id=input-test-checkbox]')).getAttribute('checked').then((value: string) => {
+
+    it('should be checked when clicked, and be unchecked when clicked again', () => {
+      let checkboxEl = element(by.id('test-checkbox'));
+      let inputEl = element(by.css('input[id=input-test-checkbox]'));
+
+      checkboxEl.click();
+      inputEl.getAttribute('checked').then((value: string) => {
         expect(value).toBeTruthy('Expect checkbox "checked" property to be true');
       });
 
-      element(by.id('test-checkbox')).click();
-      element(by.css('input[id=input-test-checkbox]')).getAttribute('checked').then((value: string) => {
+      checkboxEl.click();
+      inputEl.getAttribute('checked').then((value: string) => {
         expect(value).toBeFalsy('Expect checkbox "checked" property to be false');
       });
     });
+
+    it('should toggle the checkbox when pressing space', () => {
+      let inputEl = element(by.css('input[id=input-test-checkbox]'));
+
+      inputEl.getAttribute('checked').then((value: string) => {
+        expect(value).toBeFalsy('Expect checkbox "checked" property to be false');
+      });
+
+      inputEl.sendKeys(Key.SPACE);
+
+      inputEl.getAttribute('checked').then((value: string) => {
+        expect(value).toBeTruthy('Expect checkbox "checked" property to be true');
+      });
+    });
+
   });
 });

e2e/components/checkbox/checkbox.e2e.ts

@@ -1,17 +1,19 @@
+import {browser, by, element, Key, ProtractorBy} from 'protractor';
+
 describe('dialog', () => {
   beforeEach(() => browser.get('/dialog'));
 
   it('should open a dialog', () => {
     element(by.id('default')).click();
-    waitForDialog().then(isPresent => expect(isPresent).toBe(true));
+    waitForDialog().then((isPresent: boolean) => expect(isPresent).toBe(true));
   });
 
   it('should close by clicking on the backdrop', () => {
     element(by.id('default')).click();
 
     waitForDialog().then(() => {
       clickOnBackrop();
-      waitForDialog().then(isPresent => expect(isPresent).toBe(false));
+      waitForDialog().then((isPresent: boolean) => expect(isPresent).toBe(false));
     });
   });
 
@@ -20,7 +22,7 @@ describe('dialog', () => {
 
     waitForDialog().then(() => {
       pressEscape();
-      waitForDialog().then(isPresent => expect(isPresent).toBe(false));
+      waitForDialog().then((isPresent: boolean) => expect(isPresent).toBe(false));
     });
   });
 
@@ -29,7 +31,7 @@ describe('dialog', () => {
 
     waitForDialog().then(() => {
       element(by.id('close')).click();
-      waitForDialog().then(isPresent => expect(isPresent).toBe(false));
+      waitForDialog().then((isPresent: boolean) => expect(isPresent).toBe(false));
     });
   });
 
@@ -56,7 +58,7 @@ describe('dialog', () => {
     element(by.id('default')).click();
 
     waitForDialog().then(() => {
-      let tab = protractor.Key.TAB;
+      let tab = Key.TAB;
 
       browser.actions().sendKeys(tab, tab, tab).perform();
       expectFocusOn(element(by.id('close')));
@@ -68,7 +70,7 @@ describe('dialog', () => {
 
     waitForDialog().then(() => {
       clickOnBackrop();
-      waitForDialog().then(isPresent => expect(isPresent).toBe(true));
+      waitForDialog().then((isPresent: boolean) => expect(isPresent).toBe(true));
     });
   });
 
@@ -77,25 +79,25 @@ describe('dialog', () => {
 
     waitForDialog().then(() => {
       pressEscape();
-      waitForDialog().then(isPresent => expect(isPresent).toBe(true));
+      waitForDialog().then((isPresent: boolean) => expect(isPresent).toBe(true));
     });
   });
 
   function waitForDialog() {
-    return browser.isElementPresent(by.css('md-dialog-container'));
+    return browser.isElementPresent(by.css('md-dialog-container') as ProtractorBy);
   }
 
   function clickOnBackrop() {
     browser.actions()
       // We need to move the cursor to the top left so
       // the dialog doesn't receive the click accidentally.
-      .mouseMove(element(by.css('.md-overlay-backdrop')).getWebElement(), { x: 0, y: 0 })
+      .mouseMove(element(by.css('.cdk-overlay-backdrop')).getWebElement(), { x: 0, y: 0 })
       .click()
       .perform();
   }
 
   function pressEscape() {
-    browser.actions().sendKeys(protractor.Key.ESCAPE).perform();
+    browser.actions().sendKeys(Key.ESCAPE).perform();
   }
 
   // TODO(crisbeto): should be moved to a common util. copied from the menu e2e setup.

e2e/components/dialog/dialog.e2e.ts

@@ -1,3 +1,5 @@
+import {browser, by, element} from 'protractor';
+
 describe('grid-list', () => {
   beforeEach(() => browser.get('/grid-list'));
 

e2e/components/grid-list/grid-list.e2e.ts

@@ -1,3 +1,5 @@
+import {browser, by, element} from 'protractor';
+
 describe('icon', () => {
   describe('font icons by ligature', () => {
     let testIcon: any;

e2e/components/icon/icon.e2e.ts

@@ -1,3 +1,5 @@
+import {browser, by, element} from 'protractor';
+
 describe('list', () => {
   beforeEach(() => browser.get('/list'));