arthub-table 0.0.3

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

@@ -0,0 +1,112 @@
+/**
+ * TextViewerWithSwitcher - Tree-structured text viewer with expand/collapse
+ * Displays task names with tree hierarchy, expand/collapse buttons,
+ * task icons, child count badges, and error/warning indicators
+ */
+import type { CellViewer, ViewerRenderContext, TextViewerWithSwitcherData } from './types';
+/**
+ * TextViewerWithSwitcher renders task names with tree hierarchy
+ * Supports expand/collapse, task icons, child count, error indicators
+ */
+declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitcherData> {
+    readonly type = "text-with-switcher";
+    private imageManager;
+    private arrowImage;
+    private totalNumImage;
+    private loadingAngle;
+    private lastLayoutBounds;
+    constructor();
+    /**
+     * Preload SVG icons
+     */
+    private preloadIcons;
+    /**
+     * Main draw method
+     */
+    draw(context: ViewerRenderContext, data: TextViewerWithSwitcherData): void;
+    /**
+     * Draw tree indent lines
+     * Only draws vertical dashed lines for each indent level (no horizontal connectors).
+     * - isLastLeafArr[i] === true: ancestor at level i still has siblings -> full height line
+     * - isLastLeafArr[i] === false: ancestor at level i is the last child -> half height line (top to middle)
+     * @returns New X position
+     */
+    private drawIndentLines;
+    /**
+     * Draw expand/collapse arrow or loading indicator
+     * @returns New X position
+     */
+    private drawExpandArrow;
+    /**
+     * Draw loading spinner animation
+     */
+    private drawLoadingSpinner;
+    /**
+     * Draw vertical dashed line below the expand icon (when node is expanded)
+     * This connects the expand arrow to its child nodes below.
+     * Mirrors DOM's .switch-icon-down-expand-line behavior.
+     */
+    private drawExpandDownLine;
+    /**
+     * Draw fallback triangle arrow (when SVG fails to load)
+     */
+    private drawFallbackArrow;
+    /**
+     * Draw task icon and optional link icon
+     * @returns New X position
+     */
+    private drawIcon;
+    /**
+     * Draw task name text with truncation, strikethrough, weaken, and markdown link support
+     * @returns New X position after text
+     */
+    private drawText;
+    /**
+     * Calculate right reserved width for totalNum, downstream, and error icons
+     */
+    private calcRightReservedWidth;
+    /**
+     * Draw right area: totalNum icon, downstream indicator, error/warning icon
+     */
+    private drawRightArea;
+    /**
+     * Draw totalNum icon and count
+     * @returns New right X position (moving leftward)
+     */
+    private drawTotalNum;
+    /**
+     * Draw downstream node indicator
+     * @returns New right X position (moving leftward)
+     */
+    private drawDownstreamIcon;
+    /**
+     * Draw error or warning icon
+     * @returns New right X position (moving leftward)
+     */
+    private drawErrorIcon;
+    /**
+     * Get display text from data
+     */
+    private getDisplayText;
+    /**
+     * Extract plain text from HTML/rich text
+     */
+    private extractPlainText;
+    /**
+     * Truncate text with ellipsis if exceeds max width
+     */
+    private truncateText;
+    /**
+     * Calculate layout bounds for a given data set (used by onClick/getInteractiveCursor)
+     */
+    private calcLayoutBounds;
+    /**
+     * Handle click events on the cell
+     */
+    onClick(context: ViewerRenderContext, data: TextViewerWithSwitcherData, localX: number, _localY: number): boolean;
+    /**
+     * Get interactive cursor for hover areas
+     */
+    getInteractiveCursor(context: ViewerRenderContext, data: TextViewerWithSwitcherData, localX: number, _localY: number): string | null;
+}
+export default TextViewerWithSwitcher;

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

