lwc 2.32.1 → 2.33.0

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

@@ -121,6 +121,9 @@
    * The above list of 46 aria attributes is consistent with the following resources:
    * https://github.com/w3c/aria/pull/708/files#diff-eacf331f0ffc35d4b482f1d15a887d3bR11060
    * https://wicg.github.io/aom/spec/aria-reflection.html
+   *
+   * NOTE: If you update this list, please update test files that implicitly reference this list!
+   * Searching the codebase for `aria-flowto` and `ariaFlowTo` should be good enough to find all usages.
    */
   const AriaPropertyNames = [
       'ariaActiveDescendant',
@@ -336,89 +339,7 @@
       CACHED_ATTRIBUTE_PROPERTY_MAPPING.set(attrName, propertyName);
       return propertyName;
   }
-  /** version: 2.32.1 */
-
-  /**
-   * Copyright (C) 2018 salesforce.com, inc.
-   */
-
-  /*
-   * 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
-   */
-  function detect(propName) {
-      return getOwnPropertyDescriptor$1(Element.prototype, propName) === undefined;
-  }
-
-  /*
-   * 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 nodeToAriaPropertyValuesMap = new WeakMap();
-  function getAriaPropertyMap(elm) {
-      let map = nodeToAriaPropertyValuesMap.get(elm);
-      if (map === undefined) {
-          map = {};
-          nodeToAriaPropertyValuesMap.set(elm, map);
-      }
-      return map;
-  }
-  function getNormalizedAriaPropertyValue(value) {
-      return value == null ? null : String(value);
-  }
-  function createAriaPropertyPropertyDescriptor(propName, attrName) {
-      return {
-          get() {
-              const map = getAriaPropertyMap(this);
-              if (hasOwnProperty$1.call(map, propName)) {
-                  return map[propName];
-              }
-              // otherwise just reflect what's in the attribute
-              return this.hasAttribute(attrName) ? this.getAttribute(attrName) : null;
-          },
-          set(newValue) {
-              const normalizedValue = getNormalizedAriaPropertyValue(newValue);
-              const map = getAriaPropertyMap(this);
-              map[propName] = normalizedValue;
-              // reflect into the corresponding attribute
-              if (newValue === null) {
-                  this.removeAttribute(attrName);
-              }
-              else {
-                  this.setAttribute(attrName, newValue);
-              }
-          },
-          configurable: true,
-          enumerable: true,
-      };
-  }
-  function patch$1(propName) {
-      // Typescript is inferring the wrong function type for this particular
-      // overloaded method: https://github.com/Microsoft/TypeScript/issues/27972
-      // @ts-ignore type-mismatch
-      const attrName = AriaPropNameToAttrNameMap[propName];
-      const descriptor = createAriaPropertyPropertyDescriptor(propName, attrName);
-      Object.defineProperty(Element.prototype, propName, descriptor);
-  }
-
-  /*
-   * 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 ElementPrototypeAriaPropertyNames = keys(AriaPropNameToAttrNameMap);
-  for (let i = 0, len = ElementPrototypeAriaPropertyNames.length; i < len; i += 1) {
-      const propName = ElementPrototypeAriaPropertyNames[i];
-      if (detect(propName)) {
-          patch$1(propName);
-      }
-  }
-  /** version: 2.32.1 */
+  /** version: 2.33.0 */
 
   /**
    * Copyright (C) 2018 salesforce.com, inc.
@@ -440,6 +361,7 @@
       DISABLE_LIGHT_DOM_UNSCOPED_CSS: null,
       ENABLE_SCOPED_CUSTOM_ELEMENT_REGISTRY: null,
       ENABLE_FROZEN_TEMPLATE: null,
+      DISABLE_ARIA_REFLECTION_POLYFILL: null,
   };
   if (!_globalThis.lwcRuntimeFlags) {
       Object.defineProperty(_globalThis, 'lwcRuntimeFlags', { value: create(null) });
@@ -483,6 +405,83 @@
    */
   function setFeatureFlagForTest(name, value) {
   }
