star-horse-lowcode 3.1.13 → 3.1.15

package/dist/types/components/print/constants.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 打印模板设计器 - 常量定义
+ *
+ * 集中管理：纸张预设、默认元素、字体、颜色等
+ */
+import type { BarcodeSymbology, PrintDataField, PrintElement, PrintPaper, PrintSystemVar } from "./types";
+/** 预设纸张 */
+export declare const PRESET_PAPERS: PrintPaper[];
+/** 默认纸张 */
+export declare const DEFAULT_PAPER: PrintPaper;
+/** 默认字体族 */
+export declare const DEFAULT_FONT_FAMILY = "Microsoft YaHei";
+/** 字号预设 */
+export declare const FONT_SIZE_PRESETS: number[];
+/** 常用颜色 */
+export declare const COLOR_PRESETS: string[];
+/** 条码码制选项 */
+export declare const BARCODE_SYMBOLOGY_OPTIONS: Array<{
+    label: string;
+    value: BarcodeSymbology;
+}>;
+/** 系统变量选项 */
+export declare const SYSTEM_VAR_OPTIONS: Array<{
+    label: string;
+    value: PrintSystemVar;
+}>;
+/** 系统变量格式化（日期类） */
+export declare const SYSTEM_VAR_DATE_FORMAT: Record<string, string>;
+/** 默认数据字段（用于演示） */
+export declare const DEFAULT_DATA_FIELDS: PrintDataField[];
+/** 创建默认文本元素 */
+export declare const createTextElement: (overrides?: Partial<PrintElement>) => PrintElement;
+/** 创建默认条码元素 */
+export declare const createBarcodeElement: (overrides?: Partial<PrintElement>) => PrintElement;
+/** 创建默认二维码元素 */
+export declare const createQrcodeElement: (overrides?: Partial<PrintElement>) => PrintElement;
+/** 创建默认图片元素 */
+export declare const createImageElement: (overrides?: Partial<PrintElement>) => PrintElement;
+/** 创建默认直线元素 */
+export declare const createLineElement: (overrides?: Partial<PrintElement>) => PrintElement;
+/** 创建默认矩形元素 */
+export declare const createRectElement: (overrides?: Partial<PrintElement>) => PrintElement;
+/** 创建默认日期时间元素 */
+export declare const createDateTimeElement: (overrides?: Partial<PrintElement>) => PrintElement;
+/** 创建默认计数器元素 */
+export declare const createCounterElement: (overrides?: Partial<PrintElement>) => PrintElement;
+/** 创建默认表格元素 */
+export declare const createTableElement: (overrides?: Partial<PrintElement>) => PrintElement;
+/** 元素工厂函数映射 */
+export declare const ELEMENT_FACTORIES: Record<string, (overrides?: Partial<PrintElement>) => PrintElement>;
+/** MM 转 PX 比例（96 DPI：1mm ≈ 3.7795px） */
+export declare const MM_TO_PX = 3.7795275591;
+/** PX 转 MM 比例 */
+export declare const PX_TO_MM: number;
+/** MM 转 PT 比例（1pt = 1/72 inch, 1 inch = 25.4mm） */
+export declare const MM_TO_PT: number;
+/** PT 转 MM 比例 */
+export declare const PT_TO_MM: number;
+/** 默认缩放 */
+export declare const DEFAULT_ZOOM = 1;
+/** 缩放范围 */
+export declare const ZOOM_RANGE: {
+    min: number;
+    max: number;
+};
+/** 缩放步进 */
+export declare const ZOOM_STEP = 0.1;
+/** 默认吸附阈值 */
+export declare const DEFAULT_SNAP_THRESHOLD = 1;
+/** 历史记录最大长度 */
+export declare const MAX_HISTORY_SIZE = 50;

package/dist/types/components/print/dialogs/PrintDataSourceDialog.vue.d.ts

