@lark-project/js-sdk 2.0.4-dev.1 → 2.0.4-dev.2

package/dist/es/index.js

@@ -1,7 +1,7 @@
 
 /**
 * MIT License
-* Copyright (c) 2024 Lark Technologies Pte. Ltd.
+* Copyright (c) 2025 Lark Technologies Pte. Ltd.
 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 * The above copyright notice and this permission notice, shall be included in all copies or substantial portions of the Software.
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -624,7 +624,7 @@ var SDKClient = _SDKClient;
 /**
  * SDK 版本号
  */
-SDKClient.version = "2.0.4-dev.1";
+SDKClient.version = "2.0.4-dev.2";
 
 // src/types/biz.ts
 var AttributeType = /* @__PURE__ */ ((AttributeType2) => {
@@ -695,16 +695,16 @@ var InterceptEvent = /* @__PURE__ */ ((InterceptEvent2) => {
   InterceptEvent2[InterceptEvent2["UpdateState"] = 3001] = "UpdateState";
   return InterceptEvent2;
 })(InterceptEvent || {});
+var ComponentScheduleScene = /* @__PURE__ */ ((ComponentScheduleScene2) => {
+  ComponentScheduleScene2[ComponentScheduleScene2["ALL"] = 0] = "ALL";
+  ComponentScheduleScene2[ComponentScheduleScene2["workItemNode"] = 1] = "workItemNode";
+  ComponentScheduleScene2[ComponentScheduleScene2["scheduleTable"] = 2] = "scheduleTable";
+  return ComponentScheduleScene2;
+})(ComponentScheduleScene || {});
 var CustomComponentType = /* @__PURE__ */ ((CustomComponentType2) => {
   CustomComponentType2["Schedule"] = "schedule";
   return CustomComponentType2;
 })(CustomComponentType || {});
-var CustomComponentScene = /* @__PURE__ */ ((CustomComponentScene2) => {
-  CustomComponentScene2[CustomComponentScene2["ALL"] = 0] = "ALL";
-  CustomComponentScene2[CustomComponentScene2["workItemNode"] = 1] = "workItemNode";
-  CustomComponentScene2[CustomComponentScene2["scheduleTable"] = 2] = "scheduleTable";
-  return CustomComponentScene2;
-})(CustomComponentScene || {});
 
 // src/errors/CustomError.ts
 var CustomError = class extends Error {
@@ -788,12 +788,12 @@ export {
   Button,
   ButtonScene,
   Clipboard,
+  ComponentScheduleScene,
   Configuration,
   ContainerModal,
   Context,
   Control,
   CustomComponent,
-  CustomComponentScene,
   CustomComponentType,
   Field,
   FieldType,

package/dist/lib/index.js

@@ -1,7 +1,7 @@
 
 /**
 * MIT License
-* Copyright (c) 2024 Lark Technologies Pte. Ltd.
+* Copyright (c) 2025 Lark Technologies Pte. Ltd.
 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 * The above copyright notice and this permission notice, shall be included in all copies or substantial portions of the Software.
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -53,12 +53,12 @@ __export(src_exports, {
   Button: () => Button,
   ButtonScene: () => ButtonScene,
   Clipboard: () => Clipboard,
+  ComponentScheduleScene: () => ComponentScheduleScene,
   Configuration: () => Configuration,
   ContainerModal: () => ContainerModal,
   Context: () => Context,
   Control: () => Control,
   CustomComponent: () => CustomComponent,
-  CustomComponentScene: () => CustomComponentScene,
   CustomComponentType: () => CustomComponentType,
   Field: () => Field,
   FieldType: () => FieldType,
@@ -689,7 +689,7 @@ var SDKClient = _SDKClient;
 /**
  * SDK 版本号
  */
-SDKClient.version = "2.0.4-dev.1";
+SDKClient.version = "2.0.4-dev.2";
 
 // src/types/biz.ts
 var AttributeType = /* @__PURE__ */ ((AttributeType2) => {
@@ -760,16 +760,16 @@ var InterceptEvent = /* @__PURE__ */ ((InterceptEvent2) => {
   InterceptEvent2[InterceptEvent2["UpdateState"] = 3001] = "UpdateState";
   return InterceptEvent2;
 })(InterceptEvent || {});
+var ComponentScheduleScene = /* @__PURE__ */ ((ComponentScheduleScene2) => {
+  ComponentScheduleScene2[ComponentScheduleScene2["ALL"] = 0] = "ALL";
+  ComponentScheduleScene2[ComponentScheduleScene2["workItemNode"] = 1] = "workItemNode";
+  ComponentScheduleScene2[ComponentScheduleScene2["scheduleTable"] = 2] = "scheduleTable";
+  return ComponentScheduleScene2;
+})(ComponentScheduleScene || {});
 var CustomComponentType = /* @__PURE__ */ ((CustomComponentType2) => {
   CustomComponentType2["Schedule"] = "schedule";
   return CustomComponentType2;
 })(CustomComponentType || {});
-var CustomComponentScene = /* @__PURE__ */ ((CustomComponentScene2) => {
-  CustomComponentScene2[CustomComponentScene2["ALL"] = 0] = "ALL";
-  CustomComponentScene2[CustomComponentScene2["workItemNode"] = 1] = "workItemNode";
-  CustomComponentScene2[CustomComponentScene2["scheduleTable"] = 2] = "scheduleTable";
-  return CustomComponentScene2;
-})(CustomComponentScene || {});
 
 // src/errors/CustomError.ts
 var CustomError = class extends Error {
@@ -854,12 +854,12 @@ var src_default = SDKClient;
   Button,
   ButtonScene,
   Clipboard,
+  ComponentScheduleScene,
   Configuration,
   ContainerModal,
   Context,
   Control,
   CustomComponent,
-  CustomComponentScene,
   CustomComponentType,
   Field,
   FieldType,

package/dist/types/index.d.ts

@@ -522,6 +522,57 @@ interface InterceptFeatureContext<T> {
     }>;
     customData: T;
 }
+/** ----------------------- 拓展组件-排期组件特化属性 ----------------------- */
+/**
+ * 排期组件位置
+ */
+declare enum ComponentScheduleScene {
+    /**
+     * 全部
+     */
+    ALL = 0,
+    /**
+     * 工作项节点/子任务
+     */
+    workItemNode = 1,
+    /**
+     * 计划表
+     */
+    scheduleTable = 2
+}
+declare enum WorkItemNodeType {
+    Node = "node",
+    SubTask = "sub_task",
+    SubWorkItem = "sub_workitem",
+    SuInstance = "sub_instance"
+}
+interface WorkItemInfo {
+    spaceId: string;
+    workObjectId: string;
+    workItemId: string;
+}
+type ComponentScheduleIdentity = WorkItemInfo & {
+    type: WorkItemNodeType;
+    nodeId: string;
+    taskId: string;
+};
+interface WbsStatus {
+    wbsStatus: string;
+}
+interface UserInfo {
+    role: string;
+    userName: string;
+    id: string;
+}
+type ScheduleCompValueType = string[];
+/**
+ *  schedule 组件类型校验返回值
+ */
+interface ScheduleCompValidateMsg {
+    code: 200 | number;
+    msg: string;
+}
+/** ----------------------- 拓展点位通用类型 ----------------------- */
 /**
  * 自定义组件构成
  * 支持的定义组件类型
@@ -533,7 +584,22 @@ declare enum CustomComponentType {
  * 自定义组件构成
  * 允许用户定制指定业务组件类型的UI
  */
-interface CustomComponentFeatureContext {
+interface CustomComponentFeatureContext<I extends {
+    /**
+     * 组件节点标识
+     * 适用场景：详情页为节点流时，且当前控件位于节点表单/计划表内，该字段才有数据
+     */
+    nodeId?: string;
+    /**
+     * 组件子任务标识
+     * 适用场景：详情页为节点流时，且当前控件位于节点表单/计划表内，该字段才有数据
+     */
+    taskId?: string;
+}, S extends ComponentScheduleScene> {
+    /**
+     * 组件所处场景
+     */
+    scene: S;
     /**
      * 组件当前所属空间标识
      */
@@ -549,45 +615,9 @@ interface CustomComponentFeatureContext {
     workItemId?: number;
     /**
      * 组件唯一标识
-     * 新建场景结合 webhook 用于关联自有数据
-     * 详情页可能为空，不推荐强依赖 UUID 读取自有数据
-     */
-    UUID?: string;
-    /**
-     * 组件节点标识
-     * 适用场景：详情页为节点流时，且当前控件位于节点表单内，该字段才有数据
-     */
-    nodeId?: string;
-    /**
-     * 组件子任务标识
-     * 适用场景：详情页为节点流时，且当前控件位于节点表单内，该字段才有数据
-     */
-    taskId?: string;
-}
-/**
- * 排期组件位置
- */
-declare enum CustomComponentScene {
-    /**
-     * 全部
-     */
-    ALL = 0,
-    /**
-     * 工作项节点/子任务
+     * 组件所属节点的所属空间/工作项/工作项实例以及节点任务标识
      */
-    workItemNode = 1,
-    /**
-     * 计划表
-     */
-    scheduleTable = 2
-}
-/**
- *  schedule 组件类型校验返回值
- */
-type ScheduleCompValueType = string[];
-interface ScheduleCompValidateMsg {
-    code: 200 | 403;
-    msg: string;
+    identity?: I;
 }
 /**
  * 自定义组件构成
@@ -597,8 +627,6 @@ interface CustomComponentProps {
     [CustomComponentType.Schedule]: {
         value: ScheduleCompValueType;
         disabled?: boolean;
-        getContext: () => Promise<CustomComponentFeatureContext>;
-        handleSubmit: (value: ScheduleCompValueType) => ScheduleCompValidateMsg;
     };
 }
 
@@ -1628,15 +1656,17 @@ declare abstract class CustomComponent extends BaseModel {
      */
     protected static [IMPL_KEY]: string;
     abstract [CustomComponentType.Schedule]: {
-        load: () => Promise<CustomComponentProps[CustomComponentType.Schedule]>;
+        getProps: () => Promise<CustomComponentProps[CustomComponentType.Schedule]>;
         /**
          * 用于监听 props 变更
          * @param callback 返回 schedule 组件新的 props
          * @param watchKeys 监听的 key，只能监听属性的 key（不能监听 api key），不传默认监听所有 key。监听的 key 对应的值变更会触发回调
          * @returns
          */
-        watch: (callback: (next: CustomComponentProps[CustomComponentType.Schedule]) => void, watchKeys?: keyof Omit<CustomComponentProps[CustomComponentType.Schedule], 'getContext' | 'handleSubmit'>[]) => Off;
-        getContext: () => Promise<CustomComponentFeatureContext>;
+        watch: (callback: (next: CustomComponentProps[CustomComponentType.Schedule]) => void, watchKeys?: (keyof CustomComponentProps[CustomComponentType.Schedule])[]) => Off;
+        getContext: () => Promise<CustomComponentFeatureContext<ComponentScheduleIdentity, ComponentScheduleScene>>;
+        getWbsStatus?: () => Promise<WbsStatus>;
+        getOwnersInfo?: () => Promise<UserInfo[]>;
         handleSubmit: (value: ScheduleCompValueType) => Promise<ScheduleCompValidateMsg>;
     };
 }
@@ -1854,4 +1884,4 @@ declare class NotSupportedError extends CustomError {
  * @packageDocumentation
  */
 
-export { ActionSheet, ActionSheetOptions, AttributeType, BizLine, BriefField, BriefNode, BriefSpace, BriefTemplate, BriefView, BriefWorkItem, BriefWorkObject, Button, ButtonFeatureContext, ButtonScene, Clipboard, ColorScheme, Configuration, ConfigurationFeatureContext, ContainerModal, Context, Control, ControlFeatureContext, CreateButtonFeatureContext, CustomComponent, CustomComponentFeatureContext, CustomComponentProps, CustomComponentScene, CustomComponentType, Field, FieldType, FlowMode, 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, ScheduleCompValidateMsg, ScheduleCompValueType, Shared, Space, Storage, Tab, TabFeatureContext, Toast, ToastOptions, User, Utils, View, ViewFeatureContext, WorkItem, WorkItemButtonFeatureContext, WorkItemCreateFormPreset, WorkItemFinder, WorkItemFinderOptions, WorkObject, SDKClient as default, unwatch };
+export { ActionSheet, ActionSheetOptions, AttributeType, BizLine, BriefField, BriefNode, BriefSpace, BriefTemplate, BriefView, BriefWorkItem, BriefWorkObject, Button, ButtonFeatureContext, ButtonScene, Clipboard, ColorScheme, ComponentScheduleIdentity, ComponentScheduleScene, Configuration, ConfigurationFeatureContext, ContainerModal, Context, Control, ControlFeatureContext, CreateButtonFeatureContext, CustomComponent, CustomComponentFeatureContext, CustomComponentProps, CustomComponentType, Field, FieldType, FlowMode, 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, ScheduleCompValidateMsg, ScheduleCompValueType, Shared, Space, Storage, Tab, TabFeatureContext, Toast, ToastOptions, User, UserInfo, Utils, View, ViewFeatureContext, WbsStatus, 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.4-dev.1",
+  "version": "2.0.4-dev.2",
   "runtimeMinVersions": {
     "web": "2.1.0",
     "mobile": "1.1.0"