arthub-table 0.0.3

package/dist/types/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * canvas-table - High-performance canvas-based table/grid component for Vue 3
+ *
+ * @packageDocumentation
+ */
+export { default as DataGrid } from './components/index.vue';
+export type { CellData, CellStyle, RowData, ColData, DataGridOptions, Position, Size, Rect, Range, CellRange, HistoryItem, ValidatorRule, ColumnType, ColumnConfig, SelectorState, EditorState, AutofillState, RangeState, DrawOptions, TextOptions, ClipboardState, EventHandlers, Direction, ScrollDirection, GroupLevel, SeparateLevel, BaseGroupedRowData, GroupRowData, SeparateRowData, NormalRowData, GroupedTableRowData, GroupRowStyle, SeparatorRowStyle, StatisticOption, FooterCellData, FooterData, FooterCellClickInfo, } from './core/types';
+export { isGroupRow, isSeparateRow, isNormalRow, GROUP_TABLE_CONSTANTS, DEFAULT_GROUP_STYLES, DEFAULT_SEPARATOR_STYLES, } from './core/types';
+export type { CellBounds, ViewerRenderContext, ViewerDragState, CellViewer, CellViewerData, ViewerOption, ViewerStyle, TextViewerData, SelectViewerData, ImageViewerData, PersonViewerData, PersonInfo, ProgressViewerData, DatetimeViewerData, BooleanViewerData, StatusViewerData, StatusOption, GroupHeaderViewerData, SeparatorRowViewerData, PunchViewerData, PunchValue, ModuleInfo, ModuleViewerData, TextViewerWithSwitcherData, FileItem, FileViewerData, HyperlinkTextViewerData, IUpstreamModule, IUpstreamReminderProperties, IUpstreamSyncProperty, IUpstreamFieldViewItem, UpstreamViewerData, TaskNodeItem, TaskNodeViewerData, NestedGridViewerData, NestedColumnConfig, ViewerConstructor, ViewerFactory, ViewerTypeMap, ViewerType, TypedCellData, TableActionButtonOption, TableActionButtonViewerData, } from './core/viewers/types';
+export { isTextViewerData, isSelectViewerData, isPersonViewerData, isProgressViewerData, isNestedGridViewerData, } from './core/viewers/types';
+export { default as ViewerRegistry, getViewerRegistry, } from './core/viewers/ViewerRegistry';
+export { registerDefaultViewers, defaultViewers } from './core/viewers/index';
+export { default as TextViewer } from './core/viewers/TextViewer';
+export { default as SelectViewer } from './core/viewers/SelectViewer';
+export { default as ImageViewer } from './core/viewers/ImageViewer';
+export { default as PersonViewer } from './core/viewers/PersonViewer';
+export { default as ProgressViewer } from './core/viewers/ProgressViewer';
+export { default as DatetimeViewer } from './core/viewers/DatetimeViewer';
+export { default as BooleanViewer } from './core/viewers/BooleanViewer';
+export { default as StatusViewer } from './core/viewers/StatusViewer';
+export { default as GroupHeaderViewer } from './core/viewers/GroupHeaderViewer';
+export { default as SeparatorRowViewer } from './core/viewers/SeparatorRowViewer';
+export { default as NestedGridViewer } from './core/viewers/NestedGridViewer';
+export { default as PunchViewer } from './core/viewers/PunchViewer';
+export { default as HyperlinkTextViewer } from './core/viewers/HyperlinkTextViewer';
+export { default as FileViewer } from './core/viewers/FileViewer';
+export { default as TaskNodeViewer } from './core/viewers/TaskNodeViewer';
+export { default as ModuleViewer } from './core/viewers/ModuleViewer';
+export { default as TextViewerWithSwitcher } from './core/viewers/TextViewerWithSwitcher';
+export { default as UpstreamViewer } from './core/viewers/UpstreamViewer';
+export { TableActionButtonViewer } from './core/viewers/TableActionButtonViewer';
+export type { HeaderConfig } from './core/util';
+export { toLeaf, getMaxRow, calCrossSpan, getIcon, getIconByFileStatus, } from './core/util';
+export type { LogLevel, PerformanceMonitorConfig, } from './core/PerformanceMonitor';
+export { PerformanceMonitor, getPerformanceMonitor, } from './core/PerformanceMonitor';
+export { CSS_PREFIX, HEADER_HEIGHT, ROW_INDEX_WIDTH, CHECK_BOX_WIDTH, CELL_HEIGHT, MIN_CELL_WIDTH, MIN_CELL_HEIGHT, SCROLLER_TRACK_SIZE, SCROLLER_SIZE, SCROLLER_COLOR, SCROLLER_FOCUS_COLOR, SELECT_BORDER_COLOR, SELECT_AREA_COLOR, SELECT_BG_COLOR, READONLY_COLOR, READONLY_TEXT_COLOR, ERROR_TIP_COLOR, EMPTY_VALUE, DATE_DISPLAY_TYPE, SIZE_MAP, VALIDATOR_TYPES, FILE_TYPE_FIELDS, FOOTER_HEIGHT, } from './core/constants';
+export { getFieldStatisticTypes } from './core/footer/utils';

