@lwc/engine-core 2.13.3 → 2.14.1

package/dist/engine-core.cjs.js

@@ -3,8 +3,33 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var shared = require('@lwc/shared');
 var features = require('@lwc/features');
+var shared = require('@lwc/shared');
+
+/*
+ * 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
+ */
+// @ts-ignore
+
+if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
+  window.addEventListener('test-dummy-flag', () => {
+    let hasFlag = false;
+
+    if (features.runtimeFlags.DUMMY_TEST_FLAG) {
+      hasFlag = true;
+    }
+
+    window.dispatchEvent(new CustomEvent('has-dummy-flag', {
+      detail: {
+        package: '@lwc/engine-core',
+        hasFlag
+      }
+    }));
+  });
+}
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -106,9 +131,7 @@ let HTMLElementExported;
 function setHTMLElement(HTMLElementImpl) {
     HTMLElementExported = HTMLElementImpl;
 }
-let isHydrating;
 function setIsHydrating(isHydratingImpl) {
-    isHydrating = isHydratingImpl;
 }
 let insert;
 function setInsert(insertImpl) {
@@ -230,10 +253,6 @@ let isConnected;
 function setIsConnected(isConnectedImpl) {
     isConnected = isConnectedImpl;
 }
-let insertGlobalStylesheet;
-function setInsertGlobalStylesheet(insertGlobalStylesheetImpl) {
-    insertGlobalStylesheet = insertGlobalStylesheetImpl;
-}
 let insertStylesheet;
 function setInsertStylesheet(insertStylesheetImpl) {
     insertStylesheet = insertStylesheetImpl;
@@ -2300,7 +2319,8 @@ function getDecoratorsMeta(Ctor) {
  * 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
+if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
     // @ts-ignore
     window.__lwcResetWarnedOnVersionMismatch = () => {
         warned = false;
@@ -2349,6 +2369,8 @@ function registerTemplate(tpl) {
     // on top of stylesheetToken for anyone who is accessing the old internal API.
     // Details: https://salesforce.quip.com/v1rmAFu2cKAr
     shared.defineProperty(tpl, 'stylesheetTokens', {
+        enumerable: true,
+        configurable: true,
         get() {
             const { stylesheetToken } = this;
             if (shared.isUndefined(stylesheetToken)) {
@@ -3432,16 +3454,20 @@ function mountVNodes(vnodes, parent, anchor, start = 0, end = vnodes.length) {
     }
 }
 function unmount(vnode, parent, doRemove = false) {
-    const { type, elm } = vnode;
+    const { type, elm, sel } = 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);
+        case 2 /* Element */: {
+            // Slot content is removed to trigger slotchange event when removing slot.
+            // Only required for synthetic shadow.
+            const removeChildren = sel === 'slot' && vnode.owner.shadowMode === 1 /* Synthetic */;
+            unmountVNodes(vnode.children, elm, removeChildren);
             break;
+        }
         case 3 /* CustomElement */: {
             const { vm } = vnode;
             // No need to unmount the children here, `removeVM` will take care of removing the
@@ -4358,10 +4384,10 @@ function createStylesheet(vm, stylesheets) {
     const { renderMode, shadowMode } = vm;
     if (renderMode === 1 /* Shadow */ && shadowMode === 1 /* Synthetic */) {
         for (let i = 0; i < stylesheets.length; i++) {
-            insertGlobalStylesheet(stylesheets[i]);
+            insertStylesheet(stylesheets[i]);
         }
     }
-    else if (ssr || isHydrating()) {
+    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.
@@ -4372,15 +4398,10 @@ function createStylesheet(vm, stylesheets) {
     else {
         // native shadow or light DOM, DOM renderer
         const root = getNearestNativeShadowComponent(vm);
-        const isGlobal = shared.isNull(root);
+        // null root means a global style
+        const target = shared.isNull(root) ? undefined : root.shadowRoot;
         for (let i = 0; i < stylesheets.length; i++) {
-            if (isGlobal) {
-                insertGlobalStylesheet(stylesheets[i]);
-            }
-            else {
-                // local level
-                insertStylesheet(stylesheets[i], root.shadowRoot);
-            }
+            insertStylesheet(stylesheets[i], target);
         }
     }
     return null;
@@ -4922,13 +4943,25 @@ function removeVM(vm) {
 
   resetComponentStateWhenRemoved(vm);
 }
-function createVM(elm, ctor, options) {
-  var _a;
 
+function getNearestShadowAncestor(vm) {
+  let ancestor = vm.owner;
+
+  while (!shared.isNull(ancestor) && ancestor.renderMode === 0
+  /* Light */
+  ) {
+    ancestor = ancestor.owner;
+  }
+
+  return ancestor;
+}
+
+function createVM(elm, ctor, options) {
   const {
     mode,
     owner,
-    tagName
+    tagName,
+    hydrated
   } = options;
   const def = getComponentInternalDef(ctor);
   const vm = {
@@ -4951,9 +4984,8 @@ function createVM(elm, ctor, options) {
     cmpSlots: shared.create(null),
     oar: shared.create(null),
     cmpTemplate: null,
+    hydrated: Boolean(hydrated),
     renderMode: def.renderMode,
-    shadowMode: computeShadowMode(def, owner),
-    nearestShadowMode: (owner === null || owner === void 0 ? void 0 : owner.shadowRoot) ? owner.shadowMode : (_a = owner === null || owner === void 0 ? void 0 : owner.nearestShadowMode) !== null && _a !== void 0 ? _a : null,
     context: {
       stylesheetToken: undefined,
       hasTokenInClass: undefined,
@@ -4966,6 +4998,7 @@ function createVM(elm, ctor, options) {
     },
     // Properties set right after VM creation.
     tro: null,
+    shadowMode: null,
     // Properties set by the LightningElement constructor.
     component: null,
     shadowRoot: null,
@@ -4974,6 +5007,7 @@ function createVM(elm, ctor, options) {
     setHook,
     getHook
   };
+  vm.shadowMode = computeShadowMode(vm);
   vm.tro = getTemplateReactiveObserver(vm);
 
   if (process.env.NODE_ENV !== 'production') {
@@ -4998,9 +5032,10 @@ function createVM(elm, ctor, options) {
   return vm;
 }
 
-function computeShadowMode(def, owner) {
-  var _a;
-
+function computeShadowMode(vm) {
+  const {
+    def
+  } = vm;
   let shadowMode;
 
   if (isSyntheticShadowDefined) {
@@ -5023,13 +5058,23 @@ function computeShadowMode(def, owner) {
           /* Native */
           ;
         } else {
-          // Transitive support for native Shadow DOM. A component in native mode
-          // transitively opts all of its descendants into native.
-          // Synthetic if neither this component nor any of its ancestors are configured
-          // to be native.
-          shadowMode = (_a = owner === null || owner === void 0 ? void 0 : owner.nearestShadowMode) !== null && _a !== void 0 ? _a : 1
-          /* Synthetic */
-          ;
+          const shadowAncestor = getNearestShadowAncestor(vm);
+
+          if (!shared.isNull(shadowAncestor) && shadowAncestor.shadowMode === 0
+          /* Native */
+          ) {
+            // Transitive support for native Shadow DOM. A component in native mode
+            // transitively opts all of its descendants into native.
+            shadowMode = 0
+            /* Native */
+            ;
+          } else {
+            // Synthetic if neither this component nor any of its ancestors are configured
+            // to be native.
+            shadowMode = 1
+            /* Synthetic */
+            ;
+          }
         }
       } else {
         shadowMode = 1
@@ -5925,6 +5970,7 @@ function hydrateCustomElement(elm, vnode) {
         mode,
         owner,
         tagName: sel,
+        hydrated: true,
     });
     vnode.elm = elm;
     vnode.vm = vm;
@@ -6119,6 +6165,105 @@ function setHooks(hooks) {
     setSanitizeHtmlContentHook(hooks.sanitizeHtmlContent);
 }
 
+/*
+ * 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
+ */
+// See @lwc/engine-core/src/framework/template.ts
+const TEMPLATE_PROPS = ['slots', 'stylesheetToken', 'stylesheets', 'renderMode'];
+// Via https://www.npmjs.com/package/object-observer
+const ARRAY_MUTATION_METHODS = [
+    'pop',
+    'push',
+    'shift',
+    'unshift',
+    'reverse',
+    'sort',
+    'fill',
+    'splice',
+    'copyWithin',
+];
+function getOriginalArrayMethod(prop) {
+    switch (prop) {
+        case 'pop':
+            return shared.ArrayPop;
+        case 'push':
+            return shared.ArrayPush;
+        case 'shift':
+            return shared.ArrayShift;
+        case 'unshift':
+            return shared.ArrayUnshift;
+        case 'reverse':
+            return shared.ArrayReverse;
+        case 'sort':
+            return shared.ArraySort;
+        case 'fill':
+            return shared.ArrayFill;
+        case 'splice':
+            return shared.ArraySplice;
+        case 'copyWithin':
+            return shared.ArrayCopyWithin;
+    }
+}
+let mutationWarningsSilenced = false;
+// Warn if the user tries to mutate tmpl.stylesheets, e.g.:
+// `tmpl.stylesheets.push(someStylesheetFunction)`
+function warnOnArrayMutation(stylesheets) {
+    // We can't handle users calling Array.prototype.slice.call(tmpl.stylesheets), but
+    // we can at least warn when they use the most common mutation methods.
+    for (const prop of ARRAY_MUTATION_METHODS) {
+        const originalArrayMethod = getOriginalArrayMethod(prop);
+        stylesheets[prop] = function arrayMutationWarningWrapper() {
+            logError(`Mutating the "stylesheets" array on a template function ` +
+                `is deprecated and may be removed in a future version of LWC.`);
+            // @ts-ignore
+            return originalArrayMethod.apply(this, arguments);
+        };
+    }
+}
+// TODO [#2782]: eventually freezeTemplate() will _actually_ freeze the tmpl object. Today it
+// just warns on mutation.
+function freezeTemplate(tmpl) {
+    if (process.env.NODE_ENV !== 'production') {
+        if (!shared.isUndefined(tmpl.stylesheets)) {
+            warnOnArrayMutation(tmpl.stylesheets);
+        }
+        for (const prop of TEMPLATE_PROPS) {
+            let value = tmpl[prop];
+            shared.defineProperty(tmpl, prop, {
+                enumerable: true,
+                configurable: true,
+                get() {
+                    return value;
+                },
+                set(newValue) {
+                    if (!mutationWarningsSilenced) {
+                        logError(`Dynamically setting the "${prop}" property on a template function ` +
+                            `is deprecated and may be removed in a future version of LWC.`);
+                    }
+                    value = newValue;
+                },
+            });
+        }
+        const originalDescriptor = shared.getOwnPropertyDescriptor(tmpl, 'stylesheetTokens');
+        shared.defineProperty(tmpl, 'stylesheetTokens', {
+            enumerable: true,
+            configurable: true,
+            get: originalDescriptor.get,
+            set(value) {
+                logError(`Dynamically setting the "stylesheetTokens" property on a template function ` +
+                    `is deprecated and may be removed in a future version of LWC.`);
+                // Avoid logging twice (for both stylesheetToken and stylesheetTokens)
+                mutationWarningsSilenced = true;
+                originalDescriptor.set.call(this, value);
+                mutationWarningsSilenced = false;
+            },
+        });
+    }
+}
+
 /*
  * Copyright (c) 2018, salesforce.com, inc.
  * All rights reserved.
@@ -6157,6 +6302,7 @@ exports.connectRootElement = connectRootElement;
 exports.createContextProvider = createContextProvider;
 exports.createVM = createVM;
 exports.disconnectRootElement = disconnectRootElement;
+exports.freezeTemplate = freezeTemplate;
 exports.getAssociatedVMIfPresent = getAssociatedVMIfPresent;
 exports.getComponentConstructor = getComponentConstructor;
 exports.getComponentDef = getComponentDef;
@@ -6194,7 +6340,6 @@ exports.setGetProperty = setGetProperty;
 exports.setHTMLElement = setHTMLElement;
 exports.setHooks = setHooks;
 exports.setInsert = setInsert;
-exports.setInsertGlobalStylesheet = setInsertGlobalStylesheet;
 exports.setInsertStylesheet = setInsertStylesheet;
 exports.setIsConnected = setIsConnected;
 exports.setIsHydrating = setIsHydrating;
@@ -6217,4 +6362,4 @@ exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/* version: 2.13.3 */
+/* version: 2.14.1 */

package/dist/engine-core.js

@@ -1,7 +1,32 @@
 /* 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, hasOwnProperty as hasOwnProperty$1, 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, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, isString, StringSlice, SVG_NAMESPACE, KEY__SHADOW_RESOLVER, isArray as isArray$1, isNumber, StringReplace, KEY__SCOPED_CSS, noop, ArrayUnshift } from '@lwc/shared';
 import { runtimeFlags } from '@lwc/features';
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
+import { seal, create, isFunction as isFunction$1, ArrayPush as ArrayPush$1, isUndefined as isUndefined$1, ArrayIndexOf, ArraySplice, StringToLowerCase, ArrayJoin, isNull, isFrozen, defineProperty, hasOwnProperty as hasOwnProperty$1, 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, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, isString, StringSlice, SVG_NAMESPACE, KEY__SHADOW_RESOLVER, isArray as isArray$1, isNumber, StringReplace, KEY__SCOPED_CSS, noop, ArrayUnshift, ArrayCopyWithin, ArrayFill, ArraySort, ArrayReverse, ArrayShift, ArrayPop } from '@lwc/shared';
+
+/*
+ * 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
+ */
+// @ts-ignore
+
+if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
+  window.addEventListener('test-dummy-flag', () => {
+    let hasFlag = false;
+
+    if (runtimeFlags.DUMMY_TEST_FLAG) {
+      hasFlag = true;
+    }
+
+    window.dispatchEvent(new CustomEvent('has-dummy-flag', {
+      detail: {
+        package: '@lwc/engine-core',
+        hasFlag
+      }
+    }));
+  });
+}
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -103,9 +128,7 @@ let HTMLElementExported;
 function setHTMLElement(HTMLElementImpl) {
     HTMLElementExported = HTMLElementImpl;
 }
-let isHydrating;
 function setIsHydrating(isHydratingImpl) {
-    isHydrating = isHydratingImpl;
 }
 let insert;
 function setInsert(insertImpl) {
@@ -227,10 +250,6 @@ let isConnected;
 function setIsConnected(isConnectedImpl) {
     isConnected = isConnectedImpl;
 }
-let insertGlobalStylesheet;
-function setInsertGlobalStylesheet(insertGlobalStylesheetImpl) {
-    insertGlobalStylesheet = insertGlobalStylesheetImpl;
-}
 let insertStylesheet;
 function setInsertStylesheet(insertStylesheetImpl) {
     insertStylesheet = insertStylesheetImpl;
@@ -2297,7 +2316,8 @@ function getDecoratorsMeta(Ctor) {
  * 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
+if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
     // @ts-ignore
     window.__lwcResetWarnedOnVersionMismatch = () => {
         warned = false;
@@ -2346,6 +2366,8 @@ function registerTemplate(tpl) {
     // on top of stylesheetToken for anyone who is accessing the old internal API.
     // Details: https://salesforce.quip.com/v1rmAFu2cKAr
     defineProperty(tpl, 'stylesheetTokens', {
+        enumerable: true,
+        configurable: true,
         get() {
             const { stylesheetToken } = this;
             if (isUndefined$1(stylesheetToken)) {
@@ -3429,16 +3451,20 @@ function mountVNodes(vnodes, parent, anchor, start = 0, end = vnodes.length) {
     }
 }
 function unmount(vnode, parent, doRemove = false) {
-    const { type, elm } = vnode;
+    const { type, elm, sel } = 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);
+        case 2 /* Element */: {
+            // Slot content is removed to trigger slotchange event when removing slot.
+            // Only required for synthetic shadow.
+            const removeChildren = sel === 'slot' && vnode.owner.shadowMode === 1 /* Synthetic */;
+            unmountVNodes(vnode.children, elm, removeChildren);
             break;
+        }
         case 3 /* CustomElement */: {
             const { vm } = vnode;
             // No need to unmount the children here, `removeVM` will take care of removing the
@@ -4355,10 +4381,10 @@ function createStylesheet(vm, stylesheets) {
     const { renderMode, shadowMode } = vm;
     if (renderMode === 1 /* Shadow */ && shadowMode === 1 /* Synthetic */) {
         for (let i = 0; i < stylesheets.length; i++) {
-            insertGlobalStylesheet(stylesheets[i]);
+            insertStylesheet(stylesheets[i]);
         }
     }
-    else if (ssr || isHydrating()) {
+    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.
@@ -4369,15 +4395,10 @@ function createStylesheet(vm, stylesheets) {
     else {
         // native shadow or light DOM, DOM renderer
         const root = getNearestNativeShadowComponent(vm);
-        const isGlobal = isNull(root);
+        // null root means a global style
+        const target = isNull(root) ? undefined : root.shadowRoot;
         for (let i = 0; i < stylesheets.length; i++) {
-            if (isGlobal) {
-                insertGlobalStylesheet(stylesheets[i]);
-            }
-            else {
-                // local level
-                insertStylesheet(stylesheets[i], root.shadowRoot);
-            }
+            insertStylesheet(stylesheets[i], target);
         }
     }
     return null;
@@ -4919,13 +4940,25 @@ function removeVM(vm) {
 
   resetComponentStateWhenRemoved(vm);
 }
-function createVM(elm, ctor, options) {
-  var _a;
 
+function getNearestShadowAncestor(vm) {
+  let ancestor = vm.owner;
+
+  while (!isNull(ancestor) && ancestor.renderMode === 0
+  /* Light */
+  ) {
+    ancestor = ancestor.owner;
+  }
+
+  return ancestor;
+}
+
+function createVM(elm, ctor, options) {
   const {
     mode,
     owner,
-    tagName
+    tagName,
+    hydrated
   } = options;
   const def = getComponentInternalDef(ctor);
   const vm = {
@@ -4948,9 +4981,8 @@ function createVM(elm, ctor, options) {
     cmpSlots: create(null),
     oar: create(null),
     cmpTemplate: null,
+    hydrated: Boolean(hydrated),
     renderMode: def.renderMode,
-    shadowMode: computeShadowMode(def, owner),
-    nearestShadowMode: (owner === null || owner === void 0 ? void 0 : owner.shadowRoot) ? owner.shadowMode : (_a = owner === null || owner === void 0 ? void 0 : owner.nearestShadowMode) !== null && _a !== void 0 ? _a : null,
     context: {
       stylesheetToken: undefined,
       hasTokenInClass: undefined,
@@ -4963,6 +4995,7 @@ function createVM(elm, ctor, options) {
     },
     // Properties set right after VM creation.
     tro: null,
+    shadowMode: null,
     // Properties set by the LightningElement constructor.
     component: null,
     shadowRoot: null,
@@ -4971,6 +5004,7 @@ function createVM(elm, ctor, options) {
     setHook,
     getHook
   };
+  vm.shadowMode = computeShadowMode(vm);
   vm.tro = getTemplateReactiveObserver(vm);
 
   if (process.env.NODE_ENV !== 'production') {
@@ -4995,9 +5029,10 @@ function createVM(elm, ctor, options) {
   return vm;
 }
 
-function computeShadowMode(def, owner) {
-  var _a;
-
+function computeShadowMode(vm) {
+  const {
+    def
+  } = vm;
   let shadowMode;
 
   if (isSyntheticShadowDefined) {
@@ -5020,13 +5055,23 @@ function computeShadowMode(def, owner) {
           /* Native */
           ;
         } else {
-          // Transitive support for native Shadow DOM. A component in native mode
-          // transitively opts all of its descendants into native.
-          // Synthetic if neither this component nor any of its ancestors are configured
-          // to be native.
-          shadowMode = (_a = owner === null || owner === void 0 ? void 0 : owner.nearestShadowMode) !== null && _a !== void 0 ? _a : 1
-          /* Synthetic */
-          ;
+          const shadowAncestor = getNearestShadowAncestor(vm);
+
+          if (!isNull(shadowAncestor) && shadowAncestor.shadowMode === 0
+          /* Native */
+          ) {
+            // Transitive support for native Shadow DOM. A component in native mode
+            // transitively opts all of its descendants into native.
+            shadowMode = 0
+            /* Native */
+            ;
+          } else {
+            // Synthetic if neither this component nor any of its ancestors are configured
+            // to be native.
+            shadowMode = 1
+            /* Synthetic */
+            ;
+          }
         }
       } else {
         shadowMode = 1
@@ -5922,6 +5967,7 @@ function hydrateCustomElement(elm, vnode) {
         mode,
         owner,
         tagName: sel,
+        hydrated: true,
     });
     vnode.elm = elm;
     vnode.vm = vm;
@@ -6116,6 +6162,105 @@ function setHooks(hooks) {
     setSanitizeHtmlContentHook(hooks.sanitizeHtmlContent);
 }
 
+/*
+ * 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
+ */
+// See @lwc/engine-core/src/framework/template.ts
+const TEMPLATE_PROPS = ['slots', 'stylesheetToken', 'stylesheets', 'renderMode'];
+// Via https://www.npmjs.com/package/object-observer
+const ARRAY_MUTATION_METHODS = [
+    'pop',
+    'push',
+    'shift',
+    'unshift',
+    'reverse',
+    'sort',
+    'fill',
+    'splice',
+    'copyWithin',
+];
+function getOriginalArrayMethod(prop) {
+    switch (prop) {
+        case 'pop':
+            return ArrayPop;
+        case 'push':
+            return ArrayPush$1;
+        case 'shift':
+            return ArrayShift;
+        case 'unshift':
+            return ArrayUnshift;
+        case 'reverse':
+            return ArrayReverse;
+        case 'sort':
+            return ArraySort;
+        case 'fill':
+            return ArrayFill;
+        case 'splice':
+            return ArraySplice;
+        case 'copyWithin':
+            return ArrayCopyWithin;
+    }
+}
+let mutationWarningsSilenced = false;
+// Warn if the user tries to mutate tmpl.stylesheets, e.g.:
+// `tmpl.stylesheets.push(someStylesheetFunction)`
+function warnOnArrayMutation(stylesheets) {
+    // We can't handle users calling Array.prototype.slice.call(tmpl.stylesheets), but
+    // we can at least warn when they use the most common mutation methods.
+    for (const prop of ARRAY_MUTATION_METHODS) {
+        const originalArrayMethod = getOriginalArrayMethod(prop);
+        stylesheets[prop] = function arrayMutationWarningWrapper() {
+            logError(`Mutating the "stylesheets" array on a template function ` +
+                `is deprecated and may be removed in a future version of LWC.`);
+            // @ts-ignore
+            return originalArrayMethod.apply(this, arguments);
+        };
+    }
+}
+// TODO [#2782]: eventually freezeTemplate() will _actually_ freeze the tmpl object. Today it
+// just warns on mutation.
+function freezeTemplate(tmpl) {
+    if (process.env.NODE_ENV !== 'production') {
+        if (!isUndefined$1(tmpl.stylesheets)) {
+            warnOnArrayMutation(tmpl.stylesheets);
+        }
+        for (const prop of TEMPLATE_PROPS) {
+            let value = tmpl[prop];
+            defineProperty(tmpl, prop, {
+                enumerable: true,
+                configurable: true,
+                get() {
+                    return value;
+                },
+                set(newValue) {
+                    if (!mutationWarningsSilenced) {
+                        logError(`Dynamically setting the "${prop}" property on a template function ` +
+                            `is deprecated and may be removed in a future version of LWC.`);
+                    }
+                    value = newValue;
+                },
+            });
+        }
+        const originalDescriptor = getOwnPropertyDescriptor$1(tmpl, 'stylesheetTokens');
+        defineProperty(tmpl, 'stylesheetTokens', {
+            enumerable: true,
+            configurable: true,
+            get: originalDescriptor.get,
+            set(value) {
+                logError(`Dynamically setting the "stylesheetTokens" property on a template function ` +
+                    `is deprecated and may be removed in a future version of LWC.`);
+                // Avoid logging twice (for both stylesheetToken and stylesheetTokens)
+                mutationWarningsSilenced = true;
+                originalDescriptor.set.call(this, value);
+                mutationWarningsSilenced = false;
+            },
+        });
+    }
+}
+
 /*
  * Copyright (c) 2018, salesforce.com, inc.
  * All rights reserved.
@@ -6139,5 +6284,5 @@ function getComponentConstructor(elm) {
     return ctor;
 }
 
-export { LightningElement, profilerControl as __unstable__ProfilerControl, api$1 as api, connectRootElement, createContextProvider, createVM, disconnectRootElement, getAssociatedVMIfPresent, getComponentConstructor, getComponentDef, getComponentHtmlPrototype, getUpgradableConstructor, hydrateRoot, 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.13.3 */
+export { LightningElement, profilerControl as __unstable__ProfilerControl, api$1 as api, connectRootElement, createContextProvider, createVM, disconnectRootElement, freezeTemplate, getAssociatedVMIfPresent, getComponentConstructor, getComponentDef, getComponentHtmlPrototype, getUpgradableConstructor, hydrateRoot, 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, setInsertStylesheet, setIsConnected, setIsHydrating, setIsNativeShadowDefined, setIsSyntheticShadowDefined, setNextSibling, setQuerySelector, setQuerySelectorAll, setRemove, setRemoveAttribute, setRemoveEventListener, setSetAttribute, setSetCSSStyleProperty, setSetProperty, setSetText, setSsr, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };
+/* version: 2.14.1 */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lwc/engine-core",
-    "version": "2.13.3",
+    "version": "2.14.1",
     "description": "Core LWC engine APIs.",
     "homepage": "https://lwc.dev/",
     "repository": {
@@ -25,8 +25,8 @@
         "types/"
     ],
     "dependencies": {
-        "@lwc/features": "2.13.3",
-        "@lwc/shared": "2.13.3"
+        "@lwc/features": "2.14.1",
+        "@lwc/shared": "2.14.1"
     },
     "devDependencies": {
         "observable-membrane": "2.0.0"

package/types/framework/freeze-template.d.ts

@@ -0,0 +1,2 @@
+import { Template } from './template';
+export declare function freezeTemplate(tmpl: Template): void;

package/types/framework/main.d.ts

@@ -19,6 +19,7 @@ export { profilerControl as __unstable__ProfilerControl } from './profiler';
 export { getUpgradableConstructor } from './upgradable-element';
 export { swapTemplate, swapComponent, swapStyle } from './hot-swaps';
 export { setHooks } from './overridable-hooks';
+export { freezeTemplate } from './freeze-template';
 export { getComponentConstructor } from './get-component-constructor';
 export type { ConfigValue as WireConfigValue, ContextValue as WireContextValue, DataCallback, WireAdapter, WireAdapterConstructor, WireAdapterSchemaValue, } from './wiring';
-export { setAssertInstanceOfHTMLElement, setAttachShadow, setCreateComment, setCreateElement, setCreateText, setDefineCustomElement, setDispatchEvent, setGetAttribute, setGetBoundingClientRect, setGetChildNodes, setGetChildren, setGetClassList, setGetCustomElement, setGetElementsByClassName, setGetElementsByTagName, setGetFirstChild, setGetFirstElementChild, setGetLastChild, setGetLastElementChild, setGetProperty, setHTMLElement, setInsert, setInsertGlobalStylesheet, setInsertStylesheet, setIsConnected, setIsHydrating, setIsNativeShadowDefined, setIsSyntheticShadowDefined, setNextSibling, setQuerySelector, setQuerySelectorAll, setRemove, setRemoveAttribute, setRemoveEventListener, setSetAttribute, setSetCSSStyleProperty, setSetProperty, setSetText, setSsr, setAddEventListener, } from '../renderer';
+export { setAssertInstanceOfHTMLElement, setAttachShadow, setCreateComment, setCreateElement, setCreateText, setDefineCustomElement, setDispatchEvent, setGetAttribute, setGetBoundingClientRect, setGetChildNodes, setGetChildren, setGetClassList, setGetCustomElement, setGetElementsByClassName, setGetElementsByTagName, setGetFirstChild, setGetFirstElementChild, setGetLastChild, setGetLastElementChild, setGetProperty, setHTMLElement, setInsert, setIsConnected, setIsHydrating, setIsNativeShadowDefined, setIsSyntheticShadowDefined, setNextSibling, setQuerySelector, setQuerySelectorAll, setRemove, setRemoveAttribute, setRemoveEventListener, setSetAttribute, setSetCSSStyleProperty, setSetProperty, setSetText, setSsr, setAddEventListener, setInsertStylesheet, } from '../renderer';

package/types/framework/vm.d.ts

@@ -62,12 +62,11 @@ export interface VM<N = HostNode, E = HostElement> {
     readonly context: Context;
     /** The owner VM or null for root elements. */
     readonly owner: VM<N, E> | null;
+    /** Whether or not the VM was hydrated */
+    readonly hydrated: boolean;
     /** Rendering operations associated with the VM */
-    readonly renderMode: RenderMode;
+    renderMode: RenderMode;
     shadowMode: ShadowMode;
-    /** Transitive support for native Shadow DOM. A component in native mode
-     * transitively opts all of its descendants into native. */
-    readonly nearestShadowMode: ShadowMode | null;
     /** The component creation index. */
     idx: number;
     /** Component state, analogous to Element.isConnected */
@@ -133,6 +132,7 @@ export declare function createVM<HostNode, HostElement>(elm: HostElement, ctor:
     mode: ShadowRootMode;
     owner: VM<HostNode, HostElement> | null;
     tagName: string;
+    hydrated?: boolean;
 }): VM;
 export declare function associateVM(obj: VMAssociable, vm: VM): void;
 export declare function getAssociatedVM(obj: VMAssociable): VM;

package/types/index.d.ts

@@ -1 +1,2 @@
+import './testFeatureFlag';
 export * from './framework/main';

package/types/renderer.d.ts

@@ -105,10 +105,7 @@ export declare function setGetLastElementChild(getLastElementChildImpl: getLastE
 declare type isConnectedFunc = (node: N) => boolean;
 export declare let isConnected: isConnectedFunc;
 export declare function setIsConnected(isConnectedImpl: isConnectedFunc): void;
-declare type insertGlobalStylesheetFunc = (content: string) => void;
-export declare let insertGlobalStylesheet: insertGlobalStylesheetFunc;
-export declare function setInsertGlobalStylesheet(insertGlobalStylesheetImpl: insertGlobalStylesheetFunc): void;
-declare type insertStylesheetFunc = (content: string, target: ShadowRoot) => void;
+declare type insertStylesheetFunc = (content: string, target?: ShadowRoot) => void;
 export declare let insertStylesheet: insertStylesheetFunc;
 export declare function setInsertStylesheet(insertStylesheetImpl: insertStylesheetFunc): void;
 declare type assertInstanceOfHTMLElementFunc = (elm: any, msg: string) => void;

package/types/testFeatureFlag.d.ts

@@ -0,0 +1 @@
+export {};