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

package/dist/useTableQuery.d.cts

@@ -452,9 +452,9 @@ 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;
 }
@@ -545,7 +545,7 @@ interface ErrorConfig {
   /** 错误描述文案 */
   message?: string;
   /** 重试回调 */
-  onRetry?: () => void | Promise<void>;
+  onRetry?: () => unknown;
 }
 /** 批量操作配置 */
 interface BatchActionsConfig<T extends object = DataRecord> {
@@ -560,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 {
@@ -694,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;
   /** 是否禁用（可选） */
@@ -861,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;
@@ -876,36 +870,13 @@ 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, C>;
   /** CRUD 模式自动提供 columns / data / loading，可省略对应属性。 */
@@ -914,13 +885,15 @@ interface TableProps<T extends object = DataRecord, C = DataRecord> extends Part
   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];
 }
@@ -1091,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;
 }
 /**
@@ -1110,21 +1083,9 @@ type ColumnWithKey = TableColumn & {
 //#endregion
 //#region src/components/C_Table/index.vue.d.ts
 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<{
-    /** 根容器 class；普通 class/style 仍按既有契约转发到 NDataTable。 */wrapperClass?: vue.HTMLAttributes["class"]; /** 填满已确定高度的根容器，并为工具栏和分页预留空间。 */
-    flexHeight?: boolean; /** 原生横向虚拟滚动；未声明业务列宽时仍提供可计算的数值兜底。 */
-    virtualScrollX?: boolean; /** 列配置（crud 模式下可省略） */
-    columns?: TableColumn<T>[]; /** 数据源（crud 模式下可省略） */
-    data?: MaybeRefLike<T[]>; /** 加载状态 */
-    loading?: MaybeRefLike<boolean>; /** 行唯一键 */
-    rowKey?: TableRowKey<T>; /** 统一功能配置（edit / selection / expand / pagination / dynamicRows / toolbar / display） */
-    config?: TableConfig<T, C>; /** 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>;
-  } & {
-    onCancel?: ((rowData: T, rowIndex: number) => any) | undefined;
+  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;
@@ -1157,7 +1118,7 @@ declare const __VLS_export$1: <T extends object = DataRecord, C = unknown>(__VLS
   } & {
     loading?: (props: {}) => any;
   };
-  emit: ((evt: "cancel", rowData: T, rowIndex: number) => void) & ((evt: "save", rowData: T, rowIndex: number, columnKey?: string | undefined) => 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);
+  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>>;
 };
@@ -1252,8 +1213,8 @@ interface RowValidationError {
 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>;
+  onSave?: (rowData: DataRecord, rowIndex: number, originalKey?: DataTableRowKey) => unknown;
+  onCancel?: (rowData: DataRecord, rowIndex: number) => unknown;
   /** 列配置（用于提取校验规则） */
   columns?: () => TableColumn[];
 }
@@ -1297,8 +1258,8 @@ interface TableManagerConfig {
   showRowActions: boolean;
   modalTitle: string;
   modalWidth: number;
-  onEditSave?: (rowData: DataRecord, rowIndex: number, columnKey?: string) => void | Promise<void>;
-  onEditCancel?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
+  onEditSave?: (rowData: DataRecord, rowIndex: number, columnKey?: string) => unknown;
+  onEditCancel?: (rowData: DataRecord, rowIndex: number) => unknown;
   onEditError?: (error: unknown) => void;
   expandable: boolean;
   defaultExpandedKeys?: DataTableRowKey[];
@@ -1520,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[];
 }
