@sl-material/sl-table-sheet 1.0.0-beta2 → 1.0.0-beta4

package/config/config.d.ts

@@ -0,0 +1,10 @@
+export declare const defaultHeaderStyle: {
+    color: string;
+    fontSize: number;
+    fontWeight: string;
+    background: string;
+};
+export declare const defaultCellStyle: {
+    color: string;
+    fontSize: number;
+};

package/core/SheetTabs.d.ts

@@ -0,0 +1,44 @@
+import { SheetData } from './excel/types';
+
+export interface SheetTabsConfig {
+    container: HTMLElement;
+    sheets: SheetData[];
+    activeIndex?: number;
+    onTabChange?: (sheetData: SheetData, index: number) => void;
+}
+export declare class SheetTabs {
+    private container;
+    private tabsElement;
+    private sheets;
+    private activeIndex;
+    private onTabChange?;
+    constructor(config: SheetTabsConfig);
+    private init;
+    private injectStyles;
+    private render;
+    private createTab;
+    /**
+     * 设置当前激活的标签
+     */
+    setActiveTab(index: number): void;
+    /**
+     * 更新 Sheet 数据
+     */
+    updateSheets(sheets: SheetData[]): void;
+    /**
+     * 更新单个 Sheet 的错误数量
+     */
+    updateSheetError(index: number, errorCount: number): void;
+    /**
+     * 获取当前激活的 Sheet 数据
+     */
+    getActiveSheet(): SheetData | null;
+    /**
+     * 获取当前激活的索引
+     */
+    getActiveIndex(): number;
+    /**
+     * 销毁组件
+     */
+    destroy(): void;
+}

package/core/SlTableSheet.d.ts

@@ -1,26 +1,36 @@
 import { TableSheet, TableSheetConfig } from './TableSheet';
 import { FindReplaceDialog } from './Dialog';
 import { Toolbar, ToolbarConfig } from './Toolbar';
