@zero-library/common 2.3.12 → 2.4.1

package/dist/index.d.mts

@@ -20,7 +20,7 @@ interface AudioPlayerProps {
  * 提供基本的音频播放功能
  * @param props - 组件属性
  */
-declare const _default$r: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$q: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /** Docx文档预览组件的属性接口 */
 interface DocxPreviewProps {
@@ -33,7 +33,7 @@ interface DocxPreviewProps {
  * Docx文档预览组件
  * @param props - 组件属性
  */
-declare const _default$q: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$p: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件图标组件属性接口
@@ -59,7 +59,7 @@ interface FileIconProps {
  * @param props - 组件属性
  * @returns 对应文件类型的图标
  */
-declare const _default$p: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
+declare const _default$o: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览组件属性接口
@@ -93,7 +93,7 @@ interface FilePreviewProps {
  * 支持图片、PDF、视频、音频、Markdown等文件格式的预览
  * @param props - 组件属性
  */
-declare const _default$o: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$n: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览抽屉组件属性接口
@@ -123,7 +123,7 @@ interface FilePreviewDrawerProps extends FilePreviewProps {
  * @param props - 组件属性
  * @returns 文件预览抽屉组件
  */
-declare const _default$n: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$m: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown预览组件属性接口
@@ -139,7 +139,7 @@ interface MarkdownPreviewProps {
  * 从指定URL获取Markdown内容并渲染显示
  * @param props - 组件属性
  */
-declare const _default$m: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$l: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
 
 interface PdfImagePreviewProps {
     /** PDF文件URL地址 */
@@ -159,7 +159,7 @@ interface PdfImagePreviewProps {
  * @param props - 组件属性
  * 适用于大量PDF页面的高效展示
  */
-declare const _default$l: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$k: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * PDF预览组件属性接口
@@ -187,7 +187,7 @@ interface PdfPreviewProps {
  * @param props - 组件属性
  * TODO 放大缩小会丢失分页
  */
-declare const _default$k: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$j: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 视频播放器组件属性接口
@@ -201,7 +201,7 @@ interface VideoPlayerProps {
  * 提供基本的视频播放功能
  * @param props - 组件属性
  */
-declare const _default$j: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$i: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Iframe组件属性接口
@@ -223,7 +223,7 @@ interface IframeProps {
  * 支持加载状态、URL参数处理、防缓存等功能
  * @param props - 组件属性
  */
-declare const _default$i: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
+declare const _default$h: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
 
 /**
  * 组件映射类型，用于延时加载
@@ -250,7 +250,7 @@ interface LazyComponentProps {
  * 使用示例：<LazyComponent type="renderMarkdown" data={{}} loading={true} />
  * @param props - 组件属性
  */
-declare const _default$h: ({ type, customComponents, unknownContent, ...rest }: LazyComponentProps) => string | number | true | react_jsx_runtime.JSX.Element | Iterable<react.ReactNode>;
+declare const _default$g: ({ type, customComponents, unknownContent, ...rest }: LazyComponentProps) => string | number | true | react_jsx_runtime.JSX.Element | Iterable<react.ReactNode>;
 
 declare const ANNOTATION_ATTRS: readonly ["annotation-id", "user-name", "user-id", "update-time", "content"];
 /**
@@ -353,6 +353,16 @@ interface CollectionConfig extends CollectionsProps {
  */
 type ToolbarItem = 'undo-redo' | 'heading' | 'list' | 'block' | 'format' | 'script' | 'align';
 
+/**
+ * 分页功能配置接口
+ */
+interface PageNoConfig {
+    /** 是否启用分页功能，默认为false */
+    enabled: boolean;
+    /** 页面滚动回调 */
+    onScrollPage?: (pageIndex: number) => void;
+}
+
 /**
  * Markdown编辑器组件属性接口
  */
@@ -379,12 +389,7 @@ interface MarkdownEditorProps {
     annotationConfig?: AnnotationConfig;
     /** 摘录功能专属配置，不与批注混淆 */
     collectionConfig?: CollectionConfig;
-    pageNoConfig?: {
-        /** 是否启用分页功能，默认为false */
-        enabled: boolean;
-        /** 页面滚动回调 */
-        onScrollPage?: (pageIndex: number) => void;
-    };
+    pageNoConfig?: PageNoConfig;
 }
 /**
  * Markdown编辑器组件
@@ -392,7 +397,7 @@ interface MarkdownEditorProps {
  * 提供丰富的编辑功能：格式化、链接、图片、表格、高亮等
  * @param props - 组件属性
  */
-declare const _default$g: ({ value, onChange, searchValue, disabled, extraNav, fixedToolbar, floatToolbar, onQuote, onDownloadFile, annotationConfig, collectionConfig, pageNoConfig }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+declare const _default$f: ({ value, onChange, searchValue, disabled, extraNav, fixedToolbar, floatToolbar, onQuote, onDownloadFile, annotationConfig, collectionConfig, pageNoConfig }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
 
 interface Detection {
     bbox: [number, number, number, number];
@@ -417,7 +422,7 @@ interface MarkDrawingProps {
  * @param originalSize - 原始尺寸信息
  * @param scopeRender - 可选的作用域渲染函数
  */
-declare const _default$f: ({ children, detections, originalSize, scopeRender }: MarkDrawingProps) => react_jsx_runtime.JSX.Element;
+declare const _default$e: ({ children, detections, originalSize, scopeRender }: MarkDrawingProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown渲染组件属性接口
@@ -438,7 +443,7 @@ interface RenderMarkdownProps {
  * 支持自定义组件、搜索高亮等功能
  * @param RenderMarkdownProps - 组件属性
  */
-declare const _default$e: ({ content, searchValue, customComponents, ...rest }: RenderMarkdownProps) => react_jsx_runtime.JSX.Element;
+declare const _default$d: ({ content, searchValue, customComponents, ...rest }: RenderMarkdownProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 渲染控制对象类型
@@ -490,7 +495,7 @@ interface RenderWrapperProps<C, P> {
  * @param props - 组件属性
  * @returns 渲染的组件或null
  */
-declare const _default$d: react.ForwardRefExoticComponent<RenderWrapperProps<unknown, unknown> & react.RefAttributes<unknown>>;
+declare const _default$c: react.ForwardRefExoticComponent<RenderWrapperProps<unknown, unknown> & react.RefAttributes<unknown>>;
 
 /**
  * 判断是否应该渲染组件
@@ -510,44 +515,6 @@ declare function propsMerge(control?: RenderControl<any, any> | null, props?: Ob
     props: any;
 };
 
-type SpeechPermission = 'granted' | 'denied' | 'prompt' | 'unsupported';
-type SpeechProps = {
-    /**
-     * 识别结果回调函数
-     */
-    onResult: (text: string) => void;
-    /**
-     * 语言，默认为中文
-     */
-    lang?: string;
-};
-/**
- * 语音识别 Hook
- * @param onResult 识别结果回调函数
- * @param lang 语言，默认为中文
- * @returns 返回权限状态、录音状态和控制方法
- */
-declare const _default$c: ({ onResult, lang }: SpeechProps) => {
-    /**
-     * 权限状态
-     */
-    permission: SpeechPermission;
-    /**
-     * 录音状态
-     */
-    isRecording: boolean;
-    /** 开始语音识别 */
-    start: () => void;
-    /** 停止语音识别 */
-    stop: () => void;
-};
-
-/**
- * 语音按钮
- * @param SpeechProps
- */
-declare const _default$b: (props: SpeechProps) => react_jsx_runtime.JSX.Element;
-
 /**
  * 用户头像组件属性接口
  */
@@ -564,7 +531,7 @@ interface UserAvatarProps {
  * 如果没有头像图片，则显示用户名首字母作为头像
  * @param props - 组件属性
  */
-declare const _default$a: ({ size, avatarSrc, userName }: UserAvatarProps) => react_jsx_runtime.JSX.Element;
+declare const _default$b: ({ size, avatarSrc, userName }: UserAvatarProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * iframe 消息参数类型
@@ -621,11 +588,54 @@ type Handler<P = Params> = (params: P, source?: MessageEventSource | null, origi
  * off('custom-event', handleMessage)
  * ```
  */
-declare const _default$9: (allowedOrigins?: string[]) => {
+declare const _default$a: (allowedOrigins?: string[]) => {
     on: (type: string, handler: Handler<Params>) => void;
     off: (type: string, handler: Handler<Params>) => void;
 };
 
+/**
+ * 队列任务定义
+ * - func：任务函数（可同步/异步）
+ * - args：任务参数（透传给 func）
+ */
+type QueueTask = {
+    func: (...args: any[]) => Promise<void> | void;
+    args: any[];
+};
+/**
+ * 异步队列 Hook
+ * 用于按顺序串行执行一组异步任务（FIFO），避免并发导致的竞态问题。
+ *
+ * 设计目标：
+ * - 同一时刻只执行一个任务，后续任务自动排队
+ * - 支持暂停/恢复执行
+ * - 保持 API 简单，具体任务逻辑由调用方提供
+ * - 默认不丢任务：任务入队后会一直等待，直到执行完成或被清空
+ *
+ * @returns 队列控制方法与状态
+ * - addToQueue：入队一个任务
+ * - executeQueue：暂停/恢复队列的自动执行
+ * - clearQueue：清空等待中的任务（不影响当前正在执行的任务）
+ * - queueSize：当前等待队列长度（不含正在执行中的任务）
+ * - enabled：当前是否允许自动执行
+ * - running：当前是否正在执行任务
+ *
+ * @example
+ * const { addToQueue, executeQueue } = useAsyncQueue()
+ * addToQueue(async (id) => await fetchById(id), '1')
+ * addToQueue(async () => await refresh())
+ * executeQueue(false) // 暂停执行（默认即为 true）
+ *
+ */
+declare const _default$9: () => {
+    addToQueue: (func: QueueTask["func"], ...args: QueueTask["args"]) => void;
+    executeQueue: (nextEnabled: boolean) => void;
+    clearQueue: () => void;
+    queueSize: number;
+    enabled: boolean;
+    running: boolean;
+};
+
 /**
  * 通用的自动刷新 Hook
  * 监听指定值的变化，当满足条件时自动触发回调函数
@@ -2489,4 +2499,4 @@ declare function createTokenManager({ key, storage }: TokenManagerProps): {
     clear: () => void;
 };
 
-export { type AnnotationConfig, type AnnotationType, _default$r as AudioPlayer, type AudioPlayerProps, BusinessCode, type CacheMessage, type CollectionConfig, type CollectionType, type ComponentMapType, DEFAULT_DATE_FORMAT, DEFAULT_DATE_TIME_FORMAT, DEFAULT_YEAR_MONTH_DAY_FORMAT, DEFAULT_YEAR_MONTH_FORMAT, _default$q as DocxPreview, type DocxPreviewProps, _default$p as FileIcon, type FileIconProps, _default$o as FilePreview, _default$n as FilePreviewDrawer, type FilePreviewDrawerProps, type FilePreviewProps, type FindTreeNodesOptions, type FormatSizeOptions, HttpStatus, _default$i as Iframe, type IframeProps, _default$h as LazyComponent, type LazyComponentProps, _default$f as MarkDrawing, _default$g as MarkdownEditor, type MarkdownEditorProps, _default$m as MarkdownPreview, type MarkdownPreviewProps, MultiEmailValidator, _default$l as PdfImagePreview, type PdfImagePreviewProps, _default$k as PdfPreview, type PdfPreviewProps, PhoneOrMobileValidator, RegBankCardNo, RegDetailAddress, RegEmail, RegFixedTelePhone, RegIdentityCardNo, RegMobile, RegNumNo, RegPassword, RegSmsCode, RegTaxNo, RegTelePhone, type RenderControl, _default$e as RenderMarkdown, type RenderMarkdownProps, _default$d as RenderWrapper, type RenderWrapperProps, type RequestConfig, type SecureManagerProps, type SetIntervalType, type SizeUnit, _default$b as SpeechButton, type SpeechPermission, type SpeechProps, ThanNumLengthValidator, ThanNumValidator, type TokenManagerProps, _default$a as UserAvatar, type UserAvatarProps, _default$j 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, findTreeNodesByIds, formatDate, formatNumberWithCommas, formatSize, genNonDuplicateID, generateRandomNumbers, getAllUrlParams, getDeviceId, getEndOfTimestamp, getFileName, getFileSuffixName, getRowSpanCount, getStartOfTimestamp, getTimestamp, getWebSocketUrl, htmlToMarkdown, htmlToText, 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, markdownToText, 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$c as useSpeech, _default$2 as useSyncInput, _default$1 as useThrottle, _default as useWebSocket };
+export { type AnnotationConfig, type AnnotationType, _default$q as AudioPlayer, type AudioPlayerProps, BusinessCode, type CacheMessage, type CollectionConfig, type CollectionType, type ComponentMapType, DEFAULT_DATE_FORMAT, DEFAULT_DATE_TIME_FORMAT, DEFAULT_YEAR_MONTH_DAY_FORMAT, DEFAULT_YEAR_MONTH_FORMAT, _default$p as DocxPreview, type DocxPreviewProps, _default$o as FileIcon, type FileIconProps, _default$n as FilePreview, _default$m as FilePreviewDrawer, type FilePreviewDrawerProps, type FilePreviewProps, type FindTreeNodesOptions, type FormatSizeOptions, HttpStatus, _default$h as Iframe, type IframeProps, _default$g as LazyComponent, type LazyComponentProps, _default$e as MarkDrawing, type MarkDrawingProps, _default$f as MarkdownEditor, type MarkdownEditorProps, _default$l as MarkdownPreview, type MarkdownPreviewProps, MultiEmailValidator, _default$k as PdfImagePreview, type PdfImagePreviewProps, _default$j as PdfPreview, type PdfPreviewProps, PhoneOrMobileValidator, RegBankCardNo, RegDetailAddress, RegEmail, RegFixedTelePhone, RegIdentityCardNo, RegMobile, RegNumNo, RegPassword, RegSmsCode, RegTaxNo, RegTelePhone, type RenderControl, _default$d as RenderMarkdown, type RenderMarkdownProps, _default$c as RenderWrapper, type RenderWrapperProps, type RequestConfig, type SecureManagerProps, type SetIntervalType, type SizeUnit, ThanNumLengthValidator, ThanNumValidator, type TokenManagerProps, _default$b as UserAvatar, type UserAvatarProps, _default$i 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, findTreeNodesByIds, formatDate, formatNumberWithCommas, formatSize, genNonDuplicateID, generateRandomNumbers, getAllUrlParams, getDeviceId, getEndOfTimestamp, getFileName, getFileSuffixName, getRowSpanCount, getStartOfTimestamp, getTimestamp, getWebSocketUrl, htmlToMarkdown, htmlToText, 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, markdownToText, minus, objToOptions, plus, precision, processItemList, propsMerge, setInterval, setUrlMainSource, shouldRender, times, toFixed, transform, transforms, _default$9 as useAsyncQueue, _default$8 as useAutoRefresh, _default$7 as useCountDown, _default$6 as useCreateValtioContext, _default$5 as useDebounce, _default$4 as useDeepEffect, _default$a as useIframeRelayBridge, _default$3 as useRefState, _default$2 as useSyncInput, _default$1 as useThrottle, _default as useWebSocket };

package/dist/index.d.ts

@@ -20,7 +20,7 @@ interface AudioPlayerProps {
  * 提供基本的音频播放功能
  * @param props - 组件属性
  */
-declare const _default$r: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$q: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /** Docx文档预览组件的属性接口 */
 interface DocxPreviewProps {
@@ -33,7 +33,7 @@ interface DocxPreviewProps {
  * Docx文档预览组件
  * @param props - 组件属性
  */
-declare const _default$q: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$p: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件图标组件属性接口
@@ -59,7 +59,7 @@ interface FileIconProps {
  * @param props - 组件属性
  * @returns 对应文件类型的图标
  */
-declare const _default$p: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
+declare const _default$o: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览组件属性接口
@@ -93,7 +93,7 @@ interface FilePreviewProps {
  * 支持图片、PDF、视频、音频、Markdown等文件格式的预览
  * @param props - 组件属性
  */
-declare const _default$o: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$n: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览抽屉组件属性接口
@@ -123,7 +123,7 @@ interface FilePreviewDrawerProps extends FilePreviewProps {
  * @param props - 组件属性
  * @returns 文件预览抽屉组件
  */
-declare const _default$n: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$m: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown预览组件属性接口
@@ -139,7 +139,7 @@ interface MarkdownPreviewProps {
  * 从指定URL获取Markdown内容并渲染显示
  * @param props - 组件属性
  */
-declare const _default$m: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$l: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
 
 interface PdfImagePreviewProps {
     /** PDF文件URL地址 */
@@ -159,7 +159,7 @@ interface PdfImagePreviewProps {
  * @param props - 组件属性
  * 适用于大量PDF页面的高效展示
  */
-declare const _default$l: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$k: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * PDF预览组件属性接口
@@ -187,7 +187,7 @@ interface PdfPreviewProps {
  * @param props - 组件属性
  * TODO 放大缩小会丢失分页
  */
-declare const _default$k: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$j: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 视频播放器组件属性接口
@@ -201,7 +201,7 @@ interface VideoPlayerProps {
  * 提供基本的视频播放功能
  * @param props - 组件属性
  */
-declare const _default$j: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$i: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Iframe组件属性接口
@@ -223,7 +223,7 @@ interface IframeProps {
  * 支持加载状态、URL参数处理、防缓存等功能
  * @param props - 组件属性
  */
-declare const _default$i: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
+declare const _default$h: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
 
 /**
  * 组件映射类型，用于延时加载
@@ -250,7 +250,7 @@ interface LazyComponentProps {
  * 使用示例：<LazyComponent type="renderMarkdown" data={{}} loading={true} />
  * @param props - 组件属性
  */
-declare const _default$h: ({ type, customComponents, unknownContent, ...rest }: LazyComponentProps) => string | number | true | react_jsx_runtime.JSX.Element | Iterable<react.ReactNode>;
+declare const _default$g: ({ type, customComponents, unknownContent, ...rest }: LazyComponentProps) => string | number | true | react_jsx_runtime.JSX.Element | Iterable<react.ReactNode>;
 
 declare const ANNOTATION_ATTRS: readonly ["annotation-id", "user-name", "user-id", "update-time", "content"];
 /**
@@ -353,6 +353,16 @@ interface CollectionConfig extends CollectionsProps {
  */
 type ToolbarItem = 'undo-redo' | 'heading' | 'list' | 'block' | 'format' | 'script' | 'align';
 
+/**
+ * 分页功能配置接口
+ */
+interface PageNoConfig {
+    /** 是否启用分页功能，默认为false */
+    enabled: boolean;
+    /** 页面滚动回调 */
+    onScrollPage?: (pageIndex: number) => void;
+}
+
 /**
  * Markdown编辑器组件属性接口
  */
@@ -379,12 +389,7 @@ interface MarkdownEditorProps {
     annotationConfig?: AnnotationConfig;
     /** 摘录功能专属配置，不与批注混淆 */
     collectionConfig?: CollectionConfig;
-    pageNoConfig?: {
-        /** 是否启用分页功能，默认为false */
-        enabled: boolean;
-        /** 页面滚动回调 */
-        onScrollPage?: (pageIndex: number) => void;
-    };
+    pageNoConfig?: PageNoConfig;
 }
 /**
  * Markdown编辑器组件
@@ -392,7 +397,7 @@ interface MarkdownEditorProps {
  * 提供丰富的编辑功能：格式化、链接、图片、表格、高亮等
  * @param props - 组件属性
  */
-declare const _default$g: ({ value, onChange, searchValue, disabled, extraNav, fixedToolbar, floatToolbar, onQuote, onDownloadFile, annotationConfig, collectionConfig, pageNoConfig }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+declare const _default$f: ({ value, onChange, searchValue, disabled, extraNav, fixedToolbar, floatToolbar, onQuote, onDownloadFile, annotationConfig, collectionConfig, pageNoConfig }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
 
 interface Detection {
     bbox: [number, number, number, number];
@@ -417,7 +422,7 @@ interface MarkDrawingProps {
  * @param originalSize - 原始尺寸信息
  * @param scopeRender - 可选的作用域渲染函数
  */
-declare const _default$f: ({ children, detections, originalSize, scopeRender }: MarkDrawingProps) => react_jsx_runtime.JSX.Element;
+declare const _default$e: ({ children, detections, originalSize, scopeRender }: MarkDrawingProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown渲染组件属性接口
@@ -438,7 +443,7 @@ interface RenderMarkdownProps {
  * 支持自定义组件、搜索高亮等功能
  * @param RenderMarkdownProps - 组件属性
  */
-declare const _default$e: ({ content, searchValue, customComponents, ...rest }: RenderMarkdownProps) => react_jsx_runtime.JSX.Element;
+declare const _default$d: ({ content, searchValue, customComponents, ...rest }: RenderMarkdownProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 渲染控制对象类型
@@ -490,7 +495,7 @@ interface RenderWrapperProps<C, P> {
  * @param props - 组件属性
  * @returns 渲染的组件或null
  */
-declare const _default$d: react.ForwardRefExoticComponent<RenderWrapperProps<unknown, unknown> & react.RefAttributes<unknown>>;
+declare const _default$c: react.ForwardRefExoticComponent<RenderWrapperProps<unknown, unknown> & react.RefAttributes<unknown>>;
 
 /**
  * 判断是否应该渲染组件
@@ -510,44 +515,6 @@ declare function propsMerge(control?: RenderControl<any, any> | null, props?: Ob
     props: any;
 };
 
-type SpeechPermission = 'granted' | 'denied' | 'prompt' | 'unsupported';
-type SpeechProps = {
-    /**
-     * 识别结果回调函数
-     */
-    onResult: (text: string) => void;
-    /**
-     * 语言，默认为中文
-     */
-    lang?: string;
-};
-/**
- * 语音识别 Hook
- * @param onResult 识别结果回调函数
- * @param lang 语言，默认为中文
- * @returns 返回权限状态、录音状态和控制方法
- */
-declare const _default$c: ({ onResult, lang }: SpeechProps) => {
-    /**
-     * 权限状态
-     */
-    permission: SpeechPermission;
-    /**
-     * 录音状态
-     */
-    isRecording: boolean;
-    /** 开始语音识别 */
-    start: () => void;
-    /** 停止语音识别 */
-    stop: () => void;
-};
-
-/**
- * 语音按钮
- * @param SpeechProps
- */
-declare const _default$b: (props: SpeechProps) => react_jsx_runtime.JSX.Element;
-
 /**
  * 用户头像组件属性接口
  */
@@ -564,7 +531,7 @@ interface UserAvatarProps {
  * 如果没有头像图片，则显示用户名首字母作为头像
  * @param props - 组件属性
  */
-declare const _default$a: ({ size, avatarSrc, userName }: UserAvatarProps) => react_jsx_runtime.JSX.Element;
+declare const _default$b: ({ size, avatarSrc, userName }: UserAvatarProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * iframe 消息参数类型
@@ -621,11 +588,54 @@ type Handler<P = Params> = (params: P, source?: MessageEventSource | null, origi
  * off('custom-event', handleMessage)
  * ```
  */
-declare const _default$9: (allowedOrigins?: string[]) => {
+declare const _default$a: (allowedOrigins?: string[]) => {
     on: (type: string, handler: Handler<Params>) => void;
     off: (type: string, handler: Handler<Params>) => void;
 };
 
+/**
+ * 队列任务定义
+ * - func：任务函数（可同步/异步）
+ * - args：任务参数（透传给 func）
+ */
+type QueueTask = {
+    func: (...args: any[]) => Promise<void> | void;
+    args: any[];
+};
+/**
+ * 异步队列 Hook
+ * 用于按顺序串行执行一组异步任务（FIFO），避免并发导致的竞态问题。
+ *
+ * 设计目标：
+ * - 同一时刻只执行一个任务，后续任务自动排队
+ * - 支持暂停/恢复执行
+ * - 保持 API 简单，具体任务逻辑由调用方提供
+ * - 默认不丢任务：任务入队后会一直等待，直到执行完成或被清空
+ *
+ * @returns 队列控制方法与状态
+ * - addToQueue：入队一个任务
+ * - executeQueue：暂停/恢复队列的自动执行
+ * - clearQueue：清空等待中的任务（不影响当前正在执行的任务）
+ * - queueSize：当前等待队列长度（不含正在执行中的任务）
+ * - enabled：当前是否允许自动执行
+ * - running：当前是否正在执行任务
+ *
+ * @example
+ * const { addToQueue, executeQueue } = useAsyncQueue()
+ * addToQueue(async (id) => await fetchById(id), '1')
+ * addToQueue(async () => await refresh())
+ * executeQueue(false) // 暂停执行（默认即为 true）
+ *
+ */
+declare const _default$9: () => {
+    addToQueue: (func: QueueTask["func"], ...args: QueueTask["args"]) => void;
+    executeQueue: (nextEnabled: boolean) => void;
+    clearQueue: () => void;
+    queueSize: number;
+    enabled: boolean;
+    running: boolean;
+};
+
 /**
  * 通用的自动刷新 Hook
  * 监听指定值的变化，当满足条件时自动触发回调函数
@@ -2489,4 +2499,4 @@ declare function createTokenManager({ key, storage }: TokenManagerProps): {
     clear: () => void;
 };
 
-export { type AnnotationConfig, type AnnotationType, _default$r as AudioPlayer, type AudioPlayerProps, BusinessCode, type CacheMessage, type CollectionConfig, type CollectionType, type ComponentMapType, DEFAULT_DATE_FORMAT, DEFAULT_DATE_TIME_FORMAT, DEFAULT_YEAR_MONTH_DAY_FORMAT, DEFAULT_YEAR_MONTH_FORMAT, _default$q as DocxPreview, type DocxPreviewProps, _default$p as FileIcon, type FileIconProps, _default$o as FilePreview, _default$n as FilePreviewDrawer, type FilePreviewDrawerProps, type FilePreviewProps, type FindTreeNodesOptions, type FormatSizeOptions, HttpStatus, _default$i as Iframe, type IframeProps, _default$h as LazyComponent, type LazyComponentProps, _default$f as MarkDrawing, _default$g as MarkdownEditor, type MarkdownEditorProps, _default$m as MarkdownPreview, type MarkdownPreviewProps, MultiEmailValidator, _default$l as PdfImagePreview, type PdfImagePreviewProps, _default$k as PdfPreview, type PdfPreviewProps, PhoneOrMobileValidator, RegBankCardNo, RegDetailAddress, RegEmail, RegFixedTelePhone, RegIdentityCardNo, RegMobile, RegNumNo, RegPassword, RegSmsCode, RegTaxNo, RegTelePhone, type RenderControl, _default$e as RenderMarkdown, type RenderMarkdownProps, _default$d as RenderWrapper, type RenderWrapperProps, type RequestConfig, type SecureManagerProps, type SetIntervalType, type SizeUnit, _default$b as SpeechButton, type SpeechPermission, type SpeechProps, ThanNumLengthValidator, ThanNumValidator, type TokenManagerProps, _default$a as UserAvatar, type UserAvatarProps, _default$j 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, findTreeNodesByIds, formatDate, formatNumberWithCommas, formatSize, genNonDuplicateID, generateRandomNumbers, getAllUrlParams, getDeviceId, getEndOfTimestamp, getFileName, getFileSuffixName, getRowSpanCount, getStartOfTimestamp, getTimestamp, getWebSocketUrl, htmlToMarkdown, htmlToText, 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, markdownToText, 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$c as useSpeech, _default$2 as useSyncInput, _default$1 as useThrottle, _default as useWebSocket };
+export { type AnnotationConfig, type AnnotationType, _default$q as AudioPlayer, type AudioPlayerProps, BusinessCode, type CacheMessage, type CollectionConfig, type CollectionType, type ComponentMapType, DEFAULT_DATE_FORMAT, DEFAULT_DATE_TIME_FORMAT, DEFAULT_YEAR_MONTH_DAY_FORMAT, DEFAULT_YEAR_MONTH_FORMAT, _default$p as DocxPreview, type DocxPreviewProps, _default$o as FileIcon, type FileIconProps, _default$n as FilePreview, _default$m as FilePreviewDrawer, type FilePreviewDrawerProps, type FilePreviewProps, type FindTreeNodesOptions, type FormatSizeOptions, HttpStatus, _default$h as Iframe, type IframeProps, _default$g as LazyComponent, type LazyComponentProps, _default$e as MarkDrawing, type MarkDrawingProps, _default$f as MarkdownEditor, type MarkdownEditorProps, _default$l as MarkdownPreview, type MarkdownPreviewProps, MultiEmailValidator, _default$k as PdfImagePreview, type PdfImagePreviewProps, _default$j as PdfPreview, type PdfPreviewProps, PhoneOrMobileValidator, RegBankCardNo, RegDetailAddress, RegEmail, RegFixedTelePhone, RegIdentityCardNo, RegMobile, RegNumNo, RegPassword, RegSmsCode, RegTaxNo, RegTelePhone, type RenderControl, _default$d as RenderMarkdown, type RenderMarkdownProps, _default$c as RenderWrapper, type RenderWrapperProps, type RequestConfig, type SecureManagerProps, type SetIntervalType, type SizeUnit, ThanNumLengthValidator, ThanNumValidator, type TokenManagerProps, _default$b as UserAvatar, type UserAvatarProps, _default$i 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, findTreeNodesByIds, formatDate, formatNumberWithCommas, formatSize, genNonDuplicateID, generateRandomNumbers, getAllUrlParams, getDeviceId, getEndOfTimestamp, getFileName, getFileSuffixName, getRowSpanCount, getStartOfTimestamp, getTimestamp, getWebSocketUrl, htmlToMarkdown, htmlToText, 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, markdownToText, minus, objToOptions, plus, precision, processItemList, propsMerge, setInterval, setUrlMainSource, shouldRender, times, toFixed, transform, transforms, _default$9 as useAsyncQueue, _default$8 as useAutoRefresh, _default$7 as useCountDown, _default$6 as useCreateValtioContext, _default$5 as useDebounce, _default$4 as useDeepEffect, _default$a as useIframeRelayBridge, _default$3 as useRefState, _default$2 as useSyncInput, _default$1 as useThrottle, _default as useWebSocket };