@zero-library/common 2.1.11 → 2.2.0

package/dist/index.d.ts

@@ -3,8 +3,9 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 import dayjs from 'dayjs';
 import Decimal from 'decimal.js';
+import { RuleObject } from 'antd/es/form';
+import * as axios from 'axios';
 import { AxiosRequestConfig } from 'axios';
-import { ThemeConfig } from 'antd/lib';
 
 /**
  * 音频播放器组件属性接口
@@ -18,7 +19,7 @@ interface AudioPlayerProps {
  * 提供基本的音频播放功能
  * @param props - 组件属性
  */
-declare const _default$b: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$m: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件图标组件属性接口
@@ -44,7 +45,7 @@ interface FileIconProps {
  * @param props - 组件属性
  * @returns 对应文件类型的图标
  */
-declare const _default$a: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
+declare const _default$l: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览组件属性接口
@@ -79,7 +80,7 @@ interface FilePreviewProps {
  * 支持图片、PDF、视频、音频、Markdown等文件格式的预览
  * @param props - 组件属性
  */
-declare const _default$9: ({ suffix, fileUrl, pdfParams, password, searchValue }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$k: ({ suffix, fileUrl, pdfParams, password, searchValue }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览抽屉组件属性接口
@@ -130,7 +131,7 @@ interface FilePreviewDrawerProps {
  * @param props - 组件属性
  * @returns 文件预览抽屉组件
  */
-declare const _default$8: ({ open, fileUrl, suffix, title, onClose, password, fileParams, pdfParams, onSetPassSuccess }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$j: ({ open, fileUrl, suffix, title, onClose, password, fileParams, pdfParams, onSetPassSuccess }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown预览组件属性接口
@@ -146,7 +147,7 @@ interface MarkdownPreviewProps {
  * 从指定URL获取Markdown内容并渲染显示
  * @param props - 组件属性
  */
-declare const _default$7: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$i: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * PDF预览组件属性接口
@@ -173,7 +174,7 @@ interface PdfPreviewProps {
  * 支持密码保护、缩略图、缩放、页面导航等功能
  * @param props - 组件属性
  */
-declare const _default$6: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$h: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 视频播放器组件属性接口
@@ -187,12 +188,14 @@ interface VideoPlayerProps {
  * 提供基本的视频播放功能
  * @param props - 组件属性
  */
-declare const _default$5: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$g: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Iframe组件属性接口
  */
 interface IframeProps {
+    /** 默认主源 */
+    defaultMainSource?: string;
     /** iframe ID */
     id?: string;
     /** iframe源地址 */
@@ -207,7 +210,7 @@ interface IframeProps {
  * 支持加载状态、URL参数处理、防缓存等功能
  * @param props - 组件属性
  */
-declare const _default$4: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
+declare const _default$f: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
 
 /**
  * 组件映射类型，用于延时加载
@@ -232,7 +235,7 @@ interface LazyComponentProps {
  * 使用示例：<LazyComponent type="renderMarkdown" data={{}} loading={true} />
  * @param props - 组件属性
  */
-declare const _default$3: ({ type, customComponents, ...rest }: LazyComponentProps) => react_jsx_runtime.JSX.Element;
+declare const _default$e: ({ type, customComponents, ...rest }: LazyComponentProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown编辑器组件属性接口
@@ -263,7 +266,7 @@ interface MarkdownEditorProps {
  * 提供丰富的编辑功能：格式化、链接、图片、表格、高亮等
  * @param props - 组件属性
  */
-declare const _default$2: ({ value, onChange, onScrollPage, searchValue, disabled, extraNav, showToolbar, onQuote, onDownloadFile }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+declare const _default$d: ({ value, onChange, onScrollPage, searchValue, disabled, extraNav, showToolbar, onQuote, onDownloadFile }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown渲染组件属性接口
@@ -286,7 +289,7 @@ interface RenderMarkdownProps {
  * 支持自定义组件、搜索高亮、内容编辑等功能
  * @param RenderMarkdownProps - 组件属性
  */
-declare const _default$1: ({ content, searchValue, customComponents, onChange, onPartialChange }: RenderMarkdownProps) => react_jsx_runtime.JSX.Element;
+declare const _default$c: ({ content, searchValue, customComponents, onChange, onPartialChange }: RenderMarkdownProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 渲染控制对象类型
@@ -338,7 +341,8 @@ interface RenderWrapperProps<C, P> {
  * @param props - 组件属性
  * @returns 渲染的组件或null
  */
-declare const RenderWrapper: react.ForwardRefExoticComponent<RenderWrapperProps<unknown, unknown> & react.RefAttributes<unknown>>;
+declare const _default$b: react.ForwardRefExoticComponent<RenderWrapperProps<unknown, unknown> & react.RefAttributes<unknown>>;
+
 /**
  * 判断是否应该渲染组件
  * @param control - 渲染控制配置
@@ -373,24 +377,94 @@ interface UserAvatarProps {
  * 如果没有头像图片，则显示用户名首字母作为头像
  * @param props - 组件属性
  */
-declare const _default: ({ size, avatarSrc, userName }: UserAvatarProps) => react_jsx_runtime.JSX.Element;
+declare const _default$a: ({ size, avatarSrc, userName }: UserAvatarProps) => react_jsx_runtime.JSX.Element;
 
+/**
+ * iframe 消息参数类型
+ * 定义跨iframe通信时的参数结构
+ */
 type Params = Record<string, any>;
 /**
- * 通知当前页面的父页面或者顶级窗口
+ * 向父页面或顶级窗口发送消息
+ * @param type - 消息类型
+ * @param data - 消息数据
+ * @param to - 发送目标，默认为'top'
  */
 declare function emit(type: string, data?: Params, to?: 'parent' | 'top'): void;
 /**
- * 通知某个子 iframe 窗口（必须传入 iframe.contentWindow）
+ * 向子iframe发送消息
+ * @param iframeWindow - 目标iframe的contentWindow
+ * @param type - 消息类型
+ * @param data - 消息数据
+ * @param origin - 消息源，默认为'*'
  */
 declare function emitToChild(iframeWindow: Window | null, type: string, data?: Params, origin?: string): void;
 
+/**
+ * 消息处理器函数类型定义
+ * @template P 参数类型，默认为 Params
+ * @param params 消息参数
+ * @param source 消息源窗口对象
+ * @param origin 消息来源
+ */
 type Handler<P = Params> = (params: P, source?: MessageEventSource | null, origin?: string) => void;
-declare function useIframeRelayBridge(allowedOrigins?: string[]): {
+/**
+ * iframe 消息中继桥接 Hook
+ *
+ * 提供跨 iframe 消息通信的桥接功能，支持：
+ * - 消息监听与分发
+ * - 来源验证（白名单机制）
+ * - 消息类型处理
+ * - 父子窗口通信
+ * - 顶层窗口消息转发
+ *
+ * @param allowedOrigins 允许的消息来源域名列表，默认允许所有来源
+ *
+ * @example
+ * ```tsx
+ * const { on, off } = useIframeRelayBridge(['https://example.com'])
+ *
+ * // 监听消息
+ * const handleMessage = (params, source, origin) => {
+ *   console.log('收到消息:', params)
+ * }
+ * on('custom-event', handleMessage)
+ *
+ * // 取消监听
+ * off('custom-event', handleMessage)
+ * ```
+ */
+declare const _default$9: (allowedOrigins?: string[]) => {
     on: (type: string, handler: Handler<Params>) => void;
     off: (type: string, handler: Handler<Params>) => void;
 };
 
+/**
+ * 通用的自动刷新 Hook
+ * 监听指定值的变化，当满足条件时自动触发回调函数
+ *
+ * @param listenValue - 要监听的值
+ * @param shouldRefresh - 判断是否需要触发回调的函数，接收 listenValue 作为参数
+ * @param callback - 执行刷新动作的异步方法
+ * @param delay - 延迟时间（毫秒），默认为 10000ms
+ * @returns 清理定时器的函数
+ */
+declare const _default$8: <T>(listenValue: T, shouldRefresh: (listenValue: T) => boolean, callback: () => Promise<void>, delay?: number) => void;
+
+/**
+ * 倒计时 Hook
+ * 提供倒计时功能，支持开始、暂停、完成回调等操作
+ *
+ * @param callback - 倒计时结束时的回调函数
+ * @returns 倒计时控制对象
+ */
+declare const _default$7: (callback?: () => void) => {
+    count: number;
+    start: (initialValue?: number) => void;
+    pause: () => void;
+    startCount: number;
+};
+
 /**
  * 通用的 Valtio Context 创建工厂 Hook
  * 创建 Valtio 状态管理的 Context 和 Provider
@@ -402,7 +476,7 @@ declare function useIframeRelayBridge(allowedOrigins?: string[]): {
  * @template T - Store 对象类型
  * @returns Valtio Context 相关的工具函数
  */
-declare function useCreateValtioContext<T extends object>(): {
+declare const _default$6: <T extends object>() => {
     ValtioProvider: ({ store, children }: {
         store: T;
         children?: ReactNode;
@@ -419,7 +493,7 @@ declare function useCreateValtioContext<T extends object>(): {
  * @param wait - 延迟时间（毫秒），默认为400ms
  * @returns 防抖处理后的函数，包含 flush 和 cancel 方法
  */
-declare function useDebounce<A extends Array<any>, R = void>(func: (..._args: A) => R, wait?: number): {
+declare const _default$5: <A extends Array<any>, R = void>(func: (..._args: A) => R, wait?: number) => {
     (..._args: A): Promise<R>;
     /** 添加额外方法到防抖函数 */
     flush: () => any;
@@ -433,7 +507,7 @@ declare function useDebounce<A extends Array<any>, R = void>(func: (..._args: A)
  * @param effect - 要执行的副作用函数
  * @param deps - 依赖项数组
  */
-declare function useDeepEffect(effect: React.EffectCallback, deps: any[]): void;
+declare const _default$4: (effect: React.EffectCallback, deps: any[]) => void;
 
 /**
  * 创建同时具有 ref 和 state 特性的状态 Hook
@@ -442,7 +516,7 @@ declare function useDeepEffect(effect: React.EffectCallback, deps: any[]): void;
  * @param init - 初始值
  * @returns [state, setState, getState] 元组，包含状态值、设置函数和获取函数
  */
-declare function useRefState<T>(init: T): readonly [T, (newVal: T) => void, () => T];
+declare const _default$3: <T>(init: T) => readonly [T, (newVal: T) => void, () => T];
 
 /**
  * 同步输入框组件和外部状态的 Hook
@@ -453,7 +527,7 @@ declare function useRefState<T>(init: T): readonly [T, (newVal: T) => void, () =
  * @param setStoreValue - 设置外部存储值的函数
  * @returns 包含 inputValue 和 setInputValue 的对象
  */
-declare const useSyncInput: <T>(storeValue: T, setStoreValue: (value: T) => void) => {
+declare const _default$2: <T>(storeValue: T, setStoreValue: (value: T) => void) => {
     inputValue: T;
     setInputValue: (value: T) => void;
 };
@@ -468,166 +542,367 @@ declare const useSyncInput: <T>(storeValue: T, setStoreValue: (value: T) => void
  * @param wait - 节流间隔时间（毫秒）
  * @returns 节流处理后的函数，包含 flush 和 cancel 方法
  */
-declare function useThrottle<A extends Array<any>, R = void>(func: (..._args: A) => R, wait: number): {
+declare const _default$1: <A extends Array<any>, R = void>(func: (..._args: A) => R, wait: number) => {
     (..._args: A): Promise<R>;
     /** 添加额外方法到节流函数 */
     flush: () => any;
     cancel: () => void;
 };
 
-interface UseWebSocketParams {
+/**
+ * useWebSocket Hook 参数类型定义
+ */
+interface WebSocketProps {
+    /** WebSocket 服务器地址 */
     url: string;
+    /** 接收到消息时的回调函数 */
     onMessage: (message: any) => void;
+    /** 连接关闭时的回调函数（可选） */
     onClose?: () => void;
+    /** 心跳间隔时间，单位毫秒，默认 30000ms */
     heartbeatInterval?: number;
+    /** 心跳消息内容，默认 'ping' */
     heartbeatMessage?: string;
+    /** 是否开启客户端心跳，默认 true */
     clientHeartbeat?: boolean;
+    /** 重连间隔时间，单位毫秒，默认 5000ms */
     reconnectInterval?: number;
+    /** 最大重连尝试次数，不设置则无限重连 */
     maxReconnectAttempts?: number;
+    /** 是否开启重连机制，默认 true */
     isReconnect?: boolean;
 }
-interface UseWebSocketReturn {
+/**
+ * useWebSocket Hook 返回值类型定义
+ */
+interface WebSocketType {
+    /** 发送消息的方法 */
     sendMessage: (message: string) => void;
+    /** WebSocket 连接状态，对应 WebSocket.readyState */
     socketReadyState: number | null;
 }
-declare const useWebSocket: ({ url, onMessage, onClose, heartbeatInterval, heartbeatMessage, clientHeartbeat, reconnectInterval, maxReconnectAttempts, isReconnect }: UseWebSocketParams) => UseWebSocketReturn;
+/**
+ * WebSocket 连接管理 Hook
+ *
+ * 提供完整的 WebSocket 连接管理功能，包括：
+ * - 自动重连机制
+ * - 心跳检测
+ * - 页面可见性监听
+ * - 连接状态管理
+ * - 消息发送与接收
+ *
+ * @example
+ * ```tsx
+ * const { sendMessage, socketReadyState } = useWebSocket({
+ *   url: 'ws://localhost:8080',
+ *   onMessage: (message) => console.log('收到消息:', message),
+ *   heartbeatInterval: 30000,
+ *   maxReconnectAttempts: 5
+ * })
+ * ```
+ */
+declare const _default: ({ url, onMessage, onClose, heartbeatInterval, heartbeatMessage, clientHeartbeat, reconnectInterval, maxReconnectAttempts, isReconnect }: WebSocketProps) => WebSocketType;
 
 /**
  * 深拷贝函数
+ *
+ * @template T
  * @param obj - 要拷贝的对象
- * @param isJson - 是否使用 JSON 方式深拷贝，默认为 true
+ * @param isJson - 是否使用 JSON 深拷贝（默认 true）
  * @returns 拷贝后的新对象
+ *
+ * @example
+ * const a = { x: { y: 1 } }
+ * const b = deepCopy(a)
+ * b.x.y = 2
+ * console.log(a.x.y) // 1
+ *
+ * @remarks
+ * - JSON 深拷贝会丢失：函数、Map、Set、RegExp、Date 等信息
+ * - isJson = false 时使用递归版本，性能差但支持大部分类型，支持循环引用
+ * - 不处理 Symbol、getter/setter 属性
  */
-declare const deepCopy: <T>(arg: T, isJson?: boolean) => T;
+declare const deepCopy: <T>(obj: T, isJson?: boolean) => T;
 /**
  * 深度比较两个对象是否相等
- * 支持 Date、RegExp、Map、Set、Array、Function、Object 等类型
+ *
  * @param a - 第一个对象
  * @param b - 第二个对象
  * @returns 是否相等
+ *
+ * @example
+ * deepEqual({ a: 1 }, { a: 1 }) // true
+ * deepEqual([1, 2], [1, 2]) // true
+ * deepEqual(new Date(1), new Date(1)) // true
+ * deepEqual(new Set([1]), new Set([1])) // true
+ *
+ * @remarks
+ * - 支持 Date、RegExp、Map、Set、Array、Function（仅作引用比较）、Object
+ * - 支持循环引用检测
+ * - 不处理不可枚举属性、getter/setter 和 Symbol
  */
 declare function deepEqual(a: any, b: any): boolean;
 /**
- * 深度合并两个对象，对于对象类型进行递归合并
+ * 深度合并两个对象
+ *
+ * @template T
  * @param base - 基础对象
  * @param override - 覆盖对象
  * @returns 合并后的新对象
+ *
+ * @example
+ * deepMerge(
+ *   { a: 1, b: { x: 1 } },
+ *   { b: { x: 2, y: 3 } }
+ * )
+ * // => { a: 1, b: { x: 2, y: 3 } }
+ *
+ * @remarks
+ * - 数组不进行合并，只会被直接覆盖
+ * - 内部使用递归，性能良好
+ * - 只处理普通对象的深度合并，特殊对象（如 Date、RegExp、Map、Set 等）会被直接覆盖
+ * - undefined 值会被忽略，不会覆盖原有值
  */
 declare const deepMerge: <T extends Record<string, any>>(base: T, override: Partial<T>) => T;
 /**
- * 将键值对象转换为选项数组格式
+ * 将对象或者数组转换为下拉选项数组
+ *
  * @param obj - 键值对象
- * @returns 选项数组，包含 label 和 value 属性
+ * @param filter - 可选的过滤函数，用于过滤不需要的项
+ * @returns label/value 数组，value根据键的类型智能转换：数字字符串转为数字，其他保持为字符串
+ *
+ * @example
+ * objToOptions({ 1: '男', 2: '女' })
+ * // => [ { label: '男', value: 1 }, { label: '女', value: 2 } ]
+ *
+ * @example
+ * objToOptions({ admin: '管理员', user: '用户' })
+ * // => [ { label: '管理员', value: 'admin' }, { label: '用户', value: 'user' } ]
+ *
+ * @example
+ * objToOptions({ '1': '男', '2': '女', '0': '未知' }, (key) => Number(key) > 0)
+ * // => [ { label: '男', value: 1 }, { label: '女', value: 2 } ]
  */
-declare const objToOptions: (obj: ObjectType<string>) => {
-    label: string;
-    value: number;
+declare const objToOptions: (obj: Record<string, string> | string[], filter?: (key: string, value: string) => boolean) => {
+    label: any;
+    value: string | number;
 }[];
 /**
- * 将数组转换为以指定字段为键的对象
- * @param arr - 要转换的数组
- * @param key - 用作对象键的字段名
+ * 将数组按照某个 key 转换为对象
+ *
+ * @template T
+ * @param arr - 数组
+ * @param key - 作为对象 key 的字段名
  * @returns 转换后的对象
+ *
+ * @example
+ * arrToObj([{ id: 1, name: 'a' }], 'id')
+ * // => { "1": { id: 1, name: "a" } }
  */
 declare const arrToObj: <T>(arr: T[], key: string) => {
     [key: string]: T;
 };
-interface NsSetIntervalReturnType {
-    /** 检查是否正在运行 */
-    isRun: () => boolean;
-    /** 取消定时器 */
-    cancel: () => void;
-}
 /**
- * 使用 setTimeout 模拟 setInterval 的返回类型接口
- * 避免 setInterval 的内存泄漏问题
- * @param fn - 要重复执行的函数
- * @param t - 间隔时间（毫秒）
- * @returns 控制对象，包含 isRun 和 cancel 方法
+ * 使用 setTimeout 模拟 setInterval，避免堆积
+ *
+ * @param fn - 要执行的函数（允许 async）
+ * @param t - 间隔毫秒数
+ * @returns 控制对象
+ *
+ * @example
+ * const timer = setInterval(() => console.log('run'), 1000)
+ *
+ * setTimeout(() => timer.cancel(), 5000)
+ *
+ * @remarks
+ * - 可以确保执行 fn 时间不影响下一次调用，天然避免 setInterval 的堆积问题
  */
-declare const nsSetInterval: (fn: () => void, t: number) => NsSetIntervalReturnType;
+declare const setInterval: (fn: () => void | Promise<void>, t: number) => {
+    isRun: () => boolean;
+    cancel: () => void;
+};
 /**
- * 生成不重复的唯一ID
- * @returns 唯一ID字符串
+ * 生成唯一的 UUID v4 格式 ID
+ * 使用 crypto.randomUUID() 生成符合 RFC 4122 标准的 UUID
+ *
+ * @returns 符合 UUID v4 格式的唯一标识符字符串
+ *
+ * @example
+ * const id = genNonDuplicateID()
+ * console.log(id) // 输出类似: "f8c8e6d2-35a2-4f4d-9d53-994f2b6e1c2d"
  */
-declare const genNonDuplicateID: () => string;
+declare const genNonDuplicateID: () => `${string}-${string}-${string}-${string}-${string}`;
 /**
  * 复制文本到剪贴板
- * 优先使用 navigator.clipboard API，降级使用 execCommand
- * @param text - 要复制的文本
- * @param prompt - 提示语
- * @returns void
+ *
+ * @param text - 文本
+ * @param prompt - 提示语（默认"复制成功"）
+ *
+ * @example
+ * copyText('HELLO')
  */
-declare const copyText: (text: string, prompt?: string) => void;
+declare const copyText: (text: string, prompt?: string) => Promise<void>;
 /**
- * 把后台接口字段，返回的关于金额的数字，转换为千分符号分隔的数字
- * return string
+ * 数字千分位格式化
+ *
+ * @param number - 数字或字符串
+ * @returns 格式化字符串
+ *
+ * @example
+ * formatNumberWithCommas(1234567) // "1,234,567"
  */
 declare function formatNumberWithCommas(number: number | string): string | number;
 /**
- * 生成指定范围内的不重复随机数
+ * 生成范围内的不重复随机数
+ *
  * @param min - 最小值
  * @param max - 最大值
  * @param count - 生成数量
  * @returns 不重复的随机数数组
+ *
+ * @example
+ * generateRandomNumbers(1, 100, 3)
+ * // => [13, 77, 54]
  */
 declare const generateRandomNumbers: (min: number, max: number, count: number) => number[];
 /**
- * 从文件路径中提取文件名
- * @param filePath - 文件路径
+ * 根据文件路径提取文件名
+ *
+ * @param filePath - 路径
  * @returns 文件名
+ *
+ * @example
+ * getFileName('/a/b/c.png?xxx') // "c.png"
  */
 declare const getFileName: (filePath: string) => string;
 /**
- * 从文件名中获取文件扩展名
+ * 获取文件后缀
+ *
  * @param fileName - 文件名
- * @returns 文件扩展名
+ * @returns 后缀
+ *
+ * @example
+ * getFileSuffixName('a.png') // "png"
  */
 declare const getFileSuffixName: (fileName: string) => string;
 /**
- * 将文本中的换行符转换为 HTML 换行标签
- * @param con - 要转换的文本
- * @returns 转换后的 HTML 字符串
+ * 将换行转换为 <br/>
+ *
+ * @param con - 文本
+ * @returns HTML 字符串
+ *
+ * @example
+ * convertNewlineToBr("a\nb")
+ * // => "a<br/>b"
  */
-declare const textAreaView: (con?: string) => string;
+declare const convertNewlineToBr: (con?: string) => string;
 /**
- * 将对象转换为 URL 查询参数字符串
- * @param obj - 要转换的对象
- * @param url - 要拼接的 URL，如果未提供，则返回查询参数字符串
- * @returns URL 查询参数字符串
+ * 获取 URL 中所有参数
+ * @param url - URL
+ * @returns Record<string, string | string[]> 返回参数键值对对象，对于同名参数会以数组形式存储
+ *
+ * @example
+ * getAllUrlParams("http://example.com?a=1&b=2")
+ * // => { a: "1", b: "2" }
+ *
+ * @example
+ * getAllUrlParams("http://example.com?a=1&a=2&b=3")
+ * // => { a: ["1", "2"], b: "3" }
  */
-declare const buildUrlParams: (obj: Record<string, any>, url?: string) => string;
+declare const getAllUrlParams: (url?: string) => Record<string, string | string[]>;
 /**
- * 下载文件到本地
- * @param url - 文件下载地址
- * @param name - 下载文件名，默认为'图片下载'
+ * 构建 URL 查询参数
+ *
+ * @param obj - 参数对象
+ * @param url - 可选，拼接到某个 URL 上
+ * @param format - 数组格式化方式，'repeat' | 'comma'; 默认为 'repeat'
+ * @returns 最终字符串
+ *
+ * @example
+ * buildUrlParams({ a: 1, b: [2, 3] })
+ * // "a=1&b=2&b=3"
+ *
+ * buildUrlParams({ a: 1 }, "/api")
+ * // "/api?a=1"
+ *
+ * buildUrlParams({ a: [1, 2] }, "/api", "comma")
+ * // "/api?a=1,2"
+ */
+declare const buildUrlParams: (obj: Record<string, any>, url?: string, format?: "repeat" | "comma") => string;
+/**
+ * 触发浏览器下载文件
+ *
+ * @param url - 文件地址
+ * @param name - 文件名 默认 "图片下载"
+ *
+ * @example
+ * downloadFile("/xx/a.png", "头像.png")
  */
 declare const downloadFile: (url: string, name?: string) => void;
 /**
- * 给URL路径最后添加斜杠
- * @param url - 要处理的URL，默认为空字符串
- * @returns 处理后的URL
+ * 给 URL 最后追加斜杠
+ *
+ * @param url - URL
+ * @returns 新 URL
+ *
+ * @example
+ * addUrlLastSlash("/api/user") // "/api/user/"
  */
 declare const addUrlLastSlash: (url?: string) => string;
 /**
  * 给URL增加mainSource参数
- * @param url - 目标URL
- * @param preHref - 参考URL，用于获取mainSource参数
- * @returns 处理后的URL
+ *
+ * 此函数用于在URL中添加或保留mainSource查询参数，主要用于追踪来源。
+ * 如果URL中已经存在mainSource参数，则不会修改该URL。
+ * 如果不存在，则会从preHref参数中提取mainSource值，如果preHref中也没有，
+ * 则使用默认值defaultMainSource。
+ *
+ * @param url - 需要处理的目标URL
+ * @param preHref - 可选，参考URL，用于从中提取mainSource参数值
+ * @param defaultMainSource - 可选，mainSource默认值，默认为'cube-uc'
+ * @returns 添加了mainSource参数的URL字符串
+ *
+ * @example
+ * // URL中已有mainSource参数，直接返回原URL
+ * setUrlMainSource('https://example.com/page?mainSource=adwords')
+ * // => 'https://example.com/page?mainSource=adwords'
+ *
+ * @example
+ * // URL中没有mainSource参数，preHref中有mainSource参数
+ * setUrlMainSource('https://example.com/page', 'https://referrer.com/?mainSource=facebook')
+ * // => 'https://example.com/page?mainSource=facebook'
+ *
+ * @example
+ * // URL和preHref中都没有mainSource参数，使用默认值
+ * setUrlMainSource('https://example.com/page')
+ * // => 'https://example.com/page?mainSource=defaultMainSource'
  */
-declare const getUrlMainSource: (url: string, preHref?: string) => string;
+declare const setUrlMainSource: (url: string, preHref?: string, defaultMainSource?: string) => string;
 /**
- * 获取 WebSocket 连接地址
- * @param path - WebSocket 服务路径，比如 "/ws" 或 "/socket"
- * @param customHost - 可选，指定 host:port；默认取当前 window.location.host
- * @returns 完整的 WebSocket URL
+ * 构建 WebSocket 地址
+ *
+ * @param path - WS 路径
+ * @param customHost - 可选 host; 默认使用当前页面的 host
+ * @returns 完整 WS 地址
+ *
+ * @example
+ * getWebSocketUrl("/ws") // "ws://xxx/ws"
  */
 declare const getWebSocketUrl: (path: string, customHost?: string) => string;
 /**
- * 对象转换函数，将源对象转换为目标对象
+ * 按照字段映射转换对象
+ *
+ * @template T, U
  * @param source - 源对象
- * @param fieldMap - 字段映射配置
- * @returns 转换后的目标对象
+ * @param fieldMap - 字段映射表
+ * @returns 转换结果
+ *
+ * @example
+ * transform(
+ *   { a: 1, b: 2 },
+ *   { x: 'a', y: (s) => s.b + 1 }
+ * )
+ * // => { x: 1, y: 3 }
  */
 declare function transform<T extends object, U extends object>(source: T, fieldMap: {
     [K in keyof U]: keyof T | ((source: T) => U[K]) | U[K];
@@ -637,278 +912,1255 @@ declare function transform<T extends object, U extends object>(source: T, fieldM
  * @param sources - 源对象数组
  * @param fieldMap - 字段映射配置
  * @returns 转换后的目标对象数组
+ *
+ * @example
+ * transforms([{ a: 1 }], { x: 'a' })
+ * // => [{ x: 1 }]
  */
 declare function transforms<T extends object, U extends object>(sources: T[], fieldMap: {
     [K in keyof U]: keyof T | ((source: T) => U[K]) | U[K];
 }): U[];
+/**
+ * 将数字金额转换为中文大写金额
+ *
+ * 该函数将阿拉伯数字表示的金额转换为中文大写形式，常用于财务票据、合同等正式场合
+ * 支持处理整数和小数部分，最大处理金额不超过 999,999,999,999,999.9999
+ *
+ * @param money - 需要转换的金额，可以是数字或字符串形式的数字
+ * @returns 中文大写金额字符串
+ *
+ * @example
+ * convertCurrency(123456.78)
+ * // => "壹拾贰万叁仟肆佰伍拾陆圆柒角捌分"
+ *
+ * @example
+ * convertCurrency("1000")
+ * // => "壹仟圆整"
+ *
+ * @example
+ * convertCurrency(-123.45)
+ * // => "(负数)壹佰贰拾叁圆肆角伍分"
+ */
+declare const convertCurrency: (money?: string | number) => string;
+/**
+ * 计算表格中指定列的行合并数量
+ *
+ * 该函数通常用于表格渲染中，根据某一列的相同值进行行合并（rowspan）
+ * 它会将连续相同的值分为一组，并返回目标位置所在的组的大小
+ *
+ * @param data - 数据数组，每一项应为对象
+ * @param key - 需要检查的字段名，用于比较值是否相同
+ * @param target - 目标索引位置，函数将返回该位置所在组的大小
+ * @returns 目标位置所在组的大小，如果是组的第一个元素则返回组大小，否则返回0
+ *
+ * @example
+ * const data = [
+ *   { name: 'Alice', dept: 'IT' },
+ *   { name: 'Bob', dept: 'IT' },
+ *   { name: 'Charlie', dept: 'HR' },
+ *   { name: 'David', dept: 'HR' },
+ *   { name: 'Eve', dept: 'HR' }
+ * ]
+ *
+ * getRowSpanCount(data, 'dept', 0) // 返回 2 (IT部门有2人)
+ * getRowSpanCount(data, 'dept', 1) // 返回 0 (IT部门第2个人)
+ * getRowSpanCount(data, 'dept', 2) // 返回 3 (HR部门有3人)
+ * getRowSpanCount(data, 'dept', 3) // 返回 0 (HR部门第2个人)
+ * getRowSpanCount(data, 'dept', 4) // 返回 0 (HR部门第3个人)
+ */
+declare const getRowSpanCount: (data: any[], key: string, target: number) => any;
+/**
+ * 动态加载第三方文件（JavaScript 或 CSS）
+ *
+ * 该函数用于在运行时动态加载外部资源文件，支持 JavaScript 和 CSS 文件
+ * 主要用于按需加载第三方库或样式文件，避免在页面初始加载时引入所有资源
+ *
+ * @param document - DOM 文档对象，用于创建和插入元素
+ * @param path - 文件路径，支持相对路径或绝对路径
+ *
+ * @example
+ * // 加载 JavaScript 文件
+ * importThirdPartyFile(document, 'https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.js')
+ *
+ * @example
+ * // 加载 CSS 文件
+ * importThirdPartyFile(document, '/assets/styles/third-party.css')
+ *
+ * @example
+ * // 加载本地 JavaScript 文件
+ * importThirdPartyFile(document, './libs/custom-lib.js')
+ *
+ * @remarks
+ * - 根据文件扩展名自动识别文件类型（.js 为脚本文件，其他为样式文件）
+ * - JavaScript 文件会异步加载（async = true）
+ * - CSS 文件会作为 stylesheet 添加到文档头部
+ * - 需要确保 document.head 存在才会添加元素
+ */
+declare const importThirdPartyFile: (document: Document, path: string) => void;
+/**
+ * 主要用于处理需要设置key的数组数据
+ *
+ * 该函数用于过滤和处理项目数组，主要功能包括：
+ * 1. 过滤掉标记为隐藏的项目（hidden 为 true 的项目）
+ * 2. 为每个项目添加唯一的 key 属性（使用数组索引）
+ *
+ * @template T - 项目类型，hidden 属性（可选）
+ * @param items - 需要处理的项目数组
+ * @returns 处理后的项目数组，已过滤隐藏项并添加了 key 属性（优先使用数组项自身的key属性）
+ *
+ * @example
+ * // 过滤带有 hidden 标记的菜单项
+ * const menuItems = [
+ *   { name: '首页', path: '/', hidden: true },
+ *   { name: '关于', path: '/about' },
+ *   { name: '联系', path: '/contact', hidden: false }
+ * ];
+ * const processedItems = processItemList(menuItems);
+ * // 结果: [{ key: 0, name: '关于', path: '/about' }, { key: 1, name: '联系', path: '/contact', hidden: false }]
+ *
+ * @remarks
+ * - 该函数不会修改原始数组，而是返回一个新的处理后的数组
+ * - key 值基于过滤后的数组索引生成，不是原始数组的索引
+ * - hidden 属性为 true 的项目会被过滤掉，其他情况（false、undefined、null等）都会保留
+ */
+declare const processItemList: <T extends {
+    hidden?: boolean;
+}>(items: T[]) => (T & {
+    key: number;
+})[];
+/**
+ * 执行安全的脚本代码
+ *
+ * @param script - 需要执行的脚本代码字符串
+ * @param params - 传递给脚本的参数对象，键为参数名，值为参数值
+ *
+ * @example
+ * // 执行简单的数学运算脚本
+ * executeScript('return a + b;', { a: 1, b: 2 });
+ *
+ * @example
+ * // 执行带条件逻辑的脚本
+ * executeScript(`
+ *   if (age >= 18) {
+ *     return "成年人";
+ *   } else {
+ *     return "未成年人";
+ *   }
+ * `, { age: 20 });
+ *
+ * @example
+ * // 执行数组处理脚本
+ * executeScript(`
+ *   return numbers.map(n => n * 2).filter(n => n > 5);
+ * `, { numbers: [1, 2, 3, 4, 5] });
+ *
+ * @remarks
+ * - 函数会先调用 isScriptSafe 检查脚本安全性，只有安全的脚本才会被执行
+ * - 使用 Function 构造器而非 eval，相对更安全
+ * - 参数通过解构方式传递给脚本函数
+ * - 脚本中可以直接使用 params 对象中的键作为变量名
+ * - 如果脚本执行出错，会在控制台输出错误信息
+ *
+ * @security
+ * - 脚本执行在 JavaScript 运行时环境中，仍可能访问全局对象
+ * - 应确保传入的脚本来自可信源
+ * - 仅依赖 isScriptSafe 检查不足以防范所有安全风险
+ */
+declare const executeScript: (script: string, params: {
+    [key: string]: any;
+}) => any;
+/**
+ * AES 加密
+ * @param data - 需要加密的数据
+ * @param key - 加密密钥
+ * @returns 加密后的字符串
+ * @throws 当密钥为空或加密过程失败时抛出错误
+ */
+declare function aesEncrypt<T = any>(data: T, key: string): string;
+/**
+ * AES 解密
+ * @param data - 加密后的字符串
+ * @param key - 解密密钥
+ * @returns 解密后的数据，解密失败时返回null
+ */
+declare function aesDecrypt<T = any>(data: string, key: string): T | null;
 
 type DateType = string | number | Date | dayjs.Dayjs | null;
 /** 默认日期时间格式：年-月-日 时:分:秒 */
-declare const DateFormatType = "YYYY-MM-DD HH:mm:ss";
+declare const DEFAULT_DATE_TIME_FORMAT = "YYYY-MM-DD HH:mm:ss";
 /** 默认日期格式：年-月-日 */
-declare const DateFormatType2 = "YYYY-MM-DD";
+declare const DEFAULT_DATE_FORMAT = "YYYY-MM-DD";
+/** 年月中文格式：**年**月 */
+declare const DEFAULT_YEAR_MONTH_FORMAT = "YYYY\u5E74MM\u6708";
+/** 年月日格式：**年**月**日 */
+declare const DEFAULT_YEAR_MONTH_DAY_FORMAT = "YYYY\u5E74MM\u6708DD\u65E5";
 /**
- * 获取一天的最早时间 '2023/10/17 00:00:00' 的时间戳
+ * 获取指定日期开始时间戳 (如: '2023/10/17 00:00:00')
+ * @param date 日期
+ * @param unit 时间单位，默认为 'date' (天)
+ * @returns 时间戳
  */
 declare const getStartOfTimestamp: (date?: DateType, unit?: dayjs.OpUnitType) => number;
 /**
- * 获取一天的最晚时间 '2023/10/17 23:59:59' 的时间戳
+ * 获取指定日期结束时间戳 (如: '2023/10/17 23:59:59')
+ * @param date 日期
+ * @param unit 时间单位，默认为 'date' (天)
+ * @returns 时间戳
  */
 declare const getEndOfTimestamp: (date?: DateType, unit?: dayjs.OpUnitType) => number;
+/**
+ * 格式化日期
+ * @param date 待格式化的日期
+ * @param format 格式字符串，默认为 'YYYY-MM-DD HH:mm:ss'
+ * @returns 格式化后的日期字符串
+ */
 declare const formatDate: (date: Date | number | string, fmt?: string) => string;
+/**
+ * 获取日期的时间戳
+ * @param date 日期,默认当前时间
+ * @returns 时间戳
+ */
 declare const getTimestamp: (date?: DateType) => number;
+/**
+ * 检查日期是否已过期
+ * @param date 待检查的日期, 默认当前时间
+ * @returns 是否过期
+ */
 declare const isExpire: (date?: DateType) => boolean;
 
 /**
  * 类型判断函数
+ *
  * @param val - 要判断的值
  * @param type - 目标类型名
  * @returns 是否为目标类型
+ *
+ * @example
+ * ```typescript
+ * is({}, 'Object') // true
+ * is([], 'Array') // true
+ * is(123, 'Number') // true
+ * ```
  */
 declare function is(val: unknown, type: string): boolean;
 /**
  * 判断值是否为 undefined
+ *
  * @param val - 要判断的值
  * @returns 是否为 undefined
+ *
+ * @example
+ * ```typescript
+ * isUnDef(undefined) // true
+ * isUnDef(null) // false
+ * isUnDef(0) // false
+ * ```
  */
 declare function isUnDef<T = unknown>(val?: T): val is T;
 /**
  * 判断值是否已定义（非 undefined）
+ *
  * @param val - 要判断的值
  * @returns 是否已定义
+ *
+ * @example
+ * ```typescript
+ * isDef(null) // true
+ * isDef(0) // true
+ * isDef('') // true
+ * isDef(undefined) // false
+ * ```
  */
 declare function isDef<T = unknown>(val?: T): val is T;
 /**
- * 判断值是否为对象（不包括 FormData 等）
+ * 判断值是否为纯对象
+ *
  * @param val - 要判断的值
- * @returns 是否为对象
+ * @returns 是否为纯对象
+ *
+ * @example
+ * ```typescript
+ * isObject({}) // true
+ * isObject([]) // false
+ * isObject(null) // false
+ * isObject(new Date()) // false
+ * ```
  */
 declare function isObject(val: any): val is Record<any, any>;
 /**
  * 判断对象是否为空对象
+ *
  * @param val - 要判断的值
  * @returns 是否为空对象
+ *
+ * @example
+ * ```typescript
+ * isEmptyObj({}) // true
+ * isEmptyObj({ a: 1 }) // false
+ * isEmptyObj([]) // false
+ * isEmptyObj(null) // false
+ * ```
  */
 declare function isEmptyObj<T = unknown>(val: T): boolean;
 /**
  * 判断值是否为 Date 对象
+ *
  * @param val - 要判断的值
  * @returns 是否为 Date 对象
+ *
+ * @example
+ * ```typescript
+ * isDate(new Date()) // true
+ * isDate('2023-01-01') // false
+ * isDate({}) // false
+ * ```
  */
 declare function isDate(val: unknown): val is Date;
+/**
+ * 判断值是否为 null
+ *
+ * @param val - 要判断的值
+ * @returns 是否为 null
+ *
+ * @example
+ * ```typescript
+ * isNull(null) // true
+ * isNull(undefined) // false
+ * isNull(0) // false
+ * ```
+ */
 declare function isNull(val: unknown): val is null;
+/**
+ * 判断值是否为 null 或 undefined
+ *
+ * @param val - 要判断的值
+ * @returns 是否为 null 或 undefined
+ *
+ * @example
+ * ```typescript
+ * isNullOrUnDef(null) // true
+ * isNullOrUnDef(undefined) // true
+ * isNullOrUnDef(0) // false
+ * isNullOrUnDef('') // false
+ * ```
+ */
 declare function isNullOrUnDef(val: unknown): val is null | undefined;
+/**
+ * 判断值是否为数字（包括 NaN）
+ *
+ * @param val - 要判断的值
+ * @returns 是否为数字类型
+ *
+ * @example
+ * ```typescript
+ * isNumber(123) // true
+ * isNumber('123') // false
+ * isNumber(NaN) // true
+ * ```
+ */
 declare function isNumber(val: unknown): val is number;
+/**
+ * 判断值是否为有效数字（不包括 NaN）
+ *
+ * @param val - 要判断的值
+ * @returns 是否为有效数字
+ *
+ * @example
+ * ```typescript
+ * isNumberNoNaN(123) // true
+ * isNumberNoNaN(NaN) // false
+ * isNumberNoNaN('123') // false
+ * ```
+ */
 declare function isNumberNoNaN(val: unknown): val is number;
+/**
+ * 判断值是否为字符串
+ *
+ * @param val - 要判断的值
+ * @returns 是否为字符串
+ *
+ * @example
+ * ```typescript
+ * isString('hello') // true
+ * isString(123) // false
+ * isString(new String('hello')) // true
+ * ```
+ */
 declare function isString(val: unknown): val is string;
+/**
+ * 判断值是否为函数
+ *
+ * @param val - 要判断的值
+ * @returns 是否为函数
+ *
+ * @example
+ * ```typescript
+ * isFunction(() => {}) // true
+ * isFunction(function() {}) // true
+ * isFunction('function') // false
+ * isFunction({}) // false
+ * ```
+ */
 declare function isFunction(val: unknown): boolean;
+/**
+ * 判断值是否为 Promise 对象
+ *
+ * @param val - 要判断的值
+ * @returns 是否为 Promise
+ *
+ * @example
+ * ```typescript
+ * isPromise(Promise.resolve()) // true
+ * isPromise({ then: () => {}, catch: () => {} }) // false
+ * isPromise({}) // false
+ * ```
+ */
 declare function isPromise<T = any>(val: unknown): val is Promise<T>;
+/**
+ * 判断值是否为布尔值
+ *
+ * @param val - 要判断的值
+ * @returns 是否为布尔值
+ *
+ * @example
+ * ```typescript
+ * isBoolean(true) // true
+ * isBoolean(false) // true
+ * isBoolean(1) // false
+ * isBoolean('true') // false
+ * ```
+ */
 declare function isBoolean(val: unknown): val is boolean;
+/**
+ * 判断值是否为正则表达式
+ *
+ * @param val - 要判断的值
+ * @returns 是否为正则表达式
+ *
+ * @example
+ * ```typescript
+ * isRegExp(/test/) // true
+ * isRegExp(new RegExp('test')) // true
+ * isRegExp('/test/') // false
+ * isRegExp({}) // false
+ * ```
+ */
 declare function isRegExp(val: unknown): val is RegExp;
-declare function isArray(val: any): val is Array<any>;
-declare function isEmpty<T = unknown>(val: T): val is T;
+/**
+ * 判断值是否为数组
+ *
+ * @param val - 要判断的值
+ * @returns 是否为数组
+ *
+ * @example
+ * ```typescript
+ * isArray([]) // true
+ * isArray([1, 2, 3]) // true
+ * isArray({}) // false
+ * isArray('array') // false
+ * ```
+ */
+declare function isArray<T = any>(val: unknown): val is Array<T>;
+/**
+ * 判断值是否为空值
+ *
+ * @param val - 要判断的值
+ * @returns 是否为空值
+ *
+ * @example
+ * ```typescript
+ * isEmpty('') // true
+ * isEmpty([]) // true
+ * isEmpty({}) // true
+ * isEmpty(null) // true
+ * isEmpty(undefined) // true
+ * isEmpty(0) // false
+ * isEmpty(false) // false
+ * ```
+ */
+declare function isEmpty<T = unknown>(val: T): boolean;
+/**
+ * 判断值是否为 Window 对象
+ *
+ * @param val - 要判断的值
+ * @returns 是否为 Window 对象
+ *
+ * @example
+ * ```typescript
+ * isWindow(window) // true
+ * isWindow({}) // false
+ * isWindow(global) // false
+ * ```
+ */
 declare function isWindow(val: any): val is Window;
+/**
+ * 判断值是否为 DOM 元素
+ *
+ * @param val - 要判断的值
+ * @returns 是否为 DOM 元素
+ *
+ * @example
+ * ```typescript
+ * isElement(document.body) // true
+ * isElement(document.createElement('div')) // true
+ * isElement({ tagName: 'div' }) // false
+ * isElement('div') // false
+ * ```
+ */
 declare function isElement(val: unknown): val is Element;
-declare function isMap(val: unknown): val is Map<any, any>;
-/** 判断是否为服务端环境（无 window 对象） */
-declare const isServer: boolean;
-/** 判断是否为客户端环境（有 window 对象） */
-declare const isClient: boolean;
 /**
- * 判断是否是外链
- * @param {string} path
- * @returns {Boolean}
- * @author LiQingSong
+ * 判断值是否为 Map 对象
+ *
+ * @param val - 要判断的值
+ * @returns 是否为 Map
+ *
+ * @example
+ * ```typescript
+ * isMap(new Map()) // true
+ * isMap(new WeakMap()) // false
+ * isMap({}) // false
+ * ```
+ */
+declare function isMap<K = any, V = any>(val: unknown): val is Map<K, V>;
+/**
+ * 判断值是否为 Set 对象
+ *
+ * @param val - 要判断的值
+ * @returns 是否为 Set
+ *
+ * @example
+ * ```typescript
+ * isSet(new Set()) // true
+ * isSet(new WeakSet()) // false
+ * isSet([]) // false
+ * ```
+ */
+declare function isSet<T = any>(val: unknown): val is Set<T>;
+/**
+ * 判断是否为外部链接
+ *
+ * @param path - 路径字符串
+ * @returns 是否为外部链接
+ *
+ * @example
+ * ```typescript
+ * isExternal('https://example.com') // true
+ * isExternal('mailto:test@example.com') // true
+ * isExternal('tel:123456789') // true
+ * isExternal('/home') // false
+ * isExternal('http://localhost:3000') // true
+ * ```
  */
 declare const isExternal: (path: string) => boolean;
-declare const isBlob: (val: unknown) => boolean;
-declare const isLocalhost: (host?: string) => boolean;
-
 /**
- * 设置当前用户信息到 sessionStorage（AES 加密存储）
- * @param userInfo - 用户信息对象
+ * 判断值是否为 Blob 对象
+ *
+ * @param val - 要判断的值
+ * @returns 是否为 Blob
+ *
+ * @example
+ * ```typescript
+ * isBlob(new Blob()) // true
+ * isBlob(new File([], 'test.txt')) // true
+ * isBlob({}) // false
+ * ```
  */
-declare function setCurrentUser(userInfo: any): void;
+declare const isBlob: (val: unknown) => val is Blob;
 /**
- * 从 sessionStorage 获取当前用户信息（AES 解密）
- * @returns 用户信息对象或 null
+ * 判断是否为本地主机
+ *
+ * @param host - 主机名，默认取当前 location.host
+ * @returns 是否为本地主机
+ *
+ * @example
+ * ```typescript
+ * isLocalhost() // 检查当前主机
+ * isLocalhost('localhost:3000') // true
+ * isLocalhost('127.0.0.1:3000') // true
+ * isLocalhost('example.com') // false
+ * ```
  */
-declare function getCurrentUser(): any;
+declare const isLocalhost: (host?: string) => boolean;
 /**
- * 清除 sessionStorage 中的用户信息
+ * 判断值是否为引用类型（对象或函数）
+ * 引用类型包括：Object, Array, Function, Date, RegExp, Map, Set 等
+ *
+ * @param val - 要判断的值
+ * @returns 是否为引用类型
+ *
+ * @example
+ * ```typescript
+ * isReferenceType({}) // true
+ * isReferenceType([]) // true
+ * isReferenceType(function(){}) // true
+ * isReferenceType(null) // false
+ * isReferenceType(undefined) // false
+ * isReferenceType(123) // false
+ * isReferenceType('string') // false
+ * ```
+ */
+declare function isReferenceType(val: unknown): boolean;
+/**
+ * 检查脚本字符串是否安全
+ *
+ * 该函数用于检测给定的脚本字符串是否包含潜在的不安全代码，
+ * 主要用于防范 XSS（跨站脚本攻击）和其他安全风险。
+ * 通过检测常见的危险关键字和全局对象来判断脚本的安全性。
+ *
+ * @param script - 需要检查的脚本字符串
+ * @returns 如果脚本被认为是安全的则返回 true，否则返回 false
+ *
+ * @example
+ * // 安全的脚本
+ * isScriptSafe('const a = 1; console.log(a);') // true
+ *
+ * @example
+ * // 不安全的脚本（包含 eval）
+ * isScriptSafe('eval("alert(1)")') // false
+ *
+ * @example
+ * // 不安全的脚本（访问全局对象）
+ * isScriptSafe('window.location.href = "http://malicious.com"') // false
+ *
+ * @remarks
+ * - 该函数仅做基础的关键字检测，不能保证 100% 安全
+ * - 对于复杂的安全需求，应使用专门的沙箱环境或服务端验证
+ * - 函数不区分大小写进行关键字匹配
+ * - 关键字使用单词边界匹配，避免误判（如 'evaluation' 不会被误判为 'eval'）
+ *
+ * @security
+ * - 注意：这只是一个基础的安全检查，不应作为唯一的安全防护措施
+ * - 生产环境中建议结合 Content Security Policy (CSP) 等多重安全机制
  */
-declare function clearCurrentUser(): void;
+declare const isScriptSafe: (script: string) => boolean;
 /**
- * 获取或生成设备唯一标识
- * @returns 设备ID字符串
+ * 检查字符串是否为有效的 JSON 格式
+ *
+ * @param text - 需要检查的字符串，默认为空字符串
+ * @returns 如果字符串是有效的 JSON 格式则返回 true，否则返回 false
+ *
+ * @example
+ * isJson('{"name": "张三", "age": 25}') // true
+ * isJson('[1, 2, 3]') // true
+ * isJson('hello world') // false
+ * isJson('true') // false (虽然 JSON.parse('true') 有效，但不是对象或数组)
+ * isJson('') // false
+ *
+ * @remarks
+ * - 该函数使用 try/catch 机制来捕获 JSON.parse 解析结果
+ * - 只接受 JSON 对象 ({}) 或 JSON 数组 ([])，不接受基本类型值 (如: true, 123, "string")
  */
-declare function getDeviceId(): string;
+declare const isJson: (text?: string) => boolean;
 
 /** 数学运算符类型 */
 type OperatorType = '+' | '-' | '*' | '/';
 /**
  * 通用数学计算函数
+ * 支持链式运算，对多个数值执行相同类型的运算
+ *
+ * 实现原理：
+ * 1. 取第一个数值作为初始值
+ * 2. 使用reduce对剩余数值依次进行运算
+ * 3. 使用Decimal.js确保精度
+ *
  * @param operator - 运算符：+、-、*、/
- * @param args - 要计算的数值数组
+ * @param args - 要计算的数值数组（可变参数）
  * @returns 计算结果字符串
+ *
+ * @example
+ * calculate('+', 0.1, 0.2) // 返回 "0.3"
+ * calculate('*', 2, 3, 4)  // 返回 "24"
  */
 declare const calculate: (operator: OperatorType, ...args: Decimal.Value[]) => string;
 /**
  * 精确加法运算
- * 调用：plus(arg1,arg2)
- * 返回值：arg1加arg2的精确结果
+ * 解决JavaScript浮点数精度问题，支持多个数值相加
+ *
+ * @param args - 要相加的数值列表（可变参数）
+ * @returns 相加结果字符串
+ *
+ * @example
+ * plus(0.1, 0.2)        // 返回 "0.3"
+ * plus(1, 2, 3, 4, 5)   // 返回 "15"
  */
 declare const plus: (...args: Decimal.Value[]) => string;
 /**
  * 精确减法运算
- * 调用：minus(arg1,arg2)
- * 返回值：arg1减arg2的精确结果
+ * 解决JavaScript浮点数精度问题，支持多个数值连续相减
+ *
+ * @param args - 要相减的数值列表（可变参数）
+ * @returns 相减结果字符串
+ *
+ * @example
+ * minus(0.3, 0.1)       // 返回 "0.2"
+ * minus(10, 1, 2, 3)    // 返回 "4" (10-1-2-3)
  */
 declare const minus: (...args: Decimal.Value[]) => string;
 /**
  * 精确乘法运算
- * 调用：times(arg1,arg2)
- * 返回值：arg1乘以arg2的精确结果
+ * 解决JavaScript浮点数精度问题，支持多个数值连续相乘
+ *
+ * @param args - 要相乘的数值列表（可变参数）
+ * @returns 相乘结果字符串
+ *
+ * @example
+ * times(0.1, 0.2)       // 返回 "0.02"
+ * times(2, 3, 4)        // 返回 "24"
  */
 declare const times: (...args: Decimal.Value[]) => string;
 /**
  * 精确除法运算
- * 调用：dividedBy(arg1,arg2)
- * 返回值：arg1除以arg2的精确结果
+ * 解决JavaScript浮点数精度问题，支持多个数值连续相除
+ *
+ * @param args - 要相除的数值列表（可变参数）
+ * @returns 相除结果字符串
+ *
+ * @example
+ * dividedBy(0.3, 0.1)   // 返回 "3"
+ * dividedBy(100, 2, 5)  // 返回 "10" (100/2/5)
  */
 declare const dividedBy: (...args: Decimal.Value[]) => string;
 /**
  * 查看小数位数（不计算小数点最后末尾的0）
+ * 返回数值中小数点后非零数字的位数
+ *
  * @param arg1 - 要检查的数值
  * @returns 小数位数
+ *
+ * @example
+ * decimalPlaces(1.23)   // 返回 2
+ * decimalPlaces(1.2300) // 返回 2 (末尾的0不计入)
+ * decimalPlaces(1)      // 返回 0
  */
 declare const decimalPlaces: (arg1: Decimal.Value) => number;
 /**
  * 查看数值总位数（包括整数和小数部分）
+ * 返回数值中所有有效数字的总位数
+ *
  * @param arg1 - 要检查的数值
  * @returns 总位数
+ *
+ * @example
+ * precision(1.23)  // 返回 3
+ * precision(123)   // 返回 3
+ * precision(0.01)  // 返回 1
  */
 declare const precision: (arg1: Decimal.Value) => number;
 /**
  * 取绝对值
+ * 返回数值的绝对值（非负值）
+ *
  * @param arg1 - 要处理的数值
  * @returns 绝对值字符串
+ *
+ * @example
+ * absVal(-5)    // 返回 "5"
+ * absVal(5)     // 返回 "5"
+ * absVal(-1.5)  // 返回 "1.5"
  */
 declare const absVal: (arg1: Decimal.Value) => string;
 /**
  * 数值比较函数
+ * 支持多种比较操作，解决浮点数比较精度问题
+ *
  * @param arg1 - 第一个数值
  * @param arg2 - 第二个数值
  * @param type - 比较类型：>、>=、<、<=、==
  * @returns 比较结果布尔值
+ *
+ * @example
+ * compareNum(0.1 + 0.2, 0.3, '==')  // 返回 true
+ * compareNum(1, 2, '<')              // 返回 true
+ * compareNum(2, 2, '>=')             // 返回 true
  */
 declare const compareNum: (arg1: Decimal.Value, arg2: Decimal.Value, type: string) => boolean;
 /**
  * 四舍五入处理
+ * 对数值进行指定小数位数的四舍五入处理（解决原始toFixed精度问题）
+ *
  * @param num - 要处理的数值
  * @param decimals - 保留小数位数，默认为2
  * @param fill - 是否补0，默认为true
  * @returns 处理后的数字字符串
+ *
+ * @example
+ * toFixed(1.2345)           // 返回 "1.23"
+ * toFixed(1.2345, 3)        // 返回 "1.235"
+ * toFixed(1.2, 2, true)     // 返回 "1.20" (补0)
+ * toFixed(1.2, 2, false)    // 返回 "1.2" (不补0)
  */
 declare const toFixed: (num: Decimal.Value, decimals?: number, fill?: boolean) => string;
 /**
  * 判断是否为整数
+ * 检查数值是否为整数（没有小数部分）
+ *
  * @param num - 要判断的数值
  * @returns 是否为整数
+ *
+ * @example
+ * isInteger(1)     // 返回 true
+ * isInteger(1.0)   // 返回 true
+ * isInteger(1.1)   // 返回 false
  */
 declare const isInteger: (num: Decimal.Value) => boolean;
 /**
  * 判断是否为负数
+ * 检查数值是否小于0
+ *
  * @param num - 要判断的数值
  * @returns 是否为负数
+ *
+ * @example
+ * isNegative(-1)    // 返回 true
+ * isNegative(0)     // 返回 false
+ * isNegative(1)     // 返回 false
  */
 declare const isNegative: (num: Decimal.Value) => boolean;
 
-/** HTTP 状态码常量：成功 */
-declare const OK = 200;
-/** HTTP 状态码常量：服务器错误 */
-declare const ERROR = 500;
-/** HTTP 状态码常量：缺少参数 */
-declare const MISSING_PARAMETER = 400;
-/** HTTP 状态码常量：未授权 */
-declare const UNAUTHORIZED = 401;
-/** HTTP 状态码常量：禁止访问 */
-declare const FORBIDDEN = 403;
-/** HTTP 状态码常量：未找到资源 */
-declare const NOT_FOUND = 404;
-/** 业务错误码常量：权限拒绝 */
-declare const PERMISSION_DENIED = 13001;
-/**
- * 创建 Axios 请求实例
- * @param baseURL - API 基础路径，默认为 '/api'
- * @returns 请求实例对象
- */
-declare function createRequest(baseURL?: string): {
+/**
+ * 消息提示配置接口
+ */
+interface Message {
+    /** 消息标题 */
+    title?: string;
+    /** 消息内容 */
+    content: string;
+    /** 显示时长（秒），为0则不自动关闭 */
+    duration?: number;
+    /** 消息类型：成功、错误、警告、信息 */
+    type?: 'success' | 'error' | 'warning' | 'info';
+    /** 关闭回调 */
+    onClose?: () => void;
+}
+/**
+ * 缓存消息配置接口
+ * 扩展基础消息接口，增加缓存控制
+ */
+interface CacheMessage extends Message {
+    /** 是否启用缓存机制 */
+    isCache?: boolean;
+    /** 是否为唯一消息 */
+    isOnly?: boolean;
+}
+/**
+ * 导出的缓存消息显示函数
+ * 支持防重复显示、自动关闭、多种显示形式
+ *
+ * 使用示例：
+ * ```typescript
+ * // 基本用法
+ * cachedMessage({ content: '操作成功', type: 'success' })
+ *
+ * // 长消息自动使用通知形式
+ * cachedMessage({ title: '系统通知', content: '这是一条很长的通知内容，将会以notification形式显示...', type: 'info' })
+ *
+ * // 弹窗形式（duration=0）
+ * cachedMessage({ title: '确认操作', content: '确定要删除这项数据吗？', duration: 0, type: 'warning' })
+ *
+ * // 防重复显示
+ * cachedMessage({ content: '请先登录', type: 'error' })
+ * cachedMessage({ content: '请先登录', type: 'error' }) // 此条不会显示
+ *
+ * // 强制重新显示（禁用缓存）
+ * cachedMessage({ content: '请先登录', type: 'error', isCache: false })
+ * ```
+ */
+declare const cachedMessage: ({ title, content, type, duration, onClose, isCache, isOnly }: CacheMessage) => void;
+
+/**
+ * 手机号验证规则
+ * 匹配以1开头，第二位为3-9的11位数字
+ */
+declare const RegMobile: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 固定电话验证规则
+ * 匹配区号(0开头2-3位数字) + 连字符 + 7-8位号码
+ */
+declare const RegFixedTelePhone: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 通用电话号码验证规则
+ * 匹配包含数字及常见电话符号(+、-、()、（）、 )的1-20位字符串
+ */
+declare const RegTelePhone: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 税号验证规则
+ * 匹配15位、18位或20位的大写字母和数字组合
+ */
+declare const RegTaxNo: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 银行卡号验证规则
+ * 匹配纯数字组成的字符串
+ */
+declare const RegBankCardNo: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 身份证号验证规则
+ * 匹配15位数字、18位数字或17位数字加X/x的格式
+ */
+declare const RegIdentityCardNo: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 数字验证规则
+ * 匹配纯数字组成的字符串
+ */
+declare const RegNumNo: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 短信验证码验证规则
+ * 匹配6位数字
+ */
+declare const RegSmsCode: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 邮箱验证规则
+ * 匹配标准邮箱格式：用户名@域名.顶级域名
+ */
+declare const RegEmail: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 详细地址验证规则
+ * 必须包含地址相关关键词（街、路、村、乡、镇、道、巷、号）
+ */
+declare const RegDetailAddress: {
+    pattern: RegExp;
+    message: string;
+};
+/**
+ * 手机号或固定电话验证器
+ * 验证输入是否符合手机号或固定电话格式
+ *
+ * @param errMessage - 自定义错误消息
+ * @returns Ant Design 表单验证规则对象
+ *
+ * @example
+ * // 基本使用
+ * <Form.Item name="phone" rules={[PhoneOrMobileValidator()]}>
+ *   <Input />
+ * </Form.Item>
+ *
+ * @example
+ * // 自定义错误消息
+ * <Form.Item name="phone" rules={[PhoneOrMobileValidator('请输入正确的联系电话')]}>
+ *   <Input />
+ * </Form.Item>
+ */
+declare const PhoneOrMobileValidator: (errMessage?: string) => {
+    validator: (_: RuleObject, value: string) => Promise<void>;
+};
+/**
+ * 数值范围验证器
+ * 验证输入数值是否在指定范围内
+ *
+ * @param options - 验证选项
+ * @param options.min - 最小值
+ * @param options.max - 最大值
+ * @param options.equalMin - 是否可等于最小值，默认false
+ * @param options.equalMax - 是否可等于最大值，默认false
+ * @param options.errMessage - 通用错误消息
+ * @param options.maxErrMessage - 最大值错误消息
+ * @param options.minErrMessage - 最小值错误消息
+ * @returns Ant Design 表单验证规则对象
+ *
+ * @example
+ * // 验证年龄在0-150之间
+ * <Form.Item name="age" rules={[ThanNumValidator({ min: 0, max: 150, equalMin: true, equalMax: true })]}>
+ *   <InputNumber />
+ * </Form.Item>
+ *
+ * @example
+ * // 验证价格大于0
+ * <Form.Item name="price" rules={[ThanNumValidator({ min: 0, equalMin: false })]}>
+ *   <InputNumber />
+ * </Form.Item>
+ */
+declare const ThanNumValidator: ({ min, max, equalMin, equalMax, errMessage, maxErrMessage, minErrMessage }: {
+    min?: number | string;
+    max?: number | string;
+    equalMin?: boolean;
+    equalMax?: boolean;
+    maxErrMessage?: string;
+    minErrMessage?: string;
+    errMessage?: string;
+}) => {
+    validator: (_: RuleObject, value: string) => Promise<void>;
+};
+/**
+ * 数值位数验证器
+ * 验证输入数值的总位数、整数位数和小数位数是否符合要求
+ *
+ * @param options - 验证选项
+ * @param options.length - 总位数限制
+ * @param options.decimalsLength - 小数位数限制
+ * @param options.integerLength - 整数位数限制
+ * @param options.lengthErrMessage - 总位数错误消息
+ * @param options.decimalsLengthErrMessage - 小数位数错误消息
+ * @param options.integerLengthErrMessage - 整数位数错误消息
+ * @returns Ant Design 表单验证规则对象
+ *
+ * @example
+ * // 验证金额最多8位，其中小数点后2位
+ * <Form.Item name="amount" rules={[ThanNumLengthValidator({ length: 8, decimalsLength: 2 })]}>
+ *   <InputNumber />
+ * </Form.Item>
+ *
+ * @example
+ * // 验证百分比最多3位整数，最多2位小数
+ * <Form.Item name="percent" rules={[ThanNumLengthValidator({ integerLength: 3, decimalsLength: 2 })]}>
+ *   <InputNumber />
+ * </Form.Item>
+ */
+declare const ThanNumLengthValidator: ({ length, decimalsLength, integerLength, lengthErrMessage, decimalsLengthErrMessage, integerLengthErrMessage }: {
+    length?: number;
+    decimalsLength?: number;
+    integerLength?: number;
+    lengthErrMessage?: string;
+    decimalsLengthErrMessage?: string;
+    integerLengthErrMessage?: string;
+}) => {
+    validator: (_: RuleObject, value: string) => Promise<void>;
+};
+/**
+ * 多邮箱验证器
+ * 验证逗号分隔的多个邮箱地址是否都符合格式要求
+ *
+ * @param max - 最大邮箱数量
+ * @returns Ant Design 表单验证规则对象
+ *
+ * @example
+ * // 最多允许输入5个邮箱
+ * <Form.Item name="emails" rules={[MultiEmailValidator(5)]}>
+ *   <Input placeholder="多个邮箱用逗号分隔" />
+ * </Form.Item>
+ */
+declare const MultiEmailValidator: (max: number) => {
+    validator: (_: RuleObject, value: string) => Promise<void>;
+};
+
+/**
+ * HTTP 错误状态码常量映射
+ * 用于定义常见的 HTTP 错误响应状态码
+ */
+declare const HttpStatus: {
+    /** 服务器错误 */
+    readonly ERROR: 500;
+    /** 缺少参数或参数错误 */
+    readonly MISSING_PARAMETER: 400;
+    /** 未授权，需要用户验证 */
+    readonly UNAUTHORIZED: 401;
+    /** 禁止访问，服务器理解请求但拒绝执行 */
+    readonly FORBIDDEN: 403;
+    /** 请求的资源未找到 */
+    readonly NOT_FOUND: 404;
+};
+/**
+ * 业务码常量映射
+ * 用于定义应用层面的业务逻辑码
+ */
+declare const BusinessCode: {
+    /** 请求成功 */
+    readonly OK: 200;
+    /** 权限拒绝，没有足够的权限执行操作 */
+    readonly PERMISSION_DENIED: 13001;
+};
+/**
+ * 扩展的请求配置接口
+ * 继承自 AxiosRequestConfig，并增加了控制错误提示的选项
+ */
+interface RequestConfig extends AxiosRequestConfig {
+    showError?: boolean;
+}
+/**
+ * 创建一个配置好的 HTTP 请求实例
+ * @param config - 可选的默认配置项
+ * @returns 包含各种 HTTP 方法的对象
+ */
+declare function createRequest(config?: RequestConfig): {
     /**
-     * GET 请求方法
+     * 返回原始 axios 实例
+     * 可以用于添加拦截器等
+     */
+    instance: axios.AxiosInstance;
+    /**
+     * 发送 GET 请求
      * @param url - 请求地址
      * @param params - 查询参数
-     * @param options - Axios 配置选项
-     * @returns 响应数据
+     * @param options - 额外的请求配置
+     * @returns Promise<any> 响应数据
      */
-    get: (url: string, params?: any, options?: AxiosRequestConfig) => Promise<any>;
+    get: (url: string, params?: any, options?: RequestConfig) => Promise<any>;
     /**
-     * POST 请求方法
+     * 发送 POST 请求
      * @param url - 请求地址
-     * @param data - 请求数据
-     * @param options - Axios 配置选项
-     * @returns 响应数据
+     * @param data - 请求体数据
+     * @param options - 额外的请求配置
+     * @returns Promise<any> 响应数据
      */
-    post: (url: string, data?: any, options?: AxiosRequestConfig) => Promise<any>;
+    post: (url: string, data?: any, options?: RequestConfig) => Promise<any>;
     /**
-     * PUT 请求方法
+     * 发送 PUT 请求
      * @param url - 请求地址
-     * @param data - 请求数据
-     * @param options - Axios 配置选项
-     * @returns 响应数据
+     * @param data - 请求体数据
+     * @param options - 额外的请求配置
+     * @returns Promise<any> 响应数据
      */
-    put: (url: string, data?: any, options?: AxiosRequestConfig) => Promise<any>;
+    put: (url: string, data?: any, options?: RequestConfig) => Promise<any>;
     /**
-     * DELETE 请求方法
+     * 发送 DELETE 请求
      * @param url - 请求地址
-     * @param data - 请求数据
-     * @param options - Axios 配置选项
-     * @returns 响应数据
+     * @param data - 请求体数据
+     * @param options - 额外的请求配置
+     * @returns Promise<any> 响应数据
      */
-    delete: (url: string, data?: any, options?: AxiosRequestConfig) => Promise<any>;
+    delete: (url: string, data?: any, options?: RequestConfig) => Promise<any>;
 };
 
-/** Token 存储键名 */
-declare const TOKEN_KEY = "NS-TOKEN";
-/**
- * 设置访问令牌到 localStorage
- * @param accessToken - 访问令牌
- */
-declare function setToken(accessToken: string): void;
 /**
- * 从 URL 查询参数中获取 Token
- * @returns Token 字符串或空字符串
- */
-declare function getUrlToken(): string;
-/**
- * 获取当前有效的访问令牌
- * 优先从 URL 参数获取，其次从 localStorage 获取
- * @returns Token 字符串或空字符串
- */
-declare function getToken(): string;
+ * 获取或生成设备唯一标识
+ *
+ * 该函数用于获取设备的唯一标识符，如果本地存储中不存在则会生成一个新的唯一ID
+ * 主要用途：
+ * 1. 跟踪用户设备（不涉及个人隐私）
+ * 2. 设备统计分析
+ * 3. 防止重复提交等场景
+ *
+ * 实现逻辑：
+ * 1. 首先尝试从localStorage中获取已存储的设备ID
+ * 2. 如果存在，则直接返回该设备ID
+ * 3. 如果不存在，则生成一个新的唯一ID
+ * 4. 将新生成的ID存储到localStorage中，以便下次使用
+ * 5. 返回设备ID
+ *
+ * @param DEVICEID_KEY - 设备ID在localStorage中的存储键名
+ * @returns 设备唯一标识字符串
+ *
+ * @example
+ * // 使用自定义键名获取设备ID
+ * const deviceId = getDeviceId('MY-APP-DEVICE-ID')
+ *
+ * 注意事项：
+ * 1. 设备ID存储在localStorage中，清除浏览器数据会导致重新生成
+ * 2. 不同域名下会有不同的设备ID
+ * 3. 该ID不包含任何个人身份信息，仅用于设备识别
+ */
+declare function getDeviceId(DEVICEID_KEY: string): string;
+interface SecureManagerProps {
+    /** 存储键名 */
+    key: string;
+    /** AES加密密钥;（不传则明文存储） */
+    aesKey?: string;
+    /** 存储类型，默认为localStorage */
+    storage?: Storage;
+}
 /**
- * 清除 localStorage 中的 Token
- */
-declare function clearToken(): void;
+ * 创建安全存储管理器
+ *
+ * 提供统一的数据存储接口，支持加密和明文两种存储模式
+ *
+ * 特性：
+ * 1. 灵活存储：支持sessionStorage和localStorage
+ * 2. 可选加密：通过aesKey参数控制是否加密存储
+ * 3. 自动处理：根据是否提供aesKey自动切换加密/明文模式
+ * 4. 类型安全：支持泛型，可指定存储数据的类型
+ *
+ * @param options 安全存储配置选项
+ * @returns 安全存储管理器对象
+ *
+ * @example
+ * // 加密存储（提供aesKey时自动启用加密）
+ * const secureManager = createSecureManager({
+ *   key: 'user-profile',
+ *   aesKey: 'my-secret-key'
+ * })
+ * secureManager.set({ name: 'John', id: 123 })
+ *
+ * @example
+ * // 明文存储（不提供aesKey时使用明文存储）
+ * const plainManager = createSecureManager({
+ *   key: 'app-settings'
+ * })
+ * plainManager.set({ theme: 'dark', lang: 'en' })
+ *
+ * @example
+ * // 自定义存储类型
+ * const localManager = createSecureManager({
+ *   key: 'local-data',
+ *   aesKey: 'secret-key',
+ *   storage: localStorage
+ * })
+ */
+declare function createSecureManager<T>({ key, storage, aesKey }: SecureManagerProps): {
+    set: (data: T) => void;
+    get: () => T | null;
+    clear: () => void;
+};
+interface TokenManagerProps {
+    /** token在存储中的键名 */
+    key: string;
+    /** 存储类型，支持localStorage和sessionStorage，默认为localStorage */
+    storage?: Storage;
+}
 /**
- * 获取登录页面路径
- * @returns 登录路径，默认为 '/sign-in'
- */
-declare function getSignPath(): string;
-
-/** 项目主色调 */
-declare const LgPrimaryColor: string;
-/** Ant Design 主题配置 */
-declare const themeConfig: ThemeConfig;
+ * 创建token管理器
+ *
+ * 提供统一的token管理功能，支持从URL参数或存储中获取、设置和清除token
+ *
+ * 设计特点：
+ * 1. 自动同步：从URL获取token时会自动同步到存储中
+ * 2. 灵活存储：支持localStorage和sessionStorage
+ * 3. 优先级获取：优先使用URL参数中的token
+ * 4. 简洁API：提供完整的token管理操作
+ *
+ * @param options token管理器配置选项
+ * @returns token管理器对象
+ *
+ * @example
+ * // 创建基于localStorage的token管理器
+ * const tokenManager = createTokenManager({
+ *   key: 'ACCESS_TOKEN'
+ * })
+ *
+ * // 从URL参数或localStorage获取token
+ * const token = tokenManager.get()
+ *
+ * // 设置token
+ * tokenManager.set('new-token-value')
+ *
+ * // 清除token
+ * tokenManager.clear()
+ *
+ * @example
+ * // 创建基于sessionStorage的token管理器
+ * const tokenManager = createTokenManager({
+ *   key: 'SESSION_TOKEN',
+ *   storage: sessionStorage
+ * })
+ */
+declare function createTokenManager({ key, storage }: TokenManagerProps): {
+    set: (data: string) => void;
+    get: () => string;
+    clear: () => void;
+};
 
-export { _default$b as AudioPlayer, type AudioPlayerProps, type ComponentMapType, DateFormatType, DateFormatType2, ERROR, FORBIDDEN, _default$a as FileIcon, type FileIconProps, _default$9 as FilePreview, _default$8 as FilePreviewDrawer, type FilePreviewDrawerProps, type FilePreviewProps, _default$4 as Iframe, type IframeProps, _default$3 as LazyComponent, type LazyComponentProps, LgPrimaryColor, MISSING_PARAMETER, _default$2 as MarkdownEditor, type MarkdownEditorProps, _default$7 as MarkdownPreview, type MarkdownPreviewProps, NOT_FOUND, type NsSetIntervalReturnType, OK, PERMISSION_DENIED, type Params, _default$6 as PdfPreview, type PdfPreviewProps, type RenderControl, type RenderControlObj, _default$1 as RenderMarkdown, type RenderMarkdownProps, RenderWrapper, type RenderWrapperProps, TOKEN_KEY, UNAUTHORIZED, _default as UserAvatar, type UserAvatarProps, _default$5 as VideoPlayer, type VideoPlayerProps, absVal, addUrlLastSlash, arrToObj, buildUrlParams, calculate, clearCurrentUser, clearToken, compareNum, copyText, createRequest, decimalPlaces, deepCopy, deepEqual, deepMerge, dividedBy, downloadFile, emit, emitToChild, formatDate, formatNumberWithCommas, genNonDuplicateID, generateRandomNumbers, getCurrentUser, getDeviceId, getEndOfTimestamp, getFileName, getFileSuffixName, getSignPath, getStartOfTimestamp, getTimestamp, getToken, getUrlMainSource, getUrlToken, getWebSocketUrl, is, isArray, isBlob, isBoolean, isClient, isDate, isDef, isElement, isEmpty, isEmptyObj, isExpire, isExternal, isFunction, isInteger, isLocalhost, isMap, isNegative, isNull, isNullOrUnDef, isNumber, isNumberNoNaN, isObject, isPromise, isRegExp, isServer, isString, isUnDef, isWindow, minus, nsSetInterval, objToOptions, plus, precision, propsMerge, setCurrentUser, setToken, shouldRender, textAreaView, themeConfig, times, toFixed, transform, transforms, useCreateValtioContext, useDebounce, useDeepEffect, useIframeRelayBridge, useRefState, useSyncInput, useThrottle, useWebSocket };
+export { _default$m as AudioPlayer, type AudioPlayerProps, BusinessCode, type CacheMessage, type ComponentMapType, DEFAULT_DATE_FORMAT, DEFAULT_DATE_TIME_FORMAT, DEFAULT_YEAR_MONTH_DAY_FORMAT, DEFAULT_YEAR_MONTH_FORMAT, _default$l as FileIcon, type FileIconProps, _default$k as FilePreview, _default$j as FilePreviewDrawer, type FilePreviewDrawerProps, type FilePreviewProps, HttpStatus, _default$f as Iframe, type IframeProps, _default$e as LazyComponent, type LazyComponentProps, _default$d as MarkdownEditor, type MarkdownEditorProps, _default$i as MarkdownPreview, type MarkdownPreviewProps, MultiEmailValidator, _default$h as PdfPreview, type PdfPreviewProps, PhoneOrMobileValidator, RegBankCardNo, RegDetailAddress, RegEmail, RegFixedTelePhone, RegIdentityCardNo, RegMobile, RegNumNo, RegSmsCode, RegTaxNo, RegTelePhone, type RenderControl, _default$c as RenderMarkdown, type RenderMarkdownProps, _default$b as RenderWrapper, type RenderWrapperProps, type RequestConfig, type SecureManagerProps, ThanNumLengthValidator, ThanNumValidator, type TokenManagerProps, _default$a as UserAvatar, type UserAvatarProps, _default$g as VideoPlayer, type VideoPlayerProps, type WebSocketProps, type WebSocketType, absVal, addUrlLastSlash, aesDecrypt, aesEncrypt, arrToObj, buildUrlParams, cachedMessage, calculate, compareNum, convertCurrency, convertNewlineToBr, copyText, createRequest, createSecureManager, createTokenManager, decimalPlaces, deepCopy, deepEqual, deepMerge, dividedBy, downloadFile, emit, emitToChild, executeScript, formatDate, formatNumberWithCommas, genNonDuplicateID, generateRandomNumbers, getAllUrlParams, getDeviceId, getEndOfTimestamp, getFileName, getFileSuffixName, getRowSpanCount, getStartOfTimestamp, getTimestamp, getWebSocketUrl, importThirdPartyFile, is, isArray, isBlob, isBoolean, isDate, isDef, isElement, isEmpty, isEmptyObj, isExpire, isExternal, isFunction, isInteger, isJson, isLocalhost, isMap, isNegative, isNull, isNullOrUnDef, isNumber, isNumberNoNaN, isObject, isPromise, isReferenceType, isRegExp, isScriptSafe, isSet, isString, isUnDef, isWindow, minus, objToOptions, plus, precision, processItemList, propsMerge, setInterval, setUrlMainSource, shouldRender, times, toFixed, transform, transforms, _default$8 as useAutoRefresh, _default$7 as useCountDown, _default$6 as useCreateValtioContext, _default$5 as useDebounce, _default$4 as useDeepEffect, _default$9 as useIframeRelayBridge, _default$3 as useRefState, _default$2 as useSyncInput, _default$1 as useThrottle, _default as useWebSocket };