@robot-admin/naive-ui-components 0.17.3 → 0.17.5

package/dist/useTableQuery.d.ts

@@ -278,6 +278,67 @@ interface UseCrossPageSelectionReturn<T extends object = DataRecord> {
 /** 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. */
@@ -582,118 +643,296 @@ declare const createEditModeChecker: (config: ResolvedConfig) => {
   isCellEditMode: () => boolean;
 };
 //#endregion
-//#region src/components/C_Table/composables/useTableGlobalConfig.d.ts
-type FormatterType = 'date' | 'datetime' | 'currency' | 'percent' | 'enum' | 'number';
-interface FormatterConfig {
-  /** 日期格式 */
-  date?: {
-    format?: string;
-  };
-  /** 日期时间格式 */
-  datetime?: {
-    format?: string;
-  };
-  /** 货币格式 */
-  currency?: {
-    prefix?: string;
-    suffix?: string;
-    precision?: number;
-  };
-  /** 百分比格式 */
-  percent?: {
-    precision?: number;
-    suffix?: string;
-  };
-  /** 数字格式（千分位） */
-  number?: {
-    precision?: number;
-  };
-}
-/** 列级 formatter 配置 */
-interface ColumnFormatter {
-  type: FormatterType;
-  /** enum mapping：{ male: '男', female: '女' } */
-  mapping?: Record<string, string>;
-  /** 自定义格式化函数（优先级最高） */
-  fn?: (value: unknown, row: DataRecord) => string;
-  /** 覆盖全局格式配置 */
-  config?: Record<string, unknown>;
+//#region src/components/C_Table/composables/useRowEdit.d.ts
+/** 行级校验错误 */
+interface RowValidationError {
+  field: string;
+  message: string;
 }
-interface TableGlobalConfig {
-  /** 任意 C_Table 配置的应用级默认值。 */
-  defaults?: TableConfig;
-  /** 表格显示默认值 */
-  display?: DisplayConfig;
-  /** 默认分页条数 */
-  pageSize?: number;
-  /** 空状态文案 */
-  emptyText?: string;
-  /** 全局格式化配置 */
-  formatter?: FormatterConfig;
-  /** 列配置持久化前缀 */
-  persistPrefix?: string;
-  /** 默认导出文件名 */
-  exportFilename?: 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 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;
+/**
+ * 可编辑行组合函数，提供表格整行的编辑功能
+ */
+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/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;
+//#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;
 }
-type EditMode = 'row' | 'cell' | 'both' | 'modal' | 'none';
-type EditType = 'input' | 'textarea' | 'select' | 'date' | 'number' | 'switch' | 'email' | 'mobile';
-type ButtonType$1 = '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;
+/**
+ * 表格管理器参数接口
+ */
+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>;
 }
-/** 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$1 | ((row: T, index: number) => ButtonType$1);
-  /** 点击事件处理器 */
-  onClick: (row: T, index: number) => void | Promise<void>;
-  /** 条件显示函数（可选） */
-  show?: (row: T, index: number) => boolean;
-  /** 是否禁用（可选） */
-  disabled?: (row: T, index: number) => boolean;
+/**
+ * 事件处理器接口
+ */
+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;
+} | 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$1 = '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$1 | ((row: T, index: number) => ButtonType$1);
+  /** 点击事件处理器 */
+  onClick: (row: T, index: number) => void | Promise<void>;
+  /** 条件显示函数（可选） */
+  show?: (row: T, index: number) => boolean;
+  /** 是否禁用（可选） */
+  disabled?: (row: T, index: number) => boolean;
   /** 按钮提示文本（可选） */
   tooltip?: string;
 }
@@ -871,6 +1110,7 @@ interface TableDisplayProps {
   singleLine?: boolean;
   size?: 'small' | 'medium' | 'large';
 }
