react-shared-states 1.0.11 → 1.0.12

package/dist/main.min.js

@@ -1,11 +1,11 @@
 /*!
-* react-shared-states v1.0.11
+* react-shared-states v1.0.12
 * (c) Hichem Taboukouyout
 * Released under the MIT License.
 * Github: github.com/HichemTab-tech/react-shared-states
 */
 
-(function(f,p){typeof exports=="object"&&typeof module<"u"?p(exports,require("react")):typeof define=="function"&&define.amd?define(["exports","react"],p):(f=typeof globalThis<"u"?globalThis:f||self,p(f.ReactSharedStates={},f.React))})(this,function(f,p){"use strict";var N={exports:{}},D={};/**
+(function(p,S){typeof exports=="object"&&typeof module<"u"?S(exports,require("react")):typeof define=="function"&&define.amd?define(["exports","react"],S):(p=typeof globalThis<"u"?globalThis:p||self,S(p.ReactSharedStates={},p.React))})(this,function(p,S){"use strict";function ce(i){return i&&i.__esModule&&Object.prototype.hasOwnProperty.call(i,"default")?i.default:i}var N={exports:{}},C={};/**
  * @license React
  * react-jsx-runtime.production.js
  *
@@ -13,7 +13,7 @@
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
- */var J;function ie(){if(J)return D;J=1;var i=Symbol.for("react.transitional.element"),e=Symbol.for("react.fragment");function r(t,s,c){var a=null;if(c!==void 0&&(a=""+c),s.key!==void 0&&(a=""+s.key),"key"in s){c={};for(var b in s)b!=="key"&&(c[b]=s[b])}else c=s;return s=c.ref,{$$typeof:i,type:t,key:a,ref:s!==void 0?s:null,props:c}}return D.Fragment=e,D.jsx=r,D.jsxs=r,D}var C={};/**
+ */var B;function ue(){if(B)return C;B=1;var i=Symbol.for("react.transitional.element"),e=Symbol.for("react.fragment");function r(t,o,a){var n=null;if(a!==void 0&&(n=""+a),o.key!==void 0&&(n=""+o.key),"key"in o){a={};for(var f in o)f!=="key"&&(a[f]=o[f])}else a=o;return o=a.ref,{$$typeof:i,type:t,key:n,ref:o!==void 0?o:null,props:a}}return C.Fragment=e,C.jsx=r,C.jsxs=r,C}var F={};/**
  * @license React
  * react-jsx-runtime.development.js
  *
@@ -21,9 +21,9 @@
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
- */var z;function oe(){return z||(z=1,process.env.NODE_ENV!=="production"&&function(){function i(n){if(n==null)return null;if(typeof n=="function")return n.$$typeof===De?null:n.displayName||n.name||null;if(typeof n=="string")return n;switch(n){case v:return"Fragment";case O:return"Profiler";case L:return"StrictMode";case Pe:return"Suspense";case Le:return"SuspenseList";case je:return"Activity"}if(typeof n=="object")switch(typeof n.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),n.$$typeof){case h:return"Portal";case we:return(n.displayName||"Context")+".Provider";case Ae:return(n._context.displayName||"Context")+".Consumer";case ye:var o=n.render;return n=n.displayName,n||(n=o.displayName||o.name||"",n=n!==""?"ForwardRef("+n+")":"ForwardRef"),n;case Oe:return o=n.displayName||null,o!==null?o:i(n.type)||"Memo";case $:o=n._payload,n=n._init;try{return i(n(o))}catch{}}return null}function e(n){return""+n}function r(n){try{e(n);var o=!1}catch{o=!0}if(o){o=console;var d=o.error,m=typeof Symbol=="function"&&Symbol.toStringTag&&n[Symbol.toStringTag]||n.constructor.name||"Object";return d.call(o,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",m),e(n)}}function t(n){if(n===v)return"<>";if(typeof n=="object"&&n!==null&&n.$$typeof===$)return"<...>";try{var o=i(n);return o?"<"+o+">":"<...>"}catch{return"<...>"}}function s(){var n=V.A;return n===null?null:n.getOwner()}function c(){return Error("react-stack-top-frame")}function a(n){if(ee.call(n,"key")){var o=Object.getOwnPropertyDescriptor(n,"key").get;if(o&&o.isReactWarning)return!1}return n.key!==void 0}function b(n,o){function d(){te||(te=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",o))}d.isReactWarning=!0,Object.defineProperty(n,"key",{get:d,configurable:!0})}function _(){var n=i(this.type);return re[n]||(re[n]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),n=this.props.ref,n!==void 0?n:null}function y(n,o,d,m,P,A,M,U){return d=A.ref,n={$$typeof:g,type:n,key:o,props:A,_owner:P},(d!==void 0?d:null)!==null?Object.defineProperty(n,"ref",{enumerable:!1,get:_}):Object.defineProperty(n,"ref",{enumerable:!1,value:null}),n._store={},Object.defineProperty(n._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(n,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(n,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:M}),Object.defineProperty(n,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:U}),Object.freeze&&(Object.freeze(n.props),Object.freeze(n)),n}function w(n,o,d,m,P,A,M,U){var E=o.children;if(E!==void 0)if(m)if(Ce(E)){for(m=0;m<E.length;m++)l(E[m]);Object.freeze&&Object.freeze(E)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else l(E);if(ee.call(o,"key")){E=i(n);var j=Object.keys(o).filter(function(ke){return ke!=="key"});m=0<j.length?"{key: someKey, "+j.join(": ..., ")+": ...}":"{key: someKey}",ae[E+m]||(j=0<j.length?"{"+j.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
+ */var J;function fe(){return J||(J=1,process.env.NODE_ENV!=="production"&&function(){function i(s){if(s==null)return null;if(typeof s=="function")return s.$$typeof===Me?null:s.displayName||s.name||null;if(typeof s=="string")return s;switch(s){case x:return"Fragment";case j:return"Profiler";case P:return"StrictMode";case Ne:return"Suspense";case ke:return"SuspenseList";case Ye:return"Activity"}if(typeof s=="object")switch(typeof s.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),s.$$typeof){case m:return"Portal";case Ce:return(s.displayName||"Context")+".Provider";case De:return(s._context.displayName||"Context")+".Consumer";case Fe:var u=s.render;return s=s.displayName,s||(s=u.displayName||u.name||"",s=s!==""?"ForwardRef("+s+")":"ForwardRef"),s;case Ve:return u=s.displayName||null,u!==null?u:i(s.type)||"Memo";case te:u=s._payload,s=s._init;try{return i(s(u))}catch{}}return null}function e(s){return""+s}function r(s){try{e(s);var u=!1}catch{u=!0}if(u){u=console;var g=u.error,R=typeof Symbol=="function"&&Symbol.toStringTag&&s[Symbol.toStringTag]||s.constructor.name||"Object";return g.call(u,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",R),e(s)}}function t(s){if(s===x)return"<>";if(typeof s=="object"&&s!==null&&s.$$typeof===te)return"<...>";try{var u=i(s);return u?"<"+u+">":"<...>"}catch{return"<...>"}}function o(){var s=I.A;return s===null?null:s.getOwner()}function a(){return Error("react-stack-top-frame")}function n(s){if(re.call(s,"key")){var u=Object.getOwnPropertyDescriptor(s,"key").get;if(u&&u.isReactWarning)return!1}return s.key!==void 0}function f(s,u){function g(){ne||(ne=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",u))}g.isReactWarning=!0,Object.defineProperty(s,"key",{get:g,configurable:!0})}function c(){var s=i(this.type);return se[s]||(se[s]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),s=this.props.ref,s!==void 0?s:null}function b(s,u,g,R,O,w,z,G){return g=w.ref,s={$$typeof:E,type:s,key:u,props:w,_owner:O},(g!==void 0?g:null)!==null?Object.defineProperty(s,"ref",{enumerable:!1,get:c}):Object.defineProperty(s,"ref",{enumerable:!1,value:null}),s._store={},Object.defineProperty(s._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(s,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(s,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:z}),Object.defineProperty(s,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:G}),Object.freeze&&(Object.freeze(s.props),Object.freeze(s)),s}function h(s,u,g,R,O,w,z,G){var y=u.children;if(y!==void 0)if(R)if(Ie(y)){for(R=0;R<y.length;R++)l(y[R]);Object.freeze&&Object.freeze(y)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else l(y);if(re.call(u,"key")){y=i(s);var D=Object.keys(u).filter(function(We){return We!=="key"});R=0<D.length?"{key: someKey, "+D.join(": ..., ")+": ...}":"{key: someKey}",ie[y+R]||(D=0<D.length?"{"+D.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
   let props = %s;
   <%s {...props} />
 React keys must be passed directly to JSX without using spread:
   let props = %s;
-  <%s key={someKey} {...props} />`,m,E,j,E),ae[E+m]=!0)}if(E=null,d!==void 0&&(r(d),E=""+d),a(o)&&(r(o.key),E=""+o.key),"key"in o){d={};for(var G in o)G!=="key"&&(d[G]=o[G])}else d=o;return E&&b(d,typeof n=="function"?n.displayName||n.name||"Unknown":n),y(n,E,A,P,s(),d,M,U)}function l(n){typeof n=="object"&&n!==null&&n.$$typeof===g&&n._store&&(n._store.validated=1)}var x=p,g=Symbol.for("react.transitional.element"),h=Symbol.for("react.portal"),v=Symbol.for("react.fragment"),L=Symbol.for("react.strict_mode"),O=Symbol.for("react.profiler"),Ae=Symbol.for("react.consumer"),we=Symbol.for("react.context"),ye=Symbol.for("react.forward_ref"),Pe=Symbol.for("react.suspense"),Le=Symbol.for("react.suspense_list"),Oe=Symbol.for("react.memo"),$=Symbol.for("react.lazy"),je=Symbol.for("react.activity"),De=Symbol.for("react.client.reference"),V=x.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,ee=Object.prototype.hasOwnProperty,Ce=Array.isArray,W=console.createTask?console.createTask:function(){return null};x={react_stack_bottom_frame:function(n){return n()}};var te,re={},ne=x.react_stack_bottom_frame.bind(x,c)(),se=W(t(c)),ae={};C.Fragment=v,C.jsx=function(n,o,d,m,P){var A=1e4>V.recentlyCreatedOwnerStacks++;return w(n,o,d,!1,m,P,A?Error("react-stack-top-frame"):ne,A?W(t(n)):se)},C.jsxs=function(n,o,d,m,P){var A=1e4>V.recentlyCreatedOwnerStacks++;return w(n,o,d,!0,m,P,A?Error("react-stack-top-frame"):ne,A?W(t(n)):se)}}()),C}var X;function ce(){return X||(X=1,process.env.NODE_ENV==="production"?N.exports=ie():N.exports=oe()),N.exports}var ue=ce();f.isDevMode=!1;const le=i=>{f.isDevMode=i},F=(...i)=>{f.isDevMode&&console.log("%c[react-shared-states]","color: #007acc; font-weight: bold",...i)},k=i=>{if(!i)throw new Error("Value is empty");return i},B=()=>Math.random().toString(36).substring(2,15),H=p.createContext(void 0),fe=({children:i,scopeName:e})=>{if(e&&e.includes("//"))throw new Error("scopeName cannot contain '//'");return e||(e=p.useMemo(()=>B(),[])),ue.jsx(H.Provider,{value:{scopeName:e},children:i})},de=()=>p.useContext(H),Z=[];class u{data=new Map;defaultValue(){return{}}addListener(e,r,t){this.data.has(u.prefix(e,r))||this.data.set(u.prefix(e,r),{...this.defaultValue(),listeners:[]}),this.data.get(u.prefix(e,r)).listeners.push(t)}removeListener(e,r,t){this.data.has(u.prefix(e,r))&&(this.data.get(u.prefix(e,r)).listeners=this.data.get(u.prefix(e,r)).listeners.filter(s=>s!==t))}callListeners(e,r){this.data.has(u.prefix(e,r))&&this.data.get(u.prefix(e,r)).listeners.forEach(t=>t())}init(e,r,t,s=!1){this.data.has(u.prefix(e,r))||this.data.set(u.prefix(e,r),{...t,isStatic:s,listeners:[]})}createStatic(e,r){const t=r??r??"_global",s={key:B(),prefix:t,...e};return Z.push(s),this.initStatic(s),s}initStatic(e){const{key:r,prefix:t}=e;this.init(r,t,this.defaultValue(),!0)}clearAll(e=!1,r=!1){this.data.forEach((t,s)=>{const[c,a]=u.extractPrefix(s);this.clear(a,c,e,r)})}clear(e,r,t=!1,s=!1){t||this.callListeners(e,r);const c=this.data.get(u.prefix(e,r));if(!c)return;const a={...c};if(this.data.delete(u.prefix(e,r)),a.isStatic&&!s){const b=Z.find(_=>_.key===e&&_.prefix===r);b&&this.initStatic(b)}}get(e,r){let t=this.has(e,r);if(t)return this.data.get(t)}setValue(e,r,t){this.data.has(u.prefix(e,r))&&this.data.set(u.prefix(e,r),{...this.data.get(u.prefix(e,r)),...t})}has(e,r){return this.data.has(u.prefix(e,r))?u.prefix(e,r):this.data.has(u.prefix(e,"_global"))?u.prefix(e,"_global"):void 0}static prefix(e,r){if(e.includes("//"))throw new Error("key cannot contain '//'");return`${r}//${e}`}static extractPrefix(e){return e.split("//")}useEffect(e,r,t=null){p.useEffect(()=>()=>{t?.(),F(`[${u.prefix(e,r)}]`,"unmount effect"),this.data.get(u.prefix(e,r)).listeners?.length===0&&this.clear(e,r)},[])}}class Y{constructor(e){this.sharedData=e}get(e,r){let t,s=r;if(typeof e!="string"){const{key:b,prefix:_}=e;t=b,s=_}else t=k(e);const c=s||"_global";return this.sharedData.get(t,c)}set(e,r,t){let s,c=t;if(typeof e!="string"){const{key:b,prefix:_}=e;s=b,c=_}else s=k(e);const a=c||"_global";this.sharedData.setValue(s,a,r)}clearAll(){this.sharedData.clearAll()}clearScope(e){const r=e||"_global";this.sharedData.data.forEach((t,s)=>{const[c,a]=u.extractPrefix(s);if(c===r){this.sharedData.clear(a,c);return}})}resolve(e){const{key:r,prefix:t}=e;return this.get(r,t)}clear(e,r){let t,s;typeof e=="string"?(t=e,s=r||"_global"):(t=e.key,s=e.prefix),this.sharedData.clear(t,s)}has(e,r="_global"){const t=r||"_global";return!!this.sharedData.has(e,t)}getAll(){const e={};return this.sharedData.data.forEach((r,t)=>{const[s,c]=u.extractPrefix(t);e[s]=e[s]||{},e[s][c]=r}),e}}const I=i=>{const e=de();return{prefix:i??e?.scopeName??"_global"}};class Se extends u{defaultValue(){return{value:void 0}}initValue(e,r,t,s=!1){super.init(e,r,{value:t},s)}initStatic(e){const{key:r,prefix:t,initialValue:s}=e;this.initValue(r,t,s,!0)}}class Q extends Y{constructor(e){super(e)}get(e,r="_global"){return typeof e!="string"?super.get(e)?.value:super.get(e,r)?.value}set(e,r,t="_global"){if(typeof e!="string"){super.set(e,{value:r});return}super.set(e,{value:r},t)}}const T=new Se,pe=new Q(T),he=(i,e)=>T.createStatic({initialValue:i},e);function be(i,e,r){let t,s,c=r;if(typeof i!="string"){const{key:l,initialValue:x,prefix:g}=i;t=l,s=x,c=g}else t=k(i),s=e;const{prefix:a}=I(c);T.initValue(t,a,s);const b=p.useMemo(()=>l=>(T.initValue(t,a,e),T.addListener(t,a,l),()=>{T.removeListener(t,a,l)}),[]),_=p.useMemo(()=>()=>T.get(t,a)?.value,[]),y=p.useSyncExternalStore(b,_),w=l=>{const x=typeof l=="function"?l(T.get(t,a)?.value):l;x!==y&&(T.setValue(t,a,{value:x}),T.callListeners(t,a))};return T.useEffect(t,a),[y,w]}class ge extends u{defaultValue(){return{fnState:{results:void 0,isLoading:!1,error:void 0}}}initValue(e,r,t=!1){super.init(e,r,this.defaultValue(),t)}setValue(e,r,t){super.setValue(e,r,t)}}class K extends Y{constructor(e){super(e)}get(e,r="_global"){return typeof e!="string"?super.get(e)?.fnState:super.get(e,r)?.fnState}set(e,r,t="_global"){if(typeof e!="string"){super.set(e,r);return}super.set(e,r,t)}}const R=new ge,ve=new K(R),me=(i,e)=>R.createStatic({fn:i},e);function Ee(i,e,r){let t,s,c=r;if(typeof i!="string"){const{key:l,fn:x,prefix:g}=i;t=l,s=x,c=g}else t=k(i),s=e;const{prefix:a}=I(c);R.initValue(t,a);const b=p.useMemo(()=>l=>(R.initValue(t,a),R.addListener(t,a,l),()=>{R.removeListener(t,a,l)}),[]),_=p.useMemo(()=>()=>R.get(t,a).fnState,[]),y=p.useSyncExternalStore(b,_),w=async(l,...x)=>{const g=R.get(t,a);if(!l&&(g.fnState.isLoading||g.fnState.results!==void 0))return g.fnState;g.fnState={...g.fnState,isLoading:!0,error:void 0},R.callListeners(t,a);try{const h=await s(...x);g.fnState={results:h,isLoading:!1,error:void 0}}catch(h){g.fnState={...g.fnState,isLoading:!1,error:h}}R.callListeners(t,a)};return R.useEffect(t,a),{state:y,trigger:(...l)=>{w(!1,...l)},forceTrigger:(...l)=>{w(!0,...l)},clear:()=>{const l=R.get(t,a);l&&(l.fnState=R.defaultValue().fnState,R.callListeners(t,a))}}}class xe extends u{defaultValue(){return{fnState:{data:void 0,isLoading:!1,error:void 0,subscribed:!1}}}initValue(e,r,t=!1){super.init(e,r,this.defaultValue(),t)}setValue(e,r,t){super.setValue(e,r,t)}useEffect(e,r){p.useEffect(()=>()=>{F(`[${u.prefix(e,r)}]`,"unmount effect2"),this.get(e,r)?.listeners.length===0&&this.unsubscribe(e,r)},[]),super.useEffect(e,r)}async unsubscribe(e,r){const t=this.get(e,r);t&&(t.unsubscribe&&(t.unsubscribe(),t.unsubscribe=void 0),t.fnState={...t.fnState,subscribed:!1},this.callListeners(e,r))}}class q extends Y{constructor(e){super(e)}get(e,r="_global"){return typeof e!="string"?super.get(e)?.fnState:super.get(e,r)?.fnState}set(e,r,t="_global"){if(typeof e!="string"){super.set(e,r);return}super.set(e,r,t)}}const S=new xe,Re=new q(S),_e=(i,e)=>S.createStatic({subscriber:i},e);function Te(i,e,r){let t,s,c=r;if(typeof i!="string"){const{key:h,subscriber:v,prefix:L}=i;t=h,s=v,c=L}else t=k(i),s=e;const{prefix:a}=I(c);S.initValue(t,a);const b=p.useMemo(()=>h=>(S.initValue(t,a),S.addListener(t,a,h),()=>{S.removeListener(t,a,h)}),[]),_=p.useMemo(()=>()=>S.get(t,a).fnState,[]),y=p.useSyncExternalStore(b,_),w=h=>{const v=S.get(t,a);v.fnState={...v.fnState,data:h},S.callListeners(t,a)},l=h=>{const v=S.get(t,a);v.fnState={...v.fnState,isLoading:!1,data:void 0,error:h},S.callListeners(t,a)},x=()=>{const h=S.get(t,a);h.fnState={...h.fnState,isLoading:!1},S.callListeners(t,a)},g=async h=>{const v=S.get(t,a);if(h&&(await S.unsubscribe(t,a),v.fnState={...v.fnState,isLoading:!1,data:void 0,error:void 0,subscribed:!1}),v.fnState.subscribed)return v.fnState;F("triggered !!"),v.fnState={...v.fnState,isLoading:!0,error:void 0},S.callListeners(t,a);try{const L=await s(w,l,x),O=S.get(t,a);O.unsubscribe=L,O.fnState.subscribed=!0}catch(L){const O=S.get(t,a);O.fnState={...O.fnState,isLoading:!1,error:L}}S.callListeners(t,a)};return S.useEffect(t,a),{state:y,trigger:()=>{g(!1)},forceTrigger:()=>{g(!0)},unsubscribe:()=>{S.unsubscribe(t,a)}}}f.SharedFunctionsApi=K,f.SharedStatesApi=Q,f.SharedStatesProvider=fe,f.SharedSubscriptionsApi=q,f.createSharedFunction=me,f.createSharedState=he,f.createSharedSubscription=_e,f.setDevMode=le,f.sharedFunctionsApi=ve,f.sharedStatesApi=pe,f.sharedSubscriptionsApi=Re,f.useSharedFunction=Ee,f.useSharedState=be,f.useSharedSubscription=Te,Object.defineProperty(f,Symbol.toStringTag,{value:"Module"})});
+  <%s key={someKey} {...props} />`,R,y,D,y),ie[y+R]=!0)}if(y=null,g!==void 0&&(r(g),y=""+g),n(u)&&(r(u.key),y=""+u.key),"key"in u){g={};for(var U in u)U!=="key"&&(g[U]=u[U])}else g=u;return y&&f(g,typeof s=="function"?s.displayName||s.name||"Unknown":s),b(s,y,w,O,o(),g,z,G)}function l(s){typeof s=="object"&&s!==null&&s.$$typeof===E&&s._store&&(s._store.validated=1)}var A=S,E=Symbol.for("react.transitional.element"),m=Symbol.for("react.portal"),x=Symbol.for("react.fragment"),P=Symbol.for("react.strict_mode"),j=Symbol.for("react.profiler"),De=Symbol.for("react.consumer"),Ce=Symbol.for("react.context"),Fe=Symbol.for("react.forward_ref"),Ne=Symbol.for("react.suspense"),ke=Symbol.for("react.suspense_list"),Ve=Symbol.for("react.memo"),te=Symbol.for("react.lazy"),Ye=Symbol.for("react.activity"),Me=Symbol.for("react.client.reference"),I=A.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,re=Object.prototype.hasOwnProperty,Ie=Array.isArray,W=console.createTask?console.createTask:function(){return null};A={react_stack_bottom_frame:function(s){return s()}};var ne,se={},ae=A.react_stack_bottom_frame.bind(A,a)(),oe=W(t(a)),ie={};F.Fragment=x,F.jsx=function(s,u,g,R,O){var w=1e4>I.recentlyCreatedOwnerStacks++;return h(s,u,g,!1,R,O,w?Error("react-stack-top-frame"):ae,w?W(t(s)):oe)},F.jsxs=function(s,u,g,R,O){var w=1e4>I.recentlyCreatedOwnerStacks++;return h(s,u,g,!0,R,O,w?Error("react-stack-top-frame"):ae,w?W(t(s)):oe)}}()),F}var X;function le(){return X||(X=1,process.env.NODE_ENV==="production"?N.exports=ue():N.exports=fe()),N.exports}var de=le();p.isDevMode=!1;const pe=i=>{p.isDevMode=i},V=(...i)=>{p.isDevMode&&console.log("%c[react-shared-states]","color: #007acc; font-weight: bold",...i)},L=i=>{if(!i)throw new Error("Value is empty");return i},H=()=>Math.random().toString(36).substring(2,15),Z=S.createContext(void 0),Se=({children:i,scopeName:e})=>{if(e&&e.includes("//"))throw new Error("scopeName cannot contain '//'");return e||(e=S.useMemo(()=>H(),[])),de.jsx(Z.Provider,{value:{scopeName:e},children:i})},he=()=>S.useContext(Z),Q=[];class d{data=new Map;defaultValue(){return{}}addListener(e,r,t){this.data.has(d.prefix(e,r))||this.data.set(d.prefix(e,r),{...this.defaultValue(),listeners:[]}),this.data.get(d.prefix(e,r)).listeners.push(t)}removeListener(e,r,t){this.data.has(d.prefix(e,r))&&(this.data.get(d.prefix(e,r)).listeners=this.data.get(d.prefix(e,r)).listeners.filter(o=>o!==t))}callListeners(e,r){this.data.has(d.prefix(e,r))&&this.data.get(d.prefix(e,r)).listeners.forEach(t=>t())}init(e,r,t,o=!1){this.data.has(d.prefix(e,r))||this.data.set(d.prefix(e,r),{...t,isStatic:o,listeners:[]})}createStatic(e,r){const t=r??r??"_global",o={key:H(),prefix:t,...e};return Q.push(o),this.initStatic(o),o}initStatic(e){const{key:r,prefix:t}=e;this.init(r,t,this.defaultValue(),!0)}clearAll(e=!1,r=!1){this.data.forEach((t,o)=>{const[a,n]=d.extractPrefix(o);this.clear(n,a,e,r)})}clear(e,r,t=!1,o=!1){t||this.callListeners(e,r);const a=this.data.get(d.prefix(e,r));if(!a)return;const n={...a};if(this.data.delete(d.prefix(e,r)),n.isStatic&&!o){const f=Q.find(c=>c.key===e&&c.prefix===r);f&&this.initStatic(f)}}get(e,r){let t=this.has(e,r);if(t)return this.data.get(t)}setValue(e,r,t){this.data.has(d.prefix(e,r))&&this.data.set(d.prefix(e,r),{...this.data.get(d.prefix(e,r)),...t})}has(e,r){return this.data.has(d.prefix(e,r))?d.prefix(e,r):this.data.has(d.prefix(e,"_global"))?d.prefix(e,"_global"):void 0}static prefix(e,r){if(e.includes("//"))throw new Error("key cannot contain '//'");return`${r}//${e}`}static extractPrefix(e){return e.split("//")}useEffect(e,r,t=null){S.useEffect(()=>()=>{t?.(),V(`[${d.prefix(e,r)}]`,"unmount effect"),this.data.get(d.prefix(e,r)).listeners?.length===0&&this.clear(e,r)},[])}}class Y{constructor(e){this.sharedData=e}get(e,r){let t,o=r;if(typeof e!="string"){const{key:f,prefix:c}=e;t=f,o=c}else t=L(e);const a=o||"_global";return this.sharedData.get(t,a)}set(e,r,t){let o,a=t;if(typeof e!="string"){const{key:f,prefix:c}=e;o=f,a=c}else o=L(e);const n=a||"_global";this.sharedData.init(o,n,r),this.sharedData.setValue(o,n,r),this.sharedData.callListeners(o,n)}clearAll(){this.sharedData.clearAll()}clearScope(e){const r=e||"_global";this.sharedData.data.forEach((t,o)=>{const[a,n]=d.extractPrefix(o);if(a===r){this.sharedData.clear(n,a),this.sharedData.callListeners(n,a);return}})}resolve(e){const{key:r,prefix:t}=e;return this.get(r,t)}clear(e,r){let t,o;typeof e=="string"?(t=e,o=r||"_global"):(t=e.key,o=e.prefix),this.sharedData.clear(t,o)}has(e,r="_global"){const t=r||"_global";return!!this.sharedData.has(e,t)}getAll(){const e={};return this.sharedData.data.forEach((r,t)=>{const[o,a]=d.extractPrefix(t);e[o]=e[o]||{},e[o][a]=r}),e}}const k=i=>{const e=he();return{prefix:i??e?.scopeName??"_global"}};var M,K;function ge(){if(K)return M;K=1;var i=typeof Element<"u",e=typeof Map=="function",r=typeof Set=="function",t=typeof ArrayBuffer=="function"&&!!ArrayBuffer.isView;function o(a,n){if(a===n)return!0;if(a&&n&&typeof a=="object"&&typeof n=="object"){if(a.constructor!==n.constructor)return!1;var f,c,b;if(Array.isArray(a)){if(f=a.length,f!=n.length)return!1;for(c=f;c--!==0;)if(!o(a[c],n[c]))return!1;return!0}var h;if(e&&a instanceof Map&&n instanceof Map){if(a.size!==n.size)return!1;for(h=a.entries();!(c=h.next()).done;)if(!n.has(c.value[0]))return!1;for(h=a.entries();!(c=h.next()).done;)if(!o(c.value[1],n.get(c.value[0])))return!1;return!0}if(r&&a instanceof Set&&n instanceof Set){if(a.size!==n.size)return!1;for(h=a.entries();!(c=h.next()).done;)if(!n.has(c.value[0]))return!1;return!0}if(t&&ArrayBuffer.isView(a)&&ArrayBuffer.isView(n)){if(f=a.length,f!=n.length)return!1;for(c=f;c--!==0;)if(a[c]!==n[c])return!1;return!0}if(a.constructor===RegExp)return a.source===n.source&&a.flags===n.flags;if(a.valueOf!==Object.prototype.valueOf&&typeof a.valueOf=="function"&&typeof n.valueOf=="function")return a.valueOf()===n.valueOf();if(a.toString!==Object.prototype.toString&&typeof a.toString=="function"&&typeof n.toString=="function")return a.toString()===n.toString();if(b=Object.keys(a),f=b.length,f!==Object.keys(n).length)return!1;for(c=f;c--!==0;)if(!Object.prototype.hasOwnProperty.call(n,b[c]))return!1;if(i&&a instanceof Element)return!1;for(c=f;c--!==0;)if(!((b[c]==="_owner"||b[c]==="__v"||b[c]==="__o")&&a.$$typeof)&&!o(a[b[c]],n[b[c]]))return!1;return!0}return a!==a&&n!==n}return M=function(n,f){try{return o(n,f)}catch(c){if((c.message||"").match(/stack|recursion/i))return console.warn("react-fast-compare cannot handle circular refs"),!1;throw c}},M}var ve=ge();const be=ce(ve);class me extends d{defaultValue(){return{value:void 0}}initValue(e,r,t,o=!1){super.init(e,r,{value:t},o)}initStatic(e){const{key:r,prefix:t,initialValue:o}=e;this.initValue(r,t,o,!0)}}class q extends Y{constructor(e){super(e)}get(e,r="_global"){return typeof e!="string"?super.get(e)?.value:super.get(e,r)?.value}set(e,r,t="_global"){if(typeof e!="string"){super.set(e,{value:r});return}super.set(e,{value:r},t)}}const _=new me,Ee=new q(_),xe=(i,e)=>_.createStatic({initialValue:i},e);function Re(i,e,r){let t,o,a=r;if(typeof i!="string"){const{key:l,initialValue:A,prefix:E}=i;t=l,o=A,a=E}else t=L(i),o=e;const{prefix:n}=k(a);_.initValue(t,n,o);const f=S.useMemo(()=>l=>(_.initValue(t,n,e),_.addListener(t,n,l),()=>{_.removeListener(t,n,l)}),[]),c=S.useMemo(()=>()=>_.get(t,n)?.value,[]),b=S.useSyncExternalStore(f,c),h=l=>{const A=typeof l=="function"?l(_.get(t,n)?.value):l;A!==b&&(_.setValue(t,n,{value:A}),_.callListeners(t,n))};return _.useEffect(t,n),[b,h]}function ye(i,e,r){let t,o=r;if(typeof i!="string"){const{key:h,prefix:l}=i;t=h,o=l}else t=L(i);const{prefix:a}=k(o),n=S.useRef(void 0),f=S.useMemo(()=>h=>(_.addListener(t,a,h),()=>{_.removeListener(t,a,h)}),[]),c=S.useMemo(()=>()=>{const h=_.get(t,a)?.value,l=e(h);return be(n.current,l)?n.current:l},[]),b=S.useSyncExternalStore(f,c);return _.useEffect(t,a),b}class _e extends d{defaultValue(){return{fnState:{results:void 0,isLoading:!1,error:void 0}}}initValue(e,r,t=!1){super.init(e,r,this.defaultValue(),t)}setValue(e,r,t){super.setValue(e,r,t)}}class $ extends Y{constructor(e){super(e)}get(e,r="_global"){return typeof e!="string"?super.get(e)?.fnState:super.get(e,r)?.fnState}set(e,r,t="_global"){if(typeof e!="string"){super.set(e,r);return}super.set(e,r,t)}}const T=new _e,Ae=new $(T),Te=(i,e)=>T.createStatic({fn:i},e);function we(i,e,r){let t,o,a=r;if(typeof i!="string"){const{key:l,fn:A,prefix:E}=i;t=l,o=A,a=E}else t=L(i),o=e;const{prefix:n}=k(a);T.initValue(t,n);const f=S.useMemo(()=>l=>(T.initValue(t,n),T.addListener(t,n,l),()=>{T.removeListener(t,n,l)}),[]),c=S.useMemo(()=>()=>T.get(t,n).fnState,[]),b=S.useSyncExternalStore(f,c),h=async(l,...A)=>{const E=T.get(t,n);if(!l&&(E.fnState.isLoading||E.fnState.results!==void 0))return E.fnState;E.fnState={...E.fnState,isLoading:!0,error:void 0},T.callListeners(t,n);try{const m=await o(...A);E.fnState={results:m,isLoading:!1,error:void 0}}catch(m){E.fnState={...E.fnState,isLoading:!1,error:m}}T.callListeners(t,n)};return T.useEffect(t,n),{state:b,trigger:(...l)=>{h(!1,...l)},forceTrigger:(...l)=>{h(!0,...l)},clear:()=>{const l=T.get(t,n);l&&(l.fnState=T.defaultValue().fnState,T.callListeners(t,n))}}}class Oe extends d{defaultValue(){return{fnState:{data:void 0,isLoading:!1,error:void 0,subscribed:!1}}}initValue(e,r,t=!1){super.init(e,r,this.defaultValue(),t)}setValue(e,r,t){super.setValue(e,r,t)}useEffect(e,r){S.useEffect(()=>()=>{V(`[${d.prefix(e,r)}]`,"unmount effect2"),this.get(e,r)?.listeners.length===0&&this.unsubscribe(e,r)},[]),super.useEffect(e,r)}async unsubscribe(e,r){const t=this.get(e,r);t&&(t.unsubscribe&&(t.unsubscribe(),t.unsubscribe=void 0),t.fnState={...t.fnState,subscribed:!1},this.callListeners(e,r))}}class ee extends Y{constructor(e){super(e)}get(e,r="_global"){return typeof e!="string"?super.get(e)?.fnState:super.get(e,r)?.fnState}set(e,r,t="_global"){if(typeof e!="string"){super.set(e,r);return}super.set(e,r,t)}}const v=new Oe,Pe=new ee(v),je=(i,e)=>v.createStatic({subscriber:i},e);function Le(i,e,r){let t,o,a=r;if(typeof i!="string"){const{key:m,subscriber:x,prefix:P}=i;t=m,o=x,a=P}else t=L(i),o=e;const{prefix:n}=k(a);v.initValue(t,n);const f=S.useMemo(()=>m=>(v.initValue(t,n),v.addListener(t,n,m),()=>{v.removeListener(t,n,m)}),[]),c=S.useMemo(()=>()=>v.get(t,n).fnState,[]),b=S.useSyncExternalStore(f,c),h=m=>{const x=v.get(t,n);x.fnState={...x.fnState,data:m},v.callListeners(t,n)},l=m=>{const x=v.get(t,n);x.fnState={...x.fnState,isLoading:!1,data:void 0,error:m},v.callListeners(t,n)},A=()=>{const m=v.get(t,n);m.fnState={...m.fnState,isLoading:!1},v.callListeners(t,n)},E=async m=>{const x=v.get(t,n);if(m&&(await v.unsubscribe(t,n),x.fnState={...x.fnState,isLoading:!1,data:void 0,error:void 0,subscribed:!1}),x.fnState.subscribed)return x.fnState;V("triggered !!"),x.fnState={...x.fnState,isLoading:!0,error:void 0},v.callListeners(t,n);try{const P=await o(h,l,A),j=v.get(t,n);j.unsubscribe=P,j.fnState.subscribed=!0}catch(P){const j=v.get(t,n);j.fnState={...j.fnState,isLoading:!1,error:P}}v.callListeners(t,n)};return v.useEffect(t,n),{state:b,trigger:()=>{E(!1)},forceTrigger:()=>{E(!0)},unsubscribe:()=>{v.unsubscribe(t,n)}}}p.SharedFunctionsApi=$,p.SharedStatesApi=q,p.SharedStatesProvider=Se,p.SharedSubscriptionsApi=ee,p.createSharedFunction=Te,p.createSharedState=xe,p.createSharedSubscription=je,p.setDevMode=pe,p.sharedFunctionsApi=Ae,p.sharedStatesApi=Ee,p.sharedSubscriptionsApi=Pe,p.useSharedFunction=we,p.useSharedState=Re,p.useSharedStateSelector=ye,p.useSharedSubscription=Le,Object.defineProperty(p,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-shared-states",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "type": "module",
   "description": "Global state made as simple as useState, with zero config, built-in async caching, and automatic scoping.",
   "keywords": [
@@ -24,6 +24,10 @@
   "bugs": {
     "url": "https://github.com/HichemTab-tech/react-shared-states/issues"
   },
+  "peerDependencies": {
+    "react": "^19.1.11",
+    "react-dom": "^19.1.11"
+  },
   "homepage": "https://github.com/HichemTab-tech/react-shared-states#readme",
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",
@@ -36,11 +40,14 @@
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
     "typescript": "^5.9.2",
-    "vite": "^7.1.3",
+    "vite": "7.1.5",
     "vite-plugin-banner": "^0.8.1",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^3.2.4"
   },
+  "dependencies": {
+    "react-fast-compare": "^3.2.2"
+  },
   "scripts": {
     "tsc": "tsc",
     "bump": "node scripts/bumper.js",

package/tests/index.test.tsx

@@ -11,6 +11,7 @@ import {
     sharedSubscriptionsApi,
     useSharedFunction,
     useSharedState,
+    useSharedStateSelector,
     useSharedSubscription
 } from "../src";
 import type {Subscriber, SubscriberEvents} from "../src/hooks/use-shared-subscription";
@@ -524,3 +525,138 @@ describe('useSharedSubscription', () => {
         expect(clearedState.error).toBeUndefined();
     });
 });
+
+describe('useSharedStateSelector', () => {
+    const initialState = {a: 1, b: 2, nested: {c: 'hello'}};
+    const sharedObjectState = createSharedState(initialState);
+
+    it('should select a slice of state and only re-render when that slice changes', () => {
+        const renderSpyA = vi.fn();
+        const renderSpyB = vi.fn();
+
+        const ComponentA = () => {
+            const a = useSharedStateSelector(sharedObjectState, state => state.a);
+            renderSpyA();
+            return <span data-testid="a-value">{a}</span>;
+        };
+
+        const ComponentB = () => {
+            const b = useSharedStateSelector(sharedObjectState, state => state.b);
+            renderSpyB();
+            return <span data-testid="b-value">{b}</span>;
+        };
+
+        const Controller = () => {
+            const [state, setState] = useSharedState(sharedObjectState);
+            return (
+                <div>
+                    <button onClick={() => setState(s => ({...s, a: s.a + 1}))}>inc a</button>
+                    <button onClick={() => setState(s => ({...s, b: s.b + 1}))}>inc b</button>
+                    <span data-testid="full-state">{JSON.stringify(state)}</span>
+                </div>
+            );
+        };
+
+        render(
+            <>
+                <ComponentA/>
+                <ComponentB/>
+                <Controller/>
+            </>
+        );
+
+        // Initial render
+        expect(screen.getByTestId('a-value').textContent).toBe('1');
+        expect(screen.getByTestId('b-value').textContent).toBe('2');
+        expect(renderSpyA).toHaveBeenCalledTimes(1);
+        expect(renderSpyB).toHaveBeenCalledTimes(1);
+
+        // Update 'b', only ComponentB should re-render
+        act(() => {
+            fireEvent.click(screen.getByText('inc b'));
+        });
+
+        expect(screen.getByTestId('a-value').textContent).toBe('1');
+        expect(screen.getByTestId('b-value').textContent).toBe('3');
+        expect(renderSpyA).toHaveBeenCalledTimes(1); // Should not re-render
+        expect(renderSpyB).toHaveBeenCalledTimes(2); // Should re-render
+
+        // Update 'a', only ComponentA should re-render
+        act(() => {
+            fireEvent.click(screen.getByText('inc a'));
+        });
+
+        expect(screen.getByTestId('a-value').textContent).toBe('2');
+        expect(screen.getByTestId('b-value').textContent).toBe('3');
+        expect(renderSpyA).toHaveBeenCalledTimes(2); // Should re-render
+        expect(renderSpyB).toHaveBeenCalledTimes(2); // Should not re-render
+    });
+
+    it('should work with string keys', () => {
+        const renderSpy = vi.fn();
+        const key = 'string-key-state';
+        sharedStatesApi.set(key, {val: 100});
+
+        const SelectorComponent = () => {
+            const val = useSharedStateSelector<{ val: number }, typeof key, number>(key, state => state.val);
+            renderSpy();
+            return <span data-testid="val">{val}</span>;
+        };
+
+        render(<SelectorComponent/>);
+        expect(screen.getByTestId('val').textContent).toBe('100');
+        expect(renderSpy).toHaveBeenCalledTimes(1);
+
+        // Update state
+        act(() => {
+            sharedStatesApi.set(key, {val: 200});
+        });
+
+        expect(screen.getByTestId('val').textContent).toBe('200');
+        expect(renderSpy).toHaveBeenCalledTimes(2);
+    });
+
+    it('should perform deep comparison correctly', () => {
+        const renderSpy = vi.fn();
+        const nestedState = createSharedState({ a: 1, nested: { c: 'initial' } });
+
+        const NestedSelector = () => {
+            const nested = useSharedStateSelector(nestedState, state => state.nested);
+            renderSpy();
+            return <span data-testid="nested-c">{nested.c}</span>;
+        };
+
+        const Controller = () => {
+            const [, setState] = useSharedState(nestedState);
+            return (
+                <div>
+                    <button onClick={() => setState(s => ({ ...s, a: s.a + 1 }))}>update outer</button>
+                    <button onClick={() => setState(s => ({ ...s, nested: { c: 'updated' } }))}>update inner</button>
+                </div>
+            );
+        };
+
+        render(
+            <>
+                <NestedSelector />
+                <Controller />
+            </>
+        );
+
+        expect(screen.getByTestId('nested-c').textContent).toBe('initial');
+        expect(renderSpy).toHaveBeenCalledTimes(1);
+
+        // Update outer property, should not re-render because the selected object is deep-equal
+        act(() => {
+            fireEvent.click(screen.getByText('update outer'));
+        });
+        expect(renderSpy).toHaveBeenCalledTimes(1);
+
+        // Update inner property, should re-render
+        act(() => {
+            fireEvent.click(screen.getByText('update inner'));
+        });
+        expect(screen.getByTestId('nested-c').textContent).toBe('updated');
+        expect(renderSpy).toHaveBeenCalledTimes(2);
+    });
+});

package/pnpm-workspace.yaml

@@ -1,2 +0,0 @@
-onlyBuiltDependencies:
-  - esbuild