@angular/core 12.1.0-next.4 → 12.1.1

package/fesm2015/core.js

@@ -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
  */
@@ -947,22 +947,22 @@ const autoRegisterModuleById = {};
  * @codeGenApi
  */
 function ɵɵdefineNgModule(def) {
-    const res = {
-        type: def.type,
-        bootstrap: def.bootstrap || EMPTY_ARRAY,
-        declarations: def.declarations || EMPTY_ARRAY,
-        imports: def.imports || EMPTY_ARRAY,
-        exports: def.exports || EMPTY_ARRAY,
-        transitiveCompileScopes: null,
-        schemas: def.schemas || null,
-        id: def.id || null,
-    };
-    if (def.id != null) {
-        noSideEffects(() => {
+    return noSideEffects(() => {
+        const res = {
+            type: def.type,
+            bootstrap: def.bootstrap || EMPTY_ARRAY,
+            declarations: def.declarations || EMPTY_ARRAY,
+            imports: def.imports || EMPTY_ARRAY,
+            exports: def.exports || EMPTY_ARRAY,
+            transitiveCompileScopes: null,
+            schemas: def.schemas || null,
+            id: def.id || null,
+        };
+        if (def.id != null) {
             autoRegisterModuleById[def.id] = def.type;
-        });
-    }
-    return res;
+        }
+        return res;
+    });
 }
 /**
  * Adds the module metadata that is necessary to compute the module's transitive scope to an
@@ -6548,6 +6548,10 @@ const CUSTOM_ELEMENTS_SCHEMA = {
 /**
  * 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
  */
 const NO_ERRORS_SCHEMA = {
@@ -21244,6 +21248,9 @@ class _NullComponentFactoryResolver {
  * 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
  */
 class ComponentFactoryResolver {
@@ -21462,7 +21469,7 @@ class Version {
 /**
  * @publicApi
  */
-const VERSION = new Version('12.1.0-next.4');
+const VERSION = new Version('12.1.1');
 
 /**
  * @license
@@ -23650,6 +23657,8 @@ function getParentRenderElement(view, renderHost, def) {
                 (renderParent.element.componentRendererType.encapsulation ===
                     ViewEncapsulation.ShadowDom ||
                     // TODO(FW-2290): remove the `encapsulation === 1` fallback logic in v12.
+                    // @ts-ignore TODO: Remove as part of FW-2290. TS complains about us dealing with an enum
+                    // value that is not known (but previously was the value for ViewEncapsulation.Native)
                     renderParent.element.componentRendererType.encapsulation === 1))) {
             // only children of non components, or children of components with native encapsulation should
             // be attached.
@@ -26138,6 +26147,7 @@ class QueryList {
         this.changes.unsubscribe();
     }
 }
+Symbol.iterator;
 
 /**
  * @license
@@ -29557,20 +29567,41 @@ class ApplicationRef {
             merge$1(isCurrentlyStable, isStable.pipe(share()));
     }
     /**
-     * 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(componentOrFactory, rootSelectorOrNode) {
         if (!this._initStatus.done) {