arthub-table 0.0.3

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

@@ -0,0 +1,399 @@
+import type { ViewerOption } from './viewers/types';
+export interface CellData {
+    value?: any;
+    text?: string;
+    style?: CellStyle;
+    merge?: [number, number];
+    editable?: boolean;
+    [key: string]: any;
+}
+export interface CellStyle {
+    bgcolor?: string;
+    align?: 'left' | 'center' | 'right';
+    valign?: 'top' | 'middle' | 'bottom';
+    textwrap?: boolean;
+    underline?: boolean;
+    color?: string;
+    bold?: boolean;
+    italic?: boolean;
+    strike?: boolean;
+    font?: {
+        name?: string;
+        size?: number;
+    };
+    border?: {
+        top?: string[];
+        bottom?: string[];
+        left?: string[];
+        right?: string[];
+    };
+    [key: string]: any;
+}
+export interface RowData {
+    cells: {
+        [key: number]: CellData;
+    };
+    height?: number;
+    [key: string]: any;
+}
+export interface ColData {
+    width?: number;
+    [key: string]: any;
+}
+export interface DataGridOptions {
+    rows?: {
+        [key: number]: RowData;
+    };
+    cols?: {
+        [key: number]: ColData;
+    };
+    merges?: string[];
+    freeze?: string;
+    styles?: CellStyle[];
+    validations?: any[];
+    autofilter?: any;
+    [key: string]: any;
+}
+export interface Position {
+    x: number;
+    y: number;
+}
+export interface Size {
+    width: number;
+    height: number;
+}
+export interface Rect extends Position, Size {
+}
+export interface Range {
+    sri: number;
+    sci: number;
+    eri: number;
+    eci: number;
+}
+export interface CellRange {
+    row: number;
+    col: number;
+    rowspan?: number;
+    colspan?: number;
+}
+export interface HistoryItem {
+    type: string;
+    data: any;
+}
+export interface ValidatorRule {
+    type: 'list' | 'number' | 'date' | 'phone' | 'email';
+    required?: boolean;
+    pattern?: string | RegExp;
+    min?: number;
+    max?: number;
+    options?: string[];
+    immediate?: boolean;
+    [key: string]: any;
+}
+/**
+ * All supported column types, including built-in types and registered viewer types.
+ * Custom viewer types can be registered via ViewerRegistry.register().
+ */
+export type ColumnType = 'text' | 'number' | 'select' | 'date' | 'datetime' | 'month' | 'time' | 'image' | 'nested' | 'nested-child' | 'person' | 'progress' | 'boolean' | 'checkbox' | 'status' | 'group-header' | 'separator-row' | 'punch' | 'hyperlink' | 'file' | 'task-node' | 'module' | 'text-with-switcher' | 'upstream' | 'table-action-button' | (string & Record<string, never>);
+export interface ColumnConfig {
+    title: string;
+    key: string;
+    label?: string;
+    size?: 'mini' | 'small' | 'medium' | 'large';
+    fixed?: 'left' | 'right' | '';
+    fixedLeft?: boolean;
+    fixedRight?: boolean;
+    readonly?: boolean;
+    align?: 'left' | 'center' | 'right';
+    baseline?: 'top' | 'middle' | 'bottom';
+    type?: ColumnType;
+    options?: ViewerOption[];
+    render?: (value: any) => string;
+    rule?: ValidatorRule;
+    children?: ColumnConfig[];
+    level?: number;
+    rowspan?: number;
+    colspan?: number;
+    index?: number;
+    width?: number;
+    parentKey?: string;
+    nestedKey?: string;
+    nestedChildOffset?: number;
+    color?: string;
+    [key: string]: any;
+}
+export interface SelectorState {
+    show: boolean;
+    isSelected: boolean;
+    xArr: [number, number];
+    yArr: [number, number];
+}
+export interface EditorState {
+    show: boolean;
+    xIndex: number;
+    yIndex: number;
+}
+export interface AutofillState {
+    enable: boolean;
+    xIndex: number;
+    yIndex: number;
+    xArr: [number, number];
+    yArr: [number, number];
+}
+export interface RangeState {
+    minX: number;
+    minY: number;
+    maxY: number;
+    maxX?: number;
+}
+export interface DrawOptions {
+    borderColor?: string;
+    borderWidth?: number;
+    fillColor?: string;
+    shadowBlur?: number;
+    shadowColor?: string;
+    shadowOffsetX?: number;
+    shadowOffsetY?: number;
+    lineDash?: number[];
+    lineCap?: CanvasLineCap;
+    lineJoin?: CanvasLineJoin;
+}
+export interface TextOptions {
+    font?: string;
+    color?: string;
+    align?: 'left' | 'center' | 'right';
+    baseLine?: 'top' | 'middle' | 'bottom';
+    icon?: HTMLImageElement | null;
+    iconWidth?: number;
+    iconHeight?: number;
+    iconOffsetX?: number;
+    iconOffsetY?: number;
+}
+export interface ClipboardState {
+    show: boolean;
+    isPaste: boolean;
+    xArr: [number, number];
+    yArr: [number, number];
+}
+export interface EventHandlers {
+    [key: string]: (e: Event) => void;
+}
+export type Direction = 'LEFT' | 'TOP' | 'RIGHT' | 'BOTTOM';
+export type ScrollDirection = 'HORIZONTAL' | 'VERTICAL';
+/**
+ * Group level enumeration for multi-level grouping (max 3 levels)
+ * 0 = First level (most prominent)
+ * 1 = Second level
+ * 2 = Third level
+ */
+export type GroupLevel = 0 | 1 | 2;
+/**
+ * Separate row level enumeration
+ */
+export type SeparateLevel = 0 | 1 | 2;
+/**
+ * Base interface for all row types in grouped table
+ */
+export interface BaseGroupedRowData {
+    id: string | number;
+    [key: string]: any;
+}
+/**
+ * Group header row data
+ * Represents a collapsible group header in the table
+ */
+export interface GroupRowData extends BaseGroupedRowData {
+    /** Identifies this row as a group header */
+    isGroup: true;
+    /** Group name - can be string or array (e.g., list of people) */
+    name: string | string[];
+    /** Raw group name */
+    rawName?: string | string[];
+    /** Nesting level of the group (0, 1, or 2) */
+    groupLevel: GroupLevel;
+    /** Whether the group is expanded */
+    expanded: boolean;
+    /** Number of items in this group */
+    count?: number;
+    /** Whether to show the count badge */
+    showCount?: boolean;
+    /** Whether to show user working hours icon */
+    showUserWorkingHours?: boolean;
+    /** Whether this group has children */
+    hasChildren?: boolean;
+    /** Parent group ID */
+    parentId?: string | number;
+    /** Whether this is a leaf group (no sub-groups) */
+    isLeafGroup?: boolean;
+    /** Multi-level group name array */
+    multiGroupName?: string[];
+    /** Multi-level group value array */
+    multiValue?: any[];
+    /** Group path */
+    path?: any[];
+    /** Value path */
+    valuePath?: any[];
+    /** Property name for grouping */
+    property?: string;
+    /** Group value */
+    value?: any;
+    /** Custom row height (optional) */
+    rowHeight?: number;
+    /** Children rows (for nested structure) */
+    children?: GroupedTableRowData[];
+    /** Separate rows (for nested structure) */
+    separate?: SeparateRowData[];
+}
+/**
+ * Separate row data
+ * Represents a visual separator between groups
+ */
+export interface SeparateRowData extends BaseGroupedRowData {
+    /** Identifies this row as a separator */
+    isSeparateRow: true;
+    /** Nesting level of the separator */
+    separateLevel: SeparateLevel;
+    /** Group level context */
+    groupLevel?: GroupLevel;
+    /** Whether this is the end level */
+    isEndLevel?: boolean;
+    /** Row height - typically 12px for separators */
+    rowHeight?: number;
+    /** Group name context */
+    groupName?: {
+        multi_group_name: string[];
+        multi_value: any[];
+    };
+    /** Filter match status */
+    filterMatched?: boolean;
+}
+/**
+ * Normal data row (not a group header or separator)
+ */
+export interface NormalRowData extends BaseGroupedRowData {
+    /** Identifies this row as NOT a group header */
+    isGroup?: false;
+    /** Identifies this row as NOT a separator */
+    isSeparateRow?: false;
+    /** Proxied data object (contains actual row data) */
+    proxyedData?: {
+        id: string | number;
+        name?: string;
+        [key: string]: any;
+    };
+    /** Custom row height (optional) */
+    rowHeight?: number;
+    /** Parent ID for grouping context */
+    parentId?: string | number;
+    /** Group name context */
+    groupName?: {
+        multi_group_name: string[];
+        multi_value: any[];
+    };
+    /** Filter match status */
+    filterMatched?: boolean;
+    [key: string]: any;
+}
+/**
+ * Union type for all row types in a grouped table
+ */
+export type GroupedTableRowData = GroupRowData | SeparateRowData | NormalRowData;
+/**
+ * Type guard to check if a row is a group header
+ */
+export declare function isGroupRow(row: unknown): row is GroupRowData;
+/**
+ * Type guard to check if a row is a separator
+ */
+export declare function isSeparateRow(row: unknown): row is SeparateRowData;
+/**
+ * Type guard to check if a row is a normal data row
+ */
+export declare function isNormalRow(row: unknown): row is NormalRowData;
+/**
+ * Constants for grouped table rendering
+ */
+export declare const GROUP_TABLE_CONSTANTS: {
+    /** Default row height for group headers */
+    GROUP_HEADER_HEIGHT: number;
+    /** Default row height for separators */
+    SEPARATOR_HEIGHT: number;
+    /** Default row height for normal rows */
+    NORMAL_ROW_HEIGHT: number;
+    /** Indentation per group level */
+    LEVEL_INDENT: number;
+    /** Arrow icon size */
+    ARROW_SIZE: number;
+    /** Padding for group header content */
+    GROUP_PADDING: number;
+};
+/**
+ * Group row style configuration
+ */
+export interface GroupRowStyle {
+    /** Background color for group level 0 */
+    level0BgColor: string;
+    /** Background color for group level 1 */
+    level1BgColor: string;
+    /** Background color for group level 2 */
+    level2BgColor: string;
+    /** Text color for group headers */
+    textColor: string;
+    /** Font weight for group headers */
+    fontWeight: string;
+    /** Font size for group headers */
+    fontSize: number;
+}
+/**
+ * Separator row style configuration
+ */
+export interface SeparatorRowStyle {
+    /** Background color for separator level 0 */
+    level0BgColor: string;
+    /** Background color for separator level 1 */
+    level1BgColor: string;
+    /** Background color for separator level 2 */
+    level2BgColor: string;
+}
+/**
+ * Default styles for grouped table
+ */
+export declare const DEFAULT_GROUP_STYLES: GroupRowStyle;
+export declare const DEFAULT_SEPARATOR_STYLES: SeparatorRowStyle;
+/**
+ * 统计选项接口
+ */
+export interface StatisticOption {
+    key: string;
+    label: string;
+}
+/**
+ * Footer 单元格数据
+ */
+export interface FooterCellData {
+    /** 统计类型标识 */
+    statisticType: string;
+    /** 格式化后的显示文本，null 表示无数据 */
+    value: string | null;
+}
+/**
+ * Footer 数据，key 为列的 columnKey
+ */
+export type FooterData = Record<string, FooterCellData>;
+/**
+ * Footer 单元格点击回调信息
+ */
+export interface FooterCellClickInfo {
+    /** 列标识 */
+    columnKey: string;
+    /** 列 editor 类型 */
+    editor: string;
+    /** 当前统计类型 */
+    statisticType: string;
+    /** 可选统计选项列表 */
+    statisticOptions: StatisticOption[];
+    /** 点击位置的 clientX */
+    clientX: number;
+    /** 点击位置的 clientY */
+    clientY: number;
+}

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

