@worm-vue3-print/core 1.3.6 → 1.3.7

package/dist/browser/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.7
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -292,6 +292,10 @@ function renderBarcodeSvg(value, opts) {
   svg.setAttribute("shape-rendering", "crispEdges");
   return svg.outerHTML;
 }
+var QR_DEFAULT_QUIET_MODULES = 0;
+function qrQuietModules(value) {
+  return typeof value === "number" && Number.isFinite(value) ? Math.max(0, Math.floor(value)) : QR_DEFAULT_QUIET_MODULES;
+}
 function renderQrSvg(value, opts) {
   const level = (opts.qrCodeLevel ?? "M").toUpperCase();
   const qr = import_qrcode.default.create(value, {
@@ -300,7 +304,7 @@ function renderQrSvg(value, opts) {
   const modules = qr.modules;
   const size = modules.size;
   const dot = 4;
-  const quiet = 4 * dot;
+  const quiet = qrQuietModules(opts.qrQuietZone) * dot;
   const dim = size * dot + quiet * 2;
   let rects = "";
   for (let y = 0; y < size; y++) {
@@ -1621,9 +1625,11 @@ function makeRenderRow(row, resolve, keepRaw = false) {
       cellType: cell.cellType,
       barcodeType: cell.barcodeType,
       qrCodeLevel: cell.qrCodeLevel,
+      qrQuietZone: cell.qrQuietZone,
       showBarcodeText: cell.showBarcodeText,
       printerDpi: cell.printerDpi,
       fit: cell.fit,
+      objectPosition: cell.objectPosition,
       maxWidth: cell.maxWidth,
       maxHeight: cell.maxHeight,
       rowspan: cell.rowspan ?? 1,
@@ -2890,12 +2896,26 @@ function textStyle(opts) {
   if (opts.lineHeight) parts.push(`line-height:${opts.lineHeight}pt`);
   if (opts.letterSpacing) parts.push(`letter-spacing:${opts.letterSpacing}pt`);
   if (opts.verticalAlign) {
-    parts.push(`display:flex;align-items:${V_ALIGN_FLEX[opts.verticalAlign] ?? "flex-start"}`);
-    parts.push(`justify-content:${H_ALIGN_FLEX[opts.textAlign ?? "left"] ?? "flex-start"}`);
+    if (opts.textAlign === "justify") {
+      parts.push(`display:flex;flex-direction:column;justify-content:${V_ALIGN_FLEX[opts.verticalAlign] ?? "flex-start"}`);
+    } else {
+      parts.push(`display:flex;align-items:${V_ALIGN_FLEX[opts.verticalAlign] ?? "flex-start"}`);
+      parts.push(`justify-content:${H_ALIGN_FLEX[opts.textAlign ?? "left"] ?? "flex-start"}`);
+    }
   }
   if (opts.textAlign) parts.push(`text-align:${opts.textAlign}`);
+  if (opts.textAlign === "justify") parts.push("text-align-last:justify");
   return parts.length ? parts.join(";") + ";" : "";
 }
+function indentStyle(opts) {
+  return opts.longTextIndent ? `text-indent:${opts.longTextIndent}em;` : "";
+}
+var OBJECT_POSITION_UNSAFE = /[;"'<>\\(){}\[\]@!#]/;
+function positionStyle(objectPosition) {
+  const v = (objectPosition ?? "").trim();
+  if (!v || v.length > 64 || OBJECT_POSITION_UNSAFE.test(v)) return "";
+  return `object-position:${escapeInlineStyleValue(v)};`;
+}
 function elementFitStyle(fit, opts) {
   if (fit === "autoHeight") return "overflow:visible;";
   if (opts.wordWrap === false) return "white-space:nowrap;text-overflow:ellipsis;";
@@ -2934,7 +2954,7 @@ function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
       return renderTableElement(el, isMeasure, measureAttr, ctx);
     case "image":
       return `<div class="print-element" style="${style}"${measureAttr}>
-  <img src="${esc(opts.src ?? "")}" style="width:100%;height:100%;object-fit:contain;" />
+  <img src="${esc(opts.src ?? "")}" style="width:100%;height:100%;object-fit:${opts.fit || "contain"};${positionStyle(opts.objectPosition)}" />
 </div>`;
     case "barcode":
     case "qrcode": {
@@ -2961,7 +2981,7 @@ function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
     case "oval":
       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>`;
+      return `<div class="print-element" style="${style}${textStyle(opts)}${indentStyle(opts)}${elementFitStyle(fit, opts)}"${measureAttr}${fitAttr}>${esc(opts.formatter ?? opts.testData ?? "")}</div>`;
     case "html":
       return `<div class="print-element" style="${style}"${measureAttr}>${opts.testData ?? opts.title ?? ""}</div>`;
     default:
@@ -2976,6 +2996,8 @@ function codeImgHtml(value, cellType, opts, io) {
     const svg = codeRenderer.render(value, cellType, {
       barcodeType: opts.barcodeType,
       qrCodeLevel: opts.qrCodeLevel != null ? String(opts.qrCodeLevel) : void 0,
+      // 0 是合法档（无白边），必须用 typeof 判定而非 or/?? 之类假值判断
+      qrQuietZone: typeof opts.qrQuietZone === "number" ? opts.qrQuietZone : 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,
@@ -2986,10 +3008,8 @@ function codeImgHtml(value, cellType, opts, io) {
     if (isBarcode && /^<svg[\s>]/i.test(svg)) return inlineCodeSvgHtml(svg);
     const src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
     const styleParts = [];
-    styleParts.push("max-width:100%", "max-height:100%", "display:block", "margin:auto");
-    if (fit) {
-      styleParts.push(`object-fit:${fit}`);
-    }
+    styleParts.push("width:100%", "height:100%", "max-width:100%", "max-height:100%", "display:block", "margin:auto");
+    styleParts.push(`object-fit:${fit || "contain"}`);
     if (maxWidth) {
       styleParts.push(`max-width:${maxWidth}mm`);
     }
@@ -3017,6 +3037,7 @@ function matrixCellStyle(cell, opts) {
   if (color) parts.push(`color:${color}`);
   if (cell.backgroundColor) parts.push(`background-color:${cell.backgroundColor}`);
   parts.push(`text-align:${cell.align ?? "left"}`);
+  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");
@@ -3056,7 +3077,7 @@ function renderMatrixRows(renderRows, start, end, opts, withRowIndex, ctx, fitOw
         const fit = cell.fit || "contain";
         const maxWidth = cell.maxWidth ? `max-width:${cell.maxWidth}mm;` : "max-width:100%;";
         const maxHeight = cell.maxHeight ? `max-height:${cell.maxHeight}mm;` : "max-height:100%;";
-        inner = `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;"><img src="${esc(resolveCellContent(cell, ctx))}" style="object-fit:${fit};${maxWidth}${maxHeight}display:block;" /></div>`;
+        inner = `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;"><img src="${esc(resolveCellContent(cell, ctx))}" style="object-fit:${fit};${positionStyle(cell.objectPosition)}${maxWidth}${maxHeight}display:block;" /></div>`;
       } else {
         inner = renderTextCellInner(renderRows, r, colIndex, cell, opts, fitOwner, defaultPadding, ctx);
       }
@@ -3245,7 +3266,8 @@ function codeSpecKey(value, cellType, opts = {}) {
     opts.qrCodeLevel ?? null,
     opts.showText ?? null,
     opts.barWidth ?? null,
-    opts.fontSize ?? null
+    opts.fontSize ?? null,
+    opts.qrQuietZone ?? null
   ]);
 }
 function createMapCodeRenderer(map) {

package/dist/browser/index.d.cts

@@ -1,11 +1,11 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.7
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * 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';
+import { P as PageLayout, T as TemplateData, M as MultiPageTemplateData, C as CodeRenderer, D as DriverFactory, R as RawMeasurement, a as CodeSpec } from '../driver-Dzr2Aikx.cjs';
+import { P as PrintRuntime, F as FitFontSize } from '../ports-Bin4xmo0.cjs';
 
 interface BrowserRenderResult {
     /** 最终多页 HTML 字符串 */

package/dist/browser/index.d.ts

@@ -1,11 +1,11 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.7
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * 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';
+import { P as PageLayout, T as TemplateData, M as MultiPageTemplateData, C as CodeRenderer, D as DriverFactory, R as RawMeasurement, a as CodeSpec } from '../driver-Dzr2Aikx.js';
+import { P as PrintRuntime, F as FitFontSize } from '../ports-B8MFq_Yo.js';
 
 interface BrowserRenderResult {
     /** 最终多页 HTML 字符串 */

package/dist/browser/index.js

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.7
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -17,7 +17,7 @@ import {
   prepareDocument,
   resolveBarcodeSize,
   resolveShrinkMinFontSize
-} from "../chunk-JQUJ7AF3.js";
+} from "../chunk-TCI5XQKI.js";
 
 // src/browser/browser-code-renderer.ts
 import JsBarcode from "jsbarcode";
@@ -62,6 +62,10 @@ function renderBarcodeSvg(value, opts) {
   svg.setAttribute("shape-rendering", "crispEdges");
   return svg.outerHTML;
 }
+var QR_DEFAULT_QUIET_MODULES = 0;
+function qrQuietModules(value) {
+  return typeof value === "number" && Number.isFinite(value) ? Math.max(0, Math.floor(value)) : QR_DEFAULT_QUIET_MODULES;
+}
 function renderQrSvg(value, opts) {
   const level = (opts.qrCodeLevel ?? "M").toUpperCase();
   const qr = QRCode.create(value, {
@@ -70,7 +74,7 @@ function renderQrSvg(value, opts) {
   const modules = qr.modules;
   const size = modules.size;
   const dot = 4;
-  const quiet = 4 * dot;
+  const quiet = qrQuietModules(opts.qrQuietZone) * dot;
   const dim = size * dot + quiet * 2;
   let rects = "";
   for (let y = 0; y < size; y++) {

package/dist/{chunk-JQUJ7AF3.js → chunk-TCI5XQKI.js}

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.7
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -1047,9 +1047,11 @@ function makeRenderRow(row, resolve, keepRaw = false) {
       cellType: cell.cellType,
       barcodeType: cell.barcodeType,
       qrCodeLevel: cell.qrCodeLevel,
+      qrQuietZone: cell.qrQuietZone,
       showBarcodeText: cell.showBarcodeText,
       printerDpi: cell.printerDpi,
       fit: cell.fit,
+      objectPosition: cell.objectPosition,
       maxWidth: cell.maxWidth,
       maxHeight: cell.maxHeight,
       rowspan: cell.rowspan ?? 1,
@@ -2451,12 +2453,26 @@ function textStyle(opts) {
   if (opts.lineHeight) parts.push(`line-height:${opts.lineHeight}pt`);
   if (opts.letterSpacing) parts.push(`letter-spacing:${opts.letterSpacing}pt`);
   if (opts.verticalAlign) {
-    parts.push(`display:flex;align-items:${V_ALIGN_FLEX[opts.verticalAlign] ?? "flex-start"}`);
-    parts.push(`justify-content:${H_ALIGN_FLEX[opts.textAlign ?? "left"] ?? "flex-start"}`);
+    if (opts.textAlign === "justify") {
+      parts.push(`display:flex;flex-direction:column;justify-content:${V_ALIGN_FLEX[opts.verticalAlign] ?? "flex-start"}`);
+    } else {
+      parts.push(`display:flex;align-items:${V_ALIGN_FLEX[opts.verticalAlign] ?? "flex-start"}`);
+      parts.push(`justify-content:${H_ALIGN_FLEX[opts.textAlign ?? "left"] ?? "flex-start"}`);
+    }
   }
   if (opts.textAlign) parts.push(`text-align:${opts.textAlign}`);
+  if (opts.textAlign === "justify") parts.push("text-align-last:justify");
   return parts.length ? parts.join(";") + ";" : "";
 }
+function indentStyle(opts) {
+  return opts.longTextIndent ? `text-indent:${opts.longTextIndent}em;` : "";
+}
+var OBJECT_POSITION_UNSAFE = /[;"'<>\\(){}\[\]@!#]/;
+function positionStyle(objectPosition) {
+  const v = (objectPosition ?? "").trim();
+  if (!v || v.length > 64 || OBJECT_POSITION_UNSAFE.test(v)) return "";
+  return `object-position:${escapeInlineStyleValue(v)};`;
+}
 function elementFitStyle(fit, opts) {
   if (fit === "autoHeight") return "overflow:visible;";
   if (opts.wordWrap === false) return "white-space:nowrap;text-overflow:ellipsis;";
@@ -2495,7 +2511,7 @@ function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
       return renderTableElement(el, isMeasure, measureAttr, ctx);
     case "image":
       return `<div class="print-element" style="${style}"${measureAttr}>
-  <img src="${esc(opts.src ?? "")}" style="width:100%;height:100%;object-fit:contain;" />
+  <img src="${esc(opts.src ?? "")}" style="width:100%;height:100%;object-fit:${opts.fit || "contain"};${positionStyle(opts.objectPosition)}" />
 </div>`;
     case "barcode":
     case "qrcode": {
@@ -2522,7 +2538,7 @@ function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
     case "oval":
       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>`;
+      return `<div class="print-element" style="${style}${textStyle(opts)}${indentStyle(opts)}${elementFitStyle(fit, opts)}"${measureAttr}${fitAttr}>${esc(opts.formatter ?? opts.testData ?? "")}</div>`;
     case "html":
       return `<div class="print-element" style="${style}"${measureAttr}>${opts.testData ?? opts.title ?? ""}</div>`;
     default:
@@ -2537,6 +2553,8 @@ function codeImgHtml(value, cellType, opts, io) {
     const svg = codeRenderer.render(value, cellType, {
       barcodeType: opts.barcodeType,
       qrCodeLevel: opts.qrCodeLevel != null ? String(opts.qrCodeLevel) : void 0,
+      // 0 是合法档（无白边），必须用 typeof 判定而非 or/?? 之类假值判断
+      qrQuietZone: typeof opts.qrQuietZone === "number" ? opts.qrQuietZone : 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,
@@ -2547,10 +2565,8 @@ function codeImgHtml(value, cellType, opts, io) {
     if (isBarcode && /^<svg[\s>]/i.test(svg)) return inlineCodeSvgHtml(svg);
     const src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
     const styleParts = [];
-    styleParts.push("max-width:100%", "max-height:100%", "display:block", "margin:auto");
-    if (fit) {
-      styleParts.push(`object-fit:${fit}`);
-    }
+    styleParts.push("width:100%", "height:100%", "max-width:100%", "max-height:100%", "display:block", "margin:auto");
+    styleParts.push(`object-fit:${fit || "contain"}`);
     if (maxWidth) {
       styleParts.push(`max-width:${maxWidth}mm`);
     }
@@ -2578,6 +2594,7 @@ function matrixCellStyle(cell, opts) {
   if (color) parts.push(`color:${color}`);
   if (cell.backgroundColor) parts.push(`background-color:${cell.backgroundColor}`);
   parts.push(`text-align:${cell.align ?? "left"}`);
+  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");
@@ -2617,7 +2634,7 @@ function renderMatrixRows(renderRows, start, end, opts, withRowIndex, ctx, fitOw
         const fit = cell.fit || "contain";
         const maxWidth = cell.maxWidth ? `max-width:${cell.maxWidth}mm;` : "max-width:100%;";
         const maxHeight = cell.maxHeight ? `max-height:${cell.maxHeight}mm;` : "max-height:100%;";
-        inner = `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;"><img src="${esc(resolveCellContent(cell, ctx))}" style="object-fit:${fit};${maxWidth}${maxHeight}display:block;" /></div>`;
+        inner = `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;"><img src="${esc(resolveCellContent(cell, ctx))}" style="object-fit:${fit};${positionStyle(cell.objectPosition)}${maxWidth}${maxHeight}display:block;" /></div>`;
       } else {
         inner = renderTextCellInner(renderRows, r, colIndex, cell, opts, fitOwner, defaultPadding, ctx);
       }
@@ -2960,7 +2977,8 @@ function codeSpecKey(value, cellType, opts = {}) {
     opts.qrCodeLevel ?? null,
     opts.showText ?? null,
     opts.barWidth ?? null,
-    opts.fontSize ?? null
+    opts.fontSize ?? null,
+    opts.qrQuietZone ?? null
   ]);
 }
 function createMapCodeRenderer(map) {

package/dist/{chunk-GLNQXOMO.js → chunk-WLGEOVFK.js}

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.7
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -9,7 +9,7 @@ import {
   evaluate,
   parse,
   tokenize
-} from "./chunk-JQUJ7AF3.js";
+} from "./chunk-TCI5XQKI.js";
 
 // src/index.ts
 var TemplateEngine = class {

package/dist/client/index.cjs

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

package/dist/client/index.d.cts

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

package/dist/client/index.d.ts

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

package/dist/client/index.js

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

package/dist/designer/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.7
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -102,6 +102,7 @@ __export(designer_exports, {
   normalizeSelection: () => normalizeSelection,
   normalizeTemplateUnits: () => normalizeTemplateUnits,
   parseCellFitKey: () => parseCellFitKey,
+  propertyTip: () => propertyTip,
   ptToMm: () => ptToMm,
   pxToMm: () => pxToMm,
   resolveBarcodeDesignValue: () => resolveBarcodeDesignValue,
@@ -112,6 +113,7 @@ __export(designer_exports, {
   resolveElementTextFit: () => resolveElementTextFit,
   resolveShrinkMinFontSize: () => resolveShrinkMinFontSize,
   resolveTextBinding: () => resolveTextBinding,
+  resolveToolbarOverflow: () => resolveToolbarOverflow,
   roundFontSize: () => roundFontSize,
   safeEval: () => safeEval2,
   searchProperties: () => searchProperties,
@@ -304,6 +306,27 @@ function computeFitScale(containerW, containerH, paperW, paperH, ratio = 0.9) {
   return Math.max(FIT_SCALE_MIN_PERCENT, pct);
 }
 
+// src/designer/utils/toolbar-overflow.ts
+var DEFAULT_GAP = 2;
+function resolveToolbarOverflow(input) {
+  const gap = input.gap ?? DEFAULT_GAP;
+  const chain = [...input.units].sort((a, b) => a.order - b.order);
+  if (input.available <= 0) return { movedIds: [], overflowRemains: false };
+  if (chain.some((u) => u.width <= 0)) return { movedIds: [], overflowRemains: false };
+  const fits = (moved2) => {
+    const inline = chain.filter((u) => !moved2.has(u.id));
+    const used = input.pinned + inline.reduce((sum2, u) => sum2 + u.width + gap, 0) + (moved2.size > 0 ? input.moreTriggerWidth + gap : 0);
+    return used <= input.available;
+  };
+  if (fits(/* @__PURE__ */ new Set())) return { movedIds: [], overflowRemains: false };
+  const moved = /* @__PURE__ */ new Set();
+  for (const unit of chain) {
+    moved.add(unit.id);
+    if (fits(moved)) return { movedIds: [...moved], overflowRemains: false };
+  }
+  return { movedIds: [...moved], overflowRemains: true };
+}
+
 // src/designer/utils/migrate.ts
 var PT_KEYS = ["left", "top", "width", "height"];
 function convertElement(el) {
@@ -1010,7 +1033,22 @@ var PROPERTY_REGISTRY = [
       { key: "ap-letter-spacing", keywords: ["\u5B57\u95F4\u8DDD", "letterspacing"] },
       { key: "ap-text-fit", keywords: ["\u6EA2\u51FA", "\u6EA2\u51FA\u663E\u793A", "\u622A\u65AD", "\u81EA\u52A8\u7F29\u5C0F", "\u81EA\u9002\u5E94\u884C\u9AD8", "textfit", "overflow"] },
       { key: "ap-shrink-min", keywords: ["\u6700\u5C0F\u5B57\u53F7", "\u7F29\u653E\u4E0B\u9650", "shrinkminfontsize"] },
-      { key: "ap-word-wrap", keywords: ["\u81EA\u52A8\u6362\u884C", "\u4E0D\u6362\u884C", "wordwrap"] }
+      { key: "ap-word-wrap", keywords: ["\u81EA\u52A8\u6362\u884C", "\u4E0D\u6362\u884C", "wordwrap"] },
+      {
+        key: "ap-long-text-indent",
+        keywords: ["\u9996\u884C\u7F29\u8FDB", "\u7F29\u8FDB", "indent", "longtextindent", "\u4E24\u5B57\u7B26", "\u6BB5\u9996"],
+        tip: "\u957F\u6587\u672C\u6BCF\u6BB5\u9996\u884C\u7A7A\u51FA\u7684\u5BBD\u5EA6\uFF0C\u5355\u4F4D\u300C\u5B57\u7B26\u300D\uFF1A\u586B 2 \u5373\u7F29\u8FDB\u4E24\u4E2A\u6C49\u5B57\u5BBD\uFF08\u4E2D\u6587\u6392\u7248\u60EF\u4F8B\uFF09\uFF0C\u6309 em \u843D\u7EB8\u2014\u2014\u5B57\u53F7\u88AB\u300C\u81EA\u52A8\u7F29\u5C0F\u300D\u538B\u5C0F\u65F6\u7F29\u8FDB\u540C\u6B65\u53D8\u7A84\u3002\u4EC5\u957F\u6587\u672C\u5143\u7D20\u751F\u6548\uFF0C\u5199\u5728\u666E\u901A\u6587\u672C\u4E0A\u4E0D\u751F\u6548"
+      },
+      {
+        key: "ap-img-fit",
+        keywords: ["\u7F29\u653E\u6A21\u5F0F", "\u62C9\u4F38", "\u7B49\u6BD4", "fit", "contain", "cover", "\u586B\u5145", "\u88C1\u526A"],
+        tip: "\u56FE\u7247\u5728\u5143\u7D20\u6846\u5185\u7684\u7F29\u653E\u65B9\u5F0F\uFF1A\u5305\u542B\uFF1D\u5B8C\u6574\u663E\u793A\u53EF\u80FD\u7559\u767D\uFF1B\u8986\u76D6\uFF1D\u94FA\u6EE1\u6846\u53EF\u80FD\u88C1\u8FB9\uFF1B\u62C9\u4F38\uFF1D\u586B\u6EE1\u6846\u4F1A\u53D8\u5F62\uFF1B\u539F\u59CB\u5C3A\u5BF8/\u7F29\u5C0F\u4E0D\u653E\u5927\u3002\u753B\u5E03\u4E0E\u4E09\u6761\u51FA\u7EB8\u94FE\u8DEF\u540C\u4E00\u53E3\u5F84\uFF08\u7F3A\u7701\u5305\u542B\uFF09"
+      },
+      {
+        key: "ap-img-object-position",
+        keywords: ["\u88C1\u526A\u951A\u70B9", "\u951A\u70B9", "objectposition", "object-position", "\u5BF9\u9F50\u70B9", "\u4E0A\u79FB", "\u5934\u9876"],
+        tip: "\u88C1\u526A\u65F6\u4FDD\u7559\u6846\u5185\u7684\u54EA\u4E00\u90E8\u5206\uFF0CCSS object-position \u503C\u539F\u6837\u751F\u6548\uFF08\u5982 center 20% \u8BA9\u753B\u9762\u4E0A\u79FB\u3001\u4FDD\u4F4F\u8BC1\u4EF6\u7167\u5934\u9876\uFF09\uFF1B\u53EA\u5728\u53D1\u751F\u88C1\u5207\u65F6\u53EF\u89C1\uFF0C\u7F3A\u7701\u6309 50% 50% \u5C45\u4E2D\u3002\u542B\u5206\u53F7\u3001\u5F15\u53F7\u3001url() \u7684\u503C\u4F1A\u88AB\u6574\u6761\u4E22\u5F03"
+      }
     ]
   },
   {
@@ -1023,6 +1061,11 @@ var PROPERTY_REGISTRY = [
       { key: "cd-show-text", keywords: ["\u663E\u793A\u6587\u672C", "\u6761\u7801\u6587\u672C", "\u663E\u793A\u6570\u5B57"] },
       { key: "cd-font-size", keywords: ["\u6761\u7801\u5B57\u53F7", "\u6587\u672C\u5B57\u53F7"] },
       { key: "cd-ec-level", keywords: ["\u7EA0\u9519\u7EA7\u522B", "\u5BB9\u9519", "qrcodelevel"] },
+      {
+        key: "cd-quiet-zone",
+        keywords: ["\u9759\u533A", "\u9759\u533A\u5BBD\u5EA6", "\u767D\u8FB9", "\u7A7A\u767D\u8FB9", "\u7559\u767D", "\u94FA\u6EE1", "quietzone"],
+        tip: "\u4E8C\u7EF4\u7801\u56DB\u5468\u7559\u51FA\u7684\u7A7A\u767D\u683C\u6570\uFF1A0 \u5373\u4E0D\u7559\u767D\u8FB9\u3001\u7801\u9762\u7B49\u6BD4\u94FA\u6EE1\u5143\u7D20\u6846\uFF08\u6B64\u65F6\u9760\u6846\u5916\u7684\u767D\u7EB8\u5145\u5F53\u9759\u533A\uFF09\uFF1B\u6570\u503C\u8D8A\u5927\u767D\u8FB9\u8D8A\u5BBD\u3001\u7801\u9762\u5728\u6846\u5185\u8D8A\u5C0F\uFF08\u7F3A\u7701 0\uFF0C\u9700 ISO/IEC 18004 \u63A8\u8350\u9759\u533A\u65F6\u586B 4\uFF09"
+      },
       { key: "cd-fit", keywords: ["\u7F29\u653E\u6A21\u5F0F", "\u62C9\u4F38", "\u7B49\u6BD4", "fit", "contain", "cover"] },
       { key: "cd-max-width", keywords: ["\u6700\u5927\u5BBD\u5EA6", "\u6700\u5927\u5BBD", "maxwidth"] },
       { key: "cd-max-height", keywords: ["\u6700\u5927\u9AD8\u5EA6", "\u6700\u5927\u9AD8", "maxheight"] }
@@ -1077,6 +1120,13 @@ var PROPERTY_REGISTRY = [
     ]
   }
 ];
+function propertyTip(key) {
+  for (const group of PROPERTY_REGISTRY) {
+    const hit = group.items.find((item) => item.key === key);
+    if (hit) return hit.tip ?? "";
+  }
+  return "";
+}
 function matchKeywords(search, keywords) {
   const s = search.trim().toLowerCase();
   if (!s) {
@@ -2846,6 +2896,7 @@ function useBindingDisplay() {
   normalizeSelection,
   normalizeTemplateUnits,
   parseCellFitKey,
+  propertyTip,
   ptToMm,
   pxToMm,
   resolveBarcodeDesignValue,
@@ -2856,6 +2907,7 @@ function useBindingDisplay() {
   resolveElementTextFit,
   resolveShrinkMinFontSize,
   resolveTextBinding,
+  resolveToolbarOverflow,
   roundFontSize,
   safeEval,
   searchProperties,

package/dist/designer/index.d.cts

@@ -1,12 +1,12 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.7
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
-import { E as ElementBorderSide, b as ElementOptions, c as TemplateData, d as TableRow, e as TableCellBorder, f as TableCell, g as TableRowType, h as ElementType, i as RuntimeElement, j as ElementZone, k as PrintBusinessField, B as BindingDescriptor, l as ElementRect, A as AdsorbResult, m as ResizePoint } from '../driver-CFm0C_yX.cjs';
-export { n as AlignLine, o as DesignBackground, p as ElementBorderEdge, q as ElementFieldBinding, r as MultiPageTemplateData, s as PaginationConfig, t as PaperSize, u as PrintElementData, v as PrintElementTypeMeta, w as TableCellBorders, x as TableCellType, y as TablePaginationConfig, z as TableSelection, F as TemplateElement, G as TextAlign, H as TextFit, U as UploadDesignBackgroundFn, I as UploadImageFn, V as VerticalAlign, W as WatermarkOptions } from '../driver-CFm0C_yX.cjs';
-export { C as CellFitRowKind, D as DEFAULT_SHRINK_MIN_FONT_SIZE_PT, F as FitFontSize, M as MIN_SHRINK_FONT_SIZE_PT, c as cellFitCapMm, a as cellFitKey, b as cellFitWidthMm, f as floorFontSize, p as parseCellFitKey, r as resolveCellTextFit, d as resolveElementTextFit, e as resolveShrinkMinFontSize, g as roundFontSize } from '../ports-BXYcHExa.cjs';
+import { E as ElementBorderSide, b as ElementOptions, c as TemplateData, d as TableRow, e as TableCellBorder, f as TableCell, g as TableRowType, h as ElementType, i as RuntimeElement, j as ElementZone, k as PrintBusinessField, B as BindingDescriptor, l as ElementRect, A as AdsorbResult, m as ResizePoint } from '../driver-Dzr2Aikx.cjs';
+export { n as AlignLine, o as DesignBackground, p as ElementBorderEdge, q as ElementFieldBinding, r as MultiPageTemplateData, s as PaginationConfig, t as PaperSize, u as PrintElementData, v as PrintElementTypeMeta, w as TableCellBorders, x as TableCellType, y as TablePaginationConfig, z as TableSelection, F as TemplateElement, G as TextAlign, H as TextFit, U as UploadDesignBackgroundFn, I as UploadImageFn, V as VerticalAlign, W as WatermarkOptions } from '../driver-Dzr2Aikx.cjs';
+export { C as CellFitRowKind, D as DEFAULT_SHRINK_MIN_FONT_SIZE_PT, F as FitFontSize, M as MIN_SHRINK_FONT_SIZE_PT, c as cellFitCapMm, a as cellFitKey, b as cellFitWidthMm, f as floorFontSize, p as parseCellFitKey, r as resolveCellTextFit, d as resolveElementTextFit, e as resolveShrinkMinFontSize, g as roundFontSize } from '../ports-Bin4xmo0.cjs';
 import { TemplateEngine, formatMoney, ifFn, addNumbers, subtractNumbers, multiplyNumbers, divideNumbers, round, roundUp, roundDown, roundHalfEven, formatDate, toUpperCaseAmount } from '../index.cjs';
 
 /** 1 英寸 = 25.4mm */
@@ -111,6 +111,40 @@ declare function nextWheelScale(percent: number, direction: 1 | -1, factor?: num
 /** 计算适应窗口的缩放百分比,允许小于交互缩放下限,保证整版纸张可见 */
 declare function computeFitScale(containerW: number, containerH: number, paperW: number, paperH: number, ratio?: number): number;
 
+/**
+ * 顶部工具栏自适应收纳的纯计算部分：给定可用宽与各收纳单元的自然宽度，
+ * 按收纳优先级链得出哪些单元应移入「更多」下拉。
+ *
+ * 放在框架无关内核而非某个 UI 包：canvas 与 common 两套设计器宿主必须同链同序，
+ * 复制两份会出现「同一宽度下收起的分组不同」。
+ */
+interface OverflowUnitInput {
+    /** 单元标识，同时作为「更多」面板内落位容器的 key */
+    id: string;
+    /** 收纳优先级：数值小者先被收进「更多」 */
+    order: number;
+    /** 实测自然宽度（px）；<=0 表示尚未上报 */
+    width: number;
+}
+interface ToolbarOverflowInput {
+    /** 工具栏可用内容宽（px） */
+    available: number;
+    /** 常驻不外收单元的合计宽（含其分隔） */
+    pinned: number;
+    /** 「更多」触发钮宽度，仅在确有收纳时计入 */
+    moreTriggerWidth: number;
+    /** flex 子项间距，与工具栏的 gap 同源 */
+    gap?: number;
+    units: OverflowUnitInput[];
+}
+interface ToolbarOverflowResult {
+    /** 收纳顺序（优先级链从先到后） */
+    movedIds: string[];
+    /** 收纳用尽仍放不下，需由样式兜底 */
+    overflowRemains: boolean;
+}
+declare function resolveToolbarOverflow(input: ToolbarOverflowInput): ToolbarOverflowResult;
+
 declare function normalizeTemplateUnits(data: TemplateData): TemplateData;
 
 /** 标签纸分组名（PAPER_PRESETS.group）：该组纸型默认取消页眉、页脚与页边距 */
@@ -290,6 +324,8 @@ declare const PRESET_COLORS: readonly ["#000000", "#333333", "#666666", "#999999
 interface PropertyItem {
     key: string;
     keywords: string[];
+    /** 字段说明文案：挂在标签后的帮助图标上（悬浮/点击显示），元素台与单元格台、canvas 与 common 共用同一份 */
+    tip?: string;
 }
 interface PropertyGroupDef {
     group: string;
@@ -298,6 +334,8 @@ interface PropertyGroupDef {
 }
 declare const PROPERTY_REGISTRY: PropertyGroupDef[];
 /** 正向包含匹配：任一关键词包含搜索词即命中；空搜索恒命中 */
+/** 按表单项 key 取说明文案（帮助图标 tip 的内容）；未登记说明时返回空串 */
+declare function propertyTip(key: string): string;
 declare function matchKeywords(search: string, keywords: string[]): boolean;
 /** 计算命中的分组与表单项 key 集合 */
 declare function searchProperties(search: string): {
@@ -484,4 +522,4 @@ declare function useBindingDisplay(): {
     getBindingDisplayState: (element: any) => BindingDisplayState;
 };
 
-export { type AdsorbConfig, AdsorbResult, type AlignMode, BARCODE_BAR_HEIGHT_MODULES, BARCODE_MARGIN_BOTTOM_MODULES, BARCODE_MODULE_WIDTH_MM, BARCODE_QUIET_ZONE_MODULES, BARCODE_TEXT_FONT_SIZE_MODULES, type BarcodeSize, type BarcodeSizeInput, BindingDescriptor, type BorderPreset, type CellRect, DEFAULT_DEMO_DATA, ELEMENT_BINDING_REGISTRY, ELEMENT_BORDER_SIDES, EXTENDED_FUNCTIONS, type ElementBorderCss, ElementBorderSide, type ElementBordersCss, ElementOptions, ElementRect, ElementType, ElementZone, FIT_SCALE_MIN_PERCENT, type FieldGroup, GHOST_BORDER_CSS, type KeyboardHandlers, LABEL_PAPER_GROUP, MIN_COL_WIDTH_MM, MIN_SCALE_PERCENT, MM_PER_INCH, type ManualGuides, PAPER_PRESETS, PRESET_COLORS, PROPERTY_REGISTRY, type PaperPreset, PrintBusinessField, type PropertyGroupDef, type PropertyItem, RESIZE_POINTS, RULER_THICKNESS, type ResizeOptions, ResizePoint, type ResizeRect, type RulerTick, RuntimeElement, TableCell, TableCellBorder, TableRow, TableRowType, TemplateData, ZONE_ALLOWED_TYPES, type ZoneRectPt, acceptsElementBorder, applyBorderPreset, barcodeAvailableBoxMm, barcodePreferredModuleWidthMm, barcodeUnitsPerModule, buildRulerTicks, calcResizeRect, canMergeReason, chooseMajorStepMM, clampResizedColumnWidth, clampScalePercent, clampToZone, computeAdsorb, computeFitScale, createCell, createDefaultOptions, createDefaultTable, createFieldElement, createRuntimeElement, deleteCol, deleteRow, engine, evaluateTemplate, filterGroups, finalizeElementZone, findMainCell, generateGroupId, generateId, getDemoData, getElementBindings, getPaperDimensions, getPaperSizeMM, getSpanRect, getTableCellBindings, getZoneRects, groupFields, insertCol, insertRow, isContinuousPaperSize, isLabelPaperSize, labelPaperDefaults, matchKeywords, mergeCells, minorStepMM, mmToPx, nextWheelScale, normalizeSelection, normalizeTemplateUnits, ptToMm, pxToMm, resolveBarcodeDesignValue, resolveBarcodeSize, resolveCellBorderCss, resolveElementBorder, resolveTextBinding, safeEval, searchProperties, setHeaderRepeat, setRowType, splitCells, syncTableElementSize, useAlign, useBindingDisplay, useGroup, useKeyboard, useResize, zoneFromPaperPoint };
+export { type AdsorbConfig, AdsorbResult, type AlignMode, BARCODE_BAR_HEIGHT_MODULES, BARCODE_MARGIN_BOTTOM_MODULES, BARCODE_MODULE_WIDTH_MM, BARCODE_QUIET_ZONE_MODULES, BARCODE_TEXT_FONT_SIZE_MODULES, type BarcodeSize, type BarcodeSizeInput, BindingDescriptor, type BorderPreset, type CellRect, DEFAULT_DEMO_DATA, ELEMENT_BINDING_REGISTRY, ELEMENT_BORDER_SIDES, EXTENDED_FUNCTIONS, type ElementBorderCss, ElementBorderSide, type ElementBordersCss, ElementOptions, ElementRect, ElementType, ElementZone, FIT_SCALE_MIN_PERCENT, type FieldGroup, GHOST_BORDER_CSS, type KeyboardHandlers, LABEL_PAPER_GROUP, MIN_COL_WIDTH_MM, MIN_SCALE_PERCENT, MM_PER_INCH, type ManualGuides, type OverflowUnitInput, PAPER_PRESETS, PRESET_COLORS, PROPERTY_REGISTRY, type PaperPreset, PrintBusinessField, type PropertyGroupDef, type PropertyItem, RESIZE_POINTS, RULER_THICKNESS, type ResizeOptions, ResizePoint, type ResizeRect, type RulerTick, RuntimeElement, TableCell, TableCellBorder, TableRow, TableRowType, TemplateData, type ToolbarOverflowInput, type ToolbarOverflowResult, ZONE_ALLOWED_TYPES, type ZoneRectPt, acceptsElementBorder, applyBorderPreset, barcodeAvailableBoxMm, barcodePreferredModuleWidthMm, barcodeUnitsPerModule, buildRulerTicks, calcResizeRect, canMergeReason, chooseMajorStepMM, clampResizedColumnWidth, clampScalePercent, clampToZone, computeAdsorb, computeFitScale, createCell, createDefaultOptions, createDefaultTable, createFieldElement, createRuntimeElement, deleteCol, deleteRow, engine, evaluateTemplate, filterGroups, finalizeElementZone, findMainCell, generateGroupId, generateId, getDemoData, getElementBindings, getPaperDimensions, getPaperSizeMM, getSpanRect, getTableCellBindings, getZoneRects, groupFields, insertCol, insertRow, isContinuousPaperSize, isLabelPaperSize, labelPaperDefaults, matchKeywords, mergeCells, minorStepMM, mmToPx, nextWheelScale, normalizeSelection, normalizeTemplateUnits, propertyTip, ptToMm, pxToMm, resolveBarcodeDesignValue, resolveBarcodeSize, resolveCellBorderCss, resolveElementBorder, resolveTextBinding, resolveToolbarOverflow, safeEval, searchProperties, setHeaderRepeat, setRowType, splitCells, syncTableElementSize, useAlign, useBindingDisplay, useGroup, useKeyboard, useResize, zoneFromPaperPoint };