arthub-table 0.2.7 → 0.2.8

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

@@ -0,0 +1,59 @@
+/**
+ * CpPersonViewer - CP Person (外包人员) rendering viewer
+ * Handles avatar and name display for CP users
+ *
+ * 与 DOM 版 cpPersonViewer.ts 对齐：
+ * - value 为 CP 用户 ID 数组（string[]）或单个 string
+ * - 通过 cpUserResolver 回调将 ID 解析为显示名称（companyName/roleName/nickName）
+ * - 未解析的 ID 先显示 ID 占位，异步加载后通过 requestRedraw 刷新
+ * - 样式对齐 PersonViewer：头像 + 名称
+ */
+import type { CellViewer, ViewerRenderContext, CpPersonViewerData } from './types';
+/**
+ * CpPersonViewer renders CP person information in cells
+ * Style aligned with PersonViewer (avatar + name)
+ */
+declare class CpPersonViewer implements CellViewer<CpPersonViewerData> {
+    readonly type = "cp-person";
+    private imageManager;
+    private _sm;
+    private get avatarColors();
+    constructor();
+    /**
+     * Draw CP person content in the cell
+     */
+    draw(context: ViewerRenderContext, data: CpPersonViewerData): void;
+    /**
+     * Draw persons list (with background tag style, aligned with PersonViewer showNameBackground mode)
+     */
+    private drawPersons;
+    /**
+     * Draw person avatar (circle shape, using default avatar image)
+     */
+    private drawAvatar;
+    /**
+     * Draw fallback avatar with initial character
+     */
+    private drawFallbackAvatar;
+    /**
+     * Get consistent color index based on person id
+     */
+    private getColorIndex;
+    /**
+     * Get initial character from name
+     */
+    private getInitial;
+    /**
+     * Truncate text with ellipsis to fit within maxWidth
+     */
+    private truncateText;
+    /**
+     * Draw remaining count badge
+     */
+    private drawRemainingCount;
+    /**
+     * Draw placeholder for empty state
+     */
+    private drawPlaceholder;
+}
+export default CpPersonViewer;

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

@@ -41,6 +41,7 @@ export { default as ChildrenViewer } from './ChildrenViewer';
 export { default as OnlyShowErrorViewer } from './OnlyShowErrorViewer';
 export { default as PerspectiveViewer } from './PerspectiveViewer';
 export { default as RelatedTaskViewer } from './RelatedTaskViewer';
+export { default as CpPersonViewer } from './CpPersonViewer';
 import TextViewer from './TextViewer';
 import DropdownViewer from './DropdownViewer';
 import ImageViewer from './ImageViewer';
@@ -78,6 +79,7 @@ import ChildrenViewer from './ChildrenViewer';
 import OnlyShowErrorViewer from './OnlyShowErrorViewer';
 import PerspectiveViewer from './PerspectiveViewer';
 import RelatedTaskViewer from './RelatedTaskViewer';
+import CpPersonViewer from './CpPersonViewer';
 /**
  * Register all default viewers
  * Call this function once during application initialization
@@ -129,4 +131,5 @@ export declare const defaultViewers: {
     'only-show-error': typeof OnlyShowErrorViewer;
     perspective: typeof PerspectiveViewer;
     'related-task': typeof RelatedTaskViewer;
+    'cp-person': typeof CpPersonViewer;
 };

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

@@ -969,6 +969,7 @@ export interface ViewerTypeMap {
     'itfs-path': ItfsPathViewerData;
     'deliverable-review': DeliverableReviewViewerData;
     'rich-text': RichTextViewerData;
+    'cp-person': CpPersonViewerData;
 }
 /**
  * All supported viewer types
@@ -1383,3 +1384,34 @@ export interface RelatedTaskViewerData extends CellViewerData {
         ids: number[];
     }, data: any) => void;
 }
+/**
+ * CP 人员信息（由 cpUserResolver 返回）
+ */
+export interface CpPersonInfo {
+    id: string;
+    /** 显示名称，格式如 "公司名/基地/昵称" */
+    showName: string;
+}
+/**
+ * CP 人员 Viewer 数据接口
+ * 用于展示外包人员（CP User）信息
+ * 对齐 DOM 版 cpPersonViewer.ts 的渲染逻辑
+ */
+export interface CpPersonViewerData extends CellViewerData {
+    /** CP 用户 ID 数组或单个 ID 字符串 */
+    value: string[] | string | null;
+    /** 头像大小，默认 16 */
+    avatarSize?: number;
+    /** 最大显示人数，默认 3 */
+    maxDisplay?: number;
+    /** 空值占位符，默认 '-' */
+    placeholder?: string;
+    /**
+     * CP 用户解析回调
+     * 同步返回已缓存的用户信息，对未缓存的 ID 触发异步加载后调用 requestRedraw
+     * @param ids CP 用户 ID 数组
+     * @param requestRedraw 重绘回调，异步加载完成后调用
+     * @returns 已解析的用户信息数组（未解析的以 ID 作为 showName）
+     */
+    cpUserResolver?: (ids: string[], requestRedraw: () => void) => CpPersonInfo[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "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",