weboffice-js-sdk 2.0.3-beta.11 → 2.0.3-beta.12

package/README.md

@@ -29,8 +29,12 @@ connect({
   signature: '用您的 app id 和 secret 签发的签名',
   token: '用于您系统识别用户请求的 token',
   container: document.querySelector('#shimo-file'), // iframe 挂载的目标容器元素
-  lang: 'en' // 未指定此参数时，使用浏览器默认语言
-  userUuid：'您的uuid', // 仅在v2版本回调时需要传入(co-1.3+支持)
+  lang: 'en', // 未指定此参数时，使用浏览器默认语言
+  disableAiEntry: true, // 可选，隐藏 iframe 内 AI 入口
+  theme: {
+    name: 'light'
+  }, // 可选，透传给 iframe 内编辑器主题配置
+  userUuid：'您的uuid' // 仅在v2版本回调时需要传入(co-1.3+支持)
 }).then((shimoSDK) => {
   // ...
 })
@@ -38,6 +42,11 @@ connect({
 
 参数说明请参考 [docs/interfaces/connectoptions.md](docs/interfaces/ConnectOptions.md)。
 
+其中：
+
+- `disableAiEntry` 为可选布尔值，透传到 iframe 内 `ShimoSDK` 的 AI 入口开关能力。
+- `theme` 为可选主题对象，宿主侧仅负责透传；未传时 iframe 内仍使用默认主题配置。
+
 返回值：
 
 ```
@@ -145,6 +154,7 @@ const command = sdk.headerBars.getCommand('custom-export')
 // 命令状态（属性读写）
 command.visible = true
 command.disabled = false
+command.active = true
 
 // 外层覆盖命令点击回调（优先于 iframe 默认回调）
 command.onCommandClick = async () => {

package/dist/OfficeSDK.d.ts

@@ -463,6 +463,13 @@ export type EventCallback = (...args: any[]) => any;
 export interface SDKToastOptions {
     [key: string]: string | SDKToastOptions | undefined;
 }
+/**
+ * 透传给 iframe 编辑器的主题配置。
+ * 当前 shimo-js-sdk 仅负责跨 iframe 传输，不在宿主侧约束字段细节。
+ */
+export interface CommonThemeConfig {
+    [key: string]: unknown;
+}
 /**
  * iframe 内置加载页配置，只支持可序列化字段。
  */
@@ -587,6 +594,16 @@ export interface OfficeSDKOptions extends Omit<ContainerMethods, 'getContainerRe
      * 控制 headerbar 组件是否展示，false 表示隐藏。
      */
     headerBarsVisible?: boolean;
+    /**
+     * 是否隐藏 iframe 内 AI 入口。
+     * 对应 iframe 内 ShimoSDK 的现有 AI 入口开关能力。
+     */
+    disableAiEntry?: boolean;
+    /**
+     * 编辑器主题配置。
+     * 该参数会透传到 iframe 内各套件初始化链路；未传时保持 iframe 默认主题。
+     */
+    theme?: CommonThemeConfig;
     /**
      * docs 斜杠菜单配置。
      * 仅 docs 文件类型生效；`button.callback` 实际运行在宿主页，

package/dist/OfficeSDK.headerBars.d.ts

@@ -5,6 +5,7 @@ export declare const HEADER_BARS_METHOD: {
     readonly getCommand: "headerBars.getCommand";
     readonly setCommandVisible: "headerBars.setCommandVisible";
     readonly setCommandDisabled: "headerBars.setCommandDisabled";
+    readonly setCommandActive: "headerBars.setCommandActive";
     readonly setCommandSrc: "headerBars.setCommandSrc";
     readonly setCommandLabel: "headerBars.setCommandLabel";
     readonly setCommandEditable: "headerBars.setCommandEditable";
@@ -20,6 +21,7 @@ export interface HeaderBarsCommandDefinition {
     label?: string;
     visible?: boolean;
     disabled?: boolean;
+    active?: boolean;
     editable?: boolean;
     type?: 'action' | 'structural';
     renderType?: string;
@@ -33,6 +35,7 @@ export interface HeaderBarsCommandRef {
     readonly id: string;
     visible: boolean;
     disabled: boolean;
+    active: boolean;
     src?: string;
     label?: string;
     editable?: boolean;