@jcyao/print-sdk 1.1.1 → 1.1.3

package/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 所有版本的变更记录都列在这里，遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/) 规范。
 
+## [1.1.2] - 2026-05-07
+
+### 🐛 问题修复
+
+| 问题 | 修复内容 |
+|------|----------|
+| 打印内容偏左 | `@media print` 中 `.print-page` 的 `margin` 未完全覆盖，导致 `auto` margin 在打印时产生偏移 |
+| 批量打印无边距 | `generateBatchPrintStyles` 未设置 `.print-page` 的 `padding`，导致边距功能失效 |
+
+### ✨ 新增功能
+
+- **多模板批量打印**：新增 `printMultiTemplate` 方法，支持一次打印操作中组合多个不同模板及各自对应的数据列表（一客一模板场景）
+
+### 🔧 修复详情
+
+#### 1. 打印样式 `@media print` 增强
+
+- `body` 样式增加 `!important` 标记，确保打印时完全重置 `margin`、`padding`、`background`
+- `.print-page` 的 `margin-bottom: 0 !important` 改为 `margin: 0 !important`，完全覆盖所有方向的 `auto` margin
+- `.print-page` 的 `box-shadow` 增加 `!important` 标记
+
+**影响范围**：`generatePrintPageStyles`、`generateBatchPrintStyles`
+
+#### 2. 批量打印边距修复
+
+- `generateBatchPrintStyles` 的 `.print-page` 基础样式增加 `padding: ${marginTop}mm ${marginRight}mm ${marginBottom}mm ${marginLeft}mm`
+- 确保批量打印时页面边距功能正常生效
+
+---
+
+## [1.1.1] - 2026-01-22
+
+### ✨ 新增功能
+
+- **表格嵌套对象数据支持**：表格打印支持嵌套对象格式的数据源（如 `{ a: { b: 1 } }`），数据绑定时可通过路径（如 `a.b`）正确解析
+- **服务架构简化**：移除独立 server 服务，改用 Vite mock 集成，降低开发和部署复杂度
+
+---
+
 ## [1.1.0] - 2026-04-15
 
 ### 🎯 重大改进

package/README.md

@@ -5,7 +5,17 @@
 
 通用打印 SDK - 客户端打印解决方案
 
-**当前版本**: v1.1.0
+**当前版本**: v1.1.2
+
+## 🆕 v1.1.2 问题修复
+
+- 🐛 **打印内容偏移修复**：`@media print` 中 `.print-page` 的 `margin` 完全覆盖，解决打印内容偏左问题
+- 🐛 **批量打印边距修复**：`generateBatchPrintStyles` 增加 `padding` 设置，批量打印边距功能正常生效
+
+## 🆕 v1.1.1 新增功能
+
+- ✨ **表格嵌套对象数据支持**：表格打印支持嵌套对象格式的数据源
+- 🔧 **服务架构简化**：移除独立 server 服务，改用 Vite mock 集成
 
 ## 🆕 v1.1.0 重大改进
 
