lwc 2.37.3 → 2.38.1

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

@@ -201,6 +201,8 @@ const KEY__SHADOW_RESOLVER = '$shadowResolver$';
 const KEY__SHADOW_STATIC = '$shadowStaticNode$';
 const KEY__SYNTHETIC_MODE = '$$lwc-synthetic-mode';
 const KEY__SCOPED_CSS = '$scoped$';
+const KEY__NATIVE_GET_ELEMENT_BY_ID = '$nativeGetElementById$';
+const KEY__NATIVE_QUERY_SELECTOR_ALL = '$nativeQuerySelectorAll$';
 
 /*
  * Copyright (c) 2022, salesforce.com, inc.
@@ -440,9 +442,9 @@ function htmlEscape(str, attrMode = false) {
  * 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.
@@ -521,7 +523,7 @@ function setFeatureFlagForTest(name, value) {
         setFeatureFlag(name, value);
     }
 }
-/** version: 2.37.3 */
+/** version: 2.38.1 */
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -617,7 +619,7 @@ function applyAriaReflection(prototype = Element.prototype) {
         }
     }
 }
-/** version: 2.37.3 */
+/** version: 2.38.1 */
 
 /* proxy-compat-disable */
 
@@ -2191,6 +2193,14 @@ LightningElement.prototype = {
         }
         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;
@@ -2265,31 +2275,84 @@ function createObservedFieldPropertyDescriptor(key) {
 }
 
 /*
- * 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);
@@ -2320,35 +2383,6 @@ function createConfigWatcher(component, configCallback, callbackWhenConfigIsRead
         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;
@@ -2423,13 +2457,6 @@ function createConnector(vm, name, wireDef) {
         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) {
@@ -5890,17 +5917,30 @@ function recursivelyDisconnectChildren(vnodes) {
 // 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 getErrorBoundaryVM(vm) {
     let currentVm = vm;
     while (!isNull(currentVm)) {
@@ -5936,67 +5976,10 @@ function runWithBoundaryProtection(vm, owner, pre, job, post) {
         }
     }
 }
-
-/*
- * 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);
-}
+// 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];
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -6213,7 +6196,28 @@ function freezeTemplate(tmpl) {
         }
     }
 }
-/* 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) 2020, salesforce.com, inc.
@@ -6229,8 +6233,9 @@ const HostParentKey = Symbol('parent');
 const HostShadowRootKey = Symbol('shadow-root');
 const HostChildrenKey = Symbol('children');
 const HostAttributesKey = Symbol('attributes');
-const HostEventListenersKey = Symbol('event-listeners');
 const HostValueKey = Symbol('value');
+const HostHostKey = Symbol('host');
+const HostContextProvidersKey = Symbol('context-providers');
 var HostNodeType;
 (function (HostNodeType) {
     HostNodeType["Text"] = "text";
@@ -6254,6 +6259,48 @@ function tokenListToClassName(values) {
     return Array.from(values).join(' ');
 }
 
+/*
+ * 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) {
+    const vm = getAssociatedVMIfPresent(elm);
+    if (!isUndefined$1(vm)) {
+        elm = vm.elm;
+    }
+    const contextProviders = elm[HostContextProvidersKey];
+    if (isUndefined$1(contextProviders)) {
+        throw new Error('Unable to register context provider on provided `elm`.');
+    }
+    contextProviders.set(adapterContextToken, onContextSubscription);
+}
+function registerContextConsumer(elm, adapterContextToken, subscriptionPayload) {
+    // Traverse element ancestors, looking for an element that can provide context
+    // for the adapter identified by `adapterContextToken`. If found, register
+    // to receive context updates from that provider.
+    let currentNode = elm;
+    do {
+        if (currentNode[HostTypeKey] === HostNodeType.Element) {
+            const subscribeToProvider = currentNode[HostContextProvidersKey].get(adapterContextToken);
+            if (!isUndefined$1(subscribeToProvider)) {
+                subscribeToProvider(subscriptionPayload);
+                // If we find a provider, we shouldn't continue traversing
+                // looking for another provider.
+                break;
+            }
+        }
+        currentNode =
+            currentNode[HostTypeKey] === HostNodeType.Element
+                ? currentNode[HostParentKey]
+                : currentNode[HostHostKey];
+    } while (!isNull(currentNode));
+}
+
 /*
  * Copyright (c) 2020, salesforce.com, inc.
  * All rights reserved.
@@ -6274,7 +6321,7 @@ function createElement$1(tagName, namespace) {
         [HostShadowRootKey]: null,
         [HostChildrenKey]: [],
         [HostAttributesKey]: [],
-        [HostEventListenersKey]: {},
+        [HostContextProvidersKey]: new Map(),
     };
 }
 const isNativeShadowDefined = false;
@@ -6340,6 +6387,7 @@ function attachShadow(element, config) {
     element[HostShadowRootKey] = {
         [HostTypeKey]: HostNodeType.ShadowRoot,
         [HostChildrenKey]: [],
+        [HostHostKey]: element,
         mode: config.mode,
         delegatesFocus: !!config.delegatesFocus,
     };
@@ -6536,6 +6584,7 @@ function createCustomElement(tagName, upgradeCallback) {
     const UpgradableConstructor = getUpgradableElement(tagName);
     return new UpgradableConstructor(upgradeCallback);
 }
+const ownerDocument = unsupportedMethod('ownerDocument');
 const renderer = {
     isNativeShadowDefined,
     isSyntheticShadowDefined,
@@ -6574,6 +6623,8 @@ const renderer = {
     isConnected,
     insertStylesheet,
     assertInstanceOfHTMLElement,
+    ownerDocument,
+    registerContextConsumer,
 };
 
 /*
@@ -6650,7 +6701,7 @@ const FakeRootElement = {
     [HostShadowRootKey]: null,
     [HostChildrenKey]: [],
     [HostAttributesKey]: [],
-    [HostEventListenersKey]: {},
+    [HostContextProvidersKey]: new Map(),
 };
 function renderComponent(tagName, Ctor, props = {}) {
     if (!isString(tagName)) {
@@ -6701,6 +6752,7 @@ seal(LightningElement.prototype);
 function createElement() {
     throw new Error('createElement is not supported in @lwc/engine-server, only @lwc/engine-dom.');
 }
-/* version: 2.37.3 */
+/* version: 2.38.1 */
 
 export { LightningElement, api$1 as api, createContextProvider, createElement, freezeTemplate, getComponentDef, isComponentConstructor, parseFragment, parseFragment as parseSVGFragment, readonly, register, registerComponent, registerDecorators, registerTemplate, renderComponent, renderer, sanitizeAttribute, setFeatureFlag, setFeatureFlagForTest, setHooks, track, unwrap, wire };
+//# sourceMappingURL=engine-server.js.map