lwc 2.35.0 → 2.35.2

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

@@ -29,10 +29,10 @@ function fail(msg) {
 
 var assert = /*#__PURE__*/Object.freeze({
     __proto__: null,
+    fail: fail,
     invariant: invariant,
-    isTrue: isTrue$1,
     isFalse: isFalse$1,
-    fail: fail
+    isTrue: isTrue$1
 });
 
 /*
@@ -202,41 +202,11 @@ const ID_REFERENCING_ATTRIBUTES_SET = new Set([
  * 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.
@@ -359,9 +329,9 @@ function htmlAttributeToProperty(attrName) {
  * 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.
@@ -414,7 +384,8 @@ function setFeatureFlag(name, value) {
         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;
     }
@@ -434,11 +405,12 @@ function setFeatureFlag(name, value) {
  * 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.
@@ -502,7 +474,7 @@ function applyAriaReflection(prototype = Element.prototype) {
         }
     }
 }
-/** version: 2.35.0 */
+/** version: 2.35.2 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -523,8 +495,7 @@ if (!lwcRuntimeFlags.DISABLE_ARIA_REFLECTION_POLYFILL) {
  * 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) {
@@ -548,8 +519,7 @@ if (process.env.NODE_ENV !== 'production' && typeof __karma__ !== 'undefined') {
  * 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) {
@@ -690,8 +660,8 @@ function addErrorComponentStack(vm, error) {
  * 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();
@@ -940,6 +910,14 @@ function setRefVNode(vm, ref, vnode) {
         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.
@@ -1145,27 +1123,18 @@ function generateAccessorDescriptor(options) {
 }
 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({
@@ -1246,10 +1215,7 @@ function patchElementWithRestrictions(elm, options) {
     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.
@@ -1290,10 +1256,7 @@ function getShadowRootRestrictionsDescriptors(sr) {
 // 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');
@@ -1338,10 +1301,7 @@ function getCustomElementRestrictionsDescriptors(elm) {
     };
 }
 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() {
@@ -1355,10 +1315,7 @@ function getComponentRestrictionsDescriptors() {
     };
 }
 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({
@@ -2072,7 +2029,6 @@ function createBridgeToElementDescriptor(propName, descriptor) {
     }
   };
 }
-const EMPTY_REFS = freeze(create(null));
 const refsCache = new WeakMap();
 /**
  * This class is the base class for any LWC element.
@@ -2360,7 +2316,6 @@ LightningElement.prototype = {
     }
     const {
       refVNodes,
-      hasRefVNodes,
       cmpTemplate
     } = vm;
     // If the `cmpTemplate` is null, that means that the template has not been rendered yet. Most likely this occurs
@@ -2374,15 +2329,9 @@ LightningElement.prototype = {
     // 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.
@@ -3197,8 +3146,8 @@ function getDecoratorsMeta(Ctor) {
  * 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;
@@ -3494,10 +3443,7 @@ function rehydrateHotComponent(Ctor) {
     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);
@@ -3506,10 +3452,7 @@ function getTemplateOrSwappedTemplate(tpl) {
     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);
@@ -3518,10 +3461,7 @@ function getComponentOrSwappedComponent(Ctor) {
     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);
@@ -3530,10 +3470,7 @@ function getStyleOrSwappedStyle(style) {
     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);
@@ -3576,10 +3513,7 @@ function setActiveVM(vm) {
     }
 }
 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);
@@ -5752,10 +5686,7 @@ function setVMBeingRendered(vm) {
     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) {
@@ -5889,9 +5820,7 @@ function evaluateTemplate(vm, html) {
                 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 = [];
@@ -6078,7 +6007,7 @@ function markComponentAsDirty(vm) {
 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)) {
@@ -6223,7 +6152,6 @@ function createVM(elm, ctor, renderer, options) {
     mode,
     owner,
     refVNodes: null,
-    hasRefVNodes: false,
     children: EmptyArray,
     aChildren: EmptyArray,
     velements: EmptyArray,
@@ -7491,7 +7419,7 @@ function getComponentConstructor(elm) {
     }
     return ctor;
 }
-/* version: 2.35.0 */
+/* version: 2.35.2 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -7599,8 +7527,7 @@ const stylesheetCache = new Map();
 // 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();
@@ -7770,7 +7697,7 @@ const createCustomElementCompat = (tagName, upgradeCallback) => {
 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.
@@ -7815,7 +7742,7 @@ const createUpgradableConstructor = (connectedCallback, disconnectedCallback) =>
     }
     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)) {
@@ -7843,7 +7770,7 @@ const createCustomElementVanilla = (tagName, upgradeCallback, connectedCallback,
  */
 /**
  * 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) {
@@ -8384,10 +8311,10 @@ function createCustomElementScoped(tagName, upgradeCallback, connectedCallback,
  * 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
@@ -8398,8 +8325,8 @@ if (hasCustomElements) {
   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
@@ -8455,10 +8382,10 @@ function rendererFactory(baseRenderer) {
 
     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;
@@ -8466,7 +8393,7 @@ function rendererFactory(baseRenderer) {
     function isNull(obj) {
         return obj === null;
     }
-    /** version: 2.35.0 */
+    /** version: 2.35.2 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -9027,6 +8954,6 @@ defineProperty(LightningElement, 'CustomElementConstructor', {
 });
 freeze(LightningElement);
 seal(LightningElement.prototype);
-/* version: 2.35.0 */
+/* version: 2.35.2 */
 
 export { LightningElement, profilerControl as __unstable__ProfilerControl, reportingControl as __unstable__ReportingControl, api$1 as api, deprecatedBuildCustomElementConstructor as buildCustomElementConstructor, createContextProvider, createElement, freezeTemplate, getComponentConstructor, getComponentDef, hydrateComponent, isComponentConstructor, isNodeShadowed as isNodeFromTemplate, parseFragment, parseSVGFragment, readonly, register, registerComponent, registerDecorators, registerTemplate, renderer, rendererFactory, sanitizeAttribute, setFeatureFlag, setFeatureFlagForTest, setHooks, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };