arthub-table 0.2.34 → 0.2.35-next.0

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

@@ -167,6 +167,8 @@ export interface ThemeTokens {
     bgTagDefault: string;
     /** 进度条轨道色 */
     bgProgressTrack: string;
+    /** 分组特殊标识（hook_mark/mark_bg_color）容器背景色 */
+    bgGroupMarkPurple: string;
     /** 顶层实体行背景色（path_id.length === 2 的 Entity 行） */
     bgTopLevelEntity: string;
     /** 顶层实体行 hover 背景色 */

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

@@ -0,0 +1,49 @@
+/**
+ * PreImageViewer - 文件预览图渲染器（DOM PreImageViewer 的 Canvas 对齐版）
+ *
+ * 与 ImageViewer 的差异（与 DOM `preImageViewer.ts` 行为对齐）：
+ * 1. 当 fileFormat 不属于图片格式（且 URL 后缀也不属于图片格式）时，
+ *    显示 fileFormat 对应的"文件类型图标"（PDF / Word / Excel / Sketch ...），
+ *    而不是缩略图 — 与 DOM `PreImageViewer.updateMiddle` 的"非图片型"分支一致。
+ * 2. 其余渲染（hover 浮窗、双击预览、loading 占位、状态图标兜底等）100% 委托 `ImageViewer`，
+ *    不重复实现像素绘制逻辑。
+ *
+ * 实现策略：独立类 + 内部组合（持有）一个 ImageViewer 实例完成实际绘制，
+ * 在 draw 入口决定"绘制缩略图 URL"还是"绘制 fileFormat 图标 URL"，
+ * 然后委托 `ImageViewer.draw` 完成像素级渲染。
+ *
+ * type 标识独立为 `'preImage'`，便于业务侧/适配层做精细化路由。
+ */
+import type { CellViewer, ViewerRenderContext, PreImageViewerData } from './types';
+declare class PreImageViewer implements CellViewer<PreImageViewerData> {
+    readonly type = "preImage";
+    /** 内部组合的 ImageViewer 实例，承担实际像素绘制 / hover / 命中检测 */
+    private imageViewer;
+    constructor();
+    /**
+     * 绘制入口：判定是显示缩略图还是文件类型图标
+     * 对齐 DOM `preImageViewer.updateMiddle` 的 ext + IMAGE_EXTENSIONS 判定逻辑
+     */
+    draw(context: ViewerRenderContext, data: PreImageViewerData): void;
+    /**
+     * 给委托给 ImageViewer 的 data 注入 __viewerType: 'preImage'
+     * 这样 ImageViewer 触发的 onImgMouseIn / onDblClick 回调里业务侧能识别这是 preImage 列
+     * （用于走"反馈面板 popper"而非"简版大图 popper"）
+     */
+    private withViewerType;
+    /**
+     * 双击委托给 ImageViewer（onClickImage 由业务侧注入，签名一致）
+     */
+    onDblClick(context: ViewerRenderContext, data: PreImageViewerData, localX: number, localY: number): boolean;
+    /**
+     * 鼠标悬停光标 + hover 回调委托给 ImageViewer
+     * 注意：必须注入 __viewerType，否则 ImageViewer.handleHoverChange 透传给业务回调的 data 不带标记，
+     * 业务侧无法区分这是 preImage 列还是普通 image 列
+     */
+    getInteractiveCursor(context: ViewerRenderContext, data: PreImageViewerData, localX: number, localY: number): string | null;
+    /**
+     * hover 状态重置委托给 ImageViewer
+     */
+    resetHoverState(data: PreImageViewerData): void;
+}
+export default PreImageViewer;

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

@@ -7,6 +7,7 @@ export { default as ViewerRegistry, getViewerRegistry } from './ViewerRegistry';
 export { default as TextViewer } from './TextViewer';
 export { default as DropdownViewer } from './DropdownViewer';
 export { default as ImageViewer } from './ImageViewer';
+export { default as PreImageViewer } from './PreImageViewer';
 export { default as PersonViewer } from './PersonViewer';
 export { default as ProgressViewer } from './ProgressViewer';
 export { default as DatetimeViewer } from './DatetimeViewer';
@@ -46,6 +47,7 @@ export { default as DeliveryExpectationsViewer } from './DeliveryExpectationsVie
 import TextViewer from './TextViewer';
 import DropdownViewer from './DropdownViewer';
 import ImageViewer from './ImageViewer';
+import PreImageViewer from './PreImageViewer';
 import PersonViewer from './PersonViewer';
 import ProgressViewer from './ProgressViewer';
 import DatetimeViewer from './DatetimeViewer';
@@ -95,6 +97,7 @@ export declare const defaultViewers: {
     number: typeof TextViewer;
     select: typeof DropdownViewer;
     image: typeof ImageViewer;
+    preImage: typeof PreImageViewer;
     person: typeof PersonViewer;
     progress: typeof ProgressViewer;
     datetime: typeof DatetimeViewer;

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

@@ -303,8 +303,12 @@ export interface ImageViewerData extends CellViewerData {
     animated?: boolean;
     /** 点击图片回调（与 DOM multiImageViewer 的 onClickImage 签名一致） */
     onClickImage?: (imgUrls: string[], initIndex: number, assetIds: (number | string | undefined)[], data: any) => void;
-    /** 鼠标移入图片回调（用于显示大图预览） */
-    onImgMouseIn?: (url: string, virtualAnchor: any) => void;
+    /**
+     * 鼠标移入图片回调（用于显示大图预览）
+     * 第三个参数 data 透传当前 cell 的完整 ViewerData，便于业务侧根据 viewer 类型/行上下文做分支
+     * （如 preImage 列触发反馈面板 popper 而非简版预览，需要 _rowId / _colKey 走 findRow 拼 fullData）
+     */
+    onImgMouseIn?: (url: string, virtualAnchor: any, data?: any) => void;
     /** 鼠标移出图片回调（用于隐藏大图预览） */
     onImgMouseOut?: () => void;
     /**
@@ -323,6 +327,23 @@ export interface ImageViewerData extends CellViewerData {
         progress?: number;
     }>;
 }
+/**
+ * 文件预览图 viewer 数据
+ *
+ * 与 ImageViewerData 的差异（与 DOM `preImageViewer.ts` 行为对齐）：
+ * 1. 接收单值 string URL（不像 ImageViewer 接收 string[]）
+ * 2. 多接收 `fileFormat` 字段：当 fileFormat 不属于图片格式时，
+ *    PreImageViewer 会显示 fileFormat 对应的文件类型图标（PDF / Word / Excel / Sketch ...），
+ *    而不是缩略图
+ *
+ * 其余字段语义与 ImageViewerData 一致（hover / 双击回调签名兼容，可直接复用 imageCallbacks）。
+ */
+export interface PreImageViewerData extends Omit<ImageViewerData, 'value'> {
+    /** 缩略图 URL（单值；空字符串/null 时显示占位符 '-'） */
+    value: string | null;
+    /** 文件后缀名（如 'pdf' / 'docx' / 'png'），用于决定显示缩略图还是文件类型图标 */
+    fileFormat?: string;
+}
 /**
  * Person/User viewer data
  */
@@ -977,6 +998,7 @@ export interface ViewerTypeMap {
     text: TextViewerData;
     select: DropdownViewerData;
     image: ImageViewerData;
+    preImage: PreImageViewerData;
     person: PersonViewerData;
     progress: ProgressViewerData;
     datetime: DatetimeViewerData;

package/dist/types/index.d.ts

@@ -10,13 +10,14 @@ 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, 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 type { CellBounds, ViewerRenderContext, ViewerDragState, CellViewer, CellViewerData, ViewerOption, ViewerStyle, TextViewerData, DropdownViewerData, ImageViewerData, PreImageViewerData, 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';
 export { default as TextViewer } from './core/viewers/TextViewer';
 export { default as DropdownViewer } from './core/viewers/DropdownViewer';
 export { default as ImageViewer } from './core/viewers/ImageViewer';
+export { default as PreImageViewer } from './core/viewers/PreImageViewer';
 export { default as PersonViewer } from './core/viewers/PersonViewer';
 export { default as ProgressViewer } from './core/viewers/ProgressViewer';
 export { default as DatetimeViewer } from './core/viewers/DatetimeViewer';

package/package.json

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