@jlceda/pro-api-types 0.1.110 → 0.1.112

package/index.d.ts

@@ -180,6 +180,11 @@ declare class DMT_EditorControl {
      * @returns 操作是否成功
      */
     mergeAllDocumentFromSplitScreen(): Promise<boolean>;
+    /* Excluded from this release type: getCurrentRenderedAreaImage */
+    /* Excluded from this release type: zoomToRegion */
+    /* Excluded from this release type: zoomTo */
+    /* Excluded from this release type: zoomToAllPrimitives */
+    /* Excluded from this release type: zoomToSelectedPrimitives */
 }
 
 /**
@@ -196,7 +201,7 @@ declare class DMT_Folder {
      * @param teamUuid - 团队 UUID
      * @param parentFolderUuid - 父文件夹 UUID，如若不指定，则为根文件夹
      * @param description - 文件夹描述
-     * @returns 文���夹 UUID，如若为 `undefined` 则创建失败
+     * @returns 文件夹 UUID，如若为 `undefined` 则创建失败
      */
     createFolder(folderName: string, teamUuid: string, parentFolderUuid?: string, description?: string): Promise<string | undefined>;
     /**
@@ -311,7 +316,7 @@ declare class DMT_Panel {
      *
      * @public
      * @remarks 将会获取当前打开且拥有最后输入焦点的面板的详细属性
-     * @returns 面板���详细属性，如若为 `undefined` 则获取失败
+     * @returns 面板的详细属性，如若为 `undefined` 则获取失败
      */
     getCurrentPanelInfo(): Promise<IDMT_PanelItem | undefined>;
     /**
@@ -417,7 +422,7 @@ declare class DMT_Project {
      * @param teamUuid - 团队 UUID，如若不指定，则默认为个人；在不存在个人工程的环境下必须指定团队 UUID
      * @param folderUuid - 文件夹 UUID，如若不指定，则为根文件夹
      * @param description - 工程描述
-     * @param collaborationMode - 工程协作���式，如若团队权限无需工程设置协作模式，则该参数将被忽略
+     * @param collaborationMode - 工程协作模式，如若团队权限无需工程设置协作模式，则该参数将被忽略
      * @returns 工程 UUID，如若为 `undefined` 则创建失败
      */
     createProject(projectFriendlyName: string, projectName?: string, teamUuid?: string, folderUuid?: string, description?: string, collaborationMode?: EDMT_ProjectCollaborationMode): Promise<string | undefined>;
@@ -500,7 +505,7 @@ declare class DMT_Schematic {
      * 修改原理图名称
      *
      * @beta
-     * @remarks 如若原理图已关联复用模块（在工程库内存在同名的复用模块符号），则修改名称时将同步修改复用模块符号名称与关联 PCB 名称
+     * @remarks 如若原理图已关联复用模块（在工程库内存在同名的复用模块符号），则修改名称时将同步修改复用模块符号名称与关联 PCB ���称
      * @param schematicUuid - 原理图 UUID
      * @param schematicName - 原理图名称
      * @returns 是否修改成功
@@ -987,6 +992,20 @@ declare enum EPCB_DocumentRatlineCalculatingActiveStatus {
     INACTIVE = "inactive"
 }
 
+/**
+ * 非激活层展示模式
+ *
+ * @public
+ */
+declare enum EPCB_InactiveLayerDisplayMode {
+    /** 正常亮度 */
+    NORMAL_BRIGHTNESS = 0,
+    /** 置灰 */
+    TURN_GRAY = 1,
+    /** 隐藏 */
+    HIDE = 2
+}
+
 /**
  * 图层颜色配置
  *
@@ -1167,7 +1186,7 @@ declare enum EPCB_LayerId {
     CUSTOM_28 = 98,
     /** 自定义层 29 */
     CUSTOM_29 = 99,
-    /** 自定义层 30 */
+    /** ��定义层 30 */
     CUSTOM_30 = 100,
     /** 夹层（介电基板）1 */
     SUBSTRATE_1 = 101,
@@ -2094,12 +2113,36 @@ declare interface ILIB_ClassificationIndex {
  * @public
  */
 declare interface ILIB_DeviceAssociationItem {
-    /** 符号类型 */
+    /**
+     * 符号类型
+     *
+     * @deprecated 请使用 {@link ILIB_DeviceSearchItem.symbol | symbol} 替代
+     */
     symbolType: ELIB_SymbolType;
-    /** 符号 UUID */
+    /**
+     * 符号 UUID
+     *
+     * @deprecated 请使用 {@link ILIB_DeviceSearchItem.symbol | symbol} 替代
+     */
     symbolUuid: string;
-    /** 封装 UUID */
-    footprintUuid?: string;
+    /** 符号 */
+    symbol: {
+        type: ELIB_SymbolType;
+        uuid: string;
+        libraryUuid: string;
+    };
+    /**
+     * 封装 UUID
+     *
+     * @deprecated 请使用 {@link ILIB_DeviceSearchItem.footprint | footprint} 替代
+     */
+    footprintUuid: string;
+    /** 封装 */
+    footprint?: {
+        uuid: string;
+        libraryUuid: string;
+    };
+    images?: Array<string>;
 }
 
 /**
@@ -2126,8 +2169,10 @@ declare interface ILIB_DeviceExtendPropertyItem {
     supplier?: string;
     /** 供应商编号 */
     supplierId?: string;
-    /** 其它 */
-    [key: string]: boolean | number | string | undefined;
+    /** 其它参数 */
+    otherProperty?: {
+        [key: string]: boolean | number | string | undefined;
+    };
 }
 
 /**
@@ -2196,18 +2241,60 @@ declare interface ILIB_DeviceSearchItem {
     ordinal: number;
     /** 器件名称 */
     name: string;
-    /** 关联符号名称 */
+    /**
+     * 关联符号名称
+     *
+     * @deprecated 请使用 {@link ILIB_DeviceSearchItem.symbol | symbol} 替代
+     */
     symbolName: string;
-    /** 关联符号 UUID */
+    /**
+     * 关联符号 UUID
+     *
+     * @deprecated 请使用 {@link ILIB_DeviceSearchItem.symbol | symbol} 替代
+     */
     symbolUuid: string;
-    /** 关联封装名称 */
+    /** 关联符号 */
+    symbol: {
+        name: string;
+        uuid: string;
+        libraryUuid: string;
+    };
+    /**
+     * 关联封装名称
+     *
+     * @deprecated 请使用 {@link ILIB_DeviceSearchItem.footprint | footprint} 替代
+     */
     footprintName?: string;
-    /** 关联封装 UUID */
-    footprintUuid?: string;
-    /** 关联 3D 模型名称 */
+    /**
+     * 关联封装 UUID
+     *
+     * @deprecated 请使用 {@link ILIB_DeviceSearchItem.footprint | footprint} 替代
+     */
+    footprintUuid: string;
+    /** 关联封装 */
+    footprint?: {
+        name: string;
+        uuid: string;
+        libraryUuid: string;
+    };
+    /**
+     * 关联 3D 模型名称
+     *
+     * @deprecated 请使用 {@link ILIB_DeviceSearchItem.model3D | model3D} 替代
+     */
     model3DName?: string;
-    /** 关联 3D 模型 UUID */
-    model3DUuid?: string;
+    /**
+     * 关联 3D 模型 UUID
+     *
+     * @deprecated 请使用 {@link ILIB_DeviceSearchItem.model3D | model3D} 替代
+     */
+    model3DUuid: string;
+    /** 关联 3D 模型 */
+    model3D?: {
+        name: string;
+        uuid: string;
+        libraryUuid: string;
+    };
     /** 关联图片 UUID */
     imageUuid?: string;
     /** 描述 */
@@ -2449,6 +2536,8 @@ declare interface IPCB_EqualLengthNetGroupItem {
     name: string;
     /** 网络名称数组 */
     nets: Array<string>;
+    /** 等长网络组颜色 */
+    color: string | null;
 }
 
 /**
@@ -2479,6 +2568,22 @@ declare interface IPCB_NetClassItem {
     name: string;
     /** 网络名称数组 */
     nets: Array<string>;
+    /** 网络类颜色 */
+    color: string | null;
+}
+
+/**
+ * 网络属性
+ *
+ * @public
+ */
+declare interface IPCB_NetInfo {
+    /** 网络名称 */
+    net: string;
+    /** 颜色 */
+    color: string | null;
+    /** 长度 */
+    length: number;
 }
 
 /**
@@ -2801,9 +2906,18 @@ declare class IPCB_PrimitiveArc implements IPCB_Primitive {
      * 获取整段导线
      *
      * @beta
+     * @param includeVias - 是否包含导线两端的过孔
      * @returns 整段导线内的所有直线和圆弧线
      */
-    getEntireTrack(): Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc>>;
+    getEntireTrack(includeVias: false): Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc>>;
+    /**
+     * 获取整段导线
+     *
+     * @beta
+     * @param includeVias - 是否包含导线两端的过孔
+     * @returns 整段导线内的所有直线、圆弧线，以及两端连接的过孔（如果有）
+     */
+    getEntireTrack(includeVias: true): Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc | IPCB_PrimitiveVia>>;
 }
 
 /**
@@ -2996,7 +3110,7 @@ declare class IPCB_PrimitiveComponent implements IPCB_Primitive {
      */
     getState_Supplier(): string | undefined;
     /**
-     * 获取属性状态：供应商编号
+     * 获取属���状态：供应商编号
      *
      * @public
      * @returns 供应商编号
@@ -3147,7 +3261,7 @@ declare class IPCB_PrimitiveComponent implements IPCB_Primitive {
      */
     isAsync(): boolean;
     /**
-     * 将异步图元重置为当前画布状态
+     * 将异���图元重置为当前画布状态
      *
      * @beta
      * @returns 器件图元对象
@@ -3194,6 +3308,8 @@ declare class IPCB_PrimitiveComponentPad extends IPCB_PrimitivePad {
      * @returns 器件焊盘图元对象
      */
     done(): Promise<IPCB_PrimitiveComponentPad>;
