arthub-table 0.0.3

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

@@ -0,0 +1,101 @@
+/**
+ * 画笔
+ */
+interface DrawLineOptions {
+    lineCap?: CanvasLineCap;
+    lineJoin?: CanvasLineJoin;
+    borderWidth?: number;
+    borderColor?: string;
+    fillColor?: string;
+    lineDash?: number[];
+}
+interface DrawTextOptions {
+    font?: string;
+    color?: string;
+    align?: CanvasTextAlign | "left" | "right";
+    baseLine?: CanvasTextBaseline;
+    bold?: boolean;
+}
+interface DrawCellTextOptions extends DrawTextOptions {
+    icon?: HTMLImageElement | {
+        src: string;
+    } | null;
+    iconWidth?: number;
+    iconHeight?: number;
+    iconOffsetX?: number;
+    iconOffsetY?: number;
+}
+interface DrawRectOptions {
+    borderWidth?: number;
+    borderColor?: string;
+    fillColor?: string;
+    shadowOffsetX?: number;
+    shadowOffsetY?: number;
+    shadowBlur?: number;
+    shadowColor?: string;
+}
+interface DrawIconOptions extends DrawTextOptions {
+}
+interface DrawCellAffixIconOptions {
+    color?: string;
+    fillColor?: string;
+}
+declare class Paint {
+    ctx: CanvasRenderingContext2D;
+    constructor(target: HTMLCanvasElement);
+    scaleCanvas(dpr: number): void;
+    drawLine(points: number[][], options?: DrawLineOptions): void;
+    /**
+     * 在指定位置渲染文本
+     * @param text 渲染的文本
+     * @param x 渲染的x轴位置
+     * @param y 渲染的y轴位置
+     * @param options 配置选项
+     */
+    drawText(text: string | number, x: number, y: number, options?: DrawTextOptions): void;
+    /**
+     * 在指定宽高的盒子里渲染文本，会结合文本的长度和盒子的宽来决定对齐方式
+     * @param text 渲染的文本
+     * @param x 渲染的初始x轴位置
+     * @param y 渲染的初始y轴位置
+     * @param width 盒子的宽
+     * @param height 盒子的高
+     * @param padding 左右边距
+     * @param options color, font, align...
+     */
+    drawCellText(text: string | number, x: number, y: number, width: number, height: number, padding: number, options?: DrawCellTextOptions): void;
+    drawCellAffixIcon(icon: string, x: number, y: number, width: number, height: number, options?: DrawCellAffixIconOptions): void;
+    /**
+     * 在文本前指定距离的位置渲染一个图标
+     * @param label 支持字符串图标或者实体字符
+     * @param text 指定文本
+     * @param x x坐标
+     * @param y y坐标
+     * @param width 宽度
+     * @param padding 边距
+     * @param offsetX 横坐标位移
+     * @param offsetY 纵坐标位移
+     * @param options 配置选项
+     */
+    drawIcon(label: string, text: string | number, x: number, y: number, width: number, padding: number, offsetX: number, offsetY: number, options?: DrawIconOptions): void;
+    drawRect(x: number, y: number, width: number, height: number, options?: DrawRectOptions): void;
+    drawRoundRect(x: number, y: number, width: number, height: number, raidus: number, options?: DrawRectOptions): void;
+    drawImage(img: HTMLImageElement | HTMLCanvasElement | {
+        src: string;
+    }, x: number, y: number, width: number, height: number): void;
+    clearCanvas(x?: number, y?: number, width?: number, height?: number): void;
+    /**
+     * 计算长文本自动换行
+     * @param text 文本
+     * @param width 单元格宽度
+     * @param padding 左右需要留出的padding
+     */
+    getTextWrapping(text: string | number, width: number, padding: number): string[];
+    /**
+     * 测量文本宽度
+     * @param text 文本
+     * @param fontSize 字体大小
+     */
+    measureText(text: string, fontSize?: number): number;
+}
+export default Paint;

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

