@worm-vue3-print/canvas 1.2.0 → 1.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worm-vue3-print/canvas",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "type": "module",
   "description": "Vue 3 可视化打印模板设计器画布（开源核心，无 Element Plus、无宿主业务依赖）",
   "main": "./dist/index.cjs",

package/dist/composables/useAlign.d.ts

@@ -1,5 +0,0 @@
-import type { RuntimeElement } from '../types';
-export type AlignMode = 'left' | 'right' | 'top' | 'bottom' | 'vertical' | 'horizontal' | 'distributeHor' | 'distributeVer';
-export declare function useAlign(): {
-    align: (elements: RuntimeElement[], mode: AlignMode) => void;
-};

package/dist/composables/useBindingDisplay.d.ts

@@ -1,11 +0,0 @@
-interface BindingDisplayState {
-    status: 'unbound' | 'bound' | 'warning' | 'error';
-    badge: string;
-    badgeColor: string;
-    demoPreview: string;
-    warning?: string;
-}
-export declare function useBindingDisplay(): {
-    getBindingDisplayState: (element: any) => BindingDisplayState;
-};
-export {};

package/dist/composables/useGroup.d.ts

@@ -1,7 +0,0 @@
-import type { RuntimeElement } from '../types';
-export declare function generateGroupId(): string;
-export declare function useGroup(): {
-    group: (elements: RuntimeElement[], selectedIds: Set<string>) => RuntimeElement[];
-    ungroup: (elements: RuntimeElement[], selectedIds: Set<string>) => RuntimeElement[];
-    getGroupedIds: (elements: RuntimeElement[], selectedId: string) => Set<string>;
-};

package/dist/composables/useKeyboard.d.ts

@@ -1,22 +0,0 @@
-export 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;
-}
-export declare function useKeyboard(handlers: KeyboardHandlers): {
-    setup: () => void;
-    cleanup: () => void;
-};

package/dist/composables/useResize.d.ts

@@ -1,26 +0,0 @@
-import type { ResizePoint } from '../types';
-export interface ResizeRect {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-}
-export interface ResizeOptions {
-    minWidth?: number;
-    minHeight?: number;
-    getScale?: () => number;
-    /** 缩放起始时读取元素当前矩形（mm） */
-    getRect: () => ResizeRect;
-    onResize: (rect: ResizeRect) => void;
-    onStart?: () => void;
-    onStop?: () => void;
-}
-/** 8 方位缩放手柄，供模板 v-for 渲染 */
-export declare const RESIZE_POINTS: ResizePoint[];
-/** 根据方位与位移计算缩放后矩形（纯函数） */
-export declare function calcResizeRect(point: ResizePoint, startRect: ResizeRect, dx: number, dy: number, minW: number, minH: number): ResizeRect;
-/** 缩放交互逻辑：手柄由组件模板渲染，mousedown 时调用 startResize */
-export declare function useResize(options: ResizeOptions): {
-    startResize: (point: ResizePoint, e: MouseEvent) => void;
-    cleanup: () => void;
-};

package/dist/render/browser-code-renderer.d.ts

@@ -1,3 +0,0 @@
-import type { CodeRenderer } from '@worm-vue3-print/core';
-/** 浏览器条码/二维码渲染器；码值非法或为空时抛错，由渲染管线降级文本占位 */
-export declare const browserCodeRenderer: CodeRenderer;

package/dist/render/browser-pagination.d.ts

@@ -1,17 +0,0 @@
-import type { PrintTemplateData, PageLayout, CodeRenderer } from '@worm-vue3-print/core';
-export interface BrowserRenderResult {
-    /** 最终多页 HTML 字符串 */
-    html: string;
-    /** 总页数 */
-    pageCount: number;
-    /** 分页布局（调试/高级用途） */
-    pageLayouts: PageLayout[];
-}
-/**
- * 浏览器内完成「数据绑定 → 测量 → 分页 → 最终 HTML」全流程。
- * @param template 模板 JSON（设计器 TemplateData 结构兼容）
- * @param printData 业务数据
- * @param baseUrl 图片相对路径拼接前缀
- * @param codeRenderer 条码渲染器（browserCodeRenderer）
- */
-export declare function renderHtmlPages(template: PrintTemplateData, printData?: Record<string, any> | Record<string, any>[], baseUrl?: string, codeRenderer?: CodeRenderer): Promise<BrowserRenderResult>;

package/dist/types.d.ts

