docs(aio): update migrated content from anguar.io

aio/content/examples/hierarchical-dependency-injection/src/app/app.component.ts

@@ -0,0 +1,21 @@
+import { Component } from '@angular/core';
+
+@Component({
+  selector: 'my-app',
+  template: `
+    <label><input type="checkbox" [checked]="showHeroes"   (change)="showHeroes=!showHeroes">Heroes</label>
+    <label><input type="checkbox" [checked]="showVillains" (change)="showVillains=!showVillains">Villains</label>
+    <label><input type="checkbox" [checked]="showCars"     (change)="showCars=!showCars">Cars</label>
+
+    <h1>Hierarchical Dependency Injection</h1>
+
+    <heroes-list   *ngIf="showHeroes"></heroes-list>
+    <villains-list *ngIf="showVillains"></villains-list>
+    <my-cars       *ngIf="showCars"></my-cars>
+  `
+})
+export class AppComponent {
+  showCars = true;
+  showHeroes = true;
+  showVillains = true;
+}

aio/content/examples/hierarchical-dependency-injection/src/app/app.module.ts

@@ -0,0 +1,33 @@
+// #docregion
+import { NgModule }      from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+import { FormsModule }   from '@angular/forms';
+
+import { AppComponent }          from './app.component';
+import { HeroTaxReturnComponent }     from './hero-tax-return.component';
+import { HeroesListComponent }   from './heroes-list.component';
+import { HeroesService }         from './heroes.service';
+import { VillainsListComponent } from './villains-list.component';
+
+import { carComponents, carServices } from './car.components';
+
+@NgModule({
+  imports: [
+    BrowserModule,
+    FormsModule
+  ],
+  providers: [
+    carServices,
+    HeroesService
+ ],
+  declarations: [
+    AppComponent,
+    carComponents,
+    HeroesListComponent,
+    HeroTaxReturnComponent,
+    VillainsListComponent
+  ],
+  bootstrap: [ AppComponent ]
+})
+export class AppModule { }
+

aio/content/examples/hierarchical-dependency-injection/src/app/car.components.ts

@@ -0,0 +1,74 @@
+import { Component } from '@angular/core';
+
+import {
+  CarService, CarService2, CarService3,
+  EngineService, EngineService2, TiresService
+} from './car.services';
+
+////////// CCarComponent ////////////
+@Component({
+  selector: 'c-car',
+  template: `<div>C: {{description}}</div>`,
+  providers: [
+    { provide: CarService, useClass: CarService3 }
+  ]
+})
+export class CCarComponent {
+  description: string;
+  constructor(carService: CarService) {
+    this.description = `${carService.getCar().description} (${carService.name})`;
+  }
+}
+
+////////// BCarComponent ////////////
+@Component({
+  selector: 'b-car',
+  template: `
+    <div>B: {{description}}</div>
+    <c-car></c-car>
+  `,
+  providers: [
+    { provide: CarService,    useClass: CarService2 },
+    { provide: EngineService, useClass: EngineService2 }
+  ]
+})
+export class BCarComponent {
+  description: string;
+  constructor(carService: CarService) {
+    this.description = `${carService.getCar().description} (${carService.name})`;
+  }
+}
+
+////////// ACarComponent ////////////
+@Component({
+  selector: 'a-car',
+  template: `
+  <div>A: {{description}}</div>
+  <b-car></b-car>`
+})
+export class ACarComponent {
+  description: string;
+  constructor(carService: CarService) {
+    this.description = `${carService.getCar().description} (${carService.name})`;
+  }
+}
+////////// CarsComponent ////////////
+@Component({
+  selector: 'my-cars',
+  template: `
+  <h3>Cars</h3>
+  <a-car></a-car>`
+})
+export class CarsComponent { }
+
+////////////////
+
+export const carComponents = [
+  CarsComponent,
+  ACarComponent, BCarComponent, CCarComponent
+];
+
+// generic car-related services
+export const carServices = [
+ CarService, EngineService, TiresService
+];

aio/content/examples/hierarchical-dependency-injection/src/app/car.services.ts

