belobog-stellar-grid 1.0.0 → 1.0.1

package/README.md

@@ -170,7 +170,7 @@ await export_table_to_csv_batch(
   1000, // 每批处理 1000 行
   (progress) => {
     console.log(`进度: ${Math.round(progress)}%`);
-  }
+  },
 );
 ```
 
@@ -319,6 +319,46 @@ basic-http-server .
 # 访问: http://localhost:4000/examples/
 ```
 
+### 发布到 npm
+
+项目使用 `just` 进行发布管理。需要先安装 [just](https://github.com/casey/just) 和 [cargo-edit](https://github.com/killercup/cargo-edit)：
+
+```bash
+# 安装 just
+cargo install just
+
+# 安装 cargo-edit（用于版本管理）
+cargo install cargo-edit
+```
+
+**发布流程**：
+
+```bash
+# 1. 升级版本
+just bump patch    # 1.0.0 -> 1.0.1 (补丁版本)
+just bump minor    # 1.0.0 -> 1.1.0 (次要版本)
+just bump major    # 1.0.0 -> 2.0.0 (主要版本)
+
+# 2. 提交更改
+git add .
+git commit -m "chore: bump version"
+
+# 3. 发布到 npm
+just publish latest    # 发布稳定版
+just publish beta      # 发布 beta 版
+just publish next      # 发布 next 版
+```
+
+**其他发布相关命令**：
+
+```bash
+just info       # 查看当前版本
+just test       # 运行测试
+just build      # 构建 WASM
+just optimize   # 优化 WASM 文件大小
+just dry-run    # 发布前测试
+```
+
 ### 项目结构
 
 ```
@@ -364,6 +404,43 @@ belobog-stellar-grid/
 
 ---
 
+## 📌 TODO / 开发路线图
+
+以下是待改进的功能点：
+
+### 数据类型处理
+
+- [ ] 支持数据类型自动检测（数字、日期、布尔值等）
+- [ ] 导出时将数字类型写入 Excel 数值单元格而非文本
+- [ ] 支持 Excel 公式导出
+
+### 样式与格式化
+
+- [ ] 支持基础样式设置（字体、颜色、边框、背景色）
+- [ ] 支持列宽自动调整
+- [ ] 支持表头行特殊样式（加粗、背景色）
+- [ ] 支持条件格式（数据条、图标集等）
+
+### 表格结构
+
+- [ ] 导出时保留合并单元格状态
+- [ ] 支持多工作表导出（多表格导出到同一 Excel 文件的不同 sheet）
+- [ ] 支持检测并排除隐藏行/列（`display: none`）
+
+### 数据选择与过滤
+
+- [ ] 支持选择性导出特定行或列
+- [ ] 支持导出前数据预处理/转换
+- [ ] 支持自定义列名映射
+
+### 其他
+
+- [ ] 支持从 JavaScript 数组直接生成文件（不依赖 DOM）
+- [ ] CSV 导出添加 BOM 头选项（兼容旧版 Excel）
+- [ ] 探索 Node.js/服务端支持可能性
+
+---
+
 ## 🤝 社区与支持
 
 ### 获取帮助

package/belobog_stellar_grid.d.ts

@@ -5,14 +5,14 @@
  * 导出格式枚举
  */
 export enum ExportFormat {
-  /**
-   * CSV 格式（默认）
-   */
-  Csv = 0,
-  /**
-   * Excel XLSX 格式
-   */
-  Xlsx = 1,
+    /**
+     * CSV 格式（默认）
+     */
+    Csv = 0,
+    /**
+     * Excel XLSX 格式
+     */
+    Xlsx = 1,
 }
 
 /**
@@ -57,6 +57,7 @@ export function export_table(table_id: string, filename?: string | null, format?
  *
  * 这个函数将表格数据分批处理，在批次之间让出控制权给浏览器事件循环，
  * 从而避免在处理大量数据时阻塞主线程导致页面卡死。
+ * 支持合并单元格（colspan/rowspan）的正确处理。
  *
  * # 参数
  * * `table_id` - 要导出的 HTML 表格元素的 ID
@@ -85,42 +86,77 @@ export function export_table(table_id: string, filename?: string | null, format?
  */
 export function export_table_to_csv_batch(table_id: string, tbody_id?: string | null, filename?: string | null, batch_size?: number | null, progress_callback?: Function | null): Promise<any>;
 
+/**
+ * 分批异步导出 HTML 表格到 XLSX 文件
+ *
+ * 采用两阶段策略避免阻塞主线程：
+ * 1. 分批读取 DOM 数据（异步，可 yield 让出控制权）
+ * 2. 同步生成 XLSX 文件（内存操作，快速）
+ *
+ * # 参数
+ * * `table_id` - 要导出的 HTML 表格元素的 ID
+ * * `tbody_id` - 可选的数据表格体 ID（用于分离表头和数据）
+ * * `filename` - 可选的导出文件名（默认为 "table_export.xlsx"）
+ * * `batch_size` - 每批处理的行数（默认 1000）
+ * * `progress_callback` - 进度回调函数，接收进度百分比 (0-100)
+ *
+ * # 返回值
+ * * `Promise<void>` - 异步操作的 Promise
+ *
+ * # 示例
+ * ```javascript
+ * import { export_table_to_xlsx_batch } from './pkg/belobog_stellar_grid.js';
+ *
+ * await export_table_to_xlsx_batch(
+ *     'my-table',
+ *     'my-tbody',  // 可选的 tbody ID
+ *     'data.xlsx',
+ *     1000,  // 每批 1000 行
+ *     (progress) => {
+ *         console.log(`进度: ${progress}%`);
+ *     }
+ * );
+ * ```
+ */
+export function export_table_to_xlsx_batch(table_id: string, tbody_id?: string | null, filename?: string | null, batch_size?: number | null, progress_callback?: Function | null): Promise<any>;
+
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
-  readonly memory: WebAssembly.Memory;
-  readonly export_table: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
-  readonly export_table_to_csv_batch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => any;
-  readonly wasm_bindgen__convert__closures_____invoke__hd548f8095fd5fd71: (a: number, b: number, c: any) => void;
-  readonly wasm_bindgen__closure__destroy__hd85ddfaf9b76fe33: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h27f1beedb8b1e394: (a: number, b: number, c: any, d: any) => void;
-  readonly __wbindgen_malloc: (a: number, b: number) => number;
-  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
-  readonly __wbindgen_exn_store: (a: number) => void;
-  readonly __externref_table_alloc: () => number;
-  readonly __wbindgen_externrefs: WebAssembly.Table;
-  readonly __externref_table_dealloc: (a: number) => void;
-  readonly __wbindgen_start: () => void;
+    readonly memory: WebAssembly.Memory;
+    readonly export_table: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
+    readonly export_table_to_csv_batch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => any;
+    readonly export_table_to_xlsx_batch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => any;
+    readonly wasm_bindgen__closure__destroy__hfa0c196dc31165a7: (a: number, b: number) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h532f206189913be7: (a: number, b: number, c: any, d: any) => void;
+    readonly wasm_bindgen__convert__closures_____invoke__h44abe8207b381064: (a: number, b: number, c: any) => void;
+    readonly __wbindgen_malloc: (a: number, b: number) => number;
+    readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_exn_store: (a: number) => void;
+    readonly __externref_table_alloc: () => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __externref_table_dealloc: (a: number) => void;
+    readonly __wbindgen_start: () => void;
 }
 
 export type SyncInitInput = BufferSource | WebAssembly.Module;
 
 /**
-* Instantiates the given `module`, which can either be bytes or
-* a precompiled `WebAssembly.Module`.
-*
-* @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
-*
-* @returns {InitOutput}
-*/
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
 export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
 
 /**
-* If `module_or_path` is {RequestInfo} or {URL}, makes a request and
-* for everything else, calls `WebAssembly.instantiate` directly.
-*
-* @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
-*
-* @returns {Promise<InitOutput>}
-*/
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
 export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;