feat(stepper): Merge initial prototype of stepper into the upstream stepper branch.

src/cdk/public_api.ts

@@ -15,3 +15,4 @@ export * from './portal/index';
 export * from './rxjs/index';
 export * from './observe-content/index';
 export * from './keyboard/index';
+export * from './stepper/index';

src/cdk/stepper/index.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+import {NgModule} from '@angular/core';
+import {CdkStepper, CdkStep} from './stepper';
+import {CommonModule} from '@angular/common';
+import {CdkStepLabel} from './step-label';
+
+@NgModule({
+  imports: [CommonModule],
+  exports: [CdkStep, CdkStepper, CdkStepLabel],
+  declarations: [CdkStep, CdkStepper, CdkStepLabel]
+})
+export class CdkStepperModule {}
+
+export * from './stepper';
+export * from './step-label';

src/cdk/stepper/step-label.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+import {Directive, TemplateRef} from '@angular/core';
+
+@Directive({
+  selector: '[cdkStepLabel]',
+})
+export class CdkStepLabel {
+  constructor(public template: TemplateRef<any>) { }
+}

src/cdk/stepper/step.html

@@ -0,0 +1 @@
+<ng-template><ng-content></ng-content></ng-template>

src/cdk/stepper/stepper.ts

@@ -0,0 +1,169 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+import {
+  ContentChildren,
+  EventEmitter,
+  Input,
+  Output,
+  QueryList,
+  Directive,
+  // This import is only used to define a generic type. The current TypeScript version incorrectly
+  // considers such imports as unused (https://github.com/Microsoft/TypeScript/issues/14953)
+  // tslint:disable-next-line:no-unused-variable
+  ElementRef,
+  Component,
+  ContentChild,
+  ViewChild,
+  TemplateRef
+} from '@angular/core';
+import {LEFT_ARROW, RIGHT_ARROW, ENTER, SPACE} from '../keyboard/keycodes';
+import {CdkStepLabel} from './step-label';
+
+/** Used to generate unique ID for each stepper component. */
+let nextId = 0;
+
+/** Change event emitted on selection changes. */
+export class CdkStepperSelectionEvent {
+  /** Index of the step now selected. */
+  selectedIndex: number;
+
+  /** Index of the step previously selected. */
+  previouslySelectedIndex: number;
+
+  /** The step instance now selected. */
+  selectedStep: CdkStep;
+
+  /** The step instance previously selected. */
+  previouslySelectedStep: CdkStep;
+}
+
+@Component({
+  selector: 'cdk-step',
+  templateUrl: 'step.html',
+})
+export class CdkStep {
+  /** Template for step label if it exists. */
+  @ContentChild(CdkStepLabel) stepLabel: CdkStepLabel;
+
+  /** Template for step content. */
+  @ViewChild(TemplateRef) content: TemplateRef<any>;
+
+  /** Label of the step. */
+  @Input()
+  label: string;
+
+  constructor(private _stepper: CdkStepper) { }
+
+  /** Selects this step component. */
+  select(): void {
+    this._stepper.selected = this;
+  }
+}
+
+@Directive({
+  selector: 'cdk-stepper',
+  host: {
+    '(focus)': '_focusStep()',
+    '(keydown)': '_onKeydown($event)',
+  },
+})
+export class CdkStepper {
+  /** The list of step components that the stepper is holding. */
+  @ContentChildren(CdkStep) _steps: QueryList<CdkStep>;
+
+  /** The list of step headers of the steps in the stepper. */
+  _stepHeader: QueryList<ElementRef>;
+
+  /** The index of the selected step. */
+  @Input()
+  get selectedIndex() { return this._selectedIndex; }
+  set selectedIndex(index: number) {
+    if (this._selectedIndex != index) {
+      this._emitStepperSelectionEvent(index);
+      this._focusStep(this._selectedIndex);
+    }
+  }
+  private _selectedIndex: number = 0;
+
+  /** The step that is selected. */
+  @Input()
+  get selected() { return this._steps[this.selectedIndex]; }
+  set selected(step: CdkStep) {
+    let index = this._steps.toArray().indexOf(step);
+    this.selectedIndex = index;
+  }
+
+  /** Event emitted when the selected step has changed. */
+  @Output() selectionChange = new EventEmitter<CdkStepperSelectionEvent>();
+
+  /** The index of the step that the focus can be set. */
+  _focusIndex: number = 0;
+
+  /** Used to track unique ID for each stepper component. */
+  private _groupId: number;
+
+  constructor() {
+    this._groupId = nextId++;
+  }
+
+  /** Selects and focuses the next step in list. */
+  next(): void {
+    this.selectedIndex = Math.min(this._selectedIndex + 1, this._steps.length - 1);
+  }
+
+  /** Selects and focuses the previous step in list. */
+  previous(): void {
+    this.selectedIndex = Math.max(this._selectedIndex - 1, 0);
+  }
+
+  /** Returns a unique id for each step label element. */
+  _getStepLabelId(i: number): string {
+    return `mat-step-label-${this._groupId}-${i}`;
+  }
+
+  /** Returns nique id for each step content element. */
+  _getStepContentId(i: number): string {
+    return `mat-step-content-${this._groupId}-${i}`;
+  }
+
+  private _emitStepperSelectionEvent(newIndex: number): void {
+    const stepsArray = this._steps.toArray();
+    this.selectionChange.emit({
+      selectedIndex: newIndex,
+      previouslySelectedIndex: this._selectedIndex,
+      selectedStep: stepsArray[newIndex],
+      previouslySelectedStep: stepsArray[this._selectedIndex],
+    });
+    this._selectedIndex = newIndex;
+  }
+
+  _onKeydown(event: KeyboardEvent) {
+    switch (event.keyCode) {
+      case RIGHT_ARROW:
+        this._focusStep((this._focusIndex + 1) % this._steps.length);
+        break;
+      case LEFT_ARROW:
+        this._focusStep((this._focusIndex + this._steps.length - 1) % this._steps.length);
+        break;
+      case SPACE:
+      case ENTER:
+        this._emitStepperSelectionEvent(this._focusIndex);
+        break;
+      default:
+        // Return to avoid calling preventDefault on keys that are not explicitly handled.
+        return;
+    }
+    event.preventDefault();
+  }
+
+  private _focusStep(index: number) {
+    this._focusIndex = index;
+    this._stepHeader.toArray()[this._focusIndex].nativeElement.focus();
+  }
+}

