@hewliyang/headless-spreadjs 0.0.1

package/README.md

@@ -0,0 +1,109 @@
+# headless-spreadjs
+
+Headless Excel workbook engine for Node.js — powered by [SpreadJS](https://developer.mescius.com/spreadjs) with DOM shims. No browser, no Excel, any platform including Linux.
+
+## Features
+
+- **Full Excel fidelity** — 500+ formula functions, charts, pivot tables, tables, cell styling, merging, number formatting
+- **XLSX I/O** — read and write `.xlsx, .xlsm` files with full roundtrip support
+- **JSON serialization** — `toJSON()` / `fromJSON()` preserves everything (formulas, styles, charts, pivots)
+
+## System Dependencies
+
+On Linux, install Cairo/Pango (required by the `canvas` npm package):
+
+```bash
+sudo apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev
+```
+
+macOS: `brew install pkg-config cairo pango libpng jpeg giflib librsvg`
+
+## Install
+
+```bash
+pnpm add headless-spreadjs
+```
+
+## Usage
+
+```js
+import { init } from "headless-spreadjs";
+
+// Initialize (with optional SpreadJS license key)
+// If you use this for commercial purposes, please get a license from the madlads!
+const { ExcelFile, GC, dispose } = await init({ licenseKey: "xxx" });
+
+// Create a workbook from scratch
+const file = new ExcelFile();
+const sheet = file.workbook.getActiveSheet();
+sheet.setValue(0, 0, "Name");
+sheet.setValue(0, 1, "Score");
+sheet.setValue(1, 0, "Alice");
+sheet.setValue(1, 1, 95);
+sheet.setValue(2, 0, "Bob");
+sheet.setValue(2, 1, 87);
+sheet.setValue(3, 0, "Average");
+sheet.setFormula(3, 1, "AVERAGE(B2:B3)");
+await file.save("output.xlsx");
+
+// Open an existing workbook
+const file2 = await ExcelFile.open("input.xlsx");
+const val = file2.workbook.getActiveSheet().getValue(0, 0);
+console.log(val);
+
+// Access raw SpreadJS API
+const workbook = file.workbook; // GC.Spread.Sheets.Workbook instance
+
+// Clean up when done
+dispose();
+```
+
+## API
+
+### `init(options?): { GC, ExcelFile, dispose }`
+
+Initialize the headless runtime. Must be called before creating ExcelFiles.
+
+| Option       | Type      | Description                                |
+| ------------ | --------- | ------------------------------------------ |
+| `licenseKey` | `string?` | SpreadJS license key. Omit for trial mode. |
+
+### `ExcelFile`
+
+| Method                              | Description                                    |
+| ----------------------------------- | ---------------------------------------------- |
+| `new ExcelFile()`                   | Create an empty workbook                       |
+| `ExcelFile.open(path)`              | Open an xlsx file → `Promise<ExcelFile>`       |
+| `ExcelFile.openFromBuffer(buf)`     | Open xlsx from a Buffer → `Promise<ExcelFile>` |
+| `file.save(path)`                   | Save to xlsx file → `Promise<void>`            |
+| `file.saveToBuffer()`               | Save to Buffer → `Promise<Buffer>`             |
+| `file.toJSON()`                     | Serialize to SpreadJS JSON                     |
+| `file.fromJSON(json)`               | Load from SpreadJS JSON                        |
+| `file.batch(fn)`                    | Suspend calc during `fn`, resume after         |
+| `file.workbook`                     | Raw `GC.Spread.Sheets.Workbook` instance       |
+
+### `dispose()`
+
+Close the happy-dom window to prevent memory leaks. Call when done with all workbooks.
+
+## Concurrency
+
+`headless-spreadjs` installs DOM shims on `globalThis` (e.g. `window`, `document`, `navigator`), so a single Node.js process supports **one `init()` / `dispose()` lifecycle at a time**. You cannot safely run multiple workbook operations concurrently within the same process.
+
+If you need parallelism, use separate processes (e.g. worker threads or child processes) — each gets its own global scope so the shims don't collide.
+
+## Docker
+
+`headless-spreadjs` will run in an image as simple as follows
+
+```dockerfile
+FROM node:20-slim
+RUN apt-get update && apt-get install -y \
+    build-essential libcairo2-dev libpango1.0-dev \
+    libjpeg-dev libgif-dev librsvg2-dev \
+    && rm -rf /var/lib/apt/lists/*
+```
+
+## License
+
+MIT (this package). SpreadJS requires a separate commercial license from [MESCIUS](https://developer.mescius.com/spreadjs).

package/dist/excel-file.d.ts

@@ -0,0 +1,15 @@
+import type { GCNamespace, SpreadWorkbook } from "./types.js";
+export declare function setGC(gc: GCNamespace | null): void;
+export declare class ExcelFile {
+    readonly workbook: SpreadWorkbook;
+    constructor(workbook?: SpreadWorkbook);
+    batch<T>(fn: () => T): T;
+    batch<T>(fn: () => Promise<T>): Promise<T>;
+    save(filePath: string): Promise<void>;
+    saveToBuffer(): Promise<Buffer>;
+    toJSON(): object;
+    fromJSON(json: object): void;
+    static open(filePath: string): Promise<ExcelFile>;
+    static openFromBuffer(buffer: Buffer): Promise<ExcelFile>;
+}
+//# sourceMappingURL=excel-file.d.ts.map

package/dist/excel-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-file.d.ts","sourceRoot":"","sources":["../src/excel-file.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA8I9D,wBAAgB,KAAK,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAElD;AAED,qBAAa,SAAS;IACpB,SAAgB,QAAQ,EAAE,cAAc,CAAC;gBAE7B,QAAQ,CAAC,EAAE,cAAc;IAKrC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IACxB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBpC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,MAAM,IAAI,MAAM;IAIhB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;WAIf,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;WAO1C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAKhE"}

package/dist/excel-file.js

@@ -0,0 +1,162 @@
+import fs from "node:fs";
+import path from "node:path";
+import { unzipSync, zipSync } from "fflate";
+let gcRef = null;
+function getGC() {
+    if (!gcRef) {
+        throw new Error("headless-spreadjs not initialized. Call init() first.");
+    }
+    return gcRef;
+}
+function stripEvalSheet(spread) {
+    for (let i = spread.getSheetCount() - 1; i >= 0; i--) {
+        if (spread.getSheet(i).name() === "Evaluation Version") {
+            spread.removeSheet(i);
+        }
+    }
+}
+function toArrayBuffer(buffer) {
+    return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+}
+function stripEvalSheetFromZip(buf) {
+    const zip = unzipSync(new Uint8Array(buf));
+    const wbXmlBytes = zip["xl/workbook.xml"];
+    if (!wbXmlBytes)
+        return buf;
+    const decoder = new TextDecoder();
+    const wbXml = decoder.decode(wbXmlBytes);
+    const sheetRe = /<sheet\s[^>]*name="Evaluation Version"[^>]*\/>/g;
+    const match = sheetRe.exec(wbXml);
+    if (!match)
+        return buf;
+    const ridMatch = /r:id="(rId\d+)"/.exec(match[0]);
+    if (!ridMatch)
+        return buf;
+    const rId = ridMatch[1];
+    const allSheets = [...wbXml.matchAll(/<sheet\s[^>]*\/>/g)];
+    const evalIndex = allSheets.findIndex((m) => m[0] === match[0]);
+    let newWbXml = wbXml.replace(match[0], "");
+    newWbXml = newWbXml.replace(/activeTab="(\d+)"/g, (_full, tabStr) => {
+        let tab = parseInt(tabStr, 10);
+        if (evalIndex >= 0 && tab >= evalIndex) {
+            tab = Math.max(0, tab - 1);
+        }
+        return `activeTab="${tab}"`;
+    });
+    const relsBytes = zip["xl/_rels/workbook.xml.rels"];
+    if (!relsBytes)
+        return buf;
+    const relsXml = decoder.decode(relsBytes);
+    const relRe = new RegExp(`<Relationship[^>]*Id="${rId}"[^>]*/>`, "g");
+    const relMatch = relRe.exec(relsXml);
+    let sheetPath = null;
+    if (relMatch) {
+        const targetMatch = /Target="([^"]+)"/.exec(relMatch[0]);
+        if (targetMatch) {
+            sheetPath = `xl/${targetMatch[1]}`;
+        }
+    }
+    const newRelsXml = relsXml.replace(relRe, "");
+    const ctBytes = zip["[Content_Types].xml"];
+    let newCtXml = null;
+    if (ctBytes && sheetPath) {
+        const ctXml = decoder.decode(ctBytes);
+        const partName = `/${sheetPath}`;
+        const overrideRe = new RegExp(`<Override[^>]*PartName="${partName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}"[^>]*/>`, "g");
+        newCtXml = ctXml.replace(overrideRe, "");
+    }
+    const encoder = new TextEncoder();
+    const newZip = {};
+    for (const [name, data] of Object.entries(zip)) {
+        if (sheetPath && name === sheetPath)
+            continue;
+        if (name === "xl/workbook.xml") {
+            newZip[name] = encoder.encode(newWbXml);
+        }
+        else if (name === "xl/_rels/workbook.xml.rels") {
+            newZip[name] = encoder.encode(newRelsXml);
+        }
+        else if (name === "[Content_Types].xml" && newCtXml) {
+            newZip[name] = encoder.encode(newCtXml);
+        }
+        else {
+            newZip[name] = data;
+        }
+    }
+    return Buffer.from(zipSync(newZip));
+}
+function saveAsBuffer(spread, gc) {
+    return new Promise((resolve, reject) => {
+        spread.save((blob) => {
+            blob
+                .arrayBuffer()
+                .then((bytes) => resolve(stripEvalSheetFromZip(Buffer.from(bytes))))
+                .catch(reject);
+        }, (err) => reject(err), { fileType: gc.Spread.Sheets.FileType.excel });
+    });
+}
+function importWorkbook(bytes, gc) {
+    return new Promise((resolve, reject) => {
+        const spread = new gc.Spread.Sheets.Workbook();
+        spread.import(bytes, () => {
+            stripEvalSheet(spread);
+            resolve(spread);
+        }, (err) => reject(err), { fileType: gc.Spread.Sheets.FileType.excel });
+    });
+}
+export function setGC(gc) {
+    gcRef = gc;
+}
+export class ExcelFile {
+    workbook;
+    constructor(workbook) {
+        const gc = getGC();
+        this.workbook = workbook ?? new gc.Spread.Sheets.Workbook();
+    }
+    batch(fn) {
+        this.workbook.suspendCalcService(false);
+        try {
+            const result = fn();
+            if (result instanceof Promise) {
+                return result.finally(() => {
+                    this.workbook.resumeCalcService(true);
+                });
+            }
+            this.workbook.resumeCalcService(true);
+            return result;
+        }
+        catch (error) {
+            this.workbook.resumeCalcService(true);
+            throw error;
+        }
+    }
+    async save(filePath) {
+        const bytes = await this.saveToBuffer();
+        const dir = path.dirname(filePath);
+        if (dir && dir !== ".") {
+            await fs.promises.mkdir(dir, { recursive: true });
+        }
+        await fs.promises.writeFile(filePath, bytes);
+    }
+    saveToBuffer() {
+        return saveAsBuffer(this.workbook, getGC());
+    }
+    toJSON() {
+        return this.workbook.toJSON();
+    }
+    fromJSON(json) {
+        this.workbook.fromJSON(json);
+    }
+    static async open(filePath) {
+        const gc = getGC();
+        const bytes = await fs.promises.readFile(filePath);
+        const spread = await importWorkbook(toArrayBuffer(bytes), gc);
+        return new ExcelFile(spread);
+    }
+    static async openFromBuffer(buffer) {
+        const gc = getGC();
+        const spread = await importWorkbook(toArrayBuffer(buffer), gc);
+        return new ExcelFile(spread);
+    }
+}
+//# sourceMappingURL=excel-file.js.map