@@ -0,0 +1,36 @@
+/**
+ * ThemeViewer - 主题文本渲染 viewer
+ * 用于展示主题标签（图标 + 主题名称 + 后缀），如 [🎨] 主题A 等2个
+ * 参考 AssetMatrix/src/views/components/ProgressPanel/ProgressPropsViewer/themeViewer.ts
+ */
+import type { CellViewer, ViewerRenderContext, ThemeViewerData } from './types';
+/**
+ * ThemeViewer 在单元格中渲染主题标签
+ * 展示形如 [图标] 主题名称 等N个 的内容
+ */
+declare class ThemeViewer implements CellViewer<ThemeViewerData> {
+    readonly type = "theme";
+    /** 空值占位符 */
+    private readonly emptyValue;
+    /**
+     * 绘制主题内容
+     */
+    draw(context: ViewerRenderContext, data: ThemeViewerData): void;
+    /**
+     * 绘制主题内容（图标 + 名称 + 后缀）
+     */
+    private drawThemeContent;
+    /**
+     * 绘制主题图标（皮肤/调色板图标）
+     */
+    private drawThemeIcon;
+    /**
+     * 绘制空值占位文本
+     */
+    private drawEmptyText;
+    /**
+     * 截断文本并添加省略号
+     */
+    private truncateText;
+}
+export default ThemeViewer;

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

@@ -0,0 +1,55 @@
+/**
+ * TreeDropdownViewer - 树形下拉选择渲染 Viewer
+ * 将树形选中的路径值渲染为面包屑风格的标签
+ * 超出单元格宽度时文本截断打点显示
+ */
+import type { CellViewer, ViewerRenderContext, TreeDropdownViewerData } from './types';
+/**
+ * TreeDropdownViewer 渲染树形下拉选择结果
+ * 支持多选路径标签展示，如 "第二层"、"第二层/1"、"第二层/1/2"
+ * 超出单元格宽度时标签文本截断打点
+ */
+declare class TreeDropdownViewer implements CellViewer<TreeDropdownViewerData> {
+    readonly type = "tree-dropdown";
+    /**
+     * Draw tree dropdown content in the cell
+     */
+    draw(context: ViewerRenderContext, data: TreeDropdownViewerData): void;
+    /**
+     * 根据 data 解析出需要展示的路径标签列表
+     */
+    private getPathLabels;
+    /**
+     * 获取路径的最后一段
+     */
+    private getLastSegment;
+    /**
+     * 绘制空状态
+     */
+    private drawEmptyState;
+    /**
+     * 绘制路径标签列表（标签紧凑左对齐，空间不足时等比缩小并截断打点）
+     */
+    private drawPathTags;
+    /**
+     * 计算标签宽度
+     */
+    private calculateTagWidth;
+    /**
+     * 绘制单个路径标签
+     */
+    private drawPathTag;
+    /**
+     * 绘制圆角矩形（填充）
+     */
+    private drawRoundedRect;
+    /**
+     * 绘制圆角矩形边框
+     */
+    private drawRoundedRectBorder;
+    /**
+     * 文本截断，超出宽度显示省略号，至少保留一个可见字符
+     */
+    private truncateText;
+}
+export default TreeDropdownViewer;

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

@@ -0,0 +1,79 @@
+/**
+ * UpstreamViewer - Upstream dependency status rendering viewer
+ * Displays upstream field view items with module tags, completion status,
+ * resource preview thumbnails, and reminder indicators.
+ *
+ * Layout per item: [ModuleTag] [DoneIcon + StatusText] [PreviewImages...]
+ *                  [ModuleTag] [ReminderTag]
+ * Empty state: "-"
+ */
+import type { CellViewer, ViewerRenderContext, UpstreamViewerData } from './types';
+declare class UpstreamViewer implements CellViewer<UpstreamViewerData> {
+    readonly type = "upstream";
+    private imageManager;
+    private failedImages;
+    private pendingLoads;
+    constructor();
+    /**
+     * Draw upstream cell content
+     */
+    draw(context: ViewerRenderContext, data: UpstreamViewerData): void;
+    /**
+     * Handle click events — detect clicks on preview images
+     */
+    onClick(context: ViewerRenderContext, data: UpstreamViewerData, localX: number, localY: number): boolean;
+    /**
+     * Get interactive cursor for preview images
+     */
+    getInteractiveCursor(context: ViewerRenderContext, data: UpstreamViewerData, localX: number, localY: number): string | null;
+    /**
+     * Draw empty state placeholder
+     */
+    private drawEmpty;
+    /**
+     * Draw module tag with background color
+     * @returns tag width drawn
+     */
+    private drawModuleTag;
+    /**
+     * Draw reminder tag for incomplete items
+     * @returns tag width drawn
+     */
+    private drawReminderTag;
+    /**
+     * Draw done status: checkmark icon + status text + preview images
+     * @returns new currentX after drawing
+     */
+    private drawDoneStatus;
+    /**
+     * Draw preview images for sync properties
+     * @returns new currentX after drawing
+     */
+    private drawPreviewImages;
+    /**
+     * Draw a single preview image with rounded corners
+     */
+    private drawPreviewImage;
+    /**
+     * Draw an SVG icon (for fallback / file type icons)
+     */
+    private drawSvgIcon;
+    /**
+     * Draw a checkmark icon
+     */
+    private drawCheckmark;
+    /**
+     * Calculate clickable areas for preview images
+     * Returns array of {x, y, width, height, imageUrl, assetId, index} in cell-local coords
+     */
+    private calculateClickAreas;
+    /**
+     * Draw a rounded rectangle
+     */
+    private drawRoundRect;
+    /**
+     * Clip to rounded rectangle path
+     */
+    private clipRoundRect;
+}
+export default UpstreamViewer;

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