-import { ExcelParseOptions, ExcelParseResult } from './excel';
+import { SheetTabs } from './SheetTabs';
+import { ExcelParseOptions, ExcelParseResult, MultiSheetParseResult, SheetData } from './excel';
 
 export interface SlTableSheetConfig extends Omit<TableSheetConfig, "container"> {
     container: HTMLElement | string;
     showToolbar?: boolean;
+    /** 是否显示自定义 Sheet 标签页（用于多 Sheet Excel） */
+    showSheetTabs?: boolean;
     toolbar?: Partial<ToolbarConfig>;
     onExport?: (format: "csv" | "excel") => void;
     onRefresh?: () => void;
     onExcelImport?: (data: ExcelParseResult) => void;
+    /** 多 Sheet 导入回调 */
+    onMultiSheetImport?: (data: MultiSheetParseResult) => void;
+    /** Sheet 切换回调 */
+    onSheetChange?: (sheetData: SheetData, index: number) => void;
 }
 export declare class SlTableSheet {
     private tableSheet;
     private findReplaceDialog;
     private toolbar;
+    private sheetTabs;
     private container;
     private tableContainer;
     private toolbarContainer;
+    private sheetTabsContainer;
+    private loadingOverlay;
     private config;
-    /** Excel 单元格样式映射 */
-    private excelCellStyles;
+    /** 多 Sheet 数据 */
+    private multiSheetData;
     constructor(config: SlTableSheetConfig);
     /**
      * 初始化
@@ -103,6 +113,14 @@ export declare class SlTableSheet {
      * @param filename 文件名（不含扩展名）
      */
     downloadExcel(filename?: string): void;
+    /**
+     * 显示 loading 状态
+     */
+    showLoading(text?: string): void;
+    /**
+     * 隐藏 loading 状态
+     */
+    hideLoading(): void;
     /**
      * 解析在线 Excel 文件并显示到表格
      * @param url Excel 文件的 URL 地址
@@ -130,6 +148,14 @@ export declare class SlTableSheet {
     parseExcelFile(file: File, options?: ExcelParseOptions & {
         autoDisplay?: boolean;
     }): Promise<ExcelParseResult>;
+    /**
+     * 将批注数据合并到记录中，生成带 isMarked 标记的数据格式
+     */
+    private mergeCommentsToRecords;
+    /**
+     * 处理数据并生成样式化的列配置
+     */
+    private processDataWithStyles;
     /**
      * 处理 Excel 导入结果
      */
@@ -162,5 +188,49 @@ export declare class SlTableSheet {
      * 销毁实例
      */
     destroy(): void;
+    /**
+     * 从 URL 加载 Excel 所有 Sheet
+     */
+    loadAllSheetsFromUrl(url: string, options?: Omit<ExcelParseOptions, "sheetIndex">): Promise<MultiSheetParseResult>;
+    /**
+     * 解析 Excel ArrayBuffer 的所有 Sheet
+     */
+    parseAllSheets(buffer: ArrayBuffer, options?: Omit<ExcelParseOptions, "sheetIndex">): MultiSheetParseResult;
+    /**
+     * 处理多 Sheet 导入结果
+     */
+    private handleMultiSheetImportResult;
+    /**
+     * 创建 Sheet 标签页
+     */
+    private createSheetTabs;
+    /**
+     * 显示指定 Sheet 的数据
+     */
+    private displaySheetData;
+    /**
+     * 更新 Sheet 的错误数量
+     */
+    updateSheetError(sheetIndex: number, errorCount: number): void;
+    /**
+     * 获取当前激活的 Sheet 索引
+     */
+    getActiveSheetIndex(): number;
+    /**
+     * 获取当前激活的 Sheet 数据
+     */
+    getActiveSheetData(): SheetData | null;
+    /**
+     * 获取所有 Sheet 数据
+     */
+    getAllSheetsData(): MultiSheetParseResult | null;
+    /**
+     * 切换到指定 Sheet
+     */
+    switchToSheet(index: number): void;
+    /**
+     * 获取 SheetTabs 实例
+     */
+    getSheetTabs(): SheetTabs | null;
 }
 export default SlTableSheet;

package/core/TableSheet.d.ts

@@ -1,3 +1,5 @@
+import { MarkedMap } from './processors/StyleProcessor';
+
 /**
  * 自定义组件配置接口
  */
@@ -90,10 +92,7 @@ export declare class TableSheet {
     private customComponentManager;
     private cellMarkManager;
     private eventManager;
-    constructor(config: TableSheetConfig, markedMap?: Map<string, {
-        isMarked: boolean;
-        comment?: string;
-    }>);
+    constructor(config: TableSheetConfig, markedMap?: MarkedMap);
     /**
      * 初始化表格
      */
@@ -106,6 +105,10 @@ export declare class TableSheet {
      * 创建表格实例
      */
     private createSheet;
+    /**
+     * 初始化 Manager
+     */
+    private initManagers;
     /**
      * 修改单元格值
      */
@@ -168,10 +171,15 @@ export declare class TableSheet {
     /**
      * 获取标记映射
      */
-    getMarkedMap(): Map<string, {
-        isMarked: boolean;
-        comment?: string;
-    }> | null;
+    getMarkedMap(): MarkedMap | null;
+    /**
+     * 获取当前表格的所有数据（包括编辑后的最新值）
+     */
+    getAllRecords(): any[][];
+    /**
+     * 获取列配置
+     */
+    getColumns(): any[];
     /**
      * 监听事件
      */

package/core/excel/ExcelParser.d.ts

@@ -1,4 +1,4 @@
-import { ExcelParseOptions, ExcelParseResult } from './types';
+import { ExcelParseOptions, ExcelParseResult, MultiSheetParseResult } from './types';
 
 export declare class ExcelParser {
     /**
@@ -9,4 +9,12 @@ export declare class ExcelParser {
      * 构建列配置
      */
     private static buildColumns;
+    /**
+     * 解析 Excel 所有 Sheet
+     */
+    static parseAllSheets(buffer: ArrayBuffer, options?: Omit<ExcelParseOptions, "sheetIndex">): MultiSheetParseResult;
+    /**
+     * 获取 Excel 文件的 Sheet 名称列表
+     */
+    static getSheetNames(buffer: ArrayBuffer): string[];
 }

package/core/excel/index.d.ts

@@ -1,4 +1,4 @@
-import { ExcelParseOptions, ExcelParseResult } from './types';
+import { ExcelParseOptions, ExcelParseResult, MultiSheetParseResult } from './types';
 /**
  * Excel 模块统一导出
  */
@@ -13,3 +13,15 @@ export declare function exportToExcelStream(columns: any[], records: any[], opti
     filterEmptyColumns?: boolean;
 }): ArrayBuffer;
 export declare function downloadExcel(buffer: ArrayBuffer, filename?: string): void;
+/**
+ * 解析 Excel 所有 Sheet
+ */
+export declare function parseAllSheets(buffer: ArrayBuffer, options?: Omit<ExcelParseOptions, "sheetIndex">): MultiSheetParseResult;
+/**
+ * 从 URL 加载并解析 Excel 所有 Sheet
+ */
+export declare function loadAllSheetsFromUrl(url: string, options?: Omit<ExcelParseOptions, "sheetIndex">): Promise<MultiSheetParseResult>;
+/**
+ * 获取 Excel 文件的 Sheet 名称列表
+ */
+export declare function getSheetNames(buffer: ArrayBuffer): string[];

package/core/excel/types.d.ts

@@ -27,7 +27,7 @@ export interface CellComment {
 export interface ExcelParseResult {
     columns: Array<{
         key: string;
-        field: string;
+        field: string | number;
         title: string;
         width: number;
         sort?: boolean;
@@ -37,3 +37,26 @@ export interface ExcelParseResult {
     cellStyles?: Map<string, CellStyle>;
     cellComments?: Map<string, CellComment>;
 }
+/**
+ * 单个 Sheet 的解析结果
+ */
+export interface SheetData {
+    sheetName: string;
+    sheetIndex: number;
+    columns: ExcelParseResult["columns"];
+    records: any[][];
+    cellStyles?: Map<string, CellStyle>;
+    cellComments?: Map<string, CellComment>;
+    /** 是否有错误数据 */
+    hasError?: boolean;
+    /** 错误数量 */
+    errorCount?: number;
+}
+/**
+ * 多 Sheet 解析结果
+ */
+export interface MultiSheetParseResult {
+    sheets: SheetData[];
+    sheetNames: string[];
+    activeSheetIndex: number;
+}

package/core/managers/CellMarkManager.d.ts

@@ -1,15 +1,13 @@
-/**
- * 标记单元格管理器
- */
+import { MarkedMap } from '../processors/StyleProcessor';
+
 export declare class CellMarkManager {
     private markedMap;
     private tableInstance;
-    constructor(tableInstance: any, markedMap?: Map<string, {
-        isMarked: boolean;
-        comment?: string;
-    }>);
+    private markedCellsSet;
+    private tooltipThrottle;
+    constructor(tableInstance: any, markedMap?: MarkedMap);
     /**
-     * 处理单元格鼠标进入事件
+     * 处理单元格鼠标进入事件（性能优化版）
      */
     handleCellMouseEnter(args: any): void;
     /**
@@ -19,15 +17,13 @@ export declare class CellMarkManager {
     /**
      * 获取标记映射
      */
-    getMarkedMap(): Map<string, {
-        isMarked: boolean;
-        comment?: string;
-    }> | null;
+    getMarkedMap(): MarkedMap | null;
     /**
      * 设置标记映射
      */
-    setMarkedMap(markedMap: Map<string, {
-        isMarked: boolean;
-        comment?: string;
-    }>): void;
+    setMarkedMap(markedMap: MarkedMap): void;
+    /**
+     * 销毁实例，清理引用
+     */
+    destroy(): void;
 }

package/core/managers/EventManager.d.ts

@@ -31,4 +31,8 @@ export declare class EventManager {
      * 取消监听事件
      */
     off(eventName: string, callback?: Function): void;
+    /**
+     * 销毁实例，解绑所有事件
+     */
+    destroy(): void;
 }

package/core/processors/DataProcessor.d.ts

@@ -1,16 +1,12 @@
-/**
- * 数据处理器 - 处理数据预处理逻辑
- */
+import { MarkedMap } from './StyleProcessor';
+
 export declare class DataProcessor {
     /**
      * 预处理数据：将 {value, isMarked} 格式转换为二维数组格式，并构建标记索引
      */
     static processRecords(records: any[], columns: any[]): {
         displayRecords: any[][];
-        markedMap: Map<string, {
-            isMarked: boolean;
-            comment?: string;
-        }>;
+        markedMap: MarkedMap;
     };
     /**
      * 处理数组格式的行

package/core/processors/StyleProcessor.d.ts

@@ -1,15 +1,14 @@
-import { CellStyle } from '../excel';
-
+/**
+ * 样式处理器 - 处理列样式配置
+ */
+export interface MarkedInfo {
+    isMarked: boolean;
+    comment?: string;
+}
+export type MarkedMap = Map<string, MarkedInfo>;
 export declare class StyleProcessor {
     /**
-     * 初始化列配置，根据 markedMap 添加高亮样式，并应用 Excel 单元格样式
-     */
-    static initColumns(columns: any[], markedMap: Map<string, {
-        isMarked: boolean;
-        comment?: string;
-    }>, cellStyles?: Map<string, CellStyle> | null): any[];
-    /**
-     * 应用 Excel 单元格样式
+     * 初始化列配置，根据 markedMap 添加高亮样式
      */
-    private static applyExcelStyle;
+    static initColumns(columns: any[], markedMap: MarkedMap, headerRowCount?: number): any[];
 }

package/index.d.ts

@@ -3,6 +3,8 @@
  * 支持多种技术栈：Vue 2/3、原生 JS、Web Component
  */
 export type { TableSheetConfig, SheetConfig, EditorConfig, CellInfo, } from './core/types';
-export { loadExcelFromUrl, parseExcelFile, parseExcelBuffer, fetchExcelFromUrl, } from './core/ExcelUtils';
-export type { ExcelParseOptions, ExcelParseResult, CellStyle, } from './core/ExcelUtils';
+export { loadExcelFromUrl, parseExcelFile, parseExcelBuffer, fetchExcelFromUrl, parseAllSheets, loadAllSheetsFromUrl, getSheetNames, } from './core/excel';
+export type { ExcelParseOptions, ExcelParseResult, CellStyle, SheetData, MultiSheetParseResult, } from './core/excel';
+export { SheetTabs } from './core/SheetTabs';
+export type { SheetTabsConfig } from './core/SheetTabs';
 export { SlTableSheet as default } from './core/SlTableSheet';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sl-material/sl-table-sheet",
-  "version": "1.0.0-beta2",
+  "version": "1.0.0-beta4",
   "description": "VTable 组件库 - 支持 npm 和 UMD",
   "main": "./sl-table-sheet.cjs.js",
   "module": "./sl-table-sheet.es.js",