@officesdk/editor-sdk-core 0.0.0-alpha.18 → 0.0.0-alpha.19

package/types/combine.d.ts

@@ -960,6 +960,24 @@ 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;
+
 /**
  * 文档信息配置项，用于显示在文档信息弹窗中的内容
  */
@@ -1110,14 +1128,31 @@ export declare interface DocsSDKOptions extends EditorOptions {
         linespacing: string;
         size: string;
     };
+    fonts?: EditorFontsOptions;
     footer?: {
         logo?: string;
         viewsText?: string;
     };
+    /**
+     * UI主题相关设置
+     */
+    theme: DocsThemeOptions;
     /**
      * 错误处理回调
      */
     errorHandler?: (context: string, err: Error, extra?: Record<string, string>) => void;
+    /**
+     * 是否启用拼写和语法检查功能，默认 false
+     */
+    enableSpellChecker?: boolean;
+    /**
+     * Docs 套件的卡点/权限检查函数（可选）。
+     *
+     * @remarks
+     * - 由宿主环境提供（如 lizard-service-iframe-sdk 的 `createCheckPermission`）。
+     * - 用于实现 `paste_limit_rdoc` 等卡点能力（例如粘贴前长度限制）。
+     */
+    checkPermission?: DocsCheckPermission;
 }
 
 /**
@@ -1168,6 +1203,35 @@ export declare interface DocsSelection {
     insertHtml: (html: string) => DocsRangeValue;
 }
 
+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>;
+
 /**
  * 传统文档右键菜单功能按钮
  */
