@sl-material/sl-table-sheet 1.0.0-beta0

package/core/Dialog-column.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 查找替换弹窗 - 纯 TypeScript/JavaScript 实现
+ * 不依赖任何框架，可在任何项目中使用
+ */
+export interface MatchPosition {
+    row: number;
+    col: number;
+    value: string;
+}
+export interface FindReplaceOptions {
+    container?: HTMLElement | string;
+    tableInstance?: any;
+    onSearch?: (matches: MatchPosition[]) => void;
+    onReplace?: (match: MatchPosition, newValue: string) => void;
+    selectedColumnsOnly?: boolean;
+}
+export declare class FindReplaceDialog {
+    private dialog;
+    private tableInstance;
+    private elements;
+    private state;
+    private options;
+    constructor(options?: FindReplaceOptions);
+    /**
+     * 初始化弹窗
+     */
+    private init;
+    /**
+     * 创建弹窗 DOM
+     */
+    private createDialog;
+    /**
+     * 绑定事件
+     */
+    private bindEvents;
+    /**
+     * 绑定拖拽事件
+     */
+    private bindDragEvents;
+    /**
+     * 注入样式
+     */
+    private injectStyles;
+    /**
+     * 解析容器
+     */
+    private resolveContainer;
+    /**
+     * 打开弹窗
+     */
+    open(): void;
+    /**
+     * 关闭弹窗
+     */
+    close(): void;
+    /**
+     * 重置状态
+     */
+    private resetState;
+    /**
+     * 清除结果显示
+     */
+    private clearResults;
+    /**
+     * 执行查找
+     */
+    private performSearch;
+    /**
+     * 高亮匹配项
+     */
+    private highlightMatch;
+    /**
+     * 查找下一个
+     */
+    findNext(): void;
+    /**
+     * 查找上一个
+     */
+    findPrevious(): void;
+    /**
+     * 替换一个
+     */
+    replaceOne(): void;
+    /**
+     * 全部替换
+     */
+    replaceAll(): void;
+    /**
+     * 显示消息
+     */
+    private showMessage;
+    /**
+     * 设置表格实例（用于表格重建后更新引用）
+     */
+    setTableInstance(tableInstance: any): void;
+    /**
+     * 设置是否只搜索选中列
+     */
+    setSelectedColumnsOnly(selectedOnly: boolean): void;
+    /**
+     * 获取是否只搜索选中列
+     */
+    getSelectedColumnsOnly(): boolean;
+    /**
+     * 设置查找文本
+     */
+    setFindText(text: string): void;
+    /**
+     * 设置替换文本
+     */
+    setReplaceText(text: string): void;
+    /**
+     * 销毁弹窗
+     */
+    destroy(): void;
+}
+export default FindReplaceDialog;

package/core/Dialog.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 查找替换弹窗 - 纯 TypeScript/JavaScript 实现
+ * 不依赖任何框架，可在任何项目中使用
+ */
+export interface MatchPosition {
+    row: number;
+    col: number;
+    value: string;
+}
+export interface FindReplaceOptions {
+    container?: HTMLElement | string;
+    tableInstance?: any;
+    onSearch?: (matches: MatchPosition[]) => void;
+    onReplace?: (match: MatchPosition, newValue: string) => void;
+    selectedColumnsOnly?: boolean;
+}
+export declare class FindReplaceDialog {
+    private dialog;
+    private tableInstance;
+    private elements;
+    private state;
+    private options;
+    constructor(options?: FindReplaceOptions);
+    /**
+     * 初始化弹窗
+     */
+    private init;
+    /**
+     * 创建弹窗 DOM
+     */
+    private createDialog;
+    /**
+     * 绑定事件
+     */
+    private bindEvents;
+    /**
+     * 绑定拖拽事件
+     */
+    private bindDragEvents;
+    /**
+     * 注入样式
+     */
+    private injectStyles;
+    /**
+     * 解析容器
+     */
+    private resolveContainer;
+    /**
+     * 打开弹窗
+     */
+    open(): void;
+    /**
+     * 关闭弹窗
+     */
+    close(): void;
+    /**
+     * 重置状态
+     */
+    private resetState;
+    /**
+     * 清除结果显示
+     */
+    private clearResults;
+    /**
+     * 执行查找
+     */
+    private performSearch;
+    /**
+     * 高亮匹配项
+     */
+    private highlightMatch;
+    /**
+     * 查找下一个
+     */
+    findNext(): void;
+    /**
+     * 查找上一个
+     */
+    findPrevious(): void;
+    /**
+     * 替换一个
+     */
+    replaceOne(): void;
+    /**
+     * 全部替换
+     */
+    replaceAll(): void;
+    /**
+     * 显示消息
+     */
+    private showMessage;
+    /**
+     * 设置表格实例（用于表格重建后更新引用）
+     */
+    setTableInstance(tableInstance: any): void;
+    /**
+     * 设置是否只搜索选中列
+     */
+    setSelectedColumnsOnly(selectedOnly: boolean): void;
+    /**
+     * 获取是否只搜索选中列
+     */
+    getSelectedColumnsOnly(): boolean;
+    /**
+     * 设置查找文本
+     */
+    setFindText(text: string): void;
+    /**
+     * 设置替换文本
+     */
+    setReplaceText(text: string): void;
+    /**
+     * 销毁弹窗
+     */
+    destroy(): void;
+}
+export default FindReplaceDialog;

