arthub-table 0.2.86 → 0.2.87-next.1

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

@@ -12,7 +12,7 @@ import Histories from "./History";
 import { StyleManager, type TableTheme } from "./StyleManager";
 import EdgeScroller from "./EdgeScroller";
 import { type HeaderConfig } from "./util";
-import { type FooterCellClickInfo, type FooterData, type FooterCellData, type GroupHeaderCellClickInfo, type GroupHeaderCellHoverInfo, type FooterStatRefreshInfo, type GroupHeaderStatRefreshInfo } from "./types";
+import { type FooterCellClickInfo, type FooterData, type FooterCellData, type GroupHeaderCellClickInfo, type GroupHeaderCellHoverInfo, type FooterStatRefreshInfo, type GroupHeaderStatRefreshInfo, type ConditionalStyle, type ConditionalStylePatch, type ActiveCellInfo } from "./types";
 import { type PerformanceMonitor } from "./PerformanceMonitor";
 interface Column extends HeaderConfig {
     children?: Column[];
@@ -137,6 +137,8 @@ interface RowContextMenuInfo {
     clientX: number;
     /** 鼠标屏幕 Y 坐标 */
     clientY: number;
+    /** 右键发生时的不可变源单元格快照，供“快速生成规则”使用。 */
+    sourceCell?: ActiveCellInfo;
     /** Canvas 行索引（供外部通过 isRowCheckedByIndex 查询选中状态） */
     _canvasRowIndex?: number;
     /** 右键行是否处于选中（checked）状态 */
@@ -146,6 +148,20 @@ interface RowContextMenuInfo {
     /** Row 对象内部的 _rowId，和 selectedRowIds 中的 key 格式一致 */
     _internalRowId?: string;
 }
+/** Row hover action context. sourceCell is limited to the hovered row. */
+export interface RowHoverActionInfo {
+    rowData: RowData;
+    rowIndex: number;
+    sourceCell?: ActiveCellInfo;
+    position: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    clientX?: number;
+    clientY?: number;
+}
 export interface DataGridOptions {
     width?: number | string;
     height?: number | string;
@@ -429,6 +445,10 @@ export interface DataGridOptions {
     }) => void;
     /** 行右键菜单回调：行区域右键时触发 */
     onRowContextMenu?: (info: RowContextMenuInfo) => void;
+    /** 行 hover 时是否展示通用“更多”操作。 */
+    rowHoverAction?: boolean;
+    /** 行 hover 操作点击回调。 */
+    onRowHoverActionClick?: (info: RowHoverActionInfo) => void;
     onModuleOverflowClick?: (modules: any[], rowData: any, rowIndex: number, colIndex: number) => void;
     onAddRow?: (groupInfo?: any) => void;
     /** 表头排序图标点击回调 */
@@ -862,6 +882,8 @@ declare class DataGrid {
     private _customTokens;
     edgeScroller: EdgeScroller;
     rowIdMap: Map<string, number>;
+    private conditionalRowStyles;
+    private conditionalCellStyles;
     selectedRowIds: Set<string>;
     selectedGroupIds: Set<string>;
     lastSelectedRowIndex: number;
@@ -980,6 +1002,11 @@ declare class DataGrid {
     }) => void;
     /** 行右键菜单回调 */
     onRowContextMenu?: (info: RowContextMenuInfo) => void;
+    rowHoverAction?: DataGridOptions['rowHoverAction'];
+    onRowHoverActionClick?: (info: RowHoverActionInfo) => void;
+    private _rowHoverActionInfo;
+    private _rowHoverActionIcon;
+    private _rowHoverActionIconTheme;
     onModuleOverflowClick?: (modules: any[], rowData: any, rowIndex: number, colIndex: number) => void;
     onAddRow?: (groupInfo?: any) => void;
     onScroll?: (scrollX: number, scrollY: number) => void;
@@ -1013,6 +1040,10 @@ declare class DataGrid {
     onGroupHeaderStatRefresh?: (info: GroupHeaderStatRefreshInfo) => void;
     /** Footer 弹窗激活的列标识 key（弹窗打开时设置，关闭时清除），保持该列的下拉箭头和刷新图标始终显示 */
     footerPopoverActiveKey: string | null;
+    /** 人员工时图标激活状态（弹窗打开时记录 groupId，关闭时置 null），用于绘制蓝色激活图标 */
+    userWorkingHoursActiveState: {
+        groupId: string | number;
+    } | null;
     /** 组头弹窗激活状态（弹窗打开时设置，关闭时清除），包含列标识和分组 ID，确保只有对应分组的列显示激活样式 */
     groupHeaderPopoverActiveState: {
         key: string;
@@ -1571,6 +1602,12 @@ declare class DataGrid {
      * Called when data changes, interaction state changes, etc.
      */
     markDirty(): void;
+    private mergeConditionalStyle;
+    /** Apply a Worker result in one batch and trigger at most one canvas repaint. */
+    applyConditionalStylePatches(patches: ConditionalStylePatch[]): void;
+    clearConditionalStyles(rowIds?: Array<string | number>): void;
+    /** Resolve row style first, then cell style. Callers must treat the returned cache entry as read-only. */
+    getConditionalStyle(rowId: string | number | null | undefined, columnKey?: string): ConditionalStyle | undefined;
     /**
      * [PERF] 反注册本实例向 ImageManager 单例注册过的回调。
      * Vue 组件 onUnmounted 时调用，避免每次组件卸载/重建累计泄漏 callback
@@ -1921,6 +1958,12 @@ declare class DataGrid {
         y: number;
         height: number;
     } | null;
+    private getSelectedCellInfoForRow;
+    private updateRowHoverAction;
+    isRowHoverActionAt(x: number, y: number): boolean;
+    private drawRowHoverAction;
+    triggerRowHoverAction(clientX: number, clientY: number): void;
+    setRowHoverAction(action: DataGridOptions['rowHoverAction']): void;
     /**
      * 根据列 key 获取列的布局信息（精确的 x 偏移、宽度、冻结状态）
      * @param key - 列配置中的 key 属性
@@ -1978,6 +2021,8 @@ declare class DataGrid {
         width: number;
         height: number;
     } | null;
+    /** 将 Canvas viewer 的显示对象转换为可读文本，供右键等外部 UI 使用。 */
+    getCellDisplayText(cell: any): string;
     /**
      * 根据 canvas 局部坐标命中可见 cell（外部文件拖拽 hit-test 入口）。
      *
@@ -2499,6 +2544,12 @@ declare class DataGrid {
      *   若省略 groupId 但当前已有激活状态，则保留已有的 groupId（兼容外部只传 key 的调用）
      */
     setGroupHeaderPopoverActive(key: string | null, groupId?: string | number): void;
+    /**
+     * 设置人员工时图标的激活状态（弹窗打开时调用，关闭时传 null）。
+     * 与 setGroupHeaderPopoverActive 不同：专用于"工时摘要弹窗"激活态，激活时该分组行的工时图标渲染为蓝色。
+     * @param groupId - 分组 ID；传 null 表示关闭弹窗、清除激活状态
+     */
+    setUserWorkingHoursActive(groupId: string | number | null): void;
     /** 从 body.data 中查找指定 groupId 的 GroupRowData */
     private findGroupRowData;
     /**

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

@@ -116,6 +116,15 @@ declare class ImageManager {
      * @returns HTMLCanvasElement with colored icon, or null if source icon not yet loaded
      */
     getColoredFilterIcon(color: string, size?: number): HTMLCanvasElement | null;
+    /**
+     * 按目标色给"任意按需加载的图标"着色（通用版，供 GroupRow 等使用）。
+     * 复用类内已有的 recolorIcon（source-in 合成，不缓存、每次现算）。
+     * @param src 图标资源 URL（即 getCachedImage / loadImage 使用的同一个 src）
+     * @param color 目标填充色
+     * @param size 显示尺寸（正方形）
+     * @returns 着色后的 canvas；原图未加载完成时返回 null（调用方需兜底）
+     */
+    getColoredIcon(src: string, color: string, size?: number): HTMLCanvasElement | null;
     /**
      * Load settings icon (for nested column parent headers)
      */

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

@@ -271,6 +271,8 @@ export interface ThemeTokens {
     iconExpandActive: string;
     /** 筛选激活色（筛选命中该列时，筛选图标常驻且使用此色） */
     iconFilterActive: string;
+    /** 人员工时图标激活色（工时摘要弹窗打开时，该分组行工时图标使用此色） */
+    iconUserWorkingHoursActive: string;
     /** WfState 默认图标色 */
     iconWfStateDefault: string;
     /** 审核图标色 */

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

@@ -0,0 +1,4 @@
+/** Resolve the stable render row id used by both cell and row-header conditional styles. */
+export declare function getConditionalStyleRowId(rowData: Record<string, unknown> | undefined, rowKey: string, rowId?: unknown): string | number | undefined;
+/** Blend a translucent conditional background once before canvas text and icons are drawn. */
+export declare function compositeConditionalBackground(foreground: string, background: string): string;

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

@@ -1,4 +1,26 @@
 import type { ViewerOption } from './viewers/types';
+/** Runtime style produced by conditional-format rules. `null` clears an existing value. */
+export interface ConditionalStyle {
+    backgroundColor?: string | null;
+    color?: string | null;
+    fontWeight?: 'normal' | 'bold' | null;
+}
+/** A batched conditional-format update addressed by the stable DataGrid row id. */
+export interface ConditionalStylePatch {
+    rowId: string | number;
+    rowStyle?: ConditionalStyle | null;
+    cellStyles?: Record<string, ConditionalStyle | null>;
+}
+/** Immutable snapshot used by context-menu based rule creation. */
+export interface ActiveCellInfo {
+    rowId: string;
+    rowIndex: number;
+    colIndex: number;
+    columnKey: string;
+    rawValue: unknown;
+    displayValue: string;
+    rowData: Record<string, any>;
+}
 export interface CellData {
     value?: any;
     text?: string;

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

@@ -11,6 +11,8 @@ declare class PersonViewer implements CellViewer<PersonViewerData> {
     readonly type = "person";
     private imageManager;
     private _sm;
+    /** The active cell style is shared by the small person-card drawing helpers in one synchronous draw pass. */
+    private _cellStyle;
     /**
      * 每个 cell 内"被截断的 person 名称"几何缓存。
      * 二级结构 WeakMap<scope, Map<`${rowIndex}-${colIndex}`, PersonOverflowInfo[]>>：

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

@@ -23,6 +23,8 @@ declare class TaskNodeViewer implements CellViewer<TaskNodeViewerData> {
     /** 记录加载失败的图标 URL，避免反复重试 */
     private failedIcons;
     private _sm;
+    /** Conditional formatting is injected per draw and must never be cached in node data. */
+    private _cellStyle;
     private get NODE_ITEM_BG_COLOR();
     private get TEXT_COLOR();
     private get EMPTY_TEXT_COLOR();

package/dist/types/index.d.ts

@@ -8,7 +8,7 @@ import DataGrid from './components/index.vue';
 declare const install: (app: App) => void;
 export { install };
 export default DataGrid;
-export type { CellData, CellStyle, RowData, ColData, DataGridOptions, Position, Size, Rect, Range, CellRange, HistoryItem, ValidatorRule, ColumnType, ColumnConfig, SelectorState, EditorState, AutofillState, RangeState, DrawOptions, TextOptions, ClipboardState, EventHandlers, Direction, ScrollDirection, GroupLevel, SeparateLevel, BaseGroupedRowData, GroupRowData, SeparateRowData, NormalRowData, GroupedTableRowData, GroupRowStyle, SeparatorRowStyle, StatisticOption, FooterCellData, FooterData, FooterCellClickInfo, } from './core/types';
+export type { CellData, CellStyle, RowData, ColData, DataGridOptions, Position, Size, Rect, Range, CellRange, HistoryItem, ValidatorRule, ColumnType, ColumnConfig, SelectorState, EditorState, AutofillState, RangeState, DrawOptions, TextOptions, ClipboardState, EventHandlers, ConditionalStyle, ConditionalStylePatch, ActiveCellInfo, Direction, ScrollDirection, GroupLevel, SeparateLevel, BaseGroupedRowData, GroupRowData, SeparateRowData, NormalRowData, GroupedTableRowData, GroupRowStyle, SeparatorRowStyle, StatisticOption, FooterCellData, FooterData, FooterCellClickInfo, } from './core/types';
 export { isGroupRow, isSeparateRow, isNormalRow, isRowSelectable, GROUP_TABLE_CONSTANTS, DEFAULT_GROUP_STYLES, DEFAULT_SEPARATOR_STYLES, } from './core/types';
 export type { CellBounds, ViewerRenderContext, ViewerDragState, CellViewer, CellViewerData, ViewerOption, ViewerStyle, TextViewerData, DropdownViewerData, ImageViewerData, PreImageViewerData, PersonViewerData, PersonInfo, ProgressViewerData, DatetimeViewerData, CaseTimeViewerData, BooleanViewerData, StatusViewerData, StatusOption, GroupHeaderViewerData, GroupNameViewerData, GroupNameTagItem, GroupNamePersonItem, SeparatorRowViewerData, PunchViewerData, PunchValue, ModuleInfo, ModuleViewerData, TextViewerChildCountTextPart, TextViewerChildCountIconPart, TextViewerChildCountRenderResult, TextViewerChildCountRenderer, TextViewerWithSwitcherData, FileItem, FileViewerData, HyperlinkTextViewerData, IUpstreamModule, IUpstreamReminderProperties, IUpstreamSyncProperty, IUpstreamFieldViewItem, UpstreamViewerData, TaskNodeItem, TaskNodeViewerData, NestedGridViewerData, NestedColumnConfig, ViewerConstructor, ViewerFactory, ViewerTypeMap, ViewerType, TypedCellData, TableActionButtonOption, TableActionButtonViewerData, } from './core/viewers/types';
 export { isTextViewerData, isDropdownViewerData, isPersonViewerData, isProgressViewerData, isNestedGridViewerData, } from './core/viewers/types';

package/package.json

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