@worm-vue3-print/core 1.3.6 → 1.3.8

package/dist/{driver-CFm0C_yX.d.cts → driver-hJxBl2_n.d.cts}

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.8
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -242,7 +242,7 @@ type TemplateElement$1 = PrintElementData;
 /** 元素类型 */
 type ElementType = 'text' | 'image' | 'longText' | 'table' | 'hline' | 'vline' | 'rect' | 'oval' | 'barcode' | 'qrcode' | 'html' | 'pageNumber';
 /** 对齐方式 */
-type TextAlign = 'left' | 'center' | 'right';
+type TextAlign = 'left' | 'center' | 'right' | 'justify';
 /**
  * 文字超出可用空间时的显示形式（文本类元素与表格单元格共用）：
  * - `clip`：截断，超出部分不显示；不换行（`wordWrap=false`）时以省略号收尾
@@ -310,6 +310,7 @@ interface TableCell {
     cellType?: TableCellType;
     barcodeType?: string;
     qrCodeLevel?: string;
+    qrQuietZone?: number;
     showBarcodeText?: boolean;
     /**
      * 打印机分辨率（点/英寸，常见 203/300/600），仅 cellType='barcode' 时生效：
@@ -340,6 +341,8 @@ interface TableCell {
     /** 自动缩小（textFit='shrink'）的下限字号（pt）；缺省 6pt */
     shrinkMinFontSize?: number;
     fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
+    objectPosition?: string;
+    fitScale?: number;
     maxWidth?: number;
     maxHeight?: number;
 }