+  /** version: 2.33.0 */
+
+  /**
+   * Copyright (C) 2018 salesforce.com, inc.
+   */
+
+  /*
+   * 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
+   */
+  function detect(propName, prototype) {
+      return isUndefined$1(getOwnPropertyDescriptor$1(prototype, propName));
+  }
+
+  /*
+   * 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
+   */
+  function createAriaPropertyPropertyDescriptor(attrName) {
+      // Note that we need to call this.{get,set,has,remove}Attribute rather than dereferencing
+      // from Element.prototype, because these methods are overridden in LightningElement.
+      return {
+          get() {
+              // reflect what's in the attribute
+              return this.hasAttribute(attrName) ? this.getAttribute(attrName) : null;
+          },
+          set(newValue) {
+              // reflect into the corresponding attribute
+              if (isNull(newValue)) {
+                  this.removeAttribute(attrName);
+              }
+              else {
+                  this.setAttribute(attrName, newValue);
+              }
+          },
+          configurable: true,
+          enumerable: true,
+      };
+  }
+  function patch$1(propName, prototype) {
+      const attrName = AriaPropNameToAttrNameMap[propName];
+      const descriptor = createAriaPropertyPropertyDescriptor(attrName);
+      defineProperty(prototype, propName, descriptor);
+  }
+
+  /*
+   * 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
+   */
+  function applyAriaReflection(prototype = Element.prototype) {
+      const ElementPrototypeAriaPropertyNames = keys(AriaPropNameToAttrNameMap);
+      for (let i = 0, len = ElementPrototypeAriaPropertyNames.length; i < len; i += 1) {
+          const propName = ElementPrototypeAriaPropertyNames[i];
+          if (detect(propName, prototype)) {
+              patch$1(propName, prototype);
+          }
+      }
+  }
+  /** version: 2.33.0 */
+
+  /*
+   * 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
+   */
+  if (!lwcRuntimeFlags.DISABLE_ARIA_REFLECTION_POLYFILL) {
+    // If DISABLE_ARIA_REFLECTION_POLYFILL is false, then we need to apply the ARIA reflection polyfill globally,
+    // i.e. to the global Element.prototype
+    applyAriaReflection();
+  }
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -1389,30 +1388,35 @@
    * for the Base Lightning Element, it also include the reactivity bit, so the standard property is reactive.
    */
   function createBridgeToElementDescriptor(propName, descriptor) {
-      const { get, set, enumerable, configurable } = descriptor;
-      if (!isFunction$1(get)) {
-          throw new TypeError();
-      }
-      if (!isFunction$1(set)) {
-          throw new TypeError();
+    const {
+      get,
+      set,
+      enumerable,
+      configurable
+    } = descriptor;
+    if (!isFunction$1(get)) {
+      throw new TypeError();
+    }
+    if (!isFunction$1(set)) {
+      throw new TypeError();
+    }
+    return {
+      enumerable,
+      configurable,
+      get() {
+        const vm = getAssociatedVM(this);
+        if (isBeingConstructed(vm)) {
+          return;
+        }
+        componentValueObserved(vm, propName);
+        return get.call(vm.elm);
+      },
+      set(newValue) {
+        const vm = getAssociatedVM(this);
+        updateComponentValue(vm, propName, newValue);
+        return set.call(vm.elm, newValue);
       }
-      return {
-          enumerable,
-          configurable,
-          get() {
-              const vm = getAssociatedVM(this);
-              if (isBeingConstructed(vm)) {
-                  return;
-              }
-              componentValueObserved(vm, propName);
-              return get.call(vm.elm);
-          },
-          set(newValue) {
-              const vm = getAssociatedVM(this);
-              updateComponentValue(vm, propName, newValue);
-              return set.call(vm.elm, newValue);
-          },
-      };
+    };
   }
   const EMPTY_REFS = freeze(create(null));
   const refsCache = new WeakMap();
@@ -1422,262 +1426,361 @@
    **/
   // @ts-ignore
   const LightningElement = function () {
-      // This should be as performant as possible, while any initialization should be done lazily
-      if (isNull(vmBeingConstructed)) {
-          // Thrown when doing something like `new LightningElement()` or
-          // `class Foo extends LightningElement {}; new Foo()`
-          throw new TypeError('Illegal constructor');
-      }
-      const vm = vmBeingConstructed;
-      const { def, elm } = vm;
-      const { bridge } = def;
-      const component = this;
-      setPrototypeOf(elm, bridge.prototype);
-      vm.component = this;
-      // Locker hooks assignment. When the LWC engine run with Locker, Locker intercepts all the new
-      // component creation and passes hooks to instrument all the component interactions with the
-      // engine. We are intentionally hiding this argument from the formal API of LightningElement
-      // because we don't want folks to know about it just yet.
-      if (arguments.length === 1) {
-          const { callHook, setHook, getHook } = arguments[0];
-          vm.callHook = callHook;
-          vm.setHook = setHook;
-          vm.getHook = getHook;
-      }
-      markLockerLiveObject(this);
-      // Linking elm, shadow root and component with the VM.
-      associateVM(component, vm);
-      associateVM(elm, vm);
-      if (vm.renderMode === 1 /* RenderMode.Shadow */) {
-          vm.renderRoot = doAttachShadow(vm);
-      }
-      else {
-          vm.renderRoot = elm;
-      }
-      return this;
+    // This should be as performant as possible, while any initialization should be done lazily
+    if (isNull(vmBeingConstructed)) {
+      // Thrown when doing something like `new LightningElement()` or
+      // `class Foo extends LightningElement {}; new Foo()`
+      throw new TypeError('Illegal constructor');
+    }
+    const vm = vmBeingConstructed;
+    const {
+      def,
+      elm
+    } = vm;
+    const {
+      bridge
+    } = def;
+    const component = this;
+    setPrototypeOf(elm, bridge.prototype);
+    vm.component = this;
+    // Locker hooks assignment. When the LWC engine run with Locker, Locker intercepts all the new
+    // component creation and passes hooks to instrument all the component interactions with the
+    // engine. We are intentionally hiding this argument from the formal API of LightningElement
+    // because we don't want folks to know about it just yet.
+    if (arguments.length === 1) {
+      const {
+        callHook,
+        setHook,
+        getHook
+      } = arguments[0];
+      vm.callHook = callHook;
+      vm.setHook = setHook;
+      vm.getHook = getHook;
+    }
+    markLockerLiveObject(this);
+    // Linking elm, shadow root and component with the VM.
+    associateVM(component, vm);
+    associateVM(elm, vm);
+    if (vm.renderMode === 1 /* RenderMode.Shadow */) {
+      vm.renderRoot = doAttachShadow(vm);
+    } else {
+      vm.renderRoot = elm;
+    }
+    return this;
   };
   function doAttachShadow(vm) {
-      const { elm, mode, shadowMode, def: { ctor }, renderer: { attachShadow }, } = vm;
-      const shadowRoot = attachShadow(elm, {
-          [KEY__SYNTHETIC_MODE]: shadowMode === 1 /* ShadowMode.Synthetic */,
-          delegatesFocus: Boolean(ctor.delegatesFocus),
-          mode,
-      });
-      vm.shadowRoot = shadowRoot;
-      associateVM(shadowRoot, vm);
-      return shadowRoot;
+    const {
+      elm,
+      mode,
+      shadowMode,
+      def: {
+        ctor
+      },
+      renderer: {
+        attachShadow
+      }
+    } = vm;
+    const shadowRoot = attachShadow(elm, {
+      [KEY__SYNTHETIC_MODE]: shadowMode === 1 /* ShadowMode.Synthetic */,
+      delegatesFocus: Boolean(ctor.delegatesFocus),
+      mode
+    });
+    vm.shadowRoot = shadowRoot;
+    associateVM(shadowRoot, vm);
+    return shadowRoot;
   }
   // @ts-ignore
   LightningElement.prototype = {
-      constructor: LightningElement,
-      dispatchEvent(event) {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { dispatchEvent }, } = vm;
-          return dispatchEvent(elm, event);
-      },
-      addEventListener(type, listener, options) {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { addEventListener }, } = vm;
-          const wrappedListener = getWrappedComponentsListener(vm, listener);
-          addEventListener(elm, type, wrappedListener, options);
-      },
-      removeEventListener(type, listener, options) {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { removeEventListener }, } = vm;
-          const wrappedListener = getWrappedComponentsListener(vm, listener);
-          removeEventListener(elm, type, wrappedListener, options);
-      },
-      hasAttribute(name) {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { getAttribute }, } = vm;
-          return !isNull(getAttribute(elm, name));
-      },
-      hasAttributeNS(namespace, name) {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { getAttribute }, } = vm;
-          return !isNull(getAttribute(elm, name, namespace));
-      },
-      removeAttribute(name) {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { removeAttribute }, } = vm;
-          unlockAttribute(elm, name);
-          removeAttribute(elm, name);
-          lockAttribute();
-      },
-      removeAttributeNS(namespace, name) {
-          const { elm, renderer: { removeAttribute }, } = getAssociatedVM(this);
-          unlockAttribute(elm, name);
-          removeAttribute(elm, name, namespace);
-          lockAttribute();
-      },
-      getAttribute(name) {
-          const vm = getAssociatedVM(this);
-          const { elm } = vm;
-          const { getAttribute } = vm.renderer;
-          return getAttribute(elm, name);
-      },
-      getAttributeNS(namespace, name) {
-          const vm = getAssociatedVM(this);
-          const { elm } = vm;
-          const { getAttribute } = vm.renderer;
-          return getAttribute(elm, name, namespace);
-      },
-      setAttribute(name, value) {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { setAttribute }, } = vm;
-          unlockAttribute(elm, name);
-          setAttribute(elm, name, value);
-          lockAttribute();
-      },
-      setAttributeNS(namespace, name, value) {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { setAttribute }, } = vm;
-          unlockAttribute(elm, name);
-          setAttribute(elm, name, value, namespace);
-          lockAttribute();
-      },
-      getBoundingClientRect() {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { getBoundingClientRect }, } = vm;
-          return getBoundingClientRect(elm);
-      },
-      get isConnected() {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { isConnected }, } = vm;
-          return isConnected(elm);
-      },
-      get classList() {
-          const vm = getAssociatedVM(this);
-          const { elm, renderer: { getClassList }, } = vm;
-          return getClassList(elm);
-      },
-      get template() {
-          const vm = getAssociatedVM(this);
-          return vm.shadowRoot;
-      },
-      get refs() {
-          const vm = getAssociatedVM(this);
-          if (isUpdatingTemplate) {
-              // If the template is in the process of being updated, then we don't want to go through the normal
-              // process of returning the refs and caching them, because the state of the refs is unstable.
-              // This can happen if e.g. a template contains `<div class={foo}></div>` and `foo` is computed
-              // based on `this.refs.bar`.
-              return;
-          }
-          const { refVNodes, hasRefVNodes, cmpTemplate } = vm;
-          // For backwards compatibility with component written before template refs
-          // 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.
-          if (isNull(refVNodes)) {
-              return EMPTY_REFS;
-          }
-          // The refNodes can be cached based on the refVNodes, since the refVNodes
-          // are recreated from scratch every time the template is rendered.
-          // This happens with `vm.refVNodes = null` in `template.ts` in `@lwc/engine-core`.
-          let refs = refsCache.get(refVNodes);
-          if (isUndefined$1(refs)) {
-              refs = create(null);
-              for (const key of keys(refVNodes)) {
-                  refs[key] = refVNodes[key].elm;
-              }
-              freeze(refs);
-              refsCache.set(refVNodes, refs);
-          }
-          return refs;
-      },
-      // For backwards compat, we allow component authors to set `refs` as an expando
-      set refs(value) {
-          defineProperty(this, 'refs', {
-              configurable: true,
-              enumerable: true,
-              writable: true,
-              value,
-          });
-      },
-      get shadowRoot() {
-          // From within the component instance, the shadowRoot is always reported as "closed".
-          // Authors should rely on this.template instead.
-          return null;
-      },
-      get children() {
-          const vm = getAssociatedVM(this);
-          const renderer = vm.renderer;
-          return renderer.getChildren(vm.elm);
-      },
-      get childNodes() {
-          const vm = getAssociatedVM(this);
-          const renderer = vm.renderer;
-          return renderer.getChildNodes(vm.elm);
-      },
-      get firstChild() {
-          const vm = getAssociatedVM(this);
-          const renderer = vm.renderer;
-          return renderer.getFirstChild(vm.elm);
-      },
-      get firstElementChild() {
-          const vm = getAssociatedVM(this);
-          const renderer = vm.renderer;
-          return renderer.getFirstElementChild(vm.elm);
-      },
-      get lastChild() {
-          const vm = getAssociatedVM(this);
-          const renderer = vm.renderer;
-          return renderer.getLastChild(vm.elm);
-      },
-      get lastElementChild() {
-          const vm = getAssociatedVM(this);
-          const renderer = vm.renderer;
-          return renderer.getLastElementChild(vm.elm);
-      },
-      render() {
-          const vm = getAssociatedVM(this);
-          return vm.def.template;
-      },
-      toString() {
-          const vm = getAssociatedVM(this);
-          return `[object ${vm.def.name}]`;
-      },
+    constructor: LightningElement,
+    dispatchEvent(event) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          dispatchEvent
+        }
+      } = vm;
+      return dispatchEvent(elm, event);
+    },
+    addEventListener(type, listener, options) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          addEventListener
+        }
+      } = vm;
+      const wrappedListener = getWrappedComponentsListener(vm, listener);
+      addEventListener(elm, type, wrappedListener, options);
+    },
+    removeEventListener(type, listener, options) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          removeEventListener
+        }
+      } = vm;
+      const wrappedListener = getWrappedComponentsListener(vm, listener);
+      removeEventListener(elm, type, wrappedListener, options);
+    },
+    hasAttribute(name) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          getAttribute
+        }
+      } = vm;
+      return !isNull(getAttribute(elm, name));
+    },
+    hasAttributeNS(namespace, name) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          getAttribute
+        }
+      } = vm;
+      return !isNull(getAttribute(elm, name, namespace));
+    },
+    removeAttribute(name) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          removeAttribute
+        }
+      } = vm;
+      unlockAttribute(elm, name);
+      removeAttribute(elm, name);
+      lockAttribute();
+    },
+    removeAttributeNS(namespace, name) {
+      const {
+        elm,
+        renderer: {
+          removeAttribute
+        }
+      } = getAssociatedVM(this);
+      unlockAttribute(elm, name);
+      removeAttribute(elm, name, namespace);
+      lockAttribute();
+    },
+    getAttribute(name) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm
+      } = vm;
+      const {
+        getAttribute
+      } = vm.renderer;
+      return getAttribute(elm, name);
+    },
+    getAttributeNS(namespace, name) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm
+      } = vm;
+      const {
+        getAttribute
+      } = vm.renderer;
+      return getAttribute(elm, name, namespace);
+    },
+    setAttribute(name, value) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          setAttribute
+        }
+      } = vm;
+      unlockAttribute(elm, name);
+      setAttribute(elm, name, value);
+      lockAttribute();
+    },
+    setAttributeNS(namespace, name, value) {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          setAttribute
+        }
+      } = vm;
+      unlockAttribute(elm, name);
+      setAttribute(elm, name, value, namespace);
+      lockAttribute();
+    },
+    getBoundingClientRect() {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          getBoundingClientRect
+        }
+      } = vm;
+      return getBoundingClientRect(elm);
+    },
+    get isConnected() {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          isConnected
+        }
+      } = vm;
+      return isConnected(elm);
+    },
+    get classList() {
+      const vm = getAssociatedVM(this);
+      const {
+        elm,
+        renderer: {
+          getClassList
+        }
+      } = vm;
+      return getClassList(elm);
+    },
+    get template() {
+      const vm = getAssociatedVM(this);
+      return vm.shadowRoot;
+    },
+    get refs() {
+      const vm = getAssociatedVM(this);
+      if (isUpdatingTemplate) {
+        // If the template is in the process of being updated, then we don't want to go through the normal
+        // process of returning the refs and caching them, because the state of the refs is unstable.
+        // This can happen if e.g. a template contains `<div class={foo}></div>` and `foo` is computed
+        // based on `this.refs.bar`.
+        return;
+      }
+      const {
+        refVNodes,
+        hasRefVNodes,
+        cmpTemplate
+      } = vm;
+      // For backwards compatibility with component written before template refs
+      // 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.
+      if (isNull(refVNodes)) {
+        return EMPTY_REFS;
+      }
+      // The refNodes can be cached based on the refVNodes, since the refVNodes
+      // are recreated from scratch every time the template is rendered.
+      // This happens with `vm.refVNodes = null` in `template.ts` in `@lwc/engine-core`.
+      let refs = refsCache.get(refVNodes);
+      if (isUndefined$1(refs)) {
+        refs = create(null);
+        for (const key of keys(refVNodes)) {
+          refs[key] = refVNodes[key].elm;
+        }
+        freeze(refs);
+        refsCache.set(refVNodes, refs);
+      }
+      return refs;
+    },
+    // For backwards compat, we allow component authors to set `refs` as an expando
+    set refs(value) {
+      defineProperty(this, 'refs', {
+        configurable: true,
+        enumerable: true,
+        writable: true,
+        value
+      });
+    },
+    get shadowRoot() {
+      // From within the component instance, the shadowRoot is always reported as "closed".
+      // Authors should rely on this.template instead.
+      return null;
+    },
+    get children() {
+      const vm = getAssociatedVM(this);
+      const renderer = vm.renderer;
+      return renderer.getChildren(vm.elm);
+    },
+    get childNodes() {
+      const vm = getAssociatedVM(this);
+      const renderer = vm.renderer;
+      return renderer.getChildNodes(vm.elm);
+    },
+    get firstChild() {
+      const vm = getAssociatedVM(this);
+      const renderer = vm.renderer;
+      return renderer.getFirstChild(vm.elm);
+    },
+    get firstElementChild() {
+      const vm = getAssociatedVM(this);
+      const renderer = vm.renderer;
+      return renderer.getFirstElementChild(vm.elm);
+    },
+    get lastChild() {
+      const vm = getAssociatedVM(this);
+      const renderer = vm.renderer;
+      return renderer.getLastChild(vm.elm);
+    },
+    get lastElementChild() {
+      const vm = getAssociatedVM(this);
+      const renderer = vm.renderer;
+      return renderer.getLastElementChild(vm.elm);
+    },
+    render() {
+      const vm = getAssociatedVM(this);
+      return vm.def.template;
+    },
+    toString() {
+      const vm = getAssociatedVM(this);
+      return `[object ${vm.def.name}]`;
+    }
   };
   const queryAndChildGetterDescriptors = create(null);
