arthub-table 0.2.28 → 0.2.29-next.1

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

@@ -36,7 +36,12 @@ declare class Footer {
      * 布局从右到左：[下拉箭头(ARROW_ICON_SIZE)] [刷新icon(REFRESH_ICON_PADDING + REFRESH_ICON_SIZE + REFRESH_ICON_PADDING)]
      */
     private isInsideRefreshIcon;
-    /** 从列配置中查找指定索引的列 */
+    /**
+     * 从列配置中查找指定 key 的列。
+     * 注意：必须按 key 匹配，不能按 index — grid.headers 由 calCrossSpan 生成的复合表头树形结构，
+     * 元素本身并无 index 字段（HeaderConfig 仅有 level/rowspan/colspan/children），
+     * 而 ColumnHeader 的 index 是叶子列序号，与 headers 树形结构无对应关系。
+     */
     private findColumnConfig;
     /** 绘制 footer */
     draw(): void;

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

@@ -309,7 +309,10 @@ declare class GroupRow extends Context {
      */
     private isInsideNestedRefreshIcon;
     /**
-     * 从列配置中查找指定索引的列
+     * 从列配置中查找指定 key 的列。
+     * 注意：必须按 key 匹配，不能按 index — grid.headers 由 calCrossSpan 生成的复合表头树形结构，
+     * 元素本身并无 index 字段（HeaderConfig 仅有 level/rowspan/colspan/children），
+     * 而 ColumnHeader 的 index 是叶子列序号，与 headers 树形结构无对应关系。
      */
     private findColumnConfig;
     dbClick(_x: number, _y: number): void;

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

@@ -0,0 +1,64 @@
+/**
+ * DeliveryExpectationsViewer - 交付预期单元格渲染器（Canvas 实现）
+ *
+ * 功能：
+ * 1. 多行文本渲染：每个 module 一行，用逗号分隔时换行展示
+ * 2. 逾期标红：当 item.color === 'red' 时，该行文字渲染为红色
+ * 3. 点击交互：点击单元格弹出下拉浮窗展示完整内容
+ *
+ * 数据格式：
+ * delivery_expectations: [
+ *   { color: "red", estimate_end_date: 1758815999000, module: "【默认模块 2】09月25日" }
+ * ]
+ */
+import type { CellViewer, ViewerRenderContext, CellViewerData } from './types';
+/**
+ * 交付预期项
+ */
+export interface DeliveryExpectationItem {
+    /** 颜色标记，'red' 表示逾期 */
+    color?: string;
+    /** 预计结束时间戳 */
+    estimate_end_date?: number;
+    /** 模块显示文本，如 "【品牌】可验收，【配置】可验收" */
+    module: string;
+}
+/**
+ * 交付预期 viewer 数据
+ */
+export interface DeliveryExpectationsViewerData extends CellViewerData {
+    /** 交付预期列表 */
+    value: DeliveryExpectationItem[] | string | null;
+    /** 占位符文本，默认 '-' */
+    placeholder?: string;
+}
+declare class DeliveryExpectationsViewer implements CellViewer<DeliveryExpectationsViewerData> {
+    readonly type = "delivery-expectations";
+    /**
+     * 绘制交付预期单元格内容
+     */
+    draw(context: ViewerRenderContext, data: DeliveryExpectationsViewerData): void;
+    /**
+     * 点击事件处理：返回 false 不阻止默认选中行为，
+     * 由外部 afterSelectCell 回调检测 viewerType 后弹出浮窗
+     */
+    onClick(_context: ViewerRenderContext, _data: DeliveryExpectationsViewerData, _localX: number, _localY: number): boolean;
+    /**
+     * 鼠标悬停时显示手型光标
+     */
+    getInteractiveCursor(_context: ViewerRenderContext, data: DeliveryExpectationsViewerData, _localX: number, _localY: number): string | null;
+    /**
+     * 解析数据为 DeliveryExpectationItem 数组
+     */
+    private parseItems;
+    /**
+     * 将 items 拆分为多行显示
+     * 每个 item 的 module 文本按逗号拆分为多行
+     */
+    private splitToLines;
+    /**
+     * 截断文本并添加省略号
+     */
+    private truncateWithEllipsis;
+}
+export default DeliveryExpectationsViewer;

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

@@ -42,6 +42,7 @@ export { default as OnlyShowErrorViewer } from './OnlyShowErrorViewer';
 export { default as PerspectiveViewer } from './PerspectiveViewer';
 export { default as RelatedTaskViewer } from './RelatedTaskViewer';
 export { default as CpPersonViewer } from './CpPersonViewer';
+export { default as DeliveryExpectationsViewer } from './DeliveryExpectationsViewer';
 import TextViewer from './TextViewer';
 import DropdownViewer from './DropdownViewer';
 import ImageViewer from './ImageViewer';
@@ -80,6 +81,7 @@ import OnlyShowErrorViewer from './OnlyShowErrorViewer';
 import PerspectiveViewer from './PerspectiveViewer';
 import RelatedTaskViewer from './RelatedTaskViewer';
 import CpPersonViewer from './CpPersonViewer';
+import DeliveryExpectationsViewer from './DeliveryExpectationsViewer';
 /**
  * Register all default viewers
  * Call this function once during application initialization
@@ -132,4 +134,5 @@ export declare const defaultViewers: {
     perspective: typeof PerspectiveViewer;
     'related-task': typeof RelatedTaskViewer;
     'cp-person': typeof CpPersonViewer;
+    'delivery-expectations': typeof DeliveryExpectationsViewer;
 };

package/package.json

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