arthub-table 0.2.88 → 0.2.89

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,10 @@ declare class DataGrid {
     private _customTokens;
     edgeScroller: EdgeScroller;
     rowIdMap: Map<string, number>;
+    private conditionalRowStyles;
+    private conditionalCellStyles;
+    /** 行、单元格样式同时命中时复用合并结果，避免每一帧为每个单元格创建临时对象。 */
+    private resolvedConditionalCellStyles;
     selectedRowIds: Set<string>;
     selectedGroupIds: Set<string>;
     lastSelectedRowIndex: number;
@@ -980,6 +1004,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;
@@ -1575,6 +1604,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
@@ -1925,6 +1960,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 属性
@@ -1982,6 +2023,8 @@ declare class DataGrid {
         width: number;
         height: number;
     } | null;
+    /** 将 Canvas viewer 的显示对象转换为可读文本，供右键等外部 UI 使用。 */
+    getCellDisplayText(cell: any): string;
     /**
      * 根据 canvas 局部坐标命中可见 cell（外部文件拖拽 hit-test 入口）。
      *

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.88",
+  "version": "0.2.89",
   "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",