arthub-table 0.2.51-next.3 → 0.2.51

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

@@ -1,7 +1,6 @@
 /**
  * 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';
 /**
@@ -12,14 +11,15 @@ declare class BooleanViewer implements CellViewer<BooleanViewerData> {
     readonly type = "boolean";
     readonly hideEditIcon = true;
     /**
-     * Handle click on boolean cell.
-     * 数组值场景不支持点击切换（无法确定用户点击了哪个元素），返回 false。
-     * 单值场景返回命中检测结果。
+     * Handle click on boolean cell
+     * Returns true if the click was on the checkbox/switch area
+     * 注意：实际的值切换、乐观更新、onValueChange 回调和重绘由 Row.mouseDown 统一处理
+     * 此方法仅做命中检测，返回 true 表示点击在交互区域内
      */
     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,8 +27,7 @@ declare class BooleanViewer implements CellViewer<BooleanViewerData> {
      */
     private hitTestArea;
     /**
-     * Draw boolean content in the cell.
-     * 数组值场景：渲染多个 checkbox/switch/text 标签并排显示。
+     * Draw boolean content in the cell
      */
     draw(context: ViewerRenderContext, data: BooleanViewerData): void;
     /**
@@ -41,9 +40,6 @@ 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
@@ -53,18 +49,6 @@ 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 {
-    /** 值格式：扁平数组 [文本1, URL1, 文本2, URL2, ...] 或 null，每两个元素为一组链接 */
-    value: string[] | null;
+    /** 值格式：[显示文本, 链接URL] 或 null */
+    value: [string, 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;
     /**
-     * 解析超链接值（支持扁平数组 [文本1,url1,文本2,url2,...]）
-     * 每两个元素为一组链接，返回解析后的数组
+     * 解析超链接值
+     * 值格式为数组 [显示文本, 链接URL]
      */
-    private parseValues;
+    private parseValue;
     /**
-     * 绘制超链接文本（支持多条以逗号间隔）
+     * 绘制超链接文本
      */
-    private drawHyperLinkTexts;
+    private drawHyperLinkText;
     /**
      * 绘制右侧编辑按钮
      */
@@ -74,8 +74,8 @@ declare class HyperlinkTextViewer implements CellViewer<HyperlinkTextViewerData>
      */
     private drawErrorIcon;
     /**
-     * 根据点击的局部 x 坐标查找被点击的超链接索引，返回 -1 表示未命中
+     * 文本截断，超出宽度时显示省略号
      */
-    private findClickedLinkIndex;
+    private truncateText;
 }
 export default HyperlinkTextViewer;

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

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

package/package.json

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