@jlceda/pro-api-types 0.2.25 → 0.2.26

package/index.d.ts

@@ -383,6 +383,8 @@ declare global {
 	    type: ELIB_SymbolType;
 	    /** 描述 */
 	    description?: string;
+	    /** 子部件名称数组 */
+	    subPartNames: [];
 	}
 	/**
 	 * 搜索到的符号属性
@@ -515,6 +517,7 @@ declare global {
 	    getRenderImage(source: {
 	        symbolUuid: string;
 	        libraryUuid: string;
+	        subPartName?: string;
 	    }): Promise<Blob | undefined>;
 	}
 
@@ -957,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`，则打开文档失败
 	     */
@@ -1390,7 +1393,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` 则创建失败
@@ -1879,7 +1882,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 - 描述
@@ -2012,7 +2015,7 @@ declare global {
 	    supplier?: string;
 	    /** 供应商编号 */
 	    supplierId?: string;
-	    /** 其它参数 */
+	    /** 其它属性 */
 	    otherProperty?: {
 	        [key: string]: boolean | number | string | undefined;
 	    };
@@ -2039,6 +2042,8 @@ declare global {
 	    description?: string;
 	    /** 扩展属性 */
 	    property: ILIB_DeviceExtendPropertyItem;
+	    /** 子部件名称数组 */
+	    subPartNames: [];
 	}
 	/**
 	 * 搜索到的器件属性
@@ -2168,7 +2173,7 @@ declare global {
 	     * @deprecated 在 `otherProperty` 中替代
 	     */
 	    jlcLibraryCategory?: ELIB_DeviceJlcLibraryCategory;
-	    /** 其它参数 */
+	    /** 其它属性 */
 	    otherProperty?: {
 	        [key: string]: boolean | number | string | undefined;
 	    };
@@ -2213,7 +2218,7 @@ declare global {
 	     * @param classification - 分类
 	     * @param association - 关联符号、封装、图像，指定 `symbolType` 则创建新符号，无需新建符号则无需指定 `symbolType`，但请注意，如若不新建符号也不指定符号的关联信息将无法创建器件
 	     * @param description - 描述
-	     * @param property - 其它参数，仅 `designator`、`addIntoBom`、`addIntoPcb` 存在默认值
+	     * @param property - 其它属性，仅 `designator`、`addIntoBom`、`addIntoPcb` 存在默认值
 	     * @returns 器件 UUID
 	     */
 	    create(libraryUuid: string, deviceName: string, classification?: ILIB_ClassificationIndex | Array<string>, association?: {
@@ -2254,7 +2259,7 @@ declare global {
 	     * @param classification - 分类
 	     * @param association - 关联符号、封装、图像
 	     * @param description - 描述
-	     * @param property - 其它参数
+	     * @param property - 其它属性
 	     * @returns 操作是否成功
 	     */
 	    modify(deviceUuid: string, libraryUuid: string, deviceName?: string, classification?: ILIB_ClassificationIndex | Array<string> | null, association?: {
@@ -2878,7 +2883,7 @@ declare global {
 	     * 获取工程库的 UUID
 	     *
 	     * @public
-	     * @remarks 在未打开工程的情况下调用将返�� `undefined`
+	     * @remarks 在未打开工程的情况下调用将返回 `undefined`
 	     * @returns 工程库的 UUID
 	     */
 	    getProjectLibraryUuid(): Promise<string | undefined>;
@@ -3356,7 +3361,7 @@ declare global {
 	     * 即 `setCanvasOrigin(0, 0)`；
 	     *
 	     * 此处的单位为数据层面单位，在跨度上等同于画布层面的 mil
-	     * @param offsetX - 画布原点相对于数据原点的 X 坐标偏移
+	     * @param offsetX - 画布原点相对于数���原点的 X 坐标偏移
 	     * @param offsetY - 画布原点相对于数据原点的 Y 坐标偏移
 	     * @returns 操作是否成功
 	     */
@@ -4938,6 +4943,36 @@ declare global {
 	     * @param layers - 导出层，默认则按照嘉立创生产需求导出
 	     * @param objects - 导出对象，默认则按照嘉立创生产需求导出
 	     * @returns PCB 制版文件数据
+	     * @example
+	     * ```javascript
+	     * // 导出默认的 Gerber 文件
+	     * const gerberFile = await eda.pcb_ManufactureData.getGerberFile('MyBoard_Gerber');
+	     * if (gerberFile) {
+	     *     console.log('Gerber 文件已生成:', gerberFile);
+	     * }
+	     *
+	     * // 导出并保存到本地
+	     * const gerberFile = await eda.pcb_ManufactureData.getGerberFile(
+	     *     'MyBoard_Gerber',
+	     *     false,
+	     *     ESYS_Unit.MILLIMETER,
+	     *     { integerNumber: 2, decimalNumber: 6 }
+	     * );
+	     * if (gerberFile) {
+	     *     await eda.sys_FileSystem.saveFile(gerberFile,'Gerber.zip');
+	     * }
+	     *
+	     * // 自定义导出层和对象
+	     * const gerberFile = await eda.pcb_ManufactureData.getGerberFile(
+	     *     'Custom_Gerber',
+	     *     false,
+	     *     ESYS_Unit.INCH,
+	     *     { integerNumber: 3, decimalNumber: 5 },
+	     *     { metallicDrillingInformation: true, nonMetallicDrillingInformation: true, drillTable: false, flyingProbeTestingFile: false },
+	     *     [{ layerId: 1, isMirror: false }, { layerId: 2, isMirror: false }, { layerId: 11, isMirror: false }],
+	     *     ['Pad', 'Via', 'Track', 'BoardOutline']
+	     * );
+	     * ```
 	     */
 	    getGerberFile(fileName?: string, colorSilkscreen?: boolean, unit?: ESYS_Unit.MILLIMETER | ESYS_Unit.INCH, digitalFormat?: {
 	        integerNumber: number;
@@ -4963,8 +4998,40 @@ declare global {
 	     * @param fileType - 文件类型
 	     * @param element - 导出对象
 	     * @param modelMode - 导出模式，`Outfit` = 装配体，`Parts` = 零件
-	     * @param autoGenerateModels - 是否为未绑定 3D 模型的元件自动生成 3D 模型（根据元件的“高度”属性）
+	     * @param autoGenerateModels - 是否为未绑定 3D 模型的元件自动生成 3D 模型（根据元件的"高度"属性）
 	     * @returns 3D 模型文件数据
+	     * @example
+	     * ```javascript
+	     * // 导出装配体模式的 STEP 文件（包含元件模型）
+	     * const stepFile = await eda.pcb_ManufactureData.get3DFile(
+	     *     'MyBoard_3D',
+	     *     'step',
+	     *     ['Component Model'],
+	     *     'Outfit',
+	     *     true
+	     * );
+	     * if (stepFile) {
+	     *     await eda.sys_FileSystem.saveFile(stepFile);
+	     * }
+	     *
+	     * // 导出包含多种对象的完整 3D 模型
+	     * const full3DFile = await eda.pcb_ManufactureData.get3DFile(
+	     *     'Complete_3D_Model',
+	     *     'step',
+	     *     ['Component Model', 'Via', 'Silkscreen', 'Wire In Signal Layer'],
+	     *     'Outfit',
+	     *     true
+	     * );
+	     *
+	     * // 导出零件模式 OBJ 文件
+	     * const objFile = await eda.pcb_ManufactureData.get3DFile(
+	     *     'MyBoard_OBJ',
+	     *     'obj',
+	     *     ['Component Model'],
+	     *     'Parts',
+	     *     false
+	     * );
+	     * ```
 	     */
 	    get3DFile(fileName?: string, fileType?: 'step' | 'obj', element?: Array<'Component Model' | 'Via' | 'Silkscreen' | 'Wire In Signal Layer'>, modelMode?: 'Outfit' | 'Parts', autoGenerateModels?: boolean): Promise<File | undefined>;
 	    /**
@@ -4975,6 +5042,20 @@ declare global {
 	     * @param fileName - 文件名
 	     * @param fileType - 文件类型
 	     * @returns 3D 外壳文件数据
+	     * @example
+	     * ```javascript
+	     * // 导出 STL 格式 3D 外壳
+	     * const stlFile = await eda.pcb_ManufactureData.get3DShellFile('Board_Shell', 'stl');
+	     * if (stlFile) {
+	     *     await eda.sys_FileSystem.saveFile(stlFile);
+	     * }
+	     *
+	     * // 导出 STEP 格式 3D 外壳
+	     * const stepShellFile = await eda.pcb_ManufactureData.get3DShellFile('Board_Shell_STEP', 'step');
+	     * if (stepShellFile) {
+	     *     await eda.sys_FileSystem.saveFile(stepShellFile);
+	     * }
+	     * ```
 	     */
 	    get3DShellFile(fileName?: string, fileType?: 'stl' | 'step' | 'obj'): Promise<File | undefined>;
 	    /**
@@ -4986,6 +5067,19 @@ declare global {
 	     * @param fileType - 文件类型
 	     * @param unit - 单位
 	     * @returns 坐标文件数据
+	     * @example
+	     * ```javascript
+	     * // 导出毫米单位的 Excel 格式坐标文件
+	     * const pnpFile = await eda.pcb_ManufactureData.getPickAndPlaceFile(
+	     *     'PickAndPlace',
+	     *     'xlsx',
+	     *     ESYS_Unit.MILLIMETER
+	     * );
+	     * if (pnpFile) {
+	     *     await eda.sys_FileSystem.saveFile(pnpFile);
+	     * }
+	     *
+	     * ```
 	     */
 	    getPickAndPlaceFile(fileName?: string, fileType?: 'xlsx' | 'csv', unit?: ESYS_Unit.MILLIMETER | ESYS_Unit.MIL): Promise<File | undefined>;
 	    /**
@@ -4994,6 +5088,14 @@ declare global {
 	     * @beta
 	     * @param fileName - 文件名
 	     * @returns 飞针测试文件数据
+	     * @example
+	     * ```javascript
+	     * // 保存飞针测试文件到本地
+	     * const flyingProbeFile = await eda.pcb_ManufactureData.getFlyingProbeTestFile('FlyingProbe_Test');
+	     * if (flyingProbeFile) {
+	     *     await eda.sys_FileSystem.saveFile(flyingProbeFile);
+	     * }
+	     * ```
 	     */
 	    getFlyingProbeTestFile(fileName?: string): Promise<File | undefined>;
 	    /**
@@ -5001,6 +5103,15 @@ declare global {
 	     *
 	     * @beta
 	     * @returns BOM 模板列表
+	     * @example
+	     * ```javascript
+	     * // 获取所有可用的 BOM 模板
+	     * const templates = await eda.pcb_ManufactureData.getBomTemplates();
+	     * console.log('可用的 BOM 模板:', templates);
+	     * templates.forEach((template, index) => {
+	     *     console.log(`${index + 1}. ${template}`);
+	     * });
+	     * ```
 	     */
 	    getBomTemplates(): Promise<Array<string>>;
 	    /**
@@ -5010,6 +5121,20 @@ declare global {
 	     * @param templateFile - BOM 模板文件
 	     * @param template - BOM 模板名称，如若为 `undefined` 则自动从 `templateFile` 中取值
 	     * @returns BOM 模板名称
+	     * @example
+	     * ```javascript
+	     * // 从文件选择器读取模板文件
+	     * const templateFile = await eda.sys_FileSystem.openReadFileDialog('.xlsx');
+	     * if (templateFile) {
+	     *     const templateName = await eda.pcb_ManufactureData.uploadBomTemplateFile(
+	     *         templateFile,
+	     *         'MyCustomTemplate'
+	     *     );
+	     *     if (templateName) {
+	     *         console.log('模板上传成功:', templateName);
+	     *     }
+	     * }
+	     * ```
 	     */
 	    uploadBomTemplateFile(templateFile: File, template?: string): Promise<string | undefined>;
 	    /**
@@ -5018,6 +5143,14 @@ declare global {
 	     * @beta
 	     * @param template - BOM 模板名称
 	     * @returns BOM 模板文件
+	     * @example
+	     * ```javascript
+	     * // 获取指定模板的文件
+	     * const templateFile = await eda.pcb_ManufactureData.getBomTemplateFile('MyCustomTemplate');
+	     * if (templateFile) {
+	     *     await eda.sys_FileSystem.saveFile(templateFile);
+	     * }
+	     * ```
 	     */
 	    getBomTemplateFile(template: string): Promise<File | undefined>;
 	    /**
@@ -5026,6 +5159,16 @@ declare global {
 	     * @beta
 	     * @param template - BOM 模板名称
 	     * @returns 操作是否成功
+	     * @example
+	     * ```javascript
+	     * // 删除指定的 BOM 模板
+	     * const success = await eda.pcb_ManufactureData.deleteBomTemplate('MyCustomTemplate');
+	     * if (success) {
+	     *     console.log('BOM 模板删除成功');
+	     * } else {
+	     *     console.log('删除失败，可能是默认模板或模板不存在');
+	     * }
+	     * ```
 	     */
 	    deleteBomTemplate(template: string): Promise<boolean>;
 	    /**
@@ -5041,6 +5184,41 @@ declare global {
 	     * @param property - 属性，包含所有需要启用的属性的名称
 	     * @param columns - 列的属性及排序，`title`、`sort`、`group`、`orderWeight` 不传入则取默认值，`null` 代表 **无** 或 **空**
 	     * @returns BOM 文件数据
+	     * @example
+	     * ```javascript
+	     * // 使用默认配置导出 BOM
+	     * const bomFile = await eda.pcb_ManufactureData.getBomFile('MyBOM', 'xlsx');
+	     * if (bomFile) {
+	     *     await eda.sys_FileSystem.saveFile(bomFile);
+	     * }
+	     *
+	     * // 自定义 BOM 过滤和列配置
+	     * const bomFile = await eda.pcb_ManufactureData.getBomFile(
+	     *     'Custom_Production_BOM',
+	     *     'xlsx',
+	     *     undefined,
+	     *     [
+	     *         { property: 'Add into BOM', includeValue: 'yes' },
+	     *         { property: 'Convert to PCB', includeValue: 'yes' }
+	     *     ],
+	     *     ['No.', 'Quantity', 'Comment'],
+	     *     ['Name', 'Device', 'Designator', 'Supplier'],
+	     *     [
+	     *         { property: 'Designator', title: '位号', sort: 'asc', group: 'No', orderWeight: 10 },
+	     *         { property: 'Quantity', title: '数量', sort: 'desc', group: 'Yes', orderWeight: 9 }
+	     *     ]
+	     * );
+	     *
+	     * // 导出 CSV 格式 BOM
+	     * const csvBomFile = await eda.pcb_ManufactureData.getBomFile(
+	     *     'Simple_BOM',
+	     *     'csv',
+	     *     undefined,
+	     *     [{ property: 'Add into BOM', includeValue: 'yes' }],
+	     *     ['No.', 'Quantity'],
+	     *     ['Designator', 'Footprint', 'Value']
+	     * );
+	     * ```
 	     */
 	    getBomFile(fileName?: string, fileType?: 'xlsx' | 'csv', template?: string, filterOptions?: Array<{
 	        property: string;
@@ -5054,6 +5232,14 @@ declare global {
 	     * @param fileName - 文件名
 	     * @param fileType - 文件类型
 	     * @returns 测试点报告文件数据
+	     * @example
+	     * ```javascript
+	     * // 保存测试点报告文件到本地
+	     * const testPointFile = await eda.pcb_ManufactureData.getTestPointFile('Test_Point_Report', 'xlsx');
+	     * if (testPointFile) {
+	     *     await eda.sys_FileSystem.saveFile(testPointFile);
+	     * }
+	     * ```
 	     */
 	    getTestPointFile(fileName?: string, fileType?: 'xlsx' | 'csv'): Promise<File | undefined>;
 	    /**
@@ -5064,6 +5250,29 @@ declare global {
 	     * @param fileName - 文件名
 	     * @param netlistType - 网表类型
 	     * @returns 网表文件数据
+	     * @example
+	     * ```javascript
+	     * // 导出嘉立创 EDA 专业版格式网表
+	     * const netlistFile = await eda.pcb_ManufactureData.getNetlistFile(
+	     *     'MyNetlist',
+	     *     ESYS_NetlistType.JLCEDA_PRO
+	     * );
+	     * if (netlistFile) {
+	     *     await eda.sys_FileSystem.saveFile(netlistFile);
+	     * }
+	     *
+	     * // 导出 Altium Designer 格式
+	     * const altiumNetlist = await eda.pcb_ManufactureData.getNetlistFile(
+	     *     'Netlist_Altium',
+	     *     ESYS_NetlistType.ALTIUM_DESIGNER
+	     * );
+	     *
+	     * // 导出 PADS 格式
+	     * const padsNetlist = await eda.pcb_ManufactureData.getNetlistFile(
+	     *     'Netlist_PADS',
+	     *     ESYS_NetlistType.PADS
+	     * );
+	     * ```
 	     */
 	    getNetlistFile(fileName?: string, netlistType?: ESYS_NetlistType): Promise<File | undefined>;
 	    /**
@@ -5093,6 +5302,17 @@ declare global {
 	     * @param contentConfig - 内容配置
 	     * @param watermark - 水印
 	     * @returns PDF 文件数据（或压缩包）
+	     * @example
+	     * ```javascript
+	     * // 导出多页 PDF（包含所有图层）
+	     * const pdfFile = await eda.pcb_ManufactureData.getPdfFile(
+	     *     'PCB_Documentation',
+	     *     EPCB_PdfOutputMethod.MULTI_PAGE_PDF
+	     * );
+	     * if (pdfFile) {
+	     *     await eda.sys_FileSystem.saveFile(pdfFile);
+	     * }
+	     * ```
 	     */
 	    getPdfFile(fileName?: string, outputMethod?: EPCB_PdfOutputMethod, contentConfig?: {
 	        displayAttributesAsMenu: boolean;
@@ -5121,6 +5341,13 @@ declare global {
 	     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
 	     * @param fileName - 文件名
 	     * @returns IPC-D-356A 文件数据
+	     * @example
+	     * ```javascript
+	     * const ipcFile = await eda.pcb_ManufactureData.getIpcD356AFile('IPC_D356A_Test');
+	     * if (ipcFile) {
+	     *     await eda.sys_FileSystem.saveFile(ipcFile);
+	     * }
+	     * ```
 	     */
 	    getIpcD356AFile(fileName?: string): Promise<File | undefined>;
 	    /**
@@ -5143,6 +5370,23 @@ declare global {
 	     * @param layers - 导出层，默认则按照嘉立创生产需求导出
 	     * @param objects - 导出对象，默认则按照嘉立创生产需求导出
 	     * @returns ODB++ 文件数据
+	     * @example
+	     * ```javascript
+	     * // 导出 ODB++ 文件，自定义单位和选项
+	     * const odbFile = await eda.pcb_ManufactureData.getOpenDatabaseDoublePlusFile(
+	     *     'MyBoard_ODB',
+	     *     ESYS_Unit.INCH,
+	     *     {
+	     *         metallizedDrilledHoles: true,
+	     *         nonMetallizedDrilledHoles: true,
+	     *         drillTable: true,
+	     *         flyingProbeTestFile: false
+	     *     }
+	     * );
+	     * if (odbFile) {
+	     *     await eda.sys_FileSystem.saveFile(odbFile);
+	     * }
+	     * ```
 	     */
 	    getOpenDatabaseDoublePlusFile(fileName?: string, unit?: ESYS_Unit.INCH, otherData?: {
 	        metallizedDrilledHoles?: boolean;
@@ -5171,6 +5415,13 @@ declare global {
 	     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
 	     * @param fileName - 文件名
 	     * @returns 自动布线 DSN 文件数据
+	     * @example
+	     * ```javascript
+	     * const dsnFile = await eda.pcb_ManufactureData.getDsnFile('AutoRoute_DSN');
+	     * if (dsnFile) {
+	     *     await eda.sys_FileSystem.saveFile(dsnFile);
+	     * }
+	     * ```
 	     */
 	    getDsnFile(fileName?: string): Promise<File | undefined>;
 	    /**
@@ -5180,6 +5431,13 @@ declare global {
 	     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
 	     * @param fileName - 文件名
 	     * @returns 自动布线 JSON 文件数据
+	     * @example
+	     * ```javascript
+	     * const autoRouteJson = await eda.pcb_ManufactureData.getAutoRouteJsonFile('AutoRoute_Json');
+	     * if (autoRouteJson) {
+	     *     await eda.sys_FileSystem.saveFile(autoRouteJson);
+	     * }
+	     * ```
 	     */
 	    getAutoRouteJsonFile(fileName?: string): Promise<File | undefined>;
 	    /**
@@ -5189,6 +5447,13 @@ declare global {
 	     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
 	     * @param fileName - 文件名
 	     * @returns 自动布局 JSON 文件数据
+	     * @example
+	     * ```javascript
+	     * const autoLayoutJson = await eda.pcb_ManufactureData.getAutoLayoutJsonFile('AutoLayout_Json');
+	     * if (autoLayoutJson) {
+	     *     await eda.sys_FileSystem.saveFile(autoLayoutJson);
+	     * }
+	     * ```
 	     */
 	    getAutoLayoutJsonFile(fileName?: string): Promise<File | undefined>;
 	    /**
@@ -5198,6 +5463,14 @@ declare global {
 	     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
 	     * @param fileName - 文件名
 	     * @returns Altium Designer 文件数据
+	     * @example
+	     * ```javascript
+	     * //获取 Altium Designer 格式文件
+	     * const adFile = await eda.pcb_ManufactureData.getAltiumDesignerFile('Converted_To_AD');
+	     * if (adFile) {
+	     *     await eda.sys_FileSystem.saveFile(adFile);
+	     * }
+	     * ```
 	     */
 	    getAltiumDesignerFile(fileName?: string): Promise<File | undefined>;
 	    /**
@@ -5207,6 +5480,14 @@ declare global {
 	     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
 	     * @param fileName - 文件名
 	     * @returns PADS 文件数据
+	     * @example
+	     * ```javascript
+	     * // 获取 PADS 格式文件
+	     * const padsFile = await eda.pcb_ManufactureData.getPadsFile('Converted_To_PADS');
+	     * if (padsFile) {
+	     *     await eda.sys_FileSystem.saveFile(padsFile);
+	     * }
+	     * ```
 	     */
 	    getPadsFile(fileName?: string): Promise<File | undefined>;
 	    /**
@@ -5216,6 +5497,13 @@ declare global {
 	     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
 	     * @param fileName - 文件名
 	     * @returns PCB 信息文件
+	     * @example
+	     * ```javascript
+	     * const pcbInfoFile = await eda.pcb_ManufactureData.getPcbInfoFile('Board_Information');
+	     * if (pcbInfoFile) {
+	     *     await eda.sys_FileSystem.saveFile(pcbInfoFile);
+	     * }
+	     * ```
 	     */
 	    getPcbInfoFile(fileName?: string): Promise<File | undefined>;
 	    /**
@@ -5224,6 +5512,13 @@ declare global {
 	     * @beta
 	     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
 	     * @returns IDX 文件
+	     * @example
+	     * ```javascript
+	     * const idxFile = await eda.pcb_ManufactureData.getIdxFile('Design_Exchange');
+	     * if (idxFile) {
+	     *     await eda.sys_FileSystem.saveFile(idxFile);
+	     * }
+	     * ```
 	     */
 	    getIdxFile(fileName?: string): Promise<File | undefined>;
 	    /**
@@ -5233,7 +5528,7 @@ declare global {
 	     * @remarks 本接口暂时只支持交互式检查，入参暂无作用，预留后续开发
 	     * @param interactive - 是否启用交互式检查
 	     *
-	     * 如若启用，则会存在弹窗等待用户进行交互，且无法使用 `ignoreWarning` 参数忽略警告，
+	     * 如���启用，则会存在弹窗等待用户进行交互，且无法使用 `ignoreWarning` 参数忽略警告，
 	     * 即 `ignoreWarning` 参数将被忽略；
 	     *
 	     * 如若禁用，则在调用后不会有任何 EDA 内部弹窗，程序执行静默检查，
@@ -5703,7 +5998,7 @@ declare global {
 	     * 更新网表
 	     *
 	     * @public
-	     * @param type - 网表格式
+	     * @param type - ��表格式
 	     * @param netlist - 网表数据
 	     */
 	    setNetlist(type: ESYS_NetlistType | undefined, netlist: string): Promise<boolean>;
@@ -7815,7 +8110,7 @@ declare global {
 	     * 删除区域
 	     *
 	     * @beta
-	     * @param primitiveIds - 区域的���元 ID 或区域图元对象
+	     * @param primitiveIds - 区域的图元 ID 或区域图元对象
 	     * @returns 删除操作是否成功
 	     */
 	    delete(primitiveIds: string | IPCB_PrimitiveRegion | Array<string> | Array<IPCB_PrimitiveRegion>): Promise<boolean>;
@@ -9721,7 +10016,11 @@ declare global {
 	    create(component: {
 	        libraryUuid: string;
 	        uuid: string;
-	    } | ILIB_DeviceItem, layer: TPCB_LayersOfComponent, x: number, y: number, rotation?: number, primitiveLock?: boolean): Promise<IPCB_PrimitiveComponent | undefined>;
+	    } | ILIB_DeviceItem | ILIB_DeviceSearchItem | {
+	        libraryType: ELIB_LibraryType.FOOTPRINT;
+	        libraryUuid: string;
+	        uuid: string;
+	    } | ILIB_FootprintItem | ILIB_FootprintSearchItem, layer: TPCB_LayersOfComponent, x: number, y: number, rotation?: number, primitiveLock?: boolean): Promise<IPCB_PrimitiveComponent | undefined>;
 	    /**
 	     * 删除器件
 	     *
@@ -9814,7 +10113,7 @@ declare global {
 	    /**
 	     * 使用鼠标放置器件
 	     *
-	     * @alpha
+	     * @beta
 	     * @remarks
 	     * 本接口模拟前端点击放置按钮，指定的器件将绑定到当前鼠标，并在用户后续点击时放置于画布
 	     *
@@ -9825,14 +10124,34 @@ declare global {
 	    placeComponentWithMouse(component: {
 	        libraryUuid: string;
 	        uuid: string;
-	    } | ILIB_DeviceItem): Promise<boolean>;
+	    } | ILIB_DeviceItem | ILIB_DeviceSearchItem): Promise<boolean>;
+	    /**
+	     * 使用鼠标放置封装
+	     *
+	     * @alpha
+	     * @remarks
+	     * DEFINED since API v0.2.26
+	     *
+	     * 本接口模拟前端点击放置按钮，指定的封装将绑定到当前鼠标，并在用户后续点击时放置于画布
+	     *
+	     * 本接口的返回时机并不会等待用户的放置操作，一旦封装被绑定到鼠标，本接口将立即返回 `true` 的结果
+	     * @param footprint - 关联库封装
+	     * @param properties - 器件属性
+	     * @returns 是否找到封装
+	     */
+	    placeFootprintWithMouse(footprint: {
+	        libraryUuid: string;
+	        uuid: string;
+	    } | ILIB_FootprintItem | ILIB_FootprintSearchItem, properties?: {
+	        [key: string]: boolean | number | string | undefined;
+	    }): Promise<boolean>;
 	    /**
 	     * 获取所有器件的所有属性名称集合
 	     *
 	     * @alpha
 	     * @returns 所有器件的所有属性名称集合
 	     */
-	    getAllPropertyNames(): Promise<string[]>;
+	    getAllPropertyNames(): Promise<Array<string>>;
 	}
 	/**
 	 * 器件图元
@@ -9847,7 +10166,7 @@ declare global {
 	    /** 图元 ID */
 	    private primitiveId?;
 	    /** 关联库器件 */
-	    private component;
+	    private component?;
 	    /** 关联库封装 */
 	    private footprint?;
 	    /** 层 */
@@ -9886,14 +10205,18 @@ declare global {
 	    private _attributeVisible?;
 	    /** @internal */
 	    constructor(component: {
+	        libraryType?: ELIB_LibraryType.DEVICE | ELIB_LibraryType.FOOTPRINT;
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    }, layer: TPCB_LayersOfComponent, x: number, y: number, rotation?: number, primitiveLock?: boolean, addIntoBom?: boolean, primitiveId?: string, footprint?: {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    }, model3D?: {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    }, designator?: string, pads?: Array<{
 	        primitiveId: string;
 	        net: string;
@@ -9931,7 +10254,8 @@ declare global {
 	    getState_Component(): {
 	        libraryUuid: string;
 	        uuid: string;
-	    };
+	        name?: string;
+	    } | undefined;
 	    /**
 	     * 获取属性状态：关联库封装
 	     *
@@ -9941,6 +10265,7 @@ declare global {
 	    getState_Footprint(): {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    } | undefined;
 	    /**
 	     * 获取属性状态：层
@@ -9993,6 +10318,7 @@ declare global {
 	    getState_Model3D(): {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    } | undefined;
 	    /**
 	     * 获取属性状态：位号
@@ -10739,7 +11065,7 @@ declare global {
 	     */
 	    getState_X(): number;
 	    /**
-	     * 获取属性状态：BBox 左上点坐标 Y
+	     * ��取属性状态：BBox 左上点坐标 Y
 	     *
 	     * @public
 	     * @returns BBox 左上点坐标 Y
@@ -12909,7 +13235,7 @@ declare global {
 	     */
 	    getState_PrimitiveType(): ESCH_PrimitiveType;
 	    /**
-	     * 获取属性状态：图元 ID
+	     * 获取属性���态：图元 ID
 	     *
 	     * @public
 	     * @returns 图元 ID
@@ -14495,14 +14821,14 @@ declare global {
 	    placeComponentWithMouse(component: {
 	        libraryUuid: string;
 	        uuid: string;
-	    } | ILIB_DeviceItem, subPartName?: string): Promise<boolean>;
+	    } | ILIB_DeviceItem | ILIB_DeviceSearchItem, subPartName?: string): Promise<boolean>;
 	    /**
 	     * 获取所有器件的所有属性名称集合
 	     *
 	     * @beta
 	     * @returns 所有器件的所有属性名称集合
 	     */
-	    getAllPropertyNames(): Promise<string[]>;
+	    getAllPropertyNames(): Promise<Array<string>>;
 	    /**
 	     * 到 pro-ui 获取器件的详细信息
 	     *
@@ -15072,7 +15398,7 @@ declare global {
 	     *
 	     * @beta
 	     * @param component - 关联库器件
-	     * @param subPartName - 子图块名称
+	     * @param subPartName - 子部件名称
 	     * @param x - 坐标 X
 	     * @param y - 坐标 Y
 	     * @param rotation - 旋转角度
@@ -15082,9 +15408,14 @@ declare global {
 	     * @returns 器件图元对象
 	     */
 	    create(component: {
+	        libraryType?: ELIB_LibraryType.DEVICE;
+	        libraryUuid: string;
+	        uuid: string;
+	    } | ILIB_DeviceItem | ILIB_DeviceSearchItem | {
+	        libraryType: ELIB_LibraryType.SYMBOL;
 	        libraryUuid: string;
 	        uuid: string;
-	    } | ILIB_DeviceItem | ILIB_DeviceSearchItem, x: number, y: number, subPartName?: string, rotation?: number, mirror?: boolean, addIntoBom?: boolean, addIntoPcb?: boolean): Promise<ISCH_PrimitiveComponent | undefined>;
+	    } | ILIB_SymbolItem | ILIB_SymbolSearchItem, x: number, y: number, subPartName?: string, rotation?: number, mirror?: boolean, addIntoBom?: boolean, addIntoPcb?: boolean): Promise<ISCH_PrimitiveComponent | undefined>;
 	    /**
 	     * 创建网络标识
 	     *
@@ -15126,7 +15457,7 @@ declare global {
 	     * 创建复用模块符号
 	     *
 	     * @alpha
-	     * @param cbbSymbol - 关联库复用模块符号
+	     * @param cbbSymbol - 关联库复用模块符号，libraryUuid 是 CBB 工程所在库的 UUID，cbbUuid 是 CBB 工程的 UUID，uuid 是 CBB 工程内符号的 UUID，name 是符号的显示名称
 	     * @param x - 坐标 X
 	     * @param y - 坐标 Y
 	     * @param rotation - 旋转角度
@@ -15136,7 +15467,7 @@ declare global {
 	    createCbbSymbol(cbbSymbol: {
 	        libraryUuid: string;
 	        cbbUuid: string;
-	        uuid: string;
+	        uuid?: string;
 	    }, x: number, y: number, rotation?: number, mirror?: boolean): Promise<ISCH_PrimitiveCbbSymbolComponent | undefined>;
 	    /**
 	     * 放置复用模块原理图图页
@@ -15252,19 +15583,41 @@ declare global {
 	     *
 	     * 本接口的返回时机并不会等待用户的放置操作，一旦器件被绑定到鼠标，本接口将立即返回 `true` 的结果
 	     * @param component - 关联库器件
+	     * @param subPartName - 子部件名称
 	     * @returns 是否找到器件
 	     */
 	    placeComponentWithMouse(component: {
 	        libraryUuid: string;
 	        uuid: string;
-	    } | ILIB_DeviceItem, subPartName?: string): Promise<boolean>;
+	    } | ILIB_DeviceItem | ILIB_DeviceSearchItem, subPartName?: string): Promise<boolean>;
+	    /**
+	     * 使用鼠标放置符号
+	     *
+	     * @alpha
+	     * @remarks
+	     * DEFINED since API v0.2.26
+	     *
+	     * 本接口模拟前端点击放置按钮，指定的符号将绑定到当前鼠标，并在用户后续点击时放置于画布
+	     *
+	     * 本接口的返回时机并不会等待用户的放置操作，一旦符号被绑定到鼠标，本接口将立即返回 `true` 的结果
+	     * @param symbol - 关联库符号
+	     * @param subPartName - 子部件名称
+	     * @param properties - 器件属性
+	     * @returns 是否找到符号
+	     */
+	    placeSymbolWithMouse(symbol: {
+	        libraryUuid: string;
+	        uuid: string;
+	    } | ILIB_SymbolItem | ILIB_SymbolSearchItem, subPartName?: string, properties?: {
+	        [key: string]: boolean | number | string | undefined;
+	    }): Promise<boolean>;
 	    /**
 	     * 获取所有器件的所有属性名称集合
 	     *
 	     * @alpha
 	     * @returns 所有器件的所有属性名称集合
 	     */
-	    getAllPropertyNames(): Promise<string[]>;
+	    getAllPropertyNames(): Promise<Array<string>>;
 	    /**
 	     * 到 pro-ui 获取器件的详细信息
 	     *
@@ -15317,8 +15670,8 @@ declare global {
 	    /** 器件类型 */
 	    private componentType;
 	    /** 关联库器件 */
-	    private component;
-	    /** 子图块名称 */
+	    private component?;
+	    /** 子部件名称 */
 	    private subPartName?;
 	    /** Component 属性：是否加入 BOM */
 	    private addIntoBom?;
@@ -15350,6 +15703,7 @@ declare global {
 	     * @internal
 	     */
 	    constructor(componentType: ESCH_PrimitiveComponentType, component: {
+	        libraryType?: ELIB_LibraryType.DEVICE | ELIB_LibraryType.SYMBOL;
 	        libraryUuid: string;
 	        uuid: string;
 	        name?: string;
@@ -15402,7 +15756,7 @@ declare global {
 	        libraryUuid: string;
 	        uuid: string;
 	        name?: string;
-	    };
+	    } | undefined;
 	    /**
 	     * 获取属性状态：坐标 X
 	     *
@@ -15418,10 +15772,10 @@ declare global {
 	     */
 	    getState_Y(): number;
 	    /**
-	     * 获取属性状态：子图块名称
+	     * 获取属性状态：子部件名称
 	     *
 	     * @public
-	     * @returns 子图块名称
+	     * @returns 子部件名称
 	     */
 	    getState_SubPartName(): string | undefined;
 	    /**
@@ -15712,10 +16066,10 @@ declare global {
 	     */
 	    private setState_Component;
 	    /**
-	     * 设置属性状态：子图块名称
+	     * 设置属性状态：子部件名称
 	     *
 	     * @internal
-	     * @param subPartName - 子图块名称
+	     * @param subPartName - 子部件名称
 	     * @returns 器件图元对象
 	     */
 	    private setState_SubPartName;
@@ -15731,7 +16085,11 @@ declare global {
 	     *
 	     */
 	    private cbb;
-	    /** 关联复用模块符号，cbbUuid是来源工程的uuid，uuid是来源符号的uuid */
+	    /**
+	     * 关联复用模块符号
+	     *
+	     * @remarks libraryUuid 是 CBB 工程所在库的 UUID，cbbUuid 是 CBB 工程的 UUID，uuid 是 CBB 工程内符号的 UUID，name 是符号的显示名称
+	     */
 	    private cbbSymbol;
 	    /**
 	     * @internal
@@ -15739,7 +16097,7 @@ declare global {
 	    constructor(cbbSymbol: {
 	        libraryUuid: string;
 	        cbbUuid: string;
-	        uuid: string;
+	        uuid?: string;
 	        name?: string;
 	    }, x: number, y: number, rotation?: number, mirror?: boolean, primitiveId?: string, symbol?: {
 	        libraryUuid: string;
@@ -15772,7 +16130,7 @@ declare global {
 	    getState_CbbSymbol(): {
 	        libraryUuid: string;
 	        cbbUuid: string;
-	        uuid: string;
+	        uuid?: string;
 	        name?: string;
 	    };
 	    /**
@@ -17653,7 +18011,7 @@ declare global {
 	     */
 	    listFilesOfFileSystem(folderPath: string, recursive?: boolean): Promise<Array<ISYS_FileSystemFileList>>;
 	    /**
-	     * 删除文件系统内的文件
+	     * 删除文件系统内���文件
 	     *
 	     * @beta
 	     * @remarks
@@ -18008,7 +18366,7 @@ declare global {
 	     *
 	     * 本接口新增的子菜单将默认排列在原菜单的结尾
 	     *
-	     * 注意：本接口需要使用者启用扩展的外部交互权限，如若未启用将始��� `throw Error`
+	     * 注意：本接口需要使用者启用扩展的外部交互权限，如若未启用将始终 `throw Error`
 	     *
 	     * 非公开接口使用提醒：本接口按原样提供，不提供参数的额外文档，参数可能在任何版本出现破坏性更改并不另行通知
 	     * @param headerMenus - 顶部菜单数据
@@ -19177,7 +19535,7 @@ declare global {
 	     *
 	     * @beta
 	     * @param netlist1 - 网表 1，可以为：①当前工程内的原理图、PCB 的 UUID；②其它工程的工程 UUID 和原理图、PCB UUID；③原理图、PCB 文件数据
-	     * @param netlist2 - 网表 2，可以为：①当前工程内的原理图、PCB 的 UUID；②其它工程的工程 UUID 和原理图、PCB UUID；③原理图、PCB 文件数据
+	     * @param netlist2 - ���表 2，可以为：①当前工程内的原理图、PCB 的 UUID；②其它工程的工程 UUID 和原理图、PCB UUID；③原理图、PCB 文件数据
 	     * @returns 网表对比结果
 	     */
 	    netlistComparison(netlist1: string | {

package/package.json

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