@taocompany/magic-grid 0.1.6 → 0.3.0

package/dist/components/MagicGrid/MagicGrid.vue.d.ts

@@ -1,18 +1,29 @@
-import { PropType } from 'vue';
+import { PropType, DefineComponent, ExtractPropTypes, ShallowRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
 import { GridApi } from '../../core/api/gridApi';
 import { RowSelectionInput } from '../../core/types/rowSelectionOptions';
-import { CellEditorFn, CellEditType, EditMode } from '../../core/types/cellEditor';
+import { CellEditorFn, CellEditType, CellEditBehavior } from '../../core/types/cellEditor';
 import { RowValidator, InvalidEditValueMode } from '../../core/types/validation';
 import { AsyncRowMutationHandlers } from '../../core/types/rowMutationAsync';
 import { GridMetrics } from '../../core/grid/gridMetrics';
 import { CellClickedEvent, RowClickedEvent, RowDoubleClickedEvent, CellValueChangedEvent, CellEditingStartedEvent, CellEditingStoppedEvent, RowEditingStartedEvent, RowEditingStoppedEvent, RowValueChangedEvent, CellCommitStartedEvent, CellCommitFinishedEvent, EditCommitAbortedEvent, RowCommitStartedEvent, RowCommitFinishedEvent, CellValidationFailedEvent, RowValidationFailedEvent, RowsAddedEvent, RowsRemovedEvent, RowIdPromotedEvent, FilterModel, RowNodeTransaction, RowTransaction, SelectionChangedEvent, IndexFocusChangedEvent, SortModelItem, ColumnMovedEvent, ColumnResizedEvent, ColumnPinnedEvent, ColumnHiddenChangedEvent, RowMovedEvent, RowDragEndEvent, RowDragCommitStartedEvent, RowDragCommitFinishedEvent, RowHeightChangedEvent, RowExpansionChangedEvent, RowGroupChangedEvent, RowGroupOpenedEvent } from '../../core/types';
-import { TreeChildrenLoadedEvent, TreeChildrenLoadFailedEvent, TreeChildrenLoadingEvent, TreeNodeOpenedEvent } from '../../core/types/treeTable';
+import { TreeChildrenLoadedEvent, TreeChildrenLoadFailedEvent, TreeChildrenLoadingEvent, TreeNodeOpenedEvent, GetDataPathFn, TreeValueGetterFn, TreeDisplayType, TreeDragScope, SetDataPathFn, HasTreeChildrenFn, LoadTreeChildrenFn } from '../../core/types/treeTable';
 import { CellCommentChangedEvent, CellCommentsDataSource, CellCommentTrigger } from '../../core/types/cellComment';
 import { CellSelectionChangedEvent, CellSelectionDeleteEndEvent, CellSelectionDeleteStartEvent, CellSelectionOptions } from '../../core/types/cellRangeSelection';
-import { MagicGridBorder, MagicGridHorizontalAlign, MagicGridSize, MagicGridTheme, MagicGridVerticalAlign, IndexColumnOptions, SelectionColumnOptions, SelectableFn, IsRowDisabledFn, RowStyle, RowData, SummaryMethod, SummaryScope, ColumnDef } from '../../types';
+import { GridBorder, GridHorizontalAlign, GridSize, GridTheme, GridVerticalAlign, IndexColumnOptions, SelectionColumnOptions, SelectableFn, IsRowDisabledFn, RowStyle, RowData, SummaryMethod, SummaryScope, ColumnDef, CellSelectionAggregation, ResolvedStatusBarRangeAggregationPrecision, OverlayShownEvent, OverlayHiddenEvent, TooltipComponentFactory, GroupKeyCreatorFn, GroupComparatorFn, TreeValueGetterFn, GetDataPathFn, GetRowHeightFn, AutoSizeStrategy, OverlayType, OverlayComponentFactory, RowDragCommitMode, RowDragCommitHandler, IsRowMasterFn, DetailRowHeightFn, GetDetailRowDataFn, DetailCellRendererFn, GroupDisplayType, GroupCellRendererFn, TreeDragScope, SetDataPathFn, HasTreeChildrenFn, LoadTreeChildrenFn, ProcessCellForClipboardFn, ProcessCellFromClipboardFn, ProcessDataFromClipboardFn, TooltipShowMode, StatusBarHeightInput, StatusBarRangeAggregationPosition, StatusBarRangeAggregationPrecisionInput } from '../../types/core.ts';
+import { GridSize, StatusBarHeightInput } from '../../core/theme/gridSize';
+import { AutoSizeStrategy } from '../../core/types/columnAutosize';
+import { StatusBarRangeAggregationPosition, StatusBarRangeAggregationPrecisionInput } from '../../types/status-bar';
+import { RowDragCommitMode, RowDragCommitHandler } from '../../core/types/rowDrag';
+import { GetRowHeightFn } from '../../core/types/rowHeight';
+import { IsRowMasterFn, DetailRowHeightFn, GetDetailRowDataFn, DetailCellRendererFn } from '../../core/types/rowExpansion';
+import { GroupDisplayType, GroupKeyCreatorFn, GroupComparatorFn, GroupCellRendererFn } from '../../core/types/rowGrouping';
+import { ProcessCellForClipboardFn, ProcessCellFromClipboardFn, ProcessDataFromClipboardFn } from '../../core/types/cellClipboard';
+import { TooltipShowMode, TooltipComponentType } from '../../core/types/overflowTooltip';
+import { OverlayType, OverlayComponentType } from '../../core/types/emptyState';
+import { GetDataOptions } from '../../core/types/rowMutation';
 declare var __VLS_1: {
     api: GridApi | undefined;
-    size: import('../../core/theme/gridSize').MagicGridSize;
+    size: GridSize;
     portalEl: HTMLElement | undefined;
 }, __VLS_3: {
     api: GridApi | undefined;
@@ -22,10 +33,10 @@ declare var __VLS_1: {
     selectedRowCount: number;
     rowSelectionEnabled: boolean;
     cellSelectionEnabled: boolean;
-    cellSelectionAggregation: import('../../core/types').CellSelectionAggregation | null;
-    statusBarRangeAggregationPrecision: import('../../types').ResolvedStatusBarRangeAggregationPrecision;
+    cellSelectionAggregation: CellSelectionAggregation | null;
+    statusBarRangeAggregationPrecision: ResolvedStatusBarRangeAggregationPrecision;
     metrics: GridMetrics | undefined;
-}, __VLS_5: {
+}, __VLS_10: {
     api: GridApi | undefined;
     totalRowCount: number;
     displayedRowCount: number;
@@ -33,10 +44,10 @@ declare var __VLS_1: {
     selectedRowCount: number;
     rowSelectionEnabled: boolean;
     cellSelectionEnabled: boolean;
-    cellSelectionAggregation: import('../../core/types').CellSelectionAggregation | null;
-    statusBarRangeAggregationPrecision: import('../../types').ResolvedStatusBarRangeAggregationPrecision;
+    cellSelectionAggregation: CellSelectionAggregation | null;
+    statusBarRangeAggregationPrecision: ResolvedStatusBarRangeAggregationPrecision;
     metrics: GridMetrics | undefined;
-}, __VLS_17: {
+}, __VLS_22: {
     api: GridApi | undefined;
     totalRowCount: number;
     displayedRowCount: number;
@@ -44,8 +55,8 @@ declare var __VLS_1: {
     selectedRowCount: number;
     rowSelectionEnabled: boolean;
     cellSelectionEnabled: boolean;
-    cellSelectionAggregation: import('../../core/types').CellSelectionAggregation | null;
-    statusBarRangeAggregationPrecision: import('../../types').ResolvedStatusBarRangeAggregationPrecision;
+    cellSelectionAggregation: CellSelectionAggregation | null;
+    statusBarRangeAggregationPrecision: ResolvedStatusBarRangeAggregationPrecision;
     metrics: GridMetrics | undefined;
 };
 type __VLS_Slots = {} & {
@@ -53,11 +64,11 @@ type __VLS_Slots = {} & {
 } & {
     'status-bar'?: (props: typeof __VLS_3) => any;
 } & {
-    'status-bar-left'?: (props: typeof __VLS_5) => any;
+    'status-bar-left'?: (props: typeof __VLS_10) => any;
 } & {
-    'status-bar-right'?: (props: typeof __VLS_17) => any;
+    'status-bar-right'?: (props: typeof __VLS_22) => any;
 };
-declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+declare const __VLS_base: DefineComponent<ExtractPropTypes<{
     columns: {
         type: PropType<ColumnDef[]>;
         required: true;
@@ -79,15 +90,15 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     border: {
-        type: PropType<MagicGridBorder>;
+        type: PropType<GridBorder>;
         default: string;
     };
     theme: {
-        type: PropType<MagicGridTheme>;
+        type: PropType<GridTheme>;
         default: string;
     };
     size: {
-        type: PropType<MagicGridSize>;
+        type: PropType<GridSize>;
         default: string;
     };
     rounded: {
@@ -139,27 +150,27 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     headerAlign: {
-        type: PropType<MagicGridHorizontalAlign>;
+        type: PropType<GridHorizontalAlign>;
         default: undefined;
     };
     headerValign: {
-        type: PropType<MagicGridVerticalAlign>;
+        type: PropType<GridVerticalAlign>;
         default: undefined;
     };
     align: {
-        type: PropType<MagicGridHorizontalAlign>;
+        type: PropType<GridHorizontalAlign>;
         default: undefined;
     };
     valign: {
-        type: PropType<MagicGridVerticalAlign>;
+        type: PropType<GridVerticalAlign>;
         default: undefined;
     };
     footerAlign: {
-        type: PropType<MagicGridHorizontalAlign>;
+        type: PropType<GridHorizontalAlign>;
         default: undefined;
     };
     footerValign: {
-        type: PropType<MagicGridVerticalAlign>;
+        type: PropType<GridVerticalAlign>;
         default: undefined;
     };
     rowBuffer: {
@@ -186,8 +197,8 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         type: BooleanConstructor;
         default: boolean;
     };
-    editMode: {
-        type: PropType<EditMode>;
+    editBehavior: {
+        type: PropType<CellEditBehavior>;
         default: string;
     };
     editType: {
@@ -243,7 +254,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     autoSizeStrategy: {
-        type: PropType<import('../../core/types/columnAutosize').AutoSizeStrategy>;
+        type: PropType< AutoSizeStrategy>;
         default: undefined;
     };
     suppressMoveWhenColumnDragging: {
@@ -290,14 +301,24 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 状态栏高度：`'auto'` 跟随 size preset；number 为自定义 px */
+    statusBarHeight: {
+        type: PropType< StatusBarHeightInput>;
+        default: string;
+    };
     /** Phase 24.1 · 框选时在状态栏展示平均值/计数/求和；cellSelection 开时默认 true */
     showStatusBarRangeAggregation: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /** Phase 24.1 · 框选聚合 panel 位置；默认 right（右栏内侧） */
+    statusBarRangeAggregationPosition: {
+        type: PropType< StatusBarRangeAggregationPosition>;
+        default: string;
+    };
     /** Phase 24.1 · 平均值/求和展示小数位；默认 2，可分别指定 average/sum */
     statusBarRangeAggregationPrecision: {
-        type: PropType<import('../../types/statusBar').StatusBarRangeAggregationPrecisionInput>;
+        type: PropType< StatusBarRangeAggregationPrecisionInput>;
         default: undefined;
     };
     rowDragManaged: {
@@ -305,15 +326,15 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     rowDragCommitMode: {
-        type: PropType<import('../../core/types/rowDrag').RowDragCommitMode>;
+        type: PropType< RowDragCommitMode>;
         default: string;
     };
     onRowDragCommit: {
-        type: PropType<import('../../core/types/rowDrag').RowDragCommitHandler>;
+        type: PropType< RowDragCommitHandler>;
         default: undefined;
     };
     getRowHeight: {
-        type: PropType<import('../../core/types/rowHeight').GetRowHeightFn>;
+        type: PropType< GetRowHeightFn>;
         default: undefined;
     };
     rowHeightMin: {
@@ -335,7 +356,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     isRowMaster: {
-        type: PropType<import('../../core/types/rowExpansion').IsRowMasterFn>;
+        type: PropType< IsRowMasterFn>;
         default: undefined;
     };
     masterDefaultExpanded: {
@@ -343,7 +364,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     detailRowHeight: {
-        type: PropType<number | import('../../core/types/rowExpansion').DetailRowHeightFn>;
+        type: PropType<number | DetailRowHeightFn>;
         default: undefined;
     };
     detailRowAutoHeight: {
@@ -359,11 +380,11 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     getDetailRowData: {
-        type: PropType<import('../../core/types/rowExpansion').GetDetailRowDataFn>;
+        type: PropType< GetDetailRowDataFn>;
         default: undefined;
     };
     detailCellRenderer: {
-        type: PropType<import('../../core/types/rowExpansion').DetailCellRendererFn>;
+        type: PropType< DetailCellRendererFn>;
         default: undefined;
     };
     /** Phase 18 · 启用行分组 */
@@ -384,7 +405,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     groupDisplayType: {
-        type: PropType<import('../../core/types/rowGrouping').GroupDisplayType>;
+        type: PropType< GroupDisplayType>;
         default: undefined;
     };
     showGroupColumn: {
@@ -396,11 +417,11 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     groupKeyCreator: {
-        type: PropType<import('../../core/types/rowGrouping').GroupKeyCreatorFn>;
+        type: PropType< GroupKeyCreatorFn>;
         default: undefined;
     };
     groupComparator: {
-        type: PropType<import('../../core/types/rowGrouping').GroupComparatorFn>;
+        type: PropType< GroupComparatorFn>;
         default: undefined;
     };
     groupFooterLabel: {
@@ -408,7 +429,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     groupCellRenderer: {
-        type: PropType<import('../../core/types/rowGrouping').GroupCellRendererFn>;
+        type: PropType< GroupCellRendererFn>;
         default: undefined;
     };
     tree: {
@@ -416,7 +437,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     getDataPath: {
-        type: PropType<import('../../core/types/treeTable').GetDataPathFn>;
+        type: PropType< GetDataPathFn>;
         default: undefined;
     };
     showTreeColumn: {
@@ -428,19 +449,19 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     treeValueGetter: {
-        type: PropType<import('../../core/types/treeTable').TreeValueGetterFn>;
+        type: PropType< TreeValueGetterFn>;
         default: undefined;
     };
     treeDisplayType: {
-        type: PropType<import('../../core/types/treeTable').TreeDisplayType>;
+        type: PropType< TreeDisplayType>;
         default: undefined;
     };
     treeDragScope: {
-        type: PropType<import('../../core/types/treeTable').TreeDragScope>;
+        type: PropType< TreeDragScope>;
         default: undefined;
     };
     setDataPath: {
-        type: PropType<import('../../core/types/treeTable').SetDataPathFn>;
+        type: PropType< SetDataPathFn>;
         default: undefined;
     };
     treeLazyLoad: {
@@ -448,11 +469,11 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     hasTreeChildren: {
-        type: PropType<import('../../core/types/treeTable').HasTreeChildrenFn>;
+        type: PropType< HasTreeChildrenFn>;
         default: undefined;
     };
     loadTreeChildren: {
-        type: PropType<import('../../core/types/treeTable').LoadTreeChildrenFn>;
+        type: PropType< LoadTreeChildrenFn>;
         default: undefined;
     };
     cellCommentsDataSource: {
@@ -475,15 +496,11 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         type: NumberConstructor;
         default: undefined;
     };
-    /** Phase 24 · 单元格框选；默认 true（含 enableColumnSelection），handle 默认 off（无 Fill/Range 手柄） */
+    /** Phase 24 · 单元格框选；默认 true（含 enableColumnSelection），handleMode 默认 off（无 Fill/Range 手柄） */
     cellSelection: {
         type: PropType<boolean | CellSelectionOptions>;
         default: boolean;
     };
-    enableCellClipboard: {
-        type: BooleanConstructor;
-        default: undefined;
-    };
     enableCellCopy: {
         type: BooleanConstructor;
         default: undefined;
@@ -501,15 +518,15 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     processCellForClipboard: {
-        type: PropType<import('../../core/types/cellClipboard').ProcessCellForClipboardFn>;
+        type: PropType< ProcessCellForClipboardFn>;
         default: undefined;
     };
     processCellFromClipboard: {
-        type: PropType<import('../../core/types/cellClipboard').ProcessCellFromClipboardFn>;
+        type: PropType< ProcessCellFromClipboardFn>;
         default: undefined;
     };
     processDataFromClipboard: {
-        type: PropType<import('../../core/types/cellClipboard').ProcessDataFromClipboardFn>;
+        type: PropType< ProcessDataFromClipboardFn>;
         default: undefined;
     };
     enableTooltips: {
@@ -517,7 +534,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     tooltipShowMode: {
-        type: PropType<import('../../core/types/overflowTooltip').TooltipShowMode>;
+        type: PropType< TooltipShowMode>;
         default: undefined;
     };
     tooltipShowDelay: {
@@ -541,7 +558,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     tooltipComponent: {
-        type: PropType<import('../../core/types/overflowTooltip').TooltipComponentType>;
+        type: PropType< TooltipComponentType>;
         default: undefined;
     };
     tooltipComponentParams: {
@@ -553,7 +570,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     suppressOverlays: {
-        type: PropType<import('../../core/types/emptyState').OverlayType[]>;
+        type: PropType< OverlayType[]>;
         default: undefined;
     };
     suppressLoadingOverlay: {
@@ -585,7 +602,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     loadingOverlayComponent: {
-        type: PropType<import('../../core/types/emptyState').OverlayComponentType>;
+        type: PropType< OverlayComponentType>;
         default: undefined;
     };
     loadingOverlayComponentParams: {
@@ -593,7 +610,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     noRowsOverlayComponent: {
-        type: PropType<import('../../core/types/emptyState').OverlayComponentType>;
+        type: PropType< OverlayComponentType>;
         default: undefined;
     };
     noRowsOverlayComponentParams: {
@@ -601,7 +618,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     noMatchingRowsOverlayComponent: {
-        type: PropType<import('../../core/types/emptyState').OverlayComponentType>;
+        type: PropType< OverlayComponentType>;
         default: undefined;
     };
     noMatchingRowsOverlayComponentParams: {
@@ -609,7 +626,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     overlayComponent: {
-        type: PropType<import('../../core/types/emptyState').OverlayComponentType>;
+        type: PropType< OverlayComponentType>;
         default: undefined;
     };
     overlayComponentParams: {
@@ -617,19 +634,19 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
 }>, {
-    api: import('vue').ShallowRef<GridApi | undefined, GridApi | undefined>;
+    api: ShallowRef<GridApi | undefined, GridApi | undefined>;
     getMetrics: () => GridMetrics | undefined;
     scrollTo: (scrollTop: number, scrollLeft?: number) => void;
     setSortModel: (model: SortModelItem[]) => void;
     getSortModel: () => SortModelItem[];
     setFilterModel: (model: FilterModel) => void;
-    getData: (options?: import('../../core/types/rowMutation').GetDataOptions) => RowData[];
+    getData: (options?: GetDataOptions) => RowData[];
     applyTransaction: (transaction: RowTransaction) => Promise<RowNodeTransaction | undefined>;
     beginUpdate: () => void;
     endUpdate: () => void;
     ensureIndexVisible: (index: number, position?: "top" | "bottom" | "middle") => void;
     flushFrames: () => void;
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     scroll: (metrics: GridMetrics) => any;
     "data-rendered": (metrics: GridMetrics) => any;
     "cell-clicked": (event: CellClickedEvent) => any;
@@ -676,9 +693,9 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     "cell-selection-changed": (event: CellSelectionChangedEvent) => any;
     "cell-selection-delete-start": (event: CellSelectionDeleteStartEvent) => any;
     "cell-selection-delete-end": (event: CellSelectionDeleteEndEvent) => any;
-    "overlay-shown": (event: import('../../core/types').OverlayShownEvent) => any;
-    "overlay-hidden": (event: import('../../core/types').OverlayHiddenEvent) => any;
-}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    "overlay-shown": (event: OverlayShownEvent) => any;
+    "overlay-hidden": (event: OverlayHiddenEvent) => any;
+}, string, PublicProps, Readonly< ExtractPropTypes<{
     columns: {
         type: PropType<ColumnDef[]>;
         required: true;
@@ -700,15 +717,15 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     border: {
-        type: PropType<MagicGridBorder>;
+        type: PropType<GridBorder>;
         default: string;
     };
     theme: {
-        type: PropType<MagicGridTheme>;
+        type: PropType<GridTheme>;
         default: string;
     };
     size: {
-        type: PropType<MagicGridSize>;
+        type: PropType<GridSize>;
         default: string;
     };
     rounded: {
@@ -760,27 +777,27 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     headerAlign: {
-        type: PropType<MagicGridHorizontalAlign>;
+        type: PropType<GridHorizontalAlign>;
         default: undefined;
     };
     headerValign: {
-        type: PropType<MagicGridVerticalAlign>;
+        type: PropType<GridVerticalAlign>;
         default: undefined;
     };
     align: {
-        type: PropType<MagicGridHorizontalAlign>;
+        type: PropType<GridHorizontalAlign>;
         default: undefined;
     };
     valign: {
-        type: PropType<MagicGridVerticalAlign>;
+        type: PropType<GridVerticalAlign>;
         default: undefined;
     };
     footerAlign: {
-        type: PropType<MagicGridHorizontalAlign>;
+        type: PropType<GridHorizontalAlign>;
         default: undefined;
     };
     footerValign: {
-        type: PropType<MagicGridVerticalAlign>;
+        type: PropType<GridVerticalAlign>;
         default: undefined;
     };
     rowBuffer: {
@@ -807,8 +824,8 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         type: BooleanConstructor;
         default: boolean;
     };
-    editMode: {
-        type: PropType<EditMode>;
+    editBehavior: {
+        type: PropType<CellEditBehavior>;
         default: string;
     };
     editType: {
@@ -864,7 +881,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     autoSizeStrategy: {
-        type: PropType<import('../../core/types/columnAutosize').AutoSizeStrategy>;
+        type: PropType< AutoSizeStrategy>;
         default: undefined;
     };
     suppressMoveWhenColumnDragging: {
@@ -911,14 +928,24 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 状态栏高度：`'auto'` 跟随 size preset；number 为自定义 px */
+    statusBarHeight: {
+        type: PropType< StatusBarHeightInput>;
+        default: string;
+    };
     /** Phase 24.1 · 框选时在状态栏展示平均值/计数/求和；cellSelection 开时默认 true */
     showStatusBarRangeAggregation: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /** Phase 24.1 · 框选聚合 panel 位置；默认 right（右栏内侧） */
+    statusBarRangeAggregationPosition: {
+        type: PropType< StatusBarRangeAggregationPosition>;
+        default: string;
+    };
     /** Phase 24.1 · 平均值/求和展示小数位；默认 2，可分别指定 average/sum */
     statusBarRangeAggregationPrecision: {
-        type: PropType<import('../../types/statusBar').StatusBarRangeAggregationPrecisionInput>;
+        type: PropType< StatusBarRangeAggregationPrecisionInput>;
         default: undefined;
     };
     rowDragManaged: {
@@ -926,15 +953,15 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     rowDragCommitMode: {
-        type: PropType<import('../../core/types/rowDrag').RowDragCommitMode>;
+        type: PropType< RowDragCommitMode>;
         default: string;
     };
     onRowDragCommit: {
-        type: PropType<import('../../core/types/rowDrag').RowDragCommitHandler>;
+        type: PropType< RowDragCommitHandler>;
         default: undefined;
     };
     getRowHeight: {
-        type: PropType<import('../../core/types/rowHeight').GetRowHeightFn>;
+        type: PropType< GetRowHeightFn>;
         default: undefined;
     };
     rowHeightMin: {
@@ -956,7 +983,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     isRowMaster: {
-        type: PropType<import('../../core/types/rowExpansion').IsRowMasterFn>;
+        type: PropType< IsRowMasterFn>;
         default: undefined;
     };
     masterDefaultExpanded: {
@@ -964,7 +991,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     detailRowHeight: {
-        type: PropType<number | import('../../core/types/rowExpansion').DetailRowHeightFn>;
+        type: PropType<number | DetailRowHeightFn>;
         default: undefined;
     };
     detailRowAutoHeight: {
@@ -980,11 +1007,11 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     getDetailRowData: {
-        type: PropType<import('../../core/types/rowExpansion').GetDetailRowDataFn>;
+        type: PropType< GetDetailRowDataFn>;
         default: undefined;
     };
     detailCellRenderer: {
-        type: PropType<import('../../core/types/rowExpansion').DetailCellRendererFn>;
+        type: PropType< DetailCellRendererFn>;
         default: undefined;
     };
     /** Phase 18 · 启用行分组 */
@@ -1005,7 +1032,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     groupDisplayType: {
-        type: PropType<import('../../core/types/rowGrouping').GroupDisplayType>;
+        type: PropType< GroupDisplayType>;
         default: undefined;
     };
     showGroupColumn: {
@@ -1017,11 +1044,11 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     groupKeyCreator: {
-        type: PropType<import('../../core/types/rowGrouping').GroupKeyCreatorFn>;
+        type: PropType< GroupKeyCreatorFn>;
         default: undefined;
     };
     groupComparator: {
-        type: PropType<import('../../core/types/rowGrouping').GroupComparatorFn>;
+        type: PropType< GroupComparatorFn>;
         default: undefined;
     };
     groupFooterLabel: {
@@ -1029,7 +1056,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     groupCellRenderer: {
-        type: PropType<import('../../core/types/rowGrouping').GroupCellRendererFn>;
+        type: PropType< GroupCellRendererFn>;
         default: undefined;
     };
     tree: {
@@ -1037,7 +1064,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     getDataPath: {
-        type: PropType<import('../../core/types/treeTable').GetDataPathFn>;
+        type: PropType< GetDataPathFn>;
         default: undefined;
     };
     showTreeColumn: {
@@ -1049,19 +1076,19 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     treeValueGetter: {
-        type: PropType<import('../../core/types/treeTable').TreeValueGetterFn>;
+        type: PropType< TreeValueGetterFn>;
         default: undefined;
     };
     treeDisplayType: {
-        type: PropType<import('../../core/types/treeTable').TreeDisplayType>;
+        type: PropType< TreeDisplayType>;
         default: undefined;
     };
     treeDragScope: {
-        type: PropType<import('../../core/types/treeTable').TreeDragScope>;
+        type: PropType< TreeDragScope>;
         default: undefined;
     };
     setDataPath: {
-        type: PropType<import('../../core/types/treeTable').SetDataPathFn>;
+        type: PropType< SetDataPathFn>;
         default: undefined;
     };
     treeLazyLoad: {
@@ -1069,11 +1096,11 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     hasTreeChildren: {
-        type: PropType<import('../../core/types/treeTable').HasTreeChildrenFn>;
+        type: PropType< HasTreeChildrenFn>;
         default: undefined;
     };
     loadTreeChildren: {
-        type: PropType<import('../../core/types/treeTable').LoadTreeChildrenFn>;
+        type: PropType< LoadTreeChildrenFn>;
         default: undefined;
     };
     cellCommentsDataSource: {
@@ -1096,15 +1123,11 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         type: NumberConstructor;
         default: undefined;
     };
-    /** Phase 24 · 单元格框选；默认 true（含 enableColumnSelection），handle 默认 off（无 Fill/Range 手柄） */
+    /** Phase 24 · 单元格框选；默认 true（含 enableColumnSelection），handleMode 默认 off（无 Fill/Range 手柄） */
     cellSelection: {
         type: PropType<boolean | CellSelectionOptions>;
         default: boolean;
     };
-    enableCellClipboard: {
-        type: BooleanConstructor;
-        default: undefined;
-    };
     enableCellCopy: {
         type: BooleanConstructor;
         default: undefined;
@@ -1122,15 +1145,15 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: boolean;
     };
     processCellForClipboard: {
-        type: PropType<import('../../core/types/cellClipboard').ProcessCellForClipboardFn>;
+        type: PropType< ProcessCellForClipboardFn>;
         default: undefined;
     };
     processCellFromClipboard: {
-        type: PropType<import('../../core/types/cellClipboard').ProcessCellFromClipboardFn>;
+        type: PropType< ProcessCellFromClipboardFn>;
         default: undefined;
     };
     processDataFromClipboard: {
-        type: PropType<import('../../core/types/cellClipboard').ProcessDataFromClipboardFn>;
+        type: PropType< ProcessDataFromClipboardFn>;
         default: undefined;
     };
     enableTooltips: {
@@ -1138,7 +1161,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     tooltipShowMode: {
-        type: PropType<import('../../core/types/overflowTooltip').TooltipShowMode>;
+        type: PropType< TooltipShowMode>;
         default: undefined;
     };
     tooltipShowDelay: {
@@ -1162,7 +1185,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     tooltipComponent: {
-        type: PropType<import('../../core/types/overflowTooltip').TooltipComponentType>;
+        type: PropType< TooltipComponentType>;
         default: undefined;
     };
     tooltipComponentParams: {
@@ -1174,7 +1197,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     suppressOverlays: {
-        type: PropType<import('../../core/types/emptyState').OverlayType[]>;
+        type: PropType< OverlayType[]>;
         default: undefined;
     };
     suppressLoadingOverlay: {
@@ -1206,7 +1229,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     loadingOverlayComponent: {
-        type: PropType<import('../../core/types/emptyState').OverlayComponentType>;
+        type: PropType< OverlayComponentType>;
         default: undefined;
     };
     loadingOverlayComponentParams: {
@@ -1214,7 +1237,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     noRowsOverlayComponent: {
-        type: PropType<import('../../core/types/emptyState').OverlayComponentType>;
+        type: PropType< OverlayComponentType>;
         default: undefined;
     };
     noRowsOverlayComponentParams: {
@@ -1222,7 +1245,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     noMatchingRowsOverlayComponent: {
-        type: PropType<import('../../core/types/emptyState').OverlayComponentType>;
+        type: PropType< OverlayComponentType>;
         default: undefined;
     };
     noMatchingRowsOverlayComponentParams: {
@@ -1230,7 +1253,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
         default: undefined;
     };
     overlayComponent: {
-        type: PropType<import('../../core/types/emptyState').OverlayComponentType>;
+        type: PropType< OverlayComponentType>;
         default: undefined;
     };
     overlayComponentParams: {
@@ -1284,80 +1307,79 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     "onCell-selection-changed"?: ((event: CellSelectionChangedEvent) => any) | undefined;
     "onCell-selection-delete-start"?: ((event: CellSelectionDeleteStartEvent) => any) | undefined;
     "onCell-selection-delete-end"?: ((event: CellSelectionDeleteEndEvent) => any) | undefined;
-    "onOverlay-shown"?: ((event: import('../../core/types').OverlayShownEvent) => any) | undefined;
-    "onOverlay-hidden"?: ((event: import('../../core/types').OverlayHiddenEvent) => any) | undefined;
+    "onOverlay-shown"?: ((event: OverlayShownEvent) => any) | undefined;
+    "onOverlay-hidden"?: ((event: OverlayHiddenEvent) => any) | undefined;
 }>, {
     rounded: number | boolean;
     tree: boolean;
     rowHeight: number;
-    showSummary: boolean;
-    summaryScope: import('../../core/types').SummaryScope;
-    summaryRowHeight: number;
-    summaryMethod: import('../../core/types').SummaryMethod;
     width: string | number;
     sortable: boolean;
     filterable: boolean;
     resizable: boolean;
-    editType: CellEditType;
-    headerAlign: import('../../core/types').MagicGridHorizontalAlign;
-    headerValign: import('../../core/types').MagicGridVerticalAlign;
-    align: import('../../core/types').MagicGridHorizontalAlign;
-    valign: import('../../core/types').MagicGridVerticalAlign;
-    footerAlign: import('../../core/types').MagicGridHorizontalAlign;
-    footerValign: import('../../core/types').MagicGridVerticalAlign;
     groupFooterLabel: string;
+    editType: CellEditType;
+    headerAlign: GridHorizontalAlign;
+    headerValign: GridVerticalAlign;
+    align: GridHorizontalAlign;
+    valign: GridVerticalAlign;
+    footerAlign: GridHorizontalAlign;
+    footerValign: GridVerticalAlign;
     suppressCellComments: boolean;
-    tooltipComponent: import('../../core/types/overflowTooltip').TooltipComponentFactory;
+    tooltipComponent: TooltipComponentFactory;
     tooltipComponentParams: Record<string, unknown>;
+    showSummary: boolean;
+    summaryScope: SummaryScope;
+    summaryRowHeight: number;
+    summaryMethod: SummaryMethod;
     cellSelection: boolean | CellSelectionOptions;
-    enableCellClipboard: boolean;
     enableCellCopy: boolean;
     enableCellPaste: boolean;
     enableHeaderHighlight: boolean;
     enableIndexColumnHighlight: boolean;
     height: string | number;
     loading: boolean;
-    groupKeyCreator: import('../../core/types').GroupKeyCreatorFn;
-    groupComparator: import('../../core/types').GroupComparatorFn;
+    groupKeyCreator: GroupKeyCreatorFn;
+    groupComparator: GroupComparatorFn;
     quickFilterText: string;
     showGroupHeader: boolean;
     showGroupFooter: boolean;
-    treeValueGetter: import('../../core/types').TreeValueGetterFn;
-    getDataPath: import('../../core/types').GetDataPathFn;
+    treeValueGetter: TreeValueGetterFn;
+    getDataPath: GetDataPathFn;
     rowKey: string;
-    getRowHeight: import('../../core/types').GetRowHeightFn;
+    getRowHeight: GetRowHeightFn;
     colResizeDefault: "shift";
-    autoSizeStrategy: import('../../core/types/columnAutosize').AutoSizeStrategy;
-    suppressOverlays: import('../../core/types').OverlayType[];
+    autoSizeStrategy: AutoSizeStrategy;
+    suppressOverlays: OverlayType[];
     suppressLoadingOverlay: boolean;
     suppressNoRowsOverlay: boolean;
     suppressNoMatchingRowsOverlay: boolean;
     overlayLoadingTemplate: string;
     overlayNoRowsTemplate: string;
     overlayNoMatchingRowsTemplate: string;
-    loadingOverlayComponent: import('../../core/types/emptyState').OverlayComponentFactory;
+    loadingOverlayComponent: OverlayComponentFactory;
     loadingOverlayComponentParams: Record<string, unknown>;
-    noRowsOverlayComponent: import('../../core/types/emptyState').OverlayComponentFactory;
+    noRowsOverlayComponent: OverlayComponentFactory;
     noRowsOverlayComponentParams: Record<string, unknown>;
-    noMatchingRowsOverlayComponent: import('../../core/types/emptyState').OverlayComponentFactory;
+    noMatchingRowsOverlayComponent: OverlayComponentFactory;
     noMatchingRowsOverlayComponentParams: Record<string, unknown>;
-    overlayComponent: import('../../core/types/emptyState').OverlayComponentFactory;
+    overlayComponent: OverlayComponentFactory;
     overlayComponentParams: Record<string, unknown>;
     overlayInteraction: boolean;
     isRowDisabled: boolean | IsRowDisabledFn;
-    border: MagicGridBorder;
+    border: GridBorder;
     headerHeight: number;
     rowBuffer: number;
-    editMode: EditMode;
+    editBehavior: CellEditBehavior;
     invalidEditValueMode: InvalidEditValueMode;
     rowValidator: RowValidator;
     asyncRowMutation: AsyncRowMutationHandlers;
-    selectable: import('../../core').SelectableFn;
+    selectable: SelectableFn;
     reserveSelection: boolean;
     floatingFilter: boolean;
     showIndexColumn: boolean;
-    indexColumn: import('../../core/types').IndexColumnOptions;
-    selectionColumn: import('../../core/types').SelectionColumnOptions;
+    indexColumn: IndexColumnOptions;
+    selectionColumn: SelectionColumnOptions;
     defaultSort: SortModelItem[];
     showUnsortedSortHintOnHover: boolean;
     columnMovable: boolean;
@@ -1369,51 +1391,51 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     filterSetValueMode: "reserve" | "current";
     filterSetDateLayoutMode: "tree" | "list";
     rowDragManaged: boolean;
-    rowDragCommitMode: import('../../core/types').RowDragCommitMode;
-    onRowDragCommit: import('../../core/types').RowDragCommitHandler;
+    rowDragCommitMode: RowDragCommitMode;
+    onRowDragCommit: RowDragCommitHandler;
     rowHeightMin: number;
     rowHeightMax: number;
     enableCellSpan: boolean;
     masterDetail: boolean;
-    isRowMaster: import('../../core/types').IsRowMasterFn;
+    isRowMaster: IsRowMasterFn;
     masterDefaultExpanded: number;
-    detailRowHeight: number | import('../../core/types').DetailRowHeightFn;
+    detailRowHeight: number | DetailRowHeightFn;
     detailRowAutoHeight: boolean;
     embedFullWidthRows: boolean;
     showExpandColumn: boolean;
-    getDetailRowData: import('../../core/types').GetDetailRowDataFn;
-    detailCellRenderer: import('../../core/types').DetailCellRendererFn;
+    getDetailRowData: GetDetailRowDataFn;
+    detailCellRenderer: DetailCellRendererFn;
     rowGrouping: boolean;
     groupDefaultExpanded: number;
-    groupDisplayType: import('../../core/types').GroupDisplayType;
+    groupDisplayType: GroupDisplayType;
     showGroupColumn: boolean;
-    autoGroupColumnDef: Partial<ColumnDef>;
-    groupCellRenderer: import('../../core/types').GroupCellRendererFn;
-    treeDragScope: import('../../core/types').TreeDragScope;
-    setDataPath: import('../../core/types').SetDataPathFn;
+    autoGroupColumnDef: Partial<ColumnDef<RowData>>;
+    groupCellRenderer: GroupCellRendererFn;
+    treeDragScope: TreeDragScope;
+    setDataPath: SetDataPathFn;
     showTreeColumn: boolean;
-    autoTreeColumnDef: Partial<ColumnDef>;
+    autoTreeColumnDef: Partial<ColumnDef<RowData>>;
     treeDisplayType: "singleColumn";
     treeLazyLoad: boolean;
-    hasTreeChildren: import('../../core/types').HasTreeChildrenFn;
-    loadTreeChildren: import('../../core/types').LoadTreeChildrenFn;
+    hasTreeChildren: HasTreeChildrenFn;
+    loadTreeChildren: LoadTreeChildrenFn;
     cellCommentsDataSource: CellCommentsDataSource<RowData, unknown>;
     cellCommentTrigger: CellCommentTrigger;
     cellCommentShowDelay: number;
     cellCommentHideDelay: number;
     rowStyle: RowStyle;
-    processCellForClipboard: import('../../core/types/cellClipboard').ProcessCellForClipboardFn;
-    processCellFromClipboard: import('../../core/types/cellClipboard').ProcessCellFromClipboardFn;
-    processDataFromClipboard: import('../../core/types/cellClipboard').ProcessDataFromClipboardFn;
+    processCellForClipboard: ProcessCellForClipboardFn;
+    processCellFromClipboard: ProcessCellFromClipboardFn;
+    processDataFromClipboard: ProcessDataFromClipboardFn;
     enableTooltips: boolean;
-    tooltipShowMode: import('../../core/types').TooltipShowMode;
+    tooltipShowMode: TooltipShowMode;
     tooltipShowDelay: number;
     tooltipSwitchShowDelay: number;
     tooltipHideDelay: number;
     tooltipInteraction: boolean;
     tooltipMouseTrack: boolean;
-    size: MagicGridSize;
-    theme: MagicGridTheme;
+    size: GridSize;
+    theme: GridTheme;
     stripe: boolean;
     rowSelection: RowSelectionInput;
     cellEditorRegistry: Record<string, CellEditorFn>;
@@ -1421,9 +1443,11 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
     navigateFooter: boolean;
     showStatusBar: boolean;
     showDefaultStatusBarPanels: boolean;
+    statusBarHeight: StatusBarHeightInput;
     showStatusBarRangeAggregation: boolean;
-    statusBarRangeAggregationPrecision: import('../../types').StatusBarRangeAggregationPrecisionInput;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+    statusBarRangeAggregationPosition: StatusBarRangeAggregationPosition;
+    statusBarRangeAggregationPrecision: StatusBarRangeAggregationPrecisionInput;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;