diff --git a/packages/animations/src/version.ts b/packages/animations/src/version.ts index 929a53ed3e..7b731c0956 100644 --- a/packages/animations/src/version.ts +++ b/packages/animations/src/version.ts @@ -15,7 +15,7 @@ /** * @whatItDoes Represents the version of angular/animations * - * @stable + * */ export class Version { public readonly major: string; @@ -31,6 +31,6 @@ export class Version { } /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/common/http/src/backend.ts b/packages/common/http/src/backend.ts index aeed25d2e7..1c0c84cf5f 100644 --- a/packages/common/http/src/backend.ts +++ b/packages/common/http/src/backend.ts @@ -20,7 +20,7 @@ import {HttpEvent} from './response'; * * In an `HttpInterceptor`, the `HttpHandler` parameter is the next interceptor in the chain. * - * @stable + * */ export abstract class HttpHandler { abstract handle(req: HttpRequest): Observable>; @@ -34,7 +34,7 @@ export abstract class HttpHandler { * When injected, `HttpBackend` dispatches requests directly to the backend, without going * through the interceptor chain. * - * @stable + * */ export abstract class HttpBackend implements HttpHandler { abstract handle(req: HttpRequest): Observable>; diff --git a/packages/common/http/src/client.ts b/packages/common/http/src/client.ts index 59f27e938b..9a6e79da69 100644 --- a/packages/common/http/src/client.ts +++ b/packages/common/http/src/client.ts @@ -43,7 +43,7 @@ function addBody( } /** - * @stable + * */ export type HttpObserve = 'body' | 'events' | 'response'; @@ -54,7 +54,7 @@ export type HttpObserve = 'body' | 'events' | 'response'; * Each request method has multiple signatures, and the return type varies according to which * signature is called (mainly the values of `observe` and `responseType`). * - * @stable + * */ @Injectable() export class HttpClient { diff --git a/packages/common/http/src/headers.ts b/packages/common/http/src/headers.ts index 50091fe8bb..d6c5203510 100755 --- a/packages/common/http/src/headers.ts +++ b/packages/common/http/src/headers.ts @@ -14,7 +14,7 @@ interface Update { /** * Immutable set of Http headers, with lazy parsing. - * @stable + * */ export class HttpHeaders { /** diff --git a/packages/common/http/src/interceptor.ts b/packages/common/http/src/interceptor.ts index d4ae53245f..cb1f8990fc 100644 --- a/packages/common/http/src/interceptor.ts +++ b/packages/common/http/src/interceptor.ts @@ -22,7 +22,7 @@ import {HttpEvent} from './response'; * In rare cases, interceptors may wish to completely handle a request themselves, * and not delegate to the remainder of the chain. This behavior is allowed. * - * @stable + * */ export interface HttpInterceptor { /** @@ -47,7 +47,7 @@ export interface HttpInterceptor { /** * `HttpHandler` which applies an `HttpInterceptor` to an `HttpRequest`. * - * @stable + * */ export class HttpInterceptorHandler implements HttpHandler { constructor(private next: HttpHandler, private interceptor: HttpInterceptor) {} @@ -61,7 +61,7 @@ export class HttpInterceptorHandler implements HttpHandler { * A multi-provider token which represents the array of `HttpInterceptor`s that * are registered. * - * @stable + * */ export const HTTP_INTERCEPTORS = new InjectionToken('HTTP_INTERCEPTORS'); diff --git a/packages/common/http/src/jsonp.ts b/packages/common/http/src/jsonp.ts index 12f259d207..b002675047 100644 --- a/packages/common/http/src/jsonp.ts +++ b/packages/common/http/src/jsonp.ts @@ -34,7 +34,7 @@ export const JSONP_ERR_WRONG_RESPONSE_TYPE = 'JSONP requests must use Json respo * * In the browser, this should always be the `window` object. * - * @stable + * */ export abstract class JsonpCallbackContext { [key: string]: (data: any) => void; } @@ -42,7 +42,7 @@ export abstract class JsonpCallbackContext { [key: string]: (data: any) => void; * `HttpBackend` that only processes `HttpRequest` with the JSONP method, * by performing JSONP style requests. * - * @stable + * */ @Injectable() export class JsonpClientBackend implements HttpBackend { @@ -206,7 +206,7 @@ export class JsonpClientBackend implements HttpBackend { * An `HttpInterceptor` which identifies requests with the method JSONP and * shifts them to the `JsonpClientBackend`. * - * @stable + * */ @Injectable() export class JsonpInterceptor { diff --git a/packages/common/http/src/module.ts b/packages/common/http/src/module.ts index effa7581f5..08ebe63e36 100644 --- a/packages/common/http/src/module.ts +++ b/packages/common/http/src/module.ts @@ -48,7 +48,7 @@ export class HttpInterceptingHandler implements HttpHandler { * * Meant to be used as a factory function within `HttpClientModule`. * - * @stable + * */ export function interceptingHandler( backend: HttpBackend, interceptors: HttpInterceptor[] | null = []): HttpHandler { @@ -65,7 +65,7 @@ export function interceptingHandler( * Ordinarily JSONP callbacks are stored on the `window` object, but this may not exist * in test environments. In that case, callbacks are stored on an anonymous object instead. * - * @stable + * */ export function jsonpCallbackContext(): Object { if (typeof window === 'object') { @@ -84,7 +84,7 @@ export function jsonpCallbackContext(): Object { * If no such names are provided, the default is to use `X-XSRF-TOKEN` for * the header name and `XSRF-TOKEN` for the cookie name. * - * @stable + * */ @NgModule({ providers: [ @@ -132,7 +132,7 @@ export class HttpClientXsrfModule { * Interceptors can be added to the chain behind `HttpClient` by binding them * to the multiprovider for `HTTP_INTERCEPTORS`. * - * @stable + * */ @NgModule({ imports: [ @@ -159,7 +159,7 @@ export class HttpClientModule { * Without this module, Jsonp requests will reach the backend * with method JSONP, where they'll be rejected. * - * @stable + * */ @NgModule({ providers: [ diff --git a/packages/common/http/src/params.ts b/packages/common/http/src/params.ts index 170f151fe6..3d93890285 100755 --- a/packages/common/http/src/params.ts +++ b/packages/common/http/src/params.ts @@ -11,7 +11,7 @@ * * Used by `HttpParams`. * - * @stable + * **/ export interface HttpParameterCodec { encodeKey(key: string): string; @@ -25,7 +25,7 @@ export interface HttpParameterCodec { * A `HttpParameterCodec` that uses `encodeURIComponent` and `decodeURIComponent` to * serialize and parse URL parameter keys and values. * - * @stable + * */ export class HttpUrlEncodingCodec implements HttpParameterCodec { encodeKey(k: string): string { return standardEncoding(k); } @@ -94,7 +94,7 @@ export interface HttpParamsOptions { * * This class is immutable - all mutation operations return a new instance. * - * @stable + * */ export class HttpParams { private map: Map|null; diff --git a/packages/common/http/src/request.ts b/packages/common/http/src/request.ts index 7bfc6d23d4..6b920ed7d9 100644 --- a/packages/common/http/src/request.ts +++ b/packages/common/http/src/request.ts @@ -73,7 +73,7 @@ function isFormData(value: any): value is FormData { * assumed to be immutable. To modify a `HttpRequest`, the `clone` * method should be used. * - * @stable + * */ export class HttpRequest { /** diff --git a/packages/common/http/src/response.ts b/packages/common/http/src/response.ts index b30cdc8d0b..bb6d292f3b 100644 --- a/packages/common/http/src/response.ts +++ b/packages/common/http/src/response.ts @@ -11,7 +11,7 @@ import {HttpHeaders} from './headers'; /** * Type enumeration for the different kinds of `HttpEvent`. * - * @stable + * */ export enum HttpEventType { /** @@ -48,7 +48,7 @@ export enum HttpEventType { /** * Base interface for progress events. * - * @stable + * */ export interface HttpProgressEvent { /** @@ -71,7 +71,7 @@ export interface HttpProgressEvent { /** * A download progress event. * - * @stable + * */ export interface HttpDownloadProgressEvent extends HttpProgressEvent { type: HttpEventType.DownloadProgress; @@ -87,7 +87,7 @@ export interface HttpDownloadProgressEvent extends HttpProgressEvent { /** * An upload progress event. * - * @stable + * */ export interface HttpUploadProgressEvent extends HttpProgressEvent { type: HttpEventType.UploadProgress; @@ -98,7 +98,7 @@ export interface HttpUploadProgressEvent extends HttpProgressEvent { * when a request may be retried multiple times, to distinguish between * retries on the final event stream. * - * @stable + * */ export interface HttpSentEvent { type: HttpEventType.Sent; } @@ -108,7 +108,7 @@ export interface HttpSentEvent { type: HttpEventType.Sent; } * Grouping all custom events under this type ensures they will be handled * and forwarded by all implementations of interceptors. * - * @stable + * */ export interface HttpUserEvent { type: HttpEventType.User; } @@ -118,7 +118,7 @@ export interface HttpUserEvent { type: HttpEventType.User; } * * It bundles the Error object with the actual response body that failed to parse. * - * @stable + * */ export interface HttpJsonParseError { error: Error; @@ -130,7 +130,7 @@ export interface HttpJsonParseError { * * Typed according to the expected type of the response. * - * @stable + * */ export type HttpEvent = HttpSentEvent | HttpHeaderResponse | HttpResponse| HttpProgressEvent | HttpUserEvent; @@ -138,7 +138,7 @@ export type HttpEvent = /** * Base class for both `HttpResponse` and `HttpHeaderResponse`. * - * @stable + * */ export abstract class HttpResponseBase { /** @@ -206,7 +206,7 @@ export abstract class HttpResponseBase { * `HttpHeaderResponse` is a `HttpEvent` available on the response * event stream, only when progress events are requested. * - * @stable + * */ export class HttpHeaderResponse extends HttpResponseBase { /** @@ -247,7 +247,7 @@ export class HttpHeaderResponse extends HttpResponseBase { * `HttpResponse` is a `HttpEvent` available on the response event * stream. * - * @stable + * */ export class HttpResponse extends HttpResponseBase { /** @@ -297,7 +297,7 @@ export class HttpResponse extends HttpResponseBase { * will contain either a wrapped Error object or the error response returned * from the server. * - * @stable + * */ export class HttpErrorResponse extends HttpResponseBase implements Error { readonly name = 'HttpErrorResponse'; diff --git a/packages/common/http/src/xhr.ts b/packages/common/http/src/xhr.ts index 51027648c5..c0583c10a7 100644 --- a/packages/common/http/src/xhr.ts +++ b/packages/common/http/src/xhr.ts @@ -33,14 +33,14 @@ function getResponseUrl(xhr: any): string|null { /** * A wrapper around the `XMLHttpRequest` constructor. * - * @stable + * */ export abstract class XhrFactory { abstract build(): XMLHttpRequest; } /** * A factory for @{link HttpXhrBackend} that uses the `XMLHttpRequest` browser API. * - * @stable + * */ @Injectable() export class BrowserXhr implements XhrFactory { @@ -62,7 +62,7 @@ interface PartialResponse { * An `HttpBackend` which uses the XMLHttpRequest API to send * requests to a backend server. * - * @stable + * */ @Injectable() export class HttpXhrBackend implements HttpBackend { diff --git a/packages/common/http/src/xsrf.ts b/packages/common/http/src/xsrf.ts index 75930e6452..98089874ae 100644 --- a/packages/common/http/src/xsrf.ts +++ b/packages/common/http/src/xsrf.ts @@ -21,7 +21,7 @@ export const XSRF_HEADER_NAME = new InjectionToken('XSRF_HEADER_NAME'); /** * Retrieves the current XSRF token to use with the next outgoing request. * - * @stable + * */ export abstract class HttpXsrfTokenExtractor { /** diff --git a/packages/common/http/testing/src/api.ts b/packages/common/http/testing/src/api.ts index d5bce72ea1..c5a4afdb71 100644 --- a/packages/common/http/testing/src/api.ts +++ b/packages/common/http/testing/src/api.ts @@ -13,7 +13,7 @@ import {TestRequest} from './request'; /** * Defines a matcher for requests based on URL, method, or both. * - * @stable + * */ export interface RequestMatch { method?: string; @@ -24,7 +24,7 @@ export interface RequestMatch { * Controller to be injected into tests, that allows for mocking and flushing * of requests. * - * @stable + * */ export abstract class HttpTestingController { /** diff --git a/packages/common/http/testing/src/backend.ts b/packages/common/http/testing/src/backend.ts index 4021e20ab5..d5311fd551 100644 --- a/packages/common/http/testing/src/backend.ts +++ b/packages/common/http/testing/src/backend.ts @@ -23,7 +23,7 @@ import {TestRequest} from './request'; * requests were made and then flush them. In the end, a verify() method asserts * that no unexpected requests were made. * - * @stable + * */ @Injectable() export class HttpClientTestingBackend implements HttpBackend, HttpTestingController { diff --git a/packages/common/http/testing/src/module.ts b/packages/common/http/testing/src/module.ts index 3329b1bf3f..68c8fb0ae0 100644 --- a/packages/common/http/testing/src/module.ts +++ b/packages/common/http/testing/src/module.ts @@ -18,7 +18,7 @@ import {HttpClientTestingBackend} from './backend'; * * Inject `HttpTestingController` to expect and flush requests in your tests. * - * @stable + * */ @NgModule({ imports: [ diff --git a/packages/common/http/testing/src/request.ts b/packages/common/http/testing/src/request.ts index 3dba6ddf3a..37fa3ff9cb 100644 --- a/packages/common/http/testing/src/request.ts +++ b/packages/common/http/testing/src/request.ts @@ -15,7 +15,7 @@ import {Observer} from 'rxjs'; * This interface allows access to the underlying `HttpRequest`, and allows * responding with `HttpEvent`s or `HttpErrorResponse`s. * - * @stable + * */ export class TestRequest { /** diff --git a/packages/common/src/common_module.ts b/packages/common/src/common_module.ts index a5444112c2..07c1557836 100644 --- a/packages/common/src/common_module.ts +++ b/packages/common/src/common_module.ts @@ -18,7 +18,7 @@ import {COMMON_PIPES} from './pipes/index'; /** * The module that includes all the basic Angular directives like {@link NgIf}, {@link NgForOf}, ... * - * @stable + * */ @NgModule({ declarations: [COMMON_DIRECTIVES, COMMON_PIPES], diff --git a/packages/common/src/directives/ng_class.ts b/packages/common/src/directives/ng_class.ts index 8df756eb8f..ef832535ab 100644 --- a/packages/common/src/directives/ng_class.ts +++ b/packages/common/src/directives/ng_class.ts @@ -34,7 +34,7 @@ import {Directive, DoCheck, ElementRef, Input, IterableChanges, IterableDiffer, * - `Object` - keys are CSS classes that get added when the expression given in the value * evaluates to a truthy value, otherwise they are removed. * - * @stable + * */ @Directive({selector: '[ngClass]'}) export class NgClass implements DoCheck { diff --git a/packages/common/src/directives/ng_for_of.ts b/packages/common/src/directives/ng_for_of.ts index 7ea39c9f7a..eddfdde69c 100644 --- a/packages/common/src/directives/ng_for_of.ts +++ b/packages/common/src/directives/ng_for_of.ts @@ -9,7 +9,7 @@ import {ChangeDetectorRef, Directive, DoCheck, EmbeddedViewRef, Input, IterableChangeRecord, IterableChanges, IterableDiffer, IterableDiffers, NgIterable, OnChanges, SimpleChanges, TemplateRef, TrackByFunction, ViewContainerRef, forwardRef, isDevMode} from '@angular/core'; /** - * @stable + * */ export class NgForOfContext { constructor( @@ -93,7 +93,7 @@ export class NgForOfContext { * See a [live demo](http://plnkr.co/edit/KVuXxDp0qinGDyo307QW?p=preview) for a more detailed * example. * - * @stable + * */ @Directive({selector: '[ngFor][ngForOf]'}) export class NgForOf implements DoCheck, OnChanges { diff --git a/packages/common/src/directives/ng_if.ts b/packages/common/src/directives/ng_if.ts index cefb3d0771..053b1b4874 100644 --- a/packages/common/src/directives/ng_if.ts +++ b/packages/common/src/directives/ng_if.ts @@ -96,7 +96,7 @@ import {Directive, EmbeddedViewRef, Input, TemplateRef, ViewContainerRef, ɵstri * ... * ``` * - * @stable + * */ @Directive({selector: '[ngIf]'}) export class NgIf { @@ -159,7 +159,7 @@ export class NgIf { } /** - * @stable + * */ export class NgIfContext { public $implicit: any = null; diff --git a/packages/common/src/directives/ng_style.ts b/packages/common/src/directives/ng_style.ts index 504021f7bc..79e84548e9 100644 --- a/packages/common/src/directives/ng_style.ts +++ b/packages/common/src/directives/ng_style.ts @@ -28,7 +28,7 @@ import {Directive, DoCheck, ElementRef, Input, KeyValueChanges, KeyValueDiffer, * - keys are style names with an optional `.` suffix (ie 'top.px', 'font-style.em'), * - values are the values assigned to those properties (expressed in the given unit). * - * @stable + * */ @Directive({selector: '[ngStyle]'}) export class NgStyle implements DoCheck { diff --git a/packages/common/src/directives/ng_switch.ts b/packages/common/src/directives/ng_switch.ts index 000e0ffbae..cece18504d 100644 --- a/packages/common/src/directives/ng_switch.ts +++ b/packages/common/src/directives/ng_switch.ts @@ -71,7 +71,7 @@ export class SwitchView { * When no matching expression is found on a `ngSwitchCase` view, the `ngSwitchDefault` view is * stamped out. * - * @stable + * */ @Directive({selector: '[ngSwitch]'}) export class NgSwitch { @@ -147,7 +147,7 @@ export class NgSwitch { * * See {@link NgSwitch} for more details and example. * - * @stable + * */ @Directive({selector: '[ngSwitchCase]'}) export class NgSwitchCase implements DoCheck { @@ -186,7 +186,7 @@ export class NgSwitchCase implements DoCheck { * * See {@link NgSwitch} for more details and example. * - * @stable + * */ @Directive({selector: '[ngSwitchDefault]'}) export class NgSwitchDefault { diff --git a/packages/common/src/directives/ng_template_outlet.ts b/packages/common/src/directives/ng_template_outlet.ts index c76668ab14..8cc2cd6dfb 100644 --- a/packages/common/src/directives/ng_template_outlet.ts +++ b/packages/common/src/directives/ng_template_outlet.ts @@ -30,7 +30,7 @@ import {Directive, EmbeddedViewRef, Input, OnChanges, SimpleChange, SimpleChange * * {@example common/ngTemplateOutlet/ts/module.ts region='NgTemplateOutlet'} * - * @stable + * */ @Directive({selector: '[ngTemplateOutlet]'}) export class NgTemplateOutlet implements OnChanges { diff --git a/packages/common/src/dom_tokens.ts b/packages/common/src/dom_tokens.ts index c31db4436f..3952de8f54 100644 --- a/packages/common/src/dom_tokens.ts +++ b/packages/common/src/dom_tokens.ts @@ -14,6 +14,6 @@ import {InjectionToken} from '@angular/core'; * Note: Document might not be available in the Application Context when Application and Rendering * Contexts are not the same (e.g. when running the application into a Web Worker). * - * @stable + * */ export const DOCUMENT = new InjectionToken('DocumentToken'); diff --git a/packages/common/src/i18n/format_date.ts b/packages/common/src/i18n/format_date.ts index 78015bf26f..df8841957c 100644 --- a/packages/common/src/i18n/format_date.ts +++ b/packages/common/src/i18n/format_date.ts @@ -58,7 +58,7 @@ enum TranslationType { * * See {@link DatePipe} for more details. * - * @stable + * */ export function formatDate( value: string | number | Date, format: string, locale: string, timezone?: string): string { diff --git a/packages/common/src/i18n/format_number.ts b/packages/common/src/i18n/format_number.ts index b2c4876141..b528e5f4c3 100644 --- a/packages/common/src/i18n/format_number.ts +++ b/packages/common/src/i18n/format_number.ts @@ -138,7 +138,7 @@ function formatNumberToLocaleString( * as `USD` for the US dollar and `EUR` for the euro. * - `digitInfo` See {@link DecimalPipe} for more details. * - * @stable + * */ export function formatCurrency( value: number, locale: string, currency: string, currencyCode?: string, @@ -168,7 +168,7 @@ export function formatCurrency( * - `locale` is a `string` defining the locale to use. * - `digitInfo` See {@link DecimalPipe} for more details. * - * @stable + * */ export function formatPercent(value: number, locale: string, digitsInfo?: string): string { const format = getLocaleNumberFormat(locale, NumberFormatStyle.Percent); @@ -191,7 +191,7 @@ export function formatPercent(value: number, locale: string, digitsInfo?: string * - `locale` is a `string` defining the locale to use. * - `digitInfo` See {@link DecimalPipe} for more details. * - * @stable + * */ export function formatNumber(value: number, locale: string, digitsInfo?: string): string { const format = getLocaleNumberFormat(locale, NumberFormatStyle.Decimal); diff --git a/packages/common/src/location/hash_location_strategy.ts b/packages/common/src/location/hash_location_strategy.ts index 1fe05f007e..64a1f5733f 100644 --- a/packages/common/src/location/hash_location_strategy.ts +++ b/packages/common/src/location/hash_location_strategy.ts @@ -29,7 +29,7 @@ import {LocationChangeListener, PlatformLocation} from './platform_location'; * * {@example common/location/ts/hash_location_component.ts region='LocationComponent'} * - * @stable + * */ @Injectable() export class HashLocationStrategy extends LocationStrategy { diff --git a/packages/common/src/location/location.ts b/packages/common/src/location/location.ts index ce5a6d0f3e..ec329172b8 100644 --- a/packages/common/src/location/location.ts +++ b/packages/common/src/location/location.ts @@ -40,7 +40,7 @@ export interface PopStateEvent { * * ### Example * {@example common/location/ts/path_location_component.ts region='LocationComponent'} - * @stable + * */ @Injectable() export class Location { diff --git a/packages/common/src/location/location_strategy.ts b/packages/common/src/location/location_strategy.ts index d5b19979b1..8284c20b86 100644 --- a/packages/common/src/location/location_strategy.ts +++ b/packages/common/src/location/location_strategy.ts @@ -25,7 +25,7 @@ import {LocationChangeListener} from './platform_location'; * * See these two classes for more. * - * @stable + * */ export abstract class LocationStrategy { abstract path(includeHash?: boolean): string; @@ -59,6 +59,6 @@ export abstract class LocationStrategy { * class AppModule {} * ``` * - * @stable + * */ export const APP_BASE_HREF = new InjectionToken('appBaseHref'); diff --git a/packages/common/src/location/path_location_strategy.ts b/packages/common/src/location/path_location_strategy.ts index 3854ec8bf0..42161382d6 100644 --- a/packages/common/src/location/path_location_strategy.ts +++ b/packages/common/src/location/path_location_strategy.ts @@ -38,7 +38,7 @@ import {LocationChangeListener, PlatformLocation} from './platform_location'; * * {@example common/location/ts/path_location_component.ts region='LocationComponent'} * - * @stable + * */ @Injectable() export class PathLocationStrategy extends LocationStrategy { diff --git a/packages/common/src/location/platform_location.ts b/packages/common/src/location/platform_location.ts index c222a3a75a..7d1e245698 100644 --- a/packages/common/src/location/platform_location.ts +++ b/packages/common/src/location/platform_location.ts @@ -27,7 +27,7 @@ import {InjectionToken} from '@angular/core'; * {@link Location} / {@link LocationStrategy} and DOM apis flow through the `PlatformLocation` * class they are all platform independent. * - * @stable + * */ export abstract class PlatformLocation { abstract getBaseHrefFromDOM(): string; diff --git a/packages/common/src/pipes/async_pipe.ts b/packages/common/src/pipes/async_pipe.ts index 1167ae7524..9f08ee63cd 100644 --- a/packages/common/src/pipes/async_pipe.ts +++ b/packages/common/src/pipes/async_pipe.ts @@ -64,7 +64,7 @@ const _observableStrategy = new ObservableStrategy(); * * {@example common/pipes/ts/async_pipe.ts region='AsyncPipeObservable'} * - * @stable + * */ @Pipe({name: 'async', pure: false}) export class AsyncPipe implements OnDestroy, PipeTransform { diff --git a/packages/common/src/pipes/case_conversion_pipes.ts b/packages/common/src/pipes/case_conversion_pipes.ts index eba9cfcc7c..9e49183ad0 100644 --- a/packages/common/src/pipes/case_conversion_pipes.ts +++ b/packages/common/src/pipes/case_conversion_pipes.ts @@ -14,7 +14,7 @@ import {invalidPipeArgumentError} from './invalid_pipe_argument_error'; * * {@example common/pipes/ts/lowerupper_pipe.ts region='LowerUpperPipe' } * - * @stable + * */ @Pipe({name: 'lowercase'}) export class LowerCasePipe implements PipeTransform { @@ -49,7 +49,7 @@ const unicodeWordMatch = * ## Example * {@example common/pipes/ts/titlecase_pipe.ts region='TitleCasePipe'} * - * @stable + * */ @Pipe({name: 'titlecase'}) export class TitleCasePipe implements PipeTransform { @@ -67,7 +67,7 @@ export class TitleCasePipe implements PipeTransform { /** * Transforms text to uppercase. * - * @stable + * */ @Pipe({name: 'uppercase'}) export class UpperCasePipe implements PipeTransform { diff --git a/packages/common/src/pipes/date_pipe.ts b/packages/common/src/pipes/date_pipe.ts index 239122eca2..d70a002968 100644 --- a/packages/common/src/pipes/date_pipe.ts +++ b/packages/common/src/pipes/date_pipe.ts @@ -99,7 +99,7 @@ import {invalidPipeArgumentError} from './invalid_pipe_argument_error'; * * {@example common/pipes/ts/date_pipe.ts region='DatePipe'} * - * @stable + * */ // clang-format on @Pipe({name: 'date', pure: true}) diff --git a/packages/common/src/pipes/deprecated/date_pipe.ts b/packages/common/src/pipes/deprecated/date_pipe.ts index d098773632..98db1e3e3d 100644 --- a/packages/common/src/pipes/deprecated/date_pipe.ts +++ b/packages/common/src/pipes/deprecated/date_pipe.ts @@ -71,7 +71,7 @@ import {DateFormatter} from './intl'; * * {@example common/pipes/ts/date_pipe.ts region='DeprecatedDatePipe'} * - * @stable + * */ @Pipe({name: 'date', pure: true}) export class DeprecatedDatePipe implements PipeTransform { diff --git a/packages/common/src/pipes/deprecated/number_pipe.ts b/packages/common/src/pipes/deprecated/number_pipe.ts index fb703ea416..8af1efe6d0 100644 --- a/packages/common/src/pipes/deprecated/number_pipe.ts +++ b/packages/common/src/pipes/deprecated/number_pipe.ts @@ -82,7 +82,7 @@ function formatNumber( * * {@example common/pipes/ts/number_pipe.ts region='DeprecatedNumberPipe'} * - * @stable + * */ @Pipe({name: 'number'}) export class DeprecatedDecimalPipe implements PipeTransform { @@ -110,7 +110,7 @@ export class DeprecatedDecimalPipe implements PipeTransform { * * {@example common/pipes/ts/percent_pipe.ts region='DeprecatedPercentPipe'} * - * @stable + * */ @Pipe({name: 'percent'}) export class DeprecatedPercentPipe implements PipeTransform { @@ -144,7 +144,7 @@ export class DeprecatedPercentPipe implements PipeTransform { * * {@example common/pipes/ts/currency_pipe.ts region='DeprecatedCurrencyPipe'} * - * @stable + * */ @Pipe({name: 'currency'}) export class DeprecatedCurrencyPipe implements PipeTransform { diff --git a/packages/common/src/pipes/json_pipe.ts b/packages/common/src/pipes/json_pipe.ts index f0801164a9..50388a5618 100644 --- a/packages/common/src/pipes/json_pipe.ts +++ b/packages/common/src/pipes/json_pipe.ts @@ -17,7 +17,7 @@ import {Pipe, PipeTransform} from '@angular/core'; * ### Example * {@example common/pipes/ts/json_pipe.ts region='JsonPipe'} * - * @stable + * */ @Pipe({name: 'json', pure: false}) export class JsonPipe implements PipeTransform { diff --git a/packages/common/src/pipes/number_pipe.ts b/packages/common/src/pipes/number_pipe.ts index 2c54e235c1..dcbaf44621 100644 --- a/packages/common/src/pipes/number_pipe.ts +++ b/packages/common/src/pipes/number_pipe.ts @@ -24,7 +24,7 @@ import {invalidPipeArgumentError} from './invalid_pipe_argument_error'; * * {@example common/pipes/ts/number_pipe.ts region='NumberPipe'} * - * @stable + * */ @Pipe({name: 'number'}) export class DecimalPipe implements PipeTransform { @@ -67,7 +67,7 @@ export class DecimalPipe implements PipeTransform { * * {@example common/pipes/ts/percent_pipe.ts region='PercentPipe'} * - * @stable + * */ @Pipe({name: 'percent'}) export class PercentPipe implements PipeTransform { @@ -105,7 +105,7 @@ export class PercentPipe implements PipeTransform { * * {@example common/pipes/ts/currency_pipe.ts region='CurrencyPipe'} * - * @stable + * */ @Pipe({name: 'currency'}) export class CurrencyPipe implements PipeTransform { diff --git a/packages/common/src/pipes/slice_pipe.ts b/packages/common/src/pipes/slice_pipe.ts index af86424e70..af2726382e 100644 --- a/packages/common/src/pipes/slice_pipe.ts +++ b/packages/common/src/pipes/slice_pipe.ts @@ -38,7 +38,7 @@ import {invalidPipeArgumentError} from './invalid_pipe_argument_error'; * * {@example common/pipes/ts/slice_pipe.ts region='SlicePipe_string'} * - * @stable + * */ @Pipe({name: 'slice', pure: false}) diff --git a/packages/common/src/version.ts b/packages/common/src/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/common/src/version.ts +++ b/packages/common/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/common/testing/src/mock_location_strategy.ts b/packages/common/testing/src/mock_location_strategy.ts index 170d888727..6c3c663624 100644 --- a/packages/common/testing/src/mock_location_strategy.ts +++ b/packages/common/testing/src/mock_location_strategy.ts @@ -15,7 +15,7 @@ import {EventEmitter, Injectable} from '@angular/core'; * A mock implementation of {@link LocationStrategy} that allows tests to fire simulated * location events. * - * @stable + * */ @Injectable() export class MockLocationStrategy extends LocationStrategy { diff --git a/packages/compiler-cli/src/version.ts b/packages/compiler-cli/src/version.ts index dd4544fcb4..9d3cd48c2b 100644 --- a/packages/compiler-cli/src/version.ts +++ b/packages/compiler-cli/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/compiler'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/compiler/src/version.ts b/packages/compiler/src/version.ts index e7ed88caf3..565e4676f1 100644 --- a/packages/compiler/src/version.ts +++ b/packages/compiler/src/version.ts @@ -14,6 +14,6 @@ import {Version} from './util'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/core/src/application_ref.ts b/packages/core/src/application_ref.ts index b844c856b7..ce30069931 100644 --- a/packages/core/src/application_ref.ts +++ b/packages/core/src/application_ref.ts @@ -41,7 +41,7 @@ export const ALLOW_MULTIPLE_PLATFORMS = new InjectionToken('AllowMultip * does not result in additional changes to any bindings (also known as * unidirectional data flow). * - * @stable + * */ export function enableProdMode(): void { if (_runModeLocked) { @@ -160,7 +160,7 @@ export function getPlatform(): PlatformRef|null { /** * Provides additional options to the bootstraping process. * - * @stable + * */ export interface BootstrapOptions { /** @@ -181,7 +181,7 @@ export interface BootstrapOptions { * A page's platform is initialized implicitly when a platform is created via a platform factory * (e.g. {@link platformBrowser}), or explicitly by calling the {@link createPlatform} function. * - * @stable + * */ @Injectable() export class PlatformRef { @@ -262,7 +262,7 @@ export class PlatformRef { * * let moduleRef = platformBrowser().bootstrapModule(MyModule); * ``` - * @stable + * */ bootstrapModule( moduleType: Type, compilerOptions: (CompilerOptions&BootstrapOptions)| @@ -359,7 +359,7 @@ function optionsReducer(dst: any, objs: T | T[]): T { /** * A reference to an Angular application running on a page. * - * @stable + * */ @Injectable() export class ApplicationRef { diff --git a/packages/core/src/change_detection/change_detection_util.ts b/packages/core/src/change_detection/change_detection_util.ts index 5384664e4b..c0f179efbb 100644 --- a/packages/core/src/change_detection/change_detection_util.ts +++ b/packages/core/src/change_detection/change_detection_util.ts @@ -41,7 +41,7 @@ export function devModeEqual(a: any, b: any): boolean { * return WrappedValue.wrap(this._latestValue); // this will force update * } * ``` - * @stable + * */ export class WrappedValue { /** @deprecated from 5.3, use `unwrap()` instead - will switch to protected */ @@ -64,7 +64,7 @@ export class WrappedValue { /** * Represents a basic change from a previous to a new value. - * @stable + * */ export class SimpleChange { constructor(public previousValue: any, public currentValue: any, public firstChange: boolean) {} diff --git a/packages/core/src/change_detection/change_detector_ref.ts b/packages/core/src/change_detection/change_detector_ref.ts index dcf25fc3b5..b0e647ab4d 100644 --- a/packages/core/src/change_detection/change_detector_ref.ts +++ b/packages/core/src/change_detection/change_detector_ref.ts @@ -7,7 +7,7 @@ */ /** - * @stable + * */ export abstract class ChangeDetectorRef { /** diff --git a/packages/core/src/change_detection/constants.ts b/packages/core/src/change_detection/constants.ts index 093b7bfd2c..6add5fc6b2 100644 --- a/packages/core/src/change_detection/constants.ts +++ b/packages/core/src/change_detection/constants.ts @@ -10,7 +10,7 @@ /** * Describes within the change detector which strategy will be used the next time change * detection is triggered. - * @stable + * */ export enum ChangeDetectionStrategy { /** diff --git a/packages/core/src/change_detection/differs/default_iterable_differ.ts b/packages/core/src/change_detection/differs/default_iterable_differ.ts index dc2c08ec18..597cadce4c 100644 --- a/packages/core/src/change_detection/differs/default_iterable_differ.ts +++ b/packages/core/src/change_detection/differs/default_iterable_differ.ts @@ -558,7 +558,7 @@ export class DefaultIterableDiffer implements IterableDiffer, IterableChan } /** - * @stable + * */ export class IterableChangeRecord_ implements IterableChangeRecord { currentIndex: number|null = null; diff --git a/packages/core/src/change_detection/differs/default_keyvalue_differ.ts b/packages/core/src/change_detection/differs/default_keyvalue_differ.ts index 66731a5aa2..b3745d428c 100644 --- a/packages/core/src/change_detection/differs/default_keyvalue_differ.ts +++ b/packages/core/src/change_detection/differs/default_keyvalue_differ.ts @@ -261,7 +261,7 @@ export class DefaultKeyValueDiffer implements KeyValueDiffer, KeyVal /** - * @stable + * */ class KeyValueChangeRecord_ implements KeyValueChangeRecord { previousValue: V|null = null; diff --git a/packages/core/src/change_detection/differs/iterable_differs.ts b/packages/core/src/change_detection/differs/iterable_differs.ts index 991a77465f..09f988d0a1 100644 --- a/packages/core/src/change_detection/differs/iterable_differs.ts +++ b/packages/core/src/change_detection/differs/iterable_differs.ts @@ -13,7 +13,7 @@ import {StaticProvider} from '../../di/provider'; /** * A type describing supported iterable types. * - * @stable + * */ export type NgIterable = Array| Iterable; @@ -21,7 +21,7 @@ export type NgIterable = Array| Iterable; * A strategy for tracking changes over time to an iterable. Used by {@link NgForOf} to * respond to changes in an iterable by effecting equivalent changes in the DOM. * - * @stable + * */ export interface IterableDiffer { /** @@ -38,7 +38,7 @@ export interface IterableDiffer { * An object describing the changes in the `Iterable` collection since last time * `IterableDiffer#diff()` was invoked. * - * @stable + * */ export interface IterableChanges { /** @@ -91,7 +91,7 @@ export interface IterableChanges { /** * Record representing the item change information. * - * @stable + * */ export interface IterableChangeRecord { /** Current index of the item in `Iterable` or null if removed. */ @@ -116,14 +116,14 @@ export interface CollectionChangeRecord extends IterableChangeRecord {} * An optional function passed into {@link NgForOf} that defines how to track * items in an iterable (e.g. fby index or id) * - * @stable + * */ export interface TrackByFunction { (index: number, item: T): any; } /** * Provides a factory for {@link IterableDiffer}. * - * @stable + * */ export interface IterableDifferFactory { supports(objects: any): boolean; @@ -132,7 +132,7 @@ export interface IterableDifferFactory { /** * A repository of different iterable diffing strategies used by NgFor, NgClass, and others. - * @stable + * */ export class IterableDiffers { /** diff --git a/packages/core/src/change_detection/differs/keyvalue_differs.ts b/packages/core/src/change_detection/differs/keyvalue_differs.ts index cefbab3225..c8e35cced3 100644 --- a/packages/core/src/change_detection/differs/keyvalue_differs.ts +++ b/packages/core/src/change_detection/differs/keyvalue_differs.ts @@ -12,7 +12,7 @@ import {Optional, SkipSelf, StaticProvider} from '../../di'; /** * A differ that tracks changes made to an object over time. * - * @stable + * */ export interface KeyValueDiffer { /** @@ -40,7 +40,7 @@ export interface KeyValueDiffer { * An object describing the changes in the `Map` or `{[k:string]: string}` since last time * `KeyValueDiffer#diff()` was invoked. * - * @stable + * */ export interface KeyValueChanges { /** @@ -74,7 +74,7 @@ export interface KeyValueChanges { /** * Record representing the item change information. * - * @stable + * */ export interface KeyValueChangeRecord { /** @@ -96,7 +96,7 @@ export interface KeyValueChangeRecord { /** * Provides a factory for {@link KeyValueDiffer}. * - * @stable + * */ export interface KeyValueDifferFactory { /** @@ -112,7 +112,7 @@ export interface KeyValueDifferFactory { /** * A repository of different Map diffing strategies used by NgClass, NgStyle, and others. - * @stable + * */ export class KeyValueDiffers { /** diff --git a/packages/core/src/change_detection/pipe_transform.ts b/packages/core/src/change_detection/pipe_transform.ts index d5a4605ed4..4e6d120931 100644 --- a/packages/core/src/change_detection/pipe_transform.ts +++ b/packages/core/src/change_detection/pipe_transform.ts @@ -33,6 +33,6 @@ * * Invoking `{{ 'ok' | repeat:3 }}` in a template produces `okokok`. * - * @stable + * */ export interface PipeTransform { transform(value: any, ...args: any[]): any; } diff --git a/packages/core/src/di/injectable.ts b/packages/core/src/di/injectable.ts index 663a03a219..507623051a 100644 --- a/packages/core/src/di/injectable.ts +++ b/packages/core/src/di/injectable.ts @@ -30,7 +30,7 @@ export type InjectableProvider = ValueSansProvider | ExistingSansProvider | /** * Type of the Injectable decorator / constructor function. * - * @stable + * */ export interface InjectableDecorator { /** @@ -54,7 +54,7 @@ export interface InjectableDecorator { * * {@example core/di/ts/metadata_spec.ts region='InjectableThrows'} * - * @stable + * */ (): any; (options?: {providedIn: Type| 'root' | null}&InjectableProvider): any; @@ -113,7 +113,7 @@ export function convertInjectableProviderToFactory( /** * Injectable decorator and metadata. * -* @stable +* * @Annotation */ export const Injectable: InjectableDecorator = makeDecorator( diff --git a/packages/core/src/di/injection_token.ts b/packages/core/src/di/injection_token.ts index adea877791..080ee0188e 100644 --- a/packages/core/src/di/injection_token.ts +++ b/packages/core/src/di/injection_token.ts @@ -46,7 +46,7 @@ import {InjectableDef, defineInjectable} from './defs'; * * {@example core/di/ts/injector_spec.ts region='InjectionToken'} * - * @stable + * */ export class InjectionToken { /** @internal */ diff --git a/packages/core/src/di/injector.ts b/packages/core/src/di/injector.ts index ba98456e35..8bb91dd68e 100644 --- a/packages/core/src/di/injector.ts +++ b/packages/core/src/di/injector.ts @@ -58,7 +58,7 @@ export class NullInjector implements Injector { * `Injector` returns itself when given `Injector` as a token: * {@example core/di/ts/injector_spec.ts region='injectInjector'} * - * @stable + * */ export abstract class Injector { static THROW_IF_NOT_FOUND = _THROW_IF_NOT_FOUND; @@ -412,7 +412,7 @@ function getClosureSafeProperty(objWithPropertyToExtract: T): string { /** * Injection flags for DI. * - * @stable + * */ export const enum InjectFlags { Default = 0, diff --git a/packages/core/src/di/metadata.ts b/packages/core/src/di/metadata.ts index bb283669cb..7ddb9cf9a3 100644 --- a/packages/core/src/di/metadata.ts +++ b/packages/core/src/di/metadata.ts @@ -16,7 +16,7 @@ import {EMPTY_ARRAY} from '../view/util'; /** * Type of the Inject decorator / constructor function. * - * @stable + * */ export interface InjectDecorator { /** @@ -44,7 +44,7 @@ export interface InjectDecorator { * * {@example core/di/ts/metadata_spec.ts region='InjectWithoutDecorator'} * - * @stable + * */ (token: any): any; new (token: any): Inject; @@ -53,14 +53,14 @@ export interface InjectDecorator { /** * Type of the Inject metadata. * - * @stable + * */ export interface Inject { token: any; } /** * Inject decorator and metadata. * - * @stable + * * @Annotation */ export const Inject: InjectDecorator = makeParamDecorator('Inject', (token: any) => ({token})); @@ -69,7 +69,7 @@ export const Inject: InjectDecorator = makeParamDecorator('Inject', (token: any) /** * Type of the Optional decorator / constructor function. * - * @stable + * */ export interface OptionalDecorator { /** @@ -91,7 +91,7 @@ export interface OptionalDecorator { * * {@example core/di/ts/metadata_spec.ts region='Optional'} * - * @stable + * */ (): any; new (): Optional; @@ -100,14 +100,14 @@ export interface OptionalDecorator { /** * Type of the Optional metadata. * - * @stable + * */ export interface Optional {} /** * Optional decorator and metadata. * - * @stable + * * @Annotation */ export const Optional: OptionalDecorator = makeParamDecorator('Optional'); @@ -115,7 +115,7 @@ export const Optional: OptionalDecorator = makeParamDecorator('Optional'); /** * Type of the Self decorator / constructor function. * - * @stable + * */ export interface SelfDecorator { /** @@ -136,7 +136,7 @@ export interface SelfDecorator { * * {@example core/di/ts/metadata_spec.ts region='Self'} * - * @stable + * */ (): any; new (): Self; @@ -145,14 +145,14 @@ export interface SelfDecorator { /** * Type of the Self metadata. * - * @stable + * */ export interface Self {} /** * Self decorator and metadata. * - * @stable + * * @Annotation */ export const Self: SelfDecorator = makeParamDecorator('Self'); @@ -161,7 +161,7 @@ export const Self: SelfDecorator = makeParamDecorator('Self'); /** * Type of the SkipSelf decorator / constructor function. * - * @stable + * */ export interface SkipSelfDecorator { /** @@ -182,7 +182,7 @@ export interface SkipSelfDecorator { * * {@example core/di/ts/metadata_spec.ts region='SkipSelf'} * - * @stable + * */ (): any; new (): SkipSelf; @@ -191,14 +191,14 @@ export interface SkipSelfDecorator { /** * Type of the SkipSelf metadata. * - * @stable + * */ export interface SkipSelf {} /** * SkipSelf decorator and metadata. * - * @stable + * * @Annotation */ export const SkipSelf: SkipSelfDecorator = makeParamDecorator('SkipSelf'); @@ -206,7 +206,7 @@ export const SkipSelf: SkipSelfDecorator = makeParamDecorator('SkipSelf'); /** * Type of the Host decorator / constructor function. * - * @stable + * */ export interface HostDecorator { /** @@ -228,7 +228,7 @@ export interface HostDecorator { * * {@example core/di/ts/metadata_spec.ts region='Host'} * - * @stable + * */ (): any; new (): Host; @@ -237,14 +237,14 @@ export interface HostDecorator { /** * Type of the Host metadata. * - * @stable + * */ export interface Host {} /** * Host decorator and metadata. * - * @stable + * * @Annotation */ export const Host: HostDecorator = makeParamDecorator('Host'); diff --git a/packages/core/src/di/provider.ts b/packages/core/src/di/provider.ts index 9b22c062da..1b521e911a 100644 --- a/packages/core/src/di/provider.ts +++ b/packages/core/src/di/provider.ts @@ -48,7 +48,7 @@ export interface ValueSansProvider { * * {@example core/di/ts/provider_spec.ts region='ValueProvider'} * - * @stable + * */ export interface ValueProvider extends ValueSansProvider { /** @@ -120,7 +120,7 @@ export interface StaticClassSansProvider { * Note that following two providers are not equal: * {@example core/di/ts/provider_spec.ts region='StaticClassProviderDifference'} * - * @stable + * */ export interface StaticClassProvider extends StaticClassSansProvider { /** @@ -183,7 +183,7 @@ export interface ConstructorSansProvider { * * {@example core/di/ts/provider_spec.ts region='ConstructorProvider'} * - * @stable + * */ export interface ConstructorProvider extends ConstructorSansProvider { /** @@ -218,7 +218,7 @@ export interface ConstructorProvider extends ConstructorSansProvider { * * {@example core/di/ts/provider_spec.ts region='ExistingSansProvider'} * - * @stable + * */ export interface ExistingSansProvider { /** @@ -242,7 +242,7 @@ export interface ExistingSansProvider { * * {@example core/di/ts/provider_spec.ts region='ExistingProvider'} * - * @stable + * */ export interface ExistingProvider extends ExistingSansProvider { /** @@ -315,7 +315,7 @@ export interface FactorySansProvider { * Dependencies can also be marked as optional: * {@example core/di/ts/provider_spec.ts region='FactoryProviderOptionalDeps'} * - * @stable + * */ export interface FactoryProvider extends FactorySansProvider { /** @@ -343,7 +343,7 @@ export interface FactoryProvider extends FactorySansProvider { * * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}. * - * @stable + * */ export type StaticProvider = ValueProvider | ExistingProvider | StaticClassProvider | ConstructorProvider | FactoryProvider | any[]; @@ -370,7 +370,7 @@ export type StaticProvider = ValueProvider | ExistingProvider | StaticClassProvi * * {@example core/di/ts/provider_spec.ts region='TypeProvider'} * - * @stable + * */ export interface TypeProvider extends Type {} @@ -423,7 +423,7 @@ export interface ClassSansProvider { * Note that following two providers are not equal: * {@example core/di/ts/provider_spec.ts region='ClassProviderDifference'} * - * @stable + * */ export interface ClassProvider extends ClassSansProvider { /** @@ -451,7 +451,7 @@ export interface ClassProvider extends ClassSansProvider { * * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}. * - * @stable + * */ export type Provider = TypeProvider | ValueProvider | ClassProvider | ExistingProvider | FactoryProvider | any[]; diff --git a/packages/core/src/di/reflective_errors.ts b/packages/core/src/di/reflective_errors.ts index 4eaf4be951..51f223c383 100644 --- a/packages/core/src/di/reflective_errors.ts +++ b/packages/core/src/di/reflective_errors.ts @@ -187,7 +187,7 @@ export function invalidProviderError(provider: any) { * * expect(() => Injector.resolveAndCreate([A,B])).toThrowError(); * ``` - * @stable + * */ export function noAnnotationError(typeOrFunc: Type| Function, params: any[][]): Error { const signature: string[] = []; @@ -218,7 +218,7 @@ export function noAnnotationError(typeOrFunc: Type| Function, params: any[] * * expect(() => injector.getAt(100)).toThrowError(); * ``` - * @stable + * */ export function outOfBoundsError(index: number) { return Error(`Index ${index} is out-of-bounds.`); diff --git a/packages/core/src/error_handler.ts b/packages/core/src/error_handler.ts index f961c4cc33..62f17e84d3 100644 --- a/packages/core/src/error_handler.ts +++ b/packages/core/src/error_handler.ts @@ -34,7 +34,7 @@ import {ERROR_ORIGINAL_ERROR, getDebugContext, getErrorLogger, getOriginalError} * class MyModule {} * ``` * - * @stable + * */ export class ErrorHandler { /** diff --git a/packages/core/src/event_emitter.ts b/packages/core/src/event_emitter.ts index 799eaff9b3..bd46970b5c 100644 --- a/packages/core/src/event_emitter.ts +++ b/packages/core/src/event_emitter.ts @@ -53,7 +53,7 @@ import {Subject, Subscription} from 'rxjs'; * https://github.com/jhusain/observable-spec * * Once a reference implementation of the spec is available, switch to it. - * @stable + * */ export class EventEmitter extends Subject { // TODO: mark this as internal once all the facades are gone diff --git a/packages/core/src/linker/compiler.ts b/packages/core/src/linker/compiler.ts index 621c4cb57b..d9e5acec94 100644 --- a/packages/core/src/linker/compiler.ts +++ b/packages/core/src/linker/compiler.ts @@ -39,7 +39,7 @@ function _throwError() { * Each `@NgModule` provides an own `Compiler` to its injector, * that will use the directives/pipes of the ng module for compilation * of components. - * @stable + * */ @Injectable() export class Compiler { diff --git a/packages/core/src/linker/component_factory.ts b/packages/core/src/linker/component_factory.ts index 7e7ac7c519..3deb494bdf 100644 --- a/packages/core/src/linker/component_factory.ts +++ b/packages/core/src/linker/component_factory.ts @@ -20,7 +20,7 @@ import {ViewRef} from './view_ref'; * `ComponentRef` provides access to the Component Instance as well other objects related to this * Component Instance and allows you to destroy the Component Instance via the {@link #destroy} * method. - * @stable + * */ export abstract class ComponentRef { /** @@ -65,7 +65,7 @@ export abstract class ComponentRef { } /** - * @stable + * */ export abstract class ComponentFactory { abstract get selector(): string; diff --git a/packages/core/src/linker/component_factory_resolver.ts b/packages/core/src/linker/component_factory_resolver.ts index 2ebb7fe369..e1a4f56b39 100644 --- a/packages/core/src/linker/component_factory_resolver.ts +++ b/packages/core/src/linker/component_factory_resolver.ts @@ -34,7 +34,7 @@ class _NullComponentFactoryResolver implements ComponentFactoryResolver { } /** - * @stable + * */ export abstract class ComponentFactoryResolver { static NULL: ComponentFactoryResolver = new _NullComponentFactoryResolver(); diff --git a/packages/core/src/linker/element_ref.ts b/packages/core/src/linker/element_ref.ts index e4cf8b565d..9adc4128bd 100644 --- a/packages/core/src/linker/element_ref.ts +++ b/packages/core/src/linker/element_ref.ts @@ -16,7 +16,7 @@ * XSS attacks. Carefully review any use of `ElementRef` in your code. For more detail, see the * [Security Guide](http://g.co/ng/security). * - * @stable + * */ // Note: We don't expose things like `Injector`, `ViewContainer`, ... here, // i.e. users have to ask for what they need. With that, we can build better analysis tools @@ -41,7 +41,7 @@ export class ElementRef { * web worker. *

* - * @stable + * */ public nativeElement: T; diff --git a/packages/core/src/linker/ng_module_factory.ts b/packages/core/src/linker/ng_module_factory.ts index 0e4925f806..dac8488c89 100644 --- a/packages/core/src/linker/ng_module_factory.ts +++ b/packages/core/src/linker/ng_module_factory.ts @@ -18,7 +18,7 @@ import {ComponentFactoryResolver} from './component_factory_resolver'; * `NgModuleRef` provides access to the NgModule Instance as well other objects related to this * NgModule Instance. * - * @stable + * */ export abstract class NgModuleRef { /** diff --git a/packages/core/src/linker/ng_module_factory_loader.ts b/packages/core/src/linker/ng_module_factory_loader.ts index 8f0e8d7286..290f4f53d2 100644 --- a/packages/core/src/linker/ng_module_factory_loader.ts +++ b/packages/core/src/linker/ng_module_factory_loader.ts @@ -10,7 +10,7 @@ import {NgModuleFactory} from './ng_module_factory'; /** * Used to load ng module factories. - * @stable + * */ export abstract class NgModuleFactoryLoader { abstract load(path: string): Promise>; diff --git a/packages/core/src/linker/query_list.ts b/packages/core/src/linker/query_list.ts index b461e93b22..3d7739a471 100644 --- a/packages/core/src/linker/query_list.ts +++ b/packages/core/src/linker/query_list.ts @@ -34,7 +34,7 @@ import {getSymbolIterator} from '../util'; * @ViewChildren(Item) items:QueryList; * } * ``` - * @stable + * */ export class QueryList/* implements Iterable */ { public readonly dirty = true; diff --git a/packages/core/src/linker/template_ref.ts b/packages/core/src/linker/template_ref.ts index bdf2afc849..d3fc094d5b 100644 --- a/packages/core/src/linker/template_ref.ts +++ b/packages/core/src/linker/template_ref.ts @@ -20,7 +20,7 @@ import {EmbeddedViewRef} from './view_ref'; * * To instantiate Embedded Views based on a Template, use {@link ViewContainerRef# * createEmbeddedView}, which will create the View and attach it to the View Container. - * @stable + * */ export abstract class TemplateRef { /** diff --git a/packages/core/src/linker/view_container_ref.ts b/packages/core/src/linker/view_container_ref.ts index 4c6c428cdc..cb188cecdf 100644 --- a/packages/core/src/linker/view_container_ref.ts +++ b/packages/core/src/linker/view_container_ref.ts @@ -30,7 +30,7 @@ import {EmbeddedViewRef, ViewRef} from './view_ref'; * * To access a `ViewContainerRef` of an Element, you can either place a {@link Directive} injected * with `ViewContainerRef` on the Element, or you obtain it via a {@link ViewChild} query. - * @stable + * */ export abstract class ViewContainerRef { /** diff --git a/packages/core/src/linker/view_ref.ts b/packages/core/src/linker/view_ref.ts index 3f110bd3ff..bdaf8e7ce5 100644 --- a/packages/core/src/linker/view_ref.ts +++ b/packages/core/src/linker/view_ref.ts @@ -11,7 +11,7 @@ import {ChangeDetectorRef} from '../change_detection/change_detector_ref'; /** - * @stable + * */ export abstract class ViewRef extends ChangeDetectorRef { /** diff --git a/packages/core/src/metadata/di.ts b/packages/core/src/metadata/di.ts index 2fe51f3294..fff3ae60e1 100644 --- a/packages/core/src/metadata/di.ts +++ b/packages/core/src/metadata/di.ts @@ -49,7 +49,7 @@ export const ANALYZE_FOR_ENTRY_COMPONENTS = new InjectionToken('AnalyzeForE /** * Type of the Attribute decorator / constructor function. * - * @stable + * */ export interface AttributeDecorator { /** @@ -88,7 +88,7 @@ export interface AttributeDecorator { * ] * ``` * - * @stable + * */ (name: string): any; new (name: string): Attribute; @@ -103,7 +103,7 @@ export interface Attribute { attributeName?: string; } /** * Attribute decorator and metadata. * - * @stable + * * @Annotation */ export const Attribute: AttributeDecorator = @@ -112,7 +112,7 @@ export const Attribute: AttributeDecorator = /** * Type of the Query metadata. * - * @stable + * */ export interface Query { descendants: boolean; @@ -128,7 +128,7 @@ export interface Query { * See {@link ContentChildren}, {@link ContentChild}, {@link ViewChildren}, {@link ViewChild} for * more information. * - * @stable + * */ export abstract class Query {} @@ -137,7 +137,7 @@ export abstract class Query {} * * See {@link ContentChildren}. * - * @stable + * */ export interface ContentChildrenDecorator { /** @@ -168,7 +168,7 @@ export interface ContentChildrenDecorator { * * **npm package**: `@angular/core` * - * @stable + * * @Annotation */ (selector: Type|Function|string, opts?: {descendants?: boolean, read?: any}): any; @@ -178,7 +178,7 @@ export interface ContentChildrenDecorator { /** * Type of the ContentChildren metadata. * - * @stable + * * @Annotation */ export type ContentChildren = Query; @@ -186,7 +186,7 @@ export type ContentChildren = Query; /** * ContentChildren decorator and metadata. * - * @stable + * * @Annotation */ export const ContentChildren: ContentChildrenDecorator = makePropDecorator( @@ -199,7 +199,7 @@ export const ContentChildren: ContentChildrenDecorator = makePropDecorator( * Type of the ContentChild decorator / constructor function. * * - * @stable + * */ export interface ContentChildDecorator { /** @@ -228,7 +228,7 @@ export interface ContentChildDecorator { * * **npm package**: `@angular/core` * - * @stable + * * @Annotation */ (selector: Type|Function|string, opts?: {read?: any}): any; @@ -240,14 +240,14 @@ export interface ContentChildDecorator { * * See {@link ContentChild}. * - * @stable + * */ export type ContentChild = Query; /** * ContentChild decorator and metadata. * - * @stable + * * @Annotation */ export const ContentChild: ContentChildDecorator = makePropDecorator( @@ -260,7 +260,7 @@ export const ContentChild: ContentChildDecorator = makePropDecorator( * * See {@link ViewChildren}. * - * @stable + * */ export interface ViewChildrenDecorator { /** @@ -289,7 +289,7 @@ export interface ViewChildrenDecorator { * * **npm package**: `@angular/core` * - * @stable + * * @Annotation */ (selector: Type|Function|string, opts?: {read?: any}): any; @@ -299,14 +299,14 @@ export interface ViewChildrenDecorator { /** * Type of the ViewChildren metadata. * - * @stable + * */ export type ViewChildren = Query; /** * ViewChildren decorator and metadata. * - * @stable + * * @Annotation */ export const ViewChildren: ViewChildrenDecorator = makePropDecorator( @@ -319,7 +319,7 @@ export const ViewChildren: ViewChildrenDecorator = makePropDecorator( * * See {@link ViewChild} * - * @stable + * */ export interface ViewChildDecorator { /** @@ -346,7 +346,7 @@ export interface ViewChildDecorator { * * **npm package**: `@angular/core` * - * @stable + * * @Annotation */ (selector: Type|Function|string, opts?: {read?: any}): any; @@ -356,14 +356,14 @@ export interface ViewChildDecorator { /** * Type of the ViewChild metadata. * - * @stable + * */ export type ViewChild = Query; /** * ViewChild decorator and metadata. * - * @stable + * * @Annotation */ export const ViewChild: ViewChildDecorator = makePropDecorator( diff --git a/packages/core/src/metadata/directives.ts b/packages/core/src/metadata/directives.ts index f478574db7..145f5ed18f 100644 --- a/packages/core/src/metadata/directives.ts +++ b/packages/core/src/metadata/directives.ts @@ -17,7 +17,7 @@ import {ViewEncapsulation} from './view'; /** * Type of the Directive decorator / constructor function. * - * @stable + * */ export interface DirectiveDecorator { /** @@ -65,7 +65,7 @@ export interface DirectiveDecorator { * * **queries** - configure queries that can be injected into the component * * **selector** - css selector that identifies this component in a template * - * @stable + * * @Annotation */ (obj: Directive): TypeDecorator; @@ -397,7 +397,7 @@ export interface Directive { /** * Directive decorator and metadata. * - * @stable + * * @Annotation */ export const Directive: DirectiveDecorator = @@ -406,7 +406,7 @@ export const Directive: DirectiveDecorator = /** * Type of the Component decorator / constructor function. * - * @stable + * */ export interface ComponentDecorator { /** @@ -462,7 +462,7 @@ export interface ComponentDecorator { * * {@example core/ts/metadata/metadata.ts region='component'} * - * @stable + * * @Annotation */ (obj: Component): TypeDecorator; @@ -475,7 +475,7 @@ export interface ComponentDecorator { /** * Type of the Component metadata. * - * @stable + * */ export interface Component extends Directive { /** @@ -749,7 +749,7 @@ export interface Component extends Directive { /** * Component decorator and metadata. * - * @stable + * * @Annotation */ export const Component: ComponentDecorator = makeDecorator( @@ -759,7 +759,7 @@ export const Component: ComponentDecorator = makeDecorator( /** * Type of the Pipe decorator / constructor function. * - * @stable + * */ export interface PipeDecorator { /** @@ -780,7 +780,7 @@ export interface PipeDecorator { /** * Type of the Pipe metadata. * - * @stable + * */ export interface Pipe { /** @@ -813,7 +813,7 @@ export interface Pipe { * To use the pipe include a reference to the pipe class in * {@link NgModule#declarations}. * - * @stable + * * @Annotation */ export const Pipe: PipeDecorator = makeDecorator('Pipe', (p: Pipe) => ({pure: true, ...p})); @@ -822,7 +822,7 @@ export const Pipe: PipeDecorator = makeDecorator('Pipe', (p: Pipe) => ({pure: tr /** * Type of the Input decorator / constructor function. * - * @stable + * */ export interface InputDecorator { /** @@ -863,7 +863,7 @@ export interface InputDecorator { * * class App {} * ``` - * @stable + * */ (bindingPropertyName?: string): any; new (bindingPropertyName?: string): any; @@ -872,7 +872,7 @@ export interface InputDecorator { /** * Type of the Input metadata. * - * @stable + * */ export interface Input { /** @@ -884,7 +884,7 @@ export interface Input { /** * Input decorator and metadata. * - * @stable + * * @Annotation */ export const Input: InputDecorator = @@ -893,7 +893,7 @@ export const Input: InputDecorator = /** * Type of the Output decorator / constructor function. * - * @stable + * */ export interface OutputDecorator { /** @@ -934,7 +934,7 @@ export interface OutputDecorator { * everyFiveSeconds() { console.log('five seconds'); } * } * ``` - * @stable + * */ (bindingPropertyName?: string): any; new (bindingPropertyName?: string): any; @@ -943,14 +943,14 @@ export interface OutputDecorator { /** * Type of the Output metadata. * - * @stable + * */ export interface Output { bindingPropertyName?: string; } /** * Output decorator and metadata. * - * @stable + * * @Annotation */ export const Output: OutputDecorator = @@ -960,7 +960,7 @@ export const Output: OutputDecorator = /** * Type of the HostBinding decorator / constructor function. * - * @stable + * */ export interface HostBindingDecorator { /** @@ -994,7 +994,7 @@ export interface HostBindingDecorator { * prop; * } * ``` - * @stable + * */ (hostPropertyName?: string): any; new (hostPropertyName?: string): any; @@ -1003,14 +1003,14 @@ export interface HostBindingDecorator { /** * Type of the HostBinding metadata. * - * @stable + * */ export interface HostBinding { hostPropertyName?: string; } /** * HostBinding decorator and metadata. * - * @stable + * * @Annotation */ export const HostBinding: HostBindingDecorator = @@ -1020,7 +1020,7 @@ export const HostBinding: HostBindingDecorator = /** * Type of the HostListener decorator / constructor function. * - * @stable + * */ export interface HostListenerDecorator { /** @@ -1052,7 +1052,7 @@ export interface HostListenerDecorator { * }) * class App {} * ``` - * @stable + * * @Annotation */ (eventName: string, args?: string[]): any; @@ -1062,7 +1062,7 @@ export interface HostListenerDecorator { /** * Type of the HostListener metadata. * - * @stable + * */ export interface HostListener { eventName?: string; @@ -1072,7 +1072,7 @@ export interface HostListener { /** * HostListener decorator and metadata. * - * @stable + * * @Annotation */ export const HostListener: HostListenerDecorator = diff --git a/packages/core/src/metadata/lifecycle_hooks.ts b/packages/core/src/metadata/lifecycle_hooks.ts index 70046d97a2..cfa21b9dee 100644 --- a/packages/core/src/metadata/lifecycle_hooks.ts +++ b/packages/core/src/metadata/lifecycle_hooks.ts @@ -12,7 +12,7 @@ import {SimpleChange} from '../change_detection/change_detection_util'; /** * A `changes` object whose keys are property names and * values are instances of {@link SimpleChange}. See {@link OnChanges} - * @stable + * */ export interface SimpleChanges { [propName: string]: SimpleChange; } @@ -29,7 +29,7 @@ export interface SimpleChanges { [propName: string]: SimpleChange; } * * See {@linkDocs guide/lifecycle-hooks#onchanges "Lifecycle Hooks Guide"}. * - * @stable + * */ export interface OnChanges { ngOnChanges(changes: SimpleChanges): void; } @@ -47,7 +47,7 @@ export interface OnChanges { ngOnChanges(changes: SimpleChanges): void; } * * See {@linkDocs guide/lifecycle-hooks "Lifecycle Hooks Guide"}. * - * @stable + * */ export interface OnInit { ngOnInit(): void; } @@ -71,7 +71,7 @@ export interface OnInit { ngOnInit(): void; } * * See {@linkDocs guide/lifecycle-hooks#docheck "Lifecycle Hooks Guide"}. * - * @stable + * */ export interface DoCheck { ngDoCheck(): void; } @@ -87,7 +87,7 @@ export interface DoCheck { ngDoCheck(): void; } * * See {@linkDocs guide/lifecycle-hooks "Lifecycle Hooks Guide"}. * - * @stable + * */ export interface OnDestroy { ngOnDestroy(): void; } @@ -102,7 +102,7 @@ export interface OnDestroy { ngOnDestroy(): void; } * * See {@linkDocs guide/lifecycle-hooks#aftercontent "Lifecycle Hooks Guide"}. * - * @stable + * */ export interface AfterContentInit { ngAfterContentInit(): void; } @@ -115,7 +115,7 @@ export interface AfterContentInit { ngAfterContentInit(): void; } * * See {@linkDocs guide/lifecycle-hooks#aftercontent "Lifecycle Hooks Guide"}. * - * @stable + * */ export interface AfterContentChecked { ngAfterContentChecked(): void; } @@ -129,7 +129,7 @@ export interface AfterContentChecked { ngAfterContentChecked(): void; } * * See {@linkDocs guide/lifecycle-hooks#afterview "Lifecycle Hooks Guide"}. * - * @stable + * */ export interface AfterViewInit { ngAfterViewInit(): void; } @@ -142,6 +142,6 @@ export interface AfterViewInit { ngAfterViewInit(): void; } * * See {@linkDocs guide/lifecycle-hooks#afterview "Lifecycle Hooks Guide"}. * - * @stable + * */ export interface AfterViewChecked { ngAfterViewChecked(): void; } diff --git a/packages/core/src/metadata/ng_module.ts b/packages/core/src/metadata/ng_module.ts index 363ada2612..60e9986efb 100644 --- a/packages/core/src/metadata/ng_module.ts +++ b/packages/core/src/metadata/ng_module.ts @@ -16,7 +16,7 @@ import {TypeDecorator, makeDecorator} from '../util/decorators'; /** * A wrapper around a module that also includes the providers. * - * @stable + * */ export interface ModuleWithProviders { ngModule: Type; @@ -36,7 +36,7 @@ export interface SchemaMetadata { name: string; } * - any properties on elements with a `-` in their name which is the common rule for custom * elements. * - * @stable + * */ export const CUSTOM_ELEMENTS_SCHEMA: SchemaMetadata = { name: 'custom-elements' @@ -55,7 +55,7 @@ export const NO_ERRORS_SCHEMA: SchemaMetadata = { /** * Type of the NgModule decorator / constructor function. * - * @stable + * */ export interface NgModuleDecorator { /** @@ -68,7 +68,7 @@ export interface NgModuleDecorator { /** * Type of the NgModule metadata. * - * @stable + * */ export interface NgModule { /** @@ -190,7 +190,7 @@ export interface NgModule { /** * NgModule decorator and metadata. * - * @stable + * * @Annotation */ export const NgModule: NgModuleDecorator = makeDecorator( diff --git a/packages/core/src/metadata/view.ts b/packages/core/src/metadata/view.ts index 5644aa537c..1874257075 100644 --- a/packages/core/src/metadata/view.ts +++ b/packages/core/src/metadata/view.ts @@ -10,7 +10,7 @@ * Defines template and style encapsulation options available for Component's {@link Component}. * * See {@link Component#encapsulation encapsulation}. - * @stable + * */ export enum ViewEncapsulation { /** diff --git a/packages/core/src/sanitization/security.ts b/packages/core/src/sanitization/security.ts index c47e30bde9..bef465345b 100644 --- a/packages/core/src/sanitization/security.ts +++ b/packages/core/src/sanitization/security.ts @@ -13,7 +13,7 @@ * * See DomSanitizer for more details on security in Angular applications. * - * @stable + * */ export enum SecurityContext { NONE = 0, @@ -27,7 +27,7 @@ export enum SecurityContext { /** * Sanitizer is used by the views to sanitize potentially dangerous values. * - * @stable + * */ export abstract class Sanitizer { abstract sanitize(context: SecurityContext, value: {}|string|null): string|null; diff --git a/packages/core/src/type.ts b/packages/core/src/type.ts index a6429bd970..42f072385b 100644 --- a/packages/core/src/type.ts +++ b/packages/core/src/type.ts @@ -14,7 +14,7 @@ * An example of a `Type` is `MyCustomComponent` class, which in JavaScript is be represented by * the `MyCustomComponent` constructor function. * - * @stable + * */ export const Type = Function; diff --git a/packages/core/src/util/decorators.ts b/packages/core/src/util/decorators.ts index 3c3e0c0b17..afc39b620a 100644 --- a/packages/core/src/util/decorators.ts +++ b/packages/core/src/util/decorators.ts @@ -19,7 +19,7 @@ import {Type} from '../type'; * @ng.Component({...}) * class MyClass {...} * ``` - * @stable + * */ export interface TypeDecorator { /** diff --git a/packages/core/src/version.ts b/packages/core/src/version.ts index 76534b37e8..12fbcb4467 100644 --- a/packages/core/src/version.ts +++ b/packages/core/src/version.ts @@ -9,7 +9,7 @@ /** * @description Represents the version of Angular * - * @stable + * */ export class Version { public readonly major: string; @@ -24,6 +24,6 @@ export class Version { } /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/core/testing/src/async.ts b/packages/core/testing/src/async.ts index ebe2052314..1d67a2d25e 100644 --- a/packages/core/testing/src/async.ts +++ b/packages/core/testing/src/async.ts @@ -23,7 +23,7 @@ import {asyncFallback} from './async_fallback'; * }); * ``` * - * @stable + * */ export function async(fn: Function): (done: any) => any { const _Zone: any = typeof Zone !== 'undefined' ? Zone : null; diff --git a/packages/core/testing/src/async_fallback.ts b/packages/core/testing/src/async_fallback.ts index b5db030f0d..a2c8250b12 100644 --- a/packages/core/testing/src/async_fallback.ts +++ b/packages/core/testing/src/async_fallback.ts @@ -29,7 +29,7 @@ const _global = (typeof window === 'undefined' ? global : window); * }); * ``` * - * @stable + * */ export function asyncFallback(fn: Function): (done: any) => any { // If we're running using the Jasmine test framework, adapt to call the 'done' diff --git a/packages/core/testing/src/component_fixture.ts b/packages/core/testing/src/component_fixture.ts index 7c5da496f4..88c5acd32e 100644 --- a/packages/core/testing/src/component_fixture.ts +++ b/packages/core/testing/src/component_fixture.ts @@ -12,7 +12,7 @@ import {ChangeDetectorRef, ComponentRef, DebugElement, ElementRef, NgZone, Rende /** * Fixture for debugging and testing a component. * - * @stable + * */ export class ComponentFixture { /** diff --git a/packages/core/testing/src/test_bed.ts b/packages/core/testing/src/test_bed.ts index 32f1470c45..7f0176ab52 100644 --- a/packages/core/testing/src/test_bed.ts +++ b/packages/core/testing/src/test_bed.ts @@ -55,7 +55,7 @@ export type TestModuleMetadata = { * * TestBed is the primary api for writing unit tests for Angular applications and libraries. * - * @stable + * */ export class TestBed implements Injector { /** @@ -606,7 +606,7 @@ export function getTestBed() { * eventually * becomes `it('...', @Inject (object: AClass, async: AsyncTestCompleter) => { ... });` * - * @stable + * */ export function inject(tokens: any[], fn: Function): () => any { const testBed = getTestBed(); diff --git a/packages/forms/src/directives/abstract_control_directive.ts b/packages/forms/src/directives/abstract_control_directive.ts index b63132ba14..c0d049bfc8 100644 --- a/packages/forms/src/directives/abstract_control_directive.ts +++ b/packages/forms/src/directives/abstract_control_directive.ts @@ -15,7 +15,7 @@ import {ValidationErrors} from './validators'; * * Only used internally in the forms module. * - * @stable + * */ export abstract class AbstractControlDirective { /** diff --git a/packages/forms/src/directives/abstract_form_group_directive.ts b/packages/forms/src/directives/abstract_form_group_directive.ts index df3df50e2b..91e446a33c 100644 --- a/packages/forms/src/directives/abstract_form_group_directive.ts +++ b/packages/forms/src/directives/abstract_form_group_directive.ts @@ -20,7 +20,7 @@ import {AsyncValidatorFn, ValidatorFn} from './validators'; /** * This is a base class for code shared between `NgModelGroup` and `FormGroupName`. * - * @stable + * */ export class AbstractFormGroupDirective extends ControlContainer implements OnInit, OnDestroy { /** @internal */ diff --git a/packages/forms/src/directives/checkbox_value_accessor.ts b/packages/forms/src/directives/checkbox_value_accessor.ts index 835ece8350..dd8ee87b5a 100644 --- a/packages/forms/src/directives/checkbox_value_accessor.ts +++ b/packages/forms/src/directives/checkbox_value_accessor.ts @@ -24,7 +24,7 @@ export const CHECKBOX_VALUE_ACCESSOR: any = { * * ``` * - * @stable + * */ @Directive({ selector: diff --git a/packages/forms/src/directives/control_container.ts b/packages/forms/src/directives/control_container.ts index 305d6aeeac..9002b212ab 100644 --- a/packages/forms/src/directives/control_container.ts +++ b/packages/forms/src/directives/control_container.ts @@ -15,7 +15,7 @@ import {Form} from './form_interface'; * * Only used by the forms module. * - * @stable + * */ export abstract class ControlContainer extends AbstractControlDirective { name: string; diff --git a/packages/forms/src/directives/control_value_accessor.ts b/packages/forms/src/directives/control_value_accessor.ts index 6c65d9ff04..569647c579 100644 --- a/packages/forms/src/directives/control_value_accessor.ts +++ b/packages/forms/src/directives/control_value_accessor.ts @@ -15,7 +15,7 @@ import {InjectionToken} from '@angular/core'; * Implement this interface if you want to create a custom form control directive * that integrates with Angular forms. * - * @stable + * */ export interface ControlValueAccessor { /** @@ -113,6 +113,6 @@ export interface ControlValueAccessor { * Used to provide a `ControlValueAccessor` for form controls. * * See `DefaultValueAccessor` for how to implement one. - * @stable + * */ export const NG_VALUE_ACCESSOR = new InjectionToken('NgValueAccessor'); diff --git a/packages/forms/src/directives/default_value_accessor.ts b/packages/forms/src/directives/default_value_accessor.ts index 2758a879fa..b082fd0688 100644 --- a/packages/forms/src/directives/default_value_accessor.ts +++ b/packages/forms/src/directives/default_value_accessor.ts @@ -40,7 +40,7 @@ export const COMPOSITION_BUFFER_MODE = new InjectionToken('CompositionE * * ``` * - * @stable + * */ @Directive({ selector: diff --git a/packages/forms/src/directives/form_interface.ts b/packages/forms/src/directives/form_interface.ts index ca7e96d666..d2790aa1d8 100644 --- a/packages/forms/src/directives/form_interface.ts +++ b/packages/forms/src/directives/form_interface.ts @@ -18,7 +18,7 @@ import {NgControl} from './ng_control'; * * Only used by the forms module. * - * @stable + * */ export interface Form { /** diff --git a/packages/forms/src/directives/ng_control.ts b/packages/forms/src/directives/ng_control.ts index 00f4b59aeb..b5b028c7de 100644 --- a/packages/forms/src/directives/ng_control.ts +++ b/packages/forms/src/directives/ng_control.ts @@ -22,7 +22,7 @@ function unimplemented(): any { * * Used internally by Angular forms. * - * @stable + * */ export abstract class NgControl extends AbstractControlDirective { /** @internal */ diff --git a/packages/forms/src/directives/ng_control_status.ts b/packages/forms/src/directives/ng_control_status.ts index 51c91d3f4e..44ebb8d9eb 100644 --- a/packages/forms/src/directives/ng_control_status.ts +++ b/packages/forms/src/directives/ng_control_status.ts @@ -49,7 +49,7 @@ export const ngControlStatusHost = { * * ng-untouched * * ng-touched * - * @stable + * */ @Directive({selector: '[formControlName],[ngModel],[formControl]', host: ngControlStatusHost}) export class NgControlStatus extends AbstractControlStatus { @@ -60,7 +60,7 @@ export class NgControlStatus extends AbstractControlStatus { * Directive automatically applied to Angular form groups that sets CSS classes * based on control status (valid/invalid/dirty/etc). * - * @stable + * */ @Directive({ selector: diff --git a/packages/forms/src/directives/ng_form.ts b/packages/forms/src/directives/ng_form.ts index b9256ba1d9..ee285127bf 100644 --- a/packages/forms/src/directives/ng_form.ts +++ b/packages/forms/src/directives/ng_form.ts @@ -61,7 +61,7 @@ const resolvedPromise = Promise.resolve(null); * * * **NgModule**: `FormsModule` * - * @stable + * */ @Directive({ selector: 'form:not([ngNoForm]):not([formGroup]),ngForm,[ngForm]', diff --git a/packages/forms/src/directives/ng_model.ts b/packages/forms/src/directives/ng_model.ts index 16c17f0ba1..882153d794 100644 --- a/packages/forms/src/directives/ng_model.ts +++ b/packages/forms/src/directives/ng_model.ts @@ -101,7 +101,7 @@ const resolvedPromise = Promise.resolve(null); * * **NgModule**: `FormsModule` * - * @stable + * */ @Directive({ selector: '[ngModel]:not([formControlName]):not([formControl])', diff --git a/packages/forms/src/directives/ng_model_group.ts b/packages/forms/src/directives/ng_model_group.ts index 5f72c3545b..88af18344b 100644 --- a/packages/forms/src/directives/ng_model_group.ts +++ b/packages/forms/src/directives/ng_model_group.ts @@ -43,7 +43,7 @@ export const modelGroupProvider: any = { * * * **NgModule**: `FormsModule` * - * @stable + * */ @Directive({selector: '[ngModelGroup]', providers: [modelGroupProvider], exportAs: 'ngModelGroup'}) export class NgModelGroup extends AbstractFormGroupDirective implements OnInit, OnDestroy { diff --git a/packages/forms/src/directives/radio_control_value_accessor.ts b/packages/forms/src/directives/radio_control_value_accessor.ts index 93c61105ea..13343f7bd3 100644 --- a/packages/forms/src/directives/radio_control_value_accessor.ts +++ b/packages/forms/src/directives/radio_control_value_accessor.ts @@ -81,7 +81,7 @@ export class RadioControlRegistry { * * * **npm package**: `@angular/forms` * - * @stable + * */ @Directive({ selector: diff --git a/packages/forms/src/directives/reactive_directives/form_control_directive.ts b/packages/forms/src/directives/reactive_directives/form_control_directive.ts index 5bc86796a3..0683aeba66 100644 --- a/packages/forms/src/directives/reactive_directives/form_control_directive.ts +++ b/packages/forms/src/directives/reactive_directives/form_control_directive.ts @@ -134,7 +134,7 @@ export const formControlBinding: any = { * pattern with a config value of `"always"`. This may help to track down where in the code * the pattern is being used as the code is being updated. * - * @stable + * */ @Directive({selector: '[formControl]', providers: [formControlBinding], exportAs: 'ngForm'}) diff --git a/packages/forms/src/directives/reactive_directives/form_control_name.ts b/packages/forms/src/directives/reactive_directives/form_control_name.ts index 462c340d0e..da9bb6de83 100644 --- a/packages/forms/src/directives/reactive_directives/form_control_name.ts +++ b/packages/forms/src/directives/reactive_directives/form_control_name.ts @@ -146,7 +146,7 @@ export const controlNameBinding: any = { * pattern with a config value of `"always"`. This may help to track down where in the code * the pattern is being used as the code is being updated. * - * @stable + * */ @Directive({selector: '[formControlName]', providers: [controlNameBinding]}) export class FormControlName extends NgControl implements OnChanges, OnDestroy { diff --git a/packages/forms/src/directives/reactive_directives/form_group_directive.ts b/packages/forms/src/directives/reactive_directives/form_group_directive.ts index 6e8d724ad2..cd5562e83c 100644 --- a/packages/forms/src/directives/reactive_directives/form_group_directive.ts +++ b/packages/forms/src/directives/reactive_directives/form_group_directive.ts @@ -56,7 +56,7 @@ export const formDirectiveProvider: any = { * * **NgModule**: `ReactiveFormsModule` * - * @stable + * */ @Directive({ selector: '[formGroup]', diff --git a/packages/forms/src/directives/reactive_directives/form_group_name.ts b/packages/forms/src/directives/reactive_directives/form_group_name.ts index ab0ae2f400..eb125784f0 100644 --- a/packages/forms/src/directives/reactive_directives/form_group_name.ts +++ b/packages/forms/src/directives/reactive_directives/form_group_name.ts @@ -65,7 +65,7 @@ export const formGroupNameProvider: any = { * * * **NgModule**: `ReactiveFormsModule` * - * @stable + * */ @Directive({selector: '[formGroupName]', providers: [formGroupNameProvider]}) export class FormGroupName extends AbstractFormGroupDirective implements OnInit, OnDestroy { @@ -139,7 +139,7 @@ export const formArrayNameProvider: any = { * * * **NgModule**: `ReactiveFormsModule` * - * @stable + * */ @Directive({selector: '[formArrayName]', providers: [formArrayNameProvider]}) export class FormArrayName extends ControlContainer implements OnInit, OnDestroy { diff --git a/packages/forms/src/directives/select_control_value_accessor.ts b/packages/forms/src/directives/select_control_value_accessor.ts index dcd9a5903f..bd3d8bafaf 100644 --- a/packages/forms/src/directives/select_control_value_accessor.ts +++ b/packages/forms/src/directives/select_control_value_accessor.ts @@ -87,7 +87,7 @@ function _extractId(valueString: string): string { * * * **npm package**: `@angular/forms` * - * @stable + * */ @Directive({ selector: @@ -164,7 +164,7 @@ export class SelectControlValueAccessor implements ControlValueAccessor { * * See docs for `SelectControlValueAccessor` for usage examples. * - * @stable + * */ @Directive({selector: 'option'}) export class NgSelectOption implements OnDestroy { diff --git a/packages/forms/src/directives/select_multiple_control_value_accessor.ts b/packages/forms/src/directives/select_multiple_control_value_accessor.ts index c8e5b692e1..4dae1c507a 100644 --- a/packages/forms/src/directives/select_multiple_control_value_accessor.ts +++ b/packages/forms/src/directives/select_multiple_control_value_accessor.ts @@ -67,7 +67,7 @@ abstract class HTMLCollection { * } * ``` * - * @stable + * */ @Directive({ selector: diff --git a/packages/forms/src/directives/validators.ts b/packages/forms/src/directives/validators.ts index da5952db08..8dfe9f6e3c 100644 --- a/packages/forms/src/directives/validators.ts +++ b/packages/forms/src/directives/validators.ts @@ -35,7 +35,7 @@ export type ValidationErrors = { * } * ``` * - * @stable + * */ export interface Validator { validate(c: AbstractControl): ValidationErrors|null; @@ -70,7 +70,7 @@ export const CHECKBOX_REQUIRED_VALIDATOR: StaticProvider = { * * ``` * - * @stable + * */ @Directive({ selector: @@ -167,12 +167,12 @@ export class EmailValidator implements Validator { } /** - * @stable + * */ export interface ValidatorFn { (c: AbstractControl): ValidationErrors|null; } /** - * @stable + * */ export interface AsyncValidatorFn { (c: AbstractControl): Promise|Observable; @@ -195,7 +195,7 @@ export const MIN_LENGTH_VALIDATOR: any = { * A directive which installs the `MinLengthValidator` for any `formControlName`, * `formControl`, or control with `ngModel` that also has a `minlength` attribute. * - * @stable + * */ @Directive({ selector: '[minlength][formControlName],[minlength][formControl],[minlength][ngModel]', @@ -245,7 +245,7 @@ export const MAX_LENGTH_VALIDATOR: any = { * `formControl`, * or control with `ngModel` that also has a `maxlength` attribute. * - * @stable + * */ @Directive({ selector: '[maxlength][formControlName],[maxlength][formControl],[maxlength][ngModel]', @@ -296,7 +296,7 @@ export const PATTERN_VALIDATOR: any = { * ``` * * ``` - * @stable + * */ @Directive({ selector: '[pattern][formControlName],[pattern][formControl],[pattern][ngModel]', diff --git a/packages/forms/src/form_builder.ts b/packages/forms/src/form_builder.ts index 34c379d6b1..ccb1fd9563 100644 --- a/packages/forms/src/form_builder.ts +++ b/packages/forms/src/form_builder.ts @@ -29,7 +29,7 @@ import {AbstractControl, FormArray, FormControl, FormGroup} from './model'; * * * **NgModule**: `ReactiveFormsModule` * - * @stable + * */ @Injectable() export class FormBuilder { diff --git a/packages/forms/src/form_providers.ts b/packages/forms/src/form_providers.ts index fd2b452a89..586a13b506 100644 --- a/packages/forms/src/form_providers.ts +++ b/packages/forms/src/form_providers.ts @@ -16,7 +16,7 @@ import {FormBuilder} from './form_builder'; /** * The ng module for forms. - * @stable + * */ @NgModule({ declarations: TEMPLATE_DRIVEN_DIRECTIVES, @@ -28,7 +28,7 @@ export class FormsModule { /** * The ng module for reactive forms. - * @stable + * */ @NgModule({ declarations: [REACTIVE_DRIVEN_DIRECTIVES], diff --git a/packages/forms/src/model.ts b/packages/forms/src/model.ts index d75f516a57..71da5b6873 100644 --- a/packages/forms/src/model.ts +++ b/packages/forms/src/model.ts @@ -123,7 +123,7 @@ function isOptionsObj( * @see [Forms Guide](/guide/forms) * @see [Reactive Forms Guide](/guide/reactive-forms) * @see [Dynamic Forms Guide](/guide/dynamic-form) - * @stable + * */ export abstract class AbstractControl { /** @internal */ @@ -735,7 +735,7 @@ export abstract class AbstractControl { * * * **npm package**: `@angular/forms` * - * @stable + * */ export class FormControl extends AbstractControl { /** @internal */ @@ -978,7 +978,7 @@ export class FormControl extends AbstractControl { * * * **npm package**: `@angular/forms` * - * @stable + * */ export class FormGroup extends AbstractControl { constructor( @@ -1314,7 +1314,7 @@ export class FormGroup extends AbstractControl { * * * **npm package**: `@angular/forms` * - * @stable + * */ export class FormArray extends AbstractControl { constructor( diff --git a/packages/forms/src/validators.ts b/packages/forms/src/validators.ts index 9198a76f10..bf432271a2 100644 --- a/packages/forms/src/validators.ts +++ b/packages/forms/src/validators.ts @@ -36,7 +36,7 @@ function isEmptyInputValue(value: any): boolean { * } * ``` * - * @stable + * */ export const NG_VALIDATORS = new InjectionToken>('NgValidators'); @@ -48,7 +48,7 @@ export const NG_VALIDATORS = new InjectionToken>('NgVa * * See `NG_VALIDATORS` for more details. * - * @stable + * */ export const NG_ASYNC_VALIDATORS = new InjectionToken>('NgAsyncValidators'); @@ -68,7 +68,7 @@ const EMAIL_REGEXP = * var loginControl = new FormControl("", Validators.required) * ``` * - * @stable + * */ export class Validators { /** diff --git a/packages/forms/src/version.ts b/packages/forms/src/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/forms/src/version.ts +++ b/packages/forms/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/language-service/src/version.ts b/packages/language-service/src/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/language-service/src/version.ts +++ b/packages/language-service/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/platform-browser-dynamic/src/platform-browser-dynamic.ts b/packages/platform-browser-dynamic/src/platform-browser-dynamic.ts index 654164134a..cd33f06fa6 100644 --- a/packages/platform-browser-dynamic/src/platform-browser-dynamic.ts +++ b/packages/platform-browser-dynamic/src/platform-browser-dynamic.ts @@ -24,7 +24,7 @@ export const RESOURCE_CACHE_PROVIDER: Provider[] = [{provide: ResourceLoader, useClass: CachedResourceLoader, deps: []}]; /** - * @stable + * */ export const platformBrowserDynamic = createPlatformFactory( platformCoreDynamic, 'browserDynamic', INTERNAL_BROWSER_DYNAMIC_PLATFORM_PROVIDERS); diff --git a/packages/platform-browser-dynamic/src/version.ts b/packages/platform-browser-dynamic/src/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/platform-browser-dynamic/src/version.ts +++ b/packages/platform-browser-dynamic/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/platform-browser-dynamic/testing/src/testing.ts b/packages/platform-browser-dynamic/testing/src/testing.ts index 4aca9c2c30..7fe80499b6 100644 --- a/packages/platform-browser-dynamic/testing/src/testing.ts +++ b/packages/platform-browser-dynamic/testing/src/testing.ts @@ -17,7 +17,7 @@ import {platformCoreDynamicTesting} from './platform_core_dynamic_testing'; export * from './private_export_testing'; /** - * @stable + * */ export const platformBrowserDynamicTesting = createPlatformFactory( platformCoreDynamicTesting, 'browserDynamicTesting', @@ -26,7 +26,7 @@ export const platformBrowserDynamicTesting = createPlatformFactory( /** * NgModule for testing. * - * @stable + * */ @NgModule({ exports: [BrowserTestingModule], diff --git a/packages/platform-browser/src/browser.ts b/packages/platform-browser/src/browser.ts index 4ec340c715..7ab1753934 100644 --- a/packages/platform-browser/src/browser.ts +++ b/packages/platform-browser/src/browser.ts @@ -45,7 +45,7 @@ export const BROWSER_SANITIZATION_PROVIDERS: StaticProvider[] = [ ]; /** - * @stable + * */ export const platformBrowser: (extraProviders?: StaticProvider[]) => PlatformRef = createPlatformFactory(platformCore, 'browser', INTERNAL_BROWSER_PLATFORM_PROVIDERS); @@ -66,7 +66,7 @@ export function _document(): any { /** * The ng module for the browser. * - * @stable + * */ @NgModule({ providers: [ diff --git a/packages/platform-browser/src/dom/events/event_manager.ts b/packages/platform-browser/src/dom/events/event_manager.ts index 0a1ae3cd21..3264bdf065 100644 --- a/packages/platform-browser/src/dom/events/event_manager.ts +++ b/packages/platform-browser/src/dom/events/event_manager.ts @@ -11,13 +11,13 @@ import {Inject, Injectable, InjectionToken, NgZone} from '@angular/core'; import {getDOM} from '../dom_adapter'; /** - * @stable + * */ export const EVENT_MANAGER_PLUGINS = new InjectionToken('EventManagerPlugins'); /** - * @stable + * */ @Injectable() export class EventManager { diff --git a/packages/platform-browser/src/security/dom_sanitization_service.ts b/packages/platform-browser/src/security/dom_sanitization_service.ts index 13427ca295..7c2dd51bb5 100644 --- a/packages/platform-browser/src/security/dom_sanitization_service.ts +++ b/packages/platform-browser/src/security/dom_sanitization_service.ts @@ -17,42 +17,42 @@ export {SecurityContext}; /** * Marker interface for a value that's safe to use in a particular context. * - * @stable + * */ export interface SafeValue {} /** * Marker interface for a value that's safe to use as HTML. * - * @stable + * */ export interface SafeHtml extends SafeValue {} /** * Marker interface for a value that's safe to use as style (CSS). * - * @stable + * */ export interface SafeStyle extends SafeValue {} /** * Marker interface for a value that's safe to use as JavaScript. * - * @stable + * */ export interface SafeScript extends SafeValue {} /** * Marker interface for a value that's safe to use as a URL linking to a document. * - * @stable + * */ export interface SafeUrl extends SafeValue {} /** * Marker interface for a value that's safe to use as a URL to load executable code from. * - * @stable + * */ export interface SafeResourceUrl extends SafeValue {} @@ -85,7 +85,7 @@ export interface SafeResourceUrl extends SafeValue {} * into this call. Make sure any user data is appropriately escaped for this security context. * For more detail, see the [Security Guide](http://g.co/ng/security). * - * @stable + * */ export abstract class DomSanitizer implements Sanitizer { /** diff --git a/packages/platform-browser/src/version.ts b/packages/platform-browser/src/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/platform-browser/src/version.ts +++ b/packages/platform-browser/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/platform-browser/testing/src/browser.ts b/packages/platform-browser/testing/src/browser.ts index b9020df987..2ed2e6c194 100644 --- a/packages/platform-browser/testing/src/browser.ts +++ b/packages/platform-browser/testing/src/browser.ts @@ -20,7 +20,7 @@ const _TEST_BROWSER_PLATFORM_PROVIDERS: StaticProvider[] = /** * Platform for testing * - * @stable + * */ export const platformBrowserTesting = createPlatformFactory(platformCore, 'browserTesting', _TEST_BROWSER_PLATFORM_PROVIDERS); @@ -28,7 +28,7 @@ export const platformBrowserTesting = /** * NgModule for testing. * - * @stable + * */ @NgModule({ exports: [BrowserModule], diff --git a/packages/platform-server/src/version.ts b/packages/platform-server/src/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/platform-server/src/version.ts +++ b/packages/platform-server/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/platform-webworker-dynamic/src/version.ts b/packages/platform-webworker-dynamic/src/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/platform-webworker-dynamic/src/version.ts +++ b/packages/platform-webworker-dynamic/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/platform-webworker/src/version.ts b/packages/platform-webworker/src/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/platform-webworker/src/version.ts +++ b/packages/platform-webworker/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/router/src/config.ts b/packages/router/src/config.ts index 3c2e82f29b..b1fe4b1e86 100644 --- a/packages/router/src/config.ts +++ b/packages/router/src/config.ts @@ -251,7 +251,7 @@ import {UrlSegment, UrlSegmentGroup} from './url_tree'; * Then it will extract the set of routes defined in that NgModule, and will transparently add * those routes to the main configuration. * - * @stable use Routes + * use Routes */ export type Routes = Route[]; @@ -296,7 +296,7 @@ export type UrlMatcher = (segments: UrlSegment[], group: UrlSegmentGroup, route: * Represents the static data associated with a particular route. * * See `Routes` for more details. - * @stable + * */ export type Data = { [name: string]: any @@ -308,7 +308,7 @@ export type Data = { * Represents the resolved data associated with a particular route. * * See `Routes` for more details. - * @stable + * */ export type ResolveData = { [name: string]: any @@ -320,7 +320,7 @@ export type ResolveData = { * The type of `loadChildren`. * * See `Routes` for more details. - * @stable + * */ export type LoadChildrenCallback = () => Type| NgModuleFactory| Promise>| Observable>; @@ -331,7 +331,7 @@ export type LoadChildrenCallback = () => * The type of `loadChildren`. * * See `Routes` for more details. - * @stable + * */ export type LoadChildren = string | LoadChildrenCallback; @@ -341,7 +341,7 @@ export type LoadChildren = string | LoadChildrenCallback; * The type of `queryParamsHandling`. * * See `RouterLink` for more details. - * @stable + * */ export type QueryParamsHandling = 'merge' | 'preserve' | ''; @@ -357,7 +357,7 @@ export type RunGuardsAndResolvers = 'paramsChange' | 'paramsOrQueryParamsChange' /** * See `Routes` for more details. - * @stable + * */ export interface Route { path?: string; diff --git a/packages/router/src/directives/router_link.ts b/packages/router/src/directives/router_link.ts index 9529e97c0b..135585702a 100644 --- a/packages/router/src/directives/router_link.ts +++ b/packages/router/src/directives/router_link.ts @@ -88,7 +88,7 @@ import {UrlTree} from '../url_tree'; * * @ngModule RouterModule * - * @stable + * */ @Directive({selector: ':not(a)[routerLink]'}) export class RouterLink { @@ -160,7 +160,7 @@ export class RouterLink { * * @ngModule RouterModule * - * @stable + * */ @Directive({selector: 'a[routerLink]'}) export class RouterLinkWithHref implements OnChanges, OnDestroy { diff --git a/packages/router/src/directives/router_link_active.ts b/packages/router/src/directives/router_link_active.ts index 3aa62c2b5b..f30b66ba4e 100644 --- a/packages/router/src/directives/router_link_active.ts +++ b/packages/router/src/directives/router_link_active.ts @@ -70,7 +70,7 @@ import {RouterLink, RouterLinkWithHref} from './router_link'; * * @ngModule RouterModule * - * @stable + * */ @Directive({ selector: '[routerLinkActive]', diff --git a/packages/router/src/directives/router_outlet.ts b/packages/router/src/directives/router_outlet.ts index f09282faeb..92ea3cd362 100644 --- a/packages/router/src/directives/router_outlet.ts +++ b/packages/router/src/directives/router_outlet.ts @@ -33,7 +33,7 @@ import {PRIMARY_OUTLET} from '../shared'; * ``` * @ngModule RouterModule * - * @stable + * */ @Directive({selector: 'router-outlet', exportAs: 'outlet'}) export class RouterOutlet implements OnDestroy, OnInit { diff --git a/packages/router/src/events.ts b/packages/router/src/events.ts index 3c0ecaea42..72c49ab3a2 100644 --- a/packages/router/src/events.ts +++ b/packages/router/src/events.ts @@ -55,7 +55,7 @@ export class RouterEvent { * * Represents an event triggered when a navigation starts. * - * @stable + * */ export class NavigationStart extends RouterEvent { /** @@ -104,7 +104,7 @@ export class NavigationStart extends RouterEvent { * * Represents an event triggered when a navigation ends successfully. * - * @stable + * */ export class NavigationEnd extends RouterEvent { constructor( @@ -128,7 +128,7 @@ export class NavigationEnd extends RouterEvent { * * Represents an event triggered when a navigation is canceled. * - * @stable + * */ export class NavigationCancel extends RouterEvent { constructor( @@ -150,7 +150,7 @@ export class NavigationCancel extends RouterEvent { * * Represents an event triggered when a navigation fails due to an unexpected error. * - * @stable + * */ export class NavigationError extends RouterEvent { constructor( @@ -174,7 +174,7 @@ export class NavigationError extends RouterEvent { * * Represents an event triggered when routes are recognized. * - * @stable + * */ export class RoutesRecognized extends RouterEvent { constructor( @@ -424,7 +424,7 @@ export class ActivationEnd { * - `NavigationCancel`, * - `NavigationError` * - * @stable + * */ export type Event = RouterEvent | RouteConfigLoadStart | RouteConfigLoadEnd | ChildActivationStart | ChildActivationEnd | ActivationStart | ActivationEnd; diff --git a/packages/router/src/interfaces.ts b/packages/router/src/interfaces.ts index cda64c574b..1d10033c04 100644 --- a/packages/router/src/interfaces.ts +++ b/packages/router/src/interfaces.ts @@ -75,7 +75,7 @@ import {ActivatedRouteSnapshot, RouterStateSnapshot} from './router_state'; * class AppModule {} * ``` * - * @stable + * */ export interface CanActivate { canActivate(route: ActivatedRouteSnapshot, state: RouterStateSnapshot): @@ -155,7 +155,7 @@ export interface CanActivate { * class AppModule {} * ``` * - * @stable + * */ export interface CanActivateChild { canActivateChild(childRoute: ActivatedRouteSnapshot, state: RouterStateSnapshot): @@ -228,7 +228,7 @@ export interface CanActivateChild { * class AppModule {} * ``` * - * @stable + * */ export interface CanDeactivate { canDeactivate( @@ -301,7 +301,7 @@ export interface CanDeactivate { * }) * class AppModule {} * ``` - * @stable + * */ export interface Resolve { resolve(route: ActivatedRouteSnapshot, state: RouterStateSnapshot): Observable|Promise|T; @@ -370,6 +370,6 @@ export interface Resolve { * class AppModule {} * ``` * - * @stable + * */ export interface CanLoad { canLoad(route: Route): Observable|Promise|boolean; } diff --git a/packages/router/src/router.ts b/packages/router/src/router.ts index 0ec50cdfd2..1cf291a4b9 100644 --- a/packages/router/src/router.ts +++ b/packages/router/src/router.ts @@ -34,7 +34,7 @@ import {TreeNode, nodeChildrenAsMap} from './utils/tree'; * * Represents the extra options used during navigation. * - * @stable + * */ export interface NavigationExtras { /** @@ -152,7 +152,7 @@ export interface NavigationExtras { * If the handler throws an exception, the navigation promise will be rejected with * the exception. * - * @stable + * */ export type ErrorHandler = (error: any) => any; @@ -195,7 +195,7 @@ function defaultRouterHook(snapshot: RouterStateSnapshot): Observable { * * @ngModule RouterModule * - * @stable + * */ export class Router { private currentUrlTree: UrlTree; diff --git a/packages/router/src/router_module.ts b/packages/router/src/router_module.ts index 9dbb8ed41a..0d8c252af2 100644 --- a/packages/router/src/router_module.ts +++ b/packages/router/src/router_module.ts @@ -33,7 +33,7 @@ import {flatten} from './utils/collection'; * * Contains a list of directives * - * @stable + * */ const ROUTER_DIRECTIVES = [RouterOutlet, RouterLink, RouterLinkWithHref, RouterLinkActive]; @@ -42,7 +42,7 @@ const ROUTER_DIRECTIVES = [RouterOutlet, RouterLink, RouterLinkWithHref, RouterL * * Is used in DI to configure the router. * - * @stable + * */ export const ROUTER_CONFIGURATION = new InjectionToken('ROUTER_CONFIGURATION'); @@ -125,7 +125,7 @@ export function routerNgProbeToken() { * [Read this developer guide](https://angular.io/docs/ts/latest/guide/router.html) to get an * overview of how the router should be used. * - * @stable + * */ @NgModule({declarations: ROUTER_DIRECTIVES, exports: ROUTER_DIRECTIVES}) export class RouterModule { @@ -213,7 +213,7 @@ export function provideForRootGuard(router: Router): any { * class MyNgModule {} * ``` * - * @stable + * */ export function provideRoutes(routes: Routes): any { return [ @@ -255,7 +255,7 @@ export type InitialNavigation = * * Represents options to configure the router. * - * @stable + * */ export interface ExtraOptions { /** diff --git a/packages/router/src/router_outlet_context.ts b/packages/router/src/router_outlet_context.ts index 58560156ff..789e8fc5b0 100644 --- a/packages/router/src/router_outlet_context.ts +++ b/packages/router/src/router_outlet_context.ts @@ -15,7 +15,7 @@ import {ActivatedRoute} from './router_state'; /** * Store contextual information about a `RouterOutlet` * - * @stable + * */ export class OutletContext { outlet: RouterOutlet|null = null; @@ -28,7 +28,7 @@ export class OutletContext { /** * Store contextual information about the children (= nested) `RouterOutlet` * - * @stable + * */ export class ChildrenOutletContexts { // contexts for child outlets, by name. diff --git a/packages/router/src/router_preloader.ts b/packages/router/src/router_preloader.ts index 73ce802d29..67f4465abe 100644 --- a/packages/router/src/router_preloader.ts +++ b/packages/router/src/router_preloader.ts @@ -67,7 +67,7 @@ export class NoPreloading implements PreloadingStrategy { * * If a route is protected by `canLoad` guards, the preloaded will not load it. * - * @stable + * */ @Injectable() export class RouterPreloader implements OnDestroy { diff --git a/packages/router/src/router_state.ts b/packages/router/src/router_state.ts index aa64ec3720..0afb6870d4 100644 --- a/packages/router/src/router_state.ts +++ b/packages/router/src/router_state.ts @@ -43,7 +43,7 @@ import {Tree, TreeNode} from './utils/tree'; * * See `ActivatedRoute` for more information. * - * @stable + * */ export class RouterState extends Tree { /** @internal */ @@ -102,7 +102,7 @@ export function createEmptyStateSnapshot( * } * ``` * - * @stable + * */ export class ActivatedRoute { /** The current snapshot of this route */ @@ -245,7 +245,7 @@ function flattenInherited(pathFromRoot: ActivatedRouteSnapshot[]): Inherited { * } * ``` * - * @stable + * */ export class ActivatedRouteSnapshot { /** The configuration used to match this route **/ @@ -348,7 +348,7 @@ export class ActivatedRouteSnapshot { * } * ``` * - * @stable + * */ export class RouterStateSnapshot extends Tree { /** @internal */ diff --git a/packages/router/src/shared.ts b/packages/router/src/shared.ts index c4484092ce..c43f7353d9 100644 --- a/packages/router/src/shared.ts +++ b/packages/router/src/shared.ts @@ -15,14 +15,14 @@ import {UrlSegment, UrlSegmentGroup} from './url_tree'; * * Name of the primary outlet. * - * @stable + * */ export const PRIMARY_OUTLET = 'primary'; /** * A collection of parameters. * - * @stable + * */ export type Params = { [key: string]: any @@ -38,7 +38,7 @@ export type Params = { * The API is inspired by the URLSearchParams interface. * see https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams * - * @stable + * */ export interface ParamMap { has(name: string): boolean; @@ -91,7 +91,7 @@ class ParamsAsMap implements ParamMap { /** * Convert a `Params` instance to a `ParamMap`. * - * @stable + * */ export function convertToParamMap(params: Params): ParamMap { return new ParamsAsMap(params); diff --git a/packages/router/src/url_tree.ts b/packages/router/src/url_tree.ts index ae3275a8d3..0b06fd5fc4 100644 --- a/packages/router/src/url_tree.ts +++ b/packages/router/src/url_tree.ts @@ -100,7 +100,7 @@ function containsSegmentGroupHelper( * } * ``` * - * @stable + * */ export class UrlTree { /** @internal */ @@ -133,7 +133,7 @@ export class UrlTree { * * See `UrlTree` for more information. * - * @stable + * */ export class UrlSegmentGroup { /** @internal */ @@ -185,7 +185,7 @@ export class UrlSegmentGroup { * } * ``` * - * @stable + * */ export class UrlSegment { /** @internal */ @@ -245,7 +245,7 @@ export function mapChildrenIntoArray( * * See `DefaultUrlSerializer` for an example of a URL serializer. * - * @stable + * */ export abstract class UrlSerializer { /** Parse a url into a `UrlTree` */ @@ -271,7 +271,7 @@ export abstract class UrlSerializer { * colon syntax to specify the outlet, and the ';parameter=value' syntax (e.g., open=true) to * specify route specific parameters. * - * @stable + * */ export class DefaultUrlSerializer implements UrlSerializer { /** Parses a url into a `UrlTree` */ diff --git a/packages/router/src/version.ts b/packages/router/src/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/router/src/version.ts +++ b/packages/router/src/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/packages/router/testing/src/router_testing_module.ts b/packages/router/testing/src/router_testing_module.ts index 1482329ca9..3ec89852f7 100644 --- a/packages/router/testing/src/router_testing_module.ts +++ b/packages/router/testing/src/router_testing_module.ts @@ -40,7 +40,7 @@ import {ChildrenOutletContexts, ExtraOptions, NoPreloading, PreloadingStrategy, * router.navigateByUrl('/lazy/loaded'); * ``` * - * @stable + * */ @Injectable() export class SpyNgModuleFactoryLoader implements NgModuleFactoryLoader { @@ -86,7 +86,7 @@ function isUrlHandlingStrategy(opts: ExtraOptions | UrlHandlingStrategy): /** * Router setup factory function used for testing. * - * @stable + * */ export function setupTestingRouter( urlSerializer: UrlSerializer, contexts: ChildrenOutletContexts, location: Location, @@ -107,7 +107,7 @@ export function setupTestingRouter( /** * Router setup factory function used for testing. * - * @stable + * */ export function setupTestingRouter( urlSerializer: UrlSerializer, contexts: ChildrenOutletContexts, location: Location, @@ -153,7 +153,7 @@ export function setupTestingRouter( * }); * ``` * - * @stable + * */ @NgModule({ exports: [RouterModule], diff --git a/packages/upgrade/src/common/angular1.ts b/packages/upgrade/src/common/angular1.ts index d7047dde68..88183f2ba7 100644 --- a/packages/upgrade/src/common/angular1.ts +++ b/packages/upgrade/src/common/angular1.ts @@ -262,7 +262,7 @@ export function getAngularLib(): any { * * Used when AngularJS is loaded lazily, and not available on `window`. * - * @stable + * */ export function setAngularJSGlobal(ng: any): void { angular = ng; @@ -272,7 +272,7 @@ export function setAngularJSGlobal(ng: any): void { /** * Returns the current AngularJS global. * - * @stable + * */ export function getAngularJSGlobal(): any { return angular; diff --git a/packages/upgrade/src/common/version.ts b/packages/upgrade/src/common/version.ts index 19db5be5a5..0957b61dc8 100644 --- a/packages/upgrade/src/common/version.ts +++ b/packages/upgrade/src/common/version.ts @@ -14,6 +14,6 @@ import {Version} from '@angular/core'; /** - * @stable + * */ export const VERSION = new Version('0.0.0-PLACEHOLDER'); diff --git a/tools/public_api_guard/common/common.d.ts b/tools/public_api_guard/common/common.d.ts index 74e2e81370..0ba2b7ba56 100644 --- a/tools/public_api_guard/common/common.d.ts +++ b/tools/public_api_guard/common/common.d.ts @@ -1,7 +1,5 @@ -/** @stable */ export declare const APP_BASE_HREF: InjectionToken; -/** @stable */ export declare class AsyncPipe implements OnDestroy, PipeTransform { constructor(_ref: ChangeDetectorRef); ngOnDestroy(): void; @@ -11,41 +9,34 @@ export declare class AsyncPipe implements OnDestroy, PipeTransform { transform(obj: null): null; } -/** @stable */ export declare class CommonModule { } -/** @stable */ export declare class CurrencyPipe implements PipeTransform { constructor(_locale: string); transform(value: any, currencyCode?: string, display?: 'code' | 'symbol' | 'symbol-narrow' | string | boolean, digitsInfo?: string, locale?: string): string | null; } -/** @stable */ export declare class DatePipe implements PipeTransform { constructor(locale: string); transform(value: any, format?: string, timezone?: string, locale?: string): string | null; } -/** @stable */ export declare class DecimalPipe implements PipeTransform { constructor(_locale: string); transform(value: any, digitsInfo?: string, locale?: string): string | null; } -/** @stable */ export declare class DeprecatedCurrencyPipe implements PipeTransform { constructor(_locale: string); transform(value: any, currencyCode?: string, symbolDisplay?: boolean, digits?: string): string | null; } -/** @stable */ export declare class DeprecatedDatePipe implements PipeTransform { constructor(_locale: string); transform(value: any, pattern?: string): string | null; } -/** @stable */ export declare class DeprecatedDecimalPipe implements PipeTransform { constructor(_locale: string); transform(value: any, digits?: string): string | null; @@ -55,25 +46,19 @@ export declare class DeprecatedDecimalPipe implements PipeTransform { export declare class DeprecatedI18NPipesModule { } -/** @stable */ export declare class DeprecatedPercentPipe implements PipeTransform { constructor(_locale: string); transform(value: any, digits?: string): string | null; } -/** @stable */ export declare const DOCUMENT: InjectionToken; -/** @stable */ export declare function formatCurrency(value: number, locale: string, currency: string, currencyCode?: string, digitsInfo?: string): string; -/** @stable */ export declare function formatDate(value: string | number | Date, format: string, locale: string, timezone?: string): string; -/** @stable */ export declare function formatNumber(value: number, locale: string, digitsInfo?: string): string; -/** @stable */ export declare function formatPercent(value: number, locale: string, digitsInfo?: string): string; /** @experimental */ @@ -147,7 +132,6 @@ export declare function getLocaleWeekEndRange(locale: string): [WeekDay, WeekDay /** @experimental */ export declare function getNumberOfCurrencyDigits(code: string): number; -/** @stable */ export declare class HashLocationStrategy extends LocationStrategy { constructor(_platformLocation: PlatformLocation, _baseHref?: string); back(): void; @@ -187,12 +171,10 @@ export declare function isPlatformWorkerApp(platformId: Object): boolean; /** @experimental */ export declare function isPlatformWorkerUi(platformId: Object): boolean; -/** @stable */ export declare class JsonPipe implements PipeTransform { transform(value: any): string; } -/** @stable */ export declare class Location { constructor(platformStrategy: LocationStrategy); back(): void; @@ -223,7 +205,6 @@ export interface LocationChangeListener { (e: LocationChangeEvent): any; } -/** @stable */ export declare abstract class LocationStrategy { abstract back(): void; abstract forward(): void; @@ -235,12 +216,10 @@ export declare abstract class LocationStrategy { abstract replaceState(state: any, title: string, url: string, queryParams: string): void; } -/** @stable */ export declare class LowerCasePipe implements PipeTransform { transform(value: string): string; } -/** @stable */ export declare class NgClass implements DoCheck { klass: string; ngClass: string | string[] | Set | { @@ -261,7 +240,6 @@ export declare class NgComponentOutlet implements OnChanges, OnDestroy { ngOnDestroy(): void; } -/** @stable */ export declare class NgForOf implements DoCheck, OnChanges { ngForOf: NgIterable; ngForTemplate: TemplateRef>; @@ -271,7 +249,6 @@ export declare class NgForOf implements DoCheck, OnChanges { ngOnChanges(changes: SimpleChanges): void; } -/** @stable */ export declare class NgForOfContext { $implicit: T; count: number; @@ -284,7 +261,6 @@ export declare class NgForOfContext { constructor($implicit: T, ngForOf: NgIterable, index: number, count: number); } -/** @stable */ export declare class NgIf { ngIf: any; ngIfElse: TemplateRef | null; @@ -292,7 +268,6 @@ export declare class NgIf { constructor(_viewContainer: ViewContainerRef, templateRef: TemplateRef); } -/** @stable */ export declare class NgIfContext { $implicit: any; ngIf: any; @@ -325,7 +300,6 @@ export declare class NgPluralCase { constructor(value: string, template: TemplateRef, viewContainer: ViewContainerRef, ngPlural: NgPlural); } -/** @stable */ export declare class NgStyle implements DoCheck { ngStyle: { [key: string]: string; @@ -334,24 +308,20 @@ export declare class NgStyle implements DoCheck { ngDoCheck(): void; } -/** @stable */ export declare class NgSwitch { ngSwitch: any; } -/** @stable */ export declare class NgSwitchCase implements DoCheck { ngSwitchCase: any; constructor(viewContainer: ViewContainerRef, templateRef: TemplateRef, ngSwitch: NgSwitch); ngDoCheck(): void; } -/** @stable */ export declare class NgSwitchDefault { constructor(viewContainer: ViewContainerRef, templateRef: TemplateRef, ngSwitch: NgSwitch); } -/** @stable */ export declare class NgTemplateOutlet implements OnChanges { ngTemplateOutlet: TemplateRef; ngTemplateOutletContext: Object; @@ -385,7 +355,6 @@ export declare enum NumberSymbol { CurrencyGroup = 13, } -/** @stable */ export declare class PathLocationStrategy extends LocationStrategy { constructor(_platformLocation: PlatformLocation, href?: string); back(): void; @@ -398,13 +367,11 @@ export declare class PathLocationStrategy extends LocationStrategy { replaceState(state: any, title: string, url: string, queryParams: string): void; } -/** @stable */ export declare class PercentPipe implements PipeTransform { constructor(_locale: string); transform(value: any, digitsInfo?: string, locale?: string): string | null; } -/** @stable */ export declare abstract class PlatformLocation { readonly abstract hash: string; readonly abstract pathname: string; @@ -439,7 +406,6 @@ export interface PopStateEvent { /** @experimental */ export declare function registerLocaleData(data: any, localeId?: string | any, extraData?: any): void; -/** @stable */ export declare class SlicePipe implements PipeTransform { transform(value: any, start: number, end?: number): any; } @@ -450,7 +416,6 @@ export declare type Time = { minutes: number; }; -/** @stable */ export declare class TitleCasePipe implements PipeTransform { transform(value: string): string; } @@ -463,12 +428,10 @@ export declare enum TranslationWidth { Short = 3, } -/** @stable */ export declare class UpperCasePipe implements PipeTransform { transform(value: string): string; } -/** @stable */ export declare const VERSION: Version; /** @experimental */ diff --git a/tools/public_api_guard/common/http.d.ts b/tools/public_api_guard/common/http.d.ts index fd066926af..3c3aad3ad8 100644 --- a/tools/public_api_guard/common/http.d.ts +++ b/tools/public_api_guard/common/http.d.ts @@ -1,12 +1,9 @@ -/** @stable */ export declare const HTTP_INTERCEPTORS: InjectionToken; -/** @stable */ export declare abstract class HttpBackend implements HttpHandler { abstract handle(req: HttpRequest): Observable>; } -/** @stable */ export declare class HttpClient { constructor(handler: HttpHandler); delete(url: string, options?: { @@ -1478,15 +1475,12 @@ export declare class HttpClient { }): Observable; } -/** @stable */ export declare class HttpClientJsonpModule { } -/** @stable */ export declare class HttpClientModule { } -/** @stable */ export declare class HttpClientXsrfModule { static disable(): ModuleWithProviders; static withOptions(options?: { @@ -1495,13 +1489,11 @@ export declare class HttpClientXsrfModule { }): ModuleWithProviders; } -/** @stable */ export interface HttpDownloadProgressEvent extends HttpProgressEvent { partialText?: string; type: HttpEventType.DownloadProgress; } -/** @stable */ export declare class HttpErrorResponse extends HttpResponseBase implements Error { readonly error: any | null; readonly message: string; @@ -1516,10 +1508,8 @@ export declare class HttpErrorResponse extends HttpResponseBase implements Error }); } -/** @stable */ export declare type HttpEvent = HttpSentEvent | HttpHeaderResponse | HttpResponse | HttpProgressEvent | HttpUserEvent; -/** @stable */ export declare enum HttpEventType { Sent = 0, UploadProgress = 1, @@ -1529,12 +1519,10 @@ export declare enum HttpEventType { User = 5, } -/** @stable */ export declare abstract class HttpHandler { abstract handle(req: HttpRequest): Observable>; } -/** @stable */ export declare class HttpHeaderResponse extends HttpResponseBase { readonly type: HttpEventType.ResponseHeader; constructor(init?: { @@ -1551,7 +1539,6 @@ export declare class HttpHeaderResponse extends HttpResponseBase { }): HttpHeaderResponse; } -/** @stable */ export declare class HttpHeaders { constructor(headers?: string | { [name: string]: string | string[]; @@ -1565,12 +1552,10 @@ export declare class HttpHeaders { set(name: string, value: string | string[]): HttpHeaders; } -/** @stable */ export interface HttpInterceptor { intercept(req: HttpRequest, next: HttpHandler): Observable>; } -/** @stable */ export interface HttpParameterCodec { decodeKey(key: string): string; decodeValue(value: string): string; @@ -1578,7 +1563,6 @@ export interface HttpParameterCodec { encodeValue(value: string): string; } -/** @stable */ export declare class HttpParams { constructor(options?: HttpParamsOptions); append(param: string, value: string): HttpParams; @@ -1591,14 +1575,12 @@ export declare class HttpParams { toString(): string; } -/** @stable */ export interface HttpProgressEvent { loaded: number; total?: number; type: HttpEventType.DownloadProgress | HttpEventType.UploadProgress; } -/** @stable */ export declare class HttpRequest { readonly body: T | null; readonly headers: HttpHeaders; @@ -1667,7 +1649,6 @@ export declare class HttpRequest { serializeBody(): ArrayBuffer | Blob | FormData | string | null; } -/** @stable */ export declare class HttpResponse extends HttpResponseBase { readonly body: T | null; readonly type: HttpEventType.Response; @@ -1694,7 +1675,6 @@ export declare class HttpResponse extends HttpResponseBase { }): HttpResponse; } -/** @stable */ export declare abstract class HttpResponseBase { readonly headers: HttpHeaders; readonly ok: boolean; @@ -1710,12 +1690,10 @@ export declare abstract class HttpResponseBase { }, defaultStatus?: number, defaultStatusText?: string); } -/** @stable */ export interface HttpSentEvent { type: HttpEventType.Sent; } -/** @stable */ export declare class HttpUrlEncodingCodec implements HttpParameterCodec { decodeKey(k: string): string; decodeValue(v: string): string; @@ -1723,35 +1701,29 @@ export declare class HttpUrlEncodingCodec implements HttpParameterCodec { encodeValue(v: string): string; } -/** @stable */ export interface HttpUserEvent { type: HttpEventType.User; } -/** @stable */ export declare class HttpXhrBackend implements HttpBackend { constructor(xhrFactory: XhrFactory); handle(req: HttpRequest): Observable>; } -/** @stable */ export declare abstract class HttpXsrfTokenExtractor { abstract getToken(): string | null; } -/** @stable */ export declare class JsonpClientBackend implements HttpBackend { constructor(callbackMap: JsonpCallbackContext, document: any); handle(req: HttpRequest): Observable>; } -/** @stable */ export declare class JsonpInterceptor { constructor(jsonp: JsonpClientBackend); intercept(req: HttpRequest, next: HttpHandler): Observable>; } -/** @stable */ export declare abstract class XhrFactory { abstract build(): XMLHttpRequest; } diff --git a/tools/public_api_guard/common/http/testing.d.ts b/tools/public_api_guard/common/http/testing.d.ts index 6614e8f1dc..7387dc1486 100644 --- a/tools/public_api_guard/common/http/testing.d.ts +++ b/tools/public_api_guard/common/http/testing.d.ts @@ -1,8 +1,6 @@ -/** @stable */ export declare class HttpClientTestingModule { } -/** @stable */ export declare abstract class HttpTestingController { abstract expectNone(url: string, description?: string): void; abstract expectNone(params: RequestMatch, description?: string): void; @@ -18,13 +16,11 @@ export declare abstract class HttpTestingController { }): void; } -/** @stable */ export interface RequestMatch { method?: string; url?: string; } -/** @stable */ export declare class TestRequest { readonly cancelled: boolean; request: HttpRequest; diff --git a/tools/public_api_guard/common/testing.d.ts b/tools/public_api_guard/common/testing.d.ts index e20ffe3687..187fbd044b 100644 --- a/tools/public_api_guard/common/testing.d.ts +++ b/tools/public_api_guard/common/testing.d.ts @@ -1,4 +1,3 @@ -/** @stable */ export declare class MockLocationStrategy extends LocationStrategy { internalBaseHref: string; internalPath: string; diff --git a/tools/public_api_guard/core/core.d.ts b/tools/public_api_guard/core/core.d.ts index f803756993..e1234003b7 100644 --- a/tools/public_api_guard/core/core.d.ts +++ b/tools/public_api_guard/core/core.d.ts @@ -1,19 +1,15 @@ -/** @stable */ export interface AfterContentChecked { ngAfterContentChecked(): void; } -/** @stable */ export interface AfterContentInit { ngAfterContentInit(): void; } -/** @stable */ export interface AfterViewChecked { ngAfterViewChecked(): void; } -/** @stable */ export interface AfterViewInit { ngAfterViewInit(): void; } @@ -42,7 +38,6 @@ export declare class ApplicationModule { constructor(appRef: ApplicationRef); } -/** @stable */ export declare class ApplicationRef { readonly componentTypes: Type[]; readonly components: ComponentRef[]; @@ -60,16 +55,13 @@ export declare function asNativeElements(debugEls: DebugElement[]): any; /** @experimental */ export declare function assertPlatform(requiredToken: any): PlatformRef; -/** @stable */ export declare const Attribute: AttributeDecorator; -/** @stable */ export declare enum ChangeDetectionStrategy { OnPush = 0, Default = 1, } -/** @stable */ export declare abstract class ChangeDetectorRef { abstract checkNoChanges(): void; abstract detach(): void; @@ -78,7 +70,6 @@ export declare abstract class ChangeDetectorRef { abstract reattach(): void; } -/** @stable */ export interface ClassProvider extends ClassSansProvider { multi?: boolean; provide: any; @@ -88,7 +79,6 @@ export interface ClassProvider extends ClassSansProvider { export interface CollectionChangeRecord extends IterableChangeRecord { } -/** @stable */ export declare class Compiler { clearCache(): void; clearCacheFor(type: Type): void; @@ -115,16 +105,13 @@ export declare type CompilerOptions = { preserveWhitespaces?: boolean; }; -/** @stable */ export declare const Component: ComponentDecorator; -/** @stable */ export interface ComponentDecorator { - /** @stable */ (obj: Component): TypeDecorator; + (obj: Component): TypeDecorator; new (obj: Component): Component; } -/** @stable */ export declare abstract class ComponentFactory { readonly abstract componentType: Type; readonly abstract inputs: { @@ -140,13 +127,11 @@ export declare abstract class ComponentFactory { abstract create(injector: Injector, projectableNodes?: any[][], rootSelectorOrNode?: string | any, ngModule?: NgModuleRef): ComponentRef; } -/** @stable */ export declare abstract class ComponentFactoryResolver { abstract resolveComponentFactory(component: Type): ComponentFactory; static NULL: ComponentFactoryResolver; } -/** @stable */ export declare abstract class ComponentRef { readonly abstract changeDetectorRef: ChangeDetectorRef; readonly abstract componentType: Type; @@ -158,12 +143,10 @@ export declare abstract class ComponentRef { abstract onDestroy(callback: Function): void; } -/** @stable */ export declare const ContentChild: ContentChildDecorator; -/** @stable */ export interface ContentChildDecorator { - /** @stable */ (selector: Type | Function | string, opts?: { + (selector: Type | Function | string, opts?: { read?: any; }): any; new (selector: Type | Function | string, opts?: { @@ -171,12 +154,10 @@ export interface ContentChildDecorator { }): ContentChild; } -/** @stable */ export declare const ContentChildren: ContentChildrenDecorator; -/** @stable */ export interface ContentChildrenDecorator { - /** @stable */ (selector: Type | Function | string, opts?: { + (selector: Type | Function | string, opts?: { descendants?: boolean; read?: any; }): any; @@ -195,7 +176,6 @@ export declare function createPlatform(injector: Injector): PlatformRef; /** @experimental */ export declare function createPlatformFactory(parentPlatformFactory: ((extraProviders?: StaticProvider[]) => PlatformRef) | null, name: string, providers?: StaticProvider[]): (extraProviders?: StaticProvider[]) => PlatformRef; -/** @stable */ export declare const CUSTOM_ELEMENTS_SCHEMA: SchemaMetadata; /** @experimental */ @@ -276,23 +256,19 @@ export declare function defineInjector(options: { /** @experimental */ export declare function destroyPlatform(): void; -/** @stable */ export declare const Directive: DirectiveDecorator; -/** @stable */ export interface DirectiveDecorator { - /** @stable */ (obj: Directive): TypeDecorator; + (obj: Directive): TypeDecorator; new (obj: Directive): Directive; } -/** @stable */ export interface DoCheck { ngDoCheck(): void; } -/** @stable */ export declare class ElementRef { - /** @stable */ nativeElement: T; + nativeElement: T; constructor(nativeElement: T); } @@ -302,15 +278,12 @@ export declare abstract class EmbeddedViewRef extends ViewRef { readonly abstract rootNodes: any[]; } -/** @stable */ export declare function enableProdMode(): void; -/** @stable */ export declare class ErrorHandler { handleError(error: any): void; } -/** @stable */ export declare class EventEmitter extends Subject { __isAsync: boolean; constructor(isAsync?: boolean); @@ -318,13 +291,11 @@ export declare class EventEmitter extends Subject { subscribe(generatorOrNext?: any, error?: any, complete?: any): any; } -/** @stable */ export interface ExistingProvider extends ExistingSansProvider { multi?: boolean; provide: any; } -/** @stable */ export interface FactoryProvider extends FactorySansProvider { multi?: boolean; provide: any; @@ -353,19 +324,15 @@ export interface GetTestability { findTestabilityInTree(registry: TestabilityRegistry, elem: any, findInAncestors: boolean): Testability | null; } -/** @stable */ export declare const Host: HostDecorator; -/** @stable */ export declare const HostBinding: HostBindingDecorator; -/** @stable */ export interface HostDecorator { - /** @stable */ (): any; + (): any; new (): Host; } -/** @stable */ export declare const HostListener: HostListenerDecorator; /** @experimental */ @@ -373,15 +340,12 @@ export declare function inject(token: Type | InjectionToken, notFoundVa export declare function inject(token: Type | InjectionToken, notFoundValue: T, flags?: InjectFlags): T; export declare function inject(token: Type | InjectionToken, notFoundValue: null, flags?: InjectFlags): T | null; -/** @stable */ export declare const Inject: InjectDecorator; -/** @stable */ export declare const Injectable: InjectableDecorator; -/** @stable */ export interface InjectableDecorator { - /** @stable */ (): any; + (): any; (options?: { providedIn: Type | 'root' | null; } & InjectableProvider): any; @@ -405,20 +369,17 @@ export interface InjectableType extends Type { ngInjectableDef: InjectableDef; } -/** @stable */ export interface InjectDecorator { - /** @stable */ (token: any): any; + (token: any): any; new (token: any): Inject; } -/** @stable */ export declare const enum InjectFlags { Default = 0, SkipSelf = 1, Self = 2, } -/** @stable */ export declare class InjectionToken { protected _desc: string; readonly ngInjectableDef: InjectableDef | undefined; @@ -429,7 +390,6 @@ export declare class InjectionToken { toString(): string; } -/** @stable */ export declare abstract class Injector { abstract get(token: Type | InjectionToken, notFoundValue?: T, flags?: InjectFlags): T; /** @deprecated */ abstract get(token: any, notFoundValue?: any): any; @@ -465,13 +425,11 @@ export interface InjectorTypeWithProviders { providers?: (Type | ValueProvider | ExistingProvider | FactoryProvider | ConstructorProvider | StaticClassProvider | ClassProvider | any[])[]; } -/** @stable */ export declare const Input: InputDecorator; /** @experimental */ export declare function isDevMode(): boolean; -/** @stable */ export interface IterableChangeRecord { readonly currentIndex: number | null; readonly item: V; @@ -479,7 +437,6 @@ export interface IterableChangeRecord { readonly trackById: any; } -/** @stable */ export interface IterableChanges { forEachAddedItem(fn: (record: IterableChangeRecord) => void): void; forEachIdentityChange(fn: (record: IterableChangeRecord) => void): void; @@ -490,18 +447,15 @@ export interface IterableChanges { forEachRemovedItem(fn: (record: IterableChangeRecord) => void): void; } -/** @stable */ export interface IterableDiffer { diff(object: NgIterable): IterableChanges | null; } -/** @stable */ export interface IterableDifferFactory { create(trackByFn?: TrackByFunction): IterableDiffer; supports(objects: any): boolean; } -/** @stable */ export declare class IterableDiffers { /** @deprecated */ factories: IterableDifferFactory[]; constructor(factories: IterableDifferFactory[]); @@ -510,14 +464,12 @@ export declare class IterableDiffers { static extend(factories: IterableDifferFactory[]): StaticProvider; } -/** @stable */ export interface KeyValueChangeRecord { readonly currentValue: V | null; readonly key: K; readonly previousValue: V | null; } -/** @stable */ export interface KeyValueChanges { forEachAddedItem(fn: (r: KeyValueChangeRecord) => void): void; forEachChangedItem(fn: (r: KeyValueChangeRecord) => void): void; @@ -526,7 +478,6 @@ export interface KeyValueChanges { forEachRemovedItem(fn: (r: KeyValueChangeRecord) => void): void; } -/** @stable */ export interface KeyValueDiffer { diff(object: Map): KeyValueChanges; diff(object: { @@ -534,13 +485,11 @@ export interface KeyValueDiffer { }): KeyValueChanges; } -/** @stable */ export interface KeyValueDifferFactory { create(): KeyValueDiffer; supports(objects: any): boolean; } -/** @stable */ export declare class KeyValueDiffers { /** @deprecated */ factories: KeyValueDifferFactory[]; constructor(factories: KeyValueDifferFactory[]); @@ -566,16 +515,13 @@ export declare class ModuleWithComponentFactories { constructor(ngModuleFactory: NgModuleFactory, componentFactories: ComponentFactory[]); } -/** @stable */ export interface ModuleWithProviders { ngModule: Type; providers?: Provider[]; } -/** @stable */ export declare type NgIterable = Array | Iterable; -/** @stable */ export declare const NgModule: NgModuleDecorator; /** @experimental */ @@ -584,12 +530,10 @@ export declare abstract class NgModuleFactory { abstract create(parentInjector: Injector | null): NgModuleRef; } -/** @stable */ export declare abstract class NgModuleFactoryLoader { abstract load(path: string): Promise>; } -/** @stable */ export declare abstract class NgModuleRef { readonly abstract componentFactoryResolver: ComponentFactoryResolver; readonly abstract injector: Injector; @@ -629,40 +573,32 @@ export declare class NgZone { /** @experimental */ export declare const NO_ERRORS_SCHEMA: SchemaMetadata; -/** @stable */ export interface OnChanges { ngOnChanges(changes: SimpleChanges): void; } -/** @stable */ export interface OnDestroy { ngOnDestroy(): void; } -/** @stable */ export interface OnInit { ngOnInit(): void; } -/** @stable */ export declare const Optional: OptionalDecorator; -/** @stable */ export interface OptionalDecorator { - /** @stable */ (): any; + (): any; new (): Optional; } -/** @stable */ export declare const Output: OutputDecorator; /** @experimental */ export declare const PACKAGE_ROOT_URL: InjectionToken; -/** @stable */ export declare const Pipe: PipeDecorator; -/** @stable */ export interface PipeTransform { transform(value: any, ...args: any[]): any; } @@ -676,11 +612,10 @@ export declare const PLATFORM_INITIALIZER: InjectionToken<(() => void)[]>; /** @experimental */ export declare const platformCore: (extraProviders?: StaticProvider[] | undefined) => PlatformRef; -/** @stable */ export declare class PlatformRef { readonly destroyed: boolean; readonly injector: Injector; - /** @stable */ bootstrapModule(moduleType: Type, compilerOptions?: (CompilerOptions & BootstrapOptions) | Array): Promise>; + bootstrapModule(moduleType: Type, compilerOptions?: (CompilerOptions & BootstrapOptions) | Array): Promise>; /** @experimental */ bootstrapModuleFactory(moduleFactory: NgModuleFactory, options?: BootstrapOptions): Promise>; destroy(): void; onDestroy(callback: () => void): void; @@ -691,14 +626,11 @@ export interface Predicate { (value: T): boolean; } -/** @stable */ export declare type Provider = TypeProvider | ValueProvider | ClassProvider | ExistingProvider | FactoryProvider | any[]; -/** @stable */ export declare abstract class Query { } -/** @stable */ export declare class QueryList { readonly changes: Observable; readonly dirty: boolean; @@ -851,7 +783,6 @@ export declare abstract class RootRenderer { abstract renderComponent(componentType: RenderComponentType): Renderer; } -/** @stable */ export declare abstract class Sanitizer { abstract sanitize(context: SecurityContext, value: {} | string | null): string | null; } @@ -861,7 +792,6 @@ export interface SchemaMetadata { name: string; } -/** @stable */ export declare enum SecurityContext { NONE = 0, HTML = 1, @@ -871,19 +801,16 @@ export declare enum SecurityContext { RESOURCE_URL = 5, } -/** @stable */ export declare const Self: SelfDecorator; -/** @stable */ export interface SelfDecorator { - /** @stable */ (): any; + (): any; new (): Self; } /** @experimental */ export declare function setTestabilityGetter(getter: GetTestability): void; -/** @stable */ export declare class SimpleChange { currentValue: any; firstChange: boolean; @@ -892,21 +819,17 @@ export declare class SimpleChange { isFirstChange(): boolean; } -/** @stable */ export interface SimpleChanges { [propName: string]: SimpleChange; } -/** @stable */ export declare const SkipSelf: SkipSelfDecorator; -/** @stable */ export interface SkipSelfDecorator { - /** @stable */ (): any; + (): any; new (): SkipSelf; } -/** @stable */ export declare type StaticProvider = ValueProvider | ExistingProvider | StaticClassProvider | ConstructorProvider | FactoryProvider | any[]; /** @experimental */ @@ -921,7 +844,6 @@ export declare abstract class SystemJsNgModuleLoaderConfig { factoryPathSuffix: string; } -/** @stable */ export declare abstract class TemplateRef { readonly abstract elementRef: ElementRef; abstract createEmbeddedView(context: C): EmbeddedViewRef; @@ -950,7 +872,6 @@ export declare class TestabilityRegistry { unregisterApplication(token: any): void; } -/** @stable */ export interface TrackByFunction { (index: number, item: T): any; } @@ -961,26 +882,21 @@ export declare const TRANSLATIONS: InjectionToken; /** @experimental */ export declare const TRANSLATIONS_FORMAT: InjectionToken; -/** @stable */ export declare const Type: FunctionConstructor; -/** @stable */ export interface TypeDecorator { (target: Object, propertyKey?: string | symbol, parameterIndex?: number): void; >(type: T): T; } -/** @stable */ export interface TypeProvider extends Type { } -/** @stable */ export interface ValueProvider extends ValueSansProvider { multi?: boolean; provide: any; } -/** @stable */ export declare class Version { full: string; readonly major: string; @@ -989,15 +905,12 @@ export declare class Version { constructor(full: string); } -/** @stable */ export declare const VERSION: Version; -/** @stable */ export declare const ViewChild: ViewChildDecorator; -/** @stable */ export interface ViewChildDecorator { - /** @stable */ (selector: Type | Function | string, opts?: { + (selector: Type | Function | string, opts?: { read?: any; }): any; new (selector: Type | Function | string, opts?: { @@ -1005,12 +918,10 @@ export interface ViewChildDecorator { }): ViewChild; } -/** @stable */ export declare const ViewChildren: ViewChildrenDecorator; -/** @stable */ export interface ViewChildrenDecorator { - /** @stable */ (selector: Type | Function | string, opts?: { + (selector: Type | Function | string, opts?: { read?: any; }): any; new (selector: Type | Function | string, opts?: { @@ -1018,7 +929,6 @@ export interface ViewChildrenDecorator { }): ViewChildren; } -/** @stable */ export declare abstract class ViewContainerRef { readonly abstract element: ElementRef; readonly abstract injector: Injector; @@ -1035,21 +945,18 @@ export declare abstract class ViewContainerRef { abstract remove(index?: number): void; } -/** @stable */ export declare enum ViewEncapsulation { Emulated = 0, Native = 1, None = 2, } -/** @stable */ export declare abstract class ViewRef extends ChangeDetectorRef { readonly abstract destroyed: boolean; abstract destroy(): void; abstract onDestroy(callback: Function): any; } -/** @stable */ export declare class WrappedValue { /** @deprecated */ wrapped: any; constructor(value: any); diff --git a/tools/public_api_guard/core/testing.d.ts b/tools/public_api_guard/core/testing.d.ts index b5fcd428c9..b25ae5069d 100644 --- a/tools/public_api_guard/core/testing.d.ts +++ b/tools/public_api_guard/core/testing.d.ts @@ -1,10 +1,8 @@ -/** @stable */ export declare function async(fn: Function): (done: any) => any; /** @experimental */ export declare function cleanupDocument(): void; -/** @stable */ export declare class ComponentFixture { changeDetectorRef: ChangeDetectorRef; componentInstance: T; @@ -47,7 +45,6 @@ export declare function flushMicrotasks(): void; /** @experimental */ export declare function getTestBed(): TestBed; -/** @stable */ export declare function inject(tokens: any[], fn: Function): () => any; /** @experimental */ @@ -66,7 +63,6 @@ export declare type MetadataOverride = { /** @experimental */ export declare function resetFakeAsyncZone(): void; -/** @stable */ export declare class TestBed implements Injector { ngModule: Type | Type[]; platform: PlatformRef; diff --git a/tools/public_api_guard/forms/forms.d.ts b/tools/public_api_guard/forms/forms.d.ts index f9b72df3cc..dcb2921f8e 100644 --- a/tools/public_api_guard/forms/forms.d.ts +++ b/tools/public_api_guard/forms/forms.d.ts @@ -1,4 +1,3 @@ -/** @stable */ export declare abstract class AbstractControl { asyncValidator: AsyncValidatorFn | null; readonly dirty: boolean; @@ -64,7 +63,6 @@ export declare abstract class AbstractControl { }): void; } -/** @stable */ export declare abstract class AbstractControlDirective { readonly abstract control: AbstractControl | null; readonly dirty: boolean | null; @@ -94,7 +92,6 @@ export interface AbstractControlOptions { validators?: ValidatorFn | ValidatorFn[] | null; } -/** @stable */ export declare class AbstractFormGroupDirective extends ControlContainer implements OnInit, OnDestroy { readonly asyncValidator: AsyncValidatorFn | null; readonly control: FormGroup; @@ -110,12 +107,10 @@ export interface AsyncValidator extends Validator { validate(c: AbstractControl): Promise | Observable; } -/** @stable */ export interface AsyncValidatorFn { (c: AbstractControl): Promise | Observable; } -/** @stable */ export declare class CheckboxControlValueAccessor implements ControlValueAccessor { onChange: (_: any) => void; onTouched: () => void; @@ -134,14 +129,12 @@ export declare class CheckboxRequiredValidator extends RequiredValidator { /** @experimental */ export declare const COMPOSITION_BUFFER_MODE: InjectionToken; -/** @stable */ export declare abstract class ControlContainer extends AbstractControlDirective { readonly formDirective: Form | null; name: string; readonly path: string[] | null; } -/** @stable */ export interface ControlValueAccessor { registerOnChange(fn: any): void; registerOnTouched(fn: any): void; @@ -149,7 +142,6 @@ export interface ControlValueAccessor { writeValue(obj: any): void; } -/** @stable */ export declare class DefaultValueAccessor implements ControlValueAccessor { onChange: (_: any) => void; onTouched: () => void; @@ -167,7 +159,6 @@ export declare class EmailValidator implements Validator { validate(c: AbstractControl): ValidationErrors | null; } -/** @stable */ export interface Form { addControl(dir: NgControl): void; addFormGroup(dir: AbstractFormGroupDirective): void; @@ -178,7 +169,6 @@ export interface Form { updateModel(dir: NgControl, value: any): void; } -/** @stable */ export declare class FormArray extends AbstractControl { controls: AbstractControl[]; readonly length: number; @@ -203,7 +193,6 @@ export declare class FormArray extends AbstractControl { }): void; } -/** @stable */ export declare class FormArrayName extends ControlContainer implements OnInit, OnDestroy { readonly asyncValidator: AsyncValidatorFn | null; readonly control: FormArray; @@ -216,7 +205,6 @@ export declare class FormArrayName extends ControlContainer implements OnInit, O ngOnInit(): void; } -/** @stable */ export declare class FormBuilder { array(controlsConfig: any[], validator?: ValidatorFn | ValidatorFn[] | null, asyncValidator?: AsyncValidatorFn | AsyncValidatorFn[] | null): FormArray; control(formState: any, validator?: ValidatorFn | ValidatorFn[] | null, asyncValidator?: AsyncValidatorFn | AsyncValidatorFn[] | null): FormControl; @@ -227,7 +215,6 @@ export declare class FormBuilder { } | null): FormGroup; } -/** @stable */ export declare class FormControl extends AbstractControl { constructor(formState?: any, validatorOrOpts?: ValidatorFn | ValidatorFn[] | AbstractControlOptions | null, asyncValidator?: AsyncValidatorFn | AsyncValidatorFn[] | null); patchValue(value: any, options?: { @@ -250,7 +237,6 @@ export declare class FormControl extends AbstractControl { }): void; } -/** @stable */ export declare class FormControlDirective extends NgControl implements OnChanges { readonly asyncValidator: AsyncValidatorFn | null; readonly control: FormControl; @@ -266,7 +252,6 @@ export declare class FormControlDirective extends NgControl implements OnChanges viewToModelUpdate(newValue: any): void; } -/** @stable */ export declare class FormControlName extends NgControl implements OnChanges, OnDestroy { readonly asyncValidator: AsyncValidatorFn; readonly control: FormControl; @@ -283,7 +268,6 @@ export declare class FormControlName extends NgControl implements OnChanges, OnD viewToModelUpdate(newValue: any): void; } -/** @stable */ export declare class FormGroup extends AbstractControl { controls: { [key: string]: AbstractControl; @@ -315,7 +299,6 @@ export declare class FormGroup extends AbstractControl { }): void; } -/** @stable */ export declare class FormGroupDirective extends ControlContainer implements Form, OnChanges { readonly control: FormGroup; directives: FormControlName[]; @@ -341,17 +324,14 @@ export declare class FormGroupDirective extends ControlContainer implements Form updateModel(dir: FormControlName, value: any): void; } -/** @stable */ export declare class FormGroupName extends AbstractFormGroupDirective implements OnInit, OnDestroy { name: string; constructor(parent: ControlContainer, validators: any[], asyncValidators: any[]); } -/** @stable */ export declare class FormsModule { } -/** @stable */ export declare class MaxLengthValidator implements Validator, OnChanges { maxlength: string; ngOnChanges(changes: SimpleChanges): void; @@ -359,7 +339,6 @@ export declare class MaxLengthValidator implements Validator, OnChanges { validate(c: AbstractControl): ValidationErrors | null; } -/** @stable */ export declare class MinLengthValidator implements Validator, OnChanges { minlength: string; ngOnChanges(changes: SimpleChanges): void; @@ -367,16 +346,12 @@ export declare class MinLengthValidator implements Validator, OnChanges { validate(c: AbstractControl): ValidationErrors | null; } -/** @stable */ export declare const NG_ASYNC_VALIDATORS: InjectionToken<(Function | Validator)[]>; -/** @stable */ export declare const NG_VALIDATORS: InjectionToken<(Function | Validator)[]>; -/** @stable */ export declare const NG_VALUE_ACCESSOR: InjectionToken; -/** @stable */ export declare abstract class NgControl extends AbstractControlDirective { readonly asyncValidator: AsyncValidatorFn | null; name: string | null; @@ -385,17 +360,14 @@ export declare abstract class NgControl extends AbstractControlDirective { abstract viewToModelUpdate(newValue: any): void; } -/** @stable */ export declare class NgControlStatus extends AbstractControlStatus { constructor(cd: NgControl); } -/** @stable */ export declare class NgControlStatusGroup extends AbstractControlStatus { constructor(cd: ControlContainer); } -/** @stable */ export declare class NgForm extends ControlContainer implements Form, AfterViewInit { readonly control: FormGroup; readonly controls: { @@ -426,7 +398,6 @@ export declare class NgForm extends ControlContainer implements Form, AfterViewI updateModel(dir: NgControl, value: any): void; } -/** @stable */ export declare class NgModel extends NgControl implements OnChanges, OnDestroy { readonly asyncValidator: AsyncValidatorFn | null; readonly control: FormControl; @@ -449,13 +420,11 @@ export declare class NgModel extends NgControl implements OnChanges, OnDestroy { viewToModelUpdate(newValue: any): void; } -/** @stable */ export declare class NgModelGroup extends AbstractFormGroupDirective implements OnInit, OnDestroy { name: string; constructor(parent: ControlContainer, validators: any[], asyncValidators: any[]); } -/** @stable */ export declare class NgSelectOption implements OnDestroy { id: string; ngValue: any; @@ -464,7 +433,6 @@ export declare class NgSelectOption implements OnDestroy { ngOnDestroy(): void; } -/** @stable */ export declare class PatternValidator implements Validator, OnChanges { pattern: string | RegExp; ngOnChanges(changes: SimpleChanges): void; @@ -472,7 +440,6 @@ export declare class PatternValidator implements Validator, OnChanges { validate(c: AbstractControl): ValidationErrors | null; } -/** @stable */ export declare class RadioControlValueAccessor implements ControlValueAccessor, OnDestroy, OnInit { formControlName: string; name: string; @@ -489,20 +456,17 @@ export declare class RadioControlValueAccessor implements ControlValueAccessor, writeValue(value: any): void; } -/** @stable */ export declare class ReactiveFormsModule { static withConfig(opts: { warnOnNgModelWithFormControl: 'never' | 'once' | 'always'; }): ModuleWithProviders; } -/** @stable */ export declare class RequiredValidator implements Validator { required: boolean | string; registerOnValidatorChange(fn: () => void): void; validate(c: AbstractControl): ValidationErrors | null; } -/** @stable */ export declare class SelectControlValueAccessor implements ControlValueAccessor { compareWith: (o1: any, o2: any) => boolean; onChange: (_: any) => void; @@ -515,7 +479,6 @@ export declare class SelectControlValueAccessor implements ControlValueAccessor writeValue(value: any): void; } -/** @stable */ export declare class SelectMultipleControlValueAccessor implements ControlValueAccessor { compareWith: (o1: any, o2: any) => boolean; onChange: (_: any) => void; @@ -533,18 +496,15 @@ export declare type ValidationErrors = { [key: string]: any; }; -/** @stable */ export interface Validator { registerOnValidatorChange?(fn: () => void): void; validate(c: AbstractControl): ValidationErrors | null; } -/** @stable */ export interface ValidatorFn { (c: AbstractControl): ValidationErrors | null; } -/** @stable */ export declare class Validators { static compose(validators: (ValidatorFn | null | undefined)[]): ValidatorFn | null; static compose(validators: null): null; @@ -560,5 +520,4 @@ export declare class Validators { static requiredTrue(control: AbstractControl): ValidationErrors | null; } -/** @stable */ export declare const VERSION: Version; diff --git a/tools/public_api_guard/platform-browser-dynamic/platform-browser-dynamic.d.ts b/tools/public_api_guard/platform-browser-dynamic/platform-browser-dynamic.d.ts index 1b02d8e0e5..6fa4010bc1 100644 --- a/tools/public_api_guard/platform-browser-dynamic/platform-browser-dynamic.d.ts +++ b/tools/public_api_guard/platform-browser-dynamic/platform-browser-dynamic.d.ts @@ -3,11 +3,9 @@ export declare class JitCompilerFactory implements CompilerFactory { createCompiler(options?: CompilerOptions[]): Compiler; } -/** @stable */ export declare const platformBrowserDynamic: (extraProviders?: StaticProvider[] | undefined) => PlatformRef; /** @experimental */ export declare const RESOURCE_CACHE_PROVIDER: Provider[]; -/** @stable */ export declare const VERSION: Version; diff --git a/tools/public_api_guard/platform-browser-dynamic/testing.d.ts b/tools/public_api_guard/platform-browser-dynamic/testing.d.ts index 86bfad1dfe..7e0f94e022 100644 --- a/tools/public_api_guard/platform-browser-dynamic/testing.d.ts +++ b/tools/public_api_guard/platform-browser-dynamic/testing.d.ts @@ -1,6 +1,4 @@ -/** @stable */ export declare class BrowserDynamicTestingModule { } -/** @stable */ export declare const platformBrowserDynamicTesting: (extraProviders?: StaticProvider[] | undefined) => PlatformRef; diff --git a/tools/public_api_guard/platform-browser/platform-browser.d.ts b/tools/public_api_guard/platform-browser/platform-browser.d.ts index 5fb21c9625..4c4d8afca5 100644 --- a/tools/public_api_guard/platform-browser/platform-browser.d.ts +++ b/tools/public_api_guard/platform-browser/platform-browser.d.ts @@ -1,4 +1,3 @@ -/** @stable */ export declare class BrowserModule { constructor(parentModule: BrowserModule); /** @experimental */ static withServerTransition(params: { @@ -23,7 +22,6 @@ export declare function disableDebugTools(): void; /** @deprecated */ export declare const DOCUMENT: InjectionToken; -/** @stable */ export declare abstract class DomSanitizer implements Sanitizer { abstract bypassSecurityTrustHtml(value: string): SafeHtml; abstract bypassSecurityTrustResourceUrl(value: string): SafeResourceUrl; @@ -36,10 +34,8 @@ export declare abstract class DomSanitizer implements Sanitizer { /** @experimental */ export declare function enableDebugTools(ref: ComponentRef): ComponentRef; -/** @stable */ export declare const EVENT_MANAGER_PLUGINS: InjectionToken; -/** @stable */ export declare class EventManager { constructor(plugins: EventManagerPlugin[], _zone: NgZone); addEventListener(element: HTMLElement, eventName: string, handler: Function): Function; @@ -99,30 +95,23 @@ export declare type MetaDefinition = { [prop: string]: string; }; -/** @stable */ export declare const platformBrowser: (extraProviders?: StaticProvider[]) => PlatformRef; -/** @stable */ export interface SafeHtml extends SafeValue { } -/** @stable */ export interface SafeResourceUrl extends SafeValue { } -/** @stable */ export interface SafeScript extends SafeValue { } -/** @stable */ export interface SafeStyle extends SafeValue { } -/** @stable */ export interface SafeUrl extends SafeValue { } -/** @stable */ export interface SafeValue { } @@ -148,5 +137,4 @@ export declare class TransferState { toJson(): string; } -/** @stable */ export declare const VERSION: Version; diff --git a/tools/public_api_guard/platform-browser/testing.d.ts b/tools/public_api_guard/platform-browser/testing.d.ts index 102040b559..15ef7eaa5b 100644 --- a/tools/public_api_guard/platform-browser/testing.d.ts +++ b/tools/public_api_guard/platform-browser/testing.d.ts @@ -1,6 +1,4 @@ -/** @stable */ export declare class BrowserTestingModule { } -/** @stable */ export declare const platformBrowserTesting: (extraProviders?: StaticProvider[] | undefined) => PlatformRef; diff --git a/tools/public_api_guard/platform-server/platform-server.d.ts b/tools/public_api_guard/platform-server/platform-server.d.ts index bc25795a0f..26505af030 100644 --- a/tools/public_api_guard/platform-server/platform-server.d.ts +++ b/tools/public_api_guard/platform-server/platform-server.d.ts @@ -45,5 +45,4 @@ export declare class ServerModule { export declare class ServerTransferStateModule { } -/** @stable */ export declare const VERSION: Version; diff --git a/tools/public_api_guard/platform-webworker-dynamic/platform-webworker-dynamic.d.ts b/tools/public_api_guard/platform-webworker-dynamic/platform-webworker-dynamic.d.ts index a51be8b680..d0ceddb3c0 100644 --- a/tools/public_api_guard/platform-webworker-dynamic/platform-webworker-dynamic.d.ts +++ b/tools/public_api_guard/platform-webworker-dynamic/platform-webworker-dynamic.d.ts @@ -1,5 +1,4 @@ /** @experimental */ export declare const platformWorkerAppDynamic: (extraProviders?: StaticProvider[] | undefined) => PlatformRef; -/** @stable */ export declare const VERSION: Version; diff --git a/tools/public_api_guard/platform-webworker/platform-webworker.d.ts b/tools/public_api_guard/platform-webworker/platform-webworker.d.ts index 76a2717c52..c239f471cf 100644 --- a/tools/public_api_guard/platform-webworker/platform-webworker.d.ts +++ b/tools/public_api_guard/platform-webworker/platform-webworker.d.ts @@ -78,7 +78,6 @@ export declare class UiArguments { constructor(method: string, args?: FnArg[] | undefined); } -/** @stable */ export declare const VERSION: Version; /** @experimental */ diff --git a/tools/public_api_guard/router/router.d.ts b/tools/public_api_guard/router/router.d.ts index 7fa17a655e..34a80a4878 100644 --- a/tools/public_api_guard/router/router.d.ts +++ b/tools/public_api_guard/router/router.d.ts @@ -1,4 +1,3 @@ -/** @stable */ export declare class ActivatedRoute { readonly children: ActivatedRoute[]; component: Type | string | null; @@ -19,7 +18,6 @@ export declare class ActivatedRoute { toString(): string; } -/** @stable */ export declare class ActivatedRouteSnapshot { readonly children: ActivatedRouteSnapshot[]; component: Type | string | null; @@ -55,22 +53,18 @@ export declare class ActivationStart { toString(): string; } -/** @stable */ export interface CanActivate { canActivate(route: ActivatedRouteSnapshot, state: RouterStateSnapshot): Observable | Promise | boolean; } -/** @stable */ export interface CanActivateChild { canActivateChild(childRoute: ActivatedRouteSnapshot, state: RouterStateSnapshot): Observable | Promise | boolean; } -/** @stable */ export interface CanDeactivate { canDeactivate(component: T, currentRoute: ActivatedRouteSnapshot, currentState: RouterStateSnapshot, nextState?: RouterStateSnapshot): Observable | Promise | boolean; } -/** @stable */ export interface CanLoad { canLoad(route: Route): Observable | Promise | boolean; } @@ -91,7 +85,6 @@ export declare class ChildActivationStart { toString(): string; } -/** @stable */ export declare class ChildrenOutletContexts { getContext(childName: string): OutletContext | null; getOrCreateContext(childName: string): OutletContext; @@ -101,15 +94,12 @@ export declare class ChildrenOutletContexts { onOutletReAttached(contexts: Map): void; } -/** @stable */ export declare function convertToParamMap(params: Params): ParamMap; -/** @stable */ export declare type Data = { [name: string]: any; }; -/** @stable */ export declare class DefaultUrlSerializer implements UrlSerializer { parse(url: string): UrlTree; serialize(tree: UrlTree): string; @@ -118,10 +108,8 @@ export declare class DefaultUrlSerializer implements UrlSerializer { /** @experimental */ export declare type DetachedRouteHandle = {}; -/** @stable */ export declare type Event = RouterEvent | RouteConfigLoadStart | RouteConfigLoadEnd | ChildActivationStart | ChildActivationEnd | ActivationStart | ActivationEnd; -/** @stable */ export interface ExtraOptions { enableTracing?: boolean; errorHandler?: ErrorHandler; @@ -158,13 +146,10 @@ export declare class GuardsCheckStart extends RouterEvent { toString(): string; } -/** @stable */ export declare type LoadChildren = string | LoadChildrenCallback; -/** @stable */ export declare type LoadChildrenCallback = () => Type | NgModuleFactory | Promise> | Observable>; -/** @stable */ export declare class NavigationCancel extends RouterEvent { reason: string; constructor( @@ -174,7 +159,6 @@ export declare class NavigationCancel extends RouterEvent { toString(): string; } -/** @stable */ export declare class NavigationEnd extends RouterEvent { urlAfterRedirects: string; constructor( @@ -184,7 +168,6 @@ export declare class NavigationEnd extends RouterEvent { toString(): string; } -/** @stable */ export declare class NavigationError extends RouterEvent { error: any; constructor( @@ -194,7 +177,6 @@ export declare class NavigationError extends RouterEvent { toString(): string; } -/** @stable */ export interface NavigationExtras { fragment?: string; preserveFragment?: boolean; @@ -206,7 +188,6 @@ export interface NavigationExtras { skipLocationChange?: boolean; } -/** @stable */ export declare class NavigationStart extends RouterEvent { navigationTrigger?: 'imperative' | 'popstate' | 'hashchange'; restoredState?: { @@ -227,7 +208,6 @@ export declare class NoPreloading implements PreloadingStrategy { preload(route: Route, fn: () => Observable): Observable; } -/** @stable */ export declare class OutletContext { attachRef: ComponentRef | null; children: ChildrenOutletContexts; @@ -236,7 +216,6 @@ export declare class OutletContext { route: ActivatedRoute | null; } -/** @stable */ export interface ParamMap { readonly keys: string[]; get(name: string): string | null; @@ -244,7 +223,6 @@ export interface ParamMap { has(name: string): boolean; } -/** @stable */ export declare type Params = { [key: string]: any; }; @@ -259,18 +237,14 @@ export declare abstract class PreloadingStrategy { abstract preload(route: Route, fn: () => Observable): Observable; } -/** @stable */ export declare const PRIMARY_OUTLET = "primary"; -/** @stable */ export declare function provideRoutes(routes: Routes): any; -/** @stable */ export interface Resolve { resolve(route: ActivatedRouteSnapshot, state: RouterStateSnapshot): Observable | Promise | T; } -/** @stable */ export declare type ResolveData = { [name: string]: any; }; @@ -299,7 +273,6 @@ export declare class ResolveStart extends RouterEvent { toString(): string; } -/** @stable */ export interface Route { canActivate?: any[]; canActivateChild?: any[]; @@ -334,7 +307,6 @@ export declare class RouteConfigLoadStart { toString(): string; } -/** @stable */ export declare class Router { config: Routes; errorHandler: ErrorHandler; @@ -360,7 +332,6 @@ export declare class Router { setUpLocationChangeListener(): void; } -/** @stable */ export declare const ROUTER_CONFIGURATION: InjectionToken; /** @experimental */ @@ -384,7 +355,6 @@ export declare class RouterEvent { url: string); } -/** @stable */ export declare class RouterLink { fragment: string; preserveFragment: boolean; @@ -401,7 +371,6 @@ export declare class RouterLink { onClick(): boolean; } -/** @stable */ export declare class RouterLinkActive implements OnChanges, OnDestroy, AfterContentInit { readonly isActive: boolean; links: QueryList; @@ -416,7 +385,6 @@ export declare class RouterLinkActive implements OnChanges, OnDestroy, AfterCont ngOnDestroy(): void; } -/** @stable */ export declare class RouterLinkWithHref implements OnChanges, OnDestroy { fragment: string; href: string; @@ -437,14 +405,12 @@ export declare class RouterLinkWithHref implements OnChanges, OnDestroy { onClick(button: number, ctrlKey: boolean, metaKey: boolean, shiftKey: boolean): boolean; } -/** @stable */ export declare class RouterModule { constructor(guard: any, router: Router); static forChild(routes: Routes): ModuleWithProviders; static forRoot(routes: Routes, config?: ExtraOptions): ModuleWithProviders; } -/** @stable */ export declare class RouterOutlet implements OnDestroy, OnInit { activateEvents: EventEmitter; readonly activatedRoute: ActivatedRoute; @@ -463,7 +429,6 @@ export declare class RouterOutlet implements OnDestroy, OnInit { ngOnInit(): void; } -/** @stable */ export declare class RouterPreloader implements OnDestroy { constructor(router: Router, moduleLoader: NgModuleFactoryLoader, compiler: Compiler, injector: Injector, preloadingStrategy: PreloadingStrategy); ngOnDestroy(): void; @@ -471,25 +436,21 @@ export declare class RouterPreloader implements OnDestroy { setUpPreloading(): void; } -/** @stable */ export declare class RouterState extends Tree { snapshot: RouterStateSnapshot; toString(): string; } -/** @stable */ export declare class RouterStateSnapshot extends Tree { url: string; toString(): string; } -/** @stable */ export declare type Routes = Route[]; /** @experimental */ export declare const ROUTES: InjectionToken; -/** @stable */ export declare class RoutesRecognized extends RouterEvent { state: RouterStateSnapshot; urlAfterRedirects: string; @@ -522,7 +483,6 @@ export declare type UrlMatchResult = { }; }; -/** @stable */ export declare class UrlSegment { readonly parameterMap: ParamMap; parameters: { @@ -537,7 +497,6 @@ export declare class UrlSegment { toString(): string; } -/** @stable */ export declare class UrlSegmentGroup { children: { [key: string]: UrlSegmentGroup; @@ -554,13 +513,11 @@ export declare class UrlSegmentGroup { toString(): string; } -/** @stable */ export declare abstract class UrlSerializer { abstract parse(url: string): UrlTree; abstract serialize(tree: UrlTree): string; } -/** @stable */ export declare class UrlTree { fragment: string | null; readonly queryParamMap: ParamMap; @@ -571,5 +528,4 @@ export declare class UrlTree { toString(): string; } -/** @stable */ export declare const VERSION: Version; diff --git a/tools/public_api_guard/router/testing.d.ts b/tools/public_api_guard/router/testing.d.ts index e7877cdc2d..d401d5a72d 100644 --- a/tools/public_api_guard/router/testing.d.ts +++ b/tools/public_api_guard/router/testing.d.ts @@ -1,13 +1,10 @@ -/** @stable */ export declare class RouterTestingModule { static withRoutes(routes: Routes, config?: ExtraOptions): ModuleWithProviders; } -/** @stable */ export declare function setupTestingRouter(urlSerializer: UrlSerializer, contexts: ChildrenOutletContexts, location: Location, loader: NgModuleFactoryLoader, compiler: Compiler, injector: Injector, routes: Route[][], opts?: ExtraOptions, urlHandlingStrategy?: UrlHandlingStrategy): Router; export declare function setupTestingRouter(urlSerializer: UrlSerializer, contexts: ChildrenOutletContexts, location: Location, loader: NgModuleFactoryLoader, compiler: Compiler, injector: Injector, routes: Route[][], urlHandlingStrategy?: UrlHandlingStrategy): Router; -/** @stable */ export declare class SpyNgModuleFactoryLoader implements NgModuleFactoryLoader { stubbedModules: { [path: string]: any; diff --git a/tools/public_api_guard/upgrade/static.d.ts b/tools/public_api_guard/upgrade/static.d.ts index 3ff9b4b9a0..435cfbd851 100644 --- a/tools/public_api_guard/upgrade/static.d.ts +++ b/tools/public_api_guard/upgrade/static.d.ts @@ -13,13 +13,11 @@ export declare function downgradeInjectable(token: any): Function; /** @experimental */ export declare function downgradeModule(moduleFactoryOrBootstrapFn: NgModuleFactory | ((extraProviders: StaticProvider[]) => Promise>)): string; -/** @stable */ export declare function getAngularJSGlobal(): any; /** @deprecated */ export declare function getAngularLib(): any; -/** @stable */ export declare function setAngularJSGlobal(ng: any): void; /** @deprecated */ @@ -45,5 +43,4 @@ export declare class UpgradeModule { bootstrap(element: Element, modules?: string[], config?: any): void; } -/** @stable */ export declare const VERSION: Version; diff --git a/tools/public_api_guard/upgrade/upgrade.d.ts b/tools/public_api_guard/upgrade/upgrade.d.ts index 070da46ff9..17f4b857b4 100644 --- a/tools/public_api_guard/upgrade/upgrade.d.ts +++ b/tools/public_api_guard/upgrade/upgrade.d.ts @@ -21,5 +21,4 @@ export declare class UpgradeAdapterRef { ready(fn: (upgradeAdapterRef: UpgradeAdapterRef) => void): void; } -/** @stable */ export declare const VERSION: Version;