signalium 1.1.0 → 1.2.0

package/.turbo/turbo-build.log

@@ -1,12 +1,12 @@
 
-> signalium@1.1.0 build
+> signalium@1.2.0 build
 > npm run build:esm && npm run build:cjs
 
 
-> signalium@1.1.0 build:esm
+> signalium@1.2.0 build:esm
 > tsc
 
 
-> signalium@1.1.0 build:cjs
+> signalium@1.2.0 build:cjs
 > tsc --module commonjs --outDir dist/cjs --moduleResolution node
 

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # signalium
 
+## 1.2.0
+
+### Minor Changes
+
+- a56cc6f: Add runReactiveSafe for running reactive functions safely in React apps
+
+## 1.1.1
+
+### Patch Changes
+
+- dd4a7f9: Fix root context inheritance
+
 ## 1.1.0
 
 ### Minor Changes

package/dist/cjs/react/index.d.ts

@@ -2,4 +2,5 @@ export { ContextProvider } from './provider.js';
 export { useScope } from './context.js';
 export { setupReact } from './setup.js';
 export { useStateSignal } from './state.js';
+export { runReactiveSafe } from './rendering.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cjs/react/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useStateSignal = exports.setupReact = exports.useScope = exports.ContextProvider = void 0;
+exports.runReactiveSafe = exports.useStateSignal = exports.setupReact = exports.useScope = exports.ContextProvider = void 0;
 var provider_js_1 = require("./provider.js");
 Object.defineProperty(exports, "ContextProvider", { enumerable: true, get: function () { return provider_js_1.ContextProvider; } });
 var context_js_1 = require("./context.js");
@@ -9,4 +9,6 @@ var setup_js_1 = require("./setup.js");
 Object.defineProperty(exports, "setupReact", { enumerable: true, get: function () { return setup_js_1.setupReact; } });
 var state_js_1 = require("./state.js");
 Object.defineProperty(exports, "useStateSignal", { enumerable: true, get: function () { return state_js_1.useStateSignal; } });
