@jlceda/pro-api-types 0.2.20 → 0.2.24

package/index.d.ts

@@ -1,6 +1,5 @@
-import * as react from 'react';
-import react__default from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import React$1 from 'react';
 
 declare global {
 	/**
@@ -506,6 +505,17 @@ declare global {
 	     * @returns 标签页 ID，对应 {@link IDMT_EditorTabItem.tabId}，可使用 {@link DMT_EditorControl.getSplitScreenIdByTabId} 获取到分屏 ID
 	     */
 	    openInEditor(symbolUuid: string, libraryUuid: string, splitScreenId?: string): Promise<string | undefined>;
+	    /**
+	     * 获取符号渲染图
+	     *
+	     * @beta
+	     * @param symbol - 符号的索引
+	     * @returns 符号渲染图
+	     */
+	    getRenderImage(source: {
+	        symbolUuid: string;
+	        libraryUuid: string;
+	    }): Promise<Blob | undefined>;
 	}
 
 	/**
@@ -1380,7 +1390,7 @@ declare global {
 	     * @param projectFriendlyName - 工程友好名称
 	     * @param projectName - 工程名称，不可重复，仅支持字母 `a-zA-Z`、数字 `0-9`、中划线 `-`，如若不指定，则根据工程友好名称自动生成
 	     * @param teamUuid - 团队 UUID，如若不指定，则默认为个人；在不存在个人工程的环境下必须指定团队 UUID
-	     * @param folderUuid - 文件夹 UUID，如若不指定，则为根文件夹
+	     * @param folderUuid - 文件夹 UUID，如若不指定，则为根文��夹
 	     * @param description - 工程描述
 	     * @param collaborationMode - 工程协作模式，如若团队权限无需工程设置协作模式，则该参数将被忽略
 	     * @returns 工程 UUID，如若为 `undefined` 则创建失败
@@ -1605,17 +1615,9 @@ declare global {
 	 * 系统 / 单位类
 	 *
 	 * @public
-	 * @remarks 控制系统数据单位与单位转换基础函数，当前系统数据单位跨度等效为 `mil`
+	 * @remarks 控制系统数据单位与单位转换基础函数，当前原理图数据单位跨度等效为 `10mil` 或 `0.01inch`，PCB 数据单位跨度等效为 `mil`
 	 */
 	class SYS_Unit {
-	    /**
-	     * 获取 API 系统数据单位跨度
-	     *
-	     * @public
-	     * @remarks 当前 API 系统数据单位跨度等效为 `mil`，不会发生改变
-	     * @returns 单位
-	     */
-	    getSystemDataUnit(): ESYS_Unit.MIL;
 	    /**
 	     * 获取 EDA 前端数据单位跨度
 	     *
@@ -1877,7 +1879,7 @@ declare global {
 	     * @beta
 	     * @remarks 如希望清除某些属性，则将其的值设置为 `null`
 	     * @param cbbUuid - 复用模块 UUID
-	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取
+	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口��取
 	     * @param cbbName - 复用模块名称
 	     * @param classification - 分类
 	     * @param description - 描述
@@ -2504,6 +2506,17 @@ declare global {
 	     * @returns 标签页 ID，对应 {@link IDMT_EditorTabItem.tabId}，可使用 {@link DMT_EditorControl.getSplitScreenIdByTabId} 获取到分屏 ID
 	     */
 	    openInEditor(footprintUuid: string, libraryUuid: string, splitScreenId?: string): Promise<string | undefined>;
+	    /**
+	     * 获取封装渲染图
+	     *
+	     * @beta
+	     * @param footprint - 封装的索引
+	     * @returns 封装渲染图
+	     */
+	    getRenderImage(source: {
+	        footprintUuid: string;
+	        libraryUuid: string;
+	    }): Promise<Blob | undefined>;
 	}
 
 	/**
@@ -2865,7 +2878,7 @@ declare global {
 	     * 获取工程库的 UUID
 	     *
 	     * @public
-	     * @remarks 在未打开工程的情况下调用将返回 `undefined`
+	     * @remarks 在未打开工程的情况下调用将返�� `undefined`
 	     * @returns 工程库的 UUID
 	     */
 	    getProjectLibraryUuid(): Promise<string | undefined>;
@@ -4590,7 +4603,9 @@ declare global {
 	    /** Altium Designer */
 	    ALTIUM_DESIGNER = "Protel2",
 	    /** 数字化工业软件联盟 */
-	    DISA = "DISA"
+	    DISA = "DISA",
+	    /** 数字化工业软件联盟仿真 */
+	    DISA_SIMULATION = "DSNET"
 	}
 	/**
 	 * 导入工程导入选项
@@ -4724,7 +4739,7 @@ declare global {
 	     *
 	     * 注意：本接口需要启用 **团队库 \> 下载库** 权限，没有权限调用将始终 `throw Error`
 	     *
-	     * @param deviceUuid - ���件 UUID 或器件 UUID 列表
+	     * @param deviceUuid - 器件 UUID 或器件 UUID 列表
 	     * @param libraryUuid - 库 UUID，可以使用 {@link LIB_LibrariesList} 内的接口获取，如若不传入，则为系统库
 	     * @returns 器件文件数据，`undefined` 表示数据获取失败
 	     */