@@ -0,0 +1,14 @@
+import type { PrintDataSource } from "../types";
+type __VLS_Props = {
+    visible: boolean;
+    dataSources: PrintDataSource[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    save: (list: PrintDataSource[]) => any;
+    "update:visible": (v: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSave?: (list: PrintDataSource[]) => any;
+    "onUpdate:visible"?: (v: boolean) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/print/dialogs/PrintPreviewDialog.vue.d.ts

@@ -0,0 +1,24 @@
+import type { PrintRenderTarget, PrintTemplate } from "../types";
+type __VLS_Props = {
+    visible: boolean;
+    template: PrintTemplate;
+    /** 渲染数据（必填，预览前需先准备） */
+    data?: Record<string, any>;
+    /** 操作员名 */
+    operator?: string;
+    /** 打印机名 */
+    printerName?: string;
+    /** 默认页数 */
+    pageCount?: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:visible": (v: boolean) => any;
+    print: (target: PrintRenderTarget, content: string) => any;
+    "copy-zpl": (content: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:visible"?: (v: boolean) => any;
+    onPrint?: (target: PrintRenderTarget, content: string) => any;
+    "onCopy-zpl"?: (content: string) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/print/dialogs/PrintTemplateManagerDialog.vue.d.ts

@@ -0,0 +1,19 @@
+import type { PrintTemplate } from "../types";
+type __VLS_Props = {
+    visible: boolean;
+    /** 已保存的模板列表（外部存储） */
+    savedTemplates: PrintTemplate[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    delete: (id: string) => any;
+    load: (template: PrintTemplate) => any;
+    "update:visible": (v: boolean) => any;
+    export: (template: PrintTemplate) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDelete?: (id: string) => any;
+    onLoad?: (template: PrintTemplate) => any;
+    "onUpdate:visible"?: (v: boolean) => any;
+    onExport?: (template: PrintTemplate) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/print/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 打印模板设计器 - 模块导出
+ *
+ * 单一职责：仅做导出聚合，不包含业务逻辑
+ */
+export { default as PrintTemplateDesigner } from "./PrintTemplateDesigner.vue";
+export { default as PrintToolbar } from "./panels/PrintToolbar.vue";
+export { default as PrintElementPanel } from "./panels/PrintElementPanel.vue";
+export { default as PrintCanvas } from "./panels/PrintCanvas.vue";
+export { default as PrintPropertyPanel } from "./panels/PrintPropertyPanel.vue";
+export { default as PrintLayerPanel } from "./panels/PrintLayerPanel.vue";
+export { default as PrintPreviewDialog } from "./dialogs/PrintPreviewDialog.vue";
+export { default as PrintDataSourceDialog } from "./dialogs/PrintDataSourceDialog.vue";
+export { default as PrintTemplateManagerDialog } from "./dialogs/PrintTemplateManagerDialog.vue";
+export { usePrintDesigner } from "./composables/usePrintDesigner";
+export { renderPrintHtml, renderPageHtml } from "./renderers/HtmlRenderer";
+export { renderZpl } from "./renderers/ZplRenderer";
+export { renderTspl } from "./renderers/TsplRenderer";
+export { PRESET_PAPERS, DEFAULT_PAPER, DEFAULT_DATA_FIELDS, ELEMENT_FACTORIES, SYSTEM_VAR_OPTIONS, BARCODE_SYMBOLOGY_OPTIONS, FONT_SIZE_PRESETS, COLOR_PRESETS, MM_TO_PX, PX_TO_MM, MM_TO_PT, PT_TO_MM, } from "./constants";
+export type * from "./types";

package/dist/types/components/print/panels/PrintCanvas.vue.d.ts

@@ -0,0 +1,7 @@
+import type { UsePrintDesignerReturn } from "../composables/usePrintDesigner";
+type __VLS_Props = {
+    designer: UsePrintDesignerReturn;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/print/panels/PrintElementPanel.vue.d.ts

@@ -0,0 +1,12 @@
+type __VLS_Props = {
+    readonly?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    add: (type: string) => any;
+    "drag-start": (type: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAdd?: (type: string) => any;
+    "onDrag-start"?: (type: string) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/print/panels/PrintLayerPanel.vue.d.ts

@@ -0,0 +1,7 @@
+import type { UsePrintDesignerReturn } from "../composables/usePrintDesigner";
+type __VLS_Props = {
+    designer: UsePrintDesignerReturn;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/print/panels/PrintPropertyPanel.vue.d.ts

@@ -0,0 +1,7 @@
+import type { UsePrintDesignerReturn } from "../composables/usePrintDesigner";
+type __VLS_Props = {
+    designer: UsePrintDesignerReturn;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/print/panels/PrintToolbar.vue.d.ts

@@ -0,0 +1,18 @@
+import type { UsePrintDesignerReturn } from "../composables/usePrintDesigner";
+type __VLS_Props = {
+    designer: UsePrintDesignerReturn;
+    readonly?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    datasource: () => any;
+    save: () => any;
+    preview: () => any;
+    manage: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDatasource?: () => any;
+    onSave?: () => any;
+    onPreview?: () => any;
+    onManage?: () => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/print/renderers/HtmlRenderer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * HTML 渲染器
+ *
+ * 职责：将 PrintElement[] 渲染为 HTML 字符串 / 浏览器打印
+ * 不依赖任何运行时框架，纯字符串拼接，便于服务端渲染
+ */
+import type { PrintRenderContext, PrintTemplate } from "../types";
+/** 渲染整页 HTML */
+export declare const renderPageHtml: (template: PrintTemplate, ctx: PrintRenderContext) => string;
+/** 渲染完整打印 HTML（包含 @page 规则） */
+export declare const renderPrintHtml: (template: PrintTemplate, ctx: PrintRenderContext) => string;

package/dist/types/components/print/renderers/TsplRenderer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * TSPL 渲染器（TSC Printer Programming Language）
+ *
+ * 职责：将 PrintElement[] 渲染为 TSPL/TSPL2 指令字符串
+ * 适用于 TSC / TTP 系列标签打印机
+ *
+ * 关键命令：
+ *   SIZE 标签尺寸
+ *   GAP 标签间距
+ *   CLS 清空缓冲区
+ *   TEXT 文本
+ *   BARCODE 条码
+ *   QRCODE 二维码
+ *   BAR 直线
+ *   BOX 矩形
+ *   CIRCLE 圆
+ *   PRINT 打印
+ */
+import type { PrintRenderContext, PrintTemplate } from "../types";
+/** 渲染整页 TSPL */
+export declare const renderTspl: (template: PrintTemplate, ctx: PrintRenderContext) => string;

package/dist/types/components/print/renderers/ZplRenderer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ZPL 渲染器（Zebra Programming Language）
+ *
+ * 职责：将 PrintElement[] 渲染为 ZPL II 指令字符串
+ * 适用于 Zebra / Honeywell / TSC 等支持 ZPL 的打印机
+ *
+ * 参考文档：Zebra ZPL Programming Guide Volume 2
+ * 关键命令：
+ *   ^XA 开始 / ^XZ 结束
+ *   ^LH 设置标签原点偏移
+ *   ^PW 设置打印宽度
+ *   ^FO 字段原点（X,Y）
+ *   ^FD 字段数据 / ^FS 字段结束
+ *   ^A 字体 ^CF 默认字体
+ *   ^BY 条码默认参数
+ *   ^BC CODE128 ^BQ 二维码
+ */
+import type { PrintRenderContext, PrintTemplate } from "../types";
+/** 渲染整页 ZPL */
+export declare const renderZpl: (template: PrintTemplate, ctx: PrintRenderContext) => string;

package/dist/types/components/print/types.d.ts

@@ -0,0 +1,346 @@
+/**
+ * 打印模板设计器 - 类型定义
+ *
+ * 涵盖：元素、模板、数据源、纸张、渲染输出等核心类型
+ * 设计原则：单一职责，所有类型在此集中定义，组件按需引用
+ */
+/** 元素类型枚举 */
+export type PrintElementType = "text" | "barcode" | "qrcode" | "image" | "line" | "rect" | "ellipse" | "table" | "datetime" | "counter" | "shape";
+/** 数据绑定来源 */
+export type PrintDataBindSource = "static" | "field" | "formula" | "system";
+/** 系统变量枚举 */
+export type PrintSystemVar = "currentDate" | "currentTime" | "currentDateTime" | "pageNumber" | "pageCount" | "operator" | "printerName" | "templateName" | "tenantName";
+/** 条码码制 */
+export type BarcodeSymbology = "CODE128" | "CODE39" | "EAN13" | "EAN8" | "UPC_A" | "UPC_E" | "ITF14" | "MSI";
+/** 渲染输出目标 */
+export type PrintRenderTarget = "html" | "pdf" | "zpl" | "tspl";
+/** 长度单位 */
+export type PrintUnit = "mm" | "px" | "pt";
+/** 纸张方向 */
+export type PaperOrientation = "portrait" | "landscape";
+/** 文本对齐 */
+export type PrintTextAlign = "left" | "center" | "right";
+/** 文本垂直对齐 */
+export type PrintVerticalAlign = "top" | "middle" | "bottom";
+/** 字体粗细 */
+export type PrintFontWeight = "normal" | "bold" | "lighter" | "bolder" | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+/** 元素数据绑定 */
+export interface PrintDataBinding {
+    source: PrintDataBindSource;
+    /** 字段名（source=field 时生效） */
+    fieldName?: string;
+    /** 公式表达式（source=formula 时生效，复用 FormulaEngine 语法） */
+    formula?: string;
+    /** 系统变量（source=system 时生效） */
+    systemVar?: PrintSystemVar;
+    /** 静态值（source=static 时生效） */
+    staticValue?: string;
+    /** 数据格式化（日期/数字格式串） */
+    format?: string;
+    /** 空值替换文本 */
+    emptyText?: string;
+}
+/** 元素基础属性 */
+export interface PrintElementBase {
+    /** 元素唯一 ID */
+    id: string;
+    /** 元素类型 */
+    type: PrintElementType;
+    /** 元素名称（图层显示用） */
+    name: string;
+    /** X 坐标（单位：mm） */
+    x: number;
+    /** Y 坐标（单位：mm） */
+    y: number;
+    /** 宽度（单位：mm） */
+    width: number;
+    /** 高度（单位：mm） */
+    height: number;
+    /** 旋转角度（0-359） */
+    rotation?: number;
+    /** 是否锁定 */
+    locked?: boolean;
+    /** 是否可见 */
+    visible?: boolean;
+    /** 透明度 0-1 */
+    opacity?: number;
+    /** Z 层级 */
+    zIndex?: number;
+    /** 数据绑定 */
+    dataBinding?: PrintDataBinding;
+    /** 自定义样式（透传到渲染器） */
+    style?: PrintElementStyle;
+}
+/** 元素样式 */
+export interface PrintElementStyle {
+    /** 字体族 */
+    fontFamily?: string;
+    /** 字号（pt） */
+    fontSize?: number;
+    /** 字重 */
+    fontWeight?: PrintFontWeight;
+    /** 字体颜色 */
+    color?: string;
+    /** 背景色 */
+    backgroundColor?: string;
+    /** 文本水平对齐 */
+    textAlign?: PrintTextAlign;
+    /** 文本垂直对齐 */
+    verticalAlign?: PrintVerticalAlign;
+    /** 行高（倍数） */
+    lineHeight?: number;
+    /** 字间距（px） */
+    letterSpacing?: number;
+    /** 是否斜体 */
+    italic?: boolean;
+    /** 是否下划线 */
+    underline?: boolean;
+    /** 是否删除线 */
+    lineThrough?: boolean;
+    /** 是否自动换行 */
+    wordWrap?: boolean;
+    /** 是否溢出隐藏 */
+    overflowHidden?: boolean;
+    /** 边框（css border 字符串） */
+    border?: string;
+    /** 圆角 */
+    borderRadius?: number;
+    /** 内边距 */
+    padding?: number | [number, number, number, number];
+}
+/** 文本元素 */
+export interface PrintTextElement extends PrintElementBase {
+    type: "text";
+}
+/** 日期时间元素 */
+export interface PrintDateTimeElement extends PrintElementBase {
+    type: "datetime";
+    /** 日期格式 */
+    dateFormat: string;
+}
+/** 计数器元素（页码/序号） */
+export interface PrintCounterElement extends PrintElementBase {
+    type: "counter";
+    /** 起始值 */
+    startValue: number;
+    /** 步长 */
+    step: number;
+    /** 是否每页重置 */
+    resetPerPage: boolean;
+}
+/** 条码元素 */
+export interface PrintBarcodeElement extends PrintElementBase {
+    type: "barcode";
+    /** 码制 */
+    symbology: BarcodeSymbology;
+    /** 是否显示文本 */
+    displayText: boolean;
+    /** 条码颜色 */
+    barColor: string;
+    /** 背景色 */
+    bgColor: string;
+    /** 模块宽度（px） */
+    moduleWidth: number;
+    /** 高度（px） */
+    barHeight: number;
+}
+/** 二维码元素 */
+export interface PrintQrcodeElement extends PrintElementBase {
+    type: "qrcode";
+    /** 纠错等级 L/M/Q/H */
+    errorCorrectionLevel: "L" | "M" | "Q" | "H";
+    /** 颜色 */
+    color: string;
+    /** 背景色 */
+    bgColor: string;
+    /** 边距 */
+    margin: number;
+}
+/** 图片元素 */
+export interface PrintImageElement extends PrintElementBase {
+    type: "image";
+    /** 图片 URL 或 base64 */
+    src: string;
+    /** 适配模式 */
+    fitMode: "fill" | "contain" | "cover" | "none";
+}
+/** 直线元素 */
+export interface PrintLineElement extends PrintElementBase {
+    type: "line";
+    /** 线宽 */
+    strokeWidth: number;
+    /** 线型 */
+    lineStyle: "solid" | "dashed" | "dotted";
+    /** 颜色 */
+    color: string;
+}
+/** 矩形元素 */
+export interface PrintRectElement extends PrintElementBase {
+    type: "rect";
+    /** 边框宽度 */
+    strokeWidth: number;
+    /** 边框颜色 */
+    strokeColor: string;
+    /** 填充色 */
+    fillColor: string;
+    /** 圆角 */
+    radius: number;
+}
+/** 椭圆元素 */
+export interface PrintEllipseElement extends PrintElementBase {
+    type: "ellipse";
+    strokeWidth: number;
+    strokeColor: string;
+    fillColor: string;
+}
+/** 表格列定义 */
+export interface PrintTableColumn {
+    /** 字段名 */
+    field: string;
+    /** 列标题 */
+    title: string;
+    /** 列宽（mm） */
+    width: number;
+    /** 对齐方式 */
+    align: PrintTextAlign;
+    /** 数据格式化 */
+    format?: string;
+    /** 是否合计 */
+    summary?: boolean;
+    /** 合计类型 */
+    summaryType?: "sum" | "avg" | "count" | "max" | "min";
+}
+/** 表格元素 */
+export interface PrintTableElement extends PrintElementBase {
+    type: "table";
+    /** 列定义 */
+    columns: PrintTableColumn[];
+    /** 数据集字段名（绑定到模板数据源中的某个数组字段） */
+    dataField: string;
+    /** 是否显示表头 */
+    showHeader: boolean;
+    /** 是否显示边框 */
+    showBorder: boolean;
+    /** 行高（mm） */
+    rowHeight: number;
+    /** 表头背景色 */
+    headerBgColor: string;
+}
+/** 联合元素类型 */
+export type PrintElement = PrintTextElement | PrintDateTimeElement | PrintCounterElement | PrintBarcodeElement | PrintQrcodeElement | PrintImageElement | PrintLineElement | PrintRectElement | PrintEllipseElement | PrintTableElement;
+/** 纸张定义 */
+export interface PrintPaper {
+    /** 纸张名称 */
+    name: string;
+    /** 宽度（mm） */
+    width: number;
+    /** 高度（mm） */
+    height: number;
+    /** 方向 */
+    orientation: PaperOrientation;
+    /** 边距（mm）：[上, 右, 下, 左] */
+    margin: [number, number, number, number];
+    /** 是否自定义尺寸 */
+    custom?: boolean;
+}
+/** 数据字段定义 */
+export interface PrintDataField {
+    /** 字段名 */
+    name: string;
+    /** 字段标签 */
+    label: string;
+    /** 字段类型 */
+    type: "string" | "number" | "date" | "boolean" | "object" | "array";
+    /** 示例值 */
+    sample?: any;
+    /** 子字段（type=array/object 时） */
+    children?: PrintDataField[];
+}
+/** 数据源定义 */
+export interface PrintDataSource {
+    /** 数据源 ID */
+    id: string;
+    /** 名称 */
+    name: string;
+    /** 类型 */
+    type: "static" | "api" | "sql" | "form";
+    /** API URL */
+    apiUrl?: string;
+    /** SQL 语句 */
+    sql?: string;
+    /** 表单 ID */
+    formId?: string;
+    /** 静态数据 */
+    staticData?: any;
+    /** 字段列表 */
+    fields: PrintDataField[];
+}
+/** 打印模板 */
+export interface PrintTemplate {
+    /** 模板 ID */
+    id: string;
+    /** 模板名称 */
+    name: string;
+    /** 模板编码 */
+    code: string;
+    /** 分类 */
+    category?: string;
+    /** 描述 */
+    description?: string;
+    /** 纸张配置 */
+    paper: PrintPaper;
+    /** 元素列表 */
+    elements: PrintElement[];
+    /** 数据源列表 */
+    dataSources: PrintDataSource[];
+    /** 创建时间 */
+    createTime?: number;
+    /** 更新时间 */
+    updateTime?: number;
+    /** 创建人 */
+    creator?: string;
+    /** 版本号 */
+    version?: number;
+}
+/** 设计器状态 */
+export interface PrintDesignerState {
+    /** 当前模板 */
+    template: PrintTemplate;
+    /** 选中元素 ID 列表 */
+    selectedIds: string[];
+    /** 复制剪贴板 */
+    clipboard: PrintElement[];
+    /** 历史记录 */
+    history: PrintTemplate[];
+    /** 历史指针 */
+    historyIndex: number;
+    /** 缩放比例 */
+    zoom: number;
+    /** 是否显示标尺 */
+    showRuler: boolean;
+    /** 是否显示网格 */
+    showGrid: boolean;
+    /** 是否吸附 */
+    snap: boolean;
+    /** 吸附阈值（mm） */
+    snapThreshold: number;
+    /** 是否只读 */
+    readonly: boolean;
+}
+/** 渲染上下文（运行时数据 + 系统变量） */
+export interface PrintRenderContext {
+    /** 当前页码 */
+    pageNumber: number;
+    /** 总页数 */
+    pageCount: number;
+    /** 操作员 */
+    operator: string;
+    /** 打印机名称 */
+    printerName: string;
+    /** 租户名 */
+    tenantName: string;
+    /** 模板数据（按数据源 ID 索引） */
+    data: Record<string, any>;
+    /** 渲染时间戳 */
+    renderTime: number;
+}

package/dist/types/components/report/CellUtils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 单元格地址工具
+ *
+ * 职责：A1/B2/AA10 等地址与 {row,col} 互转、区域解析、地址生成
+ * 单一职责：纯函数，无状态
+ */
+/** 列号转字母（1→A, 27→AA） */
+export declare const colToLetter: (col: number) => string;
+/** 字母转列号（A→1, AA→27） */
+export declare const letterToCol: (letter: string) => number;
+/** 行列号转地址（1,1 → "A1"） */
+export declare const toAddress: (row: number, col: number) => string;
+/** 地址转行列号（"A1" → {row:1, col:1}） */
+export declare const fromAddress: (address: string) => {
+    row: number;
+    col: number;
+};
+/** 解析区域字符串（"A1:B10" → {start, end}） */
+export declare const parseRange: (range: string) => {
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+};
+/** 区域转地址数组 */
+export declare const rangeToAddresses: (range: string) => string[];
+/** 获取区域内所有单元格地址（行列范围版） */
+export declare const getRangeAddresses: (startRow: number, startCol: number, endRow: number, endCol: number) => string[];
+/** 检查地址是否在区域内 */
+export declare const isAddressInRange: (address: string, startRow: number, startCol: number, endRow: number, endCol: number) => boolean;
+/** 生成区域字符串 */
+export declare const toRange: (startRow: number, startCol: number, endRow: number, endCol: number) => string;
+/** 偏移地址 */
+export declare const offsetAddress: (address: string, rowOffset: number, colOffset: number) => string;

package/dist/types/components/report/ReportDesigner.vue.d.ts

@@ -0,0 +1,18 @@
+import type { ReportTemplate } from "./types";
+type __VLS_Props = {
+    template?: ReportTemplate;
+    initialTemplate?: Partial<ReportTemplate>;
+    readonly?: boolean;
+    operator?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    save: (v: ReportTemplate) => any;
+    preview: (v: ReportTemplate) => any;
+    "update:template": (v: ReportTemplate) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSave?: (v: ReportTemplate) => any;
+    onPreview?: (v: ReportTemplate) => any;
+    "onUpdate:template"?: (v: ReportTemplate) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;