@canvas-components/print-design 0.1.1 → 0.1.2

package/dist/index.d.cts

@@ -384,6 +384,15 @@ interface PrintDesignTableColumn {
     headerAlign?: "left" | "center" | "right";
     hidden?: boolean;
     ellipsis?: boolean;
+    /** 列级文本溢出方式；优先于旧版 ellipsis 和表格默认值。 */
+    cellOverflow?: "nowrap" | "wrap" | "ellipsis" | "shrink";
+    /** 单元格四边内边距，单位为 96 DPI 逻辑像素。 */
+    cellPadding?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
     cellType?: string;
     cellStyle?: {
         textAlign?: "left" | "center" | "right";
@@ -416,6 +425,32 @@ interface PrintDesignTableColumn {
     };
     render?: (value: unknown, record: Record<string, unknown>, rowIndex: number, column: PrintDesignTableColumn) => unknown;
 }
+/** 表体单元格的打印样式及合并配置，行列索引均从零开始。 */
+interface PrintDesignTableCell {
+    rowIndex: number;
+    columnIndex: number;
+    rowSpan?: number;
+    colSpan?: number;
+    backgroundColor?: string;
+    color?: string;
+    /** 单元格边框覆盖；透明色可在打印时隐藏边框。 */
+    borderColor?: string;
+    /** 动态数据字段为 false、0 或空字符串时隐藏边框。 */
+    borderPath?: string;
+    diagonal?: "down" | "up";
+    diagonalStart?: string;
+    diagonalEnd?: string;
+}
+/** 与 ListTable 的 mergeCell 配置一致，按绑定记录自动合并连续行或相邻列。 */
+interface PrintDesignTableMergeCell {
+    row?: {
+        keys: NonNullable<PrintDesignTableColumn["dataIndex"]>[];
+        columns?: NonNullable<PrintDesignTableColumn["dataIndex"]>[];
+    };
+    column?: {
+        keys: NonNullable<PrintDesignTableColumn["dataIndex"]>[];
+    };
+}
 /** 表格组件。行高单位毫米，列宽沿用 ListTable 的逻辑像素。 */
 interface PrintDesignTableElement extends PrintDesignElementBase {
     type: "table";
@@ -434,12 +469,28 @@ interface PrintDesignTableElement extends PrintDesignElementBase {
         color?: string;
         width?: number;
     };
+    /** 全表边框控制；绑定值为 false、0 或空字符串时隐藏。 */
+    borderMode?: "show" | "hide" | "binding";
+    borderPath?: string;
+    /** 单元格样式和合并区域；区域内仅左上角单元格绘制内容。 */
+    cells?: PrintDesignTableCell[];
+    /** 表头手动合并区域，行号按表头层级从零开始。 */
+    headerCells?: PrintDesignTableCell[];
+    /** 根据绑定记录动态合并连续行或同一行的相邻列。 */
+    mergeCell?: PrintDesignTableMergeCell;
     /** 默认水平对齐，列级配置优先。 */
     cellAlign?: "left" | "center" | "right";
     /** 默认垂直对齐，列级配置优先。 */
     cellVerticalAlign?: "top" | "middle" | "bottom";
     /** 单元格超出方式，沿用 ListTable 的换行与省略号模式。 */
-    cellOverflow?: "wrap" | "ellipsis";
+    cellOverflow?: "nowrap" | "wrap" | "ellipsis" | "shrink";
+    /** 表格级单元格内边距默认值；列级 cellPadding 可逐边覆盖。 */
+    cellPadding?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
     /** 是否显示列配置生成的汇总行，默认显示。 */
     showSummary?: boolean;
     /** 汇总行高，单位毫米，默认沿用数据行高。 */
@@ -751,10 +802,27 @@ interface PrintDesignHtmlOptions {
     /** 省略时输出文档中的所有页面。 */
     pageIds?: readonly string[];
 }
-/** 将设计文档及数据转换为可直接交给浏览器打印的 HTML。 */
-declare function transformPrintDesignToHtml(document: PrintDesignDocument, options?: PrintDesignHtmlOptions): string;
 /** 将转换后的 HTML 写入打印窗口，等待图片加载后唤起浏览器打印。 */
 declare function printPrintDesignHtml(popup: Window, html: string): void;
+/** 同步生成打印 HTML，保留原有调用方式。 */
+declare function transformPrintDesignToHtml(document: PrintDesignDocument, options?: PrintDesignHtmlOptions): string;
+/** 分时间片生成打印页面，支持取消和实际处理进度。 */
+declare function transformPrintDesignToHtmlAsync(document: PrintDesignDocument, options?: PrintDesignHtmlOptions & {
+    signal?: AbortSignal;
+    onProgress?: (progress: number) => void;
+}): Promise<string>;
+/** 按实际物理页限制生成 HTML，调用方消费一批后才生成下一批。 */
+declare function transformPrintDesignToHtmlBatches(document: PrintDesignDocument, options: {
+    data?: Record<string, unknown>;
+    pagesPerBatch: number;
+    signal?: AbortSignal;
+    onProgress?: (progress: number) => void;
+}): AsyncGenerator<{
+    html: string;
+    firstPage: number;
+    lastPage: number;
+    hasMore: boolean;
+}, void, unknown>;
 
 type ResizeHandle = "nw" | "ne" | "se" | "sw" | "n" | "s" | "w" | "e";
 type Rect = Pick<PrintDesignElement, "x" | "y" | "width" | "height">;
@@ -921,6 +989,32 @@ declare abstract class PrintDesignBase {
 
 /** 静态表格单元格编辑会话与文档历史，独立于文本元素编辑。 */
 declare abstract class PrintDesignTableEditing extends PrintDesignBase {
+    protected tableCellSelection: {
+        elementId: string;
+        area: "header" | "body";
+        selectorKind?: "row" | "column" | "all";
+        startRow: number;
+        endRow: number;
+        startColumn: number;
+        endColumn: number;
+    } | null;
+    /** 返回表格单元格选区，供右键菜单与选区绘制使用。 */
+    getTableCellSelection(): {
+        elementId: string;
+        area: "header" | "body";
+        selectorKind?: "row" | "column" | "all";
+        startRow: number;
+        endRow: number;
+        startColumn: number;
+        endColumn: number;
+    } | null;
+    /** 选择表格整行、整列或全部单元格。 */
+    selectTableSelector(elementId: string, kind: "row" | "column" | "all", index?: number, area?: "header" | "body"): this;
+    /** 选中一个单元格，按 Shift 扩展为矩形区域。 */
+    protected selectTableCellAtPoint(element: PrintDesignTableElement, point: {
+        x: number;
+        y: number;
+    }, extend?: boolean): boolean;
     private tableEditing;
     protected beginTableEditing(element: PrintDesignTableElement, point: {
         x: number;
@@ -984,6 +1078,7 @@ declare abstract class PrintDesignRenderer extends PrintDesignTextEditing {
     render(): this;
     private drawGrid;
     private drawSelection;
+    private drawTableCellSelection;
     /** 组合四边控制柄与外部图层重叠时，优先保留其它图层的选择。 */
     protected hitTestGroupResizeHandle(point: {
         x: number;
@@ -996,7 +1091,7 @@ declare abstract class PrintDesignRenderer extends PrintDesignTextEditing {
         x: number;
         y: number;
     }, page: PrintDesignPage, scale: number): {
-        element: PrintDesignElement;
+        element: PrintDesignTextElement | PrintDesignListElement | PrintDesignDateTimeElement | PrintDesignMoneyUpperElement | PrintDesignPageNumberElement | PrintDesignWatermarkElement | PrintDesignShapeElement | PrintDesignDividerElement | PrintDesignRulerElement | PrintDesignGridElement | PrintDesignProgressElement | PrintDesignClockElement | PrintDesignImageElement | PrintDesignBarcodeElement | PrintDesignQrCodeElement | PrintDesignChartElement | PrintDesignTableElement | PrintDesignPivotTableElement | PrintDesignGanttElement;
         handle: ResizeHandle;
     } | undefined;
     protected hitTestRotateHandle(point: {
@@ -1052,6 +1147,28 @@ declare function getPrintDesignAlignmentUnits(elements: PrintDesignElement[], id
 /** 菜单批量操作与实例内剪贴板；每次文档操作只提交一条历史。 */
 declare abstract class PrintDesignActions extends PrintDesignGrouping {
     private elementClipboard;
+    /** 定位画布中的行、列或全选选择器。 */
+    tableSelectorAtClientPoint(clientX: number, clientY: number): {
+        elementId: string;
+        kind: "column" | "row" | "all";
+        index: number;
+        area: "header" | "body" | undefined;
+    } | null;
+    /** 定位画布右键所指的表头或表体单元格。 */
+    tableCellAtClientPoint(clientX: number, clientY: number): {
+        elementId: string;
+        area: "header" | "body";
+        rowIndex: number;
+        columnIndex: number;
+    } | null;
+    /** 合并右键单元格与相邻单元格；变更纳入撤销历史。 */
+    mergeTableCell(elementId: string, rowIndex: number, columnIndex: number, rowSpan: number, colSpan: number): this;
+    /** 合并表头选区，保留左上角单元格标题。 */
+    mergeTableHeaderCell(elementId: string, rowIndex: number, columnIndex: number, rowSpan: number, colSpan: number): this;
+    /** 在静态表格指定数据行的上方或下方插入空行。 */
+    insertTableRow(elementId: string, rowIndex: number, after?: boolean): this;
+    /** 在可见叶列的左侧或右侧插入空白列。 */
+    insertTableColumn(elementId: string, columnIndex: number, after?: boolean): this;
     /** 画布右键命中选区；点中已选项保留多选，空白清空选区。 */
     selectAtClientPoint(clientX: number, clientY: number): this;
     /** 复制选中元素，保留组合、数据及样式，不使用系统剪贴板。 */
@@ -1089,6 +1206,11 @@ declare abstract class PrintDesignActions extends PrintDesignGrouping {
 
 /** 负责打印文档、页面与导出 API 的原生设计器实例。 */
 declare class PrintDesign extends PrintDesignActions {
+    private temporaryDocumentSnapshot;
+    /** 临时显示演示文档；原文档、选区与撤销记录保留在实例中。 */
+    showTemporaryDocument(document: PrintDesignDocument, pageId?: string, elementId?: string): this;
+    /** 恢复临时演示前的文档和选区，保留原有撤销记录。 */
+    restoreTemporaryDocument(): this;
     /** 获取文档副本。 */
     getDocument(): PrintDesignDocument;
     /** 替换当前文档并清空撤销历史。 */
@@ -1120,6 +1242,13 @@ declare class PrintDesign extends PrintDesignActions {
         x: number;
         y: number;
     } | null;
+    /** 获取当前页元素在浏览器视口中的包围盒，包含旋转后的占用范围。 */
+    getElementClientRect(elementId: string): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null;
     /** 新增元素并选中。 */
     addElement<T extends PrintDesignElement>(element: Omit<T, "id"> & {
         id?: string;
@@ -1288,4 +1417,4 @@ declare function isPrintDesignTableDataSource(value: unknown): value is PrintDes
 /** 兼容 ReactListTable 图表弹窗所使用的 ListTableChartData。 */
 declare function isPrintDesignChartDataSource(value: unknown): value is PrintDesignChartDataSource;
 
-export { DEFAULT_PRINT_DESIGN_DEBUG_OPTIONS, PRINT_DESIGN_CSS_DPI, PRINT_DESIGN_MM_PER_INCH, PRINT_DESIGN_SCHEMA_VERSION, PRINT_DESIGN_UNIT_MM, PrintDesign, type PrintDesignBarcodeElement, type PrintDesignChartData, type PrintDesignChartDataSource, type PrintDesignChartElement, type PrintDesignClockElement, type PrintDesignDataField, type PrintDesignDebugOptions, type PrintDesignDividerElement, type PrintDesignDocument, type PrintDesignElement, type PrintDesignElementBase, type PrintDesignExportOptions, type PrintDesignGanttElement, type PrintDesignGridCell, type PrintDesignGridElement, type PrintDesignGridMark, type PrintDesignHtmlOptions, type PrintDesignImageElement, type PrintDesignLayerAlignment, type PrintDesignLayerNode, type PrintDesignListElement, type PrintDesignOptions, type PrintDesignOrientation, type PrintDesignPage, type PrintDesignPageMargins, type PrintDesignPivotTableElement, type PrintDesignProgressElement, type PrintDesignQrCodeElement, type PrintDesignRulerElement, type PrintDesignSelection, type PrintDesignShapeElement, type PrintDesignTableColumn, type PrintDesignTableDataSource, type PrintDesignTableElement, type PrintDesignTextElement, type PrintDesignUnit, type PrintGanttDependency, type PrintGanttScale, type PrintGanttTask, type PrintPivotAggregator, type PrintPivotField, type PrintPivotFieldArea, type PrintPivotFieldLayout, type PrintPivotFilterState, buildPrintDesignLayerTree, canvasPointToPageMillimeters, computePrintTableSummaryValues, createPrintDesignDocument, createPrintDesignId, createPrintDesignPage, drawPrintDesignElement, drawPrintDesignPage, findPrintPivotFieldArea, formatDisplayUnit, fromDisplayUnit, getPrintDesignAlignmentUnits, getPrintDesignDataFields, getPrintDesignElementDataConfig, getPrintDesignPageSize, hitTestPrintDesignPage, isGanttTasks, isPrintDesignChartDataSource, isPrintDesignTableDataSource, materializePivotTable, millimetersToPixels, movePrintPivotField, normalizeGridCount, paginatePrintDesignDocument, parsePrintDesignDocument, pixelsToMillimeters, printPivotFieldHeaderTitle, printPivotFieldTitle, printPivotValueTitle, printPrintDesignHtml, readChartData, readTableCell, removePrintPivotField, renderPrintDesignPageToCanvas, resizeGridCells, resolveChartOption, resolveDesignText, resolveGanttDependencies, resolveGanttTasks, resolveGridCells, resolvePivotRows, resolvePrintDesignBinding, resolvePrintDesignDataPath, resolvePrintDesignDebugOptions, resolvePrintDesignElementData, resolvePrintDesignElementVisible, resolveTableDataSource, resolveTableRows, serializePrintDesignDocument, tableLeafColumns, toDisplayUnit, transformPrintDesignToHtml, writeTableCell };
+export { DEFAULT_PRINT_DESIGN_DEBUG_OPTIONS, PRINT_DESIGN_CSS_DPI, PRINT_DESIGN_MM_PER_INCH, PRINT_DESIGN_SCHEMA_VERSION, PRINT_DESIGN_UNIT_MM, PrintDesign, type PrintDesignBarcodeElement, type PrintDesignChartData, type PrintDesignChartDataSource, type PrintDesignChartElement, type PrintDesignClockElement, type PrintDesignDataField, type PrintDesignDebugOptions, type PrintDesignDividerElement, type PrintDesignDocument, type PrintDesignElement, type PrintDesignElementBase, type PrintDesignExportOptions, type PrintDesignGanttElement, type PrintDesignGridCell, type PrintDesignGridElement, type PrintDesignGridMark, type PrintDesignHtmlOptions, type PrintDesignImageElement, type PrintDesignLayerAlignment, type PrintDesignLayerNode, type PrintDesignListElement, type PrintDesignOptions, type PrintDesignOrientation, type PrintDesignPage, type PrintDesignPageMargins, type PrintDesignPivotTableElement, type PrintDesignProgressElement, type PrintDesignQrCodeElement, type PrintDesignRulerElement, type PrintDesignSelection, type PrintDesignShapeElement, type PrintDesignTableCell, type PrintDesignTableColumn, type PrintDesignTableDataSource, type PrintDesignTableElement, type PrintDesignTableMergeCell, type PrintDesignTextElement, type PrintDesignUnit, type PrintGanttDependency, type PrintGanttScale, type PrintGanttTask, type PrintPivotAggregator, type PrintPivotField, type PrintPivotFieldArea, type PrintPivotFieldLayout, type PrintPivotFilterState, buildPrintDesignLayerTree, canvasPointToPageMillimeters, computePrintTableSummaryValues, createPrintDesignDocument, createPrintDesignId, createPrintDesignPage, drawPrintDesignElement, drawPrintDesignPage, findPrintPivotFieldArea, formatDisplayUnit, fromDisplayUnit, getPrintDesignAlignmentUnits, getPrintDesignDataFields, getPrintDesignElementDataConfig, getPrintDesignPageSize, hitTestPrintDesignPage, isGanttTasks, isPrintDesignChartDataSource, isPrintDesignTableDataSource, materializePivotTable, millimetersToPixels, movePrintPivotField, normalizeGridCount, paginatePrintDesignDocument, parsePrintDesignDocument, pixelsToMillimeters, printPivotFieldHeaderTitle, printPivotFieldTitle, printPivotValueTitle, printPrintDesignHtml, readChartData, readTableCell, removePrintPivotField, renderPrintDesignPageToCanvas, resizeGridCells, resolveChartOption, resolveDesignText, resolveGanttDependencies, resolveGanttTasks, resolveGridCells, resolvePivotRows, resolvePrintDesignBinding, resolvePrintDesignDataPath, resolvePrintDesignDebugOptions, resolvePrintDesignElementData, resolvePrintDesignElementVisible, resolveTableDataSource, resolveTableRows, serializePrintDesignDocument, tableLeafColumns, toDisplayUnit, transformPrintDesignToHtml, transformPrintDesignToHtmlAsync, transformPrintDesignToHtmlBatches, writeTableCell };

package/dist/index.d.ts

@@ -384,6 +384,15 @@ interface PrintDesignTableColumn {
     headerAlign?: "left" | "center" | "right";
     hidden?: boolean;
     ellipsis?: boolean;
+    /** 列级文本溢出方式；优先于旧版 ellipsis 和表格默认值。 */
+    cellOverflow?: "nowrap" | "wrap" | "ellipsis" | "shrink";
+    /** 单元格四边内边距，单位为 96 DPI 逻辑像素。 */
+    cellPadding?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
     cellType?: string;
     cellStyle?: {
         textAlign?: "left" | "center" | "right";
@@ -416,6 +425,32 @@ interface PrintDesignTableColumn {
     };
     render?: (value: unknown, record: Record<string, unknown>, rowIndex: number, column: PrintDesignTableColumn) => unknown;
 }
+/** 表体单元格的打印样式及合并配置，行列索引均从零开始。 */
+interface PrintDesignTableCell {
+    rowIndex: number;
+    columnIndex: number;
+    rowSpan?: number;
+    colSpan?: number;
+    backgroundColor?: string;
+    color?: string;
+    /** 单元格边框覆盖；透明色可在打印时隐藏边框。 */
+    borderColor?: string;
+    /** 动态数据字段为 false、0 或空字符串时隐藏边框。 */
+    borderPath?: string;
+    diagonal?: "down" | "up";
+    diagonalStart?: string;
+    diagonalEnd?: string;
+}
+/** 与 ListTable 的 mergeCell 配置一致，按绑定记录自动合并连续行或相邻列。 */
+interface PrintDesignTableMergeCell {
+    row?: {
+        keys: NonNullable<PrintDesignTableColumn["dataIndex"]>[];
+        columns?: NonNullable<PrintDesignTableColumn["dataIndex"]>[];
+    };
+    column?: {
+        keys: NonNullable<PrintDesignTableColumn["dataIndex"]>[];
+    };
+}
 /** 表格组件。行高单位毫米，列宽沿用 ListTable 的逻辑像素。 */
 interface PrintDesignTableElement extends PrintDesignElementBase {
     type: "table";
@@ -434,12 +469,28 @@ interface PrintDesignTableElement extends PrintDesignElementBase {
         color?: string;
         width?: number;
     };
+    /** 全表边框控制；绑定值为 false、0 或空字符串时隐藏。 */
+    borderMode?: "show" | "hide" | "binding";
+    borderPath?: string;
+    /** 单元格样式和合并区域；区域内仅左上角单元格绘制内容。 */
+    cells?: PrintDesignTableCell[];
+    /** 表头手动合并区域，行号按表头层级从零开始。 */
+    headerCells?: PrintDesignTableCell[];
+    /** 根据绑定记录动态合并连续行或同一行的相邻列。 */
+    mergeCell?: PrintDesignTableMergeCell;
     /** 默认水平对齐，列级配置优先。 */
     cellAlign?: "left" | "center" | "right";
     /** 默认垂直对齐，列级配置优先。 */
     cellVerticalAlign?: "top" | "middle" | "bottom";
     /** 单元格超出方式，沿用 ListTable 的换行与省略号模式。 */
-    cellOverflow?: "wrap" | "ellipsis";
+    cellOverflow?: "nowrap" | "wrap" | "ellipsis" | "shrink";
+    /** 表格级单元格内边距默认值；列级 cellPadding 可逐边覆盖。 */
+    cellPadding?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
     /** 是否显示列配置生成的汇总行，默认显示。 */
     showSummary?: boolean;
     /** 汇总行高，单位毫米，默认沿用数据行高。 */
@@ -751,10 +802,27 @@ interface PrintDesignHtmlOptions {
     /** 省略时输出文档中的所有页面。 */
     pageIds?: readonly string[];
 }
-/** 将设计文档及数据转换为可直接交给浏览器打印的 HTML。 */
-declare function transformPrintDesignToHtml(document: PrintDesignDocument, options?: PrintDesignHtmlOptions): string;
 /** 将转换后的 HTML 写入打印窗口，等待图片加载后唤起浏览器打印。 */
 declare function printPrintDesignHtml(popup: Window, html: string): void;
+/** 同步生成打印 HTML，保留原有调用方式。 */
+declare function transformPrintDesignToHtml(document: PrintDesignDocument, options?: PrintDesignHtmlOptions): string;
+/** 分时间片生成打印页面，支持取消和实际处理进度。 */
+declare function transformPrintDesignToHtmlAsync(document: PrintDesignDocument, options?: PrintDesignHtmlOptions & {
+    signal?: AbortSignal;
+    onProgress?: (progress: number) => void;
+}): Promise<string>;
+/** 按实际物理页限制生成 HTML，调用方消费一批后才生成下一批。 */
+declare function transformPrintDesignToHtmlBatches(document: PrintDesignDocument, options: {
+    data?: Record<string, unknown>;
+    pagesPerBatch: number;
+    signal?: AbortSignal;
+    onProgress?: (progress: number) => void;
+}): AsyncGenerator<{
+    html: string;
+    firstPage: number;
+    lastPage: number;
+    hasMore: boolean;
+}, void, unknown>;
 
 type ResizeHandle = "nw" | "ne" | "se" | "sw" | "n" | "s" | "w" | "e";
 type Rect = Pick<PrintDesignElement, "x" | "y" | "width" | "height">;
@@ -921,6 +989,32 @@ declare abstract class PrintDesignBase {
 
 /** 静态表格单元格编辑会话与文档历史，独立于文本元素编辑。 */
 declare abstract class PrintDesignTableEditing extends PrintDesignBase {
+    protected tableCellSelection: {
+        elementId: string;
+        area: "header" | "body";
+        selectorKind?: "row" | "column" | "all";
+        startRow: number;
+        endRow: number;
+        startColumn: number;
+        endColumn: number;
+    } | null;
+    /** 返回表格单元格选区，供右键菜单与选区绘制使用。 */
+    getTableCellSelection(): {
+        elementId: string;
+        area: "header" | "body";
+        selectorKind?: "row" | "column" | "all";
+        startRow: number;
+        endRow: number;
+        startColumn: number;
+        endColumn: number;
+    } | null;
+    /** 选择表格整行、整列或全部单元格。 */
+    selectTableSelector(elementId: string, kind: "row" | "column" | "all", index?: number, area?: "header" | "body"): this;
+    /** 选中一个单元格，按 Shift 扩展为矩形区域。 */
+    protected selectTableCellAtPoint(element: PrintDesignTableElement, point: {
+        x: number;
+        y: number;
+    }, extend?: boolean): boolean;
     private tableEditing;
     protected beginTableEditing(element: PrintDesignTableElement, point: {
         x: number;
@@ -984,6 +1078,7 @@ declare abstract class PrintDesignRenderer extends PrintDesignTextEditing {
     render(): this;
     private drawGrid;
     private drawSelection;
+    private drawTableCellSelection;
     /** 组合四边控制柄与外部图层重叠时，优先保留其它图层的选择。 */
     protected hitTestGroupResizeHandle(point: {
         x: number;
@@ -996,7 +1091,7 @@ declare abstract class PrintDesignRenderer extends PrintDesignTextEditing {
         x: number;
         y: number;
     }, page: PrintDesignPage, scale: number): {
-        element: PrintDesignElement;
+        element: PrintDesignTextElement | PrintDesignListElement | PrintDesignDateTimeElement | PrintDesignMoneyUpperElement | PrintDesignPageNumberElement | PrintDesignWatermarkElement | PrintDesignShapeElement | PrintDesignDividerElement | PrintDesignRulerElement | PrintDesignGridElement | PrintDesignProgressElement | PrintDesignClockElement | PrintDesignImageElement | PrintDesignBarcodeElement | PrintDesignQrCodeElement | PrintDesignChartElement | PrintDesignTableElement | PrintDesignPivotTableElement | PrintDesignGanttElement;
         handle: ResizeHandle;
     } | undefined;
     protected hitTestRotateHandle(point: {
@@ -1052,6 +1147,28 @@ declare function getPrintDesignAlignmentUnits(elements: PrintDesignElement[], id
 /** 菜单批量操作与实例内剪贴板；每次文档操作只提交一条历史。 */
 declare abstract class PrintDesignActions extends PrintDesignGrouping {
     private elementClipboard;
+    /** 定位画布中的行、列或全选选择器。 */
+    tableSelectorAtClientPoint(clientX: number, clientY: number): {
+        elementId: string;
+        kind: "column" | "row" | "all";
+        index: number;
+        area: "header" | "body" | undefined;
+    } | null;
+    /** 定位画布右键所指的表头或表体单元格。 */
+    tableCellAtClientPoint(clientX: number, clientY: number): {
+        elementId: string;
+        area: "header" | "body";
+        rowIndex: number;
+        columnIndex: number;
+    } | null;
+    /** 合并右键单元格与相邻单元格；变更纳入撤销历史。 */
+    mergeTableCell(elementId: string, rowIndex: number, columnIndex: number, rowSpan: number, colSpan: number): this;
+    /** 合并表头选区，保留左上角单元格标题。 */
+    mergeTableHeaderCell(elementId: string, rowIndex: number, columnIndex: number, rowSpan: number, colSpan: number): this;
+    /** 在静态表格指定数据行的上方或下方插入空行。 */
+    insertTableRow(elementId: string, rowIndex: number, after?: boolean): this;
+    /** 在可见叶列的左侧或右侧插入空白列。 */
+    insertTableColumn(elementId: string, columnIndex: number, after?: boolean): this;
     /** 画布右键命中选区；点中已选项保留多选，空白清空选区。 */
     selectAtClientPoint(clientX: number, clientY: number): this;
     /** 复制选中元素，保留组合、数据及样式，不使用系统剪贴板。 */
@@ -1089,6 +1206,11 @@ declare abstract class PrintDesignActions extends PrintDesignGrouping {
 
 /** 负责打印文档、页面与导出 API 的原生设计器实例。 */
 declare class PrintDesign extends PrintDesignActions {
+    private temporaryDocumentSnapshot;
+    /** 临时显示演示文档；原文档、选区与撤销记录保留在实例中。 */
+    showTemporaryDocument(document: PrintDesignDocument, pageId?: string, elementId?: string): this;
+    /** 恢复临时演示前的文档和选区，保留原有撤销记录。 */
+    restoreTemporaryDocument(): this;
     /** 获取文档副本。 */
     getDocument(): PrintDesignDocument;
     /** 替换当前文档并清空撤销历史。 */
@@ -1120,6 +1242,13 @@ declare class PrintDesign extends PrintDesignActions {
         x: number;
         y: number;
     } | null;
+    /** 获取当前页元素在浏览器视口中的包围盒，包含旋转后的占用范围。 */
+    getElementClientRect(elementId: string): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null;
     /** 新增元素并选中。 */
     addElement<T extends PrintDesignElement>(element: Omit<T, "id"> & {
         id?: string;
@@ -1288,4 +1417,4 @@ declare function isPrintDesignTableDataSource(value: unknown): value is PrintDes
 /** 兼容 ReactListTable 图表弹窗所使用的 ListTableChartData。 */
 declare function isPrintDesignChartDataSource(value: unknown): value is PrintDesignChartDataSource;
 
-export { DEFAULT_PRINT_DESIGN_DEBUG_OPTIONS, PRINT_DESIGN_CSS_DPI, PRINT_DESIGN_MM_PER_INCH, PRINT_DESIGN_SCHEMA_VERSION, PRINT_DESIGN_UNIT_MM, PrintDesign, type PrintDesignBarcodeElement, type PrintDesignChartData, type PrintDesignChartDataSource, type PrintDesignChartElement, type PrintDesignClockElement, type PrintDesignDataField, type PrintDesignDebugOptions, type PrintDesignDividerElement, type PrintDesignDocument, type PrintDesignElement, type PrintDesignElementBase, type PrintDesignExportOptions, type PrintDesignGanttElement, type PrintDesignGridCell, type PrintDesignGridElement, type PrintDesignGridMark, type PrintDesignHtmlOptions, type PrintDesignImageElement, type PrintDesignLayerAlignment, type PrintDesignLayerNode, type PrintDesignListElement, type PrintDesignOptions, type PrintDesignOrientation, type PrintDesignPage, type PrintDesignPageMargins, type PrintDesignPivotTableElement, type PrintDesignProgressElement, type PrintDesignQrCodeElement, type PrintDesignRulerElement, type PrintDesignSelection, type PrintDesignShapeElement, type PrintDesignTableColumn, type PrintDesignTableDataSource, type PrintDesignTableElement, type PrintDesignTextElement, type PrintDesignUnit, type PrintGanttDependency, type PrintGanttScale, type PrintGanttTask, type PrintPivotAggregator, type PrintPivotField, type PrintPivotFieldArea, type PrintPivotFieldLayout, type PrintPivotFilterState, buildPrintDesignLayerTree, canvasPointToPageMillimeters, computePrintTableSummaryValues, createPrintDesignDocument, createPrintDesignId, createPrintDesignPage, drawPrintDesignElement, drawPrintDesignPage, findPrintPivotFieldArea, formatDisplayUnit, fromDisplayUnit, getPrintDesignAlignmentUnits, getPrintDesignDataFields, getPrintDesignElementDataConfig, getPrintDesignPageSize, hitTestPrintDesignPage, isGanttTasks, isPrintDesignChartDataSource, isPrintDesignTableDataSource, materializePivotTable, millimetersToPixels, movePrintPivotField, normalizeGridCount, paginatePrintDesignDocument, parsePrintDesignDocument, pixelsToMillimeters, printPivotFieldHeaderTitle, printPivotFieldTitle, printPivotValueTitle, printPrintDesignHtml, readChartData, readTableCell, removePrintPivotField, renderPrintDesignPageToCanvas, resizeGridCells, resolveChartOption, resolveDesignText, resolveGanttDependencies, resolveGanttTasks, resolveGridCells, resolvePivotRows, resolvePrintDesignBinding, resolvePrintDesignDataPath, resolvePrintDesignDebugOptions, resolvePrintDesignElementData, resolvePrintDesignElementVisible, resolveTableDataSource, resolveTableRows, serializePrintDesignDocument, tableLeafColumns, toDisplayUnit, transformPrintDesignToHtml, writeTableCell };
+export { DEFAULT_PRINT_DESIGN_DEBUG_OPTIONS, PRINT_DESIGN_CSS_DPI, PRINT_DESIGN_MM_PER_INCH, PRINT_DESIGN_SCHEMA_VERSION, PRINT_DESIGN_UNIT_MM, PrintDesign, type PrintDesignBarcodeElement, type PrintDesignChartData, type PrintDesignChartDataSource, type PrintDesignChartElement, type PrintDesignClockElement, type PrintDesignDataField, type PrintDesignDebugOptions, type PrintDesignDividerElement, type PrintDesignDocument, type PrintDesignElement, type PrintDesignElementBase, type PrintDesignExportOptions, type PrintDesignGanttElement, type PrintDesignGridCell, type PrintDesignGridElement, type PrintDesignGridMark, type PrintDesignHtmlOptions, type PrintDesignImageElement, type PrintDesignLayerAlignment, type PrintDesignLayerNode, type PrintDesignListElement, type PrintDesignOptions, type PrintDesignOrientation, type PrintDesignPage, type PrintDesignPageMargins, type PrintDesignPivotTableElement, type PrintDesignProgressElement, type PrintDesignQrCodeElement, type PrintDesignRulerElement, type PrintDesignSelection, type PrintDesignShapeElement, type PrintDesignTableCell, type PrintDesignTableColumn, type PrintDesignTableDataSource, type PrintDesignTableElement, type PrintDesignTableMergeCell, type PrintDesignTextElement, type PrintDesignUnit, type PrintGanttDependency, type PrintGanttScale, type PrintGanttTask, type PrintPivotAggregator, type PrintPivotField, type PrintPivotFieldArea, type PrintPivotFieldLayout, type PrintPivotFilterState, buildPrintDesignLayerTree, canvasPointToPageMillimeters, computePrintTableSummaryValues, createPrintDesignDocument, createPrintDesignId, createPrintDesignPage, drawPrintDesignElement, drawPrintDesignPage, findPrintPivotFieldArea, formatDisplayUnit, fromDisplayUnit, getPrintDesignAlignmentUnits, getPrintDesignDataFields, getPrintDesignElementDataConfig, getPrintDesignPageSize, hitTestPrintDesignPage, isGanttTasks, isPrintDesignChartDataSource, isPrintDesignTableDataSource, materializePivotTable, millimetersToPixels, movePrintPivotField, normalizeGridCount, paginatePrintDesignDocument, parsePrintDesignDocument, pixelsToMillimeters, printPivotFieldHeaderTitle, printPivotFieldTitle, printPivotValueTitle, printPrintDesignHtml, readChartData, readTableCell, removePrintPivotField, renderPrintDesignPageToCanvas, resizeGridCells, resolveChartOption, resolveDesignText, resolveGanttDependencies, resolveGanttTasks, resolveGridCells, resolvePivotRows, resolvePrintDesignBinding, resolvePrintDesignDataPath, resolvePrintDesignDebugOptions, resolvePrintDesignElementData, resolvePrintDesignElementVisible, resolveTableDataSource, resolveTableRows, serializePrintDesignDocument, tableLeafColumns, toDisplayUnit, transformPrintDesignToHtml, transformPrintDesignToHtmlAsync, transformPrintDesignToHtmlBatches, writeTableCell };