lwc 2.5.3 → 2.5.7

package/dist/engine-server/commonjs/es2017/engine-server.js

@@ -339,7 +339,7 @@ function htmlPropertyToAttribute(propName) {
   CACHED_PROPERTY_ATTRIBUTE_MAPPING.set(propName, attributeName);
   return attributeName;
 }
-/** version: 2.5.3 */
+/** version: 2.5.7 */
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -460,7 +460,7 @@ function setFeatureFlagForTest(name, value) {
     setFeatureFlag(name, value);
   }
 }
-/** version: 2.5.3 */
+/** version: 2.5.7 */
 
 /* proxy-compat-disable */
 
@@ -2832,9 +2832,9 @@ function attachShadow(vm) {
   }
 }
 
-function warnIfInvokedDuringConstruction(vm, methodName) {
+function warnIfInvokedDuringConstruction(vm, methodOrPropName) {
   if (isBeingConstructed(vm)) {
-    logError(`this.${methodName}() should not be called during the construction of the custom element for ${getComponentTag(vm)} because the element is not yet in the DOM or has no children yet.`);
+    logError(`this.${methodOrPropName} should not be called during the construction of the custom element for ${getComponentTag(vm)} because the element is not yet in the DOM or has no children yet.`);
   }
 } // @ts-ignore
 
@@ -2994,76 +2994,12 @@ LightningElement.prototype = {
     } = vm;
 
     if (process.env.NODE_ENV !== 'production') {
-      warnIfInvokedDuringConstruction(vm, 'getBoundingClientRect');
+      warnIfInvokedDuringConstruction(vm, 'getBoundingClientRect()');
     }
 
     return getBoundingClientRect(elm);
   },
 
-  querySelector(selectors) {
-    const vm = getAssociatedVM(this);
-    const {
-      elm,
-      renderer: {
-        querySelector
-      }
-    } = vm;
-
-    if (process.env.NODE_ENV !== 'production') {
-      warnIfInvokedDuringConstruction(vm, 'querySelector');
-    }
-
-    return querySelector(elm, selectors);
-  },
-
-  querySelectorAll(selectors) {
-    const vm = getAssociatedVM(this);
-    const {
-      elm,
-      renderer: {
-        querySelectorAll
-      }
-    } = vm;
-
-    if (process.env.NODE_ENV !== 'production') {
-      warnIfInvokedDuringConstruction(vm, 'querySelectorAll');
-    }
-
-    return querySelectorAll(elm, selectors);
-  },
-
-  getElementsByTagName(tagNameOrWildCard) {
-    const vm = getAssociatedVM(this);
-    const {
-      elm,
-      renderer: {
-        getElementsByTagName
-      }
-    } = vm;
-
-    if (process.env.NODE_ENV !== 'production') {
-      warnIfInvokedDuringConstruction(vm, 'getElementsByTagName');
-    }
-
-    return getElementsByTagName(elm, tagNameOrWildCard);
-  },
-
-  getElementsByClassName(names) {
-    const vm = getAssociatedVM(this);
-    const {
-      elm,
-      renderer: {
-        getElementsByClassName
-      }
-    } = vm;
-
-    if (process.env.NODE_ENV !== 'production') {
-      warnIfInvokedDuringConstruction(vm, 'getElementsByClassName');
-    }
-
-    return getElementsByClassName(elm, names);
-  },
-
   get isConnected() {
     const {
       elm,
@@ -3123,6 +3059,55 @@ LightningElement.prototype = {
   }
 
 };
+const queryAndChildGetterDescriptors = create(null);
+const childGetters = [['children', 'getChildren'], ['childNodes', 'getChildNodes'], ['firstChild', 'getFirstChild'], ['firstElementChild', 'getFirstElementChild'], ['lastChild', 'getLastChild'], ['lastElementChild', 'getLastElementChild']]; // Generic passthrough for child getters on HTMLElement to the relevant Renderer APIs
+
+for (const [elementProp, rendererMethod] of childGetters) {
+  queryAndChildGetterDescriptors[elementProp] = {
+    get() {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer
+      } = vm;
+
+      if (process.env.NODE_ENV !== 'production') {
+        warnIfInvokedDuringConstruction(vm, elementProp);
+      }
+
+      return renderer[rendererMethod](elm);
+    },
+
+    configurable: true,
+    enumerable: true
+  };
+}
+
+const queryMethods = ['getElementsByClassName', 'getElementsByTagName', 'querySelector', 'querySelectorAll']; // Generic passthrough for query APIs on HTMLElement to the relevant Renderer APIs
+
+for (const queryMethod of queryMethods) {
+  queryAndChildGetterDescriptors[queryMethod] = {
+    value(arg) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer
+      } = vm;
+
+      if (process.env.NODE_ENV !== 'production') {
+        warnIfInvokedDuringConstruction(vm, `${queryMethod}()`);
+      }
+
+      return renderer[queryMethod](elm, arg);
+    },
+
+    configurable: true,
+    enumerable: true,
+    writable: true
+  };
+}
+
+defineProperties(LightningElement.prototype, queryAndChildGetterDescriptors);
 const lightningBasedDescriptors = create(null);
 
 for (const propName in HTMLElementOriginalDescriptors) {
@@ -3713,15 +3698,14 @@ function registerTemplate(tpl) {
   return tpl;
 }
 /**
- * EXPERIMENTAL: This function acts like a hook for Lightning Locker
- * Service and other similar libraries to sanitize vulnerable attributes.
- * This API is subject to change or being removed.
+ * EXPERIMENTAL: This function acts like a hook for Lightning Locker Service and other similar
+ * libraries to sanitize vulnerable attributes.
  */
 
 
 function sanitizeAttribute(tagName, namespaceUri, attrName, attrValue) {
-  // locker-service patches this function during runtime to sanitize vulnerable attributes.
-  // when ran off-core this function becomes a noop and returns the user authored value.
+  // locker-service patches this function during runtime to sanitize vulnerable attributes. When
+  // ran off-core this function becomes a noop and returns the user authored value.
   return attrValue;
 }
 /*
@@ -4157,7 +4141,7 @@ function createComponentDef(Ctor) {
     if (!isUndefined$1(ctorShadowSupportMode)) {
       assert.invariant(ctorShadowSupportMode === "any"
       /* Any */
-      || ctorShadowSupportMode === "default"
+      || ctorShadowSupportMode === "reset"
       /* Default */
       , `Invalid value for static property shadowSupportMode: '${ctorShadowSupportMode}'`);
     }