+    /* Excluded from this release type: getConnectedPrimitives */
+    getConnectedPrimitives(onlyCentreConnection: false): Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc | IPCB_PrimitiveVia | IPCB_PrimitivePolyline | IPCB_PrimitiveFill>;
 }
 
 /**
@@ -3569,7 +3685,7 @@ declare class IPCB_PrimitiveFill implements IPCB_Primitive {
      */
     convertToPour(): Promise<IPCB_PrimitivePour>;
     /**
-     * 转换到：区��图元(默认是禁止区域)
+     * 转换到：区域图元(默认是禁止区域)
      *
      * @beta
      * @returns 区域图元对象
@@ -3685,7 +3801,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @public
      * @returns 是否锁定
      */
-    getState_PrimitiveLock(): boolean | undefined;
+    getState_PrimitiveLock(): boolean;
     /**
      * 设置属性状态：BBox 左上点坐标 X
      *
@@ -3693,7 +3809,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @param x - BBox 左上点坐标 X
      * @returns 图像图元对象
      */
-    setState_X(x: number | undefined): IPCB_PrimitiveImage;
+    setState_X(x: number): IPCB_PrimitiveImage;
     /**
      * 设置属性状态：BBox 左上点坐标 Y
      *
@@ -3701,7 +3817,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @param y - BBox 左上点坐标 Y
      * @returns 图像图元对象
      */
-    setState_Y(y: number | undefined): IPCB_PrimitiveImage;
+    setState_Y(y: number): IPCB_PrimitiveImage;
     /**
      * 设置属性状态：层
      *
@@ -3709,7 +3825,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @param layer - 层
      * @returns 图像图元对象
      */
-    setState_Layer(layer: TPCB_LayersOfImage | undefined): IPCB_PrimitiveImage;
+    setState_Layer(layer: TPCB_LayersOfImage): IPCB_PrimitiveImage;
     /**
      * 设置属性状态：宽
      *
@@ -3717,7 +3833,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @param width - 宽
      * @returns 图像图元对象
      */
-    setState_Width(width: number | undefined): IPCB_PrimitiveImage;
+    setState_Width(width: number): IPCB_PrimitiveImage;
     /**
      * 设置属性状态：高
      *
@@ -3725,7 +3841,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @param height - 高
      * @returns 图像图元对象
      */
-    setState_Height(height: number | undefined): IPCB_PrimitiveImage;
+    setState_Height(height: number): IPCB_PrimitiveImage;
     /**
      * 设置属性状态：旋转角度
      *
@@ -3733,7 +3849,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @param rotation - 旋转角度
      * @returns 图像图元对象
      */
-    setState_Rotation(rotation: number | undefined): IPCB_PrimitiveImage;
+    setState_Rotation(rotation: number): IPCB_PrimitiveImage;
     /**
      * 设置属性状态：是否水平镜像
      *
@@ -3741,7 +3857,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @param horizonMirror - 是否水平镜像
      * @returns 图像图元对象
      */
-    setState_HorizonMirror(horizonMirror: boolean | undefined): IPCB_PrimitiveImage;
+    setState_HorizonMirror(horizonMirror: boolean): IPCB_PrimitiveImage;
     /**
      * 设置属性状态：是否锁定
      *
@@ -3749,7 +3865,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @param primitiveLock - 是否锁定
      * @returns 图像图元对象
      */
-    setState_PrimitiveLock(primitiveLock: boolean | undefined): IPCB_PrimitiveImage;
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveImage;
     /**
      * 将图元转换为异步图元
      *
@@ -3941,7 +4057,7 @@ declare class IPCB_PrimitiveLine implements IPCB_Primitive {
      *
      * @beta
      * @param lineWidth - 线宽
-     * @returns 直线图元对象
+     * @returns 直线图元对���
      */
     setState_LineWidth(lineWidth: number): IPCB_PrimitiveLine;
     /**
@@ -3999,9 +4115,18 @@ declare class IPCB_PrimitiveLine implements IPCB_Primitive {
      * 获取整段导线
      *
      * @beta
+     * @param includeVias - 是否包含导线两端的过孔
      * @returns 整段导线内的所有直线和圆弧线
      */
