@topgrid/grid-export 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 import { Table } from '@tanstack/react-table';
-import { E as ExcelExportOptions, C as CSVExportOptions, P as PDFExportOptions, a as ClipboardOptions, b as PrintOptions, c as ExcelColumn, d as ExportRowsOptions } from './types-BCeqH-13.cjs';
-export { D as DownloadExcelOptions, e as EmptyBehavior, f as ExportScope } from './types-BCeqH-13.cjs';
+import { E as ExcelExportOptions, C as CSVExportOptions, P as PDFExportOptions, a as ClipboardOptions, b as PrintOptions, c as ExcelColumn, d as ExportRowsOptions, e as ExcelSheet, M as MultiSheetOptions } from './types-yAFLGyyY.cjs';
+export { D as DownloadExcelOptions, f as EmptyBehavior, g as ExportScope } from './types-yAFLGyyY.cjs';
 
 /**
  * TanStack Table 인스턴스를 기반으로 Excel(.xlsx) 파일을 생성·다운로드한다.
  *
  * @param table - TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
- * @param options - Excel export 옵션 (fileName, sheetName, scope, emptyBehavior)
+ * @param options - Excel export 옵션 (fileName, sheetName, scope, emptyBehavior, columnFormats, columnWidths)
  * @returns void (동기 실행 — xlsx.writeFile 동기 API, D3)
  *
  * @remarks
@@ -14,6 +14,10 @@ export { D as DownloadExcelOptions, e as EmptyBehavior, f as ExportScope } from
  * xlsx.writeFile 이 동기 실행되어 브라우저 메인 스레드를 블로킹할 수 있습니다.
  * 대용량 사용 시 Web Worker 래핑 권장 (EC-05).
  *
+ * **셀 서식(MOD-GRID-25)**: `columnFormats` 는 네이티브 Excel number-format(`.z`)을 적용해
+ * 셀이 Excel 안에서 numeric·정렬가능하게 유지됩니다. 폰트/배경색은 community
+ * `xlsx@0.18.5` 가 write 시 미지원(round-trip 시 스트립)이라 제공하지 않습니다.
+ *
  * @example
  * // 기본 사용 (filtered 행)
  * exportToExcel(table, { fileName: '데이터.xlsx' });
@@ -26,6 +30,13 @@ export { D as DownloadExcelOptions, e as EmptyBehavior, f as ExportScope } from
  *   scope: 'selected',
  *   emptyBehavior: 'empty',
  * });
+ *
+ * @example
+ * // 네이티브 숫자서식 + 컬럼 폭
+ * exportToExcel(table, {
+ *   columnFormats: { price: '#,##0.00', orderedAt: 'yyyy-mm-dd' },
+ *   columnWidths: { name: 30 },
+ * });
  */
 declare function exportToExcel<TData>(table: Table<TData>, options?: ExcelExportOptions): void;
 
@@ -135,4 +146,69 @@ declare function printGrid<TData>(table: Table<TData>, options?: PrintOptions):
  */
 declare function exportRowsToExcel<TData extends Record<string, unknown>>(rows: TData[], columns: ExcelColumn[], options?: ExportRowsOptions): void;
 
