pocket-state 0.1.9 → 0.1.11

package/README.md

@@ -14,6 +14,7 @@ Works seamlessly **inside React** with hooks or **outside React** with a simple
 - 🔌 Framework-agnostic – Works in plain TS/JS and React.
 - 🛠 Middleware – Logging, persistence, batching, devtools bridges, etc.
 - 🔔 Event Emitter – Subscribe to store and custom events.
+- ⚖️ EqualityFn – Custom comparator (shallow by default, can use deep/custom).
 - ✅ TypeScript-first – Fully type-safe.
 
 ---
@@ -183,17 +184,33 @@ export function CounterComponent() {
 
 ---
 
-## 🎯 Selectors
+## ⚖️ EqualityFn
 
-Selectors let you subscribe to **just part of the state**.
+By default, `createStore` uses a shallow equality function to detect changes.  
+You can override this by providing a custom comparator as the 3rd argument:
 
-```tsx
-function FlagDisplay() {
-  const flag = useStore(counterStore, s => s.flag);
-  return <Text>Flag is {flag ? 'ON' : 'OFF'}</Text>;
+```ts
+import {createStore} from 'pocket-state';
+import deepEqual from 'fast-deep-equal';
+
+interface State {
+  count: number;
+  nested: {a: number; b: number};
 }
+
+// shallow equality (default)
+const store1 = createStore<State>({count: 0, nested: {a: 1, b: 2}});
+
+// deep equality
+const store2 = createStore<State>(
+  {count: 0, nested: {a: 1, b: 2}},
+  [],
+  deepEqual,
+);
 ```
 
+This is useful when working with nested state objects and you want to avoid unnecessary re-renders.
+
 ---
 
 ## 🧩 API Reference
@@ -224,6 +241,6 @@ Generates a custom hook for your store.
 
 ## 📜 License
 
-MIT — use it however you like.
+MIT
 
-keywords: pocket-state, state-management, react, react-native, typescript, hooks, store
+keywords: pocket-state, state-management, react, react-native, typescript, hooks, store, equalityFn

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pocket-state",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "tiny global store",
   "main": "src/index",
   "codegenConfig": {

package/src/globalState/store.ts

@@ -10,7 +10,12 @@ export function createStore<T>(
   equalityFn?: (a: any, b: any) => boolean,
 ): Store<T> {
   const emitter: IEventEmitter = new EventEmitter();
-  let state = initialState;
+  const _initialState = Array.isArray(initialState)
+    ? (initialState as any).slice()
+    : initialState && typeof initialState === 'object'
+    ? {...initialState}
+    : initialState;
+  let state = _initialState;
 
   const areEqual = equalityFn ?? shallow;
 
@@ -35,7 +40,7 @@ export function createStore<T>(
   );
 
   const getValue = ((key?: keyof T) => {
-    if (!key) return state;
+    if (key === undefined) return state;
     return state[key];
   }) as UseStoreGet<T>;
 
@@ -70,18 +75,20 @@ export function createStore<T>(
   function setValue(
     patch: Partial<T> | ((state: T) => Partial<T> | Promise<Partial<T>>),
   ): void {
-    (async () => {
-      try {
-        const resolved =
-          typeof patch === 'function' ? await patch(state) : patch;
-
-        if (resolved && typeof resolved === 'object') {
-          setFn(resolved as Partial<T>);
-        }
-      } catch (error) {
-        console.warn('[store.setValue] patch error:', error);
+    let resolved = typeof patch === 'function' ? patch(state) : patch;
+    if (resolved instanceof Promise) {
+      resolved
+        .then(res => {
+          if (res && typeof res === 'object') {
+            setFn(res as Partial<T>);
+          }
+        })
+        .catch(error => console.warn('[store.setValue] patch error:', error));
+    } else {
+      if (resolved && typeof resolved === 'object') {
+        setFn(resolved as Partial<T>);
       }
-    })();
+    }
   }
 
   function setImmer(updater: (draft: Draft<T>) => void): void {
@@ -95,17 +102,17 @@ export function createStore<T>(
       }
       const delta = {} as Partial<T>;
       let changed = false;
-      for (const k in nextState) {
-        const nv = nextState[k];
-        const ov = state[k];
+      for (const k in nextState as any) {
+        const nv = (nextState as any)[k];
+        const ov = (state as any)[k];
         if (nv !== ov) {
-          delta[k] = nv;
+          (delta as any)[k] = nv;
           changed = true;
         }
       }
-      for (const k in state) {
+      for (const k in state as any) {
         if (!(k in (nextState as any))) {
-          delta[k] = undefined;
+          (delta as any)[k] = undefined;
           changed = true;
         }
       }
@@ -150,22 +157,23 @@ export function createStore<T>(
   }
 
   function getInitialValue(): T {
-    if (Array.isArray(state)) {
-      return (state as any).slice();
+    if (Array.isArray(_initialState)) {
+      return (_initialState as any).slice();
     }
-    if (state && typeof state === 'object') {
-      return {...state};
+    if (_initialState && typeof _initialState === 'object') {
+      return {..._initialState};
     }
-    return state;
+    return _initialState;
   }
 
   function isDirty() {
-    return !areEqual(state, initialState);
+    return !areEqual(state, _initialState);
   }
 
   function getNumberOfSubscriber() {
     return emitter.getNumberOfSubscriber();
   }
+
   return {
     getValue,
     getInitialValue,