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

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

@@ -0,0 +1,56 @@
+/**
+ * GroupNameViewer - Group header name rendering viewer
+ * Renders the group name in group header rows with proper formatting.
+ *
+ * Supports 5 render modes:
+ * - text: Plain text (default, for workflow_state, workflow_id, taskNode, etc.)
+ * - person: Avatar + person name with click-to-jump support
+ * - tag: Colored background tags (for module, dropdown, treeDropdown)
+ * - boolean: Check/cross icon + text (for boolean fields)
+ * - priority: P{n} colored tag (for priority fields)
+ *
+ * The business layer (AssetMatrix) builds GroupNameViewerData from formatSpecialGroupHeader logic,
+ * and this viewer only handles rendering. This keeps arthub-table free of business dependencies.
+ */
+import type { CellViewer, ViewerRenderContext, GroupNameViewerData } from './types';
+declare class GroupNameViewer implements CellViewer<GroupNameViewerData> {
+    readonly type = "group-name";
+    private imageManager;
+    private _sm;
+    /** Index of the person currently hovered by mouse (-1 = none) */
+    private _hoverPersonIndex;
+    private get avatarColors();
+    constructor();
+    /**
+     * Draw group name content
+     */
+    draw(context: ViewerRenderContext, data: GroupNameViewerData): void;
+    /**
+     * Handle click events - detect person name clicks for jump
+     */
+    onClick(context: ViewerRenderContext, data: GroupNameViewerData, localX: number, _localY: number): boolean;
+    /**
+     * Show pointer cursor when hovering over person names
+     */
+    getInteractiveCursor(context: ViewerRenderContext, data: GroupNameViewerData, localX: number, _localY: number): string | null;
+    /**
+     * Reset hover state when mouse leaves the viewer area
+     */
+    resetHoverState(_data?: GroupNameViewerData): void;
+    private drawTextMode;
+    private drawPersonMode;
+    /**
+     * Draw person avatar from URL
+     */
+    private drawAvatar;
+    /**
+     * Draw fallback avatar with initial letter
+     */
+    private drawFallbackAvatar;
+    private getColorIndex;
+    private getInitial;
+    private drawTagMode;
+    private drawBooleanMode;
+    private drawPriorityMode;
+}
+export default GroupNameViewer;

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

@@ -31,6 +31,12 @@ declare class PersonViewer implements CellViewer<PersonViewerData> {
      * Draw persons
      */
     private drawPersons;
+    /**
+     * showNameBackground (tag) 模式下的 flex 均匀分配布局
+     * 对齐 DOM 版本：容器 padding 4px，卡片间距 4px，卡片内 padding 4px 6px
+     * 所有卡片先按最小宽度（头像+padding）分配，剩余空间均匀分给文本
+     */
+    private drawPersonsFlexLayout;
     /**
      * Draw a single person with width constraint
      * @returns Width of the drawn person item

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

@@ -27,9 +27,5 @@ declare class PriorityTextViewer implements CellViewer<PriorityTextViewerData> {
      * 绘制圆角矩形
      */
     private drawRoundedRect;
-    /**
-     * 截断文本并添加省略号
-     */
-    private truncateText;
 }
 export default PriorityTextViewer;

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