package/dist/types/testing/SnapshotManager.d.ts

@@ -0,0 +1,55 @@
+import type DataGrid from '../core/DataGrid';
+import type { TableSnapshot, SnapshotCompareResult } from './TestHooks';
+/**
+ * Manages table state snapshots for regression testing.
+ * Snapshots capture the complete visual state of the table
+ * (visible cells, column configs, scroll position, dimensions)
+ * and can be compared against the current state to detect layout regressions.
+ */
+export declare class SnapshotManager {
+    private grid;
+    private snapshots;
+    constructor(grid: DataGrid);
+    /**
+     * Create a snapshot of the current table state.
+     * @param name - Unique snapshot identifier
+     * @returns The created TableSnapshot
+     */
+    createSnapshot(name: string): TableSnapshot;
+    /**
+     * Compare the current table state against a previously saved snapshot.
+     * @param name - Snapshot name to compare against
+     * @param tolerance - Pixel tolerance for coordinate comparisons (default: 1)
+     * @returns SnapshotCompareResult with list of differences
+     */
+    compareSnapshot(name: string, tolerance?: number): SnapshotCompareResult;
+    /**
+     * Get a previously saved snapshot by name.
+     * @param name - Snapshot identifier
+     * @returns Deep copy of the snapshot or null
+     */
+    getSnapshot(name: string): TableSnapshot | null;
+    /**
+     * Export a snapshot as a JSON string for saving to a file.
+     * @param name - Snapshot identifier
+     * @returns JSON string or null if not found
+     */
+    exportSnapshot(name: string): string | null;
+    /**
+     * Import a snapshot from a JSON string.
+     * @param json - JSON string representing a TableSnapshot
+     */
+    importSnapshot(json: string): void;
+    private captureVisibleCells;
+    private captureColumnConfigs;
+    private captureScrollPosition;
+    private captureDimensions;
+    private compareDimensions;
+    private compareScrollPosition;
+    private compareColumns;
+    private compareVisibleCells;
+    /**
+     * Check if two numeric values are within a given tolerance.
+     */
+    private isWithinTolerance;
+}

package/dist/types/testing/TestHooks.d.ts

