lwc 2.45.1 → 2.45.3

package/dist/engine-dom/iife/es2017/engine-dom_debug.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) {
@@ -184,7 +195,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',
@@ -271,11 +282,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)) {
@@ -321,10 +332,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.
      */
 
     /*
@@ -388,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.
      */
 
     /*
@@ -452,7 +463,7 @@ var LWC = (function (exports) {
             }
         }
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -466,7 +477,9 @@ var LWC = (function (exports) {
         applyAriaReflection();
     }
 
-    /* proxy-compat-disable */
+    /**
+     * Copyright (C) 2023 salesforce.com, inc.
+     */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -615,6 +628,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.
@@ -863,19 +879,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.
@@ -1372,6 +1375,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
@@ -1489,15 +1500,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);
@@ -1514,16 +1521,12 @@ var LWC = (function (exports) {
         setAttribute(name, value) {
             const vm = getAssociatedVM(this);
             const { elm, renderer: { setAttribute }, } = vm;
-            unlockAttribute(elm, name);
             setAttribute(elm, name, value);
-            lockAttribute();
         },
         setAttributeNS(namespace, name, value) {
             const vm = getAssociatedVM(this);
             const { elm, renderer: { setAttribute }, } = vm;
-            unlockAttribute(elm, name);
             setAttribute(elm, name, value, namespace);
-            lockAttribute();
         },
         getBoundingClientRect() {
             const vm = getAssociatedVM(this);
@@ -1834,7 +1837,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,
@@ -2200,6 +2203,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
@@ -2253,14 +2260,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;
         };
@@ -2442,6 +2441,15 @@ var LWC = (function (exports) {
         }
     }
     const 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();
     const 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.
@@ -2503,6 +2511,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);
@@ -2905,7 +2921,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);
@@ -2920,7 +2935,6 @@ var LWC = (function (exports) {
                 else {
                     setAttribute(elm, key, cur);
                 }
-                lockAttribute();
             }
         }
     }
@@ -5370,6 +5384,27 @@ var LWC = (function (exports) {
         return renderer.nextSibling(hydratedNode);
     }
     const 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 (_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)) {
@@ -5431,8 +5466,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;
@@ -5458,19 +5504,17 @@ var LWC = (function (exports) {
     }
     function hydrateChildren(node, children, parentNode, owner) {
         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;
-                    mount(childVnode, parentNode, renderer, anchor);
-                    anchor = childVnode.elm;
+                    mount(childVnode, parentNode, renderer, nextNode);
+                    nextNode = renderer.nextSibling(childVnode.elm);
                 }
             }
         }
@@ -5507,15 +5551,19 @@ 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()) {
             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);
@@ -5530,12 +5578,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 { getAttribute } = renderer;
             const elmAttrValue = getAttribute(elm, attrName);
             if (!attributeValuesAreEqual(attrValue, elmAttrValue)) {
@@ -6093,6 +6144,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);
@@ -6219,7 +6271,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.
@@ -6259,7 +6311,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.
@@ -6870,7 +6922,7 @@ var LWC = (function (exports) {
             });
         }));
     }
-    /* version: 2.45.1 */
+    /** version: 2.45.3 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;