@lwc/engine-core 2.9.0 → 2.10.0

package/dist/engine-core.js

@@ -1,5 +1,5 @@
 /* proxy-compat-disable */
-import { seal, create, isFunction as isFunction$1, ArrayPush as ArrayPush$1, isUndefined as isUndefined$1, ArrayIndexOf, ArraySplice, StringToLowerCase, ArrayJoin, isNull, isFrozen, defineProperty, assign, forEach, keys, AriaPropNameToAttrNameMap, getPropertyDescriptor, defineProperties, getOwnPropertyNames as getOwnPropertyNames$1, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, isObject, assert, KEY__SYNTHETIC_MODE, toString as toString$1, isFalse, isTrue, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, freeze, htmlPropertyToAttribute, ArraySlice, hasOwnProperty as hasOwnProperty$1, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, isString, StringSlice, SVG_NAMESPACE, KEY__SHADOW_RESOLVER, isArray as isArray$1, isNumber, StringReplace, KEY__SCOPED_CSS, noop, ArrayUnshift, ArrayFilter } from '@lwc/shared';
+import { seal, create, isFunction as isFunction$1, ArrayPush as ArrayPush$1, isUndefined as isUndefined$1, ArrayIndexOf, ArraySplice, StringToLowerCase, ArrayJoin, isNull, isFrozen, defineProperty, assign, forEach, keys, AriaPropNameToAttrNameMap, getPropertyDescriptor, defineProperties, getOwnPropertyNames as getOwnPropertyNames$1, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, isObject, assert, KEY__SYNTHETIC_MODE, toString as toString$1, isFalse, isTrue, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, LWC_VERSION_COMMENT_REGEX, LWC_VERSION, freeze, htmlPropertyToAttribute, ArraySlice, hasOwnProperty as hasOwnProperty$1, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, isString, StringSlice, SVG_NAMESPACE, KEY__SHADOW_RESOLVER, isArray as isArray$1, isNumber, StringReplace, KEY__SCOPED_CSS, noop, ArrayUnshift, ArrayFilter } from '@lwc/shared';
 import { runtimeFlags } from '@lwc/features';
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
 
@@ -81,6 +81,19 @@ function cloneAndOmitKey(object, keyToOmit) {
 
   return result;
 }
+function flattenStylesheets(stylesheets) {
+  const list = [];
+
+  for (const stylesheet of stylesheets) {
+    if (!Array.isArray(stylesheet)) {
+      list.push(stylesheet);
+    } else {
+      list.push(...flattenStylesheets(stylesheet));
+    }
+  }
+
+  return list;
+}
 
 //
 // Primitives
@@ -2774,6 +2787,45 @@ function getDecoratorsMeta(Ctor) {
   return isUndefined$1(meta) ? defaultMeta : meta;
 }
 
