arthub-table 0.2.0-beta.2 → 0.2.0-beta.21

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

@@ -194,3 +194,17 @@ export declare function preprocessSingleRow(rawRow: Record<string, any>, allHead
     controllerProps: Record<string, any>;
     tableIndex?: number;
 }): PreprocessedRow;
+/**
+ * Rebuild _nestedData for specific nested columns on given preprocessed rows.
+ *
+ * This extracts the nested data construction logic from convertToDataGridRows,
+ * allowing incremental rebuild of _nestedData when a child column's data changes
+ * (e.g. file/image upload in a nested sub-table) without a full data refresh.
+ *
+ * @param rows - Preprocessed row array (same as body.data / _dataGridData)
+ * @param rawRows - Raw row data array (same as tableDataList)
+ * @param nestedParentKeys - Keys of the nested parent columns to rebuild
+ * @param allHeaders - All column headers (including nested columns with children)
+ * @param props - Controller props (pipelineViewKey, displayTaskNum, iconUrlPrefix, etc.)
+ */
+export declare function rebuildNestedColumnData(rows: PreprocessedRow[], rawRows: Record<string, any>[], nestedParentKeys: string[], allHeaders: ITableHeader[], props: Record<string, any>): void;

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

@@ -50,6 +50,7 @@ interface AutofillState {
 }
 interface RowDragState {
     isDragging: boolean;
+    dragStartX: number;
     dragStartY: number;
     draggedRowIndices: number[];
     dropIndicatorType: 'line' | 'overlay' | null;
@@ -500,7 +501,13 @@ export interface DataGridOptions {
             height: number;
         };
     }) => void;
-    /** 折叠所有任务回调 */
+    /** 嵌套表格展开/收起回调：展开全部或收起按钮点击时触发，用于通知业务层更新数据 */
+    onNestedExpandToggle?: (info: {
+        parentRowData: any;
+        parentColKey: string;
+        parentRowIndex: number;
+        expanded: boolean;
+    }) => void;
     onCollapseAll?: () => void;
     /** 展开所有任务回调 */
     onExpandAll?: () => void;
@@ -951,6 +958,8 @@ declare class DataGrid {
     private static readonly MAX_CONSECUTIVE_RENDER_ERRORS;
     perfMonitor: PerformanceMonitor;
     wfStateStyle: 'icon' | 'tag';
+    /** Minimum time (ms) a loading indicator must be visible before it can be hidden */
+    private static readonly MIN_LOADING_DISPLAY_MS;
     private loadingCells;
     private loadingRotation;
     private loadingImage;
@@ -1662,6 +1671,10 @@ declare class DataGrid {
      * 内部辅助：移除单个 loading 状态
      */
     private removeSingleLoading;
+    /**
+     * Check if there are any active loading cells.
+     */
+    hasLoadingCells(): boolean;
     /**
      * 查询指定 cellKey 是否处于 loading 状态
      */

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

@@ -17,7 +17,6 @@ interface EventTasks {
 declare class Events {
     grid: DataGrid;
     el: HTMLCanvasElement;
-    isFirefox: boolean;
     eventTasks: EventTasks;
     constructor(grid: DataGrid, el: HTMLCanvasElement);
     init(): void;

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

@@ -139,7 +139,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;
     /**
      * 处理右键菜单事件，返回上下文信息
@@ -340,6 +340,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/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/StatusViewer.d.ts

@@ -4,7 +4,6 @@
  */
 import type { CellViewer, ViewerRenderContext, StatusViewerData } from './types';
 /**
- * StatusViewer renders status values in cells
  * Supports icons, colored tags, and various status types
  */
 declare class StatusViewer implements CellViewer<StatusViewerData> {

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

@@ -625,6 +625,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 +659,8 @@ export interface FileViewerData extends CellViewerData {
     key?: string;
     /** 是否可编辑 */
     canEdit?: boolean;
+    /** 隐藏右侧操作区域（编辑笔/查看图标），用于嵌套表格中由 NestedGrid 层统一绘制编辑笔 */
+    hideAfterArea?: boolean;
     /** 是否显示删除线 */
     showLineThrow?: boolean;
     /** 是否关联属性 */
@@ -1260,3 +1264,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';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.2.0-beta.2",
+  "version": "0.2.0-beta.21",
   "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",
@@ -72,7 +72,6 @@
     "vue": "^3.0.0"
   },
   "dependencies": {
-    "arthub-table": "0.0.5",
     "axios": "^1.6.0",
     "core-js": "^3.35.0",
     "gifuct-js": "^2.1.2",