arthub-table 0.2.88 → 0.2.90-next.0

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

@@ -76,6 +76,18 @@ export interface DataGridInitOptions {
     theme?: string | Record<string, any>;
     /** WfState Viewer 显示样式：'icon'=图标+文字（默认），'tag'=色块标签 */
     wfStateStyle?: 'icon' | 'tag';
+    /**
+     * Reminder 蓝色三角的锚点位置（4 个角可选），默认 'top-right'（右上角）。
+     * 由业务侧按场景覆盖（例如 AssetMatrix 和平玩法传 'top-left' 把角标挪到左上角）。
+     * 三角形状会随 anchor 等效镜像翻转，保持视觉对称。
+     */
+    remindAnchor?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    /**
+     * Reminder 蓝色三角的点击命中热区边长（像素，正方形）。
+     * 默认沿用可视三角边长 18（保持历史行为），业务侧可放大到 20/24 以便用户命中触发弹窗。
+     * 命中区是以 anchor 对应角为起点、朝单元格内部延伸的 size×size 正方形（独立于可视三角）。
+     */
+    remindHitAreaSize?: number;
     /** 嵌套表格数据源字段名，默认 '$$pipelineView$$' */
     pipelineViewKey?: string;
     /** 嵌套表格折叠时默认显示行数，默认 3 */

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

@@ -3,6 +3,7 @@ import Validator from "./Validator";
 import NestedGrid from "./NestedGrid";
 import type DataGrid from "./DataGrid";
 import type { ColumnConfig } from "./types";
+import { type RemindAnchor } from "./constants";
 import { type CellViewerData, type ViewerRenderContext } from "./viewers";
 interface Column extends ColumnConfig {
     [key: string]: any;
@@ -143,8 +144,14 @@ declare class Cell extends Context {
         [key: string]: any;
     } | null;
     /**
-     * 判断鼠标坐标是否在蓝色提醒三角区域内（右上角 18x18 三角形）
-     * 三角区域为：(right-18, top), (right, top), (right, top+18) 构成的直角三角形
+     * 判断鼠标坐标是否在蓝色提醒三角的命中热区内。
+     *
+     * 命中热区是以 anchor 对应角为起点、朝单元格内部延伸的 size×size 正方形。
+     * 热区尺寸由 grid.remindHitAreaSize 控制（默认与可视三角边长一致 18px），
+     * 业务侧可按场景放大到 20/24 以便用户点击触发弹窗。
+     *
+     * 注意：热区是矩形而非三角，这样热区放大时在整个角都可命中、点击体验更好。
+     *
      * @param mouseX 鼠标在 canvas 上的 x 坐标（已经过 scrollX 修正的坐标）
      * @param mouseY 鼠标在 canvas 上的 y 坐标（已经过 scrollY 修正的坐标）
      * @param cellX 单元格左上角 x（已含 scroll/fixed 偏移）
@@ -152,4 +159,34 @@ declare class Cell extends Context {
      */
     isInsideReminderTriangle(mouseX: number, mouseY: number, cellX: number, cellY: number): boolean;
 }
+/**
+ * 计算 reminder 三角形在指定 anchor 下的 3 个顶点。
+ * 三角形是直角三角，直角始终贴在 anchor 对应的角上，斜边指向单元格内部（等效镜像翻转）。
+ *
+ * @param x 单元格左上角 x
+ * @param y 单元格左上角 y
+ * @param width 单元格宽
+ * @param height 单元格高
+ * @param size 三角边长
+ * @param anchor 锚点位置
+ */
+declare function computeReminderTrianglePoints(x: number, y: number, width: number, height: number, size: number, anchor: RemindAnchor): number[][];
+/**
+ * 计算 reminder 点击命中热区（正方形）。
+ * 热区以 anchor 对应角为起点、朝单元格内部延伸 size 长度。
+ *
+ * @param cellX 单元格左上角 x
+ * @param cellY 单元格左上角 y
+ * @param width 单元格宽
+ * @param height 单元格高
+ * @param size 热区边长
+ * @param anchor 锚点位置
+ */
+declare function computeReminderHitRect(cellX: number, cellY: number, width: number, height: number, size: number, anchor: RemindAnchor): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export { computeReminderTrianglePoints, computeReminderHitRect };
 export default Cell;

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

@@ -12,7 +12,8 @@ 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 RemindAnchor } from "./constants";
+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 +138,8 @@ interface RowContextMenuInfo {
     clientX: number;
     /** 鼠标屏幕 Y 坐标 */
     clientY: number;
+    /** 右键发生时的不可变源单元格快照，供“快速生成规则”使用。 */
+    sourceCell?: ActiveCellInfo;
     /** Canvas 行索引（供外部通过 isRowCheckedByIndex 查询选中状态） */
     _canvasRowIndex?: number;
     /** 右键行是否处于选中（checked）状态 */
@@ -146,6 +149,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 +446,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;
     /** 表头排序图标点击回调 */
@@ -673,6 +694,18 @@ export interface DataGridOptions {
         };
         rowData: Record<string, any>;
     }) => void;
