fix: doc review

Author: jhefferman-sfdc

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

@@ -124,17 +124,15 @@ If `setTrustedSignalSet` is called more than once, it will throw an error. If it
 
 ### setContextKeys
 
-Enables a state manager context implementation to provide LWC with context Symbols, namely `connectContext` and `disconnectContext`. These symbols would then be defined on any manager-instantiated context as methods and those methods are called
-with a ContextConnector object when contextful components are connected and disconnected.
+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()
 
-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
-and state manager-defined context has been added to this set, the context object's connectContext and disconnectContext methods will be called with a ContextConnector when the associated component is connected and disconnected.
+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.
 
-### ContextConnector
+### ContextBinding
 
-The context object's `connectContext` and `disconnectContext` methods are called with this object when contextful components are connected and disconnected. The ContextConnector exposes `provideContext` and `consumeContext`,
+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.

packages/@lwc/engine-core/src/framework/modules/context.ts

@@ -13,7 +13,7 @@ import {
     ContextEventName,
     isTrustedContext,
     type ContextProvidedCallback,
-    type ContextConnector as IContextConnector,
+    type ContextBinding as IContextBinding,
 } from '@lwc/shared';
 import { type VM } from '../vm';
 import { logWarnOnce } from '../../shared/logger';
@@ -23,7 +23,7 @@ import type { ShouldContinueBubbling } from '../wiring/types';
 
 type ContextVarieties = Map<unknown, Signal<unknown>>;
 
-class ContextConnector<C extends object> implements IContextConnector<C> {
+class ContextBinding<C extends object> implements IContextBinding<C> {
     component: C;
     #renderer: RendererAPI;
     #providedContextVarieties: ContextVarieties;
@@ -34,26 +34,23 @@ class ContextConnector<C extends object> implements IContextConnector<C> {
         this.#renderer = vm.renderer;
         this.#elm = vm.elm;
         this.#providedContextVarieties = providedContextVarieties;
+
+        // Register the component as a context provider.
+        this.#renderer.registerContextProvider(
+            this.#elm,
+            ContextEventName,
+            (contextConsumer): ShouldContinueBubbling => {
+                // This callback is invoked when the provided context is consumed somewhere down
+                // in the component's subtree.
+                return contextConsumer.setNewContext(this.#providedContextVarieties);
+            }
+        );
     }
 
     provideContext<V extends object>(
         contextVariety: V,
         providedContextSignal: Signal<unknown>
     ): void {
-        // registerContextProvider is called one time when the component is first provided context.
-        // The component is then listening for consumers to consume the provided context.
-        if (this.#providedContextVarieties.size === 0) {
-            this.#renderer.registerContextProvider(
-                this.#elm,
-                ContextEventName,
-                (payload): ShouldContinueBubbling => {
-                    // This callback is invoked when the provided context is consumed somewhere down
-                    // in the component's subtree.
-                    return payload.setNewContext(this.#providedContextVarieties);
-                }
-            );
-        }
-
         if (this.#providedContextVarieties.has(contextVariety)) {
             logWarnOnce(
                 'Multiple contexts of the same variety were provided. Only the first context will be used.'
@@ -107,7 +104,7 @@ export function connectContext(vm: VM) {
     try {
         for (let i = 0; i < contextfulKeys.length; i++) {
             (component as any)[contextfulKeys[i]][connectContext](
-                new ContextConnector(vm, component, providedContextVarieties)
+                new ContextBinding(vm, component, providedContextVarieties)
             );
         }
     } catch (err: any) {

packages/@lwc/shared/src/context.ts

@@ -17,7 +17,7 @@ export type ContextKeys = {
 
 export type ContextProvidedCallback = (contextSignal?: object) => void;
 
-export interface ContextConnector<C extends object> {
+export interface ContextBinding<C extends object> {
     component: C;
 
     provideContext<V extends object>(contextVariety: V, providedContextSignal: object): void;