@officesdk/editor-sdk-core 0.0.0-2 → 0.0.0-20

package/sheet.d.ts

@@ -1,1370 +0,0 @@
-export declare abstract class AbstractedSheetSDK extends EditorSDK {
-    /**
-     * 打印文档
-     */
-    abstract print(): Promise<void>;
-    /**
-     * 工作簿接口
-     */
-    abstract get workbook(): SheetWorkbook;
-    /**
-     * 当前活跃工作表对象
-     */
-    abstract get activeSheet(): SheetWorksheet;
-    /**
-     * 当前活动单元格
-     */
-    abstract get activeCell(): SheetCell | null;
-    /**
-     * 获取当前选区
-     */
-    abstract get selections(): SheetSelection[] | null;
-    /**
-     * 文本格式接口
-     */
-    abstract get text(): SheetText;
-}
-
-/**
- * 编辑器内部资源请求配置
- */
-declare interface EditorAssetsOptions {
-    /**
-     * 通用资源请求代理配置，
-     * 用于套件内部资源请求时代理请求
-     */
-    proxy: HTTPProxy;
-    /**
-     * 资源文件 URL 转换和解析
-     */
-    resolver: EditorAssetsResolver;
-    /**
-     * 图片处理器
-     */
-    imageProcessing: EditorAssetsOssImageProcessing;
-}
-
-/**
- * 基于对象存储的图片处理抽象
- */
-declare interface EditorAssetsOssImageProcessing {
-    /**
-     * 压缩图片的方法
-     * @param imageUrl 图片的 URL
-     * @param compressOptions 压缩配置，例如质量、最大宽度和最大高度
-     * @returns 压缩后的图片 URL
-     */
-    compress: (imageUrl: string, compressOptions?: {
-        quality?: number;
-        maxWidth?: number;
-        maxHeight?: number;
-    }) => Promise<string>;
-    /**
-     * 裁切图片的方法
-     * @param imageUrl 图片的 URL
-     * @param cropOptions 裁切配置，例如宽度、高度和起始点
-     * @returns 裁切后的图片 URL
-     */
-    crop: (imageUrl: string, cropOptions: {
-        x?: number;
-        y?: number;
-        w: number;
-        h: number;
-        g?: EditorImageCropPoint;
-    }) => Promise<string>;
-}
-
-declare interface EditorAssetsResolver {
-    /**
-     * 将资源文件 ID 转换为 URL 的方法
-     * @param assetId 资源文件 ID
-     * @returns 转换后的资源 URL ，如果无法转换则返回 null
-     */
-    resolveUrl: (assetId: string) => Promise<string | null>;
-    /**
-     * 从 URL 中解析资源文件 ID 的方法
-     * @param url 资源 URL
-     * @returns 解析出的资源文件 ID
-     */
-    parseId: (url: string) => Promise<string | null>;
-    /**
-     * 检查资源文件 ID 对应的文件是否准备就绪，
-     * 在部分环境中，资源文件需要异步导入，在编辑器加载的时候可能还未准备就绪
-     * @param assetId 资源文件 ID
-     * @returns
-     */
-    checkAssetReady: (assetId: string) => Promise<boolean> | boolean;
-}
-
-/**
- * 品牌相关设置，
- * 用于在套件中展示品牌外露信息
- */
-declare interface EditorBrandOptions {
-    /**
-     * 需要显示在品牌展示位的内容，按数组顺序显示
-     */
-    content: Array<{
-        type: 'image';
-        src: string;
-    } | {
-        type: 'text';
-        content: string;
-        color?: string;
-    }>;
-    /**
-     * 品牌展示位的布局信息
-     */
-    layout: {
-        width: string;
-        height: string;
-    };
-}
-
-/**
- * 单条评论数据
- */
-declare interface EditorCommentItem {
-    /**
-     * 评论 ID
-     */
-    id: string;
-    /**
-     * 评论用户信息
-     */
-    user: {
-        id: string;
-        name: string;
-    };
-    content: {
-        text: string;
-    };
-}
-
-declare interface EditorComments {
-    /**
-     * 检查是否有评论
-     * @returns
-     */
-    hasAny: () => Promise<boolean>;
-    /**
-     * 获取评论列表
-     * @returns
-     */
-    getAll: () => Promise<EditorCommentItem[]>;
-    /**
-     * 获取单个评论
-     * @param commentId
-     * @returns
-     */
-    getOne: (commentId: string) => Promise<EditorCommentItem | null>;
-    /**
-     * 添加内容
-     * @param options
-     * @returns
-     */
-    add: (options: {
-        /**
-         * 评论内容
-         */
-        text: string;
-        /**
-         * 默认评论是添加到当前选区上，也可以指定一个区域
-         */
-        range?: string;
-    }) => Promise<string | null>;
-    /**
-     * 删除所有评论
-     * @returns
-     */
-    deleteAll: () => Promise<boolean>;
-    /**
-     * 删除单条评论
-     */
-    deleteOne: (commentId: string) => Promise<boolean>;
-}
-
-/**
- * 编辑器评论初始化配置
- */
-declare interface EditorCommentsOptions {
-    /**
-     * 评论作者信息，如果这里的信息为空，将会使用 user 信息
-     */
-    author?: {
-        /**
-         * 评论作者 ID
-         */
-        id: string;
-        /**
-         * 评论作者信息
-         */
-        name: string;
-        /**
-         * 评论作者头像
-         */
-        avatar?: string;
-    };
-    /**
-     * 显示的视图配置
-     */
-    view?: {
-        /**
-         * 评论显示模式，
-         * none: 不显示评论，默认值。
-         * card: 评论以卡片形式显示。
-         */
-        mode: 'none' | 'card';
-    };
-}
-
-declare interface EditorContent {
-    /**
-     * 设置编辑器内容
-     * @param content
-     */
-    setContent: (content: string | ArrayBuffer) => Promise<void>;
-    /**
-     * 获取编辑器内容
-     */
-    getContent: () => Promise<EditorDelta>;
-    /**
-     * 添加监听，当内容发生变化时触发监听，传入 Delta
-     * @param listener
-     */
-    addChangeListener: (listener: (change: EditorDelta) => void) => () => void;
-}
-
-declare interface EditorDelta {
-    compose: (other: EditorDelta, isDocument?: boolean) => EditorDelta;
-    transform: (other: EditorDelta, priority?: boolean) => EditorDelta;
-    stringify: () => string;
-    length: number;
-}
-
-/**
- * 编辑器嵌入对象
- */
-declare interface EditorEmbeddedObject {
-    /**
-     * 嵌入的对象 url
-     */
-    url: string;
-    /**
-     * 嵌入对象的类型描述
-     */
-    type?: string;
-    /**
-     * 嵌入对象的名
-     */
-    name?: string;
-}
-
-/**
- * 编辑器嵌入对象抽象类
- */
-declare interface EditorEmbeddedObjectOptions {
-    /**
-     * 执行打开嵌入对象操作，
-     * 如果已经处理了打开操作，返回 true，否则返回 false，
-     * 如果返回 false，编辑器会继续后续默认的打开操作。
-     * @param object
-     * @returns
-     */
-    open: (object: EditorEmbeddedObject) => Promise<boolean>;
-    /**
-     * 嵌入对象的页面功能
-     */
-    ui?: {
-        /**
-         * 预览功能
-         */
-        preview?: {
-            disabled?: boolean;
-        };
-        /**
-         * 下载功能
-         */
-        download?: {
-            disabled?: boolean;
-        };
-    };
-}
-
-declare interface EditorFontFace {
-    /**
-     * 字体的名称，用于在用户界面上显示的名称
-     */
-    name: string;
-    /**
-     * 字体族
-     */
-    family: string;
-    /**
-     * 用于加载字体的 URL
-     */
-    url?: string;
-    /**
-     * 是否为受版权保护的字体，如果是在用户界面上会有所标识。
-     */
-    isCopyrightProtected: boolean;
-    /**
-     * 字体元数据
-     */
-    meta: EditorFontMeta;
-}
-
-/**
- * 字体元数据
- */
-declare interface EditorFontMeta {
-    head: {
-        unitsPerEm: number;
-    };
-    hhea: {
-        ascender: number;
-        descender: number;
-        lineGap: number;
-    };
-    vhea?: {
-        ascender: number;
-        descender: number;
-        lineGap: number;
-    };
-    os2: {
-        usWeightClass?: number;
-        usWidthClass?: number;
-        italic?: boolean;
-        isSymbol?: boolean;
-        ulCodePageRange: [number, number];
-    };
-    /**
-     * opentype中没有强制要求必须有en条目，只能确定name下的value的类型是对象
-     */
-    name: {
-        preferredFamily?: Record<string, string>;
-        preferredSubfamily?: Record<string, string>;
-        fontFamily?: Record<string, string>;
-        fontSubfamily?: Record<string, string>;
-        fullName?: Record<string, string>;
-        postScriptName?: Record<string, string>;
-    };
-}
-
-/**
- * 字体列表
- */
-declare interface EditorFontsList {
-    /**
-     * 返回解析为字体的列表的 Promise。
-     */
-    getAll: () => Promise<EditorFontFace[]>;
-}
-
-declare interface EditorFontsOptions {
-    /**
-     * 服务器字体列表，用于获取服务器端配置的字体列表，
-     * 并提供可用于字体的加载 URL 和字体元数据。
-     */
-    list: EditorFontsList;
-}
-
-/**
- * i18n 相关设置
- */
-declare interface EditorI18nOptions {
-    /**
-     * 语言，默认使用浏览器当前环境中的语言
-     */
-    language?: string;
-    /**
-     * 文本方向，默认根据语言自动适配
-     */
-    direction?: 'ltr' | 'rtl';
-}
-
-declare type EditorImageCropPoint = 'nw' | 'north' | 'ne' | 'west' | 'center' | 'east' | 'sw' | 'south' | 'se';
-
-/**
- * 链接配置，抽象打开链接等操作
- */
-declare interface EditorLinkOptions {
-    /**
-     * 打开链接，如果取消了打开链接操作，返回 false
-     * @param url
-     * @param target
-     * @returns
-     */
-    open: (url: string, target: string) => Promise<boolean>;
-}
-
-/**
- * 菜单栏自定义按钮配置
- */
-declare type EditorMenuCustomButton = {
-    /**
-     * 按钮名称
-     */
-    name: string;
-    /**
-     * 链接
-     */
-    type: 'link';
-    /**
-     * 按钮文本
-     */
-    text: string;
-    /**
-     * 链接地址
-     */
-    url: string;
-} | {
-    /**
-     * 按钮名称
-     */
-    name: string;
-    /**
-     * 按钮，点击后触发 callback 回调
-     */
-    type: 'button';
-    /**
-     * 按钮文本
-     */
-    label: string;
-    /**
-     * 按钮图标，可以是 base64 的图片信息，也可以是图片 url
-     */
-    icon?: string;
-    /**
-     * 按钮点击事件
-     */
-    callback: () => void;
-};
-
-/**
- * 菜单栏二级以下的菜单入口
- */
-declare interface EditorMenuEntryButton {
-    type: 'entry';
-    /**
-     * 菜单名称
-     */
-    name: string;
-    /**
-     * 菜单图标
-     */
-    icon?: string;
-}
-
-/**
- * 菜单栏一级菜单配置，此处用于定义一级菜单的操作入口，
- * 一级菜单在鼠标悬停时展示二级列表
- */
-declare interface EditorMenuEntryConfig<TName extends string> {
-    /**
-     * 一级菜单名称
-     */
-    name: string;
-    /**
-     * 二级菜单定义，定一个二维数组，用于定义二级菜单的结构，
-     * 将第一层数组中的所有按钮放到一个区域内用分隔符隔开，
-     * 第二层数组为按钮的定义，可以是功能按钮也可以是一个下拉入口。
-     */
-    children: Array<EditorMenuFeatureButton<TName> | EditorMenuEntryButton>[];
-}
-
-/**
- * 菜单栏功能按钮配置
- */
-declare type EditorMenuFeatureButton<TName extends string> = {
-    /**
-     * 隐藏按钮，用作在需要隐藏菜单栏时定义
-     */
-    type: 'hidden';
-    /**
-     * 按钮名称
-     */
-    name: TName;
-} | {
-    type: 'button';
-    /**
-     * 按钮名称
-     */
-    name: TName;
-    /**
-     * 按钮标签（显示文本）
-     */
-    label: string;
-    /**
-     * 按钮图标，可以是 base64 的图片信息，也可以是图片 url
-     */
-    icon?: string;
-};
-
-/**
- * 菜单栏按钮配置
- */
-declare type EditorMenuFeatureButtonConfig<TName extends string> = Record<TName, EditorMenuFeatureButton<TName>>;
-
-/**
- * 菜单栏相关配置，目前菜单栏不是所有套件都支持，
- * 菜单栏是指的编辑器最上放可以展开二级菜单的那一栏。
- */
-declare interface EditorMenuOptions<TName extends string> {
-    /**
-     * 菜单栏是否显示
-     */
-    visible?: boolean;
-    /**
-     * 是否禁用菜单栏所有功能
-     */
-    disabled?: boolean;
-    /**
-     * 菜单栏一级菜单配置
-     */
-    entries?: EditorMenuEntryConfig<TName>[];
-    /**
-     * 菜单栏功能按钮配置
-     */
-    features?: Partial<EditorMenuFeatureButtonConfig<TName>>;
-    /**
-     * 自定义按钮配置
-     */
-    custom?: EditorMenuCustomButton[];
-}
-
-/**
- * 编辑器基础模式接口
- */
-declare interface EditorMode {
-    /**
-     * 获取当前编辑器模式
-     */
-    getModeType: () => EditorModeType;
-    /**
-     * 设置编辑器权限模式，仅在 `standard` 模式下有效
-     * @param permission
-     */
-    setStandardRole: (standardRole: EditorStandardRole) => Promise<void>;
-    /**
-     * 获取当前编辑器权限模式，仅在 `standard` 模式下有效
-     */
-    getStandardRole: () => EditorStandardRole;
-}
-
-/**
- * 编辑器初始化的时相关的模式配置
- */
-declare type EditorModeOptions = {
-    type: 'standard';
-    /**
-     * 当 mode 为 `standard` 时，可以设置当前编辑器的权限模式
-     */
-    role?: EditorStandardRole;
-} | {
-    type: 'preview';
-} | {
-    type: 'presentation';
-};
-
-/**
- * 编辑器模式
- * - `standard` 标准模式，会根据用户权限配置不同的功能
- * - `preview` 预览模式，只能查看内容
- * - `presentation` 演示模式，用作演示场景，演示模式下部分套件可以进行一些简单的编辑操作
- */
-declare type EditorModeType = 'standard' | 'preview' | 'presentation';
-
-/**
- * 编辑器初始化通用参数
- */
-declare interface EditorOptions {
-    /**
-     * 编辑器初始化内容，可以是 string 或者 ArrayBuffer，
-     * 也可以通过异步 Promise 加载
-     */
-    content: MaybePromiseValue<string | ArrayBuffer>;
-    /**
-     * 初始化时的编辑模式，默认为 `preview`
-     */
-    mode?: EditorModeOptions;
-    /**
-     * 当前操作编辑器的用户信息
-     */
-    user?: EditorUserOptions;
-    /**
-     * i18n 相关设置
-     */
-    i18n?: EditorI18nOptions;
-    /**
-     * 品牌相关设置
-     */
-    brand?: EditorBrandOptions;
-    /**
-     * 工具栏相关设置
-     */
-    toolbar?: EditorToolbarOptions;
-    /**
-     * 编辑器内部资源请求配置
-     */
-    assets?: EditorAssetsOptions;
-    /**
-     * 编辑器内部超链接设置
-     */
-    link?: EditorLinkOptions;
-    /**
-     * 嵌入对象相关配置
-     */
-    embeddedObject?: EditorEmbeddedObjectOptions;
-    /**
-     * 初始化水印配置
-     */
-    watermark?: EditorWatermarkOptions;
-    /**
-     * 编辑器打印设置
-     */
-    print?: EditorPrintOptions;
-    /**
-     * 编辑器评论设置
-     */
-    comments?: EditorCommentsOptions;
-}
-
-/**
- * 编辑器打印设置
- */
-declare interface EditorPrintOptions {
-    /**
-     * 部分套件如果绕过了编辑器预设的打印接口，直接通过拉起了浏览器的打印页面，这时打印页面无法获取到编辑器的内容，
-     * 这种情况下就会 fallback 到这个 options 上，显示一个提示信息。
-     */
-    fallback?: {
-        message: string;
-    };
-    /**
-     * 是否禁用打印功能
-     */
-    disabled?: boolean;
-}
-
-/**
- * 编辑器通用接口
- */
-declare abstract class EditorSDK {
-    protected options: EditorOptions;
-    constructor(options: EditorOptions);
-    /**
-     * 初始化编辑器、加载插件等操作。
-     */
-    abstract init(): Promise<void>;
-    /**
-     * 销毁编辑器
-     */
-    abstract destroy(): Promise<void>;
-    /**
-     * 将编辑器挂载到指定的根节点上，并渲染，
-     * mount 应该在 init 之后调用。
-     * @param root
-     */
-    abstract mount(root: HTMLElement): Promise<void>;
-    /**
-     * 从根节点卸载编辑器，对应 `mount` 操作
-     */
-    abstract unmount(): Promise<void>;
-    /**
-     * 编辑器内容相关接口
-     */
-    abstract get content(): EditorContent;
-    /**
-     * 编辑器模式相关接口
-     */
-    abstract get mode(): EditorMode;
-    /**
-     * 编辑器评论相关接口
-     */
-    abstract get comments(): EditorComments;
-}
-
-/**
- * 编辑器在 `standard` 模式下的权限模式
- * - `editor` 编辑模式
- * - `viewer` 阅读模式
- * - `reviewer` 评论模式
- */
-declare type EditorStandardRole = 'editor' | 'viewer' | 'reviewer';
-
-/**
- * 文本格式接口，
- * 包括设置、读取选区内文本的 BIUS、family、大小、颜色等
- */
-declare interface EditorText<Color = string, TRangeValue = unknown> {
-    /**
-     * 获取当前选区或指定选区内的文本格式状态
-     */
-    get: (range?: TRangeValue) => Partial<EditorTextFormat<Color>>;
-    /**
-     * 将文本的格式应用到当前选区或指定选区上，
-     * 传入的非空字段会覆盖对应的属性，其他没有传入的属性会保持不变。
-     * @param range
-     * @param format
-     * @returns
-     */
-    apply: (format: Partial<EditorTextFormat<Color>>, range?: TRangeValue) => Partial<EditorTextFormat<Color>>;
-    /**
-     * 清空当前选区或指定选区内文本的格式，将文本格式恢复到默认状态
-     * @param range
-     * @returns
-     */
-    clear: (range: TRangeValue) => void;
-}
-
-/**
- * 文本格式状态
- */
-declare interface EditorTextFormat<Color = string> {
-    /**
-     * 粗体
-     */
-    bold: boolean;
-    /**
-     * 斜体
-     */
-    italic: boolean;
-    /**
-     * 下划线
-     */
-    underline: boolean;
-    /**
-     * 删除线
-     */
-    strike: boolean;
-    /**
-     * 文本颜色
-     */
-    color: Color;
-    /**
-     * 文本背景高亮颜色
-     */
-    highlight: Color;
-    /**
-     * 文本大小
-     */
-    size: number | string;
-    /**
-     * 文本名称
-     */
-    family: string;
-}
-
-/**
- * 文本格式初始化选项
- */
-declare interface EditorTextOptions<Color = string> {
-    /**
-     * 当前编辑器默认的文本格式
-     */
-    defaultFormat?: Partial<EditorTextFormat<Color>>;
-}
-
-/**
- * 工具栏自定义按钮配置
- */
-declare interface EditorToolbarCustomButton extends Omit<EditorToolbarFeatureButton, 'name'> {
-    /**
-     * 自定义按钮名称
-     */
-    name: string;
-    /**
-     * 按钮点击事件
-     */
-    callback: () => void;
-    /**
-     * 按钮在工具栏中的位置，默认添加到工具栏所有按钮后面
-     */
-    index?: number;
-}
-
-/**
- * 工具栏自定义按钮配置
- */
-declare interface EditorToolbarCustomButtonConfig {
-    /**
-     * 按钮配置
-     */
-    [key: string]: EditorToolbarCustomButton;
-}
-
-/**
- * 工具栏内置功能按钮配置
- */
-declare interface EditorToolbarFeatureButton {
-    /**
-     * 按钮类型
-     */
-    name: EditorToolbarFeatureButtonName;
-    /**
-     * 按钮标签（显示文本）
-     */
-    label?: string;
-    /**
-     * 按钮图标，可以是 base64 的图片信息，也可以是图片 url
-     */
-    icon?: string;
-    /**
-     * 按钮是否禁用
-     */
-    disabled?: boolean;
-    /**
-     * 按钮提示文本
-     */
-    tooltip?: string;
-}
-
-/**
- * 工具栏内置功能按钮配置
- */
-declare type EditorToolbarFeatureButtonConfig = {
-    [key in EditorToolbarFeatureButtonName]?: EditorToolbarFeatureButton;
-};
-
-/**
- * 工具栏内置功能按钮
- */
-declare type EditorToolbarFeatureButtonName = 
-/**
-* 加粗
-*/
-'bold'
-/**
-* 斜体
-*/
-| 'italic'
-/**
-* 下划线
-*/
-| 'underline'
-/**
-* 删除线
-*/
-| 'strikethrough'
-/**
-* 插入图片
-*/
-| 'insertImage'
-/**
-* 插入链接
-*/
-| 'insertLink'
-/**
-* 限制编辑
-*/
-| 'restriction';
-
-/**
- * 工具栏相关设置，可以控制工具栏的显示内容
- */
-declare interface EditorToolbarOptions {
-    /**
-     * 控制工具栏显隐状态
-     */
-    visible?: boolean;
-    /**
-     * 是否禁用工具栏所有功能
-     */
-    disabled?: boolean;
-    /**
-     * 现有按钮的功能配置
-     */
-    features?: EditorToolbarFeatureButtonConfig;
-    /**
-     * 自定义按钮
-     */
-    custom?: EditorToolbarCustomButtonConfig;
-}
-
-/**
- * 操作当前编辑器的用户信息
- */
-declare interface EditorUserOptions {
-    /**
-     * 用户 ID，用于标识用户
-     */
-    uid: string;
-    /**
-     * 用户名
-     */
-    name: string;
-    /**
-     * 用户头像
-     */
-    avatar?: string;
-}
-
-/**
- * 编辑器外部水印信息
- */
-declare interface EditorWatermarkOptions {
-    /**
-     * 获取用作初始化使用的默认水印
-     */
-    getWatermark: () => MaybePromiseValue<EditorWatermarkResource | null>;
-    /**
-     * 是否必须，如果为 true，编辑器将在初始化时强制渲染水印，
-     * 水印配置信息加载失败将导致编辑器初始化失败
-     */
-    required?: boolean;
-}
-
-declare type EditorWatermarkResource = {
-    type: 'data-url';
-    url: string;
-} | {
-    type: 'object-url';
-    url: string;
-};
-
-/**
- * 请求、响应头
- */
-declare type HTTPHeaders = Record<string, string | number | boolean | undefined>;
-
-/**
- * 请求方法
- */
-declare type HTTPMethod = 'get' | 'GET' | 'delete' | 'DELETE' | 'head' | 'HEAD' | 'options' | 'OPTIONS' | 'post' | 'POST' | 'put' | 'PUT' | 'patch' | 'PATCH';
-
-/**
- * HTTP 代理，用于抽象 HTTP 请求，
- * 将请求代理编辑器外部
- */
-declare interface HTTPProxy {
-    /**
-     * 发送请求，如果需要做请求、响应拦截，需要在 proxy.interceptors 中实现，
-     * 套件内使用 proxy 发送请求的方式应该为类似如下方式:
-     * ```ts
-     * const raw = await proxy.request(proxy.interceptors?.request?.intercept(requestConfig) ?? requestConfig);
-     * const response = proxy.interceptors?.response?.intercept(raw) ?? raw;
-     * ```
-     *
-     * 套件内如果需要通过其他方式发送请求，比如通过浏览器的 Image API 加载，可以使用 proxy.interceptors?.request?.intercept(requestConfig) 处理请求配置
-     * @param config
-     * @returns
-     */
-    request: <D = unknown, T = unknown>(config: HTTPRequestConfig<D>) => Promise<HTTPResponse<T>>;
-    /**
-     * 请求、响应拦截器，
-     *
-     */
-    interceptors?: {
-        request?: {
-            /**
-             * 请求拦截器，传入请求配置，返回处理后的请求配置
-             * @param requestConfig 请求配置
-             * @returns
-             */
-            intercept: <D = unknown>(requestConfig: HTTPRequestConfig<D>) => HTTPRequestConfig<D>;
-        };
-        response?: {
-            /**
-             * 响应拦截器，传入响应，返回处理后的响应
-             * @param response
-             * @returns
-             */
-            intercept: <T = unknown>(response: HTTPResponse<T>) => HTTPResponse<T>;
-        };
-    };
-    /**
-     * 创建一个新的 HTTP 代理，用于为不同请求场景创建不同的代理
-     * @param id
-     * @returns
-     */
-    create: (id: string) => Promise<HTTPProxy>;
-}
-
-/**
- * 请求配置
- */
-declare interface HTTPRequestConfig<Data = unknown> {
-    /**
-     * 请求地址
-     */
-    url: string;
-    /**
-     * 请求方法
-     */
-    method?: HTTPMethod;
-    /**
-     * 请求携带数据，主要是 POST、PUT、PATCH 等方法的请求数据
-     */
-    data?: Data;
-    /**
-     * 期望的响应数据类型
-     */
-    responseType?: HTTPResponseType;
-    /**
-     * 请求头
-     */
-    headers?: HTTPHeaders;
-}
-
-/**
- * 响应数据
- */
-declare interface HTTPResponse<Data = unknown> {
-    /**
-     * 响应数据 body
-     */
-    data: Data;
-    /**
-     * 响应状态码
-     */
-    status: number;
-    /**
-     * 响应头
-     */
-    headers: HTTPHeaders;
-}
-
-/**
- * 请求返回类型
- */
-declare type HTTPResponseType = 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream';
-
-declare type MaybePromiseValue<T> = T | Promise<T>;
-
-/**
- * 表格单元格对象
- */
-export declare interface SheetCell {
-    /**
-     * 单元格所在的行号
-     */
-    row: number;
-    /**
-     * 单元格所在的列号
-     */
-    column: number;
-    /**
-     * 单元格所在的工作表 ID
-     */
-    sheetId: string;
-    /**
-     * 获取单元格的文本
-     */
-    getCellText: () => string;
-    /**
-     * 获取单元格的值
-     */
-    getCellValue: () => SheetCellValue | null;
-}
-
-/**
- * 单元格值类型
- */
-export declare type SheetCellValue = {
-    type: 'primitive';
-    value: string | number | boolean;
-} | {
-    type: 'date';
-    value: number;
-} | {
-    type: 'calcError';
-    value: {
-        error: string;
-    };
-};
-
-/**
- * 电子表格工具栏一级菜单
- */
-export declare type SheetMenuEntryConfig = EditorMenuEntryConfig<SheetMenuFeatureButtonName>;
-
-/**
- * 电子表格工具栏功能按钮
- */
-export declare type SheetMenuFeatureButtonConfig = EditorMenuFeatureButtonConfig<SheetMenuFeatureButtonName>;
-
-/**
- * 电子表格工具栏内置功能按钮
- */
-export declare type SheetMenuFeatureButtonName = 'undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'selectAll';
-
-export declare type SheetMenuOptions = EditorMenuOptions<SheetMenuFeatureButtonName>;
-
-/**
- * 表格区域对象，
- * 用于表示表格中被选中的单元格区域，
- * 可以是一个单元格、一行、一列、或某个区域。
- */
-export declare interface SheetRange {
-    /**
-     * 区域类型
-     */
-    type: `${SheetRangeType}`;
-    /**
-     * 区域的行开始位置
-     */
-    readonly row: number;
-    /**
-     * 区域的列开始位置
-     */
-    readonly column: number;
-    /**
-     * 区域的行数
-     */
-    readonly rowCount: number;
-    /**
-     * 区域的列数
-     */
-    readonly columnCount: number;
-    /**
-     * 获取该区域对应的纯文本信息。
-     * @returns
-     */
-    getText: () => string;
-    /**
-     * 设置该区域的内容
-     * @param text 内容
-     */
-    setText: (text: string) => void;
-    /**
-     * 将区域中的内容以 HTML 格式返回
-     */
-    getHtml: () => string;
-    /**
-     * 设置该区域的内容为 HTML 格式
-     * @param html 内容
-     */
-    setHtml: (html: string) => void;
-}
-
-/**
- * 区域（Range）
- * 区域对象，表示表格中的一个单元格区域，每个 Range 对象包含了一个或多个单元格、行、列信息。
- */
-/**
- * 选区类型
- */
-export declare enum SheetRangeType {
-    /**
-     * 选中一个或多个单元格
-     */
-    Cells = "cells",
-    /**
-     * 选中一行或多行
-     */
-    Rows = "rows",
-    /**
-     * 选中一列或多列
-     */
-    Columns = "columns",
-    /**
-     * 选中整个工作表
-     */
-    Sheet = "sheet"
-}
-
-export declare type SheetRangeValue = {
-    /**
-     * 单个或多个单元格
-     */
-    type: `${SheetRangeType.Cells}`;
-    /**
-     * 起始单元格的行号
-     */
-    row: number;
-    /**
-     * 总计行数
-     */
-    rowCount: number;
-    /**
-     * 起始单元格的列号
-     */
-    column: number;
-    /**
-     * 总计列数
-     */
-    columnCount: number;
-} | {
-    /**
-     * 一列或多列
-     */
-    type: `${SheetRangeType.Rows}`;
-    /**
-     * 起始列号
-     */
-    row: number;
-    /**
-     * 总计行数
-     */
-    rowCount: number;
-} | {
-    /**
-     * 一行或多行
-     */
-    type: `${SheetRangeType.Columns}`;
-    /**
-     * 起始行号
-     */
-    column: number;
-    /**
-     * 总计列数
-     */
-    columnCount: number;
-} | {
-    /**
-     * 整个工作表
-     */
-    type: `${SheetRangeType.Sheet}`;
-};
-
-export declare interface SheetSDKOptions extends EditorOptions {
-    /**
-     * 字体配置
-     */
-    fonts?: EditorFontsOptions;
-    /**
-     * 菜单栏相关设置
-     */
-    menu?: SheetMenuOptions;
-    /**
-     * 文本格式相关设置
-     */
-    text?: SheetTextOptions;
-}
-
-/**
- * 选区（Selection）
- * 表示窗口或窗格中的当前选定内容。
- * 选定内容表示表格中的选定（或突出显示）的单元格区域。
- */
-export declare interface SheetSelection {
-    /**
-     * 获取选区的区域范围，
-     * 如果没有指定范围，则返回当前选区的范围。
-     * 如果指定了范围，则返回指定范围的选区。
-     * 如果选区不存在，则返回 null。
-     */
-    getRange: (value?: SheetRangeValue) => SheetRange | null;
-    /**
-     * 设置选区的区域范围，
-     * 设置后，选区会自动选中指定范围。
-     * 如果设置为 null，则清空选区。
-     */
-    setRange: (value: SheetRangeValue | null) => void;
-}
-
-/**
- * 电子表格文本接口
- */
-export declare type SheetText = EditorText<string, SheetRangeValue>;
-
-/**
- * 电子表格文本格式
- */
-export declare type SheetTextFormat = EditorTextFormat;
-
-/**
- * 电子表格文本格式初始化选项
- */
-export declare type SheetTextOptions = EditorTextOptions<string>;
-
-/**
- * 工作表集合对象
- */
-export declare interface SheetWorkbook {
-    /**
-     * 获取所有工作表
-     * @returns
-     */
-    getWorksheets: () => SheetWorksheet[];
-    /**
-     * 获取指定的工作表
-     * @param sheetId
-     * @returns
-     */
-    getWorksheetById: (sheetId: string) => SheetWorksheet | null;
-    /**
-     * 获取当前活动的工作表
-     * TODO: 是否存在返回空的场景
-     * @returns
-     */
-    getActiveWorksheet: () => SheetWorksheet;
-    /**
-     * 激活指定的工作表
-     * @param sheetId
-     */
-    setActiveWorksheet: (sheetId: string) => void;
-}
-
-/**
- * 工作表对象
- */
-export declare interface SheetWorksheet {
-    /**
-     * 工作表对应编号
-     */
-    get id(): string;
-    /**
-     * 获取当前工作表名称
-     */
-    get name(): string;
-    /**
-     * 这个工作表是否为当前活动的工作表
-     */
-    get isActive(): boolean;
-    /**
-     * 获取工作表的所有选区
-     * @returns
-     */
-    getSelections: () => SheetSelection[] | null;
-    /**
-     * 获取选区的物理位置（相对于浏览器窗口），如果选区完全不在工作表的可视区域内，返回 null。
-     * 其中选区超出可视区域的部分会被截断处理。
-     *
-     * 当工作表存在冻结行列时，可视区域将被分成四个部分（如果仅存在冻结行或冻结列则被分为两个部分），
-     * 此时需要计算出选区在**视觉上**与可视区域的交集。
-     */
-    getPhysicalPosition: (range: SheetRangeValue) => {
-        left: number;
-        top: number;
-        width: number;
-        height: number;
-    } | null;
-    /**
-     * 添加选区变化监听器，当选区发生变化时，会触发回调。
-     * @param listener
-     * @returns 用于移除监听的回调
-     */
-    addRangeListener: (listener: (range: {
-        sheet: string;
-        ranges: SheetRangeValue[] | null;
-    }) => void) => () => void;
-    /**
-     * 获取工作表中指定区域的单元格对象
-     * @returns
-     */
-    getCell: (row: number, column: number) => SheetCell | null;
-    /**
-     * 获取工作表中选中的单元格对象
-     * @returns
-     */
-    getActiveCell: () => SheetCell | null;
-    /**
-     * 激活工作表中某个单元格
-     * @param cell 单元格对象，需要传入行和列的索引值
-     * @returns
-     */
-    setActiveCell: (cell: {
-        row: number;
-        column: number;
-    }) => void;
-    /**
-     * 定位到单元格所在位置
-     * @param row 单元格所在行
-     * @param column 单元格所在列
-     */
-    locateCell: (row: number, column: number) => void;
-}
-
-export { }