arthub-table 0.2.15 → 0.2.16

package/dist/types/adapters/DataGridIntegration.d.ts

@@ -599,6 +599,14 @@ export interface DataGridCallbacks {
         data: any;
         selectedRowIds: string[];
     }) => void;
+    /** 最大可选行数（超过此数量时阻止勾选并触发 onSelectionLimitExceeded 回调），不设置则不限制 */
+    maxSelectedRows?: number;
+    /** 勾选超限回调（当勾选操作将导致选中数量超过 maxSelectedRows 时触发） */
+    onSelectionLimitExceeded?: (info: {
+        currentCount: number;
+        attemptCount: number;
+        limit: number;
+    }) => void;
     /**
      * Cell value transformer callback.
      * Called by Cell.drawWithViewer() before passing data to viewer.draw().

package/dist/types/core/DataGrid.d.ts

@@ -732,6 +732,14 @@ export interface DataGridOptions {
         data: any;
         selectedRowIds: string[];
     }) => void;
+    /** 最大可选行数（超过此数量时阻止勾选并触发 onSelectionLimitExceeded 回调），不设置则不限制 */
+    maxSelectedRows?: number;
+    /** 勾选超限回调（当勾选操作将导致选中数量超过 maxSelectedRows 时触发） */
+    onSelectionLimitExceeded?: (info: {
+        currentCount: number;
+        attemptCount: number;
+        limit: number;
+    }) => void;
     /**
     /** Cell value transformer callback.
      * Called by Cell.drawWithViewer() before passing data to viewer.draw().
@@ -793,6 +801,8 @@ declare class DataGrid {
     edgeScroller: EdgeScroller;
     rowIdMap: Map<string, number>;
     selectedRowIds: Set<string>;
+    selectedGroupIds: Set<string>;
+    _groupSelectedRowIds: Map<string, string[]>;
     lastSelectedRowIndex: number;
     /** Footer 行高度（showFooter 为 false 时返回 0） */
     get footerHeight(): number;
@@ -966,6 +976,14 @@ declare class DataGrid {
         data: any;
         selectedRowIds: string[];
     }) => void;
+    /** 最大可选行数（超过此数量时阻止勾选） */
+    maxSelectedRows?: number;
+    /** 勾选超限回调 */
+    onSelectionLimitExceeded?: (info: {
+        currentCount: number;
+        attemptCount: number;
+        limit: number;
+    }) => void;
     /** 折叠所有任务回调 */
     onCollapseAll?: () => void;
     /** 展开所有任务回调 */
@@ -2276,6 +2294,12 @@ declare class DataGrid {
      */
     private ensureRowIds;
     syncGroupCheckedState(): void;
+    /**
+     * 受控模式下：计算组头应有的 checked 状态，如果与当前不一致则通过回调通知外部修改。
+     * 逻辑与 syncGroupCheckedState 的计算一致，但不直接修改 data.checked 和 selectedGroupIds，
+     * 而是通过 onGroupCheckboxChange 回调让外部决定是否更新。
+     */
+    private _notifyGroupCheckedChanges;
     /**
      * 折叠所有任务（受控模式下触发 onCollapseAll 回调，由外部操作 tableTaskList 后刷新）
      */

package/dist/types/core/GroupRow.d.ts

@@ -293,6 +293,14 @@ declare class GroupRow extends Context {
      * @returns 变更后该组内所有行的 rowId 数组
      */
     private selectGroupRows;
+    /**
+     * 计算该组下将新增的选中行数（不含已选中的行）
+     * 用于 maxSelectedRows 前置校验
+     *
+     * @param groupId - 组头行的 ID
+     * @returns 该组内尚未选中的普通行数量
+     */
+    private countGroupRows;
     /**
      * Placeholder methods for compatibility with Row interface
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "High-performance canvas-based table/grid component for Vue 3 with TypeScript support, featuring virtual scrolling, cell viewers, grouped rows, and nested grids.",
   "main": "dist/arthub-table.common.js",
   "module": "dist/arthub-table.umd.min.js",