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

package/core/excel/ExcelExporter.d.ts

@@ -0,0 +1,26 @@
+import { ExcelColumn } from './types';
+
+export declare class ExcelExporter {
+    /**
+     * 导出为 Excel 流
+     */
+    static exportToStream(columns: ExcelColumn[], records: any[], options?: {
+        filterEmptyColumns?: boolean;
+    }): ArrayBuffer;
+    /**
+     * 下载 Excel 文件
+     */
+    static download(buffer: ArrayBuffer, filename?: string): void;
+    /**
+     * 过滤空列
+     */
+    private static filterEmptyColumns;
+    /**
+     * 构建数据行
+     */
+    private static buildDataRows;
+    /**
+     * 提取单元格值
+     */
+    private static extractCellValue;
+}

package/core/excel/ExcelParser.d.ts

@@ -0,0 +1,12 @@
+import { ExcelParseOptions, ExcelParseResult } from './types';
+
+export declare class ExcelParser {
+    /**
+     * 解析 Excel ArrayBuffer
+     */
+    static parseBuffer(buffer: ArrayBuffer, options?: ExcelParseOptions): ExcelParseResult;
+    /**
+     * 构建列配置
+     */
+    private static buildColumns;
+}

package/core/excel/index.d.ts

@@ -0,0 +1,15 @@
+import { ExcelParseOptions, ExcelParseResult } from './types';
+/**
+ * Excel 模块统一导出
+ */
+export { ExcelParser } from './ExcelParser';
+export { ExcelExporter } from './ExcelExporter';
+export * from './types';
+export declare function fetchExcelFromUrl(url: string): Promise<ArrayBuffer>;
+export declare function parseExcelBuffer(buffer: ArrayBuffer, options?: ExcelParseOptions): ExcelParseResult;
+export declare function loadExcelFromUrl(url: string, options?: ExcelParseOptions): Promise<ExcelParseResult>;
+export declare function parseExcelFile(file: File, options?: ExcelParseOptions): Promise<ExcelParseResult>;
+export declare function exportToExcelStream(columns: any[], records: any[], options?: {
+    filterEmptyColumns?: boolean;
+}): ArrayBuffer;
+export declare function downloadExcel(buffer: ArrayBuffer, filename?: string): void;

package/core/excel/parsers/CommentExtractor.d.ts

@@ -0,0 +1,23 @@
+import { CellComment } from '../types';
+/**
+ * Excel 批注提取器
+ */
+import * as XLSX from "xlsx";
+export declare class CommentExtractor {
+    /**
+     * 提取批注数据
+     */
+    static extractComments(worksheet: XLSX.WorkSheet, dataStartRow: number): Map<string, CellComment> | undefined;
+    /**
+     * 收集所有批注
+     */
+    private static collectComments;
+    /**
+     * 从单元格中提取批注
+     */
+    private static extractCommentsFromCells;
+    /**
+     * 清理批注文本
+     */
+    private static cleanCommentText;
+}

package/core/excel/parsers/HeaderDetector.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Excel 表头智能检测器
+ */
+export interface HeaderDetectionResult {
+    headerRows: number;
+    dataStartRow: number;
+    effectiveHeaderRows: any[][];
+}
+/**
+ * 智能检测 Excel 表头结构
+ */
+export declare class HeaderDetector {
+    /**
+     * 检测表头行数
+     */
+    static detectHeaderRows(rawData: any[][], userHeaderRows?: number): HeaderDetectionResult;
+    /**
+     * 自动检测表头行数
+     */
+    private static autoDetectHeaderRows;
+    /**
+     * 过滤标题行，只保留表头行
+     */
+    private static filterTitleRows;
+    /**
+     * 获取非空单元格
+     */
+    private static getNonEmptyCells;
+    /**
+     * 判断是否为标题行
+     */
+    private static isTitleRow;
+    /**
+     * 判断是否为表头行
+     */
+    private static isHeaderRow;
+    /**
+     * 判断是否为数据行
+     */
+    private static isDataRow;
+    /**
+     * 合并多层表头
+     */
+    static mergeHeaders(effectiveHeaderRows: any[][], maxCols: number): string[];
+}

