lwc 2.20.4 → 2.22.0

package/dist/engine-dom/iife/es2017/engine-dom.js

@@ -302,9 +302,9 @@ var LWC = (function (exports) {
    * 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.20.4";
+  const LWC_VERSION = "2.22.0";
   const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-  /** version: 2.20.4 */
+  /** version: 2.22.0 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -458,7 +458,7 @@ var LWC = (function (exports) {
           setFeatureFlag(name, value);
       }
   }
-  /** version: 2.20.4 */
+  /** version: 2.22.0 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -690,18 +690,21 @@ var LWC = (function (exports) {
           ArrayPush$1.call(this.listeners, reactiveObservers);
       }
   }
-
-  /*
-   * 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 componentValueMutated(vm, key) {
-      valueMutated(vm.component, key);
+      // On the server side, we don't need mutation tracking. Skipping it improves performance.
+      {
+          valueMutated(vm.component, key);
+      }
   }
   function componentValueObserved(vm, key) {
-      valueObserved(vm.component, key);
+      // On the server side, we don't need mutation tracking. Skipping it improves performance.
+      {
+          valueObserved(vm.component, key);
+      }
+  }
+  function createReactiveObserver(callback) {
+      // On the server side, we don't need mutation tracking. Skipping it improves performance.
+      return new ReactiveObserver(callback) ;
   }
 
   /*
@@ -1823,7 +1826,24 @@ var LWC = (function (exports) {
    * change or being removed.
    */
   function unwrap(value) {
-      return reactiveMembrane.unwrapProxy(value);
+      // On the server side, we don't need mutation tracking. Skipping it improves performance.
+      return reactiveMembrane.unwrapProxy(value) ;
+  }
+  function getReadOnlyProxy(value) {
+      // We must return a frozen wrapper around the value, so that child components cannot mutate properties passed to
+      // them from their parents. This applies to both the client and server.
+      return reactiveMembrane.getReadOnlyProxy(value);
+  }
+  function getReactiveProxy(value) {
+      // On the server side, we don't need mutation tracking. Skipping it improves performance.
+      return reactiveMembrane.getProxy(value) ;
+  }
+  // Making the component instance a live value when using Locker to support expandos.
+  function markLockerLiveObject(obj) {
+      // On the server side, we don't need mutation tracking. Skipping it improves performance.
+      {
+          obj[lockerLivePropertyKey] = undefined;
+      }
   }
 
   /*
@@ -1913,8 +1933,7 @@ var LWC = (function (exports) {
           vm.setHook = setHook;
           vm.getHook = getHook;
       }
-      // Making the component instance a live value when using Locker to support expandos.
-      this[lockerLivePropertyKey] = undefined;
+      markLockerLiveObject(this);
       // Linking elm, shadow root and component with the VM.
       associateVM(component, vm);
       associateVM(elm, vm);
@@ -2183,6 +2202,45 @@ var LWC = (function (exports) {
           configurable: true,
       };
   }
+  class AccessorReactiveObserver extends ReactiveObserver {
+      constructor(vm, set) {
+          super(() => {
+              if (isFalse(this.debouncing)) {
+                  this.debouncing = true;
+                  addCallbackToNextTick(() => {
+                      if (isTrue(this.debouncing)) {
+                          const { value } = this;
+                          const { isDirty: dirtyStateBeforeSetterCall, component, idx } = vm;
+                          set.call(component, value);
+                          // de-bouncing after the call to the original setter to prevent
+                          // infinity loop if the setter itself is mutating things that
+                          // were accessed during the previous invocation.
+                          this.debouncing = false;
+                          if (isTrue(vm.isDirty) && isFalse(dirtyStateBeforeSetterCall) && idx > 0) {
+                              // immediate rehydration due to a setter driven mutation, otherwise
+                              // the component will get rendered on the second tick, which it is not
+                              // desirable.
+                              rerenderVM(vm);
+                          }
+                      }
+                  });
+              }
+          });
+          this.debouncing = false;
+      }
+      reset(value) {
+          super.reset();
+          this.debouncing = false;
+          if (arguments.length > 0) {
+              this.value = value;
+          }
+      }
+  }
+  function createAccessorReactiveObserver(vm, set) {
+      // On the server side, we don't need mutation tracking. Skipping it improves performance.
+      return new AccessorReactiveObserver(vm, set)
+          ;
+  }
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -2231,50 +2289,6 @@ var LWC = (function (exports) {
       configurable: true
     };
   }
-  class AccessorReactiveObserver extends ReactiveObserver {
-    constructor(vm, set) {
-      super(() => {
-        if (isFalse(this.debouncing)) {
-          this.debouncing = true;
-          addCallbackToNextTick(() => {
-            if (isTrue(this.debouncing)) {
-              const {
-                value
-              } = this;
-              const {
-                isDirty: dirtyStateBeforeSetterCall,
-                component,
-                idx
-              } = vm;
-              set.call(component, value); // de-bouncing after the call to the original setter to prevent
-              // infinity loop if the setter itself is mutating things that
-              // were accessed during the previous invocation.
-
-              this.debouncing = false;
-
-              if (isTrue(vm.isDirty) && isFalse(dirtyStateBeforeSetterCall) && idx > 0) {
-                // immediate rehydration due to a setter driven mutation, otherwise
-                // the component will get rendered on the second tick, which it is not
-                // desirable.
-                rerenderVM(vm);
-              }
-            }
-          });
-        }
-      });
-      this.debouncing = false;
-    }
-
-    reset(value) {
-      super.reset();
-      this.debouncing = false;
-
-      if (arguments.length > 0) {
-        this.value = value;
-      }
-    }
-
-  }
   function createPublicAccessorDescriptor(key, descriptor) {
     const {
       get,
@@ -2315,7 +2329,7 @@ var LWC = (function (exports) {
             let ro = vm.oar[key];
 
             if (isUndefined$1(ro)) {
-              ro = vm.oar[key] = new AccessorReactiveObserver(vm, set);
+              ro = vm.oar[key] = createAccessorReactiveObserver(vm, set);
             } // every time we invoke this setter from outside (through this wrapper setter)
             // we should reset the value and then debounce just in case there is a pending
             // invocation the next tick that is not longer relevant since the value is changing
@@ -2347,7 +2361,7 @@ var LWC = (function (exports) {
    */
   function track(target) {
       if (arguments.length === 1) {
-          return reactiveMembrane.getProxy(target);
+          return getReactiveProxy(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.`);
@@ -2368,7 +2382,7 @@ var LWC = (function (exports) {
                   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);
+              const reactiveOrAnyValue = getReactiveProxy(newValue);
               if (reactiveOrAnyValue !== vm.cmpFields[key]) {
                   vm.cmpFields[key] = reactiveOrAnyValue;
                   componentValueMutated(vm, key);
@@ -2760,7 +2774,7 @@ var LWC = (function (exports) {
           fn = cachedSetterByKey[key] = function (newValue) {
               const vm = getAssociatedVM(this);
               const { setHook } = vm;
-              newValue = reactiveMembrane.getReadOnlyProxy(newValue);
+              newValue = getReadOnlyProxy(newValue);
               setHook(vm.component, key, newValue);
           };
       }
@@ -3900,10 +3914,11 @@ var LWC = (function (exports) {
       const { sel, owner, data: { svg }, } = vnode;
       const { createElement } = renderer;
       const namespace = isTrue(svg) ? SVG_NAMESPACE : undefined;
-      const elm = createElement(sel, namespace);
+      const elm = (vnode.elm = createElement(sel, namespace));
       linkNodeToShadow(elm, owner, renderer);
-      fallbackElmHook(elm, vnode, renderer);
-      vnode.elm = elm;
+      applyStyleScoping(elm, owner, renderer);
+      applyDomManual(elm, vnode);
+      applyElementRestrictions(elm, vnode);
       patchElementPropsAndAttrs$1(null, vnode, renderer);
       insertNode(elm, parent, anchor, renderer);
       mountVNodes(vnode.children, elm, renderer, null);
@@ -3918,6 +3933,7 @@ var LWC = (function (exports) {
       const { cloneNode, isSyntheticShadowDefined } = renderer;
       const elm = (vnode.elm = cloneNode(vnode.fragment, true));
       linkNodeToShadow(elm, owner, renderer);
+      applyElementRestrictions(elm, vnode);
       // Marks this node as Static to propagate the shadow resolver. must happen after elm is assigned to the proper shadow
       const { renderMode, shadowMode } = owner;
       if (isSyntheticShadowDefined) {
@@ -3925,10 +3941,6 @@ var LWC = (function (exports) {
               elm[KEY__SHADOW_STATIC] = true;
           }
       }
-      if (process.env.NODE_ENV !== 'production') {
-          const isLight = renderMode === 0 /* RenderMode.Light */;
-          patchElementWithRestrictions(elm, { isPortal: false, isLight });
-      }
       insertNode(elm, parent, anchor, renderer);
   }
   function mountCustomElement(vnode, parent, anchor, renderer) {
@@ -3945,9 +3957,10 @@ var LWC = (function (exports) {
           // the custom element from the registry is expecting an upgrade callback
           vm = createViewModelHook(elm, vnode, renderer);
       });
-      linkNodeToShadow(elm, owner, renderer);
       vnode.elm = elm;
       vnode.vm = vm;
+      linkNodeToShadow(elm, owner, renderer);
+      applyStyleScoping(elm, owner, renderer);
       if (vm) {
           allocateChildren(vnode, vm);
       }
@@ -4031,22 +4044,6 @@ var LWC = (function (exports) {
   function isVNode(vnode) {
       return vnode != null;
   }
-  function observeElementChildNodes(elm) {
-      elm.$domManual$ = true;
-  }
-  function setElementShadowToken(elm, token) {
-      elm.$shadowToken$ = token;
-  }
-  // Set the scope token class for *.scoped.css styles
-  function setScopeTokenClassIfNecessary(elm, owner, renderer) {
-      const token = getScopeTokenClass(owner);
-      if (!isNull(token)) {
-          const { getClassList } = renderer;
-          // TODO [#2762]: this dot notation with add is probably problematic
-          // probably we should have a renderer api for just the add operation
-          getClassList(elm).add(token);
-      }
-  }
   function linkNodeToShadow(elm, owner, renderer) {
       const { renderRoot, renderMode, shadowMode } = owner;
       const { isSyntheticShadowDefined } = renderer;
@@ -4099,31 +4096,37 @@ var LWC = (function (exports) {
       patchAttributes(oldVnode, vnode, renderer);
       patchProps(oldVnode, vnode, renderer);
   }
-  function fallbackElmHook(elm, vnode, renderer) {
-      const { owner } = vnode;
-      setScopeTokenClassIfNecessary(elm, owner, renderer);
-      if (owner.shadowMode === 1 /* ShadowMode.Synthetic */) {
-          const { data: { context }, } = vnode;
-          const { stylesheetToken } = owner.context;
-          if (!isUndefined$1(context) &&
-              !isUndefined$1(context.lwc) &&
-              context.lwc.dom === "manual" /* LwcDomMode.Manual */) {
-              // this element will now accept any manual content inserted into it
-              observeElementChildNodes(elm);
-          }
-          if (!isUndefined$1(stylesheetToken)) {
-              // when running in synthetic shadow mode, we need to set the shadowToken value
-              // into each element from the template, so they can be styled accordingly.
-              setElementShadowToken(elm, stylesheetToken);
-          }
+  function applyStyleScoping(elm, owner, renderer) {
+      // Set the class name for `*.scoped.css` style scoping.
+      const scopeToken = getScopeTokenClass(owner);
+      if (!isNull(scopeToken)) {
+          const { getClassList } = renderer;
+          // TODO [#2762]: this dot notation with add is probably problematic
+          // probably we should have a renderer api for just the add operation
+          getClassList(elm).add(scopeToken);
+      }
+      // Set property element for synthetic shadow DOM style scoping.
+      const { stylesheetToken: syntheticToken } = owner.context;
+      if (owner.shadowMode === 1 /* ShadowMode.Synthetic */ && !isUndefined$1(syntheticToken)) {
+          elm.$shadowToken$ = syntheticToken;
+      }
+  }
+  function applyDomManual(elm, vnode) {
+      var _a;
+      const { owner, data: { context }, } = vnode;
+      if (owner.shadowMode === 1 /* ShadowMode.Synthetic */ && ((_a = context === null || context === void 0 ? void 0 : context.lwc) === null || _a === void 0 ? void 0 : _a.dom) === "manual" /* LwcDomMode.Manual */) {
+          elm.$domManual$ = true;
       }
+  }
+  function applyElementRestrictions(elm, vnode) {
+      var _a, _b;
       if (process.env.NODE_ENV !== 'production') {
-          const { data: { context }, } = vnode;
-          const isPortal = !isUndefined$1(context) &&
-              !isUndefined$1(context.lwc) &&
-              context.lwc.dom === "manual" /* LwcDomMode.Manual */;
-          const isLight = owner.renderMode === 0 /* RenderMode.Light */;
-          patchElementWithRestrictions(elm, { isPortal, isLight });
+          const isPortal = vnode.type === 2 /* VNodeType.Element */ && ((_b = (_a = vnode.data.context) === null || _a === void 0 ? void 0 : _a.lwc) === null || _b === void 0 ? void 0 : _b.dom) === "manual" /* LwcDomMode.Manual */;
+          const isLight = vnode.owner.renderMode === 0 /* RenderMode.Light */;
+          patchElementWithRestrictions(elm, {
+              isPortal,
+              isLight,
+          });
       }
   }
   function allocateChildren(vnode, vm) {
@@ -4158,15 +4161,6 @@ var LWC = (function (exports) {
           return vm;
       }
       const { sel, mode, ctor, owner } = vnode;
-      setScopeTokenClassIfNecessary(elm, owner, renderer);
-      if (owner.shadowMode === 1 /* ShadowMode.Synthetic */) {
-          const { stylesheetToken } = owner.context;
-          // when running in synthetic shadow mode, we need to set the shadowToken value
-          // into each element from the template, so they can be styled accordingly.
-          if (!isUndefined$1(stylesheetToken)) {
-              setElementShadowToken(elm, stylesheetToken);
-          }
-      }
       vm = createVM(elm, ctor, renderer, {
           mode,
           owner,
@@ -5216,7 +5210,7 @@ var LWC = (function (exports) {
       return signedTemplateMap.get(Ctor);
   }
   function getTemplateReactiveObserver(vm) {
-      return new ReactiveObserver(() => {
+      return createReactiveObserver(() => {
           const { isDirty } = vm;
           if (isFalse(isDirty)) {
               markComponentAsDirty(vm);
@@ -6031,7 +6025,7 @@ var LWC = (function (exports) {
   function createConfigWatcher(component, configCallback, callbackWhenConfigIsReady) {
     let hasPendingConfig = false; // creating the reactive observer for reactive params when needed
 
-    const ro = new ReactiveObserver(() => {
+    const ro = createReactiveObserver(() => {
       if (hasPendingConfig === false) {
         hasPendingConfig = true; // collect new config in the micro-task
 
@@ -6327,7 +6321,7 @@ var LWC = (function (exports) {
               assert.fail('@readonly cannot be used as a decorator just yet, use it as a function with one argument to produce a readonly version of the provided value.');
           }
       }
-      return reactiveMembrane.getReadOnlyProxy(obj);
+      return getReadOnlyProxy(obj);
   }
 
   /*
@@ -6838,7 +6832,7 @@ var LWC = (function (exports) {
       }
       return ctor;
   }
-  /* version: 2.20.4 */
+  /* version: 2.22.0 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -6982,6 +6976,69 @@ var LWC = (function (exports) {
       }
   }
 
+  /*
+   * 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 SUPPORTS_TEMPLATE = typeof HTMLTemplateElement === 'function';
+  let createFragment;
+  if (SUPPORTS_TEMPLATE) {
+      // Parse the fragment HTML string into DOM
+      createFragment = function (html) {
+          const template = document.createElement('template');
+          template.innerHTML = html;
+          return template.content.firstChild;
+      };
+  }
+  else {
+      // In browsers that don't support <template> (e.g. IE11), we need to be careful to wrap elements like
+      // <td> in the proper container elements (e.g. <tbody>), because otherwise they will be parsed as null.
+      // Via https://github.com/webcomponents/polyfills/blob/ee1db33/packages/template/template.js#L273-L280
+      // With other elements added from:
+      // https://github.com/sindresorhus/html-tags/blob/95dcdd5/index.js
+      // Using the test:
+      // document.createRange().createContextualFragment(`<${tag}></${tag}>`).firstChild === null
+      // And omitting <html>, <head>, and <body> as these are not practical in an LWC component.
+      const topLevelWrappingMap = {
+          caption: ['table'],
+          col: ['colgroup', 'table'],
+          colgroup: ['table'],
+          option: ['select'],
+          tbody: ['table'],
+          td: ['tr', 'tbody', 'table'],
+          th: ['tr', 'tbody', 'table'],
+          thead: ['table'],
+          tfoot: ['table'],
+          tr: ['tbody', 'table'],
+      };
+      // Via https://github.com/webcomponents/polyfills/blob/ee1db33/packages/template/template.js#L282-L288
+      const getTagName = function (text) {
+          return (/<([a-z][^/\0>\x20\t\r\n\f]+)/i.exec(text) || ['', ''])[1].toLowerCase();
+      };
+      // Via https://github.com/webcomponents/polyfills/blob/ee1db33/packages/template/template.js#L295-L320
+      createFragment = function (html) {
+          const wrapperTags = topLevelWrappingMap[getTagName(html)];
+          if (!isUndefined$1(wrapperTags)) {
+              for (const wrapperTag of wrapperTags) {
+                  html = `<${wrapperTag}>${html}</${wrapperTag}>`;
+              }
+          }
+          // For IE11, the document title must not be undefined, but it can be an empty string
+          // https://developer.mozilla.org/en-US/docs/Web/API/DOMImplementation/createHTMLDocument#browser_compatibility
+          const doc = document.implementation.createHTMLDocument('');
+          doc.body.innerHTML = html;
+          let content = doc.body;
+          if (!isUndefined$1(wrapperTags)) {
+              for (let i = 0; i < wrapperTags.length; i++) {
+                  content = content.firstChild;
+              }
+          }
+          return content.firstChild;
+      };
+  }
+
   /*
    * Copyright (c) 2018, salesforce.com, inc.
    * All rights reserved.
@@ -7060,9 +7117,6 @@ var LWC = (function (exports) {
   function cloneNode(node, deep) {
       return node.cloneNode(deep);
   }
-  function createFragment(html) {
-      return document.createRange().createContextualFragment(html).firstChild;
-  }
   function createElement$1(tagName, namespace) {
       return isUndefined$1(namespace)
           ? document.createElement(tagName)
@@ -7526,7 +7580,7 @@ var LWC = (function (exports) {
   });
   freeze(LightningElement);
   seal(LightningElement.prototype);
-  /* version: 2.20.4 */
+  /* version: 2.22.0 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;