@startsimpli/ui 0.4.168 → 0.4.169

package/src/utils/index.ts

@@ -8,6 +8,7 @@ export {
   downloadBlob,
   type CsvColumn,
 } from './csv'
+export { xlsxFromRows, downloadXlsx, XLSX_MIME, type XlsxCell } from './xlsx'
 
 /**
  * Generate a random ID with optional prefix

package/src/utils/xlsx.ts

@@ -0,0 +1,35 @@
+import * as XLSX from 'xlsx'
+import { downloadBlob } from './csv'
+
+/**
+ * A spreadsheet from rows, written so a spreadsheet can use it.
+ *
+ * Numbers stay numbers (a total column can be summed), strings stay strings -
+ * a `=...` string is stored as text, never as a formula, so no guard prefix is
+ * needed here (the CSV writer needs one; this format has a cell type for text).
+ * Returns the bytes so a test, a server or a download can all consume it;
+ * `downloadXlsx` is the thin browser wrapper. Pairs with `csvFromRows`: give
+ * both the same matrix and the two files hold the same values.
+ *
+ * Uses `xlsx` (SheetJS), already a dependency of this package for the table
+ * export. Only the write path is used; the parse path with the published
+ * advisories is not reachable from here.
+ */
+export type XlsxCell = string | number | boolean | null
+
+export function xlsxFromRows(rows: XlsxCell[][], opts: { sheetName?: string } = {}): Uint8Array {
+  const ws = XLSX.utils.aoa_to_sheet(rows)
+  const widths = rows[0]?.map((_, i) => ({
+    wch: Math.min(50, Math.max(...rows.map((r) => String(r[i] ?? '').length)) + 2),
+  }))
+  if (widths) ws['!cols'] = widths
+  const wb = XLSX.utils.book_new()
+  XLSX.utils.book_append_sheet(wb, ws, (opts.sheetName ?? 'Sheet1').slice(0, 31))
+  return new Uint8Array(XLSX.write(wb, { bookType: 'xlsx', type: 'array' }))
+}
+
+export const XLSX_MIME = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+
+export function downloadXlsx(filename: string, rows: XlsxCell[][], opts: { sheetName?: string } = {}): void {
+  downloadBlob(filename, new Blob([xlsxFromRows(rows, opts) as BlobPart], { type: XLSX_MIME }))
+}