@@ -0,0 +1,17 @@
+import type { ColumnConfig } from './types';
+interface HeaderConfig extends ColumnConfig {
+    children?: HeaderConfig[];
+}
+declare const toLeaf: (arr?: HeaderConfig[]) => HeaderConfig[];
+declare const getMaxRow: (config?: HeaderConfig[]) => number;
+declare const calCrossSpan: (arr?: HeaderConfig[], maxRow?: number, level?: number) => HeaderConfig[];
+declare function getIcon(type: string): string;
+/**
+ * 根据文件状态和当前主题获取对应的图标
+ * @param fileStatus 文件状态
+ * @param format 文件格式
+ * @returns 对应的图标
+ */
+declare function getIconByFileStatus(fileStatus: string | number | undefined, format?: string): any;
+export type { HeaderConfig };
+export { toLeaf, getMaxRow, calCrossSpan, getIcon, getIconByFileStatus, };

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

@@ -0,0 +1,46 @@
+/**
+ * BooleanViewer - Boolean/Checkbox rendering viewer
+ * Handles boolean value display with checkbox, switch, or text styles
+ */
+import type { CellViewer, ViewerRenderContext, BooleanViewerData } from './types';
+/**
+ * BooleanViewer renders boolean values in cells
+ * Supports checkbox, switch, and text display styles
+ */
+declare class BooleanViewer implements CellViewer<BooleanViewerData> {
+    readonly type = "boolean";
+    /**
+     * Handle click on boolean cell
+     * Returns true if the click was on the checkbox/switch area
+     */
+    onClick(context: ViewerRenderContext, data: BooleanViewerData, localX: number, localY: number): boolean;
+    /**
+     * Return pointer cursor when hovering over the interactive area
+     */
+    getInteractiveCursor(context: ViewerRenderContext, data: BooleanViewerData, localX: number, localY: number): string | null;
+    /**
+     * Draw boolean content in the cell
+     */
+    draw(context: ViewerRenderContext, data: BooleanViewerData): void;
+    /**
+     * Draw checkbox style
+     */
+    private drawCheckbox;
+    /**
+     * Draw switch style
+     */
+    private drawSwitch;
+    /**
+     * Draw text style
+     */
+    private drawText;
+    /**
+     * Draw a filled rounded rectangle
+     */
+    private drawRoundedRect;
+    /**
+     * Draw a stroked rounded rectangle
+     */
+    private drawRoundedRectStroke;
+}
+export default BooleanViewer;

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