@@ -0,0 +1,275 @@
+/**
+ * Layout information for a single cell
+ */
+export interface CellLayout {
+    /** Cell left-edge X coordinate (relative to canvas) */
+    x: number;
+    /** Cell top-edge Y coordinate (relative to canvas) */
+    y: number;
+    /** Cell width in pixels */
+    width: number;
+    /** Cell height in pixels */
+    height: number;
+    /** Whether the cell is within the visible viewport */
+    visible: boolean;
+    /** Column key */
+    columnKey: string;
+    /** Row ID (number for normal/viewer mode, string for grouped mode) */
+    rowId: string | number;
+    /** Column index */
+    colIndex: number;
+    /** Row index */
+    rowIndex: number;
+    /** Whether this is a fixed column ('left' | 'right' | '') */
+    fixed: string;
+}
+/**
+ * A visible cell in the viewport with its layout info
+ */
+export interface VisibleCell extends CellLayout {
+    /** Cell display value */
+    value: any;
+    /** Cell display label (for select-type columns, etc.) */
+    label: string;
+}
+/**
+ * Column configuration exposed to tests
+ */
+export interface TestColumnConfig {
+    /** Column unique key */
+    key: string;
+    /** Column display title */
+    title: string;
+    /** Column width in pixels */
+    width: number;
+    /** Whether this column is fixed ('left' | 'right' | '') */
+    fixed: string;
+    /** Whether this column is visible on screen */
+    visible: boolean;
+    /** Column index in the header */
+    index: number;
+    /** Column level (0 = top-level, 1 = nested child) */
+    level: number;
+    /** Column type */
+    type: string;
+    /** Nested child columns (if this is a parent column with nested sub-columns) */
+    children: TestColumnConfig[] | null;
+    /** Number of columns this header spans */
+    colspan: number;
+    /** Number of rows this header spans */
+    rowspan: number;
+    /** Parent column key (for nested child columns) */
+    parentKey: string | null;
+}
+/**
+ * Current scroll position of the table
+ */
+export interface ScrollPosition {
+    /** Horizontal scroll offset (negative value, 0 = no scroll) */
+    scrollX: number;
+    /** Vertical scroll offset (negative value, 0 = no scroll) */
+    scrollY: number;
+    /** Maximum horizontal scroll distance */
+    maxScrollX: number;
+    /** Maximum vertical scroll distance */
+    maxScrollY: number;
+    /** Whether a horizontal scrollbar is present */
+    hasHorizontalScrollbar: boolean;
+    /** Whether a vertical scrollbar is present */
+    hasVerticalScrollbar: boolean;
+}
+/**
+ * Overall table dimension information
+ */
+export interface TableDimensions {
+    /** Container (canvas) width in pixels */
+    containerWidth: number;
+    /** Container (canvas) height in pixels */
+    containerHeight: number;
+    /** Total table content width (sum of all column widths) */
+    tableWidth: number;
+    /** Total table content height (sum of all row heights) */
+    tableHeight: number;
+    /** Header area height in pixels */
+    headerHeight: number;
+    /** Default row height in pixels */
+    rowHeight: number;
+    /** Fixed left columns total width */
+    fixedLeftWidth: number;
+    /** Fixed right columns total width */
+    fixedRightWidth: number;
+    /** Total number of data rows */
+    totalRows: number;
+    /** Total number of leaf columns */
+    totalColumns: number;
+}
+/**
+ * A single difference found during snapshot comparison
+ */
+export interface SnapshotDifference {
+    /** Difference category */
+    type: 'cellLayout' | 'columnConfig' | 'scroll' | 'dimensions';
+    /** JSON path to the differing value (e.g. "cells[0].x") */
+    path: string;
+    /** Expected value from the saved snapshot */
+    expected: any;
+    /** Actual current value */
+    actual: any;
+}
+/**
+ * Result of comparing the current state against a saved snapshot
+ */
+export interface SnapshotCompareResult {
+    /** Whether the current state matches the snapshot (within tolerance) */
+    isEqual: boolean;
+    /** List of differences found */
+    differences: SnapshotDifference[];
+}
+/**
+ * A complete table state snapshot
+ */
+export interface TableSnapshot {
+    /** Snapshot identifier */
+    name: string;
+    /** Timestamp when the snapshot was created */
+    timestamp: number;
+    /** All visible cells at the time of snapshot */
+    visibleCells: VisibleCell[];
+    /** All column configurations */
+    columns: TestColumnConfig[];
+    /** Scroll position */
+    scrollPosition: ScrollPosition;
+    /** Table dimensions */
+    dimensions: TableDimensions;
+}
+/**
+ * Per-column header vs body width comparison result
+ */
+export interface HeaderBodyWidthComparison {
+    colIndex: number;
+    columnKey: string;
+    headerWidth: number;
+    bodyCellWidth: number;
+    isNested: boolean;
+    match: boolean;
+}
+/**
+ * Main Test Hooks API exposed on window.__CANVAS_TABLE_TEST_HOOKS__
+ *
+ * All methods return deep copies of internal state to prevent
+ * accidental mutation from test code.
+ */
+export interface TestHooksAPI {
+    /**
+     * Get layout information for a specific cell.
+     * @param rowId - Row identifier (number for normal/viewer, string for grouped)
+     * @param columnKey - Column key string
+     * @returns CellLayout or null if the cell does not exist
+     */
+    getCellLayout: (rowId: string | number, columnKey: string) => CellLayout | null;
+    /**
+     * Get all cells currently visible in the viewport.
+     * Only returns cells that are rendered by the virtual scroll engine.
+     * @returns Array of VisibleCell objects
+     */
+    getAllVisibleCells: () => VisibleCell[];
+    /**
+     * Get configuration for a specific column.
+     * Supports both top-level and nested child columns.
+     * @param columnKey - Column key string
+     * @returns TestColumnConfig or null if column not found
+     */
+    getColumnConfig: (columnKey: string) => TestColumnConfig | null;
+    /**
+     * Get data for a specific row.
+     * @param rowId - Row identifier
+     * @returns Row data object or null if not found
+     */
+    getRowData: (rowId: string | number) => Record<string, any> | null;
+    /**
+     * Get the current scroll position.
+     * @returns ScrollPosition object
+     */
+    getScrollPosition: () => ScrollPosition;
+    /**
+     * Get overall table dimensions.
+     * @returns TableDimensions object
+     */
+    getTableDimensions: () => TableDimensions;
+    /**
+     * Create a snapshot of the current table state.
+     * @param name - Snapshot identifier
+     * @returns The created TableSnapshot
+     */
+    createSnapshot: (name: string) => TableSnapshot;
+    /**
+     * Compare the current table state against a previously saved snapshot.
+     * @param name - Name of the snapshot to compare against
+     * @param tolerance - Pixel tolerance for coordinate comparisons (default: 1)
+     * @returns SnapshotCompareResult with differences
+     */
+    compareSnapshot: (name: string, tolerance?: number) => SnapshotCompareResult;
+    /**
+     * Get a previously saved snapshot by name.
+     * @param name - Snapshot identifier
+     * @returns TableSnapshot or null if not found
+     */
+    getSnapshot: (name: string) => TableSnapshot | null;
+    /**
+     * Export a snapshot as a JSON string (for saving to file).
+     * @param name - Snapshot identifier
+     * @returns JSON string or null if snapshot not found
+     */
+    exportSnapshot: (name: string) => string | null;
+    /**
+     * Import a snapshot from a JSON string.
+     * @param json - JSON string of a TableSnapshot
+     */
+    importSnapshot: (json: string) => void;
+    /**
+     * Compare header column widths with body cell widths.
+     * Detects header/body width mismatches, especially for nested columns.
+     * @returns Per-column comparison results
+     */
+    getHeaderBodyWidthComparison: () => HeaderBodyWidthComparison[];
+    /**
+     * Get current selection range. (Phase 2)
+     */
+    getSelectionRange?: () => {
+        startRow: number;
+        startCol: number;
+        endRow: number;
+        endCol: number;
+    } | null;
+    /**
+     * Get edit state for a specific cell. (Phase 2)
+     */
+    getCellEditState?: (rowId: string | number, columnKey: string) => {
+        isEditing: boolean;
+        value: any;
+    } | null;
+    /**
+     * Get current drag operation state. (Phase 2)
+     */
+    getDragState?: () => {
+        isDragging: boolean;
+        type: 'row' | 'column' | 'selection' | null;
+        sourceIds: string[];
+        targetId: string | null;
+    } | null;
+    /**
+     * Get cells that are currently in loading state. (Phase 2)
+     */
+    getLoadingCells?: () => Array<{
+        rowId: string | number;
+        columnKey: string;
+    }>;
+}
+/**
+ * Global window augmentation for test hooks
+ */
+declare global {
+    interface Window {
+        __CANVAS_TABLE_TEST_HOOKS__?: TestHooksAPI;
+    }
+}