@@ -128,6 +138,50 @@ await sdk.printMultiple(myTemplate, dataList, {
 });
 ```
 
+### `sdk.printMultiTemplate(groups, options)`
+
+多模板批量打印（多模板 + 各自对应的数据列表）。
+
+```typescript
+await sdk.printMultiTemplate([
+  { template: templateA, dataList: [dataA1, dataA2] },
+  { template: templateB, dataList: [dataB1] },
+], {
+  preview: true,
+  onProgress: (progress) => {
+    console.log(
+      `组: ${progress.completedGroups}/${progress.totalGroups}, 数据: ${progress.completedDataItems}/${progress.totalDataItems}`
+    );
+  }
+});
+```
+
+**参数：**
+
+```typescript
+interface PrintTemplateGroup {
+  template: PrintTemplate;
+  dataList: any[];
+}
+
+interface MultiTemplatePrintOptions {
+  preview?: boolean;
+  onProgress?: (progress: MultiTemplatePrintProgress) => void;
+}
+
+interface MultiTemplatePrintProgress {
+  totalGroups: number;          // 模板组总数
+  completedGroups: number;      // 已完成组数
+  totalDataItems: number;       // 总数据条目
+  completedDataItems: number;   // 已完成数据条目
+  failed: number;               // 失败条目数
+  currentGroupIndex: number;    // 当前处理组索引
+  currentDataIndex: number;     // 当前处理数据索引
+}
+```
+
+> ⚠️ **已知限制**：所有模板必须使用相同的纸张尺寸和边距设置。混合纸张尺寸暂不支持。
+
 ## 🎨 支持的组件
 
 - **文本组件** - 显示文本内容，支持标签和数据绑定

package/dist/PrintSDK.d.ts

@@ -28,6 +28,32 @@ export interface BatchPrintProgress {
     failed: number;
     currentIndex: number;
 }
+/**
+ * 模板 + 数据组
+ */
+export interface PrintTemplateGroup {
+    template: PrintTemplate;
+    dataList: any[];
+}
+/**
+ * 多模板打印选项
+ */
+export interface MultiTemplatePrintOptions {
+    preview?: boolean;
+    onProgress?: (progress: MultiTemplatePrintProgress) => void;
+}
+/**
+ * 多模板打印进度
+ */
+export interface MultiTemplatePrintProgress {
+    totalGroups: number;
+    completedGroups: number;
+    totalDataItems: number;
+    completedDataItems: number;
+    failed: number;
+    currentGroupIndex: number;
+    currentDataIndex: number;
+}
 export declare class PrintSDK {
     /**
      * 打印
@@ -64,6 +90,15 @@ export declare class PrintSDK {
      * @param options 批量打印选项
      */
     printMultiple(template: PrintTemplate, dataList: any[], options?: BatchPrintOptions): Promise<void>;
+    /**
+     * 多模板批量打印
+     * 支持多个模板各自绑定数据列表，一次打印确认
+     *
+     * 注意：所有模板需使用相同纸张尺寸，混合尺寸暂不支持
+     * @param groups 模板+数据组列表
+     * @param options 打印选项
+     */
+    printMultiTemplate(groups: PrintTemplateGroup[], options?: MultiTemplatePrintOptions): Promise<void>;
 }
 /**
  * 创建 SDK 实例（无需配置）

package/dist/index.esm.js

@@ -209,8 +209,9 @@ function generatePrintPageStyles(config) {
 
     @media print {
       body {
-        background: white;
-        padding: 0;
+        margin: 0 !important;
+        padding: 0 !important;
+        background: white !important;
       }
 
       @page {
@@ -219,9 +220,9 @@ function generatePrintPageStyles(config) {
       }
 
       .print-page {
+        margin: 0 !important;
+        box-shadow: none !important;
         page-break-after: always;
-        margin-bottom: 0 !important;
-        box-shadow: none;  /* 移除阴影 */
       }
 
       .print-page:last-child {
@@ -248,7 +249,7 @@ function generatePrintPageStyles(config) {
  * 用于 PrintSDK 的 printMultiple
  */
 function generateBatchPrintStyles(config) {
-    const { pageWidthMm, pageHeightMm, isContinuous = false, minHeightMm = 100, } = config;
+    const { pageWidthMm, pageHeightMm, marginTop = 0, marginRight = 0, marginBottom = 0, marginLeft = 0, isContinuous = false, minHeightMm = 100, } = config;
     return `
     * { margin: 0; padding: 0; box-sizing: border-box; }
     body { margin: 0; padding: 0; background: #f5f5f5; }
@@ -259,8 +260,8 @@ function generateBatchPrintStyles(config) {
     }
     
     @media print {
-      body { margin: 0; padding: 0; background: white; }
-      .print-page { margin: 0; page-break-after: always; box-shadow: none !important; }
+      body { margin: 0 !important; padding: 0 !important; background: white !important; }
+      .print-page { margin: 0 !important; page-break-after: always; box-shadow: none !important; }
       .print-page:last-child { page-break-after: auto; }
     }
     
@@ -271,7 +272,7 @@ function generateBatchPrintStyles(config) {
         box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
       }
     }
