feat(core): introduce @AppModule

Main part for #9726
Closes #9730

modules/@angular/compiler/test/runtime_compiler_spec.ts

@@ -1,5 +1,5 @@
 import {beforeEach, ddescribe, xdescribe, describe, expect, iit, inject, beforeEachProviders, it, xit,} from '@angular/core/testing/testing_internal';
-import {Injectable, Component, Input, ViewMetadata, Compiler, ComponentFactory, Injector} from '@angular/core';
+import {Injectable, Component, Input, ViewMetadata, Compiler, ComponentFactory, Injector, AppModule, AppModuleMetadata, AppModuleFactory} from '@angular/core';
 import {ConcreteType, stringify} from '../src/facade/lang';
 import {fakeAsync, tick, TestComponentBuilder, ComponentFixture} from '@angular/core/testing';
 import {XHR, ViewResolver} from '@angular/compiler';
@@ -19,6 +19,10 @@ class SomeComp {
 class SomeCompWithUrlTemplate {
 }
 
+@AppModule({})
+class SomeModule {
+}
+
 export function main() {
   describe('RuntimeCompiler', () => {
     let compiler: Compiler;
@@ -104,5 +108,51 @@ export function main() {
            expect(compFixture.nativeElement).toHaveText('hello');
          }));
     });
+
+    describe('compileAppModuleAsync', () => {
+      it('should allow to use templateUrl components', fakeAsync(() => {
+           xhr.spy('get').andCallFake(() => Promise.resolve('hello'));
+           let appModuleFactory: AppModuleFactory<any>;
+           compiler
+               .compileAppModuleAsync(
+                   SomeModule, new AppModuleMetadata({precompile: [SomeCompWithUrlTemplate]}))
+               .then((f) => appModuleFactory = f);
+           tick();
+           expect(appModuleFactory.moduleType).toBe(SomeModule);
+         }));
+    });
+
+    describe('compileAppModuleSync', () => {
+      it('should throw when using a templateUrl that has not been compiled before', () => {
+        xhr.spy('get').andCallFake(() => Promise.resolve(''));
+        expect(
+            () => compiler.compileAppModuleSync(
+                SomeModule, new AppModuleMetadata({precompile: [SomeCompWithUrlTemplate]})))
+            .toThrowError(
+                `Can't compile synchronously as ${stringify(SomeCompWithUrlTemplate)} is still being loaded!`);
+      });
+
+      it('should throw when using a templateUrl in a nested component that has not been compiled before',
+         () => {
+           xhr.spy('get').andCallFake(() => Promise.resolve(''));
+           viewResolver.setView(
+               SomeComp, new ViewMetadata({template: '', directives: [ChildComp]}));
+           viewResolver.setView(ChildComp, new ViewMetadata({templateUrl: '/someTpl.html'}));
+           expect(
+               () => compiler.compileAppModuleSync(
+                   SomeModule, new AppModuleMetadata({precompile: [SomeComp]})))
+               .toThrowError(
+                   `Can't compile synchronously as ${stringify(ChildComp)} is still being loaded!`);
+         });
+
+      it('should allow to use templateUrl components that have been loaded before',
+         fakeAsync(() => {
+           xhr.spy('get').andCallFake(() => Promise.resolve('hello'));
+           tcb.createFakeAsync(SomeCompWithUrlTemplate);
+           let appModuleFactory = compiler.compileAppModuleSync(
+               SomeModule, new AppModuleMetadata({precompile: [SomeCompWithUrlTemplate]}));
+           expect(appModuleFactory).toBeTruthy();
+         }));
+    });
   });
 }