@@ -0,0 +1,95 @@
+import { Injectable } from '@angular/core';
+
+/// Model ///
+export class Car {
+  name = 'Avocado Motors';
+  constructor(public engine: Engine, public tires: Tires) { }
+
+  get description() {
+    return `${this.name} car with ` +
+      `${this.engine.cylinders} cylinders and ${this.tires.make} tires.`;
+  }
+}
+
+export class Engine {
+  cylinders = 4;
+}
+
+export class Tires {
+  make  = 'Flintstone';
+  model = 'Square';
+}
+
+//// Engine services ///
+@Injectable()
+export class EngineService {
+  id = 'E1';
+  getEngine() { return new Engine(); }
+}
+
+@Injectable()
+export class EngineService2 {
+  id = 'E2';
+  getEngine() {
+    const eng = new Engine();
+    eng.cylinders = 8;
+    return eng;
+  }
+}
+
+//// Tire services ///
+@Injectable()
+export class TiresService {
+  id = 'T1';
+  getTires() { return new Tires(); }
+}
+
+/// Car Services ///
+@Injectable()
+export class CarService {
+  id = 'C1';
+  constructor(
+    protected engineService: EngineService,
+    protected tiresService: TiresService) { }
+
+  getCar() {
+    return new Car(
+      this.engineService.getEngine(),
+      this.tiresService.getTires());
+  }
+
+  get name() {
+    return `${this.id}-${this.engineService.id}-${this.tiresService.id}`;
+  }
+}
+
+@Injectable()
+export class CarService2 extends CarService {
+  id = 'C2';
+  constructor(
+    protected engineService: EngineService,
+    protected tiresService: TiresService) {
+    super(engineService, tiresService);
+  }
+  getCar() {
+    const car = super.getCar();
+    car.name = 'BamBam Motors, BroVan 2000';
+    return car;
+  }
+}
+
+@Injectable()
+export class CarService3 extends CarService2 {
+  id = 'C3';
+  constructor(
+    protected engineService: EngineService,
+    protected tiresService: TiresService) {
+    super(engineService, tiresService);
+  }
+  getCar() {
+    const car = super.getCar();
+    car.name = 'Chizzamm Motors, Calico UltraMax Supreme';
+    return car;
+  }
+}
+

aio/content/examples/hierarchical-dependency-injection/src/app/hero-tax-return.component.css

@@ -0,0 +1,22 @@
+.tax-return { border: thin dashed green; margin: 1em; padding: 1em; width: 18em; position: relative }
+#name { font-weight: bold;}
+#tid { float: right; }
+input { font-size: 100%; padding-left: 2px; width: 6em; }
+input.num { text-align: right; padding-left: 0; padding-right: 4px; width: 4em;}
+fieldset { border: 0 none;}
+
+.msg {
+  color: white;
+  font-size: 150%;
+  position: absolute;
+  /*opacity: 0.3;*/
+  left: 2px;
+  top: 3em;
+  width: 98%;
+  background-color: green;
+  text-align: center;
+}
+.msg.canceled {
+  color: white;
+  background-color: red;
+}

aio/content/examples/hierarchical-dependency-injection/src/app/hero-tax-return.component.html

@@ -0,0 +1,20 @@
+<div class="tax-return">
+  <div class="msg" [class.canceled]="message==='Canceled'">{{message}}</div>
+  <fieldset>
+    <span  id=name>{{taxReturn.name}}</span>
+    <label id=tid>TID: {{taxReturn.tid}}</label>
+  </fieldset>
+  <fieldset>
+    <label>
+      Income: <input [(ngModel)]="taxReturn.income" class="num">
+    </label>
+  </fieldset>
+  <fieldset>
+    <label>Tax: {{taxReturn.tax}}</label>
+  </fieldset>
+  <fieldset>
+    <button (click)="onSaved()">Save</button>
+    <button (click)="onCanceled()">Cancel</button>
+    <button (click)="onClose()">Close</button>
+  </fieldset>
+</div>

aio/content/examples/hierarchical-dependency-injection/src/app/hero-tax-return.component.ts

@@ -0,0 +1,44 @@
+// #docregion
+import { Component, EventEmitter, Input, Output } from '@angular/core';
+import { HeroTaxReturn }        from './hero';
+import { HeroTaxReturnService } from './hero-tax-return.service';
+
+@Component({
+  selector: 'hero-tax-return',
+  templateUrl: './hero-tax-return.component.html',
+  styleUrls: [ './hero-tax-return.component.css' ],
+  // #docregion providers
+  providers: [ HeroTaxReturnService ]
+  // #enddocregion providers
+})
+export class HeroTaxReturnComponent {
+  message = '';
+  @Output() close = new EventEmitter<void>();
+
+  get taxReturn(): HeroTaxReturn {
+    return this.heroTaxReturnService.taxReturn;
+  }
+  @Input()
+  set taxReturn (htr: HeroTaxReturn) {
+    this.heroTaxReturnService.taxReturn = htr;
+  }
+
+  constructor(private heroTaxReturnService: HeroTaxReturnService ) { }
+
+  onCanceled()  {
+    this.flashMessage('Canceled');
+    this.heroTaxReturnService.restoreTaxReturn();
+  };
+
+  onClose()  { this.close.emit(); };
+
+  onSaved() {
+    this.flashMessage('Saved');
+    this.heroTaxReturnService.saveTaxReturn();
+  }
+
+  flashMessage(msg: string) {
+    this.message = msg;
+    setTimeout(() => this.message = '', 500);
+  }
+}

