@jlceda/pro-api-types 0.2.27 → 0.2.29

package/index.d.ts

@@ -960,7 +960,7 @@ declare global {
 	     * @beta
 	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
 	     * @param libraryType - 库类型，支持符号和封装
-	     * @param uuid - 符号、��装 UUID
+	     * @param uuid - 符号、封��� UUID
 	     * @param splitScreenId - 分屏 ID，即 {@link DMT_EditorControl.getSplitScreenTree} 方法获取到的 {@link IDMT_EditorSplitScreenItem.id}
 	     * @returns 标签页 ID，如若为 `undefined`，则打开文档失败
 	     */
@@ -1392,7 +1392,7 @@ declare global {
 	     * @beta
 	     * @param projectFriendlyName - 工程友好名称
 	     * @param projectName - 工程名称，不可重复，仅支持字母 `a-zA-Z`、数字 `0-9`、中划线 `-`，如若不指定，则根据工程友好名称自动生成
-	     * @param teamUuid - 团队 UUID，如若不指定，则默认为个人；在不存在个人工程的环境下必须指定团队 UUID
+	     * @param teamUuid - 团队 UUID，如若不指定，则默认为个人；在不存在个人工程的环境下必须指定团�� UUID
 	     * @param folderUuid - 文件夹 UUID，如若不指定，则为根文件夹
 	     * @param description - 工程描述
 	     * @param collaborationMode - 工程协作模式，如若团队权限无需工程设置协作模式，则该参数将被忽略
@@ -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 操作是否成功
 	     */
@@ -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 线宽
@@ -11056,7 +11056,7 @@ declare global {
 	     * 获取属性状态：图元类型
 	     *
 	     * @public
-	     * @returns 图元类���
+	     * @returns 图元类型
 	     */
 	    getState_PrimitiveType(): EPCB_PrimitiveType;
 	    /**
@@ -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;
@@ -17473,13 +17504,13 @@ declare global {
 
 	interface ButtonProps {
 	    text?: string;
-	    disable?: boolean;
+	    disabled?: boolean;
 	    type?: 'default' | 'primary' | 'danger' | 'forbidden' | 'text';
 	    width?: number | 'responsive';
 	    icon?: IconProps;
 	    onClick?: () => void;
 	}
-	function Button({ text, disable, type, width, icon, onClick, }: ButtonProps): react_jsx_runtime.JSX.Element;
+	function Button({ text, disabled, type, width, icon, onClick, }: ButtonProps): react_jsx_runtime.JSX.Element;
 
 	interface ListChildren$1 {
 	    title: string;
@@ -17492,7 +17523,7 @@ declare global {
 	    width?: number;
 	    disabled?: boolean;
 	    readonly?: boolean;
-	    clearBtn?: boolean | 'keepAlive';
+	    clearBtn?: boolean;
 	    clickBtn?: boolean;
 	    dropDownList?: ListChildren$1[];
 	    searchBtn?: boolean;
@@ -17529,11 +17560,12 @@ declare global {
 	    color?: string;
 	    padding?: number[];
 	    margin?: number[];
-	    width?: number;
-	    height?: number;
+	    width?: number | '100%';
+	    height?: number | '100%';
 	    rotate?: number;
 	    cursor?: 'pointer' | 'default' | 'none' | 'move' | 'text';
 	    invisible?: boolean;
+	    display?: string;
 	}
 
 	interface FlexProps extends ContainerStyleProps {
@@ -17634,32 +17666,34 @@ declare global {
 	function TextArea({ disabled, value, width, height, resizable, placeholder, name, onChange, }: TextAreaProps): react_jsx_runtime.JSX.Element;
 
 	interface ModalProps {
-	    defaultTop: number;
-	    defaultLeft: number;
-	    defaultWidth: number;
-	    defaultHeight: number;
+	    top: number;
+	    left: number;
+	    width: number;
+	    height: number;
+	    overlay?: boolean;
 	    maxDragX?: number;
 	    maxDragY?: number;
 	    hide?: boolean;
 	    children?: React$1.ReactNode;
 	    onMoved?: (top: number, left: number) => void;
 	}
-	function Modal({ defaultTop, defaultLeft, defaultWidth, defaultHeight, maxDragX, maxDragY, hide, children, onMoved, }: ModalProps): react_jsx_runtime.JSX.Element;
+	function Modal({ top, left, width, height, maxDragX, maxDragY, hide, overlay, children, onMoved, }: ModalProps): react_jsx_runtime.JSX.Element;
 
-	interface DialogButtonProps {
-	    text: string;
-	    icon?: IconProps;
-	    width?: number;
-	    onClick?: () => void;
-	    type?: 'default' | 'primary' | 'danger' | 'forbidden' | 'text';
-	}
 	interface DialogProps {
 	    title: string;
-	    buttons?: DialogButtonProps[];
+	    width?: number;
+	    height?: number;
+	    left?: number;
+	    top?: number;
+	    hide?: boolean;
+	    overlay?: boolean;
+	    maxDragY?: number;
+	    modal?: boolean;
+	    buttons?: ButtonProps[];
 	    onClose?: () => void;
 	    children?: React$1.ReactNode;
 	}
-	function Dialog({ title, buttons, onClose, children }: DialogProps): react_jsx_runtime.JSX.Element;
+	function Dialog(props: DialogProps): react_jsx_runtime.JSX.Element;
 
 	interface SelectListItem {
 	    title: string;
@@ -18439,7 +18473,7 @@ declare global {
 	    /**
 	     * 转换 T/DISA 4001 库到单个嘉立创库文件
 	     *
-	     * @alpha
+	     * @beta
 	     * @param file - T/DISA 4001 库文件
 	     * @returns 嘉立创库文件
 	     */
@@ -18447,7 +18481,7 @@ declare global {
 	    /**
 	     * 转换 T/DISA 4001 库到多个嘉立创库文件（每个器件一个文件）
 	     *
-	     * @alpha
+	     * @beta
 	     * @param file - T/DISA 4001 库文件
 	     * @returns 多个嘉立创库文件
 	     */
@@ -18554,7 +18588,7 @@ declare global {
 	    title: string;
 	    /** 菜单项图标 */
 	    icon?: string;
-	    /** 注册方法名称（需要在扩展入口文件导出该方法） */
+	    /** 注册方法名称（需要在扩展入���文件导出该方法） */
 	    registerFn?: string;
 	}
 	/**
@@ -20037,7 +20071,7 @@ declare global {
 	     * 获取当前主题
 	     *
 	     * @public
-	     * @remarks 获取当前 EDA 主题，**浅色** 或 **深色**
+	     * @remarks 获取当��� EDA 主题，**浅色** 或 **深色**
 	     * @returns 当前主题
 	     */
 	    getCurrentTheme(): Promise<ESYS_Theme>;
@@ -20120,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.27", "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" } }