@jlceda/pro-api-types 0.1.83 → 0.1.85

package/index.d.ts

@@ -416,7 +416,7 @@ declare class DMT_Project {
      * @param teamUuid - 团队 UUID，如若不指定，则默认为个人；在不存在个人工程的环境下必须指定团队 UUID
      * @param folderUuid - 文件夹 UUID，如若不指定，则为根文件夹
      * @param description - 工程描述
-     * @param collaborationMode - 工程协作模式，如若团队权限无需工程设置协作模式，则该参数将被忽略
+     * @param collaborationMode - 工程协作模式，如若团队权限无需工程设置协作模式，则��参数将被忽略
      * @returns 工程 UUID，如若为 `undefined` 则创建失败
      */
     createProject(projectFriendlyName: string, projectName?: string, teamUuid?: string, folderUuid?: string, description?: string, collaborationMode?: EDMT_ProjectCollaborationMode): Promise<string | undefined>;
@@ -595,7 +595,7 @@ declare class DMT_Schematic {
      */
     getCurrentSchematicInfo(): Promise<IDMT_SchematicItem | undefined>;
     /**
-     * 获取当前原理图图页的详细属性
+     * 获取当前原��图图页的详细属性
      *
      * @beta
      * @remarks 将会获取当前打开且拥有最后输入焦点的原理图图页的详细属性
@@ -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",
     /** 多边形 */
@@ -1707,7 +1749,7 @@ declare interface IDMT_EditorTabItem {
     title: string;
     /** 标签页 ID */
     tabId: string;
-    /** 标签页是否可拖动 */
+    /** 标签页��否可拖动 */
     draggable: boolean;
     /** 标签页是否可关闭 */
     isAbleDelete: boolean;
@@ -1930,7 +1972,7 @@ declare interface ILIB_CbbItem {
 }
 
 /**
- * 搜索��的复用模块属性
+ * 搜索到的复用模块属性
  *
  * @public
  */
@@ -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;
     /**
      * 将图元转换为异步图元
      */
@@ -5686,7 +5993,7 @@ declare class LIB_Cbb {
      */
     get(cbbUuid: string, libraryUuid?: string): Promise<ILIB_CbbItem | undefined>;
     /**
-     * 复制复用���块
+     * 复制复用模块
      *
      * @beta
      * @param cbbUuid - 复用模块 UUID
@@ -6267,17 +6574,23 @@ declare class PCB_Document {
      */
     importChanges(uuid: string): Promise<boolean>;
     /**
-     * 导入旧版自动布线文件（JSON）
+     * 导入自动布线文件（JSON）
      *
-     * @public
+     * @beta
      * @remarks 可以使用 {@link SYS_FileSystem.openReadFileDialog} 读入文件
      * @param autoRouteFile - 欲导入的 JSON 文件
      * @returns 导入操作是否成功
      */
-    importOldAutoRouteJsonFile(autoRouteFile: File): Promise<boolean>;
-    /* Excluded from this release type: importAutoRouteJsonFile */
-    /* Excluded from this release type: importOldAutoLayoutJsonFile */
-    /* Excluded from this release type: importAutoLayoutJsonFile */
+    importAutoRouteJsonFile(autoRouteFile: File): Promise<boolean>;
+    /**
+     * 导入自动布局文件（JSON）
+     *
+     * @beta
+     * @remarks 可以使用 {@link SYS_FileSystem.openReadFileDialog} 读入文件
+     * @param autoLayoutFile - 欲导入的 JSON 文件
+     * @returns 导入操作是否成功
+     */
+    importAutoLayoutJsonFile(autoLayoutFile: File): Promise<boolean>;
     /**
      * 保存文档
      *
@@ -6414,7 +6727,7 @@ declare class PCB_Drc {
     /**
      * 获取当前设计规则配置
      *
-     * @public
+     * @beta
      * @returns 当前设计规则配置，`undefined` 为获取失败
      */
     getCurrentRuleConfiguration(): Promise<{
@@ -6423,7 +6736,7 @@ declare class PCB_Drc {
     /**
      * 获取指定设计规则配置
      *
-     * @beta
+     * @public
      * @param configurationName - 配置名称
      * @returns 设计规则配置，`undefined` 为不存在该设计规则
      */
@@ -6456,6 +6769,7 @@ declare class PCB_Drc {
      * 重命名设计规则配置
      *
      * @beta
+     * @remarks 只有自定义配置可以重命名，系统配置不允许重命名
      * @param originalConfigurationName - 原设计规则配置名称
      * @param configurationName - 新设计规则配置名称
      * @returns 重命名是否成功
@@ -6465,6 +6779,7 @@ declare class PCB_Drc {
      * 删除设计规则配置
      *
      * @beta
+     * @remarks 系统配置不允许删除
      * @param configurationName - 配置名称
      * @returns 删除是否成功
      */
@@ -6480,6 +6795,7 @@ declare class PCB_Drc {
      * 设置为新建 PCB 默认设计规则配置
      *
      * @beta
+     * @remarks 返回值为结果导向，重复设置相同的设计规则为默认设计规则也将返回 `true`
      * @param configurationName - 配置名称
      * @returns 设置是否成功
      */
@@ -7353,15 +7669,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>;
     /**
      * 删除器件
      *
@@ -7435,6 +7748,7 @@ declare class PCB_PrimitiveComponent implements IPCB_PrimitiveAPI {
      * @returns 器件图元对象数组
      */
     getAll(layer?: TPCB_LayersOfComponent, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveComponent>>;
+    /* Excluded from this release type: placeComponentWithMouse */
 }
 
 /**
@@ -7854,7 +8168,7 @@ declare class PCB_PrimitivePolyline implements IPCB_PrimitiveAPI {
      * 获取折线
      *
      * @beta
-     * @param primitiveIds - 折线的图元 ID，可以为字符串或字符��数组，如若为数组，则返回的也是数组
+     * @param primitiveIds - 折线的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
      * @returns 折线图元对象，`undefined` 表示获取失败
      */
     get(primitiveIds: string): Promise<IPCB_PrimitivePolyline | undefined>;
@@ -8033,6 +8347,7 @@ declare class PCB_SelectControl {
      *
      * @beta
      * @param primitiveIds - 图元 ID
+     * @returns 操作是否成功
      */
     doSelectPrimitives(primitiveIds: string | Array<string>): Promise<boolean>;
     /**
@@ -8043,31 +8358,17 @@ declare class PCB_SelectControl {
      * @param pins - 器件位号_引脚编号，格式为 ['U1_1', 'U1_2']
      * @param nets - 网络名称
      * @param highlight - 是否高亮
-     * @param select - 是否选中
+     * @param select - 操作是否成功
      */
     doCrossProbeSelect(components?: Array<string>, pins?: Array<string>, nets?: Array<string>, highlight?: boolean, select?: boolean): Promise<boolean>;
     /**
      * 清除选中
      *
      * @beta
-     * @returns 是否清除成功
+     * @returns 操作是否成功
      */
     clearSelected(): Promise<boolean>;
-}
-
-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"
+    /* Excluded from this release type: getCurrentMousePosition */
 }
 
 /**
@@ -8189,8 +8490,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>;
 }
 
 /**
@@ -8471,87 +8808,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 subLibraryId - 子库编号 part名称
+     * @param component - 关联库器件
+     * @param subPartName - 子图块名称
      * @param x - 坐标 X
      * @param y - 坐标 Y
-     * @param rotation - 旋转角度，可选 `0` `90` `180` `270`
+     * @param rotation - 旋转角度
      * @param mirror - 是否镜像
-     * @param libraryPath - 库路径，默认为系统库
      * @param addIntoBom - 是否加入 BOM
      * @param addIntoPcb - 是否转到 PCB
      * @returns 器件图元对象
      */
-    create(componentUuid: string, subLibraryId: string, x: number, y: number, rotation?: number, mirror?: boolean, libraryPath?: string, 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>;
     /**
      * 创建网络标识
      *
@@ -8601,11 +8954,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
@@ -8619,17 +8972,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
      *
@@ -8647,23 +9024,9 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
      */
     getAll(componentType?: string, allSchematicPages?: boolean): Promise<Array<ISCH_PrimitiveComponent>>;
     /* Excluded from this release type: getAllPinsByPrimitiveId */
-    /**
-     * 到 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: placeComponentWithMouse */
+    /* Excluded from this release type: getComponentDetail */
+    /* Excluded from this release type: checkComponentType */
 }
 
 /**
@@ -8687,7 +9050,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>;
     /**
      * 删除引脚
      *
@@ -8712,7 +9075,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>;
     /**
      * 获取引脚
      *
@@ -8750,7 +9113,7 @@ declare class SCH_PrimitivePolygon implements ISCH_PrimitiveAPI {
      * 创建多边形
      *
      * @beta
-     * @param line - 坐标组，连续的一组 `[x1, y1, x2, y2, x3, y3]` 所描述的线
+     * @param line - 坐标���，连续的一组 `[x1, y1, x2, y2, x3, y3]` 所描述的线
      * @param color - 颜色，`null` 表示默认
      * @param fillColor - 填充颜色，`none` 表示无填充，`null` 表示默认
      * @param lineWidth - 线宽，范围 `1-10`，`null` 表示默认
@@ -9057,6 +9420,7 @@ declare class SCH_SelectControl {
      *
      * @public
      * @param primitiveIds - 图元 ID
+     * @returns 操作是否成功
      */
     doSelectPrimitives(primitiveIds: string | Array<string>): Promise<boolean>;
     /**
@@ -9068,14 +9432,17 @@ declare class SCH_SelectControl {
      * @param nets - 网络名称
      * @param highlight - 是否高亮
      * @param select - 是否选中
+     * @returns 操作是否成功
      */
     doCrossProbeSelect(components?: Array<string>, pins?: Array<string>, nets?: Array<string>, highlight?: boolean, select?: boolean): boolean;
     /**
      * 清除选中
      *
      * @public
+     * @returns 操作是否成功
      */
     clearSelected(): boolean;
+    /* Excluded from this release type: getCurrentMousePosition */
 }
 
 /**
@@ -9109,7 +9476,7 @@ declare class SYS_ClientUrl {
      * 注意：本接口需要使用者启用扩展的外部交互权限，如若未启用将始终 `throw Error`
      * @param url - 请求地址
      * @param method - 请求方法
-     * @param data - 请求发送的数据，可以是直接数据或 {@link https://developer.mozilla.org/docs/Web/API/URLSearchParams | URLSearchParams} 对象，如果 method 为 `HEAD` 或 `GET`，本参数将被忽略
+     * @param data - 请求发送的数据，可以是直接数��或 {@link https://developer.mozilla.org/docs/Web/API/URLSearchParams | URLSearchParams} 对象，如果 method 为 `HEAD` 或 `GET`，本参数将被忽略
      * @param options - 请求参数
      * @param succeedCallFn - 请求成功后回调的函数
      * @returns Fetch 的返回结果
@@ -9151,7 +9518,7 @@ declare class SYS_Environment {
      */
     isEasyEDAProEdition(): boolean;
     /**
-     * 是否为嘉立创EDA 专���版本
+     * 是否为嘉立创EDA 专业版本
      *
      * @public
      * @returns 是否为嘉立创EDA 专业版本
@@ -9234,7 +9601,7 @@ declare class SYS_FileManager {
      * 修改文档源码
      *
      * @beta
-     * @param source - 文档源码
+     * @param source - 文档源��
      * @returns 是否修改成功，如果输入的文档源码格式错误，将返回 `false` 的结果
      */
     setDocumentSource(source: string): Promise<boolean>;
@@ -9298,9 +9665,10 @@ declare class SYS_FileSystem {
      * 打开读入文件窗口
      *
      * @beta
+     * @param filenameExtensions - 文件扩展名
      * @returns File 格式文件
      */
-    openReadFileDialog(): Promise<File | undefined>;
+    openReadFileDialog(filenameExtensions?: string | Array<string>): Promise<File | undefined>;
     /**
      * 保存文件
      *
@@ -9363,7 +9731,7 @@ declare class SYS_I18n {
      * @remarks
      * 可以使用 `${1}` 格式的占位符表示参数；
      *
-     * 语言优先级：当前显示语言 \> 系统默认语言 \> 数据集中第一个搜索到��包含该文本标签的语言 \> 文本标签(tag)
+     * 语言优先级：当前显示语言 \> 系统默认语言 \> 数据集中第一个搜索到的包含该文本标签的语言 \> 文本标签(tag)
      * @param tag - 文本标签，对应多语言文件键值对中的键
      * @param namespace - 文本命名空间，在扩展运行环境内默认为扩展的 UUID，否则为系统默认命名空间
      * @param language - 语言，`undefined` 为 EDA 当前的显示语言
@@ -9379,13 +9747,6 @@ declare class SYS_I18n {
      * @returns 语言
      */
     getCurrentLanguage(): Promise<string>;
-    /**
-     * 刷新当前语言环境
-     *
-     * @public
-     * @remarks 使扩展内部语言环境与 EDA 当前语言环境同步
-     */
-    flushCurrentLanguage(): Promise<void>;
     /**
      * 查询所有支持的语言
      *
@@ -9446,6 +9807,8 @@ declare class SYS_IFrame {
      *
      * @beta
      * @param htmlFileName - 需要加载的 HTML 文件在扩展包内的路径
+     * @param width - 内联框架窗口的宽度
+     * @param height - 内联框架窗口的高度
      */
     openIFrame(htmlFileName: string, width?: number, height?: number): Promise<void>;
     /**

package/package.json

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