@reactuses/core 5.0.14 → 5.0.16

package/README.md

@@ -56,6 +56,19 @@ Refer to [documentations](https://reactuse.com/) for more details.
 
 <hr/>
 
+## Sponsor Me
+
+If my work has helped you, consider buying me a cup of coffee. Thank you very much🥰!.
+
+[Buy me a coffee](https://www.buymeacoffee.com/lianwenwu)
+
+### For Chinese User
+
+<p float="left">
+  <img src="https://d21002cb.images-f3o.pages.dev/images/wechat.jpg" alt="Wechat Pay" width="200" />
+  <img src="https://d21002cb.images-f3o.pages.dev/images/ali.jpg" alt="Ali Pay" width="200" />
+</p>
+
 ## Feedback
 
 You can submit an [issue](https://github.com/childrentime/reactuse/issues) or provide feedback on [Discord](https://discord.gg/HMsq6cFkKp).

package/dist/index-client-DSNqfa2q.cjs

@@ -0,0 +1,29 @@
+'use client';
+var React = require('react');
+
+function assignRef(ref, value) {
+    if (ref == null) return;
+    if (typeof ref === "function") {
+        ref(value);
+        return;
+    }
+    try {
+        ref.current = value;
+    } catch (error) {
+        throw new Error(`Cannot assign value '${value}' to ref '${ref}'`);
+    }
+}
+function mergeRefs(...refs) {
+    return (node)=>{
+        refs.forEach((ref)=>{
+            assignRef(ref, node);
+        });
+    };
+}
+const useMergedRefs = (...refs)=>{
+    return React.useMemo(()=>mergeRefs(...refs), refs);
+};
+
+exports.assignRef = assignRef;
+exports.mergeRefs = mergeRefs;
+exports.useMergedRefs = useMergedRefs;

package/dist/index-client-KksAIxbB.js

@@ -0,0 +1,27 @@
+'use client';
+import { useMemo } from 'react';
+
+function assignRef(ref, value) {
+    if (ref == null) return;
+    if (typeof ref === "function") {
+        ref(value);
+        return;
+    }
+    try {
+        ref.current = value;
+    } catch (error) {
+        throw new Error(`Cannot assign value '${value}' to ref '${ref}'`);
+    }
+}
+function mergeRefs(...refs) {
+    return (node)=>{
+        refs.forEach((ref)=>{
+            assignRef(ref, node);
+        });
+    };
+}
+const useMergedRefs = (...refs)=>{
+    return useMemo(()=>mergeRefs(...refs), refs);
+};
+
+export { assignRef as a, mergeRefs as m, useMergedRefs as u };

package/dist/index.cjs

@@ -5,6 +5,7 @@ var lodashEs = require('lodash-es');
 var Cookies = require('js-cookie');
 var screenfull = require('screenfull');
 var index_js = require('use-sync-external-store/shim/index.js');
+var indexClient = require('./index-client-DSNqfa2q.cjs');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -3323,11 +3324,178 @@ const useMobileLandscape = ()=>{
     return isMobileLandscape;
 };
 
+const useControlled = (value, defaultValue, onChange)=>{
+    const [stateValue, setStateValue] = React.useState(value !== undefined ? value : defaultValue);
+    const isControlled = value !== undefined;
+    const onChangeRef = useLatest(onChange);
+    const setValue = React.useCallback((newValue)=>{
+        if (!isControlled) {
+            setStateValue(newValue);
+        }
+        onChangeRef.current == null ? void 0 : onChangeRef.current.call(onChangeRef, newValue);
+    }, [
+        isControlled,
+        onChangeRef
+    ]);
+    return [
+        isControlled ? value : stateValue,
+        setValue
+    ];
+};
+
+const useDisclosure = (props = {})=>{
+    const { defaultOpen, isOpen: isOpenProp, onClose: onCloseProp, onOpen: onOpenProp, onChange = ()=>{} } = props;
+    const onOpenPropRef = useLatest(onOpenProp);
+    const onClosePropRef = useLatest(onCloseProp);
+    const [isOpen, setIsOpen] = useControlled(isOpenProp, defaultOpen || false, onChange);
+    const isControlled = isOpenProp !== undefined;
+    const onClose = React.useCallback(()=>{
+        if (!isControlled) {
+            setIsOpen(false);
+        }
+        onClosePropRef.current == null ? void 0 : onClosePropRef.current.call(onClosePropRef);
+    }, [
+        isControlled,
+        onClosePropRef,
+        setIsOpen
+    ]);
+    const onOpen = React.useCallback(()=>{
+        if (!isControlled) {
+            setIsOpen(true);
+        }
+        onOpenPropRef.current == null ? void 0 : onOpenPropRef.current.call(onOpenPropRef);
+    }, [
+        isControlled,
+        onOpenPropRef,
+        setIsOpen
+    ]);
+    const onOpenChange = React.useCallback(()=>{
+        const action = isOpen ? onClose : onOpen;
+        action();
+    }, [
+        isOpen,
+        onOpen,
+        onClose
+    ]);
+    return {
+        isOpen: !!isOpen,
+        onOpen,
+        onClose,
+        onOpenChange,
+        isControlled
+    };
+};
+
+const useEventSource = (url, events = [], options = defaultOptions$1)=>{
+    const [data, setData] = React.useState(null);
+    const [error, setError] = React.useState(null);
+    const [status, setStatus] = React.useState("DISCONNECTED");
+    const [event, setEvent] = React.useState(null);
+    const [lastEventId, setLastEventId] = React.useState(null);
+    const retries = React.useRef(0);
+    const explicitlyClosed = React.useRef(false);
+    const eventSourceRef = React.useRef(null);
+    const eventListenerRef = React.useRef();
+    if (!eventListenerRef.current) {
+        eventListenerRef.current = new Map();
+    }
+    const clean = useEvent(()=>{
+        const listeners = eventListenerRef.current;
+        events.forEach((name)=>{
+            const handler = listeners == null ? void 0 : listeners.get(name);
+            if (handler) {
+                var _eventSourceRef_current;
+                (_eventSourceRef_current = eventSourceRef.current) == null ? void 0 : _eventSourceRef_current.removeEventListener(name, handler);
+            }
+        });
+    });
+    const close = React.useCallback(()=>{
+        var _eventSourceRef_current;
+        setStatus("DISCONNECTED");
+        clean();
+        (_eventSourceRef_current = eventSourceRef.current) == null ? void 0 : _eventSourceRef_current.close();
+        eventSourceRef.current = null;
+        explicitlyClosed.current = true;
+    }, [
+        clean
+    ]);
+    const open = useEvent(()=>{
+        close();
+        explicitlyClosed.current = false;
+        retries.current = 0;
+        if (!eventSourceRef.current) {
+            eventSourceRef.current = new EventSource(url, {
+                withCredentials: options.withCredentials
+            });
+        }
+        const es = eventSourceRef.current;
+        es.onopen = ()=>{
+            setStatus("CONNECTED");
+            setError(null);
+        };
+        es.onmessage = (ev)=>{
+            setData(ev.data);
+            setLastEventId(ev.lastEventId);
+            setStatus("CONNECTED");
+        };
+        es.onerror = (err)=>{
+            setError(err);
+            setStatus("DISCONNECTED");
+            if (options.autoReconnect && !explicitlyClosed.current) {
+                const { retries: maxRetries = -1, delay = 1000, onFailed } = options.autoReconnect;
+                retries.current += 1;
+                if (typeof maxRetries === "number" && (maxRetries < 0 || retries.current < maxRetries) || typeof maxRetries === "function" && maxRetries()) {
+                    setTimeout(open, delay);
+                } else {
+                    onFailed == null ? void 0 : onFailed();
+                }
+            }
+        };
+        const listeners = eventListenerRef.current;
+        events.forEach((name)=>{
+            const handler = (event)=>{
+                setEvent(name);
+                var _event_data;
+                setData((_event_data = event.data) != null ? _event_data : null);
+            };
+            es.addEventListener(name, handler);
+            listeners == null ? void 0 : listeners.set(name, handler);
+        });
+    });
+    React.useEffect(()=>{
+        if (options.immediate !== false) {
+            open();
+        }
+        return close;
+    }, [
+        open,
+        close,
+        options.immediate
+    ]);
+    useUnmount(()=>{
+        close();
+    });
+    return {
+        eventSourceRef,
+        data,
+        error,
+        status,
+        lastEventId,
+        event,
+        close,
+        open
+    };
+};
+
+exports.assignRef = indexClient.assignRef;
+exports.mergeRefs = indexClient.mergeRefs;
+exports.useMergedRefs = indexClient.useMergedRefs;
 exports.defaultOptions = defaultOptions;
 exports.useActiveElement = useActiveElement;
 exports.useAsyncEffect = useAsyncEffect;
 exports.useClickOutside = useClickOutside;
 exports.useClipboard = useClipboard;
+exports.useControlled = useControlled;
 exports.useCookie = useCookie;
 exports.useCountDown = useCountDown;
 exports.useCounter = useCounter;
@@ -3338,6 +3506,7 @@ exports.useDarkMode = useDarkMode;
 exports.useDebounce = useDebounce;
 exports.useDebounceFn = useDebounceFn;
 exports.useDeepCompareEffect = useDeepCompareEffect;
+exports.useDisclosure = useDisclosure;
 exports.useDocumentVisibility = useDocumentVisibility;
 exports.useDoubleClick = useDoubleClick;
 exports.useDraggable = useDraggable;
@@ -3348,6 +3517,7 @@ exports.useElementVisibility = useElementVisibility;
 exports.useEvent = useEvent;
 exports.useEventEmitter = useEventEmitter;
 exports.useEventListener = useEventListener;
+exports.useEventSource = useEventSource;
 exports.useEyeDropper = useEyeDropper;
 exports.useFavicon = useFavicon;
 exports.useFileDialog = useFileDialog;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import react__default, { DependencyList, MutableRefObject, EffectCallback, Dispatch, SetStateAction, RefObject, useEffect, useLayoutEffect } from 'react';
+import react__default, { DependencyList, MutableRefObject, EffectCallback, Dispatch, SetStateAction, RefObject, useEffect, useLayoutEffect, Ref } from 'react';
 import Cookies from 'js-cookie';
 import { DebounceSettings, ThrottleSettings, DebouncedFunc as DebouncedFunc$1 } from 'lodash-es';
 import * as lodash from 'lodash';
@@ -2639,6 +2639,193 @@ declare const usePlatform: UsePlatform;
 
 declare const useMobileLandscape: () => boolean;
 
+/**
+ * @title useControlledState
+ * @returns_en A tuple with the following elements:
+ * - The current value.
+ * - A function to update the value.
+ * @returns 包含以下元素的元组：
+ * - 当前值。
+ * - 更新当前值的函数。
+ */
+type UseControlled = <T>(
+/**
+ * @en controlled value
+ * @zh 受控值
+ */
+value: T | undefined, 
+/**
+ * @en default value
+ * @zh 默认值
+ */
+defaultValue: T, 
+/**
+ * @en callback when value change
+ * @zh 值改变时的回调
+ */
+onChange?: ((v: T, ...args: any[]) => void) | undefined) => [T, (value: T) => void];
+
+declare const useControlled: UseControlled;
+
+/**
+ * @title UseDisclosureProps
+ */
+interface UseDisclosureProps {
+    /**
+     * @en Whether the disclosure is open, if passed, it will be controlled
+     * @zh 是否打开，传了则为受控
+     */
+    isOpen?: boolean;
+    /**
+     * @en default open state
+     * @zh 默认打开状态
+     */
+    defaultOpen?: boolean;
+    /**
+     * @en Callback when disclosure is closed
+     * @zh 关闭时的回调
+     */
+    onClose?: () => void;
+    /**
+     * @en Callback when disclosure is opened
+     * @zh 打开时的回调
+     */
+    onOpen?: () => void;
+    /**
+     * @en Callback when disclosure is changed
+     * @zh 状态改变时的回调
+     */
+    onChange?(isOpen: boolean | undefined): void;
+}
+/**
+ * @title useDisclosure
+ */
+type UseDisclosure = (props?: UseDisclosureProps) => {
+    isOpen: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    onOpenChange: () => void;
+    isControlled: boolean;
+};
+
+declare const useDisclosure: (props?: UseDisclosureProps) => {
+    isOpen: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    onOpenChange: () => void;
+    isControlled: boolean;
+};
+
+type EventSourceStatus = "CONNECTING" | "CONNECTED" | "DISCONNECTED";
+/**
+ * @title UseEventSourceOptions
+ */
+interface UseEventSourceOptions extends EventSourceInit {
+    /**
+     * @en immediately open the connection, enabled by default
+     * @zh 立即打开连接, 默认打开
+     */
+    immediate?: boolean;
+    /**
+     * @en Automatically reconnect when the connection is disconnected
+     * @zh 连接断开时自动重连
+     */
+    autoReconnect?: UseEventSourceAutoReconnectOptions;
+}
+/**
+ * @title UseEventSourceAutoReconnectOptions
+ */
+interface UseEventSourceAutoReconnectOptions {
+    /**
+     * @en The number of retries, if it is a function, it will be called to determine whether to retry
+     * @zh 重试次数，如果是函数，会调用来判断是否重试
+     */
+    retries?: number | (() => boolean);
+    /**
+     * @en The delay time before reconnecting
+     * @zh 重连前的延迟时间
+     */
+    delay?: number;
+    /**
+     * @en Callback when reconnection fails
+     * @zh 重连失败时的回调
+     */
+    onFailed?: () => void;
+}
+type UseEventSource = <Events extends string[]>(
+/**
+ * @en The URL of the server-sent event
+ * @zh 服务器发送事件的 URL
+ */
+url: string | URL, 
+/**
+ * @en The event name to listen to
+ * @zh 要监听的事件名
+ */
+events?: Events, 
+/**
+ * @en EventSource options
+ * @zh EventSource 选项
+ */
+options?: UseEventSourceOptions) => UseEventSourceReturn;
+/**
+ * @title UseEventSourceReturn
+ */
+interface UseEventSourceReturn {
+    /**
+     * @en EventSource instance
+     * @zh EventSource 实例
+     */
+    eventSourceRef: React.MutableRefObject<EventSource | null>;
+    /**
+     * @en The data received
+     * @zh 接收到的数据
+     */
+    data: string | null;
+    /**
+     * @en The error occurred
+     * @zh 发生的错误
+     */
+    error: Event | null;
+    /**
+     * @en The status of the connection
+     * @zh 连接的状态
+     */
+    status: EventSourceStatus;
+    /**
+     * @en The last event ID
+     * @zh 最后的事件 ID
+     */
+    lastEventId: string | null;
+    /**
+     * @en The event name
+     * @zh 事件名
+     */
+    event: string | null;
+    /**
+     * @zh 关闭连接
+     * @en Close the connection
+     */
+    close: () => void;
+    /**
+     * @zh 打开连接
+     *  @en Open the connection
+     */
+    open: () => void;
+}
+
+declare const useEventSource: UseEventSource;
+
+/**
+ * @title useMergedRef
+ */
+type UseMergedRef = <T>(...refs: PossibleRef<T>[]) => (node: T | null) => void;
+type PossibleRef<T> = Ref<T> | undefined;
+
+declare function assignRef<T>(ref: PossibleRef<T>, value: T): void;
+declare function mergeRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void;
+declare const useMergedRefs: <T>(...refs: PossibleRef<T>[]) => (node: T | null) => void;
+
 /**
  * @title useDocumentVisiblity
  * @returns_en document visibility
@@ -2991,4 +3178,4 @@ defauleValue?: boolean) => boolean;
  */
 type UseMobileLandscape = () => boolean;
 
-export { type ColorScheme, type Contrast, type DepsEqualFnType, type EventType, type INetworkInformation, type IUseNetworkState, type KeyModifier, type Pausable, type Platform, type UseActiveElement, type UseAsyncEffect, type UseClickOutside, type UseClipboard, type UseCookie, type UseCookieState, type UseCountDown, type UseCounter, type UseCssVar, type UseCssVarOptions, type UseCustomCompareEffect, type UseCycleList, type UseDarkMode, type UseDarkOptions, type UseDebounce, type UseDebounceFn, type UseDeepCompareEffect, type UseDocumentVisibility, type UseDoubleClick, type UseDoubleClickProps, type UseDraggable, type UseDraggableOptions, type UseDropZone, type UseElementBounding, type UseElementBoundingOptions, type UseElementBoundingReturn, type UseElementSize, type UseElementVisibility, type UseEvent, type UseEventEmitter, type UseEventEmitterDisposable, type UseEventEmitterEvent, type UseEventEmitterEventOnce, type UseEventEmitterListener, type UseEventEmitterReturn, type UseEventListener, type UseEyeDropper, type UseEyeDropperOpenOptions, type UseEyeDropperOpenReturnType, type UseFavicon, type UseFileDialog, type UseFileDialogOptions, type UseFirstMountState, type UseFocus, type UseFps, type UseFpsOptions, type UseFullScreenOptions, type UseFullscreen, type UseGeolocation, type UseHover, type UseIdle, type UseInfiniteScroll, type UseInfiniteScrollArrivedState, type UseInfiniteScrollDirection, type UseInfiniteScrollLoadMore, type UseInfiniteScrollOptions, type UseIntersectionObserver, type UseInterval, type UseIntervalOptions, type UseKeyModifier, type UseLatest, type UseLocalStorage, type UseLocalStorageOptions, type UseLocalStorageSerializer, type UseLocationSelector, type UseLongPress, type UseLongPressOptions, type UseMeasure, type UseMeasureRect, type UseMediaDeviceOptions, type UseMediaDevices, type UseMediaQuery, type UseMobileLandscape, type UseModifierOptions, type UseMount, type UseMountedState, type UseMouse, type UseMouseCursorState, type UseMousePressed, type UseMousePressedOptions, type UseMousePressedSourceType, type UseMutationObserver, type UseNetwork, type UseObjectUrl, type UseOnline, type UseOrientation, type UseOrientationLockType, type UseOrientationState, type UseOrientationType, type UsePageLeave, type UsePermission, type UsePermissionDescriptorNamePolyfill, type UsePermissionGeneralPermissionDescriptor, type UsePermissionState, type UsePlatform, type UsePlatformProps, type UsePlatformReturn, type UsePreferredColorScheme, type UsePreferredContrast, type UsePreferredDark, type UsePrevious, type UseRafFn, type UseRafState, type UseReducedMotion, type UseResizeObserver, type UseScreenSafeArea, type UseScriptTag, type UseScriptTagOptions, type UseScriptTagStatus, type UseScroll, type UseScrollArrivedState, type UseScrollDirection, type UseScrollIntoView, type UseScrollIntoViewAnimation, type UseScrollIntoViewParams, type UseScrollLock, type UseScrollOffset, type UseScrollOptions, type UseSessionStorage, type UseSessionStorageOptions, type UseSessionStorageSerializer, type UseSetState, type UseSticky, type UseStickyParams, type UseSupported, type UseTextDirection, type UseTextDirectionOptions, type UseTextDirectionValue, type UseTextSelection, type UseThrottle, type UseThrottleFn, type UseTimeout, type UseTimeoutFn, type UseTimeoutFnOptions, type UseTimeoutOptions, type UseTitle, type UseToggle, type UseUnmount, type UseUpdate, type UseWebNotification, type UseWebNotificationReturn, type UseWebNotificationShow, type UseWindowScroll, type UseWindowScrollState, type UseWindowSize, type UseWindowsFocus, defaultOptions, useActiveElement, useAsyncEffect, useClickOutside, useClipboard, useCookie, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEyeDropper, useFavicon, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMeasure, useMediaDevices, useMediaQuery, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };
+export { type ColorScheme, type Contrast, type DepsEqualFnType, type EventSourceStatus, type EventType, type INetworkInformation, type IUseNetworkState, type KeyModifier, type Pausable, type Platform, type PossibleRef, type UseActiveElement, type UseAsyncEffect, type UseClickOutside, type UseClipboard, type UseControlled, type UseCookie, type UseCookieState, type UseCountDown, type UseCounter, type UseCssVar, type UseCssVarOptions, type UseCustomCompareEffect, type UseCycleList, type UseDarkMode, type UseDarkOptions, type UseDebounce, type UseDebounceFn, type UseDeepCompareEffect, type UseDisclosure, type UseDisclosureProps, type UseDocumentVisibility, type UseDoubleClick, type UseDoubleClickProps, type UseDraggable, type UseDraggableOptions, type UseDropZone, type UseElementBounding, type UseElementBoundingOptions, type UseElementBoundingReturn, type UseElementSize, type UseElementVisibility, type UseEvent, type UseEventEmitter, type UseEventEmitterDisposable, type UseEventEmitterEvent, type UseEventEmitterEventOnce, type UseEventEmitterListener, type UseEventEmitterReturn, type UseEventListener, type UseEventSource, type UseEventSourceAutoReconnectOptions, type UseEventSourceOptions, type UseEventSourceReturn, type UseEyeDropper, type UseEyeDropperOpenOptions, type UseEyeDropperOpenReturnType, type UseFavicon, type UseFileDialog, type UseFileDialogOptions, type UseFirstMountState, type UseFocus, type UseFps, type UseFpsOptions, type UseFullScreenOptions, type UseFullscreen, type UseGeolocation, type UseHover, type UseIdle, type UseInfiniteScroll, type UseInfiniteScrollArrivedState, type UseInfiniteScrollDirection, type UseInfiniteScrollLoadMore, type UseInfiniteScrollOptions, type UseIntersectionObserver, type UseInterval, type UseIntervalOptions, type UseKeyModifier, type UseLatest, type UseLocalStorage, type UseLocalStorageOptions, type UseLocalStorageSerializer, type UseLocationSelector, type UseLongPress, type UseLongPressOptions, type UseMeasure, type UseMeasureRect, type UseMediaDeviceOptions, type UseMediaDevices, type UseMediaQuery, type UseMergedRef, type UseMobileLandscape, type UseModifierOptions, type UseMount, type UseMountedState, type UseMouse, type UseMouseCursorState, type UseMousePressed, type UseMousePressedOptions, type UseMousePressedSourceType, type UseMutationObserver, type UseNetwork, type UseObjectUrl, type UseOnline, type UseOrientation, type UseOrientationLockType, type UseOrientationState, type UseOrientationType, type UsePageLeave, type UsePermission, type UsePermissionDescriptorNamePolyfill, type UsePermissionGeneralPermissionDescriptor, type UsePermissionState, type UsePlatform, type UsePlatformProps, type UsePlatformReturn, type UsePreferredColorScheme, type UsePreferredContrast, type UsePreferredDark, type UsePrevious, type UseRafFn, type UseRafState, type UseReducedMotion, type UseResizeObserver, type UseScreenSafeArea, type UseScriptTag, type UseScriptTagOptions, type UseScriptTagStatus, type UseScroll, type UseScrollArrivedState, type UseScrollDirection, type UseScrollIntoView, type UseScrollIntoViewAnimation, type UseScrollIntoViewParams, type UseScrollLock, type UseScrollOffset, type UseScrollOptions, type UseSessionStorage, type UseSessionStorageOptions, type UseSessionStorageSerializer, type UseSetState, type UseSticky, type UseStickyParams, type UseSupported, type UseTextDirection, type UseTextDirectionOptions, type UseTextDirectionValue, type UseTextSelection, type UseThrottle, type UseThrottleFn, type UseTimeout, type UseTimeoutFn, type UseTimeoutFnOptions, type UseTimeoutOptions, type UseTitle, type UseToggle, type UseUnmount, type UseUpdate, type UseWebNotification, type UseWebNotificationReturn, type UseWebNotificationShow, type UseWindowScroll, type UseWindowScrollState, type UseWindowSize, type UseWindowsFocus, assignRef, defaultOptions, mergeRefs, useActiveElement, useAsyncEffect, useClickOutside, useClipboard, useControlled, useCookie, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDisclosure, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEventSource, useEyeDropper, useFavicon, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMeasure, useMediaDevices, useMediaQuery, useMergedRefs, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import react__default, { DependencyList, MutableRefObject, EffectCallback, Dispatch, SetStateAction, RefObject, useEffect, useLayoutEffect } from 'react';
+import react__default, { DependencyList, MutableRefObject, EffectCallback, Dispatch, SetStateAction, RefObject, useEffect, useLayoutEffect, Ref } from 'react';
 import Cookies from 'js-cookie';
 import { DebounceSettings, ThrottleSettings, DebouncedFunc as DebouncedFunc$1 } from 'lodash-es';
 import * as lodash from 'lodash';
@@ -2639,6 +2639,193 @@ declare const usePlatform: UsePlatform;
 
 declare const useMobileLandscape: () => boolean;
 
+/**
+ * @title useControlledState
+ * @returns_en A tuple with the following elements:
+ * - The current value.
+ * - A function to update the value.
+ * @returns 包含以下元素的元组：
+ * - 当前值。
+ * - 更新当前值的函数。
+ */
+type UseControlled = <T>(
+/**
+ * @en controlled value
+ * @zh 受控值
+ */
+value: T | undefined, 
+/**
+ * @en default value
+ * @zh 默认值
+ */
+defaultValue: T, 
+/**
+ * @en callback when value change
+ * @zh 值改变时的回调
+ */
+onChange?: ((v: T, ...args: any[]) => void) | undefined) => [T, (value: T) => void];
+
+declare const useControlled: UseControlled;
+
+/**
+ * @title UseDisclosureProps
+ */
+interface UseDisclosureProps {
+    /**
+     * @en Whether the disclosure is open, if passed, it will be controlled
+     * @zh 是否打开，传了则为受控
+     */
+    isOpen?: boolean;
+    /**
+     * @en default open state
+     * @zh 默认打开状态
+     */
+    defaultOpen?: boolean;
+    /**
+     * @en Callback when disclosure is closed
+     * @zh 关闭时的回调
+     */
+    onClose?: () => void;
+    /**
+     * @en Callback when disclosure is opened
+     * @zh 打开时的回调
+     */
+    onOpen?: () => void;
+    /**
+     * @en Callback when disclosure is changed
+     * @zh 状态改变时的回调
+     */
+    onChange?(isOpen: boolean | undefined): void;
+}
+/**
+ * @title useDisclosure
+ */
+type UseDisclosure = (props?: UseDisclosureProps) => {
+    isOpen: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    onOpenChange: () => void;
+    isControlled: boolean;
+};
+
+declare const useDisclosure: (props?: UseDisclosureProps) => {
+    isOpen: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    onOpenChange: () => void;
+    isControlled: boolean;
+};
+
+type EventSourceStatus = "CONNECTING" | "CONNECTED" | "DISCONNECTED";
+/**
+ * @title UseEventSourceOptions
+ */
+interface UseEventSourceOptions extends EventSourceInit {
+    /**
+     * @en immediately open the connection, enabled by default
+     * @zh 立即打开连接, 默认打开
+     */
+    immediate?: boolean;
+    /**
+     * @en Automatically reconnect when the connection is disconnected
+     * @zh 连接断开时自动重连
+     */
+    autoReconnect?: UseEventSourceAutoReconnectOptions;
+}
+/**
+ * @title UseEventSourceAutoReconnectOptions
+ */
+interface UseEventSourceAutoReconnectOptions {
+    /**
+     * @en The number of retries, if it is a function, it will be called to determine whether to retry
+     * @zh 重试次数，如果是函数，会调用来判断是否重试
+     */
+    retries?: number | (() => boolean);
+    /**
+     * @en The delay time before reconnecting
+     * @zh 重连前的延迟时间
+     */
+    delay?: number;
+    /**
+     * @en Callback when reconnection fails
+     * @zh 重连失败时的回调
+     */
+    onFailed?: () => void;
+}
+type UseEventSource = <Events extends string[]>(
+/**
+ * @en The URL of the server-sent event
+ * @zh 服务器发送事件的 URL
+ */
+url: string | URL, 
+/**
+ * @en The event name to listen to
+ * @zh 要监听的事件名
+ */
+events?: Events, 
+/**
+ * @en EventSource options
+ * @zh EventSource 选项
+ */
+options?: UseEventSourceOptions) => UseEventSourceReturn;
+/**
+ * @title UseEventSourceReturn
+ */
+interface UseEventSourceReturn {
+    /**
+     * @en EventSource instance
+     * @zh EventSource 实例
+     */
+    eventSourceRef: React.MutableRefObject<EventSource | null>;
+    /**
+     * @en The data received
+     * @zh 接收到的数据
+     */
+    data: string | null;
+    /**
+     * @en The error occurred
+     * @zh 发生的错误
+     */
+    error: Event | null;
+    /**
+     * @en The status of the connection
+     * @zh 连接的状态
+     */
+    status: EventSourceStatus;
+    /**
+     * @en The last event ID
+     * @zh 最后的事件 ID
+     */
+    lastEventId: string | null;
+    /**
+     * @en The event name
+     * @zh 事件名
+     */
+    event: string | null;
+    /**
+     * @zh 关闭连接
+     * @en Close the connection
+     */
+    close: () => void;
+    /**
+     * @zh 打开连接
+     *  @en Open the connection
+     */
+    open: () => void;
+}
+
+declare const useEventSource: UseEventSource;
+
+/**
+ * @title useMergedRef
+ */
+type UseMergedRef = <T>(...refs: PossibleRef<T>[]) => (node: T | null) => void;
+type PossibleRef<T> = Ref<T> | undefined;
+
+declare function assignRef<T>(ref: PossibleRef<T>, value: T): void;
+declare function mergeRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void;
+declare const useMergedRefs: <T>(...refs: PossibleRef<T>[]) => (node: T | null) => void;
+
 /**
  * @title useDocumentVisiblity
  * @returns_en document visibility
@@ -2991,4 +3178,4 @@ defauleValue?: boolean) => boolean;
  */
 type UseMobileLandscape = () => boolean;
 
-export { type ColorScheme, type Contrast, type DepsEqualFnType, type EventType, type INetworkInformation, type IUseNetworkState, type KeyModifier, type Pausable, type Platform, type UseActiveElement, type UseAsyncEffect, type UseClickOutside, type UseClipboard, type UseCookie, type UseCookieState, type UseCountDown, type UseCounter, type UseCssVar, type UseCssVarOptions, type UseCustomCompareEffect, type UseCycleList, type UseDarkMode, type UseDarkOptions, type UseDebounce, type UseDebounceFn, type UseDeepCompareEffect, type UseDocumentVisibility, type UseDoubleClick, type UseDoubleClickProps, type UseDraggable, type UseDraggableOptions, type UseDropZone, type UseElementBounding, type UseElementBoundingOptions, type UseElementBoundingReturn, type UseElementSize, type UseElementVisibility, type UseEvent, type UseEventEmitter, type UseEventEmitterDisposable, type UseEventEmitterEvent, type UseEventEmitterEventOnce, type UseEventEmitterListener, type UseEventEmitterReturn, type UseEventListener, type UseEyeDropper, type UseEyeDropperOpenOptions, type UseEyeDropperOpenReturnType, type UseFavicon, type UseFileDialog, type UseFileDialogOptions, type UseFirstMountState, type UseFocus, type UseFps, type UseFpsOptions, type UseFullScreenOptions, type UseFullscreen, type UseGeolocation, type UseHover, type UseIdle, type UseInfiniteScroll, type UseInfiniteScrollArrivedState, type UseInfiniteScrollDirection, type UseInfiniteScrollLoadMore, type UseInfiniteScrollOptions, type UseIntersectionObserver, type UseInterval, type UseIntervalOptions, type UseKeyModifier, type UseLatest, type UseLocalStorage, type UseLocalStorageOptions, type UseLocalStorageSerializer, type UseLocationSelector, type UseLongPress, type UseLongPressOptions, type UseMeasure, type UseMeasureRect, type UseMediaDeviceOptions, type UseMediaDevices, type UseMediaQuery, type UseMobileLandscape, type UseModifierOptions, type UseMount, type UseMountedState, type UseMouse, type UseMouseCursorState, type UseMousePressed, type UseMousePressedOptions, type UseMousePressedSourceType, type UseMutationObserver, type UseNetwork, type UseObjectUrl, type UseOnline, type UseOrientation, type UseOrientationLockType, type UseOrientationState, type UseOrientationType, type UsePageLeave, type UsePermission, type UsePermissionDescriptorNamePolyfill, type UsePermissionGeneralPermissionDescriptor, type UsePermissionState, type UsePlatform, type UsePlatformProps, type UsePlatformReturn, type UsePreferredColorScheme, type UsePreferredContrast, type UsePreferredDark, type UsePrevious, type UseRafFn, type UseRafState, type UseReducedMotion, type UseResizeObserver, type UseScreenSafeArea, type UseScriptTag, type UseScriptTagOptions, type UseScriptTagStatus, type UseScroll, type UseScrollArrivedState, type UseScrollDirection, type UseScrollIntoView, type UseScrollIntoViewAnimation, type UseScrollIntoViewParams, type UseScrollLock, type UseScrollOffset, type UseScrollOptions, type UseSessionStorage, type UseSessionStorageOptions, type UseSessionStorageSerializer, type UseSetState, type UseSticky, type UseStickyParams, type UseSupported, type UseTextDirection, type UseTextDirectionOptions, type UseTextDirectionValue, type UseTextSelection, type UseThrottle, type UseThrottleFn, type UseTimeout, type UseTimeoutFn, type UseTimeoutFnOptions, type UseTimeoutOptions, type UseTitle, type UseToggle, type UseUnmount, type UseUpdate, type UseWebNotification, type UseWebNotificationReturn, type UseWebNotificationShow, type UseWindowScroll, type UseWindowScrollState, type UseWindowSize, type UseWindowsFocus, defaultOptions, useActiveElement, useAsyncEffect, useClickOutside, useClipboard, useCookie, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEyeDropper, useFavicon, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMeasure, useMediaDevices, useMediaQuery, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };
+export { type ColorScheme, type Contrast, type DepsEqualFnType, type EventSourceStatus, type EventType, type INetworkInformation, type IUseNetworkState, type KeyModifier, type Pausable, type Platform, type PossibleRef, type UseActiveElement, type UseAsyncEffect, type UseClickOutside, type UseClipboard, type UseControlled, type UseCookie, type UseCookieState, type UseCountDown, type UseCounter, type UseCssVar, type UseCssVarOptions, type UseCustomCompareEffect, type UseCycleList, type UseDarkMode, type UseDarkOptions, type UseDebounce, type UseDebounceFn, type UseDeepCompareEffect, type UseDisclosure, type UseDisclosureProps, type UseDocumentVisibility, type UseDoubleClick, type UseDoubleClickProps, type UseDraggable, type UseDraggableOptions, type UseDropZone, type UseElementBounding, type UseElementBoundingOptions, type UseElementBoundingReturn, type UseElementSize, type UseElementVisibility, type UseEvent, type UseEventEmitter, type UseEventEmitterDisposable, type UseEventEmitterEvent, type UseEventEmitterEventOnce, type UseEventEmitterListener, type UseEventEmitterReturn, type UseEventListener, type UseEventSource, type UseEventSourceAutoReconnectOptions, type UseEventSourceOptions, type UseEventSourceReturn, type UseEyeDropper, type UseEyeDropperOpenOptions, type UseEyeDropperOpenReturnType, type UseFavicon, type UseFileDialog, type UseFileDialogOptions, type UseFirstMountState, type UseFocus, type UseFps, type UseFpsOptions, type UseFullScreenOptions, type UseFullscreen, type UseGeolocation, type UseHover, type UseIdle, type UseInfiniteScroll, type UseInfiniteScrollArrivedState, type UseInfiniteScrollDirection, type UseInfiniteScrollLoadMore, type UseInfiniteScrollOptions, type UseIntersectionObserver, type UseInterval, type UseIntervalOptions, type UseKeyModifier, type UseLatest, type UseLocalStorage, type UseLocalStorageOptions, type UseLocalStorageSerializer, type UseLocationSelector, type UseLongPress, type UseLongPressOptions, type UseMeasure, type UseMeasureRect, type UseMediaDeviceOptions, type UseMediaDevices, type UseMediaQuery, type UseMergedRef, type UseMobileLandscape, type UseModifierOptions, type UseMount, type UseMountedState, type UseMouse, type UseMouseCursorState, type UseMousePressed, type UseMousePressedOptions, type UseMousePressedSourceType, type UseMutationObserver, type UseNetwork, type UseObjectUrl, type UseOnline, type UseOrientation, type UseOrientationLockType, type UseOrientationState, type UseOrientationType, type UsePageLeave, type UsePermission, type UsePermissionDescriptorNamePolyfill, type UsePermissionGeneralPermissionDescriptor, type UsePermissionState, type UsePlatform, type UsePlatformProps, type UsePlatformReturn, type UsePreferredColorScheme, type UsePreferredContrast, type UsePreferredDark, type UsePrevious, type UseRafFn, type UseRafState, type UseReducedMotion, type UseResizeObserver, type UseScreenSafeArea, type UseScriptTag, type UseScriptTagOptions, type UseScriptTagStatus, type UseScroll, type UseScrollArrivedState, type UseScrollDirection, type UseScrollIntoView, type UseScrollIntoViewAnimation, type UseScrollIntoViewParams, type UseScrollLock, type UseScrollOffset, type UseScrollOptions, type UseSessionStorage, type UseSessionStorageOptions, type UseSessionStorageSerializer, type UseSetState, type UseSticky, type UseStickyParams, type UseSupported, type UseTextDirection, type UseTextDirectionOptions, type UseTextDirectionValue, type UseTextSelection, type UseThrottle, type UseThrottleFn, type UseTimeout, type UseTimeoutFn, type UseTimeoutFnOptions, type UseTimeoutOptions, type UseTitle, type UseToggle, type UseUnmount, type UseUpdate, type UseWebNotification, type UseWebNotificationReturn, type UseWebNotificationShow, type UseWindowScroll, type UseWindowScrollState, type UseWindowSize, type UseWindowsFocus, assignRef, defaultOptions, mergeRefs, useActiveElement, useAsyncEffect, useClickOutside, useClipboard, useControlled, useCookie, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDisclosure, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEventSource, useEyeDropper, useFavicon, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMeasure, useMediaDevices, useMediaQuery, useMergedRefs, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import react__default, { DependencyList, MutableRefObject, EffectCallback, Dispatch, SetStateAction, RefObject, useEffect, useLayoutEffect } from 'react';
+import react__default, { DependencyList, MutableRefObject, EffectCallback, Dispatch, SetStateAction, RefObject, useEffect, useLayoutEffect, Ref } from 'react';
 import Cookies from 'js-cookie';
 import { DebounceSettings, ThrottleSettings, DebouncedFunc as DebouncedFunc$1 } from 'lodash-es';
 import * as lodash from 'lodash';
@@ -2639,6 +2639,193 @@ declare const usePlatform: UsePlatform;
 
 declare const useMobileLandscape: () => boolean;
 
+/**
+ * @title useControlledState
+ * @returns_en A tuple with the following elements:
+ * - The current value.
+ * - A function to update the value.
+ * @returns 包含以下元素的元组：
+ * - 当前值。
+ * - 更新当前值的函数。
+ */
+type UseControlled = <T>(
+/**
+ * @en controlled value
+ * @zh 受控值
+ */
+value: T | undefined, 
+/**
+ * @en default value
+ * @zh 默认值
+ */
+defaultValue: T, 
+/**
+ * @en callback when value change
+ * @zh 值改变时的回调
+ */
+onChange?: ((v: T, ...args: any[]) => void) | undefined) => [T, (value: T) => void];
+
+declare const useControlled: UseControlled;
+
+/**
+ * @title UseDisclosureProps
+ */
+interface UseDisclosureProps {
+    /**
+     * @en Whether the disclosure is open, if passed, it will be controlled
+     * @zh 是否打开，传了则为受控
+     */
+    isOpen?: boolean;
+    /**
+     * @en default open state
+     * @zh 默认打开状态
+     */
+    defaultOpen?: boolean;
+    /**
+     * @en Callback when disclosure is closed
+     * @zh 关闭时的回调
+     */
+    onClose?: () => void;
+    /**
+     * @en Callback when disclosure is opened
+     * @zh 打开时的回调
+     */
+    onOpen?: () => void;
+    /**
+     * @en Callback when disclosure is changed
+     * @zh 状态改变时的回调
+     */
+    onChange?(isOpen: boolean | undefined): void;
+}
+/**
+ * @title useDisclosure
+ */
+type UseDisclosure = (props?: UseDisclosureProps) => {
+    isOpen: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    onOpenChange: () => void;
+    isControlled: boolean;
+};
+
+declare const useDisclosure: (props?: UseDisclosureProps) => {
+    isOpen: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    onOpenChange: () => void;
+    isControlled: boolean;
+};
+
+type EventSourceStatus = "CONNECTING" | "CONNECTED" | "DISCONNECTED";
+/**
+ * @title UseEventSourceOptions
+ */
+interface UseEventSourceOptions extends EventSourceInit {
+    /**
+     * @en immediately open the connection, enabled by default
+     * @zh 立即打开连接, 默认打开
+     */
+    immediate?: boolean;
+    /**
+     * @en Automatically reconnect when the connection is disconnected
+     * @zh 连接断开时自动重连
+     */
+    autoReconnect?: UseEventSourceAutoReconnectOptions;
+}
+/**
+ * @title UseEventSourceAutoReconnectOptions
+ */
+interface UseEventSourceAutoReconnectOptions {
+    /**
+     * @en The number of retries, if it is a function, it will be called to determine whether to retry
+     * @zh 重试次数，如果是函数，会调用来判断是否重试
+     */
+    retries?: number | (() => boolean);
+    /**
+     * @en The delay time before reconnecting
+     * @zh 重连前的延迟时间
+     */
+    delay?: number;
+    /**
+     * @en Callback when reconnection fails
+     * @zh 重连失败时的回调
+     */
+    onFailed?: () => void;
+}
+type UseEventSource = <Events extends string[]>(
+/**
+ * @en The URL of the server-sent event
+ * @zh 服务器发送事件的 URL
+ */
+url: string | URL, 
+/**
+ * @en The event name to listen to
+ * @zh 要监听的事件名
+ */
+events?: Events, 
+/**
+ * @en EventSource options
+ * @zh EventSource 选项
+ */
+options?: UseEventSourceOptions) => UseEventSourceReturn;
+/**
+ * @title UseEventSourceReturn
+ */
+interface UseEventSourceReturn {
+    /**
+     * @en EventSource instance
+     * @zh EventSource 实例
+     */
+    eventSourceRef: React.MutableRefObject<EventSource | null>;
+    /**
+     * @en The data received
+     * @zh 接收到的数据
+     */
+    data: string | null;
+    /**
+     * @en The error occurred
+     * @zh 发生的错误
+     */
+    error: Event | null;
+    /**
+     * @en The status of the connection
+     * @zh 连接的状态
+     */
+    status: EventSourceStatus;
+    /**
+     * @en The last event ID
+     * @zh 最后的事件 ID
+     */
+    lastEventId: string | null;
+    /**
+     * @en The event name
+     * @zh 事件名
+     */
+    event: string | null;
+    /**
+     * @zh 关闭连接
+     * @en Close the connection
+     */
+    close: () => void;
+    /**
+     * @zh 打开连接
+     *  @en Open the connection
+     */
+    open: () => void;
+}
+
+declare const useEventSource: UseEventSource;
+
+/**
+ * @title useMergedRef
+ */
+type UseMergedRef = <T>(...refs: PossibleRef<T>[]) => (node: T | null) => void;
+type PossibleRef<T> = Ref<T> | undefined;
+
+declare function assignRef<T>(ref: PossibleRef<T>, value: T): void;
+declare function mergeRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void;
+declare const useMergedRefs: <T>(...refs: PossibleRef<T>[]) => (node: T | null) => void;
+
 /**
  * @title useDocumentVisiblity
  * @returns_en document visibility
@@ -2991,4 +3178,4 @@ defauleValue?: boolean) => boolean;
  */
 type UseMobileLandscape = () => boolean;
 
-export { type ColorScheme, type Contrast, type DepsEqualFnType, type EventType, type INetworkInformation, type IUseNetworkState, type KeyModifier, type Pausable, type Platform, type UseActiveElement, type UseAsyncEffect, type UseClickOutside, type UseClipboard, type UseCookie, type UseCookieState, type UseCountDown, type UseCounter, type UseCssVar, type UseCssVarOptions, type UseCustomCompareEffect, type UseCycleList, type UseDarkMode, type UseDarkOptions, type UseDebounce, type UseDebounceFn, type UseDeepCompareEffect, type UseDocumentVisibility, type UseDoubleClick, type UseDoubleClickProps, type UseDraggable, type UseDraggableOptions, type UseDropZone, type UseElementBounding, type UseElementBoundingOptions, type UseElementBoundingReturn, type UseElementSize, type UseElementVisibility, type UseEvent, type UseEventEmitter, type UseEventEmitterDisposable, type UseEventEmitterEvent, type UseEventEmitterEventOnce, type UseEventEmitterListener, type UseEventEmitterReturn, type UseEventListener, type UseEyeDropper, type UseEyeDropperOpenOptions, type UseEyeDropperOpenReturnType, type UseFavicon, type UseFileDialog, type UseFileDialogOptions, type UseFirstMountState, type UseFocus, type UseFps, type UseFpsOptions, type UseFullScreenOptions, type UseFullscreen, type UseGeolocation, type UseHover, type UseIdle, type UseInfiniteScroll, type UseInfiniteScrollArrivedState, type UseInfiniteScrollDirection, type UseInfiniteScrollLoadMore, type UseInfiniteScrollOptions, type UseIntersectionObserver, type UseInterval, type UseIntervalOptions, type UseKeyModifier, type UseLatest, type UseLocalStorage, type UseLocalStorageOptions, type UseLocalStorageSerializer, type UseLocationSelector, type UseLongPress, type UseLongPressOptions, type UseMeasure, type UseMeasureRect, type UseMediaDeviceOptions, type UseMediaDevices, type UseMediaQuery, type UseMobileLandscape, type UseModifierOptions, type UseMount, type UseMountedState, type UseMouse, type UseMouseCursorState, type UseMousePressed, type UseMousePressedOptions, type UseMousePressedSourceType, type UseMutationObserver, type UseNetwork, type UseObjectUrl, type UseOnline, type UseOrientation, type UseOrientationLockType, type UseOrientationState, type UseOrientationType, type UsePageLeave, type UsePermission, type UsePermissionDescriptorNamePolyfill, type UsePermissionGeneralPermissionDescriptor, type UsePermissionState, type UsePlatform, type UsePlatformProps, type UsePlatformReturn, type UsePreferredColorScheme, type UsePreferredContrast, type UsePreferredDark, type UsePrevious, type UseRafFn, type UseRafState, type UseReducedMotion, type UseResizeObserver, type UseScreenSafeArea, type UseScriptTag, type UseScriptTagOptions, type UseScriptTagStatus, type UseScroll, type UseScrollArrivedState, type UseScrollDirection, type UseScrollIntoView, type UseScrollIntoViewAnimation, type UseScrollIntoViewParams, type UseScrollLock, type UseScrollOffset, type UseScrollOptions, type UseSessionStorage, type UseSessionStorageOptions, type UseSessionStorageSerializer, type UseSetState, type UseSticky, type UseStickyParams, type UseSupported, type UseTextDirection, type UseTextDirectionOptions, type UseTextDirectionValue, type UseTextSelection, type UseThrottle, type UseThrottleFn, type UseTimeout, type UseTimeoutFn, type UseTimeoutFnOptions, type UseTimeoutOptions, type UseTitle, type UseToggle, type UseUnmount, type UseUpdate, type UseWebNotification, type UseWebNotificationReturn, type UseWebNotificationShow, type UseWindowScroll, type UseWindowScrollState, type UseWindowSize, type UseWindowsFocus, defaultOptions, useActiveElement, useAsyncEffect, useClickOutside, useClipboard, useCookie, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEyeDropper, useFavicon, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMeasure, useMediaDevices, useMediaQuery, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };
+export { type ColorScheme, type Contrast, type DepsEqualFnType, type EventSourceStatus, type EventType, type INetworkInformation, type IUseNetworkState, type KeyModifier, type Pausable, type Platform, type PossibleRef, type UseActiveElement, type UseAsyncEffect, type UseClickOutside, type UseClipboard, type UseControlled, type UseCookie, type UseCookieState, type UseCountDown, type UseCounter, type UseCssVar, type UseCssVarOptions, type UseCustomCompareEffect, type UseCycleList, type UseDarkMode, type UseDarkOptions, type UseDebounce, type UseDebounceFn, type UseDeepCompareEffect, type UseDisclosure, type UseDisclosureProps, type UseDocumentVisibility, type UseDoubleClick, type UseDoubleClickProps, type UseDraggable, type UseDraggableOptions, type UseDropZone, type UseElementBounding, type UseElementBoundingOptions, type UseElementBoundingReturn, type UseElementSize, type UseElementVisibility, type UseEvent, type UseEventEmitter, type UseEventEmitterDisposable, type UseEventEmitterEvent, type UseEventEmitterEventOnce, type UseEventEmitterListener, type UseEventEmitterReturn, type UseEventListener, type UseEventSource, type UseEventSourceAutoReconnectOptions, type UseEventSourceOptions, type UseEventSourceReturn, type UseEyeDropper, type UseEyeDropperOpenOptions, type UseEyeDropperOpenReturnType, type UseFavicon, type UseFileDialog, type UseFileDialogOptions, type UseFirstMountState, type UseFocus, type UseFps, type UseFpsOptions, type UseFullScreenOptions, type UseFullscreen, type UseGeolocation, type UseHover, type UseIdle, type UseInfiniteScroll, type UseInfiniteScrollArrivedState, type UseInfiniteScrollDirection, type UseInfiniteScrollLoadMore, type UseInfiniteScrollOptions, type UseIntersectionObserver, type UseInterval, type UseIntervalOptions, type UseKeyModifier, type UseLatest, type UseLocalStorage, type UseLocalStorageOptions, type UseLocalStorageSerializer, type UseLocationSelector, type UseLongPress, type UseLongPressOptions, type UseMeasure, type UseMeasureRect, type UseMediaDeviceOptions, type UseMediaDevices, type UseMediaQuery, type UseMergedRef, type UseMobileLandscape, type UseModifierOptions, type UseMount, type UseMountedState, type UseMouse, type UseMouseCursorState, type UseMousePressed, type UseMousePressedOptions, type UseMousePressedSourceType, type UseMutationObserver, type UseNetwork, type UseObjectUrl, type UseOnline, type UseOrientation, type UseOrientationLockType, type UseOrientationState, type UseOrientationType, type UsePageLeave, type UsePermission, type UsePermissionDescriptorNamePolyfill, type UsePermissionGeneralPermissionDescriptor, type UsePermissionState, type UsePlatform, type UsePlatformProps, type UsePlatformReturn, type UsePreferredColorScheme, type UsePreferredContrast, type UsePreferredDark, type UsePrevious, type UseRafFn, type UseRafState, type UseReducedMotion, type UseResizeObserver, type UseScreenSafeArea, type UseScriptTag, type UseScriptTagOptions, type UseScriptTagStatus, type UseScroll, type UseScrollArrivedState, type UseScrollDirection, type UseScrollIntoView, type UseScrollIntoViewAnimation, type UseScrollIntoViewParams, type UseScrollLock, type UseScrollOffset, type UseScrollOptions, type UseSessionStorage, type UseSessionStorageOptions, type UseSessionStorageSerializer, type UseSetState, type UseSticky, type UseStickyParams, type UseSupported, type UseTextDirection, type UseTextDirectionOptions, type UseTextDirectionValue, type UseTextSelection, type UseThrottle, type UseThrottleFn, type UseTimeout, type UseTimeoutFn, type UseTimeoutFnOptions, type UseTimeoutOptions, type UseTitle, type UseToggle, type UseUnmount, type UseUpdate, type UseWebNotification, type UseWebNotificationReturn, type UseWebNotificationShow, type UseWindowScroll, type UseWindowScrollState, type UseWindowSize, type UseWindowsFocus, assignRef, defaultOptions, mergeRefs, useActiveElement, useAsyncEffect, useClickOutside, useClipboard, useControlled, useCookie, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDisclosure, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEventSource, useEyeDropper, useFavicon, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMeasure, useMediaDevices, useMediaQuery, useMergedRefs, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };

package/dist/index.mjs

@@ -3,6 +3,7 @@ import { isEqual, debounce, throttle } from 'lodash-es';
 import Cookies from 'js-cookie';
 import screenfull from 'screenfull';
 import { useSyncExternalStore } from 'use-sync-external-store/shim/index.js';
+export { a as assignRef, m as mergeRefs, u as useMergedRefs } from './index-client-KksAIxbB.js';
 
 const useLatest = (value)=>{
     const ref = useRef(value);
@@ -3316,4 +3317,167 @@ const useMobileLandscape = ()=>{
     return isMobileLandscape;
 };
 
-export { defaultOptions, useActiveElement, useAsyncEffect, useClickOutside, useClipboard, useCookie, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEyeDropper, useFavicon, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMeasure, useMediaDevices, useMediaQuery, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };
+const useControlled = (value, defaultValue, onChange)=>{
+    const [stateValue, setStateValue] = useState(value !== undefined ? value : defaultValue);
+    const isControlled = value !== undefined;
+    const onChangeRef = useLatest(onChange);
+    const setValue = useCallback((newValue)=>{
+        if (!isControlled) {
+            setStateValue(newValue);
+        }
+        onChangeRef.current == null ? void 0 : onChangeRef.current.call(onChangeRef, newValue);
+    }, [
+        isControlled,
+        onChangeRef
+    ]);
+    return [
+        isControlled ? value : stateValue,
+        setValue
+    ];
+};
+
+const useDisclosure = (props = {})=>{
+    const { defaultOpen, isOpen: isOpenProp, onClose: onCloseProp, onOpen: onOpenProp, onChange = ()=>{} } = props;
+    const onOpenPropRef = useLatest(onOpenProp);
+    const onClosePropRef = useLatest(onCloseProp);
+    const [isOpen, setIsOpen] = useControlled(isOpenProp, defaultOpen || false, onChange);
+    const isControlled = isOpenProp !== undefined;
+    const onClose = useCallback(()=>{
+        if (!isControlled) {
+            setIsOpen(false);
+        }
+        onClosePropRef.current == null ? void 0 : onClosePropRef.current.call(onClosePropRef);
+    }, [
+        isControlled,
+        onClosePropRef,
+        setIsOpen
+    ]);
+    const onOpen = useCallback(()=>{
+        if (!isControlled) {
+            setIsOpen(true);
+        }
+        onOpenPropRef.current == null ? void 0 : onOpenPropRef.current.call(onOpenPropRef);
+    }, [
+        isControlled,
+        onOpenPropRef,
+        setIsOpen
+    ]);
+    const onOpenChange = useCallback(()=>{
+        const action = isOpen ? onClose : onOpen;
+        action();
+    }, [
+        isOpen,
+        onOpen,
+        onClose
+    ]);
+    return {
+        isOpen: !!isOpen,
+        onOpen,
+        onClose,
+        onOpenChange,
+        isControlled
+    };
+};
+
+const useEventSource = (url, events = [], options = defaultOptions$1)=>{
+    const [data, setData] = useState(null);
+    const [error, setError] = useState(null);
+    const [status, setStatus] = useState("DISCONNECTED");
+    const [event, setEvent] = useState(null);
+    const [lastEventId, setLastEventId] = useState(null);
+    const retries = useRef(0);
+    const explicitlyClosed = useRef(false);
+    const eventSourceRef = useRef(null);
+    const eventListenerRef = useRef();
+    if (!eventListenerRef.current) {
+        eventListenerRef.current = new Map();
+    }
+    const clean = useEvent(()=>{
+        const listeners = eventListenerRef.current;
+        events.forEach((name)=>{
+            const handler = listeners == null ? void 0 : listeners.get(name);
+            if (handler) {
+                var _eventSourceRef_current;
+                (_eventSourceRef_current = eventSourceRef.current) == null ? void 0 : _eventSourceRef_current.removeEventListener(name, handler);
+            }
+        });
+    });
+    const close = useCallback(()=>{
+        var _eventSourceRef_current;
+        setStatus("DISCONNECTED");
+        clean();
+        (_eventSourceRef_current = eventSourceRef.current) == null ? void 0 : _eventSourceRef_current.close();
+        eventSourceRef.current = null;
+        explicitlyClosed.current = true;
+    }, [
+        clean
+    ]);
+    const open = useEvent(()=>{
+        close();
+        explicitlyClosed.current = false;
+        retries.current = 0;
+        if (!eventSourceRef.current) {
+            eventSourceRef.current = new EventSource(url, {
+                withCredentials: options.withCredentials
+            });
+        }
+        const es = eventSourceRef.current;
+        es.onopen = ()=>{
+            setStatus("CONNECTED");
+            setError(null);
+        };
+        es.onmessage = (ev)=>{
+            setData(ev.data);
+            setLastEventId(ev.lastEventId);
+            setStatus("CONNECTED");
+        };
+        es.onerror = (err)=>{
+            setError(err);
+            setStatus("DISCONNECTED");
+            if (options.autoReconnect && !explicitlyClosed.current) {
+                const { retries: maxRetries = -1, delay = 1000, onFailed } = options.autoReconnect;
+                retries.current += 1;
+                if (typeof maxRetries === "number" && (maxRetries < 0 || retries.current < maxRetries) || typeof maxRetries === "function" && maxRetries()) {
+                    setTimeout(open, delay);
+                } else {
+                    onFailed == null ? void 0 : onFailed();
+                }
+            }
+        };
+        const listeners = eventListenerRef.current;
+        events.forEach((name)=>{
+            const handler = (event)=>{
+                setEvent(name);
+                var _event_data;
+                setData((_event_data = event.data) != null ? _event_data : null);
+            };
+            es.addEventListener(name, handler);
+            listeners == null ? void 0 : listeners.set(name, handler);
+        });
+    });
+    useEffect(()=>{
+        if (options.immediate !== false) {
+            open();
+        }
+        return close;
+    }, [
+        open,
+        close,
+        options.immediate
+    ]);
+    useUnmount(()=>{
+        close();
+    });
+    return {
+        eventSourceRef,
+        data,
+        error,
+        status,
+        lastEventId,
+        event,
+        close,
+        open
+    };
+};
+
+export { defaultOptions, useActiveElement, useAsyncEffect, useClickOutside, useClipboard, useControlled, useCookie, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDisclosure, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEventSource, useEyeDropper, useFavicon, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMeasure, useMediaDevices, useMediaQuery, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };

package/package.json

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