lwc 2.13.1 → 2.13.4

package/dist/engine-server/commonjs/es2017/engine-server.js

@@ -47,7 +47,7 @@ var assert = /*#__PURE__*/Object.freeze({
  */
 const { assign, create, defineProperties, defineProperty, freeze, getOwnPropertyDescriptor: getOwnPropertyDescriptor$1, getOwnPropertyNames: getOwnPropertyNames$1, getPrototypeOf: getPrototypeOf$1, hasOwnProperty: hasOwnProperty$1, isFrozen, keys, seal, setPrototypeOf, } = Object;
 const { isArray: isArray$1 } = Array;
-const { filter: ArrayFilter, find: ArrayFind, indexOf: ArrayIndexOf, join: ArrayJoin, map: ArrayMap, push: ArrayPush$1, reduce: ArrayReduce, reverse: ArrayReverse, slice: ArraySlice, splice: ArraySplice, unshift: ArrayUnshift, forEach, } = Array.prototype;
+const { copyWithin: ArrayCopyWithin, fill: ArrayFill, filter: ArrayFilter, find: ArrayFind, indexOf: ArrayIndexOf, join: ArrayJoin, map: ArrayMap, pop: ArrayPop, push: ArrayPush$1, reduce: ArrayReduce, reverse: ArrayReverse, shift: ArrayShift, slice: ArraySlice, sort: ArraySort, splice: ArraySplice, unshift: ArrayUnshift, forEach, } = Array.prototype;
 const { fromCharCode: StringFromCharCode } = String;
 const { charCodeAt: StringCharCodeAt, replace: StringReplace, slice: StringSlice, toLowerCase: StringToLowerCase, } = String.prototype;
 function isUndefined$1(obj) {
@@ -421,9 +421,9 @@ const XLINK_NAMESPACE = 'http://www.w3.org/1999/xlink';
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 // Increment whenever the LWC template compiler changes
-const LWC_VERSION = "2.13.1";
+const LWC_VERSION = "2.13.4";
 const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-/** version: 2.13.1 */
+/** version: 2.13.4 */
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -468,6 +468,7 @@ if (typeof CustomEvent !== 'function') {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const features = {
+    DUMMY_TEST_FLAG: null,
     ENABLE_ELEMENT_PATCH: null,
     ENABLE_FORCE_NATIVE_SHADOW_MODE_FOR_TEST: null,
     ENABLE_HMR: null,
@@ -531,10 +532,35 @@ function setFeatureFlagForTest(name, value) {
         setFeatureFlag(name, value);
     }
 }
-/** version: 2.13.1 */
+/** version: 2.13.4 */
 
 /* proxy-compat-disable */
 
+/*
+ * 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.
  * All rights reserved.
@@ -608,10 +634,6 @@ let HTMLElementExported$1;
 function setHTMLElement(HTMLElementImpl) {
     HTMLElementExported$1 = HTMLElementImpl;
 }
-let isHydrating$1;
-function setIsHydrating(isHydratingImpl) {
-    isHydrating$1 = isHydratingImpl;
-}
 let insert$1;
 function setInsert(insertImpl) {
     insert$1 = insertImpl;
@@ -732,10 +754,6 @@ let isConnected$1;
 function setIsConnected(isConnectedImpl) {
     isConnected$1 = isConnectedImpl;
 }
-let insertGlobalStylesheet$1;
-function setInsertGlobalStylesheet(insertGlobalStylesheetImpl) {
-    insertGlobalStylesheet$1 = insertGlobalStylesheetImpl;
-}
 let insertStylesheet$1;
 function setInsertStylesheet(insertStylesheetImpl) {
     insertStylesheet$1 = insertStylesheetImpl;
@@ -2820,6 +2838,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 [];
@@ -2837,6 +2861,32 @@ 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', {
+        enumerable: true,
+        configurable: true,
+        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;
@@ -3780,15 +3830,16 @@ 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);
     }
+    const removeChildren = sel === 'slot'; // slot content is removed to trigger slotchange event when removing slot
     switch (type) {
         case 2 /* Element */:
-            unmountVNodes(vnode.children, elm);
+            unmountVNodes(vnode.children, elm, removeChildren);
             break;
         case 3 /* CustomElement */: {
             const { vm } = vnode;
@@ -4706,10 +4757,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$1(stylesheets[i]);
+            insertStylesheet$1(stylesheets[i]);
         }
     }
-    else if (ssr$1 || isHydrating$1()) {
+    else if (ssr$1 || 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.
@@ -4720,15 +4771,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$1(stylesheets[i]);
-            }
-            else {
-                // local level
-                insertStylesheet$1(stylesheets[i], root.shadowRoot);
-            }
+            insertStylesheet$1(stylesheets[i], target);
         }
     }
     return null;
@@ -5236,24 +5282,14 @@ 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,
-    tagName
+    tagName,
+    hydrated
   } = options;
   const def = getComponentInternalDef(ctor);
   const vm = {
@@ -5276,7 +5312,10 @@ 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,
@@ -5289,7 +5328,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,
@@ -5298,7 +5336,6 @@ function createVM(elm, ctor, options) {
     setHook,
     getHook
   };
-  vm.shadowMode = computeShadowMode(vm);
   vm.tro = getTemplateReactiveObserver(vm);
 
   if (process.env.NODE_ENV !== 'production') {
@@ -5323,10 +5360,9 @@ function createVM(elm, ctor, options) {
   return vm;
 }
 
-function computeShadowMode(vm) {
-  const {
-    def
-  } = vm;
+function computeShadowMode(def, owner) {
+  var _a;
+
   let shadowMode;
 
   if (isSyntheticShadowDefined$1) {
@@ -5349,23 +5385,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
@@ -6145,7 +6171,106 @@ function setHooks(hooks) {
     hooksAreSet = true;
     setSanitizeHtmlContentHook(hooks.sanitizeHtmlContent);
 }
-/* version: 2.13.1 */
+
+/*
+ * 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;
+            },
+        });
+    }
+}
+/* version: 2.13.4 */
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -6218,9 +6343,6 @@ class HTMLElementImpl {
     }
 }
 const ssr = true;
-function isHydrating() {
-    return false;
-}
 const isNativeShadowDefined = false;
 const isSyntheticShadowDefined = false;
 function insert(node, parent, anchor) {
@@ -6421,9 +6543,6 @@ function isConnected(node) {
 }
 // Noop on SSR (for now). This need to be reevaluated whenever we will implement support for
 // synthetic shadow.
-const insertGlobalStylesheet = noop;
-// Noop on SSR (for now). This need to be reevaluated whenever we will implement support for
-// synthetic shadow.
 const insertStylesheet = noop;
 // Noop on SSR.
 const addEventListener = noop;
@@ -6479,10 +6598,7 @@ setGetLastElementChild(getLastElementChild);
 setGetProperty(getProperty);
 setHTMLElement(HTMLElementExported);
 setInsert(insert);
-setInsertGlobalStylesheet(insertGlobalStylesheet);
-setInsertStylesheet(insertStylesheet);
 setIsConnected(isConnected);
-setIsHydrating(isHydrating);
 setIsNativeShadowDefined(isNativeShadowDefined);
 setIsSyntheticShadowDefined(isSyntheticShadowDefined);
 setNextSibling(nextSibling);
@@ -6497,6 +6613,7 @@ setSetProperty(setProperty);
 setSetText(setText);
 setSsr(ssr);
 setAddEventListener(addEventListener);
+setInsertStylesheet(insertStylesheet);
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -6612,11 +6729,12 @@ function renderComponent(tagName, Ctor, props = {}) {
  */
 freeze(LightningElement);
 seal(LightningElement.prototype);
-/* version: 2.13.1 */
+/* version: 2.13.4 */
 
 exports.LightningElement = LightningElement;
 exports.api = api$1;
 exports.createContextProvider = createContextProvider;
+exports.freezeTemplate = freezeTemplate;
 exports.getComponentDef = getComponentDef;
 exports.isComponentConstructor = isComponentConstructor;
 exports.readonly = readonly;