Merge branch 'master' into wjh/wtr-hydration

Author: wjhsf

package.json

@@ -1,6 +1,6 @@
 {
     "name": "lwc-monorepo",
-    "version": "8.20.0",
+    "version": "8.20.1",
     "private": true,
     "description": "Lightning Web Components",
     "repository": {

packages/@lwc/aria-reflection/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/aria-reflection",
-    "version": "8.20.0",
+    "version": "8.20.1",
     "description": "ARIA element reflection polyfill for strings",
     "keywords": [
         "aom",

packages/@lwc/babel-plugin-component/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/babel-plugin-component",
-    "version": "8.20.0",
+    "version": "8.20.1",
     "description": "Babel plugin to transform a LWC module",
     "keywords": [
         "lwc"
@@ -47,8 +47,8 @@
     },
     "dependencies": {
         "@babel/helper-module-imports": "7.25.9",
-        "@lwc/errors": "8.20.0",
-        "@lwc/shared": "8.20.0",
+        "@lwc/errors": "8.20.1",
+        "@lwc/shared": "8.20.1",
         "line-column": "~1.0.2"
     },
     "devDependencies": {

packages/@lwc/compiler/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/compiler",
-    "version": "8.20.0",
+    "version": "8.20.1",
     "description": "LWC compiler",
     "keywords": [
         "lwc"
@@ -52,11 +52,11 @@
         "@babel/plugin-transform-class-properties": "7.25.9",
         "@babel/plugin-transform-object-rest-spread": "7.25.9",
         "@locker/babel-plugin-transform-unforgeables": "0.22.0",
-        "@lwc/babel-plugin-component": "8.20.0",
-        "@lwc/errors": "8.20.0",
-        "@lwc/shared": "8.20.0",
-        "@lwc/ssr-compiler": "8.20.0",
-        "@lwc/style-compiler": "8.20.0",
-        "@lwc/template-compiler": "8.20.0"
+        "@lwc/babel-plugin-component": "8.20.1",
+        "@lwc/errors": "8.20.1",
+        "@lwc/shared": "8.20.1",
+        "@lwc/ssr-compiler": "8.20.1",
+        "@lwc/style-compiler": "8.20.1",
+        "@lwc/template-compiler": "8.20.1"
     }
 }

packages/@lwc/engine-core/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.

packages/@lwc/engine-core/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.1",
     "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.1",
+        "@lwc/shared": "8.20.1",
+        "@lwc/signals": "8.20.1"
     },
     "devDependencies": {
         "observable-membrane": "2.0.0"

packages/@lwc/engine-core/src/framework/main.ts

@@ -73,5 +73,13 @@ 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';

packages/@lwc/engine-dom/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/engine-dom",
-    "version": "8.20.0",
+    "version": "8.20.1",
     "description": "Renders LWC components in a DOM environment.",
     "keywords": [
         "lwc"
@@ -46,9 +46,10 @@
         }
     },
     "devDependencies": {
-        "@lwc/engine-core": "8.20.0",
-        "@lwc/shared": "8.20.0",
-        "@lwc/features": "8.20.0"
+        "@lwc/engine-core": "8.20.1",
+        "@lwc/shared": "8.20.1",
+        "@lwc/features": "8.20.1",
+        "@lwc/signals": "8.20.1"
     },
     "lwc": {
         "modules": [

packages/@lwc/engine-dom/src/index.ts

@@ -28,17 +28,20 @@ export {
     setHooks,
     getComponentDef,
     isComponentConstructor,
+    isTrustedSignal,
     parseFragment,
     parseSVGFragment,
     setContextKeys,
     setTrustedSignalSet,
     setTrustedContextSet,
+    addTrustedContext as __dangerous_do_not_use_addTrustedContext,
     swapComponent,
     swapStyle,
     swapTemplate,
     getComponentConstructor,
     __unstable__ProfilerControl,
     __unstable__ReportingControl,
+    SignalBaseClass,
 } from '@lwc/engine-core';
 
 // Engine-core public types ------------------------------------------------------------------------

packages/@lwc/engine-server/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/engine-server",
-    "version": "8.20.0",
+    "version": "8.20.1",
     "description": "Renders LWC components in a server environment.",
     "keywords": [
         "lwc"
@@ -46,10 +46,11 @@
         }
     },
     "devDependencies": {
-        "@lwc/engine-core": "8.20.0",
-        "@lwc/rollup-plugin": "8.20.0",
-        "@lwc/shared": "8.20.0",
-        "@lwc/features": "8.20.0",
+        "@lwc/engine-core": "8.20.1",
+        "@lwc/rollup-plugin": "8.20.1",
+        "@lwc/shared": "8.20.1",
+        "@lwc/features": "8.20.1",
+        "@lwc/signals": "8.20.1",
         "@rollup/plugin-virtual": "^3.0.2",
         "parse5": "^7.3.0"
     }