@plasius/react-state 1.0.12 → 1.1.0

package/dist/index.cjs

@@ -36,9 +36,28 @@ var __noop = null;
 // src/create-scoped-store.tsx
 var import_react = require("react");
 
+// src/freeze.ts
+function deepFreeze(obj, seen = /* @__PURE__ */ new WeakSet()) {
+  if (obj === null || typeof obj !== "object") return obj;
+  const o = obj;
+  if (seen.has(o)) return obj;
+  seen.add(o);
+  for (const key of Object.getOwnPropertyNames(o)) {
+    const val = o[key];
+    if (val && typeof val === "object") deepFreeze(val, seen);
+  }
+  for (const sym of Object.getOwnPropertySymbols(o)) {
+    const val = o[sym];
+    if (val && typeof val === "object") deepFreeze(val, seen);
+  }
+  return Object.freeze(obj);
+}
+
 // src/store.ts
+var import_meta = {};
+var DEV = typeof import_meta !== "undefined" ? import_meta.env?.DEV : process.env.NODE_ENV !== "production";
 function createStore(reducer, initialState) {
-  let state = initialState;
+  let state = DEV ? deepFreeze(initialState) : initialState;
   const listeners = /* @__PURE__ */ new Set();
   const keyListeners = /* @__PURE__ */ new Map();
   const selectorListeners = /* @__PURE__ */ new Set();
@@ -46,6 +65,7 @@ function createStore(reducer, initialState) {
   const dispatch = (action) => {
     const prevState = state;
     const nextState = reducer(state, action);
+    if (DEV) deepFreeze(nextState);
     if (Object.is(prevState, nextState)) {
       state = nextState;
       return;
@@ -102,6 +122,23 @@ function createStore(reducer, initialState) {
 
 // src/create-scoped-store.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
+var _queue = /* @__PURE__ */ new Set();
+var _queued = false;
+var _schedule = typeof queueMicrotask === "function" ? queueMicrotask : (fn) => Promise.resolve().then(fn);
+function enqueue(fn) {
+  _queue.add(fn);
+  if (_queued) return;
+  _queued = true;
+  _schedule(() => {
+    _queued = false;
+    const fns = Array.from(_queue);
+    _queue.clear();
+    for (const f of fns) f();
+  });
+}
+function makeBatchedSubscribe(subscribe) {
+  return (onChange) => subscribe(() => enqueue(onChange));
+}
 function shallowEqual(a, b) {
   if (Object.is(a, b)) return true;
   if (typeof a !== "object" || a === null || typeof b !== "object" || b === null)
@@ -117,23 +154,35 @@ function shallowEqual(a, b) {
 }
 function createScopedStoreContext(reducer, initialState) {
   const Context = (0, import_react.createContext)(null);
-  const store = createStore(reducer, initialState);
-  const Provider = ({ children }) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Context.Provider, { value: store, children });
+  const Provider = ({
+    children,
+    initialState: override
+  }) => {
+    const storeRef = (0, import_react.useRef)(null);
+    if (!storeRef.current) {
+      storeRef.current = createStore(reducer, override ?? initialState);
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Context.Provider, { value: storeRef.current, children });
+  };
   const useStore2 = () => {
     const ctx = (0, import_react.useContext)(Context);
     if (!ctx) throw new Error("Store not found in context");
-    return (0, import_react.useSyncExternalStore)(ctx.subscribe, ctx.getState, ctx.getState);
+    return (0, import_react.useSyncExternalStore)(
+      makeBatchedSubscribe(ctx.subscribe),
+      ctx.getState,
+      ctx.getState
+    );
   };
   const useDispatch2 = () => {
     const ctx = (0, import_react.useContext)(Context);
     if (!ctx) throw new Error("Dispatch not found in context");
-    return (action) => ctx.dispatch(action);
+    return (0, import_react.useCallback)((action) => ctx.dispatch(action), [ctx]);
   };
   function useSelector(selector, isEqual = shallowEqual) {
     const ctx = (0, import_react.useContext)(Context);
     if (!ctx) throw new Error("Store not found in context");
     const state = (0, import_react.useSyncExternalStore)(
-      ctx.subscribe,
+      makeBatchedSubscribe(ctx.subscribe),
       ctx.getState,
       ctx.getState
     );
@@ -147,7 +196,6 @@ function createScopedStoreContext(reducer, initialState) {
     return nextSelected;
   }
   return {
-    store,
     Context,
     Provider,
     useStore: useStore2,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/create-scoped-store.tsx","../src/store.ts","../src/provider.tsx","../src/metadata-store.ts"],"sourcesContent":["export * from \"./types.js\";\nexport * from \"./create-scoped-store.js\";\nexport * from \"./store.js\";\nexport * from \"./provider.js\";\nexport * from \"./metadata-store.js\";\n","export type Reducer<S, A> = (state: S, action: A) => S;\nexport type Listener = () => void;\nexport type Unsubscribe = () => void;\nexport const __noop = null;","import { createContext, useContext, useRef, useSyncExternalStore } from \"react\";\nimport type { IState, IAction, Store } from \"./store.js\";\nimport { createStore } from \"./store.js\";\n\nfunction shallowEqual(a: any, b: any) {\n  if (Object.is(a, b)) return true;\n  if (\n    typeof a !== \"object\" ||\n    a === null ||\n    typeof b !== \"object\" ||\n    b === null\n  )\n    return false;\n  const ak = Object.keys(a),\n    bk = Object.keys(b);\n  if (ak.length !== bk.length) return false;\n  for (let i = 0; i < ak.length; i++) {\n    const k = ak[i] as string;\n    if (\n      !Object.prototype.hasOwnProperty.call(b, k) ||\n      !Object.is((a as any)[k], (b as any)[k])\n    )\n      return false;\n  }\n  return true;\n}\n\nexport function createScopedStoreContext<S extends IState, A extends IAction>(\n  reducer: (state: S, action: A) => S,\n  initialState: S\n) {\n  const Context = createContext<Store<S, A> | null>(null);\n\n  const store = createStore(reducer, initialState);\n\n  const Provider = ({ children }: { children: React.ReactNode }) => (\n    <Context.Provider value={store}>{children}</Context.Provider>\n  );\n\n  const useStore = (): S => {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Store not found in context\");\n    return useSyncExternalStore(ctx.subscribe, ctx.getState, ctx.getState);\n  };\n\n  const useDispatch = (): ((action: A) => void) => {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Dispatch not found in context\");\n    return (action: A) => ctx.dispatch(action);\n  };\n\n  function useSelector<T>(\n    selector: (state: S) => T,\n    isEqual: (a: T, b: T) => boolean = shallowEqual\n  ): T {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Store not found in context\");\n\n    // Subscribe to the raw state snapshot (stable reference until a dispatch)\n    const state = useSyncExternalStore(\n      ctx.subscribe,\n      ctx.getState,\n      ctx.getState\n    );\n\n    // Cache the selected slice per state snapshot to avoid returning fresh objects during render\n    const lastRef = useRef<{ state: S; selected: T } | null>(null);\n    const last = lastRef.current;\n    const nextSelected = selector(state);\n\n    if (last && last.state === state && isEqual(last.selected, nextSelected)) {\n      return last.selected; // return cached reference to satisfy getSnapshot caching\n    }\n\n    lastRef.current = { state, selected: nextSelected };\n    return nextSelected;\n  }\n\n  return {\n    store,\n    Context,\n    Provider,\n    useStore,\n    useDispatch,\n    useSelector,\n  };\n}\n","import type { Reducer, Listener } from \"./types.js\";\n\n// Allow narrower parameter types for callbacks without fighting variance\ntype BivariantListener<T> = {\n  bivarianceHack(value: T): void;\n}[\"bivarianceHack\"];\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface IState {}\nexport interface IAction {\n  type: string;\n}\n\nexport interface Store<S extends IState, A extends IAction> {\n  getState(): S;\n  dispatch(action: A): void;\n  /**\n   * Subscribe to all state changes.\n   */\n  subscribe(listener: Listener): () => void;\n  /**\n   * Subscribe to changes of a specific key in the state.\n   */\n  subscribeToKey<K extends keyof S>(\n    key: K,\n    listener: (value: S[K]) => void\n  ): () => void;\n  /**\n   * Subscribe to changes in a selected value from the state.\n   */\n  subscribeWithSelector<T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void\n  ): () => void;\n}\n\nexport function createStore<S extends IState, A extends IAction>(\n  reducer: Reducer<S, A>,\n  initialState: S\n): Store<S, A> {\n  let state = initialState;\n  const listeners = new Set<Listener>();\n  const keyListeners = new Map<keyof S, Set<BivariantListener<S[keyof S]>>>();\n\n  interface SelectorEntry<T> {\n    selector: (state: S) => T;\n    listener: BivariantListener<T>;\n    lastValue: T;\n  }\n  const selectorListeners = new Set<SelectorEntry<unknown>>();\n\n  const getState = () => state;\n\n  const dispatch = (action: A) => {\n    const prevState = state;\n    const nextState = reducer(state, action);\n\n    // Distinct-until-changed: if the reducer returns the same reference,\n    // skip all notifications (prevents unnecessary re-renders).\n    if (Object.is(prevState, nextState)) {\n      state = nextState; // keep any identity guarantees from reducer\n      return;\n    }\n\n    state = nextState;\n\n    // Notify global listeners (iterate over a snapshot so unsubscribe during\n    // notify does not skip the next listener)\n    for (const listener of [...listeners]) listener();\n\n    // Notify key listeners only when that key actually changed (Object.is)\n    for (const [key, set] of keyListeners.entries()) {\n      if (!Object.is(prevState[key], state[key])) {\n        for (const listener of [...set]) listener(state[key]);\n      }\n    }\n\n    // Notify selector listeners only when selected value changed (Object.is)\n    selectorListeners.forEach((entry) => {\n      const nextValue = (entry.selector as (s: S) => unknown)(state);\n      if (!Object.is(entry.lastValue, nextValue)) {\n        entry.lastValue = nextValue as unknown;\n        (entry.listener as (v: unknown) => void)(nextValue);\n      }\n    });\n  };\n\n  const subscribe = (listener: Listener) => {\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  };\n\n  const subscribeToKey = <K extends keyof S>(\n    key: K,\n    listener: (value: S[K]) => void\n  ) => {\n    const set =\n      keyListeners.get(key) ?? new Set<BivariantListener<S[keyof S]>>();\n    set.add(listener as unknown as BivariantListener<S[keyof S]>);\n    keyListeners.set(key, set);\n    return () => {\n      set.delete(listener as unknown as BivariantListener<S[keyof S]>);\n      if (set.size === 0) keyListeners.delete(key);\n    };\n  };\n\n  const subscribeWithSelector = <T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void\n  ) => {\n    const entry: SelectorEntry<T> = {\n      selector,\n      listener: listener as BivariantListener<T>,\n      lastValue: selector(state),\n    };\n    selectorListeners.add(entry as unknown as SelectorEntry<unknown>);\n    return () => {\n      selectorListeners.delete(entry as unknown as SelectorEntry<unknown>);\n    };\n  };\n\n  return {\n    getState,\n    dispatch,\n    subscribe,\n    subscribeToKey,\n    subscribeWithSelector,\n  };\n}\n","import React, { createContext, useContext, useEffect, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { Store, IState, IAction } from \"./store.js\";\n\nconst StoreContext = createContext<Store<IState, IAction> | undefined>(undefined);\n\nfunction useStoreInstance<S extends IState, A extends IAction>(): Store<S, A> {\n  const store = useContext(StoreContext) as Store<S, A> | undefined;\n  if (!store) {\n    throw new Error(\n      \"StoreProvider is missing in the React tree. Wrap your app with <StoreProvider store={...}>.\"\n    );\n  }\n  return store;\n}\n\ninterface StoreProviderProps<S extends IState, A extends IAction> {\n  store: Store<S, A>;\n  children: ReactNode;\n}\n\nexport function StoreProvider<S extends IState, A extends IAction>({\n  store,\n  children,\n}: StoreProviderProps<S, A>) {\n  return (\n    <StoreContext.Provider value={store as unknown as Store<IState, IAction>}>\n      {children}\n    </StoreContext.Provider>\n  );\n}\n\nexport function useStore<S extends IState>(): S {\n  const store = useStoreInstance<S, IAction>();\n  const [state, setState] = useState<S>(() => store.getState());\n\n  useEffect(() => {\n    // Subscribe to store changes and update local state.\n    const unsubscribe = store.subscribe(() => {\n      setState(store.getState());\n    });\n    return unsubscribe;\n  }, [store]);\n\n  return state;\n}\n\nexport function useDispatch<A extends IAction>(): Store<IState, A>[\"dispatch\"] {\n  const store = useStoreInstance<IState, A>();\n  // Return the store's dispatch directly; consumers can call dispatch(action).\n  return store.dispatch as Store<IState, A>[\"dispatch\"];\n}\n","// metadata-store.ts\nexport class MetadataStore<T extends object, Meta extends object> {\n  private readonly symbol: symbol;\n\n  constructor(description: string) {\n    this.symbol = Symbol(description);\n  }\n\n  set(target: T, meta: Meta) {\n    Object.defineProperty(target, this.symbol as PropertyKey, {\n      value: meta,\n      writable: false,\n      enumerable: false,\n    });\n  }\n\n  get(target: T): Meta | undefined {\n    return (target as Record<PropertyKey, Meta>)[this.symbol as PropertyKey];\n  }\n\n  has(target: T): boolean {\n    return (this.symbol as PropertyKey) in target;\n  }\n}\n"],"mappings":"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","names":["useStore","useDispatch","import_react","import_jsx_runtime"]}
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/create-scoped-store.tsx","../src/freeze.ts","../src/store.ts","../src/provider.tsx","../src/metadata-store.ts"],"sourcesContent":["export * from \"./types.js\";\nexport * from \"./create-scoped-store.js\";\nexport * from \"./store.js\";\nexport * from \"./provider.js\";\nexport * from \"./metadata-store.js\";\n","export type Reducer<S, A> = (state: S, action: A) => S;\nexport type Listener = () => void;\nexport type Unsubscribe = () => void;\nexport const __noop = null;","import { createContext, useContext, useRef, useSyncExternalStore, useCallback } from \"react\";\nimport type { IState, IAction, Store } from \"./store.js\";\nimport { createStore } from \"./store.js\";\n\n// Local microtask-based batching (no react-dom dependency)\nconst _queue = new Set<() => void>();\nlet _queued = false;\nconst _schedule = typeof queueMicrotask === \"function\"\n  ? queueMicrotask\n  : (fn: () => void) => Promise.resolve().then(fn);\n\nfunction enqueue(fn: () => void) {\n  _queue.add(fn);\n  if (_queued) return;\n  _queued = true;\n  _schedule(() => {\n    _queued = false;\n    const fns = Array.from(_queue);\n    _queue.clear();\n    for (const f of fns) f();\n  });\n}\n\nfunction makeBatchedSubscribe(subscribe: (l: () => void) => () => void) {\n  return (onChange: () => void) => subscribe(() => enqueue(onChange));\n}\n\nfunction shallowEqual(a: any, b: any) {\n  if (Object.is(a, b)) return true;\n  if (\n    typeof a !== \"object\" ||\n    a === null ||\n    typeof b !== \"object\" ||\n    b === null\n  )\n    return false;\n  const ak = Object.keys(a),\n    bk = Object.keys(b);\n  if (ak.length !== bk.length) return false;\n  for (let i = 0; i < ak.length; i++) {\n    const k = ak[i] as string;\n    if (\n      !Object.prototype.hasOwnProperty.call(b, k) ||\n      !Object.is((a as any)[k], (b as any)[k])\n    )\n      return false;\n  }\n  return true;\n}\n\nexport function createScopedStoreContext<S extends IState, A extends IAction>(\n  reducer: (state: S, action: A) => S,\n  initialState: S\n) {\n  const Context = createContext<Store<S, A> | null>(null);\n\n  // Each Provider instance gets its own store.\n  const Provider = ({\n    children,\n    initialState: override,\n  }: {\n    children: React.ReactNode;\n    initialState?: S;\n  }) => {\n    const storeRef = useRef<Store<S, A> | null>(null);\n    if (!storeRef.current) {\n      storeRef.current = createStore(reducer, override ?? initialState);\n    }\n    return <Context.Provider value={storeRef.current}>{children}</Context.Provider>;\n  };\n\n  const useStore = (): S => {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Store not found in context\");\n    return useSyncExternalStore(\n      makeBatchedSubscribe(ctx.subscribe),\n      ctx.getState,\n      ctx.getState\n    );\n  };\n\n  const useDispatch = (): ((action: A) => void) => {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Dispatch not found in context\");\n    return useCallback((action: A) => ctx.dispatch(action), [ctx]);\n  };\n\n  function useSelector<T>(\n    selector: (state: S) => T,\n    isEqual: (a: T, b: T) => boolean = shallowEqual\n  ): T {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Store not found in context\");\n\n    // Subscribe to the raw state snapshot (stable reference until a dispatch)\n    const state = useSyncExternalStore(\n      makeBatchedSubscribe(ctx.subscribe),\n      ctx.getState,\n      ctx.getState\n    );\n\n    // Cache the selected slice per state snapshot to avoid returning fresh objects during render\n    const lastRef = useRef<{ state: S; selected: T } | null>(null);\n    const last = lastRef.current;\n    const nextSelected = selector(state);\n\n    if (last && last.state === state && isEqual(last.selected, nextSelected)) {\n      return last.selected; // return cached reference to satisfy getSnapshot caching\n    }\n\n    lastRef.current = { state, selected: nextSelected };\n    return nextSelected;\n  }\n\n  return {\n    Context,\n    Provider,\n    useStore,\n    useDispatch,\n    useSelector,\n  };\n}\n","// freeze.ts\nexport function deepFreeze<T>(obj: T, seen = new WeakSet<object>()): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const o = obj as unknown as object;\n  if (seen.has(o)) return obj;\n  seen.add(o);\n\n  // Freeze children first\n  for (const key of Object.getOwnPropertyNames(o)) {\n    // @ts-expect-error index access\n    const val = (o as any)[key];\n    if (val && typeof val === \"object\") deepFreeze(val, seen);\n  }\n  // Also handle symbols (rare but safe)\n  for (const sym of Object.getOwnPropertySymbols(o)) {\n    // @ts-expect-error index access\n    const val = (o as any)[sym];\n    if (val && typeof val === \"object\") deepFreeze(val, seen);\n  }\n\n  return Object.freeze(obj);\n}\n","import type { Reducer, Listener } from \"./types.js\";\nimport { deepFreeze } from \"./freeze.js\";\n\nconst DEV =\n  typeof import.meta !== \"undefined\"\n    ? (import.meta as unknown as { env?: { DEV?: boolean } }).env?.DEV\n    : process.env.NODE_ENV !== \"production\";\n\n// Allow narrower parameter types for callbacks without fighting variance\ntype BivariantListener<T> = {\n  bivarianceHack(value: T): void;\n}[\"bivarianceHack\"];\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface IState {}\nexport interface IAction {\n  type: string;\n}\n\nexport interface Store<S extends IState, A extends IAction> {\n  getState(): S;\n  dispatch(action: A): void;\n  /**\n   * Subscribe to all state changes.\n   */\n  subscribe(listener: Listener): () => void;\n  /**\n   * Subscribe to changes of a specific key in the state.\n   */\n  subscribeToKey<K extends keyof S>(\n    key: K,\n    listener: (value: S[K]) => void\n  ): () => void;\n  /**\n   * Subscribe to changes in a selected value from the state.\n   */\n  subscribeWithSelector<T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void\n  ): () => void;\n}\n\nexport function createStore<S extends IState, A extends IAction>(\n  reducer: Reducer<S, A>,\n  initialState: S\n): Store<S, A> {\n  let state: S = DEV ? deepFreeze(initialState) : initialState;\n  const listeners = new Set<Listener>();\n  const keyListeners = new Map<keyof S, Set<BivariantListener<S[keyof S]>>>();\n\n  interface SelectorEntry<T> {\n    selector: (state: S) => T;\n    listener: BivariantListener<T>;\n    lastValue: T;\n  }\n  const selectorListeners = new Set<SelectorEntry<unknown>>();\n\n  const getState = () => state;\n\n  const dispatch = (action: A) => {\n    const prevState = state;\n    const nextState = reducer(state, action);\n    \n    if (DEV) deepFreeze(nextState);\n    \n    // Distinct-until-changed: if the reducer returns the same reference,\n    // skip all notifications (prevents unnecessary re-renders).\n    if (Object.is(prevState, nextState)) {\n      state = nextState; // keep any identity guarantees from reducer\n      return;\n    }\n\n    state = nextState;\n\n    // Notify global listeners (iterate over a snapshot so unsubscribe during\n    // notify does not skip the next listener)\n    for (const listener of [...listeners]) listener();\n\n    // Notify key listeners only when that key actually changed (Object.is)\n    for (const [key, set] of keyListeners.entries()) {\n      if (!Object.is(prevState[key], state[key])) {\n        for (const listener of [...set]) listener(state[key]);\n      }\n    }\n\n    // Notify selector listeners only when selected value changed (Object.is)\n    selectorListeners.forEach((entry) => {\n      const nextValue = (entry.selector as (s: S) => unknown)(state);\n      if (!Object.is(entry.lastValue, nextValue)) {\n        entry.lastValue = nextValue as unknown;\n        (entry.listener as (v: unknown) => void)(nextValue);\n      }\n    });\n  };\n\n  const subscribe = (listener: Listener) => {\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  };\n\n  const subscribeToKey = <K extends keyof S>(\n    key: K,\n    listener: (value: S[K]) => void\n  ) => {\n    const set =\n      keyListeners.get(key) ?? new Set<BivariantListener<S[keyof S]>>();\n    set.add(listener as unknown as BivariantListener<S[keyof S]>);\n    keyListeners.set(key, set);\n    return () => {\n      set.delete(listener as unknown as BivariantListener<S[keyof S]>);\n      if (set.size === 0) keyListeners.delete(key);\n    };\n  };\n\n  const subscribeWithSelector = <T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void\n  ) => {\n    const entry: SelectorEntry<T> = {\n      selector,\n      listener: listener as BivariantListener<T>,\n      lastValue: selector(state),\n    };\n    selectorListeners.add(entry as unknown as SelectorEntry<unknown>);\n    return () => {\n      selectorListeners.delete(entry as unknown as SelectorEntry<unknown>);\n    };\n  };\n\n  return {\n    getState,\n    dispatch,\n    subscribe,\n    subscribeToKey,\n    subscribeWithSelector,\n  };\n}\n","import React, { createContext, useContext, useEffect, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { Store, IState, IAction } from \"./store.js\";\n\nconst StoreContext = createContext<Store<IState, IAction> | undefined>(undefined);\n\nfunction useStoreInstance<S extends IState, A extends IAction>(): Store<S, A> {\n  const store = useContext(StoreContext) as Store<S, A> | undefined;\n  if (!store) {\n    throw new Error(\n      \"StoreProvider is missing in the React tree. Wrap your app with <StoreProvider store={...}>.\"\n    );\n  }\n  return store;\n}\n\ninterface StoreProviderProps<S extends IState, A extends IAction> {\n  store: Store<S, A>;\n  children: ReactNode;\n}\n\nexport function StoreProvider<S extends IState, A extends IAction>({\n  store,\n  children,\n}: StoreProviderProps<S, A>) {\n  return (\n    <StoreContext.Provider value={store as unknown as Store<IState, IAction>}>\n      {children}\n    </StoreContext.Provider>\n  );\n}\n\nexport function useStore<S extends IState>(): S {\n  const store = useStoreInstance<S, IAction>();\n  const [state, setState] = useState<S>(() => store.getState());\n\n  useEffect(() => {\n    // Subscribe to store changes and update local state.\n    const unsubscribe = store.subscribe(() => {\n      setState(store.getState());\n    });\n    return unsubscribe;\n  }, [store]);\n\n  return state;\n}\n\nexport function useDispatch<A extends IAction>(): Store<IState, A>[\"dispatch\"] {\n  const store = useStoreInstance<IState, A>();\n  // Return the store's dispatch directly; consumers can call dispatch(action).\n  return store.dispatch as Store<IState, A>[\"dispatch\"];\n}\n","// metadata-store.ts\nexport class MetadataStore<T extends object, Meta extends object> {\n  private readonly symbol: symbol;\n\n  constructor(description: string) {\n    this.symbol = Symbol(description);\n  }\n\n  set(target: T, meta: Meta) {\n    Object.defineProperty(target, this.symbol as PropertyKey, {\n      value: meta,\n      writable: false,\n      enumerable: false,\n    });\n  }\n\n  get(target: T): Meta | undefined {\n    return (target as Record<PropertyKey, Meta>)[this.symbol as PropertyKey];\n  }\n\n  has(target: T): boolean {\n    return (this.symbol as PropertyKey) in target;\n  }\n}\n"],"mappings":"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","names":["useStore","useDispatch","import_react","import_jsx_runtime"]}

package/dist/index.d.cts

@@ -31,10 +31,10 @@ interface Store<S extends IState, A extends IAction> {
 declare function createStore<S extends IState, A extends IAction>(reducer: Reducer<S, A>, initialState: S): Store<S, A>;
 
 declare function createScopedStoreContext<S extends IState, A extends IAction>(reducer: (state: S, action: A) => S, initialState: S): {
-    store: Store<S, A>;
     Context: react.Context<Store<S, A> | null>;
-    Provider: ({ children }: {
+    Provider: ({ children, initialState: override, }: {
         children: React.ReactNode;
+        initialState?: S;
     }) => react_jsx_runtime.JSX.Element;
     useStore: () => S;
     useDispatch: () => ((action: A) => void);

package/dist/index.d.ts

@@ -31,10 +31,10 @@ interface Store<S extends IState, A extends IAction> {
 declare function createStore<S extends IState, A extends IAction>(reducer: Reducer<S, A>, initialState: S): Store<S, A>;
 
 declare function createScopedStoreContext<S extends IState, A extends IAction>(reducer: (state: S, action: A) => S, initialState: S): {
-    store: Store<S, A>;
     Context: react.Context<Store<S, A> | null>;
-    Provider: ({ children }: {
+    Provider: ({ children, initialState: override, }: {
         children: React.ReactNode;
+        initialState?: S;
     }) => react_jsx_runtime.JSX.Element;
     useStore: () => S;
     useDispatch: () => ((action: A) => void);

package/dist/index.js

@@ -2,11 +2,29 @@
 var __noop = null;
 
 // src/create-scoped-store.tsx
-import { createContext, useContext, useRef, useSyncExternalStore } from "react";
+import { createContext, useContext, useRef, useSyncExternalStore, useCallback } from "react";
+
+// src/freeze.ts
+function deepFreeze(obj, seen = /* @__PURE__ */ new WeakSet()) {
+  if (obj === null || typeof obj !== "object") return obj;
+  const o = obj;
+  if (seen.has(o)) return obj;
+  seen.add(o);
+  for (const key of Object.getOwnPropertyNames(o)) {
+    const val = o[key];
+    if (val && typeof val === "object") deepFreeze(val, seen);
+  }
+  for (const sym of Object.getOwnPropertySymbols(o)) {
+    const val = o[sym];
+    if (val && typeof val === "object") deepFreeze(val, seen);
+  }
+  return Object.freeze(obj);
+}
 
 // src/store.ts
+var DEV = typeof import.meta !== "undefined" ? import.meta.env?.DEV : process.env.NODE_ENV !== "production";
 function createStore(reducer, initialState) {
-  let state = initialState;
+  let state = DEV ? deepFreeze(initialState) : initialState;
   const listeners = /* @__PURE__ */ new Set();
   const keyListeners = /* @__PURE__ */ new Map();
   const selectorListeners = /* @__PURE__ */ new Set();
@@ -14,6 +32,7 @@ function createStore(reducer, initialState) {
   const dispatch = (action) => {
     const prevState = state;
     const nextState = reducer(state, action);
+    if (DEV) deepFreeze(nextState);
     if (Object.is(prevState, nextState)) {
       state = nextState;
       return;
@@ -70,6 +89,23 @@ function createStore(reducer, initialState) {
 
 // src/create-scoped-store.tsx
 import { jsx } from "react/jsx-runtime";
+var _queue = /* @__PURE__ */ new Set();
+var _queued = false;
+var _schedule = typeof queueMicrotask === "function" ? queueMicrotask : (fn) => Promise.resolve().then(fn);
+function enqueue(fn) {
+  _queue.add(fn);
+  if (_queued) return;
+  _queued = true;
+  _schedule(() => {
+    _queued = false;
+    const fns = Array.from(_queue);
+    _queue.clear();
+    for (const f of fns) f();
+  });
+}
+function makeBatchedSubscribe(subscribe) {
+  return (onChange) => subscribe(() => enqueue(onChange));
+}
 function shallowEqual(a, b) {
   if (Object.is(a, b)) return true;
   if (typeof a !== "object" || a === null || typeof b !== "object" || b === null)
@@ -85,23 +121,35 @@ function shallowEqual(a, b) {
 }
 function createScopedStoreContext(reducer, initialState) {
   const Context = createContext(null);
-  const store = createStore(reducer, initialState);
-  const Provider = ({ children }) => /* @__PURE__ */ jsx(Context.Provider, { value: store, children });
+  const Provider = ({
+    children,
+    initialState: override
+  }) => {
+    const storeRef = useRef(null);
+    if (!storeRef.current) {
+      storeRef.current = createStore(reducer, override ?? initialState);
+    }
+    return /* @__PURE__ */ jsx(Context.Provider, { value: storeRef.current, children });
+  };
   const useStore2 = () => {
     const ctx = useContext(Context);
     if (!ctx) throw new Error("Store not found in context");
-    return useSyncExternalStore(ctx.subscribe, ctx.getState, ctx.getState);
+    return useSyncExternalStore(
+      makeBatchedSubscribe(ctx.subscribe),
+      ctx.getState,
+      ctx.getState
+    );
   };
   const useDispatch2 = () => {
     const ctx = useContext(Context);
     if (!ctx) throw new Error("Dispatch not found in context");
-    return (action) => ctx.dispatch(action);
+    return useCallback((action) => ctx.dispatch(action), [ctx]);
   };
   function useSelector(selector, isEqual = shallowEqual) {
     const ctx = useContext(Context);
     if (!ctx) throw new Error("Store not found in context");
     const state = useSyncExternalStore(
-      ctx.subscribe,
+      makeBatchedSubscribe(ctx.subscribe),
       ctx.getState,
       ctx.getState
     );
@@ -115,7 +163,6 @@ function createScopedStoreContext(reducer, initialState) {
     return nextSelected;
   }
   return {
-    store,
     Context,
     Provider,
     useStore: useStore2,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/create-scoped-store.tsx","../src/store.ts","../src/provider.tsx","../src/metadata-store.ts"],"sourcesContent":["export type Reducer<S, A> = (state: S, action: A) => S;\nexport type Listener = () => void;\nexport type Unsubscribe = () => void;\nexport const __noop = null;","import { createContext, useContext, useRef, useSyncExternalStore } from \"react\";\nimport type { IState, IAction, Store } from \"./store.js\";\nimport { createStore } from \"./store.js\";\n\nfunction shallowEqual(a: any, b: any) {\n  if (Object.is(a, b)) return true;\n  if (\n    typeof a !== \"object\" ||\n    a === null ||\n    typeof b !== \"object\" ||\n    b === null\n  )\n    return false;\n  const ak = Object.keys(a),\n    bk = Object.keys(b);\n  if (ak.length !== bk.length) return false;\n  for (let i = 0; i < ak.length; i++) {\n    const k = ak[i] as string;\n    if (\n      !Object.prototype.hasOwnProperty.call(b, k) ||\n      !Object.is((a as any)[k], (b as any)[k])\n    )\n      return false;\n  }\n  return true;\n}\n\nexport function createScopedStoreContext<S extends IState, A extends IAction>(\n  reducer: (state: S, action: A) => S,\n  initialState: S\n) {\n  const Context = createContext<Store<S, A> | null>(null);\n\n  const store = createStore(reducer, initialState);\n\n  const Provider = ({ children }: { children: React.ReactNode }) => (\n    <Context.Provider value={store}>{children}</Context.Provider>\n  );\n\n  const useStore = (): S => {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Store not found in context\");\n    return useSyncExternalStore(ctx.subscribe, ctx.getState, ctx.getState);\n  };\n\n  const useDispatch = (): ((action: A) => void) => {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Dispatch not found in context\");\n    return (action: A) => ctx.dispatch(action);\n  };\n\n  function useSelector<T>(\n    selector: (state: S) => T,\n    isEqual: (a: T, b: T) => boolean = shallowEqual\n  ): T {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Store not found in context\");\n\n    // Subscribe to the raw state snapshot (stable reference until a dispatch)\n    const state = useSyncExternalStore(\n      ctx.subscribe,\n      ctx.getState,\n      ctx.getState\n    );\n\n    // Cache the selected slice per state snapshot to avoid returning fresh objects during render\n    const lastRef = useRef<{ state: S; selected: T } | null>(null);\n    const last = lastRef.current;\n    const nextSelected = selector(state);\n\n    if (last && last.state === state && isEqual(last.selected, nextSelected)) {\n      return last.selected; // return cached reference to satisfy getSnapshot caching\n    }\n\n    lastRef.current = { state, selected: nextSelected };\n    return nextSelected;\n  }\n\n  return {\n    store,\n    Context,\n    Provider,\n    useStore,\n    useDispatch,\n    useSelector,\n  };\n}\n","import type { Reducer, Listener } from \"./types.js\";\n\n// Allow narrower parameter types for callbacks without fighting variance\ntype BivariantListener<T> = {\n  bivarianceHack(value: T): void;\n}[\"bivarianceHack\"];\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface IState {}\nexport interface IAction {\n  type: string;\n}\n\nexport interface Store<S extends IState, A extends IAction> {\n  getState(): S;\n  dispatch(action: A): void;\n  /**\n   * Subscribe to all state changes.\n   */\n  subscribe(listener: Listener): () => void;\n  /**\n   * Subscribe to changes of a specific key in the state.\n   */\n  subscribeToKey<K extends keyof S>(\n    key: K,\n    listener: (value: S[K]) => void\n  ): () => void;\n  /**\n   * Subscribe to changes in a selected value from the state.\n   */\n  subscribeWithSelector<T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void\n  ): () => void;\n}\n\nexport function createStore<S extends IState, A extends IAction>(\n  reducer: Reducer<S, A>,\n  initialState: S\n): Store<S, A> {\n  let state = initialState;\n  const listeners = new Set<Listener>();\n  const keyListeners = new Map<keyof S, Set<BivariantListener<S[keyof S]>>>();\n\n  interface SelectorEntry<T> {\n    selector: (state: S) => T;\n    listener: BivariantListener<T>;\n    lastValue: T;\n  }\n  const selectorListeners = new Set<SelectorEntry<unknown>>();\n\n  const getState = () => state;\n\n  const dispatch = (action: A) => {\n    const prevState = state;\n    const nextState = reducer(state, action);\n\n    // Distinct-until-changed: if the reducer returns the same reference,\n    // skip all notifications (prevents unnecessary re-renders).\n    if (Object.is(prevState, nextState)) {\n      state = nextState; // keep any identity guarantees from reducer\n      return;\n    }\n\n    state = nextState;\n\n    // Notify global listeners (iterate over a snapshot so unsubscribe during\n    // notify does not skip the next listener)\n    for (const listener of [...listeners]) listener();\n\n    // Notify key listeners only when that key actually changed (Object.is)\n    for (const [key, set] of keyListeners.entries()) {\n      if (!Object.is(prevState[key], state[key])) {\n        for (const listener of [...set]) listener(state[key]);\n      }\n    }\n\n    // Notify selector listeners only when selected value changed (Object.is)\n    selectorListeners.forEach((entry) => {\n      const nextValue = (entry.selector as (s: S) => unknown)(state);\n      if (!Object.is(entry.lastValue, nextValue)) {\n        entry.lastValue = nextValue as unknown;\n        (entry.listener as (v: unknown) => void)(nextValue);\n      }\n    });\n  };\n\n  const subscribe = (listener: Listener) => {\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  };\n\n  const subscribeToKey = <K extends keyof S>(\n    key: K,\n    listener: (value: S[K]) => void\n  ) => {\n    const set =\n      keyListeners.get(key) ?? new Set<BivariantListener<S[keyof S]>>();\n    set.add(listener as unknown as BivariantListener<S[keyof S]>);\n    keyListeners.set(key, set);\n    return () => {\n      set.delete(listener as unknown as BivariantListener<S[keyof S]>);\n      if (set.size === 0) keyListeners.delete(key);\n    };\n  };\n\n  const subscribeWithSelector = <T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void\n  ) => {\n    const entry: SelectorEntry<T> = {\n      selector,\n      listener: listener as BivariantListener<T>,\n      lastValue: selector(state),\n    };\n    selectorListeners.add(entry as unknown as SelectorEntry<unknown>);\n    return () => {\n      selectorListeners.delete(entry as unknown as SelectorEntry<unknown>);\n    };\n  };\n\n  return {\n    getState,\n    dispatch,\n    subscribe,\n    subscribeToKey,\n    subscribeWithSelector,\n  };\n}\n","import React, { createContext, useContext, useEffect, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { Store, IState, IAction } from \"./store.js\";\n\nconst StoreContext = createContext<Store<IState, IAction> | undefined>(undefined);\n\nfunction useStoreInstance<S extends IState, A extends IAction>(): Store<S, A> {\n  const store = useContext(StoreContext) as Store<S, A> | undefined;\n  if (!store) {\n    throw new Error(\n      \"StoreProvider is missing in the React tree. Wrap your app with <StoreProvider store={...}>.\"\n    );\n  }\n  return store;\n}\n\ninterface StoreProviderProps<S extends IState, A extends IAction> {\n  store: Store<S, A>;\n  children: ReactNode;\n}\n\nexport function StoreProvider<S extends IState, A extends IAction>({\n  store,\n  children,\n}: StoreProviderProps<S, A>) {\n  return (\n    <StoreContext.Provider value={store as unknown as Store<IState, IAction>}>\n      {children}\n    </StoreContext.Provider>\n  );\n}\n\nexport function useStore<S extends IState>(): S {\n  const store = useStoreInstance<S, IAction>();\n  const [state, setState] = useState<S>(() => store.getState());\n\n  useEffect(() => {\n    // Subscribe to store changes and update local state.\n    const unsubscribe = store.subscribe(() => {\n      setState(store.getState());\n    });\n    return unsubscribe;\n  }, [store]);\n\n  return state;\n}\n\nexport function useDispatch<A extends IAction>(): Store<IState, A>[\"dispatch\"] {\n  const store = useStoreInstance<IState, A>();\n  // Return the store's dispatch directly; consumers can call dispatch(action).\n  return store.dispatch as Store<IState, A>[\"dispatch\"];\n}\n","// metadata-store.ts\nexport class MetadataStore<T extends object, Meta extends object> {\n  private readonly symbol: symbol;\n\n  constructor(description: string) {\n    this.symbol = Symbol(description);\n  }\n\n  set(target: T, meta: Meta) {\n    Object.defineProperty(target, this.symbol as PropertyKey, {\n      value: meta,\n      writable: false,\n      enumerable: false,\n    });\n  }\n\n  get(target: T): Meta | undefined {\n    return (target as Record<PropertyKey, Meta>)[this.symbol as PropertyKey];\n  }\n\n  has(target: T): boolean {\n    return (this.symbol as PropertyKey) in target;\n  }\n}\n"],"mappings":";AAGO,IAAM,SAAS;;;ACHtB,SAAS,eAAe,YAAY,QAAQ,4BAA4B;;;ACoCjE,SAAS,YACd,SACA,cACa;AACb,MAAI,QAAQ;AACZ,QAAM,YAAY,oBAAI,IAAc;AACpC,QAAM,eAAe,oBAAI,IAAiD;AAO1E,QAAM,oBAAoB,oBAAI,IAA4B;AAE1D,QAAM,WAAW,MAAM;AAEvB,QAAM,WAAW,CAAC,WAAc;AAC9B,UAAM,YAAY;AAClB,UAAM,YAAY,QAAQ,OAAO,MAAM;AAIvC,QAAI,OAAO,GAAG,WAAW,SAAS,GAAG;AACnC,cAAQ;AACR;AAAA,IACF;AAEA,YAAQ;AAIR,eAAW,YAAY,CAAC,GAAG,SAAS,EAAG,UAAS;AAGhD,eAAW,CAAC,KAAK,GAAG,KAAK,aAAa,QAAQ,GAAG;AAC/C,UAAI,CAAC,OAAO,GAAG,UAAU,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG;AAC1C,mBAAW,YAAY,CAAC,GAAG,GAAG,EAAG,UAAS,MAAM,GAAG,CAAC;AAAA,MACtD;AAAA,IACF;AAGA,sBAAkB,QAAQ,CAAC,UAAU;AACnC,YAAM,YAAa,MAAM,SAA+B,KAAK;AAC7D,UAAI,CAAC,OAAO,GAAG,MAAM,WAAW,SAAS,GAAG;AAC1C,cAAM,YAAY;AAClB,QAAC,MAAM,SAAkC,SAAS;AAAA,MACpD;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,YAAY,CAAC,aAAuB;AACxC,cAAU,IAAI,QAAQ;AACtB,WAAO,MAAM;AACX,gBAAU,OAAO,QAAQ;AAAA,IAC3B;AAAA,EACF;AAEA,QAAM,iBAAiB,CACrB,KACA,aACG;AACH,UAAM,MACJ,aAAa,IAAI,GAAG,KAAK,oBAAI,IAAmC;AAClE,QAAI,IAAI,QAAoD;AAC5D,iBAAa,IAAI,KAAK,GAAG;AACzB,WAAO,MAAM;AACX,UAAI,OAAO,QAAoD;AAC/D,UAAI,IAAI,SAAS,EAAG,cAAa,OAAO,GAAG;AAAA,IAC7C;AAAA,EACF;AAEA,QAAM,wBAAwB,CAC5B,UACA,aACG;AACH,UAAM,QAA0B;AAAA,MAC9B;AAAA,MACA;AAAA,MACA,WAAW,SAAS,KAAK;AAAA,IAC3B;AACA,sBAAkB,IAAI,KAA0C;AAChE,WAAO,MAAM;AACX,wBAAkB,OAAO,KAA0C;AAAA,IACrE;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;AD9FI;AAhCJ,SAAS,aAAa,GAAQ,GAAQ;AACpC,MAAI,OAAO,GAAG,GAAG,CAAC,EAAG,QAAO;AAC5B,MACE,OAAO,MAAM,YACb,MAAM,QACN,OAAO,MAAM,YACb,MAAM;AAEN,WAAO;AACT,QAAM,KAAK,OAAO,KAAK,CAAC,GACtB,KAAK,OAAO,KAAK,CAAC;AACpB,MAAI,GAAG,WAAW,GAAG,OAAQ,QAAO;AACpC,WAAS,IAAI,GAAG,IAAI,GAAG,QAAQ,KAAK;AAClC,UAAM,IAAI,GAAG,CAAC;AACd,QACE,CAAC,OAAO,UAAU,eAAe,KAAK,GAAG,CAAC,KAC1C,CAAC,OAAO,GAAI,EAAU,CAAC,GAAI,EAAU,CAAC,CAAC;AAEvC,aAAO;AAAA,EACX;AACA,SAAO;AACT;AAEO,SAAS,yBACd,SACA,cACA;AACA,QAAM,UAAU,cAAkC,IAAI;AAEtD,QAAM,QAAQ,YAAY,SAAS,YAAY;AAE/C,QAAM,WAAW,CAAC,EAAE,SAAS,MAC3B,oBAAC,QAAQ,UAAR,EAAiB,OAAO,OAAQ,UAAS;AAG5C,QAAMA,YAAW,MAAS;AACxB,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4BAA4B;AACtD,WAAO,qBAAqB,IAAI,WAAW,IAAI,UAAU,IAAI,QAAQ;AAAA,EACvE;AAEA,QAAMC,eAAc,MAA6B;AAC/C,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,CAAC,IAAK,OAAM,IAAI,MAAM,+BAA+B;AACzD,WAAO,CAAC,WAAc,IAAI,SAAS,MAAM;AAAA,EAC3C;AAEA,WAAS,YACP,UACA,UAAmC,cAChC;AACH,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4BAA4B;AAGtD,UAAM,QAAQ;AAAA,MACZ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,IACN;AAGA,UAAM,UAAU,OAAyC,IAAI;AAC7D,UAAM,OAAO,QAAQ;AACrB,UAAM,eAAe,SAAS,KAAK;AAEnC,QAAI,QAAQ,KAAK,UAAU,SAAS,QAAQ,KAAK,UAAU,YAAY,GAAG;AACxE,aAAO,KAAK;AAAA,IACd;AAEA,YAAQ,UAAU,EAAE,OAAO,UAAU,aAAa;AAClD,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAAD;AAAA,IACA,aAAAC;AAAA,IACA;AAAA,EACF;AACF;;;AEtFA,SAAgB,iBAAAC,gBAAe,cAAAC,aAAY,WAAW,gBAAgB;AA0BlE,gBAAAC,YAAA;AAtBJ,IAAM,eAAeF,eAAkD,MAAS;AAEhF,SAAS,mBAAqE;AAC5E,QAAM,QAAQC,YAAW,YAAY;AACrC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,cAAmD;AAAA,EACjE;AAAA,EACA;AACF,GAA6B;AAC3B,SACE,gBAAAC,KAAC,aAAa,UAAb,EAAsB,OAAO,OAC3B,UACH;AAEJ;AAEO,SAAS,WAAgC;AAC9C,QAAM,QAAQ,iBAA6B;AAC3C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAY,MAAM,MAAM,SAAS,CAAC;AAE5D,YAAU,MAAM;AAEd,UAAM,cAAc,MAAM,UAAU,MAAM;AACxC,eAAS,MAAM,SAAS,CAAC;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT,GAAG,CAAC,KAAK,CAAC;AAEV,SAAO;AACT;AAEO,SAAS,cAA+D;AAC7E,QAAM,QAAQ,iBAA4B;AAE1C,SAAO,MAAM;AACf;;;AClDO,IAAM,gBAAN,MAA2D;AAAA,EAC/C;AAAA,EAEjB,YAAY,aAAqB;AAC/B,SAAK,SAAS,OAAO,WAAW;AAAA,EAClC;AAAA,EAEA,IAAI,QAAW,MAAY;AACzB,WAAO,eAAe,QAAQ,KAAK,QAAuB;AAAA,MACxD,OAAO;AAAA,MACP,UAAU;AAAA,MACV,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,QAA6B;AAC/B,WAAQ,OAAqC,KAAK,MAAqB;AAAA,EACzE;AAAA,EAEA,IAAI,QAAoB;AACtB,WAAQ,KAAK,UAA0B;AAAA,EACzC;AACF;","names":["useStore","useDispatch","createContext","useContext","jsx"]}
+{"version":3,"sources":["../src/types.ts","../src/create-scoped-store.tsx","../src/freeze.ts","../src/store.ts","../src/provider.tsx","../src/metadata-store.ts"],"sourcesContent":["export type Reducer<S, A> = (state: S, action: A) => S;\nexport type Listener = () => void;\nexport type Unsubscribe = () => void;\nexport const __noop = null;","import { createContext, useContext, useRef, useSyncExternalStore, useCallback } from \"react\";\nimport type { IState, IAction, Store } from \"./store.js\";\nimport { createStore } from \"./store.js\";\n\n// Local microtask-based batching (no react-dom dependency)\nconst _queue = new Set<() => void>();\nlet _queued = false;\nconst _schedule = typeof queueMicrotask === \"function\"\n  ? queueMicrotask\n  : (fn: () => void) => Promise.resolve().then(fn);\n\nfunction enqueue(fn: () => void) {\n  _queue.add(fn);\n  if (_queued) return;\n  _queued = true;\n  _schedule(() => {\n    _queued = false;\n    const fns = Array.from(_queue);\n    _queue.clear();\n    for (const f of fns) f();\n  });\n}\n\nfunction makeBatchedSubscribe(subscribe: (l: () => void) => () => void) {\n  return (onChange: () => void) => subscribe(() => enqueue(onChange));\n}\n\nfunction shallowEqual(a: any, b: any) {\n  if (Object.is(a, b)) return true;\n  if (\n    typeof a !== \"object\" ||\n    a === null ||\n    typeof b !== \"object\" ||\n    b === null\n  )\n    return false;\n  const ak = Object.keys(a),\n    bk = Object.keys(b);\n  if (ak.length !== bk.length) return false;\n  for (let i = 0; i < ak.length; i++) {\n    const k = ak[i] as string;\n    if (\n      !Object.prototype.hasOwnProperty.call(b, k) ||\n      !Object.is((a as any)[k], (b as any)[k])\n    )\n      return false;\n  }\n  return true;\n}\n\nexport function createScopedStoreContext<S extends IState, A extends IAction>(\n  reducer: (state: S, action: A) => S,\n  initialState: S\n) {\n  const Context = createContext<Store<S, A> | null>(null);\n\n  // Each Provider instance gets its own store.\n  const Provider = ({\n    children,\n    initialState: override,\n  }: {\n    children: React.ReactNode;\n    initialState?: S;\n  }) => {\n    const storeRef = useRef<Store<S, A> | null>(null);\n    if (!storeRef.current) {\n      storeRef.current = createStore(reducer, override ?? initialState);\n    }\n    return <Context.Provider value={storeRef.current}>{children}</Context.Provider>;\n  };\n\n  const useStore = (): S => {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Store not found in context\");\n    return useSyncExternalStore(\n      makeBatchedSubscribe(ctx.subscribe),\n      ctx.getState,\n      ctx.getState\n    );\n  };\n\n  const useDispatch = (): ((action: A) => void) => {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Dispatch not found in context\");\n    return useCallback((action: A) => ctx.dispatch(action), [ctx]);\n  };\n\n  function useSelector<T>(\n    selector: (state: S) => T,\n    isEqual: (a: T, b: T) => boolean = shallowEqual\n  ): T {\n    const ctx = useContext(Context);\n    if (!ctx) throw new Error(\"Store not found in context\");\n\n    // Subscribe to the raw state snapshot (stable reference until a dispatch)\n    const state = useSyncExternalStore(\n      makeBatchedSubscribe(ctx.subscribe),\n      ctx.getState,\n      ctx.getState\n    );\n\n    // Cache the selected slice per state snapshot to avoid returning fresh objects during render\n    const lastRef = useRef<{ state: S; selected: T } | null>(null);\n    const last = lastRef.current;\n    const nextSelected = selector(state);\n\n    if (last && last.state === state && isEqual(last.selected, nextSelected)) {\n      return last.selected; // return cached reference to satisfy getSnapshot caching\n    }\n\n    lastRef.current = { state, selected: nextSelected };\n    return nextSelected;\n  }\n\n  return {\n    Context,\n    Provider,\n    useStore,\n    useDispatch,\n    useSelector,\n  };\n}\n","// freeze.ts\nexport function deepFreeze<T>(obj: T, seen = new WeakSet<object>()): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const o = obj as unknown as object;\n  if (seen.has(o)) return obj;\n  seen.add(o);\n\n  // Freeze children first\n  for (const key of Object.getOwnPropertyNames(o)) {\n    // @ts-expect-error index access\n    const val = (o as any)[key];\n    if (val && typeof val === \"object\") deepFreeze(val, seen);\n  }\n  // Also handle symbols (rare but safe)\n  for (const sym of Object.getOwnPropertySymbols(o)) {\n    // @ts-expect-error index access\n    const val = (o as any)[sym];\n    if (val && typeof val === \"object\") deepFreeze(val, seen);\n  }\n\n  return Object.freeze(obj);\n}\n","import type { Reducer, Listener } from \"./types.js\";\nimport { deepFreeze } from \"./freeze.js\";\n\nconst DEV =\n  typeof import.meta !== \"undefined\"\n    ? (import.meta as unknown as { env?: { DEV?: boolean } }).env?.DEV\n    : process.env.NODE_ENV !== \"production\";\n\n// Allow narrower parameter types for callbacks without fighting variance\ntype BivariantListener<T> = {\n  bivarianceHack(value: T): void;\n}[\"bivarianceHack\"];\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface IState {}\nexport interface IAction {\n  type: string;\n}\n\nexport interface Store<S extends IState, A extends IAction> {\n  getState(): S;\n  dispatch(action: A): void;\n  /**\n   * Subscribe to all state changes.\n   */\n  subscribe(listener: Listener): () => void;\n  /**\n   * Subscribe to changes of a specific key in the state.\n   */\n  subscribeToKey<K extends keyof S>(\n    key: K,\n    listener: (value: S[K]) => void\n  ): () => void;\n  /**\n   * Subscribe to changes in a selected value from the state.\n   */\n  subscribeWithSelector<T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void\n  ): () => void;\n}\n\nexport function createStore<S extends IState, A extends IAction>(\n  reducer: Reducer<S, A>,\n  initialState: S\n): Store<S, A> {\n  let state: S = DEV ? deepFreeze(initialState) : initialState;\n  const listeners = new Set<Listener>();\n  const keyListeners = new Map<keyof S, Set<BivariantListener<S[keyof S]>>>();\n\n  interface SelectorEntry<T> {\n    selector: (state: S) => T;\n    listener: BivariantListener<T>;\n    lastValue: T;\n  }\n  const selectorListeners = new Set<SelectorEntry<unknown>>();\n\n  const getState = () => state;\n\n  const dispatch = (action: A) => {\n    const prevState = state;\n    const nextState = reducer(state, action);\n    \n    if (DEV) deepFreeze(nextState);\n    \n    // Distinct-until-changed: if the reducer returns the same reference,\n    // skip all notifications (prevents unnecessary re-renders).\n    if (Object.is(prevState, nextState)) {\n      state = nextState; // keep any identity guarantees from reducer\n      return;\n    }\n\n    state = nextState;\n\n    // Notify global listeners (iterate over a snapshot so unsubscribe during\n    // notify does not skip the next listener)\n    for (const listener of [...listeners]) listener();\n\n    // Notify key listeners only when that key actually changed (Object.is)\n    for (const [key, set] of keyListeners.entries()) {\n      if (!Object.is(prevState[key], state[key])) {\n        for (const listener of [...set]) listener(state[key]);\n      }\n    }\n\n    // Notify selector listeners only when selected value changed (Object.is)\n    selectorListeners.forEach((entry) => {\n      const nextValue = (entry.selector as (s: S) => unknown)(state);\n      if (!Object.is(entry.lastValue, nextValue)) {\n        entry.lastValue = nextValue as unknown;\n        (entry.listener as (v: unknown) => void)(nextValue);\n      }\n    });\n  };\n\n  const subscribe = (listener: Listener) => {\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  };\n\n  const subscribeToKey = <K extends keyof S>(\n    key: K,\n    listener: (value: S[K]) => void\n  ) => {\n    const set =\n      keyListeners.get(key) ?? new Set<BivariantListener<S[keyof S]>>();\n    set.add(listener as unknown as BivariantListener<S[keyof S]>);\n    keyListeners.set(key, set);\n    return () => {\n      set.delete(listener as unknown as BivariantListener<S[keyof S]>);\n      if (set.size === 0) keyListeners.delete(key);\n    };\n  };\n\n  const subscribeWithSelector = <T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void\n  ) => {\n    const entry: SelectorEntry<T> = {\n      selector,\n      listener: listener as BivariantListener<T>,\n      lastValue: selector(state),\n    };\n    selectorListeners.add(entry as unknown as SelectorEntry<unknown>);\n    return () => {\n      selectorListeners.delete(entry as unknown as SelectorEntry<unknown>);\n    };\n  };\n\n  return {\n    getState,\n    dispatch,\n    subscribe,\n    subscribeToKey,\n    subscribeWithSelector,\n  };\n}\n","import React, { createContext, useContext, useEffect, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { Store, IState, IAction } from \"./store.js\";\n\nconst StoreContext = createContext<Store<IState, IAction> | undefined>(undefined);\n\nfunction useStoreInstance<S extends IState, A extends IAction>(): Store<S, A> {\n  const store = useContext(StoreContext) as Store<S, A> | undefined;\n  if (!store) {\n    throw new Error(\n      \"StoreProvider is missing in the React tree. Wrap your app with <StoreProvider store={...}>.\"\n    );\n  }\n  return store;\n}\n\ninterface StoreProviderProps<S extends IState, A extends IAction> {\n  store: Store<S, A>;\n  children: ReactNode;\n}\n\nexport function StoreProvider<S extends IState, A extends IAction>({\n  store,\n  children,\n}: StoreProviderProps<S, A>) {\n  return (\n    <StoreContext.Provider value={store as unknown as Store<IState, IAction>}>\n      {children}\n    </StoreContext.Provider>\n  );\n}\n\nexport function useStore<S extends IState>(): S {\n  const store = useStoreInstance<S, IAction>();\n  const [state, setState] = useState<S>(() => store.getState());\n\n  useEffect(() => {\n    // Subscribe to store changes and update local state.\n    const unsubscribe = store.subscribe(() => {\n      setState(store.getState());\n    });\n    return unsubscribe;\n  }, [store]);\n\n  return state;\n}\n\nexport function useDispatch<A extends IAction>(): Store<IState, A>[\"dispatch\"] {\n  const store = useStoreInstance<IState, A>();\n  // Return the store's dispatch directly; consumers can call dispatch(action).\n  return store.dispatch as Store<IState, A>[\"dispatch\"];\n}\n","// metadata-store.ts\nexport class MetadataStore<T extends object, Meta extends object> {\n  private readonly symbol: symbol;\n\n  constructor(description: string) {\n    this.symbol = Symbol(description);\n  }\n\n  set(target: T, meta: Meta) {\n    Object.defineProperty(target, this.symbol as PropertyKey, {\n      value: meta,\n      writable: false,\n      enumerable: false,\n    });\n  }\n\n  get(target: T): Meta | undefined {\n    return (target as Record<PropertyKey, Meta>)[this.symbol as PropertyKey];\n  }\n\n  has(target: T): boolean {\n    return (this.symbol as PropertyKey) in target;\n  }\n}\n"],"mappings":";AAGO,IAAM,SAAS;;;ACHtB,SAAS,eAAe,YAAY,QAAQ,sBAAsB,mBAAmB;;;ACC9E,SAAS,WAAc,KAAQ,OAAO,oBAAI,QAAgB,GAAM;AACrE,MAAI,QAAQ,QAAQ,OAAO,QAAQ,SAAU,QAAO;AACpD,QAAM,IAAI;AACV,MAAI,KAAK,IAAI,CAAC,EAAG,QAAO;AACxB,OAAK,IAAI,CAAC;AAGV,aAAW,OAAO,OAAO,oBAAoB,CAAC,GAAG;AAE/C,UAAM,MAAO,EAAU,GAAG;AAC1B,QAAI,OAAO,OAAO,QAAQ,SAAU,YAAW,KAAK,IAAI;AAAA,EAC1D;AAEA,aAAW,OAAO,OAAO,sBAAsB,CAAC,GAAG;AAEjD,UAAM,MAAO,EAAU,GAAG;AAC1B,QAAI,OAAO,OAAO,QAAQ,SAAU,YAAW,KAAK,IAAI;AAAA,EAC1D;AAEA,SAAO,OAAO,OAAO,GAAG;AAC1B;;;AClBA,IAAM,MACJ,OAAO,gBAAgB,cAClB,YAAuD,KAAK,MAC7D,QAAQ,IAAI,aAAa;AAoCxB,SAAS,YACd,SACA,cACa;AACb,MAAI,QAAW,MAAM,WAAW,YAAY,IAAI;AAChD,QAAM,YAAY,oBAAI,IAAc;AACpC,QAAM,eAAe,oBAAI,IAAiD;AAO1E,QAAM,oBAAoB,oBAAI,IAA4B;AAE1D,QAAM,WAAW,MAAM;AAEvB,QAAM,WAAW,CAAC,WAAc;AAC9B,UAAM,YAAY;AAClB,UAAM,YAAY,QAAQ,OAAO,MAAM;AAEvC,QAAI,IAAK,YAAW,SAAS;AAI7B,QAAI,OAAO,GAAG,WAAW,SAAS,GAAG;AACnC,cAAQ;AACR;AAAA,IACF;AAEA,YAAQ;AAIR,eAAW,YAAY,CAAC,GAAG,SAAS,EAAG,UAAS;AAGhD,eAAW,CAAC,KAAK,GAAG,KAAK,aAAa,QAAQ,GAAG;AAC/C,UAAI,CAAC,OAAO,GAAG,UAAU,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG;AAC1C,mBAAW,YAAY,CAAC,GAAG,GAAG,EAAG,UAAS,MAAM,GAAG,CAAC;AAAA,MACtD;AAAA,IACF;AAGA,sBAAkB,QAAQ,CAAC,UAAU;AACnC,YAAM,YAAa,MAAM,SAA+B,KAAK;AAC7D,UAAI,CAAC,OAAO,GAAG,MAAM,WAAW,SAAS,GAAG;AAC1C,cAAM,YAAY;AAClB,QAAC,MAAM,SAAkC,SAAS;AAAA,MACpD;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,YAAY,CAAC,aAAuB;AACxC,cAAU,IAAI,QAAQ;AACtB,WAAO,MAAM;AACX,gBAAU,OAAO,QAAQ;AAAA,IAC3B;AAAA,EACF;AAEA,QAAM,iBAAiB,CACrB,KACA,aACG;AACH,UAAM,MACJ,aAAa,IAAI,GAAG,KAAK,oBAAI,IAAmC;AAClE,QAAI,IAAI,QAAoD;AAC5D,iBAAa,IAAI,KAAK,GAAG;AACzB,WAAO,MAAM;AACX,UAAI,OAAO,QAAoD;AAC/D,UAAI,IAAI,SAAS,EAAG,cAAa,OAAO,GAAG;AAAA,IAC7C;AAAA,EACF;AAEA,QAAM,wBAAwB,CAC5B,UACA,aACG;AACH,UAAM,QAA0B;AAAA,MAC9B;AAAA,MACA;AAAA,MACA,WAAW,SAAS,KAAK;AAAA,IAC3B;AACA,sBAAkB,IAAI,KAA0C;AAChE,WAAO,MAAM;AACX,wBAAkB,OAAO,KAA0C;AAAA,IACrE;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;AFtEW;AA/DX,IAAM,SAAS,oBAAI,IAAgB;AACnC,IAAI,UAAU;AACd,IAAM,YAAY,OAAO,mBAAmB,aACxC,iBACA,CAAC,OAAmB,QAAQ,QAAQ,EAAE,KAAK,EAAE;AAEjD,SAAS,QAAQ,IAAgB;AAC/B,SAAO,IAAI,EAAE;AACb,MAAI,QAAS;AACb,YAAU;AACV,YAAU,MAAM;AACd,cAAU;AACV,UAAM,MAAM,MAAM,KAAK,MAAM;AAC7B,WAAO,MAAM;AACb,eAAW,KAAK,IAAK,GAAE;AAAA,EACzB,CAAC;AACH;AAEA,SAAS,qBAAqB,WAA0C;AACtE,SAAO,CAAC,aAAyB,UAAU,MAAM,QAAQ,QAAQ,CAAC;AACpE;AAEA,SAAS,aAAa,GAAQ,GAAQ;AACpC,MAAI,OAAO,GAAG,GAAG,CAAC,EAAG,QAAO;AAC5B,MACE,OAAO,MAAM,YACb,MAAM,QACN,OAAO,MAAM,YACb,MAAM;AAEN,WAAO;AACT,QAAM,KAAK,OAAO,KAAK,CAAC,GACtB,KAAK,OAAO,KAAK,CAAC;AACpB,MAAI,GAAG,WAAW,GAAG,OAAQ,QAAO;AACpC,WAAS,IAAI,GAAG,IAAI,GAAG,QAAQ,KAAK;AAClC,UAAM,IAAI,GAAG,CAAC;AACd,QACE,CAAC,OAAO,UAAU,eAAe,KAAK,GAAG,CAAC,KAC1C,CAAC,OAAO,GAAI,EAAU,CAAC,GAAI,EAAU,CAAC,CAAC;AAEvC,aAAO;AAAA,EACX;AACA,SAAO;AACT;AAEO,SAAS,yBACd,SACA,cACA;AACA,QAAM,UAAU,cAAkC,IAAI;AAGtD,QAAM,WAAW,CAAC;AAAA,IAChB;AAAA,IACA,cAAc;AAAA,EAChB,MAGM;AACJ,UAAM,WAAW,OAA2B,IAAI;AAChD,QAAI,CAAC,SAAS,SAAS;AACrB,eAAS,UAAU,YAAY,SAAS,YAAY,YAAY;AAAA,IAClE;AACA,WAAO,oBAAC,QAAQ,UAAR,EAAiB,OAAO,SAAS,SAAU,UAAS;AAAA,EAC9D;AAEA,QAAMA,YAAW,MAAS;AACxB,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4BAA4B;AACtD,WAAO;AAAA,MACL,qBAAqB,IAAI,SAAS;AAAA,MAClC,IAAI;AAAA,MACJ,IAAI;AAAA,IACN;AAAA,EACF;AAEA,QAAMC,eAAc,MAA6B;AAC/C,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,CAAC,IAAK,OAAM,IAAI,MAAM,+BAA+B;AACzD,WAAO,YAAY,CAAC,WAAc,IAAI,SAAS,MAAM,GAAG,CAAC,GAAG,CAAC;AAAA,EAC/D;AAEA,WAAS,YACP,UACA,UAAmC,cAChC;AACH,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4BAA4B;AAGtD,UAAM,QAAQ;AAAA,MACZ,qBAAqB,IAAI,SAAS;AAAA,MAClC,IAAI;AAAA,MACJ,IAAI;AAAA,IACN;AAGA,UAAM,UAAU,OAAyC,IAAI;AAC7D,UAAM,OAAO,QAAQ;AACrB,UAAM,eAAe,SAAS,KAAK;AAEnC,QAAI,QAAQ,KAAK,UAAU,SAAS,QAAQ,KAAK,UAAU,YAAY,GAAG;AACxE,aAAO,KAAK;AAAA,IACd;AAEA,YAAQ,UAAU,EAAE,OAAO,UAAU,aAAa;AAClD,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAAD;AAAA,IACA,aAAAC;AAAA,IACA;AAAA,EACF;AACF;;;AGzHA,SAAgB,iBAAAC,gBAAe,cAAAC,aAAY,WAAW,gBAAgB;AA0BlE,gBAAAC,YAAA;AAtBJ,IAAM,eAAeF,eAAkD,MAAS;AAEhF,SAAS,mBAAqE;AAC5E,QAAM,QAAQC,YAAW,YAAY;AACrC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,cAAmD;AAAA,EACjE;AAAA,EACA;AACF,GAA6B;AAC3B,SACE,gBAAAC,KAAC,aAAa,UAAb,EAAsB,OAAO,OAC3B,UACH;AAEJ;AAEO,SAAS,WAAgC;AAC9C,QAAM,QAAQ,iBAA6B;AAC3C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAY,MAAM,MAAM,SAAS,CAAC;AAE5D,YAAU,MAAM;AAEd,UAAM,cAAc,MAAM,UAAU,MAAM;AACxC,eAAS,MAAM,SAAS,CAAC;AAAA,IAC3B,CAAC;AACD,WAAO;AAAA,EACT,GAAG,CAAC,KAAK,CAAC;AAEV,SAAO;AACT;AAEO,SAAS,cAA+D;AAC7E,QAAM,QAAQ,iBAA4B;AAE1C,SAAO,MAAM;AACf;;;AClDO,IAAM,gBAAN,MAA2D;AAAA,EAC/C;AAAA,EAEjB,YAAY,aAAqB;AAC/B,SAAK,SAAS,OAAO,WAAW;AAAA,EAClC;AAAA,EAEA,IAAI,QAAW,MAAY;AACzB,WAAO,eAAe,QAAQ,KAAK,QAAuB;AAAA,MACxD,OAAO;AAAA,MACP,UAAU;AAAA,MACV,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,QAA6B;AAC/B,WAAQ,OAAqC,KAAK,MAAqB;AAAA,EACzE;AAAA,EAEA,IAAI,QAAoB;AACtB,WAAQ,KAAK,UAA0B;AAAA,EACzC;AACF;","names":["useStore","useDispatch","createContext","useContext","jsx"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/react-state",
-  "version": "1.0.12",
+  "version": "1.1.0",
   "description": "Tiny, testable, typesafe React Scoped Store helper.",
   "keywords": [
     "react",
@@ -51,13 +51,14 @@
     "clean": "rimraf dist"
   },
   "devDependencies": {
+    "@types/react": "^19.1.13",
     "@testing-library/jest-dom": "^6.8.0",
     "@testing-library/react": "^16.3.0",
-    "@types/node": "^24.3.1",
+    "@types/node": "^24.5.2",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
     "@vitest/coverage-v8": "^3.2.4",
-    "eslint": "^9.35.0",
+    "eslint": "^9.36.0",
     "jsdom": "^27.0.0",
     "tsup": "^8.5.0",
     "tsx": "^4.20.5",
@@ -67,9 +68,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@types/react": "^19.1.13",
-    "react": "^19.1.1"
+  "peerDependencies": {
+    "react": "^19"
   },
   "funding": [
     {