@@ -0,0 +1,96 @@
+/**
+ * PerformanceMonitor - Performance monitoring and profiling utility for canvas-table.
+ *
+ * Provides:
+ * - performance.mark / performance.measure wrappers
+ * - Development mode performance warnings
+ * - Frame rate monitoring
+ * - Render timing statistics
+ */
+/** Log level for debug output */
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'verbose';
+/** Performance monitor configuration */
+export interface PerformanceMonitorConfig {
+    /** Enable performance monitoring (default: false) */
+    enabled: boolean;
+    /** Log level for console output (default: 'warn') */
+    logLevel: LogLevel;
+    /** Row count threshold for performance warning (default: 5000) */
+    largeDataThreshold: number;
+    /** Column count threshold for performance warning (default: 50) */
+    largeColumnThreshold: number;
+    /** Frame time warning threshold in ms (default: 16.67 for 60fps) */
+    frameTimeThreshold: number;
+}
+/** Render timing entry */
+interface TimingEntry {
+    name: string;
+    startTime: number;
+    duration: number;
+}
+export declare class PerformanceMonitor {
+    private config;
+    private timings;
+    private frameCount;
+    private lastFpsTime;
+    private currentFps;
+    private markMap;
+    constructor(config?: Partial<PerformanceMonitorConfig>);
+    /**
+     * Update configuration
+     */
+    setConfig(config: Partial<PerformanceMonitorConfig>): void;
+    /**
+     * Check if monitoring is enabled
+     */
+    get isEnabled(): boolean;
+    /**
+     * Set debug/enabled state
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Place a performance mark
+     */
+    mark(name: string): void;
+    /**
+     * Measure duration between two marks
+     */
+    measure(name: string, startMark: string, endMark?: string): number;
+    /**
+     * Call once per frame to track FPS
+     */
+    trackFrame(): void;
+    /**
+     * Get current FPS
+     */
+    getFps(): number;
+    /**
+     * Check data size and emit warnings if thresholds are exceeded
+     */
+    checkDataSize(rowCount: number, columnCount: number): void;
+    /**
+     * Warn if a render frame takes too long
+     */
+    checkFrameTime(duration: number): void;
+    /**
+     * Get collected timing statistics
+     */
+    getTimings(): ReadonlyArray<TimingEntry>;
+    /**
+     * Get average duration for a named measure
+     */
+    getAverageDuration(name: string): number;
+    /**
+     * Clear all collected timings
+     */
+    clearTimings(): void;
+    /**
+     * Log a message at the specified level
+     */
+    log(level: Exclude<LogLevel, 'silent'>, message: string): void;
+}
+/**
+ * Get or create the global PerformanceMonitor instance
+ */
+export declare function getPerformanceMonitor(config?: Partial<PerformanceMonitorConfig>): PerformanceMonitor;
+export {};

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

@@ -0,0 +1,31 @@
+import RowHeader from "./RowHeader";
+import Cell from "./Cell";
+import Context from "./Context";
+import type DataGrid from "./DataGrid";
+interface RowData {
+    [key: string]: any;
+}
+declare class Row extends Context {
+    data: RowData;
+    rowIndex: number;
+    _rowId: string;
+    checked: boolean;
+    allCells: Cell[];
+    fixedCells: Cell[];
+    cells: Cell[];
+    rowHeader: RowHeader;
+    constructor(grid: DataGrid, rowIndex: number, x: number, y: number, height: number, data: RowData);
+    isInVerticalAutofill(mouseX: number, mouseY: number): boolean;
+    handleCheck(checked?: boolean): void;
+    mouseDown(x: number, y: number): void;
+    mouseMove(mouseX: number, mouseY: number): void;
+    handleAutofill(x: number, y: number): void;
+    handleStartAutofill(x: number, y: number): void;
+    click(x: number, y: number): void;
+    dbClick(x: number, y: number): void;
+    resizeColumn(colIndex: number, diffWidth: number): void;
+    resizeRow(rowIndex: number, height: number): void;
+    rePaint(): void;
+    draw(): void;
+}
+export default Row;

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

@@ -0,0 +1,22 @@
+import Context from "./Context";
+import type DataGrid from "./DataGrid";
+interface RowHeaderOptions {
+    borderColor?: string;
+    fillColor?: string;
+    borderWidth?: number;
+    color?: string;
+    checked?: boolean;
+}
+declare class RowHeader extends Context {
+    rowIndex: number;
+    text: string | number;
+    checked: boolean;
+    borderColor?: string;
+    fillColor?: string;
+    borderWidth?: number;
+    color?: string;
+    constructor(grid: DataGrid, rowIndex: number, x: number, y: number, width: number, height: number, options?: RowHeaderOptions);
+    handleCheck(val: boolean): void;
+    draw(): void;
+}
+export default RowHeader;

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

@@ -0,0 +1,33 @@
+import type DataGrid from "./DataGrid";
+interface ScrollerState {
+    x?: number;
+    y?: number;
+    move: boolean;
+    focus: boolean;
+    size: number;
+    ratio: number;
+    has: boolean;
+}
+declare class Scroller {
+    grid: DataGrid;
+    horizontalScroller: ScrollerState;
+    verticalScroller: ScrollerState;
+    mouseOriginalX?: number;
+    mouseOriginalY?: number;
+    constructor(grid: DataGrid);
+    /**
+     * 初始化滚动条配置
+     */
+    reset(): void;
+    update(diff: number, dir: "HORIZONTAL" | "VERTICAL"): void;
+    setPosition(): void;
+    isInsideHorizontalScroller(mouseX: number, mouseY: number): boolean;
+    isInsideHorizontalScrollerBar(mouseX: number, mouseY: number): boolean;
+    isInsideVerticalScroller(mouseX: number, mouseY: number): boolean;
+    isInsideVerticalScrollerBar(mouseX: number, mouseY: number): boolean;
+    mouseDown(x: number, y: number): void;
+    mouseMove(x: number, y: number): void;
+    mouseUp(): void;
+    draw(): void;
+}
+export default Scroller;

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

