@reactuses/core 6.1.1 → 6.1.3

package/dist/index.d.mts

@@ -10,6 +10,7 @@ import { FetchEventSourceInit } from '@microsoft/fetch-event-source';
  * @title useActiveElement
  * @returns_en Returns an instance of the type parameter `T` or `null`.
  * @returns 返回类型参数 `T` 或 `null` 的实例
+ * @returns_zh-Hant 返回類型參數 `T` 或 `null` 的實例
  */
 type UseActiveElement = <T extends Element>() => T | null;
 
@@ -22,17 +23,20 @@ declare const useActiveElement: UseActiveElement;
 type UseAsyncEffect = <T>(
 /**
  * @zh 支持promise的副作用函数
+ * @zh-Hant 支援promise的副作用函數
  * @en effect that support promise
  */
 effect: () => Promise<T> | T, 
 /**
  * @zh 清理函数
+ * @zh-Hant 清理函數
  * @en cleanup function
  * @defaultValue () => {}
  */
 cleanup?: typeof effect, 
 /**
  * @zh 依赖列表
+ * @zh-Hant 依賴列表
  * @en dependency list
  */
 deps?: DependencyList) => void;
@@ -49,16 +53,19 @@ type BasicTarget<T extends TargetType = Element> = (() => TargetValue<T>) | Targ
 type UseClickOutside = (
 /**
  * @zh dom对象
+ * @zh-Hant dom對象
  * @en dom element
  */
 target: BasicTarget<Element>, 
 /**
  * @zh 监听函数
+ * @zh-Hant 監聽函數
  * @en listener fucntion
  */
 handler: (evt: EventType) => void, 
 /**
  * @zh 监听函数是否生效
+ * @zh-Hant 監聽函數是否生效
  * @en whether the listener fucntion is enabled
  */
 enabled?: boolean) => void;
@@ -76,20 +83,27 @@ declare const useClickOutside: UseClickOutside;
  * - The current value of the cookie.
  * - A function to update the value of the cookie.
  * - A function to refresh the value of the cookie, incase other events change it.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - cookie 的當前值。
