@storve/react 1.0.0

package/benchmarks/week3.ts

@@ -0,0 +1,102 @@
+import { performance } from 'perf_hooks'
+import { createStore } from '@storve/core'
+
+type BenchmarkResult = {
+  operation: string
+  averageMs: string
+  status: string
+}
+
+function bench(label: string, fn: () => void, iterations = 100_000): BenchmarkResult {
+  for (let i = 0; i < 1000; i++) fn()
+
+  const start = performance.now()
+  for (let i = 0; i < iterations; i++) fn()
+  const avg = (performance.now() - start) / iterations
+
+  const limits: Record<string, number> = {
+    'useStore() subscription setup':     0.5,
+    'useStore() subscription cleanup':   0.5,
+    'selector execution (primitive)':    0.1,
+    'selector execution (derived)':      0.1,
+    'setState() write + notify (10 subs)': 1,
+  }
+
+  const limit = limits[label] ?? 1
+  const status = avg <= limit ? '✅ PASS' : '❌ FAIL'
+  return { operation: label, averageMs: avg.toFixed(8) + 'ms', status }
+}
+
+function runBenchmarks(): void {
+  console.log('\n⚡ Storve React Adapter — Benchmark Results\n')
+
+  const results: BenchmarkResult[] = []
+
+  // 1. Subscription setup
+  const store1 = createStore({ count: 0 })
+  results.push(bench('useStore() subscription setup', () => {
+    const unsub = store1.subscribe(() => {})
+    unsub()
+  }))
+
+  // 2. Subscription cleanup
+  const store2 = createStore({ count: 0 })
+  const unsubs: Array<() => void> = []
+  results.push(bench('useStore() subscription cleanup', () => {
+    const unsub = store2.subscribe(() => {})
+    unsubs.push(unsub)
+    unsubs.pop()?.()
+  }))
+
+  // 3. Selector execution primitive
+  const store3 = createStore({ count: 42, name: 'test' })
+  results.push(bench('selector execution (primitive)', () => {
+    const state = store3.getState()
+    void state.count
+  }))
+
+  // 4. Selector execution derived
+  const store4 = createStore({ a: 10, b: 20 })
+  results.push(bench('selector execution (derived)', () => {
+    const state = store4.getState()
+    void (state.a + state.b)
+  }))
+
+  // 5. setState + notify
+  const store5 = createStore({ count: 0 })
+  for (let i = 0; i < 10; i++) store5.subscribe(() => {})
+  let c = 0
+  results.push(bench('setState() write + notify (10 subs)', () => {
+    store5.setState({ count: c++ })
+  }, 10_000))
+
+  const colWidths = { operation: 45, averageMs: 20, status: 10 }
+  const header =
+    'Operation'.padEnd(colWidths.operation) +
+    'Average Time'.padEnd(colWidths.averageMs) +
+    'Status'
+  const divider = '-'.repeat(header.length)
+
+  console.log(header)
+  console.log(divider)
+
+  let allPassed = true
+  for (const r of results) {
+    if (r.status.includes('FAIL')) allPassed = false
+    console.log(
+      r.operation.padEnd(colWidths.operation) +
+      r.averageMs.padEnd(colWidths.averageMs) +
+      r.status
+    )
+  }
+
+  console.log(divider)
+  console.log(allPassed
+    ? '\n✅ All benchmarks passed!\n'
+    : '\n❌ Some benchmarks failed!\n'
+  )
+
+  if (!allPassed) process.exit(1)
+}
+
+runBenchmarks()

package/coverage/coverage-summary.json

@@ -0,0 +1,5 @@
+{"total": {"lines":{"total":89,"covered":89,"skipped":0,"pct":100},"statements":{"total":89,"covered":89,"skipped":0,"pct":100},"functions":{"total":3,"covered":3,"skipped":0,"pct":100},"branches":{"total":43,"covered":38,"skipped":0,"pct":88.37},"branchesTrue":{"total":0,"covered":0,"skipped":0,"pct":"Unknown"}}
+,"/Users/dipanshusrivastava/Desktop/React Flux/packages/storve-react/src/index.ts": {"lines":{"total":1,"covered":1,"skipped":0,"pct":100},"functions":{"total":0,"covered":0,"skipped":0,"pct":100},"statements":{"total":1,"covered":1,"skipped":0,"pct":100},"branches":{"total":0,"covered":0,"skipped":0,"pct":100}}
+,"/Users/dipanshusrivastava/Desktop/React Flux/packages/storve-react/src/useDevtools.ts": {"lines":{"total":21,"covered":21,"skipped":0,"pct":100},"functions":{"total":1,"covered":1,"skipped":0,"pct":100},"statements":{"total":21,"covered":21,"skipped":0,"pct":100},"branches":{"total":8,"covered":3,"skipped":0,"pct":37.5}}
+,"/Users/dipanshusrivastava/Desktop/React Flux/packages/storve-react/src/useStore.ts": {"lines":{"total":67,"covered":67,"skipped":0,"pct":100},"functions":{"total":2,"covered":2,"skipped":0,"pct":100},"statements":{"total":67,"covered":67,"skipped":0,"pct":100},"branches":{"total":35,"covered":35,"skipped":0,"pct":100}}
+}

