lwc 2.21.1 → 2.22.0

package/dist/engine-dom/umd/es5/engine-dom.js

@@ -368,9 +368,9 @@
   // Increment whenever the LWC template compiler changes
 
 
-  var LWC_VERSION = "2.21.1";
+  var LWC_VERSION = "2.22.0";
   var LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-  /** version: 2.21.1 */
+  /** version: 2.22.0 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -549,7 +549,7 @@
       setFeatureFlag(name, value);
     }
   }
-  /** version: 2.21.1 */
+  /** version: 2.22.0 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -855,20 +855,24 @@
 
     return ReactiveObserver;
   }();
-  /*
-   * 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);
   }
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -2283,8 +2287,28 @@
    */
 
   function unwrap(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;
+    }
+  }
   /*
    * Copyright (c) 2018, salesforce.com, inc.
    * All rights reserved.
@@ -2399,10 +2423,9 @@
       vm.callHook = _callHook;
       vm.setHook = _setHook;
       vm.getHook = _getHook;
-    } // Making the component instance a live value when using Locker to support expandos.
-
+    }
 
-    this[lockerLivePropertyKey] = undefined; // Linking elm, shadow root and component with the VM.
+    markLockerLiveObject(this); // Linking elm, shadow root and component with the VM.
 
     associateVM(component, vm);
     associateVM(elm, vm);
@@ -2742,55 +2765,6 @@
       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 api$1() {
-    if (process.env.NODE_ENV !== 'production') {
-      assert.fail("@api decorator can only be used as a decorator function.");
-    }
-
-    throw new Error();
-  }
-
-  function createPublicPropertyDescriptor(key) {
-    return {
-      get: function get() {
-        var vm = getAssociatedVM(this);
-
-        if (isBeingConstructed(vm)) {
-          if (process.env.NODE_ENV !== 'production') {
-            logError("Can\u2019t read the value of property `".concat(toString$1(key), "` from the constructor because the owner component hasn\u2019t set the value yet. Instead, use the constructor to set a default value for the property."), vm);
-          }
-
-          return;
-        }
-
-        componentValueObserved(vm, key);
-        return vm.cmpProps[key];
-      },
-      set: function set(newValue) {
-        var vm = getAssociatedVM(this);
-
-        if (process.env.NODE_ENV !== 'production') {
-          var _vmBeingRendered3 = getVMBeingRendered();
-
-          assert.invariant(!isInvokingRender, "".concat(_vmBeingRendered3, ".render() method has side effects on the state of ").concat(vm, ".").concat(toString$1(key)));
-          assert.invariant(!isUpdatingTemplate, "Updating the template of ".concat(_vmBeingRendered3, " has side effects on the state of ").concat(vm, ".").concat(toString$1(key)));
-        }
-
-        vm.cmpProps[key] = newValue;
-        componentValueMutated(vm, key);
-      },
-      enumerable: true,
-      configurable: true
-    };
-  }
 
   var AccessorReactiveObserver = /*#__PURE__*/function (_ReactiveObserver) {
     _inherits(AccessorReactiveObserver, _ReactiveObserver);
@@ -2849,6 +2823,60 @@
     return AccessorReactiveObserver;
   }(ReactiveObserver);
 