aio/content/examples/hierarchical-dependency-injection/src/app/hero-tax-return.service.ts

@@ -0,0 +1,30 @@
+// #docregion
+import { Injectable }    from '@angular/core';
+import { HeroTaxReturn } from './hero';
+import { HeroesService } from './heroes.service';
+
+@Injectable()
+export class HeroTaxReturnService {
+  private currentTaxReturn: HeroTaxReturn;
+  private originalTaxReturn: HeroTaxReturn;
+
+  constructor(private heroService: HeroesService) { }
+
+  set taxReturn (htr: HeroTaxReturn) {
+    this.originalTaxReturn = htr;
+    this.currentTaxReturn  = htr.clone();
+  }
+
+  get taxReturn (): HeroTaxReturn {
+    return this.currentTaxReturn;
+  }
+
+  restoreTaxReturn() {
+    this.taxReturn = this.originalTaxReturn;
+  }
+
+  saveTaxReturn() {
+    this.taxReturn = this.currentTaxReturn;
+    this.heroService.saveTaxReturn(this.currentTaxReturn).subscribe();
+  }
+}

aio/content/examples/hierarchical-dependency-injection/src/app/hero.ts

@@ -0,0 +1,31 @@
+// #docregion
+
+export class Hero {
+  id:   number;
+  name: string;
+  tid:  string; // tax id
+}
+
+//// HeroTaxReturn ////
+let nextId = 100;
+
+export class HeroTaxReturn {
+  constructor(
+    public id = nextId++,
+    public hero: Hero,
+    public income = 0 ) {
+      if (id === 0) { id = nextId++; }
+    }
+
+  get name() { return this.hero.name; }
+  get tax()  { return this.income ? .10 * this.income : 0; }
+  get tid()  { return this.hero.tid; }
+
+  toString() {
+    return `${this.hero.name}`;
+  }
+
+  clone() {
+    return new HeroTaxReturn(this.id, this.hero, this.income);
+  }
+}

aio/content/examples/hierarchical-dependency-injection/src/app/heroes-list.component.ts

@@ -0,0 +1,48 @@
+// #docregion
+import { Component }  from '@angular/core';
+import { Observable } from 'rxjs/Observable';
+
+import { Hero, HeroTaxReturn } from './hero';
+import { HeroesService }       from './heroes.service';
+
+@Component({
+  selector: 'heroes-list',
+  template: `
+    <div>
+      <h3>Hero Tax Returns</h3>
+      <ul>
+        <li *ngFor="let hero of heroes | async"
+            (click)="showTaxReturn(hero)">{{hero.name}}
+        </li>
+      </ul>
+      <hero-tax-return
+        *ngFor="let selected of selectedTaxReturns; let i = index"
+        [taxReturn]="selected"
+        (close)="closeTaxReturn(i)">
+      </hero-tax-return>
+    </div>
+    `,
+  styles: [ 'li {cursor: pointer;}' ]
+})
+export class HeroesListComponent {
+  heroes: Observable<Hero[]>;
+  selectedTaxReturns: HeroTaxReturn[] = [];
+
+  constructor(private heroesService: HeroesService) {
+    this.heroes = heroesService.getHeroes();
+  }
+
+  showTaxReturn(hero: Hero) {
+    this.heroesService.getTaxReturn(hero)
+    .subscribe(htr => {
+      // show if not currently shown
+      if (!this.selectedTaxReturns.find(tr => tr.id === htr.id)) {
+        this.selectedTaxReturns.push(htr);
+      }
+    });
+  }
+
+  closeTaxReturn(ix: number) {
+    this.selectedTaxReturns.splice(ix, 1);
+  }
+}

aio/content/examples/hierarchical-dependency-injection/src/app/heroes.service.ts