+var rendering_js_1 = require("./rendering.js");
+Object.defineProperty(exports, "runReactiveSafe", { enumerable: true, get: function () { return rendering_js_1.runReactiveSafe; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAAvC,8GAAA,eAAe,OAAA;AACxB,2CAAwC;AAA/B,sGAAA,QAAQ,OAAA;AACjB,uCAAwC;AAA/B,sGAAA,UAAU,OAAA;AACnB,uCAA4C;AAAnC,0GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAAvC,8GAAA,eAAe,OAAA;AACxB,2CAAwC;AAA/B,sGAAA,QAAQ,OAAA;AACjB,uCAAwC;AAA/B,sGAAA,UAAU,OAAA;AACnB,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AAEvB,+CAAiD;AAAxC,+GAAA,eAAe,OAAA"}

package/dist/cjs/react/provider.d.ts

@@ -1,8 +1,7 @@
 import { ContextPair } from '../internals/contexts.js';
-export declare function ContextProvider<C extends unknown[]>({ children, contexts, inherit, root, }: {
+export declare function ContextProvider<C extends unknown[]>({ children, contexts, inherit, }: {
     children: React.ReactNode;
-    contexts: [...ContextPair<C>];
+    contexts?: [...ContextPair<C>] | [];
     inherit?: boolean;
-    root?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=provider.d.ts.map

package/dist/cjs/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,2CAKA"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/react/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,WAAW,EAA2B,MAAM,0BAA0B,CAAC;AAE7F,wBAAgB,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EACnD,QAAQ,EACR,QAAa,EACb,OAAc,GACf,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,2CAKA"}

package/dist/cjs/react/provider.js

@@ -5,8 +5,8 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const context_js_1 = require("./context.js");
 const contexts_js_1 = require("../internals/contexts.js");
-function ContextProvider({ children, contexts, inherit = true, root = false, }) {
-    const parentScope = (0, react_1.useContext)(context_js_1.ScopeContext);
+function ContextProvider({ children, contexts = [], inherit = true, }) {
+    const parentScope = (0, react_1.useContext)(context_js_1.ScopeContext) ?? contexts_js_1.ROOT_SCOPE;
     const scope = new contexts_js_1.SignalScope(contexts, inherit ? parentScope : undefined);
     return (0, jsx_runtime_1.jsx)(context_js_1.ScopeContext.Provider, { value: scope, children: children });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/react/provider.tsx"],"names":[],"mappings":";;AAIA,0CAeC;;AAnBD,iCAAmC;AACnC,6CAA4C;AAC5C,0DAAiF;AAEjF,SAAgB,eAAe,CAAsB,EACnD,QAAQ,EACR,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,IAAI,GAAG,KAAK,GAMb;IACC,MAAM,WAAW,GAAG,IAAA,kBAAU,EAAC,yBAAY,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,yBAAW,CAAC,QAA6C,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhH,OAAO,uBAAC,yBAAY,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":";;AAIA,0CAaC;;AAjBD,iCAAmC;AACnC,6CAA4C;AAC5C,0DAA6F;AAE7F,SAAgB,eAAe,CAAsB,EACnD,QAAQ,EACR,QAAQ,GAAG,EAAE,EACb,OAAO,GAAG,IAAI,GAKf;IACC,MAAM,WAAW,GAAG,IAAA,kBAAU,EAAC,yBAAY,CAAC,IAAI,wBAAU,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,yBAAW,CAAC,QAA6C,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhH,OAAO,uBAAC,yBAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CAAC;AACjF,CAAC"}

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

@@ -1,2 +1,8 @@
+/**
+ * Reactive functions can be called anywhere, but React Hooks cannot. When calling reactive functions
+ * in code that _may or may not_ be used while rendering, we need to use this function to wrap the
+ * call. This will ensure that we will not be in a rendering context when the reactive function is called.
+ */
+export declare const runReactiveSafe: <T, Args extends unknown[]>(fn: (...args: Args) => T, ...args: Args) => T;
 export declare function isRendering(): boolean;
 //# sourceMappingURL=rendering.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../src/react/rendering.ts"],"names":[],"mappings":"AAcA,wBAAgB,WAAW,YAU1B"}
+{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../src/react/rendering.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,WAAW,IAAI,KAAG,CAQpG,CAAC;AAEF,wBAAgB,WAAW,YAW1B"}

package/dist/cjs/react/rendering.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.runReactiveSafe = void 0;
 exports.isRendering = isRendering;
 const react_1 = __importDefault(require("react"));
 // This is a private React internal that we need to access to check if we are rendering.
@@ -14,9 +15,26 @@ const REACT_INTERNALS = react_1.default.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WIL
     react_1.default.__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;
+let RENDERING_SAFE_MODE_COUNT = 0;
+/**
+ * Reactive functions can be called anywhere, but React Hooks cannot. When calling reactive functions
+ * in code that _may or may not_ be used while rendering, we need to use this function to wrap the
+ * call. This will ensure that we will not be in a rendering context when the reactive function is called.
+ */
+const runReactiveSafe = (fn, ...args) => {
+    RENDERING_SAFE_MODE_COUNT++;
+    try {
+        return fn(...args);
+    }
+    finally {
+        RENDERING_SAFE_MODE_COUNT--;
+    }
+};
+exports.runReactiveSafe = runReactiveSafe;
 function isRendering() {
     const dispatcher = IS_REACT_18 ? ReactCurrentDispatcher.current : ReactCurrentDispatcher.H;
-    return (!!dispatcher &&
+    return (RENDERING_SAFE_MODE_COUNT === 0 &&
+        !!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)

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

@@ -1 +1 @@
-{"version":3,"file":"rendering.js","sourceRoot":"","sources":["../../../src/react/rendering.ts"],"names":[],"mappings":";;;;;AAcA,kCAUC;AAxBD,kDAA0B;AAE1B,wFAAwF;AACxF,oFAAoF;AACpF,mFAAmF;AACnF,0DAA0D;AAC1D,MAAM,eAAe,GAClB,eAAa,CAAC,kDAAkD;IAChE,eAAa,CAAC,+DAA+D;IAC7E,eAAa,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,SAAgB,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"}
+{"version":3,"file":"rendering.js","sourceRoot":"","sources":["../../../src/react/rendering.ts"],"names":[],"mappings":";;;;;;AA+BA,kCAWC;AA1CD,kDAA0B;AAE1B,wFAAwF;AACxF,oFAAoF;AACpF,mFAAmF;AACnF,0DAA0D;AAC1D,MAAM,eAAe,GAClB,eAAa,CAAC,kDAAkD;IAChE,eAAa,CAAC,+DAA+D;IAC7E,eAAa,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,IAAI,yBAAyB,GAAG,CAAC,CAAC;AAElC;;;;GAIG;AACI,MAAM,eAAe,GAAG,CAA4B,EAAwB,EAAE,GAAG,IAAU,EAAK,EAAE;IACvG,yBAAyB,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,yBAAyB,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC,CAAC;AARW,QAAA,eAAe,mBAQ1B;AAEF,SAAgB,WAAW;IACzB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAE3F,OAAO,CACL,yBAAyB,KAAK,CAAC;QAC/B,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/index.d.ts

@@ -2,4 +2,5 @@ export { ContextProvider } from './provider.js';
 export { useScope } from './context.js';
 export { setupReact } from './setup.js';
 export { useStateSignal } from './state.js';
+export { runReactiveSafe } from './rendering.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/react/index.js

@@ -2,4 +2,5 @@ export { ContextProvider } from './provider.js';
 export { useScope } from './context.js';
 export { setupReact } from './setup.js';
 export { useStateSignal } from './state.js';
+export { runReactiveSafe } from './rendering.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -1,8 +1,7 @@
 import { ContextPair } from '../internals/contexts.js';
-export declare function ContextProvider<C extends unknown[]>({ children, contexts, inherit, root, }: {
+export declare function ContextProvider<C extends unknown[]>({ children, contexts, inherit, }: {
     children: React.ReactNode;
-    contexts: [...ContextPair<C>];
+    contexts?: [...ContextPair<C>] | [];
     inherit?: boolean;
-    root?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=provider.d.ts.map

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,2CAKA"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/react/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,WAAW,EAA2B,MAAM,0BAA0B,CAAC;AAE7F,wBAAgB,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EACnD,QAAQ,EACR,QAAa,EACb,OAAc,GACf,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,2CAKA"}

package/dist/esm/react/provider.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useContext } from 'react';
 import { ScopeContext } from './context.js';
-import { SignalScope } from '../internals/contexts.js';
-export function ContextProvider({ children, contexts, inherit = true, root = false, }) {
-    const parentScope = useContext(ScopeContext);
+import { ROOT_SCOPE, SignalScope } from '../internals/contexts.js';
+export function ContextProvider({ children, contexts = [], inherit = true, }) {
+    const parentScope = useContext(ScopeContext) ?? ROOT_SCOPE;
     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,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,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE7F,MAAM,UAAU,eAAe,CAAsB,EACnD,QAAQ,EACR,QAAQ,GAAG,EAAE,EACb,OAAO,GAAG,IAAI,GAKf;IACC,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC;IAC3D,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

@@ -1,2 +1,8 @@
+/**
+ * Reactive functions can be called anywhere, but React Hooks cannot. When calling reactive functions
+ * in code that _may or may not_ be used while rendering, we need to use this function to wrap the
+ * call. This will ensure that we will not be in a rendering context when the reactive function is called.
+ */
+export declare const runReactiveSafe: <T, Args extends unknown[]>(fn: (...args: Args) => T, ...args: Args) => T;
 export declare function isRendering(): boolean;
 //# sourceMappingURL=rendering.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../src/react/rendering.ts"],"names":[],"mappings":"AAcA,wBAAgB,WAAW,YAU1B"}
+{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../src/react/rendering.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,WAAW,IAAI,KAAG,CAQpG,CAAC;AAEF,wBAAgB,WAAW,YAW1B"}

package/dist/esm/react/rendering.js

@@ -8,9 +8,25 @@ const REACT_INTERNALS = React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED
     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;
+let RENDERING_SAFE_MODE_COUNT = 0;
+/**
+ * Reactive functions can be called anywhere, but React Hooks cannot. When calling reactive functions
+ * in code that _may or may not_ be used while rendering, we need to use this function to wrap the
+ * call. This will ensure that we will not be in a rendering context when the reactive function is called.
+ */
+export const runReactiveSafe = (fn, ...args) => {
+    RENDERING_SAFE_MODE_COUNT++;
+    try {
+        return fn(...args);
+    }
+    finally {
+        RENDERING_SAFE_MODE_COUNT--;
+    }
+};
 export function isRendering() {
     const dispatcher = IS_REACT_18 ? ReactCurrentDispatcher.current : ReactCurrentDispatcher.H;
-    return (!!dispatcher &&
+    return (RENDERING_SAFE_MODE_COUNT === 0 &&
+        !!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)

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

@@ -1 +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"}
+{"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,IAAI,yBAAyB,GAAG,CAAC,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAA4B,EAAwB,EAAE,GAAG,IAAU,EAAK,EAAE;IACvG,yBAAyB,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,yBAAyB,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,WAAW;IACzB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAE3F,OAAO,CACL,yBAAyB,KAAK,CAAC;QAC/B,CAAC,CAAC,UAAU;QACZ,sFAAsF;QACtF,yFAAyF;QACzF,wDAAwD;QACxD,UAAU,CAAC,QAAQ,KAAK,UAAU,CAAC,SAAS,CAC7C,CAAC;AACJ,CAAC"}

package/package.json

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

package/src/__tests__/context.test.ts

@@ -65,6 +65,54 @@ describe('contexts', () => {
     expect(derived()).toBe('Hi, Everyone');
   });
 
+  test('withContexts inherits from root scope', () => {
+    const defaultValue1 = state('default1');
+    const defaultValue2 = state('default2');
+    const ctx1 = createContext(defaultValue1);
+    const ctx2 = createContext(defaultValue2);
+    const rootOverride1 = state('root1');
+    const rootOverride2 = state('root2');
+
+    // Set root contexts
+    setRootContexts([
+      [ctx1, rootOverride1],
+      [ctx2, rootOverride2],
+    ]);
+
+    // Create a reactive function that uses both contexts
+    const derived = reactive(() => `${useContext(ctx1).get()}-${useContext(ctx2).get()}`);
+
+    // Should inherit from root scope when no local overrides
+    const result1 = withContexts([], () => derived());
+    expect(result1).toBe('root1-root2');
+
+    // Should inherit from root scope for unoverridden contexts
+    const localOverride1 = state('local1');
+    const result2 = withContexts([[ctx1, localOverride1]], () => derived());
+    expect(result2).toBe('local1-root2');
+
+    // Should use local overrides when provided
+    const localOverride2 = state('local2');
+    const result3 = withContexts(
+      [
+        [ctx1, localOverride1],
+        [ctx2, localOverride2],
+      ],
+      () => derived(),
+    );
+    expect(result3).toBe('local1-local2');
+
+    // Changes to root contexts should be reflected in inherited contexts
+    rootOverride1.set('updated-root1');
+    rootOverride2.set('updated-root2');
+
+    const result4 = withContexts([], () => derived());
+    expect(result4).toBe('updated-root1-updated-root2');
+
+    const result5 = withContexts([[ctx1, localOverride1]], () => derived());
+    expect(result5).toBe('local1-updated-root2');
+  });
+
   test('async computed maintains context ownership across await boundaries', async () => {
     const ctx = createContext('default');
 

package/src/react/__tests__/contexts.test.tsx

@@ -1,6 +1,6 @@
 import { describe, expect, test } from 'vitest';
 import { render } from 'vitest-browser-react';
-import { state, reactive, createContext, useContext } from 'signalium';
+import { state, reactive, createContext, useContext, setRootContexts } from '../../index.js';
 import { ContextProvider, setupReact, useScope } from '../index.js';
 import React, { useState } from 'react';
 
@@ -49,6 +49,69 @@ describe('React > contexts', () => {
     await expect.element(getByText('Hey, World')).toBeInTheDocument();
   });
 
+  test('provider inherits from root scope', async () => {
+    const defaultValue1 = state('default1');
+    const defaultValue2 = state('default2');
+    const ctx1 = createContext(defaultValue1);
+    const ctx2 = createContext(defaultValue2);
+    const rootOverride1 = state('root1');
+    const rootOverride2 = state('root2');
+
+    // Set root contexts
+    setRootContexts([
+      [ctx1, rootOverride1],
+      [ctx2, rootOverride2],
+    ]);
+
+    // Component that uses both contexts
+    function Component({ testId }: { testId: string }): React.ReactNode {
+      const value1 = useContext(ctx1);
+      const value2 = useContext(ctx2);
+      const derived = reactive(() => `${value1.get()}-${value2.get()}`);
+      return <div data-testid={testId}>{derived()}</div>;
+    }
+    const localOverride1 = state('local1');
+    const localOverride2 = state('local2');
+
+    // Should inherit from root scope when no local overrides
+    const { getByTestId } = render(
+      <>
+        <ContextProvider contexts={[]}>
+          <Component testId="result" />
+        </ContextProvider>
+        <ContextProvider contexts={[[ctx1, localOverride1]]}>
+          <Component testId="result2" />
+        </ContextProvider>
+        <ContextProvider
+          contexts={[
+            [ctx1, localOverride1],
+            [ctx2, localOverride2],
+          ]}
+        >
+          <Component testId="result3" />
+        </ContextProvider>
+      </>,
+    );
+
+    await expect.element(getByTestId('result')).toHaveTextContent('root1-root2');
+
+    // Should inherit from root scope for unoverridden contexts
+    await expect.element(getByTestId('result2')).toHaveTextContent('local1-root2');
+
+    // Should use local overrides when provided
+    await expect.element(getByTestId('result3')).toHaveTextContent('local1-local2');
+
+    // Changes to root contexts should be reflected in inherited contexts
+    rootOverride1.set('updated-root1');
+    rootOverride2.set('updated-root2');
+
+    await expect.element(getByTestId('result')).toHaveTextContent('updated-root1-updated-root2');
+
+    // Local overrides should remain unaffected by root context changes
+    await expect.element(getByTestId('result2')).toHaveTextContent('local1-updated-root2');
+    await expect.element(getByTestId('result3')).toHaveTextContent('local1-local2');
+  });
+
   test('useContext works inside computed value passed via context provider', async () => {
     const value = state('Hello');
     const override = state('Hey');

package/src/react/index.ts

@@ -2,3 +2,5 @@ export { ContextProvider } from './provider.js';
 export { useScope } from './context.js';
 export { setupReact } from './setup.js';
 export { useStateSignal } from './state.js';
+
+export { runReactiveSafe } from './rendering.js';

package/src/react/provider.tsx

@@ -1,19 +1,17 @@
 import { useContext } from 'react';
 import { ScopeContext } from './context.js';
-import { ContextImpl, ContextPair, SignalScope } from '../internals/contexts.js';
+import { ContextImpl, ContextPair, ROOT_SCOPE, SignalScope } from '../internals/contexts.js';
 
 export function ContextProvider<C extends unknown[]>({
   children,
-  contexts,
+  contexts = [],
   inherit = true,
-  root = false,
 }: {
   children: React.ReactNode;
-  contexts: [...ContextPair<C>];
+  contexts?: [...ContextPair<C>] | [];
   inherit?: boolean;
-  root?: boolean;
 }) {
-  const parentScope = useContext(ScopeContext);
+  const parentScope = useContext(ScopeContext) ?? ROOT_SCOPE;
   const scope = new SignalScope(contexts as [ContextImpl<unknown>, unknown][], inherit ? parentScope : undefined);
 
   return <ScopeContext.Provider value={scope}>{children}</ScopeContext.Provider>;

package/src/react/rendering.ts

@@ -12,10 +12,28 @@ const REACT_INTERNALS =
 const IS_REACT_18 = !!REACT_INTERNALS.ReactCurrentDispatcher;
 const ReactCurrentDispatcher = REACT_INTERNALS.ReactCurrentDispatcher || REACT_INTERNALS;
 
+let RENDERING_SAFE_MODE_COUNT = 0;
+
+/**
+ * Reactive functions can be called anywhere, but React Hooks cannot. When calling reactive functions
+ * in code that _may or may not_ be used while rendering, we need to use this function to wrap the
+ * call. This will ensure that we will not be in a rendering context when the reactive function is called.
+ */
+export const runReactiveSafe = <T, Args extends unknown[]>(fn: (...args: Args) => T, ...args: Args): T => {
+  RENDERING_SAFE_MODE_COUNT++;
+
+  try {
+    return fn(...args);
+  } finally {
+    RENDERING_SAFE_MODE_COUNT--;
+  }
+};
+
 export function isRendering() {
   const dispatcher = IS_REACT_18 ? ReactCurrentDispatcher.current : ReactCurrentDispatcher.H;
 
   return (
+    RENDERING_SAFE_MODE_COUNT === 0 &&
     !!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