@jlceda/pro-api-types 0.1.83 → 0.1.84

package/index.d.ts

@@ -5686,7 +5686,7 @@ declare class LIB_Cbb {
      */
     get(cbbUuid: string, libraryUuid?: string): Promise<ILIB_CbbItem | undefined>;
     /**
-     * 复制复用���块
+     * 复制复用模块
      *
      * @beta
      * @param cbbUuid - 复用模块 UUID
@@ -6267,17 +6267,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>;
     /**
      * 保存文档
      *
@@ -6343,7 +6349,7 @@ declare class PCB_Document {
      * 嘉立创 EDA 专业版 API 使用的均为数据原点；
      *
      * 如果返回的数据为 `{ canvasOriginOffsetX: 100, canvasOriginOffsetY: 200 }`，
-     * 则代表画布原点在数据原点的向右 100 单位且向上 200 单位的位置；
+     * 则代表画布原点在数据原点的向右 100 单位且向上 200 单位的位��；
      *
      * 此处的单位为数据层面单位，在跨度上等同于画布层面的 mil
      * @returns 画布原点相对于数据原点的偏移坐标
@@ -6414,7 +6420,7 @@ declare class PCB_Drc {
     /**
      * 获取当前设计规则配置
      *
-     * @public
+     * @beta
      * @returns 当前设计规则配置，`undefined` 为获取失败
      */
     getCurrentRuleConfiguration(): Promise<{
@@ -6423,7 +6429,7 @@ declare class PCB_Drc {
     /**
      * 获取指定设计规则配置
      *
-     * @beta
+     * @public
      * @param configurationName - 配置名称
      * @returns 设计规则配置，`undefined` 为不存在该设计规则
      */
@@ -6456,6 +6462,7 @@ declare class PCB_Drc {
      * 重命名设计规则配置
      *
      * @beta
+     * @remarks 只有自定义配置可以重命名，系统配置不允许重命名
      * @param originalConfigurationName - 原设计规则配置名称
      * @param configurationName - 新设计规则配置名称
      * @returns 重命名是否成功
@@ -6465,6 +6472,7 @@ declare class PCB_Drc {
      * 删除设计规则配置
      *
      * @beta
+     * @remarks 系统配置不允许删除
      * @param configurationName - 配置名称
      * @returns 删除是否成功
      */
@@ -6480,6 +6488,7 @@ declare class PCB_Drc {
      * 设置为新建 PCB 默认设计规则配置
      *
      * @beta
+     * @remarks 返回值为结果导向，重复设置相同的设计规则为默认设计规则也将返回 `true`
      * @param configurationName - 配置名称
      * @returns 设置是否成功
      */
@@ -6928,7 +6937,7 @@ declare class PCB_ManufactureData {
      * @beta
      * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
      * @param fileName - 文件名
-     * @param colorSilkscreen - 是否生成彩色丝印制造文件（嘉立创专用文件）
+     * @param colorSilkscreen - 是否生成彩色丝印制造文件（嘉立���专用文件）
      * @param unit - 单位
      * @param digitalFormat - 数字格式
      * @param drilledHole - 钻孔
@@ -7432,9 +7441,10 @@ 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 */
 }
 
 /**
@@ -7854,7 +7864,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 +8043,7 @@ declare class PCB_SelectControl {
      *
      * @beta
      * @param primitiveIds - 图元 ID
+     * @returns 操作是否成功
      */
     doSelectPrimitives(primitiveIds: string | Array<string>): Promise<boolean>;
     /**
@@ -8043,16 +8054,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>;
+    /* Excluded from this release type: getCurrentMousePosition */
 }
 
 declare enum PIN_TYPE {
@@ -8304,7 +8316,7 @@ declare class SCH_PrimitiveArc implements ISCH_PrimitiveAPI {
      * 获取圆弧
      *
      * @beta
-     * @param primitiveIds - 圆弧的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @param primitiveIds - 圆弧的图元 ID，可以为字符串或字符串数组，如若为数组，则返回��也是数组
      * @returns 圆弧图元对象
      */
     get(primitiveIds: string): Promise<ISCH_PrimitiveArc | undefined>;
@@ -8541,17 +8553,17 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
      *
      * @beta
      * @param componentUuid - 关联库器件 UUID
+     * @param libraryPath - 库路
      * @param subLibraryId - 子库编号 part名称
      * @param x - 坐标 X
      * @param y - 坐标 Y
      * @param rotation - 旋转角度，可选 `0` `90` `180` `270`
      * @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(componentUuid: string, libraryPath: string, subLibraryId: string, x: number, y: number, rotation?: number, mirror?: boolean, addIntoBom?: boolean, addIntoPcb?: boolean): Promise<ISCH_PrimitiveComponent | undefined>;
     /**
      * 创建网络标识
      *
@@ -8647,6 +8659,7 @@ 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 获取器件的详细信息
      *
@@ -9057,6 +9070,7 @@ declare class SCH_SelectControl {
      *
      * @public
      * @param primitiveIds - 图元 ID
+     * @returns 操作是否成功
      */
     doSelectPrimitives(primitiveIds: string | Array<string>): Promise<boolean>;
     /**
@@ -9068,14 +9082,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 */
 }
 
 /**
@@ -9151,7 +9168,7 @@ declare class SYS_Environment {
      */
     isEasyEDAProEdition(): boolean;
     /**
-     * 是否为嘉立创EDA 专���版本
+     * 是否为嘉立创EDA 专业版本
      *
      * @public
      * @returns 是否为嘉立创EDA 专业版本
@@ -9298,9 +9315,10 @@ declare class SYS_FileSystem {
      * 打开读入文件窗口
      *
      * @beta
+     * @param filenameExtensions - 文件扩展名
      * @returns File 格式文件
      */
-    openReadFileDialog(): Promise<File | undefined>;
+    openReadFileDialog(filenameExtensions?: string | Array<string>): Promise<File | undefined>;
     /**
      * 保存文件
      *
@@ -9363,7 +9381,7 @@ declare class SYS_I18n {
      * @remarks
      * 可以使用 `${1}` 格式的占位符表示参数；
      *
-     * 语言优先级：当前显示语言 \> 系统默认语言 \> 数据集中第一个搜索到��包含该文本标签的语言 \> 文本标签(tag)
+     * 语言优先级：当前显示语言 \> 系统默认语言 \> 数据集中第一个搜索到的包含该文本标签的语言 \> 文本标签(tag)
      * @param tag - 文本标签，对应多语言文件键值对中的键
      * @param namespace - 文本命名空间，在扩展运行环境内默认为扩展的 UUID，否则为系统默认命名空间
      * @param language - 语言，`undefined` 为 EDA 当前的显示语言
@@ -9379,13 +9397,6 @@ declare class SYS_I18n {
      * @returns 语言
      */
     getCurrentLanguage(): Promise<string>;
-    /**
-     * 刷新当前语言环境
-     *
-     * @public
-     * @remarks 使扩展内部语言环境与 EDA 当前语言环境同步
-     */
-    flushCurrentLanguage(): Promise<void>;
     /**
      * 查询所有支持的语言
      *
@@ -9446,6 +9457,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.84",
 	"description": "嘉立创EDA & EasyEDA 专业版扩展 API 接口类型定义",
 	"typings": "index.d.ts",
 	"keywords": [