+/** @deprecated 旧类型兼容；组件功能请使用 config.edit。 */
 interface TableEditProps<T extends object = DataRecord> {
   editable?: boolean;
   editMode?: EditMode;
@@ -881,6 +1121,7 @@ interface TableEditProps<T extends object = DataRecord> {
   modalWidth?: number;
   columnWidth?: number;
 }
+/** @deprecated 旧类型兼容；组件功能请使用 config.expand。 */
 interface TableExpandProps<T extends object = DataRecord, C = DataRecord> {
   expandable?: boolean;
   onLoadExpandData?: (row: T) => Promise<C[]> | C[];
@@ -888,6 +1129,7 @@ interface TableExpandProps<T extends object = DataRecord, C = DataRecord> {
   rowExpandable?: (row: T) => boolean;
   defaultExpandedKeys?: DataTableRowKey[];
 }
+/** @deprecated 旧类型兼容；组件功能请使用 config.selection。 */
 interface TableSelectionProps<T extends object = DataRecord, C = DataRecord> extends BaseConfig<T> {
   enableSelection?: boolean;
   defaultCheckedKeys?: DataTableRowKey[];
@@ -897,8 +1139,16 @@ interface TableSelectionProps<T extends object = DataRecord, C = DataRecord> ext
   enableParentChildLink?: boolean;
   parentChildLinkMode?: ParentChildLinkMode;
 }
-interface TableProps<T extends object = DataRecord, C = DataRecord> extends TableBaseProps<T>, TableDisplayProps, TableEditProps<T>, TableExpandProps<T, C>, TableSelectionProps<T, C> {
-  pagination?: PaginationConfig | boolean;
+interface TableProps<T extends object = DataRecord, C = DataRecord> extends Partial<TableBaseProps<T>>, TableDisplayProps, TableEditProps<T>, TableExpandProps<T, C>, TableSelectionProps<T, C> {
+  /** 功能配置的统一入口。 */
+  config?: TableConfig<T>;
+  /** 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'];
@@ -974,6 +1224,12 @@ interface TablePaginationMethods {
 }
 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'];
+  /** 此嵌套对象中的 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[]>;
@@ -1086,399 +1342,160 @@ declare const __VLS_export$1: <T extends object = DataRecord>(__VLS_props: NonNu
     printTable: (elementRef?: HTMLElement) => Promise<void>;
     downloadTableScreenshot: (elementRef?: HTMLElement, filename?: string) => Promise<void>;
     resetToFirstPage: () => void;
-    getTotalPages: () => number;
-    getSelectedRows: () => DataRecord[];
-    getEditingData: () => DataRecord | null | undefined;
-    isEditing: (rowKey: DataTableRowKey, columnKey?: string) => boolean;
-    isExpanded: (rowKey: DataTableRowKey) => boolean;
-    getManager: () => {
-      edit: {
-        start(rowKey: DataTableRowKey, columnKey?: string): void;
-        cancel(): void;
-        save(): Promise<void>;
-        isEditing(rowKey: DataTableRowKey, columnKey?: string): boolean;
-        getEditingData(): DataRecord | null | undefined;
-      };
-      expand: {
-        row(rowKey: DataTableRowKey): Promise<void>;
-        collapse(rowKey: DataTableRowKey): void;
-        toggle(rowKey: DataTableRowKey): Promise<void>;
-        all(): Promise<void>;
-        collapseAll(): void;
-        isExpanded(rowKey: DataTableRowKey): boolean;
-      };
-      selection: {
-        select(rowKey: DataTableRowKey): void;
-        unselect(rowKey: DataTableRowKey): void;
-        all(): void;
-        clear(): void;
-        isSelected(rowKey: DataTableRowKey): boolean;
-        getSelected(): DataRecord[];
-      };
-      childSelection: {
-        select(parentKey: DataTableRowKey, childKey: DataTableRowKey): void;
-        unselect(parentKey: DataTableRowKey, childKey: DataTableRowKey): void;
-        selectAll(parentKey: DataTableRowKey): void;
-        clear(parentKey: DataTableRowKey): void;
-        getSelected(parentKey: DataTableRowKey): DataRecord[];
-      };
-      dynamicRows: {
-        add(): void;
-        insert(): void;
-        delete(): void;
-        copy(): void;
-        moveUp(): void;
-        moveDown(): void;
-        clearSelection(): void;
-        getSelected(): DataRecord | null;
-        print(elementRef?: HTMLElement): Promise<void>;
-        download(elementRef?: HTMLElement, filename?: string): Promise<void>;
-      };
-      clearAllSelections(): void;
-    }; /** 导出数据 */
-    exportData: () => Promise<void>; /** 跨页选择 */
-    crossPageSelection: {
-      enabled: vue.ComputedRef<boolean>;
-      selectedKeys: vue.Ref<Set<DataTableRowKey>, Set<DataTableRowKey>>;
-      selectedCount: vue.ComputedRef<number>;
-      select: (key: DataTableRowKey) => boolean;
-      unselect: (key: DataTableRowKey) => void;
-      selectAll: () => void;
-      clearAll: () => void;
-      getSelectedRows: () => DataRecord[];
-    };
-  }>) => void;
-  attrs: any;
-  slots: {
-    'toolbar-left'?: (props: {}) => any;
-  } & {
-    'toolbar-right'?: (props: {}) => any;
-  } & {
-    error?: (props: {
-      error: ErrorConfig;
-    }) => any;
-  } & {
-    loading?: (props: {}) => any;
-  };
-  emit: ((evt: "cancel", rowData: DataRecord, rowIndex: number) => void) & ((evt: "save", rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "pagination-change", ...args: [page: number, pageSize: number] & [page: number, pageSize: number]) => void) & ((evt: "row-delete", ...args: [deletedRow: DataRecord, index: number] & [deletedRow: DataRecord, index: number]) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<DataRecord>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: DataRecord | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: DataRecord[]) => void) & ((evt: "edit-error", error: unknown) => void) & ((evt: "row-add", newRow: DataRecord) => void) & ((evt: "row-copy", originalRow: DataRecord, newRow: DataRecord) => void) & ((evt: "row-move", row: DataRecord, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => void) & ((evt: "view-detail", data: DataRecord) => void) & ((evt: "column-change", columns: TableColumn[]) => void);
-}>) => vue.VNode & {
-  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
-};
-declare const _default$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] }) & {};
-//#endregion
-//#region src/components/C_Table/helpers.d.ts
-/** Type-safe identity helper that rejects misspelled business field keys. */
-declare function defineTableColumns<T extends object>(columns: StrictTableColumn<T>[]): StrictTableColumn<T>[];
-/** Preserve row types across edit, action, summary and batch callbacks. */
-declare function defineTableConfig<T extends object>(config: TableConfig<T>): TableConfig<T>;
-/** Find missing and duplicate row keys before stateful table features consume them. */
-declare function validateTableRowKeys<T extends object>(data: readonly T[], rowKey: (row: T) => DataTableRowKey | null | undefined): TableRowKeyIssue<T>[];
-//#endregion
-//#region src/components/C_Table/composables/useTableColumns.d.ts
-/** useTableColumns 中对 tableManager 的最小依赖接口 */
-interface TableManagerRef {
-  editStates: {
-    cellEdit: {
-      isEditingCell: (rowKey: DataTableRowKey, columnKey: string) => boolean;
-      getEditingCellValue: (rowKey: DataTableRowKey, columnKey: string) => unknown;
-      updateEditingCellValue: (rowKey: DataTableRowKey, columnKey: string, value: unknown) => void;
-      saveEditCell: () => Promise<unknown>;
-      cancelEditCell: () => void;
-      startEditCell: (rowKey: DataTableRowKey, columnKey: string) => void;
-    };
-    rowEdit: {
-      isEditingRow: (rowKey: DataTableRowKey) => boolean;
-      getEditingRowData: (rowKey: DataTableRowKey) => DataRecord | undefined;
-      updateEditingRowData: (rowKey: DataTableRowKey, field: string, value: unknown) => void;
-    };
-  };
-  dynamicRowsState?: {
-    enhanceColumns: (columns: TableColumn[]) => TableColumn[];
-  } | null;
-  expandState?: {
-    getTableColumns: (originalColumns: TableColumn[]) => DataTableColumn[];
-  } | null;
-}
-/**
- * 渲染编辑组件（行编辑/单元格编辑通用）
- */
-interface UseTableColumnsOptions {
-  /** 原始列配置 */
-  rawColumns: ComputedRef<TableColumn[]>;
-  /** 统一配置 */
-  config: ComputedRef<ResolvedConfig>;
-  /** 默认列宽 */
-  columnWidth: number;
-  /** 区分使用侧显式统一列宽与内部默认值，不把默认值强加给弹性业务列。 */
-  columnWidthExplicit?: boolean;
-  /** 用户设定的 scrollX */
-  scrollX?: number | string;
-  /** 行键获取函数 */
-  rowKey: (row: DataRecord) => DataTableRowKey;
-  /** 表格管理器 */
-  tableManager: TableManagerRef;
-  /** 操作列渲染函数 */
-  actionsRenderer: (row: DataRecord, index: number) => VNodeChild;
-  /** 编辑模式检查器 */
-  editModeChecker: ComputedRef<{
-    isNonEditable: (column: TableColumn) => boolean;
-    isRowEditMode: () => boolean;
-    isCellEditMode: () => boolean;
-  }>;
-  /** 是否渲染操作列 */
-  showActionsColumn: ComputedRef<boolean>;
-}
-interface UseTableColumnsReturn {
-  reactiveColumns: Ref<TableColumn[]>;
-  showSettingsPanel: Ref<boolean>;
-  computedColumns: ComputedRef<DataTableColumn[]>;
-  computedScrollX: ComputedRef<number | string | undefined>;
-  handleColumnChange: (columns: TableColumn[]) => void;
-}
-/**
- * 表格列处理引擎
- */
-declare function useTableColumns(options: UseTableColumnsOptions): UseTableColumnsReturn;
-//#endregion
-//#region src/components/C_Table/composables/useRowEdit.d.ts
-/** 行级校验错误 */
-interface RowValidationError {
-  field: string;
-  message: string;
-}
-/**
- * 行编辑配置选项
- */
-interface RowEditOptions {
-  data: () => DataRecord[];
-  rowKey: (row: DataRecord) => DataTableRowKey;
-  onSave?: (rowData: DataRecord, rowIndex: number, 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;
+    getTotalPages: () => number;
+    getSelectedRows: () => DataRecord[];
+    getEditingData: () => DataRecord | null | undefined;
+    isEditing: (rowKey: DataTableRowKey, columnKey?: string) => boolean;
+    isExpanded: (rowKey: DataTableRowKey) => boolean;
+    getManager: () => {
+      edit: {
+        start(rowKey: DataTableRowKey, columnKey?: string): void;
+        cancel(): void;
+        save(): Promise<void>;
+        isEditing(rowKey: DataTableRowKey, columnKey?: string): boolean;
+        getEditingData(): DataRecord | null | undefined;
+      };
+      expand: {
+        row(rowKey: DataTableRowKey): Promise<void>;
+        collapse(rowKey: DataTableRowKey): void;
+        toggle(rowKey: DataTableRowKey): Promise<void>;
+        all(): Promise<void>;
+        collapseAll(): void;
+        isExpanded(rowKey: DataTableRowKey): boolean;
+      };
+      selection: {
+        select(rowKey: DataTableRowKey): void;
+        unselect(rowKey: DataTableRowKey): void;
+        all(): void;
+        clear(): void;
+        isSelected(rowKey: DataTableRowKey): boolean;
+        getSelected(): DataRecord[];
+      };
+      childSelection: {
+        select(parentKey: DataTableRowKey, childKey: DataTableRowKey): void;
+        unselect(parentKey: DataTableRowKey, childKey: DataTableRowKey): void;
+        selectAll(parentKey: DataTableRowKey): void;
+        clear(parentKey: DataTableRowKey): void;
+        getSelected(parentKey: DataTableRowKey): DataRecord[];
+      };
+      dynamicRows: {
+        add(): void;
+        insert(): void;
+        delete(): void;
+        copy(): void;
+        moveUp(): void;
+        moveDown(): void;
+        clearSelection(): void;
+        getSelected(): DataRecord | null;
+        print(elementRef?: HTMLElement): Promise<void>;
+        download(elementRef?: HTMLElement, filename?: string): Promise<void>;
+      };
+      clearAllSelections(): void;
+    }; /** 导出数据 */
+    exportData: () => Promise<void>; /** 跨页选择 */
+    crossPageSelection: {
+      enabled: vue.ComputedRef<boolean>;
+      selectedKeys: vue.Ref<Set<DataTableRowKey>, Set<DataTableRowKey>>;
+      selectedCount: vue.ComputedRef<number>;
+      select: (key: DataTableRowKey) => boolean;
+      unselect: (key: DataTableRowKey) => void;
+      selectAll: () => void;
+      clearAll: () => void;
+      getSelectedRows: () => DataRecord[];
     };
+  }>) => void;
+  attrs: any;
+  slots: {
+    'toolbar-left'?: (props: {}) => any;
+  } & {
+    'toolbar-right'?: (props: {}) => any;
+  } & {
+    error?: (props: {
+      error: ErrorConfig;
+    }) => any;
+  } & {
+    loading?: (props: {}) => any;
+  };
+  emit: ((evt: "cancel", rowData: DataRecord, rowIndex: number) => void) & ((evt: "save", rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => void) & ((evt: "pagination-change", ...args: [page: number, pageSize: number] & [page: number, pageSize: number]) => void) & ((evt: "row-delete", ...args: [deletedRow: DataRecord, index: number] & [deletedRow: DataRecord, index: number]) => void) & ((evt: "batch-action-error", error: unknown, actionKey: string) => void) & ((evt: "row-key-error", issues: TableRowKeyIssue<DataRecord>[]) => void) & ((evt: "expand-change", expandedKeys: DataTableRowKey[], row?: DataRecord | undefined, expanded?: boolean | undefined) => void) & ((evt: "selection-change", checkedKeys: DataTableRowKey[], checkedRows: DataRecord[], childSelections?: Map<DataTableRowKey, DataTableRowKey[]> | undefined) => void) & ((evt: "child-selection-change", parentKey: DataTableRowKey, childKeys: DataTableRowKey[], childRows: DataRecord[]) => void) & ((evt: "parent-child-link-change", parentKey: DataTableRowKey, shouldSelect: boolean) => void) & ((evt: "update:data", data: DataRecord[]) => void) & ((evt: "edit-error", error: unknown) => void) & ((evt: "row-add", newRow: DataRecord) => void) & ((evt: "row-copy", originalRow: DataRecord, newRow: DataRecord) => void) & ((evt: "row-move", row: DataRecord, fromIndex: number, toIndex: number) => void) & ((evt: "row-selection-change", selectedKey: DataTableRowKey | null, selectedRow: DataRecord | null) => void) & ((evt: "view-detail", data: DataRecord) => void) & ((evt: "column-change", columns: TableColumn[]) => void);
+}>) => vue.VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default$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] }) & {};
+//#endregion
+//#region src/components/C_Table/helpers.d.ts
+/** Type-safe identity helper that rejects misspelled business field keys. */
+declare function defineTableColumns<T extends object>(columns: StrictTableColumn<T>[]): StrictTableColumn<T>[];
+/** Preserve row types across edit, action, summary and batch callbacks. */
+declare function defineTableConfig<T extends object>(config: TableConfig<T>): TableConfig<T>;
+/** Find missing and duplicate row keys before stateful table features consume them. */
+declare function validateTableRowKeys<T extends object>(data: readonly T[], rowKey: (row: T) => DataTableRowKey | null | undefined): TableRowKeyIssue<T>[];
+//#endregion
+//#region src/components/C_Table/composables/useTableColumns.d.ts
+/** useTableColumns 中对 tableManager 的最小依赖接口 */
+interface TableManagerRef {
+  editStates: {
     cellEdit: {
-      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;
+      saveEditCell: () => Promise<unknown>;
+      cancelEditCell: () => void;
+      startEditCell: (rowKey: DataTableRowKey, columnKey: string) => 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;
+    rowEdit: {
       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[];
+      getEditingRowData: (rowKey: DataTableRowKey) => DataRecord | undefined;
+      updateEditingRowData: (rowKey: DataTableRowKey, field: string, value: unknown) => void;
     };
-    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;
-};
+  dynamicRowsState?: {
+    enhanceColumns: (columns: TableColumn[]) => TableColumn[];
+  } | null;
+  expandState?: {
+    getTableColumns: (originalColumns: TableColumn[]) => DataTableColumn[];
+  } | null;
+}
+/**
+ * 渲染编辑组件（行编辑/单元格编辑通用）
+ */
+interface UseTableColumnsOptions {
+  /** 原始列配置 */
+  rawColumns: ComputedRef<TableColumn[]>;
+  /** 统一配置 */
+  config: ComputedRef<ResolvedConfig>;
+  /** 默认列宽 */
+  columnWidth: number;
+  /** 区分使用侧显式统一列宽与内部默认值，不把默认值强加给弹性业务列。 */
+  columnWidthExplicit?: boolean;
+  /** 用户设定的 scrollX */
+  scrollX?: number | string;
+  /** 行键获取函数 */
+  rowKey: (row: DataRecord) => DataTableRowKey;
+  /** 表格管理器 */
+  tableManager: TableManagerRef;
+  /** 操作列渲染函数 */
+  actionsRenderer: (row: DataRecord, index: number) => VNodeChild;
+  /** 编辑模式检查器 */
+  editModeChecker: ComputedRef<{
+    isNonEditable: (column: TableColumn) => boolean;
+    isRowEditMode: () => boolean;
+    isCellEditMode: () => boolean;
+  }>;
+  /** 是否渲染操作列 */
+  showActionsColumn: ComputedRef<boolean>;
+}
+interface UseTableColumnsReturn {
+  reactiveColumns: Ref<TableColumn[]>;
+  showSettingsPanel: Ref<boolean>;
+  computedColumns: ComputedRef<DataTableColumn[]>;
+  computedScrollX: ComputedRef<number | string | undefined>;
+  handleColumnChange: (columns: TableColumn[]) => void;
+}
+/**
+ * 表格列处理引擎
+ */
+declare function useTableColumns(options: UseTableColumnsOptions): UseTableColumnsReturn;
 //#endregion
 //#region src/components/C_Table/composables/useTableExpand.d.ts
 /**
@@ -1711,9 +1728,10 @@ interface TreeExpose {
   getCheckedData: TreeInst['getCheckedData'];
   getIndeterminateData: TreeInst['getIndeterminateData'];
   scrollTo: TreeInst['scrollTo'];
-  expandedKeys: Ref<TreeKey[]>;
-  selectedKeys: Ref<TreeKey[]>;
-  checkedKeys: Ref<TreeKey[]>;
+  /** Vue 公开实例会解包顶层 Ref；这些属性直接读取数组。 */
+  expandedKeys: TreeKey[];
+  selectedKeys: TreeKey[];
+  checkedKeys: TreeKey[];
 }
 interface TreeEmits {
   'update:searchPattern': [pattern: string];
@@ -1737,38 +1755,42 @@ interface TreeSlots {
 //#endregion
 //#region src/components/C_Tree/index.vue.d.ts
 type __VLS_Slots = TreeSlots;
-declare const __VLS_base: vue.DefineComponent<TreeProps$1, TreeExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  add: (parentNode?: TreeNodeData | undefined) => any;
+declare const __VLS_base: vue.DefineComponent<TreeProps$1, Omit<TreeExpose, "expandedKeys" | "checkedKeys" | "selectedKeys"> & {
+  expandedKeys: vue.Ref<TreeKey[]>;
+  selectedKeys: vue.Ref<TreeKey[]>;
+  checkedKeys: vue.Ref<TreeKey[]>;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   refresh: () => any;
-  "load-error": (error: unknown, node: TreeOption$1) => any;
-  "update:expandedKeys": (keys: TreeKey[], options: (TreeOption$1 | null)[], meta: TreeUpdateMeta) => any;
+  add: (parentNode?: TreeNodeData | undefined) => any;
   "node-drop": (info: DropInfo) => 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;
+  "load-error": (error: unknown, node: TreeOption$1) => any;
 }, string, vue.PublicProps, Readonly<TreeProps$1> & Readonly<{
-  onAdd?: ((parentNode?: TreeNodeData | undefined) => any) | undefined;
   onRefresh?: (() => any) | undefined;
-  "onLoad-error"?: ((error: unknown, node: TreeOption$1) => any) | undefined;
-  "onUpdate:expandedKeys"?: ((keys: TreeKey[], options: (TreeOption$1 | null)[], meta: TreeUpdateMeta) => any) | undefined;
+  onAdd?: ((parentNode?: TreeNodeData | undefined) => any) | undefined;
   "onNode-drop"?: ((info: DropInfo) => 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;
+  "onLoad-error"?: ((error: unknown, node: TreeOption$1) => any) | undefined;
 }>, {
+  density: ComponentDensity;
   mode: TreeMode;
-  showToolbar: boolean;
-  addable: boolean;
   draggable: boolean;
-  density: ComponentDensity;
+  showToolbar: boolean;
   defaultExpandAll: boolean;
   showLine: boolean;
   searchable: boolean;
   searchPlaceholder: string;
+  addable: boolean;
   addText: string;
   refreshable: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
@@ -1787,7 +1809,7 @@ declare const presetConfigs: Record<TreeMode, Partial<TreeProps$1>>;
 type EmitFn = <E extends keyof TreeEmits>(event: E, ...args: TreeEmits[E]) => void;
 /** State coordination only; checking, filtering, keyboard and loading stay native. */
 declare function useTreeOperations(props: TreeProps$1, emit: EmitFn, slots?: TreeSlots): {
-  internalSearchPattern: vue.Ref<string, string>;
+  internalSearchPattern: Ref<string, string>;
   expandedKeys: vue.WritableComputedRef<TreeKey[], TreeKey[]>;
   selectedKeys: vue.WritableComputedRef<TreeKey[], TreeKey[]>;
   checkedKeys: vue.WritableComputedRef<TreeKey[], TreeKey[]>;
@@ -1813,7 +1835,11 @@ declare function useTreeOperations(props: TreeProps$1, emit: EmitFn, slots?: Tre
   handleDrop: (info: DropInfo) => void;
   handleAdd: () => void;
   handleRefresh: () => void;
-  expose: TreeExpose;
+  expose: Omit<TreeExpose, "expandedKeys" | "checkedKeys" | "selectedKeys"> & {
+    expandedKeys: Ref<TreeKey[]>;
+    selectedKeys: Ref<TreeKey[]>;
+    checkedKeys: Ref<TreeKey[]>;
+  };
 };
 //#endregion
 //#region src/utils/storage.d.ts
@@ -1957,4 +1983,4 @@ declare function useTableQuery<T extends object, Q extends object = Record<strin
   cancel: () => void;
 };
 //#endregion
-export { MaybeRefLike as $, printPresets as $t, HighlightPluginOptions as A, ExpandConfig$1 as At, useRowEdit as B, exportTableData as Bt, TreeNodeData as C, useTableGlobalConfig as Ct, TreeSlots as D, DisplayConfig as Dt, TreeRenderContext as E, CrudBinding as Et, useCellEdit as F, TreeConfig as Ft, _default$1 as G, RowDragConfig as Gt, defineTableColumns as H, UseCrossPageSelectionOptions as Ht, usePagination as I, VirtualScrollConfig as It, ChildSelectionState as J, useRowDrag as Jt, ApiFunction as K, UseRowDragOptions as Kt, useTableActions as L, createEditModeChecker as Lt, setupHighlight as M, SummaryConfig as Mt, useHighlight as N, TableConfig as Nt, TreeUpdateMeta as O, EditConfig as Ot, useModalEdit as P, ToolbarConfig as Pt, EditMode as Q, PrintWatermarkOptions as Qt, useTableExpand as R, resolveConfig as Rt, TreeNativeProps as S, mergeGlobalConfig as St, TreeProps$1 as T, ColumnDragConfig as Tt, defineTableConfig as U, UseCrossPageSelectionReturn as Ut, useTableColumns as V, CrossPageSelectionConfig as Vt, validateTableRowKeys as W, useCrossPageSelection as Wt, CustomAction as X, DynamicRowsReturn as Xt, ColumnWithKey as Y, DynamicRowsOptions as Yt, DataRecord as Z, useDynamicRows as Zt, StatusType as _, FormatterConfig as _t, getItem as a, SelectOption as at, TreeKey as b, TableGlobalConfig as bt, setItem as c, TableColumn as ct, _default as d, TableProps as dt, usePrintWatermark as en, NormalTableColumn as et, ActionConfig as f, TableRowKey as ft, StatusConfig as g, ColumnFormatter as gt, IconConfig as h, UseTableExpandReturn as ht, useTableQuery as i, COMPONENT_LOCALE_KEY as in, RowAction as it, createHighlight as j, SelectionConfig$1 as jt, HighlightAPI as k, ErrorConfig as kt, useTreeOperations as l, TableEmits as lt, DropInfo as m, UseTableExpandOptions as mt, TableQueryResult as n, useComponentLocale as nn, ParentChildLinkMode as nt, removeAllItem as o, SimpleTableActions as ot, ButtonType as p, TableRowKeyIssue as pt, BuiltInTableColumn as q, UseRowDragReturn as qt, UseTableQueryOptions as r, COMPONENT_FEEDBACK_KEY as rn, RenderFunction as rt, removeItem as s, StrictTableColumn as st, TableQueryContext as t, useComponentFeedback as tn, PaginationConfig as tt, presetConfigs as u, TableInstance as ut, TreeEmits as v, FormatterType as vt, TreeOption$1 as w, BatchActionsConfig as wt, TreeMode as x, applyFormatter as xt, TreeExpose as y, TABLE_GLOBAL_CONFIG_KEY as yt, useTableManager as z, ExportConfig as zt };
+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 };