@@ -1,287 +0,0 @@
-/** 纸张尺寸 */
-export type PaperSize = 'A4' | 'A3' | 'A5' | 'Letter' | 'Legal' | 'CUSTOM';
-/** 元素所属区域（运行时标记，序列化时剥离；区域元素 left/top 相对所在区域左上角，单位 pt） */
-export type ElementZone = 'content' | 'header' | 'footer';
-/** 元素分页属性（非表格元素） */
-export interface PaginationConfig {
-    pageable: boolean;
-    keepWithNext: boolean;
-}
-/** 表格分页配置 */
-export interface TablePaginationConfig {
-    enabled: boolean;
-}
-/** 新模板数据模型（替代旧 PrintPanel / PrintTemplateJson） */
-export 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 各区域） */
-export type TemplateElement = PrintElementData;
-/** 元素类型 */
-export type ElementType = 'text' | 'image' | 'longText' | 'table' | 'hline' | 'vline' | 'rect' | 'oval' | 'barcode' | 'qrcode' | 'html' | 'pageNumber';
-/** 对齐方式 */
-export type TextAlign = 'left' | 'center' | 'right';
-/** 垂直对齐方式（文本类元素，未设置时按顶部处理，与打印端一致） */
-export type VerticalAlign = 'top' | 'middle' | 'bottom';
-/** 缩放手柄方向 */
-export type ResizePoint = 'nw' | 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w';
-/** 引导线 */
-export interface AlignLine {
-    type: 'vertical' | 'horizontal';
-    position: number;
-    id?: string;
-    /** 引导线颜色(区分左/中/右对齐类型) */
-    color?: string;
-}
-/** 吸附结果 */
-export interface AdsorbResult {
-    left: number;
-    top: number;
-    lines: AlignLine[];
-}
-/** 元素矩形（用于吸附检测） */
-export interface ElementRect {
-    id: string;
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-}
-/** 表格行类型：header 标题 / data 数据（全表唯一） / subtotal 当前页小计（每页末尾） / summary 整表汇总 */
-export type TableRowType = 'header' | 'data' | 'subtotal' | 'summary';
-/** 单边边框样式 */
-export interface TableCellBorder {
-    width: number;
-    style: 'solid' | 'dashed' | 'dotted' | 'double' | 'none';
-    color: string;
-}
-/** 四边边框 */
-export interface TableCellBorders {
-    top?: TableCellBorder;
-    right?: TableCellBorder;
-    bottom?: TableCellBorder;
-    left?: TableCellBorder;
-}
-/** 单元格内容类型 */
-export type TableCellType = 'text' | 'barcode' | 'qrcode' | 'image';
-/** 单元格 */
-export 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;
-}
-/** 表格行 */
-export interface TableRow {
-    id: string;
-    type: TableRowType;
-    height: number;
-    repeatOnPage?: boolean;
-    cells: TableCell[];
-}
-/** 单元格选区（r/c 均为 0 基，闭区间） */
-export interface TableSelection {
-    elementId: string;
-    r1: number;
-    c1: number;
-    r2: number;
-    c2: number;
-}
-/** 表格历史字段绑定（兼容存量模板，实际取 fields[0].dataSource） */
-export interface ElementFieldBinding {
-    text?: string;
-    dataSource?: string;
-}
-/** 元素选项（序列化到 JSON） */
-export 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;
-}
-/** 元素类型元数据 */
-export interface PrintElementTypeMeta {
-    title?: string;
-    type: ElementType;
-    editable?: boolean;
-    formatter?: string;
-    styler?: string;
-}
-/** 序列化元素数据 */
-export interface PrintElementData {
-    id?: string;
-    type?: ElementType;
-    options: ElementOptions;
-    printElementType: PrintElementTypeMeta;
-}
-/** 水印配置 */
-export 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;
-}
-/** 运行时元素（设计器中带状态） */
-export interface RuntimeElement {
-    id: string;
-    options: ElementOptions;
-    printElementType: PrintElementTypeMeta;
-    selected?: boolean;
-    /** 运行时所属区域，序列化时剥离，缺省视为 content */
-    zone?: ElementZone;
-}
-/** 业务字段（宿主查询后传入，核心不内置字段字典） */
-export interface PrintBusinessField {
-    id?: string;
-    fieldKey: string;
-    fieldLabel: string;
-    /** 字段类型；'list' 表示明细列表字段（用于表格数据源选择） */
-    fieldType: string;
-    sortOrder: number;
-}
-/**
- * 绑定位置描述（用于属性面板自动渲染绑定控件）
- */
-export 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;
-}
-/** 截图请求载荷（设计器叠层对比用） */
-export interface ScreenshotRequest {
-    templateJson: TemplateData;
-    printData: Record<string, any>;
-}
-/** 截图适配器：宿主依据模板 + 数据返回 PNG Blob */
-export type RequestScreenshotFn = (req: ScreenshotRequest) => Promise<Blob>;
-/** 图片上传适配器：宿主上传文件并返回可访问的图片 URL */
-export type UploadImageFn = (file: File) => Promise<string>;

