lwc 2.45.1 → 2.45.2

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

@@ -90,8 +90,10 @@
     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,
@@ -105,6 +107,15 @@
       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,
@@ -330,9 +341,9 @@
      * 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
-    var LWC_VERSION = "2.45.1";
+    var LWC_VERSION = "2.45.2";
     var LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-    /** version: 2.45.1 */
+    /** version: 2.45.2 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -412,7 +423,7 @@
         setFeatureFlag(name, value);
       }
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.2 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -476,7 +487,7 @@
         }
       }
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.2 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -7026,6 +7037,35 @@
       }
       return false;
     }
+    // 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)) {
@@ -7105,7 +7145,18 @@
       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,
@@ -7202,6 +7253,9 @@
       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()) {
         if (process.env.NODE_ENV !== 'production') {
@@ -7209,10 +7263,10 @@
         }
         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);
@@ -7227,7 +7281,7 @@
       // 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;
@@ -7237,6 +7291,9 @@
         var _Object$entries$_i = _slicedToArray(_Object$entries[_i37], 2),
           attrName = _Object$entries$_i[0],
           attrValue = _Object$entries$_i[1];
+        if (!shouldValidateAttr(attrName)) {
+          continue;
+        }
         var owner = vnode.owner;
         var getAttribute = renderer.getAttribute;
         var elmAttrValue = getAttribute(elm, attrName);
@@ -7688,7 +7745,7 @@
       }
       return getReadOnlyProxy(obj);
     }
-    /* version: 2.45.1 */
+    /* version: 2.45.2 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -8114,7 +8171,7 @@
         function isNull(obj) {
           return obj === null;
         }
-        /** version: 2.45.1 */
+        /** version: 2.45.2 */
 
         /*
          * Copyright (c) 2023, salesforce.com, inc.
@@ -8756,7 +8813,7 @@
         });
       });
     }
-    /* version: 2.45.1 */
+    /* version: 2.45.2 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;