-    getEntireTrack(): Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc>>;
+    getEntireTrack(includeVias: false): Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc>>;
+    /**
+     * 获取整段导线
+     *
+     * @beta
+     * @param includeVias - 是否包含导线两端的过孔
+     * @returns 整段导线内的所有直线、圆弧线，以及两端连接的过孔（如果有）
+     */
+    getEntireTrack(includeVias: true): Promise<Array<IPCB_PrimitiveLine | IPCB_PrimitiveArc | IPCB_PrimitiveVia>>;
 }
 
 /**
@@ -4067,7 +4192,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      */
     getState_TopLeftX(): number | undefined;
     /**
-     * 获取属性状态：左上�� Y
+     * 获取属性状态：左上点 Y
      *
      * @public
      * @returns 左上点 Y
@@ -4086,42 +4211,42 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @public
      * @returns 宽
      */
-    getState_Width(): number | undefined;
+    getState_Width(): number;
     /**
      * 获取属性状态：高
      *
      * @public
      * @returns 高
      */
-    getState_Height(): number | undefined;
+    getState_Height(): number;
     /**
      * 获取属性状态：旋转角度
      *
      * @public
      * @returns 旋转角度
      */
-    getState_Rotation(): number | undefined;
+    getState_Rotation(): number;
     /**
      * 获取属性状态：是否水平镜像
      *
      * @public
      * @returns 是否水平镜像
      */
-    getState_Mirror(): boolean | undefined;
+    getState_Mirror(): boolean;
     /**
      * 获取属性状态：文件名
      *
      * @public
      * @returns 文件名
      */
-    getState_FileName(): string | undefined;
+    getState_FileName(): string;
     /**
      * 获取属性状态：是否锁定
      *
      * @public
      * @returns 是否锁定
      */
-    getState_PrimitiveLock(): boolean | undefined;
+    getState_PrimitiveLock(): boolean;
     /**
      * 设置属性状态：层
      *
@@ -4129,7 +4254,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @param layer - 层
      * @returns 二进制内嵌对象图元对象
      */
-    setState_Layer(layer: TPCB_LayersOfObject | undefined): IPCB_PrimitiveObject;
+    setState_Layer(layer: TPCB_LayersOfObject): IPCB_PrimitiveObject;
     /**
      * 设置属性状态：左上点 X
      *
@@ -4137,7 +4262,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @param topLeftX - 左上点 X
      * @returns 二进制内嵌对象图元对象
      */
-    setState_TopLeftX(topLeftX: number | undefined): IPCB_PrimitiveObject;
+    setState_TopLeftX(topLeftX: number): IPCB_PrimitiveObject;
     /**
      * 设置属性状态：左上点 Y
      *
@@ -4145,7 +4270,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @param topLeftY - 左上点 Y
      * @returns 二进制内嵌对象图元对象
      */
-    setState_TopLeftY(topLeftY: number | undefined): IPCB_PrimitiveObject;
+    setState_TopLeftY(topLeftY: number): IPCB_PrimitiveObject;
     /**
      * 设置属性状态：二进制数据
      *
@@ -4161,7 +4286,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @param width - 宽
      * @returns 二进制内嵌对象图元对象
      */
-    setState_Width(width: number | undefined): IPCB_PrimitiveObject;
+    setState_Width(width: number): IPCB_PrimitiveObject;
     /**
      * 设置属性状态：高
      *
@@ -4169,7 +4294,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @param height - 高
      * @returns 二进制内嵌对象图元对象
      */
-    setState_Height(height: number | undefined): IPCB_PrimitiveObject;
+    setState_Height(height: number): IPCB_PrimitiveObject;
     /**
      * 设置属性状态：旋转角度
      *
@@ -4177,7 +4302,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @param rotation - 旋转角度
      * @returns 二进制内嵌对象图元对象
      */
-    setState_Rotation(rotation: number | undefined): IPCB_PrimitiveObject;
+    setState_Rotation(rotation: number): IPCB_PrimitiveObject;
     /**
      * 设置属性状态：是否水平镜像
      *
@@ -4185,7 +4310,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @param mirror - 是否水平镜像
      * @returns 二进制内嵌对象图元对象
      */
-    setState_Mirror(mirror: boolean | undefined): IPCB_PrimitiveObject;
+    setState_Mirror(mirror: boolean): IPCB_PrimitiveObject;
     /**
      * 设置属性状态：文件名
      *
@@ -4193,7 +4318,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @param fileName - 文件名
      * @returns 二进制内嵌对象图元对象
      */
-    setState_FileName(fileName: string | undefined): IPCB_PrimitiveObject;
+    setState_FileName(fileName: string): IPCB_PrimitiveObject;
     /**
      * 设置属性状态：是否锁定
      *
@@ -4201,7 +4326,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
      * @param primitiveLock - 是否锁定
      * @returns 二进制内嵌对象图元对象
      */
