@lotics/xlsx 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/xlsx",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",

package/src/csv_parser.ts

@@ -8,8 +8,12 @@ import type {
 
 const MAX_ROWS = 10_000;
 
-export async function parseCsvFile(url: string, signal?: AbortSignal): Promise<ParsedSpreadsheet> {
-  const response = await fetch(url, { signal });
+export async function parseCsvFile(
+  url: string,
+  signal?: AbortSignal,
+  credentials?: RequestCredentials,
+): Promise<ParsedSpreadsheet> {
+  const response = await fetch(url, { signal, credentials });
   if (!response.ok) {
     throw new Error(`Failed to fetch file: ${response.status} ${response.statusText}`);
   }

package/src/data_workbook.test.ts

@@ -1,8 +1,9 @@
 import { describe, it, expect } from "vitest";
-import { buildDataWorkbook } from "./data_workbook";
+import { buildDataWorkbook, buildDataSheet } from "./data_workbook";
 import { exportWorkbook } from "./xlsx_writer";
 import { parseExcelBuffer } from "./excel_parser";
 import { parseToExcelSerial } from "./numfmt_type";
+import { WorkbookModel, StyleRegistry } from "./workbook_model";
 import type { ParsedSheet, ParsedCell } from "./types";
 
 interface FeeRow {
@@ -109,3 +110,31 @@ describe("buildDataWorkbook", () => {
     expect(widths.get(2)).toBe(40); // explicit override wins
   });
 });
+
+describe("buildDataSheet", () => {
+  it("builds multiple sheets into one shared registry that round-trips with styles intact", () => {
+    // Two sheets sharing ONE registry — cell styles are stored by index into a
+    // single registry, so this is the only correct way to merge data sheets into
+    // one workbook (two buildDataWorkbook calls each mint a private registry).
+    const styles = new StyleRegistry();
+    const columns = [
+      { header: "Container", value: (r: FeeRow) => r.container },
+      { header: "Số tiền", type: "currency" as const, value: (r: FeeRow) => r.amount },
+    ];
+    const a = buildDataSheet({ sheetName: "Gate IN", currencyFormat: '#,##0" ₫"', columns, rows: [ROWS[0]] }, styles);
+    const b = buildDataSheet({ sheetName: "Gate OUT", currencyFormat: '#,##0" ₫"', columns, rows: [ROWS[1]] }, styles);
+    const wb = new WorkbookModel({ sheets: [a, b], activeSheetIndex: 0, styles });
+    const parsed = parseExcelBuffer(new Uint8Array(exportWorkbook(wb)).buffer);
+
+    expect(parsed.sheets.map((s) => s.name)).toEqual(["Gate IN", "Gate OUT"]);
+    // Each sheet's body landed on its own tab.
+    expect(cellAt(parsed.sheets[0], 2, 1)?.value).toBe("ABCD1234567");
+    expect(cellAt(parsed.sheets[0], 2, 2)?.rawValue).toBe(1_500_000);
+    expect(cellAt(parsed.sheets[1], 2, 1)?.value).toBe("WXYZ7654321");
+    // Styles resolve correctly across both sheets: bold header on sheet 2, and the
+    // currency body cell on sheet 1 keeps its right alignment (proves the shared
+    // registry's style indices are valid for every sheet, not just the first).
+    expect(cellAt(parsed.sheets[1], 1, 1)?.style?.fontBold).toBe(true);
+    expect(cellAt(parsed.sheets[0], 2, 2)?.style?.horizontalAlign).toBe("right");
+  });
+});

package/src/data_workbook.ts

@@ -123,23 +123,21 @@ function clampWidth(chars: number): number {
 }
 
 /**
- * Build a single-sheet workbook from typed columns + rows.
+ * Build ONE styled data sheet from typed columns + rows into a caller-supplied
+ * style registry. Use this when assembling a multi-sheet workbook so every sheet
+ * shares one registry (cell styles are stored by index into a single registry —
+ * sheets built against different registries cannot be merged). For the common
+ * single-sheet case use {@link buildDataWorkbook}.
  *
  * ```ts
- * const wb = buildDataWorkbook({
- *   sheetName: "Phí",
- *   currencyFormat: '#,##0" ₫"',
- *   columns: [
- *     { header: "Container", value: (r) => r.container },
- *     { header: "Ngày", type: "date", value: (r) => r.date },
- *     { header: "Số tiền", type: "currency", value: (r) => r.amount },
- *   ],
- *   rows,
- * });
+ * const styles = new StyleRegistry();
+ * const a = buildDataSheet({ sheetName: "A", columns, rows: rowsA }, styles);
+ * const b = buildDataSheet({ sheetName: "B", columns, rows: rowsB }, styles);
+ * const wb = new WorkbookModel({ sheets: [a, b], activeSheetIndex: 0, styles });
  * const bytes = exportWorkbook(wb);
  * ```
  */
-export function buildDataWorkbook<R>(opts: BuildDataWorkbookOptions<R>): WorkbookModel {
+export function buildDataSheet<R>(opts: BuildDataWorkbookOptions<R>, styles: StyleRegistry): SheetModel {
   const {
     columns,
     rows,
@@ -149,7 +147,6 @@ export function buildDataWorkbook<R>(opts: BuildDataWorkbookOptions<R>): Workboo
     headerStyle = DEFAULT_HEADER_STYLE,
   } = opts;
 
-  const styles = new StyleRegistry();
   const sheet = new SheetModel(sanitizeSheetName(sheetName), styles);
 
   // Per-type body cell style (interned once each via the StyleRegistry).
@@ -182,5 +179,28 @@ export function buildDataWorkbook<R>(opts: BuildDataWorkbookOptions<R>): Workboo
   // Freeze the header row.
   if (rows.length > 0 || columns.length > 0) sheet.setFreeze("A2");
 
+  return sheet;
+}
+
+/**
+ * Build a single-sheet workbook from typed columns + rows.
+ *
+ * ```ts
+ * const wb = buildDataWorkbook({
+ *   sheetName: "Phí",
+ *   currencyFormat: '#,##0" ₫"',
+ *   columns: [
+ *     { header: "Container", value: (r) => r.container },
+ *     { header: "Ngày", type: "date", value: (r) => r.date },
+ *     { header: "Số tiền", type: "currency", value: (r) => r.amount },
+ *   ],
+ *   rows,
+ * });
+ * const bytes = exportWorkbook(wb);
+ * ```
+ */
+export function buildDataWorkbook<R>(opts: BuildDataWorkbookOptions<R>): WorkbookModel {
+  const styles = new StyleRegistry();
+  const sheet = buildDataSheet(opts, styles);
   return new WorkbookModel({ sheets: [sheet], activeSheetIndex: 0, styles });
 }

package/src/index.ts

@@ -106,7 +106,7 @@ export { exportWorkbook } from "./xlsx_writer";
 // Data → workbook (the common "rows in, .xlsx out" helper)
 // -----------------------------------------------------------------------------
 
-export { buildDataWorkbook } from "./data_workbook";
+export { buildDataWorkbook, buildDataSheet } from "./data_workbook";
 export type { DataColumn, DataColumnType, BuildDataWorkbookOptions } from "./data_workbook";
 
 export { unzipXlsx } from "./ooxml_zip";