@zero-library/common 2.2.13 → 2.3.0

package/dist/index.d.mts

@@ -20,7 +20,7 @@ interface AudioPlayerProps {
  * 提供基本的音频播放功能
  * @param props - 组件属性
  */
-declare const _default$p: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$r: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /** Docx文档预览组件的属性接口 */
 interface DocxPreviewProps {
@@ -33,7 +33,7 @@ interface DocxPreviewProps {
  * Docx文档预览组件
  * @param props - 组件属性
  */
-declare const _default$o: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$q: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件图标组件属性接口
@@ -59,7 +59,7 @@ interface FileIconProps {
  * @param props - 组件属性
  * @returns 对应文件类型的图标
  */
-declare const _default$n: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
+declare const _default$p: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览组件属性接口
@@ -88,14 +88,14 @@ interface FilePreviewProps {
     /** 文件参数 */
     fileParams?: ObjectType<string>;
     /** 密码设置成功回调 */
-    onSetPassSuccess?: () => void;
+    onSetPassword?: () => void;
 }
 /**
  * 文件预览组件
  * 支持图片、PDF、视频、音频、Markdown等文件格式的预览
  * @param props - 组件属性
  */
-declare const _default$m: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$o: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览抽屉组件属性接口
@@ -125,7 +125,7 @@ interface FilePreviewDrawerProps extends FilePreviewProps {
  * @param props - 组件属性
  * @returns 文件预览抽屉组件
  */
-declare const _default$l: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$n: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown预览组件属性接口
@@ -141,7 +141,27 @@ interface MarkdownPreviewProps {
  * 从指定URL获取Markdown内容并渲染显示
  * @param props - 组件属性
  */
-declare const _default$k: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$m: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
+
+interface PdfImagePreviewProps {
+    /** PDF文件URL地址 */
+    fileUrl: string;
+    /** 当前页码 */
+    pageNo?: number;
+    /** 缩放比例，默认为1 */
+    scale?: number;
+    /** 是否显示缩略图，默认为true */
+    isHasThumbnails?: boolean;
+    /** 页码变化回调 */
+    onSetPageNo?: (pageNo: number) => void;
+}
+/**
+ * PDF图片预览组件 模仿pdf预览
+ * 支持虚拟滚动、缩放、缩略图导航等功能
+ * @param props - 组件属性
+ * 适用于大量PDF页面的高效展示
+ */
+declare const _default$l: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * PDF预览组件属性接口
@@ -167,8 +187,9 @@ interface PdfPreviewProps {
  * 基于react-pdf-viewer实现的PDF文件预览功能
  * 支持密码保护、缩略图、缩放、页面导航等功能
  * @param props - 组件属性
+ * TODO 放大缩小会丢失分页
  */
-declare const _default$j: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$k: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 视频播放器组件属性接口
@@ -182,7 +203,7 @@ interface VideoPlayerProps {
  * 提供基本的视频播放功能
  * @param props - 组件属性
  */
-declare const _default$i: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$j: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Iframe组件属性接口
@@ -204,7 +225,7 @@ interface IframeProps {
  * 支持加载状态、URL参数处理、防缓存等功能
  * @param props - 组件属性
  */
-declare const _default$h: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
+declare const _default$i: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
 
 /**
  * 组件映射类型，用于延时加载
@@ -220,6 +241,8 @@ interface LazyComponentProps {
     type: string;
     /** 自定义组件映射 */
     customComponents?: ComponentMapType;
+    /** 未知类型时显示的内容，默认为警告提示 */
+    unknownContent?: React.ReactNode;
     /** 其他属性会透传给组件 */
     [key: string]: any;
 }
@@ -229,7 +252,97 @@ interface LazyComponentProps {
  * 使用示例：<LazyComponent type="renderMarkdown" data={{}} loading={true} />
  * @param props - 组件属性
  */
-declare const _default$g: ({ type, customComponents, ...rest }: LazyComponentProps) => react_jsx_runtime.JSX.Element;
+declare const _default$h: ({ type, customComponents, unknownContent, ...rest }: LazyComponentProps) => string | number | true | react_jsx_runtime.JSX.Element | Iterable<react.ReactNode>;
+
+/**
+ * 批注功能配置
+ */
+interface AnnotationsProps {
+    /** 是否启用批注功能，默认为false */
+    enabled: boolean;
+    /** 当前用户 */
+    user: {
+        id: string;
+        name: string;
+    };
+    /** 是否显示批注列表，默认为true */
+    showList?: boolean;
+    /** 受控属性：批注列表是否可见 */
+    visible?: boolean;
+    /** 受控属性：批注列表可见性改变回调 */
+    onVisibleChange?: (visible: boolean) => void;
+}
+
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        annotation: {
+            selectAnnotation: (id: string) => any;
+            moveCursorToAnnotation: (id: string) => any;
+        };
+    }
+}
+
+/**
+ * 批注功能配置接口
+ */
+interface AnnotationConfig extends AnnotationsProps {
+    getContainer?: () => HTMLElement | null;
+}
+
+declare const COLLECTION_ATTRS: readonly ["collection-id", "user-name", "user-id", "update-time", "page-no"];
+type CollectionType = {
+    text: string;
+    from: number;
+    to: number;
+    pageNo?: string;
+} & {
+    [key in (typeof COLLECTION_ATTRS)[number]]: string;
+};
+/**
+ * 收录功能配置
+ */
+interface CollectionsProps {
+    /** 是否启用批注功能，默认为false */
+    enabled: boolean;
+    /** 当前用户 */
+    user: {
+        id: string;
+        name: string;
+    };
+    /** 是否显示收录列表，默认为true */
+    showList?: boolean;
+    /** 受控属性：批注列表是否可见 */
+    visible?: boolean;
+    /** 受控属性：批注列表可见性改变回调 */
+    onVisibleChange?: (visible: boolean) => void;
+    /**
+     * 创建收录的回调
+     * @param data 收录数据
+     * @returns 返回收录ID（如果有），返回Promise
+     */
+    onBeforeCreate?: (data: {
+        content: string;
+        pageNo?: number;
+    }) => Promise<string>;
+    /**
+     * 自定义渲染收录列表项
+     * @param props 列表项数据及操作
+     * @returns React节点
+     */
+    renderItem?: (props: {
+        collection: CollectionType;
+        isSelected: boolean;
+        onSelect: () => void;
+        onDelete: () => void;
+    }) => React.ReactNode;
+}
+
+/**
+ * 收录功能配置接口
+ */
+interface CollectionConfig extends CollectionsProps {
+    getContainer?: () => HTMLElement | null;
+}
 
 /**
  * Markdown编辑器组件属性接口
@@ -243,16 +356,24 @@ interface MarkdownEditorProps {
     value?: string;
     /** 内容变化回调 */
     onChange?: (value: string) => void;
-    /** 页面滚动回调 */
-    onScrollPage?: (pageIndex: number) => void;
     /** 额外导航内容 */
     extraNav?: ReactNode;
     /** 是否显示工具栏，默认为true */
     showToolbar?: boolean;
     /** 引用文本回调 */
-    onQuote?: (text: string) => void;
+    onQuote?: (text?: string, markdown?: string) => void;
     /** 文件下载回调 */
     onDownloadFile?: (fileContent: string, targetFormat?: string) => Promise<void>;
+    /** 批注功能配置对象 */
+    annotationConfig?: AnnotationConfig;
+    /** 收录功能专属配置，不与批注混淆 */
+    collectionConfig?: CollectionConfig;
+    pageNoConfig?: {
+        /** 是否启用分页功能，默认为false */
+        enabled: boolean;
+        /** 页面滚动回调 */
+        onScrollPage?: (pageIndex: number) => void;
+    };
 }
 /**
  * Markdown编辑器组件
@@ -260,7 +381,30 @@ interface MarkdownEditorProps {
  * 提供丰富的编辑功能：格式化、链接、图片、表格、高亮等
  * @param props - 组件属性
  */
-declare const _default$f: ({ value, onChange, onScrollPage, searchValue, disabled, extraNav, showToolbar, onQuote, onDownloadFile }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+declare const _default$g: ({ value, onChange, searchValue, disabled, extraNav, showToolbar, onQuote, onDownloadFile, annotationConfig, collectionConfig, pageNoConfig }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+
+interface Detection {
+    bbox: [number, number, number, number];
+    score: number;
+}
+interface SizeType {
+    width: number;
+    height: number;
+}
+interface MarkDrawingProps {
+    children: ReactNode;
+    detections: Detection[];
+    originalSize: SizeType;
+}
+/**
+ * MarkDrawing组件
+ * 在指定内容上绘制检测框，常用于图像标注、物体识别可视化等场景
+ * 根据原始尺寸和当前容器尺寸自动计算缩放比例，确保标注框准确显示
+ * @param children - 待绘制标注的内容
+ * @param detections - 检测结果数组
+ * @param originalSize - 原始尺寸信息
+ */
+declare const _default$f: ({ children, detections, originalSize }: MarkDrawingProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown渲染组件属性接口
@@ -777,7 +921,7 @@ declare const setInterval: (fn: () => void | Promise<void>, t: number) => {
  * const id = genNonDuplicateID()
  * console.log(id) // 输出类似: "f8c8e6d2-35a2-4f4d-9d53-994f2b6e1c2d"
  */
-declare const genNonDuplicateID: () => `${string}-${string}-${string}-${string}-${string}`;
+declare const genNonDuplicateID: () => string;
 /**
  * 复制文本到剪贴板
  *
@@ -1172,6 +1316,24 @@ declare const formatSize: (value: number | string, options?: FormatSizeOptions)
  * markdownToText('## 标题\n\n- 列表项1\n- 列表项2 <div>123</div>') // '标题 列表项1 列表项2 123'
  */
 declare const markdownToText: (markdown: string) => string;
+/**
+ * HTML 转 纯文本
+ * @param html - 原始 HTML 内容
+ * @returns 纯文本
+ * @description 使用 'html-to-text' 库进行转换，相比简单的正则替换，能更好地保留结构（如列表、表格等）。
+ * @example
+ * htmlToText('<div>标题</div><p>内容</p>') // '标题\n\n内容'
+ */
+declare const htmlToText: (html: string) => string;
+/**
+ * HTML 转 Markdown
+ * @param html - 原始 HTML 内容
+ * @returns Markdown 内容
+ * @description 使用 'turndown' 库进行转换。
+ * @example
+ * htmlToMarkdown('<h1>标题</h1><p>内容</p>') // '# 标题\n\n内容'
+ */
+declare const htmlToMarkdown: (html: string) => string;
 interface FindTreeNodesOptions {
     /** 树的id字段名，默认 "id" */
     id?: string;
@@ -2313,4 +2475,4 @@ declare function createTokenManager({ key, storage }: TokenManagerProps): {
     clear: () => void;
 };
 
-export { _default$p 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$o as DocxPreview, type DocxPreviewProps, _default$n as FileIcon, type FileIconProps, _default$m as FilePreview, _default$l as FilePreviewDrawer, type FilePreviewDrawerProps, type FilePreviewProps, type FindTreeNodesOptions, type FormatSizeOptions, HttpStatus, _default$h as Iframe, type IframeProps, _default$g as LazyComponent, type LazyComponentProps, _default$f as MarkdownEditor, type MarkdownEditorProps, _default$k as MarkdownPreview, type MarkdownPreviewProps, MultiEmailValidator, _default$j 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$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, 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 { _default$r 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$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 };

package/dist/index.d.ts

@@ -20,7 +20,7 @@ interface AudioPlayerProps {
  * 提供基本的音频播放功能
  * @param props - 组件属性
  */
-declare const _default$p: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$r: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /** Docx文档预览组件的属性接口 */
 interface DocxPreviewProps {
@@ -33,7 +33,7 @@ interface DocxPreviewProps {
  * Docx文档预览组件
  * @param props - 组件属性
  */
-declare const _default$o: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$q: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件图标组件属性接口
@@ -59,7 +59,7 @@ interface FileIconProps {
  * @param props - 组件属性
  * @returns 对应文件类型的图标
  */
-declare const _default$n: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
+declare const _default$p: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览组件属性接口
@@ -88,14 +88,14 @@ interface FilePreviewProps {
     /** 文件参数 */
     fileParams?: ObjectType<string>;
     /** 密码设置成功回调 */
-    onSetPassSuccess?: () => void;
+    onSetPassword?: () => void;
 }
 /**
  * 文件预览组件
  * 支持图片、PDF、视频、音频、Markdown等文件格式的预览
  * @param props - 组件属性
  */
-declare const _default$m: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$o: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览抽屉组件属性接口
@@ -125,7 +125,7 @@ interface FilePreviewDrawerProps extends FilePreviewProps {
  * @param props - 组件属性
  * @returns 文件预览抽屉组件
  */
-declare const _default$l: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$n: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown预览组件属性接口
@@ -141,7 +141,27 @@ interface MarkdownPreviewProps {
  * 从指定URL获取Markdown内容并渲染显示
  * @param props - 组件属性
  */
-declare const _default$k: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$m: ({ fileUrl, searchValue }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
+
+interface PdfImagePreviewProps {
+    /** PDF文件URL地址 */
+    fileUrl: string;
+    /** 当前页码 */
+    pageNo?: number;
+    /** 缩放比例，默认为1 */
+    scale?: number;
+    /** 是否显示缩略图，默认为true */
+    isHasThumbnails?: boolean;
+    /** 页码变化回调 */
+    onSetPageNo?: (pageNo: number) => void;
+}
+/**
+ * PDF图片预览组件 模仿pdf预览
+ * 支持虚拟滚动、缩放、缩略图导航等功能
+ * @param props - 组件属性
+ * 适用于大量PDF页面的高效展示
+ */
+declare const _default$l: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * PDF预览组件属性接口
@@ -167,8 +187,9 @@ interface PdfPreviewProps {
  * 基于react-pdf-viewer实现的PDF文件预览功能
  * 支持密码保护、缩略图、缩放、页面导航等功能
  * @param props - 组件属性
+ * TODO 放大缩小会丢失分页
  */
-declare const _default$j: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$k: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 视频播放器组件属性接口
@@ -182,7 +203,7 @@ interface VideoPlayerProps {
  * 提供基本的视频播放功能
  * @param props - 组件属性
  */
-declare const _default$i: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$j: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Iframe组件属性接口
@@ -204,7 +225,7 @@ interface IframeProps {
  * 支持加载状态、URL参数处理、防缓存等功能
  * @param props - 组件属性
  */
-declare const _default$h: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
+declare const _default$i: react.ForwardRefExoticComponent<IframeProps & react.RefAttributes<HTMLIFrameElement>>;
 
 /**
  * 组件映射类型，用于延时加载
@@ -220,6 +241,8 @@ interface LazyComponentProps {
     type: string;
     /** 自定义组件映射 */
     customComponents?: ComponentMapType;
+    /** 未知类型时显示的内容，默认为警告提示 */
+    unknownContent?: React.ReactNode;
     /** 其他属性会透传给组件 */
     [key: string]: any;
 }
@@ -229,7 +252,97 @@ interface LazyComponentProps {
  * 使用示例：<LazyComponent type="renderMarkdown" data={{}} loading={true} />
  * @param props - 组件属性
  */
-declare const _default$g: ({ type, customComponents, ...rest }: LazyComponentProps) => react_jsx_runtime.JSX.Element;
+declare const _default$h: ({ type, customComponents, unknownContent, ...rest }: LazyComponentProps) => string | number | true | react_jsx_runtime.JSX.Element | Iterable<react.ReactNode>;
+
+/**
+ * 批注功能配置
+ */
+interface AnnotationsProps {
+    /** 是否启用批注功能，默认为false */
+    enabled: boolean;
+    /** 当前用户 */
+    user: {
+        id: string;
+        name: string;
+    };
+    /** 是否显示批注列表，默认为true */
+    showList?: boolean;
+    /** 受控属性：批注列表是否可见 */
+    visible?: boolean;
+    /** 受控属性：批注列表可见性改变回调 */
+    onVisibleChange?: (visible: boolean) => void;
+}
+
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        annotation: {
+            selectAnnotation: (id: string) => any;
+            moveCursorToAnnotation: (id: string) => any;
+        };
+    }
+}
+
+/**
+ * 批注功能配置接口
+ */
+interface AnnotationConfig extends AnnotationsProps {
+    getContainer?: () => HTMLElement | null;
+}
+
+declare const COLLECTION_ATTRS: readonly ["collection-id", "user-name", "user-id", "update-time", "page-no"];
+type CollectionType = {
+    text: string;
+    from: number;
+    to: number;
+    pageNo?: string;
+} & {
+    [key in (typeof COLLECTION_ATTRS)[number]]: string;
+};
+/**
+ * 收录功能配置
+ */
+interface CollectionsProps {
+    /** 是否启用批注功能，默认为false */
+    enabled: boolean;
+    /** 当前用户 */
+    user: {
+        id: string;
+        name: string;
+    };
+    /** 是否显示收录列表，默认为true */
+    showList?: boolean;
+    /** 受控属性：批注列表是否可见 */
+    visible?: boolean;
+    /** 受控属性：批注列表可见性改变回调 */
+    onVisibleChange?: (visible: boolean) => void;
+    /**
+     * 创建收录的回调
+     * @param data 收录数据
+     * @returns 返回收录ID（如果有），返回Promise
+     */
+    onBeforeCreate?: (data: {
+        content: string;
+        pageNo?: number;
+    }) => Promise<string>;
+    /**
+     * 自定义渲染收录列表项
+     * @param props 列表项数据及操作
+     * @returns React节点
+     */
+    renderItem?: (props: {
+        collection: CollectionType;
+        isSelected: boolean;
+        onSelect: () => void;
+        onDelete: () => void;
+    }) => React.ReactNode;
+}
+
+/**
+ * 收录功能配置接口
+ */
+interface CollectionConfig extends CollectionsProps {
+    getContainer?: () => HTMLElement | null;
+}
 
 /**
  * Markdown编辑器组件属性接口
@@ -243,16 +356,24 @@ interface MarkdownEditorProps {
     value?: string;
     /** 内容变化回调 */
     onChange?: (value: string) => void;
-    /** 页面滚动回调 */
-    onScrollPage?: (pageIndex: number) => void;
     /** 额外导航内容 */
     extraNav?: ReactNode;
     /** 是否显示工具栏，默认为true */
     showToolbar?: boolean;
     /** 引用文本回调 */
-    onQuote?: (text: string) => void;
+    onQuote?: (text?: string, markdown?: string) => void;
     /** 文件下载回调 */
     onDownloadFile?: (fileContent: string, targetFormat?: string) => Promise<void>;
+    /** 批注功能配置对象 */
+    annotationConfig?: AnnotationConfig;
+    /** 收录功能专属配置，不与批注混淆 */
+    collectionConfig?: CollectionConfig;
+    pageNoConfig?: {
+        /** 是否启用分页功能，默认为false */
+        enabled: boolean;
+        /** 页面滚动回调 */
+        onScrollPage?: (pageIndex: number) => void;
+    };
 }
 /**
  * Markdown编辑器组件
@@ -260,7 +381,30 @@ interface MarkdownEditorProps {
  * 提供丰富的编辑功能：格式化、链接、图片、表格、高亮等
  * @param props - 组件属性
  */
-declare const _default$f: ({ value, onChange, onScrollPage, searchValue, disabled, extraNav, showToolbar, onQuote, onDownloadFile }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+declare const _default$g: ({ value, onChange, searchValue, disabled, extraNav, showToolbar, onQuote, onDownloadFile, annotationConfig, collectionConfig, pageNoConfig }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+
+interface Detection {
+    bbox: [number, number, number, number];
+    score: number;
+}
+interface SizeType {
+    width: number;
+    height: number;
+}
+interface MarkDrawingProps {
+    children: ReactNode;
+    detections: Detection[];
+    originalSize: SizeType;
+}
+/**
+ * MarkDrawing组件
+ * 在指定内容上绘制检测框，常用于图像标注、物体识别可视化等场景
+ * 根据原始尺寸和当前容器尺寸自动计算缩放比例，确保标注框准确显示
+ * @param children - 待绘制标注的内容
+ * @param detections - 检测结果数组
+ * @param originalSize - 原始尺寸信息
+ */
+declare const _default$f: ({ children, detections, originalSize }: MarkDrawingProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown渲染组件属性接口
@@ -777,7 +921,7 @@ declare const setInterval: (fn: () => void | Promise<void>, t: number) => {
  * const id = genNonDuplicateID()
  * console.log(id) // 输出类似: "f8c8e6d2-35a2-4f4d-9d53-994f2b6e1c2d"
  */
-declare const genNonDuplicateID: () => `${string}-${string}-${string}-${string}-${string}`;
+declare const genNonDuplicateID: () => string;
 /**
  * 复制文本到剪贴板
  *
@@ -1172,6 +1316,24 @@ declare const formatSize: (value: number | string, options?: FormatSizeOptions)
  * markdownToText('## 标题\n\n- 列表项1\n- 列表项2 <div>123</div>') // '标题 列表项1 列表项2 123'
  */
 declare const markdownToText: (markdown: string) => string;
+/**
+ * HTML 转 纯文本
+ * @param html - 原始 HTML 内容
+ * @returns 纯文本
+ * @description 使用 'html-to-text' 库进行转换，相比简单的正则替换，能更好地保留结构（如列表、表格等）。
+ * @example
+ * htmlToText('<div>标题</div><p>内容</p>') // '标题\n\n内容'
+ */
+declare const htmlToText: (html: string) => string;
+/**
+ * HTML 转 Markdown
+ * @param html - 原始 HTML 内容
+ * @returns Markdown 内容
+ * @description 使用 'turndown' 库进行转换。
+ * @example
+ * htmlToMarkdown('<h1>标题</h1><p>内容</p>') // '# 标题\n\n内容'
+ */
+declare const htmlToMarkdown: (html: string) => string;
 interface FindTreeNodesOptions {
     /** 树的id字段名，默认 "id" */
     id?: string;
@@ -2313,4 +2475,4 @@ declare function createTokenManager({ key, storage }: TokenManagerProps): {
     clear: () => void;
 };
 
-export { _default$p 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$o as DocxPreview, type DocxPreviewProps, _default$n as FileIcon, type FileIconProps, _default$m as FilePreview, _default$l as FilePreviewDrawer, type FilePreviewDrawerProps, type FilePreviewProps, type FindTreeNodesOptions, type FormatSizeOptions, HttpStatus, _default$h as Iframe, type IframeProps, _default$g as LazyComponent, type LazyComponentProps, _default$f as MarkdownEditor, type MarkdownEditorProps, _default$k as MarkdownPreview, type MarkdownPreviewProps, MultiEmailValidator, _default$j 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$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, 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 { _default$r 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$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 };