lwc 2.45.1 → 2.45.3

package/dist/engine-dom/iife/es5/engine-dom_debug.js

@@ -29,9 +29,11 @@ var LWC = (function (exports) {
     function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
     function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
     function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
-    /* proxy-compat-disable */
     /**
-     * Copyright (C) 2018 salesforce.com, inc.
+     * Copyright (C) 2023 salesforce.com, inc.
+     */
+    /**
+     * Copyright (C) 2023 salesforce.com, inc.
      */
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -87,8 +89,10 @@ var LWC = (function (exports) {
     var isArray$1 = Array.isArray;
     var _Array$prototype = Array.prototype,
       ArrayCopyWithin = _Array$prototype.copyWithin,
+      ArrayEvery = _Array$prototype.every,
       ArrayFill = _Array$prototype.fill,
       ArrayFilter = _Array$prototype.filter,
+      ArrayIncludes = _Array$prototype.includes,
       ArrayIndexOf = _Array$prototype.indexOf,
       ArrayJoin = _Array$prototype.join,
       ArrayMap = _Array$prototype.map,
@@ -101,6 +105,15 @@ var LWC = (function (exports) {
       ArraySplice = _Array$prototype.splice,
       ArrayUnshift = _Array$prototype.unshift,
       forEach = _Array$prototype.forEach;
+    // The type of the return value of Array.prototype.every is `this is T[]`. However, once this
+    // Array method is pulled out of the prototype, the function is now referencing `this` where
+    // `this` is meaningless, resulting in a TypeScript compilation error.
+    //
+    // Exposing this helper function is the closest we can get to preserving the usage patterns
+    // of Array.prototype methods used elsewhere in the codebase.
+    function arrayEvery(arr, predicate) {
+      return ArrayEvery.call(arr, predicate);
+    }
     var StringFromCharCode = String.fromCharCode;
     var _String$prototype = String.prototype,
       StringCharCodeAt = _String$prototype.charCodeAt,
@@ -200,7 +213,7 @@ var LWC = (function (exports) {
       AriaPropNameToAttrNameMap = _ref.AriaPropNameToAttrNameMap;
     // These attributes take either an ID or a list of IDs as values.
     // This includes aria-* attributes as well as the special non-ARIA "for" attribute
-    var ID_REFERENCING_ATTRIBUTES_SET = new Set(['aria-activedescendant', 'aria-controls', 'aria-describedby', 'aria-details', 'aria-errormessage', 'aria-flowto', 'aria-labelledby', 'aria-owns', 'for']);
+    var ID_REFERENCING_ATTRIBUTES_SET = /*@__PURE__*/new Set(['aria-activedescendant', 'aria-controls', 'aria-describedby', 'aria-details', 'aria-errormessage', 'aria-flowto', 'aria-labelledby', 'aria-owns', 'for']);
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -263,11 +276,11 @@ var LWC = (function (exports) {
     /**
      * Map associating previously transformed HTML property into HTML attribute.
      */
-    var CACHED_PROPERTY_ATTRIBUTE_MAPPING = new Map();
+    var CACHED_PROPERTY_ATTRIBUTE_MAPPING = /*@__PURE__@*/new Map();
     /**
      * Map associating previously transformed HTML attribute into HTML property.
      */
-    var CACHED_ATTRIBUTE_PROPERTY_MAPPING = new Map();
+    var CACHED_ATTRIBUTE_PROPERTY_MAPPING = /*@__PURE__@*/new Map();
     function htmlPropertyToAttribute(propName) {
       var ariaAttributeName = AriaPropNameToAttrNameMap[propName];
       if (!isUndefined$1(ariaAttributeName)) {
@@ -315,10 +328,10 @@ var LWC = (function (exports) {
       CACHED_ATTRIBUTE_PROPERTY_MAPPING.set(attrName, propertyName);
       return propertyName;
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /**
-     * Copyright (C) 2018 salesforce.com, inc.
+     * Copyright (C) 2023 salesforce.com, inc.
      */
 
     /*
@@ -386,10 +399,10 @@ var LWC = (function (exports) {
      */
     function setFeatureFlagForTest(name, value) {
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /**
-     * Copyright (C) 2018 salesforce.com, inc.
+     * Copyright (C) 2023 salesforce.com, inc.
      */
 
     /*
@@ -450,7 +463,7 @@ var LWC = (function (exports) {
         }
       }
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -464,7 +477,9 @@ var LWC = (function (exports) {
       applyAriaReflection();
     }
 
-    /* proxy-compat-disable */
+    /**
+     * Copyright (C) 2023 salesforce.com, inc.
+     */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -611,6 +626,9 @@ var LWC = (function (exports) {
     function logError(message, vm) {
       log('error', message, vm, false);
     }
+    function logWarn(message, vm) {
+      log('warn', message, vm, false);
+    }
 
     /*
      * Copyright (c) 2019, salesforce.com, inc.
@@ -885,19 +903,6 @@ var LWC = (function (exports) {
      */
     // These properties get added to LWCElement.prototype publicProps automatically
     var defaultDefHTMLPropertyNames = ['accessKey', 'dir', 'draggable', 'hidden', 'id', 'lang', 'spellcheck', 'tabIndex', 'title'];
-    var controlledElement = null;
-    var controlledAttributeName;
-    function isAttributeLocked(elm, attrName) {
-      return elm !== controlledElement || attrName !== controlledAttributeName;
-    }
-    function lockAttribute(_elm, _key) {
-      controlledElement = null;
-      controlledAttributeName = undefined;
-    }
-    function unlockAttribute(elm, key) {
-      controlledElement = elm;
-      controlledAttributeName = key;
-    }
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -1513,6 +1518,14 @@ var LWC = (function (exports) {
      * SPDX-License-Identifier: MIT
      * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
      */
+    /**
+     * This module is responsible for producing the ComponentDef object that is always
+     * accessible via `vm.def`. This is lazily created during the creation of the first
+     * instance of a component class, and shared across all instances.
+     *
+     * This structure can be used to synthetically create proxies, and understand the
+     * shape of a component. It is also used internally to apply extra optimizations.
+     */
     /**
      * This operation is called with a descriptor of an standard html property
      * that a Custom Element can support (including AOM properties), which
@@ -1643,17 +1656,13 @@ var LWC = (function (exports) {
         var vm = getAssociatedVM(this);
         var elm = vm.elm,
           removeAttribute = vm.renderer.removeAttribute;
-        unlockAttribute(elm, name);
         removeAttribute(elm, name);
-        lockAttribute();
       },
       removeAttributeNS: function removeAttributeNS(namespace, name) {
         var _getAssociatedVM = getAssociatedVM(this),
           elm = _getAssociatedVM.elm,
           removeAttribute = _getAssociatedVM.renderer.removeAttribute;
-        unlockAttribute(elm, name);
         removeAttribute(elm, name, namespace);
-        lockAttribute();
       },
       getAttribute: function getAttribute(name) {
         var vm = getAssociatedVM(this);
@@ -1671,17 +1680,13 @@ var LWC = (function (exports) {
         var vm = getAssociatedVM(this);
         var elm = vm.elm,
           setAttribute = vm.renderer.setAttribute;
-        unlockAttribute(elm, name);
         setAttribute(elm, name, value);
-        lockAttribute();
       },
       setAttributeNS: function setAttributeNS(namespace, name, value) {
         var vm = getAssociatedVM(this);
         var elm = vm.elm,
           setAttribute = vm.renderer.setAttribute;
-        unlockAttribute(elm, name);
         setAttribute(elm, name, value, namespace);
-        lockAttribute();
       },
       getBoundingClientRect: function getBoundingClientRect() {
         var vm = getAssociatedVM(this);
@@ -2014,7 +2019,9 @@ var LWC = (function (exports) {
       });
       runWithBoundaryProtection(vm, vm, noop, function () {
         // job
-        connector = new adapter(dataCallback);
+        connector = new adapter(dataCallback, {
+          tagName: vm.tagName
+        });
       }, noop);
       var updateConnectorConfig = function updateConnectorConfig(config) {
         // every time the config is recomputed due to tracking,
@@ -2399,6 +2406,10 @@ var LWC = (function (exports) {
      * SPDX-License-Identifier: MIT
      * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
      */
+    /**
+     * This module is responsible for creating the base bridge class BaseBridgeElement
+     * that represents the HTMLElement extension used for any LWC inserted in the DOM.
+     */
     // A bridge descriptor is a descriptor whose job is just to get the component instance
     // from the element instance, and get the value or set a new value on the component.
     // This means that across different elements, similar names can get the exact same
@@ -2453,14 +2464,6 @@ var LWC = (function (exports) {
           }
           return;
         }
-        if (!isAttributeLocked(this, attrName)) {
-          // Ignore changes triggered by the engine itself during:
-          // * diffing when public props are attempting to reflect to the DOM
-          // * component via `this.setAttribute()`, should never update the prop
-          // Both cases, the setAttribute call is always wrapped by the unlocking of the
-          // attribute to be changed
-          return;
-        }
         // Reflect attribute change to the corresponding property when changed from outside.
         this[propName] = newValue;
       };
@@ -2679,6 +2682,15 @@ var LWC = (function (exports) {
       return ModernWeakMultiMap;
     }();
     var WeakMultiMap = supportsWeakRefs ? ModernWeakMultiMap : LegacyWeakMultiMap;
+
+    /*
+     * Copyright (c) 2020, 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
+     */
+    new WeakMap();
+    new WeakMap();
     var swappedStyleMap = new WeakMap();
     // The important thing here is the weak values – VMs are transient (one per component instance) and should be GC'ed,
     // so we don't want to create strong references to them.
@@ -2749,6 +2761,14 @@ var LWC = (function (exports) {
      * SPDX-License-Identifier: MIT
      * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
      */
+    /**
+     * This module is responsible for producing the ComponentDef object that is always
+     * accessible via `vm.def`. This is lazily created during the creation of the first
+     * instance of a component class, and shared across all instances.
+     *
+     * This structure can be used to synthetically create proxies, and understand the
+     * shape of a component. It is also used internally to apply extra optimizations.
+     */
     var CtorToDefMap = new WeakMap();
     function getCtorProto(Ctor) {
       var proto = getPrototypeOf$1(Ctor);
@@ -2920,9 +2940,9 @@ var LWC = (function (exports) {
         };
       }
       var publicMethods = {};
-      for (var _key2 in methods) {
+      for (var _key in methods) {
         // avoid leaking the reference to the public method descriptors
-        publicMethods[_key2] = methods[_key2].value;
+        publicMethods[_key] = methods[_key].value;
       }
       return {
         ctor: ctor,
@@ -3173,7 +3193,6 @@ var LWC = (function (exports) {
         var cur = attrs[key];
         var old = oldAttrs[key];
         if (old !== cur) {
-          unlockAttribute(elm, key);
           if (StringCharCodeAt.call(key, 3) === ColonCharCode$1) {
             // Assume xml namespace
             setAttribute(elm, key, cur, XML_NAMESPACE);
@@ -3185,7 +3204,6 @@ var LWC = (function (exports) {
           } else {
             setAttribute(elm, key, cur);
           }
-          lockAttribute();
         }
       }
     }
@@ -4595,8 +4613,8 @@ var LWC = (function (exports) {
     }
     function buildParseFragmentFn(createFragmentFn) {
       return function (strings) {
-        for (var _len3 = arguments.length, keys = new Array(_len3 > 1 ? _len3 - 1 : 0), _key3 = 1; _key3 < _len3; _key3++) {
-          keys[_key3 - 1] = arguments[_key3];
+        for (var _len3 = arguments.length, keys = new Array(_len3 > 1 ? _len3 - 1 : 0), _key2 = 1; _key2 < _len3; _key2++) {
+          keys[_key2 - 1] = arguments[_key2];
         }
         var cache = create(null);
         return function () {
@@ -5706,6 +5724,35 @@ var LWC = (function (exports) {
       return renderer.nextSibling(hydratedNode);
     }
     var NODE_VALUE_PROP = 'nodeValue';
+    // The validationOptOut static property can be an array of attribute names.
+    // Any attribute names specified in that array will not be validated, and the
+    // LWC runtime will assume that VDOM attrs and DOM attrs are in sync.
+    function getValidationPredicate(optOutStaticProp) {
+      if (isUndefined$1(optOutStaticProp)) {
+        return function (_attrName) {
+          return true;
+        };
+      }
+      // If validationOptOut is true, no attributes will be checked for correctness
+      // and the runtime will assume VDOM attrs and DOM attrs are in sync.
+      if (isTrue(optOutStaticProp)) {
+        return function (_attrName) {
+          return false;
+        };
+      }
+      // If validationOptOut is an array of strings, attributes specified in the
+      // array will be "opted out". Attributes not specified in the array will still
+      // be validated.
+      if (isArray$1(optOutStaticProp) && arrayEvery(optOutStaticProp, isString)) {
+        return function (attrName) {
+          return !ArrayIncludes.call(optOutStaticProp, attrName);
+        };
+      }
+      logWarn('Validation opt out must be `true` or an array of attributes that should not be validated.');
+      return function (_attrName) {
+        return true;
+      };
+    }
     function hydrateText(node, vnode, renderer) {
       var _a;
       if (!hasCorrectNodeType(vnode, node, 3 /* EnvNodeTypes.TEXT */, renderer)) {
@@ -5769,7 +5816,18 @@ var LWC = (function (exports) {
       return elm;
     }
     function hydrateCustomElement(elm, vnode, renderer) {
-      if (!hasCorrectNodeType(vnode, elm, 1 /* EnvNodeTypes.ELEMENT */, renderer) || !isMatchingElement(vnode, elm, renderer)) {
+      var validationOptOut = vnode.ctor.validationOptOut;
+      var shouldValidateAttr = getValidationPredicate(validationOptOut);
+      // The validationOptOut static property can be an array of attribute names.
+      // Any attribute names specified in that array will not be validated, and the
+      // LWC runtime will assume that VDOM attrs and DOM attrs are in sync.
+      //
+      // If validationOptOut is true, no attributes will be checked for correctness
+      // and the runtime will assume VDOM attrs and DOM attrs are in sync.
+      //
+      // Therefore, if validationOptOut is falsey or an array of strings, we need to
+      // examine some or all of the custom element's attributes.
+      if (!hasCorrectNodeType(vnode, elm, 1 /* EnvNodeTypes.ELEMENT */, renderer) || !isMatchingElement(vnode, elm, renderer, shouldValidateAttr)) {
         return handleMismatch(elm, vnode, renderer);
       }
       var sel = vnode.sel,
@@ -5798,18 +5856,16 @@ var LWC = (function (exports) {
     }
     function hydrateChildren(node, children, parentNode, owner) {
       var nextNode = node;
-      var anchor = null;
       var renderer = owner.renderer;
       for (var _i36 = 0; _i36 < children.length; _i36++) {
         var childVnode = children[_i36];
         if (!isNull(childVnode)) {
           if (nextNode) {
             nextNode = hydrateNode(nextNode, childVnode, renderer);
-            anchor = childVnode.elm;
           } else {
             hasMismatch = true;
-            mount(childVnode, parentNode, renderer, anchor);
-            anchor = childVnode.elm;
+            mount(childVnode, parentNode, renderer, nextNode);
+            nextNode = renderer.nextSibling(childVnode.elm);
           }
         }
       }
@@ -5847,14 +5903,17 @@ var LWC = (function (exports) {
       return true;
     }
     function isMatchingElement(vnode, elm, renderer) {
+      var shouldValidateAttr = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : function () {
+        return true;
+      };
       var getProperty = renderer.getProperty;
       if (vnode.sel.toLowerCase() !== getProperty(elm, 'tagName').toLowerCase()) {
         return false;
       }
-      var hasIncompatibleAttrs = validateAttrs(vnode, elm, renderer);
-      var hasIncompatibleClass = validateClassAttr(vnode, elm, renderer);
-      var hasIncompatibleStyle = validateStyleAttr(vnode, elm, renderer);
-      return hasIncompatibleAttrs && hasIncompatibleClass && hasIncompatibleStyle;
+      var hasCompatibleAttrs = validateAttrs(vnode, elm, renderer, shouldValidateAttr);
+      var hasCompatibleClass = shouldValidateAttr('class') ? validateClassAttr(vnode, elm, renderer) : true;
+      var hasCompatibleStyle = shouldValidateAttr('style') ? validateStyleAttr(vnode, elm, renderer) : true;
+      return hasCompatibleAttrs && hasCompatibleClass && hasCompatibleStyle;
     }
     function attributeValuesAreEqual(vnodeValue, value) {
       var vnodeValueAsString = String(vnodeValue);
@@ -5869,7 +5928,7 @@ var LWC = (function (exports) {
       // In all other cases, the two values are not considered equal
       return false;
     }
-    function validateAttrs(vnode, elm, renderer) {
+    function validateAttrs(vnode, elm, renderer, shouldValidateAttr) {
       var _vnode$data$attrs = vnode.data.attrs,
         attrs = _vnode$data$attrs === void 0 ? {} : _vnode$data$attrs;
       var nodesAreCompatible = true;
@@ -5879,6 +5938,9 @@ var LWC = (function (exports) {
         var _Object$entries$_i = _slicedToArray(_Object$entries[_i37], 2),
           attrName = _Object$entries$_i[0],
           attrValue = _Object$entries$_i[1];
+        if (!shouldValidateAttr(attrName)) {
+          continue;
+        }
         vnode.owner;
         var getAttribute = renderer.getAttribute;
         var elmAttrValue = getAttribute(elm, attrName);
@@ -6469,6 +6531,7 @@ var LWC = (function (exports) {
      * SPDX-License-Identifier: MIT
      * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
      */
+    new WeakMap();
     // Creates a custom element for compat (legacy) browser environments
     var createCustomElementCompat = function createCustomElementCompat(tagName, upgradeCallback) {
       var elm = document.createElement(tagName);
@@ -6596,7 +6659,7 @@ var LWC = (function (exports) {
     function rendererFactory(baseRenderer) {
       var renderer = function (exports) {
         /**
-         * Copyright (C) 2018 salesforce.com, inc.
+         * Copyright (C) 2023 salesforce.com, inc.
          */
         /*
          * Copyright (c) 2018, salesforce.com, inc.
@@ -6635,7 +6698,7 @@ var LWC = (function (exports) {
         function isNull(obj) {
           return obj === null;
         }
-        /** version: 2.45.1 */
+        /** version: 2.45.3 */
 
         /*
          * Copyright (c) 2023, salesforce.com, inc.
@@ -7270,7 +7333,7 @@ var LWC = (function (exports) {
         });
       });
     }
-    /* version: 2.45.1 */
+    /** version: 2.45.3 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;