quickspeadsheet 1.0.0

package/dist/types/spread.d.ts

@@ -0,0 +1,1147 @@
+/**
+ * SpreadJS 核心类型定义
+ */
+
+declare namespace GC {
+  namespace Spread {
+    /** 通用工具类 */
+    namespace Common {
+      /** 文化管理器 */
+      class CultureManager {
+        /** 获取当前文化 */
+        culture(): string;
+        /** 设置当前文化 */
+        culture(cultureName: string): void;
+        /** 添加文化信息 */
+        addCultureInfo(cultureName: string, cultureInfo: CultureInfo): void;
+        /** 获取文化信息 */
+        getCultureInfo(cultureName?: string | number): CultureInfo;
+        /** 获取当前文化信息 */
+        q4(cultureName?: string | number): CultureInfo;
+      }
+
+      /** 文化信息 */
+      class CultureInfo {
+        /** 数字格式 */
+        NumberFormat: {
+          currencyDecimalDigits: number;
+          currencyDecimalSeparator: string;
+          currencyGroupSeparator: string;
+          currencyGroupSizes: number[];
+          currencyNegativePattern: number;
+          currencyPositivePattern: number;
+          currencySymbol: string;
+          digitSubstitution: number;
+          isReadOnly: boolean;
+          numberGroupSizes: number[];
+          nanSymbol: string;
+          nativeDigits: string[];
+          numberNegativePattern: number;
+          negativeInfinitySymbol: string;
+          negativeSign: string;
+          numberDecimalDigits: number;
+          numberDecimalSeparator: string;
+          numberGroupSeparator: string;
+          positiveInfinitySymbol: string;
+          positiveSign: string;
+          percentDecimalDigits: number;
+          percentDecimalSeparator: string;
+          percentGroupSeparator: string;
+          percentGroupSizes: number[];
+          percentNegativePattern: number;
+          percentPositivePattern: number;
+          percentSymbol: string;
+          perMilleSymbol: string;
+          listSeparator: string;
+          arrayListSeparator: string;
+          arrayGroupSeparator: string;
+          dbNumber: any;
+        };
+
+        /** 日期时间格式 */
+        DateTimeFormat: {
+          abbreviatedDayNames: string[];
+          abbreviatedMonthGenitiveNames: string[];
+          abbreviatedMonthNames: string[];
+          amDesignator: string;
+          calendarIsReadOnly: boolean;
+          calendarWeekRule: number;
+          Calendar: {
+            MinSupportedDateTime: string;
+            MaxSupportedDateTime: string;
+            AlgorithmType: number;
+            CalendarType: number;
+            Eras: number[];
+            TwoDigitYearMax: number;
+            isReadOnly: boolean;
+          };
+          dateSeparator: string;
+          dayNames: string[];
+          firstDayOfWeek: number;
+          fullDateTimePattern: string;
+          longDatePattern: string;
+          longTimePattern: string;
+          monthDayPattern: string;
+          monthGenitiveNames: string[];
+          monthNames: string[];
+          nativeCalendarName: string;
+          pmDesignator: string;
+          rfc1123Pattern: string;
+          shortDatePattern: string;
+          shortestDayNames: string[];
+          shortTimePattern: string;
+          sortableDateTimePattern: string;
+          timeSeparator: string;
+          universalSortableDateTimePattern: string;
+          yearMonthPattern: string;
+          eras?: any;
+        };
+
+        /** 获取文化名称 */
+        name(): string;
+        /** 文化ID */
+        id: number;
+      }
+    }
+
+    /** 命令管理 */
+    namespace Commands {
+      /** 命令管理器 */
+      class CommandManager {
+        /** 添加命令 */
+        addCommand(commandName: string, execute: Function, canExecute: Function): void;
+        /** 执行命令 */
+        execute(commandName: string, ...args: any[]): boolean;
+        /** 检查命令是否可执行 */
+        canExecute(commandName: string, ...args: any[]): boolean;
+      }
+    }
+
+    /** 格式化工具 */
+    namespace Formatter {
+      /** 通用格式化器 */
+      class GeneralFormatter {
+        constructor(formatString: string, digitGroup: number);
+        /** 格式化值 */
+        format(value: any): string;
+      }
+    }
+
+    /** 迷你图 */
+    namespace Sparklines {
+      /** 迷你图类型 */
+      enum SparklineType {
+        line = 0,
+        column = 1,
+        winLoss = 2
+      }
+
+      /** 迷你图设置 */
+      interface SparklineSettings {
+        type: SparklineType;
+        showAxis?: boolean;
+        showMarkers?: boolean;
+        showFirst?: boolean;
+        showLast?: boolean;
+        showHigh?: boolean;
+        showLow?: boolean;
+        showNegative?: boolean;
+        lineWeight?: number;
+        colorSeries?: string;
+        colorNegative?: string;
+        colorAxis?: string;
+        colorMarkers?: string;
+        colorFirst?: string;
+        colorLast?: string;
+        colorHigh?: string;
+        colorLow?: string;
+      }
+    }
+
+    /** 切片器 */
+    namespace Slicers {
+      /** 切片器样式 */
+      interface SlicerStyle {
+        name: string;
+        styleElements?: Array<{ type: string; dxfId: string }>;
+      }
+    }
+
+    /** 计算引擎 */
+    namespace CalcEngine {
+      /** 基础函数 */
+      namespace BasicFunctions {
+        // 基础函数定义
+      }
+
+      /** 高级函数 */
+      namespace AdvancedFunctions {
+        // 高级函数定义
+      }
+    }
+
+    /** 表格核心功能 */
+    namespace Sheets {
+      /** 常用事件名（与 gcShim/spreadCompat 对齐的最小子集） */
+      const Events: {
+        ActiveCellChanged: 'ActiveCellChanged';
+        SelectionChanged: 'selectionChanged';
+        ValueChanged: 'valueChanged';
+        Paint: 'paint';
+      };
+
+      /** 水平位置 */
+      enum HorizontalPosition {
+        left = 0,
+        center = 1,
+        right = 2,
+        nearest = 3
+      }
+
+      /** 垂直位置 */
+      enum VerticalPosition {
+        top = 0,
+        center = 1,
+        bottom = 2,
+        nearest = 3
+      }
+
+      /** 调整大小提示 */
+      enum ShowResizeTip {
+        none = 0,
+        column = 1,
+        row = 2,
+        both = 3
+      }
+
+      /** 滚动提示 */
+      enum ShowScrollTip {
+        none = 0,
+        horizontal = 1,
+        vertical = 2,
+        both = 3
+      }
+
+      /** 自动调整类型 */
+      enum AutoFitType {
+        cell = 0,
+        cellWithHeader = 1
+      }
+
+      /** 无效操作类型 */
+      enum InvalidOperationType {
+        setFormula = 0,
+        copyPaste = 1,
+        dragFill = 2,
+        dragDrop = 3,
+        changePartOfArrayFormula = 4,
+        changeSheetName = 5
+      }
+
+      /** 调整零指示器 */
+      enum ResizeZeroIndicator {
+        "default" = 0,
+        enhanced = 1
+      }
+
+      /** 复制粘贴表头选项 */
+      enum CopyPasteHeaderOptions {
+        noHeaders = 0,
+        rowHeaders = 1,
+        columnHeaders = 2,
+        allHeaders = 3
+      }
+
+      /** 工作簿选项 */
+      interface WorkbookOptions {
+        allowUserDragDrop?: boolean;
+        allowUserDragFill?: boolean;
+        allowUserZoom?: boolean;
+        allowUserResize?: boolean;
+        allowUndo?: boolean;
+        allowSheetReorder?: boolean;
+        allowContextMenu?: boolean;
+        defaultDragFillType?: number;
+        showDragFillSmartTag?: boolean;
+        showHorizontalScrollbar?: boolean;
+        showVerticalScrollbar?: boolean;
+        scrollbarShowMax?: boolean;
+        scrollbarMaxAlign?: boolean;
+        tabStripVisible?: boolean;
+        tabStripRatio?: number;
+        tabEditable?: boolean;
+        newTabVisible?: boolean;
+        cutCopyIndicatorVisible?: boolean;
+        cutCopyIndicatorBorderColor?: string;
+        tabNavigationVisible?: boolean;
+        backColor?: string;
+        backgroundImage?: string | null;
+        backgroundImageLayout?: number;
+        showResizeTip?: number;
+        showDragDropTip?: boolean;
+        showDragFillTip?: boolean;
+        scrollIgnoreHidden?: boolean;
+        highlightInvalidData?: boolean;
+        showScrollTip?: number;
+        grayAreaBackColor?: string | null;
+        useTouchLayout?: boolean;
+        hideSelection?: boolean;
+        resizeZeroIndicator?: number;
+        allowUserEditFormula?: boolean;
+        enableFormulaTextbox?: boolean;
+        referenceStyle?: number;
+        autoFitType?: number;
+        allowCopyPasteExcelStyle?: boolean;
+        allowExtendPasteRange?: boolean;
+        copyPasteHeaderOptions?: number;
+        allowUserDragMerge?: boolean;
+        font?: any;
+      }
+
+      /** 工作簿 */
+      class Workbook {
+        constructor(container: HTMLElement, options?: WorkbookOptions);
+        
+        /** 获取命令管理器 */
+        commandManager(): Commands.CommandManager;
+        /** 获取撤销管理器 */
+        undoManager(): any;
+        /** 获取活动工作表 */
+        getActiveSheet(): Worksheet;
+        /** 设置活动工作表 */
+        setActiveSheet(sheet: Worksheet | string): void;
+        /** 获取活动工作表索引 */
+        getActiveSheetIndex(): number;
+        /** 设置活动工作表索引 */
+        setActiveSheetIndex(index: number): void;
+        /** 添加工作表 */
+        addSheet(name?: string, index?: number): Worksheet;
+        /** 移除工作表 */
+        removeSheet(index: number): void;
+        /** 清空工作表 */
+        clearSheets(): void;
+        /** 获取工作表 */
+        getSheet(index: number): Worksheet | null;
+        /** 根据名称获取工作表 */
+        getSheetFromName(name: string): Worksheet | null;
+        /** 获取工作表索引 */
+        getSheetIndex(name: string): number | null;
+        /** 获取工作表数量 */
+        getSheetCount(): number;
+        /** 设置工作表数量 */
+        setSheetCount(count: number): void;
+        /** 绑定事件 */
+        bind(eventName: string, callback: (...args: any[]) => void): void;
+        /** 选区事件（标准载荷第4参） */
+        bind(eventName: 'selectionChanged', callback: (sheet: Worksheet, row: number, col: number, payload: SelectionChangedPayload) => void): void;
+        /** 值变更事件 */
+        bind(eventName: 'valueChanged', callback: (payload: ValueChangedPayload) => void): void;
+        /** 图表点击事件 */
+        bind(eventName: 'ChartClick', callback: (payload: ChartClickPayload) => void): void;
+        /** 图表元素点击事件 */
+        bind(eventName: 'ChartElementClick', callback: (payload: ChartElementClickPayload) => void): void;
+        /** 兼容签名：bind(name, data, callback) */
+        bind(eventName: string, data: any, callback: (...args: any[]) => void): void;
+        /** 事件绑定别名 */
+        on(eventName: string, callback: (...args: any[]) => void): void;
+        /** 选区事件（标准载荷第4参） */
+        on(eventName: 'selectionChanged', callback: (sheet: Worksheet, row: number, col: number, payload: SelectionChangedPayload) => void): void;
+        /** 值变更事件 */
+        on(eventName: 'valueChanged', callback: (payload: ValueChangedPayload) => void): void;
+        /** 图表点击事件 */
+        on(eventName: 'ChartClick', callback: (payload: ChartClickPayload) => void): void;
+        /** 图表元素点击事件 */
+        on(eventName: 'ChartElementClick', callback: (payload: ChartElementClickPayload) => void): void;
+        /** 解绑事件 */
+        unbind(eventName: string, callback?: (...args: any[]) => void): void;
+        /** 事件解绑别名 */
+        off(eventName: string, callback?: (...args: any[]) => void): void;
+        /** 解绑所有事件 */
+        unbindAll(): void;
+        /** 触发事件 */
+        trigger(eventName: string, ...args: any[]): void;
+        /** 事件触发别名 */
+        emit(eventName: string, ...args: any[]): void;
+        /** 剪贴板操作 */
+        copy(): void;
+        paste(): void;
+        /** 挂起绘制 */
+        suspendPaint(): void;
+        /** 恢复绘制 */
+        resumePaint(): void;
+        /** 检查绘制是否挂起 */
+        isPaintSuspended(): boolean;
+        /** 刷新 */
+        refresh(): void;
+        /** 重绘 */
+        repaint(): void;
+        /** 销毁 */
+        destroy(): void;
+        /** 获取宿主元素 */
+        getHost(): HTMLElement;
+        /** 失效布局 */
+        invalidateLayout(): void;
+        /** 添加命名样式 */
+        addNamedStyle(style: any): void;
+        /** 获取命名样式 */
+        getNamedStyle(name: string): any;
+        /** 移除命名样式 */
+        removeNamedStyle(name: string): void;
+        /** 获取所有命名样式 */
+        getNamedStyles(): any[];
+        /** 聚焦 */
+        focus(focus?: boolean): void;
+        /** 点击检测（clientX/clientY） */
+        hitTest(clientX: number, clientY: number): any;
+        /** 获取单元格矩形 */
+        getCellRect(row: number, col: number): { x: number; y: number; width: number; height: number } | null;
+        /** 进入活动单元格编辑（Canvas 模式） */
+        startEdit(): void;
+      }
+
+      /** 工作表 */
+      class Worksheet {
+        /** 获取工作表名称 */
+        name(): string;
+        /** 设置工作表名称 */
+        name(name: string): void;
+        /** 获取工作表可见性 */
+        visible(): boolean;
+        /** 设置工作表可见性 */
+        visible(visible: boolean): void;
+        /** 获取行数 */
+        getRowCount(): number;
+        /** 设置行数 */
+        setRowCount(count: number): void;
+        /** 获取列数 */
+        getColumnCount(): number;
+        /** 设置列数 */
+        setColumnCount(count: number): void;
+        /** 获取单元格值 */
+        getValue(row: number, col: number): any;
+        /** 设置单元格值 */
+        setValue(row: number, col: number, value: any): void;
+        /** 设置单元格公式 */
+        setFormula(row: number, col: number, formula: string | null): void;
+        /** 获取单元格样式 */
+        getStyle(row: number, col: number): any;
+        /** 设置单元格样式 */
+        setStyle(row: number, col: number, style: any): void;
+        /** 获取合并单元格信息 */
+        getMergedRange(row: number, col: number): any;
+        /** 合并单元格 */
+        merge(row: number, col: number, rowCount: number, colCount: number): void;
+        /** 取消合并单元格 */
+        unmerge(row: number, col: number): void;
+        /** 获取冻结行数 */
+        frozenRowCount(): number;
+        /** 设置冻结行数 */
+        frozenRowCount(count: number): void;
+        /** 获取冻结列数 */
+        frozenColumnCount(): number;
+        /** 设置冻结列数 */
+        frozenColumnCount(count: number): void;
+        /** 获取行高 */
+        getRowHeight(row: number): number;
+        /** 设置行高 */
+        setRowHeight(row: number, height: number): void;
+        /** 获取列宽 */
+        getColumnWidth(col: number): number;
+        /** 设置列宽 */
+        setColumnWidth(col: number, width: number): void;
+        /** 自动调整行高 */
+        autoFitRow(row: number): void;
+        /** 自动调整列宽 */
+        autoFitColumn(col: number): void;
+        /** 获取单元格类型 */
+        getCellType(row: number, col: number): CellTypes.ICellType;
+        /** 设置单元格类型 */
+        setCellType(row: number, col: number, cellType: CellTypes.ICellType): void;
+        /** 绑定事件 */
+        bind(eventName: string, data: any, callback: Function): void;
+        /** 解绑事件 */
+        unbind(eventName: string, callback?: Function): void;
+        /** 解绑所有事件 */
+        unbindAll(): void;
+        /** 挂起事件 */
+        suspendEvent(): void;
+        /** 恢复事件 */
+        resumeEvent(): void;
+        /** 重绘 */
+        repaint(): void;
+        /** 失效布局 */
+        invalidateLayout(): void;
+      }
+
+      /** 单元格类型 */
+      namespace CellTypes {
+        /** 单元格类型接口 */
+        interface ICellType {
+          /** 获取编辑器 */
+          getEditor(): any;
+          /** 验证值 */
+          validate(value: any): boolean;
+          /** 格式化值 */
+          format(value: any): string;
+          /** 解析值 */
+          parse(text: string): any;
+        }
+
+        /** 文本单元格类型 */
+        class TextCellType implements ICellType {
+          constructor(options?: any);
+          getEditor(): any;
+          validate(value: any): boolean;
+          format(value: any): string;
+          parse(text: string): any;
+        }
+
+        /** 数字单元格类型 */
+        class NumberCellType implements ICellType {
+          constructor(options?: any);
+          getEditor(): any;
+          validate(value: any): boolean;
+          format(value: any): string;
+          parse(text: string): any;
+        }
+
+        /** 日期单元格类型 */
+        class DateCellType implements ICellType {
+          constructor(options?: any);
+          getEditor(): any;
+          validate(value: any): boolean;
+          format(value: any): string;
+          parse(text: string): any;
+        }
+
+        /** 下拉列表单元格类型 */
+        class DropDownListCellType implements ICellType {
+          constructor(items: any[]);
+          getEditor(): any;
+          validate(value: any): boolean;
+          format(value: any): string;
+          parse(text: string): any;
+        }
+
+        /** 复选框单元格类型 */
+        class CheckBoxCellType implements ICellType {
+          constructor(options?: any);
+          getEditor(): any;
+          validate(value: any): boolean;
+          format(value: any): string;
+          parse(text: string): any;
+        }
+      }
+
+      /** 绑定功能 */
+      namespace Bindings {
+        /** 绑定类型 */
+        enum BindingType {
+          cell = 0,
+          range = 1,
+          table = 2,
+          list = 3,
+          matrix = 4
+        }
+
+        /** 绑定接口 */
+        interface IBinding {
+          /** 获取绑定类型 */
+          bindingType(): BindingType;
+          /** 获取绑定路径 */
+          path(): string;
+          /** 获取绑定范围 */
+          range(): string;
+          /** 获取绑定名称 */
+          name(): string;
+          /** 设置绑定数据 */
+          setValue(value: any): void;
+          /** 获取绑定数据 */
+          getValue(): any;
+          /** 解绑 */
+          unbind(): void;
+        }
+      }
+
+      /** 搜索功能 */
+      namespace Search {
+        /** 搜索选项 */
+        interface SearchOptions {
+          /** 搜索值 */
+          value: string;
+          /** 是否区分大小写 */
+          caseSensitive?: boolean;
+          /** 是否全字匹配 */
+          wholeWord?: boolean;
+          /** 是否使用正则表达式 */
+          useRegex?: boolean;
+          /** 搜索范围 */
+          range?: string;
+        }
+
+        /** 搜索结果 */
+        interface SearchResult {
+          /** 行索引 */
+          row: number;
+          /** 列索引 */
+          col: number;
+          /** 工作表 */
+          sheet: Worksheet;
+        }
+      }
+
+      /** 大纲功能 */
+      namespace Outlines {
+        /** 大纲级别 */
+        interface OutlineLevel {
+          /** 行大纲级别 */
+          rowLevels: number[];
+          /** 列大纲级别 */
+          columnLevels: number[];
+        }
+      }
+
+      /** 触摸支持 */
+      namespace Touch {
+        /** 触摸配置 */
+        interface TouchConfig {
+          /** 是否启用触摸支持 */
+          enabled?: boolean;
+          /** 触摸手势配置 */
+          gestures?: any;
+        }
+      }
+
+      /** 浮动对象 */
+      namespace FloatingObjects {
+        /** 浮动对象类型 */
+        enum FloatingObjectType {
+          shape = 0,
+          image = 1,
+          textbox = 2
+        }
+
+        /** 浮动对象 */
+        interface FloatingObject {
+          /** 获取对象类型 */
+          type(): FloatingObjectType;
+          /** 获取对象位置 */
+          position(): { x: number; y: number };
+          /** 设置对象位置 */
+          position(pos: { x: number; y: number }): void;
+          /** 获取对象大小 */
+          size(): { width: number; height: number };
+          /** 设置对象大小 */
+          size(size: { width: number; height: number }): void;
+          /** 获取对象可见性 */
+          visible(): boolean;
+          /** 设置对象可见性 */
+          visible(visible: boolean): void;
+          /** 移除对象 */
+          remove(): void;
+        }
+      }
+
+      /** 迷你图 */
+      namespace Sparklines {
+        /** 添加迷你图 */
+        function add(worksheet: Worksheet, range: string, dataRange: string, settings: SparklineSettings): void;
+        /** 移除迷你图 */
+        function remove(worksheet: Worksheet, range: string): void;
+        /** 获取迷你图设置 */
+        function getSettings(worksheet: Worksheet, range: string): SparklineSettings;
+        /** 设置迷你图设置 */
+        function setSettings(worksheet: Worksheet, range: string, settings: SparklineSettings): void;
+      }
+
+      /** 注释 */
+      namespace Comments {
+        /** 注释选项 */
+        interface CommentOptions {
+          /** 注释文本 */
+          text: string;
+          /** 注释作者 */
+          author?: string;
+          /** 注释位置 */
+          position?: { x: number; y: number };
+          /** 注释大小 */
+          size?: { width: number; height: number };
+        }
+
+        /** 添加注释 */
+        function add(worksheet: Worksheet, row: number, col: number, options: CommentOptions): void;
+        /** 移除注释 */
+        function remove(worksheet: Worksheet, row: number, col: number): void;
+        /** 获取注释 */
+        function get(worksheet: Worksheet, row: number, col: number): any;
+        /** 显示注释 */
+        function show(worksheet: Worksheet, row: number, col: number): void;
+        /** 隐藏注释 */
+        function hide(worksheet: Worksheet, row: number, col: number): void;
+      }
+
+      /** 条件格式 */
+      namespace ConditionalFormatting {
+        /** 条件格式类型 */
+        enum ConditionType {
+          cellValue = 0,
+          expression = 1,
+          top10 = 2,
+          unique = 3,
+          duplicate = 4,
+          containsText = 5,
+          notContainsText = 6,
+          beginsWith = 7,
+          endsWith = 8,
+          error = 9,
+          noError = 10,
+          dateOccurring = 11,
+          aboveAverage = 12,
+          colorScale = 13,
+          dataBar = 14,
+          iconSet = 15
+        }
+
+        /** 条件格式规则 */
+        interface ConditionalFormatRule {
+          /** 条件类型 */
+          type: ConditionType;
+          /** 条件值 */
+          values?: any[];
+          /** 条件运算符 */
+          operator?: string;
+          /** 格式 */
+          format?: any;
+        }
+
+        /** 添加条件格式 */
+        function addRule(worksheet: Worksheet, range: string, rule: ConditionalFormatRule): number;
+        /** 移除条件格式 */
+        function removeRule(worksheet: Worksheet, index: number): void;
+        /** 获取条件格式规则 */
+        function getRule(worksheet: Worksheet, index: number): ConditionalFormatRule;
+        /** 设置条件格式规则 */
+        function setRule(worksheet: Worksheet, index: number, rule: ConditionalFormatRule): void;
+      }
+
+      /** 筛选 */
+      namespace Filter {
+        /** 筛选选项 */
+        interface FilterOptions {
+          /** 筛选范围 */
+          range: string;
+          /** 筛选条件 */
+          conditions?: Array<{ col: number; criteria: any }>;
+        }
+
+        /** 添加筛选 */
+        function add(worksheet: Worksheet, options: FilterOptions): void;
+        /** 移除筛选 */
+        function remove(worksheet: Worksheet): void;
+        /** 应用筛选 */
+        function apply(worksheet: Worksheet): void;
+        /** 清除筛选 */
+        function clear(worksheet: Worksheet): void;
+      }
+
+      /** 表格 */
+      namespace Tables {
+        /** 表格选项 */
+        interface TableOptions {
+          /** 表格范围 */
+          range: string;
+          /** 表格名称 */
+          name?: string;
+          /** 是否有表头 */
+          hasHeader?: boolean;
+          /** 是否有汇总行 */
+          hasTotal?: boolean;
+          /** 表格样式 */
+          style?: string;
+        }
+
+        /** 表格 */
+        interface Table {
+          /** 获取表格名称 */
+          name(): string;
+          /** 设置表格名称 */
+          name(name: string): void;
+          /** 获取表格范围 */
+          range(): string;
+          /** 设置表格范围 */
+          range(range: string): void;
+          /** 获取表格样式 */
+          style(): string;
+          /** 设置表格样式 */
+          style(style: string): void;
+          /** 移除表格 */
+          remove(): void;
+        }
+
+        /** 添加表格 */
+        function add(worksheet: Worksheet, options: TableOptions): Table;
+        /** 获取表格 */
+        function get(worksheet: Worksheet, name: string): Table;
+        /** 移除表格 */
+        function remove(worksheet: Worksheet, name: string): void;
+      }
+
+      /** 切片器 */
+      namespace Slicers {
+        /** 切片器选项 */
+        interface SlicerOptions {
+          /** 切片器名称 */
+          name: string;
+          /** 切片器标题 */
+          caption?: string;
+          /** 切片器位置 */
+          position?: { x: number; y: number };
+          /** 切片器大小 */
+          size?: { width: number; height: number };
+          /** 切片器样式 */
+          style?: string;
+          /** 列数 */
+          columnCount?: number;
+        }
+
+        /** 切片器 */
+        interface Slicer {
+          /** 获取切片器名称 */
+          name(): string;
+          /** 设置切片器名称 */
+          name(name: string): void;
+          /** 获取切片器标题 */
+          caption(): string;
+          /** 设置切片器标题 */
+          caption(caption: string): void;
+          /** 获取切片器位置 */
+          position(): { x: number; y: number };
+          /** 设置切片器位置 */
+          position(pos: { x: number; y: number }): void;
+          /** 获取切片器大小 */
+          size(): { width: number; height: number };
+          /** 设置切片器大小 */
+          size(size: { width: number; height: number }): void;
+          /** 获取切片器样式 */
+          style(): string;
+          /** 设置切片器样式 */
+          style(style: string): void;
+          /** 移除切片器 */
+          remove(): void;
+        }
+
+        /** 添加切片器 */
+        function add(worksheet: Worksheet, tableName: string, columnName: string, options: SlicerOptions): Slicer;
+        /** 获取切片器 */
+        function get(worksheet: Worksheet, name: string): Slicer;
+        /** 移除切片器 */
+        function remove(worksheet: Worksheet, name: string): void;
+      }
+
+      /** 数据验证 */
+      namespace DataValidation {
+        /** 数据验证类型 */
+        enum ValidationType {
+          none = 0,
+          wholeNumber = 1,
+          decimal = 2,
+          list = 3,
+          date = 4,
+          time = 5,
+          textLength = 6,
+          custom = 7
+        }
+
+        /** 数据验证运算符 */
+        enum ValidationOperator {
+          between = 0,
+          notBetween = 1,
+          equalTo = 2,
+          notEqualTo = 3,
+          greaterThan = 4,
+          greaterThanOrEqual = 5,
+          lessThan = 6,
+          lessThanOrEqual = 7
+        }
+
+        /** 数据验证选项 */
+        interface ValidationOptions {
+          /** 验证类型 */
+          type: ValidationType;
+          /** 验证运算符 */
+          operator?: ValidationOperator;
+          /** 验证值 */
+          values?: any[];
+          /** 是否忽略空值 */
+          ignoreBlank?: boolean;
+          /** 错误消息 */
+          errorMessage?: string;
+          /** 错误标题 */
+          errorTitle?: string;
+          /** 输入消息 */
+          inputMessage?: string;
+          /** 输入标题 */
+          inputTitle?: string;
+          /** 是否显示错误消息 */
+          showErrorMessage?: boolean;
+          /** 是否显示输入消息 */
+          showInputMessage?: boolean;
+        }
+
+        /** 添加数据验证 */
+        function add(worksheet: Worksheet, range: string, options: ValidationOptions): void;
+        /** 移除数据验证 */
+        function remove(worksheet: Worksheet, range: string): void;
+        /** 获取数据验证 */
+        function get(worksheet: Worksheet, row: number, col: number): ValidationOptions;
+      }
+
+      /** 填充功能 */
+      namespace Fill {
+        /** 填充类型 */
+        enum FillType {
+          copy = 0,
+          series = 1,
+          growth = 2,
+          date = 3,
+          linear = 4,
+          auto = 5
+        }
+
+        /** 填充选项 */
+        interface FillOptions {
+          /** 填充类型 */
+          fillType: FillType;
+          /** 填充方向 */
+          direction?: string;
+          /** 步长 */
+          step?: number;
+          /** 终止值 */
+          stopValue?: any;
+        }
+
+        /** 执行填充 */
+        function fill(worksheet: Worksheet, range: string, options: FillOptions): void;
+      }
+
+      /** 上下文菜单 */
+      namespace ContextMenu {
+        /** 菜单项 */
+        interface MenuItem {
+          /** 菜单项文本 */
+          text: string;
+          /** 菜单项图标 */
+          icon?: string;
+          /** 菜单项点击回调 */
+          command?: string | Function;
+          /** 子菜单项 */
+          items?: MenuItem[];
+          /** 是否分隔线 */
+          separator?: boolean;
+          /** 是否禁用 */
+          disabled?: boolean;
+          /** 是否可见 */
+          visible?: boolean;
+        }
+
+        /** 上下文菜单选项 */
+        interface ContextMenuOptions {
+          /** 菜单项 */
+          items: MenuItem[];
+          /** 是否启用默认菜单项 */
+          useDefaultItems?: boolean;
+        }
+
+        /** 注册上下文菜单 */
+        function register(contextMenu: ContextMenuOptions): void;
+        /** 取消注册上下文菜单 */
+        function unregister(): void;
+      }
+
+      interface SelectionRange {
+        row: number;
+        col: number;
+        rowCount: number;
+        colCount: number;
+      }
+
+      interface SelectionChangedPayload {
+        sheet: Worksheet;
+        row: number;
+        col: number;
+        ranges: SelectionRange[];
+        oldRanges: SelectionRange[];
+      }
+
+      interface ValueChangedPayload {
+        sheet: Worksheet;
+        row: number;
+        col: number;
+        oldValue: any;
+        newValue: any;
+      }
+
+      interface ChartClickPayload {
+        sheet: Worksheet;
+        shapeIndex: number;
+      }
+
+      interface ChartElementClickPayload extends ChartClickPayload {
+        seriesIndex: number;
+        pointIndex: number;
+        series?: any;
+        point?: any;
+      }
+
+      /** 公式文本框 */
+      namespace FormulaTextBox {
+        /** 公式文本框选项 */
+        interface FormulaTextBoxOptions {
+          /** 容器元素 */
+          container: HTMLElement;
+          /** 是否启用 */
+          enabled?: boolean;
+          /** 是否显示公式栏 */
+          visible?: boolean;
+        }
+
+        /** 公式文本框 */
+        class FormulaTextBox {
+          constructor(options: FormulaTextBoxOptions);
+          /** 绑定工作簿 */
+          bindWorkbook(workbook: Workbook): void;
+          /** 解绑工作簿 */
+          unbindWorkbook(): void;
+          /** 获取文本 */
+          text(): string;
+          /** 设置文本 */
+          text(text: string): void;
+          /** 显示 */
+          show(): void;
+          /** 隐藏 */
+          hide(): void;
+          /** 销毁 */
+          destroy(): void;
+        }
+      }
+
+      /** 大纲列 */
+      namespace OutlineColumn {
+        /** 添加大纲列 */
+        function add(worksheet: Worksheet, position: number): void;
+        /** 移除大纲列 */
+        function remove(worksheet: Worksheet): void;
+        /** 获取大纲列位置 */
+        function position(worksheet: Worksheet): number;
+        /** 设置大纲列位置 */
+        function position(worksheet: Worksheet, position: number): void;
+      }
+
+      /** 拖动合并 */
+      namespace DragMerge {
+        /** 启用拖动合并 */
+        function enable(worksheet: Worksheet, enabled: boolean): void;
+        /** 检查是否启用拖动合并 */
+        function isEnabled(worksheet: Worksheet): boolean;
+      }
+    }
+  }
+}
+
+/** 导出Spread命名空间 */
+declare const Spread: typeof GC.Spread;
+export default Spread;
+
+/** 运行时兼容辅助：按需创建轻量 GC 命名空间 */
+export declare function createGcShim(target?: any): any;
+/** 是否存在原生 GC.Spread 运行时 */
+export declare function hasGCSpread(): boolean;
+
+/** createSpreadCompat 返回的最小兼容接口 */
+export interface SpreadCompat {
+  Events: {
+    ActiveCellChanged: 'ActiveCellChanged';
+    SelectionChanged: 'SelectionChanged';
+    ValueChanged: 'ValueChanged';
+    Paint: 'Paint';
+    ChartClick: 'ChartClick';
+    ChartElementClick: 'ChartElementClick';
+  };
+  fromJSON(data: any): void;
+  toJSON(...args: any[]): any;
+  getActiveSheet(): any;
+  getActiveSheetIndex(): number;
+  getWorkbook(): any;
+  getHost(): HTMLElement | null;
+  getSheet(index: number): any;
+  getSheetCount(): number;
+  addSheet(index: number, sheet: any): void;
+  setActiveSheetIndex(index: number): void;
+  getActiveRowIndex(): number;
+  getActiveColumnIndex(): number;
+  setActiveCell(row: number, col: number): void;
+  getSelections(): any[];
+  setSelections(ranges: any[]): void;
+  selectionUnit(val?: number): any;
+  selectionPolicy(val?: number): any;
+  navigateSelection(direction: string): void;
+  suspendPaint(): any;
+  resumePaint(): any;
+  undoManager(): any;
+  copy(): void;
+  paste(): void;
+  hitTest(clientX: number, clientY: number): any;
+  getCellRect(row: number, col: number): { x: number; y: number; width: number; height: number } | null;
+  startEdit(): void;
+  invalidateLayout(): any;
+  focus(): void;
+  refresh(): void;
+  destroy(): void;
+  bind(event: string, handler: (...args: any[]) => void): any;
+  bind(event: 'selectionChanged', handler: (sheet: GC.Spread.Sheets.Worksheet, row: number, col: number, payload: GC.Spread.Sheets.SelectionChangedPayload) => void): any;
+  bind(event: 'valueChanged', handler: (payload: GC.Spread.Sheets.ValueChangedPayload) => void): any;
+  bind(event: 'ChartClick', handler: (payload: GC.Spread.Sheets.ChartClickPayload) => void): any;
+  bind(event: 'ChartElementClick', handler: (payload: GC.Spread.Sheets.ChartElementClickPayload) => void): any;
+  unbind(event: string, handler?: (...args: any[]) => void): any;
+  unbindAll(): any;
+  trigger(event: string, ...args: any[]): any;
+  trigger(event: 'ChartClick', payload: GC.Spread.Sheets.ChartClickPayload): any;
+  trigger(event: 'ChartElementClick', payload: GC.Spread.Sheets.ChartElementClickPayload): any;
+  on(event: string, handler: (...args: any[]) => void): any;
+  on(event: 'selectionChanged', handler: (sheet: GC.Spread.Sheets.Worksheet, row: number, col: number, payload: GC.Spread.Sheets.SelectionChangedPayload) => void): any;
+  on(event: 'valueChanged', handler: (payload: GC.Spread.Sheets.ValueChangedPayload) => void): any;
+  on(event: 'ChartClick', handler: (payload: GC.Spread.Sheets.ChartClickPayload) => void): any;
+  on(event: 'ChartElementClick', handler: (payload: GC.Spread.Sheets.ChartElementClickPayload) => void): any;
+  off(event: string, handler?: (...args: any[]) => void): any;
+  emit(event: string, ...args: any[]): any;
+  emit(event: 'ChartClick', payload: GC.Spread.Sheets.ChartClickPayload): any;
+  emit(event: 'ChartElementClick', payload: GC.Spread.Sheets.ChartElementClickPayload): any;
+  eventMap: Record<string, string>;
+  options: Record<string, any>;
+  container: HTMLElement | null;
+  sheets: any[];
+}
+
+/** 运行时兼容辅助：创建 Spread 兼容包装 */
+export declare function createSpreadCompat(workbook: any): SpreadCompat | null;
+
+/** 图表兼容辅助：统一 parse/render 入口 */
+export declare const GcChartsShim: {
+  parse(chartXml: string): any;
+  render(container: HTMLElement, chartData: any, options?: any): {
+    chart: any;
+    update(nextData?: any, nextOptions?: any): any;
+    destroy(): void;
+    hitTest(clientX: number, clientY: number): any;
+    setActiveElements(seriesIndex?: number, pointIndex?: number): any;
+    getChartInstance(): any;
+  };
+  create(container: HTMLElement, chartData: any, options?: any): {
+    chart: any;
+    update(nextData?: any, nextOptions?: any): any;
+    destroy(): void;
+    hitTest(clientX: number, clientY: number): any;
+    setActiveElements(seriesIndex?: number, pointIndex?: number): any;
+    getChartInstance(): any;
+  };
+};