@worm-vue3-print/core 1.3.9 → 1.3.10

package/dist/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -76,7 +76,10 @@ __export(index_exports, {
   escapeInlineStyleValue: () => escapeInlineStyleValue,
   evaluate: () => evaluate,
   evaluateTemplate: () => evaluateTemplate,
+  filterFontOptions: () => filterFontOptions,
+  findFontOption: () => findFontOption,
   floorFontSize: () => floorFontSize,
+  fontOptionLabel: () => fontOptionLabel,
   formatDate: () => formatDate,
   formatMoney: () => formatMoney,
   formatTimestamp: () => formatTimestamp,
@@ -99,6 +102,8 @@ __export(index_exports, {
   mm: () => mm,
   mmToPx: () => mmToPx,
   multiplyNumbers: () => multiplyNumbers,
+  normalizeFontCatalog: () => normalizeFontCatalog,
+  normalizeFontQuery: () => normalizeFontQuery,
   normalizeMeasurements: () => normalizeMeasurements,
   normalizePrintData: () => normalizePrintData,
   normalizeTemplate: () => normalizeTemplate,
@@ -114,6 +119,7 @@ __export(index_exports, {
   renderTemplate: () => renderTemplate,
   renderWatermarkLayerHtml: () => renderWatermarkLayerHtml,
   renderWatermarkTileSvg: () => renderWatermarkTileSvg,
+  resolveCanvasFontFamily: () => resolveCanvasFontFamily,
   resolveCellTextFit: () => resolveCellTextFit,
   resolveElementTextFit: () => resolveElementTextFit,
   resolvePaperMm: () => resolvePaperMm,
@@ -1064,6 +1070,123 @@ function evaluateTemplate(text, ctx) {
   }
 }
 
+// src/render/flow-list.ts
+var FLOW_MIN_COLUMNS = 1;
+var FLOW_MAX_COLUMNS = 12;
+var FLOW_MIN_ROW_HEIGHT_MM = 3;
+var FLOW_MAX_ROW_HEIGHT_MM = 100;
+var FLOW_MIN_GAP_X_MM = 0;
+var FLOW_MAX_GAP_X_MM = 50;
+var PT_TO_MM = 25.4 / 72;
+function clampInt(value, min2, max2, fallback) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+  return Math.min(max2, Math.max(min2, Math.round(value)));
+}
+function resolveFlowColumns(value) {
+  return clampInt(value, FLOW_MIN_COLUMNS, FLOW_MAX_COLUMNS, 4);
+}
+function resolveFlowGapX(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return 4;
+  return Math.min(FLOW_MAX_GAP_X_MM, Math.max(FLOW_MIN_GAP_X_MM, value));
+}
+function resolveFlowRowHeight(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return 8;
+  return Math.min(FLOW_MAX_ROW_HEIGHT_MM, Math.max(FLOW_MIN_ROW_HEIGHT_MM, value));
+}
+function resolveFlowMaxSpan(value, columns) {
+  const cols = resolveFlowColumns(columns);
+  const fallback = Math.min(2, cols);
+  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+  return Math.min(cols, Math.max(1, Math.round(value)));
+}
+function flowColumnWidthMm(width, columns, gapX) {
+  const cols = resolveFlowColumns(columns);
+  const gap = resolveFlowGapX(gapX);
+  const avail = width - gap * (cols - 1);
+  if (avail <= 0) return 0;
+  return avail / cols;
+}
+function flowSpanWidthMm(colUnitMm, gapX, span) {
+  const k = Math.max(1, Math.floor(span));
+  return colUnitMm * k + gapX * (k - 1);
+}
+function estimateTextWidthMm(text, fontSizePt) {
+  if (!text) return 0;
+  const em = typeof fontSizePt === "number" && Number.isFinite(fontSizePt) && fontSizePt > 0 ? fontSizePt * PT_TO_MM : 12 * PT_TO_MM;
+  let units = 0;
+  for (const ch of text) {
+    if (ch === " ") {
+      units += 0.28;
+      continue;
+    }
+    const c = ch.codePointAt(0) ?? 0;
+    if (c >= 12288 && c <= 12351 || c >= 13312 && c <= 19903 || c >= 19968 && c <= 40959 || c >= 63744 && c <= 64255 || c >= 65280 && c <= 65376 || c >= 65504 && c <= 65510 || c >= 131072) units += 1;
+    else if (/^[0-9A-Z]$/.test(ch)) units += 0.6;
+    else if (/^[a-z]$/.test(ch)) units += 0.5;
+    else if (/^[\u0020-\u007f]$/.test(ch)) units += 0.4;
+    else units += 0.75;
+  }
+  return units * em;
+}
+function spanForText(text, cfg) {
+  if (!cfg.autoSpan) return 1;
+  const ceiling = resolveFlowMaxSpan(cfg.maxSpan, cfg.columns);
+  if (ceiling <= 1 || cfg.colUnitMm <= 0) return 1;
+  const need = estimateTextWidthMm(text, cfg.fontSizePt);
+  for (let k = 1; k <= ceiling; k++) {
+    if (need <= flowSpanWidthMm(cfg.colUnitMm, cfg.gapX, k)) return k;
+  }
+  return ceiling;
+}
+function layoutFlowList(items, cfg) {
+  const columns = resolveFlowColumns(cfg.columns);
+  const gapX = resolveFlowGapX(cfg.gapX);
+  const colUnitMm = flowColumnWidthMm(cfg.width, columns, gapX);
+  const maxSpan = resolveFlowMaxSpan(cfg.maxSpan, columns);
+  const rows = [];
+  let current = [];
+  let used = 0;
+  for (const raw of items) {
+    const text = String(raw ?? "");
+    const span = spanForText(text, { ...cfg, columns, gapX, maxSpan, colUnitMm });
+    if (current.length > 0 && used + span > columns) {
+      rows.push({ cells: current });
+      current = [];
+      used = 0;
+    }
+    current.push({ text, span });
+    used += span;
+  }
+  if (current.length > 0) rows.push({ cells: current });
+  return rows;
+}
+function detectFlowListKey(expr, data) {
+  if (typeof expr !== "string" || !expr.includes("{") || !data) return void 0;
+  const roots = /* @__PURE__ */ new Set();
+  for (const token of expr.matchAll(/\{([^{}]*)\}/g)) {
+    for (const piece of (token[1] ?? "").split(/[^A-Za-z0-9_\u4e00-\u9fa5.]/)) {
+      const root = piece.split(".")[0];
+      if (root && !/^\d/.test(root)) roots.add(root);
+    }
+  }
+  for (const root of roots) {
+    if (Array.isArray(data[root])) return root;
+  }
+  return void 0;
+}
+var mmNum = (v) => `${Math.round(v * 1e3) / 1e3}mm`;
+function flowGridStyle(cfg) {
+  const columns = resolveFlowColumns(cfg.columns);
+  const gapX = resolveFlowGapX(cfg.gapX);
+  const rowHeight = resolveFlowRowHeight(cfg.rowHeight);
+  return [
+    `display:grid`,
+    `grid-template-columns:repeat(${columns},minmax(0,1fr))`,
+    `column-gap:${mmNum(gapX)}`,
+    `grid-auto-rows:minmax(${mmNum(rowHeight)},auto)`
+  ].join(";");
+}
+
 // src/render/data-binder.ts
 function bindData(template, printData, baseUrl, fontBaseUrl) {
   const data = { ...resolveSystemVariables(), ...printData ?? {} };
@@ -1091,7 +1214,8 @@ function bindData(template, printData, baseUrl, fontBaseUrl) {
 }
 function bindElement(el, data, baseUrl) {
   const cloned = { ...el, options: { ...el.options } };
-  if (typeof cloned.options.formatter === "string") {
+  const isFlowList = cloned.type === "flowList" || cloned.printElementType?.type === "flowList";
+  if (!isFlowList && typeof cloned.options.formatter === "string") {
     const raw = cloned.options.formatter;
     if (referencesPageNumbers(raw)) {
       cloned.options.rawFormatter = raw;
@@ -1113,8 +1237,23 @@ function bindElement(el, data, baseUrl) {
   if (cloned.type === "table" || cloned.printElementType?.type === "table") {
     bindTableData(cloned, data);
   }
+  if (cloned.type === "flowList" || cloned.printElementType?.type === "flowList") {
+    bindFlowListData(cloned, data);
+  }
   return cloned;
 }
+function bindFlowListData(el, data) {
+  const template = typeof el.options.formatter === "string" ? el.options.formatter : "";
+  const source = { ...el.options, dataSource: el.options.dataSource ?? detectFlowListKey(template, data) };
+  const { list, key } = resolveListSource(source, data);
+  const itemCtx = (item) => key ? { ...data, ...item, [key]: item } : { ...data, ...item };
+  const items = list.map((item) => {
+    if (!template) return String(item ?? "");
+    return referencesPageNumbers(template) ? template : evaluateTemplate(template, itemCtx(item));
+  });
+  el.options._flowItems = items;
+  el.options._flowRawFormatter = referencesPageNumbers(template) ? template : void 0;
+}
 function resolveListSource(opts, data) {
   const explicitKey = opts.dataSource ?? opts.fields?.[0]?.dataSource ?? opts.fields?.[0]?.field;
   if (explicitKey && Array.isArray(data[explicitKey])) {
@@ -1190,6 +1329,12 @@ function makeRenderRow(row, resolve, keepRaw = false) {
       barcodeType: cell.barcodeType,
       qrCodeLevel: cell.qrCodeLevel,
       qrQuietZone: cell.qrQuietZone,
+      barQuietZone: cell.barQuietZone,
+      // 条高同样必须进白名单：漏一个，属性台填的 mm 就只在设计器生效、出纸静默按缺省 30 模块
+      barHeight: cell.barHeight,
+      // 条宽与条码文本字号也必须在白名单里：漏一个，属性台填的倍率就只在设计器生效、出纸静默按缺省
+      barWidth: cell.barWidth,
+      barFontSize: cell.barFontSize,
       showBarcodeText: cell.showBarcodeText,
       printerDpi: cell.printerDpi,
       fit: cell.fit,
@@ -1306,6 +1451,57 @@ function toFontFamilyStack(family) {
   const head = name.includes(",") ? name : `"${name.replace(/"/g, "")}"`;
   return [head, ...FALLBACK_FONT_STACK].join(", ");
 }
+function resolveCanvasFontFamily(family) {
+  return family ? toFontFamilyStack(family) : "inherit";
+}
+function normalizeFontCatalog(host) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const font of host ?? []) {
+    const family = font?.family?.trim();
+    if (!family) continue;
+    const key = family.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    const label = font?.label?.trim();
+    out.push(label ? { family, label } : { family });
+  }
+  return out;
+}
+function findFontOption(fonts, family) {
+  const key = family?.trim().toLowerCase();
+  if (!key) return void 0;
+  return fonts.find((f) => f.family.trim().toLowerCase() === key);
+}
+function fontOptionLabel(option) {
+  return option.label ? `${option.label}\uFF08${option.family}\uFF09` : option.family;
+}
+function normalizeFontQuery(value) {
+  return value.toLowerCase().replace(/\s+/g, "");
+}
+function matchRank(nameKey, queryKey) {
+  if (nameKey === queryKey) return 0;
+  if (nameKey.startsWith(queryKey)) return 1;
+  if (nameKey.includes(queryKey)) return 2;
+  let cursor = 0;
+  for (const char of nameKey) {
+    if (char === queryKey[cursor]) cursor++;
+    if (cursor === queryKey.length) return 3;
+  }
+  return -1;
+}
+function fontMatchRank(font, queryKey) {
+  const byFamily = matchRank(normalizeFontQuery(font.family), queryKey);
+  if (!font.label) return byFamily;
+  const byLabel = matchRank(normalizeFontQuery(font.label), queryKey);
+  if (byFamily < 0) return byLabel;
+  return byLabel < 0 ? byFamily : Math.min(byFamily, byLabel);
+}
+function filterFontOptions(fonts, query) {
+  const queryKey = normalizeFontQuery(query.trim());
+  if (!queryKey) return [...fonts];
+  return fonts.map((font, index) => ({ font, index, rank: fontMatchRank(font, queryKey) })).filter((item) => item.rank >= 0).sort((a, b) => a.rank - b.rank || a.index - b.index).map((item) => item.font);
+}
 
 // src/render/types.ts
 var PAPER_DIMENSIONS = {
@@ -1440,7 +1636,8 @@ function elementBlock() {
 .print-table td {
   border: 1px solid #ccc;
   padding: 2mm 3mm;
-  word-break: break-all;
+  word-break: normal;
+  overflow-wrap: break-word;
   overflow: hidden;
 }
 .print-table thead th {
@@ -1672,7 +1869,9 @@ function normalizeFit(value) {
 }
 var ELEMENT_DEFAULT_FIT = {
   text: "clip",
-  longText: "autoHeight"
+  longText: "autoHeight",
+  // 流式列表一框一页：超出元素框高的单元按截断处理，不自动撑破纸面（specs 第八节第 8 项）
+  flowList: "clip"
 };
 function resolveElementTextFit(type, opts) {
   return normalizeFit(opts?.textFit) ?? ELEMENT_DEFAULT_FIT[type] ?? "clip";
@@ -1734,6 +1933,7 @@ var SELF_BORDER_TYPES = /* @__PURE__ */ new Set(["rect", "oval", "hline", "vline
 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;
+  if (style === "none") return null;
   return {
     borderWidth: `${width}pt`,
     borderStyle: typeof style === "string" && VALID_STYLES.has(style) ? style : "solid",
@@ -2690,6 +2890,27 @@ function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
       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)}${indentStyle(opts)}${elementFitStyle(fit, opts)}"${measureAttr}${fitAttr}>${esc(opts.formatter ?? opts.testData ?? "")}</div>`;
+    case "flowList": {
+      const columns = resolveFlowColumns(opts.flowColumns);
+      const gapX = resolveFlowGapX(opts.flowGapX);
+      const rowHeight = resolveFlowRowHeight(opts.flowRowHeight);
+      const maxSpan = resolveFlowMaxSpan(opts.flowMaxSpan, columns);
+      const boundItems = Array.isArray(opts._flowItems) ? opts._flowItems : void 0;
+      const items = boundItems && boundItems.length > 0 ? boundItems : String(opts.testData ?? "").split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
+      const cfg = {
+        width,
+        columns,
+        gapX,
+        rowHeight,
+        maxSpan,
+        fontSizePt: opts.fontSize ?? 12,
+        autoSpan: opts.flowAutoSpan === true
+      };
+      const cells = layoutFlowList(items, cfg).flatMap((row) => row.cells).map((c) => `<div class="print-flow-cell"${c.span > 1 ? ` style="grid-column:span ${c.span};"` : ""}>${esc(c.text)}</div>`).join("\n  ");
+      return `<div class="print-element" style="${style}${textStyle(opts)}overflow:hidden;${flowGridStyle(cfg)};"${measureAttr}${fitAttr}>
+  ${cells}
+</div>`;
+    }
     case "html":
       return `<div class="print-element" style="${style}"${measureAttr}>${opts.testData ?? opts.title ?? ""}</div>`;
     default:
@@ -2706,9 +2927,13 @@ function codeImgHtml(value, cellType, opts, io) {
       qrCodeLevel: opts.qrCodeLevel != null ? String(opts.qrCodeLevel) : void 0,
       // 0 是合法档（无白边），必须用 typeof 判定而非 or/?? 之类假值判断
       qrQuietZone: typeof opts.qrQuietZone === "number" ? opts.qrQuietZone : void 0,
+      barQuietZone: typeof opts.barQuietZone === "number" ? opts.barQuietZone : void 0,
+      // 条高（mm）：元素台与单元格台都写 barHeight，非法/未填交由布局函数回退缺省档
+      barHeightMm: typeof opts.barHeight === "number" ? opts.barHeight : void 0,
       showText: opts.hideTitle !== void 0 ? !opts.hideTitle : opts.showBarcodeText,
       barWidth: typeof opts.barWidth === "number" ? opts.barWidth : void 0,
-      fontSize: typeof opts.fontSize === "number" ? opts.fontSize : void 0,
+      // 元素台的条码文本字号是 fontSize；单元格台的文本字号是 barFontSize（单元格的 fontSize 是正文字号，不该拿来决定条码）
+      fontSize: typeof (opts.barFontSize ?? opts.fontSize) === "number" ? opts.barFontSize ?? opts.fontSize : void 0,
       printerDpi: isBarcode ? io.printerDpi : void 0,
       targetWidthMm: isBarcode ? barcodeAvailableBoxMm(io.targetWidthMm, maxWidth) : void 0,
       targetHeightMm: isBarcode ? barcodeAvailableBoxMm(io.targetHeightMm, maxHeight) : void 0
@@ -2739,8 +2964,9 @@ function matrixCellStyle(cell, opts) {
   const fontSize = cell.fittedFontSize ?? cell.fontSize ?? opts.tableDefaultFontSize;
   const color = cell.color ?? opts.tableDefaultColor;
   const padding = cell.padding ?? opts.tableDefaultPadding ?? 1;
+  const fontFamily = cell.fontFamily ?? opts.tableDefaultFontFamily;
   if (fontSize) parts.push(`font-size:${fontSize}pt`);
-  if (cell.fontFamily) parts.push(`font-family:${escapeInlineStyleValue(toFontFamilyStack(cell.fontFamily))}`);
+  if (fontFamily) parts.push(`font-family:${escapeInlineStyleValue(toFontFamilyStack(fontFamily))}`);
   if (cell.fontWeight) parts.push(`font-weight:${cell.fontWeight}`);
   if (color) parts.push(`color:${color}`);
   if (cell.backgroundColor) parts.push(`background-color:${cell.backgroundColor}`);
@@ -2748,7 +2974,7 @@ function matrixCellStyle(cell, opts) {
   if (cell.align === "justify") parts.push("text-align-last:justify");
   parts.push(`vertical-align:${cell.valign ?? "middle"}`);
   parts.push(`padding:${padding}mm`);
-  parts.push(cell.wordWrap === false ? "white-space:nowrap;overflow:hidden" : "word-break:break-all");
+  parts.push(cell.wordWrap === false ? "white-space:nowrap;overflow:hidden" : "white-space:pre-wrap;word-break:normal;overflow-wrap:break-word");
   const b = cell.borders ?? {};
   for (const side of ["top", "right", "bottom", "left"]) {
     const border = b[side];
@@ -3132,7 +3358,9 @@ function codeSpecKey(value, cellType, opts = {}) {
     opts.showText ?? null,
     opts.barWidth ?? null,
     opts.fontSize ?? null,
-    opts.qrQuietZone ?? null
+    opts.qrQuietZone ?? null,
+    opts.barQuietZone ?? null,
+    opts.barHeightMm ?? null
   ]);
 }
 function createMapCodeRenderer(map) {
@@ -3914,7 +4142,10 @@ var TemplateEngine = class {
   escapeInlineStyleValue,
   evaluate,
   evaluateTemplate,
+  filterFontOptions,
+  findFontOption,
   floorFontSize,
+  fontOptionLabel,
   formatDate,
   formatMoney,
   formatTimestamp,
@@ -3937,6 +4168,8 @@ var TemplateEngine = class {
   mm,
   mmToPx,
   multiplyNumbers,
+  normalizeFontCatalog,
+  normalizeFontQuery,
   normalizeMeasurements,
   normalizePrintData,
   normalizeTemplate,
@@ -3952,6 +4185,7 @@ var TemplateEngine = class {
   renderTemplate,
   renderWatermarkLayerHtml,
   renderWatermarkTileSvg,
+  resolveCanvasFontFamily,
   resolveCellTextFit,
   resolveElementTextFit,
   resolvePaperMm,

package/dist/index.d.cts

@@ -1,13 +1,13 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
-import { T as TemplateData, C as CodeRenderer, P as PageLayout, J as MeasuredElement, K as TemplateElement, W as WatermarkOptions, L as PaperMm, N as ViewportPx, O as HeightSource, Q as MarginsMm, S as PdfTargetSpec, R as RawMeasurement, a as CodeSpec, X as CodeRenderOptions, D as DriverFactory, Y as ExecutorBundle, Z as TileLayout, _ as PrintJob, $ as PreparedDocument, a0 as RenderPdfResult, M as MultiPageTemplateData, a1 as PrintFontDeclaration } from './driver-hJxBl2_n.cjs';
-export { a2 as ContinuousPaperSize, a3 as EXECUTOR_TARGETS, a4 as ExecutorMethod, a5 as ExecutorTargetKind, a6 as FALLBACK_FONT_STACK, a7 as MAX_BATCH_COPIES, a8 as NormalizedPrintData, a9 as PAPER_DIMENSIONS, aa as PageDriver, ab as PageSection, ac as PaperSize, ad as PrintDataInput, ae as PrintFontFile, af as RenderCell, ag as RenderRequest, ah as RenderRow, ai as SheetPaperSize, aj as TILE_DEFAULTS, H as TextFit, ak as TilingError, al as TilingIssue, am as TilingIssueCode, an as TilingOptions, ao as TilingResolveOptions, ap as TilingTemplateInput, aq as buildFontFaceCss, ar as computeMaxColumns, as as computeTileLayout, at as escapeInlineStyleValue, au as getPaperDimensions, av as isContinuousPaper, aw as isContinuousPaperSize, ax as normalizePrintData, ay as normalizeTilingOptions, az as resolveSheetMm, aA as roundMm, aB as tilePosition, aC as toFontFamilyStack, aD as validateTiling } from './driver-hJxBl2_n.cjs';
-import { F as FitFontSize, P as PrintRuntime } from './ports-B-Jb2XwT.cjs';
-export { C as CellFitRowKind, i as DEFAULT_READINESS_MS, D as DEFAULT_SHRINK_MIN_FONT_SIZE_PT, j as DEFAULT_TIMEOUT_MS, M as MIN_SHRINK_FONT_SIZE_PT, k as MeasureResult, l as PrintSession, S as SessionBudget, c as cellFitCapMm, a as cellFitKey, f as floorFontSize, p as parseCellFitKey, r as resolveCellTextFit, e as resolveElementTextFit, g as resolveShrinkMinFontSize, h as roundFontSize } from './ports-B-Jb2XwT.cjs';
+import { T as TemplateData, C as CodeRenderer, P as PageLayout, J as MeasuredElement, K as TemplateElement, W as WatermarkOptions, L as PaperMm, N as ViewportPx, O as HeightSource, Q as MarginsMm, S as PdfTargetSpec, R as RawMeasurement, a as CodeSpec, X as CodeRenderOptions, D as DriverFactory, Y as ExecutorBundle, Z as TileLayout, _ as PrintJob, $ as PreparedDocument, a0 as RenderPdfResult, M as MultiPageTemplateData, a1 as PrintFontDeclaration } from './driver-DW3mxuRF.cjs';
+export { a2 as ContinuousPaperSize, a3 as EXECUTOR_TARGETS, a4 as ExecutorMethod, a5 as ExecutorTargetKind, a6 as FALLBACK_FONT_STACK, a7 as FontCatalogOption, a8 as MAX_BATCH_COPIES, a9 as NormalizedPrintData, aa as PAPER_DIMENSIONS, ab as PageDriver, ac as PageSection, ad as PaperSize, ae as PrintDataInput, af as PrintFontFile, ag as RenderCell, ah as RenderRequest, ai as RenderRow, aj as SheetPaperSize, ak as TILE_DEFAULTS, H as TextFit, al as TilingError, am as TilingIssue, an as TilingIssueCode, ao as TilingOptions, ap as TilingResolveOptions, aq as TilingTemplateInput, ar as buildFontFaceCss, as as computeMaxColumns, at as computeTileLayout, au as escapeInlineStyleValue, av as filterFontOptions, aw as findFontOption, ax as fontOptionLabel, ay as getPaperDimensions, az as isContinuousPaper, aA as isContinuousPaperSize, aB as normalizeFontCatalog, aC as normalizeFontQuery, aD as normalizePrintData, aE as normalizeTilingOptions, aF as resolveCanvasFontFamily, aG as resolveSheetMm, aH as roundMm, aI as tilePosition, aJ as toFontFamilyStack, aK as validateTiling } from './driver-DW3mxuRF.cjs';
+import { F as FitFontSize, P as PrintRuntime } from './ports-DJ7_blE7.cjs';
+export { C as CellFitRowKind, i as DEFAULT_READINESS_MS, D as DEFAULT_SHRINK_MIN_FONT_SIZE_PT, j as DEFAULT_TIMEOUT_MS, M as MIN_SHRINK_FONT_SIZE_PT, k as MeasureResult, l as PrintSession, S as SessionBudget, c as cellFitCapMm, a as cellFitKey, f as floorFontSize, p as parseCellFitKey, r as resolveCellTextFit, e as resolveElementTextFit, g as resolveShrinkMinFontSize, h as roundFontSize } from './ports-DJ7_blE7.cjs';
 
 type TokenType = 'num' | 'str' | 'bool' | 'ident' | 'punc';
 interface Token {

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
-import { T as TemplateData, C as CodeRenderer, P as PageLayout, J as MeasuredElement, K as TemplateElement, W as WatermarkOptions, L as PaperMm, N as ViewportPx, O as HeightSource, Q as MarginsMm, S as PdfTargetSpec, R as RawMeasurement, a as CodeSpec, X as CodeRenderOptions, D as DriverFactory, Y as ExecutorBundle, Z as TileLayout, _ as PrintJob, $ as PreparedDocument, a0 as RenderPdfResult, M as MultiPageTemplateData, a1 as PrintFontDeclaration } from './driver-hJxBl2_n.js';
-export { a2 as ContinuousPaperSize, a3 as EXECUTOR_TARGETS, a4 as ExecutorMethod, a5 as ExecutorTargetKind, a6 as FALLBACK_FONT_STACK, a7 as MAX_BATCH_COPIES, a8 as NormalizedPrintData, a9 as PAPER_DIMENSIONS, aa as PageDriver, ab as PageSection, ac as PaperSize, ad as PrintDataInput, ae as PrintFontFile, af as RenderCell, ag as RenderRequest, ah as RenderRow, ai as SheetPaperSize, aj as TILE_DEFAULTS, H as TextFit, ak as TilingError, al as TilingIssue, am as TilingIssueCode, an as TilingOptions, ao as TilingResolveOptions, ap as TilingTemplateInput, aq as buildFontFaceCss, ar as computeMaxColumns, as as computeTileLayout, at as escapeInlineStyleValue, au as getPaperDimensions, av as isContinuousPaper, aw as isContinuousPaperSize, ax as normalizePrintData, ay as normalizeTilingOptions, az as resolveSheetMm, aA as roundMm, aB as tilePosition, aC as toFontFamilyStack, aD as validateTiling } from './driver-hJxBl2_n.js';
-import { F as FitFontSize, P as PrintRuntime } from './ports-CJ0SUYFt.js';
-export { C as CellFitRowKind, i as DEFAULT_READINESS_MS, D as DEFAULT_SHRINK_MIN_FONT_SIZE_PT, j as DEFAULT_TIMEOUT_MS, M as MIN_SHRINK_FONT_SIZE_PT, k as MeasureResult, l as PrintSession, S as SessionBudget, c as cellFitCapMm, a as cellFitKey, f as floorFontSize, p as parseCellFitKey, r as resolveCellTextFit, e as resolveElementTextFit, g as resolveShrinkMinFontSize, h as roundFontSize } from './ports-CJ0SUYFt.js';
+import { T as TemplateData, C as CodeRenderer, P as PageLayout, J as MeasuredElement, K as TemplateElement, W as WatermarkOptions, L as PaperMm, N as ViewportPx, O as HeightSource, Q as MarginsMm, S as PdfTargetSpec, R as RawMeasurement, a as CodeSpec, X as CodeRenderOptions, D as DriverFactory, Y as ExecutorBundle, Z as TileLayout, _ as PrintJob, $ as PreparedDocument, a0 as RenderPdfResult, M as MultiPageTemplateData, a1 as PrintFontDeclaration } from './driver-DW3mxuRF.js';
+export { a2 as ContinuousPaperSize, a3 as EXECUTOR_TARGETS, a4 as ExecutorMethod, a5 as ExecutorTargetKind, a6 as FALLBACK_FONT_STACK, a7 as FontCatalogOption, a8 as MAX_BATCH_COPIES, a9 as NormalizedPrintData, aa as PAPER_DIMENSIONS, ab as PageDriver, ac as PageSection, ad as PaperSize, ae as PrintDataInput, af as PrintFontFile, ag as RenderCell, ah as RenderRequest, ai as RenderRow, aj as SheetPaperSize, ak as TILE_DEFAULTS, H as TextFit, al as TilingError, am as TilingIssue, an as TilingIssueCode, ao as TilingOptions, ap as TilingResolveOptions, aq as TilingTemplateInput, ar as buildFontFaceCss, as as computeMaxColumns, at as computeTileLayout, au as escapeInlineStyleValue, av as filterFontOptions, aw as findFontOption, ax as fontOptionLabel, ay as getPaperDimensions, az as isContinuousPaper, aA as isContinuousPaperSize, aB as normalizeFontCatalog, aC as normalizeFontQuery, aD as normalizePrintData, aE as normalizeTilingOptions, aF as resolveCanvasFontFamily, aG as resolveSheetMm, aH as roundMm, aI as tilePosition, aJ as toFontFamilyStack, aK as validateTiling } from './driver-DW3mxuRF.js';
+import { F as FitFontSize, P as PrintRuntime } from './ports-Brn5xcLD.js';
+export { C as CellFitRowKind, i as DEFAULT_READINESS_MS, D as DEFAULT_SHRINK_MIN_FONT_SIZE_PT, j as DEFAULT_TIMEOUT_MS, M as MIN_SHRINK_FONT_SIZE_PT, k as MeasureResult, l as PrintSession, S as SessionBudget, c as cellFitCapMm, a as cellFitKey, f as floorFontSize, p as parseCellFitKey, r as resolveCellTextFit, e as resolveElementTextFit, g as resolveShrinkMinFontSize, h as roundFontSize } from './ports-Brn5xcLD.js';
 
 type TokenType = 'num' | 'str' | 'bool' | 'ident' | 'punc';
 interface Token {

package/dist/index.js

@@ -1,12 +1,12 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
 import {
   TemplateEngine
-} from "./chunk-QBFZ25CV.js";
+} from "./chunk-4ZEP2HSH.js";
 import {
   DEFAULT_READINESS_MS,
   DEFAULT_SHRINK_MIN_FONT_SIZE_PT,
@@ -57,7 +57,10 @@ import {
   escapeInlineStyleValue,
   evaluate,
   evaluateTemplate,
+  filterFontOptions,
+  findFontOption,
   floorFontSize,
+  fontOptionLabel,
   formatDate,
   formatMoney,
   formatTimestamp,
@@ -80,6 +83,8 @@ import {
   mm,
   mmToPx2 as mmToPx,
   multiplyNumbers,
+  normalizeFontCatalog,
+  normalizeFontQuery,
   normalizeMeasurements,
   normalizePrintData,
   normalizeTemplate,
@@ -95,6 +100,7 @@ import {
   renderTemplate,
   renderWatermarkLayerHtml,
   renderWatermarkTileSvg,
+  resolveCanvasFontFamily,
   resolveCellTextFit,
   resolveElementTextFit,
   resolvePaperMm,
@@ -125,7 +131,7 @@ import {
   tokenize,
   validateTiling,
   withTimeout
-} from "./chunk-BRGDUOUB.js";
+} from "./chunk-7FXIWNYK.js";
 export {
   DEFAULT_READINESS_MS,
   DEFAULT_SHRINK_MIN_FONT_SIZE_PT,
@@ -177,7 +183,10 @@ export {
   escapeInlineStyleValue,
   evaluate,
   evaluateTemplate,
+  filterFontOptions,
+  findFontOption,
   floorFontSize,
+  fontOptionLabel,
   formatDate,
   formatMoney,
   formatTimestamp,
@@ -200,6 +209,8 @@ export {
   mm,
   mmToPx,
   multiplyNumbers,
+  normalizeFontCatalog,
+  normalizeFontQuery,
   normalizeMeasurements,
   normalizePrintData,
   normalizeTemplate,
@@ -215,6 +226,7 @@ export {
   renderTemplate,
   renderWatermarkLayerHtml,
   renderWatermarkTileSvg,
+  resolveCanvasFontFamily,
   resolveCellTextFit,
   resolveElementTextFit,
   resolvePaperMm,

package/dist/node/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/node/index.d.cts

@@ -1,10 +1,10 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
-import { Y as ExecutorBundle } from '../driver-hJxBl2_n.cjs';
+import { Y as ExecutorBundle } from '../driver-DW3mxuRF.cjs';
 
 /** 读取 core 自带的 DOM 执行器 IIFE 产物；宿主把它注入页面后即可调用 __wormDom */
 declare function loadExecutorBundle(): ExecutorBundle;

package/dist/node/index.d.ts

@@ -1,10 +1,10 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
-import { Y as ExecutorBundle } from '../driver-hJxBl2_n.js';
+import { Y as ExecutorBundle } from '../driver-DW3mxuRF.js';
 
 /** 读取 core 自带的 DOM 执行器 IIFE 产物；宿主把它注入页面后即可调用 __wormDom */
 declare function loadExecutorBundle(): ExecutorBundle;

package/dist/node/index.js

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/{ports-B-Jb2XwT.d.cts → ports-Brn5xcLD.d.ts}

@@ -1,10 +1,10 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
-import { H as TextFit, a as CodeSpec, N as ViewportPx, R as RawMeasurement, S as PdfTargetSpec } from './driver-hJxBl2_n.cjs';
+import { H as TextFit, a as CodeSpec, N as ViewportPx, R as RawMeasurement, S as PdfTargetSpec } from './driver-DW3mxuRF.js';
 
 /** 自动缩小的默认下限字号（pt） */
 declare const DEFAULT_SHRINK_MIN_FONT_SIZE_PT = 6;

package/dist/{ports-CJ0SUYFt.d.ts → ports-DJ7_blE7.d.cts}

@@ -1,10 +1,10 @@
 /*!
- * @worm-vue3-print/core v1.3.9
+ * @worm-vue3-print/core v1.3.10
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
-import { H as TextFit, a as CodeSpec, N as ViewportPx, R as RawMeasurement, S as PdfTargetSpec } from './driver-hJxBl2_n.js';
+import { H as TextFit, a as CodeSpec, N as ViewportPx, R as RawMeasurement, S as PdfTargetSpec } from './driver-DW3mxuRF.cjs';
 
 /** 自动缩小的默认下限字号（pt） */
 declare const DEFAULT_SHRINK_MIN_FONT_SIZE_PT = 6;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worm-vue3-print/core",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "type": "module",
   "description": "打印模板表达式引擎、同构渲染管线与框架无关的设计器内核（HTML 生成/分页/数据绑定/设计器模型与工具），无 Vue/React 依赖",
   "main": "dist/index.cjs",