@achmadya-dev/mcp-excel-query 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 achmadya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# @achmadya-dev/mcp-excel-query
+
+MCP server for local `.xlsx` files over **stdio**. TypeScript + [ExcelJS](https://github.com/exceljs/exceljs). Read, write, format, and manage workbooks without Microsoft Excel installed.
+
+## Requirements
+
+- Node.js **≥ 20**
+- `.xlsx` files on the local filesystem (paths passed in tool arguments)
+
+## Install from npm
+
+```json
+{
+  "mcpServers": {
+    "excel": {
+      "command": "npx",
+      "args": ["-y", "@achmadya-dev/mcp-excel-query"],
+      "env": {
+        "EXCEL_PAGING_CELLS_LIMIT": "4000"
+      }
+    }
+  }
+}
+```
+
+Or use `envFile` instead of inline `env`.
+
+## Develop from source
+
+```bash
+cp .env.example .env
+pnpm install
+pnpm --filter @achmadya-dev/mcp-excel-query run build
+```
+
+`.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "excel": {
+      "command": "node",
+      "args": ["${workspaceFolder}/packages/mcp-excel-query/dist/index.js"],
+      "envFile": "${workspaceFolder}/.env"
+    }
+  }
+}
+```
+
+Relevant `.env` key:
+
+```env
+EXCEL_PAGING_CELLS_LIMIT=4000
+```
+
+## Environment variables
+
+| Variable                   | Default              | Description                                            |
+| -------------------------- | -------------------- | ------------------------------------------------------ |
+| `EXCEL_PAGING_CELLS_LIMIT` | _(unset = no limit)_ | Max cells returned per read; prevents huge sheet dumps |
+
+## Tools (17)
+
+| Tool                         | Use for                                                                      |
+| ---------------------------- | ---------------------------------------------------------------------------- |
+| `excel_read_sheet`           | Read rows, formulas (`showFormula`), styles, dates, merged cells, validation |
+| `excel_get_metadata`         | Sheet names, dimensions, date info                                           |
+| `excel_create_file`          | New workbook + optional headers                                              |
+| `excel_write_range`          | Bulk write, append, new sheet, single cell/formula, optional style           |
+| `excel_format_range`         | Font, fill, border, alignment, numFmt, merge                                 |
+| `excel_copy_sheet`           | Duplicate worksheet                                                          |
+| `excel_rename_sheet`         | Rename worksheet                                                             |
+| `excel_delete_sheet`         | Delete worksheet                                                             |
+| `excel_copy_range`           | Copy cells to another location                                               |
+| `excel_delete_range`         | Delete range; `shiftDirection: up` or `left`                                 |
+| `excel_unmerge_cells`        | Unmerge range                                                                |
+| `excel_create_table`         | Native Excel table                                                           |
+| `excel_insert_rows`          | Insert empty rows                                                            |
+| `excel_insert_columns`       | Insert empty columns                                                         |
+| `excel_set_sheet_visibility` | Show, hide, or very-hide a sheet                                             |
+| `excel_set_data_validation`  | Dropdown / validation rules on a range                                       |
+| `excel_set_dimensions`       | Row height, column width, sheet defaults                                     |
+
+### Common patterns
+
+```json
+// Append rows
+{ "append": true, "values": [[1, "Alice", 25]] }
+
+// Write formula to one cell
+{ "startCell": "D2", "values": [["=SUM(A2:C2)"]] }
+
+// New blank sheet
+{ "newSheet": true, "sheetName": "Report" }
+
+// Style one cell
+{ "startCell": "A1", "values": [["Title"]], "style": { "font": { "bold": true } } }
+
+// Merge + format
+{ "startCell": "A1", "endCell": "C1", "mergeCells": true, "bold": true }
+
+// Read dates using each cell's Excel numFmt
+{ "range": "H3:H10", "headerRow": 0, "dateFormat": "cell" }
+
+// Hide a sheet
+{ "sheetName": "Archive", "state": "hidden" }
+
+// Dropdown validation
+{ "startCell": "B2", "endCell": "B100", "type": "list", "formulae": ["\"Yes,No,Maybe\""] }
+```
+
+## Notes
+
+- Formulas are stored, not evaluated server-side.
+- `.xlsx` only (not `.xls` or `.csv`).
+
+## Package scripts
+
+```bash
+pnpm run build
+pnpm test
+pnpm start
+```

package/dist/excel/cell.d.ts

@@ -0,0 +1,12 @@
+import type ExcelJS from "exceljs";
+export type CellValue = string | number | boolean | null;
+export declare class Cell {
+    static readDisplay(cellValue: unknown, showFormula: boolean, opts?: {
+        dateFormat?: string;
+        cellNumFmt?: string;
+    }): CellValue | string;
+    static extractStyle(cell: ExcelJS.Cell): Record<string, unknown> | null;
+    static set(cell: ExcelJS.Cell, value: unknown): void;
+    static applyStyle(excelCell: ExcelJS.Cell, style: Record<string, unknown>): void;
+}
+//# sourceMappingURL=cell.d.ts.map

package/dist/excel/cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell.d.ts","sourceRoot":"","sources":["../../src/excel/cell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAQnC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AA8CzD,qBAAa,IAAI;IACf,MAAM,CAAC,WAAW,CAChB,SAAS,EAAE,OAAO,EAClB,WAAW,EAAE,OAAO,EACpB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,SAAS,GAAG,MAAM;IAerB,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYvE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAmBpD,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAmDjF"}

package/dist/excel/cell.js

@@ -0,0 +1,136 @@
+import { extractDateFromCellValue, formatDateValue, parseDateValue, resolveDateFormat, } from "./date.js";
+function toArgb(hex) {
+    const clean = hex.trim().replace(/^#/, "");
+    if (clean.length === 6) {
+        return { argb: "FF" + clean.toUpperCase() };
+    }
+    if (clean.length === 8) {
+        return { argb: clean.toUpperCase() };
+    }
+    return { argb: clean };
+}
+function getCleanValue(cellValue) {
+    if (cellValue === null || cellValue === undefined)
+        return null;
+    if (cellValue instanceof Date)
+        return cellValue.toISOString();
+    if (typeof cellValue === "object") {
+        if ("result" in cellValue) {
+            return getCleanValue(cellValue.result);
+        }
+        if ("richText" in cellValue && Array.isArray(cellValue.richText)) {
+            return cellValue.richText
+                .map((t) => t.text || "")
+                .join("");
+        }
+        if ("text" in cellValue) {
+            return String(cellValue.text);
+        }
+        return JSON.stringify(cellValue);
+    }
+    return cellValue;
+}
+function getFormula(cellValue) {
+    if (cellValue === null || cellValue === undefined)
+        return null;
+    if (typeof cellValue === "object" && "formula" in cellValue) {
+        const formula = cellValue.formula;
+        return formula.startsWith("=") ? formula : `=${formula}`;
+    }
+    if (typeof cellValue === "string" && cellValue.startsWith("=")) {
+        return cellValue;
+    }
+    return null;
+}
+export class Cell {
+    static readDisplay(cellValue, showFormula, opts) {
+        if (showFormula) {
+            const formula = getFormula(cellValue);
+            if (formula)
+                return formula;
+        }
+        const resolvedFormat = resolveDateFormat(opts?.dateFormat, opts?.cellNumFmt);
+        if (resolvedFormat) {
+            const date = extractDateFromCellValue(cellValue);
+            if (date)
+                return formatDateValue(date, resolvedFormat);
+        }
+        return getCleanValue(cellValue);
+    }
+    static extractStyle(cell) {
+        const style = {};
+        if (cell.font && Object.keys(cell.font).length > 0)
+            style.font = { ...cell.font };
+        if (cell.fill && Object.keys(cell.fill).length > 0)
+            style.fill = { ...cell.fill };
+        if (cell.alignment && Object.keys(cell.alignment).length > 0) {
+            style.alignment = { ...cell.alignment };
+        }
+        if (cell.border && Object.keys(cell.border).length > 0)
+            style.border = { ...cell.border };
+        if (cell.numFmt)
+            style.numFmt = cell.numFmt;
+        return Object.keys(style).length > 0 ? style : null;
+    }
+    static set(cell, value) {
+        if (value === null || value === undefined) {
+            cell.value = null;
+            return;
+        }
+        if (typeof value === "string" && value.startsWith("=")) {
+            cell.value = { formula: value.slice(1) };
+            return;
+        }
+        const parsedDate = parseDateValue(value);
+        if (parsedDate) {
+            cell.value = parsedDate;
+            return;
+        }
+        cell.value = value;
+    }
+    static applyStyle(excelCell, style) {
+        if (!style)
+            return;
+        if (style.font && typeof style.font === "object") {
+            const font = { ...style.font };
+            if (typeof font.color === "string") {
+                font.color = toArgb(font.color);
+            }
+            excelCell.font = font;
+        }
+        if (style.fill && typeof style.fill === "object") {
+            const fillSrc = style.fill;
+            const fill = {};
+            fill.type = fillSrc.type || "pattern";
+            fill.pattern = fillSrc.pattern || "solid";
+            if (typeof fillSrc.fgColor === "string") {
+                fill.fgColor = toArgb(fillSrc.fgColor);
+            }
+            if (typeof fillSrc.bgColor === "string") {
+                fill.bgColor = toArgb(fillSrc.bgColor);
+            }
+            excelCell.fill = fill;
+        }
+        if (style.alignment && typeof style.alignment === "object") {
+            excelCell.alignment = { ...style.alignment };
+        }
+        if (style.border && typeof style.border === "object") {
+            const border = {};
+            const sides = ["top", "left", "bottom", "right"];
+            const borderSrc = style.border;
+            for (const side of sides) {
+                if (borderSrc[side]) {
+                    border[side] = {
+                        style: borderSrc[side].style,
+                        ...(borderSrc[side].color ? { color: toArgb(borderSrc[side].color) } : {}),
+                    };
+                }
+            }
+            excelCell.border = border;
+        }
+        if (typeof style.numFmt === "string") {
+            excelCell.numFmt = style.numFmt;
+        }
+    }
+}
+//# sourceMappingURL=cell.js.map

package/dist/excel/cell.js.map

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

package/dist/excel/date.d.ts

@@ -0,0 +1,6 @@
+export declare function normalizeExcelNumFmt(numFmt: string): string;
+export declare function parseDateValue(value: unknown): Date | null;
+export declare function extractDateFromCellValue(cellValue: unknown): Date | null;
+export declare function formatDateValue(date: Date, pattern: string): string;
+export declare function resolveDateFormat(dateFormat: string | undefined, cellNumFmt?: string): string | undefined;
+//# sourceMappingURL=date.d.ts.map

package/dist/excel/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/excel/date.ts"],"names":[],"mappings":"AAgDA,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAyC1D;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAexE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBnE;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAMpB"}

package/dist/excel/date.js

@@ -0,0 +1,132 @@
+const MONTH_SHORT = [
+    "Jan",
+    "Feb",
+    "Mar",
+    "Apr",
+    "May",
+    "Jun",
+    "Jul",
+    "Aug",
+    "Sep",
+    "Oct",
+    "Nov",
+    "Dec",
+];
+const MONTH_FULL = [
+    "January",
+    "February",
+    "March",
+    "April",
+    "May",
+    "June",
+    "July",
+    "August",
+    "September",
+    "October",
+    "November",
+    "December",
+];
+const MONTH_INDEX = Object.fromEntries(MONTH_SHORT.flatMap((m, i) => [
+    [m.toLowerCase(), i],
+    [MONTH_FULL[i].toLowerCase(), i],
+]));
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?$/;
+function excelSerialToDate(serial) {
+    if (!Number.isFinite(serial) || serial < 1 || serial >= 2958466)
+        return null;
+    const utcDays = Math.floor(serial - 25569);
+    const ms = utcDays * 86400 * 1000;
+    const date = new Date(ms);
+    return Number.isNaN(date.getTime()) ? null : date;
+}
+export function normalizeExcelNumFmt(numFmt) {
+    return numFmt.replace(/\\"/g, " ").replace(/"/g, "").replace(/\s+/g, " ").trim();
+}
+export function parseDateValue(value) {
+    if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? null : value;
+    }
+    if (typeof value === "number") {
+        return excelSerialToDate(value);
+    }
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    if (ISO_DATE_RE.test(trimmed)) {
+        const date = new Date(trimmed);
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    const textDate = trimmed.match(/^(\d{1,2})\s+([A-Za-z]{3,9})\s+(\d{2,4})$/);
+    if (textDate) {
+        const day = parseInt(textDate[1], 10);
+        const month = MONTH_INDEX[textDate[2].toLowerCase()];
+        let year = parseInt(textDate[3], 10);
+        if (month === undefined)
+            return null;
+        if (year < 100)
+            year += 2000;
+        const date = new Date(year, month, day);
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    const slashDate = trimmed.match(/^(\d{1,2})[/-](\d{1,2})[/-](\d{2,4})$/);
+    if (slashDate) {
+        const day = parseInt(slashDate[1], 10);
+        const month = parseInt(slashDate[2], 10) - 1;
+        let year = parseInt(slashDate[3], 10);
+        if (year < 100)
+            year += 2000;
+        const date = new Date(year, month, day);
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    return null;
+}
+export function extractDateFromCellValue(cellValue) {
+    if (cellValue === null || cellValue === undefined)
+        return null;
+    if (cellValue instanceof Date) {
+        return Number.isNaN(cellValue.getTime()) ? null : cellValue;
+    }
+    if (typeof cellValue === "object" && "result" in cellValue) {
+        return extractDateFromCellValue(cellValue.result);
+    }
+    if (typeof cellValue === "number") {
+        return excelSerialToDate(cellValue);
+    }
+    if (typeof cellValue === "string") {
+        return parseDateValue(cellValue);
+    }
+    return null;
+}
+export function formatDateValue(date, pattern) {
+    const pad = (n, len = 2) => String(n).padStart(len, "0");
+    const replacements = [
+        ["yyyy", String(date.getFullYear())],
+        ["yy", String(date.getFullYear()).slice(-2)],
+        ["MMMM", MONTH_FULL[date.getMonth()]],
+        ["mmmm", MONTH_FULL[date.getMonth()]],
+        ["MMM", MONTH_SHORT[date.getMonth()]],
+        ["mmm", MONTH_SHORT[date.getMonth()]],
+        ["MM", pad(date.getMonth() + 1)],
+        ["dd", pad(date.getDate())],
+        ["HH", pad(date.getHours())],
+        ["hh", pad(date.getHours() % 12 || 12)],
+        ["mm", pad(date.getMinutes())],
+        ["ss", pad(date.getSeconds())],
+    ];
+    let result = normalizeExcelNumFmt(pattern);
+    for (const [token, value] of replacements) {
+        result = result.replaceAll(token, value);
+    }
+    return result;
+}
+export function resolveDateFormat(dateFormat, cellNumFmt) {
+    if (!dateFormat)
+        return undefined;
+    if (dateFormat === "cell") {
+        return cellNumFmt ? normalizeExcelNumFmt(cellNumFmt) : undefined;
+    }
+    return dateFormat;
+}
+//# sourceMappingURL=date.js.map

package/dist/excel/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/excel/date.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG;IAClB,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACN,CAAC;AAEF,MAAM,UAAU,GAAG;IACjB,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAC;AAEF,MAAM,WAAW,GAA2B,MAAM,CAAC,WAAW,CAC5D,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACpB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;CACjC,CAAC,CACH,CAAC;AAEF,MAAM,WAAW,GACf,kFAAkF,CAAC;AAErF,SAAS,iBAAiB,CAAC,MAAc;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC5E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACrD,IAAI,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,IAAI,GAAG,GAAG;YAAE,IAAI,IAAI,IAAI,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACzE,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,IAAI,GAAG,GAAG;YAAE,IAAI,IAAI,IAAI,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,SAAkB;IACzD,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,SAAS,YAAY,IAAI,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC3D,OAAO,wBAAwB,CAAE,SAAiC,CAAC,MAAM,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAU,EAAE,OAAe;IACzD,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,YAAY,GAA4B;QAC5C,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACpC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;QAChC,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3B,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5B,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9B,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;KAC/B,CAAC;IAEF,IAAI,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC3C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QAC1C,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,UAA8B,EAC9B,UAAmB;IAEnB,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/excel/excel.d.ts

@@ -0,0 +1,29 @@
+import ExcelJS from "exceljs";
+import { type A1Bounds } from "./range.js";
+export declare class Sheet {
+    private readonly worksheet;
+    constructor(worksheet: ExcelJS.Worksheet);
+    get name(): string;
+    get raw(): ExcelJS.Worksheet;
+    range(a1: string): A1Bounds;
+    range(start: string, end: string): A1Bounds;
+}
+export declare class Excel {
+    private readonly wb;
+    private readonly filePath;
+    private constructor();
+    static pagingLimit(): number;
+    static open(filePath: string): Promise<Excel>;
+    static create(filePath: string, opts?: {
+        sheetName?: string;
+        headers?: string[];
+    }): Excel;
+    get path(): string;
+    get workbook(): ExcelJS.Workbook;
+    save(): Promise<void>;
+    sheet(name?: string): Sheet;
+    addSheet(name: string): Sheet;
+    hasSheet(name: string): boolean;
+    removeSheet(name: string): void;
+}
+//# sourceMappingURL=excel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"excel.d.ts","sourceRoot":"","sources":["../../src/excel/excel.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAS,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,OAAO,CAAC,SAAS;IAEzD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,GAAG,IAAI,OAAO,CAAC,SAAS,CAE3B;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ;IAC3B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ;CAO5C;AAED,qBAAa,KAAK;IAEd,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAF3B,OAAO;IAKP,MAAM,CAAC,WAAW,IAAI,MAAM;WAOf,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IASnD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,KAAK;IAiBzF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAE/B;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK;IAQ3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAO7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAUhC"}

package/dist/excel/excel.js

@@ -0,0 +1,94 @@
+import ExcelJS from "exceljs";
+import * as fs from "fs";
+import * as path from "path";
+import { Range } from "./range.js";
+export class Sheet {
+    worksheet;
+    constructor(worksheet) {
+        this.worksheet = worksheet;
+    }
+    get name() {
+        return this.worksheet.name;
+    }
+    get raw() {
+        return this.worksheet;
+    }
+    range(startOrA1, end) {
+        if (end !== undefined) {
+            return Range.between(startOrA1, end);
+        }
+        return Range.parse(startOrA1);
+    }
+}
+export class Excel {
+    wb;
+    filePath;
+    constructor(wb, filePath) {
+        this.wb = wb;
+        this.filePath = filePath;
+    }
+    static pagingLimit() {
+        const raw = process.env.EXCEL_PAGING_CELLS_LIMIT;
+        if (raw === undefined || raw === "")
+            return 4000;
+        const n = parseInt(raw, 10);
+        return Number.isFinite(n) && n > 0 ? n : 4000;
+    }
+    static async open(filePath) {
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        const workbook = new ExcelJS.Workbook();
+        await workbook.xlsx.readFile(filePath);
+        return new Excel(workbook, filePath);
+    }
+    static create(filePath, opts) {
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const workbook = new ExcelJS.Workbook();
+        const sheetName = opts?.sheetName ?? "Sheet1";
+        const worksheet = workbook.addWorksheet(sheetName);
+        if (opts?.headers && opts.headers.length > 0) {
+            worksheet.addRow(opts.headers);
+        }
+        return new Excel(workbook, filePath);
+    }
+    get path() {
+        return this.filePath;
+    }
+    get workbook() {
+        return this.wb;
+    }
+    async save() {
+        await this.wb.xlsx.writeFile(this.filePath);
+    }
+    sheet(name) {
+        const worksheet = name ? this.wb.getWorksheet(name) : this.wb.worksheets[0];
+        if (!worksheet) {
+            throw new Error(`Worksheet not found: "${name ?? "Index 0"}"`);
+        }
+        return new Sheet(worksheet);
+    }
+    addSheet(name) {
+        if (this.wb.getWorksheet(name)) {
+            throw new Error(`Worksheet already exists: "${name}"`);
+        }
+        return new Sheet(this.wb.addWorksheet(name));
+    }
+    hasSheet(name) {
+        return this.wb.getWorksheet(name) !== undefined;
+    }
+    removeSheet(name) {
+        if (this.wb.worksheets.length <= 1) {
+            throw new Error("Cannot delete the only worksheet in the workbook");
+        }
+        const worksheet = this.wb.getWorksheet(name);
+        if (!worksheet) {
+            throw new Error(`Worksheet not found: "${name}"`);
+        }
+        this.wb.removeWorksheet(worksheet.id);
+    }
+}
+//# sourceMappingURL=excel.js.map

package/dist/excel/excel.js.map

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

package/dist/excel/range.d.ts

@@ -0,0 +1,15 @@
+export type A1Bounds = {
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+};
+export declare class Range {
+    static letterToCol(letter: string): number;
+    static colToLetter(col: number): string;
+    static address(row: number, col: number): string;
+    static toA1(bounds: A1Bounds): string;
+    static parse(rangeStr: string): A1Bounds;
+    static between(startCell: string, endCell?: string): A1Bounds;
+}
+//# sourceMappingURL=range.d.ts.map

package/dist/excel/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/excel/range.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,qBAAa,KAAK;IAChB,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAY1C,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAWvC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIhD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IAQrC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IAyBxC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;CAa9D"}