feat: export add trusted context (#5399)

* feat: export add trusted context

* fix: addTrustedContext alias

* fix: bundle size

Author: jhefferman-sfdc

packages/@lwc/engine-core/README.md

@@ -124,15 +124,15 @@ If `setTrustedSignalSet` is called more than once, it will throw an error. If it
 
 ### 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.

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

@@ -73,5 +73,10 @@ 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,
+} from '@lwc/shared';
 export type { Stylesheet, Stylesheets } from '@lwc/shared';

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

@@ -33,6 +33,7 @@ export {
     setContextKeys,
     setTrustedSignalSet,
     setTrustedContextSet,
+    addTrustedContext as __dangerous_do_not_use_addTrustedContext,
     swapComponent,
     swapStyle,
     swapTemplate,

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

@@ -30,6 +30,7 @@ export {
     parseFragment,
     parseFragment as parseSVGFragment,
     setTrustedContextSet,
+    addTrustedContext as __dangerous_do_not_use_addTrustedContext,
     setContextKeys,
 } from '@lwc/engine-core';
 

packages/@lwc/integration-karma/test-hydration/context/x/contextManager/contextManager.js

@@ -1,4 +1,8 @@
-import { setContextKeys, setTrustedContextSet } from 'lwc';
+import {
+    setContextKeys,
+    setTrustedContextSet,
+    __dangerous_do_not_use_addTrustedContext,
+} from 'lwc';
 
 const connectContext = Symbol('connectContext');
 const disconnectContext = Symbol('disconnectContext');
@@ -16,7 +20,7 @@ class MockContextSignal {
         this.value = initialValue;
         this.contextDefinition = contextDefinition;
         this.fromContext = fromContext;
-        trustedContext.add(this);
+        __dangerous_do_not_use_addTrustedContext(this);
     }
     [connectContext](runtimeAdapter) {
         this.connectProvidedComponent = runtimeAdapter.component;

packages/@lwc/ssr-runtime/src/index.ts

@@ -17,6 +17,7 @@ export {
     setContextKeys,
     setTrustedSignalSet,
     setTrustedContextSet,
+    addTrustedContext as __dangerous_do_not_use_addTrustedContext,
 } from '@lwc/shared';
 
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';

packages/lwc/README.md

@@ -90,15 +90,15 @@ If `setTrustedSignalSet` is called more than once, it will throw an error. If it
 
 ### 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.

scripts/bundlesize/bundlesize.config.json

@@ -2,7 +2,7 @@
     "files": [
         {
             "path": "packages/@lwc/engine-dom/dist/index.js",
-            "maxSize": "24.59KB"
+            "maxSize": "24.62KB"
         },
         {
             "path": "packages/@lwc/synthetic-shadow/dist/index.js",