arthub-table 0.2.49-next.1 → 0.2.49

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

@@ -19,8 +19,9 @@ declare class CpPersonViewer implements CellViewer<CpPersonViewerData> {
     private _sm;
     /**
      * 每个 cell 内"被截断的 CP person 名称"几何缓存。
-     * Key: `${rowIndex}-${colIndex}`；不主动清理，依赖 draw 重绘覆盖。
-     * 单例 viewer，无需考虑跨 grid 隔离。
+     * 二级结构 WeakMap<scope, Map<`${rowIndex}-${colIndex}`, CpPersonOverflowInfo[]>>：
+     * - 外层 scope 区分 DataGrid 与内部 NestedGrid，避免内外层相同 rowIndex/colIndex 互相覆盖
+     * - 作用域实例被 GC 后 WeakMap 自动释放，无需主动清理
      */
     private _personOverflowCache;
     private get avatarColors();

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

@@ -10,9 +10,10 @@ import type { CellViewer, ViewerRenderContext, DropdownViewerData } from './type
 declare class DropdownViewer implements CellViewer<DropdownViewerData> {
     readonly type = "select";
     /**
-     * 多选 tag 几何与"是否截断"缓存（仅 drawMultipleTags 分支写入）。
-     * Key: `${rowIndex}-${colIndex}`；不主动清理，依赖 draw 重绘覆盖。
-     * 单例 viewer，无需考虑跨 grid 隔离。
+     * 多选 tag 几何与"是否截断"缓存（仅 drawMultipleTags / drawSingleOption 分支写入）。
+     * 二级结构 WeakMap<scope, Map<`${rowIndex}-${colIndex}`, DropdownTagOverflowInfo[]>>：
+     * - 外层 scope 区分 DataGrid 与内部 NestedGrid，避免内外层相同 rowIndex/colIndex 互相覆盖
+     * - 作用域实例被 GC 后 WeakMap 自动释放，无需主动清理
      */
     private _tagOverflowCache;
     /**

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

@@ -14,8 +14,9 @@ declare class ModuleViewer implements CellViewer<ModuleViewerData> {
     readonly type = "module";
     /**
      * drawColoredTags 时每个 cell 内所有 tag 的几何与"是否截断"信息缓存。
-     * - Key: `${rowIndex}-${colIndex}`
-     * - Value: 数组，对应 drawColoredTags 实际绘制的 tag 序列
+     * 二级结构 WeakMap<scope, Map<`${rowIndex}-${colIndex}`, ModuleTagOverflowInfo[]>>：
+     * - 外层 scope 区分 DataGrid 与内部 NestedGrid，避免内外层相同 rowIndex/colIndex 互相覆盖
+     * - 作用域实例被 GC 后 WeakMap 自动释放，无需主动清理
      *
      * 写入：drawColoredTags 末尾覆盖式写入
      * 读取：getTooltip 用 localX/localY 命中后查询

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

@@ -13,8 +13,9 @@ declare class PersonViewer implements CellViewer<PersonViewerData> {
     private _sm;
     /**
      * 每个 cell 内"被截断的 person 名称"几何缓存。
-     * Key: `${rowIndex}-${colIndex}`；不主动清理，依赖 draw 重绘覆盖。
-     * 单例 viewer，无需考虑跨 grid 隔离。
+     * 二级结构 WeakMap<scope, Map<`${rowIndex}-${colIndex}`, PersonOverflowInfo[]>>：
+     * - 外层 scope 用于区分 DataGrid 与其内部各个 NestedGrid，避免内外层 rowIndex/colIndex 相同时互相覆盖
+     * - 作用域实例被 GC 后 WeakMap 自动释放，无需主动清理
      */
     private _personOverflowCache;
     private get avatarColors();

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

@@ -11,19 +11,19 @@ declare class TextViewer implements CellViewer<TextViewerData> {
     readonly type = "text";
     /**
      * drawMultiTags 时每个 cell 内所有 tag 的几何与"是否截断"信息缓存。
-     * - Key: `${rowIndex}-${colIndex}`
-     * - Value: 数组，对应 drawMultiTags 实际绘制的 tag 序列
+     * 二级结构 WeakMap<scope, Map<`${rowIndex}-${colIndex}`, TagOverflowInfo[]>>：
+     * - 外层 scope 区分 DataGrid 与内部 NestedGrid，避免内外层相同 rowIndex/colIndex 互相覆盖
+     * - 作用域实例被 GC 后 WeakMap 自动释放，无需主动清理
      *
      * 写入：drawMultiTags 末尾覆盖式写入
      * 读取：getTooltip 用 localX/localY 命中后查询
      * 清理策略：依赖 draw 自动刷新（每次重绘同 key 覆盖），不主动清理。
-     * 该 viewer 在 ViewerRegistry 中是单例，所以缓存是单例级的，不需考虑跨 grid 隔离。
      */
     private _multiTagOverflowCache;
     /**
      * 单文本场景（普通 draw 分支）的"上一次绘制时的渲染区域"缓存。
-     * - Key: `${rowIndex}-${colIndex}`
-     * - Value: { x, y, width, height, padding, fontSize }
+     * 二级结构 WeakMap<scope, Map<`${rowIndex}-${colIndex}`, geometry>>，
+     * 区分 DataGrid 与内部 NestedGrid。
      *
      * 写入：draw() 普通文本分支末尾写入
      * 读取：getTooltip 调用时按需通过 ctx.measureText 临时判定是否溢出

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

@@ -43,6 +43,14 @@ export interface ViewerRenderContext {
     fillColor: string;
     /** Callback to request redraw */
     requestRedraw: () => void;
+    /**
+     * Cache scope key for viewer-internal per-cell caches (e.g. tag overflow info).
+     * - Top-level DataGrid cells: default = grid itself
+     * - NestedGrid inner cells: pass the inner NestedGrid instance so nested cells
+     *   don't collide with outer grid cells that share the same rowIndex/colIndex.
+     * Viewers should use this via `resolveCacheScope(context)` from `./utils`.
+     */
+    cacheScope?: object;
     /** 鼠标点击时的视口 clientX（仅在 onClick/onDblClick 调用链中可用） */
     clientX?: number;
     /** 鼠标点击时的视口 clientY（仅在 onClick/onDblClick 调用链中可用） */

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

@@ -17,3 +17,17 @@ export declare function resolveCssColor(color: string | undefined | null, fallba
  * 在主题切换等场景下调用，确保重新解析颜色
  */
 export declare function clearCssColorCache(): void;
+/**
+ * 解析 viewer 缓存作用域。
+ * NestedGrid 会显式传入 cacheScope（内层 NestedGrid 实例），保证内层 cell 与外层 cell
+ * 的缓存互不覆盖；未显式传入时回退到 context.grid（外层 DataGrid 实例）。
+ */
+export declare function resolveCacheScope(context: {
+    grid: object;
+    cacheScope?: object;
+}): object;
+/**
+ * 从二级 WeakMap 缓存中按作用域取子 Map，作用域被 GC 后自动释放，避免内存泄漏。
+ * 用法：const cache = getPerScopeCache(this._weakCache, resolveCacheScope(context));
+ */
+export declare function getPerScopeCache<K, V>(perScopeCaches: WeakMap<object, Map<K, V>>, scope: object): Map<K, V>;

package/dist/types/testing/TestHooks.d.ts

@@ -213,6 +213,12 @@ export interface TestHooksAPI {
      * @returns Row data object or null if not found
      */
     getRowData: (rowId: string | number) => Record<string, any> | null;
+    /**
+     * 返回当前 body.data 的浅拷贝（视觉顺序），每项含 id / nodeId / name。
+     * 用于 e2e 在视觉顺序下批量获取主任务 rowId（pipeline-count-display 等场景）。
+     * 不存在 body.data 时回退到 _fullData。
+     */
+    getDataRows: () => Array<Record<string, any>>;
     /**
      * 获取组头行搜索命中高亮状态。
      *

package/package.json

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