package/dist/utils/binding-registry.d.ts

@@ -1,8 +0,0 @@
-import type { BindingDescriptor } from '../types';
-/**
- * 元素绑定声明注册表
- * 每个元素类型声明其支持的 formatter 绑定位置
- */
-export declare const ELEMENT_BINDING_REGISTRY: Record<string, BindingDescriptor[]>;
-export declare function getTableCellBindings(rowType: string, rowIndex: number, cellIndex: number, listField?: string): BindingDescriptor[];
-export declare function getElementBindings(element: any): BindingDescriptor[];

package/dist/utils/binding.d.ts

@@ -1,16 +0,0 @@
-import type { RuntimeElement } from '../types';
-import './expression-eval';
-/** 从业务字段创建带 formatter 绑定的文本元素 */
-export declare function createFieldElement(field: {
-    fieldKey: string;
-    fieldLabel: string;
-}): RuntimeElement;
-/** 非设计态文本内容解析：用共享引擎渲染 formatter */
-export declare function resolveTextBinding(options: {
-    formatter?: string;
-}, data?: Record<string, any>[]): string;
-/**
- * 设计态条码/二维码单元格取值：{field} 占位符替换为 demo 数据
- * （列表字段取数据源首项，全局字段按路径取），无匹配回退通用示例码值
- */
-export declare function resolveBarcodeDesignValue(formatter: string | undefined, listSource?: Record<string, any>[]): string;

package/dist/utils/default-config.d.ts

@@ -1,13 +0,0 @@
-import type { TemplateData } from '../types';
-export declare const PAPER_PRESETS: Record<string, {
-    width: number;
-    height: number;
-}>;
-/**
- * 获取纸张原始宽高（mm，未应用方向）
- * CUSTOM 时读取 customWidth/customHeight，缺省回退 A4
- */
-export declare function getPaperDimensions(t: Pick<TemplateData, 'paperSize' | 'orientation' | 'customWidth' | 'customHeight'>): {
-    width: number;
-    height: number;
-};

package/dist/utils/demo-data.d.ts

@@ -1,2 +0,0 @@
-export declare function getDemoData(): Record<string, any>;
-export declare const DEFAULT_DEMO_DATA: Record<string, any>;

package/dist/utils/element-factory.d.ts

@@ -1,4 +0,0 @@
-import type { RuntimeElement, ElementType, ElementOptions } from '../types';
-export declare function generateId(): string;
-export declare function createDefaultOptions(type: ElementType): ElementOptions;
-export declare function createRuntimeElement(type: ElementType, options?: Partial<ElementOptions>): RuntimeElement;

package/dist/utils/engine.d.ts

@@ -1,2 +0,0 @@
-import { TemplateEngine } from '@worm-vue3-print/core';
-export declare const engine: TemplateEngine;

package/dist/utils/expression-eval.d.ts

@@ -1,30 +0,0 @@
-import { formatMoney, formatDate, toUpperCaseAmount, ifFn } from '@worm-vue3-print/core';
-export 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 保留参数，实际使用共享引擎
- */
-export declare function safeEval(expr: string, context: Record<string, any>, _callableNames?: string[]): any;
-/**
- * 模板字符串求值：{表达式} 内 safeEval 求值，外为字面文本。
- * 聚合函数 SUM/AVG/COUNT/MIN/MAX(field) 预处理（需 ctx.rows）。
- * 单个 {expr} 求值失败时保留原 {expr} 文本。
- */
-export declare function evaluateTemplate(text: string, ctx: Record<string, any>): string;

package/dist/utils/field-groups.d.ts

@@ -1,21 +0,0 @@
-import type { PrintBusinessField } from '../types';
-export interface FieldGroup {
-    /** 分组键（fieldKey 首段）；空串表示无分组的顶层字段 */
-    key: string;
-    /** 分组显示名：取容器字段的 fieldLabel，缺省回退为 key */
-    label: string;
-    /** 是否明细列表分组（容器字段 fieldType === 'list'） */
-    isList: boolean;
-    /** 分组下的叶子字段 */
-    fields: PrintBusinessField[];
-}
-/**
- * 将宿主扁平字段按 fieldKey 首段分组：
- * - 带点路径（supplier.name、goods.spec）归入首段分组；
- * - 无点且作为其它字段前缀的记录视为分组容器（如 supplier/goods），
- *   容器提供分组名称，fieldType='list' 标识明细列表（表格数据源）；
- * - 无点且无子字段的记录作为独立顶层字段。
- */
-export declare function groupFields(fields: PrintBusinessField[]): FieldGroup[];
-/** 按关键字过滤分组（匹配字段名/字段 key），无叶子的分组剔除 */
-export declare function filterGroups(groups: FieldGroup[], keyword: string): FieldGroup[];

