@jlceda/pro-api-types 0.2.25 → 0.2.27

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?: {
@@ -2326,7 +2331,7 @@ declare global {
 	     *
 	     * @alpha
 	     * @remarks
-	     * 注意：本接口仅客户端有效，在浏览器环境内调用将始终 `throw Error`
+	     * 注意：本接口仅全离线客户端有效，在浏览器环境内调用将始终 `throw Error`
 	     * @param properties - 属性
 	     * @param libraryUuid - 库 UUID，默认为系统库，可以使用 {@link LIB_LibrariesList} 内的接口获取
 	     * @param classification - 分类，默认为全部
@@ -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,8 +5431,24 @@ 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>;
+	    /**
+	     * 获取 JRouter 专用自动布线文件（JSON）
+	     *
+	     * @beta
+	     * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
+	     * @param fileName - 文件名
+	     * @returns 自动布线 JSON 文件数据
+	     */
+	    getAutoRouteJsonFileForJRouter(fileName?: string): Promise<File | undefined>;
 	    /**
 	     * 获取自动布局文件（JSON）
 	     *
@@ -5189,6 +5456,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 +5472,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 +5489,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 +5506,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 +5521,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>;
 	    /**
@@ -5685,7 +5989,7 @@ declare global {
 	     */
 	    unhighlightNet(net: string): Promise<boolean>;
 	    /**
-	     * 取消高亮所有网络
+	     * 取消高亮��有网络
 	     *
 	     * @beta
 	     * @returns 操作是否成功
@@ -6821,7 +7125,7 @@ declare global {
 	     * 获取文本
 	     *
 	     * @alpha
-	     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+	     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的��元对象
 	     * @param primitiveIds - 文本的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
 	     * @returns 文本图元对象，空数组表示获取失败
 	     */
@@ -7815,7 +8119,7 @@ declare global {
 	     * 删除区域
 	     *
 	     * @beta
-	     * @param primitiveIds - 区域的���元 ID 或区域图元对象
+	     * @param primitiveIds - 区域的图元 ID 或区域图元对象
 	     * @returns 删除操作是否成功
 	     */
 	    delete(primitiveIds: string | IPCB_PrimitiveRegion | Array<string> | Array<IPCB_PrimitiveRegion>): Promise<boolean>;
@@ -8578,7 +8882,7 @@ declare global {
 	     */
 	    getState_Polygon(): IPCB_Polygon;
 	    /**
-	     * 获取属性状态：线宽
+	     * ��取属性状态：线宽
 	     *
 	     * @public
 	     * @returns 线宽
@@ -9721,7 +10025,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 +10122,7 @@ declare global {
 	    /**
 	     * 使用鼠标放置器件
 	     *
-	     * @alpha
+	     * @beta
 	     * @remarks
 	     * 本接口模拟前端点击放置按钮，指定的器件将绑定到当前鼠标，并在用户后续点击时放置于画布
 	     *
@@ -9825,14 +10133,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 +10175,7 @@ declare global {
 	    /** 图元 ID */
 	    private primitiveId?;
 	    /** 关联库器件 */
-	    private component;
+	    private component?;
 	    /** 关联库封装 */
 	    private footprint?;
 	    /** 层 */
@@ -9886,14 +10214,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 +10263,8 @@ declare global {
 	    getState_Component(): {
 	        libraryUuid: string;
 	        uuid: string;
-	    };
+	        name?: string;
+	    } | undefined;
 	    /**
 	     * 获取属性状态：关联库封装
 	     *
@@ -9941,6 +10274,7 @@ declare global {
 	    getState_Footprint(): {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    } | undefined;
 	    /**
 	     * 获取属性状态：层
@@ -9993,6 +10327,7 @@ declare global {
 	    getState_Model3D(): {
 	        libraryUuid: string;
 	        uuid: string;
+	        name?: string;
 	    } | undefined;
 	    /**
 	     * 获取属性状态：位号
@@ -10721,7 +11056,7 @@ declare global {
 	     * 获取属性状态：图元类型
 	     *
 	     * @public
-	     * @returns 图元类型
+	     * @returns 图元类���
 	     */
 	    getState_PrimitiveType(): EPCB_PrimitiveType;
 	    /**
@@ -14080,7 +14415,7 @@ declare global {
 	 *
 	 * @public
 	 * @remarks
-	 * 器件引脚图元是一个特殊的图元，它指的是在原理图画布上关联到符号的引脚
+	 * 器件引脚图元是一个特��的图元，它指的是在原理图画布上关联到符号的引脚
 	 *
 	 * 器件引脚图元仅可更改 `pinNumber`、`noConnected` 属性，其它所有属性均为只读，
 	 * 并且你只能通过 {@link SCH_PrimitiveComponent.getAllPinsByPrimitiveId | 器件类的 getAllPinsByPrimitiveId 方法} 或 {@link ISCH_PrimitiveComponent.getAllPins | 器件图元的 getAllPins 方法} 获取到器件引脚图元
@@ -14495,14 +14830,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 +15407,7 @@ declare global {
 	     *
 	     * @beta
 	     * @param component - 关联库器件
-	     * @param subPartName - 子图块名称
+	     * @param subPartName - 子部件名称
 	     * @param x - 坐标 X
 	     * @param y - 坐标 Y
 	     * @param rotation - 旋转角度
@@ -15082,9 +15417,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 +15466,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 +15476,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 +15592,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 +15679,8 @@ declare global {
 	    /** 器件类型 */
 	    private componentType;
 	    /** 关联库器件 */
-	    private component;
-	    /** 子图块名称 */
+	    private component?;
+	    /** 子部件名称 */
 	    private subPartName?;
 	    /** Component 属性：是否加入 BOM */
 	    private addIntoBom?;
@@ -15350,6 +15712,7 @@ declare global {
 	     * @internal
 	     */
 	    constructor(componentType: ESCH_PrimitiveComponentType, component: {
+	        libraryType?: ELIB_LibraryType.DEVICE | ELIB_LibraryType.SYMBOL;
 	        libraryUuid: string;
 	        uuid: string;
 	        name?: string;
@@ -15402,7 +15765,7 @@ declare global {
 	        libraryUuid: string;
 	        uuid: string;
 	        name?: string;
-	    };
+	    } | undefined;
 	    /**
 	     * 获取属性状态：坐标 X
 	     *
@@ -15418,10 +15781,10 @@ declare global {
 	     */
 	    getState_Y(): number;
 	    /**
-	     * 获取属性状态：子图块名称
+	     * 获取属性状态：子部件名称
 	     *
 	     * @public
-	     * @returns 子图块名称
+	     * @returns 子部件名称
 	     */
 	    getState_SubPartName(): string | undefined;
 	    /**
@@ -15712,10 +16075,10 @@ declare global {
 	     */
 	    private setState_Component;
 	    /**
-	     * 设置属性状态：子图块名称
+	     * 设置属性状态：子部件名称
 	     *
 	     * @internal
-	     * @param subPartName - 子图块名称
+	     * @param subPartName - 子部件名称
 	     * @returns 器件图元对象
 	     */
 	    private setState_SubPartName;
@@ -15731,7 +16094,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 +16106,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 +16139,7 @@ declare global {
 	    getState_CbbSymbol(): {
 	        libraryUuid: string;
 	        cbbUuid: string;
-	        uuid: string;
+	        uuid?: string;
 	        name?: string;
 	    };
 	    /**
@@ -15798,6 +16165,301 @@ declare global {
 	    private setState_CbbSymbol;
 	}
 
+	/**
+	 * 原理图 & 符号 / 二进制内嵌对象图元类
+	 *
+	 * @public
+	 */
+	class SCH_PrimitiveObject implements ISCH_PrimitiveAPI {
+	    /**
+	     * 创建二进制内嵌对象
+	     *
+	     * @alpha
+	     * @param startX - 起点坐标 X
+	     * @param startY - 起点坐标 Y
+	     * @param width - 宽
+	     * @param height - 高
+	     * @param rotation - 旋转角度
+	     * @param mirror - 是否镜像
+	     * @param fileName - 文件名称
+	     * @param content - 对象内容
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    create(content: File | string, startX: number, startY: number, width?: number, height?: number, rotation?: number, mirror?: boolean, fileName?: string): Promise<ISCH_PrimitiveObject | undefined>;
+	    /**
+	     * 删除二进制内嵌对象
+	     *
+	     * @alpha
+	     * @param primitiveIds - 二进制内嵌对象的图元 ID 或二进制内嵌对象图元对象
+	     * @returns 删除操作是否成功
+	     */
+	    delete(primitiveIds: string | ISCH_PrimitiveObject | Array<string> | Array<ISCH_PrimitiveObject>): Promise<boolean>;
+	    /**
+	     * 修改二进制内嵌对象
+	     *
+	     * @alpha
+	     * @param primitiveId - 图元 ID
+	     * @param property - 修改参数
+	     * @returns 二进制内嵌对象图元对象，`undefined` 表示修改失败
+	     */
+	    modify(primitiveId: string | ISCH_PrimitiveObject, property: {
+	        content?: File | string;
+	        startX?: number;
+	        startY?: number;
+	        width?: number;
+	        height?: number;
+	        rotation?: number;
+	        mirror?: boolean;
+	        fileName?: string;
+	    }): Promise<ISCH_PrimitiveObject | undefined>;
+	    /**
+	     * 获取二进制内嵌对象
+	     *
+	     * @alpha
+	     * @param primitiveIds - 二进制内嵌对象的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+	     * @returns 二进制内嵌对象图元对象，`undefined` 表示获取失败
+	     */
+	    get(primitiveIds: string): Promise<ISCH_PrimitiveObject | undefined>;
+	    /**
+	     * 获取二进制内嵌对象
+	     *
+	     * @alpha
+	     * @remarks 如若传入多个图元 ID，任意图元 ID 未匹配到不影响其它图元的返回，即可能返回少于传入的图元 ID 数量的图元对象
+	     * @param primitiveIds - 二进制内嵌对象的图元 ID，可以为字符串或字符串数组，如若为数组，则返回的也是数组
+	     * @returns 二进制内嵌对象图元对象，空数组表示获取失败
+	     */
+	    get(primitiveIds: Array<string>): Promise<Array<ISCH_PrimitiveObject>>;
+	    /**
+	     * 获取所有二进制内嵌对象的图元 ID
+	     *
+	     * @alpha
+	     * @returns 二进制内嵌对象的图元 ID 数组
+	     */
+	    getAllPrimitiveId(): Promise<Array<string>>;
+	    /**
+	     * 获取所有二进制内嵌对象
+	     *
+	     * @alpha
+	     * @returns 二进制内嵌对象图元对象数组
+	     */
+	    getAll(): Promise<Array<ISCH_PrimitiveObject>>;
+	}
+	/**
+	 * 二进制内嵌对象图元
+	 *
+	 * @public
+	 */
+	class ISCH_PrimitiveObject implements ISCH_Primitive {
+	    /** 异步 */
+	    private async;
+	    /** 图元类型 */
+	    private readonly primitiveType;
+	    /** 图元 ID */
+	    private primitiveId?;
+	    /** 对象内容 */
+	    private content;
+	    /** 起点坐标 X */
+	    private startX;
+	    /** 起点坐标 Y */
+	    private startY;
+	    /** 宽度 */
+	    private width;
+	    /** 高度 */
+	    private height;
+	    /** 旋转角度 */
+	    private rotation;
+	    /** 是否镜像 */
+	    private mirror;
+	    /** 文件名称 */
+	    private fileName;
+	    /** @internal */
+	    constructor(content: File | string, startX: number, startY: number, width?: number, height?: number, rotation?: number, mirror?: boolean, fileName?: string, primitiveId?: string);
+	    /**
+	     * 在原理图画布中创建图元
+	     *
+	     * @internal
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    create(): Promise<ISCH_PrimitiveObject>;
+	    /**
+	     * 将 File 对象转换为 base64 字符串
+	     *
+	     * @internal
+	     * @param file - File 对象
+	     * @returns base64 字符串
+	     */
+	    private fileToBase64;
+	    /**
+	     * 获取属性状态：图元类型
+	     *
+	     * @public
+	     * @returns 图元类型
+	     */
+	    getState_PrimitiveType(): ESCH_PrimitiveType;
+	    /**
+	     * 获取属性状态：图元 ID
+	     *
+	     * @public
+	     * @returns 图元 ID
+	     */
+	    getState_PrimitiveId(): string;
+	    /**
+	     * 获取属性状态：对象内容
+	     *
+	     * @public
+	     * @returns 对象内容
+	     */
+	    getState_Content(): File | string;
+	    /**
+	     * 获取属性状态：坐标 X
+	     *
+	     * @public
+	     * @returns 坐标 X
+	     */
+	    getState_StartX(): number;
+	    /**
+	     * 获取属性状态：坐标 Y
+	     *
+	     * @public
+	     * @returns 坐标 Y
+	     */
+	    getState_StartY(): number;
+	    /**
+	     * 获取属性状态：宽度
+	     *
+	     * @public
+	     * @returns 宽度
+	     */
+	    getState_Width(): number;
+	    /**
+	     * 获取属性状态：高度
+	     *
+	     * @public
+	     * @returns 高度
+	     */
+	    getState_Height(): number;
+	    /**
+	     * 获取属性状态：旋转角度
+	     *
+	     * @public
+	     * @returns 旋转角度
+	     */
+	    getState_Rotation(): number;
+	    /**
+	     * 获取属性状态：是否镜像
+	     *
+	     * @public
+	     * @returns 是否镜像
+	     */
+	    getState_Mirror(): boolean;
+	    /**
+	     * 获取属性状态：文件名称
+	     *
+	     * @public
+	     * @returns 文件名称
+	     */
+	    getState_FileName(): string;
+	    /**
+	     * 设置属性状态：对象内容
+	     *
+	     * @beta
+	     * @param content - 对象内容
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    setState_Content(content: File | string): ISCH_PrimitiveObject;
+	    /**
+	     * 设置属性状态：起点坐标 X
+	     *
+	     * @beta
+	     * @param startX - 起点坐标 X
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    setState_StartX(startX: number): ISCH_PrimitiveObject;
+	    /**
+	     * 设置属性状态：起点坐标 Y
+	     *
+	     * @beta
+	     * @param startY - 起点坐标 Y
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    setState_StartY(startY: number): ISCH_PrimitiveObject;
+	    /**
+	     * 设置属性状态：宽度
+	     *
+	     * @beta
+	     * @param width - 宽度
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    setState_Width(width: number): ISCH_PrimitiveObject;
+	    /**
+	     * 设置属性状态：高度
+	     *
+	     * @beta
+	     * @param height - 高度
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    setState_Height(height: number): ISCH_PrimitiveObject;
+	    /**
+	     * 设置属性状态：旋转角度
+	     *
+	     * @beta
+	     * @param rotation - 旋转角度
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    setState_Rotation(rotation: number): ISCH_PrimitiveObject;
+	    /**
+	     * 设置属性状态：是否镜像
+	     *
+	     * @beta
+	     * @param mirror - 是否镜像
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    setState_Mirror(mirror: boolean): ISCH_PrimitiveObject;
+	    /**
+	     * 设置属性状态：文件名称
+	     *
+	     * @beta
+	     * @param fileName - 文件名称
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    setState_FileName(fileName: string): ISCH_PrimitiveObject;
+	    /**
+	     * 将图元转换为异步图元
+	     *
+	     * @public
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    toAsync(): ISCH_PrimitiveObject;
+	    /**
+	     * 将图元转换为同步图元
+	     *
+	     * @public
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    toSync(): ISCH_PrimitiveObject;
+	    /**
+	     * 查询图元是否为异步图元
+	     *
+	     * @public
+	     * @returns 是否为异步图元
+	     */
+	    isAsync(): boolean;
+	    /**
+	     * 将异步图元重置为当前画布状态
+	     *
+	     * @alpha
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    reset(): Promise<ISCH_PrimitiveObject>;
+	    /**
+	     * 将对图元的更改应用到画布
+	     *
+	     * @alpha
+	     * @returns 二进制内嵌对象图元对象
+	     */
+	    done(): Promise<ISCH_PrimitiveObject>;
+	}
+
 	/**
 	 * 原理图 & 符号 / 多边形（折线）图元类
 	 *
@@ -17711,7 +18373,7 @@ declare global {
 	     *
 	     * @beta
 	     * @remarks
-	     * 注意 1：本接口仅离线客户端有效，在浏览器环境内调用将始终 `throw Error`
+	     * 注意 1：本接口仅半、全离线客户端有效，在浏览器环境内调用将始终 `throw Error`
 	     *
 	     * 注意 2：本接口需要使用者启用扩展的外部交互权限，如若未启用将始终 `throw Error`
 	     * @returns 工程目录路径数组
@@ -18008,7 +18670,7 @@ declare global {
 	     *
 	     * 本接口新增的子菜单将默认排列在原菜单的结尾
 	     *
-	     * 注意：本接口需要使用者启用扩展的外部交互权限，如若未启用将始��� `throw Error`
+	     * 注意：本接口需要使用者启用扩展的外部交互权限，如若未启用将始终 `throw Error`
 	     *
 	     * 非公开接口使用提醒：本接口按原样提供，不提供参数的额外文档，参数可能在任何版本出现破坏性更改并不另行通知
 	     * @param headerMenus - 顶部菜单数据
@@ -19480,6 +20142,7 @@ declare global {
 	    sch_SelectControl: SCH_SelectControl;
 	    sch_SimulationEngine: SCH_SimulationEngine;
 	    sch_Utils: SCH_Utils;
+	    sch_PrimitiveObject: SCH_PrimitiveObject;
 	    sys_ClientUrl: SYS_ClientUrl;
 	    sys_Dialog: SYS_Dialog;
 	    sys_Environment: SYS_Environment;

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.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" } }