@bsg-export/solid 1.0.10

package/dist/ExportButton.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ExportButton - 开箱即用的导出按钮组件 (Solid.js)
+ *
+ * 自动管理 WASM 初始化、导出状态和进度显示。
+ *
+ * @example
+ * ```tsx
+ * import { ExportButton, ExportFormat } from '@bsg-export/solid';
+ *
+ * <ExportButton tableId="my-table" filename="报表.xlsx" format={ExportFormat.Xlsx}>
+ *   导出 Excel
+ * </ExportButton>
+ * ```
+ */
+import { type JSX, type ParentProps } from 'solid-js';
+import type { ExportFormat } from '@bsg-export/types';
+/** ExportButton 组件的 Props */
+export interface ExportButtonProps {
+    /** 要导出的 HTML 表格元素的 ID */
+    tableId: string;
+    /** 导出文件名 */
+    filename?: string;
+    /** 导出格式 */
+    format?: ExportFormat;
+    /** 是否排除隐藏行/列 */
+    excludeHidden?: boolean;
+    /** 是否添加 UTF-8 BOM（仅 CSV 有效） */
+    withBom?: boolean;
+    /** 是否禁用按钮 */
+    disabled?: boolean;
+    /** 导出成功回调 */
+    onExportSuccess?: () => void;
+    /** 导出失败回调 */
+    onExportError?: (error: Error) => void;
+    /** 进度变化回调 */
+    onExportProgress?: (progress: number) => void;
+    /** 初始化中的提示文本 */
+    initializingText?: string;
+    /** 导出中的提示文本（支持 {progress} 占位符） */
+    loadingText?: string;
+    /** 按钮的 CSS class */
+    class?: string;
+    /** 按钮的内联样式 */
+    style?: string | JSX.CSSProperties;
+}
+/**
+ * 导出按钮组件
+ *
+ * 封装了 WASM 初始化和导出逻辑，通过 props 配置导出参数。
+ */
+export declare function ExportButton(props: ParentProps<ExportButtonProps>): JSX.Element;
+//# sourceMappingURL=ExportButton.d.ts.map

package/dist/ExportButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportButton.d.ts","sourceRoot":"","sources":["../src/ExportButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAgB,KAAK,GAAG,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,6BAA6B;AAC7B,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,gBAAgB;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa;IACb,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,aAAa;IACb,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACvC,aAAa;IACb,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,gBAAgB;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,iBAAiB,CAAC,eAsDjE"}

package/dist/ExportButton.jsx

@@ -0,0 +1,64 @@
+/**
+ * ExportButton - 开箱即用的导出按钮组件 (Solid.js)
+ *
+ * 自动管理 WASM 初始化、导出状态和进度显示。
+ *
+ * @example
+ * ```tsx
+ * import { ExportButton, ExportFormat } from '@bsg-export/solid';
+ *
+ * <ExportButton tableId="my-table" filename="报表.xlsx" format={ExportFormat.Xlsx}>
+ *   导出 Excel
+ * </ExportButton>
+ * ```
+ */
+import { createEffect } from 'solid-js';
+import { createExporter } from './create-exporter';
+/**
+ * 导出按钮组件
+ *
+ * 封装了 WASM 初始化和导出逻辑，通过 props 配置导出参数。
+ */
+export function ExportButton(props) {
+    const { initialized, loading, progress, error, exportTable } = createExporter();
+    const initText = () => props.initializingText ?? '初始化中...';
+    const loadText = () => props.loadingText ?? '导出中 {progress}%';
+    // 监听错误并触发回调
+    createEffect(() => {
+        const err = error();
+        if (err && props.onExportError) {
+            props.onExportError(err);
+        }
+    });
+    // 监听进度变化并触发回调
+    createEffect(() => {
+        const p = progress();
+        if (props.onExportProgress) {
+            props.onExportProgress(p);
+        }
+    });
+    /** 处理点击 */
+    const handleClick = () => {
+        const success = exportTable({
+            tableId: props.tableId,
+            filename: props.filename,
+            format: props.format,
+            excludeHidden: props.excludeHidden,
+            withBom: props.withBom,
+        });
+        if (success && props.onExportSuccess) {
+            props.onExportSuccess();
+        }
+    };
+    /** 渲染按钮文本 */
+    const renderText = () => {
+        if (!initialized())
+            return initText();
+        if (loading())
+            return loadText().replace('{progress}', Math.round(progress()).toString());
+        return props.children ?? '导出';
+    };
+    return (<button class={props.class} style={props.style} disabled={props.disabled || !initialized() || loading()} onClick={handleClick}>
+      {renderText()}
+    </button>);
+}