+  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.
+   * 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 api$1() {
+    if (process.env.NODE_ENV !== 'production') {
+      assert.fail("@api decorator can only be used as a decorator function.");
+    }
+
+    throw new Error();
+  }
+
+  function createPublicPropertyDescriptor(key) {
+    return {
+      get: function get() {
+        var vm = getAssociatedVM(this);
+
+        if (isBeingConstructed(vm)) {
+          if (process.env.NODE_ENV !== 'production') {
+            logError("Can\u2019t read the value of property `".concat(toString$1(key), "` from the constructor because the owner component hasn\u2019t set the value yet. Instead, use the constructor to set a default value for the property."), vm);
+          }
+
+          return;
+        }
+
+        componentValueObserved(vm, key);
+        return vm.cmpProps[key];
+      },
+      set: function set(newValue) {
+        var vm = getAssociatedVM(this);
+
+        if (process.env.NODE_ENV !== 'production') {
+          var _vmBeingRendered3 = getVMBeingRendered();
+
+          assert.invariant(!isInvokingRender, "".concat(_vmBeingRendered3, ".render() method has side effects on the state of ").concat(vm, ".").concat(toString$1(key)));
+          assert.invariant(!isUpdatingTemplate, "Updating the template of ".concat(_vmBeingRendered3, " has side effects on the state of ").concat(vm, ".").concat(toString$1(key)));
+        }
+
+        vm.cmpProps[key] = newValue;
+        componentValueMutated(vm, key);
+      },
+      enumerable: true,
+      configurable: true
+    };
+  }
+
   function createPublicAccessorDescriptor(key, descriptor) {
     var _get3 = descriptor.get,
         _set2 = descriptor.set,
@@ -2889,7 +2917,7 @@
             var ro = vm.oar[key];
 
             if (isUndefined$1(ro)) {
-              ro = vm.oar[key] = new AccessorReactiveObserver(vm, _set2);
+              ro = vm.oar[key] = createAccessorReactiveObserver(vm, _set2);
             } // 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
@@ -2921,7 +2949,7 @@
 
   function track(target) {
     if (arguments.length === 1) {
-      return reactiveMembrane.getProxy(target);
+      return getReactiveProxy(target);
     }
 
     if (process.env.NODE_ENV !== 'production') {
@@ -2948,7 +2976,7 @@
           assert.invariant(!isUpdatingTemplate, "Updating the template of ".concat(_vmBeingRendered5, " has side effects on the state of ").concat(vm, ".").concat(toString$1(key)));
         }
 
-        var reactiveOrAnyValue = reactiveMembrane.getProxy(newValue);
+        var reactiveOrAnyValue = getReactiveProxy(newValue);
 
         if (reactiveOrAnyValue !== vm.cmpFields[key]) {
           vm.cmpFields[key] = reactiveOrAnyValue;
@@ -3423,7 +3451,7 @@
       fn = cachedSetterByKey[key] = function (newValue) {
         var vm = getAssociatedVM(this);
         var setHook = vm.setHook;
-        newValue = reactiveMembrane.getReadOnlyProxy(newValue);
+        newValue = getReadOnlyProxy(newValue);
         setHook(vm.component, key, newValue);
       };
     }
@@ -6472,7 +6500,7 @@
   }
 
   function getTemplateReactiveObserver(vm) {
-    return new ReactiveObserver(function () {
+    return createReactiveObserver(function () {
       var isDirty = vm.isDirty;
 
       if (isFalse(isDirty)) {
@@ -7291,7 +7319,7 @@
   function createConfigWatcher(component, configCallback, callbackWhenConfigIsReady) {
     var hasPendingConfig = false; // creating the reactive observer for reactive params when needed
 
-    var ro = new ReactiveObserver(function () {
+    var ro = createReactiveObserver(function () {
       if (hasPendingConfig === false) {
         hasPendingConfig = true; // collect new config in the micro-task
 
@@ -7592,7 +7620,7 @@
       }
     }
 
-    return reactiveMembrane.getReadOnlyProxy(obj);
+    return getReadOnlyProxy(obj);
   }
   /*
    * Copyright (c) 2022, salesforce.com, inc.
@@ -8273,7 +8301,7 @@
 
     return ctor;
   }
-  /* version: 2.21.1 */
+  /* version: 2.22.0 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -8441,6 +8469,85 @@
    */
 
 
+  var SUPPORTS_TEMPLATE = typeof HTMLTemplateElement === 'function';
+  var createFragment;
+
+  if (SUPPORTS_TEMPLATE) {
+    // Parse the fragment HTML string into DOM
+    createFragment = function createFragment(html) {
+      var 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.
+    var 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
+
+    var getTagName = function getTagName(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 createFragment(html) {
+      var wrapperTags = topLevelWrappingMap[getTagName(html)];
+
+      if (!isUndefined$1(wrapperTags)) {
+        var _iterator5 = _createForOfIteratorHelper(wrapperTags),
+            _step5;
+
+        try {
+          for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+            var wrapperTag = _step5.value;
+            html = "<".concat(wrapperTag, ">").concat(html, "</").concat(wrapperTag, ">");
+          }
+        } catch (err) {
+          _iterator5.e(err);
+        } finally {
+          _iterator5.f();
+        }
+      } // 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
+
+
+      var doc = document.implementation.createHTMLDocument('');
+      doc.body.innerHTML = html;
+      var content = doc.body;
+
+      if (!isUndefined$1(wrapperTags)) {
+        for (var _i32 = 0; _i32 < wrapperTags.length; _i32++) {
+          content = content.firstChild;
+        }
+      }
+
+      return content.firstChild;
+    };
+  }
+  /*
+   * 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
+   */
+
+
   var getCustomElement;
   var defineCustomElement;
   var HTMLElementConstructor;
@@ -8541,10 +8648,6 @@
     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) : document.createElementNS(namespace, tagName);
   }
@@ -8769,8 +8872,8 @@
       hydrated: true
     });
 
-    for (var _i32 = 0, _Object$entries2 = Object.entries(props); _i32 < _Object$entries2.length; _i32++) {
-      var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i32], 2),
+    for (var _i33 = 0, _Object$entries2 = Object.entries(props); _i33 < _Object$entries2.length; _i33++) {
+      var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i33], 2),
           key = _Object$entries2$_i[0],
           value = _Object$entries2$_i[1];
 
@@ -9102,7 +9205,7 @@
   });
   freeze(LightningElement);
   seal(LightningElement.prototype);
-  /* version: 2.21.1 */
+  /* version: 2.22.0 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;