@angular/core 6.0.3 → 6.0.7

package/src/metadata/lifecycle_hooks.d.ts

@@ -25,7 +25,7 @@ export interface SimpleChanges {
  * and content children are checked if at least one of them has changed.
  * The `changes` parameter contains the changed properties.
  *
- * See {@linkDocs guide/lifecycle-hooks#onchanges "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#onchanges).
  *
  *
  */
@@ -44,7 +44,7 @@ export interface OnChanges {
  * first time, and before any of its children have been checked. It is invoked only once when the
  * directive is instantiated.
  *
- * See {@linkDocs guide/lifecycle-hooks "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks).
  *
  *
  */
@@ -69,7 +69,7 @@ export interface OnInit {
  * See {@link KeyValueDiffers} and {@link IterableDiffers} for implementing custom dirty checking
  * for collections.
  *
- * See {@linkDocs guide/lifecycle-hooks#docheck "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#docheck).
  *
  *
  */
@@ -86,7 +86,7 @@ export interface DoCheck {
  * `ngOnDestroy` callback is typically used for any custom cleanup that needs to occur when the
  * instance is destroyed.
  *
- * See {@linkDocs guide/lifecycle-hooks "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks).
  *
  *
  */
@@ -102,7 +102,7 @@ export interface OnDestroy {
  * Lifecycle hook that is called after a directive's content has been fully
  * initialized.
  *
- * See {@linkDocs guide/lifecycle-hooks#aftercontent "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#aftercontent).
  *
  *
  */
@@ -116,7 +116,7 @@ export interface AfterContentInit {
  * @description
  * Lifecycle hook that is called after every check of a directive's content.
  *
- * See {@linkDocs guide/lifecycle-hooks#aftercontent "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#aftercontent).
  *
  *
  */
@@ -131,7 +131,7 @@ export interface AfterContentChecked {
  * Lifecycle hook that is called after a component's view has been fully
  * initialized.
  *
- * See {@linkDocs guide/lifecycle-hooks#afterview "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#afterview).
  *
  *
  */
@@ -145,7 +145,7 @@ export interface AfterViewInit {
  * @description
  * Lifecycle hook that is called after every check of a component's view.
  *
- * See {@linkDocs guide/lifecycle-hooks#afterview "Lifecycle Hooks Guide"}.
+ * See ["Lifecycle Hooks Guide"](guide/lifecycle-hooks#afterview).
  *
  *
  */

package/src/metadata/ng_module.d.ts

@@ -2,7 +2,7 @@ import { Provider } from '../di/provider';
 import { Type } from '../type';
 import { TypeDecorator } from '../util/decorators';
 /**
- * A wrapper around a module that also includes the providers.
+ * A wrapper around an NgModule that associates it with the providers.
  *
  *
  */
@@ -11,7 +11,11 @@ export interface ModuleWithProviders {
     providers?: Provider[];
 }
 /**
- * Interface for schema definitions in @NgModules.
+ * A schema definition associated with an NgModule.
+ *
+ * @see `@NgModule`, `CUSTOM_ELEMENTS_SCHEMA`, `NO_ERRORS_SCHEMA`
+ *
+ * @param name The name of a defined schema.
  *
  * @experimental
  */
@@ -19,16 +23,16 @@ export interface SchemaMetadata {
     name: string;
 }
 /**
- * Defines a schema that will allow:
- * - any non-Angular elements with a `-` in their name,
- * - any properties on elements with a `-` in their name which is the common rule for custom
- * elements.
+ * Defines a schema that allows an NgModule to contain the following:
+ * - Non-Angular elements named with dash case (`-`).
+ * - Element properties named with dash case (`-`).
+ * Dash case is the naming convention for custom elements.
  *
  *
  */
 export declare const CUSTOM_ELEMENTS_SCHEMA: SchemaMetadata;
 /**
- * Defines a schema that will allow any property on any element.
+ * Defines a schema that allows any property on any element.
  *
  * @experimental
  */
@@ -40,7 +44,7 @@ export declare const NO_ERRORS_SCHEMA: SchemaMetadata;
  */
 export interface NgModuleDecorator {
     /**
-     * Defines an NgModule.
+     * Marks a class as an NgModule and supplies configuration metadata.
      */
     (obj?: NgModule): TypeDecorator;
     new (obj?: NgModule): NgModule;
@@ -52,12 +56,13 @@ export interface NgModuleDecorator {
  */
 export interface NgModule {
     /**
-     * Defines the set of injectable objects that are available in the injector
+     * The set of injectable objects that are available in the injector
      * of this module.
      *
-     * ## Simple Example
+     * @usageNotes
      *
-     * Here is an example of a class that can be injected:
+     * The following example defines a class that is injected in
+     * the HelloWorld NgModule:
      *
      * ```
      * class Greeter {
@@ -82,9 +87,12 @@ export interface NgModule {
      */
     providers?: Provider[];
     /**
-     * Specifies a list of directives/pipes that belong to this module.
+     * The set of directives and pipes that belong to this module.
+     *
+     * @usageNotes
      *
-     * ### Example
+     * The following example allows the CommonModule to use the `NgFor`
+     * directive.
      *
      * ```javascript
      * @NgModule({
@@ -96,11 +104,13 @@ export interface NgModule {
      */
     declarations?: Array<Type<any> | any[]>;
     /**
-     * Specifies a list of modules whose exported directives/pipes
-     * should be available to templates in this module.
-     * This can also contain {@link ModuleWithProviders}.
+     * The set of NgModules, with or without providers,
+     * whose exported directives/pipes
+     * are available to templates in this module.
      *
-     * ### Example
+     * @usageNotes
+     *
+     * The following example allows MainModule to use CommonModule:
      *
      * ```javascript
      * @NgModule({
@@ -109,14 +119,17 @@ export interface NgModule {
      * class MainModule {
      * }
      * ```
+     *  @see {@link ModuleWithProviders}
      */
     imports?: Array<Type<any> | ModuleWithProviders | any[]>;
     /**
-     * Specifies a list of directives/pipes/modules that can be used within the template
-     * of any component that is part of an Angular module
-     * that imports this Angular module.
+     * The set of directives, pipe, and NgModules that can be used
+     * within the template of any component that is part of an
+     * NgModule that imports this NgModule.
+     *
+     * @usageNotes
      *
-     * ### Example
+     * The following example exports the `NgFor` directive from CommonModule.
      *
      * ```javascript
      * @NgModule({
@@ -128,40 +141,38 @@ export interface NgModule {
      */
     exports?: Array<Type<any> | any[]>;
     /**
-     * Specifies a list of components that should be compiled when this module is defined.
-     * For each component listed here, Angular will create a {@link ComponentFactory}
-     * and store it in the {@link ComponentFactoryResolver}.
+     * The set of components to compile when this NgModule is defined.
+     * For each component listed here, Angular creates a `ComponentFactory`
+     * and stores it in the `ComponentFactoryResolver`.
      */
     entryComponents?: Array<Type<any> | any[]>;
     /**
-     * Defines the components that should be bootstrapped when
+     * The set of components that are bootstrapped when
      * this module is bootstrapped. The components listed here
-     * will automatically be added to `entryComponents`.
+     * are automatically added to `entryComponents`.
      */
     bootstrap?: Array<Type<any> | any[]>;
     /**
-     * Elements and properties that are not Angular components nor directives have to be declared in
-     * the schema.
+     * The set of schemas that declare elements to be allowed in the NgModule.
+     * Elements and properties that are neither Angular components nor directives
+     * must be declared in a schema.
      *
-     * Available schemas:
-     * - `NO_ERRORS_SCHEMA`: any elements and properties are allowed,
-     * - `CUSTOM_ELEMENTS_SCHEMA`: any custom elements (tag name has "-") with any properties are
-     *   allowed.
+     * Allowed value are `NO_ERRORS_SCHEMA` and `CUSTOM_ELEMENTS_SCHEMA`.
      *
-     * @security When using one of `NO_ERRORS_SCHEMA` or `CUSTOM_ELEMENTS_SCHEMA` we're trusting that
-     * allowed elements (and its properties) securely escape inputs.
+     * @security When using one of `NO_ERRORS_SCHEMA` or `CUSTOM_ELEMENTS_SCHEMA`
+     * you must ensure that allowed elements and properties securely escape inputs.
      */
     schemas?: Array<SchemaMetadata | any[]>;
     /**
-     * An opaque ID for this module, e.g. a name or a path. Used to identify modules in
-     * `getModuleFactory`. If left `undefined`, the `NgModule` will not be registered with
+     * A name or path that uniquely identifies this NgModule in `getModuleFactory`.
+     * If left `undefined`, the NgModule is not registered with
      * `getModuleFactory`.
      */
     id?: string;
 }
 /**
- * NgModule decorator and metadata.
- *
+ * Decorator that marks the following class as an NgModule, and supplies
+ * configuration metadata for it.
  *
  * @Annotation
  */

package/src/render3/view_ref.d.ts

@@ -29,7 +29,8 @@ export declare class ViewRef<T> implements viewEngine_EmbeddedViewRef<T> {
      *
      * <!-- TODO: Add a link to a chapter on OnPush components -->
      *
-     * ### Example ([live demo](https://stackblitz.com/edit/angular-kx7rrw))
+     * @usageNotes
+     * ### Example
      *
      * ```typescript
      * @Component({
@@ -62,6 +63,7 @@ export declare class ViewRef<T> implements viewEngine_EmbeddedViewRef<T> {
      * <!-- TODO: Add a link to a chapter on detach/reattach/local digest -->
      * <!-- TODO: Add a live demo once ref.detectChanges is merged into master -->
      *
+     * @usageNotes
      * ### Example
      *
      * The following example defines a component with a large list of readonly data.
@@ -112,7 +114,8 @@ export declare class ViewRef<T> implements viewEngine_EmbeddedViewRef<T> {
      *
      * <!-- TODO: Add a link to a chapter on detach/reattach/local digest -->
      *
-     * ### Example ([live demo](https://stackblitz.com/edit/angular-ymgsxw))
+     * @usageNotes
+     * ### Example
      *
      * The following example creates a component displaying `live` data. The component will detach
      * its change detector from the main change detector tree when the component's live property
@@ -169,6 +172,7 @@ export declare class ViewRef<T> implements viewEngine_EmbeddedViewRef<T> {
      * <!-- TODO: Add a link to a chapter on detach/reattach/local digest -->
      * <!-- TODO: Add a live demo once ref.detectChanges is merged into master -->
      *
+     * @usageNotes
      * ### Example
      *
      * The following example defines a component with a large list of readonly data.

package/src/zone/ng_zone.d.ts

@@ -12,6 +12,7 @@ import { EventEmitter } from '../event_emitter';
  *   - link to runOutsideAngular/run (throughout this file!)
  *   -->
  *
+ * @usageNotes
  * ### Example
  *
  * ```

package/testing/src/fake_async.d.ts

@@ -14,7 +14,8 @@ export declare function resetFakeAsyncZone(): void;
  *
  * Can be used to wrap inject() calls.
  *
- * ## Example
+ * @usageNotes
+ * ### Example
  *
  * {@example core/testing/ts/fake_async.ts region='basic'}
  *
@@ -30,7 +31,8 @@ export declare function fakeAsync(fn: Function): (...args: any[]) => any;
  * The microtasks queue is drained at the very start of this function and after any timer callback
  * has been executed.
  *
- * ## Example
+ * @usageNotes
+ * ### Example
  *
  * {@example core/testing/ts/fake_async.ts region='basic'}
  *

package/testing/src/fake_async_fallback.d.ts

@@ -14,7 +14,8 @@ export declare function resetFakeAsyncZoneFallback(): void;
  *
  * Can be used to wrap inject() calls.
  *
- * ## Example
+ * @usageNotes
+ * ### Example
  *
  * {@example core/testing/ts/fake_async.ts region='basic'}
  *
@@ -30,7 +31,8 @@ export declare function fakeAsyncFallback(fn: Function): (...args: any[]) => any
  * The microtasks queue is drained at the very start of this function and after any timer callback
  * has been executed.
  *
- * ## Example
+ * @usageNotes
+ * ### Example
  *
  * {@example core/testing/ts/fake_async.ts region='basic'}
  *

package/testing/src/metadata_override.d.ts

@@ -11,7 +11,7 @@
  * @experimental
  */
 export declare type MetadataOverride<T> = {
-    add?: T;
-    remove?: T;
-    set?: T;
+    add?: Partial<T>;
+    remove?: Partial<T>;
+    set?: Partial<T>;
 };

package/testing.d.ts

@@ -1,8 +1,3 @@
-/**
- * @license Angular v6.0.3
- * (c) 2010-2018 Google, Inc. https://angular.io/
- * License: MIT
- */
 
   export * from './testing/testing';
   

package/testing.metadata.json

@@ -1 +1 @@
-{"__symbolic":"module","version":3,"metadata":{},"exports":[{"from":"./testing/testing"}],"flatModuleIndexRedirect":true}
+{"__symbolic":"module","version":3,"metadata":{},"exports":[{"from":"./testing/testing"}],"flatModuleIndexRedirect":true,"importAs":"@angular/core/testing"}