package/dist/create-exporter.d.ts

@@ -0,0 +1,54 @@
+/**
+ * createExporter - WASM 导出管理 Primitive
+ *
+ * 自动管理 WASM 初始化生命周期，提供类型安全的导出方法和响应式信号。
+ *
+ * @example
+ * ```tsx
+ * import { createExporter } from '@bsg-export/solid';
+ *
+ * function App() {
+ *   const { initialized, loading, progress, exportTable } = createExporter();
+ *
+ *   return (
+ *     <button onClick={() => exportTable({ tableId: 'my-table', filename: '报表.xlsx' })}
+ *             disabled={!initialized() || loading()}>
+ *       {loading() ? `导出中 ${progress()}%` : '导出 Excel'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+import { type Accessor } from 'solid-js';
+import type { ExportDataOptions, ExportTableOptions, ExportTablesXlsxOptions, ExportCsvBatchOptions, ExportXlsxBatchOptions, ExportTablesBatchOptions, DataRow } from '@bsg-export/types';
+/** createExporter 返回值 */
+export interface CreateExporterReturn {
+    /** WASM 是否已初始化完成 */
+    initialized: Accessor<boolean>;
+    /** 是否正在导出 */
+    loading: Accessor<boolean>;
+    /** 导出进度 (0-100) */
+    progress: Accessor<number>;
+    /** 错误信息 */
+    error: Accessor<Error | null>;
+    /** 导出 HTML 表格 */
+    exportTable: (options: ExportTableOptions) => boolean;
+    /** 从 JS 数组直接导出 */
+    exportData: (data: DataRow[], options?: ExportDataOptions) => boolean;
+    /** 多工作表同步导出 */
+    exportTablesXlsx: (options: ExportTablesXlsxOptions) => boolean;
+    /** 分批异步导出 CSV */
+    exportCsvBatch: (options: ExportCsvBatchOptions) => Promise<boolean>;
+    /** 分批异步导出 XLSX */
+    exportXlsxBatch: (options: ExportXlsxBatchOptions) => Promise<boolean>;
+    /** 多工作表分批异步导出 */
+    exportTablesBatch: (options: ExportTablesBatchOptions) => Promise<boolean>;
+}
+/**
+ * WASM 导出管理 Primitive
+ *
+ * 自动初始化 WASM 模块，提供类型安全的导出方法，
+ * 管理 loading / progress / error 响应式信号。
+ */
+export declare function createExporter(): CreateExporterReturn;
+//# sourceMappingURL=create-exporter.d.ts.map

package/dist/create-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-exporter.d.ts","sourceRoot":"","sources":["../src/create-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EAExB,OAAO,EACR,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,oBAAoB;IACpB,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,aAAa;IACb,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,mBAAmB;IACnB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,WAAW;IACX,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC9B,iBAAiB;IACjB,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC;IACtD,kBAAkB;IAClB,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC;IACtE,eAAe;IACf,gBAAgB,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC;IAChE,iBAAiB;IACjB,cAAc,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,kBAAkB;IAClB,eAAe,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,iBAAiB;IACjB,iBAAiB,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5E;AA6BD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CA6JrD"}

package/dist/create-exporter.js

