@worm-vue3-print/core 1.2.2 → 1.3.1

package/dist/browser/index.d.cts

@@ -1,4 +1,5 @@
-import { P as PageLayout, T as TemplateData, C as CodeRenderer } from '../types-BGBAbQD5.cjs';
+import { P as PageLayout, T as TemplateData, M as MultiPageTemplateData, C as CodeRenderer, D as DriverFactory, R as RawMeasurement, a as CodeSpec } from '../driver-Dn_YAzO5.cjs';
+import { P as PrintRuntime, F as FitFontSize } from '../ports-Cf5sjwls.cjs';
 
 interface BrowserRenderResult {
     /** 最终多页 HTML 字符串 */
@@ -7,17 +8,89 @@ interface BrowserRenderResult {
     pageCount: number;
     /** 分页布局（调试/高级用途） */
     pageLayouts: PageLayout[];
+    /** 最终纸张尺寸（mm，已含方向）；连续纸为探针推导后的高度 */
+    paperMm: {
+        width: number;
+        height: number;
+    };
+    /** 模板是否连续纸 */
+    continuous: boolean;
+    /** 份数（对象数据=1；数组=数组长度） */
+    copies: number;
+    /** 批量时每份纸张尺寸（连续纸各份高度可能不同） */
+    copyPaperMm?: {
+        width: number;
+        height: number;
+    }[];
+}
+interface BrowserRenderOptions {
+    /** 连续纸显式纸高覆盖（mm）；仅对 CONTINUOUS 生效 */
+    paperHeightMm?: number;
+    /**
+     * 相对路径字体基址。缺省空串 = 不拼接，由文档自身 origin 解析——
+     * 与设计器画布注入 @font-face 的语义一致（画布能加载的字体，预览/浏览器打印也能加载）。
+     * 传值则拼在该基址上，供字体与页面不同源的宿主使用。
+     */
+    fontBaseUrl?: string;
 }
 /**
- * 浏览器内完成「数据绑定 → 测量 → 分页 → 最终 HTML」全流程。
- * @param template 模板 JSON（设计器 TemplateData 结构兼容）
+ * 浏览器内完成「数据绑定 → 码值渲染 → 测量 → 分页 → 连续纸推导 → 最终 HTML」。
+ * @param template 模板 JSON（设计器 TemplateData 结构兼容；含 { pages } 多页面模板）
  * @param printData 业务数据
  * @param baseUrl 图片相对路径拼接前缀
- * @param codeRenderer 条码渲染器（browserCodeRenderer）
+ * @param codeRenderer 调用方提供的码值渲染器；传入时沿用该渲染器（既有覆盖语义）
+ * @param options 渲染选项（连续纸纸高覆盖等）
  */
-declare function renderHtmlPages(template: TemplateData, printData?: Record<string, any> | Record<string, any>[], baseUrl?: string, codeRenderer?: CodeRenderer): Promise<BrowserRenderResult>;
+declare function renderHtmlPages(template: TemplateData | MultiPageTemplateData, printData?: Record<string, any> | Record<string, any>[], baseUrl?: string, codeRenderer?: CodeRenderer, options?: BrowserRenderOptions): Promise<BrowserRenderResult>;
 
 /** 浏览器条码/二维码渲染器；码值非法或为空时抛错，由渲染管线降级文本占位 */
 declare const browserCodeRenderer: CodeRenderer;
 
-export { type BrowserRenderResult, browserCodeRenderer, renderHtmlPages };
+/** 浏览器端 runtime：iframe driver + 进程内执行器；不提供 PDF/截图 */
+declare function createBrowserPrintRuntime(): PrintRuntime;
+
+/** 浏览器 iframe driver：进程内直调执行器，无需注入脚本；不提供出图能力 */
+declare function createIframeDriverFactory(): DriverFactory;
+
+/**
+ * 单个节点自动缩小；返回最终字号（pt）。非 shrink 节点返回 undefined。
+ * 缩到下限仍放不下时保持下限字号，由容器裁剪兜底（等价退化为截断）。
+ * 返回的字号与写进 DOM 的字号完全一致（向下取两位小数），
+ * 否则测量趟按 9.623pt 排版、最终趟按回写的 9.62pt 渲染，会出现不可控的亚像素错版。
+ */
+declare function fitTextNode(el: HTMLElement): number | undefined;
+/**
+ * 全文档自动缩小：按 DOM 顺序处理所有 data-fit="shrink" 节点，
+ * 返回需要回写到模板的字号清单（key = 元素 id 或 `元素id#行类别#行:列`）。
+ * 调用方须在读取测量值之前执行，使实测高度与最终渲染同口径。
+ */
+declare function applyTextFit(doc: Document): FitFontSize[];
+
+/** 执行器版本：注入失败时用于日志定位产物不匹配 */
+declare const EXECUTOR_VERSION = "2";
+
+/** 等待文档加载、字体就绪与图片完成；任何失败都不阻断（测量有兜底） */
+declare function waitReady(win: Window, timeoutMs?: number): Promise<void>;
+/**
+ * 读取 [data-measure-id] 元素高度与表格行高（原始 CSS px）。
+ * 用 getBoundingClientRect().height 而非 offsetHeight：后者是取整整数，
+ * 38mm 会被舍成 144px（38.1mm），在内容刚好顶满分页预算时把「放得下」误判为
+ * 「放不下」，进而触发换页。亚像素精度才能反映真实布局高度。
+ */
+declare function readMeasurements(doc: Document): RawMeasurement[];
+/** 内容区后代相对 .print-page 顶部的最大底边（CSS px）；绝对定位元素的几何由真实引擎决定 */
+declare function readContentBottom(doc: Document): number;
+/** 码值 → SVG 映射；单项失败跳过，交由 core 降级文本占位 */
+declare function renderCodes(specs: CodeSpec[]): Record<string, string>;
+/** 注入后挂在 globalThis.__wormDom 上的执行器对象 */
+declare const domExecutor: {
+    version: string;
+    waitReady: typeof waitReady;
+    readMeasurements: typeof readMeasurements;
+    readContentBottom: typeof readContentBottom;
+    renderCodes: typeof renderCodes;
+    /** 自动缩小（data-fit="shrink"）：须在 readMeasurements 之前调用，返回需回写的字号清单 */
+    applyTextFit: typeof applyTextFit;
+};
+
+export { type BrowserRenderOptions, type BrowserRenderResult, EXECUTOR_VERSION, applyTextFit, browserCodeRenderer, createBrowserPrintRuntime, createIframeDriverFactory, domExecutor, fitTextNode, readContentBottom, readMeasurements, renderCodes, renderHtmlPages, waitReady };

package/dist/browser/index.d.ts

@@ -1,4 +1,5 @@
-import { P as PageLayout, T as TemplateData, C as CodeRenderer } from '../types-BGBAbQD5.js';
+import { P as PageLayout, T as TemplateData, M as MultiPageTemplateData, C as CodeRenderer, D as DriverFactory, R as RawMeasurement, a as CodeSpec } from '../driver-Dn_YAzO5.js';
+import { P as PrintRuntime, F as FitFontSize } from '../ports-BvwlA_km.js';
 
 interface BrowserRenderResult {
     /** 最终多页 HTML 字符串 */
@@ -7,17 +8,89 @@ interface BrowserRenderResult {
     pageCount: number;
     /** 分页布局（调试/高级用途） */
     pageLayouts: PageLayout[];
+    /** 最终纸张尺寸（mm，已含方向）；连续纸为探针推导后的高度 */
+    paperMm: {
+        width: number;
+        height: number;
+    };
+    /** 模板是否连续纸 */
+    continuous: boolean;
+    /** 份数（对象数据=1；数组=数组长度） */
+    copies: number;
+    /** 批量时每份纸张尺寸（连续纸各份高度可能不同） */
+    copyPaperMm?: {
+        width: number;
+        height: number;
+    }[];
+}
+interface BrowserRenderOptions {
+    /** 连续纸显式纸高覆盖（mm）；仅对 CONTINUOUS 生效 */
+    paperHeightMm?: number;
+    /**
+     * 相对路径字体基址。缺省空串 = 不拼接，由文档自身 origin 解析——
+     * 与设计器画布注入 @font-face 的语义一致（画布能加载的字体，预览/浏览器打印也能加载）。
+     * 传值则拼在该基址上，供字体与页面不同源的宿主使用。
+     */
+    fontBaseUrl?: string;
 }
 /**
- * 浏览器内完成「数据绑定 → 测量 → 分页 → 最终 HTML」全流程。
- * @param template 模板 JSON（设计器 TemplateData 结构兼容）
+ * 浏览器内完成「数据绑定 → 码值渲染 → 测量 → 分页 → 连续纸推导 → 最终 HTML」。
+ * @param template 模板 JSON（设计器 TemplateData 结构兼容；含 { pages } 多页面模板）
  * @param printData 业务数据
  * @param baseUrl 图片相对路径拼接前缀
- * @param codeRenderer 条码渲染器（browserCodeRenderer）
+ * @param codeRenderer 调用方提供的码值渲染器；传入时沿用该渲染器（既有覆盖语义）
+ * @param options 渲染选项（连续纸纸高覆盖等）
  */
-declare function renderHtmlPages(template: TemplateData, printData?: Record<string, any> | Record<string, any>[], baseUrl?: string, codeRenderer?: CodeRenderer): Promise<BrowserRenderResult>;
+declare function renderHtmlPages(template: TemplateData | MultiPageTemplateData, printData?: Record<string, any> | Record<string, any>[], baseUrl?: string, codeRenderer?: CodeRenderer, options?: BrowserRenderOptions): Promise<BrowserRenderResult>;
 
 /** 浏览器条码/二维码渲染器；码值非法或为空时抛错，由渲染管线降级文本占位 */
 declare const browserCodeRenderer: CodeRenderer;
 
-export { type BrowserRenderResult, browserCodeRenderer, renderHtmlPages };
+/** 浏览器端 runtime：iframe driver + 进程内执行器；不提供 PDF/截图 */
+declare function createBrowserPrintRuntime(): PrintRuntime;
+
+/** 浏览器 iframe driver：进程内直调执行器，无需注入脚本；不提供出图能力 */
+declare function createIframeDriverFactory(): DriverFactory;
+
+/**
+ * 单个节点自动缩小；返回最终字号（pt）。非 shrink 节点返回 undefined。
+ * 缩到下限仍放不下时保持下限字号，由容器裁剪兜底（等价退化为截断）。
+ * 返回的字号与写进 DOM 的字号完全一致（向下取两位小数），
+ * 否则测量趟按 9.623pt 排版、最终趟按回写的 9.62pt 渲染，会出现不可控的亚像素错版。
+ */
+declare function fitTextNode(el: HTMLElement): number | undefined;
+/**
+ * 全文档自动缩小：按 DOM 顺序处理所有 data-fit="shrink" 节点，
+ * 返回需要回写到模板的字号清单（key = 元素 id 或 `元素id#行类别#行:列`）。
+ * 调用方须在读取测量值之前执行，使实测高度与最终渲染同口径。
+ */
+declare function applyTextFit(doc: Document): FitFontSize[];
+
+/** 执行器版本：注入失败时用于日志定位产物不匹配 */
+declare const EXECUTOR_VERSION = "2";
+
+/** 等待文档加载、字体就绪与图片完成；任何失败都不阻断（测量有兜底） */
+declare function waitReady(win: Window, timeoutMs?: number): Promise<void>;
+/**
+ * 读取 [data-measure-id] 元素高度与表格行高（原始 CSS px）。
+ * 用 getBoundingClientRect().height 而非 offsetHeight：后者是取整整数，
+ * 38mm 会被舍成 144px（38.1mm），在内容刚好顶满分页预算时把「放得下」误判为
+ * 「放不下」，进而触发换页。亚像素精度才能反映真实布局高度。
+ */
+declare function readMeasurements(doc: Document): RawMeasurement[];
+/** 内容区后代相对 .print-page 顶部的最大底边（CSS px）；绝对定位元素的几何由真实引擎决定 */
+declare function readContentBottom(doc: Document): number;
+/** 码值 → SVG 映射；单项失败跳过，交由 core 降级文本占位 */
+declare function renderCodes(specs: CodeSpec[]): Record<string, string>;
+/** 注入后挂在 globalThis.__wormDom 上的执行器对象 */
+declare const domExecutor: {
+    version: string;
+    waitReady: typeof waitReady;
+    readMeasurements: typeof readMeasurements;
+    readContentBottom: typeof readContentBottom;
+    renderCodes: typeof renderCodes;
+    /** 自动缩小（data-fit="shrink"）：须在 readMeasurements 之前调用，返回需回写的字号清单 */
+    applyTextFit: typeof applyTextFit;
+};
+
+export { type BrowserRenderOptions, type BrowserRenderResult, EXECUTOR_VERSION, applyTextFit, browserCodeRenderer, createBrowserPrintRuntime, createIframeDriverFactory, domExecutor, fitTextNode, readContentBottom, readMeasurements, renderCodes, renderHtmlPages, waitReady };

package/dist/browser/index.js

@@ -1,141 +1,59 @@
 import {
-  bindData,
-  generateHtml,
-  getPaperDimensions,
-  paginate
-} from "../chunk-JZIVNXZ7.js";
-
-// src/browser/browser-pagination.ts
-var PX_PER_MM = 3.7795275591;
-var READY_TIMEOUT_MS = 3e3;
-async function renderHtmlPages(template, printData, baseUrl, codeRenderer) {
-  const boundTemplate = bindData(template, printData, baseUrl);
-  const measuredElements = await measureElements(boundTemplate, codeRenderer);
-  const pageLayouts = paginate(boundTemplate, measuredElements);
-  const html = generateHtml(boundTemplate, pageLayouts, printData, {
-    codeRenderer
-  });
-  return { html, pageCount: pageLayouts.length, pageLayouts };
-}
-async function measureElements(template, codeRenderer) {
-  const paper = getPaperDimensions(template);
-  const measureHtml = generateHtml(template, [], void 0, {
-    isMeasurementPass: true,
-    codeRenderer
-  });
-  const iframe = document.createElement("iframe");
-  iframe.setAttribute("aria-hidden", "true");
-  iframe.style.cssText = `position:fixed;left:-10000px;top:0;width:${paper.width}mm;height:${paper.height}mm;border:0;visibility:hidden;pointer-events:none;`;
-  document.body.appendChild(iframe);
-  try {
-    const win = iframe.contentWindow;
-    const doc = iframe.contentDocument;
-    if (!win || !doc) throw new Error("\u65E0\u6CD5\u521B\u5EFA\u6D4B\u91CF iframe");
-    doc.open();
-    doc.write(measureHtml);
-    doc.close();
-    await waitForRenderReady(win);
-    const measurements = readMeasurements(doc);
-    const measuredMap = /* @__PURE__ */ new Map();
-    const elementIndex = new Map(template.elements.map((el) => [el.id, el]));
-    for (const m of measurements) {
-      const el = elementIndex.get(m.id);
-      const repeatCount = el?.options?._repeatHeaderCount ?? 0;
-      measuredMap.set(m.id, {
-        id: m.id,
-        measuredHeight: m.height,
-        measuredRowHeights: m.rowHeights,
-        repeatHeaderHeight: m.rowHeights && repeatCount > 0 ? m.rowHeights.slice(0, repeatCount).reduce((s, h) => s + h, 0) : 0
-      });
-    }
-    return measuredMap;
-  } finally {
-    iframe.remove();
-  }
-}
-function waitForRenderReady(win) {
-  return new Promise((resolve) => {
-    let settled = false;
-    const finish = () => {
-      if (!settled) {
-        settled = true;
-        resolve();
-      }
-    };
-    const timer = setTimeout(finish, READY_TIMEOUT_MS);
-    const run = async () => {
-      try {
-        const fonts = win.document.fonts;
-        if (fonts?.ready) {
-          await Promise.race([fonts.ready, timeout(READY_TIMEOUT_MS)]);
-        }
-        await Promise.race([waitForImages(win.document), timeout(READY_TIMEOUT_MS)]);
-      } catch {
-      } finally {
-        clearTimeout(timer);
-        finish();
-      }
-    };
-    if (win.document.readyState === "complete") {
-      void run();
-    } else {
-      win.addEventListener("load", () => void run(), { once: true });
-      setTimeout(finish, READY_TIMEOUT_MS);
-    }
-  });
-}
-function timeout(ms) {
-  return new Promise((_resolve, reject) => setTimeout(() => reject(new Error("timeout")), ms));
-}
-function waitForImages(doc) {
-  const imgs = Array.from(doc.images ?? []);
-  return Promise.all(
-    imgs.map(
-      (img) => img.complete ? Promise.resolve() : new Promise((resolve) => {
-        img.addEventListener("load", () => resolve(), { once: true });
-        img.addEventListener("error", () => resolve(), { once: true });
-      })
-    )
-  ).then(() => void 0);
-}
-function readMeasurements(doc) {
-  const result = [];
-  const elements = doc.querySelectorAll("[data-measure-id]");
-  for (const el of elements) {
-    const htmlEl = el;
-    const id = htmlEl.getAttribute("data-measure-id");
-    if (!id) continue;
-    const heightPx = htmlEl.offsetHeight;
-    const table = htmlEl.querySelector("table.print-table");
-    if (table) {
-      const rowHeights = [];
-      const rows = table.querySelectorAll("tbody > tr[data-row-index]");
-      for (const row of rows) {
-        rowHeights.push(row.offsetHeight / PX_PER_MM);
-      }
-      result.push({ id, height: heightPx / PX_PER_MM, rowHeights });
-    } else {
-      result.push({ id, height: heightPx / PX_PER_MM });
-    }
-  }
-  return result;
-}
+  BARCODE_BAR_HEIGHT_MODULES,
+  BARCODE_MARGIN_BOTTOM_MODULES,
+  BARCODE_QUIET_ZONE_MODULES,
+  BARCODE_TEXT_FONT_SIZE_MODULES,
+  EXECUTOR_TARGETS,
+  barcodeUnitsPerModule,
+  createDomHostRuntime,
+  floorFontSize,
+  mmToPx,
+  prepareDocument,
+  resolveBarcodeSize,
+  resolveShrinkMinFontSize
+} from "../chunk-KFRPTLFV.js";
 
 // src/browser/browser-code-renderer.ts
 import JsBarcode from "jsbarcode";
 import QRCode from "qrcode";
 var SVG_NS = "http://www.w3.org/2000/svg";
+function readViewBox(svg) {
+  const raw = svg.getAttribute("viewBox");
+  if (!raw) return null;
+  const parts = raw.trim().split(/[\s,]+/).map(Number);
+  if (parts.length !== 4 || parts.some((v) => !Number.isFinite(v))) return null;
+  return { width: parts[2], height: parts[3] };
+}
 function renderBarcodeSvg(value, opts) {
   const svg = document.createElementNS(SVG_NS, "svg");
+  const unitPerModule = barcodeUnitsPerModule(opts.barWidth);
   JsBarcode(svg, value, {
     format: opts.barcodeType || "CODE128",
-    width: Math.max(1, (opts.barWidth ?? 2) / 2),
-    height: 30,
+    width: unitPerModule,
+    height: BARCODE_BAR_HEIGHT_MODULES * unitPerModule,
     displayValue: opts.showText !== false,
-    fontSize: opts.fontSize ?? 10,
+    fontSize: (opts.fontSize ?? BARCODE_TEXT_FONT_SIZE_MODULES) * unitPerModule,
+    // 静区只留左右：上下留白会白白吃掉元素高度（jsbarcode 的 margin 是四边通配）
     margin: 0,
-    marginBottom: 2
+    marginLeft: BARCODE_QUIET_ZONE_MODULES * unitPerModule,
+    marginRight: BARCODE_QUIET_ZONE_MODULES * unitPerModule,
+    marginTop: 0,
+    marginBottom: BARCODE_MARGIN_BOTTOM_MODULES * unitPerModule
   });
+  const viewBox = readViewBox(svg);
+  if (viewBox) {
+    const size = resolveBarcodeSize({
+      unitWidth: viewBox.width / unitPerModule,
+      unitHeight: viewBox.height / unitPerModule,
+      boxWidthMm: opts.targetWidthMm ?? 0,
+      boxHeightMm: opts.targetHeightMm ?? 0,
+      dpi: opts.printerDpi,
+      barWidth: opts.barWidth
+    });
+    svg.setAttribute("width", `${size.widthMm}mm`);
+    svg.setAttribute("height", `${size.heightMm}mm`);
+  }
+  svg.setAttribute("shape-rendering", "crispEdges");
   return svg.outerHTML;
 }
 function renderQrSvg(value, opts) {
@@ -158,13 +76,250 @@ function renderQrSvg(value, opts) {
   }
   return `<svg xmlns="${SVG_NS}" viewBox="0 0 ${dim} ${dim}" width="${dim}" height="${dim}" shape-rendering="crispEdges">${rects}</svg>`;
 }
+function renderCodeSvg(value, cellType, opts = {}) {
+  if (!value) throw new Error("empty barcode value");
+  return cellType === "qrcode" ? renderQrSvg(value, opts) : renderBarcodeSvg(value, opts);
+}
 var browserCodeRenderer = {
   render(value, cellType, opts = {}) {
-    if (!value) throw new Error("empty barcode value");
-    return cellType === "qrcode" ? renderQrSvg(value, opts) : renderBarcodeSvg(value, opts);
+    return renderCodeSvg(value, cellType, opts);
+  }
+};
+
+// src/browser/text-fit-dom.ts
+var FIT_TOLERANCE_PX = 0.5;
+var SEARCH_STEPS = 12;
+function readAttrNumber(el, name) {
+  const raw = el.getAttribute(name);
+  if (raw === null || raw === "") return void 0;
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : void 0;
+}
+function overflows(el, targetPx) {
+  if (el.scrollWidth > el.clientWidth + FIT_TOLERANCE_PX) return true;
+  const content = el.scrollHeight;
+  if (targetPx !== void 0) return content > targetPx + FIT_TOLERANCE_PX;
+  return content > el.clientHeight + FIT_TOLERANCE_PX;
+}
+function fitTextNode(el) {
+  if (el.getAttribute("data-fit") !== "shrink") return void 0;
+  const minPt = resolveShrinkMinFontSize(readAttrNumber(el, "data-fit-min"));
+  const start = Math.max(readAttrNumber(el, "data-fit-base") ?? minPt, minPt);
+  const targetMm = readAttrNumber(el, "data-fit-mm");
+  const targetPx = targetMm !== void 0 && targetMm > 0 ? mmToPx(targetMm) : void 0;
+  const apply = (pt) => {
+    const size = floorFontSize(pt);
+    el.style.fontSize = `${size}pt`;
+    el.setAttribute("data-fit-size", String(size));
+    return size;
+  };
+  const base = apply(start);
+  if (!overflows(el, targetPx)) return base;
+  if (start <= minPt) return base;
+  let lo = minPt;
+  let hi = start;
+  for (let i = 0; i < SEARCH_STEPS; i++) {
+    const mid = (lo + hi) / 2;
+    apply(mid);
+    if (overflows(el, targetPx)) hi = mid;
+    else lo = mid;
   }
+  return apply(lo);
+}
+function applyTextFit(doc) {
+  const fits = [];
+  doc.querySelectorAll('[data-fit="shrink"]').forEach((el) => {
+    const size = fitTextNode(el);
+    const key = el.getAttribute("data-fit-key");
+    if (size === void 0 || !key) return;
+    fits.push({ key, fontSizePt: size });
+  });
+  return fits;
+}
+
+// src/browser/dom-executor.ts
+var EXECUTOR_VERSION = "2";
+var DEFAULT_READY_TIMEOUT_MS = 5e3;
+async function waitReady(win, timeoutMs = DEFAULT_READY_TIMEOUT_MS) {
+  const doc = win.document;
+  const wait = (task) => Promise.race([task, new Promise((resolve) => setTimeout(resolve, timeoutMs))]);
+  const ready = (async () => {
+    if (doc.readyState !== "complete") {
+      await wait(new Promise((resolve) => win.addEventListener("load", () => resolve(), { once: true })));
+    }
+    const fonts = doc.fonts;
+    if (fonts) {
+      await wait(Promise.all(declaredFontFaces(doc).map(
+        (face) => fonts.load(`${face.style} ${face.weight} 16px "${face.family}"`).catch(() => void 0)
+      )));
+      if (fonts.ready) await wait(fonts.ready);
+    }
+    await wait(Promise.all(Array.from(doc.images ?? []).map(
+      (img) => img.complete ? Promise.resolve() : new Promise((resolve) => {
+        img.addEventListener("load", () => resolve(), { once: true });
+        img.addEventListener("error", () => resolve(), { once: true });
+      })
+    )));
+  })();
+  await wait(ready);
+}
+function declaredFontFaces(doc) {
+  const out = [];
+  const CSS_FONT_FACE_RULE = 5;
+  for (const sheet of Array.from(doc.styleSheets ?? [])) {
+    let rules;
+    try {
+      rules = sheet.cssRules;
+    } catch {
+      continue;
+    }
+    for (const rule of Array.from(rules ?? [])) {
+      if (rule.type !== CSS_FONT_FACE_RULE) continue;
+      const style = rule.style;
+      const family = (style.getPropertyValue("font-family") || "").replace(/^["']|["']$/g, "");
+      if (!family) continue;
+      out.push({
+        family,
+        weight: style.getPropertyValue("font-weight") || "400",
+        style: style.getPropertyValue("font-style") || "normal"
+      });
+    }
+  }
+  return out;
+}
+function readMeasurements(doc) {
+  const result = [];
+  doc.querySelectorAll("[data-measure-id]").forEach((node) => {
+    const el = node;
+    const id = el.getAttribute("data-measure-id");
+    if (!id) return;
+    const heightPx = el.getBoundingClientRect().height;
+    const table = el.querySelector("table.print-table");
+    if (!table) {
+      result.push({ id, heightPx });
+      return;
+    }
+    const rowHeightsPx = [];
+    table.querySelectorAll("tbody > tr[data-row-index]").forEach((row) => {
+      rowHeightsPx.push(row.getBoundingClientRect().height);
+    });
+    result.push({ id, heightPx, rowHeightsPx });
+  });
+  return result;
+}
+function readContentBottom(doc) {
+  const page = doc.querySelector(".print-page");
+  const area = doc.querySelector(".content-area");
+  if (!page || !area) return 0;
+  const pageTop = page.getBoundingClientRect().top;
+  let maxBottom = 0;
+  area.querySelectorAll("*").forEach((node) => {
+    const rect = node.getBoundingClientRect();
+    if (rect.height > 0) maxBottom = Math.max(maxBottom, rect.bottom - pageTop);
+  });
+  const areaRect = area.getBoundingClientRect();
+  if (areaRect.height > 0) maxBottom = Math.max(maxBottom, areaRect.bottom - pageTop);
+  return maxBottom;
+}
+function renderCodes(specs) {
+  const map = {};
+  for (const spec of specs) {
+    try {
+      map[spec.key] = renderCodeSvg(spec.value, spec.cellType, spec.opts);
+    } catch {
+    }
+  }
+  return map;
+}
+var domExecutor = {
+  version: EXECUTOR_VERSION,
+  waitReady,
+  readMeasurements,
+  readContentBottom,
+  renderCodes,
+  /** 自动缩小（data-fit="shrink"）：须在 readMeasurements 之前调用，返回需回写的字号清单 */
+  applyTextFit
 };
+
+// src/browser/driver-iframe.ts
+function createIframeDriverFactory() {
+  return {
+    async createDriver() {
+      const iframe = document.createElement("iframe");
+      iframe.setAttribute("aria-hidden", "true");
+      iframe.style.cssText = "position:fixed;left:-10000px;top:0;border:0;visibility:hidden;pointer-events:none;";
+      document.body.appendChild(iframe);
+      let doc = iframe.contentDocument ?? document;
+      return {
+        requiresExecutor: false,
+        async open(viewport) {
+          iframe.style.width = `${viewport.width}px`;
+          iframe.style.height = `${viewport.height}px`;
+          doc = iframe.contentDocument ?? document;
+        },
+        async setContent(html) {
+          doc = iframe.contentDocument ?? document;
+          doc.open();
+          doc.write(html);
+          doc.close();
+        },
+        async injectExecutor(_bundle) {
+        },
+        async evaluate(method, args) {
+          const fn = domExecutor[method];
+          const payload = args ?? [];
+          const target = EXECUTOR_TARGETS[method];
+          if (target === "window") return fn(iframe.contentWindow, ...payload);
+          if (target === "document") return fn(doc, ...payload);
+          return fn(...payload);
+        },
+        async close() {
+          iframe.remove();
+        }
+      };
+    }
+  };
+}
+
+// src/browser/browser-runtime.ts
+function createBrowserPrintRuntime() {
+  return createDomHostRuntime(createIframeDriverFactory());
+}
+
+// src/browser/browser-pagination.ts
+async function renderHtmlPages(template, printData, baseUrl, codeRenderer, options) {
+  const prepared = await prepareDocument(
+    {
+      templateJson: template,
+      printData,
+      baseUrl,
+      fontBaseUrl: options?.fontBaseUrl ?? "",
+      paperHeightMm: options?.paperHeightMm,
+      codeRenderer
+    },
+    createBrowserPrintRuntime()
+  );
+  return {
+    html: prepared.html,
+    pageCount: prepared.pageCount,
+    pageLayouts: prepared.pageLayouts,
+    paperMm: prepared.paperMm,
+    continuous: prepared.continuous,
+    copies: prepared.copies,
+    copyPaperMm: prepared.copyPaperMm
+  };
+}
 export {
+  EXECUTOR_VERSION,
+  applyTextFit,
   browserCodeRenderer,
-  renderHtmlPages
+  createBrowserPrintRuntime,
+  createIframeDriverFactory,
+  domExecutor,
+  fitTextNode,
+  readContentBottom,
+  readMeasurements,
+  renderCodes,
+  renderHtmlPages,
+  waitReady
 };

package/dist/{chunk-HLCZHPUF.js → chunk-AKWV6SID.js}

@@ -3,7 +3,7 @@ import {
   evaluate,
   parse,
   tokenize
-} from "./chunk-JZIVNXZ7.js";
+} from "./chunk-KFRPTLFV.js";
 
 // src/index.ts
 var TemplateEngine = class {