@robot-admin/naive-ui-components 0.22.0 → 0.23.0

package/dist/index11.vue.d.ts

@@ -1,58 +1,1130 @@
-import { D as FormConfig, X as FormOption, Z as FormRecord, ut as SubmitEventPayload } from "./useDynamicFormState.js";
+import { o as ActionItem, t as ActionBarConfig } from "./types.js";
+import { n as ComponentLocale, t as ComponentFeedback } from "./contracts.js";
+import { t as DictionaryBinding } from "./dictionary.js";
+import { t as ComponentDensity } from "./density.js";
 import * as vue from "vue";
-import { ComputedRef, Ref } from "vue";
+import { ComputedRef, InjectionKey, MaybeRef, MaybeRefOrGetter, Ref, VNodeChild } from "vue";
+import { DataTableBaseColumn, DataTableRowKey, FormItemRule, PaginationProps } from "naive-ui";
 
-//#region src/components/C_FormModal/types.d.ts
-type FormModalMode = 'create' | 'edit';
-/**
- * Structural editor contract. It intentionally does not depend on request-core,
- * so any headless CRUD implementation can drive the modal.
- */
-interface FormModalEditor<T extends object = FormRecord> {
-  visible: Ref<boolean>;
-  mode: Ref<FormModalMode>;
-  model: Ref<T | null>;
-  title: Ref<string>;
-  loading: Ref<boolean> | ComputedRef<boolean>;
-  setModel(model: T): void;
-  close(): void;
-  submit(model?: T): Promise<boolean>;
-}
-interface FormModalProps<T extends object = FormRecord> {
-  editor: FormModalEditor<T>;
-  options: FormOption<T>[];
-  config?: FormConfig<T>;
+//#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 DynamicRowsBaseOptions<T extends object> {
+  /** 总开关；关闭时公开方法保持安全 no-op */
+  enabled?: boolean;
+  rowKey?: string | ((row: T) => DataTableRowKey);
+  /** 新增返回完整业务行；复制时可接收原行副本，函数 rowKey 需返回完整的新副本。 */
+  defaultRowData?: (source?: T) => 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;
+}
+/** 明确业务模型必须由工厂创建完整记录；开放记录保留原有空行兼容入口。 */
+type DynamicRowsOptions<T extends object = DataRecord> = DynamicRowsBaseOptions<T> & (string extends keyof T ? unknown : {
+  defaultRowData: (source?: T) => T;
+});
+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[]>>, ...args: string extends keyof T ? [options?: MaybeRefOrGetter<DynamicRowsOptions<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;
+  /** Maximum selected rows, including previously visited remote pages. */
+  maxSelection?: number;
+}
+interface UseCrossPageSelectionOptions<T extends object = DataRecord> {
+  /** All local rows, or the loaded page when remote is enabled. */
+  allData: Ref<T[]> | ComputedRef<T[]>;
+  rowKey: (row: T) => DataTableRowKey;
+  config: MaybeRefOrGetter<CrossPageSelectionConfig | undefined>;
+  remote?: MaybeRefOrGetter<boolean>;
+  childrenKey?: MaybeRefOrGetter<string | undefined>;
+  rowCheckable?: (row: T) => boolean;
+  onSelectionChange?: (keys: DataTableRowKey[], rows: T[]) => void;
+}
+interface UseCrossPageSelectionReturn<T extends object = DataRecord> {
+  selectedKeys: Ref<Set<DataTableRowKey>>;
+  selectedCount: ComputedRef<number>;
+  getPageCheckedKeys: (pageData: T[]) => DataTableRowKey[];
+  handlePageSelectionChange: (keys: DataTableRowKey[], pageData: T[]) => void;
+  /** In remote mode, adds the currently loaded page; never claims to select unseen server rows. */
+  selectAll: () => void;
+  select: (key: DataTableRowKey) => boolean;
+  unselect: (key: DataTableRowKey) => void;
+  clearAll: () => void;
+  getSelectedRows: () => T[];
+  isSelected: (key: DataTableRowKey) => boolean;
+}
+/** Preserve selected identities and loaded row snapshots across local or remote pages. */
+declare function useCrossPageSelection<T extends object = DataRecord>(options: UseCrossPageSelectionOptions<T>): UseCrossPageSelectionReturn<T>;
+//#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/composables/useTableExport.d.ts
+interface ExportConfig {
+  /** Data scope used by C_Table; source preserves the legacy loaded-source behavior. */
+  scope?: 'source' | 'page' | 'selected';
+  /** Explicit server-side/full-data export request; invoked only when exporting. */
+  requestData?: () => DataRecord[] | Promise<DataRecord[]>;
+  /** 导出文件名（不含扩展名） */
+  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 内部会将外部 columns 规范化为自己的 TableColumn。
+ * columns 刻意使用 unknown[] 作为跨包边界，避免要求 CRUD 数据源与组件库
+ * 共享同一份 TableColumn 声明；直接使用 columns prop 时仍保留完整的强类型校验。
+ */
+interface CrudBinding<T extends object = DataRecord> {
+  data: Ref<T[]>;
+  loading: Ref<boolean>;
+  columns: ComputedRef<readonly unknown[]>;
+  /** 提供 save 时 edit 函数只标记保存能力；自定义编辑入口放到 config.actions.edit。 */
+  actions?: ComputedRef<SimpleTableActions<T>>;
+  pagination?: ComputedRef<PaginationConfig | boolean | undefined>;
+  tableRef?: Ref<unknown>;
+  save?: (row: T, rowIndex?: number, columnKey?: string) => unknown | Promise<unknown>;
+  handleCancel?: () => void;
+  handlePaginationChange?: (page: number, pageSize: number) => void;
+  handleRowDelete?: (row: T, index?: number) => unknown | Promise<unknown>;
+  detail?: {
+    show: (row: T) => unknown;
+  };
+}
+/** C_Table :config prop 的类型 — 所有功能配置收拢在此 */
+interface TableConfig<T extends object = DataRecord, C = unknown> {
+  /** 与 C_Form / C_FormSearch 共用密度；局部 display.size 等显式配置优先。 */
+  density?: ComponentDensity;
+  /** 组件级反馈适配器；未提供时尝试复用 Naive Provider，再安全降级 */
+  feedback?: ComponentFeedback;
+  /** 组件级文案与语言覆盖 */
+  locale?: ComponentLocale;
+  /** 校验缺失/重复行键；默认开启，超大或无状态表格可关闭。 */
+  validateRowKeys?: boolean;
+  /** 编辑配置 */
+  edit?: EditConfig<T> | EditMode | boolean;
+  /** 操作按钮 */
+  actions?: SimpleTableActions<T>;
+  /** 分页配置 */
+  pagination?: PaginationConfig | boolean;
+  /** 展开行配置 */
+  expand?: ExpandConfig$1<T, C> | boolean;
+  /** 选择配置 */
+  selection?: SelectionConfig$1<T, C> | boolean;
+  /** 动态行配置 */
+  dynamicRows?: DynamicRowsOptions<T> | (string extends keyof T ? boolean : false);
+  /** 工具栏 */
+  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?: EditMode;
+  showRowActions?: boolean;
+  modalTitle?: string;
+  modalWidth?: number;
+  /** 保存前回调；抛出异常会保留编辑态，便于修正或重试 */
+  onSave?: (rowData: T, rowIndex: number, columnKey?: string) => unknown;
+  /** 取消编辑回调 */
+  onCancel?: (rowData: T, rowIndex: number) => unknown;
+  /** 编辑或保存失败回调 */
+  onError?: (error: unknown) => void;
+}
+interface ExpandConfig$1<T extends object = DataRecord, C = unknown> {
+  enabled?: boolean;
+  defaultExpandedKeys?: DataTableRowKey[];
+  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$1<T extends object = DataRecord, C = unknown> {
+  enabled?: boolean;
+  defaultCheckedKeys?: DataTableRowKey[];
+  rowCheckable?: (row: T) => boolean;
+  maxSelection?: number;
+  childSelection?: {
+    enabled?: boolean;
+    childRowCheckable?: (childRow: C, parentRow: T) => boolean;
+  };
+  parentChildLink?: {
+    enabled?: boolean;
+    mode?: ParentChildLinkMode;
+  };
+}
+interface ToolbarConfig {
+  /** 是否显示工具栏 */
+  show?: boolean;
+  /** 是否启用列设置 */
+  columnSettings?: boolean;
+  /** 左侧业务动作，统一交给 C_ActionBar 渲染。 */
+  actions?: ActionItem[];
+  /** 右侧业务动作，适合左侧存在标签页或查询条件的场景。 */
+  rightActions?: ActionItem[];
+  /** 透传给 C_ActionBar 的布局与尺寸配置。 */
+  actionBar?: ActionBarConfig;
+}
+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?: () => unknown;
+}
+/** 批量操作配置 */
+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[]) => unknown;
+  }>;
+}
+interface ResolvedConfig {
+  density: ComponentDensity | undefined;
+  controlSize: 'small' | 'medium' | 'large';
+  feedback: ComponentFeedback | undefined;
+  locale: ComponentLocale | undefined;
+  editable: boolean;
+  editMode: EditMode;
+  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?: ChildSelectionState) => 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;
+  toolbarActions: ActionItem[];
+  toolbarRightActions: ActionItem[];
+  toolbarActionBarConfig: ActionBarConfig;
+  /** 虚拟滚动 */
+  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/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) => unknown;
+  /** 条件显示函数（可选） */
+  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;
+    controlSize?: 'small' | 'medium' | 'large';
+    feedback?: ComponentFeedback;
+    locale?: ComponentLocale;
+  }> | ComputedRef<{
+    editable: boolean;
+    editMode: string;
+    controlSize?: 'small' | 'medium' | 'large';
+    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;
+  /** A bound CRUD action may already report success or failure to the user. */
+  isDeleteFeedbackHandled?: (action: ApiFunction<T>) => boolean;
+  /** 查看详情回调 */
+  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<DataTableBaseColumn<T>, '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, context: {
+    onUpdate: (value: unknown) => void;
+  }) => VNodeChild;
+  render?: (rowData: T, rowIndex: number) => VNodeChild;
+  /** 声明式格式化器（优先级低于 render） */
+  formatter?: ColumnFormatter;
+  /** 字典显示低于 render/formatter；编辑时显式 editProps.options 优先。 */
+  dictionary?: DictionaryBinding;
+  fixed?: 'left' | 'right';
+  resizable?: boolean;
+  minWidth?: number;
+  maxWidth?: number;
+}
+interface NormalTableColumn<T extends object = DataRecord> extends BaseTableColumn<T> {
+  type?: never;
+  key: Extract<keyof T, DataTableRowKey> | DataTableRowKey;
+  title: string;
+}
+interface BuiltInTableColumn<T extends object = DataRecord> extends BaseTableColumn<T> {
+  /** 内置列类型：无需 key / title */
+  type: 'selection' | 'expand' | 'index';
+  /** 原生选择列禁用判定；与 config.selection.rowCheckable 一起生效。 */
+  disabled?: (row: T) => boolean;
+  /** 原生选择列是否多选；maxSelection=1 时仍使用单选。 */
+  multiple?: boolean;
+  /** 原生展开列判定；与 config.expand.rowExpandable 一起生效。 */
+  expandable?: (row: T) => boolean;
+  /** 展开行渲染函数（仅当 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 TableDisplayProps {
+  maxHeight?: number | string;
+  minHeight?: number | string;
+  scrollX?: number | string;
+  striped?: boolean;
+  bordered?: boolean;
+  singleLine?: boolean;
+  size?: 'small' | 'medium' | 'large';
+}
+/** 组件声明的实际属性；与 UI 壳共用，避免旧配置重新混入主契约。 */
+interface TableRuntimeProps<T extends object = DataRecord, C = unknown> {
+  /** CRUD 模式自动提供列和数据，可省略。 */
+  columns?: TableColumn<T>[];
+  data?: MaybeRefLike<T[]>;
+  loading?: MaybeRefLike<boolean>;
+  rowKey?: TableRowKey<T>;
+  /** 功能配置的统一入口。 */
+  config?: TableConfig<T, C>;
+  /** CRUD 模式自动提供 columns / data / loading，可省略对应属性。 */
+  crud?: CrudBinding<T>;
+  /** 原生分页入口；声明后优先于 config.pagination。 */
+  pagination?: PaginationProps | false;
+  remote?: boolean;
+  virtualScrollX?: boolean;
+  /** 根容器 class，原生 class/style 仍转发到内部表格。 */
+  wrapperClass?: vue.HTMLAttributes['class'];
+  /** 填满确定高度的容器，保留工具栏和分页空间。 */
+  flexHeight?: boolean;
+}
+/** 事件监听与组件共用同一份事件参数，避免将有效监听器误当作旧功能配置。 */
+type TableListeners<T extends object, C> = { [E in keyof TableEmits<T, C> as `on${Capitalize<E>}`]?: (...args: TableEmits<T, C>[E]) => unknown };
+/** 业务功能统一使用 config；有效的原生显示属性继续由 $attrs 透传。 */
+type TableProps<T extends object = DataRecord, C = unknown> = TableRuntimeProps<T, C> & Omit<TableDisplayProps, 'maxHeight' | 'scrollX'> & TableListeners<T, C>;
+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>[]];
+  'row-add': [newRow: T];
+  'row-copy': [originalRow: T, newRow: T];
+  'row-move': [row: T, fromIndex: number, toIndex: number];
+  'row-selection-change': [selectedKey: DataTableRowKey | null, selectedRow: T | null];
+  'view-detail': [data: T];
+  'column-change': [columns: TableColumn<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;
+  retryExpand: (rowKey: DataTableRowKey) => Promise<void>;
+  invalidateExpand: (rowKey?: DataTableRowKey) => void;
+}
+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 TableManagerApi<T extends object = DataRecord, C = DataRecord> {
+  edit: {
+    start: TableEditMethods<T>['startEdit'];
+    cancel: TableEditMethods<T>['cancelEdit'];
+    save: TableEditMethods<T>['saveEdit'];
+    isEditing: TableEditMethods<T>['isEditing'];
+    getEditingData: () => T | null | undefined;
+  };
+  expand: {
+    row: TableExpandMethods['expandRow'];
+    collapse: TableExpandMethods['collapseRow'];
+    toggle: TableExpandMethods['toggleExpand'];
+    all: TableExpandMethods['expandAll'];
+    collapseAll: TableExpandMethods['collapseAll'];
+    isExpanded: TableExpandMethods['isExpanded'];
+  };
+  selection: {
+    select: TableSelectionMethods<T, C>['selectRow'];
+    unselect: TableSelectionMethods<T, C>['unselectRow'];
+    all: TableSelectionMethods<T, C>['selectAll'];
+    clear: TableSelectionMethods<T, C>['clearSelection'];
+    isSelected: TableSelectionMethods<T, C>['isRowSelected'];
+    getSelected: TableSelectionMethods<T, C>['getSelectedRows'];
+  };
+  childSelection: {
+    select: TableSelectionMethods<T, C>['selectChildRow'];
+    unselect: TableSelectionMethods<T, C>['unselectChildRow'];
+    selectAll: TableSelectionMethods<T, C>['selectAllChildren'];
+    clear: TableSelectionMethods<T, C>['clearChildrenSelection'];
+    getSelected: TableSelectionMethods<T, C>['getChildSelectedRows'];
+  };
+  dynamicRows: {
+    add: TableDynamicRowsMethods<T>['addRow'];
+    insert: TableDynamicRowsMethods<T>['insertRow'];
+    delete: TableDynamicRowsMethods<T>['deleteRow'];
+    copy: TableDynamicRowsMethods<T>['copyRow'];
+    moveUp: TableDynamicRowsMethods<T>['moveRowUp'];
+    moveDown: TableDynamicRowsMethods<T>['moveRowDown'];
+    clearSelection: TableDynamicRowsMethods<T>['clearRowSelection'];
+    getSelected: TableDynamicRowsMethods<T>['getSelectedRowData'];
+    print: TableDynamicRowsMethods<T>['printTable'];
+    download: TableDynamicRowsMethods<T>['downloadTableScreenshot'];
+  };
+  clearAllSelections: TableSelectionMethods<T, C>['clearAllSelections'];
+}
+interface TableInstance<T extends object = DataRecord, C = DataRecord> extends TableEditMethods<T>, TableExpandMethods, TableSelectionMethods<T, C>, TableDynamicRowsMethods<T>, TablePaginationMethods {
+  exportData: () => Promise<void>;
+  /** 高级兼容入口；常规操作优先使用实例上的选择、展开和编辑方法。 */
+  getManager: () => TableManagerApi<T, C>;
+  /** 此嵌套对象中的 Ref 保持响应式，读取时使用 .value。 */
+  crossPageSelection: Pick<UseCrossPageSelectionReturn<T>, 'selectedKeys' | 'selectedCount' | 'select' | 'unselect' | 'selectAll' | 'clearAll' | 'getSelectedRows'> & {
+    enabled: ComputedRef<boolean>;
+  };
+}
+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;
+  /** Native tree children field; omitted for flat/detail-expansion tables. */
+  childrenKey?: string;
+  locale?: ComponentLocale;
+  /** 展开数据等待时的加载内容，C_Table 内置统一 SVG；独立引擎可按需提供。 */
+  renderLoading?: () => VNodeChild;
+  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>>;
+  errorMap: Ref<Map<DataTableRowKey, unknown>>;
+  retryExpand: (key: DataTableRowKey) => Promise<void>;
+  invalidateExpand: (key?: DataTableRowKey) => void;
+  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) => unknown;
+  tooltip?: string;
+}
+/**
+ * 展平 TableColumn 联合类型以便直接访问 key/title/visible 等属性。
+ * 各 composable 共用此类型，避免重复定义。
+ */
+type ColumnWithKey = TableColumn & {
+  key?: string;
+  title?: string;
+  visible?: boolean;
   width?: number | string;
-  createText?: string;
-  saveText?: string;
-  cancelText?: string;
-  closable?: boolean;
-  maskClosable?: boolean;
-  closeOnEsc?: boolean;
-}
-interface FormModalEmits<T extends object = FormRecord> {
-  submit: [payload: SubmitEventPayload<T>, saved: boolean];
-  close: [];
-}
-//#endregion
-//#region src/components/C_FormModal/index.vue.d.ts
-declare const __VLS_export: <T extends object = FormRecord>(__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<FormModalProps<T> & {
-    onClose?: (() => any) | undefined;
-    onSubmit?: ((payload: SubmitEventPayload<T>, saved: boolean) => any) | undefined;
+  align?: string;
+  titleAlign?: string;
+  formatter?: ColumnFormatter;
+};
+//#endregion
+//#region src/components/C_DataPicker/types.d.ts
+type DataPickerValue = string | number;
+/** 接口、鉴权与实体映射只在应用中注册一次，组件不探测后端返回结构。 */
+interface DataPickerSource<T extends object> {
+  rowKey: TableRowKey<T>;
+  value: (row: T) => DataPickerValue;
+  label: (row: T) => string;
+  request: (query: {
+    page: number;
+    pageSize: number;
+    search: string;
+    signal: AbortSignal;
+  }) => Promise<{
+    rows: T[];
+    total: number;
+  }>;
+  resolve?: (values: readonly DataPickerValue[], signal: AbortSignal) => Promise<readonly T[]>;
+}
+interface DataPickerProps<T extends object> {
+  source: DataPickerSource<T>;
+  columns: TableColumn<T>[];
+  modelValue?: DataPickerValue | readonly DataPickerValue[] | null;
+  multiple?: boolean;
+  disabled?: boolean;
+  readonly?: boolean;
+  clearable?: boolean;
+  title?: string;
+  placeholder?: string;
+  density?: ComponentDensity;
+  locale?: ComponentLocale;
+  pageSize?: number;
+}
+interface DataPickerEmits<T extends object> {
+  'update:modelValue': [value: DataPickerValue | DataPickerValue[] | null];
+  /** 无 resolve 的未知初值保留原编码，此事件只包含已解析的行。 */
+  select: [rows: T[]];
+}
+//#endregion
+//#region src/components/C_DataPicker/index.vue.d.ts
+declare const __VLS_export: <T extends object>(__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<DataPickerProps<T> & {
+    onSelect?: ((rows: T[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: DataPickerValue | DataPickerValue[] | null) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
-  expose: (exposed: {}) => void;
+  expose: (exposed: vue.ShallowUnwrapRef<{
+    open: () => void;
+    close: () => void;
+  }>) => void;
   attrs: any;
-  slots: {
-    [x: string]: ((props: any) => any) | undefined;
-  };
-  emit: ((evt: "close") => void) & ((evt: "submit", payload: SubmitEventPayload<T>, saved: boolean) => void);
+  slots: {};
+  emit: ((evt: "select", rows: T[]) => void) & ((evt: "update:modelValue", value: DataPickerValue | DataPickerValue[] | null) => 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
-export { FormModalProps as a, FormModalMode as i, FormModalEditor as n, FormModalEmits as r, _default as t };
+export { FormatterConfig as $, UseTableActionsOptions as A, ExpandConfig$1 as B, TableEmits as C, TableRowKey as D, TableProps as E, ColumnDragConfig as F, ToolbarConfig as G, SelectionConfig$1 as H, CrudBinding as I, createEditModeChecker as J, TreeConfig as K, DisplayConfig as L, UseTableExpandOptions as M, UseTableExpandReturn as N, TableRowKeyIssue as O, BatchActionsConfig as P, ColumnFormatter as Q, EditConfig as R, TableColumn as S, TableManagerApi as T, SummaryConfig as U, ResolvedConfig as V, TableConfig as W, ExportConfig as X, resolveConfig as Y, exportTableData as Z, RenderFunction as _, PrintWatermarkOptions as _t, DataPickerValue as a, useTableGlobalConfig as at, SimpleTableActions as b, ChildSelectionState as c, UseCrossPageSelectionReturn as ct, DataRecord as d, UseRowDragOptions as dt, FormatterType as et, EditMode as f, UseRowDragReturn as ft, ParentChildLinkMode as g, useDynamicRows as gt, PaginationConfig as h, DynamicRowsReturn as ht, DataPickerSource as i, mergeGlobalConfig as it, UseTableActionsReturn as j, TableRuntimeProps as k, ColumnWithKey as l, useCrossPageSelection as lt, NormalTableColumn as m, DynamicRowsOptions as mt, DataPickerEmits as n, TableGlobalConfig as nt, ApiFunction as o, CrossPageSelectionConfig as ot, MaybeRefLike as p, useRowDrag as pt, VirtualScrollConfig as q, DataPickerProps as r, applyFormatter as rt, BuiltInTableColumn as s, UseCrossPageSelectionOptions as st, _default as t, TABLE_GLOBAL_CONFIG_KEY as tt, CustomAction as u, RowDragConfig as ut, RowAction as v, printPresets as vt, TableInstance as w, StrictTableColumn as x, SelectOption as y, usePrintWatermark as yt, ErrorConfig as z };