@fun-tools/store 1.0.0

package/README.md

@@ -0,0 +1,437 @@
+# @ex/store
+
+> A lightweight, type-safe external store library for React, React Native, and Next.js
+
+[![npm version](https://img.shields.io/npm/v/@ex/store.svg)](https://www.npmjs.com/package/@ex/store)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## 📋 Overview
+
+`@ex/store` is a minimal yet powerful state management solution built on React's `useSyncExternalStore` API. It provides automatic handler generation, TypeScript support, and works seamlessly across React, React Native, and Next.js applications.
+
+## ✨ Features
+
+- **🎯 Type-Safe**: Full TypeScript support with intelligent type inference
+- **⚡ Lightweight**: Minimal bundle size with zero dependencies (except React peer dependency)
+- **🔄 Auto-Generated Handlers**: Automatic CRUD operations for arrays, objects, and primitives
+- **🪝 Custom Handlers**: Define your own sync and async state handlers
+- **🎨 Flexible API**: Use as a global store or scoped with React Context
+- **📦 Tree-Shakeable**: Only bundle what you use
+- **🚀 Performance Optimized**: Built-in shallow equality checks and snapshot caching
+
+## 📦 Installation
+
+```bash
+npm install @ex/store
+```
+
+```bash
+yarn add @ex/store
+```
+
+```bash
+pnpm add @ex/store
+```
+
+## 🚀 Quick Start
+
+### Basic Usage (Global Store)
+
+```tsx
+import { createStore } from "@ex/store";
+
+// Define your store
+const store = createStore({
+  states: {
+    count: 0,
+    user: { name: "John", age: 25 },
+    items: ["apple", "banana"],
+  },
+});
+
+// Use in components
+function Counter() {
+  const { count } = store.useStore((state) => ({ count: state.count }));
+  const handlers = store.useHandlers();
+
+  return (
+    <div>
+      <p>Count: {count}</p>
+      <button onClick={() => handlers.count.set((prev) => prev + 1)}>
+        Increment
+      </button>
+      <button onClick={() => handlers.count.reset()}>Reset</button>
+    </div>
+  );
+}
+```
+
+### Context-Based Store (Scoped)
+
+```tsx
+import { createStoreProvider } from "@ex/store";
+
+// Create provider
+const { Provider, useStore, useHandlers } = createStoreProvider({
+  states: {
+    theme: "light",
+    settings: { notifications: true },
+  },
+});
+
+// Wrap your app
+function App() {
+  return (
+    <Provider>
+      <ThemeToggle />
+    </Provider>
+  );
+}
+
+// Use in child components
+function ThemeToggle() {
+  const { theme } = useStore((state) => ({ theme: state.theme }));
+  const handlers = useHandlers();
+
+  return (
+    <button
+      onClick={() => handlers.theme.set(theme === "light" ? "dark" : "light")}
+    >
+      Current: {theme}
+    </button>
+  );
+}
+```
+
+## 📖 API Reference
+
+### `createStore(config)`
+
+Creates a global store instance.
+
+**Parameters:**
+
+- `states`: Initial state object
+- `syncHandlers?`: Custom synchronous handlers (optional)
+- `asyncHandlers?`: Custom asynchronous handlers (optional)
+
+**Returns:**
+
+- `useStore<T>(selector)`: Hook to select and subscribe to state
+- `useHandlers()`: Hook to access all handlers
+
+### `createStoreProvider(config)`
+
+Creates a context-based store provider.
+
+**Parameters:**
+
+- Same as `createStore`
+
+**Returns:**
+
+- `Provider`: React component to wrap your app
+- `useStore<T>(selector)`: Hook to select and subscribe to state
+- `useHandlers()`: Hook to access all handlers
+
+## 🎨 Auto-Generated Handlers
+
+The library automatically generates handlers based on your state types:
+
+### For All Types
+
+```tsx
+// Set value (supports callbacks)
+handlers.count.set(10);
+handlers.count.set((prev) => prev + 1);
+
+// Reset to initial value
+handlers.count.reset();
+```
+
+### For Arrays
+
+```tsx
+const store = createStore({
+  states: { items: ["a", "b", "c"] },
+});
+
+const handlers = store.useHandlers();
+
+// Add items
+handlers.items.push("d");
+handlers.items.unshift("z");
+
+// Remove items
+handlers.items.pop();
+handlers.items.shift();
+
+// Transform
+handlers.items.filter((item) => item !== "b");
+handlers.items.map((item) => item.toUpperCase());
+```
+
+### For Objects
+
+```tsx
+const store = createStore({
+  states: {
+    user: {
+      name: "John",
+      address: { city: "NYC", zip: "10001" },
+    },
+  },
+});
+
+const handlers = store.useHandlers();
+
+// Update single nested property
+handlers.user.update("name", "Jane");
+handlers.user.update("address.city", "LA");
+
+// Update multiple properties (deep merge)
+handlers.user.updateMany({
+  name: "Jane",
+  address: { city: "LA" },
+});
+```
+
+## 🔧 Custom Handlers
+
+### Sync Handlers
+
+```tsx
+const store = createStore({
+  states: {
+    count: 0,
+  },
+  syncHandlers: {
+    increment: (states) => {
+      states.count++;
+    },
+    incrementBy: (states, amount: number) => {
+      states.count += amount;
+    },
+  },
+});
+
+// Usage
+const handlers = store.useHandlers();
+handlers.increment(); // count + 1
+handlers.incrementBy(5); // count + 5
+```
+
+### Async Handlers
+
+```tsx
+const store = createStore({
+  states: {
+    user: null,
+    loading: false,
+  },
+  asyncHandlers: {
+    fetchUser: async (states, userId: string) => {
+      states.loading = true;
+      const response = await fetch(`/api/users/${userId}`);
+      states.user = await response.json();
+      states.loading = false;
+    },
+  },
+});
+
+// Usage
+const handlers = store.useHandlers();
+await handlers.fetchUser("123");
+```
+
+## 💡 Advanced Usage
+
+### Selective Subscriptions
+
+The `useStore` selector ensures components only re-render when selected state changes:
+
+```tsx
+// Component only re-renders when 'count' changes
+function CountDisplay() {
+  const { count } = store.useStore((state) => ({ count: state.count }));
+  return <div>{count}</div>;
+}
+
+// Component only re-renders when 'user.name' changes
+function UserName() {
+  const { name } = store.useStore((state) => ({
+    name: state.user.name,
+  }));
+  return <div>{name}</div>;
+}
+```
+
+### Multiple Stores
+
+You can create multiple independent stores:
+
+```tsx
+const authStore = createStore({
+  states: { user: null, isAuthenticated: false },
+});
+
+const cartStore = createStore({
+  states: { items: [], total: 0 },
+});
+
+function App() {
+  const { user } = authStore.useStore((state) => ({ user: state.user }));
+  const { items } = cartStore.useStore((state) => ({ items: state.items }));
+
+  // ...
+}
+```
+
+### TypeScript Type Inference
+
+The library provides full type safety with intelligent inference:
+
+```tsx
+const store = createStore({
+  states: {
+    count: 0,
+    user: { name: "John", age: 25 },
+  },
+  syncHandlers: {
+    setUserAge: (states, age: number) => {
+      states.user.age = age;
+    },
+  },
+});
+
+const handlers = store.useHandlers();
+
+// ✅ TypeScript knows the types
+handlers.count.set(10); // ✓
+handlers.user.update("name", "Jane"); // ✓
+handlers.setUserAge(30); // ✓
+
+// ❌ TypeScript catches errors
+handlers.count.set("invalid"); // Error: Argument of type 'string' is not assignable
+handlers.setUserAge("invalid"); // Error: Argument of type 'string' is not assignable
+```
+
+## 🏗️ Architecture
+
+The library uses React's `useSyncExternalStore` API for optimal performance and compatibility:
+
+- **Snapshot Caching**: Prevents unnecessary re-renders with shallow equality checks
+- **WeakMap Storage**: Efficient snapshot management with automatic garbage collection
+- **Immutable Updates**: State changes create new references for proper React updates
+- **Subscription Management**: Automatic cleanup when components unmount
+
+## 🎯 Use Cases
+
+Perfect for:
+
+- ✅ Small to medium-sized applications
+- ✅ Quick prototyping and MVPs
+- ✅ React Native mobile apps
+- ✅ Next.js applications (SSR compatible)
+- ✅ Projects needing simple global state
+- ✅ Teams wanting minimal state management setup
+
+## 📝 Examples
+
+### Todo App
+
+```tsx
+const todoStore = createStore({
+  states: {
+    todos: [] as Array<{ id: string; text: string; completed: boolean }>,
+  },
+  syncHandlers: {
+    addTodo: (states, text: string) => {
+      states.todos.push({
+        id: Date.now().toString(),
+        text,
+        completed: false,
+      });
+    },
+    toggleTodo: (states, id: string) => {
+      const todo = states.todos.find((t) => t.id === id);
+      if (todo) todo.completed = !todo.completed;
+    },
+    removeTodo: (states, id: string) => {
+      states.todos = states.todos.filter((t) => t.id !== id);
+    },
+  },
+});
+
+function TodoList() {
+  const { todos } = todoStore.useStore((state) => ({ todos: state.todos }));
+  const handlers = todoStore.useHandlers();
+
+  return (
+    <div>
+      {todos.map((todo) => (
+        <div key={todo.id}>
+          <input
+            type="checkbox"
+            checked={todo.completed}
+            onChange={() => handlers.toggleTodo(todo.id)}
+          />
+          <span
+            style={{ textDecoration: todo.completed ? "line-through" : "none" }}
+          >
+            {todo.text}
+          </span>
+          <button onClick={() => handlers.removeTodo(todo.id)}>Delete</button>
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+### Form Management
+
+```tsx
+const formStore = createStore({
+  states: {
+    formData: {
+      username: "",
+      email: "",
+      bio: "",
+    },
+    errors: {} as Record<string, string>,
+  },
+  syncHandlers: {
+    updateField: (
+      states,
+      { field, value }: { field: string; value: string }
+    ) => {
+      states.formData = { ...states.formData, [field]: value };
+    },
+    validate: (states) => {
+      const errors: Record<string, string> = {};
+      if (!states.formData.username) errors.username = "Required";
+      if (!states.formData.email.includes("@")) errors.email = "Invalid email";
+      states.errors = errors;
+    },
+  },
+});
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT © [Your Name]
+
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/yourusername/ex-store)
+- [Issues](https://github.com/yourusername/ex-store/issues)
+- [NPM Package](https://www.npmjs.com/package/@ex/store)
+
+---
+
+Made with ❤️ by developers, for developers

package/dist/index.cjs

@@ -0,0 +1,210 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createStore: () => createStore,
+  createStoreProvider: () => createStoreProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/createStore/index.ts
+var import_react = require("react");
+
+// src/createStore/utils.ts
+function cookAutoBuildHandlers(states, cb) {
+  const withCallback = (fun) => {
+    return (...args) => {
+      const val = fun(...args);
+      cb();
+      return val;
+    };
+  };
+  const defaultStates = JSON.parse(JSON.stringify(states));
+  return Object.fromEntries(
+    Object.entries(states).map(([key, val]) => {
+      const handlers = {
+        set: withCallback((action) => {
+          states[key] = typeof action === "function" ? action(states[key]) : action;
+        }),
+        reset: withCallback(() => {
+          states[key] = defaultStates[key];
+        }),
+        ...Array.isArray(val) ? {
+          push: withCallback((val2) => {
+            states[key] = [...states[key], val2];
+          }),
+          pop: withCallback(() => {
+            states[key] = states[key].slice(0, -1);
+          }),
+          shift: withCallback(() => {
+            states[key] = states[key].slice(1);
+          }),
+          unshift: withCallback((val2) => {
+            states[key] = [val2, ...states[key]];
+          }),
+          filter: withCallback((cb2) => {
+            states[key] = states[key].filter(cb2);
+          }),
+          map: withCallback((cb2) => {
+            states[key] = states[key].map(cb2);
+          })
+        } : val && typeof val === "object" ? {
+          update: withCallback((_path, val2) => {
+            let temp = states[key];
+            const path = _path.split(".");
+            const fn = (obj, index = 0) => {
+              var _a;
+              if (path.length === index) return val2;
+              const key2 = path[index];
+              return {
+                ...obj,
+                [key2]: fn((_a = obj == null ? void 0 : obj[key2]) != null ? _a : {}, index + 1)
+              };
+            };
+            states[key] = fn(states[key]);
+          }),
+          updateMany: withCallback((val2) => {
+            const fn = (target, source) => {
+              if (typeof source !== "object" || source === null) return source;
+              if (Array.isArray(source)) return source;
+              const result = { ...target };
+              for (const key2 in source) {
+                if (Object.prototype.hasOwnProperty.call(target, key2)) {
+                  result[key2] = fn(target[key2], source[key2]);
+                }
+              }
+              return result;
+            };
+            states[key] = fn(states[key], val2);
+          })
+        } : {}
+      };
+      return [key, handlers];
+    })
+  );
+}
+function shallowEqual(a, b) {
+  if (a === b) return true;
+  if (typeof a !== "object" || typeof b !== "object") return false;
+  if (Array.isArray(a) !== Array.isArray(b)) return false;
+  const key1 = Object.keys(a);
+  const key2 = Object.keys(b);
+  if (key1.length !== key2.length) return false;
+  for (let key of key1) {
+    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
+    if (!Object.is(a[key], b[key])) return false;
+  }
+  return true;
+}
+
+// src/createStore/index.ts
+function createStore({
+  states,
+  syncHandlers,
+  asyncHandlers
+}) {
+  const allHandlers = Object.freeze(
+    Object.fromEntries([
+      ...Object.entries(syncHandlers != null ? syncHandlers : {}).map(([key, cb]) => [
+        key,
+        (action) => {
+          cb(states, action);
+          notify();
+        }
+      ]),
+      ...Object.entries(asyncHandlers != null ? asyncHandlers : {}).map(([key, cb]) => [
+        key,
+        async (action) => {
+          await cb(states, action);
+          notify();
+        }
+      ]),
+      ...Object.entries(cookAutoBuildHandlers(states, notify))
+    ])
+  );
+  const consumers = /* @__PURE__ */ new Set();
+  function consume(consumer) {
+    consumers.add(consumer);
+    return () => consumers.delete(consumer);
+  }
+  function notify() {
+    consumers.forEach((con) => con());
+  }
+  const snapshotCache = /* @__PURE__ */ new WeakMap();
+  function getSnapshot(selector) {
+    const newSnapshot = selector(states);
+    const cachedSnapshot = snapshotCache.get(selector);
+    if (cachedSnapshot && shallowEqual(newSnapshot, cachedSnapshot)) {
+      return cachedSnapshot;
+    }
+    snapshotCache.set(selector, newSnapshot);
+    return Object.freeze(newSnapshot);
+  }
+  function useStore(selector) {
+    return (0, import_react.useSyncExternalStore)(
+      consume,
+      () => getSnapshot(selector),
+      () => getSnapshot(selector)
+    );
+  }
+  function useHandlers() {
+    return allHandlers;
+  }
+  return {
+    useStore,
+    useHandlers
+  };
+}
+
+// src/createStoreProvider/index.tsx
+var import_react2 = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+function createStoreProvider(props) {
+  const Context = (0, import_react2.createContext)(null);
+  function Provider({ children }) {
+    const store = (0, import_react2.useRef)(null);
+    if (!store.current) {
+      store.current = createStore(props);
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Context.Provider, { value: store.current, children });
+  }
+  function useStore(selector) {
+    const store = (0, import_react2.useContext)(Context);
+    if (!store) throw Error("Store Provider is missing !!");
+    return store.useStore(selector);
+  }
+  function useHandlers() {
+    const store = (0, import_react2.useContext)(Context);
+    if (!store) throw Error("Store Provider is missing !!");
+    return store.useHandlers();
+  }
+  return {
+    Provider,
+    useStore,
+    useHandlers
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createStore,
+  createStoreProvider
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/createStore/index.ts","../src/createStore/utils.ts","../src/createStoreProvider/index.tsx"],"sourcesContent":["export { default as createStore } from \"./createStore\";\r\nexport { default as createStoreProvider } from \"./createStoreProvider\";\r\n\r\nexport * from \"./createStore/types\";","import { useSyncExternalStore } from \"react\";\r\nimport { cookAutoBuildHandlers, shallowEqual } from \"./utils\";\r\nimport { \r\n    AsyncHandler, CreateStoreContextProps, \r\n    CreateStoreReturn, \r\n    HandlerRecord, States, SyncHandler \r\n} from \"./types\";\r\n\r\n\r\n\r\nexport default function createStore<\r\n    S extends States,\r\n    SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>,\r\n    AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>\r\n>({\r\n    states, syncHandlers, asyncHandlers\r\n}: CreateStoreContextProps<S, SH, AH>): CreateStoreReturn<S, SH, AH> {\r\n\r\n    const allHandlers: HandlerRecord<S, SH, AH> = Object.freeze(\r\n        Object.fromEntries([\r\n            ...Object.entries(syncHandlers ?? {}).map(([key, cb]) => [\r\n                key, (action?: any) => {cb(states, action); notify();}\r\n            ]),\r\n            ...Object.entries(asyncHandlers ?? {}).map(([key, cb]) => [\r\n                key, async (action?: any) => {await cb(states, action); notify();}\r\n            ]),\r\n            ...Object.entries(cookAutoBuildHandlers(states, notify))\r\n        ])\r\n    ) as HandlerRecord<S, SH, AH>\r\n\r\n\r\n    const consumers = new Set<() => void>();\r\n\r\n    \r\n    function consume(consumer: () => void) {\r\n        consumers.add(consumer);\r\n        return () => consumers.delete(consumer);\r\n    }\r\n\r\n\r\n    function notify() {\r\n        consumers.forEach(con => con());\r\n    }\r\n\r\n\r\n    const snapshotCache = new WeakMap<(state: S) => object, object>();\r\n\r\n\r\n    function getSnapshot<T extends object>(selector: (state: S) => T): T {\r\n        const newSnapshot = selector(states);\r\n        const cachedSnapshot = snapshotCache.get(selector);\r\n\r\n        if(cachedSnapshot && shallowEqual(newSnapshot, cachedSnapshot)) {\r\n            return cachedSnapshot as T;\r\n        }\r\n            \r\n        snapshotCache.set(selector, newSnapshot);\r\n        return Object.freeze(newSnapshot);\r\n    }\r\n    \r\n    \r\n    function useStore<T extends object>(selector: (state: S) => T): T {\r\n        return useSyncExternalStore(\r\n            consume,\r\n            () => getSnapshot(selector),\r\n            () => getSnapshot(selector)\r\n        )\r\n    }\r\n\r\n\r\n    function useHandlers(): HandlerRecord<S, SH, AH> {\r\n        return allHandlers;\r\n    }\r\n\r\n\r\n    return {\r\n        useStore,\r\n        useHandlers\r\n    }\r\n}","import { AutoBuildHandler, AutoBuildHandlerRecord, States } from \"./types\";\r\n\r\nexport function cookAutoBuildHandlers<S extends States>(states: S, cb: () => void): AutoBuildHandlerRecord<S> {\r\n\r\n    const withCallback = <R>(fun: (...args: any[]) => R) => {\r\n        return (...args: any[]): R => {\r\n            const val = fun(...args);\r\n            cb();\r\n            return val;\r\n        }\r\n    }\r\n\r\n\r\n    const defaultStates: S = JSON.parse(JSON.stringify(states));\r\n\r\n    \r\n    return Object.fromEntries(\r\n        Object.entries(states).map(([key, val]: [keyof S, S[keyof S]]) => {\r\n            const handlers: AutoBuildHandler<S[keyof S]> = {\r\n                set: withCallback((action) => {\r\n                    states[key] = typeof action === 'function' ? action(states[key]) : action;\r\n                }),\r\n\r\n                reset: withCallback(() => {\r\n                    states[key] = defaultStates[key];\r\n                }),\r\n                \r\n                ...(\r\n                    Array.isArray(val) ? {\r\n                        push: withCallback((val) => {\r\n                            states[key] = [...states[key], val] as S[keyof S]\r\n                        }),\r\n                        \r\n                        pop: withCallback(() => {\r\n                            states[key] = states[key].slice(0, -1)\r\n                        }),\r\n\r\n                        shift: withCallback(() => {\r\n                            states[key] = states[key].slice(1)\r\n                        }),\r\n                        \r\n                        unshift: withCallback((val) => {\r\n                            states[key] = [val, ...states[key]] as S[keyof S]\r\n                        }),\r\n\r\n                        filter: withCallback((cb) => {\r\n                            states[key] = states[key].filter(cb)\r\n                        }),\r\n\r\n                        map: withCallback((cb) => {\r\n                            states[key] = states[key].map(cb)\r\n                        })\r\n\r\n                    } : val && typeof val === \"object\" ? {\r\n                        update: withCallback((_path, val) => {\r\n                            let temp: any = states[key];\r\n                            const path = _path.split('.');\r\n\r\n                            const fn = (obj: any, index = 0): S[keyof S] => {\r\n                                if (path.length === index) return val;\r\n                                const key = path[index];\r\n\r\n                                return {\r\n                                    ...obj,\r\n                                    [key]: fn(obj?.[key] ?? {}, index + 1)\r\n                                };\r\n                            }\r\n\r\n                            states[key] = fn(states[key]);\r\n                        }),\r\n\r\n                        updateMany: withCallback((val) => {\r\n                            const fn = (target: any, source: any) => {\r\n                                if (typeof source !== \"object\" || source === null) return source;\r\n                                if (Array.isArray(source)) return source;\r\n\r\n                                const result = { ...target };\r\n\r\n                                for (const key in source) {\r\n                                    if (Object.prototype.hasOwnProperty.call(target, key)) {\r\n                                        result[key] = fn(target[key], source[key]);\r\n                                    }\r\n                                }\r\n\r\n                                return result;\r\n                            }\r\n\r\n                            states[key] = fn(states[key], val);\r\n                        })\r\n                    } : {}\r\n                )\r\n            } as unknown as AutoBuildHandler<S[keyof S]>\r\n            \r\n            return [key, handlers]\r\n        })\r\n    ) as unknown as AutoBuildHandlerRecord<S>\r\n}\r\n\r\n\r\nexport function shallowEqual(a: any, b: any) {\r\n    if(a === b) return true;\r\n    \r\n    if(typeof a !== 'object' || typeof b !== 'object') return false;\r\n\r\n    if(Array.isArray(a) !== Array.isArray(b)) return false;\r\n\r\n    const key1 = Object.keys(a);\r\n    const key2 = Object.keys(b);\r\n\r\n    if(key1.length !== key2.length) return false;\r\n\r\n    for(let key of key1) {\r\n        if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\r\n        if (!Object.is(a[key], b[key])) return false;\r\n    }\r\n\r\n    return true;\r\n}","import React, { createContext, ReactNode, useContext, useRef } from \"react\";\r\nimport createStore from \"../createStore\";\r\nimport { AsyncHandler, CreateStoreContextProps, CreateStoreReturn, HandlerRecord, States, SyncHandler } from \"../createStore/types\";\r\n\r\n\r\n\r\nexport default function createStoreProvider<\r\n    S extends States,\r\n    SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>,\r\n    AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>\r\n>(props: CreateStoreContextProps<S, SH, AH>) {    \r\n\r\n    const Context = createContext<CreateStoreReturn<S, SH, AH> | null>(null);\r\n    \r\n    function Provider({children}: {children: ReactNode}): React.JSX.Element {\r\n        const store = useRef<CreateStoreReturn<S, SH, AH> | null>(null);\r\n\r\n        if(!store.current) {\r\n            store.current = createStore(props);\r\n        }\r\n\r\n        return (\r\n            <Context.Provider value={store.current}>\r\n                {children}\r\n            </Context.Provider>\r\n        )\r\n    }\r\n\r\n    \r\n    function useStore<T extends object>(selector: (states: S) => T): T {\r\n        const store = useContext(Context);\r\n        if(!store) throw Error('Store Provider is missing !!');\r\n        return store.useStore<T>(selector);\r\n    }\r\n\r\n\r\n    function useHandlers(): HandlerRecord<S, SH, AH> {\r\n        const store = useContext(Context);\r\n        if(!store) throw Error('Store Provider is missing !!');\r\n        return store.useHandlers();\r\n    }\r\n\r\n\r\n    return {\r\n        Provider,\r\n        useStore,\r\n        useHandlers\r\n    } \r\n}"],"mappings":"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","names":["val","cb","key","import_react"]}

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+import React, { ReactNode } from 'react';
+
+type OBJECT_KEYS<T extends object> = {
+    [K in keyof T]: K extends string | number ? T[K] extends object ? K | `${K}.${OBJECT_KEYS<T[K]>}` : K : never;
+}[keyof T];
+type OBJECT_VALUE<O extends Record<string, any>, P extends string | number> = (P extends `${infer K}.${infer P}` ? K extends keyof O ? OBJECT_VALUE<O[K], P> : never : P extends keyof O ? O[P] : never);
+
+type States = Record<string, any>;
+type Action<T> = T | ((val: T) => T);
+type Handler<S, V> = (V extends (state: S) => infer R ? ((state: S) => R) : V extends (state: S, action: infer A) => infer R ? ((state: S, action: A) => R) : never);
+type SyncHandler<S> = Handler<S, (state: S, action: any) => any>;
+type AsyncHandler<S> = Handler<S, (state: S, action: any) => Promise<any>>;
+type SyncHandlerRecord<S, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>> = {
+    [K in keyof SH]: Handler<S, SH[K]>;
+};
+type AsyncHandlerRecord<S, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>> = {
+    [K in keyof AH]: Handler<S, AH[K]>;
+};
+type CreateStoreContextProps<S extends States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>> = {
+    states: S;
+    syncHandlers?: SH;
+    asyncHandlers?: AH;
+};
+type AutoBuildHandler<V> = {
+    set: (cb: Action<V>) => void;
+    reset: () => void;
+} & (V extends Array<infer T> ? {
+    push: (val: T) => void;
+    pop: () => T | null;
+    shift: () => T | null;
+    unshift: (val: T) => void;
+    filter: (cb: (item: T) => boolean) => void;
+    map: (cb: (item: T) => T) => void;
+} : V extends States ? {
+    update: (key: OBJECT_KEYS<V>, val: OBJECT_VALUE<V, OBJECT_KEYS<V>>) => void;
+    updateMany: (val: Partial<V>) => void;
+} : {});
+type AutoBuildHandlerRecord<S extends States> = {
+    [K in keyof S]: AutoBuildHandler<S[K]>;
+};
+type ExtractActionType<T> = T extends (state: States, action: infer A) => void ? A : never;
+type ReturnHandlers<S, V> = (V extends (state: S) => infer R ? (() => R) : V extends (state: S, action: infer A) => infer R ? ((action: A) => R) : never);
+type HandlerRecord<S extends States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>> = AutoBuildHandlerRecord<S> & {
+    [K in keyof SH]: ReturnHandlers<S, SH[K]>;
+} & {
+    [K in keyof AH]: ReturnHandlers<S, AH[K]>;
+};
+type CreateStoreReturn<S extends States = States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>> = {
+    useStore: <T extends object>(selector: (state: S) => T) => T;
+    useHandlers: () => HandlerRecord<S, SH, AH>;
+};
+
+declare function createStore<S extends States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>>({ states, syncHandlers, asyncHandlers }: CreateStoreContextProps<S, SH, AH>): CreateStoreReturn<S, SH, AH>;
+
+declare function createStoreProvider<S extends States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>>(props: CreateStoreContextProps<S, SH, AH>): {
+    Provider: ({ children }: {
+        children: ReactNode;
+    }) => React.JSX.Element;
+    useStore: <T extends object>(selector: (states: S) => T) => T;
+    useHandlers: () => HandlerRecord<S, SH, AH>;
+};
+
+export { type Action, type AsyncHandler, type AsyncHandlerRecord, type AutoBuildHandler, type AutoBuildHandlerRecord, type CreateStoreContextProps, type CreateStoreReturn, type ExtractActionType, type Handler, type HandlerRecord, type States, type SyncHandler, type SyncHandlerRecord, createStore, createStoreProvider };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import React, { ReactNode } from 'react';
+
+type OBJECT_KEYS<T extends object> = {
+    [K in keyof T]: K extends string | number ? T[K] extends object ? K | `${K}.${OBJECT_KEYS<T[K]>}` : K : never;
+}[keyof T];
+type OBJECT_VALUE<O extends Record<string, any>, P extends string | number> = (P extends `${infer K}.${infer P}` ? K extends keyof O ? OBJECT_VALUE<O[K], P> : never : P extends keyof O ? O[P] : never);
+
+type States = Record<string, any>;
+type Action<T> = T | ((val: T) => T);
+type Handler<S, V> = (V extends (state: S) => infer R ? ((state: S) => R) : V extends (state: S, action: infer A) => infer R ? ((state: S, action: A) => R) : never);
+type SyncHandler<S> = Handler<S, (state: S, action: any) => any>;
+type AsyncHandler<S> = Handler<S, (state: S, action: any) => Promise<any>>;
+type SyncHandlerRecord<S, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>> = {
+    [K in keyof SH]: Handler<S, SH[K]>;
+};
+type AsyncHandlerRecord<S, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>> = {
+    [K in keyof AH]: Handler<S, AH[K]>;
+};
+type CreateStoreContextProps<S extends States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>> = {
+    states: S;
+    syncHandlers?: SH;
+    asyncHandlers?: AH;
+};
+type AutoBuildHandler<V> = {
+    set: (cb: Action<V>) => void;
+    reset: () => void;
+} & (V extends Array<infer T> ? {
+    push: (val: T) => void;
+    pop: () => T | null;
+    shift: () => T | null;
+    unshift: (val: T) => void;
+    filter: (cb: (item: T) => boolean) => void;
+    map: (cb: (item: T) => T) => void;
+} : V extends States ? {
+    update: (key: OBJECT_KEYS<V>, val: OBJECT_VALUE<V, OBJECT_KEYS<V>>) => void;
+    updateMany: (val: Partial<V>) => void;
+} : {});
+type AutoBuildHandlerRecord<S extends States> = {
+    [K in keyof S]: AutoBuildHandler<S[K]>;
+};
+type ExtractActionType<T> = T extends (state: States, action: infer A) => void ? A : never;
+type ReturnHandlers<S, V> = (V extends (state: S) => infer R ? (() => R) : V extends (state: S, action: infer A) => infer R ? ((action: A) => R) : never);
+type HandlerRecord<S extends States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>> = AutoBuildHandlerRecord<S> & {
+    [K in keyof SH]: ReturnHandlers<S, SH[K]>;
+} & {
+    [K in keyof AH]: ReturnHandlers<S, AH[K]>;
+};
+type CreateStoreReturn<S extends States = States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>> = {
+    useStore: <T extends object>(selector: (state: S) => T) => T;
+    useHandlers: () => HandlerRecord<S, SH, AH>;
+};
+
+declare function createStore<S extends States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>>({ states, syncHandlers, asyncHandlers }: CreateStoreContextProps<S, SH, AH>): CreateStoreReturn<S, SH, AH>;
+
+declare function createStoreProvider<S extends States, SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>, AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>>(props: CreateStoreContextProps<S, SH, AH>): {
+    Provider: ({ children }: {
+        children: ReactNode;
+    }) => React.JSX.Element;
+    useStore: <T extends object>(selector: (states: S) => T) => T;
+    useHandlers: () => HandlerRecord<S, SH, AH>;
+};
+
+export { type Action, type AsyncHandler, type AsyncHandlerRecord, type AutoBuildHandler, type AutoBuildHandlerRecord, type CreateStoreContextProps, type CreateStoreReturn, type ExtractActionType, type Handler, type HandlerRecord, type States, type SyncHandler, type SyncHandlerRecord, createStore, createStoreProvider };

package/dist/index.js

@@ -0,0 +1,182 @@
+// src/createStore/index.ts
+import { useSyncExternalStore } from "react";
+
+// src/createStore/utils.ts
+function cookAutoBuildHandlers(states, cb) {
+  const withCallback = (fun) => {
+    return (...args) => {
+      const val = fun(...args);
+      cb();
+      return val;
+    };
+  };
+  const defaultStates = JSON.parse(JSON.stringify(states));
+  return Object.fromEntries(
+    Object.entries(states).map(([key, val]) => {
+      const handlers = {
+        set: withCallback((action) => {
+          states[key] = typeof action === "function" ? action(states[key]) : action;
+        }),
+        reset: withCallback(() => {
+          states[key] = defaultStates[key];
+        }),
+        ...Array.isArray(val) ? {
+          push: withCallback((val2) => {
+            states[key] = [...states[key], val2];
+          }),
+          pop: withCallback(() => {
+            states[key] = states[key].slice(0, -1);
+          }),
+          shift: withCallback(() => {
+            states[key] = states[key].slice(1);
+          }),
+          unshift: withCallback((val2) => {
+            states[key] = [val2, ...states[key]];
+          }),
+          filter: withCallback((cb2) => {
+            states[key] = states[key].filter(cb2);
+          }),
+          map: withCallback((cb2) => {
+            states[key] = states[key].map(cb2);
+          })
+        } : val && typeof val === "object" ? {
+          update: withCallback((_path, val2) => {
+            let temp = states[key];
+            const path = _path.split(".");
+            const fn = (obj, index = 0) => {
+              var _a;
+              if (path.length === index) return val2;
+              const key2 = path[index];
+              return {
+                ...obj,
+                [key2]: fn((_a = obj == null ? void 0 : obj[key2]) != null ? _a : {}, index + 1)
+              };
+            };
+            states[key] = fn(states[key]);
+          }),
+          updateMany: withCallback((val2) => {
+            const fn = (target, source) => {
+              if (typeof source !== "object" || source === null) return source;
+              if (Array.isArray(source)) return source;
+              const result = { ...target };
+              for (const key2 in source) {
+                if (Object.prototype.hasOwnProperty.call(target, key2)) {
+                  result[key2] = fn(target[key2], source[key2]);
+                }
+              }
+              return result;
+            };
+            states[key] = fn(states[key], val2);
+          })
+        } : {}
+      };
+      return [key, handlers];
+    })
+  );
+}
+function shallowEqual(a, b) {
+  if (a === b) return true;
+  if (typeof a !== "object" || typeof b !== "object") return false;
+  if (Array.isArray(a) !== Array.isArray(b)) return false;
+  const key1 = Object.keys(a);
+  const key2 = Object.keys(b);
+  if (key1.length !== key2.length) return false;
+  for (let key of key1) {
+    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
+    if (!Object.is(a[key], b[key])) return false;
+  }
+  return true;
+}
+
+// src/createStore/index.ts
+function createStore({
+  states,
+  syncHandlers,
+  asyncHandlers
+}) {
+  const allHandlers = Object.freeze(
+    Object.fromEntries([
+      ...Object.entries(syncHandlers != null ? syncHandlers : {}).map(([key, cb]) => [
+        key,
+        (action) => {
+          cb(states, action);
+          notify();
+        }
+      ]),
+      ...Object.entries(asyncHandlers != null ? asyncHandlers : {}).map(([key, cb]) => [
+        key,
+        async (action) => {
+          await cb(states, action);
+          notify();
+        }
+      ]),
+      ...Object.entries(cookAutoBuildHandlers(states, notify))
+    ])
+  );
+  const consumers = /* @__PURE__ */ new Set();
+  function consume(consumer) {
+    consumers.add(consumer);
+    return () => consumers.delete(consumer);
+  }
+  function notify() {
+    consumers.forEach((con) => con());
+  }
+  const snapshotCache = /* @__PURE__ */ new WeakMap();
+  function getSnapshot(selector) {
+    const newSnapshot = selector(states);
+    const cachedSnapshot = snapshotCache.get(selector);
+    if (cachedSnapshot && shallowEqual(newSnapshot, cachedSnapshot)) {
+      return cachedSnapshot;
+    }
+    snapshotCache.set(selector, newSnapshot);
+    return Object.freeze(newSnapshot);
+  }
+  function useStore(selector) {
+    return useSyncExternalStore(
+      consume,
+      () => getSnapshot(selector),
+      () => getSnapshot(selector)
+    );
+  }
+  function useHandlers() {
+    return allHandlers;
+  }
+  return {
+    useStore,
+    useHandlers
+  };
+}
+
+// src/createStoreProvider/index.tsx
+import { createContext, useContext, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+function createStoreProvider(props) {
+  const Context = createContext(null);
+  function Provider({ children }) {
+    const store = useRef(null);
+    if (!store.current) {
+      store.current = createStore(props);
+    }
+    return /* @__PURE__ */ jsx(Context.Provider, { value: store.current, children });
+  }
+  function useStore(selector) {
+    const store = useContext(Context);
+    if (!store) throw Error("Store Provider is missing !!");
+    return store.useStore(selector);
+  }
+  function useHandlers() {
+    const store = useContext(Context);
+    if (!store) throw Error("Store Provider is missing !!");
+    return store.useHandlers();
+  }
+  return {
+    Provider,
+    useStore,
+    useHandlers
+  };
+}
+export {
+  createStore,
+  createStoreProvider
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/createStore/index.ts","../src/createStore/utils.ts","../src/createStoreProvider/index.tsx"],"sourcesContent":["import { useSyncExternalStore } from \"react\";\r\nimport { cookAutoBuildHandlers, shallowEqual } from \"./utils\";\r\nimport { \r\n    AsyncHandler, CreateStoreContextProps, \r\n    CreateStoreReturn, \r\n    HandlerRecord, States, SyncHandler \r\n} from \"./types\";\r\n\r\n\r\n\r\nexport default function createStore<\r\n    S extends States,\r\n    SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>,\r\n    AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>\r\n>({\r\n    states, syncHandlers, asyncHandlers\r\n}: CreateStoreContextProps<S, SH, AH>): CreateStoreReturn<S, SH, AH> {\r\n\r\n    const allHandlers: HandlerRecord<S, SH, AH> = Object.freeze(\r\n        Object.fromEntries([\r\n            ...Object.entries(syncHandlers ?? {}).map(([key, cb]) => [\r\n                key, (action?: any) => {cb(states, action); notify();}\r\n            ]),\r\n            ...Object.entries(asyncHandlers ?? {}).map(([key, cb]) => [\r\n                key, async (action?: any) => {await cb(states, action); notify();}\r\n            ]),\r\n            ...Object.entries(cookAutoBuildHandlers(states, notify))\r\n        ])\r\n    ) as HandlerRecord<S, SH, AH>\r\n\r\n\r\n    const consumers = new Set<() => void>();\r\n\r\n    \r\n    function consume(consumer: () => void) {\r\n        consumers.add(consumer);\r\n        return () => consumers.delete(consumer);\r\n    }\r\n\r\n\r\n    function notify() {\r\n        consumers.forEach(con => con());\r\n    }\r\n\r\n\r\n    const snapshotCache = new WeakMap<(state: S) => object, object>();\r\n\r\n\r\n    function getSnapshot<T extends object>(selector: (state: S) => T): T {\r\n        const newSnapshot = selector(states);\r\n        const cachedSnapshot = snapshotCache.get(selector);\r\n\r\n        if(cachedSnapshot && shallowEqual(newSnapshot, cachedSnapshot)) {\r\n            return cachedSnapshot as T;\r\n        }\r\n            \r\n        snapshotCache.set(selector, newSnapshot);\r\n        return Object.freeze(newSnapshot);\r\n    }\r\n    \r\n    \r\n    function useStore<T extends object>(selector: (state: S) => T): T {\r\n        return useSyncExternalStore(\r\n            consume,\r\n            () => getSnapshot(selector),\r\n            () => getSnapshot(selector)\r\n        )\r\n    }\r\n\r\n\r\n    function useHandlers(): HandlerRecord<S, SH, AH> {\r\n        return allHandlers;\r\n    }\r\n\r\n\r\n    return {\r\n        useStore,\r\n        useHandlers\r\n    }\r\n}","import { AutoBuildHandler, AutoBuildHandlerRecord, States } from \"./types\";\r\n\r\nexport function cookAutoBuildHandlers<S extends States>(states: S, cb: () => void): AutoBuildHandlerRecord<S> {\r\n\r\n    const withCallback = <R>(fun: (...args: any[]) => R) => {\r\n        return (...args: any[]): R => {\r\n            const val = fun(...args);\r\n            cb();\r\n            return val;\r\n        }\r\n    }\r\n\r\n\r\n    const defaultStates: S = JSON.parse(JSON.stringify(states));\r\n\r\n    \r\n    return Object.fromEntries(\r\n        Object.entries(states).map(([key, val]: [keyof S, S[keyof S]]) => {\r\n            const handlers: AutoBuildHandler<S[keyof S]> = {\r\n                set: withCallback((action) => {\r\n                    states[key] = typeof action === 'function' ? action(states[key]) : action;\r\n                }),\r\n\r\n                reset: withCallback(() => {\r\n                    states[key] = defaultStates[key];\r\n                }),\r\n                \r\n                ...(\r\n                    Array.isArray(val) ? {\r\n                        push: withCallback((val) => {\r\n                            states[key] = [...states[key], val] as S[keyof S]\r\n                        }),\r\n                        \r\n                        pop: withCallback(() => {\r\n                            states[key] = states[key].slice(0, -1)\r\n                        }),\r\n\r\n                        shift: withCallback(() => {\r\n                            states[key] = states[key].slice(1)\r\n                        }),\r\n                        \r\n                        unshift: withCallback((val) => {\r\n                            states[key] = [val, ...states[key]] as S[keyof S]\r\n                        }),\r\n\r\n                        filter: withCallback((cb) => {\r\n                            states[key] = states[key].filter(cb)\r\n                        }),\r\n\r\n                        map: withCallback((cb) => {\r\n                            states[key] = states[key].map(cb)\r\n                        })\r\n\r\n                    } : val && typeof val === \"object\" ? {\r\n                        update: withCallback((_path, val) => {\r\n                            let temp: any = states[key];\r\n                            const path = _path.split('.');\r\n\r\n                            const fn = (obj: any, index = 0): S[keyof S] => {\r\n                                if (path.length === index) return val;\r\n                                const key = path[index];\r\n\r\n                                return {\r\n                                    ...obj,\r\n                                    [key]: fn(obj?.[key] ?? {}, index + 1)\r\n                                };\r\n                            }\r\n\r\n                            states[key] = fn(states[key]);\r\n                        }),\r\n\r\n                        updateMany: withCallback((val) => {\r\n                            const fn = (target: any, source: any) => {\r\n                                if (typeof source !== \"object\" || source === null) return source;\r\n                                if (Array.isArray(source)) return source;\r\n\r\n                                const result = { ...target };\r\n\r\n                                for (const key in source) {\r\n                                    if (Object.prototype.hasOwnProperty.call(target, key)) {\r\n                                        result[key] = fn(target[key], source[key]);\r\n                                    }\r\n                                }\r\n\r\n                                return result;\r\n                            }\r\n\r\n                            states[key] = fn(states[key], val);\r\n                        })\r\n                    } : {}\r\n                )\r\n            } as unknown as AutoBuildHandler<S[keyof S]>\r\n            \r\n            return [key, handlers]\r\n        })\r\n    ) as unknown as AutoBuildHandlerRecord<S>\r\n}\r\n\r\n\r\nexport function shallowEqual(a: any, b: any) {\r\n    if(a === b) return true;\r\n    \r\n    if(typeof a !== 'object' || typeof b !== 'object') return false;\r\n\r\n    if(Array.isArray(a) !== Array.isArray(b)) return false;\r\n\r\n    const key1 = Object.keys(a);\r\n    const key2 = Object.keys(b);\r\n\r\n    if(key1.length !== key2.length) return false;\r\n\r\n    for(let key of key1) {\r\n        if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\r\n        if (!Object.is(a[key], b[key])) return false;\r\n    }\r\n\r\n    return true;\r\n}","import React, { createContext, ReactNode, useContext, useRef } from \"react\";\r\nimport createStore from \"../createStore\";\r\nimport { AsyncHandler, CreateStoreContextProps, CreateStoreReturn, HandlerRecord, States, SyncHandler } from \"../createStore/types\";\r\n\r\n\r\n\r\nexport default function createStoreProvider<\r\n    S extends States,\r\n    SH extends Record<string, SyncHandler<S>> = Record<string, SyncHandler<S>>,\r\n    AH extends Record<string, AsyncHandler<S>> = Record<string, AsyncHandler<S>>\r\n>(props: CreateStoreContextProps<S, SH, AH>) {    \r\n\r\n    const Context = createContext<CreateStoreReturn<S, SH, AH> | null>(null);\r\n    \r\n    function Provider({children}: {children: ReactNode}): React.JSX.Element {\r\n        const store = useRef<CreateStoreReturn<S, SH, AH> | null>(null);\r\n\r\n        if(!store.current) {\r\n            store.current = createStore(props);\r\n        }\r\n\r\n        return (\r\n            <Context.Provider value={store.current}>\r\n                {children}\r\n            </Context.Provider>\r\n        )\r\n    }\r\n\r\n    \r\n    function useStore<T extends object>(selector: (states: S) => T): T {\r\n        const store = useContext(Context);\r\n        if(!store) throw Error('Store Provider is missing !!');\r\n        return store.useStore<T>(selector);\r\n    }\r\n\r\n\r\n    function useHandlers(): HandlerRecord<S, SH, AH> {\r\n        const store = useContext(Context);\r\n        if(!store) throw Error('Store Provider is missing !!');\r\n        return store.useHandlers();\r\n    }\r\n\r\n\r\n    return {\r\n        Provider,\r\n        useStore,\r\n        useHandlers\r\n    } \r\n}"],"mappings":"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","names":["val","cb","key"]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@fun-tools/store",
+  "version": "1.0.0",
+  "description": "Lightweight external store for React, React Native and Next.js",
+  "author": "Mustak Khan",
+  "license": "MIT",
+
+  "type": "module",
+
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+
+  "files": ["dist"],
+
+  "peerDependencies": {
+    "react": ">=18"
+  },
+
+  "devDependencies": {
+    "@types/react": "^19.2.7",
+    "eslint": "^9.39.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  }
+}