@@ -1669,7 +1733,7 @@ export declare interface DocxSDKOptions extends EditorOptions {
     /**
      * 主题字体相关配置
      */
-    theme: DocxThemeOptions;
+    theme?: DocxThemeOptions;
     /**
      * 工具栏设置
      */
@@ -4550,18 +4614,47 @@ export declare interface EditorSocket {
     connected: boolean;
 }
 
+export declare interface EditorSpellCheckDictionaryFileConfig {
+    /** 词典文件的 aff 文件路径 */
+    aff: string;
+    /** 词典文件的 dic 文件路径 */
+    dic: string;
+}
+
 /**
  * 拼写检查相关配置
  */
 export declare interface EditorSpellCheckOptions extends EditorFeatureConfig {
     /**
-     * 字典文件 CDN 路径
+     * 拼写检查功能配置
      */
-    dictionaryCDNPath?: string;
+    spellCheck?: {
+        /**
+         * 拼写检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查所需要的字典文件 CDN 域名
+         */
+        dictionaryCDNHost?: string;
+        /**
+         * 自定义拼写检查词典, 用于覆盖内置的默认词典
+         */
+        customDictionary?: Partial<Record<EditorLanguage, EditorSpellCheckDictionaryFileConfig>>;
+    };
     /**
-     * 拼写检查API的URL,必须使用绝对路径
+     * 语法检查功能配置
      */
-    url?: string;
+    grammarCheck?: {
+        /**
+         * 语法检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查API的URL,必须使用绝对路径
+         */
+        url?: string;
+    };
 }
 
 /**
@@ -5789,8 +5882,6 @@ export declare interface MenuItemConfig {
     };
     /** 边框 */
     border: BorderConfig;
-    /** 圆角 */
-    borderRadius: string;
     /** 布局 */
     layout: {
         /** 内边距 */
@@ -6415,7 +6506,7 @@ export declare interface PresentationSDKOptions extends EditorOptions {
     /**
      * UI主题相关设置
      */
-    theme: PresentationThemeOptions;
+    theme?: PresentationThemeOptions;
     /**
      * 幻灯片主题相关设置
      */
@@ -7303,6 +7394,7 @@ export declare interface SheetFormOptions extends EditorFeatureConfig {
     }) => Promise<{
         guid: string;
         id: number;
+        fullUrl?: string;
     }>;
     /**
      * 获取表单文件的父级文件

package/types/diagram.d.ts

@@ -2555,18 +2555,47 @@ export declare interface EditorSocket {
     connected: boolean;
 }
 
+export declare interface EditorSpellCheckDictionaryFileConfig {
+    /** 词典文件的 aff 文件路径 */
+    aff: string;
+    /** 词典文件的 dic 文件路径 */
+    dic: string;
+}
+
 /**
  * 拼写检查相关配置
  */
 export declare interface EditorSpellCheckOptions extends EditorFeatureConfig {
     /**
-     * 字典文件 CDN 路径
+     * 拼写检查功能配置
      */
-    dictionaryCDNPath?: string;
+    spellCheck?: {
+        /**
+         * 拼写检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查所需要的字典文件 CDN 域名
+         */
+        dictionaryCDNHost?: string;
+        /**
+         * 自定义拼写检查词典, 用于覆盖内置的默认词典
+         */
+        customDictionary?: Partial<Record<EditorLanguage, EditorSpellCheckDictionaryFileConfig>>;
+    };
     /**
-     * 拼写检查API的URL,必须使用绝对路径
+     * 语法检查功能配置
      */
-    url?: string;
+    grammarCheck?: {
+        /**
+         * 语法检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查API的URL,必须使用绝对路径
+         */
+        url?: string;
+    };
 }
 
 /**
@@ -3628,8 +3657,6 @@ export declare interface MenuItemConfig {
     };
     /** 边框 */
     border: BorderConfig;
-    /** 圆角 */
-    borderRadius: string;
     /** 布局 */
     layout: {
         /** 内边距 */

package/types/docs.d.ts

@@ -432,6 +432,24 @@ 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;
+
 /**
  * 文档信息配置项，用于显示在文档信息弹窗中的内容
  */
@@ -582,14 +600,31 @@ export declare interface DocsSDKOptions extends EditorOptions {
         linespacing: string;
         size: string;
     };
+    fonts?: EditorFontsOptions;
     footer?: {
         logo?: string;
         viewsText?: string;
     };
+    /**
+     * UI主题相关设置
+     */
+    theme: DocsThemeOptions;
     /**
      * 错误处理回调
      */
     errorHandler?: (context: string, err: Error, extra?: Record<string, string>) => void;
+    /**
+     * 是否启用拼写和语法检查功能，默认 false
+     */
+    enableSpellChecker?: boolean;
+    /**
+     * Docs 套件的卡点/权限检查函数（可选）。
+     *
+     * @remarks
+     * - 由宿主环境提供（如 lizard-service-iframe-sdk 的 `createCheckPermission`）。
+     * - 用于实现 `paste_limit_rdoc` 等卡点能力（例如粘贴前长度限制）。
+     */
+    checkPermission?: DocsCheckPermission;
 }
 
 /**
@@ -640,6 +675,35 @@ export declare interface DocsSelection {
     insertHtml: (html: string) => DocsRangeValue;
 }
 
+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>;
+
 /** Dropdown 按钮配置 */
 export declare interface DropdownButtonConfig {
     /** 颜色 */
@@ -2685,18 +2749,47 @@ export declare interface EditorSocket {
     connected: boolean;
 }
 
+export declare interface EditorSpellCheckDictionaryFileConfig {
+    /** 词典文件的 aff 文件路径 */
+    aff: string;
+    /** 词典文件的 dic 文件路径 */
+    dic: string;
+}
+
 /**
  * 拼写检查相关配置
  */
 export declare interface EditorSpellCheckOptions extends EditorFeatureConfig {
     /**
-     * 字典文件 CDN 路径
+     * 拼写检查功能配置
      */
-    dictionaryCDNPath?: string;
+    spellCheck?: {
+        /**
+         * 拼写检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查所需要的字典文件 CDN 域名
+         */
+        dictionaryCDNHost?: string;
+        /**
+         * 自定义拼写检查词典, 用于覆盖内置的默认词典
+         */
+        customDictionary?: Partial<Record<EditorLanguage, EditorSpellCheckDictionaryFileConfig>>;
+    };
     /**
-     * 拼写检查API的URL,必须使用绝对路径
+     * 语法检查功能配置
      */
-    url?: string;
+    grammarCheck?: {
+        /**
+         * 语法检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查API的URL,必须使用绝对路径
+         */
+        url?: string;
+    };
 }
 
 /**
@@ -3758,8 +3851,6 @@ export declare interface MenuItemConfig {
     };
     /** 边框 */
     border: BorderConfig;
-    /** 圆角 */
-    borderRadius: string;
     /** 布局 */
     layout: {
         /** 内边距 */

package/types/docx.d.ts

@@ -978,7 +978,7 @@ export declare interface DocxSDKOptions extends EditorOptions {
     /**
      * 主题字体相关配置
      */
-    theme: DocxThemeOptions;
+    theme?: DocxThemeOptions;
     /**
      * 工具栏设置
      */
@@ -3859,18 +3859,47 @@ export declare interface EditorSocket {
     connected: boolean;
 }
 
+export declare interface EditorSpellCheckDictionaryFileConfig {
+    /** 词典文件的 aff 文件路径 */
+    aff: string;
+    /** 词典文件的 dic 文件路径 */
+    dic: string;
+}
+
 /**
  * 拼写检查相关配置
  */
 export declare interface EditorSpellCheckOptions extends EditorFeatureConfig {
     /**
-     * 字典文件 CDN 路径
+     * 拼写检查功能配置
      */
-    dictionaryCDNPath?: string;
+    spellCheck?: {
+        /**
+         * 拼写检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查所需要的字典文件 CDN 域名
+         */
+        dictionaryCDNHost?: string;
+        /**
+         * 自定义拼写检查词典, 用于覆盖内置的默认词典
+         */
+        customDictionary?: Partial<Record<EditorLanguage, EditorSpellCheckDictionaryFileConfig>>;
+    };
     /**
-     * 拼写检查API的URL,必须使用绝对路径
+     * 语法检查功能配置
      */
-    url?: string;
+    grammarCheck?: {
+        /**
+         * 语法检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查API的URL,必须使用绝对路径
+         */
+        url?: string;
+    };
 }
 
 /**
@@ -4932,8 +4961,6 @@ export declare interface MenuItemConfig {
     };
     /** 边框 */
     border: BorderConfig;
-    /** 圆角 */
-    borderRadius: string;
     /** 布局 */
     layout: {
         /** 内边距 */

package/types/form.d.ts

@@ -2491,18 +2491,47 @@ export declare interface EditorSocket {
     connected: boolean;
 }
 
+export declare interface EditorSpellCheckDictionaryFileConfig {
+    /** 词典文件的 aff 文件路径 */
+    aff: string;
+    /** 词典文件的 dic 文件路径 */
+    dic: string;
+}
+
 /**
  * 拼写检查相关配置
  */
 export declare interface EditorSpellCheckOptions extends EditorFeatureConfig {
     /**
-     * 字典文件 CDN 路径
+     * 拼写检查功能配置
      */
-    dictionaryCDNPath?: string;
+    spellCheck?: {
+        /**
+         * 拼写检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查所需要的字典文件 CDN 域名
+         */
+        dictionaryCDNHost?: string;
+        /**
+         * 自定义拼写检查词典, 用于覆盖内置的默认词典
+         */
+        customDictionary?: Partial<Record<EditorLanguage, EditorSpellCheckDictionaryFileConfig>>;
+    };
     /**
-     * 拼写检查API的URL,必须使用绝对路径
+     * 语法检查功能配置
      */
-    url?: string;
+    grammarCheck?: {
+        /**
+         * 语法检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查API的URL,必须使用绝对路径
+         */
+        url?: string;
+    };
 }
 
 /**
@@ -3713,8 +3742,6 @@ export declare interface MenuItemConfig {
     };
     /** 边框 */
     border: BorderConfig;
-    /** 圆角 */
-    borderRadius: string;
     /** 布局 */
     layout: {
         /** 内边距 */
@@ -4645,7 +4672,9 @@ export declare interface UnauthedFormSDK {
 export declare interface UnauthedFormSDKOption {
     container: HTMLElement;
     /** 主题相关设置 */
-    theme: EditorThemeOptions;
+    theme?: EditorThemeOptions;
+    /** i18n 相关设置 */
+    i18n?: EditorI18nOptions;
     filePicker?: EditorAttachmentOptions['picker'];
     fileUploader?: EditorAttachmentOptions['uploader'];
     /** 填写页无图片/附件的预览、下载等操作，也不存在权限判断，仅有对文件类型的限制，故简化配置项 */

package/types/mindmap.d.ts

@@ -2506,18 +2506,47 @@ export declare interface EditorSocket {
     connected: boolean;
 }
 
+export declare interface EditorSpellCheckDictionaryFileConfig {
+    /** 词典文件的 aff 文件路径 */
+    aff: string;
+    /** 词典文件的 dic 文件路径 */
+    dic: string;
+}
+
 /**
  * 拼写检查相关配置
  */
 export declare interface EditorSpellCheckOptions extends EditorFeatureConfig {
     /**
-     * 字典文件 CDN 路径
+     * 拼写检查功能配置
      */
-    dictionaryCDNPath?: string;
+    spellCheck?: {
+        /**
+         * 拼写检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查所需要的字典文件 CDN 域名
+         */
+        dictionaryCDNHost?: string;
+        /**
+         * 自定义拼写检查词典, 用于覆盖内置的默认词典
+         */
+        customDictionary?: Partial<Record<EditorLanguage, EditorSpellCheckDictionaryFileConfig>>;
+    };
     /**
-     * 拼写检查API的URL,必须使用绝对路径
+     * 语法检查功能配置
      */
-    url?: string;
+    grammarCheck?: {
+        /**
+         * 语法检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查API的URL,必须使用绝对路径
+         */
+        url?: string;
+    };
 }
 
 /**
@@ -3579,8 +3608,6 @@ export declare interface MenuItemConfig {
     };
     /** 边框 */
     border: BorderConfig;
-    /** 圆角 */
-    borderRadius: string;
     /** 布局 */
     layout: {
         /** 内边距 */

package/types/pdf.d.ts

@@ -2504,18 +2504,47 @@ export declare interface EditorSocket {
     connected: boolean;
 }
 
+export declare interface EditorSpellCheckDictionaryFileConfig {
+    /** 词典文件的 aff 文件路径 */
+    aff: string;
+    /** 词典文件的 dic 文件路径 */
+    dic: string;
+}
+
 /**
  * 拼写检查相关配置
  */
 export declare interface EditorSpellCheckOptions extends EditorFeatureConfig {
     /**
-     * 字典文件 CDN 路径
+     * 拼写检查功能配置
      */
-    dictionaryCDNPath?: string;
+    spellCheck?: {
+        /**
+         * 拼写检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查所需要的字典文件 CDN 域名
+         */
+        dictionaryCDNHost?: string;
+        /**
+         * 自定义拼写检查词典, 用于覆盖内置的默认词典
+         */
+        customDictionary?: Partial<Record<EditorLanguage, EditorSpellCheckDictionaryFileConfig>>;
+    };
     /**
-     * 拼写检查API的URL,必须使用绝对路径
+     * 语法检查功能配置
      */
-    url?: string;
+    grammarCheck?: {
+        /**
+         * 语法检查功能是否被禁用
+         */
+        disabled?: boolean;
+        /**
+         * 拼写检查API的URL,必须使用绝对路径
+         */
+        url?: string;
+    };
 }
 
 /**
@@ -3577,8 +3606,6 @@ export declare interface MenuItemConfig {
     };
     /** 边框 */
     border: BorderConfig;
-    /** 圆角 */
-    borderRadius: string;
     /** 布局 */
     layout: {
         /** 内边距 */