package/core/ExcelUtils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * ExcelUtils - Excel 导入导出工具类（兼容层）
+ * 此文件保留用于向后兼容，新代码请使用 ./excel 模块
+ * @deprecated 请使用 ./excel 模块中的功能
+ */
+export * from './excel';

package/core/SlTableSheet.d.ts

@@ -0,0 +1,166 @@
+import { TableSheet, TableSheetConfig } from './TableSheet';
+import { FindReplaceDialog } from './Dialog';
+import { Toolbar, ToolbarConfig } from './Toolbar';
+import { ExcelParseOptions, ExcelParseResult } from './excel';
+
+export interface SlTableSheetConfig extends Omit<TableSheetConfig, "container"> {
+    container: HTMLElement | string;
+    showToolbar?: boolean;
+    toolbar?: Partial<ToolbarConfig>;
+    onExport?: (format: "csv" | "excel") => void;
+    onRefresh?: () => void;
+    onExcelImport?: (data: ExcelParseResult) => void;
+}
+export declare class SlTableSheet {
+    private tableSheet;
+    private findReplaceDialog;
+    private toolbar;
+    private container;
+    private tableContainer;
+    private toolbarContainer;
+    private config;
+    /** Excel 单元格样式映射 */
+    private excelCellStyles;
+    constructor(config: SlTableSheetConfig);
+    /**
+     * 初始化
+     */
+    private init;
+    /**
+     * 获取容器
+     */
+    private getContainer;
+    /**
+     * 创建布局
+     */
+    private createLayout;
+    /**
+     * 创建工具栏
+     */
+    private createToolbar;
+    /**
+     * 创建表格
+     */
+    private createTable;
+    /**
+     * 创建查找替换弹窗
+     */
+    private createFindReplaceDialog;
+    /**
+     * 打开查找替换弹窗
+     */
+    openFindReplace(): void;
+    /**
+     * 冻结列
+     */
+    private freezeColumns;
+    /**
+     * 注入样式
+     */
+    private injectStyles;
+    /**
+     * 更新标题统计
+     */
+    updateTitleStats(count: number, total: number): void;
+    /**
+     * 获取 TableSheet 实例
+     */
+    getTableSheet(): TableSheet | null;
+    /**
+     * 获取表格实例
+     */
+    getTableInstance(): any;
+    /**
+     * 获取查找替换弹窗实例
+     */
+    getFindReplaceDialog(): FindReplaceDialog | null;
+    /**
+     * 设置查找替换是否只搜索选中列
+     */
+    setFindReplaceSelectedColumnsOnly(selectedOnly: boolean): void;
+    /**
+     * 更新数据
+     */
+    updateData(records: any[]): void;
+    /**
+     * 更新列配置
+     */
+    updateColumns(columns: any[]): void;
+    /**
+     * 导出数据
+     */
+    exportData(format?: "csv" | "excel"): any;
+    /**
+     * 导出数据为 Excel 流 (ArrayBuffer)
+     * @param options 导出选项
+     * @returns Excel 文件的 ArrayBuffer
+     */
+    exportToExcelStream(options?: {
+        filterEmptyColumns?: boolean;
+    }): ArrayBuffer;
+    /**
+     * 下载 Excel 文件
+     * @param filename 文件名（不含扩展名）
+     */
+    downloadExcel(filename?: string): void;
+    /**
+     * 解析在线 Excel 文件并显示到表格
+     * @param url Excel 文件的 URL 地址
+     * @param options 解析选项
+     * @returns 解析后的列配置和数据
+     */
+    loadExcelFromUrl(url: string, options?: ExcelParseOptions & {
+        autoDisplay?: boolean;
+    }): Promise<ExcelParseResult>;
+    /**
+     * 解析 Excel ArrayBuffer 并显示到表格
+     * @param buffer Excel 文件的 ArrayBuffer
+     * @param options 解析选项
+     * @returns 解析后的列配置和数据
+     */
+    parseExcelBuffer(buffer: ArrayBuffer, options?: ExcelParseOptions & {
+        autoDisplay?: boolean;
+    }): ExcelParseResult;
+    /**
+     * 从 File 对象解析 Excel 文件
+     * @param file File 对象
+     * @param options 解析选项
+     * @returns 解析后的列配置和数据
+     */
+    parseExcelFile(file: File, options?: ExcelParseOptions & {
+        autoDisplay?: boolean;
+    }): Promise<ExcelParseResult>;
+    /**
+     * 处理 Excel 导入结果
+     */
+    private handleExcelImportResult;
+    /**
+     * 重新创建表格实例
+     */
+    private recreateTable;
+    /**
+     * 更新查找替换弹窗的表格实例引用
+     */
+    private updateFindReplaceTableInstance;
+    /**
+     * 刷新表格
+     */
+    refresh(): void;
+    /**
+     * 监听事件
+     */
+    on(eventName: string, callback: Function): void;
+    /**
+     * 取消监听事件
+     */
+    off(eventName: string, callback?: Function): void;
+    /**
+     * 获取工具栏实例
+     */
+    getToolbar(): Toolbar | null;
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+}
+export default SlTableSheet;