-    setState_PrimitiveLock(primitiveLock: boolean | undefined): IPCB_PrimitiveObject;
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveObject;
     /**
      * 将图元转换为异步图元
      *
@@ -5858,7 +5983,7 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
      */
     getState_ComponentType(): ESCH_PrimitiveComponentType;
     /**
-     * 获取属性状态：���元 ID
+     * 获取属性状态：图元 ID
      *
      * @public
      * @returns 图元 ID
@@ -6967,7 +7092,7 @@ declare class LIB_Device {
      * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @param deviceName - 器件名称
      * @param classification - 分类
-     * @param association - 关联符号、封装、图像，指定 `symbolType` 则创建新符号，无需新建符号则无需指定 `symbolType`，但请注意，如若不新建符号也不指定符号的 UUID 将无法创建器件
+     * @param association - 关联符号、封装、图像，指定 `symbolType` 则创建新符号，无需新建符号则无需指定 `symbolType`，但请注意，如若不新建符号也不指定符号的关联信息将无法创建器件
      * @param description - 描述
      * @param property - 其它参数，仅 `designator`、`addIntoBom`、`addIntoPcb` 存在默认值
      * @returns 器件 UUID
@@ -6975,14 +7100,27 @@ declare class LIB_Device {
     create(libraryUuid: string, deviceName: string, classification?: ILIB_ClassificationIndex, association?: {
         symbolType?: ELIB_SymbolType;
         symbolUuid?: string;
+        symbol?: {
+            uuid: string;
+            libraryUuid: string;
+        };
         footprintUuid?: string;
+        footprint?: {
+            uuid: string;
+            libraryUuid: string;
+        };
+        model3D?: {
+            uuid: string;
+            libraryUuid: string;
+        };
+        imageData?: File | Blob;
     }, description?: string, property?: ILIB_DeviceExtendPropertyItem): Promise<string | undefined>;
     /**
      * 删除器件
      *
      * @beta
-     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @param deviceUuid - 器件 UUID
+     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @returns 操作是否成功
      */
     delete(deviceUuid: string, libraryUuid: string): Promise<boolean>;