package/dist/excel-file.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { ExcelFile } from "./excel-file.js";
+import type { GCNamespace } from "./types.js";
+export { ExcelFile } from "./excel-file.js";
+export type { GCNamespace, SpreadStyle, SpreadWorkbook, SpreadWorksheet, } from "./types.js";
+export interface InitOptions {
+    licenseKey?: string;
+}
+export interface InitResult {
+    GC: GCNamespace;
+    ExcelFile: typeof ExcelFile;
+    dispose: () => void;
+}
+export declare function init(options?: InitOptions): Promise<InitResult>;
+export declare function dispose(): void;
+//# 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,OAAO,EAAE,SAAS,EAAS,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAoBD,wBAAsB,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBrE;AAED,wBAAgB,OAAO,IAAI,IAAI,CAK9B"}

package/dist/index.js

@@ -0,0 +1,43 @@
+import { ExcelFile, setGC } from "./excel-file.js";
+import { disposeShims, installShims } from "./shims.js";
+export { ExcelFile } from "./excel-file.js";
+const optionalAddons = [
+    "@mescius/spread-sheets-charts",
+    "@mescius/spread-sheets-pivot-addon",
+    "@mescius/spread-sheets-shapes",
+    "@mescius/spread-sheets-slicers",
+];
+let initialized = false;
+let cachedGC = null;
+async function importOptional(moduleName) {
+    try {
+        await import(moduleName);
+    }
+    catch {
+        // Optional addon is not installed.
+    }
+}
+export async function init(options) {
+    if (initialized && cachedGC) {
+        return { GC: cachedGC, ExcelFile, dispose };
+    }
+    installShims();
+    const spreadModule = await import("@mescius/spread-sheets");
+    const gc = (spreadModule.default ?? spreadModule);
+    await import("@mescius/spread-sheets-io");
+    await Promise.all(optionalAddons.map(importOptional));
+    if (options?.licenseKey) {
+        gc.Spread.Sheets.LicenseKey = options.licenseKey;
+    }
+    setGC(gc);
+    cachedGC = gc;
+    initialized = true;
+    return { GC: gc, ExcelFile, dispose };
+}
+export function dispose() {
+    disposeShims();
+    cachedGC = null;
+    initialized = false;
+    setGC(null);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAkB5C,MAAM,cAAc,GAAG;IACrB,+BAA+B;IAC/B,oCAAoC;IACpC,+BAA+B;IAC/B,gCAAgC;CACxB,CAAC;AAEX,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,IAAI,QAAQ,GAAuB,IAAI,CAAC;AAExC,KAAK,UAAU,cAAc,CAAC,UAA2C;IACvE,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAqB;IAC9C,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAC9C,CAAC;IAED,YAAY,EAAE,CAAC;IAEf,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC5D,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,YAAY,CAAgB,CAAC;IAEjE,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAC1C,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;IAEtD,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;QACxB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,QAAQ,GAAG,EAAE,CAAC;IACd,WAAW,GAAG,IAAI,CAAC;IAEnB,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,YAAY,EAAE,CAAC;IACf,QAAQ,GAAG,IAAI,CAAC;IAChB,WAAW,GAAG,KAAK,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/shims.d.ts

@@ -0,0 +1,4 @@
+export declare function installShims(): void;
+export declare function disposeShims(): void;
+export declare function isShimInstalled(): boolean;
+//# sourceMappingURL=shims.d.ts.map

package/dist/shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shims.d.ts","sourceRoot":"","sources":["../src/shims.ts"],"names":[],"mappings":"AAiKA,wBAAgB,YAAY,IAAI,IAAI,CAyDnC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAMnC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/shims.js

@@ -0,0 +1,187 @@
+import canvas from "canvas";
+import { Window } from "happy-dom";
+let shimInstalled = false;
+let windowInstance = null;
+class NodeFileReader {
+    result = null;
+    error = null;
+    onload = null;
+    onerror = null;
+    onloadend = null;
+    readyState = 0;
+    done(result) {
+        this.readyState = 2;
+        this.result = result;
+        const event = { target: this };
+        this.onload?.(event);
+        this.onloadend?.(event);
+    }
+    fail(error) {
+        this.readyState = 2;
+        this.error = error;
+        const event = { target: this };
+        this.onerror?.(event);
+        this.onloadend?.(event);
+    }
+    readAsArrayBuffer(input) {
+        this.readyState = 1;
+        if (input instanceof ArrayBuffer) {
+            process.nextTick(() => this.done(input));
+            return;
+        }
+        if (isArrayBufferSource(input)) {
+            input
+                .arrayBuffer()
+                .then((bytes) => this.done(bytes))
+                .catch((error) => this.fail(error));
+        }
+    }
+    readAsBinaryString(input) {
+        this.readyState = 1;
+        if (!isArrayBufferSource(input)) {
+            return;
+        }
+        input
+            .arrayBuffer()
+            .then((bytes) => {
+            const data = new Uint8Array(bytes);
+            let text = "";
+            for (const value of data) {
+                text += String.fromCharCode(value);
+            }
+            this.done(text);
+        })
+            .catch((error) => this.fail(error));
+    }
+    readAsDataURL(input) {
+        this.readyState = 1;
+        if (!isArrayBufferSource(input)) {
+            return;
+        }
+        input
+            .arrayBuffer()
+            .then((bytes) => {
+            const mimeType = input.type ?? "application/octet-stream";
+            const base64 = Buffer.from(bytes).toString("base64");
+            this.done(`data:${mimeType};base64,${base64}`);
+        })
+            .catch((error) => this.fail(error));
+    }
+    readAsText(input, encoding) {
+        this.readyState = 1;
+        if (!isArrayBufferSource(input)) {
+            return;
+        }
+        input
+            .arrayBuffer()
+            .then((bytes) => {
+            const decoder = new TextDecoder(encoding ?? "utf-8");
+            this.done(decoder.decode(bytes));
+        })
+            .catch((error) => this.fail(error));
+    }
+    abort() { }
+    addEventListener(type, listener) {
+        if (!listener) {
+            return;
+        }
+        if (type === "load") {
+            this.onload = listener;
+        }
+        else if (type === "error") {
+            this.onerror = listener;
+        }
+        else {
+            this.onloadend = listener;
+        }
+    }
+    removeEventListener(type, listener) {
+        if (type === "load" && this.onload === listener) {
+            this.onload = null;
+        }
+        if (type === "error" && this.onerror === listener) {
+            this.onerror = null;
+        }
+        if (type === "loadend" && this.onloadend === listener) {
+            this.onloadend = null;
+        }
+    }
+}
+function isArrayBufferSource(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "arrayBuffer" in value &&
+        typeof value.arrayBuffer === "function");
+}
+function setGlobal(name, value) {
+    try {
+        Object.assign(globalThis, { [name]: value });
+    }
+    catch {
+        Object.defineProperty(globalThis, name, {
+            value,
+            writable: true,
+            configurable: true,
+        });
+    }
+}
+export function installShims() {
+    if (shimInstalled) {
+        return;
+    }
+    const win = new Window({ url: "http://localhost" });
+    windowInstance = win;
+    setGlobal("self", globalThis);
+    setGlobal("window", win);
+    setGlobal("document", win.document);
+    setGlobal("navigator", win.navigator);
+    setGlobal("HTMLCollection", win.HTMLCollection);
+    setGlobal("getComputedStyle", win.getComputedStyle.bind(win));
+    setGlobal("customElements", win.customElements);
+    setGlobal("HTMLElement", win.HTMLElement);
+    setGlobal("HTMLDivElement", win.HTMLDivElement);
+    setGlobal("HTMLCanvasElement", win.HTMLCanvasElement);
+    setGlobal("HTMLImageElement", win.HTMLImageElement);
+    setGlobal("Image", win.Image);
+    setGlobal("Event", win.Event);
+    setGlobal("MouseEvent", win.MouseEvent);
+    setGlobal("KeyboardEvent", win.KeyboardEvent);
+    setGlobal("PointerEvent", win.PointerEvent || win.MouseEvent);
+    setGlobal("TouchEvent", win.TouchEvent || class TouchEvent {
+    });
+    setGlobal("WheelEvent", win.WheelEvent || win.Event);
+    setGlobal("MutationObserver", win.MutationObserver);
+    setGlobal("ResizeObserver", class ResizeObserver {
+        observe() { }
+        disconnect() { }
+        unobserve() { }
+    });
+    setGlobal("requestAnimationFrame", (callback) => setTimeout(() => callback(Date.now()), 0));
+    setGlobal("cancelAnimationFrame", (id) => clearTimeout(id));
+    setGlobal("FileReader", NodeFileReader);
+    setGlobal("DOMParser", win.DOMParser);
+    setGlobal("XMLSerializer", win.XMLSerializer);
+    setGlobal("canvas", canvas);
+    setGlobal("devicePixelRatio", 1);
+    setGlobal("location", win.location);
+    setGlobal("innerWidth", 800);
+    setGlobal("innerHeight", 600);
+    setGlobal("addEventListener", () => { });
+    setGlobal("removeEventListener", () => { });
+    setGlobal("getSelection", () => ({
+        removeAllRanges: () => { },
+        addRange: () => { },
+    }));
+    shimInstalled = true;
+}
+export function disposeShims() {
+    if (windowInstance) {
+        windowInstance.close();
+        windowInstance = null;
+    }
+    shimInstalled = false;
+}
+export function isShimInstalled() {
+    return shimInstalled;
+}
+//# sourceMappingURL=shims.js.map

