@angular/core 12.1.0-next.4 → 12.1.1

package/core.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v12.1.0-next.4
+ * @license Angular v12.1.1
  * (c) 2010-2021 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -411,20 +411,41 @@ export declare class ApplicationRef {
      */
     readonly isStable: Observable<boolean>;
     /**
-     * Bootstrap a new component at the root level of the application.
+     * Bootstrap a component onto the element identified by its selector or, optionally, to a
+     * specified element.
      *
      * @usageNotes
      * ### Bootstrap process
      *
-     * When bootstrapping a new root component into an application, Angular mounts the
-     * specified application component onto DOM elements identified by the componentType's
-     * selector and kicks off automatic change detection to finish initializing the component.
+     * When bootstrapping a component, Angular mounts it onto a target DOM element
+     * and kicks off automatic change detection. The target DOM element can be
+     * provided using the `rootSelectorOrNode` argument.
      *
-     * Optionally, a component can be mounted onto a DOM element that does not match the
-     * componentType's selector.
+     * If the target DOM element is not provided, Angular tries to find one on a page
+     * using the `selector` of the component that is being bootstrapped
+     * (first matched element is used).
      *
      * ### Example
-     * {@example core/ts/platform/platform.ts region='longform'}
+     *
+     * Generally, we define the component to bootstrap in the `bootstrap` array of `NgModule`,
+     * but it requires us to know the component while writing the application code.
+     *
+     * Imagine a situation where we have to wait for an API call to decide about the component to
+     * bootstrap. We can use the `ngDoBootstrap` hook of the `NgModule` and call this method to
+     * dynamically bootstrap a component.
+     *
+     * {@example core/ts/platform/platform.ts region='componentSelector'}
+     *
+     * Optionally, a component can be mounted onto a DOM element that does not match the
+     * selector of the bootstrapped component.
+     *
+     * In the following example, we are providing a CSS selector to match the target element.
+     *
+     * {@example core/ts/platform/platform.ts region='cssSelector'}
+     *
+     * While in this example, we are providing reference to a DOM node.
+     *
+     * {@example core/ts/platform/platform.ts region='domNode'}
      */
     bootstrap<C>(componentOrFactory: ComponentFactory<C> | Type<C>, rootSelectorOrNode?: string | any): ComponentRef<C>;
     /**
@@ -1153,6 +1174,9 @@ export { ComponentFactory as ɵComponentFactory }
  * then use the factory's `create()` method to create a component of that type.
  *
  * @see [Dynamic Components](guide/dynamic-component-loader)
+ * @see [Usage Example](guide/dynamic-component-loader#resolving-components)
+ * @see <live-example name="dynamic-component-loader" noDownload></live-example>
+of the code in this cookbook
  * @publicApi
  */
 export declare abstract class ComponentFactoryResolver {
@@ -1318,6 +1342,17 @@ export declare interface ContentChildDecorator {
      * * **static** - True to resolve query results before change detection runs,
      * false to resolve after change detection. Defaults to false.
      *
+     * The following selectors are supported.
+     *   * Any class with the `@Component` or `@Directive` decorator
+     *   * A template reference variable as a string (e.g. query `<my-component #cmp></my-component>`
+     * with `@ContentChild('cmp')`)
+     *   * Any provider defined in the child component tree of the current component (e.g.
+     * `@ContentChild(SomeService) someService: SomeService`)
+     *   * Any provider defined through a string token (e.g. `@ContentChild('someToken') someTokenVal:
+     * any`)
+     *   * A `TemplateRef` (e.g. query `<ng-template></ng-template>` with `@ContentChild(TemplateRef)
+     * template;`)
+     *
      * The following values are supported by `read`:
      *   * Any class with the `@Component` or `@Directive` decorator
      *   * Any provider defined on the injector of the component that is matched by the `selector` of
@@ -1394,6 +1429,20 @@ export declare interface ContentChildrenDecorator {
      *   removed in future versions of Angular.
      * * **read** - Used to read a different token from the queried elements.
      *
+     * The following selectors are supported.
+     *   * Any class with the `@Component` or `@Directive` decorator
+     *   * A template reference variable as a string (e.g. query `<my-component #cmp></my-component>`
+     * with `@ContentChildren('cmp')`)
+     *   * Any provider defined in the child component tree of the current component (e.g.
+     * `@ContentChildren(SomeService) someService: SomeService`)
+     *   * Any provider defined through a string token (e.g. `@ContentChildren('someToken')
+     * someTokenVal: any`)
+     *   * A `TemplateRef` (e.g. query `<ng-template></ng-template>` with
+     * `@ContentChildren(TemplateRef) template;`)
+     *
+     * In addition, multiple string selectors can be separated with a comma (e.g.
+     * `@ContentChildren('cmp1,cmp2')`)
+     *
      * The following values are supported by `read`:
      *   * Any class with the `@Component` or `@Directive` decorator
      *   * Any provider defined on the injector of the component that is matched by the `selector` of
@@ -2287,6 +2336,9 @@ declare interface DisposableFn {
  * See ["Bootstrapping"](guide/bootstrapping) and ["Entry components"](guide/entry-components).
  *
  * @usageNotes
+ * The example below uses `ApplicationRef.bootstrap()` to render the
+ * `AppComponent` on the page.
+ *
  * ```typescript
  * class AppModule implements DoBootstrap {
  *   ngDoBootstrap(appRef: ApplicationRef) {
@@ -4630,7 +4682,10 @@ export declare interface NgModule {
      * using one of the imperative techniques, such as `ViewContainerRef.createComponent()`.
      *
      * @see [Entry Components](guide/entry-components)
-     * @deprecated Since 9.0.0. With Ivy, this property is no longer necessary.
+     * @deprecated
+     * Since 9.0.0. With Ivy, this property is no longer necessary.
+     * (You may need to keep these if building a library that will be consumed by a View Engine
+     * application.)
      */
     entryComponents?: Array<Type<any> | any[]>;
     /**
@@ -4923,6 +4978,10 @@ export declare class NgZone {
 /**
  * Defines a schema that allows any property on any element.
  *
+ * This schema allows you to ignore the errors related to any unknown elements or properties in a
+ * template. The usage of this schema is generally discouraged because it prevents useful validation
+ * and may hide real errors in your template. Consider using the `CUSTOM_ELEMENTS_SCHEMA` instead.
+ *
  * @publicApi
  */
 export declare const NO_ERRORS_SCHEMA: SchemaMetadata;
@@ -8008,7 +8067,7 @@ export declare interface TrackByFunction<T> {
      * @param index The index of the item within the iterable.
      * @param item The item in the iterable.
      */
-    (index: number, item: T): any;
+    <U extends T>(index: number, item: U): any;
 }
 
 /**
@@ -8720,6 +8779,20 @@ export declare interface ViewChildrenDecorator {
      *   ** Note: *** This config option is **deprecated**, it will be permanently set to `true` and
      * removed in future versions of Angular.
      *
+     * The following selectors are supported.
+     *   * Any class with the `@Component` or `@Directive` decorator
+     *   * A template reference variable as a string (e.g. query `<my-component #cmp></my-component>`
+     * with `@ViewChildren('cmp')`)
+     *   * Any provider defined in the child component tree of the current component (e.g.
+     * `@ViewChildren(SomeService) someService: SomeService`)
+     *   * Any provider defined through a string token (e.g. `@ViewChildren('someToken') someTokenVal:
+     * any`)
+     *   * A `TemplateRef` (e.g. query `<ng-template></ng-template>` with `@ViewChildren(TemplateRef)
+     * template;`)
+     *
+     * In addition, multiple string selectors can be separated with a comma (e.g.
+     * `@ViewChildren('cmp1,cmp2')`)
+     *
      * The following values are supported by `read`:
      *   * Any class with the `@Component` or `@Directive` decorator
      *   * Any provider defined on the injector of the component that is matched by the `selector` of
@@ -8802,6 +8875,8 @@ export declare abstract class ViewContainerRef {
      * 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 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.
      *