arthub-table 0.2.52 → 0.2.53

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

@@ -1,6 +1,7 @@
 /**
  * BooleanViewer - Boolean/Checkbox rendering viewer
- * Handles boolean value display with checkbox, switch, or text styles
+ * Handles boolean value display with checkbox, switch, or text styles.
+ * 支持单值和数组值（多节点引用场景）。
  */
 import type { CellViewer, ViewerRenderContext, BooleanViewerData } from './types';
 /**
@@ -11,15 +12,14 @@ declare class BooleanViewer implements CellViewer<BooleanViewerData> {
     readonly type = "boolean";
     readonly hideEditIcon = true;
     /**
-     * Handle click on boolean cell
-     * Returns true if the click was on the checkbox/switch area
-     * 注意：实际的值切换、乐观更新、onValueChange 回调和重绘由 Row.mouseDown 统一处理
-     * 此方法仅做命中检测，返回 true 表示点击在交互区域内
+     * Handle click on boolean cell.
+     * 数组值场景不支持点击切换（无法确定用户点击了哪个元素），返回 false。
+     * 单值场景返回命中检测结果。
      */
     onClick(context: ViewerRenderContext, data: BooleanViewerData, localX: number, localY: number): boolean;
     /**
      * 鼠标悬停在 checkbox/switch 交互区域时显示指针光标
-     * 注意：不能调用 onClick，否则会在 mousemove 时触发值变更
+     * 数组值场景不显示交互指针
      */
     getInteractiveCursor(context: ViewerRenderContext, data: BooleanViewerData, localX: number, localY: number): string | null;
     /**
@@ -27,7 +27,8 @@ declare class BooleanViewer implements CellViewer<BooleanViewerData> {
      */
     private hitTestArea;
     /**
-     * Draw boolean content in the cell
+     * Draw boolean content in the cell.
+     * 数组值场景：渲染多个 checkbox/switch/text 标签并排显示。
      */
     draw(context: ViewerRenderContext, data: BooleanViewerData): void;
     /**
@@ -40,6 +41,9 @@ declare class BooleanViewer implements CellViewer<BooleanViewerData> {
      *  - checkboxBorderDisabled : border    (readonly + unchecked)
      * `data.checkedColor` may override the editable-checked fill color.
      */
+    /**
+     * Draw a single checkbox using toBool for string-compatible boolean detection.
+     */
     private drawCheckbox;
     /**
      * Draw switch style
@@ -49,6 +53,18 @@ declare class BooleanViewer implements CellViewer<BooleanViewerData> {
      * Draw text style
      */
     private drawText;
+    /**
+     * 绘制空状态（数组值全为空/无有效值时显示）
+     */
+    private drawEmpty;
+    /**
+     * 绘制多个 checkbox 标签（数组值场景），每项 16×16，间隔 4px，整组居中
+     */
+    private drawCheckboxes;
+    /**
+     * 数组值 fallback：用文本形式展示多个布尔值，以逗号分隔
+     */
+    private drawTexts;
     /**
      * Draw a filled rounded rectangle
      */

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

@@ -8,8 +8,8 @@ import type { CellViewer, ViewerRenderContext, CellViewerData } from './types';
  * 超链接 Viewer 数据接口
  */
 export interface HyperlinkTextViewerData extends CellViewerData {
-    /** 值格式：[显示文本, 链接URL] 或 null */
-    value: [string, string] | null;
+    /** 值格式：扁平数组 [文本1, URL1, 文本2, URL2, ...] 或 null，每两个元素为一组链接 */
+    value: string[] | null;
     /** 数据行 ID */
     id?: string | number;
     /** 属性 key */
@@ -45,14 +45,14 @@ declare class HyperlinkTextViewer implements CellViewer<HyperlinkTextViewerData>
      */
     getInteractiveCursor(context: ViewerRenderContext, data: HyperlinkTextViewerData, localX: number, localY: number): string | null;
     /**
-     * 解析超链接值
-     * 值格式为数组 [显示文本, 链接URL]
+     * 解析超链接值（支持扁平数组 [文本1,url1,文本2,url2,...]）
+     * 每两个元素为一组链接，返回解析后的数组
      */
-    private parseValue;
+    private parseValues;
     /**
-     * 绘制超链接文本
+     * 绘制超链接文本（支持多条以逗号间隔）
      */
-    private drawHyperLinkText;
+    private drawHyperLinkTexts;
     /**
      * 绘制右侧编辑按钮
      */
@@ -74,8 +74,8 @@ declare class HyperlinkTextViewer implements CellViewer<HyperlinkTextViewerData>
      */
     private drawErrorIcon;
     /**
-     * 文本截断，超出宽度时显示省略号
+     * 根据点击的局部 x 坐标查找被点击的超链接索引，返回 -1 表示未命中
      */
-    private truncateText;
+    private findClickedLinkIndex;
 }
 export default HyperlinkTextViewer;

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