-export { CSVExportOptions, ClipboardOptions, ExcelColumn, ExcelExportOptions, ExportRowsOptions, PDFExportOptions, PrintOptions, copyToClipboard, exportRowsToExcel, exportToCSV, exportToExcel, exportToPdf, printGrid };
+/**
+ * 여러 TanStack Table 을 **하나의 Excel 워크북**(여러 시트)으로 export·다운로드한다.
+ * (MOD-GRID-25 G-2 — AG Grid/DevExpress 다중 시트 export 격차 해소)
+ *
+ * 각 시트는 `exportToExcel`(단일 시트)과 동일한 빌더(`buildGridWorksheet`)를 재사용하므로
+ * 헤더 merge·scope·네이티브 숫자서식(`.z`)·컬럼 폭 동작이 단일 시트와 일관된다.
+ *
+ * @param sheets  시트 정의 배열 (`{ name, table, scope?, columnFormats?, columnWidths? }`)
+ * @param options 파일명 옵션
+ * @returns void (동기 — xlsx.writeFile)
+ *
+ * @example
+ * exportSheetsToExcel(
+ *   [
+ *     { name: '주문', table: ordersTable, columnFormats: { total: '#,##0' } },
+ *     { name: '고객', table: customersTable, scope: 'selected' },
+ *   ],
+ *   { fileName: '월간보고.xlsx' },
+ * );
+ */
+declare function exportSheetsToExcel(sheets: ExcelSheet[], options?: MultiSheetOptions): void;
+
+/**
+ * @topgrid/grid-export — sheet ↔ .xlsx bridge (MOD-GRID-69).
+ *
+ * Import/export a spreadsheet **with formulas** to/from `.xlsx`. The pinned community `xlsx@0.18.5`
+ * round-trips cell formulas (`.f`) losslessly (probe-verified) — only cell *styles* (`.s`) are
+ * stripped on write (that is the separate "Excel cell styles" gap, out of scope; see MOD-25 LESS-004).
+ *
+ * The bridge is lib-agnostic of grid-pro-sheet: it operates on a plain `Record<cellRef, rawString>`
+ * where a raw string is either a formula (`"=A1+A2"`) or a literal (`"10"`, `"hi"`) — exactly the
+ * `createSheet` `setCell(ref, raw)` / `getRaw(ref)` contract. The consumer wires it to the engine.
+ */
+/** A worksheet cell as understood by the xlsx lib (the subset this bridge reads/writes). */
+interface XlsxCell {
+    /** Cell type: `'n'` number, `'s'` string, `'b'` boolean. */
+    t: 'n' | 's' | 'b';
+    /** Literal value (absent/ignored when `f` is the source of truth for display). */
+    v?: number | string | boolean;
+    /** Formula text WITHOUT the leading `=` (xlsx convention). */
+    f?: string;
+}
+/**
+ * Pure: a sheet raw input (`"=A1+A2"` | `"10"` | `"hi"`) → an xlsx cell object.
+ *
+ * A formula cell **must carry a cached value** (`v`) or the lib drops it on write (probe-verified),
+ * so `computed` (the engine's displayed value, from `getDisplay`) is written as the cache. Without
+ * it, a fallback `v: 0` keeps the formula (Excel recalculates on open). Value cells ignore `computed`.
+ */
+declare function sheetRawToXlsxCell(raw: string, computed?: string | number): XlsxCell;
+/** Pure: an xlsx cell → a sheet raw input. Formula cells become `"=…"`; value cells stringify. */
+declare function xlsxCellToSheetRaw(cell: XlsxCell): string;
+/**
+ * Build an `.xlsx` workbook from a sheet cell map and (in a browser/node) trigger a download / write.
+ * Formula cells are written as `.f` (preserved by the lib). Returns nothing — side-effecting write.
+ */
+declare function exportSheetCellsToXlsx(cells: Record<string, string>, computed?: Record<string, string | number>, fileName?: string, sheetName?: string): void;
+/** Build an `.xlsx` workbook as a Uint8Array buffer (node-testable; no file I/O). */
+declare function exportSheetCellsToXlsxBuffer(cells: Record<string, string>, computed?: Record<string, string | number>, sheetName?: string): Uint8Array;
+/**
+ * Parse an `.xlsx` (the first worksheet) into a sheet cell map. Formula cells become `"=…"` raws so
+ * the sheet engine re-evaluates them; value cells stringify. Feeds `createSheet` via `setCell`.
+ */
+declare function importXlsxToSheetCells(data: ArrayBuffer | Uint8Array): Record<string, string>;
+
+export { CSVExportOptions, ClipboardOptions, ExcelColumn, ExcelExportOptions, ExcelSheet, ExportRowsOptions, MultiSheetOptions, PDFExportOptions, PrintOptions, type XlsxCell, copyToClipboard, exportRowsToExcel, exportSheetCellsToXlsx, exportSheetCellsToXlsxBuffer, exportSheetsToExcel, exportToCSV, exportToExcel, exportToPdf, importXlsxToSheetCells, printGrid, sheetRawToXlsxCell, xlsxCellToSheetRaw };

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 import { Table } from '@tanstack/react-table';
-import { E as ExcelExportOptions, C as CSVExportOptions, P as PDFExportOptions, a as ClipboardOptions, b as PrintOptions, c as ExcelColumn, d as ExportRowsOptions } from './types-BCeqH-13.js';
-export { D as DownloadExcelOptions, e as EmptyBehavior, f as ExportScope } from './types-BCeqH-13.js';
+import { E as ExcelExportOptions, C as CSVExportOptions, P as PDFExportOptions, a as ClipboardOptions, b as PrintOptions, c as ExcelColumn, d as ExportRowsOptions, e as ExcelSheet, M as MultiSheetOptions } from './types-yAFLGyyY.js';
+export { D as DownloadExcelOptions, f as EmptyBehavior, g as ExportScope } from './types-yAFLGyyY.js';
 
 /**
  * TanStack Table 인스턴스를 기반으로 Excel(.xlsx) 파일을 생성·다운로드한다.
  *
  * @param table - TanStack v8 Table<TData> 인스턴스 (useReactTable 반환값)
- * @param options - Excel export 옵션 (fileName, sheetName, scope, emptyBehavior)
+ * @param options - Excel export 옵션 (fileName, sheetName, scope, emptyBehavior, columnFormats, columnWidths)
  * @returns void (동기 실행 — xlsx.writeFile 동기 API, D3)
  *
  * @remarks
@@ -14,6 +14,10 @@ export { D as DownloadExcelOptions, e as EmptyBehavior, f as ExportScope } from
  * xlsx.writeFile 이 동기 실행되어 브라우저 메인 스레드를 블로킹할 수 있습니다.
  * 대용량 사용 시 Web Worker 래핑 권장 (EC-05).
  *
+ * **셀 서식(MOD-GRID-25)**: `columnFormats` 는 네이티브 Excel number-format(`.z`)을 적용해
+ * 셀이 Excel 안에서 numeric·정렬가능하게 유지됩니다. 폰트/배경색은 community
+ * `xlsx@0.18.5` 가 write 시 미지원(round-trip 시 스트립)이라 제공하지 않습니다.
+ *
  * @example
  * // 기본 사용 (filtered 행)
  * exportToExcel(table, { fileName: '데이터.xlsx' });
@@ -26,6 +30,13 @@ export { D as DownloadExcelOptions, e as EmptyBehavior, f as ExportScope } from
  *   scope: 'selected',
  *   emptyBehavior: 'empty',
  * });
+ *
+ * @example
+ * // 네이티브 숫자서식 + 컬럼 폭
+ * exportToExcel(table, {
+ *   columnFormats: { price: '#,##0.00', orderedAt: 'yyyy-mm-dd' },
+ *   columnWidths: { name: 30 },
+ * });
  */
 declare function exportToExcel<TData>(table: Table<TData>, options?: ExcelExportOptions): void;
 
