@angular/core 16.0.0 → 16.0.2

package/fesm2022/testing.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v16.0.0
+ * @license Angular v16.0.2
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -941,10 +941,7 @@ function throwError(msg, actual, expected, comparison) {
         (comparison == null ? '' : ` [Expected=> ${expected} ${comparison} ${actual} <=Actual]`));
 }
 function assertDomNode(node) {
-    // If we're in a worker, `Node` will not be defined.
-    if (!(typeof Node !== 'undefined' && node instanceof Node) &&
-        !(typeof node === 'object' && node != null &&
-            node.constructor.name === 'WebWorkerRenderNode')) {
+    if (!(node instanceof Node)) {
         throwError(`The provided value must be an instance of a DOM Node but got ${stringify(node)}`);
     }
 }
@@ -2042,6 +2039,7 @@ function formatError(text, obj, injectorErrorName, source = null) {
 /**
  * Inject decorator and metadata.
  *
+ * @Annotation
  * @publicApi
  */
 const Inject = attachInjectFlag(
@@ -2051,7 +2049,7 @@ makeParamDecorator('Inject', (token) => ({ token })), -1 /* DecoratorFlags.Injec
 /**
  * Optional decorator and metadata.
  *
-
+ * @Annotation
  * @publicApi
  */
 const Optional = 
@@ -2061,7 +2059,7 @@ attachInjectFlag(makeParamDecorator('Optional'), 8 /* InternalInjectFlags.Option
 /**
  * Self decorator and metadata.
  *
-
+ * @Annotation
  * @publicApi
  */
 const Self = 
@@ -2071,7 +2069,7 @@ attachInjectFlag(makeParamDecorator('Self'), 2 /* InternalInjectFlags.Self */);
 /**
  * `SkipSelf` decorator and metadata.
  *
-
+ * @Annotation
  * @publicApi
  */
 const SkipSelf = 
@@ -2081,7 +2079,7 @@ attachInjectFlag(makeParamDecorator('SkipSelf'), 4 /* InternalInjectFlags.SkipSe
 /**
  * Host decorator and metadata.
  *
-
+ * @Annotation
  * @publicApi
  */
 const Host = 
@@ -3086,7 +3084,7 @@ function getPipeDef$1(type) {
 /**
  * Checks whether a given Component, Directive or Pipe is marked as standalone.
  * This will return false if passed anything other than a Component, Directive, or Pipe class
- * See this guide for additional information: https://angular.io/guide/standalone-components
+ * See [this guide](/guide/standalone-components) for additional information:
  *
  * @param type A reference to a Component, Directive or Pipe.
  * @publicApi
@@ -3166,6 +3164,9 @@ function getComponentId(componentDef) {
         componentDef.decls,
         componentDef.encapsulation,
         componentDef.standalone,
+        componentDef.exportAs,
+        JSON.stringify(componentDef.inputs),
+        JSON.stringify(componentDef.outputs),
         // We cannot use 'componentDef.type.name' as the name of the symbol will change and will not
         // match in the server and browser bundles.
         Object.getOwnPropertyNames(componentDef.type.prototype),
@@ -3429,10 +3430,12 @@ function getFactoryDef(type, throwNotFound) {
  */
 const SIGNAL = Symbol('SIGNAL');
 /**
- * Checks if the given `value` function is a reactive `Signal`.
+ * Checks if the given `value` is a reactive `Signal`.
+ *
+ * @developerPreview
  */
 function isSignal(value) {
-    return value[SIGNAL] !== undefined;
+    return typeof value === 'function' && value[SIGNAL] !== undefined;
 }
 /**
  * Converts `fn` into a marked signal function (where `isSignal(fn)` will be `true`), and
@@ -6083,6 +6086,7 @@ function ɵɵinjectAttribute(attrNameToInject) {
 /**
  * Attribute decorator and metadata.
  *
+ * @Annotation
  * @publicApi
  */
 const Attribute = makeParamDecorator('Attribute', (attributeName) => ({ attributeName, __NG_ELEMENT_ID__: () => ɵɵinjectAttribute(attributeName) }));
@@ -6383,7 +6387,7 @@ function isPropertyValid(element, propName, tagName, schemas) {
     if (schemas === null)
         return true;
     // The property is considered valid if the element matches the schema, it exists on the element,
-    // or it is synthetic, and we are in a browser context (web worker nodes should be skipped).
+    // or it is synthetic.
     if (matchingSchemas(schemas, tagName) || propName in element || isAnimationProp(propName)) {
         return true;
     }
@@ -6525,6 +6529,59 @@ function matchingSchemas(schemas, tagName) {
     return false;
 }
 
+/**
+ * The name of an attribute that can be added to the hydration boundary node
+ * (component host node) to disable hydration for the content within that boundary.
+ */
+const SKIP_HYDRATION_ATTR_NAME = 'ngSkipHydration';
+/**
+ * Helper function to check if a given node has the 'ngSkipHydration' attribute
+ */
+function hasNgSkipHydrationAttr(tNode) {
+    const SKIP_HYDRATION_ATTR_NAME_LOWER_CASE = SKIP_HYDRATION_ATTR_NAME.toLowerCase();
+    const attrs = tNode.mergedAttrs;
+    if (attrs === null)
+        return false;
+    // only ever look at the attribute name and skip the values
+    for (let i = 0; i < attrs.length; i += 2) {
+        const value = attrs[i];
+        // This is a marker, which means that the static attributes section is over,
+        // so we can exit early.
+        if (typeof value === 'number')
+            return false;
+        if (typeof value === 'string' && value.toLowerCase() === SKIP_HYDRATION_ATTR_NAME_LOWER_CASE) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Checks whether a TNode has a flag to indicate that it's a part of
+ * a skip hydration block.
+ */
+function hasInSkipHydrationBlockFlag(tNode) {
+    return (tNode.flags & 128 /* TNodeFlags.inSkipHydrationBlock */) === 128 /* TNodeFlags.inSkipHydrationBlock */;
+}
+/**
+ * Helper function that determines if a given node is within a skip hydration block
+ * by navigating up the TNode tree to see if any parent nodes have skip hydration
+ * attribute.
+ *
+ * TODO(akushnir): this function should contain the logic of `hasInSkipHydrationBlockFlag`,
+ * there is no need to traverse parent nodes when we have a TNode flag (which would also
+ * make this lookup O(1)).
+ */
+function isInSkipHydrationBlock(tNode) {
+    let currentTNode = tNode.parent;
+    while (currentTNode) {
+        if (hasNgSkipHydrationAttr(currentTNode)) {
+            return true;
+        }
+        currentTNode = currentTNode.parent;
+    }
+    return false;
+}
+
 /**
  * Flags for renderer-specific style modifiers.
  * @publicApi
@@ -7404,12 +7461,14 @@ function processCleanups(tView, lView) {
     }
     const destroyHooks = lView[ON_DESTROY_HOOKS];
     if (destroyHooks !== null) {
+        // Reset the ON_DESTROY_HOOKS array before iterating over it to prevent hooks that unregister
+        // themselves from mutating the array during iteration.
+        lView[ON_DESTROY_HOOKS] = null;
         for (let i = 0; i < destroyHooks.length; i++) {
             const destroyHooksFn = destroyHooks[i];
             ngDevMode && assertFunction(destroyHooksFn, 'Expecting destroy hook to be a function.');
             destroyHooksFn();
         }
-        lView[ON_DESTROY_HOOKS] = null;
     }
 }
 /** Calls onDestroy hooks for this view */
@@ -7824,6 +7883,11 @@ function applyProjectionRecursive(renderer, action, lView, tProjectionNode, pare
     else {
         let nodeToProject = nodeToProjectOrRNodes;
         const projectedComponentLView = componentLView[PARENT];
+        // If a parent <ng-content> is located within a skip hydration block,
+        // annotate an actual node that is being projected with the same flag too.
+        if (hasInSkipHydrationBlockFlag(tProjectionNode)) {
+            nodeToProject.flags |= 128 /* TNodeFlags.inSkipHydrationBlock */;
+        }
         applyNodes(renderer, action, nodeToProject, projectedComponentLView, parentRElement, beforeNode, true);
     }
 }
@@ -8124,7 +8188,7 @@ function ɵɵvalidateIframeAttribute(attrValue, tagName, attrName) {
  * When running ivy outside of a browser environment, it is necessary to call `setDocument()` to
  * tell ivy what the global `document` is.
  *
- * Angular does this for us in each of the standard platforms (`Browser`, `Server`, and `WebWorker`)
+ * Angular does this for us in each of the standard platforms (`Browser` and `Server`)
  * by calling `setDocument()` when providing the `DOCUMENT` token.
  */
 let DOCUMENT = undefined;
@@ -8151,12 +8215,13 @@ function getDocument() {
     else if (typeof document !== 'undefined') {
         return document;
     }
+    throw new RuntimeError(210 /* RuntimeErrorCode.MISSING_DOCUMENT */, (typeof ngDevMode === 'undefined' || ngDevMode) &&
+        `The document object is not available in this context. Make sure the DOCUMENT injection token is provided.`);
     // No "document" can be found. This should only happen if we are running ivy outside Angular and
     // the current platform is not a browser. Since this is not a supported scenario at the moment
     // this should not happen in Angular apps.
     // Once we support running ivy outside of Angular we will need to publish `setDocument()` as a
-    // public API. Meanwhile we just return `undefined` and let the application fail.
-    return undefined;
+    // public API.
 }
 
 /**
@@ -9400,7 +9465,11 @@ class R3Injector extends EnvironmentInjector {
             for (const service of this._ngOnDestroyHooks) {
                 service.ngOnDestroy();
             }
-            for (const hook of this._onDestroyHooks) {
+            const onDestroyHooks = this._onDestroyHooks;
+            // Reset the _onDestroyHooks array before iterating over it to prevent hooks that unregister
+            // themselves from mutating the array during iteration.
+            this._onDestroyHooks = [];
+            for (const hook of onDestroyHooks) {
                 hook();
             }
         }
@@ -9409,7 +9478,6 @@ class R3Injector extends EnvironmentInjector {
             this.records.clear();
             this._ngOnDestroyHooks.clear();
             this.injectorDefTypes.clear();
-            this._onDestroyHooks.length = 0;
         }
     }
     onDestroy(callback) {
@@ -9823,26 +9891,6 @@ const ENABLED_SSR_FEATURES = new InjectionToken((typeof ngDevMode === 'undefined
     factory: () => new Set(),
 });
 
-function escapeTransferStateContent(text) {
-    const escapedText = {
-        '&': '&a;',
-        '"': '&q;',
-        '\'': '&s;',
-        '<': '&l;',
-        '>': '&g;',
-    };
-    return text.replace(/[&"'<>]/g, s => escapedText[s]);
-}
-function unescapeTransferStateContent(text) {
-    const unescapedText = {
-        '&a;': '&',
-        '&q;': '"',
-        '&s;': '\'',
-        '&l;': '<',
-        '&g;': '>',
-    };
-    return text.replace(/&[^;]+;/g, s => unescapedText[s]);
-}
 /**
  * Create a `StateKey<T>` that can be used to store value of type T with `TransferState`.
  *
@@ -9862,7 +9910,9 @@ function makeStateKey(key) {
 }
 function initTransferState() {
     const transferState = new TransferState();
-    transferState.store = retrieveTransferredState(getDocument(), inject$1(APP_ID));
+    if (inject$1(PLATFORM_ID) === 'browser') {
+        transferState.store = retrieveTransferredState(getDocument(), inject$1(APP_ID));
+    }
     return transferState;
 }
 /**
@@ -9944,24 +9994,27 @@ class TransferState {
                 }
             }
         }
-        return JSON.stringify(this.store);
+        // Escape script tag to avoid break out of <script> tag in serialized output.
+        // Encoding of `<` is the same behaviour as G3 script_builders.
+        return JSON.stringify(this.store).replace(/</g, '\\u003C');
     }
 }
 function retrieveTransferredState(doc, appId) {
     // Locate the script tag with the JSON data transferred from the server.
     // The id of the script tag is set to the Angular appId + 'state'.
     const script = doc.getElementById(appId + '-state');
-    let initialState = {};
-    if (script && script.textContent) {
+    if (script?.textContent) {
         try {
             // Avoid using any here as it triggers lint errors in google3 (any is not allowed).
-            initialState = JSON.parse(unescapeTransferStateContent(script.textContent));
+            // Decoding of `<` is done of the box by browsers and node.js, same behaviour as G3
+            // script_builders.
+            return JSON.parse(script.textContent);
         }
         catch (e) {
             console.warn('Exception while restoring TransferState for app ' + appId, e);
         }
     }
-    return initialState;
+    return {};
 }
 
 /** Encodes that the node lookup should start from the host node of this component. */
@@ -10080,6 +10133,12 @@ function getComponentLViewForHydration(viewRef) {
     if (isRootView(lView)) {
         lView = lView[HEADER_OFFSET];
     }
+    // If a `ViewContainerRef` was injected in a component class, this resulted
+    // in an LContainer creation at that location. In this case, the component
+    // LView is in the LContainer's `HOST` slot.
+    if (isLContainer(lView)) {
+        lView = lView[HOST];
+    }
     return lView;
 }
 function getTextNodeContent(node) {
@@ -10375,7 +10434,7 @@ class Version {
 /**
  * @publicApi
  */
-const VERSION = new Version('16.0.0');
+const VERSION = new Version('16.0.2');
 
 // This default value is when checking the hierarchy for a token.
 //
@@ -10481,48 +10540,6 @@ class ErrorHandler {
     }
 }
 
-/**
- * The name of an attribute that can be added to the hydration boundary node
- * (component host node) to disable hydration for the content within that boundary.
- */
-const SKIP_HYDRATION_ATTR_NAME = 'ngSkipHydration';
-/**
- * Helper function to check if a given node has the 'ngSkipHydration' attribute
- */
-function hasNgSkipHydrationAttr(tNode) {
-    const SKIP_HYDRATION_ATTR_NAME_LOWER_CASE = SKIP_HYDRATION_ATTR_NAME.toLowerCase();
-    const attrs = tNode.mergedAttrs;
-    if (attrs === null)
-        return false;
-    // only ever look at the attribute name and skip the values
-    for (let i = 0; i < attrs.length; i += 2) {
-        const value = attrs[i];
-        // This is a marker, which means that the static attributes section is over,
-        // so we can exit early.
-        if (typeof value === 'number')
-            return false;
-        if (typeof value === 'string' && value.toLowerCase() === SKIP_HYDRATION_ATTR_NAME_LOWER_CASE) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Helper function that determines if a given node is within a skip hydration block
- * by navigating up the TNode tree to see if any parent nodes have skip hydration
- * attribute.
- */
-function isInSkipHydrationBlock(tNode) {
-    let currentTNode = tNode.parent;
-    while (currentTNode) {
-        if (hasNgSkipHydrationAttr(currentTNode)) {
-            return true;
-        }
-        currentTNode = currentTNode.parent;
-    }
-    return false;
-}
-
 /**
  * Internal token that specifies whether DOM reuse logic
  * during hydration is enabled.
@@ -10584,9 +10601,11 @@ function throwMultipleComponentError(tNode, first, second) {
         `${stringifyForError(second)}`);
 }
 /** Throws an ExpressionChangedAfterChecked error if checkNoChanges mode is on. */
-function throwErrorIfNoChangesMode(creationMode, oldValue, currValue, propName) {
+function throwErrorIfNoChangesMode(creationMode, oldValue, currValue, propName, lView) {
+    const hostComponentDef = getDeclarationComponentDef(lView);
+    const componentClassName = hostComponentDef?.type?.name;
     const field = propName ? ` for '${propName}'` : '';
-    let msg = `ExpressionChangedAfterItHasBeenCheckedError: Expression has changed after it was checked. Previous value${field}: '${oldValue}'. Current value: '${currValue}'.`;
+    let msg = `ExpressionChangedAfterItHasBeenCheckedError: Expression has changed after it was checked. Previous value${field}: '${oldValue}'. Current value: '${currValue}'.${componentClassName ? ` Expression location: ${componentClassName} component` : ''}`;
     if (creationMode) {
         msg +=
             ` It seems like the view has been created after its parent and its children have been dirty checked.` +
@@ -10912,6 +10931,7 @@ function getInjectableMetadata(type, srcMeta) {
 /**
  * Injectable decorator and metadata.
  *
+ * @Annotation
  * @publicApi
  */
 const Injectable = makeDecorator('Injectable', undefined, undefined, undefined, (type, meta) => compileInjectable(type, meta));
@@ -11468,6 +11488,10 @@ function createTNode(tView, tParent, type, index, value, attrs) {
     ngDevMode && ngDevMode.tNode++;
     ngDevMode && tParent && assertTNodeForTView(tParent, tView);
     let injectorIndex = tParent ? tParent.injectorIndex : -1;
+    let flags = 0;
+    if (isInSkipHydrationBlock$1()) {
+        flags |= 128 /* TNodeFlags.inSkipHydrationBlock */;
+    }
     const tNode = {
         type,
         index,
@@ -11478,7 +11502,7 @@ function createTNode(tView, tParent, type, index, value, attrs) {
         directiveStylingLast: -1,
         componentOffset: -1,
         propertyBindings: null,
-        flags: 0,
+        flags,
         providerIndexes: 0,
         value: value,
         attrs: attrs,
@@ -14032,7 +14056,7 @@ function bindingUpdated(lView, bindingIndex, value) {
             const oldValueToCompare = oldValue !== NO_CHANGE ? oldValue : undefined;
             if (!devModeEqual(oldValueToCompare, value)) {
                 const details = getExpressionChangedErrorDetails(lView, bindingIndex, oldValueToCompare, value);
-                throwErrorIfNoChangesMode(oldValue === NO_CHANGE, details.oldValue, details.newValue, details.propName);
+                throwErrorIfNoChangesMode(oldValue === NO_CHANGE, details.oldValue, details.newValue, details.propName, lView);
             }
             // There was a change, but the `devModeEqual` decided that the change is exempt from an error.
             // For this reason we exit as if no change. The early exit is needed to prevent the changed
@@ -16017,8 +16041,6 @@ function wrapListener(tNode, lView, context, listenerFn, wrapWithPreventDefault)
         }
         if (wrapWithPreventDefault && result === false) {
             e.preventDefault();
-            // Necessary for legacy browsers that don't support preventDefault (e.g. IE)
-            e.returnValue = false;
         }
         return result;
     };
@@ -19551,7 +19573,7 @@ function getLocaleCurrencyCode(locale) {
  * @param locale A locale code for the locale format rules to use.
  * @returns The plural function for the locale.
  * @see `NgPlural`
- * @see [Internationalization (i18n) Guide](https://angular.io/guide/i18n-overview)
+ * @see [Internationalization (i18n) Guide](/guide/i18n-overview)
  */
 function getLocalePluralCase(locale) {
     const data = findLocaleData(locale);
@@ -23466,7 +23488,11 @@ const R3ViewContainerRef = class ViewContainerRef extends VE_ViewContainerRef {
         }
         const hydrationInfo = findMatchingDehydratedView(this._lContainer, templateRef.ssrId);
         const viewRef = templateRef.createEmbeddedViewImpl(context || {}, injector, hydrationInfo);
-        this.insertImpl(viewRef, index, !!hydrationInfo);
+        // If there is a matching dehydrated view, but the host TNode is located in the skip
+        // hydration block, this means that the content was detached (as a part of the skip
+        // hydration logic) and it needs to be appended into the DOM.
+        const skipDomInsertion = !!hydrationInfo && !hasInSkipHydrationBlockFlag(this._hostTNode);
+        this.insertImpl(viewRef, index, skipDomInsertion);
         return viewRef;
     }
     createComponent(componentFactoryOrType, indexOrOptions, injector, projectableNodes, environmentInjector) {
@@ -23540,7 +23566,11 @@ const R3ViewContainerRef = class ViewContainerRef extends VE_ViewContainerRef {
         const dehydratedView = findMatchingDehydratedView(this._lContainer, componentDef?.id ?? null);
         const rNode = dehydratedView?.firstChild ?? null;
         const componentRef = componentFactory.create(contextInjector, projectableNodes, rNode, environmentInjector);
-        this.insertImpl(componentRef.hostView, index, !!dehydratedView);
+        // If there is a matching dehydrated view, but the host TNode is located in the skip
+        // hydration block, this means that the content was detached (as a part of the skip
+        // hydration logic) and it needs to be appended into the DOM.
+        const skipDomInsertion = !!dehydratedView && !hasInSkipHydrationBlockFlag(this._hostTNode);
+        this.insertImpl(componentRef.hostView, index, skipDomInsertion);
         return componentRef;
     }
     insert(viewRef, index) {
@@ -23714,8 +23744,10 @@ function locateOrCreateAnchorNode(lContainer, hostLView, hostTNode, slotValue) {
         return;
     const hydrationInfo = hostLView[HYDRATION];
     const noOffsetIndex = hostTNode.index - HEADER_OFFSET;
-    const isNodeCreationMode = !hydrationInfo || isInSkipHydrationBlock(hostTNode) ||
-        isDisconnectedNode(hydrationInfo, noOffsetIndex);
+    // TODO(akushnir): this should really be a single condition, refactor the code
+    // to use `hasInSkipHydrationBlockFlag` logic inside `isInSkipHydrationBlock`.
+    const skipHydration = isInSkipHydrationBlock(hostTNode) || hasInSkipHydrationBlockFlag(hostTNode);
+    const isNodeCreationMode = !hydrationInfo || skipHydration || isDisconnectedNode(hydrationInfo, noOffsetIndex);
     // Regular creation mode.
     if (isNodeCreationMode) {
         return createAnchorNode(lContainer, hostLView, hostTNode, slotValue);
@@ -26127,7 +26159,7 @@ class TestBedImpl {
     }
     configureCompiler(config) {
         if (config.useJit != null) {
-            throw new Error('the Render3 compiler JiT mode is not configurable !');
+            throw new Error('JIT compiler is not configurable via TestBed APIs.');
         }
         if (config.providers !== undefined) {
             this.compiler.setCompilerProviders(config.providers);
@@ -26135,7 +26167,7 @@ class TestBedImpl {
         return this;
     }
     configureTestingModule(moduleDef) {
-        this.assertNotInstantiated('R3TestBed.configureTestingModule', 'configure the test module');
+        this.assertNotInstantiated('TestBed.configureTestingModule', 'configure the test module');
         // Trigger module scoping queue flush before executing other TestBed operations in a test.
         // This is needed for the first test invocation to ensure that globally declared modules have
         // their components scoped properly. See the `checkGlobalCompilationFinished` function
@@ -26189,7 +26221,7 @@ class TestBedImpl {
         return this;
     }
     overrideTemplateUsingTestingModule(component, template) {
-        this.assertNotInstantiated('R3TestBed.overrideTemplateUsingTestingModule', 'Cannot override template when the test module has already been instantiated');
+        this.assertNotInstantiated('TestBed.overrideTemplateUsingTestingModule', 'Cannot override template when the test module has already been instantiated');
         this.compiler.overrideTemplateUsingTestingModule(component, template);
         return this;
     }