dom-to-vector-pdf 0.0.1 → 0.0.3

package/README.md

@@ -1,14 +1,79 @@
 # dom-to-vector-pdf
 
-DOM 转矢量 PDF
-
-1. 克隆元素时对原页面的影响
-   - 内联控制（current）
-     - 样式优先级
-   - Shadow DOM
-   - iframe
-2. iconfont 大小问题：目前是默认 16px 字体大小来做的缩放
-3. 原来的 DOM 中本身存在的 SVG 用的内联样式来决定样式
-   - 目前只支持内联中属性名和元素属性名一致的情况
-4. 页面整体转换出来的文字对比背景要偏下一点
-   - 目前是暂时所有文字整体上移 3 个像素单位
+A tool for converting DOM elements to vector PDFs using jsPDF, dom-to-svg and svg2pdf.js.
+
+## Basic Usage
+
+```javascript
+import vectorInstance from "dom-to-vector-pdf";
+
+export const ExportToPDF = (id, title) => {
+  vectorInstance.registerFont([
+    {
+      font: PingFangRegular,
+      fontId: "PingFang",
+      fontWeight: "400",
+      fontStyle: "normal",
+    },
+    {
+      font: PingFangHeavy,
+      fontId: "PingFang",
+      fontWeight: "700",
+      fontStyle: "normal",
+    },
+  ]);
+  vectorInstance.export({
+    id,
+    filename: title,
+  });
+};
+```
+
+## Features
+
+- Converts DOM elements to vector PDFs
+- Preserves vector graphics and text
+- Supports SVG elements
+- Maintains font styles and weights
+- Handles complex layouts
+
+## Todo List
+
+### DOM Cloning
+- [ ] Inline style handling
+  - [ ] Style priority management
+- [ ] Shadow DOM support
+- [ ] iframe support
+
+### Icon Fonts
+- [ ] Current implementation uses 16px as base font size for scaling
+- [ ] Need to improve icon font size handling
+
+### SVG Support
+- [ ] Currently only supports inline styles where property names match element attributes
+- [ ] Need to enhance SVG style handling
+
+### Text Alignment
+- [ ] Text appears slightly lower than background
+  - Current workaround: Shift all text up by 3 pixels
+
+### Unsupported Features
+- [ ] Image background export
+- [ ] Canvas export
+
+### Font Support
+- [ ] Currently limited to single font family
+  - Font ID must be consistent during registration
+- [ ] Need to add support for multiple fonts
+- [ ] Consider WOFF2 format compatibility
+
+### Image Export
+- [ ] Image export quality needs improvement
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,79 @@
+# dom-to-vector-pdf
+
+一个使用 jsPDF、dom-to-svg 和 svg2pdf.js 将 DOM 元素转换为矢量 PDF 的工具。
+
+## 基础使用
+
+```javascript
+import vectorInstance from "dom-to-vector-pdf";
+
+export const ExportToPDF = (id, title) => {
+  vectorInstance.registerFont([
+    {
+      font: PingFangRegular,
+      fontId: "PingFang",
+      fontWeight: "400",
+      fontStyle: "normal",
+    },
+    {
+      font: PingFangHeavy,
+      fontId: "PingFang",
+      fontWeight: "700",
+      fontStyle: "normal",
+    },
+  ]);
+  vectorInstance.export({
+    id,
+    filename: title,
+  });
+};
+```
+
+## 功能特点
+
+- 将 DOM 元素转换为矢量 PDF
+- 保持矢量图形和文本质量
+- 支持 SVG 元素
+- 保持字体样式和字重
+- 处理复杂布局
+
+## 待办事项
+
+### DOM 克隆
+- [ ] 内联样式处理
+  - [ ] 样式优先级管理
+- [ ] Shadow DOM 支持
+- [ ] iframe 支持
+
+### 图标字体
+- [ ] 当前实现使用 16px 作为基础字体大小进行缩放
+- [ ] 需要改进图标字体大小处理
+
+### SVG 支持
+- [ ] 目前仅支持属性名与元素属性名一致的内联样式
+- [ ] 需要增强 SVG 样式处理
+
+### 文本对齐
+- [ ] 文字相对背景略微偏下
+  - 当前解决方案：所有文字整体上移 3 个像素单位
+
+### 不支持的功能
+- [ ] 图片背景导出
+- [ ] Canvas 导出
+
+### 字体支持
+- [ ] 目前仅支持单一字体系列
+  - 注册字体时 fontId 必须一致
+- [ ] 需要添加多字体支持
+- [ ] 考虑兼容 WOFF2 格式
+
+### 图片导出
+- [ ] 图片导出效果需要改进
+
+## 贡献
+
+欢迎贡献代码！请随时提交 Pull Request。
+
+## 许可证
+
+MIT 

