@justybase/spreadsheet-tasks 1.1.1 → 1.3.0

package/README.md

@@ -30,6 +30,42 @@ A high-performance TypeScript library for reading and writing Excel files in XLS
 npm install @justybase/spreadsheet-tasks
 ```
 
+## 🌐 Browser Support & CDN (Zero Dependencies)
+
+This library includes browser-compatible modules to generate XLSB and XLSX files directly on the client side without relying on Node.js APIs or external dependencies.
+
+To bundle the browser version into a single minified file (e.g. for deployment to a CDN), run the following command in the project root:
+
+```bash
+npx esbuild browser/browser-spreadsheet.js --bundle --minify --format=esm --outfile=browser/justybase-spreadsheet.min.js
+```
+
+You can then import this single file via a script tag in any web application:
+
+```html
+<script type="module">
+  import { downloadXlsb, downloadXlsx } from 'https://your-cdn.com/justybase-spreadsheet.min.js';
+  
+  const headers = ["ID", "Name", "Score"];
+  const rows = [
+    [1, "Alice", 99.5],
+    [2, "Bob", 88.0]
+  ];
+  
+  // Generates the file and triggers the browser download automatically
+  document.getElementById('downloadBtn').addEventListener('click', () => {
+    downloadXlsb('report.xlsb', rows, headers, { headerStyle: 'bold+fill' });
+  });
+</script>
+```
+
+**Features included in the browser build:**
+- Built-in Zip archiving (no external libraries needed)
+- Memory-efficient `Uint8Array` buffer handling
+- Auto-fitted column widths
+- Frozen and styled headers (styles: `bold`, `fill`, `bold+fill`)
+- Auto-filters enabled by default
+
 ## 🔧 Quick Start
 
 ### Writing Excel Files

package/dist/Formats.d.ts

@@ -0,0 +1,34 @@
+export interface FormattedCell {
+    value: any;
+    format: string;
+}
+export declare const F: {
+    THOUSANDS_SEP: string;
+    CURRENCY_PLN: string;
+    CURRENCY_EUR: string;
+    PERCENTAGE: string;
+    SCIENTIFIC: string;
+    TWO_DECIMALS: string;
+    TEXT: string;
+    LEADING_ZEROS: string;
+    DATE_SHORT: string;
+    DATE_LONG: string;
+    DATE_DAY_MONTH_YEAR: string;
+    DATE_ISO: string;
+    DATE_MONTH_YEAR: string;
+    DATE_WEEKDAY: string;
+    DATE_DAY_MONTH: string;
+    DATE_YEAR_ONLY: string;
+    DATETIME_SHORT: string;
+    DATETIME_LONG: string;
+    TIME_HH_MM: string;
+    TIME_HH_MM_SS: string;
+    TIME_12H: string;
+    DATETIME_24H: string;
+    DATETIME_ISO: string;
+    TIME_MS: string;
+};
+export declare function isFormattedCell(val: any): val is FormattedCell;
+export declare function unwrapCell(val: any): any;
+export declare function getFormat(val: any): string | null;
+//# sourceMappingURL=Formats.d.ts.map

package/dist/Formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Formats.d.ts","sourceRoot":"","sources":["../src/Formats.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;CA2Bb,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,aAAa,CAE9D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAKxC;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAKjD"}

package/dist/Formats.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.F = void 0;
+exports.isFormattedCell = isFormattedCell;
+exports.unwrapCell = unwrapCell;
+exports.getFormat = getFormat;
+exports.F = {
+    THOUSANDS_SEP: '#,##0',
+    CURRENCY_PLN: '#,##0.00 "z\u0142"',
+    CURRENCY_EUR: '#,##0.00 \u20AC',
+    PERCENTAGE: '0%',
+    SCIENTIFIC: '0.00E+00',
+    TWO_DECIMALS: '#,##0.00',
+    TEXT: '@',
+    LEADING_ZEROS: '000000000',
+    DATE_SHORT: 'dd.mm.yyyy',
+    DATE_LONG: 'd mmmm yyyy',
+    DATE_DAY_MONTH_YEAR: 'dd-mm-yyyy',
+    DATE_ISO: 'yyyy-mm-dd',
+    DATE_MONTH_YEAR: 'mmmm yyyy',
+    DATE_WEEKDAY: 'dddd, d mmmm yyyy',
+    DATE_DAY_MONTH: 'd mmmm',
+    DATE_YEAR_ONLY: 'yyyy',
+    DATETIME_SHORT: 'dd.mm.yyyy hh:mm',
+    DATETIME_LONG: 'd mmmm yyyy hh:mm:ss',
+    TIME_HH_MM: 'hh:mm',
+    TIME_HH_MM_SS: 'hh:mm:ss',
+    TIME_12H: 'h:mm AM/PM',
+    DATETIME_24H: 'dd.mm.yyyy hh:mm:ss',
+    DATETIME_ISO: 'yyyy-mm-dd"T"hh:mm:ss',
+    TIME_MS: 'hh:mm:ss.000',
+};
+function isFormattedCell(val) {
+    return val !== null && val !== undefined && typeof val === 'object' && 'format' in val && typeof val.format === 'string';
+}
+function unwrapCell(val) {
+    if (isFormattedCell(val)) {
+        return val.value;
+    }
+    return val;
+}
+function getFormat(val) {
+    if (isFormattedCell(val)) {
+        return val.format;
+    }
+    return null;
+}
+//# sourceMappingURL=Formats.js.map

package/dist/Formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Formats.js","sourceRoot":"","sources":["../src/Formats.ts"],"names":[],"mappings":";;;AAkCA,0CAEC;AAED,gCAKC;AAED,8BAKC;AA7CY,QAAA,CAAC,GAAG;IACb,aAAa,EAAE,OAAO;IACtB,YAAY,EAAE,oBAAoB;IAClC,YAAY,EAAE,iBAAiB;IAC/B,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,UAAU;IACxB,IAAI,EAAE,GAAG;IACT,aAAa,EAAE,WAAW;IAE1B,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,aAAa;IACxB,mBAAmB,EAAE,YAAY;IACjC,QAAQ,EAAE,YAAY;IACtB,eAAe,EAAE,WAAW;IAC5B,YAAY,EAAE,mBAAmB;IACjC,cAAc,EAAE,QAAQ;IACxB,cAAc,EAAE,MAAM;IAEtB,cAAc,EAAE,kBAAkB;IAClC,aAAa,EAAE,sBAAsB;IACrC,UAAU,EAAE,OAAO;IACnB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE,YAAY;IACtB,YAAY,EAAE,qBAAqB;IACnC,YAAY,EAAE,uBAAuB;IACrC,OAAO,EAAE,cAAc;CAC1B,CAAC;AAEF,SAAgB,eAAe,CAAC,GAAQ;IACpC,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC;AAC7H,CAAC;AAED,SAAgB,UAAU,CAAC,GAAQ;IAC/B,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAgB,SAAS,CAAC,GAAQ;IAC9B,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,MAAM,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/XlsbWriter.d.ts

@@ -10,6 +10,9 @@ export declare class XlsbWriter {
     private colWidths;
     private _autofilterIsOn;
     private _oaEpoch;
+    private _nextFmtId;
+    private _nextXfIdx;
+    private _stFmtRecords;
     private _sheet1Bytes;
     private _workbookBinStart;
     private _workbookBinMiddle;
@@ -32,6 +35,12 @@ export declare class XlsbWriter {
     private isStreaming;
     constructor(filePath: string);
     private _sanitizeSheetName;
+    private _registerFormat;
+    private static _buildBrtRecord;
+    private static _encodeVlq;
+    private static _buildStFmtRecord;
+    private static _buildXfRecord;
+    private _buildStylesBin;
     addSheet(sheetName: string, hidden?: boolean): void;
     /**
      * Start a new sheet in streaming mode. Call writeRow() for each row, then endSheet() when done.
@@ -60,7 +69,7 @@ export declare class XlsbWriter {
     writeDouble(bigBuf: BigBuffer, val: number, colNum: number, styleNum?: number): void;
     writeBool(bigBuf: BigBuffer, val: boolean, colNum: number): void;
     writeDateTime(bigBuf: BigBuffer, date: Date, colNum: number): void;
-    writeString(bigBuf: BigBuffer, val: string, colNum: number, bolded?: boolean): void;
+    writeString(bigBuf: BigBuffer, val: string, colNum: number, bolded?: boolean, styleOverride?: number): void;
     private saveSst;
     private _writeFilterDefinedName;
     finalize(): Promise<void>;

package/dist/XlsbWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"XlsbWriter.d.ts","sourceRoot":"","sources":["../src/XlsbWriter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"XlsbWriter.d.ts","sourceRoot":"","sources":["../src/XlsbWriter.ts"],"names":[],"mappings":"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"}

package/dist/XlsbWriter.js

@@ -41,6 +41,7 @@ const fs = __importStar(require("fs"));
 const archiver_1 = __importDefault(require("archiver"));
 const stream_1 = require("stream");
 const BigBuffer_1 = require("./BigBuffer");
+const Formats_1 = require("./Formats");
 const INVALID_SHEET_NAME_CHARS = /[\\/*?[\]:]/g;
 class XlsbWriter {
     constructor(filePath) {
@@ -51,6 +52,9 @@ class XlsbWriter {
         this.sstCntAll = 0;
         this.colWidths = [];
         this._autofilterIsOn = false;
+        this._nextFmtId = 167;
+        this._nextXfIdx = 4;
+        this._stFmtRecords = new Map();
         // Streaming state
         this.currentSheetBuffer = null;
         this.currentSheetRowNum = 0;
@@ -229,6 +233,128 @@ class XlsbWriter {
         }
         return sanitized;
     }
+    _registerFormat(fmtString) {
+        if (this._stFmtRecords.has(fmtString)) {
+            return this._stFmtRecords.get(fmtString).xfIndex;
+        }
+        const numfmtId = this._nextFmtId++;
+        const xfIndex = this._nextXfIdx++;
+        this._stFmtRecords.set(fmtString, { numfmtId, xfIndex });
+        return xfIndex;
+    }
+    static _buildBrtRecord(type, data) {
+        const header = XlsbWriter._encodeVlq(type);
+        header.push(...XlsbWriter._encodeVlq(data.length));
+        return Buffer.concat([Buffer.from(header), data]);
+    }
+    static _encodeVlq(value) {
+        const result = [];
+        while (value >= 0x80) {
+            result.push((value & 0x7F) | 0x80);
+            value >>>= 7;
+        }
+        result.push(value & 0x7F);
+        return result;
+    }
+    static _buildStFmtRecord(ifmt, fmtString) {
+        const cch = fmtString.length;
+        const remaining = 2 + 4 + cch * 2;
+        const data = Buffer.alloc(2 + remaining);
+        data[0] = 0x2C;
+        data[1] = remaining;
+        data.writeUInt16LE(ifmt, 2);
+        data.writeUInt32LE(cch, 4);
+        data.write(fmtString, 8, cch * 2, 'utf16le');
+        return data;
+    }
+    static _buildXfRecord(fontId, ifmt, flags, byte6Extra = 0) {
+        const data = Buffer.alloc(18);
+        data[0] = 0x2F;
+        data[1] = 16;
+        data.writeUInt16LE(fontId, 2);
+        data.writeUInt16LE(ifmt, 4);
+        data[6] = byte6Extra;
+        data[14] = 0x10;
+        data[15] = 0x10;
+        data.writeUInt16LE(flags, 16);
+        return data;
+    }
+    _buildStylesBin() {
+        if (this._stFmtRecords.size === 0) {
+            return this._stylesBin;
+        }
+        const base = this._stylesBin;
+        // Find BrtEndFonts (0xE8, 0x04, 0x00)
+        let fontEndOff = -1;
+        for (let i = 3; i < base.length - 3; i++) {
+            if (base[i] === 0xE8 && base[i + 1] === 0x04 && base[i + 2] === 0x00) {
+                fontEndOff = i;
+                break;
+            }
+        }
+        // Find BrtBeginCellXFs (0xE9, 0x04)
+        let xfBeginOff = -1;
+        for (let i = fontEndOff + 3; i < base.length - 2; i++) {
+            if (base[i] === 0xE9 && base[i + 1] === 0x04) {
+                xfBeginOff = i;
+                break;
+            }
+        }
+        // Find BrtEndCellXFs (0xEA, 0x04, 0x00)
+        let xfEndOff = -1;
+        for (let i = xfBeginOff; i < base.length - 3; i++) {
+            if (base[i] === 0xEA && base[i + 1] === 0x04 && base[i + 2] === 0x00) {
+                xfEndOff = i;
+                break;
+            }
+        }
+        // Find BrtBeginFills (0xE3, 0x04) — start after BrtEndFonts
+        let fillBeginOff = -1;
+        for (let i = fontEndOff + 3; i < base.length - 2; i++) {
+            if (base[i] === 0xE3 && base[i + 1] === 0x04) {
+                fillBeginOff = i;
+                break;
+            }
+        }
+        const totalFmt = 2 + this._stFmtRecords.size;
+        const totalXf = 4 + this._stFmtRecords.size;
+        const parts = [];
+        // 1. BrtBeginStyleSheet
+        parts.push(base.subarray(0, 3));
+        // 2. NEW BrtFmt: VLQ(0x0267) + VLQ(4) + count(2 LE) + pad(2)
+        const fmtHeader = Buffer.alloc(4);
+        fmtHeader.writeUInt16LE(totalFmt, 0);
+        parts.push(XlsbWriter._buildBrtRecord(0x0267, fmtHeader));
+        // 3. BrtNumFmt records: 2 base + custom
+        parts.push(XlsbWriter._buildStFmtRecord(164, 'yyyy\\-mm\\-dd\\ hh:mm:ss'));
+        parts.push(XlsbWriter._buildStFmtRecord(166, 'yyyy\\-mm\\-dd'));
+        for (const [fmtString, st] of this._stFmtRecords) {
+            parts.push(XlsbWriter._buildStFmtRecord(st.numfmtId, fmtString));
+        }
+        // 4. BrtEndFonts
+        parts.push(XlsbWriter._buildBrtRecord(0x0268, Buffer.alloc(0)));
+        // 5. Copy fills+borders+BrtFont+cellStyleXFs from template
+        parts.push(base.subarray(fillBeginOff, xfBeginOff));
+        // 7. NEW BrtBeginCellXFs
+        const xfHeader = Buffer.alloc(4);
+        xfHeader.writeUInt16LE(totalXf, 0);
+        parts.push(XlsbWriter._buildBrtRecord(0x0269, xfHeader));
+        // 8. Base XF records
+        parts.push(XlsbWriter._buildXfRecord(0, 0, 0x0000));
+        parts.push(XlsbWriter._buildXfRecord(0, 164, 0x0001));
+        parts.push(XlsbWriter._buildXfRecord(0, 166, 0x0001));
+        parts.push(XlsbWriter._buildXfRecord(1, 0, 0x0000, 1));
+        // 9. Custom XF records
+        const sortedXf = [...this._stFmtRecords.entries()].sort((a, b) => a[1].xfIndex - b[1].xfIndex);
+        for (const [, st] of sortedXf) {
+            parts.push(XlsbWriter._buildXfRecord(0, st.numfmtId, 0x0001));
+        }
+        // 10. BrtEndCellXFs
+        parts.push(XlsbWriter._buildBrtRecord(0x026A, Buffer.alloc(0)));
+        // 11. Copy remaining template
+        parts.push(base.subarray(xfEndOff + 3));
+        return Buffer.concat(parts);
+    }
     addSheet(sheetName, hidden = false) {
         const sanitizedName = this._sanitizeSheetName(sheetName);
         this.sheetCount++;
@@ -339,20 +465,23 @@ class XlsbWriter {
         this.createRowHeader(bigBuf, this.currentSheetRowNum, this.currentSheetStartCol, this.currentSheetEndCol);
         // Write each cell
         for (let c = 0; c < row.length; c++) {
-            const val = row[c];
-            if (val === null || val === undefined)
+            const raw = row[c];
+            if (raw === null || raw === undefined)
                 continue;
+            const fmtString = (0, Formats_1.getFormat)(raw);
+            const val = fmtString !== null ? (0, Formats_1.unwrapCell)(raw) : raw;
+            const styleNum = fmtString !== null ? this._registerFormat(fmtString) : 0;
             if (typeof val === 'number') {
                 if (Number.isInteger(val)) {
                     if (val >= this._rRkIntegerLowerLimit && val <= this._rRkIntegerUpperLimit) {
-                        this.writeRkNumberInteger(bigBuf, val, c);
+                        this.writeRkNumberInteger(bigBuf, val, c, styleNum);
                     }
                     else {
-                        this.writeDouble(bigBuf, val, c);
+                        this.writeDouble(bigBuf, val, c, styleNum);
                     }
                 }
                 else {
-                    this.writeDouble(bigBuf, val, c);
+                    this.writeDouble(bigBuf, val, c, styleNum);
                 }
             }
             else if (typeof val === 'bigint') {
@@ -362,10 +491,11 @@ class XlsbWriter {
                 this.writeBool(bigBuf, val, c);
             }
             else if (val instanceof Date) {
-                this.writeDateTime(bigBuf, val, c);
+                const oaDate = (val.getTime() - this._oaEpoch) / 86400000;
+                this.writeDouble(bigBuf, oaDate, c, fmtString !== null ? styleNum : 1);
             }
             else {
-                this.writeString(bigBuf, val.toString(), c);
+                this.writeString(bigBuf, val.toString(), c, false, fmtString !== null ? styleNum : undefined);
             }
         }
         this.currentSheetRowNum++;
@@ -442,8 +572,11 @@ class XlsbWriter {
         for (let r = 0; r < Math.min(rows.length, 100); r++) {
             const row = rows[r];
             for (let c = 0; c < row.length; c++) {
-                const val = row[c];
-                const len = val ? val.toString().length : 0;
+                const raw = row[c];
+                if (raw === null || raw === undefined)
+                    continue;
+                const val = (0, Formats_1.isFormattedCell)(raw) ? raw.value : raw;
+                const len = val instanceof Date ? 10 : val.toString().length;
                 let width = 1.25 * len + 2;
                 if (width > 80)
                     width = 80;
@@ -501,20 +634,23 @@ class XlsbWriter {
             this.createRowHeader(bigBuf, rowNum, startCol, endCol);
             const row = rows[r];
             for (let c = 0; c < row.length; c++) {
-                const val = row[c];
-                if (val === null || val === undefined)
+                const raw = row[c];
+                if (raw === null || raw === undefined)
                     continue;
+                const fmtString = (0, Formats_1.getFormat)(raw);
+                const val = fmtString !== null ? (0, Formats_1.unwrapCell)(raw) : raw;
+                const styleNum = fmtString !== null ? this._registerFormat(fmtString) : 0;
                 if (typeof val === 'number') {
                     if (Number.isInteger(val)) {
                         if (val >= this._rRkIntegerLowerLimit && val <= this._rRkIntegerUpperLimit) {
-                            this.writeRkNumberInteger(bigBuf, val, c);
+                            this.writeRkNumberInteger(bigBuf, val, c, styleNum);
                         }
                         else {
-                            this.writeDouble(bigBuf, val, c);
+                            this.writeDouble(bigBuf, val, c, styleNum);
                         }
                     }
                     else {
-                        this.writeDouble(bigBuf, val, c);
+                        this.writeDouble(bigBuf, val, c, styleNum);
                     }
                 }
                 else if (typeof val === 'bigint') {
@@ -524,10 +660,11 @@ class XlsbWriter {
                     this.writeBool(bigBuf, val, c);
                 }
                 else if (val instanceof Date) {
-                    this.writeDateTime(bigBuf, val, c);
+                    const oaDate = (val.getTime() - this._oaEpoch) / 86400000;
+                    this.writeDouble(bigBuf, oaDate, c, fmtString !== null ? styleNum : 1);
                 }
                 else {
-                    this.writeString(bigBuf, val.toString(), c);
+                    this.writeString(bigBuf, val.toString(), c, false, fmtString !== null ? styleNum : undefined);
                 }
             }
             rowNum++;
@@ -611,7 +748,7 @@ class XlsbWriter {
         const oaDate = (date.getTime() - this._oaEpoch) / 86400000;
         this.writeDouble(bigBuf, oaDate, colNum, 1);
     }
-    writeString(bigBuf, val, colNum, bolded = false) {
+    writeString(bigBuf, val, colNum, bolded = false, styleOverride) {
         let index;
         if (this.sstDic.has(val)) {
             index = this.sstDic.get(val);
@@ -622,11 +759,12 @@ class XlsbWriter {
             this.sstCntUnique++;
         }
         this.sstCntAll++;
+        const styleNum = styleOverride !== undefined ? styleOverride : (bolded ? 3 : 0);
         bigBuf.ensureCapacity(17);
         bigBuf.writeUnsafeByte(7);
         bigBuf.writeUnsafeByte(12);
         bigBuf.writeUnsafeInt32LE(colNum);
-        bigBuf.writeUnsafeByte(bolded ? 3 : 0);
+        bigBuf.writeUnsafeByte(styleNum);
         bigBuf.writeUnsafeByte(0);
         bigBuf.writeUnsafeByte(0);
         bigBuf.writeUnsafeByte(0);
@@ -692,7 +830,7 @@ class XlsbWriter {
         return new Promise((resolve, reject) => {
             try {
                 this.saveSst();
-                this.archive.append(this._stylesBin, { name: 'xl/styles.bin' });
+                this.archive.append(this._buildStylesBin(), { name: 'xl/styles.bin' });
                 const wbBuffers = [];
                 wbBuffers.push(this._workbookBinStart);
                 for (const sheet of this.sheetList) {