@@ -0,0 +1,9 @@
+declare class Selector {
+    cornerEl: any;
+    areaEl: any;
+    clipboardEl: any;
+    autofillEl: any;
+    el: any;
+    constructor();
+}
+export default Selector;

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

@@ -0,0 +1,108 @@
+/**
+ * Canvas 样式管理器
+ * 提供类似 CSS 的样式定义和管理方式
+ */
+export interface CellStyle {
+    backgroundColor?: string;
+    backgroundColorHover?: string;
+    backgroundColorActive?: string;
+    backgroundColorReadonly?: string;
+    color?: string;
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: string;
+    textAlign?: CanvasTextAlign;
+    textBaseline?: CanvasTextBaseline;
+    borderColor?: string;
+    borderWidth?: number;
+    borderStyle?: 'solid' | 'dashed' | 'dotted';
+    paddingTop?: number;
+    paddingRight?: number;
+    paddingBottom?: number;
+    paddingLeft?: number;
+    opacity?: number;
+    cursor?: string;
+}
+export interface TableTheme {
+    global?: CellStyle;
+    header?: CellStyle;
+    cell?: CellStyle;
+    readonly?: CellStyle;
+    striped?: {
+        enabled?: boolean;
+        oddColor?: string;
+        evenColor?: string;
+    };
+    hover?: {
+        enabled?: boolean;
+        backgroundColor?: string;
+    };
+    selected?: CellStyle;
+    editing?: CellStyle;
+    checked?: {
+        enabled?: boolean;
+        backgroundColor?: string;
+    };
+}
+/**
+ * 预定义主题
+ */
+export declare const themes: Record<string, TableTheme>;
+/**
+ * 样式管理器类
+ */
+export declare class StyleManager {
+    private currentTheme;
+    private customStyles;
+    constructor(theme?: TableTheme | string);
+    /**
+     * 切换主题
+     */
+    setTheme(theme: TableTheme | string): void;
+    /**
+     * 获取当前主题
+     */
+    getTheme(): TableTheme;
+    /**
+     * 合并样式（类似 CSS 的层叠）
+     */
+    mergeStyles(...styles: (CellStyle | undefined)[]): CellStyle;
+    /**
+     * 获取单元格样式
+     */
+    getCellStyle(options: {
+        isHeader?: boolean;
+        isReadonly?: boolean;
+        isHover?: boolean;
+        isEditing?: boolean;
+        isStriped?: boolean;
+        isChecked?: boolean;
+        rowIndex?: number;
+        customClass?: string;
+    }): CellStyle;
+    /**
+     * 注册自定义样式类（类似 CSS class）
+     */
+    registerStyle(className: string, style: CellStyle): void;
+    /**
+     * 批量注册样式
+     */
+    registerStyles(styles: Record<string, CellStyle>): void;
+    /**
+     * 应用样式到 Canvas 上下文
+     */
+    applyToContext(ctx: CanvasRenderingContext2D, style: CellStyle): void;
+    /**
+     * 解析 padding 简写（类似 CSS）
+     */
+    parsePadding(padding: number | string): {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+/**
+ * 创建默认样式管理器实例
+ */
+export declare const defaultStyleManager: StyleManager;

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

@@ -0,0 +1,28 @@
+import type DataGrid from "./DataGrid";
+interface TooltipValue {
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    valid?: boolean;
+    message?: string;
+    colWidth?: number;
+    colHeight?: number;
+    fixed?: string;
+}
+declare class Tooltip {
+    grid: DataGrid;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    valid: boolean;
+    message?: string;
+    colWidth?: number;
+    colHeight?: number;
+    fixed?: string;
+    constructor(grid: DataGrid, x: number, y: number, message?: string, _type?: string);
+    update(value: TooltipValue): void;
+    draw(): void;
+}
+export default Tooltip;

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

@@ -0,0 +1,26 @@
+import { ColumnConfig, ColumnType } from "./types";
+import type { ViewerOption } from "./viewers/types";
+interface ValidationResult {
+    flag: boolean;
+    message?: string;
+}
+type ValidatorFunction = (value: any, row: any, callback: (res: string | boolean) => void) => void | Promise<void>;
+declare class Validator {
+    validateKey: string;
+    validateTitle: string;
+    columnType?: ColumnType;
+    type?: 'list' | 'number' | 'date' | 'phone' | 'email';
+    options?: ViewerOption[];
+    required?: boolean;
+    validator?: RegExp | ValidatorFunction;
+    operator?: string;
+    message?: string;
+    descriptor?: any;
+    pattern?: string | RegExp;
+    min?: number;
+    max?: number;
+    immediate?: boolean;
+    constructor(column: ColumnConfig);
+    validate(v: any, row: any): Promise<ValidationResult>;
+}
+export default Validator;

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

@@ -0,0 +1,5 @@
+export declare const dpr: number;
+declare const _default: {
+    dpr: number;
+};
+export default _default;

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

@@ -0,0 +1,39 @@
+export declare const CSS_PREFIX = "xs-data-grid";
+export declare const HEADER_HEIGHT = 36;
+export declare const FOOTER_HEIGHT = 36;
+export declare const ROW_INDEX_WIDTH = 36;
+export declare const CHECK_BOX_WIDTH = 36;
+export declare const CELL_HEIGHT = 36;
+export declare const MIN_CELL_WIDTH = 100;
+export declare const MIN_CELL_HEIGHT = 36;
+export declare const SCROLLER_TRACK_SIZE = 16;
+export declare const SCROLLER_SIZE = 8;
+export declare const SCROLLER_COLOR = "#dee0e3";
+export declare const SCROLLER_FOCUS_COLOR = "#bbbec4";
+export declare const SELECT_BORDER_COLOR = "rgb(82,146,247)";
+export declare const SELECT_AREA_COLOR = "rgba(82,146,247,0.1)";
+export declare const SELECT_BG_COLOR = "rgba(82,146,247,0.1)";
+export declare const READONLY_COLOR = "#f8f8f9";
+export declare const READONLY_TEXT_COLOR = "#80848f";
+export declare const ERROR_TIP_COLOR = "#ED3F14";
+/** 空值占位符 */
+export declare const EMPTY_VALUE = "-";
+/** 日期显示类型 */
+export declare enum DATE_DISPLAY_TYPE {
+    RELATIVE = "relative_date",
+    ABSOLUTE = "absolute_date"
+}
+export declare const SIZE_MAP: {
+    mini: number;
+    small: number;
+    medium: number;
+    large: number;
+};
+export declare const VALIDATOR_TYPES: string[];
+export declare const FILE_TYPE_FIELDS: {
+    readonly AssetConvertStatusNotSupport: -3;
+    readonly AssetConvertStatusUnknown: -2;
+    readonly AssetConvertStatusFailed: -1;
+    readonly AssetConvertStatusSuccess: 0;
+    readonly AssetConvertStatusSubmit: 1;
+};

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

@@ -0,0 +1,36 @@
+declare class Element {
+    el: HTMLElement;
+    private dataMap;
+    constructor(tag: string | HTMLElement, className?: string);
+    data(key: string, value?: any): any;
+    on(eventNames: string, handler: (evt: Event) => void): this;
+    offset(value?: any): any;
+    scroll(v?: any): any;
+    box(): DOMRect;
+    parent(): Element;
+    children(...eles: any[]): any;
+    removeChild(el: Node): void;
+    child(arg: string | Element | Node): this;
+    contains(ele: Node): boolean;
+    className(v?: string): any;
+    addClass(name: string): this;
+    hasClass(name: string): boolean;
+    removeClass(name: string): this;
+    toggle(cls?: string): boolean;
+    toggleClass(name: string): boolean;
+    active(flag?: boolean, cls?: string): this;
+    checked(flag?: boolean): this;
+    disabled(flag?: boolean): this;
+    attr(key: string | Record<string, any>, value?: string): any;
+    removeAttr(key: string): this;
+    html(content?: string): any;
+    val(v?: any): any;
+    focus(): void;
+    cssRemoveKeys(...keys: string[]): this;
+    css(name: string | Record<string, any>, value?: string): any;
+    computedStyle(): CSSStyleDeclaration;
+    show(): this;
+    hide(): this;
+}
+declare const h: (tag: string | HTMLElement, className?: string) => Element;
+export { Element, h };

package/dist/types/core/extension-type-mapping.d.ts

@@ -0,0 +1,5 @@
+export function e2t(extension: any): "image" | "versionset" | "pdf" | "exe" | "aep" | "ai" | "enf" | "mcp" | "x2d" | "xd" | "sketch" | "model" | "models" | "images" | "video" | "zipped" | "na" | "misc" | "iframeOffice" | "iframe" | "audio" | "pxcook";
+export function typeArr(type: any): string[];
+export function allExt(): string[];
+export function allowUploadExt(): string[];
+export function documentType(extension: any): "cell" | "word" | "slide";

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

@@ -0,0 +1,7 @@
+import type { StatisticOption } from '../types';
+/**
+ * 根据列的 editor 类型返回可选统计选项列表
+ * @param editor 列的编辑器类型
+ * @returns 统计选项列表
+ */
+export declare function getFieldStatisticTypes(editor: string): StatisticOption[];