@@ -5566,14 +5581,14 @@ declare global {
 	    /**
 	     * 获取所有网络的详细信息
 	     *
-	     * @alpha
+	     * @beta
 	     * @returns 所有网络的详细信息
 	     */
 	    getAllNets(): Promise<Array<IPCB_NetInfo>>;
 	    /**
 	     * 获取指定网络的详细信息
 	     *
-	     * @alpha
+	     * @beta
 	     * @param net - 网络名称
 	     * @returns 网络的详细信息, `undefined` 为不存在该网络
 	     */
@@ -5604,7 +5619,7 @@ declare global {
 	    /**
 	     * 获取指定网络的颜色
 	     *
-	     * @alpha
+	     * @beta
 	     * @param net - 网络名称
 	     * @returns 网络颜色，`undefined` 为不存在该网络
 	     */
@@ -5612,7 +5627,7 @@ declare global {
 	    /**
 	     * 设置指定网络的颜色
 	     *
-	     * @alpha
+	     * @beta
 	     * @param net - 网络名称
 	     * @param color - 网络颜色
 	     * @returns 是否设置成功, `false` 为不存在该网络
@@ -5638,7 +5653,7 @@ declare global {
 	    /**
 	     * 取消选中网络
 	     *
-	     * @alpha
+	     * @beta
 	     * @param net - 网络名称
 	     * @returns 操作是否成功
 	     */
@@ -5646,7 +5661,7 @@ declare global {
 	    /**
 	     * 取消选中所有网络
 	     *
-	     * @alpha
+	     * @beta
 	     * @remarks 如果希望取消选中所有图元，请使用 {@link PCB_SelectControl.clearSelected} 接口
 	     * @returns 操作是否成功
 	     */
@@ -5672,7 +5687,7 @@ declare global {
 	    /**
 	     * 取消高亮所有网络
 	     *
-	     * @alpha
+	     * @beta
 	     * @returns 操作是否成功
 	     */
 	    unhighlightAllNets(): Promise<boolean>;
@@ -7800,7 +7815,7 @@ declare global {
 	     * 删除区域
 	     *
 	     * @beta
-	     * @param primitiveIds - 区域的图元 ID 或区域图元对象
+	     * @param primitiveIds - 区域的���元 ID 或区域图元对象
 	     * @returns 删除操作是否成功
 	     */
 	    delete(primitiveIds: string | IPCB_PrimitiveRegion | Array<string> | Array<IPCB_PrimitiveRegion>): Promise<boolean>;
@@ -11145,7 +11160,7 @@ declare global {
 	     *
 	     * @public
 	     * @param height - 高
-	     * @returns 二进���内嵌对象图元对象
+	     * @returns 二进制内嵌对象图元对象
 	     */
 	    setState_Height(height: number): IPCB_PrimitiveObject;
 	    /**
@@ -11799,6 +11814,38 @@ declare global {
 	        text: string;
 	        value: string;
 	    }>>;
+	    /**
+	     * 获取 BOM 模板列表
+	     *
+	     * @alpha
+	     * @returns BOM 模板列表
+	     */
+	    getBomTemplates(): Promise<Array<string>>;
+	    /**
+	     * 上传 BOM 模板文件
+	     *
+	     * @alpha
+	     * @param templateFile - BOM 模板文件
+	     * @param template - BOM 模板名称，如若为 `undefined` 则自动从 `templateFile` 中取值
+	     * @returns BOM 模板名称
+	     */
+	    uploadBomTemplateFile(templateFile: File, template?: string): Promise<string | undefined>;
+	    /**
+	     * 获取 BOM 模板文件
+	     *
+	     * @alpha
+	     * @param template - BOM 模板名称
+	     * @returns BOM 模板文件
+	     */
+	    getBomTemplateFile(template: string): Promise<File | undefined>;
+	    /**
+	     * 删除 BOM 模板
+	     *
+	     * @alpha
+	     * @param template - BOM 模板名称
+	     * @returns 操作是否成功
+	     */
+	    deleteBomTemplate(template: string): Promise<boolean>;
 	    /**
 	     * 获取 BOM 文件
 	     *
@@ -11907,6 +11954,86 @@ declare global {
 	    placeSmtComponentsOrder(interactive?: boolean, ignoreWarning?: boolean): Promise<boolean>;
 	}
 
+	/**
+	 * 工程网络属性
+	 *
+	 * @public
+	 */
+	interface ISCH_ProjectNetInfo {
+	    /** 原理图名称 */
+	    schematicName: string;
+	    /** 原理图 UUID */
+	    schematicUuid: string;
+	    /** 板子名称 */
+	    boardName: string;
+	    /** 网络 */
+	    nets: Array<ISCH_NetInfo>;
+	}
+	/**
+	 * 网络属性
+	 *
+	 * @public
+	 */
+	interface ISCH_NetInfo {
+	    /** 网络名称 */
+	    net: string;
+	    /** 导线 */
+	    wires: Array<ISCH_WireInfo>;
+	}
+	/**
+	 * 导线属性
+	 *
+	 * @public
+	 */
+	interface ISCH_WireInfo {
+	    /** 导线名称 */
+	    name: string;
+	    /** ID */
+	    id: string;
+	    /** 全局网络名 */
+	    globalNetName: string;
+	    /** 原理图图页名称 */
+	    pageName: string;
+	    /** 原理图图页 UUID */
+	    pageUuid: string;
+	}
+	/**
+	 * 原理图 & 符号 / 网络类
+	 *
+	 * @public
+	 */
+	class SCH_Net {
+	    /**
+	     * 获取当前工程下所有网络的详细信息
+	     *
+	     * @alpha
+	     * @returns 当前工程下所有网络的详细信息
+	     */
+	    getCurrentProjectAllNets(): Promise<Array<ISCH_ProjectNetInfo>>;
+	    /**
+	     * 获取所有网络的详细信息
+	     *
+	     * @alpha
+	     * @returns 所有网络的详细信息
+	     */
+	    getAllNets(): Promise<Array<ISCH_NetInfo>>;
+	    /**
+	     * 获取指定网络的详细信息
+	     *
+	     * @alpha
+	     * @param net - 网络名称
+	     * @returns 网络的详细信息, `undefined` 为不存在该网络
+	     */
+	    getNet(net: string): Promise<ISCH_NetInfo | undefined>;
+	    /**
+	     * 获取所有网络的网络名称
+	     *
+	     * @alpha
+	     * @returns 网络名称数组
+	     */
+	    getAllNetsName(): Promise<Array<string>>;
+	}
+
 	/**
 	 * 原理图 & 符号 / 网表类
 	 *
@@ -15274,6 +15401,7 @@ declare global {
 	    getState_Component(): {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    };
 	    /**
 	     * 获取属性状态：坐标 X
@@ -15340,6 +15468,7 @@ declare global {
 	    getState_Symbol(): {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    } | undefined;
 	    /**
 	     * 获取属性状态：关联库封装
@@ -15350,6 +15479,7 @@ declare global {
 	    getState_Footprint(): {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    } | undefined;
 	    /**
 	     * 获取属性状态：位号
@@ -15426,7 +15556,7 @@ declare global {
 	     */
 	    setState_Y(y: number): ISCH_PrimitiveComponent;
 	    /**
-	     * 设置属性状态：旋��角度
+	     * 设置属性状态：旋转角度
 	     *
 	     * @beta
 	     * @param rotation - 旋转角度
@@ -15614,6 +15744,7 @@ declare global {
 	    }, x: number, y: number, rotation?: number, mirror?: boolean, primitiveId?: string, symbol?: {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    }, designator?: string, name?: string);
 	    /**
 	     * 在原理图画布中创建图元
@@ -16670,29 +16801,6 @@ declare global {
 	    }, succeedCallFn?: (data: Response) => void | Promise<void>): Promise<Response>;
 	}
 
-	interface ImageStoreProps {
-	    src: string;
-	    width?: number;
-	    height?: number;
-	    title?: string;
-	}
-	type BoardStoreEvents$1 = {
-	    event: 'click';
-	    data: boolean;
-	};
-
-	interface BoardStoreProps {
-	    padding?: number[];
-	    bgColor?: string;
-	    width?: number;
-	    height?: number;
-	    title: string;
-	}
-	type BoardStoreEvents = {
-	    event: 'click';
-	    data: boolean;
-	};
-
 	type IconProps = {
 	    /** 模板名称 */
 	    iconClass: string;
@@ -16701,28 +16809,55 @@ declare global {
 	    iconUrl: string;
 	} | {};
 
-	interface ButtonStoreProps {
+	interface ButtonProps {
 	    text?: string;
 	    disable?: boolean;
 	    type?: 'default' | 'primary' | 'danger' | 'forbidden' | 'text';
 	    width?: number | 'responsive';
 	    icon?: IconProps;
+	    onClick?: () => void;
 	}
-	type ButtonStoreEvents = {
-	    event: 'click';
-	};
+	function Button({ text, disable, type, width, icon, onClick, }: ButtonProps): react_jsx_runtime.JSX.Element;
 
-	interface PanelStoreProps {
+	interface ListChildren$1 {
+	    title: string;
+	    value?: string;
+	    clearBtn?: boolean;
+	    children?: ListChildren$1[];
+	    selected?: boolean;
+	}
+	interface InputProps {
+	    width?: number;
+	    disabled?: boolean;
+	    readonly?: boolean;
+	    clearBtn?: boolean | 'keepAlive';
+	    clickBtn?: boolean;
+	    dropDownList?: ListChildren$1[];
+	    searchBtn?: boolean;
+	    value?: string;
+	    placeholder?: string;
+	    preText?: string;
+	    type: 'text' | 'telephone' | 'number' | 'password' | 'color' | 'email';
+	    otherAttr?: {
+	        [key: string]: string;
+	    };
+	    testVal?: string;
+	    onClick?: () => void;
+	    onSearchClick?: (data: string) => void;
+	    onFilterClick?: (data: string) => void;
+	    onChange?: (data: string) => void;
+	    onAddClick?: (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;
+
+	interface TextProps {
 	    value: string;
 	    fontFamily?: string;
 	    textAlign?: 'left' | 'center' | 'right';
 	    fontSize?: number;
 	    color?: string;
 	}
-	type PanelStoreEvents = {
-	    event: 'change';
-	    data: boolean;
-	};
+	function Text({ value, fontFamily, textAlign, fontSize, color, }: TextProps): react_jsx_runtime.JSX.Element;
 
 	interface ContainerStyleProps {
 	    backgroundColor?: string;
@@ -16736,149 +16871,92 @@ declare global {
 	    height?: number;
 	    rotate?: number;
 	    cursor?: 'pointer' | 'default' | 'none' | 'move' | 'text';
+	    invisible?: boolean;
 	}
 
-	interface FlexItemStoreProps extends ContainerStyleProps {
-	    flexRatio?: number;
-	}
-	type FlexItemStoreEvents = {
-	    event: 'change';
-	    data: boolean;
-	};
-
-	interface FlexStoreProps extends ContainerStyleProps {
+	interface FlexProps extends ContainerStyleProps {
 	    direction?: 'column' | 'column-reverse' | 'row' | 'row-reverse';
 	    alignX?: 'start' | 'center' | 'end';
 	    alignY?: 'start' | 'center' | 'end' | 'stretch';
 	    gap?: number;
 	    classes?: string[];
+	    children?: React$1.ReactNode;
+	    onClick?: () => void;
 	}
-	type FlexStoreEvents = {
-	    event: 'change';
-	    data: boolean;
-	};
-
-	interface ModalStoreProps {
-	    defaultTop: number;
-	    defaultLeft: number;
-	    defaultWidth: number;
-	    defaultHeight: number;
-	    maxDragX?: number;
-	    maxDragY?: number;
-	    hide?: boolean;
-	}
-	type ModalStoreEvents = {
-	    event: 'moved';
-	    top: number;
-	    left: number;
-	};
+	function Flex({ direction, alignX, alignY, gap, classes, children, onClick, ...styleProps }: FlexProps): react_jsx_runtime.JSX.Element;
 
-	interface GridSItemtoreProps extends ContainerStyleProps {
-	    colSpan?: number;
-	    rowSpan?: number;
-	    align?: 'start' | 'center' | 'end' | 'stretch';
+	interface FlexItemProps extends ContainerStyleProps {
+	    flexRatio?: number;
+	    children?: React$1.ReactNode;
+	    onClick?: () => void;
 	}
-	type CheckBoxStoreEvents$3 = {
-	    event: 'resize';
-	};
+	function FlexItem({ flexRatio, children, onClick, ...styleProps }: FlexItemProps): react_jsx_runtime.JSX.Element;
 
-	interface GridStoreProps extends ContainerStyleProps {
+	interface GridProps extends ContainerStyleProps {
 	    columns: number;
 	    rowGap?: number;
 	    colGap?: number;
+	    children?: React$1.ReactNode;
 	}
-	type CheckBoxStoreEvents$2 = {
-	    event: 'resize';
-	};
+	function Grid({ columns, rowGap, colGap, children, ...styleProps }: GridProps): react_jsx_runtime.JSX.Element;
 
-	interface ListChildren$1 {
+	interface GridItemProps extends ContainerStyleProps {
+	    colSpan?: number;
+	    rowSpan?: number;
+	    align?: 'start' | 'center' | 'end' | 'stretch';
+	    children?: React$1.ReactNode;
+	}
+	function GridItem({ colSpan, rowSpan, align, children, ...styleProps }: GridItemProps): react_jsx_runtime.JSX.Element;
+
+	interface ListChildren {
 	    title: string;
 	    id?: string;
 	    clearBtn?: boolean;
-	    children?: ListChildren$1[];
+	    children?: ListChildren[];
 	    childrenCollapse?: boolean;
 	    selected?: boolean;
-	    icon?: IconProps;
+	    icons?: IconProps[];
 	}
 	interface ListProps {
 	    width?: number;
 	    height?: number;
-	    list: ListChildren$1[];
+	    list: ListChildren[];
 	    itemHeight?: number;
 	    border?: boolean;
 	    expandEnable?: boolean;
+	    onItemClick?: (id: string) => void;
+	    onItemDblclick?: (id: string) => void;
+	    onItemContextmenu?: (id: string) => void;
 	}
-	type ListStoreEvents = {
-	    event: 'item-click';
-	    data: string;
-	} | {
-	    event: 'item-dblclick';
-	    data: string;
-	} | {
-	    event: 'item-contextmenu';
-	    data: string;
-	};
+	function List({ width, height, list, itemHeight: propItemHeight, border, expandEnable, onItemClick, onItemDblclick, onItemContextmenu, }: ListProps): react_jsx_runtime.JSX.Element;
 
-	interface ListChildren {
-	    title: string;
-	    value?: string;
-	    clearBtn?: boolean;
-	    children?: ListChildren[];
-	    selected?: boolean;
-	}
-	interface InputProps {
-	    width?: number;
+	interface CheckBoxProps {
+	    checked?: boolean;
 	    disabled?: boolean;
-	    readonly?: boolean;
-	    clearBtn?: boolean | 'keepAlive';
-	    clickBtn?: boolean;
-	    dropDownList?: ListChildren[];
-	    searchBtn?: boolean;
-	    value?: string;
-	    placeholder?: string;
-	    preText?: string;
-	    type: 'text' | 'telephone' | 'number' | 'password' | 'color' | 'email';
-	    otherAttr?: {
-	        [key: string]: string;
-	    };
-	    testVal?: string;
+	    text?: string;
+	    name?: string;
+	    onlyChangeByBox?: boolean;
+	    onChange?: (checked: boolean) => void;
 	}
-	type InputStoreEvents = {
-	    event: 'click';
-	    data: string;
-	} | {
-	    event: 'search-click';
-	    data: string;
-	} | {
-	    event: 'filter-click';
-	    data: string;
-	} | {
-	    event: 'change';
-	    data: string;
-	} | {
-	    event: 'add-click';
-	    data: string;
-	};
+	function CheckBox({ checked, disabled, text, name, onlyChangeByBox, onChange, }: CheckBoxProps): react_jsx_runtime.JSX.Element;
 
-	interface SingleProps {
+	interface RadioProps {
 	    disabled?: boolean;
 	    text: string;
 	    value: string;
 	    width?: number;
 	}
-	interface RadioStoreProps {
-	    group: SingleProps[];
+	interface RadioGroupProps {
+	    group: RadioProps[];
 	    selectedValue?: string;
 	    onlyChangeByBox?: boolean;
 	    lineBreak?: boolean;
 	    gap?: number;
+	    onChange?: (value: string) => void;
 	}
-	type CheckBoxStoreEvents$1 = {
-	    event: 'change';
-	    data: string;
-	};
+	function RadioGroup({ group, selectedValue, onlyChangeByBox, lineBreak, gap, onChange, }: RadioGroupProps): react_jsx_runtime.JSX.Element;
 
-	interface TextAreaStoreProps {
+	interface TextAreaProps {
 	    disabled?: boolean;
 	    value?: string;
 	    width?: number;
@@ -16889,139 +16967,354 @@ declare global {
 	    };
 	    placeholder?: string;
 	    name?: string;
+	    onChange?: (value: string) => void;
 	}
-	type TextAreaStoreEvents = {
-	    event: 'change';
-	    data: string;
-	};
+	function TextArea({ disabled, value, width, height, resizable, placeholder, name, onChange, }: TextAreaProps): react_jsx_runtime.JSX.Element;
 
-	interface CheckBoxStoreProps {
-	    checked?: boolean;
-	    disabled?: boolean;
-	    text?: string;
-	    name?: string;
-	    onlyChangeByBox?: boolean;
+	interface ModalProps {
+	    defaultTop: number;
+	    defaultLeft: number;
+	    defaultWidth: number;
+	    defaultHeight: number;
+	    maxDragX?: number;
+	    maxDragY?: number;
+	    hide?: boolean;
+	    children?: React$1.ReactNode;
+	    onMoved?: (top: number, left: number) => void;
 	}
-	type CheckBoxStoreEvents = {
-	    event: 'change';
-	    data: boolean;
-	};
+	function Modal({ defaultTop, defaultLeft, defaultWidth, defaultHeight, maxDragX, maxDragY, hide, 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?: (ButtonStoreProps & {
-	        clickEventName: string;
-	    })[];
+	    buttons?: DialogButtonProps[];
+	    onClose?: () => void;
+	    children?: React$1.ReactNode;
 	}
-	function Dialog(props: {
-	    children?: react__default.ReactElement | react__default.ReactElement[];
-	} & DialogProps): react_jsx_runtime.JSX.Element;
+	function Dialog({ title, buttons, onClose, children }: DialogProps): react_jsx_runtime.JSX.Element;
 
-	abstract class PortalBase {
-	    Provider: (props: any) => react_jsx_runtime.JSX.Element;
-	    abstract createComponent(handle: string, type: string, props: any, parent: string): void;
-	    abstract updateComponent(handle: string, props: any): void;
-	    abstract detachComponent(handle: string): void;
-	    abstract bindEvent(handle: string, callback: (ev: any) => void): void;
+	interface SelectListItem {
+	    title: string;
+	    value?: string;
+	    children?: SelectListItem[];
 	}
+	interface SelectProps {
+	    width?: number;
+	    disabled?: boolean;
+	    readonly?: boolean;
+	    dropDownList?: SelectListItem[];
+	    value?: string;
+	    onChange?: (value: string) => void;
+	}
+	function Select({ width, disabled, readonly, dropDownList, value, onChange }: SelectProps): react_jsx_runtime.JSX.Element;
+
+	interface BoardProps {
+	    padding?: number[];
+	    bgColor?: string;
+	    width?: number;
+	    height?: number;
+	    title: string;
+	    children?: React$1.ReactNode;
+	    onClick?: () => void;
+	}
+	function Board({ padding, bgColor, width, height, title, children, onClick }: BoardProps): react_jsx_runtime.JSX.Element;
+
+	interface ImageProps {
+	    src: string;
+	    width?: number;
+	    height?: number;
+	    title?: string;
+	    onClick?: () => void;
+	}
+	function Image({ src, width, height, title, onClick }: ImageProps): react_jsx_runtime.JSX.Element;
 
-	const Components: {
-	    Dialog: typeof Dialog;
-	    CheckBox: (props: CheckBoxStoreProps & {
-	        onEvent?: ((ev: CheckBoxStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    TextArea: (props: TextAreaStoreProps & {
-	        onEvent?: ((ev: TextAreaStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    RadioGroup: (props: RadioStoreProps & {
-	        onEvent?: ((ev: CheckBoxStoreEvents$1) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    Input: (props: InputProps & {
-	        onEvent?: ((ev: InputStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    List: (props: ListProps & {
-	        onEvent?: ((ev: ListStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    Grid: (props: GridStoreProps & {
-	        onEvent?: ((ev: CheckBoxStoreEvents$2) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    GridItem: (props: GridSItemtoreProps & {
-	        onEvent?: ((ev: CheckBoxStoreEvents$3) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    Modal: (props: ModalStoreProps & {
-	        onEvent?: ((ev: ModalStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    Flex: (props: FlexStoreProps & {
-	        onEvent?: ((ev: FlexStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    FlexItem: (props: FlexItemStoreProps & {
-	        onEvent?: ((ev: FlexItemStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    Text: (props: PanelStoreProps & {
-	        onEvent?: ((ev: PanelStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    Button: (props: ButtonStoreProps & {
-	        onEvent?: ((ev: ButtonStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    Board: (props: BoardStoreProps & {
-	        onEvent?: ((ev: BoardStoreEvents) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
-	    Image: (props: ImageStoreProps & {
-	        onEvent?: ((ev: BoardStoreEvents$1) => void) | undefined;
-	        children?: react.JSX.Element[] | react.JSX.Element;
-	    }) => react.JSX.Element;
+	const ComponentsIndex: {
+	    readonly Button: typeof Button;
+	    readonly Input: typeof Input;
+	    readonly Text: typeof Text;
+	    readonly Flex: typeof Flex;
+	    readonly FlexItem: typeof FlexItem;
+	    readonly Grid: typeof Grid;
+	    readonly GridItem: typeof GridItem;
+	    readonly List: typeof List;
+	    readonly CheckBox: typeof CheckBox;
+	    readonly RadioGroup: typeof RadioGroup;
+	    readonly TextArea: typeof TextArea;
+	    readonly Modal: typeof Modal;
+	    readonly Dialog: typeof Dialog;
+	    readonly Select: typeof Select;
+	    readonly Board: typeof Board;
+	    readonly Image: typeof Image;
+	};
+	const LC_DESIGN_COMPONENTS_NAMES: (keyof typeof ComponentsIndex)[];
+	type TComponentsIndex = typeof ComponentsIndex;
+	type KComponentsIndex = keyof TComponentsIndex;
+	type ComponentProps<T extends KComponentsIndex> = TComponentsIndex[T] extends React.ComponentType<infer P> ? P : never;
+
+	type ReactComponentProps<T extends KComponentsIndex> = ComponentProps<T>;
+	type LC_DESIGN_COMPONENTS = {
+	    [K in KComponentsIndex]: (props: ReactComponentProps<K>) => React.ReactElement;
 	};
-	type Components = typeof Components;
 
 	/**
-	 * WorkerPortal 类，用于在 pro-api 中与 EditorDesignPortal 通信
+	 * React 实例接口
+	 * 用于接收扩展的 React 实例
+	 *
+	 * @alpha
+	 * @remarks
+	 * 此接口定义了从扩展传递的 React 实例的方法。
+	 * 由于扩展和 pro-api 使用不同的 React 实例，需要通过此接口传递 React 方法。
+	 * @example
+	 * ```typescript
+	 * const ReactInstance = {
+	 *   createContext: React.createContext,
+	 *   useContext: React.useContext,
+	 *   useRef: React.useRef,
+	 *   useEffect: React.useEffect,
+	 *   createElement: React.createElement,
+	 * };
+	 * ```
 	 */
-	class WorkerPortal extends PortalBase {
-	    private readonly portal;
-	    private readonly compIndex;
-	    constructor(container: HTMLElement);
-	    createComponent(handle: string, type: string, props: any, parent: string): void;
-	    updateComponent(handle: string, props: any): void;
-	    detachComponent(handle: string): void;
-	    bindEvent(handle: string, callback: (ev: any) => void): void;
+	interface ISYS_ReactComponentizationDialogReactInstance {
+	    /**
+	     * 创建 React Context
+	     * @typeParam T - Context 的值类型
+	     * @returns Context 对象
+	     */
+	    createContext: <T>(defaultValue: T) => React.Context<T>;
+	    /**
+	     * 读取和订阅 Context 的值
+	     * @typeParam T - Context 的值类型
+	     * @param context - Context 对象
+	     * @returns Context 的当前值
+	     */
+	    useContext: <T>(context: React.Context<T>) => T;
+	    /**
+	     * 创建一个可变的 ref 对象
+	     * @typeParam T - ref 的值类型
+	     * @param initialValue - 初始值
+	     * @returns ref 对象
+	     */
+	    useRef: <T>(initialValue: T) => React.MutableRefObject<T>;
+	    /**
+	     * 执行副作用操作
+	     * @param effect - 副作用函数
+	     * @param deps - 依赖项数组
+	     */
+	    useEffect: (effect: () => undefined | (() => undefined), deps?: React.DependencyList) => void;
+	    /**
+	     * 创建并返回指定类型的新 React 元素
+	     * @param type - 元素类型
+	     * @param props - 元素属性
+	     * @param children - 子元素
+	     * @returns React 元素
+	     */
+	    createElement: <P extends Record<string, unknown>>(type: React.ElementType<P>, props?: P | null, ...children: React.ReactNode[]) => React.ReactElement<P>;
+	}
+	/**
+	 * React Reconciler 实例接口
+	 * 用于接收扩展的 react-reconciler 实例
+	 *
+	 * @alpha
+	 * @remarks
+	 * 此接口定义了从扩展传递的 react-reconciler 实例。
+	 * react-reconciler 是 React 的自定义渲染器，用于实现虚拟 DOM 渲染。
+	 * @example
+	 * ```typescript
+	 * const ReconcilerInstance = {
+	 *   default: Reconciler,
+	 *   constants: {
+	 *     ContinuousEventPriority,
+	 *     DiscreteEventPriority,
+	 *     DefaultEventPriority,
+	 *     ConcurrentRoot,
+	 *   },
+	 * };
+	 * ```
+	 */
+	interface ISYS_ReactComponentizationDialogReconcilerInstance {
+	    /**
+	     * Reconciler 构造函数
+	     * @param config - Reconciler 配置
+	     * @returns Reconciler 实例
+	     */
+	    default: any;
+	    /**
+	     * Reconciler 常量
+	     */
+	    constants: {
+	        /**
+	         * 连续事件优先级
+	         * 用于鼠标移动、滚动等连续事件
+	         */
+	        ContinuousEventPriority: number;
+	        /**
+	         * 离散事件优先级
+	         * 用于点击、键盘输入等离散事件
+	         */
+	        DiscreteEventPriority: number;
+	        /**
+	         * 默认事件优先级
+	         * 用于没有特定优先级的事件
+	         */
+	        DefaultEventPriority: number;
+	        /**
+	         * 并发根节点标签
+	         * 用于标识并发模式的根节点
+	         */
+	        ConcurrentRoot: number;
+	    };
 	}
 	/**
-	 * 预制组件节点类型
+	 * WorkerPortal 类接口
+	 * 用于管理组件的生命周期和事件处理
 	 *
-	 * @remarks 只能使用 Components 内的预制组件
+	 * @alpha
+	 * @remarks
+	 * WorkerPortal 负责在虚拟环境中创建、更新和销毁组件，
+	 * 并通过消息机制与 EditorDesignPortal 通信。
 	 */
-	type TComponentsNode = react__default.ReactElement<any, Components[keyof Components]> | Array<TComponentsNode> | null | undefined | boolean | string | number;
-
+	interface ISYS_ReactComponentizationDialogWorkerPortal {
+	    /**
+	     * Provider 组件
+	     * 用于提供 PortalContext 给子组件
+	     */
+	    Provider: React.ComponentType<React.PropsWithChildren<unknown>>;
+	    /**
+	     * 创建组件
+	     * @param handle - 组件句柄
+	     * @param type - 组件类型
+	     * @param props - 组件属性
+	     * @param parent - 父组件句柄
+	     */
+	    createComponent: (handle: string, type: string, props: Record<string, unknown>, parent: string) => void;
+	    /**
+	     * 更新组件
+	     * @param handle - 组件句柄
+	     * @param props - 新的组件属性
+	     */
+	    updateComponent: (handle: string, props: Record<string, unknown>) => void;
+	    /**
+	     * 销毁组件
+	     * @param handle - 组件句柄
+	     */
+	    detachComponent: (handle: string) => void;
+	    /**
+	     * 绑定事件处理器
+	     * @param handle - 组件句柄
+	     * @param callback - 事件回调函数
+	     */
+	    bindEvent: (handle: string, callback: (event: unknown) => void) => void;
+	    /**
+	     * 触发事件
+	     * @param handle - 组件句柄
+	     * @param event - 事件对象
+	     */
+	    dispatchEvent: (handle: string, event: unknown) => void;
+	}
+	/**
+	 * VirtualRender 类接口
+	 * 用于在虚拟环境中渲染 React 组件
+	 *
+	 * @alpha
+	 * @remarks
+	 * VirtualRender 使用 react-reconciler 实现虚拟 DOM 渲染，
+	 * 不直接操作真实 DOM，而是通过消息机制与 EditorDesignPortal 通信。
+	 */
+	interface ISYS_ReactComponentizationDialogVirtualRender {
+	    /**
+	     * 渲染 React 元素
+	     * @param element - React 元素
+	     */
+	    render: (element: React.ReactNode) => void;
+	}
 	/**
 	 * React 组件化弹出窗口接口
 	 *
 	 * @alpha
+	 * @remarks
+	 * 此接口提供了创建 React 组件化弹出窗口所需的所有功能。
+	 * 通过此接口，用户可以使用 lc-editor-design 提供的预制组件创建自定义弹窗。
+	 * @example
+	 * ```typescript
+	 * const { Components, WorkerPortal, VirtualRender } = await eda.sys_Dialog.createReactComponentizationDialogInterface(
+	 *   {
+	 *     createContext: React.createContext,
+	 *     useContext: React.useContext,
+	 *     useRef: React.useRef,
+	 *     useEffect: React.useEffect,
+	 *     createElement: React.createElement,
+	 *   },
+	 *   {
+	 *     default: Reconciler,
+	 *     constants: {
+	 *       ContinuousEventPriority,
+	 *       DiscreteEventPriority,
+	 *       DefaultEventPriority,
+	 *       ConcurrentRoot,
+	 *     },
+	 *   },
+	 * );
+	 *
+	 * const portal = new WorkerPortal();
+	 * const root = new VirtualRender();
+	 *
+	 * function MyDialog() {
+	 *   return (
+	 *     <Modal defaultTop={100} defaultLeft={100} defaultWidth={800} defaultHeight={600}>
+	 *       <Dialog title="My Dialog">
+	 *         <Input placeholder="Enter text" />
+	 *       </Dialog>
+	 *     </Modal>
+	 *   );
+	 * }
+	 *
+	 * root.render(
+	 *   <portal.Provider>
+	 *     <MyDialog />
+	 *   </portal.Provider>,
+	 * );
+	 * ```
 	 */
 	interface ISYS_ReactComponentizationDialogInterface {
-	    /** 预制组件 */
-	    Components: Components;
-	    /** Portal 实例 */
-	    portal: WorkerPortal;
 	    /**
-	     * 渲染 React 组件
+	     * 预制组件
 	     *
-	     * @param node - Components 内的预制组件
+	     * @remarks
+	     * 包含所有 lc-editor-design 提供的预制组件，如 Modal、Dialog、Input、Button 等。
 	     */
-	    render: (node: TComponentsNode) => void;
+	    Components: LC_DESIGN_COMPONENTS;
+	    /**
+	     * 组件名称常量
+	     *
+	     * @remarks
+	     * 包含所有预制组件的名称常量，用于类型安全的组件引用。
+	     */
+	    LC_DESIGN_COMPONENTS_NAMES: typeof LC_DESIGN_COMPONENTS_NAMES;
+	    /**
+	     * WorkerPortal 类
+	     *
+	     * @remarks
+	     * 用于管理组件的生命周期和事件处理。
+	     * 需要实例化后使用。
+	     */
+	    WorkerPortal: new () => ISYS_ReactComponentizationDialogWorkerPortal;
+	    /**
+	     * VirtualRender 类
+	     *
+	     * @remarks
+	     * 用于在虚拟环境中渲染 React 组件。
+	     * 需要实例化后使用。
+	     */
+	    VirtualRender: new () => ISYS_ReactComponentizationDialogVirtualRender;
 	}
+
 	/**
 	 * 系统 / 对话框类
 	 *
@@ -17033,9 +17326,11 @@ declare global {
 	     * 创建 React 组件化弹出窗口接口
 	     *
 	     * @alpha
+	     * @param React - 扩展的 React 实例
+	     * @param Reconciler - 扩展的 react-reconciler 实例
 	     * @returns 包含 portal、render 方法和 Components 对象的对象
 	     */
-	    createReactComponentizationDialogInterface(): ISYS_ReactComponentizationDialogInterface;
+	    createReactComponentizationDialogInterface(React: ISYS_ReactComponentizationDialogReactInstance, Reconciler: ISYS_ReactComponentizationDialogReconcilerInstance): Promise<ISYS_ReactComponentizationDialogInterface>;
 	    /**
 	     * 弹出消息窗口
 	     *
@@ -17715,7 +18010,7 @@ declare global {
 	     *
 	     * 注意：本接口需要使用者启用扩展的外部交互权限，如若未启用将始终 `throw Error`
 	     *
-	     * 非公开接口使用提醒：本接口按原样提供，不提供参数的额外文档，参数可能在任何版本出现破坏性更改并不另行通知
+	     * 非��开接口使用提醒：本接口按原样提供，不提供参数的额外文档，参数可能在任何版本出现破坏性更改并不另行通知
 	     * @param headerMenus - 顶部菜单数据
 	     * @example
 	     * headerMenus:
@@ -19168,9 +19463,10 @@ declare global {
 	    sch_Document: SCH_Document;
 	    sch_Drc: SCH_Drc;
 	    sch_Event: SCH_Event;
+	    sch_ManufactureData: SCH_ManufactureData;
+	    sch_Net: SCH_Net;
 	    sch_Netlist: SCH_Netlist;
 	    sch_Primitive: SCH_Primitive;
-	    sch_ManufactureData: SCH_ManufactureData;
 	    sch_PrimitiveArc: SCH_PrimitiveArc;
 	    sch_PrimitiveAttribute: SCH_PrimitiveAttribute;
 	    sch_PrimitiveBus: SCH_PrimitiveBus;

package/package.json

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