react-state-custom 1.0.32 → 1.0.33

package/README.md

@@ -1,8 +1,8 @@
 # React State Custom
 
-**Simple. Powerful. TypeScript-first.**
+**The "It's Just a Hook" State Manager for React.**
 
-A lightweight global React state management library that combines the simplicity of React hooks with the power of event-driven subscriptions. No boilerplate, no complexity—just pure, performant state management.
+Turn any React hook into a global store. Zero boilerplate. Full type safety. Automatic lifecycle management.
 
 [![Demo](https://img.shields.io/badge/Demo-Live-blue?style=flat-square)](https://vothanhdat.github.io/react-state-custom/)
 [![npm version](https://img.shields.io/npm/v/react-state-custom?style=flat-square)](https://www.npmjs.com/package/react-state-custom)
@@ -14,517 +14,178 @@ npm install react-state-custom
 
 🎮 **[Try the Live Demo →](https://vothanhdat.github.io/react-state-custom/)**
 
-## Quick Start (2 minutes)
+---
 
-If you already know how to write a component with `useState`, you're moments away from sharing that state everywhere.
+## ⚡ The 30-Second Pitch
 
-1. **Write a plain hook** – encapuslate data fetching, derived values, and actions inside a normal React hook.
-2. **Create a store** – `createStore('feature', useFeatureState)` creates a shared store and returns a `useStore` hook.
-3. **Mount `<AutoRootCtx />` once** – drop it near the top of your tree (wrap it with your own `ErrorBoundary` if desired).
-4. **Consume anywhere** – call the generated `useStore` hook to access data and actions.
+Stop writing reducers, actions, and manual providers. If you can write a React hook, you've already written your store.
 
 ```tsx
-const useFeatureState = ({ featureId }: { featureId: string }) => {
-  const [value, setValue] = useState(0)
-  const double = useMemo(() => value * 2, [value])
-  return { value, double, increment: () => setValue(v => v + 1) }
-}
-
-export const { useStore: useFeatureStore } = createStore('feature', useFeatureState)
-
-function AppShell() {
-  return (
-    <>
-      <AutoRootCtx Wrapper={ErrorBoundary} debugging={import.meta.env.DEV} />
-      <Routes />
-    </>
-  )
-}
-
-function FeatureMeter({ featureId }: { featureId: string }) {
-  const { value, double, increment } = useFeatureStore({ featureId })
-  return (
-    <section>
-      <strong>{value}</strong>
-      <em>{double}</em>
-      <button onClick={increment}>Add</button>
-    </section>
-  )
-}
-```
-
-That’s the entire workflow—no reducers, actions, or provider trees.
-
-## Why React State Custom?
-
-**Zero Boilerplate** • **Type-Safe** • **Selective Re-renders** • **Hook-Based** • **~10KB Bundle**
-
-React State Custom lets you write state management code that feels natural—because it **is** just React hooks. Use the same hooks you already know (`useState`, `useEffect`, etc.) to create powerful, shared global state without learning new paradigms.
-
-### When `useState` + `useEffect` Fall Short
-
-Even though React hooks are flexible, they start to hurt once state crosses component boundaries:
-
-- **Prop drilling & manual providers** – every time state needs to be shared, you create a context, memoize values, and remember to wrap trees.
-- **Coarse-grained re-renders** – updating one property forces every subscriber of that context to render, even if they don't consume the changed field.
-- **Lifecycle bookkeeping** – you manually manage instance lifetimes, clean up effects, and guard against components mounting before providers.
-- **Zero visibility** – there's no built-in way to inspect shared state, throttle noisy updates, or keep debugging breadcrumbs.
-
-React State Custom keeps your favorite hooks but layers on automatic context lifecycles, selective subscriptions, and built-in tooling so you can stay productive as your app grows.
-
-## ⚡ Quick Example
-
-### Without React State Custom (manual context plumbing)
-
-```typescript
-const CounterContext = createContext<{
-  count: number;
-  increment: () => void;
-  decrement: () => void;
-} | null>(null);
-
-function CounterProvider({ children }: { children: React.ReactNode }) {
-  const [count, setCount] = useState(0);
-  const value = useMemo(
-    () => ({
-      count,
-      increment: () => setCount(c => c + 1),
-      decrement: () => setCount(c => c - 1),
-    }),
-    [count]
-  );
-
-  return <CounterContext.Provider value={value}>{children}</CounterContext.Provider>;
+// 1. Write a standard hook (your store logic)
+const useCountState = ({ initial = 0 }) => {
+  const [count, setCount] = useState(initial)
+  const increment = () => setCount(c => c + 1)
+  return { count, increment }
 }
 
-function useCounter() {
-  const ctx = useContext(CounterContext);
-  if (!ctx) throw new Error('CounterProvider missing');
-  return ctx;
-}
-```
-
-Every consumer re-renders whenever anything in `value` changes, you have to remember to wrap parts of the tree with `CounterProvider`, and tearing this pattern down for parameterized instances gets messy fast.
+// 2. Create a store
+export const { useStore } = createStore('counter', useCountState)
 
-### With React State Custom (hook-first store)
-
-### With React State Custom (hook-first store)
-
-```typescript
-import { createStore, AutoRootCtx } from 'react-state-custom';
-
-// 1. Write your state logic using familiar React hooks
-function useCounterState() {
-  const [count, setCount] = useState(0);
-  const increment = () => setCount(c => c + 1);
-  const decrement = () => setCount(c => c - 1);
-  
-  return { count, increment, decrement };
-}
-
-// 2. Create shared store (one line!)
-const { useStore } = createStore('counter', useCounterState);
-
-// 3. Add AutoRootCtx to your app root (mount it once near the top of your tree)
+// 3. Setup (mount once at root) & Use anywhere
 function App() {
   return (
     <>
-      <AutoRootCtx />
+      <AutoRootCtx /> {/* 👈 The magic that manages your stores */}
       <Counter />
     </>
-  );
+  )
 }
 
-// 4. Use anywhere in your app
 function Counter() {
-  const { count, increment, decrement } = useStore({});
-  
-  return (
-    <div>
-      <h1>{count}</h1>
-      <button onClick={increment}>+</button>
-      <button onClick={decrement}>-</button>
-    </div>
-  );
+  const { count, increment } = useStore({ initial: 10 })
+  return <button onClick={increment}>{count}</button>
 }
 ```
 
-> ℹ️ `AutoRootCtx` accepts optional `Wrapper` and `debugging` props. Pass an ErrorBoundary-like component through `Wrapper` to isolate failures, or set `debugging` to `true` to render raw state snapshots in the DOM (handy alongside React DevTools when tracking updates).
+**That's it.** No `Provider` wrapping per store. No complex setup. Just hooks.
 
-`useStore` keeps `Counter` focused on `count`, so even if this context grows with more fields later, the component only re-renders when `count` changes.
-
-**That's it!** No reducers, no actions, no providers to wrap—just hooks.
+---
 
-## Core Concepts in Plain English
+## 🚀 Why React State Custom?
 
-- **Contexts on demand** – `Context` extends `EventTarget`, so every state update is just an event dispatch. `getContext` memoizes instances per name and `useDataContext` automatically bumps a counter so unused contexts self-evict shortly after the last consumer unmounts.
-- **Publishers** – `useDataSource` and `useDataSourceMultiple` publish inside effects to keep renders pure. A registry guards against duplicate publishers fighting over the same key so you get actionable errors instead of stale data.
-- **Subscribers** – `useDataSubscribe*` hooks cover single, multiple, debounced, and transformed reads. `useQuickSubscribe` proxies the backing data object so each component subscribes only to the properties it touches.
-- **Root factories** – `createRootCtx` runs your headless hook exactly once per parameter set, publishes every returned key, and throws if two roots try to mount with the same resolved name. Your hook receives `(props, preState)` so it can rehydrate from the last published values when a root remounts. Parameters are serialized via `paramsToId`, so stick to primitive props (string/number/boolean/bigint/null/undefined) to keep IDs deterministic.
-- **Composable Stores** – Because stores are just hooks, you can subscribe to one store *inside* the logic of another. This enables powerful reactive chains where a derived store automatically updates whenever its upstream dependencies change.
-- **Auto orchestration** – Mount `<AutoRootCtx />` once and wire each root through `createAutoCtx`. The auto root listens for subscription requests, mounts/destroys the corresponding root on demand, and optionally keeps them alive for a configurable `timeToClean` window to smooth thrashing.
-- **Dev tooling** – `DevToolContainer` watches the memoized context cache, flashes updates in place, and lets you plug in custom renderers so you can diff state right beside your UI.
+Most state libraries force you to learn a new way to write logic (reducers, atoms, proxies). **React State Custom** lets you use the React skills you already have.
 
-## Core Building Blocks (copy & paste ready)
+### 💎 Zero Boilerplate
+Define state with `useState`, `useEffect`, `useMemo`. No new syntax to learn.
 
-Familiarity beats theory, so here are the primitives you’ll reach for most often:
+### 🎯 Selective Re-renders
+Components only re-render when the specific data they use changes. Performance is built-in.
 
-### 1. Context – event-driven store
-```typescript
-const ctx = useDataContext<MyState>('my-state');
-```
+### 🔄 Automatic Lifecycle
+Stores are created when needed and destroyed when unused. No more manual cleanup or memory leaks.
 
-### 2. Data source – publish values
-```typescript
-useDataSource(ctx, 'count', count);
-```
+### 🛡️ TypeScript First
+Full type inference out of the box. Your IDE knows exactly what's in your store.
 
-### 3. Subscribers – pick exact fields
-```typescript
-const count = useDataSubscribe(ctx, 'count');
-const { count, name } = useDataSubscribeMultiple(ctx, 'count', 'name');
-```
+---
 
-### 4. Root context – run your hook once
-```typescript
-const { Root, useCtxState } = createRootCtx('my-state', useMyState);
-```
+## 🛠️ Quick Start
 
-### 5. Auto context – mount roots for you
-```typescript
-const { useCtxState } = createAutoCtx(rootContext);
-```
+### 1. Define Your State
+Write a hook that returns the data and actions you want to share.
 
-### 6. Store factory – all in one
 ```typescript
-const { useStore } = createStore('my-state', useMyState);
-```
+// features/userState.ts
+import { useState, useEffect } from 'react'
 
-### 6. Store factory – all in one
-```typescript
-const { useStore } = createStore('my-state', useMyState);
-```
-
-## 🎯 Key Features
-
-### 1. **Just React Hooks**
-Use `useState`, `useEffect`, `useMemo`, and any other React hooks you already know. No new concepts to learn.
-
-```typescript
-function useUserState({ userId }: { userId: string }) {
-  const [user, setUser] = useState(null);
-  const [loading, setLoading] = useState(true);
+export const useUserState = ({ userId }: { userId: string }) => {
+  const [user, setUser] = useState(null)
   
   useEffect(() => {
-    fetchUser(userId).then(setUser).finally(() => setLoading(false));
-  }, [userId]);
-  
-  return { user, loading };
+    fetchUser(userId).then(setUser)
+  }, [userId])
+
+  return { user, isLoading: !user }
 }
 ```
 
-### 2. **Selective Re-renders**
-Components only re-render when the **specific data they subscribe to** changes—not when anything in the state changes.
+### 2. Create the Store
+Use `createStore` to generate a hook for your components.
 
 ```typescript
-// Only re-renders when 'user' changes, not when 'loading' changes
-const { user } = useDataSubscribeMultiple(ctx, 'user');
+import { createStore } from 'react-state-custom'
+import { useUserState } from './features/userState'
 
-// Or subscribe to multiple fields
-const { user, loading } = useDataSubscribeMultiple(ctx, 'user', 'loading');
+export const { useStore: useUserStore } = createStore('user', useUserState)
 ```
 
-> ⚠️ `useQuickSubscribe` proxies are only readable during render. Destructure the properties you need immediately and avoid storing the proxy in refs, effects, or callbacks.
-
-### 3. **Automatic Context Management**
-With `AutoRootCtx`, state contexts are automatically created and destroyed as needed. Mount it once near your application root, optionally providing a `Wrapper` (for error boundaries) or enabling `debugging` to render live state snapshots in the DOM—useful context when pairing with React DevTools. No manual provider management required.
-
-### 4. **TypeScript First**
-Full type inference and type safety throughout. Your IDE knows exactly what's in your state.
-
-### 5. **Tiny Bundle Size**
-~10KB gzipped. No dependencies except React.
-
-## 🆚 Comparison with Hooks, Redux & Zustand
-
-| Feature | React State Custom | Plain Hooks (Context) | Redux | Zustand |
-|---------|-------------------|-----------------------|-------|---------|
-| **Bundle Size** | ~10KB | 0KB (just React) | ~50KB (with toolkit) | ~1KB |
-| **Learning Curve** | ✅ Minimal (just hooks) | ⚠️ Familiar APIs, but patterns are DIY | ❌ High (actions, reducers, middleware) | ✅ Low |
-| **Boilerplate** | ✅ None | ❌ Manual providers + prop drilling | ❌ Heavy | ✅ Minimal |
-| **Type Safety** | ✅ Full inference | ⚠️ Custom per-context typing | ⚠️ Requires setup | ✅ Good |
-| **Selective Re-renders** | ✅ Built-in | ❌ Context update = every consumer renders | ⚠️ Requires selectors | ✅ Built-in |
-| **DevTools** | ✅ Built-in UI | ❌ None | ✅ Redux DevTools | ✅ DevTools support |
-| **Async Support** | ✅ Native (hooks) | ✅ Native (hooks) | ⚠️ Requires middleware | ✅ Native |
-| **Context Composition** | ✅ Automatic | ❌ Manual provider trees | ❌ Manual | ⚠️ Manual store combination |
-
-### When to Use React State Custom
-
-✅ **Choose React State Custom if you:**
-- Want to use React hooks for state management without learning new patterns
-- Need fine-grained control over component re-renders
-- Prefer minimal boilerplate and configuration
-- Want automatic context lifecycle management
-- Need multiple independent state contexts that don't interfere
-
-❌ **Consider Redux if you:**
-- Need powerful time-travel debugging (Redux DevTools)
-- Have a very large team that benefits from strict architectural patterns
-- Already have significant Redux investment
-
-❌ **Consider Zustand if you:**
-- Want the absolute smallest bundle size
-- Need a simple global store without context isolation
-- Don't need automatic context lifecycle management
-
-## 🔥 Real-World Example: User Authentication
-
-```typescript
-// authState.ts
-function useAuthState() {
-  const [user, setUser] = useState<User | null>(null);
-  const [loading, setLoading] = useState(true);
-  
-  useEffect(() => {
-    // Check authentication on mount
-    checkAuth().then(setUser).finally(() => setLoading(false));
-  }, []);
-  
-  const login = async (email: string, password: string) => {
-    setLoading(true);
-    try {
-      const user = await authService.login(email, password);
-      setUser(user);
-    } finally {
-      setLoading(false);
-    }
-  };
-  
-  const logout = async () => {
-    await authService.logout();
-    setUser(null);
-  };
-  
-  return { user, loading, login, logout };
-}
-
-export const { useStore: useAuthStore } = createStore('auth', useAuthState);
+### 3. Mount the Root (Once)
+Add `<AutoRootCtx />` to your app's root. This component manages all your stores automatically.
 
+```tsx
 // App.tsx
-function App() {
+import { AutoRootCtx } from 'react-state-custom'
+
+export default function App() {
   return (
     <>
       <AutoRootCtx />
-      <Router>
-        <Header />
-        <Routes />
-      </Router>
+      <YourAppContent />
     </>
-  );
-}
-
-// Header.tsx - Only re-renders when user changes
-function Header() {
-  const { user, logout } = useAuthStore({});
-  
-  return (
-    <header>
-      {user ? (
-        <>
-          <span>Welcome, {user.name}</span>
-          <button onClick={logout}>Logout</button>
-        </>
-      ) : (
-        <Link to="/login">Login</Link>
-      )}
-    </header>
-  );
-}
-
-// ProtectedRoute.tsx - Only re-renders when loading or user changes
-function ProtectedRoute({ children }) {
-  const ctx = useAuthStore.useCtxState({});
-  const { user, loading } = useDataSubscribeMultiple(ctx, 'user', 'loading');
-  
-  if (loading) return <Spinner />;
-  if (!user) return <Navigate to="/login" />;
-  
-  return children;
+  )
 }
 ```
 
-**Compare with Redux:**
-```typescript
-// Redux requires: action types, action creators, reducers, thunks/sagas
-// React State Custom: just write a hook! ✨
-```
-
-## 🚀 Advanced Features
-
-Once you have a store running, layer in these power-ups as needed.
+### 🎭 Isolated State
 
-### Developer Tools
-Visual debugging component to inspect all your context data in real-time:
+Need to run multiple independent instances of your application or isolate features? Use `StateScopeProvider`.
 
-```typescript
-import { DevToolContainer } from 'react-state-custom';
-import 'react-state-custom/dist/react-state-custom.css';
+```tsx
+import { AutoRootCtx, StateScopeProvider } from 'react-state-custom'
 
 function App() {
   return (
     <>
-      <AutoRootCtx />
-      <YourAppContent />
-      <DevToolContainer />
+      <AutoRootCtx /> {/* Global Scope */}
+      <MainApp />
+
+      <StateScopeProvider>
+         {/* Isolated Scope - Stores here are independent of Global Scope */}
+         <IsolatedFeature />
+      </StateScopeProvider>
     </>
-  );
+  )
 }
 ```
 
-The toggle reveals a bottom-docked inspector that now uses resizable split panes powered by `@uiw/react-split`. Drag the gutter to adjust how much space the context list or detail view occupies while keeping your application visible above.
-
-**Custom data viewer with rich object visualization:**
-```typescript
-import { DataViewComponent } from 'react-state-custom';
-import { ObjectView } from 'react-obj-view';
-import 'react-obj-view/dist/react-obj-view.css'; // Required for ObjectView styling
+Stores used inside `StateScopeProvider` will be completely isolated from the parent or global scope, even if they share the same store definition.
 
-const CustomDataView: DataViewComponent = ({ name, value }) => {
-  return <ObjectView name={name} value={value} expandLevel={2} />;
-};
-
-<DevToolContainer Component={CustomDataView} />
-```
-
-Pass `children` to `DevToolContainer` to customize the floating toggle button label (for example `<DevToolContainer>State Inspector</DevToolContainer>`), and import `react-state-custom/dist/react-state-custom.css` once to pick up the overlay styles.
-
-### Parameterized Contexts
-Create multiple instances of the same state with different parameters:
-
-```typescript
-function useUserState({ userId }: { userId: string }) {
-  // State logic here
-}
-
-const { useStore: useUserStore } = createStore('user', useUserState);
+---
 
-// Different instances for different users
-function UserProfile({ userId }) {
-  const { user } = useUserStore({ userId }); // Automatic instance per userId
-  return <div>{user?.name}</div>;
-}
-```
+## 🆚 Comparison
 
-> Need to avoid rapid mount/unmount churn? Pass a second argument to `createStore` (for example `createStore('user', useUserState, 200)`) to keep instances alive for a few extra milliseconds before disposal.
+| Feature | React State Custom | Redux | Context API | Zustand |
+|:---|:---:|:---:|:---:|:---:|
+| **Paradigm** | Just Hooks 🪝 | Actions/Reducers | Providers | Store Object |
+| **Boilerplate** | 🟢 None | 🔴 High | 🟡 Medium | 🟢 Low |
+| **Auto Lifecycle** | ✅ Yes | ❌ No | ❌ No | ❌ No |
+| **Selective Renders** | ✅ Automatic | ⚠️ Selectors | ❌ Manual | ✅ Selectors |
+| **Learning Curve** | 🟢 Low | 🔴 High | 🟡 Medium | 🟢 Low |
 
-> ⚠️ The props you pass to `createStore`/`useStore` must be composed of primitive values (string, number, boolean, bigint, null, or undefined). Objects are rejected so context names stay deterministic—pass IDs instead of raw objects.
+---
 
-### Debounced Subscriptions
-Optimize performance for frequently changing values:
+## 🧩 Advanced Features
 
-```typescript
-// Re-render at most once per 300ms
-const searchQuery = useDataSubscribe(ctx, 'searchQuery', 300);
-```
+### 🔌 Developer Tools
+Inspect your state in real-time with the built-in DevTools.
 
-### Transformed Subscriptions
-Transform data before using it:
+```tsx
+import { DevToolContainer } from 'react-state-custom'
+import 'react-state-custom/dist/react-state-custom.css'
 
-```typescript
-const userStats = useDataSubscribeWithTransform(
-  ctx,
-  'user',
-  (user) => ({
-    fullName: `${user?.firstName} ${user?.lastName}`,
-    isAdmin: user?.role === 'admin'
-  })
-);
+<DevToolContainer />
 ```
 
-### Composing Stores (Derived State)
-Since stores are just hooks, you can subscribe to one store *inside* another. This allows you to build reactive dependency chains where a downstream store automatically updates when an upstream store changes.
+### 🆔 Parameterized Stores
+Create multiple independent instances of the same store by passing different parameters.
 
-```typescript
-// 1. Upstream Store
-const { useStore: useUserStore } = createStore('user', () => {
-  const [role, setRole] = useState('guest');
-  return { role, setRole };
-});
-
-// 2. Downstream Store (depends on User)
-const useDashboardStore = () => {
-  // Subscribe to the upstream store
-  const { role } = useUserStore({});
-
-  // Derive state based on the upstream value
-  const permissions = useMemo(() => {
-    return role === 'admin' ? ['read', 'write', 'delete'] : ['read'];
-  }, [role]);
-
-  return { permissions };
-};
-
-const { useStore: useDashboardStore } = createStore('dashboard', useDashboardStore);
+```tsx
+// Creates a unique store for each ID
+const { count } = useStore({ id: 'counter-1' })
+const { count } = useStore({ id: 'counter-2' })
 ```
 
-## 🎮 Live Examples
-
-Explore interactive examples in the **[Live Demo](https://vothanhdat.github.io/react-state-custom/)**:
-
-- **Counter** - Basic state management with increment, decrement, and reset
-- **Todo List** - Multiple independent lists with scoped contexts
-- **Form Validation** - Real-time validation with error handling
-- **Timer** - Side effects and cleanup with millisecond precision
-- **Shopping Cart** - Complex state with derived values (total, itemCount)
-
-Each example includes live code editing with syntax highlighting, powered by Sandpack!
-
-## 📖 Documentation
-
-For complete API documentation, examples, and advanced patterns, see:
-- **[API_DOCUMENTATION.md](./API_DOCUMENTATION.md)** - Complete API reference
-- **[Live Demo](https://vothanhdat.github.io/react-state-custom/)** - Interactive examples
-
-## 🛠️ Development
+### ⚡️ Derived State
+Compose stores just like hooks.
 
-```bash
-# Install dependencies
-yarn install
-
-# Run development UI with example selector
-yarn dev
-
-# Run interactive playground with live code editing
-yarn dev:playground
-
-# Build library
-yarn build
-
-# Build demo site
-yarn build:demo
-
-# Preview demo locally
-yarn preview
+```tsx
+const useCartTotal = () => {
+  const { items } = useCartStore({})
+  return items.reduce((total, item) => total + item.price, 0)
+}
 ```
 
-### Development Modes
-
-**`yarn dev`** - Starts a clean development UI with an interactive example selector. Great for:
-- Testing all examples in one place
-- Quick switching between different examples
-- Visual debugging with DevTool component
-
-**`yarn dev:playground`** - Starts the Sandpack-powered playground with live code editing. Perfect for:
-- Creating interactive demos
-- Live code editing and experimentation
-- Sharing editable examples
-
-## 🎓 Learning Path
-
-1. **Follow the Quick Start** – build one shared store end-to-end.
-2. **Layer on subscriptions** – swap `useQuickSubscribe` for the more specific `useDataSubscribe*` hooks where it makes sense.
-3. **Optimize when needed** – introduce debounced/transform subscriptions and `createAutoCtx` grace periods to smooth noisy stores.
-4. **Scale up** – add parameterized contexts (one store per ID) and wire the DevTool overlay for visibility.
+---
 
 ## 📦 Installation
 
@@ -532,18 +193,13 @@ yarn preview
 npm install react-state-custom
 # or
 yarn add react-state-custom
-# or
-pnpm add react-state-custom
 ```
 
-## 🤝 Contributing
+## 📖 Documentation
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+- **[API Reference](./API_DOCUMENTATION.md)** - Full API documentation.
+- **[Live Demo](https://vothanhdat.github.io/react-state-custom/)** - Interactive examples.
 
 ## 📄 License
 
-MIT License - feel free to use in any project.
-
----
-
-**Made with ❤️ for developers who love React hooks**
+MIT © Vo Thanh Dat

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { Context, getContext, useDataContext, useDataSource, useDataSourceMultiple, useDataSubscribe, useDataSubscribeMultiple, useDataSubscribeMultipleWithDebounce, useDataSubscribeWithTransform } from './state-utils/ctx';
 export { createRootCtx } from './state-utils/createRootCtx';
-export { AutoRootCtx, createAutoCtx, createStore } from './state-utils/createAutoCtx';
+export { AutoRootCtx, createAutoCtx, createStore, StateScopeProvider } from './state-utils/createAutoCtx';
 export { useArrayChangeId } from './state-utils/useArrayChangeId';
 export { paramsToId, type ParamsToIdRecord, type ParamsToIdInput } from './state-utils/paramsToId';
 export { useQuickSubscribe } from './state-utils/useQuickSubscribe';