@bsg-export/svelte 1.0.10

package/dist/ExportButton.svelte

@@ -0,0 +1,93 @@
+<!--
+  ExportButton - 开箱即用的导出按钮组件 (Svelte 4/5)
+
+  自动管理 WASM 初始化、导出状态和进度显示。
+
+  @example
+  ```svelte
+  <script>
+  import ExportButton from '@bsg-export/svelte/ExportButton.svelte';
+  import { ExportFormat } from '@bsg-export/svelte';
+  </script>
+
+  <ExportButton tableId="my-table" filename="报表.xlsx" format={ExportFormat.Xlsx}>
+    导出 Excel
+  </ExportButton>
+  ```
+-->
+<script lang="ts">
+  import { onDestroy } from 'svelte';
+  import type { ExportFormat } from '@bsg-export/types';
+  import { createExporter } from './create-exporter';
+
+  /** 要导出的 HTML 表格元素的 ID */
+  export let tableId: string;
+  /** 导出文件名 */
+  export let filename: string | undefined = undefined;
+  /** 导出格式 */
+  export let format: ExportFormat | undefined = undefined;
+  /** 是否排除隐藏行/列 */
+  export let excludeHidden: boolean | undefined = undefined;
+  /** 是否添加 UTF-8 BOM（仅 CSV 有效） */
+  export let withBom: boolean | undefined = undefined;
+  /** 是否禁用按钮 */
+  export let disabled: boolean = false;
+  /** 初始化中的提示文本 */
+  export let initializingText: string = '初始化中...';
+  /** 导出中的提示文本（支持 {progress} 占位符） */
+  export let loadingText: string = '导出中 {progress}%';
+  /** 导出成功回调 */
+  export let onExportSuccess: (() => void) | undefined = undefined;
+  /** 导出失败回调 */
+  export let onExportError: ((error: Error) => void) | undefined = undefined;
+  /** 进度变化回调 */
+  export let onExportProgress: ((progress: number) => void) | undefined = undefined;
+
+  const store = createExporter();
+  const { initialized, loading, progress, error, exportTable } = store;
+
+  onDestroy(() => {
+    store.destroy();
+  });
+
+  // 监听错误并触发回调
+  $: if ($error && onExportError) {
+    onExportError($error);
+  }
+
+  // 监听进度变化并触发回调
+  $: if (onExportProgress) {
+    onExportProgress($progress);
+  }
+
+  $: isDisabled = disabled || !$initialized || $loading;
+
+  $: buttonText = !$initialized
+    ? initializingText
+    : $loading
+      ? loadingText.replace('{progress}', Math.round($progress).toString())
+      : undefined;
+
+  /** 处理点击 */
+  function handleClick() {
+    const success = exportTable({
+      tableId,
+      filename,
+      format,
+      excludeHidden,
+      withBom,
+    });
+
+    if (success && onExportSuccess) {
+      onExportSuccess();
+    }
+  }
+</script>
+
+<button disabled={isDisabled} on:click={handleClick} {...$$restProps}>
+  {#if buttonText}
+    {buttonText}
+  {:else}
+    <slot>导出</slot>
+  {/if}
+</button>

package/dist/ExportButton.svelte.d.ts

@@ -0,0 +1,31 @@
+import { SvelteComponent } from 'svelte';
+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;
+  /** 初始化中的提示文本 */
+  initializingText?: string;
+  /** 导出中的提示文本（支持 {progress} 占位符） */
+  loadingText?: string;
+  /** 导出成功回调 */
+  onExportSuccess?: () => void;
+  /** 导出失败回调 */
+  onExportError?: (error: Error) => void;
+  /** 进度变化回调 */
+  onExportProgress?: (progress: number) => void;
+}
+
+/** 开箱即用的导出按钮组件 */
+export default class ExportButton extends SvelteComponent<ExportButtonProps> {}

package/dist/create-exporter.d.ts