package/dist/shims.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+import type * as SpreadJS from "@mescius/spread-sheets";
+export type GCNamespace = typeof SpreadJS;
+export type SpreadWorkbook = SpreadJS.Spread.Sheets.Workbook;
+export type SpreadWorksheet = SpreadJS.Spread.Sheets.Worksheet;
+export type SpreadStyle = SpreadJS.Spread.Sheets.Style;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC;AAC1C,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/workbook.d.ts

@@ -0,0 +1,19 @@
+import type { GCNamespace, SpreadWorkbook, SpreadWorksheet } from "./types.js";
+export declare function setGC(gc: GCNamespace | null): void;
+export declare class Workbook {
+    readonly spread: SpreadWorkbook;
+    constructor(spread?: SpreadWorkbook);
+    batch<T>(fn: () => T): T;
+    batch<T>(fn: () => Promise<T>): Promise<T>;
+    getActiveSheet(): SpreadWorksheet;
+    getSheet(index: number): SpreadWorksheet;
+    getSheetCount(): number;
+    addSheet(name: string, index?: number): SpreadWorksheet;
+    save(filePath: string): Promise<void>;
+    saveToBuffer(): Promise<Buffer>;
+    toJSON(): object;
+    fromJSON(json: object): void;
+    static open(filePath: string): Promise<Workbook>;
+    static openFromBuffer(buffer: Buffer): Promise<Workbook>;
+}
+//# sourceMappingURL=workbook.d.ts.map