@@ -135,4 +146,69 @@ declare function printGrid<TData>(table: Table<TData>, options?: PrintOptions):
  */
 declare function exportRowsToExcel<TData extends Record<string, unknown>>(rows: TData[], columns: ExcelColumn[], options?: ExportRowsOptions): void;
 
-export { CSVExportOptions, ClipboardOptions, ExcelColumn, ExcelExportOptions, ExportRowsOptions, PDFExportOptions, PrintOptions, copyToClipboard, exportRowsToExcel, exportToCSV, exportToExcel, exportToPdf, printGrid };
+/**
+ * 여러 TanStack Table 을 **하나의 Excel 워크북**(여러 시트)으로 export·다운로드한다.
+ * (MOD-GRID-25 G-2 — AG Grid/DevExpress 다중 시트 export 격차 해소)
+ *
+ * 각 시트는 `exportToExcel`(단일 시트)과 동일한 빌더(`buildGridWorksheet`)를 재사용하므로
+ * 헤더 merge·scope·네이티브 숫자서식(`.z`)·컬럼 폭 동작이 단일 시트와 일관된다.
+ *
+ * @param sheets  시트 정의 배열 (`{ name, table, scope?, columnFormats?, columnWidths? }`)
+ * @param options 파일명 옵션
+ * @returns void (동기 — xlsx.writeFile)
+ *
+ * @example
+ * exportSheetsToExcel(
+ *   [
+ *     { name: '주문', table: ordersTable, columnFormats: { total: '#,##0' } },
+ *     { name: '고객', table: customersTable, scope: 'selected' },
+ *   ],
+ *   { fileName: '월간보고.xlsx' },
+ * );
+ */
+declare function exportSheetsToExcel(sheets: ExcelSheet[], options?: MultiSheetOptions): void;
+
+/**
+ * @topgrid/grid-export — sheet ↔ .xlsx bridge (MOD-GRID-69).
+ *
+ * Import/export a spreadsheet **with formulas** to/from `.xlsx`. The pinned community `xlsx@0.18.5`
+ * round-trips cell formulas (`.f`) losslessly (probe-verified) — only cell *styles* (`.s`) are
+ * stripped on write (that is the separate "Excel cell styles" gap, out of scope; see MOD-25 LESS-004).
+ *
+ * The bridge is lib-agnostic of grid-pro-sheet: it operates on a plain `Record<cellRef, rawString>`
+ * where a raw string is either a formula (`"=A1+A2"`) or a literal (`"10"`, `"hi"`) — exactly the
+ * `createSheet` `setCell(ref, raw)` / `getRaw(ref)` contract. The consumer wires it to the engine.
+ */
+/** A worksheet cell as understood by the xlsx lib (the subset this bridge reads/writes). */
+interface XlsxCell {
+    /** Cell type: `'n'` number, `'s'` string, `'b'` boolean. */
+    t: 'n' | 's' | 'b';
+    /** Literal value (absent/ignored when `f` is the source of truth for display). */
+    v?: number | string | boolean;
+    /** Formula text WITHOUT the leading `=` (xlsx convention). */
+    f?: string;
+}
+/**
+ * Pure: a sheet raw input (`"=A1+A2"` | `"10"` | `"hi"`) → an xlsx cell object.
+ *
+ * A formula cell **must carry a cached value** (`v`) or the lib drops it on write (probe-verified),
+ * so `computed` (the engine's displayed value, from `getDisplay`) is written as the cache. Without
+ * it, a fallback `v: 0` keeps the formula (Excel recalculates on open). Value cells ignore `computed`.
+ */
+declare function sheetRawToXlsxCell(raw: string, computed?: string | number): XlsxCell;
+/** Pure: an xlsx cell → a sheet raw input. Formula cells become `"=…"`; value cells stringify. */
+declare function xlsxCellToSheetRaw(cell: XlsxCell): string;
+/**
+ * Build an `.xlsx` workbook from a sheet cell map and (in a browser/node) trigger a download / write.
+ * Formula cells are written as `.f` (preserved by the lib). Returns nothing — side-effecting write.
+ */
+declare function exportSheetCellsToXlsx(cells: Record<string, string>, computed?: Record<string, string | number>, fileName?: string, sheetName?: string): void;
+/** Build an `.xlsx` workbook as a Uint8Array buffer (node-testable; no file I/O). */
+declare function exportSheetCellsToXlsxBuffer(cells: Record<string, string>, computed?: Record<string, string | number>, sheetName?: string): Uint8Array;
+/**
+ * Parse an `.xlsx` (the first worksheet) into a sheet cell map. Formula cells become `"=…"` raws so
+ * the sheet engine re-evaluates them; value cells stringify. Feeds `createSheet` via `setCell`.
+ */
+declare function importXlsxToSheetCells(data: ArrayBuffer | Uint8Array): Record<string, string>;
+
+export { CSVExportOptions, ClipboardOptions, ExcelColumn, ExcelExportOptions, ExcelSheet, ExportRowsOptions, MultiSheetOptions, PDFExportOptions, PrintOptions, type XlsxCell, copyToClipboard, exportRowsToExcel, exportSheetCellsToXlsx, exportSheetCellsToXlsxBuffer, exportSheetsToExcel, exportToCSV, exportToExcel, exportToPdf, importXlsxToSheetCells, printGrid, sheetRawToXlsxCell, xlsxCellToSheetRaw };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import * as XLSX2 from 'xlsx';
+import * as XLSX6 from 'xlsx';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -35,8 +35,6 @@ function getRowsByScope(table, scope) {
   }
   return table.getFilteredRowModel().rows;
 }
