@warp-drive/react 5.7.0-alpha.37 → 5.7.0-alpha.38

package/declarations/-private/reactive-context.d.ts

@@ -3,9 +3,16 @@ import { type JSX, type ReactNode, type Context } from "react";
 export declare function useWatcher(): {
 	watcher: Signal.subtle.Watcher;
 } | null;
+/**
+* @category Contexts
+*/
 export declare const WatcherContext: Context<{
 	watcher: Signal.subtle.Watcher;
 } | null>;
+/**
+*
+* @category Components
+*/
 export declare function ReactiveContext({ children }: {
 	children: ReactNode;
 }): JSX.Element;

package/declarations/-private/request.d.ts

@@ -132,6 +132,7 @@ export declare function Throw({ error }: {
 *
 * ```
 *
+* @category Components
 */
 export declare function Request<
 	RT,

package/declarations/-private/store-provider.d.ts

@@ -1,7 +1,19 @@
 import { Store } from "@warp-drive/core";
 import { JSX, ReactNode } from "react";
+/**
+* @category Hooks
+*/
 export declare function useStore(): Store;
-export declare function StoreProvider($props: {
-	Store: Store;
+type WithExistingStore = {
+	store: Store;
 	children: ReactNode;
-}): JSX.Element;
+};
+type WithNewStore = {
+	Store: typeof Store;
+	children: ReactNode;
+};
+/**
+* @category Components
+*/
+export declare function StoreProvider($props: WithExistingStore | WithNewStore): JSX.Element;
+export {};

package/declarations/index.d.ts

@@ -1,9 +1,7 @@
 /**
-* React-specific reactivity integration, components
-* and hooks for WarpDrive.
-*
 * @module
+* @mergeModuleWith <project>
 */
-export { ReactiveContext } from "./-private/reactive-context.js";
+export { ReactiveContext, WatcherContext } from "./-private/reactive-context.js";
 export { StoreProvider, useStore } from "./-private/store-provider.js";
 export { Request, Throw } from "./-private/request.js";

package/dist/index.js

@@ -1,11 +1,16 @@
-import { R as ReactiveContext } from "./reactive-context-zIDLf-L0.js";
-import { Store } from '@warp-drive/core';
+import { R as ReactiveContext } from "./reactive-context-ClTRYXie.js";
+export { W as WatcherContext } from "./reactive-context-ClTRYXie.js";
+import '@warp-drive/core';
 import { useMemo, createContext, use, useRef, useEffect } from 'react';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import { jsx, Fragment } from 'react/jsx-runtime';
 import { DISPOSE, createRequestSubscription, signal } from '@warp-drive/core/store/-private';
 import '@warp-drive/core/request';
 const StoreContext = /*#__PURE__*/createContext(null);
+
+/**
+ * @category Hooks
+ */
 function useStore() {
   const store = use(StoreContext);
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -15,8 +20,11 @@ function useStore() {
   })(store) : {};
   return store;
 }
+/**
+ * @category Components
+ */
 function StoreProvider($props) {
-  const store = useMemo(() => new Store(), [$props.Store]);
+  const store = useMemo(() => "store" in $props ? $props.store : new $props.Store(), ["store" in $props ? $props.store : $props.Store]);
   return /*#__PURE__*/jsx(StoreContext, {
     value: store,
     children: $props.children
@@ -168,6 +176,7 @@ function Throw({
  *
  * ```
  *
+ * @category Components
  */
 function Request($props) {
   return /*#__PURE__*/jsx(ReactiveContext, {

package/dist/install.js

@@ -1,23 +1,12 @@
 import { use } from 'react';
 import { Signal } from 'signal-polyfill';
 import { setupSignals } from '@warp-drive/core/configure';
-import { W as WatcherContext } from "./reactive-context-zIDLf-L0.js";
+import { W as WatcherContext } from "./reactive-context-ClTRYXie.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 
 /**
- * Unlike reactive frameworks, React does not have the ability to support
- * fine-grained reactivity. However, we can approximate it to "good enough"
- * granularity by keeping track of signals used within a specific context.
- *
- * React also does not have a built-in way to memoize functions the way that
- * reactive frameworks do, but by building overtop of other Signal libraries
- * we can provide this.
- *
- * Due to the above limitations, @warp-drive/react/install is built
- * overtop @warp-drive/tc39-proposal-signals/install.
- *
- * The TC39 Watcher especially is valuable here, as it allows us to subscribe to changes
- * to the dependency graph of a memo and not just a signal.
+ * {@include ./install.md}
+ * @module
  */
 
 function tryConsumeContext(signal) {

package/dist/{reactive-context-zIDLf-L0.js → reactive-context-ClTRYXie.js}

@@ -127,7 +127,16 @@ function useWatcher() {
     };
   }, () => state.snapshot);
 }
+
+/**
+ * @category Contexts
+ */
 const WatcherContext = /*#__PURE__*/createContext(null);
+
+/**
+ *
+ * @category Components
+ */
 function ReactiveContext({
   children
 }) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@warp-drive/react",
   "description": "Data bindings and utilities for React applications using WarpDrive",
-  "version": "5.7.0-alpha.37",
+  "version": "5.7.0-alpha.38",
   "license": "MIT",
   "author": "Chris Thoburn <runspired@users.noreply.github.com>",
   "repository": {
@@ -38,8 +38,8 @@
   "peerDependencies": {},
   "dependencies": {
     "@embroider/macros": "^1.18.1",
-    "@warp-drive/core": "5.7.0-alpha.37",
-    "@warp-drive/tc39-proposal-signals": "5.7.0-alpha.37",
+    "@warp-drive/core": "5.7.0-alpha.38",
+    "@warp-drive/tc39-proposal-signals": "5.7.0-alpha.38",
     "signal-polyfill": "^0.2.2",
     "react": "^19.1.1"
   },
@@ -53,11 +53,11 @@
     "@babel/runtime": "^7.28.2",
     "decorator-transforms": "^2.3.0",
     "@embroider/addon-dev": "^7.1.5",
-    "@warp-drive/internal-config": "5.7.0-alpha.37",
-    "@warp-drive/core": "5.7.0-alpha.37",
-    "@types/react": "^19.1.9",
+    "@warp-drive/internal-config": "5.7.0-alpha.38",
+    "@warp-drive/core": "5.7.0-alpha.38",
+    "@types/react": "^19.1.11",
     "react": "^19.1.1",
-    "rollup": "^4.40.0",
+    "rollup": "^4.48.0",
     "typescript": "^5.9.2",
     "vite": "^7.1.2"
   },