@lark-project/js-sdk 2.0.1-alpha.9 → 2.0.2-dev.1

package/CHANGELOG.md

@@ -1,4 +1,17 @@
 # Change Log
+## 2.0.6 (2024/09/12)
+- 「Add」新增 Fullscreen Modal
+
+## 2.0.5 (2024/08/13)
+- 「Add」新增 Button Context
+
+## 2.0.4（2024/08/06）
+- 「Add」新增 WorkItemFinder
+
+## 2.0.3（2024/07/22）
+- 「Add」新增 Control Context
+- 「Add」新增 NotSupportedError
+
 ## 2.0.2（2024/07/11）
 - 「Add」新增 ContainerModal
 - 「Add」新增 Intercept

package/dist/es/index.js

@@ -51,7 +51,7 @@ _a = IMPL_KEY;
 /**
  * @internal
  */
-Context[_a] = "Context";
+Context[_a] = "context";
 
 // src/model/Space.ts
 var _a2;
@@ -260,9 +260,9 @@ _a12 = IMPL_KEY;
  */
 RichTextEditor[_a12] = "richTextEditor";
 
-// src/biz/Utils.ts
+// src/biz/WorkItemFinder.ts
 var _a13;
-var Utils = class extends BaseModel {
+var WorkItemFinder = class extends BaseModel {
   /**
    * @internal
    */
@@ -274,10 +274,42 @@ _a13 = IMPL_KEY;
 /**
  * @internal
  */
-Utils[_a13] = "utils";
+WorkItemFinder[_a13] = "workItemFinder";
 
-// src/features/ContainerModal.ts
+// src/biz/Utils.ts
 var _a14;
+var Utils = class extends BaseModel {
+  /**
+   * @internal
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a14 = IMPL_KEY;
+/**
+ * @internal
+ */
+Utils[_a14] = "utils";
+
+// src/biz/Broadcast.ts
+var _a15;
+var Broadcast = class extends BaseModel {
+  /**
+   * @internal
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a15 = IMPL_KEY;
+/**
+ * @internal
+ */
+Broadcast[_a15] = "broadcast";
+
+// src/features/ContainerModal.ts
+var _a16;
 var ContainerModal = class extends BaseModel {
   /**
    * 加载数据
@@ -286,14 +318,14 @@ var ContainerModal = class extends BaseModel {
     throw new Error("not implemented");
   }
 };
-_a14 = IMPL_KEY;
+_a16 = IMPL_KEY;
 /**
  * @internal
  */
-ContainerModal[_a14] = "ContainerModal";
+ContainerModal[_a16] = "containerModal";
 
 // src/features/Intercept.ts
-var _a15;
+var _a17;
 var Intercept = class extends BaseModel {
   /**
    * 加载数据
@@ -302,14 +334,14 @@ var Intercept = class extends BaseModel {
     throw new Error("not implemented");
   }
 };
-_a15 = IMPL_KEY;
+_a17 = IMPL_KEY;
 /**
  * @internal
  */
-Intercept[_a15] = "Intercept";
+Intercept[_a17] = "intercept";
 
 // src/features/Control.ts
-var _a16;
+var _a18;
 var Control = class extends BaseModel {
   /**
    * 加载数据
@@ -318,11 +350,91 @@ var Control = class extends BaseModel {
     throw new Error("not implemented");
   }
 };
-_a16 = IMPL_KEY;
+_a18 = IMPL_KEY;
 /**
  * @internal
  */
-Control[_a16] = "Control";
+Control[_a18] = "control";
+
+// src/features/Button.ts
+var _a19;
+var Button = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a19 = IMPL_KEY;
+/**
+ * @internal
+ */
+Button[_a19] = "button";
+
+// src/features/Configuration.ts
+var _a20;
+var Configuration = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a20 = IMPL_KEY;
+/**
+ * @internal
+ */
+Configuration[_a20] = "configuration";
+
+// src/features/Page.ts
+var _a21;
+var Page = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a21 = IMPL_KEY;
+/**
+ * @internal
+ */
+Page[_a21] = "page";
+
+// src/features/Tab.ts
+var _a22;
+var Tab = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a22 = IMPL_KEY;
+/**
+ * @internal
+ */
+Tab[_a22] = "tab";
+
+// src/features/View.ts
+var _a23;
+var View = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a23 = IMPL_KEY;
+/**
+ * @internal
+ */
+View[_a23] = "view";
 
 // src/client.ts
 function getImplClass(decl, impls) {
@@ -353,6 +465,41 @@ var _SDKClient = class {
   get control() {
     return getImplValue(Control, this._meegoBizHub);
   }
+  /**
+   * 按钮点位容器特有能力
+   * only 2.0
+   */
+  get button() {
+    return getImplValue(Button, this._meegoBizHub);
+  }
+  /**
+   * 配置点位容器特有能力
+   * only 2.0
+   */
+  get configuration() {
+    return getImplValue(Configuration, this._meegoBizHub);
+  }
+  /**
+   * 导航点位容器特有能力
+   * only 2.0
+   */
+  get page() {
+    return getImplValue(Page, this._meegoBizHub);
+  }
+  /**
+   * tab 点位容器特有能力
+   * only 2.0
+   */
+  get tab() {
+    return getImplValue(Tab, this._meegoBizHub);
+  }
+  /**
+   * 视图点位容器特有能力
+   * only 2.0
+   */
+  get view() {
+    return getImplValue(View, this._meegoBizHub);
+  }
   /**
    * 应用导航
    */
@@ -384,6 +531,13 @@ var _SDKClient = class {
   get richTextEditor() {
     return getImplValue(RichTextEditor, this._meegoBizHub);
   }
+  /**
+   * 工作项实例筛选器
+   * only web 2.0
+   */
+  get workItemFinder() {
+    return getImplValue(WorkItemFinder, this._meegoBizHub);
+  }
   /**
    * 模态框
    */
@@ -459,7 +613,7 @@ var SDKClient = _SDKClient;
 /**
  * SDK 版本号
  */
-SDKClient.version = "2.0.1-alpha.9";
+SDKClient.version = "2.0.2-dev.1";
 
 // src/types/biz.ts
 var AttributeType = /* @__PURE__ */ ((AttributeType2) => {
@@ -593,13 +747,27 @@ var InvalidParamsError = class extends CustomError {
   }
 };
 
+// src/errors/NotSupportedError.ts
+var NotSupportedError = class extends CustomError {
+  constructor(options) {
+    super({
+      message: "the api is not supported",
+      originMessage: options.originMessage
+    });
+    this.name = "NotSupportedError";
+  }
+};
+
 // src/index.ts
 var src_default = SDKClient;
 export {
   ActionSheet,
   AttributeType,
+  Broadcast,
+  Button,
   ButtonScene,
   Clipboard,
+  Configuration,
   ContainerModal,
   Context,
   Control,
@@ -617,14 +785,19 @@ export {
   NoAuthError,
   NodeStatus,
   NotFoundError,
+  NotSupportedError,
   OutOfLimitError,
+  Page,
   RichTextEditor,
   SDKClient,
   Space,
   Storage,
+  Tab,
   Toast,
   Utils,
+  View,
   WorkItem,
+  WorkItemFinder,
   WorkObject,
   src_default as default
 };

package/dist/lib/index.js

@@ -50,8 +50,11 @@ var src_exports = {};
 __export(src_exports, {
   ActionSheet: () => ActionSheet,
   AttributeType: () => AttributeType,
+  Broadcast: () => Broadcast,
+  Button: () => Button,
   ButtonScene: () => ButtonScene,
   Clipboard: () => Clipboard,
+  Configuration: () => Configuration,
   ContainerModal: () => ContainerModal,
   Context: () => Context,
   Control: () => Control,
@@ -69,14 +72,19 @@ __export(src_exports, {
   NoAuthError: () => NoAuthError,
   NodeStatus: () => NodeStatus,
   NotFoundError: () => NotFoundError,
+  NotSupportedError: () => NotSupportedError,
   OutOfLimitError: () => OutOfLimitError,
+  Page: () => Page,
   RichTextEditor: () => RichTextEditor,
   SDKClient: () => SDKClient,
   Space: () => Space,
   Storage: () => Storage,
+  Tab: () => Tab,
   Toast: () => Toast,
   Utils: () => Utils,
+  View: () => View,
   WorkItem: () => WorkItem,
+  WorkItemFinder: () => WorkItemFinder,
   WorkObject: () => WorkObject,
   default: () => src_default
 });
@@ -105,7 +113,7 @@ _a = IMPL_KEY;
 /**
  * @internal
  */
-Context[_a] = "Context";
+Context[_a] = "context";
 
 // src/model/Space.ts
 var _a2;
@@ -314,9 +322,9 @@ _a12 = IMPL_KEY;
  */
 RichTextEditor[_a12] = "richTextEditor";
 
-// src/biz/Utils.ts
+// src/biz/WorkItemFinder.ts
 var _a13;
-var Utils = class extends BaseModel {
+var WorkItemFinder = class extends BaseModel {
   /**
    * @internal
    */
@@ -328,10 +336,42 @@ _a13 = IMPL_KEY;
 /**
  * @internal
  */
-Utils[_a13] = "utils";
+WorkItemFinder[_a13] = "workItemFinder";
 
-// src/features/ContainerModal.ts
+// src/biz/Utils.ts
 var _a14;
+var Utils = class extends BaseModel {
+  /**
+   * @internal
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a14 = IMPL_KEY;
+/**
+ * @internal
+ */
+Utils[_a14] = "utils";
+
+// src/biz/Broadcast.ts
+var _a15;
+var Broadcast = class extends BaseModel {
+  /**
+   * @internal
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a15 = IMPL_KEY;
+/**
+ * @internal
+ */
+Broadcast[_a15] = "broadcast";
+
+// src/features/ContainerModal.ts
+var _a16;
 var ContainerModal = class extends BaseModel {
   /**
    * 加载数据
@@ -340,14 +380,14 @@ var ContainerModal = class extends BaseModel {
     throw new Error("not implemented");
   }
 };
-_a14 = IMPL_KEY;
+_a16 = IMPL_KEY;
 /**
  * @internal
  */
-ContainerModal[_a14] = "ContainerModal";
+ContainerModal[_a16] = "containerModal";
 
 // src/features/Intercept.ts
-var _a15;
+var _a17;
 var Intercept = class extends BaseModel {
   /**
    * 加载数据
@@ -356,14 +396,14 @@ var Intercept = class extends BaseModel {
     throw new Error("not implemented");
   }
 };
-_a15 = IMPL_KEY;
+_a17 = IMPL_KEY;
 /**
  * @internal
  */
-Intercept[_a15] = "Intercept";
+Intercept[_a17] = "intercept";
 
 // src/features/Control.ts
-var _a16;
+var _a18;
 var Control = class extends BaseModel {
   /**
    * 加载数据
@@ -372,11 +412,91 @@ var Control = class extends BaseModel {
     throw new Error("not implemented");
   }
 };
-_a16 = IMPL_KEY;
+_a18 = IMPL_KEY;
 /**
  * @internal
  */
-Control[_a16] = "Control";
+Control[_a18] = "control";
+
+// src/features/Button.ts
+var _a19;
+var Button = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a19 = IMPL_KEY;
+/**
+ * @internal
+ */
+Button[_a19] = "button";
+
+// src/features/Configuration.ts
+var _a20;
+var Configuration = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a20 = IMPL_KEY;
+/**
+ * @internal
+ */
+Configuration[_a20] = "configuration";
+
+// src/features/Page.ts
+var _a21;
+var Page = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a21 = IMPL_KEY;
+/**
+ * @internal
+ */
+Page[_a21] = "page";
+
+// src/features/Tab.ts
+var _a22;
+var Tab = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a22 = IMPL_KEY;
+/**
+ * @internal
+ */
+Tab[_a22] = "tab";
+
+// src/features/View.ts
+var _a23;
+var View = class extends BaseModel {
+  /**
+   * 加载数据
+   */
+  static load() {
+    throw new Error("not implemented");
+  }
+};
+_a23 = IMPL_KEY;
+/**
+ * @internal
+ */
+View[_a23] = "view";
 
 // src/client.ts
 function getImplClass(decl, impls) {
@@ -407,6 +527,41 @@ var _SDKClient = class {
   get control() {
     return getImplValue(Control, this._meegoBizHub);
   }
+  /**
+   * 按钮点位容器特有能力
+   * only 2.0
+   */
+  get button() {
+    return getImplValue(Button, this._meegoBizHub);
+  }
+  /**
+   * 配置点位容器特有能力
+   * only 2.0
+   */
+  get configuration() {
+    return getImplValue(Configuration, this._meegoBizHub);
+  }
+  /**
+   * 导航点位容器特有能力
+   * only 2.0
+   */
+  get page() {
+    return getImplValue(Page, this._meegoBizHub);
+  }
+  /**
+   * tab 点位容器特有能力
+   * only 2.0
+   */
+  get tab() {
+    return getImplValue(Tab, this._meegoBizHub);
+  }
+  /**
+   * 视图点位容器特有能力
+   * only 2.0
+   */
+  get view() {
+    return getImplValue(View, this._meegoBizHub);
+  }
   /**
    * 应用导航
    */
@@ -438,6 +593,13 @@ var _SDKClient = class {
   get richTextEditor() {
     return getImplValue(RichTextEditor, this._meegoBizHub);
   }
+  /**
+   * 工作项实例筛选器
+   * only web 2.0
+   */
+  get workItemFinder() {
+    return getImplValue(WorkItemFinder, this._meegoBizHub);
+  }
   /**
    * 模态框
    */
@@ -513,7 +675,7 @@ var SDKClient = _SDKClient;
 /**
  * SDK 版本号
  */
-SDKClient.version = "2.0.1-alpha.9";
+SDKClient.version = "2.0.2-dev.1";
 
 // src/types/biz.ts
 var AttributeType = /* @__PURE__ */ ((AttributeType2) => {
@@ -647,14 +809,28 @@ var InvalidParamsError = class extends CustomError {
   }
 };
 
+// src/errors/NotSupportedError.ts
+var NotSupportedError = class extends CustomError {
+  constructor(options) {
+    super({
+      message: "the api is not supported",
+      originMessage: options.originMessage
+    });
+    this.name = "NotSupportedError";
+  }
+};
+
 // src/index.ts
 var src_default = SDKClient;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionSheet,
   AttributeType,
+  Broadcast,
+  Button,
   ButtonScene,
   Clipboard,
+  Configuration,
   ContainerModal,
   Context,
   Control,
@@ -672,13 +848,18 @@ var src_default = SDKClient;
   NoAuthError,
   NodeStatus,
   NotFoundError,
+  NotSupportedError,
   OutOfLimitError,
+  Page,
   RichTextEditor,
   SDKClient,
   Space,
   Storage,
+  Tab,
   Toast,
   Utils,
+  View,
   WorkItem,
+  WorkItemFinder,
   WorkObject
 });

package/dist/types/index.d.ts

@@ -328,10 +328,10 @@ declare enum ButtonScene {
     workItemNode = 4
 }
 /**
- * 按钮构成
- * 可被配置于详情页工具栏，视图页、视图工具栏、用于操作单个或多个工作项
+ * 工作项实例按钮上下文
+ * 适用场景：工作项-更多 / 节点-更多 / 节点流转
  */
-interface ButtonFeatureContext {
+interface WorkItemButtonFeatureContext {
     /**
      * 空间标识
      */
@@ -345,10 +345,34 @@ interface ButtonFeatureContext {
      */
     workItemId: number;
     /**
-     * 按钮位置
+     * 按钮所属节点标识
+     * 适用场景：节点-更多 / 节点流转
+     */
+    nodeId?: string;
+}
+/**
+ * 新建按钮上下文
+ */
+interface CreateButtonFeatureContext {
+    /**
+     * 空间标识
+     */
+    spaceId: string;
+    /**
+     * 工作项类型标识
+     * 适用场景：新建按钮出现在视图页时，该字段才有数据
+     */
+    workObjectId?: string;
+    /**
+     * 视图标识
+     * 适用场景：新建按钮出现在视图页时，该字段才有数据
      */
-    buttonScene: ButtonScene;
+    viewId?: string;
 }
+/**
+ * 按钮构成
+ */
+type ButtonFeatureContext = WorkItemButtonFeatureContext | CreateButtonFeatureContext;
 /**
  * 内嵌页面构成
  * 一个单独的导航入口+内嵌页面
@@ -359,6 +383,15 @@ interface PageFeatureContext {
      */
     spaceId: string;
 }
+/**
+ * 配置页面构成
+ */
+interface ConfigFeatureContext {
+    /**
+     * 空间标识
+     */
+    spaceId: string;
+}
 /**
  * 详情页 Tab 构成
  * 工作项详情页中的 Tab 页面
@@ -374,6 +407,7 @@ interface TabFeatureContext {
     workObjectId: string;
     /**
      * 工作项实例唯一标识
+     * 适用场景：仅在工作项实例场景下，该字段才有数据，在工作项配置侧该字段为空
      */
     workItemId: number;
 }
@@ -418,6 +452,11 @@ interface ControlFeatureContext {
      * 详情页可能为空，不推荐强依赖 UUID 读取自有数据
      */
     UUID?: string;
+    /**
+     * 当前节点标识
+     * 适用场景：详情页为节点流时，且当前控件位于节点表单内，该字段才有数据
+     */
+    nodeId?: string;
 }
 /**
  * 拦截事件类型
@@ -461,9 +500,20 @@ interface InterceptFeatureContext<T> {
     eventType: InterceptEvent;
     workItems: Array<BriefWorkItem & {
         /**
-         * 当前触发事件
+         * 当前触发事件，不同事件类型对应不同的 changedValue
          */
-        changedValue?: any;
+        changedValue?: {
+            fieldInfo?: Array<{
+                fieldKey: string;
+                fieldType?: string;
+                alias?: string;
+                beforeFieldValue?: unknown;
+                afterFieldValue?: unknown;
+            }>;
+            nodeInfo?: any;
+            subTaskInfo?: any;
+            transitionInfo?: any;
+        };
     }>;
     customData: T;
 }
@@ -472,6 +522,7 @@ interface InterceptFeatureContext<T> {
  * @internal
  */
 type unwatch = () => void;
+type Off = unwatch;
 
 type IIgnore = string | RegExp | ((value: string) => boolean);
 interface IPluginCustomBuildConfig {
@@ -545,6 +596,12 @@ declare abstract class Context extends BaseModel {
      * @param callback
      */
     abstract watch(callback: (nextValue: Context) => void): unwatch;
+    /**
+     * only web 2.0
+     * 用于获取插件内设置的上下文数据
+     * 例如：在 sdk.modal.open 时传入的 context，可以通过该方法来获取
+     */
+    abstract getCustomContext<Context>(): Promise<Context>;
 }
 
 /**
@@ -982,9 +1039,9 @@ declare abstract class ActionSheet extends BaseModel {
 }
 
 /**
- * Modal 展示配置
+ * Modal confirm 展示配置
  */
-interface ModalOptions {
+interface ModalConfirmOptions {
     /**
      * 标题
      * title 和 content 不可同时为空
@@ -1011,6 +1068,40 @@ interface ModalOptions {
      */
     cancelText?: string;
 }
+/**
+ * Modal 展示配置
+ */
+interface ModalOptions<Context> {
+    /**
+     * 宽度
+     * 默认: 448
+     */
+    width?: number;
+    /**
+     * 高度
+     */
+    height?: number;
+    /**
+     * 是否全屏
+     * 全屏时 width / height 无效
+     */
+    fullScreen?: boolean;
+    /**
+     * 是否允许通过点击遮罩来关闭对话框
+     */
+    maskClosable?: boolean;
+    /**
+     * 传入 Modal 内的上下文数据
+     * 注：传入的数据在 Modal 内是通过 sdk.containerModal.getContext() 来获取的
+     */
+    context?: Context;
+    /**
+     * 响应弹窗内调用的 sdk.containerModal.submit 方法
+     * @param params 弹窗内调用的 sdk.containerModal.submit 的方法时传入的自定义参数
+     * @returns 调用 sdk.containerModal.submit 返回的自定义值
+     */
+    onSubmit?: (params: unknown) => Promise<unknown>;
+}
 /**
  * @public
  * Modal 用于等待用户响应、告知用户重要信息或在不丢失上下文的情况下展示更多信息
@@ -1025,16 +1116,25 @@ declare abstract class Modal extends BaseModel {
      */
     private static load;
     /**
-     * 打开模态框
+     * 使用模态框 confirm
      * @param options
      * @param callback
      *    confirmed 点击了确认
      *    canceled  点击了取消
      */
-    abstract show(options: string | ModalOptions, callback: (result: {
+    abstract confirm(options: string | ModalConfirmOptions, callback: (result: {
         confirmed: boolean;
         canceled: boolean;
     }) => void): Promise<void>;
+    /**
+     * only web 2.0
+     * 打开自定义内容的模态框
+     * @param options
+     * @returns 当前打开 Modal 的关闭方法
+     */
+    abstract open<Context>(options: ModalOptions<Context>): Promise<{
+        close: () => void;
+    }>;
 }
 
 /**
@@ -1106,7 +1206,62 @@ declare abstract class RichTextEditor extends BaseModel {
     abstract show(options: RichTextEditorOptions, callback: (result: {
         confirmed: boolean;
         canceled: boolean;
-        content?: RichTextEditorContent;
+        nextValue?: RichTextEditorContent;
+    }) => void): Promise<void>;
+}
+
+/**
+ * WorkItemFinder 配置
+ */
+interface WorkItemFinderOptions {
+    /**
+     * 空间标识
+     */
+    spaceId: string;
+    /**
+     * 工作项类型标识
+     */
+    workObjectId: string;
+    /**
+     * 筛选器标题，仅用于展示
+     */
+    title?: string;
+    /**
+     * 搜索条件标识
+     * 如为空则生成新 key，不为空则会覆写
+     * searchId 与 workObjectId | spaceId 不匹配则会异常
+     */
+    searchId?: string;
+    /**
+     * 默认 true，控制 searchId 的筛选条件是否回填到筛选器
+     */
+    backfill?: boolean;
+}
+/**
+ * @public
+ * WorkItemFinder 用于生成工作项实例筛选条件的面板
+ */
+declare abstract class WorkItemFinder extends BaseModel {
+    /**
+     * @internal
+     */
+    protected static [IMPL_KEY]: string;
+    /**
+     * @internal
+     */
+    private static load;
+    /**
+     * 打开工作项实例筛选条件面板
+     * @param options
+     * @param callback
+     *    confirmed 点击了确认
+     *    canceled  点击了取消
+     *    searchId 当点击确认时，返回筛选条件标识 searchId
+     */
+    abstract open(options: WorkItemFinderOptions, callback: (result: {
+        confirmed: boolean;
+        canceled: boolean;
+        searchId?: string;
     }) => void): Promise<void>;
 }
 
@@ -1143,6 +1298,33 @@ declare abstract class Utils extends BaseModel {
     }>;
 }
 
+interface IBroadcastDetailPageWorkItemValueChangedEvent {
+    id: number;
+    spaceId: string;
+    workObjectId: string;
+    changedKeys: Array<AttributeType | string>;
+}
+/**
+ * @public
+ * 事件中心
+ */
+declare abstract class Broadcast extends BaseModel {
+    /**
+     * @internal
+     */
+    protected static [IMPL_KEY]: string;
+    /**
+     * @internal
+     */
+    private static load;
+    /**
+     * 监听详情页工作项值变化
+     * @param watchKeys 监听的工作项属性 / 字段 ID 列表
+     * @param callback 当监听值发生变化时触发
+     */
+    abstract onDetailPageWorkItemValueChanged(watchKeys: Array<string | AttributeType>, callback: (changed: IBroadcastDetailPageWorkItemValueChangedEvent) => void): Off;
+}
+
 /**
  * @public
  * 插件容器模态框
@@ -1157,9 +1339,16 @@ declare abstract class ContainerModal extends BaseModel {
      */
     static load(): Promise<ContainerModal>;
     /**
+     * only web 2.0
+     * 只存在于 modal.open 打开的容器内
+     * submit 调用的是 sdk.modal.open 传入的 onSubmit 方法
+     */
+    abstract submit?: <Params, Result>(params: Params) => Promise<Result>;
+    /**
+     * mobile version ≥ 7.22.0
      * 关闭插件当前激活的容器模态框
      */
-    abstract closeModal: Promise<void>;
+    abstract close(): Promise<void>;
 }
 
 /**
@@ -1176,9 +1365,10 @@ declare abstract class Intercept extends BaseModel {
      */
     static load(): Promise<Intercept>;
     /**
+     * mobile version ≥ 7.22.0
      * 获取当前触发的拦截事件上下文
      */
-    abstract getEventCtx<T = any>(): Promise<InterceptFeatureContext<T>>;
+    abstract getContext<T = any>(): Promise<InterceptFeatureContext<T>>;
 }
 
 /**
@@ -1195,9 +1385,118 @@ declare abstract class Control extends BaseModel {
      */
     static load(): Promise<Control>;
     /**
-     * 获取当前控件的上下文
+     * mobile version ≥ 7.25.0
+     * 获取当前控件所在的上下文
      */
     abstract getContext(): Promise<ControlFeatureContext>;
+    /**
+     * 获取新建工作项表单项的值
+     * @param keys 需要获取的工作项属性 / 字段 ID 列表，一次限制读取 10 个 keys
+     */
+    abstract getCreateWorkItemFormItemValues(keys: Array<string | AttributeType>): Promise<Record<string | AttributeType, any>>;
+    /**
+     * only web 2.0
+     * 监听新建工作项表单项值变化
+     * @param watchKeys 需要监听的工作项属性 / 字段 ID 列表，一次限制读取 10 个 keys
+     * @param callback 当监听值发生变化时触发，changedKeys 为变化的 keys
+     */
+    abstract onCreateWorkItemFormValueChanged(watchKeys: Array<string | AttributeType>, callback: (changedKeys: Array<string | AttributeType>) => void): Off;
+}
+
+/**
+ * @public
+ * 按钮
+ */
+declare abstract class Button extends BaseModel {
+    /**
+     * @internal
+     */
+    protected static [IMPL_KEY]: string;
+    /**
+     * 加载数据
+     */
+    static load(): Promise<Button>;
+    /**
+     * mobile version ≥ 7.24.0
+     * 获取当前按钮的上下文
+     */
+    abstract getContext(): Promise<ButtonFeatureContext>;
+}
+
+/**
+ * @public
+ * 控件
+ */
+declare abstract class Configuration extends BaseModel {
+    /**
+     * @internal
+     */
+    protected static [IMPL_KEY]: string;
+    /**
+     * 加载数据
+     */
+    static load(): Promise<Configuration>;
+    /**
+     * 获取当前配置点位的上下文
+     */
+    abstract getContext(): Promise<ConfigFeatureContext>;
+}
+
+/**
+ * @public
+ * 控件
+ */
+declare abstract class Page extends BaseModel {
+    /**
+     * @internal
+     */
+    protected static [IMPL_KEY]: string;
+    /**
+     * 加载数据
+     */
+    static load(): Promise<Page>;
+    /**
+     * 获取当前内嵌页面的上下文
+     */
+    abstract getContext(): Promise<PageFeatureContext>;
+}
+
+/**
+ * @public
+ * 控件
+ */
+declare abstract class Tab extends BaseModel {
+    /**
+     * @internal
+     */
+    protected static [IMPL_KEY]: string;
+    /**
+     * 加载数据
+     */
+    static load(): Promise<Tab>;
+    /**
+     * 获取当前详情页 Tab 的上下文
+     */
+    abstract getContext(): Promise<TabFeatureContext>;
+}
+
+/**
+ * @public
+ * 控件
+ */
+declare abstract class View extends BaseModel {
+    /**
+     * @internal
+     */
+    protected static [IMPL_KEY]: string;
+    /**
+     * 加载数据
+     */
+    static load(): Promise<View>;
+    /**
+     * 获取当前视图的上下文
+     */
+    abstract getContext(): Promise<ViewFeatureContext>;
 }
 
 /**
@@ -1232,6 +1531,31 @@ declare class SDKClient {
      * only 2.0
      */
     get control(): Control;
+    /**
+     * 按钮点位容器特有能力
+     * only 2.0
+     */
+    get button(): Button;
+    /**
+     * 配置点位容器特有能力
+     * only 2.0
+     */
+    get configuration(): Configuration;
+    /**
+     * 导航点位容器特有能力
+     * only 2.0
+     */
+    get page(): Page;
+    /**
+     * tab 点位容器特有能力
+     * only 2.0
+     */
+    get tab(): Tab;
+    /**
+     * 视图点位容器特有能力
+     * only 2.0
+     */
+    get view(): View;
     /**
      * 应用导航
      */
@@ -1253,6 +1577,11 @@ declare class SDKClient {
      * only 2.0
      */
     get richTextEditor(): RichTextEditor;
+    /**
+     * 工作项实例筛选器
+     * only web 2.0
+     */
+    get workItemFinder(): WorkItemFinder;
     /**
      * 模态框
      */
@@ -1359,6 +1688,16 @@ declare class InvalidParamsError extends CustomError {
     });
 }
 
+/**
+ * @public
+ * API 在当前环境不支持
+ */
+declare class NotSupportedError extends CustomError {
+    constructor(options: {
+        originMessage: string;
+    });
+}
+
 /**
  * 用于飞书项目插件读取系统数据的 JSSDK
  *
@@ -1368,4 +1707,4 @@ declare class InvalidParamsError extends CustomError {
  * @packageDocumentation
  */
 
-export { ActionSheet, ActionSheetOptions, AttributeType, BizLine, BriefField, BriefNode, BriefSpace, BriefTemplate, BriefView, BriefWorkItem, BriefWorkObject, ButtonFeatureContext, ButtonScene, Clipboard, ColorScheme, ContainerModal, Context, Control, ControlFeatureContext, Field, FieldType, FlowMode, IMPL_KEY, IPluginCustomBuildConfig, IntegrationFeatureContext, Intercept, InterceptEvent, InterceptFeatureContext, InternalError, InvalidParamsError, Language, MEEGO_BIZ_HUB, Modal, ModalOptions, Navigation, NoAuthError, NodeStatus, NotFoundError, OutOfLimitError, PageFeatureContext, RichTextEditor, RichTextEditorContent, RichTextEditorOptions, Role, RoleOwners, SDKClient, SDKClientOptions, Space, Storage, TabFeatureContext, Toast, ToastOptions, User, Utils, ViewFeatureContext, WorkItem, WorkItemCreateFormPreset, WorkObject, SDKClient as default, unwatch };
+export { ActionSheet, ActionSheetOptions, AttributeType, BizLine, BriefField, BriefNode, BriefSpace, BriefTemplate, BriefView, BriefWorkItem, BriefWorkObject, Broadcast, Button, ButtonFeatureContext, ButtonScene, Clipboard, ColorScheme, ConfigFeatureContext, Configuration, ContainerModal, Context, Control, ControlFeatureContext, CreateButtonFeatureContext, Field, FieldType, FlowMode, IBroadcastDetailPageWorkItemValueChangedEvent, IMPL_KEY, IPluginCustomBuildConfig, IntegrationFeatureContext, Intercept, InterceptEvent, InterceptFeatureContext, InternalError, InvalidParamsError, Language, MEEGO_BIZ_HUB, Modal, ModalConfirmOptions, Navigation, NoAuthError, NodeStatus, NotFoundError, NotSupportedError, Off, OutOfLimitError, Page, PageFeatureContext, RichTextEditor, RichTextEditorContent, RichTextEditorOptions, Role, RoleOwners, SDKClient, SDKClientOptions, Space, Storage, Tab, TabFeatureContext, Toast, ToastOptions, User, Utils, View, ViewFeatureContext, WorkItem, WorkItemButtonFeatureContext, WorkItemCreateFormPreset, WorkItemFinder, WorkItemFinderOptions, WorkObject, SDKClient as default, unwatch };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-project/js-sdk",
-  "version": "2.0.1-alpha.9",
+  "version": "2.0.2-dev.1",
   "runtimeMinVersions": {
     "web": "2.1.0",
     "mobile": "1.1.0"