@borurio-print/print-designer 1.0.3 → 1.0.5

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

@@ -15,7 +15,7 @@ export interface ComponentDefinition {
 /**
  * 设计器组件注册表。
  *
- * - 文字开放内容、字号、加粗和旋转。
+ * - 文字开放内容、字号、加粗和旋转；文字框额外开放固定区域排版能力。
  * - 二维码、条形码、图片开放内容、宽度、高度和旋转。
  * - 边框开放宽高、线宽和旋转；横线、竖线只开放各自长度方向与线宽。
  * - 表格开放坐标、宽高、列配置、字体、边框线宽和旋转。

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

@@ -0,0 +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

@@ -45,7 +45,7 @@ export interface PrintResult {
     error?: unknown;
 }
 /** 业务字段目前允许在标签中使用的三种展示方式。 */
-export type FieldElementType = 'text' | 'qrcode' | 'barcode';
+export type FieldElementType = 'text' | 'textBox' | 'qrcode' | 'barcode';
 /**
  * 由业务系统传给设计器的字段定义。
  *
@@ -68,9 +68,9 @@ export interface BusinessFieldGroup {
  * 这里保留尚未实现编辑能力的组件类型，是为了让左侧组件注册表始终使用
  * 稳定的业务标识；后续实现方框、线条等组件时不需要修改已有模板字段。
  */
-export type DesignerElementType = 'text' | 'rectangle' | 'horizontalLine' | 'verticalLine' | 'qrcode' | 'barcode' | 'image' | 'serialNumber' | 'pageNumber' | 'time' | 'table' | 'pdf';
+export type DesignerElementType = 'text' | 'textBox' | 'rectangle' | 'horizontalLine' | 'verticalLine' | 'qrcode' | 'barcode' | 'image' | 'serialNumber' | 'pageNumber' | 'time' | 'table' | 'pdf';
 /** 右侧属性面板中可独立组合的属性编辑器标识。 */
-export type ElementPropertyKey = 'displayType' | 'content' | '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 控制点共用，避免两处规则不一致。
@@ -91,7 +91,7 @@ export interface ElementPropertyConfig {
  */
 export interface BaseDesignerElement {
     id: string;
-    type: 'text' | 'rectangle' | 'horizontalLine' | 'verticalLine' | 'qrcode' | 'barcode' | 'image' | 'serialNumber' | 'pageNumber' | 'time' | 'table' | 'pdf';
+    type: 'text' | 'textBox' | 'rectangle' | 'horizontalLine' | 'verticalLine' | 'qrcode' | 'barcode' | 'image' | 'serialNumber' | 'pageNumber' | 'time' | 'table' | 'pdf';
     xMm: number;
     yMm: number;
     widthMm: number;
@@ -256,8 +256,40 @@ export interface TableDesignerElement extends BaseDesignerElement {
     fontSizePt: number;
     fontWeight: 400 | 700;
 }
+/** 文字框在固定区域内放不下内容时采用的尺寸适配方式。 */
+export type TextBoxFitMode = 'fixed' | 'shrinkFont';
+/** 固定区域在最小字号下仍放不下内容时采用的溢出方式。 */
+export type TextBoxOverflowMode = 'clip' | 'ellipsis';
+/** 文字框内容在固定区域内的水平对齐方式。 */
+export type TextHorizontalAlign = 'left' | 'center' | 'right';
+/** 文字框内容在固定区域内的垂直对齐方式。 */
+export type TextVerticalAlign = 'top' | 'middle' | 'bottom';
+/**
+ * 多行文字框使用固定毫米宽高进行排版。
+ * 与普通文字不同，拖动控制点只改变文本框，不会同步缩放字号。
+ */
+export interface TextBoxDesignerElement extends BaseDesignerElement {
+    type: 'textBox';
+    /** 存在 field 时，打印阶段从业务数据读取；普通固定文字框不设置该字段。 */
+    field?: string;
+    content: string;
+    fontSizePt: number;
+    fontWeight: 400 | 700;
+    /** 行高相对于字号毫米高度的倍数。 */
+    lineHeight: number;
+    fitMode: TextBoxFitMode;
+    overflowMode: TextBoxOverflowMode;
+    /** shrinkFont 模式允许缩小到的最小字号。 */
+    minFontSizePt: number;
+    /** 新建文字框使用内边距；旧模板缺少该字段时按 0 处理。 */
+    paddingMm?: number;
+    /** 旧模板缺少该字段时按左对齐处理。 */
+    horizontalAlign?: TextHorizontalAlign;
+    /** 旧模板缺少该字段时按顶部对齐处理。 */
+    verticalAlign?: TextVerticalAlign;
+}
 /** 当前已经具备创建、属性编辑和 SVG 渲染能力的元素集合。 */
-export type DesignerElement = TextDesignerElement | RectangleDesignerElement | LineDesignerElement | QrcodeDesignerElement | BarcodeDesignerElement | ImageDesignerElement | SerialNumberDesignerElement | PageNumberDesignerElement | TimeDesignerElement | TableDesignerElement | PdfDesignerElement;
+export type DesignerElement = TextDesignerElement | TextBoxDesignerElement | RectangleDesignerElement | LineDesignerElement | QrcodeDesignerElement | BarcodeDesignerElement | ImageDesignerElement | SerialNumberDesignerElement | PageNumberDesignerElement | TimeDesignerElement | TableDesignerElement | PdfDesignerElement;
 /** 设计器运行期间保存的元素剪贴板快照。 */
 export interface ElementClipboardItem {
     id: string;