/** * @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} from '../di'; import {BaseException} from '../facade/exceptions'; import {ConcreteType, Type, stringify} from '../facade/lang'; import {ViewEncapsulation} from '../metadata'; import {AppModuleMetadata} from '../metadata/app_module'; import {AppModuleFactory} from './app_module_factory'; import {ComponentFactory} from './component_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 `@AppModule` provides an own `Compiler` to its injector, * that will use the directives/pipes of the app module for compilation * of components. * @stable */ export class Compiler { /** * Returns the injector with which the compiler has been created. */ 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(component: ConcreteType): Promise> { 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(component: ConcreteType): ComponentFactory { throw new BaseException( `Runtime compiler is not loaded. Tried to compile ${stringify(component)}`); } /** * Compiles the given App Module. All templates of the components listed in `precompile` * have to be either inline or compiled before via `compileComponentAsync` / * `compileAppModuleAsync`. Otherwise throws a {@link ComponentStillLoadingError}. */ compileAppModuleSync(moduleType: ConcreteType, metadata: AppModuleMetadata = null): AppModuleFactory { throw new BaseException( `Runtime compiler is not loaded. Tried to compile ${stringify(moduleType)}`); } compileAppModuleAsync(moduleType: ConcreteType, metadata: AppModuleMetadata = null): Promise> { 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/appModule. */ clearCacheFor(type: Type) {} } /** * Options for creating a compiler * * @experimental */ export type CompilerOptions = { useDebug?: boolean, useJit?: boolean, defaultEncapsulation?: ViewEncapsulation, providers?: any[], deprecatedAppProviders?: any[] } /** * A factory for creating a Compiler * * @experimental */ export abstract class CompilerFactory { static mergeOptions(defaultOptions: CompilerOptions = {}, newOptions: CompilerOptions = {}): CompilerOptions { return { useDebug: _firstDefined(newOptions.useDebug, defaultOptions.useDebug), useJit: _firstDefined(newOptions.useJit, defaultOptions.useJit), defaultEncapsulation: _firstDefined(newOptions.defaultEncapsulation, defaultOptions.defaultEncapsulation), providers: _mergeArrays(defaultOptions.providers, newOptions.providers), deprecatedAppProviders: _mergeArrays(defaultOptions.deprecatedAppProviders, newOptions.deprecatedAppProviders) }; } withDefaults(options: CompilerOptions = {}): CompilerFactory { return new _DefaultApplyingCompilerFactory(this, options); } abstract createCompiler(options?: CompilerOptions): Compiler; } class _DefaultApplyingCompilerFactory extends CompilerFactory { constructor(private _delegate: CompilerFactory, private _options: CompilerOptions) { super(); } createCompiler(options: CompilerOptions = {}): Compiler { return this._delegate.createCompiler(CompilerFactory.mergeOptions(this._options, options)); } } function _firstDefined(...args: T[]): T { for (var i = 0; i < args.length; i++) { if (args[i] !== undefined) { return args[i]; } } return undefined; } function _mergeArrays(...parts: any[][]): any[] { let result: any[] = []; parts.forEach((part) => result.push.apply(result, part)); return result; }