@@ -0,0 +1,76 @@
+/**
+ * ViewerRegistry - Central registry for cell viewers
+ * Manages viewer registration and retrieval with fallback support
+ */
+import type { CellViewer, CellViewerData, ViewerConstructor, ViewerFactory } from './types';
+/**
+ * Central registry for cell viewers
+ * Uses singleton pattern to ensure consistent viewer management
+ */
+declare class ViewerRegistry {
+    private static instance;
+    /** Map of viewer type to viewer instance */
+    private viewers;
+    /** Default viewer type for fallback */
+    private defaultViewerType;
+    /** Whether the registry has been initialized */
+    private initialized;
+    /** Track warned types to avoid repeated console.warn */
+    private warnedTypes;
+    private constructor();
+    /**
+     * Get the singleton instance of ViewerRegistry
+     */
+    static getInstance(): ViewerRegistry;
+    /**
+     * Register a viewer for a specific type
+     * @param type Viewer type identifier
+     * @param viewer Viewer instance, constructor, or factory function
+     */
+    register<T extends CellViewerData>(type: string, viewer: CellViewer<T> | ViewerConstructor<T> | ViewerFactory<T>): void;
+    /**
+     * Register multiple viewers at once
+     * @param viewers Object mapping types to viewers
+     */
+    registerAll(viewers: Record<string, CellViewer<any> | ViewerConstructor<any> | ViewerFactory<any>>): void;
+    /**
+     * Get a viewer by type
+     * Falls back to default viewer if type is not found
+     * @param type Viewer type identifier
+     * @returns Viewer instance
+     */
+    get<T extends CellViewerData = CellViewerData>(type: string): CellViewer<T> | null;
+    /**
+     * Check if a viewer type is registered
+     * @param type Viewer type identifier
+     */
+    has(type: string): boolean;
+    /**
+     * Get all registered viewer types
+     */
+    getRegisteredTypes(): string[];
+    /**
+     * Set the default viewer type for fallback
+     * @param type Viewer type identifier
+     */
+    setDefaultViewerType(type: string): void;
+    /**
+     * Get the default viewer type
+     */
+    getDefaultViewerType(): string;
+    /**
+     * Unregister a viewer
+     * @param type Viewer type identifier
+     */
+    unregister(type: string): boolean;
+    /**
+     * Clear all registered viewers
+     */
+    clear(): void;
+    /**
+     * Get viewer count
+     */
+    get size(): number;
+}
+export declare const getViewerRegistry: () => ViewerRegistry;
+export default ViewerRegistry;

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

