@pitboxdev/dynamic-store-zustand 0.0.2 → 0.0.3

package/README.md

@@ -26,33 +26,42 @@
 
 ---
 
-## Features
+## ⚡ Features
 
-- ✨ **Zero Boilerplate:** No more complex setups or switch-statements.
+- 🛠️ **DX First (Zero Boilerplate):** Extremely simple API without boilerplate, keeping the standard React `useState` ergonomics.
 - 🧹 **Auto-Cleanup:** Built-in hooks for automatic store resets on unmount.
+- ⚡ **High Performance:** Subscription-free hooks available (`useDynamicStoreMethods`) to read and update state without component re-renders.
 - 🔄 **Functional Updaters:** Handles race conditions naturally with `setData(prev => ...)`.
-- 🛡️ **Fully Typed:** Inferred TypeScript definitions out of the box with strict mode support.
+- 🛡️ **100% Type-safe:** Written in TypeScript with pristine type inference and autocomplete out of the box.
 - 🪶 **Tiny Footprint:** Minimal addition to your bundle size.
 
 ---
 
+## ❓ Motivation
+
+Modern frontend applications often suffer from state management boilerplate and bloated global stores. Setting up stores usually requires defining schemas upfront, creating actions, and wiring things together.
+
+The main motivation behind this package is to **drastically reduce boilerplate and simplify store management for maximum efficiency**.
+
+Whether you need to generate stores dynamically on the fly or just want the simplicity of `useState` with the power of a scalable global store, this API delivers a seamless, hassle-free experience.
+
+---
+
 ## Table of Contents
 