-
-// src/exportToExcel.ts
 function resolveHeaderText(headerValue) {
   if (typeof headerValue === "string") {
     return headerValue;
@@ -89,12 +87,56 @@ function buildHeaderRows(table) {
   }
   return { headerRows, merges };
 }
+function buildGridWorksheet(params) {
+  const {
+    headerRows,
+    merges,
+    dataRows,
+    leafColumnIds,
+    columnFormats,
+    columnWidths
+  } = params;
+  const aoa = [...headerRows, ...dataRows];
+  const ws = XLSX6.utils.aoa_to_sheet(aoa);
+  if (merges.length > 0) {
+    ws["!merges"] = merges;
+  }
+  if (columnFormats) {
+    const headerOffset = headerRows.length;
+    for (let c = 0; c < leafColumnIds.length; c++) {
+      const fmt = columnFormats[leafColumnIds[c]];
+      if (!fmt) continue;
+      for (let r = 0; r < dataRows.length; r++) {
+        const addr = XLSX6.utils.encode_cell({ r: headerOffset + r, c });
+        const cell = ws[addr];
+        if (cell && cell.t === "n") {
+          cell.z = fmt;
+        }
+      }
+    }
+  }
+  if (columnWidths) {
+    const hasAny = leafColumnIds.some(
+      (id) => columnWidths[id] !== void 0
+    );
+    if (hasAny) {
+      ws["!cols"] = leafColumnIds.map(
+        (id) => columnWidths[id] !== void 0 ? { wch: columnWidths[id] } : {}
+      );
+    }
+  }
+  return ws;
+}
+
+// src/exportToExcel.ts
 function exportToExcel(table, options) {
   const {
     fileName = "export.xlsx",
     sheetName = "Sheet1",
     scope = "filtered",
-    emptyBehavior = "skip"
+    emptyBehavior = "skip",
+    columnFormats,
+    columnWidths
   } = options ?? {};
   const rows = getRowsByScope(table, scope);
   if (rows.length === 0 && emptyBehavior === "skip") {
@@ -108,15 +150,19 @@ function exportToExcel(table, options) {
       return value !== void 0 && value !== null ? value : "";
     })
   );
-  const aoa = [...headerRows, ...dataRows];
-  const ws = XLSX2.utils.aoa_to_sheet(aoa);
-  if (merges.length > 0) {
-    ws["!merges"] = merges;
-  }
-  const wb = XLSX2.utils.book_new();
-  XLSX2.utils.book_append_sheet(wb, ws, sheetName);
+  const leafColumnIds = table.getVisibleLeafColumns().map((c) => c.id);
+  const ws = buildGridWorksheet({
+    headerRows,
+    merges,
+    dataRows,
+    leafColumnIds,
+    columnFormats,
+    columnWidths
+  });
+  const wb = XLSX6.utils.book_new();
+  XLSX6.utils.book_append_sheet(wb, ws, sheetName);
   const finalFileName = fileName.endsWith(".xlsx") ? fileName : `${fileName}.xlsx`;
-  XLSX2.writeFile(wb, finalFileName);
+  XLSX6.writeFile(wb, finalFileName);
 }
 
 // src/exportToCSV.ts
