@jlceda/pro-api-types 0.1.79 → 0.1.81

package/index.d.ts

@@ -744,11 +744,14 @@ declare class EDA {
     pcb_Primitive: PCB_Primitive;
     pcb_PrimitiveArc: PCB_PrimitiveArc;
     pcb_PrimitiveComponent: PCB_PrimitiveComponent;
+    pcb_PrimitiveFill: PCB_PrimitiveFill;
     pcb_PrimitiveDimension: PCB_PrimitiveDimension;
     pcb_PrimitiveImage: PCB_PrimitiveImage;
     pcb_PrimitiveLine: PCB_PrimitiveLine;
     pcb_PrimitivePad: PCB_PrimitivePad;
     pcb_PrimitivePolyline: PCB_PrimitivePolyline;
+    pcb_PrimitivePour: PCB_PrimitivePour;
+    pcb_PrimitiveRegion: PCB_PrimitiveRegion;
     pcb_PrimitiveVia: PCB_PrimitiveVia;
     pcb_SelectControl: PCB_SelectControl;
     pnl_Document: PNL_Document;
@@ -956,11 +959,17 @@ declare enum ELIB_SymbolType {
  * @public
  */
 declare enum ENetlistType {
+    /** Allegro */
     ALLEGRO = "Allegro",
+    /** PADS */
     PADS = "PADS",
+    /** Protel 2 */
     PROTEL2 = "Protel2",
+    /** 嘉立创 EDA 专业版 */
     JLCEDA_PRO = "JLCEDA",
+    /** EasyEDA Pro Edition */
     EASYEDA_PRO = "EasyEDA",
+    /** Altium Designer */
     ALTIUM_DESIGNER = "AltiumDesigner"
 }
 
@@ -1237,11 +1246,26 @@ declare enum EPCB_PrimitiveArcInteractiveMode {
  */
 declare enum EPCB_PrimitiveDimensionType {
     /** 半径 */
-    RADIUS = "RADIUS",
+    RADIUS = "Radius Dimension",
     /** 长度 */
-    LENGTH = "LENGTH",
+    LENGTH = "Length Dimension",
     /** 角度 */
-    ANGLE = "ANGLE"
+    ANGLE = "Protractor Dimension"
+}
+
+/**
+ * 填充图元填充模式
+ *
+ * @public
+ * @remarks 网格填充和内电层填充为预留配置
+ */
+declare enum EPCB_PrimitiveFillMode {
+    /** 实心填充 */
+    SOLID = 0,
+    /** 网格填充 */
+    MESH = 1,
+    /** 内电层填充 */
+    INNER_ELECTRICAL_LAYER = 2
 }
 
 /**
@@ -1302,6 +1326,29 @@ declare enum EPCB_PrimitivePadShapeType {
     POLYLINE_COMPLEX_POLYGON = "POLYGON"
 }
 
+/**
+ * 区域图元区域规则类型
+ *
+ * @public
+ * @remarks {@link EPCB_PrimitiveRegionRuleType.FOLLOW_REGION_RULE | FOLLOW_REGION_RULE} 即为约束区域
+ */
+declare enum EPCB_PrimitiveRegionRuleType {
+    /** 禁止元件 */
+    NO_COMPONENTS = 2,
+    /** 禁止过孔 */
+    NO_VIAS = 3,
+    /** 禁止布线 */
+    NO_WIRES = 5,
+    /** 禁止填充 */
+    NO_FILLS = 6,
+    /** 禁止覆铜 */
+    NO_POURS = 7,
+    /** 禁止内电层 */
+    NO_INNER_ELECTRICAL_LAYERS = 8,
+    /** 约束区域 */
+    FOLLOW_REGION_RULE = 9
+}
+
 /**
  * 图元类型
  *
@@ -1316,6 +1363,12 @@ declare enum EPCB_PrimitiveType {
     PAD = "Pad",
     /** 折线 */
     POLYLINE = "Polyline",
+    /** 覆铜边框 */
+    POUR = "Pour",
+    /** 填充 */
+    FILL = "Fill",
+    /** 区域 */
+    REGION = "Region",
     /** 直线 */
     LINE = "Line",
     /** 过孔 */
@@ -1323,9 +1376,7 @@ declare enum EPCB_PrimitiveType {
     /** 尺寸标注 */
     DIMENSION = "Dimension",
     /** 图像 */
-    IMAGE = "Image",
-    /** 图像 */
-    PICTURE = "Picture"
+    IMAGE = "Image"
 }
 
 /**
@@ -2382,51 +2433,204 @@ declare class IPCB_PrimitiveArc implements IPCB_Primitive {
     /** 是否锁定 */
     private primitiveLock;
     /* 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_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_ArcAngle(): number;
+    /**
+     * 获取属性状态：线宽
+     *
+     * @public
+     * @returns 线宽
+     */
+    getState_LineWidth(): number;
+    /**
+     * 获取属性状态：交互模式
+     *
+     * @public
+     * @returns 交互模式
+     */
+    getState_InteractiveMode(): EPCB_PrimitiveArcInteractiveMode;
+    /**
+     * 获取属性状态：是否锁定
+     *
+     * @public
+     * @returns 是否锁定
+     */
+    getState_PrimitiveLock(): boolean;
+    /**
+     * 设置属性状态：网络名称
      *
      * @beta
+     * @param net - 网络名称
      * @returns 圆弧线图元对象
      */
-    create(): Promise<IPCB_PrimitiveArc>;
+    setState_Net(net: string): IPCB_PrimitiveArc;
     /**
-     * 获取对象的图元 ID
+     * 设置属性状态：层
      *
-     * @returns
+     * @beta
+     * @param layer - 层
+     * @returns 圆弧线图元对象
      */
-    getState_PrimitiveId(): string;
-    /* Excluded from this release type: setState_Net */
-    /* Excluded from this release type: setState_Layer */
-    /* Excluded from this release type: setState_StartX */
-    /* Excluded from this release type: setState_StartY */
-    /* Excluded from this release type: setState_EndX */
-    /* Excluded from this release type: setState_EndY */
-    /* Excluded from this release type: setState_ArcAngle */
-    /* Excluded from this release type: setState_LineWidth */
-    /* Excluded from this release type: setState_InteractiveMode */
-    /* Excluded from this release type: setState_PrimitiveLock */
+    setState_Layer(layer: TPCB_LayersOfLine): IPCB_PrimitiveArc;
+    /**
+     * 设置属性状态：起始位置 X
+     *
+     * @beta
+     * @param startX - 起始位置 X
+     * @returns 圆弧线图元对象
+     */
+    setState_StartX(startX: number): IPCB_PrimitiveArc;
+    /**
+     * 设置属性状态：起始位置 Y
+     *
+     * @beta
+     * @param startY - 起始位置 Y
+     * @returns 圆弧线图元对象
+     */
+    setState_StartY(startY: number): IPCB_PrimitiveArc;
+    /**
+     * 设置属性状态：终止位置 X
+     *
+     * @beta
+     * @param endX - 终止位置 X
+     * @returns 圆弧线图元对象
+     */
+    setState_EndX(endX: number): IPCB_PrimitiveArc;
+    /**
+     * 设置属性状态：终止位置 Y
+     *
+     * @beta
+     * @param endY - 终止位置 Y
+     * @returns 圆弧线图元对象
+     */
+    setState_EndY(endY: number): IPCB_PrimitiveArc;
+    /**
+     * 设置属性状态：圆弧角度
+     *
+     * @beta
+     * @param arcAngle - 圆弧角度
+     * @returns 圆弧线图元对象
+     */
+    setState_ArcAngle(arcAngle: number): IPCB_PrimitiveArc;
+    /**
+     * 设置属性状态：线宽
+     *
+     * @beta
+     * @param lineWidth - 线宽
+     * @returns 圆弧线图元对象
+     */
+    setState_LineWidth(lineWidth: number): IPCB_PrimitiveArc;
+    /**
+     * 设置属性状态：交互模式
+     *
+     * @beta
+     * @param interactiveMode - 交互模式
+     * @returns 圆弧线图元对象
+     */
+    setState_InteractiveMode(interactiveMode: EPCB_PrimitiveArcInteractiveMode): IPCB_PrimitiveArc;
+    /**
+     * 设置属性状态：是否锁定
+     *
+     * @beta
+     * @param primitiveLock - 是否锁定
+     * @returns 圆弧线图元对象
+     */
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveArc;
     /**
      * 将图元转换为异步图元
+     *
+     * @public
+     * @returns 圆弧线图元对象
      */
     toAsync(): IPCB_PrimitiveArc;
     /**
      * 将图元转换为同步图元
+     *
+     * @public
+     * @returns 圆弧线图元对象
      */
     toSync(): IPCB_PrimitiveArc;
     /**
      * 查询图元是否为异步图元
+     *
+     * @public
+     * @returns 是否为异步图元
      */
     isAsync(): boolean;
     /**
      * 将异步图元重置为当前画布状态
      *
      * @beta
+     * @returns 圆弧线图元对象
      */
     reset(): Promise<IPCB_PrimitiveArc>;
     /**
      * 将对图元的更改应用到画布
      *
      * @beta
+     * @returns 圆弧线图元对象
      */
     done(): Promise<IPCB_PrimitiveArc>;
 }
@@ -2567,21 +2771,77 @@ declare class IPCB_PrimitiveDimension implements IPCB_Primitive {
     /** 是否锁定 */
     private primitiveLock;
     /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
     /**
-     * 在 PCB 画布中创建图元
+     * 获取属性状态：图元类型
      *
-     * @beta
-     * @returns 尺寸标注图元对象
+     * @public
+     * @returns 图元类型
      */
-    create(): Promise<IPCB_PrimitiveDimension>;
-    /** @alpha 定义 getState_* 函数 × 10 */
+    getState_PrimitiveType(): EPCB_PrimitiveType;
     /**
-     * 获取对象的图元 ID
+     * 获取属性状态：图元 ID
      *
-     * @returns
+     * @public
+     * @returns 图元 ID
      */
     getState_PrimitiveId(): string;
-    /** @alpha 所有的 setState_* 方法都需要对数据进行基本的格式校验 */
+    /**
+     * 获取属性状态：尺寸标注类型
+     *
+     * @public
+     * @returns 尺寸标注类型
+     */
+    getState_DimensionType(): EPCB_PrimitiveDimensionType;
+    /**
+     * 获取属性状态：坐标集
+     *
+     * @public
+     * @returns 坐标集
+     */
+    getState_CoordinateSet(): TPCB_PrimitiveDimensionCoordinateSet;
+    /**
+     * 获取属性状态：层
+     *
+     * @public
+     * @returns 层
+     */
+    getState_Layer(): TPCB_LayersOfDimension;
+    /**
+     * 获取属性状态：单位
+     *
+     * @public
+     * @returns 单位
+     */
+    getState_Unit(): ESYS_Unit.MILLIMETER | ESYS_Unit.CENTIMETER | ESYS_Unit.INCH | ESYS_Unit.MIL;
+    /**
+     * 获取属性状态：线宽
+     *
+     * @public
+     * @returns 线宽
+     */
+    getState_LineWidth(): number;
+    /**
+     * 获取属性状态：精度
+     *
+     * @public
+     * @returns 精度
+     */
+    getState_Precision(): number;
+    /**
+     * 获取属性状态：文字跟随
+     *
+     * @public
+     * @returns 文字跟随
+     */
+    getState_TextFollow(): 0 | 1;
+    /**
+     * 获取属性状态：是否锁定
+     *
+     * @public
+     * @returns 是否锁定
+     */
+    getState_PrimitiveLock(): boolean;
     /**
      * 设置属性状态：尺寸标注类型
      *
@@ -2676,479 +2936,1494 @@ declare class IPCB_PrimitiveDimension implements IPCB_Primitive {
 }
 
 /**
- * 图像图元
+ * 填充图元
  *
  * @public
  */
-declare class IPCB_PrimitiveImage implements IPCB_Primitive {
+declare class IPCB_PrimitiveFill implements IPCB_Primitive {
     /** 异步 */
     private async;
     /** 图元类型 */
     private readonly primitiveType;
     /** 图元 ID */
     private primitiveId?;
-    /** BBox 左上点坐标 X */
-    private x;
-    /** BBox 左上点坐标 Y */
-    private y;
-    /** 图像源数据（复杂多边形） */
-    private complexPolygon;
+    /** 网络名称 */
+    private net;
     /** 层 */
     private layer;
-    /** 宽 */
-    private width;
-    /** 高 */
-    private height;
-    /** 旋转角度 */
-    private rotation;
-    /** 是否水平镜像 */
-    private horizonMirror;
+    /** 复杂多边形 */
+    private complexPolygon;
+    /** 填充模式 */
+    private fillMode;
+    /** 线宽 */
+    private lineWidth?;
     /** 是否锁定 */
     private primitiveLock;
     /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
     /**
-     * 在 PCB 画布中创建图元
+     * 获取属性状态：图元类型
      *
-     * @beta
-     * @returns 图像图元对象
+     * @public
+     * @returns 图元类型
      */
-    create(): Promise<IPCB_PrimitiveImage>;
-    /** @alpha 定义 getState_* 函数 × 11 */
+    getState_PrimitiveType(): EPCB_PrimitiveType;
     /**
-     * 获取对象���图元 ID
+     * 获取属性状态：图元 ID
      *
-     * @returns
+     * @public
+     * @returns 图元 ID
      */
     getState_PrimitiveId(): string;
-    /** @alpha 所有的 setState_* 方法都需要对数据进行基本的格式校验 */
     /**
-     * 设置属性状态：BBox 左上点坐标 X
+     * 获取属性状态：网络名称
      *
-     * @beta
-     * @param x - BBox 左上点坐标 X
-     * @returns 图像图元对象
+     * @public
+     * @returns 网络名称
      */
-    setState_X(x: number): IPCB_PrimitiveImage;
+    getState_Net(): string;
     /**
-     * 设置属性状态：BBox 左上点坐标 Y
+     * 获取属性状态：层
      *
-     * @beta
-     * @param y - BBox 左上点坐标 Y
-     * @returns 图像图元对象
+     * @public
+     * @returns 层
      */
-    setState_Y(y: number): IPCB_PrimitiveImage;
+    getState_Layer(): TPCB_LayersOfFill;
     /**
-     * 设置属性状态：层
+     * 获取属性状态：复杂多边形
      *
-     * @beta
-     * @param layer - 层
-     * @returns 图像图元对象
+     * @public
+     * @returns 复杂多边形
      */
-    setState_Layer(layer: TPCB_LayersOfImage): IPCB_PrimitiveImage;
+    getState_ComplexPolygon(): IPCB_ComplexPolygon;
     /**
-     * 设置属性状态：宽
+     * 获取属性状态：填充模式
      *
-     * @beta
-     * @param width - 宽
-     * @returns 图像图元对象
+     * @public
+     * @returns 填充模式
      */
-    setState_Width(width: number): IPCB_PrimitiveImage;
+    getState_FillMode(): EPCB_PrimitiveFillMode;
     /**
-     * 设置属性状态：高
+     * 获取属性状态：线宽
      *
-     * @beta
-     * @param height - 高
-     * @returns 图像图元对象
+     * @public
+     * @returns 线宽
      */
-    setState_Height(height: number): IPCB_PrimitiveImage;
+    getState_LineWidth(): number;
     /**
-     * 设置属性状态：旋转角度
+     * 获取属性状态：是否锁定
      *
-     * @beta
-     * @param rotation - 旋转角度
-     * @returns 图像图元对象
+     * @public
+     * @returns 是否锁定
      */
-    setState_Rotation(rotation: number): IPCB_PrimitiveImage;
+    getState_PrimitiveLock(): boolean;
     /**
-     * 设置属性状态：是否水平镜像
+     * 设置属性状态：网络名称
      *
      * @beta
-     * @param horizonMirror - 是否水平镜像
-     * @returns 图像图元对象
+     * @param net - 网络名称
+     * @returns 填充图元对象
      */
-    setState_HorizonMirror(horizonMirror: boolean): IPCB_PrimitiveImage;
+    setState_Net(net: string): IPCB_PrimitiveFill;
     /**
-     * 设置属性状态：是否锁定
+     * 设置属性状态：层
      *
      * @beta
-     * @param primitiveLock - 是否锁定
-     * @returns 图像图元对象
+     * @param layer - 层
+     * @returns 填充图元对象
      */
-    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveImage;
+    setState_Layer(layer: TPCB_LayersOfFill): IPCB_PrimitiveFill;
     /**
-     * 将图元转换为异步图元
+     * 设置属性状态：复杂多边形
+     *
+     * @beta
+     * @param complexPolygon - 复杂多边形
+     * @returns 填充图元对象
+     */
+    setState_ComplexPolygon(complexPolygon: IPCB_ComplexPolygon): IPCB_PrimitiveFill;
+    /**
+     * 设置属性状态：填充模式
+     *
+     * @beta
+     * @param fillMode - 填充模式
+     * @returns 填充图元对象
+     */
+    setState_FillMode(fillMode: EPCB_PrimitiveFillMode): IPCB_PrimitiveFill;
+    /**
+     * 设置属性状态：线宽
+     *
+     * @beta
+     * @param lineWidth - 线宽
+     * @returns 填充图元对象
+     */
+    setState_LineWidth(lineWidth: number): IPCB_PrimitiveFill;
+    /**
+     * 设置属性状态：是否锁定
+     *
+     * @beta
+     * @param primitiveLock - 是否锁定
+     * @returns 填充图元对象
+     */
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveFill;
+    /**
+     * 将图元转换为异步图元
+     *
+     * @public
+     * @returns 填充图元对象
+     */
+    toAsync(): IPCB_PrimitiveFill;
+    /**
+     * 将图元转换为同步图元
+     *
+     * @public
+     * @returns 填充图元对象
+     */
+    toSync(): IPCB_PrimitiveFill;
+    /**
+     * 查询图元是否为异步图元
+     *
+     * @public
+     * @returns 是否为异步图元
+     */
+    isAsync(): boolean;
+    /* Excluded from this release type: reset */
+    /* Excluded from this release type: done */
+    /* Excluded from this release type: convertToPolyline */
+    /* Excluded from this release type: convertToPour */
+    /* Excluded from this release type: convertToRegion */
+}
+
+/**
+ * 图像图元
+ *
+ * @public
+ */
+declare class IPCB_PrimitiveImage implements IPCB_Primitive {
+    /** 异步 */
+    private async;
+    /** 图元类型 */
+    private readonly primitiveType;
+    /** 图元 ID */
+    private primitiveId?;
+    /** BBox 左上点坐标 X */
+    private x;
+    /** BBox 左上点坐标 Y */
+    private y;
+    /** 图像源数据（复杂多边形） */
+    private complexPolygon;
+    /** 层 */
+    private layer;
+    /** 宽 */
+    private width;
+    /** 高 */
+    private height;
+    /** 旋转角度 */
+    private rotation;
+    /** 是否水平镜像 */
+    private horizonMirror;
+    /** 是否锁定 */
+    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;
+    /**
+     * 获取属性状态：BBox 左上点坐标 X
+     *
+     * @public
+     * @returns BBox 左上点坐标 X
+     */
+    getState_X(): number;
+    /**
+     * 获取属性状态：BBox 左上点坐标 Y
+     *
+     * @public
+     * @returns BBox 左上点坐标 Y
+     */
+    getState_Y(): number;
+    /**
+     * 获取属性状态：图像源数据（复杂多边形）
+     *
+     * @public
+     * @returns 图像源数据（复杂多边形）
+     */
+    getState_ComplexPolygon(): TPCB_PolygonSourceArray | Array<TPCB_PolygonSourceArray>;
+    /**
+     * 获取属性状态：层
+     *
+     * @public
+     * @returns 层
+     */
+    getState_Layer(): TPCB_LayersOfImage;
+    /**
+     * 获取属性状态：宽
+     *
+     * @public
+     * @returns 宽
+     */
+    getState_Width(): number;
+    /**
+     * 获取属性状态：高
+     *
+     * @public
+     * @returns 高
+     */
+    getState_Height(): number;
+    /**
+     * 获取属性状态：旋转角度
+     *
+     * @public
+     * @returns 旋转角度
+     */
+    getState_Rotation(): number;
+    /**
+     * 获取属性状态：是否水平镜像
+     *
+     * @public
+     * @returns 是否水平镜像
+     */
+    getState_HorizonMirror(): boolean;
+    /**
+     * 获取属性状态：是否锁定
+     *
+     * @public
+     * @returns 是否锁定
+     */
+    getState_PrimitiveLock(): boolean;
+    /**
+     * 设置属性状态：BBox 左上点坐标 X
+     *
+     * @beta
+     * @param x - BBox 左上点坐标 X
+     * @returns 图像图元对象
+     */
+    setState_X(x: number): IPCB_PrimitiveImage;
+    /**
+     * 设置属性状态：BBox 左上点坐标 Y
+     *
+     * @beta
+     * @param y - BBox 左上点坐标 Y
+     * @returns 图像图元对象
+     */
+    setState_Y(y: number): IPCB_PrimitiveImage;
+    /**
+     * 设置属性状态：层
+     *
+     * @beta
+     * @param layer - 层
+     * @returns 图像图元对象
+     */
+    setState_Layer(layer: TPCB_LayersOfImage): IPCB_PrimitiveImage;
+    /**
+     * 设置属性状态：宽
+     *
+     * @beta
+     * @param width - 宽
+     * @returns 图像图元对象
+     */
+    setState_Width(width: number): IPCB_PrimitiveImage;
+    /**
+     * 设置属性状态：高
+     *
+     * @beta
+     * @param height - 高
+     * @returns 图像图元对象
+     */
+    setState_Height(height: number): IPCB_PrimitiveImage;
+    /**
+     * 设置属性状态：旋转角度
+     *
+     * @beta
+     * @param rotation - 旋转角度
+     * @returns 图像图元对象
+     */
+    setState_Rotation(rotation: number): IPCB_PrimitiveImage;
+    /**
+     * 设置属性状态：是否水平镜像
+     *
+     * @beta
+     * @param horizonMirror - 是否水平镜像
+     * @returns 图像图元对象
+     */
+    setState_HorizonMirror(horizonMirror: boolean): IPCB_PrimitiveImage;
+    /**
+     * 设置属性状态：是否锁定
+     *
+     * @beta
+     * @param primitiveLock - 是否锁定
+     * @returns 图像图元对象
+     */
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveImage;
+    /**
+     * 将图元转换为异步图元
+     *
+     * @public
+     * @returns 图像图元对象
+     */
+    toAsync(): IPCB_PrimitiveImage;
+    /**
+     * 将图元转换为同步图元
+     *
+     * @public
+     * @returns 图像图元对象
+     */
+    toSync(): IPCB_PrimitiveImage;
+    /**
+     * 查询图元是否为异步图元
+     *
+     * @public
+     * @returns 是否为异步图元
+     */
+    isAsync(): boolean;
+    /**
+     * 将异步图元重置为当前画布状态
+     *
+     * @beta
+     * @returns 图像图元对象
+     */
+    reset(): Promise<IPCB_PrimitiveImage>;
+    /**
+     * 将对图元的更改应用到画布
+     *
+     * @beta
+     * @returns 图像图元对象
+     */
+    done(): Promise<IPCB_PrimitiveImage>;
+    /* Excluded from this release type: setState_ComplexPolygon */
+}
+
+/**
+ * 导线图元
+ *
+ * @public
+ */
+declare class IPCB_PrimitiveLine implements IPCB_Primitive {
+    /** 异步 */
+    private async;
+    /** 图元类型 */
+    private readonly primitiveType;
+    /** 图元 ID */
+    private primitiveId?;
+    /** 网络名称 */
+    private net;
+    /** 层 */
+    private layer;
+    /** 起始位置 X */
+    private startX;
+    /** 起始位置 Y */
+    private startY;
+    /** 终止位置 X */
+    private endX;
+    /** 终止位置 Y */
+    private endY;
+    /** 线宽 */
+    private lineWidth;
+    /** 是否锁定 */
+    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 网络名称
+     */
+    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>;
+}
+
+/**
+ * 焊盘图元
+ *
+ * @public
+ */
+declare class IPCB_PrimitivePad implements IPCB_Primitive {
+    /** 异步 */
+    private async;
+    /** 图元类型 */
+    private readonly primitiveType;
+    /** 图元 ID */
+    private primitiveId?;
+    /** 层 */
+    private layer;
+    /** 焊盘编号 */
+    private padNumber;
+    /** 位置 X */
+    private x;
+    /** 位置 Y */
+    private y;
+    /** 旋转角度 */
+    private rotation;
+    /** 焊盘外形 */
+    private pad?;
+    /** 网络名称 */
+    private net?;
+    /** 孔 */
+    private hole;
+    /** 孔偏移 X */
+    private holeOffsetX;
+    /** 孔偏移 Y */
+    private holeOffsetY;
+    /** 孔相对于焊盘的旋转角度 */
+    private holeRotation;
+    /** 是否金属化孔壁 */
+    private metallization;
+    /** 焊盘功能 */
+    private padFunction;
+    /** 特殊焊盘外形 */
+    private specialPad?;
+    /** 阻焊/助焊扩展 */
+    private solderMaskAndPasteMaskExpansion;
+    /** 热焊优化参数 */
+    private heatWelding;
+    /** 是否锁定 */
+    private primitiveLock;
+    /* Excluded from this release type: __constructor */
+    /**
+     * 在 PCB 画布中创建图元
+     *
+     * @beta
+     * @returns 焊盘图元对象
+     */
+    create(): Promise<IPCB_PrimitivePad>;
+    /**
+     * 获取属性状态：图元类型
+     *
+     * @public
+     * @returns 图元类型
+     */
+    getState_PrimitiveType(): EPCB_PrimitiveType;
+    /**
+     * 获取属性状态：图元 ID
+     *
+     * @public
+     * @returns 图元 ID
+     */
+    getState_PrimitiveId(): string;
+    /**
+     * 获取属性状态：层
+     *
+     * @public
+     * @returns 层
+     */
+    getState_Layer(): TPCB_LayersOfPad;
+    /**
+     * 获取属性状态：焊盘编号
+     *
+     * @public
+     * @returns 焊盘编号
+     */
+    getState_PadNumber(): string;
+    /**
+     * 获取属性状态：位置 X
+     *
+     * @public
+     * @returns 位置 X
+     */
+    getState_X(): number;
+    /**
+     * 获取属性状态：位置 Y
+     *
+     * @public
+     * @returns 位置 Y
+     */
+    getState_Y(): number;
+    /**
+     * 获取属性状态：旋转角度
+     *
+     * @public
+     * @returns 旋转角度
+     */
+    getState_Rotation(): number;
+    /**
+     * 获取属性状态：焊盘外形
+     *
+     * @public
+     * @returns 焊盘外形
+     */
+    getState_Pad(): TPCB_PrimitivePadShape | undefined;
+    /**
+     * 获取属性状态：网络名称
+     *
+     * @public
+     * @returns 网络名称
+     */
+    getState_Net(): string | undefined;
+    /**
+     * 获取属性状态：孔
+     *
+     * @public
+     * @returns 孔
+     */
+    getState_Hole(): TPCB_PrimitivePadHole | null;
+    /**
+     * 获取属性状态：孔偏移 X
+     *
+     * @public
+     * @returns 孔偏移 X
+     */
+    getState_HoleOffsetX(): number;
+    /**
+     * 获取属性状态：孔偏移 Y
+     *
+     * @public
+     * @returns 孔偏移 Y
+     */
+    getState_HoleOffsetY(): number;
+    /**
+     * 获取属性状态：孔相对于焊盘的旋转角度
+     *
+     * @public
+     * @returns 孔相对于焊盘的旋转角度
+     */
+    getState_HoleRotation(): number;
+    /**
+     * 获取属性状态：是否金属化孔壁
+     *
+     * @public
+     * @returns 是否金属化孔壁
+     */
+    getState_Metallization(): boolean;
+    /**
+     * 获取属性状态：焊盘功能
+     *
+     * @public
+     * @returns 焊盘功能
+     */
+    getState_PadFunction(): EPCB_PrimitivePadFunction;
+    /**
+     * 获取属性状态：特殊焊盘外形
+     *
+     * @public
+     * @returns 特殊焊盘外形
+     */
+    getState_SpecialPad(): TPCB_PrimitiveSpecialPadShape | undefined;
+    /**
+     * 获取属性状态：阻焊/助焊扩展
+     *
+     * @public
+     * @returns 阻焊/助焊扩展
+     */
+    getState_SolderMaskAndPasteMaskExpansion(): IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null;
+    /**
+     * 获取属性状态：热焊优化参数
+     *
+     * @public
+     * @returns 热焊优化参数
+     */
+    getState_HeatWelding(): IPCB_PrimitivePadHeatWelding | null;
+    /**
+     * 获取属性状态：是否锁定
+     *
+     * @public
+     * @returns 是否锁定
+     */
+    getState_PrimitiveLock(): boolean;
+    /**
+     * 设置属性状态：层
+     *
+     * @beta
+     * @remarks
+     * 设置层时将会联动设置部分其它属性状态：
+     *
+     * 1. 顶层与底层切换时：阻焊/助焊扩展属性将会跟随切换，数据值不变
+     *
+     * 2. 多层切换到单层时：判断切换到顶层还是底层，阻焊/助焊扩展属性将只保留指定层对应的数据；如若存在特殊焊盘，将转换为普通焊盘属性，并且只保留指定层对应的数据；与孔有关的属性将被重置到默认值
+     *
+     * 3. 单层切换到多层时：阻焊/助焊扩展属性将只保留阻焊扩展，并复制原数据应用于顶层和底层；焊盘钻孔属性将被赋指定值，长宽均为焊盘直径（焊盘为长圆形或正多边形）、宽（焊盘为矩形）的 60% 的长圆形（数据层面上是长圆形，实则是正圆形），如若焊盘为折线复杂多边形，则通过专用算法计算得出数据（通常比较抽象，建议后期修改）
+     *
+     * @param layer - 层
+     * @returns 焊盘图元对象
+     */
+    setState_Layer(layer: TPCB_LayersOfPad): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：焊盘编号
+     *
+     * @beta
+     * @param padNumber - 焊盘编号
+     * @returns 焊盘图元对象
+     */
+    setState_PadNumber(padNumber: string): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：位置 X
+     *
+     * @beta
+     * @param x - 位置 X
+     * @returns 焊盘图元对象
+     */
+    setState_X(x: number): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：位置 Y
+     *
+     * @beta
+     * @param y - 位置 Y
+     * @returns 焊盘图元对象
+     */
+    setState_Y(y: number): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：旋转角度
+     *
+     * @beta
+     * @param rotation - 旋转角度
+     * @returns 焊盘图元对象
+     */
+    setState_Rotation(rotation: number): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：焊盘外形
+     *
+     * @beta
+     * @remarks
+     * 设置焊盘外形时将会联动设置部分其它属性状态：
+     *
+     * 1. 特殊焊盘外形属性将被清空
+     *
+     * @param pad - 焊盘外形
+     * @returns 焊盘图元对象
+     */
+    setState_Pad(pad: TPCB_PrimitivePadShape): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：网络
+     *
+     * @beta
+     * @remarks 本接口仅在 PCB 编辑器可用，空字符串与 `undefined` 均被视为空网络
+     * @param net - 网络名称
+     * @returns 焊盘图元对象
+     */
+    setState_Net(net?: string): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：孔
+     *
+     * @beta
+     * @remarks
+     * 设置孔时将会联动设置部分其它属性状态：
+     *
+     * 1. 层将会强制切换到多层
+     *
+     * 本接口无法将孔设置为 `null`，如果想要移除孔属性，请使用 {@link IPCB_PrimitivePad.setState_Layer | setState_Layer} 方法切换层为顶层或底层
+     *
+     * @param hole - 焊盘钻孔
+     * @returns 焊盘图元对象
+     */
+    setState_Hole(hole: TPCB_PrimitivePadHole): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：孔偏移 X
+     *
+     * @beta
+     * @remarks 如若孔不存在，则属性将不会被修改
+     * @param holeOffsetX - 孔偏移 X
+     * @returns 焊盘图元对象
+     */
+    setState_HoleOffsetX(holeOffsetX: number): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：孔偏移 Y
+     *
+     * @beta
+     * @remarks 如若孔不存在，则属性将不会被修改
+     * @param holeOffsetY - 孔偏移 Y
+     * @returns 焊盘图元对象
+     */
+    setState_HoleOffsetY(holeOffsetY: number): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：孔相对于焊盘的旋转角度
+     *
+     * @beta
+     * @remarks 如若孔不存在，则属性将不会被修改
+     * @param holeRotation - 孔相对于焊盘的旋转角度
+     * @returns 焊盘图元对象
+     */
+    setState_HoleRotation(holeRotation: number): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：是否金属化孔壁
+     *
+     * @beta
+     * @remarks 如若孔不存在，则属性将不会被修改
+     * @param metallization - 是否金属化孔壁
+     * @returns 焊盘图元对象
+     */
+    setState_Metallization(metallization: boolean): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：焊盘功能
+     *
+     * @beta
+     * @param padFunction - 焊盘功能
+     * @returns 焊盘图元对象
+     */
+    setState_PadFunction(padFunction: EPCB_PrimitivePadFunction): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：特殊焊盘外形
+     *
+     * @beta
+     * @remarks
+     * 设置特殊焊盘外形时将会联动设置部分其它属性状态：
+     *
+     * 1. 焊盘外形属性将被清空
+     *
+     * @param pad - 特殊焊盘外形
+     * @returns 焊盘图元对象
+     */
+    setState_SpecialPad(specialPad: TPCB_PrimitiveSpecialPadShape): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：阻焊/助焊扩展
+     *
+     * @beta
+     * @param solderMaskAndPasteMaskExpansion - 阻焊/助焊扩展
+     * @returns 焊盘图元对象
+     */
+    setState_SolderMaskAndPasteMaskExpansion(solderMaskAndPasteMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：热焊优化参数
+     *
+     * @beta
+     * @param heatWelding - 热焊优化参数
+     * @returns 焊盘图元对象
+     */
+    setState_HeatWelding(heatWelding: IPCB_PrimitivePadHeatWelding | null): IPCB_PrimitivePad;
+    /**
+     * 设置属性状态：是否锁定
+     *
+     * @beta
+     * @param primitiveLock - 是否锁定
+     * @returns 焊盘图元对象
+     */
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitivePad;
+    /**
+     * 将图元转换为异步图元
+     *
+     * @public
+     * @returns 焊盘图元对象
+     */
+    toAsync(): IPCB_PrimitivePad;
+    /**
+     * 将图元转换为同步图元
+     *
+     * @public
+     * @returns 焊盘图元对象
+     */
+    toSync(): IPCB_PrimitivePad;
+    /**
+     * 查询图元是否为异步图元
+     *
+     * @public
+     * @returns 是否为异步图元
+     */
+    isAsync(): boolean;
+    /**
+     * 将异步图元重置为当前画布状态
+     *
+     * @beta
+     * @returns 焊盘图元对象
+     */
+    reset(): Promise<IPCB_PrimitivePad>;
+    /**
+     * 将对图元的更改应用到画布
+     *
+     * @beta
+     * @returns 尺寸标注图元对象
+     */
+    done(): Promise<IPCB_PrimitivePad>;
+}
+
+/**
+ * 焊盘热焊优化参数
+ *
+ * @public
+ * @remarks
+ * 当连接方式（{@link IPCB_PrimitivePadHeatWelding.connectionMethod | connectionMethod}）为直连（{@link EPCB_PrimitivePadHeatWeldingConnectionMethod.DIRECT_CONNECTED | DIRECT_CONNECTED}）、无连接（{@link EPCB_PrimitivePadHeatWeldingConnectionMethod.NON_CONNECTED | NON_CONNECTED}）时，发散间距、发散线宽、发散角度的设置将被忽略
+ */
+declare interface IPCB_PrimitivePadHeatWelding {
+    /** 连接方式 */
+    connectionMethod: EPCB_PrimitivePadHeatWeldingConnectionMethod;
+    /** 发散间距 */
+    divergenceSpacing?: number;
+    /** 发散线宽 */
+    divergenceLineWidth?: number;
+    /** 发散角度 */
+    divergenceAngle?: number;
+}
+
+/**
+ * 折线图元
+ *
+ * @public
+ */
+declare class IPCB_PrimitivePolyline implements IPCB_Primitive {
+    /** 异步 */
+    private async;
+    /** 图元类型 */
+    private readonly primitiveType;
+    /** 图元 ID */
+    private primitiveId?;
+    /** 网络名称 */
+    private net;
+    /** 层 */
+    private layer;
+    /** 单多边形 */
+    private polygon;
+    /** 线宽 */
+    private lineWidth;
+    /** 是否锁定 */
+    private primitiveLock;
+    /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
+    /**
+     * 获取属性状态：图元类型
+     *
+     * @public
+     * @returns 图元类型
+     */
+    getState_PrimitiveType(): EPCB_PrimitiveType;
+    /**
+     * 获取属性状态：图元 ID
      *
      * @public
-     * @returns 图像图元对象
+     * @returns 图元 ID
      */
-    toAsync(): IPCB_PrimitiveImage;
+    getState_PrimitiveId(): string;
     /**
-     * 将图元转换为同步图元
+     * 获取属性状态：网络名称
      *
      * @public
-     * @returns 图像图元对象
+     * @returns 网络名称
      */
-    toSync(): IPCB_PrimitiveImage;
+    getState_Net(): string;
     /**
-     * 查询图元是否为异步图元
+     * 获取属性状态：层
      *
      * @public
-     * @returns 是否为异步图元
+     * @returns 层
      */
-    isAsync(): boolean;
+    getState_Layer(): TPCB_LayersOfLine;
     /**
-     * 将异步图元重置为当前画布状态
+     * 获取属性状态：单多边形
+     *
+     * @public
+     * @returns 单多边形
+     */
+    getState_Polygon(): IPCB_Polygon;
+    /**
+     * 获取属性状态：线宽
+     *
+     * @public
+     * @returns 线宽
+     */
+    getState_LineWidth(): number;
+    /**
+     * 获取属性状态：是否锁定
+     *
+     * @public
+     * @returns 是否锁定
+     */
+    getState_PrimitiveLock(): boolean;
+    /**
+     * 设置属性状态：网络名称
      *
      * @beta
-     * @returns 图像图元对象
+     * @param net - 网络名称
+     * @returns 折线图元对象
      */
-    reset(): Promise<IPCB_PrimitiveImage>;
+    setState_Net(net: string): IPCB_PrimitivePolyline;
     /**
-     * 将对图元的更改应用到画布
+     * 设置属性状态：层
      *
      * @beta
-     * @returns 图像图元对象
+     * @param layer - 层
+     * @returns 折线图元对象
      */
-    done(): Promise<IPCB_PrimitiveImage>;
+    setState_Layer(layer: TPCB_LayersOfLine): IPCB_PrimitivePolyline;
     /**
-     * 设置属性状态：图像源数据
+     * 设置属性���态：单多边形
      *
      * @beta
-     * @param complexPolygon - 图像源数据
-     * @returns 图像图元对象
+     * @param polygon - 单多边形
+     * @returns 折线图元对象
      */
-    private setState_ComplexPolygon;
-}
-
-/**
- * 导线图元
- *
- * @public
- */
-declare class IPCB_PrimitiveLine implements IPCB_Primitive {
-    /** 异步 */
-    private async;
-    /** 图元类型 */
-    private readonly primitiveType;
-    /** 图元 ID */
-    private primitiveId?;
-    /** 网络名称 */
-    private net;
-    /** 层 */
-    private layer;
-    /** 起始位置 X */
-    private startX;
-    /** 起始位置 Y */
-    private startY;
-    /** 终止位置 X */
-    private endX;
-    /** 终止位置 Y */
-    private endY;
-    /** 线宽 */
-    private lineWidth;
-    /** 是否锁定 */
-    private primitiveLock;
-    /* Excluded from this release type: __constructor */
+    setState_Polygon(polygon: IPCB_Polygon): IPCB_PrimitivePolyline;
     /**
-     * 在 PCB 画布中创建图元
+     * 设置属性状态：线宽
      *
      * @beta
-     * @returns 导线图元对象
+     * @param lineWidth - 线宽
+     * @returns 折线图元对象
      */
-    create(): Promise<IPCB_PrimitiveLine>;
+    setState_LineWidth(lineWidth: number): IPCB_PrimitivePolyline;
     /**
-     * 获取对象的图元 ID
+     * 设置属性状态：是否锁定
      *
-     * @returns
+     * @beta
+     * @param primitiveLock - 是否锁定
+     * @returns 折线图元对象
      */
-    getState_PrimitiveId(): string;
-    /* Excluded from this release type: setState_Net */
-    /* Excluded from this release type: setState_Layer */
-    /* Excluded from this release type: setState_StartX */
-    /* Excluded from this release type: setState_StartY */
-    /* Excluded from this release type: setState_EndX */
-    /* Excluded from this release type: setState_EndY */
-    /* Excluded from this release type: setState_LineWidth */
-    /* Excluded from this release type: setState_PrimitiveLock */
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitivePolyline;
     /**
      * 将图元转换为异步图元
+     *
+     * @public
+     * @returns 折线图元对象
      */
-    toAsync(): IPCB_PrimitiveLine;
+    toAsync(): IPCB_PrimitivePolyline;
     /**
      * 将图元转换为同步图元
+     *
+     * @public
+     * @returns 折线图元对象
      */
-    toSync(): IPCB_PrimitiveLine;
+    toSync(): IPCB_PrimitivePolyline;
     /**
      * 查询图元是否为异步图元
+     *
+     * @public
+     * @returns 是否为异步图元
      */
     isAsync(): boolean;
     /**
      * 将异步图元重置为当前画布状态
      *
      * @beta
+     * @returns 折线图元对象
      */
-    reset(): Promise<IPCB_PrimitiveLine>;
+    reset(): Promise<IPCB_PrimitivePolyline>;
     /**
      * 将对图元的更改应用到画布
      *
      * @beta
+     * @returns 折线图元对象
      */
-    done(): Promise<IPCB_PrimitiveLine>;
+    done(): Promise<IPCB_PrimitivePolyline>;
+    /* Excluded from this release type: convertToFill */
+    /* Excluded from this release type: convertToPour */
+    /* Excluded from this release type: convertToRegion */
 }
 
 /**
- * 焊盘图元
+ * 覆铜边框图元
  *
  * @public
  */
-declare class IPCB_PrimitivePad implements IPCB_Primitive {
+declare class IPCB_PrimitivePour implements IPCB_Primitive {
     /** 异步 */
     private async;
     /** 图元类型 */
     private readonly primitiveType;
     /** 图元 ID */
     private primitiveId?;
+    /** 网络名称 */
+    private net;
     /** 层 */
     private layer;
-    /** 焊盘编号 */
-    private padNumber;
-    /** 位置 X */
-    private x;
-    /** 位置 Y */
-    private y;
-    /** 旋转角度 */
-    private rotation;
-    /** 焊盘外形 */
-    private pad?;
-    /** 网络名称 */
-    private net?;
-    /** 孔 */
-    private hole;
-    /** 孔偏移 X */
-    private holeOffsetX;
-    /** 孔偏移 Y */
-    private holeOffsetY;
-    /** 孔相对于焊盘的旋转角度 */
-    private holeRotation;
-    /** 是否金属化孔壁 */
-    private metallization;
-    /** 焊盘功能 */
-    private padFunction;
-    /** 特殊焊盘外形 */
-    private specialPad?;
-    /** 阻焊/助焊扩展 */
-    private solderMaskAndPasteMaskExpansion;
-    /** 热焊优化参数 */
-    private heatWelding;
+    /** 复杂多边形 */
+    private complexPolygon;
+    /** 覆铜填充方法 */
+    private pourFillMethod;
+    /** 是否保留孤岛 */
+    private preserveSilos;
+    /** 覆铜边框名称 */
+    private pourName?;
+    /** 覆铜优先级 */
+    private pourPriority?;
+    /** 线宽 */
+    private lineWidth?;
     /** 是否锁定 */
     private primitiveLock;
     /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
     /**
-     * 在 PCB 画布中创建图元
+     * 获取属性状态：图元类型
      *
-     * @beta
-     * @returns 焊盘图元对象
+     * @public
+     * @returns 图元类型
      */
-    create(): Promise<IPCB_PrimitivePad>;
+    getState_PrimitiveType(): EPCB_PrimitiveType;
     /**
-     * 获取对象的图元 ID
+     * 获取属性状态：图元 ID
      *
-     * @returns
+     * @public
+     * @returns 图元 ID
      */
     getState_PrimitiveId(): string;
-    /** @alpha 定义 getState_* 函数 × 19 */
-    /** @alpha 所有的 setState_* 方法都需要对数据进行基本的格式校验 */
+    /**
+     * 获取属性状态：网络名称
+     *
+     * @public
+     * @returns 网络名称
+     */
+    getState_Net(): string;
+    /**
+     * 获取属性状态：层
+     *
+     * @public
+     * @returns 层
+     */
+    getState_Layer(): TPCB_LayersOfCopper;
+    /**
+     * 获取属性状态：复杂多边形
+     *
+     * @public
+     * @returns 复杂多边形
+     */
+    getState_ComplexPolygon(): IPCB_ComplexPolygon;
+    /**
+     * 获取属性状态：覆铜填充方法
+     *
+     * @public
+     * @returns 覆铜填充方法
+     */
+    getState_PourFillMethod(): any;
+    /**
+     * 获取属性状态：是否保留孤岛
+     *
+     * @public
+     * @returns 是否保留孤岛
+     */
+    getState_PreserveSilos(): boolean;
+    /**
+     * 获取属性状态：覆铜边框名称
+     *
+     * @public
+     * @returns 覆铜边框名称
+     */
+    getState_PourName(): string;
+    /**
+     * 获取属性状态：覆铜优先级
+     *
+     * @public
+     * @returns 覆铜优先级
+     */
+    getState_PourPriority(): number;
+    /**
+     * 获取属性状态：线宽
+     *
+     * @public
+     * @returns 线宽
+     */
+    getState_LineWidth(): number;
+    /**
+     * 获取属性状态：是否锁定
+     *
+     * @public
+     * @returns 是否锁定
+     */
+    getState_PrimitiveLock(): boolean;
+    /**
+     * 设置属性状态：网络名称
+     *
+     * @beta
+     * @param net - 网络名称
+     * @returns 覆铜边框图元对象
+     */
+    setState_Net(net: string): IPCB_PrimitivePour;
     /**
      * 设置属性状态：层
      *
      * @beta
-     * @remarks
-     * 设置层时将会联动设置部分其它属性状态：
+     * @param layer - 层
+     * @returns 覆铜边框图元对象
+     */
+    setState_Layer(layer: TPCB_LayersOfCopper): IPCB_PrimitivePour;
+    /**
+     * 设置属性状态：复杂多边形
      *
-     * 1. 顶层与底层切换时：阻焊/助焊扩展属性将会跟随切换，数据值不变
+     * @beta
+     * @param complexPolygon - 复杂多边形
+     * @returns 覆铜边框图元对象
+     */
+    setState_ComplexPolygon(complexPolygon: IPCB_ComplexPolygon): IPCB_PrimitivePour;
+    /**
+     * 设置属性状态：覆铜填充方法
      *
-     * 2. 多层切换到单层时：判断切换到顶层还是底层，阻焊/助焊扩展属性将只保留指定层对应的数据；如若存在特殊焊盘，将转换为普通焊盘属性，并且只保留指定层对应的数据；与孔有关的属性将被重置到默认值
+     * @beta
+     * @param pourFillMethod - 覆铜填充方法
+     * @returns 覆铜边框图元对象
+     */
+    setState_PourFillMethod(pourFillMethod: any): IPCB_PrimitivePour;
+    /**
+     * 设置属性状态：是否保留孤岛
      *
-     * 3. 单层切换到多层时：阻焊/助焊扩展属性将只保留阻焊扩展，并复制原数据应用于顶层和底层；焊盘钻孔属性将被赋指定值，长宽均为焊盘直径（焊盘为长圆形或正多边形）、宽（焊盘为矩形）的 60% 的长圆形（数据层面上是长圆形，实则是正圆形），如若焊盘为折线复杂多边形，则通过专用算法计算得出数据（通常比较抽象，建议后期修改）
+     * @beta
+     * @param preserveSilos - 是否保留孤岛
+     * @returns 覆铜边框图元对象
+     */
+    setState_PreserveSilos(preserveSilos: boolean): IPCB_PrimitivePour;
+    /**
+     * 设置属性状态：覆铜边框名称
      *
-     * @param layer - 层
-     * @returns 焊盘图元对象
+     * @beta
+     * @param pourName - 覆铜边框名称
+     * @returns 覆铜边框图元对象
      */
-    setState_Layer(layer: TPCB_LayersOfPad): IPCB_PrimitivePad;
+    setState_PourName(pourName: string): IPCB_PrimitivePour;
     /**
-     * 设置属性状态：焊盘编号
+     * 设置属性状态：覆铜优先级
      *
      * @beta
-     * @param padNumber - 焊盘编号
-     * @returns 焊盘图元对象
+     * @param pourPriority - 覆铜优先级
+     * @returns 覆铜边框图元对象
      */
-    setState_PadNumber(padNumber: string): IPCB_PrimitivePad;
+    setState_PourPriority(pourPriority: number): IPCB_PrimitivePour;
     /**
-     * 设置属性状态：位置 X
+     * 设置属性状态：线宽
      *
      * @beta
-     * @param x - 位置 X
-     * @returns 焊盘图元对象
+     * @param lineWidth - 线宽
+     * @returns 覆铜边框图元对象
      */
-    setState_X(x: number): IPCB_PrimitivePad;
+    setState_LineWidth(lineWidth: number): IPCB_PrimitivePour;
+    /**
+     * 设置属性状态：是否锁定
+     *
+     * @beta
+     * @param primitiveLock - 是否锁定
+     * @returns 覆铜边框图元对象
+     */
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitivePour;
+    /**
+     * 将图元转换为异步图元
+     *
+     * @public
+     * @returns 覆铜边框图元对象
+     */
+    toAsync(): IPCB_PrimitivePour;
+    /**
+     * 将图元转换为同步图元
+     *
+     * @public
+     * @returns 覆铜边框图元对象
+     */
+    toSync(): IPCB_PrimitivePour;
+    /**
+     * 查询图元是否为异步图元
+     *
+     * @public
+     * @returns 是否为异步图元
+     */
+    isAsync(): boolean;
+    /* Excluded from this release type: reset */
+    /* Excluded from this release type: done */
+    /* Excluded from this release type: convertToFill */
+    /* Excluded from this release type: convertToPolyline */
+    /* Excluded from this release type: convertToRegion */
+}
+
+/**
+ * 区域图元
+ *
+ * @public
+ */
+declare class IPCB_PrimitiveRegion implements IPCB_Primitive {
+    /** 异步 */
+    private async;
+    /** 图元类型 */
+    private readonly primitiveType;
+    /** 图元 ID */
+    private primitiveId?;
+    /** 层 */
+    private layer;
+    /** 复杂多边形 */
+    private complexPolygon;
+    /** 区域规则类型 */
+    private ruleType;
+    /** 区域名称 */
+    private regionName?;
+    /** 线宽 */
+    private lineWidth?;
+    /** 是否锁定 */
+    private primitiveLock;
+    /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
     /**
-     * 设置属性状态：位置 Y
+     * 获取属性状态：图元类型
      *
-     * @beta
-     * @param y - 位置 Y
-     * @returns 焊盘图元对象
+     * @public
+     * @returns 图元类型
      */
-    setState_Y(y: number): IPCB_PrimitivePad;
+    getState_PrimitiveType(): EPCB_PrimitiveType;
     /**
-     * 设置属性状态：旋转角度
+     * 获取属性状态：图元 ID
      *
-     * @beta
-     * @param rotation - 旋转角度
-     * @returns 焊盘图元对象
+     * @public
+     * @returns 图元 ID
      */
-    setState_Rotation(rotation: number): IPCB_PrimitivePad;
+    getState_PrimitiveId(): string;
     /**
-     * 设置属性状态：焊盘外形
+     * 获取属性状态：层
      *
-     * @beta
-     * @remarks
-     * 设置焊盘外形时将会联动设置部分其它属性状态：
-     *
-     * 1. 特殊焊盘外形属性将被清空
-     *
-     * @param pad - 焊盘外形
-     * @returns 焊盘图元对象
+     * @public
+     * @returns 层
      */
-    setState_Pad(pad: TPCB_PrimitivePadShape): IPCB_PrimitivePad;
+    getState_Layer(): TPCB_LayersOfRegion;
     /**
-     * 设置属性状态：网络
+     * 获取属性状态：复杂多边形
      *
-     * @beta
-     * @remarks 本接口仅在 PCB 编辑器可用，空字符串与 `undefined` 均被视为空网络
-     * @param net - 网络名称
-     * @returns 焊盘图元对象
+     * @public
+     * @returns 复杂多边形
      */
-    setState_Net(net?: string): IPCB_PrimitivePad;
+    getState_ComplexPolygon(): IPCB_ComplexPolygon;
     /**
-     * 设置属性状态：孔
-     *
-     * @beta
-     * @remarks
-     * 设置孔时将会联动设置部分其它属性状态：
-     *
-     * 1. 层将会强制切换到多层
+     * 获取属性状态：区域规则类型
      *
-     * 本接口无法将孔设置为 `null`，如果想要移除孔属性，请使用 {@link IPCB_PrimitivePad.setState_Layer | setState_Layer} 方法切换层为顶层或底层
-     *
-     * @param hole - 焊盘钻孔
-     * @returns 焊盘图元对象
+     * @public
+     * @returns 区域规则类型
      */
-    setState_Hole(hole: TPCB_PrimitivePadHole): IPCB_PrimitivePad;
+    getState_RuleType(): Array<EPCB_PrimitiveRegionRuleType>;
     /**
-     * 设置属性状态：孔偏移 X
+     * 获取属性状态：区域名称
      *
-     * @beta
-     * @remarks 如若孔不存在，则属性将不会被修改
-     * @param holeOffsetX - 孔偏移 X
-     * @returns 焊盘图元对象
+     * @public
+     * @returns 区域名称
      */
-    setState_HoleOffsetX(holeOffsetX: number): IPCB_PrimitivePad;
+    getState_RegionName(): string | undefined;
     /**
-     * 设置属性状态：孔偏移 Y
+     * 获取属性状态：线宽
      *
-     * @beta
-     * @remarks 如若孔不存在，则属性将不会被修改
-     * @param holeOffsetY - 孔偏移 Y
-     * @returns 焊盘图元对象
+     * @public
+     * @returns 线宽
      */
-    setState_HoleOffsetY(holeOffsetY: number): IPCB_PrimitivePad;
+    getState_LineWidth(): number;
     /**
-     * 设置属性状态：孔相对于焊盘的旋转角度
+     * 获取属性状态：是否锁定
      *
-     * @beta
-     * @remarks 如若孔不存在，则属性将不会被修改
-     * @param holeRotation - 孔相对于焊盘的旋转角度
-     * @returns 焊盘图元对象
+     * @public
+     * @returns 是否锁定
      */
-    setState_HoleRotation(holeRotation: number): IPCB_PrimitivePad;
+    getState_PrimitiveLock(): boolean;
     /**
-     * 设置属性状态：是否金属化孔壁
+     * 设置属性状态：层
      *
      * @beta
-     * @remarks 如若孔不存在，则属性将不会被修改
-     * @param metallization - 是否金属化孔壁
-     * @returns 焊盘图元对象
+     * @param layer - 层
+     * @returns 区域图元对象
      */
-    setState_Metallization(metallization: boolean): IPCB_PrimitivePad;
+    setState_Layer(layer: TPCB_LayersOfRegion): IPCB_PrimitiveRegion;
     /**
-     * 设置属性状态：焊盘功能
+     * 设置属性状态：复杂多边形
      *
      * @beta
-     * @param padFunction - 焊盘功能
-     * @returns 焊盘图元对象
+     * @param complexPolygon - 复杂多边形
+     * @returns 区域图元对象
      */
-    setState_PadFunction(padFunction: EPCB_PrimitivePadFunction): IPCB_PrimitivePad;
+    setState_ComplexPolygon(complexPolygon: IPCB_ComplexPolygon): IPCB_PrimitiveRegion;
     /**
-     * 设置属性状态：特殊焊盘外形
+     * 设置属性状态：区域规则类型
      *
      * @beta
-     * @remarks
-     * 设置特殊焊盘外形时将会联动设置部分其它属性状态：
-     *
-     * 1. 焊盘外形属性将被清空
-     *
-     * @param pad - 特殊焊盘外形
-     * @returns 焊盘图元对象
+     * @param ruleType - 区域规则类型
+     * @returns 区域图元对象
      */
-    setState_SpecialPad(specialPad: TPCB_PrimitiveSpecialPadShape): IPCB_PrimitivePad;
+    setState_RuleType(ruleType: Array<EPCB_PrimitiveRegionRuleType>): IPCB_PrimitiveRegion;
     /**
-     * 设置属性状态：阻焊/助焊扩展
+     * 设置属性状态：区域名称
      *
      * @beta
-     * @param solderMaskAndPasteMaskExpansion - 阻焊/助焊扩展
-     * @returns 焊盘图元对象
+     * @remarks
+     * 仅当 `ruleType` 为 {@link EPCB_PrimitiveRegionRuleType.FOLLOW_REGION_RULE} 时有效，用于匹配区域 DRC 规则
+     *
+     * 如若 `ruleType` 为 {@link EPCB_PrimitiveRegionRuleType.FOLLOW_REGION_RULE} 但 `regionName` 为空，则系统将会自动分配名称
+     * @param regionName - 区域名称
+     * @returns 区域图元对象
      */
-    setState_SolderMaskAndPasteMaskExpansion(solderMaskAndPasteMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null): IPCB_PrimitivePad;
+    setState_RegionName(regionName?: string): IPCB_PrimitiveRegion;
     /**
-     * 设置属性状态：热焊优化参数
+     * 设置属性状态：线宽
      *
      * @beta
-     * @param heatWelding - 热焊优化参数
-     * @returns 焊盘图元对象
+     * @param lineWidth - 线宽
+     * @returns 区域图元对象
      */
-    setState_HeatWelding(heatWelding: IPCB_PrimitivePadHeatWelding | null): IPCB_PrimitivePad;
+    setState_LineWidth(lineWidth: number): IPCB_PrimitiveRegion;
     /**
      * 设置属性状态：是否锁定
      *
      * @beta
      * @param primitiveLock - 是否锁定
-     * @returns 焊盘图元对象
+     * @returns 区域图元对象
      */
-    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitivePad;
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveRegion;
     /**
      * 将图元转换为异步图元
      *
      * @public
-     * @returns 焊盘图元对象
+     * @returns 区域图元对象
      */
-    toAsync(): IPCB_PrimitivePad;
+    toAsync(): IPCB_PrimitiveRegion;
     /**
      * 将图元转换为同步图元
      *
      * @public
-     * @returns 焊盘图元对象
+     * @returns 区域图元对象
      */
-    toSync(): IPCB_PrimitivePad;
+    toSync(): IPCB_PrimitiveRegion;
     /**
      * 查询图元是否为异步图元
      *
@@ -3156,46 +4431,45 @@ declare class IPCB_PrimitivePad implements IPCB_Primitive {
      * @returns 是否为异步图元
      */
     isAsync(): boolean;
-    /**
-     * 将异步图元重置为当前画布状态
-     *
-     * @beta
-     * @returns 焊盘图元对象
-     */
-    reset(): Promise<IPCB_PrimitivePad>;
-    /**
-     * 将对图元的更改应用到画布
-     *
-     * @beta
-     * @returns 尺寸标注图元对象
-     */
-    done(): Promise<IPCB_PrimitivePad>;
+    /* Excluded from this release type: reset */
+    /* Excluded from this release type: done */
+    /* Excluded from this release type: convertToFill */
+    /* Excluded from this release type: convertToPolyline */
+    /* Excluded from this release type: convertToPour */
 }
 
 /**
- * 焊盘热焊优化参数
+ * 阻焊/助焊扩展
  *
  * @public
  * @remarks
- * 当连接方式（{@link IPCB_PrimitivePadHeatWelding.connectionMethod | connectionMethod}）为直连（{@link EPCB_PrimitivePadHeatWeldingConnectionMethod.DIRECT_CONNECTED | DIRECT_CONNECTED}）、无连接（{@link EPCB_PrimitivePadHeatWeldingConnectionMethod.NON_CONNECTED | NON_CONNECTED}）时，发散间距、发散线宽、发散角度的设置将被忽略
+ * 本参数设置包含以下三类情况：
+ *
+ * 1. 当图元为顶层/底层贴片焊盘时，允许设置对应层的阻焊/助焊扩展，其余设置不生效
+ *
+ * 2. 当图元为通孔焊盘时，允许设置顶层/底层的阻焊扩展，助焊扩展的设置不生效
+ *
+ * 3. 当图元为过孔时，允许设置顶层/底层的阻焊扩展，助焊扩展的设置不生效，如若为盲孔，则视其暴露层生效其阻焊扩展设置
+ *
+ * 助焊扩展在一般情况下仅用于钢网生产等特定用途，不了解其作用请安心地忽略其参数设置
  */
-declare interface IPCB_PrimitivePadHeatWelding {
-    /** 连接方式 */
-    connectionMethod: EPCB_PrimitivePadHeatWeldingConnectionMethod;
-    /** 发散间距 */
-    divergenceSpacing?: number;
-    /** 发散线宽 */
-    divergenceLineWidth?: number;
-    /** 发散角度 */
-    divergenceAngle?: number;
+declare interface IPCB_PrimitiveSolderMaskAndPasteMaskExpansion {
+    /** 顶层阻焊扩展 */
+    topSolderMask?: number;
+    /** 底层阻焊扩展 */
+    bottomSolderMask?: number;
+    /** 顶层助焊扩展 */
+    topPasteMask?: number;
+    /** 底层助焊扩展 */
+    bottomPasteMask?: number;
 }
 
 /**
- * 折线图元
+ * 过孔图元
  *
  * @public
  */
-declare class IPCB_PrimitivePolyline implements IPCB_Primitive {
+declare class IPCB_PrimitiveVia implements IPCB_Primitive {
     /** 异步 */
     private async;
     /** 图元类型 */
@@ -3204,160 +4478,206 @@ declare class IPCB_PrimitivePolyline implements IPCB_Primitive {
     private primitiveId?;
     /** 网络名称 */
     private net;
-    /** 层 */
-    private layer;
-    /** 单多边形 */
-    private polygon;
-    /** 线宽 */
-    private lineWidth;
+    /** 坐标 X */
+    private x;
+    /** 坐标 Y */
+    private y;
+    /** 孔径 */
+    private holeDiameter;
+    /** 外径 */
+    private diameter;
+    /** 过孔类型 */
+    private viaType;
+    /** 盲埋孔设计规则项名称 */
+    private designRuleBlindViaName;
+    /** 阻焊/助焊扩展 */
+    private solderMaskExpansion;
     /** 是否锁定 */
     private primitiveLock;
     /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
     /**
-     * 在 PCB 画布中创建图元
+     * 获取属性状态：图元类型
      *
-     * @beta
-     * @returns 折线图元对象
+     * @public
+     * @returns 图元类型
      */
-    create(): Promise<IPCB_PrimitivePolyline>;
+    getState_PrimitiveType(): EPCB_PrimitiveType;
     /**
-     * 获取对象的图元 ID
+     * 获取属性状态：图元 ID
      *
-     * @returns
+     * @public
+     * @returns 图元 ID
      */
     getState_PrimitiveId(): string;
-    /* Excluded from this release type: setState_Net */
-    /* Excluded from this release type: setState_Layer */
-    /* Excluded from this release type: setState_Polygon */
-    /* Excluded from this release type: setState_LineWidth */
-    /* Excluded from this release type: setState_PrimitiveLock */
     /**
-     * 将图元转换为异步图元
+     * 获取属性状态：网络名称
+     *
+     * @public
+     * @returns 网络名称
      */
-    toAsync(): IPCB_PrimitivePolyline;
+    getState_Net(): string;
     /**
-     * 将图元转换为同步图元
+     * 获取属性状态：坐标 X
+     *
+     * @public
+     * @returns 坐标 X
      */
-    toSync(): IPCB_PrimitivePolyline;
+    getState_X(): number;
     /**
-     * 查询图元是否为异步图元
+     * 获取属性状态：坐标 Y
+     *
+     * @public
+     * @returns 坐标 Y
      */
-    isAsync(): boolean;
+    getState_Y(): number;
     /**
-     * 将异步图元重置为当前画布状态
+     * 获取属性状态：孔径
+     *
+     * @public
+     * @returns 孔径
+     */
+    getState_HoleDiameter(): number;
+    /**
+     * 获取属性状态：外径
+     *
+     * @public
+     * @returns 外径
+     */
+    getState_Diameter(): number;
+    /**
+     * 获取属性状态：过孔类型
+     *
+     * @public
+     * @returns 过孔类型
+     */
+    getState_ViaType(): EPCB_PrimitiveViaType;
+    /**
+     * 获取属性状态：盲埋孔设计规则项名称
+     *
+     * @public
+     * @returns 盲埋孔设计规则项名称
+     */
+    getState_DesignRuleBlindViaName(): string | null;
+    /**
+     * 获取属性状态：阻焊/助焊扩展
+     *
+     * @public
+     * @returns 阻焊/助焊扩展
+     */
+    getState_SolderMaskExpansion(): IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null;
+    /**
+     * 获取属性状态：是否锁定
+     *
+     * @public
+     * @returns 是否锁定
+     */
+    getState_PrimitiveLock(): boolean;
+    /**
+     * 设置属性状态：网络名称
+     *
+     * @beta
+     * @param net - 网络名称
+     * @returns 过孔图元对象
+     */
+    setState_Net(net: string): IPCB_PrimitiveVia;
+    /**
+     * 设置属性状态：坐标 X
      *
      * @beta
+     * @param x - 坐标 X
+     * @returns 过孔图元对象
      */
-    reset(): Promise<IPCB_PrimitivePolyline>;
+    setState_X(x: number): IPCB_PrimitiveVia;
     /**
-     * 将对图元的更改应用到画布
+     * 设置属性状态：坐标 Y
+     *
+     * @beta
+     * @param y - 坐标 Y
+     * @returns 过孔图元对象
+     */
+    setState_Y(y: number): IPCB_PrimitiveVia;
+    /**
+     * 设置属性状态：孔径
+     *
+     * @beta
+     * @param holeDiameter - 孔径
+     * @returns 过孔图元对象
+     */
+    setState_HoleDiameter(holeDiameter: number): IPCB_PrimitiveVia;
+    /**
+     * 设置属性状态：外径
+     *
+     * @beta
+     * @param diameter - 外径
+     * @returns 过孔图元对象
+     */
+    setState_Diameter(diameter: number): IPCB_PrimitiveVia;
+    /**
+     * 设置属性状态：过孔类型
+     *
+     * @beta
+     * @param viaType - 过孔类型
+     * @returns 过孔图元对象
+     */
+    setState_ViaType(viaType: EPCB_PrimitiveViaType): IPCB_PrimitiveVia;
+    /**
+     * 设置属性状态：盲埋孔设计规则项名称
      *
      * @beta
+     * @param designRuleBlindViaName - 盲埋孔设计规则项名称
+     * @returns 过孔图元对象
      */
-    done(): Promise<IPCB_PrimitivePolyline>;
-}
-
-/**
- * 阻焊/助焊扩展
- *
- * @public
- * @remarks
- * 本参数设置包含以下三类情况：
- *
- * 1. 当图元为顶层/底层贴片焊盘时，允许设置对应层的阻焊/助焊扩展，其余设置不生效
- *
- * 2. 当图元为通孔焊盘时，允许设置顶层/底层的阻焊扩展，助焊扩展的设置不生效
- *
- * 3. 当图元为过孔时，允许设置顶层/底层的阻焊扩展，助焊扩展的设置不生效，如若为盲孔，则视其暴露层生效其阻焊扩展设置
- *
- * 助焊扩展在一般情况下仅用于钢网生产等特定用途，不了解其作用请安心地忽略其参数设置
- */
-declare interface IPCB_PrimitiveSolderMaskAndPasteMaskExpansion {
-    /** 顶层阻焊扩展 */
-    topSolderMask?: number;
-    /** 底层阻焊扩展 */
-    bottomSolderMask?: number;
-    /** 顶层助焊扩展 */
-    topPasteMask?: number;
-    /** 底层助焊扩展 */
-    bottomPasteMask?: number;
-}
-
-/**
- * 过孔图元
- *
- * @public
- */
-declare class IPCB_PrimitiveVia implements IPCB_Primitive {
-    /** 异步 */
-    private async;
-    /** 图元类型 */
-    private readonly primitiveType;
-    /** 图元 ID */
-    private primitiveId?;
-    /** 网络名称 */
-    private net;
-    /** 坐标 X */
-    private x;
-    /** 坐标 Y */
-    private y;
-    /** 孔径 */
-    private holeDiameter;
-    /** 外径 */
-    private diameter;
-    /** 过孔类型 */
-    private viaType;
-    /** 盲埋孔设计规则项名称 */
-    private designRuleBlindViaName;
-    /** 阻焊/助焊扩展 */
-    private solderMaskExpansion;
-    /** 是否锁定 */
-    private primitiveLock;
-    /* Excluded from this release type: __constructor */
+    setState_DesignRuleBlindViaName(designRuleBlindViaName: string | null): IPCB_PrimitiveVia;
     /**
-     * 在 PCB 画布中创建图元
+     * 设置属性状态：阻焊/助焊扩展
      *
      * @beta
+     * @param solderMaskExpansion - 阻焊/助焊扩展
      * @returns 过孔图元对象
      */
-    create(): Promise<IPCB_PrimitiveVia>;
+    setState_SolderMaskExpansion(solderMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null): IPCB_PrimitiveVia;
     /**
-     * 获取对象的图元 ID
+     * 设置属性状态：是否锁定
      *
-     * @returns
+     * @beta
+     * @param primitiveLock - 是否锁定
+     * @returns 过孔图元对象
      */
-    getState_PrimitiveId(): string;
-    /* Excluded from this release type: setState_Net */
-    /* Excluded from this release type: setState_X */
-    /* Excluded from this release type: setState_Y */
-    /* Excluded from this release type: setState_HoleDiameter */
-    /* Excluded from this release type: setState_Diameter */
-    /* Excluded from this release type: setState_ViaType */
-    /* Excluded from this release type: setState_DesignRuleBlindViaName */
-    /* Excluded from this release type: setState_SolderMaskExpansion */
-    /* Excluded from this release type: setState_PrimitiveLock */
+    setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveVia;
     /**
      * 将图元转换为异步图元
+     *
+     * @public
+     * @returns 过孔图元对象
      */
     toAsync(): IPCB_PrimitiveVia;
     /**
      * 将图元转换为同步图元
+     *
+     * @public
+     * @returns 过孔图元对象
      */
     toSync(): IPCB_PrimitiveVia;
     /**
      * 查询图元是否为异步图元
+     *
+     * @public
+     * @returns 是否为异步图元
      */
     isAsync(): boolean;
     /**
      * 将异步图元重置为当前画布状态
      *
      * @beta
+     * @returns 过孔图元对象
      */
     reset(): Promise<IPCB_PrimitiveVia>;
     /**
      * 将对图元的更改应用到画布
      *
      * @beta
+     * @returns 过孔图元对象
      */
     done(): Promise<IPCB_PrimitiveVia>;
 }
@@ -3693,7 +5013,7 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
     private uniqueId?;
     /** Component 属性：制造商 */
     private manufacturer?;
-    /** Component 属性���制造商编号 */
+    /** Component 属性：制造商编号 */
     private manufacturerId?;
     /** Component 属性：供应商 */
     private supplier?;
@@ -4232,7 +5552,7 @@ declare interface ISYS_MultilingualLanguagesData {
  * 窗口事件监听可移除对象
  *
  * @public
- * @remarks 本对象从 {@link addEventListener} 获取，并可用于移除创建的事件监听，仅需将其传入 {@link removeEventListener}
+ * @remarks 本对象从 {@link SYS_Window.addEventListener | addEventListener} 获取，并可用于移除创建的事件监听，仅需将其传入 {@link SYS_Window.removeEventListener | removeEventListener}
  */
 declare interface ISYS_WindowEventListenerRemovableObject {
     type: ESYS_WindowEventType;
@@ -4366,7 +5686,7 @@ declare class LIB_Cbb {
      */
     get(cbbUuid: string, libraryUuid?: string): Promise<ILIB_CbbItem | undefined>;
     /**
-     * 复制复用模块
+     * 复制复用���块
      *
      * @beta
      * @param cbbUuid - 复用模块 UUID
@@ -4946,6 +6266,15 @@ declare class PCB_Document {
      * @returns 导入操作是否成功，导入失败或游离 PCB 返回 `false`
      */
     importChanges(uuid: string): Promise<boolean>;
+    /**
+     * 导入旧版自动布线文件（JSON）
+     *
+     * @public
+     * @remarks 可以使用 {@link SYS_FileSystem.openReadFileDialog} 读入文件
+     * @param autoRouteFile - 欲导入的 JSON 文件
+     * @returns 导入操作是否成功
+     */
+    importOldAutoRouteJsonFile(autoRouteFile: File): Promise<boolean>;
     /**
      * 保存文档
      *
@@ -5727,9 +7056,41 @@ declare class PCB_ManufactureData {
      * @beta
      * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
      * @param fileName - 文件名
-     * @returns 自动布线文件数据
+     * @returns 自动布线 DSN 文件数据
      */
     getDsnFile(fileName?: string): Promise<File | undefined>;
+    /**
+     * 获取旧版自动布线文件（JSON）
+     *
+     * @alpha
+     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @deprecated 新版自动布线 JSON 文件正在开发中，之后将会取代本接口
+     * @param fileName - 文件名
+     * @param routeNet - 布线网络，`All` 所有网络、`SelectedNet` 所选网络、`SelectedComponentsNet` 所选器件的网络
+     * @param cablingCorner - 布线拐角，支持 `45` 度或 `90` 度
+     * @param existingWiresAndVias - 已有导线/过孔的处理方式，`Save` 保留、`Remove` 移除
+     * @param performancePriority - 效果优先级，`Quality` 质量（完成度优先）、`Fast` 快速（速度优先）
+     * @param netPriority - 网络优先级，
+     *
+     * `Default` 默认、`Random` 随机、`Custom net names are preferred` 有自定义网络名的网络优先、
+     *
+     * `Pads from more to less` 焊盘从多到少、`Pads from less to more` 焊盘从少到多、
+     *
+     * `Pads from far to near` 焊盘从远到近、`Pads from near to far` 焊盘从近到远
+     * @param routeLayers - 布线图层，`All` 所有层，你也可以在数组内列出所有需要布线的铜箔层
+     * @param ignoredNets - 忽略的网络，请在数组内列出所有忽略的网络的名称
+     * @returns 旧版自动布线 JSON 文件数据
+     */
+    /**
+     * 获取旧版自动布线文件（JSON）
+     *
+     * @public
+     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+     * @deprecated 新版自动布线 JSON 文件正在开发中，之后将会取代本接口
+     * @param fileName - 文件名
+     * @returns 旧版自动布线 JSON 文件数据
+     */
+    getOldAutoRouteJsonFile(fileName?: string): Promise<File | undefined>;
     /**
      * 获取 PCB 信息文件
      *
@@ -5913,16 +7274,7 @@ declare class PCB_PrimitiveArc implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveId - 图元 ID
-     * @param net - 网络名称
-     * @param layer - 层
-     * @param startX - 起始位置 X
-     * @param startY - 起始位置 Y
-     * @param endX - 终止位置 X
-     * @param endY - 终止位置 Y
-     * @param arcAngle - 圆弧角度
-     * @param lineWidth - 线宽
-     * @param interactiveMode - 交互模式
-     * @param primitiveLock - 是否锁定
+     * @param property - 修改参数
      * @returns 圆弧线图元对象
      */
     modify(primitiveId: string | IPCB_PrimitiveArc, property: {
@@ -5942,9 +7294,17 @@ declare class PCB_PrimitiveArc implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveIds - 圆弧线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 圆弧线图元对象
+     * @returns 圆弧线图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitiveArc | undefined>;
+    /**
+     * 获取圆弧线
+     *
+     * @beta
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+     * @param primitiveIds - 圆弧线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 圆弧线图元对象，空数组表示获取失败
+     */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveArc>>;
     /**
      * 获取所有圆弧线的图元 ID
@@ -5963,7 +7323,7 @@ declare class PCB_PrimitiveArc implements IPCB_PrimitiveAPI {
      * @param net - 网络名称
      * @param layer - 层
      * @param primitiveLock - 是否锁定
-     * @returns 圆弧线图元对象数组
+     * @returns ���弧线图元对象数组
      */
     getAll(net?: string, layer?: TPCB_LayersOfLine, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveArc>>;
 }
@@ -6101,14 +7461,8 @@ declare class PCB_PrimitiveDimension implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveId - 图元 ID
-     * @param dimensionType - 尺寸标注类型
-     * @param coordinateSet - 尺寸标注坐标集
-     * @param layer - 层
-     * @param unit - 单位
-     * @param lineWidth - 线宽
-     * @param precision - 精度，取值范围 `0`-`4`
-     * @param primitiveLock - 是否锁定
-     * @returns 尺寸标注图��对象
+     * @param property - 修改参数
+     * @returns 尺寸标注图元对象
      */
     modify(primitiveId: string | IPCB_PrimitiveDimension, property: {
         dimensionType?: EPCB_PrimitiveDimensionType;
@@ -6124,9 +7478,17 @@ declare class PCB_PrimitiveDimension implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveIds - 尺寸标注的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 尺寸标注图元对象
+     * @returns 尺寸标注图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitiveDimension | undefined>;
+    /**
+     * 获取尺寸标注
+     *
+     * @beta
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+     * @param primitiveIds - 尺寸标注的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 尺寸标注图元对象，空数组表示获取失败
+     */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveDimension>>;
     /**
      * 获取所有尺寸标注的图元 ID
@@ -6148,6 +7510,21 @@ declare class PCB_PrimitiveDimension implements IPCB_PrimitiveAPI {
     getAll(layer?: TPCB_LayersOfDimension, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveDimension>>;
 }
 
+/**
+ * PCB & 封装 / 填充图元类
+ *
+ * @public
+ */
+declare class PCB_PrimitiveFill 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 & 封装 / 图像图元类
  *
@@ -6183,14 +7560,7 @@ declare class PCB_PrimitiveImage implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveId - 图元 ID
-     * @param x - BBox 左上点坐标 X
-     * @param y - BBox 左上点坐标 Y
-     * @param layer - 层
-     * @param width - 宽
-     * @param height - 高
-     * @param rotation - 旋转角度
-     * @param horizonMirror - 是否水平镜像
-     * @param primitiveLock - 是否锁定
+     * @param property - 修改参数
      * @returns 图像图元对象
      */
     modify(primitiveId: string | IPCB_PrimitiveImage, property: {
@@ -6208,9 +7578,17 @@ declare class PCB_PrimitiveImage implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveIds - 图像的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 图像图元对象
+     * @returns 图像图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitiveImage | undefined>;
+    /**
+     * 获取图像
+     *
+     * @beta
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+     * @param primitiveIds - 图像的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 图像图元对象，空数组表示获取失败
+     */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveImage>>;
     /**
      * 获取所有图像的图元 ID
@@ -6241,7 +7619,7 @@ declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
     /**
      * 创建导线
      *
-     * @beta
+     * @public
      * @param net - 网络名称
      * @param layer - 层
      * @param startX - 起始位置 X
@@ -6266,14 +7644,7 @@ declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveId - 图元 ID
-     * @param net - 网络名称
-     * @param layer - 层
-     * @param startX - 起始位置 X
-     * @param startY - 起始位置 Y
-     * @param endX - 终止位置 X
-     * @param endY - 终止位置 Y
-     * @param lineWidth - 线宽
-     * @param primitiveLock - 是否锁定
+     * @param property - 修改参数
      * @returns 导线图元对象
      */
     modify(primitiveId: string | IPCB_PrimitiveLine, property: {
@@ -6291,9 +7662,17 @@ declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveIds - 导线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 导线图元对象
+     * @returns 导线图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitiveLine | undefined>;
+    /**
+     * 获取导线
+     *
+     * @beta
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+     * @param primitiveIds - 导线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 导线图元对象，空数组表示获取失败
+     */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveLine>>;
     /**
      * 获取所有导线的图元 ID
@@ -6360,23 +7739,7 @@ declare class PCB_PrimitivePad implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveId - 图元 ID
-     * @param layer - 层
-     * @param padNumber - 焊盘编号
-     * @param x - 位置 X
-     * @param y - 位置 Y
-     * @param rotation - 旋转角度
-     * @param pad - 焊盘外形
-     * @param net - 网络名称
-     * @param hole - 孔，`null` 标识无孔
-     * @param holeOffsetX - 孔偏移 X
-     * @param holeOffsetY - 孔偏移 Y
-     * @param holeRotation - 孔相对于焊盘的旋转角度
-     * @param metallization - 是否金属化孔壁
-     * @param padFunction - 焊盘功能
-     * @param specialPad - 特殊焊盘外形
-     * @param solderMaskAndPasteMaskExpansion - 阻焊/助焊扩展，`null` 表示遵循规则
-     * @param heatWelding - 热焊优化参数
-     * @param primitiveLock - 是否锁定
+     * @param property - 修改参数
      * @returns 焊盘图元对象
      */
     modify(primitiveId: string | IPCB_PrimitivePad, property: {
@@ -6403,9 +7766,17 @@ declare class PCB_PrimitivePad implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveIds - 焊盘的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 焊盘图元对象
+     * @returns 焊盘图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitivePad | undefined>;
+    /**
+     * 获取焊盘
+     *
+     * @beta
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+     * @param primitiveIds - 焊盘的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 焊盘图元对象，空数组表示获取失败
+     */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitivePad>>;
     /**
      * 获取所有焊盘的图元 ID
@@ -6438,7 +7809,7 @@ declare class PCB_PrimitivePolyline implements IPCB_PrimitiveAPI {
     /**
      * 创建折线
      *
-     * @beta
+     * @public
      * @param net - 网络名称
      * @param layer - 层
      * @param polygon - 单多边形对象
@@ -6460,11 +7831,7 @@ declare class PCB_PrimitivePolyline implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveId - 图元 ID
-     * @param net - 网络名称
-     * @param layer - 层
-     * @param polygon - 单多边形对象
-     * @param lineWidth - 线宽
-     * @param primitiveLock - 是否锁定
+     * @param property - 修改参数
      * @returns 折线图元对象
      */
     modify(primitiveId: string | IPCB_PrimitivePolyline, property: {
@@ -6479,9 +7846,17 @@ declare class PCB_PrimitivePolyline implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveIds - 折线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 折线图元对象
+     * @returns 折线图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitivePolyline | undefined>;
+    /**
+     * 获取折线
+     *
+     * @beta
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+     * @param primitiveIds - 折线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 折线图元对象，空数组表示获取失败
+     */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitivePolyline>>;
     /**
      * 获取所有折线的图元 ID
@@ -6505,6 +7880,36 @@ declare class PCB_PrimitivePolyline implements IPCB_PrimitiveAPI {
     getAll(net?: string, layer?: TPCB_LayersOfLine, primitiveLock?: boolean): Promise<Array<IPCB_PrimitivePolyline>>;
 }
 
+/**
+ * PCB & 封装 / 覆铜边框图元类
+ *
+ * @public
+ */
+declare class PCB_PrimitivePour 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 & 封装 / 区域图元类
+ *
+ * @public
+ */
+declare class PCB_PrimitiveRegion 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 & 封装 / 过孔图元类
  *
@@ -6514,13 +7919,13 @@ declare class PCB_PrimitiveVia implements IPCB_PrimitiveAPI {
     /**
      * 创建过孔
      *
-     * @beta
+     * @public
      * @param net - 网络名称
      * @param x - 坐标 X
      * @param y - 坐标 Y
      * @param holeDiameter - 孔径
      * @param diameter - 外径
-     * @param viaType - 过孔类型，`0` 普通过孔，`1` 缝合孔
+     * @param viaType - 过孔类型
      * @param designRuleBlindViaName - 盲埋孔设计规则项名称，定义过孔的开始层与结束层，`null` 表示非盲埋孔
      * @param solderMaskExpansion - 阻焊/助焊扩展，`null` 表示跟随规则
      * @param primitiveLock - 是否锁定
@@ -6540,15 +7945,7 @@ declare class PCB_PrimitiveVia implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveId - 图元 ID
-     * @param net - 网络名称
-     * @param x - 坐标 X
-     * @param y - 坐标 Y
-     * @param holeDiameter - 孔径
-     * @param diameter - 外径
-     * @param viaType - 过孔类型，`0` 普通过孔，`1` 缝合孔
-     * @param designRuleBlindViaName - 盲埋孔设计规则项名称，定义过孔的开始层与结束层，`null` 表示非盲埋孔
-     * @param solderMaskExpansion - 阻焊/助焊扩展，`null` 表示跟随规则
-     * @param primitiveLock - 是否锁定
+     * @param property - 修改参数
      * @returns 过孔图元对象
      */
     modify(primitiveId: string | IPCB_PrimitiveVia, property: {
@@ -6567,15 +7964,25 @@ declare class PCB_PrimitiveVia implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param primitiveIds - 过孔的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 过孔图元对象
+     * @returns 过孔图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitiveVia | undefined>;
+    /**
+     * 获取过孔
+     *
+     * @beta
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+     * @param primitiveIds - 过孔的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 过孔图元对象，空数组表示获取失败
+     */
     get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveVia>>;
     /**
      * 获取所有过孔图元 ID
      *
      * @beta
-     * @returns
+     * @param net - 网络名称
+     * @param primitiveLock - 是否锁定
+     * @returns 过孔的图元 ID 数组
      */
     getAllPrimitiveId(net?: string, primitiveLock?: boolean): Promise<Array<string>>;
     /**
@@ -6583,7 +7990,7 @@ declare class PCB_PrimitiveVia implements IPCB_PrimitiveAPI {
      *
      * @beta
      * @param net - 网络名称
-     * @param primitiveLock - 锁定
+     * @param primitiveLock - 是否锁定
      * @returns 过孔图元对象数组
      */
     getAll(net?: string, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveVia>>;
@@ -7720,7 +9127,7 @@ declare class SYS_ClientUrl {
  */
 declare class SYS_Environment {
     /**
-     * 是否处���浏览器环境
+     * 是否处于浏览器环境
      *
      * @public
      * @returns 是否处于浏览器环境
@@ -8445,9 +9852,17 @@ declare class SYS_ToastMessage {
  * 系统 / 单位类
  *
  * @public
- * @remarks 控制系统单位与单位转换基础函数，当前系统标准单位跨度等效为 `mil`
+ * @remarks 控制系统数据单位与单位转换基础函数，当前系统数据单位跨度等效为 `mil`
  */
 declare class SYS_Unit {
+    /**
+     * 获取 API 系统数据单位跨度
+     *
+     * @public
+     * @remarks 当前 API 系统数据单位跨度等效为 `mil`，不会发生改变
+     * @returns 单位
+     */
+    getSystemDataUnit(): ESYS_Unit.MIL;
     /**
      * 单位转换：密尔到毫米
      *
@@ -8631,6 +10046,14 @@ declare type TPCB_LayersOfCustom = EPCB_LayerId.CUSTOM_1 | EPCB_LayerId.CUSTOM_2
  */
 declare type TPCB_LayersOfDimension = TPCB_LayersOfCustom | EPCB_LayerId.TOP_SILKSCREEN | EPCB_LayerId.BOTTOM_SILKSCREEN | EPCB_LayerId.DOCUMENT | EPCB_LayerId.MECHANICAL;
 
+/**
+ * 填充所属层
+ *
+ * @public
+ * @remarks 填充所属层为 {@link EPCB_LayerId.MULTI} 时代表挖槽区域
+ */
+declare type TPCB_LayersOfFill = 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.DOCUMENT | EPCB_LayerId.MECHANICAL | EPCB_LayerId.MULTI;
+
 /**
  * SVG 图像所属层
  *
@@ -8659,6 +10082,13 @@ declare type TPCB_LayersOfLine = TPCB_LayersOfCopper | TPCB_LayersOfCustom | EPC
  */
 declare type TPCB_LayersOfPad = EPCB_LayerId.TOP | EPCB_LayerId.BOTTOM | EPCB_LayerId.MULTI;
 
+/**
+ * 区域所属层
+ *
+ * @public
+ */
+declare type TPCB_LayersOfRegion = TPCB_LayersOfCopper | EPCB_LayerId.MULTI;
+
 /**
  * 内层允许设置的图层类型
  *