lwc 2.20.0 → 2.20.3

package/dist/engine-dom/umd/es5/engine-dom.js

@@ -368,9 +368,9 @@
   // Increment whenever the LWC template compiler changes
 
 
-  var LWC_VERSION = "2.20.0";
+  var LWC_VERSION = "2.20.3";
   var LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-  /** version: 2.20.0 */
+  /** version: 2.20.3 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -549,7 +549,7 @@
       setFeatureFlag(name, value);
     }
   }
-  /** version: 2.20.0 */
+  /** version: 2.20.3 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -4119,6 +4119,241 @@
       methods: publicMethods
     };
   }
+  /*
+   * Copyright (c) 2018, salesforce.com, inc.
+   * All rights reserved.
+   * SPDX-License-Identifier: MIT
+   * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+   */
+
+
+  function makeHostToken(token) {
+    return "".concat(token, "-host");
+  }
+
+  function createInlineStyleVNode(content) {
+    return api.h('style', {
+      key: 'style',
+      attrs: {
+        type: 'text/css'
+      }
+    }, [api.t(content)]);
+  }
+
+  function updateStylesheetToken(vm, template) {
+    var elm = vm.elm,
+        context = vm.context,
+        renderMode = vm.renderMode,
+        shadowMode = vm.shadowMode,
+        _vm$renderer = vm.renderer,
+        getClassList = _vm$renderer.getClassList,
+        removeAttribute = _vm$renderer.removeAttribute,
+        setAttribute = _vm$renderer.setAttribute;
+    var newStylesheets = template.stylesheets,
+        newStylesheetToken = template.stylesheetToken;
+    var isSyntheticShadow = renderMode === 1
+    /* RenderMode.Shadow */
+    && shadowMode === 1
+    /* ShadowMode.Synthetic */
+    ;
+    var hasScopedStyles = context.hasScopedStyles;
+    var newToken;
+    var newHasTokenInClass;
+    var newHasTokenInAttribute; // Reset the styling token applied to the host element.
+
+    var oldToken = context.stylesheetToken,
+        oldHasTokenInClass = context.hasTokenInClass,
+        oldHasTokenInAttribute = context.hasTokenInAttribute;
+
+    if (!isUndefined$1(oldToken)) {
+      if (oldHasTokenInClass) {
+        getClassList(elm).remove(makeHostToken(oldToken));
+      }
+
+      if (oldHasTokenInAttribute) {
+        removeAttribute(elm, makeHostToken(oldToken));
+      }
+    } // Apply the new template styling token to the host element, if the new template has any
+    // associated stylesheets. In the case of light DOM, also ensure there is at least one scoped stylesheet.
+
+
+    if (!isUndefined$1(newStylesheets) && newStylesheets.length !== 0) {
+      newToken = newStylesheetToken;
+    } // Set the new styling token on the host element
+
+
+    if (!isUndefined$1(newToken)) {
+      if (hasScopedStyles) {
+        getClassList(elm).add(makeHostToken(newToken));
+        newHasTokenInClass = true;
+      }
+
+      if (isSyntheticShadow) {
+        setAttribute(elm, makeHostToken(newToken), '');
+        newHasTokenInAttribute = true;
+      }
+    } // Update the styling tokens present on the context object.
+
+
+    context.stylesheetToken = newToken;
+    context.hasTokenInClass = newHasTokenInClass;
+    context.hasTokenInAttribute = newHasTokenInAttribute;
+  }
+
+  function evaluateStylesheetsContent(stylesheets, stylesheetToken, vm) {
+    var content = [];
+    var root;
+
+    for (var _i11 = 0; _i11 < stylesheets.length; _i11++) {
+      var stylesheet = stylesheets[_i11];
+
+      if (isArray$1(stylesheet)) {
+        ArrayPush$1.apply(content, evaluateStylesheetsContent(stylesheet, stylesheetToken, vm));
+      } else {
+        if (process.env.NODE_ENV !== 'production') {
+          // Check for compiler version mismatch in dev mode only
+          checkVersionMismatch(stylesheet, 'stylesheet'); // in dev-mode, we support hot swapping of stylesheet, which means that
+          // the component instance might be attempting to use an old version of
+          // the stylesheet, while internally, we have a replacement for it.
+
+          stylesheet = getStyleOrSwappedStyle(stylesheet);
+        }
+
+        var isScopedCss = stylesheet[KEY__SCOPED_CSS]; // Apply the scope token only if the stylesheet itself is scoped, or if we're rendering synthetic shadow.
+
+        var scopeToken = isScopedCss || vm.shadowMode === 1
+        /* ShadowMode.Synthetic */
+        && vm.renderMode === 1
+        /* RenderMode.Shadow */
+        ? stylesheetToken : undefined; // Use the actual `:host` selector if we're rendering global CSS for light DOM, or if we're rendering
+        // native shadow DOM. Synthetic shadow DOM never uses `:host`.
+
+        var useActualHostSelector = vm.renderMode === 0
+        /* RenderMode.Light */
+        ? !isScopedCss : vm.shadowMode === 0
+        /* ShadowMode.Native */
+        ; // Use the native :dir() pseudoclass only in native shadow DOM. Otherwise, in synthetic shadow,
+        // we use an attribute selector on the host to simulate :dir().
+
+        var useNativeDirPseudoclass = void 0;
+
+        if (vm.renderMode === 1
+        /* RenderMode.Shadow */
+        ) {
+          useNativeDirPseudoclass = vm.shadowMode === 0
+          /* ShadowMode.Native */
+          ;
+        } else {
+          // Light DOM components should only render `[dir]` if they're inside of a synthetic shadow root.
+          // At the top level (root is null) or inside of a native shadow root, they should use `:dir()`.
+          if (isUndefined$1(root)) {
+            // Only calculate the root once as necessary
+            root = getNearestShadowComponent(vm);
+          }
+
+          useNativeDirPseudoclass = isNull(root) || root.shadowMode === 0
+          /* ShadowMode.Native */
+          ;
+        }
+
+        ArrayPush$1.call(content, stylesheet(scopeToken, useActualHostSelector, useNativeDirPseudoclass));
+      }
+    }
+
+    return content;
+  }
+
+  function getStylesheetsContent(vm, template) {
+    var stylesheets = template.stylesheets,
+        stylesheetToken = template.stylesheetToken;
+    var content = [];
+
+    if (!isUndefined$1(stylesheets) && stylesheets.length !== 0) {
+      content = evaluateStylesheetsContent(stylesheets, stylesheetToken, vm);
+    }
+
+    return content;
+  } // It might be worth caching this to avoid doing the lookup repeatedly, but
+  // perf testing has not shown it to be a huge improvement yet:
+  // https://github.com/salesforce/lwc/pull/2460#discussion_r691208892
+
+
+  function getNearestShadowComponent(vm) {
+    var owner = vm;
+
+    while (!isNull(owner)) {
+      if (owner.renderMode === 1
+      /* RenderMode.Shadow */
+      ) {
+        return owner;
+      }
+
+      owner = owner.owner;
+    }
+
+    return owner;
+  }
+  /**
+   * If the component that is currently being rendered uses scoped styles,
+   * this returns the unique token for that scoped stylesheet. Otherwise
+   * it returns null.
+   */
+
+
+  function getScopeTokenClass(owner) {
+    var cmpTemplate = owner.cmpTemplate,
+        context = owner.context;
+    return context.hasScopedStyles && (cmpTemplate === null || cmpTemplate === void 0 ? void 0 : cmpTemplate.stylesheetToken) || null;
+  }
+
+  function getNearestNativeShadowComponent(vm) {
+    var owner = getNearestShadowComponent(vm);
+
+    if (!isNull(owner) && owner.shadowMode === 1
+    /* ShadowMode.Synthetic */
+    ) {
+      // Synthetic-within-native is impossible. So if the nearest shadow component is
+      // synthetic, we know we won't find a native component if we go any further.
+      return null;
+    }
+
+    return owner;
+  }
+
+  function createStylesheet(vm, stylesheets) {
+    var renderMode = vm.renderMode,
+        shadowMode = vm.shadowMode,
+        _vm$renderer2 = vm.renderer,
+        ssr = _vm$renderer2.ssr,
+        insertStylesheet = _vm$renderer2.insertStylesheet;
+
+    if (renderMode === 1
+    /* RenderMode.Shadow */
+    && shadowMode === 1
+    /* ShadowMode.Synthetic */
+    ) {
+      for (var _i12 = 0; _i12 < stylesheets.length; _i12++) {
+        insertStylesheet(stylesheets[_i12]);
+      }
+    } else if (ssr || vm.hydrated) {
+      // Note: We need to ensure that during hydration, the stylesheets method is the same as those in ssr.
+      //       This works in the client, because the stylesheets are created, and cached in the VM
+      //       the first time the VM renders.
+      // native shadow or light DOM, SSR
+      return ArrayMap.call(stylesheets, createInlineStyleVNode);
+    } else {
+      // native shadow or light DOM, DOM renderer
+      var root = getNearestNativeShadowComponent(vm); // null root means a global style
+
+      var target = isNull(root) ? undefined : root.shadowRoot;
+
+      for (var _i13 = 0; _i13 < stylesheets.length; _i13++) {
+        insertStylesheet(stylesheets[_i13], target);
+      }
+    }
+
+    return null;
+  }
   /*
    * Copyright (c) 2020, salesforce.com, inc.
    * All rights reserved.
@@ -4461,8 +4696,8 @@
 
     var setCSSStyleProperty = renderer.setCSSStyleProperty;
 
-    for (var _i11 = 0; _i11 < styleDecls.length; _i11++) {
-      var _styleDecls$_i = _slicedToArray(styleDecls[_i11], 3),
+    for (var _i14 = 0; _i14 < styleDecls.length; _i14++) {
+      var _styleDecls$_i = _slicedToArray(styleDecls[_i14], 3),
           prop = _styleDecls$_i[0],
           value = _styleDecls$_i[1],
           important = _styleDecls$_i[2];
@@ -4818,15 +5053,13 @@
 
 
   function setScopeTokenClassIfNecessary(elm, owner, renderer) {
-    var cmpTemplate = owner.cmpTemplate,
-        context = owner.context;
-    var getClassList = renderer.getClassList;
-    var token = cmpTemplate === null || cmpTemplate === void 0 ? void 0 : cmpTemplate.stylesheetToken;
+    var token = getScopeTokenClass(owner);
 
-    if (!isUndefined$1(token) && context.hasScopedStyles) {
-      // TODO [#2762]: this dot notation with add is probably problematic
+    if (!isNull(token)) {
+      var _getClassList = renderer.getClassList; // TODO [#2762]: this dot notation with add is probably problematic
       // probably we should have a renderer api for just the add operation
-      getClassList(elm).add(token);
+
+      _getClassList(elm).add(token);
     }
   }
 
@@ -5016,8 +5249,8 @@
     var oldSlots = vm.cmpSlots;
     var cmpSlots = vm.cmpSlots = create(null);
 
-    for (var _i12 = 0, len = children.length; _i12 < len; _i12 += 1) {
-      var vnode = children[_i12];
+    for (var _i15 = 0, len = children.length; _i15 < len; _i15 += 1) {
+      var vnode = children[_i15];
 
       if (isNull(vnode)) {
         continue;
@@ -5043,8 +5276,8 @@
         return;
       }
 
-      for (var _i13 = 0, _len4 = oldKeys.length; _i13 < _len4; _i13 += 1) {
-        var key = oldKeys[_i13];
+      for (var _i16 = 0, _len4 = oldKeys.length; _i16 < _len4; _i16 += 1) {
+        var key = oldKeys[_i16];
 
         if (isUndefined$1(cmpSlots[key]) || oldSlots[key].length !== cmpSlots[key].length) {
           markComponentAsDirty(vm);
@@ -5184,12 +5417,12 @@
       if (oldStartIdx > oldEndIdx) {
         // There's some cases in which the sub array of vnodes to be inserted is followed by null(s) and an
         // already processed vnode, in such cases the vnodes to be inserted should be before that processed vnode.
-        var _i14 = newEndIdx;
+        var _i17 = newEndIdx;
         var n;
 
         do {
-          n = newCh[++_i14];
-        } while (!isVNode(n) && _i14 < newChEnd);
+          n = newCh[++_i17];
+        } while (!isVNode(n) && _i17 < newChEnd);
 
         before = isVNode(n) ? n.elm : null;
         mountVNodes(newCh, parent, renderer, before, newStartIdx, newEndIdx + 1);
@@ -5220,9 +5453,9 @@
 
     var anchor = null;
 
-    for (var _i15 = c2Length - 1; _i15 >= 0; _i15 -= 1) {
-      var n1 = c1[_i15];
-      var n2 = c2[_i15];
+    for (var _i18 = c2Length - 1; _i18 >= 0; _i18 -= 1) {
+      var n1 = c1[_i18];
+      var n2 = c2[_i18];
 
       if (n2 !== n1) {
         if (isVNode(n1)) {
@@ -5768,229 +6001,6 @@
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
 
-  function makeHostToken(token) {
-    return "".concat(token, "-host");
-  }
-
-  function createInlineStyleVNode(content) {
-    return api.h('style', {
-      key: 'style',
-      attrs: {
-        type: 'text/css'
-      }
-    }, [api.t(content)]);
-  }
-
-  function updateStylesheetToken(vm, template) {
-    var elm = vm.elm,
-        context = vm.context,
-        renderMode = vm.renderMode,
-        shadowMode = vm.shadowMode,
-        _vm$renderer = vm.renderer,
-        getClassList = _vm$renderer.getClassList,
-        removeAttribute = _vm$renderer.removeAttribute,
-        setAttribute = _vm$renderer.setAttribute;
-    var newStylesheets = template.stylesheets,
-        newStylesheetToken = template.stylesheetToken;
-    var isSyntheticShadow = renderMode === 1
-    /* RenderMode.Shadow */
-    && shadowMode === 1
-    /* ShadowMode.Synthetic */
-    ;
-    var hasScopedStyles = context.hasScopedStyles;
-    var newToken;
-    var newHasTokenInClass;
-    var newHasTokenInAttribute; // Reset the styling token applied to the host element.
-
-    var oldToken = context.stylesheetToken,
-        oldHasTokenInClass = context.hasTokenInClass,
-        oldHasTokenInAttribute = context.hasTokenInAttribute;
-
-    if (!isUndefined$1(oldToken)) {
-      if (oldHasTokenInClass) {
-        getClassList(elm).remove(makeHostToken(oldToken));
-      }
-
-      if (oldHasTokenInAttribute) {
-        removeAttribute(elm, makeHostToken(oldToken));
-      }
-    } // Apply the new template styling token to the host element, if the new template has any
-    // associated stylesheets. In the case of light DOM, also ensure there is at least one scoped stylesheet.
-
-
-    if (!isUndefined$1(newStylesheets) && newStylesheets.length !== 0) {
-      newToken = newStylesheetToken;
-    } // Set the new styling token on the host element
-
-
-    if (!isUndefined$1(newToken)) {
-      if (hasScopedStyles) {
-        getClassList(elm).add(makeHostToken(newToken));
-        newHasTokenInClass = true;
-      }
-
-      if (isSyntheticShadow) {
-        setAttribute(elm, makeHostToken(newToken), '');
-        newHasTokenInAttribute = true;
-      }
-    } // Update the styling tokens present on the context object.
-
-
-    context.stylesheetToken = newToken;
-    context.hasTokenInClass = newHasTokenInClass;
-    context.hasTokenInAttribute = newHasTokenInAttribute;
-  }
-
-  function evaluateStylesheetsContent(stylesheets, stylesheetToken, vm) {
-    var content = [];
-    var root;
-
-    for (var _i16 = 0; _i16 < stylesheets.length; _i16++) {
-      var stylesheet = stylesheets[_i16];
-
-      if (isArray$1(stylesheet)) {
-        ArrayPush$1.apply(content, evaluateStylesheetsContent(stylesheet, stylesheetToken, vm));
-      } else {
-        if (process.env.NODE_ENV !== 'production') {
-          // Check for compiler version mismatch in dev mode only
-          checkVersionMismatch(stylesheet, 'stylesheet'); // in dev-mode, we support hot swapping of stylesheet, which means that
-          // the component instance might be attempting to use an old version of
-          // the stylesheet, while internally, we have a replacement for it.
-
-          stylesheet = getStyleOrSwappedStyle(stylesheet);
-        }
-
-        var isScopedCss = stylesheet[KEY__SCOPED_CSS]; // Apply the scope token only if the stylesheet itself is scoped, or if we're rendering synthetic shadow.
-
-        var scopeToken = isScopedCss || vm.shadowMode === 1
-        /* ShadowMode.Synthetic */
-        && vm.renderMode === 1
-        /* RenderMode.Shadow */
-        ? stylesheetToken : undefined; // Use the actual `:host` selector if we're rendering global CSS for light DOM, or if we're rendering
-        // native shadow DOM. Synthetic shadow DOM never uses `:host`.
-
-        var useActualHostSelector = vm.renderMode === 0
-        /* RenderMode.Light */
-        ? !isScopedCss : vm.shadowMode === 0
-        /* ShadowMode.Native */
-        ; // Use the native :dir() pseudoclass only in native shadow DOM. Otherwise, in synthetic shadow,
-        // we use an attribute selector on the host to simulate :dir().
-
-        var useNativeDirPseudoclass = void 0;
-
-        if (vm.renderMode === 1
-        /* RenderMode.Shadow */
-        ) {
-          useNativeDirPseudoclass = vm.shadowMode === 0
-          /* ShadowMode.Native */
-          ;
-        } else {
-          // Light DOM components should only render `[dir]` if they're inside of a synthetic shadow root.
-          // At the top level (root is null) or inside of a native shadow root, they should use `:dir()`.
-          if (isUndefined$1(root)) {
-            // Only calculate the root once as necessary
-            root = getNearestShadowComponent(vm);
-          }
-
-          useNativeDirPseudoclass = isNull(root) || root.shadowMode === 0
-          /* ShadowMode.Native */
-          ;
-        }
-
-        ArrayPush$1.call(content, stylesheet(scopeToken, useActualHostSelector, useNativeDirPseudoclass));
-      }
-    }
-
-    return content;
-  }
-
-  function getStylesheetsContent(vm, template) {
-    var stylesheets = template.stylesheets,
-        stylesheetToken = template.stylesheetToken;
-    var content = [];
-
-    if (!isUndefined$1(stylesheets) && stylesheets.length !== 0) {
-      content = evaluateStylesheetsContent(stylesheets, stylesheetToken, vm);
-    }
-
-    return content;
-  } // It might be worth caching this to avoid doing the lookup repeatedly, but
-  // perf testing has not shown it to be a huge improvement yet:
-  // https://github.com/salesforce/lwc/pull/2460#discussion_r691208892
-
-
-  function getNearestShadowComponent(vm) {
-    var owner = vm;
-
-    while (!isNull(owner)) {
-      if (owner.renderMode === 1
-      /* RenderMode.Shadow */
-      ) {
-        return owner;
-      }
-
-      owner = owner.owner;
-    }
-
-    return owner;
-  }
-
-  function getNearestNativeShadowComponent(vm) {
-    var owner = getNearestShadowComponent(vm);
-
-    if (!isNull(owner) && owner.shadowMode === 1
-    /* ShadowMode.Synthetic */
-    ) {
-      // Synthetic-within-native is impossible. So if the nearest shadow component is
-      // synthetic, we know we won't find a native component if we go any further.
-      return null;
-    }
-
-    return owner;
-  }
-
-  function createStylesheet(vm, stylesheets) {
-    var renderMode = vm.renderMode,
-        shadowMode = vm.shadowMode,
-        _vm$renderer2 = vm.renderer,
-        ssr = _vm$renderer2.ssr,
-        insertStylesheet = _vm$renderer2.insertStylesheet;
-
-    if (renderMode === 1
-    /* RenderMode.Shadow */
-    && shadowMode === 1
-    /* ShadowMode.Synthetic */
-    ) {
-      for (var _i17 = 0; _i17 < stylesheets.length; _i17++) {
-        insertStylesheet(stylesheets[_i17]);
-      }
-    } else if (ssr || vm.hydrated) {
-      // Note: We need to ensure that during hydration, the stylesheets method is the same as those in ssr.
-      //       This works in the client, because the stylesheets are created, and cached in the VM
-      //       the first time the VM renders.
-      // native shadow or light DOM, SSR
-      return ArrayMap.call(stylesheets, createInlineStyleVNode);
-    } else {
-      // native shadow or light DOM, DOM renderer
-      var root = getNearestNativeShadowComponent(vm); // null root means a global style
-
-      var target = isNull(root) ? undefined : root.shadowRoot;
-
-      for (var _i18 = 0; _i18 < stylesheets.length; _i18++) {
-        insertStylesheet(stylesheets[_i18], target);
-      }
-    }
-
-    return null;
-  }
-  /*
-   * Copyright (c) 2018, salesforce.com, inc.
-   * All rights reserved.
-   * SPDX-License-Identifier: MIT
-   * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
-   */
-
-
   var operationIdNameMapping = ['constructor', 'render', 'patch', 'connectedCallback', 'renderedCallback', 'disconnectedCallback', 'errorCallback', 'lwc-hydrate', 'lwc-rehydrate']; // Even if all the browser the engine supports implements the UserTiming API, we need to guard the measure APIs.
   // JSDom (used in Jest) for example doesn't implement the UserTiming APIs.
 