package/dist/dom-converter.d.ts

@@ -1,28 +1,28 @@
 import type { ExportPdfOptions, LifecycleHooks } from './types';
 /**
- * DOM转PDF转换器
+ * DOM to PDF Converter
  */
 export declare class DomToPdfConverter {
     private fontManager;
     constructor();
     /**
-     * 导出PDF
+     * Export PDF
      */
     exportPdf(options: ExportPdfOptions, hooks?: LifecycleHooks): Promise<void>;
     /**
-     * 准备DOM元素
+     * Prepare DOM element
      */
     private prepareDomElement;
     /**
-     * 准备SVG元素
+     * Prepare SVG element
      */
     private prepareSvgElement;
     /**
-     * 创建PDF文档
+     * Create PDF document
      */
     private createPdfDocument;
     /**
-     * 渲染SVG到PDF
+     * Render SVG to PDF
      */
     private renderSvgToPdf;
 }

package/dist/font-manager.d.ts

@@ -1,32 +1,37 @@
 import { jsPDF } from 'jspdf';
 import type { FontRegisterOptions } from './types';
 /**
- * 字体管理器
+ * Font manager
  */
 export declare class FontManager {
     private static instance;
     private registeredFonts;
     private pdfInstance?;
     private callbackList;
+    private fontId;
     private constructor();
     /**
-     * 获取字体管理器单例
+     * Get font ID
+     */
+    getFontId(): string;
+    /**
+     * Get font manager singleton
      */
     static getInstance(): FontManager;
     /**
-     * 设置PDF实例
+     * Set PDF instance
      */
-    setPdfInstance(pdf: jsPDF): void;
+    setPdfInstance(pdf: jsPDF | null): void;
     /**
-     * 注册字体
+     * Register font
      */
     registerFont(options: FontRegisterOptions): void;
     /**
-     * 批量注册字体
+     * Batch register fonts
      */
     registerFonts(options: FontRegisterOptions[]): void;
     /**
-     * 添加字体到PDF实例
+     * Add font to PDF instance
      */
     private addFontToPdf;
 }

