@cyberpunk-vue/components 1.13.5 → 1.13.7

package/dist/table/index.d.ts

@@ -59,6 +59,18 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         readonly defaultSort: {
             readonly type: import('vue').PropType<import('.').SortState>;
         };
+        readonly sortState: {
+            readonly type: import('vue').PropType<import('.').SortState>;
+            readonly default: undefined;
+        };
+        readonly manualSort: {
+            readonly type: BooleanConstructor;
+            readonly default: false;
+        };
+        readonly sortOrders: {
+            readonly type: import('vue').PropType<import('.').SortOrder[]>;
+            readonly default: () => (string | null)[];
+        };
         readonly color: {
             readonly type: StringConstructor;
             readonly default: "";
@@ -120,10 +132,11 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         "onSelect-all"?: ((selection: import('.').SelectionPayload) => any) | undefined;
         "onCurrent-change"?: ((currentRow: any, oldRow: any) => any) | undefined;
         "onUpdate:checkedKeys"?: ((keys: (string | number)[]) => any) | undefined;
-        "onSort-change"?: ((sortState: import('.').SortState) => any) | undefined;
+        "onSort-change"?: ((_sortState: import('.').SortChangePayload) => any) | undefined;
         "onRow-click"?: ((row: any, index: number, event: MouseEvent) => any) | undefined;
         "onSelection-change"?: ((selection: import('.').SelectionPayload) => any) | undefined;
         "onExpand-change"?: ((row: any, expanded: boolean) => any) | undefined;
+        "onUpdate:sortState"?: ((_sortState: import('.').SortState) => any) | undefined;
     }>, {
         clearSelection: () => void;
         setSelectionKeys: (keys: (string | number)[]) => void;
@@ -133,6 +146,8 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         getHalfCheckedKeys: () => (string | number)[];
         getSelectionDetail: () => import('.').SelectionDetail;
         sort: (prop: string, order: import('.').SortOrder) => void;
+        clearSort: () => void;
+        getSortState: () => import('.').SortState;
         setCurrentRow: (row: any) => void;
         toggleRowExpansion: (row: any, expanded?: boolean) => void;
         expandAll: () => void;
@@ -143,10 +158,11 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         "select-all": (selection: import('.').SelectionPayload) => void;
         "current-change": (currentRow: any, oldRow: any) => void;
         "update:checkedKeys": (keys: (string | number)[]) => void;
-        "sort-change": (sortState: import('.').SortState) => void;
+        "sort-change": (_sortState: import('.').SortChangePayload) => void;
         "row-click": (row: any, index: number, event: MouseEvent) => void;
         "selection-change": (selection: import('.').SelectionPayload) => void;
         "expand-change": (row: any, expanded: boolean) => void;
+        "update:sortState": (_sortState: import('.').SortState) => void;
     }, import('vue').PublicProps, {
         readonly size: import('@cyberpunk-vue/hooks').Size;
         readonly data: any[];
@@ -165,6 +181,9 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         readonly rowClassName: import('.').TableRowClassName;
         readonly emptyText: string;
         readonly rowKey: string | ((row: any) => string | number);
+        readonly sortState: import('.').SortState;
+        readonly manualSort: boolean;
+        readonly sortOrders: import('.').SortOrder[];
         readonly treeProps: import('.').TableTreeProps;
         readonly expandRowKeys: (string | number)[];
         readonly rowExpandable: (row: any) => boolean;
@@ -224,6 +243,18 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         readonly defaultSort: {
             readonly type: import('vue').PropType<import('.').SortState>;
         };
+        readonly sortState: {
+            readonly type: import('vue').PropType<import('.').SortState>;
+            readonly default: undefined;
+        };
+        readonly manualSort: {
+            readonly type: BooleanConstructor;
+            readonly default: false;
+        };
+        readonly sortOrders: {
+            readonly type: import('vue').PropType<import('.').SortOrder[]>;
+            readonly default: () => (string | null)[];
+        };
         readonly color: {
             readonly type: StringConstructor;
             readonly default: "";
@@ -285,10 +316,11 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         "onSelect-all"?: ((selection: import('.').SelectionPayload) => any) | undefined;
         "onCurrent-change"?: ((currentRow: any, oldRow: any) => any) | undefined;
         "onUpdate:checkedKeys"?: ((keys: (string | number)[]) => any) | undefined;
-        "onSort-change"?: ((sortState: import('.').SortState) => any) | undefined;
+        "onSort-change"?: ((_sortState: import('.').SortChangePayload) => any) | undefined;
         "onRow-click"?: ((row: any, index: number, event: MouseEvent) => any) | undefined;
         "onSelection-change"?: ((selection: import('.').SelectionPayload) => any) | undefined;
         "onExpand-change"?: ((row: any, expanded: boolean) => any) | undefined;
+        "onUpdate:sortState"?: ((_sortState: import('.').SortState) => any) | undefined;
     }>, {
         clearSelection: () => void;
         setSelectionKeys: (keys: (string | number)[]) => void;
@@ -298,6 +330,8 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         getHalfCheckedKeys: () => (string | number)[];
         getSelectionDetail: () => import('.').SelectionDetail;
         sort: (prop: string, order: import('.').SortOrder) => void;
+        clearSort: () => void;
+        getSortState: () => import('.').SortState;
         setCurrentRow: (row: any) => void;
         toggleRowExpansion: (row: any, expanded?: boolean) => void;
         expandAll: () => void;
@@ -321,6 +355,9 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         readonly rowClassName: import('.').TableRowClassName;
         readonly emptyText: string;
         readonly rowKey: string | ((row: any) => string | number);
+        readonly sortState: import('.').SortState;
+        readonly manualSort: boolean;
+        readonly sortOrders: import('.').SortOrder[];
         readonly treeProps: import('.').TableTreeProps;
         readonly expandRowKeys: (string | number)[];
         readonly rowExpandable: (row: any) => boolean;
@@ -377,6 +414,18 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
     readonly defaultSort: {
         readonly type: import('vue').PropType<import('.').SortState>;
     };
+    readonly sortState: {
+        readonly type: import('vue').PropType<import('.').SortState>;
+        readonly default: undefined;
+    };
+    readonly manualSort: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly sortOrders: {
+        readonly type: import('vue').PropType<import('.').SortOrder[]>;
+        readonly default: () => (string | null)[];
+    };
     readonly color: {
         readonly type: StringConstructor;
         readonly default: "";
@@ -438,10 +487,11 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
     "onSelect-all"?: ((selection: import('.').SelectionPayload) => any) | undefined;
     "onCurrent-change"?: ((currentRow: any, oldRow: any) => any) | undefined;
     "onUpdate:checkedKeys"?: ((keys: (string | number)[]) => any) | undefined;
-    "onSort-change"?: ((sortState: import('.').SortState) => any) | undefined;
+    "onSort-change"?: ((_sortState: import('.').SortChangePayload) => any) | undefined;
     "onRow-click"?: ((row: any, index: number, event: MouseEvent) => any) | undefined;
     "onSelection-change"?: ((selection: import('.').SelectionPayload) => any) | undefined;
     "onExpand-change"?: ((row: any, expanded: boolean) => any) | undefined;
+    "onUpdate:sortState"?: ((_sortState: import('.').SortState) => any) | undefined;
 }>, {
     clearSelection: () => void;
     setSelectionKeys: (keys: (string | number)[]) => void;
@@ -451,6 +501,8 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
     getHalfCheckedKeys: () => (string | number)[];
     getSelectionDetail: () => import('.').SelectionDetail;
     sort: (prop: string, order: import('.').SortOrder) => void;
+    clearSort: () => void;
+    getSortState: () => import('.').SortState;
     setCurrentRow: (row: any) => void;
     toggleRowExpansion: (row: any, expanded?: boolean) => void;
     expandAll: () => void;
@@ -461,10 +513,11 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
     "select-all": (selection: import('.').SelectionPayload) => void;
     "current-change": (currentRow: any, oldRow: any) => void;
     "update:checkedKeys": (keys: (string | number)[]) => void;
-    "sort-change": (sortState: import('.').SortState) => void;
+    "sort-change": (_sortState: import('.').SortChangePayload) => void;
     "row-click": (row: any, index: number, event: MouseEvent) => void;
     "selection-change": (selection: import('.').SelectionPayload) => void;
     "expand-change": (row: any, expanded: boolean) => void;
+    "update:sortState": (_sortState: import('.').SortState) => void;
 }, string, {
     readonly size: import('@cyberpunk-vue/hooks').Size;
     readonly data: any[];
@@ -483,6 +536,9 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
     readonly rowClassName: import('.').TableRowClassName;
     readonly emptyText: string;
     readonly rowKey: string | ((row: any) => string | number);
+    readonly sortState: import('.').SortState;
+    readonly manualSort: boolean;
+    readonly sortOrders: import('.').SortOrder[];
     readonly treeProps: import('.').TableTreeProps;
     readonly expandRowKeys: (string | number)[];
     readonly rowExpandable: (row: any) => boolean;

package/dist/table/src/table.d.ts

@@ -12,6 +12,13 @@ export type TableSize = Size;
  * 排序方向
  */
 export type SortOrder = 'ascending' | 'descending' | null;
+/**
+ * 列排序模式
+ * - `false`：不可排序
+ * - `true`：组件内部本地排序
+ * - `'custom'`：只维护排序 UI 与事件，由调用者远程排序
+ */
+export type ColumnSortable = boolean | 'custom';
 /**
  * 排序配置
  */
@@ -19,6 +26,21 @@ export interface SortState {
     prop: string;
     order: SortOrder;
 }
+/**
+ * sort-change 事件 payload
+ */
+export interface SortChangePayload extends SortState {
+    /** 当前触发排序的列配置；通过编程式排序且未匹配到列时为 null */
+    column: TableColumnConfig | null;
+}
+/**
+ * 排序取值配置
+ */
+export type SortBy = string | string[] | ((row: any) => any);
+/**
+ * 自定义本地排序函数
+ */
+export type SortMethod = (a: any, b: any, order: Exclude<SortOrder, null>) => number;
 /**
  * 树形 + 多选联动策略
  */
@@ -89,7 +111,13 @@ export interface TableColumnConfig {
     /** 最小列宽 */
     minWidth?: string | number;
     /** 是否可排序 */
-    sortable: boolean;
+    sortable: ColumnSortable;
+    /** 自定义本地排序函数 */
+    sortMethod?: SortMethod;
+    /** 自定义排序取值字段或函数 */
+    sortBy?: SortBy;
+    /** 排序切换顺序 */
+    sortOrders?: SortOrder[];
     /** 特殊列类型 */
     columnType: 'default' | 'selection' | 'index' | 'expand';
     /** 内容对齐 */
@@ -118,10 +146,22 @@ export interface TableColumnConfig {
  * @exposes getSelectionDetail() - 获取结构化选中详情 { rows, keys, halfRows, halfKeys }
  * @exposes setSelectionKeys(keys) - 程序式设置选中 rowKey 数组
  * @exposes sort(prop, order) - 编程式排序
+ * @exposes clearSort() - 清空排序
+ * @exposes getSortState() - 获取当前排序状态
  * @exposes setCurrentRow(row) - 设置当前行
  * @exposes toggleRowExpand(row, expanded?) - 切换行展开（展开列模式）
  * @example
  * ```vue
+ * <!-- 远程排序：只维护排序状态，不做本地排序 -->
+ * <CpTable
+ *   v-model:sort-state="sortState"
+ *   :data="tableData"
+ *   manual-sort
+ *   @sort-change="fetchTableData"
+ * >
+ *   <CpTableColumn prop="createdAt" label="创建时间" sortable />
+ * </CpTable>
+ *
  * <!-- 基础用法 -->
  * <CpTable :data="tableData" stripe border>
  *   <CpTableColumn prop="name" label="姓名" sortable />
@@ -260,10 +300,53 @@ export declare const tableProps: {
     };
     /**
      * 默认排序
+     *
+     * 仅作为非受控模式下的初始排序状态；后续外部变更不会自动覆盖内部状态。
      */
     readonly defaultSort: {
         readonly type: PropType<SortState>;
     };
+    /**
+     * 受控排序状态（配合 `v-model:sort-state`）
+     *
+     * 传入后排序状态由外部维护；组件点击表头只触发 `update:sortState`
+     * 与 `sort-change`，视觉状态会跟随外部传回的新值。
+     *
+     * @example
+     * ```vue
+     * <CpTable v-model:sort-state="sortState" :data="rows" />
+     * ```
+     */
+    readonly sortState: {
+        readonly type: PropType<SortState>;
+        readonly default: undefined;
+    };
+    /**
+     * 手动排序模式
+     *
+     * 开启后组件只维护排序状态与排序图标，不会对 `data` 做本地排序。
+     * 适用于服务端排序、URL 状态同步、外部 store 管理等场景。
+     *
+     * 也可以在列上设置 `sortable="custom"` 仅让某一列进入手动排序。
+     *
+     * @default false
+     */
+    readonly manualSort: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * 排序切换顺序
+     *
+     * 默认按升序、降序、取消排序循环。可传 `['descending', 'ascending']`
+     * 让列始终保持有序状态，不进入取消排序。
+     *
+     * @default ['ascending', 'descending', null]
+     */
+    readonly sortOrders: {
+        readonly type: PropType<SortOrder[]>;
+        readonly default: () => (string | null)[];
+    };
     /**
      * 自定义主题色（CSS 颜色值）
      * 优先级高于 type，设置后会覆盖 --cp-table-color
@@ -414,7 +497,7 @@ export type TableProps = ExtractPropTypes<typeof tableProps>;
  */
 export declare const tableEmits: {
     /** 排序变化 */
-    'sort-change': (sortState: SortState) => boolean;
+    'sort-change': (_sortState: SortChangePayload) => boolean;
     /** 行点击 */
     'row-click': (row: any, index: number, event: MouseEvent) => boolean;
     /** 选中行变化 */
@@ -429,5 +512,7 @@ export declare const tableEmits: {
     'expand-change': (row: any, expanded: boolean) => boolean;
     /** 受控 checkedKeys 变化（用于 `v-model:checked-keys`） */
     'update:checkedKeys': (keys: (string | number)[]) => boolean;
+    /** 受控 sortState 变化（用于 `v-model:sort-state`） */
+    'update:sortState': (_sortState: SortState) => boolean;
 };
 export type TableEmits = typeof tableEmits;

package/dist/table/src/table.vue.d.ts

@@ -1,4 +1,4 @@
-import { SortOrder, SortState, SelectionDetail, SelectionPayload } from './table';
+import { SortOrder, SortState, SortChangePayload, SelectionDetail, SelectionPayload } from './table';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
@@ -56,6 +56,18 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     readonly defaultSort: {
         readonly type: import('vue').PropType<SortState>;
     };
+    readonly sortState: {
+        readonly type: import('vue').PropType<SortState>;
+        readonly default: undefined;
+    };
+    readonly manualSort: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly sortOrders: {
+        readonly type: import('vue').PropType<SortOrder[]>;
+        readonly default: () => (string | null)[];
+    };
     readonly color: {
         readonly type: StringConstructor;
         readonly default: "";
@@ -129,6 +141,10 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     getSelectionDetail: () => SelectionDetail;
     /** 排序 */
     sort: (prop: string, order: SortOrder) => void;
+    /** 清空排序 */
+    clearSort: () => void;
+    /** 获取当前排序状态 */
+    getSortState: () => SortState;
     /** 设置当前行 */
     setCurrentRow: (row: any) => void;
     /** 切换行展开（树形模式） */
@@ -144,10 +160,11 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     "select-all": (selection: SelectionPayload) => void;
     "current-change": (currentRow: any, oldRow: any) => void;
     "update:checkedKeys": (keys: (string | number)[]) => void;
-    "sort-change": (sortState: SortState) => void;
+    "sort-change": (_sortState: SortChangePayload) => void;
     "row-click": (row: any, index: number, event: MouseEvent) => void;
     "selection-change": (selection: SelectionPayload) => void;
     "expand-change": (row: any, expanded: boolean) => void;
+    "update:sortState": (_sortState: SortState) => void;
 }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     readonly data: {
         readonly type: import('vue').PropType<any[]>;
@@ -194,6 +211,18 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     readonly defaultSort: {
         readonly type: import('vue').PropType<SortState>;
     };
+    readonly sortState: {
+        readonly type: import('vue').PropType<SortState>;
+        readonly default: undefined;
+    };
+    readonly manualSort: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly sortOrders: {
+        readonly type: import('vue').PropType<SortOrder[]>;
+        readonly default: () => (string | null)[];
+    };
     readonly color: {
         readonly type: StringConstructor;
         readonly default: "";
@@ -255,10 +284,11 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     "onSelect-all"?: ((selection: SelectionPayload) => any) | undefined;
     "onCurrent-change"?: ((currentRow: any, oldRow: any) => any) | undefined;
     "onUpdate:checkedKeys"?: ((keys: (string | number)[]) => any) | undefined;
-    "onSort-change"?: ((sortState: SortState) => any) | undefined;
+    "onSort-change"?: ((_sortState: SortChangePayload) => any) | undefined;
     "onRow-click"?: ((row: any, index: number, event: MouseEvent) => any) | undefined;
     "onSelection-change"?: ((selection: SelectionPayload) => any) | undefined;
     "onExpand-change"?: ((row: any, expanded: boolean) => any) | undefined;
+    "onUpdate:sortState"?: ((_sortState: SortState) => any) | undefined;
 }>, {
     readonly size: import('@cyberpunk-vue/hooks').Size;
     readonly data: any[];
@@ -277,6 +307,9 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     readonly rowClassName: import('./table').TableRowClassName;
     readonly emptyText: string;
     readonly rowKey: string | ((row: any) => string | number);
+    readonly sortState: SortState;
+    readonly manualSort: boolean;
+    readonly sortOrders: SortOrder[];
     readonly treeProps: import('./table').TableTreeProps;
     readonly expandRowKeys: (string | number)[];
     readonly rowExpandable: (row: any) => boolean;

package/dist/table-column/index.d.ts

@@ -30,9 +30,21 @@ export declare const CpTableColumn: import('../utils').SFCWithInstall<{
             readonly type: import('vue').PropType<string | number>;
         };
         readonly sortable: {
-            readonly type: BooleanConstructor;
+            readonly type: import('vue').PropType<import('..').ColumnSortable>;
             readonly default: false;
         };
+        readonly sortMethod: {
+            readonly type: import('vue').PropType<import('..').SortMethod>;
+            readonly default: undefined;
+        };
+        readonly sortBy: {
+            readonly type: import('vue').PropType<import('..').SortBy>;
+            readonly default: undefined;
+        };
+        readonly sortOrders: {
+            readonly type: import('vue').PropType<import('..').SortOrder[]>;
+            readonly default: undefined;
+        };
         readonly align: {
             readonly type: import('vue').PropType<"left" | "center" | "right">;
             readonly default: "left";
@@ -45,8 +57,11 @@ export declare const CpTableColumn: import('../utils').SFCWithInstall<{
         readonly type: import('.').ColumnType;
         readonly label: string;
         readonly align: "left" | "right" | "center";
+        readonly sortOrders: import('..').SortOrder[];
         readonly prop: string;
-        readonly sortable: boolean;
+        readonly sortable: import('..').ColumnSortable;
+        readonly sortMethod: import('..').SortMethod;
+        readonly sortBy: import('..').SortBy;
         readonly headerAlign: "" | "left" | "right" | "center";
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};
@@ -75,9 +90,21 @@ export declare const CpTableColumn: import('../utils').SFCWithInstall<{
             readonly type: import('vue').PropType<string | number>;
         };
         readonly sortable: {
-            readonly type: BooleanConstructor;
+            readonly type: import('vue').PropType<import('..').ColumnSortable>;
             readonly default: false;
         };
+        readonly sortMethod: {
+            readonly type: import('vue').PropType<import('..').SortMethod>;
+            readonly default: undefined;
+        };
+        readonly sortBy: {
+            readonly type: import('vue').PropType<import('..').SortBy>;
+            readonly default: undefined;
+        };
+        readonly sortOrders: {
+            readonly type: import('vue').PropType<import('..').SortOrder[]>;
+            readonly default: undefined;
+        };
         readonly align: {
             readonly type: import('vue').PropType<"left" | "center" | "right">;
             readonly default: "left";
@@ -90,8 +117,11 @@ export declare const CpTableColumn: import('../utils').SFCWithInstall<{
         readonly type: import('.').ColumnType;
         readonly label: string;
         readonly align: "left" | "right" | "center";
+        readonly sortOrders: import('..').SortOrder[];
         readonly prop: string;
-        readonly sortable: boolean;
+        readonly sortable: import('..').ColumnSortable;
+        readonly sortMethod: import('..').SortMethod;
+        readonly sortBy: import('..').SortBy;
         readonly headerAlign: "" | "left" | "right" | "center";
     }>;
     __isFragment?: never;
@@ -117,9 +147,21 @@ export declare const CpTableColumn: import('../utils').SFCWithInstall<{
         readonly type: import('vue').PropType<string | number>;
     };
     readonly sortable: {
-        readonly type: BooleanConstructor;
+        readonly type: import('vue').PropType<import('..').ColumnSortable>;
         readonly default: false;
     };
+    readonly sortMethod: {
+        readonly type: import('vue').PropType<import('..').SortMethod>;
+        readonly default: undefined;
+    };
+    readonly sortBy: {
+        readonly type: import('vue').PropType<import('..').SortBy>;
+        readonly default: undefined;
+    };
+    readonly sortOrders: {
+        readonly type: import('vue').PropType<import('..').SortOrder[]>;
+        readonly default: undefined;
+    };
     readonly align: {
         readonly type: import('vue').PropType<"left" | "center" | "right">;
         readonly default: "left";
@@ -132,8 +174,11 @@ export declare const CpTableColumn: import('../utils').SFCWithInstall<{
     readonly type: import('.').ColumnType;
     readonly label: string;
     readonly align: "left" | "right" | "center";
+    readonly sortOrders: import('..').SortOrder[];
     readonly prop: string;
-    readonly sortable: boolean;
+    readonly sortable: import('..').ColumnSortable;
+    readonly sortMethod: import('..').SortMethod;
+    readonly sortBy: import('..').SortBy;
     readonly headerAlign: "" | "left" | "right" | "center";
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
     $slots: Readonly<{

package/dist/table-column/src/table-column.d.ts

@@ -1,4 +1,5 @@
 import { ExtractPropTypes, PropType } from 'vue';
+import { ColumnSortable, SortBy, SortMethod, SortOrder } from '../../table/src/table';
 /**
  * 列特殊类型
  * - `default` — 普通数据列
@@ -18,6 +19,7 @@ export type ColumnType = 'default' | 'selection' | 'index' | 'expand';
  * ```vue
  * <!-- 普通数据列 -->
  * <CpTableColumn prop="name" label="姓名" sortable />
+ * <CpTableColumn prop="createdAt" label="创建时间" sortable="custom" />
  *
  * <!-- 自定义单元格渲染 -->
  * <CpTableColumn prop="status" label="状态">
@@ -82,12 +84,48 @@ export declare const tableColumnProps: {
     };
     /**
      * 是否可排序
+     *
+     * - `false`：不可排序
+     * - `true`：使用 CpTable 内置本地排序
+     * - `'custom'`：只触发排序状态和事件，不做本地排序，适用于远程排序
+     *
      * @default false
      */
     readonly sortable: {
-        readonly type: BooleanConstructor;
+        readonly type: PropType<ColumnSortable>;
         readonly default: false;
     };
+    /**
+     * 自定义本地排序函数
+     *
+     * 仅在 `sortable` 为 `true` 且表格未开启 `manualSort` 时生效。
+     * 返回值规则与 `Array.prototype.sort` 一致。
+     */
+    readonly sortMethod: {
+        readonly type: PropType<SortMethod>;
+        readonly default: undefined;
+    };
+    /**
+     * 自定义排序取值
+     *
+     * 支持字段名、字段名数组（依次比较）或函数。未设置时使用 `prop`。
+     * 可用于展示字段与排序字段不一致，或需要嵌套字段排序的场景。
+     */
+    readonly sortBy: {
+        readonly type: PropType<SortBy>;
+        readonly default: undefined;
+    };
+    /**
+     * 当前列的排序切换顺序
+     *
+     * 未设置时继承 CpTable 的 `sortOrders`。
+     *
+     * @default undefined
+     */
+    readonly sortOrders: {
+        readonly type: PropType<SortOrder[]>;
+        readonly default: undefined;
+    };
     /**
      * 内容对齐方式
      * @default 'left'

package/dist/table-column/src/table-column.vue.d.ts

@@ -31,9 +31,21 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly type: import('vue').PropType<string | number>;
     };
     readonly sortable: {
-        readonly type: BooleanConstructor;
+        readonly type: import('vue').PropType<import('../..').ColumnSortable>;
         readonly default: false;
     };
+    readonly sortMethod: {
+        readonly type: import('vue').PropType<import('../..').SortMethod>;
+        readonly default: undefined;
+    };
+    readonly sortBy: {
+        readonly type: import('vue').PropType<import('../..').SortBy>;
+        readonly default: undefined;
+    };
+    readonly sortOrders: {
+        readonly type: import('vue').PropType<import('../..').SortOrder[]>;
+        readonly default: undefined;
+    };
     readonly align: {
         readonly type: import('vue').PropType<"left" | "center" | "right">;
         readonly default: "left";
@@ -62,9 +74,21 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly type: import('vue').PropType<string | number>;
     };
     readonly sortable: {
-        readonly type: BooleanConstructor;
+        readonly type: import('vue').PropType<import('../..').ColumnSortable>;
         readonly default: false;
     };
+    readonly sortMethod: {
+        readonly type: import('vue').PropType<import('../..').SortMethod>;
+        readonly default: undefined;
+    };
+    readonly sortBy: {
+        readonly type: import('vue').PropType<import('../..').SortBy>;
+        readonly default: undefined;
+    };
+    readonly sortOrders: {
+        readonly type: import('vue').PropType<import('../..').SortOrder[]>;
+        readonly default: undefined;
+    };
     readonly align: {
         readonly type: import('vue').PropType<"left" | "center" | "right">;
         readonly default: "left";
@@ -77,8 +101,11 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     readonly type: import('./table-column').ColumnType;
     readonly label: string;
     readonly align: "left" | "right" | "center";
+    readonly sortOrders: import('../..').SortOrder[];
     readonly prop: string;
-    readonly sortable: boolean;
+    readonly sortable: import('../..').ColumnSortable;
+    readonly sortMethod: import('../..').SortMethod;
+    readonly sortBy: import('../..').SortBy;
     readonly headerAlign: "" | "left" | "right" | "center";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;