@jcyao/print-sdk 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 所有版本的变更记录都列在这里，遵循 [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`，导致边距功能失效 |
+
+### 🔧 修复详情
+
+#### 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 重大改进
 

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()}
@@ -584,6 +586,25 @@ class TextRenderer {
 /**
  * 表格组件渲染器
  */
+/**
+ * 根据数据路径从对象中取值
+ * 支持嵌套路径，如：'product.name' => obj.product.name
+ * @param obj 数据对象
+ * @param path 属性路径，支持点号分隔的嵌套路径
+ * @returns 属性值，路径不存在时返回 undefined
+ */
+function getByPath(obj, path) {
+    if (!obj || !path)
+        return undefined;
+    const keys = path.split('.');
+    let value = obj;
+    for (const key of keys) {
+        if (value === null || value === undefined)
+            return undefined;
+        value = value[key];
+    }
+    return value;
+}
 class TableRenderer {
     constructor() {
         this.type = 'table';
@@ -688,7 +709,8 @@ class TableRenderer {
                 .map((row) => {
                 const cells = visibleColumns
                     .map((col) => {
-                    const value = row[col.dataIndex] || '';
+                    var _a;
+                    const value = (_a = getByPath(row, col.dataIndex)) !== null && _a !== void 0 ? _a : '';
                     // 使用百分比宽度，min-height 允许内容换行时自然扩展
                     return `<td style="${cellBorder} ${cellPadding} ${cellTextStyle} text-align: ${textAlign}; width: ${colWidthPercent}%; min-height: ${rowHeightPx}px; box-sizing: border-box;">${value}</td>`;
                 })
@@ -769,7 +791,7 @@ class TableRenderer {
             return '';
         const values = data
             .map(row => {
-            const val = row[column.dataIndex];
+            const val = getByPath(row, column.dataIndex);
             // 尝试转换为数字，失败则返回 null
             const num = Number(val);
             return isNaN(num) ? null : num;