@jcyao/print-sdk 1.0.0 → 1.1.0

package/dist/printEngine/constants.d.ts

@@ -44,8 +44,8 @@ export declare const TABLE_DEFAULT: {
     readonly HEADER_HEIGHT: 10;
     /** 数据行最小高度（mm） */
     readonly MIN_ROW_HEIGHT: 8;
-    /** 行高计算系数（考虑文本换行） */
-    readonly ROW_HEIGHT_FACTOR: 1.3;
+    /** 行高计算系数（用于 min-height，实际高度由内容撑开） */
+    readonly ROW_HEIGHT_FACTOR: 1;
 };
 /**
  * 样式默认值

package/dist/printEngine/renderers/PageNumberRenderer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 页码组件渲染器
+ * 支持三种格式：
+ * - simple: 1, 2, 3
+ * - text: 第1页 共3页
+ * - slash: 1/3
+ */
+import type { ComponentNode } from '../../types';
+import type { ComponentRenderer, RenderContext } from '../types';
+export declare class PageNumberRenderer implements ComponentRenderer {
+    readonly type = "pageNumber";
+    render(component: ComponentNode, context: RenderContext): string;
+    calculateHeight(component: ComponentNode): number;
+    /**
+     * 格式化页码文本
+     */
+    private formatPageNumber;
+    /**
+     * HTML 转义
+     */
+    private escapeHtml;
+}

package/dist/printEngine/renderers/index.d.ts

@@ -8,3 +8,4 @@ export { RectRenderer } from './RectRenderer';
 export { LineRenderer } from './LineRenderer';
 export { QRCodeRenderer } from './QRCodeRenderer';
 export { BarcodeRenderer } from './BarcodeRenderer';
+export { PageNumberRenderer } from './PageNumberRenderer';

package/dist/printEngine.d.ts

@@ -77,8 +77,19 @@ export declare class PrintEngine {
      * 计算表格行高度（mm）
      */
     private calculateTableRowHeight;
+    /**
+     * 渲染页码（根据页面配置）
+     */
+    private renderPageNumber;
+    /**
+     * HTML 转义
+     */
+    private escapeHtml;
     /**
      * 渲染单个页面（直接渲染，不做智能布局）
+     * @param components 组件列表
+     * @param pageNumber 当前页码（可选）
+     * @param totalPages 总页数（可选）
      */
     private renderSinglePage;
     /**
@@ -89,15 +100,20 @@ export declare class PrintEngine {
      * 3. 换页时从 marginTop 开始，忽略原 gap
      */
     private calculatePages;
+    /**
+     * 测量表格实际行高（渲染后测量方案）
+     * 将表格渲染到隐藏容器，测量表头、数据行和合计行的实际高度
+     */
+    private measureTableRowHeights;
     /**
      * 表格跨页拆分（基于相对间距）
-     * 支持 repeatHeader 配置、精确行高计算、空表格检查
+     * 支持 repeatHeader 配置、渲染后测量、空表格检查
      */
     private splitTableWithGap;
     /**
      * 生成打印 HTML
      */
-    generatePrintHTML(): string;
+    generatePrintHTML(): Promise<string>;
 }
 /**
  * 工厂函数：创建打印引擎实例
@@ -106,7 +122,7 @@ export declare function createPrintEngine(template: PrintTemplate, data: any): {
     /**
      * 生成完整打印 HTML
      */
-    generatePrintHTML(): string;
+    generatePrintHTML(): Promise<string>;
     /**
      * 注册自定义渲染器
      */

package/dist/sdk.d.ts

@@ -1,6 +1,6 @@
 /**
  * 打印 SDK 统一导出
- * 这个文件将来可以直接独立为 @printer/sdk 包
+ * 这个文件将来可以直接独立为 @jcyao/print-sdk 包
  */
 export { PrintSDK, createPrintSDK } from './PrintSDK';
 export type { PrintOptions, BatchPrintOptions, BatchPrintProgress, } from './PrintSDK';