@@ -41,7 +41,11 @@ declare class TaskNodeViewer implements CellViewer<TaskNodeViewerData> {
      */
     private parseValue;
     /**
-     * 通过 ID 数组和 customTaskNodeInfo 映射解析节点信息
+     * 通过 ID 数组解析节点信息
+     * 解析优先级（与 DOM 版 findNeedFetchNodeAndFormatNode 对齐）：
+     * 1. customTaskNodeInfo（行数据上的映射表，TemplateDetail 场景）
+     * 2. taskNodeResolver（通过 graph.getNode 查询，进度表场景）
+     * 3. 兜底使用 ID 数字作为名称
      */
     private resolveNodesByIds;
     /**

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

@@ -15,6 +15,8 @@ declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitche
     private totalNumImage;
     private iomcImages;
     private iomcColoredCanvases;
+    private downstreamImage;
+    private downstreamColoredCanvas;
     private loadingAngle;
     private lastLayoutBounds;
     private _sm;
@@ -26,6 +28,14 @@ declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitche
     /**
      * Main draw method
      */
+    /**
+     * Live-refresh iconFile & tapdHighlight from rowData (overlay Proxy).
+     * transformTextWithSwitcherValue snapshots these values at preprocess time,
+     * but the underlying proxyedData may be updated asynchronously (e.g. updateTableTaskByNode).
+     * Reading from data.extra.rowData triggers the overlay Proxy get handler,
+     * which falls back to proxyedData for the latest value.
+     */
+    private refreshDataFromRowData;
     draw(context: ViewerRenderContext, data: TextViewerWithSwitcherData): void;
     /**
      * Draw tree indent lines
@@ -65,6 +75,10 @@ declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitche
      * the correct color using source-in composite operation.
      */
     private recolorIomcIcon;
+    /**
+     * Recolor an icon image to the specified color using offscreen canvas.
+     */
+    private recolorIcon;
     /**
      * Draw IOMC order state icon (已提单/未提单/已驳回)
      * Renders before text, after task icon.
@@ -90,7 +104,7 @@ declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitche
      */
     private drawTotalNum;
     /**
-     * Draw downstream node indicator
+     * Draw downstream node indicator (icon_history1.svg, colored #ffb74d, 16x16)
      * @returns New right X position (moving leftward)
      */
     private drawDownstreamIcon;

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

@@ -12,7 +12,7 @@ export { default as ProgressViewer } from './ProgressViewer';
 export { default as DatetimeViewer } from './DatetimeViewer';
 export { default as BooleanViewer } from './BooleanViewer';
 export { default as StatusViewer } from './StatusViewer';
-export { default as GroupHeaderViewer } from './GroupHeaderViewer';
+export { default as GroupNameViewer } from './GroupNameViewer';
 export { default as SeparatorRowViewer } from './SeparatorRowViewer';
 export { default as NestedGridViewer } from './NestedGridViewer';
 export { default as PunchViewer } from './PunchViewer';
@@ -48,7 +48,7 @@ import ProgressViewer from './ProgressViewer';
 import DatetimeViewer from './DatetimeViewer';
 import BooleanViewer from './BooleanViewer';
 import StatusViewer from './StatusViewer';
-import GroupHeaderViewer from './GroupHeaderViewer';
+import GroupNameViewer from './GroupNameViewer';
 import SeparatorRowViewer from './SeparatorRowViewer';
 import NestedGridViewer from './NestedGridViewer';
 import PunchViewer from './PunchViewer';
@@ -98,7 +98,7 @@ export declare const defaultViewers: {
     boolean: typeof BooleanViewer;
     checkbox: typeof BooleanViewer;
     status: typeof StatusViewer;
-    'group-header': typeof GroupHeaderViewer;
+    'group-name': typeof GroupNameViewer;
     'separator-row': typeof SeparatorRowViewer;
     nested: typeof NestedGridViewer;
     punch: typeof PunchViewer;

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

@@ -166,6 +166,26 @@ export interface CellViewerData {
     /** Extra data for specific viewers */
     extra?: Record<string, any>;
 }
+/**
+ * Cell value transformer callback type.
+ *
+ * Called by Cell.drawWithViewer() before passing data to viewer.draw().
+ * The transformer receives the raw cell value and column metadata, and returns
+ * a transformed value suitable for the viewer. If no transformation is needed,
+ * return the original value unchanged (or undefined to skip transformation).
+ *
+ * This decouples value transformation from the data preprocessing layer
+ * (rowDataAdapter.transformCellValues) and moves it to the rendering layer,
+ * aligning with the DOM table's approach where viewers (e.g. textViewer.ts
+ * getDisplayValue / getTreeCustomInfo) handle value-to-display conversion.
+ *
+ * @param rawValue - The raw cell value from row data
+ * @param columnKey - The column key (header key / property UUID)
+ * @param viewerType - The viewer type identifier (e.g. 'text', 'person', 'wf-state')
+ * @param rowData - The full row data object
+ * @returns Transformed value to use for rendering, or undefined to keep original
+ */
+export type CellValueTransformer = (rawValue: any, columnKey: string, viewerType: string, rowData: Record<string, any>) => any | undefined;
 /**
  * Option item for select-type viewers
  */
@@ -237,7 +257,7 @@ export interface ImageViewerData extends CellViewerData {
     /** Placeholder image URL */
     placeholder?: string;
     /** Image fit mode */
-    fit?: 'contain' | 'cover' | 'fill';
+    fit?: 'contain' | 'cover' | 'fill' | 'height-full' | 'width-full';
     /** Border radius */
     borderRadius?: number;
     /** Whether the image is animated (GIF) */
@@ -330,6 +350,10 @@ export interface DatetimeViewerData extends CellViewerData {
     formattedText?: string;
     /** 文本颜色（如逾期提醒的红色） */
     textColor?: string;
+    /** hover 时显示的 tooltip 文本（完整日期格式） */
+    hoverText?: string;
+    /** hover 时是否显示下划线（用于时间型字段变更提醒） */
+    showUnderlineOnHover?: boolean;
 }
 /**
  * Boolean/Checkbox viewer data
@@ -396,6 +420,55 @@ export interface GroupHeaderViewerData extends CellViewerData {
     /** Whether to show working hours icon */
     showUserWorkingHours?: boolean;
 }
+/**
+ * Group name tag item (for module/dropdown/treeDropdown colored tags)
+ */
+export interface GroupNameTagItem {
+    /** Display text */
+    text: string;
+    /** Tag background color */
+    bgColor: string;
+    /** Tag text color */
+    textColor: string;
+    /** Whether bgColor is an original color (not derived) */
+    isOriginalColor?: boolean;
+}
+/**
+ * Group name person item (for person-type group headers)
+ */
+export interface GroupNamePersonItem {
+    /** Person display name */
+    name: string;
+    /** Person avatar URL */
+    avatar?: string;
+    /** Person account name (used for click-to-jump) */
+    accountName?: string;
+    /** Whether this is an empty/placeholder person */
+    isEmpty?: boolean;
+}
+/**
+ * Group name viewer data
+ * Used by GroupNameViewer to render group header names with proper formatting.
+ * The business layer (AssetMatrix) builds this data from formatSpecialGroupHeader logic,
+ * and the viewer only handles rendering.
+ */
+export interface GroupNameViewerData extends CellViewerData {
+    value: any;
+    /** Render mode */
+    renderType: 'text' | 'person' | 'tag' | 'boolean' | 'priority';
+    /** Plain text display name (used for text/boolean/fallback rendering) */
+    displayName?: string;
+    /** Tag items for tag render mode (module/dropdown/treeDropdown) */
+    tags?: GroupNameTagItem[];
+    /** Person items for person render mode */
+    persons?: GroupNamePersonItem[];
+    /** Boolean value string ('true' or 'false') for boolean render mode */
+    boolValue?: 'true' | 'false';
+    /** Priority numeric value for priority render mode */
+    priorityValue?: number | string;
+    /** Callback when a person name is clicked (for user profile jump) */
+    onPersonClick?: (accountName: string) => void;
+}
 /**
  * Separator row viewer data
  */
@@ -575,6 +648,8 @@ export interface FileViewerData extends CellViewerData {
     } | null;
     /** 是否仅显示缩略图（隐藏文件名） */
     isDisplayThumbnail?: boolean;
+    /** 缩略图模式下的图片适配方式（与 ImageViewerData.fit 对齐） */
+    thumbnailFit?: 'contain' | 'cover' | 'fill' | 'height-full' | 'width-full';
     /** 鼠标移入文件项回调（用于显示大图预览，与 ImageViewer 的 onImgMouseIn 签名一致） */
     onFileMouseIn?: (previewUrl: string, virtualAnchor: any) => void;
     /** 鼠标移出文件项回调（用于隐藏大图预览，与 ImageViewer 的 onImgMouseOut 签名一致） */
@@ -738,6 +813,12 @@ export interface TaskNodeViewerData extends CellViewerData {
         name: string;
         iconFile?: string;
     }>;
+    /** 节点详情解析回调（渲染时通过 graph.getNode 查询，与 DOM 版 findNeedFetchNodeAndFormatNode 对齐） */
+    taskNodeResolver?: (nodeId: number) => {
+        id: number;
+        name: string;
+        iconFile?: string;
+    } | null;
     /** 点击任务节点回调（打开业务节点详情页） */
     onTaskGoToDetail?: (nodeId: number) => void;
 }
@@ -811,6 +892,7 @@ export interface ViewerTypeMap {
     checkbox: BooleanViewerData;
     status: StatusViewerData;
     'group-header': GroupHeaderViewerData;
+    'group-name': GroupNameViewerData;
     'separator-row': SeparatorRowViewerData;
     nested: NestedGridViewerData;
     punch: PunchViewerData;

package/dist/types/index.d.ts

@@ -10,7 +10,7 @@ export { install };
 export default DataGrid;
 export type { CellData, CellStyle, RowData, ColData, DataGridOptions, Position, Size, Rect, Range, CellRange, HistoryItem, ValidatorRule, ColumnType, ColumnConfig, SelectorState, EditorState, AutofillState, RangeState, DrawOptions, TextOptions, ClipboardState, EventHandlers, Direction, ScrollDirection, GroupLevel, SeparateLevel, BaseGroupedRowData, GroupRowData, SeparateRowData, NormalRowData, GroupedTableRowData, GroupRowStyle, SeparatorRowStyle, StatisticOption, FooterCellData, FooterData, FooterCellClickInfo, } from './core/types';
 export { isGroupRow, isSeparateRow, isNormalRow, GROUP_TABLE_CONSTANTS, DEFAULT_GROUP_STYLES, DEFAULT_SEPARATOR_STYLES, } from './core/types';
-export type { CellBounds, ViewerRenderContext, ViewerDragState, CellViewer, CellViewerData, ViewerOption, ViewerStyle, TextViewerData, DropdownViewerData, ImageViewerData, PersonViewerData, PersonInfo, ProgressViewerData, DatetimeViewerData, BooleanViewerData, StatusViewerData, StatusOption, GroupHeaderViewerData, SeparatorRowViewerData, PunchViewerData, PunchValue, ModuleInfo, ModuleViewerData, TextViewerWithSwitcherData, FileItem, FileViewerData, HyperlinkTextViewerData, IUpstreamModule, IUpstreamReminderProperties, IUpstreamSyncProperty, IUpstreamFieldViewItem, UpstreamViewerData, TaskNodeItem, TaskNodeViewerData, NestedGridViewerData, NestedColumnConfig, ViewerConstructor, ViewerFactory, ViewerTypeMap, ViewerType, TypedCellData, TableActionButtonOption, TableActionButtonViewerData, } from './core/viewers/types';
+export type { CellBounds, ViewerRenderContext, ViewerDragState, CellViewer, CellViewerData, ViewerOption, ViewerStyle, TextViewerData, DropdownViewerData, ImageViewerData, PersonViewerData, PersonInfo, ProgressViewerData, DatetimeViewerData, BooleanViewerData, StatusViewerData, StatusOption, GroupHeaderViewerData, GroupNameViewerData, GroupNameTagItem, GroupNamePersonItem, SeparatorRowViewerData, PunchViewerData, PunchValue, ModuleInfo, ModuleViewerData, TextViewerWithSwitcherData, FileItem, FileViewerData, HyperlinkTextViewerData, IUpstreamModule, IUpstreamReminderProperties, IUpstreamSyncProperty, IUpstreamFieldViewItem, UpstreamViewerData, TaskNodeItem, TaskNodeViewerData, NestedGridViewerData, NestedColumnConfig, ViewerConstructor, ViewerFactory, ViewerTypeMap, ViewerType, TypedCellData, TableActionButtonOption, TableActionButtonViewerData, } from './core/viewers/types';
 export { isTextViewerData, isDropdownViewerData, isPersonViewerData, isProgressViewerData, isNestedGridViewerData, } from './core/viewers/types';
 export { default as ViewerRegistry, getViewerRegistry, } from './core/viewers/ViewerRegistry';
 export { registerDefaultViewers, defaultViewers } from './core/viewers/index';
@@ -22,7 +22,7 @@ export { default as ProgressViewer } from './core/viewers/ProgressViewer';
 export { default as DatetimeViewer } from './core/viewers/DatetimeViewer';
 export { default as BooleanViewer } from './core/viewers/BooleanViewer';
 export { default as StatusViewer } from './core/viewers/StatusViewer';
-export { default as GroupHeaderViewer } from './core/viewers/GroupHeaderViewer';
+export { default as GroupNameViewer } from './core/viewers/GroupNameViewer';
 export { default as SeparatorRowViewer } from './core/viewers/SeparatorRowViewer';
 export { default as NestedGridViewer } from './core/viewers/NestedGridViewer';
 export { default as PunchViewer } from './core/viewers/PunchViewer';
@@ -41,11 +41,11 @@ 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, } from './adapters/rowDataAdapter';
+export { convertToDataGridRows, isPerfLogEnabled, } from './adapters/rowDataAdapter';
 export type { PreprocessedRow, } from './adapters/rowDataAdapter';
 export { preprocessRowStyles, } from './adapters/styleAdapter';
 export type { RowStyleResult, } from './adapters/styleAdapter';
 export { DataGridEventAdapter, EventCategory, extractEventContext, mapDomEventToDataGridEvent, } from './adapters/DataGridEventAdapter';
 export type { EventContext, } from './adapters/DataGridEventAdapter';
-export { buildDataGridInitParams, refreshDataGridRows, refreshDataGridColumns, refreshDataGridColumnByKeys, refreshDataGridRowByIndex, } from './adapters/DataGridIntegration';
+export { buildDataGridInitParams, refreshDataGridRows, refreshDataGridColumns, refreshDataGridColumnByKeys, refreshDataGridColumnByKeysAsync, refreshDataGridRowByIndex, } from './adapters/DataGridIntegration';
 export type { DataGridInitOptions, DataGridCallbacks, DataGridInitResult, } from './adapters/DataGridIntegration';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.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",