hank-zilla 1.2.2 → 3.0.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 phamdung2209
-
-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.
+MIT License
+
+Copyright (c) 2025 phamdung2209
+
+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

@@ -1,209 +1,116 @@
-# 🦖 Hank-Zilla
-
-A lightweight React state management library that eliminates the need for Context, Redux, or Providers. Share state across components as easily as `useState` with global accessibility.
-
-[![npm version](https://badge.fury.io/js/hank-zilla.svg)](https://badge.fury.io/js/hank-zilla)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
-
-## ✨ Features
-
--   🚀 **No Provider Required**: Share state globally without wrapping components in Providers
--   🔄 **Drop-in Replacement**: Replace `useState` with `useAppState` for global state
--   🎯 **Access Anywhere**: Use the same state in any component, anywhere in your app
--   🪶 **Lightweight**: Zero dependencies, minimal bundle size (~2.1KB)
--   ⚡ **Fast**: Built on React's `useSyncExternalStore` for optimal performance
--   📦 **TypeScript**: Full TypeScript support with type inference
-
-## 📦 Installation
-
-```bash
-npm install hank-zilla
-```
-
-## 🚀 Quick Start
-
-```typescript
-import { useAppState, setAppState, getAppState } from 'hank-zilla'
-
-// Parent Component - Set state
-function ParentComponent() {
-    const user = useAppState('user', { name: '', email: '' })
-
-    return (
-        <div>
-            <button
-                onClick={() => setAppState('user', { name: 'John Doe', email: 'john@example.com' })}
-            >
-                Set User
-            </button>
-            <ChildComponent />
-        </div>
-    )
-}
-
-// Child Component - Access same state (no props needed!)
-function ChildComponent() {
-    const user = useAppState('user')
-
-    return <div>{user ? `Welcome, ${user.name}!` : 'No user logged in'}</div>
-}
-```
-
-## 📖 API Reference
-
-### `useAppState(key, defaultValue?, removeOnUnmount?)`
-
-React hook for managing global state - works exactly like `useState` but globally accessible.
-
-```typescript
-// Basic usage
-const count = useAppState('count', 0)
-
-// Auto-cleanup when component unmounts
-const tempData = useAppState('tempData', null, true)
-
-// TypeScript support
-interface User {
-    name: string
-    email: string
-}
-const user = useAppState<User>('user', null)
-```
-
-### `setAppState(key, value)`
-
-Update state from anywhere in your app - works with values or updater functions.
-
-```typescript
-// Set value directly
-setAppState('count', 42)
-
-// Update with function (like useState)
-setAppState('count', (prev) => prev + 1)
-
-// Update object (shallow merge)
-setAppState('user', { name: 'John' })
-
-// Update array
-setAppState('items', (prev) => [...prev, 'new item'])
-```
-
-### `getAppState(key?)`
-
-Get state value without subscribing to changes (no re-renders).
-
-```typescript
-// Get specific key
-const currentCount = getAppState('count')
-
-// Get all state
-const allState = getAppState()
-
-// ⚠️ Note: This doesn't trigger re-renders when state changes
-```
-
-### `$getAppState` (Console Helper)
-
-Debug helper available in browser console to inspect your app state.
-
-```javascript
-// In browser console
-$getAppState // Returns all state
-$getAppState('key') // Returns specific key
-```
-
-## 🎯 Advanced Usage
-
-### Auto-cleanup with `removeOnUnmount`
-
-```typescript
-function TemporaryComponent() {
-    // This state will be deleted when component unmounts
-    const [data, setData] = useAppState('tempData', [], true)
-
-    return <div>Temporary data: {data.length} items</div>
-}
-```
-
-### TypeScript Support
-
-```typescript
-interface CartItem {
-    id: string
-    name: string
-    price: number
-}
-
-// Type inference
-const [cart, setCart] = useAppState<CartItem[]>('cart', [])
-
-// Add item with type safety
-const addItem = (item: CartItem) => {
-    setCart((prev) => [...prev, item])
-}
-```
-
-### Performance: When to use `getAppState`
-
-```typescript
-// ✅ Good: Use useAppState for UI components
-function Counter() {
-    const [count, setCount] = useAppState('count', 0)
-    return <div>Count: {count}</div> // Re-renders when count changes
-}
-
-// ✅ Good: Use getAppState for utilities/callbacks
-function logCurrentState() {
-    const count = getAppState('count')
-    console.log('Current count:', count) // No re-renders
-}
-```
-
-## 📊 Comparison
-
-| Feature           | Hank-Zilla  | Context API       | Redux              | Zustand     |
-| ----------------- | ----------- | ----------------- | ------------------ | ----------- |
-| **Setup**         | ❌ None     | ✅ Provider       | ✅ Store + Actions | ✅ Store    |
-| **Bundle Size**   | 🟢 ~1.3KB   | 🟢 Built-in       | 🔴 ~45KB           | 🟡 ~8KB     |
-| **Global Access** | ✅ Anywhere | ❌ Provider scope | ✅ Anywhere        | ✅ Anywhere |
-| **TypeScript**    | 🟢 Full     | 🟡 Manual         | 🟢 Full            | 🟢 Full     |
-
-## 🔧 Migration
-
-### From `useState` to `useAppState`
-
-```typescript
-// Before: Local state
-const [count, setCount] = useState(0)
-
-// After: Global state
-const count = useAppState('count', 0)
-```
-
-### From Context API
-
-```typescript
-// Before: Complex setup
-const UserContext = createContext()
-const { user, setUser } = useContext(UserContext)
-
-// After: Direct usage
-const user = useAppState('user', null)
-```
-
-## 🤝 Contributing
-
-Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.
-
-## 📄 License
-
-MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 🙏 Acknowledgments
-
-Built with ❤️ by [phamdung2209](https://github.com/phamdung2209) • Special thanks to the React team for `useSyncExternalStore`
-
----
-
-Made with 🦖 by the Hank-Zilla team
+# 🦖 Hank-Zilla
+
+Global React state with the ergonomics of `useState` — no Provider, no boilerplate, no dependencies.
+
+[![npm version](https://badge.fury.io/js/hank-zilla.svg)](https://badge.fury.io/js/hank-zilla)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+
+## Features
+
+- **No Provider** — read and write the same state from any component
+- **Familiar** — `useAppState` reads like `useState`, but global
+- **Tiny** — zero dependencies, ~0.7 KB gzipped
+- **Correct** — built on `useSyncExternalStore`, concurrent-safe
+- **Typed** — full TypeScript inference
+
+## Install
+
+```bash
+npm install hank-zilla
+```
+
+## Quick start
+
+`useAppState` returns the **value** and subscribes to it. Write with `setAppState` from anywhere — no props, no context.
+
+```tsx
+import { useAppState, setAppState } from 'hank-zilla'
+
+function Counter() {
+    const count = useAppState('count', 0)
+    return <button onClick={() => setAppState('count', (n) => n + 1)}>{count}</button>
+}
+
+// Another component, same state — nothing passed down
+function Readout() {
+    const count = useAppState('count')
+    return <p>Count is {count}</p>
+}
+```
+
+## API
+
+### `useAppState<T>(key, defaultValue?, removeOnUnmount?, silent?) → T`
+
+Subscribe to a key and get its current value. Re-renders only when that key changes.
+
+```tsx
+const count = useAppState('count', 0)
+const user = useAppState<User>('user', null)
+const temp = useAppState('draft', '', true) // removed from the store on unmount
+```
+
+### `setAppState(key, value | updater, silent?)`
+
+Write a key from anywhere. A plain value **replaces**; a function is an **updater** `(prev) => next`.
+
+```tsx
+setAppState('count', 42) // replace
+setAppState('count', (n) => n + 1) // updater
+setAppState('user', { name: 'Jane' }) // replaces the whole value
+setAppState('user', (u) => ({ ...u, name: 'Jane' })) // merge — via updater
+setAppState('items', (list) => [...list, item]) // append — via updater
+```
+
+Each key is independent: writing `count` never touches `user`. Pass `silent` to update without notifying subscribers.
+
+### `getAppState(key?)`
+
+Read without subscribing — no re-render. Handy in callbacks and utilities.
+
+```tsx
+getAppState('count') // one key
+getAppState() // the whole store
+```
+
+### `deleteAppState(key)`
+
+Remove a key and re-render its subscribers (they fall back to their default).
+
+### `$getAppState()` — console helper
+
+Exposed on `globalThis` for debugging in the browser console.
+
+```js
+$getAppState() // the whole store
+$getAppState('count') // one key
+```
+
+## Comparison
+
+| | Hank-Zilla | Context API | Redux | Zustand |
+| --- | --- | --- | --- | --- |
+| Provider needed | No | Yes | Yes | No |
+| Boilerplate | None | Some | High | Low |
+| Global access | Yes | Provider scope | Yes | Yes |
+| Bundle (gzip) | ~0.7 KB | built-in | large | ~1 KB |
+| TypeScript | Full | Manual | Full | Full |
+
+## Migration
+
+```tsx
+// Local state
+const [count, setCount] = useState(0)
+setCount((n) => n + 1)
+
+// Global state
+const count = useAppState('count', 0)
+setAppState('count', (n) => n + 1)
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Built by [phamdung2209](https://github.com/phamdung2209) 🦖

package/dist/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 phamdung2209
-
-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.
+MIT License
+
+Copyright (c) 2025 phamdung2209
+
+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/dist/README.md

@@ -1,209 +1,116 @@
-# 🦖 Hank-Zilla
-
-A lightweight React state management library that eliminates the need for Context, Redux, or Providers. Share state across components as easily as `useState` with global accessibility.
-
-[![npm version](https://badge.fury.io/js/hank-zilla.svg)](https://badge.fury.io/js/hank-zilla)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
-
-## ✨ Features
-
--   🚀 **No Provider Required**: Share state globally without wrapping components in Providers
--   🔄 **Drop-in Replacement**: Replace `useState` with `useAppState` for global state
--   🎯 **Access Anywhere**: Use the same state in any component, anywhere in your app
--   🪶 **Lightweight**: Zero dependencies, minimal bundle size (~2.1KB)
--   ⚡ **Fast**: Built on React's `useSyncExternalStore` for optimal performance
--   📦 **TypeScript**: Full TypeScript support with type inference
-
-## 📦 Installation
-
-```bash
-npm install hank-zilla
-```
-
-## 🚀 Quick Start
-
-```typescript
-import { useAppState, setAppState, getAppState } from 'hank-zilla'
-
-// Parent Component - Set state
-function ParentComponent() {
-    const user = useAppState('user', { name: '', email: '' })
-
-    return (
-        <div>
-            <button
-                onClick={() => setAppState('user', { name: 'John Doe', email: 'john@example.com' })}
-            >
-                Set User
-            </button>
-            <ChildComponent />
-        </div>
-    )
-}
-
-// Child Component - Access same state (no props needed!)
-function ChildComponent() {
-    const user = useAppState('user')
-
-    return <div>{user ? `Welcome, ${user.name}!` : 'No user logged in'}</div>
-}
-```
-
-## 📖 API Reference
-
-### `useAppState(key, defaultValue?, removeOnUnmount?)`
-
-React hook for managing global state - works exactly like `useState` but globally accessible.
-
-```typescript
-// Basic usage
-const count = useAppState('count', 0)
-
-// Auto-cleanup when component unmounts
-const tempData = useAppState('tempData', null, true)
-
-// TypeScript support
-interface User {
-    name: string
-    email: string
-}
-const user = useAppState<User>('user', null)
-```
-
-### `setAppState(key, value)`
-
-Update state from anywhere in your app - works with values or updater functions.
-
-```typescript
-// Set value directly
-setAppState('count', 42)
-
-// Update with function (like useState)
-setAppState('count', (prev) => prev + 1)
-
-// Update object (shallow merge)
-setAppState('user', { name: 'John' })
-
-// Update array
-setAppState('items', (prev) => [...prev, 'new item'])
-```
-
-### `getAppState(key?)`
-
-Get state value without subscribing to changes (no re-renders).
-
-```typescript
-// Get specific key
-const currentCount = getAppState('count')
-
-// Get all state
-const allState = getAppState()
-
-// ⚠️ Note: This doesn't trigger re-renders when state changes
-```
-
-### `$getAppState` (Console Helper)
-
-Debug helper available in browser console to inspect your app state.
-
-```javascript
-// In browser console
-$getAppState // Returns all state
-$getAppState('key') // Returns specific key
-```
-
-## 🎯 Advanced Usage
-
-### Auto-cleanup with `removeOnUnmount`
-
-```typescript
-function TemporaryComponent() {
-    // This state will be deleted when component unmounts
-    const [data, setData] = useAppState('tempData', [], true)
-
-    return <div>Temporary data: {data.length} items</div>
-}
-```
-
-### TypeScript Support
-
-```typescript
-interface CartItem {
-    id: string
-    name: string
-    price: number
-}
-
-// Type inference
-const [cart, setCart] = useAppState<CartItem[]>('cart', [])
-
-// Add item with type safety
-const addItem = (item: CartItem) => {
-    setCart((prev) => [...prev, item])
-}
-```
-
-### Performance: When to use `getAppState`
-
-```typescript
-// ✅ Good: Use useAppState for UI components
-function Counter() {
-    const [count, setCount] = useAppState('count', 0)
-    return <div>Count: {count}</div> // Re-renders when count changes
-}
-
-// ✅ Good: Use getAppState for utilities/callbacks
-function logCurrentState() {
-    const count = getAppState('count')
-    console.log('Current count:', count) // No re-renders
-}
-```
-
-## 📊 Comparison
-
-| Feature           | Hank-Zilla  | Context API       | Redux              | Zustand     |
-| ----------------- | ----------- | ----------------- | ------------------ | ----------- |
-| **Setup**         | ❌ None     | ✅ Provider       | ✅ Store + Actions | ✅ Store    |
-| **Bundle Size**   | 🟢 ~1.3KB   | 🟢 Built-in       | 🔴 ~45KB           | 🟡 ~8KB     |
-| **Global Access** | ✅ Anywhere | ❌ Provider scope | ✅ Anywhere        | ✅ Anywhere |
-| **TypeScript**    | 🟢 Full     | 🟡 Manual         | 🟢 Full            | 🟢 Full     |
-
-## 🔧 Migration
-
-### From `useState` to `useAppState`
-
-```typescript
-// Before: Local state
-const [count, setCount] = useState(0)
-
-// After: Global state
-const count = useAppState('count', 0)
-```
-
-### From Context API
-
-```typescript
-// Before: Complex setup
-const UserContext = createContext()
-const { user, setUser } = useContext(UserContext)
-
-// After: Direct usage
-const user = useAppState('user', null)
-```
-
-## 🤝 Contributing
-
-Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.
-
-## 📄 License
-
-MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 🙏 Acknowledgments
-
-Built with ❤️ by [phamdung2209](https://github.com/phamdung2209) • Special thanks to the React team for `useSyncExternalStore`
-
----
-
-Made with 🦖 by the Hank-Zilla team
+# 🦖 Hank-Zilla
+
+Global React state with the ergonomics of `useState` — no Provider, no boilerplate, no dependencies.
+
+[![npm version](https://badge.fury.io/js/hank-zilla.svg)](https://badge.fury.io/js/hank-zilla)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+
+## Features
+
+- **No Provider** — read and write the same state from any component
+- **Familiar** — `useAppState` reads like `useState`, but global
+- **Tiny** — zero dependencies, ~0.7 KB gzipped
+- **Correct** — built on `useSyncExternalStore`, concurrent-safe
+- **Typed** — full TypeScript inference
+
+## Install
+
+```bash
+npm install hank-zilla
+```
+
+## Quick start
+
+`useAppState` returns the **value** and subscribes to it. Write with `setAppState` from anywhere — no props, no context.
+
+```tsx
+import { useAppState, setAppState } from 'hank-zilla'
+
+function Counter() {
+    const count = useAppState('count', 0)
+    return <button onClick={() => setAppState('count', (n) => n + 1)}>{count}</button>
+}
+
+// Another component, same state — nothing passed down
+function Readout() {
+    const count = useAppState('count')
+    return <p>Count is {count}</p>
+}
+```
+
+## API
+
+### `useAppState<T>(key, defaultValue?, removeOnUnmount?, silent?) → T`
+
+Subscribe to a key and get its current value. Re-renders only when that key changes.
+
+```tsx
+const count = useAppState('count', 0)
+const user = useAppState<User>('user', null)
+const temp = useAppState('draft', '', true) // removed from the store on unmount
+```
+
+### `setAppState(key, value | updater, silent?)`
+
+Write a key from anywhere. A plain value **replaces**; a function is an **updater** `(prev) => next`.
+
+```tsx
+setAppState('count', 42) // replace
+setAppState('count', (n) => n + 1) // updater
+setAppState('user', { name: 'Jane' }) // replaces the whole value
+setAppState('user', (u) => ({ ...u, name: 'Jane' })) // merge — via updater
+setAppState('items', (list) => [...list, item]) // append — via updater
+```
+
+Each key is independent: writing `count` never touches `user`. Pass `silent` to update without notifying subscribers.
+
+### `getAppState(key?)`
+
+Read without subscribing — no re-render. Handy in callbacks and utilities.
+
+```tsx
+getAppState('count') // one key
+getAppState() // the whole store
+```
+
+### `deleteAppState(key)`
+
+Remove a key and re-render its subscribers (they fall back to their default).
+
+### `$getAppState()` — console helper
+
+Exposed on `globalThis` for debugging in the browser console.
+
+```js
+$getAppState() // the whole store
+$getAppState('count') // one key
+```
+
+## Comparison
+
+| | Hank-Zilla | Context API | Redux | Zustand |
+| --- | --- | --- | --- | --- |
+| Provider needed | No | Yes | Yes | No |
+| Boilerplate | None | Some | High | Low |
+| Global access | Yes | Provider scope | Yes | Yes |
+| Bundle (gzip) | ~0.7 KB | built-in | large | ~1 KB |
+| TypeScript | Full | Manual | Full | Full |
+
+## Migration
+
+```tsx
+// Local state
+const [count, setCount] = useState(0)
+setCount((n) => n + 1)
+
+// Global state
+const count = useAppState('count', 0)
+setAppState('count', (n) => n + 1)
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Built by [phamdung2209](https://github.com/phamdung2209) 🦖

package/dist/useAppState/appState.d.ts

@@ -2,7 +2,7 @@ declare const store: {
     state: Record<string, any>;
     getState: () => Record<string, any>;
     subscribe: (callback: () => void) => () => boolean;
-    setState: (newState: Record<string, any>, silent?: boolean) => void;
+    setState: (changes: Record<string, any>, silent?: boolean) => void;
 };
 export declare const useAppState: <T>(key: string, defaultValue?: T, removeOnUnmount?: boolean, silent?: boolean) => T;
 export declare const setAppState: (key: string, newValue: any, silent?: boolean) => void;

package/dist/useAppState/appState.js

@@ -1 +1 @@
-import{useEffect,useSyncExternalStore}from"react";import init$ from"./init$";const listeners=new Set,store={state:{},getState:()=>store.state,subscribe:t=>(listeners.add(t),()=>listeners.delete(t)),setState:(t,e)=>{store.state={...store.state,...Object.entries(t).reduce((t,[e,s])=>{const r=store.state[e];return t[e]="function"==typeof s?s(r):"object"==typeof s&&null!==s?Array.isArray(s)?Array.isArray(r)?[...r,...s]:[...s]:0===Object.keys(s).length?s:{...r||{},...s}:s,t},{})},e||listeners.forEach(t=>t())}};export const useAppState=(t,e,s=!1,r)=>(t in store.state||void 0===e||store.setState({[t]:e},r),useEffect(()=>()=>{s&&deleteAppState(t)},[t,s]),useSyncExternalStore(store.subscribe,()=>store.state[t]??e,()=>e));export const setAppState=(t,e,s)=>{store.setState({[t]:e},s)};export const getAppState=t=>void 0===t?store.getState():store.getState()[t];export const deleteAppState=t=>{t in store.state&&delete store.state[t]};init$({getAppState:getAppState});export default store;
+import{useEffect,useSyncExternalStore}from"react";import init$ from"./init$";const listeners=new Set,store={state:{},getState:()=>store.state,subscribe:t=>(listeners.add(t),()=>listeners.delete(t)),setState:(t,e)=>{const s={...store.state};for(const[e,o]of Object.entries(t))s[e]="function"==typeof o?o(store.state[e]):o;store.state=s,e||listeners.forEach(t=>t())}};export const useAppState=(t,e,s=!1,o)=>(t in store.state||void 0===e||store.setState({[t]:e},o),useEffect(()=>()=>{s&&deleteAppState(t)},[t,s]),useSyncExternalStore(store.subscribe,()=>store.state[t]??e,()=>e));export const setAppState=(t,e,s)=>{store.setState({[t]:e},s)};export const getAppState=t=>void 0===t?store.getState():store.getState()[t];export const deleteAppState=t=>{t in store.state&&(delete store.state[t],listeners.forEach(t=>t()))};init$({getAppState:getAppState});export default store;

package/package.json

@@ -1,70 +1,70 @@
-{
-    "name": "hank-zilla",
-    "version": "1.2.2",
-    "description": "A lightweight React state management library with modular architecture",
-    "main": "dist/index.js",
-    "module": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "repository": {
-        "url": "https://github.com/phamdung2209/hank_zilla.git",
-        "type": "git"
-    },
-    "bugs": {
-        "url": "https://github.com/phamdung2209/hank_zilla/issues"
-    },
-    "exports": {
-        ".": {
-            "import": "./dist/index.js",
-            "require": "./dist/index.js",
-            "types": "./dist/index.d.ts"
-        },
-        "./useAppState": {
-            "import": "./dist/useAppState/index.js",
-            "require": "./dist/useAppState/index.js",
-            "types": "./dist/useAppState/index.d.ts"
-        },
-        "./package.json": "./package.json"
-    },
-    "files": [
-        "dist",
-        "README.md",
-        "LICENSE"
-    ],
-    "scripts": {
-        "build": "npm run clean && tsc && npm run minify && npm run copy-files",
-        "minify": "npm run minify-index && npm run minify-useappstate",
-        "minify-index": "terser dist/index.js -o dist/index.js -c -m",
-        "minify-useappstate": "terser dist/useAppState/index.js -o dist/useAppState/index.js -c -m && terser dist/useAppState/appState.js -o dist/useAppState/appState.js -c -m",
-        "copy-files": "npm run copy-readme && npm run copy-license",
-        "copy-readme": "cp README.md dist/ || copy README.md dist\\",
-        "copy-license": "cp LICENSE dist/ || copy LICENSE dist\\ || echo 'LICENSE not found'",
-        "dev": "tsc --watch",
-        "clean": "rimraf dist",
-        "prepublishOnly": "npm run build",
-        "postbuild": "ls -la dist || dir dist",
-        "release:patch": "npm version patch && npm publish && git push origin --tags",
-        "release:minor": "npm version minor && npm publish && git push origin --tags",
-        "release:major": "npm version major && npm publish && git push origin --tags",
-        "test": "echo \"Error: no test specified\" && exit 1"
-    },
-    "keywords": [
-        "react",
-        "state-management",
-        "hook",
-        "useState",
-        "global-state",
-        "modular",
-        "tree-shaking"
-    ],
-    "author": "phamdung2209",
-    "license": "MIT",
-    "peerDependencies": {
-        "react": ">=16.8.0"
-    },
-    "devDependencies": {
-        "@types/react": "^19.1.8",
-        "typescript": "^5.8.3",
-        "rimraf": "^6.0.1",
-        "terser": "^5.36.0"
-    }
-}
+{
+    "name": "hank-zilla",
+    "version": "3.0.1",
+    "description": "A lightweight React state management library with modular architecture",
+    "main": "dist/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "repository": {
+        "url": "https://github.com/phamdung2209/hank_zilla.git",
+        "type": "git"
+    },
+    "bugs": {
+        "url": "https://github.com/phamdung2209/hank_zilla/issues"
+    },
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        },
+        "./useAppState": {
+            "import": "./dist/useAppState/index.js",
+            "require": "./dist/useAppState/index.js",
+            "types": "./dist/useAppState/index.d.ts"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "npm run clean && tsc && npm run minify && npm run copy-files",
+        "minify": "npm run minify-index && npm run minify-useappstate",
+        "minify-index": "terser dist/index.js -o dist/index.js -c -m",
+        "minify-useappstate": "terser dist/useAppState/index.js -o dist/useAppState/index.js -c -m && terser dist/useAppState/appState.js -o dist/useAppState/appState.js -c -m",
+        "copy-files": "npm run copy-readme && npm run copy-license",
+        "copy-readme": "cp README.md dist/ || copy README.md dist\\",
+        "copy-license": "cp LICENSE dist/ || copy LICENSE dist\\ || echo 'LICENSE not found'",
+        "dev": "tsc --watch",
+        "clean": "rimraf dist",
+        "prepublishOnly": "npm run build",
+        "postbuild": "ls -la dist || dir dist",
+        "release:patch": "npm version patch && npm publish && git push origin --tags",
+        "release:minor": "npm version minor && npm publish && git push origin --tags",
+        "release:major": "npm version major && npm publish && git push origin --tags",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "keywords": [
+        "react",
+        "state-management",
+        "hook",
+        "useState",
+        "global-state",
+        "modular",
+        "tree-shaking"
+    ],
+    "author": "phamdung2209",
+    "license": "MIT",
+    "peerDependencies": {
+        "react": ">=16.8.0"
+    },
+    "devDependencies": {
+        "@types/react": "^19.1.8",
+        "typescript": "^5.8.3",
+        "rimraf": "^6.0.1",
+        "terser": "^5.36.0"
+    }
+}