@@ -0,0 +1,47 @@
+import { Injectable } from '@angular/core';
+
+import { Observable } from 'rxjs/Observable';
+import { Observer } from 'rxjs/Observer';
+
+import { Hero, HeroTaxReturn } from './hero';
+
+@Injectable()
+export class HeroesService {
+  heroes: Hero[] = [
+    { id: 1, name: 'RubberMan', tid: '082-27-5678'},
+    { id: 2, name: 'Tornado',   tid: '099-42-4321'}
+  ];
+
+  heroTaxReturns: HeroTaxReturn[] = [
+    new HeroTaxReturn(10, this.heroes[0], 35000),
+    new HeroTaxReturn(20, this.heroes[1], 1250000)
+  ];
+
+  getHeroes(): Observable<Hero[]> {
+    return new Observable<Hero[]>((observer: Observer<Hero[]>) => {
+      observer.next(this.heroes);
+      observer.complete();
+    });
+  }
+
+  getTaxReturn(hero: Hero): Observable<HeroTaxReturn> {
+    return new Observable<HeroTaxReturn>((observer: Observer<HeroTaxReturn>) => {
+      const htr = this.heroTaxReturns.find(t => t.hero.id === hero.id);
+      observer.next(htr || new HeroTaxReturn(0, hero));
+      observer.complete();
+    });
+  }
+
+  saveTaxReturn(heroTaxReturn: HeroTaxReturn): Observable<HeroTaxReturn> {
+    return new Observable<HeroTaxReturn>((observer: Observer<HeroTaxReturn>) => {
+      const htr = this.heroTaxReturns.find(t => t.id === heroTaxReturn.id);
+      if (htr) {
+        heroTaxReturn = Object.assign(htr, heroTaxReturn); // demo: mutate
+      } else {
+        this.heroTaxReturns.push(heroTaxReturn);
+      }
+      observer.next(heroTaxReturn);
+      observer.complete();
+    });
+  }
+}

aio/content/examples/hierarchical-dependency-injection/src/app/villains-list.component.html

@@ -0,0 +1,6 @@
+<div>
+  <h3>Villains</h3>
+  <ul>
+    <li *ngFor="let villain of villains | async">{{villain.name}}</li>
+  </ul>
+</div>

aio/content/examples/hierarchical-dependency-injection/src/app/villains-list.component.ts

@@ -0,0 +1,20 @@
+// #docregion
+import { Component }  from '@angular/core';
+import { Observable } from 'rxjs/Observable';
+
+import { Villain, VillainsService } from './villains.service';
+
+// #docregion metadata
+@Component({
+  selector: 'villains-list',
+  templateUrl: './villains-list.component.html',
+  providers: [ VillainsService ]
+})
+// #enddocregion metadata
+export class VillainsListComponent {
+  villains: Observable<Villain[]>;
+
+  constructor(private villainsService: VillainsService) {
+    this.villains = villainsService.getVillains();
+  }
+}

aio/content/examples/hierarchical-dependency-injection/src/app/villains.service.ts

@@ -0,0 +1,17 @@
+import { Injectable } from '@angular/core';
+
+import { of }         from 'rxjs/observable/of';
+
+export interface Villain { id: number; name: string; }
+
+@Injectable()
+export class VillainsService {
+ villains: Villain[] = [
+    { id: 1, name: 'Dr. Evil'},
+    { id: 2, name: 'Moriarty'}
+  ];
+
+  getVillains() {
+    return of(this.villains);
+  }
+}

aio/content/examples/hierarchical-dependency-injection/src/index.html

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Hierarchical Injectors</title>
+    <base href="/">
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link rel="stylesheet" href="styles.css">
+
+    <!-- Polyfills -->
+    <script src="node_modules/core-js/client/shim.min.js"></script>
+
+    <script src="node_modules/zone.js/dist/zone.js"></script>
+    <script src="node_modules/systemjs/dist/system.src.js"></script>
+
+    <script src="systemjs.config.js"></script>
+    <script>
+      System.import('main.js').catch(function(err){ console.error(err); });
+    </script>
+  </head>
+
+  <body>
+    <my-app>loading...</my-app>
+  </body>
+
+</html>

aio/content/examples/hierarchical-dependency-injection/src/main.ts

@@ -0,0 +1,5 @@
+// #docregion
+import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
+import { AppModule } from './app/app.module';
+
+platformBrowserDynamic().bootstrapModule(AppModule);