package/dist/utils/migrate.d.ts

@@ -1,2 +0,0 @@
-import type { TemplateData } from '../types';
-export declare function normalizeTemplateUnits(data: TemplateData): TemplateData;

package/dist/utils/preset-colors.d.ts

@@ -1,2 +0,0 @@
-/** 打印设计器常见预设颜色（12 色） */
-export declare const PRESET_COLORS: readonly ["#000000", "#333333", "#666666", "#999999", "#cccccc", "#ffffff", "#e53935", "#fb8c00", "#1e88e5", "#43a047", "#8d6e63", "#00acc1"];

package/dist/utils/property-search.d.ts

@@ -1,18 +0,0 @@
-/** 属性面板搜索注册表：分组 → 表单项 → 关键词 */
-export interface PropertyItem {
-    key: string;
-    keywords: string[];
-}
-export interface PropertyGroupDef {
-    group: string;
-    groupLabel: string;
-    items: PropertyItem[];
-}
-export declare const PROPERTY_REGISTRY: PropertyGroupDef[];
-/** 正向包含匹配：任一关键词包含搜索词即命中；空搜索恒命中 */
-export declare function matchKeywords(search: string, keywords: string[]): boolean;
-/** 计算命中的分组与表单项 key 集合 */
-export declare function searchProperties(search: string): {
-    groups: string[];
-    itemKeys: Set<string>;
-};

package/dist/utils/ruler.d.ts

@@ -1,29 +0,0 @@
-/** 视口固定尺条厚度（px），CanvasArea 布局与左上角块共用 */
-export declare const RULER_THICKNESS = 22;
-export interface RulerTick {
-    /** 刻度在纸面坐标系上的位置（mm，可为负，表示纸张原点之外） */
-    mm: number;
-    /** 是否为主刻度（带数字标签） */
-    major: boolean;
-    label?: string;
-}
-/**
- * 按缩放选择主刻度步长（mm）：取漂亮数序列中使屏幕间距
- * 不小于 targetPx 的最小步长，保证任意缩放下标签不重叠
- * @param scale 画布缩放比例（1 = 100%）
- * @param targetPx 主刻度之间的目标屏幕间距（px）
- */
-export declare function chooseMajorStepMM(scale: number, targetPx?: number): number;
-/**
- * 次刻度步长：5 系（5/50/500…）五等分、2 系（2/20/200…）二等分、
- * 10 的幂从 10mm 起五等分（10→2mm、100→20mm），1mm 时无次刻度
- */
-export declare function minorStepMM(majorStepMM: number): number | null;
-/**
- * 生成可见毫米范围内的全部刻度（升序）：
- * 从首个对齐的次刻度开始，主刻度带数字标签
- * @param startMM 可见范围起点（纸面坐标，可为负）
- * @param endMM 可见范围终点
- * @param majorStepMM 主刻度步长（由 chooseMajorStepMM 选出）
- */
-export declare function buildRulerTicks(startMM: number, endMM: number, majorStepMM: number): RulerTick[];

package/dist/utils/scale.d.ts

@@ -1,13 +0,0 @@
-/** 最小缩放百分比,低于此值画布难以查看与操作;放大方向不设上限 */
-export declare const MIN_SCALE_PERCENT = 25;
-/** 将缩放百分比钳制到允许范围:仅保留下限,放大不设上限 */
-export declare function clampScalePercent(percent: number): number;
-/**
- * 滚轮缩放:乘性步进(默认 ×1.1 / ÷1.1),大倍数下仍保持平滑手感,
- * 返回取整后的百分比,避免浮点累加产生脏显示(如 110.00000001)
- * @param percent 当前缩放百分比
- * @param direction 1 放大,-1 缩小
- */
-export declare function nextWheelScale(percent: number, direction: 1 | -1, factor?: number): number;
-/** 计算适应窗口的缩放百分比,仅钳制最小缩放,放大不设上限 */
-export declare function computeFitScale(containerW: number, containerH: number, paperW: number, paperH: number, ratio?: number): number;

package/dist/utils/table-matrix.d.ts

