@livestore/solid 0.4.0-dev.21 → 0.4.0-dev.23

package/dist/useStore.js

@@ -0,0 +1,94 @@
+import * as Solid from 'solid-js';
+import { useStoreRegistry } from "./StoreRegistryContext.jsx";
+import { useClientDocument } from "./useClientDocument.js";
+import { useQuery } from "./useQuery.js";
+import { resolve } from "./utils.js";
+import { every, when } from "./whenever.js";
+/**
+ * Returns a store resource that suspends until the store is loaded.
+ * The store is cached by its `storeId` in the `StoreRegistry`.
+ *
+ * @example
+ * ```tsx
+ * import { Suspense } from 'solid-js'
+ *
+ * function Issue(props: { issueId: string }) {
+ *   const store = useStore(issueStoreOptions(props.issueId))
+ *   const issues = store()?.useQuery(queryDb(tables.issue.select()))
+ *
+ *   return (
+ *     <Show when={store()}>
+ *       {(s) => <IssueView store={s()} />}
+ *     </Show>
+ *   )
+ * }
+ *
+ * // With Suspense boundary
+ * function App() {
+ *   return (
+ *     <Suspense fallback={<div>Loading...</div>}>
+ *       <Issue issueId="abc123" />
+ *     </Suspense>
+ *   )
+ * }
+ * ```
+ *
+ * @remarks
+ * - Suspends until the store is loaded when used within a Suspense boundary.
+ * - Store is cached by its `storeId` in the `StoreRegistry`. Multiple calls with the same `storeId` return the same store instance.
+ * - Store is cached as long as it's being used, and after `unusedCacheTime` expires (default `60_000` ms in browser, `Infinity` in non-browser)
+ * - Default store options can be configured in `StoreRegistry` constructor.
+ * - Store options are only applied when the store is loaded. Subsequent calls with different options will not affect the store if it's already loaded and cached in the registry.
+ *
+ * @typeParam TSchema - The schema type for the store
+ * @typeParam TContext - User-defined context attached to the store
+ * @typeParam TSyncPayloadSchema - Schema for the sync payload sent to the backend
+ * @returns A Resource that resolves to the loaded store instance augmented with Solid hooks
+ */
+export const useStore = (options) => {
+    const storeRegistry = useStoreRegistry();
+    const [storeResource] = Solid.createResource(() => resolve(options), (opts) => {
+        const release = storeRegistry.retain(opts);
+        Solid.onCleanup(release);
+        return storeRegistry.getOrLoadPromise(opts);
+    });
+    return withSolidApi(storeResource);
+};
+/**
+ * Augments a Store instance with Solid-specific methods (`useQuery`, `useClientDocument`).
+ *
+ * This is called automatically by `useStore()`. You typically don't need to call it
+ * directly unless you're building custom integrations.
+ *
+ * @internal
+ */
+export const withSolidApi = (store) => {
+    return Object.assign(store, {
+        useQuery(queryDef) {
+            const memo = Solid.createMemo(when(store, (store) => useQuery(queryDef, { store })));
+            return () => memo()?.();
+        },
+        useClientDocument(table, id, options) {
+            const [localState, setLocalState] = Solid.createSignal();
+            const getClient = Solid.createMemo(when(every(store, table), ([store, table]) => {
+                const client = useClientDocument(table, id, options, { store: store });
+                const _localState = Solid.untrack(localState);
+                if (_localState !== undefined) {
+                    client[1](_localState);
+                    setLocalState(undefined);
+                }
+                return client;
+            }, (previous) => previous));
+            // State accessor: return store state if available, otherwise local buffer
+            const state = when(getClient, ([state]) => state(), localState);
+            // Setter: update store if ready, otherwise buffer locally
+            const setState = when(getClient, ([, set], value) => set(value), setLocalState);
+            // ID accessor
+            const idAccessor = when(getClient, ([, , id]) => id());
+            // Query accessor
+            const queryAccessor = when(getClient, ([, , , query]) => query());
+            return [state, setState, idAccessor, queryAccessor];
+        },
+    });
+};
+//# sourceMappingURL=useStore.js.map

