@vue-ui-kit/ant 2.5.0 → 2.5.2

package/dist/index.d.ts

@@ -167,19 +167,31 @@ declare class BaseCell {
     y: number;
     width: number;
     height: number;
+    visibleWidth: number;
+    visibleHeight: number;
     fixed?: Fixed;
     cellType: CellType;
+    drawX: number;
+    drawY: number;
+    cellImages: Map<string, CellImage>;
     constructor(ctx: Context, x: number, y: number, width: number, height: number, cellType: CellType, fixed?: Fixed);
     isHorizontalVisible(): boolean;
     isVerticalVisible(): boolean;
     getDrawX(): number;
     getDrawY(): number;
     getLeftFixedX(): number;
+    isInside(x: number, y: number): boolean;
     /**
-     * RightFixed时相对StageX
+     * 判断是否在可见区域,合并单元格用
+     * @param x
+     * @param y
      * @returns
      */
-    getRightFixedX(): void;
+    isInsideVisible(x: number, y: number): boolean;
+    setImage(key: string, image: CellImage): void;
+    getImages(): Map<string, CellImage>;
+    getImage(key: string): CellImage | undefined;
+    isImageInside(key: string, e: MouseEvent): boolean;
 }
 
 declare type BeforeAutofillDataMethod = (changeList: BeforeChangeItem[], xArr: number[], yArr: number[]) => BeforeChangeItem[] | Promise<BeforeChangeItem[]>;
@@ -205,6 +217,14 @@ declare type BeforeCopyParams = {
     yArr: number[];
 };
 
+declare type BeforeDragRowMethod = (params: BeforeDragRowParams) => boolean | Promise<boolean>;
+
+declare type BeforeDragRowParams = {
+    source: Cell;
+    target: Cell;
+    position: TreeUtilPosition;
+};
+
 declare type BeforeHeaderContextMenuMethod = (params: ContextMenuItemParams) => MenuItem[] | Promise<MenuItem[]>;
 
 declare type BeforePasteDataMethod = (changeList: BeforeChangeItem[], xArr: number[], yArr: number[], textArr: string[][]) => BeforeChangeItem[] | Promise<BeforeChangeItem[]>;
