zustand-kit 1.0.2 → 1.0.3

package/README.md

@@ -108,26 +108,22 @@ function Settings() {
 
 ### Redux DevTools 集成
 
-在开发环境下，所有全局状态会自动集成到统一的 Redux DevTools 视图中，便于调试：
+在开发环境下，所有全局状态会自动集成到统一的 Redux DevTools 视图中，便于调试。DevTools 采用全局配置，默认根据环境变量自动启用/禁用：
 
 ```tsx
-import { useGlobalState } from 'zustand-kit';
+import { useGlobalState, configureDevtools } from 'zustand-kit';
 
-// 开发环境自动启用 DevTools（默认行为）
+// 默认行为：开发环境自动启用，生产环境自动禁用
 const [data, setData] = useGlobalState('data', { count: 0 });
 
-// 禁用 DevTools（即使在开发环境）
-const [privateData, setPrivateData] = useGlobalState('private', {}, {
-  enableDevtools: false
-});
+// 全局禁用 DevTools（在应用入口配置）
+configureDevtools(false);
 
-// 强制启用 DevTools（生产环境，不推荐）
-const [debugData, setDebugData] = useGlobalState('debug', {}, {
-  enableDevtools: true
-});
+// 全局启用 DevTools（在应用入口配置，如在生产环境调试，不推荐）
+configureDevtools(true);
 ```
 
-**注意：** 所有全局状态会聚合到一个名为 `GlobalStates (All)` 的 DevTools 实例中，每个状态以其 key 作为属性显示，方便统一查看和调试所有状态。
+**注意：** 所有全局状态会聚合到一个名为 `GlobalStates (All)` 的 DevTools 实例中，每个状态以其 key 作为属性显示，方便统一查看和调试所有状态。建议在应用入口处调用 `configureDevtools()` 进行全局配置。
 
 ### 选择器模式（性能优化）
 
@@ -242,12 +238,27 @@ resetGlobalState('counter');
 - `options?: UseGlobalStateOptions` - 可选配置
   - `storage?: 'localStorage' | 'sessionStorage' | 'none'` - 持久化类型（默认 'none'）
   - `storageKey?: string` - 存储键前缀（默认 'global-state'）
-  - `enableDevtools?: boolean` - 是否启用 Redux DevTools（开发环境默认 true，生产环境默认 false）
 
 **返回：** `[state, setState, resetState]`
 
 **注意：** 对于对象类型的状态，`setState` 支持部分更新。例如：`setUser({ name: 'Jane' })` 只会更新 `name` 字段，其他字段保持不变。
 
+### `configureDevtools(enabled)`
+
+全局配置 Redux DevTools 集成。
+
+**参数：**
+- `enabled: boolean` - 是否启用 Redux DevTools（默认：开发环境 true，生产环境 false）
+
+**使用示例：**
+```typescript
+import { configureDevtools } from 'zustand-kit';
+
+// 在应用入口处配置
+configureDevtools(false); // 禁用 DevTools
+configureDevtools(true);  // 启用 DevTools
+```
+
 ### `useGlobalSelector<T, R>(key, selector, equalityMode?)`
 
 使用选择器订阅状态的特定部分。支持自动检测返回值类型并选择合适的比较模式。

package/dist/index.cjs.js

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

package/dist/index.esm.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zustand-kit",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "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,3 +1,14 @@
+/**
+ * Configure global DevTools integration
+ * @param enabled - Whether to enable Redux DevTools integration for all global states
+ * @example
+ * // Disable DevTools in development
+ * configureDevtools(false);
+ *
+ * // Enable DevTools in production (not recommended)
+ * configureDevtools(true);
+ */
+export declare function configureDevtools(enabled: boolean): void;
 /**
  * Clear all global states (for testing purposes)
  * @internal
@@ -25,11 +36,6 @@ 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
@@ -66,15 +72,9 @@ export interface UseGlobalStateOptions {
  *   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
- * });
+ * // Configure DevTools globally (before creating states)
+ * import { configureDevtools } from 'zustand-kit';
+ * configureDevtools(false); // Disable DevTools
  *
  * // For non-React usage, see: getGlobalState, setGlobalState, subscribeGlobalState, resetGlobalState
  */