@@ -0,0 +1,177 @@
+/**
+ * createExporter - WASM 导出管理 Primitive
+ *
+ * 自动管理 WASM 初始化生命周期，提供类型安全的导出方法和响应式信号。
+ *
+ * @example
+ * ```tsx
+ * import { createExporter } from '@bsg-export/solid';
+ *
+ * function App() {
+ *   const { initialized, loading, progress, exportTable } = createExporter();
+ *
+ *   return (
+ *     <button onClick={() => exportTable({ tableId: 'my-table', filename: '报表.xlsx' })}
+ *             disabled={!initialized() || loading()}>
+ *       {loading() ? `导出中 ${progress()}%` : '导出 Excel'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+import { createSignal, onMount, onCleanup } from 'solid-js';
+/** WASM 模块缓存 */
+let wasmModule = null;
+let wasmInitPromise = null;
+/**
+ * 初始化 WASM 模块（单例模式）
+ */
+async function initWasm() {
+    if (wasmModule)
+        return wasmModule;
+    if (!wasmInitPromise) {
+        wasmInitPromise = import('belobog-stellar-grid')
+            .then(async (mod) => {
+            await mod.default();
+            wasmModule = mod;
+            return mod;
+        })
+            .catch((err) => {
+            // 初始化失败时重置 Promise，允许后续调用重试
+            wasmInitPromise = null;
+            throw err;
+        });
+    }
+    return wasmInitPromise;
+}
+/**
+ * WASM 导出管理 Primitive
+ *
+ * 自动初始化 WASM 模块，提供类型安全的导出方法，
+ * 管理 loading / progress / error 响应式信号。
+ */
+export function createExporter() {
+    const [initialized, setInitialized] = createSignal(false);
+    const [loading, setLoading] = createSignal(false);
+    const [progress, setProgress] = createSignal(0);
+    const [error, setError] = createSignal(null);
+    let alive = true;
+    onMount(() => {
+        initWasm()
+            .then(() => {
+            if (alive)
+                setInitialized(true);
+        })
+            .catch((err) => {
+            if (alive)
+                setError(err instanceof Error ? err : new Error(String(err)));
+        });
+    });
+    onCleanup(() => {
+        alive = false;
+    });
+    /** 创建进度回调（自动更新 progress 状态） */
+    const createProgressCallback = () => {
+        return (p) => {
+            if (alive)
+                setProgress(p);
+        };
+    };
+    /** 包装同步导出操作 */
+    const wrapSync = (fn) => {
+        if (!initialized() || !wasmModule)
+            return false;
+        setLoading(true);
+        setProgress(0);
+        setError(null);
+        try {
+            fn();
+            if (alive)
+                setProgress(100);
+            return true;
+        }
+        catch (err) {
+            if (alive)
+                setError(err instanceof Error ? err : new Error(String(err)));
+            return false;
+        }
+        finally {
+            if (alive)
+                setLoading(false);
+        }
+    };
+    /** 包装异步导出操作 */
+    const wrapAsync = async (fn) => {
+        if (!initialized() || !wasmModule)
+            return false;
+        setLoading(true);
+        setProgress(0);
+        setError(null);
+        try {
+            await fn();
+            if (alive)
+                setProgress(100);
+            return true;
+        }
+        catch (err) {
+            if (alive)
+                setError(err instanceof Error ? err : new Error(String(err)));
+            return false;
+        }
+        finally {
+            if (alive)
+                setLoading(false);
+        }
+    };
+    /** 导出 HTML 表格 */
+    const exportTable = (options) => {
+        return wrapSync(() => {
+            wasmModule.export_table(options.tableId, options.filename, options.format, options.excludeHidden, createProgressCallback(), options.withBom, options.strictProgressCallback);
+        });
+    };
+    /** 从 JS 数组直接导出 */
+    const exportData = (data, options) => {
+        return wrapSync(() => {
+            const opts = options
+                ? { ...options, progressCallback: options.progressCallback ?? createProgressCallback() }
+                : { progressCallback: createProgressCallback() };
+            wasmModule.export_data(data, opts);
+        });
+    };
+    /** 多工作表同步导出 */
+    const exportTablesXlsx = (options) => {
+        return wrapSync(() => {
+            wasmModule.export_tables_xlsx(options.sheets, options.filename, createProgressCallback(), options.strictProgressCallback);
+        });
+    };
+    /** 分批异步导出 CSV */
+    const exportCsvBatch = async (options) => {
+        return await wrapAsync(async () => {
+            await wasmModule.export_table_to_csv_batch(options.tableId, options.tbodyId, options.filename, options.batchSize, options.excludeHidden, createProgressCallback(), options.withBom, options.strictProgressCallback);
+        });
+    };
+    /** 分批异步导出 XLSX */
+    const exportXlsxBatch = async (options) => {
+        return await wrapAsync(async () => {
+            await wasmModule.export_table_to_xlsx_batch(options.tableId, options.tbodyId, options.filename, options.batchSize, options.excludeHidden, createProgressCallback(), options.strictProgressCallback);
+        });
+    };
+    /** 多工作表分批异步导出 */
+    const exportTablesBatch = async (options) => {
+        return await wrapAsync(async () => {
+            await wasmModule.export_tables_to_xlsx_batch(options.sheets, options.filename, options.batchSize, createProgressCallback(), options.strictProgressCallback);
+        });
+    };
+    return {
+        initialized,
+        loading,
+        progress,
+        error,
+        exportTable,
+        exportData,
+        exportTablesXlsx,
+        exportCsvBatch,
+        exportXlsxBatch,
+        exportTablesBatch,
+    };
+}

