@lwc/ssr-runtime 8.20.0 → 8.20.1

package/dist/context.d.ts

@@ -0,0 +1,12 @@
+import { type ContextProvidedCallback, type ContextBinding as IContextBinding } from '@lwc/shared';
+import { type LightningElement } from './lightning-element';
+import type { Signal } from '@lwc/signals';
+declare class ContextBinding<C extends LightningElement> implements IContextBinding<LightningElement> {
+    component: C;
+    constructor(component: C);
+    provideContext<V extends object>(contextVariety: V, providedContextSignal: Signal<unknown>): void;
+    consumeContext<V extends object>(contextVariety: V, contextProvidedCallback: ContextProvidedCallback): void;
+}
+export { ContextBinding };
+export declare function connectContext(le: LightningElement): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/index.cjs.js

@@ -46,12 +46,6 @@ function registerTemplate(..._) {
 function sanitizeAttribute(..._) {
     throw new Error('sanitizeAttribute cannot be used in SSR context.');
 }
-function setFeatureFlag(..._) {
-    throw new Error('setFeatureFlag cannot be used in SSR context.');
-}
-function setFeatureFlagForTest(..._) {
-    throw new Error('setFeatureFlagForTest cannot be used in SSR context.');
-}
 function swapComponent(..._) {
     throw new Error('swapComponent cannot be used in SSR context.');
 }
@@ -70,12 +64,6 @@ function unwrap$1(..._) {
 function wire(..._) {
     throw new Error('@wire cannot be used in SSR context.');
 }
-function setContextKeys(..._) {
-    throw new Error('@setContextKeys cannot be used in SSR context.');
-}
-function setTrustedContextSet(..._) {
-    throw new Error('setTrustedContextSet cannot be used in SSR context.');
-}
 const renderer = {
     isSyntheticShadowDefined: false,
     insert(..._) {
@@ -263,6 +251,8 @@ assign,
 create, 
 /** Detached {@linkcode Object.defineProperties}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperties MDN Reference}. */
 defineProperties, 
+/** Detached {@linkcode Object.defineProperty}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty MDN Reference}. */
+defineProperty, 
 /** Detached {@linkcode Object.entries}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries MDN Reference}. */
 entries, 
 /** Detached {@linkcode Object.getOwnPropertyNames}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames MDN Reference}. */
@@ -277,7 +267,7 @@ isArray: isArray$1} = Array;
 // For some reason, JSDoc don't get picked up for multiple renamed destructured constants (even
 // though it works fine for one, e.g. isArray), so comments for these are added to the export
 // statement, rather than this declaration.
-const { join: ArrayJoin, map: ArrayMap, forEach, // Weird anomaly!
+const { filter: ArrayFilter, join: ArrayJoin, map: ArrayMap, forEach, // Weird anomaly!
  } = Array.prototype;
 /** Detached {@linkcode String.fromCharCode}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/fromCharCode MDN Reference}. */
 const { fromCharCode: StringFromCharCode } = String;
@@ -299,6 +289,14 @@ function isUndefined$1(obj) {
 function isNull(obj) {
     return obj === null;
 }
+/**
+ * Determines whether the argument is a boolean.
+ * @param obj Value to test
+ * @returns `true` if the value is a boolean.
+ */
+function isBoolean(obj) {
+    return typeof obj === 'boolean';
+}
 /**
  * Determines whether the argument is an object or null.
  * @param obj Value to test
@@ -444,6 +442,31 @@ const { AriaAttrNameToPropNameMap, AriaPropNameToAttrNameMap } = /*@__PURE__*/ (
 function isAriaAttribute(attrName) {
     return attrName in AriaAttrNameToPropNameMap;
 }
+let trustedContext;
+let contextKeys;
+function setContextKeys(config) {
+    isFalse$1(contextKeys, '`setContextKeys` cannot be called more than once');
+    contextKeys = config;
+}
+function getContextKeys() {
+    return contextKeys;
+}
+function setTrustedContextSet(context) {
+    isFalse$1(trustedContext, 'Trusted Context Set is already set!');
+    trustedContext = context;
+}
+function addTrustedContext(contextParticipant) {
+    // This should be a no-op when the trustedSignals set isn't set by runtime
+    trustedContext?.add(contextParticipant);
+}
+function isTrustedContext(target) {
+    if (!trustedContext) {
+        // The runtime didn't set a trustedContext set
+        // this check should only be performed for runtimes that care about filtering context participants to track
+        return true;
+    }
+    return trustedContext.has(target);
+}
 // These are HTML standard prop/attribute IDL mappings, but are not predictable based on camel/kebab-case conversion
 const SPECIAL_PROPERTY_ATTRIBUTE_MAPPING = /*@__PURE__@*/ new Map([
     ['accessKey', 'accesskey'],
@@ -607,6 +630,27 @@ function setHooks(hooks) {
     exports.sanitizeHtmlContent = hooks.sanitizeHtmlContent;
 }
 
+/*
+ * Copyright (c) 2024, 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
+ */
+let trustedSignals;
+function setTrustedSignalSet(signals) {
+    isFalse$1(trustedSignals, 'Trusted Signal Set is already set!');
+    trustedSignals = signals;
+}
+function isTrustedSignal(target) {
+    if (!trustedSignals) {
+        // The runtime didn't set a trustedSignals set
+        // this check should only be performed for runtimes that care about filtering signals to track
+        // our default behavior should be to track all signals
+        return true;
+    }
+    return trustedSignals.has(target);
+}
+
 /*
  * Copyright (c) 2024, Salesforce, Inc.
  * All rights reserved.
@@ -630,7 +674,143 @@ function normalizeTabIndex(value) {
     const shouldNormalize = value > 0 && typeof value !== 'boolean';
     return shouldNormalize ? 0 : value;
 }
-/** version: 8.20.0 */
+/** version: 8.20.1 */
+
+/**
+ * Copyright (c) 2025 Salesforce, Inc.
+ */
+/**
+ * Copyright (c) 2025 Salesforce, 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
+ */
+/**
+ *
+ * @param value
+ * @param msg
+ */
+/**
+ *
+ * @param value
+ * @param msg
+ */
+/** version: 8.20.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 SignalBaseClass {
+    constructor() {
+        this.subscribers = new Set();
+    }
+    subscribe(onUpdate) {
+        this.subscribers.add(onUpdate);
+        return () => {
+            this.subscribers.delete(onUpdate);
+        };
+    }
+    notify() {
+        for (const subscriber of this.subscribers) {
+            subscriber();
+        }
+    }
+}
+/** version: 8.20.1 */
+
+/**
+ * Copyright (c) 2025 Salesforce, Inc.
+ */
+
+/*
+ * Copyright (c) 2024, Salesforce, 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
+ */
+// When deprecating a feature flag, ensure that it is also no longer set in the application. For
+// example, in core, the flag should be removed from LwcPermAndPrefUtilImpl.java
+/** List of all feature flags available, with the default value `null`. */
+const features = {
+    PLACEHOLDER_TEST_FLAG: null,
+    DISABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE: null,
+    ENABLE_WIRE_SYNC_EMIT: null,
+    DISABLE_LIGHT_DOM_UNSCOPED_CSS: null,
+    ENABLE_FROZEN_TEMPLATE: null,
+    ENABLE_LEGACY_SCOPE_TOKENS: null,
+    ENABLE_FORCE_SHADOW_MIGRATE_MODE: null,
+    ENABLE_EXPERIMENTAL_SIGNALS: null,
+    DISABLE_SYNTHETIC_SHADOW: null,
+    DISABLE_SCOPE_TOKEN_VALIDATION: null,
+    LEGACY_LOCKER_ENABLED: null,
+    DISABLE_LEGACY_VALIDATION: null,
+};
+if (!globalThis.lwcRuntimeFlags) {
+    Object.defineProperty(globalThis, 'lwcRuntimeFlags', { value: create(null) });
+}
+/** Feature flags that have been set. */
+const flags = globalThis.lwcRuntimeFlags;
+/**
+ * Set the value at runtime of a given feature flag. This method only be invoked once per feature
+ * flag. It is meant to be used during the app initialization.
+ * @param name Name of the feature flag to set
+ * @param value Whether the feature flag should be enabled
+ * @throws Will throw if a non-boolean value is provided when running in production.
+ * @example setFeatureFlag("DISABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE", true)
+ */
+function setFeatureFlag(name, value) {
+    if (!isBoolean(value)) {
+        const message = `Failed to set the value "${value}" for the runtime feature flag "${name}". Runtime feature flags can only be set to a boolean value.`;
+        if (process.env.NODE_ENV !== 'production') {
+            throw new TypeError(message);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.error(message);
+            return;
+        }
+    }
+    if (isUndefined$1(features[name])) {
+        // eslint-disable-next-line no-console
+        console.info(`Attempt to set a value on an unknown feature flag "${name}" resulted in a NOOP.`);
+        return;
+    }
+    // This may seem redundant, but `process.env.NODE_ENV === 'test-karma-lwc'` is replaced by Karma tests
+    if (process.env.NODE_ENV === 'test-karma-lwc' || process.env.NODE_ENV !== 'production') {
+        // Allow the same flag to be set more than once outside of production to enable testing
+        flags[name] = value;
+    }
+    else {
+        // Disallow the same flag to be set more than once in production
+        const runtimeValue = flags[name];
+        if (!isUndefined$1(runtimeValue)) {
+            // eslint-disable-next-line no-console
+            console.error(`Failed to set the value "${value}" for the runtime feature flag "${name}". "${name}" has already been set with the value "${runtimeValue}".`);
+            return;
+        }
+        defineProperty(flags, name, { value });
+    }
+}
+/**
+ * Set the value at runtime of a given feature flag. This method should only be used for testing
+ * purposes. It is a no-op when invoked in production mode.
+ * @param name Name of the feature flag to enable or disable
+ * @param value Whether the feature flag should be enabled
+ * @example setFeatureFlag("DISABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE", true)
+ */
+function setFeatureFlagForTest(name, value) {
+    // This may seem redundant, but `process.env.NODE_ENV === 'test-karma-lwc'` is replaced by Karma tests
+    if (process.env.NODE_ENV === 'test-karma-lwc' || process.env.NODE_ENV !== 'production') {
+        setFeatureFlag(name, value);
+    }
+}
+/** version: 8.20.1 */
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -1354,21 +1534,139 @@ function readonly(value) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-var _LightningElement_props, _LightningElement_attrs, _LightningElement_classList;
+const contextfulRelationships = new WeakMap();
+function establishContextfulRelationship(parentLe, childLe) {
+    contextfulRelationships.set(childLe, parentLe);
+}
+function getContextfulStack(le) {
+    const contextfulParent = contextfulRelationships.get(le);
+    if (!contextfulParent) {
+        return [];
+    }
+    return [contextfulParent, ...getContextfulStack(contextfulParent)];
+}
+const contextProviders = new WeakMap();
+function registerContextProvider(adapter, attachedLe, consumerCallback) {
+    let elementMap = contextProviders.get(adapter);
+    if (!elementMap) {
+        elementMap = new WeakMap();
+        contextProviders.set(adapter, elementMap);
+    }
+    elementMap.set(attachedLe, consumerCallback);
+}
+function connectContext$1(adapter, contextConsumer, onNewValue) {
+    const elementMap = contextProviders.get(adapter);
+    if (!elementMap) {
+        return;
+    }
+    const contextfulStack = getContextfulStack(contextConsumer);
+    for (const ancestor of contextfulStack) {
+        const onConsumerConnected = elementMap.get(ancestor);
+        if (onConsumerConnected) {
+            onConsumerConnected({
+                provide(newContextValue) {
+                    onNewValue(newContextValue);
+                },
+            });
+            return;
+        }
+    }
+}
+function createContextProvider(adapter) {
+    return (le, options) => {
+        if (!(le instanceof LightningElement)) {
+            throw new Error('Unable to register context provider on provided `elm`.');
+        }
+        if (!le.isConnected || !options?.consumerConnectedCallback) {
+            return;
+        }
+        const { consumerConnectedCallback } = options;
+        registerContextProvider(adapter, le, (consumer) => consumerConnectedCallback(consumer));
+    };
+}
+
+/*
+ * Copyright (c) 2024, 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 ContextBinding {
+    constructor(component) {
+        this.component = component;
+    }
+    provideContext(contextVariety, providedContextSignal) {
+        const contextVarieties = this.component[SYMBOL__CONTEXT_VARIETIES];
+        if (contextVarieties.has(contextVariety)) {
+            if (process.env.NODE_ENV !== 'production') {
+                throw new Error('Multiple contexts of the same variety were provided.');
+            }
+            return;
+        }
+        contextVarieties.set(contextVariety, providedContextSignal);
+    }
+    consumeContext(contextVariety, contextProvidedCallback) {
+        const contextfulStack = getContextfulStack(this.component);
+        for (const ancestor of contextfulStack) {
+            // If the ancestor has the specified context variety, consume it and stop searching
+            const ancestorContextVarieties = ancestor[SYMBOL__CONTEXT_VARIETIES];
+            if (ancestorContextVarieties.has(contextVariety)) {
+                contextProvidedCallback(ancestorContextVarieties.get(contextVariety));
+                break;
+            }
+        }
+    }
+}
+function connectContext(le) {
+    const contextKeys = getContextKeys();
+    if (isUndefined$1(contextKeys)) {
+        return;
+    }
+    const { connectContext } = contextKeys;
+    const enumerableKeys = keys(le);
+    const contextfulKeys = ArrayFilter.call(enumerableKeys, (enumerableKey) => isTrustedContext(le[enumerableKey]));
+    if (contextfulKeys.length === 0) {
+        return;
+    }
+    try {
+        for (let i = 0; i < contextfulKeys.length; i++) {
+            le[contextfulKeys[i]][connectContext](new ContextBinding(le));
+        }
+    }
+    catch (err) {
+        if (process.env.NODE_ENV !== 'production') {
+            throw new Error(`Attempted to connect to trusted context but received the following error: ${err.message}`);
+        }
+    }
+}
+
+/*
+ * Copyright (c) 2024, 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 _LightningElement_props, _LightningElement_attrs, _LightningElement_classList, _a;
 const SYMBOL__SET_INTERNALS = Symbol('set-internals');
 const SYMBOL__GENERATE_MARKUP = Symbol('generate-markup');
 const SYMBOL__DEFAULT_TEMPLATE = Symbol('default-template');
+const SYMBOL__CONTEXT_VARIETIES = Symbol('context-varieties');
 class LightningElement {
     constructor(propsAvailableAtConstruction) {
         this.isConnected = false;
         _LightningElement_props.set(this, void 0);
         _LightningElement_attrs.set(this, void 0);
         _LightningElement_classList.set(this, null);
+        this[_a] = new Map();
         assign(this, propsAvailableAtConstruction);
     }
-    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), SYMBOL__SET_INTERNALS)](props, attrs, publicProperties) {
+    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), _a = SYMBOL__CONTEXT_VARIETIES, SYMBOL__SET_INTERNALS)](props, attrs, publicProperties) {
         __classPrivateFieldSet(this, _LightningElement_props, props, "f");
         __classPrivateFieldSet(this, _LightningElement_attrs, attrs, "f");
+        if (lwcRuntimeFlags.ENABLE_EXPERIMENTAL_SIGNALS) {
+            // Setup context before connected callback is executed
+            connectContext(this);
+        }
         // Class should be set explicitly to avoid it being overridden by connectedCallback classList mutation.
         if (attrs.class) {
             this.className = attrs.class;
@@ -1833,71 +2131,16 @@ function* toIteratorDirective(iterable) {
     }
 }
 
-/*
- * Copyright (c) 2024, 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 contextfulRelationships = new WeakMap();
-function establishContextfulRelationship(parentLe, childLe) {
-    contextfulRelationships.set(childLe, parentLe);
-}
-function getContextfulStack(le) {
-    const contextfulParent = contextfulRelationships.get(le);
-    if (!contextfulParent) {
-        return [];
-    }
-    return [contextfulParent, ...getContextfulStack(contextfulParent)];
-}
-const contextProviders = new WeakMap();
-function registerContextProvider(adapter, attachedLe, consumerCallback) {
-    let elementMap = contextProviders.get(adapter);
-    if (!elementMap) {
-        elementMap = new WeakMap();
-        contextProviders.set(adapter, elementMap);
-    }
-    elementMap.set(attachedLe, consumerCallback);
-}
-function connectContext(adapter, contextConsumer, onNewValue) {
-    const elementMap = contextProviders.get(adapter);
-    if (!elementMap) {
-        return;
-    }
-    const contextfulStack = getContextfulStack(contextConsumer);
-    for (const ancestor of contextfulStack) {
-        const onConsumerConnected = elementMap.get(ancestor);
-        if (onConsumerConnected) {
-            onConsumerConnected({
-                provide(newContextValue) {
-                    onNewValue(newContextValue);
-                },
-            });
-            return;
-        }
-    }
-}
-function createContextProvider(adapter) {
-    return (le, options) => {
-        if (!(le instanceof LightningElement)) {
-            throw new Error('Unable to register context provider on provided `elm`.');
-        }
-        if (!le.isConnected || !options?.consumerConnectedCallback) {
-            return;
-        }
-        const { consumerConnectedCallback } = options;
-        registerContextProvider(adapter, le, (consumer) => consumerConnectedCallback(consumer));
-    };
-}
-
 exports.ClassList = ClassList;
 exports.LightningElement = LightningElement;
 exports.SYMBOL__DEFAULT_TEMPLATE = SYMBOL__DEFAULT_TEMPLATE;
 exports.SYMBOL__GENERATE_MARKUP = SYMBOL__GENERATE_MARKUP;
 exports.SYMBOL__SET_INTERNALS = SYMBOL__SET_INTERNALS;
+exports.SignalBaseClass = SignalBaseClass;
+exports.__dangerous_do_not_use_addTrustedContext = addTrustedContext;
 exports.addSlottedContent = addSlottedContent;
 exports.api = api;
-exports.connectContext = connectContext;
+exports.connectContext = connectContext$1;
 exports.createContextProvider = createContextProvider;
 exports.createElement = createElement;
 exports.establishContextfulRelationship = establishContextfulRelationship;
@@ -1909,6 +2152,7 @@ exports.hasScopedStaticStylesheets = hasScopedStaticStylesheets;
 exports.hot = hot;
 exports.htmlEscape = htmlEscape;
 exports.isComponentConstructor = isComponentConstructor;
+exports.isTrustedSignal = isTrustedSignal;
 exports.mutationTracker = mutationTracker;
 exports.normalizeClass = normalizeClass;
 exports.normalizeTabIndex = normalizeTabIndex;
@@ -1932,6 +2176,7 @@ exports.setFeatureFlag = setFeatureFlag;
 exports.setFeatureFlagForTest = setFeatureFlagForTest;
 exports.setHooks = setHooks;
 exports.setTrustedContextSet = setTrustedContextSet;
+exports.setTrustedSignalSet = setTrustedSignalSet;
 exports.swapComponent = swapComponent;
 exports.swapStyle = swapStyle;
 exports.swapTemplate = swapTemplate;
@@ -1940,5 +2185,5 @@ exports.track = track;
 exports.unwrap = unwrap$1;
 exports.validateStyleTextContents = validateStyleTextContents;
 exports.wire = wire;
-/** version: 8.20.0 */
+/** version: 8.20.1 */
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * from './stubs';
-export { htmlEscape, setHooks, sanitizeHtmlContent, normalizeClass, normalizeTabIndex, } from '@lwc/shared';
+export { htmlEscape, setHooks, sanitizeHtmlContent, normalizeClass, normalizeTabIndex, setContextKeys, setTrustedSignalSet, setTrustedContextSet, addTrustedContext as __dangerous_do_not_use_addTrustedContext, isTrustedSignal, } from '@lwc/shared';
+export { SignalBaseClass } from '@lwc/signals';
+export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
 export { ClassList } from './class-list';
 export { LightningElement, LightningElementConstructor, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, } from './lightning-element';
 export { mutationTracker } from './mutation-tracker';

package/dist/index.js

@@ -42,12 +42,6 @@ function registerTemplate(..._) {
 function sanitizeAttribute(..._) {
     throw new Error('sanitizeAttribute cannot be used in SSR context.');
 }
-function setFeatureFlag(..._) {
-    throw new Error('setFeatureFlag cannot be used in SSR context.');
-}
-function setFeatureFlagForTest(..._) {
-    throw new Error('setFeatureFlagForTest cannot be used in SSR context.');
-}
 function swapComponent(..._) {
     throw new Error('swapComponent cannot be used in SSR context.');
 }
@@ -66,12 +60,6 @@ function unwrap$1(..._) {
 function wire(..._) {
     throw new Error('@wire cannot be used in SSR context.');
 }
-function setContextKeys(..._) {
-    throw new Error('@setContextKeys cannot be used in SSR context.');
-}
-function setTrustedContextSet(..._) {
-    throw new Error('setTrustedContextSet cannot be used in SSR context.');
-}
 const renderer = {
     isSyntheticShadowDefined: false,
     insert(..._) {
@@ -259,6 +247,8 @@ assign,
 create, 
 /** Detached {@linkcode Object.defineProperties}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperties MDN Reference}. */
 defineProperties, 
+/** Detached {@linkcode Object.defineProperty}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty MDN Reference}. */
+defineProperty, 
 /** Detached {@linkcode Object.entries}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries MDN Reference}. */
 entries, 
 /** Detached {@linkcode Object.getOwnPropertyNames}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames MDN Reference}. */
@@ -273,7 +263,7 @@ isArray: isArray$1} = Array;
 // For some reason, JSDoc don't get picked up for multiple renamed destructured constants (even
 // though it works fine for one, e.g. isArray), so comments for these are added to the export
 // statement, rather than this declaration.
-const { join: ArrayJoin, map: ArrayMap, forEach, // Weird anomaly!
+const { filter: ArrayFilter, join: ArrayJoin, map: ArrayMap, forEach, // Weird anomaly!
  } = Array.prototype;
 /** Detached {@linkcode String.fromCharCode}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/fromCharCode MDN Reference}. */
 const { fromCharCode: StringFromCharCode } = String;
@@ -295,6 +285,14 @@ function isUndefined$1(obj) {
 function isNull(obj) {
     return obj === null;
 }
+/**
+ * Determines whether the argument is a boolean.
+ * @param obj Value to test
+ * @returns `true` if the value is a boolean.
+ */
+function isBoolean(obj) {
+    return typeof obj === 'boolean';
+}
 /**
  * Determines whether the argument is an object or null.
  * @param obj Value to test
@@ -440,6 +438,31 @@ const { AriaAttrNameToPropNameMap, AriaPropNameToAttrNameMap } = /*@__PURE__*/ (
 function isAriaAttribute(attrName) {
     return attrName in AriaAttrNameToPropNameMap;
 }
+let trustedContext;
+let contextKeys;
+function setContextKeys(config) {
+    isFalse$1(contextKeys, '`setContextKeys` cannot be called more than once');
+    contextKeys = config;
+}
+function getContextKeys() {
+    return contextKeys;
+}
+function setTrustedContextSet(context) {
+    isFalse$1(trustedContext, 'Trusted Context Set is already set!');
+    trustedContext = context;
+}
+function addTrustedContext(contextParticipant) {
+    // This should be a no-op when the trustedSignals set isn't set by runtime
+    trustedContext?.add(contextParticipant);
+}
+function isTrustedContext(target) {
+    if (!trustedContext) {
+        // The runtime didn't set a trustedContext set
+        // this check should only be performed for runtimes that care about filtering context participants to track
+        return true;
+    }
+    return trustedContext.has(target);
+}
 // These are HTML standard prop/attribute IDL mappings, but are not predictable based on camel/kebab-case conversion
 const SPECIAL_PROPERTY_ATTRIBUTE_MAPPING = /*@__PURE__@*/ new Map([
     ['accessKey', 'accesskey'],
@@ -603,6 +626,27 @@ function setHooks(hooks) {
     sanitizeHtmlContent = hooks.sanitizeHtmlContent;
 }
 
+/*
+ * Copyright (c) 2024, 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
+ */
+let trustedSignals;
+function setTrustedSignalSet(signals) {
+    isFalse$1(trustedSignals, 'Trusted Signal Set is already set!');
+    trustedSignals = signals;
+}
+function isTrustedSignal(target) {
+    if (!trustedSignals) {
+        // The runtime didn't set a trustedSignals set
+        // this check should only be performed for runtimes that care about filtering signals to track
+        // our default behavior should be to track all signals
+        return true;
+    }
+    return trustedSignals.has(target);
+}
+
 /*
  * Copyright (c) 2024, Salesforce, Inc.
  * All rights reserved.
@@ -626,7 +670,143 @@ function normalizeTabIndex(value) {
     const shouldNormalize = value > 0 && typeof value !== 'boolean';
     return shouldNormalize ? 0 : value;
 }
-/** version: 8.20.0 */
+/** version: 8.20.1 */
+
+/**
+ * Copyright (c) 2025 Salesforce, Inc.
+ */
+/**
+ * Copyright (c) 2025 Salesforce, 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
+ */
+/**
+ *
+ * @param value
+ * @param msg
+ */
+/**
+ *
+ * @param value
+ * @param msg
+ */
+/** version: 8.20.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 SignalBaseClass {
+    constructor() {
+        this.subscribers = new Set();
+    }
+    subscribe(onUpdate) {
+        this.subscribers.add(onUpdate);
+        return () => {
+            this.subscribers.delete(onUpdate);
+        };
+    }
+    notify() {
+        for (const subscriber of this.subscribers) {
+            subscriber();
+        }
+    }
+}
+/** version: 8.20.1 */
+
+/**
+ * Copyright (c) 2025 Salesforce, Inc.
+ */
+
+/*
+ * Copyright (c) 2024, Salesforce, 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
+ */
+// When deprecating a feature flag, ensure that it is also no longer set in the application. For
+// example, in core, the flag should be removed from LwcPermAndPrefUtilImpl.java
+/** List of all feature flags available, with the default value `null`. */
+const features = {
+    PLACEHOLDER_TEST_FLAG: null,
+    DISABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE: null,
+    ENABLE_WIRE_SYNC_EMIT: null,
+    DISABLE_LIGHT_DOM_UNSCOPED_CSS: null,
+    ENABLE_FROZEN_TEMPLATE: null,
+    ENABLE_LEGACY_SCOPE_TOKENS: null,
+    ENABLE_FORCE_SHADOW_MIGRATE_MODE: null,
+    ENABLE_EXPERIMENTAL_SIGNALS: null,
+    DISABLE_SYNTHETIC_SHADOW: null,
+    DISABLE_SCOPE_TOKEN_VALIDATION: null,
+    LEGACY_LOCKER_ENABLED: null,
+    DISABLE_LEGACY_VALIDATION: null,
+};
+if (!globalThis.lwcRuntimeFlags) {
+    Object.defineProperty(globalThis, 'lwcRuntimeFlags', { value: create(null) });
+}
+/** Feature flags that have been set. */
+const flags = globalThis.lwcRuntimeFlags;
+/**
+ * Set the value at runtime of a given feature flag. This method only be invoked once per feature
+ * flag. It is meant to be used during the app initialization.
+ * @param name Name of the feature flag to set
+ * @param value Whether the feature flag should be enabled
+ * @throws Will throw if a non-boolean value is provided when running in production.
+ * @example setFeatureFlag("DISABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE", true)
+ */
+function setFeatureFlag(name, value) {
+    if (!isBoolean(value)) {
+        const message = `Failed to set the value "${value}" for the runtime feature flag "${name}". Runtime feature flags can only be set to a boolean value.`;
+        if (process.env.NODE_ENV !== 'production') {
+            throw new TypeError(message);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.error(message);
+            return;
+        }
+    }
+    if (isUndefined$1(features[name])) {
+        // eslint-disable-next-line no-console
+        console.info(`Attempt to set a value on an unknown feature flag "${name}" resulted in a NOOP.`);
+        return;
+    }
+    // This may seem redundant, but `process.env.NODE_ENV === 'test-karma-lwc'` is replaced by Karma tests
+    if (process.env.NODE_ENV === 'test-karma-lwc' || process.env.NODE_ENV !== 'production') {
+        // Allow the same flag to be set more than once outside of production to enable testing
+        flags[name] = value;
+    }
+    else {
+        // Disallow the same flag to be set more than once in production
+        const runtimeValue = flags[name];
+        if (!isUndefined$1(runtimeValue)) {
+            // eslint-disable-next-line no-console
+            console.error(`Failed to set the value "${value}" for the runtime feature flag "${name}". "${name}" has already been set with the value "${runtimeValue}".`);
+            return;
+        }
+        defineProperty(flags, name, { value });
+    }
+}
+/**
+ * Set the value at runtime of a given feature flag. This method should only be used for testing
+ * purposes. It is a no-op when invoked in production mode.
+ * @param name Name of the feature flag to enable or disable
+ * @param value Whether the feature flag should be enabled
+ * @example setFeatureFlag("DISABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE", true)
+ */
+function setFeatureFlagForTest(name, value) {
+    // This may seem redundant, but `process.env.NODE_ENV === 'test-karma-lwc'` is replaced by Karma tests
+    if (process.env.NODE_ENV === 'test-karma-lwc' || process.env.NODE_ENV !== 'production') {
+        setFeatureFlag(name, value);
+    }
+}
+/** version: 8.20.1 */
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -1350,21 +1530,139 @@ function readonly(value) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-var _LightningElement_props, _LightningElement_attrs, _LightningElement_classList;
+const contextfulRelationships = new WeakMap();
+function establishContextfulRelationship(parentLe, childLe) {
+    contextfulRelationships.set(childLe, parentLe);
+}
+function getContextfulStack(le) {
+    const contextfulParent = contextfulRelationships.get(le);
+    if (!contextfulParent) {
+        return [];
+    }
+    return [contextfulParent, ...getContextfulStack(contextfulParent)];
+}
+const contextProviders = new WeakMap();
+function registerContextProvider(adapter, attachedLe, consumerCallback) {
+    let elementMap = contextProviders.get(adapter);
+    if (!elementMap) {
+        elementMap = new WeakMap();
+        contextProviders.set(adapter, elementMap);
+    }
+    elementMap.set(attachedLe, consumerCallback);
+}
+function connectContext$1(adapter, contextConsumer, onNewValue) {
+    const elementMap = contextProviders.get(adapter);
+    if (!elementMap) {
+        return;
+    }
+    const contextfulStack = getContextfulStack(contextConsumer);
+    for (const ancestor of contextfulStack) {
+        const onConsumerConnected = elementMap.get(ancestor);
+        if (onConsumerConnected) {
+            onConsumerConnected({
+                provide(newContextValue) {
+                    onNewValue(newContextValue);
+                },
+            });
+            return;
+        }
+    }
+}
+function createContextProvider(adapter) {
+    return (le, options) => {
+        if (!(le instanceof LightningElement)) {
+            throw new Error('Unable to register context provider on provided `elm`.');
+        }
+        if (!le.isConnected || !options?.consumerConnectedCallback) {
+            return;
+        }
+        const { consumerConnectedCallback } = options;
+        registerContextProvider(adapter, le, (consumer) => consumerConnectedCallback(consumer));
+    };
+}
+
+/*
+ * Copyright (c) 2024, 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 ContextBinding {
+    constructor(component) {
+        this.component = component;
+    }
+    provideContext(contextVariety, providedContextSignal) {
+        const contextVarieties = this.component[SYMBOL__CONTEXT_VARIETIES];
+        if (contextVarieties.has(contextVariety)) {
+            if (process.env.NODE_ENV !== 'production') {
+                throw new Error('Multiple contexts of the same variety were provided.');
+            }
+            return;
+        }
+        contextVarieties.set(contextVariety, providedContextSignal);
+    }
+    consumeContext(contextVariety, contextProvidedCallback) {
+        const contextfulStack = getContextfulStack(this.component);
+        for (const ancestor of contextfulStack) {
+            // If the ancestor has the specified context variety, consume it and stop searching
+            const ancestorContextVarieties = ancestor[SYMBOL__CONTEXT_VARIETIES];
+            if (ancestorContextVarieties.has(contextVariety)) {
+                contextProvidedCallback(ancestorContextVarieties.get(contextVariety));
+                break;
+            }
+        }
+    }
+}
+function connectContext(le) {
+    const contextKeys = getContextKeys();
+    if (isUndefined$1(contextKeys)) {
+        return;
+    }
+    const { connectContext } = contextKeys;
+    const enumerableKeys = keys(le);
+    const contextfulKeys = ArrayFilter.call(enumerableKeys, (enumerableKey) => isTrustedContext(le[enumerableKey]));
+    if (contextfulKeys.length === 0) {
+        return;
+    }
+    try {
+        for (let i = 0; i < contextfulKeys.length; i++) {
+            le[contextfulKeys[i]][connectContext](new ContextBinding(le));
+        }
+    }
+    catch (err) {
+        if (process.env.NODE_ENV !== 'production') {
+            throw new Error(`Attempted to connect to trusted context but received the following error: ${err.message}`);
+        }
+    }
+}
+
+/*
+ * Copyright (c) 2024, 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 _LightningElement_props, _LightningElement_attrs, _LightningElement_classList, _a;
 const SYMBOL__SET_INTERNALS = Symbol('set-internals');
 const SYMBOL__GENERATE_MARKUP = Symbol('generate-markup');
 const SYMBOL__DEFAULT_TEMPLATE = Symbol('default-template');
+const SYMBOL__CONTEXT_VARIETIES = Symbol('context-varieties');
 class LightningElement {
     constructor(propsAvailableAtConstruction) {
         this.isConnected = false;
         _LightningElement_props.set(this, void 0);
         _LightningElement_attrs.set(this, void 0);
         _LightningElement_classList.set(this, null);
+        this[_a] = new Map();
         assign(this, propsAvailableAtConstruction);
     }
-    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), SYMBOL__SET_INTERNALS)](props, attrs, publicProperties) {
+    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), _a = SYMBOL__CONTEXT_VARIETIES, SYMBOL__SET_INTERNALS)](props, attrs, publicProperties) {
         __classPrivateFieldSet(this, _LightningElement_props, props, "f");
         __classPrivateFieldSet(this, _LightningElement_attrs, attrs, "f");
+        if (lwcRuntimeFlags.ENABLE_EXPERIMENTAL_SIGNALS) {
+            // Setup context before connected callback is executed
+            connectContext(this);
+        }
         // Class should be set explicitly to avoid it being overridden by connectedCallback classList mutation.
         if (attrs.class) {
             this.className = attrs.class;
@@ -1829,63 +2127,6 @@ function* toIteratorDirective(iterable) {
     }
 }
 
-/*
- * Copyright (c) 2024, 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 contextfulRelationships = new WeakMap();
-function establishContextfulRelationship(parentLe, childLe) {
-    contextfulRelationships.set(childLe, parentLe);
-}
-function getContextfulStack(le) {
-    const contextfulParent = contextfulRelationships.get(le);
-    if (!contextfulParent) {
-        return [];
-    }
-    return [contextfulParent, ...getContextfulStack(contextfulParent)];
-}
-const contextProviders = new WeakMap();
-function registerContextProvider(adapter, attachedLe, consumerCallback) {
-    let elementMap = contextProviders.get(adapter);
-    if (!elementMap) {
-        elementMap = new WeakMap();
-        contextProviders.set(adapter, elementMap);
-    }
-    elementMap.set(attachedLe, consumerCallback);
-}
-function connectContext(adapter, contextConsumer, onNewValue) {
-    const elementMap = contextProviders.get(adapter);
-    if (!elementMap) {
-        return;
-    }
-    const contextfulStack = getContextfulStack(contextConsumer);
-    for (const ancestor of contextfulStack) {
-        const onConsumerConnected = elementMap.get(ancestor);
-        if (onConsumerConnected) {
-            onConsumerConnected({
-                provide(newContextValue) {
-                    onNewValue(newContextValue);
-                },
-            });
-            return;
-        }
-    }
-}
-function createContextProvider(adapter) {
-    return (le, options) => {
-        if (!(le instanceof LightningElement)) {
-            throw new Error('Unable to register context provider on provided `elm`.');
-        }
-        if (!le.isConnected || !options?.consumerConnectedCallback) {
-            return;
-        }
-        const { consumerConnectedCallback } = options;
-        registerContextProvider(adapter, le, (consumer) => consumerConnectedCallback(consumer));
-    };
-}
-
-export { ClassList, LightningElement, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, addSlottedContent, api, connectContext, createContextProvider, createElement, establishContextfulRelationship, fallbackTmpl, fallbackTmplNoYield, freezeTemplate, getComponentDef, hasScopedStaticStylesheets, hot, htmlEscape, isComponentConstructor, mutationTracker, normalizeClass, normalizeTabIndex, normalizeTextContent, parseFragment, parseSVGFragment, readonly, registerComponent, registerDecorators, registerTemplate, renderAttrs, renderAttrsNoYield, serverSideRenderComponent as renderComponent, renderStylesheets, renderTextContent, renderer, sanitizeAttribute, sanitizeHtmlContent, serverSideRenderComponent, setContextKeys, setFeatureFlag, setFeatureFlagForTest, setHooks, setTrustedContextSet, swapComponent, swapStyle, swapTemplate, toIteratorDirective, track, unwrap$1 as unwrap, validateStyleTextContents, wire };
-/** version: 8.20.0 */
+export { ClassList, LightningElement, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, SignalBaseClass, addTrustedContext as __dangerous_do_not_use_addTrustedContext, addSlottedContent, api, connectContext$1 as connectContext, createContextProvider, createElement, establishContextfulRelationship, fallbackTmpl, fallbackTmplNoYield, freezeTemplate, getComponentDef, hasScopedStaticStylesheets, hot, htmlEscape, isComponentConstructor, isTrustedSignal, mutationTracker, normalizeClass, normalizeTabIndex, normalizeTextContent, parseFragment, parseSVGFragment, readonly, registerComponent, registerDecorators, registerTemplate, renderAttrs, renderAttrsNoYield, serverSideRenderComponent as renderComponent, renderStylesheets, renderTextContent, renderer, sanitizeAttribute, sanitizeHtmlContent, serverSideRenderComponent, setContextKeys, setFeatureFlag, setFeatureFlagForTest, setHooks, setTrustedContextSet, setTrustedSignalSet, swapComponent, swapStyle, swapTemplate, toIteratorDirective, track, unwrap$1 as unwrap, validateStyleTextContents, wire };
+/** version: 8.20.1 */
 //# sourceMappingURL=index.js.map

package/dist/lightning-element.d.ts

@@ -1,10 +1,12 @@
 import { ClassList } from './class-list';
 import type { Attributes, Properties } from './types';
 import type { Stylesheets } from '@lwc/shared';
+import type { Signal } from '@lwc/signals';
 type EventListenerOrEventListenerObject = unknown;
 type AddEventListenerOptions = unknown;
 type EventListenerOptions = unknown;
 type ShadowRoot = unknown;
+type ContextVarieties = Map<unknown, Signal<unknown>>;
 export type LightningElementConstructor = typeof LightningElement;
 interface PropsAvailableAtConstruction {
     tagName: string;
@@ -12,6 +14,7 @@ interface PropsAvailableAtConstruction {
 export declare const SYMBOL__SET_INTERNALS: unique symbol;
 export declare const SYMBOL__GENERATE_MARKUP: unique symbol;
 export declare const SYMBOL__DEFAULT_TEMPLATE: unique symbol;
+export declare const SYMBOL__CONTEXT_VARIETIES: unique symbol;
 export declare class LightningElement implements PropsAvailableAtConstruction {
     #private;
     static renderMode?: 'light' | 'shadow';
@@ -30,6 +33,7 @@ export declare class LightningElement implements PropsAvailableAtConstruction {
     title: string;
     isConnected: boolean;
     tagName: string;
+    [SYMBOL__CONTEXT_VARIETIES]: ContextVarieties;
     constructor(propsAvailableAtConstruction: PropsAvailableAtConstruction & Properties);
     [SYMBOL__SET_INTERNALS](props: Properties, attrs: Attributes, publicProperties: Set<string>): void;
     get className(): any;

package/dist/stubs.d.ts

@@ -9,16 +9,12 @@ export declare function registerComponent(..._: unknown[]): never;
 export declare function registerDecorators(..._: unknown[]): never;
 export declare function registerTemplate(..._: unknown[]): never;
 export declare function sanitizeAttribute(..._: unknown[]): never;
-export declare function setFeatureFlag(..._: unknown[]): never;
-export declare function setFeatureFlagForTest(..._: unknown[]): never;
 export declare function swapComponent(..._: unknown[]): never;
 export declare function swapStyle(..._: unknown[]): never;
 export declare function swapTemplate(..._: unknown[]): never;
 export declare function track(..._: unknown[]): never;
 export declare function unwrap(..._: unknown[]): never;
 export declare function wire(..._: unknown[]): never;
-export declare function setContextKeys(..._: unknown[]): never;
-export declare function setTrustedContextSet(..._: unknown[]): never;
 export declare const renderer: {
     isSyntheticShadowDefined: boolean;
     insert(..._: unknown[]): never;

package/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/ssr-runtime",
-    "version": "8.20.0",
+    "version": "8.20.1",
     "description": "Runtime complement to @lwc/ssr-compiler",
     "keywords": [
         "lwc",
@@ -48,8 +48,10 @@
         }
     },
     "devDependencies": {
-        "@lwc/shared": "8.20.0",
-        "@lwc/engine-core": "8.20.0",
+        "@lwc/shared": "8.20.1",
+        "@lwc/engine-core": "8.20.1",
+        "@lwc/features": "8.20.1",
+        "@lwc/signals": "8.20.1",
         "observable-membrane": "2.0.0"
     }
 }