@@ -0,0 +1,76 @@
+/**
+ * WfStateViewer - 工作流状态 Viewer
+ * 在 canvas 单元格中渲染工作流状态图标、名称文字、以及右上角的角标
+ */
+import type { CellViewer, ViewerRenderContext, WfStateViewerData } from './types';
+declare class WfStateViewer implements CellViewer<WfStateViewerData> {
+    readonly type = "wf-state";
+    private imageManager;
+    /** 记录加载失败的图标 URL，避免反复重试 */
+    private failedIcons;
+    constructor();
+    /**
+     * 绘制单元格内容
+     */
+    draw(context: ViewerRenderContext, data: WfStateViewerData): void;
+    /**
+     * 处理点击事件
+     */
+    onClick(context: ViewerRenderContext, data: WfStateViewerData, localX: number, localY: number): boolean;
+    /**
+     * 获取交互光标
+     */
+    getInteractiveCursor(context: ViewerRenderContext, data: WfStateViewerData, localX: number, localY: number): string | null;
+    /**
+     * 从 value 中提取状态类型
+     */
+    private parseValue;
+    /**
+     * 根据图标名称绘制对应 SVG 图标
+     * icon 值为 stateIcon 目录下的文件名（不含 .svg 后缀），未找到则兜底使用 ah-icon_supervise
+     */
+    private drawIcon;
+    /**
+     * 通用 SVG 图标绘制方法
+     * 通过 ImageManager 加载 SVG 图片并绘制到 Canvas 上
+     */
+    private drawSvgIcon;
+    /**
+     * 使用离屏 Canvas 对图片进行着色绘制
+     * 原理：先在离屏 Canvas 上绘制原图，再用 'source-in' 合成模式覆盖指定颜色
+     */
+    private drawTintedImage;
+    /**
+     * 绘制文字，支持截断省略
+     */
+    private drawText;
+    /**
+     * 绘制占位符文本
+     */
+    private drawPlaceholder;
+    /**
+     * 绘制角标（右上角三角形）
+     */
+    private drawCorner;
+    /**
+     * 判断是否应该显示角标
+     */
+    private hasValidCorner;
+    /**
+     * 检查坐标是否在角标区域内
+     */
+    private isInCornerArea;
+    /**
+     * 从 context 中判断鼠标是否在角标区域（用于 hover 检测）
+     */
+    private isInCornerAreaFromContext;
+    /**
+     * 截断文字并添加省略号
+     */
+    private truncateText;
+    /**
+     * 估算文字宽度（用于交互区域判断，不依赖 ctx）
+     */
+    private estimateTextWidth;
+}
+export default WfStateViewer;

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

@@ -0,0 +1,37 @@
+/**
+ * WorkflowViewer - 工作流 Viewer
+ * 在 canvas 单元格中渲染工作流名称列表，支持悬停下划线和点击交互
+ */
+import type { CellViewer, ViewerRenderContext, WorkflowViewerData } from './types';
+declare class WorkflowViewer implements CellViewer<WorkflowViewerData> {
+    readonly type = "workflow";
+    /**
+     * 解析 value，返回过滤后的 string[]
+     */
+    private parseValue;
+    /**
+     * 绘制单元格内容
+     */
+    draw(context: ViewerRenderContext, data: WorkflowViewerData): void;
+    /**
+     * 处理点击事件
+     */
+    onClick(context: ViewerRenderContext, data: WorkflowViewerData, localX: number, localY: number): boolean;
+    /**
+     * 获取交互光标
+     */
+    getInteractiveCursor(context: ViewerRenderContext, data: WorkflowViewerData, localX: number, localY: number): string | null;
+    /**
+     * 绘制占位符文本
+     */
+    private drawPlaceholder;
+    /**
+     * 截断文字并添加省略号
+     */
+    private truncateText;
+    /**
+     * 估算文字宽度（用于交互区域判断，不依赖 ctx）
+     */
+    private estimateTextWidth;
+}
+export default WorkflowViewer;

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