package/dist/index.cjs

@@ -0,0 +1,97 @@
+'use strict';
+
+var react = require('react');
+
+function shallowEqual(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (typeof a !== 'object' || a === null || typeof b !== 'object' || b === null)
+        return false;
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    for (const k of keysA) {
+        if (!Object.prototype.hasOwnProperty.call(b, k) ||
+            !Object.is(a[k], b[k]))
+            return false;
+    }
+    return true;
+}
+function useStore(store, selector) {
+    const lastResult = react.useRef(undefined);
+    const hasUpdate = react.useRef(false);
+    const lastStore = react.useRef(null);
+    const subscribe = react.useCallback((callback) => {
+        return store.subscribe(() => {
+            hasUpdate.current = true;
+            callback();
+        });
+    }, [store]);
+    const getSnapshot = react.useCallback(() => {
+        const state = store.getState();
+        // Invalidate cache when store reference changes
+        if (store !== lastStore.current) {
+            lastStore.current = store;
+            lastResult.current = undefined;
+            hasUpdate.current = true;
+        }
+        if (selector) {
+            const next = selector(state);
+            if (Object.is(next, lastResult.current))
+                return lastResult.current;
+            if (typeof next === 'object' &&
+                next !== null &&
+                lastResult.current !== undefined &&
+                shallowEqual(next, lastResult.current)) {
+                return lastResult.current;
+            }
+            lastResult.current = next;
+            return next;
+        }
+        // No selector: return shallow copy when store updated
+        if (hasUpdate.current || lastResult.current === undefined) {
+            hasUpdate.current = false;
+            lastResult.current = { ...state }; // ✅ just cache state, don't merge actions here
+        }
+        return lastResult.current;
+    }, [store, selector]);
+    const result = react.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    // Handle selector and no-selector cases separately
+    if (selector) {
+        return result;
+    }
+    // No selector — merge actions at return time only, not inside getSnapshot
+    return Object.assign({}, result, store.actions);
+}
+
+/**
+ * A React hook that subscribes to a devtools-enabled store and returns reactive devtools state.
+ *
+ * @param store - The Storve store instance (must be wrapped with withDevtools)
+ * @returns An object containing canUndo, canRedo, history, and snapshots.
+ */
+function useDevtools(store) {
+    const devStore = store;
+    const subscribe = react.useCallback((callback) => store.subscribe(callback), [store]);
+    const getSnapshot = react.useCallback(() => {
+        const internals = devStore.__devtools;
+        if (!internals)
+            return '';
+        // Combine stable markers to identify changes that require re-render
+        return `${internals.buffer.cursor}-${internals.snapshots.size}`;
+    }, [devStore]);
+    react.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    // Return the actual properties from the store
+    // These are augmented by withDevtools extension
+    return {
+        canUndo: devStore.canUndo ?? false,
+        canRedo: devStore.canRedo ?? false,
+        history: devStore.history ?? [],
+        snapshots: devStore.snapshots ?? [],
+    };
+}
+
+exports.useDevtools = useDevtools;
+exports.useStore = useStore;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.js

@@ -0,0 +1,9 @@
+'use strict';
+
+// useStore hook goes here
+function useStore() {
+    return {};
+}
+
+exports.useStore = useStore;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/useStore.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;SAEgB,QAAQ,GAAA;AACpB,IAAA,OAAO,EAAE;AACb;;;;"}

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/useStore.ts","../src/useDevtools.ts"],"sourcesContent":[null,null],"names":["useRef","useCallback","useSyncExternalStore"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export { useStore } from './useStore';
+export { useDevtools } from './useDevtools';
+export type { Selector } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.esm.js

@@ -0,0 +1,7 @@
+// useStore hook goes here
+function useStore() {
+    return {};
+}
+
+export { useStore };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/useStore.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;SAEgB,QAAQ,GAAA;AACpB,IAAA,OAAO,EAAE;AACb;;;;"}