package/core/TableSheet.d.ts

@@ -0,0 +1,188 @@
+/**
+ * 自定义组件配置接口
+ */
+export interface CustomComponentConfig {
+    /** 组件渲染函数，返回 DOM 元素 */
+    render: (args: CustomComponentRenderArgs) => HTMLElement;
+    /** 组件挂载后的回调 */
+    onMount?: (container: HTMLElement, args: CustomComponentRenderArgs) => void;
+    /** 组件卸载前的回调 */
+    onUnmount?: (container: HTMLElement) => void;
+    /** 是否在点击单元格时显示组件 */
+    showOnClick?: boolean;
+    /** 组件容器样式 */
+    containerStyle?: Partial<CSSStyleDeclaration>;
+}
+/**
+ * 自定义组件渲染参数
+ */
+export interface CustomComponentRenderArgs {
+    /** 表格实例 */
+    table: any;
+    /** 行索引 */
+    row: number;
+    /** 列索引 */
+    col: number;
+    /** 单元格值 */
+    value: any;
+    /** 原始数据 */
+    dataValue: any;
+    /** 单元格矩形区域 */
+    rect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    /** 更新单元格值的回调 */
+    setValue: (newValue: any) => void;
+    /** 关闭组件的回调 */
+    close: () => void;
+}
+/**
+ * TableSheet 配置接口
+ */
+export interface TableSheetConfig {
+    /** 容器元素或选择器 */
+    container: HTMLElement | string;
+    /** 列配置，支持在列中定义 customRender 实现自定义单元格渲染 */
+    columns?: any[];
+    /** 数据记录 */
+    records?: any[];
+    /** 是否显示公式栏 */
+    showFormulaBar?: boolean;
+    /** 是否显示工作表标签 */
+    showSheetTab?: boolean;
+    /** 工作表配置 */
+    sheets?: any[];
+    /** 编辑器配置 */
+    editors?: {
+        dateEditor?: any;
+        listEditor?: any;
+        customEditors?: Record<string, any>;
+    };
+    /**
+     * 自定义渲染器配置（保留用于扩展）
+     * 注意：VTable 的 customRender 应该在 columns 的每一列中配置
+     * 示例：columns: [{ field: 'name', customRender: (args) => ({ elements: [...] }) }]
+     */
+    customRenderers?: Record<string, any>;
+    /**
+     * 自定义交互组件配置
+     * 用于在单元格中渲染复杂的DOM组件（如弹出层、下拉选择等）
+     * 示例：customComponents: { 'store-selector': { render: (args) => createStoreSelector(args) } }
+     */
+    customComponents?: Record<string, CustomComponentConfig>;
+    /** 其他 VTable 选项 */
+    options?: any;
+    /** 表格就绪回调 */
+    onReady?: (instance: any) => void;
+    /** 单元格点击回调 */
+    onCellClick?: (args: any) => void;
+    /** 单元格值变化回调 */
+    onCellChange?: (args: any) => void;
+}
+export declare class TableSheet {
+    private sheetInstance;
+    private tableInstance;
+    private container;
+    private config;
+    private customComponentManager;
+    private cellMarkManager;
+    private eventManager;
+    constructor(config: TableSheetConfig, markedMap?: Map<string, {
+        isMarked: boolean;
+        comment?: string;
+    }>);
+    /**
+     * 初始化表格
+     */
+    private init;
+    /**
+     * 获取容器元素
+     */
+    private getContainer;
+    /**
+     * 创建表格实例
+     */
+    private createSheet;
+    /**
+     * 修改单元格值
+     */
+    changeCellValue(col: number, row: number, value: any): void;
+    /**
+     * 获取单元格值
+     */
+    getCellValue(col: number, row: number): any;
+    /**
+     * 获取选中的单元格
+     */
+    getSelectedCells(): any;
+    /**
+     * 更新数据
+     */
+    updateData(records: any[]): void;
+    /**
+     * 更新列配置
+     */
+    updateColumns(columns: any[]): void;
+    /**
+     * 添加行
+     */
+    addRow(record: any, index?: number): void;
+    /**
+     * 删除行
+     */
+    deleteRow(index: number): void;
+    /**
+     * 导出数据
+     */
+    exportData(format?: "csv" | "excel"): any;
+    /**
+     * 切换工作表
+     */
+    switchSheet(sheetKey: string): void;
+    /**
+     * 获取当前工作表
+     */
+    getActiveSheet(): any;
+    /**
+     * 获取所有工作表
+     */
+    getAllSheets(): any;
+    /**
+     * 刷新表格
+     */
+    refresh(): void;
+    /**
+     * 获取原始实例
+     */
+    getSheetInstance(): any;
+    getTableInstance(): any;
+    /**
+     * 为指定列设置自定义渲染函数
+     * @param field 列字段名
+     * @param customRender 自定义渲染函数
+     */
+    setColumnCustomRender(field: string, customRender: Function): void;
+    /**
+     * 获取标记映射
+     */
+    getMarkedMap(): Map<string, {
+        isMarked: boolean;
+        comment?: string;
+    }> | null;
+    /**
+     * 监听事件
+     */
+    on(eventName: string, callback: Function): void;
+    /**
+     * 取消监听事件
+     */
+    off(eventName: string, callback?: Function): void;
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+}
+export default TableSheet;

