@jlceda/pro-api-types 0.1.76 → 0.1.77

package/README.en.md

@@ -10,7 +10,7 @@ JLCEDA & EasyEDA Pro Edition Extension API Interface Type Definition
 
 It is recommended to use [pro-api-sdk](https://github.com/easyeda/pro-api-sdk) for extension development, this definition file is pre-configured within the SDK.
 
-1. 安装类型定义
+1. Install type definition
 
     ```shell
     npm install --save-dev @jlceda/pro-api-types

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 将会获取当前打开且拥有最后输入焦点的原理图图页的详细属性
@@ -2110,7 +2110,7 @@ declare interface ILIB_PanelLibraryItem {
     libraryUuid: string;
     /** 面板库名称 */
     name: string;
-    /** 分�� */
+    /** 分类 */
     classification?: ILIB_ClassificationIndex;
     /** 描述 */
     description?: string;
@@ -2270,7 +2270,7 @@ declare interface IPCB_LayerItem {
     type: EPCB_LayerType;
     /** 颜色（RGB HEX 格式） */
     color: string;
-    /** ��明度（%） */
+    /** 透明度（%） */
     transparency: number;
 }
 
@@ -3273,7 +3273,7 @@ declare class IPCB_PrimitivePolyline implements IPCB_Primitive {
 declare interface IPCB_PrimitiveSolderMaskAndPasteMaskExpansion {
     /** 顶层阻焊扩展 */
     topSolderMask?: number;
-    /** 底��阻焊扩展 */
+    /** 底层阻焊扩展 */
     bottomSolderMask?: number;
     /** 顶层助焊扩展 */
     topPasteMask?: number;
@@ -3693,7 +3693,7 @@ declare class ISCH_PrimitiveComponent implements ISCH_Primitive {
     private manufacturer?;
     /** Component 属性：制造商编号 */
     private manufacturerId?;
-    /** Component 属性：供应商 */
+    /** Component ���性：供应商 */
     private supplier?;
     /** Component 属性：供应商编号 */
     private supplierId?;
@@ -3960,7 +3960,7 @@ declare class ISCH_PrimitiveRectangle implements ISCH_Primitive {
     private height;
     /** 圆角半径 */
     private cornerRadius;
-    /** 旋���角度 */
+    /** 旋��角度 */
     private rotation;
     /** 边框颜色 */
     private color;
@@ -4620,7 +4620,7 @@ declare class LIB_Device {
      */
     getByLcscIds<T extends boolean>(lcscIds: string, libraryUuid?: string, allowMultiMatch?: T): Promise<T extends true ? ILIB_DeviceSearchItem | undefined : Array<ILIB_DeviceSearchItem>>;
     /**
-     * 使用立创 C 编号批量获取器件
+     * ���用立创 C 编号批量获取器件
      *
      * @beta
      * @remarks
@@ -5113,7 +5113,7 @@ declare class PCB_Drc {
      * @param ruleConfiguration - 设计规则配置
      * @param configurationName - 配置名称
      * @param allowOverwrite - 是否允许覆写同名设计规则配置，`false` 则将在遇到同名设计规则配置时返回 `false`，请注意可能的数据丢失风险
-     * @returns 保存是否成功
+     * @returns 保���是否成功
      */
     saveRuleConfiguration(ruleConfiguration: {
         [key: string]: any;
@@ -5895,7 +5895,7 @@ declare class PCB_PrimitiveArc implements IPCB_PrimitiveAPI {
      */
     create(net: string, layer: TPCB_LayersOfLine, startX: number, startY: number, endX: number, endY: number, arcAngle: number, lineWidth?: number, interactiveMode?: EPCB_PrimitiveArcInteractiveMode, primitiveLock?: boolean): Promise<IPCB_PrimitiveArc | undefined>;
     /**
-     * ���除圆弧线
+     * 删除圆弧线
      *
      * @beta
      * @param primitiveIds - 圆弧线的图元 ID 或圆弧线图元对象
@@ -6659,7 +6659,7 @@ declare class PNL_Document {
      * 保存文档
      *
      * @beta
-     * @returns 保存操作是否成功，保存失败、上传���败等错误均返回 `false`
+     * @returns 保存操作是否成功，保存失败、上传失败等错误均返回 `false`
      */
     save(): Promise<boolean>;
 }
@@ -7081,7 +7081,7 @@ declare class SCH_PrimitiveComponent implements ISCH_PrimitiveAPI {
      *
      * @beta
      * @param componentUuid - 器件 UUID
-     * @param libraryPath - 库路���，默认为系统库
+     * @param libraryPath - 库路径，默认为系统库
      * @returns 操作是否成功
      */
     setNetFlagComponentUuid_ProtectGround(componentUuid: string, libraryPath?: string): Promise<boolean>;
@@ -7439,7 +7439,7 @@ declare class SCH_PrimitiveRectangle implements ISCH_PrimitiveAPI {
      * 获取矩形
      *
      * @public
-     * @param primitiveIds - 矩形的���元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+     * @param primitiveIds - 矩形的��元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
      * @returns 矩形图元对象
      */
     get(primitiveIds: string): Promise<ISCH_PrimitiveRectangle | undefined>;
@@ -7797,7 +7797,7 @@ declare class SYS_FileManager {
      */
     getFootprintFileByFootprintUuid(footprintUuid: string | Array<string>, libraryUuid?: string): Promise<File | undefined>;
     /**
-     * 使用复用模块 UUID ��取复用模块文件
+     * 使用复用模块 UUID 获取复用模块文件
      *
      * @beta
      * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
@@ -8235,13 +8235,14 @@ declare class SYS_Timer {
      * 设置循环定时器
      *
      * @public
+     * @remarks 如果遇到 ID 重复的定时器，则之前设置的定时器将被清除
      * @param id - 定时器 ID，用于定位&删除定时器
      * @param timeout - 定时时间，单位 ms
      * @param callFn - 定时调用函数
-     * @param argument - 传给定时调用函数的参数
+     * @param args - 传给定时调用函数的参数
      * @returns 定时器是否设置成功
      */
-    setIntervalTimer(id: string, timeout: number, callFn: (argument: any) => void, argument?: any): boolean;
+    setIntervalTimer(id: string, timeout: number, callFn: (...args: any) => void, ...args: any): boolean;
     /**
      * 清除指定循环定时器
      *
@@ -8254,12 +8255,22 @@ declare class SYS_Timer {
      * 设置单次定时器
      *
      * @public
+     * @remarks 如果遇到 ID 重复的定时器，则之前设置的定时器将被清除
+     * @param id - 定时器 ID
      * @param timeout - 定时时间，单位 ms
      * @param callFn - 定时调用函数
-     * @param argument - 传给定时调用函数的参数
+     * @param args - 传给定时调用函数的参数
      * @returns 定时器是否设置成功
      */
-    setTimeoutTimer(timeout: number, callFn: (argument: any) => void, argument?: any): boolean;
+    setTimeoutTimer(id: string, timeout: number, callFn: (...args: any) => void, ...args: any): boolean;
+    /**
+     * 清除指定单次定时器
+     *
+     * @public
+     * @param id - 定时器 ID
+     * @returns 定时器是否清除成功
+     */
+    clearTimeoutTimer(id: string): boolean;
 }
 
 /**
@@ -8295,7 +8306,7 @@ declare class SYS_Unit {
      *
      * @public
      * @param mil - 输入密尔数
-     * @param numberOfDecimals - 保留小��位数，默认为 `4`
+     * @param numberOfDecimals - 保留小数位数，默认为 `4`
      * @returns 输出毫米数
      */
     milToMm(mil: number, numberOfDecimals?: number): number;
@@ -8594,7 +8605,7 @@ declare type TPCB_PolygonSourceArray = Array<'L' | 'ARC' | 'CARC' | 'C' | 'R' |
  * @remarks
  * 尺寸标注坐标集存在以下三种 {@link EPCB_PrimitiveDimensionType | 尺寸标注类型}：
  *
- * ① 半径标注
+ * ① 半���标注
  *
  * `[x1, y1, x2, y2, x3, y3]`
  *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jlceda/pro-api-types",
-	"version": "0.1.76",
+	"version": "0.1.77",
 	"description": "嘉立创EDA & EasyEDA 专业版扩展 API 接口类型定义",
 	"typings": "index.d.ts",
 	"keywords": [
@@ -30,11 +30,11 @@
 		"eslint-plugin-tsdoc": "^0.3.0",
 		"fast-text-encoding": "^1.0.6",
 		"fs-extra": "^11.2.0",
-		"husky": "^9.1.4",
-		"lint-staged": "^15.2.9",
+		"husky": "^9.1.6",
+		"lint-staged": "^15.2.10",
 		"prettier": "^3.3.3",
 		"ts-node": "^10.9.2",
-		"typescript": "^5.5.4"
+		"typescript": "^5.6.2"
 	},
 	"lint-staged": {
 		"*.ts": "eslint --cache --fix",