@jlceda/pro-api-types 0.1.99 → 0.1.101

package/index.d.ts

@@ -416,7 +416,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>;
@@ -744,19 +744,17 @@ declare class EDA {
     pcb_Primitive: PCB_Primitive;
     pcb_PrimitiveArc: PCB_PrimitiveArc;
     pcb_PrimitiveComponent: PCB_PrimitiveComponent;
-    pcb_PrimitiveFill: PCB_PrimitiveFill;
     pcb_PrimitiveDimension: PCB_PrimitiveDimension;
+    pcb_PrimitiveFill: PCB_PrimitiveFill;
     pcb_PrimitiveImage: PCB_PrimitiveImage;
     pcb_PrimitiveLine: PCB_PrimitiveLine;
+    pcb_PrimitiveObject: PCB_PrimitiveObject;
     pcb_PrimitivePad: PCB_PrimitivePad;
     pcb_PrimitivePolyline: PCB_PrimitivePolyline;
     pcb_PrimitivePour: PCB_PrimitivePour;
     pcb_PrimitiveRegion: PCB_PrimitiveRegion;
     pcb_PrimitiveVia: PCB_PrimitiveVia;
     pcb_SelectControl: PCB_SelectControl;
-    EPCB_LayerId: {
-        [key: string]: number;
-    };
     pnl_Document: PNL_Document;
     sch_Document: SCH_Document;
     sch_Drc: SCH_Drc;
@@ -795,7 +793,6 @@ declare class EDA {
     sys_WebSocket: SYS_WebSocket;
     sys_Window: SYS_Window;
     /* Excluded from this release type: extensionUuid */
-    /* Excluded from this release type: allowExternalInteractions */
     /* Excluded from this release type: __constructor */
 }
 
@@ -1020,7 +1017,7 @@ declare enum EPCB_LayerId {
     TOP_SOLDER_MASK = 5,
     /** 顶层锡膏（助焊）层 */
     TOP_PASTE_MASK = 7,
-    /** 顶层装配层 */
+    /** 顶层���配层 */
     TOP_ASSEMBLY = 9,
     /** 顶层 FPC 补强层 */
     TOP_STIFFENER = 58,
@@ -1378,6 +1375,8 @@ declare enum EPCB_PrimitiveType {
     COMPONENT = "Component",
     /** 焊盘 */
     PAD = "Pad",
+    /** 器件焊盘 */
+    COMPONENT_PAD = "ComponentPad",
     /** 折线 */
     POLYLINE = "Polyline",
     /** 覆铜边框 */
@@ -1393,7 +1392,9 @@ declare enum EPCB_PrimitiveType {
     /** 尺寸标注 */
     DIMENSION = "Dimension",
     /** 图像 */
-    IMAGE = "Image"
+    IMAGE = "Image",
+    /** 二进制内嵌对象 */
+    OBJECT = "Object"
 }
 
 /**
@@ -1428,6 +1429,7 @@ declare enum ESCH_PrimitiveComponentType {
     NON_ELECTRICAL_FLAG = "nonElectrical_symbol",
     /** 短接标识 */
     SHORT_CIRCUIT_FLAG = "short_symbol",
+    /** 网络标签 */
     NET_LABEL = "netlabel"
 }
 
@@ -1435,6 +1437,7 @@ declare enum ESCH_PrimitiveComponentType {
  * 引脚类型
  *
  * @public
+ * @remarks 引脚图元仅符号编辑器可用，在原理图图页内，关联到符号的引脚被称为 {@link ISCH_PrimitiveComponentPin | 器件引脚图元}
  */
 declare enum ESCH_PrimitivePinType {
     IN = "IN",
@@ -2470,8 +2473,8 @@ declare interface IPCB_PrimitiveAPI {
         (primitiveIds: string): IPCB_Primitive | undefined | Promise<IPCB_Primitive | undefined>;
         (primitiveIds: Array<string>): Array<IPCB_Primitive> | Promise<Array<IPCB_Primitive>>;
     };
-    getAllPrimitiveId: (...args: any[]) => Array<string> | Promise<Array<string>> | Promise<Array<string>>;
-    getAll: (...args: any[]) => Array<IPCB_Primitive> | Promise<Array<IPCB_Primitive>> | Promise<Array<IPCB_Primitive>>;
+    getAllPrimitiveId: (...args: any[]) => Array<string> | Promise<Array<string>>;
+    getAll: (...args: any[]) => Array<IPCB_Primitive> | Promise<Array<IPCB_Primitive>>;
 }
 
 /**
@@ -2707,6 +2710,8 @@ declare class IPCB_PrimitiveArc implements IPCB_Primitive {
      * @returns 圆弧线图元对象
      */
     done(): Promise<IPCB_PrimitiveArc>;
+    /* Excluded from this release type: getAdjacentPrimitives */
+    /* Excluded from this release type: getEntireTrack */
 }
 
 /**
@@ -2758,39 +2763,266 @@ declare class IPCB_PrimitiveComponent implements IPCB_Primitive {
     /** 其它参数 */
     private otherProperty?;
     /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
     /**
-     * 在 PCB 画布中创建图元
+     * 获取属性状态：图元类型
+     *
+     * @public
+     * @returns 图元类型
+     */
+    getState_PrimitiveType(): EPCB_PrimitiveType;
+    /**
+     * 获取属性状态：图元 ID
+     *
+     * @public
+     * @returns 图元 ID
+     */
+    getState_PrimitiveId(): string;
+    /**
+     * 获取属性状态：关联库器件
+     *
+     * @public
+     * @returns 关联库器件
+     */
+    getState_Component(): {
+        libraryUuid: string;
+        uuid: string;
+    };
+    /**
+     * 获取属性状态：关联库封装
+     *
+     * @public
+     * @returns 关联库封装
+     */
+    getState_Footprint(): {
+        libraryUuid: string;
+        uuid: string;
+    } | undefined;
+    /**
+     * 获取属性状态：层
+     *
+     * @public
+     * @returns 层
+     */
+    getState_Layer(): TPCB_LayersOfComponent;
+    /**
+     * 获取属性状态：坐标 X
+     *
+     * @public
+     * @returns 坐标 X
+     */
+    getState_X(): number;
+    /**
+     * 获取属性状态：坐标 Y
+     *
+     * @public
+     * @returns 坐标 Y
+     */
+    getState_Y(): number;
+    /**
+     * 获取属性状态：旋转角度
+     *
+     * @public
+     * @returns 旋转角度
+     */
+    getState_Rotation(): number;
+    /**
+     * 获取属性状态：是否锁定
+     *
+     * @public
+     * @returns 是否锁定
+     */
+    getState_PrimitiveLock(): boolean;
+    /**
+     * 获取属性状态：是否加入 BOM
+     *
+     * @public
+     * @returns 是否加入 BOM
+     */
+    getState_AddIntoBom(): boolean;
+    /**
+     * 获取属性状态：关联库 3D 模型
+     *
+     * @public
+     * @returns 关联库 3D 模型
+     */
+    getState_Model3D(): {
+        libraryUuid: string;
+        uuid: string;
+    } | undefined;
+    /**
+     * 获取属性状态：位号
+     *
+     * @public
+     * @returns 位号
+     */
+    getState_Designator(): string | undefined;
+    /**
+     * 获取属性状态：焊盘
+     *
+     * @public
+     * @returns 焊盘
+     */
+    getState_Pads(): Array<{
+        primitiveId: string;
+        net: string;
+        padNumber: string;
+    }> | undefined;
+    /**
+     * 获取属性状态：名称
+     *
+     * @public
+     * @returns 名称
+     */
+    getState_Name(): string | undefined;
+    /**
+     * 获取属性状态：唯一 ID
+     *
+     * @public
+     * @returns 唯一 ID
+     */
+    getState_UniqueId(): string | undefined;
+    /**
+     * 获取属性状态：制造商
+     *
+     * @public
+     * @returns 制造商
+     */
+    getState_Manufacturer(): string | undefined;
+    /**
+     * 获取属性状态：制造商编号
+     *
+     * @public
+     * @returns 制造商编号
+     */
+    getState_ManufacturerId(): string | undefined;
+    /**
+     * 获取属性状态：供应商
+     *
+     * @public
+     * @returns 供应商
+     */
+    getState_Supplier(): string | undefined;
+    /**
+     * 获取属性状态：供应商编号
+     *
+     * @public
+     * @returns 供应商编号
+     */
+    getState_SupplierId(): string | undefined;
+    /**
+     * 获取属性状态：其它参数
+     *
+     * @public
+     * @returns 其它参数
+     */
+    getState_OtherProperty(): {
+        [key: string]: string | number | boolean;
+    } | undefined;
+    /**
+     * 设置属性状态：层
      *
      * @beta
+     * @param layer - 层
      * @returns 器件图元对象
      */
-    create(): Promise<IPCB_PrimitiveComponent>;
+    setState_Layer(layer: TPCB_LayersOfComponent): IPCB_PrimitiveComponent;
     /**
-     * 获取对象的图元 ID
+     * 设置属性状态：坐标 X
      *
-     * @returns
+     * @beta
+     * @param x - 坐标 X
+     * @returns 器件图元对象
      */
-    getState_PrimitiveType(): EPCB_PrimitiveType;
+    setState_X(x: number): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：坐标 Y
+     *
+     * @beta
+     * @param y - 坐标 Y
+     * @returns 器件图元对象
+     */
+    setState_Y(y: number): IPCB_PrimitiveComponent;
     /**
-     * 获取对象的图元 ID
+     * 设置属性状态：旋转角度
      *
-     * @returns
+     * @beta
+     * @param rotation - 旋转角度
+     * @returns 器件图元对象
      */
-    getState_PrimitiveId(): string;
-    /* Excluded from this release type: getState_Pads */
-    /* Excluded from this release type: setState_Layer */
-    /* Excluded from this release type: setState_X */
-    /* Excluded from this release type: setState_Y */
-    /* Excluded from this release type: setState_Rotation */
-    /* Excluded from this release type: setState_PrimitiveLock */
-    /* Excluded from this release type: setState_AddIntoBom */
-    /* Excluded from this release type: setState_Designator */
-    /* Excluded from this release type: setState_Name */
-    /* Excluded from this release type: setState_UniqueId */
-    /* Excluded from this release type: setState_Supplier */
-    /* Excluded from this release type: setState_SupplierId */
-    /* Excluded from this release type: setState_Manufacturer */
-    /* Excluded from this release type: setState_ManufacturerId */
+    setState_Rotation(rotation: number): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：是否锁定
+     *
+     * @beta
+     * @param primitiveLock - 是否锁定
+     * @returns 器件图元对象
+     */
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：是否加入 BOM
+     *
+     * @beta
+     * @param addIntoBom - 是否加入 BOM
+     * @returns 器件图元对象
+     */
+    setState_AddIntoBom(addIntoBom: boolean): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：位号
+     *
+     * @beta
+     * @param designator - 位号
+     * @returns 器件图元对象
+     */
+    setState_Designator(designator: string | undefined): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：名称
+     *
+     * @beta
+     * @param name - 名称
+     * @returns 器件图元对象
+     */
+    setState_Name(name: string | undefined): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：唯一 ID
+     *
+     * @beta
+     * @param uniqueId - 唯一 ID
+     * @returns 器件图元对象
+     */
+    setState_UniqueId(uniqueId: string | undefined): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：制造商
+     *
+     * @beta
+     * @param manufacturer - 制造商
+     * @returns 器件图元对象
+     */
+    setState_Manufacturer(manufacturer: string | undefined): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：制造商编号
+     *
+     * @beta
+     * @param manufacturerId - 制造商编号
+     * @returns 器件图元对象
+     */
+    setState_ManufacturerId(manufacturerId: string | undefined): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：供应商
+     *
+     * @beta
+     * @param supplier - 供应商
+     * @returns 器件图元对象
+     */
+    setState_Supplier(supplier: string | undefined): IPCB_PrimitiveComponent;
+    /**
+     * 设置属性状态：供应商编号
+     *
+     * @beta
+     * @param supplierId - 供应商编号
+     * @returns 器件图元对象
+     */
+    setState_SupplierId(supplierId: string | undefined): IPCB_PrimitiveComponent;
     /**
      * 设置属性状态：其它参数
      *
@@ -2799,38 +3031,67 @@ declare class IPCB_PrimitiveComponent implements IPCB_Primitive {
      * @returns 器件图元对象
      */
     setState_OtherProperty(otherProperty: {
-        [key: string]: string;
+        [key: string]: string | number | boolean;
     }): IPCB_PrimitiveComponent;
     /**
      * 将图元转换为异步图元
      *
+     * @public
+     * @returns 器件图元对象
      */
     toAsync(): IPCB_PrimitiveComponent;
     /**
      * 将图元转换为同步图元
      *
+     * @public
+     * @returns 器件图元对象
      */
     toSync(): IPCB_PrimitiveComponent;
     /**
      * 查询图元是否为异步图元
      *
+     * @public
+     * @returns 是否为异步图元
      */
     isAsync(): boolean;
     /**
      * 将异步图元重置为当前画布状态
      *
      * @beta
+     * @returns 器件图元对象
      */
     reset(): Promise<IPCB_PrimitiveComponent>;
     /**
      * 将对图元的更改应用到画布
      *
      * @beta
+     * @returns 器件图元对象
      */
     done(): Promise<IPCB_PrimitiveComponent>;
+    /* Excluded from this release type: getAllPins */
     /* Excluded from this release type: setState_Component */
 }
 
+/**
+ * 器件焊盘图元
+ *
+ * @public
+ * @remarks
+ * 器件焊盘图元是一个特殊的图元，它指的是在 PCB 画布上关联到封装的焊盘
+ *
+ * 你只能通过 {@link PCB_PrimitiveComponent.getAllPadsByPrimitiveId | 器件类的 getAllPinsByPrimitiveId 方法} 或 {@link IPCB_PrimitiveComponent.getAllPins | 器件图元的 getAllPads 方法} 获取到器件焊盘图元
+ */
+declare class IPCB_PrimitiveComponentPad extends IPCB_PrimitivePad {
+    /** 图元类型 */
+    protected readonly primitiveType: EPCB_PrimitiveType.COMPONENT_PAD;
+    /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
+    /* Excluded from this release type: setState_Layer */
+    /* Excluded from this release type: setState_PadNumber */
+    /* Excluded from this release type: reset */
+    /* Excluded from this release type: done */
+}
+
 /**
  * 尺寸标注图元
  *
@@ -3394,7 +3655,7 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
 }
 
 /**
- * 导线图元
+ * 直线图元
  *
  * @public
  */
@@ -3424,68 +3685,289 @@ declare class IPCB_PrimitiveLine implements IPCB_Primitive {
     /* Excluded from this release type: __constructor */
     /* Excluded from this release type: create */
     /**
-     * 获取属性状态：图元类型
+     * 获取属性状态：图元类型
+     *
+     * @public
+     * @returns 图元类型
+     */
+    getState_PrimitiveType(): EPCB_PrimitiveType;
+    /**
+     * 获取属性状态：图元 ID
+     *
+     * @public
+     * @returns 图元 ID
+     */
+    getState_PrimitiveId(): string;
+    /**
+     * 获取属性状态：网络名称
+     *
+     * @public
+     * @returns 网络名称
+     */
+    getState_Net(): string;
+    /**
+     * 获取属性状态：层
+     *
+     * @public
+     * @returns 层
+     */
+    getState_Layer(): TPCB_LayersOfLine;
+    /**
+     * 获取属性状态：起始位置 X
+     *
+     * @public
+     * @returns 起始位置 X
+     */
+    getState_StartX(): number;
+    /**
+     * 获取属性状态：起始位置 Y
+     *
+     * @public
+     * @returns 起始位置 Y
+     */
+    getState_StartY(): number;
+    /**
+     * 获取属性状态：终止位置 X
+     *
+     * @public
+     * @returns 终止位置 X
+     */
+    getState_EndX(): number;
+    /**
+     * 获取属性状态：终止位置 Y
+     *
+     * @public
+     * @returns 终止位置 Y
+     */
+    getState_EndY(): number;
+    /**
+     * 获取属性状态：线宽
+     *
+     * @public
+     * @returns 线宽
+     */
+    getState_LineWidth(): number;
+    /**
+     * 获取属性状态：是否锁定
+     *
+     * @public
+     * @returns 是否锁定
+     */
+    getState_PrimitiveLock(): boolean;
+    /**
+     * 设置属性状态：网络名称
+     *
+     * @beta
+     * @param net - 网络名称
+     * @returns 直线图元对象
+     */
+    setState_Net(net: string): IPCB_PrimitiveLine;
+    /**
+     * 设置属性状态：层
+     *
+     * @beta
+     * @param layer - 层
+     * @returns 直线图元对象
+     */
+    setState_Layer(layer: TPCB_LayersOfLine): IPCB_PrimitiveLine;
+    /**
+     * 设置属性状态：起始位置 X
+     *
+     * @beta
+     * @param startX - 起始位置 X
+     * @returns 直线图元对象
+     */
+    setState_StartX(startX: number): IPCB_PrimitiveLine;
+    /**
+     * 设置属性状态：起始位置 Y
+     *
+     * @beta
+     * @param startY - 起始位置 Y
+     * @returns 直线图元对象
+     */
+    setState_StartY(startY: number): IPCB_PrimitiveLine;
+    /**
+     * 设置属性状态：终止位置 X
+     *
+     * @beta
+     * @param endX - 终止位置 X
+     * @returns 直线图元对象
+     */
+    setState_EndX(endX: number): IPCB_PrimitiveLine;
+    /**
+     * 设置属性状态：终止位置 Y
+     *
+     * @beta
+     * @param endY - 终止位置 Y
+     * @returns 直线图元对象
+     */
+    setState_EndY(endY: number): IPCB_PrimitiveLine;
+    /**
+     * 设置属性状态：线宽
+     *
+     * @beta
+     * @param lineWidth - 线宽
+     * @returns 直线图元对象
+     */
+    setState_LineWidth(lineWidth: number): IPCB_PrimitiveLine;
+    /**
+     * 设置属性状态：是否锁定
+     *
+     * @beta
+     * @param primitiveLock - 是否锁定
+     * @returns 直线图元对象
+     */
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveLine;
+    /**
+     * 将图元转换为异步图元
+     *
+     * @public
+     * @returns 直线图元对象
+     */
+    toAsync(): IPCB_PrimitiveLine;
+    /**
+     * 将图元转换为同步图元
+     *
+     * @public
+     * @returns 直线图元对象
+     */
+    toSync(): IPCB_PrimitiveLine;
+    /**
+     * 查询图元是否为异步图元
+     *
+     * @public
+     * @returns 是否为异步图元
+     */
+    isAsync(): boolean;
+    /**
+     * 将异步图元重置为当前画布状态
+     *
+     * @beta
+     * @returns 直线图元对象
+     */
+    reset(): Promise<IPCB_PrimitiveLine>;
+    /**
+     * 将对图元的更改应用到画布
+     *
+     * @beta
+     * @returns 直线图元对象
+     */
+    done(): Promise<IPCB_PrimitiveLine>;
+    /* Excluded from this release type: getAdjacentPrimitives */
+    /* Excluded from this release type: getEntireTrack */
+}
+
+/**
+ * 二进制内嵌对象图元
+ *
+ * @public
+ */
+declare class IPCB_PrimitiveObject implements IPCB_Primitive {
+    /** 异步 */
+    private async;
+    /** 图元类型 */
+    private readonly primitiveType;
+    /** 图元 ID */
+    private primitiveId?;
+    /** 层 */
+    private layer;
+    /** 左上点 X */
+    private topLeftX;
+    /** 左上点 Y */
+    private topLeftY;
+    /** 二进制数据 */
+    private binaryData;
+    /** 宽 */
+    private width;
+    /** 高 */
+    private height;
+    /** 旋转角度 */
+    private rotation;
+    /** 是否水平镜像 */
+    private mirror;
+    /** 文件名 */
+    private fileName;
+    /** 是否锁定 */
+    private primitiveLock;
+    /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
+    /**
+     * 获取属性状态：图元类型
+     *
+     * @public
+     * @returns 图元类型
+     */
+    getState_PrimitiveType(): EPCB_PrimitiveType;
+    /**
+     * 获取属性状态：图元 ID
+     *
+     * @public
+     * @returns 图��� ID
+     */
+    getState_PrimitiveId(): string;
+    /**
+     * 获取属性状态：层
      *
      * @public
-     * @returns 图元类型
+     * @returns 层
      */
-    getState_PrimitiveType(): EPCB_PrimitiveType;
+    getState_Layer(): TPCB_LayersOfObject;
     /**
-     * 获取属性状态：图元 ID
+     * 获取属性状态：左上点 X
      *
      * @public
-     * @returns 图元 ID
+     * @returns 左上点 X
      */
-    getState_PrimitiveId(): string;
+    getState_TopLeftX(): number;
     /**
-     * 获取属性状态：网络名称
+     * 获取属性状态：左上点 Y
      *
      * @public
-     * @returns 网络名称
+     * @returns 左上点 Y
      */
-    getState_Net(): string;
+    getState_TopLeftY(): number;
     /**
-     * 获取属性状态：层
+     * 获取属性状态：二进制数据
      *
      * @public
-     * @returns 层
+     * @returns 二进制数据
      */
-    getState_Layer(): TPCB_LayersOfLine;
+    getState_BinaryData(): string;
     /**
-     * 获取属性状态：起始位置 X
+     * 获取属性状态：宽
      *
      * @public
-     * @returns 起始位置 X
+     * @returns 宽
      */
-    getState_StartX(): number;
+    getState_Width(): number;
     /**
-     * 获取属性状态：起始位置 Y
+     * 获取属性状态：高
      *
      * @public
-     * @returns 起始位置 Y
+     * @returns 高
      */
-    getState_StartY(): number;
+    getState_Height(): number;
     /**
-     * 获取属性状态：终止位置 X
+     * 获取属性状态：旋转角度
      *
      * @public
-     * @returns 终止位置 X
+     * @returns 旋转角度
      */
-    getState_EndX(): number;
+    getState_Rotation(): number;
     /**
-     * 获取属性状态：终止位置 Y
+     * 获取属性状态：是否水平镜像
      *
      * @public
-     * @returns 终止位置 Y
+     * @returns 是否水平镜像
      */
-    getState_EndY(): number;
+    getState_Mirror(): boolean;
     /**
-     * 获取属性状态：线宽
+     * 获取属性状态：文件名
      *
      * @public
-     * @returns 线宽
+     * @returns 文件名
      */
-    getState_LineWidth(): number;
+    getState_FileName(): string;
     /**
      * 获取属性状态：是否锁定
      *
@@ -3494,83 +3976,99 @@ declare class IPCB_PrimitiveLine implements IPCB_Primitive {
      */
     getState_PrimitiveLock(): boolean;
     /**
-     * 设置属性状态：网络名称
+     * 设置属性状态：层
      *
      * @beta
-     * @param net - 网络名称
-     * @returns 导线图元对象
+     * @param layer - 层
+     * @returns 二进制内嵌对象图元对象
      */
-    setState_Net(net: string): IPCB_PrimitiveLine;
+    setState_Layer(layer: TPCB_LayersOfObject): IPCB_PrimitiveObject;
     /**
-     * 设置属性状态：层
+     * 设置属性状态：左上点 X
      *
-     * @beta
-     * @param layer - 层
-     * @returns 导线图元对象
+     * @public
+     * @param topLeftX - 左上点 X
+     * @returns 二进制内嵌对象图元对象
      */
-    setState_Layer(layer: TPCB_LayersOfLine): IPCB_PrimitiveLine;
+    setState_TopLeftX(topLeftX: number): IPCB_PrimitiveObject;
     /**
-     * 设置属性状态：起始位置 X
+     * 设置属性状态：左上点 Y
      *
-     * @beta
-     * @param startX - 起始位置 X
-     * @returns 导线图元对象
+     * @public
+     * @param topLeftY - 左上点 Y
+     * @returns 二进制内嵌对象图元对象
      */
-    setState_StartX(startX: number): IPCB_PrimitiveLine;
+    setState_TopLeftY(topLeftY: number): IPCB_PrimitiveObject;
     /**
-     * 设置属性状态：起始位置 Y
+     * 设置属性状态：二进制数据
      *
-     * @beta
-     * @param startY - 起始位置 Y
-     * @returns 导线图元对象
+     * @public
+     * @param binaryData - 二进制数据
+     * @returns 二进制内嵌对象图元对象
      */
-    setState_StartY(startY: number): IPCB_PrimitiveLine;
+    setState_BinaryData(binaryData: string): IPCB_PrimitiveObject;
     /**
-     * 设置属性状态：终止位置 X
+     * 设置属性状态：宽
      *
-     * @beta
-     * @param endX - 终止位置 X
-     * @returns 导线图元对象
+     * @public
+     * @param width - 宽
+     * @returns 二进制内嵌对象图元对象
      */
-    setState_EndX(endX: number): IPCB_PrimitiveLine;
+    setState_Width(width: number): IPCB_PrimitiveObject;
     /**
-     * 设置属性状态：终止位置 Y
+     * 设置属性状态：高
      *
-     * @beta
-     * @param endY - 终止位置 Y
-     * @returns 导线图元对象
+     * @public
+     * @param height - 高
+     * @returns 二进制内嵌对象图元对象
      */
-    setState_EndY(endY: number): IPCB_PrimitiveLine;
+    setState_Height(height: number): IPCB_PrimitiveObject;
     /**
-     * 设置属性状态：线宽
+     * 设置属性状态：旋转角度
      *
-     * @beta
-     * @param lineWidth - 线宽
-     * @returns 导线图元对象
+     * @public
+     * @param rotation - 旋转角度
+     * @returns 二进制内嵌对象图元对象
      */
-    setState_LineWidth(lineWidth: number): IPCB_PrimitiveLine;
+    setState_Rotation(rotation: number): IPCB_PrimitiveObject;
+    /**
+     * 设置属性状态：是否水平镜像
+     *
+     * @public
+     * @param mirror - 是否水平镜像
+     * @returns 二进制内嵌对象图元对象
+     */
+    setState_Mirror(mirror: boolean): IPCB_PrimitiveObject;
+    /**
+     * 设置属性状态：文件名
+     *
+     * @public
+     * @param fileName - 文件名
+     * @returns 二进制内嵌对象图元对象
+     */
+    setState_FileName(fileName: string): IPCB_PrimitiveObject;
     /**
      * 设置属性状态：是否锁定
      *
      * @beta
      * @param primitiveLock - 是否锁定
-     * @returns 导线图元对象
+     * @returns 二进制内嵌对象图元对象
      */
-    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveLine;
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveObject;
     /**
      * 将图元转换为异步图元
      *
      * @public
-     * @returns 导线图元对象
+     * @returns 二进制内嵌对象图元对象
      */
-    toAsync(): IPCB_PrimitiveLine;
+    toAsync(): IPCB_PrimitiveObject;
     /**
      * 将图元转换为同步图元
      *
      * @public
-     * @returns 导线图元对象
+     * @returns 二进制内嵌对象图元对象
      */
-    toSync(): IPCB_PrimitiveLine;
+    toSync(): IPCB_PrimitiveObject;
     /**
      * 查询图元是否为异步图元
      *
@@ -3578,20 +4076,8 @@ declare class IPCB_PrimitiveLine implements IPCB_Primitive {
      * @returns 是否为异步图元
      */
     isAsync(): boolean;
-    /**
-     * 将异步图元重置为当前画布状态
-     *
-     * @beta
-     * @returns 导线图元对象
-     */
-    reset(): Promise<IPCB_PrimitiveLine>;
-    /**
-     * 将对图元的更改应用到画布
-     *
-     * @beta
-     * @returns 导线图元对象
-     */
-    done(): Promise<IPCB_PrimitiveLine>;
+    /* Excluded from this release type: reset */
+    /* Excluded from this release type: done */
 }
 
 /**
@@ -3601,45 +4087,45 @@ declare class IPCB_PrimitiveLine implements IPCB_Primitive {
  */
 declare class IPCB_PrimitivePad implements IPCB_Primitive {
     /** 异步 */
-    private async;
+    protected async: boolean;
     /** 图元类型 */
-    private readonly primitiveType;
+    protected readonly primitiveType: EPCB_PrimitiveType;
     /** 图元 ID */
-    private primitiveId?;
+    protected primitiveId?: string;
     /** 层 */
-    private layer;
+    protected layer: TPCB_LayersOfPad;
     /** 焊盘编号 */
-    private padNumber;
+    protected padNumber: string;
     /** 位置 X */
-    private x;
+    protected x: number;
     /** 位置 Y */
-    private y;
+    protected y: number;
     /** 旋转角度 */
-    private rotation;
+    protected rotation: number;
     /** 焊盘外形 */
-    private pad?;
+    protected pad?: TPCB_PrimitivePadShape;
     /** 网络名称 */
-    private net?;
+    protected net?: string;
     /** 孔 */
-    private hole;
+    protected hole: TPCB_PrimitivePadHole | null;
     /** 孔偏移 X */
-    private holeOffsetX;
+    protected holeOffsetX: number;
     /** 孔偏移 Y */
-    private holeOffsetY;
+    protected holeOffsetY: number;
     /** 孔相对于焊盘的旋转角度 */
-    private holeRotation;
+    protected holeRotation: number;
     /** 是否金属化孔壁 */
-    private metallization;
+    protected metallization: boolean;
     /** 焊盘功能 */
-    private padFunction;
+    protected padFunction: EPCB_PrimitivePadFunction;
     /** 特殊焊盘外形 */
-    private specialPad?;
+    protected specialPad?: TPCB_PrimitiveSpecialPadShape;
     /** 阻焊/助焊扩展 */
-    private solderMaskAndPasteMaskExpansion;
+    protected solderMaskAndPasteMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null;
     /** 热焊优化参数 */
-    private heatWelding;
+    protected heatWelding: IPCB_PrimitivePadHeatWelding | null;
     /** 是否锁定 */
-    private primitiveLock;
+    protected primitiveLock: boolean;
     /* Excluded from this release type: __constructor */
     /**
      * 在 PCB 画布中创建图元
@@ -3990,7 +4476,7 @@ declare class IPCB_PrimitivePad implements IPCB_Primitive {
  *
  * @public
  * @remarks
- * 当连接方式（{@link IPCB_PrimitivePadHeatWelding.connectionMethod | connectionMethod}）为直连（{@link EPCB_PrimitivePadHeatWeldingConnectionMethod.DIRECT_CONNECTED | DIRECT_CONNECTED}）、无连接（{@link EPCB_PrimitivePadHeatWeldingConnectionMethod.NON_CONNECTED | NON_CONNECTED}）时，发散间距、发散线宽、发散角度的设置将被忽略
+ * 当连接方式（{@link IPCB_PrimitivePadHeatWelding.connectionMethod | connectionMethod}）为直连（{@link EPCB_PrimitivePadHeatWeldingConnectionMethod.DIRECT_CONNECTED | DIRECT_CONNECTED}）、无连接（{@link EPCB_PrimitivePadHeatWeldingConnectionMethod.NON_CONNECTED | NON_CONNECTED}）时，发散间距、发散线宽、发散角度��设置将被忽略
  */
 declare interface IPCB_PrimitivePadHeatWelding {
     /** 连接方式 */
@@ -4174,7 +4660,7 @@ declare class IPCB_PrimitivePour implements IPCB_Primitive {
     private layer;
     /** 复杂多边形 */
     private complexPolygon;
-    /** 覆���填充方法 */
+    /** 覆铜填充方法 */
     private pourFillMethod;
     /** 是否保留孤岛 */
     private preserveSilos;
@@ -4769,6 +5255,7 @@ declare class IPCB_PrimitiveVia implements IPCB_Primitive {
      * @returns 过孔图元对象
      */
     done(): Promise<IPCB_PrimitiveVia>;
+    /* Excluded from this release type: getAdjacentPrimitives */
 }
 
 /**
@@ -4800,8 +5287,8 @@ declare interface ISCH_PrimitiveAPI {
         (primitiveIds: string): ISCH_Primitive | undefined | Promise<ISCH_Primitive | undefined>;
         (primitiveIds: Array<string>): Array<ISCH_Primitive> | Promise<Array<ISCH_Primitive>>;
     };
-    getAllPrimitiveId: (...args: any[]) => Array<string> | Promise<Array<string>> | Promise<Array<string>>;
-    getAll: (...args: any[]) => Array<ISCH_Primitive> | Promise<Array<ISCH_Primitive>> | Promise<Array<ISCH_Primitive>>;
+    getAllPrimitiveId: (...args: any[]) => Array<string> | Promise<Array<string>>;
+    getAll: (...args: any[]) => Array<ISCH_Primitive> | Promise<Array<ISCH_Primitive>>;
 }
 
 /**
@@ -5210,7 +5697,7 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
         uuid: string;
     } | undefined;
     /**
-     * 获取属性状态：关联库封装
+     * 获取属性状态：关联库��装
      *
      * @public
      * @returns 关联库封装
@@ -5275,7 +5762,7 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
      * @returns 其它参数
      */
     getState_OtherProperty(): {
-        [key: string]: string;
+        [key: string]: string | number | boolean;
     } | undefined;
     /**
      * 设置属性状态：坐标 X
@@ -5397,7 +5884,7 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
      * @returns 器件图元对象
      */
     setState_OtherProperty(otherProperty: {
-        [key: string]: string;
+        [key: string]: string | number | boolean;
     }): ISCH_PrimitiveComponent;
     /**
      * 将图元转换为异步图元
@@ -5434,65 +5921,73 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
      * @returns 器件图元对象
      */
     done(): Promise<ISCH_PrimitiveComponent>;
+    /* Excluded from this release type: getAllPins */
     /* Excluded from this release type: setState_Component */
     /* Excluded from this release type: setState_SubPartName */
 }
 
 /**
- * 器件引脚
+ * 器件引脚图元
  *
  * @public
+ * @remarks
+ * 器件引脚图元是一个特殊的图元，它指的是在原理图画布上关联到符号的引脚
+ *
+ * 器件引脚图元仅可更改 `pinNumber` 属性，其它所有属性均为只读，
+ * 并且你只能通过 {@link SCH_PrimitiveComponent.getAllPinsByPrimitiveId | 器件类的 getAllPinsByPrimitiveId 方法} 或 {@link ISCH_PrimitiveComponent.getAllPins | 器件图元的 getAllPins 方法} 获取到器件引脚图元
  */
-declare interface ISCH_PrimitiveComponentPin {
-    readonly primitiveType: ESCH_PrimitiveType.COMPONENT_PIN;
-    readonly primitiveId: string;
-    readonly x: number;
-    readonly y: number;
-    readonly pinNumber: string;
-    readonly pinName: string;
-    readonly pinShape: string;
-    readonly pinType: ESCH_PrimitivePinType;
-    readonly noConnectFlag: boolean;
+declare class ISCH_PrimitiveComponentPin extends ISCH_PrimitivePin {
+    /** 图元类型 */
+    protected readonly primitiveType: ESCH_PrimitiveType.COMPONENT_PIN;
+    /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
+    /* Excluded from this release type: setState_X */
+    /* Excluded from this release type: setState_Y */
+    /* Excluded from this release type: setState_PinName */
+    /* Excluded from this release type: setState_Rotation */
+    /* Excluded from this release type: setState_PinLength */
+    /* Excluded from this release type: setState_PinColor */
+    /* Excluded from this release type: setState_PinShape */
+    /* Excluded from this release type: setState_PinType */
+    /* Excluded from this release type: reset */
+    /* Excluded from this release type: done */
 }
 
 /**
  * 引脚图元
  *
  * @public
+ * @remarks 引脚图元仅符号编辑器可用，在原理图图页内，关联到符号的引脚被称为 {@link ISCH_PrimitiveComponentPin | 器件引脚图元}
  */
 declare class ISCH_PrimitivePin implements ISCH_Primitive {
     /** 异步 */
-    private async;
+    protected async: boolean;
     /** 图元类型 */
-    private readonly primitiveType;
+    protected readonly primitiveType: ESCH_PrimitiveType;
     /** 图元 ID */
-    private primitiveId?;
+    protected primitiveId?: string;
     /** 坐标 X */
-    private x;
+    protected x: number;
     /** 坐标 Y */
-    private y;
+    protected y: number;
     /** 引脚编号 */
-    private pinNumber;
+    protected pinNumber: string;
     /** 引脚名称 */
-    private pinName;
+    protected pinName: string;
     /** 旋转角度 */
-    private rotation;
+    protected rotation: number;
     /** 引脚长度 */
-    private pinLength;
+    protected pinLength: number;
     /** 引脚颜色 */
-    private pinColor;
+    protected pinColor: string | null;
     /** 引脚外形 */
-    private pinShape;
+    protected pinShape: string;
     /** 引脚类型 */
-    private pinType;
+    protected pinType: ESCH_PrimitivePinType;
+    /** 其它参数 */
+    private otherProperty?;
     /* Excluded from this release type: __constructor */
-    /**
-     * 在原理图画布中创建图元
-     *
-     * @beta
-     * @returns 引脚图元对象
-     */
-    create(): Promise<ISCH_PrimitivePin>;
+    /* Excluded from this release type: create */
     getState_PrimitiveType(): ESCH_PrimitiveType;
     getState_PrimitiveId(): string;
     getState_X(): number;
@@ -5504,6 +5999,15 @@ declare class ISCH_PrimitivePin implements ISCH_Primitive {
     getState_PinColor(): string | null;
     getState_PinShape(): string;
     getState_pinType(): ESCH_PrimitivePinType;
+    /**
+     * 获取属性状态：其它参数
+     *
+     * @public
+     * @returns 其它参数
+     */
+    getState_OtherProperty(): {
+        [key: string]: string | number | boolean;
+    } | undefined;
     setState_X(x: number): ISCH_PrimitivePin;
     setState_Y(y: number): ISCH_PrimitivePin;
     setState_PinNumber(pinNumber: string): ISCH_PrimitivePin;
@@ -5511,8 +6015,18 @@ declare class ISCH_PrimitivePin implements ISCH_Primitive {
     setState_Rotation(rotation: number): ISCH_PrimitivePin;
     setState_PinLength(pinLength: number): ISCH_PrimitivePin;
     setState_PinColor(pinColor: string | null): ISCH_PrimitivePin;
-    setState_PinShape(pinShape: string): this;
+    setState_PinShape(pinShape: string): ISCH_PrimitivePin;
     setState_PinType(pinType: ESCH_PrimitivePinType): ISCH_PrimitivePin;
+    /**
+     * 设置属性状态：其它参数
+     *
+     * @beta
+     * @param otherProperty - 其它参数
+     * @returns 引脚图元对象
+     */
+    setState_OtherProperty(otherProperty: {
+        [key: string]: string | number | boolean;
+    }): ISCH_PrimitivePin;
     /**
      * 将图元转换为异步图元
      */
@@ -5536,7 +6050,7 @@ declare class ISCH_PrimitivePin implements ISCH_Primitive {
      *
      * @beta
      */
-    done(): ISCH_PrimitivePin;
+    done(): Promise<ISCH_PrimitivePin>;
 }
 
 /**
@@ -5873,7 +6387,7 @@ declare interface ISYS_FileSystemFileList {
     isDirectory: boolean;
     /** 目录子文件 */
     subFiles?: Array<ISYS_FileSystemFileList>;
-    /** 相对路径，不包含前面的传入路径和文件名（当没有传入路径时，不存在相对路径），且前后均无斜杠 */
+    /** 相对路径���不包含前面的传入路径和文件名（当没有传入路径时，不存在相对路径），且前后均无斜杠 */
     relativePath?: string;
     /** 完整路径，包含文件名的绝对路径 */
     fullPath: string;
@@ -5950,7 +6464,7 @@ declare class LIB_3DModel {
      *
      * @beta
      * @param modelUuid - 3D 模型 UUID
-     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接��获取
+     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @returns 操作是否成功
      */
     delete(modelUuid: string, libraryUuid: string): Promise<boolean>;
@@ -5993,7 +6507,7 @@ declare class LIB_3DModel {
      *
      * @beta
      * @param key - 搜索关键字
-     * @param libraryUuid - 库 UUID，默认为系统库，可以使用 {@link LIB_LibrariesList} 内的接口获取
+     * @param libraryUuid - 库 UUID，默认为系统库��可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @param classification - 分类，默认为全部
      * @param itemsOfPage - 一页搜索结果的数量
      * @param page - 页数
@@ -6087,7 +6601,7 @@ declare class LIB_Cbb {
      * 在编辑器打开复用模块符号
      *
      * @beta
-     * @param cbbUuid - 复用模块 UUID
+     * @param cbbUuid - 复��模块 UUID
      * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
      * @param splitScreenId - 分屏 ID，不填写则默认在最后输入焦点的分屏内打开，可以使用 {@link DMT_EditorControl} 内的接口获取
      * @returns 标签页 ID，对应 {@link IDMT_EditorTabItem.tabId}，可使用 {@link DMT_EditorControl.getSplitScreenIdByTabId} 获取到分屏 ID
@@ -6187,7 +6701,7 @@ declare class LIB_Classification {
      */
     deleteByUuid(libraryUuid: string, classificationUuid: string): Promise<boolean>;
     /**
-     * 删除指定索引的分类
+     * 删除指定索���的分类
      *
      * @beta
      * @param classificationIndex - 分类索引
@@ -6284,7 +6798,7 @@ declare class LIB_Device {
      *
      * @beta
      * @param key - 搜索关键字
-     * @param libraryUuid - 库 UUID，默认为系统库，可以使用 {@link LIB_LibrariesList} 内的接口获取
+     * @param libraryUuid - 库 UUID，默认为系统库，可以��用 {@link LIB_LibrariesList} 内的接口获取
      * @param classification - 分类，默认为全部
      * @param symbolType - 符号类型，默认为全部
      * @param itemsOfPage - 一页搜索结果的数量
@@ -6432,7 +6946,14 @@ declare class LIB_LibrariesList {
      * @returns 个人库的 UUID
      */
     getPersonalLibraryUuid(): Promise<string | undefined>;
-    /* Excluded from this release type: getProjectLibraryUuid */
+    /**
+     * 获取工程库的 UUID
+     *
+     * @beta
+     * @remarks 在未打开工程的情况下调用将返回 `undefined`
+     * @returns 工程库的 UUID
+     */
+    getProjectLibraryUuid(): Promise<string | undefined>;
     /**
      * 获取收藏库的 UUID
      *
@@ -6632,18 +7153,29 @@ declare class PCB_Document {
      * 从原理图导入变更
      *
      * @public
-     * @returns 导入操作是否成功，导入失败或游离 PCB 返回 `false`
+     * @param uuid - 原理图 UUID，默认为关联在同一个 Board 下的原理图
+     * @returns 导入操作是否成功，导入失败或未传入原理图 UUID 的游离 PCB 将返回 `false`
      */
-    importChanges(uuid: string): Promise<boolean>;
+    importChanges(uuid?: string): Promise<boolean>;
     /**
-     * 导入自动布线文件（JSON）
+     * 导入旧版自动布线文件（JSON）
      *
      * @beta
      * @remarks 可以使用 {@link SYS_FileSystem.openReadFileDialog} 读入文件
      * @param autoRouteFile - 欲导入的 JSON 文件
      * @returns 导入操作是否成功
      */
-    importAutoRouteJsonFile(autoRouteFile: File): Promise<boolean>;
+    importOldAutoRouteJsonFile(autoRouteFile: File): Promise<boolean>;
+    /**
+     * 导入旧版自动布局文件（JSON）
+     *
+     * @beta
+     * @remarks 可以使用 {@link SYS_FileSystem.openReadFileDialog} 读入文件
+     * @deprecated 建议使用 {@link PCB_ManufactureData.getAutoLayoutJsonFile} 接口提供的自动布线文件，它对应 {@link PCB_Document.importAutoLayoutJsonFile} 导入接口
+     * @param autoLayoutFile - 欲导入的 JSON 文件
+     * @returns 导入操作是否成功
+     */
+    importOldAutoLayoutJsonFile(autoLayoutFile: File): Promise<boolean>;
     /**
      * 导入自动布局文件（JSON）
      *
@@ -6741,7 +7273,7 @@ declare class PCB_Document {
      * 即 `setCanvasOrigin(0, 0)`；
      *
      * 此处的单位为数据层面单位，在跨度上等同于画布层面的 mil
-     * @param offsetX - 画布原点相对于数据原点的 X 坐标偏移
+     * @param offsetX - ��布原点相对于数据原点的 X 坐标偏移
      * @param offsetY - 画布原点相对于数据原点的 Y 坐标偏移
      * @returns 操作是否成功
      */
@@ -6754,13 +7286,17 @@ declare class PCB_Document {
      * 本接口在前端画布上定位到指定的数据层面坐标；
      *
      * 如果希望在进行本操作时前端画布坐标能与传入数据一致，
-     * 建议调用 {@link PCB_Document.setCanvasOrigin} 方法并设置偏移量为零
+     * 建议调用 {@link PCB_Document.setCanvasOrigin} 方法并设置偏移量为零；
+     *
+     * 此处的单位为数据层面单位，在跨度上等同于画布层面的 mil
      * @param x - 坐标 X
      * @param y - 坐标 Y
      * @returns 操作是否成功
      */
     navigateToCoordinates(x: number, y: number): Promise<boolean>;
     /* Excluded from this release type: navigateToRegion */
+    /* Excluded from this release type: getPrimitiveAtPoint */
+    /* Excluded from this release type: getPrimitivesInRegion */
 }
 
 /**
@@ -6974,7 +7510,7 @@ declare class PCB_Drc {
      */
     getAllNetClasses(): Promise<Array<IPCB_NetClassItem>>;
     /**
-     * 创建差分对
+     * 创建���分对
      *
      * @beta
      * @param differentialPairName - 差分对名称
@@ -7448,7 +7984,7 @@ declare class PCB_ManufactureData {
      *
      * @public
      * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
-     * @deprecated 新版自动布线 JSON 文件正在开发中，之后将会取代本接口
+     * @deprecated 建议使用 {@link PCB_ManufactureData.getAutoRouteJsonFile} 接口提供的自动布线文件
      * @param fileName - 文件名
      * @returns 旧版自动布线 JSON 文件数据
      */
@@ -7467,7 +8003,7 @@ declare class PCB_ManufactureData {
      *
      * @beta
      * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
-     * @deprecated 新版自动布局 JSON 文件正在开发中，之后将会取代本接口
+     * @deprecated 建议使用 {@link PCB_ManufactureData.getAutoLayoutJsonFile} 接口提供的自动布局文件
      * @param fileName - 文件名
      * @returns 旧版自动布局 JSON 文件数据
      */
@@ -7585,14 +8121,33 @@ declare class PCB_Net {
      * @returns 操作是否成功
      */
     selectNet(net: string): Promise<boolean>;
+    /**
+     * 取消选中网络
+     *
+     * @beta
+     * @param net - 网络名称
+     * @returns 操作是否成功
+     */
+    unselectNet(net: string): Promise<boolean>;
+    /**
+     * 取消选中所有网络
+     *
+     * @beta
+     * @remarks 如果希望取消选中所有图元，请使用 {@link PCB_SelectControl.clearSelected} 接口
+     * @returns 操作是否成功
+     */
+    unselectAllNets(): Promise<boolean>;
     /**
      * 高亮网络
      *
      * @beta
+     * @remarks 本接口的返回值为结果导向，如果该网络原先已高亮，也将返回 `true`
      * @param net - 网络名称
      * @returns 操作是否成功
      */
     highlightNet(net: string): Promise<boolean>;
+    /* Excluded from this release type: unhighlightNet */
+    /* Excluded from this release type: unhighlightAllNets */
     /**
      * 获取网表
      *
@@ -7628,6 +8183,7 @@ declare class PCB_Primitive {
  * PCB & 封装 / 圆弧线图元类
  *
  * @public
+ * @remarks 直线和圆弧线均为导线，对应画布的线条走线和圆弧走线
  */
 declare class PCB_PrimitiveArc implements IPCB_PrimitiveAPI {
     /**
@@ -7787,9 +8343,17 @@ declare class PCB_PrimitiveComponent implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveIds - 器件的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 器件图元对象
+     * @returns 器件图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitiveComponent | undefined>;
+    /**
+     * 获取器件
+     *
+     * @beta
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+     * @param primitiveIds - 器件的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 器件图元对象，空数组表示获取失败
+     */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveComponent>>;
     /**
      * 获取所有器件的图元 ID
@@ -7797,7 +8361,7 @@ declare class PCB_PrimitiveComponent implements IPCB_PrimitiveAPI {
      * @beta
      * @param layer - 层
      * @param primitiveLock - 是否锁定
-     * @returns 器件��图元 ID 数组
+     * @returns 器件的图元 ID 数组
      */
     getAllPrimitiveId(layer?: TPCB_LayersOfComponent, primitiveLock?: boolean): Promise<Array<string>>;
     /**
@@ -7809,6 +8373,7 @@ declare class PCB_PrimitiveComponent implements IPCB_PrimitiveAPI {
      * @returns 器件图元对象数组
      */
     getAll(layer?: TPCB_LayersOfComponent, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveComponent>>;
+    /* Excluded from this release type: getAllPinsByPrimitiveId */
     /* Excluded from this release type: placeComponentWithMouse */
 }
 
@@ -7919,6 +8484,7 @@ declare class PCB_PrimitiveImage implements IPCB_PrimitiveAPI {
      * 创建图像
      *
      * @public
+     * @remarks 如需创建彩色丝印图像，请使用 {@link PCB_PrimitiveObject | 二进制内嵌对象图元类}
      * @param x - BBox 左上点坐标 X
      * @param y - BBox 左上点坐标 Y
      * @param complexPolygon - 图像源数据（复杂多边形），可以使用 {@link PCB_MathPolygon.convertImageToComplexPolygon} 方法将图像文件转换为复杂多边形数据
@@ -7995,13 +8561,14 @@ declare class PCB_PrimitiveImage implements IPCB_PrimitiveAPI {
 }
 
 /**
- * PCB & 封装 / 导线图元类
+ * PCB & 封装 / 直线图元类
  *
  * @public
+ * @remarks 直线和圆弧线均为导线，对应画布的线条走线和圆弧走线
  */
 declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
     /**
-     * 创建导线
+     * 创建直线
      *
      * @public
      * @param net - 网络名称
@@ -8012,24 +8579,24 @@ declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
      * @param endY - 终止位置 Y
      * @param lineWidth - 线宽
      * @param primitiveLock - 是否锁定
-     * @returns 导线图元对象
+     * @returns 直线图元对象
      */
     create(net: string, layer: TPCB_LayersOfLine, startX: number, startY: number, endX: number, endY: number, lineWidth?: number, primitiveLock?: boolean): Promise<IPCB_PrimitiveLine | undefined>;
     /**
-     * 删除导线
+     * 删除直线
      *
      * @beta
-     * @param primitiveIds - 导线的图元 ID 或导线图元对象
+     * @param primitiveIds - 直线的图元 ID 或直线图元对象
      * @returns 删除操作是否成功
      */
     delete(primitiveIds: string | IPCB_PrimitiveLine | Array<string> | Array<IPCB_PrimitiveLine>): Promise<boolean>;
     /**
-     * 修改导线
+     * 修改直线
      *
      * @beta
      * @param primitiveId - 图元 ID
      * @param property - 修改参数
-     * @returns 导线图元对象
+     * @returns 直线图元对象
      */
     modify(primitiveId: string | IPCB_PrimitiveLine, property: {
         net?: string;
@@ -8042,24 +8609,24 @@ declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
         primitiveLock?: boolean;
     }): Promise<IPCB_PrimitiveLine | undefined>;
     /**
-     * 获取导线
+     * 获取直线
      *
      * @beta
-     * @param primitiveIds - 导线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 导线图元对象，`undefined` 表示获取失败
+     * @param primitiveIds - 直线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 直线图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitiveLine | undefined>;
     /**
-     * 获取导线
+     * 获取直线
      *
      * @beta
      * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
-     * @param primitiveIds - 导线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 导线图元对象，空数组表示获取失败
+     * @param primitiveIds - 直线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 直线图元对象，空数组表示获取失败
      */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveLine>>;
     /**
-     * 获取所有导线的图元 ID
+     * 获取所有直线的图元 ID
      *
      * @beta
      * @param net - 网络名称
@@ -8069,17 +8636,33 @@ declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
      */
     getAllPrimitiveId(net?: string, layer?: TPCB_LayersOfLine, primitiveLock?: boolean): Promise<Array<string>>;
     /**
-     * 获取所有导线
+     * 获取所有直线
      *
      * @beta
      * @param net - 网络名称
      * @param layer - 层
      * @param primitiveLock - 是否锁定
-     * @returns 导线图元对象数组
+     * @returns 直线图元对象数组
      */
     getAll(net?: string, layer?: TPCB_LayersOfLine, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveLine>>;
 }
 
+/**
+ * PCB & 封装 / 二进制内嵌对象图元类
+ *
+ * @public
+ * @remarks 彩色丝印图像属于二进制内嵌对象，需要使用二进制内嵌对象的方法创建和修改
+ */
+declare class PCB_PrimitiveObject implements IPCB_PrimitiveAPI {
+    /* Excluded from this release type: create */
+    /* Excluded from this release type: delete */
+    /* Excluded from this release type: modify */
+    /* Excluded from this release type: get */
+    /* Excluded from this release type: get */
+    /* Excluded from this release type: getAllPrimitiveId */
+    /* Excluded from this release type: getAll */
+}
+
 /**
  * PCB & 封装 / 焊盘图元类
  *
@@ -8423,7 +9006,7 @@ declare class PCB_SelectControl {
      */
     doCrossProbeSelect(components?: Array<string>, pins?: Array<string>, nets?: Array<string>, highlight?: boolean, select?: boolean): Promise<boolean>;
     /**
-     * 清除��中
+     * 清除选中
      *
      * @beta
      * @returns 操作是否成功
@@ -8469,6 +9052,10 @@ declare class SCH_Document {
      * @returns 保存操作是否成功，保存失败、上传失败等错误均返回 `false`
      */
     save(): Promise<boolean>;
+    /* Excluded from this release type: navigateToCoordinates */
+    /* Excluded from this release type: navigateToRegion */
+    /* Excluded from this release type: getPrimitiveAtPoint */
+    /* Excluded from this release type: getPrimitivesInRegion */
 }
 
 /**
@@ -8739,7 +9326,7 @@ declare class SCH_PrimitiveBus implements ISCH_PrimitiveAPI {
      * 删除总线
      *
      * @beta
-     * @param primitiveIds - 总线的图�� ID 或总线图元对象
+     * @param primitiveIds - 总线的图元 ID 或总线图元对象
      * @returns 删除操作是否成功
      */
     delete(primitiveIds: string | ISCH_PrimitiveBus | Array<string> | Array<ISCH_PrimitiveBus>): boolean;
@@ -8795,7 +9382,7 @@ declare class SCH_PrimitiveCircle implements ISCH_PrimitiveAPI {
      * @param centerY - 圆心 Y
      * @param radius - 半径
      * @param color - 颜色，`null` 表示默认
-     * @param fillColor - 填充颜色，`none` 表示无填充，`null` 表示默认
+     * @param fillColor - 填充颜色，`none` 表示无填充，`null` 表示���认
      * @param lineWidth - 线宽，范围 `1-10`，`null` 表示默认
      * @param lineType - 线型，`0` 实线，`1` 短划线，`2` 点线，`3` 点划线，`null` 表示默认
      * @returns 圆图元对象
@@ -9022,7 +9609,7 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
      * @param name - 名称，`null` 表示留空
      * @param uniqueId - 唯一 ID，`null` 表示留空
      * @param manufacturer - 制造商，`null` 表示留空
-     * @param manufacturerId - 制造商编号，`null` 表示���空
+     * @param manufacturerId - 制造商编号，`null` 表示留空
      * @param supplier - 供应商，`null` 表示留空
      * @param supplierId - 供应商编号，`null` 表示留空
      * @returns 器件图元对象
@@ -9042,7 +9629,7 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
         supplier?: string | null;
         supplierId?: string | null;
         otherProperty?: {
-            [key: string]: string;
+            [key: string]: string | number | boolean;
         };
     }): Promise<ISCH_PrimitiveComponent | undefined>;
     /**
@@ -9067,6 +9654,7 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
      *
      * @beta
      * @param componentType - 器件类型
+     * @param allSchematicPages - 是否获取所有原理图图页的器件
      * @returns 器件的图元 ID 数组
      */
     getAllPrimitiveId(componentType?: string, allSchematicPages?: boolean): Promise<Array<string>>;
@@ -9075,6 +9663,7 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
      *
      * @beta
      * @param componentType - 器件类型
+     * @param allSchematicPages - 是否获取所有原理图图页的器件
      * @returns 器件图元对象数组
      */
     getAll(componentType?: string, allSchematicPages?: boolean): Promise<Array<ISCH_PrimitiveComponent>>;
@@ -9123,7 +9712,7 @@ declare class SCH_PrimitivePin implements ISCH_PrimitiveAPI {
      * @param y - 坐标 Y
      * @param pinNumber - 引脚编号
      * @param pinName - 引脚名称
-     * @param rotation - 旋转角度，可�� `0` `90` `180` `270`
+     * @param rotation - 旋转角度，可选 `0` `90` `180` `270`
      * @param pinLength - 引脚长度
      * @param pinColor - 引脚颜色，`null` 表示默认
      * @param activeLow - 是否低电平有效
@@ -9264,7 +9853,7 @@ declare class SCH_PrimitiveRectangle implements ISCH_PrimitiveAPI {
      * @param height - 高
      * @param cornerRadius - 圆角半径
      * @param rotation - 旋转角度，绕左上点旋转，可选 `0` `90` `180` `270`
-     * @param color - 颜色，`null` 表示默认
+     * @param color - 颜色，`null` ��示默认
      * @param fillColor - 填充颜色，`none` 表示无填充，`null` 表示默认
      * @param lineWidth - 线宽，范围 `1-10`，`null` 表示默认
      * @param lineType - 线型，`0` 实线，`1` 短划线，`2` 点线，`3` 点划线，`null` 表示默认
@@ -9308,7 +9897,7 @@ declare class SCH_PrimitiveText implements ISCH_PrimitiveAPI {
      * @beta
      * @param x - 坐标 X
      * @param y - 坐标 Y
-     * @param content - 文���内容
+     * @param content - 文本内容
      * @param rotation - 旋转角度，可选 `0` `90` `180` `270`
      * @param textColor - 文本颜色，`null` 表示默认
      * @param fontName - 字体名称，`null` 表示默认
@@ -9390,7 +9979,7 @@ declare class SCH_PrimitiveWire implements ISCH_PrimitiveAPI {
      *
      * 如若已指定，则遵循：
      * 1. 有一个或多个坐标点在其他网络的图元上，且其他图元并未显式（通常指的是包含网络标签或网络端口）指定网络，则其他图元跟随指定的网络；
-     * 2. 如若其他图元指定了网络，则创建失���
+     * 2. 如若其他图元指定了网络，则创建失败
      * @param color - 导线颜色，`null` 表示默认
      * @param lineWidth - 线宽，范围 `1-10`，`null` 表示默认
      * @param lineType - 线型，`0` 实线，`1` 短划线，`2` 点线，`3` 点划线，`null` 表示默认
@@ -9666,7 +10255,7 @@ declare class SYS_FileManager {
      * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
      * @param fileName - 文件名
      * @param password - 加密密码
-     * @returns 文档文件数据，`undefined` 表示当前未打开文档或数据获取失败
+     * @returns 文档文件数据，`undefined` 表示当前未打开文档或数据获��失败
      */
     getDocumentFile(fileName?: string, password?: string): Promise<File | undefined>;
     /**
@@ -9706,7 +10295,7 @@ declare class SYS_FileManager {
      */
     getProjectFileByProjectUuid(projectUuid: string, fileName?: string, password?: string): Promise<File | undefined>;
     /**
-     * 使用器件 UUID 获取���件文件
+     * 使用器件 UUID 获取器件文件
      *
      * @public
      * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
@@ -9751,7 +10340,7 @@ declare class SYS_FileSystem {
     private extensionUuid?;
     /* Excluded from this release type: __constructor */
     /**
-     * 打开读入文件窗口
+     * 打开读入文件���口
      *
      * @beta
      * @param filenameExtensions - 文件扩展名
@@ -9863,7 +10452,7 @@ declare class SYS_I18n {
      * @public
      * @remarks 注意：本接口仅扩展有效，在独立脚本环境内调用将始终 `throw Error`
      * @param language - 语言
-     * @param source - 欲导入的多语言数据对象
+     * @param source - 欲导��的多语言数据对象
      * @returns 导入是否成功
      */
     importMultilingual(language: string, source: ISYS_LanguageKeyValuePairs): boolean;
@@ -10031,7 +10620,7 @@ declare class SYS_MessageBox {
      *
      * @public
      * @deprecated 请使用 {@link SYS_Dialog.showConfirmationMessage} 替代
-     * @remarks 显示一个拥有确认和取消按钮的���认框
+     * @remarks 显示一个拥有确认和取消按钮的确认框
      * @param content - 消息文本，支持使用 `\n` 换行
      * @param title - 确认框标题
      * @param mainButtonTitle - 主要按钮标题
@@ -10115,7 +10704,7 @@ declare class SYS_PanelControl {
      */
     closeBottomPanel(): void;
     /**
-     * 切换底部面板锁定状态
+     * 切换底部面板锁定��态
      *
      * @public
      * @param state - 是否锁定，如若不指定则反置当前状态
@@ -10546,6 +11135,13 @@ declare type TPCB_LayersOfInner = EPCB_LayerId.INNER_1 | EPCB_LayerId.INNER_2 |
  */
 declare type TPCB_LayersOfLine = TPCB_LayersOfCopper | TPCB_LayersOfCustom | EPCB_LayerId.TOP_SILKSCREEN | EPCB_LayerId.TOP_SOLDER_MASK | EPCB_LayerId.TOP_PASTE_MASK | EPCB_LayerId.TOP_ASSEMBLY | EPCB_LayerId.BOTTOM_SILKSCREEN | EPCB_LayerId.BOTTOM_SOLDER_MASK | EPCB_LayerId.BOTTOM_PASTE_MASK | EPCB_LayerId.BOTTOM_ASSEMBLY | EPCB_LayerId.BOARD_OUTLINE | EPCB_LayerId.DOCUMENT | EPCB_LayerId.MECHANICAL | EPCB_LayerId.DRILL_DRAWING;
 
+/**
+ * 二进制内嵌对象所属层
+ *
+ * @public
+ */
+declare type TPCB_LayersOfObject = EPCB_LayerId.TOP_SILKSCREEN | EPCB_LayerId.BOTTOM_SILKSCREEN | EPCB_LayerId.DOCUMENT;
+
 /**
  * 焊盘所属层
  *
@@ -10568,7 +11164,7 @@ declare type TPCB_LayersOfRegion = TPCB_LayersOfCopper | EPCB_LayerId.MULTI;
 declare type TPCB_LayerTypesOfInnerLayer = EPCB_LayerType.SIGNAL | EPCB_LayerType.INTERNAL_ELECTRICAL;
 
 /**
- * ��多边形源数组
+ * 单多边形源数组
  *
  * @public
  * @remarks