arthub-table 0.2.60 → 0.2.61-next.0

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

@@ -26,6 +26,10 @@ export interface PreprocessedRow {
     _searchMatch: SearchMatchResult;
     _cellBgColors: Record<string, string>;
     _bgColor?: string;
+    /** CP 行高亮标记 */
+    _cpHighLight?: boolean;
+    /** CP 高亮行中需要使用高亮文字色的列 key */
+    _cpHighLightFields?: string[];
     _isTopLevelEntity?: boolean;
     _isEmpty?: boolean;
     _isGroup?: boolean;

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

@@ -47,7 +47,7 @@ declare class AddTaskRow extends Context {
      */
     click(x: number, y: number, _clientX?: number, _clientY?: number): void;
     mouseDown(_x: number, _y: number): void;
-    dbClick(_x: number, _y: number): void;
+    dbClick(_x: number, _y: number, _clientX?: number, _clientY?: number): void;
     rePaint(): void;
     resizeColumn(_colIndex: number, _diffWidth: number): void;
     checked: boolean;

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

@@ -70,9 +70,9 @@ declare class Body {
     handleCheckRow(y?: number): void;
     handleCheckHeader(): void;
     mouseMove(x: number, y: number): void;
-    mouseDown(x: number, y: number, shiftKey?: boolean): void;
+    mouseDown(x: number, y: number, shiftKey?: boolean, clientX?: number, clientY?: number): void;
     click(x: number, y: number, clientX?: number, clientY?: number, event?: MouseEvent): void;
-    dbClick(x: number, y: number): void;
+    dbClick(x: number, y: number, clientX?: number, clientY?: number): void;
     /**
      * Check if double click hits a viewer with onDblClick handler
      * @returns true if viewer handled the double click

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

@@ -23,6 +23,10 @@ declare class GroupRow extends Context {
     isArrowAreaHovered: boolean;
     /** 人员工时图标的边界矩形缓存，用于点击和悬停命中检测 */
     private userWorkingHoursIconRect;
+    /** IText 实例，用于组头文字选中复制（非 person 模式） */
+    private _groupNameIText;
+    /** IText 实例数组，person 模式下每个非空人员一个实例 */
+    private _groupNameITexts;
     constructor(grid: DataGrid, rowIndex: number, x: number, y: number, height: number, data: GroupedTableRowData);
     /**
      * Draw the group row
@@ -121,6 +125,16 @@ declare class GroupRow extends Context {
      * 参考旧表格 GroupHeaderCell.updateMiddle 中根据字段 editor 类型分派渲染的逻辑
      */
     private drawGroupNameWithViewer;
+    /**
+     * person 模式：直接复用 viewer._lastPersonLayout 的布局结果创建/复用 IText 实例。
+     * 与 _drawTagITexts 模式一致：viewer 负责绘制，IText 只更新 bounds 供命中检测和选区使用。
+     */
+    private _drawPersonITexts;
+    /**
+     * tag 模式：为每个 tag 创建/复用 IText 实例，接管文字渲染（viewer 只画背景）。
+     * 直接复用 viewer.draw() 已计算好的 _lastTagLayout，确保文字与背景精确对齐，避免重复计算。
+     */
+    private _drawTagITexts;
     /**
      * 估算 viewer 绘制后的宽度，用于定位后续元素（如 count badge）
      * 针对不同 viewer 类型的绘制逻辑进行精确估算，避免内联统计值与 viewer 内容重叠
@@ -200,7 +214,7 @@ declare class GroupRow extends Context {
      */
     private drawGroupHeaderCells;
     /**
-     * 获取列在屏幕上的实际 X 坐标
+     * 绘制分组行统计数据（第二行）   * 获取列在屏幕上的实际 X 坐标
      */
     private getColumnScreenX;
     /**
@@ -300,7 +314,7 @@ declare class GroupRow extends Context {
     handleStartAutofill(_x: number, _y: number, _shiftKey?: boolean): void;
     isInsideVerticaTableBoundary(mouseX: number, mouseY: number): boolean;
     mouseMove(x: number, y: number): void;
-    mouseDown(_x: number, _y: number): void;
+    mouseDown(x: number, y: number, clientX?: number, clientY?: number): void;
     click(x: number, y: number, clientX?: number, clientY?: number): void;
     /** 处理 nested 子列点击 */
     private onNestedChildClick;
@@ -315,7 +329,8 @@ declare class GroupRow extends Context {
      * 而 ColumnHeader 的 index 是叶子列序号，与 headers 树形结构无对应关系。
      */
     private findColumnConfig;
-    dbClick(_x: number, _y: number): void;
+    dispose(): void;
+    dbClick(x: number, y: number, clientX?: number, clientY?: number): void;
     rowHeader: {
         handleCheck: (_val: boolean) => void;
     };

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

@@ -0,0 +1,118 @@
+/**
+ * IText - 独立 Canvas 文字渲染组件
+ * 支持：点击定位光标、鼠标拖拽选区、双击选词、Ctrl/Cmd+C 复制、Ctrl/Cmd+A 全选
+ * 不依赖 Viewer 体系，可在任何 Canvas 渲染场景中使用（组头、普通单元格等）
+ */
+export interface ITextOptions {
+    /** 字体大小，默认 12 */
+    fontSize?: number;
+    /** 字体粗细，默认 'normal' */
+    fontWeight?: 'normal' | 'bold';
+    /** 字体族，默认 sans-serif */
+    fontFamily?: string;
+    /** 文字颜色，默认 '#333' */
+    color?: string;
+    /** 文字对齐方式，默认 'left' */
+    textAlign?: 'left' | 'center' | 'right';
+    /** 内边距，默认 4 */
+    padding?: number;
+    /** requestRedraw 回调，激活后每次选区变化时调用 */
+    requestRedraw?: () => void;
+    /**
+     * 选区样式：
+     * - 'solid'：蓝底白字（纯文本场景，默认）
+     * - 'overlay'：半透明蓝色覆盖（viewer 场景，不会遮住 viewer 内容）
+     */
+    selectionStyle?: 'solid' | 'overlay';
+}
+export declare class IText {
+    private text;
+    private options;
+    /** 最后一次 draw 时的 canvas 绝对坐标 */
+    private x;
+    private y;
+    private width;
+    private height;
+    private selectionStart;
+    private selectionEnd;
+    private isActiveState;
+    private isDragging;
+    private anchorIndex;
+    private charWidths;
+    private charPositions;
+    private textarea;
+    private cleanupMouseMove;
+    private cleanupMouseUp;
+    private onKeydown;
+    /** charWidths 是否需要重新计算（文本变化时置为 true） */
+    private charsDirty;
+    constructor(text: string, options?: ITextOptions);
+    /** 更新文本（文本变化时调用） */
+    setText(text: string): void;
+    /** 更新文字颜色（每帧 draw 前可调用，适用于颜色来源不同的场景） */
+    setColor(color: string): void;
+    /**
+     * 批量更新选项（fontSize、fontWeight、fontFamily、color 等）
+     * viewer 路径每帧同步样式时使用
+     */
+    setOptions(opts: Partial<ITextOptions>): void;
+    /** 更新 requestRedraw 回调 */
+    setRequestRedraw(fn: () => void): void;
+    /** 判断 canvas 绝对坐标是否在文字区域内，左侧留 4px buffer 方便从文字起始位置附近点击激活 */
+    containsPoint(canvasX: number, canvasY: number): boolean;
+    /**
+     * 渲染文字 + 选区高亮（每帧调用）
+     * x, y, width, height 是文字区域在 canvas 上的绝对坐标
+     *
+     * drawText 参数语义：
+     * - true（默认）：IText 绘制文字 + 选区，外部无需再绘制文字
+     * - false：IText 只更新 bounds（供命中检测使用），不绘制任何内容
+     *   适用于 viewer 路径中非 text 模式（viewer 自己负责绘制文字）
+     */
+    draw(ctx: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, drawText?: boolean): void;
+    /**
+     * 鼠标按下：激活 + 定位光标 + 开始拖拽
+     * clientX/clientY 是鼠标的视口坐标
+     */
+    handleMouseDown(canvasEl: HTMLCanvasElement, clientX: number, _clientY: number): void;
+    /**
+     * 鼠标移动：更新拖拽选区（仅在 isDragging 时有效）
+     * 内部由 mousemove 监听器调用
+     */
+    handleMouseMove(canvasEl: HTMLCanvasElement, clientX: number, _clientY: number): void;
+    /** 鼠标抬起：结束拖拽 */
+    handleMouseUp(): void;
+    /** 双击：全选所有文字 */
+    handleDblClick(canvasEl: HTMLCanvasElement, clientX: number, clientY: number): void;
+    /** 失活：清除选区、销毁 textarea */
+    deactivate(): void;
+    /** 是否处于激活状态 */
+    get active(): boolean;
+    /**
+     * 单独绘制选区覆盖层（在所有内容绘制完成后调用）
+     * 用于 viewer 路径：viewer 先绘制内容，最后再叠加选区高亮
+     */
+    drawSelectionOverlay(ctx: CanvasRenderingContext2D): void;
+    /** 获取当前选中文字（限制在可见区域内） */
+    getSelectedText(): string;
+    /** 获取可见区域内最后一个完整字符的索引上限 */
+    private getMaxVisibleIndex;
+    private buildFont;
+    private measureCharWidths;
+    private getTextStartX;
+    private drawSelection;
+    /** 分段绘制文字：选中区域白色，其余原色 */
+    private drawTextWithSelection;
+    /** 将视口坐标 clientX 转为相对于文字起始位置的局部 X */
+    private clientToLocalX;
+    /** 根据局部 X 坐标找到最近的字符索引，结果限制在可见区域内 */
+    private getCharIndexFromX;
+    private mountTextarea;
+    private unmountTextarea;
+    private registerDragListeners;
+}
+/**
+ * 取消当前激活的 IText 实例的选区
+ * 在 canvas 全局 mousedown 入口调用，模拟 DOM 原生选中行为：点击任意位置即取消选区
+ */
+export declare function deactivateActiveIText(): void;

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

@@ -17,12 +17,12 @@ declare class Row extends Context {
     constructor(grid: DataGrid, rowIndex: number, x: number, y: number, height: number, data: RowData);
     isInVerticalAutofill(mouseX: number, mouseY: number): boolean;
     handleCheck(checked?: boolean, event?: MouseEvent, silent?: boolean): void;
-    mouseDown(x: number, y: number): void;
+    mouseDown(x: number, y: number, _clientX?: number, _clientY?: number): void;
     mouseMove(mouseX: number, mouseY: number): void;
     handleAutofill(x: number, y: number): void;
     handleStartAutofill(x: number, y: number, shiftKey?: boolean): void;
     click(x: number, y: number, event?: MouseEvent): void;
-    dbClick(x: number, y: number): void;
+    dbClick(x: number, y: number, _clientX?: number, _clientY?: number): void;
     resizeColumn(colIndex: number, diffWidth: number): void;
     resizeRow(rowIndex: number, height: number): void;
     rePaint(): void;

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

@@ -173,6 +173,10 @@ export interface ThemeTokens {
     bgTopLevelEntity: string;
     /** 顶层实体行 hover 背景色 */
     bgTopLevelEntityHover: string;
+    /** CP 高亮行背景色 */
+    bgCpHighlight: string;
+    /** CP 高亮行文字色 */
+    textCpHighlight: string;
     /** 需求变更-新增需求背景色 */
     bgDemandChangeAdd: string;
     /** 需求变更-新增需求 hover 背景色 */

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

@@ -13,6 +13,27 @@
  * and this viewer only handles rendering. This keeps arthub-table free of business dependencies.
  */
 import type { CellViewer, ViewerRenderContext, GroupNameViewerData } from './types';
+/** tag 模式单个 tag 的布局计算结果 */
+interface TagLayoutItem {
+    /** 原始 tag 数据 */
+    tag: {
+        text: string;
+        bgColor: string;
+        textColor: string;
+    };
+    /** tag 背景起始 X（绝对坐标） */
+    tagX: number;
+    /** tag 背景宽度（可能因截断而缩小） */
+    tagWidth: number;
+    /** 文字起始 X（tagX + paddingH） */
+    textX: number;
+    /** 文字可用宽度（tagWidth - 2*paddingH，最小为 0） */
+    textWidth: number;
+    /** 实际显示文字（可能含省略号） */
+    displayText: string;
+    /** 是否渲染（false 表示剩余空间不足，跳过该 tag 及后续 tag） */
+    visible: boolean;
+}
 declare class GroupNameViewer implements CellViewer<GroupNameViewerData> {
     readonly type = "group-name";
     private imageManager;
@@ -21,6 +42,15 @@ declare class GroupNameViewer implements CellViewer<GroupNameViewerData> {
     private _hoverPersonIndex;
     /** Row index of the group row currently being hovered (-1 = none) */
     private _hoverRowIndex;
+    /** 最近一次 drawTagMode 计算出的布局结果，供 _drawTagITexts 复用 */
+    _lastTagLayout: TagLayoutItem[];
+    /** 最近一次 drawPersonMode 计算出的每个人的布局（nameX, nameWidth, displayName），供 onClick/getInteractiveCursor 复用 */
+    _lastPersonLayout: Array<{
+        nameX: number;
+        nameWidth: number;
+        displayName: string;
+        personIndex: number;
+    }>;
     private get avatarColors();
     constructor();
     /**
@@ -52,6 +82,15 @@ declare class GroupNameViewer implements CellViewer<GroupNameViewerData> {
     private getColorIndex;
     private getInitial;
     private drawTagMode;
+    /**
+     * 计算 tag 模式的布局，返回每个 tag 的渲染参数。
+     * 策略与 TextViewer.drawMultiTags 对齐：
+     * - 总宽度 <= 可用宽度 → 各 tag 用理想宽度完整显示
+     * - 总宽度 > 可用宽度 → 等比缩小所有 tag（minTagWidth 兜底），确保所有 tag 都显示
+     * - 等比缩小后仍超出 → 减少可见 tag 数（极端情况）
+     * - 每个 tag 内文字超出 tag 宽度 → 省略号截断
+     */
+    private _computeTagLayout;
     private drawBooleanMode;
     private drawPriorityMode;
 }

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

@@ -8,6 +8,17 @@
 import type { CellViewer, ViewerRenderContext, TaskNodeViewerData } from './types';
 declare class TaskNodeViewer implements CellViewer<TaskNodeViewerData> {
     readonly type = "task-node";
+    /**
+     * draw 时每个 cell 内所有 tag 的几何与"是否截断"信息缓存。
+     * 二级结构 WeakMap<scope, Map<`${rowIndex}-${colIndex}`, NameOverflowInfo[]>>：
+     * - 外层 scope 区分 DataGrid 与内部 NestedGrid，避免内外层相同 rowIndex/colIndex 互相覆盖
+     * - 作用域实例被 GC 后 WeakMap 自动释放，无需主动清理
+     *
+     * 写入：draw 末尾覆盖式写入
+     * 读取：getTooltip 用 localX/localY 命中后查询
+     * 清理策略：依赖 draw 自动刷新（每次重绘同 key 覆盖），不主动清理。
+     */
+    private _nameOverflowCache;
     private imageManager;
     /** 记录加载失败的图标 URL，避免反复重试 */
     private failedIcons;
@@ -112,5 +123,14 @@ declare class TaskNodeViewer implements CellViewer<TaskNodeViewerData> {
      * 文本截断，超出宽度时显示省略号
      */
     private truncateText;
+    getTooltip(context: ViewerRenderContext, _data: TaskNodeViewerData, localX: number, localY: number): {
+        text: string;
+        bounds: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    } | null;
 }
 export default TaskNodeViewer;

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

@@ -570,6 +570,10 @@ export interface GroupNameViewerData extends CellViewerData {
     priorityValue?: number | string;
     /** Callback when a person name is clicked (for user profile jump) */
     onPersonClick?: (accountName: string) => void;
+    /** 跳过文字绘制，由外部 IText 负责绘制文字（text 模式专用） */
+    skipText?: boolean;
+    /** 可见裁剪宽度，tag 模式用于控制截断逻辑（超出则显示省略号而非被 clip 截断） */
+    clipWidth?: number;
 }
 /**
  * Separator row viewer data

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.2.60",
+  "version": "0.2.61-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",