@angular/core 13.2.0-rc.1 → 13.2.3

package/core.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v13.2.0-rc.1
+ * @license Angular v13.2.3
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -1702,13 +1702,18 @@ export declare const CUSTOM_ELEMENTS_SCHEMA: SchemaMetadata;
  * @see [Basics of testing components](guide/testing-components-basics)
  * @see [Testing utility APIs](guide/testing-utility-apis)
  */
-export declare interface DebugElement extends DebugNode {
+export declare class DebugElement extends DebugNode {
+    constructor(nativeNode: Element);
+    /**
+     * The underlying DOM element at the root of the component.
+     */
+    get nativeElement(): any;
     /**
      * The element tag name, if it is an element.
      */
-    readonly name: string;
+    get name(): string;
     /**
-     *  A map of property names to property values for an element.
+     *  Gets a map of property names to property values for an element.
      *
      *  This map includes:
      *  - Regular property bindings (e.g. `[id]="id"`)
@@ -1719,13 +1724,23 @@ export declare interface DebugElement extends DebugNode {
      *  - input property bindings (e.g. `[myCustomInput]="value"`)
      *  - attribute bindings (e.g. `[attr.role]="menu"`)
      */
-    readonly properties: {
+    get properties(): {
         [key: string]: any;
     };
     /**
      *  A map of attribute names to attribute values for an element.
      */
-    readonly attributes: {
+    get attributes(): {
+        [key: string]: string | null;
+    };
+    /**
+     * The inline styles of the DOM element.
+     *
+     * Will be `null` if there is no `style` property on the underlying DOM element.
+     *
+     * @see [ElementCSSInlineStyle](https://developer.mozilla.org/en-US/docs/Web/API/ElementCSSInlineStyle/style)
+     */
+    get styles(): {
         [key: string]: string | null;
     };
     /**
@@ -1738,33 +1753,19 @@ export declare interface DebugElement extends DebugNode {
      *
      * @see [Element.className](https://developer.mozilla.org/en-US/docs/Web/API/Element/className)
      */
-    readonly classes: {
+    get classes(): {
         [key: string]: boolean;
     };
-    /**
-     * The inline styles of the DOM element.
-     *
-     * Will be `null` if there is no `style` property on the underlying DOM element.
-     *
-     * @see [ElementCSSInlineStyle](https://developer.mozilla.org/en-US/docs/Web/API/ElementCSSInlineStyle/style)
-     */
-    readonly styles: {
-        [key: string]: string | null;
-    };
     /**
      * The `childNodes` of the DOM element as a `DebugNode` array.
      *
      * @see [Node.childNodes](https://developer.mozilla.org/en-US/docs/Web/API/Node/childNodes)
      */
-    readonly childNodes: DebugNode[];
-    /**
-     * The underlying DOM element at the root of the component.
-     */
-    readonly nativeElement: any;
+    get childNodes(): DebugNode[];
     /**
      * The immediate `DebugElement` children. Walk the tree by descending through `children`.
      */
-    readonly children: DebugElement[];
+    get children(): DebugElement[];
     /**
      * @returns the first `DebugElement` that matches the predicate at any depth in the subtree.
      */
@@ -1792,13 +1793,6 @@ export declare interface DebugElement extends DebugNode {
     triggerEventHandler(eventName: string, eventObj: any): void;
 }
 
-/**
- * @publicApi
- */
-export declare const DebugElement: {
-    new (...args: any[]): DebugElement;
-};
-
 /**
  * @publicApi
  */
@@ -1811,28 +1805,24 @@ export declare class DebugEventListener {
 /**
  * @publicApi
  */
-export declare interface DebugNode {
+export declare class DebugNode {
     /**
-     * The callbacks attached to the component's @Output properties and/or the element's event
-     * properties.
+     * The underlying DOM node.
      */
-    readonly listeners: DebugEventListener[];
+    readonly nativeNode: any;
+    constructor(nativeNode: Node);
     /**
      * The `DebugElement` parent. Will be `null` if this is the root element.
      */
-    readonly parent: DebugElement | null;
-    /**
-     * The underlying DOM node.
-     */
-    readonly nativeNode: any;
+    get parent(): DebugElement | null;
     /**
      * The host dependency injector. For example, the root element's component instance injector.
      */
-    readonly injector: Injector;
+    get injector(): Injector;
     /**
      * The element's own component instance, if it has one.
      */
-    readonly componentInstance: any;
+    get componentInstance(): any;
     /**
      * An object that provides parent context for this element. Often an ancestor component instance
      * that governs this element.
@@ -1841,28 +1831,26 @@ export declare interface DebugNode {
      * property is the value of the row instance value. For example, the `hero` in `*ngFor="let hero
      * of heroes"`.
      */
-    readonly context: any;
+    get context(): any;
+    /**
+     * The callbacks attached to the component's @Output properties and/or the element's event
+     * properties.
+     */
+    get listeners(): DebugEventListener[];
     /**
      * Dictionary of objects associated with template local variables (e.g. #foo), keyed by the local
      * variable name.
      */
-    readonly references: {
+    get references(): {
         [key: string]: any;
     };
     /**
      * This component's injector lookup tokens. Includes the component itself plus the tokens that the
      * component lists in its providers metadata.
      */
-    readonly providerTokens: any[];
+    get providerTokens(): any[];
 }
 
-/**
- * @publicApi
- */
-export declare const DebugNode: {
-    new (...args: any[]): DebugNode;
-};
-
 /**
  * A logical node which comprise into `LView`s.
  *
@@ -2779,7 +2767,7 @@ export declare interface ForwardRefFn {
 /**
  * @publicApi
  */
-declare const getDebugNode: (nativeNode: any) => DebugNode | null;
+declare function getDebugNode(nativeNode: any): DebugNode | null;
 export { getDebugNode }
 export { getDebugNode as ɵgetDebugNode }
 
@@ -3072,19 +3060,20 @@ export declare interface HostListener {
  *
  * ```
  *
- * The following example registers another DOM event handler that listens for key-press events.
+ * The following example registers another DOM event handler that listens for `Enter` key-press
+ * events on the global `window`.
  * ``` ts
  * import { HostListener, Component } from "@angular/core";
  *
  * @Component({
  *   selector: 'app',
- *   template: `<h1>Hello, you have pressed keys {{counter}} number of times!</h1> Press any key to
- * increment the counter.
+ *   template: `<h1>Hello, you have pressed enter {{counter}} number of times!</h1> Press enter key
+ * to increment the counter.
  *   <button (click)="resetCounter()">Reset Counter</button>`
  * })
  * class AppComponent {
  *   counter = 0;
- *   @HostListener('window:keydown', ['$event'])
+ *   @HostListener('window:keydown.enter', ['$event'])
  *   handleKeyDown(event: KeyboardEvent) {
  *     this.counter++;
  *   }
@@ -3093,6 +3082,14 @@ export declare interface HostListener {
  *   }
  * }
  * ```
+ * The list of valid key names for `keydown` and `keyup` events
+ * can be found here:
+ * https://www.w3.org/TR/DOM-Level-3-Events-key/#named-key-attribute-values
+ *
+ * Note that keys can also be combined, e.g. `@HostListener('keydown.shift.a')`.
+ *
+ * The global target names that can be used to prefix an event name are
+ * `document:`, `window:` and `body:`.
  *
  * @Annotation
  * @publicApi
@@ -5583,33 +5580,14 @@ export declare class PlatformRef {
     private _destroyListeners;
     private _destroyed;
     /**
-     * Creates an instance of an `@NgModule` for the given platform for offline compilation.
-     *
-     * @usageNotes
-     *
-     * The following example creates the NgModule for a browser platform.
-     *
-     * ```typescript
-     * my_module.ts:
-     *
-     * @NgModule({
-     *   imports: [BrowserModule]
-     * })
-     * class MyModule {}
-     *
-     * main.ts:
-     * import {MyModuleNgFactory} from './my_module.ngfactory';
-     * import {platformBrowser} from '@angular/platform-browser';
-     *
-     * let moduleRef = platformBrowser().bootstrapModuleFactory(MyModuleNgFactory);
-     * ```
+     * Creates an instance of an `@NgModule` for the given platform.
      *
      * @deprecated Passing NgModule factories as the `PlatformRef.bootstrapModuleFactory` function
      *     argument is deprecated. Use the `PlatformRef.bootstrapModule` API instead.
      */
     bootstrapModuleFactory<M>(moduleFactory: NgModuleFactory<M>, options?: BootstrapOptions): Promise<NgModuleRef<M>>;
     /**
-     * Creates an instance of an `@NgModule` for a given platform using the given runtime compiler.
+     * Creates an instance of an `@NgModule` for a given platform.
      *
      * @usageNotes
      * ### Simple Example
@@ -7333,10 +7311,9 @@ export declare abstract class TemplateRef<C> {
      * and attaches it to the view container.
      * @param context The data-binding context of the embedded view, as declared
      * in the `<ng-template>` usage.
-     * @param injector Injector to be used within the embedded view.
      * @returns The new embedded view object.
      */
-    abstract createEmbeddedView(context: C, injector?: Injector): EmbeddedViewRef<C>;
+    abstract createEmbeddedView(context: C): EmbeddedViewRef<C>;
 }
 
 /**
@@ -9014,23 +8991,6 @@ export declare abstract class ViewContainerRef {
      * @returns The number of views.
      */
     abstract get length(): number;
-    /**
-     * Instantiates an embedded view and inserts it
-     * into this container.
-     * @param templateRef The HTML template that defines the view.
-     * @param context The data-binding context of the embedded view, as declared
-     * in the `<ng-template>` usage.
-     * @param options Extra configuration for the created view. Includes:
-     *  * index: The 0-based index at which to insert the new view into this container.
-     *           If not specified, appends the new view as the last entry.
-     *  * injector: Injector to be used within the embedded view.
-     *
-     * @returns The `ViewRef` instance for the newly created view.
-     */
-    abstract createEmbeddedView<C>(templateRef: TemplateRef<C>, context?: C, options?: {
-        index?: number;
-        injector?: Injector;
-    }): EmbeddedViewRef<C>;
     /**
      * Instantiates an embedded view and inserts it
      * into this container.
@@ -9820,7 +9780,7 @@ export declare function ɵfindLocaleData(locale: string): any;
  */
 export declare function ɵflushModuleScopingQueueAsMuchAsPossible(): void;
 
-export declare const ɵgetDebugNodeR2: (nativeNode: any) => DebugNode | null;
+export declare function ɵgetDebugNodeR2(_nativeNode: any): DebugNode | null;
 
 /**
  * Retrieves directive instances associated with a given DOM node. Does not include
@@ -10543,9 +10503,24 @@ export declare function ɵresolveComponentResources(resourceResolver: (url: stri
     text(): Promise<string>;
 }>)): Promise<void>;
 
-export declare class ɵRuntimeError<T = RuntimeErrorCode> extends Error {
+/**
+ * Class that represents a runtime error.
+ * Formats and outputs the error message in a consistent way.
+ *
+ * Example:
+ * ```
+ *  throw new RuntimeError(
+ *    RuntimeErrorCode.INJECTOR_ALREADY_DESTROYED,
+ *    ngDevMode && 'Injector has already been destroyed.');
+ * ```
+ *
+ * Note: the `message` argument contains a descriptive error message as a string in development
+ * mode (when the `ngDevMode` is defined). In production mode (after tree-shaking pass), the
+ * `message` argument becomes `false`, thus we account for it in the typings and the runtime logic.
+ */
+export declare class ɵRuntimeError<T extends number = RuntimeErrorCode> extends Error {
     code: T;
-    constructor(code: T, message: string);
+    constructor(code: T, message: null | false | string);
 }
 
 /**
@@ -12127,10 +12102,11 @@ export declare function ɵɵdisableBindings(): void;
  * @param name Name of the DOM Node
  * @param attrsIndex Index of the element's attributes in the `consts` array.
  * @param localRefsIndex Index of the element's local references in the `consts` array.
+ * @returns This function returns itself so that it may be chained.
  *
  * @codeGenApi
  */
-export declare function ɵɵelement(index: number, name: string, attrsIndex?: number | null, localRefsIndex?: number): void;
+export declare function ɵɵelement(index: number, name: string, attrsIndex?: number | null, localRefsIndex?: number): typeof ɵɵelement;
 
 /**
  * Creates an empty logical container using {@link elementContainerStart}
@@ -12139,17 +12115,19 @@ export declare function ɵɵelement(index: number, name: string, attrsIndex?: nu
  * @param index Index of the element in the LView array
  * @param attrsIndex Index of the container attributes in the `consts` array.
  * @param localRefsIndex Index of the container's local references in the `consts` array.
+ * @returns This function returns itself so that it may be chained.
  *
  * @codeGenApi
  */
-export declare function ɵɵelementContainer(index: number, attrsIndex?: number | null, localRefsIndex?: number): void;
+export declare function ɵɵelementContainer(index: number, attrsIndex?: number | null, localRefsIndex?: number): typeof ɵɵelementContainer;
 
 /**
  * Mark the end of the <ng-container>.
+ * @returns This function returns itself so that it may be chained.
  *
  * @codeGenApi
  */
-export declare function ɵɵelementContainerEnd(): void;
+export declare function ɵɵelementContainerEnd(): typeof ɵɵelementContainerEnd;
 
 /**
  * Creates a logical container for other nodes (<ng-container>) backed by a comment node in the DOM.
@@ -12158,6 +12136,7 @@ export declare function ɵɵelementContainerEnd(): void;
  * @param index Index of the element in the LView array
  * @param attrsIndex Index of the container attributes in the `consts` array.
  * @param localRefsIndex Index of the container's local references in the `consts` array.
+ * @returns This function returns itself so that it may be chained.
  *
  * Even if this instruction accepts a set of attributes no actual attribute values are propagated to
  * the DOM (as a comment node can't have attributes). Attributes are here only for directive
@@ -12165,14 +12144,15 @@ export declare function ɵɵelementContainerEnd(): void;
  *
  * @codeGenApi
  */
-export declare function ɵɵelementContainerStart(index: number, attrsIndex?: number | null, localRefsIndex?: number): void;
+export declare function ɵɵelementContainerStart(index: number, attrsIndex?: number | null, localRefsIndex?: number): typeof ɵɵelementContainerStart;
 
 /**
  * Mark the end of the element.
+ * @returns This function returns itself so that it may be chained.
  *
  * @codeGenApi
  */
-export declare function ɵɵelementEnd(): void;
+export declare function ɵɵelementEnd(): typeof ɵɵelementEnd;
 
 
 /**
@@ -12182,6 +12162,7 @@ export declare function ɵɵelementEnd(): void;
  * @param name Name of the DOM Node
  * @param attrsIndex Index of the element's attributes in the `consts` array.
  * @param localRefsIndex Index of the element's local references in the `consts` array.
+ * @returns This function returns itself so that it may be chained.
  *
  * Attributes and localRefs are passed as an array of strings where elements with an even index
  * hold an attribute name and elements with an odd index hold an attribute value, ex.:
@@ -12189,7 +12170,7 @@ export declare function ɵɵelementEnd(): void;
  *
  * @codeGenApi
  */
-export declare function ɵɵelementStart(index: number, name: string, attrsIndex?: number | null, localRefsIndex?: number): void;
+export declare function ɵɵelementStart(index: number, name: string, attrsIndex?: number | null, localRefsIndex?: number): typeof ɵɵelementStart;
 
 /**
  * Enables directive matching on elements.