package/dist/workbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbook.d.ts","sourceRoot":"","sources":["../src/workbook.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA8I/E,wBAAgB,KAAK,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAElD;AAED,qBAAa,QAAQ;IACnB,SAAgB,MAAM,EAAE,cAAc,CAAC;gBAE3B,MAAM,CAAC,EAAE,cAAc;IAKnC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IACxB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqB1C,cAAc,IAAI,eAAe;IAIjC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAIxC,aAAa,IAAI,MAAM;IAIvB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe;IAOjD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAK/B,MAAM,IAAI,MAAM;IAIhB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;WAIf,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;WAOzC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAK/D"}

package/dist/workbook.js

@@ -0,0 +1,177 @@
+import fs from "node:fs";
+import path from "node:path";
+import { unzipSync, zipSync } from "fflate";
+let gcRef = null;
+function getGC() {
+    if (!gcRef) {
+        throw new Error("headless-spreadjs not initialized. Call init() first.");
+    }
+    return gcRef;
+}
+function stripEvalSheet(spread) {
+    for (let i = spread.getSheetCount() - 1; i >= 0; i--) {
+        if (spread.getSheet(i).name() === "Evaluation Version") {
+            spread.removeSheet(i);
+        }
+    }
+}
+function toArrayBuffer(buffer) {
+    return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+}
+function stripEvalSheetFromZip(buf) {
+    const zip = unzipSync(new Uint8Array(buf));
+    const wbXmlBytes = zip["xl/workbook.xml"];
+    if (!wbXmlBytes)
+        return buf;
+    const decoder = new TextDecoder();
+    const wbXml = decoder.decode(wbXmlBytes);
+    const sheetRe = /<sheet\s[^>]*name="Evaluation Version"[^>]*\/>/g;
+    const match = sheetRe.exec(wbXml);
+    if (!match)
+        return buf;
+    const ridMatch = /r:id="(rId\d+)"/.exec(match[0]);
+    if (!ridMatch)
+        return buf;
+    const rId = ridMatch[1];
+    const allSheets = [...wbXml.matchAll(/<sheet\s[^>]*\/>/g)];
+    const evalIndex = allSheets.findIndex((m) => m[0] === match[0]);
+    let newWbXml = wbXml.replace(match[0], "");
+    newWbXml = newWbXml.replace(/activeTab="(\d+)"/g, (_full, tabStr) => {
+        let tab = parseInt(tabStr, 10);
+        if (evalIndex >= 0 && tab >= evalIndex) {
+            tab = Math.max(0, tab - 1);
+        }
+        return `activeTab="${tab}"`;
+    });
+    const relsBytes = zip["xl/_rels/workbook.xml.rels"];
+    if (!relsBytes)
+        return buf;
+    const relsXml = decoder.decode(relsBytes);
+    const relRe = new RegExp(`<Relationship[^>]*Id="${rId}"[^>]*/>`, "g");
+    const relMatch = relRe.exec(relsXml);
+    let sheetPath = null;
+    if (relMatch) {
+        const targetMatch = /Target="([^"]+)"/.exec(relMatch[0]);
+        if (targetMatch) {
+            sheetPath = "xl/" + targetMatch[1];
+        }
+    }
+    const newRelsXml = relsXml.replace(relRe, "");
+    const ctBytes = zip["[Content_Types].xml"];
+    let newCtXml = null;
+    if (ctBytes && sheetPath) {
+        const ctXml = decoder.decode(ctBytes);
+        const partName = "/" + sheetPath;
+        const overrideRe = new RegExp(`<Override[^>]*PartName="${partName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}"[^>]*/>`, "g");
+        newCtXml = ctXml.replace(overrideRe, "");
+    }
+    const encoder = new TextEncoder();
+    const newZip = {};
+    for (const [name, data] of Object.entries(zip)) {
+        if (sheetPath && name === sheetPath)
+            continue;
+        if (name === "xl/workbook.xml") {
+            newZip[name] = encoder.encode(newWbXml);
+        }
+        else if (name === "xl/_rels/workbook.xml.rels") {
+            newZip[name] = encoder.encode(newRelsXml);
+        }
+        else if (name === "[Content_Types].xml" && newCtXml) {
+            newZip[name] = encoder.encode(newCtXml);
+        }
+        else {
+            newZip[name] = data;
+        }
+    }
+    return Buffer.from(zipSync(newZip));
+}
+function saveAsBuffer(spread, gc) {
+    return new Promise((resolve, reject) => {
+        spread.save((blob) => {
+            blob
+                .arrayBuffer()
+                .then((bytes) => resolve(stripEvalSheetFromZip(Buffer.from(bytes))))
+                .catch(reject);
+        }, (err) => reject(err), { fileType: gc.Spread.Sheets.FileType.excel });
+    });
+}
+function importWorkbook(bytes, gc) {
+    return new Promise((resolve, reject) => {
+        const spread = new gc.Spread.Sheets.Workbook();
+        spread.import(bytes, () => {
+            stripEvalSheet(spread);
+            resolve(spread);
+        }, (err) => reject(err), { fileType: gc.Spread.Sheets.FileType.excel });
+    });
+}
+export function setGC(gc) {
+    gcRef = gc;
+}
+export class Workbook {
+    spread;
+    constructor(spread) {
+        const gc = getGC();
+        this.spread = spread ?? new gc.Spread.Sheets.Workbook();
+    }
+    batch(fn) {
+        this.spread.suspendCalcService(false);
+        try {
+            const result = fn();
+            if (result instanceof Promise) {
+                return result.finally(() => {
+                    this.spread.resumeCalcService(true);
+                });
+            }
+            this.spread.resumeCalcService(true);
+            return result;
+        }
+        catch (error) {
+            this.spread.resumeCalcService(true);
+            throw error;
+        }
+    }
+    getActiveSheet() {
+        return this.spread.getActiveSheet();
+    }
+    getSheet(index) {
+        return this.spread.getSheet(index);
+    }
+    getSheetCount() {
+        return this.spread.getSheetCount();
+    }
+    addSheet(name, index) {
+        const gc = getGC();
+        const sheet = new gc.Spread.Sheets.Worksheet(name);
+        this.spread.addSheet(index ?? this.spread.getSheetCount(), sheet);
+        return sheet;
+    }
+    async save(filePath) {
+        const bytes = await this.saveToBuffer();
+        const dir = path.dirname(filePath);
+        if (dir && dir !== ".") {
+            await fs.promises.mkdir(dir, { recursive: true });
+        }
+        await fs.promises.writeFile(filePath, bytes);
+    }
+    saveToBuffer() {
+        return saveAsBuffer(this.spread, getGC());
+    }
+    toJSON() {
+        return this.spread.toJSON();
+    }
+    fromJSON(json) {
+        this.spread.fromJSON(json);
+    }
+    static async open(filePath) {
+        const gc = getGC();
+        const bytes = await fs.promises.readFile(filePath);
+        const spread = await importWorkbook(toArrayBuffer(bytes), gc);
+        return new Workbook(spread);
+    }
+    static async openFromBuffer(buffer) {
+        const gc = getGC();
+        const spread = await importWorkbook(toArrayBuffer(buffer), gc);
+        return new Workbook(spread);
+    }
+}
+//# sourceMappingURL=workbook.js.map

