lwc 2.5.3 → 2.5.7

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

@@ -299,7 +299,7 @@ function htmlPropertyToAttribute(propName) {
   CACHED_PROPERTY_ATTRIBUTE_MAPPING.set(propName, attributeName);
   return attributeName;
 }
-/** version: 2.5.3 */
+/** version: 2.5.7 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -479,7 +479,7 @@ function setFeatureFlagForTest(name, value) {
     setFeatureFlag(name, value);
   }
 }
-/** version: 2.5.3 */
+/** version: 2.5.7 */
 
 /* proxy-compat-disable */
 
@@ -2851,9 +2851,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
 
@@ -3013,76 +3013,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,
@@ -3142,6 +3078,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) {
@@ -3732,15 +3717,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;
 }
 /*
@@ -4296,7 +4280,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}'`);
     }
@@ -4458,7 +4442,7 @@ const lightingElementDef = {
   renderMode: 1
   /* Shadow */
   ,
-  shadowSupportMode: "default"
+  shadowSupportMode: "reset"
   /* Default */
   ,
   wire: EmptyObject,
@@ -5236,7 +5220,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);
@@ -5503,24 +5487,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.
@@ -5534,12 +5542,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) {
@@ -7373,7 +7381,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) 2018, salesforce.com, inc.
@@ -7394,8 +7417,11 @@ if (process.env.NODE_ENV === 'development') {
   };
 }
 
-const globalStylesheetsParentElement = document.head || document.body || document;
-const supportsConstructableStyleSheets = isFunction$1(CSSStyleSheet.prototype.replaceSync);
+const globalStylesheetsParentElement = document.head || document.body || document; // This check for constructable stylesheets is similar to Fast's:
+// https://github.com/microsoft/fast/blob/d49d1ec/packages/web-components/fast-element/src/dom.ts#L51-L53
+// See also: https://github.com/whatwg/webidl/issues/1027#issuecomment-934510070
+
+const supportsConstructableStyleSheets = isFunction$1(CSSStyleSheet.prototype.replaceSync) && isArray$1(document.adoptedStyleSheets);
 const styleElements = create(null);
 const styleSheets = create(null);
 const nodesToStyleSheets = new WeakMap();
@@ -7624,6 +7650,30 @@ const renderer = {
     return element.getElementsByClassName(names);
   },
 
+  getChildren(element) {
+    return element.children;
+  },
+
+  getChildNodes(element) {
+    return element.childNodes;
+  },
+
+  getFirstChild(element) {
+    return element.firstChild;
+  },
+
+  getFirstElementChild(element) {
+    return element.firstElementChild;
+  },
+
+  getLastChild(element) {
+    return element.lastChild;
+  },
+
+  getLastElementChild(element) {
+    return element.lastElementChild;
+  },
+
   isConnected(node) {
     return node.isConnected;
   },
@@ -7931,6 +7981,6 @@ defineProperty(LightningElement, 'CustomElementConstructor', {
 });
 freeze(LightningElement);
 seal(LightningElement.prototype);
-/* version: 2.5.3 */
+/* version: 2.5.7 */
 
-export { LightningElement, profilerControl as __unstable__ProfilerControl, api$1 as api, deprecatedBuildCustomElementConstructor as buildCustomElementConstructor, createContextProvider, createElement, getComponentConstructor, getComponentDef, isComponentConstructor, isNodeFromTemplate, readonly, register, registerComponent, registerDecorators, registerTemplate, sanitizeAttribute, setFeatureFlag, setFeatureFlagForTest, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };
+export { LightningElement, profilerControl as __unstable__ProfilerControl, api$1 as api, deprecatedBuildCustomElementConstructor as buildCustomElementConstructor, createContextProvider, createElement, getComponentConstructor, getComponentDef, isComponentConstructor, isNodeFromTemplate, readonly, register, registerComponent, registerDecorators, registerTemplate, sanitizeAttribute, setFeatureFlag, setFeatureFlagForTest, setHooks, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };