@jlceda/pro-api-types 0.1.168 → 0.1.170

package/index.d.ts

@@ -889,6 +889,7 @@ declare class EDA {
     sys_Log: SYS_Log;
     sys_Message: SYS_Message;
     sys_MessageBox: SYS_MessageBox;
+    sys_MessageBus: SYS_MessageBus;
     sys_PanelControl: SYS_PanelControl;
     sys_Setting: SYS_Setting;
     sys_ShortcutKey: SYS_ShortcutKey;
@@ -2150,7 +2151,7 @@ declare interface IDMT_IndicatorMarkerShape {
      */
     startY?: number;
     /**
-     * 线段 | 圆弧：终止点 X
+     * 线�� | 圆弧：终止点 X
      */
     endX?: number;
     /**
@@ -7315,7 +7316,7 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
     private uniqueId?;
     /** Component 属性：制造商 */
     private manufacturer?;
-    /** Component 属性：制��商编号 */
+    /** Component 属性：制造商编号 */
     private manufacturerId?;
     /** Component 属性：供应商 */
     private supplier?;
@@ -9140,6 +9141,28 @@ declare interface ISYS_LogLine {
     message: string;
 }
 
+/**
+ * 消息总线任务
+ *
+ * @public
+ */
+declare interface ISYS_MessageBusTask {
+    /** 调用以取消任务 */
+    cancel: () => void;
+    /**
+     * 检查运行状态
+     *
+     * @returns 是否正在监听
+     */
+    running: () => boolean;
+    /**
+     * 任务处理
+     *
+     * @param message - 接收到的数据
+     */
+    execute: (message: any) => Promise<void>;
+}
+
 /**
  * 多语言数据
  *
@@ -9584,7 +9607,7 @@ declare class LIB_Device {
      *
      * 私有化部署环境暂无法使用本接口
      * @param lcscIds - 立创 C 编号数组
-     * @param libraryUuid - 库 UUID，默认为系统库，可以使用 {@link LIB_LibrariesList} 内的接口获��
+     * @param libraryUuid - 库 UUID，默认为系统库，可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @param allowMultiMatch - 是否允许单个立创 C 编号匹配多个结果
      * @returns 搜索到的器件属性的列表
      */
@@ -9979,7 +10002,7 @@ declare class PCB_Document {
      * 输入画布坐标返回该坐标对应的数据坐标
      *
      * @public
-     * @remarks 嘉立创 EDA ��端显示的坐标均为画布原点；嘉立创 EDA API 使用的均为数据原点；在创建 PCB 时，默认画布原点等于数据原点
+     * @remarks 嘉立创 EDA 前端显示的坐标均为画布原点；嘉立创 EDA API 使用的均为数据原点；在创建 PCB 时，默认画布原点等于数据原点
      * @param canvasOriginX - 画布原点 X
      * @param canvasOriginY - 画布原点 Y
      * @returns 数据原点坐标
@@ -10775,7 +10798,7 @@ declare class PCB_ManufactureData {
      */
     uploadBomTemplateFile(templateFile: File, template?: string): Promise<string | undefined>;
     /**
-     * 获取 BOM 模板文件
+     * 获取 BOM 模板���件
      *
      * @beta
      * @param template - BOM 模板名称
@@ -11932,7 +11955,7 @@ declare class PCB_PrimitivePad implements IPCB_PrimitiveAPI {
      * @beta
      * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
      * @param primitiveIds - 焊盘的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 焊盘图元对象，空数组表示获取失败
+     * @returns 焊盘图��对象，空数组表示获取失败
      */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitivePad>>;
     /**
@@ -13525,7 +13548,7 @@ declare class SCH_PrimitivePolygon implements ISCH_PrimitiveAPI {
      * 获取多边形
      *
      * @beta
-     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返���少于传入的图元 ID 数量的图元对象
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
      * @param primitiveIds - 多边形的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
      * @returns 多边形图元对象，空数组表示获取失败
      */
@@ -14228,8 +14251,72 @@ declare class SYS_FileManager {
      * @returns 面板库文件数据，`undefined` 表示数据获取失败
      */
     getPanelLibraryFileByPanelLibraryUuid(panelLibraryUuid: string | Array<string>, libraryUuid?: string): Promise<File | undefined>;
-    /* Excluded from this release type: importProjectByProjectFile */
-    /* Excluded from this release type: importProjectByProjectFile */
+    /**
+     * 使用工程文件导入工程
+     *
+     * @beta
+     * @remarks 暂不支持提取库的相关配置，如果需求提取库，将会按照默认配置提取
+     * @param projectFile - 工程文件
+     * @param fileType - 文件类型
+     * @param props - 导入参数，参考 EDA 前端 **导入** 窗口内的配置项
+     * @param saveTo - 保存到工程参数
+     * @returns 导入的工程的简略工程属性
+     */
+    importProjectByProjectFile(projectFile: File, fileType?: 'JLCEDA' | 'JLCEDA Pro' | 'EasyEDA' | 'EasyEDA Pro' | 'Allegro' | 'OrCAD' | 'EAGLE' | 'KiCad' | 'PADS' | 'LTspice', props?: {
+        importOption?: EImportOptionType;
+        schematicObjectStyle?: ESchPrimitiveStyle;
+        associateFootprint?: boolean;
+        associate3DModel?: boolean;
+        importFootprintNotesLayer?: boolean;
+    }, saveTo?: {
+        operation: 'New Project';
+        newProjectOwnerTeamUuid: IDMT_TeamItem['uuid'];
+        newProjectOwnerFolderUuid?: IDMT_FolderItem['uuid'];
+        newProjectName?: string;
+        newProjectFriendlyName?: string;
+        newProjectDescription?: string;
+        newProjectCollaborationMode?: EDMT_ProjectCollaborationMode;
+    } | {
+        operation: 'Existing Project';
+        existingProjectUuid: IDMT_BriefProjectItem['uuid'];
+    }, librariesImportSetting?: {
+        ownerTeamUuid: IDMT_TeamItem['uuid'];
+        createDeviceForSingleSymbol?: boolean;
+    }): Promise<IDMT_BriefProjectItem | undefined>;
+    /**
+     * 使用工程文件导入工程
+     *
+     * @beta
+     * @remarks 暂不支持提取库的相关配置，如果需求提取库，将会按照默认配置提取
+     * @param projectFile - 工程文件
+     * @param fileType - 文件类型
+     * @param props - 导入参数，参考 EDA 前端 **导入** 窗口内的配置项
+     * @param saveTo - 保存到工程参数
+     * @returns 导入的工程的简略工程属性
+     */
+    importProjectByProjectFile(projectFile: File, fileType?: 'Altium Designer' | 'Protel', props?: {
+        importOption?: EImportOptionType;
+        viaSolderMaskExpansion?: EViaSolderMaskExpansion;
+        boardOutlineSource?: EBoardOutlineSourceType;
+        schematicObjectStyle?: ESchPrimitiveStyle;
+        associateFootprint?: boolean;
+        associate3DModel?: boolean;
+        importFootprintNotesLayer?: boolean;
+    }, saveTo?: {
+        operation: 'New Project';
+        newProjectOwnerTeamUuid: IDMT_TeamItem['uuid'];
+        newProjectOwnerFolderUuid?: IDMT_FolderItem['uuid'];
+        newProjectName?: string;
+        newProjectFriendlyName?: string;
+        newProjectDescription?: string;
+        newProjectCollaborationMode?: EDMT_ProjectCollaborationMode;
+    } | {
+        operation: 'Existing Project';
+        existingProjectUuid: IDMT_BriefProjectItem['uuid'];
+    }, librariesImportSetting?: {
+        ownerTeamUuid: IDMT_TeamItem['uuid'];
+        createDeviceForSingleSymbol?: boolean;
+    }): Promise<IDMT_BriefProjectItem | undefined>;
 }
 
 /**
@@ -14729,6 +14816,179 @@ declare class SYS_MessageBox {
     showConfirmationMessage(content: string, title?: string, mainButtonTitle?: string, buttonTitle?: string, callbackFn?: (mainButtonClicked: boolean) => void): void;
 }
 
+/**
+ * 系统 / 消息总线类
+ *
+ * @public
+ */
+declare class SYS_MessageBus {
+    /** 扩展 UUID */
+    private extensionUuid?;
+    /* Excluded from this release type: __constructor */
+    /**
+     * 创建私有消息总线
+     *
+     * @public
+     * @remarks 一般无需调用该方法，在进行监听或发送消息时会自动创建私有消息总线
+     */
+    createPrivateMessageBus(): void;
+    /**
+     * 移除私有消息总线
+     *
+     * @public
+     * @remarks 一般无需调用该方法，除非你知道自己在做什么
+     */
+    removePrivateMessageBus(): void;
+    /**
+     * 私有消息总线：推消息
+     *
+     * @public
+     * @remarks 每个消息只有一个 Puller 可以收到
+     * @param topic - 主题
+     * @param message - 消息
+     */
+    push(topic: string, message: any): void;
+    /**
+     * 公共消息总线：推消息
+     *
+     * @public
+     * @remarks 每个消息只有一个 Puller 可以收到
+     * @param topic - 主题
+     * @param message - 消息
+     */
+    pushPublic(topic: string, message: any): void;
+    /**
+     * 私有消息总线：拉消息
+     *
+     * @public
+     * @remarks 每次只能拉一个消息
+     * @param topic - 主题
+     * @param callbackFn - 拉到消息后的回调
+     * @returns 消息总线任务
+     */
+    pull(topic: string, callbackFn: (message: any) => void): ISYS_MessageBusTask;
+    /**
+     * 公共消息总线：拉消息
+     *
+     * @public
+     * @remarks 每次只能拉一个消息
+     * @param topic - 主题
+     * @param callbackFn - 拉到消息后的回调
+     * @returns 消息总线任务
+     */
+    pullPublic(topic: string, callbackFn: (message: any) => void): ISYS_MessageBusTask;
+    /**
+     * 私有消息总线：拉消息 Promise 版本
+     *
+     * @public
+     * @remarks 每次只能拉一个消息，可以使用 `await` 等待消息拉取
+     * @param topic - 主题
+     * @returns 拉取到的消息
+     */
+    pullAsync(topic: string): Promise<any>;
+    /**
+     * 公共消息总线：拉消息 Promise 版本
+     *
+     * @public
+     * @remarks 每次只能拉一个消息，可以使用 `await` 等待消息拉取
+     * @param topic - 主题
+     * @returns 拉取到的消息
+     */
+    pullAsyncPublic(topic: string): Promise<any>;
+    /**
+     * 私有消息总线：发布消息
+     *
+     * @public
+     * @remarks 将消息广播给每一个 Subscriber
+     * @param topic - 主题
+     * @param message - 消息
+     */
+    publish(topic: string, message: any): void;
+    /**
+     * 公共消息总线：发布消息
+     *
+     * @public
+     * @remarks 将消息广播给每一个 Subscriber
+     * @param topic - 主题
+     * @param message - 消息
+     */
+    publishPublic(topic: string, message: any): void;
+    /**
+     * 私有消息总线：订阅消息
+     *
+     * @public
+     * @remarks 持久性订阅消息
+     * @param topic - 主题
+     * @param callbackFn - 接收到消息后的回调
+     * @returns 消息总线任务
+     */
+    subscribe(topic: string, callbackFn: (message: any) => void): ISYS_MessageBusTask;
+    /**
+     * 公共消息总线：订阅消息
+     *
+     * @public
+     * @remarks 持久性订阅消息
+     * @param topic - 主题
+     * @param callbackFn - 接收到消息后的回调
+     * @returns 消息总线任务
+     */
+    subscribePublic(topic: string, callbackFn: (message: any) => void): ISYS_MessageBusTask;
+    /**
+     * 私有消息总线：订阅单次消息
+     *
+     * @public
+     * @param topic - 主题
+     * @param callbackFn - 接收到消息后的回调
+     * @returns 消息总线任务
+     */
+    subscribeOnce(topic: string, callbackFn: (message: any) => void): ISYS_MessageBusTask;
+    /**
+     * 公共消息总线：订阅单次消息
+     *
+     * @public
+     * @param topic - 主题
+     * @param callbackFn - 接收到消息后的回调
+     * @returns 消息总线任务
+     */
+    subscribeOncePublic(topic: string, callbackFn: (message: any) => void): ISYS_MessageBusTask;
+    /**
+     * 私有消息总线：调用 RPC 服务
+     *
+     * @public
+     * @param topic - 主题
+     * @param message - 消息
+     * @param timeout - 超时
+     * @returns RPC 服务返回
+     */
+    rpcCall(topic: string, message?: any, timeout?: number): Promise<any>;
+    /**
+     * 公共消息总线：调用 RPC 服务
+     *
+     * @public
+     * @param topic - 主题
+     * @param message - 消息
+     * @param timeout - 超时
+     * @returns RPC 服务返回
+     */
+    rpcCallPublic(topic: string, message?: any, timeout?: number): Promise<any>;
+    /**
+     * 私有消息总线：注册 RPC 服务
+     *
+     * @public
+     * @param topic - 主题
+     * @param callbackFn - 接收到消息后的回调
+     */
+    rpcService(topic: string, callbackFn: (...args: Array<any>) => any | Promise<any>): void;
+    /**
+     * 公共消息总线：注册 RPC 服务
+     *
+     * @public
+     * @param topic - 主题
+     * @param callbackFn - 接收到消息后的回调
+     */
+    rpcServicePublic(topic: string, callbackFn: (...args: Array<any>) => any | Promise<any>): void;
+}
+
 /**
  * 系统 / 面板控制类
  *
@@ -14962,7 +15222,7 @@ declare class SYS_Timer {
     private extensionUuid?;
     /* Excluded from this release type: __constructor */
     /**
-     * 设置循环定时器
+     * 设置循环定时��
      *
      * @public
      * @remarks 如果遇到 ID 重复的定时器，则之前设置的定时器将被清除

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jlceda/pro-api-types",
-	"version": "0.1.168",
+	"version": "0.1.170",
 	"description": "嘉立创EDA & EasyEDA 专业版扩展 API 接口类型定义",
 	"typings": "index.d.ts",
 	"keywords": [