@jlceda/pro-api-types 0.1.84 → 0.1.86

package/index.d.ts

@@ -1187,7 +1187,7 @@ declare enum EPCB_LayerId {
     SHELL_3D_TOP = 54,
     /** 3D 外壳底层 */
     SHELL_3D_BOTTOM = 55,
-    /** 钻��图层 */
+    /** 钻���图层 */
     DRILL_DRAWING = 56
 }
 
@@ -1393,6 +1393,46 @@ declare enum EPCB_PrimitiveViaType {
     SUTURE = 2
 }
 
+/**
+ * 器件类型
+ *
+ * @public
+ */
+declare enum ESCH_PrimitiveComponentType {
+    /** 元件 */
+    COMPONENT = "part",
+    /** 图纸 */
+    DRAWING = "Drawing",
+    /** 网络标识 */
+    NET_FLAG = "netflag",
+    /** 网络端口 */
+    NET_PORT = "netport",
+    /** 无电气标识 */
+    NON_ELECTRICAL_FLAG = "nonElectrical_symbol",
+    /** 短接标识 */
+    SHORT_CIRCUIT_FLAG = "short_symbol"
+}
+
+/**
+ * 引脚类型
+ *
+ * @public
+ */
+declare enum ESCH_PrimitivePinType {
+    IN = "IN",
+    OUT = "OUT",
+    BI = "BI",
+    OPEN_COLLECTOR = "Open Collector",
+    STATE_3 = "3 State",
+    OPEN_EMITTER = "Open Emitter",
+    POWER = "Power",
+    HIZ = "HIZ",
+    UNDEFINED = "Undefined",
+    TERMINATOR = "Terminator",
+    GROUND = "Ground",
+    DEFAULT = "BI"
+}
+
 /**
  * 图元类型
  *
@@ -1407,6 +1447,8 @@ declare enum ESCH_PrimitiveType {
     CIRCLE = "Circle",
     /** 器件 */
     COMPONENT = "Component",
+    /** 器件引脚 */
+    COMPONENT_PIN = "ComponentPin",
     /** 引脚 */
     PIN = "Pin",
     /** 多边形 */
@@ -1930,7 +1972,7 @@ declare interface ILIB_CbbItem {
 }
 
 /**
- * 搜索��的复用模块属性
+ * 搜索到的复用模块属性
  *
  * @public
  */