package/core/excel/parsers/StyleExtractor.d.ts

@@ -0,0 +1,27 @@
+import { CellStyle } from '../types';
+/**
+ * Excel 单元格样式提取器
+ */
+import * as XLSX from "xlsx";
+export declare class StyleExtractor {
+    /**
+     * 提取单元格样式
+     */
+    static extractStyles(worksheet: XLSX.WorkSheet, workbook: XLSX.WorkBook, dataStartRow: number): Map<string, CellStyle> | undefined;
+    /**
+     * 提取单个单元格样式
+     */
+    private static extractCellStyle;
+    /**
+     * 提取字体样式
+     */
+    private static extractFontStyle;
+    /**
+     * 提取填充样式
+     */
+    private static extractFillStyle;
+    /**
+     * 检查是否有非默认样式
+     */
+    private static hasNonDefaultStyle;
+}

package/core/excel/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Excel 相关类型定义
+ */
+export interface ExcelColumn {
+    field?: string;
+    key?: string;
+    title?: string;
+}
+export interface ExcelParseOptions {
+    sheetIndex?: number;
+    headerRow?: number;
+    headerRows?: number;
+    mergeHeaders?: boolean;
+    extractStyles?: boolean;
+    extractComments?: boolean;
+}
+export interface CellStyle {
+    fontColor?: string;
+    bgColor?: string;
+    bold?: boolean;
+    italic?: boolean;
+}
+export interface CellComment {
+    text: string;
+    author?: string;
+}
+export interface ExcelParseResult {
+    columns: Array<{
+        key: string;
+        field: string;
+        title: string;
+        width: number;
+        sort?: boolean;
+        filter?: boolean;
+    }>;
+    records: any[][];
+    cellStyles?: Map<string, CellStyle>;
+    cellComments?: Map<string, CellComment>;
+}

package/core/excel/utils/ColorConverter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 颜色格式转换工具
+ */
+/**
+ * 将 ARGB 颜色转换为 hex 格式
+ */
+export declare function argbToHex(argb: string | undefined): string | undefined;
+/**
+ * 从 xlsx 主题颜色索引获取颜色
+ */
+export declare function getThemeColor(theme: number, _tint?: number): string | undefined;
+/**
+ * 解析 xlsx 颜色对象
+ */
+export declare function parseXlsxColor(color: any): string | undefined;

package/core/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 核心模块导出
+ */
+export { TableSheet } from './TableSheet';
+export type { TableSheetConfig } from './TableSheet';
+export { FindReplaceDialog } from './Dialog';
+export type { MatchPosition, FindReplaceOptions } from './Dialog';
+export { Toolbar } from './Toolbar';
+export type { ToolbarConfig } from './Toolbar';
+export { SlTableSheet } from './SlTableSheet';
+export type { SlTableSheetConfig } from './SlTableSheet';
+export { SlTableSheet as default } from './SlTableSheet';

package/core/managers/CellMarkManager.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 标记单元格管理器
+ */
+export declare class CellMarkManager {
+    private markedMap;
+    private tableInstance;
+    constructor(tableInstance: any, markedMap?: Map<string, {
+        isMarked: boolean;
+        comment?: string;
+    }>);
+    /**
+     * 处理单元格鼠标进入事件
+     */
+    handleCellMouseEnter(args: any): void;
+    /**
+     * 显示 tooltip
+     */
+    private showTooltip;
+    /**
+     * 获取标记映射
+     */
+    getMarkedMap(): Map<string, {
+        isMarked: boolean;
+        comment?: string;
+    }> | null;
+    /**
+     * 设置标记映射
+     */
+    setMarkedMap(markedMap: Map<string, {
+        isMarked: boolean;
+        comment?: string;
+    }>): void;
+}

