@lwc/engine-core 2.45.1 → 2.45.3

package/dist/{engine-core.js → index.js}

@@ -1,5 +1,7 @@
-/* proxy-compat-disable */
-import { noop, StringToLowerCase, isNull, ArrayPush as ArrayPush$1, ArrayJoin, isFrozen, isUndefined as isUndefined$1, defineProperty, ArrayIndexOf, ArraySplice, create, seal, isArray as isArray$1, isFunction as isFunction$1, keys, hasOwnProperty as hasOwnProperty$1, forEach, AriaPropNameToAttrNameMap, getPropertyDescriptor, defineProperties, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, assign, isObject, freeze, KEY__SYNTHETIC_MODE, assert, toString as toString$1, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, isFalse, LWC_VERSION_COMMENT_REGEX, LWC_VERSION, getOwnPropertyNames as getOwnPropertyNames$1, htmlPropertyToAttribute, ArraySlice, ArrayMap, KEY__SCOPED_CSS, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, htmlAttributeToProperty, isString, StringSlice, isTrue, SVG_NAMESPACE, KEY__SHADOW_STATIC, KEY__SHADOW_RESOLVER, ArraySome, ArrayPop, isNumber, StringReplace, ArrayUnshift, globalThis as globalThis$1, KEY__NATIVE_GET_ELEMENT_BY_ID, KEY__NATIVE_QUERY_SELECTOR_ALL, ID_REFERENCING_ATTRIBUTES_SET, KEY__SHADOW_TOKEN, ArrayFilter, StringSplit, ArrayCopyWithin, ArrayFill, ArraySort, ArrayReverse, ArrayShift } from '@lwc/shared';
+/**
+ * Copyright (C) 2023 salesforce.com, inc.
+ */
+import { noop, StringToLowerCase, isNull, ArrayPush as ArrayPush$1, ArrayJoin, isFrozen, isUndefined as isUndefined$1, defineProperty, ArrayIndexOf, ArraySplice, create, seal, isArray as isArray$1, isFunction as isFunction$1, keys, hasOwnProperty as hasOwnProperty$1, forEach, AriaPropNameToAttrNameMap, getPropertyDescriptor, defineProperties, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, assign, isObject, freeze, KEY__SYNTHETIC_MODE, assert, toString as toString$1, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, isFalse, LWC_VERSION_COMMENT_REGEX, LWC_VERSION, getOwnPropertyNames as getOwnPropertyNames$1, htmlPropertyToAttribute, ArraySlice, ArrayMap, KEY__SCOPED_CSS, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, htmlAttributeToProperty, isString, StringSlice, isTrue, SVG_NAMESPACE, KEY__SHADOW_STATIC, KEY__SHADOW_RESOLVER, ArraySome, ArrayPop, isNumber, StringReplace, ArrayUnshift, globalThis as globalThis$1, KEY__NATIVE_GET_ELEMENT_BY_ID, KEY__NATIVE_QUERY_SELECTOR_ALL, ID_REFERENCING_ATTRIBUTES_SET, KEY__SHADOW_TOKEN, ArrayFilter, StringSplit, arrayEvery, ArrayIncludes, ArrayCopyWithin, ArrayFill, ArraySort, ArrayReverse, ArrayShift } from '@lwc/shared';
 import { applyAriaReflection } from '@lwc/aria-reflection';
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
 
@@ -444,19 +446,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.
@@ -495,6 +484,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,
@@ -1324,6 +1314,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
@@ -1487,15 +1485,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);
@@ -1517,9 +1511,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);
@@ -1529,9 +1521,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);
@@ -1913,7 +1903,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,
@@ -2481,6 +2471,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
@@ -2534,14 +2528,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;
     };
@@ -2886,6 +2872,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);
@@ -3327,7 +3321,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);
@@ -3342,7 +3335,6 @@ function patchAttributes(oldVnode, vnode, renderer) {
             else {
                 setAttribute(elm, key, cur);
             }
-            lockAttribute();
         }
     }
 }
@@ -6238,6 +6230,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)) {
@@ -6316,8 +6329,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;
@@ -6348,14 +6372,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;
@@ -6365,8 +6387,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);
             }
         }
     }
@@ -6411,7 +6433,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') {
@@ -6419,10 +6441,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);
@@ -6437,12 +6463,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);
@@ -6868,5 +6897,5 @@ function readonly(obj) {
 }
 
 export { LightningElement, profilerControl as __unstable__ProfilerControl, reportingControl as __unstable__ReportingControl, api$1 as api, connectRootElement, createContextProviderWithRegister, createVM, disconnectRootElement, freezeTemplate, getAssociatedVMIfPresent, getComponentConstructor, getComponentDef, getComponentHtmlPrototype, hydrateRoot, isComponentConstructor, parseFragment, parseSVGFragment, readonly, register, registerComponent, registerDecorators, registerTemplate, sanitizeAttribute, setHooks, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };
-/* version: 2.45.1 */
-//# sourceMappingURL=engine-core.js.map
+/** version: 2.45.3 */
+//# sourceMappingURL=index.js.map