lwc 2.45.1 → 2.45.3

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

@@ -4,9 +4,11 @@
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.LWC = {}));
 })(this, (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.
@@ -49,7 +51,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) {
@@ -187,7 +198,7 @@
     })();
     // 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 @@
     /**
      * 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)) {
@@ -324,10 +335,10 @@
         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.
      */
 
     /*
@@ -391,10 +402,10 @@
      */
     function setFeatureFlagForTest(name, value) {
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /**
-     * Copyright (C) 2018 salesforce.com, inc.
+     * Copyright (C) 2023 salesforce.com, inc.
      */
 
     /*
@@ -455,7 +466,7 @@
             }
         }
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -469,7 +480,9 @@
         applyAriaReflection();
     }
 
-    /* proxy-compat-disable */
+    /**
+     * Copyright (C) 2023 salesforce.com, inc.
+     */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -618,6 +631,9 @@
     function logError(message, vm) {
         log('error', message, vm, false);
     }
+    function logWarn(message, vm) {
+        log('warn', message, vm, false);
+    }
 
     /*
      * Copyright (c) 2019, salesforce.com, inc.
@@ -866,19 +882,6 @@
         '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.
@@ -1375,6 +1378,14 @@
      * 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
@@ -1492,15 +1503,11 @@
         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);
@@ -1517,16 +1524,12 @@
         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);
@@ -1837,7 +1840,7 @@
         });
         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,
@@ -2203,6 +2206,10 @@
      * 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
@@ -2256,14 +2263,6 @@
                 }
                 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;
         };
@@ -2445,6 +2444,15 @@
         }
     }
     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.
@@ -2506,6 +2514,14 @@
      * 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);
@@ -2908,7 +2924,6 @@
             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);
@@ -2923,7 +2938,6 @@
                 else {
                     setAttribute(elm, key, cur);
                 }
-                lockAttribute();
             }
         }
     }
@@ -5373,6 +5387,27 @@
         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)) {
@@ -5434,8 +5469,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;
@@ -5461,19 +5507,17 @@
     }
     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);
                 }
             }
         }
@@ -5510,15 +5554,19 @@
         }
         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);
@@ -5533,12 +5581,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 { getAttribute } = renderer;
             const elmAttrValue = getAttribute(elm, attrName);
             if (!attributeValuesAreEqual(attrValue, elmAttrValue)) {
@@ -6096,6 +6147,7 @@
      * 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);
@@ -6222,7 +6274,7 @@
         const renderer = (function (exports) {
 
         /**
-         * Copyright (C) 2018 salesforce.com, inc.
+         * Copyright (C) 2023 salesforce.com, inc.
          */
         /*
          * Copyright (c) 2018, salesforce.com, inc.
@@ -6262,7 +6314,7 @@
         function isNull(obj) {
             return obj === null;
         }
-        /** version: 2.45.1 */
+        /** version: 2.45.3 */
 
         /*
          * Copyright (c) 2023, salesforce.com, inc.
@@ -6873,7 +6925,7 @@
             });
         }));
     }
-    /* version: 2.45.1 */
+    /** version: 2.45.3 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;