@salesforce/lds-worker-api 1.418.0 → 1.419.0

package/dist/sfdc/es/ldsWorkerApi.js

@@ -1371,4 +1371,4 @@ if (process.env.NODE_ENV !== 'production') {
 }
 
 export { createPrimingSession, draftManager, draftQueue, evictCacheRecordsByIds, evictExpiredCacheEntries, executeAdapter, executeMutatingAdapter, getImperativeAdapterNames, importLuvioAdapterModule, importOneStoreAdapterModule, invokeAdapter, invokeAdapterWithDraftToMerge, invokeAdapterWithDraftToReplace, invokeAdapterWithMetadata, nimbusDraftQueue, setMetadataTTL, setUiApiRecordTTL, stopEviction, subscribeToAdapter };
-// version: 1.418.0-b4def2b6ce
+// version: 1.419.0-ade430921b

package/dist/standalone/es/lds-worker-api.js

@@ -4274,7 +4274,7 @@ function withDefaultLuvio(callback) {
     }
     callbacks.push(callback);
 }
-// version: 1.418.0-b4def2b6ce
+// version: 1.419.0-ade430921b
 
 // TODO [TD-0081508]: once that TD is fulfilled we can probably change this file
 function instrumentAdapter$1(createFunction, _metadata) {
@@ -4287,9 +4287,6 @@ function instrumentLuvio(_context) { }
 // Bringing those functions in would also bring in a lot of other LWC code that calls
 // DOM apis, which JSContext can't handle.  For now we just fake in the functions we
 // need with no-op stubs.
-function isTrustedSignal(target) {
-    return true;
-}
 // unwrap for lwc-luvio
 function unwrap(data) {
     return data;
@@ -5321,7 +5318,7 @@ function createGraphQLWireAdapterConstructor(luvio, adapter, metadata, astResolv
     const { apiFamily, name } = metadata;
     return createGraphQLWireAdapterConstructor$1(adapter, `${apiFamily}.${name}`, luvio, astResolver);
 }
-// version: 1.418.0-b4def2b6ce
+// version: 1.419.0-ade430921b
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -35494,7 +35491,7 @@ withDefaultLuvio((luvio) => {
     throttle(60, 60000, setupNotifyAllListRecordUpdateAvailable(luvio));
     throttle(60, 60000, setupNotifyAllListInfoSummaryUpdateAvailable(luvio));
 });
-// version: 1.418.0-68f5961c99
+// version: 1.419.0-8232dcd0ab
 
 var allowUpdatesForNonCachedRecords = {
     isOpen: function (e) {
@@ -92822,7 +92819,7 @@ class LdsInternalDataTable {
 }
 
 const tasker = idleDetector.declareNotifierTaskMulti('NimbusSqliteStore');
-const instrumentation$2 = getInstrumentation();
+const instrumentation$2$1 = getInstrumentation();
 const GRAPHQL_QUERY_ROOT_KEY = 'UiApi::uiapi::Query[uiapi]__uiapi__query';
 const GRAPHQL_QUERY_ROOT_METRIC_NAME = 'gql-query-root-object-size';
 class NimbusSqliteStore {
@@ -92991,7 +92988,7 @@ class NimbusSqliteStore {
             if (!(row && row[1] && typeof row[1] === 'string')) {
                 return;
             }
-            instrumentation$2.trackValue(GRAPHQL_QUERY_ROOT_METRIC_NAME, row[1].length);
+            instrumentation$2$1.trackValue(GRAPHQL_QUERY_ROOT_METRIC_NAME, row[1].length);
         }
         catch { }
     }
@@ -98875,7 +98872,7 @@ function buildServiceDescriptor$b(luvio) {
         },
     };
 }
-// version: 1.418.0-68f5961c99
+// version: 1.419.0-8232dcd0ab
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -98901,7 +98898,7 @@ function buildServiceDescriptor$a(notifyRecordUpdateAvailable, getNormalizedLuvi
         },
     };
 }
