@angular/core 7.2.7 → 7.2.11

package/fesm5/testing.js

@@ -1,5 +1,5 @@
 /**
- * @license Angular v7.2.7
+ * @license Angular v7.2.11
  * (c) 2010-2019 Google LLC. https://angular.io/
  * License: MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "7.2.7",
+  "version": "7.2.11",
   "description": "Angular - the core framework",
   "main": "./bundles/core.umd.js",
   "module": "./fesm5/core.js",

package/src/change_detection/constants.d.ts

@@ -16,6 +16,7 @@ export declare enum ChangeDetectionStrategy {
      * Use the `CheckOnce` strategy, meaning that automatic change detection is deactivated
      * until reactivated by setting the strategy to `Default` (`CheckAlways`).
      * Change detection can still be explicitly invoked.
+     * This strategy applies to all child directives and cannot be overridden.
      */
     OnPush = 0,
     /**

package/src/metadata/directives.d.ts

@@ -260,7 +260,7 @@ export interface Directive {
      * To listen to global events, add the target to the event name.
      * The target can be `window`, `document` or `body`.
      * - The value is the statement to execute when the event occurs. If the
-     * statement evalueates to `false`, then `preventDefault` is applied on the DOM
+     * statement evaluates to `false`, then `preventDefault` is applied on the DOM
      * event. A handler method can refer to the `$event` local variable.
      *
      */
