@jlceda/pro-api-types 0.2.28 → 0.2.29

package/index.d.ts

@@ -1624,7 +1624,7 @@ declare global {
 	    /**
 	     * 获取 EDA 前端数据单位跨度
 	     *
-	     * @alpha
+	     * @beta
 	     * @remarks 此处指的是前端用户可以切换的单位，需要同时兼容原理图和 PCB 画布
 	     * @returns 单位
 	     */
@@ -3361,7 +3361,7 @@ declare global {
 	     * 即 `setCanvasOrigin(0, 0)`；
 	     *
 	     * 此处的单位为数据层面单位，在跨度上等同于画布层面的 mil
-	     * @param offsetX - 画布原点相对于数据原点的 X 坐标偏移
+	     * @param offsetX - 画布原点相对���数据原点的 X 坐标偏移
 	     * @param offsetY - 画布原点相对于数据原点的 Y 坐标偏移
 	     * @returns 操作是否成功
 	     */
@@ -5120,7 +5120,7 @@ declare global {
 	     * @beta
 	     * @param templateFile - BOM 模板文件
 	     * @param template - BOM 模板名称，如若为 `undefined` 则自动从 `templateFile` 中取值
-	     * @returns BOM 模板��称
+	     * @returns BOM 模板名称
 	     * @example
 	     * ```javascript
 	     * // 从文件选择器读取模板文件
@@ -5989,7 +5989,7 @@ declare global {
 	     */
 	    unhighlightNet(net: string): Promise<boolean>;
 	    /**
-	     * 取消高亮所���网络
+	     * 取消高亮所��网络
 	     *
 	     * @beta
 	     * @returns 操作是否成功
@@ -7125,7 +7125,7 @@ declare global {
 	     * 获取文本
 	     *
 	     * @alpha
-	     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图���对象
+	     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图��对象
 	     * @param primitiveIds - 文本的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
 	     * @returns 文本图元对象，空数组表示获取失败
 	     */
@@ -8882,7 +8882,7 @@ declare global {
 	     */
 	    getState_Polygon(): IPCB_Polygon;
 	    /**
-	     * 获���属性状态：线宽
+	     * 获��属性状态：线宽
 	     *
 	     * @public
 	     * @returns 线宽
@@ -9974,7 +9974,7 @@ declare global {
 	     * 将异步图元重置为当前画布状态
 	     *
 	     * @internal
-	     * @remarks 本器件焊盘图元属性不支持修��，本接口调用将不会有任何效果
+	     * @remarks 本器件焊盘图元属性不支持修改，本接口调用将不会有任何效果
 	     * @returns 器件焊盘图元对象
 	     */
 	    reset(): Promise<IPCB_PrimitiveComponentPad>;
@@ -11567,6 +11567,37 @@ declare global {
 	    done(): Promise<IPCB_PrimitiveObject>;
 	}
 
+	/**
+	 * PCB & 封装 / 光线追踪引擎类
+	 *
+	 * @public
+	 * @remarks 控制光线追踪引擎的对接和交互
+	 */
+	class PCB_RayTracerEngine {
+	    /** 扩展 UUID */
+	    private extensionUuid?;
+	    /**
+	     * @internal
+	     * @param extensionUuid - 扩展 UUID
+	     */
+	    constructor(extensionUuid?: string);
+	    /**
+	     * 初始化光线追踪引擎
+	     *
+	     * @alpha
+	     * @param lut - 材质查找表
+	     */
+	    init(lut: Array<{
+	        [key: string]: any;
+	    }>): Promise<void>;
+	    /**
+	     * 停止光线追踪引擎
+	     *
+	     * @alpha
+	     */
+	    dispose(): Promise<void>;
+	}
+
 	/**
 	 * PCB & 封装 / 选择控制类
 	 *
@@ -14415,7 +14446,7 @@ declare global {
 	 *
 	 * @public
 	 * @remarks
-	 * 器件引脚图元是一个特殊���图元，它指的是在原理图画布上关联到符号的引脚
+	 * 器件引脚图元是一个特殊的图元，它指的是在原理图画布上关联到符号的引脚
 	 *
 	 * 器件引脚图元仅可更改 `pinNumber`、`noConnected` 属性，其它所有属性均为只读，
 	 * 并且你只能通过 {@link SCH_PrimitiveComponent.getAllPinsByPrimitiveId | 器件类的 getAllPinsByPrimitiveId 方法} 或 {@link ISCH_PrimitiveComponent.getAllPins | 器件图元的 getAllPins 方法} 获取到器件引脚图元
@@ -14825,7 +14856,7 @@ declare global {
 	     *
 	     * 本接口的返回时机并不会等待用户的放置操作，一旦器件被绑定到鼠标，本接口将立即返回 `true` 的结果
 	     * @param component - 关联库器件
-	     * @returns 是否找到器件
+	     * @returns 是否找��器件
 	     */
 	    placeComponentWithMouse(component: {
 	        libraryUuid: string;
@@ -18069,7 +18100,7 @@ declare global {
 	     *
 	     * @beta
 	     * @param options -
-	     * 选项列表，可以为字符串数组或对象数组，在未指定 `defaultOption` 时，默认值���列表的第一项；
+	     * 选项列表，可以为字符串数组或对象数组，在未指定 `defaultOption` 时，默认值为列表的第一项；
 	     *
 	     * 如若为字符串数组，则选项的值和选项的展示内容将保持一致；
 	     *
@@ -18557,7 +18588,7 @@ declare global {
 	    title: string;
 	    /** 菜单项图标 */
 	    icon?: string;
-	    /** 注册方法名称（需要在扩展入口文件导出该方法） */
+	    /** 注册方法名称（需要在扩展入���文件导出该方法） */
 	    registerFn?: string;
 	}
 	/**
@@ -20040,7 +20071,7 @@ declare global {
 	     * 获取当前主题
 	     *
 	     * @public
-	     * @remarks 获取当前 EDA 主题，**浅色** 或 **深色**
+	     * @remarks 获取当��� EDA 主题，**浅色** 或 **深色**
 	     * @returns 当前主题
 	     */
 	    getCurrentTheme(): Promise<ESYS_Theme>;
@@ -20123,6 +20154,7 @@ declare global {
 	    pcb_PrimitiveRegion: PCB_PrimitiveRegion;
 	    pcb_PrimitiveString: PCB_PrimitiveString;
 	    pcb_PrimitiveVia: PCB_PrimitiveVia;
+	    pcb_RayTracerEngine: PCB_RayTracerEngine;
 	    pcb_SelectControl: PCB_SelectControl;
 	    pnl_Document: PNL_Document;
 	    sch_Document: SCH_Document;

package/package.json

@@ -1 +1 @@
-{ "name": "@jlceda/pro-api-types", "type": "module", "version": "0.2.28", "description": "嘉立创EDA & EasyEDA 专业版扩展 API 接口类型定义", "typings": "index.d.ts", "author": "JLCEDA <support@lceda.cn>", "license": "Apache-2.0", "homepage": "https://pro.lceda.cn/", "keywords": ["jlceda", "pro-api"], "scripts": { "lint": "eslint", "fix": "eslint --fix", "build": "ts-node ./build/build.ts" }, "devDependencies": { "@antfu/eslint-config": "^5.4.1", "@types/fast-text-encoding": "^1.0.3", "@types/fs-extra": "^11.0.4", "dotenv": "^16.4.7", "eslint": "^9.37.0", "fast-text-encoding": "^1.0.6", "fs-extra": "^11.3.0", "lint-staged": "^16.2.3", "simple-git-hooks": "^2.13.1", "ts-node": "^10.9.2", "typescript": "^5.7.3" }, "simple-git-hooks": { "pre-commit": "npx lint-staged" }, "lint-staged": { "*": "eslint --fix" } }
+{ "name": "@jlceda/pro-api-types", "type": "module", "version": "0.2.29", "description": "嘉立创EDA & EasyEDA 专业版扩展 API 接口类型定义", "typings": "index.d.ts", "author": "JLCEDA <support@lceda.cn>", "license": "Apache-2.0", "homepage": "https://pro.lceda.cn/", "keywords": ["jlceda", "pro-api"], "scripts": { "lint": "eslint", "fix": "eslint --fix", "build": "ts-node ./build/build.ts" }, "devDependencies": { "@antfu/eslint-config": "^5.4.1", "@types/fast-text-encoding": "^1.0.3", "@types/fs-extra": "^11.0.4", "dotenv": "^16.4.7", "eslint": "^9.37.0", "fast-text-encoding": "^1.0.6", "fs-extra": "^11.3.0", "lint-staged": "^16.2.3", "simple-git-hooks": "^2.13.1", "ts-node": "^10.9.2", "typescript": "^5.7.3" }, "simple-git-hooks": { "pre-commit": "npx lint-staged" }, "lint-staged": { "*": "eslint --fix" } }