lwc 2.35.0 → 2.35.1

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

@@ -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.1";
 const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-/** version: 2.35.0 */
+/** version: 2.35.1 */
 
 /**
  * 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.1 */
 
 /**
  * Copyright (C) 2018 salesforce.com, inc.
@@ -502,7 +474,7 @@ function applyAriaReflection(prototype = Element.prototype) {
         }
     }
 }
-/** version: 2.35.0 */
+/** version: 2.35.1 */
 
 /*
  * 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.1 */
 
 /*
  * 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();
@@ -8466,7 +8393,7 @@ function rendererFactory(baseRenderer) {
     function isNull(obj) {
         return obj === null;
     }
-    /** version: 2.35.0 */
+    /** version: 2.35.1 */
 
     /*
      * 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.1 */
 
 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 };