package/core/Toolbar.d.ts

@@ -0,0 +1,110 @@
+
+export interface ToolbarConfig {
+    container?: HTMLElement | string;
+    title?: string;
+    count?: number;
+    total?: number;
+    hint?: string;
+    freezeCount?: number;
+    showErrorList?: boolean;
+    /** 左侧自定义内容，可以是 HTMLElement 或返回 HTMLElement 的函数 */
+    leftSlot?: HTMLElement | (() => HTMLElement) | null;
+    buttons?: {
+        search?: boolean;
+        freeze?: boolean;
+        export?: boolean;
+        refresh?: boolean;
+        list?: boolean;
+    };
+    onSearchClick?: () => void;
+    onFreezeChange?: (count: number) => void;
+    onListChange?: (checked: boolean) => void;
+}
+export declare class Toolbar {
+    private container;
+    private toolbarElement;
+    private config;
+    private elements;
+    constructor(config: ToolbarConfig);
+    /**
+     * 初始化
+     */
+    private init;
+    /**
+     * 获取容器
+     */
+    private getContainer;
+    /**
+     * 创建工具栏
+     */
+    private createToolbar;
+    /**
+     * 创建左侧区域（空容器，内容由调用者通过 leftSlot 插入）
+     */
+    private createLeftSection;
+    /**
+     * 创建右侧区域
+     */
+    private createRightSection;
+    /**
+     * 创建按钮
+     */
+    private createButton;
+    /**
+     * 创建冻结列选择器（标题 + 数字输入框 + 上下箭头）
+     */
+    private createFreezeButton;
+    /**
+     * 格式化数字（添加千分位）
+     */
+    private formatNumber;
+    /**
+     * 注入样式
+     */
+    private injectStyles;
+    /**
+     * 更新标题
+     */
+    updateTitle(title: string): void;
+    /**
+     * 更新统计数据
+     */
+    updateStats(count: number, total: number): void;
+    /**
+     * 更新提示信息
+     */
+    updateHint(hint: string): void;
+    /**
+     * 更新冻结列数
+     */
+    updateFreezeCount(count: number): void;
+    /**
+     * 更新显示错误列状态
+     */
+    updateShowErrorList(checked: boolean): void;
+    /**
+     * 显示工具栏
+     */
+    show(): void;
+    /**
+     * 隐藏工具栏
+     */
+    hide(): void;
+    /**
+     * 获取工具栏元素
+     */
+    getElement(): HTMLElement | null;
+    /**
+     * 更新左侧插槽内容
+     */
+    setLeftSlot(content: HTMLElement | (() => HTMLElement) | null): void;
+    /**
+     * 获取左侧区域元素
+     */
+    getLeftSection(): HTMLElement | null;
+    /**
+     * 销毁工具栏
+     */
+    destroy(): void;
+}
+export default Toolbar;

package/core/comnon.d.ts

@@ -0,0 +1,6 @@
+
+export declare const getHighlightStyle: (_styleArg: any, _col: any) => {
+    bgColor: string;
+    color: string;
+    marked: any;
+};