@worm-vue3-print/core 1.2.2 → 1.3.1

package/README.md

@@ -22,7 +22,20 @@ print-core/
 ```
 
 `core` 无 Vue、无宿主依赖，可在 Node 服务端（`@worm-vue3-print/render`）与浏览器端（`@worm-vue3-print/canvas`）共用，
-保证「浏览器预览」与「服务端 PDF」结果一致。
+保证「浏览器预览」「服务端 PDF」「桌面客户端出图」共用同一套算法（逻辑同源；像素级一致还需三端字体与 Chromium 内核同源）。
+
+### 打印管线（`print/`，纯 TS）
+
+- 入口：`prepareDocument(job, runtime)`、`renderPdf(job, runtime)`、`renderScreenshot(job, runtime)`；
+- 规格：`buildPdfTargetSpec`、`toElectronPrintToPdfOptions`（英寸）、`toPlaywrightPdfOptions`（mm）、`buildScreenshotTargetSpec`；
+- 纸张：`resolvePaperMm`（宿主覆盖逃生门）、`paperViewportPx`（测量容器 mm→px）、`escapeHeightMm`（连续纸纸高逃生门）；
+- 契约：`PageDriver`（宿主只实现 open/setContent/injectExecutor/evaluate 与可选 pdf/screenshot）+
+  `createDomHostRuntime(driverFactory, bundle)`（共享的载入→注入→就绪→执行→释放时序、超时预算与错误归一化）；
+- 拼版：`computeTileLayout` / `validateTiling` / `computeMaxColumns` / `tilePosition` / `resolveSheetMm` /
+  `composeTiledHtml`（标签多行多列铺到目标纸，如 70×40 标签铺满 A4）。配置为模板级 `TemplateData.tiling`，
+  目标纸可由用户自定义；页尺寸经 `PreparedDocument.paperMm` 透出，**服务端与客户端零协议改动**；
+- DOM 能力：`@worm-vue3-print/core/browser` 导出执行器与 iframe driver；`@worm-vue3-print/core/node` 的
+  `loadExecutorBundle()` 供 Node 宿主读取 `dist/dom-executor.iife.global.js` 注入页面。
 
 ### 子路径导出
 
@@ -63,12 +76,14 @@ import '@worm-vue3-print/canvas/native-controls.css'
     :initial-template="templateData"
     :fields="fields"
     :is-edit="true"
-    :load-default-template="loadDefaultTemplate"
     :show-help="true"
     @preview="onPreview"
     @save="onSave"
   />
 
+  <!-- 「加载默认布局」等业务入口由宿主自渲染，不在设计器工具栏内 -->
+  <button type="button" @click="onLoadDefaultLayout">加载默认布局</button>
+
   <!-- 浏览器端免保存预览：直接使用当前画布 JSON + 业务数据 -->
   <Teleport to="body">
     <PrintHtmlPreview
@@ -99,8 +114,10 @@ function onSave(json: string) {
   // 宿主持久化模板 JSON
 }
 
-function loadDefaultTemplate() {
-  return createDefaultTemplate()
+/** 加载默认布局：宿主自实现；示例造空白默认模板，真实宿主可拉取服务端默认模板 */
+function onLoadDefaultLayout() {
+  if (!confirm('将覆盖当前画布内容，是否继续？')) return
+  templateData.value = createDefaultTemplate()
 }
 </script>
 ```
@@ -108,10 +125,10 @@ function loadDefaultTemplate() {
 关键 props / 事件 / 方法：
 
 - `initial-template`：初始模板 `TemplateData`；`fields`：业务字段 `PrintBusinessField[]`；`is-edit`：是否编辑态。
-- `load-default-template()`：可选。「加载默认布局」回调（支持异步，返回 null/undefined 视为无
-  默认布局）；未注入时工具栏不展示该按钮。
 - `show-help`：帮助入口开关，默认开启，传入 `false` 可关闭帮助按钮与帮助弹框。
 - `getTemplateJson()`：通过 `ref` 获取当前画布模板 JSON，用于预览 / 保存。
+- 模板加载 / 重置（如「加载默认布局」）属于宿主业务：把新的 `TemplateData` 赋给
+  `initial-template` 即可重载画布并记录一次历史（撤销可回退），设计器工具栏不内置该入口。
 - `@preview` / `@save`：预览与保存事件，具体业务（字段查询、持久化）由宿主实现。
 - 需要服务端 / Node 输出时，直接调用 `core` 的 `bindData` / `paginate` / `generateHtml` 即可。
 
@@ -131,4 +148,4 @@ function loadDefaultTemplate() {
 ```bash
 npm run build   # tsup → dist/index.js + index.cjs + d.ts
 npm test        # vitest
-```
+```