package/core/managers/CustomComponentManager.d.ts

@@ -0,0 +1,34 @@
+import { CustomComponentConfig } from '../TableSheet';
+
+export declare class CustomComponentManager {
+    private customComponentContainers;
+    private activeComponentKey;
+    private justCreatedComponent;
+    private tableInstance;
+    private container;
+    constructor(tableInstance: any, container: HTMLElement | null);
+    /**
+     * 显示自定义组件
+     */
+    showComponent(componentName: string, config: CustomComponentConfig, cellArgs: any): void;
+    /**
+     * 创建组件容器
+     */
+    private createComponentContainer;
+    /**
+     * 关闭当前激活的组件
+     */
+    closeActiveComponent(): void;
+    /**
+     * 处理点击表格外部
+     */
+    private handleOutsideClick;
+    /**
+     * 绑定外部点击处理
+     */
+    private bindOutsideClickHandler;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+}

package/core/managers/EditorManager.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 编辑器管理器
+ */
+export interface EditorConfig {
+    dateEditor?: boolean | any;
+    listEditor?: {
+        values: string[];
+    };
+    customEditors?: Record<string, any>;
+}
+export declare class EditorManager {
+    /**
+     * 注册编辑器
+     */
+    static registerEditors(config?: EditorConfig): void;
+}

package/core/managers/EventManager.d.ts

@@ -0,0 +1,34 @@
+import { CustomComponentConfig } from '../TableSheet';
+import { CustomComponentManager } from './CustomComponentManager';
+import { CellMarkManager } from './CellMarkManager';
+
+export interface EventManagerConfig {
+    tableInstance: any;
+    columns?: any[];
+    customComponents?: Record<string, CustomComponentConfig>;
+    onCellClick?: (args: any) => void;
+    onCellChange?: (args: any) => void;
+}
+export declare class EventManager {
+    private tableInstance;
+    private config;
+    private customComponentManager;
+    private cellMarkManager;
+    constructor(config: EventManagerConfig, customComponentManager: CustomComponentManager | null, cellMarkManager: CellMarkManager | null);
+    /**
+     * 绑定所有事件
+     */
+    bindEvents(): void;
+    /**
+     * 处理单元格点击
+     */
+    private handleCellClick;
+    /**
+     * 监听事件
+     */
+    on(eventName: string, callback: Function): void;
+    /**
+     * 取消监听事件
+     */
+    off(eventName: string, callback?: Function): void;
+}

package/core/processors/DataProcessor.d.ts

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

package/core/processors/StyleProcessor.d.ts

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

package/core/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 表格配置接口
+ */
+export interface TableSheetConfig {
+    /** 容器元素或选择器 */
+    container: HTMLElement | string;
+    /** 列配置 */
+    columns?: any[];
+    /** 数据 */
+    records?: any[];
+    /** 是否显示公式栏 */
+    showFormulaBar?: boolean;
+    /** 是否显示工作表标签 */
+    showSheetTab?: boolean;
+    /** 工作表配置 */
+    sheets?: SheetConfig[];
+    /** 编辑器配置 */
+    editors?: EditorConfig;
+    /** 其他选项 */
+    options?: any;
+    /** 事件回调 */
+    onReady?: (instance: any) => void;
+    onCellClick?: (args: any) => void;
+    onCellChange?: (args: any) => void;
+}
+/**
+ * 工作表配置
+ */
+export interface SheetConfig {
+    sheetKey: string;
+    sheetTitle: string;
+    columns: any[];
+    data: any[];
+    dragOrder?: {
+        dragHeaderMode?: 'all' | 'column' | 'row';
+    };
+    [key: string]: any;
+}
+/**
+ * 编辑器配置
+ */
+export interface EditorConfig {
+    /** 日期编辑器配置 */
+    dateEditor?: boolean | any;
+    /** 下拉列表编辑器 */
+    listEditor?: {
+        values: string[];
+    };
+    /** 自定义编辑器 */
+    customEditors?: Record<string, any>;
+}
+/**
+ * API 方法返回值
+ */
+export interface CellInfo {
+    col: number;
+    row: number;
+    value: any;
+}

