@officesdk/editor-sdk-core 0.0.0-alpha.8 → 0.0.1

package/types/docs.d.ts

@@ -7,6 +7,46 @@ export declare abstract class AbstractedDocsSDK extends EditorSDK {
      * 文档选区接口
      */
     abstract get selection(): DocsSelection;
+    /**
+     * 文档大纲接口
+     */
+    abstract get outline(): DocsOutline;
+    /**
+     * 文档侧边栏接口
+     */
+    abstract get sidebar(): DocsSidebar;
+    /**
+     * 文档评论接口
+     */
+    abstract get comments(): DocsComments | undefined;
+    /**
+     * 文档演示接口
+     */
+    abstract get presentation(): EditorPresentation;
+    /**
+     * 监听标题的变化
+     * @param listener 在内部标题被修改时触发 listener 回调
+     * @returns 返回一个取消监听的函数
+     */
+    abstract addTitleChangeListener(listener: (newTitle: string) => void): () => void;
+    /**
+     * 修改标题
+     */
+    abstract setTitle(title: string): void;
+}
+
+/**
+ * 编辑文件检查器
+ */
+export declare abstract class AbstractedEditorFileChecker {
+    /**
+     * 检查文件是否符合限制
+     * @param files
+     * @returns 返回符合的files
+     */
+    check?: (files: EditorPickedFile[], options?: {
+        type: 'image' | 'video' | 'audio' | 'attachment';
+    }) => EditorPickedFile[];
 }
 
 export declare abstract class AbstractedEditorFileUploader {
@@ -84,6 +124,12 @@ export declare interface BorderColors {
     disabled: string;
 }
 
+export declare interface BorderConfig {
+    color?: string;
+    radius?: string;
+    width?: string;
+}
+
 /** 圆角配置 */
 export declare interface BorderRadiusConfig {
     /** 无圆角 0px */
@@ -140,6 +186,8 @@ export declare interface ButtonBaseSizeStyles {
     borderRadius: string;
     /** 字重 */
     fontWeight: string | number;
+    /** 间距 */
+    gap?: string;
 }
 
 /** Button 完整配置 */
@@ -347,12 +395,16 @@ export declare interface CommonThemeConfig {
         radio: RadioConfig;
         /** 复选框 */
         checkbox: CheckboxConfig;
+        /** 下拉框 */
+        dropdown: DropdownConfig;
+        /** 下拉框按钮 */
+        dropdownButton: DropdownButtonConfig;
+        /** 菜单 */
+        menu: MenuConfig;
         /** 开关 */
         switch: SwitchConfig;
         /** 按钮 */
         button: ButtonConfig;
-        /** 下拉框 */
-        dropdown: DropdownConfig;
         /** 标签页 */
         tab: TabConfig;
         /** 滑块 */
@@ -420,6 +472,48 @@ export declare interface DecorateColors {
     april: string;
 }
 
+/**
+ * Docs（轻文档）套件的卡点/权限检查结果最小形态。
+ *
+ * @remarks
+ * - 用于宿主（如 lizard-service-iframe-sdk）向 DocsSDK 透传 checkpoint 结果。
+ * - 当前粘贴长度限制仅需要 `authorized/noCheck/max`。
+ */
+export declare interface DocsAttachLimitType {
+    authorized: boolean;
+    noCheck: boolean;
+    max?: number;
+}
+
+/**
+ * Docs（轻文档）套件的卡点/权限检查函数。
+ */
+export declare type DocsCheckPermission = (key: string) => DocsAttachLimitType | null;
+
+/**
+ * Docs（轻文档）评论接口
+ */
+export declare interface DocsComments extends EditorComments {
+    /**
+     * 显示评论。show方法为默认的显示模式，可以调用showWithMode方法指定显示模式。
+     * @param type 显示模式，list表示评论列表，card表示评论卡片。
+     */
+    showWithMode: (type: 'list' | 'card') => void;
+    /**
+     * 隐藏评论
+     * @param type list表示评论列表，card表示评论卡片。
+     * 默认为list
+     */
+    hideWithMode: (type: 'list' | 'card') => void;
+}
+
+/**
+ * 文档讨论
+ */
+export declare interface DocsDiscussOptions {
+    socket?: EditorSocket;
+}
+
 /**
  * 文档信息配置项，用于显示在文档信息弹窗中的内容
  */
@@ -435,6 +529,55 @@ export declare interface DocsInfoOptions {
     name: string;
 }
 
+/**
+ * Docs（轻文档）套件卡点限制配置。
+ *
+ * @remarks
+ * 由宿主环境注入，用于在运行时查询各卡点的限额/开关。
+ * 每个 getter 返回 `undefined` 表示使用内部默认值。
+ */
+export declare interface DocsLimitationOptions {
+    /**
+     * 获取单次可粘贴的最大字符数（Character）。
+     * 返回 `undefined` 表示使用内部默认值（200000，即 20 万字符）。
+     */
+    getPasteLimitRdoc?: () => number | undefined;
+    /**
+     * 获取单次可粘贴的最大数据体积（Byte）。
+     * 返回 `undefined` 表示使用内部默认值（9437184，即 9 MB）。
+     */
+    getPasteLimit?: () => number | undefined;
+    /**
+     * 通知提醒功能是否可用。
+     * 返回 `undefined` 表示使用内部默认值（可用）。
+     */
+    getRdocNotification?: () => boolean | undefined;
+    /**
+     * 跟随模式功能是否可用。
+     * 返回 `undefined` 表示使用内部默认值（可用）。
+     */
+    getRdocFollowMode?: () => boolean | undefined;
+    /**
+     * 宽纸张功能是否可用。
+     * 返回 `undefined` 表示使用内部默认值（可用）。
+     */
+    getRdocWidePaper?: () => boolean | undefined;
+}
+
+/**
+ * Docs 大纲能力接口。
+ */
+export declare interface DocsOutline {
+    /**
+     * 获取当前大纲面板是否打开。
+     */
+    getOpen: () => boolean;
+    /**
+     * 设置大纲面板开关状态。
+     */
+    setOpen: (isOpen: boolean) => void;
+}
+
 /**
  * 区域（Range）
  * 区域对象，表示文档中的一个连续区域，每个 Range 对象包含起始字符位置和终止字符位置。
@@ -558,7 +701,7 @@ export declare interface DocsSDKOptions extends EditorOptions {
     /**
      * 纸张相关设置
      */
-    pages: {
+    pages?: {
         width: 'standard' | 'wide' | 'full';
     };
     /**
@@ -570,14 +713,44 @@ export declare interface DocsSDKOptions extends EditorOptions {
         linespacing: string;
         size: string;
     };
+    fonts?: EditorFontsOptions;
     footer?: {
         logo?: string;
         viewsText?: string;
     };
+    /**
+     * UI主题相关设置
+     */
+    theme?: DocsThemeOptions;
+    /**
+     * 讨论设置
+     */
+    discuss?: DocsDiscussOptions;
+    /**
+     * 跟随模式设置
+     */
+    followMode?: EditorFollowModeOptions;
     /**
      * 错误处理回调
      */
     errorHandler?: (context: string, err: Error, extra?: Record<string, string>) => void;
+    /**
+     * Docs 套件的卡点/权限检查函数（可选）。
+     *
+     * @remarks
+     * - 由宿主环境提供（如 lizard-service-iframe-sdk 的 `createCheckPermission`）。
+     * - 用于实现 `paste_limit_rdoc` 等卡点能力（例如粘贴前长度限制）。
+     */
+    checkPermission?: DocsCheckPermission;
+    /**
+     * Docs 套件卡点限制配置。
+     *
+     * @remarks
+     * 由宿主环境注入，用于查询各卡点的限额/功能开关。
+     * 与 {@link EditorHistoryOptions.limitations | history.limitations}、
+     * {@link EditorVersionOptions.limitations | version.limitations} 保持一致的模式。
+     */
+    limitations?: DocsLimitationOptions;
 }
 
 /**
@@ -628,82 +801,120 @@ export declare interface DocsSelection {
     insertHtml: (html: string) => DocsRangeValue;
 }
 
-/** Dropdown 箭头图标配置 */
-export declare interface DropdownArrowIconConfig extends IconConfig {
-    /** 展开状态旋转角度 */
-    expandedRotateAngel: string;
+/**
+ * Docs 侧边栏能力接口。
+ */
+export declare interface DocsSidebar {
+    /**
+     * 打开侧边栏，可选指定默认 tab。
+     */
+    show: (tab?: string) => void;
+    /**
+     * 关闭侧边栏。
+     */
+    close: () => void;
+    /**
+     * 获取当前侧边栏状态。
+     */
+    getState: () => DocsSidebarState;
 }
 
-/** Dropdown 完整配置 */
-export declare interface DropdownConfig {
-    /** 图标配置集合 */
-    icons: DropdownIconsConfig;
-    /** 普通下拉框（按钮触发器） */
-    button: DropdownVariantStyles;
-    /** 输入框下拉框（输入框触发器） */
-    input: DropdownVariantStyles;
-    /** 大尺寸配置 */
-    large: DropdownSizeStyles;
+/**
+ * Docs 侧边栏状态。
+ */
+export declare interface DocsSidebarState {
+    visible: boolean;
+    selectedTab: string;
 }
 
-/** Dropdown 图标集合配置 */
-export declare interface DropdownIconsConfig {
-    /** 下拉箭头图标 */
-    arrow: DropdownArrowIconConfig;
-    /** 选中图标 */
-    check: IconConfig;
+export declare interface DocsThemeExtensions {
+    /** 编辑器容器 */
+    container: {
+        background: string;
+        shadow: string;
+    };
+    /** 工具栏 */
+    toolbar: {
+        background: string;
+        shadow: string;
+    };
+    /** 面板背景色（历史面板、讨论面板等） */
+    drawer: {
+        background: string;
+    };
+    /** 预览组件背景色 */
+    previewer: {
+        background: string;
+    };
+    dropdown: {
+        align: 'left' | 'center' | 'right';
+    };
 }
 
-/** Dropdown 菜单项样式 */
-export declare interface DropdownMenuItemStyles extends Omit<BackgroundStateStyles, 'backgroundActive'> {
-    /** 选中背景 */
-    backgroundSelected: string;
-    /** 文字颜色 */
-    color: string;
-    /** 禁用文字颜色 */
-    colorDisabled: string;
-    /** 菜单项内边距 */
-    padding: string;
-}
+/**
+ * Docs 完整主题配置
+ */
+export declare type DocsThemeOptions = EditorThemeOptions<DocsThemeExtensions>;
 
-/** Dropdown 菜单容器样式 */
-export declare interface DropdownMenuStyles {
-    /** 背景色 */
-    background: string;
-    /** 边框色 */
-    borderColor: string;
-    /** 圆角 */
-    borderRadius: string;
-    /** 内边距 */
-    padding: string;
-    /** 阴影 */
-    boxShadow: string;
-    /** 最大高度 */
-    maxHeight: string;
+/** Dropdown 按钮配置 */
+export declare interface DropdownButtonConfig {
+    /** 颜色 */
+    color: StateStyles;
+    /** 背景 */
+    background: StateStyles;
+    /** 无边框背景 */
+    frameLessBackground: StateStyles;
+    /** 边框颜色 */
+    borderColor: StateStyles;
+    /** 图标 */
+    icon: {
+        size: IconSize;
+        /** 透明度 */
+        opacity: StateStyles;
+    };
+    /** 指示器 */
+    indicator: IconConfig & {
+        /** 旋转角度 */
+        rotate: string;
+        /** 透明度 */
+        opacity: StateStyles;
+    };
+    /** 尺寸 */
+    size: {
+        /** 大尺寸 */
+        large: DropdownButtonSizeStyles;
+        /** 中尺寸 */
+        medium: DropdownButtonSizeStyles;
+        /** 小尺寸 */
+        small: DropdownButtonSizeStyles;
+    };
 }
 
-/** Dropdown 尺寸配置 */
-export declare interface DropdownSizeStyles extends ButtonBaseSizeStyles {
-    /** 图标尺寸 */
+/** Dropdown 按钮尺寸 */
+export declare interface DropdownButtonSizeStyles {
+    padding: string;
+    fontSize: string;
+    height: string;
+    gap: string;
+    borderRadius: string;
     iconSize: IconSize;
+    indicatorSize: IconSize;
 }
 
-/** Dropdown 触发器样式（按钮或输入框触发器） */
-export declare interface DropdownTriggerStyles extends BorderStateStyles, BackgroundStateStyles, ShadowStateStyles {
-    /** 文字颜色 */
-    color: string;
-    /** 禁用文字颜色 */
-    colorDisabled: string;
-}
-
-/** Dropdown 变体样式 */
-export declare interface DropdownVariantStyles {
-    /** 触发器样式 */
-    trigger: DropdownTriggerStyles;
-    /** 菜单容器样式 */
-    menu: DropdownMenuStyles;
-    /** 菜单项样式 */
-    menuItem: DropdownMenuItemStyles;
+/**
+ * Dropdown 下拉框配置
+ */
+export declare interface DropdownConfig {
+    /** 阴影 */
+    boxShadow: string;
+    /** 内边距 */
+    padding: string;
+    /** 圆角 */
+    borderRadius: string;
+    /** 边框 */
+    border: string;
+    /** 背景 */
+    background: string;
 }
 
 /**
@@ -922,6 +1133,10 @@ export declare interface EditorAttachmentOptions {
      * 附件选择器
      */
     picker?: EditorFilePicker;
+    /**
+     * 文件检查器
+     */
+    checker?: AbstractedEditorFileChecker;
     /**
      * 附件上传器
      */
@@ -1354,6 +1569,14 @@ export declare type EditorContextMenuOptions<TName extends string> = EditorMenuO
  */
 export declare type EditorCopyOptions = EditorLogicFeatureConfig;
 
+/**
+ * 日期格式
+ * - `YYYY/MM/DD` 年/月/日（简繁中文、韩语、日语默认）
+ * - `MM/DD/YYYY` 月/日/年（英语默认）
+ * - `DD/MM/YYYY` 日/月/年（其他语言默认）
+ */
+export declare type EditorDateFormat = 'YYYY/MM/DD' | 'MM/DD/YYYY' | 'DD/MM/YYYY';
+
 /**
  * 编辑器解密选项接口
  * 用于配置编辑器中需要解密的内容的相关选项
@@ -1531,11 +1754,31 @@ export declare interface EditorFilePicker {
 }
 
 export declare interface EditorFilePickerOpenOptions {
+    /**
+     * 文件类型限制
+     */
     mimeTypes?: string[];
+    /**
+     * 最大文件尺寸限制
+     */
     maxSize?: number;
+    /**
+     * 文件后缀限制
+     */
     extensions?: string[];
+    /**
+     * 是否支持多选
+     */
     multiple?: boolean;
+    /**
+     * 是否为选择文件夹
+     */
     directory?: boolean;
+    /**
+     * 文件选择器接受的文件类型，如 'image/*' 表示接受所有图片文件
+     * 如果指定了该配置，则不会再由extensions生成accept
+     */
+    accept?: string;
 }
 
 export declare interface EditorFollowMode {
@@ -1648,9 +1891,32 @@ export declare interface EditorFontsOptions {
      */
     list?: EditorFontsList;
     /**
-     * 是否只使用本地字体，如果为 true，则不会从服务器获取字体列表。
+     * 字体列表中隐藏不可用的字体，包含外部传入的以及各套件内置的字体
+     * 不可用的定义：非本地已安装且不支持下载
+     */
+    hideUnavailableFonts?: boolean;
+    /**
+     * 字体下载监听器注册函数，当字体状态发生变化时调用提供的回调函数。
+     * 回调函数暂时没有参数，后续可以根据需要添加参数，例如提供变化的字体信息等。
+     * @param listener
+     * @returns
      */
-    useLocalFontsOnly?: boolean;
+    registerFontLoadListener?: (listener: (options: FontLoadListenerOptions) => void) => void;
+    /**
+     * 下载字体的函数，接受字体族名称和一个可选的配置对象作为参数。
+     * 配置对象可以包含以下回调函数：
+     * - onProgress: 在下载过程中调用，提供下载进度（0 到 1 之间的数字）。
+     * - onComplete: 在下载完成时调用。
+     * - onError: 在下载过程中发生错误时调用，提供错误对象。
+     * @param fontFamily
+     * @param option
+     * @returns
+     */
+    download?: (fontFamily: string, option?: {
+        onProgress?: (progress: number) => void;
+        onComplete?: () => void;
+        onError?: (error: Error) => void;
+    }) => void;
 }
 
 /**
@@ -1678,20 +1944,61 @@ export declare interface EditorHistory {
     hide: () => void;
 }
 
-export declare type EditorHistoryOptions = EditorFeatureConfig;
+export declare interface EditorHistoryLimitations {
+    /** 单个文件可还原的最近历史记录数量 */
+    getHistoryLimitRevertNum?: () => number | undefined;
+    /** 文件历史保留天数 */
+    getHistoryLimitAllTime?: () => number | undefined;
+}
+
+export declare type EditorHistoryOptions = EditorFeatureConfig & {
+    limitations?: EditorHistoryLimitations;
+};
 
 /**
  * i18n 相关设置
  */
 export declare interface EditorI18nOptions {
     /**
-     * 语言，默认使用浏览器当前环境中的语言
+     * 语言代码
+     * 默认读取浏览器/设备语言并在支持的列表中匹配
+     * 匹配规则：优先精确匹配，其次模糊匹配 language 部分，Fallback 为 en-US
      */
-    language?: string;
+    language?: EditorLanguage;
     /**
      * 文本方向，默认根据语言自动适配
      */
     direction?: 'ltr' | 'rtl';
+    /**
+     * 时区设置（包含 ID、偏移量、标签）
+     * 默认读取浏览器/设备时区，如无法匹配则根据语言推测
+     * Fallback 为 { id: 'Europe/London', offset: 0, label: 'London' }
+     */
+    timezone?: EditorTimezoneInfo;
+    /**
+     * 日期格式
+     * 默认根据语言自动匹配：
+     * - 简繁中文、韩语、日语：YYYY/MM/DD
+     * - 英语：MM/DD/YYYY
+     * - 其他语言：DD/MM/YYYY
+     * 用户手动设置后将保存并优先使用用户设置
+     */
+    dateFormat?: EditorDateFormat;
+    /**
+     * 时间格式
+     * 默认使用 24 小时制
+     * 注意：部分语言（如德语、法语、意大利语、俄语）不支持 12 小时制
+     * 用户手动设置后将保存并优先使用用户设置
+     */
+    timeFormat?: EditorTimeFormat;
+    /**
+     * 周起始日
+     * 默认根据语言自动匹配：
+     * - 英语、阿拉伯语：星期日
+     * - 其他语言：星期一
+     * 用户手动设置后将保存并优先使用用户设置
+     */
+    weekStartDay?: EditorWeekStartDay;
 }
 
 export declare type EditorImageCropPoint = 'nw' | 'north' | 'ne' | 'west' | 'center' | 'east' | 'sw' | 'south' | 'se';
@@ -1736,6 +2043,27 @@ export declare interface EditorImportOptions {
     }>;
 }
 
+/**
+ * 支持的语言代码
+ * - `zh-CN` 简体中文
+ * - `zh-TW` 繁体中文（含 zh-HK, zh-MO）
+ * - `en-US` 英语
+ * - `ja-JP` 日语
+ * - `ko-KR` 韩语
+ * - `es-ES` 西班牙语
+ * - `pt-PT` 葡萄牙语
+ * - `de-DE` 德语
+ * - `fr-FR` 法语
+ * - `it-IT` 意大利语
+ * - `ru-RU` 俄语
+ * - `id-ID` 印度尼西亚语
+ * - `vi-VN` 越南语
+ * - `th-TH` 泰语
+ * - `ms-MY` 马来语
+ * - `ar-SA` 阿拉伯语
+ */
+export declare type EditorLanguage = 'zh-CN' | 'zh-TW' | 'en-US' | 'ja-JP' | 'ko-KR' | 'es-ES' | 'pt-PT' | 'de-DE' | 'fr-FR' | 'it-IT' | 'ru-RU' | 'id-ID' | 'vi-VN' | 'th-TH' | 'ms-MY' | 'ar-SA';
+
 /**
  * 链接配置，抽象打开链接等操作
  */
@@ -2285,7 +2613,11 @@ export declare interface EditorOptions {
     /**
      * 编辑器主题相关设置
      */
-    theme: EditorThemeOptions;
+    theme?: EditorThemeOptions;
+    /**
+     * 编辑器拼写检查相关设置
+     */
+    spellCheck?: EditorSpellCheckOptions;
 }
 
 /**
@@ -2605,6 +2937,49 @@ export declare interface EditorSocket {
     connected: boolean;
 }
 
+export declare interface EditorSpellCheckDictionaryFileConfig {
+    /** 词典文件的 aff 文件路径 */
+    aff: string;
+    /** 词典文件的 dic 文件路径 */
+    dic: string;
+}
+
+/**
+ * 拼写检查相关配置
+ */
+export declare interface EditorSpellCheckOptions extends EditorFeatureConfig {
+    /**
+     * 拼写检查功能配置
+     */
+    spellCheck?: {
+        /**
+         * 拼写检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查所需要的字典文件 CDN 域名
+         */
+        dictionaryCDNHost?: string;
+        /**
+         * 自定义拼写检查词典, 用于覆盖内置的默认词典
+         */
+        customDictionary?: Partial<Record<EditorLanguage, EditorSpellCheckDictionaryFileConfig>>;
+    };
+    /**
+     * 语法检查功能配置
+     */
+    grammarCheck?: {
+        /**
+         * 语法检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查API的URL,必须使用绝对路径
+         */
+        url?: string;
+    };
+}
+
 /**
  * 编辑器在 `standard` 模式下的权限模式
  * - `editor` 编辑模式
@@ -2747,6 +3122,59 @@ export declare interface EditorThemeOptions<TExtensions = object> extends Common
     extensions?: TExtensions;
 }
 
+/**
+ * 时间格式
+ * - `24h` 24 小时制（默认）
+ * - `12h` 12 小时制（部分语言不支持）
+ */
+export declare type EditorTimeFormat = '24h' | '12h';
+
+/**
+ * 支持的时区 IANA ID
+ *
+ * 覆盖范围: UTC-12 到 UTC+12，共 34 个全球主要城市时区
+ *
+ * 注意事项:
+ * - 所有时区 ID 均为 IANA 时区数据库标准标识符
+ * - Etc/GMT+12 表示 UTC-12（Etc/GMT 时区符号与 UTC 相反）
+ * - 不包括已弃用或非标准时区标识符
+ *
+ * @see https://www.iana.org/time-zones
+ */
+export declare type EditorTimezoneId = 'Etc/GMT+12' | 'Pacific/Pago_Pago' | 'Pacific/Honolulu' | 'America/Anchorage' | 'America/Los_Angeles' | 'America/Denver' | 'America/Mexico_City' | 'America/New_York' | 'America/Santiago' | 'America/Sao_Paulo' | 'Atlantic/South_Georgia' | 'Atlantic/Cape_Verde' | 'Europe/London' | 'Europe/Lisbon' | 'Europe/Paris' | 'Europe/Berlin' | 'Europe/Rome' | 'Europe/Madrid' | 'Africa/Cairo' | 'Europe/Moscow' | 'Asia/Riyadh' | 'Asia/Dubai' | 'Asia/Karachi' | 'Asia/Dhaka' | 'Asia/Bangkok' | 'Asia/Jakarta' | 'Asia/Ho_Chi_Minh' | 'Asia/Shanghai' | 'Asia/Kuala_Lumpur' | 'Asia/Tokyo' | 'Asia/Seoul' | 'Australia/Sydney' | 'Pacific/Guadalcanal' | 'Pacific/Auckland';
+
+/**
+ * 时区信息
+ */
+export declare interface EditorTimezoneInfo {
+    /**
+     * IANA 时区 ID
+     *
+     * 标准的 IANA 时区数据库标识符
+     *
+     * @example 'Asia/Shanghai', 'America/New_York', 'Europe/London'
+     */
+    id: EditorTimezoneId;
+    /**
+     * UTC 偏移量（小时，标准时间）
+     *
+     * - 正数：东半球，如 `8` 表示 UTC+8（北京）
+     * - 负数：西半球，如 `-5` 表示 UTC-5（纽约标准时间）
+     * - 零：格林威治标准时间
+     *
+     * 注意：此值为标准时间，不包含夏令时调整
+     */
+    offset: number;
+    /**
+     * 时区标签（英文）
+     *
+     * 用于 UI 显示的城市或地区名称
+     *
+     * @example 'Shanghai', 'New York', 'London'
+     */
+    label: string;
+}
+
 /**
  * 工具栏功能按钮配置(包括内置按钮和自定义按钮)
  */
@@ -2810,6 +3238,16 @@ export declare interface EditorToolbarOptions<TName extends string> {
      * 如果不配置则按照套件的默认方式挂载。
      */
     container?: HTMLElement;
+    /**
+     * 工具栏样式
+     * 各套件可自行扩展，目前支持背景色配置
+     */
+    style?: {
+        /**
+         * 背景色
+         */
+        backgroundColor?: string;
+    };
 }
 
 /**
@@ -3023,9 +3461,11 @@ export declare interface EditorUserOptions {
 export declare interface EditorVersion {
     /**
      * 保存版本
-     * @param name 版本名称
+     * @param options 版本名称
      */
-    createRevision: (name?: string) => void;
+    createRevision: (options?: string | {
+        name: string;
+    }) => void;
     /**
      * 显示版本(侧边栏或其他形式)
      * 区别于历史侧边栏，在应用表格里表现为打开历史侧边栏切换到版本 tab
@@ -3038,7 +3478,14 @@ export declare interface EditorVersion {
     hide?: () => void;
 }
 
-export declare type EditorVersionOptions = EditorFeatureConfig;
+export declare interface EditorVersionLimitations {
+    /** 单个文件可保存/还原的版本（快照）数量 */
+    getHistoryLimitVersionNum?: () => number | undefined;
+}
+
+export declare type EditorVersionOptions = EditorFeatureConfig & {
+    limitations?: EditorVersionLimitations;
+};
 
 /**
  * 编辑器外部水印信息
@@ -3068,6 +3515,13 @@ export declare type EditorWatermarkResource = {
     url: string;
 };
 
+/**
+ * 周起始日
+ * - `sunday` 星期日（英语、阿拉伯语默认）
+ * - `monday` 星期一（其他语言默认）
+ */
+export declare type EditorWeekStartDay = 'sunday' | 'monday';
+
 export declare interface FileLinkParams {
     /**
      * 文件guid
@@ -3139,6 +3593,35 @@ export declare interface FontFamilyConfig {
     base: string;
 }
 
+/**
+ * 字体下载事件类型
+ */
+export declare enum FontLoadEventType {
+    DownloadStart = "downloadStart",
+    DownloadProgress = "downloadProgress",
+    DownloadComplete = "downloadComplete",
+    DownloadError = "downloadError"
+}
+
+/**
+ * 字体下载事件监听器参数，根据事件类型提供不同的属性
+ */
+export declare type FontLoadListenerOptions = {
+    type: FontLoadEventType.DownloadStart;
+    id: string;
+} | {
+    type: FontLoadEventType.DownloadComplete;
+    id: string;
+} | {
+    type: FontLoadEventType.DownloadProgress;
+    id: string;
+    progress: number;
+} | {
+    type: FontLoadEventType.DownloadError;
+    id: string;
+    error: Error;
+};
+
 /** 字号配置 */
 export declare interface FontSizeConfig {
     /** 超小字号 */
@@ -3273,6 +3756,16 @@ export declare interface HTTPProxy {
      * @returns
      */
     create: (id: string) => Promise<HTTPProxy>;
+    /**
+     * 凭证更新器，用于套件内部主动发起更新凭证操作
+     * 例如：页面可见性发生变化时，在pull请求发起之前
+     */
+    credentials?: {
+        /**
+         * 更新凭证
+         */
+        update: () => Promise<void>;
+    };
 }
 
 /**
@@ -3472,6 +3965,8 @@ export declare interface InputStateColorStyles {
     textColorNormal: string;
     /** 禁用文字颜色 */
     textColorDisabled: string;
+    /** 只读文字颜色 */
+    textColorReadOnly: string;
 }
 
 /** Input 状态样式配置 */
@@ -3554,6 +4049,102 @@ export declare interface MentionInfo {
     top?: number;
 }
 
+/** 菜单配置 */
+export declare interface MenuConfig {
+    /** 菜单项配置 */
+    menuItem: MenuItemConfig;
+    /** 子菜单 */
+    subMenu: {
+        /** 子菜单弹出位置偏移 */
+        popupOffset: number[];
+    };
+    /** 边框 */
+    border: BorderConfig;
+    /** 阴影 */
+    boxShadow: Pick<StateStyles, 'normal' | 'hover'>;
+    /** 分割线 */
+    divider: {
+        background: string;
+        height: string;
+        margin: string;
+    };
+    /** 分组标题 */
+    groupTitle: {
+        fontSize: string;
+        fontWeight: string;
+        color: string;
+    };
+}
+
+/** 菜单项配置 */
+export declare interface MenuItemConfig {
+    /** 背景 */
+    background: {
+        normal: string;
+        hover: string;
+        active: string;
+        disabled: string;
+    };
+    /** 边框 */
+    border: BorderConfig;
+    /** 布局 */
+    layout: {
+        /** 内边距 */
+        padding: string;
+        /** 间距 */
+        gap: string;
+    };
+    /** 图标 */
+    icon: {
+        size: IconSize;
+    };
+    /** 标签 */
+    label: {
+        /** 颜色 */
+        color: StateStyles;
+    };
+    /** 描述文本 */
+    description: {
+        /** 颜色 */
+        color: StateStyles;
+    };
+    /** 激活图标 */
+    activeIcon: {
+        url: string;
+    };
+    /** 下一级菜单图标 */
+    nextLevelIcon: {
+        url: string;
+    };
+    /** 尺寸 */
+    size: {
+        /** 小尺寸 */
+        small: MenuItemSizeStyles;
+        /** 中尺寸 */
+        medium: MenuItemSizeStyles;
+        /** 大尺寸 */
+        large: MenuItemSizeStyles;
+    };
+}
+
+/** 菜单项尺寸样式 */
+export declare interface MenuItemSizeStyles {
+    label: {
+        fontSize: string;
+        maxWidth: string;
+    };
+    description: {
+        fontSize: string;
+        maxWidth: string;
+    };
+    activeIcon: {
+        size: IconSize;
+    };
+    nextLevelIcon: {
+        size: IconSize;
+    };
+}
+
 /** 带透明度状态的图标配置 */
 export declare interface OpacityIconConfig extends IconConfig {
     /** 默认透明度 */
@@ -3801,6 +4392,7 @@ export declare interface SliderSizeStyles {
     thumbSize: string;
     /** 滑块偏移（距离边缘的间距） */
     thumbOffset: string;
+    borderWidth: string;
 }
 
 /** Slider 滑块（圆点）样式 */
@@ -3815,6 +4407,8 @@ export declare interface SliderTrackStyles {
     backgroundDisabled: string;
     /** 已填充部分背景 */
     filledBackground: string;
+    /** 已填充部分禁用状态背景 */
+    filledBackgroundDisabled: string;
     /** 高度 */
     height: string;
     /** 宽度 */
@@ -3836,6 +4430,22 @@ export declare interface Speaker {
     avatar: string;
 }
 
+/** 通用状态样式 */
+export declare interface StateStyles {
+    /** 默认颜色 */
+    normal: string;
+    /** 悬停文字颜色 */
+    hover: string;
+    /** 激活/聚焦文字颜色 */
+    active: string;
+    /** 禁用文字颜色 */
+    disabled: string;
+    /** 只读颜色 */
+    readonly?: string;
+    /** 错误颜色 */
+    error?: string;
+}
+
 /** Switch 完整配置 */
 export declare interface SwitchConfig {
     /** 关闭状态样式 */
@@ -3952,7 +4562,18 @@ export declare interface SyncStatusDelegation {
 /** Tab 完整配置 */
 export declare interface TabConfig {
     /** 线性标签页（仅下边框） */
-    line: TabVariantStyles;
+    line: {
+        backgroundColor: string;
+        item: TabStateStyles & {
+            /** 选中底部线条宽度/高度 */
+            bottomActiveWidth: string;
+            /** 选中底部线条圆角 */
+            bottomActiveBorderRadius: string;
+            /** 选中底部线条背景颜色 */
+            bottomActiveBackgroundColor: string;
+        };
+        layout: TabLayoutStyles;
+    };
     /** 面性标签页（带所有边框） */
     card: TabVariantStyles;
     /** 大尺寸配置 */
@@ -3976,8 +4597,10 @@ export declare interface TabStateStyles extends BackgroundStateStyles, BorderSta
 export declare interface TabVariantStyles {
     /** Tab 项状态样式 */
     item: TabStateStyles;
-    /** 布局样式 */
+    /** 布局 */
     layout: TabLayoutStyles;
+    /** tab条背景颜色 */
+    backgroundColor: string;
 }
 
 /** Text Button 变体配置（在基础变体上扩展带背景色的引导样式） */
@@ -4058,6 +4681,10 @@ export declare interface ToastConfig extends ToastBaseStyles {
     error: ToastVariantStyles;
     /** 警告提示样式 */
     warn: ToastVariantStyles;
+    /** 严重警告样式 */
+    critical: ToastVariantStyles;
+    /** 加载提示样式 */
+    loading: ToastVariantStyles;
     /** 偏移量 */
     offset: {
         /** 垂直偏移量 */
@@ -4065,6 +4692,10 @@ export declare interface ToastConfig extends ToastBaseStyles {
         /** 水平偏移量 */
         horizontal: string;
     };
+    /** 关闭按钮 */
+    closeButton: {
+        icon: Pick<IconConfig, 'url'>;
+    };
 }
 
 /**
@@ -4136,6 +4767,11 @@ export declare interface ToastVariantStyles {
     borderColor: string;
     /** 图标配置 */
     icon: IconConfig;
+    /** 消息 */
+    message: {
+        /** 颜色 */
+        color: string;
+    };
 }
 
 /** ToolbarButton 背景状态样式 */
@@ -4181,6 +4817,8 @@ export declare interface ToolbarButtonLayout {
     padding: string;
     /** 整体高度 */
     height: string;
+    /** 整体圆角 */
+    borderRadius: string;
     /** 内容布局 */
     content: {
         padding: string;
@@ -4275,6 +4913,8 @@ export declare interface TooltipStyleConfig {
     lineHeight: string;
     /** 字重 */
     fontWeight: number;
+    /** 最大宽度 */
+    maxWidth?: string;
 }
 
 /** Tooltip White 风格配置 */