lwc 2.23.1 → 2.23.2

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

@@ -365,9 +365,9 @@ var LWC = (function (exports) {
   // Increment whenever the LWC template compiler changes
 
 
-  var LWC_VERSION = "2.23.1";
+  var LWC_VERSION = "2.23.2";
   var LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-  /** version: 2.23.1 */
+  /** version: 2.23.2 */
 
   /**
    * Copyright (C) 2018 salesforce.com, inc.
@@ -461,7 +461,7 @@ var LWC = (function (exports) {
       patch$1(propName);
     }
   }
-  /** version: 2.23.1 */
+  /** version: 2.23.2 */
 
   /**
    * Copyright (C) 2018 salesforce.com, inc.
@@ -483,6 +483,7 @@ var LWC = (function (exports) {
     ENABLE_HTML_COLLECTIONS_PATCH: null,
     ENABLE_INNER_OUTER_TEXT_PATCH: null,
     ENABLE_MIXED_SHADOW_MODE: null,
+    ENABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE: null,
     ENABLE_NODE_LIST_PATCH: null,
     ENABLE_NODE_PATCH: null,
     ENABLE_REACTIVE_SETTER: null,
@@ -552,7 +553,7 @@ var LWC = (function (exports) {
       setFeatureFlag(name, value);
     }
   }
-  /** version: 2.23.1 */
+  /** version: 2.23.2 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -994,8 +995,8 @@ var LWC = (function (exports) {
   // to inject at runtime.
 
 
-  var HTMLElementConstructor$1 = typeof HTMLElement !== 'undefined' ? HTMLElement : function () {};
-  var HTMLElementPrototype = HTMLElementConstructor$1.prototype;
+  var HTMLElementConstructor = typeof HTMLElement !== 'undefined' ? HTMLElement : function () {};
+  var HTMLElementPrototype = HTMLElementConstructor.prototype;
   /*
    * Copyright (c) 2018, salesforce.com, inc.
    * All rights reserved.
@@ -1215,10 +1216,10 @@ var LWC = (function (exports) {
     }; // Apply extra restriction related to DOM manipulation if the element is not a portal.
 
     if (!options.isLight && !options.isPortal) {
-      var _appendChild = elm.appendChild,
-          _insertBefore = elm.insertBefore,
-          _removeChild = elm.removeChild,
-          _replaceChild = elm.replaceChild;
+      var appendChild = elm.appendChild,
+          insertBefore = elm.insertBefore,
+          removeChild = elm.removeChild,
+          replaceChild = elm.replaceChild;
       var originalNodeValueDescriptor = getPropertyDescriptor(elm, 'nodeValue');
       var originalInnerHTMLDescriptor = getPropertyDescriptor(elm, 'innerHTML');
       var originalTextContentDescriptor = getPropertyDescriptor(elm, 'textContent');
@@ -1226,7 +1227,7 @@ var LWC = (function (exports) {
         appendChild: generateDataDescriptor({
           value: function value(aChild) {
             logMissingPortalError('appendChild', 'method');
-            return _appendChild.call(this, aChild);
+            return appendChild.call(this, aChild);
           }
         }),
         insertBefore: generateDataDescriptor({
@@ -1235,7 +1236,7 @@ var LWC = (function (exports) {
               logMissingPortalError('insertBefore', 'method');
             }
 
-            return _insertBefore.call(this, newNode, referenceNode);
+            return insertBefore.call(this, newNode, referenceNode);
           }
         }),
         removeChild: generateDataDescriptor({
@@ -1244,13 +1245,13 @@ var LWC = (function (exports) {
               logMissingPortalError('removeChild', 'method');
             }
 
-            return _removeChild.call(this, aChild);
+            return removeChild.call(this, aChild);
           }
         }),
         replaceChild: generateDataDescriptor({
           value: function value(newChild, oldChild) {
             logMissingPortalError('replaceChild', 'method');
-            return _replaceChild.call(this, newChild, oldChild);
+            return replaceChild.call(this, newChild, oldChild);
           }
         }),
         nodeValue: generateAccessorDescriptor({
@@ -2411,9 +2412,8 @@ var LWC = (function (exports) {
     var bridge = def.bridge;
 
     if (process.env.NODE_ENV !== 'production') {
-      var _assertInstanceOfHTMLElement = vm.renderer.assertInstanceOfHTMLElement;
-
-      _assertInstanceOfHTMLElement(vm.elm, "Component creation requires a DOM element to be associated to ".concat(vm, "."));
+      var assertInstanceOfHTMLElement = vm.renderer.assertInstanceOfHTMLElement;
+      assertInstanceOfHTMLElement(vm.elm, "Component creation requires a DOM element to be associated to ".concat(vm, "."));
     }
 
     var component = this;
@@ -3590,7 +3590,7 @@ var LWC = (function (exports) {
     return HTMLBridgeElement;
   }
 
-  var BaseBridgeElement = HTMLBridgeElementFactory(HTMLElementConstructor$1, getOwnPropertyNames$1(HTMLElementOriginalDescriptors), []);
+  var BaseBridgeElement = HTMLBridgeElementFactory(HTMLElementConstructor, getOwnPropertyNames$1(HTMLElementOriginalDescriptors), []);
   freeze(BaseBridgeElement);
   seal(BaseBridgeElement.prototype);
   /*
@@ -4385,6 +4385,18 @@ var LWC = (function (exports) {
    */
 
 
+  function checkHasVM(elm) {
+    var hasVM = !isUndefined$1(getAssociatedVMIfPresent(elm));
+
+    if (process.env.NODE_ENV !== 'production' && !hasVM) {
+      // Occurs when an element is manually created with the same tag name as an existing LWC component. In that case,
+      // we skip calling the LWC connectedCallback/disconnectedCallback logic and log an error.
+      logError("VM for tag name \"".concat(elm.tagName.toLowerCase(), "\" is undefined. ") + "This indicates that an element was created with this tag name, " + "which is already reserved by an LWC component. Use lwc.createElement " + "instead to create elements.");
+    }
+
+    return hasVM;
+  }
+
   function getUpgradableConstructor(tagName, renderer) {
     var getCustomElement = renderer.getCustomElement,
         RendererHTMLElement = renderer.HTMLElementExported,
@@ -4426,6 +4438,20 @@ var LWC = (function (exports) {
       return _createClass(LWCUpgradableElement);
     }(RendererHTMLElement);
 
+    if (lwcRuntimeFlags.ENABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE) {
+      CE.prototype.connectedCallback = function () {
+        if (checkHasVM(this)) {
+          connectRootElement(this);
+        }
+      };
+
+      CE.prototype.disconnectedCallback = function () {
+        if (checkHasVM(this)) {
+          disconnectRootElement(this);
+        }
+      };
+    }
+
     defineCustomElement(tagName, CE);
     return CE;
   }
@@ -4537,6 +4563,15 @@ var LWC = (function (exports) {
       // different than the one previously set.
 
       if (isFirstPatch || cur !== (isLiveBindingProp(sel, key) ? getProperty(elm, key) : oldProps[key])) {
+        // Additional verification if properties are supported by the element
+        // Validation relies on html properties and public properties being defined on the element,
+        // SSR has its own custom validation.
+        if (process.env.NODE_ENV !== 'production') {
+          if (!(key in elm)) {
+            logWarn("Unknown public property \"".concat(key, "\" of element <").concat(elm.tagName.toLowerCase(), ">. This is either a typo on the corresponding attribute \"").concat(htmlPropertyToAttribute(key), "\", or the attribute does not exist in this browser or DOM implementation."));
+          }
+        }
+
         setProperty(elm, key, cur);
       }
     }
@@ -4949,13 +4984,19 @@ var LWC = (function (exports) {
     insertNode(elm, parent, anchor, renderer);
 
     if (vm) {
-      if (process.env.NODE_ENV !== 'production') {
-        assert.isTrue(vm.state === 0
-        /* VMState.created */
-        , "".concat(vm, " cannot be recycled."));
-      }
+      {
+        if (!lwcRuntimeFlags.ENABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE) {
+          if (process.env.NODE_ENV !== 'production') {
+            // With synthetic lifecycle callbacks, it's possible for elements to be removed without the engine
+            // noticing it (e.g. `appendChild` the same host element twice). This test ensures we don't regress.
+            assert.isTrue(vm.state === 0
+            /* VMState.created */
+            , "".concat(vm, " cannot be recycled."));
+          }
 
-      runConnectedCallback(vm);
+          runConnectedCallback(vm);
+        }
+      }
     }
 
     mountVNodes(vnode.children, elm, renderer, null);
@@ -5145,10 +5186,10 @@ var LWC = (function (exports) {
     var scopeToken = getScopeTokenClass(owner);
 
     if (!isNull(scopeToken)) {
-      var _getClassList = renderer.getClassList; // TODO [#2762]: this dot notation with add is probably problematic
+      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(scopeToken);
+      getClassList(elm).add(scopeToken);
     } // Set property element for synthetic shadow DOM style scoping.
 
 
@@ -7663,6 +7704,8 @@ var LWC = (function (exports) {
     return renderer.nextSibling(hydratedNode);
   }
 
+  var NODE_VALUE_PROP = 'nodeValue';
+
   function hydrateText(node, vnode, renderer) {
     var _a;
 
@@ -7673,9 +7716,8 @@ var LWC = (function (exports) {
     }
 
     if (process.env.NODE_ENV !== 'production') {
-      var _getProperty = renderer.getProperty;
-
-      var nodeValue = _getProperty(node, 'nodeValue');
+      var getProperty = renderer.getProperty;
+      var nodeValue = getProperty(node, NODE_VALUE_PROP);
 
       if (nodeValue !== vnode.text && !(nodeValue === "\u200D" && vnode.text === '')) {
         logWarn('Hydration mismatch: text values do not match, will recover from the difference', vnode.owner);
@@ -7698,9 +7740,8 @@ var LWC = (function (exports) {
     }
 
     if (process.env.NODE_ENV !== 'production') {
-      var _getProperty2 = renderer.getProperty;
-
-      var nodeValue = _getProperty2(node, 'nodeValue');
+      var getProperty = renderer.getProperty;
+      var nodeValue = getProperty(node, NODE_VALUE_PROP);
 
       if (nodeValue !== vnode.text) {
         logWarn('Hydration mismatch: comment values do not match, will recover from the difference', vnode.owner);
@@ -7708,7 +7749,7 @@ var LWC = (function (exports) {
     }
 
     var setProperty = renderer.setProperty;
-    setProperty(node, 'nodeValue', (_a = vnode.text) !== null && _a !== void 0 ? _a : null);
+    setProperty(node, NODE_VALUE_PROP, (_a = vnode.text) !== null && _a !== void 0 ? _a : null);
     vnode.elm = node;
     return node;
   }
@@ -7740,17 +7781,17 @@ var LWC = (function (exports) {
       // it may be that this element has lwc:inner-html, we need to diff and in case are the same,
       // remove the innerHTML from props so it reuses the existing dom elements.
       var props = vnode.data.props;
-      var _getProperty3 = renderer.getProperty;
+      var getProperty = renderer.getProperty;
 
       if (!isUndefined$1(props) && !isUndefined$1(props.innerHTML)) {
-        if (_getProperty3(elm, 'innerHTML') === props.innerHTML) {
+        if (getProperty(elm, 'innerHTML') === props.innerHTML) {
           // Do a shallow clone since VNodeData may be shared across VNodes due to hoist optimization
           vnode.data = Object.assign(Object.assign({}, vnode.data), {
             props: cloneAndOmitKey(props, 'innerHTML')
           });
         } else {
           if (process.env.NODE_ENV !== 'production') {
-            logWarn("Mismatch hydrating element <".concat(_getProperty3(elm, 'tagName').toLowerCase(), ">: innerHTML values do not match for element, will recover from the difference"), owner);
+            logWarn("Mismatch hydrating element <".concat(getProperty(elm, 'tagName').toLowerCase(), ">: innerHTML values do not match for element, will recover from the difference"), owner);
           }
         }
       }
@@ -7759,8 +7800,8 @@ var LWC = (function (exports) {
     patchElementPropsAndAttrs(vnode, renderer);
 
     if (!isDomManual) {
-      var _getFirstChild = renderer.getFirstChild;
-      hydrateChildren(_getFirstChild(elm), vnode.children, elm, owner);
+      var getFirstChild = renderer.getFirstChild;
+      hydrateChildren(getFirstChild(elm), vnode.children, elm, owner);
     }
 
     return elm;
@@ -7799,10 +7840,10 @@ var LWC = (function (exports) {
     if (vm.renderMode !== 0
     /* RenderMode.Light */
     ) {
-      var _getFirstChild2 = renderer.getFirstChild; // VM is not rendering in Light DOM, we can proceed and hydrate the slotted content.
+      var getFirstChild = renderer.getFirstChild; // VM is not rendering in Light DOM, we can proceed and hydrate the slotted content.
       // Note: for Light DOM, this is handled while hydrating the VM
 
-      hydrateChildren(_getFirstChild2(elm), vnode.children, elm, vm);
+      hydrateChildren(getFirstChild(elm), vnode.children, elm, vm);
     }
 
     hydrateVM(vm);
@@ -7851,11 +7892,11 @@ var LWC = (function (exports) {
       // next node in the list to be hydrated.
 
 
-      var _nextSibling = renderer.nextSibling;
+      var nextSibling = renderer.nextSibling;
 
       do {
         var current = nextNode;
-        nextNode = _nextSibling(nextNode);
+        nextNode = nextSibling(nextNode);
         removeNode(current, parentNode, renderer);
       } while (nextNode);
     }
@@ -7918,14 +7959,13 @@ var LWC = (function (exports) {
           attrValue = _Object$entries$_i[1];
 
       var owner = vnode.owner;
-      var _getAttribute = renderer.getAttribute;
-
-      var elmAttrValue = _getAttribute(elm, attrName);
+      var getAttribute = renderer.getAttribute;
+      var elmAttrValue = getAttribute(elm, attrName);
 
       if (String(attrValue) !== elmAttrValue) {
         if (process.env.NODE_ENV !== 'production') {
-          var _getProperty4 = renderer.getProperty;
-          logError("Mismatch hydrating element <".concat(_getProperty4(elm, 'tagName').toLowerCase(), ">: attribute \"").concat(attrName, "\" has different values, expected \"").concat(attrValue, "\" but found \"").concat(elmAttrValue, "\""), owner);
+          var getProperty = renderer.getProperty;
+          logError("Mismatch hydrating element <".concat(getProperty(elm, 'tagName').toLowerCase(), ">: attribute \"").concat(attrName, "\" has different values, expected \"").concat(attrValue, "\" but found \"").concat(elmAttrValue, "\""), owner);
         }
 
         nodesAreCompatible = false;
@@ -8036,8 +8076,8 @@ var LWC = (function (exports) {
 
     if (!nodesAreCompatible) {
       if (process.env.NODE_ENV !== 'production') {
-        var _getProperty5 = renderer.getProperty;
-        logError("Mismatch hydrating element <".concat(_getProperty5(elm, 'tagName').toLowerCase(), ">: attribute \"style\" has different values, expected \"").concat(vnodeStyle, "\" but found \"").concat(elmStyle, "\"."), vnode.owner);
+        var getProperty = renderer.getProperty;
+        logError("Mismatch hydrating element <".concat(getProperty(elm, 'tagName').toLowerCase(), ">: attribute \"style\" has different values, expected \"").concat(vnodeStyle, "\" but found \"").concat(elmStyle, "\"."), vnode.owner);
       }
     }
 
@@ -8057,7 +8097,7 @@ var LWC = (function (exports) {
         return false;
       }
 
-      return getProperty(client, 'nodeValue') === getProperty(ssr, 'nodeValue');
+      return getProperty(client, NODE_VALUE_PROP) === getProperty(ssr, NODE_VALUE_PROP);
     }
 
     if (getProperty(client, 'nodeType') === 8
@@ -8069,7 +8109,7 @@ var LWC = (function (exports) {
         return false;
       }
 
-      return getProperty(client, 'nodeValue') === getProperty(ssr, 'nodeValue');
+      return getProperty(client, NODE_VALUE_PROP) === getProperty(ssr, NODE_VALUE_PROP);
     }
 
     if (!hasCorrectNodeType(vnode, ssr, 1
@@ -8269,7 +8309,7 @@ var LWC = (function (exports) {
 
     return ctor;
   }
-  /* version: 2.23.1 */
+  /* version: 2.23.2 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -8436,361 +8476,395 @@ var LWC = (function (exports) {
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
 
+  /**
+   * A factory function that produces a renderer.
+   * Renderer encapsulates operations that are required to render an LWC component into the underlying
+   * runtime environment. In the case of @lwc/enigne-dom, it is meant to be used in a DOM environment.
+   * Example usage:
+   * import { renderer, rendererFactory } from 'lwc';
+   * const customRenderer = rendererFactory(renderer);
+   *
+   * @param baseRenderer Either null or the base renderer imported from 'lwc'.
+   */
 
-  var SUPPORTS_TEMPLATE = typeof HTMLTemplateElement === 'function';
-  var createFragment;
 
-  if (SUPPORTS_TEMPLATE) {
-    // Parse the fragment HTML string into DOM
-    createFragment = function createFragment(html) {
-      var template = document.createElement('template');
-      template.innerHTML = html;
-      return template.content.firstChild;
-    };
-  } else {
-    // In browsers that don't support <template> (e.g. IE11), we need to be careful to wrap elements like
-    // <td> in the proper container elements (e.g. <tbody>), because otherwise they will be parsed as null.
-    // Via https://github.com/webcomponents/polyfills/blob/ee1db33/packages/template/template.js#L273-L280
-    // With other elements added from:
-    // https://github.com/sindresorhus/html-tags/blob/95dcdd5/index.js
-    // Using the test:
-    // document.createRange().createContextualFragment(`<${tag}></${tag}>`).firstChild === null
-    // And omitting <html>, <head>, and <body> as these are not practical in an LWC component.
-    var topLevelWrappingMap = {
-      caption: ['table'],
-      col: ['colgroup', 'table'],
-      colgroup: ['table'],
-      option: ['select'],
-      tbody: ['table'],
-      td: ['tr', 'tbody', 'table'],
-      th: ['tr', 'tbody', 'table'],
-      thead: ['table'],
-      tfoot: ['table'],
-      tr: ['tbody', 'table']
-    }; // Via https://github.com/webcomponents/polyfills/blob/ee1db33/packages/template/template.js#L282-L288
-
-    var getTagName = function getTagName(text) {
-      return (/<([a-z][^/\0>\x20\t\r\n\f]+)/i.exec(text) || ['', ''])[1].toLowerCase();
-    }; // Via https://github.com/webcomponents/polyfills/blob/ee1db33/packages/template/template.js#L295-L320
-
-
-    createFragment = function createFragment(html) {
-      var wrapperTags = topLevelWrappingMap[getTagName(html)];
-
-      if (!isUndefined$1(wrapperTags)) {
-        var _iterator5 = _createForOfIteratorHelper(wrapperTags),
-            _step5;
+  function rendererFactory(baseRenderer) {
+    // Util functions
+    function assertInvariant(value, msg) {
+      if (!value) {
+        throw new Error("Invariant Violation: ".concat(msg));
+      }
+    }
 
-        try {
-          for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-            var wrapperTag = _step5.value;
-            html = "<".concat(wrapperTag, ">").concat(html, "</").concat(wrapperTag, ">");
-          }
-        } catch (err) {
-          _iterator5.e(err);
-        } finally {
-          _iterator5.f();
-        }
-      } // For IE11, the document title must not be undefined, but it can be an empty string
-      // https://developer.mozilla.org/en-US/docs/Web/API/DOMImplementation/createHTMLDocument#browser_compatibility
+    function isNull(obj) {
+      return obj === null;
+    }
 
+    function isUndefined(obj) {
+      return obj === undefined;
+    }
 
-      var doc = document.implementation.createHTMLDocument('');
-      doc.body.innerHTML = html;
-      var content = doc.body;
+    var getCustomElement;
+    var defineCustomElement;
+    var HTMLElementConstructor;
 
-      if (!isUndefined$1(wrapperTags)) {
-        for (var _i32 = 0; _i32 < wrapperTags.length; _i32++) {
-          content = content.firstChild;
-        }
+    function isCustomElementRegistryAvailable() {
+      if (typeof customElements === 'undefined') {
+        return false;
       }
 
-      return content.firstChild;
-    };
-  }
-  /*
-   * 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
-   */
+      try {
+        // dereference HTMLElement global because babel wraps globals in compat mode with a
+        // _wrapNativeSuper()
+        // This is a problem because LWCUpgradableElement extends renderer.HTMLElementExported which does not
+        // get wrapped by babel.
+        var HTMLElementAlias = HTMLElement; // In case we use compat mode with a modern browser, the compat mode transformation
+        // invokes the DOM api with an .apply() or .call() to initialize any DOM api sub-classing,
+        // which are not equipped to be initialized that way.
 
+        var clazz = /*#__PURE__*/function (_HTMLElementAlias) {
+          _inherits(clazz, _HTMLElementAlias);
 
-  var getCustomElement;
-  var defineCustomElement;
-  var HTMLElementConstructor;
+          var _super7 = _createSuper(clazz);
 
-  function isCustomElementRegistryAvailable() {
-    if (typeof customElements === 'undefined') {
-      return false;
+          function clazz() {
+            _classCallCheck(this, clazz);
+
+            return _super7.apply(this, arguments);
+          }
+
+          return _createClass(clazz);
+        }(HTMLElementAlias);
+
+        customElements.define('lwc-test-' + Math.floor(Math.random() * 1000000), clazz);
+        new clazz();
+        return true;
+      } catch (_a) {
+        return false;
+      }
     }
 
-    try {
-      // dereference HTMLElement global because babel wraps globals in compat mode with a
-      // _wrapNativeSuper()
-      // This is a problem because LWCUpgradableElement extends renderer.HTMLElementExported which does not
-      // get wrapped by babel.
-      var HTMLElementAlias = HTMLElement; // In case we use compat mode with a modern browser, the compat mode transformation
-      // invokes the DOM api with an .apply() or .call() to initialize any DOM api sub-classing,
-      // which are not equipped to be initialized that way.
+    if (isCustomElementRegistryAvailable()) {
+      getCustomElement = customElements.get.bind(customElements);
+      defineCustomElement = customElements.define.bind(customElements);
+      HTMLElementConstructor = HTMLElement;
+    } else {
+      var registry = Object.create(null);
+      var reverseRegistry = new WeakMap();
 
-      var clazz = /*#__PURE__*/function (_HTMLElementAlias) {
-        _inherits(clazz, _HTMLElementAlias);
+      defineCustomElement = function define(name, ctor) {
+        if (name !== String.prototype.toLowerCase.call(name) || registry[name]) {
+          throw new TypeError("Invalid Registration");
+        }
 
-        var _super7 = _createSuper(clazz);
+        registry[name] = ctor;
+        reverseRegistry.set(ctor, name);
+      };
 
-        function clazz() {
-          _classCallCheck(this, clazz);
+      getCustomElement = function get(name) {
+        return registry[name];
+      };
 
-          return _super7.apply(this, arguments);
+      HTMLElementConstructor = function HTMLElement() {
+        if (!(this instanceof HTMLElement)) {
+          throw new TypeError("Invalid Invocation");
         }
 
-        return _createClass(clazz);
-      }(HTMLElementAlias);
+        var constructor = this.constructor;
+        var name = reverseRegistry.get(constructor);
 
-      customElements.define('lwc-test-' + Math.floor(Math.random() * 1000000), clazz);
-      new clazz();
-      return true;
-    } catch (_a) {
-      return false;
+        if (!name) {
+          throw new TypeError("Invalid Construction");
+        }
+
+        var elm = document.createElement(name);
+        Object.setPrototypeOf(elm, constructor.prototype);
+        return elm;
+      };
+
+      HTMLElementConstructor.prototype = HTMLElement.prototype;
     }
-  }
 
-  if (isCustomElementRegistryAvailable()) {
-    getCustomElement = customElements.get.bind(customElements);
-    defineCustomElement = customElements.define.bind(customElements);
-    HTMLElementConstructor = HTMLElement;
-  } else {
-    var registry = create(null);
-    var reverseRegistry = new WeakMap();
+    function cloneNode(node, deep) {
+      return node.cloneNode(deep);
+    }
 
-    defineCustomElement = function define(name, ctor) {
-      if (name !== StringToLowerCase.call(name) || registry[name]) {
-        throw new TypeError("Invalid Registration");
-      }
+    function createElement(tagName, namespace) {
+      return isUndefined(namespace) ? document.createElement(tagName) : document.createElementNS(namespace, tagName);
+    }
 
-      registry[name] = ctor;
-      reverseRegistry.set(ctor, name);
-    };
+    function createText(content) {
+      return document.createTextNode(content);
+    }
 
-    getCustomElement = function get(name) {
-      return registry[name];
-    };
+    function createComment(content) {
+      return document.createComment(content);
+    }
 
-    HTMLElementConstructor = function HTMLElement() {
-      if (!(this instanceof HTMLElement)) {
-        throw new TypeError("Invalid Invocation");
-      }
+    var createFragment; // IE11 lacks support for this feature
 
-      var constructor = this.constructor;
-      var name = reverseRegistry.get(constructor);
+    var SUPPORTS_TEMPLATE = typeof HTMLTemplateElement === 'function';
 
-      if (!name) {
-        throw new TypeError("Invalid Construction");
-      }
+    if (SUPPORTS_TEMPLATE) {
+      // Parse the fragment HTML string into DOM
+      createFragment = function createFragment(html) {
+        var template = document.createElement('template');
+        template.innerHTML = html;
+        return template.content.firstChild;
+      };
+    } else {
+      // In browsers that don't support <template> (e.g. IE11), we need to be careful to wrap elements like
+      // <td> in the proper container elements (e.g. <tbody>), because otherwise they will be parsed as null.
+      // Via https://github.com/webcomponents/polyfills/blob/ee1db33/packages/template/template.js#L273-L280
+      // With other elements added from:
+      // https://github.com/sindresorhus/html-tags/blob/95dcdd5/index.js
+      // Using the test:
+      // document.createRange().createContextualFragment(`<${tag}></${tag}>`).firstChild === null
+      // And omitting <html>, <head>, and <body> as these are not practical in an LWC component.
+      var topLevelWrappingMap = {
+        caption: ['table'],
+        col: ['colgroup', 'table'],
+        colgroup: ['table'],
+        option: ['select'],
+        tbody: ['table'],
+        td: ['tr', 'tbody', 'table'],
+        th: ['tr', 'tbody', 'table'],
+        thead: ['table'],
+        tfoot: ['table'],
+        tr: ['tbody', 'table']
+      }; // Via https://github.com/webcomponents/polyfills/blob/ee1db33/packages/template/template.js#L282-L288
+
+      var getTagName = function getTagName(text) {
+        return (/<([a-z][^/\0>\x20\t\r\n\f]+)/i.exec(text) || ['', ''])[1].toLowerCase();
+      }; // Via https://github.com/webcomponents/polyfills/blob/ee1db33/packages/template/template.js#L295-L320
+
+
+      createFragment = function createFragment(html) {
+        var wrapperTags = topLevelWrappingMap[getTagName(html)];
+
+        if (!isUndefined(wrapperTags)) {
+          var _iterator5 = _createForOfIteratorHelper(wrapperTags),
+              _step5;
+
+          try {
+            for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+              var wrapperTag = _step5.value;
+              html = "<".concat(wrapperTag, ">").concat(html, "</").concat(wrapperTag, ">");
+            }
+          } catch (err) {
+            _iterator5.e(err);
+          } finally {
+            _iterator5.f();
+          }
+        } // For IE11, the document title must not be undefined, but it can be an empty string
+        // https://developer.mozilla.org/en-US/docs/Web/API/DOMImplementation/createHTMLDocument#browser_compatibility
 
-      var elm = document.createElement(name);
-      setPrototypeOf(elm, constructor.prototype);
-      return elm;
-    };
 
-    HTMLElementConstructor.prototype = HTMLElement.prototype;
-  }
+        var doc = document.implementation.createHTMLDocument('');
+        doc.body.innerHTML = html;
+        var content = doc.body;
 
-  var isNativeShadowDefined = _globalThis[KEY__IS_NATIVE_SHADOW_ROOT_DEFINED];
-  var isSyntheticShadowDefined = hasOwnProperty$1.call(Element.prototype, KEY__SHADOW_TOKEN);
+        if (!isUndefined(wrapperTags)) {
+          for (var _i32 = 0; _i32 < wrapperTags.length; _i32++) {
+            content = content.firstChild;
+          }
+        }
 
-  function cloneNode(node, deep) {
-    return node.cloneNode(deep);
-  }
+        return content.firstChild;
+      };
+    }
 
-  function createElement$1(tagName, namespace) {
-    return isUndefined$1(namespace) ? document.createElement(tagName) : document.createElementNS(namespace, tagName);
-  }
+    function insert(node, parent, anchor) {
+      parent.insertBefore(node, anchor);
+    }
 
-  function createText(content) {
-    return document.createTextNode(content);
-  }
+    function remove(node, parent) {
+      parent.removeChild(node);
+    }
 
-  function createComment(content) {
-    return document.createComment(content);
-  }
+    function nextSibling(node) {
+      return node.nextSibling;
+    }
 
-  function insert(node, parent, anchor) {
-    parent.insertBefore(node, anchor);
-  }
+    function attachShadow(element, options) {
+      // `shadowRoot` will be non-null 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 customElement.define('c-app', Ctor)
+      if (!isNull(element.shadowRoot)) {
+        return element.shadowRoot;
+      }
 
-  function remove(node, parent) {
-    parent.removeChild(node);
-  }
+      return element.attachShadow(options);
+    }
 
-  function nextSibling(node) {
-    return node.nextSibling;
-  }
+    function setText(node, content) {
+      node.nodeValue = content;
+    }
 
-  function attachShadow(element, options) {
-    // `shadowRoot` will be non-null 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 customElement.define('c-app', Ctor)
-    if (!isNull(element.shadowRoot)) {
-      return element.shadowRoot;
+    function getProperty(node, key) {
+      return node[key];
     }
 
-    return element.attachShadow(options);
-  }
+    function setProperty(node, key, value) {
+      node[key] = value;
+    }
 
-  function setText(node, content) {
-    node.nodeValue = content;
-  }
+    function getAttribute(element, name, namespace) {
+      return isUndefined(namespace) ? element.getAttribute(name) : element.getAttributeNS(namespace, name);
+    }
 
-  function getProperty(node, key) {
-    return node[key];
-  }
+    function setAttribute(element, name, value, namespace) {
+      return isUndefined(namespace) ? element.setAttribute(name, value) : element.setAttributeNS(namespace, name, value);
+    }
 
-  function setProperty(node, key, value) {
-    if (process.env.NODE_ENV !== 'production') {
-      if (node instanceof Element && !(key in node)) {
-        // TODO [#1297]: Move this validation to the compiler
-        assert.fail("Unknown public property \"".concat(key, "\" of element <").concat(node.tagName, ">. This is likely a typo on the corresponding attribute \"").concat(htmlPropertyToAttribute(key), "\"."));
+    function removeAttribute(element, name, namespace) {
+      if (isUndefined(namespace)) {
+        element.removeAttribute(name);
+      } else {
+        element.removeAttributeNS(namespace, name);
       }
     }
 
-    node[key] = value;
-  }
+    function addEventListener(target, type, callback, options) {
+      target.addEventListener(type, callback, options);
+    }
 
-  function getAttribute(element, name, namespace) {
-    return isUndefined$1(namespace) ? element.getAttribute(name) : element.getAttributeNS(namespace, name);
-  }
+    function removeEventListener(target, type, callback, options) {
+      target.removeEventListener(type, callback, options);
+    }
 
-  function setAttribute(element, name, value, namespace) {
-    return isUndefined$1(namespace) ? element.setAttribute(name, value) : element.setAttributeNS(namespace, name, value);
-  }
+    function dispatchEvent(target, event) {
+      return target.dispatchEvent(event);
+    }
 
-  function removeAttribute(element, name, namespace) {
-    if (isUndefined$1(namespace)) {
-      element.removeAttribute(name);
-    } else {
-      element.removeAttributeNS(namespace, name);
+    function getClassList(element) {
+      return element.classList;
     }
-  }
 
-  function addEventListener(target, type, callback, options) {
-    target.addEventListener(type, callback, options);
-  }
+    function setCSSStyleProperty(element, name, value, important) {
+      // TODO [#0]: How to avoid this type casting? Shall we use a different type interface to
+      // represent elements in the engine?
+      element.style.setProperty(name, value, important ? 'important' : '');
+    }
 
-  function removeEventListener(target, type, callback, options) {
-    target.removeEventListener(type, callback, options);
-  }
+    function getBoundingClientRect(element) {
+      return element.getBoundingClientRect();
+    }
 
-  function dispatchEvent(target, event) {
-    return target.dispatchEvent(event);
-  }
+    function querySelector(element, selectors) {
+      return element.querySelector(selectors);
+    }
 
-  function getClassList(element) {
-    return element.classList;
-  }
+    function querySelectorAll(element, selectors) {
+      return element.querySelectorAll(selectors);
+    }
 
-  function setCSSStyleProperty(element, name, value, important) {
-    // TODO [#0]: How to avoid this type casting? Shall we use a different type interface to
-    // represent elements in the engine?
-    element.style.setProperty(name, value, important ? 'important' : '');
-  }
+    function getElementsByTagName(element, tagNameOrWildCard) {
+      return element.getElementsByTagName(tagNameOrWildCard);
+    }
 
-  function getBoundingClientRect(element) {
-    return element.getBoundingClientRect();
-  }
+    function getElementsByClassName(element, names) {
+      return element.getElementsByClassName(names);
+    }
 
-  function querySelector(element, selectors) {
-    return element.querySelector(selectors);
-  }
+    function getChildren(element) {
+      return element.children;
+    }
 
-  function querySelectorAll(element, selectors) {
-    return element.querySelectorAll(selectors);
-  }
+    function getChildNodes(element) {
+      return element.childNodes;
+    }
 
-  function getElementsByTagName(element, tagNameOrWildCard) {
-    return element.getElementsByTagName(tagNameOrWildCard);
-  }
+    function getFirstChild(element) {
+      return element.firstChild;
+    }
 
-  function getElementsByClassName(element, names) {
-    return element.getElementsByClassName(names);
-  }
+    function getFirstElementChild(element) {
+      return element.firstElementChild;
+    }
 
-  function getChildren(element) {
-    return element.children;
-  }
+    function getLastChild(element) {
+      return element.lastChild;
+    }
 
-  function getChildNodes(element) {
-    return element.childNodes;
-  }
+    function getLastElementChild(element) {
+      return element.lastElementChild;
+    }
 
-  function getFirstChild(element) {
-    return element.firstChild;
-  }
+    function isConnected(node) {
+      return node.isConnected;
+    }
 
-  function getFirstElementChild(element) {
-    return element.firstElementChild;
-  }
+    function assertInstanceOfHTMLElement(elm, msg) {
+      assertInvariant(elm instanceof HTMLElement, msg);
+    }
 
-  function getLastChild(element) {
-    return element.lastChild;
-  }
+    var HTMLElementExported = HTMLElementConstructor;
+    var renderer = {
+      HTMLElementExported: HTMLElementExported,
+      insert: insert,
+      remove: remove,
+      cloneNode: cloneNode,
+      createFragment: createFragment,
+      createElement: createElement,
+      createText: createText,
+      createComment: createComment,
+      nextSibling: nextSibling,
+      attachShadow: attachShadow,
+      getProperty: getProperty,
+      setProperty: setProperty,
+      setText: setText,
+      getAttribute: getAttribute,
+      setAttribute: setAttribute,
+      removeAttribute: removeAttribute,
+      addEventListener: addEventListener,
+      removeEventListener: removeEventListener,
+      dispatchEvent: dispatchEvent,
+      getClassList: getClassList,
+      setCSSStyleProperty: setCSSStyleProperty,
+      getBoundingClientRect: getBoundingClientRect,
+      querySelector: querySelector,
+      querySelectorAll: querySelectorAll,
+      getElementsByTagName: getElementsByTagName,
+      getElementsByClassName: getElementsByClassName,
+      getChildren: getChildren,
+      getChildNodes: getChildNodes,
+      getFirstChild: getFirstChild,
+      getFirstElementChild: getFirstElementChild,
+      getLastChild: getLastChild,
+      getLastElementChild: getLastElementChild,
+      isConnected: isConnected,
+      assertInstanceOfHTMLElement: assertInstanceOfHTMLElement,
+      defineCustomElement: defineCustomElement,
+      getCustomElement: getCustomElement
+    }; // Meant to inherit any properties passed via the base renderer as the argument to the factory.
 
-  function getLastElementChild(element) {
-    return element.lastElementChild;
+    Object.setPrototypeOf(renderer, baseRenderer);
+    return renderer;
   }
+  /*
+   * 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 isConnected(node) {
-    return node.isConnected;
-  }
+  /**
+   * The base renderer that will be used by engine-core.
+   * This will be used for DOM operations when lwc is running in a browser environment.
+   */
 
-  function assertInstanceOfHTMLElement(elm, msg) {
-    assert.invariant(elm instanceof HTMLElement, msg);
-  }
 
-  var HTMLElementExported = HTMLElementConstructor;
-  var renderer = {
-    isNativeShadowDefined: isNativeShadowDefined,
-    isSyntheticShadowDefined: isSyntheticShadowDefined,
-    HTMLElementExported: HTMLElementExported,
-    insert: insert,
-    remove: remove,
-    cloneNode: cloneNode,
-    createFragment: createFragment,
-    createElement: createElement$1,
-    createText: createText,
-    createComment: createComment,
-    nextSibling: nextSibling,
-    attachShadow: attachShadow,
-    getProperty: getProperty,
-    setProperty: setProperty,
-    setText: setText,
-    getAttribute: getAttribute,
-    setAttribute: setAttribute,
-    removeAttribute: removeAttribute,
-    addEventListener: addEventListener,
-    removeEventListener: removeEventListener,
-    dispatchEvent: dispatchEvent,
-    getClassList: getClassList,
-    setCSSStyleProperty: setCSSStyleProperty,
-    getBoundingClientRect: getBoundingClientRect,
-    querySelector: querySelector,
-    querySelectorAll: querySelectorAll,
-    getElementsByTagName: getElementsByTagName,
-    getElementsByClassName: getElementsByClassName,
-    getChildren: getChildren,
-    getChildNodes: getChildNodes,
-    getFirstChild: getFirstChild,
-    getFirstElementChild: getFirstElementChild,
-    getLastChild: getLastChild,
-    getLastElementChild: getLastElementChild,
-    isConnected: isConnected,
+  var renderer = assign( // The base renderer will invoke the factory with null and assign additional properties that are
+  // shared across renderers
+  rendererFactory(null), // Properties that are either not required to be sandboxed or rely on a globally shared information
+  {
+    // insertStyleSheet implementation shares a global cache of stylesheet data
     insertStylesheet: insertStylesheet,
-    assertInstanceOfHTMLElement: assertInstanceOfHTMLElement,
-    defineCustomElement: defineCustomElement,
-    getCustomElement: getCustomElement
-  };
+    isNativeShadowDefined: _globalThis[KEY__IS_NATIVE_SHADOW_ROOT_DEFINED],
+    isSyntheticShadowDefined: hasOwnProperty$1.call(Element.prototype, KEY__SHADOW_TOKEN)
+  });
   /*
    * Copyright (c) 2018, salesforce.com, inc.
    * All rights reserved.
@@ -8962,7 +9036,6 @@ var LWC = (function (exports) {
    * SPDX-License-Identifier: MIT
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
-  // TODO [#2472]: Remove this workaround when appropriate.
   // eslint-disable-next-line @lwc/lwc-internal/no-global-node
 
 
@@ -8982,39 +9055,41 @@ var LWC = (function (exports) {
     }
 
     return node; // for convenience
-  } // Monkey patching Node methods to be able to detect the insertions and removal of root elements
-  // created via createElement.
-
+  }
 
-  var _Node$1$prototype = _Node$1.prototype,
-      _appendChild2 = _Node$1$prototype.appendChild,
-      _insertBefore2 = _Node$1$prototype.insertBefore,
-      _removeChild2 = _Node$1$prototype.removeChild,
-      _replaceChild2 = _Node$1$prototype.replaceChild;
-  assign(_Node$1.prototype, {
-    appendChild: function appendChild(newChild) {
-      var appendedNode = _appendChild2.call(this, newChild);
+  if (!lwcRuntimeFlags.ENABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE) {
+    // Monkey patching Node methods to be able to detect the insertions and removal of root elements
+    // created via createElement.
+    var _Node$1$prototype = _Node$1.prototype,
+        _appendChild = _Node$1$prototype.appendChild,
+        _insertBefore = _Node$1$prototype.insertBefore,
+        _removeChild = _Node$1$prototype.removeChild,
+        _replaceChild = _Node$1$prototype.replaceChild;
+    assign(_Node$1.prototype, {
+      appendChild: function appendChild(newChild) {
+        var appendedNode = _appendChild.call(this, newChild);
 
-      return callNodeSlot(appendedNode, ConnectingSlot);
-    },
-    insertBefore: function insertBefore(newChild, referenceNode) {
-      var insertedNode = _insertBefore2.call(this, newChild, referenceNode);
+        return callNodeSlot(appendedNode, ConnectingSlot);
+      },
+      insertBefore: function insertBefore(newChild, referenceNode) {
+        var insertedNode = _insertBefore.call(this, newChild, referenceNode);
 
-      return callNodeSlot(insertedNode, ConnectingSlot);
-    },
-    removeChild: function removeChild(oldChild) {
-      var removedNode = _removeChild2.call(this, oldChild);
+        return callNodeSlot(insertedNode, ConnectingSlot);
+      },
+      removeChild: function removeChild(oldChild) {
+        var removedNode = _removeChild.call(this, oldChild);
 
-      return callNodeSlot(removedNode, DisconnectingSlot);
-    },
-    replaceChild: function replaceChild(newChild, oldChild) {
-      var replacedNode = _replaceChild2.call(this, newChild, oldChild);
+        return callNodeSlot(removedNode, DisconnectingSlot);
+      },
+      replaceChild: function replaceChild(newChild, oldChild) {
+        var replacedNode = _replaceChild.call(this, newChild, oldChild);
 
-      callNodeSlot(replacedNode, DisconnectingSlot);
-      callNodeSlot(newChild, ConnectingSlot);
-      return replacedNode;
-    }
-  });
+        callNodeSlot(replacedNode, DisconnectingSlot);
+        callNodeSlot(newChild, ConnectingSlot);
+        return replacedNode;
+      }
+    });
+  }
   /**
    * EXPERIMENTAL: This function is almost identical to document.createElement with the slightly
    * difference that in the options, you can pass the `is` property set to a Constructor instead of
@@ -9027,6 +9102,7 @@ var LWC = (function (exports) {
    * ```
    */
 
+
   function createElement(sel, options) {
     if (!isObject(options) || isNull(options)) {
       throw new TypeError("\"createElement\" function expects an object as second parameter but received \"".concat(toString$1(options), "\"."));
@@ -9054,8 +9130,12 @@ var LWC = (function (exports) {
         mode: options.mode !== 'closed' ? 'open' : 'closed',
         owner: null
       });
-      ConnectingSlot.set(elm, connectRootElement);
-      DisconnectingSlot.set(elm, disconnectRootElement);
+
+      if (!lwcRuntimeFlags.ENABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE) {
+        ConnectingSlot.set(elm, connectRootElement);
+        DisconnectingSlot.set(elm, disconnectRootElement);
+      }
+
       wasComponentUpgraded = true;
     });
 
@@ -9102,7 +9182,7 @@ var LWC = (function (exports) {
     // inserted nodes without the `lwc:dom=manual` directive will be considered as global elements.
 
 
-    return isSyntheticShadowDefined && !isUndefined$1(node[KEY__SHADOW_RESOLVER]);
+    return renderer.isSyntheticShadowDefined && !isUndefined$1(node[KEY__SHADOW_RESOLVER]);
   }
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -9146,7 +9226,7 @@ var LWC = (function (exports) {
   });
   freeze(LightningElement);
   seal(LightningElement.prototype);
-  /* version: 2.23.1 */
+  /* version: 2.23.2 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;
@@ -9168,6 +9248,7 @@ var LWC = (function (exports) {
   exports.registerDecorators = registerDecorators;
   exports.registerTemplate = registerTemplate;
   exports.renderer = renderer;
+  exports.rendererFactory = rendererFactory;
   exports.sanitizeAttribute = sanitizeAttribute;
   exports.setFeatureFlag = setFeatureFlag;
   exports.setFeatureFlagForTest = setFeatureFlagForTest;