@robot-admin/naive-ui-components 0.10.3 → 0.11.1

package/dist/useTableQuery.d.ts

@@ -0,0 +1,1684 @@
+import { i as ComponentLocale, r as ComponentFeedback } from "./config.js";
+import * as vue from "vue";
+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 {
+  text: string;
+  textSize?: number;
+  textColor?: string;
+  font?: string;
+  opacity?: number;
+  rotate?: number;
+  position?: 'center' | 'repeat' | 'corner' | 'diagonal';
+  xGap?: number;
+  yGap?: number;
+}
+interface CaptureConfig {
+  scale?: number;
+  quality?: number;
+  format?: 'png' | 'jpeg' | 'webp';
+  backgroundColor?: string;
+  logging?: boolean;
+  allowTaint?: boolean;
+  useCORS?: boolean;
+}
+interface PrintConfig {
+  orientation?: 'portrait' | 'landscape';
+  paperSize?: 'A4' | 'A3' | 'Letter' | string;
+  margin?: string;
+  style?: string;
+  header?: string;
+  footer?: string;
+  showModal?: boolean;
+  modalMessage?: string;
+  onLoadingStart?: () => void;
+  onLoadingEnd?: () => void;
+  onPrintDialogClose?: () => void;
+}
+interface PrintWatermarkOptions {
+  watermark?: WatermarkConfig;
+  capture?: CaptureConfig;
+  print?: PrintConfig;
+}
+/**
+ *
+ */
+declare function drawWatermark(canvas: HTMLCanvasElement, config: WatermarkConfig): HTMLCanvasElement;
+/**
+ *
+ */
+declare function captureElement(element: HTMLElement, config?: CaptureConfig): Promise<HTMLCanvasElement>;
+/**
+ *
+ */
+declare function canvasToDataURL(canvas: HTMLCanvasElement, format?: 'png' | 'jpeg' | 'webp', quality?: number): string;
+/**
+ *
+ */
+declare function downloadCanvas(canvas: HTMLCanvasElement, filename?: string, format?: 'png' | 'jpeg' | 'webp'): void;
+/**
+ *
+ */
+declare function printImage(imageDataURL: string, config?: PrintConfig): Promise<void>;
+/**
+ *
+ */
+declare function usePrintWatermark(): {
+  loading: vue.Ref<boolean, boolean>;
+  progress: vue.Ref<number, number>;
+  captureWithWatermark: (element: HTMLElement, options?: PrintWatermarkOptions) => Promise<string>;
+  printWithWatermark: (element: HTMLElement, options?: PrintWatermarkOptions) => Promise<void>;
+  downloadScreenshot: (element: HTMLElement, filename?: string, options?: PrintWatermarkOptions) => Promise<void>;
+  quickPrint: (element: HTMLElement, watermarkText?: string) => Promise<void>;
+  batchCapture: (elements: HTMLElement[], options?: PrintWatermarkOptions) => Promise<string[]>;
+  batchPrint: (elements: HTMLElement[], options?: PrintWatermarkOptions) => Promise<void>;
+  mergePrint: (elements: HTMLElement[], options?: PrintWatermarkOptions, mergeOptions?: {
+    orientation?: "horizontal" | "vertical";
+    spacing?: number;
+    backgroundColor?: string;
+  }) => Promise<void>;
+  createPreset: (name: string, options: PrintWatermarkOptions) => {
+    use: (element: HTMLElement) => Promise<void>;
+    download: (element: HTMLElement, filename?: string) => Promise<void>;
+  };
+  updateProgress: (value: number) => void;
+  utils: {
+    captureElement: typeof captureElement;
+    drawWatermark: typeof drawWatermark;
+    canvasToDataURL: typeof canvasToDataURL;
+    downloadCanvas: typeof downloadCanvas;
+    printImage: typeof printImage;
+  };
+};
+declare const printPresets: {
+  readonly table: {
+    readonly watermark: {
+      readonly text: "Robot Admin - 数据表格";
+      readonly position: "repeat";
+      readonly textColor: "rgba(100, 100, 100, 0.25)";
+      readonly textSize: 14;
+      readonly xGap: 250;
+      readonly yGap: 120;
+    };
+    readonly capture: {
+      readonly scale: 1.2;
+    };
+    readonly print: {
+      readonly orientation: "landscape";
+      readonly style: "@page { margin: 8mm; } body { font-family: Arial, sans-serif; }";
+    };
+  };
+  readonly form: {
+    readonly watermark: {
+      readonly text: "Robot Admin - 表单数据";
+      readonly position: "diagonal";
+      readonly textColor: "rgba(150, 150, 150, 0.2)";
+      readonly textSize: 16;
+    };
+    readonly print: {
+      readonly orientation: "portrait";
+    };
+  };
+  readonly report: {
+    readonly watermark: {
+      readonly text: "Robot Admin - 机密报告";
+      readonly position: "center";
+      readonly textColor: "rgba(200, 50, 50, 0.15)";
+      readonly textSize: 24;
+    };
+    readonly capture: {
+      readonly quality: 0.95;
+      readonly format: "png";
+    };
+  };
+};
+//#endregion
+//#region src/components/C_Table/composables/useDynamicRow.d.ts
+interface DynamicRowsOptions<T extends object = DataRecord> {
+  /** 总开关；关闭时公开方法保持安全 no-op */
+  enabled?: boolean;
+  rowKey?: string | ((row: T) => DataTableRowKey);
+  defaultRowData?: () => T;
+  enableRadioSelection?: boolean;
+  enableAdd?: boolean;
+  enableInsert?: boolean;
+  enableDelete?: boolean;
+  enableCopy?: boolean;
+  enableMove?: boolean;
+  enablePrint?: boolean;
+  printOptions?: PrintWatermarkOptions;
+  printPreset?: 'table' | 'form' | 'report';
+  printWatermarkText?: string;
+  printTargetSelector?: string;
+  confirmDelete?: boolean;
+  deleteConfirmText?: string;
+  feedback?: ComponentFeedback;
+  locale?: ComponentLocale;
+  onRowChange?: (data: T[]) => 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 object = DataRecord> {
+  selectedRowKey: Ref<DataTableRowKey | null>;
+  selectedRowData: Ref<T | null>;
+  selectedRowIndex: Ref<number>;
+  canMoveUp: Ref<boolean>;
+  canMoveDown: Ref<boolean>;
+  deleteConfirmVisible: Ref<boolean>;
+  printLoading: Ref<boolean>;
+  printProgress: Ref<number>;
+  addRow: () => void;
+  insertRow: () => void;
+  deleteRow: () => void;
+  confirmDelete: () => void;
+  copyRow: () => void;
+  moveRowUp: () => void;
+  moveRowDown: () => 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: (target?: HTMLElement) => VNodeChild;
+  renderConfirmModal: () => VNodeChild;
+}
+/**
+ * 表格动态行操作功能组合
+ */
+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 {
+  enabled?: boolean;
+  /** 拖拽手柄 CSS 选择器（不传则整行可拖） */
+  handleSelector?: string;
+  /** 动画时长（ms） */
+  animationDuration?: number;
+  /** 拖拽时 ghost 样式类 */
+  ghostClass?: string;
+  /** 拖拽中样式类 */
+  chosenClass?: string;
+}
+interface UseRowDragOptions<T extends object = DataRecord> {
+  /** 数据源（只读即可） */
+  data: Ref<T[]> | ComputedRef<T[]>;
+  /** 获取行键 */
+  rowKey: (row: T) => DataTableRowKey;
+  /** 配置 */
+  config: MaybeRefOrGetter<RowDragConfig | undefined>;
+  /** 数据重排回调（由外部处理数据更新） */
+  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 object = 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 object = DataRecord> {
+  /** 全量数据（非分页后的） */
+  allData: Ref<T[]> | ComputedRef<T[]>;
+  /** 行键函数 */
+  rowKey: (row: T) => DataTableRowKey;
+  /** 配置 */
+  config: MaybeRefOrGetter<CrossPageSelectionConfig | undefined>;
+}
+interface UseCrossPageSelectionReturn<T extends object = DataRecord> {
+  /** 所有选中的 key（跨页） */
+  selectedKeys: Ref<Set<DataTableRowKey>>;
+  /** 选中行数量 */
+  selectedCount: ComputedRef<number>;
+  /** 当前页数据的 checkedKeys（给 NDataTable 绑定） */
+  getPageCheckedKeys: (pageData: T[]) => DataTableRowKey[];
+  /** NDataTable @update:checked-row-keys 处理器 */
+  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) => boolean;
+}
+/** 跨页多选组合式函数 */
+declare function useCrossPageSelection<T extends object = 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;
+  /** 阻止表格软件把用户文本识别为公式，默认开启 */
+  preventFormulaInjection?: boolean;
+  /** 全局格式化配置（用于 formatter） */
+  formatterConfig?: FormatterConfig;
+  /** 请求格式不可用并自动降级时的通知。 */
+  onFallback?: (requested: 'xlsx', actual: 'csv', cause: unknown) => void;
+}
+/**
+ * 导出表格数据
+ */
+declare function exportTableData(data: DataRecord[], columns: TableColumn[], config?: ExportConfig): Promise<void>;
+//#endregion
+//#region src/components/C_Table/composables/useTableConfig.d.ts
+/**
+ * 可绑定到 C_Table 的 CRUD 对象接口（桥接类型）
+ *
+ * C_Table 内部已将 data/columns 规范化为 DataRecord/TableColumn，
+ * 此接口对 columns/actions 使用 any[] 避免 TableColumn<any> 结构展开异常，
+ * 同时允许 useTableCrud<T>() 任意子类型直接传入而无需类型断言。
+ */
+interface CrudBinding<T extends object = DataRecord> {
+  data: Ref<T[]>;
+  loading: Ref<boolean>;
+  columns: ComputedRef<TableColumn<T>[]>;
+  actions?: ComputedRef<SimpleTableActions<T>>;
+  pagination?: ComputedRef<PaginationConfig | boolean | undefined>;
+  tableRef?: Ref<any>;
+  save?: (...args: any[]) => any;
+  handleCancel?: () => void;
+  handlePaginationChange?: (page: number, pageSize: number) => void;
+  handleRowDelete?: (...args: any[]) => any;
+  detail?: {
+    show: (...args: any[]) => void;
+  };
+}
+/** C_Table :config prop 的类型 — 所有功能配置收拢在此 */
+interface TableConfig<T extends object = DataRecord> {
+  /** 组件级反馈适配器；未提供时尝试复用 Naive Provider，再安全降级 */
+  feedback?: ComponentFeedback;
+  /** 组件级文案与语言覆盖 */
+  locale?: ComponentLocale;
+  /** 校验缺失/重复行键；默认开启，超大或无状态表格可关闭。 */
+  validateRowKeys?: boolean;
+  /** 编辑配置 */
+  edit?: EditConfig<T> | boolean;
+  /** 操作按钮 */
+  actions?: SimpleTableActions<T>;
+  /** 分页配置 */
+  pagination?: PaginationConfig | boolean;
+  /** 展开行配置 */
+  expand?: ExpandConfig$1<T> | boolean;
+  /** 选择配置 */
+  selection?: SelectionConfig$1<T> | boolean;
+  /** 动态行配置 */
+  dynamicRows?: DynamicRowsOptions<T> | boolean;
+  /** 工具栏 */
+  toolbar?: ToolbarConfig;
+  /** 表格显示属性 */
+  display?: DisplayConfig;
+  /** 虚拟滚动配置（大数据量） */
+  virtualScroll?: VirtualScrollConfig | boolean;
+  /** 合计行配置（财务场景） */
+  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<T>;
+}
+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 object = DataRecord> {
+  enabled?: boolean;
+  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 object = DataRecord> {
+  enabled?: boolean;
+  defaultCheckedKeys?: DataTableRowKey[];
+  rowCheckable?: (row: T) => boolean;
+  maxSelection?: number;
+  childSelection?: {
+    enabled?: boolean;
+    childRowCheckable?: (childRow: unknown, parentRow: T) => boolean;
+  };
+  parentChildLink?: {
+    enabled?: boolean;
+    mode?: ParentChildLinkMode;
+  };
+}
+interface ToolbarConfig {
+  /** 是否显示工具栏 */
+  show?: boolean;
+  /** 是否启用列设置 */
+  columnSettings?: boolean;
+}
+interface DisplayConfig {
+  striped?: boolean;
+  bordered?: boolean;
+  singleLine?: boolean;
+  size?: 'small' | 'medium' | 'large';
+  maxHeight?: number | string;
+  scrollX?: number | string;
+  columnWidth?: number;
+}
+/** 虚拟滚动配置 */
+interface VirtualScrollConfig {
+  enabled?: boolean;
+  /** 每行高度（px） */
+  itemHeight?: number;
+  /** 最大高度（px），用于滚动容器 */
+  maxHeight?: number;
+}
+/** 合计行配置 */
+interface SummaryConfig<T extends object = DataRecord> {
+  /** 合计行位置 */
+  position?: 'top' | 'bottom';
+  /** 自定义合计函数，每列返回 { value, colSpan? } */
+  render?: (data: T[]) => Record<string, {
+    value: string | number;
+    colSpan?: number;
+  }>;
+}
+/** 列拖拽排序配置 */
+interface ColumnDragConfig {
+  enabled?: boolean;
+  /** 拖拽手柄类名（默认拖拽头部区域） */
+  handleClass?: string;
+  /** 拖拽动画时长（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<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[], 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[] | 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[] | undefined;
+  rowCheckable: ((row: DataRecord) => boolean) | undefined;
+  maxSelection: number | undefined;
+  enableChildSelection: boolean;
+  childRowCheckable: ((childRow: unknown, parentRow: DataRecord) => boolean) | undefined;
+  enableParentChildLink: boolean;
+  parentChildLinkMode: ParentChildLinkMode;
+  pagination: PaginationConfig | null;
+  dynamicRows: DynamicRowsOptions<DataRecord> | undefined;
+  striped: boolean;
+  bordered: boolean;
+  singleLine: boolean;
+  size: 'small' | 'medium' | 'large';
+  maxHeight: number | string | undefined;
+  scrollX: number | string | undefined;
+  columnWidth: number;
+  showToolbar: boolean;
+  enableColumnSettings: boolean;
+  /** 虚拟滚动 */
+  virtualScroll: boolean;
+  virtualItemHeight: number;
+  virtualMaxHeight: number;
+  /** 合计行 */
+  summaryPosition: 'top' | 'bottom' | undefined;
+  summaryRender: ((data: DataRecord[]) => Record<string, {
+    value: string | number;
+    colSpan?: number;
+  }>) | undefined;
+  /** 列拖拽 */
+  enableColumnDrag: boolean;
+  columnDragHandleClass: string | undefined;
+  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 单一对象解析为内部扁平化配置
+ */
+declare function resolveConfig(config?: TableConfig): ResolvedConfig;
+declare const createEditModeChecker: (config: ResolvedConfig) => {
+  isNonEditable: (column: TableColumn) => boolean;
+  isRowEditMode: () => boolean;
+  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 {
+  /** 任意 C_Table 配置的应用级默认值。 */
+  defaults?: TableConfig;
+  /** 表格显示默认值 */
+  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 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';
+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 object = DataRecord> = (row: T, index: number) => unknown | Promise<unknown>;
+/** 渲染函数类型 */
+type RenderFunction<T extends object = DataRecord> = (row: T, index: number) => VNodeChild;
+/** 自定义操作按钮配置 */
+interface CustomAction<T extends object = 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 object = DataRecord> {
+  /** 编辑操作 - 直接传入函数 */
+  edit?: false | ApiFunction<T>;
+  /** 删除操作 - 直接传入函数 */
+  delete?: false | ApiFunction<T>;
+  /** 详情操作 - 直接传入函数 */
+  detail?: false | ApiFunction<T>;
+  /** 自定义操作按钮 */
+  custom?: CustomAction<T>[];
+  /** 完全自定义渲染 - 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 object = DataRecord> {
+  /** 操作配置 */
+  actions: Ref<SimpleTableActions<T>> | ComputedRef<SimpleTableActions<T>>;
+  /** 表格配置 */
+  config: Ref<{
+    editable: boolean;
+    editMode: string;
+    feedback?: ComponentFeedback;
+    locale?: ComponentLocale;
+  }> | ComputedRef<{
+    editable: boolean;
+    editMode: string;
+    feedback?: ComponentFeedback;
+    locale?: ComponentLocale;
+  }>;
+  /** 表格管理器 */
+  tableManager: TableActionsManager<T>;
+  /** 行键获取函数 */
+  rowKey: (row: T) => DataTableRowKey;
+  /** 事件发射器 */
+  /** 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 object = 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 object = 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 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: unknown, 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 object = DataRecord> extends BaseTableColumn<T> {
+  key: Extract<keyof T, DataTableRowKey> | DataTableRowKey;
+  title: string;
+}
+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 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 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 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: C, parentRow: T) => boolean;
+  enableParentChildLink?: boolean;
+  parentChildLinkMode?: ParentChildLinkMode;
+}
+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 object = DataRecord, C = DataRecord> {
+  'selection-change': [checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]>];
+  'child-selection-change': [parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: C[]];
+  'parent-child-link-change': [parentKey: DataTableRowKey, shouldSelect: boolean];
+}
+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 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 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;
+  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 object = DataRecord, C = DataRecord> {
+  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>[]) => 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 等属性。
+ * 各 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
+declare const __VLS_export: <T extends object = DataRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+  props: vue.PublicProps & __VLS_PrettifyLocal<{
+    /** 列配置（crud 模式下可省略） */columns?: TableColumn<T>[]; /** 数据源（crud 模式下可省略） */
+    data?: MaybeRefLike<T[]>; /** 加载状态 */
+    loading?: MaybeRefLike<boolean>; /** 行唯一键 */
+    rowKey?: string | ((row: T) => DataTableRowKey); /** 统一功能配置（edit / selection / expand / pagination / dynamicRows / toolbar / display） */
+    config?: TableConfig<T>; /** CRUD 绑定 — 传入 useTableCrud() 的返回值，自动接管 data/columns/loading/actions/pagination/events */
+    crud?: CrudBinding<T>;
+  } & {
+    [x: `on${Capitalize<string>}`]: ((...args: any) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: vue.ShallowUnwrapRef<{
+    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 | null | undefined;
+    isEditing: (rowKey: DataTableRowKey, columnKey?: string) => boolean;
+    isExpanded: (rowKey: DataTableRowKey) => boolean;
+    getManager: () => {
+      edit: {
+        start(rowKey: DataTableRowKey, columnKey?: string): void;
+        cancel(): void;
+        save(): Promise<void>;
+        isEditing(rowKey: DataTableRowKey, columnKey?: string): boolean;
+        getEditingData(): DataRecord | null | undefined;
+      };
+      expand: {
+        row(rowKey: DataTableRowKey): Promise<void>;
+        collapse(rowKey: DataTableRowKey): void;
+        toggle(rowKey: DataTableRowKey): Promise<void>;
+        all(): Promise<void>;
+        collapseAll(): void;
+        isExpanded(rowKey: DataTableRowKey): boolean;
+      };
+      selection: {
+        select(rowKey: DataTableRowKey): void;
+        unselect(rowKey: DataTableRowKey): void;
+        all(): void;
+        clear(): void;
+        isSelected(rowKey: DataTableRowKey): boolean;
+        getSelected(): DataRecord[];
+      };
+      childSelection: {
+        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;
+        insert(): void;
+        delete(): void;
+        copy(): void;
+        moveUp(): void;
+        moveDown(): void;
+        clearSelection(): void;
+        getSelected(): DataRecord | null;
+        print(elementRef?: HTMLElement): Promise<void>;
+        download(elementRef?: HTMLElement, filename?: string): Promise<void>;
+      };
+      clearAllSelections(): void;
+    }; /** 导出数据 */
+    exportData: () => Promise<void>; /** 跨页选择 */
+    crossPageSelection: {
+      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[];
+    };
+  }>) => void;
+  attrs: any;
+  slots: {
+    'toolbar-left'?: (props: {}) => any;
+  } & {
+    'toolbar-right'?: (props: {}) => any;
+  } & {
+    error?: (props: {
+      error: ErrorConfig;
+    }) => any;
+  };
+  emit: ((evt: "cancel", rowData: DataRecord, rowIndex: number) => void) & ((evt: "save", rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "pagination-change", ...args: [page: number, pageSize: number] & [page: number, pageSize: number]) => void) & ((evt: "row-delete", ...args: [deletedRow: DataRecord, index: number] & [deletedRow: DataRecord, index: number]) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<DataRecord>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: DataRecord | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: DataRecord[]) => void) & ((evt: "edit-error", error: unknown) => void) & ((evt: "row-add", newRow: DataRecord) => void) & ((evt: "row-copy", originalRow: DataRecord, newRow: DataRecord) => void) & ((evt: "row-move", row: DataRecord, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => void) & ((evt: "view-detail", data: DataRecord) => void) & ((evt: "column-change", columns: TableColumn[]) => void);
+}>) => vue.VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default: typeof __VLS_export;
+type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
+//#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, 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, columnKey: string) => void;
+    };
+    rowEdit: {
+      isEditingRow: (rowKey: DataTableRowKey) => boolean;
+      getEditingRowData: (rowKey: DataTableRowKey) => DataRecord | undefined;
+      updateEditingRowData: (rowKey: DataTableRowKey, field: string, value: unknown) => void;
+    };
+  };
+  dynamicRowsState?: {
+    enhanceColumns: (columns: TableColumn[]) => TableColumn[];
+  } | null;
+  expandState?: {
+    getTableColumns: (originalColumns: TableColumn[]) => DataTableColumn[];
+  } | null;
+}
+/**
+ * 渲染编辑组件（行编辑/单元格编辑通用）
+ */
+interface UseTableColumnsOptions {
+  /** 原始列配置 */
+  rawColumns: ComputedRef<TableColumn[]>;
+  /** 统一配置 */
+  config: ComputedRef<ResolvedConfig>;
+  /** 默认列宽 */
+  columnWidth: number;
+  /** 用户设定的 scrollX */
+  scrollX?: number | string;
+  /** 行键获取函数 */
+  rowKey: (row: DataRecord) => DataTableRowKey;
+  /** 表格管理器 */
+  tableManager: TableManagerRef;
+  /** 操作列渲染函数 */
+  actionsRenderer: (row: DataRecord, index: number) => VNodeChild;
+  /** 编辑模式检查器 */
+  editModeChecker: ComputedRef<{
+    isNonEditable: (column: TableColumn) => boolean;
+    isRowEditMode: () => boolean;
+    isCellEditMode: () => boolean;
+  }>;
+  /** 是否渲染操作列 */
+  showActionsColumn: ComputedRef<boolean>;
+}
+interface UseTableColumnsReturn {
+  reactiveColumns: Ref<TableColumn[]>;
+  showSettingsPanel: Ref<boolean>;
+  computedColumns: ComputedRef<DataTableColumn[]>;
+  computedScrollX: ComputedRef<number | string | undefined>;
+  handleColumnChange: (columns: TableColumn[]) => void;
+}
+/**
+ * 表格列处理引擎
+ */
+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;
+  onSave?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
+  onCancel?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
+  /** 列配置（用于提取校验规则） */
+  columns?: () => TableColumn[];
+}
+/**
+ * 可编辑行组合函数，提供表格整行的编辑功能
+ */
+declare function useRowEdit(options: RowEditOptions): {
+  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;
+    rowIndex: number;
+  } | undefined>;
+  validateRow: () => Promise<boolean>;
+  validationErrors: vue.Ref<{
+    field: string;
+    message: string;
+  }[], RowValidationError[] | {
+    field: string;
+    message: string;
+  }[]>;
+  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
+/**
+ * 表格管理器配置接口
+ */
+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[];
+  onLoadExpandData?: (row: DataRecord) => Promise<any[]> | any[];
+  onExpandError?: (error: unknown, row: DataRecord) => void;
+  renderExpandContent?: unknown;
+  rowExpandable?: (row: DataRecord) => boolean;
+  enableSelection: boolean;
+  defaultCheckedKeys?: DataTableRowKey[];
+  rowCheckable?: (row: DataRecord) => boolean;
+  maxSelection?: number;
+  enableChildSelection: boolean;
+  childRowCheckable?: (childRow: DataRecord, parentRow: DataRecord) => boolean;
+  enableParentChildLink: boolean;
+  parentChildLinkMode: ParentChildLinkMode;
+  dynamicRows?: DynamicRowsOptions<DataRecord>;
+}
+/**
+ * 表格管理器参数接口
+ */
+interface TableManagerParams {
+  config: MaybeRefOrGetter<TableManagerConfig>;
+  data: () => DataRecord[];
+  rowKey: (row: DataRecord) => DataTableRowKey;
+  emit: (...args: any[]) => unknown;
+  /** 列配置（用于编辑校验） */
+  columns?: () => TableColumn[];
+}
+/**
+ * 事件处理器接口
+ */
+interface EventHandlers {
+  onSave: (rowData: DataRecord, rowIndex: number, columnKey?: string) => Promise<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 | null, selectedRow: DataRecord | null) => void;
+  onRowAdd: (newRow: DataRecord) => void;
+  onRowDelete: (deletedRow: DataRecord, index: number) => void;
+  onRowCopy: (originalRow: DataRecord, newRow: DataRecord) => void;
+  onRowMove: (row: DataRecord, fromIndex: number, toIndex: number) => void;
+}
+/**
+ * 表格统一状态管理器
+ */
+declare function useTableManager(params: TableManagerParams): {
+  editStates: {
+    rowEdit: {
+      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;
+        rowIndex: number;
+      } | undefined>;
+      validateRow: () => Promise<boolean>;
+      validationErrors: vue.Ref<{
+        field: string;
+        message: string;
+      }[], RowValidationError[] | {
+        field: string;
+        message: string;
+      }[]>;
+      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 | null;
+        columnKey: string | null;
+      }, {
+        rowKey: DataTableRowKey | null;
+        columnKey: string | null;
+      } | {
+        rowKey: DataTableRowKey | null;
+        columnKey: string | null;
+      }>;
+      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;
+        };
+        rowIndex: number;
+        columnKey: string;
+      } | undefined>;
+      cancelEditCell: () => void;
+      validateCell: () => Promise<boolean>;
+      cellValidationError: vue.Ref<string | null, string | null>;
+      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>;
+      isSaving: vue.Ref<boolean, boolean>;
+      editingData: vue.Ref<DataRecord, DataRecord>;
+      editingRowKey: vue.Ref<DataTableRowKey | null, DataTableRowKey | null>;
+      editingRowIndex: vue.ComputedRef<number>;
+      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>;
+  dynamicRowsState: DynamicRowsReturn<DataRecord>;
+  stateManager: {
+    edit: {
+      /** 开始编辑 */start(rowKey: DataTableRowKey, columnKey?: string): void; /** 取消编辑 */
+      cancel(): void; /** 保存编辑 */
+      save(): Promise<void>; /** 是否正在编辑 */
+      isEditing(rowKey: DataTableRowKey, columnKey?: string): boolean; /** 获取当前编辑数据 */
+      getEditingData(): DataRecord | null | undefined;
+    };
+    expand: {
+      /** 展开行 */row(rowKey: DataTableRowKey): Promise<void>; /** 折叠行 */
+      collapse(rowKey: DataTableRowKey): void; /** 展开折叠切换 */
+      toggle(rowKey: DataTableRowKey): Promise<void>; /** 展开所有行 */
+      all(): Promise<void>; /** 折叠所有行 */
+      collapseAll(): void; /** 检查行是否已展开 */
+      isExpanded(rowKey: DataTableRowKey): boolean;
+    };
+    selection: {
+      /** 选择指定行 */select(rowKey: DataTableRowKey): void; /** 取消选择指定行 */
+      unselect(rowKey: DataTableRowKey): void; /** 选择所有行 */
+      all(): void; /** 清除所有行选择 */
+      clear(): void; /** 检查行是否已选择 */
+      isSelected(rowKey: DataTableRowKey): boolean; /** 获取所有已选择的行数据 */
+      getSelected(): DataRecord[];
+    };
+    childSelection: {
+      /** 选择指定父行下的子行 */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; /** 插入行 */
+      insert(): void; /** 删除行 */
+      delete(): void; /** 复制行 */
+      copy(): void; /** 上移动态行 */
+      moveUp(): void; /** 下移动态行 */
+      moveDown(): void; /** 清空动态行数据 */
+      clearSelection(): void; /** 获取当前选中的动态行数据 */
+      getSelected(): DataRecord | null; /** 打印表格 */
+      print(elementRef?: HTMLElement): Promise<void>; /** 导出表格数据 */
+      download(elementRef?: HTMLElement, filename?: string): Promise<void>;
+    }; /** 清除所有选择 */
+    clearAllSelections(): void;
+  };
+  expandedKeys: vue.ComputedRef<DataTableRowKey[]>;
+  checkedKeys: vue.ComputedRef<DataTableRowKey[]>;
+  eventHandlers: EventHandlers;
+};
+//#endregion
+//#region src/components/C_Table/composables/useTableExpand.d.ts
+/**
+ *
+ */
+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 object = DataRecord>(options: UseTableActionsOptions<T>): UseTableActionsReturn<T>;
+//#endregion
+//#region src/components/C_Table/composables/usePagination.d.ts
+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;
+}
+interface UsePaginationReturn<T extends object = DataRecord> {
+  currentPage: Ref<number>;
+  currentPageSize: Ref<number>;
+  paginatedData: ComputedRef<T[]>;
+  paginationConfig: ComputedRef<PaginationProps | null>;
+  handlePageChange: (page: number) => void;
+  handlePageSizeChange: (pageSize: number) => void;
+  resetToFirstPage: () => void;
+  getTotalPages: () => number;
+}
+/** 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
+/**
+ * 单元格编辑配置选项
+ */
+interface CellEditOptions {
+  data: () => DataRecord[];
+  rowKey: (row: DataRecord) => DataTableRowKey;
+  onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string) => void | Promise<void>;
+  /** 列配置（用于提取校验规则） */
+  columns?: () => TableColumn[];
+}
+/**
+ * 可编辑单元格组合函数，提供表格单元格的编辑功能
+ */
+declare function useCellEdit(options: CellEditOptions): {
+  editingCell: vue.Ref<{
+    rowKey: DataTableRowKey | null;
+    columnKey: string | null;
+  }, {
+    rowKey: DataTableRowKey | null;
+    columnKey: string | null;
+  } | {
+    rowKey: DataTableRowKey | null;
+    columnKey: string | null;
+  }>;
+  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;
+    };
+    rowIndex: number;
+    columnKey: string;
+  } | undefined>;
+  cancelEditCell: () => void;
+  validateCell: () => Promise<boolean>;
+  cellValidationError: vue.Ref<string | null, string | null>;
+  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 extends object = DataRecord> {
+  data: () => T[];
+  rowKey: (row: T) => DataTableRowKey;
+  onSave?: (editingData: T, rowIndex: number) => void | Promise<void>;
+  onCancel?: (originalData: T, rowIndex: number) => void | Promise<void>;
+}
+/** 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>;
+  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, 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 { 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 };