arthub-table 0.2.7 → 0.2.8-next.0

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

@@ -793,6 +793,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;
@@ -2276,6 +2278,12 @@ declare class DataGrid {
      */
     private ensureRowIds;
     syncGroupCheckedState(): void;
+    /**
+     * 受控模式下：计算组头应有的 checked 状态，如果与当前不一致则通过回调通知外部修改。
+     * 逻辑与 syncGroupCheckedState 的计算一致，但不直接修改 data.checked 和 selectedGroupIds，
+     * 而是通过 onGroupCheckboxChange 回调让外部决定是否更新。
+     */
+    private _notifyGroupCheckedChanges;
     /**
      * 折叠所有任务（受控模式下触发 onCollapseAll 回调，由外部操作 tableTaskList 后刷新）
      */

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

@@ -217,6 +217,14 @@ export interface ThemeTokens {
     loadingColor: string;
     /** autofill 边框色 */
     autofillBorder: string;
+    /** Boolean checkbox 边框色（未勾选 + 可编辑） */
+    checkboxBorder: string;
+    /** Boolean checkbox 边框色（未勾选 + 只读） */
+    checkboxBorderDisabled: string;
+    /** Boolean checkbox 填充色（已勾选 + 可编辑） */
+    checkboxChecked: string;
+    /** Boolean checkbox 填充色（已勾选 + 只读） */
+    checkboxCheckedDisabled: string;
     /** 固定列阴影 */
     shadowFixedColumn: string;
     /** Tooltip 阴影 */

package/dist/types/core/viewers/BooleanViewer.d.ts

@@ -32,6 +32,13 @@ declare class BooleanViewer implements CellViewer<BooleanViewerData> {
     draw(context: ViewerRenderContext, data: BooleanViewerData): void;
     /**
      * Draw checkbox style
+     * Colors are sourced from theme tokens (StyleManager) so the checkbox
+     * adapts to light/dark/blue themes consistently.
+     *  - checkboxChecked        : filled bg (editable + checked)
+     *  - checkboxCheckedDisabled: filled bg (readonly + checked)
+     *  - checkboxBorder         : border    (editable + unchecked)
+     *  - checkboxBorderDisabled : border    (readonly + unchecked)
+     * `data.checkedColor` may override the editable-checked fill color.
      */
     private drawCheckbox;
     /**

package/dist/types/core/viewers/CpPersonViewer.d.ts

@@ -0,0 +1,59 @@
+/**
+ * CpPersonViewer - CP Person (外包人员) rendering viewer
+ * Handles avatar and name display for CP users
+ *
+ * 与 DOM 版 cpPersonViewer.ts 对齐：
+ * - value 为 CP 用户 ID 数组（string[]）或单个 string
+ * - 通过 cpUserResolver 回调将 ID 解析为显示名称（companyName/roleName/nickName）
+ * - 未解析的 ID 先显示 ID 占位，异步加载后通过 requestRedraw 刷新
+ * - 样式对齐 PersonViewer：头像 + 名称
+ */
+import type { CellViewer, ViewerRenderContext, CpPersonViewerData } from './types';
+/**
+ * CpPersonViewer renders CP person information in cells
+ * Style aligned with PersonViewer (avatar + name)
+ */
+declare class CpPersonViewer implements CellViewer<CpPersonViewerData> {
+    readonly type = "cp-person";
+    private imageManager;
+    private _sm;
+    private get avatarColors();
+    constructor();
+    /**
+     * Draw CP person content in the cell
+     */
+    draw(context: ViewerRenderContext, data: CpPersonViewerData): void;
+    /**
+     * Draw persons list (with background tag style, aligned with PersonViewer showNameBackground mode)
+     */
+    private drawPersons;
+    /**
+     * Draw person avatar (circle shape, using default avatar image)
+     */
+    private drawAvatar;
+    /**
+     * Draw fallback avatar with initial character
+     */
+    private drawFallbackAvatar;
+    /**
+     * Get consistent color index based on person id
+     */
+    private getColorIndex;
+    /**
+     * Get initial character from name
+     */
+    private getInitial;
+    /**
+     * Truncate text with ellipsis to fit within maxWidth
+     */
+    private truncateText;
+    /**
+     * Draw remaining count badge
+     */
+    private drawRemainingCount;
+    /**
+     * Draw placeholder for empty state
+     */
+    private drawPlaceholder;
+}
+export default CpPersonViewer;

package/dist/types/core/viewers/index.d.ts

@@ -41,6 +41,7 @@ export { default as ChildrenViewer } from './ChildrenViewer';
 export { default as OnlyShowErrorViewer } from './OnlyShowErrorViewer';
 export { default as PerspectiveViewer } from './PerspectiveViewer';
 export { default as RelatedTaskViewer } from './RelatedTaskViewer';
+export { default as CpPersonViewer } from './CpPersonViewer';
 import TextViewer from './TextViewer';
 import DropdownViewer from './DropdownViewer';
 import ImageViewer from './ImageViewer';
@@ -78,6 +79,7 @@ import ChildrenViewer from './ChildrenViewer';
 import OnlyShowErrorViewer from './OnlyShowErrorViewer';
 import PerspectiveViewer from './PerspectiveViewer';
 import RelatedTaskViewer from './RelatedTaskViewer';
+import CpPersonViewer from './CpPersonViewer';
 /**
  * Register all default viewers
  * Call this function once during application initialization
@@ -129,4 +131,5 @@ export declare const defaultViewers: {
     'only-show-error': typeof OnlyShowErrorViewer;
     perspective: typeof PerspectiveViewer;
     'related-task': typeof RelatedTaskViewer;
+    'cp-person': typeof CpPersonViewer;
 };

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

@@ -969,6 +969,7 @@ export interface ViewerTypeMap {
     'itfs-path': ItfsPathViewerData;
     'deliverable-review': DeliverableReviewViewerData;
     'rich-text': RichTextViewerData;
+    'cp-person': CpPersonViewerData;
 }
 /**
  * All supported viewer types
@@ -1383,3 +1384,34 @@ export interface RelatedTaskViewerData extends CellViewerData {
         ids: number[];
     }, data: any) => void;
 }
+/**
+ * CP 人员信息（由 cpUserResolver 返回）
+ */
+export interface CpPersonInfo {
+    id: string;
+    /** 显示名称，格式如 "公司名/基地/昵称" */
+    showName: string;
+}
+/**
+ * CP 人员 Viewer 数据接口
+ * 用于展示外包人员（CP User）信息
+ * 对齐 DOM 版 cpPersonViewer.ts 的渲染逻辑
+ */
+export interface CpPersonViewerData extends CellViewerData {
+    /** CP 用户 ID 数组或单个 ID 字符串 */
+    value: string[] | string | null;
+    /** 头像大小，默认 16 */
+    avatarSize?: number;
+    /** 最大显示人数，默认 3 */
+    maxDisplay?: number;
+    /** 空值占位符，默认 '-' */
+    placeholder?: string;
+    /**
+     * CP 用户解析回调
+     * 同步返回已缓存的用户信息，对未缓存的 ID 触发异步加载后调用 requestRedraw
+     * @param ids CP 用户 ID 数组
+     * @param requestRedraw 重绘回调，异步加载完成后调用
+     * @returns 已解析的用户信息数组（未解析的以 ID 作为 showName）
+     */
+    cpUserResolver?: (ids: string[], requestRedraw: () => void) => CpPersonInfo[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.2.7",
+  "version": "0.2.8-next.0",
   "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",