-  const queryMethods = [
-      'getElementsByClassName',
-      'getElementsByTagName',
-      'querySelector',
-      'querySelectorAll',
-  ];
+  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;
-              return renderer[queryMethod](elm, arg);
-          },
-          configurable: true,
-          enumerable: true,
-          writable: true,
-      };
+    queryAndChildGetterDescriptors[queryMethod] = {
+      value(arg) {
+        const vm = getAssociatedVM(this);
+        const {
+          elm,
+          renderer
+        } = vm;
+        return renderer[queryMethod](elm, arg);
+      },
+      configurable: true,
+      enumerable: true,
+      writable: true
+    };
   }
   defineProperties(LightningElement.prototype, queryAndChildGetterDescriptors);
   const lightningBasedDescriptors = create(null);
   for (const propName in HTMLElementOriginalDescriptors) {
-      lightningBasedDescriptors[propName] = createBridgeToElementDescriptor(propName, HTMLElementOriginalDescriptors[propName]);
+    lightningBasedDescriptors[propName] = createBridgeToElementDescriptor(propName, HTMLElementOriginalDescriptors[propName]);
   }
   defineProperties(LightningElement.prototype, lightningBasedDescriptors);
+  function applyAriaReflectionToLightningElement() {
+    // If ARIA reflection is not applied globally to Element.prototype, or if we are running server-side,
+    // apply it to LightningElement.prototype.
+    // This allows `this.aria*` property accessors to work from inside a component, and to reflect `aria-*` attrs.
+    applyAriaReflection(LightningElement.prototype);
+  }
+  // The reason for this odd if/else branching is limitations in @lwc/features:
+  // https://github.com/salesforce/lwc/blob/master/packages/%40lwc/features/README.md#only-works-with-if-statements
+  if (lwcRuntimeFlags.DISABLE_ARIA_REFLECTION_POLYFILL) {
+    applyAriaReflectionToLightningElement();
+  }
   defineProperty(LightningElement, 'CustomElementConstructor', {
-      get() {
-          // If required, a runtime-specific implementation must be defined.
-          throw new ReferenceError('The current runtime does not support CustomElementConstructor.');
-      },
-      configurable: true,
+    get() {
+      // If required, a runtime-specific implementation must be defined.
+      throw new ReferenceError('The current runtime does not support CustomElementConstructor.');
+    },
+    configurable: true
   });
 
   function createObservedFieldPropertyDescriptor(key) {
@@ -1964,138 +2067,161 @@
   const cachedGetterByKey = create(null);
   const cachedSetterByKey = create(null);
   function createGetter(key) {
-      let fn = cachedGetterByKey[key];
-      if (isUndefined$1(fn)) {
-          fn = cachedGetterByKey[key] = function () {
-              const vm = getAssociatedVM(this);
-              const { getHook } = vm;
-              return getHook(vm.component, key);
-          };
-      }
-      return fn;
+    let fn = cachedGetterByKey[key];
+    if (isUndefined$1(fn)) {
+      fn = cachedGetterByKey[key] = function () {
+        const vm = getAssociatedVM(this);
+        const {
+          getHook
+        } = vm;
+        return getHook(vm.component, key);
+      };
+    }
+    return fn;
   }
   function createSetter(key) {
-      let fn = cachedSetterByKey[key];
-      if (isUndefined$1(fn)) {
-          fn = cachedSetterByKey[key] = function (newValue) {
-              const vm = getAssociatedVM(this);
-              const { setHook } = vm;
-              newValue = getReadOnlyProxy(newValue);
-              setHook(vm.component, key, newValue);
-          };
-      }
-      return fn;
+    let fn = cachedSetterByKey[key];
+    if (isUndefined$1(fn)) {
+      fn = cachedSetterByKey[key] = function (newValue) {
+        const vm = getAssociatedVM(this);
+        const {
+          setHook
+        } = vm;
+        newValue = getReadOnlyProxy(newValue);
+        setHook(vm.component, key, newValue);
+      };
+    }
+    return fn;
   }
   function createMethodCaller(methodName) {
-      return function () {
-          const vm = getAssociatedVM(this);
-          const { callHook, component } = vm;
-          const fn = component[methodName];
-          return callHook(vm.component, fn, ArraySlice.call(arguments));
-      };
+    return function () {
+      const vm = getAssociatedVM(this);
+      const {
+        callHook,
+        component
+      } = vm;
+      const fn = component[methodName];
+      return callHook(vm.component, fn, ArraySlice.call(arguments));
+    };
   }
   function createAttributeChangedCallback(attributeToPropMap, superAttributeChangedCallback) {
-      return function attributeChangedCallback(attrName, oldValue, newValue) {
-          if (oldValue === newValue) {
-              // Ignore same values.
-              return;
-          }
-          const propName = attributeToPropMap[attrName];
-          if (isUndefined$1(propName)) {
-              if (!isUndefined$1(superAttributeChangedCallback)) {
-                  // delegate unknown attributes to the super.
-                  // Typescript does not like it when you treat the `arguments` object as an array
-                  // @ts-ignore type-mismatch
-                  superAttributeChangedCallback.apply(this, arguments);
-              }
-              return;
-          }
-          if (!isAttributeLocked(this, attrName)) {
-              // Ignore changes triggered by the engine itself during:
-              // * diffing when public props are attempting to reflect to the DOM
-              // * component via `this.setAttribute()`, should never update the prop
-              // Both cases, the setAttribute call is always wrapped by the unlocking of the
-              // attribute to be changed
-              return;
-          }
-          // Reflect attribute change to the corresponding property when changed from outside.
-          this[propName] = newValue;
-      };
-  }
-  function HTMLBridgeElementFactory(SuperClass, props, methods) {
-      let HTMLBridgeElement;
-      /**
-       * Modern browsers will have all Native Constructors as regular Classes
-       * and must be instantiated with the new keyword. In older browsers,
-       * specifically IE11, those are objects with a prototype property defined,
-       * since they are not supposed to be extended or instantiated with the
-       * new keyword. This forking logic supports both cases, specifically because
-       * wc.ts relies on the construction path of the bridges to create new
-       * fully qualifying web components.
-       */
-      if (isFunction$1(SuperClass)) {
-          HTMLBridgeElement = class extends SuperClass {
-          };
-      }
-      else {
-          HTMLBridgeElement = function () {
-              // Bridge classes are not supposed to be instantiated directly in
-              // browsers that do not support web components.
-              throw new TypeError('Illegal constructor');
-          };
-          // prototype inheritance dance
-          setPrototypeOf(HTMLBridgeElement, SuperClass);
-          setPrototypeOf(HTMLBridgeElement.prototype, SuperClass.prototype);
-          defineProperty(HTMLBridgeElement.prototype, 'constructor', {
-              writable: true,
-              configurable: true,
-              value: HTMLBridgeElement,
-          });
+    return function attributeChangedCallback(attrName, oldValue, newValue) {
+      if (oldValue === newValue) {
+        // Ignore same values.
+        return;
       }
-      // generating the hash table for attributes to avoid duplicate fields and facilitate validation
-      // and false positives in case of inheritance.
-      const attributeToPropMap = create(null);
-      const { attributeChangedCallback: superAttributeChangedCallback } = SuperClass.prototype;
-      const { observedAttributes: superObservedAttributes = [] } = SuperClass;
-      const descriptors = create(null);
-      // expose getters and setters for each public props on the new Element Bridge
-      for (let i = 0, len = props.length; i < len; i += 1) {
-          const propName = props[i];
-          attributeToPropMap[htmlPropertyToAttribute(propName)] = propName;
-          descriptors[propName] = {
-              get: createGetter(propName),
-              set: createSetter(propName),
-              enumerable: true,
-              configurable: true,
-          };
+      const propName = attributeToPropMap[attrName];
+      if (isUndefined$1(propName)) {
+        if (!isUndefined$1(superAttributeChangedCallback)) {
+          // delegate unknown attributes to the super.
+          // Typescript does not like it when you treat the `arguments` object as an array
+          // @ts-ignore type-mismatch
+          superAttributeChangedCallback.apply(this, arguments);
+        }
+        return;
       }
-      // expose public methods as props on the new Element Bridge
-      for (let i = 0, len = methods.length; i < len; i += 1) {
-          const methodName = methods[i];
-          descriptors[methodName] = {
-              value: createMethodCaller(methodName),
-              writable: true,
-              configurable: true,
-          };
+      if (!isAttributeLocked(this, attrName)) {
+        // Ignore changes triggered by the engine itself during:
+        // * diffing when public props are attempting to reflect to the DOM
+        // * component via `this.setAttribute()`, should never update the prop
+        // Both cases, the setAttribute call is always wrapped by the unlocking of the
+        // attribute to be changed
+        return;
       }
-      // creating a new attributeChangedCallback per bridge because they are bound to the corresponding
-      // map of attributes to props. We do this after all other props and methods to avoid the possibility
-      // of getting overrule by a class declaration in user-land, and we make it non-writable, non-configurable
-      // to preserve this definition.
-      descriptors.attributeChangedCallback = {
-          value: createAttributeChangedCallback(attributeToPropMap, superAttributeChangedCallback),
+      // Reflect attribute change to the corresponding property when changed from outside.
+      this[propName] = newValue;
+    };
+  }
+  function HTMLBridgeElementFactory(SuperClass, props, methods) {
+    let HTMLBridgeElement;
+    /**
+     * Modern browsers will have all Native Constructors as regular Classes
+     * and must be instantiated with the new keyword. In older browsers,
+     * specifically IE11, those are objects with a prototype property defined,
+     * since they are not supposed to be extended or instantiated with the
+     * new keyword. This forking logic supports both cases, specifically because
+     * wc.ts relies on the construction path of the bridges to create new
+     * fully qualifying web components.
+     */
+    if (isFunction$1(SuperClass)) {
+      HTMLBridgeElement = class extends SuperClass {};
+    } else {
+      HTMLBridgeElement = function () {
+        // Bridge classes are not supposed to be instantiated directly in
+        // browsers that do not support web components.
+        throw new TypeError('Illegal constructor');
       };
-      // Specify attributes for which we want to reflect changes back to their corresponding
-      // properties via attributeChangedCallback.
-      defineProperty(HTMLBridgeElement, 'observedAttributes', {
-          get() {
-              return [...superObservedAttributes, ...keys(attributeToPropMap)];
-          },
+      // prototype inheritance dance
+      setPrototypeOf(HTMLBridgeElement, SuperClass);
+      setPrototypeOf(HTMLBridgeElement.prototype, SuperClass.prototype);
+      defineProperty(HTMLBridgeElement.prototype, 'constructor', {
+        writable: true,
+        configurable: true,
+        value: HTMLBridgeElement
       });
-      defineProperties(HTMLBridgeElement.prototype, descriptors);
-      return HTMLBridgeElement;
+    }
+    // generating the hash table for attributes to avoid duplicate fields and facilitate validation
+    // and false positives in case of inheritance.
+    const attributeToPropMap = create(null);
+    const {
+      attributeChangedCallback: superAttributeChangedCallback
+    } = SuperClass.prototype;
+    const {
+      observedAttributes: superObservedAttributes = []
+    } = SuperClass;
+    const descriptors = create(null);
+    // expose getters and setters for each public props on the new Element Bridge
+    for (let i = 0, len = props.length; i < len; i += 1) {
+      const propName = props[i];
+      attributeToPropMap[htmlPropertyToAttribute(propName)] = propName;
+      descriptors[propName] = {
+        get: createGetter(propName),
+        set: createSetter(propName),
+        enumerable: true,
+        configurable: true
+      };
+    }
+    // expose public methods as props on the new Element Bridge
+    for (let i = 0, len = methods.length; i < len; i += 1) {
+      const methodName = methods[i];
+      descriptors[methodName] = {
+        value: createMethodCaller(methodName),
+        writable: true,
+        configurable: true
+      };
+    }
+    // creating a new attributeChangedCallback per bridge because they are bound to the corresponding
+    // map of attributes to props. We do this after all other props and methods to avoid the possibility
+    // of getting overrule by a class declaration in user-land, and we make it non-writable, non-configurable
+    // to preserve this definition.
+    descriptors.attributeChangedCallback = {
+      value: createAttributeChangedCallback(attributeToPropMap, superAttributeChangedCallback)
+    };
+    // Specify attributes for which we want to reflect changes back to their corresponding
+    // properties via attributeChangedCallback.
+    defineProperty(HTMLBridgeElement, 'observedAttributes', {
+      get() {
+        return [...superObservedAttributes, ...keys(attributeToPropMap)];
+      }
+    });
+    defineProperties(HTMLBridgeElement.prototype, descriptors);
+    return HTMLBridgeElement;
   }
   const BaseBridgeElement = HTMLBridgeElementFactory(HTMLElementConstructor, getOwnPropertyNames$1(HTMLElementOriginalDescriptors), []);
+  {
+    // This ARIA reflection only really makes sense in the browser. On the server, there is no `renderedCallback()`,
+    // so you cannot do e.g. `this.template.querySelector('x-child').ariaBusy = 'true'`. So we don't need to expose
+    // ARIA props outside the LightningElement
+    if (lwcRuntimeFlags.DISABLE_ARIA_REFLECTION_POLYFILL) {
+      // If ARIA reflection is not applied globally to Element.prototype, apply it to HTMLBridgeElement.prototype.
+      // This allows `elm.aria*` property accessors to work from outside a component, and to reflect `aria-*` attrs.
+      // This is especially important because the template compiler compiles aria-* attrs on components to aria* props
+      //
+      // Also note that we apply this to BaseBridgeElement.prototype to avoid excessively redefining property
+      // accessors inside the HTMLBridgeElementFactory.
+      applyAriaReflection(BaseBridgeElement.prototype);
+    }
+  }
   freeze(BaseBridgeElement);
   seal(BaseBridgeElement.prototype);
   function setActiveVM(vm) {
@@ -6257,7 +6383,7 @@
       function isNull(obj) {
           return obj === null;
       }
-      /** version: 2.32.1 */
+      /** version: 2.33.0 */
 
       /*
        * Copyright (c) 2018, salesforce.com, inc.
@@ -6810,7 +6936,7 @@
   });
   freeze(LightningElement);
   seal(LightningElement.prototype);
-  /* version: 2.32.1 */
+  /* version: 2.33.0 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;