-- [Features](#features)
+- [⚡ Features](#-features)
+- [❓ Motivation](#-motivation)
 - [Overview](#overview)
 - [Installation](#installation)
-- [API 1 — `createDynamicStore`](#api-1--createdynamicstore)
+- [`useDynamicStore`](#usedynamicstore)
   - [Quick Start](#quick-start)
-  - [Outside React](#outside-react)
-  - [TypeScript](#typescript)
-- [API 2 — `useDynamicStore`](#api-2--usedynamicstore)
-  - [Quick Start](#quick-start-1)
   - [Functional updater (`setData`)](#functional-updater-setdata)
-  - [Auto-cleanup with `useDynamicStoreWithCleanup`](#auto-cleanup-with-usedynamicstorewithcleanup)
-  - [Imperative helpers (outside React)](#imperative-helpers-outside-react)
-  - [Config options](#config-options)
-  - [TypeScript](#typescript-1)
-- [When to use which API](#when-to-use-which-api)
+  - [Examples](#examples)
+- [`useDynamicStoreWithCleanup`](#usedynamicstorewithcleanup)
+- [`useDynamicStoreMethods` (No Subscription)](#usedynamicstoremethods-no-subscription)
+- [Imperative helpers (outside React)](#imperative-helpers-outside-react)
+- [Config options](#config-options)
+- [TypeScript](#typescript)
 - [Full API Reference](#full-api-reference)
 - [Contributing](#contributing)
 - [License](#license)
@@ -61,17 +70,15 @@
 
 ## Overview
 
-The package ships **two independent APIs** that can be used separately or together:
+`@pitboxdev/dynamic-store-zustand` provides dynamic store management for React applications. It is built on top of [Zustand](https://github.com/pmndrs/zustand) and exposes a hook API that feels exactly like React's `useState`, with the addition that stores are stored globally in a single shared registry keyed by a string `storeId`.
 
-| | `createDynamicStore` | `useDynamicStore` |
-|---|---|---|
-| Style | Factory function | React hook |
-| Stores | One Zustand store per call | All stores live in a single registry |
-| Actions | Explicit, typed | Implicit via `setData` |
-| Functional updater | Via `set((s) => …)` in actions | Built-in `setData((prev) => …)` |
-| Auto-cleanup | — | `useDynamicStoreWithCleanup` |
-| Navigation persistence | — | `persistOnNavigation` config flag |
-| Best for | Permanent, feature-level stores | Page/form/modal scoped state |
+| Feature | Description |
+|---|---|
+| **Dynamic initialization** | Stores are initialized just-in-time when the hook mounts |
+| **useState-like API** | `setData(obj)` or `setData((prev) => update)` |
+| **Auto-cleanup** | `useDynamicStoreWithCleanup` resets state on unmount |
+| **Navigation reset** | Non-persistent stores reset via imperative API on route changes |
+| **Imperative helpers** | Modify and reset stores outside React components |
 
 ---
 
@@ -89,99 +96,7 @@ pnpm add @pitboxdev/dynamic-store-zustand zustand
 
 ---
 
-## API 1 — `createDynamicStore`
-
-A factory function that creates a standalone, fully typed Zustand store from a configuration object with explicit actions.
-
-### Quick Start
-
-```tsx
-import { createDynamicStore } from "@pitboxdev/dynamic-store-zustand";
-
-const { useStore } = createDynamicStore({
-  initialState: { count: 0 },
-  actions: (set) => ({
-    increment: () => set((s) => ({ count: s.count + 1 })),
-    decrement: () => set((s) => ({ count: s.count - 1 })),
-    reset: () => set({ count: 0 }),
-  }),
-});
-
-function Counter() {
-  const count = useStore((s) => s.count);
-  const { increment, decrement, reset } = useStore();
-
-  return (
-    <div>
-      <button onClick={decrement}>-</button>
-      <span>{count}</span>
-      <button onClick={increment}>+</button>
-      <button onClick={reset}>Reset</button>
-    </div>
-  );
-}
-```
-
-### Outside React
-
-```ts
-const { store } = createDynamicStore({ initialState: { count: 0 }, actions: (set) => ({
-  increment: () => set((s) => ({ count: s.count + 1 })),
-}) });
-
-// Read
-const count = store.getState().count;
-
-// Write
-store.setState({ count: 42 });
-
-// Subscribe
-const unsub = store.subscribe((state) => console.log(state.count));
-unsub();
-```
-
-### TypeScript
-
-All types are inferred automatically. You can also define them explicitly:
-
-```ts
-import {
-  createDynamicStore,
-  type DynamicStoreConfig,
-} from "@pitboxdev/dynamic-store-zustand";
-
-interface CounterState { count: number }
-interface CounterActions {
-  increment: () => void;
-  decrement: () => void;
-  reset: () => void;
-}
-
-const config: DynamicStoreConfig<CounterState, CounterActions> = {
-  initialState: { count: 0 },
-  actions: (set) => ({
-    increment: () => set((s) => ({ count: s.count + 1 })),
-    decrement: () => set((s) => ({ count: s.count - 1 })),
-    reset: () => set({ count: 0 }),
-  }),
-};
-
-const { useStore, store } = createDynamicStore(config);
-```
-
-Using multiple selectors with shallow equality:
-
-```ts
-import { useShallow } from "zustand/react/shallow";
-
-const { count, increment } = useStore(
-  useShallow((s) => ({ count: s.count, increment: s.increment }))
-);
-```
-
----
-
-## API 2 — `useDynamicStore`
+## `useDynamicStore`
 
 A hook that stores state in a single shared registry keyed by a string `storeId`. `setData` works exactly like React's `useState` setter — it accepts either a partial object or a function that receives the previous state.
 
@@ -250,6 +165,8 @@ setData((prev) => ({ value: prev.value + 1 }));
 
 Always prefer the functional form when the new state depends on the old state.
 
+### Examples
+
 #### Todo list example
 
 ```tsx
@@ -320,7 +237,9 @@ function Cart() {
 }
 ```
 
-### Auto-cleanup with `useDynamicStoreWithCleanup`
+---
+
+## `useDynamicStoreWithCleanup`
 
 `useDynamicStoreWithCleanup` works identically to `useDynamicStore` but resets the store when the component unmounts — useful for modal dialogs, wizard steps, or edit forms.
 
@@ -337,7 +256,41 @@ function EditModal() {
 }
 ```
 
-### Imperative helpers (outside React)
+---
+
+## `useDynamicStoreMethods` (No Subscription)
+
+If you need to update or read the store **without subscribing to its changes** (to avoid component re-renders), you can use `useDynamicStoreMethods`:
+
+```tsx
+import { useDynamicStoreMethods } from "@pitboxdev/dynamic-store-zustand";
+
+function Controls() {
+  // This component will NOT re-render when 'counter' state changes!
+  const { setData, reset, get } = useDynamicStoreMethods<CounterState>("counter");
+
+  const increment = () => {
+    // Both forms work just like in the regular hook:
+    setData((prev) => ({ value: prev.value + 1 }));
+  };
+
+  const logCurrent = () => {
+    console.log("Current state:", get()); // Get current state without subscribing
+  };
+
+  return (
+    <div>
+      <button onClick={increment}>Increment</button>
+      <button onClick={logCurrent}>Log State</button>
+      <button onClick={reset}>Reset</button>
+    </div>
+  );
+}
+```
+
+---
+
+## Imperative helpers (outside React)
 
 All helpers call into the shared manager directly — no hook required.
 
@@ -362,7 +315,9 @@ resetAllDynamicStores();
 resetNonPersistentDynamicStores();
 ```
 
-### Config options
+---
+
+## Config options
 
 | Option | Type | Default | Description |
 |---|---|---|---|
@@ -370,7 +325,9 @@ resetNonPersistentDynamicStores();
 | `persistOnNavigation` | `boolean` | `false` | Skip reset when `resetNonPersistentDynamicStores()` is called |
 | `resetOnUnmount` | `boolean` | `false` | Auto-reset when the component unmounts (`useDynamicStoreWithCleanup` only) |
 
-### TypeScript
+---
+
+## TypeScript
 
 ```ts
 import {
@@ -413,56 +370,8 @@ function RegistrationForm() {
 
 ---
 
-## When to use which API
-
-### Use `createDynamicStore` when you need:
-
-- A **permanent, feature-level store** (auth, theme, user profile, global UI)
-- **Explicit, named actions** that encapsulate business logic
-- **Fine-grained selectors** and subscriptions outside React
-- The full Zustand API (middleware, persist, devtools, subscribe)
-
-```ts
-// auth.store.ts
-export const { useStore: useAuthStore, store: authStore } = createDynamicStore({
-  initialState: { user: null as User | null, token: "" },
-  actions: (set) => ({
-    login: (user: User, token: string) => set({ user, token }),
-    logout: () => set({ user: null, token: "" }),
-  }),
-});
-```
-
-### Use `useDynamicStore` when you need:
-
-- **Page / route / modal scoped state** with optional auto-cleanup
-- **useState-like ergonomics** without boilerplate action definitions
-- **Multiple stores** managed centrally with shared reset helpers
-- Quick iteration when action interfaces aren't stable yet
-
-```tsx
-// Inside a wizard step component
-const { data, setData } = useDynamicStoreWithCleanup<StepState>(
-  "wizard-step-2",
-  { initialState: { selection: null }, resetOnUnmount: true }
-);
-```
-
----
-
 ## Full API Reference
 
-### `createDynamicStore(config)`
-
-| Parameter | Type | Description |
-|---|---|---|
-| `config.initialState` | `TState` | Plain object representing the initial state |
-| `config.actions` | `(set, get) => TActions` | Factory that returns named action implementations |
-
-Returns `{ useStore, store }`.
-
----
-
 ### `useDynamicStore<T>(storeId, config?)`
 
 | Parameter | Type | Description |
@@ -480,11 +389,18 @@ Same signature as `useDynamicStore`. Calls `reset()` on component unmount when `
 
 ---
 
+### `useDynamicStoreMethods<T>(storeId, config?)`
+
+Returns `{ setData, reset, get }` bound to the store, without subscribing the component to state changes.
+
+---
+
 ### Imperative helpers
 
 | Function | Signature | Description |
 |---|---|---|
 | `updateDynamicStore` | `(storeId, data) => void` | Merge data into a store from outside React |
+| `getDynamicStoreData` | `(storeId) => T \| undefined` | Retrieve a store's current state from outside React |
 | `resetDynamicStore` | `(storeId) => void` | Reset one store to its `initialState` |
 | `resetAllDynamicStores` | `() => void` | Reset every registered store |
 | `resetNonPersistentDynamicStores` | `() => void` | Reset stores where `persistOnNavigation` is not `true` |
@@ -496,14 +412,11 @@ Same signature as `useDynamicStore`. Calls `reset()` on component unmount when `
 | Type | Description |
 |---|---|
 | `StoreState` | `Record<string, unknown>` — base constraint for state objects |
-| `StoreActions` | `Record<string, (...args) => unknown>` — base constraint for action maps |
-| `DynamicStoreConfig<TState, TActions>` | Config type for `createDynamicStore` |
-| `DynamicStore<TState, TActions>` | Return type of `createDynamicStore` |
-| `StoreSlice<TState, TActions>` | Merged state + actions type |
 | `StoreConfig<T>` | Config type for `useDynamicStore` |
 | `SetStateAction<T>` | `Partial<T> \| ((prev: T) => Partial<T>)` — setter argument type |
 | `DynamicStoreRegistry` | Internal registry entry (advanced use) |
 | `UseDynamicStoreReturn<T>` | Return type of `useDynamicStore` |
+| `UseDynamicStoreMethodsReturn<T>` | Return type of `useDynamicStoreMethods` |
 
 ---
 

package/dist/index.d.mts

@@ -1,5 +1,3 @@
-import { UseBoundStore, StoreApi } from 'zustand';
-
 /**
  * Updater argument for setData — either a partial object or a function
  * that receives the previous state and returns a partial object.
@@ -30,55 +28,23 @@ interface DynamicStoreRegistry {
  * Keys are strings, values can be anything.
  */
 type StoreState = Record<string, unknown>;
-/**
- * Actions are functions attached to the store.
- */
-type StoreActions = Record<string, (...args: unknown[]) => unknown>;
-/**
- * Full store slice = state + actions.
- */
-type StoreSlice<TState extends StoreState = StoreState, TActions extends StoreActions = StoreActions> = TState & TActions;
-/**
- * Configuration object passed to createDynamicStore.
- */
-interface DynamicStoreConfig<TState extends StoreState, TActions extends StoreActions> {
-    /** Initial state values */
-    initialState: TState;
-    /** Factory that receives `set` and `get` and returns action implementations */
-    actions: (set: StoreApi<StoreSlice<TState, TActions>>["setState"], get: StoreApi<StoreSlice<TState, TActions>>["getState"]) => TActions;
-}
-/**
- * The return type of createDynamicStore.
- */
-interface DynamicStore<TState extends StoreState, TActions extends StoreActions> {
-    /** Zustand React hook */
-    useStore: UseBoundStore<StoreApi<StoreSlice<TState, TActions>>>;
-    /** Direct access to the underlying Zustand store API */
-    store: StoreApi<StoreSlice<TState, TActions>>;
-}
-
-/**
- * Creates a dynamic Zustand store from a configuration object.
- *
- * @example
- * ```ts
- * const { useStore } = createDynamicStore({
- *   initialState: { count: 0 },
- *   actions: (set) => ({
- *     increment: () => set((s) => ({ count: s.count + 1 })),
- *     decrement: () => set((s) => ({ count: s.count - 1 })),
- *     reset: () => set({ count: 0 }),
- *   }),
- * });
- * ```
- */
-declare function createDynamicStore<TState extends StoreState, TActions extends StoreActions>(config: DynamicStoreConfig<TState, TActions>): DynamicStore<TState, TActions>;
 
+interface UseDynamicStoreMethodsReturn<T extends StoreState> {
+    setData: (updater: SetStateAction<T>) => void;
+    reset: () => void;
+    get: () => T;
+}
 interface UseDynamicStoreReturn<T extends StoreState> {
     data: T;
     setData: (updater: SetStateAction<T>) => void;
     reset: () => void;
 }
+/**
+ * Hook that returns store methods (setData, reset, get) WITHOUT subscribing
+ * to state changes. Useful when you only need to update or read the store
+ * imperatively without causing component re-renders.
+ */
+declare function useDynamicStoreMethods<T extends StoreState>(storeId: string, config?: StoreConfig<T>): UseDynamicStoreMethodsReturn<T>;
 /**
  * Hook-based dynamic store keyed by `storeId`.
  *
@@ -117,6 +83,11 @@ declare function useDynamicStoreWithCleanup<T extends StoreState>(storeId: strin
  * Update a dynamic store from outside a React component.
  */
 declare const updateDynamicStore: (storeId: string, data: StoreState) => void;
+/**
+ * Retrieve the current state of a dynamic store from outside a React component.
+ * Fallbacks to empty object if store does not exist.
+ */
+declare const getDynamicStoreData: <T extends StoreState = StoreState>(storeId: string) => T | undefined;
 /**
  * Reset a single dynamic store to its initial state from outside React.
  */
@@ -130,4 +101,4 @@ declare const resetAllDynamicStores: () => void;
  */
 declare const resetNonPersistentDynamicStores: () => void;
 
-export { type DynamicStore, type DynamicStoreConfig, type DynamicStoreRegistry, type SetStateAction, type StoreActions, type StoreConfig, type StoreSlice, type StoreState, type UseDynamicStoreReturn, createDynamicStore, resetAllDynamicStores, resetDynamicStore, resetNonPersistentDynamicStores, updateDynamicStore, useDynamicStore, useDynamicStoreWithCleanup };
+export { type DynamicStoreRegistry, type SetStateAction, type StoreConfig, type UseDynamicStoreMethodsReturn, type UseDynamicStoreReturn, getDynamicStoreData, resetAllDynamicStores, resetDynamicStore, resetNonPersistentDynamicStores, updateDynamicStore, useDynamicStore, useDynamicStoreMethods, useDynamicStoreWithCleanup };

package/dist/index.d.ts

@@ -1,5 +1,3 @@
-import { UseBoundStore, StoreApi } from 'zustand';
-
 /**
  * Updater argument for setData — either a partial object or a function
  * that receives the previous state and returns a partial object.
@@ -30,55 +28,23 @@ interface DynamicStoreRegistry {
  * Keys are strings, values can be anything.
  */
 type StoreState = Record<string, unknown>;
-/**
- * Actions are functions attached to the store.
- */
-type StoreActions = Record<string, (...args: unknown[]) => unknown>;
-/**
- * Full store slice = state + actions.
- */
-type StoreSlice<TState extends StoreState = StoreState, TActions extends StoreActions = StoreActions> = TState & TActions;
-/**
- * Configuration object passed to createDynamicStore.
- */
-interface DynamicStoreConfig<TState extends StoreState, TActions extends StoreActions> {
-    /** Initial state values */
-    initialState: TState;
-    /** Factory that receives `set` and `get` and returns action implementations */
-    actions: (set: StoreApi<StoreSlice<TState, TActions>>["setState"], get: StoreApi<StoreSlice<TState, TActions>>["getState"]) => TActions;
-}
-/**
- * The return type of createDynamicStore.
- */
-interface DynamicStore<TState extends StoreState, TActions extends StoreActions> {
-    /** Zustand React hook */
-    useStore: UseBoundStore<StoreApi<StoreSlice<TState, TActions>>>;
-    /** Direct access to the underlying Zustand store API */
-    store: StoreApi<StoreSlice<TState, TActions>>;
-}
-
-/**
- * Creates a dynamic Zustand store from a configuration object.
- *
- * @example
- * ```ts
- * const { useStore } = createDynamicStore({
- *   initialState: { count: 0 },
- *   actions: (set) => ({
- *     increment: () => set((s) => ({ count: s.count + 1 })),
- *     decrement: () => set((s) => ({ count: s.count - 1 })),
- *     reset: () => set({ count: 0 }),
- *   }),
- * });
- * ```
- */
-declare function createDynamicStore<TState extends StoreState, TActions extends StoreActions>(config: DynamicStoreConfig<TState, TActions>): DynamicStore<TState, TActions>;
 
+interface UseDynamicStoreMethodsReturn<T extends StoreState> {
+    setData: (updater: SetStateAction<T>) => void;
+    reset: () => void;
+    get: () => T;
+}
 interface UseDynamicStoreReturn<T extends StoreState> {
     data: T;
     setData: (updater: SetStateAction<T>) => void;
     reset: () => void;
 }
+/**
+ * Hook that returns store methods (setData, reset, get) WITHOUT subscribing
+ * to state changes. Useful when you only need to update or read the store
+ * imperatively without causing component re-renders.
+ */
+declare function useDynamicStoreMethods<T extends StoreState>(storeId: string, config?: StoreConfig<T>): UseDynamicStoreMethodsReturn<T>;
 /**
  * Hook-based dynamic store keyed by `storeId`.
  *
@@ -117,6 +83,11 @@ declare function useDynamicStoreWithCleanup<T extends StoreState>(storeId: strin
  * Update a dynamic store from outside a React component.
  */
 declare const updateDynamicStore: (storeId: string, data: StoreState) => void;
+/**
+ * Retrieve the current state of a dynamic store from outside a React component.
+ * Fallbacks to empty object if store does not exist.
+ */
+declare const getDynamicStoreData: <T extends StoreState = StoreState>(storeId: string) => T | undefined;
 /**
  * Reset a single dynamic store to its initial state from outside React.
  */
@@ -130,4 +101,4 @@ declare const resetAllDynamicStores: () => void;
  */
 declare const resetNonPersistentDynamicStores: () => void;
 
-export { type DynamicStore, type DynamicStoreConfig, type DynamicStoreRegistry, type SetStateAction, type StoreActions, type StoreConfig, type StoreSlice, type StoreState, type UseDynamicStoreReturn, createDynamicStore, resetAllDynamicStores, resetDynamicStore, resetNonPersistentDynamicStores, updateDynamicStore, useDynamicStore, useDynamicStoreWithCleanup };
+export { type DynamicStoreRegistry, type SetStateAction, type StoreConfig, type UseDynamicStoreMethodsReturn, type UseDynamicStoreReturn, getDynamicStoreData, resetAllDynamicStores, resetDynamicStore, resetNonPersistentDynamicStores, updateDynamicStore, useDynamicStore, useDynamicStoreMethods, useDynamicStoreWithCleanup };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var zustand=require('zustand'),middleware=require('zustand/middleware'),react=require('react');function d(r){let{initialState:t,actions:e}=r,o=zustand.create()((n,s)=>({...t,...e(n,s)}));return {useStore:o,store:o}}var i=zustand.create()(middleware.devtools(r=>({stores:{},setStoreData:(t,e,o)=>{r(n=>{let s=n.stores[t],a={data:{...s?.data??o?.initialState??{},...e},config:o??s?.config??{},initialState:o?.initialState??s?.initialState??{}};return {stores:{...n.stores,[t]:a}}});},resetStore:t=>{r(e=>{let o=e.stores[t];return o?{stores:{...e.stores,[t]:{...o,data:{...o.initialState}}}}:e});},resetAllStores:()=>{r(t=>{let e={};for(let[o,n]of Object.entries(t.stores))e[o]={...n,data:{...n.initialState}};return {stores:e}});},resetNonPersistentStores:()=>{r(t=>{let e={};for(let[o,n]of Object.entries(t.stores))e[o]=n.config.persistOnNavigation===true?n:{...n,data:{...n.initialState}};return {stores:e}});}}),{name:"DynamicStoresManager"}));function c(r,t){let e=i(),o=e.stores[r];return react.useEffect(()=>{!o&&t?.initialState!==void 0&&e.setStoreData(r,{},t);},[r]),{data:o?.data??t?.initialState??{},setData:a=>{if(typeof a=="function"){let y=e.stores[r]?.data??t?.initialState??{},D=a(y);e.setStoreData(r,D,t);}else e.setStoreData(r,a,t);},reset:()=>{e.resetStore(r);}}}function g(r,t){let{data:e,setData:o,reset:n}=c(r,t);return react.useEffect(()=>()=>{t?.resetOnUnmount===true&&n();},[r,t?.resetOnUnmount]),{data:e,setData:o,reset:n}}var l=(r,t)=>{i.getState().setStoreData(r,t);},x=r=>{i.getState().resetStore(r);},T=()=>{i.getState().resetAllStores();},A=()=>{i.getState().resetNonPersistentStores();};exports.createDynamicStore=d;exports.resetAllDynamicStores=T;exports.resetDynamicStore=x;exports.resetNonPersistentDynamicStores=A;exports.updateDynamicStore=l;exports.useDynamicStore=c;exports.useDynamicStoreWithCleanup=g;//# sourceMappingURL=index.js.map
+'use strict';var zustand=require('zustand'),middleware=require('zustand/middleware'),react=require('react');var a=zustand.create()(middleware.devtools(e=>({stores:{},setStoreData:(t,r,o)=>{e(s=>{let i=s.stores[t],n={data:{...i?.data??o?.initialState??{},...r},config:o??i?.config??{},initialState:o?.initialState??i?.initialState??{}};return {stores:{...s.stores,[t]:n}}});},resetStore:t=>{e(r=>{let o=r.stores[t];return o?{stores:{...r.stores,[t]:{...o,data:{...o.initialState}}}}:r});},resetAllStores:()=>{e(t=>{let r={};for(let[o,s]of Object.entries(t.stores))r[o]={...s,data:{...s.initialState}};return {stores:r}});},resetNonPersistentStores:()=>{e(t=>{let r={};for(let[o,s]of Object.entries(t.stores))r[o]=s.config.persistOnNavigation===true?s:{...s,data:{...s.initialState}};return {stores:r}});}}),{name:"DynamicStoresManager"}));function c(e,t){let r=a(n=>n.setStoreData),o=a(n=>n.resetStore),s=()=>a.getState().stores[e]?.data??t?.initialState??{};return {setData:n=>{if(typeof n=="function"){let D=n(s());r(e,D,t);}else r(e,n,t);},reset:()=>{o(e);},get:s}}function d(e,t){let r=a(i=>i.stores[e]),o=c(e,t);return react.useEffect(()=>{!r&&t?.initialState!==void 0&&a.getState().setStoreData(e,{},t);},[e]),{data:r?.data??t?.initialState??{},setData:o.setData,reset:o.reset}}function g(e,t){let{data:r,setData:o,reset:s}=d(e,t);return react.useEffect(()=>()=>{t?.resetOnUnmount===true&&s();},[e,t?.resetOnUnmount]),{data:r,setData:o,reset:s}}var f=(e,t)=>{a.getState().setStoreData(e,t);},p=e=>a.getState().stores[e]?.data,l=e=>{a.getState().resetStore(e);},T=()=>{a.getState().resetAllStores();},x=()=>{a.getState().resetNonPersistentStores();};exports.getDynamicStoreData=p;exports.resetAllDynamicStores=T;exports.resetDynamicStore=l;exports.resetNonPersistentDynamicStores=x;exports.updateDynamicStore=f;exports.useDynamicStore=d;exports.useDynamicStoreMethods=c;exports.useDynamicStoreWithCleanup=g;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/createDynamicStore.ts","../src/dynamicStore.ts"],"names":["createDynamicStore","config","initialState","actions","store","create","set","get","useDynamicStoresManager","devtools","storeId","data","state","existingStore","entry","next","id","useDynamicStore","storesManager","storeRegistry","useEffect","updater","currentData","updates","useDynamicStoreWithCleanup","setData","reset","updateDynamicStore","resetDynamicStore","resetAllDynamicStores","resetNonPersistentDynamicStores"],"mappings":"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","file":"index.js","sourcesContent":["import { create } from \"zustand\";\nimport type {\n  DynamicStore,\n  DynamicStoreConfig,\n  StoreActions,\n  StoreState,\n  StoreSlice,\n} from \"./types\";\n\n/**\n * Creates a dynamic Zustand store from a configuration object.\n *\n * @example\n * ```ts\n * const { useStore } = createDynamicStore({\n *   initialState: { count: 0 },\n *   actions: (set) => ({\n *     increment: () => set((s) => ({ count: s.count + 1 })),\n *     decrement: () => set((s) => ({ count: s.count - 1 })),\n *     reset: () => set({ count: 0 }),\n *   }),\n * });\n * ```\n */\nexport function createDynamicStore<\n  TState extends StoreState,\n  TActions extends StoreActions,\n>(\n  config: DynamicStoreConfig<TState, TActions>,\n): DynamicStore<TState, TActions> {\n  const { initialState, actions } = config;\n\n  const store = create<StoreSlice<TState, TActions>>()((set, get) => ({\n    ...initialState,\n    ...actions(set, get),\n  }));\n\n  return {\n    useStore: store,\n    store,\n  };\n}\n","import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport { useEffect } from \"react\";\nimport type {\n  SetStateAction,\n  StoreConfig,\n  DynamicStoreRegistry,\n  StoreState,\n} from \"./types\";\n\n// ─── Internal manager state ───────────────────────────────────────────────────\n\ninterface DynamicStoresState {\n  stores: Record<string, DynamicStoreRegistry>;\n  setStoreData: (\n    storeId: string,\n    data: StoreState,\n    config?: StoreConfig,\n  ) => void;\n  resetStore: (storeId: string) => void;\n  resetAllStores: () => void;\n  resetNonPersistentStores: () => void;\n}\n\nconst useDynamicStoresManager = create<DynamicStoresState>()(\n  devtools(\n    (set) => ({\n      stores: {},\n\n      setStoreData: (storeId, data, config) => {\n        set((state) => {\n          const existingStore = state.stores[storeId];\n          const currentData: StoreState =\n            existingStore?.data ?? config?.initialState ?? {};\n\n          const entry: DynamicStoreRegistry = {\n            data: { ...currentData, ...data },\n            config: config ?? existingStore?.config ?? {},\n            initialState:\n              config?.initialState ?? existingStore?.initialState ?? {},\n          };\n\n          return {\n            stores: { ...state.stores, [storeId]: entry },\n          };\n        });\n      },\n\n      resetStore: (storeId) => {\n        set((state) => {\n          const store = state.stores[storeId];\n          if (!store) return state;\n\n          return {\n            stores: {\n              ...state.stores,\n              [storeId]: { ...store, data: { ...store.initialState } },\n            },\n          };\n        });\n      },\n\n      resetAllStores: () => {\n        set((state) => {\n          const next: Record<string, DynamicStoreRegistry> = {};\n\n          for (const [id, store] of Object.entries(state.stores)) {\n            next[id] = { ...store, data: { ...store.initialState } };\n          }\n\n          return { stores: next };\n        });\n      },\n\n      resetNonPersistentStores: () => {\n        set((state) => {\n          const next: Record<string, DynamicStoreRegistry> = {};\n\n          for (const [id, store] of Object.entries(state.stores)) {\n            next[id] =\n              store.config.persistOnNavigation === true\n                ? store\n                : { ...store, data: { ...store.initialState } };\n          }\n\n          return { stores: next };\n        });\n      },\n    }),\n    { name: \"DynamicStoresManager\" },\n  ),\n);\n\n// ─── Return types ─────────────────────────────────────────────────────────────\n\nexport interface UseDynamicStoreReturn<T extends StoreState> {\n  data: T;\n  setData: (updater: SetStateAction<T>) => void;\n  reset: () => void;\n}\n\n// ─── useDynamicStore ──────────────────────────────────────────────────────────\n\n/**\n * Hook-based dynamic store keyed by `storeId`.\n *\n * `setData` accepts either a partial object **or** a function that receives\n * the previous state and returns a partial object — exactly like React's\n * `useState` setter.\n *\n * @example\n * ```tsx\n * const { data, setData, reset } = useDynamicStore<CounterState>('counter', {\n *   initialState: { value: 0, step: 1 },\n * });\n *\n * // object update\n * setData({ value: 42 });\n *\n * // functional update — safe for rapid successive calls\n * setData((prev) => ({ value: prev.value + prev.step }));\n * ```\n */\nexport function useDynamicStore<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreReturn<T> {\n  const storesManager = useDynamicStoresManager();\n  const storeRegistry = storesManager.stores[storeId];\n\n  // Initialize the store entry on first use\n  useEffect(() => {\n    if (!storeRegistry && config?.initialState !== undefined) {\n      storesManager.setStoreData(storeId, {}, config as StoreConfig);\n    }\n    // Only run on mount / storeId change — intentional dep list\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [storeId]);\n\n  const data = (storeRegistry?.data ?? config?.initialState ?? {}) as T;\n\n  const setData = (updater: SetStateAction<T>): void => {\n    if (typeof updater === \"function\") {\n      const currentData = (\n        storesManager.stores[storeId]?.data ?? config?.initialState ?? {}\n      ) as T;\n      const updates = updater(currentData);\n      storesManager.setStoreData(\n        storeId,\n        updates as StoreState,\n        config as StoreConfig | undefined,\n      );\n    } else {\n      storesManager.setStoreData(\n        storeId,\n        updater as StoreState,\n        config as StoreConfig | undefined,\n      );\n    }\n  };\n\n  const reset = (): void => {\n    storesManager.resetStore(storeId);\n  };\n\n  return { data, setData, reset };\n}\n\n// ─── useDynamicStoreWithCleanup ───────────────────────────────────────────────\n\n/**\n * Same as `useDynamicStore` but automatically resets state when the\n * component unmounts (when `config.resetOnUnmount` is `true`).\n *\n * @example\n * ```tsx\n * const { data, setData, reset } = useDynamicStoreWithCleanup<FormState>(\n *   'editForm',\n *   { initialState, resetOnUnmount: true },\n * );\n * ```\n */\nexport function useDynamicStoreWithCleanup<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreReturn<T> {\n  const { data, setData, reset } = useDynamicStore<T>(storeId, config);\n\n  useEffect(() => {\n    return () => {\n      if (config?.resetOnUnmount === true) {\n        reset();\n      }\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [storeId, config?.resetOnUnmount]);\n\n  return { data, setData, reset };\n}\n\n// ─── Imperative helpers (outside React) ──────────────────────────────────────\n\n/**\n * Update a dynamic store from outside a React component.\n */\nexport const updateDynamicStore = (\n  storeId: string,\n  data: StoreState,\n): void => {\n  useDynamicStoresManager.getState().setStoreData(storeId, data);\n};\n\n/**\n * Reset a single dynamic store to its initial state from outside React.\n */\nexport const resetDynamicStore = (storeId: string): void => {\n  useDynamicStoresManager.getState().resetStore(storeId);\n};\n\n/**\n * Reset all dynamic stores to their initial states from outside React.\n */\nexport const resetAllDynamicStores = (): void => {\n  useDynamicStoresManager.getState().resetAllStores();\n};\n\n/**\n * Reset only stores that do not have `persistOnNavigation: true`.\n */\nexport const resetNonPersistentDynamicStores = (): void => {\n  useDynamicStoresManager.getState().resetNonPersistentStores();\n};\n"]}
+{"version":3,"sources":["../src/dynamicStore.ts"],"names":["useDynamicStoresManager","create","devtools","set","storeId","data","config","state","existingStore","entry","store","next","id","useDynamicStoreMethods","setStoreData","resetStore","get","updater","updates","useDynamicStore","storeRegistry","methods","useEffect","useDynamicStoreWithCleanup","setData","reset","updateDynamicStore","getDynamicStoreData","resetDynamicStore","resetAllDynamicStores","resetNonPersistentDynamicStores"],"mappings":"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","file":"index.js","sourcesContent":["import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport { useEffect } from \"react\";\nimport type {\n  SetStateAction,\n  StoreConfig,\n  DynamicStoreRegistry,\n  StoreState,\n} from \"./types\";\n\n// ─── Internal manager state ───────────────────────────────────────────────────\n\ninterface DynamicStoresState {\n  stores: Record<string, DynamicStoreRegistry>;\n  setStoreData: (\n    storeId: string,\n    data: StoreState,\n    config?: StoreConfig,\n  ) => void;\n  resetStore: (storeId: string) => void;\n  resetAllStores: () => void;\n  resetNonPersistentStores: () => void;\n}\n\nconst useDynamicStoresManager = create<DynamicStoresState>()(\n  devtools(\n    (set) => ({\n      stores: {},\n\n      setStoreData: (storeId, data, config) => {\n        set((state) => {\n          const existingStore = state.stores[storeId];\n          const currentData: StoreState =\n            existingStore?.data ?? config?.initialState ?? {};\n\n          const entry: DynamicStoreRegistry = {\n            data: { ...currentData, ...data },\n            config: config ?? existingStore?.config ?? {},\n            initialState:\n              config?.initialState ?? existingStore?.initialState ?? {},\n          };\n\n          return {\n            stores: { ...state.stores, [storeId]: entry },\n          };\n        });\n      },\n\n      resetStore: (storeId) => {\n        set((state) => {\n          const store = state.stores[storeId];\n          if (!store) return state;\n\n          return {\n            stores: {\n              ...state.stores,\n              [storeId]: { ...store, data: { ...store.initialState } },\n            },\n          };\n        });\n      },\n\n      resetAllStores: () => {\n        set((state) => {\n          const next: Record<string, DynamicStoreRegistry> = {};\n\n          for (const [id, store] of Object.entries(state.stores)) {\n            next[id] = { ...store, data: { ...store.initialState } };\n          }\n\n          return { stores: next };\n        });\n      },\n\n      resetNonPersistentStores: () => {\n        set((state) => {\n          const next: Record<string, DynamicStoreRegistry> = {};\n\n          for (const [id, store] of Object.entries(state.stores)) {\n            next[id] =\n              store.config.persistOnNavigation === true\n                ? store\n                : { ...store, data: { ...store.initialState } };\n          }\n\n          return { stores: next };\n        });\n      },\n    }),\n    { name: \"DynamicStoresManager\" },\n  ),\n);\n\n// ─── Return types ─────────────────────────────────────────────────────────────\n\nexport interface UseDynamicStoreMethodsReturn<T extends StoreState> {\n  setData: (updater: SetStateAction<T>) => void;\n  reset: () => void;\n  get: () => T;\n}\n\nexport interface UseDynamicStoreReturn<T extends StoreState> {\n  data: T;\n  setData: (updater: SetStateAction<T>) => void;\n  reset: () => void;\n}\n\n// ─── useDynamicStoreMethods ───────────────────────────────────────────────────\n\n/**\n * Hook that returns store methods (setData, reset, get) WITHOUT subscribing\n * to state changes. Useful when you only need to update or read the store\n * imperatively without causing component re-renders.\n */\nexport function useDynamicStoreMethods<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreMethodsReturn<T> {\n  const setStoreData = useDynamicStoresManager((state) => state.setStoreData);\n  const resetStore = useDynamicStoresManager((state) => state.resetStore);\n\n  const get = (): T => {\n    const storeRegistry = useDynamicStoresManager.getState().stores[storeId];\n    return (storeRegistry?.data ?? config?.initialState ?? {}) as T;\n  };\n\n  const setData = (updater: SetStateAction<T>): void => {\n    if (typeof updater === \"function\") {\n      const updates = updater(get());\n      setStoreData(\n        storeId,\n        updates as StoreState,\n        config as StoreConfig | undefined,\n      );\n    } else {\n      setStoreData(\n        storeId,\n        updater as StoreState,\n        config as StoreConfig | undefined,\n      );\n    }\n  };\n\n  const reset = (): void => {\n    resetStore(storeId);\n  };\n\n  return { setData, reset, get };\n}\n\n// ─── useDynamicStore ──────────────────────────────────────────────────────────\n\n/**\n * Hook-based dynamic store keyed by `storeId`.\n *\n * `setData` accepts either a partial object **or** a function that receives\n * the previous state and returns a partial object — exactly like React's\n * `useState` setter.\n *\n * @example\n * ```tsx\n * const { data, setData, reset } = useDynamicStore<CounterState>('counter', {\n *   initialState: { value: 0, step: 1 },\n * });\n *\n * // object update\n * setData({ value: 42 });\n *\n * // functional update — safe for rapid successive calls\n * setData((prev) => ({ value: prev.value + prev.step }));\n * ```\n */\nexport function useDynamicStore<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreReturn<T> {\n  const storeRegistry = useDynamicStoresManager((state) => state.stores[storeId]);\n  const methods = useDynamicStoreMethods<T>(storeId, config);\n\n  // Initialize the store entry on first use\n  useEffect(() => {\n    if (!storeRegistry && config?.initialState !== undefined) {\n      useDynamicStoresManager.getState().setStoreData(\n        storeId,\n        {},\n        config as StoreConfig,\n      );\n    }\n    // Only run on mount / storeId change — intentional dep list\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [storeId]);\n\n  const data = (storeRegistry?.data ?? config?.initialState ?? {}) as T;\n\n  return { data, setData: methods.setData, reset: methods.reset };\n}\n\n// ─── useDynamicStoreWithCleanup ───────────────────────────────────────────────\n\n/**\n * Same as `useDynamicStore` but automatically resets state when the\n * component unmounts (when `config.resetOnUnmount` is `true`).\n *\n * @example\n * ```tsx\n * const { data, setData, reset } = useDynamicStoreWithCleanup<FormState>(\n *   'editForm',\n *   { initialState, resetOnUnmount: true },\n * );\n * ```\n */\nexport function useDynamicStoreWithCleanup<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreReturn<T> {\n  const { data, setData, reset } = useDynamicStore<T>(storeId, config);\n\n  useEffect(() => {\n    return () => {\n      if (config?.resetOnUnmount === true) {\n        reset();\n      }\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [storeId, config?.resetOnUnmount]);\n\n  return { data, setData, reset };\n}\n\n// ─── Imperative helpers (outside React) ──────────────────────────────────────\n\n/**\n * Update a dynamic store from outside a React component.\n */\nexport const updateDynamicStore = (\n  storeId: string,\n  data: StoreState,\n): void => {\n  useDynamicStoresManager.getState().setStoreData(storeId, data);\n};\n\n/**\n * Retrieve the current state of a dynamic store from outside a React component.\n * Fallbacks to empty object if store does not exist.\n */\nexport const getDynamicStoreData = <T extends StoreState = StoreState>(\n  storeId: string,\n): T | undefined => {\n  return useDynamicStoresManager.getState().stores[storeId]?.data as T | undefined;\n};\n\n/**\n * Reset a single dynamic store to its initial state from outside React.\n */\nexport const resetDynamicStore = (storeId: string): void => {\n  useDynamicStoresManager.getState().resetStore(storeId);\n};\n\n/**\n * Reset all dynamic stores to their initial states from outside React.\n */\nexport const resetAllDynamicStores = (): void => {\n  useDynamicStoresManager.getState().resetAllStores();\n};\n\n/**\n * Reset only stores that do not have `persistOnNavigation: true`.\n */\nexport const resetNonPersistentDynamicStores = (): void => {\n  useDynamicStoresManager.getState().resetNonPersistentStores();\n};\n"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {create}from'zustand';import {devtools}from'zustand/middleware';import {useEffect}from'react';function d(r){let{initialState:t,actions:e}=r,o=create()((n,s)=>({...t,...e(n,s)}));return {useStore:o,store:o}}var i=create()(devtools(r=>({stores:{},setStoreData:(t,e,o)=>{r(n=>{let s=n.stores[t],a={data:{...s?.data??o?.initialState??{},...e},config:o??s?.config??{},initialState:o?.initialState??s?.initialState??{}};return {stores:{...n.stores,[t]:a}}});},resetStore:t=>{r(e=>{let o=e.stores[t];return o?{stores:{...e.stores,[t]:{...o,data:{...o.initialState}}}}:e});},resetAllStores:()=>{r(t=>{let e={};for(let[o,n]of Object.entries(t.stores))e[o]={...n,data:{...n.initialState}};return {stores:e}});},resetNonPersistentStores:()=>{r(t=>{let e={};for(let[o,n]of Object.entries(t.stores))e[o]=n.config.persistOnNavigation===true?n:{...n,data:{...n.initialState}};return {stores:e}});}}),{name:"DynamicStoresManager"}));function c(r,t){let e=i(),o=e.stores[r];return useEffect(()=>{!o&&t?.initialState!==void 0&&e.setStoreData(r,{},t);},[r]),{data:o?.data??t?.initialState??{},setData:a=>{if(typeof a=="function"){let y=e.stores[r]?.data??t?.initialState??{},D=a(y);e.setStoreData(r,D,t);}else e.setStoreData(r,a,t);},reset:()=>{e.resetStore(r);}}}function g(r,t){let{data:e,setData:o,reset:n}=c(r,t);return useEffect(()=>()=>{t?.resetOnUnmount===true&&n();},[r,t?.resetOnUnmount]),{data:e,setData:o,reset:n}}var l=(r,t)=>{i.getState().setStoreData(r,t);},x=r=>{i.getState().resetStore(r);},T=()=>{i.getState().resetAllStores();},A=()=>{i.getState().resetNonPersistentStores();};export{d as createDynamicStore,T as resetAllDynamicStores,x as resetDynamicStore,A as resetNonPersistentDynamicStores,l as updateDynamicStore,c as useDynamicStore,g as useDynamicStoreWithCleanup};//# sourceMappingURL=index.mjs.map
+import {create}from'zustand';import {devtools}from'zustand/middleware';import {useEffect}from'react';var a=create()(devtools(e=>({stores:{},setStoreData:(t,r,o)=>{e(s=>{let i=s.stores[t],n={data:{...i?.data??o?.initialState??{},...r},config:o??i?.config??{},initialState:o?.initialState??i?.initialState??{}};return {stores:{...s.stores,[t]:n}}});},resetStore:t=>{e(r=>{let o=r.stores[t];return o?{stores:{...r.stores,[t]:{...o,data:{...o.initialState}}}}:r});},resetAllStores:()=>{e(t=>{let r={};for(let[o,s]of Object.entries(t.stores))r[o]={...s,data:{...s.initialState}};return {stores:r}});},resetNonPersistentStores:()=>{e(t=>{let r={};for(let[o,s]of Object.entries(t.stores))r[o]=s.config.persistOnNavigation===true?s:{...s,data:{...s.initialState}};return {stores:r}});}}),{name:"DynamicStoresManager"}));function c(e,t){let r=a(n=>n.setStoreData),o=a(n=>n.resetStore),s=()=>a.getState().stores[e]?.data??t?.initialState??{};return {setData:n=>{if(typeof n=="function"){let D=n(s());r(e,D,t);}else r(e,n,t);},reset:()=>{o(e);},get:s}}function d(e,t){let r=a(i=>i.stores[e]),o=c(e,t);return useEffect(()=>{!r&&t?.initialState!==void 0&&a.getState().setStoreData(e,{},t);},[e]),{data:r?.data??t?.initialState??{},setData:o.setData,reset:o.reset}}function g(e,t){let{data:r,setData:o,reset:s}=d(e,t);return useEffect(()=>()=>{t?.resetOnUnmount===true&&s();},[e,t?.resetOnUnmount]),{data:r,setData:o,reset:s}}var f=(e,t)=>{a.getState().setStoreData(e,t);},p=e=>a.getState().stores[e]?.data,l=e=>{a.getState().resetStore(e);},T=()=>{a.getState().resetAllStores();},x=()=>{a.getState().resetNonPersistentStores();};export{p as getDynamicStoreData,T as resetAllDynamicStores,l as resetDynamicStore,x as resetNonPersistentDynamicStores,f as updateDynamicStore,d as useDynamicStore,c as useDynamicStoreMethods,g as useDynamicStoreWithCleanup};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/createDynamicStore.ts","../src/dynamicStore.ts"],"names":["createDynamicStore","config","initialState","actions","store","create","set","get","useDynamicStoresManager","devtools","storeId","data","state","existingStore","entry","next","id","useDynamicStore","storesManager","storeRegistry","useEffect","updater","currentData","updates","useDynamicStoreWithCleanup","setData","reset","updateDynamicStore","resetDynamicStore","resetAllDynamicStores","resetNonPersistentDynamicStores"],"mappings":"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","file":"index.mjs","sourcesContent":["import { create } from \"zustand\";\nimport type {\n  DynamicStore,\n  DynamicStoreConfig,\n  StoreActions,\n  StoreState,\n  StoreSlice,\n} from \"./types\";\n\n/**\n * Creates a dynamic Zustand store from a configuration object.\n *\n * @example\n * ```ts\n * const { useStore } = createDynamicStore({\n *   initialState: { count: 0 },\n *   actions: (set) => ({\n *     increment: () => set((s) => ({ count: s.count + 1 })),\n *     decrement: () => set((s) => ({ count: s.count - 1 })),\n *     reset: () => set({ count: 0 }),\n *   }),\n * });\n * ```\n */\nexport function createDynamicStore<\n  TState extends StoreState,\n  TActions extends StoreActions,\n>(\n  config: DynamicStoreConfig<TState, TActions>,\n): DynamicStore<TState, TActions> {\n  const { initialState, actions } = config;\n\n  const store = create<StoreSlice<TState, TActions>>()((set, get) => ({\n    ...initialState,\n    ...actions(set, get),\n  }));\n\n  return {\n    useStore: store,\n    store,\n  };\n}\n","import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport { useEffect } from \"react\";\nimport type {\n  SetStateAction,\n  StoreConfig,\n  DynamicStoreRegistry,\n  StoreState,\n} from \"./types\";\n\n// ─── Internal manager state ───────────────────────────────────────────────────\n\ninterface DynamicStoresState {\n  stores: Record<string, DynamicStoreRegistry>;\n  setStoreData: (\n    storeId: string,\n    data: StoreState,\n    config?: StoreConfig,\n  ) => void;\n  resetStore: (storeId: string) => void;\n  resetAllStores: () => void;\n  resetNonPersistentStores: () => void;\n}\n\nconst useDynamicStoresManager = create<DynamicStoresState>()(\n  devtools(\n    (set) => ({\n      stores: {},\n\n      setStoreData: (storeId, data, config) => {\n        set((state) => {\n          const existingStore = state.stores[storeId];\n          const currentData: StoreState =\n            existingStore?.data ?? config?.initialState ?? {};\n\n          const entry: DynamicStoreRegistry = {\n            data: { ...currentData, ...data },\n            config: config ?? existingStore?.config ?? {},\n            initialState:\n              config?.initialState ?? existingStore?.initialState ?? {},\n          };\n\n          return {\n            stores: { ...state.stores, [storeId]: entry },\n          };\n        });\n      },\n\n      resetStore: (storeId) => {\n        set((state) => {\n          const store = state.stores[storeId];\n          if (!store) return state;\n\n          return {\n            stores: {\n              ...state.stores,\n              [storeId]: { ...store, data: { ...store.initialState } },\n            },\n          };\n        });\n      },\n\n      resetAllStores: () => {\n        set((state) => {\n          const next: Record<string, DynamicStoreRegistry> = {};\n\n          for (const [id, store] of Object.entries(state.stores)) {\n            next[id] = { ...store, data: { ...store.initialState } };\n          }\n\n          return { stores: next };\n        });\n      },\n\n      resetNonPersistentStores: () => {\n        set((state) => {\n          const next: Record<string, DynamicStoreRegistry> = {};\n\n          for (const [id, store] of Object.entries(state.stores)) {\n            next[id] =\n              store.config.persistOnNavigation === true\n                ? store\n                : { ...store, data: { ...store.initialState } };\n          }\n\n          return { stores: next };\n        });\n      },\n    }),\n    { name: \"DynamicStoresManager\" },\n  ),\n);\n\n// ─── Return types ─────────────────────────────────────────────────────────────\n\nexport interface UseDynamicStoreReturn<T extends StoreState> {\n  data: T;\n  setData: (updater: SetStateAction<T>) => void;\n  reset: () => void;\n}\n\n// ─── useDynamicStore ──────────────────────────────────────────────────────────\n\n/**\n * Hook-based dynamic store keyed by `storeId`.\n *\n * `setData` accepts either a partial object **or** a function that receives\n * the previous state and returns a partial object — exactly like React's\n * `useState` setter.\n *\n * @example\n * ```tsx\n * const { data, setData, reset } = useDynamicStore<CounterState>('counter', {\n *   initialState: { value: 0, step: 1 },\n * });\n *\n * // object update\n * setData({ value: 42 });\n *\n * // functional update — safe for rapid successive calls\n * setData((prev) => ({ value: prev.value + prev.step }));\n * ```\n */\nexport function useDynamicStore<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreReturn<T> {\n  const storesManager = useDynamicStoresManager();\n  const storeRegistry = storesManager.stores[storeId];\n\n  // Initialize the store entry on first use\n  useEffect(() => {\n    if (!storeRegistry && config?.initialState !== undefined) {\n      storesManager.setStoreData(storeId, {}, config as StoreConfig);\n    }\n    // Only run on mount / storeId change — intentional dep list\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [storeId]);\n\n  const data = (storeRegistry?.data ?? config?.initialState ?? {}) as T;\n\n  const setData = (updater: SetStateAction<T>): void => {\n    if (typeof updater === \"function\") {\n      const currentData = (\n        storesManager.stores[storeId]?.data ?? config?.initialState ?? {}\n      ) as T;\n      const updates = updater(currentData);\n      storesManager.setStoreData(\n        storeId,\n        updates as StoreState,\n        config as StoreConfig | undefined,\n      );\n    } else {\n      storesManager.setStoreData(\n        storeId,\n        updater as StoreState,\n        config as StoreConfig | undefined,\n      );\n    }\n  };\n\n  const reset = (): void => {\n    storesManager.resetStore(storeId);\n  };\n\n  return { data, setData, reset };\n}\n\n// ─── useDynamicStoreWithCleanup ───────────────────────────────────────────────\n\n/**\n * Same as `useDynamicStore` but automatically resets state when the\n * component unmounts (when `config.resetOnUnmount` is `true`).\n *\n * @example\n * ```tsx\n * const { data, setData, reset } = useDynamicStoreWithCleanup<FormState>(\n *   'editForm',\n *   { initialState, resetOnUnmount: true },\n * );\n * ```\n */\nexport function useDynamicStoreWithCleanup<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreReturn<T> {\n  const { data, setData, reset } = useDynamicStore<T>(storeId, config);\n\n  useEffect(() => {\n    return () => {\n      if (config?.resetOnUnmount === true) {\n        reset();\n      }\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [storeId, config?.resetOnUnmount]);\n\n  return { data, setData, reset };\n}\n\n// ─── Imperative helpers (outside React) ──────────────────────────────────────\n\n/**\n * Update a dynamic store from outside a React component.\n */\nexport const updateDynamicStore = (\n  storeId: string,\n  data: StoreState,\n): void => {\n  useDynamicStoresManager.getState().setStoreData(storeId, data);\n};\n\n/**\n * Reset a single dynamic store to its initial state from outside React.\n */\nexport const resetDynamicStore = (storeId: string): void => {\n  useDynamicStoresManager.getState().resetStore(storeId);\n};\n\n/**\n * Reset all dynamic stores to their initial states from outside React.\n */\nexport const resetAllDynamicStores = (): void => {\n  useDynamicStoresManager.getState().resetAllStores();\n};\n\n/**\n * Reset only stores that do not have `persistOnNavigation: true`.\n */\nexport const resetNonPersistentDynamicStores = (): void => {\n  useDynamicStoresManager.getState().resetNonPersistentStores();\n};\n"]}
+{"version":3,"sources":["../src/dynamicStore.ts"],"names":["useDynamicStoresManager","create","devtools","set","storeId","data","config","state","existingStore","entry","store","next","id","useDynamicStoreMethods","setStoreData","resetStore","get","updater","updates","useDynamicStore","storeRegistry","methods","useEffect","useDynamicStoreWithCleanup","setData","reset","updateDynamicStore","getDynamicStoreData","resetDynamicStore","resetAllDynamicStores","resetNonPersistentDynamicStores"],"mappings":"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","file":"index.mjs","sourcesContent":["import { create } from \"zustand\";\nimport { devtools } from \"zustand/middleware\";\nimport { useEffect } from \"react\";\nimport type {\n  SetStateAction,\n  StoreConfig,\n  DynamicStoreRegistry,\n  StoreState,\n} from \"./types\";\n\n// ─── Internal manager state ───────────────────────────────────────────────────\n\ninterface DynamicStoresState {\n  stores: Record<string, DynamicStoreRegistry>;\n  setStoreData: (\n    storeId: string,\n    data: StoreState,\n    config?: StoreConfig,\n  ) => void;\n  resetStore: (storeId: string) => void;\n  resetAllStores: () => void;\n  resetNonPersistentStores: () => void;\n}\n\nconst useDynamicStoresManager = create<DynamicStoresState>()(\n  devtools(\n    (set) => ({\n      stores: {},\n\n      setStoreData: (storeId, data, config) => {\n        set((state) => {\n          const existingStore = state.stores[storeId];\n          const currentData: StoreState =\n            existingStore?.data ?? config?.initialState ?? {};\n\n          const entry: DynamicStoreRegistry = {\n            data: { ...currentData, ...data },\n            config: config ?? existingStore?.config ?? {},\n            initialState:\n              config?.initialState ?? existingStore?.initialState ?? {},\n          };\n\n          return {\n            stores: { ...state.stores, [storeId]: entry },\n          };\n        });\n      },\n\n      resetStore: (storeId) => {\n        set((state) => {\n          const store = state.stores[storeId];\n          if (!store) return state;\n\n          return {\n            stores: {\n              ...state.stores,\n              [storeId]: { ...store, data: { ...store.initialState } },\n            },\n          };\n        });\n      },\n\n      resetAllStores: () => {\n        set((state) => {\n          const next: Record<string, DynamicStoreRegistry> = {};\n\n          for (const [id, store] of Object.entries(state.stores)) {\n            next[id] = { ...store, data: { ...store.initialState } };\n          }\n\n          return { stores: next };\n        });\n      },\n\n      resetNonPersistentStores: () => {\n        set((state) => {\n          const next: Record<string, DynamicStoreRegistry> = {};\n\n          for (const [id, store] of Object.entries(state.stores)) {\n            next[id] =\n              store.config.persistOnNavigation === true\n                ? store\n                : { ...store, data: { ...store.initialState } };\n          }\n\n          return { stores: next };\n        });\n      },\n    }),\n    { name: \"DynamicStoresManager\" },\n  ),\n);\n\n// ─── Return types ─────────────────────────────────────────────────────────────\n\nexport interface UseDynamicStoreMethodsReturn<T extends StoreState> {\n  setData: (updater: SetStateAction<T>) => void;\n  reset: () => void;\n  get: () => T;\n}\n\nexport interface UseDynamicStoreReturn<T extends StoreState> {\n  data: T;\n  setData: (updater: SetStateAction<T>) => void;\n  reset: () => void;\n}\n\n// ─── useDynamicStoreMethods ───────────────────────────────────────────────────\n\n/**\n * Hook that returns store methods (setData, reset, get) WITHOUT subscribing\n * to state changes. Useful when you only need to update or read the store\n * imperatively without causing component re-renders.\n */\nexport function useDynamicStoreMethods<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreMethodsReturn<T> {\n  const setStoreData = useDynamicStoresManager((state) => state.setStoreData);\n  const resetStore = useDynamicStoresManager((state) => state.resetStore);\n\n  const get = (): T => {\n    const storeRegistry = useDynamicStoresManager.getState().stores[storeId];\n    return (storeRegistry?.data ?? config?.initialState ?? {}) as T;\n  };\n\n  const setData = (updater: SetStateAction<T>): void => {\n    if (typeof updater === \"function\") {\n      const updates = updater(get());\n      setStoreData(\n        storeId,\n        updates as StoreState,\n        config as StoreConfig | undefined,\n      );\n    } else {\n      setStoreData(\n        storeId,\n        updater as StoreState,\n        config as StoreConfig | undefined,\n      );\n    }\n  };\n\n  const reset = (): void => {\n    resetStore(storeId);\n  };\n\n  return { setData, reset, get };\n}\n\n// ─── useDynamicStore ──────────────────────────────────────────────────────────\n\n/**\n * Hook-based dynamic store keyed by `storeId`.\n *\n * `setData` accepts either a partial object **or** a function that receives\n * the previous state and returns a partial object — exactly like React's\n * `useState` setter.\n *\n * @example\n * ```tsx\n * const { data, setData, reset } = useDynamicStore<CounterState>('counter', {\n *   initialState: { value: 0, step: 1 },\n * });\n *\n * // object update\n * setData({ value: 42 });\n *\n * // functional update — safe for rapid successive calls\n * setData((prev) => ({ value: prev.value + prev.step }));\n * ```\n */\nexport function useDynamicStore<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreReturn<T> {\n  const storeRegistry = useDynamicStoresManager((state) => state.stores[storeId]);\n  const methods = useDynamicStoreMethods<T>(storeId, config);\n\n  // Initialize the store entry on first use\n  useEffect(() => {\n    if (!storeRegistry && config?.initialState !== undefined) {\n      useDynamicStoresManager.getState().setStoreData(\n        storeId,\n        {},\n        config as StoreConfig,\n      );\n    }\n    // Only run on mount / storeId change — intentional dep list\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [storeId]);\n\n  const data = (storeRegistry?.data ?? config?.initialState ?? {}) as T;\n\n  return { data, setData: methods.setData, reset: methods.reset };\n}\n\n// ─── useDynamicStoreWithCleanup ───────────────────────────────────────────────\n\n/**\n * Same as `useDynamicStore` but automatically resets state when the\n * component unmounts (when `config.resetOnUnmount` is `true`).\n *\n * @example\n * ```tsx\n * const { data, setData, reset } = useDynamicStoreWithCleanup<FormState>(\n *   'editForm',\n *   { initialState, resetOnUnmount: true },\n * );\n * ```\n */\nexport function useDynamicStoreWithCleanup<T extends StoreState>(\n  storeId: string,\n  config?: StoreConfig<T>,\n): UseDynamicStoreReturn<T> {\n  const { data, setData, reset } = useDynamicStore<T>(storeId, config);\n\n  useEffect(() => {\n    return () => {\n      if (config?.resetOnUnmount === true) {\n        reset();\n      }\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [storeId, config?.resetOnUnmount]);\n\n  return { data, setData, reset };\n}\n\n// ─── Imperative helpers (outside React) ──────────────────────────────────────\n\n/**\n * Update a dynamic store from outside a React component.\n */\nexport const updateDynamicStore = (\n  storeId: string,\n  data: StoreState,\n): void => {\n  useDynamicStoresManager.getState().setStoreData(storeId, data);\n};\n\n/**\n * Retrieve the current state of a dynamic store from outside a React component.\n * Fallbacks to empty object if store does not exist.\n */\nexport const getDynamicStoreData = <T extends StoreState = StoreState>(\n  storeId: string,\n): T | undefined => {\n  return useDynamicStoresManager.getState().stores[storeId]?.data as T | undefined;\n};\n\n/**\n * Reset a single dynamic store to its initial state from outside React.\n */\nexport const resetDynamicStore = (storeId: string): void => {\n  useDynamicStoresManager.getState().resetStore(storeId);\n};\n\n/**\n * Reset all dynamic stores to their initial states from outside React.\n */\nexport const resetAllDynamicStores = (): void => {\n  useDynamicStoresManager.getState().resetAllStores();\n};\n\n/**\n * Reset only stores that do not have `persistOnNavigation: true`.\n */\nexport const resetNonPersistentDynamicStores = (): void => {\n  useDynamicStoresManager.getState().resetNonPersistentStores();\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pitboxdev/dynamic-store-zustand",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Dynamic store factory built on top of Zustand for scalable state management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",