lwc 2.45.1 → 2.45.3

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

@@ -1,9 +1,11 @@
 var LWC = (function (exports) {
     'use strict';
 
-    /* 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.
@@ -46,7 +48,16 @@ var LWC = (function (exports) {
      */
     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) {
@@ -187,7 +198,7 @@ var LWC = (function (exports) {
     })();
     // 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
-    const ID_REFERENCING_ATTRIBUTES_SET = new Set([
+    const ID_REFERENCING_ATTRIBUTES_SET = /*@__PURE__*/ new Set([
         'aria-activedescendant',
         'aria-controls',
         'aria-describedby',
@@ -274,11 +285,11 @@ var LWC = (function (exports) {
     /**
      * Map associating previously transformed HTML property into HTML attribute.
      */
-    const CACHED_PROPERTY_ATTRIBUTE_MAPPING = new Map();
+    const CACHED_PROPERTY_ATTRIBUTE_MAPPING = /*@__PURE__@*/ new Map();
     /**
      * Map associating previously transformed HTML attribute into HTML property.
      */
-    const CACHED_ATTRIBUTE_PROPERTY_MAPPING = new Map();
+    const CACHED_ATTRIBUTE_PROPERTY_MAPPING = /*@__PURE__@*/ new Map();
     function htmlPropertyToAttribute(propName) {
         const ariaAttributeName = AriaPropNameToAttrNameMap[propName];
         if (!isUndefined$1(ariaAttributeName)) {
@@ -332,12 +343,12 @@ 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.45.1";
+    const LWC_VERSION = "2.45.3";
     const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /**
-     * Copyright (C) 2018 salesforce.com, inc.
+     * Copyright (C) 2023 salesforce.com, inc.
      */
 
     /*
@@ -412,10 +423,10 @@ var LWC = (function (exports) {
             setFeatureFlag(name, value);
         }
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /**
-     * Copyright (C) 2018 salesforce.com, inc.
+     * Copyright (C) 2023 salesforce.com, inc.
      */
 
     /*
@@ -476,7 +487,7 @@ var LWC = (function (exports) {
             }
         }
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -490,7 +501,9 @@ var LWC = (function (exports) {
         applyAriaReflection();
     }
 
-    /* proxy-compat-disable */
+    /**
+     * Copyright (C) 2023 salesforce.com, inc.
+     */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -919,19 +932,6 @@ var LWC = (function (exports) {
         'tabIndex',
         'title',
     ];
-    let controlledElement = null;
-    let 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.
@@ -970,6 +970,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
      */
+    /* eslint @lwc/lwc-internal/no-production-assert: "off" */
     function generateDataDescriptor(options) {
         return assign({
             configurable: true,
@@ -1799,6 +1800,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
@@ -1962,15 +1971,11 @@ var LWC = (function (exports) {
         removeAttribute(name) {
             const vm = getAssociatedVM(this);
             const { elm, renderer: { removeAttribute }, } = vm;
-            unlockAttribute(elm, name);
             removeAttribute(elm, name);
-            lockAttribute();
         },
         removeAttributeNS(namespace, name) {
             const { elm, renderer: { removeAttribute }, } = getAssociatedVM(this);
-            unlockAttribute(elm, name);
             removeAttribute(elm, name, namespace);
-            lockAttribute();
         },
         getAttribute(name) {
             const vm = getAssociatedVM(this);
@@ -1992,9 +1997,7 @@ var LWC = (function (exports) {
                     logError(`Failed to construct '${getComponentTag(vm)}': The result must not have attributes.`);
                 }
             }
-            unlockAttribute(elm, name);
             setAttribute(elm, name, value);
-            lockAttribute();
         },
         setAttributeNS(namespace, name, value) {
             const vm = getAssociatedVM(this);
@@ -2004,9 +2007,7 @@ var LWC = (function (exports) {
                     logError(`Failed to construct '${getComponentTag(vm)}': The result must not have attributes.`);
                 }
             }
-            unlockAttribute(elm, name);
             setAttribute(elm, name, value, namespace);
-            lockAttribute();
         },
         getBoundingClientRect() {
             const vm = getAssociatedVM(this);
@@ -2388,7 +2389,7 @@ var LWC = (function (exports) {
         });
         runWithBoundaryProtection(vm, vm, noop, () => {
             // job
-            connector = new adapter(dataCallback);
+            connector = new adapter(dataCallback, { tagName: vm.tagName });
         }, noop);
         const updateConnectorConfig = (config) => {
             // every time the config is recomputed due to tracking,
@@ -2956,6 +2957,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
@@ -3009,14 +3014,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;
         };
@@ -3361,6 +3358,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.
+     */
     const CtorToDefMap = new WeakMap();
     function getCtorProto(Ctor) {
         let proto = getPrototypeOf$1(Ctor);
@@ -3802,7 +3807,6 @@ var LWC = (function (exports) {
             const cur = attrs[key];
             const 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);
@@ -3817,7 +3821,6 @@ var LWC = (function (exports) {
                 else {
                     setAttribute(elm, key, cur);
                 }
-                lockAttribute();
             }
         }
     }
@@ -6705,6 +6708,27 @@ var LWC = (function (exports) {
         }
         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)) {
@@ -6783,8 +6807,19 @@ var LWC = (function (exports) {
         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;
@@ -6815,14 +6850,12 @@ var LWC = (function (exports) {
     function hydrateChildren(node, children, parentNode, owner) {
         let hasWarned = false;
         let nextNode = node;
-        let anchor = null;
         const { renderer } = owner;
         for (let i = 0; i < children.length; i++) {
             const childVnode = children[i];
             if (!isNull(childVnode)) {
                 if (nextNode) {
                     nextNode = hydrateNode(nextNode, childVnode, renderer);
-                    anchor = childVnode.elm;
                 }
                 else {
                     hasMismatch = true;
@@ -6832,8 +6865,8 @@ var LWC = (function (exports) {
                             logError(`Hydration mismatch: incorrect number of rendered nodes. Client produced more nodes than the server.`, owner);
                         }
                     }
-                    mount(childVnode, parentNode, renderer, anchor);
-                    anchor = childVnode.elm;
+                    mount(childVnode, parentNode, renderer, nextNode);
+                    nextNode = renderer.nextSibling(childVnode.elm);
                 }
             }
         }
@@ -6878,7 +6911,7 @@ var LWC = (function (exports) {
         }
         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') {
@@ -6886,10 +6919,14 @@ var LWC = (function (exports) {
             }
             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);
@@ -6904,12 +6941,15 @@ 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) {
         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);
@@ -7333,7 +7373,7 @@ var LWC = (function (exports) {
         }
         return getReadOnlyProxy(obj);
     }
-    /* version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -7595,6 +7635,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
     const createCustomElementCompat = (tagName, upgradeCallback) => {
         const elm = document.createElement(tagName);
@@ -7721,7 +7762,7 @@ var LWC = (function (exports) {
         const renderer = (function (exports) {
 
         /**
-         * Copyright (C) 2018 salesforce.com, inc.
+         * Copyright (C) 2023 salesforce.com, inc.
          */
         /*
          * Copyright (c) 2018, salesforce.com, inc.
@@ -7761,7 +7802,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.
@@ -8380,7 +8421,7 @@ var LWC = (function (exports) {
             });
         }));
     }
-    /* version: 2.45.1 */
+    /** version: 2.45.3 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;