@lwc/engine-core 8.20.0 → 8.20.2

package/README.md

@@ -122,17 +122,25 @@ This experimental API enables the addition of a signal as a trusted signal. If t
 
 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`.
 
+### isTrustedSignal()
+
+Not intended for external use. This experimental API enables the caller to determine if an object is a trusted signal. The [ENABLE_EXPERIMENTAL_SIGNALS](https://github.com/salesforce/lwc/blob/master/packages/%40lwc/features/README.md#lwcfeatures) feature must be enabled.
+
 ### 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.
+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. The [ENABLE_EXPERIMENTAL_SIGNALS](https://github.com/salesforce/lwc/blob/master/packages/%40lwc/features/README.md#lwcfeatures) feature must be enabled.
 
 ### 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.
+Not intended for external use. This experimental API enables the addition of context as trusted context. The [ENABLE_EXPERIMENTAL_SIGNALS](https://github.com/salesforce/lwc/blob/master/packages/%40lwc/features/README.md#lwcfeatures) feature must be 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.
+enabling the provision/consumption of a contextful Signal of a specified variety for the associated component. The [ENABLE_EXPERIMENTAL_SIGNALS](https://github.com/salesforce/lwc/blob/master/packages/%40lwc/features/README.md#lwcfeatures) feature must be enabled.
+
+### SignalBaseClass
+
+Not intended for external use. Signals that extend SignalBaseClass will be added to set of trusted signals. The [ENABLE_EXPERIMENTAL_SIGNALS](https://github.com/salesforce/lwc/blob/master/packages/%40lwc/features/README.md#lwcfeatures) feature must be enabled.

package/dist/framework/base-lightning-element.d.ts

@@ -18,12 +18,17 @@ type HTMLElementTheGoodParts = {
 type RefNodes = {
     [name: string]: Element;
 };
-/**
- * A `LightningElement` will always be attached to an [`HTMLElement`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement),
- * rather than the more broad `Element` used by the generic shadow root interface.
- */
 export interface LightningElementShadowRoot extends ShadowRoot {
+    /**
+     * A `LightningElement` will always be attached to an [`HTMLElement`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement),
+     * rather than the more broad `Element` used by the generic shadow root interface.
+     */
     readonly host: HTMLElement;
+    /**
+     * When present, indicates that the shadow root is the synthetic polyfill loaded by
+     * `@lwc/synethic-shadow`.
+     */
+    readonly synthetic?: true;
 }
 export interface LightningElement extends HTMLElementTheGoodParts, AccessibleElementProperties {
     constructor: LightningElementConstructor;

package/dist/framework/main.d.ts

@@ -28,6 +28,7 @@ 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 { setContextKeys, setTrustedSignalSet, setTrustedContextSet } from '@lwc/shared';
+export { setContextKeys, setTrustedSignalSet, setTrustedContextSet, addTrustedContext, isTrustedSignal, } from '@lwc/shared';
 export type { Stylesheet, Stylesheets } from '@lwc/shared';
+export { SignalBaseClass } from '@lwc/signals';
 //# sourceMappingURL=main.d.ts.map

package/dist/index.cjs.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var shared = require('@lwc/shared');
 var features = require('@lwc/features');
+var signals = require('@lwc/signals');
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -8668,6 +8669,14 @@ function readonly(obj) {
     return getReadOnlyProxy(obj);
 }
 
+Object.defineProperty(exports, "addTrustedContext", {
+    enumerable: true,
+    get: function () { return shared.addTrustedContext; }
+});
+Object.defineProperty(exports, "isTrustedSignal", {
+    enumerable: true,
+    get: function () { return shared.isTrustedSignal; }
+});
 Object.defineProperty(exports, "setContextKeys", {
     enumerable: true,
     get: function () { return shared.setContextKeys; }
@@ -8692,6 +8701,10 @@ Object.defineProperty(exports, "setFeatureFlagForTest", {
     enumerable: true,
     get: function () { return features.setFeatureFlagForTest; }
 });
+Object.defineProperty(exports, "SignalBaseClass", {
+    enumerable: true,
+    get: function () { return signals.SignalBaseClass; }
+});
 exports.BaseBridgeElement = BaseBridgeElement;
 exports.LightningElement = LightningElement;
 exports.__unstable__ProfilerControl = profilerControl;
@@ -8728,5 +8741,5 @@ exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/** version: 8.20.0 */
+/** version: 8.20.2 */
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.js

@@ -2,8 +2,9 @@
  * 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, 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 { addTrustedContext, isTrustedSignal, setContextKeys, setHooks, setTrustedContextSet, setTrustedSignalSet } from '@lwc/shared';
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
+export { SignalBaseClass } from '@lwc/signals';
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -8666,5 +8667,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.20.0 */
+/** version: 8.20.2 */
 //# sourceMappingURL=index.js.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.20.0",
+    "version": "8.20.2",
     "description": "Core LWC engine APIs.",
     "keywords": [
         "lwc"
@@ -46,9 +46,9 @@
         }
     },
     "dependencies": {
-        "@lwc/features": "8.20.0",
-        "@lwc/shared": "8.20.0",
-        "@lwc/signals": "8.20.0"
+        "@lwc/features": "8.20.2",
+        "@lwc/shared": "8.20.2",
+        "@lwc/signals": "8.20.2"
     },
     "devDependencies": {
         "observable-membrane": "2.0.0"