@@ -0,0 +1,57 @@
+/**
+ * createExporter - WASM 导出管理 Store
+ *
+ * 自动管理 WASM 初始化生命周期，提供类型安全的导出方法和响应式状态。
+ * 使用 Svelte store 实现响应式更新，兼容 Svelte 4 和 5。
+ *
+ * @example
+ * ```svelte
+ * <script>
+ * import { createExporter } from '@bsg-export/svelte';
+ *
+ * const { initialized, loading, progress, exportTable } = createExporter();
+ * </script>
+ *
+ * <button on:click={() => exportTable({ tableId: 'my-table', filename: '报表.xlsx' })}
+ *         disabled={!$initialized || $loading}>
+ *   {$loading ? `导出中 ${$progress}%` : '导出 Excel'}
+ * </button>
+ * ```
+ */
+import { type Readable } from 'svelte/store';
+import type { ExportDataOptions, ExportTableOptions, ExportTablesXlsxOptions, ExportCsvBatchOptions, ExportXlsxBatchOptions, ExportTablesBatchOptions, DataRow } from '@bsg-export/types';
+/** createExporter 返回值 */
+export interface ExporterStore {
+    /** WASM 是否已初始化完成 */
+    initialized: Readable<boolean>;
+    /** 是否正在导出 */
+    loading: Readable<boolean>;
+    /** 导出进度 (0-100) */
+    progress: Readable<number>;
+    /** 错误信息 */
+    error: Readable<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>;
+    /** 销毁实例，取消未完成的操作 */
+    destroy: () => void;
+}
+/**
+ * WASM 导出管理 Store
+ *
+ * 自动初始化 WASM 模块，提供类型安全的导出方法，
+ * 管理 loading / progress / error 状态。
+ *
+ * 调用 `destroy()` 以在组件卸载时停止状态更新。
+ */
+export declare function createExporter(): ExporterStore;
+//# 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;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC5D,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,aAAa;IAC5B,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;IAC3E,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AA6BD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAgK9C"}

package/dist/create-exporter.js

@@ -0,0 +1,179 @@
+/**
+ * createExporter - WASM 导出管理 Store
+ *
+ * 自动管理 WASM 初始化生命周期，提供类型安全的导出方法和响应式状态。
+ * 使用 Svelte store 实现响应式更新，兼容 Svelte 4 和 5。
+ *
+ * @example
+ * ```svelte
+ * <script>
+ * import { createExporter } from '@bsg-export/svelte';
+ *
+ * const { initialized, loading, progress, exportTable } = createExporter();
+ * </script>
+ *
+ * <button on:click={() => exportTable({ tableId: 'my-table', filename: '报表.xlsx' })}
+ *         disabled={!$initialized || $loading}>
+ *   {$loading ? `导出中 ${$progress}%` : '导出 Excel'}
+ * </button>
+ * ```
+ */
+import { writable, get } from 'svelte/store';
+/** 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 导出管理 Store
+ *
+ * 自动初始化 WASM 模块，提供类型安全的导出方法，
+ * 管理 loading / progress / error 状态。
+ *
+ * 调用 `destroy()` 以在组件卸载时停止状态更新。
+ */
+export function createExporter() {
+    const initialized = writable(false);
+    const loading = writable(false);
+    const progress = writable(0);
+    const error = writable(null);
+    let alive = true;
+    // 自动初始化 WASM
+    initWasm()
+        .then(() => {
+        if (alive)
+            initialized.set(true);
+    })
+        .catch((err) => {
+        if (alive)
+            error.set(err instanceof Error ? err : new Error(String(err)));
+    });
+    /** 创建进度回调（自动更新 progress 状态） */
+    const createProgressCallback = () => {
+        return (p) => {
+            if (alive)
+                progress.set(p);
+        };
+    };
+    /** 包装同步导出操作 */
+    const wrapSync = (fn) => {
+        if (!get(initialized) || !wasmModule)
+            return false;
+        loading.set(true);
+        progress.set(0);
+        error.set(null);
+        try {
+            fn();
+            if (alive)
+                progress.set(100);
+            return true;
+        }
+        catch (err) {
+            if (alive)
+                error.set(err instanceof Error ? err : new Error(String(err)));
+            return false;
+        }
+        finally {
+            if (alive)
+                loading.set(false);
+        }
+    };
+    /** 包装异步导出操作 */
+    const wrapAsync = async (fn) => {
+        if (!get(initialized) || !wasmModule)
+            return false;
+        loading.set(true);
+        progress.set(0);
+        error.set(null);
+        try {
+            await fn();
+            if (alive)
+                progress.set(100);
+            return true;
+        }
+        catch (err) {
+            if (alive)
+                error.set(err instanceof Error ? err : new Error(String(err)));
+            return false;
+        }
+        finally {
+            if (alive)
+                loading.set(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);
+        });
+    };
+    /** 销毁实例 */
+    const destroy = () => {
+        alive = false;
+    };
+    return {
+        initialized: { subscribe: initialized.subscribe },
+        loading: { subscribe: loading.subscribe },
+        progress: { subscribe: progress.subscribe },
+        error: { subscribe: error.subscribe },
+        exportTable,
+        exportData,
+        exportTablesXlsx,
+        exportCsvBatch,
+        exportXlsxBatch,
+        exportTablesBatch,
+        destroy,
+    };
+}

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