src/demo-app/demo-app-module.ts

@@ -76,10 +76,12 @@ import {
   MdToolbarModule,
   MdTooltipModule,
   OverlayContainer,
-  StyleModule
+  StyleModule,
+  MdStepperModule,
 } from '@angular/material';
 import {CdkTableModule} from '@angular/cdk';
 import {TableHeaderDemo} from './table/table-header-demo';
+import {StepperDemo} from './stepper/stepper-demo';
 
 /**
  * NgModule that includes all Material modules that are required to serve the demo-app.
@@ -118,7 +120,8 @@ import {TableHeaderDemo} from './table/table-header-demo';
     MdTooltipModule,
     MdNativeDateModule,
     CdkTableModule,
-    StyleModule
+    StyleModule,
+    MdStepperModule,
   ]
 })
 export class DemoMaterialModule {}
@@ -184,6 +187,7 @@ export class DemoMaterialModule {}
     PlatformDemo,
     TypographyDemo,
     ExpansionDemo,
+    StepperDemo,
   ],
   providers: [
     {provide: OverlayContainer, useClass: FullscreenOverlayContainer},

src/demo-app/demo-app/demo-app.ts

@@ -61,6 +61,7 @@ export class DemoApp {
     {name: 'Slider', route: 'slider'},
     {name: 'Slide Toggle', route: 'slide-toggle'},
     {name: 'Snack Bar', route: 'snack-bar'},
+    {name: 'Stepper', route: 'stepper'},
     {name: 'Table', route: 'table'},
     {name: 'Tabs', route: 'tabs'},
     {name: 'Toolbar', route: 'toolbar'},

src/demo-app/demo-app/routes.ts

@@ -36,6 +36,7 @@ import {DatepickerDemo} from '../datepicker/datepicker-demo';
 import {TableDemo} from '../table/table-demo';
 import {TypographyDemo} from '../typography/typography-demo';
 import {ExpansionDemo} from '../expansion/expansion-demo';
+import {StepperDemo} from '../stepper/stepper-demo';
 
 export const DEMO_APP_ROUTES: Routes = [
   {path: '', component: Home},
@@ -74,4 +75,5 @@ export const DEMO_APP_ROUTES: Routes = [
   {path: 'style', component: StyleDemo},
   {path: 'typography', component: TypographyDemo},
   {path: 'expansion', component: ExpansionDemo},
+  {path: 'stepper', component: StepperDemo},
 ];

src/demo-app/stepper/stepper-demo.html

@@ -0,0 +1,27 @@
+<h2>Horizontal Stepper Demo</h2>
+<mat-horizontal-stepper>
+  <mat-step *ngFor="let step of steps" [label]="step.label">
+    <md-input-container>
+      <input mdInput placeholder="Answer" [(ngModel)]="step.content">
+    </md-input-container>
+  </mat-step>
+</mat-horizontal-stepper>
+
+<h2>Horizontal Stepper Demo with Templated Label</h2>
+<mat-horizontal-stepper>
+  <mat-step *ngFor="let step of steps">
+    <ng-template matStepLabel>{{step.label}}</ng-template>
+    <md-input-container>
+      <input mdInput placeholder="Answer" [(ngModel)]="step.content">
+    </md-input-container>
+  </mat-step>
+</mat-horizontal-stepper>
+
+<h2>Vertical Stepper Demo</h2>
+<mat-vertical-stepper>
+  <mat-step *ngFor="let step of steps" [label]="step.label">
+    <md-input-container>
+      <input mdInput placeholder="Answer" [(ngModel)]="step.content">
+    </md-input-container>
+  </mat-step>
+</mat-vertical-stepper>

src/demo-app/stepper/stepper-demo.ts

@@ -0,0 +1,16 @@
+import {Component} from '@angular/core';
+
+@Component({
+  moduleId: module.id,
+  selector: 'stepper-demo',
+  templateUrl: 'stepper-demo.html',
+  styleUrls: ['stepper-demo.scss'],
+})
+export class StepperDemo {
+  steps = [
+    {label: 'Confirm your name', content: 'Last name, First name.'},
+    {label: 'Confirm your contact information', content: '123-456-7890'},
+    {label: 'Confirm your address', content: '1600 Amphitheater Pkwy MTV'},
+    {label: 'You are now done', content: 'Finished!'}
+  ];
+}

src/lib/module.ts

@@ -48,6 +48,7 @@ import {MdExpansionModule} from './expansion/index';
 import {MdTableModule} from './table/index';
 import {MdSortModule} from './sort/index';
 import {MdPaginatorModule} from './paginator/index';
+import {MdStepperModule} from './stepper/index';
 
 const MATERIAL_MODULES = [
   MdAutocompleteModule,
@@ -86,7 +87,8 @@ const MATERIAL_MODULES = [
   A11yModule,
   PlatformModule,
   MdCommonModule,
-  ObserveContentModule
+  ObserveContentModule,
+  MdStepperModule,
 ];
 
 /** @deprecated */

