@angular/core 14.1.0-next.0 → 14.1.0-next.3

package/fesm2020/testing.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v14.1.0-next.0
+ * @license Angular v14.1.0-next.3
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -862,6 +862,68 @@ const NG_INJ_DEF = getClosureSafeProperty({ ɵinj: getClosureSafeProperty });
 const NG_INJECTABLE_DEF = getClosureSafeProperty({ ngInjectableDef: getClosureSafeProperty });
 const NG_INJECTOR_DEF = getClosureSafeProperty({ ngInjectorDef: getClosureSafeProperty });
 
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+/**
+ * Base URL for the error details page.
+ *
+ * Keep the files below in full sync:
+ *  - packages/compiler-cli/src/ngtsc/diagnostics/src/error_details_base_url.ts
+ *  - packages/core/src/error_details_base_url.ts
+ */
+const ERROR_DETAILS_PAGE_BASE_URL = 'https://angular.io/errors';
+
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+/**
+ * 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.
+ */
+class RuntimeError extends Error {
+    constructor(code, message) {
+        super(formatRuntimeError(code, message));
+        this.code = code;
+    }
+}
+/**
+ * Called to format a runtime error.
+ * See additional info on the `message` argument type in the `RuntimeError` class description.
+ */
+function formatRuntimeError(code, message) {
+    // Error code might be a negative number, which is a special marker that instructs the logic to
+    // generate a link to the error details page on angular.io.
+    const fullCode = `NG0${Math.abs(code)}`;
+    let errorMessage = `${fullCode}${message ? ': ' + message.trim() : ''}`;
+    if (ngDevMode && code < 0) {
+        const addPeriodSeparator = !errorMessage.match(/[.,;!?]$/);
+        const separator = addPeriodSeparator ? '.' : '';
+        errorMessage =
+            `${errorMessage}${separator} Find more at ${ERROR_DETAILS_PAGE_BASE_URL}/${fullCode}`;
+    }
+    return errorMessage;
+}
+
 /**
  * @license
  * Copyright Google LLC All Rights Reserved.
@@ -1790,68 +1852,6 @@ function initNgDevMode() {
     return false;
 }
 
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-/**
- * Base URL for the error details page.
- *
- * Keep the files below in full sync:
- *  - packages/compiler-cli/src/ngtsc/diagnostics/src/error_details_base_url.ts
- *  - packages/core/src/error_details_base_url.ts
- */
-const ERROR_DETAILS_PAGE_BASE_URL = 'https://angular.io/errors';
-
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-/**
- * 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.
- */
-class RuntimeError extends Error {
-    constructor(code, message) {
-        super(formatRuntimeError(code, message));
-        this.code = code;
-    }
-}
-/**
- * Called to format a runtime error.
- * See additional info on the `message` argument type in the `RuntimeError` class description.
- */
-function formatRuntimeError(code, message) {
-    // Error code might be a negative number, which is a special marker that instructs the logic to
-    // generate a link to the error details page on angular.io.
-    const fullCode = `NG0${Math.abs(code)}`;
-    let errorMessage = `${fullCode}${message ? ': ' + message.trim() : ''}`;
-    if (ngDevMode && code < 0) {
-        const addPeriodSeparator = !errorMessage.match(/[.,;!?]$/);
-        const separator = addPeriodSeparator ? '.' : '';
-        errorMessage =
-            `${errorMessage}${separator} Find more at ${ERROR_DETAILS_PAGE_BASE_URL}/${fullCode}`;
-    }
-    return errorMessage;
-}
-
 /**
  * @license
  * Copyright Google LLC All Rights Reserved.
@@ -2045,10 +2045,8 @@ function setCurrentInjector(injector) {
 }
 function injectInjectorOnly(token, flags = InjectFlags.Default) {
     if (_currentInjector === undefined) {
-        const errorMessage = (typeof ngDevMode === 'undefined' || ngDevMode) ?
-            `inject() must be called from an injection context (a constructor, a factory function or a field initializer)` :
-            '';
-        throw new RuntimeError(-203 /* RuntimeErrorCode.MISSING_INJECTION_CONTEXT */, errorMessage);
+        throw new RuntimeError(-203 /* RuntimeErrorCode.MISSING_INJECTION_CONTEXT */, ngDevMode &&
+            `inject() must be called from an injection context (a constructor, a factory function or a field initializer)`);
     }
     else if (_currentInjector === null) {
         return injectRootLimpMode(token, undefined, flags);
@@ -2064,22 +2062,17 @@ function ɵɵinject(token, flags = InjectFlags.Default) {
  * Throws an error indicating that a factory function could not be generated by the compiler for a
  * particular class.
  *
- * This instruction allows the actual error message to be optimized away when ngDevMode is turned
- * off, saving bytes of generated code while still providing a good experience in dev mode.
- *
  * The name of the class is not mentioned here, but will be in the generated factory function name
  * and thus in the stack trace.
  *
  * @codeGenApi
  */
 function ɵɵinvalidFactoryDep(index) {
-    const msg = ngDevMode ?
+    throw new RuntimeError(202 /* RuntimeErrorCode.INVALID_FACTORY_DEPENDENCY */, ngDevMode &&
         `This constructor is not compatible with Angular Dependency Injection because its dependency at index ${index} of the parameter list is invalid.
 This can happen if the dependency type is a primitive like a string or if an ancestor of this class is missing an Angular decorator.
 
-Please check that 1) the type for the parameter at index ${index} is correct and 2) the correct Angular decorators are defined for this class and its ancestors.` :
-        'invalid';
-    throw new Error(msg);
+Please check that 1) the type for the parameter at index ${index} is correct and 2) the correct Angular decorators are defined for this class and its ancestors.`);
 }
 /**
  * Injects a token from the currently active injector.
@@ -2154,10 +2147,7 @@ function injectArgs(types) {
         const arg = resolveForwardRef(types[i]);
         if (Array.isArray(arg)) {
             if (arg.length === 0) {
-                const errorMessage = (typeof ngDevMode === 'undefined' || ngDevMode) ?
-                    'Arguments array must have arguments.' :
-                    '';
-                throw new RuntimeError(900 /* RuntimeErrorCode.INVALID_DIFFER_INPUT */, errorMessage);
+                throw new RuntimeError(900 /* RuntimeErrorCode.INVALID_DIFFER_INPUT */, ngDevMode && 'Arguments array must have arguments.');
             }
             let type = undefined;
             let flags = InjectFlags.Default;
@@ -3271,8 +3261,17 @@ var RendererStyleFlags3;
 function isProceduralRenderer(renderer) {
     return !!(renderer.listen);
 }
+let renderer3Enabled = false;
+function enableRenderer3() {
+    renderer3Enabled = true;
+}
 const domRendererFactory3 = {
     createRenderer: (hostElement, rendererType) => {
+        if (!renderer3Enabled) {
+            throw new Error(ngDevMode ?
+                `Renderer3 is not supported. This problem is likely caused by some component in the hierarchy was constructed without a correct parent injector.` :
+                'Renderer3 disabled');
+        }
         return getDocument();
     }
 };
@@ -5487,7 +5486,7 @@ function reflectDependency(dep) {
             }
             else if (param instanceof Attribute) {
                 if (param.attributeName === undefined) {
-                    throw new Error(`Attribute name must be defined.`);
+                    throw new RuntimeError(204 /* RuntimeErrorCode.INVALID_INJECTION_TOKEN */, ngDevMode && `Attribute name must be defined.`);
                 }
                 meta.attribute = param.attributeName;
             }
@@ -6489,10 +6488,8 @@ function ɵɵsanitizeResourceUrl(unsafeResourceUrl) {
     if (allowSanitizationBypassAndThrow(unsafeResourceUrl, "ResourceURL" /* BypassType.ResourceUrl */)) {
         return trustedScriptURLFromStringBypass(unwrapSafeValue(unsafeResourceUrl));
     }
-    const errorMessage = (typeof ngDevMode === 'undefined' || ngDevMode) ?
-        'unsafe value used in a resource URL context (see https://g.co/ng/security#xss)' :
-        '';
-    throw new RuntimeError(904 /* RuntimeErrorCode.UNSAFE_VALUE_IN_RESOURCE_URL */, errorMessage);
+    throw new RuntimeError(904 /* RuntimeErrorCode.UNSAFE_VALUE_IN_RESOURCE_URL */, ngDevMode &&
+        'unsafe value used in a resource URL context (see https://g.co/ng/security#xss)');
 }
 /**
  * A `script` sanitizer which only lets trusted javascript through.
@@ -6514,10 +6511,7 @@ function ɵɵsanitizeScript(unsafeScript) {
     if (allowSanitizationBypassAndThrow(unsafeScript, "Script" /* BypassType.Script */)) {
         return trustedScriptFromStringBypass(unwrapSafeValue(unsafeScript));
     }
-    const errorMessage = (typeof ngDevMode === 'undefined' || ngDevMode) ?
-        'unsafe value used in a script context' :
-        '';
-    throw new RuntimeError(905 /* RuntimeErrorCode.UNSAFE_VALUE_IN_SCRIPT */, errorMessage);
+    throw new RuntimeError(905 /* RuntimeErrorCode.UNSAFE_VALUE_IN_SCRIPT */, ngDevMode && 'unsafe value used in a script context');
 }
 /**
  * A template tag function for promoting the associated constant literal to a
@@ -10128,7 +10122,7 @@ class ReflectiveKey {
         this.token = token;
         this.id = id;
         if (!token) {
-            throw new Error('Token must be defined!');
+            throw new RuntimeError(208 /* RuntimeErrorCode.MISSING_INJECTION_TOKEN */, ngDevMode && 'Token must be defined!');
         }
         this.displayName = stringify(this.token);
     }
@@ -14198,6 +14192,7 @@ const NULL_INJECTOR = {
 function renderComponent(componentType /* Type as workaround for: Microsoft/TypeScript/issues/4881 */, opts = {}) {
     ngDevMode && publishDefaultGlobalUtils();
     ngDevMode && assertComponentType(componentType);
+    enableRenderer3();
     const rendererFactory = opts.rendererFactory || domRendererFactory3;
     const sanitizer = opts.sanitizer || null;
     const componentDef = getComponentDef$1(componentType);
@@ -14385,10 +14380,8 @@ function ɵɵInheritDefinitionFeature(definition) {
         }
         else {
             if (superType.ɵcmp) {
-                const errorMessage = (typeof ngDevMode === 'undefined' || ngDevMode) ?
-                    `Directives cannot inherit Components. Directive ${stringifyForError(definition.type)} is attempting to extend component ${stringifyForError(superType)}` :
-                    '';
-                throw new RuntimeError(903 /* RuntimeErrorCode.INVALID_INHERITANCE */, errorMessage);
+                throw new RuntimeError(903 /* RuntimeErrorCode.INVALID_INHERITANCE */, ngDevMode &&
+                    `Directives cannot inherit Components. Directive ${stringifyForError(definition.type)} is attempting to extend component ${stringifyForError(superType)}`);
             }
             // Don't use getComponentDef/getDirectiveDef. This logic relies on inheritance.
             superDef = superType.ɵdir;
@@ -19509,7 +19502,7 @@ function findLocaleData(locale) {
     if (parentLocale === 'en') {
         return localeEn;
     }
-    throw new Error(`Missing locale data for the locale "${locale}".`);
+    throw new RuntimeError(701 /* RuntimeErrorCode.MISSING_LOCALE_DATA */, ngDevMode && `Missing locale data for the locale "${locale}".`);
 }
 /**
  * Retrieves the default currency code for the given locale.
@@ -22085,7 +22078,7 @@ class Version {
 /**
  * @publicApi
  */
-const VERSION = new Version('14.1.0-next.0');
+const VERSION = new Version('14.1.0-next.3');
 
 /**
  * @license
@@ -22423,8 +22416,7 @@ class ViewRef {
     }
     attachToViewContainerRef() {
         if (this._appRef) {
-            const errorMessage = ngDevMode ? 'This view is already attached directly to the ApplicationRef!' : '';
-            throw new RuntimeError(902 /* RuntimeErrorCode.VIEW_ALREADY_ATTACHED */, errorMessage);
+            throw new RuntimeError(902 /* RuntimeErrorCode.VIEW_ALREADY_ATTACHED */, ngDevMode && 'This view is already attached directly to the ApplicationRef!');
         }
         this._attachedToViewContainer = true;
     }
@@ -22434,8 +22426,7 @@ class ViewRef {
     }
     attachToAppRef(appRef) {
         if (this._attachedToViewContainer) {
-            const errorMessage = ngDevMode ? 'This view is already attached to a ViewContainer!' : '';
-            throw new RuntimeError(902 /* RuntimeErrorCode.VIEW_ALREADY_ATTACHED */, errorMessage);
+            throw new RuntimeError(902 /* RuntimeErrorCode.VIEW_ALREADY_ATTACHED */, ngDevMode && 'This view is already attached to a ViewContainer!');
         }
         this._appRef = appRef;
     }
@@ -22756,10 +22747,18 @@ class EnvironmentNgModuleRefAdapter extends NgModuleRef$1 {
 /**
  * Create a new environment injector.
  *
+ * Learn more about environment injectors in
+ * [this guide](guide/standalone-components#environment-injectors).
+ *
+ * @param providers An array of providers.
+ * @param parent A parent environment injector.
+ * @param debugName An optional name for this injector instance, which will be used in error
+ *     messages.
+ *
  * @publicApi
  * @developerPreview
  */
-function createEnvironmentInjector(providers, parent = null, debugName = null) {
+function createEnvironmentInjector(providers, parent, debugName = null) {
     const adapter = new EnvironmentNgModuleRefAdapter(providers, parent, debugName);
     return adapter.injector;
 }
@@ -24713,7 +24712,7 @@ function patchModuleCompilation() {
 function isModuleWithProviders$1(value) {
     return value.ngModule !== undefined;
 }
-function isNgModule(value) {
+function isNgModule$1(value) {
     return !!getNgModuleDef(value);
 }
 
@@ -25102,6 +25101,7 @@ function setScopeOnDeclaredComponents(moduleType, ngModule) {
     const declarations = flatten$1(ngModule.declarations || EMPTY_ARRAY);
     const transitiveScopes = transitiveScopesFor(moduleType);
     declarations.forEach(declaration => {
+        declaration = resolveForwardRef(declaration);
         if (declaration.hasOwnProperty(NG_COMP_DEF)) {
             // A `ɵcmp` field exists - go ahead and patch the component directly.
             const component = declaration;
@@ -25135,7 +25135,7 @@ function patchComponentDefWithScope(componentDef, transitiveScopes) {
  * (either a NgModule or a standalone component / directive / pipe).
  */
 function transitiveScopesFor(type) {
-    if (isNgModule(type)) {
+    if (isNgModule$1(type)) {
         return transitiveScopesForNgModule(type);
     }
     else if (isStandalone(type)) {
@@ -25219,7 +25219,7 @@ function transitiveScopesForNgModule(moduleType) {
         const exportedType = exported;
         // Either the type is a module, a pipe, or a component/directive (which may not have a
         // ɵcmp as it might be compiled asynchronously).
-        if (isNgModule(exportedType)) {
+        if (isNgModule$1(exportedType)) {
             // When this module exports another, the exported module's exported directives and pipes are
             // added to both the compilation and exported scopes of this module.
             const exportedScope = transitiveScopesFor(exportedType);
@@ -25526,7 +25526,7 @@ class R3TestBedCompiler {
         // module's provider list.
         this.providerOverridesByModule = new Map();
         this.providerOverridesByToken = new Map();
-        this.moduleProvidersOverridden = new Set();
+        this.scopesWithOverriddenProviders = new Set();
         this.testModuleRef = null;
         class DynamicTestModule {
         }
@@ -25694,7 +25694,7 @@ class R3TestBedCompiler {
         this.queueTypesFromModulesArray([moduleType]);
         this.compileTypesSync();
         this.applyProviderOverrides();
-        this.applyProviderOverridesToModule(moduleType);
+        this.applyProviderOverridesInScope(moduleType);
         this.applyTransitiveScopes();
     }
     /**
@@ -25704,7 +25704,7 @@ class R3TestBedCompiler {
         this.queueTypesFromModulesArray([moduleType]);
         await this.compileComponents();
         this.applyProviderOverrides();
-        this.applyProviderOverridesToModule(moduleType);
+        this.applyProviderOverridesInScope(moduleType);
         this.applyTransitiveScopes();
     }
     /**
@@ -25805,50 +25805,52 @@ class R3TestBedCompiler {
         this.seenComponents.clear();
         this.seenDirectives.clear();
     }
-    applyProviderOverridesToModule(moduleType) {
-        if (this.moduleProvidersOverridden.has(moduleType)) {
+    /**
+     * Applies provider overrides to a given type (either an NgModule or a standalone component)
+     * and all imported NgModules and standalone components recursively.
+     */
+    applyProviderOverridesInScope(type) {
+        const hasScope = isStandaloneComponent(type) || isNgModule(type);
+        // The function can be re-entered recursively while inspecting dependencies
+        // of an NgModule or a standalone component. Exit early if we come across a
+        // type that can not have a scope (directive or pipe) or the type is already
+        // processed earlier.
+        if (!hasScope || this.scopesWithOverriddenProviders.has(type)) {
             return;
         }
-        this.moduleProvidersOverridden.add(moduleType);
+        this.scopesWithOverriddenProviders.add(type);
         // NOTE: the line below triggers JIT compilation of the module injector,
         // which also invokes verification of the NgModule semantics, which produces
         // detailed error messages. The fact that the code relies on this line being
         // present here is suspicious and should be refactored in a way that the line
         // below can be moved (for ex. after an early exit check below).
-        const injectorDef = moduleType[ɵNG_INJ_DEF];
+        const injectorDef = type[ɵNG_INJ_DEF];
         // No provider overrides, exit early.
         if (this.providerOverridesByToken.size === 0)
             return;
-        if (isStandaloneComponent(moduleType)) {
+        if (isStandaloneComponent(type)) {
             // Visit all component dependencies and override providers there.
-            const def = getComponentDef(moduleType);
+            const def = getComponentDef(type);
             const dependencies = maybeUnwrapFn(def.dependencies ?? []);
             for (const dependency of dependencies) {
-                // Proceed with examining dependencies recursively
-                // when a dependency is a standalone component or an NgModule.
-                // In AOT, the `dependencies` might also contain regular (NgModule-based)
-                // Component, Directive and Pipes. Skip them here, they are handled in a
-                // different location (in the `configureTestingModule` function).
-                if (isStandaloneComponent(dependency) || hasNgModuleDef(dependency)) {
-                    this.applyProviderOverridesToModule(dependency);
-                }
+                this.applyProviderOverridesInScope(dependency);
             }
         }
         else {
             const providers = [
                 ...injectorDef.providers,
-                ...(this.providerOverridesByModule.get(moduleType) || [])
+                ...(this.providerOverridesByModule.get(type) || [])
             ];
             if (this.hasProviderOverrides(providers)) {
-                this.maybeStoreNgDef(ɵNG_INJ_DEF, moduleType);
-                this.storeFieldOfDefOnType(moduleType, ɵNG_INJ_DEF, 'providers');
+                this.maybeStoreNgDef(ɵNG_INJ_DEF, type);
+                this.storeFieldOfDefOnType(type, ɵNG_INJ_DEF, 'providers');
                 injectorDef.providers = this.getOverriddenProviders(providers);
             }
             // Apply provider overrides to imported modules recursively
-            const moduleDef = moduleType[ɵNG_MOD_DEF];
+            const moduleDef = type[ɵNG_MOD_DEF];
             const imports = maybeUnwrapFn(moduleDef.imports);
             for (const importedModule of imports) {
-                this.applyProviderOverridesToModule(importedModule);
+                this.applyProviderOverridesInScope(importedModule);
             }
             // Also override the providers on any ModuleWithProviders imports since those don't appear in
             // the moduleDef.
@@ -26085,7 +26087,7 @@ class R3TestBedCompiler {
             });
         });
         this.initialNgDefs.clear();
-        this.moduleProvidersOverridden.clear();
+        this.scopesWithOverriddenProviders.clear();
         this.restoreComponentResolutionQueue();
         // Restore the locale ID to the default value, this shouldn't be necessary but we never know
         ɵsetLocaleId(ɵDEFAULT_LOCALE_ID);
@@ -26112,7 +26114,7 @@ class R3TestBedCompiler {
             providers,
         }, /* allowDuplicateDeclarationsInRoot */ true);
         // clang-format on
-        this.applyProviderOverridesToModule(this.testModuleType);
+        this.applyProviderOverridesInScope(this.testModuleType);
     }
     get injector() {
         if (this._injector !== null) {
@@ -26212,6 +26214,9 @@ function getComponentDef(value) {
 function hasNgModuleDef(value) {
     return value.hasOwnProperty('ɵmod');
 }
+function isNgModule(value) {
+    return hasNgModuleDef(value);
+}
 function maybeUnwrapFn(maybeFn) {
     return maybeFn instanceof Function ? maybeFn() : maybeFn;
 }