lwc 2.43.0 → 2.44.0

package/dist/engine-dom/umd/es5/engine-dom.js

@@ -323,27 +323,6 @@
       return propertyName;
     }
 
-    /*
-     * 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
-     */
-    var ESCAPED_CHARS = {
-      '"': '"',
-      "'": ''',
-      '<': '&lt;',
-      '>': '&gt;',
-      '&': '&amp;'
-    };
-    function htmlEscape(str) {
-      var attrMode = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
-      var searchValue = attrMode ? /["&]/g : /["'<>&]/g;
-      return str.replace(searchValue, function (char) {
-        return ESCAPED_CHARS[char];
-      });
-    }
-
     /*
      * Copyright (c) 2018, salesforce.com, inc.
      * All rights reserved.
@@ -351,9 +330,9 @@
      * 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
-    var LWC_VERSION = "2.43.0";
+    var LWC_VERSION = "2.44.0";
     var LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-    /** version: 2.43.0 */
+    /** version: 2.44.0 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -433,7 +412,7 @@
         setFeatureFlag(name, value);
       }
     }
-    /** version: 2.43.0 */
+    /** version: 2.44.0 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -497,7 +476,7 @@
         }
       }
     }
-    /** version: 2.43.0 */
+    /** version: 2.44.0 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -964,101 +943,6 @@
      */
     // These properties get added to LWCElement.prototype publicProps automatically
     var defaultDefHTMLPropertyNames = ['accessKey', 'dir', 'draggable', 'hidden', 'id', 'lang', 'spellcheck', 'tabIndex', 'title'];
-    function offsetPropertyErrorMessage(name) {
-      return "Using the `".concat(name, "` property is an anti-pattern because it rounds the value to an integer. Instead, use the `getBoundingClientRect` method to obtain fractional values for the size of an element and its position relative to the viewport.");
-    }
-    // Global HTML Attributes & Properties
-    // https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes
-    // https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement
-    //
-    // If you update this list, check for test files that recapitulate the same list. Searching the codebase
-    // for e.g. "dropzone" should suffice.
-    var globalHTMLProperties = {
-      accessKey: {
-        attribute: 'accesskey'
-      },
-      accessKeyLabel: {
-        readOnly: true
-      },
-      className: {
-        attribute: 'class',
-        error: 'Using the `className` property is an anti-pattern because of slow runtime behavior and potential conflicts with classes provided by the owner element. Use the `classList` API instead.'
-      },
-      contentEditable: {
-        attribute: 'contenteditable'
-      },
-      dataset: {
-        readOnly: true,
-        error: "Using the `dataset` property is an anti-pattern because it can't be statically analyzed. Expose each property individually using the `@api` decorator instead."
-      },
-      dir: {
-        attribute: 'dir'
-      },
-      draggable: {
-        attribute: 'draggable'
-      },
-      dropzone: {
-        attribute: 'dropzone',
-        readOnly: true
-      },
-      hidden: {
-        attribute: 'hidden'
-      },
-      id: {
-        attribute: 'id'
-      },
-      inputMode: {
-        attribute: 'inputmode'
-      },
-      lang: {
-        attribute: 'lang'
-      },
-      slot: {
-        attribute: 'slot',
-        error: 'Using the `slot` property is an anti-pattern.'
-      },
-      spellcheck: {
-        attribute: 'spellcheck'
-      },
-      style: {
-        attribute: 'style'
-      },
-      tabIndex: {
-        attribute: 'tabindex'
-      },
-      title: {
-        attribute: 'title'
-      },
-      translate: {
-        attribute: 'translate'
-      },
-      // additional "global attributes" that are not present in the link above.
-      isContentEditable: {
-        readOnly: true
-      },
-      offsetHeight: {
-        readOnly: true,
-        error: offsetPropertyErrorMessage('offsetHeight')
-      },
-      offsetLeft: {
-        readOnly: true,
-        error: offsetPropertyErrorMessage('offsetLeft')
-      },
-      offsetParent: {
-        readOnly: true
-      },
-      offsetTop: {
-        readOnly: true,
-        error: offsetPropertyErrorMessage('offsetTop')
-      },
-      offsetWidth: {
-        readOnly: true,
-        error: offsetPropertyErrorMessage('offsetWidth')
-      },
-      role: {
-        attribute: 'role'
-      }
-    };
     var controlledElement = null;
     var controlledAttributeName;
     function isAttributeLocked(elm, attrName) {
@@ -1246,8 +1130,7 @@
         }),
         addEventListener: generateDataDescriptor({
           value: function value(type, listener, options) {
-            // TODO [#420]: this is triggered when the component author attempts to add a listener
-            // programmatically into its Component's shadow root
+            // TODO [#1824]: Potentially relax this restriction
             if (!isUndefined$1(options)) {
               logError('The `addEventListener` method on ShadowRoot does not support any options.', getAssociatedVMIfPresent(this));
             }
@@ -1293,8 +1176,7 @@
         }),
         addEventListener: generateDataDescriptor({
           value: function value(type, listener, options) {
-            // TODO [#420]: this is triggered when the component author attempts to add a listener
-            // programmatically into a lighting element node
+            // TODO [#1824]: Potentially relax this restriction
             if (!isUndefined$1(options)) {
               logError('The `addEventListener` method in `LightningElement` does not support any options.', getAssociatedVMIfPresent(this));
             }
@@ -1321,7 +1203,7 @@
     function getLightningElementPrototypeRestrictionsDescriptors(proto) {
       assertNotProd(); // this method should never leak to prod
       var originalDispatchEvent = proto.dispatchEvent;
-      var descriptors = {
+      return {
         dispatchEvent: generateDataDescriptor({
           value: function value(event) {
             var vm = getAssociatedVM(this);
@@ -1337,34 +1219,6 @@
           }
         })
       };
-      forEach.call(getOwnPropertyNames$1(globalHTMLProperties), function (propName) {
-        if (propName in proto) {
-          return; // no need to redefine something that we are already exposing
-        }
-
-        descriptors[propName] = generateAccessorDescriptor({
-          get: function get() {
-            var _globalHTMLProperties = globalHTMLProperties[propName],
-              error = _globalHTMLProperties.error,
-              attribute = _globalHTMLProperties.attribute;
-            var msg = [];
-            msg.push("Accessing the global HTML property \"".concat(propName, "\" is disabled."));
-            if (error) {
-              msg.push(error);
-            } else if (attribute) {
-              msg.push("Instead access it via `this.getAttribute(\"".concat(attribute, "\")`."));
-            }
-            logError(msg.join('\n'), getAssociatedVM(this));
-          },
-          set: function set() {
-            var readOnly = globalHTMLProperties[propName].readOnly;
-            if (readOnly) {
-              logError("The global HTML property `".concat(propName, "` is read-only."), getAssociatedVM(this));
-            }
-          }
-        });
-      });
-      return descriptors;
     }
     // This routine will prevent access to certain properties on a shadow root instance to guarantee
     // that all components will work fine in IE11 and other browsers without shadow dom support.
@@ -2879,12 +2733,7 @@
         _set2 = descriptor.set,
         enumerable = descriptor.enumerable,
         configurable = descriptor.configurable;
-      if (!isFunction$1(_get2)) {
-        if (process.env.NODE_ENV !== 'production') {
-          assert.invariant(isFunction$1(_get2), "Invalid compiler output for public accessor ".concat(toString$1(key), " decorated with @api"));
-        }
-        throw new Error();
-      }
+      assert.invariant(isFunction$1(_get2), "Invalid public accessor ".concat(toString$1(key), " decorated with @api. The property is missing a getter."));
       return {
         get: function get() {
           if (process.env.NODE_ENV !== 'production') {
@@ -3004,60 +2853,63 @@
     }
 
     function validateObservedField(Ctor, fieldName, descriptor) {
+      assertNotProd(); // this method should never leak to prod
       if (!isUndefined$1(descriptor)) {
         var type = getClassDescriptorType(descriptor);
         var message = "Invalid observed ".concat(fieldName, " field. Found a duplicate ").concat(type, " with the same name.");
-        // [W-9927596] Ideally we always throw an error when detecting duplicate observed field.
-        // This branch is only here for backward compatibility reasons.
-        if (type === "accessor" /* DescriptorType.Accessor */) {
-          logError(message);
-        } else {
-          assert.fail(message);
-        }
+        // TODO [#3408]: this should throw, not log
+        logError(message);
       }
     }
     function validateFieldDecoratedWithTrack(Ctor, fieldName, descriptor) {
+      assertNotProd(); // this method should never leak to prod
       if (!isUndefined$1(descriptor)) {
         var type = getClassDescriptorType(descriptor);
-        assert.fail("Invalid @track ".concat(fieldName, " field. Found a duplicate ").concat(type, " with the same name."));
+        // TODO [#3408]: this should throw, not log
+        logError("Invalid @track ".concat(fieldName, " field. Found a duplicate ").concat(type, " with the same name."));
       }
     }
     function validateFieldDecoratedWithWire(Ctor, fieldName, descriptor) {
+      assertNotProd(); // this method should never leak to prod
       if (!isUndefined$1(descriptor)) {
         var type = getClassDescriptorType(descriptor);
-        assert.fail("Invalid @wire ".concat(fieldName, " field. Found a duplicate ").concat(type, " with the same name."));
+        // TODO [#3408]: this should throw, not log
+        logError("Invalid @wire ".concat(fieldName, " field. Found a duplicate ").concat(type, " with the same name."));
       }
     }
     function validateMethodDecoratedWithWire(Ctor, methodName, descriptor) {
+      assertNotProd(); // this method should never leak to prod
       if (isUndefined$1(descriptor) || !isFunction$1(descriptor.value) || isFalse(descriptor.writable)) {
-        assert.fail("Invalid @wire ".concat(methodName, " method."));
+        // TODO [#3441]: This line of code does not seem possible to reach.
+        logError("Invalid @wire ".concat(methodName, " field. The field should have a valid writable descriptor."));
       }
     }
     function validateFieldDecoratedWithApi(Ctor, fieldName, descriptor) {
+      assertNotProd(); // this method should never leak to prod
       if (!isUndefined$1(descriptor)) {
         var type = getClassDescriptorType(descriptor);
         var message = "Invalid @api ".concat(fieldName, " field. Found a duplicate ").concat(type, " with the same name.");
-        // [W-9927596] Ideally we always throw an error when detecting duplicate public properties.
-        // This branch is only here for backward compatibility reasons.
-        if (type === "accessor" /* DescriptorType.Accessor */) {
-          logError(message);
-        } else {
-          assert.fail(message);
-        }
+        // TODO [#3408]: this should throw, not log
+        logError(message);
       }
     }
     function validateAccessorDecoratedWithApi(Ctor, fieldName, descriptor) {
-      if (isUndefined$1(descriptor)) {
-        assert.fail("Invalid @api get ".concat(fieldName, " accessor."));
-      } else if (isFunction$1(descriptor.set)) {
-        assert.isTrue(isFunction$1(descriptor.get), "Missing getter for property ".concat(fieldName, " decorated with @api in ").concat(Ctor, ". You cannot have a setter without the corresponding getter."));
+      assertNotProd(); // this method should never leak to prod
+      if (isFunction$1(descriptor.set)) {
+        if (!isFunction$1(descriptor.get)) {
+          // TODO [#3441]: This line of code does not seem possible to reach.
+          logError("Missing getter for property ".concat(fieldName, " decorated with @api in ").concat(Ctor, ". You cannot have a setter without the corresponding getter."));
+        }
       } else if (!isFunction$1(descriptor.get)) {
-        assert.fail("Missing @api get ".concat(fieldName, " accessor."));
+        // TODO [#3441]: This line of code does not seem possible to reach.
+        logError("Missing @api get ".concat(fieldName, " accessor."));
       }
     }
     function validateMethodDecoratedWithApi(Ctor, methodName, descriptor) {
+      assertNotProd(); // this method should never leak to prod
       if (isUndefined$1(descriptor) || !isFunction$1(descriptor.value) || isFalse(descriptor.writable)) {
-        assert.fail("Invalid @api ".concat(methodName, " method."));
+        // TODO [#3441]: This line of code does not seem possible to reach.
+        logError("Invalid @api ".concat(methodName, " method."));
       }
     }
     /**
@@ -3084,13 +2936,14 @@
           apiFieldsConfig[fieldName] = propConfig.config;
           descriptor = getOwnPropertyDescriptor$1(proto, fieldName);
           if (propConfig.config > 0) {
+            if (isUndefined$1(descriptor)) {
+              // TODO [#3441]: This line of code does not seem possible to reach.
+              throw new Error();
+            }
             // accessor declaration
             if (process.env.NODE_ENV !== 'production') {
               validateAccessorDecoratedWithApi(Ctor, fieldName, descriptor);
             }
-            if (isUndefined$1(descriptor)) {
-              throw new Error();
-            }
             descriptor = createPublicAccessorDescriptor(fieldName, descriptor);
           } else {
             // field declaration
@@ -3133,7 +2986,10 @@
           descriptor = getOwnPropertyDescriptor$1(proto, fieldOrMethodName);
           if (method === 1) {
             if (process.env.NODE_ENV !== 'production') {
-              assert.isTrue(adapter, "@wire on method \"".concat(fieldOrMethodName, "\": adapter id must be truthy."));
+              if (!adapter) {
+                // TODO [#3408]: this should throw, not log
+                logError("@wire on method \"".concat(fieldOrMethodName, "\": adapter id must be truthy."));
+              }
               validateMethodDecoratedWithWire(Ctor, fieldOrMethodName, descriptor);
             }
             if (isUndefined$1(descriptor)) {
@@ -3143,7 +2999,10 @@
             storeWiredMethodMeta(descriptor, adapter, configCallback, dynamic);
           } else {
             if (process.env.NODE_ENV !== 'production') {
-              assert.isTrue(adapter, "@wire on field \"".concat(fieldOrMethodName, "\": adapter id must be truthy."));
+              if (!adapter) {
+                // TODO [#3408]: this should throw, not log
+                logError("@wire on field \"".concat(fieldOrMethodName, "\": adapter id must be truthy."));
+              }
               validateFieldDecoratedWithWire(Ctor, fieldOrMethodName, descriptor);
             }
             descriptor = internalWireFieldDecorator(fieldOrMethodName);
@@ -7149,8 +7008,6 @@
       return renderer.nextSibling(hydratedNode);
     }
     var NODE_VALUE_PROP = 'nodeValue';
-    var PARENT_NODE_PROP = 'parentNode';
-    var TAG_NAME_PROP = 'tagName';
     function textNodeContentsAreEqual(node, vnode, renderer) {
       var getProperty = renderer.getProperty;
       var nodeValue = getProperty(node, NODE_VALUE_PROP);
@@ -7162,22 +7019,6 @@
       if (nodeValue === "\u200D" && vnode.text === '') {
         return true;
       }
-      // Special case for text nodes inside `<style>` tags – these are escaped when rendered server-size,
-      // but not when generated by the engine client-side.
-      var parentNode = getProperty(node, PARENT_NODE_PROP);
-      // Should never be null, but just to be safe, we check.
-      /* istanbul ignore else */
-      if (!isNull(parentNode)) {
-        var tagName = getProperty(parentNode, TAG_NAME_PROP);
-        // If the tagName is STYLE, then the following condition should always be true.
-        // The LWC compiler blocks using `<style>`s inside of templates, so it should be impossible
-        // for component authors to render different `<style>` text content on the client and server.
-        // But just to be safe, we check.
-        /* istanbul ignore next */
-        if (tagName === 'STYLE' && htmlEscape(vnode.text) === nodeValue) {
-          return true;
-        }
-      }
       return false;
     }
     function hydrateText(node, vnode, renderer) {
@@ -7837,12 +7678,12 @@
       if (process.env.NODE_ENV !== 'production') {
         // TODO [#1292]: Remove the readonly decorator
         if (arguments.length !== 1) {
-          assert.fail('@readonly cannot be used as a decorator just yet, use it as a function with one argument to produce a readonly version of the provided value.');
+          logError('@readonly cannot be used as a decorator just yet, use it as a function with one argument to produce a readonly version of the provided value.');
         }
       }
       return getReadOnlyProxy(obj);
     }
-    /* version: 2.43.0 */
+    /* version: 2.44.0 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -8268,7 +8109,7 @@
         function isNull(obj) {
           return obj === null;
         }
-        /** version: 2.43.0 */
+        /** version: 2.44.0 */
 
         /*
          * Copyright (c) 2023, salesforce.com, inc.
@@ -8910,7 +8751,7 @@
         });
       });
     }
-    /* version: 2.43.0 */
+    /* version: 2.44.0 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;