@@ -1,69 +0,0 @@
-import type { TableRow, TableRowType, TableCell, TableCellBorder, ElementOptions } from '../types';
-export interface CellRect {
-    r1: number;
-    c1: number;
-    r2: number;
-    c2: number;
-}
-export declare function createCell(partial?: Partial<TableCell>): TableCell;
-/** 默认新建表格：3 列 × 4 行（标题/数据/小计/汇总），列宽均分 50mm，表格组件默认显示当前页小计行 */
-export declare function createDefaultTable(): {
-    rows: TableRow[];
-    colWidths: number[];
-};
-/** 定位覆盖 (r,c) 的主格坐标（自身非 merged 即为主格） */
-export declare function findMainCell(rows: TableRow[], r: number, c: number): {
-    r: number;
-    c: number;
-};
-/** 主格覆盖矩形 */
-export declare function getSpanRect(rows: TableRow[], r: number, c: number): CellRect;
-/** 由锚点/焦点推导矩形选区，并迭代扩展至完整包含所有跨越的合并格 */
-export declare function normalizeSelection(rows: TableRow[], a: {
-    r: number;
-    c: number;
-}, b: {
-    r: number;
-    c: number;
-}): CellRect;
-/** 合并合法性校验，返回拒绝原因或 null */
-export declare function canMergeReason(rows: TableRow[], rect: CellRect): string | null;
-/** 合并：左上为主格，非空内容空格拼接并入主格 */
-export declare function mergeCells(rows: TableRow[], rect: CellRect): void;
-/** 拆分选区内所有合并格：占位格恢复并复制主格样式 */
-export declare function splitCells(rows: TableRow[], rect: CellRect): void;
-/** 插入行。index 为参照行，position 决定插在其上方或下方 */
-export declare function insertRow(rows: TableRow[], index: number, position: 'above' | 'below'): void;
-/** 删除行；主格在被删行时移交下一行 */
-export declare function deleteRow(rows: TableRow[], index: number): string | null;
-/** 插入列 */
-export declare function insertCol(rows: TableRow[], colWidths: number[], index: number, position: 'left' | 'right'): void;
-/** 删除列；主格在被删列时移交右侧列 */
-export declare function deleteCol(rows: TableRow[], colWidths: number[], index: number): string | null;
-/** 行类型变更校验 + 写入。约束：header 顶部连续；data 唯一；subtotal/summary 在 data 之后；subtotal 在 summary 之前 */
-export declare function setRowType(rows: TableRow[], index: number, type: TableRowType): string | null;
-export type BorderPreset = 'all' | 'outer' | 'inner' | 'none';
-/** 按预设批量写边框；none 时清空选区内所有格的 borders */
-export declare function applyBorderPreset(rows: TableRow[], rect: CellRect, preset: BorderPreset, border: TableCellBorder): void;
-/** 设计态下无边框单元格的辅助虚线：与背景网格线同风格（浅灰虚线），略深保证可读 */
-export declare const GHOST_BORDER_CSS = "1px dashed rgba(0,0,0,0.18)";
-/**
- * 解析单元格某条边的最终 CSS border 值。
- * - 有真实边框（style 非 none）→ 返回 `${width}pt ${style} ${color}`
- * - 设计态且开关开启、且该边无边框 → 返回虚拟虚线（仅设计稿展示，不影响预览/打印）
- * - 其余情况（预览态 / 开关关闭）→ 'none'
- */
-export declare function resolveCellBorderCss(b: TableCellBorder | undefined, opts?: {
-    designMode?: boolean;
-    showGhostBorder?: boolean;
-}): string;
-/** 表格元素尺寸派生：options.width/height 恒等于列宽和/行高和（mm），与渲染端一致 */
-export declare function syncTableElementSize(options: ElementOptions): void;
-/** 列宽拖拽的最小列宽（mm），与属性面板列宽输入下限一致 */
-export declare const MIN_COL_WIDTH_MM = 5;
-/**
- * 列宽拖拽钳制（纯函数，不修改入参，调用方负责回写）：
- * 返回目标列宽在 [MIN_COL_WIDTH_MM, maxTableWidth - 其余列和] 范围内的钳制值，
- * 结果保留 0.1mm 精度。maxTableWidth 为 Infinity 时不设总宽上限。
- */
-export declare function clampResizedColumnWidth(colWidths: number[], index: number, targetMm: number, maxTableWidth: number): number;

package/dist/utils/units.d.ts

@@ -1,6 +0,0 @@
-/** pt 转 mm */
-export declare function ptToMm(pt: number): number;
-/** px 转 mm（基于 96dpi 屏幕） */
-export declare function pxToMm(px: number): number;
-/** mm 转 px（基于 96dpi 屏幕） */
-export declare function mmToPx(mm: number): number;