+ * - 更新 cookie 值的函數。
+ * - 刷新 cookie 值的函數，以防其他事件更改它。
  */
 type UseCookie = (
 /**
  * @zh 键值
+ * @zh-Hant 鍵值
  * @en key
  */
 key: string, 
 /**
  * @zh 透传给 `js-cookie` 的参数
+ * @zh-Hant 透傳給 `js-cookie` 的參數
  * @en option pass to `js-cookie`
  */
 options?: Cookies.CookieAttributes, 
 /**
  * @zh 默认值，ssr必须传递
+ * @zh-Hant 預設值，ssr必須傳遞
  * @en defaultValue, must be required in ssr
  */
 defaultValue?: string) => readonly [
@@ -114,21 +128,28 @@ declare const useCookie: UseCookie;
  * - 小时。
  * - 分钟。
  * - 秒数。
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 小時。
+ * - 分鐘。
+ * - 秒數。
  */
 type UseCountDown = (
 /**
  * @zh 时间差
+ * @zh-Hant 時間差
  * @en time differ
  */
 time: number, 
 /**
  * @zh 时间格式化函数
+ * @zh-Hant 時間格式化函數
  * @en time format function
  * @defaultValue HH MM SS
  */
 format?: (num: number) => [string, string, string], 
 /**
  * @zh 倒计时结束的回调函数
+ * @zh-Hant 倒計時結束的回調函數
  * @en callback function for end of countdown
  */
 callback?: () => void) => readonly [string, string, string];
@@ -143,27 +164,36 @@ declare const useCountDown: UseCountDown;
  * - A function to increment the counter. It optionally accepts a number to increment the counter by, defaulting to 1.
  * - A function to decrement the counter. It optionally accepts a number to decrement the counter by, defaulting to 1.
  * - A function to reset the counter to its initial value.
- *  @returns 包含以下元素的元组：
+ * @returns 包含以下元素的元组：
  * - 计数器的当前值。
  * - 设置计数器状态的函数。 它可以接受数字或返回数字的函数。
  * - 递增计数器的函数。 它可以选择接受一个数字来增加计数器，默认为 1。
  * - 递减计数器的函数。 它可以选择接受一个数字来减少计数器，默认为 1。
  * - 将计数器重置为其初始值的函数。
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 計數器的當前值。
+ * - 設定計數器狀態的函數。它可以接受數字或返回數字的函數。
+ * - 遞增計數器的函數。它可以選擇接受一個數字來增加計數器，預設為 1。
+ * - 遞減計數器的函數。它可以選擇接受一個數字來減少計數器，預設為 1。
+ * - 將計數器重設為其初始值的函數。
  */
 type UseCounter = (
 /**
  * @zh 初始值，可以为数字或者一个初始化的函数
+ * @zh-Hant 初始值，可以為數字或者一個初始化的函數
  * @en The initial value of the counter. It can be a number or a function that returns a number. If not provided, the counter will start from 0.
  * @defaultValue 0
  */
 initialValue?: number | (() => number), 
 /**
  * @zh 最大值。不提供则无上限
+ * @zh-Hant 最大值。不提供則無上限
  * @en The maximum value that the counter can reach. If not provided or null, there is no upper limit.
  */
 max?: number | null, 
 /**
  * @zh 最小值。不提供则无下限
+ * @zh-Hant 最小值。不提供則無下限
  * @en The minimum value that the counter can reach. If not provided or null, there is no lower limit.
  */
 min?: number | null) => readonly [
@@ -185,25 +215,32 @@ declare const defaultOptions: UseCssVarOptions;
  *  @returns 包含以下元素的元组：
  * - css 变量值
  * - 更新 css 变量值的函数
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - css 變數值
+ * - 更新 css 變數值的函數
  */
 type UseCssVar = <T extends HTMLElement = HTMLElement>(
 /**
  * @zh 属性值，比如 --color
+ * @zh-Hant 屬性值，比如 --color
  * @en prop, eg: --color
  */
 prop: string, 
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom element
  */
 target: BasicTarget<T>, 
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en default value
  */
 defaultValue?: string, 
 /**
  * @zh 可选项
+ * @zh-Hant 可選項
  * @en options
  */
 options?: UseCssVarOptions) => readonly [string, (v: string) => void];
@@ -214,6 +251,7 @@ interface UseCssVarOptions {
     /**
      * @en Use MutationObserver to monitor variable changes
      * @zh 使用 MutationObserver 来监听变量变更
+     * @zh-Hant 使用 MutationObserver 來監聽變數變更
      * @defaultValue false
      */
     observe?: boolean;
@@ -228,16 +266,19 @@ type DepsEqualFnType<TDeps extends DependencyList> = (prevDeps: TDeps, nextDeps:
 type UseCustomCompareEffect = <TDeps extends DependencyList>(
 /**
  * @zh 副作用函数
+ * @zh-Hant 副作用函數
  * @en effect callback
  */
 effect: EffectCallback, 
 /**
  * @zh 依赖列表
+ * @zh-Hant 依賴列表
  * @en deps
  */
 deps: TDeps, 
 /**
  * @zh 依赖比较函数
+ * @zh-Hant 依賴比較函數
  * @en deps compare function
  */
 depsEqual: DepsEqualFnType<TDeps>) => void;
@@ -254,15 +295,21 @@ declare const useCustomCompareEffect: UseCustomCompareEffect;
  * - 数组中当前的索引对象值
  * - 设置索引为前一个的函数
  * - 设置索引为后一个的函数
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 陣列中當前的索引對象值
+ * - 設定索引為前一個的函數
+ * - 設定索引為後一個的函數
  */
 type UseCycleList = <T>(
 /**
  * @zh 循环数组
+ * @zh-Hant 循環陣列
  * @en cycle array
  */
 list: T[], 
 /**
  * @zh 数组索引
+ * @zh-Hant 陣列索引
  * @en array index
  */
 i?: number) => readonly [T, (i?: number) => void, (i?: number) => void];
@@ -276,41 +323,48 @@ interface UseDarkOptions {
     /**
      * @en CSS Selector for the target element applying to
      * @zh 适用于目标元素的 CSS 选择器
+     * @zh-Hant 適用於目標元素的 CSS 選擇器
      * @defaultValue 'html'
      */
     selector?: string;
     /**
      * @en HTML attribute applying the target element
      * @zh 应用到目标元素的 html 属性
+     * @zh-Hant 應用到目標元素的 html 屬性
      * @defaultValue 'class'
      */
     attribute?: string;
     /**
      * @en default value
      * @zh 默认值
+     * @zh-Hant 預設值
      * @defaultValue false
      */
     defaultValue?: boolean;
     /**
      * @en Key to persist the data into localStorage/sessionStorage.
      * @zh 将数据持久保存到 localStorage/sessionStorage 的键值
+     * @zh-Hant 將資料持久保存到 localStorage/sessionStorage 的鍵值
      * @defaultValue 'reactuses-color-scheme'
      */
     storageKey?: string;
     /**
      * @en Storage object, can be localStorage or sessionStorage
      * @zh 存储对象，可以是localStorage或sessionStorage
+     * @zh-Hant 儲存對象，可以是localStorage或sessionStorage
      * @defaultValue `localStorage`
      */
     storage?: () => Storage;
     /**
      * @en name dark apply to element
      * @zh  应用到目标元素上黑色类名称
+     * @zh-Hant 應用到目標元素上黑色類名稱
      */
     classNameDark: string;
     /**
      * @en name light apply to element
      * @zh 应用到目标元素上的亮色类名称
+     * @zh-Hant 應用到目標元素上的亮色類名稱
      */
     classNameLight: string;
 }
@@ -324,6 +378,10 @@ interface UseDarkOptions {
  * - 黑暗状态的当前值。
  * - 切换黑暗状态的功能。
  * - 更新黑暗状态的功能。
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 黑暗狀態的當前值。
+ * - 切換黑暗狀態的功能。
+ * - 更新黑暗狀態的功能。
  */
 type UseDarkMode = (options: UseDarkOptions) => readonly [
     boolean | null,
@@ -339,16 +397,19 @@ declare const useDarkMode: UseDarkMode;
 type UseDebounce = <T>(
 /**
  * @zh 要防抖的值
+ * @zh-Hant 要防抖的值
  * @en the value need to debounce
  */
 value: T, 
 /**
  * @zh 间隔时间
+ * @zh-Hant 間隔時間
  * @en wait time
  */
 wait?: number, 
 /**
  * @zh 传递给 `lodash.debounce` 的选项
+ * @zh-Hant 傳遞給 `lodash.debounce` 的選項
  * @en options passed to `lodash.debounce`
  */
 options?: DebounceSettings) => T;
@@ -365,20 +426,27 @@ declare const useDebounce: UseDebounce;
  * - run：执行函数。
  * - cancel：取消执行函数。
  * - flush: 立即执行函数
+ * @returns_zh-Hant 具有以下元素的對象:
+ * - run：執行函數。
+ * - cancel：取消執行函數。
+ * - flush: 立即執行函數
  */
 type UseDebounceFn = <T extends (...args: any) => any>(
 /**
  * @zh 要防抖的函数
+ * @zh-Hant 要防抖的函數
  * @en debounce function
  */
 fn: T, 
 /**
  * @zh 间隔时间
+ * @zh-Hant 間隔時間
  * @en wait time
  */
 wait?: number, 
 /**
  * @zh 传递给 `lodash.debounce` 的属性
+ * @zh-Hant 傳遞給 `lodash.debounce` 的屬性
  * @en options passed to `lodash.debounce`
  */
 options?: DebounceSettings$1) => {
@@ -395,11 +463,13 @@ declare const useDebounceFn: UseDebounceFn;
 type UseDeepCompareEffect = (
 /**
  * @zh 副作用函数
+ * @zh-Hant 副作用函數
  * @en effect function
  */
 effect: EffectCallback, 
 /**
  * @zh 依赖列表
+ * @zh-Hant 依賴列表
  * @en dep list
  */
 deps: DependencyList) => void;
@@ -418,21 +488,25 @@ type UseDoubleClick = (props: UseDoubleClickProps) => void;
 interface UseDoubleClickProps {
     /**
      * @zh dom对象
+     * @zh-Hant dom對象
      * @en dom element
      */
     target: BasicTarget<Element>;
     /**
      * @zh 延迟时间（毫秒）
+     * @zh-Hant 延遲時間（毫秒）
      * @en latency time (milliseconds)
      */
     latency?: number | undefined;
     /**
      * @zh 单击事件处理函数
+     * @zh-Hant 單擊事件處理函數
      * @en single click event handler
      */
     onSingleClick?: ((e?: MouseEvent | TouchEvent) => void) | undefined;
     /**
      * @zh 双击事件处理函数
+     * @zh-Hant 雙擊事件處理函數
      * @en double click event handler
      */
     onDoubleClick?: ((e?: MouseEvent | TouchEvent) => void) | undefined;
@@ -480,15 +554,22 @@ interface Pausable$1 {
  * - y
  * - Whether the element is being dragged
  * set the element position
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - x
+ * - y
+ * - 元素是否在拖動中
+ * - 設定元素的位置
  */
 type UseDraggable = (
 /**
  * @zh dom对象
+ * @zh-Hant dom對象
  * @en dom element
  */
 target: BasicTarget<HTMLElement | SVGElement>, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseDraggableOptions) => readonly [number, number, boolean, Dispatch<SetStateAction<Position>>];
@@ -567,15 +648,18 @@ declare const useDraggable: UseDraggable;
  * @title useDropZone
  * @returns 文件是否在区域上
  * @returns_en Whether the file is on the zone
+ * @returns_zh-Hant 檔案是否在區域上
  */
 type UseDropZone = (
 /**
  * @zh 目标元素
+ * @zh-Hant 目標元素
  * @en target element
  */
 target: BasicTarget<EventTarget>, 
 /**
  * @zh 拖拽释放时候的回调
+ * @zh-Hant 拖拽釋放時候的回調
  * @en drop callback
  */
 onDrop?: ((files: File[] | null) => void) | undefined) => boolean;
@@ -588,11 +672,13 @@ declare const useDropZone: UseDropZone;
 type UseElementBounding = (
 /**
  * @zh 目标元素
+ * @zh-Hant 目標元素
  * @en target element
  */
 target: BasicTarget<Element>, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseElementBoundingOptions) => UseElementBoundingReturn;
@@ -686,10 +772,14 @@ declare const useElementBounding: UseElementBounding;
  * @returns 包含以下元素的元组：
  * - 元素宽度。
  * - 元素高度。
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 元素寬度。
+ * - 元素高度。
  */
 type UseElementSize = (
 /**
  * @zh dom对象
+ * @zh-Hant dom對象
  * @en dom element
  */
 target: BasicTarget<Element>, 
@@ -709,15 +799,20 @@ declare const useElementSize: UseElementSize;
  * @returns_en A tuple with the following elements:
  * - is the current element visible.
  * - stop observer listening function.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 當前元素是否可見。
+ * - 停止監聽函數。
  */
 type UseElementVisibility = (
 /**
  * @zh dom对象
+ * @zh-Hant dom對象
  * @en dom element
  */
 target: BasicTarget<HTMLElement | SVGElement>, 
 /**
  * @zh 传递给 `intersectionObserver` 的选项
+ * @zh-Hant 傳遞給 `intersectionObserver` 的選項
  * @en options passed to `intersectionObserver`
  */
 options?: IntersectionObserverInit) => readonly [boolean, () => void];
@@ -730,6 +825,7 @@ declare const useElementVisibility: UseElementVisibility;
 type UseEvent = <T extends Fn>(
 /**
  * @zh 函数
+ * @zh-Hant 函數
  * @en function
  */
 fn: T) => T;
@@ -749,6 +845,10 @@ declare const useEvent: UseEvent;
  * - a function to add lisenter.
  * - fire functiion.
  * stop functiion
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 添加監聽器的函數。
+ * - 觸發函數。
+ * - 停止函數。
  */
 type UseEventEmitter = <T, U = void>() => readonly [
     UseEventEmitterEvent<T, U>,
@@ -803,6 +903,9 @@ declare function useEventListener(eventName: string, handler: (...p: any) => voi
  * @returns_en A tuple with the following elements:
  * - Whether the browser supports this feature.
  * - A function to open eye dropper.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 瀏覽器是否支援該特性。
+ * - 打開顏色選擇器的函數。
  */
 type UseEyeDropper = () => readonly [
     boolean,
@@ -814,6 +917,7 @@ type UseEyeDropper = () => readonly [
 interface UseEyeDropperOpenOptions {
     /**
      * @zh 终止信号
+     * @zh-Hant 終止信號
      * @en abort signal
      */
     signal?: AbortSignal;
@@ -843,6 +947,10 @@ declare function useFavicon(href: string, baseUrl?: string, rel?: string): void;
  * - file array.
  * - A function to open file dialog.
  * - A function to reset files
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 檔案陣列。
+ * - 打開檔案選擇器函數。
+ * - 重設函數。
  */
 type UseFileDialog = (options?: UseFileDialogOptions) => readonly [
     FileList | null,
@@ -855,6 +963,7 @@ type UseFileDialog = (options?: UseFileDialogOptions) => readonly [
 interface UseFileDialogOptions {
     /**
      * @zh 选择多个文件
+     * @zh-Hant 選擇多個檔案
      * @en choose multiple file
      * @defaultValue true
      */
@@ -877,6 +986,9 @@ declare const useFileDialog: UseFileDialog;
 
 /**
  * @title useFirstMountState
+ * @returns 组件是否刚刚挂载的布尔值
+ * @returns_en A boolean value indicating whether the component is just mounted
+ * @returns_zh-Hant 組件是否剛剛掛載的布爾值
  */
 type UseFirstMountState = () => boolean;
 
@@ -890,15 +1002,20 @@ declare const useFirstMountState: UseFirstMountState;
  * @returns_en A tuple with the following elements:
  * -  whether the element focus.
  * - A function to update focus state.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 元素是否聚焦。
+ * - 更新聚焦狀態。
  */
 type UseFocus = (
 /**
  * @zh dom对象
+ * @zh-Hant dom對象
  * @en dom element
  */
 target: BasicTarget<HTMLElement | SVGElement>, 
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en defaultValue
  * @defaultValue false
  */
@@ -910,6 +1027,7 @@ declare const useFocus: UseFocus;
  * @title useFps
  * @returns 每秒帧数
  * @returns_en frames per second
+ * @returns_zh-Hant 每秒幀數
  */
 type UseFps = (options?: UseFpsOptions) => number;
 /**
@@ -919,6 +1037,7 @@ interface UseFpsOptions {
     /**
      * @en Calculate the FPS on every x frames.
      * @zh 每过 x 帧计算一次
+     * @zh-Hant 每過 x 幀計算一次
      * @defaultValue 10
      */
     every?: number;
@@ -942,10 +1061,18 @@ declare function useFps(options?: UseFpsOptions): number;
  * - exitFullscreen
  * - toggleFullscreen
  * - isEnabled: whether the browser support fullscreen
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 當前是否處於全螢幕。
+ * - 一個操作對象:
+ * - enterFullscreen： 進入全螢幕。
+ * - exitFullscreen： 退出全螢幕。
+ * - toggleFullscreen： 切換全螢幕。
+ * - isEnabled： 當前瀏覽器是否支援全螢幕。
  */
 type UseFullscreen = (
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom element
  */
 target: BasicTarget<Element>, 
@@ -1012,10 +1139,16 @@ declare const useFullscreen: UseFullscreen;
  * - timestamp when get coordinates.
  * - errors.
  * - Whether the browser supports `geolocation`.
+ * @returns_zh-Hant 包含以下元素的對象：
+ * - 坐標。
+ * - 獲取坐標的時間戳。
+ * - 錯誤。
+ * - 瀏覽器是否支援 `geolocation`。
  */
 type UseGeolocation = (
 /**
  * @zh 可选 `PositionOptions` 参数
+ * @zh-Hant 可選 `PositionOptions` 參數
  * @en optional `PositionOptions` params
  */
 options?: Partial<PositionOptions>) => {
@@ -1037,6 +1170,7 @@ declare const useGeolocation: UseGeolocation;
 type UseHover = <T extends Element = HTMLDivElement>(
 /**
  * @zh dom对象
+ * @zh-Hant dom對象
  * @en dom element
  */
 target: BasicTarget<T>) => boolean;
@@ -1047,16 +1181,19 @@ declare const useHover: UseHover;
  * @title UseIdle
  * @returns 是否处于空闲
  * @returns_en whether user is idle
+ * @returns_zh-Hant 是否處於空閒
  */
 type UseIdle = (
 /**
  * @zh 检测时间
+ * @zh-Hant 檢測時間
  * @en detection time
  * @defaultValue 60e3
  */
 ms?: number, 
 /**
  * @zh 初始值
+ * @zh-Hant 初始值
  * @en initial value
  * @defaultValue false
  */
@@ -1084,15 +1221,23 @@ declare const useIdle: UseIdle;
  * - Whether it is scrolling.
  * - Boundary arrival status.
  * - Scroll direction.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - x 值。
+ * - y 值。
+ * - 是否在滚動。
+ * - 到達邊界狀態。
+ * - 滚動方向
  */
 type UseScroll = (
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom elment
  */
 target: BasicTarget<Element> | Window | Document, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseScrollOptions) => readonly [
@@ -1107,8 +1252,9 @@ options?: UseScrollOptions) => readonly [
  */
 interface UseScrollOptions {
     /**
-     * @en Throttle time for scroll event, it’s disabled by default.
+     * @en Throttle time for scroll event, it's disabled by default.
      * @zh 滚动事件的节流时间，默认关闭。
+     * @zh-Hant 滚動事件的節流時間，預設關閉。
      * @defaultValue 0
      */
     throttle?: number;
@@ -1117,27 +1263,33 @@ interface UseScrollOptions {
      * This configuration will be setting to (throttle + idle) when the `throttle` is configured.
      * @zh 滚动结束时的检查时间。
      * 当配置 `throttle` 时，此配置将设置为 (throttle +idle)。
+     * @zh-Hant 滚動結束時的檢查時間。
+     * 當配置 `throttle` 時，此配置將設置為 (throttle +idle)。
      * @default 200
      */
     idle?: number;
     /**
      * @en Offset arrived states by x pixels
      * @zh 将到达状态偏移 x 像素
+     * @zh-Hant 將到達狀態偏移 x 像素
      */
     offset?: UseScrollOffset;
     /**
      * @en Trigger it when scrolling.
      * @zh 滚动的回调
+     * @zh-Hant 滚動的回調
      */
     onScroll?: (e: Event) => void;
     /**
      * @en Trigger it when scrolling ends.
      * @zh 滚动结束的回调
+     * @zh-Hant 滚動結束的回調
      */
     onStop?: (e: Event) => void;
     /**
      * @en Listener options for scroll event.
      * @zh 滚动事件参数
+     * @zh-Hant 滚動事件參數
      * @defaultValue {capture: false, passive: true}
      */
     eventListenerOptions?: boolean | AddEventListenerOptions;
@@ -1155,21 +1307,25 @@ interface UseScrollArrivedState {
     /**
      * @en arrived left
      * @zh 到达左边
+     * @zh-Hant 到達左邊
      */
     left: boolean;
     /**
      * @en arrived right
      * @zh 到达右边
+     * @zh-Hant 到達右邊
      */
     right: boolean;
     /**
      * @en arrived top
      * @zh 到达顶部
+     * @zh-Hant 到達頂部
      */
     top: boolean;
     /**
      * @en arrived bottom
      * @zh 到达底部
+     * @zh-Hant 到達底部
      */
     bottom: boolean;
 }
@@ -1180,21 +1336,25 @@ interface UseScrollDirection {
     /**
      * @en scroll left
      * @zh 向左滚动
+     * @zh-Hant 向左滚動
      */
     left: boolean;
     /**
      * @en scroll right
      * @zh 向右滚动
+     * @zh-Hant 向右滚動
      */
     right: boolean;
     /**
      * @en scroll top
      * @zh 向上滚动
+     * @zh-Hant 向上滚動
      */
     top: boolean;
     /**
      * @en scroll bottom
      * @zh 向下滚动
+     * @zh-Hant 向下滚動
      */
     bottom: boolean;
 }
@@ -1205,11 +1365,13 @@ interface UseScrollDirection {
 type UseInfiniteScroll = (
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom element
  */
 target: BasicTarget<Element>, 
 /**
  * @zh 加载更多函数
+ * @zh-Hant 加載更多函數
  * @en load more function
  */
 onLoadMore: UseInfiniteScrollLoadMore, 
@@ -1313,15 +1475,18 @@ declare const useInfiniteScroll: UseInfiniteScroll;
  * @title useIntersectionObserver
  * @returns 停止监听函数
  * @returns_en stop listening function
+ * @returns_zh-Hant 停止監聽函數
  */
 type UseIntersectionObserver = (
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom element
  */
 target: BasicTarget<Element>, 
 /**
  * @zh 回调
+ * @zh-Hant 回調
  * @en callback
  */
 callback: IntersectionObserverCallback, 
@@ -1339,11 +1504,13 @@ declare const useIntersectionObserver: UseIntersectionObserver;
 type UseInterval = (
 /**
  * @zh 回调
+ * @zh-Hant 回調
  * @en callback
  */
 callback: () => void, 
 /**
  * @zh 时间，如果为 `null` 的话则停止计时器
+ * @zh-Hant 時間，如果為 `null` 的話則停止計時器
  * @en Time, if `null` then stop the timer
  */
 delay?: number | null, 
@@ -1396,15 +1563,18 @@ declare const useIsomorphicLayoutEffect: typeof useEffect;
  * @title useKeyModifier
  * @returns 按键是否被按下
  * @returns_en Whether the key is pressed
+ * @returns_zh-Hant 按鍵是否被按下
  */
 type UseKeyModifier = (
 /**
  * @zh 键位
+ * @zh-Hant 鍵位
  * @en key modifier
  */
 modifier: KeyModifier, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseModifierOptions) => boolean;
@@ -1433,10 +1603,12 @@ declare const useKeyModifier: UseKeyModifier;
  * @title useLatest
  * @returns ref 对象
  * @returns_en ref object
+ * @returns_zh-Hant ref 對象
  */
 type UseLatest = <T>(
 /**
  * @zh 追踪值
+ * @zh-Hant 追蹤值
  * @en tracked value
  */
 value: T) => MutableRefObject<T>;
@@ -1490,11 +1662,13 @@ declare function useLocalStorage<T = unknown>(key: string, defaults: null, optio
 type UseLocationSelector = <R>(
 /**
  * @zh 选择器
+ * @zh-Hant 選擇器
  * @en selector function
  */
 selector: (location: Location) => R, 
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en default value
  */
 fallback?: R | undefined) => R | undefined;
@@ -1515,15 +1689,23 @@ declare const useLocationSelector: UseLocationSelector;
  * - onMouseUp: Mouse up event.
  * - onMouseLeave: Mouse leave event.
  * - onTouchEnd: Finger touch end event.
+ * @returns_zh-Hant 包含以下元素的對象：
+ * - onMouseDown 滑鼠按下事件。
+ * - onTouchStart 手指按下事件。
+ * - onMouseUp 滑鼠放開事件。
+ * - onMouseLeave 滑鼠離開事件
+ * - onTouchEnd 手指放開事件
  */
 type UseLongPress = (
 /**
  * @zh 回调
+ * @zh-Hant 回調
  * @en callback
  */
 callback: (e: TouchEvent | MouseEvent) => void, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseLongPressOptions) => {
@@ -1539,12 +1721,14 @@ options?: UseLongPressOptions) => {
 interface UseLongPressOptions {
     /**
      * @zh 阻止默认事件
+     * @zh-Hant 阻止預設事件
      * @en whether prevent default event
      * @defaultValue true
      */
     isPreventDefault?: boolean;
     /**
      * @zh 延迟
+     * @zh-Hant 延遲
      * @en delay time
      * @defaultValue 300
      */
@@ -1557,15 +1741,18 @@ declare const useLongPress: UseLongPress;
  * @title useMeasure
  * @returns [DOMRect值,停止监听函数]
  * @returns_en [DOMRect, stop listening function]
+ * @returns_zh-Hant [DOMRect值,停止監聽函數]
  */
 type UseMeasure = (
 /**
  * @zh dom对象
+ * @zh-Hant dom對象
  * @en dom element
  */
 target: BasicTarget<Element>, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: ResizeObserverOptions) => readonly [UseMeasureRect, () => void];
@@ -1584,10 +1771,14 @@ declare const useMeasure: UseMeasure;
  * @returns_en A tuple with the following elements:
  * - The media devices info.
  * - A function to request media devices permission.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 媒體設備信息。
+ * - 請求媒體設備權限。
  */
 type UseMediaDevices = (
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseMediaDeviceOptions) => readonly [
@@ -1609,12 +1800,14 @@ interface UseMediaDeviceOptions {
      * @en Request for permissions immediately if it's not granted,
      * otherwise label and deviceIds could be empty
      * @zh 自动请求权限
+     * @zh-Hant 自動請求權限
      * @defaultValue false
      */
     requestPermissions?: boolean;
     /**
      * @en Request for types of media permissions
      * @zh 请求媒体权限类型
+     * @zh-Hant 請求媒體權限類型
      * @defaultValue { audio: true, video: true }
      */
     constraints?: MediaStreamConstraints;
@@ -1626,15 +1819,18 @@ declare const useMediaDevices: UseMediaDevices;
  * @title useMediaQuery
  * @returns 是否符合媒体查询
  * @returns_en whether comply with media inquiries
+ * @returns_zh-Hant 是否符合媒體查詢
  */
 type UseMediaQuery = (
 /**
  * @zh 媒体查询字符串
+ * @zh-Hant 媒體查詢字符串
  * @en media query string
  */
 query: string, 
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en default value
  */
 defaultState?: boolean) => boolean;
@@ -1647,6 +1843,7 @@ declare const useMediaQuery: UseMediaQuery;
 type UseMount = (
 /**
  * @zh 副作用函数
+ * @zh-Hant 副作用函數
  * @en effect function
  */
 effect: () => void) => void;
@@ -1659,10 +1856,12 @@ declare function useMountedState(): () => boolean;
  * @title useMouse
  * @returns 鼠标位置
  * @returns_en Mouse Position
+ * @returns_zh-Hant 滑鼠位置
  */
 type UseMouse = (
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom element
  */
 target?: BasicTarget) => UseMouseCursorState;
@@ -1694,10 +1893,14 @@ declare const useMouse: UseMouse;
  * @returns_en A tuple with the following elements:
  * - whether the mouse is pressed.
  * - the pressed source type
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 滑鼠是否按下。
+ * - 按下的事件來源。
  */
 type UseMousePressed = (
 /**
  * @zh dom对象
+ * @zh-Hant dom對象
  * @en dom element
  */
 target?: BasicTarget<Element>, 
@@ -1740,15 +1943,18 @@ declare const useMousePressed: UseMousePressed;
  * @title UseMutationObserver
  * @returns 停止函数
  * @returns_en stop listenering function
+ * @returns_zh-Hant 停止函數
  */
 type UseMutationObserver = (
 /**
  * @zh 回调
+ * @zh-Hant 回調
  * @en callback
  */
 callback: MutationCallback, 
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom对象
  */
 target: BasicTarget, 
@@ -1771,6 +1977,7 @@ interface IUseNetworkState {
     /**
      * @en Whether browser connected to the network or not.
      * @zh 浏览器是否连接网络
+     * @zh-Hant 瀏覽器是否連接網路
      */
     online: boolean | undefined;
     /**
@@ -1778,6 +1985,8 @@ interface IUseNetworkState {
      * just connected or lost connection.
      * @zh `online` 属性的先前值。 帮助识别浏览器是否
      * 刚刚连接或失去连接。
+     * @zh-Hant `online` 屬性的先前值。 幫助識別瀏覽器是否
+     * 剛剛連接或失去連接。
      */
     previous: boolean | undefined;
     /**
@@ -1858,10 +2067,12 @@ declare const useNetwork: UseNetwork;
  * @title useObjectUrl
  * @returns 返回一个由 Blob 或 MediaSource 对象生成的 URL（如果存在），否则返回 undefined
  * @returns_en Returns a URL created from the Blob or MediaSource object, or undefined if none exists
+ * @returns_zh-Hant 返回一個由 Blob 或 MediaSource 對象生成的 URL（如果存在），否則返回 undefined
  */
 type UseObjectUrl = (
 /**
  * @zh 文件或者媒体对象
+ * @zh-Hant 檔案或者媒體對象
  * @en file or media source
  */
 object: Blob | MediaSource) => string | undefined;
@@ -1876,6 +2087,7 @@ declare const useOnceLayoutEffect: typeof react.useEffect | typeof useLayoutEffe
  * @title useOnline
  * @returns 网络是否在线
  * @returns_en whether netwotk is online
+ * @returns_zh-Hant 網路是否在線
  */
 type UseOnline = () => boolean | undefined;
 
@@ -1891,10 +2103,15 @@ declare const useOnline: UseOnline;
  * - orientation type.
  * - lock orientation.
  * - unlock orientation.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 方向狀態。
+ * - 鎖定方向。
+ * - 解鎖方向。
  */
 type UseOrientation = (
 /**
  * @zh 初始值
+ * @zh-Hant 初始值
  * @en initial value
  */
 initialState?: UseOrientationState) => readonly [
@@ -1934,10 +2151,12 @@ declare function usePageLeave(): boolean;
  * @title usePermission
  * @returns 权限状态
  * @returns_en permission state
+ * @returns_zh-Hant 權限狀態
  */
 type UsePermission = (
 /**
  * @zh 权限描述符
+ * @zh-Hant 權限描述符
  * @en permission desc
  */
 permissionDesc: UsePermissionGeneralPermissionDescriptor | UsePermissionGeneralPermissionDescriptor['name']) => UsePermissionState;
@@ -1962,10 +2181,12 @@ declare const usePermission: UsePermission;
  * @title usePreferredColorScheme
  * @returns prefers-color-scheme的媒体查询值
  * @returns_en value of prefers-color-scheme media query
+ * @returns_zh-Hant prefers-color-scheme的媒體查詢值
  */
 type UsePreferredColorScheme = (
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en default value
  * @defaultValue no-preference
  */
@@ -1983,6 +2204,7 @@ declare const usePreferredColorScheme: UsePreferredColorScheme;
 type UsePreferredContrast = (
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en default value
  * @defaultValue no-preference
  */
@@ -2008,10 +2230,15 @@ declare function usePrevious<T>(value: T): T | undefined;
  * - stop function
  * - start function
  * whether function is running
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 停止函數。
+ * - 開始函數。
+ * - 函數是否在執行中。
  */
 type UseRafFn = (
 /**
  * @zh 回调
+ * @zh-Hant 回調
  * @en callback
  */
 callback: FrameRequestCallback, 
@@ -2033,11 +2260,13 @@ declare function useReducedMotion(defaultState?: boolean): boolean;
 type UseResizeObserver = (
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom element
  */
 target: BasicTarget<Element>, 
 /**
  * @zh 回调
+ * @zh-Hant 回調
  * @en callback
  */
 callback: ResizeObserverCallback, 
@@ -2051,6 +2280,153 @@ declare const useResizeObserver: UseResizeObserver;
 
 declare function useScreenSafeArea(): readonly [string, string, string, string, lodash.DebouncedFunc<() => void>];
 
+/**
+ * @title UseScratchState
+ */
+interface UseScratchState {
+    /**
+     * @zh 是否正在刮擦
+     * @zh-Hant 是否正在刮擦
+     * @en Whether scratching is in progress
+     */
+    isScratching: boolean;
+    /**
+     * @zh 开始时间戳
+     * @zh-Hant 開始時間戳
+     * @en Start timestamp
+     */
+    start?: number;
+    /**
+     * @zh 结束时间戳
+     * @zh-Hant 結束時間戳
+     * @en End timestamp
+     */
+    end?: number;
+    /**
+     * @zh 相对于元素的 x 坐标
+     * @zh-Hant 相對於元素的 x 座標
+     * @en x coordinate relative to element
+     */
+    x?: number;
+    /**
+     * @zh 相对于元素的 y 坐标
+     * @zh-Hant 相對於元素的 y 座標
+     * @en y coordinate relative to element
+     */
+    y?: number;
+    /**
+     * @zh x 方向的增量
+     * @zh-Hant x 方向的增量
+     * @en Delta in x direction
+     */
+    dx?: number;
+    /**
+     * @zh y 方向的增量
+     * @zh-Hant y 方向的增量
+     * @en Delta in y direction
+     */
+    dy?: number;
+    /**
+     * @zh 文档中的 x 坐标
+     * @zh-Hant 文檔中的 x 座標
+     * @en x coordinate in document
+     */
+    docX?: number;
+    /**
+     * @zh 文档中的 y 坐标
+     * @zh-Hant 文檔中的 y 座標
+     * @en y coordinate in document
+     */
+    docY?: number;
+    /**
+     * @zh 元素在文档中的 x 位置
+     * @zh-Hant 元素在文檔中的 x 位置
+     * @en Element x position in document
+     */
+    posX?: number;
+    /**
+     * @zh 元素在文档中的 y 位置
+     * @zh-Hant 元素在文檔中的 y 位置
+     * @en Element y position in document
+     */
+    posY?: number;
+    /**
+     * @zh 元素高度
+     * @zh-Hant 元素高度
+     * @en Element height
+     */
+    elH?: number;
+    /**
+     * @zh 元素宽度
+     * @zh-Hant 元素寬度
+     * @en Element width
+     */
+    elW?: number;
+    /**
+     * @zh 元素 x 位置
+     * @zh-Hant 元素 x 位置
+     * @en Element x position
+     */
+    elX?: number;
+    /**
+     * @zh 元素 y 位置
+     * @zh-Hant 元素 y 位置
+     * @en Element y position
+     */
+    elY?: number;
+}
+/**
+ * @title UseScratchOptions
+ */
+interface UseScratchOptions {
+    /**
+     * @zh 是否禁用
+     * @zh-Hant 是否禁用
+     * @en Whether to disable
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * @zh 刮擦时的回调
+     * @zh-Hant 刮擦時的回調
+     * @en Callback during scratching
+     */
+    onScratch?: (state: UseScratchState) => void;
+    /**
+     * @zh 开始刮擦时的回调
+     * @zh-Hant 開始刮擦時的回調
+     * @en Callback when scratching starts
+     */
+    onScratchStart?: (state: UseScratchState) => void;
+    /**
+     * @zh 结束刮擦时的回调
+     * @zh-Hant 結束刮擦時的回調
+     * @en Callback when scratching ends
+     */
+    onScratchEnd?: (state: UseScratchState) => void;
+}
+/**
+ * @title useScratch
+ * @returns 刮擦状态
+ * @returns_en Scratch state
+ * @returns_zh-Hant 刮擦狀態
+ */
+type UseScratch = (
+/**
+ * @zh 目标元素
+ * @zh-Hant 目標元素
+ * @en Target element
+ */
+target: BasicTarget<HTMLElement>, 
+/**
+ * @zh 配置项
+ * @zh-Hant 配置項
+ * @en Options
+ */
+options?: UseScratchOptions) => UseScratchState;
+
+declare const useScratch: UseScratch;
+
 /**
  * @title useScriptTag
  * @returns 包含以下元素的元组：
@@ -2063,20 +2439,28 @@ declare function useScreenSafeArea(): readonly [string, string, string, string,
  * - Resource loading status.
  * - Resource loading function.
  * - Resource unloading function
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 用來加載資源的 html 元素。
+ * - 資源加載狀態。
+ * - 資源加載函數。
+ * - 資源卸載函數
  */
 type UseScriptTag = (
 /**
  * @zh 资源地址
+ * @zh-Hant 資源地址
  * @en source
  */
 src: string, 
 /**
  * @zh 资源加载完成的回调
+ * @zh-Hant 資源加載完成的回調
  * @en source loaded callback
  */
 onLoaded?: (el: HTMLScriptElement) => void, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseScriptTagOptions) => readonly [
@@ -2092,50 +2476,59 @@ interface UseScriptTagOptions {
     /**
      * @en Load the script immediately
      * @zh 立即加载资源
+     * @zh-Hant 立即加載資源
      * @defaultValue true
      */
     immediate?: boolean;
     /**
      * @en Add `async` attribute to the script tag
      * @zh 在 `script` 标签上加上 `async`
+     * @zh-Hant 在 `script` 標籤上加上 `async`
      * @defaultValue true
      */
     async?: boolean;
     /**
      * @en Script type
      * @zh 脚本类型
+     * @zh-Hant 腳本類型
      * @defaultValue 'text/javascript'
      */
     type?: string;
     /**
      * @en Manual controls the timing of loading and unloading
      * @zh 手动控制加载和卸载时机
+     * @zh-Hant 手動控制加載和卸載時機
      * @defaultValue false
      */
     manual?: boolean;
     /**
      * @zh 跨域属性
+     * @zh-Hant 跨域屬性
      * @en cross origin
      */
     crossOrigin?: 'anonymous' | 'use-credentials';
     /**
      * @en referrer policy
      * @zh 来源属性
+     * @zh-Hant 來源屬性
      */
     referrerPolicy?: 'no-referrer' | 'no-referrer-when-downgrade' | 'origin' | 'origin-when-cross-origin' | 'same-origin' | 'strict-origin' | 'strict-origin-when-cross-origin' | 'unsafe-url';
     /**
      * @en Add `noModule` attribute to the script tag
      * @zh 在 `script` 标签上加上 `noModule`
+     * @zh-Hant 在 `script` 標籤上加上 `noModule`
      */
     noModule?: boolean;
     /**
      * @en Add `defer` attribute to the script tag
      * @zh 在 `script` 标签上加上 `defer`
+     * @zh-Hant 在 `script` 標籤上加上 `defer`
      */
     defer?: boolean;
     /**
      * @en Add custom attribute to the script tag
      * @zh 在 script 标签上添加自定义属性
+     * @zh-Hant 在 script 標籤上添加自定義屬性
      */
     attrs?: Record<string, string>;
 }
@@ -2156,10 +2549,14 @@ declare const useScroll: UseScroll;
  * @returns_en A object with the following elements:
  * - scrollIntoView: scroll target element into viewport
  * - cancel: cancel scroll function
+ * @returns_zh-Hant 包含以下元素的對象：
+ * - scrollIntoView：滚動進入視口函數。
+ * - cancel： 取消滚動函數。
  */
 type UseScrollIntoView = (
 /**
  * @zh dom对象
+ * @zh-Hant dom對象
  * @en dom element
  */
 targetElement: BasicTarget<HTMLElement>, 
@@ -2241,10 +2638,14 @@ declare const useScrollIntoView: UseScrollIntoView;
  * @returns_en A tuple with the following elements:
  * - whether scroll is locked.
  * - A function to update the value of lock state.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 是否鎖定。
+ * - 更新鎖定值的函數。
  */
 type UseScrollLock = (
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom element
  */
 target: BasicTarget<HTMLElement>, 
@@ -2271,10 +2672,14 @@ declare function useSessionStorage<T = unknown>(key: string, defaults: null, opt
  * @returns_en A tuple with the following elements:
  * - The current value of the state.
  * - A function to update the value of the state.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - state 的當前值。
+ * - 更新 state 值的函數。
  */
 type UseSetState = <T extends Record<string, any>>(
 /**
  * @zh 初始值
+ * @zh-Hant 初始值
  * @en initial value
  */
 initialState: T) => readonly [
@@ -2292,10 +2697,14 @@ declare const useSetState: UseSetState;
  * @returns_en A tuple with the following elements:
  * - The current state of sticky.
  * - A function to update the value of sticky.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 當前是否粘滞。
+ * - 更新粘滞值的函數。
  */
 type UseSticky = (
 /**
  * @zh dom元素
+ * @zh-Hant dom元素
  * @en dom element
  */
 targetElement: BasicTarget<HTMLElement>, 
@@ -2339,10 +2748,14 @@ declare function useSupported(callback: () => unknown, sync?: boolean): boolean;
  * @returns_en A tuple with the following elements:
  * - The current value of the text direction.
  * - A function to update the value of the text direction.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 文字方向。
+ * - 更新文字方向值的函數。
  */
 type UseTextDirection = (
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseTextDirectionOptions) => readonly [UseTextDirectionValue, (value: UseTextDirectionValue) => void];
@@ -2353,12 +2766,14 @@ interface UseTextDirectionOptions {
     /**
      * @en CSS Selector for the target element applying to
      * @zh 适用于目标元素的 CSS 选择器
+     * @zh-Hant 適用於目標元素的 CSS 選擇器
      * @defaultValue 'html'
      */
     selector?: string;
     /**
      * @en Initial value
      * @zh 初始值
+     * @zh-Hant 初始值
      * @defaultValue 'ltr'
      */
     initialValue?: UseTextDirectionValue;
@@ -2374,6 +2789,7 @@ declare const useTextDirection: UseTextDirection;
  * @title useTextSelection
  * @returns 选择的文本对象
  * @returns_en selected text object
+ * @returns_zh-Hant 選擇的文本對象
  */
 type UseTextSelection = () => Selection | null;
 
@@ -2385,11 +2801,13 @@ declare const useTextSelection: UseTextSelection;
 type UseThrottle = <T>(
 /**
  * @zh 要节流的值
+ * @zh-Hant 要節流的值
  * @en the value need to throttle
  */
 value: T, 
 /**
  * @zh 间隔时间
+ * @zh-Hant 間隔時間
  * @en wait time
  */
 wait?: number, 
@@ -2417,15 +2835,21 @@ declare function useThrottleFn<T extends (...args: any) => any>(fn: T, wait?: nu
  * - Whether to wait for the timer to execute.
  * - Set timer.
  * - Cancel timer.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 是否等待定時器執行。
+ * - 設定定時器。
+ * - 取消定時器。
  */
 type UseTimeout = (
 /**
  * @zh 间隔时间
+ * @zh-Hant 間隔時間
  * @en wait time
  */
 ms?: number
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional param
  */ , options?: UseTimeoutOptions) => Stoppable;
 /**
@@ -2435,6 +2859,7 @@ interface UseTimeoutOptions {
     /**
      * @en Start the timer immediate after calling this function
      * @zh 立即设置定时器
+     * @zh-Hant 立即設定定時器
      * @defaultValue true
      */
     immediate?: boolean;
@@ -2452,20 +2877,27 @@ declare const useTimeout: UseTimeout;
  * - Whether to wait for the timer to execute.
  * - Set timer.
  * - Cancel timer.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 是否等待定時器執行。
+ * - 設置定時器。
+ * - 取消定時器。
  */
 type UseTimeoutFn = (
 /**
  * @zh 回调
+ * @zh-Hant 回調
  * @en callback
  */
 cb: (...args: unknown[]) => any, 
 /**
  * @zh 间隔时间
+ * @zh-Hant 間隔時間
  * @en wait time
  */
 interval: number, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional param
  */
 options?: UseTimeoutFnOptions) => Stoppable;
@@ -2476,6 +2908,7 @@ interface UseTimeoutFnOptions {
     /**
      * @en Start the timer immediate after calling this function
      * @zh 立即设置定时器
+     * @zh-Hant 立即設置定時器
      * @defaultValue true
      */
     immediate?: boolean;
@@ -2496,6 +2929,7 @@ declare const useTimeoutFn: UseTimeoutFn;
 type UseTitle = (
 /**
  * @zh 标题
+ * @zh-Hant 標題
  * @en title
  */
 title: string) => void;
@@ -2510,10 +2944,14 @@ declare const useTitle: UseTitle;
  * @returns_en A tuple with the following elements:
  * - The current value of the bool state.
  * - A function to update the value of the bool state.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 布林狀態的當前值。
+ * - 切換布林狀態值的函數。
  */
 type UseToggle = (
 /**
  * @zh 初始值
+ * @zh-Hant 初始值
  * @en initialValue
  */
 initialValue: boolean) => [boolean, (nextValue?: any) => void];
@@ -2534,6 +2972,7 @@ declare const useUpdateLayoutEffect: typeof react.useEffect | typeof useLayoutEf
 type UseWebNotification = (
 /**
  * @zh 自动请求权限
+ * @zh-Hant 自動請求權限
  * @en auto request permission
  */
 requestPermissions?: boolean) => UseWebNotificationReturn;
@@ -2543,6 +2982,7 @@ requestPermissions?: boolean) => UseWebNotificationReturn;
 interface UseWebNotificationReturn {
     /**
      * @zh 浏览器是否支持
+     * @zh-Hant 瀏覽器是否支援
      * @en whether browser support
      */
     readonly isSupported: boolean;
@@ -2597,11 +3037,13 @@ type UseWindowScroll = () => UseWindowScrollState;
 interface UseWindowScrollState {
     /**
      * @zh 水平滚动的像素值
+     * @zh-Hant 水平滚動的像素值
      * @en pixel value of horizontal scrolling
      */
     x: number;
     /**
      * @zh 垂直滚动的像素值
+     * @zh-Hant 垂直滚動的像素值
      * @en pixel value of vertical scrolling
      */
     y: number;
@@ -2617,6 +3059,9 @@ declare function useWindowScroll(): UseWindowScrollState;
  * @returns 包含以下元素的对象：
  * - width：当前视窗宽度。
  * - height： 当前视窗高度。
+ * @returns_zh-Hant 包含以下元素的對象：
+ * - width：當前視窗寬度。
+ * - height： 當前視窗高度。
  */
 type UseWindowSize = () => {
     readonly width: number;
@@ -2629,6 +3074,7 @@ declare const useWindowSize: UseWindowSize;
  * @title useClipBoard
  * @returns_en Returns a readonly tuple.
  * @returns 返回只读元组.
+ * @returns_zh-Hant 返回唯讀元組.
  */
 type UseClipboard = () => readonly [string, (txt: string) => Promise<void>];
 
@@ -2641,6 +3087,7 @@ type Platform = 'ios' | 'android' | 'unknown';
 interface UsePlatformProps {
     /**
      * @zh 服务端渲染时，需要传递 `userAgent`
+     * @zh-Hant 服務端渲染時，需要傳遞 `userAgent`
      * @en When server rendering, you need to pass `userAgent`
      */
     userAgent?: string;
@@ -2689,21 +3136,27 @@ declare function useMobileLandscape(): boolean;
  * @returns 包含以下元素的元组：
  * - 当前值。
  * - 更新当前值的函数。
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 當前值。
+ * - 更新當前值的函數。
  */
 type UseControlled = <T>(
 /**
  * @en controlled value
  * @zh 受控值
+ * @zh-Hant 受控值
  */
 value: T | undefined, 
 /**
  * @en default value
  * @zh 默认值
+ * @zh-Hant 預設值
  */
 defaultValue: T, 
 /**
  * @en callback when value change
  * @zh 值改变时的回调
+ * @zh-Hant 值改變時的回調
  */
 onChange?: ((v: T, ...args: any[]) => void) | undefined) => [T, (value: T) => void];
 
@@ -2716,26 +3169,31 @@ interface UseDisclosureProps {
     /**
      * @en Whether the disclosure is open, if passed, it will be controlled
      * @zh 是否打开，传了则为受控
+     * @zh-Hant 是否打開，傳了則為受控
      */
     isOpen?: boolean;
     /**
      * @en default open state
      * @zh 默认打开状态
+     * @zh-Hant 預設打開狀態
      */
     defaultOpen?: boolean;
     /**
      * @en Callback when disclosure is closed
      * @zh 关闭时的回调
+     * @zh-Hant 關閉時的回調
      */
     onClose?: () => void;
     /**
      * @en Callback when disclosure is opened
      * @zh 打开时的回调
+     * @zh-Hant 打開時的回調
      */
     onOpen?: () => void;
     /**
      * @en Callback when disclosure is changed
      * @zh 状态改变时的回调
+     * @zh-Hant 狀態改變時的回調
      */
     onChange?: (isOpen: boolean | undefined) => void;
 }
@@ -2766,11 +3224,13 @@ interface UseEventSourceOptions extends EventSourceInit {
     /**
      * @en immediately open the connection, enabled by default
      * @zh 立即打开连接, 默认打开
+     * @zh-Hant 立即打開連接, 預設打開
      */
     immediate?: boolean;
     /**
      * @en Automatically reconnect when the connection is disconnected
      * @zh 连接断开时自动重连
+     * @zh-Hant 連接斷開時自動重連
      */
     autoReconnect?: UseEventSourceAutoReconnectOptions;
 }
@@ -2860,6 +3320,9 @@ declare const useEventSource: UseEventSource;
 
 /**
  * @title useMergedRef
+ * @returns 合并多个 ref 的函数
+ * @returns_en A function that merges multiple refs
+ * @returns_zh-Hant 合併多個 ref 的函數
  */
 type UseMergedRef = <T>(...refs: PossibleRef<T>[]) => (node: T | null) => void;
 type PossibleRef<T> = Ref<T> | undefined;
@@ -2877,10 +3340,12 @@ declare const use: any;
  * @title UsePreferredLanguages
  * @returns 语言偏好
  * @returns_en preferred languages
+ * @returns_zh-Hant 語言偏好
  */
 type UsePreferredLanguages = (
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en defaule value
  */ defaultLanguages?: string[]) => string[];
 
@@ -2892,6 +3357,7 @@ declare const usePreferredLanguages: UsePreferredLanguages;
 interface UseBroadcastChannelOptions {
     /**
      * @zh 频道名称
+     * @zh-Hant 頻道名稱
      * @en channel name
      */
     name: string;
@@ -2902,6 +3368,7 @@ interface UseBroadcastChannelOptions {
 type UseBroadcastChannel = <D, P>(
 /**
  * @zh 选项
+ * @zh-Hant 選項
  * @en options
  */
 options: UseBroadcastChannelOptions) => UseBroadcastChannelReturn<D, P>;
@@ -2911,41 +3378,49 @@ options: UseBroadcastChannelOptions) => UseBroadcastChannelReturn<D, P>;
 interface UseBroadcastChannelReturn<D, P> {
     /**
      * @zh 是否支持
+     * @zh-Hant 是否支援
      * @en is supported
      */
     readonly isSupported: boolean;
     /**
      * @zh 频道
+     * @zh-Hant 頻道
      * @en channel
      */
     readonly channel: BroadcastChannel | undefined;
     /**
      * @zh 数据
+     * @zh-Hant 資料
      * @en data
      */
     readonly data: D | undefined;
     /**
      * @zh 发送数据
+     * @zh-Hant 發送資料
      * @en post data
      */
     readonly post: (data: P) => void;
     /**
      * @zh 关闭
+     * @zh-Hant 關閉
      * @en close
      */
     readonly close: () => void;
     /**
      * @zh 错误
+     * @zh-Hant 錯誤
      * @en error
      */
     readonly error: Event | null;
     /**
      * @zh 是否关闭
+     * @zh-Hant 是否關閉
      * @en is closed
      */
     readonly isClosed: boolean;
     /**
      * @zh 时间戳
+     * @zh-Hant 時間戳
      * @en timestamp
      */
     readonly timeStamp: number;
@@ -2967,10 +3442,17 @@ declare const useBroadcastChannel: UseBroadcastChannel;
  * - setTrue: 将值设置为 true 的函数。
  * - setFalse: 将值设置为 false 的函数。
  * - toggle: 切换布尔值的函数。
+ * @returns_zh-Hant 包含以下屬性的物件：
+ * - value: 當前的布林值。
+ * - setValue: 直接設定布林值的函數。
+ * - setTrue: 將值設定為 true 的函數。
+ * - setFalse: 將值設定為 false 的函數。
+ * - toggle: 切換布林值的函數。
  */
 type UseBoolean = (
 /**
  * @zh 初始值，默认为 false
+ * @zh-Hant 初始值，預設為 false
  * @en The initial boolean value. Defaults to false.
  */
 initialValue?: boolean) => {
@@ -2993,6 +3475,7 @@ type UseDevicePixelRatio = () => UseDevicePixelRatioReturn;
 interface UseDevicePixelRatioReturn {
     /**
      * @zh 像素比率
+     * @zh-Hant 像素比率
      * @en Pixel ratio
      */
     pixelRatio: number;
@@ -3007,6 +3490,7 @@ type UseElementByPoint = <M extends boolean = false>(
 /**
  * @en options
  * @zh 配置项
+ * @zh-Hant 配置項
  */
 options: UseElementByPointOptions<M>) => UseElementByPointReturn<M>;
 /**
@@ -3074,16 +3558,19 @@ interface UseFetchEventSourceAutoReconnectOptions {
     /**
      * @en The number of retries, if it is a function, it will be called to determine whether to retry
      * @zh 重试次数，如果是函数，会调用来判断是否重试
+     * @zh-Hant 重試次數，如果是函數，會調用來判斷是否重試
      */
     retries?: number | (() => boolean);
     /**
      * @en The delay time before reconnecting (ms)
      * @zh 重连前的延迟时间（毫秒）
+     * @zh-Hant 重連前的延遲時間（毫秒）
      */
     delay?: number;
     /**
      * @en Callback when reconnection fails
      * @zh 重连失败时的回调
+     * @zh-Hant 重連失敗時的回調
      */
     onFailed?: () => void;
 }
@@ -3234,15 +3721,20 @@ declare const useFetchEventSource: UseFetchEventSource;
  * - map: 当前的 Map 实例。
  * - set: 在 map 中设置键值对的函数。
  * - get: 通过键从 map 中获取值的函数。
- * - remove: 从 map 中删除键并返回是否存在的函数。
- * - has: 检查键是否存在于 map 中的函数。
- * - clear: 清除 map 中所有条目的函数。
- * - reset: 将 map 重置为其初始状态的函数。
- * - size: map 的当前大小。
+ * @returns_zh-Hant 包含以下屬性的對象：
+ * - map: 當前的 Map 實例。
+ * - set: 在 map 中設定鍵值對的函數。
+ * - get: 通過鍵從 map 中獲取值的函數。
+ * - remove: 從 map 中刪除鍵並返回是否存在的函數。
+ * - has: 檢查鍵是否存在於 map 中的函數。
+ * - clear: 清除 map 中所有條目的函數。
+ * - reset: 將 map 重置為其初始狀態的函數。
+ * - size: map 的當前大小。
  */
 type UseMap<K = any, V = any> = (
 /**
  * @zh 初始值，可以为 Map 实例、数组或者一个初始化的函数
+ * @zh-Hant 初始值，可以為 Map 實例、數組或者一個初始化的函數
  * @en The initial value of the map. It can be a Map instance, an array of key-value pairs, or a function that returns initial entries.
  */
 initialValue?: Map<K, V> | readonly (readonly [K, V])[] | (() => Map<K, V> | readonly (readonly [K, V])[])) => {
@@ -3265,45 +3757,53 @@ interface UseColorModeOptions<T extends string = string> {
     /**
      * @en CSS Selector for the target element applying to
      * @zh 适用于目标元素的 CSS 选择器
+     * @zh-Hant 適用於目標元素的 CSS 選擇器
      * @defaultValue 'html'
      */
     selector?: string;
     /**
      * @en HTML attribute applying the target element
      * @zh 应用到目标元素的 html 属性
+     * @zh-Hant 應用到目標元素的 html 屬性
      * @defaultValue 'class'
      */
     attribute?: string;
     /**
      * @en Available color modes
      * @zh 可用的颜色模式
+     * @zh-Hant 可用的顏色模式
      */
     modes: T[];
     /**
      * @en Default color mode
      * @zh 默认颜色模式
+     * @zh-Hant 預設顏色模式
      */
     defaultValue?: T;
     /**
      * @en Key to persist the data into localStorage/sessionStorage.
      * @zh 将数据持久保存到 localStorage/sessionStorage 的键值
+     * @zh-Hant 將資料持久保存到 localStorage/sessionStorage 的鍵值
      * @defaultValue 'reactuses-color-mode'
      */
     storageKey?: string;
     /**
      * @en Storage object, can be localStorage or sessionStorage
      * @zh 存储对象，可以是localStorage或sessionStorage
+     * @zh-Hant 儲存對象，可以是localStorage或sessionStorage
      * @defaultValue `localStorage`
      */
     storage?: () => Storage | undefined;
     /**
      * @en Function to get initial color mode from system preference
      * @zh 从系统偏好获取初始颜色模式的函数
+     * @zh-Hant 從系統偏好獲取初始顏色模式的函數
      */
     initialValueDetector?: () => T;
     /**
      * @en Mapping of color modes to their corresponding class names or attribute values
      * @zh 颜色模式到对应类名或属性值的映射
+     * @zh-Hant 顏色模式到對應類名或屬性值的映射
      */
     modeClassNames?: Partial<Record<T, string>>;
 }
@@ -3317,6 +3817,10 @@ interface UseColorModeOptions<T extends string = string> {
  * - 当前颜色模式值。
  * - 设置颜色模式的函数。
  * - 循环切换可用模式的函数。
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 當前顏色模式值。
+ * - 設定顏色模式的函數。
+ * - 循環切換可用模式的函數。
  */
 type UseColorMode<T extends string = string> = (options: UseColorModeOptions<T>) => readonly [
     T | null,
@@ -3386,6 +3890,7 @@ interface UseSpeechRecognitionOptions {
      * Controls whether continuous results are returned for each recognition, or only a single result.
      *
      * @zh 控制是否为每次识别返回连续结果，或仅返回单个结果
+     * @zh-Hant 控制是否為每次識別返回連續結果，或僅返回單個結果
      * @en Controls whether continuous results are returned for each recognition, or only a single result
      * @default true
      */
@@ -3394,6 +3899,7 @@ interface UseSpeechRecognitionOptions {
      * Controls whether interim results should be returned (true) or not (false.) Interim results are results that are not yet final
      *
      * @zh 控制是否应返回临时结果（true）或不返回（false）。临时结果是尚未最终确定的结果
+     * @zh-Hant 控制是否應返回臨時結果（true）或不返回（false）。臨時結果是尚未最終確定的結果
      * @en Controls whether interim results should be returned (true) or not (false.) Interim results are results that are not yet final
      * @default true
      */
@@ -3402,6 +3908,7 @@ interface UseSpeechRecognitionOptions {
      * Language for SpeechRecognition
      *
      * @zh 语音识别的语言
+     * @zh-Hant 語音識別的語言
      * @en Language for SpeechRecognition
      * @default 'en-US'
      */
@@ -3410,6 +3917,7 @@ interface UseSpeechRecognitionOptions {
      * A number representing the maximum returned alternatives for each result.
      *
      * @zh 表示每个结果返回的最大备选项数量的数字
+     * @zh-Hant 表示每個結果返回的最大備選項數量的數字
      * @en A number representing the maximum returned alternatives for each result
      * @see https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition/maxAlternatives
      * @default 1
@@ -3438,55 +3946,75 @@ interface UseSpeechRecognitionOptions {
  * - Function to toggle listening state.
  * - Function to start listening.
  * - Function to stop listening.
+ * @returns_zh-Hant 包含以下元素的對象：
+ * - 是否支持語音識別。
+ * - 是否正在監聽。
+ * - 識別結果是否為最終結果。
+ * - SpeechRecognition 實例。
+ * - 識別結果文本。
+ * - 錯誤信息。
+ * - 切換監聽狀態的函數。
+ * - 開始監聽的函數。
+ * - 停止監聽的函數。
  */
 type UseSpeechRecognition = (
 /**
  * @zh 可选的语音识别配置参数
+ * @zh-Hant 可選的語音識別配置參數
  * @en Optional speech recognition configuration options
  */
 options?: UseSpeechRecognitionOptions) => {
     /**
      * @zh 浏览器是否支持语音识别
+     * @zh-Hant 瀏覽器是否支持語音識別
      * @en Whether the browser supports speech recognition
      */
     readonly isSupported: boolean;
     /**
      * @zh 是否正在监听
+     * @zh-Hant 是否正在監聽
      * @en Whether currently listening
      */
     readonly isListening: boolean;
     /**
      * @zh 识别结果是否为最终结果
+     * @zh-Hant 識別結果是否為最終結果
      * @en Whether the recognition result is final
      */
     readonly isFinal: boolean;
     /**
      * @zh SpeechRecognition 实例
+     * @zh-Hant SpeechRecognition 實例
      * @en SpeechRecognition instance
      */
     readonly recognition: SpeechRecognition | undefined;
     /**
      * @zh 识别结果文本
+     * @zh-Hant 識別結果文本
      * @en Recognition result text
      */
     readonly result: string;
     /**
      * @zh 错误信息
+     * @zh-Hant 錯誤信息
      * @en Error information
      */
     readonly error: SpeechRecognitionErrorEvent | undefined;
     /**
      * @zh 切换监听状态
+     * @zh-Hant 切換監聽狀態
      * @en Toggle listening state
      */
     readonly toggle: (value?: boolean, startOptions?: Partial<UseSpeechRecognitionOptions>) => void;
     /**
      * @zh 开始监听
+     * @zh-Hant 開始監聽
      * @en Start listening
      */
     readonly start: (startOptions?: Partial<UseSpeechRecognitionOptions>) => void;
     /**
      * @zh 停止监听
+     * @zh-Hant 停止監聽
      * @en Stop listening
      */
     readonly stop: () => void;
@@ -3499,10 +4027,12 @@ declare const useSpeechRecognition: UseSpeechRecognition;
  * @title useDocumentVisiblity
  * @returns_en document visibility
  * @returns 文档可见性
+ * @returns_zh-Hant 文檔可見性
  */
 type UseDocumentVisibility = (
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en default value
  */
 defaultValue?: DocumentVisibilityState) => DocumentVisibilityState;
@@ -3513,11 +4043,13 @@ defaultValue?: DocumentVisibilityState) => DocumentVisibilityState;
 type UseEventListener = (
 /**
  * @zh 事件名称
+ * @zh-Hant 事件名稱
  * @en event name
  */
 eventName: string, 
 /**
  * @zh 事件处理器
+ * @zh-Hant 事件處理器
  * @en event handler
  */
 handler: (event: any) => void, 
@@ -3539,16 +4071,19 @@ options?: boolean | AddEventListenerOptions | undefined) => void;
 type UseFavicon = (
 /**
  * @zh 图标路径
+ * @zh-Hant 圖標路徑
  * @en icon href
  */
 href: string, 
 /**
  * @zh 基础 url
+ * @zh-Hant 基礎 url
  * @en base url
  */
 baseUrl?: string, 
 /**
  * @zh 设置 link 标签的 rel 属性
+ * @zh-Hant 設定 link 標籤的 rel 屬性
  * @en set rel attribute to link element
  * @defaultValue icon
  */
@@ -3562,20 +4097,26 @@ rel?: string) => void;
  * @returns_en A tuple with the following elements:
  * - The current value of the localStorage.
  * - A function to update the value of the localStorage.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - localStorage 的當前值。
+ * - 更新 localStorage 值的函數。
  */
 type UseLocalStorage = <T extends string | number | boolean | object | null>(
 /**
  * @zh 键值
+ * @zh-Hant 鍵值
  * @en key
  */
 key: string, 
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en default value
  */
 defaultValue?: T, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseLocalStorageOptions<T>) => readonly [T | null, Dispatch<SetStateAction<T | null>>];
@@ -3586,28 +4127,33 @@ interface UseLocalStorageOptions<T> {
     /**
      * @en Custom data serialization
      * @zh 自定义数据序列化
+     * @zh-Hant 自訂資料序列化
      */
     serializer?: UseLocalStorageSerializer<T>;
     /**
      * @en On error callback
      * @zh 错误回调
+     * @zh-Hant 錯誤回呼
      * @defaultValue `console.error`
      */
     onError?: (error: unknown) => void;
     /**
      * @en set to storage when nodata in first mount, deprecated
      * @zh 首次挂载时没有数据时设置到 storage, 已弃用
+     * @zh-Hant 首次掛載時沒有資料時設定到 storage，已棄用
      * @deprecated
      */
     effectStorageValue?: T | (() => T);
     /**
      * @en set to storage when nodata in first mount
      * @zh 首次挂载时没有数据时设置到 storage
+     * @zh-Hant 首次掛載時沒有資料時設定到 storage
      */
     mountStorageValue?: T | (() => T);
     /**
      * @en listen to storage changes
      * @zh 监听 storage 变化
+     * @zh-Hant 監聽 storage 變化
      * @defaultValue `true`
      */
     listenToStorageChanges?: boolean;
@@ -3619,11 +4165,13 @@ interface UseLocalStorageSerializer<T> {
     /**
      * @en Custom data read
      * @zh 自定义数据读取
+     * @zh-Hant 自訂資料讀取
      */
     read: (raw: string) => T;
     /**
      * @en Custom data write
      * @zh 自定义数据写入
+     * @zh-Hant 自訂資料寫入
      */
     write: (value: T) => string;
 }
@@ -3632,6 +4180,7 @@ interface UseLocalStorageSerializer<T> {
  * @title useMountedState
  * @returns 组件的挂载状态
  * @returns_en component mounted state
+ * @returns_zh-Hant 組件的挂載狀態
  */
 type UseMountedState = () => () => boolean;
 
@@ -3639,6 +4188,7 @@ type UseMountedState = () => () => boolean;
  * @title usePageLeave
  * @returns 鼠标是否离开页面
  * @returns_en whether the mouse leave page
+ * @returns_zh-Hant 滑鼠是否離開頁面
  */
 type UsePageLeave = () => boolean;
 
@@ -3646,10 +4196,12 @@ type UsePageLeave = () => boolean;
  * @title usePreferredDark
  * @returns 是否偏好黑色
  * @returns_en whether prefer dark
+ * @returns_zh-Hant 是否偏好黑色
  */
 type UsePreferredDark = (
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en defaule value
  */
 defaultState?: boolean) => boolean;
@@ -3658,10 +4210,12 @@ defaultState?: boolean) => boolean;
  * @title usePrevious
  * @returns 更新前的值
  * @returns_en previous value
+ * @returns_zh-Hant 更新前的值
  */
 type UsePrevious = <T>(
 /**
  * @zh 状态值
+ * @zh-Hant 狀態值
  * @en state value
  */
 state: T) => T | undefined;
@@ -3674,10 +4228,14 @@ state: T) => T | undefined;
  * @returns_en A tuple with the following elements:
  * - the state value
  * - a function to update state in `requestAnimationFrame`
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - state 的當前值。
+ * - 在 `requestAnimationFrame` 中更新 state 值的函數。
  */
 type UseRafState = <S>(
 /**
  * @zh 状态值
+ * @zh-Hant 狀態值
  * @en state value
  */
 initialState: S | (() => S)) => readonly [S, Dispatch<SetStateAction<S>>];
@@ -3686,10 +4244,12 @@ initialState: S | (() => S)) => readonly [S, Dispatch<SetStateAction<S>>];
  * @title useReducedMotion
  * @returns 是否偏好减少动画
  * @returns_en whether prefer reduced motion
+ * @returns_zh-Hant 是否偏好減少動畫
  */
 type UseReducedMotion = (
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en default value
  */
 defaultState?: boolean) => boolean;
@@ -3707,6 +4267,12 @@ defaultState?: boolean) => boolean;
  * - right safe distance
  * - bottom safe distance
  * - left safe distance
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - 頂部安全距離。
+ * - 右邊安全距離。
+ * - 底部安全距離。
+ * - 左邊安全距離，
+ * - 手動更新函數
  * - munual update function
  */
 type UseScreenSafeArea = () => readonly [string, string, string, string, DebouncedFunc$1<() => void>];
@@ -3719,20 +4285,26 @@ type UseScreenSafeArea = () => readonly [string, string, string, string, Debounc
  * @returns_en A tuple with the following elements:
  * - The current value of the sessionStorage.
  * - A function to update the value of the sessionStorage.
+ * @returns_zh-Hant 包含以下元素的元組：
+ * - sessionStorage 的當前值。
+ * - 更新 sessionStorage 值的函數。
  */
 type UseSessionStorage = <T extends string | number | boolean | object | null>(
 /**
  * @zh 键值
+ * @zh-Hant 鍵值
  * @en key
  */
 key: string, 
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en default value
  */
 defaultValue?: T, 
 /**
  * @zh 可选参数
+ * @zh-Hant 可選參數
  * @en optional params
  */
 options?: UseSessionStorageOptions<T>) => readonly [T | null, Dispatch<SetStateAction<T | null>>];
@@ -3743,28 +4315,33 @@ interface UseSessionStorageOptions<T> {
     /**
      * @en Custom data serialization
      * @zh 自定义数据序列化
+     * @zh-Hant 自定義數據序列化
      */
     serializer?: UseSessionStorageSerializer<T>;
     /**
      * @en On error callback
      * @zh 错误回调
+     * @zh-Hant 錯誤回調
      * @defaultValue `console.error`
      */
     onError?: (error: unknown) => void;
     /**
      * @en set to storage when nodata in first mount, deprecated
      * @zh 首次挂载时没有数据时设置到 storage, 已弃用
+     * @zh-Hant 首次掛載時沒有數據時設置到 storage, 已棄用
      * @deprecated
      */
     effectStorageValue?: T | (() => T);
     /**
      * @en set to storage when nodata in first mount
      * @zh 首次挂载时没有数据时设置到 storage
+     * @zh-Hant 首次掛載時沒有數據時設置到 storage
      */
     mountStorageValue?: T | (() => T);
     /**
      * @en listen to storage changes
      * @zh 监听 storage 变化
+     * @zh-Hant 監聽 storage 變化
      * @defaultValue `true`
      */
     listenToStorageChanges?: boolean;
@@ -3776,11 +4353,13 @@ interface UseSessionStorageSerializer<T> {
     /**
      * @en Custom data read
      * @zh 自定义数据读取
+     * @zh-Hant 自定義數據讀取
      */
     read: (raw: string) => T;
     /**
      * @en Custom data write
      * @zh 自定义数据写入
+     * @zh-Hant 自定義數據寫入
      */
     write: (value: T) => string;
 }
@@ -3789,15 +4368,18 @@ interface UseSessionStorageSerializer<T> {
  * @title useSupported
  * @returns 浏览器是否支持
  * @returns_en whether the browser support
+ * @returns_zh-Hant 瀏覽器是否支援
  */
 type UseSupported = (
 /**
  * @zh 测试回调
+ * @zh-Hant 測試回調
  * @en test callback
  */
 callback: () => unknown, 
 /**
  * @zh 使用 useLayoutEffect来进行测试
+ * @zh-Hant 使用 useLayoutEffect來進行測試
  * @en use useLayoutEffect to test
  * @defaultValue false
  */
@@ -3813,20 +4395,27 @@ sync?: boolean) => boolean;
  * - run：执行函数。
  * - cancel：取消执行函数。
  * - flush: 立即执行函数
+ * @returns_zh-Hant 具有以下元素的對象:
+ * - run：執行函數。
+ * - cancel：取消執行函數。
+ * - flush: 立即執行函數
  */
 type UseThrottleFn = <T extends (...args: any) => any>(
 /**
  * @zh 要节流的函数
+ * @zh-Hant 要節流的函數
  * @en Throttle function
  */
 fn: T, 
 /**
  * @zh 间隔时间
+ * @zh-Hant 間隔時間
  * @en wait time
  */
 wait?: number, 
 /**
  * @zh 传递给 `lodash.throttle` 的属性
+ * @zh-Hant 傳遞給 `lodash.throttle` 的屬性
  * @en options passed to `lodash.throttle`
  */
 options?: ThrottleSettings$1) => {
@@ -3841,6 +4430,7 @@ options?: ThrottleSettings$1) => {
 type UseUnmount = (
 /**
  * @zh 清理函数
+ * @zh-Hant 清理函數
  * @en clear function
  */
 fn: () => void) => void;
@@ -3849,6 +4439,7 @@ fn: () => void) => void;
  * @title useUpdate
  * @returns 强制更新函数
  * @returns_en rerender trigger function
+ * @returns_zh-Hant 強制更新函數
  */
 type UseUpdate = () => () => void;
 
@@ -3856,10 +4447,12 @@ type UseUpdate = () => () => void;
  * @title useWindowsFocus
  * @returns 窗口是否聚焦
  * @returns_en whether window focus
+ * @returns_zh-Hant 窗口是否聚焦
  */
 type UseWindowsFocus = (
 /**
  * @zh 默认值
+ * @zh-Hant 預設值
  * @en defauleValue
  */
 defauleValue?: boolean) => boolean;
@@ -3868,6 +4461,7 @@ defauleValue?: boolean) => boolean;
  * @title useMobileLandscape
  * @returns 是否是移动端横屏
  * @returns_en whether is mobile landscape
+ * @returns_zh-Hant 是否是行動端橫屏
  */
 type UseMobileLandscape = () => boolean;
 
@@ -3894,13 +4488,15 @@ type Usable<T> = Thenable<T> | Context<T>;
  * @title Use
  * @returns 解析状态值
  * @returns_en resolved state value
+ * @returns_zh-Hant 解析狀態值
  */
 type Use = <T>(
 /**
  * @zh promise 或者 context
+ * @zh-Hant promise 或者 context
  * @en promise or context
  */
 usable: Usable<T>) => T;
 
-export { assignRef, defaultOptions, mergeRefs, use, useActiveElement, useAsyncEffect, useBoolean, useBroadcastChannel, useClickOutside as useClickAway, useClickOutside, useClipboard, useColorMode, useControlled, useCookie, useClipboard as useCopyToClipboard, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDevicePixelRatio, useDisclosure, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementByPoint, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEventSource, useEyeDropper, useFavicon, useFetchEventSource, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMap, useMeasure, useMediaDevices, useMediaQuery, useMergedRefs, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePreferredLanguages, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSpeechRecognition, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };
-export type { ColorScheme, Contrast, DepsEqualFnType, EventSourceStatus, EventType, INetworkInformation, IUseNetworkState, KeyModifier, Pausable, Platform, PossibleRef, Use, UseActiveElement, UseAsyncEffect, UseBoolean, UseBroadcastChannel, UseBroadcastChannelOptions, UseBroadcastChannelReturn, UseClickOutside, UseClipboard, UseColorMode, UseColorModeOptions, UseControlled, UseCookie, UseCookieState, UseCountDown, UseCounter, UseCssVar, UseCssVarOptions, UseCustomCompareEffect, UseCycleList, UseDarkMode, UseDarkOptions, UseDebounce, UseDebounceFn, UseDeepCompareEffect, UseDevicePixelRatio, UseDevicePixelRatioReturn, UseDisclosure, UseDisclosureProps, UseDocumentVisibility, UseDoubleClick, UseDoubleClickProps, UseDraggable, UseDraggableOptions, UseDropZone, UseElementBounding, UseElementBoundingOptions, UseElementBoundingReturn, UseElementByPoint, UseElementByPointOptions, UseElementByPointReturn, UseElementSize, UseElementVisibility, UseEvent, UseEventEmitter, UseEventEmitterDisposable, UseEventEmitterEvent, UseEventEmitterEventOnce, UseEventEmitterListener, UseEventEmitterReturn, UseEventListener, UseEventSource, UseEventSourceAutoReconnectOptions, UseEventSourceOptions, UseEventSourceReturn, UseEyeDropper, UseEyeDropperOpenOptions, UseEyeDropperOpenReturnType, UseFavicon, UseFetchEventSource, UseFetchEventSourceAutoReconnectOptions, UseFetchEventSourceMessage, UseFetchEventSourceOptions, UseFetchEventSourceReturn, UseFetchEventSourceStatus, UseFileDialog, UseFileDialogOptions, UseFirstMountState, UseFocus, UseFps, UseFpsOptions, UseFullScreenOptions, UseFullscreen, UseGeolocation, UseHover, UseIdle, UseInfiniteScroll, UseInfiniteScrollArrivedState, UseInfiniteScrollDirection, UseInfiniteScrollLoadMore, UseInfiniteScrollOptions, UseIntersectionObserver, UseInterval, UseIntervalOptions, UseKeyModifier, UseLatest, UseLocalStorage, UseLocalStorageOptions, UseLocalStorageSerializer, UseLocationSelector, UseLongPress, UseLongPressOptions, UseMap, UseMeasure, UseMeasureRect, UseMediaDeviceOptions, UseMediaDevices, UseMediaQuery, UseMergedRef, UseMobileLandscape, UseModifierOptions, UseMount, UseMountedState, UseMouse, UseMouseCursorState, UseMousePressed, UseMousePressedOptions, UseMousePressedSourceType, UseMutationObserver, UseNetwork, UseObjectUrl, UseOnline, UseOrientation, UseOrientationLockType, UseOrientationState, UseOrientationType, UsePageLeave, UsePermission, UsePermissionDescriptorNamePolyfill, UsePermissionGeneralPermissionDescriptor, UsePermissionState, UsePlatform, UsePlatformProps, UsePlatformReturn, UsePreferredColorScheme, UsePreferredContrast, UsePreferredDark, UsePreferredLanguages, UsePrevious, UseRafFn, UseRafState, UseReducedMotion, UseResizeObserver, UseScreenSafeArea, UseScriptTag, UseScriptTagOptions, UseScriptTagStatus, UseScroll, UseScrollArrivedState, UseScrollDirection, UseScrollIntoView, UseScrollIntoViewAnimation, UseScrollIntoViewParams, UseScrollLock, UseScrollOffset, UseScrollOptions, UseSessionStorage, UseSessionStorageOptions, UseSessionStorageSerializer, UseSetState, UseSpeechRecognition, UseSpeechRecognitionOptions, UseSpeechRecognitionReturn, UseSticky, UseStickyParams, UseSupported, UseTextDirection, UseTextDirectionOptions, UseTextDirectionValue, UseTextSelection, UseThrottle, UseThrottleFn, UseTimeout, UseTimeoutFn, UseTimeoutFnOptions, UseTimeoutOptions, UseTitle, UseToggle, UseUnmount, UseUpdate, UseWebNotification, UseWebNotificationReturn, UseWebNotificationShow, UseWindowScroll, UseWindowScrollState, UseWindowSize, UseWindowsFocus };
+export { assignRef, defaultOptions, mergeRefs, use, useActiveElement, useAsyncEffect, useBoolean, useBroadcastChannel, useClickOutside as useClickAway, useClickOutside, useClipboard, useColorMode, useControlled, useCookie, useClipboard as useCopyToClipboard, useCountDown, useCounter, useCssVar, useCustomCompareEffect, useCycleList, useDarkMode, useDebounce, useDebounceFn, useDeepCompareEffect, useDevicePixelRatio, useDisclosure, useDocumentVisibility, useDoubleClick, useDraggable, useDropZone, useElementBounding, useElementByPoint, useElementSize, useElementVisibility, useEvent, useEventEmitter, useEventListener, useEventSource, useEyeDropper, useFavicon, useFetchEventSource, useFileDialog, useFirstMountState, useFocus, useFps, useFullscreen, useGeolocation, useHover, useIdle, useInfiniteScroll, useIntersectionObserver, useInterval, useIsomorphicLayoutEffect, useKeyModifier, useLatest, useLocalStorage, useLocationSelector, useLongPress, useMap, useMeasure, useMediaDevices, useMediaQuery, useMergedRefs, useMobileLandscape, useMount, useMountedState, useMouse, useMousePressed, useMutationObserver, useNetwork, useObjectUrl, useOnceEffect, useOnceLayoutEffect, useOnline, useOrientation, usePageLeave, usePermission, usePlatform, usePreferredColorScheme, usePreferredContrast, usePreferredDark, usePreferredLanguages, usePrevious, useRafFn, useRafState, useReducedMotion, useResizeObserver, useScratch, useScreenSafeArea, useScriptTag, useScroll, useScrollIntoView, useScrollLock, useSessionStorage, useSetState, useSpeechRecognition, useSticky, useSupported, useTextDirection, useTextSelection, useThrottle, useThrottleFn, useTimeout, useTimeoutFn, useTitle, useToggle, useUnmount, useUpdate, useUpdateEffect, useUpdateLayoutEffect, useWebNotification, useWindowScroll, useWindowSize, useWindowsFocus };
+export type { ColorScheme, Contrast, DepsEqualFnType, EventSourceStatus, EventType, INetworkInformation, IUseNetworkState, KeyModifier, Pausable, Platform, PossibleRef, Use, UseActiveElement, UseAsyncEffect, UseBoolean, UseBroadcastChannel, UseBroadcastChannelOptions, UseBroadcastChannelReturn, UseClickOutside, UseClipboard, UseColorMode, UseColorModeOptions, UseControlled, UseCookie, UseCookieState, UseCountDown, UseCounter, UseCssVar, UseCssVarOptions, UseCustomCompareEffect, UseCycleList, UseDarkMode, UseDarkOptions, UseDebounce, UseDebounceFn, UseDeepCompareEffect, UseDevicePixelRatio, UseDevicePixelRatioReturn, UseDisclosure, UseDisclosureProps, UseDocumentVisibility, UseDoubleClick, UseDoubleClickProps, UseDraggable, UseDraggableOptions, UseDropZone, UseElementBounding, UseElementBoundingOptions, UseElementBoundingReturn, UseElementByPoint, UseElementByPointOptions, UseElementByPointReturn, UseElementSize, UseElementVisibility, UseEvent, UseEventEmitter, UseEventEmitterDisposable, UseEventEmitterEvent, UseEventEmitterEventOnce, UseEventEmitterListener, UseEventEmitterReturn, UseEventListener, UseEventSource, UseEventSourceAutoReconnectOptions, UseEventSourceOptions, UseEventSourceReturn, UseEyeDropper, UseEyeDropperOpenOptions, UseEyeDropperOpenReturnType, UseFavicon, UseFetchEventSource, UseFetchEventSourceAutoReconnectOptions, UseFetchEventSourceMessage, UseFetchEventSourceOptions, UseFetchEventSourceReturn, UseFetchEventSourceStatus, UseFileDialog, UseFileDialogOptions, UseFirstMountState, UseFocus, UseFps, UseFpsOptions, UseFullScreenOptions, UseFullscreen, UseGeolocation, UseHover, UseIdle, UseInfiniteScroll, UseInfiniteScrollArrivedState, UseInfiniteScrollDirection, UseInfiniteScrollLoadMore, UseInfiniteScrollOptions, UseIntersectionObserver, UseInterval, UseIntervalOptions, UseKeyModifier, UseLatest, UseLocalStorage, UseLocalStorageOptions, UseLocalStorageSerializer, UseLocationSelector, UseLongPress, UseLongPressOptions, UseMap, UseMeasure, UseMeasureRect, UseMediaDeviceOptions, UseMediaDevices, UseMediaQuery, UseMergedRef, UseMobileLandscape, UseModifierOptions, UseMount, UseMountedState, UseMouse, UseMouseCursorState, UseMousePressed, UseMousePressedOptions, UseMousePressedSourceType, UseMutationObserver, UseNetwork, UseObjectUrl, UseOnline, UseOrientation, UseOrientationLockType, UseOrientationState, UseOrientationType, UsePageLeave, UsePermission, UsePermissionDescriptorNamePolyfill, UsePermissionGeneralPermissionDescriptor, UsePermissionState, UsePlatform, UsePlatformProps, UsePlatformReturn, UsePreferredColorScheme, UsePreferredContrast, UsePreferredDark, UsePreferredLanguages, UsePrevious, UseRafFn, UseRafState, UseReducedMotion, UseResizeObserver, UseScratch, UseScratchOptions, UseScratchState, UseScreenSafeArea, UseScriptTag, UseScriptTagOptions, UseScriptTagStatus, UseScroll, UseScrollArrivedState, UseScrollDirection, UseScrollIntoView, UseScrollIntoViewAnimation, UseScrollIntoViewParams, UseScrollLock, UseScrollOffset, UseScrollOptions, UseSessionStorage, UseSessionStorageOptions, UseSessionStorageSerializer, UseSetState, UseSpeechRecognition, UseSpeechRecognitionOptions, UseSpeechRecognitionReturn, UseSticky, UseStickyParams, UseSupported, UseTextDirection, UseTextDirectionOptions, UseTextDirectionValue, UseTextSelection, UseThrottle, UseThrottleFn, UseTimeout, UseTimeoutFn, UseTimeoutFnOptions, UseTimeoutOptions, UseTitle, UseToggle, UseUnmount, UseUpdate, UseWebNotification, UseWebNotificationReturn, UseWebNotificationShow, UseWindowScroll, UseWindowScrollState, UseWindowSize, UseWindowsFocus };