@robot-admin/naive-ui-components 0.6.31 → 0.7.1

package/dist/useModalEdit.d.ts

@@ -1,215 +1,10 @@
 import { DataTableColumns, DataTableRowKey } from "naive-ui";
 import * as vue from "vue";
-import { ComputedRef, MaybeRef, Ref, VNodeChild } 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";
 
-//#region src/components/C_Table/types.d.ts
-type RefLike<T> = {
-  value: T;
-} | T;
-type MaybeRefLike<T> = RefLike<T> | MaybeRef<T>;
-type DataRecord = Record<string, 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';
-type ParentChildLinkMode = 'strict' | 'loose';
-interface PaginationConfig {
-  enabled?: boolean;
-  page?: number;
-  pageSize?: number;
-  total?: number;
-  showSizePicker?: boolean;
-  showQuickJumper?: boolean;
-  pageSizes?: number[];
-  simple?: boolean;
-  size?: 'small' | 'medium' | 'large';
-  remote?: boolean;
-}
-/** API 函数类型 */
-type ApiFunction<T extends DataRecord = DataRecord> = (row: T, index: number) => Promise<any> | any;
-/** 渲染函数类型 */
-type RenderFunction<T extends DataRecord = DataRecord> = (row: T, index: number) => VNodeChild;
-/** 自定义操作按钮配置 */
-interface CustomAction<T extends DataRecord = DataRecord> {
-  /** 按钮唯一键 */
-  key: string;
-  /** 按钮显示文本 */
-  label: string | ((row: T, index: number) => string);
-  /** 按钮图标 */
-  icon: string | ((row: T, index: number) => string);
-  /** 按钮类型样式 */
-  type?: ButtonType | ((row: T, index: number) => ButtonType);
-  /** 点击事件处理器 */
-  onClick: (row: T, index: number) => void | Promise<void>;
-  /** 条件显示函数（可选） */
-  show?: (row: T, index: number) => boolean;
-  /** 是否禁用（可选） */
-  disabled?: (row: T, index: number) => boolean;
-  /** 按钮提示文本（可选） */
-  tooltip?: string;
-}
-/** 简化的操作配置 - 二元法则 */
-interface SimpleTableActions<T extends DataRecord = DataRecord> {
-  /** 编辑操作 - 直接传入函数 */
-  edit?: false | ApiFunction<T>;
-  /** 删除操作 - 直接传入函数 */
-  delete?: false | ApiFunction<T>;
-  /** 详情操作 - 直接传入函数 */
-  detail?: false | ApiFunction<T>;
-  /** 自定义操作按钮 */
-  custom?: CustomAction<T>[];
-  /** 完全自定义渲染 - 10%场景 */
-  render?: RenderFunction<T>;
-}
-/** useTableActions Hook 选项类型 */
-interface UseTableActionsOptions<T extends DataRecord = DataRecord> {
-  /** 操作配置 */
-  actions: Ref<SimpleTableActions<T>> | ComputedRef<SimpleTableActions<T>>;
-  /** 表格配置 */
-  config: Ref<any> | ComputedRef<any>;
-  /** 表格管理器 */
-  tableManager: any;
-  /** 行键获取函数 */
-  rowKey: (row: T) => DataTableRowKey;
-  /** 事件发射器 */
-  emit: any;
-  /** 查看详情回调 */
-  onViewDetail?: (data: T) => void;
-}
-/** useTableActions Hook 返回类型 */
-interface UseTableActionsReturn<T extends DataRecord = DataRecord> {
-  /** 渲染操作列 */
-  renderActions: (rowData: T, rowIndex: number) => VNodeChild;
-  /** 检查操作是否启用 */
-  isActionEnabled: (actionKey: 'edit' | 'delete' | 'detail') => boolean;
-}
-interface BaseOption {
-  label: string;
-  value: string | number;
-  disabled?: boolean;
-}
-interface BaseConfig<T extends DataRecord = DataRecord> {
-  enabled?: boolean;
-  rowCheckable?: (row: T) => boolean;
-}
-type SelectOption = BaseOption;
-interface EditProps {
-  min?: number;
-  max?: number;
-  step?: number;
-  showButton?: boolean;
-  type?: string;
-  rows?: number;
-  placeholder?: string;
-  options?: SelectOption[];
-  rules?: FormItemRule[];
-  format?: string;
-  valueFormat?: string;
-  clearable?: boolean;
-  disabled?: boolean;
-  readonly?: boolean;
-}
-/**
- * ================= 列类型系统 =================
- * 说明：
- * - BaseTableColumn：去除了 naive 的 key/title/render，提供扩展位
- * - NormalTableColumn：普通数据列，必须有 key + title
- * - BuiltInTableColumn：内置列（selection/expand），不需要 key/title
- * - TableColumn：以上二者联合
- */
-interface BaseTableColumn<T extends DataRecord = DataRecord> extends Omit<DataTableColumns<T>[number], 'key' | 'title' | 'render' | 'type'> {
-  key?: any;
-  title?: string;
-  visible?: boolean;
-  editable?: boolean;
-  required?: boolean;
-  editType?: EditType;
-  editProps?: EditProps;
-  editRender?: (value: any, rowData: T, rowIndex: number) => VNodeChild;
-  render?: (rowData: T, rowIndex: number) => VNodeChild;
-  fixed?: 'left' | 'right';
-  resizable?: boolean;
-  minWidth?: number;
-  maxWidth?: number;
-}
-interface NormalTableColumn<T extends DataRecord = DataRecord> extends BaseTableColumn<T> {
-  key: keyof T | string;
-  title: string;
-}
-interface BuiltInTableColumn<T extends DataRecord = 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>;
-interface ChildSelectionState {
-  selectedKeys: DataTableRowKey[];
-  isAllChecked: boolean;
-  selectAll: () => void;
-  clearAll: () => void;
-}
-interface ExpandConfig$1<T extends DataRecord = DataRecord, C = any> {
-  onLoadData?: (row: T) => Promise<C[]> | C[];
-  renderContent?: (row: T, expandData: C[], loading: boolean, childSelection?: ChildSelectionState) => VNodeChild;
-  rowExpandable?: (row: T) => boolean;
-}
-interface SelectionConfig$1<T extends DataRecord = DataRecord> extends BaseConfig<T> {
-  enableSelection?: boolean;
-  defaultCheckedKeys?: DataTableRowKey[];
-  maxSelection?: number;
-  enableChildSelection?: boolean;
-  childRowCheckable?: (childRow: any, parentRow: T) => boolean;
-  enableParentChildLink?: boolean;
-  parentChildLinkMode?: ParentChildLinkMode;
-}
-interface TableExpandEvents<T extends DataRecord = DataRecord> {
-  'expand-change': [expandedKeys: DataTableRowKey[], row?: T, expanded?: boolean];
-}
-interface TableSelectionEvents<T extends DataRecord = DataRecord> {
-  'selection-change': [checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]>];
-  'child-selection-change': [parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: any[]];
-  'parent-child-link-change': [parentKey: DataTableRowKey, shouldSelect: boolean];
-}
-interface TableEditEvents<T extends DataRecord = DataRecord> {
-  'update:data': [data: T[]];
-  save: [rowData: T, rowIndex: number, columnKey?: string];
-  cancel: [rowData: T, rowIndex: number];
-}
-interface TableEmits<T extends DataRecord = DataRecord> extends TableExpandEvents<T>, TableSelectionEvents<T>, TableEditEvents<T> {
-  'pagination-change': [page: number, pageSize: number];
-  'row-delete': [deletedRow: T, index: number];
-}
-interface UseTableExpandOptions<T extends DataRecord = DataRecord, C = any> extends ExpandConfig$1<T, C>, SelectionConfig$1<T> {
-  data: Ref<T[]> | ComputedRef<T[]>;
-  rowKey: (row: T) => DataTableRowKey;
-  childRowKey?: (child: C) => DataTableRowKey;
-  defaultExpandedKeys?: DataTableRowKey[];
-  onExpandChange?: (expandedKeys: DataTableRowKey[], row?: T, expanded?: boolean) => void;
-  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> {
-  expandedKeys: Ref<DataTableRowKey[]>;
-  checkedKeys: Ref<DataTableRowKey[]>;
-  childSelections: Ref<Map<DataTableRowKey, DataTableRowKey[]>>;
-  expandDataMap: Ref<Map<DataTableRowKey, C[]>>;
-  loadingMap: Ref<Map<DataTableRowKey, boolean>>;
-  selectedRowsCount: ComputedRef<number>;
-  totalChildSelections: ComputedRef<number>;
-  expandAll: () => Promise<void>;
-  collapseAll: () => void;
-  expandRow: (key: DataTableRowKey) => Promise<void>;
-  handleExpandChange: (keys: DataTableRowKey[]) => void;
-  selectAll: () => void;
-  clearSelection: () => void;
-  clearAllSelections: () => void;
-  handleSelectionChange: (keys: DataTableRowKey[]) => void;
-  getTableColumns: (originalColumns: TableColumn<T>[]) => any[];
-}
-//#endregion
 //#region src/components/C_Table/composables/usePrintWatermark.d.ts
 interface WatermarkConfig {
   text: string;
@@ -396,6 +191,96 @@ interface DynamicRowsReturn<T extends DataRecord = DataRecord> {
  */
 declare function useDynamicRows<T extends DataRecord = DataRecord>(data: Ref<T[]>, options?: DynamicRowsOptions<T>): DynamicRowsReturn<T>;
 //#endregion
+//#region src/components/C_Table/composables/useRowDrag.d.ts
+interface RowDragConfig {
+  enabled?: boolean;
+  /** 拖拽手柄 CSS 选择器（不传则整行可拖） */
+  handleSelector?: string;
+  /** 动画时长（ms） */
+  animationDuration?: number;
+  /** 拖拽时 ghost 样式类 */
+  ghostClass?: string;
+  /** 拖拽中样式类 */
+  chosenClass?: string;
+}
+interface UseRowDragOptions<T extends DataRecord = DataRecord> {
+  /** 数据源（只读即可） */
+  data: Ref<T[]> | ComputedRef<T[]>;
+  /** 获取行键 */
+  rowKey: (row: T) => DataTableRowKey$1;
+  /** 配置 */
+  config: RowDragConfig;
+  /** 数据重排回调（由外部处理数据更新） */
+  onReorder?: (newData: T[]) => void;
+  /** 排序变更回调 */
+  onSort?: (row: T, fromIndex: number, toIndex: number) => void;
+}
+interface UseRowDragReturn {
+  /** 初始化拖拽（需在 onMounted 中调用） */
+  initRowDrag: (wrapperEl: HTMLElement) => void;
+  /** 销毁拖拽实例 */
+  destroyRowDrag: () => void;
+  /** 是否正在拖拽 */
+  isDragging: Ref<boolean>;
+}
+/** 行拖拽排序组合式函数 */
+declare function useRowDrag<T extends DataRecord = DataRecord>(options: UseRowDragOptions<T>): UseRowDragReturn;
+//#endregion
+//#region src/components/C_Table/composables/useCrossPageSelection.d.ts
+interface CrossPageSelectionConfig {
+  enabled?: boolean;
+  /** 最大选择数 */
+  maxSelection?: number;
+}
+interface UseCrossPageSelectionOptions<T extends DataRecord = DataRecord> {
+  /** 全量数据（非分页后的） */
+  allData: Ref<T[]> | ComputedRef<T[]>;
+  /** 行键函数 */
+  rowKey: (row: T) => DataTableRowKey$1;
+  /** 配置 */
+  config: CrossPageSelectionConfig;
+}
+interface UseCrossPageSelectionReturn<T extends DataRecord = DataRecord> {
+  /** 所有选中的 key（跨页） */
+  selectedKeys: Ref<Set<DataTableRowKey$1>>;
+  /** 选中行数量 */
+  selectedCount: ComputedRef<number>;
+  /** 当前页数据的 checkedKeys（给 NDataTable 绑定） */
+  getPageCheckedKeys: (pageData: T[]) => DataTableRowKey$1[];
+  /** NDataTable @update:checked-row-keys 处理器 */
+  handlePageSelectionChange: (keys: DataTableRowKey$1[], pageData: T[]) => void;
+  /** 全选所有页 */
+  selectAll: () => void;
+  /** 清除所有页选中 */
+  clearAll: () => void;
+  /** 获取所有选中行数据 */
+  getSelectedRows: () => T[];
+  /** 判断 key 是否选中 */
+  isSelected: (key: DataTableRowKey$1) => boolean;
+}
+/** 跨页多选组合式函数 */
+declare function useCrossPageSelection<T extends DataRecord = DataRecord>(options: UseCrossPageSelectionOptions<T>): UseCrossPageSelectionReturn<T>;
+//#endregion
+//#region src/components/C_Table/composables/useTableExport.d.ts
+interface ExportConfig {
+  /** 导出文件名（不含扩展名） */
+  filename?: string;
+  /** 导出格式 */
+  format?: 'csv' | 'xlsx';
+  /** 是否包含表头 */
+  includeHeader?: boolean;
+  /** 自定义选择导出列（传 key 数组） */
+  columnKeys?: string[];
+  /** CSV 分隔符 */
+  csvSeparator?: string;
+  /** 全局格式化配置（用于 formatter） */
+  formatterConfig?: FormatterConfig;
+}
+/**
+ * 导出表格数据
+ */
+declare function exportTableData(data: DataRecord[], columns: TableColumn[], config?: ExportConfig): Promise<void>;
+//#endregion
 //#region src/components/C_Table/composables/useTableConfig.d.ts
 /**
  * 可绑定到 C_Table 的 CRUD 对象接口（桥接类型）
@@ -428,9 +313,9 @@ interface TableConfig<T extends DataRecord = DataRecord> {
   /** 分页配置 */
   pagination?: PaginationConfig | boolean;
   /** 展开行配置 */
-  expand?: ExpandConfig<T> | boolean;
+  expand?: ExpandConfig$1<T> | boolean;
   /** 选择配置 */
-  selection?: SelectionConfig<T> | boolean;
+  selection?: SelectionConfig$1<T> | boolean;
   /** 动态行配置 */
   dynamicRows?: DynamicRowsOptions<T> | boolean;
   /** 工具栏 */
@@ -443,6 +328,22 @@ interface TableConfig<T extends DataRecord = DataRecord> {
   summary?: SummaryConfig<T>;
   /** 列拖拽排序 */
   columnDrag?: ColumnDragConfig | boolean;
+  /** 树形表格 */
+  tree?: TreeConfig | boolean;
+  /** 行拖拽排序 */
+  rowDrag?: RowDragConfig | boolean;
+  /** 跨页多选 */
+  crossPageSelection?: CrossPageSelectionConfig | boolean;
+  /** 导出配置 */
+  export?: ExportConfig;
+  /** 列配置持久化 key（传入即启用 localStorage） */
+  persistKey?: string;
+  /** 全局格式化配置 */
+  formatterConfig?: FormatterConfig;
+  /** 错误状态配置 */
+  error?: ErrorConfig;
+  /** 批量操作配置 */
+  batchActions?: BatchActionsConfig;
 }
 interface EditConfig {
   enabled?: boolean;
@@ -451,14 +352,14 @@ interface EditConfig {
   modalTitle?: string;
   modalWidth?: number;
 }
-interface ExpandConfig<T extends DataRecord = DataRecord> {
+interface ExpandConfig$1<T extends DataRecord = DataRecord> {
   enabled?: boolean;
   defaultExpandedKeys?: DataTableRowKey$1[];
   onLoadData?: (row: T) => Promise<unknown[]> | unknown[];
   renderContent?: (row: T, expandData: unknown[], loading: boolean, childSelection?: unknown) => VNodeChild;
   rowExpandable?: (row: T) => boolean;
 }
-interface SelectionConfig<T extends DataRecord = DataRecord> {
+interface SelectionConfig$1<T extends DataRecord = DataRecord> {
   enabled?: boolean;
   defaultCheckedKeys?: naive_ui_es0.DataTableRowKey[];
   rowCheckable?: (row: T) => boolean;
@@ -513,6 +414,37 @@ interface ColumnDragConfig {
   /** 拖拽动画时长（ms） */
   animationDuration?: number;
 }
+/** 树形表格配置 */
+interface TreeConfig {
+  enabled?: boolean;
+  /** 子节点字段名 */
+  childrenKey?: string;
+  /** 缩进宽度（px） */
+  indent?: number;
+  /** 默认展开所有 */
+  defaultExpandAll?: boolean;
+}
+/** 错误状态配置 */
+interface ErrorConfig {
+  /** 是否显示错误状态 */
+  show?: boolean;
+  /** 错误描述文案 */
+  message?: string;
+  /** 重试回调 */
+  onRetry?: () => void | Promise<void>;
+}
+/** 批量操作配置 */
+interface BatchActionsConfig {
+  enabled?: boolean;
+  /** 自定义批量操作按钮 */
+  actions?: Array<{
+    key: string;
+    label: string;
+    icon?: string;
+    type?: string;
+    onClick: (selectedKeys: DataTableRowKey$1[], selectedRows: DataRecord[]) => void | Promise<void>;
+  }>;
+}
 interface ResolvedConfig {
   editable: boolean;
   editMode: string;
@@ -557,6 +489,25 @@ interface ResolvedConfig {
   enableColumnDrag: boolean;
   columnDragHandleClass: string;
   columnDragAnimationDuration: number;
+  /** 树形表格 */
+  treeEnabled: boolean;
+  treeChildrenKey: string;
+  treeIndent: number;
+  treeDefaultExpandAll: boolean;
+  /** 行拖拽 */
+  rowDrag: RowDragConfig | undefined;
+  /** 跨页多选 */
+  crossPageSelection: CrossPageSelectionConfig | undefined;
+  /** 导出配置 */
+  exportConfig: ExportConfig | undefined;
+  /** 列持久化 key */
+  persistKey: string | undefined;
+  /** 全局格式化配置 */
+  formatterConfig: FormatterConfig | undefined;
+  /** 错误状态 */
+  error: ErrorConfig | undefined;
+  /** 批量操作 */
+  batchActions: BatchActionsConfig | undefined;
 }
 /**
  * 将 config 单一对象解析为内部扁平化配置
@@ -568,6 +519,285 @@ declare const createEditModeChecker: (config: ResolvedConfig) => {
   isCellEditMode: () => boolean;
 };
 //#endregion
+//#region src/components/C_Table/composables/useTableGlobalConfig.d.ts
+type FormatterType = 'date' | 'datetime' | 'currency' | 'percent' | 'enum' | 'number';
+interface FormatterConfig {
+  /** 日期格式 */
+  date?: {
+    format?: string;
+  };
+  /** 日期时间格式 */
+  datetime?: {
+    format?: string;
+  };
+  /** 货币格式 */
+  currency?: {
+    prefix?: string;
+    suffix?: string;
+    precision?: number;
+  };
+  /** 百分比格式 */
+  percent?: {
+    precision?: number;
+    suffix?: string;
+  };
+  /** 数字格式（千分位） */
+  number?: {
+    precision?: number;
+  };
+}
+/** 列级 formatter 配置 */
+interface ColumnFormatter {
+  type: FormatterType;
+  /** enum mapping：{ male: '男', female: '女' } */
+  mapping?: Record<string, string>;
+  /** 自定义格式化函数（优先级最高） */
+  fn?: (value: unknown, row: DataRecord) => string;
+  /** 覆盖全局格式配置 */
+  config?: Record<string, unknown>;
+}
+interface TableGlobalConfig {
+  /** 表格显示默认值 */
+  display?: DisplayConfig;
+  /** 默认分页条数 */
+  pageSize?: number;
+  /** 空状态文案 */
+  emptyText?: string;
+  /** 全局格式化配置 */
+  formatter?: FormatterConfig;
+  /** 列配置持久化前缀 */
+  persistPrefix?: string;
+  /** 默认导出文件名 */
+  exportFilename?: string;
+}
+declare const TABLE_GLOBAL_CONFIG_KEY: InjectionKey<TableGlobalConfig>;
+/** 根据 ColumnFormatter 配置格式化单元格值 */
+declare function applyFormatter(value: unknown, row: DataRecord, formatter: ColumnFormatter, globalConfig?: FormatterConfig): string;
+/** 在组件内获取全局配置（自动合并默认值） */
+declare function useTableGlobalConfig(): TableGlobalConfig;
+/** 合并全局配置到 TableConfig（局部 > 全局 > 默认） */
+declare function mergeGlobalConfig(local: TableConfig, global: TableGlobalConfig): TableConfig;
+//#endregion
+//#region src/components/C_Table/types.d.ts
+type RefLike<T> = {
+  value: T;
+} | T;
+type MaybeRefLike<T> = RefLike<T> | MaybeRef<T>;
+type DataRecord = Record<string, 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';
+type ParentChildLinkMode = 'strict' | 'loose';
+interface PaginationConfig {
+  enabled?: boolean;
+  page?: number;
+  pageSize?: number;
+  total?: number;
+  showSizePicker?: boolean;
+  showQuickJumper?: boolean;
+  pageSizes?: number[];
+  simple?: boolean;
+  size?: 'small' | 'medium' | 'large';
+  remote?: boolean;
+}
+/** API 函数类型 */
+type ApiFunction<T extends DataRecord = DataRecord> = (row: T, index: number) => Promise<any> | any;
+/** 渲染函数类型 */
+type RenderFunction<T extends DataRecord = DataRecord> = (row: T, index: number) => VNodeChild;
+/** 自定义操作按钮配置 */
+interface CustomAction<T extends DataRecord = DataRecord> {
+  /** 按钮唯一键 */
+  key: string;
+  /** 按钮显示文本 */
+  label: string | ((row: T, index: number) => string);
+  /** 按钮图标 */
+  icon: string | ((row: T, index: number) => string);
+  /** 按钮类型样式 */
+  type?: ButtonType | ((row: T, index: number) => ButtonType);
+  /** 点击事件处理器 */
+  onClick: (row: T, index: number) => void | Promise<void>;
+  /** 条件显示函数（可选） */
+  show?: (row: T, index: number) => boolean;
+  /** 是否禁用（可选） */
+  disabled?: (row: T, index: number) => boolean;
+  /** 按钮提示文本（可选） */
+  tooltip?: string;
+}
+/** 简化的操作配置 - 二元法则 */
+interface SimpleTableActions<T extends DataRecord = DataRecord> {
+  /** 编辑操作 - 直接传入函数 */
+  edit?: false | ApiFunction<T>;
+  /** 删除操作 - 直接传入函数 */
+  delete?: false | ApiFunction<T>;
+  /** 详情操作 - 直接传入函数 */
+  detail?: false | ApiFunction<T>;
+  /** 自定义操作按钮 */
+  custom?: CustomAction<T>[];
+  /** 完全自定义渲染 - 10%场景 */
+  render?: RenderFunction<T>;
+}
+/** useTableActions Hook 选项类型 */
+interface UseTableActionsOptions<T extends DataRecord = DataRecord> {
+  /** 操作配置 */
+  actions: Ref<SimpleTableActions<T>> | ComputedRef<SimpleTableActions<T>>;
+  /** 表格配置 */
+  config: Ref<any> | ComputedRef<any>;
+  /** 表格管理器 */
+  tableManager: any;
+  /** 行键获取函数 */
+  rowKey: (row: T) => DataTableRowKey;
+  /** 事件发射器 */
+  emit: any;
+  /** 查看详情回调 */
+  onViewDetail?: (data: T) => void;
+}
+/** useTableActions Hook 返回类型 */
+interface UseTableActionsReturn<T extends DataRecord = DataRecord> {
+  /** 渲染操作列 */
+  renderActions: (rowData: T, rowIndex: number) => VNodeChild;
+  /** 检查操作是否启用 */
+  isActionEnabled: (actionKey: 'edit' | 'delete' | 'detail') => boolean;
+}
+interface BaseOption {
+  label: string;
+  value: string | number;
+  disabled?: boolean;
+}
+interface BaseConfig<T extends DataRecord = DataRecord> {
+  enabled?: boolean;
+  rowCheckable?: (row: T) => boolean;
+}
+type SelectOption = BaseOption;
+interface EditProps {
+  min?: number;
+  max?: number;
+  step?: number;
+  showButton?: boolean;
+  type?: string;
+  rows?: number;
+  placeholder?: string;
+  options?: SelectOption[];
+  rules?: FormItemRule[];
+  format?: string;
+  valueFormat?: string;
+  clearable?: boolean;
+  disabled?: boolean;
+  readonly?: boolean;
+}
+/**
+ * ================= 列类型系统 =================
+ * 说明：
+ * - BaseTableColumn：去除了 naive 的 key/title/render，提供扩展位
+ * - NormalTableColumn：普通数据列，必须有 key + title
+ * - BuiltInTableColumn：内置列（selection/expand），不需要 key/title
+ * - TableColumn：以上二者联合
+ */
+interface BaseTableColumn<T extends DataRecord = DataRecord> extends Omit<DataTableColumns<T>[number], 'key' | 'title' | 'render' | 'type'> {
+  key?: any;
+  title?: string;
+  visible?: boolean;
+  editable?: boolean;
+  required?: boolean;
+  editType?: EditType;
+  editProps?: EditProps;
+  editRender?: (value: any, rowData: T, rowIndex: number) => VNodeChild;
+  render?: (rowData: T, rowIndex: number) => VNodeChild;
+  /** 声明式格式化器（优先级低于 render） */
+  formatter?: ColumnFormatter;
+  fixed?: 'left' | 'right';
+  resizable?: boolean;
+  minWidth?: number;
+  maxWidth?: number;
+}
+interface NormalTableColumn<T extends DataRecord = DataRecord> extends BaseTableColumn<T> {
+  key: keyof T | string;
+  title: string;
+}
+interface BuiltInTableColumn<T extends DataRecord = 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>;
+interface ChildSelectionState {
+  selectedKeys: DataTableRowKey[];
+  isAllChecked: boolean;
+  selectAll: () => void;
+  clearAll: () => void;
+}
+interface ExpandConfig<T extends DataRecord = DataRecord, C = any> {
+  onLoadData?: (row: T) => Promise<C[]> | C[];
+  renderContent?: (row: T, expandData: C[], loading: boolean, childSelection?: ChildSelectionState) => VNodeChild;
+  rowExpandable?: (row: T) => boolean;
+}
+interface SelectionConfig<T extends DataRecord = DataRecord> extends BaseConfig<T> {
+  enableSelection?: boolean;
+  defaultCheckedKeys?: DataTableRowKey[];
+  maxSelection?: number;
+  enableChildSelection?: boolean;
+  childRowCheckable?: (childRow: any, parentRow: T) => boolean;
+  enableParentChildLink?: boolean;
+  parentChildLinkMode?: ParentChildLinkMode;
+}
+interface TableExpandEvents<T extends DataRecord = DataRecord> {
+  'expand-change': [expandedKeys: DataTableRowKey[], row?: T, expanded?: boolean];
+}
+interface TableSelectionEvents<T extends DataRecord = DataRecord> {
+  'selection-change': [checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]>];
+  'child-selection-change': [parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: any[]];
+  'parent-child-link-change': [parentKey: DataTableRowKey, shouldSelect: boolean];
+}
+interface TableEditEvents<T extends DataRecord = DataRecord> {
+  'update:data': [data: T[]];
+  save: [rowData: T, rowIndex: number, columnKey?: string];
+  cancel: [rowData: T, rowIndex: number];
+}
+interface TableEmits<T extends DataRecord = DataRecord> extends TableExpandEvents<T>, TableSelectionEvents<T>, TableEditEvents<T> {
+  'pagination-change': [page: number, pageSize: number];
+  'row-delete': [deletedRow: T, index: number];
+}
+interface UseTableExpandOptions<T extends DataRecord = DataRecord, C = any> extends ExpandConfig<T, C>, SelectionConfig<T> {
+  data: Ref<T[]> | ComputedRef<T[]>;
+  rowKey: (row: T) => DataTableRowKey;
+  childRowKey?: (child: C) => DataTableRowKey;
+  defaultExpandedKeys?: DataTableRowKey[];
+  onExpandChange?: (expandedKeys: DataTableRowKey[], row?: T, expanded?: boolean) => void;
+  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> {
+  expandedKeys: Ref<DataTableRowKey[]>;
+  checkedKeys: Ref<DataTableRowKey[]>;
+  childSelections: Ref<Map<DataTableRowKey, DataTableRowKey[]>>;
+  expandDataMap: Ref<Map<DataTableRowKey, C[]>>;
+  loadingMap: Ref<Map<DataTableRowKey, boolean>>;
+  selectedRowsCount: ComputedRef<number>;
+  totalChildSelections: ComputedRef<number>;
+  expandAll: () => Promise<void>;
+  collapseAll: () => void;
+  expandRow: (key: DataTableRowKey) => Promise<void>;
+  handleExpandChange: (keys: DataTableRowKey[]) => void;
+  selectAll: () => void;
+  clearSelection: () => void;
+  clearAllSelections: () => void;
+  handleSelectionChange: (keys: DataTableRowKey[]) => void;
+  getTableColumns: (originalColumns: TableColumn<T>[]) => any[];
+}
+/**
+ * 展平 TableColumn 联合类型以便直接访问 key/title/visible 等属性。
+ * 各 composable 共用此类型，避免重复定义。
+ */
+type ColumnWithKey = TableColumn & {
+  key?: string;
+  title?: string;
+  visible?: boolean;
+  width?: number | string;
+  align?: string;
+  titleAlign?: string;
+  formatter?: ColumnFormatter;
+};
+//#endregion
 //#region src/components/C_Table/index.vue.d.ts
 type __VLS_Props = {
   /** 列配置（crud 模式下可省略） */columns?: TableColumn[]; /** 数据源（crud 模式下可省略） */
@@ -577,11 +807,15 @@ type __VLS_Props = {
   config?: TableConfig; /** CRUD 绑定 — 传入 useTableCrud() 的返回值，自动接管 data/columns/loading/actions/pagination/events */
   crud?: CrudBinding;
 };
-declare var __VLS_6: {}, __VLS_8: {};
+declare var __VLS_6: {}, __VLS_8: {}, __VLS_52: {
+    error: ErrorConfig;
+  };
 type __VLS_Slots = {} & {
   'toolbar-left'?: (props: typeof __VLS_6) => any;
 } & {
   'toolbar-right'?: (props: typeof __VLS_8) => any;
+} & {
+  error?: (props: typeof __VLS_52) => any;
 };
 declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
   startEdit: (rowKey: DataTableRowKey$1, columnKey?: string) => void;
@@ -640,7 +874,15 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
       download(elementRef?: HTMLElement, filename?: string): Promise<void>;
     };
     clearAllSelections(): void;
-  };
+  }; /** 导出数据 */
+  exportData: () => Promise<void>; /** 跨页选择 */
+  crossPageSelection: {
+    selectedKeys: vue.Ref<Set<DataTableRowKey$1>, Set<DataTableRowKey$1>>;
+    selectedCount: vue.ComputedRef<number>;
+    selectAll: () => void;
+    clearAll: () => void;
+    getSelectedRows: () => DataRecord[];
+  } | undefined;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   cancel: (rowData: DataRecord, rowIndex: number) => any;
   save: (rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => any;
@@ -747,6 +989,48 @@ interface UseTableColumnsReturn {
  */
 declare function useTableColumns(options: UseTableColumnsOptions): UseTableColumnsReturn;
 //#endregion
+//#region src/components/C_Table/composables/useRowEdit.d.ts
+/** 行级校验错误 */
+interface RowValidationError {
+  field: string;
+  message: string;
+}
+/**
+ * 行编辑配置选项
+ */
+interface RowEditOptions {
+  data: () => DataRecord[];
+  rowKey: (row: DataRecord) => DataTableRowKey$1;
+  onSave?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
+  onCancel?: (rowData: DataRecord, rowIndex: number) => void;
+  /** 列配置（用于提取校验规则） */
+  columns?: () => TableColumn[];
+}
+/**
+ * 可编辑行组合函数，提供表格整行的编辑功能
+ */
+declare function useRowEdit(options: RowEditOptions): {
+  editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
+  isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
+  startEditRow: (rowKey: DataTableRowKey$1) => void;
+  cancelEditRow: () => Promise<void>;
+  saveEditRow: () => Promise<{
+    updatedData: DataRecord;
+    rowIndex: number;
+  } | undefined>;
+  validateRow: () => Promise<boolean>;
+  validationErrors: vue.Ref<{
+    field: string;
+    message: string;
+  }[], RowValidationError[] | {
+    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;
+};
+//#endregion
 //#region src/components/C_Table/composables/useTableManager.d.ts
 /**
  * 表格管理器配置接口
@@ -780,6 +1064,8 @@ interface TableManagerParams {
   data: () => DataRecord[];
   rowKey: (row: DataRecord) => DataTableRowKey$1;
   emit: (...args: any[]) => void;
+  /** 列配置（用于编辑校验） */
+  columns?: () => TableColumn[];
 }
 /**
  * 事件处理器接口
@@ -811,6 +1097,14 @@ declare function useTableManager(params: TableManagerParams): {
         updatedData: DataRecord;
         rowIndex: number;
       } | undefined>;
+      validateRow: () => Promise<boolean>;
+      validationErrors: vue.Ref<{
+        field: string;
+        message: string;
+      }[], RowValidationError[] | {
+        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;
@@ -836,6 +1130,8 @@ declare function useTableManager(params: TableManagerParams): {
         columnKey: string;
       } | undefined>;
       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;
@@ -939,33 +1235,6 @@ interface UsePaginationReturn<T extends DataRecord = DataRecord> {
 }
 declare function usePagination<T extends DataRecord = DataRecord>(options: UsePaginationOptions<T>): UsePaginationReturn<T>;
 //#endregion
-//#region src/components/C_Table/composables/useRowEdit.d.ts
-/**
- * 行编辑配置选项
- */
-interface RowEditOptions {
-  data: () => DataRecord[];
-  rowKey: (row: DataRecord) => DataTableRowKey$1;
-  onSave?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
-  onCancel?: (rowData: DataRecord, rowIndex: number) => void;
-}
-/**
- * 可编辑行组合函数，提供表格整行的编辑功能
- */
-declare function useRowEdit(options: RowEditOptions): {
-  editingRowKey: vue.Ref<DataTableRowKey$1 | null, DataTableRowKey$1 | null>;
-  isEditingRow: (rowKey: DataTableRowKey$1) => boolean;
-  startEditRow: (rowKey: DataTableRowKey$1) => void;
-  cancelEditRow: () => Promise<void>;
-  saveEditRow: () => Promise<{
-    updatedData: DataRecord;
-    rowIndex: number;
-  } | undefined>;
-  getEditingRowData: (rowKey: DataTableRowKey$1) => DataRecord;
-  updateEditingRowData: (rowKey: DataTableRowKey$1, field: string, value: unknown) => void;
-  findRowData: (rowKey: DataTableRowKey$1) => DataRecord | null | undefined;
-};
-//#endregion
 //#region src/components/C_Table/composables/useCellEdit.d.ts
 /**
  * 单元格编辑配置选项
@@ -974,6 +1243,8 @@ interface CellEditOptions {
   data: () => DataRecord[];
   rowKey: (row: DataRecord) => DataTableRowKey$1;
   onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string) => void | Promise<void>;
+  /** 列配置（用于提取校验规则） */
+  columns?: () => TableColumn[];
 }
 /**
  * 可编辑单元格组合函数，提供表格单元格的编辑功能
@@ -999,6 +1270,8 @@ declare function useCellEdit(options: CellEditOptions): {
     columnKey: string;
   } | undefined>;
   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;
@@ -1031,5 +1304,5 @@ declare function useModalEdit<T = Record<string, any>>(options: ModalEditOptions
   getEditingRowData: (rowKey: DataTableRowKey$1) => Record<string, any> | null;
 };
 //#endregion
-export { SimpleTableActions as A, ChildSelectionState as C, PaginationConfig as D, MaybeRefLike as E, TableEmits as M, UseTableExpandOptions as N, ParentChildLinkMode as O, UseTableExpandReturn as P, usePrintWatermark as S, EditMode as T, DynamicRowsOptions as _, useTableActions as a, PrintWatermarkOptions as b, useTableColumns as c, CrudBinding as d, SummaryConfig as f, resolveConfig as g, createEditModeChecker as h, usePagination as i, TableColumn as j, SelectOption as k, _default as l, VirtualScrollConfig as m, useCellEdit as n, useTableExpand as o, TableConfig as p, useRowEdit as r, useTableManager as s, useModalEdit as t, ColumnDragConfig as u, DynamicRowsReturn as v, DataRecord as w, printPresets as x, useDynamicRows as y };
+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