-// version: 1.418.0-68f5961c99
+// version: 1.419.0-8232dcd0ab
 
 /*!
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -101550,7 +101547,7 @@ register$1({
     id: '@salesforce/lds-network-adapter',
     instrument: instrument$2,
 });
-// version: 1.418.0-b4def2b6ce
+// version: 1.419.0-ade430921b
 
 const { create: create$2, keys: keys$2 } = Object;
 const { stringify, parse } = JSON;
@@ -103593,17 +103590,117 @@ class SignalBaseClass {
 const connectContext = Symbol('connectContext');
 const disconnectContext = Symbol('disconnectContext');
 const NOOP = () => { };
+const signalMarker = Symbol('signalMarker');
+class LwcStateSignalBaseClass extends SignalBaseClass {
+    constructor() {
+        super();
+        // Marks the signal as a state manager signal so it can be identified and handled appropriately
+        Object.defineProperty(this, signalMarker, {
+            value: true,
+        });
+    }
+}
+const isSignal = (signal) => {
+    return typeof signal === 'object' && signal !== null && !!signal[signalMarker];
+};
+/**
+ * Binds all prototype methods and accessors of an instance
+ * so that `this` is always the instance, even if you extract them.
+ */
+function bindInstanceMethods(instance, collectedKeyDescriptorMap) {
+    for (const [key, desc] of collectedKeyDescriptorMap.entries()) {
+        const { configurable, enumerable = false, writable = false } = desc;
+        if ('value' in desc && typeof desc.value === 'function') {
+            // Method -> bind to instance
+            Object.defineProperty(instance, key, {
+                configurable,
+                enumerable,
+                writable,
+                value: desc.value.bind(instance),
+            });
+        }
+        else if (desc.get || desc.set) {
+            // Accessor -> bind getter/setter to instance
+            const get = desc.get ? desc.get.bind(instance) : undefined;
+            const set = desc.set ? desc.set.bind(instance) : undefined;
+            Object.defineProperty(instance, key, {
+                configurable,
+                enumerable,
+                get,
+                set,
+            });
+        }
+    }
+}
+function collectKeyDescriptorsMap(Base) {
+    let proto = Base.prototype;
+    const nonConfigurablePrototypeProps = new Set();
+    const collectedKeyDescriptorMap = new Map();
+    while (proto && proto !== Object.prototype) {
+        for (const key of Reflect.ownKeys(proto)) {
+            // Skip the constructor (string key only)
+            if (key === 'constructor')
+                continue;
+            // Already defined directly on the instance? Don't overwrite it.
+            if (collectedKeyDescriptorMap.has(key) ||
+                // Already defined as non-configurable in a subclass
+                nonConfigurablePrototypeProps.has(key)) {
+                continue;
+            }
+            const desc = Object.getOwnPropertyDescriptor(proto, key);
+            if (!desc)
+                continue;
+            // Do not touch non-configurable prototype props, or redefined ones as non-configurable in a subclass
+            if (desc.configurable === false) {
+                nonConfigurablePrototypeProps.add(key);
+                continue;
+            }
+            collectedKeyDescriptorMap.set(key, desc);
+        }
+        proto = Object.getPrototypeOf(proto);
+    }
+    return collectedKeyDescriptorMap;
+}
+/**
+ * Given a class Base, returns a new class with the *same* public shape,
+ * but whose instances auto-bind all methods/accessors (string + symbol keys)
+ * to themselves.
+ *
+ * This is a delegate pattern implementation, with advantage of preserving the
+ * object's identity.
+ */
+function LockerSafeClass(Base) {
+    const collectedKeyDescriptorMap = collectKeyDescriptorsMap(Base);
+    class Bound extends Base {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        constructor(...args) {
+            super(...args);
+            bindInstanceMethods(this, collectedKeyDescriptorMap);
+        }
+    }
+    return Bound;
+}
 
 const trustedSignalSet = new WeakSet();
 setTrustedSignalSet(trustedSignalSet);
 
