@jlceda/pro-api-types 0.1.170 → 0.1.172

package/index.d.ts

@@ -738,8 +738,8 @@ declare class DMT_SelectControl {
      * 获取当前文档的属性
      *
      * @beta
-     * @remarks 仅在存在打开的工程后生效，将会获取当前打开且拥有最后输入焦点的文档的文档类型、UUID、所属工程的 UUID
-     * @returns 文档类型、UUID、所属工程的 UUID 组成的对象，如若为 `undefined` 则获取失败
+     * @remarks 将会获取当前打开且拥有最后输入焦点的文档的文档类型、UUID、所属工程的 UUID 或所属库的 UUID
+     * @returns 文档类型、UUID、所属工程的 UUID、所属库的 UUID 组成的对象，如若为 `undefined` 则获取失败
      */
     getCurrentDocumentInfo(): Promise<IDMT_EditorDocumentItem | undefined>;
 }
@@ -883,6 +883,7 @@ declare class EDA {
     sys_FileManager: SYS_FileManager;
     sys_FileSystem: SYS_FileSystem;
     sys_FontManager: SYS_FontManager;
+    sys_HeaderMenu: SYS_HeaderMenu;
     sys_I18n: SYS_I18n;
     sys_IFrame: SYS_IFrame;
     sys_LoadingAndProgressBar: SYS_LoadingAndProgressBar;
@@ -891,6 +892,7 @@ declare class EDA {
     sys_MessageBox: SYS_MessageBox;
     sys_MessageBus: SYS_MessageBus;
     sys_PanelControl: SYS_PanelControl;
+    sys_RightClickMenu: SYS_RightClickMenu;
     sys_Setting: SYS_Setting;
     sys_ShortcutKey: SYS_ShortcutKey;
     sys_Storage: SYS_Storage;
@@ -1083,7 +1085,7 @@ declare enum ELIB_LibraryType {
  * @public
  */
 declare enum ELIB_SymbolType {
-    /** 元件 */
+    /** 元件符号 */
     COMPONENT = 2,
     /** 网络标识 */
     NET_FLAG = 18,
@@ -1094,7 +1096,13 @@ declare enum ELIB_SymbolType {
     /** 无电气 */
     NON_ELECTRICAL = 21,
     /** 短接标识 */
-    SHORT_CIRCUIT_FLAG = 22
+    SHORT_CIRCUIT_FLAG = 22,
+    /** 跨页连接标识 */
+    OFF_PAGE_CONNECTOR = "\u5F00\u53D1\u8BF7\u4FEE\u65391",
+    /** 差分对标识 */
+    DIFFERENTIAL_PAIRS_FLAG = "\u5F00\u53D1\u8BF7\u4FEE\u65392",
+    /** 复用模块符号 */
+    CBB_SYMBOL = "\u5F00\u53D1\u8BF7\u4FEE\u65393"
 }
 
 /**
@@ -1623,7 +1631,7 @@ declare enum ESCH_PrimitiveComponentType {
  * @public
  */
 declare enum ESCH_PrimitiveComponentType_2 {
-    /** 元件 */
+    /** 元件符号 */
     COMPONENT = "part",
     /** 图纸 */
     DRAWING = "sheet",
@@ -1636,7 +1644,13 @@ declare enum ESCH_PrimitiveComponentType_2 {
     /** 短接标识 */
     SHORT_CIRCUIT_FLAG = "short_symbol",
     /** 网络标签 */
-    NET_LABEL = "netlabel"
+    NET_LABEL = "netlabel",
+    /** 跨页连接标识 */
+    OFF_PAGE_CONNECTOR = "offPageConnector",
+    /** 差分对标识 */
+    DIFFERENTIAL_PAIRS_FLAG = "diffPairsFlag",
+    /** 复用模块符号 */
+    CBB_SYMBOL = "block_symbol"
 }
 
 /**
@@ -1782,6 +1796,32 @@ declare enum ESYS_BottomPanelTab {
     FIND = "findResult"
 }
 
+/**
+ * 顶部菜单环境
+ *
+ * @public
+ */
+declare enum ESYS_HeaderMenuEnvironment {
+    /** 主页 */
+    HOME = "home",
+    /** 空白页 */
+    BLANK = "blank",
+    /** 原理图 */
+    SCHEMATIC = "sch",
+    /** 符号（包括 CBB 符号） */
+    SYMBOL = "symbol",
+    /** PCB */
+    PCB = "pcb",
+    /** 封装 */
+    FOOTPRINT = "footprint",
+    /** PCB 预览（包括 2D、3D 预览） */
+    PCB_VIEW = "pcbView",
+    /** 面板 */
+    PANEL = "panel",
+    /** 面板预览 */
+    PANEL_VIEW = "panelView"
+}
+
 /**
  * 左侧面板标签页
  *
@@ -2057,7 +2097,9 @@ declare interface IDMT_EditorDocumentItem {
     /** 文档 UUID */
     uuid: string;
     /** 文档所属工程 UUID */
-    parentProjectUuid: string;
+    parentProjectUuid?: string;
+    /** 库文档所属库 UUID */
+    parentLibraryUuid?: string;
 }
 
 /**
@@ -2151,7 +2193,7 @@ declare interface IDMT_IndicatorMarkerShape {
      */
     startY?: number;
     /**
-     * 线�� | 圆弧：终止点 X
+     * 线段 | 圆弧：终止点 X
      */
     endX?: number;
     /**
@@ -2248,6 +2290,8 @@ declare interface IDMT_SchematicItem {
     parentProjectUuid: string;
     /** 所属板子 UUID */
     parentBoardUuid?: string;
+    /** 复用模块原理图关联的模块符号 */
+    cbbSymbol?: ILIB_SymbolItem;
 }
 
 /**
@@ -2370,6 +2414,8 @@ declare interface ILIB_CbbItem {
     classification?: ILIB_ClassificationIndex;
     /** 描述 */
     description?: string;
+    /** 下属板子 */
+    boards: Array<IDMT_BoardItem>;
 }
 
 /**
@@ -2627,6 +2673,237 @@ declare interface ILIB_DeviceSearchItem {
     jlcLibraryCategory?: ELIB_DeviceJlcLibraryCategory;
 }
 
+/**
+ * 外部库复用模块方法
+ *
+ * @public
+ */
+declare interface ILIB_ExtendLibraryCbbFunctions extends ILIB_ExtendLibraryFunctions {
+    getList: (props: any) => Promise<any>;
+}
+
+/**
+ * 外部库分类索引
+ *
+ * @public
+ * @remarks
+ * 支持外部库使用名称或 UUID 作为分类的唯一 ID 索引
+ */
+declare interface ILIB_ExtendLibraryClassificationIndex {
+    /** 一级分类名称 */
+    primaryClassificationName?: string;
+    /** 一级分类 UUID */
+    primaryClassificationUuid?: string;
+    /** 二级分类名称 */
+    secondaryClassificationName?: string;
+    /** 二级分类 UUID */
+    secondaryClassificationUuid?: string;
+}
+
+/**
+ * 外部库器件方法
+ *
+ * @public
+ */
+declare interface ILIB_ExtendLibraryDeviceFunctions extends ILIB_ExtendLibraryFunctions {
+    getList: (props: ILIB_ExtendLibrarySearchProperty<{
+        attributes?: {
+            [key: string]: string;
+        };
+        symbolType?: ELIB_SymbolType;
+    }>) => Promise<ILIB_ExtendLibrarySearchResult<ILIB_ExtendLibraryItemIndex & {
+        classification?: ILIB_ExtendLibraryClassificationIndex;
+        symbol?: ILIB_ExtendLibraryItem & {
+            symbolType: ELIB_SymbolType;
+        };
+        footprint?: ILIB_ExtendLibraryItem;
+        model3d?: ILIB_ExtendLibraryItem;
+        value?: string;
+        supplierPart?: string;
+        manufacturer?: string;
+        description?: string;
+    }>>;
+    /**
+     * 获取支持的符号类型
+     *
+     * @returns 符号类型数组
+     */
+    getSupportedSymbolTypes: () => Promise<Array<ELIB_SymbolType>>;
+}
+
+/**
+ * 外部库封装方法
+ *
+ * @public
+ */
+declare interface ILIB_ExtendLibraryFootprintFunctions extends ILIB_ExtendLibraryFunctions {
+    getList: (props: ILIB_ExtendLibrarySearchProperty<{}>) => Promise<ILIB_ExtendLibrarySearchResult<ILIB_ExtendLibraryItem & {
+        classification?: ILIB_ExtendLibraryClassificationIndex;
+        description?: string;
+        version?: string;
+        updateTime?: number;
+        createTime?: number;
+        creator?: ILIB_ExtendLibraryUserIndex;
+        modifier?: ILIB_ExtendLibraryUserIndex;
+        owner?: ILIB_ExtendLibraryUserIndex;
+    }>>;
+}
+
+/**
+ * 外部库方法
+ *
+ * @public
+ */
+declare interface ILIB_ExtendLibraryFunctions {
+    /**
+     * 获取详细信息
+     *
+     * @param uuid - UUID
+     * @returns 库元素详细信息
+     */
+    getDetail: (uuid: string) => Promise<any>;
+    /**
+     * 获取分类树
+     *
+     * @returns 分类树
+     */
+    getClassificationTree: () => Promise<Array<{
+        name: string;
+        uuid?: string;
+        children?: Array<{
+            name: string;
+            uuid?: string;
+        }> | undefined;
+    }>>;
+    /**
+     * 获取列表
+     *
+     * @param props - 搜索参数
+     * @returns 库元素列表
+     */
+    getList: (props: ILIB_ExtendLibrarySearchProperty<any>) => Promise<ILIB_ExtendLibrarySearchResult<any>>;
+}
+
+/**
+ * 外部库元素
+ *
+ * @public
+ * @remarks
+ * 此处需要传递 `url` 或 `data` 字段，如若同时传入，则取 `data` 的数据，忽略 `url` 字段
+ *
+ * 如若仅传入 `url` 字段，将会对其发起请求并尝试获取其库文件
+ *
+ * `data` 的数据可为 Blob 格式或 DataURL 格式
+ */
+declare interface ILIB_ExtendLibraryItem extends ILIB_ExtendLibraryItemIndex {
+    /** 库文件地址 */
+    url?: string;
+    /** 库文件数据 */
+    data?: string | Blob;
+}
+
+/**
+ * 外部库元素索引
+ *
+ * @public
+ * @remarks
+ * 支持外部库使用名称或 UUID 作为元素的唯一 ID 索引
+ *
+ * 正常情况下，希望每个库都拥有 UUID，但可能部分系统开发时不存在 UUID 字段（或可以做类似用途的字段）
+ *
+ * 此处仅传入 `name` 字段时，将把 `name` 做唯一 ID 用途，不可有重名的数据
+ *
+ * 如若传入 `uuid` 和 `name` 字段，则只有 `uuid` 不可重复
+ */
+declare interface ILIB_ExtendLibraryItemIndex {
+    /** 库 UUID */
+    uuid?: string;
+    /** 库名称 */
+    name: string;
+}
+
+/**
+ * 外部库搜索参数
+ *
+ * @public
+ */
+declare interface ILIB_ExtendLibrarySearchProperty<T> {
+    /** 页数 */
+    page?: number;
+    /** 单页条目数 */
+    pageSize?: number;
+    /** 查询参数 */
+    query: T & {
+        wd?: string;
+        listByTitles?: Array<string>;
+        classification?: ILIB_ExtendLibraryClassificationIndex;
+    };
+}
+
+/**
+ * 外部库搜索结果
+ *
+ * @public
+ */
+declare interface ILIB_ExtendLibrarySearchResult<T> {
+    /** 总条目数 */
+    count: number;
+    /** 结果列表 */
+    lists: Array<T>;
+    /** 当前页数 */
+    page: number;
+    /** 单页条目数 */
+    pageSize: number;
+    /** 总页数 */
+    totalPage: number;
+}
+
+/**
+ * 外部库符号方法
+ *
+ * @public
+ */
+declare interface ILIB_ExtendLibrarySymbolFunctions extends ILIB_ExtendLibraryFunctions {
+    getList: (props: ILIB_ExtendLibrarySearchProperty<{
+        symbolType?: ELIB_SymbolType;
+    }>) => Promise<ILIB_ExtendLibrarySearchResult<ILIB_ExtendLibraryItem & {
+        symbolType: ELIB_SymbolType;
+    } & {
+        classification?: ILIB_ExtendLibraryClassificationIndex;
+        description?: string;
+        version?: string;
+        updateTime?: number;
+        createTime?: number;
+        creator?: ILIB_ExtendLibraryUserIndex;
+        modifier?: ILIB_ExtendLibraryUserIndex;
+        owner?: ILIB_ExtendLibraryUserIndex;
+    }>>;
+    /**
+     * 获取支持的符号类型
+     *
+     * @returns 符号类型数组
+     */
+    getSupportedSymbolTypes: () => Promise<Array<ELIB_SymbolType>>;
+}
+
+/**
+ * 外部库用户索引
+ *
+ * @public
+ * @remarks
+ * 支持外部库使用名称或关联的嘉立创 EDA 系统内用户 UUID 作为用户的唯一 ID 索引
+ *
+ * 如若希望关联嘉立创 EDA 的用户，请传入该用户的 UUID，将会自动读取用户的名称（如若用户存在）
+ *
+ * 如若仅希望显示用户名称，可以传入 `name` 字段
+ */
+declare interface ILIB_ExtendLibraryUserIndex {
+    /** 用户名称 */
+    name?: string;
+    /** 嘉立创 EDA 系统内的用户 UUID */
+    uuid?: string;
+}
+
 /**
  * 封装属性
  *
@@ -2744,6 +3021,8 @@ declare interface ILIB_SymbolItem {
     uuid: string;
     /** 所属库 UUID */
     libraryUuid: string;
+    /** 所属复用模块 UUID，仅复用模块符号存在该属性 */
+    cbbUuid?: string;
     /** 符号名称 */
     name: string;
     /** 分类 */
@@ -3201,7 +3480,7 @@ declare class IPCB_PrimitiveArc implements IPCB_Primitive {
      * 设置属性状态：是否锁定
      *
      * @beta
-     * @param primitiveLock - 是否锁定
+     * @param primitiveLock - ��否锁定
      * @returns 圆弧线图元对象
      */
     setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveArc;
@@ -3859,7 +4138,7 @@ declare class IPCB_PrimitiveComponent implements IPCB_Primitive {
      * 设置属性状态：位号
      *
      * @beta
-     * @param designator - 位号
+     * @param designator - 位��
      * @returns 器件图元对象
      */
     setState_Designator(designator: string | undefined): IPCB_PrimitiveComponent;
@@ -7071,6 +7350,47 @@ declare class ISCH_PrimitiveBus implements ISCH_Primitive {
     done(): Promise<ISCH_PrimitiveBus>;
 }
 
+/**
+ * 复用模块符号图元
+ *
+ * @public
+ */
+declare class ISCH_PrimitiveCbbSymbolComponent extends ISCH_PrimitiveComponent_2 {
+    /**
+     * 关联复用模块
+     *
+     */
+    private cbb;
+    /** 关联复用模块符号 */
+    private cbbSymbol;
+    /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
+    /**
+     * 获取属性状态：关联复用模块
+     *
+     * @public
+     * @returns 关联复用模块
+     */
+    getState_Cbb(): {
+        libraryUuid: string;
+        uuid: string;
+    };
+    /**
+     * 获取属性状态：关联复用模块符号
+     *
+     * @public
+     * @returns 关联复用模块符号
+     */
+    getState_CbbSymbol(): {
+        libraryUuid: string;
+        cbbUuid: string;
+        uuid: string;
+    };
+    /* Excluded from this release type: reset */
+    /* Excluded from this release type: done */
+    /* Excluded from this release type: setState_CbbSymbol */
+}
+
 /**
  * 圆图元
  *
@@ -7607,7 +7927,7 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
      * 设置属性状态：其它参数
      *
      * @beta
-     * @param otherProperty - 其它参数
+     * @param otherProperty - 其它参���
      * @returns 器件图元对象
      */
     setState_OtherProperty(otherProperty: {
@@ -7660,7 +7980,19 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
  */
 declare class ISCH_PrimitiveComponent_2 implements ISCH_Primitive {
     /** 异步 */
-    private async;
+    protected async: boolean;
+    /** 坐标 X */
+    protected x: number;
+    /** 坐标 Y */
+    protected y: number;
+    /** 旋转角度 */
+    protected rotation: number;
+    /** 是否镜像 */
+    protected mirror: boolean;
+    /** Component 属性：位号 */
+    protected designator?: string;
+    /** Component 属性：名称 */
+    protected name?: string;
     /** 图元类型 */
     private readonly primitiveType;
     /** 器件类型 */
@@ -7669,30 +8001,24 @@ declare class ISCH_PrimitiveComponent_2 implements ISCH_Primitive {
     private primitiveId?;
     /** 关联库器件 */
     private component;
-    /** 坐标 X */
-    private x;
-    /** 坐标 Y */
-    private y;
     /** 子图块名称 */
     private partId?;
-    /** 旋转角度 */
-    private rotation;
-    /** 是否镜像 */
-    private mirror;
     /** Component 属性：是否加入 BOM */
     private addIntoBom?;
     /** Component 属性：是否转到 PCB */
     private addIntoPcb?;
     /** NetPort 和 NetFlag 属性：网络名称 */
     private net?;
-    /** 关联库符号 UUID */
+    /**
+     * 关联库符号
+     *
+     */
     private symbol?;
-    /** 关联库封装 UUID */
+    /**
+     * 关联库封装
+     *
+     */
     private footprint?;
-    /** Component 属性：位号 */
-    private designator?;
-    /** Component 属性：名称 */
-    private name?;
     /** Component 属性：唯一 ID */
     private uniqueId?;
     /** Component 属性：制造商 */
@@ -8202,7 +8528,7 @@ declare class ISCH_PrimitivePin implements ISCH_Primitive {
      * 设置属性状态：引脚编号
      *
      * @beta
-     * @param pinNumber - 引脚编号
+     * @param pinNumber - 引脚编���
      * @returns 引脚图元对象
      */
     setState_PinNumber(pinNumber: string): ISCH_PrimitivePin;
@@ -8882,7 +9208,7 @@ declare class ISCH_PrimitiveText implements ISCH_Primitive {
      * 设置属性状态：字体大小
      *
      * @beta
-     * @param fontSize - 字体大小
+     * @param fontSize - 字体��小
      * @returns 文本图元对象
      */
     setState_FontSize(fontSize: number | null): ISCH_PrimitiveText;
@@ -9117,6 +9443,88 @@ declare interface ISYS_FileSystemFileList {
     fullPath: string;
 }
 
+/**
+ * 顶部菜单项
+ *
+ * @public
+ */
+declare interface ISYS_HeaderMenus {
+    /** 主页 */
+    home?: Array<ISYS_HeaderMenuTopMenuItem>;
+    /** 空白页 */
+    blank?: Array<ISYS_HeaderMenuTopMenuItem>;
+    /** 原理图 */
+    schematic?: Array<ISYS_HeaderMenuTopMenuItem>;
+    /**
+     * 原理图
+     *
+     * @deprecated 请使用 `schematic` 替代 `sch`
+     */
+    sch?: Array<ISYS_HeaderMenuTopMenuItem>;
+    /** 符号（包括 CBB 符号） */
+    symbol?: Array<ISYS_HeaderMenuTopMenuItem>;
+    /** PCB */
+    pcb?: Array<ISYS_HeaderMenuTopMenuItem>;
+    /** 封装 */
+    footprint?: Array<ISYS_HeaderMenuTopMenuItem>;
+    /** PCB 预览（包括 2D、3D 预览） */
+    pcbView?: Array<ISYS_HeaderMenuTopMenuItem>;
+    /** 面板 */
+    panel?: Array<ISYS_HeaderMenuTopMenuItem>;
+    /** 面板预览 */
+    panelView?: Array<ISYS_HeaderMenuTopMenuItem>;
+}
+
+/**
+ * 顶部二级菜单项
+ *
+ * @public
+ */
+declare interface ISYS_HeaderMenuSub1MenuItem {
+    /** 菜单项 ID，不可重复 */
+    id: string;
+    /** 菜单项标题 */
+    title: string;
+    /** 菜单项图标 */
+    icon?: string;
+    /** 注册方法名称（需要在扩展入口文件导出该方法） */
+    registerFn?: string;
+    /** 子菜单项 */
+    menuItems?: Array<ISYS_HeaderMenuSub2MenuItem | null>;
+}
+
+/**
+ * 顶部三级菜单项
+ *
+ * @public
+ */
+declare interface ISYS_HeaderMenuSub2MenuItem {
+    /** 菜单项 ID，不可重复 */
+    id: string;
+    /** 菜单项标题 */
+    title: string;
+    /** 菜单项图标 */
+    icon?: string;
+    /** 注册方法名称（需要在扩展入口文件导出该方法） */
+    registerFn?: string;
+}
+
+/**
+ * 顶部一级菜单项
+ *
+ * @public
+ */
+declare interface ISYS_HeaderMenuTopMenuItem {
+    /** 菜单项 ID，不可重复 */
+    id: string;
+    /** 菜单项标题 */
+    title: string;
+    /** 注册方法名称（需要在扩展入口文件导出该方法） */
+    registerFn?: string;
+    /** 子菜单项 */
+    menuItems?: Array<ISYS_HeaderMenuSub1MenuItem | null>;
+}
+
 /**
  * 语言数据键值对
  *
@@ -9173,6 +9581,24 @@ declare interface ISYS_MultilingualLanguagesData {
     [language: string]: ISYS_LanguageKeyValuePairs;
 }
 
+/**
+ * 右键菜单项
+ *
+ * @public
+ */
+declare interface ISYS_RightClickMenuItem {
+    /** 菜单项 ID，不可重复 */
+    id: string;
+    /** 菜单项标题 */
+    title?: string;
+    /** 菜单项图标 */
+    icon?: string;
+    /** 注册方法名称（需要在扩展入口文件导出该方法） */
+    registerFn?: string;
+    /** 子菜单项 */
+    menuItems?: Array<ISYS_RightClickMenuItem | null>;
+}
+
 /**
  * 窗口事件监听可移除对象
  *
@@ -9338,7 +9764,7 @@ declare class LIB_Cbb {
      * 在编辑器打开复用模块工程
      *
      * @beta
-     * @remarks 本操作将会在 EDA 前端打开模块工程，如若原先已打开其它工程且有未保存的变更，执行本操作将直接丢失所有未保存的数据
+     * @remarks 本操作将会在 EDA 前端打开模块工程，如若原先已打开其它工程且��未保存的变更，执行本操作将直接丢失所有未保存的数据
      * @param cbbUuid - 复用模块 UUID
      * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
      */
@@ -9427,14 +9853,14 @@ declare class LIB_Classification {
      * @param libraryType - 库类型
      * @returns 分类信息组成的树结构数据
      */
-    getAllClassificationTree(libraryUuid: string, libraryType: ELIB_LibraryType): Promise<{
+    getAllClassificationTree(libraryUuid: string, libraryType: ELIB_LibraryType): Promise<Array<{
         name: string;
         uuid: string;
-        children?: {
+        children?: Array<{
             name: string;
             uuid: string;
-        }[] | undefined;
-    }[]>;
+        }> | undefined;
+    }>>;
     /**
      * 删除指定 UUID 的分类
      *
@@ -9715,17 +10141,20 @@ declare class LIB_Footprint {
  * @remarks 此处所有接口都基于编辑器当前工作区环境，如需切换到其他工作区，请使用 {@link DMT_Workspace.toggleToWorkspace} 接口切换工作区
  */
 declare class LIB_LibrariesList {
+    /** 扩展 UUID */
+    private extensionUuid?;
+    /* Excluded from this release type: __constructor */
     /**
      * 获取系统库的 UUID
      *
-     * @beta
+     * @public
      * @returns 系统库的 UUID
      */
     getSystemLibraryUuid(): Promise<string | undefined>;
     /**
      * 获取个人库的 UUID
      *
-     * @beta
+     * @public
      * @remarks 将会获取当前编辑器工作区下的个人库的 UUID，在私有部署环境下不存在个人库，此接口将永远返回 `undefined`
      * @returns 个人库的 UUID
      */
@@ -9733,7 +10162,7 @@ declare class LIB_LibrariesList {
     /**
      * 获取工程库的 UUID
      *
-     * @beta
+     * @public
      * @remarks 在未打开工程的情况下调用将返回 `undefined`
      * @returns 工程库的 UUID
      */
@@ -9741,7 +10170,7 @@ declare class LIB_LibrariesList {
     /**
      * 获取收藏库的 UUID
      *
-     * @beta
+     * @public
      * @remarks 将会获取当前编辑器工作区下的收藏库的 UUID
      * @returns 收藏库的 UUID
      */
@@ -9749,11 +10178,12 @@ declare class LIB_LibrariesList {
     /**
      * 获取所有库的列表
      *
-     * @beta
+     * @public
      * @remarks 此处不会获取到系统库、个人库、工程库、收藏库的信息，如需获取它们的信息，请使用 {@link LIB_LibrariesList.getSystemLibraryUuid | getSystemLibraryUuid}、{@link LIB_LibrariesList.getPersonalLibraryUuid | getPersonalLibraryUuid}、{@link LIB_LibrariesList.getProjectLibraryUuid | getProjectLibraryUuid}、{@link LIB_LibrariesList.getFavoriteLibraryUuid | getFavoriteLibraryUuid} 接口
      * @returns 库信息列表
      */
     getAllLibrariesList(): Promise<Array<ILIB_LibraryInfo>>;
+    /* Excluded from this release type: registerExtendLibrary */
 }
 
 /**
@@ -10798,7 +11228,7 @@ declare class PCB_ManufactureData {
      */
     uploadBomTemplateFile(templateFile: File, template?: string): Promise<string | undefined>;
     /**
-     * 获取 BOM 模板���件
+     * 获取 BOM 模板文件
      *
      * @beta
      * @param template - BOM 模板名称
@@ -11955,7 +12385,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>>;
     /**
@@ -13301,6 +13731,8 @@ declare class SCH_PrimitiveComponent3 implements ISCH_PrimitiveAPI {
      * @returns 器件图元对象
      */
     createShortCircuitFlag(x: number, y: number, rotation?: number, mirror?: boolean): Promise<ISCH_PrimitiveComponent_2 | undefined>;
+    /* Excluded from this release type: createCbbSymbol */
+    /* Excluded from this release type: placeCbbSchematicPage */
     /**
      * 删除器件
      *
@@ -14341,9 +14773,20 @@ declare class SYS_FileSystem {
      *
      * @beta
      * @param filenameExtensions - 文件扩展名
+     * @param multiFiles - 是否允许读取多文件
+     * @returns File 格式文件数组
+     */
+    openReadFileDialog(filenameExtensions?: string | Array<string>, multiFiles?: true): Promise<Array<File> | undefined>;
+    /**
+     * 打开读入文件窗口
+     *
+     * @beta
+     * @param filenameExtensions - 文件扩展名
+     * @param multiFiles - 是否允许读取多文件
      * @returns File 格式文件
      */
-    openReadFileDialog(filenameExtensions?: string | Array<string>): Promise<File | undefined>;
+    openReadFileDialog(filenameExtensions?: string | Array<string>, multiFiles?: false): Promise<File | undefined>;
+    /* Excluded from this release type: openReadFolderDialog */
     /**
      * 保存文件
      *
@@ -14496,6 +14939,41 @@ declare class SYS_FontManager {
     deleteFont(fontName: string): Promise<boolean>;
 }
 
+/**
+ * 系统 / 顶部菜单类
+ *
+ * @public
+ */
+declare class SYS_HeaderMenu {
+    /** 扩展 UUID */
+    private extensionUuid?;
+    /* Excluded from this release type: __constructor */
+    /**
+     * 导入顶部菜单数据
+     *
+     * @public
+     * @param headerMenus - 顶部菜单数据
+     */
+    insertHeaderMenus(headerMenus: ISYS_HeaderMenus): Promise<void>;
+    /**
+     * 移除顶部菜单数据
+     *
+     * @public
+     */
+    removeHeaderMenus(): void;
+    /**
+     * 替换顶部菜单数据
+     *
+     * @public
+     * @remarks 本接口相当于同时执行了 {@link SYS_HeaderMenu.removeHeaderMenus | 移除} 和 {@link SYS_HeaderMenu.insertHeaderMenus | 导入} 操作
+     * @param headerMenus - 顶部菜单数据
+     */
+    replaceHeaderMenus(headerMenus: ISYS_HeaderMenus): Promise<void>;
+    /* Excluded from this release type: removeSystemHeaderMenuItem */
+    /* Excluded from this release type: insertSystemHeaderMenuItem */
+    /* Excluded from this release type: insertSystemHeaderMenus */
+}
+
 /**
  * 系统 / 多语言类
  *
@@ -15078,6 +15556,18 @@ declare class SYS_PanelControl {
     isBottomPanelLocked(): Promise<boolean>;
 }
 
+/**
+ * 系统 / 右键菜单类
+ *
+ * @public
+ */
+declare class SYS_RightClickMenu {
+    /** 扩展 UUID */
+    private extensionUuid?;
+    /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: changeMenu */
+}
+
 /**
  * 系统 / 设置类
  *
@@ -15087,6 +15577,7 @@ declare class SYS_Setting {
     /**
      * 全局恢复默认设置
      *
+     * @beta
      * @remarks 将所有 EDA 设置恢复到默认状态，本操作将会丢失所有设置项，在调用时请特别注意
      * @returns 操作是否成功
      */
@@ -15222,7 +15713,7 @@ declare class SYS_Timer {
     private extensionUuid?;
     /* Excluded from this release type: __constructor */
     /**
-     * 设置循环定时��
+     * 设置循环定时器
      *
      * @public
      * @remarks 如果遇到 ID 重复的定时器，则之前设置的定时器将被清除
@@ -15292,7 +15783,20 @@ declare class SYS_ToastMessage {
  * @public
  */
 declare class SYS_Tool {
-    /* Excluded from this release type: netlistComparison */
+    /**
+     * 网表对比
+     *
+     * @beta
+     * @param netlist1 - 网表 1，可以为当前工程内�� PCB 和原理图的 UUID、网表的文件数据
+     * @param netlist2 - 网表 2，可以为当前工程内的 PCB 和原理图的 UUID、网表的文件数据
+     * @returns 网表对比结果
+     */
+    netlistComparison(netlist1: string | File, netlist2: string | File): Promise<Array<{
+        type: 'Net' | 'Component';
+        object: string;
+        netlist1Name: Array<string>;
+        netlist2Name: Array<string>;
+    }>>;
 }
 
 /**
@@ -15425,7 +15929,7 @@ declare class SYS_Window {
     /**
      * 打开资源窗口
      *
-     * @beta
+     * @public
      * @param url - 欲加载资源的 URL 或路径
      * @param target - 上下文目标
      */
@@ -15433,7 +15937,7 @@ declare class SYS_Window {
     /**
      * 新增事件监听
      *
-     * @beta
+     * @public
      * @param type - 事件类型，当前支持 `blur` `focus`
      * @param listener - 事件监听回调
      * @param options - 可选参数
@@ -15448,11 +15952,21 @@ declare class SYS_Window {
     /**
      * 移除事件监听
      *
-     * @beta
+     * @public
      * @param removableObject - 窗口事件监听可移除对象
      */
     removeEventListener(removableObject: ISYS_WindowEventListenerRemovableObject): void;
-    /* Excluded from this release type: openUI */
+    /**
+     * 打开 UI 窗口
+     *
+     * @public
+     * @remarks 非公开接口使用提醒：本接口按原样提供，不提供参数的额外文档，参数可能在任何版本出现破坏性更改并不另行通知
+     * @param uiName - UI 名称
+     * @param args - 可选参数对象
+     */
+    openUI(uiName: string, args?: {
+        [key: string]: any;
+    }): Promise<void>;
     /**
      * 获取当前主题
      *

package/package.json

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