@jlceda/pro-api-types 0.1.84 → 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;
     /**
      * 将图元转换为异步图元
      */
@@ -6349,7 +6656,7 @@ declare class PCB_Document {
      * 嘉立创 EDA 专业版 API 使用的均为数据原点；
      *
      * 如果返回的数据为 `{ canvasOriginOffsetX: 100, canvasOriginOffsetY: 200 }`，
-     * 则代表画布原点在数据原点的向右 100 单位且向上 200 单位的位��；
+     * 则代表画布原点在数据原点的向右 100 单位且向上 200 单位的位置；
      *
      * 此处的单位为数据层面单位，在跨度上等同于画布层面的 mil
      * @returns 画布原点相对于数据原点的偏移坐标
@@ -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 - 钻孔
@@ -7362,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>;
     /**
      * 删除器件
      *
@@ -7441,7 +7745,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 +8371,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 +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>;
 }
 
 /**
@@ -8316,7 +8641,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 +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 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 +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
@@ -8631,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
      *
@@ -8660,23 +9025,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 +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>;
     /**
      * 删除引脚
      *
@@ -8725,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>;
     /**
      * 获取引脚
      *
@@ -8763,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` 表示默认
@@ -9126,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 的返回结果
@@ -9251,7 +9601,7 @@ declare class SYS_FileManager {
      * 修改文档源码
      *
      * @beta
-     * @param source - 文档源码
+     * @param source - 文档源��
      * @returns 是否修改成功，如果输入的文档源码格式错误，将返回 `false` 的结果
      */
     setDocumentSource(source: string): Promise<boolean>;

package/package.json

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