+    /**
+     * Reminder 蓝色三角的锚点位置（4 个角可选），默认 'top-right'（右上角）。
+     * 由业务侧按场景覆盖（如 AssetMatrix 和平玩法传 'top-left' 把角标挪到左上角）。
+     * 三角形状会随 anchor 做等效镜像翻转，保持视觉对称。
+     */
+    remindAnchor?: RemindAnchor;
+    /**
+     * Reminder 蓝色三角的点击命中热区边长（像素，正方形）。
+     * 默认 18（与可视三角一致），业务侧可放大到 20/24 以便用户点击触发弹窗。
+     * 命中区是以 anchor 对应角为起点、朝单元格内部延伸的 size×size 正方形。
+     */
+    remindHitAreaSize?: number;
     /** 表头 Link icon hover 回调：鼠标悬停/离开引用字段表头 link icon 时触发 */
     onHeaderLinkIconHover?: (info: {
         show: boolean;
@@ -862,6 +895,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 +1015,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;
@@ -1296,6 +1336,10 @@ declare class DataGrid {
         };
         rowData: Record<string, any>;
     }) => void;
+    /** Reminder 蓝色三角的锚点位置（4 个角可选），默认 'top-right'。 */
+    remindAnchor: RemindAnchor;
+    /** Reminder 蓝色三角的点击命中热区边长（像素，正方形）。 */
+    remindHitAreaSize: number;
     onHeaderLinkIconHover?: (info: {
         show: boolean;
         colKey: string;
@@ -1575,6 +1619,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 +1975,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 +2038,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/constants.d.ts

@@ -29,6 +29,21 @@ export declare const ERROR_TIP_COLOR: string;
 /** @deprecated 请使用 styleManager.getToken('reminderColor') */
 export declare const REMINDER_TIP_COLOR: string;
 export declare const REMINDER_TRIANGLE_SIZE = 18;
+/**
+ * 蓝色提醒三角的锚点位置（4 个角可选）。
+ * 默认 'top-right'（右上角），与历史渲染行为保持一致。
+ * 由业务侧（如 AssetMatrix）按场景/玩法通过 DataGridOptions.remindAnchor 覆盖。
+ */
+export type RemindAnchor = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export declare const REMINDER_ANCHOR_DEFAULT: RemindAnchor;
+/**
+ * 蓝色提醒三角的点击命中热区尺寸（像素，正方形边长）。
+ * 默认沿用 REMINDER_TRIANGLE_SIZE（18px）保持历史点击面积；
+ * 业务侧（如 AssetMatrix 和平玩法）可通过 DataGridOptions.remindHitAreaSize 放大为 20/24 等，
+ * 便于用户命中以触发外部 Reminder 弹窗（点击行为，非 hover）。
+ * 命中区是以 anchor 对应角为起点、朝单元格内部延伸的 size×size 正方形（独立于可视三角大小）。
+ */
+export declare const REMINDER_HIT_AREA_SIZE_DEFAULT = 18;
 /** @deprecated 请使用 styleManager.getToken('textHeader') */
 export declare const HEADER_TEXT_COLOR: 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.90-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",