@@ -4319,7 +4303,7 @@ const lightingElementDef = {
   renderMode: 1
   /* Shadow */
   ,
-  shadowSupportMode: "default"
+  shadowSupportMode: "reset"
   /* Default */
   ,
   wire: EmptyObject,
@@ -5097,7 +5081,7 @@ function i(iterable, factory) {
     next = iterator.next();
     last = next.done; // template factory logic based on the previous collected value
 
-    const vnode = factory(value, j, j === 0, last);
+    const vnode = factory(value, j, j === 0, last === true);
 
     if (isArray$1(vnode)) {
       ArrayPush$1.apply(list, vnode);
@@ -5364,24 +5348,48 @@ function sc(vnodes) {
   markAsDynamicChildren(vnodes);
   return vnodes;
 }
+/**
+ * EXPERIMENTAL: This function acts like a hook for Lightning Locker Service and other similar
+ * libraries to sanitize HTML content. This hook process the content passed via the template to
+ * lwc:inner-html directive.
+ * It is meant to be overridden with setSanitizeHtmlContentHook, it throws an error by default.
+ */
 
-var api = /*#__PURE__*/Object.freeze({
-  __proto__: null,
-  h: h,
-  ti: ti,
-  s: s,
-  c: c,
-  i: i,
-  f: f,
-  t: t,
-  co: co,
-  d: d,
-  b: b,
-  k: k,
-  gid: gid,
-  fid: fid,
-  dc: dc,
-  sc: sc
+
+let sanitizeHtmlContentHook = () => {
+  // locker-service patches this function during runtime to sanitize HTML content.
+  throw new Error('sanitizeHtmlContent hook must be implemented.');
+};
+/**
+ * Sets the sanitizeHtmlContentHook.
+ */
+
+
+function setSanitizeHtmlContentHook(newHookImpl) {
+  sanitizeHtmlContentHook = newHookImpl;
+} // [s]anitize [h]tml [c]ontent
+
+
+function shc(content) {
+  return sanitizeHtmlContentHook(content);
+}
+
+const api = freeze({
+  s,
+  h,
+  c,
+  i,
+  f,
+  t,
+  d,
+  b,
+  k,
+  co,
+  dc,
+  ti,
+  gid,
+  fid,
+  shc
 });
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -5395,12 +5403,12 @@ function makeHostToken(token) {
 }
 
 function createInlineStyleVNode(content) {
-  return h('style', {
+  return api.h('style', {
     key: 'style',
     attrs: {
       type: 'text/css'
     }
-  }, [t(content)]);
+  }, [api.t(content)]);
 }
 
 function updateStylesheetToken(vm, template) {
@@ -7164,7 +7172,22 @@ function readonly(obj) {
 
   return reactiveMembrane.getReadOnlyProxy(obj);
 }
-/* version: 2.5.3 */
+/*
+ * Copyright (c) 2018, 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
+ */
+
+
+let hooksAreSet = false;
+
+function setHooks(hooks) {
+  assert.isFalse(hooksAreSet, 'Hooks are already overridden, only one definition is allowed.');
+  hooksAreSet = true;
+  setSanitizeHtmlContentHook(hooks.sanitizeHtmlContent);
+}
+/* version: 2.5.7 */
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -7179,6 +7202,7 @@ var HostNodeType;
 (function (HostNodeType) {
   HostNodeType["Text"] = "text";
   HostNodeType["Comment"] = "comment";
+  HostNodeType["Raw"] = "raw";
   HostNodeType["Element"] = "element";
   HostNodeType["ShadowRoot"] = "shadow-root";
 })(HostNodeType || (HostNodeType = {}));
@@ -7193,7 +7217,7 @@ var HostNodeType;
 const CLASSNAMES_SEPARATOR = /\s+/g;
 
 function classNameToTokenList(value) {
-  return new Set(value.trim().split(CLASSNAMES_SEPARATOR));
+  return new Set(value.split(CLASSNAMES_SEPARATOR).filter(str => str.length));
 }
 
 function tokenListToClassName(values) {
@@ -7358,7 +7382,17 @@ const renderer = {
     }
 
     if (node.type === HostNodeType.Element) {
-      const attrName = htmlPropertyToAttribute(key); // Handle all the boolean properties.
+      const attrName = htmlPropertyToAttribute(key);
+
+      if (key === 'innerHTML') {
+        node.children = [{
+          type: HostNodeType.Raw,
+          parent: node,
+          value
+        }];
+        return;
+      } // Handle all the boolean properties.
+
 
       if (isBooleanAttribute(attrName, node.name)) {
         return value === true ? this.setAttribute(node, attrName, '') : this.removeAttribute(node, attrName);
@@ -7452,18 +7486,18 @@ const renderer = {
   },
 
   setCSSStyleProperty(element, name, value, important) {
-    let styleAttribute = element.attributes.find(attr => attr.name === 'style' && isNull(attr.namespace));
+    const styleAttribute = element.attributes.find(attr => attr.name === 'style' && isNull(attr.namespace));
+    const serializedProperty = `${name}: ${value}${important ? ' !important' : ''}`;
 
     if (isUndefined$1(styleAttribute)) {
-      styleAttribute = {
+      element.attributes.push({
         name: 'style',
         namespace: null,
-        value: ''
-      };
-      element.attributes.push(styleAttribute);
+        value: serializedProperty
+      });
+    } else {
+      styleAttribute.value += `; ${serializedProperty}`;
     }
-
-    styleAttribute.value = `${styleAttribute.value}; ${name}: ${value}${important ? ' !important' : ''}`;
   },
 
   isConnected(node) {
@@ -7490,6 +7524,12 @@ const renderer = {
   querySelectorAll: unsupportedMethod('querySelectorAll'),
   getElementsByTagName: unsupportedMethod('getElementsByTagName'),
   getElementsByClassName: unsupportedMethod('getElementsByClassName'),
+  getChildren: unsupportedMethod('getChildren'),
+  getChildNodes: unsupportedMethod('getChildNodes'),
+  getFirstChild: unsupportedMethod('getFirstChild'),
+  getFirstElementChild: unsupportedMethod('getFirstElementChild'),
+  getLastChild: unsupportedMethod('getLastChild'),
+  getLastElementChild: unsupportedMethod('getLastElementChild'),
 
   defineCustomElement(name, constructor, _options) {
     registerCustomElement(name, constructor);
@@ -7540,6 +7580,9 @@ function serializeChildNodes(children) {
       case HostNodeType.Comment:
         return `<!--${htmlEscape(child.value)}-->`;
 
+      case HostNodeType.Raw:
+        return child.value;
+
       case HostNodeType.Element:
         return serializeElement(child);
     }
@@ -7635,7 +7678,7 @@ function renderComponent(tagName, Ctor, props = {}) {
 
 freeze(LightningElement);
 seal(LightningElement.prototype);
-/* version: 2.5.3 */
+/* version: 2.5.7 */
 
 exports.LightningElement = LightningElement;
 exports.api = api$1;
@@ -7651,6 +7694,7 @@ exports.renderComponent = renderComponent;
 exports.sanitizeAttribute = sanitizeAttribute;
 exports.setFeatureFlag = setFeatureFlag;
 exports.setFeatureFlagForTest = setFeatureFlagForTest;
+exports.setHooks = setHooks;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;