@angular/core 10.0.6 → 10.0.10

package/core.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v10.0.6
+ * @license Angular v10.0.10
  * (c) 2010-2020 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -693,7 +693,7 @@ export declare interface CollectionChangeRecord<V> extends IterableChangeRecord<
 }
 
 /**
- * Marks that the next string is for comment.
+ * Marks that the next string is comment text.
  *
  * See `I18nMutateOpCodes` documentation.
  */
@@ -1595,6 +1595,29 @@ export declare const DebugNode: {
     new (...args: any[]): DebugNode;
 };
 
+/**
+ * A logical node which comprise into `LView`s.
+ *
+ */
+declare interface DebugNode_2 {
+    /**
+     * HTML representation of the node.
+     */
+    html: string | null;
+    /**
+     * Human readable node type.
+     */
+    type: typeof TNodeTypeAsString[number];
+    /**
+     * DOM native node.
+     */
+    native: Node;
+    /**
+     * Child nodes
+     */
+    children: DebugNode_2[];
+}
+
 declare class DebugNode__POST_R3__ implements DebugNode {
     readonly nativeNode: Node;
     constructor(nativeNode: Node);
@@ -2116,7 +2139,7 @@ export declare interface DoCheck {
 }
 
 /**
- * Marks that the next string is for element.
+ * Marks that the next string is an element name.
  *
  * See `I18nMutateOpCodes` documentation.
  */
@@ -2794,6 +2817,17 @@ export declare interface HostListenerDecorator {
     new (eventName: string, args?: string[]): any;
 }
 
+declare interface I18nDebug {
+    /**
+     * Human readable representation of the OpCode arrays.
+     *
+     * NOTE: This property only exists if `ngDevMode` is set to `true` and it is not present in
+     * production. Its presence is purely to help debug issue in development, and should not be relied
+     * on in production application.
+     */
+    debug?: string[];
+}
+
 /**
  * Array storing OpCode for dynamically creating `i18n` blocks.
  *
@@ -2803,50 +2837,27 @@ export declare interface HostListenerDecorator {
  *   // For adding text nodes
  *   // ---------------------
  *   // Equivalent to:
- *   //   const node = lView[index++] = document.createTextNode('abc');
- *   //   lView[1].insertBefore(node, lView[2]);
- *   'abc', 1 << SHIFT_PARENT | 2 << SHIFT_REF | InsertBefore,
- *
- *   // Equivalent to:
- *   //   const node = lView[index++] = document.createTextNode('xyz');
- *   //   lView[1].appendChild(node);
- *   'xyz', 1 << SHIFT_PARENT | AppendChild,
+ *   //   lView[1].appendChild(lView[0] = document.createTextNode('xyz'));
+ *   'xyz', 0, 1 << SHIFT_PARENT | 0 << SHIFT_REF | AppendChild,
  *
  *   // For adding element nodes
  *   // ---------------------
  *   // Equivalent to:
- *   //   const node = lView[index++] = document.createElement('div');
- *   //   lView[1].insertBefore(node, lView[2]);
- *   ELEMENT_MARKER, 'div', 1 << SHIFT_PARENT | 2 << SHIFT_REF | InsertBefore,
- *
- *   // Equivalent to:
- *   //   const node = lView[index++] = document.createElement('div');
- *   //   lView[1].appendChild(node);
- *   ELEMENT_MARKER, 'div', 1 << SHIFT_PARENT | AppendChild,
+ *   //   lView[1].appendChild(lView[0] = document.createElement('div'));
+ *   ELEMENT_MARKER, 'div', 0, 1 << SHIFT_PARENT | 0 << SHIFT_REF | AppendChild,
  *
  *   // For adding comment nodes
  *   // ---------------------
  *   // Equivalent to:
- *   //   const node = lView[index++] = document.createComment('');
- *   //   lView[1].insertBefore(node, lView[2]);
- *   COMMENT_MARKER, '', 1 << SHIFT_PARENT | 2 << SHIFT_REF | InsertBefore,
- *
- *   // Equivalent to:
- *   //   const node = lView[index++] = document.createComment('');
- *   //   lView[1].appendChild(node);
- *   COMMENT_MARKER, '', 1 << SHIFT_PARENT | AppendChild,
+ *   //   lView[1].appendChild(lView[0] = document.createComment(''));
+ *   COMMENT_MARKER, '', 0, 1 << SHIFT_PARENT | 0 << SHIFT_REF | AppendChild,
  *
  *   // For moving existing nodes to a different location
  *   // --------------------------------------------------
  *   // Equivalent to:
  *   //   const node = lView[1];
- *   //   lView[2].insertBefore(node, lView[3]);
- *   1 << SHIFT_REF | Select, 2 << SHIFT_PARENT | 3 << SHIFT_REF | InsertBefore,
- *
- *   // Equivalent to:
- *   //   const node = lView[1];
  *   //   lView[2].appendChild(node);
- *   1 << SHIFT_REF | Select, 2 << SHIFT_PARENT | AppendChild,
+ *   1 << SHIFT_REF | Select, 2 << SHIFT_PARENT | 0 << SHIFT_REF | AppendChild,
  *
  *   // For removing existing nodes
  *   // --------------------------------------------------
@@ -2858,17 +2869,13 @@ export declare interface HostListenerDecorator {
  *   // --------------------------------------------------
  *   //   const node = lView[1];
  *   //   node.setAttribute('attr', 'value');
- *   1 << SHIFT_REF | Select, 'attr', 'value'
- *            // NOTE: Select followed by two string (vs select followed by OpCode)
+ *   1 << SHIFT_REF | Attr, 'attr', 'value'
  * ];
  * ```
- * NOTE:
- *   - `index` is initial location where the extra nodes should be stored in the EXPANDO section of
- * `LVIewData`.
  *
  * See: `applyI18nCreateOpCodes`;
  */
-declare interface I18nMutateOpCodes extends Array<number | string | ELEMENT_MARKER | COMMENT_MARKER | null> {
+declare interface I18nMutateOpCodes extends Array<number | string | ELEMENT_MARKER | COMMENT_MARKER | null>, I18nDebug {
 }
 
 /**
@@ -2880,6 +2887,10 @@ declare interface I18nMutateOpCodes extends Array<number | string | ELEMENT_MARK
  * higher.) The OpCodes then compare its own change mask against the expression change mask to
  * determine if the OpCodes should execute.
  *
+ * NOTE: 32nd bit is special as it says 32nd or higher. This way if we have more than 32 bindings
+ * the code still works, but with lower efficiency. (it is unlikely that a translation would have
+ * more than 32 bindings.)
+ *
  * These OpCodes can be used by both the i18n block as well as ICU sub-block.
  *
  * ## Example
@@ -2903,8 +2914,8 @@ declare interface I18nMutateOpCodes extends Array<number | string | ELEMENT_MARK
  *   // The following OpCodes represent: `<div i18n-title="pre{{exp1}}in{{exp2}}post">`
  *   // If `changeMask & 0b11`
  *   //        has changed then execute update OpCodes.
- *   //        has NOT changed then skip `7` values and start processing next OpCodes.
- *   0b11, 7,
+ *   //        has NOT changed then skip `8` values and start processing next OpCodes.
+ *   0b11, 8,
  *   // Concatenate `newValue = 'pre'+lView[bindIndex-4]+'in'+lView[bindIndex-3]+'post';`.
  *   'pre', -4, 'in', -3, 'post',
  *   // Update attribute: `elementAttribute(1, 'title', sanitizerFn(newValue));`
@@ -2923,8 +2934,8 @@ declare interface I18nMutateOpCodes extends Array<number | string | ELEMENT_MARK
  *   // The following OpCodes represent: `<div i18n>{exp4, plural, ... }">`
  *   // If `changeMask & 0b1000`
  *   //        has changed then execute update OpCodes.
- *   //        has NOT changed then skip `4` values and start processing next OpCodes.
- *   0b1000, 4,
+ *   //        has NOT changed then skip `2` values and start processing next OpCodes.
+ *   0b1000, 2,
  *   // Concatenate `newValue = lView[bindIndex -1];`.
  *   -1,
  *   // Switch ICU: `icuSwitchCase(lView[1], 0, newValue);`
@@ -2939,7 +2950,7 @@ declare interface I18nMutateOpCodes extends Array<number | string | ELEMENT_MARK
  * ```
  *
  */
-declare interface I18nUpdateOpCodes extends Array<string | number | SanitizerFn | null> {
+declare interface I18nUpdateOpCodes extends Array<string | number | SanitizerFn | null>, I18nDebug {
 }
 
 /**
@@ -3825,6 +3836,28 @@ declare interface LContainer extends Array<any> {
     [VIEW_REFS]: ViewRef[] | null;
 }
 
+/**
+ * Human readable version of the `LContainer`
+ *
+ * `LContainer` is a data structure used internally to keep track of child views. The `LContainer`
+ * is designed for efficiency and so at times it is difficult to read or write tests which assert on
+ * its values. For this reason when `ngDevMode` is true we patch a `LContainer.debug` property which
+ * points to `LContainerDebug` for easier debugging and test writing. It is the intent of
+ * `LContainerDebug` to be used in tests.
+ */
+declare interface LContainerDebug {
+    readonly native: RComment;
+    /**
+     * Child `LView`s.
+     */
+    readonly views: LViewDebug[];
+    readonly parent: LViewDebug | null;
+    readonly movedViews: ɵangular_packages_core_core_bp[] | null;
+    readonly host: RElement | RComment | ɵangular_packages_core_core_bp;
+    readonly next: LViewDebug | LContainerDebug | null;
+    readonly hasTransplantedViews: boolean;
+}
+
 /**
  *
  */
@@ -4001,6 +4034,126 @@ declare interface LQuery<T> {
     setDirty(): void;
 }
 
+/**
+ * Human readable version of the `LView`.
+ *
+ * `LView` is a data structure used internally to keep track of views. The `LView` is designed for
+ * efficiency and so at times it is difficult to read or write tests which assert on its values. For
+ * this reason when `ngDevMode` is true we patch a `LView.debug` property which points to
+ * `LViewDebug` for easier debugging and test writing. It is the intent of `LViewDebug` to be used
+ * in tests.
+ */
+declare interface LViewDebug {
+    /**
+     * Flags associated with the `LView` unpacked into a more readable state.
+     *
+     * See `LViewFlags` for the flag meanings.
+     */
+    readonly flags: {
+        initPhaseState: number;
+        creationMode: boolean;
+        firstViewPass: boolean;
+        checkAlways: boolean;
+        dirty: boolean;
+        attached: boolean;
+        destroyed: boolean;
+        isRoot: boolean;
+        indexWithinInitPhase: number;
+    };
+    /**
+     * Parent view (or container)
+     */
+    readonly parent: LViewDebug | LContainerDebug | null;
+    /**
+     * Next sibling to the `LView`.
+     */
+    readonly next: LViewDebug | LContainerDebug | null;
+    /**
+     * The context used for evaluation of the `LView`
+     *
+     * (Usually the component)
+     */
+    readonly context: {} | null;
+    /**
+     * Hierarchical tree of nodes.
+     */
+    readonly nodes: DebugNode_2[];
+    /**
+     * HTML representation of the `LView`.
+     *
+     * This is only approximate to actual HTML as child `LView`s are removed.
+     */
+    readonly html: string;
+    /**
+     * The host element to which this `LView` is attached.
+     */
+    readonly hostHTML: string | null;
+    /**
+     * Child `LView`s
+     */
+    readonly childViews: Array<LViewDebug | LContainerDebug>;
+    /**
+     * Sub range of `LView` containing decls (DOM elements).
+     */
+    readonly decls: LViewDebugRange;
+    /**
+     * Sub range of `LView` containing vars (bindings).
+     */
+    readonly vars: LViewDebugRange;
+    /**
+     * Sub range of `LView` containing i18n (translated DOM elements).
+     */
+    readonly i18n: LViewDebugRange;
+    /**
+     * Sub range of `LView` containing expando (used by DI).
+     */
+    readonly expando: LViewDebugRange;
+}
+
+/**
+ * `LView` is subdivided to ranges where the actual data is stored. Some of these ranges such as
+ * `decls` and `vars` are known at compile time. Other such as `i18n` and `expando` are runtime only
+ * concepts.
+ */
+declare interface LViewDebugRange {
+    /**
+     * The starting index in `LView` where the range begins. (Inclusive)
+     */
+    start: number;
+    /**
+     * The ending index in `LView` where the range ends. (Exclusive)
+     */
+    end: number;
+    /**
+     * The length of the range
+     */
+    length: number;
+    /**
+     * The merged content of the range. `t` contains data from `TView.data` and `l` contains `LView`
+     * data at an index.
+     */
+    content: LViewDebugRangeContent[];
+}
+
+/**
+ * For convenience the static and instance portions of `TView` and `LView` are merged into a single
+ * object in `LViewRange`.
+ */
+declare interface LViewDebugRangeContent {
+    /**
+     * Index into original `LView` or `TView.data`.
+     */
+    index: number;
+    /**
+     * Value from the `TView.data[index]` location.
+     */
+    t: any;
+    /**
+     * Value from the `LView[index]` location.
+     */
+    l: any;
+}
+
 /** Flags associated with an LView (saved in LView[FLAGS]) */
 declare const enum LViewFlags {
     /** The state of the init phase on the first 2 bits */
@@ -6729,6 +6882,13 @@ declare interface TIcu {
      * write into them.
      */
     vars: number[];
+    /**
+     * Currently selected ICU case pointer.
+     *
+     * `lView[currentCaseLViewIndex]` stores the currently selected case. This is needed to know how
+     * to clean up the current case when transitioning no the new case.
+     */
+    currentCaseLViewIndex: number;
     /**
      * An optional array of child/sub ICUs.
      *
@@ -7198,6 +7358,12 @@ declare const enum TNodeType {
     IcuContainer = 5
 }
 
+/**
+ * Converts `TNodeType` into human readable text.
+ * Make sure this matches with `TNodeType`
+ */
+declare const TNodeTypeAsString: readonly ["Container", "Projection", "View", "Element", "ElementContainer", "IcuContainer"];
+
 /**
  * Type representing a set of TNodes that can have local refs (`#foo`) placed on them.
  */
@@ -7986,7 +8152,7 @@ export declare interface ViewChildDecorator {
      *   * A template reference variable as a string (e.g. query `<my-component #cmp></my-component>`
      * with `@ViewChild('cmp')`)
      *   * Any provider defined in the child component tree of the current component (e.g.
-     * `@ViewChild(SomeComponent) someComponent: SomeComponent`)
+     * `@ViewChild(SomeService) someService: SomeService`)
      *   * Any provider defined through a string token (e.g. `@ViewChild('someToken') someTokenVal:
      * any`)
      *   * A `TemplateRef` (e.g. query `<ng-template></ng-template>` with `@ViewChild(TemplateRef)
@@ -8738,6 +8904,14 @@ export declare function ɵangular_packages_core_core_bo<T>(objWithPropertyToExtr
  * don't have to edit the data array based on which views are present.
  */
 export declare interface ɵangular_packages_core_core_bp extends Array<any> {
+    /**
+     * Human readable representation of the `LView`.
+     *
+     * NOTE: This property only exists if `ngDevMode` is set to `true` and it is not present in
+     * production. Its presence is purely to help debug issue in development, and should not be relied
+     * on in production application.
+     */
+    debug?: LViewDebug;
     /**
      * The host node for this LView instance, if this is a component view.
      * If this is an embedded view, HOST will be null.
@@ -8941,18 +9115,6 @@ export declare interface ɵangular_packages_core_core_bp extends Array<any> {
     [TRANSPLANTED_VIEWS_TO_REFRESH]: number;
 }
 
-
-/**
- * Convince closure compiler that the wrapped function has no side-effects.
- *
- * Closure compiler always assumes that `toString` has no side-effects. We use this quirk to
- * allow us to execute a function but have closure compiler mark the call as no-side-effects.
- * It is important that the return value for the `noSideEffects` function be assigned
- * to something which is retained otherwise the call to `noSideEffects` will be removed by closure
- * compiler.
- */
-export declare function ɵangular_packages_core_core_bq<T>(fn: () => T): T;
-
 /**
  * Returns the `RootContext` instance that is associated with
  * the application where the target is situated. It does this by walking the parent views until it
@@ -8960,7 +9122,32 @@ export declare function ɵangular_packages_core_core_bq<T>(fn: () => T): T;
  *
  * @param viewOrComponent the `LView` or component to get the root context for.
  */
-export declare function ɵangular_packages_core_core_br(viewOrComponent: ɵangular_packages_core_core_bp | {}): RootContext;
+export declare function ɵangular_packages_core_core_bq(viewOrComponent: ɵangular_packages_core_core_bp | {}): RootContext;
+
+
+/**
+ * Handles message string post-processing for internationalization.
+ *
+ * Handles message string post-processing by transforming it from intermediate
+ * format (that might contain some markers that we need to replace) to the final
+ * form, consumable by i18nStart instruction. Post processing steps include:
+ *
+ * 1. Resolve all multi-value cases (like [�*1:1��#2:1�|�#4:1�|�5�])
+ * 2. Replace all ICU vars (like "VAR_PLURAL")
+ * 3. Replace all placeholders used inside ICUs in a form of {PLACEHOLDER}
+ * 4. Replace all ICU references with corresponding values (like �ICU_EXP_ICU_1�)
+ *    in case multiple ICUs have the same placeholder name
+ *
+ * @param message Raw translation string for post processing
+ * @param replacements Set of replacements that should be applied
+ *
+ * @returns Transformed string that can be consumed by i18nStart instruction
+ *
+ * @codeGenApi
+ */
+export declare function ɵangular_packages_core_core_br(message: string, replacements?: {
+    [key: string]: (string | string[]);
+}): string;
 
 export declare class ɵangular_packages_core_core_c implements Injector {
     get(token: any, notFoundValue?: any): any;
@@ -10259,6 +10446,18 @@ export declare class ɵNoopNgZone implements NgZone {
     runTask<T>(fn: (...args: any[]) => T, applyThis?: any, applyArgs?: any, name?: string): T;
 }
 
+
+/**
+ * Convince closure compiler that the wrapped function has no side-effects.
+ *
+ * Closure compiler always assumes that `toString` has no side-effects. We use this quirk to
+ * allow us to execute a function but have closure compiler mark the call as no-side-effects.
+ * It is important that the return value for the `noSideEffects` function be assigned
+ * to something which is retained otherwise the call to `noSideEffects` will be removed by closure
+ * compiler.
+ */
+export declare function ɵnoSideEffects<T>(fn: () => T): T;
+
 export declare const ɵNOT_FOUND_CHECK_ONLY_ELEMENT_INJECTOR: {};
 
 export declare function ɵnov(view: ViewData, index: number): any;
@@ -10664,6 +10863,7 @@ export declare function ɵsetCurrentInjector(injector: Injector | null | undefin
  */
 export declare function ɵsetDocument(document: Document | undefined): void;
 
+
 /**
  * Sets the locale id that will be used for translations and ICU expressions.
  * This is the ivy version of `LOCALE_ID` that was defined as an injection token for the view engine