src/lib/public_api.ts

@@ -44,3 +44,4 @@ export * from './tabs/index';
 export * from './tabs/tab-nav-bar/index';
 export * from './toolbar/index';
 export * from './tooltip/index';
+export * from './stepper/index';

src/lib/stepper/index.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+import {NgModule} from '@angular/core';
+import {CommonModule} from '@angular/common';
+import {PortalModule} from '@angular/cdk';
+import {MdButtonModule} from '../button/index';
+import {MdHorizontalStepper} from './stepper-horizontal';
+import {MdVerticalStepper} from './stepper-vertical';
+import {MdStep} from './step';
+import {MdStepper} from './stepper';
+import {CdkStepperModule} from '@angular/cdk';
+import {MdCommonModule} from '../core';
+import {MdStepLabel} from './step-label';
+
+@NgModule({
+  imports: [MdCommonModule, CommonModule, PortalModule, MdButtonModule, CdkStepperModule],
+  exports: [MdCommonModule, MdHorizontalStepper, MdVerticalStepper, MdStep, MdStepLabel, MdStepper],
+  declarations: [MdHorizontalStepper, MdVerticalStepper, MdStep, MdStepLabel, MdStepper],
+})
+export class MdStepperModule {}
+
+export * from './stepper-horizontal';
+export * from './stepper-vertical';
+export * from './step';
+export * from './step-label';
+export * from './stepper';

src/lib/stepper/step-label.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+import {Directive, TemplateRef} from '@angular/core';
+import {CdkStepLabel} from '@angular/cdk';
+
+@Directive({
+  selector: '[mdStepLabel], [matStepLabel]',
+})
+export class MdStepLabel extends CdkStepLabel {
+  constructor(template: TemplateRef<any>) {
+    super(template);
+  }
+}

src/lib/stepper/step.html

@@ -0,0 +1 @@
+<ng-template><ng-content></ng-content></ng-template>