package/dist/index.mjs

@@ -0,0 +1,94 @@
+import { useRef, useCallback, useSyncExternalStore } from 'react';
+
+function shallowEqual(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (typeof a !== 'object' || a === null || typeof b !== 'object' || b === null)
+        return false;
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    for (const k of keysA) {
+        if (!Object.prototype.hasOwnProperty.call(b, k) ||
+            !Object.is(a[k], b[k]))
+            return false;
+    }
+    return true;
+}
+function useStore(store, selector) {
+    const lastResult = useRef(undefined);
+    const hasUpdate = useRef(false);
+    const lastStore = useRef(null);
+    const subscribe = useCallback((callback) => {
+        return store.subscribe(() => {
+            hasUpdate.current = true;
+            callback();
+        });
+    }, [store]);
+    const getSnapshot = useCallback(() => {
+        const state = store.getState();
+        // Invalidate cache when store reference changes
+        if (store !== lastStore.current) {
+            lastStore.current = store;
+            lastResult.current = undefined;
+            hasUpdate.current = true;
+        }
+        if (selector) {
+            const next = selector(state);
+            if (Object.is(next, lastResult.current))
+                return lastResult.current;
+            if (typeof next === 'object' &&
+                next !== null &&
+                lastResult.current !== undefined &&
+                shallowEqual(next, lastResult.current)) {
+                return lastResult.current;
+            }
+            lastResult.current = next;
+            return next;
+        }
+        // No selector: return shallow copy when store updated
+        if (hasUpdate.current || lastResult.current === undefined) {
+            hasUpdate.current = false;
+            lastResult.current = { ...state }; // ✅ just cache state, don't merge actions here
+        }
+        return lastResult.current;
+    }, [store, selector]);
+    const result = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    // Handle selector and no-selector cases separately
+    if (selector) {
+        return result;
+    }
+    // No selector — merge actions at return time only, not inside getSnapshot
+    return Object.assign({}, result, store.actions);
+}
+
+/**
+ * A React hook that subscribes to a devtools-enabled store and returns reactive devtools state.
+ *
+ * @param store - The Storve store instance (must be wrapped with withDevtools)
+ * @returns An object containing canUndo, canRedo, history, and snapshots.
+ */
+function useDevtools(store) {
+    const devStore = store;
+    const subscribe = useCallback((callback) => store.subscribe(callback), [store]);
+    const getSnapshot = useCallback(() => {
+        const internals = devStore.__devtools;
+        if (!internals)
+            return '';
+        // Combine stable markers to identify changes that require re-render
+        return `${internals.buffer.cursor}-${internals.snapshots.size}`;
+    }, [devStore]);
+    useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    // Return the actual properties from the store
+    // These are augmented by withDevtools extension
+    return {
+        canUndo: devStore.canUndo ?? false,
+        canRedo: devStore.canRedo ?? false,
+        history: devStore.history ?? [],
+        snapshots: devStore.snapshots ?? [],
+    };
+}
+
+export { useDevtools, useStore };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

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

package/dist/types.d.ts

