lwc 2.45.1 → 2.45.3

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

@@ -1,6 +1,8 @@
-/* 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.
@@ -43,7 +45,16 @@ var assert = /*#__PURE__*/Object.freeze({
  */
 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 @@ const { AriaAttrNameToPropNameMap, AriaPropNameToAttrNameMap } = /*@__PURE__*/ (
 })();
 // 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 @@ const { NO_STANDARD_ATTRIBUTE_PROPERTY_MAPPING, NO_STANDARD_PROPERTY_ATTRIBUTE_M
 /**
  * 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)) {
@@ -329,12 +340,12 @@ function htmlAttributeToProperty(attrName) {
  * 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.
  */
 
 /*
@@ -409,10 +420,10 @@ function setFeatureFlagForTest(name, value) {
         setFeatureFlag(name, value);
     }
 }
-/** version: 2.45.1 */
+/** version: 2.45.3 */
 
 /**
- * Copyright (C) 2018 salesforce.com, inc.
+ * Copyright (C) 2023 salesforce.com, inc.
  */
 
 /*
@@ -473,7 +484,7 @@ function applyAriaReflection(prototype = Element.prototype) {
         }
     }
 }
-/** version: 2.45.1 */
+/** version: 2.45.3 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -487,7 +498,9 @@ if (!lwcRuntimeFlags.DISABLE_ARIA_REFLECTION_POLYFILL) {
     applyAriaReflection();
 }
 
-/* proxy-compat-disable */
+/**
+ * Copyright (C) 2023 salesforce.com, inc.
+ */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -916,19 +929,6 @@ const defaultDefHTMLPropertyNames = [
     '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.
@@ -967,6 +967,7 @@ forEach.call(defaultDefHTMLPropertyNames, (propName) => {
  * 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,
@@ -1796,6 +1797,14 @@ function markLockerLiveObject(obj) {
  * 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
@@ -1959,15 +1968,11 @@ LightningElement.prototype = {
     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);
@@ -1989,9 +1994,7 @@ LightningElement.prototype = {
                 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);
@@ -2001,9 +2004,7 @@ LightningElement.prototype = {
                 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);
@@ -2385,7 +2386,7 @@ function createConnector(vm, name, wireDef) {
     });
     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,
@@ -2953,6 +2954,10 @@ function sanitizeAttribute(tagName, namespaceUri, attrName, attrValue) {
  * 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
@@ -3006,14 +3011,6 @@ function createAttributeChangedCallback(attributeToPropMap, superAttributeChange
             }
             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;
     };
@@ -3358,6 +3355,14 @@ function swapStyle(oldStyle, newStyle) {
  * 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);
@@ -3799,7 +3804,6 @@ function patchAttributes(oldVnode, vnode, renderer) {
         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);
@@ -3814,7 +3818,6 @@ function patchAttributes(oldVnode, vnode, renderer) {
             else {
                 setAttribute(elm, key, cur);
             }
-            lockAttribute();
         }
     }
 }
@@ -6702,6 +6705,27 @@ function textNodeContentsAreEqual(node, vnode, renderer) {
     }
     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)) {
@@ -6780,8 +6804,19 @@ function hydrateElement(elm, vnode, renderer) {
     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;
@@ -6812,14 +6847,12 @@ function hydrateCustomElement(elm, vnode, renderer) {
 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;
@@ -6829,8 +6862,8 @@ function hydrateChildren(node, children, parentNode, owner) {
                         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);
             }
         }
     }
@@ -6875,7 +6908,7 @@ function hasCorrectNodeType(vnode, node, nodeType, renderer) {
     }
     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') {
@@ -6883,10 +6916,14 @@ function isMatchingElement(vnode, elm, renderer) {
         }
         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);
@@ -6901,12 +6938,15 @@ function attributeValuesAreEqual(vnodeValue, value) {
     // 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);
@@ -7330,7 +7370,7 @@ function readonly(obj) {
     }
     return getReadOnlyProxy(obj);
 }
-/* version: 2.45.1 */
+/** version: 2.45.3 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -7592,6 +7632,7 @@ const hasCustomElements = isCustomElementRegistryAvailable();
  * 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);
@@ -7718,7 +7759,7 @@ function rendererFactory(baseRenderer) {
     const renderer = (function (exports) {
 
     /**
-     * Copyright (C) 2018 salesforce.com, inc.
+     * Copyright (C) 2023 salesforce.com, inc.
      */
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -7758,7 +7799,7 @@ function rendererFactory(baseRenderer) {
     function isNull(obj) {
         return obj === null;
     }
-    /** version: 2.45.1 */
+    /** version: 2.45.3 */
 
     /*
      * Copyright (c) 2023, salesforce.com, inc.
@@ -8377,7 +8418,7 @@ function registerContextProvider(elm, adapterContextToken, onContextSubscription
         });
     }));
 }
-/* version: 2.45.1 */
+/** version: 2.45.3 */
 
 export { LightningElement, profilerControl as __unstable__ProfilerControl, reportingControl as __unstable__ReportingControl, api$1 as api, deprecatedBuildCustomElementConstructor as buildCustomElementConstructor, createContextProvider, createElement, freezeTemplate, getComponentConstructor, getComponentDef, hydrateComponent, isComponentConstructor, isNodeShadowed as isNodeFromTemplate, parseFragment, parseSVGFragment, readonly, register, registerComponent, registerDecorators, registerTemplate, renderer, rendererFactory, sanitizeAttribute, setFeatureFlag, setFeatureFlagForTest, setHooks, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };
 //# sourceMappingURL=engine-dom.js.map