VMPrint

你是否经历过这样的绝望时刻：财务主管急需一份 PDF 报表，而你的 HTML/CSS 方案在分页处崩得一塌糊涂？页眉显示“第 1 页，共 ?? 页”，表格被拦腰截断，无头浏览器在 Lambda 函数里内存溢出……

VMPrint 不是另一个基于浏览器的 PDF 包装器，而是一场排版架构的革命。这是一个纯 JavaScript 实现、零依赖（无 React、无 PDF.js、无服务端）、体积仅 1.7MB 的轻量级库，却能用确定性空间模拟引擎解决传统方案无法处理的复杂排版难题。

核心理念：文档即“物理模拟世界”

VMPrint 彻底抛弃了 DOM、CSS 盒模型和浏览器渲染引擎。它将文档视为一个物理模拟系统：

• 元素即主体 (Agents)：段落、表格、首字下沉不再是静态标签，而是拥有几何规则和行为的“自主主体”。
• 排版即稳定过程：排版不是简单的流式布局，而是让所有主体在约束场（页面边界）中通过碰撞、拆分、重组，最终达到稳定状态的过程。
• 确定性输出：无论运行在 Cloudflare Worker、本地笔记本、AWS Lambda 还是手机上，相同的输入永远产生完全一致的输出。

智能分页：像乐高一样重组

在传统引擎中，跨页表格是噩梦。而在 VMPrint 中：

想象一个“乐高蝙蝠侠”走到页面边缘。它不会被切断，也不会被推迟。它会自动拆解：能放下的部分留在本页，剩余部分在下一页重新组合成完整的蝙蝠侠。身份、逻辑、关联完全保留，只是物理位置发生了适应性的重组。

这就是 VMPrint 处理跨页表格、长列表和复杂嵌套的逻辑——原生支持，无需 hack。

核心优势

极简 API：所见即所得

无需复杂的样式表调试，只需定义数据结构，即可实现预览与导出的完美同步。

import { createVMPrintPreview } from '@vmprint/preview';

// 1. 定义文档数据 (JSON 结构)
const quarterlyReport = {
  pages: [
    {
      header: { text: "Q3 Financial Report", pageNumber: true },
      content: [
        { type: "table", data: financialData, crossPage: true },
        { type: "chart", data: revenueChart },
        // ...更多元素
      ]
    }
  ]
};

// 2. 创建预览实例 (启动模拟引擎)
const preview = await createVMPrintPreview(quarterlyReport);

// 3. 实时预览 (渲染到 Canvas)
await preview.renderPageToCanvas(0, canvasElement); 

// 4. 导出最终产物 (保持同一布局，零差异)
const pdfBlob = await preview.exportPdf();      // 生成 PDF
const svgString = await preview.exportSvgPage(0); // 生成 SVG

适用场景

• 📊 动态报表生成：财务周报、销售仪表盘，需在服务器端快速生成且保证格式严谨。
• ☁️ 边缘计算：在 Cloudflare Workers、Deno Deploy 或 AWS Lambda 等无服务器环境中生成 PDF，无需沉重的 Chrome 实例。
• 📱 移动端应用：在资源受限的手机或平板上直接生成高质量文档，无需联网。
• 📚 长篇文档出版：书籍、手册、技术文档，涉及大量跨页表格、脚注和复杂排版。
• 🔍 可调试工作流：需要精确控制排版细节，或需记录排版过程日志的生产级应用。

技术亮点深度解析

1. 扁平化几何输出：
   最终渲染结果是一个绝对定位的扁平盒子列表，无树形结构，无层叠计算。这使得渲染极快，且天然适配 GPU 加速。
2. 时序状态捕获：
   由于文档是一个运行中的模拟系统，VMPrint 可以捕获任意帧的状态。这意味着每一页不仅是静态图片，更是世界演变的快照，为动态文档和交互式 PDF 打开了新大门。
3. 真正的跨平台一致性：
   不依赖操作系统的字体渲染引擎或浏览器的布局算法，VMPrint 自带排版逻辑，确保“一次编写，处处相同”。