docs: remove all deprecated @stable jsdoc tags (#23210)

These are no longer needed as stable docs are computed as those that
do not have `@experimental` or `@deprecated` tags.

PR Close #23210

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');

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<any>): Observable<HttpEvent<any>>;
@@ -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<any>): Observable<HttpEvent<any>>;

packages/common/http/src/client.ts

@@ -43,7 +43,7 @@ function addBody<T>(
 }
 
 /**
- * @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 {

packages/common/http/src/headers.ts

@@ -14,7 +14,7 @@ interface Update {
 
 /**
  * Immutable set of Http headers, with lazy parsing.
- * @stable
+ *
  */
 export class HttpHeaders {
   /**

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<HttpInterceptor[]>('HTTP_INTERCEPTORS');
 

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 {

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: [

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<string, string[]>|null;

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<T> {
   /**

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<T> { type: HttpEventType.User; }
 
@@ -118,7 +118,7 @@ export interface HttpUserEvent<T> { 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<T> =
     HttpSentEvent | HttpHeaderResponse | HttpResponse<T>| HttpProgressEvent | HttpUserEvent<T>;
@@ -138,7 +138,7 @@ export type HttpEvent<T> =
 /**
  * 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<T> extends HttpResponseBase {
   /**
@@ -297,7 +297,7 @@ export class HttpResponse<T> 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';

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 {

packages/common/http/src/xsrf.ts

@@ -21,7 +21,7 @@ export const XSRF_HEADER_NAME = new InjectionToken<string>('XSRF_HEADER_NAME');
 /**
  * Retrieves the current XSRF token to use with the next outgoing request.
  *
- * @stable
+ *
  */
 export abstract class HttpXsrfTokenExtractor {
   /**

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 {
   /**

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 {

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: [

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 {
   /**

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],

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 {

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<T> {
   constructor(
@@ -93,7 +93,7 @@ export class NgForOfContext<T> {
  * See a [live demo](http://plnkr.co/edit/KVuXxDp0qinGDyo307QW?p=preview) for a more detailed
  * example.
  *
- * @stable
+ *
  */
 @Directive({selector: '[ngFor][ngForOf]'})
 export class NgForOf<T> implements DoCheck, OnChanges {

packages/common/src/directives/ng_if.ts

@@ -96,7 +96,7 @@ import {Directive, EmbeddedViewRef, Input, TemplateRef, ViewContainerRef, ɵstri
  * <ng-template #elseBlock>...</ng-template>
  * ```
  *
- * @stable
+ *
  */
 @Directive({selector: '[ngIf]'})
 export class NgIf {
@@ -159,7 +159,7 @@ export class NgIf {
 }
 
 /**
- * @stable
+ *
  */
 export class NgIfContext {
   public $implicit: any = null;

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 `.<unit>` 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 {

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 {

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 {

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<Document>('DocumentToken');

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 {

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);

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 {

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 {

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<string>('appBaseHref');

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 {

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;

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 {

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 {

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})

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 {

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 {

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 {

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 {

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})

packages/common/src/version.ts

@@ -14,6 +14,6 @@
 
 import {Version} from '@angular/core';
 /**
- * @stable
+ *
  */
 export const VERSION = new Version('0.0.0-PLACEHOLDER');

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 {

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');

packages/compiler/src/version.ts

@@ -14,6 +14,6 @@
 
 import {Version} from './util';
 /**
- * @stable
+ *
  */
 export const VERSION = new Version('0.0.0-PLACEHOLDER');

packages/core/src/application_ref.ts

@@ -41,7 +41,7 @@ export const ALLOW_MULTIPLE_PLATFORMS = new InjectionToken<boolean>('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<M>(
       moduleType: Type<M>, compilerOptions: (CompilerOptions&BootstrapOptions)|
@@ -359,7 +359,7 @@ function optionsReducer<T extends Object>(dst: any, objs: T | T[]): T {
 /**
  * A reference to an Angular application running on a page.
  *
- * @stable
+ *
  */
 @Injectable()
 export class ApplicationRef {

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) {}

packages/core/src/change_detection/change_detector_ref.ts

@@ -7,7 +7,7 @@
  */
 
 /**
- * @stable
+ *
  */
 export abstract class ChangeDetectorRef {
   /**

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 {
   /**

packages/core/src/change_detection/differs/default_iterable_differ.ts

@@ -558,7 +558,7 @@ export class DefaultIterableDiffer<V> implements IterableDiffer<V>, IterableChan
 }
 
 /**
- * @stable
+ *
  */
 export class IterableChangeRecord_<V> implements IterableChangeRecord<V> {
   currentIndex: number|null = null;

packages/core/src/change_detection/differs/default_keyvalue_differ.ts

@@ -261,7 +261,7 @@ export class DefaultKeyValueDiffer<K, V> implements KeyValueDiffer<K, V>, KeyVal
 
 
 /**
- * @stable
+ *
  */
 class KeyValueChangeRecord_<K, V> implements KeyValueChangeRecord<K, V> {
   previousValue: V|null = null;

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<T> = Array<T>| Iterable<T>;
 
@@ -21,7 +21,7 @@ export type NgIterable<T> = Array<T>| Iterable<T>;
  * 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<V> {
   /**
@@ -38,7 +38,7 @@ export interface IterableDiffer<V> {
  * An object describing the changes in the `Iterable` collection since last time
  * `IterableDiffer#diff()` was invoked.
  *
- * @stable
+ *
  */
 export interface IterableChanges<V> {
   /**
@@ -91,7 +91,7 @@ export interface IterableChanges<V> {
 /**
  * Record representing the item change information.
  *
- * @stable
+ *
  */
 export interface IterableChangeRecord<V> {
   /** Current index of the item in `Iterable` or null if removed. */
@@ -116,14 +116,14 @@ export interface CollectionChangeRecord<V> extends IterableChangeRecord<V> {}
  * 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<T> { (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 {
   /**

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<K, V> {
   /**
@@ -40,7 +40,7 @@ export interface KeyValueDiffer<K, V> {
  * An object describing the changes in the `Map` or `{[k:string]: string}` since last time
  * `KeyValueDiffer#diff()` was invoked.
  *
- * @stable
+ *
  */
 export interface KeyValueChanges<K, V> {
   /**
@@ -74,7 +74,7 @@ export interface KeyValueChanges<K, V> {
 /**
  * Record representing the item change information.
  *
- * @stable
+ *
  */
 export interface KeyValueChangeRecord<K, V> {
   /**
@@ -96,7 +96,7 @@ export interface KeyValueChangeRecord<K, V> {
 /**
  * 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 {
   /**

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; }

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<any>| 'root' | null}&InjectableProvider): any;
@@ -113,7 +113,7 @@ export function convertInjectableProviderToFactory(
 /**
 * Injectable decorator and metadata.
 *
-* @stable
+*
 * @Annotation
 */
 export const Injectable: InjectableDecorator = makeDecorator(

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<T> {
   /** @internal */

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<T>(objWithPropertyToExtract: T): string {
 /**
  * Injection flags for DI.
  *
- * @stable
+ *
  */
 export const enum InjectFlags {
   Default = 0,

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');

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<any> {}
 
@@ -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[];

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<any>| Function, params: any[][]): Error {
   const signature: string[] = [];
@@ -218,7 +218,7 @@ export function noAnnotationError(typeOrFunc: Type<any>| Function, params: any[]
  *
  * expect(() => injector.getAt(100)).toThrowError();
  * ```
- * @stable
+ *
  */
 export function outOfBoundsError(index: number) {
   return Error(`Index ${index} is out-of-bounds.`);

packages/core/src/error_handler.ts

@@ -34,7 +34,7 @@ import {ERROR_ORIGINAL_ERROR, getDebugContext, getErrorLogger, getOriginalError}
  * class MyModule {}
  * ```
  *
- * @stable
+ *
  */
 export class ErrorHandler {
   /**

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<T> extends Subject<T> {
   // TODO: mark this as internal once all the facades are gone

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 {

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<C> {
   /**
@@ -65,7 +65,7 @@ export abstract class ComponentRef<C> {
 }
 
 /**
- * @stable
+ *
  */
 export abstract class ComponentFactory<C> {
   abstract get selector(): string;

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();

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<T = any> {
    *    web worker.
    *   </p>
    * </div>
-   * @stable
+   *
    */
   public nativeElement: T;
 

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<T> {
   /**

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<NgModuleFactory<any>>;

packages/core/src/linker/query_list.ts

@@ -34,7 +34,7 @@ import {getSymbolIterator} from '../util';
  *   @ViewChildren(Item) items:QueryList<Item>;
  * }
  * ```
- * @stable
+ *
  */
 export class QueryList<T>/* implements Iterable<T> */ {
   public readonly dirty = true;

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<C> {
   /**

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 {
   /**

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 {
   /**

packages/core/src/metadata/di.ts

@@ -49,7 +49,7 @@ export const ANALYZE_FOR_ENTRY_COMPONENTS = new InjectionToken<any>('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<any>|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<any>|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<any>|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<any>|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(

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 =

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; }

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<any>;
@@ -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(

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 {
   /**

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;

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;
 

packages/core/src/util/decorators.ts

@@ -19,7 +19,7 @@ import {Type} from '../type';
  * @ng.Component({...})
  * class MyClass {...}
  * ```
- * @stable
+ *
  */
 export interface TypeDecorator {
   /**

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');

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;

packages/core/testing/src/async_fallback.ts

@@ -29,7 +29,7 @@ const _global = <any>(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'

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<T> {
   /**

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();

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 {
   /**

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 */

packages/forms/src/directives/checkbox_value_accessor.ts

@@ -24,7 +24,7 @@ export const CHECKBOX_VALUE_ACCESSOR: any = {
  *  <input type="checkbox" name="rememberLogin" ngModel>
  *  ```
  *
- *  @stable
+ *
  */
 @Directive({
   selector:

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;

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<ControlValueAccessor>('NgValueAccessor');

packages/forms/src/directives/default_value_accessor.ts

@@ -40,7 +40,7 @@ export const COMPOSITION_BUFFER_MODE = new InjectionToken<boolean>('CompositionE
  *  <input type="text" name="searchQuery" ngModel>
  *  ```
  *
- *  @stable
+ *
  */
 @Directive({
   selector:

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 {
   /**

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 */

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:

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]',

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])',

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 {

packages/forms/src/directives/radio_control_value_accessor.ts

@@ -81,7 +81,7 @@ export class RadioControlRegistry {
  *
  *  * **npm package**: `@angular/forms`
  *
- *  @stable
+ *
  */
 @Directive({
   selector:

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'})
 

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 {

packages/forms/src/directives/reactive_directives/form_group_directive.ts

@@ -56,7 +56,7 @@ export const formDirectiveProvider: any = {
  *
  * **NgModule**: `ReactiveFormsModule`
  *
- *  @stable
+ *
  */
 @Directive({
   selector: '[formGroup]',

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 {