signalium 1.0.1 → 1.1.0

package/dist/esm/internals/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/internals/state.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAS1G,qBAAa,WAAW,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAAiE;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IAEZ,OAAO,CAAC,UAAU,CAAoC;gBAE1C,KAAK,EAAE,CAAC,EAAE,MAAM,GAAE,YAAY,CAAC,CAAC,CAAqB,EAAE,IAAI,GAAE,MAAgB;IAOzF,GAAG,IAAI,CAAC;IAmBR,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC;IAI1B,IAAI,IAAI,CAAC;IAIT,GAAG,CAAC,KAAK,EAAE,CAAC;IAuBZ,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;CAWlD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,QAUpD;AAID,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,YAAY,EAAE,CAAC,EACf,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,CAAC,GACnD,WAAW,CAAC,CAAC,CAAC,CAIhB"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/internals/state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AASvG,qBAAa,WAAW,CAAC,CAAC,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAAiE;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IAEZ,OAAO,CAAC,UAAU,CAAoC;gBAE1C,KAAK,EAAE,CAAC,EAAE,MAAM,GAAE,YAAY,CAAC,CAAC,CAAqB,EAAE,IAAI,GAAE,MAAgB;IAOzF,GAAG,IAAI,CAAC;IAmBR,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC;IAI1B,IAAI,IAAI,CAAC;IAIT,GAAG,CAAC,KAAK,EAAE,CAAC;IAuBZ,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;CAWlD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,QAUpD;AAID,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,YAAY,EAAE,CAAC,EACf,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,CAAC,GACnD,WAAW,CAAC,CAAC,CAAC,CAIhB"}

package/dist/esm/internals/utils/equals.d.ts

@@ -1,3 +1,5 @@
 import { SignalEquals } from '../../types.js';
+export declare const DEFAULT_EQUALS: SignalEquals<unknown>;
+export declare const FALSE_EQUALS: SignalEquals<unknown>;
 export declare const equalsFrom: <T>(equals: SignalEquals<T> | false | undefined) => SignalEquals<T>;
 //# sourceMappingURL=equals.d.ts.map

