lwc 2.35.0 → 2.35.2

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

@@ -35,10 +35,10 @@
 
   var assert = /*#__PURE__*/Object.freeze({
       __proto__: null,
+      fail: fail,
       invariant: invariant,
-      isTrue: isTrue$1,
       isFalse: isFalse$1,
-      fail: fail
+      isTrue: isTrue$1
   });
 
   /*
@@ -208,41 +208,11 @@
    * SPDX-License-Identifier: MIT
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
-  // Inspired from: https://mathiasbynens.be/notes/globalthis
-  const _globalThis = /*@__PURE__*/ (function () {
-      // On recent browsers, `globalThis` is already defined. In this case return it directly.
-      if (typeof globalThis === 'object') {
-          return globalThis;
-      }
-      let _globalThis;
-      try {
-          // eslint-disable-next-line no-extend-native
-          Object.defineProperty(Object.prototype, '__magic__', {
-              get: function () {
-                  return this;
-              },
-              configurable: true,
-          });
-          // __magic__ is undefined in Safari 10 and IE10 and older.
-          // @ts-ignore
-          // eslint-disable-next-line no-undef
-          _globalThis = __magic__;
-          // @ts-ignore
-          delete Object.prototype.__magic__;
-      }
-      catch (ex) {
-          // In IE8, Object.defineProperty only works on DOM objects.
-      }
-      finally {
-          // If the magic above fails for some reason we assume that we are in a legacy browser.
-          // Assume `window` exists in this case.
-          if (typeof _globalThis === 'undefined') {
-              // @ts-ignore
-              _globalThis = window;
-          }
-      }
-      return _globalThis;
-  })();
+  // See browser support for globalThis:
+  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/globalThis#browser_compatibility
+  /* istanbul ignore next */
+  // @ts-ignore
+  const _globalThis = typeof globalThis === 'object' ? globalThis : window;
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -365,9 +335,9 @@
    * 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.35.0";
+  const LWC_VERSION = "2.35.2";
   const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-  /** version: 2.35.0 */
