@cyberpunk-vue/components 1.10.1 → 1.11.0

package/dist/table/index.d.ts

@@ -95,17 +95,33 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
             readonly type: import('vue').PropType<(row: any) => boolean>;
             readonly default: undefined;
         };
+        readonly treeCheckMode: {
+            readonly type: import('vue').PropType<import('.').TreeCheckMode>;
+            readonly default: "strict";
+        };
+        readonly selectionPayload: {
+            readonly type: import('vue').PropType<import('.').SelectionPayloadShape>;
+            readonly default: "rows";
+        };
+        readonly includeHalfChecked: {
+            readonly type: BooleanConstructor;
+            readonly default: false;
+        };
     }>> & Readonly<{
-        onSelect?: ((selection: any[], row: any) => any) | undefined;
-        "onSelect-all"?: ((selection: any[]) => any) | undefined;
+        onSelect?: ((selection: import('.').SelectionPayload, row: any) => any) | undefined;
+        "onSelect-all"?: ((selection: import('.').SelectionPayload) => any) | undefined;
         "onSort-change"?: ((sortState: import('.').SortState) => any) | undefined;
         "onRow-click"?: ((row: any, index: number, event: MouseEvent) => any) | undefined;
-        "onSelection-change"?: ((selection: any[]) => any) | undefined;
+        "onSelection-change"?: ((selection: import('.').SelectionPayload) => any) | undefined;
         "onCurrent-change"?: ((currentRow: any, oldRow: any) => any) | undefined;
         "onExpand-change"?: ((row: any, expanded: boolean) => any) | undefined;
     }>, {
         clearSelection: () => void;
         getSelectionRows: () => any[];
+        getSelectionKeys: () => (string | number)[];
+        getHalfCheckedRows: () => any[];
+        getHalfCheckedKeys: () => (string | number)[];
+        getSelectionDetail: () => import('.').SelectionDetail;
         sort: (prop: string, order: import('.').SortOrder) => void;
         setCurrentRow: (row: any) => void;
         toggleRowExpansion: (row: any, expanded?: boolean) => void;
@@ -113,11 +129,11 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         collapseAll: () => void;
         toggleRowExpand: (row: any, expanded?: boolean) => void;
     }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        select: (selection: any[], row: any) => void;
-        "select-all": (selection: any[]) => void;
+        select: (selection: import('.').SelectionPayload, row: any) => void;
+        "select-all": (selection: import('.').SelectionPayload) => void;
         "sort-change": (sortState: import('.').SortState) => void;
         "row-click": (row: any, index: number, event: MouseEvent) => void;
-        "selection-change": (selection: any[]) => void;
+        "selection-change": (selection: import('.').SelectionPayload) => void;
         "current-change": (currentRow: any, oldRow: any) => void;
         "expand-change": (row: any, expanded: boolean) => void;
     }, import('vue').PublicProps, {
@@ -139,6 +155,9 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         readonly treeProps: import('.').TableTreeProps;
         readonly expandRowKeys: (string | number)[];
         readonly rowExpandable: (row: any) => boolean;
+        readonly treeCheckMode: import('.').TreeCheckMode;
+        readonly selectionPayload: import('.').SelectionPayloadShape;
+        readonly includeHalfChecked: boolean;
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, HTMLDivElement, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
@@ -228,17 +247,33 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
             readonly type: import('vue').PropType<(row: any) => boolean>;
             readonly default: undefined;
         };
+        readonly treeCheckMode: {
+            readonly type: import('vue').PropType<import('.').TreeCheckMode>;
+            readonly default: "strict";
+        };
+        readonly selectionPayload: {
+            readonly type: import('vue').PropType<import('.').SelectionPayloadShape>;
+            readonly default: "rows";
+        };
+        readonly includeHalfChecked: {
+            readonly type: BooleanConstructor;
+            readonly default: false;
+        };
     }>> & Readonly<{
-        onSelect?: ((selection: any[], row: any) => any) | undefined;
-        "onSelect-all"?: ((selection: any[]) => any) | undefined;
+        onSelect?: ((selection: import('.').SelectionPayload, row: any) => any) | undefined;
+        "onSelect-all"?: ((selection: import('.').SelectionPayload) => any) | undefined;
         "onSort-change"?: ((sortState: import('.').SortState) => any) | undefined;
         "onRow-click"?: ((row: any, index: number, event: MouseEvent) => any) | undefined;
-        "onSelection-change"?: ((selection: any[]) => any) | undefined;
+        "onSelection-change"?: ((selection: import('.').SelectionPayload) => any) | undefined;
         "onCurrent-change"?: ((currentRow: any, oldRow: any) => any) | undefined;
         "onExpand-change"?: ((row: any, expanded: boolean) => any) | undefined;
     }>, {
         clearSelection: () => void;
         getSelectionRows: () => any[];
+        getSelectionKeys: () => (string | number)[];
+        getHalfCheckedRows: () => any[];
+        getHalfCheckedKeys: () => (string | number)[];
+        getSelectionDetail: () => import('.').SelectionDetail;
         sort: (prop: string, order: import('.').SortOrder) => void;
         setCurrentRow: (row: any) => void;
         toggleRowExpansion: (row: any, expanded?: boolean) => void;
@@ -264,6 +299,9 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         readonly treeProps: import('.').TableTreeProps;
         readonly expandRowKeys: (string | number)[];
         readonly rowExpandable: (row: any) => boolean;
+        readonly treeCheckMode: import('.').TreeCheckMode;
+        readonly selectionPayload: import('.').SelectionPayloadShape;
+        readonly includeHalfChecked: boolean;
     }>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -350,17 +388,33 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
         readonly type: import('vue').PropType<(row: any) => boolean>;
         readonly default: undefined;
     };