+let instrumentation$2 = {
+    stateCreated: (_context) => { }, // Invoked whenever a state manager is created with defineState()
+    stateDefined: (_context) => { }, // Invoked whenever a state manager is defined with defineState()
+    contextConsumed: (_context) => { }, // Invoked whenever fromContext consumes a context
+};
+
 const atomSetter = Symbol('atomSetter');
 const contextID = Symbol('contextID');
-class AtomSignal extends SignalBaseClass {
+/**
+ * Signal subclass used to hold atom() values.
+ */
+class AtomSignal extends LwcStateSignalBaseClass {
+    _value;
+    isSignal = false;
+    unsubscribe = NOOP;
     constructor(value) {
         super();
-        this.isSignal = false;
-        this.unsubscribe = NOOP;
         this.obtainValue(value);
     }
     [atomSetter](value) {
@@ -103624,13 +103721,17 @@ class AtomSignal extends SignalBaseClass {
         return this.isSignal ? this._value.value : this._value;
     }
 }
-const isSignal = (signal) => {
-    return typeof signal === 'object' && signal !== null && isTrustedSignal();
-};
-class ComputedSignal extends SignalBaseClass {
+const LockerSafeAtomSignal = LockerSafeClass(AtomSignal);
+/**
+ * Signal subclass used to hold computed() values.
+ */
+class ComputedSignal extends LwcStateSignalBaseClass {
+    computer;
+    dependencies;
+    _value;
+    isStale = true;
     constructor(inputSignals, computer) {
         super();
-        this.isStale = true;
         this.computer = computer;
         this.dependencies = inputSignals;
         const onUpdate = () => this.notify();
@@ -103656,12 +103757,13 @@ class ComputedSignal extends SignalBaseClass {
         return this._value;
     }
 }
+const LockerSafeComputedSignal = LockerSafeClass(ComputedSignal);
 const isUpdater = (signalOrUpdater) => typeof signalOrUpdater === 'function';
 function createStateManagerAtomsClosure() {
     const smAtoms = new WeakSet();
     return {
         atom: (v) => {
-            const a = new AtomSignal(v);
+            const a = new LockerSafeAtomSignal(v);
             smAtoms.add(a);
             return a;
         },
@@ -103672,15 +103774,27 @@ function createStateManagerAtomsClosure() {
         },
     };
 }
-const computed = (inputSignalsObj, computer) => new ComputedSignal(inputSignalsObj, computer);
-const defineState = (defineStateCallback // legacy pattern
-) => {
+const computed = (inputSignalsObj, computer) => new LockerSafeComputedSignal(inputSignalsObj, computer);
+/**
+ * Symbol used to store the state definition metadata.
+ */
+const stateDefMetadataSymbol = Symbol('stateDefMetadata');
+const defineState = function (defineStateCallback, // legacy pattern
+options) {
+    // Read metadata from options parameter
+    const metadata = options?.metadata;
+    const stateDefMetadata = {
+        definedBy: metadata?.definedBy || '',
+        type: metadata?.type || 'unknown',
+    };
     const stateDefinition = (...args) => {
-        class StateManagerSignal extends SignalBaseClass {
+        class StateManagerSignal extends LwcStateSignalBaseClass {
+            internalStateShape;
+            _value;
+            isStale = true;
+            isNotifyScheduled = false;
             constructor() {
                 super();
-                this.isStale = true;
-                this.isNotifyScheduled = false;
                 const { atom, setAtom } = createStateManagerAtomsClosure();
                 const callbackResult = defineStateCallback({
                     atom,
@@ -103747,11 +103861,68 @@ const defineState = (defineStateCallback // legacy pattern
                 return this._value;
             }
         }
-        return new StateManagerSignal();
+        {
+            const LockerSafeStateManagerSignal = LockerSafeClass(StateManagerSignal);
+            return new LockerSafeStateManagerSignal();
+        }
     };
+    // Attach metadata to the state definition function for access via fromContext
+    Object.defineProperty(stateDefinition, stateDefMetadataSymbol, {
+        value: stateDefMetadata,
+        writable: false,
+        enumerable: false,
+        configurable: false,
+    });
     return stateDefinition;
 };
 
+class ConsumedContextSignal extends LwcStateSignalBaseClass {
+    desiredStateDef;
+    providedContextSignal;
+    isStale = true;
+    _value;
+    _unsubscribe = NOOP;
+    constructor(stateDef) {
+        super();
+        this.desiredStateDef = stateDef;
+    }
+    get value() {
+        if (this.isStale) {
+            this.isStale = false;
+            this._value = this.providedContextSignal?.value;
+        }
+        return this._value;
+    }
+    [connectContext](runtimeAdapter) {
+        if (!runtimeAdapter) {
+            throw new Error('Implementation error: runtimeAdapter must be present at the time of connect.');
+        }
+        runtimeAdapter.consumeContext(this.desiredStateDef, (providedContextSignal) => {
+            this.providedContextSignal = providedContextSignal;
+            const onUpdate = () => {
+                this.isStale = true;
+                this.notify();
+            };
+            onUpdate();
+            this._unsubscribe = providedContextSignal.subscribe(onUpdate);
+            // Call instrumentation hook with metadata
+            instrumentation$2.contextConsumed({
+                stateDefMetadata: this.desiredStateDef[stateDefMetadataSymbol],
+                componentName: runtimeAdapter.component?.tagName || 'unknown',
+            });
+        });
+    }
+    [disconnectContext]() {
+        // Unlike the state manager's fromContext which can subscribe to multiple
+        // ancestor contexts simultaneously, this standalone version only subscribes
+        // to a single context at a time.
+        this._unsubscribe();
+        this.providedContextSignal = undefined;
+        this._unsubscribe = NOOP;
+    }
+}
+LockerSafeClass(ConsumedContextSignal);
+
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
  * All rights reserved.
@@ -108918,7 +109089,7 @@ function registerCallback(cb) {
         cb(graphql_v1_import, graphql_imperative$1, graphql_imperative_legacy_v1_import, graphql_state_manager, useOneStoreGraphQL);
     }
 }
-// version: 1.418.0-68f5961c99
+// version: 1.419.0-8232dcd0ab
 
 function createFragmentMap(documentNode) {
     const fragments = {};
@@ -138143,7 +138314,7 @@ register$1({
     configuration: { ...configurationForGraphQLAdapters$1 },
     instrument: instrument$1,
 });
-// version: 1.418.0-68f5961c99
+// version: 1.419.0-8232dcd0ab
 
 // On core the unstable adapters are re-exported with different names,
 // we want to match them here.
@@ -138295,7 +138466,7 @@ withDefaultLuvio((luvio) => {
     unstable_graphQL_imperative = createImperativeAdapter(luvio, createInstrumentedAdapter(ldsAdapter, adapterMetadata), adapterMetadata);
     graphQLImperative = ldsAdapter;
 });
-// version: 1.418.0-68f5961c99
+// version: 1.419.0-8232dcd0ab
 
 var gqlApi = /*#__PURE__*/Object.freeze({
     __proto__: null,
@@ -139094,7 +139265,7 @@ const callbacks$1 = [];
 function register(r) {
     callbacks$1.forEach((callback) => callback(r));
 }
-// version: 1.418.0-b4def2b6ce
+// version: 1.419.0-ade430921b
 
 /**
  * Copyright (c) 2022, Salesforce, Inc.,
@@ -140410,4 +140581,4 @@ const { luvio } = getRuntime();
 setDefaultLuvio({ luvio });
 
 export { createPrimingSession, draftManager, draftQueue, evictCacheRecordsByIds, evictExpiredCacheEntries, executeAdapter, executeMutatingAdapter, getImperativeAdapterNames, importLuvioAdapterModule, importOneStoreAdapterModule, invokeAdapter, invokeAdapterWithDraftToMerge, invokeAdapterWithDraftToReplace, invokeAdapterWithMetadata, nimbusDraftQueue, registerReportObserver, setMetadataTTL, setUiApiRecordTTL, stopEviction, subscribeToAdapter };
-// version: 1.418.0-b4def2b6ce
+// version: 1.419.0-ade430921b

package/dist/standalone/umd/lds-worker-api.js

@@ -4280,7 +4280,7 @@
         }
         callbacks.push(callback);
     }
-    // version: 1.418.0-b4def2b6ce
+    // version: 1.419.0-ade430921b
 
     // TODO [TD-0081508]: once that TD is fulfilled we can probably change this file
     function instrumentAdapter$1(createFunction, _metadata) {
@@ -4293,9 +4293,6 @@
     // Bringing those functions in would also bring in a lot of other LWC code that calls
     // DOM apis, which JSContext can't handle.  For now we just fake in the functions we
     // need with no-op stubs.
-    function isTrustedSignal(target) {
-        return true;
-    }
     // unwrap for lwc-luvio
     function unwrap(data) {
         return data;
@@ -5327,7 +5324,7 @@
         const { apiFamily, name } = metadata;
         return createGraphQLWireAdapterConstructor$1(adapter, `${apiFamily}.${name}`, luvio, astResolver);
     }
-    // version: 1.418.0-b4def2b6ce
+    // version: 1.419.0-ade430921b
 
     /**
      * Copyright (c) 2022, Salesforce, Inc.,
@@ -35500,7 +35497,7 @@
         throttle(60, 60000, setupNotifyAllListRecordUpdateAvailable(luvio));
         throttle(60, 60000, setupNotifyAllListInfoSummaryUpdateAvailable(luvio));
     });
-    // version: 1.418.0-68f5961c99
+    // version: 1.419.0-8232dcd0ab
 
     var allowUpdatesForNonCachedRecords = {
         isOpen: function (e) {
@@ -92828,7 +92825,7 @@
     }
 
     const tasker = idleDetector.declareNotifierTaskMulti('NimbusSqliteStore');
-    const instrumentation$2 = getInstrumentation();
+    const instrumentation$2$1 = getInstrumentation();
     const GRAPHQL_QUERY_ROOT_KEY = 'UiApi::uiapi::Query[uiapi]__uiapi__query';
     const GRAPHQL_QUERY_ROOT_METRIC_NAME = 'gql-query-root-object-size';
     class NimbusSqliteStore {
@@ -92997,7 +92994,7 @@
                 if (!(row && row[1] && typeof row[1] === 'string')) {
                     return;
                 }
-                instrumentation$2.trackValue(GRAPHQL_QUERY_ROOT_METRIC_NAME, row[1].length);
+                instrumentation$2$1.trackValue(GRAPHQL_QUERY_ROOT_METRIC_NAME, row[1].length);
             }
             catch { }
         }
@@ -98881,7 +98878,7 @@
             },
         };
     }
-    // version: 1.418.0-68f5961c99
+    // version: 1.419.0-8232dcd0ab
 
     /**
      * Copyright (c) 2022, Salesforce, Inc.,
@@ -98907,7 +98904,7 @@
             },
         };
     }
-    // version: 1.418.0-68f5961c99
+    // version: 1.419.0-8232dcd0ab
 
     /*!
      * Copyright (c) 2022, Salesforce, Inc.,
@@ -101556,7 +101553,7 @@
         id: '@salesforce/lds-network-adapter',
         instrument: instrument$2,
     });
-    // version: 1.418.0-b4def2b6ce
+    // version: 1.419.0-ade430921b
 
     const { create: create$2, keys: keys$2 } = Object;
     const { stringify, parse } = JSON;
@@ -103599,17 +103596,117 @@
     const connectContext = Symbol('connectContext');
     const disconnectContext = Symbol('disconnectContext');
     const NOOP = () => { };
+    const signalMarker = Symbol('signalMarker');
+    class LwcStateSignalBaseClass extends SignalBaseClass {
+        constructor() {
+            super();
+            // Marks the signal as a state manager signal so it can be identified and handled appropriately
+            Object.defineProperty(this, signalMarker, {
+                value: true,
+            });
+        }
+    }
+    const isSignal = (signal) => {
+        return typeof signal === 'object' && signal !== null && !!signal[signalMarker];
+    };
+    /**
+     * Binds all prototype methods and accessors of an instance
+     * so that `this` is always the instance, even if you extract them.
+     */
+    function bindInstanceMethods(instance, collectedKeyDescriptorMap) {
+        for (const [key, desc] of collectedKeyDescriptorMap.entries()) {
+            const { configurable, enumerable = false, writable = false } = desc;
+            if ('value' in desc && typeof desc.value === 'function') {
+                // Method -> bind to instance
+                Object.defineProperty(instance, key, {
+                    configurable,
+                    enumerable,
+                    writable,
+                    value: desc.value.bind(instance),
+                });
+            }
+            else if (desc.get || desc.set) {
+                // Accessor -> bind getter/setter to instance
+                const get = desc.get ? desc.get.bind(instance) : undefined;
+                const set = desc.set ? desc.set.bind(instance) : undefined;
+                Object.defineProperty(instance, key, {
+                    configurable,
+                    enumerable,
+                    get,
+                    set,
+                });
+            }
+        }
+    }
+    function collectKeyDescriptorsMap(Base) {
+        let proto = Base.prototype;
+        const nonConfigurablePrototypeProps = new Set();
+        const collectedKeyDescriptorMap = new Map();
+        while (proto && proto !== Object.prototype) {
+            for (const key of Reflect.ownKeys(proto)) {
+                // Skip the constructor (string key only)
+                if (key === 'constructor')
+                    continue;
+                // Already defined directly on the instance? Don't overwrite it.
+                if (collectedKeyDescriptorMap.has(key) ||
+                    // Already defined as non-configurable in a subclass
+                    nonConfigurablePrototypeProps.has(key)) {
+                    continue;
+                }
+                const desc = Object.getOwnPropertyDescriptor(proto, key);
+                if (!desc)
+                    continue;
+                // Do not touch non-configurable prototype props, or redefined ones as non-configurable in a subclass
+                if (desc.configurable === false) {
+                    nonConfigurablePrototypeProps.add(key);
+                    continue;
+                }
+                collectedKeyDescriptorMap.set(key, desc);
+            }
+            proto = Object.getPrototypeOf(proto);
+        }
+        return collectedKeyDescriptorMap;
+    }
+    /**
+     * Given a class Base, returns a new class with the *same* public shape,
+     * but whose instances auto-bind all methods/accessors (string + symbol keys)
+     * to themselves.
+     *
+     * This is a delegate pattern implementation, with advantage of preserving the
+     * object's identity.
+     */
+    function LockerSafeClass(Base) {
+        const collectedKeyDescriptorMap = collectKeyDescriptorsMap(Base);
+        class Bound extends Base {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            constructor(...args) {
+                super(...args);
+                bindInstanceMethods(this, collectedKeyDescriptorMap);
+            }
+        }
+        return Bound;
+    }
 
     const trustedSignalSet = new WeakSet();
     setTrustedSignalSet(trustedSignalSet);
 
+    let instrumentation$2 = {
+        stateCreated: (_context) => { }, // Invoked whenever a state manager is created with defineState()
+        stateDefined: (_context) => { }, // Invoked whenever a state manager is defined with defineState()
+        contextConsumed: (_context) => { }, // Invoked whenever fromContext consumes a context
+    };
+
     const atomSetter = Symbol('atomSetter');
     const contextID = Symbol('contextID');
-    class AtomSignal extends SignalBaseClass {
+    /**
+     * Signal subclass used to hold atom() values.
+     */
+    class AtomSignal extends LwcStateSignalBaseClass {
+        _value;
+        isSignal = false;
+        unsubscribe = NOOP;
         constructor(value) {
             super();
-            this.isSignal = false;
-            this.unsubscribe = NOOP;
             this.obtainValue(value);
         }
         [atomSetter](value) {
@@ -103630,13 +103727,17 @@
             return this.isSignal ? this._value.value : this._value;
         }
     }
-    const isSignal = (signal) => {
-        return typeof signal === 'object' && signal !== null && isTrustedSignal();
-    };
-    class ComputedSignal extends SignalBaseClass {
+    const LockerSafeAtomSignal = LockerSafeClass(AtomSignal);
+    /**
+     * Signal subclass used to hold computed() values.
+     */
+    class ComputedSignal extends LwcStateSignalBaseClass {
+        computer;
+        dependencies;
+        _value;
+        isStale = true;
         constructor(inputSignals, computer) {
             super();
-            this.isStale = true;
             this.computer = computer;
             this.dependencies = inputSignals;
             const onUpdate = () => this.notify();
@@ -103662,12 +103763,13 @@
             return this._value;
         }
     }
+    const LockerSafeComputedSignal = LockerSafeClass(ComputedSignal);
     const isUpdater = (signalOrUpdater) => typeof signalOrUpdater === 'function';
     function createStateManagerAtomsClosure() {
         const smAtoms = new WeakSet();
         return {
             atom: (v) => {
-                const a = new AtomSignal(v);
+                const a = new LockerSafeAtomSignal(v);
                 smAtoms.add(a);
                 return a;
             },
@@ -103678,15 +103780,27 @@
             },
         };
     }
-    const computed = (inputSignalsObj, computer) => new ComputedSignal(inputSignalsObj, computer);
-    const defineState = (defineStateCallback // legacy pattern
-    ) => {
+    const computed = (inputSignalsObj, computer) => new LockerSafeComputedSignal(inputSignalsObj, computer);
+    /**
+     * Symbol used to store the state definition metadata.
+     */
+    const stateDefMetadataSymbol = Symbol('stateDefMetadata');
+    const defineState = function (defineStateCallback, // legacy pattern
+    options) {
+        // Read metadata from options parameter
+        const metadata = options?.metadata;
+        const stateDefMetadata = {
+            definedBy: metadata?.definedBy || '',
+            type: metadata?.type || 'unknown',
+        };
         const stateDefinition = (...args) => {
-            class StateManagerSignal extends SignalBaseClass {
+            class StateManagerSignal extends LwcStateSignalBaseClass {
+                internalStateShape;
+                _value;
+                isStale = true;
+                isNotifyScheduled = false;
                 constructor() {
                     super();
-                    this.isStale = true;
-                    this.isNotifyScheduled = false;
                     const { atom, setAtom } = createStateManagerAtomsClosure();
                     const callbackResult = defineStateCallback({
                         atom,
@@ -103753,11 +103867,68 @@
                     return this._value;
                 }
             }
-            return new StateManagerSignal();
+            {
+                const LockerSafeStateManagerSignal = LockerSafeClass(StateManagerSignal);
+                return new LockerSafeStateManagerSignal();
+            }
         };
+        // Attach metadata to the state definition function for access via fromContext
+        Object.defineProperty(stateDefinition, stateDefMetadataSymbol, {
+            value: stateDefMetadata,
+            writable: false,
+            enumerable: false,
+            configurable: false,
+        });
         return stateDefinition;
     };
 
+    class ConsumedContextSignal extends LwcStateSignalBaseClass {
+        desiredStateDef;
+        providedContextSignal;
+        isStale = true;
+        _value;
+        _unsubscribe = NOOP;
+        constructor(stateDef) {
+            super();
+            this.desiredStateDef = stateDef;
+        }
+        get value() {
+            if (this.isStale) {
+                this.isStale = false;
+                this._value = this.providedContextSignal?.value;
+            }
+            return this._value;
+        }
+        [connectContext](runtimeAdapter) {
+            if (!runtimeAdapter) {
+                throw new Error('Implementation error: runtimeAdapter must be present at the time of connect.');
+            }
+            runtimeAdapter.consumeContext(this.desiredStateDef, (providedContextSignal) => {
+                this.providedContextSignal = providedContextSignal;
+                const onUpdate = () => {
+                    this.isStale = true;
+                    this.notify();
+                };
+                onUpdate();
+                this._unsubscribe = providedContextSignal.subscribe(onUpdate);
+                // Call instrumentation hook with metadata
+                instrumentation$2.contextConsumed({
+                    stateDefMetadata: this.desiredStateDef[stateDefMetadataSymbol],
+                    componentName: runtimeAdapter.component?.tagName || 'unknown',
+                });
+            });
+        }
+        [disconnectContext]() {
+            // Unlike the state manager's fromContext which can subscribe to multiple
+            // ancestor contexts simultaneously, this standalone version only subscribes
+            // to a single context at a time.
+            this._unsubscribe();
+            this.providedContextSignal = undefined;
+            this._unsubscribe = NOOP;
+        }
+    }
+    LockerSafeClass(ConsumedContextSignal);
+
     /**
      * Copyright (c) 2022, Salesforce, Inc.,
      * All rights reserved.
@@ -108924,7 +109095,7 @@
             cb(graphql_v1_import, graphql_imperative$1, graphql_imperative_legacy_v1_import, graphql_state_manager, useOneStoreGraphQL);
         }
     }
-    // version: 1.418.0-68f5961c99
+    // version: 1.419.0-8232dcd0ab
 
     function createFragmentMap(documentNode) {
         const fragments = {};
@@ -138149,7 +138320,7 @@
         configuration: { ...configurationForGraphQLAdapters$1 },
         instrument: instrument$1,
     });
-    // version: 1.418.0-68f5961c99
+    // version: 1.419.0-8232dcd0ab
 
     // On core the unstable adapters are re-exported with different names,
     // we want to match them here.
@@ -138301,7 +138472,7 @@
         unstable_graphQL_imperative = createImperativeAdapter(luvio, createInstrumentedAdapter(ldsAdapter, adapterMetadata), adapterMetadata);
         graphQLImperative = ldsAdapter;
     });
-    // version: 1.418.0-68f5961c99
+    // version: 1.419.0-8232dcd0ab
 
     var gqlApi = /*#__PURE__*/Object.freeze({
         __proto__: null,
@@ -139100,7 +139271,7 @@
     function register(r) {
         callbacks$1.forEach((callback) => callback(r));
     }
-    // version: 1.418.0-b4def2b6ce
+    // version: 1.419.0-ade430921b
 
     /**
      * Copyright (c) 2022, Salesforce, Inc.,
@@ -140437,4 +140608,4 @@
     exports.subscribeToAdapter = subscribeToAdapter;
 
 }));
-// version: 1.418.0-b4def2b6ce
+// version: 1.419.0-ade430921b

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/lds-worker-api",
-    "version": "1.418.0",
+    "version": "1.419.0",
     "license": "SEE LICENSE IN LICENSE.txt",
     "description": "",
     "main": "dist/standalone/es/lds-worker-api.js",
@@ -35,14 +35,14 @@
     },
     "devDependencies": {
         "@oat-sa/rollup-plugin-wildcard-external": "^1.0.0",
-        "@salesforce/lds-adapters-graphql": "^1.418.0",
-        "@salesforce/lds-adapters-uiapi": "^1.418.0",
-        "@salesforce/lds-default-luvio": "^1.418.0",
-        "@salesforce/lds-drafts": "^1.418.0",
-        "@salesforce/lds-graphql-parser": "^1.418.0",
-        "@salesforce/lds-luvio-engine": "^1.418.0",
-        "@salesforce/lds-runtime-mobile": "^1.418.0",
-        "@salesforce/nimbus-plugin-lds": "^1.418.0",
+        "@salesforce/lds-adapters-graphql": "^1.419.0",
+        "@salesforce/lds-adapters-uiapi": "^1.419.0",
+        "@salesforce/lds-default-luvio": "^1.419.0",
+        "@salesforce/lds-drafts": "^1.419.0",
+        "@salesforce/lds-graphql-parser": "^1.419.0",
+        "@salesforce/lds-luvio-engine": "^1.419.0",
+        "@salesforce/lds-runtime-mobile": "^1.419.0",
+        "@salesforce/nimbus-plugin-lds": "^1.419.0",
         "ajv": "^8.11.0",
         "glob": "^7.1.5",
         "nimbus-types": "^2.0.0-alpha1",