lwc 2.37.3 → 2.38.1

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

@@ -318,7 +318,7 @@
       CACHED_ATTRIBUTE_PROPERTY_MAPPING.set(attrName, propertyName);
       return propertyName;
     }
-    /** version: 2.37.3 */
+    /** version: 2.38.1 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -390,7 +390,7 @@
      */
     function setFeatureFlagForTest(name, value) {
     }
-    /** version: 2.37.3 */
+    /** version: 2.38.1 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -454,7 +454,7 @@
         }
       }
     }
-    /** version: 2.37.3 */
+    /** version: 2.38.1 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -1795,6 +1795,11 @@
         var renderer = vm.renderer;
         return renderer.getLastElementChild(vm.elm);
       },
+      get ownerDocument() {
+        var vm = getAssociatedVM(this);
+        var renderer = vm.renderer;
+        return renderer.ownerDocument(vm.elm);
+      },
       render: function render() {
         var vm = getAssociatedVM(this);
         return vm.def.template;
@@ -1863,38 +1868,90 @@
     }
 
     /*
-     * Copyright (c) 2018, salesforce.com, inc.
+     * Copyright (c) 2023, 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
      */
-    var DeprecatedWiredElementHost = '$$DeprecatedWiredElementHostKey$$';
-    var DeprecatedWiredParamsMeta = '$$DeprecatedWiredParamsMetaKey$$';
-    var WireMetaMap = new Map();
-    var WireContextRegistrationEvent = /*#__PURE__*/function (_CustomEvent) {
-      _inherits(WireContextRegistrationEvent, _CustomEvent);
-      var _super3 = _createSuper(WireContextRegistrationEvent);
-      function WireContextRegistrationEvent(adapterToken, _ref3) {
-        var _this2;
-        var setNewContext = _ref3.setNewContext,
-          setDisconnectedCallback = _ref3.setDisconnectedCallback;
-        _classCallCheck(this, WireContextRegistrationEvent);
-        _this2 = _super3.call(this, adapterToken, {
-          bubbles: true,
-          composed: true
+    var AdapterToTokenMap = new Map();
+    function createContextProviderWithRegister(adapter, registerContextProvider) {
+      var adapterContextToken = AdapterToTokenMap.get(adapter);
+      if (!isUndefined$1(adapterContextToken)) {
+        throw new Error("Adapter already has a context provider.");
+      }
+      adapterContextToken = guid();
+      AdapterToTokenMap.set(adapter, adapterContextToken);
+      var providers = new WeakSet();
+      return function (elmOrComponent, options) {
+        if (providers.has(elmOrComponent)) {
+          throw new Error("Adapter was already installed on ".concat(elmOrComponent, "."));
+        }
+        providers.add(elmOrComponent);
+        var consumerConnectedCallback = options.consumerConnectedCallback,
+          consumerDisconnectedCallback = options.consumerDisconnectedCallback;
+        registerContextProvider(elmOrComponent, adapterContextToken, function (subscriptionPayload) {
+          var setNewContext = subscriptionPayload.setNewContext,
+            setDisconnectedCallback = subscriptionPayload.setDisconnectedCallback;
+          var consumer = {
+            provide: function provide(newContext) {
+              setNewContext(newContext);
+            }
+          };
+          var disconnectCallback = function disconnectCallback() {
+            if (!isUndefined$1(consumerDisconnectedCallback)) {
+              consumerDisconnectedCallback(consumer);
+            }
+          };
+          setDisconnectedCallback(disconnectCallback);
+          consumerConnectedCallback(consumer);
         });
-        defineProperties(_assertThisInitialized(_this2), {
-          setNewContext: {
-            value: setNewContext
+      };
+    }
+    function createContextWatcher(vm, wireDef, callbackWhenContextIsReady) {
+      var adapter = wireDef.adapter;
+      var adapterContextToken = AdapterToTokenMap.get(adapter);
+      if (isUndefined$1(adapterContextToken)) {
+        return; // no provider found, nothing to be done
+      }
+
+      var elm = vm.elm,
+        _vm$context = vm.context,
+        wiredConnecting = _vm$context.wiredConnecting,
+        wiredDisconnecting = _vm$context.wiredDisconnecting,
+        registerContextConsumer = vm.renderer.registerContextConsumer;
+      // waiting for the component to be connected to formally request the context via the token
+      ArrayPush$1.call(wiredConnecting, function () {
+        // This will attempt to connect the current element with one of its anscestors
+        // that can provide context for the given wire adapter. This relationship is
+        // keyed on the secret & internal value of `adapterContextToken`, which is unique
+        // to a given wire adapter.
+        //
+        // Depending on the runtime environment, this connection is made using either DOM
+        // events (in the browser) or a custom traversal (on the server).
+        registerContextConsumer(elm, adapterContextToken, {
+          setNewContext: function setNewContext(newContext) {
+            // eslint-disable-next-line @lwc/lwc-internal/no-invalid-todo
+            // TODO: dev-mode validation of config based on the adapter.contextSchema
+            callbackWhenContextIsReady(newContext);
           },
-          setDisconnectedCallback: {
-            value: setDisconnectedCallback
+          setDisconnectedCallback: function setDisconnectedCallback(disconnectCallback) {
+            // adds this callback into the disconnect bucket so it gets disconnected from parent
+            // the the element hosting the wire is disconnected
+            ArrayPush$1.call(wiredDisconnecting, disconnectCallback);
           }
         });
-        return _this2;
-      }
-      return _createClass(WireContextRegistrationEvent);
-    }( /*#__PURE__*/_wrapNativeSuper(CustomEvent));
+      });
+    }
+
+    /*
+     * Copyright (c) 2023, 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
+     */
+    var DeprecatedWiredElementHost = '$$DeprecatedWiredElementHostKey$$';
+    var DeprecatedWiredParamsMeta = '$$DeprecatedWiredParamsMetaKey$$';
+    var WireMetaMap = new Map();
     function createFieldDataCallback(vm, name) {
       return function (value) {
         updateComponentValue(vm, name, value);
@@ -1940,40 +1997,6 @@
         ro: ro
       };
     }
-    function createContextWatcher(vm, wireDef, callbackWhenContextIsReady) {
-      var adapter = wireDef.adapter;
-      var adapterContextToken = getAdapterToken(adapter);
-      if (isUndefined$1(adapterContextToken)) {
-        return; // no provider found, nothing to be done
-      }
-
-      var elm = vm.elm,
-        _vm$context = vm.context,
-        wiredConnecting = _vm$context.wiredConnecting,
-        wiredDisconnecting = _vm$context.wiredDisconnecting,
-        dispatchEvent = vm.renderer.dispatchEvent;
-      // waiting for the component to be connected to formally request the context via the token
-      ArrayPush$1.call(wiredConnecting, function () {
-        // This event is responsible for connecting the host element with another
-        // element in the composed path that is providing contextual data. The provider
-        // must be listening for a special dom event with the name corresponding to the value of
-        // `adapterContextToken`, which will remain secret and internal to this file only to
-        // guarantee that the linkage can be forged.
-        var contextRegistrationEvent = new WireContextRegistrationEvent(adapterContextToken, {
-          setNewContext: function setNewContext(newContext) {
-            // eslint-disable-next-line @lwc/lwc-internal/no-invalid-todo
-            // TODO: dev-mode validation of config based on the adapter.contextSchema
-            callbackWhenContextIsReady(newContext);
-          },
-          setDisconnectedCallback: function setDisconnectedCallback(disconnectCallback) {
-            // adds this callback into the disconnect bucket so it gets disconnected from parent
-            // the the element hosting the wire is disconnected
-            ArrayPush$1.call(wiredDisconnecting, disconnectCallback);
-          }
-        });
-        dispatchEvent(elm, contextRegistrationEvent);
-      });
-    }
     function createConnector(vm, name, wireDef) {
       var method = wireDef.method,
         adapter = wireDef.adapter,
@@ -2036,13 +2059,6 @@
         }
       };
     }
-    var AdapterToTokenMap = new Map();
-    function getAdapterToken(adapter) {
-      return AdapterToTokenMap.get(adapter);
-    }
-    function setAdapterToken(adapter, token) {
-      AdapterToTokenMap.set(adapter, token);
-    }
     function storeWiredMethodMeta(descriptor, adapter, configCallback, dynamic) {
       // support for callable adapters
       if (adapter.adapter) {
@@ -2468,10 +2484,10 @@
       if (isFunction$1(SuperClass)) {
         HTMLBridgeElement = /*#__PURE__*/function (_SuperClass) {
           _inherits(HTMLBridgeElement, _SuperClass);
-          var _super4 = _createSuper(HTMLBridgeElement);
+          var _super3 = _createSuper(HTMLBridgeElement);
           function HTMLBridgeElement() {
             _classCallCheck(this, HTMLBridgeElement);
-            return _super4.apply(this, arguments);
+            return _super3.apply(this, arguments);
           }
           return _createClass(HTMLBridgeElement);
         }(SuperClass);
@@ -4650,8 +4666,8 @@
      */
     function registerComponent(
     // We typically expect a LightningElementConstructor, but technically you can call this with anything
-    Ctor, _ref4) {
-      var tmpl = _ref4.tmpl;
+    Ctor, _ref3) {
+      var tmpl = _ref3.tmpl;
       if (isFunction$1(Ctor)) {
         signedTemplateMap.set(Ctor, tmpl);
       }
@@ -5128,19 +5144,30 @@
     // into snabbdom. Especially useful when the reset is a consequence of an error, in which case the
     // children VNodes might not be representing the current state of the DOM.
     function resetComponentRoot(vm) {
-      var children = vm.children,
-        renderRoot = vm.renderRoot,
-        remove = vm.renderer.remove;
-      for (var _i32 = 0, len = children.length; _i32 < len; _i32++) {
-        var child = children[_i32];
-        if (!isNull(child) && !isUndefined$1(child.elm)) {
-          remove(child.elm, renderRoot);
-        }
-      }
+      recursivelyRemoveChildren(vm.children, vm);
       vm.children = EmptyArray;
       runChildNodesDisconnectedCallback(vm);
       vm.velements = EmptyArray;
     }
+    // Helper function to remove all children of the root node.
+    // If the set of children includes VFragment nodes, we need to remove the children of those nodes too.
+    // Since VFragments can contain other VFragments, we need to traverse the entire of tree of VFragments.
+    // If the set contains no VFragment nodes, no traversal is needed.
+    function recursivelyRemoveChildren(vnodes, vm) {
+      var renderRoot = vm.renderRoot,
+        remove = vm.renderer.remove;
+      for (var _i32 = 0, len = vnodes.length; _i32 < len; _i32 += 1) {
+        var vnode = vnodes[_i32];
+        if (!isNull(vnode)) {
+          // VFragments are special; their .elm property does not point to the root element since they have no single root.
+          if (isVFragment(vnode)) {
+            recursivelyRemoveChildren(vnode.children, vm);
+          } else if (!isUndefined$1(vnode.elm)) {
+            remove(vnode.elm, renderRoot);
+          }
+        }
+      }
+    }
     function scheduleRehydration(vm) {
       if (isTrue(vm.isScheduled)) {
         return;
@@ -5201,6 +5228,10 @@
     // Use the unpatched native getElementById/querySelectorAll rather than the synthetic one
     var getElementById = _globalThis[KEY__NATIVE_GET_ELEMENT_BY_ID];
     var querySelectorAll = _globalThis[KEY__NATIVE_QUERY_SELECTOR_ALL];
+    // This is a "handoff" from synthetic-shadow to engine-core – we want to clean up after ourselves
+    // so nobody else can misuse these global APIs.
+    delete _globalThis[KEY__NATIVE_GET_ELEMENT_BY_ID];
+    delete _globalThis[KEY__NATIVE_QUERY_SELECTOR_ALL];
     function isSyntheticShadowRootInstance(rootNode) {
       return rootNode !== document && isTrue(rootNode.synthetic);
     }
@@ -5448,63 +5479,6 @@
       }
     }
 
-    /*
-     * 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
-     */
-    // this is lwc internal implementation
-    function createContextProvider(adapter) {
-      var adapterContextToken = getAdapterToken(adapter);
-      if (!isUndefined$1(adapterContextToken)) {
-        throw new Error("Adapter already has a context provider.");
-      }
-      adapterContextToken = guid();
-      setAdapterToken(adapter, adapterContextToken);
-      var providers = new WeakSet();
-      return function (elm, options) {
-        if (providers.has(elm)) {
-          throw new Error("Adapter was already installed on ".concat(elm, "."));
-        }
-        providers.add(elm);
-        var consumerConnectedCallback = options.consumerConnectedCallback,
-          consumerDisconnectedCallback = options.consumerDisconnectedCallback;
-        elm.addEventListener(adapterContextToken, function (evt) {
-          var setNewContext = evt.setNewContext,
-            setDisconnectedCallback = evt.setDisconnectedCallback;
-          var consumer = {
-            provide: function provide(newContext) {
-              setNewContext(newContext);
-            }
-          };
-          var disconnectCallback = function disconnectCallback() {
-            if (!isUndefined$1(consumerDisconnectedCallback)) {
-              consumerDisconnectedCallback(consumer);
-            }
-          };
-          setDisconnectedCallback(disconnectCallback);
-          consumerConnectedCallback(consumer);
-          evt.stopImmediatePropagation();
-        });
-      };
-    }
-
-    /*
-     * 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
-     */
-    /**
-     * EXPERIMENTAL: This function allows you to create a reactive readonly
-     * membrane around any object value. This API is subject to change or
-     * being removed.
-     */
-    function readonly(obj) {
-      return getReadOnlyProxy(obj);
-    }
-
     /*
      * Copyright (c) 2022, salesforce.com, inc.
      * All rights reserved.
@@ -6132,6 +6106,21 @@
       return ctor;
     }
 
+    /*
+     * 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
+     */
+    /**
+     * EXPERIMENTAL: This function allows you to create a reactive readonly
+     * membrane around any object value. This API is subject to change or
+     * being removed.
+     */
+    function readonly(obj) {
+      return getReadOnlyProxy(obj);
+    }
+
     /*
      * Copyright (c) 2018, salesforce.com, inc.
      * All rights reserved.
@@ -6281,10 +6270,10 @@
         // which are not equipped to be initialized that way.
         var clazz = /*#__PURE__*/function (_HTMLElementAlias) {
           _inherits(clazz, _HTMLElementAlias);
-          var _super5 = _createSuper(clazz);
+          var _super4 = _createSuper(clazz);
           function clazz() {
             _classCallCheck(this, clazz);
-            return _super5.apply(this, arguments);
+            return _super4.apply(this, arguments);
           }
           return _createClass(clazz);
         }(HTMLElementAlias);
@@ -6330,24 +6319,24 @@
       // TODO [#2972]: this class should expose observedAttributes as necessary
       var UpgradableConstructor = /*#__PURE__*/function (_HTMLElement) {
         _inherits(UpgradableConstructor, _HTMLElement);
-        var _super6 = _createSuper(UpgradableConstructor);
+        var _super5 = _createSuper(UpgradableConstructor);
         function UpgradableConstructor(upgradeCallback) {
-          var _this3;
+          var _this2;
           _classCallCheck(this, UpgradableConstructor);
-          _this3 = _super6.call(this);
+          _this2 = _super5.call(this);
           // If the element is not created using lwc.createElement(), e.g. `document.createElement('x-foo')`,
           // then elementBeingUpgraded will be false
           if (elementBeingUpgradedByLWC) {
-            upgradeCallback(_assertThisInitialized(_this3));
+            upgradeCallback(_assertThisInitialized(_this2));
           } else if (hasConnectedCallback || hasDisconnectedCallback) {
             // If this element has connected or disconnected callbacks, then we need to keep track of
             // instances that were created outside LWC (i.e. not created by `lwc.createElement()`).
             // If the element has no connected or disconnected callbacks, then we don't need to track this.
-            elementsUpgradedOutsideLWC.add(_assertThisInitialized(_this3));
+            elementsUpgradedOutsideLWC.add(_assertThisInitialized(_this2));
             // TODO [#2970]: LWC elements cannot be upgraded via new Ctor()
             // Do we want to support this? Throw an error? Currently for backwards compat it's a no-op.
           }
-          return _this3;
+          return _this2;
         }
         return _createClass(UpgradableConstructor);
       }( /*#__PURE__*/_wrapNativeSuper(HTMLElement)); // Do not unnecessarily add a connectedCallback/disconnectedCallback, as it introduces perf overhead
@@ -6469,7 +6458,46 @@
         function isNull(obj) {
           return obj === null;
         }
-        /** version: 2.37.3 */
+        /** version: 2.38.1 */
+
+        /*
+         * Copyright (c) 2023, 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
+         */
+        var WireContextSubscriptionEvent = /*#__PURE__*/function (_CustomEvent) {
+          _inherits(WireContextSubscriptionEvent, _CustomEvent);
+          var _super6 = _createSuper(WireContextSubscriptionEvent);
+          function WireContextSubscriptionEvent(adapterToken, _ref6) {
+            var _this3;
+            var setNewContext = _ref6.setNewContext,
+              setDisconnectedCallback = _ref6.setDisconnectedCallback;
+            _classCallCheck(this, WireContextSubscriptionEvent);
+            _this3 = _super6.call(this, adapterToken, {
+              bubbles: true,
+              composed: true
+            });
+            _this3.setNewContext = setNewContext;
+            _this3.setDisconnectedCallback = setDisconnectedCallback;
+            return _this3;
+          }
+          return _createClass(WireContextSubscriptionEvent);
+        }( /*#__PURE__*/_wrapNativeSuper(CustomEvent));
+        function registerContextConsumer(elm, adapterContextToken, subscriptionPayload) {
+          dispatchEvent(elm, new WireContextSubscriptionEvent(adapterContextToken, subscriptionPayload));
+        }
+        function registerContextProvider(elm, adapterContextToken, onContextSubscription) {
+          addEventListener(elm, adapterContextToken, function (evt) {
+            evt.stopImmediatePropagation();
+            var setNewContext = evt.setNewContext,
+              setDisconnectedCallback = evt.setDisconnectedCallback;
+            onContextSubscription({
+              setNewContext: setNewContext,
+              setDisconnectedCallback: setDisconnectedCallback
+            });
+          });
+        }
 
         /*
          * Copyright (c) 2018, salesforce.com, inc.
@@ -6651,6 +6679,9 @@
         function assertInstanceOfHTMLElement(elm, msg) {
           assert.invariant(elm instanceof HTMLElement, msg);
         }
+        function ownerDocument(element) {
+          return element.ownerDocument;
+        }
         exports.addEventListener = addEventListener;
         exports.assertInstanceOfHTMLElement = assertInstanceOfHTMLElement;
         exports.attachShadow = attachShadow;
@@ -6674,8 +6705,11 @@
         exports.insert = insert;
         exports.isConnected = isConnected;
         exports.nextSibling = nextSibling;
+        exports.ownerDocument = ownerDocument;
         exports.querySelector = querySelector;
         exports.querySelectorAll = querySelectorAll;
+        exports.registerContextConsumer = registerContextConsumer;
+        exports.registerContextProvider = registerContextProvider;
         exports.remove = remove;
         exports.removeAttribute = removeAttribute;
         exports.removeEventListener = removeEventListener;
@@ -7028,7 +7062,38 @@
     });
     freeze(LightningElement);
     seal(LightningElement.prototype);
-    /* version: 2.37.3 */
+
+    /*
+     * 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 addEventListener(target, type, callback, options) {
+      target.addEventListener(type, callback, options);
+    }
+
+    /*
+     * Copyright (c) 2023, 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 createContextProvider(adapter) {
+      return createContextProviderWithRegister(adapter, registerContextProvider);
+    }
+    function registerContextProvider(elm, adapterContextToken, onContextSubscription) {
+      addEventListener(elm, adapterContextToken, function (evt) {
+        evt.stopImmediatePropagation();
+        var setNewContext = evt.setNewContext,
+          setDisconnectedCallback = evt.setDisconnectedCallback;
+        onContextSubscription({
+          setNewContext: setNewContext,
+          setDisconnectedCallback: setDisconnectedCallback
+        });
+      });
+    }
+    /* version: 2.38.1 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;
@@ -7064,3 +7129,4 @@
     exports.wire = wire;
 
 }));
+//# sourceMappingURL=engine-dom_debug.js.map