package/dist/useStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStore.js","sourceRoot":"","sources":["../src/useStore.ts"],"names":[],"mappings":"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"}

package/dist/useStore.server.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SSR tests for useStore
+ * These tests run in node environment with SSR JSX transform using renderToString.
+ */
+export {};
+//# sourceMappingURL=useStore.server.test.d.ts.map

package/dist/useStore.server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStore.server.test.d.ts","sourceRoot":"","sources":["../src/useStore.server.test.tsx"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/useStore.server.test.jsx

@@ -0,0 +1,56 @@
+/**
+ * SSR tests for useStore
+ * These tests run in node environment with SSR JSX transform using renderToString.
+ */
+import { isServer, renderToString } from 'solid-js/web';
+import { describe, expect, it } from 'vitest';
+import { makeInMemoryAdapter } from '@livestore/adapter-web';
+import { provideOtel } from '@livestore/common';
+import { createStore } from '@livestore/livestore';
+import { Effect } from '@livestore/utils/effect';
+import { schema, tables } from "./__tests__/fixture.jsx";
+import { withSolidApi } from "./useStore.js";
+describe('environment', () => {
+    it('runs on server', () => {
+        // Use 'window' in globalThis to avoid TypeScript error without DOM lib
+        expect('window' in globalThis).toBe(false);
+        expect(isServer).toBe(true);
+    });
+});
+describe('useStore SSR', () => {
+    it('renders component with pre-created store to string', async () => {
+        await Effect.gen(function* () {
+            const store = yield* createStore({
+                schema,
+                storeId: 'ssr-store-test',
+                adapter: makeInMemoryAdapter(),
+                debug: { instanceId: 'ssr-store-test' },
+            });
+            const storeWithSolidApi = withSolidApi(store);
+            const StoreStatus = () => {
+                return <div>Store ID: {storeWithSolidApi.storeId}</div>;
+            };
+            const html = renderToString(() => <StoreStatus />);
+            expect(html).toContain('Store ID:');
+            expect(html).toContain('ssr-store-test');
+        }).pipe(provideOtel({}), Effect.scoped, Effect.runPromise);
+    });
+    it('renders component using store queries to string', async () => {
+        await Effect.gen(function* () {
+            const store = yield* createStore({
+                schema,
+                storeId: 'ssr-store-query-test',
+                adapter: makeInMemoryAdapter(),
+                debug: { instanceId: 'ssr-store-query-test' },
+            });
+            const storeWithSolidApi = withSolidApi(store);
+            const [state] = storeWithSolidApi.useClientDocument(tables.userInfo, 'u1');
+            const UserInfo = () => {
+                return <div>User: {state().username || 'anonymous'}</div>;
+            };
+            const html = renderToString(() => <UserInfo />);
+            expect(html).toContain('User:');
+        }).pipe(provideOtel({}), Effect.scoped, Effect.runPromise);
+    });
+});
+//# sourceMappingURL=useStore.server.test.jsx.map

package/dist/useStore.server.test.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStore.server.test.jsx","sourceRoot":"","sources":["../src/useStore.server.test.tsx"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,4 @@
+import type { Accessor } from 'solid-js';
+export type AccessorMaybe<T> = Accessor<T> | T;
+export declare const resolve: <T>(value: AccessorMaybe<T>) => T;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAE9C,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,aAAa,CAAC,CAAC,CAAC,KAAG,CAKpD,CAAA"}

package/dist/utils.js