package/dist/workbook.js.map

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

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@hewliyang/headless-spreadjs",
+  "version": "0.0.1",
+  "description": "Headless Excel workbook engine for Node.js — powered by SpreadJS with DOM shims. No browser, no Excel, any platform.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "excel",
+    "xlsx",
+    "spreadsheet",
+    "headless",
+    "spreadjs",
+    "node",
+    "charts",
+    "pivot-tables",
+    "formulas",
+    "shapes",
+    "slicers"
+  ],
+  "author": "hewliyang",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hewliyang/headless-spreadjs.git"
+  },
+  "homepage": "https://github.com/hewliyang/headless-spreadjs#readme",
+  "bugs": {
+    "url": "https://github.com/hewliyang/headless-spreadjs/issues"
+  },
+  "dependencies": {
+    "@mescius/spread-sheets": ">=18.0.0",
+    "@mescius/spread-sheets-charts": ">=18.0.0",
+    "@mescius/spread-sheets-io": ">=18.0.0",
+    "@mescius/spread-sheets-pivot-addon": ">=18.0.0",
+    "@mescius/spread-sheets-shapes": ">=18.0.0",
+    "@mescius/spread-sheets-slicers": ">=18.0.0",
+    "canvas": "^3.1.0",
+    "fflate": "^0.8.2",
+    "happy-dom": "^16.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.15",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit && tsc --project examples/tsconfig.json",
+    "dev": "tsc --watch",
+    "lint": "biome check",
+    "fmt": "biome check --write",
+    "test": "vitest run --maxWorkers=1",
+    "test:watch": "vitest --maxWorkers=1"
+  }
+}