@worm-vue3-print/core 1.3.3 → 1.3.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Worm Base AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -26,10 +26,10 @@ print-core/
 
 ### 打印管线（`print/`，纯 TS）
 
-- 入口：`prepareDocument(job, runtime)`、`renderPdf(job, runtime)`、`renderScreenshot(job, runtime)`；
-- 规格：`buildPdfTargetSpec`、`toElectronPrintToPdfOptions`（英寸）、`toPlaywrightPdfOptions`（mm）、`buildScreenshotTargetSpec`；
+- 入口：`prepareDocument(job, runtime)`、`renderPdf(job, runtime)`；
+- 规格：`buildPdfTargetSpec`、`toElectronPrintToPdfOptions`（英寸）、`toPlaywrightPdfOptions`（mm）；
 - 纸张：`resolvePaperMm`（宿主覆盖逃生门）、`paperViewportPx`（测量容器 mm→px）、`escapeHeightMm`（连续纸纸高逃生门）；
-- 契约：`PageDriver`（宿主只实现 open/setContent/injectExecutor/evaluate 与可选 pdf/screenshot）+
+- 契约：`PageDriver`（宿主只实现 open/setContent/injectExecutor/evaluate 与可选 pdf）+
   `createDomHostRuntime(driverFactory, bundle)`（共享的载入→注入→就绪→执行→释放时序、超时预算与错误归一化）；
 - 拼版：`computeTileLayout` / `validateTiling` / `computeMaxColumns` / `tilePosition` / `resolveSheetMm` /
   `composeTiledHtml`（标签多行多列铺到目标纸，如 70×40 标签铺满 A4）。配置为模板级 `TemplateData.tiling`，
@@ -65,8 +65,8 @@ const html = generateHtml(pages)
 ```ts
 import { PrintDesigner, PrintHtmlPreview, createDefaultTemplate } from '@worm-vue3-print/canvas'
 import type { PrintBusinessField, TemplateData } from '@worm-vue3-print/canvas'
-// 设计器内部控件基于原生样式，需全局引入一次
-import '@worm-vue3-print/canvas/native-controls.css'
+// 设计器控件样式（发布包唯一对外样式入口），需全局引入一次
+import '@worm-vue3-print/canvas/style.css'
 ```
 
 ```vue

package/dist/browser/index.cjs

@@ -1,3 +1,9 @@
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -173,23 +179,6 @@ function createDomHostRuntime(factory, bundle) {
             "RENDER_TIMEOUT",
             `PDF \u751F\u6210\u8D85\u8FC7 ${ms}ms`
           );
-        },
-        async toScreenshot(html, spec, viewport) {
-          if (!driver.screenshot) throw new PrintFailure("UNSUPPORTED_RUNTIME", "\u5F53\u524D\u5BBF\u4E3B\u4E0D\u652F\u6301\u622A\u56FE");
-          const ms = budget();
-          return withTimeout(
-            (async () => {
-              try {
-                await load(html, viewport);
-                return await driver.screenshot(html, spec);
-              } catch (err) {
-                throw fail(err, "SCREENSHOT_FAILED", "\u622A\u56FE\u5931\u8D25");
-              }
-            })(),
-            ms,
-            "RENDER_TIMEOUT",
-            `\u622A\u56FE\u8D85\u8FC7 ${ms}ms`
-          );
         }
       };
       try {
@@ -1517,9 +1506,6 @@ function bindData(template, printData, baseUrl, fontBaseUrl) {
   if (bound.footer?.elements) {
     bound.footer.elements = bound.footer.elements.map((el) => bindElement(el, data, baseUrl));
   }
-  if (bound.firstPageOverlay?.elements) {
-    bound.firstPageOverlay.elements = bound.firstPageOverlay.elements.map((el) => bindElement(el, data, baseUrl));
-  }
   bound.elements = bound.elements.map((el) => bindElement(el, data, baseUrl));
   const fontBase = fontBaseUrl ?? baseUrl;
   if (fontBase && bound.fonts?.length) {
@@ -1960,7 +1946,6 @@ function areaGeometryBlock(template, paper, desc) {
   const { bottom: mb } = template.margins;
   const headerH = template.header?.height ?? 0;
   const footerH = template.footer?.height ?? 0;
-  const overlayH = template.firstPageOverlay?.height ?? 0;
   const contentWidth = paper.width - ml - mr;
   return `
 /* \u2500\u2500 \u9875\u7709 \u2500\u2500 */
