@hanzogui/use-store 7.0.0 → 7.3.0

package/LICENSE

@@ -1,21 +1,42 @@
-MIT License
+BSD 3-Clause License
+
+Copyright (c) 2026-present, Hanzo AI, Inc.
+
+Portions of this software are derived from upstream code originally licensed under
+the MIT License, with the following copyright notices retained per its terms:
 
   Copyright (c) 2020 Nate Wienert
-  
-  Permission is hereby granted, free of charge, to any person obtaining a copy
-  of this software and associated documentation files (the "Software"), to deal
-  in the Software without restriction, including without limitation the rights
-  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-  copies of the Software, and to permit persons to whom the Software is
-  furnished to do so, subject to the following conditions:
-  
-  The above copyright notice and this permission notice shall be included in all
-  copies or substantial portions of the Software.
-  
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-  SOFTWARE.
+  Copyright (c) 2015-present, Nicolas Gallagher.
+  Copyright (c) 2015-present, Facebook, Inc.
+  Copyright (c) 2021 Radix
+  Copyright (c) 2017 Carmelo Pullara
+  Copyright (c) 2018 Framer B.V.
+  Copyright (c) 2022 WorkOS
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

package/dist/cjs/useStore.cjs

@@ -58,8 +58,7 @@ var import_helpers = require("./helpers.cjs");
 var import_useStoreDebug = require("./useStoreDebug.cjs");
 const idFn = _ => _;
 function useStore(StoreKlass, props, options = import_constants.defaultOptions) {
-  const info = getOrCreateStoreInfo(StoreKlass, props, options);
-  return useStoreFromInfo(info, options.selector, options);
+  return useStoreFromInfo(getOrCreateStoreInfo(StoreKlass, props, options), options.selector, options);
 }
 function useStoreDebug(StoreKlass, props) {
   return useStore(StoreKlass, props, {
@@ -73,9 +72,7 @@ function useGlobalStore(instance, debug) {
   const store = instance[import_constants.UNWRAP_PROXY];
   const uid = (0, import_helpers.getStoreUid)(store.constructor, store.props);
   const info = import_helpers.cache.get(uid);
-  if (!info) {
-    throw new Error(`This store not created using createStore()`);
-  }
+  if (!info) throw new Error(`This store not created using createStore()`);
   return useStoreFromInfo(info, void 0, {
     debug
   });
@@ -84,9 +81,7 @@ function useGlobalStoreSelector(instance, selector, debug) {
   const store = instance[import_constants.UNWRAP_PROXY];
   const uid = (0, import_helpers.getStoreUid)(store.constructor, store.props);
   const info = import_helpers.cache.get(uid);
-  if (!info) {
-    throw new Error(`This store not created using createStore()`);
-  }
+  if (!info) throw new Error(`This store not created using createStore()`);
   return useStoreFromInfo(info, selector, {
     debug
   });
@@ -134,16 +129,10 @@ function onCreateStore(cb) {
   };
 }
 function getOrCreateStoreInfo(StoreKlass, props, options, propsKeyCalculated) {
-  if (!StoreKlass) {
-    return null;
-  }
+  if (!StoreKlass) return null;
   const uid = (0, import_helpers.getStoreUid)(StoreKlass, propsKeyCalculated ?? props);
-  if (!options?.avoidCache && import_helpers.cache.has(uid)) {
-    return import_helpers.cache.get(uid);
-  }
-  if (options?.refuseCreation) {
-    throw new Error(`No store exists (${StoreKlass.name}) with props: ${props}`);
-  }
+  if (!options?.avoidCache && import_helpers.cache.has(uid)) return import_helpers.cache.get(uid);
+  if (options?.refuseCreation) throw new Error(`No store exists (${StoreKlass.name}) with props: ${props}`);
   const storeInstance = new StoreKlass(props);
   storeInstance.props = props;
   const getters = {};
@@ -152,15 +141,7 @@ function getOrCreateStoreInfo(StoreKlass, props, options, propsKeyCalculated) {
   const descriptors = (0, import_helpers.getStoreDescriptors)(storeInstance);
   for (const key in descriptors) {
     const descriptor = descriptors[key];
-    if (typeof descriptor.value === "function") {
-      actions[key] = descriptor.value;
-    } else if (typeof descriptor.get === "function") {
-      getters[key] = descriptor.get;
-    } else {
-      if (key !== "props" && key[0] !== "_") {
-        stateKeys.add(key);
-      }
-    }
+    if (typeof descriptor.value === "function") actions[key] = descriptor.value;else if (typeof descriptor.get === "function") getters[key] = descriptor.get;else if (key !== "props" && key[0] !== "_") stateKeys.add(key);
   }
   const keyComparators = storeInstance["_comparators"];
   const listeners = /* @__PURE__ */new Set();
@@ -191,17 +172,13 @@ function getOrCreateStoreInfo(StoreKlass, props, options, propsKeyCalculated) {
     },
     triggerUpdate: () => {
       storeInfo.version = (storeInfo.version + 1) % Number.MAX_SAFE_INTEGER;
-      for (const cb of listeners) {
-        cb();
-      }
+      for (const cb of listeners) cb();
     }
   };
   const store = createProxiedStore(
   // we assign store right after and proxiedStore never accesses it until later on
   storeInfo);
-  if (process.env.NODE_ENV === "development") {
-    allStores[StoreKlass.name + uid] = store;
-  }
+  if (process.env.NODE_ENV === "development") allStores[StoreKlass.name + uid] = store;
   store.mount?.();
   storeInfo.store = store;
   const result = storeInfo;
@@ -210,18 +187,12 @@ function getOrCreateStoreInfo(StoreKlass, props, options, propsKeyCalculated) {
   return result;
 }
 const allStores = {};
-if (process.env.NODE_ENV === "development") {
-  globalThis["Store"] ||= allStores;
-}
+if (process.env.NODE_ENV === "development") globalThis["Store"] ||= allStores;
 const emptyObj = {};
 const selectKeys = (obj, keys) => {
-  if (!keys.length) {
-    return emptyObj;
-  }
+  if (!keys.length) return emptyObj;
   const res = {};
-  for (const key of keys) {
-    res[key] = obj[key];
-  }
+  for (const key of keys) res[key] = obj[key];
   return res;
 };
 let isInReaction = false;
@@ -232,14 +203,12 @@ function useStoreFromInfo(info, userSelector, options) {
   const store = info?.store;
   const internal = import_react.default.useRef(void 0);
   const component = (0, import_useStoreDebug.useCurrentComponent)();
-  if (!internal.current) {
-    internal.current = {
-      component,
-      tracked: /* @__PURE__ */new Set(),
-      last: null,
-      lastKeys: null
-    };
-  }
+  if (!internal.current) internal.current = {
+    component,
+    tracked: /* @__PURE__ */new Set(),
+    last: null,
+    lastKeys: null
+  };
   const curInternal = internal.current;
   const shouldPrintDebug = options?.debug;
   const getSnapshot = import_react.default.useCallback(() => {
@@ -249,66 +218,46 @@ function useStoreFromInfo(info, userSelector, options) {
     const keys = [...(!isTracking ? info.stateKeys : curInternal2.tracked)];
     const nextKeys = `${info.version}${keys.join("")}${userSelector || ""}`;
     const lastKeys = curInternal2.lastKeys;
-    if (nextKeys === curInternal2.lastKeys) {
-      return curInternal2.last;
-    }
+    if (nextKeys === curInternal2.lastKeys) return curInternal2.last;
     curInternal2.lastKeys = nextKeys;
     let snap;
     info.disableTracking = true;
     const last = curInternal2.last;
-    if (userSelector) {
-      snap = userSelector(store);
-    } else {
-      snap = selectKeys(store, keys);
-    }
+    if (userSelector) snap = userSelector(store);else snap = selectKeys(store, keys);
     info.disableTracking = false;
     const isUnchanged = !userSelector && !isTracking && last || typeof last !== "undefined" && (0, import_comparators.isEqualSubsetShallow)(last, snap, {
       keyComparators: info.keyComparators
     });
-    if (shouldPrintDebug) {
-      console.info("\u{1F311} getSnapshot", {
-        storeState: selectKeys(store, Object.keys(store)),
-        userSelector,
-        info,
-        isUnchanged,
-        component,
-        keys,
-        last,
-        snap,
-        curInternal: curInternal2,
-        nextKeys,
-        lastKeys
-      });
-    }
-    if (isUnchanged) {
-      return last;
-    }
+    if (shouldPrintDebug) console.info("🌑 getSnapshot", {
+      storeState: selectKeys(store, Object.keys(store)),
+      userSelector,
+      info,
+      isUnchanged,
+      component,
+      keys,
+      last,
+      snap,
+      curInternal: curInternal2,
+      nextKeys,
+      lastKeys
+    });
+    if (isUnchanged) return last;
     curInternal2.last = snap;
     return snap;
   }, [store]);
   const state = import_react.default.useSyncExternalStore(info?.subscribe || idFn, getSnapshot, getSnapshot);
-  if (!info || !store || !state) {
-    return state;
-  }
-  if (userSelector) {
-    return state;
-  }
+  if (!info || !store || !state) return state;
+  if (userSelector) return state;
   return new Proxy(store, {
     get(target, key) {
       const curVal = Reflect.get(target, key);
-      if (isInReaction) {
-        return curVal;
-      }
+      if (isInReaction) return curVal;
       const keyString = key;
       if (info.stateKeys.has(keyString) || keyString in info.getters) {
-        if (shouldPrintDebug) {
-          console.info("\u{1F440} tracking", keyString);
-        }
+        if (shouldPrintDebug) console.info("👀 tracking", keyString);
         curInternal.tracked.add(keyString);
       }
-      if (Reflect.has(state, key)) {
-        return Reflect.get(state, key);
-      }
+      if (Reflect.has(state, key)) return Reflect.get(state, key);
       return curVal;
     }
   });
@@ -332,32 +281,22 @@ function createProxiedStore(storeInfo) {
   let didSet = false;
   const wrappedActions = {};
   for (const key in actions) {
-    if (key === "subscribe") {
-      continue;
-    }
+    if (key === "subscribe") continue;
     const actionFn = actions[key];
     const isGetFn = key.startsWith("get");
     wrappedActions[key] = function useStoreAction(...args) {
       let res;
-      if (isGetFn || gettersState.isGetting) {
-        return Reflect.apply(actionFn, proxiedStore, args);
-      }
-      if (process.env.NODE_ENV === "development" && shouldDebug2) {
-        console.info("(debug) startAction", key);
-      }
+      if (isGetFn || gettersState.isGetting) return Reflect.apply(actionFn, proxiedStore, args);
+      if (process.env.NODE_ENV === "development" && shouldDebug2) console.info("(debug) startAction", key);
       res = Reflect.apply(actionFn, proxiedStore, args);
-      if (res instanceof Promise) {
-        return res.then(finishAction);
-      }
+      if (res instanceof Promise) return res.then(finishAction);
       finishAction();
       return res;
     };
     if (process.env.NODE_ENV === "development") {
       let hashCode = function (str) {
           let hash = 0;
-          for (let i = 0; i < str.length; i++) {
-            hash = str.charCodeAt(i) + ((hash << 5) - hash);
-          }
+          for (let i = 0; i < str.length; i++) hash = str.charCodeAt(i) + ((hash << 5) - hash);
           return hash;
         },
         strColor = function (str) {
@@ -368,10 +307,7 @@ function createProxiedStore(storeInfo) {
         wrappedActions[key] = new Proxy(ogAction, {
           apply(target, thisArg, args) {
             const isDebugging = shouldDebug2 || storeInfo.debug;
-            const shouldLog = process.env.LOG_LEVEL !== "0" && (isDebugging || import_configureUseStore.configureOpts.logLevel !== "error");
-            if (!shouldLog) {
-              return Reflect.apply(target, thisArg, args);
-            }
+            if (!(process.env.LOG_LEVEL !== "0" && (isDebugging || import_configureUseStore.configureOpts.logLevel !== "error"))) return Reflect.apply(target, thisArg, args);
             setters = /* @__PURE__ */new Set();
             const curSetters = setters;
             const isTopLevelLogger = logStack.size == 0;
@@ -390,18 +326,12 @@ function createProxiedStore(storeInfo) {
               const color = strColor(name);
               const simpleArgs = args.map(import_helpers.simpleStr);
               logs.add([`%c \u{1F311} ${id} ${name.padStart(isTopLevelLogger ? 8 : 4)}%c.${key}(${simpleArgs.join(", ")})${isTopLevelLogger && logStack.size > 1 ? ` (+${logStack.size - 1})` : ""}`, `color: ${color};`, "color: black;"]);
-              if (curSetters.size) {
-                curSetters.forEach(({
-                  key: key2,
-                  value
-                }) => {
-                  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
-                    logs.add([` SET ${key2} ${value}`, value]);
-                  } else {
-                    logs.add([` SET ${key2}`, value]);
-                  }
-                });
-              }
+              if (curSetters.size) curSetters.forEach(({
+                key: key2,
+                value
+              }) => {
+                if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") logs.add([` SET ${key2} ${value}`, value]);else logs.add([` SET ${key2}`, value]);
+              });
               if (isTopLevelLogger) {
                 let error = null;
                 try {
@@ -425,19 +355,13 @@ function createProxiedStore(storeInfo) {
                         console.info(...log);
                         console.groupEnd();
                       }
-                    } else {
-                      console.info("Weird log", head, ...rest);
-                    }
+                    } else console.info("Weird log", head, ...rest);
                   }
                 } catch (err) {
                   error = err;
                 }
-                for (const _ of logStack) {
-                  console.groupEnd();
-                }
-                if (error) {
-                  console.error(`error loggin`, error);
-                }
+                for (const _ of logStack) console.groupEnd();
+                if (error) console.error(`error loggin`, error);
                 logStack.clear();
               }
               return res;
@@ -448,11 +372,9 @@ function createProxiedStore(storeInfo) {
     }
   }
   const finishAction = val => {
-    if (process.env.NODE_ENV === "development" && shouldDebug2) {
-      console.info("(debug) finishAction", {
-        didSet
-      });
-    }
+    if (process.env.NODE_ENV === "development" && shouldDebug2) console.info("(debug) finishAction", {
+      didSet
+    });
     if (didSet) {
       storeInfo.triggerUpdate();
       didSet = false;
@@ -461,55 +383,32 @@ function createProxiedStore(storeInfo) {
   };
   let isTriggering = false;
   const proxiedStore = new Proxy(storeInstance, {
-    // GET
     get(_, key) {
-      if (key in wrappedActions) {
-        return wrappedActions[key];
-      }
-      if (key in passThroughKeys) {
-        return Reflect.get(storeInstance, key);
-      }
-      if (key === import_constants.UNWRAP_PROXY) {
-        return storeInstance;
-      }
-      if (key === import_helpers.UNWRAP_STORE_INFO) {
-        return storeInfo;
-      }
-      if (storeAccessTrackers.size) {
-        storeAccessTrackers.forEach(cb => cb(storeInfo));
-      }
-      if (typeof key !== "string") {
-        return Reflect.get(storeInstance, key);
-      }
+      if (key in wrappedActions) return wrappedActions[key];
+      if (key in passThroughKeys) return Reflect.get(storeInstance, key);
+      if (key === import_constants.UNWRAP_PROXY) return storeInstance;
+      if (key === import_helpers.UNWRAP_STORE_INFO) return storeInfo;
+      if (storeAccessTrackers.size) storeAccessTrackers.forEach(cb => cb(storeInfo));
+      if (typeof key !== "string") return Reflect.get(storeInstance, key);
       if (!storeInfo.disableTracking) {
-        if (gettersState.isGetting) {
-          gettersState.curGetKeys.add(key);
-        } else {}
+        if (gettersState.isGetting) gettersState.curGetKeys.add(key);
       }
       if (key in getters) {
-        if (getCache.has(key)) {
-          return getCache.get(key);
-        }
+        if (getCache.has(key)) return getCache.get(key);
         curGetKeys.clear();
         const isSubGetter = gettersState.isGetting;
         gettersState.isGetting = true;
         const res = getters[key].call(proxiedStore);
-        if (!isSubGetter) {
-          gettersState.isGetting = false;
-        }
+        if (!isSubGetter) gettersState.isGetting = false;
         for (const gk of curGetKeys) {
-          if (!depsToGetter.has(gk)) {
-            depsToGetter.set(gk, /* @__PURE__ */new Set());
-          }
-          const cur = depsToGetter.get(gk);
-          cur.add(key);
+          if (!depsToGetter.has(gk)) depsToGetter.set(gk, /* @__PURE__ */new Set());
+          depsToGetter.get(gk).add(key);
         }
         getCache.set(key, res);
         return res;
       }
       return Reflect.get(storeInstance, key);
     },
-    // SET
     set(target, key, value, receiver) {
       const cur = Reflect.get(target, key);
       const res = Reflect.set(target, key, value, receiver);
@@ -521,16 +420,12 @@ function createProxiedStore(storeInfo) {
               key,
               value
             });
-            if (getShouldDebug(storeInfo)) {
-              console.info("(debug) SET", res, key, value);
-            }
-          }
-          if (process.env.NODE_ENV === "development" && shouldDebug2) {
-            console.info("SET...", {
-              key,
-              value
-            });
+            if (getShouldDebug(storeInfo)) console.info("(debug) SET", res, key, value);
           }
+          if (process.env.NODE_ENV === "development" && shouldDebug2) console.info("SET...", {
+            key,
+            value
+          });
         }
         if (!isTriggering) {
           isTriggering = true;
@@ -546,14 +441,10 @@ function createProxiedStore(storeInfo) {
   function clearGetterCache(setKey) {
     const parentGetters = depsToGetter.get(setKey);
     getCache.delete(setKey);
-    if (!parentGetters) {
-      return;
-    }
+    if (!parentGetters) return;
     for (const gk of parentGetters) {
       getCache.delete(gk);
-      if (depsToGetter.has(gk)) {
-        clearGetterCache(gk);
-      }
+      if (depsToGetter.has(gk)) clearGetterCache(gk);
     }
   }
   return proxiedStore;
@@ -572,6 +463,5 @@ function getShouldDebug(storeInfo) {
   const info = {
     storeInstance: storeInfo.store
   };
-  const trackers = storeInfo.trackers;
-  return [...trackers].some(tracker => tracker.component && (0, import_useStoreDebug.shouldDebug)(tracker.component, info));
+  return [...storeInfo.trackers].some(tracker => tracker.component && (0, import_useStoreDebug.shouldDebug)(tracker.component, info));
 }