Angular 2 Offline Compiler @shuheikagawa

→ GitHub/Qiita @shuhei → Twitter @shuheikagawa → Software Engineer @ M3, Inc

Angular 2 & Me TypeScript-ish type annotations and decorators in ES2015+ → babel-angular2-app → babel-preset-angular2 → babel-plugin-angular2-annotations

Compiler in JavaScript?

Template -> JS

Angular 1 Runtime compilation was the bottleneck

Angular 2 Compiles only once at the boot time

Can we do better?

Offline Compiler → Faster bootstrap → Smaller lib

Let's try!

$ npm i -D @angular/compiler-cli $ ./node_modules/.bin/ngc -p tsconfig.json

$ ls -l src app.css app.css.shim.ts app.ngfactory.ts app.ts main.ts

main.ts

import { coreBootstrap, ReflectiveInjector } from '@angular/core'; import { browserPlatform, BROWSER_APP_STATIC_PROVIDERS } from '@angular/platform-browser'; import {AppNgFactory} from './app.ngfactory'; const appInjector = ReflectiveInjector.resolveAndCreate( BROWSER_APP_STATIC_PROVIDERS, browserPlatform().injector ); coreBootstrap(appInjector, AppNgFactory);

./node_modules/.bin/tsc -p tsconfig.json

Doesn't Work

→ o compiler_cli/integrationtest → x angular2-seed → x router-deprecated → x router

No content

What's .ngfactory.ts?

app.ts @Component({ selector: 'app', template: 'hello {{name}}' }) class App { name: string = 'ng2'; }

app.ngfactory.ts class _View_App0 extends DebugAppView { createInternal() {} detectsChangeInternal() {} } function viewFactory_App0(...): AppView {} class _View_App_Host0 extends DebugAppView { createInternal() {} } function viewFactory_App_Host0(...): AppView {} export const AppNgFactory: ComponentFactory = new ComponentFactory('app', viewFactory_App_Host0, App);

createInternal

createInternal(rootSelector: string): AppElement { var parentRenderNode =this.renderer .createViewRoot(this.declarationAppElement.nativeElement); this._text_0 = this.renderer .createText(parentRenderNode,'',this.debug(0,0,0)); this._expr_0 = import3.uninitialized; this.init([],[this._text_0],[],[]); return null; }

createInternal → create elements, texts and directives → set up listeners → set up subscriptions → call child views

detectChangesInternal

detectChangesInternal(throwOnChange: boolean): void { this.detectContentChildrenChanges(throwOnChange); this.debug(0,0,0); var currVal_0: any = import4.interpolate(1,'Hello World ',this.context.user,''); if (import4.checkBinding(throwOnChange,this._expr_0,currVal_0)) { this.renderer.setText(this._text_0,currVal_0); this._expr_0 = currVal_0; } this.detectViewChildrenChanges(throwOnChange); }

detectChangesInternal → detect changes → update DOMs → call child views

Benefits → Shorter bootstrap time → JS size: compiler and platform-browser-dynamic vs *.ngfactory.ts → Type-check your templates!

Notes → Don't check in generated files → TypeScript 1.8: generate in src → TypeScript 1.9: use rootDirs → Expect a build system plugin instead of the CLI

Stay tuned!

fin