lwc 2.5.2 → 2.5.6

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.2 */
+/** version: 2.5.6 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -409,6 +409,7 @@ const features = {
   ENABLE_HMR: null,
   ENABLE_INNER_OUTER_TEXT_PATCH: null,
   ENABLE_ELEMENT_PATCH: null,
+  ENABLE_FORCE_NATIVE_SHADOW_MODE_FOR_TEST: null,
   ENABLE_NODE_LIST_PATCH: null,
   ENABLE_HTML_COLLECTIONS_PATCH: null,
   ENABLE_NODE_PATCH: null,
@@ -478,7 +479,7 @@ function setFeatureFlagForTest(name, value) {
     setFeatureFlag(name, value);
   }
 }
-/** version: 2.5.2 */
+/** version: 2.5.6 */
 
 /* proxy-compat-disable */
 
@@ -2850,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
 
@@ -3012,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,
@@ -3141,6 +3078,50 @@ 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);
+    }
+
+  };
+}
+
+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);
+    }
+
+  };
+}
+
+defineProperties(LightningElement.prototype, queryAndChildGetterDescriptors);
 const lightningBasedDescriptors = create(null);
 
 for (const propName in HTMLElementOriginalDescriptors) {
@@ -3731,15 +3712,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;
 }
 /*
@@ -4860,6 +4840,38 @@ function getUpgradableConstructor(tagName, renderer) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 
+/**
+ * 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
+ */
+
+
+let sanitizeHtmlContentHook = () => {
+  // locker-service patches this function during runtime to sanitize HTML content.
+  throw new Error('sanitizeHtmlContent hook must be implemented.');
+};
+/**
+ * Sets the sanitizeHtmlContentHook.
+ *
+ * @param newHookImpl
+ * @returns oldHookImplementation.
+ */
+
+
+function setSanitizeHtmlContentHook(newHookImpl) {
+  const currentHook = sanitizeHtmlContentHook;
+  sanitizeHtmlContentHook = newHookImpl;
+  return currentHook;
+}
+/*
+ * 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
+ */
+
 
 const SVG_NAMESPACE = 'http://www.w3.org/2000/svg';
 const SymbolIterator = Symbol.iterator;
@@ -5235,7 +5247,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);
@@ -5501,25 +5513,29 @@ function sc(vnodes) {
 
   markAsDynamicChildren(vnodes);
   return vnodes;
-}
-
-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
+} // [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.
@@ -5533,12 +5549,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) {
@@ -6437,6 +6453,12 @@ function createVM(elm, def, options) {
     vm.toString = () => {
       return `[object:vm ${def.name} (${vm.idx})]`;
     };
+
+    if (runtimeFlags.ENABLE_FORCE_NATIVE_SHADOW_MODE_FOR_TEST) {
+      vm.shadowMode = 0
+      /* Native */
+      ;
+    }
   } // Create component instance associated to the vm and the element.
 
 
@@ -7366,7 +7388,38 @@ function readonly(obj) {
 
   return reactiveMembrane.getReadOnlyProxy(obj);
 }
-/* version: 2.5.2 */
+/*
+ * 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 overrideHooks(hooks) {
+  const oldHooks = {};
+
+  if (!isUndefined$1(hooks.sanitizeHtmlContent)) {
+    oldHooks.sanitizeHtmlContent = setSanitizeHtmlContentHook(hooks.sanitizeHtmlContent);
+  }
+
+  return oldHooks;
+}
+
+function setHooks(hooks) {
+  assert.isFalse(hooksAreSet, 'Hooks are already overridden, only one definition is allowed.');
+  overrideHooks(hooks);
+  hooksAreSet = true;
+}
+
+function setHooksForTest(hooks) {
+  if (process.env.NODE_ENV !== 'production') {
+    return overrideHooks(hooks);
+  }
+}
+/* version: 2.5.6 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -7387,8 +7440,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();
@@ -7617,6 +7673,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;
   },
@@ -7924,6 +8004,6 @@ defineProperty(LightningElement, 'CustomElementConstructor', {
 });
 freeze(LightningElement);
 seal(LightningElement.prototype);
-/* version: 2.5.2 */
+/* version: 2.5.6 */
 
-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, setHooksForTest, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };