lwc 2.37.1 → 2.37.3

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

@@ -322,6 +322,24 @@ function htmlAttributeToProperty(attrName) {
     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
+ */
+const ESCAPED_CHARS = {
+    '"': '"',
+    "'": ''',
+    '<': '&lt;',
+    '>': '&gt;',
+    '&': '&amp;',
+};
+function htmlEscape(str, attrMode = false) {
+    const searchValue = attrMode ? /["&]/g : /["'<>&]/g;
+    return str.replace(searchValue, (char) => ESCAPED_CHARS[char]);
+}
+
 /*
  * Copyright (c) 2018, salesforce.com, inc.
  * All rights reserved.
@@ -329,9 +347,9 @@ 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.37.1";
+const LWC_VERSION = "2.37.3";
 const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-/** version: 2.37.1 */
+/** version: 2.37.3 */
 
 /**
  * Copyright (C) 2018 salesforce.com, inc.
@@ -410,7 +428,7 @@ function setFeatureFlagForTest(name, value) {
         setFeatureFlag(name, value);
     }
 }
-/** version: 2.37.1 */
+/** version: 2.37.3 */
 
 /**
  * Copyright (C) 2018 salesforce.com, inc.
@@ -474,7 +492,7 @@ function applyAriaReflection(prototype = Element.prototype) {
         }
     }
 }
-/** version: 2.37.1 */
+/** version: 2.37.3 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -2993,7 +3011,7 @@ function checkVersionMismatch(func, type) {
             // stylesheets and templates do not have user-meaningful names, but components do
             const friendlyName = type === 'component' ? `${type} ${func.name}` : type;
             logError(`LWC WARNING: current engine is v${LWC_VERSION}, but ${friendlyName} was compiled with v${version}.\nPlease update your compiled code or LWC engine so that the versions match.\nNo further warnings will appear.`);
-            report(1 /* ReportingEventId.CompilerRuntimeVersionMismatch */, {
+            report("CompilerRuntimeVersionMismatch" /* ReportingEventId.CompilerRuntimeVersionMismatch */, {
                 compilerVersion: version,
                 runtimeVersion: LWC_VERSION,
             });
@@ -6347,7 +6365,7 @@ function reportViolation$1(source, target, attrName) {
         // vm should never be undefined here, but just to be safe, bail out and don't report
         return;
     }
-    report(0 /* ReportingEventId.CrossRootAriaInSyntheticShadow */, {
+    report("CrossRootAriaInSyntheticShadow" /* ReportingEventId.CrossRootAriaInSyntheticShadow */, {
         tagName: vm.tagName,
         attributeName: attrName,
     });
@@ -6527,7 +6545,7 @@ function checkAndReportViolation(elm, prop, isSetter, setValue) {
             // https://github.com/salesforce/lwc/issues/3284
             setValueType = isNull(setValue) ? 'null' : typeof setValue;
         }
-        report(2 /* ReportingEventId.NonStandardAriaReflection */, {
+        report("NonStandardAriaReflection" /* ReportingEventId.NonStandardAriaReflection */, {
             tagName: vm === null || vm === void 0 ? void 0 : vm.tagName,
             propertyName: prop,
             isSetter,
@@ -6694,15 +6712,44 @@ function hydrateNode(node, vnode, renderer) {
     return renderer.nextSibling(hydratedNode);
 }
 const NODE_VALUE_PROP = 'nodeValue';
+const PARENT_NODE_PROP = 'parentNode';
+const TAG_NAME_PROP = 'tagName';
+function textNodeContentsAreEqual(node, vnode, renderer) {
+    const { getProperty } = renderer;
+    const nodeValue = getProperty(node, NODE_VALUE_PROP);
+    if (nodeValue === vnode.text) {
+        return true;
+    }
+    // Special case for empty text nodes – these are serialized differently on the server
+    // See https://github.com/salesforce/lwc/pull/2656
+    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.
+    const parentNode = getProperty(node, PARENT_NODE_PROP);
+    // Should never be null, but just to be safe, we check.
+    /* istanbul ignore else */
+    if (!isNull(parentNode)) {
+        const 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) {
     var _a;
     if (!hasCorrectNodeType(vnode, node, 3 /* EnvNodeTypes.TEXT */, renderer)) {
         return handleMismatch(node, vnode, renderer);
     }
     if (process.env.NODE_ENV !== 'production') {
-        const { getProperty } = renderer;
-        const nodeValue = getProperty(node, NODE_VALUE_PROP);
-        if (nodeValue !== vnode.text && !(nodeValue === '\u200D' && vnode.text === '')) {
+        if (!textNodeContentsAreEqual(node, vnode, renderer)) {
             logWarn('Hydration mismatch: text values do not match, will recover from the difference', vnode.owner);
         }
     }
@@ -6882,6 +6929,19 @@ function isMatchingElement(vnode, elm, renderer) {
     const hasIncompatibleStyle = validateStyleAttr(vnode, elm, renderer);
     return hasIncompatibleAttrs && hasIncompatibleClass && hasIncompatibleStyle;
 }
+function attributeValuesAreEqual(vnodeValue, value) {
+    const vnodeValueAsString = String(vnodeValue);
+    if (vnodeValueAsString === value) {
+        return true;
+    }
+    // If the expected value is null, this means that the attribute does not exist. In that case,
+    // we accept any nullish value (undefined or null).
+    if (isNull(value) && (isUndefined$1(vnodeValue) || isNull(vnodeValue))) {
+        return true;
+    }
+    // In all other cases, the two values are not considered equal
+    return false;
+}
 function validateAttrs(vnode, elm, renderer) {
     const { data: { attrs = {} }, } = vnode;
     let nodesAreCompatible = true;
@@ -6891,10 +6951,10 @@ function validateAttrs(vnode, elm, renderer) {
         const { owner } = vnode;
         const { getAttribute } = renderer;
         const elmAttrValue = getAttribute(elm, attrName);
-        if (String(attrValue) !== elmAttrValue) {
+        if (!attributeValuesAreEqual(attrValue, elmAttrValue)) {
             if (process.env.NODE_ENV !== 'production') {
                 const { getProperty } = renderer;
-                logError(`Mismatch hydrating element <${getProperty(elm, 'tagName').toLowerCase()}>: attribute "${attrName}" has different values, expected "${attrValue}" but found "${elmAttrValue}"`, owner);
+                logError(`Mismatch hydrating element <${getProperty(elm, 'tagName').toLowerCase()}>: attribute "${attrName}" has different values, expected "${attrValue}" but found ${isNull(elmAttrValue) ? 'null' : `"${elmAttrValue}"`}`, owner);
             }
             nodesAreCompatible = false;
         }
@@ -7113,10 +7173,10 @@ function reportViolation(type, eventId, prop) {
     report(eventId, { propertyName: prop });
 }
 function reportTemplateViolation(prop) {
-    reportViolation('template', 3 /* ReportingEventId.TemplateMutation */, prop);
+    reportViolation('template', "TemplateMutation" /* ReportingEventId.TemplateMutation */, prop);
 }
 function reportStylesheetViolation(prop) {
-    reportViolation('stylesheet', 4 /* ReportingEventId.StylesheetMutation */, prop);
+    reportViolation('stylesheet', "StylesheetMutation" /* ReportingEventId.StylesheetMutation */, prop);
 }
 // Warn if the user tries to mutate a stylesheets array, e.g.:
 // `tmpl.stylesheets.push(someStylesheetFunction)`
@@ -7288,7 +7348,7 @@ function getComponentConstructor(elm) {
     }
     return ctor;
 }
-/* version: 2.37.1 */
+/* version: 2.37.3 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -7716,7 +7776,7 @@ function rendererFactory(baseRenderer) {
     function isNull(obj) {
         return obj === null;
     }
-    /** version: 2.37.1 */
+    /** version: 2.37.3 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -8269,6 +8329,6 @@ defineProperty(LightningElement, 'CustomElementConstructor', {
 });
 freeze(LightningElement);
 seal(LightningElement.prototype);
-/* version: 2.37.1 */
+/* version: 2.37.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 };

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

@@ -325,6 +325,24 @@ var LWC = (function (exports) {
         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
+     */
+    const ESCAPED_CHARS = {
+        '"': '"',
+        "'": ''',
+        '<': '&lt;',
+        '>': '&gt;',
+        '&': '&amp;',
+    };
+    function htmlEscape(str, attrMode = false) {
+        const searchValue = attrMode ? /["&]/g : /["'<>&]/g;
+        return str.replace(searchValue, (char) => ESCAPED_CHARS[char]);
+    }
+
     /*
      * Copyright (c) 2018, salesforce.com, inc.
      * All rights reserved.
@@ -332,9 +350,9 @@ var LWC = (function (exports) {
      * 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.37.1";
+    const LWC_VERSION = "2.37.3";
     const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-    /** version: 2.37.1 */
+    /** version: 2.37.3 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -413,7 +431,7 @@ var LWC = (function (exports) {
             setFeatureFlag(name, value);
         }
     }
-    /** version: 2.37.1 */
+    /** version: 2.37.3 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -477,7 +495,7 @@ var LWC = (function (exports) {
             }
         }
     }
-    /** version: 2.37.1 */
+    /** version: 2.37.3 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -2996,7 +3014,7 @@ var LWC = (function (exports) {
                 // stylesheets and templates do not have user-meaningful names, but components do
                 const friendlyName = type === 'component' ? `${type} ${func.name}` : type;
                 logError(`LWC WARNING: current engine is v${LWC_VERSION}, but ${friendlyName} was compiled with v${version}.\nPlease update your compiled code or LWC engine so that the versions match.\nNo further warnings will appear.`);
-                report(1 /* ReportingEventId.CompilerRuntimeVersionMismatch */, {
+                report("CompilerRuntimeVersionMismatch" /* ReportingEventId.CompilerRuntimeVersionMismatch */, {
                     compilerVersion: version,
                     runtimeVersion: LWC_VERSION,
                 });
@@ -6350,7 +6368,7 @@ var LWC = (function (exports) {
             // vm should never be undefined here, but just to be safe, bail out and don't report
             return;
         }
-        report(0 /* ReportingEventId.CrossRootAriaInSyntheticShadow */, {
+        report("CrossRootAriaInSyntheticShadow" /* ReportingEventId.CrossRootAriaInSyntheticShadow */, {
             tagName: vm.tagName,
             attributeName: attrName,
         });
@@ -6530,7 +6548,7 @@ var LWC = (function (exports) {
                 // https://github.com/salesforce/lwc/issues/3284
                 setValueType = isNull(setValue) ? 'null' : typeof setValue;
             }
-            report(2 /* ReportingEventId.NonStandardAriaReflection */, {
+            report("NonStandardAriaReflection" /* ReportingEventId.NonStandardAriaReflection */, {
                 tagName: vm === null || vm === void 0 ? void 0 : vm.tagName,
                 propertyName: prop,
                 isSetter,
@@ -6697,15 +6715,44 @@ var LWC = (function (exports) {
         return renderer.nextSibling(hydratedNode);
     }
     const NODE_VALUE_PROP = 'nodeValue';
+    const PARENT_NODE_PROP = 'parentNode';
+    const TAG_NAME_PROP = 'tagName';
+    function textNodeContentsAreEqual(node, vnode, renderer) {
+        const { getProperty } = renderer;
+        const nodeValue = getProperty(node, NODE_VALUE_PROP);
+        if (nodeValue === vnode.text) {
+            return true;
+        }
+        // Special case for empty text nodes – these are serialized differently on the server
+        // See https://github.com/salesforce/lwc/pull/2656
+        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.
+        const parentNode = getProperty(node, PARENT_NODE_PROP);
+        // Should never be null, but just to be safe, we check.
+        /* istanbul ignore else */
+        if (!isNull(parentNode)) {
+            const 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) {
         var _a;
         if (!hasCorrectNodeType(vnode, node, 3 /* EnvNodeTypes.TEXT */, renderer)) {
             return handleMismatch(node, vnode, renderer);
         }
         if (process.env.NODE_ENV !== 'production') {
-            const { getProperty } = renderer;
-            const nodeValue = getProperty(node, NODE_VALUE_PROP);
-            if (nodeValue !== vnode.text && !(nodeValue === '\u200D' && vnode.text === '')) {
+            if (!textNodeContentsAreEqual(node, vnode, renderer)) {
                 logWarn('Hydration mismatch: text values do not match, will recover from the difference', vnode.owner);
             }
         }
@@ -6885,6 +6932,19 @@ var LWC = (function (exports) {
         const hasIncompatibleStyle = validateStyleAttr(vnode, elm, renderer);
         return hasIncompatibleAttrs && hasIncompatibleClass && hasIncompatibleStyle;
     }
+    function attributeValuesAreEqual(vnodeValue, value) {
+        const vnodeValueAsString = String(vnodeValue);
+        if (vnodeValueAsString === value) {
+            return true;
+        }
+        // If the expected value is null, this means that the attribute does not exist. In that case,
+        // we accept any nullish value (undefined or null).
+        if (isNull(value) && (isUndefined$1(vnodeValue) || isNull(vnodeValue))) {
+            return true;
+        }
+        // In all other cases, the two values are not considered equal
+        return false;
+    }
     function validateAttrs(vnode, elm, renderer) {
         const { data: { attrs = {} }, } = vnode;
         let nodesAreCompatible = true;
@@ -6894,10 +6954,10 @@ var LWC = (function (exports) {
             const { owner } = vnode;
             const { getAttribute } = renderer;
             const elmAttrValue = getAttribute(elm, attrName);
-            if (String(attrValue) !== elmAttrValue) {
+            if (!attributeValuesAreEqual(attrValue, elmAttrValue)) {
                 if (process.env.NODE_ENV !== 'production') {
                     const { getProperty } = renderer;
-                    logError(`Mismatch hydrating element <${getProperty(elm, 'tagName').toLowerCase()}>: attribute "${attrName}" has different values, expected "${attrValue}" but found "${elmAttrValue}"`, owner);
+                    logError(`Mismatch hydrating element <${getProperty(elm, 'tagName').toLowerCase()}>: attribute "${attrName}" has different values, expected "${attrValue}" but found ${isNull(elmAttrValue) ? 'null' : `"${elmAttrValue}"`}`, owner);
                 }
                 nodesAreCompatible = false;
             }
@@ -7116,10 +7176,10 @@ var LWC = (function (exports) {
         report(eventId, { propertyName: prop });
     }
     function reportTemplateViolation(prop) {
-        reportViolation('template', 3 /* ReportingEventId.TemplateMutation */, prop);
+        reportViolation('template', "TemplateMutation" /* ReportingEventId.TemplateMutation */, prop);
     }
     function reportStylesheetViolation(prop) {
-        reportViolation('stylesheet', 4 /* ReportingEventId.StylesheetMutation */, prop);
+        reportViolation('stylesheet', "StylesheetMutation" /* ReportingEventId.StylesheetMutation */, prop);
     }
     // Warn if the user tries to mutate a stylesheets array, e.g.:
     // `tmpl.stylesheets.push(someStylesheetFunction)`
@@ -7291,7 +7351,7 @@ var LWC = (function (exports) {
         }
         return ctor;
     }
-    /* version: 2.37.1 */
+    /* version: 2.37.3 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -7719,7 +7779,7 @@ var LWC = (function (exports) {
         function isNull(obj) {
             return obj === null;
         }
-        /** version: 2.37.1 */
+        /** version: 2.37.3 */
 
         /*
          * Copyright (c) 2018, salesforce.com, inc.
@@ -8272,7 +8332,7 @@ var LWC = (function (exports) {
     });
     freeze(LightningElement);
     seal(LightningElement.prototype);
-    /* version: 2.37.1 */
+    /* version: 2.37.3 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;