arthub-table 0.2.0-beta.4 → 0.2.0-beta.41

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

@@ -79,6 +79,8 @@ declare class NestedGrid {
     parentRowBgColor: string | undefined;
     private redrawScheduled;
     private redrawTimer;
+    private _lastHoverViewerType;
+    private _lastHoverViewerData;
     selectionRange: SelectionRange | null;
     selectionAnchor: SelectionAnchor | null;
     selectionEnd: SelectionAnchor | null;
@@ -106,6 +108,15 @@ declare class NestedGrid {
         startValue: number;
         currentValue: number;
     };
+    rowDrag: {
+        pending: boolean;
+        isDragging: boolean;
+        fromRowIndex: number;
+        currentRowIndex: number;
+        position: 'front' | 'tail' | null;
+        mouseDownY: number;
+        ghostEl: HTMLDivElement | null;
+    };
     constructor(options: NestedGridOptions);
     getColumnWidth(index: number): number;
     getCellBounds(colIndex: number, rowIndex: number): {
@@ -125,12 +136,18 @@ declare class NestedGrid {
         row: number;
     } | null;
     handleMouseMove(mouseX: number, mouseY: number): boolean;
+    /**
+     * Reset the last hovered viewer's state (e.g. hide image popper).
+     * Called when mouse leaves the nested grid or moves to non-cell areas.
+     */
+    resetLastHoverViewer(): void;
     private isProgressCell;
     private isMouseOnProgressBar;
     handleMouseDown(mouseX: number, mouseY: number, e?: {
         ctrlKey?: boolean;
         metaKey?: boolean;
         shiftKey?: boolean;
+        altKey?: boolean;
         button?: number;
     }): boolean;
     private handleProgressDragMove;
@@ -139,7 +156,7 @@ declare class NestedGrid {
         col: number;
         row: number;
     }): boolean;
-    isCellEditable(colIndex: number): boolean;
+    isCellEditable(colIndex: number, rowIndex?: number): boolean;
     getSelectLabel(colIndex: number, value: any): string;
     /**
      * 处理右键菜单事件，返回上下文信息
@@ -192,6 +209,31 @@ declare class NestedGrid {
             parentColKey: string;
         };
     } | null;
+    /**
+     * Handle double-click inside nested grid.
+     * Delegates to viewer.onDblClick (e.g. FileViewer opens file detail on dblclick).
+     * Returns true if the double-click was handled by a viewer.
+     */
+    handleDblClick(mouseX: number, mouseY: number): {
+        type: 'editIcon';
+        cell: {
+            row: number;
+            col: number;
+        };
+        editInfo: {
+            bounds: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+            column: any;
+            value: any;
+            rowData: any;
+            parentRowData: any;
+            parentColKey: string;
+        };
+    } | null;
     /**
      * Check if mouse is on the boolean checkbox area within a cell
      */
@@ -230,6 +272,19 @@ declare class NestedGrid {
      * 以避免 autofill 手柄等突出 Cell 边界的元素被裁剪掉。
      */
     drawOverlays(): void;
+    /**
+     * 创建跟随鼠标的 DOM 浮层（Alt 子行拖动排序专用）。
+     * 样式与主表 DataGrid.createDragGhostEl 对齐，显示被拖子行的 name 字段值。
+     */
+    private createRowDragGhostEl;
+    /**
+     * 更新浮层位置，读取 DataGrid 缓存的最新鼠标 client 坐标（Events.ts handleMouseMove 中写入）。
+     */
+    private updateRowDragGhostPosition;
+    /**
+     * 从 DOM 中移除浮层元素。
+     */
+    private removeRowDragGhostEl;
     clearOtherNestedGridsSelection(): void;
     /**
      * 收集同列所有有选区的嵌套子表信息，触发 onNestedSelectionChange 回调
@@ -340,6 +395,11 @@ declare class NestedGrid {
      * 处理不同类型数据的包装和转换
      */
     private buildNestedViewerData;
+    /**
+     * Draw loading indicator for a nested cell.
+     * Mirrors Cell.drawLoadingIndicator logic: rotating icon at cell right side.
+     */
+    private drawNestedLoadingIndicator;
     /**
      * 兜底文本渲染（当 viewer 不可用时）
      */

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

@@ -272,6 +272,16 @@ export interface GroupRowData extends BaseGroupedRowData {
     hook_mark?: 'green' | 'blue';
     /** 图标容器背景色 */
     mark_bg_color?: 'purple';
+    /**
+     * 组头行是否被快捷搜索命中（searchMatchList 中存在 isGroupHeader: true 且 id 匹配的条目）。
+     * 由 rowDataAdapter.preprocessRow 在组头行上注入，供 GroupRow 渲染时查询。
+     */
+    _groupHeaderSearchMatched?: boolean;
+    /**
+     * 组头行是否是"当前高亮"命中项（命中条目中存在 highlight: true 的 field）。
+     * 当为 true 时 GroupRow 会绘制 2px 橙色 inset 边框。
+     */
+    _groupHeaderSearchCurrentHighlight?: boolean;
 }
 /**
  * Separate row data

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

@@ -110,9 +110,9 @@ declare class FileViewer implements CellViewer<FileViewerData> {
      */
     /**
      * 绘制交付物角标（右下角圆形图标）
-     * 与 DOM .mark-icon 样式对齐：
-     * - ah-icon_finish1: 白底 + 绿色 #00bd77 勾（已完成）
-     * - ah-icon_help2: 白底 + 橙色 #ed954f 问号（待验收）
+     * 与 DOM .mark-icon iconfont 图标对齐：
+     * - ah-icon_finish1: 绿色 #00bd77 圆形背景 + 白色勾（已完成）
+     * - ah-icon_help2: 橙色 #ed954f 圆形背景 + 白色问号（待验收）
      */
     private drawMarkIcon;
     private drawIconByFileStatus;

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

@@ -62,9 +62,9 @@ declare class ImageViewer implements CellViewer<ImageViewerData> {
     private drawSinglePlaceholder;
     /**
      * 绘制交付物角标（右下角圆形图标）
-     * 与 DOM .mark-icon 样式对齐：
-     * - ah-icon_finish1: 白底 + 绿色 #00bd77 勾（已完成）
-     * - ah-icon_help2: 白底 + 橙色 #ed954f 问号（待验收）
+     * 与 DOM .mark-icon iconfont 图标对齐：
+     * - ah-icon_finish1: 绿色 #00bd77 圆形背景 + 白色勾（已完成）
+     * - ah-icon_help2: 橙色 #ed954f 圆形背景 + 白色问号（待验收）
      */
     private drawMarkIcon;
     /**

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

@@ -1,6 +1,12 @@
 /**
  * PivotViewer - 引用类型 Viewer
- * 在 canvas 单元格中渲染引用属性值，支持关联图标、悬停下划线和点击交互
+ * 在 canvas 单元格中渲染引用属性值，支持关联图标、悬停下划线和点击交互。
+ *
+ * 根据 pivotFieldViewer 委托给子 viewer 渲染：
+ * - 'person' → PersonViewer（人员头像 + 名称）
+ * - 'image' → ImageViewer（交付物缩略图）
+ * - 'wf-state' → WfStateViewer（工作流状态图标 + 名称）
+ * - 其他 / undefined → 默认文本渲染（当前逻辑）
  */
 import type { CellViewer, ViewerRenderContext, PivotViewerData } from './types';
 declare class PivotViewer implements CellViewer<PivotViewerData> {
@@ -11,18 +17,53 @@ declare class PivotViewer implements CellViewer<PivotViewerData> {
      * 解析 value，返回有效的显示文本或 null
      */
     private parseValue;
+    /**
+     * 判断是否应该委托给子 viewer 渲染
+     */
+    private shouldDelegate;
     /**
      * 绘制单元格内容
      */
     draw(context: ViewerRenderContext, data: PivotViewerData): void;
+    /**
+     * 委托给子 viewer 渲染
+     * 构造子 viewer 期望的 bounds（减去关联图标区域），然后调用子 viewer.draw()
+     */
+    private drawDelegated;
+    /**
+     * 默认文本模式渲染（原有逻辑）
+     */
+    private drawTextMode;
     /**
      * 处理点击事件
      */
     onClick(context: ViewerRenderContext, data: PivotViewerData, localX: number, localY: number): boolean;
+    /**
+     * 委托模式下的点击处理
+     */
+    private onClickDelegated;
+    /**
+     * 处理双击事件
+     * 对于 image 类型的 pivot 字段，双击图片打开文件详情页（与普通 file 列双击行为一致）。
+     * 实现方式：委托给 ImageViewer.onClick 检测点击位置，但用桥接回调将 onClickImage 转为 onFileGoToDetail。
+     */
+    onDblClick(context: ViewerRenderContext, data: PivotViewerData, localX: number, localY: number): boolean;
+    /**
+     * 构造子 viewer 的 data（公共逻辑提取）
+     */
+    private buildSubViewerData;
+    /**
+     * 构造子 viewer 的 context（公共逻辑提取）
+     */
+    private buildSubViewerContext;
     /**
      * 获取交互光标
      */
     getInteractiveCursor(context: ViewerRenderContext, data: PivotViewerData, localX: number, localY: number): string | null;
+    /**
+     * 委托模式下的光标处理
+     */
+    private getInteractiveCursorDelegated;
     /**
      * 绘制占位符文本
      */

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

@@ -0,0 +1,76 @@
+/**
+ * RelatedTaskViewer - Related task cell renderer (Canvas implementation)
+ * Displays the first related task's configured display fields.
+ *
+ * Layout modes:
+ *   - Single-line (default): task name | thumbnails | "label: value" pairs — all horizontal, vertically centered
+ *   - Multi-line (when row is expanded by nested columns): one field per line, vertically stacked
+ */
+import type { CellViewer, ViewerRenderContext, RelatedTaskViewerData } from './types';
+declare class RelatedTaskViewer implements CellViewer<RelatedTaskViewerData> {
+    readonly type = "related-task";
+    private imageManager;
+    /** Track failed image URLs to avoid retrying */
+    private failedImages;
+    private _sm;
+    private get TEXT_COLOR();
+    private get LABEL_COLOR();
+    private get EMPTY_TEXT_COLOR();
+    private get DASHED_BORDER_COLOR();
+    constructor();
+    /**
+     * Calculate thumbnail height for single-line mode.
+     * Max height = cell height - top/bottom padding (4px each).
+     */
+    private getSingleLineThumbnailHeight;
+    /**
+     * Calculate thumbnail width for a given image, maintaining aspect ratio.
+     * If no image is cached yet, returns thumbHeight (square placeholder).
+     */
+    private getThumbnailWidth;
+    /**
+     * Draw an image within the given area according to the specified fit mode.
+     * Mirrors the logic in FileViewer.drawPreviewImage and ImageViewer.drawImageWithFit.
+     */
+    private drawImageWithFit;
+    /**
+     * Draw the related task cell content
+     */
+    draw(context: ViewerRenderContext, data: RelatedTaskViewerData): void;
+    private drawSingleLine;
+    /**
+     * Draw a single inline thumbnail at the given position (for single-line mode).
+     * @returns The X position after the thumbnail(s)
+     */
+    private drawInlineThumbnail;
+    private drawMultiLine;
+    /**
+     * Draw empty placeholder — consistent with other viewers
+     */
+    private drawEmptyPlaceholder;
+    /**
+     * Draw a file status/format icon when coverUrl is not available.
+     * Uses the same getIconByFileStatus logic as FileViewer for visual consistency.
+     */
+    private drawFileStatusIcon;
+    /**
+     * Draw a dashed rectangle placeholder for unloaded/missing images
+     */
+    private drawDashedPlaceholder;
+    /**
+     * Truncate text to fit within maxWidth, appending ellipsis if needed
+     */
+    private truncateText;
+    /**
+     * Handle click events on the cell.
+     * Detects clicks on file thumbnails and triggers onFileGoToDetail callback.
+     */
+    onClick(context: ViewerRenderContext, data: RelatedTaskViewerData, localX: number, localY: number): boolean;
+    /**
+     * Get cursor style for hover — show pointer on file thumbnails
+     */
+    getHitArea(context: ViewerRenderContext, data: RelatedTaskViewerData, localX: number, localY: number): string | null;
+    private calculateSingleLineThumbnailAreas;
+    private calculateMultiLineThumbnailAreas;
+}
+export default RelatedTaskViewer;

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

@@ -148,10 +148,30 @@ declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitche
      * Calculate layout bounds for a given data set (used by onClick/getInteractiveCursor)
      */
     private calcLayoutBounds;
+    /**
+     * Hit-test whether the given local coordinate lands on an interactive hot area.
+     * Pure query, no side effects. Used by Row.mouseDown to decide whether selectCell
+     * should skip horizontal auto-scroll (so the subsequent click event still hits
+     * the same hot area instead of drifting to a blank region after the scroll).
+     *
+     * Covered hot areas (MUST stay in sync with onClick):
+     *   - expand area (tree expand/collapse)
+     *   - task icon area (onClickIcon jump)
+     *   - text area (精确到 actualTextWidth，与 onClick 一致)
+     *   - totalNum area (child count badge)
+     */
+    hitTest(context: ViewerRenderContext, data: TextViewerWithSwitcherData, localX: number, localY: number): boolean;
+    /**
+     * 判断 localY 是否落在文字的垂直命中区域内。
+     * 文字以 textBaseline='middle' 绘制在单元格垂直中线 (height/2)，
+     * 命中区为 [mid - fontSize/2 - buffer, mid + fontSize/2 + buffer]，
+     * 避免点击文字上下空白区域时误触发文字点击回调。
+     */
+    private isInsideTextVerticalRange;
     /**
      * Handle click events on the cell
      */
-    onClick(context: ViewerRenderContext, data: TextViewerWithSwitcherData, localX: number, _localY: number): boolean;
+    onClick(context: ViewerRenderContext, data: TextViewerWithSwitcherData, localX: number, localY: number): boolean;
     /**
      * Handle double-click: suppress editing when dblclick lands on the expand/collapse area.
      * Without this, rapidly toggling expand/collapse triggers a dblclick that enters edit mode.
@@ -160,7 +180,7 @@ declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitche
     /**
      * Get interactive cursor for hover areas
      */
-    getInteractiveCursor(context: ViewerRenderContext, data: TextViewerWithSwitcherData, localX: number, _localY: number): string | null;
+    getInteractiveCursor(context: ViewerRenderContext, data: TextViewerWithSwitcherData, localX: number, localY: number): string | null;
     /**
      * Get tooltip text when mouse hovers over task icon or IOMC order state icon.
      * - Task icon: returns data.iconTooltip (pre-computed from iconFile by AssetMatrix)

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

@@ -40,6 +40,7 @@ export { default as ModuleColExpandViewer } from './ModuleColExpandViewer';
 export { default as ChildrenViewer } from './ChildrenViewer';
 export { default as OnlyShowErrorViewer } from './OnlyShowErrorViewer';
 export { default as PerspectiveViewer } from './PerspectiveViewer';
+export { default as RelatedTaskViewer } from './RelatedTaskViewer';
 import TextViewer from './TextViewer';
 import DropdownViewer from './DropdownViewer';
 import ImageViewer from './ImageViewer';
@@ -76,6 +77,7 @@ import ModuleColExpandViewer from './ModuleColExpandViewer';
 import ChildrenViewer from './ChildrenViewer';
 import OnlyShowErrorViewer from './OnlyShowErrorViewer';
 import PerspectiveViewer from './PerspectiveViewer';
+import RelatedTaskViewer from './RelatedTaskViewer';
 /**
  * Register all default viewers
  * Call this function once during application initialization
@@ -126,4 +128,5 @@ export declare const defaultViewers: {
     children: typeof ChildrenViewer;
     'only-show-error': typeof OnlyShowErrorViewer;
     perspective: typeof PerspectiveViewer;
+    'related-task': typeof RelatedTaskViewer;
 };

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

@@ -100,6 +100,25 @@ export interface CellViewer<T extends CellViewerData = CellViewerData> {
      * @returns true if the event was handled (prevents default edit behavior)
      */
     onDblClick?(context: ViewerRenderContext, data: T, localX: number, localY: number): boolean;
+    /**
+     * Optional: Query whether the given local coordinate hits an interactive hot area.
+     * Pure side-effect-free lookup used at mousedown time to decide whether the cell
+     * selection should skip horizontal auto-scroll (so a subsequent click can hit the
+     * same hot area that would otherwise drift out from under the cursor).
+     *
+     * Contract:
+     *   - MUST NOT draw, mutate data/context, or trigger any callback.
+     *   - Return value semantics: true = clickable hot area hit; false = no hit.
+     *   - Not implementing this method is equivalent to returning false (no effect on
+     *     existing auto-scroll behavior for viewers that don't opt in).
+     *
+     * @param context Render context
+     * @param data Cell data
+     * @param localX Mouse X position relative to cell
+     * @param localY Mouse Y position relative to cell
+     * @returns true if the position hits an interactive/clickable hot area
+     */
+    hitTest?(context: ViewerRenderContext, data: T, localX: number, localY: number): boolean;
     /**
      * Optional: Get the preferred height for this cell
      * @param context Render context
@@ -625,6 +644,8 @@ export interface TextViewerWithSwitcherData extends CellViewerData {
     iconTooltip?: string;
     /** 商业化单子数（仅商业化库 name 列，由 businessData[rowId] 注入） */
     businessOrderCount?: number;
+    /** 点击任务图标回调（如跳转 TAPD 页面），与 DOM 版 onClickNameIcon + iconJumpUrl 对齐 */
+    onClickIcon?: (rowData: Record<string, any>) => void;
 }
 /**
  * 文件项信息
@@ -657,6 +678,8 @@ export interface FileViewerData extends CellViewerData {
     key?: string;
     /** 是否可编辑 */
     canEdit?: boolean;
+    /** 隐藏右侧操作区域（编辑笔/查看图标），用于嵌套表格中由 NestedGrid 层统一绘制编辑笔 */
+    hideAfterArea?: boolean;
     /** 是否显示删除线 */
     showLineThrow?: boolean;
     /** 是否关联属性 */
@@ -975,6 +998,20 @@ export interface FileStorageSpecViewerData extends CellViewerData {
 /**
  * 引用类型 Viewer 数据接口
  * 接收业务层将引用属性值格式化后传入的显示文本
+ *
+ * 支持根据 pivotFieldViewer 委托给子 viewer 渲染：
+ * - 'person' → PersonViewer（人员头像 + 名称）
+ * - 'image' → ImageViewer（交付物缩略图）
+ * - 'wf-state' → WfStateViewer（工作流状态图标 + 名称）
+ * - 其他 / undefined → 默认文本渲染
+ *
+ * 数据流：
+ * 1. rowDataAdapter.transformPivotValue 将 PivotValueItem[] 转为结构化对象
+ *    （包含 pivotFieldViewer + 原始子字段值 pivotRawValue）
+ * 2. cellValueTransformer（AssetMatrix 侧）根据 pivotFieldViewer 调用对应的
+ *    _transformPersonValue / _transformWfStateValue 等方法，将 pivotRawValue
+ *    转为子 viewer 期望的格式，写入 pivotData
+ * 3. PivotViewer.draw() 根据 pivotFieldViewer 委托给对应 viewer 实例绘制
  */
 export interface PivotViewerData extends CellViewerData {
     /** 引用属性的格式化显示文本（由业务层将 pivotField 解析后传入） */
@@ -983,6 +1020,33 @@ export interface PivotViewerData extends CellViewerData {
     placeholder?: string;
     /** 是否为关联属性（为 true 时显示关联图标） */
     isLink?: boolean;
+    /**
+     * pivotField 对应的 viewer 类型（Canvas 映射后的类型名，如 'person'、'image'、'wf-state'）。
+     * 由 transformPivotValue 从 pivotResolver 获取并注入。
+     * 当此字段存在且非 'text' 时，PivotViewer 会委托给对应的子 viewer 渲染。
+     */
+    pivotFieldViewer?: string;
+    /**
+     * pivotField 的原始值（从 PivotValueItem[0][pivotField] 提取）。
+     * 由 transformPivotValue 注入，供 cellValueTransformer 进一步转换。
+     * 例如：person 类型为 accountName string，wf-state 类型为 state ID number。
+     */
+    pivotRawValue?: any;
+    /**
+     * 子 viewer 的已转换数据（由 cellValueTransformer 写入）。
+     * 例如：person 类型为 PersonInfo[]，wf-state 类型为 WfStateViewerData 对象。
+     * PivotViewer.draw() 将此数据传给对应子 viewer 的 draw() 方法。
+     */
+    pivotData?: any;
+    /**
+     * 交付物图片的 assetId 列表（仅 pivotFieldViewer === 'image' 时有值）。
+     * 由 transformPivotValue 从 deliverable 对象中提取，用于双击打开文件详情。
+     */
+    pivotAssetIds?: number[];
+    /** 双击文件项回调（打开文件详情，由 DataGridIntegration 从 fileCallbacks 注入） */
+    onFileGoToDetail?: (file: any, data: any) => void;
+    /** 点击图片回调（打开图片预览，由 DataGridIntegration 从 imageCallbacks 注入） */
+    onClickImage?: (imgUrls: string[], initIndex: number, assetIds: (number | string | undefined)[], data: any) => void;
 }
 /**
  * 工作流 Viewer 数据接口
@@ -1260,3 +1324,56 @@ export interface RichTextViewerData extends CellViewerData {
     /** 占位符文本，默认 '-' */
     placeholder?: string;
 }
+/**
+ * Related-task display field item
+ */
+export interface RelatedTaskDisplayField {
+    /** Field key (e.g. 'estimate_start_date') */
+    key: string;
+    /** Field display label (e.g. '预计开始时间') */
+    label: string;
+    /** Raw field value */
+    value: any;
+    /** Formatted display value (e.g. '2026/03/02') */
+    displayValue: string;
+    /** Whether this field is a file-type field */
+    isFileType: boolean;
+    /** File data for file-type fields (cover images, etc.) */
+    fileData?: Array<{
+        coverUrl: string;
+        assetId?: number;
+        status?: number;
+        fileFormat?: string;
+    }>;
+    /** File meta key for file-type fields (e.g. 'deliverable') */
+    fileMeta?: string;
+    /** Node ID that owns this file (for opening asset detail) */
+    nodeId?: number;
+}
+/**
+ * Related-task Viewer data interface
+ * Displays the first related task's configured display fields
+ */
+export interface RelatedTaskViewerData extends CellViewerData {
+    /** Structured value containing related task info */
+    value: {
+        /** First related task node ID */
+        firstRelatedTaskId: number;
+        /** First related task name */
+        firstRelatedTaskName: string;
+        /** Display label for the task name field (e.g. "名称") */
+        firstRelatedTaskLabel?: string;
+        /** All related node IDs (for future interactions) */
+        allRelatedNodeIds: number[];
+        /** Display fields with resolved values */
+        displayFields: RelatedTaskDisplayField[];
+    } | null;
+    /** Thumbnail fit mode for file-type fields (synced from imageDisplayMode config) */
+    thumbnailFit?: 'contain' | 'cover' | 'fill' | 'height-full' | 'width-full';
+    /** Callback when user clicks a file thumbnail — opens asset detail page */
+    onFileGoToDetail?: (file: {
+        assetId: number;
+        id: number;
+        ids: number[];
+    }, data: any) => void;
+}

package/dist/types/index.d.ts

@@ -41,7 +41,7 @@ export { CSS_PREFIX, HEADER_HEIGHT, ROW_INDEX_WIDTH, CHECK_BOX_WIDTH, CELL_HEIGH
 export { getFieldStatisticTypes } from './core/footer/utils';
 export { convertToDataGridColumns, } from './adapters/columnAdapter';
 export type { ITableHeader, } from './adapters/columnAdapter';
-export { convertToDataGridRows, isPerfLogEnabled, } from './adapters/rowDataAdapter';
+export { convertToDataGridRows, isPerfLogEnabled, rebuildNestedColumnData, } from './adapters/rowDataAdapter';
 export type { PreprocessedRow, } from './adapters/rowDataAdapter';
 export { preprocessRowStyles, } from './adapters/styleAdapter';
 export type { RowStyleResult, } from './adapters/styleAdapter';