蒙版

src/types.ts

@@ -214,6 +214,35 @@ export interface TemplateElement {
   tableBorderWidth?: number;
   /** 单元格网格线颜色，仅 type=table */
   tableBorderColor?: string;
+  /** 图层蒙版；在预览与导出时裁剪元素可见区域 */
+  mask?: ElementMaskConfig;
+}
+
+export type ElementMaskShape = 'rect' | 'image';
+
+export interface ElementMaskConfig {
+  /** 是否启用蒙版 */
+  enabled?: boolean;
+  /** 蒙版形状：矩形矢量区域或图片 alpha */
+  type?: ElementMaskShape;
+  /** 相对元素左上角的 X 偏移 (mm) */
+  x?: number;
+  /** 相对元素左上角的 Y 偏移 (mm) */
+  y?: number;
+  /** 蒙版区域宽度 (mm)，默认与元素同宽 */
+  width?: number;
+  /** 蒙版区域高度 (mm)，默认与元素同高 */
+  height?: number;
+  /** 圆角半径 (mm) */
+  borderRadius?: number;
+  borderRadiusTL?: number;
+  borderRadiusTR?: number;
+  borderRadiusBR?: number;
+  borderRadiusBL?: number;
+  /** 图片蒙版（data URI / URL），type=image 时使用 */
+  image?: string;
+  /** 图片蒙版在区域内的适应方式 */
+  imageFit?: 'contain' | 'cover' | 'fill';
 }
 
 export interface DataSourceMeta {
@@ -268,6 +297,16 @@ export interface LabelTemplate {
   enablePreviewReferenceBackground?: boolean;
   /** 生成 PDF / 打印 / 排版预览输出时是否绘制参考背景，默认 false */
   includeReferenceBackgroundInOutput?: boolean;
+  /** 排版整页背景图（URL / data URI） */
+  layoutPageBackground?: string;
+  /** 排版整页背景不透明度 0–100，默认 100 */
+  layoutPageBackgroundOpacity?: number;
+  /** 排版整页背景适应方式，默认 cover */
+  layoutPageBackgroundFit?: 'contain' | 'cover' | 'fill';
+  /** 排版预览是否显示整页背景，默认 true */
+  enableLayoutPageBackground?: boolean;
+  /** PDF / 打印输出时是否绘制整页背景，默认 false */
+  includeLayoutPageBackgroundInOutput?: boolean;
   /** 批量导出图片时的文件名模板，支持 {#SEQ}、{#INDEX}、{变量名}；留空则按序号补零命名 */
   exportImageFileNamePattern?: string;
   /** 批量导出图片：all=全部导出，conditional=按条件过滤 */