+    readonly treeCheckMode: {
+        readonly type: import('vue').PropType<import('.').TreeCheckMode>;
+        readonly default: "strict";
+    };
+    readonly selectionPayload: {
+        readonly type: import('vue').PropType<import('.').SelectionPayloadShape>;
+        readonly default: "rows";
+    };
+    readonly includeHalfChecked: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
 }>> & Readonly<{
-    onSelect?: ((selection: any[], row: any) => any) | undefined;
-    "onSelect-all"?: ((selection: any[]) => any) | undefined;
+    onSelect?: ((selection: import('.').SelectionPayload, row: any) => any) | undefined;
+    "onSelect-all"?: ((selection: import('.').SelectionPayload) => any) | undefined;
     "onSort-change"?: ((sortState: import('.').SortState) => any) | undefined;
     "onRow-click"?: ((row: any, index: number, event: MouseEvent) => any) | undefined;
-    "onSelection-change"?: ((selection: any[]) => any) | undefined;
+    "onSelection-change"?: ((selection: import('.').SelectionPayload) => any) | undefined;
     "onCurrent-change"?: ((currentRow: any, oldRow: any) => any) | undefined;
     "onExpand-change"?: ((row: any, expanded: boolean) => any) | undefined;
 }>, {
     clearSelection: () => void;
     getSelectionRows: () => any[];
+    getSelectionKeys: () => (string | number)[];
+    getHalfCheckedRows: () => any[];
+    getHalfCheckedKeys: () => (string | number)[];
+    getSelectionDetail: () => import('.').SelectionDetail;
     sort: (prop: string, order: import('.').SortOrder) => void;
     setCurrentRow: (row: any) => void;
     toggleRowExpansion: (row: any, expanded?: boolean) => void;
@@ -368,11 +422,11 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
     collapseAll: () => void;
     toggleRowExpand: (row: any, expanded?: boolean) => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    select: (selection: any[], row: any) => void;
-    "select-all": (selection: any[]) => void;
+    select: (selection: import('.').SelectionPayload, row: any) => void;
+    "select-all": (selection: import('.').SelectionPayload) => void;
     "sort-change": (sortState: import('.').SortState) => void;
     "row-click": (row: any, index: number, event: MouseEvent) => void;
-    "selection-change": (selection: any[]) => void;
+    "selection-change": (selection: import('.').SelectionPayload) => void;
     "current-change": (currentRow: any, oldRow: any) => void;
     "expand-change": (row: any, expanded: boolean) => void;
 }, string, {
@@ -394,6 +448,9 @@ export declare const CpTable: import('../utils').SFCWithInstall<{
     readonly treeProps: import('.').TableTreeProps;
     readonly expandRowKeys: (string | number)[];
     readonly rowExpandable: (row: any) => boolean;
+    readonly treeCheckMode: import('.').TreeCheckMode;
+    readonly selectionPayload: import('.').SelectionPayloadShape;
+    readonly includeHalfChecked: boolean;
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
     $slots: {
         default?(_: {}): any;

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

@@ -19,6 +19,35 @@ export interface SortState {
     prop: string;
     order: SortOrder;
 }
+/**
+ * 树形 + 多选联动策略
+ */
+export type TreeCheckMode = 'strict' | 'cascade' | 'bubble';
+/**
+ * selection-change / select / select-all 事件 payload 的输出形态
+ * - `'rows'`：数组，每项为完整行对象（默认）
+ * - `'keys'`：数组，每项为该行的 rowKey 值
+ * - `'detail'`：结构化对象，同时返回 checked 与 half-checked 两套数据
+ */
+export type SelectionPayloadShape = 'rows' | 'keys' | 'detail';
+/**
+ * `selectionPayload === 'detail'` 时的事件 payload 结构
+ */
+export interface SelectionDetail {
+    /** 完全选中的行对象数组 */
+    rows: any[];
+    /** 完全选中行的 rowKey 数组 */
+    keys: (string | number)[];
+    /** 半选行对象数组（仅 cascade / bubble 模式可能非空） */
+    halfRows: any[];
+    /** 半选行的 rowKey 数组 */
+    halfKeys: (string | number)[];
+}
+/**
+ * selection-change 等事件 payload 的联合类型
+ * 具体形态由 `selectionPayload` prop 决定
+ */
+export type SelectionPayload = any[] | (string | number)[] | SelectionDetail;
 /**
  * 树形数据配置
  */
@@ -65,7 +94,11 @@ export interface TableColumnConfig {
  * @slots empty - 空数据自定义内容 (默认: CpEmpty 组件)
  * @slots loading - 自定义加载中内容（替代默认 CpLoading + 文字）
  * @exposes clearSelection() - 清空选择
- * @exposes getSelectionRows() - 获取选中行数组
+ * @exposes getSelectionRows() - 获取选中行对象数组
+ * @exposes getSelectionKeys() - 获取选中行 rowKey 数组
+ * @exposes getHalfCheckedRows() - 获取半选行对象数组（仅联动模式）
+ * @exposes getHalfCheckedKeys() - 获取半选行 rowKey 数组（仅联动模式）
+ * @exposes getSelectionDetail() - 获取结构化选中详情 { rows, keys, halfRows, halfKeys }
  * @exposes sort(prop, order) - 编程式排序
  * @exposes setCurrentRow(row) - 设置当前行
  * @exposes toggleRowExpand(row, expanded?) - 切换行展开（展开列模式）
@@ -272,10 +305,44 @@ export declare const tableProps: {
         readonly type: PropType<(row: any) => boolean>;
         readonly default: undefined;
     };
+    /**
+     * 树形 + 多选场景下，父子节点的联动策略
+     * - `'strict'`（默认）：父子独立，互不影响
+     * - `'cascade'`：完全双向联动。勾父 → 全部后代勾选；勾/取子 → 父按直接子状态自动更新（含半选）
+     * - `'bubble'`：勾子 → 向上冒泡勾选祖先；取消父 → 后代全部取消；其他动作保持独立
+     * 仅在同时启用 `treeProps` 与 `type="selection"` 列时生效
+     * @default 'strict'
+     */
+    readonly treeCheckMode: {
+        readonly type: PropType<TreeCheckMode>;
+        readonly default: "strict";
+    };
+    /**
+     * selection-change / select / select-all 事件 payload 的输出形态
+     * - `'rows'`（默认）：数组，每项是完整行对象（等价原行为）
+     * - `'keys'`：数组，每项是该行的 rowKey 值
+     * - `'detail'`：结构化对象 `{ rows, keys, halfRows, halfKeys }`，同时返回全选与半选
+     * @default 'rows'
+     */
+    readonly selectionPayload: {
+        readonly type: PropType<SelectionPayloadShape>;
+        readonly default: "rows";
+    };
+    /**
+     * `selectionPayload` 为 `'rows'` 或 `'keys'` 时，是否将半选节点也混入数组
+     * 仅在联动模式（cascade / bubble）下可能产生半选节点
+     * `selectionPayload === 'detail'` 时此 prop 无效（detail 本身已分离全选与半选）
+     * @default false
+     */
+    readonly includeHalfChecked: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
 };
 export type TableProps = ExtractPropTypes<typeof tableProps>;
 /**
  * CpTable 事件定义
+ * selection / select / select-all payload 的具体形态由 `selectionPayload` prop 决定
  */
 export declare const tableEmits: {
     /** 排序变化 */
@@ -283,11 +350,11 @@ export declare const tableEmits: {
     /** 行点击 */
     'row-click': (row: any, index: number, event: MouseEvent) => boolean;
     /** 选中行变化 */
-    'selection-change': (selection: any[]) => boolean;
+    'selection-change': (selection: SelectionPayload) => boolean;
     /** 全选 */
-    'select-all': (selection: any[]) => boolean;
+    'select-all': (selection: SelectionPayload) => boolean;
     /** 单行选中 */
-    select: (selection: any[], row: any) => boolean;
+    select: (selection: SelectionPayload, row: any) => boolean;
     /** 当前行变化 */
     'current-change': (currentRow: any | null, oldRow: any | null) => boolean;
     /** 树形行展开/折叠 或 行展开列展开/折叠 */

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

@@ -1,4 +1,4 @@
-import { SortOrder, SortState } from './table';
+import { SortOrder, SortState, SelectionDetail, SelectionPayload } from './table';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
@@ -92,11 +92,31 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly type: import('vue').PropType<(row: any) => boolean>;
         readonly default: undefined;
     };
+    readonly treeCheckMode: {
+        readonly type: import('vue').PropType<import('./table').TreeCheckMode>;
+        readonly default: "strict";
+    };
+    readonly selectionPayload: {
+        readonly type: import('vue').PropType<import('./table').SelectionPayloadShape>;
+        readonly default: "rows";
+    };
+    readonly includeHalfChecked: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
 }>, {
     /** 清空选择 */
     clearSelection: () => void;
-    /** 获取选中行 */
+    /** 获取完全选中行对象数组 */
     getSelectionRows: () => any[];
+    /** 获取完全选中行的 rowKey 数组 */
+    getSelectionKeys: () => (string | number)[];
+    /** 获取半选行对象数组（仅 cascade / bubble 模式可能非空） */
+    getHalfCheckedRows: () => any[];
+    /** 获取半选行的 rowKey 数组（仅 cascade / bubble 模式可能非空） */
+    getHalfCheckedKeys: () => (string | number)[];
+    /** 获取结构化选中详情 { rows, keys, halfRows, halfKeys } */
+    getSelectionDetail: () => SelectionDetail;
     /** 排序 */
     sort: (prop: string, order: SortOrder) => void;
     /** 设置当前行 */
@@ -110,11 +130,11 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     /** 切换行展开（展开列模式） */
     toggleRowExpand: (row: any, expanded?: boolean) => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    select: (selection: any[], row: any) => void;
-    "select-all": (selection: any[]) => void;
+    select: (selection: SelectionPayload, row: any) => void;
+    "select-all": (selection: SelectionPayload) => void;
     "sort-change": (sortState: SortState) => void;
     "row-click": (row: any, index: number, event: MouseEvent) => void;
-    "selection-change": (selection: any[]) => void;
+    "selection-change": (selection: SelectionPayload) => void;
     "current-change": (currentRow: any, oldRow: any) => void;
     "expand-change": (row: any, expanded: boolean) => void;
 }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -199,12 +219,24 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly type: import('vue').PropType<(row: any) => boolean>;
         readonly default: undefined;
     };
+    readonly treeCheckMode: {
+        readonly type: import('vue').PropType<import('./table').TreeCheckMode>;
+        readonly default: "strict";
+    };
+    readonly selectionPayload: {
+        readonly type: import('vue').PropType<import('./table').SelectionPayloadShape>;
+        readonly default: "rows";
+    };
+    readonly includeHalfChecked: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
 }>> & Readonly<{
-    onSelect?: ((selection: any[], row: any) => any) | undefined;
-    "onSelect-all"?: ((selection: any[]) => any) | undefined;
+    onSelect?: ((selection: SelectionPayload, row: any) => any) | undefined;
+    "onSelect-all"?: ((selection: SelectionPayload) => any) | undefined;
     "onSort-change"?: ((sortState: SortState) => any) | undefined;
     "onRow-click"?: ((row: any, index: number, event: MouseEvent) => any) | undefined;
-    "onSelection-change"?: ((selection: any[]) => any) | undefined;
+    "onSelection-change"?: ((selection: SelectionPayload) => any) | undefined;
     "onCurrent-change"?: ((currentRow: any, oldRow: any) => any) | undefined;
     "onExpand-change"?: ((row: any, expanded: boolean) => any) | undefined;
 }>, {
@@ -226,6 +258,9 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
     readonly treeProps: import('./table').TableTreeProps;
     readonly expandRowKeys: (string | number)[];
     readonly rowExpandable: (row: any) => boolean;
+    readonly treeCheckMode: import('./table').TreeCheckMode;
+    readonly selectionPayload: import('./table').SelectionPayloadShape;
+    readonly includeHalfChecked: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyberpunk-vue/components",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "Cyberpunk Vue components - A futuristic Vue 3 component library",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -23,9 +23,9 @@
     "vue": "^3.5.0"
   },
   "dependencies": {
-    "@cyberpunk-vue/constants": "1.10.1",
-    "@cyberpunk-vue/hooks": "1.10.1",
-    "@cyberpunk-vue/theme-chalk": "1.10.1"
+    "@cyberpunk-vue/hooks": "1.11.0",
+    "@cyberpunk-vue/constants": "1.11.0",
+    "@cyberpunk-vue/theme-chalk": "1.11.0"
   },
   "author": "Juxest",
   "license": "MIT",