@@ -300,7 +300,7 @@ export interface ComponentDecorator {
      *
      * A component must belong to an NgModule in order for it to be available
      * to another component or application. To make it a member of an NgModule,
-     * list it in the `declarations` field of the `@NgModule` metadata.
+     * list it in the `declarations` field of the `NgModule` metadata.
      *
      * Note that, in addition to these options for configuring a directive,
      * you can control a component's runtime behavior by implementing
@@ -426,7 +426,7 @@ export interface ComponentDecorator {
      */
     (obj: Component): TypeDecorator;
     /**
-     * See the `@Component` decorator.
+     * See the `Component` decorator.
      */
     new (obj: Component): Component;
 }
@@ -491,12 +491,12 @@ export interface Component extends Directive {
     animations?: any[];
     /**
      * An encapsulation policy for the template and CSS styles. One of:
-     * - `ViewEncapsulation.Native`: Use shadow roots. This works
-     * only if natively available on the platform.
+     * - `ViewEncapsulation.Native`: Deprecated. Use `ViewEncapsulation.ShadowDom` instead.
      * - `ViewEncapsulation.Emulated`: Use shimmed CSS that
      * emulates the native behavior.
      * - `ViewEncapsulation.None`: Use global CSS without any
      * encapsulation.
+     * - `ViewEncapsulation.ShadowDom`: Use Shadow DOM v1 to encapsulate styles.
      *
      * If not supplied, the value is taken from `CompilerOptions`. The default compiler option is
      * `ViewEncapsulation.Emulated`.
@@ -538,7 +538,22 @@ export declare const Component: ComponentDecorator;
  */
 export interface PipeDecorator {
     /**
-     * Declares a reusable pipe function, and supplies configuration metadata.
+     *
+     * Decorator that marks a class as pipe and supplies configuration metadata.
+     *
+     * A pipe class must implement the `PipeTransform` interface.
+     * For example, if the name is "myPipe", use a template binding expression
+     * such as the following:
+     *
+     * ```
+     * {{ exp | myPipe }}
+     * ```
+     *
+     * The result of the expression is passed to the pipe's `transform()` method.
+     *
+     * A pipe must belong to an NgModule in order for it to be available
+     * to a template. To make it a member of an NgModule,
+     * list it in the `declarations` field of the `NgModule` metadata.
      *
      */
     (obj: Pipe): TypeDecorator;
@@ -580,23 +595,48 @@ export declare const Pipe: PipeDecorator;
  */
 export interface InputDecorator {
     /**
-     * Decorator that marks a class as pipe and supplies configuration metadata.
-     *
-     * A pipe class must implement the `PipeTransform` interface.
-     * For example, if the name is "myPipe", use a template binding expression
-     * such as the following:
-     *
-     * ```
-     * {{ exp | myPipe }}
-     * ```
-     *
-     * The result of the expression is passed to the pipe's `transform()` method.
-     *
-     * A pipe must belong to an NgModule in order for it to be available
-     * to a template. To make it a member of an NgModule,
-     * list it in the `declarations` field of the `@NgModule` metadata.
-     *
-     */
+    * Decorator that marks a class field as an input property and supplies configuration metadata.
+    * The input property is bound to a DOM property in the template. During change detection,
+    * Angular automatically updates the data property with the DOM property's value.
+    *
+    * @usageNotes
+    *
+    * You can supply an optional name to use in templates when the
+    * component is instantiated, that maps to the
+    * name of the bound property. By default, the original
+    * name of the bound property is used for input binding.
+    *
+    * The following example creates a component with two input properties,
+    * one of which is given a special binding name.
+    *
+    * ```typescript
+    * @Component({
+    *   selector: 'bank-account',
+    *   template: `
+    *     Bank Name: {{bankName}}
+    *     Account Id: {{id}}
+    *   `
+    * })
+    * class BankAccount {
+    *   // This property is bound using its original name.
+    *   @Input() bankName: string;
+    *   // this property value is bound to a different property name
+    *   // when this component is instantiated in a template.
+    *   @Input('account-id') id: string;
+    *
+    *   // this property is not bound, and is not automatically updated by Angular
+    *   normalizedBankName: string;
+    * }
+    *
+    * @Component({
+    *   selector: 'app',
+    *   template: `
+    *     <bank-account bankName="RBC" account-id="4747"></bank-account>
+    *   `
+    * })
+    * class App {}
+    * ```
+    */
     (bindingPropertyName?: string): any;
     new (bindingPropertyName?: string): any;
 }
@@ -607,49 +647,7 @@ export interface InputDecorator {
  */
 export interface Input {
     /**
-     * Decorator that marks a class field as an input property and supplies configuration metadata.
-     * Declares a data-bound input property, which Angular automatically updates
-     * during change detection.
-     *
-     * @usageNotes
-     *
-     * You can supply an optional name to use in templates when the
-     * component is instantiated, that maps to the
-     * name of the bound property. By default, the original
-     * name of the bound property is used for input binding.
-     *
-     * The following example creates a component with two input properties,
-     * one of which is given a special binding name.
-     *
-     * ```typescript
-     * @Component({
-     *   selector: 'bank-account',
-     *   template: `
-     *     Bank Name: {{bankName}}
-     *     Account Id: {{id}}
-     *   `
-     * })
-     * class BankAccount {
-     *   // This property is bound using its original name.
-     *   @Input() bankName: string;
-     *   // this property value is bound to a different property name
-     *   // when this component is instantiated in a template.
-     *   @Input('account-id') id: string;
-     *
-     *   // this property is not bound, and is not automatically updated by Angular
-     *   normalizedBankName: string;
-     * }
-     *
-     * @Component({
-     *   selector: 'app',
-     *   template: `
-     *     <bank-account bankName="RBC" account-id="4747"></bank-account>
-     *   `
-     * })
-     *
-     * class App {}
-     * ```
-     *
+     * The name of the DOM property to which the input property is bound.
      */
     bindingPropertyName?: string;
 }
@@ -666,8 +664,7 @@ export declare const Input: InputDecorator;
 export interface OutputDecorator {
     /**
     * Decorator that marks a class field as an output property and supplies configuration metadata.
-    * Declares a data-bound output property, which Angular automatically updates
-    * during change detection.
+    * The DOM property bound to the output property is automatically updated during change detection.
     *
     * @usageNotes
     *
@@ -676,7 +673,7 @@ export interface OutputDecorator {
     * name of the bound property. By default, the original
     * name of the bound property is used for output binding.
     *
-    * See `@Input` decorator for an example of providing a binding name.
+    * See `Input` decorator for an example of providing a binding name.
     *
     */
     (bindingPropertyName?: string): any;
@@ -688,6 +685,9 @@ export interface OutputDecorator {
  * @publicApi
  */
 export interface Output {
+    /**
+    * The name of the DOM property to which the output property is bound.
+    */
     bindingPropertyName?: string;
 }
 /**
@@ -739,6 +739,9 @@ export interface HostBindingDecorator {
  * @publicApi
  */
 export interface HostBinding {
+    /**
+     * The DOM property that is bound to a data property.
+     */
     hostPropertyName?: string;
 }
 /**
@@ -752,6 +755,10 @@ export declare const HostBinding: HostBindingDecorator;
  * @publicApi
  */
 export interface HostListenerDecorator {
+    /**
+     * Decorator that declares a DOM event to listen for,
+     * and provides a handler method to run when that event occurs.
+     */
     (eventName: string, args?: string[]): any;
     new (eventName: string, args?: string[]): any;
 }

package/src/metadata/ng_module.d.ts

@@ -102,10 +102,12 @@ export declare const CUSTOM_ELEMENTS_SCHEMA: SchemaMetadata;
 export declare const NO_ERRORS_SCHEMA: SchemaMetadata;
 /**
  * Type of the NgModule decorator / constructor function.
+ *
+ * @publicApi
  */
 export interface NgModuleDecorator {
     /**
-     * Marks a class as an NgModule and supplies configuration metadata.
+     * Decorator that marks a class as an NgModule and supplies configuration metadata.
      */
     (obj?: NgModule): TypeDecorator;
     new (obj?: NgModule): NgModule;
@@ -206,7 +208,7 @@ export interface NgModule {
      *
      * ### Example
      *
-     * The following example allows MainModule to use anthing exported by
+     * The following example allows MainModule to use anything exported by
      * `CommonModule`:
      *
      * ```javascript

package/src/metadata/resource_loading.d.ts

@@ -15,18 +15,18 @@ import { Component } from './directives';
  *   selector: 'my-comp',
  *   templateUrl: 'my-comp.html', // This requires asynchronous resolution
  * })
- * class MyComponnent{
+ * class MyComponent{
  * }
  *
- * // Calling `renderComponent` will fail because `MyComponent`'s `@Compenent.templateUrl`
- * // needs to be resolved because `renderComponent` is synchronous process.
- * // renderComponent(MyComponent);
+ * // Calling `renderComponent` will fail because `renderComponent` is a synchronous process
+ * // and `MyComponent`'s `@Component.templateUrl` needs to be resolved asynchronously.
  *
- * // Calling `resolveComponentResources` will resolve `@Compenent.templateUrl` into
- * // `@Compenent.template`, which would allow `renderComponent` to proceed in synchronous manner.
- * // Use browser's `fetch` function as the default resource resolution strategy.
+ * // Calling `resolveComponentResources()` will resolve `@Component.templateUrl` into
+ * // `@Component.template`, which allows `renderComponent` to proceed in a synchronous manner.
+ *
+ * // Use browser's `fetch()` function as the default resource resolution strategy.
  * resolveComponentResources(fetch).then(() => {
- *   // After resolution all URLs have been converted into strings.
+ *   // After resolution all URLs have been converted into `template` strings.
  *   renderComponent(MyComponent);
  * });
  *
@@ -35,8 +35,8 @@ import { Component } from './directives';
  * NOTE: In AOT the resolution happens during compilation, and so there should be no need
  * to call this method outside JIT mode.
  *
- * @param resourceResolver a function which is responsible to returning a `Promise` of the resolved
- * URL. Browser's `fetch` method is a good default implementation.
+ * @param resourceResolver a function which is responsible for returning a `Promise` to the
+ * contents of the resolved URL. Browser's `fetch()` method is a good default implementation.
  */
 export declare function resolveComponentResources(resourceResolver: (url: string) => (Promise<string | {
     text(): Promise<string>;

package/src/metadata.d.ts

@@ -8,5 +8,5 @@
 export { ANALYZE_FOR_ENTRY_COMPONENTS, Attribute, ContentChild, ContentChildDecorator, ContentChildren, ContentChildrenDecorator, Query, ViewChild, ViewChildDecorator, ViewChildren, ViewChildrenDecorator } from './metadata/di';
 export { Component, ComponentDecorator, Directive, DirectiveDecorator, HostBinding, HostBindingDecorator, HostListener, HostListenerDecorator, Input, InputDecorator, Output, OutputDecorator, Pipe, PipeDecorator } from './metadata/directives';
 export { AfterContentChecked, AfterContentInit, AfterViewChecked, AfterViewInit, DoCheck, OnChanges, OnDestroy, OnInit } from './metadata/lifecycle_hooks';
-export { CUSTOM_ELEMENTS_SCHEMA, DoBootstrap, ModuleWithProviders, NO_ERRORS_SCHEMA, NgModule, SchemaMetadata } from './metadata/ng_module';
+export { CUSTOM_ELEMENTS_SCHEMA, DoBootstrap, ModuleWithProviders, NO_ERRORS_SCHEMA, NgModule, NgModuleDecorator, SchemaMetadata } from './metadata/ng_module';
 export { ViewEncapsulation } from './metadata/view';

package/testing/src/resolvers.d.ts

@@ -34,6 +34,6 @@ export declare class PipeResolver extends OverrideResolver<Pipe> {
     readonly type: import("@angular/core").PipeDecorator;
 }
 export declare class NgModuleResolver extends OverrideResolver<NgModule> {
-    readonly type: import("@angular/core/src/metadata/ng_module").NgModuleDecorator;
+    readonly type: import("@angular/core").NgModuleDecorator;
 }
 export {};

package/testing.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v7.2.7
+ * @license Angular v7.2.11
  * (c) 2010-2019 Google LLC. https://angular.io/
  * License: MIT
  */