-    
+
     .print-page {
       width: ${pageWidthMm}mm;
       height: ${isContinuous ? 'auto' : pageHeightMm + 'mm'};
@@ -279,6 +280,7 @@ function generateBatchPrintStyles(config) {
       background: white;
       position: relative;
       box-sizing: border-box;
+      padding: ${marginTop}mm ${marginRight}mm ${marginBottom}mm ${marginLeft}mm;
     }
 
     ${generateComponentStyles()}
@@ -1991,7 +1993,7 @@ class PrintSDK {
      * @param options 批量打印选项
      */
     async printMultiple(template, dataList, options = {}) {
-        var _a, _b;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
         const { preview = false, onProgress, } = options;
         const { page } = template;
         const progress = {
@@ -2034,6 +2036,10 @@ class PrintSDK {
         const styles = generateBatchPrintStyles({
             pageWidthMm,
             pageHeightMm,
+            marginTop: (_b = (_a = page.marginMm) === null || _a === void 0 ? void 0 : _a.top) !== null && _b !== void 0 ? _b : 0,
+            marginRight: (_d = (_c = page.marginMm) === null || _c === void 0 ? void 0 : _c.right) !== null && _d !== void 0 ? _d : 0,
+            marginBottom: (_f = (_e = page.marginMm) === null || _e === void 0 ? void 0 : _e.bottom) !== null && _f !== void 0 ? _f : 0,
+            marginLeft: (_h = (_g = page.marginMm) === null || _g === void 0 ? void 0 : _g.left) !== null && _h !== void 0 ? _h : 0,
             isContinuous: page.size === 'CONTINUOUS',
             minHeightMm: page.minHeightMm,
         });
@@ -2063,7 +2069,7 @@ class PrintSDK {
             iframe.style.top = '-9999px';
             iframe.style.left = '-9999px';
             document.body.appendChild(iframe);
-            const iframeDoc = (_a = iframe.contentWindow) === null || _a === void 0 ? void 0 : _a.document;
+            const iframeDoc = (_j = iframe.contentWindow) === null || _j === void 0 ? void 0 : _j.document;
             if (!iframeDoc) {
                 throw new Error('Failed to access iframe document');
             }
@@ -2071,13 +2077,129 @@ class PrintSDK {
             iframeDoc.close();
             // 等待所有图片加载完成后再打印
             await waitForImagesLoaded(iframeDoc);
-            (_b = iframe.contentWindow) === null || _b === void 0 ? void 0 : _b.print();
+            (_k = iframe.contentWindow) === null || _k === void 0 ? void 0 : _k.print();
             // 打印完成后移除 iframe
             setTimeout(() => {
                 document.body.removeChild(iframe);
             }, 1000);
         }
     }
+    /**
+     * 多模板批量打印
+     * 支持多个模板各自绑定数据列表，一次打印确认
+     *
+     * 注意：所有模板需使用相同纸张尺寸，混合尺寸暂不支持
+     * @param groups 模板+数据组列表
+     * @param options 打印选项
+     */
+    async printMultiTemplate(groups, options = {}) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        const { preview = false, onProgress } = options;
+        if (!groups || groups.length === 0) {
+            console.warn('[PrintSDK] printMultiTemplate: groups 为空，跳过打印');
+            return;
+        }
+        const totalDataItems = groups.reduce((sum, g) => sum + g.dataList.length, 0);
+        const progress = {
+            totalGroups: groups.length,
+            completedGroups: 0,
+            totalDataItems,
+            completedDataItems: 0,
+            failed: 0,
+            currentGroupIndex: 0,
+            currentDataIndex: -1,
+        };
+        onProgress === null || onProgress === void 0 ? void 0 : onProgress(progress);
+        const allPagesHTML = [];
+        for (let groupIdx = 0; groupIdx < groups.length; groupIdx++) {
+            const group = groups[groupIdx];
+            progress.currentGroupIndex = groupIdx;
+            progress.currentDataIndex = -1;
+            onProgress === null || onProgress === void 0 ? void 0 : onProgress(progress);
+            for (let dataIdx = 0; dataIdx < group.dataList.length; dataIdx++) {
+                const data = group.dataList[dataIdx];
+                progress.currentDataIndex = dataIdx;
+                onProgress === null || onProgress === void 0 ? void 0 : onProgress(progress);
+                try {
+                    const engine = createPrintEngine(group.template, data);
+                    const html = await engine.generatePrintHTML();
+                    const bodyContent = extractBodyContent(html);
+                    if (bodyContent) {
+                        allPagesHTML.push(bodyContent);
+                    }
+                    progress.completedDataItems++;
+                    onProgress === null || onProgress === void 0 ? void 0 : onProgress(progress);
+                }
+                catch (error) {
+                    progress.failed++;
+                    progress.completedDataItems++;
+                    onProgress === null || onProgress === void 0 ? void 0 : onProgress(progress);
+                    console.error(`[PrintSDK] 处理失败: groupIndex=${groupIdx}, dataIndex=${dataIdx}`, error);
+                }
+            }
+            progress.completedGroups++;
+            onProgress === null || onProgress === void 0 ? void 0 : onProgress(progress);
+        }
+        progress.currentGroupIndex = -1;
+        progress.currentDataIndex = -1;
+        onProgress === null || onProgress === void 0 ? void 0 : onProgress(progress);
+        const { page } = groups[0].template;
+        const { widthMm: pageWidthMm, heightMm: pageHeightMm } = getPageSizeFromConfig(page);
+        const styles = generateBatchPrintStyles({
+            pageWidthMm,
+            pageHeightMm,
+            marginTop: (_b = (_a = page.marginMm) === null || _a === void 0 ? void 0 : _a.top) !== null && _b !== void 0 ? _b : 0,
+            marginRight: (_d = (_c = page.marginMm) === null || _c === void 0 ? void 0 : _c.right) !== null && _d !== void 0 ? _d : 0,
+            marginBottom: (_f = (_e = page.marginMm) === null || _e === void 0 ? void 0 : _e.bottom) !== null && _f !== void 0 ? _f : 0,
+            marginLeft: (_h = (_g = page.marginMm) === null || _g === void 0 ? void 0 : _g.left) !== null && _h !== void 0 ? _h : 0,
+            isContinuous: page.size === 'CONTINUOUS',
+            minHeightMm: page.minHeightMm,
+        });
+        const fullHTML = generatePrintHTML({
+            title: '多模板批量打印',
+            styles,
+            bodyContent: allPagesHTML.join('\n'),
+        });
+        if (preview) {
+            const printWindow = window.open('', '_blank');
+            if (!printWindow) {
+                throw new Error('Failed to open print window');
+            }
+            printWindow.document.write(fullHTML);
+            printWindow.document.close();
+            await waitForImagesLoaded(printWindow.document);
+            printWindow.print();
+        }
+        else {
+            const iframe = document.createElement('iframe');
+            iframe.style.position = 'fixed';
+            iframe.style.top = '-9999px';
+            iframe.style.left = '-9999px';
+            document.body.appendChild(iframe);
+            const iframeDoc = (_j = iframe.contentWindow) === null || _j === void 0 ? void 0 : _j.document;
+            if (!iframeDoc) {
+                throw new Error('Failed to access iframe document');
+            }
+            iframeDoc.write(fullHTML);
+            iframeDoc.close();
+            await waitForImagesLoaded(iframeDoc);
+            const cleanup = () => {
+                if (iframe.parentNode) {
+                    document.body.removeChild(iframe);
+                }
+            };
+            if (iframe.contentWindow) {
+                iframe.contentWindow.addEventListener('afterprint', cleanup, { once: true });
+            }
+            (_k = iframe.contentWindow) === null || _k === void 0 ? void 0 : _k.print();
+            setTimeout(() => {
+                if (iframe.parentNode) {
+                    console.warn('[PrintSDK] afterprint 事件未触发，执行兜底清理');
+                    cleanup();
+                }
+            }, 5000);
+        }
+    }
 }
 /**
  * 创建 SDK 实例（无需配置）