@@ -1562,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>): {
@@ -1789,16 +1750,16 @@ interface TreeSlots<T extends object = TreeOption$1> {
 //#region src/components/C_Tree/index.vue.d.ts
 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> & {
-    onAdd?: ((parentNode?: T | undefined) => any) | undefined;
     onRefresh?: (() => any) | undefined;
-    "onUpdate:expandedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => 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" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => any) | undefined;
-    "onUpdate:checkedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => 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;
-    "onLoad-error"?: ((error: unknown, node: T) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
@@ -1809,7 +1770,7 @@ declare const __VLS_export: <T extends object = TreeNodeData>(__VLS_props: NonNu
   }>) => void;
   attrs: any;
   slots: TreeSlots<T>;
-  emit: ((evt: "add", parentNode?: T | undefined) => void) & ((evt: "refresh") => void) & ((evt: "update:expandedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => void) & ((evt: "update:searchPattern", pattern: string) => void) & ((evt: "update:selectedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => void) & ((evt: "update:checkedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "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) & ((evt: "load-error", error: unknown, node: T) => void);
+  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>>;
 };

package/dist/useTableQuery.d.ts

@@ -452,9 +452,9 @@ 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;
 }
@@ -545,7 +545,7 @@ interface ErrorConfig {
   /** 错误描述文案 */
   message?: string;
   /** 重试回调 */
-  onRetry?: () => void | Promise<void>;
+  onRetry?: () => unknown;
 }
 /** 批量操作配置 */
 interface BatchActionsConfig<T extends object = DataRecord> {
@@ -560,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 {
@@ -694,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;
   /** 是否禁用（可选） */
@@ -861,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;
@@ -876,36 +870,13 @@ 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, C>;
   /** CRUD 模式自动提供 columns / data / loading，可省略对应属性。 */
@@ -914,13 +885,15 @@ interface TableProps<T extends object = DataRecord, C = DataRecord> extends Part
   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];
 }
@@ -1091,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;
 }
 /**
@@ -1110,21 +1083,9 @@ type ColumnWithKey = TableColumn & {
 //#endregion
 //#region src/components/C_Table/index.vue.d.ts
 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<{
-    /** 根容器 class；普通 class/style 仍按既有契约转发到 NDataTable。 */wrapperClass?: vue.HTMLAttributes["class"]; /** 填满已确定高度的根容器，并为工具栏和分页预留空间。 */
-    flexHeight?: boolean; /** 原生横向虚拟滚动；未声明业务列宽时仍提供可计算的数值兜底。 */
-    virtualScrollX?: boolean; /** 列配置（crud 模式下可省略） */
-    columns?: TableColumn<T>[]; /** 数据源（crud 模式下可省略） */
-    data?: MaybeRefLike<T[]>; /** 加载状态 */
-    loading?: MaybeRefLike<boolean>; /** 行唯一键 */
-    rowKey?: TableRowKey<T>; /** 统一功能配置（edit / selection / expand / pagination / dynamicRows / toolbar / display） */
-    config?: TableConfig<T, C>; /** 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>;
-  } & {
-    onCancel?: ((rowData: T, rowIndex: number) => any) | undefined;
+  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;
@@ -1157,7 +1118,7 @@ declare const __VLS_export$1: <T extends object = DataRecord, C = unknown>(__VLS
   } & {
     loading?: (props: {}) => any;
   };
-  emit: ((evt: "cancel", rowData: T, rowIndex: number) => void) & ((evt: "save", rowData: T, rowIndex: number, columnKey?: string | undefined) => 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);
+  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>>;
 };
@@ -1252,8 +1213,8 @@ interface RowValidationError {
 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>;
+  onSave?: (rowData: DataRecord, rowIndex: number, originalKey?: DataTableRowKey) => unknown;
+  onCancel?: (rowData: DataRecord, rowIndex: number) => unknown;
   /** 列配置（用于提取校验规则） */
   columns?: () => TableColumn[];
 }
@@ -1297,8 +1258,8 @@ interface TableManagerConfig {
   showRowActions: boolean;
   modalTitle: string;
   modalWidth: number;
-  onEditSave?: (rowData: DataRecord, rowIndex: number, columnKey?: string) => void | Promise<void>;
-  onEditCancel?: (rowData: DataRecord, rowIndex: number) => void | Promise<void>;
+  onEditSave?: (rowData: DataRecord, rowIndex: number, columnKey?: string) => unknown;
+  onEditCancel?: (rowData: DataRecord, rowIndex: number) => unknown;
   onEditError?: (error: unknown) => void;
   expandable: boolean;
   defaultExpandedKeys?: DataTableRowKey[];
@@ -1520,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[];
 }
@@ -1562,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>): {
@@ -1789,16 +1750,16 @@ interface TreeSlots<T extends object = TreeOption$1> {
 //#region src/components/C_Tree/index.vue.d.ts
 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> & {
-    onAdd?: ((parentNode?: T | undefined) => any) | undefined;
     onRefresh?: (() => any) | undefined;
-    "onUpdate:expandedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => 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" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => any) | undefined;
-    "onUpdate:checkedKeys"?: ((keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => 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;
-    "onLoad-error"?: ((error: unknown, node: T) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
@@ -1809,7 +1770,7 @@ declare const __VLS_export: <T extends object = TreeNodeData>(__VLS_props: NonNu
   }>) => void;
   attrs: any;
   slots: TreeSlots<T>;
-  emit: ((evt: "add", parentNode?: T | undefined) => void) & ((evt: "refresh") => void) & ((evt: "update:expandedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => void) & ((evt: "update:searchPattern", pattern: string) => void) & ((evt: "update:selectedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "unselect" | "check" | "uncheck">) => void) & ((evt: "update:checkedKeys", keys: TreeKey[], options: (T | null)[], meta: TreeUpdateMeta<T, "filter" | "select" | "expand" | "collapse" | "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) & ((evt: "load-error", error: unknown, node: T) => void);
+  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>>;
 };