@lark-project/js-sdk 2.0.16 → 2.0.17-dev.2

package/dist/es/index.js

@@ -450,6 +450,16 @@ _a25 = IMPL_KEY;
  */
 CustomField[_a25] = "customField";
 
+// src/features/BuilderComponent.ts
+var _a26;
+var BuilderComponent = class extends BaseModel {
+};
+_a26 = IMPL_KEY;
+/**
+ * @internal
+ */
+BuilderComponent[_a26] = "liteAppComponent";
+
 // src/client.ts
 function getImplClass(decl, impls) {
   return impls == null ? void 0 : impls[decl[IMPL_KEY]];
@@ -529,6 +539,13 @@ var _SDKClient = class {
   get customField() {
     return getImplValue(CustomField, this._meegoBizHub);
   }
+  /**
+   * 应用主页组件点位容器特有能力
+   * only web 2.0
+   */
+  get liteAppComponent() {
+    return getImplValue(BuilderComponent, this._meegoBizHub);
+  }
   /**
    * 应用导航
    */
@@ -649,7 +666,7 @@ var SDKClient = _SDKClient;
 /**
  * SDK 版本号
  */
-SDKClient.version = "2.0.16";
+SDKClient.version = "2.0.17-dev.2";
 
 // src/types/biz.ts
 var AttributeType = /* @__PURE__ */ ((AttributeType2) => {
@@ -730,6 +747,21 @@ var CustomComponentType = /* @__PURE__ */ ((CustomComponentType2) => {
   CustomComponentType2["Schedule"] = "schedule";
   return CustomComponentType2;
 })(CustomComponentType || {});
+var LiteAppPropTemplateType = /* @__PURE__ */ ((LiteAppPropTemplateType2) => {
+  LiteAppPropTemplateType2["Text"] = "text";
+  LiteAppPropTemplateType2["Number"] = "number";
+  LiteAppPropTemplateType2["Select"] = "select";
+  LiteAppPropTemplateType2["Boolean"] = "boolean";
+  LiteAppPropTemplateType2["MultiSelect"] = "multiSelect";
+  LiteAppPropTemplateType2["DatePrecise"] = "dateWithTime";
+  LiteAppPropTemplateType2["DateRange"] = "dateRange";
+  LiteAppPropTemplateType2["WorkItemInstance"] = "workItemInstance";
+  LiteAppPropTemplateType2["WorkItemTypeSelect"] = "workItemTypeSelect";
+  LiteAppPropTemplateType2["ViewSelect"] = "viewSelect";
+  LiteAppPropTemplateType2["workItemInstanceWithField"] = "workItemInstanceWithField";
+  LiteAppPropTemplateType2["workItemTypeWithField"] = "workItemTypeWithField";
+  return LiteAppPropTemplateType2;
+})(LiteAppPropTemplateType || {});
 
 // src/errors/CustomError.ts
 var CustomError = class extends Error {
@@ -822,6 +854,7 @@ var src_default = SDKClient;
 export {
   ActionSheet,
   AttributeType,
+  BuilderComponent,
   Button,
   ButtonScene,
   Clipboard,
@@ -841,6 +874,7 @@ export {
   InterceptEvent,
   InternalError,
   InvalidParamsError,
+  LiteAppPropTemplateType,
   MEEGO_BIZ_HUB,
   Modal,
   Navigation,

package/dist/lib/index.js

@@ -50,6 +50,7 @@ var src_exports = {};
 __export(src_exports, {
   ActionSheet: () => ActionSheet,
   AttributeType: () => AttributeType,
+  BuilderComponent: () => BuilderComponent,
   Button: () => Button,
   ButtonScene: () => ButtonScene,
   Clipboard: () => Clipboard,
@@ -69,6 +70,7 @@ __export(src_exports, {
   InterceptEvent: () => InterceptEvent,
   InternalError: () => InternalError,
   InvalidParamsError: () => InvalidParamsError,
+  LiteAppPropTemplateType: () => LiteAppPropTemplateType,
   MEEGO_BIZ_HUB: () => MEEGO_BIZ_HUB,
   Modal: () => Modal,
   Navigation: () => Navigation,
@@ -516,6 +518,16 @@ _a25 = IMPL_KEY;
  */
 CustomField[_a25] = "customField";
 
+// src/features/BuilderComponent.ts
+var _a26;
+var BuilderComponent = class extends BaseModel {
+};
+_a26 = IMPL_KEY;
+/**
+ * @internal
+ */
+BuilderComponent[_a26] = "liteAppComponent";
+
 // src/client.ts
 function getImplClass(decl, impls) {
   return impls == null ? void 0 : impls[decl[IMPL_KEY]];
@@ -595,6 +607,13 @@ var _SDKClient = class {
   get customField() {
     return getImplValue(CustomField, this._meegoBizHub);
   }
+  /**
+   * 应用主页组件点位容器特有能力
+   * only web 2.0
+   */
+  get liteAppComponent() {
+    return getImplValue(BuilderComponent, this._meegoBizHub);
+  }
   /**
    * 应用导航
    */
@@ -715,7 +734,7 @@ var SDKClient = _SDKClient;
 /**
  * SDK 版本号
  */
-SDKClient.version = "2.0.16";
+SDKClient.version = "2.0.17-dev.2";
 
 // src/types/biz.ts
 var AttributeType = /* @__PURE__ */ ((AttributeType2) => {
@@ -796,6 +815,21 @@ var CustomComponentType = /* @__PURE__ */ ((CustomComponentType2) => {
   CustomComponentType2["Schedule"] = "schedule";
   return CustomComponentType2;
 })(CustomComponentType || {});
+var LiteAppPropTemplateType = /* @__PURE__ */ ((LiteAppPropTemplateType2) => {
+  LiteAppPropTemplateType2["Text"] = "text";
+  LiteAppPropTemplateType2["Number"] = "number";
+  LiteAppPropTemplateType2["Select"] = "select";
+  LiteAppPropTemplateType2["Boolean"] = "boolean";
+  LiteAppPropTemplateType2["MultiSelect"] = "multiSelect";
+  LiteAppPropTemplateType2["DatePrecise"] = "dateWithTime";
+  LiteAppPropTemplateType2["DateRange"] = "dateRange";
+  LiteAppPropTemplateType2["WorkItemInstance"] = "workItemInstance";
+  LiteAppPropTemplateType2["WorkItemTypeSelect"] = "workItemTypeSelect";
+  LiteAppPropTemplateType2["ViewSelect"] = "viewSelect";
+  LiteAppPropTemplateType2["workItemInstanceWithField"] = "workItemInstanceWithField";
+  LiteAppPropTemplateType2["workItemTypeWithField"] = "workItemTypeWithField";
+  return LiteAppPropTemplateType2;
+})(LiteAppPropTemplateType || {});
 
 // src/errors/CustomError.ts
 var CustomError = class extends Error {
@@ -889,6 +923,7 @@ var src_default = SDKClient;
 0 && (module.exports = {
   ActionSheet,
   AttributeType,
+  BuilderComponent,
   Button,
   ButtonScene,
   Clipboard,
@@ -908,6 +943,7 @@ var src_default = SDKClient;
   InterceptEvent,
   InternalError,
   InvalidParamsError,
+  LiteAppPropTemplateType,
   MEEGO_BIZ_HUB,
   Modal,
   Navigation,

package/dist/types/index.d.ts

@@ -797,6 +797,138 @@ interface ContainerModalConfigureOptions {
         content: string;
     };
 }
+/** ----------------------- liteapp 组件构成类型 ----------------------- */
+interface LiteAppComponentFeatureContext {
+    /**
+     * liteapp 组件当前所属空间标识
+     */
+    spaceId: string;
+    /**
+     * liteapp 组件当前所属轻应用标识
+     */
+    appId: string;
+    /**
+     * liteapp 组件当前所属轻应用下页面标识
+     */
+    pageId: string;
+}
+/**
+ * liteapp 组件属性值类型
+ */
+type LiteAppPropLayout = {
+    width: number;
+    height: number;
+    positionX: number;
+    positionY: number;
+};
+declare enum LiteAppPropTemplateType {
+    Text = "text",
+    Number = "number",
+    Select = "select",
+    Boolean = "boolean",
+    MultiSelect = "multiSelect",
+    DatePrecise = "dateWithTime",
+    DateRange = "dateRange",
+    WorkItemInstance = "workItemInstance",
+    WorkItemTypeSelect = "workItemTypeSelect",
+    ViewSelect = "viewSelect",
+    workItemInstanceWithField = "workItemInstanceWithField",
+    workItemTypeWithField = "workItemTypeWithField"
+}
+type LiteAppPropText = string;
+type LiteAppPropNumber = number;
+type LiteAppPropSelect = string;
+type LiteAppPropBoolean = boolean;
+type LiteAppPropMultiSelect = string[];
+type LiteAppPropDateWithTime = number;
+type LiteAppPropDateRange = {
+    start: number;
+    end: number;
+};
+type LiteAppPropWorkItemType = {
+    spaceId: string;
+    workObjectId: string;
+    fieldList?: LiteAppPropField[];
+};
+type LiteAppPropWorkItemInstance = {
+    spaceId: string;
+    workObjectId: string;
+    workItemId: number;
+    fieldList?: LiteAppPropField[];
+};
+type LiteAppPropField = {
+    spaceId: string;
+    workObjectId: string;
+    fieldClass: 'field' | 'role';
+    fieldKey: string;
+    roleId: string;
+    display?: boolean;
+};
+type LiteAppPropView = {
+    viewId: string;
+    isMultiProject: boolean;
+};
+type LiteAppPropWorkItemListAfterFilter = LiteAppPropWorkItemInstance[];
+type LiteAppPropWorkItemListAfterSort = LiteAppPropWorkItemInstance[];
+type LiteAppCompPropValueType = LiteAppPropText | LiteAppPropNumber | LiteAppPropSelect | LiteAppPropBoolean | LiteAppPropMultiSelect | LiteAppPropDateWithTime | LiteAppPropDateRange | LiteAppPropWorkItemType | LiteAppPropWorkItemInstance | LiteAppPropView | LiteAppPropWorkItemListAfterFilter | LiteAppPropWorkItemListAfterSort;
+/**
+ * liteapp 组件不同的属性类型对应的可读配置
+ */
+type I18nTitleConfig = {
+    zh?: string;
+    en?: string;
+    ja?: string;
+    raw?: string;
+};
+type LiteAppCompPropSelectConfig = {
+    title: I18nTitleConfig;
+    propType: LiteAppPropTemplateType.Select | LiteAppPropTemplateType.MultiSelect;
+    options: {
+        label: I18nTitleConfig;
+        value: string;
+    }[];
+};
+type LiteAppCompPropBriefConfig = {
+    title: I18nTitleConfig;
+    propType: LiteAppPropTemplateType;
+};
+type LiteAppCompPropFullConfig = LiteAppCompPropBriefConfig | LiteAppCompPropSelectConfig;
+/**
+ * liteapp 组件入参定义
+ */
+type LiteAppComponentProps = {
+    instanceId: string;
+    layout?: LiteAppPropLayout;
+} & {
+    [propName: string]: LiteAppCompPropValueType;
+};
+type LiteAppCompLayoutConfig = 
+/** 定高模式 */
+{
+    mode: 0;
+    staticHeight: number;
+    staticWidth: number;
+}
+/** 栅格模式 */
+ | {
+    mode: 1;
+    minWidth: number;
+    minHeight: number;
+    maxWidth: number;
+    maxHeight: number;
+};
+type LiteAppComponentConfig = {
+    id: string;
+    layout: LiteAppCompLayoutConfig;
+} & {
+    [keyOfProp: string]: LiteAppCompPropBriefConfig;
+};
+interface LiteAppComponentPreset {
+    layout?: {
+        width: number;
+        height: number;
+    };
+}
 
 /**
  * @internal
@@ -1148,6 +1280,7 @@ declare abstract class Navigation extends BaseModel {
     /**
      * 打开指定空间工作项新建页
      * @param options
+     * @param options.mode 新建页交互形式，默认为 default
      * @param options.spaceId 空间唯一标识
      * @param options.spaceSimpleName [废弃]空间标识，非空间唯一标识
      * @param options.workObjectId 工作项类型唯一标识，如 story、issue
@@ -1156,6 +1289,7 @@ declare abstract class Navigation extends BaseModel {
      * @param callback 新建完成回调，当 err 为 undefined 时为新建成功，可以通过 result.workItemId 取新建工作项实例 id
      */
     abstract openWorkItemCreatePage(options: {
+        mode?: 'default' | 'modal';
         spaceId: string;
         /**
          * @deprecated
@@ -2013,6 +2147,59 @@ declare abstract class CustomField extends BaseModel {
     abstract openFullScreenPlugin(): void;
 }
 
+/**
+ * @public
+ * 自定义组件构成
+ */
+declare abstract class BuilderComponent extends BaseModel {
+    /**
+     * @internal
+     */
+    protected static [IMPL_KEY]: string;
+    /**
+     * 获取 liteapp 组件上下文信息
+     */
+    abstract getContext: () => Promise<LiteAppComponentFeatureContext>;
+    /**
+     * 获取 liteapp 组件入参
+     * 每个 liteapp 组件一共有 3种数据：
+     * * 组件实例数据（流入的属性值、组件当前的系统属性值）
+     * * 组件配置数据（属于开发者后台的配置，用于描述组件所具有的属性）
+     * * 组件预设值/默认值（属于开发者后台配置，只不过用于给组件提供默认值）
+     * getProps 获取的即第一种数据 - 组件实例数据：
+     * * 系统内置的所有组件通用属性值
+     * * 开发者后台申明的组件入参特化属性值
+     * 不同类型属性的数据结构可参考 JSSDK 包中的类型定义或开发者手册
+     */
+    abstract getProps: () => Promise<LiteAppComponentProps>;
+    /**
+     * 用于监听 props 变更
+     * @param callback 返回组件新的 props
+     * @param watchKeys 监听的 key，只能监听属性的 key（不能监听 api key），不传默认监听所有 key。监听的 key 对应的值变更会触发回调
+     * @returns
+     */
+    abstract watch: (callback: (next: LiteAppComponentProps | Record<string, never>) => void, watchKeys?: keyof LiteAppComponentProps | (keyof LiteAppComponentProps)[]) => Promise<Off>;
+    /**
+     * 获取 liteapp 组件配置：
+     * - 名称
+     * - icon 地址
+     * - layout
+     * - 属性对应的配置
+     */
+    abstract getConfig: (propKeys?: string | string[]) => Promise<LiteAppComponentConfig>;
+    /**
+     * 根据属性 key 点查属性的完整配置
+     * - 单选多选类型的选项列表
+     */
+    abstract getPropFullConfig: (propKey: string) => Promise<LiteAppCompPropFullConfig>;
+    /**
+     * 获取 liteapp 组件预设值：
+     * - layout
+     * 暂时不支持指定多组预设值/指定预设id（统一走 default），未来视诉求开放
+     */
+    abstract getPreset: (propKeys?: string | string[]) => Promise<LiteAppComponentPreset>;
+}
+
 /**
  * @public
  * SDKClient 的配置项
@@ -2081,6 +2268,11 @@ declare class SDKClient {
      * only 2.0
      */
     get customField(): CustomField;
+    /**
+     * 应用主页组件点位容器特有能力
+     * only web 2.0
+     */
+    get liteAppComponent(): BuilderComponent;
     /**
      * 应用导航
      */
@@ -2240,4 +2432,4 @@ declare class NotSupportedError extends CustomError {
  * @packageDocumentation
  */
 
-export { ActionSheet, ActionSheetOptions, AttributeType, BatchButtonFeatureContext, BizLine, BriefField, BriefNode, BriefSpace, BriefTemplate, BriefView, BriefWorkItem, BriefWorkObject, Button, ButtonFeatureContext, ButtonScene, Clipboard, ColorScheme, ComponentScheduleIdentity, ComponentScheduleScene, Configuration, ConfigurationFeatureContext, ContainerModal, ContainerModalConfigureOptions, Context, Control, ControlFeatureContext, CreateButtonFeatureContext, CustomComponent, CustomComponentFeatureContext, CustomComponentProps, CustomComponentType, CustomField, CustomFieldConfig, CustomFieldFeatureContext, CustomFieldProps, CustomFieldValidateMsg, CustomFieldValueType, ExCompoundFieldValueType, Field, FieldType, FieldValue, FlowMode, IMPL_KEY, IPluginCustomBuildConfig, IRichTextEditorImageUploadComplete, IntegrationFeatureContext, Intercept, InterceptEvent, InterceptFeatureContext, InternalError, InvalidParamsError, Language, MEEGO_BIZ_HUB, Modal, ModalConfirmOptions, ModalOpenOptions, Navigation, NoAuthError, NodeStatus, NotFoundError, NotSupportedError, Off, OutOfLimitError, Page, PageFeatureContext, RichTextEditor, RichTextEditorContent, RichTextEditorOptions, Role, RoleOwners, SDKClient, SDKClientOptions, ScheduleCompValidateMsg, ScheduleCompValueType, ScheduleUnitButtonFeatureContext, Shared, Space, Storage, SubFieldType, Tab, TabFeatureContext, Toast, ToastOptions, User, UserInfo, Utils, View, ViewFeatureContext, WbsStatus, WorkItem, WorkItemButtonFeatureContext, WorkItemCreateFormPreset, WorkItemFinder, WorkItemFinderOptions, WorkObject, SDKClient as default, unwatch };
+export { ActionSheet, ActionSheetOptions, AttributeType, BatchButtonFeatureContext, BizLine, BriefField, BriefNode, BriefSpace, BriefTemplate, BriefView, BriefWorkItem, BriefWorkObject, BuilderComponent, Button, ButtonFeatureContext, ButtonScene, Clipboard, ColorScheme, ComponentScheduleIdentity, ComponentScheduleScene, Configuration, ConfigurationFeatureContext, ContainerModal, ContainerModalConfigureOptions, Context, Control, ControlFeatureContext, CreateButtonFeatureContext, CustomComponent, CustomComponentFeatureContext, CustomComponentProps, CustomComponentType, CustomField, CustomFieldConfig, CustomFieldFeatureContext, CustomFieldProps, CustomFieldValidateMsg, CustomFieldValueType, ExCompoundFieldValueType, Field, FieldType, FieldValue, FlowMode, I18nTitleConfig, IMPL_KEY, IPluginCustomBuildConfig, IRichTextEditorImageUploadComplete, IntegrationFeatureContext, Intercept, InterceptEvent, InterceptFeatureContext, InternalError, InvalidParamsError, Language, LiteAppCompLayoutConfig, LiteAppCompPropBriefConfig, LiteAppCompPropFullConfig, LiteAppCompPropSelectConfig, LiteAppCompPropValueType, LiteAppComponentConfig, LiteAppComponentFeatureContext, LiteAppComponentPreset, LiteAppComponentProps, LiteAppPropBoolean, LiteAppPropDateRange, LiteAppPropDateWithTime, LiteAppPropField, LiteAppPropLayout, LiteAppPropMultiSelect, LiteAppPropNumber, LiteAppPropSelect, LiteAppPropTemplateType, LiteAppPropText, LiteAppPropView, LiteAppPropWorkItemInstance, LiteAppPropWorkItemListAfterFilter, LiteAppPropWorkItemListAfterSort, LiteAppPropWorkItemType, MEEGO_BIZ_HUB, Modal, ModalConfirmOptions, ModalOpenOptions, Navigation, NoAuthError, NodeStatus, NotFoundError, NotSupportedError, Off, OutOfLimitError, Page, PageFeatureContext, RichTextEditor, RichTextEditorContent, RichTextEditorOptions, Role, RoleOwners, SDKClient, SDKClientOptions, ScheduleCompValidateMsg, ScheduleCompValueType, ScheduleUnitButtonFeatureContext, Shared, Space, Storage, SubFieldType, 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.16",
+  "version": "2.0.17-dev.2",
   "runtimeMinVersions": {
     "web": "2.1.0",
     "mobile": "1.1.0"