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
This commit is contained in:
Pete Bacon Darwin 2018-04-05 22:31:44 +01:00 committed by Igor Minar
parent ee145790d7
commit 4b96a58c5a
155 changed files with 363 additions and 643 deletions

View File

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

View File

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

View File

@ -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 {

View File

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

View File

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

View File

@ -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 {

View File

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

View File

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

View File

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

View File

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

View File

@ -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 {

View File

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

View File

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

View File

@ -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 {

View File

@ -18,7 +18,7 @@ import {HttpClientTestingBackend} from './backend';
*
* Inject `HttpTestingController` to expect and flush requests in your tests.
*
* @stable
*
*/
@NgModule({
imports: [

View File

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

View File

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

View File

@ -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 {

View File

@ -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 {

View File

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

View File

@ -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 {

View File

@ -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 {

View File

@ -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 {

View File

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

View File

@ -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 {

View File

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

View File

@ -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 {

View File

@ -40,7 +40,7 @@ export interface PopStateEvent {
*
* ### Example
* {@example common/location/ts/path_location_component.ts region='LocationComponent'}
* @stable
*
*/
@Injectable()
export class Location {

View File

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

View File

@ -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 {

View File

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

View File

@ -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 {

View File

@ -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 {

View File

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

View File

@ -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 {

View File

@ -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 {

View File

@ -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 {

View File

@ -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 {

View File

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

View File

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

View File

@ -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 {

View File

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

View File

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

View File

@ -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 {

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@ -33,6 +33,6 @@
*
* Invoking `{{ 'ok' | repeat:3 }}` in a template produces `okokok`.
*
* @stable
*
*/
export interface PipeTransform { transform(value: any, ...args: any[]): any; }

View File

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

View File

@ -46,7 +46,7 @@ import {InjectableDef, defineInjectable} from './defs';
*
* {@example core/di/ts/injector_spec.ts region='InjectionToken'}
*
* @stable
*
*/
export class InjectionToken<T> {
/** @internal */

View File

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

View File

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

View File

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

View File

@ -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.`);

View File

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

View File

@ -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

View File

@ -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 {

View File

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

View File

@ -34,7 +34,7 @@ class _NullComponentFactoryResolver implements ComponentFactoryResolver {
}
/**
* @stable
*
*/
export abstract class ComponentFactoryResolver {
static NULL: ComponentFactoryResolver = new _NullComponentFactoryResolver();

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@ -11,7 +11,7 @@ import {ChangeDetectorRef} from '../change_detection/change_detector_ref';
/**
* @stable
*
*/
export abstract class ViewRef extends ChangeDetectorRef {
/**

View File

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

View File

@ -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 =

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@ -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'

View File

@ -12,7 +12,7 @@ import {ChangeDetectorRef, ComponentRef, DebugElement, ElementRef, NgZone, Rende
/**
* Fixture for debugging and testing a component.
*
* @stable
*
*/
export class ComponentFixture<T> {
/**

View File

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

View File

@ -15,7 +15,7 @@ import {ValidationErrors} from './validators';
*
* Only used internally in the forms module.
*
* @stable
*
*/
export abstract class AbstractControlDirective {
/**

View File

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

View File

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

View File

@ -15,7 +15,7 @@ import {Form} from './form_interface';
*
* Only used by the forms module.
*
* @stable
*
*/
export abstract class ControlContainer extends AbstractControlDirective {
name: string;

View File

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

View File

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

View File

@ -18,7 +18,7 @@ import {NgControl} from './ng_control';
*
* Only used by the forms module.
*
* @stable
*
*/
export interface Form {
/**

View File

@ -22,7 +22,7 @@ function unimplemented(): any {
*
* Used internally by Angular forms.
*
* @stable
*
*/
export abstract class NgControl extends AbstractControlDirective {
/** @internal */

View File

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

View File

@ -61,7 +61,7 @@ const resolvedPromise = Promise.resolve(null);
*
* * **NgModule**: `FormsModule`
*
* @stable
*
*/
@Directive({
selector: 'form:not([ngNoForm]):not([formGroup]),ngForm,[ngForm]',

View File

@ -101,7 +101,7 @@ const resolvedPromise = Promise.resolve(null);
*
* **NgModule**: `FormsModule`
*
* @stable
*
*/
@Directive({
selector: '[ngModel]:not([formControlName]):not([formControl])',

View File

@ -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 {

View File

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

View File

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

View File

@ -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 {

View File

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

View File

@ -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 {

Some files were not shown because too many files have changed in this diff Show More