@angular/core 16.0.0 → 16.0.1

package/fesm2022/testing.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v16.0.0
+ * @license Angular v16.0.1
  * (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 = 
@@ -3156,7 +3154,7 @@ function getComponentId(componentDef) {
     // Example:
     // https://github.com/angular/components/blob/d9f82c8f95309e77a6d82fd574c65871e91354c2/src/material/core/option/option.ts#L248
     // https://github.com/angular/components/blob/285f46dc2b4c5b127d356cb7c4714b221f03ce50/src/material/legacy-core/option/option.ts#L32
-    const hashSelectors = [
+    const hashSelectors = JSON.stringify([
         componentDef.selectors,
         componentDef.ngContentSelectors,
         componentDef.hostVars,
@@ -3166,12 +3164,15 @@ function getComponentId(componentDef) {
         componentDef.decls,
         componentDef.encapsulation,
         componentDef.standalone,
+        componentDef.exportAs,
+        componentDef.inputs,
+        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),
         !!componentDef.contentQueries,
         !!componentDef.viewQuery,
-    ].join('|');
+    ]);
     for (const char of hashSelectors) {
         hash = Math.imul(31, hash) + char.charCodeAt(0) << 0;
     }
@@ -6083,6 +6084,7 @@ function ɵɵinjectAttribute(attrNameToInject) {
 /**
  * Attribute decorator and metadata.
  *
+ * @Annotation
  * @publicApi
  */
 const Attribute = makeParamDecorator('Attribute', (attributeName) => ({ attributeName, __NG_ELEMENT_ID__: () => ɵɵinjectAttribute(attributeName) }));
@@ -6383,7 +6385,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 +6527,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
@@ -7824,6 +7879,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 +8184,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 +8211,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.
 }
 
 /**
@@ -9862,7 +9923,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;
 }
 /**
@@ -9951,17 +10014,16 @@ 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));
+            return JSON.parse(unescapeTransferStateContent(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 +10142,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 +10443,7 @@ class Version {
 /**
  * @publicApi
  */
-const VERSION = new Version('16.0.0');
+const VERSION = new Version('16.0.1');
 
 // This default value is when checking the hierarchy for a token.
 //
@@ -10481,48 +10549,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.
@@ -10912,6 +10938,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 +11495,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 +11509,7 @@ function createTNode(tView, tParent, type, index, value, attrs) {
         directiveStylingLast: -1,
         componentOffset: -1,
         propertyBindings: null,
-        flags: 0,
+        flags,
         providerIndexes: 0,
         value: value,
         attrs: attrs,
@@ -23466,7 +23497,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 +23575,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 +23753,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 +26168,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 +26176,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 +26230,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;
     }