@jlceda/pro-api-types 0.2.38 → 0.2.41

package/index.d.ts

@@ -498,7 +498,7 @@ declare global {
 	     * 搜索符号
 	     *
 	     * @beta
-	     * @param key - 搜索���键字
+	     * @param key - 搜索��键字
 	     * @param libraryUuid - 库 UUID，默认为系统库，可以使用 {@link LIB_LibrariesList} 内的接口获取
 	     * @param classification - 分类，默认为全部
 	     * @param symbolType - 符号类型，默认为全部
@@ -1181,18 +1181,6 @@ declare global {
 	 *
 	 * @public
 	 */
-	enum EDMT_EditorTabEventTriggerCause {
-	    /** 切换标签页 */
-	    TOGGLE_TAB = "Toggle Tab",
-	    /** 关闭标签页 */
-	    CLOSE_TAB = "Close Tab",
-	    /** 打开文档 */
-	    OPEN_DOCUMENT = "Open Document",
-	    /** 打开工程 */
-	    OPEN_PROJECT = "Open Project",
-	    /** 关闭工程 */
-	    CLOSE_PROJECT = "Close Project"
-	}
 	/**
 	 * 文档树 / 事件类
 	 *
@@ -1221,7 +1209,6 @@ declare global {
 	     * @param onlyOnce - 是否仅监听一次
 	     */
 	    addEditorTabEventListener(id: string, eventType: 'all' | EDMT_EditorTabEventType, callFn: (eventType: EDMT_EditorTabEventType, props: {
-	        triggerCause: EDMT_EditorTabEventTriggerCause;
 	        documentType: EDMT_EditorDocumentType;
 	        title: string;
 	        tabId: string;
@@ -5281,7 +5268,7 @@ declare global {
 	     *
 	     * 注意：本接口需要启用 **团队库 \> 下载库** 权限，没有权限调用将始终 `throw Error`
 	     * @param symbolUuid - 符号 UUID 或符号 UUID 列表
-	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
+	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取，如若不传入，则为系统库
 	     * @returns 符号文件数据，`undefined` 表示数据获取失败
 	     */
 	    getSymbolFileBySymbolUuid(symbolUuid: string | Array<string>, libraryUuid?: string, fileType?: 'elibz' | 'elibz2'): Promise<File | undefined>;
@@ -5294,7 +5281,7 @@ declare global {
 	     *
 	     * 注意：本接口需要启用 **团队库 \> 下载库** 权限，没有权限调用将始终 `throw Error`
 	     * @param footprintUuid - 封装 UUID 或封装 UUID 列表
-	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
+	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取，如若不传入，则为系统库
 	     * @returns 封装文件数据，`undefined` 表示数据获取失败
 	     */
 	    getFootprintFileByFootprintUuid(footprintUuid: string | Array<string>, libraryUuid?: string, fileType?: 'elibz' | 'elibz2'): Promise<File | undefined>;
@@ -5307,7 +5294,7 @@ declare global {
 	     *
 	     * 注意：本接口需要启用 **团队模块 \> 下载模块** 权限，没有权限调用将始终 `throw Error`
 	     * @param cbbUuid - 复用模块 UUID
-	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
+	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取，如若不传入，则为系统库
 	     * @param fileName - 复用模块名
 	     * @param password - 加密密码
 	     * @returns 复用模块文件数据，`undefined` 表示数据获取失败
@@ -5328,7 +5315,7 @@ declare global {
 	     *
 	     * 注意：本接口需要启用 **团队库 \> 下载库** 权限，没有权限调用将始终 `throw Error`
 	     * @param panelLibraryUuid - 面板库 UUID 或面板库 UUID 列表
-	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
+	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取，如若不传入，则为系统库
 	     * @returns 面板库文件数据，`undefined` 表示数据获取失败
 	     */
 	    getPanelLibraryFileByPanelLibraryUuid(panelLibraryUuid: string | Array<string>, libraryUuid?: string, fileType?: 'elibz' | 'elibz2'): Promise<File | undefined>;
@@ -7048,7 +7035,7 @@ declare global {
 	     * 获取所有圆弧线的图元 ID
 	     *
 	     * @beta
-	     * @param net - ���络名称
+	     * @param net - 网络名称
 	     * @param layer - 层
 	     * @param primitiveLock - 是否锁定
 	     * @returns 圆弧线的图元 ID 数组
@@ -7682,7 +7669,7 @@ declare global {
 	     */
 	    setState_Reverse(reverse: boolean): IPCB_PrimitiveString;
 	    /**
-	     * 设置属性状态：反相扩展
+	     * ��置属性状态：反相扩展
 	     *
 	     * @beta
 	     * @param expansion - 反相扩展
@@ -8280,7 +8267,7 @@ declare global {
 	     * 在 PCB 画布中创建图元
 	     *
 	     * @internal
-	     * @remarks 覆��填充图元不支持新建，本接口调用将不会有任何效果
+	     * @remarks 覆铜填充图元不支持新建，本接口调用将不会有任何效果
 	     * @returns 覆铜填充图元对象
 	     */
 	    create(): IPCB_PrimitivePoured;
@@ -10425,7 +10412,7 @@ declare global {
 	     *
 	     * @beta
 	     * @remarks
-	     * 本接口模拟前端点击放置按钮，指定的器件将绑定到当前鼠标，并在用户后续点击时���置于画布
+	     * 本接口模拟前端点击放置按钮，指定的器件将绑定到当前鼠标，并在用户后续点击时放置于画布
 	     *
 	     * 本接口的返回时机并不会等待用户的放置操作，一旦器件被绑定到鼠标，本接口将立即返回 `true` 的结果
 	     * @param component - 关联库器件
@@ -11014,7 +11001,7 @@ declare global {
 	     * 获取所有尺寸标注的图元 ID
 	     *
 	     * @beta
-	     * @param layer - 层
+	     * @param layer - ���
 	     * @param primitiveLock - 是否锁定
 	     * @returns 尺寸标注的图元 ID 数组
 	     */
@@ -12594,7 +12581,7 @@ declare global {
 	     * 如若达成下单条件，将返回 `true` 并在新标签页打开下单页面
 	     * @param ignoreWarning - 在非交互式检查时忽略警告
 	     *
-	     * 如果设置为 `true`，将会忽���所有检查警告项并尽可能生成下单资料；
+	     * 如果设置为 `true`，将会忽略所有检查警告项并尽可能生成下单资料；
 	     *
 	     * 如果设置为 `false`，存在任意警告将中断执行并返回 `false` 的结果
 	     * @returns 是否通过下单检查
@@ -13097,7 +13084,7 @@ declare global {
 	     * @param bold - 是否加粗
 	     * @param italic - 是否斜体
 	     * @param underLine - 是否加下划线
-	     * @param alignMode - 对齐模式，`0` 左顶，`1` 中顶，`2` 右顶，`3` 左中，`4` 中中，`5` 右中，`6` 左底，`7` 中底，`8` 右底
+	     * @param alignMode - 对齐模式
 	     * @returns 文本图元对象
 	     */
 	    create(x: number, y: number, content: string, rotation?: number, textColor?: string | null, fontName?: string | null, fontSize?: number | null, bold?: boolean, italic?: boolean, underLine?: boolean, alignMode?: ESCH_PrimitiveTextAlignMode): Promise<ISCH_PrimitiveText | undefined>;
@@ -14346,7 +14333,7 @@ declare global {
 	     */
 	    toSync(): ISCH_PrimitiveCircle;
 	    /**
-	     * 查询图元是否为异��图元
+	     * 查询图元是否为异步图元
 	     *
 	     * @public
 	     * @returns 是否为异步图元
@@ -15400,7 +15387,7 @@ declare global {
 	     */
 	    getState_Manufacturer(): string | undefined;
 	    /**
-	     * 获取属性���态：制造商编号
+	     * 获取属性状态：制造商编号
 	     *
 	     * @public
 	     * @returns 制造商编号
@@ -15886,7 +15873,7 @@ declare global {
 	     * @beta
 	     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
 	     * @param primitiveIds - 器件的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
-	     * @returns 器件图元对象，空数组表示获取失败
+	     * @returns 器件图元对象���空数组表示获取失败
 	     */
 	    get(primitiveIds: Array<string>): Promise<Array<ISCH_PrimitiveComponent>>;
 	    /**
@@ -16449,7 +16436,7 @@ declare global {
 	     * 在原理图画布中创建图元
 	     *
 	     * @internal
-	     * @returns 器件图���对象
+	     * @returns 器件图元对象
 	     */
 	    create(): Promise<ISCH_PrimitiveCbbSymbolComponent>;
 	    /**
@@ -17031,7 +17018,7 @@ declare global {
 	     * @param cornerRadius - 圆角半径
 	     * @param rotation - 旋转角度，绕左上点旋转，可选 `0` `90` `180` `270`
 	     * @param color - 颜色，`null` 表示默认
-	     * @param fillColor - 填充颜色，`none` 表示无填充，`null` 表示默认
+	     * @param fillColor - 填充颜色，`none` 表示无��充，`null` 表示默认
 	     * @param lineWidth - 线宽，范围 `1-10`，`null` 表示默认
 	     * @param lineType - 线型，`null` 表示默认
 	     * @param fillStyle - 填充样式，`null` 表示默认
@@ -17575,7 +17562,7 @@ declare global {
 	     */
 	    toSync(): ISCH_PrimitiveWire;
 	    /**
-	     * 查询��元是否为异步图元
+	     * 查询图元是否为异步图元
 	     *
 	     * @public
 	     * @returns 是否为异步图元
@@ -17833,8 +17820,9 @@ declare global {
 	    onFilterClick?: (data: string) => void;
 	    onChange?: (data: string) => void;
 	    onAddClick?: (data: string) => void;
+	    onBlur?: (data: string) => void;
 	}
-	function Input({ width, disabled, readonly, clearBtn, clickBtn, dropDownList, searchBtn, value: propValue, placeholder, preText, type, otherAttr, testVal, onClick, onSearchClick, onFilterClick, onChange, onAddClick, }: InputProps): react_jsx_runtime.JSX.Element;
+	function Input({ width, disabled, readonly, clearBtn, clickBtn, dropDownList, searchBtn, value: propValue, placeholder, preText, type, otherAttr, testVal, onClick, onSearchClick, onFilterClick, onChange, onAddClick, onBlur, }: InputProps): react_jsx_runtime.JSX.Element;
 
 	interface TextProps {
 	    value: string;
@@ -17967,12 +17955,12 @@ declare global {
 	    maxDragX?: number;
 	    maxDragY?: number;
 	    hide?: boolean;
-	    resizingX?: boolean;
-	    resizingY?: boolean;
+	    resizeX?: boolean;
+	    resizeY?: boolean;
 	    children?: React$1.ReactNode;
 	    onMoved?: (top: number, left: number) => void;
 	}
-	function Modal({ top, left, width, height, maxDragX, maxDragY, hide, overlay, resizingX, resizingY, children, onMoved, }: ModalProps): react_jsx_runtime.JSX.Element;
+	function Modal({ top, left, width, height, maxDragX, maxDragY, hide, overlay, resizeX, resizeY, children, onMoved, }: ModalProps): react_jsx_runtime.JSX.Element;
 
 	interface DialogProps {
 	    title: string;
@@ -17984,8 +17972,8 @@ declare global {
 	    overlay?: boolean;
 	    maxDragY?: number;
 	    modal?: boolean;
-	    resizingX?: boolean;
-	    resizingY?: boolean;
+	    resizeX?: boolean;
+	    resizeY?: boolean;
 	    buttons?: ButtonProps[];
 	    onClose?: () => void;
 	    children?: React$1.ReactNode;
@@ -18103,7 +18091,7 @@ declare global {
 	     */
 	    useEffect: (effect: () => undefined | (() => undefined), deps?: React.DependencyList) => void;
 	    /**
-	     * 创建并返回指定类型的新 React 元素
+	     * ��建并返回指定类型的新 React 元素
 	     * @param type - 元素类型
 	     * @param props - 元素属性
 	     * @param children - 子元素
@@ -18577,13 +18565,13 @@ declare global {
 	     * 打开读入文件窗口
 	     *
 	     * @beta
-	     * @param filenameExtensions - 文件��展名
+	     * @param filenameExtensions - 文件扩展名
 	     * @param multiFiles - 是否允许读取多文件
 	     * @returns File 格式文件
 	     */
 	    openReadFileDialog(filenameExtensions?: string | Array<string>, multiFiles?: false): Promise<File | undefined>;
 	    /**
-	     * 打开读入文件夹窗口
+	     * 打��读入文件夹窗口
 	     *
 	     * @alpha
 	     * @remarks 本接口的浏览器支持有限，具体请参考 {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/webkitdirectory | MDN}
@@ -18955,8 +18943,6 @@ declare global {
 	     *
 	     * @beta
 	     * @remarks
-	     * 系统顶部菜单一旦新增无法有效删除，需要重启嘉立创 EDA 软件才可以恢复
-	     *
 	     * 本接口需要在系统已有的系统一级菜单下新增子菜单，无法新增和修改一级菜单，`id` 数组请至少传递 `2` 个值
 	     *
 	     * 本接口将会强制新建的系统顶部菜单的 ID 包含扩展 UUID，例如输入的 `id = 'example'`，将会被自动重写为 `e143d88179874e7f851cc890cd22fc71|example`，后续如需移除该菜单，请输入重写后的名称
@@ -18971,7 +18957,7 @@ declare global {
 	     * @param env - 环境
 	     * @param id - 菜单项 ID 树，将会按照数组顺序按层级匹配菜单项，并将数组最后一位作为插入的菜单项的 ID
 	     * @param props - 其它参数
-	     * @returns 顶部菜单项的 ID 数组，分隔线是否插入并不会影响操作结果的返回值
+	     * @returns 顶部菜单项的 ID，分隔线是否插入并不会影响操作结果的返回值，不包含 menuItems 中的子项的 ID
 	     */
 	    insertSystemHeaderMenuItem(env: ESYS_HeaderMenuEnvironment, id: Array<string>, props: {
 	        /** 菜单项的标题 */
@@ -19580,7 +19566,7 @@ declare global {
 	     * @public
 	     * @param message - 消息内容
 	     * @param messageType - 消息类型
-	     * @param timer - 自动关闭���计时秒数，`0` 为不自动关闭
+	     * @param timer - 自动关闭倒计时秒数，`0` 为不自动关闭
 	     * @param bottomPanel - 展开底部信息面板
 	     * @param buttonTitle - 回调按钮标题
 	     * @param buttonCallbackFn - 回调函数内容，字符串形式，会被自动解析并执行
@@ -20085,7 +20071,7 @@ declare global {
 	 * 系统 / 定时器类
 	 *
 	 * @public
-	 * @remarks 设置���时器
+	 * @remarks 设置定时器
 	 */
 	class SYS_Timer {
 	    /** 扩展 UUID */
@@ -20099,7 +20085,7 @@ declare global {
 	     * 设置循环定时器
 	     *
 	     * @public
-	     * @remarks 如果遇到 ID 重复的定时器，则之前设置的定时器将被清除
+	     * @remarks 如果遇到 ID 重复的定时器，��之前设置的定时器将被清除
 	     * @param id - 定时器 ID，用于定位&删除定时器
 	     * @param timeout - 定时时间，单位 ms
 	     * @param callFn - 定时调用函数

package/package.json

@@ -1 +1 @@
-{ "name": "@jlceda/pro-api-types", "type": "module", "version": "0.2.38", "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.41", "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" } }