@@ -2250,7 +2292,7 @@ declare interface ILIB_SymbolSearchItem {
  *
  * @public
  * @remarks
- * 复杂多边形可以包含多个单多边形，通过 {@link https://developer.mozilla.org/zh-CN/docs/Web/SVG/Attribute/fill-rule | fill-rule} 将其组合，以实现多边形的布尔运算。
+ * 复杂多边形可以包含��个单多边形，通过 {@link https://developer.mozilla.org/zh-CN/docs/Web/SVG/Attribute/fill-rule | fill-rule} 将其组合，以实现多边形的布尔运算。
  * 目前嘉立创 EDA 专业版固定使用 {@link https://developer.mozilla.org/zh-CN/docs/Web/SVG/Attribute/fill-rule#nonzero | nonzero} 这个 fill-rule。
  */
 declare class IPCB_ComplexPolygon {
@@ -2562,7 +2604,7 @@ declare class IPCB_PrimitiveArc implements IPCB_Primitive {
      * 设置属性状态：终止位置 Y
      *
      * @beta
-     * @param endY - 终止位置 Y
+     * @param endY - 终��位置 Y
      * @returns 圆弧线图元对象
      */
     setState_EndY(endY: number): IPCB_PrimitiveArc;
@@ -2711,7 +2753,16 @@ declare class IPCB_PrimitiveComponent implements IPCB_Primitive {
     /* Excluded from this release type: setState_SupplierId */
     /* Excluded from this release type: setState_Manufacturer */
     /* Excluded from this release type: setState_ManufacturerId */
-    /* Excluded from this release type: setState_OtherProperty */
+    /**
+     * 设置属性状态：其它参数
+     *
+     * @beta
+     * @param otherProperty - 其它参数
+     * @returns 器件图元对象
+     */
+    setState_OtherProperty(otherProperty: {
+        [key: string]: string;
+    }): IPCB_PrimitiveComponent;
     /**
      * 将图元转换为异步图元
      *
@@ -3066,7 +3117,7 @@ declare class IPCB_PrimitiveFill implements IPCB_Primitive {
      */
     setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveFill;
     /**
-     * 将图元转换为异步���元
+     * 将图元转换为异步图元
      *
      * @public
      * @returns 填充图元对象
@@ -3844,7 +3895,7 @@ declare class IPCB_PrimitivePad implements IPCB_Primitive {
      */
     setState_SolderMaskAndPasteMaskExpansion(solderMaskAndPasteMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null): IPCB_PrimitivePad;
     /**
-     * 设置属性状态��热焊优化参数
+     * 设置属性状态：热焊优化参数
      *
      * @beta
      * @param heatWelding - 热焊优化参数
@@ -4004,7 +4055,7 @@ declare class IPCB_PrimitivePolyline implements IPCB_Primitive {
      */
     setState_Layer(layer: TPCB_LayersOfLine): IPCB_PrimitivePolyline;
     /**
-     * 设置属性���态：单多边形
+     * 设置属性状态：单多边形
      *
      * @beta
      * @param polygon - 单多边形
@@ -4981,30 +5032,28 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
     private componentType;
     /** 图元 ID */
     private primitiveId?;
-    /** 关联库器件 UUID */
-    private componentUuid;
-    /** 子库编号 */
-    private subLibraryId;
-    /** 关联库符号 UUID */
-    private symbolUuid?;
+    /** 关联库器件 */
+    private component;
     /** 坐标 X */
     private x;
     /** 坐标 Y */
     private y;
+    /** 子图块名称 */
+    private subPartName?;
     /** 旋转角度 */
     private rotation;
     /** 是否镜像 */
     private mirror;
-    /** 库路径 */
-    private libraryPath;
     /** Component 属性：是否加入 BOM */
     private addIntoBom?;
     /** Component 属性：是否转到 PCB */
     private addIntoPcb?;
     /** NetPort 和 NetFlag 属性：网络名称 */
     private net?;
+    /** 关联库符号 UUID */
+    private symbol?;
     /** 关联库封装 UUID */
-    private footprintUuid?;
+    private footprint?;
     /** Component 属性：位号 */
     private designator?;
     /** Component 属性：名称 */
@@ -5019,93 +5068,351 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
     private supplier?;
     /** Component 属性：供应商编号 */
     private supplierId?;
+    /** 其它参数 */
+    private otherProperty?;
     /* Excluded from this release type: __constructor */
+    /* Excluded from this release type: create */
     /**
-     * 在原理图画布中创建图元
+     * 获取属性状态：图元类型
      *
-     * @returns 器件图元对象
+     * @public
+     * @returns 图元类型
+     */
+    getState_PrimitiveType(): ESCH_PrimitiveType;
+    /**
+     * 获取属性状态：器件类型
+     *
+     * @public
+     * @returns 器件类型
+     */
+    getState_ComponentType(): ESCH_PrimitiveComponentType;
+    /**
+     * 获取属性状态：图元 ID
+     *
+     * @public
+     * @returns 图元 ID
      */
-    create(): Promise<ISCH_PrimitiveComponent>;
-    getState_PrimitiveType(): string;
-    getState_ComponentType(): string;
     getState_PrimitiveId(): string;
-    getState_ComponentUuid(): string;
-    getState_SubLibraryId(): string;
-    getState_SymbolUuid(): string | undefined;
+    /**
+     * 获取属性状态：关联库器件
+     *
+     * @public
+     * @returns 关联库器件
+     */
+    getState_Component(): {
+        libraryUuid: string;
+        uuid: string;
+    };
+    /**
+     * 获取属性状态：坐标 X
+     *
+     * @public
+     * @returns 坐标 X
+     */
     getState_X(): number;
+    /**
+     * 获取属性状态：坐标 Y
+     *
+     * @public
+     * @returns 坐标 Y
+     */
     getState_Y(): number;
+    /**
+     * 获取属性状态：子图块名称
+     *
+     * @public
+     * @returns 子图块名称
+     */
+    getState_SubPartName(): string | undefined;
+    /**
+     * 获取属性状态：旋转角度
+     *
+     * @public
+     * @returns 旋转角度
+     */
     getState_Rotation(): number;
+    /**
+     * 获取属性状态：是否镜像
+     *
+     * @public
+     * @returns 是否镜像
+     */
     getState_Mirror(): boolean;
+    /**
+     * 获取属性状态：是否加入 BOM
+     *
+     * @public
+     * @returns 是否加入 BOM
+     */
     getState_AddIntoBom(): boolean | undefined;
+    /**
+     * 获取属性状态：是否转到 PCB
+     *
+     * @public
+     * @returns 是否转到 PCB
+     */
     getState_AddIntoPcb(): boolean | undefined;
+    /**
+     * 获取属性状态：网络名称
+     *
+     * @public
+     * @returns 网络名称
+     */
     getState_Net(): string | undefined;
-    getState_FootprintUuid(): string | undefined;
+    /**
+     * 获取属性状态：关联库符号
+     *
+     * @public
+     * @returns 关联库符号
+     */
+    getState_Symbol(): {
+        libraryUuid: string;
+        uuid: string;
+    } | undefined;
+    /**
+     * 获取属性状态：关联库封装
+     *
+     * @public
+     * @returns 关联库封装
+     */
+    getState_Footprint(): {
+        libraryUuid: string;
+        uuid: string;
+    } | undefined;
+    /**
+     * 获取属性状态：位号
+     *
+     * @public
+     * @returns 位号
+     */
     getState_Designator(): 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;
+    } | undefined;
+    /**
+     * 设置属性状态：坐标 X
+     *
+     * @beta
+     * @param x - 坐标 X
+     * @returns 器件图元对象
+     */
     setState_X(x: number): ISCH_PrimitiveComponent;
-    /** 数据校验 */
+    /**
+     * 设置属性状态：坐标 Y
+     *
+     * @beta
+     * @param y - 坐标 Y
+     * @returns 器件图元对象
+     */
     setState_Y(y: number): ISCH_PrimitiveComponent;
-    /** 数据校验 */
+    /**
+     * 设置属性状态：旋转角度
+     *
+     * @beta
+     * @param rotation - 旋转角度
+     * @returns 器件图元对象
+     */
     setState_Rotation(rotation: number): ISCH_PrimitiveComponent;
-    /** 数据校验 */
+    /**
+     * 设置属性状态：是否镜像
+     *
+     * @beta
+     * @param mirror - 是否镜像
+     * @returns 器件图元对象
+     */
     setState_Mirror(mirror: boolean): ISCH_PrimitiveComponent;
-    /**  数据校验 */
-    setState_AddIntoBom(addIntoBom: any): ISCH_PrimitiveComponent;
-    /**  数据校验 */
-    setState_AddIntoPcb(addIntoPcb: any): ISCH_PrimitiveComponent;
-    /**  数据校验 */
+    /**
+     * 设置属性状态：是否加入 BOM
+     *
+     * @beta
+     * @param addIntoBom - 是否加入 BOM
+     * @returns 器件图元对象
+     */
+    setState_AddIntoBom(addIntoBom: boolean | undefined): ISCH_PrimitiveComponent;
+    /**
+     * 设置属性状态：是否转到 PCB
+     *
+     * @beta
+     * @param addIntoPcb - 是否转到 PCB
+     * @returns 器件图元对象
+     */
+    setState_AddIntoPcb(addIntoPcb: boolean | undefined): ISCH_PrimitiveComponent;
+    /**
+     * 设置属性状态：网络名称
+     *
+     * @beta
+     * @param net - 网络名称
+     * @returns 器件图元对象
+     */
     setState_Net(net: string | undefined): ISCH_PrimitiveComponent;
-    /**  数据校验 */
+    /**
+     * 设置属性状态：位号
+     *
+     * @beta
+     * @param designator - 位号
+     * @returns 器件图元对象
+     */
     setState_Designator(designator: string | undefined): ISCH_PrimitiveComponent;
-    /**  数据校验 */
+    /**
+     * 设置属性状态：名称
+     *
+     * @beta
+     * @param name - 名称
+     * @returns 器件图元对象
+     */
     setState_Name(name: string | undefined): ISCH_PrimitiveComponent;
-    /** 数据校验 */
+    /**
+     * 设置属性状态：唯一 ID
+     *
+     * @beta
+     * @param uniqueId - 唯一 ID
+     * @returns 器件图元对象
+     */
     setState_UniqueId(uniqueId: string | undefined): ISCH_PrimitiveComponent;
-    /**  数据校验 */
-    setState_Supplier(supplier: string | undefined): ISCH_PrimitiveComponent;
-    /**  数据校验 */
-    setState_SupplierId(supplierId: string | undefined): ISCH_PrimitiveComponent;
-    /** 数据校验 */
+    /**
+     * 设置属性状态：制造商
+     *
+     * @beta
+     * @param manufacturer - 制造商
+     * @returns 器件图元对象
+     */
     setState_Manufacturer(manufacturer: string | undefined): ISCH_PrimitiveComponent;
-    /**  数据校验 */
+    /**
+     * 设置属性状态：制造商编号
+     *
+     * @beta
+     * @param manufacturerId - 制造商编号
+     * @returns 器件图元对象
+     */
     setState_ManufacturerId(manufacturerId: string | undefined): ISCH_PrimitiveComponent;
+    /**
+     * 设置属性状态：供应商
+     *
+     * @beta
+     * @param supplier - 供应商
+     * @returns 器件图元对象
+     */
+    setState_Supplier(supplier: string | undefined): ISCH_PrimitiveComponent;
+    /**
+     * 设置属性状态：供应商编号
+     *
+     * @beta
+     * @param supplierId - 供应商编号
+     * @returns 器件图元对象
+     */
+    setState_SupplierId(supplierId: string | undefined): ISCH_PrimitiveComponent;
+    /**
+     * 设置属性状态：其它参数
+     *
+     * @beta
+     * @param otherProperty - 其它参数
+     * @returns 器件图元对象
+     */
+    setState_OtherProperty(otherProperty: {
+        [key: string]: string;
+    }): ISCH_PrimitiveComponent;
     /**
      * 将图元转换为异步图元
+     *
+     * @public
+     * @returns 圆弧线图元对象
      */
     toAsync(): ISCH_PrimitiveComponent;
     /**
      * 将图元转换为同步图元
+     *
+     * @public
+     * @returns 圆弧线图元对象
      */
     toSync(): ISCH_PrimitiveComponent;
     /**
      * 查询图元是否为异步图元
+     *
+     * @public
+     * @returns 是否为异步图元
      */
     isAsync(): boolean;
     /**
      * 将异步图元重置为当前画布状态
      *
      * @beta
+     * @returns 器件图元对象
      */
     reset(): Promise<ISCH_PrimitiveComponent>;
     /**
      * 将对图元的更改应用到画布
      *
      * @beta
-     * @remarks 此处需要通过 componentUuid 区分器件类型，并在原理图画布中用正确的方式修改器件
+     * @returns 器件图元对象
      */
     done(): Promise<ISCH_PrimitiveComponent>;
-    /**  数据校验 */
-    private setState_ComponentUuid;
-    /** 数据校验 */
-    private setState_SubLibraryId;
-    /** 数据校验 */
-    private setState_LibraryPath;
+    /* Excluded from this release type: setState_Component */
+    /* Excluded from this release type: setState_SubPartName */
+}
+
+/**
+ * 器件引脚
+ *
+ * @public
+ */
+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;
 }
 
 /**
@@ -5156,7 +5463,7 @@ declare class ISCH_PrimitivePin implements ISCH_Primitive {
     getState_PinLength(): number;
     getState_PinColor(): string | null;
     getState_PinShape(): string;
-    getState_pinType(): PIN_TYPE;
+    getState_pinType(): ESCH_PrimitivePinType;
     setState_X(x: number): ISCH_PrimitivePin;
     setState_Y(y: number): ISCH_PrimitivePin;
     setState_PinNumber(pinNumber: string): ISCH_PrimitivePin;
@@ -5165,7 +5472,7 @@ declare class ISCH_PrimitivePin implements ISCH_Primitive {
     setState_PinLength(pinLength: number): ISCH_PrimitivePin;
     setState_PinColor(pinColor: string | null): ISCH_PrimitivePin;
     setState_PinShape(pinShape: string): this;
-    setState_PinType(pinType: PIN_TYPE): ISCH_PrimitivePin;
+    setState_PinType(pinType: ESCH_PrimitivePinType): ISCH_PrimitivePin;
     /**
      * 将图元转换为异步图元
      */
@@ -6349,7 +6656,7 @@ declare class PCB_Document {
      * 嘉立创 EDA 专业版 API 使用的均为数据原点；
      *
      * 如果返回的数据为 `{ canvasOriginOffsetX: 100, canvasOriginOffsetY: 200 }`，
-     * 则代表画布原点在数据原点的向右 100 单位且向上 200 单位的位��；
+     * 则代表画布原点在数据原点的向右 100 单位且向上 200 单位的位置；
      *
      * 此处的单位为数据层面单位，在跨度上等同于画布层面的 mil
      * @returns 画布原点相对于数据原点的偏移坐标
@@ -6851,7 +7158,7 @@ declare class PCB_Layer {
      * @param numberOfLayers - 层数
      * @returns 操作是否成功
      */
-    setTheNumberOfCopperLayers(numberOfLayers: 1 | 2 | 4 | 6 | 8 | 10 | 12 | 14 | 16 | 18 | 20 | 22 | 24 | 26 | 28 | 30 | 32): Promise<boolean>;
+    setTheNumberOfCopperLayers(numberOfLayers: 2 | 4 | 6 | 8 | 10 | 12 | 14 | 16 | 18 | 20 | 22 | 24 | 26 | 28 | 30 | 32): Promise<boolean>;
     /**
      * 设置层颜色配置
      *
@@ -6937,7 +7244,7 @@ declare class PCB_ManufactureData {
      * @beta
      * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
      * @param fileName - 文件名
-     * @param colorSilkscreen - 是否生成彩色丝印制造文件（嘉立���专用文件）
+     * @param colorSilkscreen - 是否生成彩色丝印制造文件（嘉立创专用文件）
      * @param unit - 单位
      * @param digitalFormat - 数字格式
      * @param drilledHole - 钻孔
@@ -7246,14 +7553,8 @@ declare class PCB_Net {
 declare class PCB_Primitive {
     /* Excluded from this release type: getPrimitiveTypeByPrimitiveId */
     /* Excluded from this release type: getPrimitiveByPrimitiveId */
-    /**
-     * 获取指定所有 ID 的图元的所有属性
-     *
-     * @public
-     * @param ids - 图元 ID 数组
-     * @returns 所有图元的所有属性
-     */
-    getPrimitivesByPrimitiveId(ids: Array<string>): Promise<Array<IPCB_Primitive>>;
+    /* Excluded from this release type: getPrimitivesByPrimitiveId */
+    /* Excluded from this release type: getPrimitivesBBox */
 }
 
 /**
@@ -7362,15 +7663,12 @@ declare class PCB_PrimitiveComponent implements IPCB_PrimitiveAPI {
      * @param y - 坐标 Y
      * @param rotation - 旋转角度
      * @param primitiveLock - 是否锁定
-     * @param addIntoBom - 是否加入 BOM
      * @returns 器件图元对象
      */
     create(component: {
         libraryUuid: string;
         uuid: string;
-    } | ILIB_DeviceItem, layer: TPCB_LayersOfComponent, x: number, y: number, rotation?: number, primitiveLock?: number, attributes?: {
-        [key: string]: any;
-    }): Promise<IPCB_PrimitiveComponent | undefined>;
+    } | ILIB_DeviceItem, layer: TPCB_LayersOfComponent, x: number, y: number, rotation?: number, primitiveLock?: boolean): Promise<IPCB_PrimitiveComponent | undefined>;
     /**
      * 删除器件
      *
@@ -7441,7 +7739,7 @@ declare class PCB_PrimitiveComponent implements IPCB_PrimitiveAPI {
      * @beta
      * @param layer - 层
      * @param primitiveLock - 是否锁定
-     * @returns 器件图��对象数组
+     * @returns 器件图元对象数组
      */
     getAll(layer?: TPCB_LayersOfComponent, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveComponent>>;
     /* Excluded from this release type: placeComponentWithMouse */
@@ -8067,21 +8365,6 @@ declare class PCB_SelectControl {
     /* Excluded from this release type: getCurrentMousePosition */
 }
 
-declare enum PIN_TYPE {
-    IN = "IN",
-    OUT = "OUT",
-    BI = "BI",
-    OPEN_COLLECTOR = "Open Collector",
-    STATE_3 = "3 State",
-    OPEN_EMITTER = "Open Emitter",
-    POWER = "Power",
-    HIZ = "HIZ",
-    UNDEFINED = "Undefined",
-    TERMINATOR = "Terminator",
-    GROUND = "Ground",
-    DEFAULT = "BI"
-}
-
 /**
  * 面板 / 文档操作类
  *
@@ -8201,8 +8484,44 @@ declare class SCH_ManufactureData {
      * @returns 网表文件数据
      */
     getNetlistFile(fileName?: string, netlistType?: ENetlistType): Promise<File | undefined>;
-    /* Excluded from this release type: placeComponentsOrder */
-    /* Excluded from this release type: placeSmtComponentsOrder */
+    /**
+     * 元件下单
+     *
+     * @beta
+     * @param interactive - 是否启用交互式检查
+     *
+     * 如若启用，则会存在弹窗等待用户进行交互，且无法使用 `ignoreWarning` 参数忽略警告，
+     * 即 `ignoreWarning` 参数将被忽略；
+     *
+     * 如若禁用，则在调用后不会有任何 EDA 内部弹窗，程序执行静默检查，
+     * 如若达成下单条件，将返回 `true` 并在新标签页打开下单页面
+     * @param ignoreWarning - 在非交互式检查时忽略警告
+     *
+     * 如果设置为 `true`，将会忽略所有检查警告项并尽可能生成下单资料；
+     *
+     * 如果设置为 `false`，存在任意警告将中断执行并返回 `false` 的结果
+     * @returns 是否通过下单检查
+     */
+    placeComponentsOrder(interactive?: boolean, ignoreWarning?: boolean): Promise<boolean>;
+    /**
+     * SMT 元件下单
+     *
+     * @beta
+     * @param interactive - 是否启用交互式检查
+     *
+     * 如若启用，则会存在弹窗等待用户进行交互，且无法使用 `ignoreWarning` 参数忽略警告，
+     * 即 `ignoreWarning` 参数将被忽略；
+     *
+     * 如若禁用，则在调用后不会有任何 EDA 内部弹窗，程序执行静默检查，
+     * 如若达成下单条件，将返回 `true` 并在新标签页打开下单页面
+     * @param ignoreWarning - 在非交互式检查时忽略警告
+     *
+     * 如果设置为 `true`，将会忽略所有检查警告项并尽可能生成下单资料；
+     *
+     * 如果设置为 `false`，存在任意警告将中断执行并返回 `false` 的结果
+     * @returns 是否通过下单检查
+     */
+    placeSmtComponentsOrder(interactive?: boolean, ignoreWarning?: boolean): Promise<boolean>;
 }
 
 /**
@@ -8253,14 +8572,8 @@ declare class SCH_Primitive {
      * @returns 图元的所有属性
      */
     getPrimitiveByPrimitiveId(id: string): Promise<ISCH_Primitive | undefined>;
-    /**
-     * 获取指定所有 ID 的图元的所有属性
-     *
-     * @public
-     * @param ids - 图元 ID 数组
-     * @returns 所有图元的所有属性
-     */
-    getPrimitivesByPrimitiveId(ids: Array<string>): Promise<Array<ISCH_Primitive>>;
+    /* Excluded from this release type: getPrimitivesByPrimitiveId */
+    /* Excluded from this release type: getPrimitivesBBox */
 }
 
 /**
@@ -8316,7 +8629,7 @@ declare class SCH_PrimitiveArc implements ISCH_PrimitiveAPI {
      * 获取圆弧
      *
      * @beta
-     * @param primitiveIds - 圆弧的图元 ID，可以为字符串或字符串数组，如若为数组，则返回��也是数组
+     * @param primitiveIds - 圆弧的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
      * @returns 圆弧图元对象
      */
     get(primitiveIds: string): Promise<ISCH_PrimitiveArc | undefined>;
@@ -8483,87 +8796,103 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
     private netPortComponentUuid_OUT;
     private netPortComponentUuid_BI;
     private shortCircuitFlagComponentUuid;
-    private SystematicUuid;
-    constructor();
+    private defaultLibraryUuid;
+    /* Excluded from this release type: __constructor */
     /**
      * 设置在扩展 API 中 Power 网络标识关联的器件 UUID
      *
      * @beta
-     * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库路径，默认为系统库
+     * @param component - 关联库器件
      * @returns 操作是否成功
      */
-    setNetFlagComponentUuid_Power(componentUuid: string, libraryPath?: string): Promise<boolean>;
+    setNetFlagComponentUuid_Power(component: {
+        libraryUuid: string;
+        uuid: string;
+    } | ILIB_DeviceItem): Promise<boolean>;
     /**
      * 设置在扩展 API 中 Ground 网络标识关联的器件 UUID
      *
      * @beta
-     * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库路径，默认为系统库
+     * @param component - 关联库器件
      * @returns 操作是否成功
      */
-    setNetFlagComponentUuid_Ground(componentUuid: string, libraryPath?: string): Promise<boolean>;
+    setNetFlagComponentUuid_Ground(component: {
+        libraryUuid: string;
+        uuid: string;
+    } | ILIB_DeviceItem): Promise<boolean>;
     /**
      * 设置在扩展 API 中 AnalogGround 网络标识关联的器件 UUID
      *
      * @beta
-     * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库路径，默认为系统库
+     * @param component - 关联库器件
      * @returns 操作是否成功
      */
-    setNetFlagComponentUuid_AnalogGround(componentUuid: string, libraryPath?: string): Promise<boolean>;
+    setNetFlagComponentUuid_AnalogGround(component: {
+        libraryUuid: string;
+        uuid: string;
+    } | ILIB_DeviceItem): Promise<boolean>;
     /**
      * 设置在扩展 API 中 ProtectGround 网络标识关联的器件 UUID
      *
      * @beta
-     * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库路径，默认为系统库
+     * @param component - 关联库器件
      * @returns 操作是否成功
      */
-    setNetFlagComponentUuid_ProtectGround(componentUuid: string, libraryPath?: string): Promise<boolean>;
+    setNetFlagComponentUuid_ProtectGround(component: {
+        libraryUuid: string;
+        uuid: string;
+    } | ILIB_DeviceItem): Promise<boolean>;
     /**
      * 设置在扩展 API 中 IN 网络端口关联的器件 UUID
      *
      * @beta
-     * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库路径，默认为系统库
+     * @param component - 关联库器件
      * @returns 操作是否成功
      */
-    setNetPortComponentUuid_IN(componentUuid: string, libraryPath?: string): Promise<boolean>;
+    setNetPortComponentUuid_IN(component: {
+        libraryUuid: string;
+        uuid: string;
+    } | ILIB_DeviceItem): Promise<boolean>;
     /**
      * 设置在扩展 API 中 OUT 网络端口关联的器件 UUID
      *
      * @beta
-     * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库路径，默认为系统库
+     * @param component - 关联库器件
      * @returns 操作是否成功
      */
-    setNetPortComponentUuid_OUT(componentUuid: string, libraryPath?: string): Promise<boolean>;
+    setNetPortComponentUuid_OUT(component: {
+        libraryUuid: string;
+        uuid: string;
+    } | ILIB_DeviceItem): Promise<boolean>;
     /**
      * 设置在扩展 API 中 BI 网络端口关联的器件 UUID
      *
      * @beta
-     * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库路径，默认为系统库
+     * @param component - 关联库器件
      * @returns 操作是否成功
      */
-    setNetPortComponentUuid_BI(componentUuid: string, libraryPath?: string): Promise<boolean>;
+    setNetPortComponentUuid_BI(component: {
+        libraryUuid: string;
+        uuid: string;
+    } | ILIB_DeviceItem): Promise<boolean>;
     /**
      * 创建器件
      *
      * @beta
-     * @param componentUuid - 关联库器件 UUID
-     * @param libraryPath - 库路
-     * @param subLibraryId - 子库编号 part名称
+     * @param component - 关联库器件
+     * @param subPartName - 子图块名称
      * @param x - 坐标 X
      * @param y - 坐标 Y
-     * @param rotation - 旋转角度，可选 `0` `90` `180` `270`
+     * @param rotation - 旋转角度
      * @param mirror - 是否镜像
      * @param addIntoBom - 是否加入 BOM
      * @param addIntoPcb - 是否转到 PCB
      * @returns 器件图元对象
      */
-    create(componentUuid: string, libraryPath: string, subLibraryId: string, x: number, y: number, rotation?: number, mirror?: boolean, addIntoBom?: boolean, addIntoPcb?: boolean): Promise<ISCH_PrimitiveComponent | undefined>;
+    create(component: {
+        libraryUuid: string;
+        uuid: string;
+    } | ILIB_DeviceItem, x: number, y: number, subPartName?: string, rotation?: number, mirror?: boolean, addIntoBom?: boolean, addIntoPcb?: boolean): Promise<ISCH_PrimitiveComponent | undefined>;
     /**
      * 创建网络标识
      *
@@ -8613,11 +8942,11 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
      * 修改器件
      *
      * @beta
-     * @remarks 仅当器件类型为 `Component` 时允许使用该函数进行修改
+     * @remarks 仅当器件类型为 {@link ESCH_PrimitiveComponentType.COMPONENT | COMPONENT} 时允许使用该方法进行修改
      * @param primitiveId - 图元 ID
      * @param x - 坐标 X
      * @param y - 坐标 Y
-     * @param rotation - 旋转角度，可选 `0` `90` `180` `270`
+     * @param rotation - 旋转角度
      * @param mirror - 是否镜像
      * @param libraryPath - 库路径，默认为系统库
      * @param addIntoBom - 是否加入 BOM
@@ -8631,17 +8960,41 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
      * @param supplierId - 供应商编号，`null` 表示留空
      * @returns 器件图元对象
      */
-    modify(primitiveId: string | ISCH_PrimitiveComponent, x?: number, y?: number, rotation?: number, mirror?: boolean, addIntoBom?: boolean, addIntoPcb?: boolean, designator?: string | null, name?: string | null, uniqueId?: string | null, manufacturer?: string | null, manufacturerId?: string | null, supplier?: string | null, supplierId?: string | null): Promise<ISCH_PrimitiveComponent | undefined>;
+    modify(primitiveId: string | ISCH_PrimitiveComponent, property: {
+        x?: number;
+        y?: number;
+        rotation?: number;
+        mirror?: boolean;
+        addIntoBom?: boolean;
+        addIntoPcb?: boolean;
+        designator?: string | null;
+        name?: string | null;
+        uniqueId?: string | null;
+        manufacturer?: string | null;
+        manufacturerId?: string | null;
+        supplier?: string | null;
+        supplierId?: string | null;
+        otherProperty?: {
+            [key: string]: string;
+        };
+    }): Promise<ISCH_PrimitiveComponent | undefined>;
     /**
      * 获取器件
      *
      * @beta
      * @param primitiveIds - 器件的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-     * @returns 器件图元对象
+     * @returns 器件图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<ISCH_PrimitiveComponent | undefined>;
+    /**
+     * 获取器件
+     *
+     * @beta
+     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+     * @param primitiveIds - 器件的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @returns 器件图元对象，空数组表示获取失败
+     */
     get(primitiveIds: Array<string>): Promise<Array<ISCH_PrimitiveComponent>>;
-    /* Excluded from this release type: transformPrimitiveTypeToCmdKey */
     /**
      * 获取所有器件的图元 ID
      *
@@ -8660,23 +9013,8 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
     getAll(componentType?: string, allSchematicPages?: boolean): Promise<Array<ISCH_PrimitiveComponent>>;
     /* Excluded from this release type: getAllPinsByPrimitiveId */
     /* Excluded from this release type: placeComponentWithMouse */
-    /**
-     * 到 pro-ui 获取器件的详细信息
-     *
-     * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库 PATH
-     * @returns 器件的详细信息
-     */
-    private getComponentDetail;
-    /**
-     * 根据 DOCTYPE 验证输入的 UUID 是否正确
-     *
-     * @param componentType - 器件类型
-     * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库 PATH
-     * @returns 是否正确
-     */
-    private checkComponentType;
+    /* Excluded from this release type: getComponentDetail */
+    /* Excluded from this release type: checkComponentType */
 }
 
 /**
@@ -8700,7 +9038,7 @@ declare class SCH_PrimitivePin implements ISCH_PrimitiveAPI {
      * @param pinType - 引脚类型
      * @returns 引脚图元对象
      */
-    create(x: number, y: number, pinNumber: string, pinName?: string, rotation?: number, pinLength?: number, pinColor?: string | null, pinShape?: string, pinType?: PIN_TYPE): Promise<ISCH_PrimitivePin | undefined>;
+    create(x: number, y: number, pinNumber: string, pinName?: string, rotation?: number, pinLength?: number, pinColor?: string | null, pinShape?: string, pinType?: ESCH_PrimitivePinType): Promise<ISCH_PrimitivePin | undefined>;
     /**
      * 删除引脚
      *
@@ -8725,7 +9063,7 @@ declare class SCH_PrimitivePin implements ISCH_PrimitiveAPI {
      * @param pinType - 引脚类型
      * @returns 引脚图元对象
      */
-    modify(primitiveId: string | ISCH_PrimitivePin, x?: number, y?: number, pinNumber?: string, pinName?: string, rotation?: number, pinLength?: number, pinColor?: string | null, pinShape?: string, pinType?: PIN_TYPE): Promise<ISCH_PrimitivePin | undefined>;
+    modify(primitiveId: string | ISCH_PrimitivePin, x?: number, y?: number, pinNumber?: string, pinName?: string, rotation?: number, pinLength?: number, pinColor?: string | null, pinShape?: string, pinType?: ESCH_PrimitivePinType): Promise<ISCH_PrimitivePin | undefined>;
     /**
      * 获取引脚
      *
@@ -9017,7 +9355,7 @@ declare class SCH_PrimitiveWire implements ISCH_PrimitiveAPI {
      * 获取导线
      *
      * @beta
-     * @param primitiveIds - 导线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @param primitiveIds - 导线的图元 ID，可以为字符串或字符串数组，如若为数���，则返回的也是数组
      * @returns 导线图元对象
      */
     get(primitiveIds: string): ISCH_PrimitiveWire | undefined;

package/package.json

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