@@ -0,0 +1,58 @@
+/**
+ * createWorkerExporter - Worker 线程导出管理 Store
+ *
+ * 将 CSV/XLSX 生成移至 Worker 线程，主线程不阻塞。
+ * 用户需要传入一个创建 Worker 实例的工厂函数。
+ *
+ * @example
+ * ```svelte
+ * <script>
+ * import { createWorkerExporter } from '@bsg-export/svelte';
+ *
+ * // Vite
+ * import ExportWorkerScript from '@bsg-export/worker/worker?worker';
+ * const { initialized, loading, progress, exportData, destroy } =
+ *   createWorkerExporter(() => new ExportWorkerScript());
+ *
+ * // 组件卸载时调用 destroy()
+ * import { onDestroy } from 'svelte';
+ * onDestroy(() => destroy());
+ * </script>
+ *
+ * <button disabled={!$initialized || $loading}
+ *         on:click={() => exportData(data, { columns, filename: '报表.xlsx', format: 1 })}>
+ *   {$loading ? `导出中 ${Math.round($progress)}%` : '导出'}
+ * </button>
+ * ```
+ */
+import { type Readable } from 'svelte/store';
+import type { ExportDataOptions, DataRow } from '@bsg-export/types';
+/** createWorkerExporter 返回值 */
+export interface WorkerExporterStore {
+    /** Worker 中的 WASM 是否已初始化完成 */
+    initialized: Readable<boolean>;
+    /** 是否正在导出 */
+    loading: Readable<boolean>;
+    /** 导出进度 (0-100) */
+    progress: Readable<number>;
+    /** 错误信息 */
+    error: Readable<Error | null>;
+    /** 在 Worker 中生成文件并触发下载 */
+    exportData: (data: DataRow[], options?: Omit<ExportDataOptions, 'progressCallback'>) => Promise<boolean>;
+    /** 在 Worker 中生成文件字节（不触发下载） */
+    generateBytes: (data: DataRow[], options?: Omit<ExportDataOptions, 'progressCallback'>) => Promise<Uint8Array | null>;
+    /** 销毁 Worker 和清理资源 */
+    destroy: () => void;
+}
+/**
+ * Worker 线程导出管理 Store
+ *
+ * 接收一个 Worker 工厂函数，自动管理 Worker 生命周期和 WASM 初始化。
+ * 导出计算在 Worker 线程执行，主线程保持响应。
+ *
+ * 必须在组件卸载时调用 `destroy()` 清理资源。
+ *
+ * @param createWorker - 创建 Worker 实例的工厂函数
+ */
+export declare function createWorkerExporter(createWorker: () => Worker): WorkerExporterStore;
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EACV,iBAAiB,EAEjB,OAAO,EACR,MAAM,mBAAmB,CAAC;AAE3B,+BAA+B;AAC/B,MAAM,WAAW,mBAAmB;IAClC,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,sBAAsB;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAiCD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,MAAM,GAAG,mBAAmB,CA8LpF"}

package/dist/create-worker-exporter.js

