lwc 2.37.3 → 2.38.1

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

@@ -353,9 +353,9 @@
      * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
      */
     // Increment whenever the LWC template compiler changes
-    const LWC_VERSION = "2.37.3";
+    const LWC_VERSION = "2.38.1";
     const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-    /** version: 2.37.3 */
+    /** version: 2.38.1 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -434,7 +434,7 @@
             setFeatureFlag(name, value);
         }
     }
-    /** version: 2.37.3 */
+    /** version: 2.38.1 */
 
     /**
      * Copyright (C) 2018 salesforce.com, inc.
@@ -498,7 +498,7 @@
             }
         }
     }
-    /** version: 2.37.3 */
+    /** version: 2.38.1 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -2296,6 +2296,14 @@
             }
             return renderer.getLastElementChild(vm.elm);
         },
+        get ownerDocument() {
+            const vm = getAssociatedVM(this);
+            const renderer = vm.renderer;
+            if (process.env.NODE_ENV !== 'production') {
+                warnIfInvokedDuringConstruction(vm, 'ownerDocument');
+            }
+            return renderer.ownerDocument(vm.elm);
+        },
         render() {
             const vm = getAssociatedVM(this);
             return vm.def.template;
@@ -2371,31 +2379,84 @@
     }
 
     /*
-     * 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
      */
