@stencil/core 4.18.3 → 4.19.0

package/internal/testing/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/internal/testing",
-  "version": "4.18.3",
+  "version": "4.19.0",
   "description": "Stencil internal testing platform to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "private": true

package/mock-doc/index.cjs

@@ -1,5 +1,5 @@
 /*!
- Stencil Mock Doc (CommonJS) v4.18.3 | MIT Licensed | https://stenciljs.com
+ Stencil Mock Doc (CommonJS) v4.19.0 | MIT Licensed | https://stenciljs.com
  */
 "use strict";
 var __defProp = Object.defineProperty;
@@ -6270,67 +6270,50 @@ function humanReadableList(items) {
 }
 
 // src/mock-doc/serialize-node.ts
-function serializeNodeToHtml(elm, opts = {}) {
+function normalizeSerializationOptions(opts = {}) {
+  return {
+    ...opts,
+    outerHtml: typeof opts.outerHtml !== "boolean" ? false : opts.outerHtml,
+    ...opts.prettyHtml ? {
+      indentSpaces: typeof opts.indentSpaces !== "number" ? 2 : opts.indentSpaces,
+      newLines: typeof opts.newLines !== "boolean" ? true : opts.newLines
+    } : {
+      prettyHtml: false,
+      indentSpaces: typeof opts.indentSpaces !== "number" ? 0 : opts.indentSpaces,
+      newLines: typeof opts.newLines !== "boolean" ? false : opts.newLines
+    },
+    approximateLineWidth: typeof opts.approximateLineWidth !== "number" ? -1 : opts.approximateLineWidth,
+    removeEmptyAttributes: typeof opts.removeEmptyAttributes !== "boolean" ? true : opts.removeEmptyAttributes,
+    removeAttributeQuotes: typeof opts.removeAttributeQuotes !== "boolean" ? false : opts.removeAttributeQuotes,
+    removeBooleanAttributeQuotes: typeof opts.removeBooleanAttributeQuotes !== "boolean" ? false : opts.removeBooleanAttributeQuotes,
+    removeHtmlComments: typeof opts.removeHtmlComments !== "boolean" ? false : opts.removeHtmlComments,
+    serializeShadowRoot: typeof opts.serializeShadowRoot !== "boolean" ? false : opts.serializeShadowRoot,
+    fullDocument: typeof opts.fullDocument !== "boolean" ? true : opts.fullDocument
+  };
+}
+function serializeNodeToHtml(elm, serializationOptions = {}) {
+  const opts = normalizeSerializationOptions(serializationOptions);
   const output = {
     currentLineWidth: 0,
     indent: 0,
     isWithinBody: false,
     text: []
   };
-  if (opts.prettyHtml) {
-    if (typeof opts.indentSpaces !== "number") {
-      opts.indentSpaces = 2;
-    }
-    if (typeof opts.newLines !== "boolean") {
-      opts.newLines = true;
-    }
-    opts.approximateLineWidth = -1;
-  } else {
-    opts.prettyHtml = false;
-    if (typeof opts.newLines !== "boolean") {
-      opts.newLines = false;
-    }
-    if (typeof opts.indentSpaces !== "number") {
-      opts.indentSpaces = 0;
-    }
-  }
-  if (typeof opts.approximateLineWidth !== "number") {
-    opts.approximateLineWidth = -1;
-  }
-  if (typeof opts.removeEmptyAttributes !== "boolean") {
-    opts.removeEmptyAttributes = true;
-  }
-  if (typeof opts.removeAttributeQuotes !== "boolean") {
-    opts.removeAttributeQuotes = false;
-  }
-  if (typeof opts.removeBooleanAttributeQuotes !== "boolean") {
-    opts.removeBooleanAttributeQuotes = false;
-  }
-  if (typeof opts.removeHtmlComments !== "boolean") {
-    opts.removeHtmlComments = false;
-  }
-  if (typeof opts.serializeShadowRoot !== "boolean") {
-    opts.serializeShadowRoot = false;
-  }
-  if (opts.outerHtml) {
-    serializeToHtml(elm, opts, output, false);
-  } else {
-    for (let i = 0, ii = elm.childNodes.length; i < ii; i++) {
-      serializeToHtml(elm.childNodes[i], opts, output, false);
-    }
-  }
-  if (output.text[0] === "\n") {
-    output.text.shift();
-  }
-  if (output.text[output.text.length - 1] === "\n") {
-    output.text.pop();
+  let renderedNode = "";
+  const children = !opts.fullDocument && elm.body ? Array.from(elm.body.childNodes) : opts.outerHtml ? [elm] : Array.from(elm.childNodes);
+  for (let i = 0, ii = children.length; i < ii; i++) {
+    const child = children[i];
+    const chunks = Array.from(streamToHtml(child, opts, output));
+    renderedNode += chunks.join("");
   }
-  return output.text.join("");
+  return renderedNode.trim();
 }
-function serializeToHtml(node, opts, output, isShadowRoot) {
+var shadowRootTag = "mock:shadow-root";
+function* streamToHtml(node, opts, output) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p;
+  const isShadowRoot = node.nodeType === 11 /* DOCUMENT_FRAGMENT_NODE */;
   if (node.nodeType === 1 /* ELEMENT_NODE */ || isShadowRoot) {
-    const tagName = isShadowRoot ? "mock:shadow-root" : getTagName(node);
+    const tagName = isShadowRoot ? shadowRootTag : getTagName(node);
     if (tagName === "body") {
       output.isWithinBody = true;
     }
@@ -6338,17 +6321,23 @@ function serializeToHtml(node, opts, output, isShadowRoot) {
     if (ignoreTag === false) {
       const isWithinWhitespaceSensitiveNode = opts.newLines || ((_a = opts.indentSpaces) != null ? _a : 0) > 0 ? isWithinWhitespaceSensitive(node) : false;
       if (opts.newLines && !isWithinWhitespaceSensitiveNode) {
-        output.text.push("\n");
+        yield "\n";
         output.currentLineWidth = 0;
       }
       if (((_b = opts.indentSpaces) != null ? _b : 0) > 0 && !isWithinWhitespaceSensitiveNode) {
         for (let i = 0; i < output.indent; i++) {
-          output.text.push(" ");
+          yield " ";
         }
         output.currentLineWidth += output.indent;
       }
-      output.text.push("<" + tagName);
-      output.currentLineWidth += tagName.length + 1;
+      const tag = tagName === shadowRootTag ? "template" : tagName;
+      yield "<" + tag;
+      output.currentLineWidth += tag.length + 1;
+      if (tag === "template") {
+        const mode = ` shadowrootmode="open"`;
+        yield mode;
+        output.currentLineWidth += mode.length;
+      }
       const attrsLength = node.attributes.length;
       const attributes = opts.prettyHtml && attrsLength > 1 ? cloneAttributes(node.attributes, true) : node.attributes;
       for (let i = 0; i < attrsLength; i++) {
@@ -6365,27 +6354,27 @@ function serializeToHtml(node, opts, output, isShadowRoot) {
         if (attrNamespaceURI == null) {
           output.currentLineWidth += attrName.length + 1;
           if (opts.approximateLineWidth && opts.approximateLineWidth > 0 && output.currentLineWidth > opts.approximateLineWidth) {
-            output.text.push("\n" + attrName);
+            yield "\n" + attrName;
             output.currentLineWidth = 0;
           } else {
-            output.text.push(" " + attrName);
+            yield " " + attrName;
           }
         } else if (attrNamespaceURI === "http://www.w3.org/XML/1998/namespace") {
-          output.text.push(" xml:" + attrName);
+          yield " xml:" + attrName;
           output.currentLineWidth += attrName.length + 5;
         } else if (attrNamespaceURI === "http://www.w3.org/2000/xmlns/") {
           if (attrName !== "xmlns") {
-            output.text.push(" xmlns:" + attrName);
+            yield " xmlns:" + attrName;
             output.currentLineWidth += attrName.length + 7;
           } else {
-            output.text.push(" " + attrName);
+            yield " " + attrName;
             output.currentLineWidth += attrName.length + 1;
           }
         } else if (attrNamespaceURI === XLINK_NS) {
-          output.text.push(" xlink:" + attrName);
+          yield " xlink:" + attrName;
           output.currentLineWidth += attrName.length + 7;
         } else {
-          output.text.push(" " + attrNamespaceURI + ":" + attrName);
+          yield " " + attrNamespaceURI + ":" + attrName;
           output.currentLineWidth += attrNamespaceURI.length + attrName.length + 2;
         }
         if (opts.prettyHtml && attrName === "class") {
@@ -6400,43 +6389,45 @@ function serializeToHtml(node, opts, output, isShadowRoot) {
           }
         }
         if (opts.removeAttributeQuotes && CAN_REMOVE_ATTR_QUOTES.test(attrValue)) {
-          output.text.push("=" + escapeString(attrValue, true));
+          yield "=" + escapeString(attrValue, true);
           output.currentLineWidth += attrValue.length + 1;
         } else {
-          output.text.push('="' + escapeString(attrValue, true) + '"');
+          yield '="' + escapeString(attrValue, true) + '"';
           output.currentLineWidth += attrValue.length + 3;
         }
       }
       if (node.hasAttribute("style")) {
         const cssText = node.style.cssText;
         if (opts.approximateLineWidth && opts.approximateLineWidth > 0 && output.currentLineWidth + cssText.length + 10 > opts.approximateLineWidth) {
-          output.text.push(`
-style="${cssText}">`);
+          yield `
+style="${cssText}">`;
           output.currentLineWidth = 0;
         } else {
-          output.text.push(` style="${cssText}">`);
+          yield ` style="${cssText}">`;
           output.currentLineWidth += cssText.length + 10;
         }
       } else {
-        output.text.push(">");
+        yield ">";
         output.currentLineWidth += 1;
       }
     }
     if (EMPTY_ELEMENTS.has(tagName) === false) {
-      if (opts.serializeShadowRoot && node.shadowRoot != null) {
+      const shadowRoot = node.shadowRoot;
+      if (opts.serializeShadowRoot && shadowRoot != null) {
         output.indent = output.indent + ((_c = opts.indentSpaces) != null ? _c : 0);
-        serializeToHtml(node.shadowRoot, opts, output, true);
+        yield* streamToHtml(shadowRoot, opts, output);
         output.indent = output.indent - ((_d = opts.indentSpaces) != null ? _d : 0);
         if (opts.newLines && (node.childNodes.length === 0 || node.childNodes.length === 1 && node.childNodes[0].nodeType === 3 /* TEXT_NODE */ && ((_e = node.childNodes[0].nodeValue) == null ? void 0 : _e.trim()) === "")) {
-          output.text.push("\n");
+          yield "\n";
           output.currentLineWidth = 0;
           for (let i = 0; i < output.indent; i++) {
-            output.text.push(" ");
+            yield " ";
           }
           output.currentLineWidth += output.indent;
         }
       }
       if (opts.excludeTagContent == null || opts.excludeTagContent.includes(tagName) === false) {
+        const tag = tagName === shadowRootTag ? "template" : tagName;
         const childNodes = tagName === "template" ? node.content.childNodes : node.childNodes;
         const childNodeLength = childNodes.length;
         if (childNodeLength > 0) {
@@ -6447,17 +6438,17 @@ style="${cssText}">`);
               output.indent = output.indent + ((_h = opts.indentSpaces) != null ? _h : 0);
             }
             for (let i = 0; i < childNodeLength; i++) {
-              serializeToHtml(childNodes[i], opts, output, false);
+              yield* streamToHtml(childNodes[i], opts, output);
             }
             if (ignoreTag === false) {
               if (opts.newLines && !isWithinWhitespaceSensitiveNode) {
-                output.text.push("\n");
+                yield "\n";
                 output.currentLineWidth = 0;
               }
               if (((_i = opts.indentSpaces) != null ? _i : 0) > 0 && !isWithinWhitespaceSensitiveNode) {
                 output.indent = output.indent - ((_j = opts.indentSpaces) != null ? _j : 0);
                 for (let i = 0; i < output.indent; i++) {
-                  output.text.push(" ");
+                  yield " ";
                 }
                 output.currentLineWidth += output.indent;
               }
@@ -6465,13 +6456,13 @@ style="${cssText}">`);
           }
         }
         if (ignoreTag === false) {
-          output.text.push("</" + tagName + ">");
-          output.currentLineWidth += tagName.length + 3;
+          yield "</" + tag + ">";
+          output.currentLineWidth += tag.length + 3;
         }
       }
     }
     if (((_k = opts.approximateLineWidth) != null ? _k : 0) > 0 && STRUCTURE_ELEMENTS.has(tagName)) {
-      output.text.push("\n");
+      yield "\n";
       output.currentLineWidth = 0;
     }
     if (tagName === "body") {
@@ -6483,27 +6474,27 @@ style="${cssText}">`);
       const trimmedTextContent = textContent.trim();
       if (trimmedTextContent === "") {
         if (isWithinWhitespaceSensitive(node)) {
-          output.text.push(textContent);
+          yield textContent;
           output.currentLineWidth += textContent.length;
         } else if (((_l = opts.approximateLineWidth) != null ? _l : 0) > 0 && !output.isWithinBody) {
         } else if (!opts.prettyHtml) {
           output.currentLineWidth += 1;
           if (opts.approximateLineWidth && opts.approximateLineWidth > 0 && output.currentLineWidth > opts.approximateLineWidth) {
-            output.text.push("\n");
+            yield "\n";
             output.currentLineWidth = 0;
           } else {
-            output.text.push(" ");
+            yield " ";
           }
         }
       } else {
         const isWithinWhitespaceSensitiveNode = opts.newLines || ((_m = opts.indentSpaces) != null ? _m : 0) > 0 || opts.prettyHtml ? isWithinWhitespaceSensitive(node) : false;
         if (opts.newLines && !isWithinWhitespaceSensitiveNode) {
-          output.text.push("\n");
+          yield "\n";
           output.currentLineWidth = 0;
         }
         if (((_n = opts.indentSpaces) != null ? _n : 0) > 0 && !isWithinWhitespaceSensitiveNode) {
           for (let i = 0; i < output.indent; i++) {
-            output.text.push(" ");
+            yield " ";
           }
           output.currentLineWidth += output.indent;
         }
@@ -6512,15 +6503,15 @@ style="${cssText}">`);
           const parentTagName = node.parentNode != null && node.parentNode.nodeType === 1 /* ELEMENT_NODE */ ? node.parentNode.nodeName : null;
           if (typeof parentTagName === "string" && NON_ESCAPABLE_CONTENT.has(parentTagName)) {
             if (isWithinWhitespaceSensitive(node)) {
-              output.text.push(textContent);
+              yield textContent;
             } else {
-              output.text.push(trimmedTextContent);
+              yield trimmedTextContent;
               textContentLength = trimmedTextContent.length;
             }
             output.currentLineWidth += textContentLength;
           } else {
             if (opts.prettyHtml && !isWithinWhitespaceSensitiveNode) {
-              output.text.push(escapeString(textContent.replace(/\s\s+/g, " ").trim(), false));
+              yield escapeString(textContent.replace(/\s\s+/g, " ").trim(), false);
               output.currentLineWidth += textContentLength;
             } else {
               if (isWithinWhitespaceSensitive(node)) {
@@ -6542,7 +6533,7 @@ style="${cssText}">`);
                 }
                 output.currentLineWidth += textContentLength;
               }
-              output.text.push(escapeString(textContent, false));
+              yield escapeString(textContent, false);
             }
           }
         }
@@ -6550,27 +6541,27 @@ style="${cssText}">`);
     }
   } else if (node.nodeType === 8 /* COMMENT_NODE */) {
     const nodeValue = node.nodeValue;
-    if (opts.removeHtmlComments) {
-      const isHydrateAnnotation = (nodeValue == null ? void 0 : nodeValue.startsWith(CONTENT_REF_ID + ".")) || (nodeValue == null ? void 0 : nodeValue.startsWith(ORG_LOCATION_ID + ".")) || (nodeValue == null ? void 0 : nodeValue.startsWith(SLOT_NODE_ID + ".")) || (nodeValue == null ? void 0 : nodeValue.startsWith(TEXT_NODE_ID + "."));
-      if (!isHydrateAnnotation) {
-        return;
-      }
+    const isHydrateAnnotation = (nodeValue == null ? void 0 : nodeValue.startsWith(CONTENT_REF_ID + ".")) || (nodeValue == null ? void 0 : nodeValue.startsWith(ORG_LOCATION_ID + ".")) || (nodeValue == null ? void 0 : nodeValue.startsWith(SLOT_NODE_ID + ".")) || (nodeValue == null ? void 0 : nodeValue.startsWith(TEXT_NODE_ID + "."));
+    if (opts.removeHtmlComments && !isHydrateAnnotation) {
+      return;
     }
     const isWithinWhitespaceSensitiveNode = opts.newLines || ((_o = opts.indentSpaces) != null ? _o : 0) > 0 ? isWithinWhitespaceSensitive(node) : false;
     if (opts.newLines && !isWithinWhitespaceSensitiveNode) {
-      output.text.push("\n");
+      yield "\n";
       output.currentLineWidth = 0;
     }
     if (((_p = opts.indentSpaces) != null ? _p : 0) > 0 && !isWithinWhitespaceSensitiveNode) {
       for (let i = 0; i < output.indent; i++) {
-        output.text.push(" ");
+        yield " ";
       }
       output.currentLineWidth += output.indent;
     }
-    output.text.push("<!--" + nodeValue + "-->");
-    output.currentLineWidth += nodeValue.length + 7;
+    yield "<!--" + nodeValue + "-->";
+    if (nodeValue) {
+      output.currentLineWidth += nodeValue.length + 7;
+    }
   } else if (node.nodeType === 10 /* DOCUMENT_TYPE_NODE */) {
-    output.text.push("<!doctype html>");
+    yield "<!doctype html>";
   }
 }
 var AMP_REGEX = /&/g;
@@ -6595,7 +6586,7 @@ function escapeString(str, attrMode) {
 }
 function isWithinWhitespaceSensitive(node) {
   let _node = node;
-  while (_node != null) {
+  while (_node == null ? void 0 : _node.nodeName) {
     if (WHITESPACE_SENSITIVE.has(_node.nodeName)) {
       return true;
     }
@@ -6911,6 +6902,10 @@ Testing components with ElementInternals is fully supported in e2e tests.`
   get shadowRoot() {
     return this.__shadowRoot || null;
   }
+  /**
+   * Set shadow root for element
+   * @param shadowRoot - ShadowRoot to set
+   */
   set shadowRoot(shadowRoot) {
     if (shadowRoot != null) {
       shadowRoot.host = this;
@@ -8740,14 +8735,16 @@ var WINDOW_PROPS = [
 ];
 var GLOBAL_CONSTRUCTORS = [
   ["CustomEvent", MockCustomEvent],
+  ["DocumentFragment", MockDocumentFragment],
+  ["DOMParser", MockDOMParser],
   ["Event", MockEvent],
-  ["Headers", MockHeaders],
   ["FocusEvent", MockFocusEvent],
+  ["Headers", MockHeaders],
   ["KeyboardEvent", MockKeyboardEvent],
   ["MouseEvent", MockMouseEvent],
   ["Request", MockRequest],
   ["Response", MockResponse],
-  ["DOMParser", MockDOMParser],
+  ["ShadowRoot", MockDocumentFragment],
   ["HTMLAnchorElement", MockAnchorElement],
   ["HTMLBaseElement", MockBaseElement],
   ["HTMLButtonElement", MockButtonElement],
@@ -8958,6 +8955,7 @@ var nativeClearTimeout = clearTimeout;
 var nativeSetInterval = setInterval;
 var nativeSetTimeout = setTimeout;
 var nativeURL = URL;
+var nativeWindow = globalThis.window;
 var MockWindow = class {
   constructor(html = null) {
     if (html !== false) {
@@ -8984,10 +8982,10 @@ var MockWindow = class {
   blur() {
   }
   cancelAnimationFrame(id) {
-    this.__clearTimeout(id);
+    this.__clearTimeout.call(nativeWindow || this, id);
   }
   cancelIdleCallback(id) {
-    this.__clearTimeout(id);
+    this.__clearTimeout.call(nativeWindow || this, id);
   }
   get CharacterData() {
     if (this.__charDataCstr == null) {
@@ -9005,10 +9003,10 @@ var MockWindow = class {
     this.__charDataCstr = charDataCstr;
   }
   clearInterval(id) {
-    this.__clearInterval(id);
+    this.__clearInterval.call(nativeWindow || this, id);
   }
   clearTimeout(id) {
-    this.__clearTimeout(id);
+    this.__clearTimeout.call(nativeWindow || this, id);
   }
   close() {
     resetWindow(this);
@@ -9308,20 +9306,24 @@ var MockWindow = class {
       }
       return intervalId;
     }
-    const timeoutId = this.__setTimeout(() => {
-      if (this.__timeouts) {
-        this.__timeouts.delete(timeoutId);
-        try {
-          callback(...args);
-        } catch (e2) {
-          if (this.console) {
-            this.console.error(e2);
-          } else {
-            console.error(e2);
+    const timeoutId = this.__setTimeout.call(
+      nativeWindow || this,
+      () => {
+        if (this.__timeouts) {
+          this.__timeouts.delete(timeoutId);
+          try {
+            callback(...args);
+          } catch (e2) {
+            if (this.console) {
+              this.console.error(e2);
+            } else {
+              console.error(e2);
+            }
           }
         }
-      }
-    }, ms);
+      },
+      ms
+    );
     if (this.__timeouts) {
       this.__timeouts.add(timeoutId);
     }
@@ -9332,20 +9334,24 @@ var MockWindow = class {
       this.__timeouts = /* @__PURE__ */ new Set();
     }
     ms = Math.min(ms, this.__maxTimeout);
-    const timeoutId = this.__setTimeout(() => {
-      if (this.__timeouts) {
-        this.__timeouts.delete(timeoutId);
-        try {
-          callback(...args);
-        } catch (e2) {
-          if (this.console) {
-            this.console.error(e2);
-          } else {
-            console.error(e2);
+    const timeoutId = this.__setTimeout.call(
+      nativeWindow || this,
+      () => {
+        if (this.__timeouts) {
+          this.__timeouts.delete(timeoutId);
+          try {
+            callback(...args);
+          } catch (e2) {
+            if (this.console) {
+              this.console.error(e2);
+            } else {
+              console.error(e2);
+            }
           }
         }
-      }
-    }, ms);
+      },
+      ms
+    );
     if (this.__timeouts) {
       this.__timeouts.add(timeoutId);
     }
@@ -9562,11 +9568,11 @@ function cloneWindow(srcWin, opts = {}) {
   return clonedWin;
 }
 function cloneDocument(srcDoc) {
-  if (srcDoc == null) {
+  if (srcDoc == null || !srcDoc.defaultView) {
     return null;
   }
   const dstWin = cloneWindow(srcDoc.defaultView);
-  return dstWin.document;
+  return (dstWin == null ? void 0 : dstWin.document) || null;
 }
 function constrainTimeouts(win) {
   win.__allowInterval = false;

package/mock-doc/index.d.ts

@@ -124,7 +124,7 @@ declare class MockDocument extends MockHTMLElement {
   defaultView: any;
   cookie: string;
   referrer: string;
-  constructor(html?: string | boolean, win?: any);
+  constructor(html?: string | boolean | null, win?: any);
   get dir(): string;
   set dir(value: string);
   get localName(): never;
@@ -538,6 +538,10 @@ declare class MockElement extends MockNode {
   get localName(): string;
   get namespaceURI(): string;
   get shadowRoot(): any;
+  /**
+   * Set shadow root for element
+   * @param shadowRoot - ShadowRoot to set
+   */
   set shadowRoot(shadowRoot: any);
   get attributes(): MockAttributeMap;
   set attributes(attrs: MockAttributeMap);
@@ -852,19 +856,28 @@ declare function selectAll(selector: string, elm: MockElement): any;
  */
 declare const PROBLEMATIC_SELECTORS: readonly [":scope", ":where", ":is"];
 /**
- * Serialize a node (either a DOM node or a mock-doc node) to an HTML string
+ * Serialize a node (either a DOM node or a mock-doc node) to an HTML string.
+ * This operation is similar to `outerHTML` but allows for more control over the
+ * serialization process. It is fully synchronous meaning that it will not
+ * wait for a component to be fully rendered before serializing it. Use `streamToHtml`
+ * for a streaming version of this function.
  *
  * @param elm the node to serialize
- * @param opts options to control serialization behavior
+ * @param serializationOptions options to control serialization behavior
  * @returns an html string
  */
-declare function serializeNodeToHtml(elm: Node | MockNode, opts?: SerializeNodeToHtmlOptions): string;
+declare function serializeNodeToHtml(elm: Node | MockNode, serializationOptions?: SerializeNodeToHtmlOptions): string;
 declare const NON_ESCAPABLE_CONTENT: Set<string>;
 /**
  * A list of whitespace sensitive tag names, such as `code`, `pre`, etc.
  */
 declare const WHITESPACE_SENSITIVE: Set<string>;
 declare const EMPTY_ELEMENTS: Set<string>;
+/**
+ * Partially duplicate of https://github.com/ionic-team/stencil/blob/6017dad2cb6fe366242e2e0594f82c8e3a3b5d15/src/declarations/stencil-public-compiler.ts#L895
+ * Types can't be imported in this documented as Eslint will not embed the types
+ * in the d.ts file.
+ */
 interface SerializeNodeToHtmlOptions {
   approximateLineWidth?: number;
   excludeTagContent?: string[];
@@ -878,6 +891,7 @@ interface SerializeNodeToHtmlOptions {
   removeEmptyAttributes?: boolean;
   removeHtmlComments?: boolean;
   serializeShadowRoot?: boolean;
+  fullDocument?: boolean;
 }
 declare class MockStorage {
   key(_value: number): void;