From 5d294624fae38b0366c0847a8870dbcc60a7be28 Mon Sep 17 00:00:00 2001 From: Igor Minar Date: Tue, 23 Aug 2016 22:29:34 -0700 Subject: [PATCH] docs(core): update stability markers for core apis --- modules/@angular/core/src/application_ref.ts | 6 ++-- .../core/src/linker/ng_module_factory.ts | 2 +- .../src/linker/ng_module_factory_loader.ts | 2 +- modules/@angular/core/src/metadata.ts | 4 +-- .../@angular/core/src/metadata/directives.ts | 6 ++-- .../@angular/core/src/metadata/ng_module.ts | 8 +++--- tools/public_api_guard/core/index.d.ts | 28 +++++++++---------- 7 files changed, 28 insertions(+), 28 deletions(-) diff --git a/modules/@angular/core/src/application_ref.ts b/modules/@angular/core/src/application_ref.ts index b60325ae14..9e822d3ad1 100644 --- a/modules/@angular/core/src/application_ref.ts +++ b/modules/@angular/core/src/application_ref.ts @@ -36,7 +36,7 @@ var _platform: PlatformRef; * does not result in additional changes to any bindings (also known as * unidirectional data flow). * - * @experimental APIs related to application bootstrap are currently under review. + * @stable */ export function enableProdMode(): void { if (_runModeLocked) { @@ -151,7 +151,7 @@ export function getPlatform(): PlatformRef { * A page's platform is initialized implicitly when {@link bootstrap}() is called, or * explicitly by calling {@link createPlatform}(). * - * @experimental APIs related to application bootstrap are currently under review. + * @stable */ export abstract class PlatformRef { /** @@ -344,7 +344,7 @@ export class PlatformRef_ extends PlatformRef { * * For more about Angular applications, see the documentation for {@link bootstrap}. * - * @experimental APIs related to application bootstrap are currently under review. + * @stable */ export abstract class ApplicationRef { /** diff --git a/modules/@angular/core/src/linker/ng_module_factory.ts b/modules/@angular/core/src/linker/ng_module_factory.ts index b6869734d1..575fb63faa 100644 --- a/modules/@angular/core/src/linker/ng_module_factory.ts +++ b/modules/@angular/core/src/linker/ng_module_factory.ts @@ -21,7 +21,7 @@ import {CodegenComponentFactoryResolver, ComponentFactoryResolver} from './compo * `NgModuleRef` provides access to the NgModule Instance as well other objects related to this * NgModule Instance. * - * @experimental + * @stable */ export abstract class NgModuleRef { /** diff --git a/modules/@angular/core/src/linker/ng_module_factory_loader.ts b/modules/@angular/core/src/linker/ng_module_factory_loader.ts index f8c66b0eb6..4f576725c7 100644 --- a/modules/@angular/core/src/linker/ng_module_factory_loader.ts +++ b/modules/@angular/core/src/linker/ng_module_factory_loader.ts @@ -10,7 +10,7 @@ import {NgModuleFactory} from './ng_module_factory'; /** * Used to load ng module factories. - * @experimental + * @stable */ export abstract class NgModuleFactoryLoader { abstract load(path: string): Promise>; diff --git a/modules/@angular/core/src/metadata.ts b/modules/@angular/core/src/metadata.ts index 43dc88b449..29d2256d4b 100644 --- a/modules/@angular/core/src/metadata.ts +++ b/modules/@angular/core/src/metadata.ts @@ -267,7 +267,7 @@ export interface HostListenerMetadataFactory { /** * {@link NgModuleMetadata} factory for creating annotations, decorators or DSL. * - * @experimental + * @stable */ export interface NgModuleMetadataFactory { (obj?: NgModuleMetadataType): NgModuleDecorator; @@ -1109,7 +1109,7 @@ export var HostListener: HostListenerMetadataFactory = makePropDecorator(HostLis /** * Declares an ng module. - * @experimental + * @stable * @Annotation */ export var NgModule: NgModuleMetadataFactory = diff --git a/modules/@angular/core/src/metadata/directives.ts b/modules/@angular/core/src/metadata/directives.ts index c317a3fcdc..708eb8049a 100644 --- a/modules/@angular/core/src/metadata/directives.ts +++ b/modules/@angular/core/src/metadata/directives.ts @@ -15,7 +15,7 @@ import {ViewEncapsulation} from './view'; /** * Interface for creating {@link DirectiveMetadata} - * @experimental + * @stable */ export interface DirectiveMetadataType { selector?: string; @@ -744,7 +744,7 @@ export class DirectiveMetadata extends InjectableMetadata implements DirectiveMe /** * Interface for creating {@link ComponentMetadataType} - * @experimental + * @stable */ export interface ComponentMetadataType extends DirectiveMetadataType { changeDetection?: ChangeDetectionStrategy; @@ -1009,7 +1009,7 @@ export class ComponentMetadata extends DirectiveMetadata implements ComponentMet /** * Interface for creating {@link PipeMetadata} - * @experimental + * @stable */ export interface PipeMetadataType { name: string; diff --git a/modules/@angular/core/src/metadata/ng_module.ts b/modules/@angular/core/src/metadata/ng_module.ts index fbf163b5fa..e1f55259b7 100644 --- a/modules/@angular/core/src/metadata/ng_module.ts +++ b/modules/@angular/core/src/metadata/ng_module.ts @@ -12,7 +12,7 @@ import {Type} from '../type'; /** * A wrapper around a module that also includes the providers. * - * @experimental + * @stable */ export interface ModuleWithProviders { ngModule: Type; @@ -30,7 +30,7 @@ export interface SchemaMetadata { name: string; } * Defines a schema that will allow any property on elements with a `-` in their name, * which is the common rule for custom elements. * - * @experimental + * @stable */ export const CUSTOM_ELEMENTS_SCHEMA: SchemaMetadata = { name: 'custom-elements' @@ -47,7 +47,7 @@ export const NO_ERRORS_SCHEMA: SchemaMetadata = { /** * Interface for creating {@link NgModuleMetadata} - * @experimental + * @stable */ export interface NgModuleMetadataType { providers?: any[]; @@ -61,7 +61,7 @@ export interface NgModuleMetadataType { /** * Declares an Angular Module. - * @experimental + * @stable */ export class NgModuleMetadata extends InjectableMetadata implements NgModuleMetadataType { /** diff --git a/tools/public_api_guard/core/index.d.ts b/tools/public_api_guard/core/index.d.ts index 63880f3848..8905c946a9 100644 --- a/tools/public_api_guard/core/index.d.ts +++ b/tools/public_api_guard/core/index.d.ts @@ -151,7 +151,7 @@ export declare class ApplicationInitStatus { export declare class ApplicationModule { } -/** @experimental */ +/** @stable */ export declare abstract class ApplicationRef { componentTypes: Type[]; components: ComponentRef[]; @@ -304,7 +304,7 @@ export interface ComponentMetadataFactory { new (obj: ComponentMetadataType): ComponentMetadata; } -/** @experimental */ +/** @stable */ export interface ComponentMetadataType extends DirectiveMetadataType { animations?: AnimationEntryMetadata[]; changeDetection?: ChangeDetectionStrategy; @@ -386,7 +386,7 @@ export declare function createPlatform(injector: Injector): PlatformRef; /** @experimental */ export declare function createPlatformFactory(parentPlaformFactory: PlatformFactory, name: string, providers?: any[]): PlatformFactory; -/** @experimental */ +/** @stable */ export declare const CUSTOM_ELEMENTS_SCHEMA: SchemaMetadata; /** @stable */ @@ -489,7 +489,7 @@ export interface DirectiveMetadataFactory { new (obj: DirectiveMetadataType): DirectiveMetadata; } -/** @experimental */ +/** @stable */ export interface DirectiveMetadataType { exportAs?: string; host?: { @@ -522,7 +522,7 @@ export declare abstract class EmbeddedViewRef extends ViewRef { abstract destroy(): void; } -/** @experimental */ +/** @stable */ export declare function enableProdMode(): void; /** @stable */ @@ -762,13 +762,13 @@ export declare class ModuleWithComponentFactories { constructor(ngModuleFactory: NgModuleFactory, componentFactories: ComponentFactory[]); } -/** @experimental */ +/** @stable */ export interface ModuleWithProviders { ngModule: Type; providers?: any[]; } -/** @experimental */ +/** @stable */ export declare var NgModule: NgModuleMetadataFactory; /** @stable */ @@ -784,12 +784,12 @@ export declare class NgModuleFactory { create(parentInjector: Injector): NgModuleRef; } -/** @experimental */ +/** @stable */ export declare abstract class NgModuleFactoryLoader { abstract load(path: string): Promise>; } -/** @experimental */ +/** @stable */ export declare class NgModuleMetadata extends InjectableMetadata implements NgModuleMetadataType { bootstrap: Array | any[]>; declarations: Array | any[]>; @@ -801,13 +801,13 @@ export declare class NgModuleMetadata extends InjectableMetadata implements NgMo constructor(options?: NgModuleMetadataType); } -/** @experimental */ +/** @stable */ export interface NgModuleMetadataFactory { (obj?: NgModuleMetadataType): NgModuleDecorator; new (obj?: NgModuleMetadataType): NgModuleMetadata; } -/** @experimental */ +/** @stable */ export interface NgModuleMetadataType { bootstrap?: Array | any[]>; declarations?: Array | any[]>; @@ -818,7 +818,7 @@ export interface NgModuleMetadataType { schemas?: Array; } -/** @experimental */ +/** @stable */ export declare abstract class NgModuleRef { componentFactoryResolver: ComponentFactoryResolver; injector: Injector; @@ -940,7 +940,7 @@ export interface PipeMetadataFactory { new (obj: PipeMetadataType): any; } -/** @experimental */ +/** @stable */ export interface PipeMetadataType { name: string; pure?: boolean; @@ -957,7 +957,7 @@ export declare const PLATFORM_INITIALIZER: any; /** @experimental */ export declare const platformCore: (extraProviders?: any[]) => PlatformRef; -/** @experimental */ +/** @stable */ export declare abstract class PlatformRef { destroyed: boolean; injector: Injector;