@@ -0,0 +1,220 @@
+/**
+ * createWorkerExporter - Worker 线程导出管理 Store
+ *
+ * 将 CSV/XLSX 生成移至 Worker 线程，主线程不阻塞。
+ * 用户需要传入一个创建 Worker 实例的工厂函数。
+ *
+ * @example
+ * ```svelte
+ * <script>
+ * import { createWorkerExporter } from '@bsg-export/svelte';
+ *
+ * // Vite
+ * import ExportWorkerScript from '@bsg-export/worker/worker?worker';
+ * const { initialized, loading, progress, exportData, destroy } =
+ *   createWorkerExporter(() => new ExportWorkerScript());
+ *
+ * // 组件卸载时调用 destroy()
+ * import { onDestroy } from 'svelte';
+ * onDestroy(() => destroy());
+ * </script>
+ *
+ * <button disabled={!$initialized || $loading}
+ *         on:click={() => exportData(data, { columns, filename: '报表.xlsx', format: 1 })}>
+ *   {$loading ? `导出中 ${Math.round($progress)}%` : '导出'}
+ * </button>
+ * ```
+ */
+import { writable, get } from 'svelte/store';
+let requestCounter = 0;
+function generateId() {
+    return `req_${++requestCounter}_${Date.now()}`;
+}
+/**
+ * Worker 线程导出管理 Store
+ *
+ * 接收一个 Worker 工厂函数，自动管理 Worker 生命周期和 WASM 初始化。
+ * 导出计算在 Worker 线程执行，主线程保持响应。
+ *
+ * 必须在组件卸载时调用 `destroy()` 清理资源。
+ *
+ * @param createWorker - 创建 Worker 实例的工厂函数
+ */
+export function createWorkerExporter(createWorker) {
+    const initialized = writable(false);
+    const loading = writable(false);
+    const progress = writable(0);
+    const error = writable(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);
+        }
+        error.set(err);
+    };
+    // 立即创建 Worker 并初始化
+    worker = createWorker();
+    worker.addEventListener('message', handleMessage);
+    worker.addEventListener('error', handleError);
+    // 发送 init 消息
+    const initId = generateId();
+    const initPromise = new Promise((resolve, reject) => {
+        pending.set(initId, { resolve, reject });
+    });
+    const request = { type: 'init', id: initId };
+    worker.postMessage(request);
+    initPromise
+        .then(() => {
+        if (alive)
+            initialized.set(true);
+    })
+        .catch((err) => {
+        if (alive)
+            error.set(err instanceof Error ? err : new Error(String(err)));
+    });
+    /** 向 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)
+                        progress.set(p);
+                },
+            });
+            const req = {
+                type: 'generate',
+                id,
+                data,
+                options: (options ?? {}),
+            };
+            worker.postMessage(req);
+        });
+    };
+    /** 在主线程触发文件下载 */
+    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 (!get(initialized))
+            return false;
+        loading.set(true);
+        progress.set(0);
+        error.set(null);
+        try {
+            const buffer = await sendGenerate(data, options);
+            const bytes = new Uint8Array(buffer);
+            downloadFile(bytes, options?.filename, options?.format);
+            if (alive)
+                progress.set(100);
+            return true;
+        }
+        catch (err) {
+            if (alive)
+                error.set(err instanceof Error ? err : new Error(String(err)));
+            return false;
+        }
+        finally {
+            if (alive)
+                loading.set(false);
+        }
+    };
+    /** 在 Worker 中生成文件字节（不触发下载） */
+    const generateBytes = async (data, options) => {
+        if (!get(initialized))
+            return null;
+        loading.set(true);
+        progress.set(0);
+        error.set(null);
+        try {
+            const buffer = await sendGenerate(data, options);
+            if (alive)
+                progress.set(100);
+            return new Uint8Array(buffer);
+        }
+        catch (err) {
+            if (alive)
+                error.set(err instanceof Error ? err : new Error(String(err)));
+            return null;
+        }
+        finally {
+            if (alive)
+                loading.set(false);
+        }
+    };
+    /** 销毁 Worker 和清理资源 */
+    const destroy = () => {
+        alive = false;
+        // 拒绝所有待处理请求
+        for (const [, req] of pending) {
+            req.reject(new Error('组件已卸载'));
+        }
+        pending.clear();
+        worker?.terminate();
+        worker = null;
+    };
+    return {
+        initialized: { subscribe: initialized.subscribe },
+        loading: { subscribe: loading.subscribe },
+        progress: { subscribe: progress.subscribe },
+        error: { subscribe: error.subscribe },
+        exportData,
+        generateBytes,
+        destroy,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @bsg-export/svelte - belobog-stellar-grid 的 Svelte 官方封装
+ *
+ * 提供基于 Svelte store 的导出功能封装，简化在 Svelte 项目中使用表格导出功能。
+ * 兼容 Svelte 4 和 Svelte 5。
+ *
+ * @packageDocumentation
+ */
+export { createExporter } from './create-exporter';
+export type { ExporterStore } from './create-exporter';
+export { createWorkerExporter } from './create-worker-exporter';
+export type { WorkerExporterStore } from './create-worker-exporter';
+export type { ExportButtonProps } from './ExportButton.svelte';
+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;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,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,12 @@
+/**
+ * @bsg-export/svelte - belobog-stellar-grid 的 Svelte 官方封装
+ *
+ * 提供基于 Svelte store 的导出功能封装，简化在 Svelte 项目中使用表格导出功能。
+ * 兼容 Svelte 4 和 Svelte 5。
+ *
+ * @packageDocumentation
+ */
+// Store 封装
+export { createExporter } from './create-exporter';
+export { createWorkerExporter } from './create-worker-exporter';
+export { ExportFormat } from '@bsg-export/types';

package/package.json

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