@@ -0,0 +1,114 @@
+/**
+ * Canvas-Table Viewers
+ * Central export for all viewer types and utilities
+ */
+export * from './types';
+export { default as ViewerRegistry, getViewerRegistry } from './ViewerRegistry';
+export { default as TextViewer } from './TextViewer';
+export { default as SelectViewer } from './SelectViewer';
+export { default as ImageViewer } from './ImageViewer';
+export { default as PersonViewer } from './PersonViewer';
+export { default as ProgressViewer } from './ProgressViewer';
+export { default as DatetimeViewer } from './DatetimeViewer';
+export { default as BooleanViewer } from './BooleanViewer';
+export { default as StatusViewer } from './StatusViewer';
+export { default as GroupHeaderViewer } from './GroupHeaderViewer';
+export { default as SeparatorRowViewer } from './SeparatorRowViewer';
+export { default as NestedGridViewer } from './NestedGridViewer';
+export { default as TreeDropdownViewer } from './TreeDropdownViewer';
+export { default as PunchViewer } from './PunchViewer';
+export { default as HyperlinkTextViewer } from './HyperlinkTextViewer';
+export { default as FileViewer } from './FileViewer';
+export { default as TaskNodeViewer } from './TaskNodeViewer';
+export { default as WfStateViewer } from './WfStateViewer';
+export { default as WorkflowViewer } from './WorkflowViewer';
+export { default as FileStorageSpecViewer } from './FileStorageSpecViewer';
+export { default as PivotViewer } from './PivotViewer';
+export { default as ModuleViewer } from './ModuleViewer';
+export { default as TextViewerWithSwitcher } from './TextViewerWithSwitcher';
+export { default as UpstreamViewer } from './UpstreamViewer';
+export { default as PunchTimingViewer } from './PunchTimingViewer';
+export { TableActionButtonViewer } from './TableActionButtonViewer';
+export { default as PriorityTextViewer } from './PriorityTextViewer';
+export { default as StatusTextViewer } from './StatusTextViewer';
+export { default as ThemeViewer } from './ThemeViewer';
+export { default as ItfsPathViewer } from './ItfsPathViewer';
+export { default as DeliverableReviewViewer } from './DeliverableReviewViewer';
+export { default as RichTextViewer } from './RichTextViewer';
+import TextViewer from './TextViewer';
+import SelectViewer from './SelectViewer';
+import ImageViewer from './ImageViewer';
+import PersonViewer from './PersonViewer';
+import ProgressViewer from './ProgressViewer';
+import DatetimeViewer from './DatetimeViewer';
+import BooleanViewer from './BooleanViewer';
+import StatusViewer from './StatusViewer';
+import GroupHeaderViewer from './GroupHeaderViewer';
+import SeparatorRowViewer from './SeparatorRowViewer';
+import NestedGridViewer from './NestedGridViewer';
+import TreeDropdownViewer from './TreeDropdownViewer';
+import PunchViewer from './PunchViewer';
+import HyperlinkTextViewer from './HyperlinkTextViewer';
+import FileViewer from './FileViewer';
+import TaskNodeViewer from './TaskNodeViewer';
+import WfStateViewer from './WfStateViewer';
+import WorkflowViewer from './WorkflowViewer';
+import FileStorageSpecViewer from './FileStorageSpecViewer';
+import PivotViewer from './PivotViewer';
+import ModuleViewer from './ModuleViewer';
+import TextViewerWithSwitcher from './TextViewerWithSwitcher';
+import UpstreamViewer from './UpstreamViewer';
+import PunchTimingViewer from './PunchTimingViewer';
+import { TableActionButtonViewer } from './TableActionButtonViewer';
+import PriorityTextViewer from './PriorityTextViewer';
+import StatusTextViewer from './StatusTextViewer';
+import ThemeViewer from './ThemeViewer';
+import ItfsPathViewer from './ItfsPathViewer';
+import DeliverableReviewViewer from './DeliverableReviewViewer';
+import RichTextViewer from './RichTextViewer';
+/**
+ * Register all default viewers
+ * Call this function once during application initialization
+ */
+export declare function registerDefaultViewers(): void;
+/**
+ * Default viewer map for quick access
+ */
+export declare const defaultViewers: {
+    text: typeof TextViewer;
+    number: typeof TextViewer;
+    select: typeof SelectViewer;
+    image: typeof ImageViewer;
+    person: typeof PersonViewer;
+    progress: typeof ProgressViewer;
+    datetime: typeof DatetimeViewer;
+    date: typeof DatetimeViewer;
+    time: typeof DatetimeViewer;
+    month: typeof DatetimeViewer;
+    boolean: typeof BooleanViewer;
+    checkbox: typeof BooleanViewer;
+    status: typeof StatusViewer;
+    'group-header': typeof GroupHeaderViewer;
+    'separator-row': typeof SeparatorRowViewer;
+    nested: typeof NestedGridViewer;
+    'tree-dropdown': typeof TreeDropdownViewer;
+    punch: typeof PunchViewer;
+    hyperlink: typeof HyperlinkTextViewer;
+    file: typeof FileViewer;
+    'task-node': typeof TaskNodeViewer;
+    'wf-state': typeof WfStateViewer;
+    workflow: typeof WorkflowViewer;
+    'file-storage-spec': typeof FileStorageSpecViewer;
+    pivot: typeof PivotViewer;
+    module: typeof ModuleViewer;
+    'text-with-switcher': typeof TextViewerWithSwitcher;
+    upstream: typeof UpstreamViewer;
+    'punch-timing': typeof PunchTimingViewer;
+    'table-action-button': typeof TableActionButtonViewer;
+    'priority-text': typeof PriorityTextViewer;
+    'status-text': typeof StatusTextViewer;
+    theme: typeof ThemeViewer;
+    'itfs-path': typeof ItfsPathViewer;
+    'deliverable-review': typeof DeliverableReviewViewer;
+    'rich-text': typeof RichTextViewer;
+};