@robot-admin/naive-ui-components 0.10.2 → 0.11.0

package/dist/{useModalEdit.d.ts → useTableQuery.d.cts}

@@ -1,9 +1,9 @@
-import { DataTableColumns, DataTableRowKey } from "naive-ui";
+import { i as ComponentLocale, r as ComponentFeedback } from "./config.cjs";
 import * as vue from "vue";
-import { ComputedRef, InjectionKey, MaybeRef, Ref, VNodeChild } from "vue";
-import * as naive_ui_es0 from "naive-ui/es";
-import { DataTableColumn, DataTableRowKey as DataTableRowKey$1 } from "naive-ui/es";
-import { FormItemRule } from "naive-ui/es/form";
+import { App, ComputedRef, InjectionKey, MaybeRef, MaybeRefOrGetter, Ref, VNodeChild } from "vue";
+import { DataTableColumn, DataTableColumns, DataTableRowKey, FormItemRule, PaginationProps } from "naive-ui";
+import * as _vue_shared0 from "@vue/shared";
+import { HLJSApi } from "highlight.js";
 
 //#region src/components/C_Table/composables/usePrintWatermark.d.ts
 interface WatermarkConfig {
@@ -138,8 +138,10 @@ declare const printPresets: {
 };
 //#endregion
 //#region src/components/C_Table/composables/useDynamicRow.d.ts
-interface DynamicRowsOptions<T extends DataRecord = DataRecord> {
-  rowKey?: string | ((row: T) => DataTableRowKey$1);
+interface DynamicRowsOptions<T extends object = DataRecord> {
+  /** 总开关；关闭时公开方法保持安全 no-op */
+  enabled?: boolean;
+  rowKey?: string | ((row: T) => DataTableRowKey);
   defaultRowData?: () => T;
   enableRadioSelection?: boolean;
   enableAdd?: boolean;
@@ -154,15 +156,17 @@ interface DynamicRowsOptions<T extends DataRecord = DataRecord> {
   printTargetSelector?: string;
   confirmDelete?: boolean;
   deleteConfirmText?: string;
+  feedback?: ComponentFeedback;
+  locale?: ComponentLocale;
   onRowChange?: (data: T[]) => void;
-  onSelectionChange?: (selectedKey: DataTableRowKey$1 | null, selectedRow: T | null) => void;
+  onSelectionChange?: (selectedKey: DataTableRowKey | null, selectedRow: T | null) => void;
   onRowAdd?: (newRow: T) => void;
   onRowDelete?: (deletedRow: T, index: number) => void;
   onRowCopy?: (originalRow: T, newRow: T) => void;
   onRowMove?: (row: T, fromIndex: number, toIndex: number) => void;
 }
-interface DynamicRowsReturn<T extends DataRecord = DataRecord> {
-  selectedRowKey: Ref<DataTableRowKey$1 | null>;
+interface DynamicRowsReturn<T extends object = DataRecord> {
+  selectedRowKey: Ref<DataTableRowKey | null>;
   selectedRowData: Ref<T | null>;
   selectedRowIndex: Ref<number>;
   canMoveUp: Ref<boolean>;
@@ -177,19 +181,19 @@ interface DynamicRowsReturn<T extends DataRecord = DataRecord> {
   copyRow: () => void;
   moveRowUp: () => void;
   moveRowDown: () => void;
-  selectRow: (key: DataTableRowKey$1) => void;
+  selectRow: (key: DataTableRowKey) => void;
   clearSelection: () => void;
   handlePrint: (elementRef: Ref<HTMLElement | undefined>) => Promise<void>;
   handleDownload: (elementRef: Ref<HTMLElement | undefined>, filename?: string) => Promise<void>;
   handleQuickPrint: (elementRef: Ref<HTMLElement | undefined>) => Promise<void>;
   enhanceColumns: (columns: TableColumn<T>[]) => TableColumn<T>[];
-  renderToolbar: () => VNodeChild;
+  renderToolbar: (target?: HTMLElement) => VNodeChild;
   renderConfirmModal: () => VNodeChild;
 }
 /**
  * 表格动态行操作功能组合
  */
-declare function useDynamicRows<T extends DataRecord = DataRecord>(data: Ref<T[]>, options?: DynamicRowsOptions<T>): DynamicRowsReturn<T>;
+declare function useDynamicRows<T extends object = DataRecord>(data: Readonly<Ref<T[]>>, options?: MaybeRefOrGetter<DynamicRowsOptions<T>>): DynamicRowsReturn<T>;
 //#endregion
 //#region src/components/C_Table/composables/useRowDrag.d.ts
 interface RowDragConfig {
@@ -203,13 +207,13 @@ interface RowDragConfig {
   /** 拖拽中样式类 */
   chosenClass?: string;
 }
-interface UseRowDragOptions<T extends DataRecord = DataRecord> {
+interface UseRowDragOptions<T extends object = DataRecord> {
   /** 数据源（只读即可） */
   data: Ref<T[]> | ComputedRef<T[]>;
   /** 获取行键 */
-  rowKey: (row: T) => DataTableRowKey$1;
+  rowKey: (row: T) => DataTableRowKey;
   /** 配置 */
-  config: RowDragConfig;
+  config: MaybeRefOrGetter<RowDragConfig | undefined>;
   /** 数据重排回调（由外部处理数据更新） */
   onReorder?: (newData: T[]) => void;
   /** 排序变更回调 */
@@ -224,7 +228,7 @@ interface UseRowDragReturn {
   isDragging: Ref<boolean>;
 }
 /** 行拖拽排序组合式函数 */
-declare function useRowDrag<T extends DataRecord = DataRecord>(options: UseRowDragOptions<T>): UseRowDragReturn;
+declare function useRowDrag<T extends object = DataRecord>(options: UseRowDragOptions<T>): UseRowDragReturn;
 //#endregion
 //#region src/components/C_Table/composables/useCrossPageSelection.d.ts
 interface CrossPageSelectionConfig {
@@ -232,34 +236,38 @@ interface CrossPageSelectionConfig {
   /** 最大选择数 */
   maxSelection?: number;
 }
-interface UseCrossPageSelectionOptions<T extends DataRecord = DataRecord> {
+interface UseCrossPageSelectionOptions<T extends object = DataRecord> {
   /** 全量数据（非分页后的） */
   allData: Ref<T[]> | ComputedRef<T[]>;
   /** 行键函数 */
-  rowKey: (row: T) => DataTableRowKey$1;
+  rowKey: (row: T) => DataTableRowKey;
   /** 配置 */
-  config: CrossPageSelectionConfig;
+  config: MaybeRefOrGetter<CrossPageSelectionConfig | undefined>;
 }
-interface UseCrossPageSelectionReturn<T extends DataRecord = DataRecord> {
+interface UseCrossPageSelectionReturn<T extends object = DataRecord> {
   /** 所有选中的 key（跨页） */
-  selectedKeys: Ref<Set<DataTableRowKey$1>>;
+  selectedKeys: Ref<Set<DataTableRowKey>>;
   /** 选中行数量 */
   selectedCount: ComputedRef<number>;
   /** 当前页数据的 checkedKeys（给 NDataTable 绑定） */
-  getPageCheckedKeys: (pageData: T[]) => DataTableRowKey$1[];
+  getPageCheckedKeys: (pageData: T[]) => DataTableRowKey[];
   /** NDataTable @update:checked-row-keys 处理器 */
-  handlePageSelectionChange: (keys: DataTableRowKey$1[], pageData: T[]) => void;
+  handlePageSelectionChange: (keys: DataTableRowKey[], pageData: T[]) => void;
   /** 全选所有页 */
   selectAll: () => void;
+  /** 选择指定 key */
+  select: (key: DataTableRowKey) => boolean;
+  /** 取消选择指定 key */
+  unselect: (key: DataTableRowKey) => void;
   /** 清除所有页选中 */
   clearAll: () => void;
   /** 获取所有选中行数据 */
   getSelectedRows: () => T[];
   /** 判断 key 是否选中 */
-  isSelected: (key: DataTableRowKey$1) => boolean;
+  isSelected: (key: DataTableRowKey) => boolean;
 }
 /** 跨页多选组合式函数 */
-declare function useCrossPageSelection<T extends DataRecord = DataRecord>(options: UseCrossPageSelectionOptions<T>): UseCrossPageSelectionReturn<T>;
+declare function useCrossPageSelection<T extends object = DataRecord>(options: UseCrossPageSelectionOptions<T>): UseCrossPageSelectionReturn<T>;
 //#endregion
 //#region src/components/C_Table/composables/useTableExport.d.ts
 interface ExportConfig {
@@ -273,8 +281,12 @@ interface ExportConfig {
   columnKeys?: string[];
   /** CSV 分隔符 */
   csvSeparator?: string;
+  /** 阻止表格软件把用户文本识别为公式，默认开启 */
+  preventFormulaInjection?: boolean;
   /** 全局格式化配置（用于 formatter） */
   formatterConfig?: FormatterConfig;
+  /** 请求格式不可用并自动降级时的通知。 */
+  onFallback?: (requested: 'xlsx', actual: 'csv', cause: unknown) => void;
 }
 /**
  * 导出表格数据
@@ -289,12 +301,12 @@ declare function exportTableData(data: DataRecord[], columns: TableColumn[], con
  * 此接口对 columns/actions 使用 any[] 避免 TableColumn<any> 结构展开异常，
  * 同时允许 useTableCrud<T>() 任意子类型直接传入而无需类型断言。
  */
-interface CrudBinding {
-  data: Ref<any[]>;
+interface CrudBinding<T extends object = DataRecord> {
+  data: Ref<T[]>;
   loading: Ref<boolean>;
-  columns: ComputedRef<any[]>;
-  actions?: ComputedRef<any>;
-  pagination?: ComputedRef<any>;
+  columns: ComputedRef<TableColumn<T>[]>;
+  actions?: ComputedRef<SimpleTableActions<T>>;
+  pagination?: ComputedRef<PaginationConfig | boolean | undefined>;
   tableRef?: Ref<any>;
   save?: (...args: any[]) => any;
   handleCancel?: () => void;
@@ -305,9 +317,15 @@ interface CrudBinding {
   };
 }
 /** C_Table :config prop 的类型 — 所有功能配置收拢在此 */
-interface TableConfig<T extends DataRecord = DataRecord> {
+interface TableConfig<T extends object = DataRecord> {
+  /** 组件级反馈适配器；未提供时尝试复用 Naive Provider，再安全降级 */
+  feedback?: ComponentFeedback;
+  /** 组件级文案与语言覆盖 */
+  locale?: ComponentLocale;
+  /** 校验缺失/重复行键；默认开启，超大或无状态表格可关闭。 */
+  validateRowKeys?: boolean;
   /** 编辑配置 */
-  edit?: EditConfig | boolean;
+  edit?: EditConfig<T> | boolean;
   /** 操作按钮 */
   actions?: SimpleTableActions<T>;
   /** 分页配置 */
@@ -343,25 +361,33 @@ interface TableConfig<T extends DataRecord = DataRecord> {
   /** 错误状态配置 */
   error?: ErrorConfig;
   /** 批量操作配置 */
-  batchActions?: BatchActionsConfig;
+  batchActions?: BatchActionsConfig<T>;
 }
-interface EditConfig {
+interface EditConfig<T extends object = DataRecord> {
   enabled?: boolean;
   mode?: 'row' | 'cell' | 'modal' | 'both' | 'none';
   showRowActions?: boolean;
   modalTitle?: string;
   modalWidth?: number;
+  /** 保存前回调；抛出异常会保留编辑态，便于修正或重试 */
+  onSave?: (rowData: T, rowIndex: number, columnKey?: string) => void | Promise<void>;
+  /** 取消编辑回调 */
+  onCancel?: (rowData: T, rowIndex: number) => void | Promise<void>;
+  /** 编辑或保存失败回调 */
+  onError?: (error: unknown) => void;
 }
-interface ExpandConfig$1<T extends DataRecord = DataRecord> {
+interface ExpandConfig$1<T extends object = DataRecord> {
   enabled?: boolean;
-  defaultExpandedKeys?: DataTableRowKey$1[];
+  defaultExpandedKeys?: DataTableRowKey[];
   onLoadData?: (row: T) => Promise<unknown[]> | unknown[];
+  /** 展开数据加载失败回调 */
+  onError?: (error: unknown, row: T) => void;
   renderContent?: (row: T, expandData: unknown[], loading: boolean, childSelection?: unknown) => VNodeChild;
   rowExpandable?: (row: T) => boolean;
 }
-interface SelectionConfig$1<T extends DataRecord = DataRecord> {
+interface SelectionConfig$1<T extends object = DataRecord> {
   enabled?: boolean;
-  defaultCheckedKeys?: naive_ui_es0.DataTableRowKey[];
+  defaultCheckedKeys?: DataTableRowKey[];
   rowCheckable?: (row: T) => boolean;
   maxSelection?: number;
   childSelection?: {
@@ -397,7 +423,7 @@ interface VirtualScrollConfig {
   maxHeight?: number;
 }
 /** 合计行配置 */
-interface SummaryConfig<T extends DataRecord = DataRecord> {
+interface SummaryConfig<T extends object = DataRecord> {
   /** 合计行位置 */
   position?: 'top' | 'bottom';
   /** 自定义合计函数，每列返回 { value, colSpan? } */
@@ -434,30 +460,40 @@ interface ErrorConfig {
   onRetry?: () => void | Promise<void>;
 }
 /** 批量操作配置 */
-interface BatchActionsConfig {
+interface BatchActionsConfig<T extends object = DataRecord> {
   enabled?: boolean;
+  /** 操作成功后清空选择，默认不清空 */
+  clearSelectionOnSuccess?: boolean;
+  /** 批量操作失败回调 */
+  onError?: (error: unknown, actionKey: string) => void;
   /** 自定义批量操作按钮 */
   actions?: Array<{
     key: string;
     label: string;
     icon?: string;
     type?: string;
-    onClick: (selectedKeys: DataTableRowKey$1[], selectedRows: DataRecord[]) => void | Promise<void>;
+    onClick: (selectedKeys: DataTableRowKey[], selectedRows: T[]) => void | Promise<void>;
   }>;
 }
 interface ResolvedConfig {
+  feedback: ComponentFeedback | undefined;
+  locale: ComponentLocale | undefined;
   editable: boolean;
   editMode: string;
   showRowActions: boolean;
   modalTitle: string;
   modalWidth: number;
+  onEditSave: EditConfig['onSave'] | undefined;
+  onEditCancel: EditConfig['onCancel'] | undefined;
+  onEditError: EditConfig['onError'] | undefined;
   expandable: boolean;
-  defaultExpandedKeys: DataTableRowKey$1[] | undefined;
+  defaultExpandedKeys: DataTableRowKey[] | undefined;
   onLoadExpandData: ((row: DataRecord) => Promise<unknown[]> | unknown[]) | undefined;
+  onExpandError: ((error: unknown, row: DataRecord) => void) | undefined;
   renderExpandContent: ((row: DataRecord, expandData: unknown[], loading: boolean, childSelection?: unknown) => VNodeChild) | undefined;
   rowExpandable: ((row: DataRecord) => boolean) | undefined;
   enableSelection: boolean;
-  defaultCheckedKeys: DataTableRowKey$1[] | undefined;
+  defaultCheckedKeys: DataTableRowKey[] | undefined;
   rowCheckable: ((row: DataRecord) => boolean) | undefined;
   maxSelection: number | undefined;
   enableChildSelection: boolean;
@@ -487,7 +523,7 @@ interface ResolvedConfig {
   }>) | undefined;
   /** 列拖拽 */
   enableColumnDrag: boolean;
-  columnDragHandleClass: string;
+  columnDragHandleClass: string | undefined;
   columnDragAnimationDuration: number;
   /** 树形表格 */
   treeEnabled: boolean;
@@ -557,6 +593,8 @@ interface ColumnFormatter {
   config?: Record<string, unknown>;
 }
 interface TableGlobalConfig {
+  /** 任意 C_Table 配置的应用级默认值。 */
+  defaults?: TableConfig;
   /** 表格显示默认值 */
   display?: DisplayConfig;
   /** 默认分页条数 */
@@ -584,6 +622,15 @@ type RefLike<T> = {
 } | T;
 type MaybeRefLike<T> = RefLike<T> | MaybeRef<T>;
 type DataRecord = Record<string, unknown>;
+type TableRowKey<T extends object = DataRecord> = Extract<keyof T, string> | ((row: T) => DataTableRowKey);
+interface TableRowKeyIssue<T extends object = DataRecord> {
+  type: 'missing' | 'duplicate' | 'error';
+  row: T;
+  index: number;
+  key?: DataTableRowKey;
+  firstIndex?: number;
+  cause?: unknown;
+}
 type EditMode = 'row' | 'cell' | 'both' | 'modal' | 'none';
 type EditType = 'input' | 'textarea' | 'select' | 'date' | 'number' | 'switch' | 'email' | 'mobile';
 type ButtonType = 'default' | 'primary' | 'info' | 'success' | 'warning' | 'error';
@@ -601,11 +648,11 @@ interface PaginationConfig {
   remote?: boolean;
 }
 /** API 函数类型 */
-type ApiFunction<T extends DataRecord = DataRecord> = (row: T, index: number) => Promise<any> | any;
+type ApiFunction<T extends object = DataRecord> = (row: T, index: number) => unknown | Promise<unknown>;
 /** 渲染函数类型 */
-type RenderFunction<T extends DataRecord = DataRecord> = (row: T, index: number) => VNodeChild;
+type RenderFunction<T extends object = DataRecord> = (row: T, index: number) => VNodeChild;
 /** 自定义操作按钮配置 */
-interface CustomAction<T extends DataRecord = DataRecord> {
+interface CustomAction<T extends object = DataRecord> {
   /** 按钮唯一键 */
   key: string;
   /** 按钮显示文本 */
@@ -624,7 +671,7 @@ interface CustomAction<T extends DataRecord = DataRecord> {
   tooltip?: string;
 }
 /** 简化的操作配置 - 二元法则 */
-interface SimpleTableActions<T extends DataRecord = DataRecord> {
+interface SimpleTableActions<T extends object = DataRecord> {
   /** 编辑操作 - 直接传入函数 */
   edit?: false | ApiFunction<T>;
   /** 删除操作 - 直接传入函数 */
@@ -636,23 +683,48 @@ interface SimpleTableActions<T extends DataRecord = DataRecord> {
   /** 完全自定义渲染 - 10%场景 */
   render?: RenderFunction<T>;
 }
+/** Minimal edit-state contract consumed by the action renderer. */
+interface TableActionsManager<T extends object = DataRecord> {
+  editStates: {
+    modalEdit: {
+      startEdit: (rowKey: DataTableRowKey, sourceData?: T) => boolean | void;
+    };
+    rowEdit: {
+      isEditingRow: (rowKey: DataTableRowKey) => boolean;
+      startEditRow: (rowKey: DataTableRowKey) => boolean | void;
+      cancelEditRow: () => void | Promise<void>;
+      saveEditRow: () => Promise<unknown>;
+    };
+  };
+}
 /** useTableActions Hook 选项类型 */
-interface UseTableActionsOptions<T extends DataRecord = DataRecord> {
+interface UseTableActionsOptions<T extends object = DataRecord> {
   /** 操作配置 */
   actions: Ref<SimpleTableActions<T>> | ComputedRef<SimpleTableActions<T>>;
   /** 表格配置 */
-  config: Ref<any> | ComputedRef<any>;
+  config: Ref<{
+    editable: boolean;
+    editMode: string;
+    feedback?: ComponentFeedback;
+    locale?: ComponentLocale;
+  }> | ComputedRef<{
+    editable: boolean;
+    editMode: string;
+    feedback?: ComponentFeedback;
+    locale?: ComponentLocale;
+  }>;
   /** 表格管理器 */
-  tableManager: any;
+  tableManager: TableActionsManager<T>;
   /** 行键获取函数 */
   rowKey: (row: T) => DataTableRowKey;
   /** 事件发射器 */
-  emit: any;
+  /** Deletion action completion notification; kept separate from CRUD data mutation. */
+  onRowDeleted?: (row: T, index: number) => void;
   /** 查看详情回调 */
   onViewDetail?: (data: T) => void;
 }
 /** useTableActions Hook 返回类型 */
-interface UseTableActionsReturn<T extends DataRecord = DataRecord> {
+interface UseTableActionsReturn<T extends object = DataRecord> {
   /** 渲染操作列 */
   renderActions: (rowData: T, rowIndex: number) => VNodeChild;
   /** 检查操作是否启用 */
@@ -663,7 +735,7 @@ interface BaseOption {
   value: string | number;
   disabled?: boolean;
 }
-interface BaseConfig<T extends DataRecord = DataRecord> {
+interface BaseConfig<T extends object = DataRecord> {
   enabled?: boolean;
   rowCheckable?: (row: T) => boolean;
 }
@@ -692,15 +764,15 @@ interface EditProps {
  * - BuiltInTableColumn：内置列（selection/expand），不需要 key/title
  * - TableColumn：以上二者联合
  */
-interface BaseTableColumn<T extends DataRecord = DataRecord> extends Omit<DataTableColumns<T>[number], 'key' | 'title' | 'render' | 'type'> {
-  key?: any;
+interface BaseTableColumn<T extends object = DataRecord> extends Omit<DataTableColumns<T>[number], 'key' | 'title' | 'render' | 'type'> {
+  key?: DataTableRowKey;
   title?: string;
   visible?: boolean;
   editable?: boolean;
   required?: boolean;
   editType?: EditType;
   editProps?: EditProps;
-  editRender?: (value: any, rowData: T, rowIndex: number) => VNodeChild;
+  editRender?: (value: unknown, rowData: T, rowIndex: number) => VNodeChild;
   render?: (rowData: T, rowIndex: number) => VNodeChild;
   /** 声明式格式化器（优先级低于 render） */
   formatter?: ColumnFormatter;
@@ -709,55 +781,153 @@ interface BaseTableColumn<T extends DataRecord = DataRecord> extends Omit<DataTa
   minWidth?: number;
   maxWidth?: number;
 }
-interface NormalTableColumn<T extends DataRecord = DataRecord> extends BaseTableColumn<T> {
-  key: keyof T | string;
+interface NormalTableColumn<T extends object = DataRecord> extends BaseTableColumn<T> {
+  key: Extract<keyof T, DataTableRowKey> | DataTableRowKey;
   title: string;
 }
-interface BuiltInTableColumn<T extends DataRecord = DataRecord> extends BaseTableColumn<T> {
+interface BuiltInTableColumn<T extends object = DataRecord> extends BaseTableColumn<T> {
   /** 内置列类型：无需 key / title */
   type: 'selection' | 'expand' | 'index';
   /** 展开行渲染函数（仅当 type = expand 时有效） */
   renderExpand?: (rowData: T, rowIndex: number) => VNodeChild;
 }
-type TableColumn<T extends DataRecord = DataRecord> = NormalTableColumn<T> | BuiltInTableColumn<T>;
+type TableColumn<T extends object = DataRecord> = NormalTableColumn<T> | BuiltInTableColumn<T>;
+type StrictTableColumn<T extends object> = (Omit<NormalTableColumn<T>, 'key'> & {
+  key: Extract<keyof T, string>;
+}) | BuiltInTableColumn<T>;
 interface ChildSelectionState {
   selectedKeys: DataTableRowKey[];
   isAllChecked: boolean;
   selectAll: () => void;
   clearAll: () => void;
 }
-interface ExpandConfig<T extends DataRecord = DataRecord, C = any> {
+interface ExpandConfig<T extends object = DataRecord, C = DataRecord> {
   onLoadData?: (row: T) => Promise<C[]> | C[];
+  onError?: (error: unknown, row: T) => void;
   renderContent?: (row: T, expandData: C[], loading: boolean, childSelection?: ChildSelectionState) => VNodeChild;
   rowExpandable?: (row: T) => boolean;
 }
-interface SelectionConfig<T extends DataRecord = DataRecord> extends BaseConfig<T> {
+interface SelectionConfig<T extends object = DataRecord, C = DataRecord> extends BaseConfig<T> {
+  enableSelection?: boolean;
+  defaultCheckedKeys?: DataTableRowKey[];
+  maxSelection?: number;
+  enableChildSelection?: boolean;
+  childRowCheckable?: (childRow: C, parentRow: T) => boolean;
+  enableParentChildLink?: boolean;
+  parentChildLinkMode?: ParentChildLinkMode;
+}
+interface TableBaseProps<T extends object = DataRecord> {
+  columns: TableColumn<T>[];
+  data: MaybeRefLike<T[]>;
+  rowKey?: TableRowKey<T>;
+  loading?: MaybeRefLike<boolean>;
+}
+interface TableDisplayProps {
+  maxHeight?: number | string;
+  minHeight?: number | string;
+  scrollX?: number | string;
+  striped?: boolean;
+  bordered?: boolean;
+  singleLine?: boolean;
+  size?: 'small' | 'medium' | 'large';
+}
+interface TableEditProps<T extends object = DataRecord> {
+  editable?: boolean;
+  editMode?: EditMode;
+  onSave?: (rowData: T, rowIndex: number, columnKey?: string) => void | Promise<void>;
+  onCancel?: (rowData: T, rowIndex: number) => void;
+  showRowActions?: boolean;
+  modalTitle?: string;
+  modalWidth?: number;
+  columnWidth?: number;
+}
+interface TableExpandProps<T extends object = DataRecord, C = DataRecord> {
+  expandable?: boolean;
+  onLoadExpandData?: (row: T) => Promise<C[]> | C[];
+  renderExpandContent?: (row: T, expandData: C[], loading: boolean, childSelection?: ChildSelectionState) => VNodeChild;
+  rowExpandable?: (row: T) => boolean;
+  defaultExpandedKeys?: DataTableRowKey[];
+}
+interface TableSelectionProps<T extends object = DataRecord, C = DataRecord> extends BaseConfig<T> {
   enableSelection?: boolean;
   defaultCheckedKeys?: DataTableRowKey[];
   maxSelection?: number;
   enableChildSelection?: boolean;
-  childRowCheckable?: (childRow: any, parentRow: T) => boolean;
+  childRowCheckable?: (childRow: C, parentRow: T) => boolean;
   enableParentChildLink?: boolean;
   parentChildLinkMode?: ParentChildLinkMode;
 }
-interface TableExpandEvents<T extends DataRecord = DataRecord> {
+interface TableProps<T extends object = DataRecord, C = DataRecord> extends TableBaseProps<T>, TableDisplayProps, TableEditProps<T>, TableExpandProps<T, C>, TableSelectionProps<T, C> {
+  pagination?: PaginationConfig | boolean;
+  actions?: SimpleTableActions<T>;
+}
+interface TableExpandEvents<T extends object = DataRecord> {
   'expand-change': [expandedKeys: DataTableRowKey[], row?: T, expanded?: boolean];
 }
-interface TableSelectionEvents<T extends DataRecord = DataRecord> {
+interface TableSelectionEvents<T extends object = DataRecord, C = DataRecord> {
   'selection-change': [checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]>];
-  'child-selection-change': [parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: any[]];
+  'child-selection-change': [parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: C[]];
   'parent-child-link-change': [parentKey: DataTableRowKey, shouldSelect: boolean];
 }
-interface TableEditEvents<T extends DataRecord = DataRecord> {
+interface TableEditEvents<T extends object = DataRecord> {
   'update:data': [data: T[]];
   save: [rowData: T, rowIndex: number, columnKey?: string];
   cancel: [rowData: T, rowIndex: number];
+  'edit-error': [error: unknown];
 }
-interface TableEmits<T extends DataRecord = DataRecord> extends TableExpandEvents<T>, TableSelectionEvents<T>, TableEditEvents<T> {
+interface TableEmits<T extends object = DataRecord, C = DataRecord> extends TableExpandEvents<T>, TableSelectionEvents<T, C>, TableEditEvents<T> {
   'pagination-change': [page: number, pageSize: number];
   'row-delete': [deletedRow: T, index: number];
+  'batch-action-error': [error: unknown, actionKey: string];
+  'row-key-error': [issues: TableRowKeyIssue<T>[]];
+}
+interface TableEditMethods<T extends object = DataRecord> {
+  startEdit: (rowKey: DataTableRowKey, columnKey?: string) => void;
+  cancelEdit: () => void;
+  saveEdit: () => Promise<void>;
+  isEditing: (rowKey: DataTableRowKey, columnKey?: string) => boolean;
+  getEditingData: () => T | null;
+}
+interface TableExpandMethods {
+  expandRow: (rowKey: DataTableRowKey) => Promise<void>;
+  collapseRow: (rowKey: DataTableRowKey) => void;
+  toggleExpand: (rowKey: DataTableRowKey) => Promise<void>;
+  expandAll: () => Promise<void>;
+  collapseAll: () => void;
+  isExpanded: (rowKey: DataTableRowKey) => boolean;
+}
+interface TableSelectionMethods<T extends object = DataRecord, C = DataRecord> {
+  selectRow: (rowKey: DataTableRowKey) => boolean | void;
+  unselectRow: (rowKey: DataTableRowKey) => void;
+  selectAll: () => void;
+  clearSelection: () => void;
+  isRowSelected: (rowKey: DataTableRowKey) => boolean;
+  getSelectedRows: () => T[];
+  selectChildRow: (parentKey: DataTableRowKey, childKey: DataTableRowKey) => void;
+  unselectChildRow: (parentKey: DataTableRowKey, childKey: DataTableRowKey) => void;
+  selectAllChildren: (parentKey: DataTableRowKey) => void;
+  clearChildrenSelection: (parentKey: DataTableRowKey) => void;
+  getChildSelectedRows: (parentKey: DataTableRowKey) => C[];
+  clearAllSelections: () => void;
+}
+interface TableDynamicRowsMethods<T extends object = DataRecord> {
+  addRow: () => void;
+  insertRow: () => void;
+  deleteRow: () => void;
+  copyRow: () => void;
+  moveRowUp: () => void;
+  moveRowDown: () => void;
+  clearRowSelection: () => void;
+  getSelectedRowData: () => T | null;
+  printTable: (elementRef?: HTMLElement) => Promise<void>;
+  downloadTableScreenshot: (elementRef?: HTMLElement, filename?: string) => Promise<void>;
+}
+interface TablePaginationMethods {
+  resetToFirstPage: () => void;
+  getTotalPages: () => number;
 }
-interface UseTableExpandOptions<T extends DataRecord = DataRecord, C = any> extends ExpandConfig<T, C>, SelectionConfig<T> {
+interface TableInstance<T extends object = DataRecord, C = DataRecord> extends TableEditMethods<T>, TableExpandMethods, TableSelectionMethods<T, C>, TableDynamicRowsMethods<T>, TablePaginationMethods {}
+interface UseTableExpandOptions<T extends object = DataRecord, C = DataRecord> extends ExpandConfig<T, C>, SelectionConfig<T, C> {
   data: Ref<T[]> | ComputedRef<T[]>;
   rowKey: (row: T) => DataTableRowKey;
   childRowKey?: (child: C) => DataTableRowKey;
@@ -766,7 +936,7 @@ interface UseTableExpandOptions<T extends DataRecord = DataRecord, C = any> exte
   onSelectionChange?: (checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]>) => void;
   onChildSelectionChange?: (parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: C[]) => void;
 }
-interface UseTableExpandReturn<T extends DataRecord = DataRecord, C = any> {
+interface UseTableExpandReturn<T extends object = DataRecord, C = DataRecord> {
   expandedKeys: Ref<DataTableRowKey[]>;
   checkedKeys: Ref<DataTableRowKey[]>;
   childSelections: Ref<Map<DataTableRowKey, DataTableRowKey[]>>;
@@ -782,7 +952,17 @@ interface UseTableExpandReturn<T extends DataRecord = DataRecord, C = any> {
   clearSelection: () => void;
   clearAllSelections: () => void;
   handleSelectionChange: (keys: DataTableRowKey[]) => void;
-  getTableColumns: (originalColumns: TableColumn<T>[]) => any[];
+  getTableColumns: (originalColumns: TableColumn<T>[]) => unknown[];
+}
+/** 行操作按钮配置 */
+interface RowAction<T extends object = DataRecord> {
+  label: string;
+  icon?: string;
+  type?: ButtonType;
+  disabled?: boolean | ((row: T, index: number) => boolean);
+  show?: boolean | ((row: T, index: number) => boolean);
+  onClick?: (row: T, index: number) => void | Promise<void>;
+  tooltip?: string;
 }
 /**
  * 展平 TableColumn 联合类型以便直接访问 key/title/visible 等属性。
@@ -803,7 +983,7 @@ type __VLS_Props = {
   /** 列配置（crud 模式下可省略） */columns?: TableColumn[]; /** 数据源（crud 模式下可省略） */
   data?: MaybeRefLike<DataRecord[]>; /** 加载状态 */
   loading?: MaybeRefLike<boolean>; /** 行唯一键 */
-  rowKey?: (row: DataRecord) => DataTableRowKey$1; /** 统一功能配置（edit / selection / expand / pagination / dynamicRows / toolbar / display） */
+  rowKey?: string | ((row: DataRecord) => DataTableRowKey); /** 统一功能配置（edit / selection / expand / pagination / dynamicRows / toolbar / display） */
   config?: TableConfig; /** CRUD 绑定 — 传入 useTableCrud() 的返回值，自动接管 data/columns/loading/actions/pagination/events */
   crud?: CrudBinding;
 };
@@ -818,48 +998,71 @@ type __VLS_Slots = {} & {
   error?: (props: typeof __VLS_52) => any;
 };
 declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
-  startEdit: (rowKey: DataTableRowKey$1, columnKey?: string) => void;
+  startEdit: (rowKey: DataTableRowKey, columnKey?: string) => void;
+  cancelEdit: () => void;
+  saveEdit: () => Promise<void>;
+  expandRow: (rowKey: DataTableRowKey) => Promise<void>;
+  collapseRow: (rowKey: DataTableRowKey) => void;
+  toggleExpand: (rowKey: DataTableRowKey) => Promise<void>;
   expandAll: () => Promise<void>;
   collapseAll: () => void;
+  selectRow: (rowKey: DataTableRowKey) => boolean;
+  unselectRow: (rowKey: DataTableRowKey) => void;
   selectAll: () => void;
   clearSelection: () => void;
+  isRowSelected: (rowKey: DataTableRowKey) => boolean;
   clearAllSelections: () => void;
+  selectChildRow: (parentKey: DataTableRowKey, childKey: DataTableRowKey) => void;
+  unselectChildRow: (parentKey: DataTableRowKey, childKey: DataTableRowKey) => void;
+  selectAllChildren: (parentKey: DataTableRowKey) => void;
+  clearChildrenSelection: (parentKey: DataTableRowKey) => void;
+  getChildSelectedRows: (parentKey: DataTableRowKey) => DataRecord[];
+  addRow: () => void;
+  insertRow: () => void;
+  deleteRow: () => void;
+  copyRow: () => void;
+  moveRowUp: () => void;
+  moveRowDown: () => void;
   clearRowSelection: () => void;
+  getSelectedRowData: () => DataRecord | null;
+  printTable: (elementRef?: HTMLElement) => Promise<void>;
+  downloadTableScreenshot: (elementRef?: HTMLElement, filename?: string) => Promise<void>;
   resetToFirstPage: () => void;
+  getTotalPages: () => number;
   getSelectedRows: () => DataRecord[];
-  getEditingData: () => DataRecord | vue.Ref<Record<string, any>, Record<string, any>> | null;
-  isEditing: (rowKey: DataTableRowKey$1, columnKey?: string) => boolean;
-  isExpanded: (rowKey: DataTableRowKey$1) => boolean;
+  getEditingData: () => DataRecord | null | undefined;
+  isEditing: (rowKey: DataTableRowKey, columnKey?: string) => boolean;
+  isExpanded: (rowKey: DataTableRowKey) => boolean;
   getManager: () => {
     edit: {
-      start(rowKey: DataTableRowKey$1, columnKey?: string): void;
+      start(rowKey: DataTableRowKey, columnKey?: string): void;
       cancel(): void;
       save(): Promise<void>;
-      isEditing(rowKey: DataTableRowKey$1, columnKey?: string): boolean;
-      getEditingData(): DataRecord | vue.Ref<Record<string, any>, Record<string, any>> | null;
+      isEditing(rowKey: DataTableRowKey, columnKey?: string): boolean;
+      getEditingData(): DataRecord | null | undefined;
     };
     expand: {
-      row(rowKey: DataTableRowKey$1): Promise<void>;
-      collapse(rowKey: DataTableRowKey$1): void;
-      toggle(rowKey: DataTableRowKey$1): Promise<void>;
+      row(rowKey: DataTableRowKey): Promise<void>;
+      collapse(rowKey: DataTableRowKey): void;
+      toggle(rowKey: DataTableRowKey): Promise<void>;
       all(): Promise<void>;
       collapseAll(): void;
-      isExpanded(rowKey: DataTableRowKey$1): boolean;
+      isExpanded(rowKey: DataTableRowKey): boolean;
     };
     selection: {
-      select(rowKey: DataTableRowKey$1): void;
-      unselect(rowKey: DataTableRowKey$1): void;
+      select(rowKey: DataTableRowKey): void;
+      unselect(rowKey: DataTableRowKey): void;
       all(): void;
       clear(): void;
-      isSelected(rowKey: DataTableRowKey$1): boolean;
+      isSelected(rowKey: DataTableRowKey): boolean;
       getSelected(): DataRecord[];
     };
     childSelection: {
-      select(parentKey: DataTableRowKey$1, childKey: DataTableRowKey$1): void;
-      unselect(parentKey: DataTableRowKey$1, childKey: DataTableRowKey$1): void;
-      selectAll(parentKey: DataTableRowKey$1): void;
-      clear(parentKey: DataTableRowKey$1): void;
-      getSelected(parentKey: DataTableRowKey$1): DataRecord[];
+      select(parentKey: DataTableRowKey, childKey: DataTableRowKey): void;
+      unselect(parentKey: DataTableRowKey, childKey: DataTableRowKey): void;
+      selectAll(parentKey: DataTableRowKey): void;
+      clear(parentKey: DataTableRowKey): void;
+      getSelected(parentKey: DataTableRowKey): DataRecord[];
     };
     dynamicRows: {
       add(): void;
@@ -877,26 +1080,32 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
   }; /** 导出数据 */
   exportData: () => Promise<void>; /** 跨页选择 */
   crossPageSelection: {
-    selectedKeys: vue.Ref<Set<DataTableRowKey$1>, Set<DataTableRowKey$1>>;
+    enabled: vue.ComputedRef<boolean>;
+    selectedKeys: vue.Ref<Set<DataTableRowKey>, Set<DataTableRowKey>>;
     selectedCount: vue.ComputedRef<number>;
+    select: (key: DataTableRowKey) => boolean;
+    unselect: (key: DataTableRowKey) => void;
     selectAll: () => void;
     clearAll: () => void;
     getSelectedRows: () => DataRecord[];
-  } | undefined;
+  };
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   save: (rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => any;
   cancel: (rowData: DataRecord, rowIndex: number) => any;
   "pagination-change": (...args: unknown[]) => any;
   "row-delete": (...args: unknown[]) => any;
-  "expand-change": (expandedKeys: DataTableRowKey$1[], row?: DataRecord | undefined, expanded?: boolean | undefined) => any;
-  "selection-change": (checkedKeys: DataTableRowKey$1[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey$1, DataTableRowKey$1[]> | undefined) => any;
-  "child-selection-change": (parentKey: DataTableRowKey$1, childKeys: DataTableRowKey$1[], childRows: any[]) => any;
-  "parent-child-link-change": (parentKey: DataTableRowKey$1, shouldSelect: boolean) => any;
+  "batch-action-error": (error: unknown, actionKey: string) => any;
+  "row-key-error": (issues: TableRowKeyIssue<DataRecord>[]) => any;
+  "expand-change": (expandedKeys: DataTableRowKey[], row?: DataRecord | undefined, expanded?: boolean | undefined) => any;
+  "selection-change": (checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => any;
+  "child-selection-change": (parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => any;
+  "parent-child-link-change": (parentKey: DataTableRowKey, shouldSelect: boolean) => any;
   "update:data": (data: DataRecord[]) => any;
+  "edit-error": (error: unknown) => any;
   "row-add": (newRow: DataRecord) => any;
   "row-copy": (originalRow: DataRecord, newRow: DataRecord) => any;
   "row-move": (row: DataRecord, fromIndex: number, toIndex: number) => any;
-  "row-selection-change": (selectedKey: DataTableRowKey$1 | null, selectedRow: DataRecord | null) => any;
+  "row-selection-change": (selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => any;
   "view-detail": (data: DataRecord) => any;
   "column-change": (columns: TableColumn[]) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
@@ -904,20 +1113,23 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
   onCancel?: ((rowData: DataRecord, rowIndex: number) => any) | undefined;
   "onPagination-change"?: ((...args: unknown[]) => any) | undefined;
   "onRow-delete"?: ((...args: unknown[]) => any) | undefined;
-  "onExpand-change"?: ((expandedKeys: DataTableRowKey$1[], row?: DataRecord | undefined, expanded?: boolean | undefined) => any) | undefined;
-  "onSelection-change"?: ((checkedKeys: DataTableRowKey$1[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey$1, DataTableRowKey$1[]> | undefined) => any) | undefined;
-  "onChild-selection-change"?: ((parentKey: DataTableRowKey$1, childKeys: DataTableRowKey$1[], childRows: any[]) => any) | undefined;
-  "onParent-child-link-change"?: ((parentKey: DataTableRowKey$1, shouldSelect: boolean) => any) | undefined;
+  "onBatch-action-error"?: ((error: unknown, actionKey: string) => any) | undefined;
+  "onRow-key-error"?: ((issues: TableRowKeyIssue<DataRecord>[]) => any) | undefined;
+  "onExpand-change"?: ((expandedKeys: DataTableRowKey[], row?: DataRecord | undefined, expanded?: boolean | undefined) => any) | undefined;
+  "onSelection-change"?: ((checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => any) | undefined;
+  "onChild-selection-change"?: ((parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => any) | undefined;
+  "onParent-child-link-change"?: ((parentKey: DataTableRowKey, shouldSelect: boolean) => any) | undefined;
   "onUpdate:data"?: ((data: DataRecord[]) => any) | undefined;
+  "onEdit-error"?: ((error: unknown) => any) | undefined;
   "onRow-add"?: ((newRow: DataRecord) => any) | undefined;
   "onRow-copy"?: ((originalRow: DataRecord, newRow: DataRecord) => any) | undefined;
   "onRow-move"?: ((row: DataRecord, fromIndex: number, toIndex: number) => any) | undefined;
-  "onRow-selection-change"?: ((selectedKey: DataTableRowKey$1 | null, selectedRow: DataRecord | null) => any) | undefined;
+  "onRow-selection-change"?: ((selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => any) | undefined;
   "onView-detail"?: ((data: DataRecord) => any) | undefined;
   "onColumn-change"?: ((columns: TableColumn[]) => any) | undefined;
 }>, {
   config: TableConfig;
-  rowKey: (row: DataRecord) => DataTableRowKey$1;
+  rowKey: string | ((row: DataRecord) => DataTableRowKey);
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
@@ -927,22 +1139,30 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
+//#region src/components/C_Table/helpers.d.ts
+/** Type-safe identity helper that rejects misspelled business field keys. */
+declare function defineTableColumns<T extends object>(columns: StrictTableColumn<T>[]): StrictTableColumn<T>[];
+/** Preserve row types across edit, action, summary and batch callbacks. */
+declare function defineTableConfig<T extends object>(config: TableConfig<T>): TableConfig<T>;
+/** Find missing and duplicate row keys before stateful table features consume them. */
+declare function validateTableRowKeys<T extends object>(data: readonly T[], rowKey: (row: T) => DataTableRowKey | null | undefined): TableRowKeyIssue<T>[];
+//#endregion
 //#region src/components/C_Table/composables/useTableColumns.d.ts
 /** useTableColumns 中对 tableManager 的最小依赖接口 */
 interface TableManagerRef {
   editStates: {
     cellEdit: {
-      isEditingCell: (rowKey: DataTableRowKey$1, columnKey: string) => boolean;
-      getEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string) => unknown;
-      updateEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string, value: unknown) => void;
+      isEditingCell: (rowKey: DataTableRowKey, columnKey: string) => boolean;
+      getEditingCellValue: (rowKey: DataTableRowKey, columnKey: string) => unknown;
+      updateEditingCellValue: (rowKey: DataTableRowKey, columnKey: string, value: unknown) => void;
       saveEditCell: () => Promise<unknown>;
       cancelEditCell: () => void;
-      startEditCell: (rowKey: DataTableRowKey$1, columnKey: string) => void;
+      startEditCell: (rowKey: DataTableRowKey, columnKey: string) => void;
     };
     rowEdit: {
-      isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
-      getEditingRowData: (rowKey: DataTableRowKey$1) => DataRecord | undefined;
-      updateEditingRowData: (rowKey: DataTableRowKey$1, field: string, value: unknown) => void;
+      isEditingRow: (rowKey: DataTableRowKey) => boolean;
+      getEditingRowData: (rowKey: DataTableRowKey) => DataRecord | undefined;
+      updateEditingRowData: (rowKey: DataTableRowKey, field: string, value: unknown) => void;
     };
   };
   dynamicRowsState?: {
@@ -965,7 +1185,7 @@ interface UseTableColumnsOptions {
   /** 用户设定的 scrollX */
   scrollX?: number | string;
   /** 行键获取函数 */
-  rowKey: (row: DataRecord) => DataTableRowKey$1;
+  rowKey: (row: DataRecord) => DataTableRowKey;
   /** 表格管理器 */
   tableManager: TableManagerRef;
   /** 操作列渲染函数 */
@@ -976,6 +1196,8 @@ interface UseTableColumnsOptions {
     isRowEditMode: () => boolean;
     isCellEditMode: () => boolean;
   }>;
+  /** 是否渲染操作列 */
+  showActionsColumn: ComputedRef<boolean>;
 }
 interface UseTableColumnsReturn {
   reactiveColumns: Ref<TableColumn[]>;
@@ -1000,9 +1222,9 @@ interface RowValidationError {
  */
 interface RowEditOptions {
   data: () => DataRecord[];
-  rowKey: (row: DataRecord) => DataTableRowKey$1;
+  rowKey: (row: DataRecord) => DataTableRowKey;
   onSave?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
-  onCancel?: (rowData: DataRecord, rowIndex: number) => void;
+  onCancel?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
   /** 列配置（用于提取校验规则） */
   columns?: () => TableColumn[];
 }
@@ -1010,9 +1232,11 @@ interface RowEditOptions {
  * 可编辑行组合函数，提供表格整行的编辑功能
  */
 declare function useRowEdit(options: RowEditOptions): {
-  editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
-  isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
-  startEditRow: (rowKey: DataTableRowKey$1) => void;
+  editingRowKey: vue.Ref<DataTableRowKey | null, DataTableRowKey | null>;
+  editingData: vue.Ref<Record<string, DataRecord>, Record<string, DataRecord>>;
+  isSaving: vue.Ref<boolean, boolean>;
+  isEditingRow: (rowKey: DataTableRowKey) => boolean;
+  startEditRow: (rowKey: DataTableRowKey) => boolean;
   cancelEditRow: () => Promise<void>;
   saveEditRow: () => Promise<{
     updatedData: DataRecord;
@@ -1026,9 +1250,9 @@ declare function useRowEdit(options: RowEditOptions): {
     field: string;
     message: string;
   }[]>;
-  getEditingRowData: (rowKey: DataTableRowKey$1) => DataRecord;
-  updateEditingRowData: (rowKey: DataTableRowKey$1, field: string, value: unknown) => void;
-  findRowData: (rowKey: DataTableRowKey$1) => DataRecord | null | undefined;
+  getEditingRowData: (rowKey: DataTableRowKey) => DataRecord | undefined;
+  updateEditingRowData: (rowKey: DataTableRowKey, field: string, value: unknown) => void;
+  findRowData: (rowKey: DataTableRowKey) => DataRecord | null | undefined;
 };
 //#endregion
 //#region src/components/C_Table/composables/useTableManager.d.ts
@@ -1036,18 +1260,24 @@ declare function useRowEdit(options: RowEditOptions): {
  * 表格管理器配置接口
  */
 interface TableManagerConfig {
+  feedback?: ComponentFeedback;
+  locale?: ComponentLocale;
   editable: boolean;
   editMode: string;
   showRowActions: boolean;
   modalTitle: string;
   modalWidth: number;
+  onEditSave?: (rowData: DataRecord, rowIndex: number, columnKey?: string) => void | Promise<void>;
+  onEditCancel?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
+  onEditError?: (error: unknown) => void;
   expandable: boolean;
-  defaultExpandedKeys?: DataTableRowKey$1[];
+  defaultExpandedKeys?: DataTableRowKey[];
   onLoadExpandData?: (row: DataRecord) => Promise<any[]> | any[];
+  onExpandError?: (error: unknown, row: DataRecord) => void;
   renderExpandContent?: unknown;
   rowExpandable?: (row: DataRecord) => boolean;
   enableSelection: boolean;
-  defaultCheckedKeys?: DataTableRowKey$1[];
+  defaultCheckedKeys?: DataTableRowKey[];
   rowCheckable?: (row: DataRecord) => boolean;
   maxSelection?: number;
   enableChildSelection: boolean;
@@ -1060,10 +1290,10 @@ interface TableManagerConfig {
  * 表格管理器参数接口
  */
 interface TableManagerParams {
-  config: TableManagerConfig;
+  config: MaybeRefOrGetter<TableManagerConfig>;
   data: () => DataRecord[];
-  rowKey: (row: DataRecord) => DataTableRowKey$1;
-  emit: (...args: any[]) => void;
+  rowKey: (row: DataRecord) => DataTableRowKey;
+  emit: (...args: any[]) => unknown;
   /** 列配置（用于编辑校验） */
   columns?: () => TableColumn[];
 }
@@ -1072,12 +1302,12 @@ interface TableManagerParams {
  */
 interface EventHandlers {
   onSave: (rowData: DataRecord, rowIndex: number, columnKey?: string) => Promise<void>;
-  onCancel: (rowData: DataRecord, rowIndex: number) => void;
-  onExpandChange: (keys: DataTableRowKey$1[], row?: DataRecord, expanded?: boolean) => void;
-  onSelectionChange: (checkedKeys: DataTableRowKey$1[], checkedRows: DataRecord[], childSelections: Map<DataTableRowKey$1, DataTableRowKey$1[]>) => void;
-  onChildSelectionChange: (parentKey: DataTableRowKey$1, childKeys: DataTableRowKey$1[], childRows: DataRecord[]) => void;
+  onCancel: (rowData: DataRecord, rowIndex: number) => Promise<void>;
+  onExpandChange: (keys: DataTableRowKey[], row?: DataRecord, expanded?: boolean) => void;
+  onSelectionChange: (checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections: Map<DataTableRowKey, DataTableRowKey[]>) => void;
+  onChildSelectionChange: (parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => void;
   onRowChange: (data: DataRecord[]) => void;
-  onRowSelectionChange: (selectedKey: DataTableRowKey$1 | null, selectedRow: DataRecord | null) => void;
+  onRowSelectionChange: (selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => void;
   onRowAdd: (newRow: DataRecord) => void;
   onRowDelete: (deletedRow: DataRecord, index: number) => void;
   onRowCopy: (originalRow: DataRecord, newRow: DataRecord) => void;
@@ -1089,9 +1319,11 @@ interface EventHandlers {
 declare function useTableManager(params: TableManagerParams): {
   editStates: {
     rowEdit: {
-      editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
-      isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
-      startEditRow: (rowKey: DataTableRowKey$1) => void;
+      editingRowKey: vue.Ref<DataTableRowKey | null, DataTableRowKey | null>;
+      editingData: vue.Ref<Record<string, DataRecord>, Record<string, DataRecord>>;
+      isSaving: vue.Ref<boolean, boolean>;
+      isEditingRow: (rowKey: DataTableRowKey) => boolean;
+      startEditRow: (rowKey: DataTableRowKey) => boolean;
       cancelEditRow: () => Promise<void>;
       saveEditRow: () => Promise<{
         updatedData: DataRecord;
@@ -1105,23 +1337,25 @@ declare function useTableManager(params: TableManagerParams): {
         field: string;
         message: string;
       }[]>;
-      getEditingRowData: (rowKey: DataTableRowKey$1) => DataRecord;
-      updateEditingRowData: (rowKey: DataTableRowKey$1, field: string, value: unknown) => void;
-      findRowData: (rowKey: DataTableRowKey$1) => DataRecord | null | undefined;
+      getEditingRowData: (rowKey: DataTableRowKey) => DataRecord | undefined;
+      updateEditingRowData: (rowKey: DataTableRowKey, field: string, value: unknown) => void;
+      findRowData: (rowKey: DataTableRowKey) => DataRecord | null | undefined;
     };
     cellEdit: {
       editingCell: vue.Ref<{
-        rowKey: DataTableRowKey$1 | null;
+        rowKey: DataTableRowKey | null;
         columnKey: string | null;
       }, {
-        rowKey: DataTableRowKey$1 | null;
+        rowKey: DataTableRowKey | null;
         columnKey: string | null;
       } | {
-        rowKey: DataTableRowKey$1 | null;
+        rowKey: DataTableRowKey | null;
         columnKey: string | null;
       }>;
-      isEditingCell: (rowKey: DataTableRowKey$1, columnKey: string) => boolean;
-      startEditCell: (rowKey: DataTableRowKey$1, columnKey: string) => void;
+      editingData: vue.Ref<Record<string, unknown>, Record<string, unknown>>;
+      isSaving: vue.Ref<boolean, boolean>;
+      isEditingCell: (rowKey: DataTableRowKey, columnKey: string) => boolean;
+      startEditCell: (rowKey: DataTableRowKey, columnKey: string) => boolean;
       saveEditCell: () => Promise<{
         updatedData: {
           [x: string]: unknown;
@@ -1132,56 +1366,60 @@ declare function useTableManager(params: TableManagerParams): {
       cancelEditCell: () => void;
       validateCell: () => Promise<boolean>;
       cellValidationError: vue.Ref<string | null, string | null>;
-      getEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string) => unknown;
-      updateEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string, value: unknown) => void;
-      findRowData: (rowKey: DataTableRowKey$1) => DataRecord | null | undefined;
+      getEditingCellValue: (rowKey: DataTableRowKey, columnKey: string) => unknown;
+      updateEditingCellValue: (rowKey: DataTableRowKey, columnKey: string, value: unknown) => void;
+      findRowData: (rowKey: DataTableRowKey) => DataRecord | null | undefined;
     };
     modalEdit: {
       isModalVisible: vue.Ref<boolean, boolean>;
-      editingData: vue.Ref<Record<string, any>, Record<string, any>>;
-      editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
+      isSaving: vue.Ref<boolean, boolean>;
+      editingData: vue.Ref<DataRecord, DataRecord>;
+      editingRowKey: vue.Ref<DataTableRowKey | null, DataTableRowKey | null>;
       editingRowIndex: vue.ComputedRef<number>;
-      startEdit: (rowKey: DataTableRowKey$1) => void;
-      saveEdit: (formData?: Record<string, any>) => Promise<void>;
-      cancelEdit: () => Promise<void>;
-      updateEditingData: (data: Record<string, any>) => void;
-      resetEditingState: () => void;
-      isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
-      getEditingRowData: (rowKey: DataTableRowKey$1) => Record<string, any> | null;
+      startEdit: (rowKey: DataTableRowKey, sourceData?: DataRecord | undefined) => boolean;
+      saveEdit: (formData?: DataRecord | undefined) => Promise<{
+        updatedData: any;
+        rowIndex: number;
+      } | undefined>;
+      cancelEdit: () => Promise<boolean>;
+      updateEditingData: (data: DataRecord) => boolean;
+      resetEditingState: () => boolean;
+      isEditingRow: (rowKey: DataTableRowKey) => boolean;
+      getEditingRowData: (rowKey: DataTableRowKey) => any;
     };
   };
-  expandState: UseTableExpandReturn<DataRecord, DataRecord> | null;
-  dynamicRowsState: DynamicRowsReturn<DataRecord> | null;
+  expandState: UseTableExpandReturn<DataRecord, DataRecord>;
+  dynamicRowsState: DynamicRowsReturn<DataRecord>;
   stateManager: {
     edit: {
-      /** 开始编辑 */start(rowKey: DataTableRowKey$1, columnKey?: string): void; /** 取消编辑 */
+      /** 开始编辑 */start(rowKey: DataTableRowKey, columnKey?: string): void; /** 取消编辑 */
       cancel(): void; /** 保存编辑 */
       save(): Promise<void>; /** 是否正在编辑 */
-      isEditing(rowKey: DataTableRowKey$1, columnKey?: string): boolean; /** 获取当前编辑数据 */
-      getEditingData(): DataRecord | vue.Ref<Record<string, any>, Record<string, any>> | null;
+      isEditing(rowKey: DataTableRowKey, columnKey?: string): boolean; /** 获取当前编辑数据 */
+      getEditingData(): DataRecord | null | undefined;
     };
     expand: {
-      /** 展开行 */row(rowKey: DataTableRowKey$1): Promise<void>; /** 折叠行 */
-      collapse(rowKey: DataTableRowKey$1): void; /** 展开折叠切换 */
-      toggle(rowKey: DataTableRowKey$1): Promise<void>; /** 展开所有行 */
+      /** 展开行 */row(rowKey: DataTableRowKey): Promise<void>; /** 折叠行 */
+      collapse(rowKey: DataTableRowKey): void; /** 展开折叠切换 */
+      toggle(rowKey: DataTableRowKey): Promise<void>; /** 展开所有行 */
       all(): Promise<void>; /** 折叠所有行 */
       collapseAll(): void; /** 检查行是否已展开 */
-      isExpanded(rowKey: DataTableRowKey$1): boolean;
+      isExpanded(rowKey: DataTableRowKey): boolean;
     };
     selection: {
-      /** 选择指定行 */select(rowKey: DataTableRowKey$1): void; /** 取消选择指定行 */
-      unselect(rowKey: DataTableRowKey$1): void; /** 选择所有行 */
+      /** 选择指定行 */select(rowKey: DataTableRowKey): void; /** 取消选择指定行 */
+      unselect(rowKey: DataTableRowKey): void; /** 选择所有行 */
       all(): void; /** 清除所有行选择 */
       clear(): void; /** 检查行是否已选择 */
-      isSelected(rowKey: DataTableRowKey$1): boolean; /** 获取所有已选择的行数据 */
+      isSelected(rowKey: DataTableRowKey): boolean; /** 获取所有已选择的行数据 */
       getSelected(): DataRecord[];
     };
     childSelection: {
-      /** 选择指定父行下的子行 */select(parentKey: DataTableRowKey$1, childKey: DataTableRowKey$1): void; /** 取消选择指定父行下的子行 */
-      unselect(parentKey: DataTableRowKey$1, childKey: DataTableRowKey$1): void; /** 选择指定父行下的所有子行 */
-      selectAll(parentKey: DataTableRowKey$1): void; /** 清除指定父行下的所有子行选择 */
-      clear(parentKey: DataTableRowKey$1): void; /** 获取指定父行下所有已选择的子行数据 */
-      getSelected(parentKey: DataTableRowKey$1): DataRecord[];
+      /** 选择指定父行下的子行 */select(parentKey: DataTableRowKey, childKey: DataTableRowKey): void; /** 取消选择指定父行下的子行 */
+      unselect(parentKey: DataTableRowKey, childKey: DataTableRowKey): void; /** 选择指定父行下的所有子行 */
+      selectAll(parentKey: DataTableRowKey): void; /** 清除指定父行下的所有子行选择 */
+      clear(parentKey: DataTableRowKey): void; /** 获取指定父行下所有已选择的子行数据 */
+      getSelected(parentKey: DataTableRowKey): DataRecord[];
     };
     dynamicRows: {
       /** 添加行 */add(): void; /** 插入行 */
@@ -1197,8 +1435,8 @@ declare function useTableManager(params: TableManagerParams): {
     }; /** 清除所有选择 */
     clearAllSelections(): void;
   };
-  expandedKeys: vue.ComputedRef<DataTableRowKey$1[]>;
-  checkedKeys: vue.ComputedRef<DataTableRowKey$1[]>;
+  expandedKeys: vue.ComputedRef<DataTableRowKey[]>;
+  checkedKeys: vue.ComputedRef<DataTableRowKey[]>;
   eventHandlers: EventHandlers;
 };
 //#endregion
@@ -1206,34 +1444,35 @@ declare function useTableManager(params: TableManagerParams): {
 /**
  *
  */
-declare function useTableExpand<T extends DataRecord = Record<string, any>, C = any>(options: UseTableExpandOptions<T, C>): UseTableExpandReturn<T, C>;
+declare function useTableExpand<T extends object = DataRecord, C = DataRecord>(options: UseTableExpandOptions<T, C>): UseTableExpandReturn<T, C>;
 //#endregion
 //#region src/components/C_Table/composables/useTableActions.d.ts
 /**
  * 表格操作Hook
  */
-declare function useTableActions<T extends DataRecord = DataRecord>(options: UseTableActionsOptions<T>): UseTableActionsReturn<T>;
+declare function useTableActions<T extends object = DataRecord>(options: UseTableActionsOptions<T>): UseTableActionsReturn<T>;
 //#endregion
 //#region src/components/C_Table/composables/usePagination.d.ts
-interface UsePaginationOptions<T extends DataRecord = DataRecord> {
+interface UsePaginationOptions<T extends object = DataRecord> {
   /** 数据源 - 支持函数、Ref 或 ComputedRef */
   data: (() => T[]) | Ref<T[]> | ComputedRef<T[]>;
   /** 分页配置 */
   config: Ref<PaginationConfig | null> | ComputedRef<PaginationConfig | null>;
   /** 事件触发器 */
-  emit?: (event: "pagination-change", page: number, pageSize: number) => void;
+  emit?: (event: 'pagination-change', page: number, pageSize: number) => void;
 }
-interface UsePaginationReturn<T extends DataRecord = DataRecord> {
+interface UsePaginationReturn<T extends object = DataRecord> {
   currentPage: Ref<number>;
   currentPageSize: Ref<number>;
   paginatedData: ComputedRef<T[]>;
-  paginationConfig: ComputedRef<any>;
+  paginationConfig: ComputedRef<PaginationProps | null>;
   handlePageChange: (page: number) => void;
   handlePageSizeChange: (pageSize: number) => void;
   resetToFirstPage: () => void;
   getTotalPages: () => number;
 }
-declare function usePagination<T extends DataRecord = DataRecord>(options: UsePaginationOptions<T>): UsePaginationReturn<T>;
+/** Local and remote pagination with stable controlled-state synchronization. */
+declare function usePagination<T extends object = DataRecord>(options: UsePaginationOptions<T>): UsePaginationReturn<T>;
 //#endregion
 //#region src/components/C_Table/composables/useCellEdit.d.ts
 /**
@@ -1241,7 +1480,7 @@ declare function usePagination<T extends DataRecord = DataRecord>(options: UsePa
  */
 interface CellEditOptions {
   data: () => DataRecord[];
-  rowKey: (row: DataRecord) => DataTableRowKey$1;
+  rowKey: (row: DataRecord) => DataTableRowKey;
   onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string) => void | Promise<void>;
   /** 列配置（用于提取校验规则） */
   columns?: () => TableColumn[];
@@ -1251,17 +1490,19 @@ interface CellEditOptions {
  */
 declare function useCellEdit(options: CellEditOptions): {
   editingCell: vue.Ref<{
-    rowKey: DataTableRowKey$1 | null;
+    rowKey: DataTableRowKey | null;
     columnKey: string | null;
   }, {
-    rowKey: DataTableRowKey$1 | null;
+    rowKey: DataTableRowKey | null;
     columnKey: string | null;
   } | {
-    rowKey: DataTableRowKey$1 | null;
+    rowKey: DataTableRowKey | null;
     columnKey: string | null;
   }>;
-  isEditingCell: (rowKey: DataTableRowKey$1, columnKey: string) => boolean;
-  startEditCell: (rowKey: DataTableRowKey$1, columnKey: string) => void;
+  editingData: vue.Ref<Record<string, unknown>, Record<string, unknown>>;
+  isSaving: vue.Ref<boolean, boolean>;
+  isEditingCell: (rowKey: DataTableRowKey, columnKey: string) => boolean;
+  startEditCell: (rowKey: DataTableRowKey, columnKey: string) => boolean;
   saveEditCell: () => Promise<{
     updatedData: {
       [x: string]: unknown;
@@ -1272,37 +1513,209 @@ declare function useCellEdit(options: CellEditOptions): {
   cancelEditCell: () => void;
   validateCell: () => Promise<boolean>;
   cellValidationError: vue.Ref<string | null, string | null>;
-  getEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string) => unknown;
-  updateEditingCellValue: (rowKey: DataTableRowKey$1, columnKey: string, value: unknown) => void;
-  findRowData: (rowKey: DataTableRowKey$1) => DataRecord | null | undefined;
+  getEditingCellValue: (rowKey: DataTableRowKey, columnKey: string) => unknown;
+  updateEditingCellValue: (rowKey: DataTableRowKey, columnKey: string, value: unknown) => void;
+  findRowData: (rowKey: DataTableRowKey) => DataRecord | null | undefined;
 };
 //#endregion
 //#region src/components/C_Table/composables/useModalEdit.d.ts
-/**
- * 模态框编辑配置选项
- */
-interface ModalEditOptions<T = Record<string, any>> {
+interface ModalEditOptions<T extends object = DataRecord> {
   data: () => T[];
-  rowKey: (row: T) => DataTableRowKey$1;
-  onSave?: (editingData: Record<string, any>, rowIndex: number) => void | Promise<void>;
+  rowKey: (row: T) => DataTableRowKey;
+  onSave?: (editingData: T, rowIndex: number) => void | Promise<void>;
   onCancel?: (originalData: T, rowIndex: number) => void | Promise<void>;
 }
-/**
- * 模态框编辑组合函数，提供弹窗形式的数据编辑功能
- */
-declare function useModalEdit<T = Record<string, any>>(options: ModalEditOptions<T>): {
+/** Modal edit state with lossless snapshots and retry-safe async saves. */
+declare function useModalEdit<T extends object = DataRecord>(options: ModalEditOptions<T>): {
   isModalVisible: vue.Ref<boolean, boolean>;
-  editingData: vue.Ref<Record<string, any>, Record<string, any>>;
-  editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
+  isSaving: vue.Ref<boolean, boolean>;
+  editingData: [T] extends [vue.Ref<any, any>] ? _vue_shared0.IfAny<T, vue.Ref<T, T>, T> : vue.Ref<vue.UnwrapRef<T>, T | vue.UnwrapRef<T>>;
+  editingRowKey: vue.Ref<DataTableRowKey | null, DataTableRowKey | null>;
   editingRowIndex: vue.ComputedRef<number>;
-  startEdit: (rowKey: DataTableRowKey$1) => void;
-  saveEdit: (formData?: Record<string, any>) => Promise<void>;
-  cancelEdit: () => Promise<void>;
-  updateEditingData: (data: Record<string, any>) => void;
-  resetEditingState: () => void;
-  isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
-  getEditingRowData: (rowKey: DataTableRowKey$1) => Record<string, any> | null;
+  startEdit: (rowKey: DataTableRowKey, sourceData?: T) => boolean;
+  saveEdit: (formData?: T) => Promise<{
+    updatedData: any;
+    rowIndex: number;
+  } | undefined>;
+  cancelEdit: () => Promise<boolean>;
+  updateEditingData: (data: T) => boolean;
+  resetEditingState: () => boolean;
+  isEditingRow: (rowKey: DataTableRowKey) => boolean;
+  getEditingRowData: (rowKey: DataTableRowKey) => any;
+};
+//#endregion
+//#region src/plugins/highlight.d.ts
+interface HighlightPluginOptions {
+  autoDetect?: boolean;
+  extraLanguages?: string[];
+  /** Enable lifecycle diagnostics through the supplied logger. */
+  debug?: boolean;
+  logger?: Pick<Console, 'info' | 'warn' | 'error'>;
+  onError?: (error: unknown, context: {
+    source: 'language-loader';
+    language: string;
+  }) => void;
+}
+/**
+ * * @description 获取 highlight 功能的 API 接口
+ * ! @return highlight API 对象，包含所有可用方法
+ */
+declare const useHighlight: (options?: HighlightPluginOptions) => {
+  getHljs: () => HLJSApi;
+  loadLanguage: (language: string) => Promise<boolean>;
+  loadLanguages: (languages: string[]) => Promise<string[]>;
+  getLoadedLanguages: () => string[];
+};
+/**
+ * * @description 安装 highlight.js 插件到 Vue 应用
+ * ? @param app - Vue 应用实例
+ * ? @param options - 插件配置选项
+ * ! @return void
+ */
+declare function setupHighlight(app: App, options?: HighlightPluginOptions): void;
+declare global {
+  interface Window {
+    hljs: HLJSApi;
+  }
+}
+//#endregion
+//#region src/utils/storage.d.ts
+/** SSR-safe localStorage helpers. Storage failures never break component state. */
+/** Store a value. Returns false when storage is unavailable or full. */
+declare function setItem<T>(key: string, value: T): boolean;
+/** Read and safely deserialize a value. */
+declare function getItem<T = unknown>(key: string): T | null;
+/** Remove one value. Returns whether the storage operation was available. */
+declare function removeItem(key: string): boolean;
+/**
+ * Clear localStorage for backward compatibility.
+ * Prefer `removeItem` in components so unrelated application data is preserved.
+ */
+declare function removeAllItem(): boolean;
+//#endregion
+//#region src/components/C_Table/composables/useTableQuery.d.ts
+interface TableQueryContext<Q> {
+  page: number;
+  pageSize: number;
+  query: Readonly<Q>;
+  signal: AbortSignal;
+}
+interface TableQueryResult<T extends object> {
+  data: readonly T[];
+  total: number;
+}
+interface UseTableQueryOptions<T extends object, Q extends object> {
+  request: (context: TableQueryContext<Q>) => Promise<TableQueryResult<T>>;
+  initialQuery: Q;
+  columns?: MaybeRefOrGetter<TableColumn<T>[] | undefined>;
+  config?: MaybeRefOrGetter<TableConfig<T> | undefined>;
+  rowKey?: TableRowKey<T>;
+  initialPage?: number;
+  pageSize?: number;
+  immediate?: boolean;
+  onError?: (error: unknown) => void;
+  onSuccess?: (result: TableQueryResult<T>) => void;
+}
+/**
+ * Remote table controller with latest-request-wins cancellation and ready-to-bind props.
+ */
+declare function useTableQuery<T extends object, Q extends object = Record<string, unknown>>(options: UseTableQueryOptions<T, Q>): {
+  data: vue.ShallowRef<T[], T[]>;
+  loading: vue.Ref<boolean, boolean>;
+  error: vue.ShallowRef<unknown, unknown>;
+  total: vue.Ref<number, number>;
+  page: vue.Ref<number, number>;
+  pageSize: vue.Ref<number, number>;
+  query: vue.Ref<any, any> extends Q ? Q extends Q & vue.Ref<any, any> ? _vue_shared0.IfAny<Q, vue.ShallowRef<Q, Q>, Q> : vue.ShallowRef<Q, Q> : vue.ShallowRef<Q, Q>;
+  tableProps: vue.ComputedRef<{
+    data: T[];
+    loading: boolean;
+    columns: TableColumn<T>[] | undefined;
+    rowKey: TableRowKey<T>;
+    config: {
+      pagination: {
+        enabled: true;
+        remote: true;
+        page: number;
+        pageSize: number;
+        total: number;
+        showSizePicker?: boolean;
+        showQuickJumper?: boolean;
+        pageSizes?: number[];
+        simple?: boolean;
+        size?: "small" | "medium" | "large";
+      };
+      feedback?: ComponentFeedback;
+      locale?: ComponentLocale;
+      validateRowKeys?: boolean;
+      edit?: boolean | EditConfig<T> | undefined;
+      actions?: SimpleTableActions<T> | undefined;
+      expand?: boolean | ExpandConfig$1<T> | undefined;
+      selection?: boolean | SelectionConfig$1<T> | undefined;
+      dynamicRows?: boolean | DynamicRowsOptions<T> | undefined;
+      toolbar?: ToolbarConfig;
+      display?: DisplayConfig;
+      virtualScroll?: VirtualScrollConfig | boolean;
+      summary?: SummaryConfig<T> | undefined;
+      columnDrag?: ColumnDragConfig | boolean;
+      tree?: TreeConfig | boolean;
+      rowDrag?: RowDragConfig | boolean;
+      crossPageSelection?: CrossPageSelectionConfig | boolean;
+      export?: ExportConfig;
+      persistKey?: string;
+      formatterConfig?: FormatterConfig;
+      error?: ErrorConfig;
+      batchActions?: BatchActionsConfig<T> | undefined;
+    };
+  }>;
+  execute: () => Promise<boolean>;
+  reload: () => Promise<boolean>;
+  setQuery: (next: Partial<Q> | ((current: Readonly<Q>) => Q), reload?: boolean) => Promise<boolean>;
+  resetQuery: (reload?: boolean) => Promise<boolean>;
+  handlePaginationChange: (nextPage: number, nextPageSize: number) => Promise<boolean>;
+  bindings: vue.ComputedRef<{
+    onPaginationChange: (nextPage: number, nextPageSize: number) => Promise<boolean>;
+    data: T[];
+    loading: boolean;
+    columns: TableColumn<T>[] | undefined;
+    rowKey: TableRowKey<T>;
+    config: {
+      pagination: {
+        enabled: true;
+        remote: true;
+        page: number;
+        pageSize: number;
+        total: number;
+        showSizePicker?: boolean;
+        showQuickJumper?: boolean;
+        pageSizes?: number[];
+        simple?: boolean;
+        size?: "small" | "medium" | "large";
+      };
+      feedback?: ComponentFeedback;
+      locale?: ComponentLocale;
+      validateRowKeys?: boolean;
+      edit?: boolean | EditConfig<T> | undefined;
+      actions?: SimpleTableActions<T> | undefined;
+      expand?: boolean | ExpandConfig$1<T> | undefined;
+      selection?: boolean | SelectionConfig$1<T> | undefined;
+      dynamicRows?: boolean | DynamicRowsOptions<T> | undefined;
+      toolbar?: ToolbarConfig;
+      display?: DisplayConfig;
+      virtualScroll?: VirtualScrollConfig | boolean;
+      summary?: SummaryConfig<T> | undefined;
+      columnDrag?: ColumnDragConfig | boolean;
+      tree?: TreeConfig | boolean;
+      rowDrag?: RowDragConfig | boolean;
+      crossPageSelection?: CrossPageSelectionConfig | boolean;
+      export?: ExportConfig;
+      persistKey?: string;
+      formatterConfig?: FormatterConfig;
+      error?: ErrorConfig;
+      batchActions?: BatchActionsConfig<T> | undefined;
+    };
+  }>;
+  cancel: () => void;
 };
 //#endregion
-export { useDynamicRows as $, useTableGlobalConfig as A, resolveConfig as B, ColumnFormatter as C, TableGlobalConfig as D, TABLE_GLOBAL_CONFIG_KEY as E, SummaryConfig as F, UseCrossPageSelectionReturn as G, exportTableData as H, TableConfig as I, UseRowDragOptions as J, useCrossPageSelection as K, TreeConfig as L, ColumnDragConfig as M, CrudBinding as N, applyFormatter as O, ErrorConfig as P, DynamicRowsReturn as Q, VirtualScrollConfig as R, UseTableExpandReturn as S, FormatterType as T, CrossPageSelectionConfig as U, ExportConfig as V, UseCrossPageSelectionOptions as W, useRowDrag as X, UseRowDragReturn as Y, DynamicRowsOptions as Z, SelectOption as _, useTableExpand as a, TableEmits as b, useTableColumns as c, ColumnWithKey as d, PrintWatermarkOptions as et, DataRecord as f, ParentChildLinkMode as g, PaginationConfig as h, useTableActions as i, BatchActionsConfig as j, mergeGlobalConfig as k, _default as l, MaybeRefLike as m, useCellEdit as n, usePrintWatermark as nt, useTableManager as o, EditMode as p, RowDragConfig as q, usePagination as r, useRowEdit as s, useModalEdit as t, printPresets as tt, ChildSelectionState as u, SimpleTableActions as v, FormatterConfig as w, UseTableExpandOptions as x, TableColumn as y, createEditModeChecker as z };
-//# sourceMappingURL=useModalEdit.d.ts.map
+export { applyFormatter as $, EditMode as A, PrintWatermarkOptions as At, TableColumn as B, _default as C, RowDragConfig as Ct, ColumnWithKey as D, DynamicRowsOptions as Dt, ChildSelectionState as E, useRowDrag as Et, RenderFunction as F, TableRowKeyIssue as G, TableInstance as H, RowAction as I, ColumnFormatter as J, UseTableExpandOptions as K, SelectOption as L, NormalTableColumn as M, usePrintWatermark as Mt, PaginationConfig as N, CustomAction as O, DynamicRowsReturn as Ot, ParentChildLinkMode as P, TableGlobalConfig as Q, SimpleTableActions as R, validateTableRowKeys as S, useCrossPageSelection as St, BuiltInTableColumn as T, UseRowDragReturn as Tt, TableProps as U, TableEmits as V, TableRowKey as W, FormatterType as X, FormatterConfig as Y, TABLE_GLOBAL_CONFIG_KEY as Z, useTableManager as _, ExportConfig as _t, getItem as a, DisplayConfig as at, defineTableColumns as b, UseCrossPageSelectionOptions as bt, setItem as c, ExpandConfig$1 as ct, useHighlight as d, TableConfig as dt, mergeGlobalConfig as et, useModalEdit as f, ToolbarConfig as ft, useTableExpand as g, resolveConfig as gt, useTableActions as h, createEditModeChecker as ht, useTableQuery as i, CrudBinding as it, MaybeRefLike as j, printPresets as jt, DataRecord as k, useDynamicRows as kt, HighlightPluginOptions as l, SelectionConfig$1 as lt, usePagination as m, VirtualScrollConfig as mt, TableQueryResult as n, BatchActionsConfig as nt, removeAllItem as o, EditConfig as ot, useCellEdit as p, TreeConfig as pt, UseTableExpandReturn as q, UseTableQueryOptions as r, ColumnDragConfig as rt, removeItem as s, ErrorConfig as st, TableQueryContext as t, useTableGlobalConfig as tt, setupHighlight as u, SummaryConfig as ut, useRowEdit as v, exportTableData as vt, ApiFunction as w, UseRowDragOptions as wt, defineTableConfig as x, UseCrossPageSelectionReturn as xt, useTableColumns as y, CrossPageSelectionConfig as yt, StrictTableColumn as z };