package/dist/types/testing/index.d.ts

@@ -0,0 +1,3 @@
+export type { CellLayout, VisibleCell, TestColumnConfig, ScrollPosition, TableDimensions, SnapshotDifference, SnapshotCompareResult, TableSnapshot, TestHooksAPI, } from './TestHooks';
+export { installTestHooks, removeTestHooks } from './installTestHooks';
+export { SnapshotManager } from './SnapshotManager';

package/dist/types/testing/installTestHooks.d.ts

@@ -0,0 +1,16 @@
+import type DataGrid from '../core/DataGrid';
+/**
+ * Install test hooks on window.__CANVAS_TABLE_TEST_HOOKS__
+ * This should be called after DataGrid is fully initialized.
+ *
+ * In production builds, this function is a no-op and can be
+ * tree-shaken by the bundler.
+ *
+ * @param grid - The DataGrid instance to expose hooks for
+ */
+export declare function installTestHooks(grid: DataGrid): void;
+/**
+ * Remove test hooks from the global window object.
+ * Called when the DataGrid is destroyed.
+ */
+export declare function removeTestHooks(): void;

package/package.json

@@ -0,0 +1,126 @@
+{
+  "name": "arthub-table",
+  "version": "0.0.3",
+  "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.js",
+  "types": "dist/types/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "homepage": "https://",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "keywords": [
+    "canvas",
+    "table",
+    "grid",
+    "spreadtable",
+    "vue",
+    "vue3",
+    "typescript",
+    "virtual-scroll",
+    "data-grid",
+    "cell-viewer"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": [
+    "*.css",
+    "*.scss",
+    "*.less",
+    "*.vue"
+  ],
+  "scripts": {
+    "serve": "vue-cli-service serve",
+    "build": "npm run build:lib && npm run build:types",
+    "build:lib": "vue-cli-service build --target lib --name arthub-table --dest dist src/index.ts",
+    "build:demo": "vue-cli-service build",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:analyze": "cross-env ANALYZE=true npm run build:lib",
+    "test:unit": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:changed": "jest --onlyChanged",
+    "test:e2e": "playwright test",
+    "test:e2e:chromium": "playwright test --project=chromium",
+    "test:e2e:headed": "playwright test --headed",
+    "test:e2e:report": "playwright show-report test-results/html-report",
+    "setup-husky": "node scripts/setup-husky.js",
+    "lint": "vue-cli-service lint",
+    "predeploy": "npm run build:demo",
+    "deploy": "gh-pages -d dist",
+    "prepare": "husky",
+    "prepublishOnly": "npm run lint && npm run build",
+    "version": "git add package.json",
+    "release": "bash build/release.sh"
+  },
+  "peerDependencies": {
+    "vue": "^3.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "core-js": "^3.35.0",
+    "element-plus": "^2.4.4",
+    "gifuct-js": "^2.1.2",
+    "loadsh": "^0.0.4"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "@vitejs/plugin-vue": "^5.0.0",
+    "@vue/cli-plugin-babel": "~5.0.8",
+    "@vue/cli-plugin-eslint": "~5.0.8",
+    "@vue/cli-plugin-typescript": "~5.0.8",
+    "@vue/cli-plugin-unit-jest": "^5.0.9",
+    "@vue/cli-service": "~5.0.8",
+    "@vue/eslint-config-prettier": "^9.0.0",
+    "@vue/eslint-config-typescript": "^12.0.0",
+    "@vue/test-utils": "^2.4.3",
+    "chai": "^4.3.10",
+    "cross-env": "^7.0.3",
+    "eslint": "^8.56.0",
+    "eslint-plugin-prettier": "^5.0.1",
+    "eslint-plugin-vue": "^9.19.2",
+    "gh-pages": "^6.1.0",
+    "husky": "^9.1.7",
+    "jest": "^27.5.1",
+    "jest-environment-jsdom": "^27.5.1",
+    "lint-staged": "^15.2.0",
+    "prettier": "^3.1.1",
+    "sass": "^1.69.5",
+    "sass-loader": "^13.3.3",
+    "ts-jest": "^27.1.5",
+    "typescript": "~5.3.3",
+    "unplugin-auto-import": "^0.17.2",
+    "unplugin-vue-components": "^0.26.0",
+    "vue": "^3.3.13",
+    "webpack-bundle-analyzer": "^4.10.2"
+  },
+  "gitHooks": {
+    "pre-commit": "lint-staged"
+  },
+  "lint-staged": {
+    "*.{js,jsx,vue,ts,tsx}": [
+      "npm run test:unit -- --findRelatedTests",
+      "vue-cli-service lint --fix"
+    ]
+  }
+}