46b212706b
This contains major changes to the compiler, bootstrap of the platforms and test environment initialization. Main part of #10043 Closes #10164 BREAKING CHANGE: - Semantics and name of `@AppModule` (now `@NgModule`) changed quite a bit. This is actually not breaking as `@AppModules` were not part of rc.4. We will have detailed docs on `@NgModule` separately. - `coreLoadAndBootstrap` and `coreBootstrap` can't be used any more (without migration support). Use `bootstrapModule` / `bootstrapModuleFactory` instead. - All Components listed in routes have to be part of the `declarations` of an NgModule. Either directly on the bootstrap module / lazy loaded module, or in an NgModule imported by them.
120 lines
3.6 KiB
TypeScript
120 lines
3.6 KiB
TypeScript
/**
|
|
* @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 {Injector, OpaqueToken} from '../di';
|
|
import {BaseException} from '../facade/exceptions';
|
|
import {ConcreteType, Type, stringify} from '../facade/lang';
|
|
import {ViewEncapsulation} from '../metadata';
|
|
import {NgModuleMetadata} from '../metadata/ng_module';
|
|
|
|
import {ComponentFactory} from './component_factory';
|
|
import {ComponentResolver} from './component_resolver';
|
|
import {NgModuleFactory} from './ng_module_factory';
|
|
|
|
|
|
/**
|
|
* Indicates that a component is still being loaded in a synchronous compile.
|
|
*
|
|
* @stable
|
|
*/
|
|
export class ComponentStillLoadingError extends BaseException {
|
|
constructor(public compType: Type) {
|
|
super(`Can't compile synchronously as ${stringify(compType)} is still being loaded!`);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Low-level service for running the angular compiler duirng runtime
|
|
* to create {@link ComponentFactory}s, which
|
|
* can later be used to create and render a Component instance.
|
|
*
|
|
* Each `@NgModule` provides an own `Compiler` to its injector,
|
|
* that will use the directives/pipes of the ng module for compilation
|
|
* of components.
|
|
* @stable
|
|
*/
|
|
export class Compiler {
|
|
/**
|
|
* Returns the injector with which the compiler has been created.
|
|
*
|
|
* @internal
|
|
*/
|
|
get injector(): Injector {
|
|
throw new BaseException(`Runtime compiler is not loaded. Tried to read the injector.`);
|
|
}
|
|
|
|
/**
|
|
* Loads the template and styles of a component and returns the associated `ComponentFactory`.
|
|
*/
|
|
compileComponentAsync<T>(component: ConcreteType<T>, ngModule: Type = null):
|
|
Promise<ComponentFactory<T>> {
|
|
throw new BaseException(
|
|
`Runtime compiler is not loaded. Tried to compile ${stringify(component)}`);
|
|
}
|
|
/**
|
|
* Compiles the given component. All templates have to be either inline or compiled via
|
|
* `compileComponentAsync` before. Otherwise throws a {@link ComponentStillLoadingError}.
|
|
*/
|
|
compileComponentSync<T>(component: ConcreteType<T>, ngModule: Type = null): ComponentFactory<T> {
|
|
throw new BaseException(
|
|
`Runtime compiler is not loaded. Tried to compile ${stringify(component)}`);
|
|
}
|
|
/**
|
|
* Compiles the given NgModule. All templates of the components listed in `precompile`
|
|
* have to be either inline or compiled before via `compileComponentAsync` /
|
|
* `compileModuleAsync`. Otherwise throws a {@link ComponentStillLoadingError}.
|
|
*/
|
|
compileModuleSync<T>(moduleType: ConcreteType<T>): NgModuleFactory<T> {
|
|
throw new BaseException(
|
|
`Runtime compiler is not loaded. Tried to compile ${stringify(moduleType)}`);
|
|
}
|
|
|
|
compileModuleAsync<T>(moduleType: ConcreteType<T>): Promise<NgModuleFactory<T>> {
|
|
throw new BaseException(
|
|
`Runtime compiler is not loaded. Tried to compile ${stringify(moduleType)}`);
|
|
}
|
|
|
|
/**
|
|
* Clears all caches
|
|
*/
|
|
clearCache(): void {}
|
|
|
|
/**
|
|
* Clears the cache for the given component/ngModule.
|
|
*/
|
|
clearCacheFor(type: Type) {}
|
|
}
|
|
|
|
/**
|
|
* Options for creating a compiler
|
|
*
|
|
* @experimental
|
|
*/
|
|
export type CompilerOptions = {
|
|
useDebug?: boolean,
|
|
useJit?: boolean,
|
|
defaultEncapsulation?: ViewEncapsulation,
|
|
providers?: any[],
|
|
};
|
|
|
|
/**
|
|
* Token to provide CompilerOptions in the platform injector.
|
|
*
|
|
* @experimental
|
|
*/
|
|
export const CompilerOptions = new OpaqueToken('compilerOptions');
|
|
|
|
/**
|
|
* A factory for creating a Compiler
|
|
*
|
|
* @experimental
|
|
*/
|
|
export abstract class CompilerFactory {
|
|
abstract createCompiler(options?: CompilerOptions[]): Compiler;
|
|
}
|