package/data.d.ts

@@ -0,0 +1,3 @@
+
+export declare const columns: any[];
+export declare const data: (string | number)[][];

package/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * TableSheet 统一导出
+ * 支持多种技术栈：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 { SlTableSheet as default } from './core/SlTableSheet';

package/index.umd.d.ts

@@ -0,0 +1,3 @@
+
+export type { TableSheetConfig, SheetConfig, EditorConfig, CellInfo, } from './core/types';
+export { SlTableSheet as default } from './core/SlTableSheet';

package/locales/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 国际化配置
+ */
+export type LocaleType = 'zh-CN' | 'en-US' | 'zh-TW';
+export interface I18nMessages {
+    toolbar: {
+        title: string;
+        unit: string;
+        total: string;
+        hint: string;
+        buttons: {
+            search: string;
+            freeze: {
+                label: string;
+                suffix: string;
+            };
+            list: string;
+        };
+    };
+    dialog: {
+        find: {
+            label: string;
+            placeholder: string;
+        };
+        replace: {
+            label: string;
+            placeholder: string;
+        };
+        checkbox: {
+            selectedOnly: string;
+        };
+        buttons: {
+            close: string;
+            findPrev: string;
+            findNext: string;
+            replaceOne: string;
+            replaceAll: string;
+        };
+        messages: {
+            pleaseInputFind: string;
+            notConnected: string;
+            pleaseSelectColumns: string;
+            noMatchFound: string;
+            nothingToReplace: string;
+            replacedOne: string;
+            replacedAll: string;
+        };
+        result: {
+            found: string;
+        };
+    };
+    sheet: {
+        defaultTitle: string;
+    };
+}
+declare const zhCN: I18nMessages;
+declare const zhTW: I18nMessages;
+declare const enUS: I18nMessages;
+/**
+ * 获取当前语言
+ */
+export declare function getCurrentLocale(): LocaleType;
+/**
+ * 设置当前语言
+ */
+export declare function setLocale(locale: LocaleType): void;
+/**
+ * 获取国际化消息
+ */
+export declare function getMessages(): I18nMessages;
+/**
+ * 格式化消息（支持简单的变量替换）
+ */
+export declare function formatMessage(template: string, params?: Record<string, any>): string;
+/**
+ * 获取指定路径的消息
+ */
+export declare function getMessage(path: string, params?: Record<string, any>): string;
+export { zhCN, enUS, zhTW };
+declare const _default: {
+    getCurrentLocale: typeof getCurrentLocale;
+    setLocale: typeof setLocale;
+    getMessages: typeof getMessages;
+    getMessage: typeof getMessage;
+    formatMessage: typeof formatMessage;
+};
+export default _default;

package/locales/test-zh-TW.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 测试台湾繁体中文国际化功能
+ * 运行方式：npx tsx test-zh-TW.ts
+ */
+export {};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@sl-material/sl-table-sheet",
+  "version": "1.0.0-beta0",
+  "description": "VTable 组件库 - 支持 npm 和 UMD",
+  "main": "./sl-table-sheet.cjs.js",
+  "module": "./sl-table-sheet.es.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./sl-table-sheet.es.js",
+      "require": "./sl-table-sheet.cjs.js",
+      "types": "./index.d.ts"
+    },
+    "./style.css": "./style.css"
+  },
+  "keywords": [
+    "spreadsheet",
+    "typescript",
+    "javascript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@sl-ui-pc/theme-chalk": "0.1.0-beta1",
+    "@visactor/vtable-editors": "^1.22.9",
+    "@visactor/vtable-sheet": "^1.22.9",
+    "xlsx": "^0.18.5"
+  }
+}