+/*
+ * 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
+ */
+let warned = false;
+
+if (process.env.NODE_ENV === 'development') {
+  // @ts-ignore
+  window.__lwcResetWarnedOnVersionMismatch = () => {
+    warned = false;
+  };
+}
+
+function checkVersionMismatch(func, type) {
+  const versionMatcher = func.toString().match(LWC_VERSION_COMMENT_REGEX);
+
+  if (!isNull(versionMatcher) && !warned) {
+    const version = versionMatcher[1];
+    const [major, minor] = version.split('.');
+    const [expectedMajor, expectedMinor] = LWC_VERSION.split('.');
+
+    if (major !== expectedMajor || minor !== expectedMinor) {
+      warned = true; // only warn once to avoid flooding the console
+      // stylesheets and templates do not have user-meaningful names, but components do
+
+      const friendlyName = type === 'component' ? `${type} ${func.name}` : type;
+      logError(`LWC WARNING: current engine is v${LWC_VERSION}, but ${friendlyName} was compiled with v${version}.\nPlease update your compiled code or LWC engine so that the versions match.\nNo further warnings will appear.`);
+    }
+  }
+}
+
+/*
+ * 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
+ */
 const signedTemplateSet = new Set();
 function defaultEmptyTemplate() {
   return [];
@@ -2782,12 +2834,27 @@ signedTemplateSet.add(defaultEmptyTemplate);
 function isTemplateRegistered(tpl) {
   return signedTemplateSet.has(tpl);
 }
+
+function checkTemplateVersionMismatch(template) {
+  checkVersionMismatch(template, 'template');
+
+  if (!isUndefined$1(template.stylesheets)) {
+    for (const stylesheet of flattenStylesheets(template.stylesheets)) {
+      checkVersionMismatch(stylesheet, 'stylesheet');
+    }
+  }
+}
 /**
  * INTERNAL: This function can only be invoked by compiled code. The compiler
  * will prevent this function from being imported by userland code.
  */
 
+
 function registerTemplate(tpl) {
+  if (process.env.NODE_ENV !== 'production') {
+    checkTemplateVersionMismatch(tpl);
+  }
+
   signedTemplateSet.add(tpl); // chaining this method as a way to wrap existing
   // assignment of templates easily, without too much transformation
 
@@ -3079,20 +3146,6 @@ function rehydrateHotComponent(Ctor) {
   return canRefreshAllInstances;
 }
 
-function flattenStylesheets(stylesheets) {
-  const list = [];
-
-  for (const stylesheet of stylesheets) {
-    if (!Array.isArray(stylesheet)) {
-      list.push(stylesheet);
-    } else {
-      list.push(...flattenStylesheets(stylesheet));
-    }
-  }
-
-  return list;
-}
-
 function getTemplateOrSwappedTemplate(tpl) {
   if (process.env.NODE_ENV === 'production') {
     // this method should never leak to prod
@@ -3904,156 +3957,268 @@ function applyStaticStyleAttribute(vnode) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-const TextHook = {
-  create: vnode => {
-    const {
-      owner
-    } = vnode;
-    const elm = createText(vnode.text);
-    linkNodeToShadow(elm, owner);
-    vnode.elm = elm;
-  },
-  update: updateNodeHook,
-  insert: insertNode,
-  move: insertNode,
-  remove: removeNode
-};
-const CommentHook = {
-  create: vnode => {
-    const {
-      owner,
-      text
-    } = vnode;
-    const elm = createComment(text);
-    linkNodeToShadow(elm, owner);
-    vnode.elm = elm;
-  },
-  update: updateNodeHook,
-  insert: insertNode,
-  move: insertNode,
-  remove: removeNode
-}; // insert is called after update, which is used somewhere else (via a module)
-// to mark the vm as inserted, that means we cannot use update as the main channel
-// to rehydrate when dirty, because sometimes the element is not inserted just yet,
-// which breaks some invariants. For that reason, we have the following for any
-// Custom Element that is inserted via a template.
-
-const ElementHook = {
-  create: vnode => {
-    const {
-      sel,
-      owner,
-      data: {
-        svg
-      }
-    } = vnode;
-    const namespace = isTrue(svg) ? SVG_NAMESPACE : undefined;
-    const elm = createElement(sel, namespace);
-    linkNodeToShadow(elm, owner);
-    fallbackElmHook(elm, vnode);
-    vnode.elm = elm;
-    patchElementPropsAndAttrs$1(null, vnode);
-  },
-  update: (oldVnode, vnode) => {
-    patchElementPropsAndAttrs$1(oldVnode, vnode);
-    patchChildren(vnode.elm, oldVnode.children, vnode.children);
-  },
-  insert: (vnode, parentNode, referenceNode) => {
-    insertNode(vnode, parentNode, referenceNode);
-    createChildrenHook(vnode);
-  },
-  move: insertNode,
-  remove: (vnode, parentNode) => {
-    removeNode(vnode, parentNode);
-    removeChildren(vnode);
+function patchChildren(c1, c2, parent) {
+  if (hasDynamicChildren(c2)) {
+    updateDynamicChildren(c1, c2, parent);
+  } else {
+    updateStaticChildren(c1, c2, parent);
+  }
+}
+
+function patch(n1, n2) {
+  if (n1 === n2) {
+    return;
   }
-};
-const CustomElementHook = {
-  create: vnode => {
-    const {
-      sel,
-      owner
-    } = vnode;
-    const UpgradableConstructor = getUpgradableConstructor(sel);
-    /**
-     * Note: if the upgradable constructor does not expect, or throw when we new it
-     * with a callback as the first argument, we could implement a more advanced
-     * mechanism that only passes that argument if the constructor is known to be
-     * an upgradable custom element.
-     */
-
-    let vm;
-    const elm = new UpgradableConstructor(elm => {
-      // the custom element from the registry is expecting an upgrade callback
-      vm = createViewModelHook(elm, vnode);
-    });
-    linkNodeToShadow(elm, owner);
-    vnode.elm = elm;
 
-    if (vm) {
-      allocateChildren(vnode, vm);
-    } else if (vnode.ctor !== UpgradableConstructor) {
-      throw new TypeError(`Incorrect Component Constructor`);
+  if (process.env.NODE_ENV !== 'production') {
+    if (!isSameVnode(n1, n2)) {
+      throw new Error('Expected these VNodes to be the same: ' + JSON.stringify({
+        sel: n1.sel,
+        key: n1.key
+      }) + ', ' + JSON.stringify({
+        sel: n2.sel,
+        key: n2.key
+      }));
     }
+  }
 
-    patchElementPropsAndAttrs$1(null, vnode);
-  },
-  update: (oldVnode, vnode) => {
-    patchElementPropsAndAttrs$1(oldVnode, vnode);
-    const vm = getAssociatedVMIfPresent(vnode.elm);
+  switch (n2.type) {
+    case 0
+    /* Text */
+    :
+      patchText(n1, n2);
+      break;
+
+    case 1
+    /* Comment */
+    :
+      patchComment(n1, n2);
+      break;
 
-    if (vm) {
-      // in fallback mode, the allocation will always set children to
-      // empty and delegate the real allocation to the slot elements
-      allocateChildren(vnode, vm);
-    } // in fallback mode, the children will be always empty, so, nothing
-    // will happen, but in native, it does allocate the light dom
+    case 2
+    /* Element */
+    :
+      patchElement(n1, n2);
+      break;
 
+    case 3
+    /* CustomElement */
+    :
+      patchCustomElement(n1, n2);
+      break;
+  }
+}
 
-    patchChildren(vnode.elm, oldVnode.children, vnode.children);
+function mount(node, parent, anchor) {
+  switch (node.type) {
+    case 0
+    /* Text */
+    :
+      mountText(node, parent, anchor);
+      break;
 
-    if (vm) {
-      if (process.env.NODE_ENV !== 'production') {
-        assert.isTrue(isArray$1(vnode.children), `Invalid vnode for a custom element, it must have children defined.`);
-      } // this will probably update the shadowRoot, but only if the vm is in a dirty state
-      // this is important to preserve the top to bottom synchronous rendering phase.
+    case 1
+    /* Comment */
+    :
+      mountComment(node, parent, anchor);
+      break;
+
+    case 2
+    /* Element */
+    :
+      mountElement(node, parent, anchor);
+      break;
+
+    case 3
+    /* CustomElement */
+    :
+      mountCustomElement(node, parent, anchor);
+      break;
+  }
+}
+
+function patchText(n1, n2) {
+  n2.elm = n1.elm;
+
+  if (n2.text !== n1.text) {
+    updateTextContent(n2);
+  }
+}
+
+function mountText(node, parent, anchor) {
+  const {
+    owner
+  } = node;
+  const textNode = node.elm = createText(node.text);
+  linkNodeToShadow(textNode, owner);
+  insertNode(textNode, parent, anchor);
+}
+
+function patchComment(n1, n2) {
+  n2.elm = n1.elm; // FIXME: Comment nodes should be static, we shouldn't need to diff them together. However
+  // it is the case today.
+
+  if (n2.text !== n1.text) {
+    updateTextContent(n2);
+  }
+}
 
+function mountComment(node, parent, anchor) {
+  const {
+    owner
+  } = node;
+  const commentNode = node.elm = createComment(node.text);
+  linkNodeToShadow(commentNode, owner);
+  insertNode(commentNode, parent, anchor);
+}
 
-      rerenderVM(vm);
+function mountElement(vnode, parent, anchor) {
+  const {
+    sel,
+    owner,
+    data: {
+      svg
     }
-  },
-  insert: (vnode, parentNode, referenceNode) => {
-    insertNode(vnode, parentNode, referenceNode);
-    const vm = getAssociatedVMIfPresent(vnode.elm);
+  } = vnode;
+  const namespace = isTrue(svg) ? SVG_NAMESPACE : undefined;
+  const elm = createElement(sel, namespace);
+  linkNodeToShadow(elm, owner);
+  fallbackElmHook(elm, vnode);
+  vnode.elm = elm;
+  patchElementPropsAndAttrs$1(null, vnode);
+  insertNode(elm, parent, anchor);
+  mountVNodes(vnode.children, elm, null);
+}
 
-    if (vm) {
-      if (process.env.NODE_ENV !== 'production') {
-        assert.isTrue(vm.state === 0
-        /* created */
-        , `${vm} cannot be recycled.`);
-      }
+function patchElement(n1, n2) {
+  const elm = n2.elm = n1.elm;
+  patchElementPropsAndAttrs$1(n1, n2);
+  patchChildren(n1.children, n2.children, elm);
+}
+
+function mountCustomElement(vnode, parent, anchor) {
+  const {
+    sel,
+    owner
+  } = vnode;
+  const UpgradableConstructor = getUpgradableConstructor(sel);
+  /**
+   * Note: if the upgradable constructor does not expect, or throw when we new it
+   * with a callback as the first argument, we could implement a more advanced
+   * mechanism that only passes that argument if the constructor is known to be
+   * an upgradable custom element.
+   */
+
+  let vm;
+  const elm = new UpgradableConstructor(elm => {
+    // the custom element from the registry is expecting an upgrade callback
+    vm = createViewModelHook(elm, vnode);
+  });
+  linkNodeToShadow(elm, owner);
+  vnode.elm = elm;
+  vnode.vm = vm;
+
+  if (vm) {
+    allocateChildren(vnode, vm);
+  } else if (vnode.ctor !== UpgradableConstructor) {
+    throw new TypeError(`Incorrect Component Constructor`);
+  }
+
+  patchElementPropsAndAttrs$1(null, vnode);
+  insertNode(elm, parent, anchor);
 
-      runConnectedCallback(vm);
+  if (vm) {
+    if (process.env.NODE_ENV !== 'production') {
+      assert.isTrue(vm.state === 0
+      /* created */
+      , `${vm} cannot be recycled.`);
     }
 
-    createChildrenHook(vnode);
+    runConnectedCallback(vm);
+  }
+
+  mountVNodes(vnode.children, elm, null);
+
+  if (vm) {
+    appendVM(vm);
+  }
+}
+
+function patchCustomElement(n1, n2) {
+  const elm = n2.elm = n1.elm;
+  const vm = n2.vm = n1.vm;
+  patchElementPropsAndAttrs$1(n1, n2);
+
+  if (!isUndefined$1(vm)) {
+    // in fallback mode, the allocation will always set children to
+    // empty and delegate the real allocation to the slot elements
+    allocateChildren(n2, vm);
+  } // in fallback mode, the children will be always empty, so, nothing
+  // will happen, but in native, it does allocate the light dom
+
+
+  patchChildren(n1.children, n2.children, elm);
 
-    if (vm) {
-      appendVM(vm);
+  if (!isUndefined$1(vm)) {
+    // this will probably update the shadowRoot, but only if the vm is in a dirty state
+    // this is important to preserve the top to bottom synchronous rendering phase.
+    rerenderVM(vm);
+  }
+}
+
+function mountVNodes(vnodes, parent, anchor, start = 0, end = vnodes.length) {
+  for (; start < end; ++start) {
+    const vnode = vnodes[start];
+
+    if (isVNode(vnode)) {
+      mount(vnode, parent, anchor);
     }
-  },
-  move: insertNode,
-  remove: (vnode, parentNode) => {
-    removeNode(vnode, parentNode);
-    const vm = getAssociatedVMIfPresent(vnode.elm);
+  }
+}
+
+function unmount(vnode, parent, doRemove = false) {
+  const {
+    type,
+    elm
+  } = vnode; // When unmounting a VNode subtree not all the elements have to removed from the DOM. The
+  // subtree root, is the only element worth unmounting from the subtree.
+
+  if (doRemove) {
+    removeNode(elm, parent);
+  }
+
+  switch (type) {
+    case 2
+    /* Element */
+    :
+      unmountVNodes(vnode.children, elm);
+      break;
+
+    case 3
+    /* CustomElement */
+    :
+      {
+        const {
+          vm
+        } = vnode; // No need to unmount the children here, `removeVM` will take care of removing the
+        // children.
+
+        if (!isUndefined$1(vm)) {
+          removeVM(vm);
+        }
+      }
+  }
+}
 
-    if (vm) {
-      // for custom elements we don't have to go recursively because the removeVM routine
-      // will take care of disconnecting any child VM attached to its shadow as well.
-      removeVM(vm);
+function unmountVNodes(vnodes, parent, doRemove = false, start = 0, end = vnodes.length) {
+  for (; start < end; ++start) {
+    const ch = vnodes[start];
+
+    if (isVNode(ch)) {
+      unmount(ch, parent, doRemove);
     }
   }
-};
+}
 
 function isVNode(vnode) {
   return vnode != null;
@@ -4098,43 +4263,41 @@ function linkNodeToShadow(elm, owner) {
   }
 }
 
-function updateNodeHook(oldVnode, vnode) {
+function updateTextContent(vnode) {
   const {
     elm,
     text
   } = vnode;
 
-  if (oldVnode.text !== text) {
-    if (process.env.NODE_ENV !== 'production') {
-      unlockDomMutation();
-    }
+  if (process.env.NODE_ENV !== 'production') {
+    unlockDomMutation();
+  }
 
-    setText(elm, text);
+  setText(elm, text);
 
-    if (process.env.NODE_ENV !== 'production') {
-      lockDomMutation();
-    }
+  if (process.env.NODE_ENV !== 'production') {
+    lockDomMutation();
   }
 }
 
-function insertNode(vnode, parentNode, referenceNode) {
+function insertNode(node, parent, anchor) {
   if (process.env.NODE_ENV !== 'production') {
     unlockDomMutation();
   }
 
-  insert(vnode.elm, parentNode, referenceNode);
+  insert(node, parent, anchor);
 
   if (process.env.NODE_ENV !== 'production') {
     lockDomMutation();
   }
 }
 
-function removeNode(vnode, parentNode) {
+function removeNode(node, parent) {
   if (process.env.NODE_ENV !== 'production') {
     unlockDomMutation();
   }
 
-  remove(vnode.elm, parentNode);
+  remove(node, parent);
 
   if (process.env.NODE_ENV !== 'production') {
     lockDomMutation();
@@ -4207,13 +4370,6 @@ function fallbackElmHook(elm, vnode) {
   }
 }
 
-function patchChildren(parent, oldCh, newCh) {
-  if (hasDynamicChildren(newCh)) {
-    updateDynamicChildren(parent, oldCh, newCh);
-  } else {
-    updateStaticChildren(parent, oldCh, newCh);
-  }
-}
 function allocateChildren(vnode, vm) {
   // A component with slots will re-render because:
   // 1- There is a change of the internal state.
@@ -4289,40 +4445,6 @@ function createViewModelHook(elm, vnode) {
   return vm;
 }
 
-function createChildrenHook(vnode) {
-  const {
-    elm,
-    children
-  } = vnode;
-
-  for (let j = 0; j < children.length; ++j) {
-    const ch = children[j];
-
-    if (ch != null) {
-      ch.hook.create(ch);
-      ch.hook.insert(ch, elm, null);
-    }
-  }
-}
-
-function removeChildren(vnode) {
-  // this method only needs to search on child vnodes from template
-  // to trigger the remove hook just in case some of those children
-  // are custom elements.
-  const {
-    children,
-    elm
-  } = vnode;
-
-  for (let j = 0, len = children.length; j < len; ++j) {
-    const ch = children[j];
-
-    if (!isNull(ch)) {
-      ch.hook.remove(ch, elm);
-    }
-  }
-}
-
 function allocateInSlot(vm, children) {
   var _a;
 
@@ -4419,28 +4541,7 @@ function createKeyToOldIdx(children, beginIdx, endIdx) {
   return map;
 }
 
-function addVnodes(parentElm, before, vnodes, startIdx, endIdx) {
-  for (; startIdx <= endIdx; ++startIdx) {
-    const ch = vnodes[startIdx];
-
-    if (isVNode(ch)) {
-      ch.hook.create(ch);
-      ch.hook.insert(ch, parentElm, before);
-    }
-  }
-}
-
-function removeVnodes(parentElm, vnodes, startIdx, endIdx) {
-  for (; startIdx <= endIdx; ++startIdx) {
-    const ch = vnodes[startIdx]; // text nodes do not have logic associated to them
-
-    if (isVNode(ch)) {
-      ch.hook.remove(ch, parentElm);
-    }
-  }
-}
-
-function updateDynamicChildren(parentElm, oldCh, newCh) {
+function updateDynamicChildren(oldCh, newCh, parent) {
   let oldStartIdx = 0;
   let newStartIdx = 0;
   let oldEndIdx = oldCh.length - 1;
@@ -4466,23 +4567,23 @@ function updateDynamicChildren(parentElm, oldCh, newCh) {
     } else if (!isVNode(newEndVnode)) {
       newEndVnode = newCh[--newEndIdx];
     } else if (isSameVnode(oldStartVnode, newStartVnode)) {
-      patchVnode(oldStartVnode, newStartVnode);
+      patch(oldStartVnode, newStartVnode);
       oldStartVnode = oldCh[++oldStartIdx];
       newStartVnode = newCh[++newStartIdx];
     } else if (isSameVnode(oldEndVnode, newEndVnode)) {
-      patchVnode(oldEndVnode, newEndVnode);
+      patch(oldEndVnode, newEndVnode);
       oldEndVnode = oldCh[--oldEndIdx];
       newEndVnode = newCh[--newEndIdx];
     } else if (isSameVnode(oldStartVnode, newEndVnode)) {
       // Vnode moved right
-      patchVnode(oldStartVnode, newEndVnode);
-      newEndVnode.hook.move(oldStartVnode, parentElm, nextSibling(oldEndVnode.elm));
+      patch(oldStartVnode, newEndVnode);
+      insertNode(oldStartVnode.elm, parent, nextSibling(oldEndVnode.elm));
       oldStartVnode = oldCh[++oldStartIdx];
       newEndVnode = newCh[--newEndIdx];
     } else if (isSameVnode(oldEndVnode, newStartVnode)) {
       // Vnode moved left
-      patchVnode(oldEndVnode, newStartVnode);
-      newStartVnode.hook.move(oldEndVnode, parentElm, oldStartVnode.elm);
+      patch(oldEndVnode, newStartVnode);
+      insertNode(newStartVnode.elm, parent, oldStartVnode.elm);
       oldEndVnode = oldCh[--oldEndIdx];
       newStartVnode = newCh[++newStartIdx];
     } else {
@@ -4494,8 +4595,7 @@ function updateDynamicChildren(parentElm, oldCh, newCh) {
 
       if (isUndefined$1(idxInOld)) {
         // New element
-        newStartVnode.hook.create(newStartVnode);
-        newStartVnode.hook.insert(newStartVnode, parentElm, oldStartVnode.elm);
+        mount(newStartVnode, parent, oldStartVnode.elm);
         newStartVnode = newCh[++newStartIdx];
       } else {
         elmToMove = oldCh[idxInOld];
@@ -4503,10 +4603,9 @@ function updateDynamicChildren(parentElm, oldCh, newCh) {
         if (isVNode(elmToMove)) {
           if (elmToMove.sel !== newStartVnode.sel) {
             // New element
-            newStartVnode.hook.create(newStartVnode);
-            newStartVnode.hook.insert(newStartVnode, parentElm, oldStartVnode.elm);
+            mount(newStartVnode, parent, oldStartVnode.elm);
           } else {
-            patchVnode(elmToMove, newStartVnode); // Delete the old child, but copy the array since it is read-only.
+            patch(elmToMove, newStartVnode); // Delete the old child, but copy the array since it is read-only.
             // The `oldCh` will be GC'ed after `updateDynamicChildren` is complete,
             // so we only care about the `oldCh` object inside this function.
             // To avoid cloning over and over again, we check `clonedOldCh`
@@ -4519,7 +4618,7 @@ function updateDynamicChildren(parentElm, oldCh, newCh) {
 
 
             oldCh[idxInOld] = undefined;
-            newStartVnode.hook.move(elmToMove, parentElm, oldStartVnode.elm);
+            insertNode(elmToMove.elm, parent, oldStartVnode.elm);
           }
         }
 
@@ -4540,66 +4639,56 @@ function updateDynamicChildren(parentElm, oldCh, newCh) {
       } while (!isVNode(n) && i < newChEnd);
 
       before = isVNode(n) ? n.elm : null;
-      addVnodes(parentElm, before, newCh, newStartIdx, newEndIdx);
+      mountVNodes(newCh, parent, before, newStartIdx, newEndIdx + 1);
     } else {
-      removeVnodes(parentElm, oldCh, oldStartIdx, oldEndIdx);
+      unmountVNodes(oldCh, parent, true, oldStartIdx, oldEndIdx + 1);
     }
   }
 }
 
-function updateStaticChildren(parentElm, oldCh, newCh) {
-  const oldChLength = oldCh.length;
-  const newChLength = newCh.length;
+function updateStaticChildren(c1, c2, parent) {
+  const c1Length = c1.length;
+  const c2Length = c2.length;
 
-  if (oldChLength === 0) {
+  if (c1Length === 0) {
     // the old list is empty, we can directly insert anything new
-    addVnodes(parentElm, null, newCh, 0, newChLength);
+    mountVNodes(c2, parent, null);
     return;
   }
 
-  if (newChLength === 0) {
+  if (c2Length === 0) {
     // the old list is nonempty and the new list is empty so we can directly remove all old nodes
     // this is the case in which the dynamic children of an if-directive should be removed
-    removeVnodes(parentElm, oldCh, 0, oldChLength);
+    unmountVNodes(c1, parent, true);
     return;
   } // if the old list is not empty, the new list MUST have the same
   // amount of nodes, that's why we call this static children
 
 
-  let referenceElm = null;
+  let anchor = null;
 
-  for (let i = newChLength - 1; i >= 0; i -= 1) {
-    const vnode = newCh[i];
-    const oldVNode = oldCh[i];
+  for (let i = c2Length - 1; i >= 0; i -= 1) {
+    const n1 = c1[i];
+    const n2 = c2[i];
 
-    if (vnode !== oldVNode) {
-      if (isVNode(oldVNode)) {
-        if (isVNode(vnode)) {
-          // both vnodes must be equivalent, and se just need to patch them
-          patchVnode(oldVNode, vnode);
-          referenceElm = vnode.elm;
+    if (n2 !== n1) {
+      if (isVNode(n1)) {
+        if (isVNode(n2)) {
+          // both vnodes are equivalent, and we just need to patch them
+          patch(n1, n2);
+          anchor = n2.elm;
         } else {
           // removing the old vnode since the new one is null
-          oldVNode.hook.remove(oldVNode, parentElm);
+          unmount(n1, parent, true);
         }
-      } else if (isVNode(vnode)) {
-        // this condition is unnecessary
-        vnode.hook.create(vnode); // insert the new node one since the old one is null
-
-        vnode.hook.insert(vnode, parentElm, referenceElm);
-        referenceElm = vnode.elm;
+      } else if (isVNode(n2)) {
+        mount(n2, parent, anchor);
+        anchor = n2.elm;
       }
     }
   }
 }
 
-function patchVnode(oldVnode, vnode) {
-  if (oldVnode !== vnode) {
-    vnode.elm = oldVnode.elm;
-    vnode.hook.update(oldVnode, vnode);
-  }
-}
-
 /*
  * Copyright (c) 2018, salesforce.com, inc.
  * All rights reserved.
@@ -4649,7 +4738,6 @@ function h(sel, data, children = EmptyArray) {
     children,
     elm,
     key,
-    hook: ElementHook,
     owner: vmBeingRendered
   };
 } // [t]ab[i]ndex function
@@ -4736,7 +4824,7 @@ function c(sel, Ctor, data, children = EmptyArray) {
   const {
     key
   } = data;
-  let elm;
+  let elm, aChildren, vm;
   const vnode = {
     type: 3
     /* CustomElement */
@@ -4746,11 +4834,11 @@ function c(sel, Ctor, data, children = EmptyArray) {
     children,
     elm,
     key,
-    hook: CustomElementHook,
     ctor: Ctor,
     owner: vmBeingRendered,
-    mode: 'open' // TODO [#1294]: this should be defined in Ctor
-
+    mode: 'open',
+    aChildren,
+    vm
   };
   addVNodeToChildLWC(vnode);
   return vnode;
@@ -4880,7 +4968,6 @@ function t(text) {
     text,
     elm,
     key,
-    hook: TextHook,
     owner: getVMBeingRendered()
   };
 } // [co]mment node
@@ -4896,7 +4983,6 @@ function co(text) {
     text,
     elm,
     key,
-    hook: CommentHook,
     owner: getVMBeingRendered()
   };
 } // [d]ynamic text
@@ -5747,6 +5833,10 @@ const signedTemplateMap = new Map();
 function registerComponent(Ctor, {
   tmpl
 }) {
+  if (process.env.NODE_ENV !== 'production') {
+    checkVersionMismatch(Ctor, 'component');
+  }
+
   signedTemplateMap.set(Ctor, tmpl); // chaining this method as a way to wrap existing assignment of component constructor easily,
   // without too much transformation
 
@@ -5863,7 +5953,7 @@ function invokeServiceHook(vm, cbs) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 
-function hydrate$1(vnode, node) {
+function hydrate(vnode, node) {
   switch (vnode.type) {
     case 0
     /* Text */
@@ -5895,16 +5985,18 @@ function hydrateText(vnode, node) {
   var _a;
 
   if (process.env.NODE_ENV !== 'production') {
-    // eslint-disable-next-line lwc-internal/no-global-node
-    validateNodeType(vnode, node, Node.TEXT_NODE);
+    validateNodeType(vnode, node, 3
+    /* TEXT */
+    );
+    const nodeValue = getProperty(node, 'nodeValue');
 
-    if (node.nodeValue !== vnode.text && !(node.nodeValue === '\u200D' && vnode.text === '')) {
+    if (nodeValue !== vnode.text && !(nodeValue === '\u200D' && vnode.text === '')) {
       logWarn('Hydration mismatch: text values do not match, will recover from the difference', vnode.owner);
     }
   } // always set the text value to the one from the vnode.
 
 
-  node.nodeValue = (_a = vnode.text) !== null && _a !== void 0 ? _a : null;
+  setText(node, (_a = vnode.text) !== null && _a !== void 0 ? _a : null);
   vnode.elm = node;
 }
 
@@ -5912,23 +6004,25 @@ function hydrateComment(vnode, node) {
   var _a;
 
   if (process.env.NODE_ENV !== 'production') {
-    // eslint-disable-next-line lwc-internal/no-global-node
-    validateNodeType(vnode, node, Node.COMMENT_NODE);
+    validateNodeType(vnode, node, 8
+    /* COMMENT */
+    );
 
-    if (node.nodeValue !== vnode.text) {
+    if (getProperty(node, 'nodeValue') !== vnode.text) {
       logWarn('Hydration mismatch: comment values do not match, will recover from the difference', vnode.owner);
     }
   } // always set the text value to the one from the vnode.
 
 
-  node.nodeValue = (_a = vnode.text) !== null && _a !== void 0 ? _a : null;
+  setProperty(node, 'nodeValue', (_a = vnode.text) !== null && _a !== void 0 ? _a : null);
   vnode.elm = node;
 }
 
 function hydrateElement(vnode, node) {
   if (process.env.NODE_ENV !== 'production') {
-    // eslint-disable-next-line lwc-internal/no-global-node
-    validateNodeType(vnode, node, Node.ELEMENT_NODE);
+    validateNodeType(vnode, node, 1
+    /* ELEMENT */
+    );
     validateElement(vnode, node);
   }
 
@@ -5949,13 +6043,13 @@ function hydrateElement(vnode, node) {
     } = vnode.data;
 
     if (!isUndefined$1(props) && !isUndefined$1(props.innerHTML)) {
-      if (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 {
-        logWarn(`Mismatch hydrating element <${elm.tagName.toLowerCase()}>: innerHTML values do not match for element, will recover from the difference`, vnode.owner);
+        logWarn(`Mismatch hydrating element <${getProperty(elm, 'tagName').toLowerCase()}>: innerHTML values do not match for element, will recover from the difference`, vnode.owner);
       }
     }
   }
@@ -5963,19 +6057,19 @@ function hydrateElement(vnode, node) {
   patchElementPropsAndAttrs(vnode);
 
   if (!isDomManual) {
-    hydrateChildren(vnode.elm.childNodes, vnode.children, vnode.owner);
+    hydrateChildren(getChildNodes(vnode.elm), vnode.children, vnode.owner);
   }
 }
 
 function hydrateCustomElement(vnode, node) {
   if (process.env.NODE_ENV !== 'production') {
-    // eslint-disable-next-line lwc-internal/no-global-node
-    validateNodeType(vnode, node, Node.ELEMENT_NODE);
+    validateNodeType(vnode, node, 1
+    /* ELEMENT */
+    );
     validateElement(vnode, node);
   }
 
   const elm = node;
-  vnode.elm = elm;
   const {
     sel,
     mode,
@@ -5987,6 +6081,8 @@ function hydrateCustomElement(vnode, node) {
     owner,
     tagName: sel
   });
+  vnode.elm = elm;
+  vnode.vm = vm;
   allocateChildren(vnode, vm);
   patchElementPropsAndAttrs(vnode); // Insert hook section:
 
@@ -6003,7 +6099,7 @@ function hydrateCustomElement(vnode, node) {
   ) {
     // 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(vnode.elm.childNodes, vnode.children, vm);
+    hydrateChildren(getChildNodes(vnode.elm), vnode.children, vm);
   }
 
   hydrateVM(vm);
@@ -6026,7 +6122,7 @@ function hydrateChildren(elmChildren, children, vm) {
 
     if (!isNull(childVnode)) {
       const childNode = elmChildren[childNodeIndex];
-      hydrate$1(childVnode, childNode);
+      hydrate(childVnode, childNode);
       childNodeIndex++;
     }
   }
@@ -6042,15 +6138,15 @@ function throwHydrationError() {
 }
 
 function validateNodeType(vnode, node, nodeType) {
-  if (node.nodeType !== nodeType) {
+  if (getProperty(node, 'nodeType') !== nodeType) {
     logError('Hydration mismatch: incorrect node type received', vnode.owner);
     assert.fail('Hydration mismatch: incorrect node type received.');
   }
 }
 
 function validateElement(vnode, elm) {
-  if (vnode.sel.toLowerCase() !== elm.tagName.toLowerCase()) {
-    logError(`Hydration mismatch: expecting element with tag "${vnode.sel.toLowerCase()}" but found "${elm.tagName.toLowerCase()}".`, vnode.owner);
+  if (vnode.sel.toLowerCase() !== getProperty(elm, 'tagName').toLowerCase()) {
+    logError(`Hydration mismatch: expecting element with tag "${vnode.sel.toLowerCase()}" but found "${getProperty(elm, 'tagName').toLowerCase()}".`, vnode.owner);
     throwHydrationError();
   }
 
@@ -6077,7 +6173,7 @@ function validateAttrs(vnode, elm) {
     const elmAttrValue = getAttribute(elm, attrName);
 
     if (String(attrValue) !== elmAttrValue) {
-      logError(`Mismatch hydrating element <${elm.tagName.toLowerCase()}>: attribute "${attrName}" has different values, expected "${attrValue}" but found "${elmAttrValue}"`, vnode.owner);
+      logError(`Mismatch hydrating element <${getProperty(elm, 'tagName').toLowerCase()}>: attribute "${attrName}" has different values, expected "${attrValue}" but found "${elmAttrValue}"`, vnode.owner);
       nodesAreCompatible = false;
     }
   }
@@ -6095,7 +6191,7 @@ function validateClassAttr(vnode, elm) {
   let nodesAreCompatible = true;
   let vnodeClassName;
 
-  if (!isUndefined$1(className) && String(className) !== elm.className) {
+  if (!isUndefined$1(className) && String(className) !== getProperty(elm, 'className')) {
     // className is used when class is bound to an expr.
     nodesAreCompatible = false;
     vnodeClassName = className;
@@ -6120,7 +6216,7 @@ function validateClassAttr(vnode, elm) {
   }
 
   if (!nodesAreCompatible) {
-    logError(`Mismatch hydrating element <${elm.tagName.toLowerCase()}>: attribute "class" has different values, expected "${vnodeClassName}" but found "${elm.className}"`, vnode.owner);
+    logError(`Mismatch hydrating element <${getProperty(elm, 'tagName').toLowerCase()}>: attribute "class" has different values, expected "${vnodeClassName}" but found "${getProperty(elm, 'className')}"`, vnode.owner);
   }
 
   return nodesAreCompatible;
@@ -6167,7 +6263,7 @@ function validateStyleAttr(vnode, elm) {
 
   if (!nodesAreCompatible) {
     // style is used when class is bound to an expr.
-    logError(`Mismatch hydrating element <${elm.tagName.toLowerCase()}>: attribute "style" has different values, expected "${vnodeStyle}" but found "${elmStyle}".`, vnode.owner);
+    logError(`Mismatch hydrating element <${getProperty(elm, 'tagName').toLowerCase()}>: attribute "style" has different values, expected "${vnodeStyle}" but found "${elmStyle}".`, vnode.owner);
   }
 
   return nodesAreCompatible;
@@ -6231,7 +6327,19 @@ function appendVM(vm) {
   rehydrate(vm);
 }
 function hydrateVM(vm) {
-  hydrate(vm);
+  if (isTrue(vm.isDirty)) {
+    // manually diffing/patching here.
+    // This routine is:
+    // patchShadowRoot(vm, children);
+    //  -> addVnodes.
+    const children = renderComponent(vm);
+    vm.children = children;
+    const vmChildren = vm.renderMode === 0
+    /* Light */
+    ? getChildNodes(vm.elm) : getChildNodes(vm.elm.shadowRoot);
+    hydrateChildren(vmChildren, children, vm);
+    runRenderedCallback(vm);
+  }
 } // just in case the component comes back, with this we guarantee re-rendering it
 // while preventing any attempt to rehydration until after reinsertion.
 
@@ -6381,7 +6489,11 @@ function computeShadowMode(vm) {
       /* Native */
       ;
     } else if (isNativeShadowDefined) {
-      if (def.shadowSupportMode === "any"
+      if (runtimeFlags.DISABLE_MIXED_SHADOW_MODE) {
+        shadowMode = 1
+        /* Synthetic */
+        ;
+      } else if (def.shadowSupportMode === "any"
       /* Any */
       ) {
         shadowMode = 0
@@ -6459,22 +6571,6 @@ function rehydrate(vm) {
   }
 }
 
-function hydrate(vm) {
-  if (isTrue(vm.isDirty)) {
-    // manually diffing/patching here.
-    // This routine is:
-    // patchShadowRoot(vm, children);
-    //  -> addVnodes.
-    const children = renderComponent(vm);
-    vm.children = children;
-    const vmChildren = vm.renderMode === 0
-    /* Light */
-    ? vm.elm.childNodes : vm.elm.shadowRoot.childNodes;
-    hydrateChildren(vmChildren, children, vm);
-    runRenderedCallback(vm);
-  }
-}
-
 function patchShadowRoot(vm, newCh) {
   const {
     renderRoot,
@@ -6494,7 +6590,7 @@ function patchShadowRoot(vm, newCh) {
         , vm);
       }, () => {
         // job
-        patchChildren(renderRoot, oldCh, newCh);
+        patchChildren(oldCh, newCh, renderRoot);
       }, () => {
         // post
         logOperationEnd(2
@@ -7229,4 +7325,4 @@ function setHooks(hooks) {
 }
 
 export { LightningElement, profilerControl as __unstable__ProfilerControl, api$1 as api, connectRootElement, createContextProvider, createVM, disconnectRootElement, getAssociatedVMIfPresent, getComponentDef, getComponentHtmlPrototype, getUpgradableConstructor, hydrateRootElement, isComponentConstructor, readonly, register, registerComponent, registerDecorators, registerTemplate, sanitizeAttribute, setAddEventListener, setAssertInstanceOfHTMLElement, setAttachShadow, setCreateComment, setCreateElement, setCreateText, setDefineCustomElement, setDispatchEvent, setGetAttribute, setGetBoundingClientRect, setGetChildNodes, setGetChildren, setGetClassList, setGetCustomElement, setGetElementsByClassName, setGetElementsByTagName, setGetFirstChild, setGetFirstElementChild, setGetLastChild, setGetLastElementChild, setGetProperty, setHTMLElement, setHooks, setInsert, setInsertGlobalStylesheet, setInsertStylesheet, setIsConnected, setIsHydrating, setIsNativeShadowDefined, setIsSyntheticShadowDefined, setNextSibling, setQuerySelector, setQuerySelectorAll, setRemove, setRemoveAttribute, setRemoveEventListener, setSetAttribute, setSetCSSStyleProperty, setSetProperty, setSetText, setSsr, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };
-/* version: 2.9.0 */
+/* version: 2.10.0 */