@@ -1972,13 +1957,14 @@ ${desc}.page-header {
 
 /* \u2500\u2500 \u9875\u811A\uFF1A\u7EDD\u5BF9\u5B9A\u4F4D\u56FA\u5B9A\u5728\u9875\u9762\u5E95\u90E8\uFF08\u5185\u5BB9\u4E0D\u8DB3\u65F6\u4E0D\u968F\u6587\u6863\u6D41\u4E0A\u6D6E\uFF09 \u2500\u2500
    \u7528\u663E\u5F0F top \u5B9A\u4F4D\u5230\u300C\u7EB8\u9AD8 - \u4E0B\u8FB9\u8DDD - \u9875\u811A\u9AD8\u300D\uFF0C\u4FDD\u8BC1\u4E0B\u8FB9\u8DDD\u751F\u6548\u3001
-   \u4E0E\u8BBE\u8BA1\u5668 CanvasPaper \u7684\u4E09\u533A\u51E0\u4F55\u4E00\u81F4\u3002 */
+   \u4E0E\u8BBE\u8BA1\u5668 CanvasPaper \u7684\u4E09\u533A\u51E0\u4F55\u4E00\u81F4\u3002
+   \u7EDD\u5BF9\u5B9A\u4F4D\u7684\u5305\u542B\u5757\u662F padding box \u5916\u7F18\uFF08= \u7EB8\u9762\uFF09\uFF0Cleft \u987B\u663E\u5F0F\u8865\u5DE6\u8FB9\u8DDD\u3002 */
 ${desc}.page-footer {
   width: ${mm(contentWidth)};
   height: ${mm(footerH)};
   position: absolute;
   top: ${mm(paper.height - mb - footerH)};
-  left: 0;
+  left: ${mm(ml)};
 }
 
 /* \u2500\u2500 \u5185\u5BB9\u533A \u2500\u2500 */
@@ -1987,13 +1973,6 @@ ${desc}.content-area {
   position: relative;
   overflow: visible;
 }
-
-/* \u2500\u2500 \u9996\u9875\u53E0\u52A0\u533A\u57DF \u2500\u2500 */
-${desc}.first-page-overlay {
-  width: ${mm(contentWidth)};
-  height: ${mm(overlayH)};
-  position: relative;
-}
 `;
 }
 function buildBasePageCss() {
@@ -2115,7 +2094,7 @@ var VALID_STYLES = /* @__PURE__ */ new Set(["solid", "dashed", "dotted", "double
 function parseBorder(width, style, color) {
   if (typeof width !== "number" || !Number.isFinite(width) || width <= 0) return null;
   return {
-    borderWidth: `${width}px`,
+    borderWidth: `${width}pt`,
     borderStyle: typeof style === "string" && VALID_STYLES.has(style) ? style : "solid",
     borderColor: color || "#000"
   };
@@ -2396,7 +2375,6 @@ function paginate(template, measuredElements) {
   const { top: mt, bottom: mb } = template.margins;
   const headerH = template.header?.height ?? 0;
   const footerH = template.footer?.height ?? 0;
-  const overlayH = template.firstPageOverlay?.height ?? 0;
   const continuous = isContinuousPaper(template);
   const contentHeight = continuous ? Number.POSITIVE_INFINITY : paper.height - mt - mb - headerH - footerH;
   if (!continuous && contentHeight <= 0) {
@@ -2436,8 +2414,7 @@ function paginate(template, measuredElements) {
   const unitOf = buildPaginationUnits(sorted, measuredElements, groupMap);
   const pages = [];
   let currentPage = [];
-  let remaining = contentHeight - overlayH - SAFETY_MARGIN;
-  let isFirstPage = true;
+  let remaining = contentHeight - SAFETY_MARGIN;
   let pageBroken = false;
   function sectionTop(el) {
     return pageBroken ? pageCursorTop() : el.options?.top ?? 0;
@@ -2446,7 +2423,7 @@ function paginate(template, measuredElements) {
     return Math.max(0, fullPageHeight() - remaining);
   }
   function fullPageHeight() {
-    return isFirstPage ? contentHeight - overlayH - SAFETY_MARGIN : contentHeight - SAFETY_MARGIN;
+    return contentHeight - SAFETY_MARGIN;
   }
   let overflowOnCurrent = false;
   function pushPage() {
@@ -2465,7 +2442,6 @@ function paginate(template, measuredElements) {
     pushPage();
     currentPage = [];
     remaining = contentHeight - SAFETY_MARGIN;
-    isFirstPage = false;
     pageBroken = true;
     overflowOnCurrent = false;
   }
@@ -2768,7 +2744,6 @@ function generateMeasurementHtml(template, css, ctx, printData) {
     // totalPages placeholder
     ctx
   );
-  const overlayHtml = renderAreaElements(template.firstPageOverlay?.elements ?? [], contentWidth, void 0, void 0, ctx);
   let html = `<!DOCTYPE html>
 <html lang="zh-CN">
 <head>
@@ -2779,7 +2754,6 @@ function generateMeasurementHtml(template, css, ctx, printData) {
 <section class="print-page" data-measure-page="0">
   ${renderWatermarkLayerHtml(template.watermark, printData, getPaperDims(template))}
   <div class="page-header">${headerHtml}</div>
-  <div class="first-page-overlay">${overlayHtml}</div>
   <div class="content-area" style="height:auto;overflow:visible;">
     ${elementsHtml}
   </div>
@@ -2843,14 +2817,12 @@ function renderPage(template, page, pageNum, totalPages, ctx, printData, pageCla
     totalPages,
     pageCtx
   );
-  const overlayHtml = page.pageIndex === 0 ? `<div class="first-page-overlay">${renderAreaElements(scoped.firstPageOverlay?.elements ?? [], contentWidth, pageNum, totalPages, pageCtx)}</div>` : "";
   let contentHtml = page.sections.map((section) => renderSection(section, scoped, pageCtx)).join("\n");
   contentHtml = contentHtml.replace(/\{pageIndex\}/g, String(pageNum));
   contentHtml = contentHtml.replace(/\{totalPages\}/g, String(totalPages));
   const pageInner = `
   ${renderWatermarkLayerHtml(template.watermark, printData, paperMm, { pageIndex: pageNum, totalPages })}
   <div class="page-header">${headerHtml}</div>
-  ${overlayHtml}
   <div class="content-area">
     ${contentHtml}
   </div>
@@ -2874,16 +2846,14 @@ function withPageNumbers(template, vars) {
     ...template,
     elements: template.elements.map(mapEl),
     header: mapArea(template.header),
-    footer: mapArea(template.footer),
-    firstPageOverlay: mapArea(template.firstPageOverlay)
+    footer: mapArea(template.footer)
   };
 }
 function templateReferencesPageNumbers(template) {
   const areas = [
     template.elements,
     template.header?.elements,
-    template.footer?.elements,
-    template.firstPageOverlay?.elements
+    template.footer?.elements
   ];
   return areas.some((list) => (list ?? []).some((el) => typeof el.options?.rawFormatter === "string"));
 }
@@ -2983,13 +2953,13 @@ function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
 </div>`;
     }
     case "hline":
-      return `<div class="print-element" style="${style};border-top:1px solid #000;height:0;"${measureAttr}></div>`;
+      return `<div class="print-element" style="${style};border-top:${opts.borderWidth || 0.75}pt ${opts.borderStyle || "solid"} ${opts.borderColor || "#333"};height:0;"${measureAttr}></div>`;
     case "vline":
-      return `<div class="print-element" style="${style};border-left:1px solid #000;width:0;"${measureAttr}></div>`;
+      return `<div class="print-element" style="${style};border-left:${opts.borderWidth || 0.75}pt ${opts.borderStyle || "solid"} ${opts.borderColor || "#333"};width:0;"${measureAttr}></div>`;
     case "rect":
-      return `<div class="print-element" style="${style};border:${opts.borderWidth ?? 1}px solid ${opts.borderColor ?? "#000"};"${measureAttr}></div>`;
+      return `<div class="print-element" style="${style};border:${opts.borderWidth || 1}pt ${opts.borderStyle || "solid"} ${opts.borderColor || "#333"};"${measureAttr}></div>`;
     case "oval":
-      return `<div class="print-element" style="${style};border:${opts.borderWidth ?? 1}px solid ${opts.borderColor ?? "#000"};border-radius:50%;"${measureAttr}></div>`;
+      return `<div class="print-element" style="${style};border:${opts.borderWidth || 1}pt ${opts.borderStyle || "solid"} ${opts.borderColor || "#333"};border-radius:50%;"${measureAttr}></div>`;
     case "longText":
       return `<div class="print-element" style="${style}${textStyle(opts)}${elementFitStyle(fit, opts)}"${measureAttr}${fitAttr}>${esc(opts.formatter ?? opts.testData ?? "")}</div>`;
     case "html":
@@ -3375,7 +3345,6 @@ function applyTextFitSizes(template, fits) {
   collect(template.elements);
   collect(template.header?.elements);
   collect(template.footer?.elements);
-  collect(template.firstPageOverlay?.elements);
   for (const fit of fits) {
     const parsed = parseCellFitKey(fit.key);
     if (!parsed) {

package/dist/browser/index.d.cts

@@ -1,5 +1,11 @@
-import { P as PageLayout, T as TemplateData, M as MultiPageTemplateData, C as CodeRenderer, D as DriverFactory, R as RawMeasurement, a as CodeSpec } from '../driver-CNJVZK_L.cjs';
-import { P as PrintRuntime, F as FitFontSize } from '../ports-DeEgE2SL.cjs';
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
+import { P as PageLayout, T as TemplateData, M as MultiPageTemplateData, C as CodeRenderer, D as DriverFactory, R as RawMeasurement, a as CodeSpec } from '../driver-CFm0C_yX.cjs';
+import { P as PrintRuntime, F as FitFontSize } from '../ports-BXYcHExa.cjs';
 
 interface BrowserRenderResult {
     /** 最终多页 HTML 字符串 */
@@ -46,7 +52,7 @@ declare function renderHtmlPages(template: TemplateData | MultiPageTemplateData,
 /** 浏览器条码/二维码渲染器；码值非法或为空时抛错，由渲染管线降级文本占位 */
 declare const browserCodeRenderer: CodeRenderer;
 
-/** 浏览器端 runtime：iframe driver + 进程内执行器；不提供 PDF/截图 */
+/** 浏览器端 runtime：iframe driver + 进程内执行器；不提供 PDF */
 declare function createBrowserPrintRuntime(): PrintRuntime;
 
 /** 浏览器 iframe driver：进程内直调执行器，无需注入脚本；不提供出图能力 */

package/dist/browser/index.d.ts

@@ -1,5 +1,11 @@
-import { P as PageLayout, T as TemplateData, M as MultiPageTemplateData, C as CodeRenderer, D as DriverFactory, R as RawMeasurement, a as CodeSpec } from '../driver-CNJVZK_L.js';
-import { P as PrintRuntime, F as FitFontSize } from '../ports-DSfECjvT.js';
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
+import { P as PageLayout, T as TemplateData, M as MultiPageTemplateData, C as CodeRenderer, D as DriverFactory, R as RawMeasurement, a as CodeSpec } from '../driver-CFm0C_yX.js';
+import { P as PrintRuntime, F as FitFontSize } from '../ports-Bdst9MWJ.js';
 
 interface BrowserRenderResult {
     /** 最终多页 HTML 字符串 */
@@ -46,7 +52,7 @@ declare function renderHtmlPages(template: TemplateData | MultiPageTemplateData,
 /** 浏览器条码/二维码渲染器；码值非法或为空时抛错，由渲染管线降级文本占位 */
 declare const browserCodeRenderer: CodeRenderer;
 
-/** 浏览器端 runtime：iframe driver + 进程内执行器；不提供 PDF/截图 */
+/** 浏览器端 runtime：iframe driver + 进程内执行器；不提供 PDF */
 declare function createBrowserPrintRuntime(): PrintRuntime;
 
 /** 浏览器 iframe driver：进程内直调执行器，无需注入脚本；不提供出图能力 */

package/dist/browser/index.js

@@ -1,3 +1,9 @@
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
 import {
   BARCODE_BAR_HEIGHT_MODULES,
   BARCODE_MARGIN_BOTTOM_MODULES,
@@ -11,7 +17,7 @@ import {
   prepareDocument,
   resolveBarcodeSize,
   resolveShrinkMinFontSize
-} from "../chunk-DCQGN54P.js";
+} from "../chunk-ZCA33XA6.js";
 
 // src/browser/browser-code-renderer.ts
 import JsBarcode from "jsbarcode";

package/dist/{chunk-RXSLSQFO.js → chunk-GHASCGL6.js}

@@ -1,9 +1,15 @@
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
 import {
   compileTemplate,
   evaluate,
   parse,
   tokenize
-} from "./chunk-DCQGN54P.js";
+} from "./chunk-ZCA33XA6.js";
 
 // src/index.ts
 var TemplateEngine = class {

package/dist/{chunk-DCQGN54P.js → chunk-ZCA33XA6.js}

@@ -1,3 +1,10 @@
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
+
 // src/lexer.ts
 var DANGEROUS_PROPS = /* @__PURE__ */ new Set([
   "constructor",
@@ -925,9 +932,6 @@ function bindData(template, printData, baseUrl, fontBaseUrl) {
   if (bound.footer?.elements) {
     bound.footer.elements = bound.footer.elements.map((el) => bindElement(el, data, baseUrl));
   }
-  if (bound.firstPageOverlay?.elements) {
-    bound.firstPageOverlay.elements = bound.firstPageOverlay.elements.map((el) => bindElement(el, data, baseUrl));
-  }
   bound.elements = bound.elements.map((el) => bindElement(el, data, baseUrl));
   const fontBase = fontBaseUrl ?? baseUrl;
   if (fontBase && bound.fonts?.length) {
@@ -1368,7 +1372,6 @@ function areaGeometryBlock(template, paper, desc) {
   const { bottom: mb } = template.margins;
   const headerH = template.header?.height ?? 0;
   const footerH = template.footer?.height ?? 0;
-  const overlayH = template.firstPageOverlay?.height ?? 0;
   const contentWidth = paper.width - ml - mr;
   return `
 /* \u2500\u2500 \u9875\u7709 \u2500\u2500 */
@@ -1380,13 +1383,14 @@ ${desc}.page-header {
 
 /* \u2500\u2500 \u9875\u811A\uFF1A\u7EDD\u5BF9\u5B9A\u4F4D\u56FA\u5B9A\u5728\u9875\u9762\u5E95\u90E8\uFF08\u5185\u5BB9\u4E0D\u8DB3\u65F6\u4E0D\u968F\u6587\u6863\u6D41\u4E0A\u6D6E\uFF09 \u2500\u2500
    \u7528\u663E\u5F0F top \u5B9A\u4F4D\u5230\u300C\u7EB8\u9AD8 - \u4E0B\u8FB9\u8DDD - \u9875\u811A\u9AD8\u300D\uFF0C\u4FDD\u8BC1\u4E0B\u8FB9\u8DDD\u751F\u6548\u3001
-   \u4E0E\u8BBE\u8BA1\u5668 CanvasPaper \u7684\u4E09\u533A\u51E0\u4F55\u4E00\u81F4\u3002 */
+   \u4E0E\u8BBE\u8BA1\u5668 CanvasPaper \u7684\u4E09\u533A\u51E0\u4F55\u4E00\u81F4\u3002
+   \u7EDD\u5BF9\u5B9A\u4F4D\u7684\u5305\u542B\u5757\u662F padding box \u5916\u7F18\uFF08= \u7EB8\u9762\uFF09\uFF0Cleft \u987B\u663E\u5F0F\u8865\u5DE6\u8FB9\u8DDD\u3002 */
 ${desc}.page-footer {
   width: ${mm(contentWidth)};
   height: ${mm(footerH)};
   position: absolute;
   top: ${mm(paper.height - mb - footerH)};
-  left: 0;
+  left: ${mm(ml)};
 }
 
 /* \u2500\u2500 \u5185\u5BB9\u533A \u2500\u2500 */
@@ -1395,13 +1399,6 @@ ${desc}.content-area {
   position: relative;
   overflow: visible;
 }
-
-/* \u2500\u2500 \u9996\u9875\u53E0\u52A0\u533A\u57DF \u2500\u2500 */
-${desc}.first-page-overlay {
-  width: ${mm(contentWidth)};
-  height: ${mm(overlayH)};
-  position: relative;
-}
 `;
 }
 function buildBasePageCss() {
@@ -1599,7 +1596,7 @@ var VALID_STYLES = /* @__PURE__ */ new Set(["solid", "dashed", "dotted", "double
 function parseBorder(width, style, color) {
   if (typeof width !== "number" || !Number.isFinite(width) || width <= 0) return null;
   return {
-    borderWidth: `${width}px`,
+    borderWidth: `${width}pt`,
     borderStyle: typeof style === "string" && VALID_STYLES.has(style) ? style : "solid",
     borderColor: color || "#000"
   };
@@ -1885,7 +1882,6 @@ function paginate(template, measuredElements) {
   const { top: mt, bottom: mb } = template.margins;
   const headerH = template.header?.height ?? 0;
   const footerH = template.footer?.height ?? 0;
-  const overlayH = template.firstPageOverlay?.height ?? 0;
   const continuous = isContinuousPaper(template);
   const contentHeight = continuous ? Number.POSITIVE_INFINITY : paper.height - mt - mb - headerH - footerH;
   if (!continuous && contentHeight <= 0) {
@@ -1925,8 +1921,7 @@ function paginate(template, measuredElements) {
   const unitOf = buildPaginationUnits(sorted, measuredElements, groupMap);
   const pages = [];
   let currentPage = [];
-  let remaining = contentHeight - overlayH - SAFETY_MARGIN;
-  let isFirstPage = true;
+  let remaining = contentHeight - SAFETY_MARGIN;
   let pageBroken = false;
   function sectionTop(el) {
     return pageBroken ? pageCursorTop() : el.options?.top ?? 0;
@@ -1935,7 +1930,7 @@ function paginate(template, measuredElements) {
     return Math.max(0, fullPageHeight() - remaining);
   }
   function fullPageHeight() {
-    return isFirstPage ? contentHeight - overlayH - SAFETY_MARGIN : contentHeight - SAFETY_MARGIN;
+    return contentHeight - SAFETY_MARGIN;
   }
   let overflowOnCurrent = false;
   function pushPage() {
@@ -1954,7 +1949,6 @@ function paginate(template, measuredElements) {
     pushPage();
     currentPage = [];
     remaining = contentHeight - SAFETY_MARGIN;
-    isFirstPage = false;
     pageBroken = true;
     overflowOnCurrent = false;
   }
@@ -2311,7 +2305,6 @@ function generateMeasurementHtml(template, css, ctx, printData) {
     // totalPages placeholder
     ctx
   );
-  const overlayHtml = renderAreaElements(template.firstPageOverlay?.elements ?? [], contentWidth, void 0, void 0, ctx);
   let html = `<!DOCTYPE html>
 <html lang="zh-CN">
 <head>
@@ -2322,7 +2315,6 @@ function generateMeasurementHtml(template, css, ctx, printData) {
 <section class="print-page" data-measure-page="0">
   ${renderWatermarkLayerHtml(template.watermark, printData, getPaperDims(template))}
   <div class="page-header">${headerHtml}</div>
-  <div class="first-page-overlay">${overlayHtml}</div>
   <div class="content-area" style="height:auto;overflow:visible;">
     ${elementsHtml}
   </div>
@@ -2386,14 +2378,12 @@ function renderPage(template, page, pageNum, totalPages, ctx, printData, pageCla
     totalPages,
     pageCtx
   );
-  const overlayHtml = page.pageIndex === 0 ? `<div class="first-page-overlay">${renderAreaElements(scoped.firstPageOverlay?.elements ?? [], contentWidth, pageNum, totalPages, pageCtx)}</div>` : "";
   let contentHtml = page.sections.map((section) => renderSection(section, scoped, pageCtx)).join("\n");
   contentHtml = contentHtml.replace(/\{pageIndex\}/g, String(pageNum));
   contentHtml = contentHtml.replace(/\{totalPages\}/g, String(totalPages));
   const pageInner = `
   ${renderWatermarkLayerHtml(template.watermark, printData, paperMm, { pageIndex: pageNum, totalPages })}
   <div class="page-header">${headerHtml}</div>
-  ${overlayHtml}
   <div class="content-area">
     ${contentHtml}
   </div>
@@ -2417,16 +2407,14 @@ function withPageNumbers(template, vars) {
     ...template,
     elements: template.elements.map(mapEl),
     header: mapArea(template.header),
-    footer: mapArea(template.footer),
-    firstPageOverlay: mapArea(template.firstPageOverlay)
+    footer: mapArea(template.footer)
   };
 }
 function templateReferencesPageNumbers(template) {
   const areas = [
     template.elements,
     template.header?.elements,
-    template.footer?.elements,
-    template.firstPageOverlay?.elements
+    template.footer?.elements
   ];
   return areas.some((list) => (list ?? []).some((el) => typeof el.options?.rawFormatter === "string"));
 }
@@ -2526,13 +2514,13 @@ function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
 </div>`;
     }
     case "hline":
-      return `<div class="print-element" style="${style};border-top:1px solid #000;height:0;"${measureAttr}></div>`;
+      return `<div class="print-element" style="${style};border-top:${opts.borderWidth || 0.75}pt ${opts.borderStyle || "solid"} ${opts.borderColor || "#333"};height:0;"${measureAttr}></div>`;
     case "vline":
-      return `<div class="print-element" style="${style};border-left:1px solid #000;width:0;"${measureAttr}></div>`;
+      return `<div class="print-element" style="${style};border-left:${opts.borderWidth || 0.75}pt ${opts.borderStyle || "solid"} ${opts.borderColor || "#333"};width:0;"${measureAttr}></div>`;
     case "rect":
-      return `<div class="print-element" style="${style};border:${opts.borderWidth ?? 1}px solid ${opts.borderColor ?? "#000"};"${measureAttr}></div>`;
+      return `<div class="print-element" style="${style};border:${opts.borderWidth || 1}pt ${opts.borderStyle || "solid"} ${opts.borderColor || "#333"};"${measureAttr}></div>`;
     case "oval":
-      return `<div class="print-element" style="${style};border:${opts.borderWidth ?? 1}px solid ${opts.borderColor ?? "#000"};border-radius:50%;"${measureAttr}></div>`;
+      return `<div class="print-element" style="${style};border:${opts.borderWidth || 1}pt ${opts.borderStyle || "solid"} ${opts.borderColor || "#333"};border-radius:50%;"${measureAttr}></div>`;
     case "longText":
       return `<div class="print-element" style="${style}${textStyle(opts)}${elementFitStyle(fit, opts)}"${measureAttr}${fitAttr}>${esc(opts.formatter ?? opts.testData ?? "")}</div>`;
     case "html":
@@ -2915,9 +2903,6 @@ function toPlaywrightPdfOptions(spec) {
     preferCSSPageSize: spec.preferCSSPageSize
   };
 }
-function buildScreenshotTargetSpec() {
-  return { type: "png", fullPage: true, omitBackground: false };
-}
 
 // src/print/measure.ts
 function normalizeMeasurements(raw, template) {
@@ -2952,7 +2937,6 @@ function applyTextFitSizes(template, fits) {
   collect(template.elements);
   collect(template.header?.elements);
   collect(template.footer?.elements);
-  collect(template.firstPageOverlay?.elements);
   for (const fit of fits) {
     const parsed = parseCellFitKey(fit.key);
     if (!parsed) {
@@ -3124,23 +3108,6 @@ function createDomHostRuntime(factory, bundle) {
             "RENDER_TIMEOUT",
             `PDF \u751F\u6210\u8D85\u8FC7 ${ms}ms`
           );
-        },
-        async toScreenshot(html, spec, viewport) {
-          if (!driver.screenshot) throw new PrintFailure("UNSUPPORTED_RUNTIME", "\u5F53\u524D\u5BBF\u4E3B\u4E0D\u652F\u6301\u622A\u56FE");
-          const ms = budget();
-          return withTimeout(
-            (async () => {
-              try {
-                await load(html, viewport);
-                return await driver.screenshot(html, spec);
-              } catch (err) {
-                throw fail(err, "SCREENSHOT_FAILED", "\u622A\u56FE\u5931\u8D25");
-              }
-            })(),
-            ms,
-            "RENDER_TIMEOUT",
-            `\u622A\u56FE\u8D85\u8FC7 ${ms}ms`
-          );
         }
       };
       try {
@@ -3475,33 +3442,6 @@ async function renderPdf(job, runtime) {
     return { pdf, prepared };
   });
 }
-async function renderScreenshot(job, runtime) {
-  return runtime.withSession(job, async (session) => {
-    const pageTemplates = normalizeTemplate(job.templateJson);
-    if (pageTemplates.length > 1) {
-      const normalized2 = normalizePrintData(job.printData);
-      const data2 = normalized2.mode === "batch" ? normalized2.dataList[0] : normalized2.data;
-      const copy = await prepareMultiCopy(job, session, data2);
-      const doc = composeMultiPageDocument([copy]);
-      const viewport2 = paperViewportPx(getPaperDimensions(pageTemplates[0]));
-      return session.toScreenshot(doc.html, buildScreenshotTargetSpec(), viewport2);
-    }
-    const singleJob = pageTemplates[0] !== job.templateJson ? { ...job, templateJson: pageTemplates[0] } : job;
-    const normalized = normalizePrintData(singleJob.printData);
-    const data = normalized.mode === "batch" ? normalized.dataList[0] : normalized.data;
-    const bound = bindData(singleJob.templateJson, data, singleJob.baseUrl, singleJob.fontBaseUrl);
-    const built = await buildHtmlWithCodes({
-      bound,
-      job: singleJob,
-      session,
-      data,
-      pageLayouts: [],
-      isMeasurementPass: true
-    });
-    const viewport = paperViewportPx(getPaperDimensions(bound));
-    return session.toScreenshot(built.html, buildScreenshotTargetSpec(), viewport);
-  });
-}
 async function prepareWithSession(job, session) {
   const pageTemplates = normalizeTemplate(job.templateJson);
   if (pageTemplates.length > 1) {
@@ -3836,7 +3776,6 @@ export {
   buildPdfTargetSpec,
   toElectronPrintToPdfOptions,
   toPlaywrightPdfOptions,
-  buildScreenshotTargetSpec,
   normalizeMeasurements,
   applyTextFitSizes,
   codeSpecKey,
@@ -3865,6 +3804,5 @@ export {
   mergeFontDeclarations,
   composeMultiPageDocument,
   prepareDocument,
-  renderPdf,
-  renderScreenshot
+  renderPdf
 };

package/dist/client/index.cjs

@@ -1,3 +1,9 @@
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/client/index.d.cts

@@ -1,3 +1,9 @@
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
 declare const APP_ID = "worm-print-client";
 declare const DEFAULT_PORT = 17521;
 declare const PORT_SCAN_LIMIT = 20;

package/dist/client/index.d.ts

@@ -1,3 +1,9 @@
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
 declare const APP_ID = "worm-print-client";
 declare const DEFAULT_PORT = 17521;
 declare const PORT_SCAN_LIMIT = 20;

package/dist/client/index.js

@@ -1,3 +1,10 @@
+/*!
+ * @worm-vue3-print/core v1.3.5
+ * Copyright (c) 2026 Worm Base AI
+ * SPDX-FileCopyrightText: 2026 Worm Base AI
+ * SPDX-License-Identifier: MIT
+ */
+
 // src/client/protocol.ts
 var APP_ID = "worm-print-client";
 var DEFAULT_PORT = 17521;