@worm-vue3-print/core 1.2.0 → 1.2.2

package/dist/designer/index.d.cts

@@ -0,0 +1,652 @@
+import { TemplateEngine, formatMoney, ifFn, formatDate, toUpperCaseAmount } from '../index.cjs';
+import '../types-BGBAbQD5.cjs';
+
+/** 纸张尺寸 */
+type PaperSize = 'A4' | 'A3' | 'A5' | 'Letter' | 'Legal' | 'CUSTOM';
+/** 元素所属区域（运行时标记，序列化时剥离；区域元素 left/top 相对所在区域左上角，单位 pt） */
+type ElementZone = 'content' | 'header' | 'footer';
+/** 元素分页属性（非表格元素） */
+interface PaginationConfig {
+    pageable: boolean;
+    keepWithNext: boolean;
+}
+/** 表格分页配置 */
+interface TablePaginationConfig {
+    enabled: boolean;
+}
+/** 新模板数据模型（替代旧 PrintPanel / PrintTemplateJson） */
+interface TemplateData {
+    paperSize: PaperSize;
+    orientation: 'portrait' | 'landscape';
+    margins: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    header: {
+        height: number;
+        elements: TemplateElement[];
+    };
+    footer: {
+        height: number;
+        elements: TemplateElement[];
+    };
+    firstPageOverlay: {
+        height: number;
+        elements: TemplateElement[];
+    };
+    elements: TemplateElement[];
+    /** 元素坐标单位（新保存模板固定 'mm'；旧数据无此字段按 pt 迁移） */
+    unit?: 'pt' | 'mm';
+    /** 自定义纸张宽度（mm），仅 paperSize='CUSTOM' 时有效 */
+    customWidth?: number;
+    /** 自定义纸张高度（mm），仅 paperSize='CUSTOM' 时有效 */
+    customHeight?: number;
+    /** 页面（纸张）背景色；未设置时默认白色 */
+    pageBackground?: string;
+    /** 水印配置 */
+    watermark?: WatermarkOptions;
+    /** 手动参考线（设计态辅助，序列化保留，渲染端忽略） */
+    guides?: AlignLine[];
+}
+/** 模板元素引用（用于 TemplateData 各区域） */
+type TemplateElement = PrintElementData;
+/** 元素类型 */
+type ElementType = 'text' | 'image' | 'longText' | 'table' | 'hline' | 'vline' | 'rect' | 'oval' | 'barcode' | 'qrcode' | 'html' | 'pageNumber';
+/** 对齐方式 */
+type TextAlign = 'left' | 'center' | 'right';
+/** 垂直对齐方式（文本类元素，未设置时按顶部处理，与打印端一致） */
+type VerticalAlign = 'top' | 'middle' | 'bottom';
+/** 缩放手柄方向 */
+type ResizePoint = 'nw' | 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w';
+/** 引导线 */
+interface AlignLine {
+    type: 'vertical' | 'horizontal';
+    position: number;
+    id?: string;
+    /** 引导线颜色(区分左/中/右对齐类型) */
+    color?: string;
+}
+/** 吸附结果 */
+interface AdsorbResult {
+    left: number;
+    top: number;
+    lines: AlignLine[];
+}
+/** 元素矩形（用于吸附检测） */
+interface ElementRect {
+    id: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** 表格行类型：header 标题 / data 数据（全表唯一） / subtotal 当前页小计（每页末尾） / summary 整表汇总 */
+type TableRowType = 'header' | 'data' | 'subtotal' | 'summary';
+/** 单边边框样式 */
+interface TableCellBorder {
+    width: number;
+    style: 'solid' | 'dashed' | 'dotted' | 'double' | 'none';
+    color: string;
+}
+/** 四边边框 */
+interface TableCellBorders {
+    top?: TableCellBorder;
+    right?: TableCellBorder;
+    bottom?: TableCellBorder;
+    left?: TableCellBorder;
+}
+/** 单元格内容类型 */
+type TableCellType = 'text' | 'barcode' | 'qrcode' | 'image';
+/** 单元格 */
+interface TableCell {
+    id: string;
+    formatter?: string;
+    cellType?: TableCellType;
+    barcodeType?: string;
+    qrCodeLevel?: string;
+    showBarcodeText?: boolean;
+    rowspan?: number;
+    colspan?: number;
+    merged?: boolean;
+    align?: TextAlign;
+    valign?: 'top' | 'middle' | 'bottom';
+    fontFamily?: string;
+    fontSize?: number;
+    fontWeight?: string;
+    color?: string;
+    backgroundColor?: string;
+    borders?: TableCellBorders;
+    padding?: number;
+    wordWrap?: boolean;
+    fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
+    maxWidth?: number;
+    maxHeight?: number;
+}
+/** 表格行 */
+interface TableRow {
+    id: string;
+    type: TableRowType;
+    height: number;
+    repeatOnPage?: boolean;
+    cells: TableCell[];
+}
+/** 单元格选区（r/c 均为 0 基，闭区间） */
+interface TableSelection {
+    elementId: string;
+    r1: number;
+    c1: number;
+    r2: number;
+    c2: number;
+}
+/** 表格历史字段绑定（兼容存量模板，实际取 fields[0].dataSource） */
+interface ElementFieldBinding {
+    text?: string;
+    dataSource?: string;
+}
+/** 元素选项（序列化到 JSON） */
+interface ElementOptions {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    /** @deprecated 统一使用 formatter */
+    title?: string;
+    testData?: string;
+    fontSize?: number;
+    fontWeight?: string;
+    fontFamily?: string;
+    color?: string;
+    backgroundColor?: string;
+    textAlign?: TextAlign;
+    verticalAlign?: VerticalAlign;
+    lineHeight?: number;
+    letterSpacing?: number;
+    fixed?: boolean;
+    locked?: boolean;
+    /** 元素可见性（图层面板切换） */
+    visible?: boolean;
+    borderWidth?: number;
+    borderStyle?: string;
+    borderColor?: string;
+    contentPaddingLeft?: number;
+    contentPaddingTop?: number;
+    contentPaddingRight?: number;
+    contentPaddingBottom?: number;
+    textDecoration?: string;
+    textType?: 'barcode' | 'qrcode';
+    barcodeType?: string;
+    barWidth?: number;
+    barAutoWidth?: string;
+    qrCodeLevel?: string;
+    src?: string;
+    fit?: string;
+    hideTitle?: boolean;
+    draggable?: boolean;
+    axis?: string;
+    transform?: number;
+    zIndex?: number;
+    groupId?: string;
+    pagination?: PaginationConfig;
+    tablePagination?: TablePaginationConfig;
+    /** @deprecated 静态布局模式已移除，所有表格统一使用动态模式 */
+    tableMode?: 'dynamic' | 'static';
+    tableRows?: TableRow[];
+    tableColWidths?: number[];
+    tableDefaultFontSize?: number;
+    tableDefaultColor?: string;
+    tableDefaultPadding?: number;
+    /** 列表数据源路径（data 行迭代的数据数组） */
+    dataSource?: string;
+    /** @deprecated 兼容存量表格模型；列表数据源优先使用 dataSource */
+    fields?: ElementFieldBinding[];
+    formatter?: string;
+    styler?: string;
+    rowStyler?: string;
+    longTextIndent?: number;
+    leftSpaceRemoved?: boolean;
+    lHeight?: number;
+}
+/** 元素类型元数据 */
+interface PrintElementTypeMeta {
+    title?: string;
+    type: ElementType;
+    editable?: boolean;
+    formatter?: string;
+    styler?: string;
+}
+/** 序列化元素数据 */
+interface PrintElementData {
+    id?: string;
+    type?: ElementType;
+    options: ElementOptions;
+    printElementType: PrintElementTypeMeta;
+}
+/** 水印配置 */
+interface WatermarkOptions {
+    /** 水印模式：fixed=固定文本，binding=绑定字段 */
+    mode?: 'fixed' | 'binding';
+    /** 固定文本（mode=fixed 时使用） */
+    content?: string;
+    /** 绑定字段（mode=binding 时使用） */
+    binding?: string;
+    /** 测试值（设计态预览使用） */
+    testData?: string;
+    /** 旋转角度 */
+    rotate?: number;
+    /** 颜色 */
+    color?: string;
+    /** 透明度 */
+    opacity?: number;
+    /** 显示时间戳 */
+    timestamp?: boolean;
+    /** 时间格式 */
+    format?: string;
+}
+/** 运行时元素（设计器中带状态） */
+interface RuntimeElement {
+    id: string;
+    options: ElementOptions;
+    printElementType: PrintElementTypeMeta;
+    selected?: boolean;
+    /** 运行时所属区域，序列化时剥离，缺省视为 content */
+    zone?: ElementZone;
+}
+/** 业务字段（宿主查询后传入，核心不内置字段字典） */
+interface PrintBusinessField {
+    id?: string;
+    fieldKey: string;
+    fieldLabel: string;
+    /** 字段类型；'list' 表示明细列表字段（用于表格数据源选择） */
+    fieldType: string;
+    sortOrder: number;
+}
+/**
+ * 绑定位置描述（用于属性面板自动渲染绑定控件）
+ */
+interface BindingDescriptor {
+    /** 绑定的属性路径（如 'options.formatter'、'options.tableRows[0].cells[0].formatter'） */
+    targetPath: string;
+    /** 显示名称 */
+    label: string;
+    /** 数据源上下文 */
+    dataSource: 'main' | 'list' | 'subtotal' | 'summary';
+    /** 绑定的列表字段（仅表格行需要） */
+    listField?: string;
+    /** 提示文本 */
+    placeholder?: string;
+    /** 是否允许清空 */
+    clearable?: boolean;
+}
+/** 截图请求载荷（设计器叠层对比用） */
+interface ScreenshotRequest {
+    templateJson: TemplateData;
+    printData: Record<string, any>;
+}
+/** 截图适配器：宿主依据模板 + 数据返回 PNG Blob */
+type RequestScreenshotFn = (req: ScreenshotRequest) => Promise<Blob>;
+/** 图片上传适配器：宿主上传文件并返回可访问的图片 URL */
+type UploadImageFn = (file: File) => Promise<string>;
+
+/** pt 转 mm */
+declare function ptToMm(pt: number): number;
+/** px 转 mm（基于 96dpi 屏幕） */
+declare function pxToMm(px: number): number;
+/** mm 转 px（基于 96dpi 屏幕） */
+declare function mmToPx(mm: number): number;
+
+/** 最小缩放百分比,低于此值画布难以查看与操作;放大方向不设上限 */
+declare const MIN_SCALE_PERCENT = 25;
+/** 适应窗口时允许的最小缩放百分比（可低于交互缩放下限，保证超大纸张也能整版容纳） */
+declare const FIT_SCALE_MIN_PERCENT = 5;
+/** 将缩放百分比钳制到允许范围:仅保留下限,放大不设上限 */
+declare function clampScalePercent(percent: number): number;
+/**
+ * 滚轮缩放:乘性步进(默认 ×1.1 / ÷1.1),大倍数下仍保持平滑手感,
+ * 返回取整后的百分比,避免浮点累加产生脏显示(如 110.00000001)
+ * @param percent 当前缩放百分比
+ * @param direction 1 放大,-1 缩小
+ */
+declare function nextWheelScale(percent: number, direction: 1 | -1, factor?: number): number;
+/** 计算适应窗口的缩放百分比,允许小于交互缩放下限,保证整版纸张可见 */
+declare function computeFitScale(containerW: number, containerH: number, paperW: number, paperH: number, ratio?: number): number;
+
+declare function normalizeTemplateUnits(data: TemplateData): TemplateData;
+
+declare const PAPER_PRESETS: Record<string, {
+    width: number;
+    height: number;
+}>;
+/**
+ * 获取纸张原始宽高（mm，未应用方向）
+ * CUSTOM 时读取 customWidth/customHeight，缺省回退 A4
+ */
+declare function getPaperDimensions(t: Pick<TemplateData, 'paperSize' | 'orientation' | 'customWidth' | 'customHeight'>): {
+    width: number;
+    height: number;
+};
+
+interface CellRect {
+    r1: number;
+    c1: number;
+    r2: number;
+    c2: number;
+}
+declare function createCell(partial?: Partial<TableCell>): TableCell;
+/** 默认新建表格：3 列 × 4 行（标题/数据/小计/汇总），列宽均分 50mm，表格组件默认显示当前页小计行 */
+declare function createDefaultTable(): {
+    rows: TableRow[];
+    colWidths: number[];
+};
+/** 定位覆盖 (r,c) 的主格坐标（自身非 merged 即为主格） */
+declare function findMainCell(rows: TableRow[], r: number, c: number): {
+    r: number;
+    c: number;
+};
+/** 主格覆盖矩形 */
+declare function getSpanRect(rows: TableRow[], r: number, c: number): CellRect;
+/** 由锚点/焦点推导矩形选区，并迭代扩展至完整包含所有跨越的合并格 */
+declare function normalizeSelection(rows: TableRow[], a: {
+    r: number;
+    c: number;
+}, b: {
+    r: number;
+    c: number;
+}): CellRect;
+/** 合并合法性校验，返回拒绝原因或 null */
+declare function canMergeReason(rows: TableRow[], rect: CellRect): string | null;
+/** 合并：左上为主格，非空内容空格拼接并入主格 */
+declare function mergeCells(rows: TableRow[], rect: CellRect): void;
+/** 拆分选区内所有合并格：占位格恢复并复制主格样式 */
+declare function splitCells(rows: TableRow[], rect: CellRect): void;
+/** 插入行。index 为参照行，position 决定插在其上方或下方 */
+declare function insertRow(rows: TableRow[], index: number, position: 'above' | 'below'): void;
+/** 删除行；主格在被删行时移交下一行 */
+declare function deleteRow(rows: TableRow[], index: number): string | null;
+/** 插入列 */
+declare function insertCol(rows: TableRow[], colWidths: number[], index: number, position: 'left' | 'right'): void;
+/** 删除列；主格在被删列时移交右侧列 */
+declare function deleteCol(rows: TableRow[], colWidths: number[], index: number): string | null;
+/** 行类型变更校验 + 写入。约束：header 顶部连续；data 唯一；subtotal/summary 在 data 之后；subtotal 在 summary 之前 */
+declare function setRowType(rows: TableRow[], index: number, type: TableRowType): string | null;
+type BorderPreset = 'all' | 'outer' | 'inner' | 'none';
+/** 按预设批量写边框；none 时清空选区内所有格的 borders */
+declare function applyBorderPreset(rows: TableRow[], rect: CellRect, preset: BorderPreset, border: TableCellBorder): void;
+/** 设计态下无边框单元格的辅助虚线：与背景网格线同风格（浅灰虚线），略深保证可读 */
+declare const GHOST_BORDER_CSS = "1px dashed rgba(0,0,0,0.18)";
+/**
+ * 解析单元格某条边的最终 CSS border 值。
+ * - 有真实边框（style 非 none）→ 返回 `${width}pt ${style} ${color}`
+ * - 设计态且开关开启、且该边无边框 → 返回虚拟虚线（仅设计稿展示，不影响预览/打印）
+ * - 其余情况（预览态 / 开关关闭）→ 'none'
+ */
+declare function resolveCellBorderCss(b: TableCellBorder | undefined, opts?: {
+    designMode?: boolean;
+    showGhostBorder?: boolean;
+}): string;
+/** 表格元素尺寸派生：options.width/height 恒等于列宽和/行高和（mm），与渲染端一致 */
+declare function syncTableElementSize(options: ElementOptions): void;
+/** 列宽拖拽的最小列宽（mm），与属性面板列宽输入下限一致 */
+declare const MIN_COL_WIDTH_MM = 5;
+/**
+ * 列宽拖拽钳制（纯函数，不修改入参，调用方负责回写）：
+ * 返回目标列宽在 [MIN_COL_WIDTH_MM, maxTableWidth - 其余列和] 范围内的钳制值，
+ * 结果保留 0.1mm 精度。maxTableWidth 为 Infinity 时不设总宽上限。
+ */
+declare function clampResizedColumnWidth(colWidths: number[], index: number, targetMm: number, maxTableWidth: number): number;
+
+declare function generateId(): string;
+declare function createDefaultOptions(type: ElementType): ElementOptions;
+declare function createRuntimeElement(type: ElementType, options?: Partial<ElementOptions>): RuntimeElement;
+
+/** 允许放入页眉/页脚的元素类型 */
+declare const ZONE_ALLOWED_TYPES: string[];
+interface ZoneRectPt {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** 纸张宽高（mm，含方向；CUSTOM 读取 customWidth/customHeight，缺省回退 A4） */
+declare function getPaperSizeMM(t: TemplateData): {
+    width: number;
+    height: number;
+};
+/** 三区在纸面坐标系中的矩形（mm），布局：上边距→页眉→内容→页脚→下边距 */
+declare function getZoneRects(t: TemplateData): Record<ElementZone, ZoneRectPt>;
+/** 纸面 mm 坐标 → 命中区域（高度为 0 的区域不参与命中） */
+declare function zoneFromPaperPoint(t: TemplateData, _x: number, y: number): ElementZone;
+/** 将元素局部坐标 clamp 到区域矩形内（原地修改） */
+declare function clampToZone(el: RuntimeElement, zone: ZoneRectPt): void;
+/**
+ * 拖拽/缩放结束后按元素中心点归区：
+ * 跨区时换算坐标并改写 zone；页眉/页脚内 clamp；类型不允许时拒绝跨入并 clamp 回内容区。
+ */
+declare function finalizeElementZone(el: RuntimeElement, t: TemplateData): {
+    rejected: boolean;
+};
+
+/** 视口固定尺条厚度（px），CanvasArea 布局与左上角块共用 */
+declare const RULER_THICKNESS = 22;
+interface RulerTick {
+    /** 刻度在纸面坐标系上的位置（mm，可为负，表示纸张原点之外） */
+    mm: number;
+    /** 是否为主刻度（带数字标签） */
+    major: boolean;
+    label?: string;
+}
+/**
+ * 按缩放选择主刻度步长（mm）：取漂亮数序列中使屏幕间距
+ * 不小于 targetPx 的最小步长，保证任意缩放下标签不重叠
+ * @param scale 画布缩放比例（1 = 100%）
+ * @param targetPx 主刻度之间的目标屏幕间距（px）
+ */
+declare function chooseMajorStepMM(scale: number, targetPx?: number): number;
+/**
+ * 次刻度步长：5 系（5/50/500…）五等分、2 系（2/20/200…）二等分、
+ * 10 的幂从 10mm 起五等分（10→2mm、100→20mm），1mm 时无次刻度
+ */
+declare function minorStepMM(majorStepMM: number): number | null;
+/**
+ * 生成可见毫米范围内的全部刻度（升序）：
+ * 从首个对齐的次刻度开始，主刻度带数字标签
+ * @param startMM 可见范围起点（纸面坐标，可为负）
+ * @param endMM 可见范围终点
+ * @param majorStepMM 主刻度步长（由 chooseMajorStepMM 选出）
+ */
+declare function buildRulerTicks(startMM: number, endMM: number, majorStepMM: number): RulerTick[];
+
+/** 打印设计器常见预设颜色（12 色） */
+declare const PRESET_COLORS: readonly ["#000000", "#333333", "#666666", "#999999", "#cccccc", "#ffffff", "#e53935", "#fb8c00", "#1e88e5", "#43a047", "#8d6e63", "#00acc1"];
+
+/** 属性面板搜索注册表：分组 → 表单项 → 关键词 */
+interface PropertyItem {
+    key: string;
+    keywords: string[];
+}
+interface PropertyGroupDef {
+    group: string;
+    groupLabel: string;
+    items: PropertyItem[];
+}
+declare const PROPERTY_REGISTRY: PropertyGroupDef[];
+/** 正向包含匹配：任一关键词包含搜索词即命中；空搜索恒命中 */
+declare function matchKeywords(search: string, keywords: string[]): boolean;
+/** 计算命中的分组与表单项 key 集合 */
+declare function searchProperties(search: string): {
+    groups: string[];
+    itemKeys: Set<string>;
+};
+
+interface FieldGroup {
+    /** 分组键（fieldKey 首段）；空串表示无分组的顶层字段 */
+    key: string;
+    /** 分组显示名：取容器字段的 fieldLabel，缺省回退为 key */
+    label: string;
+    /** 是否明细列表分组（容器字段 fieldType === 'list'） */
+    isList: boolean;
+    /** 分组下的叶子字段 */
+    fields: PrintBusinessField[];
+}
+/**
+ * 将宿主扁平字段按 fieldKey 首段分组：
+ * - 带点路径（supplier.name、goods.spec）归入首段分组；
+ * - 无点且作为其它字段前缀的记录视为分组容器（如 supplier/goods），
+ *   容器提供分组名称，fieldType='list' 标识明细列表（表格数据源）；
+ * - 无点且无子字段的记录作为独立顶层字段。
+ */
+declare function groupFields(fields: PrintBusinessField[]): FieldGroup[];
+/** 按关键字过滤分组（匹配字段名/字段 key），无叶子的分组剔除 */
+declare function filterGroups(groups: FieldGroup[], keyword: string): FieldGroup[];
+
+/**
+ * 元素绑定声明注册表
+ * 每个元素类型声明其支持的 formatter 绑定位置
+ */
+declare const ELEMENT_BINDING_REGISTRY: Record<string, BindingDescriptor[]>;
+declare function getTableCellBindings(rowType: string, rowIndex: number, cellIndex: number, listField?: string): BindingDescriptor[];
+declare function getElementBindings(element: any): BindingDescriptor[];
+
+declare function getDemoData(): Record<string, any>;
+declare const DEFAULT_DEMO_DATA: Record<string, any>;
+
+declare const engine: TemplateEngine;
+
+declare const EXTENDED_FUNCTIONS: {
+    MONEY: typeof formatMoney;
+    CONCAT: (...args: any[]) => string;
+    IF: typeof ifFn;
+    FORMAT: (value: any) => string;
+    SUBSTR: (str: string, start: number, len?: number) => string;
+    LEN: (str: string) => number;
+    ROUND: (num: number, decimals: number) => number;
+    NOW: () => string;
+    IFEMPTY: (value: any, defaultVal: string) => string;
+    PAD: (value: any, len: number, char: string) => string;
+    REPLACE: (str: string, from: string, to: string) => string;
+    JSON: (value: any) => string;
+    DATE: typeof formatDate;
+    UPPER: typeof toUpperCaseAmount;
+};
+/**
+ * 在受限沙箱内求值表达式
+ * @param expr 表达式字符串
+ * @param context 上下文变量
+ * @param _callableNames 保留参数，实际使用共享引擎
+ */
+declare function safeEval(expr: string, context: Record<string, any>, _callableNames?: string[]): any;
+/**
+ * 模板字符串求值：{表达式} 内 safeEval 求值，外为字面文本。
+ * 聚合函数 SUM/AVG/COUNT/MIN/MAX(field) 预处理（需 ctx.rows）。
+ * 单个 {expr} 求值失败时保留原 {expr} 文本。
+ */
+declare function evaluateTemplate(text: string, ctx: Record<string, any>): string;
+
+/** 从业务字段创建带 formatter 绑定的文本元素 */
+declare function createFieldElement(field: {
+    fieldKey: string;
+    fieldLabel: string;
+}): RuntimeElement;
+/** 非设计态文本内容解析：用共享引擎渲染 formatter */
+declare function resolveTextBinding(options: {
+    formatter?: string;
+}, data?: Record<string, any>[]): string;
+/**
+ * 设计态条码/二维码单元格取值：{field} 占位符替换为 demo 数据
+ * （列表字段取数据源首项，全局字段按路径取），无匹配回退通用示例码值
+ */
+declare function resolveBarcodeDesignValue(formatter: string | undefined, listSource?: Record<string, any>[]): string;
+
+interface AdsorbConfig {
+    adsorbMin?: number;
+    adsorbLineMin?: number;
+    showAdsorbLine?: boolean;
+}
+/** 手动参考线（mm） */
+interface ManualGuides {
+    vertical: number[];
+    horizontal: number[];
+}
+/**
+ * 计算拖动元素的吸附结果（新坐标 + 引导线）。
+ * @param movingRect 拖动元素矩形
+ * @param others 其他参与吸附的元素矩形
+ * @param manualGuides 手动参考线（可选）
+ * @param config 吸附阈值配置
+ */
+declare function computeAdsorb(movingRect: ElementRect, others: ElementRect[], manualGuides?: ManualGuides, config?: AdsorbConfig): AdsorbResult;
+
+type AlignMode = 'left' | 'right' | 'top' | 'bottom' | 'vertical' | 'horizontal' | 'distributeHor' | 'distributeVer';
+declare function useAlign(): {
+    align: (elements: RuntimeElement[], mode: AlignMode) => void;
+};
+
+declare function generateGroupId(): string;
+declare function useGroup(): {
+    group: (elements: RuntimeElement[], selectedIds: Set<string>) => RuntimeElement[];
+    ungroup: (elements: RuntimeElement[], selectedIds: Set<string>) => RuntimeElement[];
+    getGroupedIds: (elements: RuntimeElement[], selectedId: string) => Set<string>;
+};
+
+interface KeyboardHandlers {
+    onMove?: (dx: number, dy: number) => void;
+    onDelete?: () => void;
+    onCopy?: () => void;
+    onPaste?: () => void;
+    onSelectAll?: () => void;
+    onUndo?: () => void;
+    onRedo?: () => void;
+    onDuplicate?: () => void;
+    onResetZoom?: () => void;
+    onAlignLeft?: () => void;
+    onAlignRight?: () => void;
+    onAlignCenterH?: () => void;
+    onAlignTop?: () => void;
+    onAlignBottom?: () => void;
+    onGroup?: () => void;
+    onUngroup?: () => void;
+}
+declare function useKeyboard(handlers: KeyboardHandlers): {
+    setup: () => void;
+    cleanup: () => void;
+};
+
+interface ResizeRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+interface ResizeOptions {
+    minWidth?: number;
+    minHeight?: number;
+    getScale?: () => number;
+    /** 缩放起始时读取元素当前矩形（mm） */
+    getRect: () => ResizeRect;
+    onResize: (rect: ResizeRect) => void;
+    onStart?: () => void;
+    onStop?: () => void;
+}
+/** 8 方位缩放手柄，供模板 v-for 渲染 */
+declare const RESIZE_POINTS: ResizePoint[];
+/** 根据方位与位移计算缩放后矩形（纯函数） */
+declare function calcResizeRect(point: ResizePoint, startRect: ResizeRect, dx: number, dy: number, minW: number, minH: number): ResizeRect;
+/** 缩放交互逻辑：手柄由组件模板渲染，mousedown 时调用 startResize */
+declare function useResize(options: ResizeOptions): {
+    startResize: (point: ResizePoint, e: MouseEvent) => void;
+    cleanup: () => void;
+};
+
+interface BindingDisplayState {
+    status: 'unbound' | 'bound' | 'warning' | 'error';
+    badge: string;
+    badgeColor: string;
+    demoPreview: string;
+    warning?: string;
+}
+declare function useBindingDisplay(): {
+    getBindingDisplayState: (element: any) => BindingDisplayState;
+};
+
+export { type AdsorbConfig, type AdsorbResult, type AlignLine, type AlignMode, type BindingDescriptor, type BorderPreset, type CellRect, DEFAULT_DEMO_DATA, ELEMENT_BINDING_REGISTRY, EXTENDED_FUNCTIONS, type ElementFieldBinding, type ElementOptions, type ElementRect, type ElementType, type ElementZone, FIT_SCALE_MIN_PERCENT, type FieldGroup, GHOST_BORDER_CSS, type KeyboardHandlers, MIN_COL_WIDTH_MM, MIN_SCALE_PERCENT, type ManualGuides, PAPER_PRESETS, PRESET_COLORS, PROPERTY_REGISTRY, type PaginationConfig, type PaperSize, type PrintBusinessField, type PrintElementData, type PrintElementTypeMeta, type PropertyGroupDef, type PropertyItem, RESIZE_POINTS, RULER_THICKNESS, type RequestScreenshotFn, type ResizeOptions, type ResizePoint, type ResizeRect, type RulerTick, type RuntimeElement, type ScreenshotRequest, type TableCell, type TableCellBorder, type TableCellBorders, type TableCellType, type TablePaginationConfig, type TableRow, type TableRowType, type TableSelection, type TemplateData, type TemplateElement, type TextAlign, type UploadImageFn, type VerticalAlign, type WatermarkOptions, ZONE_ALLOWED_TYPES, type ZoneRectPt, applyBorderPreset, buildRulerTicks, calcResizeRect, canMergeReason, chooseMajorStepMM, clampResizedColumnWidth, clampScalePercent, clampToZone, computeAdsorb, computeFitScale, createCell, createDefaultOptions, createDefaultTable, createFieldElement, createRuntimeElement, deleteCol, deleteRow, engine, evaluateTemplate, filterGroups, finalizeElementZone, findMainCell, generateGroupId, generateId, getDemoData, getElementBindings, getPaperDimensions, getPaperSizeMM, getSpanRect, getTableCellBindings, getZoneRects, groupFields, insertCol, insertRow, matchKeywords, mergeCells, minorStepMM, mmToPx, nextWheelScale, normalizeSelection, normalizeTemplateUnits, ptToMm, pxToMm, resolveBarcodeDesignValue, resolveCellBorderCss, resolveTextBinding, safeEval, searchProperties, setRowType, splitCells, syncTableElementSize, useAlign, useBindingDisplay, useGroup, useKeyboard, useResize, zoneFromPaperPoint };