arthub-table 0.2.7-next.8 → 0.2.7

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

@@ -760,6 +760,9 @@ declare class DataGrid {
     tempValue: any;
     focusCell: any;
     enterShift: boolean;
+    _multiSelectStartX: number;
+    _multiSelectStartY: number;
+    _multiSelectThresholdMet: boolean;
     hashChange: {
         [key: string]: boolean;
     };
@@ -790,8 +793,6 @@ declare class DataGrid {
     edgeScroller: EdgeScroller;
     rowIdMap: Map<string, number>;
     selectedRowIds: Set<string>;
-    selectedGroupIds: Set<string>;
-    _groupSelectedRowIds: Map<string, string[]>;
     lastSelectedRowIndex: number;
     /** Footer 行高度（showFooter 为 false 时返回 0） */
     get footerHeight(): number;
@@ -1039,6 +1040,8 @@ declare class DataGrid {
     private static readonly MAX_CONSECUTIVE_RENDER_ERRORS;
     private _frozenOverflowWarned;
     perfMonitor: PerformanceMonitor;
+    private _imageLoadedHandler;
+    private _gifAnimationHandler;
     wfStateStyle: 'icon' | 'tag';
     /** Minimum time (ms) a loading indicator must be visible before it can be hidden */
     private static readonly MIN_LOADING_DISPLAY_MS;
@@ -1433,6 +1436,13 @@ declare class DataGrid {
      * Called when data changes, interaction state changes, etc.
      */
     markDirty(): void;
+    /**
+     * [PERF] 反注册本实例向 ImageManager 单例注册过的回调。
+     * Vue 组件 onUnmounted 时调用，避免每次组件卸载/重建累计泄漏 callback
+     * （ImageManager 是全局单例，不会被 GC，闭包持有 this 会拖住整棵 DataGrid 对象图）。
+     * 调用后再次调用是 idempotent 的（offXxx 对不存在的 callback 是 no-op）。
+     */
+    destroyImageManagerHooks(): void;
     /**
      * 注册一次性的"下一帧渲染完成后"回调。
      * 触发时机：initPaint 的 finally 块（draw 完成或抛异常后）。
@@ -2266,12 +2276,6 @@ declare class DataGrid {
      */
     private ensureRowIds;
     syncGroupCheckedState(): void;
-    /**
-     * 受控模式下：计算组头应有的 checked 状态，如果与当前不一致则通过回调通知外部修改。
-     * 逻辑与 syncGroupCheckedState 的计算一致，但不直接修改 data.checked 和 selectedGroupIds，
-     * 而是通过 onGroupCheckboxChange 回调让外部决定是否更新。
-     */
-    private _notifyGroupCheckedChanges;
     /**
      * 折叠所有任务（受控模式下触发 onCollapseAll 回调，由外部操作 tableTaskList 后刷新）
      */

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

@@ -10,6 +10,8 @@ declare class ImageManager {
     private gifImages;
     private gifAnimationManager;
     private redrawCallbacks;
+    private imageLoadedCallbacks;
+    private _imageLoadedFlushScheduled;
     private editIcon;
     private editIconCanvas;
     private editIconColor;
@@ -291,6 +293,23 @@ declare class ImageManager {
      * Trigger redraw callbacks
      */
     private triggerRedraw;
+    /**
+     * [PERF] 注册图片加载完成（成功 + 失败）后的重绘回调。
+     * 由 DataGrid 在构造时注册一次（推荐回调内仅做 markDirty，rAF 循环统一合并实际 draw）。
+     * 与 onAnimationFrame（GIF 动画帧）相互独立。
+     */
+    onImageLoaded(callback: () => void): void;
+    /**
+     * [PERF] 注销 onImageLoaded 注册的回调。
+     */
+    offImageLoaded(callback: () => void): void;
+    /**
+     * [PERF] 帧级合并触发图片加载完成后的重绘。
+     * 即便首屏一秒内 N 张图陆续 onload，本方法也只在下一帧触发 1 次回调，
+     * 让上层 DataGrid 仅 markDirty 1 次、rAF 循环只 draw 1 帧，
+     * 杜绝"事件: load → 同步 grid.draw() 串行 N 次"的长任务。
+     */
+    private scheduleImageLoadedRedraw;
     /**
      * Get GIF animation manager instance
      * @returns GifAnimationManager instance

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

@@ -217,14 +217,6 @@ export interface ThemeTokens {
     loadingColor: string;
     /** autofill 边框色 */
     autofillBorder: string;
-    /** Boolean checkbox 边框色（未勾选 + 可编辑） */
-    checkboxBorder: string;
-    /** Boolean checkbox 边框色（未勾选 + 只读） */
-    checkboxBorderDisabled: string;
-    /** Boolean checkbox 填充色（已勾选 + 可编辑） */
-    checkboxChecked: string;
-    /** Boolean checkbox 填充色（已勾选 + 只读） */
-    checkboxCheckedDisabled: string;
     /** 固定列阴影 */
     shadowFixedColumn: string;
     /** Tooltip 阴影 */

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

@@ -32,13 +32,6 @@ declare class BooleanViewer implements CellViewer<BooleanViewerData> {
     draw(context: ViewerRenderContext, data: BooleanViewerData): void;
     /**
      * Draw checkbox style
-     * Colors are sourced from theme tokens (StyleManager) so the checkbox
-     * adapts to light/dark/blue themes consistently.
-     *  - checkboxChecked        : filled bg (editable + checked)
-     *  - checkboxCheckedDisabled: filled bg (readonly + checked)
-     *  - checkboxBorder         : border    (editable + unchecked)
-     *  - checkboxBorderDisabled : border    (readonly + unchecked)
-     * `data.checkedColor` may override the editable-checked fill color.
      */
     private drawCheckbox;
     /**

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

@@ -18,9 +18,11 @@ declare class ImageViewer implements CellViewer<ImageViewerData> {
      */
     draw(context: ViewerRenderContext, data: ImageViewerData): void;
     /**
-     * 点击图片时触发 onClickImage 回调，打开图片详情弹窗
+     * 双击图片时触发 onClickImage 回调，打开图片详情弹窗
+     * 与 DOM multiImageViewer 的 dblclick 行为对齐，与文件型字段 onFileGoToDetail 一致：
+     * 单击仅选中单元格，双击图片才唤起详情页
      */
-    onClick(context: ViewerRenderContext, data: ImageViewerData, localX: number, localY: number): boolean;
+    onDblClick(context: ViewerRenderContext, data: ImageViewerData, localX: number, localY: number): boolean;
     /**
      * 鼠标悬停在图片上时显示指针光标，同时追踪悬停状态变化触发 hover 回调
      */

package/package.json

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