-    const DeprecatedWiredElementHost = '$$DeprecatedWiredElementHostKey$$';
-    const DeprecatedWiredParamsMeta = '$$DeprecatedWiredParamsMetaKey$$';
-    const WIRE_DEBUG_ENTRY = '@wire';
-    const WireMetaMap = new Map();
-    class WireContextRegistrationEvent extends CustomEvent {
-        constructor(adapterToken, { setNewContext, setDisconnectedCallback }) {
-            super(adapterToken, {
-                bubbles: true,
-                composed: true,
+    const AdapterToTokenMap = new Map();
+    function createContextProviderWithRegister(adapter, registerContextProvider) {
+        let adapterContextToken = AdapterToTokenMap.get(adapter);
+        if (!isUndefined$1(adapterContextToken)) {
+            throw new Error(`Adapter already has a context provider.`);
+        }
+        adapterContextToken = guid();
+        AdapterToTokenMap.set(adapter, adapterContextToken);
+        const providers = new WeakSet();
+        return (elmOrComponent, options) => {
+            if (providers.has(elmOrComponent)) {
+                throw new Error(`Adapter was already installed on ${elmOrComponent}.`);
+            }
+            providers.add(elmOrComponent);
+            const { consumerConnectedCallback, consumerDisconnectedCallback } = options;
+            registerContextProvider(elmOrComponent, adapterContextToken, (subscriptionPayload) => {
+                const { setNewContext, setDisconnectedCallback } = subscriptionPayload;
+                const consumer = {
+                    provide(newContext) {
+                        setNewContext(newContext);
+                    },
+                };
+                const disconnectCallback = () => {
+                    if (!isUndefined$1(consumerDisconnectedCallback)) {
+                        consumerDisconnectedCallback(consumer);
+                    }
+                };
+                setDisconnectedCallback(disconnectCallback);
+                consumerConnectedCallback(consumer);
             });
-            defineProperties(this, {
-                setNewContext: {
-                    value: setNewContext,
+        };
+    }
+    function createContextWatcher(vm, wireDef, callbackWhenContextIsReady) {
+        const { adapter } = wireDef;
+        const adapterContextToken = AdapterToTokenMap.get(adapter);
+        if (isUndefined$1(adapterContextToken)) {
+            return; // no provider found, nothing to be done
+        }
+        const { elm, context: { wiredConnecting, wiredDisconnecting }, renderer: { registerContextConsumer }, } = vm;
+        // waiting for the component to be connected to formally request the context via the token
+        ArrayPush$1.call(wiredConnecting, () => {
+            // 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(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(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);
                 },
             });
-        }
+        });
     }
+
+    /*
+     * 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
+     */
+    const DeprecatedWiredElementHost = '$$DeprecatedWiredElementHostKey$$';
+    const DeprecatedWiredParamsMeta = '$$DeprecatedWiredParamsMetaKey$$';
+    const WIRE_DEBUG_ENTRY = '@wire';
+    const WireMetaMap = new Map();
     function createFieldDataCallback(vm, name) {
         return (value) => {
             updateComponentValue(vm, name, value);
@@ -2439,35 +2500,6 @@
             ro,
         };
     }
-    function createContextWatcher(vm, wireDef, callbackWhenContextIsReady) {
-        const { adapter } = wireDef;
-        const adapterContextToken = getAdapterToken(adapter);
-        if (isUndefined$1(adapterContextToken)) {
-            return; // no provider found, nothing to be done
-        }
-        const { elm, context: { wiredConnecting, wiredDisconnecting }, renderer: { dispatchEvent }, } = vm;
-        // waiting for the component to be connected to formally request the context via the token
-        ArrayPush$1.call(wiredConnecting, () => {
-            // 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.
-            const contextRegistrationEvent = new WireContextRegistrationEvent(adapterContextToken, {
-                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(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) {
         const { method, adapter, configCallback, dynamic } = wireDef;
         let debugInfo;
@@ -2542,13 +2574,6 @@
             resetConfigWatcher: () => ro.reset(),
         };
     }
-    const 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) {
@@ -6269,17 +6294,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) {
-        const { children, renderRoot, renderer: { remove }, } = vm;
-        for (let i = 0, len = children.length; i < len; i++) {
-            const child = children[i];
-            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) {
+        const { renderRoot, renderer: { remove }, } = vm;
+        for (let i = 0, len = vnodes.length; i < len; i += 1) {
+            const vnode = vnodes[i];
+            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;
@@ -6357,6 +6395,10 @@
     // Use the unpatched native getElementById/querySelectorAll rather than the synthetic one
     const getElementById = _globalThis[KEY__NATIVE_GET_ELEMENT_BY_ID];
     const 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);
     }
@@ -6604,67 +6646,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) {
-        let adapterContextToken = getAdapterToken(adapter);
-        if (!isUndefined$1(adapterContextToken)) {
-            throw new Error(`Adapter already has a context provider.`);
-        }
-        adapterContextToken = guid();
-        setAdapterToken(adapter, adapterContextToken);
-        const providers = new WeakSet();
-        return (elm, options) => {
-            if (providers.has(elm)) {
-                throw new Error(`Adapter was already installed on ${elm}.`);
-            }
-            providers.add(elm);
-            const { consumerConnectedCallback, consumerDisconnectedCallback } = options;
-            elm.addEventListener(adapterContextToken, ((evt) => {
-                const { setNewContext, setDisconnectedCallback } = evt;
-                const consumer = {
-                    provide(newContext) {
-                        setNewContext(newContext);
-                    },
-                };
-                const 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) {
-        if (process.env.NODE_ENV !== 'production') {
-            // TODO [#1292]: Remove the readonly decorator
-            if (arguments.length !== 1) {
-                assert.fail('@readonly cannot be used as a decorator just yet, use it as a function with one argument to produce a readonly version of the provided value.');
-            }
-        }
-        return getReadOnlyProxy(obj);
-    }
-
     /*
      * Copyright (c) 2022, salesforce.com, inc.
      * All rights reserved.
@@ -7354,7 +7335,28 @@
         }
         return ctor;
     }
-    /* 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
+     */
+    /**
+     * 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) {
+        if (process.env.NODE_ENV !== 'production') {
+            // TODO [#1292]: Remove the readonly decorator
+            if (arguments.length !== 1) {
+                assert.fail('@readonly cannot be used as a decorator just yet, use it as a function with one argument to produce a readonly version of the provided value.');
+            }
+        }
+        return getReadOnlyProxy(obj);
+    }
+    /* version: 2.38.1 */
 
     /*
      * Copyright (c) 2018, salesforce.com, inc.
@@ -7782,7 +7784,37 @@
         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
+         */
+        class WireContextSubscriptionEvent extends CustomEvent {
+            constructor(adapterToken, { setNewContext, setDisconnectedCallback }) {
+                super(adapterToken, {
+                    bubbles: true,
+                    composed: true,
+                });
+                this.setNewContext = setNewContext;
+                this.setDisconnectedCallback = setDisconnectedCallback;
+            }
+        }
+        function registerContextConsumer(elm, adapterContextToken, subscriptionPayload) {
+            dispatchEvent(elm, new WireContextSubscriptionEvent(adapterContextToken, subscriptionPayload));
+        }
+        function registerContextProvider(elm, adapterContextToken, onContextSubscription) {
+            addEventListener(elm, adapterContextToken, ((evt) => {
+                evt.stopImmediatePropagation();
+                const { setNewContext, setDisconnectedCallback } = evt;
+                onContextSubscription({
+                    setNewContext,
+                    setDisconnectedCallback,
+                });
+            }));
+        }
 
         /*
          * Copyright (c) 2018, salesforce.com, inc.
@@ -7963,6 +7995,9 @@
         function assertInstanceOfHTMLElement(elm, msg) {
             assert.invariant(elm instanceof HTMLElement, msg);
         }
+        function ownerDocument(element) {
+            return element.ownerDocument;
+        }
 
         exports.addEventListener = addEventListener;
         exports.assertInstanceOfHTMLElement = assertInstanceOfHTMLElement;
@@ -7987,8 +8022,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;
@@ -8335,7 +8373,37 @@
     });
     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, ((evt) => {
+            evt.stopImmediatePropagation();
+            const { setNewContext, setDisconnectedCallback } = evt;
+            onContextSubscription({
+                setNewContext,
+                setDisconnectedCallback,
+            });
+        }));
+    }
+    /* version: 2.38.1 */
 
     exports.LightningElement = LightningElement;
     exports.__unstable__ProfilerControl = profilerControl;
@@ -8371,3 +8439,4 @@
     exports.wire = wire;
 
 }));
+//# sourceMappingURL=engine-dom.js.map