+  /** version: 2.35.2 */
 
   /**
    * Copyright (C) 2018 salesforce.com, inc.
@@ -420,7 +390,8 @@
           console.warn(`Failed to set the value "${value}" for the runtime feature flag "${name}" because it is undefined. Available flags: ${availableFlags}.`);
           return;
       }
-      if (process.env.NODE_ENV !== 'production') {
+      // This may seem redundant, but `process.env.NODE_ENV === 'test-karma-lwc'` is replaced by Karma tests
+      if (process.env.NODE_ENV === 'test-karma-lwc' || process.env.NODE_ENV !== 'production') {
           // Allow the same flag to be set more than once outside of production to enable testing
           lwcRuntimeFlags[name] = value;
       }
@@ -440,11 +411,12 @@
    * purposes. It is a no-op when invoked in production mode.
    */
   function setFeatureFlagForTest(name, value) {
-      if (process.env.NODE_ENV !== 'production') {
+      // This may seem redundant, but `process.env.NODE_ENV === 'test-karma-lwc'` is replaced by Karma tests
+      if (process.env.NODE_ENV === 'test-karma-lwc' || process.env.NODE_ENV !== 'production') {
           setFeatureFlag(name, value);
       }
   }
-  /** version: 2.35.0 */
+  /** version: 2.35.2 */
 
   /**
    * Copyright (C) 2018 salesforce.com, inc.
@@ -508,7 +480,7 @@
           }
       }
   }
-  /** version: 2.35.0 */
+  /** version: 2.35.2 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -529,8 +501,7 @@
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
   // Only used in LWC's Karma tests
-  // @ts-ignore
-  if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
+  if (process.env.NODE_ENV === 'test-karma-lwc') {
     window.addEventListener('test-dummy-flag', () => {
       let hasFlag = false;
       if (lwcRuntimeFlags.DUMMY_TEST_FLAG) {
@@ -554,8 +525,7 @@
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
   // Only used in LWC's Karma tests
-  // @ts-ignore
-  if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
+  if (process.env.NODE_ENV === 'test-karma-lwc') {
     window.addEventListener('test-dummy-flag', () => {
       let hasFlag = false;
       if (lwcRuntimeFlags.DUMMY_TEST_FLAG) {
@@ -696,8 +666,8 @@
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
   const alreadyLoggedMessages = new Set();
-  // @ts-ignore
-  if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
+  // Only used in LWC's Karma tests
+  if (process.env.NODE_ENV === 'test-karma-lwc') {
       // @ts-ignore
       window.__lwcResetAlreadyLoggedMessages = () => {
           alreadyLoggedMessages.clear();
@@ -946,6 +916,14 @@
           refVNodes[ref] = vnode;
       }
   }
+  // Throw an error if we're running in prod mode. Ensures code is truly removed from prod mode.
+  function assertNotProd() {
+      /* istanbul ignore if */
+      if (process.env.NODE_ENV === 'production') {
+          // this method should never leak to prod
+          throw new ReferenceError();
+      }
+  }
 
   /*
    * Copyright (c) 2020, salesforce.com, inc.
@@ -1151,27 +1129,18 @@
   }
   let isDomMutationAllowed = false;
   function unlockDomMutation() {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       isDomMutationAllowed = true;
   }
   function lockDomMutation() {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       isDomMutationAllowed = false;
   }
   function logMissingPortalError(name, type) {
       return logError(`The \`${name}\` ${type} is available only on elements that use the \`lwc:dom="manual"\` directive.`);
   }
   function patchElementWithRestrictions(elm, options) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       const originalOuterHTMLDescriptor = getPropertyDescriptor(elm, 'outerHTML');
       const descriptors = {
           outerHTML: generateAccessorDescriptor({
@@ -1252,10 +1221,7 @@
       defineProperties(elm, descriptors);
   }
   function getShadowRootRestrictionsDescriptors(sr) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       // Disallowing properties in dev mode only to avoid people doing the wrong
       // thing when using the real shadow root, because if that's the case,
       // the component will not work when running with synthetic shadow.
@@ -1296,10 +1262,7 @@
   // Custom Elements Restrictions:
   // -----------------------------
   function getCustomElementRestrictionsDescriptors(elm) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       const originalAddEventListener = elm.addEventListener;
       const originalInnerHTMLDescriptor = getPropertyDescriptor(elm, 'innerHTML');
       const originalOuterHTMLDescriptor = getPropertyDescriptor(elm, 'outerHTML');
@@ -1344,10 +1307,7 @@
       };
   }
   function getComponentRestrictionsDescriptors() {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       return {
           tagName: generateAccessorDescriptor({
               get() {
@@ -1361,10 +1321,7 @@
       };
   }
   function getLightningElementPrototypeRestrictionsDescriptors(proto) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       const originalDispatchEvent = proto.dispatchEvent;
       const descriptors = {
           dispatchEvent: generateDataDescriptor({
@@ -2078,7 +2035,6 @@
       }
     };
   }
-  const EMPTY_REFS = freeze(create(null));
   const refsCache = new WeakMap();
   /**
    * This class is the base class for any LWC element.
@@ -2366,7 +2322,6 @@
       }
       const {
         refVNodes,
-        hasRefVNodes,
         cmpTemplate
       } = vm;
       // If the `cmpTemplate` is null, that means that the template has not been rendered yet. Most likely this occurs
@@ -2380,15 +2335,9 @@
       // were introduced, we return undefined if the template has no refs defined
       // anywhere. This fixes components that may want to add an expando called `refs`
       // and are checking if it exists with `if (this.refs)`  before adding it.
-      // Note it is not sufficient to just check if `refVNodes` is null or empty,
-      // because a template may have `lwc:ref` defined within a falsy `if:true` block.
-      if (!hasRefVNodes) {
-        return;
-      }
-      // For templates that are using `lwc:ref`, if there are no refs currently available
-      // (e.g. refs inside of a falsy `if:true` block), we return an empty object.
+      // Note we use a null refVNodes to indicate that the template has no refs defined.
       if (isNull(refVNodes)) {
-        return EMPTY_REFS;
+        return;
       }
       // The refNodes can be cached based on the refVNodes, since the refVNodes
       // are recreated from scratch every time the template is rendered.
@@ -3203,8 +3152,8 @@
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
   let warned = false;
-  // @ts-ignore
-  if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
+  // Only used in LWC's Karma tests
+  if (process.env.NODE_ENV === 'test-karma-lwc') {
       // @ts-ignore
       window.__lwcResetWarnedOnVersionMismatch = () => {
           warned = false;
@@ -3500,10 +3449,7 @@
       return canRefreshAllInstances;
   }
   function getTemplateOrSwappedTemplate(tpl) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       const visited = new Set();
       while (swappedTemplateMap.has(tpl) && !visited.has(tpl)) {
           visited.add(tpl);
@@ -3512,10 +3458,7 @@
       return tpl;
   }
   function getComponentOrSwappedComponent(Ctor) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       const visited = new Set();
       while (swappedComponentMap.has(Ctor) && !visited.has(Ctor)) {
           visited.add(Ctor);
@@ -3524,10 +3467,7 @@
       return Ctor;
   }
   function getStyleOrSwappedStyle(style) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       const visited = new Set();
       while (swappedStyleMap.has(style) && !visited.has(style)) {
           visited.add(style);
@@ -3536,10 +3476,7 @@
       return style;
   }
   function setActiveVM(vm) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       // tracking active component
       const Ctor = vm.def.ctor;
       let componentVMs = activeComponents.get(Ctor);
@@ -3582,10 +3519,7 @@
       }
   }
   function removeActiveVM(vm) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       // tracking inactive component
       const Ctor = vm.def.ctor;
       let list = activeComponents.get(Ctor);
@@ -5758,10 +5692,7 @@
       vmBeingRendered = vm;
   }
   function validateSlots(vm, html) {
-      if (process.env.NODE_ENV === 'production') {
-          // this method should never leak to prod
-          throw new ReferenceError();
-      }
+      assertNotProd(); // this method should never leak to prod
       const { cmpSlots } = vm;
       const { slots = EmptyArray } = html;
       for (const slotName in cmpSlots.slotAssignments) {
@@ -5895,9 +5826,7 @@
                   setActiveVM(vm);
               }
               // reset the refs; they will be set during the tmpl() instantiation
-              const hasRefVNodes = Boolean(html.hasRefs);
-              vm.hasRefVNodes = hasRefVNodes;
-              vm.refVNodes = hasRefVNodes ? create(null) : null;
+              vm.refVNodes = html.hasRefs ? create(null) : null;
               // right before producing the vnodes, we clear up all internal references
               // to custom elements from the template.
               vm.velements = [];
@@ -6084,7 +6013,7 @@
   const cmpEventListenerMap = new WeakMap();
   function getWrappedComponentsListener(vm, listener) {
       if (!isFunction$1(listener)) {
-          throw new TypeError(); // avoiding problems with non-valid listeners
+          throw new TypeError('Expected an EventListener but received ' + typeof listener); // avoiding problems with non-valid listeners
       }
       let wrappedListener = cmpEventListenerMap.get(listener);
       if (isUndefined$1(wrappedListener)) {
@@ -6229,7 +6158,6 @@
       mode,
       owner,
       refVNodes: null,
-      hasRefVNodes: false,
       children: EmptyArray,
       aChildren: EmptyArray,
       velements: EmptyArray,
@@ -7497,7 +7425,7 @@
       }
       return ctor;
   }
-  /* version: 2.35.0 */
+  /* version: 2.35.2 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -7605,8 +7533,7 @@
   // Test utilities
   //
   // Only used in LWC's Karma tests
-  // @ts-ignore
-  if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
+  if (process.env.NODE_ENV === 'test-karma-lwc') {
       // @ts-ignore
       window.__lwcResetGlobalStylesheets = () => {
           stylesheetCache.clear();
@@ -7776,7 +7703,7 @@
   const cachedConstructors = new Map();
   const elementsUpgradedOutsideLWC = new WeakSet();
   let elementBeingUpgradedByLWC = false;
-  // Creates a constructor that is intended to be used as a vanilla custom element, except that the upgradeCallback is
+  // Creates a constructor that is intended to be used directly as a custom element, except that the upgradeCallback is
   // passed in to the constructor so LWC can reuse the same custom element constructor for multiple components.
   // Another benefit is that only LWC can create components that actually do anything – if you do
   // `customElements.define('x-foo')`, then you don't have access to the upgradeCallback, so it's a dummy custom element.
@@ -7821,7 +7748,7 @@
       }
       return UpgradableConstructor;
   };
-  const createCustomElementVanilla = (tagName, upgradeCallback, connectedCallback, disconnectedCallback) => {
+  const createCustomElementUsingUpgradableConstructor = (tagName, upgradeCallback, connectedCallback, disconnectedCallback) => {
       // use global custom elements registry
       let UpgradableConstructor = cachedConstructors.get(tagName);
       if (isUndefined$1(UpgradableConstructor)) {
@@ -7849,7 +7776,7 @@
    */
   /**
    * Create a scoped registry, i.e. a function that can create custom elements whose tag names
-   * do not conflict with vanilla custom elements having the same tag name.
+   * do not conflict with third-party custom elements having the same tag name.
    */
   function createScopedRegistry() {
       if (!hasCustomElements) {
@@ -8390,10 +8317,10 @@
    * We have three modes for creating custom elements:
    *
    * 1. Compat (legacy) browser support (e.g. IE11). Totally custom, doesn't rely on native browser APIs.
-   * 2. "Vanilla" custom elements registry. This system actually still allows us to have two LWC components with the
-   *    same tag name, via a simple trick: every custom element constructor we define in the registry is basically
-   *    the same. It's essentially a dummy `class extends HTMLElement` that accepts an `upgradeCallback` in its
-   *    constructor, which allows us to have completely customized functionality for different components.
+   * 2. "Upgradable constructor" custom element. This allows us to have two LWC components with the same tag name,
+   *    via a trick: every custom element constructor we define in the registry is basically the same. It's essentially
+   *    a dummy `class extends HTMLElement` that accepts an `upgradeCallback` in its constructor ("upgradable
+   *    constructor"), which allows us to have completely customized functionality for different components.
    * 3. "Scoped" (or "pivot") custom elements. This relies on a sophisticated system that emulates the "scoped custom
    *    elements registry" proposal, with support for avoiding conflicts in tag names both between LWC components and
    *    between LWC components and third-party elements. This uses a similar trick to #2, but is much more complex
@@ -8404,8 +8331,8 @@
     if (lwcRuntimeFlags.ENABLE_SCOPED_CUSTOM_ELEMENT_REGISTRY) {
       createCustomElement = createCustomElementScoped;
     } else {
-      // use global custom elements registry (vanilla)
-      createCustomElement = createCustomElementVanilla;
+      // use the global registry, with an upgradable constructor for the defined custom element
+      createCustomElement = createCustomElementUsingUpgradableConstructor;
     }
   } else {
     // no registry available here
@@ -8461,10 +8388,10 @@
 
       var assert = /*#__PURE__*/Object.freeze({
           __proto__: null,
+          fail: fail,
           invariant: invariant,
-          isTrue: isTrue$1,
           isFalse: isFalse$1,
-          fail: fail
+          isTrue: isTrue$1
       });
       function isUndefined(obj) {
           return obj === undefined;
@@ -8472,7 +8399,7 @@
       function isNull(obj) {
           return obj === null;
       }
-      /** version: 2.35.0 */
+      /** version: 2.35.2 */
 
       /*
        * Copyright (c) 2018, salesforce.com, inc.
@@ -9033,7 +8960,7 @@
   });
   freeze(LightningElement);
   seal(LightningElement.prototype);
-  /* version: 2.35.0 */
+  /* version: 2.35.2 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;