@jcyao/print-sdk 1.1.2 → 1.1.3

package/CHANGELOG.md

@@ -11,6 +11,10 @@
 | 打印内容偏左 | `@media print` 中 `.print-page` 的 `margin` 未完全覆盖，导致 `auto` margin 在打印时产生偏移 |
 | 批量打印无边距 | `generateBatchPrintStyles` 未设置 `.print-page` 的 `padding`，导致边距功能失效 |
 
+### ✨ 新增功能
+
+- **多模板批量打印**：新增 `printMultiTemplate` 方法，支持一次打印操作中组合多个不同模板及各自对应的数据列表（一客一模板场景）
+
 ### 🔧 修复详情
 
 #### 1. 打印样式 `@media print` 增强

package/README.md

@@ -138,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

@@ -1993,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 = {
@@ -2036,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,
         });
@@ -2065,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');
             }
@@ -2073,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 实例（无需配置）