@lwc/engine-core 8.19.0 → 8.20.0

package/README.md

@@ -121,3 +121,18 @@ This experimental API enables the removal of an object's observable membrane pro
 This experimental API enables the addition of a signal as a trusted signal. If the [ENABLE_EXPERIMENTAL_SIGNALS](https://github.com/salesforce/lwc/blob/master/packages/%40lwc/features/README.md#lwcfeatures) feature is enabled, any signal value change will trigger a re-render.
 
 If `setTrustedSignalSet` is called more than once, it will throw an error. If it is never called, then no trusted signal validation will be performed. The same `setTrustedSignalSet` API must be called on both `@lwc/engine-dom` and `@lwc/signals`.
+
+### setContextKeys
+
+Not intended for external use. Enables another library to establish contextful relationships via the LWC component tree. The `connectContext` and `disconnectContext` symbols that are provided are later used to identify methods that facilitate the establishment and dissolution of these contextful relationships.
+
+### setTrustedContextSet()
+
+Not intended for external use. This experimental API enables the addition of context as trusted context. If the [ENABLE_EXPERIMENTAL_SIGNALS](https://github.com/salesforce/lwc/blob/master/packages/%40lwc/features/README.md#lwcfeatures) feature is enabled.
+
+If `setTrustedContextSet` is called more than once, it will throw an error. If it is never called, then context will not be connected.
+
+### ContextBinding
+
+The context object's `connectContext` and `disconnectContext` methods are called with this object when contextful components are connected and disconnected. The ContextBinding exposes `provideContext` and `consumeContext`,
+enabling the provision/consumption of a contextful Signal of a specified variety for the associated component.

package/dist/framework/main.d.ts

@@ -28,6 +28,6 @@ export { default as track } from './decorators/track';
 export { default as wire } from './decorators/wire';
 export { readonly } from './readonly';
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
-export { setTrustedSignalSet } from '@lwc/shared';
+export { setContextKeys, setTrustedSignalSet, setTrustedContextSet } from '@lwc/shared';
 export type { Stylesheet, Stylesheets } from '@lwc/shared';
 //# sourceMappingURL=main.d.ts.map

package/dist/framework/modules/context.d.ts

@@ -0,0 +1,4 @@
+import { type VM } from '../vm';
+export declare function connectContext(vm: VM): void;
+export declare function disconnectContext(vm: VM): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/framework/renderer.d.ts

@@ -1,4 +1,4 @@
-import type { WireContextSubscriptionPayload } from './wiring';
+import type { WireContextSubscriptionCallback, WireContextSubscriptionPayload } from './wiring';
 export type HostNode = any;
 export type HostElement = any;
 type N = HostNode;
@@ -47,6 +47,7 @@ export interface RendererAPI {
     createCustomElement: (tagName: string, upgradeCallback: LifecycleCallback, useNativeLifecycle: boolean, isFormAssociated: boolean) => E;
     defineCustomElement: (tagName: string, isFormAssociated: boolean) => void;
     ownerDocument(elm: E): Document;
+    registerContextProvider: (element: E, adapterContextToken: string, onContextSubscription: WireContextSubscriptionCallback) => void;
     registerContextConsumer: (element: E, adapterContextToken: string, subscriptionPayload: WireContextSubscriptionPayload) => void;
     attachInternals: (elm: E) => ElementInternals;
     startTrackingMutations: (elm: E) => void;

package/dist/framework/wiring/types.d.ts

@@ -35,10 +35,11 @@ export interface WireDebugInfo {
     context?: ContextValue;
     wasDataProvisionedForConfig: boolean;
 }
-export type WireContextSubscriptionCallback = (subscriptionPayload: WireContextSubscriptionPayload) => void;
+export type ShouldContinueBubbling = boolean;
+export type WireContextSubscriptionCallback = (subscriptionPayload: WireContextSubscriptionPayload) => ShouldContinueBubbling;
 export interface WireContextSubscriptionPayload {
-    setNewContext(newContext: ContextValue): void;
-    setDisconnectedCallback(disconnectCallback: () => void): void;
+    setNewContext(newContext: ContextValue): ShouldContinueBubbling;
+    setDisconnectedCallback?(disconnectCallback: () => void): void;
 }
 export interface ContextConsumer {
     provide(newContext: ContextValue): void;

package/dist/index.cjs.js

@@ -611,6 +611,7 @@ function componentValueObserved(vm, key, target = {}) {
         shared.isObject(target) &&
         !shared.isNull(target) &&
         shared.isTrustedSignal(target) &&
+        process.env.IS_BROWSER &&
         // Only subscribe if a template is being rendered by the engine
         tro.isObserving()) {
         // Subscribe the template reactive observer's notify method, which will mark the vm as dirty and schedule hydration.
@@ -2145,8 +2146,11 @@ function createContextProviderWithRegister(adapter, registerContextProvider) {
                     consumerDisconnectedCallback(consumer);
                 }
             };
-            setDisconnectedCallback(disconnectCallback);
+            setDisconnectedCallback?.(disconnectCallback);
             consumerConnectedCallback(consumer);
+            // Return true as the context is always consumed here and the consumer should
+            // stop bubbling.
+            return true;
         });
     };
 }
