lwc 2.45.1 → 2.45.2

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

@@ -49,7 +49,16 @@
      */
     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 { concat: ArrayConcat$1, copyWithin: ArrayCopyWithin, fill: ArrayFill, filter: ArrayFilter, find: ArrayFind, findIndex: ArrayFindIndex, indexOf: ArrayIndexOf, join: ArrayJoin, map: ArrayMap, pop: ArrayPop, push: ArrayPush$1, reduce: ArrayReduce, reverse: ArrayReverse, shift: ArrayShift, slice: ArraySlice, some: ArraySome, sort: ArraySort, splice: ArraySplice, unshift: ArrayUnshift, forEach, } = Array.prototype;
+    const { concat: ArrayConcat$1, copyWithin: ArrayCopyWithin, every: ArrayEvery, fill: ArrayFill, filter: ArrayFilter, find: ArrayFind, findIndex: ArrayFindIndex, includes: ArrayIncludes, indexOf: ArrayIndexOf, join: ArrayJoin, map: ArrayMap, pop: ArrayPop, push: ArrayPush$1, reduce: ArrayReduce, reverse: ArrayReverse, shift: ArrayShift, slice: ArraySlice, some: ArraySome, sort: ArraySort, splice: ArraySplice, unshift: ArrayUnshift, forEach, } = Array.prototype;
+    // 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);
+    }
     const { fromCharCode: StringFromCharCode } = String;
     const { charCodeAt: StringCharCodeAt, replace: StringReplace, split: StringSplit, slice: StringSlice, toLowerCase: StringToLowerCase, } = String.prototype;
     function isUndefined$1(obj) {
@@ -335,9 +344,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
-    const LWC_VERSION = "2.45.1";
+    const LWC_VERSION = "2.45.2";
     const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-    /** version: 2.45.1 */
+    /** version: 2.45.2 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -415,7 +424,7 @@
             setFeatureFlag(name, value);
         }
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.2 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -479,7 +488,7 @@
             }
         }
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.2 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -6708,6 +6717,27 @@
         }
         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 (_attrName) => 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 (_attrName) => 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 (attrName) => !ArrayIncludes.call(optOutStaticProp, attrName);
+        }
+        logWarn('Validation opt out must be `true` or an array of attributes that should not be validated.');
+        return (_attrName) => true;
+    }
     function hydrateText(node, vnode, renderer) {
         var _a;
         if (!hasCorrectNodeType(vnode, node, 3 /* EnvNodeTypes.TEXT */, renderer)) {
@@ -6786,8 +6816,19 @@
         return elm;
     }
     function hydrateCustomElement(elm, vnode, renderer) {
+        const { validationOptOut } = vnode.ctor;
+        const 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)) {
+            !isMatchingElement(vnode, elm, renderer, shouldValidateAttr)) {
             return handleMismatch(elm, vnode, renderer);
         }
         const { sel, mode, ctor, owner } = vnode;
@@ -6881,7 +6922,7 @@
         }
         return true;
     }
-    function isMatchingElement(vnode, elm, renderer) {
+    function isMatchingElement(vnode, elm, renderer, shouldValidateAttr = () => true) {
         const { getProperty } = renderer;
         if (vnode.sel.toLowerCase() !== getProperty(elm, 'tagName').toLowerCase()) {
             if (process.env.NODE_ENV !== 'production') {
@@ -6889,10 +6930,14 @@
             }
             return false;
         }
-        const hasIncompatibleAttrs = validateAttrs(vnode, elm, renderer);
-        const hasIncompatibleClass = validateClassAttr(vnode, elm, renderer);
-        const hasIncompatibleStyle = validateStyleAttr(vnode, elm, renderer);
-        return hasIncompatibleAttrs && hasIncompatibleClass && hasIncompatibleStyle;
+        const hasCompatibleAttrs = validateAttrs(vnode, elm, renderer, shouldValidateAttr);
+        const hasCompatibleClass = shouldValidateAttr('class')
+            ? validateClassAttr(vnode, elm, renderer)
+            : true;
+        const hasCompatibleStyle = shouldValidateAttr('style')
+            ? validateStyleAttr(vnode, elm, renderer)
+            : true;
+        return hasCompatibleAttrs && hasCompatibleClass && hasCompatibleStyle;
     }
     function attributeValuesAreEqual(vnodeValue, value) {
         const vnodeValueAsString = String(vnodeValue);
@@ -6907,12 +6952,15 @@
         // In all other cases, the two values are not considered equal
         return false;
     }
-    function validateAttrs(vnode, elm, renderer) {
+    function validateAttrs(vnode, elm, renderer, shouldValidateAttr) {
         const { data: { attrs = {} }, } = vnode;
         let nodesAreCompatible = true;
         // Validate attributes, though we could always recovery from those by running the update mods.
         // Note: intentionally ONLY matching vnodes.attrs to elm.attrs, in case SSR is adding extra attributes.
         for (const [attrName, attrValue] of Object.entries(attrs)) {
+            if (!shouldValidateAttr(attrName)) {
+                continue;
+            }
             const { owner } = vnode;
             const { getAttribute } = renderer;
             const elmAttrValue = getAttribute(elm, attrName);
@@ -7336,7 +7384,7 @@
         }
         return getReadOnlyProxy(obj);
     }
-    /* version: 2.45.1 */
+    /* version: 2.45.2 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -7764,7 +7812,7 @@
         function isNull(obj) {
             return obj === null;
         }
-        /** version: 2.45.1 */
+        /** version: 2.45.2 */
 
         /*
          * Copyright (c) 2023, salesforce.com, inc.
@@ -8383,7 +8431,7 @@
             });
         }));
     }
-    /* version: 2.45.1 */
+    /* version: 2.45.2 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;