@plasius/react-state 1.1.0 → 1.2.0

package/README.md

@@ -14,6 +14,12 @@
 
 `@plasius/react-state` provides a scoped state management solution for React applications. It allows developers to create isolated, testable, and composable stores without introducing heavy dependencies.
 
+**Key traits**
+- React 18/19 compatible; uses `useSyncExternalStore` for tearing-safe snapshots.
+- Distinct-until-changed dispatch flow to avoid needless notifications and re-renders.
+- Selector subscriptions accept custom equality to prevent redundant renders when slices are unchanged.
+- Scoped Provider recreates its store when `initialState` changes so fresh trees start from fresh state.
+
 ---
 
 ## Installation

package/dist/index.cjs

@@ -56,6 +56,14 @@ function deepFreeze(obj, seen = /* @__PURE__ */ new WeakSet()) {
 // src/store.ts
 var import_meta = {};
 var DEV = typeof import_meta !== "undefined" ? import_meta.env?.DEV : process.env.NODE_ENV !== "production";
+function devTrack(name, props) {
+  if (!DEV) return;
+  try {
+    const t = globalThis?.track;
+    if (typeof t === "function") t(name, props);
+  } catch {
+  }
+}
 function createStore(reducer, initialState) {
   let state = DEV ? deepFreeze(initialState) : initialState;
   const listeners = /* @__PURE__ */ new Set();
@@ -66,49 +74,95 @@ function createStore(reducer, initialState) {
     const prevState = state;
     const nextState = reducer(state, action);
     if (DEV) deepFreeze(nextState);
+    devTrack("store:dispatch", { type: action?.type });
     if (Object.is(prevState, nextState)) {
       state = nextState;
+      devTrack("store:no-op", { type: action?.type });
       return;
     }
     state = nextState;
-    for (const listener of [...listeners]) listener();
+    let changedKeys;
+    if (DEV) {
+      changedKeys = Object.keys(nextState).filter((k) => !Object.is(prevState[k], nextState[k]));
+      devTrack("store:state-changed", { type: action?.type, changedKeys });
+    }
+    const globalSnapshot = [...listeners];
+    devTrack("store:notify:all", { listeners: globalSnapshot.length });
+    let firstError;
+    for (const listener of globalSnapshot) {
+      try {
+        listener();
+      } catch (err) {
+        if (!firstError) firstError = err;
+      }
+    }
     for (const [key, set] of keyListeners.entries()) {
       if (!Object.is(prevState[key], state[key])) {
-        for (const listener of [...set]) listener(state[key]);
+        devTrack("store:notify:key", { key: String(key), listeners: set.size });
+        for (const listener of [...set]) {
+          try {
+            listener(state[key]);
+          } catch (err) {
+            if (!firstError) firstError = err;
+          }
+        }
       }
     }
-    selectorListeners.forEach((entry) => {
+    let selNotifies = 0;
+    for (const entry of [...selectorListeners]) {
       const nextValue = entry.selector(state);
-      if (!Object.is(entry.lastValue, nextValue)) {
+      const equal = entry.isEqual ?? Object.is;
+      let isSame = false;
+      try {
+        isSame = equal(entry.lastValue, nextValue);
+      } catch (err) {
+        if (!firstError) firstError = err;
+        continue;
+      }
+      if (!isSame) {
         entry.lastValue = nextValue;
-        entry.listener(nextValue);
+        try {
+          entry.listener(nextValue);
+        } catch (err) {
+          if (!firstError) firstError = err;
+        }
+        selNotifies++;
       }
-    });
+    }
+    devTrack("store:notify:selector", { listeners: selNotifies });
+    if (firstError) throw firstError;
   };
   const subscribe = (listener) => {
     listeners.add(listener);
+    devTrack("store:sub:all:add", { size: listeners.size });
     return () => {
       listeners.delete(listener);
+      devTrack("store:sub:all:remove", { size: listeners.size });
     };
   };
   const subscribeToKey = (key, listener) => {
     const set = keyListeners.get(key) ?? /* @__PURE__ */ new Set();
     set.add(listener);
     keyListeners.set(key, set);
+    devTrack("store:sub:key:add", { key: String(key), size: set.size });
     return () => {
       set.delete(listener);
       if (set.size === 0) keyListeners.delete(key);
+      devTrack("store:sub:key:remove", { key: String(key), size: set.size });
     };
   };
-  const subscribeWithSelector = (selector, listener) => {
+  const subscribeWithSelector = (selector, listener, isEqual) => {
     const entry = {
       selector,
       listener,
-      lastValue: selector(state)
+      lastValue: selector(state),
+      isEqual
     };
     selectorListeners.add(entry);
+    devTrack("store:sub:selector:add", { size: selectorListeners.size });
     return () => {
       selectorListeners.delete(entry);
+      devTrack("store:sub:selector:remove", { size: selectorListeners.size });
     };
   };
   return {
@@ -122,6 +176,15 @@ function createStore(reducer, initialState) {
 
 // src/create-scoped-store.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
+var __DEV__ = typeof process !== "undefined" ? process.env.NODE_ENV !== "production" : true;
+function devTrack2(name, props) {
+  if (!__DEV__) return;
+  try {
+    const t = globalThis?.track;
+    if (typeof t === "function") t(name, props);
+  } catch {
+  }
+}
 var _queue = /* @__PURE__ */ new Set();
 var _queued = false;
 var _schedule = typeof queueMicrotask === "function" ? queueMicrotask : (fn) => Promise.resolve().then(fn);
@@ -134,10 +197,22 @@ function enqueue(fn) {
     const fns = Array.from(_queue);
     _queue.clear();
     for (const f of fns) f();
+    devTrack2("scoped:batch:flush", { size: fns.length });
   });
 }
 function makeBatchedSubscribe(subscribe) {
-  return (onChange) => subscribe(() => enqueue(onChange));
+  return (onChange) => {
+    devTrack2("scoped:sub:add");
+    const wrapped = () => {
+      devTrack2("scoped:notify:enqueue");
+      enqueue(onChange);
+    };
+    const unsubscribe = subscribe(wrapped);
+    return () => {
+      devTrack2("scoped:sub:remove");
+      unsubscribe();
+    };
+  };
 }
 function shallowEqual(a, b) {
   if (Object.is(a, b)) return true;
@@ -158,15 +233,21 @@ function createScopedStoreContext(reducer, initialState) {
     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 store = (0, import_react.useMemo)(() => {
+      const next = createStore(reducer, override ?? initialState);
+      devTrack2("scoped:store:create");
+      return next;
+    }, [reducer, override, initialState]);
+    (0, import_react.useEffect)(() => {
+      devTrack2("scoped:provider:mount");
+      return () => devTrack2("scoped:provider:unmount");
+    }, []);
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Context.Provider, { value: store, children });
   };
   const useStore2 = () => {
     const ctx = (0, import_react.useContext)(Context);
     if (!ctx) throw new Error("Store not found in context");
+    devTrack2("scoped:useStore");
     return (0, import_react.useSyncExternalStore)(
       makeBatchedSubscribe(ctx.subscribe),
       ctx.getState,
@@ -181,19 +262,36 @@ function createScopedStoreContext(reducer, initialState) {
   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)(
-      makeBatchedSubscribe(ctx.subscribe),
-      ctx.getState,
-      ctx.getState
-    );
     const lastRef = (0, import_react.useRef)(null);
-    const last = lastRef.current;
-    const nextSelected = selector(state);
-    if (last && last.state === state && isEqual(last.selected, nextSelected)) {
-      return last.selected;
-    }
-    lastRef.current = { state, selected: nextSelected };
-    return nextSelected;
+    const getSnapshot = () => {
+      const nextSelected = selector(ctx.getState());
+      const last = lastRef.current;
+      if (last && isEqual(last.selected, nextSelected)) {
+        devTrack2("scoped:selector:cache-hit");
+        return last.selected;
+      }
+      devTrack2("scoped:selector:cache-miss");
+      lastRef.current = { selected: nextSelected };
+      return nextSelected;
+    };
+    const subscribe = (onChange) => {
+      devTrack2("scoped:selector:sub:add");
+      const unsubscribe = ctx.subscribeWithSelector(selector, (nextSelected) => {
+        const last = lastRef.current;
+        if (last && isEqual(last.selected, nextSelected)) {
+          devTrack2("scoped:selector:skip");
+          return;
+        }
+        lastRef.current = { selected: nextSelected };
+        devTrack2("scoped:selector:notify");
+        enqueue(onChange);
+      }, isEqual);
+      return () => {
+        devTrack2("scoped:selector:sub:remove");
+        unsubscribe();
+      };
+    };
+    return (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   }
   return {
     Context,
@@ -207,10 +305,20 @@ function createScopedStoreContext(reducer, initialState) {
 // src/provider.tsx
 var import_react2 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
+var __DEV__2 = typeof process !== "undefined" ? process.env.NODE_ENV !== "production" : true;
+function devTrack3(name, props) {
+  if (!__DEV__2) return;
+  try {
+    const t = globalThis?.track;
+    if (typeof t === "function") t(name, props);
+  } catch {
+  }
+}
 var StoreContext = (0, import_react2.createContext)(void 0);
 function useStoreInstance() {
   const store = (0, import_react2.useContext)(StoreContext);
   if (!store) {
+    devTrack3("store:provider:missing");
     throw new Error(
       "StoreProvider is missing in the React tree. Wrap your app with <StoreProvider store={...}>."
     );
@@ -221,18 +329,29 @@ function StoreProvider({
   store,
   children
 }) {
+  (0, import_react2.useEffect)(() => {
+    devTrack3("store:provider:mount", { hasStore: !!store });
+    return () => devTrack3("store:provider:unmount");
+  }, [store]);
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(StoreContext.Provider, { value: store, children });
 }
 function useStore() {
   const store = useStoreInstance();
-  const [state, setState] = (0, import_react2.useState)(() => store.getState());
-  (0, import_react2.useEffect)(() => {
-    const unsubscribe = store.subscribe(() => {
-      setState(store.getState());
-    });
-    return unsubscribe;
-  }, [store]);
-  return state;
+  return (0, import_react2.useSyncExternalStore)(
+    (onStoreChange) => {
+      devTrack3("store:react:subscribe");
+      const unsubscribe = store.subscribe(() => {
+        devTrack3("store:react:notify");
+        onStoreChange();
+      });
+      return () => {
+        devTrack3("store:react:unsubscribe");
+        unsubscribe();
+      };
+    },
+    store.getState,
+    store.getState
+  );
 }
 function useDispatch() {
   const store = useStoreInstance();

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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"]}
+{"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, useEffect, useMemo } from \"react\";\nimport type { IState, IAction, Store } from \"./store.js\";\nimport { createStore } from \"./store.js\";\n\n// DEV-only tracking (no-op in production)\nconst __DEV__ = typeof process !== \"undefined\" ? process.env.NODE_ENV !== \"production\" : true;\nfunction devTrack(name: string, props?: Record<string, unknown>) {\n  if (!__DEV__) return;\n  try {\n    const t = (globalThis as any)?.track;\n    if (typeof t === \"function\") t(name, props);\n  } catch {}\n}\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    devTrack(\"scoped:batch:flush\", { size: fns.length });\n  });\n}\n\nfunction makeBatchedSubscribe(subscribe: (l: () => void) => () => void) {\n  return (onChange: () => void) => {\n    devTrack(\"scoped:sub:add\");\n    const wrapped = () => {\n      devTrack(\"scoped:notify:enqueue\");\n      enqueue(onChange);\n    };\n    const unsubscribe = subscribe(wrapped);\n    return () => {\n      devTrack(\"scoped:sub:remove\");\n      unsubscribe();\n    };\n  };\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 store = useMemo(() => {\n      const next = createStore(reducer, override ?? initialState);\n      devTrack(\"scoped:store:create\");\n      return next;\n    }, [reducer, override, initialState]);\n\n    useEffect(() => {\n      devTrack(\"scoped:provider:mount\");\n      return () => devTrack(\"scoped:provider:unmount\");\n    }, []);\n\n    return <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    devTrack(\"scoped:useStore\");\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    const lastRef = useRef<{ selected: T } | null>(null);\n\n    const getSnapshot = () => {\n      const nextSelected = selector(ctx.getState());\n      const last = lastRef.current;\n      if (last && isEqual(last.selected, nextSelected)) {\n        devTrack(\"scoped:selector:cache-hit\");\n        return last.selected;\n      }\n      devTrack(\"scoped:selector:cache-miss\");\n      lastRef.current = { selected: nextSelected };\n      return nextSelected;\n    };\n\n    const subscribe = (onChange: () => void) => {\n      devTrack(\"scoped:selector:sub:add\");\n      const unsubscribe = ctx.subscribeWithSelector(selector, (nextSelected) => {\n        const last = lastRef.current;\n        if (last && isEqual(last.selected, nextSelected)) {\n          devTrack(\"scoped:selector:skip\");\n          return;\n        }\n        lastRef.current = { selected: nextSelected };\n        devTrack(\"scoped:selector:notify\");\n        enqueue(onChange);\n      }, isEqual);\n      return () => {\n        devTrack(\"scoped:selector:sub:remove\");\n        unsubscribe();\n      };\n    };\n\n    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\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// Lightweight DEV-only tracker\nfunction devTrack(name: string, props?: Record<string, unknown>) {\n  if (!DEV) return;\n  try {\n    const t = (globalThis as any)?.track;\n    if (typeof t === \"function\") t(name, props);\n  } catch {}\n}\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    isEqual?: (a: T, b: T) => boolean\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    isEqual?: (a: T, b: T) => boolean;\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    // Track the inbound action\n    devTrack(\"store:dispatch\", { type: action?.type });\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      devTrack(\"store:no-op\", { type: action?.type });\n      return;\n    }\n\n    state = nextState;\n\n    // Compute changed keys (shallow) for diagnostics\n    let changedKeys: (keyof S)[] | undefined;\n    if (DEV) {\n      changedKeys = Object.keys(nextState as Record<string, unknown>)\n        .filter((k) => !Object.is((prevState as any)[k], (nextState as any)[k])) as (keyof S)[];\n      devTrack(\"store:state-changed\", { type: action?.type, changedKeys });\n    }\n\n    // Notify global listeners (iterate over a snapshot so unsubscribe during\n    // notify does not skip the next listener)\n    const globalSnapshot = [...listeners];\n    devTrack(\"store:notify:all\", { listeners: globalSnapshot.length });\n    let firstError: unknown;\n    for (const listener of globalSnapshot) {\n      try {\n        listener();\n      } catch (err) {\n        if (!firstError) firstError = err;\n      }\n    }\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        devTrack(\"store:notify:key\", { key: String(key), listeners: set.size });\n        for (const listener of [...set]) {\n          try {\n            listener(state[key]);\n          } catch (err) {\n            if (!firstError) firstError = err;\n          }\n        }\n      }\n    }\n\n    // Notify selector listeners only when selected value changed (Object.is)\n    let selNotifies = 0;\n    for (const entry of [...selectorListeners]) {\n      const nextValue = (entry.selector as (s: S) => unknown)(state);\n      const equal = (entry.isEqual as ((a: unknown, b: unknown) => boolean) | undefined) ?? Object.is;\n      let isSame = false;\n      try {\n        isSame = equal(entry.lastValue, nextValue);\n      } catch (err) {\n        if (!firstError) firstError = err;\n        continue;\n      }\n      if (!isSame) {\n        entry.lastValue = nextValue as unknown;\n        try {\n          (entry.listener as (v: unknown) => void)(nextValue);\n        } catch (err) {\n          if (!firstError) firstError = err;\n        }\n        selNotifies++;\n      }\n    }\n    devTrack(\"store:notify:selector\", { listeners: selNotifies });\n    if (firstError) throw firstError;\n  };\n\n  const subscribe = (listener: Listener) => {\n    listeners.add(listener);\n    devTrack(\"store:sub:all:add\", { size: listeners.size });\n    return () => {\n      listeners.delete(listener);\n      devTrack(\"store:sub:all:remove\", { size: listeners.size });\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    devTrack(\"store:sub:key:add\", { key: String(key), size: set.size });\n    return () => {\n      set.delete(listener as unknown as BivariantListener<S[keyof S]>);\n      if (set.size === 0) keyListeners.delete(key);\n      devTrack(\"store:sub:key:remove\", { key: String(key), size: set.size });\n    };\n  };\n\n  const subscribeWithSelector = <T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void,\n    isEqual?: (a: T, b: T) => boolean\n  ) => {\n    const entry: SelectorEntry<T> = {\n      selector,\n      listener: listener as BivariantListener<T>,\n      lastValue: selector(state),\n      isEqual,\n    };\n    selectorListeners.add(entry as unknown as SelectorEntry<unknown>);\n    devTrack(\"store:sub:selector:add\", { size: selectorListeners.size });\n    return () => {\n      selectorListeners.delete(entry as unknown as SelectorEntry<unknown>);\n      devTrack(\"store:sub:selector:remove\", { size: selectorListeners.size });\n    };\n  };\n\n  return {\n    getState,\n    dispatch,\n    subscribe,\n    subscribeToKey,\n    subscribeWithSelector,\n  };\n}\n","import React, { createContext, useContext, useEffect, useSyncExternalStore } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { Store, IState, IAction } from \"./store.js\";\n\n// DEV-only tracking (no-op in production)\nconst __DEV__ = typeof process !== \"undefined\" ? process.env.NODE_ENV !== \"production\" : true;\nfunction devTrack(name: string, props?: Record<string, unknown>) {\n  if (!__DEV__) return;\n  try {\n    const t = (globalThis as any)?.track;\n    if (typeof t === \"function\") t(name, props);\n  } catch {}\n}\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    devTrack(\"store:provider:missing\");\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  useEffect(() => {\n    devTrack(\"store:provider:mount\", { hasStore: !!store });\n    return () => devTrack(\"store:provider:unmount\");\n  }, [store]);\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  return useSyncExternalStore(\n    (onStoreChange) => {\n      devTrack(\"store:react:subscribe\");\n      const unsubscribe = store.subscribe(() => {\n        devTrack(\"store:react:notify\");\n        onStoreChange();\n      });\n      return () => {\n        devTrack(\"store:react:unsubscribe\");\n        unsubscribe();\n      };\n    },\n    store.getState,\n    store.getState\n  );\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":["devTrack","useStore","useDispatch","import_react","import_jsx_runtime","__DEV__","devTrack"]}

package/dist/index.d.cts

@@ -26,7 +26,7 @@ interface Store<S extends IState, A extends IAction> {
     /**
      * Subscribe to changes in a selected value from the state.
      */
-    subscribeWithSelector<T>(selector: (state: S) => T, listener: (selected: T) => void): () => void;
+    subscribeWithSelector<T>(selector: (state: S) => T, listener: (selected: T) => void, isEqual?: (a: T, b: T) => boolean): () => void;
 }
 declare function createStore<S extends IState, A extends IAction>(reducer: Reducer<S, A>, initialState: S): Store<S, A>;
 

package/dist/index.d.ts

@@ -26,7 +26,7 @@ interface Store<S extends IState, A extends IAction> {
     /**
      * Subscribe to changes in a selected value from the state.
      */
-    subscribeWithSelector<T>(selector: (state: S) => T, listener: (selected: T) => void): () => void;
+    subscribeWithSelector<T>(selector: (state: S) => T, listener: (selected: T) => void, isEqual?: (a: T, b: T) => boolean): () => void;
 }
 declare function createStore<S extends IState, A extends IAction>(reducer: Reducer<S, A>, initialState: S): Store<S, A>;
 

package/dist/index.js

@@ -2,7 +2,7 @@
 var __noop = null;
 
 // src/create-scoped-store.tsx
-import { createContext, useContext, useRef, useSyncExternalStore, useCallback } from "react";
+import { createContext, useContext, useRef, useSyncExternalStore, useCallback, useEffect, useMemo } from "react";
 
 // src/freeze.ts
 function deepFreeze(obj, seen = /* @__PURE__ */ new WeakSet()) {
@@ -23,6 +23,14 @@ function deepFreeze(obj, seen = /* @__PURE__ */ new WeakSet()) {
 
 // src/store.ts
 var DEV = typeof import.meta !== "undefined" ? import.meta.env?.DEV : process.env.NODE_ENV !== "production";
+function devTrack(name, props) {
+  if (!DEV) return;
+  try {
+    const t = globalThis?.track;
+    if (typeof t === "function") t(name, props);
+  } catch {
+  }
+}
 function createStore(reducer, initialState) {
   let state = DEV ? deepFreeze(initialState) : initialState;
   const listeners = /* @__PURE__ */ new Set();
@@ -33,49 +41,95 @@ function createStore(reducer, initialState) {
     const prevState = state;
     const nextState = reducer(state, action);
     if (DEV) deepFreeze(nextState);
+    devTrack("store:dispatch", { type: action?.type });
     if (Object.is(prevState, nextState)) {
       state = nextState;
+      devTrack("store:no-op", { type: action?.type });
       return;
     }
     state = nextState;
-    for (const listener of [...listeners]) listener();
+    let changedKeys;
+    if (DEV) {
+      changedKeys = Object.keys(nextState).filter((k) => !Object.is(prevState[k], nextState[k]));
+      devTrack("store:state-changed", { type: action?.type, changedKeys });
+    }
+    const globalSnapshot = [...listeners];
+    devTrack("store:notify:all", { listeners: globalSnapshot.length });
+    let firstError;
+    for (const listener of globalSnapshot) {
+      try {
+        listener();
+      } catch (err) {
+        if (!firstError) firstError = err;
+      }
+    }
     for (const [key, set] of keyListeners.entries()) {
       if (!Object.is(prevState[key], state[key])) {
-        for (const listener of [...set]) listener(state[key]);
+        devTrack("store:notify:key", { key: String(key), listeners: set.size });
+        for (const listener of [...set]) {
+          try {
+            listener(state[key]);
+          } catch (err) {
+            if (!firstError) firstError = err;
+          }
+        }
       }
     }
-    selectorListeners.forEach((entry) => {
+    let selNotifies = 0;
+    for (const entry of [...selectorListeners]) {
       const nextValue = entry.selector(state);
-      if (!Object.is(entry.lastValue, nextValue)) {
+      const equal = entry.isEqual ?? Object.is;
+      let isSame = false;
+      try {
+        isSame = equal(entry.lastValue, nextValue);
+      } catch (err) {
+        if (!firstError) firstError = err;
+        continue;
+      }
+      if (!isSame) {
         entry.lastValue = nextValue;
-        entry.listener(nextValue);
+        try {
+          entry.listener(nextValue);
+        } catch (err) {
+          if (!firstError) firstError = err;
+        }
+        selNotifies++;
       }
-    });
+    }
+    devTrack("store:notify:selector", { listeners: selNotifies });
+    if (firstError) throw firstError;
   };
   const subscribe = (listener) => {
     listeners.add(listener);
+    devTrack("store:sub:all:add", { size: listeners.size });
     return () => {
       listeners.delete(listener);
+      devTrack("store:sub:all:remove", { size: listeners.size });
     };
   };
   const subscribeToKey = (key, listener) => {
     const set = keyListeners.get(key) ?? /* @__PURE__ */ new Set();
     set.add(listener);
     keyListeners.set(key, set);
+    devTrack("store:sub:key:add", { key: String(key), size: set.size });
     return () => {
       set.delete(listener);
       if (set.size === 0) keyListeners.delete(key);
+      devTrack("store:sub:key:remove", { key: String(key), size: set.size });
     };
   };
-  const subscribeWithSelector = (selector, listener) => {
+  const subscribeWithSelector = (selector, listener, isEqual) => {
     const entry = {
       selector,
       listener,
-      lastValue: selector(state)
+      lastValue: selector(state),
+      isEqual
     };
     selectorListeners.add(entry);
+    devTrack("store:sub:selector:add", { size: selectorListeners.size });
     return () => {
       selectorListeners.delete(entry);
+      devTrack("store:sub:selector:remove", { size: selectorListeners.size });
     };
   };
   return {
@@ -89,6 +143,15 @@ function createStore(reducer, initialState) {
 
 // src/create-scoped-store.tsx
 import { jsx } from "react/jsx-runtime";
+var __DEV__ = typeof process !== "undefined" ? process.env.NODE_ENV !== "production" : true;
+function devTrack2(name, props) {
+  if (!__DEV__) return;
+  try {
+    const t = globalThis?.track;
+    if (typeof t === "function") t(name, props);
+  } catch {
+  }
+}
 var _queue = /* @__PURE__ */ new Set();
 var _queued = false;
 var _schedule = typeof queueMicrotask === "function" ? queueMicrotask : (fn) => Promise.resolve().then(fn);
@@ -101,10 +164,22 @@ function enqueue(fn) {
     const fns = Array.from(_queue);
     _queue.clear();
     for (const f of fns) f();
+    devTrack2("scoped:batch:flush", { size: fns.length });
   });
 }
 function makeBatchedSubscribe(subscribe) {
-  return (onChange) => subscribe(() => enqueue(onChange));
+  return (onChange) => {
+    devTrack2("scoped:sub:add");
+    const wrapped = () => {
+      devTrack2("scoped:notify:enqueue");
+      enqueue(onChange);
+    };
+    const unsubscribe = subscribe(wrapped);
+    return () => {
+      devTrack2("scoped:sub:remove");
+      unsubscribe();
+    };
+  };
 }
 function shallowEqual(a, b) {
   if (Object.is(a, b)) return true;
@@ -125,15 +200,21 @@ function createScopedStoreContext(reducer, initialState) {
     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 store = useMemo(() => {
+      const next = createStore(reducer, override ?? initialState);
+      devTrack2("scoped:store:create");
+      return next;
+    }, [reducer, override, initialState]);
+    useEffect(() => {
+      devTrack2("scoped:provider:mount");
+      return () => devTrack2("scoped:provider:unmount");
+    }, []);
+    return /* @__PURE__ */ jsx(Context.Provider, { value: store, children });
   };
   const useStore2 = () => {
     const ctx = useContext(Context);
     if (!ctx) throw new Error("Store not found in context");
+    devTrack2("scoped:useStore");
     return useSyncExternalStore(
       makeBatchedSubscribe(ctx.subscribe),
       ctx.getState,
@@ -148,19 +229,36 @@ function createScopedStoreContext(reducer, initialState) {
   function useSelector(selector, isEqual = shallowEqual) {
     const ctx = useContext(Context);
     if (!ctx) throw new Error("Store not found in context");
-    const state = useSyncExternalStore(
-      makeBatchedSubscribe(ctx.subscribe),
-      ctx.getState,
-      ctx.getState
-    );
     const lastRef = useRef(null);
-    const last = lastRef.current;
-    const nextSelected = selector(state);
-    if (last && last.state === state && isEqual(last.selected, nextSelected)) {
-      return last.selected;
-    }
-    lastRef.current = { state, selected: nextSelected };
-    return nextSelected;
+    const getSnapshot = () => {
+      const nextSelected = selector(ctx.getState());
+      const last = lastRef.current;
+      if (last && isEqual(last.selected, nextSelected)) {
+        devTrack2("scoped:selector:cache-hit");
+        return last.selected;
+      }
+      devTrack2("scoped:selector:cache-miss");
+      lastRef.current = { selected: nextSelected };
+      return nextSelected;
+    };
+    const subscribe = (onChange) => {
+      devTrack2("scoped:selector:sub:add");
+      const unsubscribe = ctx.subscribeWithSelector(selector, (nextSelected) => {
+        const last = lastRef.current;
+        if (last && isEqual(last.selected, nextSelected)) {
+          devTrack2("scoped:selector:skip");
+          return;
+        }
+        lastRef.current = { selected: nextSelected };
+        devTrack2("scoped:selector:notify");
+        enqueue(onChange);
+      }, isEqual);
+      return () => {
+        devTrack2("scoped:selector:sub:remove");
+        unsubscribe();
+      };
+    };
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
   }
   return {
     Context,
@@ -172,12 +270,22 @@ function createScopedStoreContext(reducer, initialState) {
 }
 
 // src/provider.tsx
-import { createContext as createContext2, useContext as useContext2, useEffect, useState } from "react";
+import { createContext as createContext2, useContext as useContext2, useEffect as useEffect2, useSyncExternalStore as useSyncExternalStore2 } from "react";
 import { jsx as jsx2 } from "react/jsx-runtime";
+var __DEV__2 = typeof process !== "undefined" ? process.env.NODE_ENV !== "production" : true;
+function devTrack3(name, props) {
+  if (!__DEV__2) return;
+  try {
+    const t = globalThis?.track;
+    if (typeof t === "function") t(name, props);
+  } catch {
+  }
+}
 var StoreContext = createContext2(void 0);
 function useStoreInstance() {
   const store = useContext2(StoreContext);
   if (!store) {
+    devTrack3("store:provider:missing");
     throw new Error(
       "StoreProvider is missing in the React tree. Wrap your app with <StoreProvider store={...}>."
     );
@@ -188,18 +296,29 @@ function StoreProvider({
   store,
   children
 }) {
+  useEffect2(() => {
+    devTrack3("store:provider:mount", { hasStore: !!store });
+    return () => devTrack3("store:provider:unmount");
+  }, [store]);
   return /* @__PURE__ */ jsx2(StoreContext.Provider, { value: store, children });
 }
 function useStore() {
   const store = useStoreInstance();
-  const [state, setState] = useState(() => store.getState());
-  useEffect(() => {
-    const unsubscribe = store.subscribe(() => {
-      setState(store.getState());
-    });
-    return unsubscribe;
-  }, [store]);
-  return state;
+  return useSyncExternalStore2(
+    (onStoreChange) => {
+      devTrack3("store:react:subscribe");
+      const unsubscribe = store.subscribe(() => {
+        devTrack3("store:react:notify");
+        onStoreChange();
+      });
+      return () => {
+        devTrack3("store:react:unsubscribe");
+        unsubscribe();
+      };
+    },
+    store.getState,
+    store.getState
+  );
 }
 function useDispatch() {
   const store = useStoreInstance();

package/dist/index.js.map

@@ -1 +1 @@
-{"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":"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","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, useEffect, useMemo } from \"react\";\nimport type { IState, IAction, Store } from \"./store.js\";\nimport { createStore } from \"./store.js\";\n\n// DEV-only tracking (no-op in production)\nconst __DEV__ = typeof process !== \"undefined\" ? process.env.NODE_ENV !== \"production\" : true;\nfunction devTrack(name: string, props?: Record<string, unknown>) {\n  if (!__DEV__) return;\n  try {\n    const t = (globalThis as any)?.track;\n    if (typeof t === \"function\") t(name, props);\n  } catch {}\n}\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    devTrack(\"scoped:batch:flush\", { size: fns.length });\n  });\n}\n\nfunction makeBatchedSubscribe(subscribe: (l: () => void) => () => void) {\n  return (onChange: () => void) => {\n    devTrack(\"scoped:sub:add\");\n    const wrapped = () => {\n      devTrack(\"scoped:notify:enqueue\");\n      enqueue(onChange);\n    };\n    const unsubscribe = subscribe(wrapped);\n    return () => {\n      devTrack(\"scoped:sub:remove\");\n      unsubscribe();\n    };\n  };\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 store = useMemo(() => {\n      const next = createStore(reducer, override ?? initialState);\n      devTrack(\"scoped:store:create\");\n      return next;\n    }, [reducer, override, initialState]);\n\n    useEffect(() => {\n      devTrack(\"scoped:provider:mount\");\n      return () => devTrack(\"scoped:provider:unmount\");\n    }, []);\n\n    return <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    devTrack(\"scoped:useStore\");\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    const lastRef = useRef<{ selected: T } | null>(null);\n\n    const getSnapshot = () => {\n      const nextSelected = selector(ctx.getState());\n      const last = lastRef.current;\n      if (last && isEqual(last.selected, nextSelected)) {\n        devTrack(\"scoped:selector:cache-hit\");\n        return last.selected;\n      }\n      devTrack(\"scoped:selector:cache-miss\");\n      lastRef.current = { selected: nextSelected };\n      return nextSelected;\n    };\n\n    const subscribe = (onChange: () => void) => {\n      devTrack(\"scoped:selector:sub:add\");\n      const unsubscribe = ctx.subscribeWithSelector(selector, (nextSelected) => {\n        const last = lastRef.current;\n        if (last && isEqual(last.selected, nextSelected)) {\n          devTrack(\"scoped:selector:skip\");\n          return;\n        }\n        lastRef.current = { selected: nextSelected };\n        devTrack(\"scoped:selector:notify\");\n        enqueue(onChange);\n      }, isEqual);\n      return () => {\n        devTrack(\"scoped:selector:sub:remove\");\n        unsubscribe();\n      };\n    };\n\n    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\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// Lightweight DEV-only tracker\nfunction devTrack(name: string, props?: Record<string, unknown>) {\n  if (!DEV) return;\n  try {\n    const t = (globalThis as any)?.track;\n    if (typeof t === \"function\") t(name, props);\n  } catch {}\n}\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    isEqual?: (a: T, b: T) => boolean\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    isEqual?: (a: T, b: T) => boolean;\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    // Track the inbound action\n    devTrack(\"store:dispatch\", { type: action?.type });\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      devTrack(\"store:no-op\", { type: action?.type });\n      return;\n    }\n\n    state = nextState;\n\n    // Compute changed keys (shallow) for diagnostics\n    let changedKeys: (keyof S)[] | undefined;\n    if (DEV) {\n      changedKeys = Object.keys(nextState as Record<string, unknown>)\n        .filter((k) => !Object.is((prevState as any)[k], (nextState as any)[k])) as (keyof S)[];\n      devTrack(\"store:state-changed\", { type: action?.type, changedKeys });\n    }\n\n    // Notify global listeners (iterate over a snapshot so unsubscribe during\n    // notify does not skip the next listener)\n    const globalSnapshot = [...listeners];\n    devTrack(\"store:notify:all\", { listeners: globalSnapshot.length });\n    let firstError: unknown;\n    for (const listener of globalSnapshot) {\n      try {\n        listener();\n      } catch (err) {\n        if (!firstError) firstError = err;\n      }\n    }\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        devTrack(\"store:notify:key\", { key: String(key), listeners: set.size });\n        for (const listener of [...set]) {\n          try {\n            listener(state[key]);\n          } catch (err) {\n            if (!firstError) firstError = err;\n          }\n        }\n      }\n    }\n\n    // Notify selector listeners only when selected value changed (Object.is)\n    let selNotifies = 0;\n    for (const entry of [...selectorListeners]) {\n      const nextValue = (entry.selector as (s: S) => unknown)(state);\n      const equal = (entry.isEqual as ((a: unknown, b: unknown) => boolean) | undefined) ?? Object.is;\n      let isSame = false;\n      try {\n        isSame = equal(entry.lastValue, nextValue);\n      } catch (err) {\n        if (!firstError) firstError = err;\n        continue;\n      }\n      if (!isSame) {\n        entry.lastValue = nextValue as unknown;\n        try {\n          (entry.listener as (v: unknown) => void)(nextValue);\n        } catch (err) {\n          if (!firstError) firstError = err;\n        }\n        selNotifies++;\n      }\n    }\n    devTrack(\"store:notify:selector\", { listeners: selNotifies });\n    if (firstError) throw firstError;\n  };\n\n  const subscribe = (listener: Listener) => {\n    listeners.add(listener);\n    devTrack(\"store:sub:all:add\", { size: listeners.size });\n    return () => {\n      listeners.delete(listener);\n      devTrack(\"store:sub:all:remove\", { size: listeners.size });\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    devTrack(\"store:sub:key:add\", { key: String(key), size: set.size });\n    return () => {\n      set.delete(listener as unknown as BivariantListener<S[keyof S]>);\n      if (set.size === 0) keyListeners.delete(key);\n      devTrack(\"store:sub:key:remove\", { key: String(key), size: set.size });\n    };\n  };\n\n  const subscribeWithSelector = <T>(\n    selector: (state: S) => T,\n    listener: (selected: T) => void,\n    isEqual?: (a: T, b: T) => boolean\n  ) => {\n    const entry: SelectorEntry<T> = {\n      selector,\n      listener: listener as BivariantListener<T>,\n      lastValue: selector(state),\n      isEqual,\n    };\n    selectorListeners.add(entry as unknown as SelectorEntry<unknown>);\n    devTrack(\"store:sub:selector:add\", { size: selectorListeners.size });\n    return () => {\n      selectorListeners.delete(entry as unknown as SelectorEntry<unknown>);\n      devTrack(\"store:sub:selector:remove\", { size: selectorListeners.size });\n    };\n  };\n\n  return {\n    getState,\n    dispatch,\n    subscribe,\n    subscribeToKey,\n    subscribeWithSelector,\n  };\n}\n","import React, { createContext, useContext, useEffect, useSyncExternalStore } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { Store, IState, IAction } from \"./store.js\";\n\n// DEV-only tracking (no-op in production)\nconst __DEV__ = typeof process !== \"undefined\" ? process.env.NODE_ENV !== \"production\" : true;\nfunction devTrack(name: string, props?: Record<string, unknown>) {\n  if (!__DEV__) return;\n  try {\n    const t = (globalThis as any)?.track;\n    if (typeof t === \"function\") t(name, props);\n  } catch {}\n}\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    devTrack(\"store:provider:missing\");\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  useEffect(() => {\n    devTrack(\"store:provider:mount\", { hasStore: !!store });\n    return () => devTrack(\"store:provider:unmount\");\n  }, [store]);\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  return useSyncExternalStore(\n    (onStoreChange) => {\n      devTrack(\"store:react:subscribe\");\n      const unsubscribe = store.subscribe(() => {\n        devTrack(\"store:react:notify\");\n        onStoreChange();\n      });\n      return () => {\n        devTrack(\"store:react:unsubscribe\");\n        unsubscribe();\n      };\n    },\n    store.getState,\n    store.getState\n  );\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":["devTrack","useStore","useDispatch","createContext","useContext","useEffect","useSyncExternalStore","jsx","__DEV__","devTrack"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/react-state",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Tiny, testable, typesafe React Scoped Store helper.",
   "keywords": [
     "react",
@@ -51,10 +51,10 @@
     "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.5.2",
+    "@types/react": "^19.1.13",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
     "@vitest/coverage-v8": "^3.2.4",
@@ -69,7 +69,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "react": "^19"
+    "react": "^18.2 || ^19"
   },
   "funding": [
     {
@@ -80,5 +80,8 @@
       "type": "github",
       "url": "https://github.com/sponsors/Plasius-LTD"
     }
-  ]
+  ],
+  "dependencies": {
+    "@plasius/nfr": "^1.0.1"
+  }
 }