@@ -7002,8 +7140,20 @@ declare class LIB_Device {
      */
     modify(deviceUuid: string, libraryUuid: string, deviceName?: string, classification?: ILIB_ClassificationIndex | null, association?: {
         symbolUuid?: string;
+        symbol?: {
+            uuid: string;
+            libraryUuid: string;
+        };
         footprintUuid?: string | null;
-        imageData?: Blob | null;
+        footprint?: {
+            uuid: string;
+            libraryUuid: string;
+        } | null;
+        model3D?: {
+            uuid: string;
+            libraryUuid: string;
+        } | null;
+        imageData?: File | Blob | null;
     }, description?: string | null, property?: {
         name?: string | null;
         designator?: string;
@@ -7014,7 +7164,9 @@ declare class LIB_Device {
         manufacturerId?: string | null;
         supplier?: string | null;
         supplierId?: string | null;
-        [key: string]: boolean | number | string | undefined | null;
+        otherProperty?: {
+            [key: string]: boolean | number | string | undefined | null;
+        };
     }): Promise<boolean>;
     /**
      * 获取器件的所有属性
@@ -7553,7 +7705,7 @@ declare class PCB_Document {
      */
     setCanvasOrigin(offsetX: number, offsetY: number): Promise<boolean>;
     /**
-     * 定位到画布坐标
+     * 定位到画布���标
      *
      * @public
      * @remarks
@@ -7571,6 +7723,7 @@ declare class PCB_Document {
     /* Excluded from this release type: navigateToRegion */
     /* Excluded from this release type: getPrimitiveAtPoint */
     /* Excluded from this release type: getPrimitivesInRegion */
+    /* Excluded from this release type: zoomToBoardOutline */
 }
 
 /**
@@ -7583,12 +7736,23 @@ declare class PCB_Drc {
     /**
      * 检查 DRC
      *
-     * @public
-     * @param strict - 是否严格检查，严格检查时存在 Warning 将返回 `false`，否则返回 `true`
+     * @beta
+     * @param strict - 是否严格检查，当前 PCB 统一为严格检查模式
      * @param userInterface - 是否显示 UI（呼出底部 DRC 窗口）
-     * @returns DRC 检查是否无错误
+     * @param includeVerboseError - 是否在返回值中包含详细错误信息，如若为 `true`，则返回值将始终为数组
+     * @returns DRC 检查是否通过
      */
-    check(strict?: boolean, userInterface?: boolean): Promise<boolean>;
+    check(strict: boolean, userInterface: boolean, includeVerboseError: false): Promise<boolean>;
+    /**
+     * 检查 DRC
+     *
+     * @beta
+     * @param strict - 是否严格检查，当前 PCB 统一为严格检查模式
+     * @param userInterface - 是否显示 UI（呼出底部 DRC 窗口）
+     * @param includeVerboseError - 是否在返回值中包含详细错误信息，如若为 `true`，则返回值将始终为数组
+     * @returns DRC 检查的详细结果
+     */
+    check(strict: boolean, userInterface: boolean, includeVerboseError: true): Promise<Array<any>>;
     /**
      * 获取当前设计规则配置名称
      *
@@ -7632,7 +7796,7 @@ declare class PCB_Drc {
      * @remarks 只有自定义配置可以覆盖保存，系统配置不允许修改和覆盖
      * @param ruleConfiguration - 设计规则配置
      * @param configurationName - 配置名称
-     * @param allowOverwrite - 是否允许覆写同名设计规则配置，`false` 则将在遇到同名设计规则配置时返回 `false`，请注意可能的数据丢失风险
+     * @param allowOverwrite - ��否允许覆写同名设计规则配置，`false` 则将在遇到同名设计规则配置时返回 `false`，请注意可能的数据丢失风险
      * @returns 保存是否成功
      */
     saveRuleConfiguration(ruleConfiguration: {
@@ -7739,9 +7903,10 @@ declare class PCB_Drc {
      * @beta
      * @param netClassName - 网络类名称
      * @param nets - 网络名称数组
+     * @param color - 网络类颜色
      * @returns 操作是否成功
      */
-    createNetClass(netClassName: string, nets: Array<string>): Promise<boolean>;
+    createNetClass(netClassName: string, nets: Array<string>, color?: string | null): Promise<boolean>;
     /**
      * 删除网络类
      *
@@ -7754,7 +7919,7 @@ declare class PCB_Drc {
      * 修改网络类的名称
      *
      * @beta
-     * @param originalNetClassName - 原网络类名称
+     * @param originalNetClassName - ��网络类名称
      * @param netClassName - 新网络类名称
      * @returns 操作是否成功
      */
@@ -7842,9 +8007,10 @@ declare class PCB_Drc {
      * @beta
      * @param equalLengthNetGroupName - 等长网络组名称
      * @param nets - 网络名称数组
+     * @param color - 等长网络组颜色
      * @returns 操作是否成功
      */
-    createEqualLengthNetGroup(equalLengthNetGroupName: string, nets: Array<string>): Promise<boolean>;
+    createEqualLengthNetGroup(equalLengthNetGroupName: string, nets: Array<string>, color?: string | null): Promise<boolean>;
     /**
      * 删除等长网络组
      *
@@ -7894,6 +8060,10 @@ declare class PCB_Drc {
      * @param padPairGroupName - 焊盘对组名称
      * @param padPairs - 焊盘对数组
      * @returns 操作是否成功
+     * @example 有三种不同的用法，确保画布上已有对应的焊盘。 分别是 一，游离焊盘-游离焊盘；二，器件焊盘 - 器件焊盘；三，器件焊盘 - 游离焊盘
+     * await eda.pcb_Drc.createPadPairGroup('test',[['e0','e1']]) // 游离焊盘-游离焊盘
+     * await eda.pcb_Drc.createPadPairGroup('test',[['R1:1','R1:2'],['R2:1','R2:2']]) // 器件焊盘 - 器件焊盘
+     * await eda.pcb_Drc.createPadPairGroup('test',[['R1:1','e0'],['R1:2','e1']]) // 器件焊盘 - 游离焊盘
      */
     createPadPairGroup(padPairGroupName: string, padPairs: Array<[string, string]>): Promise<boolean>;
     /**
@@ -7920,6 +8090,10 @@ declare class PCB_Drc {
      * @param padPairGroupName - 焊盘对组名称
      * @param padPair - 焊盘对
      * @returns 操作是否成功
+     * @example 有三种不同的用法，确保画布上已有对应的焊盘。 分别是 一，游离焊盘-游离焊盘；二，器件焊盘 - 器件焊盘；三，器件焊盘 - 游离焊盘
+     * await eda.pcb_Drc.addPadPairToPadPairGroup('test',['e0','e1']) // 游离焊盘-游离焊盘
+     * await eda.pcb_Drc.addPadPairToPadPairGroup('test',['R1:1','R1:2']) // 器件焊盘 - 器件焊盘
+     * await eda.pcb_Drc.addPadPairToPadPairGroup('test',['R1:1','e1']) // 器件焊盘 - 游离焊盘
      */
     addPadPairToPadPairGroup(padPairGroupName: string, padPair: [string, string] | Array<[string, string]>): Promise<boolean>;
     /**
@@ -7929,6 +8103,10 @@ declare class PCB_Drc {
      * @param padPairGroupName - 焊盘对组名称
      * @param padPair - 焊盘对
      * @returns 操作是否成功
+     * @example 有三种不同的用法，确保画布上已有对应的焊盘。 分别是 一，游离焊盘-游离焊盘；二，器件焊盘 - 器件焊盘；三，器件焊盘 - 游离焊盘
+     * await eda.pcb_Drc.removePadPairFromPadPairGroup('test',['e0','e1']) // 游离焊盘-游离焊盘
+     * await eda.pcb_Drc.removePadPairFromPadPairGroup('test',['R1:1','R1:2']) // 器件焊盘 - 器件焊盘
+     * await eda.pcb_Drc.removePadPairFromPadPairGroup('test',['R1:2','e1']) // 器件焊盘 - 游离焊盘
      */
     removePadPairFromPadPairGroup(padPairGroupName: string, padPair: [string, string] | Array<[string, string]>): Promise<boolean>;
     /**
@@ -8052,7 +8230,7 @@ declare class PCB_Layer {
      * 设置非激活层透明度
      *
      * @beta
-     * @param transparency - 透明度
+     * @param transparency - 透明度，范围 `0-100`
      * @returns 操作是否成功
      */
     setInactiveLayerTransparency(transparency: number): Promise<boolean>;
@@ -8110,6 +8288,7 @@ declare class PCB_Layer {
      * @returns 所有图层的详细属性
      */
     getAllLayers(): Promise<Array<IPCB_LayerItem>>;
+    /* Excluded from this release type: setInactiveLayerDisplayMode */
 }
 
 /**
@@ -8496,7 +8675,7 @@ declare class PCB_MathPolygon {
      * @param smoothing - 平滑，取值范围 `0`-`1.33`
      * @param despeckling - 去斑，取值范围 `0`-`5`
      * @param inversion - 是否反相
-     * @returns 复杂多边形对象
+     * @returns 复杂多���形对象
      */
     convertImageToComplexPolygon(imageBlob: Blob, imageWidth: number, imageHeight: number, tolerance?: number, simplification?: number, smoothing?: number, despeckling?: number, inversion?: boolean): Promise<IPCB_ComplexPolygon | undefined>;
 }
@@ -8507,21 +8686,33 @@ declare class PCB_MathPolygon {
  * @public
  */
 declare class PCB_Net {
+    /* Excluded from this release type: getAllNets */
+    /* Excluded from this release type: getNet */
     /**
      * 获取所有网络的网络名称
      *
-     * @beta
+     * @public
+     * @returns 网络名称数组
+     */
+    getAllNetsName(): Promise<Array<string>>;
+    /**
+     * 获取所有网络的网络名称
+     *
+     * @public
+     * @deprecated 请使用 {@link PCB_Net.getAllNetsName | getAllNetsName} 替代
      * @returns 网络名称数组
      */
     getAllNetName(): Promise<Array<string>>;
     /**
      * 获取指定网络的长度
      *
-     * @beta
+     * @public
      * @param net - 网络名称
      * @returns 网络长度，`undefined` 为不存在该网络，`0` 为网络无长度
      */
     getNetLength(net: string): Promise<number | undefined>;
+    /* Excluded from this release type: getNetColor */
+    /* Excluded from this release type: setNetColor */
     /**
      * 获取关联指定网络的所有图元
      *
@@ -8563,7 +8754,7 @@ declare class PCB_Net {
     /**
      * 获取网表
      *
-     * @beta
+     * @public
      * @param type - 网表格式
      * @returns 网表数据，当 type 为 `JLCEDA` 或 `EasyEDA` 时，返回值为数组
      */
@@ -8571,7 +8762,7 @@ declare class PCB_Net {
     /**
      * 更新网表
      *
-     * @beta
+     * @public
      * @param type - 网表格式
      * @param netlist - 网表数据
      */
@@ -9201,7 +9392,7 @@ declare class PCB_PrimitiveObject implements IPCB_PrimitiveAPI {
      * 获取二进制内嵌对象
      *
      * @beta
-     * @param primitiveIds - 二进制内嵌对象的图元 ID，��以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @param primitiveIds - 二进制内嵌对象的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
      * @returns 二进制内嵌对象图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitiveObject | undefined>;
@@ -9495,7 +9686,7 @@ declare class PCB_PrimitivePour implements IPCB_PrimitiveAPI {
      */
     getAllPrimitiveId(net?: string, layer?: TPCB_LayersOfCopper, primitiveLock?: boolean): Promise<Array<string>>;
     /**
-     * 获取所有填充
+     * 获取所有覆铜边框图元
      *
      * @beta
      * @param net - 网络名称
@@ -9712,7 +9903,7 @@ declare class PCB_SelectControl {
      */
     doSelectPrimitives(primitiveIds: string | Array<string>): Promise<boolean>;
     /**
-     * 进行交叉选择
+     * 进行交���选择
      *
      * @beta
      * @param components - 器件位号
@@ -9954,7 +10145,19 @@ declare class SCH_Primitive {
      */
     getPrimitiveByPrimitiveId(id: string): Promise<ISCH_Primitive | undefined>;
     /* Excluded from this release type: getPrimitivesByPrimitiveId */
-    /* Excluded from this release type: getPrimitivesBBox */
+    /**
+     * 获取图元的 BBox
+     *
+     * @beta
+     * @param primitiveIds - 图元 ID 数组或图元对象数组
+     * @returns 图元的 BBox，如若图元不存在或没有 BBox，将会返回 `undefined` 的结果
+     */
+    getPrimitivesBBox(primitiveIds: Array<string | ISCH_Primitive>): Promise<{
+        minX: number;
+        minY: number;
+        maxX: number;
+        maxY: number;
+    } | undefined>;
 }
 
 /**
@@ -10737,7 +10940,7 @@ declare class SCH_PrimitiveWire implements ISCH_PrimitiveAPI {
      * 获取导线
      *
      * @beta
-     * @param primitiveIds - 导线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @param primitiveIds - 导线��图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
      * @returns 导线图元对象
      */
     get(primitiveIds: string): ISCH_PrimitiveWire | undefined;
@@ -10989,17 +11192,23 @@ declare class SYS_FileManager {
      * 获取工程文件
      *
      * @public
-     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @remarks
+     * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     *
+     * 注意：本接口需要启用 **工程管理 \> 下载工程** 权限，没有权限调用将始终 `throw Error`
      * @param fileName - 文件名
      * @param password - 加密密码
      * @returns 工程文件数据，`undefined` 表示当前未打开工程或数据获取失败
      */
     getProjectFile(fileName?: string, password?: string): Promise<File | undefined>;
     /**
-     * ���取文档文件
+     * 获取文档文件
      *
      * @public
-     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @remarks
+     * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     *
+     * 注意：本接口需要启用 **工程设计图 \> 文件导出** 权限，没有权限调用将始终 `throw Error`
      * @param fileName - 文件名
      * @param password - 加密密码
      * @returns 文档文件数据，`undefined` 表示当前未打开文档或数据获取失败
@@ -11034,7 +11243,10 @@ declare class SYS_FileManager {
      * 使用工程 UUID 获取工程文件
      *
      * @public
-     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @remarks
+     * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     *
+     * 注意：本接口需要启用 **工程管理 \> 下载工程** 权限，没有权限调用将始终 `throw Error`
      * @param projectUuid - 工程 UUID
      * @param fileName - 文件名
      * @param password - 加密密码
@@ -11045,7 +11257,10 @@ declare class SYS_FileManager {
      * 使用器件 UUID 获取器件文件
      *
      * @public
-     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @remarks
+     * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     *
+     * 注意：本接口需要启用 **团队库 \> 下载库** 权限，没有权限调用将始终 `throw Error`
      * @param deviceUuid - 器件 UUID 或器件 UUID 列表
      * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @returns 器件文件数据，`undefined` 表示数据获取失败
@@ -11056,7 +11271,10 @@ declare class SYS_FileManager {
      * 使用封装 UUID 获取封装文件
      *
      * @beta
-     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @remarks
+     * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     *
+     * 注意：本接口需要启用 **团队库 \> 下载库** 权限，没有权限调用将始终 `throw Error`
      * @param footprintUuid - 封装 UUID 或封装 UUID 列表
      * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @returns 封装文件数据，`undefined` 表示数据获取失败
@@ -11066,7 +11284,10 @@ declare class SYS_FileManager {
      * 使用复用模块 UUID 获取复用模块文件
      *
      * @beta
-     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @remarks
+     * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     *
+     * 注意：本接口需要启用 **团队模块 \> 下载模块** 权限，没有权限调用将始终 `throw Error`
      * @param cbbUuid - 复用模块 UUID
      * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @param fileName - 复用模块名
@@ -11074,7 +11295,19 @@ declare class SYS_FileManager {
      * @returns 复用模块文件数据，`undefined` 表示数据获取失败
      */
     getCbbFileByCbbUuid(cbbUuid: string, libraryUuid?: string, cbbName?: string, password?: string): Promise<File | undefined>;
-    /* Excluded from this release type: getPanelLibraryFileByPanelLibraryUuid */
+    /**
+     * 使用面板库 UUID 获取面板库文件
+     *
+     * @beta
+     * @remarks
+     * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     *
+     * 注意：本接口需要启用 **团队库 \> 下载库** 权限，没有权限调用将始终 `throw Error`
+     * @param panelLibraryUuid - 面板库 UUID 或面板库 UUID 列表
+     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
+     * @returns 面板库文件数据，`undefined` 表示数据获取失败
+     */
+    getPanelLibraryFileByPanelLibraryUuid(panelLibraryUuid: string | Array<string>, libraryUuid?: string): Promise<File | undefined>;
 }
 
 /**
@@ -11628,7 +11861,7 @@ declare class SYS_Storage {
      *
      * @public
      * @remarks
-     * 新建扩展用户配置也使用本接口，在设置时如果不存在将会自动新建
+     * 新建扩展用户配置也使用本接口，���设置时如果不存在将会自动新建
      *
      * 注意：本接口仅扩展有效，在独立脚本环境内调用将始终 `throw Error`
      * @param key - 配置项

package/package.json

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