arthub-table 0.2.89 → 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,6 +12,7 @@ import Histories from "./History";
 import { StyleManager, type TableTheme } from "./StyleManager";
 import EdgeScroller from "./EdgeScroller";
 import { type HeaderConfig } from "./util";
+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 {
@@ -693,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;
@@ -884,8 +897,6 @@ declare class DataGrid {
     rowIdMap: Map<string, number>;
     private conditionalRowStyles;
     private conditionalCellStyles;
-    /** 行、单元格样式同时命中时复用合并结果，避免每一帧为每个单元格创建临时对象。 */
-    private resolvedConditionalCellStyles;
     selectedRowIds: Set<string>;
     selectedGroupIds: Set<string>;
     lastSelectedRowIndex: number;
@@ -1325,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;

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/package.json

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