@@ -0,0 +1,33 @@
+/**
+ * DatetimeViewer - Date and time rendering viewer
+ * Handles date/time display with formatting and icon support
+ */
+import type { CellViewer, ViewerRenderContext, DatetimeViewerData } from './types';
+/**
+ * DatetimeViewer renders date and time values in cells
+ * Supports various formats and display types
+ */
+declare class DatetimeViewer implements CellViewer<DatetimeViewerData> {
+    readonly type = "datetime";
+    /**
+     * Draw datetime content in the cell
+     */
+    draw(context: ViewerRenderContext, data: DatetimeViewerData): void;
+    /**
+     * Format date based on configuration
+     */
+    private formatDate;
+    /**
+     * Apply format string to date
+     */
+    private applyFormat;
+    /**
+     * Pad number with leading zero
+     */
+    private padZero;
+    /**
+     * Draw date/time icon
+     */
+    private drawIcon;
+}
+export default DatetimeViewer;

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

@@ -0,0 +1,87 @@
+/**
+ * DeliverableReviewViewer - 交付物审核 viewer
+ * 用于展示交付物审核文件列表（审核图标 + 文件名），支持多文件展示
+ * 参考 AssetMatrix/src/views/components/ProgressPanel/ProgressPropsViewer/deliverableReviewViewer.ts
+ */
+import type { CellViewer, ViewerRenderContext, DeliverableReviewViewerData } from './types';
+/**
+ * DeliverableReviewViewer 在单元格中渲染交付物审核文件列表
+ * 展示形如 [📄] 文件名1  [📄] 文件名2 的内容
+ */
+declare class DeliverableReviewViewer implements CellViewer<DeliverableReviewViewerData> {
+    readonly type = "deliverable-review";
+    /** 空值占位符 */
+    private readonly emptyValue;
+    /** 审核图标颜色 */
+    private readonly reviewIconColor;
+    /** 普通文件图标颜色 */
+    private readonly fileIconColor;
+    /** 文件名文字颜色 */
+    private readonly nameColor;
+    /** 文件名 hover 颜色（可点击文件） */
+    private readonly nameHoverColor;
+    /** 编辑图标颜色 */
+    private readonly editIconColor;
+    /**
+     * 绘制交付物审核内容
+     */
+    draw(context: ViewerRenderContext, data: DeliverableReviewViewerData): void;
+    /**
+     * 处理点击事件
+     */
+    onClick(context: ViewerRenderContext, data: DeliverableReviewViewerData, localX: number, localY: number): boolean;
+    /**
+     * 获取交互区域光标
+     */
+    getInteractiveCursor(context: ViewerRenderContext, data: DeliverableReviewViewerData, localX: number, localY: number): string | null;
+    /**
+     * 解析审核文件项列表
+     */
+    private parseReviewItems;
+    /**
+     * 绘制审核文件项列表
+     */
+    private drawReviewItems;
+    /**
+     * 绘制空值占位文本
+     */
+    private drawEmptyText;
+    /**
+     * 绘制文件图标
+     * 审核类型显示蓝色审核图标，普通文件显示灰色文件图标
+     */
+    private drawFileIcon;
+    /**
+     * 绘制审核图标（文件 + 对勾标记）
+     */
+    private drawReviewIcon;
+    /**
+     * 绘制普通文件图标
+     */
+    private drawDocumentIcon;
+    /**
+     * 绘制编辑按钮（铅笔图标）
+     */
+    private drawEditButton;
+    /**
+     * 绘制铅笔编辑图标
+     */
+    private drawPencilIcon;
+    /**
+     * 绘制错误指示器（右上角红色三角）
+     */
+    private drawErrorIndicator;
+    /**
+     * 绘制删除线
+     */
+    private drawStrikethrough;
+    /**
+     * 绘制圆角矩形
+     */
+    private drawRoundedRect;
+    /**
+     * 截断文本并添加省略号
+     */
+    private truncateText;
+}
+export default DeliverableReviewViewer;

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

