refactor(core): change module semantics
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.
This commit is contained in:
Tobias Bosch
176
tools/public_api_guard/core/index.d.ts
vendored
176
tools/public_api_guard/core/index.d.ts
vendored
@ -124,11 +124,15 @@ export declare const APP_ID: any;
|
||||
/** @experimental */
|
||||
export declare const APP_INITIALIZER: any;
|
||||
|
||||
/** @stable */
|
||||
/** @deprecated */
|
||||
export declare const APPLICATION_COMMON_PROVIDERS: Array<Type | {
|
||||
[k: string]: any;
|
||||
} | any[]>;
|
||||
|
||||
/** @experimental */
|
||||
export declare class ApplicationModule {
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare abstract class ApplicationRef {
|
||||
componentTypes: Type[];
|
||||
@ -143,68 +147,6 @@ export declare abstract class ApplicationRef {
|
||||
abstract waitForAsyncInitializers(): Promise<any>;
|
||||
}
|
||||
|
||||
/** @stable */
|
||||
export declare var AppModule: AppModuleMetadataFactory;
|
||||
|
||||
/** @stable */
|
||||
export interface AppModuleDecorator extends TypeDecorator {
|
||||
}
|
||||
|
||||
/** @stable */
|
||||
export declare class AppModuleFactory<T> {
|
||||
moduleType: ConcreteType<T>;
|
||||
constructor(_injectorClass: {
|
||||
new (parentInjector: Injector): AppModuleInjector<T>;
|
||||
}, _moduleype: ConcreteType<T>);
|
||||
create(parentInjector?: Injector): AppModuleRef<T>;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare abstract class AppModuleFactoryLoader {
|
||||
abstract load(path: string): Promise<AppModuleFactory<any>>;
|
||||
}
|
||||
|
||||
/** @stable */
|
||||
export declare class AppModuleMetadata extends InjectableMetadata {
|
||||
directives: Array<Type | any[]>;
|
||||
modules: Array<Type | any[]>;
|
||||
pipes: Array<Type | any[]>;
|
||||
precompile: Array<Type | any[]>;
|
||||
providers: any[];
|
||||
constructor({providers, directives, pipes, precompile, modules}?: {
|
||||
providers?: any[];
|
||||
directives?: Array<Type | any[]>;
|
||||
pipes?: Array<Type | any[]>;
|
||||
precompile?: Array<Type | any[]>;
|
||||
modules?: Array<Type | any[]>;
|
||||
});
|
||||
}
|
||||
|
||||
/** @stable */
|
||||
export interface AppModuleMetadataFactory {
|
||||
(obj: {
|
||||
providers?: any[];
|
||||
directives?: Array<Type | any[]>;
|
||||
pipes?: Array<Type | any[]>;
|
||||
precompile?: Array<Type | any[]>;
|
||||
modules?: Array<Type | any[]>;
|
||||
}): AppModuleDecorator;
|
||||
new (obj: {
|
||||
providers?: any[];
|
||||
directives?: Array<Type | any[]>;
|
||||
pipes?: Array<Type | any[]>;
|
||||
precompile?: Array<Type | any[]>;
|
||||
modules?: Array<Type | any[]>;
|
||||
}): AppModuleMetadata;
|
||||
}
|
||||
|
||||
/** @stable */
|
||||
export declare abstract class AppModuleRef<T> {
|
||||
componentFactoryResolver: ComponentFactoryResolver;
|
||||
injector: Injector;
|
||||
instance: T;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare function asNativeElements(debugEls: DebugElement[]): any;
|
||||
|
||||
@ -259,10 +201,10 @@ export declare class Binding extends Provider {
|
||||
}
|
||||
|
||||
/** @stable */
|
||||
export declare function bootstrapModule<M>(moduleType: ConcreteType<M>, platform: PlatformRef, compilerOptions?: CompilerOptions): Promise<AppModuleRef<M>>;
|
||||
export declare function bootstrapModule<M>(moduleType: ConcreteType<M>, platform: PlatformRef, compilerOptions?: CompilerOptions | CompilerOptions[]): Promise<NgModuleRef<M>>;
|
||||
|
||||
/** @experimental */
|
||||
export declare function bootstrapModuleFactory<M>(moduleFactory: AppModuleFactory<M>, platform: PlatformRef): AppModuleRef<M>;
|
||||
export declare function bootstrapModuleFactory<M>(moduleFactory: NgModuleFactory<M>, platform: PlatformRef): NgModuleRef<M>;
|
||||
|
||||
/** @stable */
|
||||
export declare enum ChangeDetectionStrategy {
|
||||
@ -301,30 +243,21 @@ export declare class CollectionChangeRecord {
|
||||
|
||||
/** @stable */
|
||||
export declare class Compiler {
|
||||
injector: Injector;
|
||||
clearCache(): void;
|
||||
clearCacheFor(type: Type): void;
|
||||
compileAppModuleAsync<T>(moduleType: ConcreteType<T>, metadata?: AppModuleMetadata): Promise<AppModuleFactory<T>>;
|
||||
compileAppModuleSync<T>(moduleType: ConcreteType<T>, metadata?: AppModuleMetadata): AppModuleFactory<T>;
|
||||
compileComponentAsync<T>(component: ConcreteType<T>): Promise<ComponentFactory<T>>;
|
||||
compileComponentSync<T>(component: ConcreteType<T>): ComponentFactory<T>;
|
||||
compileComponentAsync<T>(component: ConcreteType<T>, ngModule?: Type): Promise<ComponentFactory<T>>;
|
||||
compileComponentSync<T>(component: ConcreteType<T>, ngModule?: Type): ComponentFactory<T>;
|
||||
compileModuleAsync<T>(moduleType: ConcreteType<T>): Promise<NgModuleFactory<T>>;
|
||||
compileModuleSync<T>(moduleType: ConcreteType<T>): NgModuleFactory<T>;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare abstract class CompilerFactory {
|
||||
abstract createCompiler(options?: CompilerOptions): Compiler;
|
||||
withDefaults(options?: CompilerOptions): CompilerFactory;
|
||||
static mergeOptions(defaultOptions?: CompilerOptions, newOptions?: CompilerOptions): CompilerOptions;
|
||||
abstract createCompiler(options?: CompilerOptions[]): Compiler;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare type CompilerOptions = {
|
||||
useDebug?: boolean;
|
||||
useJit?: boolean;
|
||||
defaultEncapsulation?: ViewEncapsulation;
|
||||
providers?: any[];
|
||||
deprecatedAppProviders?: any[];
|
||||
};
|
||||
export declare const CompilerOptions: OpaqueToken;
|
||||
|
||||
/** @stable */
|
||||
export declare var Component: ComponentMetadataFactory;
|
||||
@ -536,11 +469,14 @@ export declare function coreBootstrap<C>(componentFactory: ComponentFactory<C>,
|
||||
/** @deprecated */
|
||||
export declare function coreLoadAndBootstrap(componentType: Type, injector: Injector): Promise<ComponentRef<any>>;
|
||||
|
||||
/** @experimental */
|
||||
export declare const corePlatform: (extraProviders?: any[]) => PlatformRef;
|
||||
|
||||
/** @experimental */
|
||||
export declare function createPlatform(injector: Injector): PlatformRef;
|
||||
|
||||
/** @experimental */
|
||||
export declare function createPlatformFactory(name: string, providers: any[]): () => PlatformRef;
|
||||
export declare function createPlatformFactory(parentPlaformFactory: PlatformFactory, name: string, providers?: any[]): PlatformFactory;
|
||||
|
||||
/** @stable */
|
||||
export declare class CyclicDependencyError extends AbstractProviderError {
|
||||
@ -927,6 +863,68 @@ export declare class KeyValueDiffers {
|
||||
/** @deprecated */
|
||||
export declare function lockRunMode(): void;
|
||||
|
||||
/** @experimental */
|
||||
export declare var NgModule: NgModuleMetadataFactory;
|
||||
|
||||
/** @stable */
|
||||
export interface NgModuleDecorator extends TypeDecorator {
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare class NgModuleFactory<T> {
|
||||
moduleType: ConcreteType<T>;
|
||||
constructor(_injectorClass: {
|
||||
new (parentInjector: Injector): NgModuleInjector<T>;
|
||||
}, _moduleype: ConcreteType<T>);
|
||||
create(parentInjector: Injector): NgModuleRef<T>;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare abstract class NgModuleFactoryLoader {
|
||||
abstract load(path: string): Promise<NgModuleFactory<any>>;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare class NgModuleMetadata extends InjectableMetadata {
|
||||
declarations: Array<Type | any[]>;
|
||||
exports: Array<Type | any[]>;
|
||||
imports: Array<Type | any[]>;
|
||||
precompile: Array<Type | any[]>;
|
||||
providers: any[];
|
||||
constructor({providers, declarations, imports, exports, precompile}?: {
|
||||
providers?: any[];
|
||||
declarations?: Array<Type | any[]>;
|
||||
imports?: Array<Type | any[]>;
|
||||
exports?: Array<Type | any[]>;
|
||||
precompile?: Array<Type | any[]>;
|
||||
});
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export interface NgModuleMetadataFactory {
|
||||
(obj?: {
|
||||
providers?: any[];
|
||||
declarations?: Array<Type | any[]>;
|
||||
imports?: Array<Type | any[]>;
|
||||
exports?: Array<Type | any[]>;
|
||||
precompile?: Array<Type | any[]>;
|
||||
}): NgModuleDecorator;
|
||||
new (obj?: {
|
||||
providers?: any[];
|
||||
declarations?: Array<Type | any[]>;
|
||||
imports?: Array<Type | any[]>;
|
||||
exports?: Array<Type | any[]>;
|
||||
precompile?: Array<Type | any[]>;
|
||||
}): NgModuleMetadata;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare abstract class NgModuleRef<T> {
|
||||
componentFactoryResolver: ComponentFactoryResolver;
|
||||
injector: Injector;
|
||||
instance: T;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare class NgZone {
|
||||
hasPendingMacrotasks: boolean;
|
||||
@ -1058,8 +1056,8 @@ export interface PipeTransform {
|
||||
transform(value: any, ...args: any[]): any;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare const PLATFORM_COMMON_PROVIDERS: Array<any | Type | Provider | any[]>;
|
||||
/** @deprecated */
|
||||
export declare const PLATFORM_COMMON_PROVIDERS: any[];
|
||||
|
||||
/** @deprecated */
|
||||
export declare const PLATFORM_DIRECTIVES: OpaqueToken;
|
||||
@ -1336,12 +1334,6 @@ export declare function style(tokens: string | {
|
||||
[key: string]: string | number;
|
||||
}>): AnimationStyleMetadata;
|
||||
|
||||
/** @experimental */
|
||||
export declare class SystemJsAppModuleLoader implements AppModuleFactoryLoader {
|
||||
constructor(_compiler: Compiler);
|
||||
load(path: string): Promise<AppModuleFactory<any>>;
|
||||
}
|
||||
|
||||
/** @deprecated */
|
||||
export declare class SystemJsCmpFactoryResolver implements ComponentResolver {
|
||||
constructor(_console: Console);
|
||||
@ -1356,6 +1348,12 @@ export declare class SystemJsComponentResolver implements ComponentResolver {
|
||||
resolveComponent(componentType: string | Type): Promise<ComponentFactory<any>>;
|
||||
}
|
||||
|
||||
/** @experimental */
|
||||
export declare class SystemJsNgModuleLoader implements NgModuleFactoryLoader {
|
||||
constructor(_compiler: Compiler);
|
||||
load(path: string): Promise<NgModuleFactory<any>>;
|
||||
}
|
||||
|
||||
/** @stable */
|
||||
export declare abstract class TemplateRef<C> {
|
||||
elementRef: ElementRef;
|
||||
|
||||
34
tools/public_api_guard/core/testing.d.ts
vendored
34
tools/public_api_guard/core/testing.d.ts
vendored
@ -37,10 +37,9 @@ export declare function configureCompiler(config: {
|
||||
/** @stable */
|
||||
export declare function configureModule(moduleDef: {
|
||||
providers?: any[];
|
||||
directives?: any[];
|
||||
pipes?: any[];
|
||||
declarations?: any[];
|
||||
imports?: any[];
|
||||
precompile?: any[];
|
||||
modules?: any[];
|
||||
}): void;
|
||||
|
||||
/** @experimental */
|
||||
@ -62,7 +61,7 @@ export declare function getTestBed(): TestBed;
|
||||
export declare function getTestInjector(): TestBed;
|
||||
|
||||
/** @experimental */
|
||||
export declare function initTestEnvironment(appModule: Type, platform: PlatformRef): void;
|
||||
export declare function initTestEnvironment(ngModule: Type, platform: PlatformRef): Injector;
|
||||
|
||||
/** @stable */
|
||||
export declare function inject(tokens: any[], fn: Function): () => any;
|
||||
@ -71,10 +70,9 @@ export declare function inject(tokens: any[], fn: Function): () => any;
|
||||
export declare class InjectSetupWrapper {
|
||||
constructor(_moduleDef: () => {
|
||||
providers?: any[];
|
||||
directives?: any[];
|
||||
pipes?: any[];
|
||||
declarations?: any[];
|
||||
imports?: any[];
|
||||
precompile?: any[];
|
||||
modules?: any[];
|
||||
});
|
||||
inject(tokens: any[], fn: Function): () => any;
|
||||
}
|
||||
@ -90,7 +88,7 @@ export declare function setBaseTestProviders(platformProviders: Array<Type | Pro
|
||||
|
||||
/** @experimental */
|
||||
export declare class TestBed implements Injector {
|
||||
appModule: Type;
|
||||
ngModule: Type;
|
||||
platform: PlatformRef;
|
||||
configureCompiler(config: {
|
||||
providers?: any[];
|
||||
@ -98,15 +96,14 @@ export declare class TestBed implements Injector {
|
||||
}): void;
|
||||
configureModule(moduleDef: {
|
||||
providers?: any[];
|
||||
directives?: any[];
|
||||
pipes?: any[];
|
||||
declarations?: any[];
|
||||
imports?: any[];
|
||||
precompile?: any[];
|
||||
modules?: any[];
|
||||
}): void;
|
||||
createAppModuleFactory(): Promise<AppModuleFactory<any>>;
|
||||
createModuleFactory(): Promise<NgModuleFactory<any>>;
|
||||
execute(tokens: any[], fn: Function): any;
|
||||
get(token: any, notFoundValue?: any): any;
|
||||
initTestAppModule(): void;
|
||||
initTestModule(): void;
|
||||
reset(): void;
|
||||
}
|
||||
|
||||
@ -114,10 +111,10 @@ export declare class TestBed implements Injector {
|
||||
export declare class TestComponentBuilder {
|
||||
protected _injector: Injector;
|
||||
constructor(_injector: Injector);
|
||||
createAsync<T>(rootComponentType: ConcreteType<T>): Promise<ComponentFixture<T>>;
|
||||
createFakeAsync<T>(rootComponentType: ConcreteType<T>): ComponentFixture<T>;
|
||||
createAsync<T>(rootComponentType: ConcreteType<T>, ngModule?: ConcreteType<any>): Promise<ComponentFixture<T>>;
|
||||
createFakeAsync<T>(rootComponentType: ConcreteType<T>, ngModule?: ConcreteType<any>): ComponentFixture<T>;
|
||||
protected createFromFactory<C>(ngZone: NgZone, componentFactory: ComponentFactory<C>): ComponentFixture<C>;
|
||||
createSync<T>(rootComponentType: ConcreteType<T>): ComponentFixture<T>;
|
||||
createSync<T>(rootComponentType: ConcreteType<T>, ngModule?: ConcreteType<any>): ComponentFixture<T>;
|
||||
overrideAnimations(componentType: Type, animations: AnimationEntryMetadata[]): TestComponentBuilder;
|
||||
overrideDirective(componentType: Type, from: Type, to: Type): TestComponentBuilder;
|
||||
overrideProviders(type: Type, providers: any[]): TestComponentBuilder;
|
||||
@ -137,10 +134,9 @@ export declare function tick(millis?: number): void;
|
||||
/** @experimental */
|
||||
export declare function withModule(moduleDef: () => {
|
||||
providers?: any[];
|
||||
directives?: any[];
|
||||
pipes?: any[];
|
||||
declarations?: any[];
|
||||
imports?: any[];
|
||||
precompile?: any[];
|
||||
modules?: any[];
|
||||
}): InjectSetupWrapper;
|
||||
|
||||
/** @experimental */
|
||||
|
||||
Reference in New Issue
Block a user