lwc 2.5.2 → 2.5.6

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

@@ -2,7 +2,7 @@
   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
   typeof define === 'function' && define.amd ? define(['exports'], factory) :
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.LWC = {}));
-}(this, (function (exports) { 'use strict';
+})(this, (function (exports) { 'use strict';
 
   /* proxy-compat-disable */
 
@@ -305,7 +305,7 @@
     CACHED_PROPERTY_ATTRIBUTE_MAPPING.set(propName, attributeName);
     return attributeName;
   }
-  /** version: 2.5.2 */
+  /** version: 2.5.6 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -415,6 +415,7 @@
     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,
@@ -484,7 +485,7 @@
       setFeatureFlag(name, value);
     }
   }
-  /** version: 2.5.2 */
+  /** version: 2.5.6 */
 
   /* proxy-compat-disable */
 
@@ -2856,9 +2857,9 @@
     }
   }
 
-  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
 
@@ -3018,76 +3019,12 @@
       } = 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,
@@ -3147,6 +3084,50 @@
     }
 
   };
+  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) {
@@ -3737,15 +3718,14 @@
     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;
   }
   /*
@@ -4866,6 +4846,38 @@
    * 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;
@@ -5241,7 +5253,7 @@
       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);
@@ -5507,25 +5519,29 @@
 
     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.
@@ -5539,12 +5555,12 @@
   }
 
   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) {
@@ -6443,6 +6459,12 @@
       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.
 
 
@@ -7372,7 +7394,38 @@
 
     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.
@@ -7393,8 +7446,11 @@
     };
   }
 
-  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();
@@ -7623,6 +7679,30 @@
       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;
     },
@@ -7930,7 +8010,7 @@
   });
   freeze(LightningElement);
   seal(LightningElement.prototype);
-  /* version: 2.5.2 */
+  /* version: 2.5.6 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;
@@ -7950,6 +8030,8 @@
   exports.sanitizeAttribute = sanitizeAttribute;
   exports.setFeatureFlag = setFeatureFlag;
   exports.setFeatureFlagForTest = setFeatureFlagForTest;
+  exports.setHooks = setHooks;
+  exports.setHooksForTest = setHooksForTest;
   exports.swapComponent = swapComponent;
   exports.swapStyle = swapStyle;
   exports.swapTemplate = swapTemplate;
@@ -7959,4 +8041,4 @@
 
   Object.defineProperty(exports, '__esModule', { value: true });
 
-})));
+}));