lwc 2.13.3 → 2.14.1

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.3";
+const LWC_VERSION = "2.14.1";
 const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-/** version: 2.13.3 */
+/** version: 2.14.1 */
 
 /*
  * 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.3 */
+/** version: 2.14.1 */
 
 /* 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;
@@ -2799,7 +2817,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;
@@ -2848,6 +2867,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)) {
@@ -3810,16 +3831,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
@@ -4736,10 +4761,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.
@@ -4750,15 +4775,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;
@@ -5266,13 +5286,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 = {
@@ -5295,9 +5327,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,
@@ -5310,6 +5341,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,
@@ -5318,6 +5350,7 @@ function createVM(elm, ctor, options) {
     setHook,
     getHook
   };
+  vm.shadowMode = computeShadowMode(vm);
   vm.tro = getTemplateReactiveObserver(vm);
 
   if (process.env.NODE_ENV !== 'production') {
@@ -5342,9 +5375,10 @@ function createVM(elm, ctor, options) {
   return vm;
 }
 
-function computeShadowMode(def, owner) {
-  var _a;
-
+function computeShadowMode(vm) {
+  const {
+    def
+  } = vm;
   let shadowMode;
 
   if (isSyntheticShadowDefined$1) {
@@ -5367,13 +5401,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
@@ -6153,7 +6197,106 @@ function setHooks(hooks) {
     hooksAreSet = true;
     setSanitizeHtmlContentHook(hooks.sanitizeHtmlContent);
 }
-/* version: 2.13.3 */
+
+/*
+ * 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.14.1 */
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -6226,9 +6369,6 @@ class HTMLElementImpl {
     }
 }
 const ssr = true;
-function isHydrating() {
-    return false;
-}
 const isNativeShadowDefined = false;
 const isSyntheticShadowDefined = false;
 function insert(node, parent, anchor) {
@@ -6429,9 +6569,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;
@@ -6487,10 +6624,7 @@ setGetLastElementChild(getLastElementChild);
 setGetProperty(getProperty);
 setHTMLElement(HTMLElementExported);
 setInsert(insert);
-setInsertGlobalStylesheet(insertGlobalStylesheet);
-setInsertStylesheet(insertStylesheet);
 setIsConnected(isConnected);
-setIsHydrating(isHydrating);
 setIsNativeShadowDefined(isNativeShadowDefined);
 setIsSyntheticShadowDefined(isSyntheticShadowDefined);
 setNextSibling(nextSibling);
@@ -6505,6 +6639,7 @@ setSetProperty(setProperty);
 setSetText(setText);
 setSsr(ssr);
 setAddEventListener(addEventListener);
+setInsertStylesheet(insertStylesheet);
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -6620,11 +6755,12 @@ function renderComponent(tagName, Ctor, props = {}) {
  */
 freeze(LightningElement);
 seal(LightningElement.prototype);
-/* version: 2.13.3 */
+/* version: 2.14.1 */
 
 exports.LightningElement = LightningElement;
 exports.api = api$1;
 exports.createContextProvider = createContextProvider;
+exports.freezeTemplate = freezeTemplate;
 exports.getComponentDef = getComponentDef;
 exports.isComponentConstructor = isComponentConstructor;
 exports.readonly = readonly;