react-hooks-global-states 16.0.4-beta → 16.0.5-beta.0

package/GlobalStore.cjs

@@ -1 +1 @@
-"use strict";var z=Object.create;var m=Object.defineProperty,D=Object.defineProperties,K=Object.getOwnPropertyDescriptor,N=Object.getOwnPropertyDescriptors,$=Object.getOwnPropertyNames,E=Object.getOwnPropertySymbols,J=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty,Q=Object.prototype.propertyIsEnumerable;var H=(n,t,e)=>t in n?m(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e,g=(n,t)=>{for(var e in t||(t={}))_.call(t,e)&&H(n,e,t[e]);if(E)for(var e of E(t))Q.call(t,e)&&H(n,e,t[e]);return n},O=(n,t)=>D(n,N(t));var X=(n,t)=>{for(var e in t)m(n,e,{get:t[e],enumerable:!0})},U=(n,t,e,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of $(t))!_.call(n,s)&&s!==e&&m(n,s,{get:()=>t[s],enumerable:!(a=K(t,s))||a.enumerable});return n};var M=(n,t,e)=>(e=n!=null?z(J(n)):{},U(t||!n||!n.__esModule?m(e,"default",{value:n,enumerable:!0}):e,n)),Y=n=>U(m({},"__esModule",{value:!0}),n);var tt={};X(tt,{GlobalStore:()=>C,createObservable:()=>y,createSelectorHook:()=>R,default:()=>Z});module.exports=Y(tt);var k=require("react"),f=M(require("json-storage-formatter/isFunction")),q=M(require("./isRecord.cjs")),A=M(require("./shallowCompare.cjs")),j=M(require("./throwWrongKeyOnActionCollectionConfig.cjs")),v=M(require("./uniqueId.cjs")),T=M(require("./GlobalStore.debugProps.cjs"));var C=class n{constructor(t,e={metadata:{}}){this.cleanupFunctions=[];this.actionsConfig=null;this.callbacks=null;this.actions=null;this.subscribers=new Set;this.createSelectorHook=R;this.createObservable=y;var r,l,u;this.dispose=this.dispose.bind(this),this.getMetadata=this.getMetadata.bind(this),this.getState=this.getState.bind(this),this.reset=this.reset.bind(this),this.setMetadata=this.setMetadata.bind(this),this.setState=this.setState.bind(this),this.subscribe=this.subscribe.bind(this);let{metadata:a,callbacks:s,actions:i,name:c}=e;if((0,f.default)(t)&&(this.stateCallback=t),(0,f.default)(a)&&(this.metadataCallback=a),this._name=c!=null?c:(0,v.default)("gs:"),this.state=this.stateCallback?this.stateCallback():t,this.metadata=this.metadataCallback?this.metadataCallback():a!=null?a:{},this.callbacks=s!=null?s:null,this.actionsConfig=i!=null?i:null,T.default.isDevToolsPresent){let b=(r=new Error().stack)!=null?r:"";(u=(l=T.default).REACT_GLOBAL_STATE_HOOK_DEBUG)==null||u.call(l,this,e,b)}this.constructor===n&&this.initialize()}async initialize(){var r,l,u,b,d,S,h,p;let t=(l=(r=this.__devtools_initialize_getStoreActionsMapWrapped)==null?void 0:r.call(this))!=null?l:this.getStoreActionsMap(),{actions:e,storeTools:a}=t;this.actions=e,this.storeTools=a,this.use=this.getMainHook();let s=(b=(u=this.onInit)==null?void 0:u.call(this))!=null?b:null;(0,f.default)(s)&&this.cleanupFunctions.push(s);let{onInit:i}=(d=this.callbacks)!=null?d:{};if(!i)return;let c=(h=(S=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:S.call(this,"config/onInit/"))!=null?h:a,o=(p=i==null?void 0:i(c))!=null?p:null;(0,f.default)(o)&&this.cleanupFunctions.push(o)}executeSetStateForSubscriber(t,e){let{selector:a,onStoreChange:s,currentState:i,isEqualRoot:c=(l,u)=>l===u,isEqual:o=(l,u)=>l===u}=t;if(!e.forceUpdate&&c(e.currentState,e.newState))return{didUpdate:!1};let r=a?a(e.newState):e.newState;return!e.forceUpdate&&o(i,r)?{didUpdate:!1}:(this.partialUpdateSubscription(t,{currentState:r}),s({state:r},{identifier:e.identifier}),{didUpdate:!0})}setActualStateWithoutValidations(t,{forceUpdate:e,identifier:a}){let s=this.state;if(!(e||s!==t))return;this.state=t;let c=this.subscribers.values(),o={forceUpdate:e,newState:t,currentState:s,identifier:a};for(let r of c)this.executeSetStateForSubscriber(r,o)}setMetadata(t){let e=(0,f.default)(t)?t(this.metadata):t;this.metadata=e}getMetadata(){return this.metadata}getState(){return this.state}subscribe(...[t,e,a]){var u;let s=(0,f.default)(e),i=s?t:void 0,c=s?e:t,o=(u=s?a:e)!=null?u:void 0,r=i?i(this.state):this.state;o!=null&&o.skipFirst||c(r);let l=g({selector:i,currentState:r,onStoreChange:({state:b})=>c(b)},o);return this.subscribeCallback(l),()=>{this.subscribers.delete(l)}}subscribeCallback(t){var e,a;return(a=(e=this.callbacks)==null?void 0:e.onSubscribed)==null||a.call(e,this.storeTools,t),this.subscribers.add(t),()=>{this.subscribers.delete(t)}}partialUpdateSubscription(t,e){Object.assign(t,e)}getMainHook(){let t=`globalHook:${this._name}`,e=(d,S=[])=>{(0,k.useDebugValue)(t);let h=(0,A.isArray)(S)?{dependencies:S}:S!=null?S:{},p=(0,k.useRef)(null),x=P=>(0,f.default)(d)?d(P):P;p.current=p.current?p.current:g({selector:x,currentState:x(this.state),onStoreChange:()=>{throw new Error("Callback not set")}},h);let V=p.current.dependencies,w=h==null?void 0:h.dependencies,W=O(g({},h),{selector:x,dependencies:w});this.partialUpdateSubscription(p.current,W);let{subscribe:B,getSnapshot:I,getServerSnapshot:L}=(0,k.useMemo)(()=>{let P=G=>(p.current.onStoreChange=G,this.subscribeCallback(p.current)),F=()=>p.current.currentState;return{subscribe:P,getSnapshot:F,getServerSnapshot:F}},[]);return this.reselectIfDependenciesChanged({subscription:p.current,newDependencies:w,currentDependencies:V}),[(0,k.useSyncExternalStore)(B,I,L),this.getStateOrchestrator(),this.metadata]},a=this,{getMetadata:s,dispose:i,getState:c,reset:o,setMetadata:r,setState:l,subscribe:u}=this,b={actions:this.actions,createObservable:this.createObservable.bind(a),createSelectorHook:this.createSelectorHook.bind(a),dispose:i,metadata:void 0,getMetadata:s,getState:c,reset:o,setMetadata:r,setState:l,subscribe:u,subscribers:this.subscribers,use:e,select:(...d)=>e(...d)[0]};return Object.assign(e,b),Object.defineProperty(e,"metadata",{configurable:!0,enumerable:!0,get:s}),e}reselectIfDependenciesChanged({subscription:t,newDependencies:e,currentDependencies:a}){!t.selector||a===e||(a==null?void 0:a.length)===(e==null?void 0:e.length)&&(0,A.default)(a,e)||this.partialUpdateSubscription(t,{currentState:t.selector(this.state)})}getStateOrchestrator(){return this.actions?this.actions:this.setState}setState(t,{forceUpdate:e,identifier:a}={}){var l,u,b,d,S,h;let s=this.state,i=(0,f.default)(t)?t(s):t;if(!e&&this.state===i)return;let c=this.setActualStateWithoutValidations,o={previousState:s,state:i,identifier:a},r=O(g(g({},this.storeTools),o),{setState:c});Object.defineProperty(r,"metadata",{configurable:!0,enumerable:!0,get:r.getMetadata}),!((l=this.callbacks)!=null&&l.computePreventStateChange&&((b=(u=this.callbacks)==null?void 0:u.computePreventStateChange)!=null&&b.call(u,r)))&&(this.setActualStateWithoutValidations(i,{forceUpdate:e,identifier:a}),(d=this.onStateChanged)==null||d.call(this,r),(h=(S=this.callbacks)==null?void 0:S.onStateChanged)==null||h.call(S,r))}getStoreActionsMap(){let{getMetadata:t,setMetadata:e,getState:a,setState:s,subscribe:i}=this,c={setMetadata:e,get metadata(){return t()},getMetadata:t,getState:a,setState:s,subscribe:i,actions:null};if(!(0,q.default)(this.actionsConfig))return{actions:null,storeTools:c};let o=this.actionsConfig,r={};c.actions=r;let l=Object.keys(o);for(let u of l)Object.assign(r,{[u](...b){let S=o[u].apply(r,b);return typeof S!="function"&&(0,j.default)(u),S.call(r,c)}});return{actions:r,storeTools:c}}removeSubscriptions(){this.subscribers.clear()}executeCleanupTasks(){this.cleanupFunctions.forEach(t=>{t==null||t()}),this.cleanupFunctions.length=0}dispose(){this.removeSubscriptions(),this.executeCleanupTasks()}reset(...t){var l,u,b,d,S,h;this.executeCleanupTasks();let e=t.length>0,a=e?t[0]:this.stateCallback?this.stateCallback():this.state,s=e?t[1]:this.metadataCallback?this.metadataCallback():this.metadata;this.setActualStateWithoutValidations(a,{forceUpdate:!0}),this.setMetadata(s);let i=(u=(l=this.onInit)==null?void 0:l.call(this))!=null?u:null;(0,f.default)(i)&&this.cleanupFunctions.push(i);let{onInit:c}=(b=this.callbacks)!=null?b:{};if(!c)return;let o=(S=(d=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:d.call(this,"config/onInit/"))!=null?S:this.storeTools,r=(h=c==null?void 0:c(o))!=null?h:null;(0,f.default)(r)&&this.cleanupFunctions.push(r)}};function y(n,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,s=t==null?void 0:t.isEqual,i=this.getState(),c=(n!=null?n:b=>b)(i),o=new C(c,{name:e!=null?e:(0,v.default)("sh:")}),r=this.subscribe(b=>{if((a!=null?a:Object.is)(i,b))return;i=b;let S=n(b);(s!=null?s:Object.is)(c,S)||(c=S,o.setState(S))},{skipFirst:!0}),l=o.subscribe.bind(o),u={getState:o.getState.bind(o),subscribe:o.subscribe.bind(o),createSelectorHook:R.bind(l),createObservable:y.bind(l),dispose:()=>{r(),o.dispose()},subscribers:o.subscribers};return Object.assign(l,u),l}function R(n,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,s=t==null?void 0:t.isEqual,i=this.getState(),c=(n!=null?n:b=>b)(i),o=new C(c,{name:e!=null?e:(0,v.default)("sh:")}),r=this.subscribe(b=>{if((a!=null?a:Object.is)(i,b))return;i=b;let S=n(b);(s!=null?s:Object.is)(c,S)||(c=S,o.setState(S))},{skipFirst:!0}),l=(...b)=>{let[d]=o.use(...b);return d},u={getState:()=>o.getState(),subscribe:o.subscribe.bind(o),createSelectorHook:R.bind(l),createObservable:y.bind(l),dispose:()=>{r(),o.dispose()},subscribers:o.subscribers};return Object.assign(l,u),l}var Z=C;
+"use strict";var z=Object.create;var m=Object.defineProperty,D=Object.defineProperties,K=Object.getOwnPropertyDescriptor,N=Object.getOwnPropertyDescriptors,$=Object.getOwnPropertyNames,E=Object.getOwnPropertySymbols,J=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty,Q=Object.prototype.propertyIsEnumerable;var H=(o,t,e)=>t in o?m(o,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):o[t]=e,g=(o,t)=>{for(var e in t||(t={}))_.call(t,e)&&H(o,e,t[e]);if(E)for(var e of E(t))Q.call(t,e)&&H(o,e,t[e]);return o},O=(o,t)=>D(o,N(t));var X=(o,t)=>{for(var e in t)m(o,e,{get:t[e],enumerable:!0})},U=(o,t,e,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of $(t))!_.call(o,s)&&s!==e&&m(o,s,{get:()=>t[s],enumerable:!(a=K(t,s))||a.enumerable});return o};var M=(o,t,e)=>(e=o!=null?z(J(o)):{},U(t||!o||!o.__esModule?m(e,"default",{value:o,enumerable:!0}):e,o)),Y=o=>U(m({},"__esModule",{value:!0}),o);var tt={};X(tt,{GlobalStore:()=>C,createObservable:()=>y,createSelectorHook:()=>R,default:()=>Z});module.exports=Y(tt);var k=require("react"),f=M(require("json-storage-formatter/isFunction")),q=M(require("./isRecord.cjs")),A=M(require("./shallowCompare.cjs")),j=M(require("./throwWrongKeyOnActionCollectionConfig.cjs")),v=M(require("./uniqueId.cjs")),T=M(require("./GlobalStore.debugProps.cjs"));var C=class o{constructor(t,e={metadata:{}}){this.cleanupFunctions=[];this.actionsConfig=null;this.callbacks=null;this.actions=null;this.subscribers=new Set;this.createSelectorHook=R;this.createObservable=y;var r,l,u;this.dispose=this.dispose.bind(this),this.getMetadata=this.getMetadata.bind(this),this.getState=this.getState.bind(this),this.reset=this.reset.bind(this),this.setMetadata=this.setMetadata.bind(this),this.setState=this.setState.bind(this),this.subscribe=this.subscribe.bind(this);let{metadata:a,callbacks:s,actions:i,name:c}=e;if((0,f.default)(t)&&(this.stateCallback=t),(0,f.default)(a)&&(this.metadataCallback=a),this._name=c!=null?c:(0,v.default)("gs:"),this.state=this.stateCallback?this.stateCallback():t,this.metadata=this.metadataCallback?this.metadataCallback():a!=null?a:{},this.callbacks=s!=null?s:null,this.actionsConfig=i!=null?i:null,T.default.isDevToolsPresent){let b=(r=new Error().stack)!=null?r:"";(u=(l=T.default).REACT_GLOBAL_STATE_HOOK_DEBUG)==null||u.call(l,this,e,b)}this.constructor===o&&this.initialize()}async initialize(){var r,l,u,b,d,S,h,p;let t=(l=(r=this.__devtools_initialize_getStoreActionsMapWrapped)==null?void 0:r.call(this))!=null?l:this.getStoreActionsMap(),{actions:e,storeTools:a}=t;this.actions=e,this.storeTools=a,this.use=this.getMainHook();let s=(b=(u=this.onInit)==null?void 0:u.call(this))!=null?b:null;(0,f.default)(s)&&this.cleanupFunctions.push(s);let{onInit:i}=(d=this.callbacks)!=null?d:{};if(!i)return;let c=(h=(S=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:S.call(this,"config/onInit/"))!=null?h:a,n=(p=i==null?void 0:i(c))!=null?p:null;(0,f.default)(n)&&this.cleanupFunctions.push(n)}executeSetStateForSubscriber(t,e){let{selector:a,onStoreChange:s,currentState:i,isEqualRoot:c=(l,u)=>l===u,isEqual:n=(l,u)=>l===u}=t;if(!e.forceUpdate&&c(e.currentState,e.newState))return{didUpdate:!1};let r=a?a(e.newState):e.newState;return!e.forceUpdate&&n(i,r)?{didUpdate:!1}:(this.partialUpdateSubscription(t,{currentState:r}),s({state:r},{identifier:e.identifier}),{didUpdate:!0})}setActualStateWithoutValidations(t,{forceUpdate:e,identifier:a}){let s=this.state;if(!(e||s!==t))return;this.state=t;let c=this.subscribers.values(),n={forceUpdate:e,newState:t,currentState:s,identifier:a};for(let r of c)this.executeSetStateForSubscriber(r,n)}setMetadata(t){let e=(0,f.default)(t)?t(this.metadata):t;this.metadata=e}getMetadata(){return this.metadata}getState(){return this.state}subscribe(...[t,e,a]){var u;let s=(0,f.default)(e),i=s?t:void 0,c=s?e:t,n=(u=s?a:e)!=null?u:void 0,r=i?i(this.state):this.state;n!=null&&n.skipFirst||c(r);let l=g({selector:i,currentState:r,onStoreChange:({state:b})=>c(b)},n);return this.subscribeCallback(l),()=>{this.subscribers.delete(l)}}subscribeCallback(t){var e,a;return(a=(e=this.callbacks)==null?void 0:e.onSubscribed)==null||a.call(e,this.storeTools,t),this.subscribers.add(t),()=>{this.subscribers.delete(t)}}partialUpdateSubscription(t,e){Object.assign(t,e)}getMainHook(){let t=`globalHook:${this._name}`,e=(d,S=[])=>{(0,k.useDebugValue)(t);let h=(0,A.isArray)(S)?{dependencies:S}:S!=null?S:{},p=(0,k.useRef)(null),x=P=>(0,f.default)(d)?d(P):P;p.current=p.current?p.current:g({selector:x,currentState:x(this.state),onStoreChange:()=>{throw new Error("Callback not set")}},h);let V=p.current.dependencies,w=h==null?void 0:h.dependencies,W=O(g({},h),{selector:x,dependencies:w});this.partialUpdateSubscription(p.current,W);let[{subscribe:B,getSnapshot:I,getServerSnapshot:L}]=(0,k.useState)(()=>{let P=G=>(p.current.onStoreChange=G,this.subscribeCallback(p.current)),F=()=>p.current.currentState;return{subscribe:P,getSnapshot:F,getServerSnapshot:F}});return this.reselectIfDependenciesChanged({subscription:p.current,newDependencies:w,currentDependencies:V}),[(0,k.useSyncExternalStore)(B,I,L),this.getStateOrchestrator(),this.metadata]},a=this,{getMetadata:s,dispose:i,getState:c,reset:n,setMetadata:r,setState:l,subscribe:u}=this,b={actions:this.actions,createObservable:this.createObservable.bind(a),createSelectorHook:this.createSelectorHook.bind(a),dispose:i,metadata:void 0,getMetadata:s,getState:c,reset:n,setMetadata:r,setState:l,subscribe:u,subscribers:this.subscribers,use:e,select:(...d)=>e(...d)[0]};return Object.assign(e,b),Object.defineProperty(e,"metadata",{configurable:!0,enumerable:!0,get:s}),e}reselectIfDependenciesChanged({subscription:t,newDependencies:e,currentDependencies:a}){!t.selector||a===e||(a==null?void 0:a.length)===(e==null?void 0:e.length)&&(0,A.default)(a,e)||this.partialUpdateSubscription(t,{currentState:t.selector(this.state)})}getStateOrchestrator(){return this.actions?this.actions:this.setState}setState(t,{forceUpdate:e,identifier:a}={}){var l,u,b,d,S,h;let s=this.state,i=(0,f.default)(t)?t(s):t;if(!e&&this.state===i)return;let c=this.setActualStateWithoutValidations,n={previousState:s,state:i,identifier:a},r=O(g(g({},this.storeTools),n),{setState:c});Object.defineProperty(r,"metadata",{configurable:!0,enumerable:!0,get:r.getMetadata}),!((l=this.callbacks)!=null&&l.computePreventStateChange&&((b=(u=this.callbacks)==null?void 0:u.computePreventStateChange)!=null&&b.call(u,r)))&&(this.setActualStateWithoutValidations(i,{forceUpdate:e,identifier:a}),(d=this.onStateChanged)==null||d.call(this,r),(h=(S=this.callbacks)==null?void 0:S.onStateChanged)==null||h.call(S,r))}getStoreActionsMap(){let{getMetadata:t,setMetadata:e,getState:a,setState:s,subscribe:i}=this,c={setMetadata:e,get metadata(){return t()},getMetadata:t,getState:a,setState:s,subscribe:i,actions:null};if(!(0,q.default)(this.actionsConfig))return{actions:null,storeTools:c};let n=this.actionsConfig,r={};c.actions=r;let l=Object.keys(n);for(let u of l)Object.assign(r,{[u](...b){let S=n[u].apply(r,b);return typeof S!="function"&&(0,j.default)(u),S.call(r,c)}});return{actions:r,storeTools:c}}removeSubscriptions(){this.subscribers.clear()}executeCleanupTasks(){this.cleanupFunctions.forEach(t=>{t==null||t()}),this.cleanupFunctions.length=0}dispose(){this.removeSubscriptions(),this.executeCleanupTasks()}reset(...t){var l,u,b,d,S,h;this.executeCleanupTasks();let e=t.length>0,a=e?t[0]:this.stateCallback?this.stateCallback():this.state,s=e?t[1]:this.metadataCallback?this.metadataCallback():this.metadata;this.setActualStateWithoutValidations(a,{forceUpdate:!0}),this.setMetadata(s);let i=(u=(l=this.onInit)==null?void 0:l.call(this))!=null?u:null;(0,f.default)(i)&&this.cleanupFunctions.push(i);let{onInit:c}=(b=this.callbacks)!=null?b:{};if(!c)return;let n=(S=(d=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:d.call(this,"config/onInit/"))!=null?S:this.storeTools,r=(h=c==null?void 0:c(n))!=null?h:null;(0,f.default)(r)&&this.cleanupFunctions.push(r)}};function y(o,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,s=t==null?void 0:t.isEqual,i=this.getState(),c=(o!=null?o:b=>b)(i),n=new C(c,{name:e!=null?e:(0,v.default)("sh:")}),r=this.subscribe(b=>{if((a!=null?a:Object.is)(i,b))return;i=b;let S=o(b);(s!=null?s:Object.is)(c,S)||(c=S,n.setState(S))},{skipFirst:!0}),l=n.subscribe.bind(n),u={getState:n.getState.bind(n),subscribe:n.subscribe.bind(n),createSelectorHook:R.bind(l),createObservable:y.bind(l),dispose:()=>{r(),n.dispose()},subscribers:n.subscribers};return Object.assign(l,u),l}function R(o,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,s=t==null?void 0:t.isEqual,i=this.getState(),c=(o!=null?o:b=>b)(i),n=new C(c,{name:e!=null?e:(0,v.default)("sh:")}),r=this.subscribe(b=>{if((a!=null?a:Object.is)(i,b))return;i=b;let S=o(b);(s!=null?s:Object.is)(c,S)||(c=S,n.setState(S))},{skipFirst:!0}),l=(...b)=>{let[d]=n.use(...b);return d},u={getState:()=>n.getState(),subscribe:n.subscribe.bind(n),createSelectorHook:R.bind(l),createObservable:y.bind(l),dispose:()=>{r(),n.dispose()},subscribers:n.subscribers};return Object.assign(l,u),l}var Z=C;

package/GlobalStore.d.ts

@@ -1,7 +1,5 @@
 import type { ActionCollectionConfig, GlobalStoreCallbacks, ActionCollectionResult, MetadataSetter, SubscribeCallbackConfig, SubscribeCallback, SelectorCallback, SubscriberParameters, StateHook, BaseMetadata, StateChanges, StoreTools, ObservableFragment, UnsubscribeCallback, AnyFunction, ReadonlyHook, ReadonlyStateApi, CleanupFunction } from './types';
-/**
- * The GlobalStore class is the main class of the library and it is used to create a GlobalStore instances
- * */
+/** Shared state, subscriptions, actions and lifecycle management. */
 export declare class GlobalStore<State, Metadata extends BaseMetadata, ActionsConfig extends ActionCollectionConfig<State, Metadata> | undefined | unknown, PublicStateMutator = keyof ActionsConfig extends never | undefined ? React.Dispatch<React.SetStateAction<State>> : ActionCollectionResult<State, Metadata, NonNullable<ActionsConfig>>> {
     protected cleanupFunctions: CleanupFunction[];
     protected _name: string;
@@ -18,9 +16,7 @@ export declare class GlobalStore<State, Metadata extends BaseMetadata, ActionsCo
      */
     use: StateHook<State, PublicStateMutator, Metadata>;
     /**
-     * @deprecated
-     * @description Set of subscribers that are listening to state changes
-     * Useful for debugging purposes... You'll probably not need to use this in your application
+     * @deprecated Internal subscription registry. Use `subscribe` to observe state changes.
      */
     subscribers: Set<SubscriberParameters>;
     state: State;
@@ -70,7 +66,7 @@ export declare class GlobalStore<State, Metadata extends BaseMetadata, ActionsCo
         identifier?: string;
     }): void;
     /**
-     * Set the value of the metadata property, this is no reactive and will not trigger a re-render
+     * Set the value of the metadata property, this is non-reactive and will not trigger a re-render
      * @param {MetadataSetter<Metadata>} setter - The setter function or the value to set
      * */
     setMetadata(setter: Parameters<MetadataSetter<Metadata>>[0]): void;

package/GlobalStore.js

@@ -1 +1 @@
-"use strict";var z=Object.create;var m=Object.defineProperty,D=Object.defineProperties,K=Object.getOwnPropertyDescriptor,N=Object.getOwnPropertyDescriptors,$=Object.getOwnPropertyNames,E=Object.getOwnPropertySymbols,J=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty,Q=Object.prototype.propertyIsEnumerable;var H=(n,t,e)=>t in n?m(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e,g=(n,t)=>{for(var e in t||(t={}))_.call(t,e)&&H(n,e,t[e]);if(E)for(var e of E(t))Q.call(t,e)&&H(n,e,t[e]);return n},O=(n,t)=>D(n,N(t));var X=(n,t)=>{for(var e in t)m(n,e,{get:t[e],enumerable:!0})},U=(n,t,e,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of $(t))!_.call(n,s)&&s!==e&&m(n,s,{get:()=>t[s],enumerable:!(a=K(t,s))||a.enumerable});return n};var M=(n,t,e)=>(e=n!=null?z(J(n)):{},U(t||!n||!n.__esModule?m(e,"default",{value:n,enumerable:!0}):e,n)),Y=n=>U(m({},"__esModule",{value:!0}),n);var tt={};X(tt,{GlobalStore:()=>C,createObservable:()=>y,createSelectorHook:()=>R,default:()=>Z});module.exports=Y(tt);var k=require("react"),f=M(require("json-storage-formatter/isFunction")),q=M(require("./isRecord.js")),A=M(require("./shallowCompare.js")),j=M(require("./throwWrongKeyOnActionCollectionConfig.js")),v=M(require("./uniqueId.js")),T=M(require("./GlobalStore.debugProps.js"));var C=class n{constructor(t,e={metadata:{}}){this.cleanupFunctions=[];this.actionsConfig=null;this.callbacks=null;this.actions=null;this.subscribers=new Set;this.createSelectorHook=R;this.createObservable=y;var r,l,u;this.dispose=this.dispose.bind(this),this.getMetadata=this.getMetadata.bind(this),this.getState=this.getState.bind(this),this.reset=this.reset.bind(this),this.setMetadata=this.setMetadata.bind(this),this.setState=this.setState.bind(this),this.subscribe=this.subscribe.bind(this);let{metadata:a,callbacks:s,actions:i,name:c}=e;if((0,f.default)(t)&&(this.stateCallback=t),(0,f.default)(a)&&(this.metadataCallback=a),this._name=c!=null?c:(0,v.default)("gs:"),this.state=this.stateCallback?this.stateCallback():t,this.metadata=this.metadataCallback?this.metadataCallback():a!=null?a:{},this.callbacks=s!=null?s:null,this.actionsConfig=i!=null?i:null,T.default.isDevToolsPresent){let b=(r=new Error().stack)!=null?r:"";(u=(l=T.default).REACT_GLOBAL_STATE_HOOK_DEBUG)==null||u.call(l,this,e,b)}this.constructor===n&&this.initialize()}async initialize(){var r,l,u,b,d,S,h,p;let t=(l=(r=this.__devtools_initialize_getStoreActionsMapWrapped)==null?void 0:r.call(this))!=null?l:this.getStoreActionsMap(),{actions:e,storeTools:a}=t;this.actions=e,this.storeTools=a,this.use=this.getMainHook();let s=(b=(u=this.onInit)==null?void 0:u.call(this))!=null?b:null;(0,f.default)(s)&&this.cleanupFunctions.push(s);let{onInit:i}=(d=this.callbacks)!=null?d:{};if(!i)return;let c=(h=(S=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:S.call(this,"config/onInit/"))!=null?h:a,o=(p=i==null?void 0:i(c))!=null?p:null;(0,f.default)(o)&&this.cleanupFunctions.push(o)}executeSetStateForSubscriber(t,e){let{selector:a,onStoreChange:s,currentState:i,isEqualRoot:c=(l,u)=>l===u,isEqual:o=(l,u)=>l===u}=t;if(!e.forceUpdate&&c(e.currentState,e.newState))return{didUpdate:!1};let r=a?a(e.newState):e.newState;return!e.forceUpdate&&o(i,r)?{didUpdate:!1}:(this.partialUpdateSubscription(t,{currentState:r}),s({state:r},{identifier:e.identifier}),{didUpdate:!0})}setActualStateWithoutValidations(t,{forceUpdate:e,identifier:a}){let s=this.state;if(!(e||s!==t))return;this.state=t;let c=this.subscribers.values(),o={forceUpdate:e,newState:t,currentState:s,identifier:a};for(let r of c)this.executeSetStateForSubscriber(r,o)}setMetadata(t){let e=(0,f.default)(t)?t(this.metadata):t;this.metadata=e}getMetadata(){return this.metadata}getState(){return this.state}subscribe(...[t,e,a]){var u;let s=(0,f.default)(e),i=s?t:void 0,c=s?e:t,o=(u=s?a:e)!=null?u:void 0,r=i?i(this.state):this.state;o!=null&&o.skipFirst||c(r);let l=g({selector:i,currentState:r,onStoreChange:({state:b})=>c(b)},o);return this.subscribeCallback(l),()=>{this.subscribers.delete(l)}}subscribeCallback(t){var e,a;return(a=(e=this.callbacks)==null?void 0:e.onSubscribed)==null||a.call(e,this.storeTools,t),this.subscribers.add(t),()=>{this.subscribers.delete(t)}}partialUpdateSubscription(t,e){Object.assign(t,e)}getMainHook(){let t=`globalHook:${this._name}`,e=(d,S=[])=>{(0,k.useDebugValue)(t);let h=(0,A.isArray)(S)?{dependencies:S}:S!=null?S:{},p=(0,k.useRef)(null),x=P=>(0,f.default)(d)?d(P):P;p.current=p.current?p.current:g({selector:x,currentState:x(this.state),onStoreChange:()=>{throw new Error("Callback not set")}},h);let V=p.current.dependencies,w=h==null?void 0:h.dependencies,W=O(g({},h),{selector:x,dependencies:w});this.partialUpdateSubscription(p.current,W);let{subscribe:B,getSnapshot:I,getServerSnapshot:L}=(0,k.useMemo)(()=>{let P=G=>(p.current.onStoreChange=G,this.subscribeCallback(p.current)),F=()=>p.current.currentState;return{subscribe:P,getSnapshot:F,getServerSnapshot:F}},[]);return this.reselectIfDependenciesChanged({subscription:p.current,newDependencies:w,currentDependencies:V}),[(0,k.useSyncExternalStore)(B,I,L),this.getStateOrchestrator(),this.metadata]},a=this,{getMetadata:s,dispose:i,getState:c,reset:o,setMetadata:r,setState:l,subscribe:u}=this,b={actions:this.actions,createObservable:this.createObservable.bind(a),createSelectorHook:this.createSelectorHook.bind(a),dispose:i,metadata:void 0,getMetadata:s,getState:c,reset:o,setMetadata:r,setState:l,subscribe:u,subscribers:this.subscribers,use:e,select:(...d)=>e(...d)[0]};return Object.assign(e,b),Object.defineProperty(e,"metadata",{configurable:!0,enumerable:!0,get:s}),e}reselectIfDependenciesChanged({subscription:t,newDependencies:e,currentDependencies:a}){!t.selector||a===e||(a==null?void 0:a.length)===(e==null?void 0:e.length)&&(0,A.default)(a,e)||this.partialUpdateSubscription(t,{currentState:t.selector(this.state)})}getStateOrchestrator(){return this.actions?this.actions:this.setState}setState(t,{forceUpdate:e,identifier:a}={}){var l,u,b,d,S,h;let s=this.state,i=(0,f.default)(t)?t(s):t;if(!e&&this.state===i)return;let c=this.setActualStateWithoutValidations,o={previousState:s,state:i,identifier:a},r=O(g(g({},this.storeTools),o),{setState:c});Object.defineProperty(r,"metadata",{configurable:!0,enumerable:!0,get:r.getMetadata}),!((l=this.callbacks)!=null&&l.computePreventStateChange&&((b=(u=this.callbacks)==null?void 0:u.computePreventStateChange)!=null&&b.call(u,r)))&&(this.setActualStateWithoutValidations(i,{forceUpdate:e,identifier:a}),(d=this.onStateChanged)==null||d.call(this,r),(h=(S=this.callbacks)==null?void 0:S.onStateChanged)==null||h.call(S,r))}getStoreActionsMap(){let{getMetadata:t,setMetadata:e,getState:a,setState:s,subscribe:i}=this,c={setMetadata:e,get metadata(){return t()},getMetadata:t,getState:a,setState:s,subscribe:i,actions:null};if(!(0,q.default)(this.actionsConfig))return{actions:null,storeTools:c};let o=this.actionsConfig,r={};c.actions=r;let l=Object.keys(o);for(let u of l)Object.assign(r,{[u](...b){let S=o[u].apply(r,b);return typeof S!="function"&&(0,j.default)(u),S.call(r,c)}});return{actions:r,storeTools:c}}removeSubscriptions(){this.subscribers.clear()}executeCleanupTasks(){this.cleanupFunctions.forEach(t=>{t==null||t()}),this.cleanupFunctions.length=0}dispose(){this.removeSubscriptions(),this.executeCleanupTasks()}reset(...t){var l,u,b,d,S,h;this.executeCleanupTasks();let e=t.length>0,a=e?t[0]:this.stateCallback?this.stateCallback():this.state,s=e?t[1]:this.metadataCallback?this.metadataCallback():this.metadata;this.setActualStateWithoutValidations(a,{forceUpdate:!0}),this.setMetadata(s);let i=(u=(l=this.onInit)==null?void 0:l.call(this))!=null?u:null;(0,f.default)(i)&&this.cleanupFunctions.push(i);let{onInit:c}=(b=this.callbacks)!=null?b:{};if(!c)return;let o=(S=(d=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:d.call(this,"config/onInit/"))!=null?S:this.storeTools,r=(h=c==null?void 0:c(o))!=null?h:null;(0,f.default)(r)&&this.cleanupFunctions.push(r)}};function y(n,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,s=t==null?void 0:t.isEqual,i=this.getState(),c=(n!=null?n:b=>b)(i),o=new C(c,{name:e!=null?e:(0,v.default)("sh:")}),r=this.subscribe(b=>{if((a!=null?a:Object.is)(i,b))return;i=b;let S=n(b);(s!=null?s:Object.is)(c,S)||(c=S,o.setState(S))},{skipFirst:!0}),l=o.subscribe.bind(o),u={getState:o.getState.bind(o),subscribe:o.subscribe.bind(o),createSelectorHook:R.bind(l),createObservable:y.bind(l),dispose:()=>{r(),o.dispose()},subscribers:o.subscribers};return Object.assign(l,u),l}function R(n,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,s=t==null?void 0:t.isEqual,i=this.getState(),c=(n!=null?n:b=>b)(i),o=new C(c,{name:e!=null?e:(0,v.default)("sh:")}),r=this.subscribe(b=>{if((a!=null?a:Object.is)(i,b))return;i=b;let S=n(b);(s!=null?s:Object.is)(c,S)||(c=S,o.setState(S))},{skipFirst:!0}),l=(...b)=>{let[d]=o.use(...b);return d},u={getState:()=>o.getState(),subscribe:o.subscribe.bind(o),createSelectorHook:R.bind(l),createObservable:y.bind(l),dispose:()=>{r(),o.dispose()},subscribers:o.subscribers};return Object.assign(l,u),l}var Z=C;
+"use strict";var z=Object.create;var m=Object.defineProperty,D=Object.defineProperties,K=Object.getOwnPropertyDescriptor,N=Object.getOwnPropertyDescriptors,$=Object.getOwnPropertyNames,E=Object.getOwnPropertySymbols,J=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty,Q=Object.prototype.propertyIsEnumerable;var H=(o,t,e)=>t in o?m(o,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):o[t]=e,g=(o,t)=>{for(var e in t||(t={}))_.call(t,e)&&H(o,e,t[e]);if(E)for(var e of E(t))Q.call(t,e)&&H(o,e,t[e]);return o},O=(o,t)=>D(o,N(t));var X=(o,t)=>{for(var e in t)m(o,e,{get:t[e],enumerable:!0})},U=(o,t,e,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of $(t))!_.call(o,s)&&s!==e&&m(o,s,{get:()=>t[s],enumerable:!(a=K(t,s))||a.enumerable});return o};var M=(o,t,e)=>(e=o!=null?z(J(o)):{},U(t||!o||!o.__esModule?m(e,"default",{value:o,enumerable:!0}):e,o)),Y=o=>U(m({},"__esModule",{value:!0}),o);var tt={};X(tt,{GlobalStore:()=>C,createObservable:()=>y,createSelectorHook:()=>R,default:()=>Z});module.exports=Y(tt);var k=require("react"),f=M(require("json-storage-formatter/isFunction")),q=M(require("./isRecord.js")),A=M(require("./shallowCompare.js")),j=M(require("./throwWrongKeyOnActionCollectionConfig.js")),v=M(require("./uniqueId.js")),T=M(require("./GlobalStore.debugProps.js"));var C=class o{constructor(t,e={metadata:{}}){this.cleanupFunctions=[];this.actionsConfig=null;this.callbacks=null;this.actions=null;this.subscribers=new Set;this.createSelectorHook=R;this.createObservable=y;var r,l,u;this.dispose=this.dispose.bind(this),this.getMetadata=this.getMetadata.bind(this),this.getState=this.getState.bind(this),this.reset=this.reset.bind(this),this.setMetadata=this.setMetadata.bind(this),this.setState=this.setState.bind(this),this.subscribe=this.subscribe.bind(this);let{metadata:a,callbacks:s,actions:i,name:c}=e;if((0,f.default)(t)&&(this.stateCallback=t),(0,f.default)(a)&&(this.metadataCallback=a),this._name=c!=null?c:(0,v.default)("gs:"),this.state=this.stateCallback?this.stateCallback():t,this.metadata=this.metadataCallback?this.metadataCallback():a!=null?a:{},this.callbacks=s!=null?s:null,this.actionsConfig=i!=null?i:null,T.default.isDevToolsPresent){let b=(r=new Error().stack)!=null?r:"";(u=(l=T.default).REACT_GLOBAL_STATE_HOOK_DEBUG)==null||u.call(l,this,e,b)}this.constructor===o&&this.initialize()}async initialize(){var r,l,u,b,d,S,h,p;let t=(l=(r=this.__devtools_initialize_getStoreActionsMapWrapped)==null?void 0:r.call(this))!=null?l:this.getStoreActionsMap(),{actions:e,storeTools:a}=t;this.actions=e,this.storeTools=a,this.use=this.getMainHook();let s=(b=(u=this.onInit)==null?void 0:u.call(this))!=null?b:null;(0,f.default)(s)&&this.cleanupFunctions.push(s);let{onInit:i}=(d=this.callbacks)!=null?d:{};if(!i)return;let c=(h=(S=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:S.call(this,"config/onInit/"))!=null?h:a,n=(p=i==null?void 0:i(c))!=null?p:null;(0,f.default)(n)&&this.cleanupFunctions.push(n)}executeSetStateForSubscriber(t,e){let{selector:a,onStoreChange:s,currentState:i,isEqualRoot:c=(l,u)=>l===u,isEqual:n=(l,u)=>l===u}=t;if(!e.forceUpdate&&c(e.currentState,e.newState))return{didUpdate:!1};let r=a?a(e.newState):e.newState;return!e.forceUpdate&&n(i,r)?{didUpdate:!1}:(this.partialUpdateSubscription(t,{currentState:r}),s({state:r},{identifier:e.identifier}),{didUpdate:!0})}setActualStateWithoutValidations(t,{forceUpdate:e,identifier:a}){let s=this.state;if(!(e||s!==t))return;this.state=t;let c=this.subscribers.values(),n={forceUpdate:e,newState:t,currentState:s,identifier:a};for(let r of c)this.executeSetStateForSubscriber(r,n)}setMetadata(t){let e=(0,f.default)(t)?t(this.metadata):t;this.metadata=e}getMetadata(){return this.metadata}getState(){return this.state}subscribe(...[t,e,a]){var u;let s=(0,f.default)(e),i=s?t:void 0,c=s?e:t,n=(u=s?a:e)!=null?u:void 0,r=i?i(this.state):this.state;n!=null&&n.skipFirst||c(r);let l=g({selector:i,currentState:r,onStoreChange:({state:b})=>c(b)},n);return this.subscribeCallback(l),()=>{this.subscribers.delete(l)}}subscribeCallback(t){var e,a;return(a=(e=this.callbacks)==null?void 0:e.onSubscribed)==null||a.call(e,this.storeTools,t),this.subscribers.add(t),()=>{this.subscribers.delete(t)}}partialUpdateSubscription(t,e){Object.assign(t,e)}getMainHook(){let t=`globalHook:${this._name}`,e=(d,S=[])=>{(0,k.useDebugValue)(t);let h=(0,A.isArray)(S)?{dependencies:S}:S!=null?S:{},p=(0,k.useRef)(null),x=P=>(0,f.default)(d)?d(P):P;p.current=p.current?p.current:g({selector:x,currentState:x(this.state),onStoreChange:()=>{throw new Error("Callback not set")}},h);let V=p.current.dependencies,w=h==null?void 0:h.dependencies,W=O(g({},h),{selector:x,dependencies:w});this.partialUpdateSubscription(p.current,W);let[{subscribe:B,getSnapshot:I,getServerSnapshot:L}]=(0,k.useState)(()=>{let P=G=>(p.current.onStoreChange=G,this.subscribeCallback(p.current)),F=()=>p.current.currentState;return{subscribe:P,getSnapshot:F,getServerSnapshot:F}});return this.reselectIfDependenciesChanged({subscription:p.current,newDependencies:w,currentDependencies:V}),[(0,k.useSyncExternalStore)(B,I,L),this.getStateOrchestrator(),this.metadata]},a=this,{getMetadata:s,dispose:i,getState:c,reset:n,setMetadata:r,setState:l,subscribe:u}=this,b={actions:this.actions,createObservable:this.createObservable.bind(a),createSelectorHook:this.createSelectorHook.bind(a),dispose:i,metadata:void 0,getMetadata:s,getState:c,reset:n,setMetadata:r,setState:l,subscribe:u,subscribers:this.subscribers,use:e,select:(...d)=>e(...d)[0]};return Object.assign(e,b),Object.defineProperty(e,"metadata",{configurable:!0,enumerable:!0,get:s}),e}reselectIfDependenciesChanged({subscription:t,newDependencies:e,currentDependencies:a}){!t.selector||a===e||(a==null?void 0:a.length)===(e==null?void 0:e.length)&&(0,A.default)(a,e)||this.partialUpdateSubscription(t,{currentState:t.selector(this.state)})}getStateOrchestrator(){return this.actions?this.actions:this.setState}setState(t,{forceUpdate:e,identifier:a}={}){var l,u,b,d,S,h;let s=this.state,i=(0,f.default)(t)?t(s):t;if(!e&&this.state===i)return;let c=this.setActualStateWithoutValidations,n={previousState:s,state:i,identifier:a},r=O(g(g({},this.storeTools),n),{setState:c});Object.defineProperty(r,"metadata",{configurable:!0,enumerable:!0,get:r.getMetadata}),!((l=this.callbacks)!=null&&l.computePreventStateChange&&((b=(u=this.callbacks)==null?void 0:u.computePreventStateChange)!=null&&b.call(u,r)))&&(this.setActualStateWithoutValidations(i,{forceUpdate:e,identifier:a}),(d=this.onStateChanged)==null||d.call(this,r),(h=(S=this.callbacks)==null?void 0:S.onStateChanged)==null||h.call(S,r))}getStoreActionsMap(){let{getMetadata:t,setMetadata:e,getState:a,setState:s,subscribe:i}=this,c={setMetadata:e,get metadata(){return t()},getMetadata:t,getState:a,setState:s,subscribe:i,actions:null};if(!(0,q.default)(this.actionsConfig))return{actions:null,storeTools:c};let n=this.actionsConfig,r={};c.actions=r;let l=Object.keys(n);for(let u of l)Object.assign(r,{[u](...b){let S=n[u].apply(r,b);return typeof S!="function"&&(0,j.default)(u),S.call(r,c)}});return{actions:r,storeTools:c}}removeSubscriptions(){this.subscribers.clear()}executeCleanupTasks(){this.cleanupFunctions.forEach(t=>{t==null||t()}),this.cleanupFunctions.length=0}dispose(){this.removeSubscriptions(),this.executeCleanupTasks()}reset(...t){var l,u,b,d,S,h;this.executeCleanupTasks();let e=t.length>0,a=e?t[0]:this.stateCallback?this.stateCallback():this.state,s=e?t[1]:this.metadataCallback?this.metadataCallback():this.metadata;this.setActualStateWithoutValidations(a,{forceUpdate:!0}),this.setMetadata(s);let i=(u=(l=this.onInit)==null?void 0:l.call(this))!=null?u:null;(0,f.default)(i)&&this.cleanupFunctions.push(i);let{onInit:c}=(b=this.callbacks)!=null?b:{};if(!c)return;let n=(S=(d=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:d.call(this,"config/onInit/"))!=null?S:this.storeTools,r=(h=c==null?void 0:c(n))!=null?h:null;(0,f.default)(r)&&this.cleanupFunctions.push(r)}};function y(o,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,s=t==null?void 0:t.isEqual,i=this.getState(),c=(o!=null?o:b=>b)(i),n=new C(c,{name:e!=null?e:(0,v.default)("sh:")}),r=this.subscribe(b=>{if((a!=null?a:Object.is)(i,b))return;i=b;let S=o(b);(s!=null?s:Object.is)(c,S)||(c=S,n.setState(S))},{skipFirst:!0}),l=n.subscribe.bind(n),u={getState:n.getState.bind(n),subscribe:n.subscribe.bind(n),createSelectorHook:R.bind(l),createObservable:y.bind(l),dispose:()=>{r(),n.dispose()},subscribers:n.subscribers};return Object.assign(l,u),l}function R(o,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,s=t==null?void 0:t.isEqual,i=this.getState(),c=(o!=null?o:b=>b)(i),n=new C(c,{name:e!=null?e:(0,v.default)("sh:")}),r=this.subscribe(b=>{if((a!=null?a:Object.is)(i,b))return;i=b;let S=o(b);(s!=null?s:Object.is)(c,S)||(c=S,n.setState(S))},{skipFirst:!0}),l=(...b)=>{let[d]=n.use(...b);return d},u={getState:()=>n.getState(),subscribe:n.subscribe.bind(n),createSelectorHook:R.bind(l),createObservable:y.bind(l),dispose:()=>{r(),n.dispose()},subscribers:n.subscribers};return Object.assign(l,u),l}var Z=C;

package/GlobalStore.mjs

@@ -1 +1 @@
-var q=Object.defineProperty,j=Object.defineProperties;var V=Object.getOwnPropertyDescriptors;var x=Object.getOwnPropertySymbols;var W=Object.prototype.hasOwnProperty,B=Object.prototype.propertyIsEnumerable;var O=(S,t,e)=>t in S?q(S,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):S[t]=e,k=(S,t)=>{for(var e in t||(t={}))W.call(t,e)&&O(S,e,t[e]);if(x)for(var e of x(t))B.call(t,e)&&O(S,e,t[e]);return S},m=(S,t)=>j(S,V(t));import{useDebugValue as I,useMemo as L,useRef as G,useSyncExternalStore as z}from"react";import f from"json-storage-formatter/isFunction";import D from"./isRecord.mjs";import K,{isArray as N}from"./shallowCompare.mjs";import $ from"./throwWrongKeyOnActionCollectionConfig.mjs";import P from"./uniqueId.mjs";import T from"./GlobalStore.debugProps.mjs";var g=class S{constructor(t,e={metadata:{}}){this.cleanupFunctions=[];this.actionsConfig=null;this.callbacks=null;this.actions=null;this.subscribers=new Set;this.createSelectorHook=v;this.createObservable=A;var n,c,l;this.dispose=this.dispose.bind(this),this.getMetadata=this.getMetadata.bind(this),this.getState=this.getState.bind(this),this.reset=this.reset.bind(this),this.setMetadata=this.setMetadata.bind(this),this.setState=this.setState.bind(this),this.subscribe=this.subscribe.bind(this);let{metadata:a,callbacks:i,actions:o,name:r}=e;if(f(t)&&(this.stateCallback=t),f(a)&&(this.metadataCallback=a),this._name=r!=null?r:P("gs:"),this.state=this.stateCallback?this.stateCallback():t,this.metadata=this.metadataCallback?this.metadataCallback():a!=null?a:{},this.callbacks=i!=null?i:null,this.actionsConfig=o!=null?o:null,T.isDevToolsPresent){let u=(n=new Error().stack)!=null?n:"";(l=(c=T).REACT_GLOBAL_STATE_HOOK_DEBUG)==null||l.call(c,this,e,u)}this.constructor===S&&this.initialize()}async initialize(){var n,c,l,u,d,b,h,p;let t=(c=(n=this.__devtools_initialize_getStoreActionsMapWrapped)==null?void 0:n.call(this))!=null?c:this.getStoreActionsMap(),{actions:e,storeTools:a}=t;this.actions=e,this.storeTools=a,this.use=this.getMainHook();let i=(u=(l=this.onInit)==null?void 0:l.call(this))!=null?u:null;f(i)&&this.cleanupFunctions.push(i);let{onInit:o}=(d=this.callbacks)!=null?d:{};if(!o)return;let r=(h=(b=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:b.call(this,"config/onInit/"))!=null?h:a,s=(p=o==null?void 0:o(r))!=null?p:null;f(s)&&this.cleanupFunctions.push(s)}executeSetStateForSubscriber(t,e){let{selector:a,onStoreChange:i,currentState:o,isEqualRoot:r=(c,l)=>c===l,isEqual:s=(c,l)=>c===l}=t;if(!e.forceUpdate&&r(e.currentState,e.newState))return{didUpdate:!1};let n=a?a(e.newState):e.newState;return!e.forceUpdate&&s(o,n)?{didUpdate:!1}:(this.partialUpdateSubscription(t,{currentState:n}),i({state:n},{identifier:e.identifier}),{didUpdate:!0})}setActualStateWithoutValidations(t,{forceUpdate:e,identifier:a}){let i=this.state;if(!(e||i!==t))return;this.state=t;let r=this.subscribers.values(),s={forceUpdate:e,newState:t,currentState:i,identifier:a};for(let n of r)this.executeSetStateForSubscriber(n,s)}setMetadata(t){let e=f(t)?t(this.metadata):t;this.metadata=e}getMetadata(){return this.metadata}getState(){return this.state}subscribe(...[t,e,a]){var l;let i=f(e),o=i?t:void 0,r=i?e:t,s=(l=i?a:e)!=null?l:void 0,n=o?o(this.state):this.state;s!=null&&s.skipFirst||r(n);let c=k({selector:o,currentState:n,onStoreChange:({state:u})=>r(u)},s);return this.subscribeCallback(c),()=>{this.subscribers.delete(c)}}subscribeCallback(t){var e,a;return(a=(e=this.callbacks)==null?void 0:e.onSubscribed)==null||a.call(e,this.storeTools,t),this.subscribers.add(t),()=>{this.subscribers.delete(t)}}partialUpdateSubscription(t,e){Object.assign(t,e)}getMainHook(){let t=`globalHook:${this._name}`,e=(d,b=[])=>{I(t);let h=N(b)?{dependencies:b}:b!=null?b:{},p=G(null),C=M=>f(d)?d(M):M;p.current=p.current?p.current:k({selector:C,currentState:C(this.state),onStoreChange:()=>{throw new Error("Callback not set")}},h);let w=p.current.dependencies,y=h==null?void 0:h.dependencies,F=m(k({},h),{selector:C,dependencies:y});this.partialUpdateSubscription(p.current,F);let{subscribe:E,getSnapshot:H,getServerSnapshot:_}=L(()=>{let M=U=>(p.current.onStoreChange=U,this.subscribeCallback(p.current)),R=()=>p.current.currentState;return{subscribe:M,getSnapshot:R,getServerSnapshot:R}},[]);return this.reselectIfDependenciesChanged({subscription:p.current,newDependencies:y,currentDependencies:w}),[z(E,H,_),this.getStateOrchestrator(),this.metadata]},a=this,{getMetadata:i,dispose:o,getState:r,reset:s,setMetadata:n,setState:c,subscribe:l}=this,u={actions:this.actions,createObservable:this.createObservable.bind(a),createSelectorHook:this.createSelectorHook.bind(a),dispose:o,metadata:void 0,getMetadata:i,getState:r,reset:s,setMetadata:n,setState:c,subscribe:l,subscribers:this.subscribers,use:e,select:(...d)=>e(...d)[0]};return Object.assign(e,u),Object.defineProperty(e,"metadata",{configurable:!0,enumerable:!0,get:i}),e}reselectIfDependenciesChanged({subscription:t,newDependencies:e,currentDependencies:a}){!t.selector||a===e||(a==null?void 0:a.length)===(e==null?void 0:e.length)&&K(a,e)||this.partialUpdateSubscription(t,{currentState:t.selector(this.state)})}getStateOrchestrator(){return this.actions?this.actions:this.setState}setState(t,{forceUpdate:e,identifier:a}={}){var c,l,u,d,b,h;let i=this.state,o=f(t)?t(i):t;if(!e&&this.state===o)return;let r=this.setActualStateWithoutValidations,s={previousState:i,state:o,identifier:a},n=m(k(k({},this.storeTools),s),{setState:r});Object.defineProperty(n,"metadata",{configurable:!0,enumerable:!0,get:n.getMetadata}),!((c=this.callbacks)!=null&&c.computePreventStateChange&&((u=(l=this.callbacks)==null?void 0:l.computePreventStateChange)!=null&&u.call(l,n)))&&(this.setActualStateWithoutValidations(o,{forceUpdate:e,identifier:a}),(d=this.onStateChanged)==null||d.call(this,n),(h=(b=this.callbacks)==null?void 0:b.onStateChanged)==null||h.call(b,n))}getStoreActionsMap(){let{getMetadata:t,setMetadata:e,getState:a,setState:i,subscribe:o}=this,r={setMetadata:e,get metadata(){return t()},getMetadata:t,getState:a,setState:i,subscribe:o,actions:null};if(!D(this.actionsConfig))return{actions:null,storeTools:r};let s=this.actionsConfig,n={};r.actions=n;let c=Object.keys(s);for(let l of c)Object.assign(n,{[l](...u){let b=s[l].apply(n,u);return typeof b!="function"&&$(l),b.call(n,r)}});return{actions:n,storeTools:r}}removeSubscriptions(){this.subscribers.clear()}executeCleanupTasks(){this.cleanupFunctions.forEach(t=>{t==null||t()}),this.cleanupFunctions.length=0}dispose(){this.removeSubscriptions(),this.executeCleanupTasks()}reset(...t){var c,l,u,d,b,h;this.executeCleanupTasks();let e=t.length>0,a=e?t[0]:this.stateCallback?this.stateCallback():this.state,i=e?t[1]:this.metadataCallback?this.metadataCallback():this.metadata;this.setActualStateWithoutValidations(a,{forceUpdate:!0}),this.setMetadata(i);let o=(l=(c=this.onInit)==null?void 0:c.call(this))!=null?l:null;f(o)&&this.cleanupFunctions.push(o);let{onInit:r}=(u=this.callbacks)!=null?u:{};if(!r)return;let s=(b=(d=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:d.call(this,"config/onInit/"))!=null?b:this.storeTools,n=(h=r==null?void 0:r(s))!=null?h:null;f(n)&&this.cleanupFunctions.push(n)}};function A(S,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,i=t==null?void 0:t.isEqual,o=this.getState(),r=(S!=null?S:u=>u)(o),s=new g(r,{name:e!=null?e:P("sh:")}),n=this.subscribe(u=>{if((a!=null?a:Object.is)(o,u))return;o=u;let b=S(u);(i!=null?i:Object.is)(r,b)||(r=b,s.setState(b))},{skipFirst:!0}),c=s.subscribe.bind(s),l={getState:s.getState.bind(s),subscribe:s.subscribe.bind(s),createSelectorHook:v.bind(c),createObservable:A.bind(c),dispose:()=>{n(),s.dispose()},subscribers:s.subscribers};return Object.assign(c,l),c}function v(S,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,i=t==null?void 0:t.isEqual,o=this.getState(),r=(S!=null?S:u=>u)(o),s=new g(r,{name:e!=null?e:P("sh:")}),n=this.subscribe(u=>{if((a!=null?a:Object.is)(o,u))return;o=u;let b=S(u);(i!=null?i:Object.is)(r,b)||(r=b,s.setState(b))},{skipFirst:!0}),c=(...u)=>{let[d]=s.use(...u);return d},l={getState:()=>s.getState(),subscribe:s.subscribe.bind(s),createSelectorHook:v.bind(c),createObservable:A.bind(c),dispose:()=>{n(),s.dispose()},subscribers:s.subscribers};return Object.assign(c,l),c}var ot=g;export{g as GlobalStore,A as createObservable,v as createSelectorHook,ot as default};
+var q=Object.defineProperty,j=Object.defineProperties;var V=Object.getOwnPropertyDescriptors;var x=Object.getOwnPropertySymbols;var W=Object.prototype.hasOwnProperty,B=Object.prototype.propertyIsEnumerable;var O=(S,t,e)=>t in S?q(S,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):S[t]=e,k=(S,t)=>{for(var e in t||(t={}))W.call(t,e)&&O(S,e,t[e]);if(x)for(var e of x(t))B.call(t,e)&&O(S,e,t[e]);return S},m=(S,t)=>j(S,V(t));import{useDebugValue as I,useRef as L,useState as G,useSyncExternalStore as z}from"react";import f from"json-storage-formatter/isFunction";import D from"./isRecord.mjs";import K,{isArray as N}from"./shallowCompare.mjs";import $ from"./throwWrongKeyOnActionCollectionConfig.mjs";import P from"./uniqueId.mjs";import T from"./GlobalStore.debugProps.mjs";var g=class S{constructor(t,e={metadata:{}}){this.cleanupFunctions=[];this.actionsConfig=null;this.callbacks=null;this.actions=null;this.subscribers=new Set;this.createSelectorHook=v;this.createObservable=A;var o,c,l;this.dispose=this.dispose.bind(this),this.getMetadata=this.getMetadata.bind(this),this.getState=this.getState.bind(this),this.reset=this.reset.bind(this),this.setMetadata=this.setMetadata.bind(this),this.setState=this.setState.bind(this),this.subscribe=this.subscribe.bind(this);let{metadata:a,callbacks:i,actions:n,name:r}=e;if(f(t)&&(this.stateCallback=t),f(a)&&(this.metadataCallback=a),this._name=r!=null?r:P("gs:"),this.state=this.stateCallback?this.stateCallback():t,this.metadata=this.metadataCallback?this.metadataCallback():a!=null?a:{},this.callbacks=i!=null?i:null,this.actionsConfig=n!=null?n:null,T.isDevToolsPresent){let u=(o=new Error().stack)!=null?o:"";(l=(c=T).REACT_GLOBAL_STATE_HOOK_DEBUG)==null||l.call(c,this,e,u)}this.constructor===S&&this.initialize()}async initialize(){var o,c,l,u,d,b,h,p;let t=(c=(o=this.__devtools_initialize_getStoreActionsMapWrapped)==null?void 0:o.call(this))!=null?c:this.getStoreActionsMap(),{actions:e,storeTools:a}=t;this.actions=e,this.storeTools=a,this.use=this.getMainHook();let i=(u=(l=this.onInit)==null?void 0:l.call(this))!=null?u:null;f(i)&&this.cleanupFunctions.push(i);let{onInit:n}=(d=this.callbacks)!=null?d:{};if(!n)return;let r=(h=(b=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:b.call(this,"config/onInit/"))!=null?h:a,s=(p=n==null?void 0:n(r))!=null?p:null;f(s)&&this.cleanupFunctions.push(s)}executeSetStateForSubscriber(t,e){let{selector:a,onStoreChange:i,currentState:n,isEqualRoot:r=(c,l)=>c===l,isEqual:s=(c,l)=>c===l}=t;if(!e.forceUpdate&&r(e.currentState,e.newState))return{didUpdate:!1};let o=a?a(e.newState):e.newState;return!e.forceUpdate&&s(n,o)?{didUpdate:!1}:(this.partialUpdateSubscription(t,{currentState:o}),i({state:o},{identifier:e.identifier}),{didUpdate:!0})}setActualStateWithoutValidations(t,{forceUpdate:e,identifier:a}){let i=this.state;if(!(e||i!==t))return;this.state=t;let r=this.subscribers.values(),s={forceUpdate:e,newState:t,currentState:i,identifier:a};for(let o of r)this.executeSetStateForSubscriber(o,s)}setMetadata(t){let e=f(t)?t(this.metadata):t;this.metadata=e}getMetadata(){return this.metadata}getState(){return this.state}subscribe(...[t,e,a]){var l;let i=f(e),n=i?t:void 0,r=i?e:t,s=(l=i?a:e)!=null?l:void 0,o=n?n(this.state):this.state;s!=null&&s.skipFirst||r(o);let c=k({selector:n,currentState:o,onStoreChange:({state:u})=>r(u)},s);return this.subscribeCallback(c),()=>{this.subscribers.delete(c)}}subscribeCallback(t){var e,a;return(a=(e=this.callbacks)==null?void 0:e.onSubscribed)==null||a.call(e,this.storeTools,t),this.subscribers.add(t),()=>{this.subscribers.delete(t)}}partialUpdateSubscription(t,e){Object.assign(t,e)}getMainHook(){let t=`globalHook:${this._name}`,e=(d,b=[])=>{I(t);let h=N(b)?{dependencies:b}:b!=null?b:{},p=L(null),C=M=>f(d)?d(M):M;p.current=p.current?p.current:k({selector:C,currentState:C(this.state),onStoreChange:()=>{throw new Error("Callback not set")}},h);let w=p.current.dependencies,y=h==null?void 0:h.dependencies,F=m(k({},h),{selector:C,dependencies:y});this.partialUpdateSubscription(p.current,F);let[{subscribe:E,getSnapshot:H,getServerSnapshot:_}]=G(()=>{let M=U=>(p.current.onStoreChange=U,this.subscribeCallback(p.current)),R=()=>p.current.currentState;return{subscribe:M,getSnapshot:R,getServerSnapshot:R}});return this.reselectIfDependenciesChanged({subscription:p.current,newDependencies:y,currentDependencies:w}),[z(E,H,_),this.getStateOrchestrator(),this.metadata]},a=this,{getMetadata:i,dispose:n,getState:r,reset:s,setMetadata:o,setState:c,subscribe:l}=this,u={actions:this.actions,createObservable:this.createObservable.bind(a),createSelectorHook:this.createSelectorHook.bind(a),dispose:n,metadata:void 0,getMetadata:i,getState:r,reset:s,setMetadata:o,setState:c,subscribe:l,subscribers:this.subscribers,use:e,select:(...d)=>e(...d)[0]};return Object.assign(e,u),Object.defineProperty(e,"metadata",{configurable:!0,enumerable:!0,get:i}),e}reselectIfDependenciesChanged({subscription:t,newDependencies:e,currentDependencies:a}){!t.selector||a===e||(a==null?void 0:a.length)===(e==null?void 0:e.length)&&K(a,e)||this.partialUpdateSubscription(t,{currentState:t.selector(this.state)})}getStateOrchestrator(){return this.actions?this.actions:this.setState}setState(t,{forceUpdate:e,identifier:a}={}){var c,l,u,d,b,h;let i=this.state,n=f(t)?t(i):t;if(!e&&this.state===n)return;let r=this.setActualStateWithoutValidations,s={previousState:i,state:n,identifier:a},o=m(k(k({},this.storeTools),s),{setState:r});Object.defineProperty(o,"metadata",{configurable:!0,enumerable:!0,get:o.getMetadata}),!((c=this.callbacks)!=null&&c.computePreventStateChange&&((u=(l=this.callbacks)==null?void 0:l.computePreventStateChange)!=null&&u.call(l,o)))&&(this.setActualStateWithoutValidations(n,{forceUpdate:e,identifier:a}),(d=this.onStateChanged)==null||d.call(this,o),(h=(b=this.callbacks)==null?void 0:b.onStateChanged)==null||h.call(b,o))}getStoreActionsMap(){let{getMetadata:t,setMetadata:e,getState:a,setState:i,subscribe:n}=this,r={setMetadata:e,get metadata(){return t()},getMetadata:t,getState:a,setState:i,subscribe:n,actions:null};if(!D(this.actionsConfig))return{actions:null,storeTools:r};let s=this.actionsConfig,o={};r.actions=o;let c=Object.keys(s);for(let l of c)Object.assign(o,{[l](...u){let b=s[l].apply(o,u);return typeof b!="function"&&$(l),b.call(o,r)}});return{actions:o,storeTools:r}}removeSubscriptions(){this.subscribers.clear()}executeCleanupTasks(){this.cleanupFunctions.forEach(t=>{t==null||t()}),this.cleanupFunctions.length=0}dispose(){this.removeSubscriptions(),this.executeCleanupTasks()}reset(...t){var c,l,u,d,b,h;this.executeCleanupTasks();let e=t.length>0,a=e?t[0]:this.stateCallback?this.stateCallback():this.state,i=e?t[1]:this.metadataCallback?this.metadataCallback():this.metadata;this.setActualStateWithoutValidations(a,{forceUpdate:!0}),this.setMetadata(i);let n=(l=(c=this.onInit)==null?void 0:c.call(this))!=null?l:null;f(n)&&this.cleanupFunctions.push(n);let{onInit:r}=(u=this.callbacks)!=null?u:{};if(!r)return;let s=(b=(d=this.__devtools_getLifeCycleStoreToolsWrapper)==null?void 0:d.call(this,"config/onInit/"))!=null?b:this.storeTools,o=(h=r==null?void 0:r(s))!=null?h:null;f(o)&&this.cleanupFunctions.push(o)}};function A(S,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,i=t==null?void 0:t.isEqual,n=this.getState(),r=(S!=null?S:u=>u)(n),s=new g(r,{name:e!=null?e:P("sh:")}),o=this.subscribe(u=>{if((a!=null?a:Object.is)(n,u))return;n=u;let b=S(u);(i!=null?i:Object.is)(r,b)||(r=b,s.setState(b))},{skipFirst:!0}),c=s.subscribe.bind(s),l={getState:s.getState.bind(s),subscribe:s.subscribe.bind(s),createSelectorHook:v.bind(c),createObservable:A.bind(c),dispose:()=>{o(),s.dispose()},subscribers:s.subscribers};return Object.assign(c,l),c}function v(S,t){let e=t==null?void 0:t.name,a=t==null?void 0:t.isEqualRoot,i=t==null?void 0:t.isEqual,n=this.getState(),r=(S!=null?S:u=>u)(n),s=new g(r,{name:e!=null?e:P("sh:")}),o=this.subscribe(u=>{if((a!=null?a:Object.is)(n,u))return;n=u;let b=S(u);(i!=null?i:Object.is)(r,b)||(r=b,s.setState(b))},{skipFirst:!0}),c=(...u)=>{let[d]=s.use(...u);return d},l={getState:()=>s.getState(),subscribe:s.subscribe.bind(s),createSelectorHook:v.bind(c),createObservable:A.bind(c),dispose:()=>{o(),s.dispose()},subscribers:s.subscribers};return Object.assign(c,l),c}var nt=g;export{g as GlobalStore,A as createObservable,v as createSelectorHook,nt as default};

package/README.md

@@ -1,18 +1,18 @@
 # react-hooks-global-states 🌟
 
-![Image John Avatar](https://raw.githubusercontent.com/johnny-quesada-developer/global-hooks-example/main/public/avatar2.jpeg)
+![Johnny Quesada](https://raw.githubusercontent.com/johnny-quesada-developer/global-hooks-example/main/public/avatar2.jpeg)
 
 <div align="center">
 
-**Zero setup. Zero complexity. Maximum performance.** 🚀
+**Shared React state. Precise subscriptions. Built-in DevTools.** 🚀
 
-_One line of code. Infinite possibilities._ ✨
+_The familiarity of `useState`, with the power of a shared store._
 
 [![npm version](https://img.shields.io/npm/v/react-hooks-global-states.svg)](https://www.npmjs.com/package/react-hooks-global-states)
 [![Downloads](https://img.shields.io/npm/dm/react-hooks-global-states.svg)](https://www.npmjs.com/package/react-hooks-global-states)
 [![License](https://img.shields.io/npm/l/react-hooks-global-states.svg)](https://github.com/johnny-quesada-developer/react-hooks-global-states/blob/main/LICENSE)
 
-[**Live Demo**](https://johnny-quesada-developer.github.io/global-hooks-example/) • [**Video Tutorial**](https://www.youtube.com/watch?v=1UBqXk2MH8I/) • [**CodePen**](https://codepen.io/johnnynabetes/pen/WNmeGwb?editors=0010)
+[**Live Demo**](https://johnny-quesada-developer.github.io/global-hooks-example/) • [**Video Tutorial**](https://www.youtube.com/watch?v=1UBqXk2MH8I) • [**CodePen**](https://codepen.io/johnnynabetes/pen/WNmeGwb?editors=0010)
 
 </div>
 
@@ -26,7 +26,7 @@ import { createGlobalState } from 'react-hooks-global-states';
 export const useCounter = createGlobalState(0);
 ```
 
-**That's it.** No providers. No context boilerplate. No configuration files. Just pure, beautiful state management. 🎨
+**That's it.** No providers. No context boilerplate. No configuration files. Shared state with a familiar React API.
 
 ```tsx
 // Use it anywhere, instantly
@@ -38,13 +38,13 @@ function Counter() {
 
 ---
 
-## 🚀 Why Developers Love This Library
+## 🚀 Built for React applications
 
 <table>
 <tr>
 <td width="50%">
 
-### 🎓 **Zero Learning Curve**
+### 🎓 **Familiar React API**
 
 ```tsx
 // If you know this...
@@ -57,9 +57,9 @@ const [state, setState] = useGlobalState();
 </td>
 <td width="50%">
 
-### ⚡ **Blazing Fast**
+### ⚡ **Precise subscriptions**
 
-Only components that care about a slice re-render. Surgical precision, maximum performance.
+Subscribe to a slice so unrelated store changes do not trigger component updates.
 
 ```tsx
 // Only re-renders when name changes
@@ -75,7 +75,7 @@ const [name] = useStore((s) => s.user.name);
 ### 🔗 **Chainable Selectors**
 
 ```tsx
-const useUsers = store.createSelectorHook((s) => s.users);
+const useUsers = useStore.createSelectorHook((s) => s.users);
 const useAdmins = useUsers.createSelectorHook((users) => users.filter((u) => u.isAdmin));
 ```
 
@@ -116,7 +116,7 @@ const Form = createContext({ name: '', email: '' });
 </td>
 <td width="50%">
 
-### � **Non-Reactive API**
+### 📦 **Non-Reactive API**
 
 Use state anywhere - even outside React components!
 
@@ -167,59 +167,53 @@ function ThemedComponent() {
 }
 ```
 
-### 60 Seconds to Production-Ready
+### Async state with actions
+
+Keep loading and error values in state so components update throughout the request.
 
 ```tsx
 import { createGlobalState } from 'react-hooks-global-states';
 
+type User = { id: string; name: string };
+
 const useAuth = createGlobalState(
-  { user: null, token: null },
+  () => ({ user: null as User | null, isLoading: false, error: null as string | null }),
   {
-    // Non-reactive metadata
-    metadata: { isLoading: false },
-
-    // Type-safe actions
     actions: {
-      login(email, password) {
-        return async ({ setState, setMetadata }) => {
-          setMetadata({ isLoading: true });
+      login(authenticate: () => Promise<User>) {
+        return async ({ setState }) => {
+          setState((state) => ({ ...state, isLoading: true, error: null }));
           try {
-            const { user, token } = await api.login(email, password);
-            setState({ user, token });
-            return { success: true };
+            const user = await authenticate();
+            setState({ user, isLoading: false, error: null });
           } catch (error) {
-            return { success: false, error };
-          } finally {
-            setMetadata({ isLoading: false });
+            setState((state) => ({
+              ...state,
+              isLoading: false,
+              error: error instanceof Error ? error.message : 'Sign-in failed',
+            }));
           }
         };
       },
-
       logout() {
         return ({ setState }) => {
-          setState({ user: null, token: null });
+          setState({ user: null, isLoading: false, error: null });
         };
       },
     },
   },
 );
 
-// Usage
-function LoginForm() {
-  const [auth, actions] = useAuth();
-  const { isLoading } = useAuth.getMetadata();
-
-  const handleSubmit = async (e) => {
-    e.preventDefault();
-    const result = await actions.login(email, password);
-    if (!result.success) toast.error(result.error);
-  };
+function LoginButton({ authenticate }: { authenticate: () => Promise<User> }) {
+  const [{ isLoading, error }, actions] = useAuth();
 
   return (
-    <form onSubmit={handleSubmit}>
-      {/* ... */}
-      <button disabled={isLoading}>{isLoading ? 'Logging in...' : 'Login'}</button>
-    </form>
+    <div>
+      <button disabled={isLoading} onClick={() => void actions.login(authenticate)}>
+        {isLoading ? 'Signing in…' : 'Sign in'}
+      </button>
+      {error && <p role="alert">{error}</p>}
+    </div>
   );
 }
 ```
@@ -257,7 +251,7 @@ const useExpensiveState = createGlobalState(() => {
 
 #### 🎯 Surgical Re-renders with Selectors
 
-The secret sauce: components only re-render when _their specific slice_ changes!
+Selectors keep components subscribed to the state they use.
 
 ```tsx
 const useStore = createGlobalState({
@@ -297,16 +291,16 @@ function NotificationCount() {
 }
 ```
 
-**Performance comparison:**
+**Subscription behavior:**
 
-| Approach        | Re-renders when ANY state changes? |
-| --------------- | ---------------------------------- |
-| Context (naive) | ✅ YES (performance killer)        |
-| This library    | ❌ NO (only selected slices)       |
+| Subscription | What triggers an update |
+| --- | --- |
+| `useStore()` | Any store value change |
+| `useStore(selector)` | A change to the selected value |
 
 #### ⚡ Computed Values with Dependencies
 
-Derive values efficiently with automatic recomputation control! - selectors can depend on external state (like `useState`)!
+Derive values from both store state and component-local values, with explicit dependencies.
 
 ```tsx
 const useStore = createGlobalState({
@@ -382,9 +376,9 @@ function AdvancedFiltered() {
 }
 ```
 
-#### 🔗 Reusable Selector Hooks (The Game Changer!)
+#### 🔗 Reusable Selector Hooks
 
-Create hooks from hooks! Chain them! Compose them! This is where it gets fun! 🎉
+Compose reusable selector hooks. Each hook returns its selected value directly.
 
 ```tsx
 const useStore = createGlobalState({
@@ -412,9 +406,9 @@ const useCurrentUser = useStore.createSelectorHook((state) => {
 
 // Now use them anywhere!
 function UserStats() {
-  const [totalUsers] = useUsers();
-  const [activeUsers] = useActiveUsers();
-  const [activeAdmins] = useActiveAdmins();
+  const totalUsers = useUsers();
+  const activeUsers = useActiveUsers();
+  const activeAdmins = useActiveAdmins();
 
   return (
     <div>
@@ -426,19 +420,24 @@ function UserStats() {
 }
 
 function CurrentUserProfile() {
-  const [user] = useCurrentUser();
+  const user = useCurrentUser();
   return <div>{user?.name}</div>;
 }
 
-// 🎯 Key insight: All these hooks share the SAME setState!
-function AnyComponent() {
-  const [, setFromUsers] = useUsers();
-  const [, setFromAdmins] = useActiveAdmins();
-  const [, setFromStore] = useStore();
-
-  console.log(setFromUsers === setFromAdmins); // true!
-  console.log(setFromUsers === setFromStore); // true!
-  console.log(setFromUsers === useStore.setState); // true!
+// Selector hooks return values. Update the source store through its API.
+function ActivateAll() {
+  return (
+    <button
+      onClick={() =>
+        useStore.setState((state) => ({
+          ...state,
+          users: state.users.map((user) => ({ ...user, active: true })),
+        }))
+      }
+    >
+      Activate all users
+    </button>
+  );
 }
 ```
 
@@ -595,7 +594,7 @@ const unsubscribe = useAuth.subscribe(
 );
 ```
 
-#### 🔭 Observable Fragments (RxJS-style)
+#### 🔭 Observable Fragments
 
 Create observable slices of your state for reactive programming!
 
@@ -625,46 +624,23 @@ const doubledObservable = countObservable.createObservable((count) => count * 2)
 
 #### 📋 Metadata - Non-Reactive Side Info
 
-Store data that doesn't need to trigger re-renders!
+Keep request counters and timestamps in metadata when they are read only by handlers or background work.
+Put loading indicators and displayed errors in state so components subscribe to their changes.
 
 ```tsx
 const useStore = createGlobalState(
-  { items: [] },
-  {
-    metadata: {
-      isLoading: false,
-      lastFetch: null,
-      error: null,
-      retryCount: 0,
-    },
-  },
+  { items: [] as string[] },
+  { metadata: { requests: 0, lastFetchedAt: null as number | null } },
 );
 
-// Metadata changes don't trigger re-renders!
-useStore.setMetadata({ isLoading: true });
-
-// But you can access it anytime
-const meta = useStore.getMetadata();
-console.log(meta.isLoading); // true
+// Metadata is replaced, so preserve the fields you are not updating.
+useStore.setMetadata((metadata) => ({ ...metadata, requests: metadata.requests + 1 }));
 
-// Perfect for loading states, error tracking, etc.
-async function fetchData() {
-  useStore.setMetadata({ isLoading: true, error: null });
+console.log(useStore.metadata.requests); // 1
 
-  try {
-    const items = await api.fetch();
-    useStore.setState({ items });
-    useStore.setMetadata({
-      isLoading: false,
-      lastFetch: new Date(),
-    });
-  } catch (error) {
-    useStore.setMetadata({
-      isLoading: false,
-      error: error.message,
-      retryCount: useStore.getMetadata().retryCount + 1,
-    });
-  }
+function recordFetchedItems(items: string[]) {
+  useStore.setMetadata((metadata) => ({ ...metadata, lastFetchedAt: Date.now() }));
+  useStore.setState({ items });
 }
 ```
 
@@ -745,7 +721,7 @@ function App() {
 
 #### 🎯 Context + Selectors = ❤️
 
-Everything that works with `createGlobalState` works with `createContext`!
+Use the same selectors, actions and metadata with state scoped to each provider.
 
 ```tsx
 const FormContext = createContext({
@@ -845,7 +821,7 @@ function App() {
 }
 
 function UserList() {
-  const [activeUsers] = useActiveUsers();
+  const activeUsers = useActiveUsers();
   return (
     <ul>
       {activeUsers.map((u) => (
@@ -1016,7 +992,7 @@ const SessionContext = createContext(
   },
 );
 
-// Internal actions are not expose through the context
+// Internal actions are not exposed through the context
 const { loadData } = SessionContext.use.actions();
 console.log(loadData); // undefined
 ```
@@ -1342,9 +1318,9 @@ function TodoApp() {
 }
 ```
 
-**Why this pattern rocks:**
+**Benefits of this structure:**
 
-- ✅ **KISS** - Keep It Simple, Stupid! Easy to navigate
+- ✅ **Focused modules** - Keep related state, actions and selectors easy to navigate
 - ✅ **Type-safe** - Everything is strongly typed
 - ✅ **Public/Private APIs** - Internal actions don't pollute public interface
 - ✅ **Namespace pattern** - Everything bundled: `todos$.useActiveTodos()`, `todos$.activeTodos$`
@@ -1548,7 +1524,7 @@ actions.addTodo('Build feature', userId);
 | Resource                                                                             | Description                       |
 | ------------------------------------------------------------------------------------ | --------------------------------- |
 | 🎮 [**Live Demo**](https://johnny-quesada-developer.github.io/global-hooks-example/) | Interactive examples              |
-| 🎥 [**Video Tutorial**](https://www.youtube.com/watch?v=1UBqXk2MH8I/)                | Full walkthrough                  |
+| 🎥 [**Video Tutorial**](https://www.youtube.com/watch?v=1UBqXk2MH8I)                | Full walkthrough                  |
 | 💻 [**CodePen**](https://codepen.io/johnnynabetes/pen/WNmeGwb?editors=0010)          | Try it online                     |
 | 📚 **400+ Tests**                                                                    | Check the test suite for patterns |
 
@@ -1566,18 +1542,7 @@ actions.addTodo('Build feature', userId);
 
 ## 🎉 Why Developers Choose This
 
-```tsx
-"I replaced 500 lines of Redux with 50 lines of this. Mind blown." 🤯
-  - Every developer who tries it
-
-"The useState I always wanted." ❤️
-  - React developers everywhere
-
-"Finally, state management that doesn't fight me." 🥊
-  - Tired developers worldwide
-```
-
-### The Bottom Line
+### At a glance
 
 | What You Get                | What You Don't        |
 | --------------------------- | --------------------- |
@@ -1587,7 +1552,7 @@ actions.addTodo('Build feature', userId);
 | ✅ TypeScript inference     | ❌ Manual typing      |
 | ✅ Global + Context         | ❌ Either/or choice   |
 | ✅ Actions (optional)       | ❌ Required structure |
-| ✅ 30-second learning curve | ❌ Week-long training |
+| ✅ Familiar hook syntax     | ❌ New component APIs |
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-hooks-global-states",
-  "version": "16.0.4-beta",
-  "description": "A package to easily handle global state across your React components using hooks.",
+  "version": "16.0.5-beta.0",
+  "description": "The shared state engine for React and React Native: selective subscriptions, derived state, actions and scoped stores.",
   "main": "./bundle.cjs",
   "module": "./bundle.mjs",
   "types": "./index.d.ts",
@@ -62,6 +62,9 @@
       "import": "./debug.mjs",
       "require": "./debug.cjs"
     },
+    "./rgsh": {
+      "import": "./rgsh.mjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -94,7 +97,7 @@
   "homepage": "https://github.com/johnny-quesada-developer/react-hooks-global-states#readme",
   "dependencies": {
     "json-storage-formatter": "^4.0.0",
-    "react-hooks-global-states-debug": "^16.0.4-beta"
+    "react-hooks-global-states-debug": "^16.0.5-beta.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -104,5 +107,8 @@
     "react": {
       "optional": false
     }
+  },
+  "bin": {
+    "rgsh": "./rgsh.mjs"
   }
 }

package/rgsh.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import 'react-hooks-global-states-debug/cli';

package/types.d.ts

@@ -58,7 +58,7 @@ export type StateApi<State, StateMutator, Metadata extends BaseMetadata> = {
     getMetadata: MetadataGetter<Metadata>;
     /**
      * Sets the metadata value
-     * The metadata value is not reactive and wont trigger re-renders
+     * The metadata value is not reactive and won’t trigger re-renders
      */
     setMetadata: MetadataSetter<Metadata>;
     /**
@@ -83,10 +83,9 @@ export type StateApi<State, StateMutator, Metadata extends BaseMetadata> = {
      */
     subscribe: SubscribeToState<State>;
     /***
-     * @description Creates a new hooks that returns the result of the selector passed as a parameter
-     * Your can create selector hooks of other selectors hooks and extract as many derived states as or fragments of the state as you want
-     * The selector hook will be evaluated only if the result of the selector changes and the equality function returns false
-     * you can customize the equality function by passing the isEqualRoot and isEqual parameters
+     * @description Creates a read-only hook that returns the selected value directly.
+     * Selector hooks can be chained to derive further values.
+     * `isEqualRoot` controls recomputation; `isEqual` controls updates to the derived value.
      */
     createSelectorHook: <Selection>(selector: (state: State) => Selection, args?: Omit<UseHookOptions<Selection, State>, 'dependencies'> & {
         name?: string;
@@ -110,7 +109,7 @@ export type StateApi<State, StateMutator, Metadata extends BaseMetadata> = {
     select: SelectHook<State>;
     /**
      * @description Sugared hook to use the global state in React components
-     * Allows you to tread the global hook as an store, with better semantics
+     * Access the hook through the store’s `use` property
      *
      * @example
      * ```tsx
@@ -189,7 +188,7 @@ export interface StateHook<State, StateMutator, Metadata extends BaseMetadata> e
 }
 /**
  * @description Function to set the metadata value
- * The metadata value is not reactive and wont trigger re-renders
+ * The metadata value is not reactive and won’t trigger re-renders
  */
 export type MetadataSetter<Metadata extends BaseMetadata> = (setter: Metadata | ((metadata: Metadata) => Metadata)) => void;
 /**
@@ -632,35 +631,25 @@ export type ContextPublicApi<State, StateMutator, Metadata extends BaseMetadata>
      *  - isEqual: A function to compare the current and next selected fragment for equality.
      *  - isEqualRoot: A function to compare the entire state for equality.
      *  - name: An optional name for debugging purposes.
-     * @returns A new context hook that provides access to the selected fragment of the state,
-     * along with the state mutator and metadata.
+     * @returns A read-only context hook that returns the selected value directly.
      *
      * @example
      * ```tsx
-     * const useTodos = createContext({
-     *   todos: [],
-     *   filter: '',
-     * }, {
-     * actions: {
-     *   setFilter(filter: string) {
-     *   ...
+     * const todos = createContext({ filter: '' }, {
+     *   actions: {
+     *     setFilter(filter: string) {
+     *       return ({ setState }) => setState({ filter });
+     *     },
+     *   },
      * });
      *
-     * const useFilter = useTodos.createSelectorHook((state) => {
-     *   return state.filter;
-     * });
+     * const useFilter = todos.use.createSelectorHook((state) => state.filter);
      *
      * function FilterComponent() {
-     *   // The selector only listen to the selected fragment (filter)
-     *   // But has access to the full actions collection
-     *   const [filter, { setFilter }] = useFilter();
+     *   const filter = useFilter();
+     *   const { setFilter } = todos.use.actions();
      *
-     *   return (
-     *     <input
-     *       value={filter}
-     *       onChange={(e) => setFilter(e.target.value)}
-     *     />
-     *   );
+     *   return <input value={filter} onChange={(event) => setFilter(event.target.value)} />;
      * }
      * ```
      */
@@ -749,10 +738,10 @@ export interface CreateContext {
          *
          * There are two ways to use the hook
          * @example
-         * The more simple and familiar way is to use it as a regular hook
+         * Destructure `use` to name the context hook:
          *
          * ```tsx
-         * const { Context, Provider, user: useUser} = createContext({ name: 'John', age: 30 });
+         * const { Context, Provider, use: useUser} = createContext({ name: 'John', age: 30 });
          *
          * function UserProfile() {
          *  const [state, setState, metadata] = useUser();
@@ -762,7 +751,7 @@ export interface CreateContext {
          * ```
          *
          * @example
-         * The recommended, more sematic and easier to read way:
+         * Access the hook and provider through the context object:
          *
          * ```tsx
          * const user = createContext({ name: 'John', age: 30 });
@@ -795,7 +784,7 @@ export interface CreateContext {
      * @param args.name Optional name for debugging purposes.
      * @param args.metadata Optional non-reactive metadata associated with the state.
      * @param args.callbacks Optional lifecycle callbacks for the context.
-     * @param args.actions Optional actions to restrict state mutations [if provided `setState` will be nullified].
+     * @param args.actions Optional actions returned as the hook’s second item; `setState` remains available on the store API.
      * @returns An object containing:
      * - **`use`** — A custom hook to read and mutate the context state.
      *   Supports selectors for granular subscriptions and returns `[state, stateMutator, metadata]`.
@@ -814,7 +803,7 @@ export interface CreateContext {
      * @param args.name Optional name for debugging purposes.
      * @param args.metadata Optional non-reactive metadata associated with the state.
      * @param args.callbacks Optional lifecycle callbacks for the context.
-     * @param args.actions Optional actions to restrict state mutations [if provided `setState` will be nullified].
+     * @param args.actions Optional actions returned as the hook’s second item; `setState` remains available on the store API.
      */
     args: {
         name?: string;
@@ -828,10 +817,10 @@ export interface CreateContext {
          *
          * There are two ways to use the hook
          * @example
-         * The more simple and familiar way is to use it as a regular hook
+         * Destructure `use` to name the context hook:
          *
          * ```tsx
-         * const { Context, Provider, user: useUser} = createContext({ name: 'John', age: 30 });
+         * const { Context, Provider, use: useUser} = createContext({ name: 'John', age: 30 });
          *
          * function UserProfile() {
          *  const [state, setState, metadata] = useUser();
@@ -841,7 +830,7 @@ export interface CreateContext {
          * ```
          *
          * @example
-         * The recommended, more sematic and easier to read way:
+         * Access the hook and provider through the context object:
          *
          * ```tsx
          * const user = createContext({ name: 'John', age: 30 });
@@ -874,7 +863,7 @@ export interface CreateContext {
      * @param args.name Optional name for debugging purposes.
      * @param args.metadata Optional non-reactive metadata associated with the state.
      * @param args.callbacks Optional lifecycle callbacks for the context.
-     * @param args.actions Optional actions to restrict state mutations [if provided `setState` will be nullified].
+     * @param args.actions Optional actions returned as the hook’s second item; `setState` remains available on the store API.
      * @returns An object containing:
      * - **`use`** — A custom hook to read and mutate the context state.
      *   Supports selectors for granular subscriptions and returns `[state, stateMutator, metadata]`.
@@ -893,7 +882,7 @@ export interface CreateContext {
      * @param args.name Optional name for debugging purposes.
      * @param args.metadata Optional non-reactive metadata associated with the state.
      * @param args.callbacks Optional lifecycle callbacks for the context.
-     * @param args.actions Optional actions to restrict state mutations [if provided `setState` will be nullified].
+     * @param args.actions Optional actions returned as the hook’s second item; `setState` remains available on the store API.
      */
     args: {
         name?: string;
@@ -907,10 +896,10 @@ export interface CreateContext {
          *
          * There are two ways to use the hook
          * @example
-         * The more simple and familiar way is to use it as a regular hook
+         * Destructure `use` to name the context hook:
          *
          * ```tsx
-         * const { Context, Provider, user: useUser} = createContext({ name: 'John', age: 30 });
+         * const { Context, Provider, use: useUser} = createContext({ name: 'John', age: 30 });
          *
          * function UserProfile() {
          *  const [state, setState, metadata] = useUser();
@@ -920,7 +909,7 @@ export interface CreateContext {
          * ```
          *
          * @example
-         * The recommended, more sematic and easier to read way:
+         * Access the hook and provider through the context object:
          *
          * ```tsx
          * const user = createContext({ name: 'John', age: 30 });
@@ -1038,7 +1027,7 @@ export interface CreateGlobalState {
      * @param args.name optional name for debugging purposes
      * @param args.metadata optional non-reactive metadata associated with the state (can be a value or callback)
      * @param args.callbacks optional lifecycle callbacks for the global state
-     * @param args.actions optional actions to restrict state mutations [if provided `setState` will be nullified]
+     * @param args.actions Optional actions returned as the hook’s second item; `setState` remains available on the store API
      * @returns a state hook that you can use in your components
      *
      * @example
@@ -1103,7 +1092,7 @@ export interface CreateGlobalState {
      * @param args.name optional name for debugging purposes
      * @param args.metadata optional non-reactive metadata associated with the state (can be a value or callback)
      * @param args.callbacks optional lifecycle callbacks for the global state
-     * @param args.actions optional actions to restrict state mutations [if provided `setState` will be nullified]
+     * @param args.actions Optional actions returned as the hook’s second item; `setState` remains available on the store API
      * @returns a state hook that you can use in your components
      *
      * @example