@jlceda/pro-api-types 0.1.111 → 0.1.112

package/index.d.ts

@@ -418,7 +418,7 @@ declare class DMT_Project {
      *
      * @beta
      * @param projectFriendlyName - 工程友好名称
-     * @param projectName - 工程名称，仅支持字母 `a-zA-Z`、数字 `0-9`、中划线 `-`，如若不指定，则根据工程友好名称自动生��
+     * @param projectName - 工程名称，仅支持字母 `a-zA-Z`、数字 `0-9`、中划线 `-`，如若不指定，则根据工程友好名称自动生成
      * @param teamUuid - 团队 UUID，如若不指定，则默认为个人；在不存在个人工程的环境下必须指定团队 UUID
      * @param folderUuid - 文件夹 UUID，如若不指定，则为根文件夹
      * @param description - 工程描述
@@ -505,7 +505,7 @@ declare class DMT_Schematic {
      * 修改原理图名称
      *
      * @beta
-     * @remarks 如若原理图已关联复用模块（在工程库内存在同名的复用模块符号），则修改名称时将同步修改复用模块符号名称与关联 PCB 名称
+     * @remarks 如若原理图已关联复用模块（在工程库内存在同名的复用模块符号），则修改名称时将同步修改复用模块符号名称与关联 PCB ���称
      * @param schematicUuid - 原理图 UUID
      * @param schematicName - 原理图名称
      * @returns 是否修改成功
@@ -1186,7 +1186,7 @@ declare enum EPCB_LayerId {
     CUSTOM_28 = 98,
     /** 自定义层 29 */
     CUSTOM_29 = 99,
-    /** ���定义层 30 */
+    /** ��定义层 30 */
     CUSTOM_30 = 100,
     /** 夹层（介电基板）1 */
     SUBSTRATE_1 = 101,
@@ -1918,7 +1918,7 @@ declare interface IDMT_ProjectItem extends IDMT_BriefProjectItem {
     description?: string;
     /** 工程内文档数据 */
     data: Array<IDMT_BoardItem | IDMT_SchematicItem | IDMT_PcbItem | IDMT_PanelItem>;
-    /** 工��协作模式 */
+    /** 工程协作模式 */
     collaborationMode?: EDMT_ProjectCollaborationMode;
 }
 
@@ -2113,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>;
 }
 
 /**
@@ -2145,8 +2169,10 @@ declare interface ILIB_DeviceExtendPropertyItem {
     supplier?: string;
     /** 供应商编号 */
     supplierId?: string;
-    /** 其它 */
-    [key: string]: boolean | number | string | undefined;
+    /** 其它参数 */
+    otherProperty?: {
+        [key: string]: boolean | number | string | undefined;
+    };
 }
 
 /**
@@ -2215,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;
     /** 描述 */
@@ -2434,7 +2502,7 @@ declare class IPCB_ComplexPolygon {
      */
     getSource(): TPCB_PolygonSourceArray | Array<TPCB_PolygonSourceArray>;
     /**
-     * 获��复杂多边形数据
+     * 获取复杂多边形数据
      *
      * @public
      * @remarks 强制返回复杂多边形格式数据，即使它仅包含单一的单多边形
@@ -2838,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>>;
 }
 
 /**
@@ -3033,7 +3110,7 @@ declare class IPCB_PrimitiveComponent implements IPCB_Primitive {
      */
     getState_Supplier(): string | undefined;
     /**
-     * 获取属性状态：供应商编号
+     * 获取属���状态：供应商编号
      *
      * @public
      * @returns 供应商编号
@@ -3184,7 +3261,7 @@ declare class IPCB_PrimitiveComponent implements IPCB_Primitive {
      */
     isAsync(): boolean;
     /**
-     * 将异步图元重置为当前画布状态
+     * 将异���图元重置为当前画布状态
      *
      * @beta
      * @returns 器件图元对象
@@ -3231,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>;
 }
 
 /**
@@ -3722,7 +3801,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
      * @public
      * @returns 是否锁定
      */
-    getState_PrimitiveLock(): boolean | undefined;
+    getState_PrimitiveLock(): boolean;
     /**
      * 设置属性状态：BBox 左上点坐标 X
      *
@@ -3730,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
      *
@@ -3738,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;
     /**
      * 设置属性状态：层
      *
@@ -3746,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;
     /**
      * 设置属性状态：宽
      *
@@ -3754,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;
     /**
      * 设置属性状态：高
      *
@@ -3762,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;
     /**
      * 设置属性状态：旋转角度
      *
@@ -3770,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;
     /**
      * 设置属性状态：是否水平镜像
      *
@@ -3778,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;
     /**
      * 设置属性状态：是否锁定
      *
@@ -3786,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;
     /**
      * 将图元转换为异步图元
      *
@@ -3978,7 +4057,7 @@ declare class IPCB_PrimitiveLine implements IPCB_Primitive {
      *
      * @beta
      * @param lineWidth - 线宽
-     * @returns 直线图元对象
+     * @returns 直线图元对���
      */
     setState_LineWidth(lineWidth: number): IPCB_PrimitiveLine;
     /**
@@ -4036,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>>;
 }
 
 /**
@@ -4065,7 +4153,7 @@ declare class IPCB_PrimitiveObject implements IPCB_Primitive {
     private width;
     /** 高 */
     private height;
-    /** 旋���角度 */
+    /** 旋转角度 */
     private rotation;
     /** 是否水平镜像 */
     private mirror;
@@ -4123,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;
     /**
      * 设置属性状态：层
      *
@@ -4166,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
      *
@@ -4174,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
      *
@@ -4182,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;
     /**
      * 设置属性状态：二进制数据
      *
@@ -4198,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;
     /**
      * 设置属性状态：高
      *
@@ -4206,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;
     /**
      * 设置属性状态：旋转角度
      *
@@ -4214,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;
     /**
      * 设置属性状态：是否水平镜像
      *
@@ -4222,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;
     /**
      * 设置属性状态：文件名
      *
@@ -4230,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;
     /**
      * 设置属性状态：是否锁定
      *
@@ -4238,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;
     /**
      * 将图元转换为异步图元
      *
@@ -4513,7 +4601,7 @@ declare class IPCB_PrimitivePad implements IPCB_Primitive {
      */
     setState_Rotation(rotation: number): IPCB_PrimitivePad;
     /**
-     * 设置属性状��：焊盘外形
+     * 设置属性状态：焊盘外形
      *
      * @beta
      * @remarks
@@ -4638,7 +4726,7 @@ declare class IPCB_PrimitivePad implements IPCB_Primitive {
      */
     toAsync(): IPCB_PrimitivePad;
     /**
-     * ���图元转换为同步图元
+     * 将图元转换为同步图元
      *
      * @public
      * @returns 焊盘图元对象
@@ -7004,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
@@ -7012,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>;
@@ -7039,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;
@@ -7051,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>;
     /**
      * 获取器件的所有属性
@@ -7100,7 +7215,7 @@ declare class LIB_Device {
      * 私有化部署环境暂无法使用本接口
      * @param lcscIds - 立创 C 编号
      * @param libraryUuid - 库 UUID，默认为系统库，可以使用 {@link LIB_LibrariesList} 内的接口获取
-     * @param allowMultiMatch - 是否允许单个立创 C 编号匹配多个���果
+     * @param allowMultiMatch - 是否允许单个立创 C 编号匹配多个结果
      * @returns 搜索到的器件属性
      */
     getByLcscIds<T extends boolean>(lcscIds: string, libraryUuid?: string, allowMultiMatch?: T): Promise<T extends true ? ILIB_DeviceSearchItem | undefined : Array<ILIB_DeviceSearchItem>>;
@@ -7590,7 +7705,7 @@ declare class PCB_Document {
      */
     setCanvasOrigin(offsetX: number, offsetY: number): Promise<boolean>;
     /**
-     * 定位到画布坐标
+     * 定位到画布���标
      *
      * @public
      * @remarks
@@ -7621,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>>;
     /**
      * 获取当前设计规则配置名称
      *
@@ -7670,7 +7796,7 @@ declare class PCB_Drc {
      * @remarks 只有自定义配置可以覆盖保存，系统配置不允许修改和覆盖
      * @param ruleConfiguration - 设计规则配置
      * @param configurationName - 配置名称
-     * @param allowOverwrite - 是否允许覆写同名设计规则配置，`false` 则将在遇到同名设计规则配置时返回 `false`，请注意可能的数据丢失风险
+     * @param allowOverwrite - ��否允许覆写同名设计规则配置，`false` 则将在遇到同名设计规则配置时返回 `false`，请注意可能的数据丢失风险
      * @returns 保存是否成功
      */
     saveRuleConfiguration(ruleConfiguration: {
@@ -7793,7 +7919,7 @@ declare class PCB_Drc {
      * 修改网络类的名称
      *
      * @beta
-     * @param originalNetClassName - 原网络类名称
+     * @param originalNetClassName - ��网络类名称
      * @param netClassName - 新网络类名称
      * @returns 操作是否成功
      */
@@ -7934,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>;
     /**
@@ -7960,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>;
     /**
@@ -7969,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>;
     /**
@@ -8537,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>;
 }
@@ -9000,7 +9138,7 @@ declare class PCB_PrimitiveFill implements IPCB_PrimitiveAPI {
      * @beta
      * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
      * @param primitiveIds - 填充的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 填充图元对象，空��组表示获取失败
+     * @returns 填充图元对象，空数组表示获取失败
      */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveFill>>;
     /**
@@ -9548,7 +9686,7 @@ declare class PCB_PrimitivePour implements IPCB_PrimitiveAPI {
      */
     getAllPrimitiveId(net?: string, layer?: TPCB_LayersOfCopper, primitiveLock?: boolean): Promise<Array<string>>;
     /**
-     * 获取所有填充
+     * 获取所有覆铜边框图元
      *
      * @beta
      * @param net - 网络名称
@@ -9765,7 +9903,7 @@ declare class PCB_SelectControl {
      */
     doSelectPrimitives(primitiveIds: string | Array<string>): Promise<boolean>;
     /**
-     * 进行交叉选择
+     * 进行交���选择
      *
      * @beta
      * @param components - 器件位号
@@ -10402,7 +10540,7 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
      * @param uniqueId - 唯一 ID，`null` 表示留空
      * @param manufacturer - 制造商，`null` 表示留空
      * @param manufacturerId - 制造商编号，`null` 表示留空
-     * @param supplier - 供应���，`null` 表示留空
+     * @param supplier - 供应商，`null` 表示留空
      * @param supplierId - 供应商编号，`null` 表示留空
      * @returns 器件图元对象
      */
@@ -10802,7 +10940,7 @@ declare class SCH_PrimitiveWire implements ISCH_PrimitiveAPI {
      * 获取导线
      *
      * @beta
-     * @param primitiveIds - 导线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @param primitiveIds - 导线��图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
      * @returns 导线图元对象
      */
     get(primitiveIds: string): ISCH_PrimitiveWire | undefined;
@@ -11054,7 +11192,10 @@ declare class SYS_FileManager {
      * 获取工程文件
      *
      * @public
-     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @remarks
+     * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     *
+     * 注意：本接口需要启用 **工程管理 \> 下载工程** 权限，没有权限调用将始终 `throw Error`
      * @param fileName - 文件名
      * @param password - 加密密码
      * @returns 工程文件数据，`undefined` 表示当前未打开工程或数据获取失败
@@ -11064,7 +11205,10 @@ declare class SYS_FileManager {
      * 获取文档文件
      *
      * @public
-     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @remarks
+     * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     *
+     * 注意：本接口需要启用 **工程设计图 \> 文件导出** 权限，没有权限调用将始终 `throw Error`
      * @param fileName - 文件名
      * @param password - 加密密码
      * @returns 文档文件数据，`undefined` 表示当前未打开文档或数据获取失败
@@ -11099,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 - 加密密码
@@ -11110,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` 表示数据获取失败
@@ -11121,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` 表示数据获取失败
@@ -11131,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 - 复用模块名
@@ -11139,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>;
 }
 
 /**
@@ -11546,7 +11714,7 @@ declare class SYS_PanelControl {
      */
     openRightPanel(tab?: ESYS_RightPanelTab): void;
     /**
-     * 关闭���侧面板
+     * 关闭右侧面板
      *
      * @public
      */
@@ -11693,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.111",
+	"version": "0.1.112",
 	"description": "嘉立创EDA & EasyEDA 专业版扩展 API 接口类型定义",
 	"typings": "index.d.ts",
 	"keywords": [