@@ -281,6 +301,8 @@ export declare interface CanvasTableProps<T extends Recordable = Recordable, B e
 }
 
 declare class Cell extends BaseCell {
+    parentRowKey: string;
+    parentRowKeys: string[];
     formatter?: FormatterMethod;
     formatterFooter?: FormatterMethod;
     hoverIconName?: string;
@@ -327,24 +349,6 @@ declare class Cell extends BaseCell {
     drawTextY: number;
     drawTextWidth: number;
     drawTextHeight: number;
-    drawTreeImageX: number;
-    drawTreeImageY: number;
-    drawTreeImageWidth: number;
-    drawTreeImageHeight: number;
-    drawTreeImageName: string;
-    drawTreeImageSource?: HTMLImageElement;
-    drawSelectionImageX: number;
-    drawSelectionImageY: number;
-    drawSelectionImageWidth: number;
-    drawSelectionImageHeight: number;
-    drawSelectionImageName: string;
-    drawSelectionImageSource?: HTMLImageElement;
-    drawHoverImageX: number;
-    drawHoverImageY: number;
-    drawHoverImageWidth: number;
-    drawHoverImageHeight: number;
-    drawHoverImageName: string;
-    drawHoverImageSource?: HTMLImageElement;
     autoRowHeight: boolean;
     calculatedHeight: number;
     ellipsis: boolean;
@@ -355,6 +359,11 @@ declare class Cell extends BaseCell {
     overflowTooltipMaxWidth: number;
     overflowTooltipPlacement: OverflowTooltipPlacement;
     maxLineClamp: LineClampType;
+    precision?: number;
+    min?: number;
+    max?: number;
+    maxlength?: number;
+    mixedRender?: boolean;
     renderType: RenderType;
     renderFooterType: RenderType;
     constructor(ctx: Context, rowIndex: number, colIndex: number, x: number, y: number, width: number, height: number, column: Column, row: any, cellType?: CellType, isUpdate?: boolean);
@@ -371,7 +380,9 @@ declare class Cell extends BaseCell {
      * 更新样式
      */
     updateStyle(): void;
+    isInsideVisible(x: number, y: number): boolean;
     private updateTree;
+    private updateDragImage;
     private drawTreeLine;
     private updateContainer;
     private updateSelection;
@@ -471,6 +482,9 @@ declare class CellHeader extends BaseCell {
     visibleHeight: number;
     maxLineClampHeader: LineClampType;
     domDataset: any;
+    textOffsetRight: number;
+    textOffsetLeft: number;
+    textInfo: TextInfo | undefined;
     drawTextX: number;
     drawTextY: number;
     drawTextWidth: number;
@@ -502,13 +516,16 @@ declare class CellHeader extends BaseCell {
      */
     updateStyle(): void;
     updateContainer(): void;
+    private updateOffset;
     update(): void;
     draw(): void;
+    drawImages(): void;
     private drawEdge;
     private drawText;
+    private drawRequired;
     private drawBg;
-    private drawSelection;
-    private drawSortIcon;
+    private updateSelection;
+    private updateSortIcon;
     getText(): string;
     /**
      * 获取样式
@@ -534,6 +551,20 @@ declare type CellHeaderStyleMethod = (params: CellHeaderParams) => CellStyleOpti
 
 declare type CellHoverIconMethod = (params: CellParams) => string | void;
 
+declare class CellImage {
+    source?: HTMLImageElement;
+    name: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    visible: boolean;
+    constructor(name: string, x: number, y: number, width: number, height: number, source?: HTMLImageElement);
+    drawWrapper(ctx: Context, options: RectOptions): void;
+    setVisible(visible: boolean): void;
+    isInside(mouseX: number, mouseY: number): boolean;
+}
+
 declare type CellParams = {
     row: any;
     rowIndex: number;
@@ -630,12 +661,18 @@ declare interface Column {
     column?: Column;
     rules?: Rules | Rule;
     options?: any;
+    dragRow?: boolean;
     dragDisabled?: boolean;
     hideDisabled?: boolean;
     fixedDisabled?: boolean;
     selectorCellValueType?: SelectorCellValueType;
     maxLineClamp?: LineClampType;
     maxLineClampHeader?: LineClampType;
+    precision?: number;
+    min?: number;
+    max?: number;
+    maxlength?: number;
+    mixedRender?: boolean;
 }
 
 export declare interface ColumnProps<D extends Recordable = Recordable> extends Omit<TableColumnType, 'slots'> {
@@ -681,8 +718,6 @@ declare class Config {
     EMPTY_BODY_HEIGHT: number;
     /** 自定义空样式 */
     EMPTY_CUSTOM_STYLE: Partial<CSSStyleDeclaration>;
-    /** 数字类型错误提示 */
-    NUMBER_ERROR_TIP: string;
     /** 空数据文本 */
     EMPTY_TEXT: string;
     /** 加载文本 */
@@ -747,6 +782,12 @@ declare class Config {
     CELL_HOVER_ICON_BG_COLOR: string;
     /** hover编辑图标边框颜色 */
     CELL_HOVER_ICON_BORDER_COLOR: string;
+    /** 内容缩放最小比例 */
+    MIN_ZOOM: number;
+    /** 内容缩放最大比例 */
+    MAX_ZOOM: number;
+    /** 启用 Ctrl + 滚轮内容缩放 */
+    ENABLE_ZOOM_WHEEL: boolean;
     /** 滚动条轨道尺寸 */
     SCROLLER_TRACK_SIZE: number;
     /** 滚动条滑块尺寸 */
@@ -881,6 +922,8 @@ declare class Config {
     ENABLE_CONTEXT_MENU: boolean;
     /** 启用表头右键菜单 */
     ENABLE_HEADER_CONTEXT_MENU: boolean;
+    /** 启用文字选中复制 */
+    ENABLE_TEXT_SELECTION: boolean;
     /** 启用复制 */
     ENABLE_COPY: boolean;
     /** 启用粘贴 */
@@ -942,6 +985,20 @@ declare class Config {
     AUTO_ROW_HEIGHT: boolean;
     /** 启用拖拽表头 */
     ENABLE_DRAG_COLUMN: boolean;
+    /** 启用拖拽行 */
+    ENABLE_DRAG_ROW: boolean;
+    /** 启用拖拽行跨级,针对tree数据结构 */
+    ENABLE_DRAG_ROW_CROSS_LEVEL: boolean;
+    /** 启用拖拽行自定义 */
+    ENABLE_DRAG_ROW_CUSTOM: boolean;
+    /** 拖拽提示线颜色 */
+    DRAG_ROW_TIP_LINE_COLOR: string;
+    /** 拖拽行图标 */
+    DRAG_ROW_ICON_SVG: string;
+    /** 拖拽行图标大小 */
+    DRAG_ROW_ICON_SIZE: number;
+    /** 拖拽行图标颜色 */
+    DRAG_ROW_ICON_COLOR: string;
     /** header 格子样式 */
     HEADER_CELL_STYLE_METHOD?: CellHeaderStyleMethod;
     /** body 格子样式 */
@@ -984,6 +1041,7 @@ declare class Config {
     BEFORE_BODY_CONTEXT_MENU_METHOD?: BeforeBodyContextMenuMethod;
     /** 数据复制前回调 */
     BEFORE_COPY_METHOD?: BeforeCopyMethod;
+    BEFORE_DRAG_ROW_METHOD?: BeforeDragRowMethod;
     constructor(config: Partial<Config>);
     /** 初始化 */
     init(config: ConfigType): void;
@@ -995,7 +1053,7 @@ declare type ConfigColorNameType = 'LOADING_ICON_COLOR' | 'EXPAND_ICON_COLOR' |
 
 declare type ConfigType = Partial<Config>;
 
-declare type ConfigTypeName = 'LOADING_ICON_SVG' | 'EXPAND_ICON_SVG' | 'SHRINK_ICON_SVG' | 'CHECKBOX_UNCHECK_SVG' | 'CHECKBOX_CHECK_SVG' | 'CHECKBOX_DISABLED_SVG' | 'ICON_EDIT_SVG' | 'ICON_SELECT_SVG' | 'CHECKBOX_CHECK_DISABLED_SVG' | 'CHECKBOX_INDETERMINATE_SVG' | 'SORT_ASC_ICON_SVG' | 'SORT_DESC_ICON_SVG' | 'SORTABLE_ICON_SVG';
+declare type ConfigTypeName = 'LOADING_ICON_SVG' | 'EXPAND_ICON_SVG' | 'SHRINK_ICON_SVG' | 'CHECKBOX_UNCHECK_SVG' | 'CHECKBOX_CHECK_SVG' | 'CHECKBOX_DISABLED_SVG' | 'ICON_EDIT_SVG' | 'ICON_SELECT_SVG' | 'CHECKBOX_CHECK_DISABLED_SVG' | 'CHECKBOX_INDETERMINATE_SVG' | 'SORT_ASC_ICON_SVG' | 'SORT_DESC_ICON_SVG' | 'SORTABLE_ICON_SVG' | 'DRAG_ROW_ICON_SVG';
 
 declare type containerElementOptions = {
     containerElement: HTMLDivElement;
@@ -1012,6 +1070,7 @@ declare class Context {
     private eventBus;
     private eventBrowser;
     private eventTable;
+    locale: Locale;
     containerElement: HTMLDivElement;
     stageElement: HTMLDivElement;
     canvasElement: HTMLCanvasElement;
@@ -1022,12 +1081,17 @@ declare class Context {
     loadingElement?: HTMLDivElement;
     stageWidth: number;
     stageHeight: number;
+    stagePhysicalWidth: number;
+    stagePhysicalHeight: number;
+    zoomScale: ZoomScale;
+    get zoom(): number;
     paint: Paint;
     icons: Icons;
     domSelectionStr: string;
+    textSelectionStr: string;
+    textSelecting: boolean;
     isMouseoverTargetContainer: boolean;
     mousedown: boolean;
-    isPointer: boolean;
     isEmpty: boolean;
     rowResizing: boolean;
     columnResizing: boolean;
@@ -1039,6 +1103,7 @@ declare class Context {
     selectColsIng: boolean;
     selectRowsIng: boolean;
     dragHeaderIng: boolean;
+    dragRowIng: boolean;
     finding: boolean;
     contextMenuIng: boolean;
     editing: boolean;
@@ -1101,6 +1166,12 @@ declare class Context {
         offsetX: number;
         offsetY: number;
     };
+    toVisual(value: number): number;
+    toLogical(value: number): number;
+    toVisualPx(value: number): string;
+    scaleStyle<T extends Record<string, any>>(style: T): T;
+    setZoom(zoom: number): void;
+    getZoom(): number;
     hasEvent(event: string): boolean;
     on(event: string, callback: EventCallback): void;
     once(event: string, callback: EventCallback): void;
@@ -1197,6 +1268,7 @@ declare class Database {
     getColumns(): Column[];
     setColumns(columns: Column[]): void;
     setData(data: any[]): void;
+    getOriginalData(): any[];
     /**
      * 统一转化数据，给画body使用，包括过滤树状等，统一入口
      * @returns
@@ -1456,6 +1528,31 @@ declare const _default: {
 };
 export default _default;
 
+declare const _default_2: {
+    numberErrorTip: string;
+    emptyText: string;
+    loadingText: string;
+    copy: string;
+    cut: string;
+    paste: string;
+    clearSelected: string;
+    fixedLeft: string;
+    fixedRight: string;
+    fixedNone: string;
+    hide: string;
+    visible: string;
+    resetHeader: string;
+    invalidNumber: string;
+    mergeCellNoFill: string;
+    mergeCellNoCopy: string;
+    mergeCellNoPaste: string;
+    numberTruncated: string;
+    batchSetItemValueError: string;
+    numberMin: string;
+    numberMax: string;
+    stringMaxlength: string;
+};
+
 declare type DefaultFactory<T> = (() => T) | T
 
 export declare const defaultItemResponsive: Responsive;
@@ -1476,6 +1573,7 @@ declare type DrawTextOptions = {
     offsetLeft?: number;
     offsetRight?: number;
     textCallback?: (textInfo: TextInfo) => void;
+    layoutCallback?: (layout: TextLayout) => void;
     cacheTextKey?: string;
 };
 
@@ -1489,6 +1587,7 @@ declare type EventCallback = (...args: any[]) => void;
 declare type EventCallback_2 = (...args: any[]) => void;
 
 declare class EVirtTable {
+    static locale: LangConfig;
     private options;
     private scroller;
     private header;
@@ -1503,8 +1602,10 @@ declare class EVirtTable {
     private contextMenu;
     private loading;
     private finderBar;
+    private textSelector;
     private animationFrameId;
     ctx: Context;
+    static useLocale(langConfig: LangConfig): void;
     constructor(target: HTMLDivElement, options: EVirtTableOptions);
     private createContainer;
     private doDraw;
@@ -1532,6 +1633,12 @@ declare class EVirtTable {
     clearEditableData(value?: null): ChangeItem[];
     clearEditor(): void;
     doLayout(): void;
+    /**
+     * 设置内容缩放比例(容器大小不变,内容变大/变小,基于原生分辨率重绘不失清晰度)
+     * @param zoom 缩放比例,范围 MIN_ZOOM ~ MAX_ZOOM
+     */
+    setZoom(zoom: number): void;
+    getZoom(): number;
     getChangedData(): {
         rowKey: string;
         colKey: string;
@@ -1584,6 +1691,7 @@ declare class EVirtTable {
     getColumnByKey(key: string): Column | undefined;
     clearChangeData(): void;
     getReadonly(rowKey: string, key: string): any;
+    useLocale(langConfig: LangConfig): void;
     /**
      * 销毁
      */
@@ -1749,6 +1857,8 @@ export declare interface ItemRender {
 
 export declare const labelColDict: Record<number, Responsive>;
 
+declare type LangConfig = typeof _default_2;
+
 declare type LineClampType = number | 'auto';
 
 declare type LineOptions = {
@@ -1761,8 +1871,14 @@ declare type LineOptions = {
     fillColor?: string | CanvasGradient | CanvasPattern;
 };
 
+declare class Locale {
+    private langConfig?;
+    use(langConfig: LangConfig): void;
+    getText(key: string, params?: Record<string, any>): string;
+}
+
 declare type MenuItem = {
-    label: string;
+    label?: string;
     value: string | MenuItemEvent;
     event?: Function;
     icon?: string;
@@ -1815,8 +1931,9 @@ declare class Paint {
     private ctx;
     private textCacheMap;
     constructor(target: HTMLCanvasElement);
+    getCtx(): CanvasRenderingContext2D;
     clearTextCache(): void;
-    scale(dpr: number): void;
+    scale(dpr: number, zoom?: number): void;
     save(): void;
     restore(): void;
     translate(x: number, y: number): void;
@@ -1847,6 +1964,10 @@ declare class Paint {
      * @returns 是否溢出
      */
     drawText(text: string | undefined, x: number, y: number, width: number, height: number, options?: DrawTextOptions): boolean;
+    private buildTextLayout;
+    private wrapTextToLines;
+    private buildEllipsisLine;
+    private buildLineSegments;
     /**
      * 将文本按宽度换行
      * @param text
@@ -2557,6 +2678,8 @@ export declare const PCanvasGrid: <D extends Recordable = Recordable, F extends
     attrs: any;
     slots: Partial<Record<number, (_: {
         cell: Cell | CellHeader;
+        parentRowKey: string;
+        parentRowKeys: string[];
         formatter?: FormatterMethod;
         formatterFooter?: FormatterMethod;
         hoverIconName?: string;
@@ -2603,24 +2726,6 @@ export declare const PCanvasGrid: <D extends Recordable = Recordable, F extends
         drawTextY: number;
         drawTextWidth: number;
         drawTextHeight: number;
-        drawTreeImageX: number;
-        drawTreeImageY: number;
-        drawTreeImageWidth: number;
-        drawTreeImageHeight: number;
-        drawTreeImageName: string;
-        drawTreeImageSource?: HTMLImageElement;
-        drawSelectionImageX: number;
-        drawSelectionImageY: number;
-        drawSelectionImageWidth: number;
-        drawSelectionImageHeight: number;
-        drawSelectionImageName: string;
-        drawSelectionImageSource?: HTMLImageElement;
-        drawHoverImageX: number;
-        drawHoverImageY: number;
-        drawHoverImageWidth: number;
-        drawHoverImageHeight: number;
-        drawHoverImageName: string;
-        drawHoverImageSource?: HTMLImageElement;
         autoRowHeight: boolean;
         calculatedHeight: number;
         ellipsis: boolean;
@@ -2631,6 +2736,11 @@ export declare const PCanvasGrid: <D extends Recordable = Recordable, F extends
         overflowTooltipMaxWidth: number;
         overflowTooltipPlacement: OverflowTooltipPlacement;
         maxLineClamp: LineClampType;
+        precision?: number;
+        min?: number;
+        max?: number;
+        maxlength?: number;
+        mixedRender?: boolean;
         renderType: RenderType;
         renderFooterType: RenderType;
         ctx: Context;
@@ -2638,6 +2748,7 @@ export declare const PCanvasGrid: <D extends Recordable = Recordable, F extends
         y: number;
         width: number;
         height: number;
+        cellImages: Map<string, CellImage>;
     } | {
         cell: Cell | CellHeader;
         align: Align;
@@ -2679,6 +2790,9 @@ export declare const PCanvasGrid: <D extends Recordable = Recordable, F extends
         visibleHeight: number;
         maxLineClampHeader: LineClampType;
         domDataset: any;
+        textOffsetRight: number;
+        textOffsetLeft: number;
+        textInfo: TextInfo | undefined;
         drawTextX: number;
         drawTextY: number;
         drawTextWidth: number;
@@ -2705,6 +2819,7 @@ export declare const PCanvasGrid: <D extends Recordable = Recordable, F extends
         width: number;
         height: number;
         cellType: CellType;
+        cellImages: Map<string, CellImage>;
     }) => any>>;
     emit: {
         (event: "toolbarButtonClick", data: {
@@ -2776,6 +2891,8 @@ export declare const PCanvasTable: <T extends Recordable = Recordable, B extends
     attrs: any;
     slots: Partial<Record<string, (_: {
         cell: Cell | CellHeader;
+        parentRowKey: string;
+        parentRowKeys: string[];
         formatter?: FormatterMethod;
         formatterFooter?: FormatterMethod;
         hoverIconName?: string;
@@ -2822,24 +2939,6 @@ export declare const PCanvasTable: <T extends Recordable = Recordable, B extends
         drawTextY: number;
         drawTextWidth: number;
         drawTextHeight: number;
-        drawTreeImageX: number;
-        drawTreeImageY: number;
-        drawTreeImageWidth: number;
-        drawTreeImageHeight: number;
-        drawTreeImageName: string;
-        drawTreeImageSource?: HTMLImageElement;
-        drawSelectionImageX: number;
-        drawSelectionImageY: number;
-        drawSelectionImageWidth: number;
-        drawSelectionImageHeight: number;
-        drawSelectionImageName: string;
-        drawSelectionImageSource?: HTMLImageElement;
-        drawHoverImageX: number;
-        drawHoverImageY: number;
-        drawHoverImageWidth: number;
-        drawHoverImageHeight: number;
-        drawHoverImageName: string;
-        drawHoverImageSource?: HTMLImageElement;
         autoRowHeight: boolean;
         calculatedHeight: number;
         ellipsis: boolean;
@@ -2850,6 +2949,11 @@ export declare const PCanvasTable: <T extends Recordable = Recordable, B extends
         overflowTooltipMaxWidth: number;
         overflowTooltipPlacement: OverflowTooltipPlacement;
         maxLineClamp: LineClampType;
+        precision?: number;
+        min?: number;
+        max?: number;
+        maxlength?: number;
+        mixedRender?: boolean;
         renderType: RenderType;
         renderFooterType: RenderType;
         ctx: Context;
@@ -2857,6 +2961,7 @@ export declare const PCanvasTable: <T extends Recordable = Recordable, B extends
         y: number;
         width: number;
         height: number;
+        cellImages: Map<string, CellImage>;
     } | {
         cell: Cell | CellHeader;
         align: Align;
@@ -2898,6 +3003,9 @@ export declare const PCanvasTable: <T extends Recordable = Recordable, B extends
         visibleHeight: number;
         maxLineClampHeader: LineClampType;
         domDataset: any;
+        textOffsetRight: number;
+        textOffsetLeft: number;
+        textInfo: TextInfo | undefined;
         drawTextX: number;
         drawTextY: number;
         drawTextWidth: number;
@@ -2924,6 +3032,7 @@ export declare const PCanvasTable: <T extends Recordable = Recordable, B extends
         width: number;
         height: number;
         cellType: CellType;
+        cellImages: Map<string, CellImage>;
     }) => any>> & {
         empty?(_: {}): any;
     };
@@ -5133,6 +5242,16 @@ declare interface SvgIcon extends IconType {
     configColorName?: ConfigColorNameType;
 }
 
+declare type TextGlyph = {
+    char: string;
+    index: number;
+    line: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+
 declare type TextInfo = {
     x: number;
     y: number;
@@ -5144,6 +5263,56 @@ declare type TextInfo = {
     bottom: number;
 };
 
+declare type TextLayout = {
+    text: string;
+    chars: string[];
+    glyphs: TextGlyph[];
+    lines: TextLayoutLine[];
+    box: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    contentBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    contentY: number;
+    lineHeight: number;
+    font: string;
+    color: string;
+    align: Align;
+    ellipsis: boolean;
+};
+
+declare type TextLayoutLine = {
+    items: TextLineItem[];
+    text: string;
+    caretIndex: number;
+    lineIndex: number;
+    drawX: number;
+    drawY: number;
+    width: number;
+    segments: TextLineSegment[];
+};
+
+declare type TextLineItem = {
+    char: string;
+    sourceIndex: number;
+    ellipsis?: boolean;
+};
+
+declare type TextLineSegment = {
+    char: string;
+    itemIndex: number;
+    sourceIndex: number;
+    x: number;
+    width: number;
+};
+
 export declare interface ToolbarButtonProps extends PButtonProps {
     code?: string;
     dropdowns?: ToolbarButtonProps[];
@@ -5165,6 +5334,8 @@ export declare interface TooltipConfig extends TooltipProps {
 
 declare type TreeSelectMode = 'auto' | 'cautious' | 'strictly';
 
+declare type TreeUtilPosition = 'none' | 'before' | 'after' | 'inside';
+
 declare type Type = 'index' | 'selection' | 'index-selection' | 'tree' | 'selection-tree' | 'tree-selection' | 'number';
 
 export declare interface UIKitConfig {
@@ -5214,6 +5385,17 @@ declare type ValidatorFunction<T> = (value: T) => boolean
 
 declare type VerticalAlign = 'top' | 'middle' | 'bottom';
 
+declare type ViewportRect = {
+    x: number;
+    y: number;
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+};
+
 declare interface VueTypeBaseDef<
 T = unknown,
 D = DefaultType<T>,
@@ -5238,4 +5420,48 @@ declare interface VueTypeValidableDef<T = unknown> extends VueTypeBaseDef<T> {
 
 export declare function watchPreviousDeep<T extends object>(source: WatchSource<T>, cb: (value: T, oldValue: T, onCleanup: () => void) => void, options?: WatchOptions): WatchHandle;
 
+/** 内容缩放：逻辑坐标 ↔ 物理像素，canvas / DOM 共用 */
+declare class ZoomScale {
+    value: number;
+    get isDefault(): boolean;
+    clamp(value: number, min: number, max: number): number;
+    /** @returns 是否发生变化 */
+    set(value: number, min: number, max: number): boolean;
+    /** 逻辑 -> 物理 */
+    toVisual(logical: number): number;
+    /** 物理 -> 逻辑 */
+    toLogical(physical: number): number;
+    toPx(logical: number): string;
+    /** DOM 测量高度 -> 逻辑高度 */
+    domHeightToLogical(physicalHeight: number): number;
+    /** 逻辑内容尺寸 -> 物理尺寸 */
+    contentToPhysical(logical: number): number;
+    scaleStyle<T extends Record<string, any>>(style: T): T;
+    assignScaledStyle(el: HTMLElement, style: Record<string, any>): void;
+    /** 容器物理宽度 -> 逻辑可视宽度 */
+    containerWidth(containerPhysicalWidth: number): number;
+    resolveStageWidth(options: {
+        containerPhysicalWidth: number;
+        contentWidth: number;
+        scrollerTrackSize: number;
+        fillContainer: boolean;
+    }): {
+        stageWidth: number;
+        stagePhysicalWidth: number;
+    };
+    applyStageHeight(stageElement: HTMLDivElement, physicalHeight: number): {
+        stageHeight: number;
+        stagePhysicalHeight: number;
+    };
+    /** floating-ui 锚点：逻辑单元格 -> 视口物理矩形 */
+    getViewportRect(logical: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, containerRect: DOMRect): ViewportRect;
+    /** overlayer 单元格：外层物理定位 + 内层 zoom 缩放自定义 render */
+    createOverlayerCellElement(cell: Cell | CellHeader, cssPrefix: string): HTMLDivElement;
+}
+
 export { }