@@ -421,9 +424,20 @@ interface ElementOptions {
      */
     printerDpi?: number;
     qrCodeLevel?: string;
+    /**
+     * 二维码静区（白边）宽度，单位「模块」：图形四周留出的空白格数，缺省 0。
+     * 0 表示不留白边，码面即整张图、等比铺满元素框——此时扫码所需的静区由元素框外的白纸充当；
+     * 要合规静区（ISO/IEC 18004 推荐 4 模块）请显式写 4。
+     * 值越大码面在框内占比越小（21 模块时：0→100%、2→84%、4→72.4%）。
+     */
+    qrQuietZone?: number;
     src?: string;
     /** 内容缩放模式（image/qrcode）：contain | cover | fill | none | scale-down。条形码不接受拉伸——尺寸已由结算确定 */
     fit?: string;
+    /** 裁剪锚点（image）：CSS object-position 值透传，如 'center 20%'；含 ; 引号 url() 等非法字符则整条丢弃；缺省不输出，按 50% 50% 居中 */
+    objectPosition?: string;
+    /** 剪裁放大比例（image，100~400，单位 %）：仅 fit='cover' 消费——铺满后把画面再推大这么多，两轴同时溢出才真裁得动；100/缺省不落声明 */
+    fitScale?: number;
     /** 内容最大宽度（mm，image/barcode/qrcode）；缺省不限制 */
     maxWidth?: number;
     /** 内容最大高度（mm，image/barcode/qrcode）；缺省不限制 */
@@ -451,8 +465,6 @@ interface ElementOptions {
     styler?: string;
     rowStyler?: string;
     longTextIndent?: number;
-    leftSpaceRemoved?: boolean;
-    lHeight?: number;
 }
 /** 元素类型元数据 */
 interface PrintElementTypeMeta {
@@ -656,12 +668,18 @@ interface RenderCell {
     barcodeType?: string;
     /** 二维码纠错级别 L/M/Q/H，仅 cellType='qrcode' 时生效 */
     qrCodeLevel?: string;
+    /** 二维码静区（白边）宽度（模块），仅 cellType='qrcode' 时生效；缺省 0 = 码面铺满单元格 */
+    qrQuietZone?: number;
     /** 条形码下方是否显示文本，仅 cellType='barcode' 时生效 */
     showBarcodeText?: boolean;
     /** 打印机分辨率（点/英寸），仅 cellType='barcode' 时生效：给出后条码尺寸优先适配打印机点阵 */
     printerDpi?: number;
     /** 图片缩放模式，仅 cellType='image' 时生效 */
     fit?: string;
+    /** 裁剪锚点（CSS object-position 值），仅 cellType=image 生效；含非法字符则整条不输出 */
+    objectPosition?: string;
+    /** 剪裁放大比例（%，100~400），仅 cellType=image 且 fit=cover 生效；100/缺省不输出 */
+    fitScale?: number;
     /** 图片最大宽度（mm），仅 cellType='image' 时生效 */
     maxWidth?: number;
     /** 图片最大高度（mm），仅 cellType='image' 时生效 */
@@ -698,6 +716,8 @@ interface CodeRenderOptions {
     barcodeType?: string;
     /** 二维码纠错级别 L/M/Q/H，仅 qrcode 类型使用 */
     qrCodeLevel?: string;
+    /** 二维码静区（白边）宽度，单位「模块」，仅 qrcode 类型使用；缺省 0 = 无白边，码面即整张图 */
+    qrQuietZone?: number;
     /** 条形码下方是否显示文本 */
     showText?: boolean;
     /** 条码模块宽度倍率；决定每模块的首选物理宽度（倍率/2 × 0.25mm），给 dpi 后吸附到最近整数点 */

package/dist/{driver-CFm0C_yX.d.ts → driver-hJxBl2_n.d.ts}

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/core v1.3.6
+ * @worm-vue3-print/core v1.3.8
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -242,7 +242,7 @@ type TemplateElement$1 = PrintElementData;
 /** 元素类型 */
 type ElementType = 'text' | 'image' | 'longText' | 'table' | 'hline' | 'vline' | 'rect' | 'oval' | 'barcode' | 'qrcode' | 'html' | 'pageNumber';
 /** 对齐方式 */
-type TextAlign = 'left' | 'center' | 'right';
+type TextAlign = 'left' | 'center' | 'right' | 'justify';
 /**
  * 文字超出可用空间时的显示形式（文本类元素与表格单元格共用）：
  * - `clip`：截断，超出部分不显示；不换行（`wordWrap=false`）时以省略号收尾
@@ -310,6 +310,7 @@ interface TableCell {
     cellType?: TableCellType;
     barcodeType?: string;
     qrCodeLevel?: string;
+    qrQuietZone?: number;
     showBarcodeText?: boolean;
     /**
      * 打印机分辨率（点/英寸，常见 203/300/600），仅 cellType='barcode' 时生效：
@@ -340,6 +341,8 @@ interface TableCell {
     /** 自动缩小（textFit='shrink'）的下限字号（pt）；缺省 6pt */
     shrinkMinFontSize?: number;
     fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
+    objectPosition?: string;
+    fitScale?: number;
     maxWidth?: number;
     maxHeight?: number;
 }
@@ -421,9 +424,20 @@ interface ElementOptions {
      */
     printerDpi?: number;
     qrCodeLevel?: string;
+    /**
+     * 二维码静区（白边）宽度，单位「模块」：图形四周留出的空白格数，缺省 0。
+     * 0 表示不留白边，码面即整张图、等比铺满元素框——此时扫码所需的静区由元素框外的白纸充当；
+     * 要合规静区（ISO/IEC 18004 推荐 4 模块）请显式写 4。
+     * 值越大码面在框内占比越小（21 模块时：0→100%、2→84%、4→72.4%）。
+     */
+    qrQuietZone?: number;
     src?: string;
     /** 内容缩放模式（image/qrcode）：contain | cover | fill | none | scale-down。条形码不接受拉伸——尺寸已由结算确定 */
     fit?: string;
+    /** 裁剪锚点（image）：CSS object-position 值透传，如 'center 20%'；含 ; 引号 url() 等非法字符则整条丢弃；缺省不输出，按 50% 50% 居中 */
+    objectPosition?: string;
+    /** 剪裁放大比例（image，100~400，单位 %）：仅 fit='cover' 消费——铺满后把画面再推大这么多，两轴同时溢出才真裁得动；100/缺省不落声明 */
+    fitScale?: number;
     /** 内容最大宽度（mm，image/barcode/qrcode）；缺省不限制 */
     maxWidth?: number;
     /** 内容最大高度（mm，image/barcode/qrcode）；缺省不限制 */
@@ -451,8 +465,6 @@ interface ElementOptions {
     styler?: string;
     rowStyler?: string;
     longTextIndent?: number;
-    leftSpaceRemoved?: boolean;
-    lHeight?: number;
 }
 /** 元素类型元数据 */
 interface PrintElementTypeMeta {
@@ -656,12 +668,18 @@ interface RenderCell {
     barcodeType?: string;
     /** 二维码纠错级别 L/M/Q/H，仅 cellType='qrcode' 时生效 */
     qrCodeLevel?: string;
+    /** 二维码静区（白边）宽度（模块），仅 cellType='qrcode' 时生效；缺省 0 = 码面铺满单元格 */
+    qrQuietZone?: number;
     /** 条形码下方是否显示文本，仅 cellType='barcode' 时生效 */
     showBarcodeText?: boolean;
     /** 打印机分辨率（点/英寸），仅 cellType='barcode' 时生效：给出后条码尺寸优先适配打印机点阵 */
     printerDpi?: number;
     /** 图片缩放模式，仅 cellType='image' 时生效 */
     fit?: string;
+    /** 裁剪锚点（CSS object-position 值），仅 cellType=image 生效；含非法字符则整条不输出 */
+    objectPosition?: string;
+    /** 剪裁放大比例（%，100~400），仅 cellType=image 且 fit=cover 生效；100/缺省不输出 */
+    fitScale?: number;
     /** 图片最大宽度（mm），仅 cellType='image' 时生效 */
     maxWidth?: number;
     /** 图片最大高度（mm），仅 cellType='image' 时生效 */
@@ -698,6 +716,8 @@ interface CodeRenderOptions {
     barcodeType?: string;
     /** 二维码纠错级别 L/M/Q/H，仅 qrcode 类型使用 */
     qrCodeLevel?: string;
+    /** 二维码静区（白边）宽度，单位「模块」，仅 qrcode 类型使用；缺省 0 = 无白边，码面即整张图 */
+    qrQuietZone?: number;
     /** 条形码下方是否显示文本 */
     showText?: boolean;
     /** 条码模块宽度倍率；决定每模块的首选物理宽度（倍率/2 × 0.25mm），给 dpi 后吸附到最近整数点 */