@reactuses/core 5.0.19 → 5.0.21

package/dist/index.cjs

@@ -114,6 +114,18 @@ function useEventListener(eventName, handler, element, options = defaultOptions$
     ]);
 }
 
+const useMount = (fn)=>{
+    if (isDev) {
+        if (!isFunction(fn)) {
+            console.error(`useMount: parameter \`fn\` expected to be a function, but got "${typeof fn}".`);
+        }
+    }
+    React.useEffect(()=>{
+        fn == null ? void 0 : fn();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+};
+
 const useActiveElement = ()=>{
     const [active, setActive] = React.useState(null);
     const listener = React.useCallback(()=>{
@@ -122,6 +134,10 @@ const useActiveElement = ()=>{
     }, []);
     useEventListener('blur', listener, ()=>window, true);
     useEventListener('focus', listener, ()=>window, true);
+    useMount(()=>{
+        var _window;
+        setActive((_window = window) == null ? void 0 : _window.document.activeElement);
+    });
     return active;
 };
 
@@ -546,7 +562,7 @@ function guessSerializerType(rawInit) {
 
 const StorageSerializers = {
     boolean: {
-        read: (v)=>v === 'true',
+        read: (v)=>v === "true",
         write: (v)=>String(v)
     },
     object: {
@@ -595,14 +611,15 @@ function getInitialState$3(key, defaultValue, storage, serializer, onError) {
         }
     }
     // A default value has not been provided, and you are rendering on the server, warn of a possible hydration mismatch when defaulting to false.
-    if (process.env.NODE_ENV !== 'production') {
-        console.warn('`createStorage` When server side rendering, defaultValue should be defined to prevent a hydration mismatches.');
+    if (process.env.NODE_ENV !== "production") {
+        console.warn("`createStorage` When server side rendering, defaultValue should be defined to prevent a hydration mismatches.");
     }
     return null;
 }
 function useStorage(key, defaultValue, getStorage = ()=>isBrowser ? sessionStorage : undefined, options = defaultOptions$1) {
     let storage;
-    const { onError = defaultOnError, effectStorageValue } = options;
+    const { onError = defaultOnError, effectStorageValue, mountStorageValue, listenToStorageChanges = true } = options;
+    const storageValue = mountStorageValue != null ? mountStorageValue : effectStorageValue;
     try {
         storage = getStorage();
     } catch (err) {
@@ -614,7 +631,7 @@ function useStorage(key, defaultValue, getStorage = ()=>isBrowser ? sessionStora
     const [state, setState] = React.useState(getInitialState$3(key, defaultValue, storage, serializer, onError));
     useDeepCompareEffect(()=>{
         var _ref;
-        const data = (_ref = effectStorageValue ? isFunction(effectStorageValue) ? effectStorageValue() : effectStorageValue : defaultValue) != null ? _ref : null;
+        const data = (_ref = storageValue ? isFunction(storageValue) ? storageValue() : storageValue : defaultValue) != null ? _ref : null;
         const getStoredValue = ()=>{
             try {
                 const raw = storage == null ? void 0 : storage.getItem(key);
@@ -634,7 +651,7 @@ function useStorage(key, defaultValue, getStorage = ()=>isBrowser ? sessionStora
         serializer,
         storage,
         onError,
-        effectStorageValue
+        storageValue
     ]);
     const updateState = useEvent((valOrFunc)=>{
         const currentState = isFunction(valOrFunc) ? valOrFunc(state) : valOrFunc;
@@ -649,6 +666,28 @@ function useStorage(key, defaultValue, getStorage = ()=>isBrowser ? sessionStora
             }
         }
     });
+    const listener = useEvent(()=>{
+        try {
+            const raw = storage == null ? void 0 : storage.getItem(key);
+            if (raw !== undefined && raw !== null) {
+                updateState(serializer.read(raw));
+            } else {
+                updateState(null);
+            }
+        } catch (e) {
+            onError(e);
+        }
+    });
+    React.useEffect(()=>{
+        if (listenToStorageChanges) {
+            window.addEventListener("storage", listener);
+            return ()=>window.removeEventListener("storage", listener);
+        }
+        return ()=>{};
+    }, [
+        listenToStorageChanges,
+        listener
+    ]);
     return [
         state,
         updateState
@@ -661,7 +700,7 @@ const useDarkMode = (options)=>{
         return window.matchMedia('(prefers-color-scheme: dark)').matches;
     };
     const [dark, setDark] = useStorage(storageKey, defaultValue, storage, {
-        effectStorageValue: value
+        mountStorageValue: value
     });
     React.useEffect(()=>{
         var _window;
@@ -1334,18 +1373,6 @@ const useFirstMountState = ()=>{
     return isFirst.current;
 };
 
-const useMount = (fn)=>{
-    if (isDev) {
-        if (!isFunction(fn)) {
-            console.error(`useMount: parameter \`fn\` expected to be a function, but got "${typeof fn}".`);
-        }
-    }
-    React.useEffect(()=>{
-        fn == null ? void 0 : fn();
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, []);
-};
-
 const useFocus = (target, initialValue = false)=>{
     const [focus, innerSetFocus] = React.useState(initialValue);
     useEventListener('focus', ()=>innerSetFocus(true), target);

package/dist/index.d.cts

@@ -1448,19 +1448,33 @@ interface Serializer<T> {
 }
 interface UseStorageOptions<T> {
     /**
-     * Custom data serialization
+     * @en Custom data serialization
+     * @zh 自定义数据序列化
      */
     serializer?: Serializer<T>;
     /**
-     * On error callback
-     *
-     * Default log error to `console.error`
+     * @en On error callback
+     * @zh 错误回调
+     * @defaultValue `console.error`
      */
     onError?: (error: unknown) => void;
     /**
-     * set to storage when nodata in effect, fallback to defaults
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     * @deprecated
      */
     effectStorageValue?: T | (() => T);
+    /**
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     */
+    mountStorageValue?: T | (() => T);
+    /**
+     * @en listen to storage changes
+     * @zh 监听 storage 变化
+     * @defaultValue `true`
+     */
+    listenToStorageChanges?: boolean;
 }
 
 declare function useLocalStorage(key: string, defaults: string, options?: UseStorageOptions<string>): readonly [string | null, Dispatch<SetStateAction<string | null>>];
@@ -3117,10 +3131,22 @@ interface UseLocalStorageOptions<T> {
      */
     onError?: (error: unknown) => void;
     /**
-     * @en set to storage when storage doesn't has data in effect, fallback to `defaultValue`
-     * @zh 当副作用执行的时候没有在 storage 中获取到数据时设置，默认会设置 `defaultValue`
+     * @en set to storage when nodata in first mount, deprecated
+     * @zh 首次挂载时没有数据时设置到 storage, 已弃用
+     * @deprecated
      */
     effectStorageValue?: T | (() => T);
+    /**
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     */
+    mountStorageValue?: T | (() => T);
+    /**
+     * @en listen to storage changes
+     * @zh 监听 storage 变化
+     * @defaultValue `true`
+     */
+    listenToStorageChanges?: boolean;
 }
 /**
  * @title UseLocalStorageSerializer
@@ -3262,10 +3288,22 @@ interface UseSessionStorageOptions<T> {
      */
     onError?: (error: unknown) => void;
     /**
-     * @en set to storage when storage doesn't has data in effect, fallback to `defaultValue`
-     * @zh 当副作用执行的时候没有在 storage 中获取到数据时设置，默认会设置 `defaultValue`
+     * @en set to storage when nodata in first mount, deprecated
+     * @zh 首次挂载时没有数据时设置到 storage, 已弃用
+     * @deprecated
      */
     effectStorageValue?: T | (() => T);
+    /**
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     */
+    mountStorageValue?: T | (() => T);
+    /**
+     * @en listen to storage changes
+     * @zh 监听 storage 变化
+     * @defaultValue `true`
+     */
+    listenToStorageChanges?: boolean;
 }
 /**
  * @title UseSessionStorageSerializer

package/dist/index.d.mts

@@ -1448,19 +1448,33 @@ interface Serializer<T> {
 }
 interface UseStorageOptions<T> {
     /**
-     * Custom data serialization
+     * @en Custom data serialization
+     * @zh 自定义数据序列化
      */
     serializer?: Serializer<T>;
     /**
-     * On error callback
-     *
-     * Default log error to `console.error`
+     * @en On error callback
+     * @zh 错误回调
+     * @defaultValue `console.error`
      */
     onError?: (error: unknown) => void;
     /**
-     * set to storage when nodata in effect, fallback to defaults
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     * @deprecated
      */
     effectStorageValue?: T | (() => T);
+    /**
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     */
+    mountStorageValue?: T | (() => T);
+    /**
+     * @en listen to storage changes
+     * @zh 监听 storage 变化
+     * @defaultValue `true`
+     */
+    listenToStorageChanges?: boolean;
 }
 
 declare function useLocalStorage(key: string, defaults: string, options?: UseStorageOptions<string>): readonly [string | null, Dispatch<SetStateAction<string | null>>];
@@ -3117,10 +3131,22 @@ interface UseLocalStorageOptions<T> {
      */
     onError?: (error: unknown) => void;
     /**
-     * @en set to storage when storage doesn't has data in effect, fallback to `defaultValue`
-     * @zh 当副作用执行的时候没有在 storage 中获取到数据时设置，默认会设置 `defaultValue`
+     * @en set to storage when nodata in first mount, deprecated
+     * @zh 首次挂载时没有数据时设置到 storage, 已弃用
+     * @deprecated
      */
     effectStorageValue?: T | (() => T);
+    /**
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     */
+    mountStorageValue?: T | (() => T);
+    /**
+     * @en listen to storage changes
+     * @zh 监听 storage 变化
+     * @defaultValue `true`
+     */
+    listenToStorageChanges?: boolean;
 }
 /**
  * @title UseLocalStorageSerializer
@@ -3262,10 +3288,22 @@ interface UseSessionStorageOptions<T> {
      */
     onError?: (error: unknown) => void;
     /**
-     * @en set to storage when storage doesn't has data in effect, fallback to `defaultValue`
-     * @zh 当副作用执行的时候没有在 storage 中获取到数据时设置，默认会设置 `defaultValue`
+     * @en set to storage when nodata in first mount, deprecated
+     * @zh 首次挂载时没有数据时设置到 storage, 已弃用
+     * @deprecated
      */
     effectStorageValue?: T | (() => T);
+    /**
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     */
+    mountStorageValue?: T | (() => T);
+    /**
+     * @en listen to storage changes
+     * @zh 监听 storage 变化
+     * @defaultValue `true`
+     */
+    listenToStorageChanges?: boolean;
 }
 /**
  * @title UseSessionStorageSerializer

package/dist/index.d.ts

@@ -1448,19 +1448,33 @@ interface Serializer<T> {
 }
 interface UseStorageOptions<T> {
     /**
-     * Custom data serialization
+     * @en Custom data serialization
+     * @zh 自定义数据序列化
      */
     serializer?: Serializer<T>;
     /**
-     * On error callback
-     *
-     * Default log error to `console.error`
+     * @en On error callback
+     * @zh 错误回调
+     * @defaultValue `console.error`
      */
     onError?: (error: unknown) => void;
     /**
-     * set to storage when nodata in effect, fallback to defaults
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     * @deprecated
      */
     effectStorageValue?: T | (() => T);
+    /**
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     */
+    mountStorageValue?: T | (() => T);
+    /**
+     * @en listen to storage changes
+     * @zh 监听 storage 变化
+     * @defaultValue `true`
+     */
+    listenToStorageChanges?: boolean;
 }
 
 declare function useLocalStorage(key: string, defaults: string, options?: UseStorageOptions<string>): readonly [string | null, Dispatch<SetStateAction<string | null>>];
@@ -3117,10 +3131,22 @@ interface UseLocalStorageOptions<T> {
      */
     onError?: (error: unknown) => void;
     /**
-     * @en set to storage when storage doesn't has data in effect, fallback to `defaultValue`
-     * @zh 当副作用执行的时候没有在 storage 中获取到数据时设置，默认会设置 `defaultValue`
+     * @en set to storage when nodata in first mount, deprecated
+     * @zh 首次挂载时没有数据时设置到 storage, 已弃用
+     * @deprecated
      */
     effectStorageValue?: T | (() => T);
+    /**
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     */
+    mountStorageValue?: T | (() => T);
+    /**
+     * @en listen to storage changes
+     * @zh 监听 storage 变化
+     * @defaultValue `true`
+     */
+    listenToStorageChanges?: boolean;
 }
 /**
  * @title UseLocalStorageSerializer
@@ -3262,10 +3288,22 @@ interface UseSessionStorageOptions<T> {
      */
     onError?: (error: unknown) => void;
     /**
-     * @en set to storage when storage doesn't has data in effect, fallback to `defaultValue`
-     * @zh 当副作用执行的时候没有在 storage 中获取到数据时设置，默认会设置 `defaultValue`
+     * @en set to storage when nodata in first mount, deprecated
+     * @zh 首次挂载时没有数据时设置到 storage, 已弃用
+     * @deprecated
      */
     effectStorageValue?: T | (() => T);
+    /**
+     * @en set to storage when nodata in first mount
+     * @zh 首次挂载时没有数据时设置到 storage
+     */
+    mountStorageValue?: T | (() => T);
+    /**
+     * @en listen to storage changes
+     * @zh 监听 storage 变化
+     * @defaultValue `true`
+     */
+    listenToStorageChanges?: boolean;
 }
 /**
  * @title UseSessionStorageSerializer

package/dist/index.mjs

@@ -106,6 +106,18 @@ function useEventListener(eventName, handler, element, options = defaultOptions$
     ]);
 }
 
+const useMount = (fn)=>{
+    if (isDev) {
+        if (!isFunction(fn)) {
+            console.error(`useMount: parameter \`fn\` expected to be a function, but got "${typeof fn}".`);
+        }
+    }
+    useEffect(()=>{
+        fn == null ? void 0 : fn();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+};
+
 const useActiveElement = ()=>{
     const [active, setActive] = useState(null);
     const listener = useCallback(()=>{
@@ -114,6 +126,10 @@ const useActiveElement = ()=>{
     }, []);
     useEventListener('blur', listener, ()=>window, true);
     useEventListener('focus', listener, ()=>window, true);
+    useMount(()=>{
+        var _window;
+        setActive((_window = window) == null ? void 0 : _window.document.activeElement);
+    });
     return active;
 };
 
@@ -538,7 +554,7 @@ function guessSerializerType(rawInit) {
 
 const StorageSerializers = {
     boolean: {
-        read: (v)=>v === 'true',
+        read: (v)=>v === "true",
         write: (v)=>String(v)
     },
     object: {
@@ -587,14 +603,15 @@ function getInitialState$3(key, defaultValue, storage, serializer, onError) {
         }
     }
     // A default value has not been provided, and you are rendering on the server, warn of a possible hydration mismatch when defaulting to false.
-    if (process.env.NODE_ENV !== 'production') {
-        console.warn('`createStorage` When server side rendering, defaultValue should be defined to prevent a hydration mismatches.');
+    if (process.env.NODE_ENV !== "production") {
+        console.warn("`createStorage` When server side rendering, defaultValue should be defined to prevent a hydration mismatches.");
     }
     return null;
 }
 function useStorage(key, defaultValue, getStorage = ()=>isBrowser ? sessionStorage : undefined, options = defaultOptions$1) {
     let storage;
-    const { onError = defaultOnError, effectStorageValue } = options;
+    const { onError = defaultOnError, effectStorageValue, mountStorageValue, listenToStorageChanges = true } = options;
+    const storageValue = mountStorageValue != null ? mountStorageValue : effectStorageValue;
     try {
         storage = getStorage();
     } catch (err) {
@@ -606,7 +623,7 @@ function useStorage(key, defaultValue, getStorage = ()=>isBrowser ? sessionStora
     const [state, setState] = useState(getInitialState$3(key, defaultValue, storage, serializer, onError));
     useDeepCompareEffect(()=>{
         var _ref;
-        const data = (_ref = effectStorageValue ? isFunction(effectStorageValue) ? effectStorageValue() : effectStorageValue : defaultValue) != null ? _ref : null;
+        const data = (_ref = storageValue ? isFunction(storageValue) ? storageValue() : storageValue : defaultValue) != null ? _ref : null;
         const getStoredValue = ()=>{
             try {
                 const raw = storage == null ? void 0 : storage.getItem(key);
@@ -626,7 +643,7 @@ function useStorage(key, defaultValue, getStorage = ()=>isBrowser ? sessionStora
         serializer,
         storage,
         onError,
-        effectStorageValue
+        storageValue
     ]);
     const updateState = useEvent((valOrFunc)=>{
         const currentState = isFunction(valOrFunc) ? valOrFunc(state) : valOrFunc;
@@ -641,6 +658,28 @@ function useStorage(key, defaultValue, getStorage = ()=>isBrowser ? sessionStora
             }
         }
     });
+    const listener = useEvent(()=>{
+        try {
+            const raw = storage == null ? void 0 : storage.getItem(key);
+            if (raw !== undefined && raw !== null) {
+                updateState(serializer.read(raw));
+            } else {
+                updateState(null);
+            }
+        } catch (e) {
+            onError(e);
+        }
+    });
+    useEffect(()=>{
+        if (listenToStorageChanges) {
+            window.addEventListener("storage", listener);
+            return ()=>window.removeEventListener("storage", listener);
+        }
+        return ()=>{};
+    }, [
+        listenToStorageChanges,
+        listener
+    ]);
     return [
         state,
         updateState
@@ -653,7 +692,7 @@ const useDarkMode = (options)=>{
         return window.matchMedia('(prefers-color-scheme: dark)').matches;
     };
     const [dark, setDark] = useStorage(storageKey, defaultValue, storage, {
-        effectStorageValue: value
+        mountStorageValue: value
     });
     useEffect(()=>{
         var _window;
@@ -1326,18 +1365,6 @@ const useFirstMountState = ()=>{
     return isFirst.current;
 };
 
-const useMount = (fn)=>{
-    if (isDev) {
-        if (!isFunction(fn)) {
-            console.error(`useMount: parameter \`fn\` expected to be a function, but got "${typeof fn}".`);
-        }
-    }
-    useEffect(()=>{
-        fn == null ? void 0 : fn();
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, []);
-};
-
 const useFocus = (target, initialValue = false)=>{
     const [focus, innerSetFocus] = useState(initialValue);
     useEventListener('focus', ()=>innerSetFocus(true), target);

package/dist/useQRCode.d.cts

@@ -1,4 +1,4 @@
-import QRCode from 'qrcode';
+import QRCode, { QRCodeToDataURLOptions } from 'qrcode';
 
 /**
  * @title UseQRCode
@@ -13,7 +13,7 @@ text: string,
  * @zh 传递给 `QRCode.toDataURL` 的选项
  * @en Options passed to `QRCode.toDataURL`
  */
-options?: QRCode.QRCodeToDataURLOptions) => UseQRCodeReturn;
+options?: QRCodeToDataURLOptions) => UseQRCodeReturn;
 /**
  * @title UseQRCodeReturn
  */

package/dist/useQRCode.d.mts

@@ -1,4 +1,4 @@
-import QRCode from 'qrcode';
+import QRCode, { QRCodeToDataURLOptions } from 'qrcode';
 
 /**
  * @title UseQRCode
@@ -13,7 +13,7 @@ text: string,
  * @zh 传递给 `QRCode.toDataURL` 的选项
  * @en Options passed to `QRCode.toDataURL`
  */
-options?: QRCode.QRCodeToDataURLOptions) => UseQRCodeReturn;
+options?: QRCodeToDataURLOptions) => UseQRCodeReturn;
 /**
  * @title UseQRCodeReturn
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reactuses/core",
-  "version": "5.0.19",
+  "version": "5.0.21",
   "license": "Unlicense",
   "homepage": "https://www.reactuse.com/",
   "repository": {