@robot-admin/naive-ui-components 0.17.6 → 0.19.0

package/dist/useTableQuery.d.cts

@@ -154,11 +154,12 @@ declare const printPresets: {
 };
 //#endregion
 //#region src/components/C_Table/composables/useDynamicRow.d.ts
-interface DynamicRowsOptions<T extends object = DataRecord> {
+interface DynamicRowsBaseOptions<T extends object> {
   /** 总开关；关闭时公开方法保持安全 no-op */
   enabled?: boolean;
   rowKey?: string | ((row: T) => DataTableRowKey);
-  defaultRowData?: () => T;
+  /** 新增返回完整业务行；复制时可接收原行副本，函数 rowKey 需返回完整的新副本。 */
+  defaultRowData?: (source?: T) => T;
   enableRadioSelection?: boolean;
   enableAdd?: boolean;
   enableInsert?: boolean;
@@ -181,6 +182,10 @@ interface DynamicRowsOptions<T extends object = DataRecord> {
   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>;
@@ -209,7 +214,7 @@ interface DynamicRowsReturn<T extends object = DataRecord> {
 /**
  * 表格动态行操作功能组合
  */
-declare function useDynamicRows<T extends object = DataRecord>(data: Readonly<Ref<T[]>>, options?: MaybeRefOrGetter<DynamicRowsOptions<T>>): DynamicRowsReturn<T>;
+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 {
@@ -382,17 +387,17 @@ interface CrudBinding<T extends object = DataRecord> {
   /** 提供 save 时 edit 函数只标记保存能力；自定义编辑入口放到 config.actions.edit。 */
   actions?: ComputedRef<SimpleTableActions<T>>;
   pagination?: ComputedRef<PaginationConfig | boolean | undefined>;
-  tableRef?: Ref<any>;
-  save?: (...args: any[]) => any;
+  tableRef?: Ref<unknown>;
+  save?: (row: T, rowIndex?: number, columnKey?: string) => unknown | Promise<unknown>;
   handleCancel?: () => void;
   handlePaginationChange?: (page: number, pageSize: number) => void;
-  handleRowDelete?: (...args: any[]) => any;
+  handleRowDelete?: (row: T, index?: number) => unknown | Promise<unknown>;
   detail?: {
-    show: (...args: any[]) => void;
+    show: (row: T) => unknown;
   };
 }
 /** C_Table :config prop 的类型 — 所有功能配置收拢在此 */
-interface TableConfig<T extends object = DataRecord> {
+interface TableConfig<T extends object = DataRecord, C = unknown> {
   /** 与 C_Form / C_FormSearch 共用密度；局部 display.size 等显式配置优先。 */
   density?: ComponentDensity;
   /** 组件级反馈适配器；未提供时尝试复用 Naive Provider，再安全降级 */
@@ -408,11 +413,11 @@ interface TableConfig<T extends object = DataRecord> {
   /** 分页配置 */
   pagination?: PaginationConfig | boolean;
   /** 展开行配置 */
-  expand?: ExpandConfig$1<T> | boolean;
+  expand?: ExpandConfig$1<T, C> | boolean;
   /** 选择配置 */
-  selection?: SelectionConfig$1<T> | boolean;
+  selection?: SelectionConfig$1<T, C> | boolean;
   /** 动态行配置 */
-  dynamicRows?: DynamicRowsOptions<T> | boolean;
+  dynamicRows?: DynamicRowsOptions<T> | (string extends keyof T ? boolean : false);
   /** 工具栏 */
   toolbar?: ToolbarConfig;
   /** 表格显示属性 */
@@ -447,29 +452,29 @@ interface EditConfig<T extends object = DataRecord> {
   modalTitle?: string;
   modalWidth?: number;
   /** 保存前回调；抛出异常会保留编辑态，便于修正或重试 */
-  onSave?: (rowData: T, rowIndex: number, columnKey?: string) => void | Promise<void>;
+  onSave?: (rowData: T, rowIndex: number, columnKey?: string) => unknown;
   /** 取消编辑回调 */
-  onCancel?: (rowData: T, rowIndex: number) => void | Promise<void>;
+  onCancel?: (rowData: T, rowIndex: number) => unknown;
   /** 编辑或保存失败回调 */
   onError?: (error: unknown) => void;
 }
-interface ExpandConfig$1<T extends object = DataRecord> {
+interface ExpandConfig$1<T extends object = DataRecord, C = unknown> {
   enabled?: boolean;
   defaultExpandedKeys?: DataTableRowKey[];
-  onLoadData?: (row: T) => Promise<unknown[]> | unknown[];
+  onLoadData?: (row: T) => Promise<C[]> | C[];
   /** 展开数据加载失败回调 */
   onError?: (error: unknown, row: T) => void;
-  renderContent?: (row: T, expandData: unknown[], loading: boolean, childSelection?: unknown) => VNodeChild;
+  renderContent?: (row: T, expandData: C[], loading: boolean, childSelection?: ChildSelectionState) => VNodeChild;
   rowExpandable?: (row: T) => boolean;
 }
-interface SelectionConfig$1<T extends object = DataRecord> {
+interface SelectionConfig$1<T extends object = DataRecord, C = unknown> {
   enabled?: boolean;
   defaultCheckedKeys?: DataTableRowKey[];
   rowCheckable?: (row: T) => boolean;
   maxSelection?: number;
   childSelection?: {
     enabled?: boolean;
-    childRowCheckable?: (childRow: unknown, parentRow: T) => boolean;
+    childRowCheckable?: (childRow: C, parentRow: T) => boolean;
   };
   parentChildLink?: {
     enabled?: boolean;
@@ -540,7 +545,7 @@ interface ErrorConfig {
   /** 错误描述文案 */
   message?: string;
   /** 重试回调 */
-  onRetry?: () => void | Promise<void>;
+  onRetry?: () => unknown;
 }
 /** 批量操作配置 */
 interface BatchActionsConfig<T extends object = DataRecord> {
@@ -555,7 +560,7 @@ interface BatchActionsConfig<T extends object = DataRecord> {
     label: string;
     icon?: string;
     type?: string;
-    onClick: (selectedKeys: DataTableRowKey[], selectedRows: T[]) => void | Promise<void>;
+    onClick: (selectedKeys: DataTableRowKey[], selectedRows: T[]) => unknown;
   }>;
 }
 interface ResolvedConfig {
@@ -575,7 +580,7 @@ interface ResolvedConfig {
   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;
+  renderExpandContent: ((row: DataRecord, expandData: unknown[], loading: boolean, childSelection?: ChildSelectionState) => VNodeChild) | undefined;
   rowExpandable: ((row: DataRecord) => boolean) | undefined;
   enableSelection: boolean;
   defaultCheckedKeys: DataTableRowKey[] | undefined;
@@ -643,245 +648,6 @@ declare const createEditModeChecker: (config: ResolvedConfig) => {
   isCellEditMode: () => boolean;
 };
 //#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, originalKey?: DataTableRowKey) => 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;
-  invalidate: () => void;
-};
-//#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>;
-  treeEnabled?: boolean;
-  treeChildrenKey?: string;
-}
-/**
- * 表格管理器参数接口
- */
-interface TableManagerParams {
-  config: MaybeRefOrGetter<TableManagerConfig>;
-  data: () => DataRecord[];
-  rowKey: (row: DataRecord) => DataTableRowKey;
-  emit: (...args: any[]) => unknown;
-  /** 列配置（用于编辑校验） */
-  columns?: () => TableColumn[];
-  /** UI 壳提供加载内容，状态引擎保持可独立调用。 */
-  renderLoading?: () => VNodeChild;
-  /** String row-key field inherited by dynamic row creation; explicit dynamicRows.rowKey wins. */
-  rowKeyField?: MaybeRefOrGetter<string | undefined>;
-}
-/**
- * 事件处理器接口
- */
-interface EventHandlers {
-  onSave: (rowData: DataRecord, rowIndex: number, columnKey?: string, originalKey?: DataTableRowKey) => 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;
-      invalidate: () => void;
-    };
-    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;
-      invalidate: () => void;
-    };
-    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;
-      invalidate: () => void;
-    };
-  };
-  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/types.d.ts
 type RefLike<T> = {
   value: T;
@@ -928,7 +694,7 @@ interface CustomAction<T extends object = DataRecord> {
   /** 按钮类型样式 */
   type?: ButtonType$1 | ((row: T, index: number) => ButtonType$1);
   /** 点击事件处理器 */
-  onClick: (row: T, index: number) => void | Promise<void>;
+  onClick: (row: T, index: number) => unknown;
   /** 条件显示函数（可选） */
   show?: (row: T, index: number) => boolean;
   /** 是否禁用（可选） */
@@ -1095,12 +861,6 @@ interface SelectionConfig<T extends object = DataRecord, C = DataRecord> extends
   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;
@@ -1110,51 +870,30 @@ interface TableDisplayProps {
   singleLine?: boolean;
   size?: 'small' | 'medium' | 'large';
 }
-/** @deprecated 旧类型兼容；组件功能请使用 config.edit。 */
-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;
-}
-/** @deprecated 旧类型兼容；组件功能请使用 config.expand。 */
-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[];
-}
-/** @deprecated 旧类型兼容；组件功能请使用 config.selection。 */
-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 Partial<TableBaseProps<T>>, TableDisplayProps, TableEditProps<T>, TableExpandProps<T, C>, TableSelectionProps<T, C> {
+/** 组件声明的实际属性；与 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>;
+  config?: TableConfig<T, C>;
   /** CRUD 模式自动提供 columns / data / loading，可省略对应属性。 */
   crud?: CrudBinding<T>;
   /** 原生分页入口；声明后优先于 config.pagination。 */
   pagination?: PaginationProps | false;
   remote?: boolean;
   virtualScrollX?: boolean;
-  /** @deprecated 使用 config.actions。 */
-  actions?: SimpleTableActions<T>;
   /** 根容器 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];
 }
@@ -1174,6 +913,12 @@ interface TableEmits<T extends object = DataRecord, C = DataRecord> extends Tabl
   '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;
@@ -1222,10 +967,56 @@ 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: () => ReturnType<typeof useTableManager>['stateManager'];
+  getManager: () => TableManagerApi<T, C>;
   /** 此嵌套对象中的 Ref 保持响应式，读取时使用 .value。 */
   crossPageSelection: Pick<UseCrossPageSelectionReturn<T>, 'selectedKeys' | 'selectedCount' | 'select' | 'unselect' | 'selectAll' | 'clearAll' | 'getSelectedRows'> & {
     enabled: ComputedRef<boolean>;
@@ -1273,7 +1064,7 @@ interface RowAction<T extends object = DataRecord> {
   type?: ButtonType$1;
   disabled?: boolean | ((row: T, index: number) => boolean);
   show?: boolean | ((row: T, index: number) => boolean);
-  onClick?: (row: T, index: number) => void | Promise<void>;
+  onClick?: (row: T, index: number) => unknown;
   tooltip?: string;
 }
 /**
@@ -1291,119 +1082,30 @@ type ColumnWithKey = TableColumn & {
 };
 //#endregion
 //#region src/components/C_Table/index.vue.d.ts
-declare const __VLS_export$1: <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<{
-    /** 根容器 class；普通 class/style 仍按既有契约转发到 NDataTable。 */wrapperClass?: vue.HTMLAttributes["class"]; /** 填满已确定高度的根容器，并为工具栏和分页预留空间。 */
-    flexHeight?: boolean; /** 原生横向虚拟滚动；未声明业务列宽时仍提供可计算的数值兜底。 */
-    virtualScrollX?: boolean; /** 列配置（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>; /** Native pagination compatibility path; takes ownership over config.pagination. */
-    pagination?: PaginationProps | false; /** Native remote mode, used with the native pagination compatibility path. */
-    remote?: boolean; /** CRUD 绑定 — 传入 useTableCrud() 的返回值，自动接管 data/columns/loading/actions/pagination/events */
-    crud?: CrudBinding<T>;
-  } & {
-    [x: `on${Capitalize<string>}`]: ((...args: any) => any) | undefined;
+declare const __VLS_export$1: <T extends object = DataRecord, C = unknown>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$1<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$1<TableRuntimeProps<T, C> & {
+    onSave?: ((rowData: T, rowIndex: number, columnKey?: string | undefined) => any) | undefined;
+    onCancel?: ((rowData: T, rowIndex: number) => any) | undefined;
+    "onPagination-change"?: ((page: number, pageSize: number) => any) | undefined;
+    "onRow-delete"?: ((deletedRow: T, index: number) => any) | undefined;
+    "onBatch-action-error"?: ((error: unknown, actionKey: string) => any) | undefined;
+    "onRow-key-error"?: ((issues: TableRowKeyIssue<T>[]) => any) | undefined;
+    "onRow-add"?: ((newRow: T) => any) | undefined;
+    "onRow-copy"?: ((originalRow: T, newRow: T) => any) | undefined;
+    "onRow-move"?: ((row: T, fromIndex: number, toIndex: number) => any) | undefined;
+    "onRow-selection-change"?: ((selectedKey: DataTableRowKey | null, selectedRow: T | null) => any) | undefined;
+    "onView-detail"?: ((data: T) => any) | undefined;
+    "onColumn-change"?: ((columns: TableColumn<T>[]) => any) | undefined;
+    "onExpand-change"?: ((expandedKeys: DataTableRowKey[], row?: T | undefined, expanded?: boolean | undefined) => any) | undefined;
+    "onSelection-change"?: ((checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => any) | undefined;
+    "onChild-selection-change"?: ((parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: C[]) => any) | undefined;
+    "onParent-child-link-change"?: ((parentKey: DataTableRowKey, shouldSelect: boolean) => any) | undefined;
+    "onUpdate:data"?: ((data: T[]) => any) | undefined;
+    "onEdit-error"?: ((error: unknown) => 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>;
-    retryExpand: (rowKey: DataTableRowKey) => Promise<void>;
-    invalidateExpand: (rowKey?: DataTableRowKey) => 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;
+  expose: (exposed: vue.ShallowUnwrapRef<TableInstance<T, C>>) => void;
   attrs: any;
   slots: {
     'toolbar-left'?: (props: {}) => any;
@@ -1416,18 +1118,18 @@ declare const __VLS_export$1: <T extends object = DataRecord>(__VLS_props: NonNu
   } & {
     loading?: (props: {}) => any;
   };
-  emit: ((evt: "save", rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "cancel", rowData: DataRecord, rowIndex: number) => 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);
+  emit: ((evt: "save", rowData: T, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "cancel", rowData: T, rowIndex: number) => void) & ((evt: "pagination-change", page: number, pageSize: number) => void) & ((evt: "row-delete", deletedRow: T, index: number) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<T>[]) => void) & ((evt: "row-add", newRow: T) => void) & ((evt: "row-copy", originalRow: T, newRow: T) => void) & ((evt: "row-move", row: T, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: T | null) => void) & ((evt: "view-detail", data: T) => void) & ((evt: "column-change", columns: TableColumn<T>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: T | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: T[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: C[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: T[]) => void) & ((evt: "edit-error", error: unknown) => void);
 }>) => vue.VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
 declare const _default$1: typeof __VLS_export$1;
-type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
+type __VLS_PrettifyLocal$1<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>;
+declare function defineTableConfig<T extends object, C = unknown>(config: TableConfig<T, C>): TableConfig<T, C>;
 /** 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
@@ -1499,6 +1201,245 @@ interface UseTableColumnsReturn {
  */
 declare function useTableColumns(options: UseTableColumnsOptions): UseTableColumnsReturn;
 //#endregion
+//#region src/components/C_Table/composables/useRowEdit.d.ts
+/** 行级校验错误 */
+interface RowValidationError {
+  field: string;
+  message: string;
+}
+/**
+ * 行编辑配置选项
+ */
+interface RowEditOptions {
+  data: () => DataRecord[];
+  rowKey: (row: DataRecord) => DataTableRowKey;
+  onSave?: (rowData: DataRecord, rowIndex: number, originalKey?: DataTableRowKey) => unknown;
+  onCancel?: (rowData: DataRecord, rowIndex: number) => unknown;
+  /** 列配置（用于提取校验规则） */
+  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;
+  invalidate: () => void;
+};
+//#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) => unknown;
+  onEditCancel?: (rowData: DataRecord, rowIndex: number) => unknown;
+  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>;
+  treeEnabled?: boolean;
+  treeChildrenKey?: string;
+}
+/**
+ * 表格管理器参数接口
+ */
+interface TableManagerParams {
+  config: MaybeRefOrGetter<TableManagerConfig>;
+  data: () => DataRecord[];
+  rowKey: (row: DataRecord) => DataTableRowKey;
+  emit: (...args: any[]) => unknown;
+  /** 列配置（用于编辑校验） */
+  columns?: () => TableColumn[];
+  /** UI 壳提供加载内容，状态引擎保持可独立调用。 */
+  renderLoading?: () => VNodeChild;
+  /** String row-key field inherited by dynamic row creation; explicit dynamicRows.rowKey wins. */
+  rowKeyField?: MaybeRefOrGetter<string | undefined>;
+}
+/**
+ * 事件处理器接口
+ */
+interface EventHandlers {
+  onSave: (rowData: DataRecord, rowIndex: number, columnKey?: string, originalKey?: DataTableRowKey) => 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;
+      invalidate: () => void;
+    };
+    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;
+      invalidate: () => void;
+    };
+    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;
+      invalidate: () => void;
+    };
+  };
+  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
 /**
  *
@@ -1540,7 +1481,7 @@ declare function usePagination<T extends object = DataRecord>(options: UsePagina
 interface CellEditOptions {
   data: () => DataRecord[];
   rowKey: (row: DataRecord) => DataTableRowKey;
-  onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string, originalKey?: DataTableRowKey) => void | Promise<void>;
+  onSave?: (rowData: DataRecord, rowIndex: number, columnKey: string, originalKey?: DataTableRowKey) => unknown;
   /** 列配置（用于提取校验规则） */
   columns?: () => TableColumn[];
 }
@@ -1582,8 +1523,8 @@ declare function useCellEdit(options: CellEditOptions): {
 interface ModalEditOptions<T extends object = DataRecord> {
   data: () => T[];
   rowKey: (row: T) => DataTableRowKey;
-  onSave?: (editingData: T, rowIndex: number, originalKey?: DataTableRowKey) => void | Promise<void>;
-  onCancel?: (originalData: T, rowIndex: number) => void | Promise<void>;
+  onSave?: (editingData: T, rowIndex: number, originalKey?: DataTableRowKey) => unknown;
+  onCancel?: (originalData: T, rowIndex: number) => unknown;
 }
 /** Modal edit state with lossless snapshots and retry-safe async saves. */
 declare function useModalEdit<T extends object = DataRecord>(options: ModalEditOptions<T>): {
@@ -1652,9 +1593,9 @@ interface TreeNodeData extends TreeOption$1 {
   type?: string;
   children?: TreeNodeData[];
 }
-interface DropInfo {
-  node: TreeOption$1;
-  dragNode: TreeOption$1;
+interface DropInfo<T extends object = TreeOption$1> {
+  node: T;
+  dragNode: T;
   dropPosition: 'before' | 'inside' | 'after';
   event: DragEvent;
 }
@@ -1665,12 +1606,12 @@ interface StatusConfig {
     type: StatusType;
   }>;
 }
-interface ActionConfig {
+interface ActionConfig<T extends object = TreeNodeData> {
   key: string;
   text: string;
   icon: string;
   type?: ButtonType;
-  show?: (node: TreeNodeData) => boolean;
+  show?: (node: T) => boolean;
   confirm?: string;
 }
 interface IconConfig {
@@ -1678,22 +1619,67 @@ interface IconConfig {
   typeMap?: Record<string, string>;
   colorMap?: Record<string, string>;
 }
-type TreeNativeProps = Omit<TreeProps, 'data'>;
-interface TreeRenderContext {
-  option: TreeOption$1;
+type MaybeArray<T> = T | T[];
+type TreeUpdateHandler<T extends object, A extends TreeUpdateMeta['action']> = (keys: TreeKey[], options: Array<T | null>, meta: TreeUpdateMeta<T, A>) => void;
+type TreeDragHandler<T extends object> = (info: {
+  node: T;
+  event: DragEvent;
+}) => void;
+/** 原生功能保持透传，涉及节点的回调由数据源推导业务类型。 */
+type TreeNativeProps<T extends object = TreeNodeData> = Omit<TreeProps, 'data' | 'filter' | 'onLoad' | 'getChildren' | 'renderLabel' | 'renderPrefix' | 'renderSuffix' | 'renderSwitcherIcon' | 'nodeProps' | 'allowDrop' | 'checkOnClick' | 'overrideDefaultNodeClickBehavior' | 'onDrop' | 'onDragenter' | 'onDragleave' | 'onDragend' | 'onDragstart' | 'onDragover' | 'onUpdateExpandedKeys' | 'onUpdate:expandedKeys' | 'onUpdateSelectedKeys' | 'onUpdate:selectedKeys' | 'onUpdateCheckedKeys' | 'onUpdate:checkedKeys' | 'onUpdateIndeterminateKeys' | 'onUpdate:indeterminateKeys'> & {
+  filter?: (pattern: string, node: T) => boolean;
+  onLoad?: (node: T) => Promise<unknown>;
+  getChildren?: (node: T) => unknown;
+  renderLabel?: (context: TreeRenderContext<T>) => VNodeChild;
+  renderPrefix?: (context: TreeRenderContext<T>) => VNodeChild;
+  renderSuffix?: (context: TreeRenderContext<T>) => VNodeChild;
+  renderSwitcherIcon?: (context: {
+    expanded: boolean;
+    selected: boolean;
+    option: T;
+  }) => VNodeChild;
+  nodeProps?: (context: {
+    option: T;
+  }) => ReturnType<NonNullable<TreeProps['nodeProps']>>;
+  allowDrop?: (info: {
+    dropPosition: DropInfo['dropPosition'];
+    node: T;
+    phase: 'drag' | 'drop';
+  }) => boolean;
+  checkOnClick?: boolean | ((node: T) => boolean);
+  overrideDefaultNodeClickBehavior?: (info: {
+    option: T;
+  }) => ReturnType<NonNullable<TreeProps['overrideDefaultNodeClickBehavior']>>;
+  onDrop?: MaybeArray<(info: DropInfo<T>) => void>;
+  onDragenter?: MaybeArray<TreeDragHandler<T>>;
+  onDragleave?: MaybeArray<TreeDragHandler<T>>;
+  onDragend?: MaybeArray<TreeDragHandler<T>>;
+  onDragstart?: MaybeArray<TreeDragHandler<T>>;
+  onDragover?: MaybeArray<TreeDragHandler<T>>;
+  onUpdateExpandedKeys?: MaybeArray<TreeUpdateHandler<T, 'expand' | 'collapse' | 'filter'>>;
+  'onUpdate:expandedKeys'?: MaybeArray<TreeUpdateHandler<T, 'expand' | 'collapse' | 'filter'>>;
+  onUpdateSelectedKeys?: MaybeArray<TreeUpdateHandler<T, 'select' | 'unselect'>>;
+  'onUpdate:selectedKeys'?: MaybeArray<TreeUpdateHandler<T, 'select' | 'unselect'>>;
+  onUpdateCheckedKeys?: MaybeArray<TreeUpdateHandler<T, 'check' | 'uncheck'>>;
+  'onUpdate:checkedKeys'?: MaybeArray<TreeUpdateHandler<T, 'check' | 'uncheck'>>;
+  onUpdateIndeterminateKeys?: MaybeArray<(keys: TreeKey[], options: Array<T | null>) => void>;
+  'onUpdate:indeterminateKeys'?: MaybeArray<(keys: TreeKey[], options: Array<T | null>) => void>;
+};
+interface TreeRenderContext<T extends object = TreeOption$1> {
+  option: T;
   checked: boolean;
   selected: boolean;
 }
-interface TreeUpdateMeta {
-  node: TreeOption$1 | null;
-  action: 'select' | 'unselect' | 'check' | 'uncheck' | 'expand' | 'collapse' | 'filter';
+interface TreeUpdateMeta<T extends object = TreeOption$1, A extends 'select' | 'unselect' | 'check' | 'uncheck' | 'expand' | 'collapse' | 'filter' = 'select' | 'unselect' | 'check' | 'uncheck' | 'expand' | 'collapse' | 'filter'> {
+  node: T | null;
+  action: A;
 }
-interface TreeProps$1 {
+interface TreeProps$1<T extends object = TreeNodeData> {
   /** Business interfaces need no string index signature; fields are selected by config. */
-  data: object[];
+  data: readonly T[];
   mode?: TreeMode;
   /** Native tree capabilities; explicit wrapper props have priority. */
-  treeProps?: TreeNativeProps;
+  treeProps?: TreeNativeProps<T>;
   density?: ComponentDensity;
   keyField?: string;
   labelField?: string;
@@ -1710,7 +1696,7 @@ interface TreeProps$1 {
   iconField?: string;
   iconConfig?: IconConfig;
   statusConfigs?: StatusConfig[];
-  actions?: ActionConfig[];
+  actions?: ActionConfig<T>[];
   defaultExpandAll?: boolean;
   defaultExpandedKeys?: TreeKey[];
   defaultSelectedKeys?: TreeKey[];
@@ -1719,125 +1705,110 @@ interface TreeProps$1 {
   selectedKeys?: TreeKey[];
   checkedKeys?: TreeKey[];
 }
-interface TreeExpose {
+interface TreeExpose<T extends object = TreeNodeData> {
   expandAll: () => void;
   collapseAll: () => void;
   selectNode: (key: TreeKey) => void;
   clearSelection: () => void;
   setCheckedKeys: (keys: TreeKey[]) => void;
   clearChecked: () => void;
-  getSelectedNode: () => TreeNodeData | null;
-  getCheckedData: TreeInst['getCheckedData'];
-  getIndeterminateData: TreeInst['getIndeterminateData'];
+  getSelectedNode: () => T | null;
+  getCheckedData: () => {
+    keys: TreeKey[];
+    options: Array<T | null>;
+  };
+  getIndeterminateData: () => {
+    keys: TreeKey[];
+    options: Array<T | null>;
+  };
   scrollTo: TreeInst['scrollTo'];
   /** Vue 公开实例会解包顶层 Ref；这些属性直接读取数组。 */
   expandedKeys: TreeKey[];
   selectedKeys: TreeKey[];
   checkedKeys: TreeKey[];
 }
-interface TreeEmits {
+interface TreeEmits<T extends object = TreeNodeData> {
   'update:searchPattern': [pattern: string];
-  'update:expandedKeys': [keys: TreeKey[], options: Array<TreeOption$1 | null>, meta: TreeUpdateMeta];
-  'update:selectedKeys': [keys: TreeKey[], options: Array<TreeOption$1 | null>, meta: TreeUpdateMeta];
-  'update:checkedKeys': [keys: TreeKey[], options: Array<TreeOption$1 | null>, meta: TreeUpdateMeta];
-  'node-select': [node: TreeNodeData | null, selectedKeys: TreeKey[]];
-  'node-action': [action: string, node: TreeNodeData];
-  'node-drop': [info: DropInfo];
-  'load-error': [error: unknown, node: TreeOption$1];
-  add: [parentNode?: TreeNodeData];
+  'update:expandedKeys': [keys: TreeKey[], options: Array<T | null>, meta: TreeUpdateMeta<T>];
+  'update:selectedKeys': [keys: TreeKey[], options: Array<T | null>, meta: TreeUpdateMeta<T>];
+  'update:checkedKeys': [keys: TreeKey[], options: Array<T | null>, meta: TreeUpdateMeta<T>];
+  'node-select': [node: T | null, selectedKeys: TreeKey[]];
+  'node-action': [action: string, node: T];
+  'node-drop': [info: DropInfo<T>];
+  'load-error': [error: unknown, node: T];
+  add: [parentNode?: T];
   refresh: [];
 }
-interface TreeSlots {
+interface TreeSlots<T extends object = TreeOption$1> {
   'toolbar-actions'?: () => VNodeChild;
-  label?: (context: TreeRenderContext) => VNodeChild;
-  prefix?: (context: TreeRenderContext) => VNodeChild;
-  suffix?: (context: TreeRenderContext) => VNodeChild;
+  label?: (context: TreeRenderContext<T>) => VNodeChild;
+  prefix?: (context: TreeRenderContext<T>) => VNodeChild;
+  suffix?: (context: TreeRenderContext<T>) => VNodeChild;
   empty?: () => VNodeChild;
 }
 //#endregion
 //#region src/components/C_Tree/index.vue.d.ts
-type __VLS_Slots = TreeSlots;
-declare const __VLS_base: vue.DefineComponent<TreeProps$1, Omit<TreeExpose, "expandedKeys" | "selectedKeys" | "checkedKeys"> & {
-  expandedKeys: vue.Ref<TreeKey[]>;
-  selectedKeys: vue.Ref<TreeKey[]>;
-  checkedKeys: vue.Ref<TreeKey[]>;
-}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  add: (parentNode?: TreeNodeData | undefined) => any;
-  "update:searchPattern": (pattern: string) => any;
-  "update:expandedKeys": (keys: TreeKey[], options: (TreeOption$1 | null)[], meta: TreeUpdateMeta) => any;
-  "update:selectedKeys": (keys: TreeKey[], options: (TreeOption$1 | null)[], meta: TreeUpdateMeta) => any;
-  "update:checkedKeys": (keys: TreeKey[], options: (TreeOption$1 | null)[], meta: TreeUpdateMeta) => any;
-  "node-select": (node: TreeNodeData | null, selectedKeys: TreeKey[]) => any;
-  "node-action": (action: string, node: TreeNodeData) => any;
-  "node-drop": (info: DropInfo) => any;
-  "load-error": (error: unknown, node: TreeOption$1) => any;
-  refresh: () => any;
-}, string, vue.PublicProps, Readonly<TreeProps$1> & Readonly<{
-  onAdd?: ((parentNode?: TreeNodeData | undefined) => any) | undefined;
-  "onUpdate:searchPattern"?: ((pattern: string) => any) | undefined;
-  "onUpdate:expandedKeys"?: ((keys: TreeKey[], options: (TreeOption$1 | null)[], meta: TreeUpdateMeta) => any) | undefined;
-  "onUpdate:selectedKeys"?: ((keys: TreeKey[], options: (TreeOption$1 | null)[], meta: TreeUpdateMeta) => any) | undefined;
-  "onUpdate:checkedKeys"?: ((keys: TreeKey[], options: (TreeOption$1 | null)[], meta: TreeUpdateMeta) => any) | undefined;
-  "onNode-select"?: ((node: TreeNodeData | null, selectedKeys: TreeKey[]) => any) | undefined;
-  "onNode-action"?: ((action: string, node: TreeNodeData) => any) | undefined;
-  "onNode-drop"?: ((info: DropInfo) => any) | undefined;
-  "onLoad-error"?: ((error: unknown, node: TreeOption$1) => any) | undefined;
-  onRefresh?: (() => any) | undefined;
-}>, {
-  mode: TreeMode;
-  density: ComponentDensity;
-  searchable: boolean;
-  searchPlaceholder: string;
-  draggable: boolean;
-  showLine: boolean;
-  showToolbar: boolean;
-  addable: boolean;
-  addText: string;
-  refreshable: boolean;
-  defaultExpandAll: boolean;
-}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-type __VLS_WithSlots<T, S> = T & {
-  new (): {
-    $slots: S;
-  };
+declare const __VLS_export: <T extends object = TreeNodeData>(__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<TreeProps$1<T> & {
+    onRefresh?: (() => any) | undefined;
+    onAdd?: ((parentNode?: T | undefined) => any) | undefined;
+    "onLoad-error"?: ((error: unknown, node: T) => any) | undefined;
+    "onUpdate:expandedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "collapse" | "expand" | "unselect" | "check" | "uncheck">) => any) | undefined;
+    "onUpdate:searchPattern"?: ((pattern: string) => any) | undefined;
+    "onUpdate:selectedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "collapse" | "expand" | "unselect" | "check" | "uncheck">) => any) | undefined;
+    "onUpdate:checkedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "collapse" | "expand" | "unselect" | "check" | "uncheck">) => any) | undefined;
+    "onNode-select"?: ((node: T | null, selectedKeys: TreeKey[]) => any) | undefined;
+    "onNode-action"?: ((action: string, node: T) => any) | undefined;
+    "onNode-drop"?: ((info: DropInfo<T>) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: vue.ShallowUnwrapRef<Omit<TreeExpose<T>, "expandedKeys" | "selectedKeys" | "checkedKeys"> & {
+    expandedKeys: vue.Ref<TreeKey[]>;
+    selectedKeys: vue.Ref<TreeKey[]>;
+    checkedKeys: vue.Ref<TreeKey[]>;
+  }>) => void;
+  attrs: any;
+  slots: TreeSlots<T>;
+  emit: ((evt: "refresh") => void) & ((evt: "add", parentNode?: T | undefined) => void) & ((evt: "load-error", error: unknown, node: T) => void) & ((evt: "update:expandedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "collapse" | "expand" | "unselect" | "check" | "uncheck">) => void) & ((evt: "update:searchPattern", pattern: string) => void) & ((evt: "update:selectedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "collapse" | "expand" | "unselect" | "check" | "uncheck">) => void) & ((evt: "update:checkedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "collapse" | "expand" | "unselect" | "check" | "uncheck">) => void) & ((evt: "node-select", node: T | null, selectedKeys: TreeKey[]) => void) & ((evt: "node-action", action: string, node: T) => void) & ((evt: "node-drop", info: DropInfo<T>) => 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_Tree/data.d.ts
-declare const presetConfigs: Record<TreeMode, Partial<TreeProps$1>>;
+declare const presetConfigs: Record<TreeMode, Partial<Omit<TreeProps$1, 'data' | 'treeProps' | 'actions'>> & {
+  actions?: Omit<ActionConfig, 'show'>[];
+}>;
 //#endregion
 //#region src/components/C_Tree/composables/useTreeOperations.d.ts
-type EmitFn = <E extends keyof TreeEmits>(event: E, ...args: TreeEmits[E]) => void;
+type EmitFn$1<T extends object> = <E extends keyof TreeEmits<T>>(event: E, ...args: TreeEmits<T>[E]) => void;
 /** State coordination only; checking, filtering, keyboard and loading stay native. */
-declare function useTreeOperations(props: TreeProps$1, emit: EmitFn, slots?: TreeSlots): {
+declare function useTreeOperations<T extends object = TreeNodeData>(props: TreeProps$1<T>, emit: EmitFn$1<T>, slots?: TreeSlots<T>): {
   internalSearchPattern: Ref<string, string>;
   expandedKeys: vue.WritableComputedRef<TreeKey[], TreeKey[]>;
   selectedKeys: vue.WritableComputedRef<TreeKey[], TreeKey[]>;
   checkedKeys: vue.WritableComputedRef<TreeKey[], TreeKey[]>;
   isAllExpanded: vue.ComputedRef<boolean>;
-  treeData: vue.ComputedRef<object[]>;
+  treeData: vue.ComputedRef<readonly T[]>;
   currentSearchPattern: vue.WritableComputedRef<string, string>;
-  renderPrefix: (info: TreeRenderContext) => string | number | boolean | void | vue.VNode<vue.RendererNode, vue.RendererElement, {
-    [key: string]: any;
-  }> | vue.VNodeArrayChildren | null;
-  renderLabel: (info: TreeRenderContext) => string | number | boolean | void | vue.VNode<vue.RendererNode, vue.RendererElement, {
-    [key: string]: any;
-  }> | vue.VNodeArrayChildren | null;
-  renderSuffix: (info: TreeRenderContext) => string | number | boolean | void | vue.VNode<vue.RendererNode, vue.RendererElement, {
+  renderPrefix: (info: TreeRenderContext<T>) => any;
+  renderLabel: (info: TreeRenderContext<T>) => string | number | boolean | void | vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
   }> | vue.VNodeArrayChildren | null;
+  renderSuffix: (info: TreeRenderContext<T>) => any;
   treeBindings: vue.ComputedRef<TreeProps>;
   treeRef: vue.ShallowRef<TreeInst | undefined, TreeInst | undefined>;
   density: vue.ComputedRef<ResolvedComponentDensity>;
   toggleExpandAll: () => void;
-  handleExpandedKeysChange: (keys: TreeKey[], options?: (TreeNodeData | null)[], meta?: TreeUpdateMeta) => void;
-  handleSelectedKeysChange: (keys: TreeKey[], options?: (TreeNodeData | null)[], meta?: TreeUpdateMeta) => void;
-  handleCheckedKeysChange: (keys: TreeKey[], options?: (TreeNodeData | null)[], meta?: TreeUpdateMeta) => void;
-  handleDrop: (info: DropInfo) => void;
+  handleExpandedKeysChange: (keys: TreeKey[], options?: (T | null)[], meta?: TreeUpdateMeta<T>) => void;
+  handleSelectedKeysChange: (keys: TreeKey[], options?: (T | null)[], meta?: TreeUpdateMeta<T>) => void;
+  handleCheckedKeysChange: (keys: TreeKey[], options?: (T | null)[], meta?: TreeUpdateMeta<T>) => void;
+  handleDrop: (info: DropInfo<T>) => void;
   handleAdd: () => void;
   handleRefresh: () => void;
-  expose: Omit<TreeExpose, "expandedKeys" | "selectedKeys" | "checkedKeys"> & {
+  expose: Omit<TreeExpose<T>, "expandedKeys" | "selectedKeys" | "checkedKeys"> & {
     expandedKeys: Ref<TreeKey[]>;
     selectedKeys: Ref<TreeKey[]>;
     checkedKeys: Ref<TreeKey[]>;
@@ -1916,9 +1887,9 @@ declare function useTableQuery<T extends object, Q extends object = Record<strin
       validateRowKeys?: boolean;
       edit?: boolean | EditMode | EditConfig<T> | undefined;
       actions?: SimpleTableActions<T> | undefined;
-      expand?: boolean | ExpandConfig$1<T> | undefined;
-      selection?: boolean | SelectionConfig$1<T> | undefined;
-      dynamicRows?: boolean | DynamicRowsOptions<T> | undefined;
+      expand?: boolean | ExpandConfig$1<T, unknown> | undefined;
+      selection?: boolean | SelectionConfig$1<T, unknown> | undefined;
+      dynamicRows?: DynamicRowsOptions<T> | (string extends keyof T ? boolean : false) | undefined;
       toolbar?: ToolbarConfig;
       display?: DisplayConfig;
       virtualScroll?: VirtualScrollConfig | boolean;
@@ -1964,9 +1935,9 @@ declare function useTableQuery<T extends object, Q extends object = Record<strin
       validateRowKeys?: boolean;
       edit?: boolean | EditMode | EditConfig<T> | undefined;
       actions?: SimpleTableActions<T> | undefined;
-      expand?: boolean | ExpandConfig$1<T> | undefined;
-      selection?: boolean | SelectionConfig$1<T> | undefined;
-      dynamicRows?: boolean | DynamicRowsOptions<T> | undefined;
+      expand?: boolean | ExpandConfig$1<T, unknown> | undefined;
+      selection?: boolean | SelectionConfig$1<T, unknown> | undefined;
+      dynamicRows?: DynamicRowsOptions<T> | (string extends keyof T ? boolean : false) | undefined;
       toolbar?: ToolbarConfig;
       display?: DisplayConfig;
       virtualScroll?: VirtualScrollConfig | boolean;
@@ -1985,4 +1956,4 @@ declare function useTableQuery<T extends object, Q extends object = Record<strin
   cancel: () => void;
 };
 //#endregion
-export { PaginationConfig as $, printPresets as $t, HighlightPluginOptions as A, resolveConfig as At, defineTableColumns as B, useTableGlobalConfig as Bt, TreeNodeData as C, SelectionConfig$1 as Ct, TreeSlots as D, TreeConfig as Dt, TreeRenderContext as E, ToolbarConfig as Et, useCellEdit as F, FormatterType as Ft, BuiltInTableColumn as G, RowDragConfig as Gt, validateTableRowKeys as H, UseCrossPageSelectionOptions as Ht, usePagination as I, TABLE_GLOBAL_CONFIG_KEY as It, CustomAction as J, useRowDrag as Jt, ChildSelectionState as K, UseRowDragOptions as Kt, useTableActions as L, TableGlobalConfig as Lt, setupHighlight as M, exportTableData as Mt, useHighlight as N, ColumnFormatter as Nt, TreeUpdateMeta as O, VirtualScrollConfig as Ot, useModalEdit as P, FormatterConfig as Pt, NormalTableColumn as Q, PrintWatermarkOptions as Qt, useTableExpand as R, applyFormatter as Rt, TreeNativeProps as S, ExpandConfig$1 as St, TreeProps$1 as T, TableConfig as Tt, _default$1 as U, UseCrossPageSelectionReturn as Ut, defineTableConfig as V, CrossPageSelectionConfig as Vt, ApiFunction as W, useCrossPageSelection as Wt, EditMode as X, DynamicRowsReturn as Xt, DataRecord as Y, DynamicRowsOptions as Yt, MaybeRefLike as Z, useDynamicRows as Zt, StatusType as _, ColumnDragConfig as _t, getItem as a, StrictTableColumn as at, TreeKey as b, EditConfig as bt, setItem as c, TableInstance as ct, _default as d, TableRowKeyIssue as dt, usePrintWatermark as en, ParentChildLinkMode as et, ActionConfig as f, UseTableExpandOptions as ft, StatusConfig as g, BatchActionsConfig as gt, IconConfig as h, useRowEdit as ht, useTableQuery as i, COMPONENT_LOCALE_KEY as in, SimpleTableActions as it, createHighlight as j, ExportConfig as jt, HighlightAPI as k, createEditModeChecker as kt, useTreeOperations as l, TableProps as lt, DropInfo as m, useTableManager as mt, TableQueryResult as n, useComponentLocale as nn, RowAction as nt, removeAllItem as o, TableColumn as ot, ButtonType as p, UseTableExpandReturn as pt, ColumnWithKey as q, UseRowDragReturn as qt, UseTableQueryOptions as r, COMPONENT_FEEDBACK_KEY as rn, SelectOption as rt, removeItem as s, TableEmits as st, TableQueryContext as t, useComponentFeedback as tn, RenderFunction as tt, presetConfigs as u, TableRowKey as ut, TreeEmits as v, CrudBinding as vt, TreeOption$1 as w, SummaryConfig as wt, TreeMode as x, ErrorConfig as xt, TreeExpose as y, DisplayConfig as yt, useTableColumns as z, mergeGlobalConfig as zt };
+export { MaybeRefLike as $, PrintWatermarkOptions as $t, HighlightPluginOptions as A, createEditModeChecker as At, useRowEdit as B, mergeGlobalConfig as Bt, TreeNodeData as C, ExpandConfig$1 as Ct, TreeSlots as D, ToolbarConfig as Dt, TreeRenderContext as E, TableConfig as Et, useCellEdit as F, FormatterConfig as Ft, _default$1 as G, useCrossPageSelection as Gt, defineTableColumns as H, CrossPageSelectionConfig as Ht, usePagination as I, FormatterType as It, ChildSelectionState as J, UseRowDragReturn as Jt, ApiFunction as K, RowDragConfig as Kt, useTableActions as L, TABLE_GLOBAL_CONFIG_KEY as Lt, setupHighlight as M, ExportConfig as Mt, useHighlight as N, exportTableData as Nt, TreeUpdateMeta as O, TreeConfig as Ot, useModalEdit as P, ColumnFormatter as Pt, EditMode as Q, useDynamicRows as Qt, useTableExpand as R, TableGlobalConfig as Rt, TreeNativeProps as S, ErrorConfig as St, TreeProps$1 as T, SummaryConfig as Tt, defineTableConfig as U, UseCrossPageSelectionOptions as Ut, useTableColumns as V, useTableGlobalConfig as Vt, validateTableRowKeys as W, UseCrossPageSelectionReturn as Wt, CustomAction as X, DynamicRowsOptions as Xt, ColumnWithKey as Y, useRowDrag as Yt, DataRecord as Z, DynamicRowsReturn as Zt, StatusType as _, BatchActionsConfig as _t, getItem as a, COMPONENT_LOCALE_KEY as an, SelectOption as at, TreeKey as b, DisplayConfig as bt, setItem as c, TableColumn as ct, _default as d, TableManagerApi as dt, printPresets as en, NormalTableColumn as et, ActionConfig as f, TableProps as ft, StatusConfig as g, UseTableExpandReturn as gt, IconConfig as h, UseTableExpandOptions as ht, useTableQuery as i, COMPONENT_FEEDBACK_KEY as in, RowAction as it, createHighlight as j, resolveConfig as jt, HighlightAPI as k, VirtualScrollConfig as kt, useTreeOperations as l, TableEmits as lt, DropInfo as m, TableRowKeyIssue as mt, TableQueryResult as n, useComponentFeedback as nn, ParentChildLinkMode as nt, removeAllItem as o, SimpleTableActions as ot, ButtonType as p, TableRowKey as pt, BuiltInTableColumn as q, UseRowDragOptions as qt, UseTableQueryOptions as r, useComponentLocale as rn, RenderFunction as rt, removeItem as s, StrictTableColumn as st, TableQueryContext as t, usePrintWatermark as tn, PaginationConfig as tt, presetConfigs as u, TableInstance as ut, TreeEmits as v, ColumnDragConfig as vt, TreeOption$1 as w, SelectionConfig$1 as wt, TreeMode as x, EditConfig as xt, TreeExpose as y, CrudBinding as yt, useTableManager as z, applyFormatter as zt };