@pitboxdev/dynamic-store-zustand 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pitboxdev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,482 @@
+# @pitboxdev/dynamic-store-zustand
+
+> Two complementary approaches to scalable, type-safe state management in React — both built on top of [Zustand](https://github.com/pmndrs/zustand).
+
+[![npm version](https://img.shields.io/npm/v/@pitboxdev/dynamic-store-zustand.svg)](https://www.npmjs.com/package/@pitboxdev/dynamic-store-zustand)
+[![license](https://img.shields.io/npm/l/@pitboxdev/dynamic-store-zustand.svg)](./LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
+
+---
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Installation](#installation)
+- [API 1 — `createDynamicStore`](#api-1--createdynamicstore)
+  - [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)
+- [Full API Reference](#full-api-reference)
+- [License](#license)
+
+---
+
+## Overview
+
+The package ships **two independent APIs** that can be used separately or together:
+
+| | `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 |
+
+---
+
+## Installation
+
+```bash
+npm install @pitboxdev/dynamic-store-zustand zustand
+# or
+yarn add @pitboxdev/dynamic-store-zustand zustand
+# or
+pnpm add @pitboxdev/dynamic-store-zustand zustand
+```
+
+> **Peer dependencies:** `react >= 18` and `zustand >= 5` must be installed in your project.
+
+---
+
+## 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`
+
+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.
+
+### Quick Start
+
+```tsx
+import { useDynamicStore } from "@pitboxdev/dynamic-store-zustand";
+
+interface CounterState {
+  value: number;
+  step: number;
+}
+
+const initial: CounterState = { value: 0, step: 1 };
+
+function Counter() {
+  const { data, setData, reset } = useDynamicStore<CounterState>("counter", {
+    initialState: initial,
+  });
+
+  return (
+    <div>
+      <p>Count: {data.value}</p>
+
+      {/* Object update */}
+      <button onClick={() => setData({ value: data.value + data.step })}>
+        + (simple)
+      </button>
+
+      {/* Functional update — always reads the latest state */}
+      <button onClick={() => setData((prev) => ({ value: prev.value + prev.step }))}>
+        + (functional)
+      </button>
+
+      <button onClick={reset}>Reset</button>
+    </div>
+  );
+}
+```
+
+### Functional updater (`setData`)
+
+`setData` accepts two forms:
+
+```ts
+// 1. Partial object — merges into current state
+setData({ value: 42 });
+
+// 2. Updater function — receives the latest state, returns a partial update
+setData((prev) => ({ value: prev.value + 1 }));
+```
+
+**Why use the functional form?**
+
+Without it, rapid successive calls all see the same snapshot:
+
+```ts
+// ❌ race condition — both calls read the same stale value
+setData({ value: data.value + 1 });
+setData({ value: data.value + 1 }); // data.value is still the old value
+
+// ✅ functional — each call receives the result of the previous one
+setData((prev) => ({ value: prev.value + 1 }));
+setData((prev) => ({ value: prev.value + 1 }));
+```
+
+Always prefer the functional form when the new state depends on the old state.
+
+#### Todo list example
+
+```tsx
+interface Todo { id: string; text: string; done: boolean }
+interface TodosState { items: Todo[]; filter: "all" | "active" | "done" }
+
+function TodoList() {
+  const { data, setData } = useDynamicStore<TodosState>("todos", {
+    initialState: { items: [], filter: "all" },
+  });
+
+  const addTodo = (text: string) => {
+    setData((prev) => ({
+      items: [...prev.items, { id: Date.now().toString(), text, done: false }],
+    }));
+  };
+
+  const toggle = (id: string) => {
+    setData((prev) => ({
+      items: prev.items.map((t) =>
+        t.id === id ? { ...t, done: !t.done } : t
+      ),
+    }));
+  };
+
+  const clearDone = () => {
+    setData((prev) => ({
+      items: prev.items.filter((t) => !t.done),
+      filter: "all",
+    }));
+  };
+
+  // ...
+}
+```
+
+#### Shopping cart example
+
+```tsx
+interface CartItem { id: string; name: string; price: number; quantity: number }
+interface CartState { items: CartItem[]; discount: number }
+
+function Cart() {
+  const { data, setData } = useDynamicStore<CartState>("cart", {
+    initialState: { items: [], discount: 0 },
+    persistOnNavigation: true,
+  });
+
+  const addItem = (product: Omit<CartItem, "quantity">) => {
+    setData((prev) => {
+      const exists = prev.items.find((i) => i.id === product.id);
+      return {
+        items: exists
+          ? prev.items.map((i) =>
+              i.id === product.id ? { ...i, quantity: i.quantity + 1 } : i
+            )
+          : [...prev.items, { ...product, quantity: 1 }],
+      };
+    });
+  };
+
+  const total = data.items.reduce(
+    (sum, i) => sum + i.price * i.quantity,
+    0
+  ) * (1 - data.discount / 100);
+
+  // ...
+}
+```
+
+### Auto-cleanup with `useDynamicStoreWithCleanup`
+
+`useDynamicStoreWithCleanup` works identically to `useDynamicStore` but resets the store when the component unmounts — useful for modal dialogs, wizard steps, or edit forms.
+
+```tsx
+import { useDynamicStoreWithCleanup } from "@pitboxdev/dynamic-store-zustand";
+
+function EditModal() {
+  const { data, setData } = useDynamicStoreWithCleanup<FormState>(
+    "editForm",
+    { initialState: { name: "", email: "" }, resetOnUnmount: true }
+  );
+
+  // State is automatically reset when the modal closes
+}
+```
+
+### Imperative helpers (outside React)
+
+All helpers call into the shared manager directly — no hook required.
+
+```ts
+import {
+  updateDynamicStore,
+  resetDynamicStore,
+  resetAllDynamicStores,
+  resetNonPersistentDynamicStores,
+} from "@pitboxdev/dynamic-store-zustand";
+
+// Merge data into a store
+updateDynamicStore("cart", { discount: 20 });
+
+// Reset one store to its initial state
+resetDynamicStore("editForm");
+
+// Reset every store
+resetAllDynamicStores();
+
+// Reset only stores without persistOnNavigation: true (e.g. on route change)
+resetNonPersistentDynamicStores();
+```
+
+### Config options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `initialState` | `T` | `{}` | Initial values; also used when `reset()` is called |
+| `persistOnNavigation` | `boolean` | `false` | Skip reset when `resetNonPersistentDynamicStores()` is called |
+| `resetOnUnmount` | `boolean` | `false` | Auto-reset when the component unmounts (`useDynamicStoreWithCleanup` only) |
+
+### TypeScript
+
+```ts
+import {
+  useDynamicStore,
+  type StoreConfig,
+  type SetStateAction,
+  type UseDynamicStoreReturn,
+} from "@pitboxdev/dynamic-store-zustand";
+
+interface FormState {
+  firstName: string;
+  lastName: string;
+  age: number;
+  agreed: boolean;
+}
+
+const config: StoreConfig<FormState> = {
+  initialState: { firstName: "", lastName: "", age: 0, agreed: false },
+  resetOnUnmount: true,
+};
+
+function RegistrationForm() {
+  const { data, setData, reset }: UseDynamicStoreReturn<FormState> =
+    useDynamicStore<FormState>("regForm", config);
+
+  // TypeScript will error on unknown keys:
+  // setData({ unknown: true }); ❌
+
+  const setAge = (age: number) => {
+    setData((prev) => ({
+      age,
+      // Clear consent when user is under 18
+      agreed: age < 18 ? false : prev.agreed,
+    }));
+  };
+
+  // ...
+}
+```
+
+---
+
+## 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 |
+|---|---|---|
+| `storeId` | `string` | Unique key identifying this store in the registry |
+| `config` | `StoreConfig<T>` | Optional config (see [Config options](#config-options)) |
+
+Returns `{ data: T, setData, reset }`.
+
+---
+
+### `useDynamicStoreWithCleanup<T>(storeId, config?)`
+
+Same signature as `useDynamicStore`. Calls `reset()` on component unmount when `config.resetOnUnmount` is `true`.
+
+---
+
+### Imperative helpers
+
+| Function | Signature | Description |
+|---|---|---|
+| `updateDynamicStore` | `(storeId, data) => void` | Merge data into a store 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` |
+
+---
+
+### Exported types
+
+| 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` |
+
+---
+
+## License
+
+[MIT](./LICENSE) © Pitboxdev

package/dist/index.d.mts

@@ -0,0 +1,133 @@
+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.
+ * Mirrors the React useState updater pattern.
+ */
+type SetStateAction<T> = Partial<T> | ((prevState: T) => Partial<T>);
+/**
+ * Configuration options for useDynamicStore / useDynamicStoreWithCleanup.
+ */
+interface StoreConfig<T extends StoreState = StoreState> {
+    /** Keep state alive across navigation (not reset on resetNonPersistentStores). */
+    persistOnNavigation?: boolean;
+    /** Automatically reset state when the component unmounts. */
+    resetOnUnmount?: boolean;
+    /** Initial state values used on first mount and on reset. */
+    initialState?: T;
+}
+/**
+ * Internal registry entry stored per storeId in the manager.
+ */
+interface DynamicStoreRegistry {
+    data: StoreState;
+    config: StoreConfig;
+    initialState: StoreState;
+}
+/**
+ * A plain object that can serve as store state.
+ * 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 UseDynamicStoreReturn<T extends StoreState> {
+    data: T;
+    setData: (updater: SetStateAction<T>) => void;
+    reset: () => void;
+}
+/**
+ * Hook-based dynamic store keyed by `storeId`.
+ *
+ * `setData` accepts either a partial object **or** a function that receives
+ * the previous state and returns a partial object — exactly like React's
+ * `useState` setter.
+ *
+ * @example
+ * ```tsx
+ * const { data, setData, reset } = useDynamicStore<CounterState>('counter', {
+ *   initialState: { value: 0, step: 1 },
+ * });
+ *
+ * // object update
+ * setData({ value: 42 });
+ *
+ * // functional update — safe for rapid successive calls
+ * setData((prev) => ({ value: prev.value + prev.step }));
+ * ```
+ */
+declare function useDynamicStore<T extends StoreState>(storeId: string, config?: StoreConfig<T>): UseDynamicStoreReturn<T>;
+/**
+ * Same as `useDynamicStore` but automatically resets state when the
+ * component unmounts (when `config.resetOnUnmount` is `true`).
+ *
+ * @example
+ * ```tsx
+ * const { data, setData, reset } = useDynamicStoreWithCleanup<FormState>(
+ *   'editForm',
+ *   { initialState, resetOnUnmount: true },
+ * );
+ * ```
+ */
+declare function useDynamicStoreWithCleanup<T extends StoreState>(storeId: string, config?: StoreConfig<T>): UseDynamicStoreReturn<T>;
+/**
+ * Update a dynamic store from outside a React component.
+ */
+declare const updateDynamicStore: (storeId: string, data: StoreState) => void;
+/**
+ * Reset a single dynamic store to its initial state from outside React.
+ */
+declare const resetDynamicStore: (storeId: string) => void;
+/**
+ * Reset all dynamic stores to their initial states from outside React.
+ */
+declare const resetAllDynamicStores: () => void;
+/**
+ * Reset only stores that do not have `persistOnNavigation: true`.
+ */
+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 };

package/dist/index.d.ts

@@ -0,0 +1,133 @@
+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.
+ * Mirrors the React useState updater pattern.
+ */
+type SetStateAction<T> = Partial<T> | ((prevState: T) => Partial<T>);
+/**
+ * Configuration options for useDynamicStore / useDynamicStoreWithCleanup.
+ */
+interface StoreConfig<T extends StoreState = StoreState> {
+    /** Keep state alive across navigation (not reset on resetNonPersistentStores). */
+    persistOnNavigation?: boolean;
+    /** Automatically reset state when the component unmounts. */
+    resetOnUnmount?: boolean;
+    /** Initial state values used on first mount and on reset. */
+    initialState?: T;
+}
+/**
+ * Internal registry entry stored per storeId in the manager.
+ */
+interface DynamicStoreRegistry {
+    data: StoreState;
+    config: StoreConfig;
+    initialState: StoreState;
+}
+/**
+ * A plain object that can serve as store state.
+ * 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 UseDynamicStoreReturn<T extends StoreState> {
+    data: T;
+    setData: (updater: SetStateAction<T>) => void;
+    reset: () => void;
+}
+/**
+ * Hook-based dynamic store keyed by `storeId`.
+ *
+ * `setData` accepts either a partial object **or** a function that receives
+ * the previous state and returns a partial object — exactly like React's
+ * `useState` setter.
+ *
+ * @example
+ * ```tsx
+ * const { data, setData, reset } = useDynamicStore<CounterState>('counter', {
+ *   initialState: { value: 0, step: 1 },
+ * });
+ *
+ * // object update
+ * setData({ value: 42 });
+ *
+ * // functional update — safe for rapid successive calls
+ * setData((prev) => ({ value: prev.value + prev.step }));
+ * ```
+ */
+declare function useDynamicStore<T extends StoreState>(storeId: string, config?: StoreConfig<T>): UseDynamicStoreReturn<T>;
+/**
+ * Same as `useDynamicStore` but automatically resets state when the
+ * component unmounts (when `config.resetOnUnmount` is `true`).
+ *
+ * @example
+ * ```tsx
+ * const { data, setData, reset } = useDynamicStoreWithCleanup<FormState>(
+ *   'editForm',
+ *   { initialState, resetOnUnmount: true },
+ * );
+ * ```
+ */
+declare function useDynamicStoreWithCleanup<T extends StoreState>(storeId: string, config?: StoreConfig<T>): UseDynamicStoreReturn<T>;
+/**
+ * Update a dynamic store from outside a React component.
+ */
+declare const updateDynamicStore: (storeId: string, data: StoreState) => void;
+/**
+ * Reset a single dynamic store to its initial state from outside React.
+ */
+declare const resetDynamicStore: (storeId: string) => void;
+/**
+ * Reset all dynamic stores to their initial states from outside React.
+ */
+declare const resetAllDynamicStores: () => void;
+/**
+ * Reset only stores that do not have `persistOnNavigation: true`.
+ */
+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 };

package/dist/index.js

@@ -0,0 +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
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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":"4GAwBO,SAASA,EAIdC,CAAAA,CACgC,CAChC,GAAM,CAAE,YAAA,CAAAC,CAAAA,CAAc,QAAAC,CAAQ,CAAA,CAAIF,EAE5BG,CAAAA,CAAQC,cAAAA,GAAuC,CAACC,CAAAA,CAAKC,CAAAA,IAAS,CAClE,GAAGL,CAAAA,CACH,GAAGC,CAAAA,CAAQG,CAAAA,CAAKC,CAAG,CACrB,CAAA,CAAE,EAEF,OAAO,CACL,QAAA,CAAUH,CAAAA,CACV,KAAA,CAAAA,CACF,CACF,CCjBA,IAAMI,CAAAA,CAA0BH,cAAAA,GAC9BI,mBAAAA,CACGH,CAAAA,GAAS,CACR,MAAA,CAAQ,EAAC,CAET,YAAA,CAAc,CAACI,CAAAA,CAASC,EAAMV,CAAAA,GAAW,CACvCK,CAAAA,CAAKM,CAAAA,EAAU,CACb,IAAMC,EAAgBD,CAAAA,CAAM,MAAA,CAAOF,CAAO,CAAA,CAIpCI,CAAAA,CAA8B,CAClC,KAAM,CAAE,GAHRD,GAAe,IAAA,EAAQZ,CAAAA,EAAQ,cAAgB,EAAC,CAGxB,GAAGU,CAAK,CAAA,CAChC,MAAA,CAAQV,GAAUY,CAAAA,EAAe,MAAA,EAAU,EAAC,CAC5C,YAAA,CACEZ,CAAAA,EAAQ,cAAgBY,CAAAA,EAAe,YAAA,EAAgB,EAC3D,CAAA,CAEA,OAAO,CACL,MAAA,CAAQ,CAAE,GAAGD,CAAAA,CAAM,MAAA,CAAQ,CAACF,CAAO,EAAGI,CAAM,CAC9C,CACF,CAAC,EACH,CAAA,CAEA,UAAA,CAAaJ,CAAAA,EAAY,CACvBJ,CAAAA,CAAKM,CAAAA,EAAU,CACb,IAAMR,CAAAA,CAAQQ,CAAAA,CAAM,MAAA,CAAOF,CAAO,CAAA,CAClC,OAAKN,CAAAA,CAEE,CACL,OAAQ,CACN,GAAGQ,EAAM,MAAA,CACT,CAACF,CAAO,EAAG,CAAE,GAAGN,EAAO,IAAA,CAAM,CAAE,GAAGA,CAAAA,CAAM,YAAa,CAAE,CACzD,CACF,CAAA,CAPmBQ,CAQrB,CAAC,EACH,CAAA,CAEA,eAAgB,IAAM,CACpBN,EAAKM,CAAAA,EAAU,CACb,IAAMG,CAAAA,CAA6C,EAAC,CAEpD,IAAA,GAAW,CAACC,CAAAA,CAAIZ,CAAK,CAAA,GAAK,MAAA,CAAO,OAAA,CAAQQ,CAAAA,CAAM,MAAM,CAAA,CACnDG,EAAKC,CAAE,CAAA,CAAI,CAAE,GAAGZ,CAAAA,CAAO,IAAA,CAAM,CAAE,GAAGA,CAAAA,CAAM,YAAa,CAAE,CAAA,CAGzD,OAAO,CAAE,MAAA,CAAQW,CAAK,CACxB,CAAC,EACH,EAEA,wBAAA,CAA0B,IAAM,CAC9BT,CAAAA,CAAKM,CAAAA,EAAU,CACb,IAAMG,CAAAA,CAA6C,EAAC,CAEpD,IAAA,GAAW,CAACC,CAAAA,CAAIZ,CAAK,CAAA,GAAK,MAAA,CAAO,QAAQQ,CAAAA,CAAM,MAAM,EACnDG,CAAAA,CAAKC,CAAE,CAAA,CACLZ,CAAAA,CAAM,MAAA,CAAO,mBAAA,GAAwB,KACjCA,CAAAA,CACA,CAAE,GAAGA,CAAAA,CAAO,IAAA,CAAM,CAAE,GAAGA,CAAAA,CAAM,YAAa,CAAE,CAAA,CAGpD,OAAO,CAAE,OAAQW,CAAK,CACxB,CAAC,EACH,CACF,GACA,CAAE,IAAA,CAAM,sBAAuB,CACjC,CACF,CAAA,CAgCO,SAASE,CAAAA,CACdP,CAAAA,CACAT,CAAAA,CAC0B,CAC1B,IAAMiB,CAAAA,CAAgBV,GAAwB,CACxCW,CAAAA,CAAgBD,CAAAA,CAAc,MAAA,CAAOR,CAAO,CAAA,CAGlD,OAAAU,eAAAA,CAAU,IAAM,CACV,CAACD,CAAAA,EAAiBlB,GAAQ,YAAA,GAAiB,MAAA,EAC7CiB,CAAAA,CAAc,YAAA,CAAaR,CAAAA,CAAS,GAAIT,CAAqB,EAIjE,CAAA,CAAG,CAACS,CAAO,CAAC,EA4BL,CAAE,IAAA,CA1BKS,CAAAA,EAAe,IAAA,EAAQlB,CAAAA,EAAQ,YAAA,EAAgB,EAAC,CA0B/C,OAAA,CAxBEoB,GAAqC,CACpD,GAAI,OAAOA,CAAAA,EAAY,UAAA,CAAY,CACjC,IAAMC,CAAAA,CACJJ,CAAAA,CAAc,OAAOR,CAAO,CAAA,EAAG,IAAA,EAAQT,CAAAA,EAAQ,YAAA,EAAgB,GAE3DsB,CAAAA,CAAUF,CAAAA,CAAQC,CAAW,CAAA,CACnCJ,CAAAA,CAAc,YAAA,CACZR,EACAa,CAAAA,CACAtB,CACF,EACF,CAAA,KACEiB,CAAAA,CAAc,aACZR,CAAAA,CACAW,CAAAA,CACApB,CACF,EAEJ,CAAA,CAMwB,KAAA,CAJV,IAAY,CACxBiB,CAAAA,CAAc,UAAA,CAAWR,CAAO,EAClC,CAE8B,CAChC,CAgBO,SAASc,CAAAA,CACdd,CAAAA,CACAT,CAAAA,CAC0B,CAC1B,GAAM,CAAE,IAAA,CAAAU,EAAM,OAAA,CAAAc,CAAAA,CAAS,MAAAC,CAAM,CAAA,CAAIT,CAAAA,CAAmBP,CAAAA,CAAST,CAAM,CAAA,CAEnE,OAAAmB,eAAAA,CAAU,IACD,IAAM,CACPnB,CAAAA,EAAQ,cAAA,GAAmB,MAC7ByB,CAAAA,GAEJ,CAAA,CAEC,CAAChB,CAAAA,CAAST,CAAAA,EAAQ,cAAc,CAAC,CAAA,CAE7B,CAAE,IAAA,CAAAU,CAAAA,CAAM,QAAAc,CAAAA,CAAS,KAAA,CAAAC,CAAM,CAChC,CAOO,IAAMC,EAAqB,CAChCjB,CAAAA,CACAC,CAAAA,GACS,CACTH,CAAAA,CAAwB,QAAA,GAAW,YAAA,CAAaE,CAAAA,CAASC,CAAI,EAC/D,CAAA,CAKaiB,CAAAA,CAAqBlB,GAA0B,CAC1DF,CAAAA,CAAwB,UAAS,CAAE,UAAA,CAAWE,CAAO,EACvD,CAAA,CAKamB,CAAAA,CAAwB,IAAY,CAC/CrB,CAAAA,CAAwB,UAAS,CAAE,cAAA,GACrC,CAAA,CAKasB,CAAAA,CAAkC,IAAY,CACzDtB,CAAAA,CAAwB,QAAA,EAAS,CAAE,wBAAA,GACrC","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"]}

package/dist/index.mjs

@@ -0,0 +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
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@pitboxdev/dynamic-store-zustand",
+  "version": "0.0.1",
+  "description": "Dynamic store factory built on top of Zustand for scalable state management",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build",
+    "release": "npm version patch && git push origin main --follow-tags && npm publish"
+  },
+  "keywords": [
+    "zustand",
+    "pitboxdev",
+    "state-management",
+    "react",
+    "typescript"
+  ],
+  "author": "Pitboxdev",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "zustand": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.12",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "react": "^18.3.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "zustand": "^5.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pitboxdev/dynamic-store-zustand.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pitboxdev/dynamic-store-zustand/issues"
+  },
+  "homepage": "https://github.com/pitboxdev/dynamic-store-zustand#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}