@@ -7954,11 +7964,27 @@
   }
 
   function validateClassAttr(vnode, elm, renderer) {
-    var _vnode$data = vnode.data,
-        className = _vnode$data.className,
-        classMap = _vnode$data.classMap;
+    var data = vnode.data,
+        owner = vnode.owner;
+    var className = data.className,
+        classMap = data.classMap;
     var getProperty = renderer.getProperty,
         getClassList = renderer.getClassList;
+    var scopedToken = getScopeTokenClass(owner); // Classnames for scoped CSS are added directly to the DOM during rendering,
+    // or to the VDOM on the server in the case of SSR. As such, these classnames
+    // are never present in VDOM nodes in the browser.
+    //
+    // Consequently, hydration mismatches will occur if scoped CSS token classnames
+    // are rendered during SSR. This needs to be accounted for when validating.
+
+    if (scopedToken) {
+      if (!isUndefined$1(className)) {
+        className = "".concat(scopedToken, " ").concat(className);
+      } else if (!isUndefined$1(classMap)) {
+        classMap = Object.assign(Object.assign({}, classMap), _defineProperty({}, scopedToken, true));
+      }
+    }
+
     var nodesAreCompatible = true;
     var vnodeClassName;
 
@@ -7996,9 +8022,9 @@
   }
 
   function validateStyleAttr(vnode, elm, renderer) {
-    var _vnode$data2 = vnode.data,
-        style = _vnode$data2.style,
-        styleDecls = _vnode$data2.styleDecls;
+    var _vnode$data = vnode.data,
+        style = _vnode$data.style,
+        styleDecls = _vnode$data.styleDecls;
     var getAttribute = renderer.getAttribute;
     var elmStyle = getAttribute(elm, 'style') || '';
     var vnodeStyle;
@@ -8271,7 +8297,7 @@
 
     return ctor;
   }
