zustand-kit 1.0.0 → 1.0.2

package/README.md

@@ -9,9 +9,10 @@
 - 🚀 **简单易用** - 最小化的 API 设计，易于上手
 - 🎯 **类型安全** - 完整的 TypeScript 支持
 - 💾 **持久化** - 内置 localStorage/sessionStorage 支持
+- 🔍 **开发者工具** - 开发环境自动集成 Redux DevTools
 - ⚡ **高性能** - 基于 Zustand，性能卓越
 - 🔄 **灵活更新** - 支持对象部分更新和函数式更新
-- 🎨 **选择器支持** - 细粒度订阅，避免不必要的重渲染
+- 🎨 **智能选择器** - 细粒度订阅，自动检测返回值类型并优化性能
 - 🌐 **非 React 环境支持** - 提供独立的 API 用于非组件场景
 
 ## 📦 安装
@@ -77,7 +78,7 @@ function UserProfile() {
 import { useGlobalState } from 'zustand-kit';
 
 function Settings() {
-  // 使用 localStorage 持久化
+  // 使用 localStorage 持久化（开发环境自动启用 DevTools）
   const [settings, setSettings] = useGlobalState(
     'settings',
     { theme: 'dark', lang: 'zh-CN' },
@@ -105,6 +106,29 @@ function Settings() {
 }
 ```
 
+### Redux DevTools 集成
+
+在开发环境下，所有全局状态会自动集成到统一的 Redux DevTools 视图中，便于调试：
+
+```tsx
+import { useGlobalState } from 'zustand-kit';
+
+// 开发环境自动启用 DevTools（默认行为）
+const [data, setData] = useGlobalState('data', { count: 0 });
+
+// 禁用 DevTools（即使在开发环境）
+const [privateData, setPrivateData] = useGlobalState('private', {}, {
+  enableDevtools: false
+});
+
+// 强制启用 DevTools（生产环境，不推荐）
+const [debugData, setDebugData] = useGlobalState('debug', {}, {
+  enableDevtools: true
+});
+```
+
+**注意：** 所有全局状态会聚合到一个名为 `GlobalStates (All)` 的 DevTools 实例中，每个状态以其 key 作为属性显示，方便统一查看和调试所有状态。
+
 ### 选择器模式（性能优化）
 
 ```tsx
@@ -112,6 +136,7 @@ import { useGlobalSelector } from 'zustand-kit';
 
 function UserName() {
   // 仅订阅 user.name，其他字段变化不会触发重渲染
+  // 自动检测：基本类型使用 Object.is
   const userName = useGlobalSelector('user', (state) => state.name);
 
   return <p>用户名: {userName}</p>;
@@ -123,6 +148,38 @@ function UserEmail() {
 
   return <p>邮箱: {userEmail}</p>;
 }
+
+// 自动检测：对象返回值自动使用浅比较
+function UserInfo() {
+  const userInfo = useGlobalSelector(
+    'user',
+    (state) => ({ name: state.name, email: state.email })
+    // 无需指定 'shallow'，自动检测对象类型并使用浅比较
+  );
+
+  return (
+    <div>
+      <p>姓名: {userInfo.name}</p>
+      <p>邮箱: {userInfo.email}</p>
+    </div>
+  );
+}
+
+// 显式指定 'shallow' 模式
+function UserInfoExplicit() {
+  const userInfo = useGlobalSelector(
+    'user',
+    (state) => ({ name: state.name, email: state.email }),
+    'shallow' // 显式指定浅比较
+  );
+
+  return (
+    <div>
+      <p>姓名: {userInfo.name}</p>
+      <p>邮箱: {userInfo.email}</p>
+    </div>
+  );
+}
 ```
 
 ### 仅获取 Setter（不订阅状态）
@@ -185,16 +242,25 @@ resetGlobalState('counter');
 - `options?: UseGlobalStateOptions` - 可选配置
   - `storage?: 'localStorage' | 'sessionStorage' | 'none'` - 持久化类型（默认 'none'）
   - `storageKey?: string` - 存储键前缀（默认 'global-state'）
+  - `enableDevtools?: boolean` - 是否启用 Redux DevTools（开发环境默认 true，生产环境默认 false）
 
 **返回：** `[state, setState, resetState]`
 
-### `useGlobalSelector<T, R>(key, selector)`
+**注意：** 对于对象类型的状态，`setState` 支持部分更新。例如：`setUser({ name: 'Jane' })` 只会更新 `name` 字段，其他字段保持不变。
+
+### `useGlobalSelector<T, R>(key, selector, equalityMode?)`
 
-使用选择器订阅状态的特定部分。
+使用选择器订阅状态的特定部分。支持自动检测返回值类型并选择合适的比较模式。
 
 **参数：**
 - `key: string` - 状态键
 - `selector: (state: T) => R` - 选择器函数
+- `equalityMode?: 'shallow' | false` - 可选的比较模式
+  - `undefined` (默认)：自动检测返回值类型
+    - 基本类型：使用 `Object.is`
+    - 对象/数组：使用浅比较
+  - `'shallow'`：强制使用浅比较
+  - `false`：强制使用 `Object.is` 比较（即使对象类型）
 
 **返回：** 选择的值
 

package/dist/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var V=Object.defineProperty;var d=Object.getOwnPropertySymbols;var x=Object.prototype.hasOwnProperty,A=Object.prototype.propertyIsEnumerable;var g=(t,e,o)=>e in t?V(t,e,{enumerable:!0,configurable:!0,writable:!0,value:o}):t[e]=o,T=(t,e)=>{for(var o in e||(e={}))x.call(e,o)&&g(t,o,e[o]);if(d)for(var o of d(e))A.call(e,o)&&g(t,o,e[o]);return t};var _zustand = require('zustand');var _middleware = require('zustand/middleware');var _react = require('react');var r=new Map;function _(){r.clear()}function B(t,e,o){let{storage:a="none",storageKey:i="global-state"}=o||{};if(!r.has(t)){let u=typeof e=="object"&&e!==null&&!Array.isArray(e),v=s=>({value:e,setValue:l=>{s(typeof l=="function"?p=>({value:l(p.value)}):u&&typeof l=="object"&&l!==null?p=>({value:T(T({},p.value),l)}):{value:l})},reset:()=>s({value:e})}),S;if(a!=="none"){let s=a==="localStorage"?localStorage:sessionStorage;S=_zustand.create.call(void 0, )(_middleware.persist.call(void 0, v,{name:`${i}-${t}`,storage:_middleware.createJSONStorage.call(void 0, ()=>s)}))}else S=_zustand.create.call(void 0, v);r.set(t,S)}let n=r.get(t),w=n(u=>u.value),b=_react.useMemo.call(void 0, ()=>n.getState().setValue,[n]),G=_react.useMemo.call(void 0, ()=>n.getState().reset,[n]);return[w,b,G]}function $(t,e){let o=r.get(t);if(!o)throw new Error(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return o(a=>e(a.value))}function I(t){let e=r.get(t);if(!e)throw new Error(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return _react.useMemo.call(void 0, ()=>e.getState().setValue,[e])}function z(t){let e=r.get(t);return e==null?void 0:e.getState().value}function P(t,e){let o=r.get(t);if(!o){process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return}o.getState().setValue(e)}function j(t,e){let o=r.get(t);if(!o)return process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`),()=>{};let a=o.getState().value;return o.subscribe(i=>{let n=i.value;n!==a&&(e(n,a),a=n)})}function C(t){let e=r.get(t);if(!e){process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return}e.getState().reset()}var D=B;exports.__clearAllStates__ = _; exports.default = D; exports.getGlobalState = z; exports.resetGlobalState = C; exports.setGlobalState = P; exports.subscribeGlobalState = j; exports.useGlobalSelector = $; exports.useGlobalSetter = I; exports.useGlobalState = B;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }var x=Object.defineProperty,E=Object.defineProperties;var N=Object.getOwnPropertyDescriptors;var h=Object.getOwnPropertySymbols;var O=Object.prototype.hasOwnProperty,D=Object.prototype.propertyIsEnumerable;var G=(t,e,o)=>e in t?x(t,e,{enumerable:!0,configurable:!0,writable:!0,value:o}):t[e]=o,T=(t,e)=>{for(var o in e||(e={}))O.call(e,o)&&G(t,o,e[o]);if(h)for(var o of h(e))D.call(e,o)&&G(t,o,e[o]);return t},A=(t,e)=>E(t,N(e));var _react = require('react'); var m = _interopRequireWildcard(_react);var _zustand = require('zustand');var _middleware = require('zustand/middleware');var _shallow = require('zustand/react/shallow');var a=new Map,i=null;function C(){return i||(i=_zustand.create.call(void 0, )(_middleware.devtools.call(void 0, ()=>({}),{name:"GlobalStates (All)"}))),i}function p(t,e){if(i){let o=i.getState();i.setState(A(T({},o),{[t]:e}))}}function X(){a.clear(),i=null}function k(t,e,o){let{storage:n="none",storageKey:u="global-state",enableDevtools:r=process.env.NODE_ENV!=="production"}=o||{};if(!a.has(t)){let c=typeof e=="object"&&e!==null&&!Array.isArray(e),V=(S,K)=>({value:e,setValue:l=>{typeof l=="function"?S(d=>{let f=l(d.value);return r&&p(t,f),{value:f}}):c&&typeof l=="object"&&l!==null?S(d=>{let f=T(T({},d.value),l);return r&&p(t,f),{value:f}}):(S({value:l}),r&&p(t,l))},reset:()=>{S({value:e}),r&&p(t,e)}}),g;if(n!=="none"){let S=n==="localStorage"?localStorage:sessionStorage;g=_zustand.create.call(void 0, )(_middleware.persist.call(void 0, V,{name:`${u}-${t}`,storage:_middleware.createJSONStorage.call(void 0, ()=>S)}))}else g=_zustand.create.call(void 0, V);a.set(t,g),r&&(C(),p(t,e))}let s=a.get(t),b=s(c=>c.value),B=_react.useMemo.call(void 0, ()=>c=>s.getState().setValue(c),[s]),R=_react.useMemo.call(void 0, ()=>()=>s.getState().reset(),[s]);return[b,B,R]}function Y(t,e,o){let n=a.get(t);if(!n)throw new Error(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);let u=_react.useRef.call(void 0, e);_react.useEffect.call(void 0, ()=>{u.current=e});let r=_react.useCallback.call(void 0, s=>u.current(s.value),[]);if(o===void 0){let s=r(n.getState());return s!==null&&typeof s=="object"&&!m.isValidElement(s)?n(_shallow.useShallow.call(void 0, r)):n(r)}return n(o==="shallow"?_shallow.useShallow.call(void 0, r):r)}function Z(t){let e=a.get(t);if(!e)throw new Error(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return _react.useMemo.call(void 0, ()=>o=>e.getState().setValue(o),[e])}function q(t){let e=a.get(t);return e==null?void 0:e.getState().value}function ee(t,e){let o=a.get(t);if(!o){process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return}o.getState().setValue(e)}function te(t,e){let o=a.get(t);if(!o)return process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`),()=>{};let n=o.getState().value;return o.subscribe(u=>{let r=u.value;Object.is(r,n)||(e(r,n),n=r)})}function oe(t){let e=a.get(t);if(!e){process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return}e.getState().reset()}var re=k;exports.__clearAllStates__ = X; exports.default = re; exports.getGlobalState = q; exports.resetGlobalState = oe; exports.setGlobalState = ee; exports.subscribeGlobalState = te; exports.useGlobalSelector = Y; exports.useGlobalSetter = Z; exports.useGlobalState = k;

package/dist/index.esm.js

@@ -1 +1 @@
-var V=Object.defineProperty;var d=Object.getOwnPropertySymbols;var x=Object.prototype.hasOwnProperty,A=Object.prototype.propertyIsEnumerable;var g=(t,e,o)=>e in t?V(t,e,{enumerable:!0,configurable:!0,writable:!0,value:o}):t[e]=o,T=(t,e)=>{for(var o in e||(e={}))x.call(e,o)&&g(t,o,e[o]);if(d)for(var o of d(e))A.call(e,o)&&g(t,o,e[o]);return t};import{create as f}from"zustand";import{persist as h,createJSONStorage as U}from"zustand/middleware";import{useMemo as c}from"react";var r=new Map;function _(){r.clear()}function B(t,e,o){let{storage:a="none",storageKey:i="global-state"}=o||{};if(!r.has(t)){let u=typeof e=="object"&&e!==null&&!Array.isArray(e),v=s=>({value:e,setValue:l=>{s(typeof l=="function"?p=>({value:l(p.value)}):u&&typeof l=="object"&&l!==null?p=>({value:T(T({},p.value),l)}):{value:l})},reset:()=>s({value:e})}),S;if(a!=="none"){let s=a==="localStorage"?localStorage:sessionStorage;S=f()(h(v,{name:`${i}-${t}`,storage:U(()=>s)}))}else S=f(v);r.set(t,S)}let n=r.get(t),w=n(u=>u.value),b=c(()=>n.getState().setValue,[n]),G=c(()=>n.getState().reset,[n]);return[w,b,G]}function $(t,e){let o=r.get(t);if(!o)throw new Error(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return o(a=>e(a.value))}function I(t){let e=r.get(t);if(!e)throw new Error(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return c(()=>e.getState().setValue,[e])}function z(t){let e=r.get(t);return e==null?void 0:e.getState().value}function P(t,e){let o=r.get(t);if(!o){process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return}o.getState().setValue(e)}function j(t,e){let o=r.get(t);if(!o)return process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`),()=>{};let a=o.getState().value;return o.subscribe(i=>{let n=i.value;n!==a&&(e(n,a),a=n)})}function C(t){let e=r.get(t);if(!e){process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return}e.getState().reset()}var D=B;export{_ as __clearAllStates__,D as default,z as getGlobalState,C as resetGlobalState,P as setGlobalState,j as subscribeGlobalState,$ as useGlobalSelector,I as useGlobalSetter,B as useGlobalState};
+var x=Object.defineProperty,E=Object.defineProperties;var N=Object.getOwnPropertyDescriptors;var h=Object.getOwnPropertySymbols;var O=Object.prototype.hasOwnProperty,D=Object.prototype.propertyIsEnumerable;var G=(t,e,o)=>e in t?x(t,e,{enumerable:!0,configurable:!0,writable:!0,value:o}):t[e]=o,T=(t,e)=>{for(var o in e||(e={}))O.call(e,o)&&G(t,o,e[o]);if(h)for(var o of h(e))D.call(e,o)&&G(t,o,e[o]);return t},A=(t,e)=>E(t,N(e));import*as m from"react";import{create as v}from"zustand";import{persist as _,createJSONStorage as $,devtools as I}from"zustand/middleware";import{useMemo as w,useRef as j,useCallback as y,useEffect as z}from"react";import{useShallow as U}from"zustand/react/shallow";var a=new Map,i=null;function C(){return i||(i=v()(I(()=>({}),{name:"GlobalStates (All)"}))),i}function p(t,e){if(i){let o=i.getState();i.setState(A(T({},o),{[t]:e}))}}function X(){a.clear(),i=null}function k(t,e,o){let{storage:n="none",storageKey:u="global-state",enableDevtools:r=process.env.NODE_ENV!=="production"}=o||{};if(!a.has(t)){let c=typeof e=="object"&&e!==null&&!Array.isArray(e),V=(S,K)=>({value:e,setValue:l=>{typeof l=="function"?S(d=>{let f=l(d.value);return r&&p(t,f),{value:f}}):c&&typeof l=="object"&&l!==null?S(d=>{let f=T(T({},d.value),l);return r&&p(t,f),{value:f}}):(S({value:l}),r&&p(t,l))},reset:()=>{S({value:e}),r&&p(t,e)}}),g;if(n!=="none"){let S=n==="localStorage"?localStorage:sessionStorage;g=v()(_(V,{name:`${u}-${t}`,storage:$(()=>S)}))}else g=v(V);a.set(t,g),r&&(C(),p(t,e))}let s=a.get(t),b=s(c=>c.value),B=w(()=>c=>s.getState().setValue(c),[s]),R=w(()=>()=>s.getState().reset(),[s]);return[b,B,R]}function Y(t,e,o){let n=a.get(t);if(!n)throw new Error(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);let u=j(e);z(()=>{u.current=e});let r=y(s=>u.current(s.value),[]);if(o===void 0){let s=r(n.getState());return s!==null&&typeof s=="object"&&!m.isValidElement(s)?n(U(r)):n(r)}return n(o==="shallow"?U(r):r)}function Z(t){let e=a.get(t);if(!e)throw new Error(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return w(()=>o=>e.getState().setValue(o),[e])}function q(t){let e=a.get(t);return e==null?void 0:e.getState().value}function ee(t,e){let o=a.get(t);if(!o){process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return}o.getState().setValue(e)}function te(t,e){let o=a.get(t);if(!o)return process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`),()=>{};let n=o.getState().value;return o.subscribe(u=>{let r=u.value;Object.is(r,n)||(e(r,n),n=r)})}function oe(t){let e=a.get(t);if(!e){process.env.NODE_ENV!=="production"&&console.warn(`Global state with key "${t}" not found. Initialize it with useGlobalState first.`);return}e.getState().reset()}var re=k;export{X as __clearAllStates__,re as default,q as getGlobalState,oe as resetGlobalState,ee as setGlobalState,te as subscribeGlobalState,Y as useGlobalSelector,Z as useGlobalSetter,k as useGlobalState};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zustand-kit",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "⚡️ A minimalist React global state management library based on Zustand with persistence, TypeScript and fine-grained subscriptions",
   "keywords": [
     "zustand",

package/types/index.d.ts

@@ -1,7 +1,3 @@
-/**
- * @file src/index.tsx
- * @author leon.wang
- */
 /**
  * Clear all global states (for testing purposes)
  * @internal
@@ -11,6 +7,10 @@ export declare function __clearAllStates__(): void;
  * Storage type for persistence
  */
 export type StorageType = 'localStorage' | 'sessionStorage' | 'none';
+/**
+ * Helper type for setter value - supports partial updates for objects
+ */
+type SetterValue<T> = T extends Record<string, unknown> ? Partial<T> | ((prev: T) => T) : T | ((prev: T) => T);
 /**
  * Options for useGlobalState
  */
@@ -25,14 +25,19 @@ export interface UseGlobalStateOptions {
      * @default 'global-state'
      */
     storageKey?: string;
+    /**
+     * Enable Redux DevTools integration (aggregated view only)
+     * @default true in development, false in production
+     */
+    enableDevtools?: boolean;
 }
 /**
  * Universal global state hook - supports both simple values and objects
- * Performance optimized with selector pattern
+ * Performance optimized with selector pattern and automatic Redux DevTools integration
  *
  * @param key - Unique key for the state
  * @param initialState - Initial state (any type)
- * @param options - Configuration options including persistence
+ * @param options - Configuration options including persistence and devtools
  * @returns [state, setState, resetState]
  *
  * @example
@@ -45,42 +50,72 @@ export interface UseGlobalStateOptions {
  * const [user, setUser, resetUser] = useGlobalState('user', {
  *   name: 'John',
  *   email: 'john@example.com',
+ *   age: 30
  * });
- * setUser({ name: 'Jane' }); // Partial update
+ * setUser({ name: 'Jane' }); // Partial update - only updates name field
+ * setUser(prev => ({ ...prev, age: prev.age + 1 })); // Functional update
  *
- * // With localStorage persistence
+ * // With localStorage persistence (DevTools enabled by default in development)
  * const [settings, setSettings] = useGlobalState('settings', { theme: 'dark' }, {
  *   storage: 'localStorage'
  * });
  *
- * // With sessionStorage persistence
+ * // With sessionStorage persistence and custom storage key
  * const [tempData, setTempData] = useGlobalState('temp', { foo: 'bar' }, {
  *   storage: 'sessionStorage',
  *   storageKey: 'my-app'
  * });
  *
+ * // Disable aggregated DevTools in development
+ * const [privateData, setPrivateData] = useGlobalState('private', {}, {
+ *   enableDevtools: false
+ * });
+ *
+ * // Force enable aggregated DevTools in production (not recommended)
+ * const [debugData, setDebugData] = useGlobalState('debug', {}, {
+ *   enableDevtools: true
+ * });
+ *
  * // For non-React usage, see: getGlobalState, setGlobalState, subscribeGlobalState, resetGlobalState
  */
-export declare function useGlobalState<T>(key: string, initialState: T, options?: UseGlobalStateOptions): [
-    T,
-    (value: T extends Record<string, unknown> ? Partial<T> | ((prev: T) => T) : T | ((prev: T) => T)) => void,
-    () => void
-];
+export declare function useGlobalState<T>(key: string, initialState: T, options?: UseGlobalStateOptions): [T, (value: SetterValue<T>) => void, () => void];
 /**
  * Advanced hook with custom selector for fine-grained subscriptions
  * Only re-renders when selected value changes
+ * Automatically detects return type and uses appropriate comparison mode
+ *
+ * @param key - Global state key
+ * @param selector - Function to select part of the state
+ * @param equalityMode - Optional comparison mode:
+ *   - undefined (default): Auto-detect based on return type (shallow for objects/arrays, Object.is for primitives)
+ *   - 'shallow': Force shallow comparison
+ *   - false: Force Object.is comparison
  *
  * @example
- * // Only subscribe to user name, not the whole user object
+ * // Auto mode: uses Object.is for primitive
  * const userName = useGlobalSelector('user', (state) => state.name);
  *
- * // Multiple values
- * const { name, email } = useGlobalSelector(
+ * // Auto mode: uses shallow for object
+ * const userInfo = useGlobalSelector(
  *   'user',
  *   (state) => ({ name: state.name, email: state.email })
  * );
+ *
+ * // Force shallow comparison
+ * const userInfo = useGlobalSelector(
+ *   'user',
+ *   (state) => ({ name: state.name, email: state.email }),
+ *   'shallow'
+ * );
+ *
+ * // Force Object.is comparison (even for objects)
+ * const userInfo = useGlobalSelector(
+ *   'user',
+ *   (state) => ({ name: state.name, email: state.email }),
+ *   false
+ * );
  */
-export declare function useGlobalSelector<T, R>(key: string, selector: (state: T) => R): R;
+export declare function useGlobalSelector<T, R>(key: string, selector: (state: T) => R, equalityMode?: 'shallow' | false): R;
 /**
  * Hook to get setter function only (doesn't subscribe to state changes)
  * Useful when you only need to update state without reading it
@@ -90,7 +125,7 @@ export declare function useGlobalSelector<T, R>(key: string, selector: (state: T
  * setCount(5);
  * setCount(prev => prev + 1);
  */
-export declare function useGlobalSetter<T>(key: string): (value: T extends Record<string, unknown> ? Partial<T> | ((prev: T) => T) : T | ((prev: T) => T)) => void;
+export declare function useGlobalSetter<T>(key: string): (value: SetterValue<T>) => void;
 /**
  * Get global state value (for non-React usage)
  * @example
@@ -104,7 +139,7 @@ export declare function getGlobalState<T>(key: string): T | undefined;
  * setGlobalState('counter', prev => prev + 1);
  * setGlobalState('user', { name: 'Jane' }); // Partial update for objects
  */
-export declare function setGlobalState<T>(key: string, value: T extends Record<string, unknown> ? Partial<T> | ((prev: T) => T) : T | ((prev: T) => T)): void;
+export declare function setGlobalState<T>(key: string, value: SetterValue<T>): void;
 /**
  * Subscribe to global state changes (for non-React usage)
  * Returns unsubscribe function