@@ -12,11 +12,16 @@ declare class PriorityTextViewer implements CellViewer<PriorityTextViewerData> {
     /** 空值占位符 */
     private readonly emptyValue;
     /**
-     * 绘制优先级标签内容
+     * 绘制优先级标签内容。
+     * 支持单值（string | number）和多节点引用场景的数组值。
      */
     draw(context: ViewerRenderContext, data: PriorityTextViewerData): void;
     /**
-     * 绘制优先级标签
+     * 绘制多个优先级标签（数组值场景），标签之间间隔 gap 像素
+     */
+    private drawPriorityTags;
+    /**
+     * 绘制单个优先级标签
      */
     private drawPriorityTag;
     /**

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

@@ -18,6 +18,10 @@ declare class ProgressViewer implements CellViewer<ProgressViewerData> {
      * Draw progress bar in the cell
      */
     draw(context: ViewerRenderContext, data: ProgressViewerData): void;
+    /**
+     * 绘制数组数值文本（逗号间隔，不渲染进度条）
+     */
+    private drawArrayText;
     /**
      * Check if mouse is over the drag handle
      */
@@ -34,6 +38,10 @@ declare class ProgressViewer implements CellViewer<ProgressViewerData> {
      * Handle drag end - trigger onProgressChange callback for data persistence
      */
     onDragEnd(_context: ViewerRenderContext, data: ProgressViewerData, newValue: any, startValue?: any): void;
+    /**
+     * 从 data.value 中提取单值（数组长度 <= 1 时取首个元素，否则返回 NaN）
+     */
+    private getSingleValue;
     /**
      * Check if mouse is over the drag handle
      */

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

@@ -9,8 +9,8 @@ import type { CellViewer, ViewerRenderContext, CellViewerData } from './types';
  * 富文本 Viewer 数据接口
  */
 export interface RichTextViewerData extends CellViewerData {
-    /** HTML 富文本内容或纯文本 */
-    value: string | null;
+    /** HTML 富文本内容或纯文本，支持数组（逗号拼接） */
+    value: string | string[] | null;
     /** 数据行 ID */
     id?: string | number;
     /** 属性 key */
@@ -35,7 +35,7 @@ export interface RichTextViewerData extends CellViewerData {
  * 解析富文本值，去除 HTML 标签 + 解码常见 HTML 实体。
  * <img> 标签替换为 [图片]，<video> 标签替换为 [视频]
  */
-export declare function getDisplayValue(value: string | null | undefined): string;
+export declare function getDisplayValue(value: string | string[] | null | undefined): string;
 declare class RichTextViewer implements CellViewer<RichTextViewerData> {
     readonly type = "rich-text";
     private _sm;

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

@@ -409,7 +409,7 @@ export interface PersonInfo {
  * Progress viewer data
  */
 export interface ProgressViewerData extends CellViewerData {
-    value: number;
+    value: number | number[];
     /** Minimum value (default 0) */
     min?: number;
     /** Maximum value (default 100) */
@@ -460,7 +460,8 @@ export interface DatetimeViewerData extends CellViewerData {
  * Boolean/Checkbox viewer data
  */
 export interface BooleanViewerData extends CellViewerData {
-    value: boolean | null;
+    /** 布尔值，支持单值或数组（多节点引用场景）；数组元素支持 boolean 或字符串 'true'/'false' */
+    value: (boolean | string)[] | boolean | string | null;
     /** Display style */
     displayStyle?: 'checkbox' | 'switch' | 'text';
     /** Text for true value */
@@ -800,8 +801,8 @@ export interface FileViewerData extends CellViewerData {
  * HyperLink text viewer data (超链接文本)
  */
 export interface HyperlinkTextViewerData extends CellViewerData {
-    /** 值格式：[显示文本, 链接URL] 或 null */
-    value: [string, string] | null;
+    /** 值格式：扁平数组 [文本1, URL1, 文本2, URL2, ...] 或 null，每两个元素为一组链接 */
+    value: string[] | null;
     /** 数据行 ID */
     id?: string | number;
     /** 属性 key */
@@ -1274,8 +1275,8 @@ export interface PunchTimingViewerData extends CellViewerData {
  * 用于展示优先级标签（P0-P4+），带有对应的颜色和背景色
  */
 export interface PriorityTextViewerData extends CellViewerData {
-    /** 优先级值，支持数字或字符串（如 0, 1, 2, '0', '1'） */
-    value: string | number | null;
+    /** 优先级值，支持数字或字符串（如 0, 1, 2, '0', '1'），或数组（多节点引用场景） */
+    value: (string | number)[] | string | number | null;
     /** 文本对齐方式，默认 'center' */
     textAlign?: 'left' | 'center' | 'right';
     /** 标签圆角半径，默认 2 */

package/package.json

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