@@ -0,0 +1,7 @@
+export const resolve = (value) => {
+    if (typeof value === 'function') {
+        return value();
+    }
+    return value;
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAI,KAAuB,EAAK,EAAE;IACvD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAQ,KAAqB,EAAE,CAAA;IACjC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/dist/whenever.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Reactive utilities to ease working with nullable signals.
+ * Inlined from @bigmistqke/solid-whenever to reduce external dependencies.
+ */
+import { type AccessorMaybe } from './utils.ts';
+type NonNullable<T> = Exclude<T, null | undefined | false | 0 | ''>;
+type InferNonNullable<T> = T extends AccessorMaybe<infer TValue> | undefined ? NonNullable<TValue> : never;
+type InferNonNullableTuple<TAccessors extends Array<AccessorMaybe<any>>> = {
+    [TKey in keyof TAccessors]: InferNonNullable<TAccessors[TKey]>;
+};
+/**
+ * Returns a function that conditionally executes a callback based on the truthiness of an accessor's value,
+ * suitable for use in reactive programming contexts.
+ * @param accessor - The value or function returning a value that is checked for truthiness
+ * @param callback - The callback function to be executed if the accessor's value is truthy
+ * @param fallback - Optional callback function to be executed if the accessor's value is falsy
+ * @returns A function that conditionally executes the callback or fallback based on the accessor's value
+ */
+export declare const when: {
+    <Args extends any[], TValue, TResult>(accessor: AccessorMaybe<TValue>, callback: (value: NonNullable<TValue>, ...args: Args) => TResult): (...args: Args) => TResult | undefined;
+    <Args extends any[], TValue, TResult, TFallbackResult>(accessor: AccessorMaybe<TValue>, callback: (value: NonNullable<TValue>, ...args: Args) => TResult, fallback: (...args: Args) => TFallbackResult): (...args: Args) => TResult | TFallbackResult;
+};
+/**
+ * Returns a function that conditionally executes and aggregates results from multiple accessors if all values are truthy.
+ *
+ * @param accessors Multiple accessors to be checked for truthiness.
+ * @returns A function that can be called to conditionally execute based on the truthiness of all accessor values,
+ *          returning their results as an array or undefined if any are not truthy.
+ */
+export declare const every: <TAccessors extends Array<AccessorMaybe<any>>>(...accessors: TAccessors) => (() => InferNonNullableTuple<TAccessors> | undefined);
+export {};
+//# sourceMappingURL=whenever.d.ts.map

package/dist/whenever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whenever.d.ts","sourceRoot":"","sources":["../src/whenever.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,YAAY,CAAA;AAExD,KAAK,WAAW,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,CAAC,GAAG,EAAE,CAAC,CAAA;AACnE,KAAK,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;AAC1G,KAAK,qBAAqB,CAAC,UAAU,SAAS,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI;KACxE,IAAI,IAAI,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;CAC/D,CAAA;AAsBD;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,EAAE;IACjB,CAAC,IAAI,SAAS,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAClC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,GAC/D,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,SAAS,CAAA;IACzC,CAAC,IAAI,SAAS,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EACnD,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,EAChE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,eAAe,GAC3C,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,eAAe,CAAA;CAQhD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,SAAS,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAChE,GAAG,WAAW,UAAU,KACvB,CAAC,MAAM,qBAAqB,CAAC,UAAU,CAAC,GAAG,SAAS,CAUtD,CAAA"}

package/dist/whenever.js

@@ -0,0 +1,51 @@
+/**
+ * Reactive utilities to ease working with nullable signals.
+ * Inlined from @bigmistqke/solid-whenever to reduce external dependencies.
+ */
+import { resolve } from "./utils.js";
+/**
+ * Checks if the accessor's value is truthy and executes a callback with that value.
+ * @param accessor - The value or function returning a value to check for truthiness
+ * @param callback - The callback function to execute if the value is truthy
+ * @param fallback - Optional callback function to execute if the value is falsy
+ * @returns The result of the callback if truthy, fallback result if falsy, or undefined if no fallback
+ */
+const check = (accessor, callback, fallback) => {
+    const value = resolve(accessor);
+    return Boolean(value) === true
+        ? callback(value)
+        : fallback !== undefined
+            ? fallback()
+            : undefined;
+};
+/**
+ * Returns a function that conditionally executes a callback based on the truthiness of an accessor's value,
+ * suitable for use in reactive programming contexts.
+ * @param accessor - The value or function returning a value that is checked for truthiness
+ * @param callback - The callback function to be executed if the accessor's value is truthy
+ * @param fallback - Optional callback function to be executed if the accessor's value is falsy
+ * @returns A function that conditionally executes the callback or fallback based on the accessor's value
+ */
+export const when = (accessor, callback, fallback) => {
+    return (...args) => check(accessor, (value) => callback(value, ...args), fallback !== undefined ? () => fallback(...args) : undefined);
+};
+/**
+ * Returns a function that conditionally executes and aggregates results from multiple accessors if all values are truthy.
+ *
+ * @param accessors Multiple accessors to be checked for truthiness.
+ * @returns A function that can be called to conditionally execute based on the truthiness of all accessor values,
+ *          returning their results as an array or undefined if any are not truthy.
+ */
+export const every = (...accessors) => {
+    return () => {
+        const values = new Array(accessors.length);
+        for (let i = 0; i < accessors.length; i++) {
+            const _value = resolve(accessors[i]);
+            if (_value == null)
+                return undefined;
+            values[i] = _value;
+        }
+        return values;
+    };
+};
+//# sourceMappingURL=whenever.js.map

package/dist/whenever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whenever.js","sourceRoot":"","sources":["../src/whenever.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAsB,OAAO,EAAE,MAAM,YAAY,CAAA;AAQxD;;;;;;GAMG;AACH,MAAM,KAAK,GAAG,CACZ,QAA+B,EAC/B,QAAiD,EACjD,QAAgC,EACO,EAAE;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC/B,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI;QAC5B,CAAC,CAAC,QAAQ,CAAC,KAA4B,CAAC;QACxC,CAAC,CAAC,QAAQ,KAAK,SAAS;YACtB,CAAC,CAAC,QAAQ,EAAE;YACZ,CAAC,CAAC,SAAS,CAAA;AACjB,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GAUb,CACF,QAA+B,EAC/B,QAAgE,EAChE,QAA6C,EACe,EAAE;IAC9D,OAAO,CAAC,GAAG,IAAU,EAAE,EAAE,CACvB,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AACtH,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,GAAG,SAAqB,EAC+B,EAAE;IACzD,OAAO,GAAG,EAAE;QACV,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,CAAsC,CAAA;QAC/E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;YACpC,IAAI,MAAM,IAAI,IAAI;gBAAE,OAAO,SAAS,CAAA;YACpC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAA;QACpB,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -1,35 +1,83 @@
 {
   "name": "@livestore/solid",
-  "version": "0.4.0-dev.21",
+  "version": "0.4.0-dev.23",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/livestorejs/livestore.git"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "src"
+  ],
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": "./dist/mod.js"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@opentelemetry/api": "1.9.0",
-    "@livestore/utils": "0.4.0-dev.21",
-    "@livestore/livestore": "0.4.0-dev.21",
-    "@livestore/common": "0.4.0-dev.21"
+    "@livestore/common": "^0.4.0-dev.23",
+    "@livestore/framework-toolkit": "^0.4.0-dev.23",
+    "@livestore/livestore": "^0.4.0-dev.23",
+    "@livestore/utils": "^0.4.0-dev.23"
   },
   "devDependencies": {
-    "@opentelemetry/sdk-trace-base": "2.0.1",
-    "jsdom": "^26.1.0",
+    "@opentelemetry/sdk-trace-base": "2.2.0",
+    "@solidjs/testing-library": "0.8.10",
+    "@testing-library/jest-dom": "6.6.3",
+    "jsdom": "26.1.0",
     "solid-js": "1.9.10",
-    "typescript": "5.9.2",
-    "vite": "7.2.4",
-    "vitest": "3.2.4"
+    "typescript": "5.9.3",
+    "vite": "7.3.1",
+    "vite-plugin-solid": "2.11.10",
+    "vitest": "3.2.4",
+    "@livestore/adapter-web": "^0.4.0-dev.23",
+    "@livestore/utils-dev": "^0.4.0-dev.23"
   },