@@ -0,0 +1,14 @@
+import type { Store, StoreState, StoreActions } from '@storve/core';
+/**
+ * Selector function — derives a value from store state
+ */
+export type Selector<D extends object, S> = (state: StoreState<D>) => S;
+/**
+ * Overloaded useStore hook type
+ */
+export type UseStoreResult<D extends object, S = StoreState<D>> = S & StoreActions<D>;
+export type UseStore = {
+    <D extends object>(store: Store<D>): UseStoreResult<D>;
+    <D extends object, S>(store: Store<D>, selector: Selector<D, S>): UseStoreResult<D, S>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEnE;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;AAEvE;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;AAErF,MAAM,MAAM,QAAQ,GAAG;IACnB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;IACtD,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;CACzF,CAAA"}

package/dist/useDevtools.d.ts

@@ -0,0 +1,23 @@
+import type { Store } from '@storve/core';
+/**
+ * A single entry in the devtools history buffer.
+ * Mirrors the HistoryEntry type from storve/devtools without requiring a subpath import.
+ */
+export interface HistoryEntry<S> {
+    state: S;
+    timestamp: number;
+    actionName: string;
+}
+/**
+ * A React hook that subscribes to a devtools-enabled store and returns reactive devtools state.
+ *
+ * @param store - The Storve store instance (must be wrapped with withDevtools)
+ * @returns An object containing canUndo, canRedo, history, and snapshots.
+ */
+export declare function useDevtools<S extends object>(store: Store<S>): {
+    canUndo: boolean;
+    canRedo: boolean;
+    history: readonly HistoryEntry<S>[];
+    snapshots: readonly string[];
+};
+//# sourceMappingURL=useDevtools.d.ts.map

package/dist/useDevtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDevtools.d.ts","sourceRoot":"","sources":["../src/useDevtools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB;AAyBD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAyBA"}

package/dist/useStore.d.ts

@@ -0,0 +1,5 @@
+import type { Store, StoreState } from '@storve/core';
+import type { Selector, UseStoreResult } from './types';
+export declare function shallowEqual(a: unknown, b: unknown): boolean;
+export declare function useStore<D extends object, S = StoreState<D>>(store: Store<D>, selector?: Selector<D, S>): UseStoreResult<D, S>;
+//# sourceMappingURL=useStore.d.ts.map

package/dist/useStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStore.d.ts","sourceRoot":"","sources":["../src/useStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAEvD,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAgB5D;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EACxD,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAyDtB"}

package/package.json

@@ -0,0 +1,40 @@
+{
+    "name": "@storve/react",
+    "version": "1.0.0",
+    "main": "dist/index.cjs",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.cjs"
+        }
+    },
+    "scripts": {
+        "build": "rollup -c",
+        "test": "vitest run --coverage && npx tsx benchmarks/week3.ts",
+        "test:watch": "vitest --coverage",
+        "test:coverage": "vitest run --coverage",
+        "test:bench": "npx tsx benchmarks/week3.ts",
+        "lint": "eslint src --ext .ts,.tsx"
+    },
+    "dependencies": {
+        "@storve/core": "1.0.0"
+    },
+    "peerDependencies": {
+        "react": ">=18.0.0"
+    },
+    "devDependencies": {
+        "@testing-library/jest-dom": "^6.9.1",
+        "@testing-library/react": "^16.3.2",
+        "@types/react": "^18.2.0",
+        "@types/react-dom": "^18.2.0",
+        "@vitest/coverage-v8": "^2.1.0",
+        "jsdom": "^24.1.3",
+        "react": "^18.3.1",
+        "react-dom": "^18.3.1",
+        "tsx": "^4.21.0",
+        "vitest": "^2.1.0"
+    }
+}

package/rollup.config.mjs

@@ -0,0 +1,25 @@
+import typescript from '@rollup/plugin-typescript';
+
+export default {
+    input: 'src/index.ts',
+    external: ['react', '@storve/core'],
+    output: [
+        {
+            file: 'dist/index.cjs',
+            format: 'cjs',
+            sourcemap: true,
+        },
+        {
+            file: 'dist/index.mjs',
+            format: 'es',
+            sourcemap: true,
+        },
+    ],
+    plugins: [
+        typescript({
+            tsconfig: './tsconfig.json',
+            declaration: true,
+            declarationDir: 'dist',
+        }),
+    ],
+};

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './types'
+export { useStore } from './useStore'
+export { useDevtools } from './useDevtools'
+export type { Selector } from './types'

package/src/types.ts

@@ -0,0 +1,16 @@
+import type { Store, StoreState, StoreActions } from '@storve/core'
+
+/**
+ * Selector function — derives a value from store state
+ */
+export type Selector<D extends object, S> = (state: StoreState<D>) => S
+
+/**
+ * Overloaded useStore hook type
+ */
+export type UseStoreResult<D extends object, S = StoreState<D>> = S & StoreActions<D>
+
+export type UseStore = {
+    <D extends object>(store: Store<D>): UseStoreResult<D>
+    <D extends object, S>(store: Store<D>, selector: Selector<D, S>): UseStoreResult<D, S>
+}

package/src/useDevtools.ts

