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

package/types/combine.d.ts

@@ -56,6 +56,32 @@ 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 AbstractedDocxSDK extends EditorSDK {
@@ -114,6 +140,20 @@ export declare abstract class AbstractedDocxSDK extends EditorSDK {
     abstract get paragraphs(): DocxParagraphs;
 }
 
+/**
+ * 编辑文件检查器
+ */
+export declare abstract class AbstractedEditorFileChecker {
+    /**
+     * 检查文件是否符合限制
+     * @param files
+     * @returns 返回符合的files
+     */
+    check?: (files: EditorPickedFile[], options?: {
+        type: 'image' | 'video' | 'audio' | 'attachment';
+    }) => EditorPickedFile[];
+}
+
 export declare abstract class AbstractedEditorFileUploader {
     /**
      * 开始上传
@@ -491,6 +531,12 @@ export declare interface BorderColors {
     disabled: string;
 }
 
+export declare interface BorderConfig {
+    color?: string;
+    radius?: string;
+    width?: string;
+}
+
 /** 圆角配置 */
 export declare interface BorderRadiusConfig {
     /** 无圆角 0px */
@@ -547,6 +593,8 @@ export declare interface ButtonBaseSizeStyles {
     borderRadius: string;
     /** 字重 */
     fontWeight: string | number;
+    /** 间距 */
+    gap?: string;
 }
 
 /** Button 完整配置 */
@@ -808,12 +856,16 @@ export declare interface CommonThemeConfig {
         radio: RadioConfig;
         /** 复选框 */
         checkbox: CheckboxConfig;
+        /** 下拉框 */
+        dropdown: DropdownConfig;
+        /** 下拉框按钮 */
+        dropdownButton: DropdownButtonConfig;
+        /** 菜单 */
+        menu: MenuConfig;
         /** 开关 */
         switch: SwitchConfig;
         /** 按钮 */
         button: ButtonConfig;
-        /** 下拉框 */
-        dropdown: DropdownConfig;
         /** 标签页 */
         tab: TabConfig;
         /** 滑块 */
@@ -948,6 +1000,48 @@ export declare interface DiagramSDKOptions extends EditorOptions {
     socket?: EditorSocket;
 }
 
+/**
+ * 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;
+}
+
 /**
  * 文档信息配置项，用于显示在文档信息弹窗中的内容
  */
@@ -963,6 +1057,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 对象包含起始字符位置和终止字符位置。
@@ -1086,7 +1229,7 @@ export declare interface DocsSDKOptions extends EditorOptions {
     /**
      * 纸张相关设置
      */
-    pages: {
+    pages?: {
         width: 'standard' | 'wide' | 'full';
     };
     /**
@@ -1098,14 +1241,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;
 }
 
 /**
@@ -1156,6 +1329,61 @@ export declare interface DocsSelection {
     insertHtml: (html: string) => DocsRangeValue;
 }
 
+/**
+ * Docs 侧边栏能力接口。
+ */
+export declare interface DocsSidebar {
+    /**
+     * 打开侧边栏，可选指定默认 tab。
+     */
+    show: (tab?: string) => void;
+    /**
+     * 关闭侧边栏。
+     */
+    close: () => void;
+    /**
+     * 获取当前侧边栏状态。
+     */
+    getState: () => DocsSidebarState;
+}
+
+/**
+ * Docs 侧边栏状态。
+ */
+export declare interface DocsSidebarState {
+    visible: boolean;
+    selectedTab: string;
+}
+
+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';
+    };
+}
+
+/**
+ * Docs 完整主题配置
+ */
+export declare type DocsThemeOptions = EditorThemeOptions<DocsThemeExtensions>;
+
 /**
  * 传统文档右键菜单功能按钮
  */
@@ -1657,7 +1885,7 @@ export declare interface DocxSDKOptions extends EditorOptions {
     /**
      * 主题字体相关配置
      */
-    theme: DocxThemeOptions;
+    theme?: DocxThemeOptions;
     /**
      * 工具栏设置
      */
@@ -2013,7 +2241,7 @@ export declare interface DocxThemeStyleConfigList {
 /**
  * 主题样式配置项
  */
-export declare type DocxThemeStyleKeys = 'BackgroundColor' | 'WebViewBgColor' | 'RulerSize' | 'ScrollWidthInPx' | 'RulerNumber' | 'RulerOutlines' | 'RulerTickMark' | 'RulerMarkersOutline' | 'RulerActiveMarkersOutline' | 'RulerMarkersFill' | 'RulerLightClr' | 'RulerDarkClr' | 'BackgroundScroll' | 'ContentControlBackground' | 'ContentControlTagBackground' | 'ContentControlTagBorder' | 'ContentControllersBrd' | 'ContentControllersHover' | 'ContentControllersActive' | 'ContentControllersText' | 'ContentControllersTextActive' | 'ContentControllersSymbol' | 'ContentControllersSymbolActive' | 'ContentControllersAnchorActive' | 'PageSpace' | 'PageShadowOffsetX' | 'PageShadowOffsetY' | 'PageShadowSize' | 'PageShadowColor' | 'DocumentBottomSpace' | 'DocumentMargins' | 'ToastOffsetTop' | 'ShowTopShadow';
+export declare type DocxThemeStyleKeys = 'BackgroundColor' | 'WebViewBgColor' | 'RulerSize' | 'ScrollWidthInPx' | 'RulerNumber' | 'RulerOutlines' | 'RulerTickMark' | 'RulerMarkersOutline' | 'RulerActiveMarkersOutline' | 'RulerMarkersFill' | 'RulerLightClr' | 'RulerDarkClr' | 'BackgroundScroll' | 'ContentControlBackground' | 'ContentControlTagBackground' | 'ContentControlTagBorder' | 'ContentControllersBrd' | 'ContentControllersHover' | 'ContentControllersActive' | 'ContentControllersText' | 'ContentControllersTextActive' | 'ContentControllersSymbol' | 'ContentControllersSymbolActive' | 'ContentControllersAnchorActive' | 'PageSpace' | 'PageShadowOffsetX' | 'PageShadowOffsetY' | 'PageShadowSize' | 'PageShadowColor' | 'DocumentBottomSpace' | 'DocumentMargins' | 'ToastOffsetTop' | 'ShowTopShadow' | 'ToolbarBackgroundColor' | 'MenuBarBackgroundColor' | 'StatusBarBackgroundColor' | 'SideBarBackgroundColor';
 
 /**
  * 通用目录项条目
@@ -2493,82 +2721,65 @@ export declare interface DocxZoom {
     zoomOut: () => void;
 }
 
-/** Dropdown 箭头图标配置 */
-export declare interface DropdownArrowIconConfig extends IconConfig {
-    /** 展开状态旋转角度 */
-    expandedRotateAngel: string;
-}
-
-/** Dropdown 完整配置 */
-export declare interface DropdownConfig {
-    /** 图标配置集合 */
-    icons: DropdownIconsConfig;
-    /** 普通下拉框（按钮触发器） */
-    button: DropdownVariantStyles;
-    /** 输入框下拉框（输入框触发器） */
-    input: DropdownVariantStyles;
-    /** 大尺寸配置 */
-    large: DropdownSizeStyles;
-}
-
-/** Dropdown 图标集合配置 */
-export declare interface DropdownIconsConfig {
-    /** 下拉箭头图标 */
-    arrow: DropdownArrowIconConfig;
-    /** 选中图标 */
-    check: IconConfig;
+/** 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 DropdownMenuItemStyles extends Omit<BackgroundStateStyles, 'backgroundActive'> {
-    /** 选中背景 */
-    backgroundSelected: string;
-    /** 文字颜色 */
-    color: string;
-    /** 禁用文字颜色 */
-    colorDisabled: string;
-    /** 菜单项内边距 */
+/** Dropdown 按钮尺寸 */
+export declare interface DropdownButtonSizeStyles {
     padding: string;
-}
-
-/** Dropdown 菜单容器样式 */
-export declare interface DropdownMenuStyles {
-    /** 背景色 */
-    background: string;
-    /** 边框色 */
-    borderColor: string;
-    /** 圆角 */
+    fontSize: string;
+    height: string;
+    gap: string;
     borderRadius: string;
-    /** 内边距 */
-    padding: string;
-    /** 阴影 */
-    boxShadow: string;
-    /** 最大高度 */
-    maxHeight: string;
-}
-
-/** Dropdown 尺寸配置 */
-export declare interface DropdownSizeStyles extends ButtonBaseSizeStyles {
-    /** 图标尺寸 */
     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;
 }
 
 /**
@@ -2787,6 +2998,10 @@ export declare interface EditorAttachmentOptions {
      * 附件选择器
      */
     picker?: EditorFilePicker;
+    /**
+     * 文件检查器
+     */
+    checker?: AbstractedEditorFileChecker;
     /**
      * 附件上传器
      */
@@ -3219,6 +3434,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';
+
 /**
  * 编辑器解密选项接口
  * 用于配置编辑器中需要解密的内容的相关选项
@@ -3396,11 +3619,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 {
@@ -3513,9 +3756,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;
 }
 
 /**
@@ -3543,20 +3809,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';
@@ -3601,6 +3908,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';
+
 /**
  * 链接配置，抽象打开链接等操作
  */
@@ -4150,7 +4478,11 @@ export declare interface EditorOptions {
     /**
      * 编辑器主题相关设置
      */
-    theme: EditorThemeOptions;
+    theme?: EditorThemeOptions;
+    /**
+     * 编辑器拼写检查相关设置
+     */
+    spellCheck?: EditorSpellCheckOptions;
 }
 
 /**
@@ -4470,6 +4802,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` 编辑模式
@@ -4612,6 +4987,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;
+}
+
 /**
  * 工具栏功能按钮配置(包括内置按钮和自定义按钮)
  */
@@ -4675,6 +5103,16 @@ export declare interface EditorToolbarOptions<TName extends string> {
      * 如果不配置则按照套件的默认方式挂载。
      */
     container?: HTMLElement;
+    /**
+     * 工具栏样式
+     * 各套件可自行扩展，目前支持背景色配置
+     */
+    style?: {
+        /**
+         * 背景色
+         */
+        backgroundColor?: string;
+    };
 }
 
 /**
@@ -4888,9 +5326,11 @@ export declare interface EditorUserOptions {
 export declare interface EditorVersion {
     /**
      * 保存版本
-     * @param name 版本名称
+     * @param options 版本名称
      */
-    createRevision: (name?: string) => void;
+    createRevision: (options?: string | {
+        name: string;
+    }) => void;
     /**
      * 显示版本(侧边栏或其他形式)
      * 区别于历史侧边栏，在应用表格里表现为打开历史侧边栏切换到版本 tab
@@ -4903,7 +5343,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;
+};
 
 /**
  * 编辑器外部水印信息
@@ -4933,6 +5380,13 @@ export declare type EditorWatermarkResource = {
     url: string;
 };
 
+/**
+ * 周起始日
+ * - `sunday` 星期日（英语、阿拉伯语默认）
+ * - `monday` 星期一（其他语言默认）
+ */
+export declare type EditorWeekStartDay = 'sunday' | 'monday';
+
 /**
  * 错误信息接口
  * 定义了表格组件中可能发生的错误信息结构
@@ -5022,6 +5476,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 {
     /** 超小字号 */
@@ -5235,6 +5718,16 @@ export declare interface HTTPProxy {
      * @returns
      */
     create: (id: string) => Promise<HTTPProxy>;
+    /**
+     * 凭证更新器，用于套件内部主动发起更新凭证操作
+     * 例如：页面可见性发生变化时，在pull请求发起之前
+     */
+    credentials?: {
+        /**
+         * 更新凭证
+         */
+        update: () => Promise<void>;
+    };
 }
 
 /**
@@ -5434,6 +5927,8 @@ export declare interface InputStateColorStyles {
     textColorNormal: string;
     /** 禁用文字颜色 */
     textColorDisabled: string;
+    /** 只读文字颜色 */
+    textColorReadOnly: string;
 }
 
 /** Input 状态样式配置 */
@@ -5585,6 +6080,102 @@ export declare enum MentionTypes {
     DateMention = "date_mention"
 }
 
+/** 菜单配置 */
+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;
+    };
+}
+
 /**
  * 幻灯片可导出类型
  */
@@ -6149,9 +6740,13 @@ export declare interface PresentationSDKOptions extends EditorOptions {
      */
     chart?: PresentationChartOptions;
     /**
-     * 主题相关设置
+     * UI主题相关设置
+     */
+    theme?: PresentationThemeOptions;
+    /**
+     * 幻灯片主题相关设置
      */
-    theme: PresentationThemeOptions;
+    slideTheme?: PresentationSlideThemeOptions;
     /**
      * 图示相关设置
      */
@@ -6338,9 +6933,9 @@ export declare interface PresentationSlidesPaneOptions {
 }
 
 /**
- * Presentation 特定主题配置
+ * Presentation 幻灯片主题配置
  */
-export declare interface PresentationSpecificThemeOptions extends EditorFeatureConfig {
+export declare interface PresentationSlideThemeOptions extends EditorFeatureConfig {
     /**
      * 是否禁用图片缓存, 默认不禁用
      */
@@ -6424,11 +7019,79 @@ export declare interface PresentationTextRangeValue {
 }
 
 /**
- * Presentation 主题配置扩展
+ * Presentation  UI 主题配置扩展
  */
 export declare interface PresentationThemeExtensions {
-    /** Presentation 特定配置 */
-    presentation?: PresentationSpecificThemeOptions;
+    /** 画布 */
+    canvas: {
+        background: string;
+    };
+    /** 设置面板,包括动画、辅助面板、音频设置等等面板 */
+    settingPanel: {
+        background: string;
+    };
+    /** 工具栏 */
+    toolbar: {
+        background: string;
+    };
+    /** 状态栏 */
+    statusBar: {
+        background: string;
+    };
+    /** 幻灯片窗格 */
+    slidesPane: {
+        background: string;
+        /** 幻灯片缩略图 */
+        thumbnail: {
+            /** 边框 */
+            border: {
+                selectedColor: string;
+            };
+        };
+    };
+    /** 历史 */
+    history: {
+        header: {
+            background: string;
+            boxShadow: string;
+            title: {
+                color: string;
+            };
+            description: {
+                color: string;
+            };
+            /** 退出按钮 */
+            quitButton: {
+                icon: IconConfig;
+            };
+        };
+        /** 侧边栏 */
+        sidePanel: {
+            /** 背景 */
+            background: string;
+        };
+    };
+    /** 打印 */
+    print: {
+        /** 头部 */
+        header: {
+            background: string;
+            boxShadow: string;
+            title: {
+                color: string;
+            };
+            description: {
+                color: string;
+            };
+        };
+        /** 侧边栏 */
+        sidePanel: {
+            background: string;
+        };
+        content: {
+            background: string;
+        };
+    };
 }
 
 /**
@@ -6777,6 +7440,18 @@ export declare interface SheetCellData extends SheetCellMeta {
     value: SheetCellValue | null;
 }
 
+export declare interface SheetCellHistoryLimitations {
+    /**
+     * 获取单元格历史保留天数
+     * @returns
+     */
+    getMaxRetentionDays?: () => number | undefined;
+}
+
+export declare interface SheetCellHistoryOptions extends EditorFeatureConfig {
+    limitations?: SheetCellHistoryLimitations;
+}
+
 export declare interface SheetCellMeta {
     /**
      * 单元格格式
@@ -6967,6 +7642,7 @@ export declare interface SheetFormOptions extends EditorFeatureConfig {
     }) => Promise<{
         guid: string;
         id: number;
+        fullUrl?: string;
     }>;
     /**
      * 获取表单文件的父级文件
@@ -6999,27 +7675,6 @@ export declare interface SheetFormulaOptions {
     };
 }
 
-export declare interface SheetHistoryLimitations {
-    maxDays: number;
-}
-
-export declare interface SheetHistoryOptions extends EditorHistoryOptions {
-    sidebar?: {
-        /**
-         * 检查侧边栏历史是否有卡点限制，如有，返回具体的限制；如没有，返回 null
-         * @returns
-         */
-        checkLimitations: () => Promise<SheetHistoryLimitations | null>;
-    };
-    cell?: {
-        /**
-         * 检查单元格历史是否有卡点限制，如有，返回具体的限制；如没有，返回 null
-         * @returns
-         */
-        checkLimitations: () => Promise<SheetHistoryLimitations | null>;
-    };
-}
-
 export declare interface SheetImportOptions extends EditorImportOptions {
     /**
      * 获取图片导入状态
@@ -7309,6 +7964,10 @@ export declare interface SheetRenderOptions extends EditorRenderOptions {
      * 不自动聚焦需要用鼠标单击选中单元格后才能使用键盘编辑
      */
     disableAutoFocus?: boolean;
+    /**
+     * 视图区域相关配置
+     */
+    viewport?: SheetViewportOptions;
 }
 
 export declare interface SheetSDKOptions extends EditorOptions {
@@ -7419,9 +8078,9 @@ export declare interface SheetSDKOptions extends EditorOptions {
      */
     paste?: SheetPasteOptions;
     /**
-     * 历史（侧边栏历史、单元格历史）相关设置
+     * 单元格历史相关设置
      */
-    history?: SheetHistoryOptions;
+    cellHistory?: SheetCellHistoryOptions;
 }
 
 /**
@@ -7460,6 +8119,15 @@ export declare interface SheetTabOptions extends EditorFeatureConfig {
      * 是否显示演示按钮
      */
     showPresentationButton?: boolean;
+    /**
+     * 样式
+     */
+    style?: {
+        /**
+         * 背景颜色
+         */
+        backgroundColor?: string;
+    };
 }
 
 /**
@@ -7539,6 +8207,37 @@ export declare interface SheetUiOptions extends EditorUiOptions {
     };
 }
 
+export declare interface SheetViewportHeaderOptions {
+    /**
+     * 样式
+     */
+    style?: {
+        /**
+         * 背景颜色
+         */
+        backgroundColorNormal?: string;
+        /**
+         * 悬停背景颜色
+         */
+        backgroundColorHover?: string;
+        /**
+         * 激活背景颜色
+         */
+        backgroundColorActive?: string;
+    };
+}
+
+export declare interface SheetViewportOptions {
+    /**
+     * 行头相关配置
+     */
+    rowHeader?: SheetViewportHeaderOptions;
+    /**
+     * 列头相关配置
+     */
+    columnHeader?: SheetViewportHeaderOptions;
+}
+
 /**
  * 工作表集合对象
  */
@@ -7777,6 +8476,7 @@ export declare interface SliderSizeStyles {
     thumbSize: string;
     /** 滑块偏移（距离边缘的间距） */
     thumbOffset: string;
+    borderWidth: string;
 }
 
 /** Slider 滑块（圆点）样式 */
@@ -7791,6 +8491,8 @@ export declare interface SliderTrackStyles {
     backgroundDisabled: string;
     /** 已填充部分背景 */
     filledBackground: string;
+    /** 已填充部分禁用状态背景 */
+    filledBackgroundDisabled: string;
     /** 高度 */
     height: string;
     /** 宽度 */
@@ -7812,6 +8514,22 @@ export declare interface Speaker {
     avatar: string;
 }
 
+/** 通用状态样式 */
+export declare interface StateStyles {
+    /** 默认颜色 */
+    normal: string;
+    /** 悬停文字颜色 */
+    hover: string;
+    /** 激活/聚焦文字颜色 */
+    active: string;
+    /** 禁用文字颜色 */
+    disabled: string;
+    /** 只读颜色 */
+    readonly?: string;
+    /** 错误颜色 */
+    error?: string;
+}
+
 /**
  * 表格编辑器状态枚举
  * 定义了表格编辑器可能处于的各种状态
@@ -7949,7 +8667,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;
     /** 大尺寸配置 */
@@ -8167,6 +8896,17 @@ export declare type TableFieldContextMenuFeatureButtonName =
 
 export declare type TableFieldContextMenuOptions = EditorMenuOptions<TableFieldContextMenuFeatureButtonName>;
 
+/**
+ * 字段数量限制配置
+ */
+export declare interface TableFieldLimitationOptions {
+    /**
+     * 获取单个数据表支持的最大字段数
+     * @returns 最大字段数，undefined 表示使用内部默认值
+     */
+    getMaxFieldCount?: () => number | undefined;
+}
+
 /**
  * 表格字段配置选项
  */
@@ -8284,6 +9024,10 @@ export declare interface TableFieldOptions {
          */
         disabled?: boolean;
     };
+    /**
+     * 字段数量限制
+     */
+    limitations?: TableFieldLimitationOptions;
 }
 
 export declare interface TableFormOptions {
@@ -8350,6 +9094,33 @@ export declare interface TableHistoryOptions extends EditorHistoryOptions {
          * @default false
          */
         disabled?: boolean;
+        /**
+         * 单元格历史记录卡点限制
+         */
+        limitations?: {
+            /**
+             * 获取单元格历史可查看的最大天数
+             * 返回 0 表示不限制；返回 undefined 表示使用内部默认值
+             * @returns 最大天数
+             */
+            getMaxCellHistoryDays?: () => number | undefined;
+        };
+    };
+    /**
+     * 行历史记录配置
+     */
+    rowHistory?: {
+        /**
+         * 行历史记录卡点限制
+         */
+        limitations?: {
+            /**
+             * 获取行动态历史可查看的最大天数
+             * 返回 0 表示不限制；返回 undefined 表示使用内部默认值
+             * @returns 最大天数
+             */
+            getMaxRowHistoryDays?: () => number | undefined;
+        };
     };
 }
 
@@ -8503,6 +9274,27 @@ export declare interface TablePasteOptions extends EditorPasteOptions {
     limitations?: TablePasteLimitationOptions;
 }
 
+/**
+ * 记录数量限制配置
+ */
+export declare interface TableRecordLimitationOptions {
+    /**
+     * 获取单个数据表支持的最大行数
+     * @returns 最大行数，undefined 表示使用内部默认值
+     */
+    getMaxRowCount?: () => number | undefined;
+}
+
+/**
+ * 记录/行配置选项
+ */
+export declare interface TableRecordOptions {
+    /**
+     * 记录数量限制
+     */
+    limitations?: TableRecordLimitationOptions;
+}
+
 export declare interface TableRenderOptions {
     /** 当前 table Guid */
     table?: string;
@@ -8639,6 +9431,10 @@ export declare interface TableSDKOptions extends TableEditorOptions {
      * 初始化页面渲染的时候需要的配置
      */
     render?: TableRenderOptions;
+    /**
+     * 记录/行配置
+     */
+    record?: TableRecordOptions;
 }
 
 export declare interface TableSelection {
@@ -8781,6 +9577,17 @@ export declare interface TableShortcutsOptions extends EditorShortcutOptions {
     disabledShortcuts?: TableShortcutsFeatureType[];
 }
 
+/**
+ * 版本数量限制配置
+ */
+export declare interface TableSnapshotLimitationOptions {
+    /**
+     * 获取单个数据表支持的最大手动保存版本数量
+     * @returns 最大版本数量，undefined 表示使用内部默认值
+     */
+    getMaxSnapshot?: () => number | undefined;
+}
+
 /**
  * 表格快照配置
  * 应用表格在预览指定版本时会显示 Header 用于显示创建时间等信息，预览模式时需要隐藏
@@ -8794,6 +9601,10 @@ export declare interface TableSnapshotOptions {
      * 是否禁用快照头部
      */
     disableSnapshotHeader?: boolean;
+    /**
+     * 版本数量限制
+     */
+    limitations?: TableSnapshotLimitationOptions;
 }
 
 /**
@@ -9207,6 +10018,32 @@ export declare type TableViewContextMenuFeatureButtonName = GridMenuItemName | K
 
 export declare type TableViewContextMenuOptions = EditorMenuOptions<TableViewContextMenuFeatureButtonName>;
 
+/**
+ * 视图数量限制配置
+ */
+export declare interface TableViewLimitationOptions {
+    /**
+     * 获取单个数据表支持的最大锁定视图数量
+     * @returns 最大锁定视图数量，undefined 表示使用内部默认值
+     */
+    getMaxLockedView?: () => number | undefined;
+    /**
+     * 获取单个数据表支持的最大个人视图数量
+     * @returns 最大个人视图数量，undefined 表示使用内部默认值
+     */
+    getMaxPersonalView?: () => number | undefined;
+    /**
+     * 获取单个数据表支持的最大甘特视图数量
+     * @returns 最大甘特视图数量，undefined 表示使用内部默认值
+     */
+    getMaxGanttView?: () => number | undefined;
+    /**
+     * 获取单个数据表支持的最大日历视图数量
+     * @returns 最大日历视图数量，undefined 表示使用内部默认值
+     */
+    getMaxCalendarView?: () => number | undefined;
+}
+
 /**
  * 表格视图配置选项
  */
@@ -9306,6 +10143,10 @@ export declare interface TableViewOptions {
             disableLayoutConfig?: boolean;
         };
     };
+    /**
+     * 视图数量限制
+     */
+    limitations?: TableViewLimitationOptions;
 }
 
 export declare interface TableWindow {
@@ -9335,8 +10176,10 @@ export declare interface TabStateStyles extends BackgroundStateStyles, BorderSta
 export declare interface TabVariantStyles {
     /** Tab 项状态样式 */
     item: TabStateStyles;
-    /** 布局样式 */
+    /** 布局 */
     layout: TabLayoutStyles;
+    /** tab条背景颜色 */
+    backgroundColor: string;
 }
 
 export declare interface TemplateProps {
@@ -9447,6 +10290,10 @@ export declare interface ToastConfig extends ToastBaseStyles {
     error: ToastVariantStyles;
     /** 警告提示样式 */
     warn: ToastVariantStyles;
+    /** 严重警告样式 */
+    critical: ToastVariantStyles;
+    /** 加载提示样式 */
+    loading: ToastVariantStyles;
     /** 偏移量 */
     offset: {
         /** 垂直偏移量 */
@@ -9454,6 +10301,10 @@ export declare interface ToastConfig extends ToastBaseStyles {
         /** 水平偏移量 */
         horizontal: string;
     };
+    /** 关闭按钮 */
+    closeButton: {
+        icon: Pick<IconConfig, 'url'>;
+    };
 }
 
 /**
@@ -9525,6 +10376,11 @@ export declare interface ToastVariantStyles {
     borderColor: string;
     /** 图标配置 */
     icon: IconConfig;
+    /** 消息 */
+    message: {
+        /** 颜色 */
+        color: string;
+    };
 }
 
 /** ToolbarButton 背景状态样式 */
@@ -9570,6 +10426,8 @@ export declare interface ToolbarButtonLayout {
     padding: string;
     /** 整体高度 */
     height: string;
+    /** 整体圆角 */
+    borderRadius: string;
     /** 内容布局 */
     content: {
         padding: string;
@@ -9664,6 +10522,8 @@ export declare interface TooltipStyleConfig {
     lineHeight: string;
     /** 字重 */
     fontWeight: number;
+    /** 最大宽度 */
+    maxWidth?: string;
 }
 
 /** Tooltip White 风格配置 */