package/dist/font-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"font-manager.d.ts","sourceRoot":"","sources":["../src/font-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,YAAY,CAAsB;IAE1C,OAAO;IAEP;;OAEG;WACW,WAAW,IAAI,WAAW;IAOxC;;OAEG;IACI,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI;IAMvC;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAIvD;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,IAAI;IAI1D;;OAEG;IACH,OAAO,CAAC,YAAY;CAYrB"}
+{"version":3,"file":"font-manager.d.ts","sourceRoot":"","sources":["../src/font-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,MAAM,CAAsB;IAEpC,OAAO;IAEP;;OAEG;IACI,SAAS,IAAI,MAAM;IAI1B;;OAEG;WACW,WAAW,IAAI,WAAW;IAOxC;;OAEG;IACI,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI;IAM9C;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAKvD;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,IAAI;IAI1D;;OAEG;IACH,OAAO,CAAC,YAAY;CAYrB"}

package/dist/index.d.ts

@@ -1,23 +1,23 @@
 import type { ExportPdfOptions, FontRegisterOptions, LifecycleHooks } from './types';
 /**
- * DOM转PDF工具实例
+ * DOM to PDF tool instance
  */
-declare class DomToPdf {
+declare class DOMToPDF {
     private converter;
     private fontManager;
     constructor();
     /**
-     * 导出PDF
-     * @param options 导出配置
-     * @param hooks 生命周期钩子
+     * Export PDF
+     * @param options Export configuration
+     * @param hooks Lifecycle hooks
      */
-    export(options: ExportPdfOptions, hooks?: LifecycleHooks): Promise<void>;
+    exportPDF(options: ExportPdfOptions, hooks?: LifecycleHooks): Promise<void>;
     /**
-     * 注册字体
-     * @param options 字体注册选项
+     * Register font
+     * @param options Font registration options
      */
     registerFont(options: FontRegisterOptions | FontRegisterOptions[]): void;
 }
-export declare const instance: DomToPdf;
+export declare const instance: DOMToPDF;
 export default instance;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAErF;;GAEG;AACH,cAAM,QAAQ;IACZ,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAc;;IAOjC;;;;OAIG;IACU,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrF;;;OAGG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,GAAG,IAAI;CAOhF;AAGD,eAAO,MAAM,QAAQ,UAAiB,CAAC;AACvC,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAErF;;GAEG;AACH,cAAM,QAAQ;IACZ,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAc;;IAOjC;;;;OAIG;IACU,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxF;;;OAGG;IACI,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,GAAG,IAAI;CAOhF;AAGD,eAAO,MAAM,QAAQ,UAAiB,CAAC;AACvC,eAAe,QAAQ,CAAC"}

package/dist/index.esm.js

@@ -3,9 +3,9 @@ import { elementToSVG } from 'dom-to-svg';
 import { svg2pdf } from 'svg2pdf.js';
 
 /**
- * 转换字体字重
- * @param weight 字体粗细
- * @returns 标准化后的字重
+ * Convert font weight
+ * @param weight Font weight
+ * @returns Normalized font weight
  */
 function normalizeFontWeight(weight) {
     const weightMap = {
@@ -15,7 +15,7 @@ function normalizeFontWeight(weight) {
     return weightMap[weight?.toString() || 'normal'] || weight?.toString() || '400';
 }
 /**
- * 计算SVG symbol的缩放比例
+ * Calculate SVG symbol scale ratio
  */
 function calculateSymbolScale(symbol) {
     const viewBox = symbol.getAttribute('viewBox');
@@ -28,7 +28,7 @@ function calculateSymbolScale(symbol) {
     return expectedSize / width;
 }
 /**
- * 内联SVG中的symbol元素
+ * Symbol element in inline SVG
  */
 function inlineSvgSymbols(element) {
     const uses = element.querySelectorAll('use');
@@ -41,34 +41,34 @@ function inlineSvgSymbols(element) {
         if (!symbol) {
             return;
         }
-        // 创建 <g> 容器保留所有属性
+        // Create <g> container preserving all attributes
         const g = document.createElementNS('http://www.w3.org/2000/svg', 'g');
-        // 复制除href外的所有属性
+        // Copy all attributes except href
         Array.from(use.attributes).forEach((attr) => {
             if (attr.name !== 'xlink:href' && attr.name !== 'href') {
                 g.setAttribute(attr.name, attr.value);
             }
         });
-        // 插入缩放后的路径
+        // Insert scaled path
         g.innerHTML = `
         <g transform="scale(${calculateSymbolScale(symbol)})">
           ${symbol.innerHTML}
         </g>
       `;
-        // 替换并保留父SVG尺寸
+        // Replace and preserve parent SVG dimensions
         use.replaceWith(g);
     });
 }
 /**
- * 递归处理SVG元素的字体属性
+ * Recursively process SVG element font attributes
  */
-function processSvgFonts(element) {
+function processSvgFonts(element, fontManager) {
     if (element.classList.contains('no-print')) {
         element.remove();
         return;
     }
     if (element.tagName === 'text' || element.tagName === 'tspan') {
-        // 解析style字符串
+        // Parse style string
         const style = element.getAttribute('style');
         if (style) {
             style.split(';').forEach((css) => {
@@ -83,29 +83,36 @@ function processSvgFonts(element) {
         const fontWeight = element.getAttribute('font-weight');
         // TODO
         if (fontFamily) {
-            element.setAttribute('font-family', 'PingFang');
+            element.setAttribute('font-family', fontManager.getFontId());
             element.setAttribute('font-weight', normalizeFontWeight(fontWeight));
         }
-        // 调整y坐标
+        // Adjust y coordinate
         const y = element.getAttribute('y');
         if (y) {
             element.setAttribute('y', String(Number(y) - 3));
         }
     }
-    // 递归处理子元素
-    Array.from(element.children).forEach((child) => processSvgFonts(child));
+    // Recursively process child elements
+    Array.from(element.children).forEach((child) => processSvgFonts(child, fontManager));
 }
 
 /**
- * 字体管理器
+ * Font manager
  */
 class FontManager {
     constructor() {
         this.registeredFonts = new Map();
         this.callbackList = [];
+        this.fontId = 'PingFang';
     }
     /**
-     * 获取字体管理器单例
+     * Get font ID
+     */
+    getFontId() {
+        return this.fontId;
+    }
+    /**
+     * Get font manager singleton
      */
     static getInstance() {
         if (!FontManager.instance) {
@@ -114,7 +121,7 @@ class FontManager {
         return FontManager.instance;
     }
     /**
-     * 设置PDF实例
+     * Set PDF instance
      */
     setPdfInstance(pdf) {
         this.pdfInstance = pdf;
@@ -122,19 +129,20 @@ class FontManager {
         this.callbackList = [];
     }
     /**
-     * 注册字体
+     * Register font
      */
     registerFont(options) {
+        this.fontId = options.fontId;
         this.addFontToPdf(options);
     }
     /**
-     * 批量注册字体
+     * Batch register fonts
      */
     registerFonts(options) {
         options.map((font) => this.registerFont(font));
     }
     /**
-     * 添加字体到PDF实例
+     * Add font to PDF instance
      */
     addFontToPdf(options) {
         if (!this.pdfInstance) {
@@ -146,44 +154,44 @@ class FontManager {
 }
 
 /**
- * DOM转PDF转换器
+ * DOM to PDF Converter
  */
 class DomToPdfConverter {
     constructor() {
         this.fontManager = FontManager.getInstance();
     }
     /**
-     * 导出PDF
+     * Export PDF
      */
     async exportPdf(options, hooks) {
         try {
-            // 1. 获取并克隆DOM元素
+            // 1. Get and clone DOM element
             const { element, parentElement } = this.prepareDomElement(options.id);
-            // 调用生命周期钩子
+            // Call lifecycle hook
             hooks?.afterDomClone?.(element);
-            // 2. 处理SVG符号
+            // 2. Process SVG symbols
             inlineSvgSymbols(element);
-            // 3. 转换为SVG
+            // 3. Convert to SVG
             const svgDocument = elementToSVG(element);
             parentElement?.removeChild(element);
             const svgElement = svgDocument.documentElement;
             document.body.appendChild(svgElement);
             this.prepareSvgElement(svgElement);
-            // 4. 处理SVG字体
-            processSvgFonts(svgElement);
-            // 调用生命周期钩子
+            // 4. Process SVG fonts
+            processSvgFonts(svgElement, this.fontManager);
+            // Call lifecycle hook
             hooks?.beforeSvgConvert?.(svgElement);
-            // 5. 创建PDF文档
+            // 5. Create PDF document
             const pdf = this.createPdfDocument(svgElement);
             this.fontManager.setPdfInstance(pdf);
-            // 6. 绘制SVG内容到PDF
+            // 6. Draw SVG content to PDF
             await this.renderSvgToPdf(svgElement, pdf);
-            // 调用生命周期钩子
+            // Call lifecycle hook
             hooks?.beforePdfGenerate?.(pdf);
             hooks?.beforePdfSave?.(pdf);
-            // 7. 保存PDF
+            // 7. Save PDF
             pdf.save(`${options.filename}.pdf`);
-            // 8. 清理临时元素
+            // 8. Clean up temporary elements
             svgElement.remove();
             this.fontManager.setPdfInstance(null);
         }
@@ -193,7 +201,7 @@ class DomToPdfConverter {
         }
     }
     /**
-     * 准备DOM元素
+     * Prepare DOM element
      */
     prepareDomElement(id) {
         const originElement = document.querySelector(id);
@@ -202,7 +210,7 @@ class DomToPdfConverter {
         }
         const parentElement = originElement.parentElement;
         const element = originElement.cloneNode(true);
-        // 设置克隆元素的样式
+        // Set cloned element styles
         element.style.cssText = `
           z-index: -999999;
           position: absolute;
@@ -214,7 +222,7 @@ class DomToPdfConverter {
         return { element, parentElement };
     }
     /**
-     * 准备SVG元素
+     * Prepare SVG element
      */
     prepareSvgElement(svgElement) {
         svgElement.style.cssText = `
@@ -225,12 +233,12 @@ class DomToPdfConverter {
       left: 0;
       z-index: -999999;
     `;
-        // 添加XML声明
+        // Add XML declaration
         const utf8Declaration = document.createTextNode('<?xml version="1.0" encoding="utf-8"?>');
         svgElement.insertBefore(utf8Declaration, svgElement.firstChild);
     }
     /**
-     * 创建PDF文档
+     * Create PDF document
      */
     createPdfDocument(svgElement) {
         const { width, height } = svgElement.getBoundingClientRect();
@@ -241,7 +249,7 @@ class DomToPdfConverter {
         });
     }
     /**
-     * 渲染SVG到PDF
+     * Render SVG to PDF
      */
     async renderSvgToPdf(svgElement, pdf) {
         await svg2pdf(svgElement, pdf, {
@@ -254,24 +262,24 @@ class DomToPdfConverter {
 }
 
 /**
- * DOM转PDF工具实例
+ * DOM to PDF tool instance
  */
-class DomToPdf {
+class DOMToPDF {
     constructor() {
         this.converter = new DomToPdfConverter();
         this.fontManager = FontManager.getInstance();
     }
     /**
-     * 导出PDF
-     * @param options 导出配置
-     * @param hooks 生命周期钩子
+     * Export PDF
+     * @param options Export configuration
+     * @param hooks Lifecycle hooks
      */
-    async export(options, hooks) {
+    async exportPDF(options, hooks) {
         await this.converter.exportPdf(options, hooks);
     }
     /**
-     * 注册字体
-     * @param options 字体注册选项
+     * Register font
+     * @param options Font registration options
      */
     registerFont(options) {
         if (Array.isArray(options)) {
@@ -282,7 +290,7 @@ class DomToPdf {
         }
     }
 }
-// 导出单例实例
-const instance = new DomToPdf();
+// Export singleton instance
+const instance = new DOMToPDF();
 
 export { instance as default, instance };

package/dist/index.js

@@ -1,13 +1,13 @@
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('jspdf'), require('dom-to-svg'), require('svg2pdf.js')) :
     typeof define === 'function' && define.amd ? define(['exports', 'jspdf', 'dom-to-svg', 'svg2pdf.js'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.DomToPdf = {}, global.jspdf, global.domToSvg, global.svg2pdf_js));
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.DOMToPDF = {}, global.jspdf, global.domToSvg, global.svg2pdf_js));
 })(this, (function (exports, jspdf, domToSvg, svg2pdf_js) { 'use strict';
 
     /**
-     * 转换字体字重
-     * @param weight 字体粗细
-     * @returns 标准化后的字重
+     * Convert font weight
+     * @param weight Font weight
+     * @returns Normalized font weight
      */
     function normalizeFontWeight(weight) {
         const weightMap = {
@@ -17,7 +17,7 @@
         return weightMap[weight?.toString() || 'normal'] || weight?.toString() || '400';
     }
     /**
-     * 计算SVG symbol的缩放比例
+     * Calculate SVG symbol scale ratio
      */
     function calculateSymbolScale(symbol) {
         const viewBox = symbol.getAttribute('viewBox');
@@ -30,7 +30,7 @@
         return expectedSize / width;
     }
     /**
-     * 内联SVG中的symbol元素
+     * Symbol element in inline SVG
      */
     function inlineSvgSymbols(element) {
         const uses = element.querySelectorAll('use');
@@ -43,34 +43,34 @@
             if (!symbol) {
                 return;
             }
-            // 创建 <g> 容器保留所有属性
+            // Create <g> container preserving all attributes
             const g = document.createElementNS('http://www.w3.org/2000/svg', 'g');
-            // 复制除href外的所有属性
+            // Copy all attributes except href
             Array.from(use.attributes).forEach((attr) => {
                 if (attr.name !== 'xlink:href' && attr.name !== 'href') {
                     g.setAttribute(attr.name, attr.value);
                 }
             });
-            // 插入缩放后的路径
+            // Insert scaled path
             g.innerHTML = `
         <g transform="scale(${calculateSymbolScale(symbol)})">
           ${symbol.innerHTML}
         </g>
       `;
-            // 替换并保留父SVG尺寸
+            // Replace and preserve parent SVG dimensions
             use.replaceWith(g);
         });
     }
     /**
-     * 递归处理SVG元素的字体属性
+     * Recursively process SVG element font attributes
      */
-    function processSvgFonts(element) {
+    function processSvgFonts(element, fontManager) {
         if (element.classList.contains('no-print')) {
             element.remove();
             return;
         }
         if (element.tagName === 'text' || element.tagName === 'tspan') {
-            // 解析style字符串
+            // Parse style string
             const style = element.getAttribute('style');
             if (style) {
                 style.split(';').forEach((css) => {
@@ -85,29 +85,36 @@
             const fontWeight = element.getAttribute('font-weight');
             // TODO
             if (fontFamily) {
-                element.setAttribute('font-family', 'PingFang');
+                element.setAttribute('font-family', fontManager.getFontId());
                 element.setAttribute('font-weight', normalizeFontWeight(fontWeight));
             }
-            // 调整y坐标
+            // Adjust y coordinate
             const y = element.getAttribute('y');
             if (y) {
                 element.setAttribute('y', String(Number(y) - 3));
             }
         }
-        // 递归处理子元素
-        Array.from(element.children).forEach((child) => processSvgFonts(child));
+        // Recursively process child elements
+        Array.from(element.children).forEach((child) => processSvgFonts(child, fontManager));
     }
 
     /**
-     * 字体管理器
+     * Font manager
      */
     class FontManager {
         constructor() {
             this.registeredFonts = new Map();
             this.callbackList = [];
+            this.fontId = 'PingFang';
         }
         /**
-         * 获取字体管理器单例
+         * Get font ID
+         */
+        getFontId() {
+            return this.fontId;
+        }
+        /**
+         * Get font manager singleton
          */
         static getInstance() {
             if (!FontManager.instance) {
@@ -116,7 +123,7 @@
             return FontManager.instance;
         }
         /**
-         * 设置PDF实例
+         * Set PDF instance
          */
         setPdfInstance(pdf) {
             this.pdfInstance = pdf;
@@ -124,19 +131,20 @@
             this.callbackList = [];
         }
         /**
-         * 注册字体
+         * Register font
          */
         registerFont(options) {
+            this.fontId = options.fontId;
             this.addFontToPdf(options);
         }
         /**
-         * 批量注册字体
+         * Batch register fonts
          */
         registerFonts(options) {
             options.map((font) => this.registerFont(font));
         }
         /**
-         * 添加字体到PDF实例
+         * Add font to PDF instance
          */
         addFontToPdf(options) {
             if (!this.pdfInstance) {
@@ -148,44 +156,44 @@
     }
 
     /**
-     * DOM转PDF转换器
+     * DOM to PDF Converter
      */
     class DomToPdfConverter {
         constructor() {
             this.fontManager = FontManager.getInstance();
         }
         /**
-         * 导出PDF
+         * Export PDF
          */
         async exportPdf(options, hooks) {
             try {
-                // 1. 获取并克隆DOM元素
+                // 1. Get and clone DOM element
                 const { element, parentElement } = this.prepareDomElement(options.id);
-                // 调用生命周期钩子
+                // Call lifecycle hook
                 hooks?.afterDomClone?.(element);
-                // 2. 处理SVG符号
+                // 2. Process SVG symbols
                 inlineSvgSymbols(element);
-                // 3. 转换为SVG
+                // 3. Convert to SVG
                 const svgDocument = domToSvg.elementToSVG(element);
                 parentElement?.removeChild(element);
                 const svgElement = svgDocument.documentElement;
                 document.body.appendChild(svgElement);
                 this.prepareSvgElement(svgElement);
-                // 4. 处理SVG字体
-                processSvgFonts(svgElement);
-                // 调用生命周期钩子
+                // 4. Process SVG fonts
+                processSvgFonts(svgElement, this.fontManager);
+                // Call lifecycle hook
                 hooks?.beforeSvgConvert?.(svgElement);
-                // 5. 创建PDF文档
+                // 5. Create PDF document
                 const pdf = this.createPdfDocument(svgElement);
                 this.fontManager.setPdfInstance(pdf);
-                // 6. 绘制SVG内容到PDF
+                // 6. Draw SVG content to PDF
                 await this.renderSvgToPdf(svgElement, pdf);
-                // 调用生命周期钩子
+                // Call lifecycle hook
                 hooks?.beforePdfGenerate?.(pdf);
                 hooks?.beforePdfSave?.(pdf);
-                // 7. 保存PDF
+                // 7. Save PDF
                 pdf.save(`${options.filename}.pdf`);
-                // 8. 清理临时元素
+                // 8. Clean up temporary elements
                 svgElement.remove();
                 this.fontManager.setPdfInstance(null);
             }
@@ -195,7 +203,7 @@
             }
         }
         /**
-         * 准备DOM元素
+         * Prepare DOM element
          */
         prepareDomElement(id) {
             const originElement = document.querySelector(id);
@@ -204,7 +212,7 @@
             }
             const parentElement = originElement.parentElement;
             const element = originElement.cloneNode(true);
-            // 设置克隆元素的样式
+            // Set cloned element styles
             element.style.cssText = `
           z-index: -999999;
           position: absolute;
@@ -216,7 +224,7 @@
             return { element, parentElement };
         }
         /**
-         * 准备SVG元素
+         * Prepare SVG element
          */
         prepareSvgElement(svgElement) {
             svgElement.style.cssText = `
@@ -227,12 +235,12 @@
       left: 0;
       z-index: -999999;
     `;
-            // 添加XML声明
+            // Add XML declaration
             const utf8Declaration = document.createTextNode('<?xml version="1.0" encoding="utf-8"?>');
             svgElement.insertBefore(utf8Declaration, svgElement.firstChild);
         }
         /**
-         * 创建PDF文档
+         * Create PDF document
          */
         createPdfDocument(svgElement) {
             const { width, height } = svgElement.getBoundingClientRect();
@@ -243,7 +251,7 @@
             });
         }
         /**
-         * 渲染SVG到PDF
+         * Render SVG to PDF
          */
         async renderSvgToPdf(svgElement, pdf) {
             await svg2pdf_js.svg2pdf(svgElement, pdf, {
@@ -256,24 +264,24 @@
     }
 
     /**
-     * DOM转PDF工具实例
+     * DOM to PDF tool instance
      */
-    class DomToPdf {
+    class DOMToPDF {
         constructor() {
             this.converter = new DomToPdfConverter();
             this.fontManager = FontManager.getInstance();
         }
         /**
-         * 导出PDF
-         * @param options 导出配置
-         * @param hooks 生命周期钩子
+         * Export PDF
+         * @param options Export configuration
+         * @param hooks Lifecycle hooks
          */
-        async export(options, hooks) {
+        async exportPDF(options, hooks) {
             await this.converter.exportPdf(options, hooks);
         }
         /**
-         * 注册字体
-         * @param options 字体注册选项
+         * Register font
+         * @param options Font registration options
          */
         registerFont(options) {
             if (Array.isArray(options)) {
@@ -284,8 +292,8 @@
             }
         }
     }
-    // 导出单例实例
-    const instance = new DomToPdf();
+    // Export singleton instance
+    const instance = new DOMToPDF();
 
     exports["default"] = instance;
     exports.instance = instance;

package/dist/types.d.ts

@@ -1,45 +1,45 @@
 import { jsPDF } from 'jspdf';
 /**
- * 导出PDF配置项
+ * Export PDF配置项
  */
 export interface ExportPdfOptions {
-    /** 要导出的DOM元素ID */
+    /** DOM element ID to export */
     id: string;
-    /** 导出的PDF文件名 */
+    /** Exported PDF file name */
     filename: string;
-    /** PDF方向，默认为 portrait */
+    /** PDF orientation, default is portrait */
     orientation?: 'portrait' | 'landscape';
-    /** 单位，默认为 px */
+    /** Unit, default is px */
     unit?: 'pt' | 'px' | 'in' | 'mm' | 'cm' | 'ex' | 'em' | 'pc';
-    /** 自定义处理SVG元素的钩子 */
+    /** Custom hook for processing SVG elements */
     beforeSvgConvert?: (svgElement: SVGElement) => void;
-    /** 自定义处理PDF文档的钩子 */
+    /** Custom hook for processing PDF document */
     beforePdfSave?: (pdf: jsPDF) => void;
 }
 /**
- * 字体注册选项
+ * Font registration options
  */
 export interface FontRegisterOptions {
-    /** 字体文件路径或URL */
+    /** Font file path or URL */
     font: string;
-    /** 字体ID，用于标识字体 */
+    /** Font ID for identifying the font */
     fontId: string;
     /** 字体样式 (normal/italic) */
     fontStyle?: 'normal' | 'italic';
-    /** 字体粗细 (100-900) */
+    /** Font weight (100-900) */
     fontWeight?: string | number;
 }
 /**
- * 生命周期钩子
+ * Lifecycle hooks
  */
 export interface LifecycleHooks {
-    /** DOM克隆后触发 */
+    /** Triggered after DOM clone */
     afterDomClone?: (clonedElement: HTMLElement) => void;
-    /** SVG转换前触发 */
+    /** Triggered before SVG conversion */
     beforeSvgConvert?: (svgElement: SVGElement) => void;
-    /** PDF生成前触发 */
+    /** Triggered before PDF generation */
     beforePdfGenerate?: (pdf: jsPDF) => void;
-    /** PDF保存前触发 */
+    /** Triggered before PDF save */
     beforePdfSave?: (pdf: jsPDF) => void;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IACvC,gBAAgB;IAChB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7D,oBAAoB;IACpB,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACpD,oBAAoB;IACpB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe;IACf,aAAa,CAAC,EAAE,CAAC,aAAa,EAAE,WAAW,KAAK,IAAI,CAAC;IACrD,eAAe;IACf,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACpD,eAAe;IACf,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IACzC,eAAe;IACf,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IACvC,0BAA0B;IAC1B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7D,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACpD,8CAA8C;IAC9C,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,aAAa,CAAC,EAAE,CAAC,aAAa,EAAE,WAAW,KAAK,IAAI,CAAC;IACrD,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACpD,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IACzC,gCAAgC;IAChC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC"}

package/dist/utils.d.ts

@@ -1,19 +1,20 @@
+import type { FontManager } from './font-manager';
 /**
- * 转换字体字重
- * @param weight 字体粗细
- * @returns 标准化后的字重
+ * Convert font weight
+ * @param weight Font weight
+ * @returns Normalized font weight
  */
-export declare function normalizeFontWeight(weight?: string | number): string;
+export declare function normalizeFontWeight(weight?: string | number | null): string;
 /**
- * 计算SVG symbol的缩放比例
+ * Calculate SVG symbol scale ratio
  */
 export declare function calculateSymbolScale(symbol: SVGElement): number;
 /**
- * 内联SVG中的symbol元素
+ * Symbol element in inline SVG
  */
 export declare function inlineSvgSymbols(element: HTMLElement | SVGElement): void;
 /**
- * 递归处理SVG元素的字体属性
+ * Recursively process SVG element font attributes
  */
-export declare function processSvgFonts(element: Element): void;
+export declare function processSvgFonts(element: Element, fontManager: FontManager): void;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAU/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CAkCxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqCtD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAM3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAU/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CAkCxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAqChF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dom-to-vector-pdf",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "author": {
     "name": "xzboss"
   },
@@ -29,7 +29,9 @@
     "dev": "rollup -c -w",
     "test": "jest",
     "prepublishOnly": "npm run build",
-    "release": "standard-version",
+    "release": "standard-version --release-as patch",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
     "release:alpha": "standard-version --prerelease alpha",
     "release:beta": "standard-version --prerelease beta",
     "release:rc": "standard-version --prerelease rc",