@@ -0,0 +1,74 @@
+import { useSyncExternalStore, useCallback } from 'react';
+import type { Store } from '@storve/core';
+
+/**
+ * A single entry in the devtools history buffer.
+ * Mirrors the HistoryEntry type from storve/devtools without requiring a subpath import.
+ */
+export interface HistoryEntry<S> {
+    state: S;
+    timestamp: number;
+    actionName: string;
+}
+
+/**
+ * Internal shape of the __devtools property attached by withDevtools.
+ * Defined locally to avoid importing internal storve implementation details.
+ * @internal
+ */
+interface DevtoolsShape<S> {
+    buffer: { entries: HistoryEntry<S>[]; cursor: number; capacity: number };
+    snapshots: Map<string, unknown>;
+}
+
+/**
+ * Augmented store type with devtools properties.
+ * @internal
+ */
+type StoreWithDevtools<S extends object> = Store<S> & {
+    __devtools?: DevtoolsShape<S>;
+    canUndo?: boolean;
+    canRedo?: boolean;
+    history?: readonly HistoryEntry<S>[];
+    snapshots?: readonly string[];
+};
+
+
+/**
+ * A React hook that subscribes to a devtools-enabled store and returns reactive devtools state.
+ * 
+ * @param store - The Storve store instance (must be wrapped with withDevtools)
+ * @returns An object containing canUndo, canRedo, history, and snapshots.
+ */
+export function useDevtools<S extends object>(store: Store<S>): {
+    canUndo: boolean;
+    canRedo: boolean;
+    history: readonly HistoryEntry<S>[];
+    snapshots: readonly string[];
+} {
+    const devStore = store as StoreWithDevtools<S>;
+
+    const subscribe = useCallback(
+        (callback: () => void) => store.subscribe(callback),
+        [store]
+    );
+
+    const getSnapshot = useCallback(() => {
+        const internals = devStore.__devtools;
+        if (!internals) return '';
+        // Combine stable markers to identify changes that require re-render
+        return `${internals.buffer.cursor}-${internals.snapshots.size}`;
+    }, [devStore]);
+
+    useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+
+    // Return the actual properties from the store
+    // These are augmented by withDevtools extension
+    return {
+        canUndo: devStore.canUndo ?? false,
+        canRedo: devStore.canRedo ?? false,
+        history: devStore.history ?? [],
+        snapshots: devStore.snapshots ?? [],
+    };
+}
+

package/src/useStore.ts

@@ -0,0 +1,83 @@
+import { useSyncExternalStore, useRef, useCallback } from 'react'
+import type { Store, StoreState } from '@storve/core'
+import type { Selector, UseStoreResult } from './types'
+
+export function shallowEqual(a: unknown, b: unknown): boolean {
+    if (Object.is(a, b)) return true
+    if (typeof a !== 'object' || a === null || typeof b !== 'object' || b === null) return false
+    const keysA = Object.keys(a)
+    const keysB = Object.keys(b)
+    if (keysA.length !== keysB.length) return false
+    for (const k of keysA) {
+        if (
+            !Object.prototype.hasOwnProperty.call(b, k) ||
+            !Object.is(
+                (a as Record<string, unknown>)[k],
+                (b as Record<string, unknown>)[k]
+            )
+        ) return false
+    }
+    return true
+}
+
+export function useStore<D extends object, S = StoreState<D>>(
+    store: Store<D>,
+    selector?: Selector<D, S>
+): UseStoreResult<D, S> {
+    const lastResult = useRef<S | undefined>(undefined)
+    const hasUpdate = useRef(false)
+    const lastStore = useRef<Store<D> | null>(null)
+
+    const subscribe = useCallback(
+        (callback: () => void) => {
+            return store.subscribe(() => {
+                hasUpdate.current = true
+                callback()
+            })
+        },
+        [store]
+    )
+
+    const getSnapshot = useCallback((): S => {
+        const state = store.getState()
+
+        // Invalidate cache when store reference changes
+        if (store !== lastStore.current) {
+            lastStore.current = store
+            lastResult.current = undefined
+            hasUpdate.current = true
+        }
+
+        if (selector) {
+            const next = selector(state)
+            if (Object.is(next, lastResult.current)) return lastResult.current as S
+            if (
+                typeof next === 'object' &&
+                next !== null &&
+                lastResult.current !== undefined &&
+                shallowEqual(next, lastResult.current)
+            ) {
+                return lastResult.current as S
+            }
+            lastResult.current = next
+            return next
+        }
+
+        // No selector: return shallow copy when store updated
+        if (hasUpdate.current || lastResult.current === undefined) {
+            hasUpdate.current = false
+            lastResult.current = { ...state } as S  // ✅ just cache state, don't merge actions here
+        }
+        return lastResult.current as S
+    }, [store, selector])
+
+    const result = useSyncExternalStore(subscribe, getSnapshot, getSnapshot)
+
+    // Handle selector and no-selector cases separately
+    if (selector) {
+        return result as UseStoreResult<D, S>
+    }
+
+    // No selector — merge actions at return time only, not inside getSnapshot
+    return Object.assign({}, result as object, store.actions) as UseStoreResult<D, S>
+}