@lwc/engine-core 2.5.10 → 2.7.1

package/dist/engine-core.cjs.js

@@ -1428,6 +1428,7 @@ const {
   isArray
 } = Array;
 const {
+  prototype: ObjectDotPrototype,
   getPrototypeOf,
   create: ObjectCreate,
   defineProperty: ObjectDefineProperty,
@@ -2077,8 +2078,6 @@ if (process.env.NODE_ENV !== 'production') {
   init();
 }
 
-const ObjectDotPrototype = Object.prototype;
-
 function defaultValueIsObservable(value) {
   // intentionally checking for null
   if (value === null) {
@@ -2106,99 +2105,85 @@ const defaultValueMutated = (obj, key) => {
   /* do nothing */
 };
 
-const defaultValueDistortion = value => value;
-
 function createShadowTarget(value) {
   return isArray(value) ? [] : {};
 }
 
-class ReactiveMembrane {
-  constructor(options) {
-    this.valueDistortion = defaultValueDistortion;
-    this.valueMutated = defaultValueMutated;
-    this.valueObserved = defaultValueObserved;
-    this.valueIsObservable = defaultValueIsObservable;
+class ObservableMembrane {
+  constructor(options = {}) {
     this.readOnlyObjectGraph = new WeakMap();
     this.reactiveObjectGraph = new WeakMap();
-
-    if (!isUndefined(options)) {
-      const {
-        valueDistortion,
-        valueMutated,
-        valueObserved,
-        valueIsObservable,
-        tagPropertyKey
-      } = options;
-      this.valueDistortion = isFunction(valueDistortion) ? valueDistortion : defaultValueDistortion;
-      this.valueMutated = isFunction(valueMutated) ? valueMutated : defaultValueMutated;
-      this.valueObserved = isFunction(valueObserved) ? valueObserved : defaultValueObserved;
-      this.valueIsObservable = isFunction(valueIsObservable) ? valueIsObservable : defaultValueIsObservable;
-      this.tagPropertyKey = tagPropertyKey;
-    }
+    const {
+      valueMutated,
+      valueObserved,
+      valueIsObservable,
+      tagPropertyKey
+    } = options;
+    this.valueMutated = isFunction(valueMutated) ? valueMutated : defaultValueMutated;
+    this.valueObserved = isFunction(valueObserved) ? valueObserved : defaultValueObserved;
+    this.valueIsObservable = isFunction(valueIsObservable) ? valueIsObservable : defaultValueIsObservable;
+    this.tagPropertyKey = tagPropertyKey;
   }
 
   getProxy(value) {
     const unwrappedValue = unwrap$1(value);
-    const distorted = this.valueDistortion(unwrappedValue);
 
-    if (this.valueIsObservable(distorted)) {
-      if (this.readOnlyObjectGraph.get(distorted) === value) {
-        // when trying to extract the writable version of a readonly
-        // we return the readonly.
+    if (this.valueIsObservable(unwrappedValue)) {
+      // When trying to extract the writable version of a readonly we return the readonly.
+      if (this.readOnlyObjectGraph.get(unwrappedValue) === value) {
         return value;
       }
 
-      return this.getReactiveHandler(unwrappedValue, distorted);
+      return this.getReactiveHandler(unwrappedValue);
     }
 
-    return distorted;
+    return unwrappedValue;
   }
 
   getReadOnlyProxy(value) {
     value = unwrap$1(value);
-    const distorted = this.valueDistortion(value);
 
-    if (this.valueIsObservable(distorted)) {
-      return this.getReadOnlyHandler(value, distorted);
+    if (this.valueIsObservable(value)) {
+      return this.getReadOnlyHandler(value);
     }
 
-    return distorted;
+    return value;
   }
 
   unwrapProxy(p) {
     return unwrap$1(p);
   }
 
-  getReactiveHandler(value, distortedValue) {
-    let proxy = this.reactiveObjectGraph.get(distortedValue);
+  getReactiveHandler(value) {
+    let proxy = this.reactiveObjectGraph.get(value);
 
     if (isUndefined(proxy)) {
       // caching the proxy after the first time it is accessed
-      const handler = new ReactiveProxyHandler(this, distortedValue);
-      proxy = new Proxy(createShadowTarget(distortedValue), handler);
+      const handler = new ReactiveProxyHandler(this, value);
+      proxy = new Proxy(createShadowTarget(value), handler);
       registerProxy(proxy, value);
-      this.reactiveObjectGraph.set(distortedValue, proxy);
+      this.reactiveObjectGraph.set(value, proxy);
     }
 
     return proxy;
   }
 
-  getReadOnlyHandler(value, distortedValue) {
-    let proxy = this.readOnlyObjectGraph.get(distortedValue);
+  getReadOnlyHandler(value) {
+    let proxy = this.readOnlyObjectGraph.get(value);
 
     if (isUndefined(proxy)) {
       // caching the proxy after the first time it is accessed
-      const handler = new ReadOnlyHandler(this, distortedValue);
-      proxy = new Proxy(createShadowTarget(distortedValue), handler);
+      const handler = new ReadOnlyHandler(this, value);
+      proxy = new Proxy(createShadowTarget(value), handler);
       registerProxy(proxy, value);
-      this.readOnlyObjectGraph.set(distortedValue, proxy);
+      this.readOnlyObjectGraph.set(value, proxy);
     }
 
     return proxy;
   }
 
 }
-/** version: 1.1.5 */
+/** version: 2.0.0 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -2207,15 +2192,9 @@ class ReactiveMembrane {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const lockerLivePropertyKey = Symbol.for('@@lockerLiveValue');
-
-function valueDistortion(value) {
-  return value;
-}
-
-const reactiveMembrane = new ReactiveMembrane({
+const reactiveMembrane = new ObservableMembrane({
   valueObserved,
   valueMutated,
-  valueDistortion,
   tagPropertyKey: lockerLivePropertyKey
 });
 /**
@@ -2224,16 +2203,9 @@ const reactiveMembrane = new ReactiveMembrane({
  * change or being removed.
  */
 
-const unwrap = function (value) {
-  const unwrapped = reactiveMembrane.unwrapProxy(value);
-
-  if (unwrapped !== value) {
-    // if value is a proxy, unwrap to access original value and apply distortion
-    return valueDistortion(unwrapped);
-  }
-
-  return value;
-};
+function unwrap(value) {
+  return reactiveMembrane.unwrapProxy(value);
+}
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -3801,10 +3773,6 @@ function createComponentDef(Ctor) {
 
     shared.assert.isTrue(Ctor.constructor, `Missing ${ctorName}.constructor, ${ctorName} should have a "constructor" property.`);
 
-    if (!features.runtimeFlags.ENABLE_MIXED_SHADOW_MODE) {
-      shared.assert.isFalse('shadowSupportMode' in Ctor, `${ctorName || 'Anonymous class'} is an invalid LWC component. The shadowSupportMode static property is not available in this environment.`);
-    }
-
     if (!shared.isUndefined(ctorShadowSupportMode)) {
       shared.assert.invariant(ctorShadowSupportMode === "any"
       /* Any */
@@ -4182,13 +4150,15 @@ function updateElmHook(oldVnode, vnode) {
 }
 function updateChildrenHook(oldVnode, vnode) {
   const {
-    children,
-    owner
+    elm,
+    children
   } = vnode;
-  const fn = hasDynamicChildren(children) ? updateDynamicChildren : updateStaticChildren;
-  runWithBoundaryProtection(owner, owner.owner, shared.noop, () => {
-    fn(vnode.elm, oldVnode.children, children);
-  }, shared.noop);
+
+  if (hasDynamicChildren(children)) {
+    updateDynamicChildren(elm, oldVnode.children, children);
+  } else {
+    updateStaticChildren(elm, oldVnode.children, children);
+  }
 }
 function allocateChildrenHook(vnode, vm) {
   // A component with slots will re-render because:
@@ -5416,6 +5386,7 @@ function updateStylesheetToken(vm, template) {
 
 function evaluateStylesheetsContent(stylesheets, stylesheetToken, vm) {
   const content = [];
+  let root;
 
   for (let i = 0; i < stylesheets.length; i++) {
     let stylesheet = stylesheets[i];
@@ -5428,23 +5399,46 @@ function evaluateStylesheetsContent(stylesheets, stylesheetToken, vm) {
         // the component instance might be attempting to use an old version of
         // the stylesheet, while internally, we have a replacement for it.
         stylesheet = getStyleOrSwappedStyle(stylesheet);
-      } // Use the actual `:host` selector if we're rendering global CSS for light DOM, or if we're rendering
-      // native shadow DOM. Synthetic shadow DOM never uses `:host`.
+      }
 
+      const isScopedCss = stylesheet[shared.KEY__SCOPED_CSS]; // Apply the scope token only if the stylesheet itself is scoped, or if we're rendering synthetic shadow.
+
+      const scopeToken = isScopedCss || vm.shadowMode === 1
+      /* Synthetic */
+      && vm.renderMode === 1
+      /* Shadow */
+      ? stylesheetToken : undefined; // Use the actual `:host` selector if we're rendering global CSS for light DOM, or if we're rendering
+      // native shadow DOM. Synthetic shadow DOM never uses `:host`.
 
-      const isScopedCss = stylesheet[shared.KEY__SCOPED_CSS];
       const useActualHostSelector = vm.renderMode === 0
       /* Light */
       ? !isScopedCss : vm.shadowMode === 0
       /* Native */
-      ; // Apply the scope token only if the stylesheet itself is scoped, or if we're rendering synthetic shadow.
+      ; // Use the native :dir() pseudoclass only in native shadow DOM. Otherwise, in synthetic shadow,
+      // we use an attribute selector on the host to simulate :dir().
 
-      const scopeToken = isScopedCss || vm.shadowMode === 1
-      /* Synthetic */
-      && vm.renderMode === 1
+      let useNativeDirPseudoclass;
+
+      if (vm.renderMode === 1
       /* Shadow */
-      ? stylesheetToken : undefined;
-      shared.ArrayPush.call(content, stylesheet(useActualHostSelector, scopeToken));
+      ) {
+        useNativeDirPseudoclass = vm.shadowMode === 0
+        /* Native */
+        ;
+      } else {
+        // Light DOM components should only render `[dir]` if they're inside of a synthetic shadow root.
+        // At the top level (root is null) or inside of a native shadow root, they should use `:dir()`.
+        if (shared.isUndefined(root)) {
+          // Only calculate the root once as necessary
+          root = getNearestShadowComponent(vm);
+        }
+
+        useNativeDirPseudoclass = shared.isNull(root) || root.shadowMode === 0
+        /* Native */
+        ;
+      }
+
+      shared.ArrayPush.call(content, stylesheet(scopeToken, useActualHostSelector, useNativeDirPseudoclass));
     }
   }
 
@@ -5467,14 +5461,12 @@ function getStylesheetsContent(vm, template) {
 // perf testing has not shown it to be a huge improvement yet:
 // https://github.com/salesforce/lwc/pull/2460#discussion_r691208892
 
-function getNearestNativeShadowComponent(vm) {
+function getNearestShadowComponent(vm) {
   let owner = vm;
 
   while (!shared.isNull(owner)) {
     if (owner.renderMode === 1
     /* Shadow */
-    && owner.shadowMode === 0
-    /* Native */
     ) {
       return owner;
     }
@@ -5485,6 +5477,20 @@ function getNearestNativeShadowComponent(vm) {
   return owner;
 }
 
+function getNearestNativeShadowComponent(vm) {
+  const owner = getNearestShadowComponent(vm);
+
+  if (!shared.isNull(owner) && owner.shadowMode === 1
+  /* Synthetic */
+  ) {
+    // Synthetic-within-native is impossible. So if the nearest shadow component is
+    // synthetic, we know we won't find a native component if we go any further.
+    return null;
+  }
+
+  return owner;
+}
+
 function createStylesheet(vm, stylesheets) {
   const {
     renderer,
@@ -5600,7 +5606,7 @@ function logOperationStart(opId, vm) {
   if (isProfilerEnabled) {
     currentDispatcher(opId, 0
     /* Start */
-    , vm.tagName, vm.idx);
+    , vm.tagName, vm.idx, vm.renderMode, vm.shadowMode);
   }
 }
 function logOperationEnd(opId, vm) {
@@ -5613,7 +5619,7 @@ function logOperationEnd(opId, vm) {
   if (isProfilerEnabled) {
     currentDispatcher(opId, 1
     /* Stop */
-    , vm.tagName, vm.idx);
+    , vm.tagName, vm.idx, vm.renderMode, vm.shadowMode);
   }
 }
 function logGlobalOperationStart(opId, vm) {
@@ -5626,7 +5632,7 @@ function logGlobalOperationStart(opId, vm) {
   if (isProfilerEnabled) {
     currentDispatcher(opId, 0
     /* Start */
-    , vm === null || vm === void 0 ? void 0 : vm.tagName, vm === null || vm === void 0 ? void 0 : vm.idx);
+    , vm === null || vm === void 0 ? void 0 : vm.tagName, vm === null || vm === void 0 ? void 0 : vm.idx, vm === null || vm === void 0 ? void 0 : vm.renderMode, vm === null || vm === void 0 ? void 0 : vm.shadowMode);
   }
 }
 function logGlobalOperationEnd(opId, vm) {
@@ -5639,7 +5645,7 @@ function logGlobalOperationEnd(opId, vm) {
   if (isProfilerEnabled) {
     currentDispatcher(opId, 1
     /* Stop */
-    , vm === null || vm === void 0 ? void 0 : vm.tagName, vm === null || vm === void 0 ? void 0 : vm.idx);
+    , vm === null || vm === void 0 ? void 0 : vm.tagName, vm === null || vm === void 0 ? void 0 : vm.idx, vm === null || vm === void 0 ? void 0 : vm.renderMode, vm === null || vm === void 0 ? void 0 : vm.shadowMode);
   }
 }
 
@@ -5792,6 +5798,7 @@ function evaluateTemplate(vm, html) {
 
   return vnodes;
 }
+
 function computeHasScopedStyles(template) {
   const {
     stylesheets
@@ -7210,4 +7217,4 @@ exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/* version: 2.5.10 */
+/* version: 2.7.1 */

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, assign, assert, keys, StringCharCodeAt, isString, StringSlice, freeze, defineProperties, forEach, getOwnPropertyNames as getOwnPropertyNames$1, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, getPropertyDescriptor, isObject, AriaPropNameToAttrNameMap, defineProperty, KEY__SYNTHETIC_MODE, toString as toString$1, isFalse, isTrue, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, htmlPropertyToAttribute, ArraySlice, hasOwnProperty as hasOwnProperty$1, ArrayFilter, noop, isArray as isArray$1, isNumber, StringReplace, KEY__SHADOW_RESOLVER, KEY__SCOPED_CSS, ArrayUnshift, isFrozen } from '@lwc/shared';
+import { seal, create, isFunction as isFunction$1, ArrayPush as ArrayPush$1, isUndefined as isUndefined$1, ArrayIndexOf, ArraySplice, StringToLowerCase, ArrayJoin, isNull, assign, assert, keys, StringCharCodeAt, isString, StringSlice, freeze, defineProperties, forEach, getOwnPropertyNames as getOwnPropertyNames$1, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, getPropertyDescriptor, isObject, AriaPropNameToAttrNameMap, defineProperty, KEY__SYNTHETIC_MODE, toString as toString$1, isFalse, isTrue, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, htmlPropertyToAttribute, ArraySlice, hasOwnProperty as hasOwnProperty$1, ArrayFilter, isArray as isArray$1, isNumber, StringReplace, KEY__SHADOW_RESOLVER, KEY__SCOPED_CSS, noop, ArrayUnshift, isFrozen } from '@lwc/shared';
 import { runtimeFlags } from '@lwc/features';
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
 
@@ -1425,6 +1425,7 @@ const {
   isArray
 } = Array;
 const {
+  prototype: ObjectDotPrototype,
   getPrototypeOf,
   create: ObjectCreate,
   defineProperty: ObjectDefineProperty,
@@ -2074,8 +2075,6 @@ if (process.env.NODE_ENV !== 'production') {
   init();
 }
 
-const ObjectDotPrototype = Object.prototype;
-
 function defaultValueIsObservable(value) {
   // intentionally checking for null
   if (value === null) {
@@ -2103,99 +2102,85 @@ const defaultValueMutated = (obj, key) => {
   /* do nothing */
 };
 
-const defaultValueDistortion = value => value;
-
 function createShadowTarget(value) {
   return isArray(value) ? [] : {};
 }
 
-class ReactiveMembrane {
-  constructor(options) {
-    this.valueDistortion = defaultValueDistortion;
-    this.valueMutated = defaultValueMutated;
-    this.valueObserved = defaultValueObserved;
-    this.valueIsObservable = defaultValueIsObservable;
+class ObservableMembrane {
+  constructor(options = {}) {
     this.readOnlyObjectGraph = new WeakMap();
     this.reactiveObjectGraph = new WeakMap();
-
-    if (!isUndefined(options)) {
-      const {
-        valueDistortion,
-        valueMutated,
-        valueObserved,
-        valueIsObservable,
-        tagPropertyKey
-      } = options;
-      this.valueDistortion = isFunction(valueDistortion) ? valueDistortion : defaultValueDistortion;
-      this.valueMutated = isFunction(valueMutated) ? valueMutated : defaultValueMutated;
-      this.valueObserved = isFunction(valueObserved) ? valueObserved : defaultValueObserved;
-      this.valueIsObservable = isFunction(valueIsObservable) ? valueIsObservable : defaultValueIsObservable;
-      this.tagPropertyKey = tagPropertyKey;
-    }
+    const {
+      valueMutated,
+      valueObserved,
+      valueIsObservable,
+      tagPropertyKey
+    } = options;
+    this.valueMutated = isFunction(valueMutated) ? valueMutated : defaultValueMutated;
+    this.valueObserved = isFunction(valueObserved) ? valueObserved : defaultValueObserved;
+    this.valueIsObservable = isFunction(valueIsObservable) ? valueIsObservable : defaultValueIsObservable;
+    this.tagPropertyKey = tagPropertyKey;
   }
 
   getProxy(value) {
     const unwrappedValue = unwrap$1(value);
-    const distorted = this.valueDistortion(unwrappedValue);
 
-    if (this.valueIsObservable(distorted)) {
-      if (this.readOnlyObjectGraph.get(distorted) === value) {
-        // when trying to extract the writable version of a readonly
-        // we return the readonly.
+    if (this.valueIsObservable(unwrappedValue)) {
+      // When trying to extract the writable version of a readonly we return the readonly.
+      if (this.readOnlyObjectGraph.get(unwrappedValue) === value) {
         return value;
       }
 
-      return this.getReactiveHandler(unwrappedValue, distorted);
+      return this.getReactiveHandler(unwrappedValue);
     }
 
-    return distorted;
+    return unwrappedValue;
   }
 
   getReadOnlyProxy(value) {
     value = unwrap$1(value);
-    const distorted = this.valueDistortion(value);
 
-    if (this.valueIsObservable(distorted)) {
-      return this.getReadOnlyHandler(value, distorted);
+    if (this.valueIsObservable(value)) {
+      return this.getReadOnlyHandler(value);
     }
 
-    return distorted;
+    return value;
   }
 
   unwrapProxy(p) {
     return unwrap$1(p);
   }
 
-  getReactiveHandler(value, distortedValue) {
-    let proxy = this.reactiveObjectGraph.get(distortedValue);
+  getReactiveHandler(value) {
+    let proxy = this.reactiveObjectGraph.get(value);
 
     if (isUndefined(proxy)) {
       // caching the proxy after the first time it is accessed
-      const handler = new ReactiveProxyHandler(this, distortedValue);
-      proxy = new Proxy(createShadowTarget(distortedValue), handler);
+      const handler = new ReactiveProxyHandler(this, value);
+      proxy = new Proxy(createShadowTarget(value), handler);
       registerProxy(proxy, value);
-      this.reactiveObjectGraph.set(distortedValue, proxy);
+      this.reactiveObjectGraph.set(value, proxy);
     }
 
     return proxy;
   }
 
-  getReadOnlyHandler(value, distortedValue) {
-    let proxy = this.readOnlyObjectGraph.get(distortedValue);
+  getReadOnlyHandler(value) {
+    let proxy = this.readOnlyObjectGraph.get(value);
 
     if (isUndefined(proxy)) {
       // caching the proxy after the first time it is accessed
-      const handler = new ReadOnlyHandler(this, distortedValue);
-      proxy = new Proxy(createShadowTarget(distortedValue), handler);
+      const handler = new ReadOnlyHandler(this, value);
+      proxy = new Proxy(createShadowTarget(value), handler);
       registerProxy(proxy, value);
-      this.readOnlyObjectGraph.set(distortedValue, proxy);
+      this.readOnlyObjectGraph.set(value, proxy);
     }
 
     return proxy;
   }
 
 }
-/** version: 1.1.5 */
+/** version: 2.0.0 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -2204,15 +2189,9 @@ class ReactiveMembrane {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const lockerLivePropertyKey = Symbol.for('@@lockerLiveValue');
-
-function valueDistortion(value) {
-  return value;
-}
-
-const reactiveMembrane = new ReactiveMembrane({
+const reactiveMembrane = new ObservableMembrane({
   valueObserved,
   valueMutated,
-  valueDistortion,
   tagPropertyKey: lockerLivePropertyKey
 });
 /**
@@ -2221,16 +2200,9 @@ const reactiveMembrane = new ReactiveMembrane({
  * change or being removed.
  */
 
-const unwrap = function (value) {
-  const unwrapped = reactiveMembrane.unwrapProxy(value);
-
-  if (unwrapped !== value) {
-    // if value is a proxy, unwrap to access original value and apply distortion
-    return valueDistortion(unwrapped);
-  }
-
-  return value;
-};
+function unwrap(value) {
+  return reactiveMembrane.unwrapProxy(value);
+}
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -3798,10 +3770,6 @@ function createComponentDef(Ctor) {
 
     assert.isTrue(Ctor.constructor, `Missing ${ctorName}.constructor, ${ctorName} should have a "constructor" property.`);
 
-    if (!runtimeFlags.ENABLE_MIXED_SHADOW_MODE) {
-      assert.isFalse('shadowSupportMode' in Ctor, `${ctorName || 'Anonymous class'} is an invalid LWC component. The shadowSupportMode static property is not available in this environment.`);
-    }
-
     if (!isUndefined$1(ctorShadowSupportMode)) {
       assert.invariant(ctorShadowSupportMode === "any"
       /* Any */
@@ -4179,13 +4147,15 @@ function updateElmHook(oldVnode, vnode) {
 }
 function updateChildrenHook(oldVnode, vnode) {
   const {
-    children,
-    owner
+    elm,
+    children
   } = vnode;
-  const fn = hasDynamicChildren(children) ? updateDynamicChildren : updateStaticChildren;
-  runWithBoundaryProtection(owner, owner.owner, noop, () => {
-    fn(vnode.elm, oldVnode.children, children);
-  }, noop);
+
+  if (hasDynamicChildren(children)) {
+    updateDynamicChildren(elm, oldVnode.children, children);
+  } else {
+    updateStaticChildren(elm, oldVnode.children, children);
+  }
 }
 function allocateChildrenHook(vnode, vm) {
   // A component with slots will re-render because:
@@ -5413,6 +5383,7 @@ function updateStylesheetToken(vm, template) {
 
 function evaluateStylesheetsContent(stylesheets, stylesheetToken, vm) {
   const content = [];
+  let root;
 
   for (let i = 0; i < stylesheets.length; i++) {
     let stylesheet = stylesheets[i];
@@ -5425,23 +5396,46 @@ function evaluateStylesheetsContent(stylesheets, stylesheetToken, vm) {
         // the component instance might be attempting to use an old version of
         // the stylesheet, while internally, we have a replacement for it.
         stylesheet = getStyleOrSwappedStyle(stylesheet);
-      } // Use the actual `:host` selector if we're rendering global CSS for light DOM, or if we're rendering
-      // native shadow DOM. Synthetic shadow DOM never uses `:host`.
+      }
 
+      const isScopedCss = stylesheet[KEY__SCOPED_CSS]; // Apply the scope token only if the stylesheet itself is scoped, or if we're rendering synthetic shadow.
+
+      const scopeToken = isScopedCss || vm.shadowMode === 1
+      /* Synthetic */
+      && vm.renderMode === 1
+      /* Shadow */
+      ? stylesheetToken : undefined; // Use the actual `:host` selector if we're rendering global CSS for light DOM, or if we're rendering
+      // native shadow DOM. Synthetic shadow DOM never uses `:host`.
 
-      const isScopedCss = stylesheet[KEY__SCOPED_CSS];
       const useActualHostSelector = vm.renderMode === 0
       /* Light */
       ? !isScopedCss : vm.shadowMode === 0
       /* Native */
-      ; // Apply the scope token only if the stylesheet itself is scoped, or if we're rendering synthetic shadow.
+      ; // Use the native :dir() pseudoclass only in native shadow DOM. Otherwise, in synthetic shadow,
+      // we use an attribute selector on the host to simulate :dir().
 
-      const scopeToken = isScopedCss || vm.shadowMode === 1
-      /* Synthetic */
-      && vm.renderMode === 1
+      let useNativeDirPseudoclass;
+
+      if (vm.renderMode === 1
       /* Shadow */
-      ? stylesheetToken : undefined;
-      ArrayPush$1.call(content, stylesheet(useActualHostSelector, scopeToken));
+      ) {
+        useNativeDirPseudoclass = vm.shadowMode === 0
+        /* Native */
+        ;
+      } else {
+        // Light DOM components should only render `[dir]` if they're inside of a synthetic shadow root.
+        // At the top level (root is null) or inside of a native shadow root, they should use `:dir()`.
+        if (isUndefined$1(root)) {
+          // Only calculate the root once as necessary
+          root = getNearestShadowComponent(vm);
+        }
+
+        useNativeDirPseudoclass = isNull(root) || root.shadowMode === 0
+        /* Native */
+        ;
+      }
+
+      ArrayPush$1.call(content, stylesheet(scopeToken, useActualHostSelector, useNativeDirPseudoclass));
     }
   }
 
@@ -5464,14 +5458,12 @@ function getStylesheetsContent(vm, template) {
 // perf testing has not shown it to be a huge improvement yet:
 // https://github.com/salesforce/lwc/pull/2460#discussion_r691208892
 
-function getNearestNativeShadowComponent(vm) {
+function getNearestShadowComponent(vm) {
   let owner = vm;
 
   while (!isNull(owner)) {
     if (owner.renderMode === 1
     /* Shadow */
-    && owner.shadowMode === 0
-    /* Native */
     ) {
       return owner;
     }
@@ -5482,6 +5474,20 @@ function getNearestNativeShadowComponent(vm) {
   return owner;
 }
 
+function getNearestNativeShadowComponent(vm) {
+  const owner = getNearestShadowComponent(vm);
+
+  if (!isNull(owner) && owner.shadowMode === 1
+  /* Synthetic */
+  ) {
+    // Synthetic-within-native is impossible. So if the nearest shadow component is
+    // synthetic, we know we won't find a native component if we go any further.
+    return null;
+  }
+
+  return owner;
+}
+
 function createStylesheet(vm, stylesheets) {
   const {
     renderer,
@@ -5597,7 +5603,7 @@ function logOperationStart(opId, vm) {
   if (isProfilerEnabled) {
     currentDispatcher(opId, 0
     /* Start */
-    , vm.tagName, vm.idx);
+    , vm.tagName, vm.idx, vm.renderMode, vm.shadowMode);
   }
 }
 function logOperationEnd(opId, vm) {
@@ -5610,7 +5616,7 @@ function logOperationEnd(opId, vm) {
   if (isProfilerEnabled) {
     currentDispatcher(opId, 1
     /* Stop */
-    , vm.tagName, vm.idx);
+    , vm.tagName, vm.idx, vm.renderMode, vm.shadowMode);
   }
 }
 function logGlobalOperationStart(opId, vm) {
@@ -5623,7 +5629,7 @@ function logGlobalOperationStart(opId, vm) {
   if (isProfilerEnabled) {
     currentDispatcher(opId, 0
     /* Start */
-    , vm === null || vm === void 0 ? void 0 : vm.tagName, vm === null || vm === void 0 ? void 0 : vm.idx);
+    , vm === null || vm === void 0 ? void 0 : vm.tagName, vm === null || vm === void 0 ? void 0 : vm.idx, vm === null || vm === void 0 ? void 0 : vm.renderMode, vm === null || vm === void 0 ? void 0 : vm.shadowMode);
   }
 }
 function logGlobalOperationEnd(opId, vm) {
@@ -5636,7 +5642,7 @@ function logGlobalOperationEnd(opId, vm) {
   if (isProfilerEnabled) {
     currentDispatcher(opId, 1
     /* Stop */
-    , vm === null || vm === void 0 ? void 0 : vm.tagName, vm === null || vm === void 0 ? void 0 : vm.idx);
+    , vm === null || vm === void 0 ? void 0 : vm.tagName, vm === null || vm === void 0 ? void 0 : vm.idx, vm === null || vm === void 0 ? void 0 : vm.renderMode, vm === null || vm === void 0 ? void 0 : vm.shadowMode);
   }
 }
 
@@ -5789,6 +5795,7 @@ function evaluateTemplate(vm, html) {
 
   return vnodes;
 }
+
 function computeHasScopedStyles(template) {
   const {
     stylesheets
@@ -7174,4 +7181,4 @@ function setHooks(hooks) {
 }
 
 export { LightningElement, profilerControl as __unstable__ProfilerControl, api$1 as api, connectRootElement, createContextProvider, createVM, disconnectRootElement, getAssociatedVMIfPresent, getComponentDef, getComponentInternalDef, getUpgradableConstructor, hydrateRootElement, isComponentConstructor, readonly, register, registerComponent, registerDecorators, registerTemplate, sanitizeAttribute, setHooks, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };
-/* version: 2.5.10 */
+/* version: 2.7.1 */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lwc/engine-core",
-    "version": "2.5.10",
+    "version": "2.7.1",
     "description": "Core LWC engine APIs.",
     "homepage": "https://lwc.dev/",
     "repository": {
@@ -24,14 +24,14 @@
         "types/"
     ],
     "dependencies": {
-        "@lwc/features": "2.5.10",
-        "@lwc/shared": "2.5.10"
+        "@lwc/features": "2.7.1",
+        "@lwc/shared": "2.7.1"
     },
     "devDependencies": {
-        "observable-membrane": "1.1.5"
+        "observable-membrane": "2.0.0"
     },
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "44a0ea56fa42bf411aa91514e958f386e3a1d191"
+    "gitHead": "1b2e246e03c6bfbc80bea3def43b7d0281a1de21"
 }

package/types/3rdparty/snabbdom/types.d.ts

@@ -7,13 +7,6 @@
  https://github.com/snabbdom/snabbdom/
  */
 import { VM } from '../../framework/vm';
-export declare type VNodeStyleDecls = Array<[string, string, boolean]>;
-export interface On {
-    [event: string]: EventListener;
-}
-export declare type Attrs = Record<string, string | number | boolean>;
-export declare type Classes = Record<string, boolean>;
-export declare type Props = Record<string, any>;
 export declare type Key = string | number;
 export declare type VNodes = Array<VNode | null>;
 export interface VNode {
@@ -53,16 +46,15 @@ export interface VComment extends VNode {
     text: string;
     key: undefined;
 }
-export declare type CustomElementContext = Record<string, Record<string, any>>;
 export interface VNodeData {
-    props?: Props;
-    attrs?: Attrs;
-    className?: any;
-    style?: any;
-    classMap?: Classes;
-    styleDecls?: VNodeStyleDecls;
-    context?: CustomElementContext;
-    on?: On;
+    props?: Record<string, any>;
+    attrs?: Record<string, string | number | boolean>;
+    className?: string;
+    style?: string;
+    classMap?: Record<string, boolean>;
+    styleDecls?: Array<[string, string, boolean]>;
+    context?: Record<string, Record<string, any>>;
+    on?: Record<string, Function>;
     svg?: boolean;
 }
 export interface VElementData extends VNodeData {
@@ -76,7 +68,3 @@ export interface Hooks<N extends VNode> {
     remove: (vNode: N, parentNode: Node) => void;
     hydrate: (vNode: N, node: Node) => void;
 }
-export interface Module<N extends VNode> {
-    create?: (vNode: N) => void;
-    update?: (oldVNode: N, vNode: N) => void;
-}

package/types/framework/membrane.d.ts

@@ -1,4 +1,4 @@
-import ObservableMembrane from 'observable-membrane';
+import { ObservableMembrane } from 'observable-membrane';
 export declare const lockerLivePropertyKey: unique symbol;
 export declare const reactiveMembrane: ObservableMembrane;
 /**
@@ -6,4 +6,4 @@ export declare const reactiveMembrane: ObservableMembrane;
  * works for observable membrane objects. This API is subject to
  * change or being removed.
  */
-export declare const unwrap: (value: any) => any;
+export declare function unwrap(value: any): any;

package/types/framework/profiler.d.ts

@@ -1,4 +1,4 @@
-import { VM } from './vm';
+import { RenderMode, ShadowMode, VM } from './vm';
 export declare const enum OperationId {
     Constructor = 0,
     Render = 1,
@@ -15,7 +15,7 @@ declare const enum Phase {
     Start = 0,
     Stop = 1
 }
-declare type LogDispatcher = (opId: OperationId, phase: Phase, cmpName?: string, vmIndex?: number) => void;
+declare type LogDispatcher = (opId: OperationId, phase: Phase, cmpName?: string, vmIndex?: number, renderMode?: RenderMode, shadowMode?: ShadowMode) => void;
 export declare const profilerControl: {
     enableProfiler(): void;
     disableProfiler(): void;

package/types/framework/stylesheet.d.ts

@@ -5,7 +5,7 @@ import { Template } from './template';
  * Function producing style based on a host and a shadow selector. This function is invoked by
  * the engine with different values depending on the mode that the component is running on.
  */
-export declare type StylesheetFactory = (useActualHostSelector: boolean, stylesheetToken: string | undefined) => string;
+export declare type StylesheetFactory = (stylesheetToken: string | undefined, useActualHostSelector: boolean, useNativeDirPseudoclass: boolean) => string;
 /**
  * The list of stylesheets associated with a template. Each entry is either a StylesheetFactory or a
  * TemplateStylesheetFactory a given stylesheet depends on other external stylesheets (via the

package/types/framework/template.d.ts

@@ -17,4 +17,3 @@ export declare let isUpdatingTemplate: boolean;
 export declare function getVMBeingRendered(): VM | null;
 export declare function setVMBeingRendered(vm: VM | null): void;
 export declare function evaluateTemplate(vm: VM, html: Template): Array<VNode | null>;
-export declare function computeHasScopedStyles(template: Template): boolean;