-  "files": [
-    "package.json",
-    "src",
-    "dist"
-  ],
-  "license": "Apache-2.0",
   "peerDependencies": {
+    "@effect/ai": "^0.35.0",
+    "@effect/cli": "^0.75.1",
+    "@effect/cluster": "^0.58.2",
+    "@effect/experimental": "^0.60.0",
+    "@effect/opentelemetry": "^0.63.0",
+    "@effect/platform": "^0.96.1",
+    "@effect/platform-browser": "^0.76.0",
+    "@effect/platform-bun": "^0.89.0",
+    "@effect/platform-node": "^0.106.0",
+    "@effect/printer": "^0.49.0",
+    "@effect/printer-ansi": "^0.49.0",
+    "@effect/rpc": "^0.75.1",
+    "@effect/sql": "^0.51.1",
+    "@effect/typeclass": "^0.40.0",
+    "@effect/vitest": "^0.29.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/resources": "^2.2.0",
+    "@standard-schema/spec": "^1.1.0",
+    "effect": "^3.21.2",
     "solid-js": "^1.9.10"
   },
-  "publishConfig": {
-    "access": "public"
+  "$genie": {
+    "source": "package.json.genie.ts",
+    "warning": "DO NOT EDIT - changes will be overwritten",
+    "workspaceClosureDirs": [
+      "packages/@livestore/adapter-web",
+      "packages/@livestore/common",
+      "packages/@livestore/common-cf",
+      "packages/@livestore/devtools-web-common",
+      "packages/@livestore/framework-toolkit",
+      "packages/@livestore/livestore",
+      "packages/@livestore/solid",
+      "packages/@livestore/sqlite-wasm",
+      "packages/@livestore/utils",
+      "packages/@livestore/utils-dev",
+      "packages/@livestore/wa-sqlite",
+      "packages/@livestore/webmesh"
+    ]
   },
   "scripts": {
     "build": "tsc",

package/src/StoreRegistryContext.tsx

@@ -0,0 +1,70 @@
+import * as Solid from 'solid-js'
+
+import type { StoreRegistry } from '@livestore/livestore'
+
+export const StoreRegistryContext = Solid.createContext<StoreRegistry | undefined>(undefined)
+
+export type StoreRegistryProviderProps = {
+  storeRegistry: StoreRegistry
+  children: Solid.JSX.Element
+}
+
+/**
+ * Solid context provider that makes a {@link StoreRegistry} available to descendant components.
+ *
+ * Wrap your application (or a subtree) with this provider to enable {@link useStore} and
+ * {@link useStoreRegistry} hooks within that tree.
+ *
+ * @example
+ * ```tsx
+ * import { StoreRegistry } from '@livestore/livestore'
+ * import { StoreRegistryProvider } from '@livestore/solid'
+ * import { batch } from 'solid-js'
+ *
+ * const storeRegistry = new StoreRegistry({
+ *   defaultOptions: { batchUpdates: batch }
+ * })
+ *
+ * function App() {
+ *   return (
+ *     <StoreRegistryProvider storeRegistry={storeRegistry}>
+ *       <MyComponent />
+ *     </StoreRegistryProvider>
+ *   )
+ * }
+ * ```
+ */
+export const StoreRegistryProvider = (props: StoreRegistryProviderProps): Solid.JSX.Element => {
+  return <StoreRegistryContext.Provider value={props.storeRegistry}>{props.children}</StoreRegistryContext.Provider>
+}
+
+/**
+ * Hook to access the {@link StoreRegistry} from context. Useful for advanced operations like preloading.
+ *
+ * @param override - Optional registry to use instead of the context value.
+ *   When provided, skips context lookup entirely.
+ * @returns The registry provided by the nearest {@link StoreRegistryProvider} ancestor, or the `override` if provided.
+ * @throws Error if called outside a {@link StoreRegistryProvider} and no override is provided
+ *
+ * @example
+ * ```tsx
+ * function PreloadButton(props: { issueId: string }) {
+ *   const storeRegistry = useStoreRegistry()
+ *
+ *   const handleMouseEnter = () => {
+ *     storeRegistry.preload(issueStoreOptions(props.issueId))
+ *   }
+ *
+ *   return <button onMouseEnter={handleMouseEnter}>View Issue</button>
+ * }
+ * ```
+ */
+export const useStoreRegistry = (override?: StoreRegistry): StoreRegistry => {
+  if (override !== undefined) return override
+
+  const storeRegistry = Solid.useContext(StoreRegistryContext)
+
+  if (storeRegistry == null) throw new Error('useStoreRegistry() must be used within <StoreRegistryProvider>')
+
+  return storeRegistry
+}