@zero-library/common 2.4.4 → 3.0.0

package/dist/index.d.mts

@@ -2,6 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { EmptyProps } from 'antd';
 import * as react from 'react';
 import { ReactNode } from 'react';
+import { Editor, FocusPosition, Content, InsertContentOptions, InsertContentAtOptions } from '@tiptap/core';
 import dayjs from 'dayjs';
 import Decimal from 'decimal.js';
 import { RuleObject } from 'antd/es/form';
@@ -20,7 +21,7 @@ interface AudioPlayerProps {
  * 提供基本的音频播放功能
  * @param props - 组件属性
  */
-declare const _default$q: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$t: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /** Docx文档预览组件的属性接口 */
 interface DocxPreviewProps {
@@ -33,7 +34,7 @@ interface DocxPreviewProps {
  * Docx文档预览组件
  * @param props - 组件属性
  */
-declare const _default$p: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$s: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件图标组件属性接口
@@ -59,7 +60,7 @@ interface FileIconProps {
  * @param props - 组件属性
  * @returns 对应文件类型的图标
  */
-declare const _default$o: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
+declare const _default$r: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览组件属性接口
@@ -93,7 +94,7 @@ interface FilePreviewProps {
  * 支持图片、PDF、视频、音频、Markdown等文件格式的预览
  * @param props - 组件属性
  */
-declare const _default$n: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$q: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览抽屉组件属性接口
@@ -123,7 +124,7 @@ interface FilePreviewDrawerProps extends FilePreviewProps {
  * @param props - 组件属性
  * @returns 文件预览抽屉组件
  */
-declare const _default$m: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$p: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown | txt 预览组件属性接口
@@ -141,7 +142,7 @@ interface MarkdownPreviewProps {
  * 从指定URL获取Markdown或txt内容并渲染显示
  * @param props - 组件属性
  */
-declare const _default$l: ({ fileUrl, searchValue, asPlainText }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$o: ({ fileUrl, searchValue, asPlainText }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
 
 interface PdfImagePreviewProps {
     /** PDF文件URL地址 */
@@ -161,7 +162,7 @@ interface PdfImagePreviewProps {
  * @param props - 组件属性
  * 适用于大量PDF页面的高效展示
  */
-declare const _default$k: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$n: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * PDF预览组件属性接口
@@ -189,7 +190,7 @@ interface PdfPreviewProps {
  * @param props - 组件属性
  * TODO 放大缩小会丢失分页
  */
-declare const _default$j: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$m: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 视频播放器组件属性接口
@@ -203,7 +204,48 @@ interface VideoPlayerProps {
  * 提供基本的视频播放功能
  * @param props - 组件属性
  */
-declare const _default$i: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$l: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
+
+interface MicroAppProps {
+    /** 应用名称（micro-app 必须唯一） */
+    name: string;
+    /** 应用地址 */
+    url: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 加载完成 */
+    onMounted?: () => void;
+    /** 加载出错 */
+    onError?: (e?: any) => void;
+    /** 传递给子应用的数据 */
+    data?: Record<string, any>;
+    /** 其他 micro-app 支持的属性 (如 keep-alive, destroy 等) */
+    [key: string]: any;
+}
+/**
+ * MicroApp 封装组件（类 iframe）
+ */
+declare const _default$k: ({ name, url, className, onMounted, onError, data, ...rest }: MicroAppProps) => react_jsx_runtime.JSX.Element;
+
+interface Props$1 {
+    name: string;
+}
+interface PodOpenProps {
+    name?: string;
+    title: string | false;
+    url: string;
+}
+declare const _default$j: ({ name: podName }: Props$1) => react_jsx_runtime.JSX.Element;
+
+interface Props {
+    defaultUrl: string;
+    name: string;
+}
+interface WindowOpenProps {
+    name?: string;
+    url: string;
+}
+declare const _default$i: ({ defaultUrl, name: appName }: Props) => react_jsx_runtime.JSX.Element;
 
 /**
  * Iframe组件属性接口
@@ -395,13 +437,44 @@ interface MarkdownEditorProps {
     collectionConfig?: CollectionConfig;
     pageNoConfig?: PageNoConfig;
 }
+/**
+ * MarkdownEditor 暴露给父组件的实例方法集合
+ * 通常通过 ref 获取，用于访问底层编辑器实例或进行插入/聚焦等操作
+ */
+interface MarkdownEditorHandle {
+    /** 获取底层 Tiptap Editor 实例 */
+    getEditor: () => Editor;
+    /** 获取当前编辑器的 Markdown 文本 */
+    getMarkdown: () => string;
+    /**
+     * 聚焦编辑器
+     * @param pos - 可选的聚焦位置
+     */
+    focus: (pos?: FocusPosition) => void;
+    /**
+     * 在当前光标位置插入内容
+     * @param value - 待插入的内容
+     * @param options - 插入选项
+     */
+    insertContent: (value: Content, options?: InsertContentOptions) => void;
+    /**
+     * 在指定位置范围内插入内容
+     * @param position - 插入位置；number 表示单点位置，{from,to} 表示范围
+     * @param value - 待插入的内容
+     * @param options - 插入选项
+     */
+    insertContentAt: (position: number | {
+        from: number;
+        to: number;
+    }, value: Content, options?: InsertContentAtOptions) => void;
+}
 /**
  * Markdown编辑器组件
  * 基于Tiptap构建的富文本编辑器，支持Markdown语法
  * 提供丰富的编辑功能：格式化、链接、图片、表格、高亮等
  * @param props - 组件属性
  */
-declare const _default$f: ({ value, onChange, searchValue, disabled, extraNav, fixedToolbar, floatToolbar, onQuote, onDownloadFile, annotationConfig, collectionConfig, pageNoConfig }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+declare const _default$f: react.ForwardRefExoticComponent<MarkdownEditorProps & react.RefAttributes<MarkdownEditorHandle>>;
 
 interface Detection {
     bbox: [number, number, number, number];
@@ -543,12 +616,20 @@ declare const _default$b: ({ size, avatarSrc, userName }: UserAvatarProps) => re
  */
 type Params = Record<string, any>;
 /**
- * 向父页面或顶级窗口发送消息
+ * iframe 消息目标类型
+ * 定义跨iframe通信时的消息目标方向
+ */
+type ToType = 'parent' | 'top' | 'nearest' | 'broadcast' | 'sibling';
+/**
+ * 向父页面、顶级窗口或同级窗口发送消息
  * @param type - 消息类型
  * @param data - 消息数据
- * @param to - 发送目标，默认为'top'
+ * @param to - 发送目标，默认为'top'。
+ *             'nearest'表示最近的监听者，
+ *             'broadcast'表示向上广播给所有监听者，
+ *             'sibling'表示通知当前窗口内的其他组件(不跨iframe)。
  */
-declare function emit(type: string, data?: Params, to?: 'parent' | 'top'): void;
+declare function emit(type: string, data?: Params, to?: ToType): void;
 /**
  * 向子iframe发送消息
  * @param iframeWindow - 目标iframe的contentWindow
@@ -750,16 +831,9 @@ declare const _default$1: <A extends Array<any>, R = void>(func: (..._args: A) =
     cancel: () => void;
 };
 
-/**
- * useWebSocket Hook 参数类型定义
- */
-interface WebSocketProps {
+interface WebSocketManagerOptions {
     /** WebSocket 服务器地址 */
     url: string;
-    /** 接收到消息时的回调函数 */
-    onMessage: (message: any) => void;
-    /** 连接关闭时的回调函数（可选） */
-    onClose?: () => void;
     /** 心跳间隔时间，单位毫秒，默认 30000ms */
     heartbeatInterval?: number;
     /** 心跳消息内容，默认 'ping' */
@@ -773,6 +847,16 @@ interface WebSocketProps {
     /** 是否开启重连机制，默认 true */
     isReconnect?: boolean;
 }
+
+/**
+ * useWebSocket Hook 参数类型定义
+ */
+interface WebSocketProps extends WebSocketManagerOptions {
+    /** 接收到消息时的回调函数 */
+    onMessage: (message: any) => void;
+    /** 连接关闭时的回调函数（可选） */
+    onClose?: () => void;
+}
 /**
  * useWebSocket Hook 返回值类型定义
  */
@@ -791,6 +875,14 @@ interface WebSocketType {
  * - 页面可见性监听
  * - 连接状态管理
  * - 消息发送与接收
+ * - 多组件共享连接（相同 url 多次调用只会创建一个连接）
+ *
+ * 使用说明：
+ * - 相同 `url` 的多个组件会复用同一个 `WebSocketManager` 和底层连接
+ * - 断线重连时会重新创建底层 `WebSocket`，但已注册的组件监听器会继续保留
+ * - `onMessage` 和 `onClose` 通过 `ref` 持有最新引用，组件重渲染后无需重新建立连接
+ * - 当前 Hook 仅在 `url` 变化时重新订阅；同一 `url` 下修改心跳、重连等配置不会立即更新已存在的管理器实例
+ * - 组件卸载或 `url` 变化时会移除当前监听器；当某个 `url` 没有任何订阅者后，连接会在短暂缓冲后销毁
  *
  * @example
  * ```tsx
@@ -2503,4 +2595,4 @@ declare function createTokenManager({ key, storage }: TokenManagerProps): {
     clear: () => void;
 };
 
-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, type PageNoConfig, _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 };
+export { type AnnotationConfig, type AnnotationType, _default$t 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$s as DocxPreview, type DocxPreviewProps, _default$r as FileIcon, type FileIconProps, _default$q as FilePreview, _default$p 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 MarkdownEditorHandle, type MarkdownEditorProps, _default$o as MarkdownPreview, type MarkdownPreviewProps, _default$k as MicroApp, _default$j as MicroAppDrawer, type MicroAppProps, _default$i as MicroAppWindow, MultiEmailValidator, type PageNoConfig, _default$n as PdfImagePreview, type PdfImagePreviewProps, _default$m as PdfPreview, type PdfPreviewProps, PhoneOrMobileValidator, type PodOpenProps, 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$l as VideoPlayer, type VideoPlayerProps, type WebSocketProps, type WebSocketType, type WindowOpenProps, 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

@@ -2,6 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { EmptyProps } from 'antd';
 import * as react from 'react';
 import { ReactNode } from 'react';
+import { Editor, FocusPosition, Content, InsertContentOptions, InsertContentAtOptions } from '@tiptap/core';
 import dayjs from 'dayjs';
 import Decimal from 'decimal.js';
 import { RuleObject } from 'antd/es/form';
@@ -20,7 +21,7 @@ interface AudioPlayerProps {
  * 提供基本的音频播放功能
  * @param props - 组件属性
  */
-declare const _default$q: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$t: ({ fileUrl }: AudioPlayerProps) => react_jsx_runtime.JSX.Element;
 
 /** Docx文档预览组件的属性接口 */
 interface DocxPreviewProps {
@@ -33,7 +34,7 @@ interface DocxPreviewProps {
  * Docx文档预览组件
  * @param props - 组件属性
  */
-declare const _default$p: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$s: ({ fileUrl, scale }: DocxPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件图标组件属性接口
@@ -59,7 +60,7 @@ interface FileIconProps {
  * @param props - 组件属性
  * @returns 对应文件类型的图标
  */
-declare const _default$o: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
+declare const _default$r: ({ suffix, fontSize }: FileIconProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览组件属性接口
@@ -93,7 +94,7 @@ interface FilePreviewProps {
  * 支持图片、PDF、视频、音频、Markdown等文件格式的预览
  * @param props - 组件属性
  */
-declare const _default$n: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$q: ({ suffix, fileUrl, pdfParams, password, searchValue, emptyProps, onSetPassword }: FilePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 文件预览抽屉组件属性接口
@@ -123,7 +124,7 @@ interface FilePreviewDrawerProps extends FilePreviewProps {
  * @param props - 组件属性
  * @returns 文件预览抽屉组件
  */
-declare const _default$m: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$p: ({ open, title, onClose, ...props }: FilePreviewDrawerProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Markdown | txt 预览组件属性接口
@@ -141,7 +142,7 @@ interface MarkdownPreviewProps {
  * 从指定URL获取Markdown或txt内容并渲染显示
  * @param props - 组件属性
  */
-declare const _default$l: ({ fileUrl, searchValue, asPlainText }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$o: ({ fileUrl, searchValue, asPlainText }: MarkdownPreviewProps) => react_jsx_runtime.JSX.Element;
 
 interface PdfImagePreviewProps {
     /** PDF文件URL地址 */
@@ -161,7 +162,7 @@ interface PdfImagePreviewProps {
  * @param props - 组件属性
  * 适用于大量PDF页面的高效展示
  */
-declare const _default$k: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$n: ({ fileUrl, pageNo, scale, isHasThumbnails, onSetPageNo }: PdfImagePreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * PDF预览组件属性接口
@@ -189,7 +190,7 @@ interface PdfPreviewProps {
  * @param props - 组件属性
  * TODO 放大缩小会丢失分页
  */
-declare const _default$j: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
+declare const _default$m: ({ password, fileUrl, pageNo, scale, isHasThumbnails, onSetPassword, onSetPageNo }: PdfPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * 视频播放器组件属性接口
@@ -203,7 +204,48 @@ interface VideoPlayerProps {
  * 提供基本的视频播放功能
  * @param props - 组件属性
  */
-declare const _default$i: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
+declare const _default$l: ({ fileUrl }: VideoPlayerProps) => react_jsx_runtime.JSX.Element;
+
+interface MicroAppProps {
+    /** 应用名称（micro-app 必须唯一） */
+    name: string;
+    /** 应用地址 */
+    url: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 加载完成 */
+    onMounted?: () => void;
+    /** 加载出错 */
+    onError?: (e?: any) => void;
+    /** 传递给子应用的数据 */
+    data?: Record<string, any>;
+    /** 其他 micro-app 支持的属性 (如 keep-alive, destroy 等) */
+    [key: string]: any;
+}
+/**
+ * MicroApp 封装组件（类 iframe）
+ */
+declare const _default$k: ({ name, url, className, onMounted, onError, data, ...rest }: MicroAppProps) => react_jsx_runtime.JSX.Element;
+
+interface Props$1 {
+    name: string;
+}
+interface PodOpenProps {
+    name?: string;
+    title: string | false;
+    url: string;
+}
+declare const _default$j: ({ name: podName }: Props$1) => react_jsx_runtime.JSX.Element;
+
+interface Props {
+    defaultUrl: string;
+    name: string;
+}
+interface WindowOpenProps {
+    name?: string;
+    url: string;
+}
+declare const _default$i: ({ defaultUrl, name: appName }: Props) => react_jsx_runtime.JSX.Element;
 
 /**
  * Iframe组件属性接口
@@ -395,13 +437,44 @@ interface MarkdownEditorProps {
     collectionConfig?: CollectionConfig;
     pageNoConfig?: PageNoConfig;
 }
+/**
+ * MarkdownEditor 暴露给父组件的实例方法集合
+ * 通常通过 ref 获取，用于访问底层编辑器实例或进行插入/聚焦等操作
+ */
+interface MarkdownEditorHandle {
+    /** 获取底层 Tiptap Editor 实例 */
+    getEditor: () => Editor;
+    /** 获取当前编辑器的 Markdown 文本 */
+    getMarkdown: () => string;
+    /**
+     * 聚焦编辑器
+     * @param pos - 可选的聚焦位置
+     */
+    focus: (pos?: FocusPosition) => void;
+    /**
+     * 在当前光标位置插入内容
+     * @param value - 待插入的内容
+     * @param options - 插入选项
+     */
+    insertContent: (value: Content, options?: InsertContentOptions) => void;
+    /**
+     * 在指定位置范围内插入内容
+     * @param position - 插入位置；number 表示单点位置，{from,to} 表示范围
+     * @param value - 待插入的内容
+     * @param options - 插入选项
+     */
+    insertContentAt: (position: number | {
+        from: number;
+        to: number;
+    }, value: Content, options?: InsertContentAtOptions) => void;
+}
 /**
  * Markdown编辑器组件
  * 基于Tiptap构建的富文本编辑器，支持Markdown语法
  * 提供丰富的编辑功能：格式化、链接、图片、表格、高亮等
  * @param props - 组件属性
  */
-declare const _default$f: ({ value, onChange, searchValue, disabled, extraNav, fixedToolbar, floatToolbar, onQuote, onDownloadFile, annotationConfig, collectionConfig, pageNoConfig }: MarkdownEditorProps) => react_jsx_runtime.JSX.Element;
+declare const _default$f: react.ForwardRefExoticComponent<MarkdownEditorProps & react.RefAttributes<MarkdownEditorHandle>>;
 
 interface Detection {
     bbox: [number, number, number, number];
@@ -543,12 +616,20 @@ declare const _default$b: ({ size, avatarSrc, userName }: UserAvatarProps) => re
  */
 type Params = Record<string, any>;
 /**
- * 向父页面或顶级窗口发送消息
+ * iframe 消息目标类型
+ * 定义跨iframe通信时的消息目标方向
+ */
+type ToType = 'parent' | 'top' | 'nearest' | 'broadcast' | 'sibling';
+/**
+ * 向父页面、顶级窗口或同级窗口发送消息
  * @param type - 消息类型
  * @param data - 消息数据
- * @param to - 发送目标，默认为'top'
+ * @param to - 发送目标，默认为'top'。
+ *             'nearest'表示最近的监听者，
+ *             'broadcast'表示向上广播给所有监听者，
+ *             'sibling'表示通知当前窗口内的其他组件(不跨iframe)。
  */
-declare function emit(type: string, data?: Params, to?: 'parent' | 'top'): void;
+declare function emit(type: string, data?: Params, to?: ToType): void;
 /**
  * 向子iframe发送消息
  * @param iframeWindow - 目标iframe的contentWindow
@@ -750,16 +831,9 @@ declare const _default$1: <A extends Array<any>, R = void>(func: (..._args: A) =
     cancel: () => void;
 };
 
-/**
- * useWebSocket Hook 参数类型定义
- */
-interface WebSocketProps {
+interface WebSocketManagerOptions {
     /** WebSocket 服务器地址 */
     url: string;
-    /** 接收到消息时的回调函数 */
-    onMessage: (message: any) => void;
-    /** 连接关闭时的回调函数（可选） */
-    onClose?: () => void;
     /** 心跳间隔时间，单位毫秒，默认 30000ms */
     heartbeatInterval?: number;
     /** 心跳消息内容，默认 'ping' */
@@ -773,6 +847,16 @@ interface WebSocketProps {
     /** 是否开启重连机制，默认 true */
     isReconnect?: boolean;
 }
+
+/**
+ * useWebSocket Hook 参数类型定义
+ */
+interface WebSocketProps extends WebSocketManagerOptions {
+    /** 接收到消息时的回调函数 */
+    onMessage: (message: any) => void;
+    /** 连接关闭时的回调函数（可选） */
+    onClose?: () => void;
+}
 /**
  * useWebSocket Hook 返回值类型定义
  */
@@ -791,6 +875,14 @@ interface WebSocketType {
  * - 页面可见性监听
  * - 连接状态管理
  * - 消息发送与接收
+ * - 多组件共享连接（相同 url 多次调用只会创建一个连接）
+ *
+ * 使用说明：
+ * - 相同 `url` 的多个组件会复用同一个 `WebSocketManager` 和底层连接
+ * - 断线重连时会重新创建底层 `WebSocket`，但已注册的组件监听器会继续保留
+ * - `onMessage` 和 `onClose` 通过 `ref` 持有最新引用，组件重渲染后无需重新建立连接
+ * - 当前 Hook 仅在 `url` 变化时重新订阅；同一 `url` 下修改心跳、重连等配置不会立即更新已存在的管理器实例
+ * - 组件卸载或 `url` 变化时会移除当前监听器；当某个 `url` 没有任何订阅者后，连接会在短暂缓冲后销毁
  *
  * @example
  * ```tsx
@@ -2503,4 +2595,4 @@ declare function createTokenManager({ key, storage }: TokenManagerProps): {
     clear: () => void;
 };
 
-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, type PageNoConfig, _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 };
+export { type AnnotationConfig, type AnnotationType, _default$t 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$s as DocxPreview, type DocxPreviewProps, _default$r as FileIcon, type FileIconProps, _default$q as FilePreview, _default$p 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 MarkdownEditorHandle, type MarkdownEditorProps, _default$o as MarkdownPreview, type MarkdownPreviewProps, _default$k as MicroApp, _default$j as MicroAppDrawer, type MicroAppProps, _default$i as MicroAppWindow, MultiEmailValidator, type PageNoConfig, _default$n as PdfImagePreview, type PdfImagePreviewProps, _default$m as PdfPreview, type PdfPreviewProps, PhoneOrMobileValidator, type PodOpenProps, 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$l as VideoPlayer, type VideoPlayerProps, type WebSocketProps, type WebSocketType, type WindowOpenProps, 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 };