package/dist/esm/internals/utils/equals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"equals.d.ts","sourceRoot":"","sources":["../../../../src/internals/utils/equals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,eAAO,MAAM,UAAU,GAAI,CAAC,UAAU,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,SAAS,KAAG,YAAY,CAAC,CAAC,CAMzF,CAAC"}
+{"version":3,"file":"equals.d.ts","sourceRoot":"","sources":["../../../../src/internals/utils/equals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,eAAO,MAAM,cAAc,EAAE,YAAY,CAAC,OAAO,CAAqB,CAAC;AACvE,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,OAAO,CAAe,CAAC;AAE/D,eAAO,MAAM,UAAU,GAAI,CAAC,UAAU,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,SAAS,KAAG,YAAY,CAAC,CAAC,CAMzF,CAAC"}

package/dist/esm/internals/utils/equals.js

@@ -1,5 +1,5 @@
-const DEFAULT_EQUALS = (a, b) => a === b;
-const FALSE_EQUALS = () => false;
+export const DEFAULT_EQUALS = (a, b) => a === b;
+export const FALSE_EQUALS = () => false;
 export const equalsFrom = (equals) => {
     if (equals === false) {
         return FALSE_EQUALS;

package/dist/esm/internals/utils/equals.js.map

@@ -1 +1 @@
-{"version":3,"file":"equals.js","sourceRoot":"","sources":["../../../../src/internals/utils/equals.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAA0B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;AAChE,MAAM,YAAY,GAA0B,GAAG,EAAE,CAAC,KAAK,CAAC;AAExD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,MAA2C,EAAmB,EAAE;IAC5F,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,IAAI,cAAc,CAAC;AAClC,CAAC,CAAC"}
+{"version":3,"file":"equals.js","sourceRoot":"","sources":["../../../../src/internals/utils/equals.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAA0B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,YAAY,GAA0B,GAAG,EAAE,CAAC,KAAK,CAAC;AAE/D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,MAA2C,EAAmB,EAAE;IAC5F,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,IAAI,cAAc,CAAC;AAClC,CAAC,CAAC"}

package/dist/esm/react/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/react/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,eAAO,MAAM,YAAY,kDAAoD,CAAC;AAE9E,wBAAgB,QAAQ,4BAEvB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/react/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,eAAO,MAAM,YAAY,kDAAoD,CAAC;AAE9E,wBAAgB,QAAQ,4BAOvB"}

package/dist/esm/react/context.js

@@ -1,6 +1,11 @@
 import { createContext, useContext } from 'react';
+import { isRendering } from './rendering.js';
 export const ScopeContext = createContext(undefined);
 export function useScope() {
+    if (!isRendering()) {
+        return undefined;
+    }
+    // eslint-disable-next-line react-hooks/rules-of-hooks
     return useContext(ScopeContext);
 }
 //# sourceMappingURL=context.js.map

package/dist/esm/react/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/react/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGlD,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA0B,SAAS,CAAC,CAAC;AAE9E,MAAM,UAAU,QAAQ;IACtB,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/react/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA0B,SAAS,CAAC,CAAC;AAE9E,MAAM,UAAU,QAAQ;IACtB,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,sDAAsD;IACtD,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC"}

package/dist/esm/react/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/react/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,WAAW,EAAe,MAAM,0BAA0B,CAAC;AAEjF,wBAAgB,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EACnD,QAAQ,EACR,QAAQ,EACR,OAAc,EACd,IAAY,GACb,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,2CAWA"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/react/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,WAAW,EAAe,MAAM,0BAA0B,CAAC;AAEjF,wBAAgB,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EACnD,QAAQ,EACR,QAAQ,EACR,OAAc,EACd,IAAY,GACb,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,2CAKA"}

package/dist/esm/react/provider.js

@@ -3,10 +3,6 @@ import { useContext } from 'react';
 import { ScopeContext } from './context.js';
 import { SignalScope } from '../internals/contexts.js';
 export function ContextProvider({ children, contexts, inherit = true, root = false, }) {
-    // if (root) {
-    //   useEffect(() => )
-    //   return <ScopeContext.Provider value={scope}>{children}</ScopeContext.Provider>;
-    // }
     const parentScope = useContext(ScopeContext);
     const scope = new SignalScope(contexts, inherit ? parentScope : undefined);
     return _jsx(ScopeContext.Provider, { value: scope, children: children });

package/dist/esm/react/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/react/provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAA4B,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEjF,MAAM,UAAU,eAAe,CAAsB,EACnD,QAAQ,EACR,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,IAAI,GAAG,KAAK,GAMb;IACC,cAAc;IACd,sBAAsB;IAEtB,oFAAoF;IACpF,IAAI;IAEJ,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,QAA6C,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhH,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CAAC;AACjF,CAAC"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/react/provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAA4B,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEjF,MAAM,UAAU,eAAe,CAAsB,EACnD,QAAQ,EACR,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,IAAI,GAAG,KAAK,GAMb;IACC,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,QAA6C,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhH,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CAAC;AACjF,CAAC"}

package/dist/esm/react/rendering.d.ts

@@ -0,0 +1,2 @@
+export declare function isRendering(): boolean;
+//# sourceMappingURL=rendering.d.ts.map

package/dist/esm/react/rendering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../src/react/rendering.ts"],"names":[],"mappings":"AAcA,wBAAgB,WAAW,YAU1B"}

package/dist/esm/react/rendering.js

@@ -0,0 +1,19 @@
+import React from 'react';
+// This is a private React internal that we need to access to check if we are rendering.
+// There is no other consistent way to check if we are rendering in both development
+// and production, and it doesn't appear that the React team wants to add one. This
+// should be checked on every major React version upgrade.
+const REACT_INTERNALS = React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED ||
+    React.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE ||
+    React.__SERVER_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;
+const IS_REACT_18 = !!REACT_INTERNALS.ReactCurrentDispatcher;
+const ReactCurrentDispatcher = REACT_INTERNALS.ReactCurrentDispatcher || REACT_INTERNALS;
+export function isRendering() {
+    const dispatcher = IS_REACT_18 ? ReactCurrentDispatcher.current : ReactCurrentDispatcher.H;
+    return (!!dispatcher &&
+        // dispatcher can be in a state where it's defined, but all hooks are invalid to call.
+        // Only way we can tell is that if they are invalid, they will all be equal to each other
+        // (e.g. because it's the function that throws an error)
+        dispatcher.useState !== dispatcher.useEffect);
+}
+//# sourceMappingURL=rendering.js.map

package/dist/esm/react/rendering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendering.js","sourceRoot":"","sources":["../../../src/react/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,wFAAwF;AACxF,oFAAoF;AACpF,mFAAmF;AACnF,0DAA0D;AAC1D,MAAM,eAAe,GAClB,KAAa,CAAC,kDAAkD;IAChE,KAAa,CAAC,+DAA+D;IAC7E,KAAa,CAAC,+DAA+D,CAAC;AAEjF,MAAM,WAAW,GAAG,CAAC,CAAC,eAAe,CAAC,sBAAsB,CAAC;AAC7D,MAAM,sBAAsB,GAAG,eAAe,CAAC,sBAAsB,IAAI,eAAe,CAAC;AAEzF,MAAM,UAAU,WAAW;IACzB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAE3F,OAAO,CACL,CAAC,CAAC,UAAU;QACZ,sFAAsF;QACtF,yFAAyF;QACzF,wDAAwD;QACxD,UAAU,CAAC,QAAQ,KAAK,UAAU,CAAC,SAAS,CAC7C,CAAC;AACJ,CAAC"}

package/dist/esm/react/signal-value.d.ts

@@ -2,5 +2,5 @@ import type { DerivedSignal } from '../internals/derived.js';
 import type { StateSignal } from '../internals/state.js';
 import type { ReactiveValue } from '../types.js';
 export declare function useStateSignal<T>(signal: StateSignal<T>): T;
-export declare function useDerivedSignal<T>(signal: DerivedSignal<T, unknown[]>): ReactiveValue<T>;
+export declare function useDerivedSignal<T, Args extends unknown[]>(signal: DerivedSignal<T, Args>): ReactiveValue<T>;
 //# sourceMappingURL=signal-value.d.ts.map

package/dist/esm/react/signal-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal-value.d.ts","sourceRoot":"","sources":["../../../src/react/signal-value.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA4BjD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAU3D;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CA4BzF"}
+{"version":3,"file":"signal-value.d.ts","sourceRoot":"","sources":["../../../src/react/signal-value.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAU3D;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CA4B5G"}

package/dist/esm/react/signal-value.js

@@ -1,25 +1,8 @@
 /* eslint-disable react-hooks/rules-of-hooks */
-import React, { useCallback, useSyncExternalStore } from 'react';
+import { useCallback, useSyncExternalStore } from 'react';
 import { isReactivePromise } from '../internals/utils/type-utils.js';
 import { isReactiveSubscription } from '../internals/async.js';
-// This is a private React internal that we need to access to check if we are rendering.
-// There is no other consistent way to check if we are rendering in both development
-// and production, and it doesn't appear that the React team wants to add one. This
-// should be checked on every major React version upgrade.
-const REACT_INTERNALS = React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED ||
-    React.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE ||
-    React.__SERVER_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;
-const ReactCurrentDispatcher = REACT_INTERNALS.ReactCurrentDispatcher || REACT_INTERNALS;
-const ReactCurrentOwner = REACT_INTERNALS.ReactCurrentOwner || REACT_INTERNALS;
-const getReactCurrentDispatcher = () => {
-    return ReactCurrentDispatcher.current || REACT_INTERNALS.H;
-};
-const getReactCurrentOwner = () => {
-    return ReactCurrentOwner.current || REACT_INTERNALS.A;
-};
-function isRendering() {
-    return !!getReactCurrentDispatcher() && !!getReactCurrentOwner();
-}
+import { isRendering } from './rendering.js';
 export function useStateSignal(signal) {
     if (!isRendering()) {
         return signal.peek();

package/dist/esm/react/signal-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"signal-value.js","sourceRoot":"","sources":["../../../src/react/signal-value.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,KAAK,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAIjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,wFAAwF;AACxF,oFAAoF;AACpF,mFAAmF;AACnF,0DAA0D;AAC1D,MAAM,eAAe,GAClB,KAAa,CAAC,kDAAkD;IAChE,KAAa,CAAC,+DAA+D;IAC7E,KAAa,CAAC,+DAA+D,CAAC;AAEjF,MAAM,sBAAsB,GAAG,eAAe,CAAC,sBAAsB,IAAI,eAAe,CAAC;AACzF,MAAM,iBAAiB,GAAG,eAAe,CAAC,iBAAiB,IAAI,eAAe,CAAC;AAE/E,MAAM,yBAAyB,GAAG,GAAG,EAAE;IACrC,OAAO,sBAAsB,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,GAAG,EAAE;IAChC,OAAO,iBAAiB,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF,SAAS,WAAW;IAClB,OAAO,CAAC,CAAC,yBAAyB,EAAE,IAAI,CAAC,CAAC,oBAAoB,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,cAAc,CAAI,MAAsB;IACtD,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,oBAAoB,CACzB,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EACzE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EACnB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAI,MAAmC;IACrE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,oBAAoB,CAChC,MAAM,CAAC,eAAe,EAAE,EACxB,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAClB,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CACnB,CAAC;IAEF,8EAA8E;IAC9E,4EAA4E;IAC5E,0EAA0E;IAC1E,yBAAyB;IACzB,EAAE;IACF,4EAA4E;IAC5E,2EAA2E;IAC3E,qCAAqC;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5E,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAkC,CAAC,CAAC;QACtE,CAAC;QAED,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,KAAyB,CAAC;AACnC,CAAC"}
+{"version":3,"file":"signal-value.js","sourceRoot":"","sources":["../../../src/react/signal-value.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAI1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,UAAU,cAAc,CAAI,MAAsB;IACtD,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,oBAAoB,CACzB,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EACzE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EACnB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAA4B,MAA8B;IACxF,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,oBAAoB,CAChC,MAAM,CAAC,eAAe,EAAE,EACxB,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAClB,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CACnB,CAAC;IAEF,8EAA8E;IAC9E,4EAA4E;IAC5E,0EAA0E;IAC1E,yBAAyB;IACzB,EAAE;IACF,4EAA4E;IAC5E,2EAA2E;IAC3E,qCAAqC;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5E,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAkC,CAAC,CAAC;QACtE,CAAC;QAED,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,KAAyB,CAAC;AACnC,CAAC"}

package/dist/esm/react/state.d.ts

@@ -1,3 +1,3 @@
-import { SignalOptions, WriteableSignal } from '../types.js';
-export declare function useStateSignal<T>(value: T, opts?: SignalOptions<T, unknown[]>): WriteableSignal<T>;
+import { SignalOptions, StateSignal } from '../types.js';
+export declare function useStateSignal<T>(value: T, opts?: SignalOptions<T, unknown[]>): StateSignal<T>;
 //# sourceMappingURL=state.d.ts.map

package/dist/esm/react/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/react/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAQlG"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/react/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAQ9F"}

package/dist/esm/react/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/react/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,UAAU,cAAc,CAAI,KAAQ,EAAE,IAAkC;IAC5E,MAAM,GAAG,GAAG,MAAM,CAAiC,SAAS,CAAC,CAAC;IAE9D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/react/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,MAAM,UAAU,cAAc,CAAI,KAAQ,EAAE,IAAkC;IAC5E,MAAM,GAAG,GAAG,MAAM,CAA6B,SAAS,CAAC,CAAC;IAE1D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC"}

package/dist/esm/types.d.ts

@@ -3,9 +3,15 @@ export interface Signal<T = unknown> {
     get(): T;
     addListener(listener: SignalListener): () => void;
 }
-export interface WriteableSignal<T> extends Signal<T> {
+export interface StateSignal<T> extends Signal<T> {
     set(value: T): void;
+    peek(): T;
+    update(updater: (value: T) => T): void;
 }
+/**
+ * @deprecated Use `StateSignal` instead.
+ */
+export type WriteableSignal<T> = StateSignal<T>;
 export type SignalEquals<T> = (prev: T, next: T) => boolean;
 export type SignalListener = () => void;
 export type SignalSubscription = {
@@ -24,6 +30,12 @@ export interface SignalOptions<T, Args extends unknown[]> {
     desc?: string;
     scope?: SignalScope;
     paramKey?: (...args: Args) => string;
+    /**
+     * Called when signal's watchCount reaches 0.
+     * Return `true` to allow GC, `false` to prevent it.
+     * If not provided, defaults to always allowing GC.
+     */
+    shouldGC?: (signal: object, value: T, args: Args) => boolean;
 }
 export interface SignalOptionsWithInit<T, Args extends unknown[]> extends SignalOptions<T, Args> {
     initValue: T extends Promise<infer U> ? U : T extends Generator<any, infer U, any> ? U : T;

package/dist/esm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO;IACjC,GAAG,IAAI,CAAC,CAAC;IACT,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IACnD,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC;AAExC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,IAAI,IAAI,CAAC;IAChB,WAAW,CAAC,IAAI,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAC/B,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KACxB,kBAAkB,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;AAE7D,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE;IACtD,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC;IAC9F,SAAS,EAAE,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACrF,OAAO,EAAE,GAAG,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;IACX,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACxD,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IAEf,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IAEjB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IACvE,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,sBAAsB,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAErF,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IACzF,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAExE,MAAM,MAAM,aAAa,CAAC,CAAC,IAEzB,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,GACvC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,GACrB,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GACxB,eAAe,CAAC,CAAC,CAAC,GAClB,CAAC,SAAS,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAC/B,eAAe,CAAC,CAAC,CAAC,GAClB,CAAC,CAAC;AAKZ,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC9B,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,GACvC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,GACrB,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GACxB,oBAAoB,CAAC,CAAC,CAAC,GACvB,CAAC,SAAS,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAC/B,oBAAoB,CAAC,CAAC,CAAC,GACvB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO;IACjC,GAAG,IAAI,CAAC,CAAC;IACT,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IAC/C,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,IAAI,IAAI,CAAC,CAAC;IACV,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAEhD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC;AAExC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,IAAI,IAAI,CAAC;IAChB,WAAW,CAAC,IAAI,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAC/B,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KACxB,kBAAkB,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;AAE7D,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE;IACtD,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;CAC9D;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,CAAE,SAAQ,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC;IAC9F,SAAS,EAAE,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACrF,OAAO,EAAE,GAAG,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;IACX,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACxD,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IAEf,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IAEjB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IACvE,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,sBAAsB,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAErF,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IACzF,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAExE,MAAM,MAAM,aAAa,CAAC,CAAC,IAEzB,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,GACvC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,GACrB,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GACxB,eAAe,CAAC,CAAC,CAAC,GAClB,CAAC,SAAS,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAC/B,eAAe,CAAC,CAAC,CAAC,GAClB,CAAC,CAAC;AAKZ,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC9B,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,GACvC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,GACrB,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GACxB,oBAAoB,CAAC,CAAC,CAAC,GACvB,CAAC,SAAS,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAC/B,oBAAoB,CAAC,CAAC,CAAC,GACvB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "signalium",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "type": "module",
   "repository": "https://github.com/pzuraq/signalium",
   "description": "Chain-reactivity at critical mass",

package/src/__tests__/context.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from 'vitest';
-import { createContext, useContext, withContexts, state } from '../index.js';
+import { createContext, useContext, withContexts, state, setRootContexts } from '../index.js';
 import { permute } from './utils/permute.js';
 import { nextTick } from './utils/async.js';
 import { reactive } from './utils/instrumented-hooks.js';
@@ -11,6 +11,60 @@ describe('contexts', () => {
     }).toThrow('useContext must be used within a signal hook');
   });
 
+  test('setRootContexts sets contexts at the root level', () => {
+    const value = state('Hello');
+    const context = createContext(value);
+    const override = state('Hey');
+
+    // Create a reactive function that uses the context
+    const derived = reactive(() => `${useContext(context).get()}, World`);
+
+    // Initially should use default value
+    expect(derived()).toBe('Hello, World');
+
+    // Set root contexts
+    setRootContexts([[context, override]]);
+
+    // Should now use the override value
+    expect(derived()).toBe('Hey, World');
+
+    // Changes to override should be reflected
+    override.set('Hi');
+    expect(derived()).toBe('Hi, World');
+  });
+
+  test('setRootContexts with multiple contexts', () => {
+    const value1 = state('Hello');
+    const value2 = state('World');
+    const context1 = createContext(value1);
+    const context2 = createContext(value2);
+    const override1 = state('Hey');
+    const override2 = state('There');
+
+    const derived = reactive(() => `${useContext(context1).get()}, ${useContext(context2).get()}`);
+
+    // Initially should use default values
+    expect(derived()).toBe('Hello, World');
+
+    // Set multiple root contexts
+    setRootContexts([
+      [context1, override1],
+      [context2, override2],
+    ]);
+
+    expect(derived()).toBe('Hey, There');
+
+    // Changes to overrides should be reflected
+    override1.set('Hi');
+    override2.set('Everyone');
+    expect(derived()).toBe('Hi, Everyone');
+
+    // Changes to original values should not affect the result
+    value1.set('Bye');
+    value2.set('Earth');
+    expect(derived()).toBe('Hi, Everyone');
+  });
+
   test('async computed maintains context ownership across await boundaries', async () => {
     const ctx = createContext('default');
 

package/src/__tests__/gc.test.ts

@@ -0,0 +1,256 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { reactive, createContext, withContexts, watcher, state } from '../index.js';
+import { SignalScope, ROOT_SCOPE, forceGc, clearRootScope } from '../internals/contexts.js';
+import { nextTick, sleep } from './utils/async.js';
+
+// Helper to access private properties for testing
+const getSignalsMap = (scope: SignalScope) => {
+  return (scope as any).signals as Map<number, any>;
+};
+
+const getGCCandidates = (scope: SignalScope) => {
+  return (scope as any).gcCandidates as Set<any>;
+};
+
+describe('Garbage Collection', () => {
+  beforeEach(() => {
+    clearRootScope();
+  });
+
+  it('should automatically garbage collect unwatched signals', async () => {
+    const testSignal = reactive(() => 42);
+
+    const w = watcher(() => testSignal());
+
+    // Watch the signal
+    const unwatch = w.addListener(() => {
+      testSignal();
+    });
+
+    await nextTick();
+
+    // Signal should be in the scope
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+
+    // Unwatch the signal
+    unwatch();
+
+    await sleep(50);
+
+    // Signal should be garbage collected
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(0);
+  });
+
+  it('should not garbage collect signals with shouldGC returning false', async () => {
+    // Create a signal that should not be garbage collected
+    const persistentSignal = reactive(() => 'persist', {
+      shouldGC: () => false,
+    });
+
+    const w = watcher(() => persistentSignal());
+
+    // Watch the signal
+    const unwatch = w.addListener(() => {
+      persistentSignal();
+    });
+
+    await nextTick();
+
+    // Signal should be in the scope
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+
+    // Unwatch the signal
+    unwatch();
+
+    await sleep(50);
+
+    // Signal should still be in the scope
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+  });
+
+  it('should support conditional GC based on signal state', async () => {
+    // Create a signal with conditional GC
+    const shouldAllowGC = state(false);
+
+    const conditionalSignal = reactive(() => shouldAllowGC.get(), {
+      shouldGC: (signal, value) => {
+        // console.log('shouldGC', signal, value);
+        return value;
+      },
+    });
+
+    const w = watcher(() => conditionalSignal());
+
+    // Watch the signal
+    const unwatch = w.addListener(() => {
+      conditionalSignal();
+    });
+
+    await nextTick();
+
+    // Signal should be in the scope
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+
+    // Unwatch the signal
+    unwatch();
+
+    await sleep(50);
+
+    // Signal should still be in the scope because shouldGC returns false
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+
+    // Now allow GC
+    shouldAllowGC.set(true);
+
+    // Watch the signal
+    const unwatch2 = w.addListener(() => {
+      conditionalSignal();
+    });
+
+    await nextTick();
+
+    // Signal should be in GC candidates
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+
+    unwatch2();
+
+    await sleep(50);
+
+    // Signal should be garbage collected
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(0);
+  });
+
+  it('should support manual garbage collection', async () => {
+    let signalObj: object;
+
+    // Create multiple signals
+    const signal1 = reactive(() => 'signal1');
+    const signal2 = reactive(() => 'signal2', {
+      shouldGC: signal => {
+        signalObj = signal;
+        return false;
+      },
+    });
+
+    const w1 = watcher(() => signal1());
+    const w2 = watcher(() => signal2());
+
+    // Watch both signals
+    const unwatch1 = w1.addListener(() => {
+      signal1();
+    });
+    const unwatch2 = w2.addListener(() => {
+      signal2();
+    });
+
+    await nextTick();
+
+    // Both signals should be in the scope
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(2);
+
+    // Unwatch both signals
+    unwatch1();
+    unwatch2();
+
+    await sleep(50);
+
+    // Only signal1 should be garbage collected
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+
+    // The remaining signal should be signal2
+    const remainingSignal = Array.from(getSignalsMap(ROOT_SCOPE).values())[0];
+    expect(remainingSignal.get()).toBe('signal2');
+
+    forceGc(signalObj!);
+
+    await sleep(50);
+
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(0);
+  });
+
+  it('should not garbage collect signals that are still being watched', async () => {
+    // Create a signal
+    const watchedSignal = reactive(() => 'watched');
+
+    const w = watcher(() => watchedSignal());
+
+    // Watch the signal but don't unwatch
+    w.addListener(() => {
+      watchedSignal();
+    });
+
+    await nextTick();
+
+    // Signal should be in the scope
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+
+    await sleep(50);
+
+    // Signal should still be in the scope because it's being watched
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+  });
+
+  it('should handle context-scoped signals correctly', async () => {
+    // Create a context
+    const TestContext = createContext('test');
+
+    // Create signals in context
+    let contextSignal: any;
+
+    withContexts([[TestContext, 'value']], () => {
+      contextSignal = reactive(() => 'context-scoped');
+
+      const w = watcher(() => contextSignal());
+
+      // Watch and unwatch
+      const unwatch = w.addListener(() => {
+        contextSignal();
+      });
+
+      unwatch();
+    });
+
+    await nextTick();
+
+    // Get the context scope (this is a bit hacky for testing)
+    const contextScope = (ROOT_SCOPE as any).children.values().next().value;
+
+    await sleep(50);
+
+    // Signal should be garbage collected from the context scope
+    expect(getSignalsMap(contextScope).size).toBe(0);
+  });
+
+  it('should remove signal from GC candidates if watched again', async () => {
+    // Create a signal
+    const signal = reactive(() => 'rewatch');
+
+    const w = watcher(() => signal());
+
+    // Watch and unwatch
+    const unwatch = w.addListener(() => {
+      signal();
+    });
+
+    await nextTick();
+
+    // Signal should be in the scope
+    expect(getSignalsMap(ROOT_SCOPE).size).toBe(1);
+
+    unwatch();
+    await nextTick();
+
+    // Signal should be in GC candidates
+    expect(getGCCandidates(ROOT_SCOPE).size).toBe(1);
+
+    // Watch again
+    w.addListener(() => {
+      signal();
+    });
+
+    await nextTick();
+
+    // Signal should be removed from GC candidates
+    expect(getGCCandidates(ROOT_SCOPE).size).toBe(0);
+  });
+});

package/src/__tests__/utils/instrumented-hooks.ts

@@ -9,7 +9,7 @@ import {
 } from '../../index.js';
 import { ReactiveTask, ReactiveValue, SignalOptionsWithInit, SignalSubscription } from '../../types.js';
 import { Context, ContextImpl, getCurrentScope, ROOT_SCOPE, SignalScope } from '../../internals/contexts.js';
-import { createDerivedSignal, DerivedSignal } from '../../internals/derived.js';
+import { DerivedSignal } from '../../internals/derived.js';
 import { ReactivePromise } from '../../internals/async.js';
 import { hashValue } from '../../internals/utils/hash.js';
 
@@ -71,10 +71,10 @@ const WATCHERS = new WeakMap<Function, DerivedSignal<unknown, unknown[]>>();
 
 // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
 function getWatcherForHook(hook: Function) {
-  let watcher = WATCHERS.get(hook);
+  let w = WATCHERS.get(hook);
 
-  if (!watcher) {
-    watcher = createDerivedSignal(
+  if (!w) {
+    w = watcher(
       () => {
         let result = hook();
 
@@ -84,18 +84,15 @@ function getWatcherForHook(hook: Function) {
 
         return result;
       },
-      undefined,
-      undefined,
-      undefined,
       { desc: 'test' + TEST_ID++ },
-    );
+    ) as DerivedSignal<unknown, unknown[]>;
 
-    unsubs.push(watcher.addListener(() => {}));
+    unsubs.push(w.addListener(() => {}));
 
-    WATCHERS.set(hook, watcher);
+    WATCHERS.set(hook, w);
   }
 
-  return watcher;
+  return w;
 }
 
 function toHaveSignalValue(

package/src/config.ts

@@ -14,7 +14,7 @@ interface SignalHooksConfig {
   runBatch: BatchFn;
   getFrameworkScope: () => SignalScope | undefined;
   useStateSignal: <T>(signal: StateSignal<T>) => T;
-  useDerivedSignal: <T>(signal: DerivedSignal<T, unknown[]>) => ReactiveValue<T>;
+  useDerivedSignal: <T, Args extends unknown[]>(signal: DerivedSignal<T, Args>) => ReactiveValue<T>;
 }
 
 export let scheduleFlush: FlushFn = flushWatchers => {
@@ -28,9 +28,11 @@ export let runBatch: BatchFn = fn => fn();
 export let getFrameworkScope: () => SignalScope | undefined = () => undefined;
 
 let useFrameworkStateSignal: <T>(signal: StateSignal<T>) => T = signal => signal.get();
-let useFrameworkDerivedSignal: <T>(signal: DerivedSignal<T, unknown[]>) => ReactiveValue<T> = signal => signal.get();
+let useFrameworkDerivedSignal: <T, Args extends unknown[]>(
+  signal: DerivedSignal<T, Args>,
+) => ReactiveValue<T> = signal => signal.get();
 
-export function useDerivedSignal<T>(signal: DerivedSignal<T, any[]>): ReactiveValue<T> {
+export function useDerivedSignal<T, Args extends unknown[]>(signal: DerivedSignal<T, Args>): ReactiveValue<T> {
   if (CURRENT_CONSUMER !== undefined) {
     return signal.get();
   } else {