@@ -0,0 +1,37 @@
+/**
+ * FileStorageSpecViewer - 交付地址 Viewer
+ * 在 canvas 单元格中渲染交付存储地址，支持悬停下划线和双击交互
+ */
+import type { CellViewer, ViewerRenderContext, FileStorageSpecViewerData } from './types';
+declare class FileStorageSpecViewer implements CellViewer<FileStorageSpecViewerData> {
+    readonly type = "file-storage-spec";
+    /**
+     * 解析 value，返回有效的显示文本或 null
+     */
+    private parseValue;
+    /**
+     * 绘制单元格内容
+     */
+    draw(context: ViewerRenderContext, data: FileStorageSpecViewerData): void;
+    /**
+     * 处理双击事件
+     */
+    onDblClick(context: ViewerRenderContext, data: FileStorageSpecViewerData, localX: number, localY: number): boolean;
+    /**
+     * 获取交互光标
+     */
+    getInteractiveCursor(context: ViewerRenderContext, data: FileStorageSpecViewerData, localX: number, localY: number): string | null;
+    /**
+     * 绘制占位符文本
+     */
+    private drawPlaceholder;
+    /**
+     * 截断文字并添加省略号
+     */
+    private truncateText;
+    /**
+     * 估算文字宽度（用于交互区域判断，不依赖 ctx）
+     */
+    private estimateTextWidth;
+}
+export default FileStorageSpecViewer;