@@ -9,4 +9,4 @@ export type { ComponentRenderer, RenderContext } from './printEngine';
 export { MM_TO_PX, COMPONENT_DEFAULT_SIZE, TABLE_DEFAULT, STYLE_DEFAULT, TABLE_STYLE_DEFAULT, BARCODE_CONFIG, QRCODE_CONFIG } from './printEngine/constants';
 export { generatePrintPageStyles, generateBatchPrintStyles, generatePrintHTML, getPageSizeFromConfig, } from './printEngine/htmlTemplate';
 export { TextRenderer, TableRenderer, ImageRenderer, RectRenderer, LineRenderer, QRCodeRenderer, BarcodeRenderer, } from './printEngine/renderers';
-export type { PrintTemplate, ComponentNode, DataBinding, PipeConfig, PageConfig, ComponentType, SchemaField, SchemaDictionary, MockData, } from './types';
+export type { PrintTemplate, ComponentNode, DataBinding, PipeConfig, PageConfig, PageNumberConfig, ComponentType, SchemaField, SchemaDictionary, MockData, TableProps, TableColumn, } from './types';

package/dist/types.d.ts

@@ -19,6 +19,21 @@ export interface SchemaDictionary {
     version?: string;
     description?: string;
 }
+export interface PageNumberConfig {
+    enabled: boolean;
+    position: 'bottom-center' | 'bottom-right' | 'bottom-left' | 'top-center' | 'top-right' | 'top-left';
+    format?: 'simple' | 'text' | 'slash';
+    prefix?: string;
+    suffix?: string;
+    separator?: string;
+    offsetX?: number;
+    offsetY?: number;
+    style?: {
+        fontSize?: number;
+        color?: string;
+        fontWeight?: 'normal' | 'bold';
+    };
+}
 export interface PageConfig {
     size: 'A4' | 'A5' | 'CUSTOM' | 'CONTINUOUS';
     widthMm?: number;
@@ -31,6 +46,7 @@ export interface PageConfig {
         bottom: number;
         left: number;
     };
+    pageNumber?: PageNumberConfig;
 }
 export type ComponentType = 'text' | 'image' | 'rect' | 'container' | 'table' | 'line' | 'qrcode' | 'barcode';
 export interface PipeConfig {
@@ -64,6 +80,15 @@ export interface TableSummaryStyle {
     fontWeight?: string;
     fontSize?: number;
 }
+export interface PageNumberProps {
+    format?: 'simple' | 'text' | 'slash';
+    align?: 'left' | 'center' | 'right';
+    prefix?: string;
+    suffix?: string;
+    separator?: string;
+    _currentPage?: number;
+    _totalPages?: number;
+}
 export interface TableProps {
     columns: TableColumn[];
     showHeader?: boolean;

package/dist/utils/resourceLoader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 资源加载工具
+ * 用于等待图片、二维码、条形码等异步资源加载完成
+ */
+/**
+ * 等待文档中所有图片加载完成
+ * @param doc 文档对象（可以是 window.document 或 iframe.contentDocument）
+ * @param timeout 超时时间（毫秒），默认 10000ms
+ * @returns Promise<void>
+ */
+export declare function waitForImagesLoaded(doc: Document, timeout?: number): Promise<void>;
+/**
+ * 等待所有打印资源加载完成
+ * 包括：图片、二维码（已转base64）、条形码（已转base64）
+ * 注意：二维码和条形码在渲染时已同步生成为 base64，所以主要等待外部图片
+ * @param doc 文档对象
+ * @param timeout 超时时间（毫秒），默认 10000ms
+ */
+export declare function waitForPrintResourcesReady(doc: Document, timeout?: number): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jcyao/print-sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Universal Print SDK - Client-side print solution",
   "type": "module",
   "main": "dist/index.js",
@@ -54,6 +54,7 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ]
 }