package/dist/create-worker-exporter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * createWorkerExporter - Worker 线程导出管理 Primitive
+ *
+ * 将 CSV/XLSX 生成移至 Worker 线程，主线程不阻塞。
+ * 用户需要传入一个创建 Worker 实例的工厂函数。
+ *
+ * @example
+ * ```tsx
+ * import { createWorkerExporter } from '@bsg-export/solid';
+ *
+ * // Vite
+ * import ExportWorkerScript from '@bsg-export/worker/worker?worker';
+ *
+ * function App() {
+ *   const { initialized, loading, progress, exportData } =
+ *     createWorkerExporter(() => new ExportWorkerScript());
+ *
+ *   return (
+ *     <button disabled={!initialized() || loading()}
+ *             onClick={() => exportData(data, { columns, filename: '报表.xlsx', format: 1 })}>
+ *       {loading() ? `导出中 ${Math.round(progress())}%` : '导出'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+import { type Accessor } from 'solid-js';
+import type { ExportDataOptions, DataRow } from '@bsg-export/types';
+/** createWorkerExporter 返回值 */
+export interface CreateWorkerExporterReturn {
+    /** Worker 中的 WASM 是否已初始化完成 */
+    initialized: Accessor<boolean>;
+    /** 是否正在导出 */
+    loading: Accessor<boolean>;
+    /** 导出进度 (0-100) */
+    progress: Accessor<number>;
+    /** 错误信息 */
+    error: Accessor<Error | null>;
+    /** 在 Worker 中生成文件并触发下载 */
+    exportData: (data: DataRow[], options?: Omit<ExportDataOptions, 'progressCallback'>) => Promise<boolean>;
+    /** 在 Worker 中生成文件字节（不触发下载） */
+    generateBytes: (data: DataRow[], options?: Omit<ExportDataOptions, 'progressCallback'>) => Promise<Uint8Array | null>;
+    /** 销毁 Worker */
+    terminate: () => void;
+}
+/**
+ * Worker 线程导出管理 Primitive
+ *
+ * 接收一个 Worker 工厂函数，自动管理 Worker 生命周期和 WASM 初始化。
+ * 导出计算在 Worker 线程执行，主线程保持响应。
+ *
+ * @param createWorker - 创建 Worker 实例的工厂函数
+ */
+export declare function createWorkerExporter(createWorker: () => Worker): CreateWorkerExporterReturn;
+//# sourceMappingURL=create-worker-exporter.d.ts.map

package/dist/create-worker-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-worker-exporter.d.ts","sourceRoot":"","sources":["../src/create-worker-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,KAAK,EACV,iBAAiB,EAEjB,OAAO,EACR,MAAM,mBAAmB,CAAC;AAE3B,+BAA+B;AAC/B,MAAM,WAAW,0BAA0B;IACzC,8BAA8B;IAC9B,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,aAAa;IACb,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,mBAAmB;IACnB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,WAAW;IACX,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC9B,0BAA0B;IAC1B,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzG,8BAA8B;IAC9B,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACtH,gBAAgB;IAChB,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAiCD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,MAAM,GAAG,0BAA0B,CAuM3F"}

package/dist/create-worker-exporter.js

@@ -0,0 +1,228 @@
+/**
+ * createWorkerExporter - Worker 线程导出管理 Primitive
+ *
+ * 将 CSV/XLSX 生成移至 Worker 线程，主线程不阻塞。
+ * 用户需要传入一个创建 Worker 实例的工厂函数。
+ *
+ * @example
+ * ```tsx
+ * import { createWorkerExporter } from '@bsg-export/solid';
+ *
+ * // Vite
+ * import ExportWorkerScript from '@bsg-export/worker/worker?worker';
+ *
+ * function App() {
+ *   const { initialized, loading, progress, exportData } =
+ *     createWorkerExporter(() => new ExportWorkerScript());
+ *
+ *   return (
+ *     <button disabled={!initialized() || loading()}
+ *             onClick={() => exportData(data, { columns, filename: '报表.xlsx', format: 1 })}>
+ *       {loading() ? `导出中 ${Math.round(progress())}%` : '导出'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+import { createSignal, onMount, onCleanup } from 'solid-js';
+let requestCounter = 0;
+function generateId() {
+    return `req_${++requestCounter}_${Date.now()}`;
+}
+/**
+ * Worker 线程导出管理 Primitive
+ *
+ * 接收一个 Worker 工厂函数，自动管理 Worker 生命周期和 WASM 初始化。
+ * 导出计算在 Worker 线程执行，主线程保持响应。
+ *
+ * @param createWorker - 创建 Worker 实例的工厂函数
+ */
+export function createWorkerExporter(createWorker) {
+    const [initialized, setInitialized] = createSignal(false);
+    const [loading, setLoading] = createSignal(false);
+    const [progress, setProgress] = createSignal(0);
+    const [error, setError] = createSignal(null);
+    let worker = null;
+    const pending = new Map();
+    let alive = true;
+    /** 处理 Worker 消息 */
+    const handleMessage = (event) => {
+        if (!alive)
+            return;
+        const { type, id, bytes, message, progress: prog } = event.data;
+        const req = pending.get(id);
+        if (!req)
+            return;
+        switch (type) {
+            case 'ready':
+                pending.delete(id);
+                req.resolve(new ArrayBuffer(0));
+                break;
+            case 'result':
+                pending.delete(id);
+                req.resolve(bytes);
+                break;
+            case 'error':
+                pending.delete(id);
+                req.reject(new Error(message ?? '未知错误'));
+                break;
+            case 'progress':
+                if (req.onProgress && prog !== undefined) {
+                    req.onProgress(prog);
+                }
+                break;
+        }
+    };
+    /** 处理 Worker 错误 */
+    const handleError = (event) => {
+        if (!alive)
+            return;
+        const err = new Error(`Worker 错误: ${event.message}`);
+        for (const [id, req] of pending) {
+            req.reject(err);
+            pending.delete(id);
+        }
+        setError(err);
+    };
+    onMount(() => {
+        worker = createWorker();
+        worker.addEventListener('message', handleMessage);
+        worker.addEventListener('error', handleError);
+        // 发送 init 消息
+        const id = generateId();
+        const initPromise = new Promise((resolve, reject) => {
+            pending.set(id, { resolve, reject });
+        });
+        const request = { type: 'init', id };
+        worker.postMessage(request);
+        initPromise
+            .then(() => {
+            if (alive)
+                setInitialized(true);
+        })
+            .catch((err) => {
+            if (alive)
+                setError(err instanceof Error ? err : new Error(String(err)));
+        });
+    });
+    onCleanup(() => {
+        alive = false;
+        // 拒绝所有待处理请求
+        for (const [, req] of pending) {
+            req.reject(new Error('组件已卸载'));
+        }
+        pending.clear();
+        worker?.terminate();
+        worker = null;
+    });
+    /** 向 Worker 发送生成请求 */
+    const sendGenerate = (data, options) => {
+        if (!worker)
+            return Promise.reject(new Error('Worker 未创建'));
+        return new Promise((resolve, reject) => {
+            const id = generateId();
+            pending.set(id, {
+                resolve,
+                reject,
+                onProgress: (p) => {
+                    if (alive)
+                        setProgress(p);
+                },
+            });
+            const request = {
+                type: 'generate',
+                id,
+                data,
+                options: (options ?? {}),
+            };
+            worker.postMessage(request);
+        });
+    };
+    /** 在主线程触发文件下载 */
+    const downloadFile = (bytes, filename, format) => {
+        const isXlsx = format === 1;
+        const mimeType = isXlsx
+            ? 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+            : 'text/csv;charset=utf-8';
+        const defaultExt = isXlsx ? 'xlsx' : 'csv';
+        let finalFilename = filename ?? `export.${defaultExt}`;
+        if (!finalFilename.endsWith(`.${defaultExt}`)) {
+            finalFilename = `${finalFilename}.${defaultExt}`;
+        }
+        const blob = new Blob([bytes.buffer], { type: mimeType });
+        const url = URL.createObjectURL(blob);
+        const anchor = document.createElement('a');
+        anchor.href = url;
+        anchor.download = finalFilename;
+        anchor.click();
+        setTimeout(() => URL.revokeObjectURL(url), 10_000);
+    };
+    /** 在 Worker 中生成文件并触发下载 */
+    const exportData = async (data, options) => {
+        if (!initialized())
+            return false;
+        setLoading(true);
+        setProgress(0);
+        setError(null);
+        try {
+            const buffer = await sendGenerate(data, options);
+            const bytes = new Uint8Array(buffer);
+            downloadFile(bytes, options?.filename, options?.format);
+            if (alive)
+                setProgress(100);
+            return true;
+        }
+        catch (err) {
+            if (alive)
+                setError(err instanceof Error ? err : new Error(String(err)));
+            return false;
+        }
+        finally {
+            if (alive)
+                setLoading(false);
+        }
+    };
+    /** 在 Worker 中生成文件字节（不触发下载） */
+    const generateBytes = async (data, options) => {
+        if (!initialized())
+            return null;
+        setLoading(true);
+        setProgress(0);
+        setError(null);
+        try {
+            const buffer = await sendGenerate(data, options);
+            if (alive)
+                setProgress(100);
+            return new Uint8Array(buffer);
+        }
+        catch (err) {
+            if (alive)
+                setError(err instanceof Error ? err : new Error(String(err)));
+            return null;
+        }
+        finally {
+            if (alive)
+                setLoading(false);
+        }
+    };
+    /** 手动销毁 Worker */
+    const terminate = () => {
+        for (const [, req] of pending) {
+            req.reject(new Error('Worker 已被手动销毁'));
+        }
+        pending.clear();
+        worker?.terminate();
+        worker = null;
+        if (alive)
+            setInitialized(false);
+    };
+    return {
+        initialized,
+        loading,
+        progress,
+        error,
+        exportData,
+        generateBytes,
+        terminate,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @bsg-export/solid - belobog-stellar-grid 的 Solid.js 官方封装
+ *
+ * 提供基于 Solid.js 信号的导出功能封装，简化在 Solid.js 项目中使用表格导出功能。
+ *
+ * @packageDocumentation
+ */
+export { createExporter } from './create-exporter';
+export type { CreateExporterReturn } from './create-exporter';
+export { createWorkerExporter } from './create-worker-exporter';
+export type { CreateWorkerExporterReturn } from './create-worker-exporter';
+export { ExportButton } from './ExportButton';
+export type { ExportButtonProps } from './ExportButton';
+export type { Column, MergeCellValue, CellValue, MergeableCellValue, DataRow, ExportDataOptions, SheetConfig, BatchSheetConfig, ProgressCallback, ExportTableOptions, ExportTablesXlsxOptions, ExportCsvBatchOptions, ExportXlsxBatchOptions, ExportTablesBatchOptions, } from '@bsg-export/types';
+export { ExportFormat } from '@bsg-export/types';
+//# 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;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAG3E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,YAAY,EACV,MAAM,EACN,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,OAAO,EACP,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @bsg-export/solid - belobog-stellar-grid 的 Solid.js 官方封装
+ *
+ * 提供基于 Solid.js 信号的导出功能封装，简化在 Solid.js 项目中使用表格导出功能。
+ *
+ * @packageDocumentation
+ */
+// Hook
+export { createExporter } from './create-exporter';
+export { createWorkerExporter } from './create-worker-exporter';
+// 组件
+export { ExportButton } from './ExportButton';
+export { ExportFormat } from '@bsg-export/types';

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@bsg-export/solid",
+  "version": "1.0.10",
+  "description": "belobog-stellar-grid 的 Solid.js 官方封装组件",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "belobog",
+    "stellar-grid",
+    "solid",
+    "solidjs",
+    "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/solid"
+  },
+  "peerDependencies": {
+    "belobog-stellar-grid": ">=1.0.0",
+    "solid-js": ">=1.8.0"
+  },
+  "dependencies": {
+    "@bsg-export/types": "file:../types"
+  },
+  "devDependencies": {
+    "solid-js": "^1.9.7",
+    "typescript": "^5.9.3"
+  }
+}