@@ -229,7 +275,11 @@ function escapeTsvValue(value) {
   return value.replace(/[\t\r\n]/g, " ");
 }
 async function copyToClipboard(table, options) {
-  const { scope = "filtered", emptyBehavior = "skip" } = options ?? {};
+  const {
+    scope = "filtered",
+    emptyBehavior = "skip",
+    includeHeader = true
+  } = options ?? {};
   const rows = getRowsByScope(table, scope);
   if (rows.length === 0 && emptyBehavior === "skip") {
     console.warn("[grid-export] copyToClipboard: \uB0B4\uBCF4\uB0BC \uB370\uC774\uD130\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
@@ -248,7 +298,9 @@ async function copyToClipboard(table, options) {
       return escapeTsvValue(str);
     }).join("	")
   );
-  const tsvString = [headerRow, ...dataRows].join("\n");
+  const tsvString = (includeHeader ? [headerRow, ...dataRows] : dataRows).join(
+    "\n"
+  );
   if (typeof navigator !== "undefined" && navigator.clipboard && typeof navigator.clipboard.writeText === "function") {
     await navigator.clipboard.writeText(tsvString);
   } else {
@@ -362,20 +414,106 @@ function exportRowsToExcel(rows, columns, options) {
     (row) => columns.map((col) => formatValue(row[col.key], col.format))
   );
   const aoa = rows.length === 0 ? [header] : [header, ...dataRows];
-  const ws = XLSX2.utils.aoa_to_sheet(aoa);
+  const ws = XLSX6.utils.aoa_to_sheet(aoa);
   ws["!cols"] = columns.map((c) => ({ wch: c.width ?? 15 }));
-  const headerRange = XLSX2.utils.decode_range(ws["!ref"] ?? "A1");
+  const headerRange = XLSX6.utils.decode_range(ws["!ref"] ?? "A1");
   for (let c = headerRange.s.c; c <= headerRange.e.c; c++) {
-    const cellAddr = XLSX2.utils.encode_cell({ r: 0, c });
+    const cellAddr = XLSX6.utils.encode_cell({ r: 0, c });
     if (!ws[cellAddr]) continue;
     ws[cellAddr].s = { font: { bold: true }, fill: { fgColor: { rgb: "F3F4F6" } } };
   }
-  const wb = XLSX2.utils.book_new();
-  XLSX2.utils.book_append_sheet(wb, ws, sheetName);
+  const wb = XLSX6.utils.book_new();
+  XLSX6.utils.book_append_sheet(wb, ws, sheetName);
   const ext = fileName.endsWith(".xlsx") ? fileName : `${fileName}.xlsx`;
-  XLSX2.writeFile(wb, ext);
+  XLSX6.writeFile(wb, ext);
+}
+function exportSheetsToExcel(sheets, options) {
+  const { fileName = "export.xlsx" } = options ?? {};
+  if (sheets.length === 0) {
+    console.warn("[grid-export] exportSheetsToExcel: \uC2DC\uD2B8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  const wb = XLSX6.utils.book_new();
+  for (const sheet of sheets) {
+    const { name, table, scope = "filtered", columnFormats, columnWidths } = sheet;
+    const rows = getRowsByScope(table, scope);
+    const { headerRows, merges } = buildHeaderRows(table);
+    const dataRows = rows.map(
+      (row) => row.getVisibleCells().map((cell) => {
+        const value = cell.getValue();
+        return value !== void 0 && value !== null ? value : "";
+      })
+    );
+    const leafColumnIds = table.getVisibleLeafColumns().map((c) => c.id);
+    const ws = buildGridWorksheet({
+      headerRows,
+      merges,
+      dataRows,
+      leafColumnIds,
+      columnFormats,
+      columnWidths
+    });
+    XLSX6.utils.book_append_sheet(wb, ws, name);
+  }
+  const finalFileName = fileName.endsWith(".xlsx") ? fileName : `${fileName}.xlsx`;
+  XLSX6.writeFile(wb, finalFileName);
+}
+function sheetRawToXlsxCell(raw, computed) {
+  if (raw.startsWith("=")) {
+    const f = raw.slice(1);
+    if (computed === void 0) return { t: "n", f, v: 0 };
+    const num = Number(computed);
+    return computed !== "" && !Number.isNaN(num) ? { t: "n", f, v: num } : { t: "s", f, v: String(computed) };
+  }
+  if (raw !== "" && !Number.isNaN(Number(raw))) {
+    return { t: "n", v: Number(raw) };
+  }
+  return { t: "s", v: raw };
+}
+function xlsxCellToSheetRaw(cell) {
+  if (cell.f !== void 0 && cell.f !== "") return `=${cell.f}`;
+  if (cell.v === void 0 || cell.v === null) return "";
+  return String(cell.v);
+}
+function exportSheetCellsToXlsx(cells, computed, fileName = "sheet.xlsx", sheetName = "Sheet1") {
+  const ws = buildWorksheet(cells, computed);
+  const wb = XLSX6.utils.book_new();
+  XLSX6.utils.book_append_sheet(wb, ws, sheetName);
+  XLSX6.writeFile(wb, fileName.endsWith(".xlsx") ? fileName : `${fileName}.xlsx`);
+}
+function exportSheetCellsToXlsxBuffer(cells, computed, sheetName = "Sheet1") {
+  const ws = buildWorksheet(cells, computed);
+  const wb = XLSX6.utils.book_new();
+  XLSX6.utils.book_append_sheet(wb, ws, sheetName);
+  return new Uint8Array(XLSX6.write(wb, { type: "array", bookType: "xlsx" }));
+}
+function importXlsxToSheetCells(data) {
+  const wb = XLSX6.read(data, { type: "array" });
+  const firstSheet = wb.SheetNames[0];
+  const out = {};
+  if (firstSheet === void 0) return out;
+  const ws = wb.Sheets[firstSheet];
+  if (ws === void 0) return out;
+  for (const ref of Object.keys(ws)) {
+    if (ref.startsWith("!")) continue;
+    out[ref] = xlsxCellToSheetRaw(ws[ref]);
+  }
+  return out;
+}
+function buildWorksheet(cells, computed) {
+  const ws = {};
+  let maxRow = 0;
+  let maxCol = 0;
+  for (const ref of Object.keys(cells)) {
+    const decoded = XLSX6.utils.decode_cell(ref);
+    if (decoded.r > maxRow) maxRow = decoded.r;
+    if (decoded.c > maxCol) maxCol = decoded.c;
+    ws[ref] = sheetRawToXlsxCell(cells[ref], computed?.[ref]);
+  }
+  ws["!ref"] = XLSX6.utils.encode_range({ s: { r: 0, c: 0 }, e: { r: maxRow, c: maxCol } });
+  return ws;
 }
 
-export { copyToClipboard, exportRowsToExcel, exportToCSV, exportToExcel, exportToPdf, printGrid };
+export { copyToClipboard, exportRowsToExcel, exportSheetCellsToXlsx, exportSheetCellsToXlsxBuffer, exportSheetsToExcel, exportToCSV, exportToExcel, exportToPdf, importXlsxToSheetCells, printGrid, sheetRawToXlsxCell, xlsxCellToSheetRaw };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map