@bsg-export/worker 1.0.8

package/README.md

@@ -0,0 +1,102 @@
+# @bsg-export/worker
+
+[![npm](https://img.shields.io/npm/v/@bsg-export/worker)](https://www.npmjs.com/package/@bsg-export/worker)
+
+> [belobog-stellar-grid](https://github.com/kurisu994/belobog-stellar-grid) 的 Web Worker 导出封装
+
+## 简介
+
+将 CSV/XLSX 文件生成移至 Worker 线程，主线程不阻塞。适用于大数据量导出（10000+ 行）。
+
+## 安装
+
+```bash
+npm install @bsg-export/worker belobog-stellar-grid
+# 或
+pnpm add @bsg-export/worker belobog-stellar-grid
+```
+
+**前置依赖**：`belobog-stellar-grid >= 1.0.0`
+
+## 使用方式
+
+### 方式 1：ExportWorker 类（通用）
+
+```typescript
+import { ExportWorker } from '@bsg-export/worker';
+
+// Vite
+import ExportWorkerScript from '@bsg-export/worker/worker?worker';
+const worker = new ExportWorker(new ExportWorkerScript());
+
+// Webpack 5
+const w = new Worker(new URL('@bsg-export/worker/worker', import.meta.url), { type: 'module' });
+const worker = new ExportWorker(w);
+
+// 初始化
+await worker.init();
+
+// 导出数据（Worker 生成 → 主线程下载）
+await worker.exportData(
+  [{ name: '张三', age: 28 }],
+  {
+    columns: [{ title: '姓名', key: 'name' }, { title: '年龄', key: 'age' }],
+    filename: '用户.xlsx',
+    format: 1,
+  },
+  { onProgress: (p) => console.log(`${p}%`) }
+);
+
+// 仅生成字节
+const bytes = await worker.generateBytes(data, options);
+
+// 销毁
+worker.terminate();
+```
+
+### 方式 2：React Hook
+
+```tsx
+import { useWorkerExporter } from '@bsg-export/react';
+import ExportWorkerScript from '@bsg-export/worker/worker?worker';
+
+const { initialized, loading, progress, exportData } = useWorkerExporter(
+  () => new ExportWorkerScript()
+);
+```
+
+### 方式 3：Vue 3 Composable
+
+```vue
+<script setup>
+import { useWorkerExporter } from '@bsg-export/vue';
+import ExportWorkerScript from '@bsg-export/worker/worker?worker';
+
+const { initialized, loading, progress, exportData } = useWorkerExporter(
+  () => new ExportWorkerScript()
+);
+</script>
+```
+
+## API
+
+### `ExportWorker`
+
+| 方法 | 说明 |
+|------|------|
+| `init()` | 初始化 Worker 中的 WASM 模块 |
+| `exportData(data, options?, workerOptions?)` | 生成文件并触发下载 |
+| `generateBytes(data, options?, workerOptions?)` | 仅生成文件字节 |
+| `terminate()` | 销毁 Worker |
+| `initialized` | `boolean` — WASM 是否初始化完成 |
+
+### Worker 创建方式
+
+| 构建工具 | 创建方式 |
+|---------|---------|
+| **Vite** | `import W from '@bsg-export/worker/worker?worker'` |
+| **Webpack 5** | `new Worker(new URL('@bsg-export/worker/worker', import.meta.url))` |
+
+## 许可证
+
+MIT OR Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,110 @@
+/**
+ * ExportWorker - Web Worker 导出管理器
+ *
+ * 将导出计算移至 Worker 线程，彻底避免主线程阻塞。
+ * 适用于大数据量场景下的 CSV/XLSX 导出。
+ *
+ * @example
+ * ```typescript
+ * import { ExportWorker } from '@bsg-export/worker';
+ * import MyWorker from './my-worker?worker';
+ *
+ * const worker = new ExportWorker(new MyWorker());
+ * await worker.init();
+ *
+ * // 导出数据（在 Worker 线程中生成，主线程触发下载）
+ * await worker.exportData(
+ *   [{ name: '张三', age: 28 }],
+ *   {
+ *     columns: [{ title: '姓名', key: 'name' }, { title: '年龄', key: 'age' }],
+ *     filename: '用户.xlsx',
+ *     format: 1, // ExportFormat.Xlsx
+ *   }
+ * );
+ *
+ * // 使用完毕后销毁
+ * worker.terminate();
+ * ```
+ */
+import type { ExportDataOptions, DataRow, ProgressCallback } from '@bsg-export/types';
+/** ExportWorker 配置选项 */
+export interface ExportWorkerOptions {
+    /** 进度回调函数 */
+    onProgress?: ProgressCallback;
+}
+/**
+ * Web Worker 导出管理器
+ *
+ * 封装 Worker 生命周期管理、消息协议、文件下载触发。
+ */
+export declare class ExportWorker {
+    private worker;
+    private pending;
+    private _initialized;
+    /**
+     * 创建 ExportWorker 实例
+     *
+     * @param worker - Worker 实例，由用户根据构建工具自行创建
+     *
+     * @example
+     * ```typescript
+     * // Vite
+     * import MyWorker from './export-worker?worker';
+     * const ew = new ExportWorker(new MyWorker());
+     *
+     * // Webpack 5
+     * const worker = new Worker(new URL('./export-worker', import.meta.url));
+     * const ew = new ExportWorker(worker);
+     * ```
+     */
+    constructor(worker: Worker);
+    /** WASM 是否已初始化完成 */
+    get initialized(): boolean;
+    /**
+     * 初始化 Worker 中的 WASM 模块
+     *
+     * 必须在调用 exportData 之前调用。
+     */
+    init(): Promise<void>;
+    /**
+     * 在 Worker 中生成文件并触发下载
+     *
+     * @param data - 导出数据（二维数组或对象数组）
+     * @param options - 导出选项（同 ExportDataOptions，但 progressCallback 通过 onProgress 传入）
+     * @param workerOptions - Worker 特有选项
+     *
+     * @returns Promise，导出完成时 resolve
+     * @throws 导出失败时 reject
+     */
+    exportData(data: DataRow[], options?: Omit<ExportDataOptions, 'progressCallback'>, workerOptions?: ExportWorkerOptions): Promise<void>;
+    /**
+     * 仅生成文件字节（不触发下载）
+     *
+     * 适用于需要自定义下载逻辑或进一步处理文件内容的场景。
+     *
+     * @param data - 导出数据
+     * @param options - 导出选项
+     * @param workerOptions - Worker 特有选项
+     *
+     * @returns 文件字节的 Uint8Array
+     */
+    generateBytes(data: DataRow[], options?: Omit<ExportDataOptions, 'progressCallback'>, workerOptions?: ExportWorkerOptions): Promise<Uint8Array>;
+    /**
+     * 销毁 Worker
+     */
+    terminate(): void;
+    /**
+     * 处理 Worker 消息
+     */
+    private handleMessage;
+    /**
+     * 处理 Worker 错误
+     */
+    private handleError;
+    /**
+     * 在主线程触发文件下载
+     */
+    private downloadFile;
+}
+export type { ExportWorkerOptions as WorkerOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,OAAO,EACP,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAmB3B,wBAAwB;AACxB,MAAM,WAAW,mBAAmB;IAClC,aAAa;IACb,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAiBD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,YAAY,CAAS;IAE7B;;;;;;;;;;;;;;;OAeG;gBACS,MAAM,EAAE,MAAM;IAM1B,oBAAoB;IACpB,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B;;;;;;;;;OASG;IACG,UAAU,CACd,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,EACrD,aAAa,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,IAAI,CAAC;IAgBhB;;;;;;;;;;OAUG;IACG,aAAa,CACjB,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,EACrD,aAAa,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,UAAU,CAAC;IA6BtB;;OAEG;IACH,SAAS,IAAI,IAAI;IAWjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,YAAY;CAoCrB;AAED,YAAY,EAAE,mBAAmB,IAAI,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,227 @@
+/**
+ * ExportWorker - Web Worker 导出管理器
+ *
+ * 将导出计算移至 Worker 线程，彻底避免主线程阻塞。
+ * 适用于大数据量场景下的 CSV/XLSX 导出。
+ *
+ * @example
+ * ```typescript
+ * import { ExportWorker } from '@bsg-export/worker';
+ * import MyWorker from './my-worker?worker';
+ *
+ * const worker = new ExportWorker(new MyWorker());
+ * await worker.init();
+ *
+ * // 导出数据（在 Worker 线程中生成，主线程触发下载）
+ * await worker.exportData(
+ *   [{ name: '张三', age: 28 }],
+ *   {
+ *     columns: [{ title: '姓名', key: 'name' }, { title: '年龄', key: 'age' }],
+ *     filename: '用户.xlsx',
+ *     format: 1, // ExportFormat.Xlsx
+ *   }
+ * );
+ *
+ * // 使用完毕后销毁
+ * worker.terminate();
+ * ```
+ */
+/**
+ * 生成唯一请求 ID
+ */
+let requestCounter = 0;
+function generateId() {
+    return `req_${++requestCounter}_${Date.now()}`;
+}
+/**
+ * Web Worker 导出管理器
+ *
+ * 封装 Worker 生命周期管理、消息协议、文件下载触发。
+ */
+export class ExportWorker {
+    /**
+     * 创建 ExportWorker 实例
+     *
+     * @param worker - Worker 实例，由用户根据构建工具自行创建
+     *
+     * @example
+     * ```typescript
+     * // Vite
+     * import MyWorker from './export-worker?worker';
+     * const ew = new ExportWorker(new MyWorker());
+     *
+     * // Webpack 5
+     * const worker = new Worker(new URL('./export-worker', import.meta.url));
+     * const ew = new ExportWorker(worker);
+     * ```
+     */
+    constructor(worker) {
+        this.pending = new Map();
+        this._initialized = false;
+        this.worker = worker;
+        this.worker.addEventListener('message', this.handleMessage.bind(this));
+        this.worker.addEventListener('error', this.handleError.bind(this));
+    }
+    /** WASM 是否已初始化完成 */
+    get initialized() {
+        return this._initialized;
+    }
+    /**
+     * 初始化 Worker 中的 WASM 模块
+     *
+     * 必须在调用 exportData 之前调用。
+     */
+    async init() {
+        if (this._initialized)
+            return;
+        return new Promise((resolve, reject) => {
+            const id = generateId();
+            this.pending.set(id, {
+                resolve: () => {
+                    this._initialized = true;
+                    resolve();
+                },
+                reject,
+            });
+            const request = { type: 'init', id };
+            this.worker.postMessage(request);
+        });
+    }
+    /**
+     * 在 Worker 中生成文件并触发下载
+     *
+     * @param data - 导出数据（二维数组或对象数组）
+     * @param options - 导出选项（同 ExportDataOptions，但 progressCallback 通过 onProgress 传入）
+     * @param workerOptions - Worker 特有选项
+     *
+     * @returns Promise，导出完成时 resolve
+     * @throws 导出失败时 reject
+     */
+    async exportData(data, options, workerOptions) {
+        if (!this._initialized) {
+            throw new Error('ExportWorker 未初始化，请先调用 init()');
+        }
+        const bytes = await this.generateBytes(data, options, workerOptions);
+        // 在主线程触发下载
+        this.downloadFile(bytes, options?.filename, options?.format, options?.withBom);
+    }
+    /**
+     * 仅生成文件字节（不触发下载）
+     *
+     * 适用于需要自定义下载逻辑或进一步处理文件内容的场景。
+     *
+     * @param data - 导出数据
+     * @param options - 导出选项
+     * @param workerOptions - Worker 特有选项
+     *
+     * @returns 文件字节的 Uint8Array
+     */
+    async generateBytes(data, options, workerOptions) {
+        if (!this._initialized) {
+            throw new Error('ExportWorker 未初始化，请先调用 init()');
+        }
+        const buffer = await new Promise((resolve, reject) => {
+            const id = generateId();
+            this.pending.set(id, {
+                resolve,
+                reject,
+                onProgress: workerOptions?.onProgress,
+            });
+            // Worker 中不传 progressCallback（它不可序列化），
+            // Worker 会自动注入 postMessage 版的进度回调
+            const { ...safeOptions } = options ?? {};
+            const request = {
+                type: 'generate',
+                id,
+                data,
+                options: safeOptions,
+            };
+            this.worker.postMessage(request);
+        });
+        return new Uint8Array(buffer);
+    }
+    /**
+     * 销毁 Worker
+     */
+    terminate() {
+        // 拒绝所有待处理的请求
+        for (const [, pending] of this.pending) {
+            pending.reject(new Error('Worker 已被销毁'));
+        }
+        this.pending.clear();
+        this.worker.terminate();
+        this._initialized = false;
+    }
+    /**
+     * 处理 Worker 消息
+     */
+    handleMessage(event) {
+        const { type, id, bytes, message, progress } = event.data;
+        const pending = this.pending.get(id);
+        if (!pending)
+            return;
+        switch (type) {
+            case 'ready':
+                // init 成功
+                this.pending.delete(id);
+                pending.resolve(new ArrayBuffer(0));
+                break;
+            case 'result':
+                // 生成成功
+                this.pending.delete(id);
+                pending.resolve(bytes);
+                break;
+            case 'error':
+                // 出错
+                this.pending.delete(id);
+                pending.reject(new Error(message ?? '未知错误'));
+                break;
+            case 'progress':
+                // 进度报告
+                if (pending.onProgress && progress !== undefined) {
+                    pending.onProgress(progress);
+                }
+                break;
+        }
+    }
+    /**
+     * 处理 Worker 错误
+     */
+    handleError(event) {
+        // 拒绝所有待处理的请求
+        const error = new Error(`Worker 错误: ${event.message}`);
+        for (const [id, pending] of this.pending) {
+            pending.reject(error);
+            this.pending.delete(id);
+        }
+    }
+    /**
+     * 在主线程触发文件下载
+     */
+    downloadFile(data, filename, format, withBom) {
+        // 确定 MIME 类型和文件扩展名
+        const isXlsx = format === 1;
+        const mimeType = isXlsx
+            ? 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+            : 'text/csv;charset=utf-8';
+        const defaultExt = isXlsx ? 'xlsx' : 'csv';
+        const defaultFilename = `export.${defaultExt}`;
+        let finalFilename = filename ?? defaultFilename;
+        // 确保文件有正确的扩展名
+        if (!finalFilename.endsWith(`.${defaultExt}`)) {
+            finalFilename = `${finalFilename}.${defaultExt}`;
+        }
+        // CSV 且需要 BOM 时，在字节前面加上 BOM（Worker 中 generate_data_bytes 已处理）
+        // 这里无需额外处理，因为 withBom 选项已传给 Worker
+        // 创建 Blob 并触发下载
+        const blob = new Blob([data.buffer], { type: mimeType });
+        const url = URL.createObjectURL(blob);
+        const anchor = document.createElement('a');
+        anchor.href = url;
+        anchor.download = finalFilename;
+        anchor.click();
+        // 延迟 10 秒后释放 Blob URL
+        setTimeout(() => URL.revokeObjectURL(url), 10000);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/worker.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Web Worker 脚本 - 在 Worker 线程中加载 WASM 并执行导出
+ *
+ * 此脚本运行在 Web Worker 环境中，负责：
+ * 1. 初始化 WASM 模块
+ * 2. 接收主线程发来的导出请求
+ * 3. 调用 generate_data_bytes 生成文件字节
+ * 4. 通过 Transferable 将字节传回主线程
+ */
+/** 声明 belobog-stellar-grid 模块类型 */
+declare module 'belobog-stellar-grid' {
+    function generate_data_bytes(data: unknown, options?: unknown): Uint8Array;
+    export default function init(): Promise<void>;
+}
+/** Worker 接收的消息类型 */
+interface WorkerRequest {
+    /** 消息类型 */
+    type: 'init' | 'generate';
+    /** 请求唯一标识 */
+    id: string;
+    /** WASM 模块路径（init 时使用） */
+    wasmUrl?: string;
+    /** 导出数据（generate 时使用） */
+    data?: unknown;
+    /** 导出选项（generate 时使用） */
+    options?: Record<string, unknown>;
+}
+/** Worker 发送的消息类型 */
+interface WorkerResponse {
+    /** 消息类型 */
+    type: 'ready' | 'result' | 'error' | 'progress';
+    /** 对应的请求标识 */
+    id: string;
+    /** 生成的文件字节（result 时） */
+    bytes?: ArrayBuffer;
+    /** 错误信息（error 时） */
+    message?: string;
+    /** 进度值 0-100（progress 时） */
+    progress?: number;
+}
+/** WASM 模块实例 */
+declare let wasmModule: typeof import('belobog-stellar-grid') | null;
+/**
+ * 初始化 WASM 模块
+ */
+declare function initWasm(id: string): Promise<void>;
+/**
+ * 生成导出文件字节
+ */
+declare function generateBytes(id: string, data: unknown, options?: Record<string, unknown>): void;
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,mCAAmC;AACnC,OAAO,QAAQ,sBAAsB,CAAC;IACpC,SAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAClF,MAAM,CAAC,OAAO,UAAU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,qBAAqB;AACrB,UAAU,aAAa;IACrB,WAAW;IACX,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qBAAqB;AACrB,UAAU,cAAc;IACtB,WAAW;IACX,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IAChD,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gBAAgB;AAChB,QAAA,IAAI,UAAU,EAAE,cAAc,sBAAsB,CAAC,GAAG,IAAW,CAAC;AAEpE;;GAEG;AACH,iBAAe,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBjD;AAED;;GAEG;AACH,iBAAS,aAAa,CACpB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAkCN"}

package/dist/worker.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Web Worker 脚本 - 在 Worker 线程中加载 WASM 并执行导出
+ *
+ * 此脚本运行在 Web Worker 环境中，负责：
+ * 1. 初始化 WASM 模块
+ * 2. 接收主线程发来的导出请求
+ * 3. 调用 generate_data_bytes 生成文件字节
+ * 4. 通过 Transferable 将字节传回主线程
+ */
+/// <reference lib="webworker" />
+/** WASM 模块实例 */
+let wasmModule = null;
+/**
+ * 初始化 WASM 模块
+ */
+async function initWasm(id) {
+    try {
+        const mod = await import('belobog-stellar-grid');
+        await mod.default();
+        wasmModule = mod;
+        const response = { type: 'ready', id };
+        self.postMessage(response);
+    }
+    catch (err) {
+        const response = {
+            type: 'error',
+            id,
+            message: `WASM 初始化失败: ${err instanceof Error ? err.message : String(err)}`,
+        };
+        self.postMessage(response);
+    }
+}
+/**
+ * 生成导出文件字节
+ */
+function generateBytes(id, data, options) {
+    if (!wasmModule) {
+        const response = {
+            type: 'error',
+            id,
+            message: 'WASM 模块未初始化，请先发送 init 消息',
+        };
+        self.postMessage(response);
+        return;
+    }
+    try {
+        // 构建选项，注入进度回调（通过 postMessage 传回主线程）
+        const workerOptions = { ...options };
+        workerOptions.progressCallback = (progress) => {
+            const response = { type: 'progress', id, progress };
+            self.postMessage(response);
+        };
+        // 调用 WASM 的 generate_data_bytes
+        const bytes = wasmModule.generate_data_bytes(data, workerOptions);
+        // 通过 Transferable 传输字节，避免拷贝
+        const buffer = bytes.buffer;
+        const response = { type: 'result', id, bytes: buffer };
+        self.postMessage(response, [buffer]);
+    }
+    catch (err) {
+        const response = {
+            type: 'error',
+            id,
+            message: `导出失败: ${err instanceof Error ? err.message : String(err)}`,
+        };
+        self.postMessage(response);
+    }
+}
+/**
+ * 监听主线程消息
+ */
+self.addEventListener('message', (event) => {
+    const { type, id, data, options } = event.data;
+    switch (type) {
+        case 'init':
+            initWasm(id);
+            break;
+        case 'generate':
+            generateBytes(id, data, options);
+            break;
+        default:
+            self.postMessage({
+                type: 'error',
+                id,
+                message: `未知的消息类型: ${type}`,
+            });
+    }
+});
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@bsg-export/worker",
+  "version": "1.0.8",
+  "description": "belobog-stellar-grid 的 Web Worker 封装，将导出计算移至 Worker 线程",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./worker": {
+      "types": "./dist/worker.d.ts",
+      "import": "./dist/worker.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "belobog",
+    "stellar-grid",
+    "worker",
+    "web-worker",
+    "export",
+    "table"
+  ],
+  "author": "Kurisu <makise_kurisuu@outlook.jp>",
+  "license": "MIT OR Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kurisu994/belobog-stellar-grid",
+    "directory": "packages/worker"
+  },
+  "peerDependencies": {
+    "belobog-stellar-grid": ">=1.0.0"
+  },
+  "dependencies": {
+    "@bsg-export/types": "file:../types"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}