@lwc/engine-core 2.13.0 → 2.13.3

package/dist/engine-core.cjs.js

@@ -440,6 +440,20 @@ function logWarn(message, vm) {
     log('warn', message, vm);
 }
 
+/*
+ * Copyright (c) 2020, 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 resolveCircularModuleDependency(fn) {
+    const module = fn();
+    return (module === null || module === void 0 ? void 0 : module.__esModule) ? module.default : module;
+}
+function isCircularModuleDependency(obj) {
+    return shared.isFunction(obj) && shared.hasOwnProperty.call(obj, '__circular__');
+}
+
 /*
  * Copyright (c) 2018, salesforce.com, inc.
  * All rights reserved.
@@ -1805,64 +1819,7 @@ if (process.env.NODE_ENV !== 'production') {
     patchLightningElementPrototypeWithRestrictions(LightningElement.prototype);
 }
 
-/*
- * 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
- */
-/**
- * @wire decorator to wire fields and methods to a wire adapter in
- * LWC Components. This function implements the internals of this
- * decorator.
- */
-function wire(_adapter, _config) {
-    if (process.env.NODE_ENV !== 'production') {
-        shared.assert.fail('@wire(adapter, config?) may only be used as a decorator.');
-    }
-    throw new Error();
-}
-function internalWireFieldDecorator(key) {
-    return {
-        get() {
-            const vm = getAssociatedVM(this);
-            componentValueObserved(vm, key);
-            return vm.cmpFields[key];
-        },
-        set(value) {
-            const vm = getAssociatedVM(this);
-            /**
-             * Reactivity for wired fields is provided in wiring.
-             * We intentionally add reactivity here since this is just
-             * letting the author to do the wrong thing, but it will keep our
-             * system to be backward compatible.
-             */
-            if (value !== vm.cmpFields[key]) {
-                vm.cmpFields[key] = value;
-                componentValueMutated(vm, key);
-            }
-        },
-        enumerable: true,
-        configurable: true,
-    };
-}
-
-/*
- * 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 track(target) {
-    if (arguments.length === 1) {
-        return reactiveMembrane.getProxy(target);
-    }
-    if (process.env.NODE_ENV !== 'production') {
-        shared.assert.fail(`@track decorator can only be used with one argument to return a trackable object, or as a decorator function.`);
-    }
-    throw new Error();
-}
-function internalTrackDecorator(key) {
+function createObservedFieldPropertyDescriptor(key) {
     return {
         get() {
             const vm = getAssociatedVM(this);
@@ -1871,14 +1828,8 @@ function internalTrackDecorator(key) {
         },
         set(newValue) {
             const vm = getAssociatedVM(this);
-            if (process.env.NODE_ENV !== 'production') {
-                const vmBeingRendered = getVMBeingRendered();
-                shared.assert.invariant(!isInvokingRender, `${vmBeingRendered}.render() method has side effects on the state of ${vm}.${shared.toString(key)}`);
-                shared.assert.invariant(!isUpdatingTemplate, `Updating the template of ${vmBeingRendered} has side effects on the state of ${vm}.${shared.toString(key)}`);
-            }
-            const reactiveOrAnyValue = reactiveMembrane.getProxy(newValue);
-            if (reactiveOrAnyValue !== vm.cmpFields[key]) {
-                vm.cmpFields[key] = reactiveOrAnyValue;
+            if (newValue !== vm.cmpFields[key]) {
+                vm.cmpFields[key] = newValue;
                 componentValueMutated(vm, key);
             }
         },
@@ -2042,7 +1993,22 @@ function createPublicAccessorDescriptor(key, descriptor) {
   };
 }
 
-function createObservedFieldPropertyDescriptor(key) {
+/*
+ * 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 track(target) {
+    if (arguments.length === 1) {
+        return reactiveMembrane.getProxy(target);
+    }
+    if (process.env.NODE_ENV !== 'production') {
+        shared.assert.fail(`@track decorator can only be used with one argument to return a trackable object, or as a decorator function.`);
+    }
+    throw new Error();
+}
+function internalTrackDecorator(key) {
     return {
         get() {
             const vm = getAssociatedVM(this);
@@ -2051,8 +2017,56 @@ function createObservedFieldPropertyDescriptor(key) {
         },
         set(newValue) {
             const vm = getAssociatedVM(this);
-            if (newValue !== vm.cmpFields[key]) {
-                vm.cmpFields[key] = newValue;
+            if (process.env.NODE_ENV !== 'production') {
+                const vmBeingRendered = getVMBeingRendered();
+                shared.assert.invariant(!isInvokingRender, `${vmBeingRendered}.render() method has side effects on the state of ${vm}.${shared.toString(key)}`);
+                shared.assert.invariant(!isUpdatingTemplate, `Updating the template of ${vmBeingRendered} has side effects on the state of ${vm}.${shared.toString(key)}`);
+            }
+            const reactiveOrAnyValue = reactiveMembrane.getProxy(newValue);
+            if (reactiveOrAnyValue !== vm.cmpFields[key]) {
+                vm.cmpFields[key] = reactiveOrAnyValue;
+                componentValueMutated(vm, key);
+            }
+        },
+        enumerable: true,
+        configurable: true,
+    };
+}
+
+/*
+ * 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
+ */
+/**
+ * @wire decorator to wire fields and methods to a wire adapter in
+ * LWC Components. This function implements the internals of this
+ * decorator.
+ */
+function wire(_adapter, _config) {
+    if (process.env.NODE_ENV !== 'production') {
+        shared.assert.fail('@wire(adapter, config?) may only be used as a decorator.');
+    }
+    throw new Error();
+}
+function internalWireFieldDecorator(key) {
+    return {
+        get() {
+            const vm = getAssociatedVM(this);
+            componentValueObserved(vm, key);
+            return vm.cmpFields[key];
+        },
+        set(value) {
+            const vm = getAssociatedVM(this);
+            /**
+             * Reactivity for wired fields is provided in wiring.
+             * We intentionally add reactivity here since this is just
+             * letting the author to do the wrong thing, but it will keep our
+             * system to be backward compatible.
+             */
+            if (value !== vm.cmpFields[key]) {
+                vm.cmpFields[key] = value;
                 componentValueMutated(vm, key);
             }
         },
@@ -2307,6 +2321,12 @@ function checkVersionMismatch(func, type) {
     }
 }
 
+/*
+ * 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 [];
@@ -2324,6 +2344,30 @@ function registerTemplate(tpl) {
         checkVersionMismatch(tpl, 'template');
     }
     signedTemplateSet.add(tpl);
+    // FIXME[@W-10950976]: the template object should be frozen, and it should not be possible to set
+    // the stylesheets or stylesheetToken(s). For backwards compat, though, we shim stylesheetTokens
+    // on top of stylesheetToken for anyone who is accessing the old internal API.
+    // Details: https://salesforce.quip.com/v1rmAFu2cKAr
+    shared.defineProperty(tpl, 'stylesheetTokens', {
+        get() {
+            const { stylesheetToken } = this;
+            if (shared.isUndefined(stylesheetToken)) {
+                return stylesheetToken;
+            }
+            // Shim for the old `stylesheetTokens` property
+            // See https://github.com/salesforce/lwc/pull/2332/files#diff-7901555acef29969adaa6583185b3e9bce475cdc6f23e799a54e0018cb18abaa
+            return {
+                hostAttribute: `${stylesheetToken}-host`,
+                shadowAttribute: stylesheetToken,
+            };
+        },
+        set(value) {
+            // If the value is null or some other exotic object, you would be broken anyway in the past
+            // because the engine would try to access hostAttribute/shadowAttribute, which would throw an error.
+            // However it may be undefined in newer versions of LWC, so we need to guard against that case.
+            this.stylesheetToken = shared.isUndefined(value) ? undefined : value.shadowAttribute;
+        },
+    });
     // chaining this method as a way to wrap existing
     // assignment of templates easily, without too much transformation
     return tpl;
@@ -2486,20 +2530,6 @@ const BaseBridgeElement = HTMLBridgeElementFactory(HTMLElementConstructor, share
 shared.freeze(BaseBridgeElement);
 shared.seal(BaseBridgeElement.prototype);
 
-/*
- * Copyright (c) 2020, 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 resolveCircularModuleDependency(fn) {
-    const module = fn();
-    return (module === null || module === void 0 ? void 0 : module.__esModule) ? module.default : module;
-}
-function isCircularModuleDependency(obj) {
-    return shared.isFunction(obj) && shared.hasOwnProperty.call(obj, '__circular__');
-}
-
 /*
  * Copyright (c) 2020, salesforce.com, inc.
  * All rights reserved.
@@ -4892,20 +4922,9 @@ function removeVM(vm) {
 
   resetComponentStateWhenRemoved(vm);
 }
-
-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) {
+  var _a;
+
   const {
     mode,
     owner,
@@ -4933,6 +4952,8 @@ function createVM(elm, ctor, options) {
     oar: shared.create(null),
     cmpTemplate: null,
     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,
@@ -4945,7 +4966,6 @@ 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,
@@ -4954,7 +4974,6 @@ function createVM(elm, ctor, options) {
     setHook,
     getHook
   };
-  vm.shadowMode = computeShadowMode(vm);
   vm.tro = getTemplateReactiveObserver(vm);
 
   if (process.env.NODE_ENV !== 'production') {
@@ -4979,10 +4998,9 @@ function createVM(elm, ctor, options) {
   return vm;
 }
 
-function computeShadowMode(vm) {
-  const {
-    def
-  } = vm;
+function computeShadowMode(def, owner) {
+  var _a;
+
   let shadowMode;
 
   if (isSyntheticShadowDefined) {
@@ -5005,23 +5023,13 @@ function computeShadowMode(vm) {
           /* Native */
           ;
         } else {
-          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 */
-            ;
-          }
+          // 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 */
+          ;
         }
       } else {
         shadowMode = 1
@@ -6111,6 +6119,29 @@ 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
+ */
+/**
+ * EXPERIMENTAL: This function provides access to the component constructor, given an HTMLElement.
+ * This API is subject to change or being removed.
+ */
+function getComponentConstructor(elm) {
+    let ctor = null;
+    // intentionally checking for undefined due to some funky libraries patching weakmap.get
+    // to throw when undefined.
+    if (!shared.isUndefined(elm)) {
+        const vm = getAssociatedVMIfPresent(elm);
+        if (!shared.isUndefined(vm)) {
+            ctor = vm.def.ctor;
+        }
+    }
+    return ctor;
+}
+
 Object.defineProperty(exports, 'setFeatureFlag', {
     enumerable: true,
     get: function () { return features.setFeatureFlag; }
@@ -6127,6 +6158,7 @@ exports.createContextProvider = createContextProvider;
 exports.createVM = createVM;
 exports.disconnectRootElement = disconnectRootElement;
 exports.getAssociatedVMIfPresent = getAssociatedVMIfPresent;
+exports.getComponentConstructor = getComponentConstructor;
 exports.getComponentDef = getComponentDef;
 exports.getComponentHtmlPrototype = getComponentHtmlPrototype;
 exports.getUpgradableConstructor = getUpgradableConstructor;
@@ -6185,4 +6217,4 @@ exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/* version: 2.13.0 */
+/* version: 2.13.3 */

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, 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 } 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, 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';
 
@@ -437,6 +437,20 @@ function logWarn(message, vm) {
     log('warn', message, vm);
 }
 
+/*
+ * Copyright (c) 2020, 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 resolveCircularModuleDependency(fn) {
+    const module = fn();
+    return (module === null || module === void 0 ? void 0 : module.__esModule) ? module.default : module;
+}
+function isCircularModuleDependency(obj) {
+    return isFunction$1(obj) && hasOwnProperty$1.call(obj, '__circular__');
+}
+
 /*
  * Copyright (c) 2018, salesforce.com, inc.
  * All rights reserved.
@@ -1802,64 +1816,7 @@ if (process.env.NODE_ENV !== 'production') {
     patchLightningElementPrototypeWithRestrictions(LightningElement.prototype);
 }
 
-/*
- * 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
- */
-/**
- * @wire decorator to wire fields and methods to a wire adapter in
- * LWC Components. This function implements the internals of this
- * decorator.
- */
-function wire(_adapter, _config) {
-    if (process.env.NODE_ENV !== 'production') {
-        assert.fail('@wire(adapter, config?) may only be used as a decorator.');
-    }
-    throw new Error();
-}
-function internalWireFieldDecorator(key) {
-    return {
-        get() {
-            const vm = getAssociatedVM(this);
-            componentValueObserved(vm, key);
-            return vm.cmpFields[key];
-        },
-        set(value) {
-            const vm = getAssociatedVM(this);
-            /**
-             * Reactivity for wired fields is provided in wiring.
-             * We intentionally add reactivity here since this is just
-             * letting the author to do the wrong thing, but it will keep our
-             * system to be backward compatible.
-             */
-            if (value !== vm.cmpFields[key]) {
-                vm.cmpFields[key] = value;
-                componentValueMutated(vm, key);
-            }
-        },
-        enumerable: true,
-        configurable: true,
-    };
-}
-
-/*
- * 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 track(target) {
-    if (arguments.length === 1) {
-        return reactiveMembrane.getProxy(target);
-    }
-    if (process.env.NODE_ENV !== 'production') {
-        assert.fail(`@track decorator can only be used with one argument to return a trackable object, or as a decorator function.`);
-    }
-    throw new Error();
-}
-function internalTrackDecorator(key) {
+function createObservedFieldPropertyDescriptor(key) {
     return {
         get() {
             const vm = getAssociatedVM(this);
@@ -1868,14 +1825,8 @@ function internalTrackDecorator(key) {
         },
         set(newValue) {
             const vm = getAssociatedVM(this);
-            if (process.env.NODE_ENV !== 'production') {
-                const vmBeingRendered = getVMBeingRendered();
-                assert.invariant(!isInvokingRender, `${vmBeingRendered}.render() method has side effects on the state of ${vm}.${toString$1(key)}`);
-                assert.invariant(!isUpdatingTemplate, `Updating the template of ${vmBeingRendered} has side effects on the state of ${vm}.${toString$1(key)}`);
-            }
-            const reactiveOrAnyValue = reactiveMembrane.getProxy(newValue);
-            if (reactiveOrAnyValue !== vm.cmpFields[key]) {
-                vm.cmpFields[key] = reactiveOrAnyValue;
+            if (newValue !== vm.cmpFields[key]) {
+                vm.cmpFields[key] = newValue;
                 componentValueMutated(vm, key);
             }
         },
@@ -2039,7 +1990,22 @@ function createPublicAccessorDescriptor(key, descriptor) {
   };
 }
 
-function createObservedFieldPropertyDescriptor(key) {
+/*
+ * 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 track(target) {
+    if (arguments.length === 1) {
+        return reactiveMembrane.getProxy(target);
+    }
+    if (process.env.NODE_ENV !== 'production') {
+        assert.fail(`@track decorator can only be used with one argument to return a trackable object, or as a decorator function.`);
+    }
+    throw new Error();
+}
+function internalTrackDecorator(key) {
     return {
         get() {
             const vm = getAssociatedVM(this);
@@ -2048,8 +2014,56 @@ function createObservedFieldPropertyDescriptor(key) {
         },
         set(newValue) {
             const vm = getAssociatedVM(this);
-            if (newValue !== vm.cmpFields[key]) {
-                vm.cmpFields[key] = newValue;
+            if (process.env.NODE_ENV !== 'production') {
+                const vmBeingRendered = getVMBeingRendered();
+                assert.invariant(!isInvokingRender, `${vmBeingRendered}.render() method has side effects on the state of ${vm}.${toString$1(key)}`);
+                assert.invariant(!isUpdatingTemplate, `Updating the template of ${vmBeingRendered} has side effects on the state of ${vm}.${toString$1(key)}`);
+            }
+            const reactiveOrAnyValue = reactiveMembrane.getProxy(newValue);
+            if (reactiveOrAnyValue !== vm.cmpFields[key]) {
+                vm.cmpFields[key] = reactiveOrAnyValue;
+                componentValueMutated(vm, key);
+            }
+        },
+        enumerable: true,
+        configurable: true,
+    };
+}
+
+/*
+ * 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
+ */
+/**
+ * @wire decorator to wire fields and methods to a wire adapter in
+ * LWC Components. This function implements the internals of this
+ * decorator.
+ */
+function wire(_adapter, _config) {
+    if (process.env.NODE_ENV !== 'production') {
+        assert.fail('@wire(adapter, config?) may only be used as a decorator.');
+    }
+    throw new Error();
+}
+function internalWireFieldDecorator(key) {
+    return {
+        get() {
+            const vm = getAssociatedVM(this);
+            componentValueObserved(vm, key);
+            return vm.cmpFields[key];
+        },
+        set(value) {
+            const vm = getAssociatedVM(this);
+            /**
+             * Reactivity for wired fields is provided in wiring.
+             * We intentionally add reactivity here since this is just
+             * letting the author to do the wrong thing, but it will keep our
+             * system to be backward compatible.
+             */
+            if (value !== vm.cmpFields[key]) {
+                vm.cmpFields[key] = value;
                 componentValueMutated(vm, key);
             }
         },
@@ -2304,6 +2318,12 @@ function checkVersionMismatch(func, type) {
     }
 }
 
+/*
+ * 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 [];
@@ -2321,6 +2341,30 @@ function registerTemplate(tpl) {
         checkVersionMismatch(tpl, 'template');
     }
     signedTemplateSet.add(tpl);
+    // FIXME[@W-10950976]: the template object should be frozen, and it should not be possible to set
+    // the stylesheets or stylesheetToken(s). For backwards compat, though, we shim stylesheetTokens
+    // on top of stylesheetToken for anyone who is accessing the old internal API.
+    // Details: https://salesforce.quip.com/v1rmAFu2cKAr
+    defineProperty(tpl, 'stylesheetTokens', {
+        get() {
+            const { stylesheetToken } = this;
+            if (isUndefined$1(stylesheetToken)) {
+                return stylesheetToken;
+            }
+            // Shim for the old `stylesheetTokens` property
+            // See https://github.com/salesforce/lwc/pull/2332/files#diff-7901555acef29969adaa6583185b3e9bce475cdc6f23e799a54e0018cb18abaa
+            return {
+                hostAttribute: `${stylesheetToken}-host`,
+                shadowAttribute: stylesheetToken,
+            };
+        },
+        set(value) {
+            // If the value is null or some other exotic object, you would be broken anyway in the past
+            // because the engine would try to access hostAttribute/shadowAttribute, which would throw an error.
+            // However it may be undefined in newer versions of LWC, so we need to guard against that case.
+            this.stylesheetToken = isUndefined$1(value) ? undefined : value.shadowAttribute;
+        },
+    });
     // chaining this method as a way to wrap existing
     // assignment of templates easily, without too much transformation
     return tpl;
@@ -2483,20 +2527,6 @@ const BaseBridgeElement = HTMLBridgeElementFactory(HTMLElementConstructor, getOw
 freeze(BaseBridgeElement);
 seal(BaseBridgeElement.prototype);
 
-/*
- * Copyright (c) 2020, 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 resolveCircularModuleDependency(fn) {
-    const module = fn();
-    return (module === null || module === void 0 ? void 0 : module.__esModule) ? module.default : module;
-}
-function isCircularModuleDependency(obj) {
-    return isFunction$1(obj) && hasOwnProperty$1.call(obj, '__circular__');
-}
-
 /*
  * Copyright (c) 2020, salesforce.com, inc.
  * All rights reserved.
@@ -4889,20 +4919,9 @@ function removeVM(vm) {
 
   resetComponentStateWhenRemoved(vm);
 }
-
-function getNearestShadowAncestor(vm) {
-  let ancestor = vm.owner;
-
-  while (!isNull(ancestor) && ancestor.renderMode === 0
-  /* Light */
-  ) {
-    ancestor = ancestor.owner;
-  }
-
-  return ancestor;
-}
-
 function createVM(elm, ctor, options) {
+  var _a;
+
   const {
     mode,
     owner,
@@ -4930,6 +4949,8 @@ function createVM(elm, ctor, options) {
     oar: create(null),
     cmpTemplate: null,
     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,
@@ -4942,7 +4963,6 @@ 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,
@@ -4951,7 +4971,6 @@ function createVM(elm, ctor, options) {
     setHook,
     getHook
   };
-  vm.shadowMode = computeShadowMode(vm);
   vm.tro = getTemplateReactiveObserver(vm);
 
   if (process.env.NODE_ENV !== 'production') {
@@ -4976,10 +4995,9 @@ function createVM(elm, ctor, options) {
   return vm;
 }
 
-function computeShadowMode(vm) {
-  const {
-    def
-  } = vm;
+function computeShadowMode(def, owner) {
+  var _a;
+
   let shadowMode;
 
   if (isSyntheticShadowDefined) {
@@ -5002,23 +5020,13 @@ function computeShadowMode(vm) {
           /* Native */
           ;
         } else {
-          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 */
-            ;
-          }
+          // 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 */
+          ;
         }
       } else {
         shadowMode = 1
@@ -6108,5 +6116,28 @@ function setHooks(hooks) {
     setSanitizeHtmlContentHook(hooks.sanitizeHtmlContent);
 }
 
-export { LightningElement, profilerControl as __unstable__ProfilerControl, api$1 as api, connectRootElement, createContextProvider, createVM, disconnectRootElement, getAssociatedVMIfPresent, 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.0 */
+/*
+ * 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
+ */
+/**
+ * EXPERIMENTAL: This function provides access to the component constructor, given an HTMLElement.
+ * This API is subject to change or being removed.
+ */
+function getComponentConstructor(elm) {
+    let ctor = null;
+    // intentionally checking for undefined due to some funky libraries patching weakmap.get
+    // to throw when undefined.
+    if (!isUndefined$1(elm)) {
+        const vm = getAssociatedVMIfPresent(elm);
+        if (!isUndefined$1(vm)) {
+            ctor = vm.def.ctor;
+        }
+    }
+    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 */

package/package.json

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

package/types/framework/component.d.ts

@@ -1,5 +1,5 @@
-import { VM } from './vm';
 import { ReactiveObserver } from '../libs/mutation-tracker';
+import { VM } from './vm';
 import { LightningElementConstructor } from './base-lightning-element';
 import { Template } from './template';
 import { VNodes } from './vnodes';

package/types/framework/def.d.ts

@@ -6,10 +6,10 @@
  * This structure can be used to synthetically create proxies, and understand the
  * shape of a component. It is also used internally to apply extra optimizations.
  */
+import { RenderMode, ShadowSupportMode } from '../framework/vm';
 import { Template } from './template';
 import { LightningElement, LightningElementConstructor } from './base-lightning-element';
 import { PropType } from './decorators/register';
-import { RenderMode, ShadowSupportMode } from '../framework/vm';
 import { HTMLElementConstructor } from './base-bridge-element';
 export interface ComponentDef {
     name: string;

package/types/framework/get-component-constructor.d.ts

@@ -0,0 +1,6 @@
+import { LightningElement } from './base-lightning-element';
+/**
+ * EXPERIMENTAL: This function provides access to the component constructor, given an HTMLElement.
+ * This API is subject to change or being removed.
+ */
+export declare function getComponentConstructor(elm: HTMLElement): typeof LightningElement | null;

package/types/framework/main.d.ts

@@ -19,5 +19,6 @@ 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 { 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';

package/types/framework/vm.d.ts

@@ -1,10 +1,10 @@
-import type { HostNode, HostElement } from '../renderer';
 import { Template } from './template';
 import { ComponentDef } from './def';
 import { LightningElement, LightningElementConstructor } from './base-lightning-element';
 import { ReactiveObserver } from './mutation-tracker';
 import { AccessorReactiveObserver } from './decorators/api';
 import { VNodes, VCustomElement, VNode } from './vnodes';
+import type { HostNode, HostElement } from '../renderer';
 declare type ShadowRootMode = 'open' | 'closed';
 export interface TemplateCache {
     [key: string]: any;
@@ -63,8 +63,11 @@ export interface VM<N = HostNode, E = HostElement> {
     /** The owner VM or null for root elements. */
     readonly owner: VM<N, E> | null;
     /** Rendering operations associated with the VM */
-    renderMode: RenderMode;
+    readonly 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 */