@borurio-print/print-designer 1.0.4 → 1.0.6

package/dist-lib/core/textBoxLayout.d.ts

@@ -1,13 +1,26 @@
 import type { TextBoxDesignerElement } from './types';
+export declare const DEFAULT_TEXT_BOX_PADDING_MM = 0.5;
 export interface TextBoxLayoutResult {
     lines: string[];
     fontSizePt: number;
     fontSizeMm: number;
     lineHeightMm: number;
     truncated: boolean;
+    textAnchor: 'start' | 'middle' | 'end';
+    textXOffsetMm: number;
+    textYOffsetMm: number;
+}
+export interface TextBoxInitialSize {
+    widthMm: number;
+    heightMm: number;
 }
 /**
  * 把运行时文字排入固定毫米矩形。设计画布和 PDF 共用该结果，避免预览与打印
  * 分别依赖 CSS/SVG 的隐式换行规则而产生差异。
  */
 export declare function layoutTextBox(element: TextBoxDesignerElement, content: string): TextBoxLayoutResult;
+/**
+ * 根据设计时可见内容计算新建文字框的初始尺寸。尺寸只在创建时计算，之后用户
+ * 调整的宽高不会因为编辑内容或替换打印数据而被覆盖。
+ */
+export declare function measureInitialTextBoxSize(element: Pick<TextBoxDesignerElement, 'content' | 'fontSizePt' | 'fontWeight' | 'lineHeight' | 'paddingMm'>, maximumWidthMm: number, maximumHeightMm: number): TextBoxInitialSize;

package/dist-lib/core/types.d.ts

@@ -70,7 +70,7 @@ export interface BusinessFieldGroup {
  */
 export type DesignerElementType = 'text' | 'textBox' | 'rectangle' | 'horizontalLine' | 'verticalLine' | 'qrcode' | 'barcode' | 'image' | 'serialNumber' | 'pageNumber' | 'time' | 'table' | 'pdf';
 /** 右侧属性面板中可独立组合的属性编辑器标识。 */
-export type ElementPropertyKey = 'displayType' | 'content' | 'textBoxFitMode' | 'textBoxOverflowMode' | 'lineHeight' | 'minFontSize' | 'imageSource' | 'x' | 'y' | 'width' | 'height' | 'fontSize' | 'fontWeight' | 'strokeWidth' | 'rotation' | 'timeMode' | 'includeTime' | 'fixedTime' | 'tableConfig' | 'pdfSource' | 'pdfCropMode' | 'pdfCropRatio';
+export type ElementPropertyKey = 'displayType' | 'content' | 'textHorizontalAlign' | 'textVerticalAlign' | 'textBoxFitMode' | 'textBoxOverflowMode' | 'lineHeight' | 'minFontSize' | 'imageSource' | 'x' | 'y' | 'width' | 'height' | 'fontSize' | 'fontWeight' | 'strokeWidth' | 'rotation' | 'timeMode' | 'includeTime' | 'fixedTime' | 'tableConfig' | 'pdfSource' | 'pdfCropMode' | 'pdfCropRatio';
 /**
  * 单个属性编辑器的能力与数值约束。
  * 数值范围跟随组件类型配置，输入框和 SVG 控制点共用，避免两处规则不一致。
@@ -84,6 +84,10 @@ export interface ElementPropertyConfig {
     /** 属性是否适用于元素当前状态，例如固定时间只在“固定”模式下展示。 */
     visibleWhen?: (element: DesignerElement) => boolean;
 }
+/** 元素相对标签画布持续生效的水平对齐规则。 */
+export type CanvasHorizontalAlign = 'left' | 'center' | 'right';
+/** 元素相对标签画布持续生效的垂直对齐规则。 */
+export type CanvasVerticalAlign = 'top' | 'center' | 'bottom';
 /**
  * 所有可编辑元素共用的布局数据。
  * 坐标和尺寸统一使用毫米，rotation 统一使用角度，避免保存屏幕像素后
@@ -98,6 +102,10 @@ export interface BaseDesignerElement {
     heightMm: number;
     rotation: number;
     zIndex: number;
+    /** 缺少时沿用模板保存的 xMm，不做运行时重排。 */
+    canvasHorizontalAlign?: CanvasHorizontalAlign;
+    /** 缺少时沿用模板保存的 yMm，不做运行时重排。 */
+    canvasVerticalAlign?: CanvasVerticalAlign;
 }
 /** 普通文字元素独有的排版属性。 */
 export interface TextDesignerElement extends BaseDesignerElement {
@@ -260,6 +268,10 @@ export interface TableDesignerElement extends BaseDesignerElement {
 export type TextBoxFitMode = 'fixed' | 'shrinkFont';
 /** 固定区域在最小字号下仍放不下内容时采用的溢出方式。 */
 export type TextBoxOverflowMode = 'clip' | 'ellipsis';
+/** 文字框内容在固定区域内的水平对齐方式。 */
+export type TextHorizontalAlign = 'left' | 'center' | 'right';
+/** 文字框内容在固定区域内的垂直对齐方式。 */
+export type TextVerticalAlign = 'top' | 'middle' | 'bottom';
 /**
  * 多行文字框使用固定毫米宽高进行排版。
  * 与普通文字不同，拖动控制点只改变文本框，不会同步缩放字号。
@@ -277,6 +289,12 @@ export interface TextBoxDesignerElement extends BaseDesignerElement {
     overflowMode: TextBoxOverflowMode;
     /** shrinkFont 模式允许缩小到的最小字号。 */
     minFontSizePt: number;
+    /** 新建文字框使用内边距；旧模板缺少该字段时按 0 处理。 */
+    paddingMm?: number;
+    /** 旧模板缺少该字段时按左对齐处理。 */
+    horizontalAlign?: TextHorizontalAlign;
+    /** 旧模板缺少该字段时按顶部对齐处理。 */
+    verticalAlign?: TextVerticalAlign;
 }
 /** 当前已经具备创建、属性编辑和 SVG 渲染能力的元素集合。 */
 export type DesignerElement = TextDesignerElement | TextBoxDesignerElement | RectangleDesignerElement | LineDesignerElement | QrcodeDesignerElement | BarcodeDesignerElement | ImageDesignerElement | SerialNumberDesignerElement | PageNumberDesignerElement | TimeDesignerElement | TableDesignerElement | PdfDesignerElement;