@@ -2171,6 +2175,9 @@ function createContextWatcher(vm, wireDef, callbackWhenContextIsReady) {
                 // eslint-disable-next-line @lwc/lwc-internal/no-invalid-todo
                 // TODO: dev-mode validation of config based on the adapter.contextSchema
                 callbackWhenContextIsReady(newContext);
+                // Return true as the context is always consumed here and the consumer should
+                // stop bubbling.
+                return true;
             },
             setDisconnectedCallback(disconnectCallback) {
                 // adds this callback into the disconnect bucket so it gets disconnected from parent
@@ -6737,6 +6744,126 @@ function getWrappedComponentsListener(vm, listener) {
     return wrappedListener;
 }
 
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+function __classPrivateFieldGet(receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+}
+
+function __classPrivateFieldSet(receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+var _ContextBinding_renderer, _ContextBinding_providedContextVarieties, _ContextBinding_elm;
+class ContextBinding {
+    constructor(vm, component, providedContextVarieties) {
+        _ContextBinding_renderer.set(this, void 0);
+        _ContextBinding_providedContextVarieties.set(this, void 0);
+        _ContextBinding_elm.set(this, void 0);
+        this.component = component;
+        __classPrivateFieldSet(this, _ContextBinding_renderer, vm.renderer, "f");
+        __classPrivateFieldSet(this, _ContextBinding_elm, vm.elm, "f");
+        __classPrivateFieldSet(this, _ContextBinding_providedContextVarieties, providedContextVarieties, "f");
+        // Register the component as a context provider.
+        __classPrivateFieldGet(this, _ContextBinding_renderer, "f").registerContextProvider(__classPrivateFieldGet(this, _ContextBinding_elm, "f"), shared.ContextEventName, (contextConsumer) => {
+            // This callback is invoked when the provided context is consumed somewhere down
+            // in the component's subtree.
+            return contextConsumer.setNewContext(__classPrivateFieldGet(this, _ContextBinding_providedContextVarieties, "f"));
+        });
+    }
+    provideContext(contextVariety, providedContextSignal) {
+        if (__classPrivateFieldGet(this, _ContextBinding_providedContextVarieties, "f").has(contextVariety)) {
+            logWarnOnce('Multiple contexts of the same variety were provided. Only the first context will be used.');
+            return;
+        }
+        __classPrivateFieldGet(this, _ContextBinding_providedContextVarieties, "f").set(contextVariety, providedContextSignal);
+    }
+    consumeContext(contextVariety, contextProvidedCallback) {
+        __classPrivateFieldGet(this, _ContextBinding_renderer, "f").registerContextConsumer(__classPrivateFieldGet(this, _ContextBinding_elm, "f"), shared.ContextEventName, {
+            setNewContext: (providerContextVarieties) => {
+                // If the provider has the specified context variety, then it is consumed
+                // and true is returned to stop bubbling.
+                if (providerContextVarieties.has(contextVariety)) {
+                    contextProvidedCallback(providerContextVarieties.get(contextVariety));
+                    return true;
+                }
+                // Return false as context has not been found/consumed
+                // and the consumer should continue traversing the context tree
+                return false;
+            },
+        });
+    }
+}
+_ContextBinding_renderer = new WeakMap(), _ContextBinding_providedContextVarieties = new WeakMap(), _ContextBinding_elm = new WeakMap();
+function connectContext(vm) {
+    const contextKeys = shared.getContextKeys();
+    if (shared.isUndefined(contextKeys)) {
+        return;
+    }
+    const { connectContext } = contextKeys;
+    const { component } = vm;
+    const enumerableKeys = shared.keys(shared.getPrototypeOf(component));
+    const contextfulKeys = shared.ArrayFilter.call(enumerableKeys, (enumerableKey) => shared.isTrustedContext(component[enumerableKey]));
+    if (contextfulKeys.length === 0) {
+        return;
+    }
+    const providedContextVarieties = new Map();
+    try {
+        for (let i = 0; i < contextfulKeys.length; i++) {
+            component[contextfulKeys[i]][connectContext](new ContextBinding(vm, component, providedContextVarieties));
+        }
+    }
+    catch (err) {
+        logWarnOnce(`Attempted to connect to trusted context but received the following error: ${err.message}`);
+    }
+}
+function disconnectContext(vm) {
+    const contextKeys = shared.getContextKeys();
+    if (!contextKeys) {
+        return;
+    }
+    const { disconnectContext } = contextKeys;
+    const { component } = vm;
+    const enumerableKeys = shared.keys(shared.getPrototypeOf(component));
+    const contextfulKeys = shared.ArrayFilter.call(enumerableKeys, (enumerableKey) => shared.isTrustedContext(component[enumerableKey]));
+    if (contextfulKeys.length === 0) {
+        return;
+    }
+    try {
+        for (let i = 0; i < contextfulKeys.length; i++) {
+            component[contextfulKeys[i]][disconnectContext](component);
+        }
+    }
+    catch (err) {
+        logWarnOnce(`Attempted to disconnect from trusted context but received the following error: ${err.message}`);
+    }
+}
+
 /*
  * Copyright (c) 2024, Salesforce, Inc.
  * All rights reserved.
@@ -7120,6 +7247,10 @@ function runConnectedCallback(vm) {
     if (hasWireAdapters(vm)) {
         connectWireAdapters(vm);
     }
+    if (lwcRuntimeFlags.ENABLE_EXPERIMENTAL_SIGNALS) {
+        // Setup context before connected callback is executed
+        connectContext(vm);
+    }
     const { connectedCallback } = vm.def;
     if (!shared.isUndefined(connectedCallback)) {
         logOperationStart(3 /* OperationId.ConnectedCallback */, vm);
@@ -7159,6 +7290,9 @@ function runDisconnectedCallback(vm) {
     if (process.env.NODE_ENV !== 'production') {
         shared.assert.isTrue(vm.state !== 2 /* VMState.disconnected */, `${vm} must be inserted.`);
     }
+    if (lwcRuntimeFlags.ENABLE_EXPERIMENTAL_SIGNALS) {
+        disconnectContext(vm);
+    }
     if (shared.isFalse(vm.isDirty)) {
         // this guarantees that if the component is reused/reinserted,
         // it will be re-rendered because we are disconnecting the reactivity
@@ -8534,10 +8668,18 @@ function readonly(obj) {
     return getReadOnlyProxy(obj);
 }
 
+Object.defineProperty(exports, "setContextKeys", {
+    enumerable: true,
+    get: function () { return shared.setContextKeys; }
+});
 Object.defineProperty(exports, "setHooks", {
     enumerable: true,
     get: function () { return shared.setHooks; }
 });
+Object.defineProperty(exports, "setTrustedContextSet", {
+    enumerable: true,
+    get: function () { return shared.setTrustedContextSet; }
+});
 Object.defineProperty(exports, "setTrustedSignalSet", {
     enumerable: true,
     get: function () { return shared.setTrustedSignalSet; }
@@ -8586,5 +8728,5 @@ exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/** version: 8.19.0 */
+/** version: 8.20.0 */
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.js

@@ -1,8 +1,8 @@
 /**
  * Copyright (c) 2025 Salesforce, Inc.
  */
-import { noop, StringToLowerCase, isNull, ArrayPush as ArrayPush$1, ArrayJoin, isFrozen, isUndefined as isUndefined$1, defineProperty, seal, create, isAPIFeatureEnabled, isFunction as isFunction$1, keys, toString, isString, ArrayFilter, isObject, isArray as isArray$1, getOwnPropertyNames as getOwnPropertyNames$1, getOwnPropertySymbols as getOwnPropertySymbols$1, ArrayIndexOf, ArrayPop, isFalse, isTrustedSignal, hasOwnProperty as hasOwnProperty$1, entries, AriaPropNameToAttrNameMap, getPropertyDescriptor, AriaAttrNameToPropNameMap, forEach, REFLECTIVE_GLOBAL_PROPERTY_SET, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, defineProperties, assign, freeze, assert, KEY__SYNTHETIC_MODE, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, LWC_VERSION_COMMENT_REGEX, LWC_VERSION, getOwnPropertyDescriptors, htmlPropertyToAttribute, ArraySlice, ArrayMap, isTrue, KEY__SCOPED_CSS, KEY__NATIVE_ONLY_CSS, ArraySplice, flattenStylesheets, kebabCaseToCamelCase, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, StringSlice, SVG_NAMESPACE, KEY__SHADOW_STATIC, ArraySome, KEY__SHADOW_RESOLVER, normalizeClass, sanitizeHtmlContent, StringReplace, isNumber, ArraySort, ArrayFrom, StringCharAt, htmlEscape, LOWEST_API_VERSION, ArrayUnshift, KEY__NATIVE_GET_ELEMENT_BY_ID, KEY__NATIVE_QUERY_SELECTOR_ALL, KEY__SHADOW_TOKEN, ID_REFERENCING_ATTRIBUTES_SET, StringSplit, arrayEvery, parseStyleText, ArrayCopyWithin, ArrayFill, ArrayReverse, ArrayShift } from '@lwc/shared';
-export { setHooks, setTrustedSignalSet } from '@lwc/shared';
+import { noop, StringToLowerCase, isNull, ArrayPush as ArrayPush$1, ArrayJoin, isFrozen, isUndefined as isUndefined$1, defineProperty, seal, create, isAPIFeatureEnabled, isFunction as isFunction$1, keys, toString, isString, ArrayFilter, isObject, isArray as isArray$1, getOwnPropertyNames as getOwnPropertyNames$1, getOwnPropertySymbols as getOwnPropertySymbols$1, ArrayIndexOf, ArrayPop, isFalse, isTrustedSignal, hasOwnProperty as hasOwnProperty$1, entries, AriaPropNameToAttrNameMap, getPropertyDescriptor, AriaAttrNameToPropNameMap, forEach, REFLECTIVE_GLOBAL_PROPERTY_SET, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, defineProperties, assign, freeze, assert, KEY__SYNTHETIC_MODE, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, LWC_VERSION_COMMENT_REGEX, LWC_VERSION, getOwnPropertyDescriptors, htmlPropertyToAttribute, ArraySlice, ArrayMap, isTrue, KEY__SCOPED_CSS, KEY__NATIVE_ONLY_CSS, ArraySplice, flattenStylesheets, kebabCaseToCamelCase, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, StringSlice, SVG_NAMESPACE, KEY__SHADOW_STATIC, ArraySome, KEY__SHADOW_RESOLVER, normalizeClass, sanitizeHtmlContent, StringReplace, isNumber, ArraySort, ArrayFrom, StringCharAt, htmlEscape, LOWEST_API_VERSION, getContextKeys, isTrustedContext, ContextEventName, ArrayUnshift, KEY__NATIVE_GET_ELEMENT_BY_ID, KEY__NATIVE_QUERY_SELECTOR_ALL, KEY__SHADOW_TOKEN, ID_REFERENCING_ATTRIBUTES_SET, StringSplit, arrayEvery, parseStyleText, ArrayCopyWithin, ArrayFill, ArrayReverse, ArrayShift } from '@lwc/shared';
+export { setContextKeys, setHooks, setTrustedContextSet, setTrustedSignalSet } from '@lwc/shared';
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
 
 /*
@@ -608,6 +608,7 @@ function componentValueObserved(vm, key, target = {}) {
         isObject(target) &&
         !isNull(target) &&
         isTrustedSignal(target) &&
+        process.env.IS_BROWSER &&
         // Only subscribe if a template is being rendered by the engine
         tro.isObserving()) {
         // Subscribe the template reactive observer's notify method, which will mark the vm as dirty and schedule hydration.
@@ -2142,8 +2143,11 @@ function createContextProviderWithRegister(adapter, registerContextProvider) {
                     consumerDisconnectedCallback(consumer);
                 }
             };
-            setDisconnectedCallback(disconnectCallback);
+            setDisconnectedCallback?.(disconnectCallback);
             consumerConnectedCallback(consumer);
+            // Return true as the context is always consumed here and the consumer should
+            // stop bubbling.
+            return true;
         });
     };
 }
@@ -2168,6 +2172,9 @@ function createContextWatcher(vm, wireDef, callbackWhenContextIsReady) {
                 // eslint-disable-next-line @lwc/lwc-internal/no-invalid-todo
                 // TODO: dev-mode validation of config based on the adapter.contextSchema
                 callbackWhenContextIsReady(newContext);
+                // Return true as the context is always consumed here and the consumer should
+                // stop bubbling.
+                return true;
             },
             setDisconnectedCallback(disconnectCallback) {
                 // adds this callback into the disconnect bucket so it gets disconnected from parent
@@ -6734,6 +6741,126 @@ function getWrappedComponentsListener(vm, listener) {
     return wrappedListener;
 }
 
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
+
+
+function __classPrivateFieldGet(receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+}
+
+function __classPrivateFieldSet(receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+var _ContextBinding_renderer, _ContextBinding_providedContextVarieties, _ContextBinding_elm;
+class ContextBinding {
+    constructor(vm, component, providedContextVarieties) {
+        _ContextBinding_renderer.set(this, void 0);
+        _ContextBinding_providedContextVarieties.set(this, void 0);
+        _ContextBinding_elm.set(this, void 0);
+        this.component = component;
+        __classPrivateFieldSet(this, _ContextBinding_renderer, vm.renderer, "f");
+        __classPrivateFieldSet(this, _ContextBinding_elm, vm.elm, "f");
+        __classPrivateFieldSet(this, _ContextBinding_providedContextVarieties, providedContextVarieties, "f");
+        // Register the component as a context provider.
+        __classPrivateFieldGet(this, _ContextBinding_renderer, "f").registerContextProvider(__classPrivateFieldGet(this, _ContextBinding_elm, "f"), ContextEventName, (contextConsumer) => {
+            // This callback is invoked when the provided context is consumed somewhere down
+            // in the component's subtree.
+            return contextConsumer.setNewContext(__classPrivateFieldGet(this, _ContextBinding_providedContextVarieties, "f"));
+        });
+    }
+    provideContext(contextVariety, providedContextSignal) {
+        if (__classPrivateFieldGet(this, _ContextBinding_providedContextVarieties, "f").has(contextVariety)) {
+            logWarnOnce('Multiple contexts of the same variety were provided. Only the first context will be used.');
+            return;
+        }
+        __classPrivateFieldGet(this, _ContextBinding_providedContextVarieties, "f").set(contextVariety, providedContextSignal);
+    }
+    consumeContext(contextVariety, contextProvidedCallback) {
+        __classPrivateFieldGet(this, _ContextBinding_renderer, "f").registerContextConsumer(__classPrivateFieldGet(this, _ContextBinding_elm, "f"), ContextEventName, {
+            setNewContext: (providerContextVarieties) => {
+                // If the provider has the specified context variety, then it is consumed
+                // and true is returned to stop bubbling.
+                if (providerContextVarieties.has(contextVariety)) {
+                    contextProvidedCallback(providerContextVarieties.get(contextVariety));
+                    return true;
+                }
+                // Return false as context has not been found/consumed
+                // and the consumer should continue traversing the context tree
+                return false;
+            },
+        });
+    }
+}
+_ContextBinding_renderer = new WeakMap(), _ContextBinding_providedContextVarieties = new WeakMap(), _ContextBinding_elm = new WeakMap();
+function connectContext(vm) {
+    const contextKeys = getContextKeys();
+    if (isUndefined$1(contextKeys)) {
+        return;
+    }
+    const { connectContext } = contextKeys;
+    const { component } = vm;
+    const enumerableKeys = keys(getPrototypeOf$1(component));
+    const contextfulKeys = ArrayFilter.call(enumerableKeys, (enumerableKey) => isTrustedContext(component[enumerableKey]));
+    if (contextfulKeys.length === 0) {
+        return;
+    }
+    const providedContextVarieties = new Map();
+    try {
+        for (let i = 0; i < contextfulKeys.length; i++) {
+            component[contextfulKeys[i]][connectContext](new ContextBinding(vm, component, providedContextVarieties));
+        }
+    }
+    catch (err) {
+        logWarnOnce(`Attempted to connect to trusted context but received the following error: ${err.message}`);
+    }
+}
+function disconnectContext(vm) {
+    const contextKeys = getContextKeys();
+    if (!contextKeys) {
+        return;
+    }
+    const { disconnectContext } = contextKeys;
+    const { component } = vm;
+    const enumerableKeys = keys(getPrototypeOf$1(component));
+    const contextfulKeys = ArrayFilter.call(enumerableKeys, (enumerableKey) => isTrustedContext(component[enumerableKey]));
+    if (contextfulKeys.length === 0) {
+        return;
+    }
+    try {
+        for (let i = 0; i < contextfulKeys.length; i++) {
+            component[contextfulKeys[i]][disconnectContext](component);
+        }
+    }
+    catch (err) {
+        logWarnOnce(`Attempted to disconnect from trusted context but received the following error: ${err.message}`);
+    }
+}
+
 /*
  * Copyright (c) 2024, Salesforce, Inc.
  * All rights reserved.
@@ -7117,6 +7244,10 @@ function runConnectedCallback(vm) {
     if (hasWireAdapters(vm)) {
         connectWireAdapters(vm);
     }
+    if (lwcRuntimeFlags.ENABLE_EXPERIMENTAL_SIGNALS) {
+        // Setup context before connected callback is executed
+        connectContext(vm);
+    }
     const { connectedCallback } = vm.def;
     if (!isUndefined$1(connectedCallback)) {
         logOperationStart(3 /* OperationId.ConnectedCallback */, vm);
@@ -7156,6 +7287,9 @@ function runDisconnectedCallback(vm) {
     if (process.env.NODE_ENV !== 'production') {
         assert.isTrue(vm.state !== 2 /* VMState.disconnected */, `${vm} must be inserted.`);
     }
+    if (lwcRuntimeFlags.ENABLE_EXPERIMENTAL_SIGNALS) {
+        disconnectContext(vm);
+    }
     if (isFalse(vm.isDirty)) {
         // this guarantees that if the component is reused/reinserted,
         // it will be re-rendered because we are disconnecting the reactivity
@@ -8532,5 +8666,5 @@ function readonly(obj) {
 }
 
 export { BaseBridgeElement, LightningElement, profilerControl as __unstable__ProfilerControl, reportingControl as __unstable__ReportingControl, api$1 as api, computeShadowAndRenderMode, connectRootElement, createContextProviderWithRegister, createVM, disconnectRootElement, freezeTemplate, getAssociatedVMIfPresent, getComponentAPIVersion, getComponentConstructor, getComponentDef, getComponentHtmlPrototype, hydrateRoot, isComponentConstructor, parseFragment, parseSVGFragment, readonly, registerComponent, registerDecorators, registerTemplate, runFormAssociatedCallback, runFormDisabledCallback, runFormResetCallback, runFormStateRestoreCallback, sanitizeAttribute, shouldBeFormAssociated, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };
-/** version: 8.19.0 */
+/** version: 8.20.0 */
 //# sourceMappingURL=index.js.map

package/dist/shared/logger.d.ts

@@ -1,5 +1,6 @@
 import type { VM } from '../framework/vm';
 export declare function logError(message: string, vm?: VM): void;
+export declare function logErrorOnce(message: string, vm?: VM): void;
 export declare function logWarn(message: string, vm?: VM): void;
 export declare function logWarnOnce(message: string, vm?: VM): void;
 //# sourceMappingURL=logger.d.ts.map

package/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/engine-core",
-    "version": "8.19.0",
+    "version": "8.20.0",
     "description": "Core LWC engine APIs.",
     "keywords": [
         "lwc"
@@ -46,9 +46,9 @@
         }
     },
     "dependencies": {
-        "@lwc/features": "8.19.0",
-        "@lwc/shared": "8.19.0",
-        "@lwc/signals": "8.19.0"
+        "@lwc/features": "8.20.0",
+        "@lwc/shared": "8.20.0",
+        "@lwc/signals": "8.20.0"
     },
     "devDependencies": {
         "observable-membrane": "2.0.0"