-  /* version: 2.20.0 */
+  /* version: 2.20.3 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -8306,10 +8332,6 @@
     };
   }
 
-  function isDocument(target) {
-    return !isUndefined$1(target.head);
-  }
-
   function createFreshStyleElement(content) {
     var elm = document.createElement('style');
     elm.type = 'text/css';
@@ -8318,11 +8340,11 @@
   }
 
   function createStyleElement(content, cacheData) {
-    var stylesheet = cacheData.stylesheet,
-        used = cacheData.used; // If the <style> was already used, then we should clone it. We cannot insert
+    var element = cacheData.element,
+        usedElement = cacheData.usedElement; // If the <style> was already used, then we should clone it. We cannot insert
     // the same <style> in two places in the DOM.
 
-    if (used) {
+    if (usedElement) {
       // For a mysterious reason, IE11 doesn't like the way we clone <style> nodes
       // and will render the incorrect styles if we do things that way. It's just
       // a perf optimization, so we can skip it for IE11.
@@ -8332,12 +8354,12 @@
       // faster to call `cloneNode()` on an existing node than to recreate it every time.
 
 
-      return stylesheet.cloneNode(true);
+      return element.cloneNode(true);
     } // We don't clone every time, because that would be a perf tax on the first time
 
 
-    cacheData.used = true;
-    return stylesheet;
+    cacheData.usedElement = true;
+    return element;
   }
 
   function createConstructableStylesheet(content) {
@@ -8360,40 +8382,36 @@
 
   function insertStyleElement(content, target, cacheData) {
     var elm = createStyleElement(content, cacheData);
-    var targetAnchorPoint = isDocument(target) ? target.head : target;
-    targetAnchorPoint.appendChild(elm);
-  }
-
-  function doInsertStylesheet(content, target, cacheData) {
-    // Constructable stylesheets are only supported in certain browsers:
-    // https://caniuse.com/mdn-api_document_adoptedstylesheets
-    // The reason we use it is for perf: https://github.com/salesforce/lwc/pull/2460
-    if (supportsConstructableStylesheets) {
-      insertConstructableStylesheet(content, target, cacheData);
-    } else {
-      // Fall back to <style> element
-      insertStyleElement(content, target, cacheData);
-    }
+    target.appendChild(elm);
   }
 
-  function getCacheData(content) {
+  function getCacheData(content, useConstructableStylesheet) {
     var cacheData = stylesheetCache.get(content);
 
     if (isUndefined$1(cacheData)) {
       cacheData = {
-        stylesheet: supportsConstructableStylesheets ? createConstructableStylesheet(content) : createFreshStyleElement(content),
+        stylesheet: undefined,
+        element: undefined,
         roots: undefined,
         global: false,
-        used: false
+        usedElement: false
       };
       stylesheetCache.set(content, cacheData);
+    } // Create <style> elements or CSSStyleSheets on-demand, as needed
+
+
+    if (useConstructableStylesheet && isUndefined$1(cacheData.stylesheet)) {
+      cacheData.stylesheet = createConstructableStylesheet(content);
+    } else if (!useConstructableStylesheet && isUndefined$1(cacheData.element)) {
+      cacheData.element = createFreshStyleElement(content);
     }
 
     return cacheData;
   }
 
   function insertGlobalStylesheet(content) {
-    var cacheData = getCacheData(content);
+    // Force a <style> element for global stylesheets. See comment below.
+    var cacheData = getCacheData(content, false);
 
     if (cacheData.global) {
       // already inserted
@@ -8401,12 +8419,13 @@
     }
 
     cacheData.global = true; // mark inserted
+    // TODO [#2922]: use document.adoptedStyleSheets in supported browsers. Currently we can't, due to backwards compat.
 
-    doInsertStylesheet(content, document, cacheData);
+    insertStyleElement(content, document.head, cacheData);
   }
 
   function insertLocalStylesheet(content, target) {
-    var cacheData = getCacheData(content);
+    var cacheData = getCacheData(content, supportsConstructableStylesheets);
     var roots = cacheData.roots;
 
     if (isUndefined$1(roots)) {
@@ -8417,8 +8436,16 @@
     }
 
     roots.add(target); // mark inserted
+    // Constructable stylesheets are only supported in certain browsers:
+    // https://caniuse.com/mdn-api_document_adoptedstylesheets
+    // The reason we use it is for perf: https://github.com/salesforce/lwc/pull/2460
 
-    doInsertStylesheet(content, target, cacheData);
+    if (supportsConstructableStylesheets) {
+      insertConstructableStylesheet(content, target, cacheData);
+    } else {
+      // Fall back to <style> element
+      insertStyleElement(content, target, cacheData);
+    }
   }
 
   function insertStylesheet(content, target) {
@@ -8567,7 +8594,15 @@
   }
 
   function attachShadow(element, options) {
-    if (hydrating) {
+    // `hydrating` will be true in two cases:
+    //   1. upon initial load with an SSR-generated DOM, while in Shadow render mode
+    //   2. when a webapp author places <c-app> in their static HTML and mounts their
+    //      root component with customeElement.define('c-app', Ctor)
+    //
+    // The second case can be treated as a failed hydration with nominal impact
+    // to performance. However, because <c-app> won't have a <template shadowroot>
+    // declarative child, `element.shadowRoot` is `null`.
+    if (hydrating && element.shadowRoot) {
       return element.shadowRoot;
     }
 
@@ -9091,7 +9126,7 @@
   });
   freeze(LightningElement);
   seal(LightningElement.prototype);
-  /* version: 2.20.0 */
+  /* version: 2.20.3 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;