@achmadya-dev/mcp-excel-query 0.3.0

package/dist/tools/excel_format_range.js

@@ -0,0 +1,157 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Cell } from "../excel/cell.js";
+import { Excel } from "../excel/excel.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const sheetNameOptional = z
+    .string()
+    .optional()
+    .describe("Name of the worksheet (defaults to the first sheet)");
+const borderSideSchema = z
+    .object({
+    style: z.string().optional(),
+    color: z.string().optional(),
+})
+    .optional();
+const cellStyleSchema = z.object({
+    font: z
+        .object({
+        name: z.string().optional(),
+        size: z.number().optional(),
+        bold: z.boolean().optional(),
+        italic: z.boolean().optional(),
+        underline: z.boolean().optional(),
+        color: z.string().optional(),
+    })
+        .optional(),
+    fill: z
+        .object({
+        type: z.enum(["pattern", "gradient"]).optional(),
+        pattern: z.string().optional(),
+        fgColor: z.string().optional(),
+        bgColor: z.string().optional(),
+    })
+        .optional(),
+    alignment: z
+        .object({
+        horizontal: z.enum(["left", "center", "right", "justify", "distributed"]).optional(),
+        vertical: z.enum(["top", "middle", "bottom", "justify", "distributed"]).optional(),
+        wrapText: z.boolean().optional(),
+    })
+        .optional(),
+    border: z
+        .object({
+        top: borderSideSchema,
+        left: borderSideSchema,
+        bottom: borderSideSchema,
+        right: borderSideSchema,
+    })
+        .optional(),
+    numFmt: z.string().optional(),
+});
+const formatRangeInputSchema = z.object({
+    filePath: filePathField,
+    sheetName: sheetNameOptional,
+    startCell: z.string(),
+    endCell: z.string().optional(),
+    range: z.string().optional(),
+    bold: z.boolean().optional(),
+    italic: z.boolean().optional(),
+    underline: z.boolean().optional(),
+    fontSize: z.number().optional(),
+    fontColor: z.string().optional(),
+    bgColor: z.string().optional(),
+    borderStyle: z.string().optional(),
+    borderColor: z.string().optional(),
+    numberFormat: z.string().optional(),
+    alignment: z.string().optional(),
+    wrapText: z.boolean().optional(),
+    mergeCells: z.boolean().optional().describe("Merge the range while applying format"),
+    styles: z.array(z.array(cellStyleSchema.nullable())).optional(),
+});
+const operationResultOutputShape = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+export const excel_format_range = defineTool({
+    name: "excel_format_range",
+    description: "Format a cell range (font, fill, border, alignment, numFmt). Set mergeCells:true to merge. Use for styling after excel_write_range.",
+    inputSchema: formatRangeInputSchema,
+    outputSchema: operationResultOutputShape,
+    handler: async (args) => {
+        try {
+            const excel = await Excel.open(args.filePath);
+            const sheet = excel.sheet(args.sheetName);
+            const bounds = args.range
+                ? sheet.range(args.range)
+                : args.endCell
+                    ? sheet.range(args.startCell, args.endCell)
+                    : sheet.range(args.startCell);
+            const worksheet = sheet.raw;
+            const flatStyle = {};
+            if (args.bold !== undefined ||
+                args.italic !== undefined ||
+                args.underline !== undefined ||
+                args.fontSize !== undefined ||
+                args.fontColor) {
+                flatStyle.font = {
+                    ...(args.bold !== undefined ? { bold: args.bold } : {}),
+                    ...(args.italic !== undefined ? { italic: args.italic } : {}),
+                    ...(args.underline !== undefined ? { underline: args.underline } : {}),
+                    ...(args.fontSize !== undefined ? { size: args.fontSize } : {}),
+                    ...(args.fontColor ? { color: args.fontColor } : {}),
+                };
+            }
+            if (args.bgColor) {
+                flatStyle.fill = { fgColor: args.bgColor };
+            }
+            if (args.borderStyle) {
+                const side = {
+                    style: args.borderStyle,
+                    ...(args.borderColor ? { color: args.borderColor } : {}),
+                };
+                flatStyle.border = { top: side, left: side, bottom: side, right: side };
+            }
+            if (args.alignment || args.wrapText !== undefined) {
+                flatStyle.alignment = {
+                    ...(args.alignment ? { horizontal: args.alignment } : {}),
+                    ...(args.wrapText !== undefined ? { wrapText: args.wrapText } : {}),
+                };
+            }
+            if (args.numberFormat) {
+                flatStyle.numFmt = args.numberFormat;
+            }
+            const rowCount = bounds.endRow - bounds.startRow + 1;
+            const colCount = bounds.endCol - bounds.startCol + 1;
+            if (args.mergeCells) {
+                worksheet.mergeCells(bounds.startRow, bounds.startCol, bounds.endRow, bounds.endCol);
+            }
+            for (let r = 0; r < rowCount; r++) {
+                for (let c = 0; c < colCount; c++) {
+                    const cell = worksheet.getCell(bounds.startRow + r, bounds.startCol + c);
+                    let styleToApply = flatStyle;
+                    if (args.styles) {
+                        const gridStyle = args.styles[r]?.[c];
+                        if (gridStyle === null)
+                            continue;
+                        if (gridStyle)
+                            styleToApply = gridStyle;
+                    }
+                    if (styleToApply && Object.keys(styleToApply).length > 0) {
+                        Cell.applyStyle(cell, styleToApply);
+                    }
+                }
+            }
+            await excel.save();
+            return {
+                success: true,
+                message: `Formatted range ${bounds.startRow},${bounds.startCol}:${bounds.endRow},${bounds.endCol} on sheet '${worksheet.name}'`,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to format range: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_format_range.js.map

package/dist/tools/excel_format_range.js.map

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

package/dist/tools/excel_get_metadata.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_get_metadata: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_get_metadata.d.ts.map

package/dist/tools/excel_get_metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_get_metadata.d.ts","sourceRoot":"","sources":["../../src/tools/excel_get_metadata.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,kBAAkB,mDAgD7B,CAAC"}

package/dist/tools/excel_get_metadata.js

@@ -0,0 +1,71 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Excel } from "../excel/excel.js";
+import { Range } from "../excel/range.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const getMetadataInputSchema = z.object({
+    filePath: filePathField,
+    includeRanges: z.boolean().optional().describe("Include usedRange and mergedCells per sheet"),
+});
+const getMetadataOutputShape = z.object({
+    filePath: z.string(),
+    creator: z.string().nullable(),
+    lastModifiedBy: z.string().nullable(),
+    created: z.string().nullable(),
+    modified: z.string().nullable(),
+    sheets: z.array(z.object({
+        name: z.string(),
+        rowCount: z.number(),
+        columnCount: z.number(),
+        state: z.enum(["visible", "hidden", "veryHidden"]).optional(),
+        usedRange: z.string().nullable().optional(),
+        mergedCells: z.array(z.string()).optional(),
+    })),
+});
+export const excel_get_metadata = defineTool({
+    name: "excel_get_metadata",
+    description: "Workbook metadata: sheet names, dimensions, creator, dates. Use includeRanges for usedRange and mergedCells per sheet (replaces list_sheets).",
+    inputSchema: getMetadataInputSchema,
+    outputSchema: getMetadataOutputShape,
+    handler: async (args) => {
+        try {
+            const { filePath, includeRanges = false } = args;
+            const excel = await Excel.open(filePath);
+            const workbook = excel.workbook;
+            const sheets = workbook.worksheets.map((ws) => {
+                const base = {
+                    name: ws.name,
+                    rowCount: ws.rowCount,
+                    columnCount: ws.actualColumnCount || 0,
+                    state: ws.state ?? "visible",
+                };
+                if (!includeRanges)
+                    return base;
+                let usedRange = null;
+                if (ws.rowCount > 0 && (ws.actualColumnCount || 0) > 0) {
+                    usedRange = Range.toA1({
+                        startRow: 1,
+                        startCol: 1,
+                        endRow: ws.rowCount,
+                        endCol: ws.actualColumnCount || 1,
+                    });
+                }
+                const mergedCells = (ws.model.merges ?? []).map((m) => String(m));
+                return { ...base, usedRange, mergedCells };
+            });
+            return {
+                filePath,
+                creator: workbook.creator || null,
+                lastModifiedBy: workbook.lastModifiedBy || null,
+                created: workbook.created ? workbook.created.toISOString() : null,
+                modified: workbook.modified ? workbook.modified.toISOString() : null,
+                sheets,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to get metadata: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_get_metadata.js.map

package/dist/tools/excel_get_metadata.js.map

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

package/dist/tools/excel_insert_columns.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_insert_columns: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_insert_columns.d.ts.map

package/dist/tools/excel_insert_columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_insert_columns.d.ts","sourceRoot":"","sources":["../../src/tools/excel_insert_columns.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,oBAAoB,mDAyB/B,CAAC"}

package/dist/tools/excel_insert_columns.js

@@ -0,0 +1,44 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Excel } from "../excel/excel.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const sheetNameOptional = z
+    .string()
+    .optional()
+    .describe("Name of the worksheet (defaults to the first sheet)");
+const insertColumnsInputSchema = z.object({
+    filePath: filePathField,
+    sheetName: sheetNameOptional,
+    startCol: z.number(),
+    count: z.number().optional(),
+});
+const operationResultOutputShape = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+export const excel_insert_columns = defineTool({
+    name: "excel_insert_columns",
+    description: "Insert empty columns at a 1-based column index.",
+    inputSchema: insertColumnsInputSchema,
+    outputSchema: operationResultOutputShape,
+    handler: async (args) => {
+        try {
+            const { filePath, sheetName, startCol, count = 1 } = args;
+            const excel = await Excel.open(filePath);
+            const sheet = excel.sheet(sheetName);
+            sheet.raw.eachRow((row) => {
+                row.splice(startCol, 0, ...Array(count).fill(null));
+            });
+            await excel.save();
+            return {
+                success: true,
+                message: `Inserted ${count} column(s) at column ${startCol}`,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to insert columns: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_insert_columns.js.map

package/dist/tools/excel_insert_columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_insert_columns.js","sourceRoot":"","sources":["../../src/tools/excel_insert_columns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE3F,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,iBAAiB;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;IAC7C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,iDAAiD;IAC9D,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,0BAA0B;IACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAErC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACxB,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,IAAa;gBACtB,OAAO,EAAE,YAAY,KAAK,wBAAwB,QAAQ,EAAE;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,4BAA4B,GAAG,GAAG,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/excel_insert_rows.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_insert_rows: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_insert_rows.d.ts.map

package/dist/tools/excel_insert_rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_insert_rows.d.ts","sourceRoot":"","sources":["../../src/tools/excel_insert_rows.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,iBAAiB,mDAkB5B,CAAC"}

package/dist/tools/excel_insert_rows.js

@@ -0,0 +1,39 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Excel } from "../excel/excel.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const sheetNameOptional = z
+    .string()
+    .optional()
+    .describe("Name of the worksheet (defaults to the first sheet)");
+const insertRowsInputSchema = z.object({
+    filePath: filePathField,
+    sheetName: sheetNameOptional,
+    startRow: z.number(),
+    count: z.number().optional(),
+});
+const operationResultOutputShape = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+export const excel_insert_rows = defineTool({
+    name: "excel_insert_rows",
+    description: "Insert empty rows at a 1-based row index.",
+    inputSchema: insertRowsInputSchema,
+    outputSchema: operationResultOutputShape,
+    handler: async (args) => {
+        try {
+            const { filePath, sheetName, startRow, count = 1 } = args;
+            const excel = await Excel.open(filePath);
+            const sheet = excel.sheet(sheetName);
+            sheet.raw.spliceRows(startRow, 0, ...Array.from({ length: count }, () => []));
+            await excel.save();
+            return { success: true, message: `Inserted ${count} row(s) at row ${startRow}` };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to insert rows: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_insert_rows.js.map

package/dist/tools/excel_insert_rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_insert_rows.js","sourceRoot":"","sources":["../../src/tools/excel_insert_rows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE3F,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,iBAAiB;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,0BAA0B;IACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACrC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9E,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,IAAa,EAAE,OAAO,EAAE,YAAY,KAAK,kBAAkB,QAAQ,EAAE,EAAE,CAAC;QAC5F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,yBAAyB,GAAG,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/excel_read_sheet.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_read_sheet: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_read_sheet.d.ts.map

package/dist/tools/excel_read_sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_read_sheet.d.ts","sourceRoot":"","sources":["../../src/tools/excel_read_sheet.ts"],"names":[],"mappings":"AA4DA,eAAO,MAAM,gBAAgB,mDAiI3B,CAAC"}

package/dist/tools/excel_read_sheet.js

@@ -0,0 +1,147 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Cell } from "../excel/cell.js";
+import { Excel } from "../excel/excel.js";
+import { Range } from "../excel/range.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const sheetNameOptional = z
+    .string()
+    .optional()
+    .describe("Name of the worksheet (defaults to the first sheet)");
+const readSheetInputSchema = z.object({
+    filePath: filePathField,
+    sheetName: sheetNameOptional,
+    range: z.string().optional().describe("Cell range in A1 notation (e.g., 'A1:C10')"),
+    startCell: z.string().optional(),
+    endCell: z.string().optional(),
+    headerRow: z
+        .number()
+        .optional()
+        .describe("Row number containing headers, 1-indexed (defaults to 1). Set to 0 if there are no headers."),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+    showFormula: z.boolean().optional(),
+    showStyle: z.boolean().optional(),
+    previewOnly: z.boolean().optional(),
+    dateFormat: z
+        .string()
+        .optional()
+        .describe('Format date cells for output. Use Excel-style tokens (e.g. "dd mmm yyyy") or "cell" to use each cell numFmt. Defaults to ISO when omitted.'),
+});
+const readSheetOutputShape = z.object({
+    sheetName: z.string(),
+    headers: z.array(z.string()).nullable(),
+    rows: z.array(z.record(z.string(), z.any())),
+    totalRows: z.number(),
+    mergedCells: z.array(z.string()).optional(),
+    previewOnly: z.boolean().optional(),
+});
+function buildRangeFromParams(range, startCell, endCell) {
+    if (range)
+        return range;
+    if (startCell && endCell)
+        return `${startCell}:${endCell}`;
+    if (startCell)
+        return startCell;
+    return undefined;
+}
+export const excel_read_sheet = defineTool({
+    name: "excel_read_sheet",
+    description: "Read worksheet data as JSON rows. Supports range, pagination, showFormula, showStyle, dateFormat (or dateFormat: cell for per-cell numFmt). Returns mergedCells and per-cell validation metadata when present.",
+    inputSchema: readSheetInputSchema,
+    outputSchema: readSheetOutputShape,
+    handler: async (args) => {
+        try {
+            const { filePath, sheetName, headerRow = 1, limit, offset, showFormula = false, showStyle = false, previewOnly = false, dateFormat, } = args;
+            const rangeStr = buildRangeFromParams(args.range, args.startCell, args.endCell);
+            const excel = await Excel.open(filePath);
+            const sheet = excel.sheet(sheetName);
+            const worksheet = sheet.raw;
+            let startRow = 1;
+            let endRow = worksheet.rowCount;
+            let startCol = 1;
+            let endCol = worksheet.actualColumnCount || 1;
+            if (rangeStr) {
+                const parsedRange = Range.parse(rangeStr);
+                startRow = parsedRange.startRow;
+                endRow = parsedRange.endRow;
+                startCol = parsedRange.startCol;
+                endCol = parsedRange.endCol;
+            }
+            const cellCount = (endRow - startRow + 1) * (endCol - startCol + 1);
+            const pagingLimit = Excel.pagingLimit();
+            if (cellCount > pagingLimit && !previewOnly && limit === undefined) {
+                throw new Error(`Range exceeds paging limit (${cellCount} cells > ${pagingLimit}). ` +
+                    `Use limit/offset, previewOnly, or set EXCEL_PAGING_CELLS_LIMIT.`);
+            }
+            const headers = [];
+            const headerRowIdx = headerRow;
+            if (headerRowIdx > 0 && headerRowIdx <= worksheet.rowCount) {
+                const row = worksheet.getRow(headerRowIdx);
+                for (let c = startCol; c <= endCol; c++) {
+                    const cellVal = Cell.readDisplay(row.getCell(c).value, showFormula);
+                    headers.push(cellVal !== null && cellVal !== undefined && cellVal !== ""
+                        ? String(cellVal)
+                        : Range.colToLetter(c));
+                }
+            }
+            else {
+                for (let c = startCol; c <= endCol; c++) {
+                    headers.push(Range.colToLetter(c));
+                }
+            }
+            const allRows = [];
+            const startDataRow = headerRowIdx > 0 ? Math.max(startRow, headerRowIdx + 1) : startRow;
+            const effectiveEndRow = previewOnly ? Math.min(endRow, startDataRow + 9) : endRow;
+            for (let r = startDataRow; r <= effectiveEndRow; r++) {
+                const row = worksheet.getRow(r);
+                const rowData = {};
+                let hasValue = false;
+                for (let c = startCol; c <= endCol; c++) {
+                    const excelCell = row.getCell(c);
+                    const headerKey = headers[c - startCol];
+                    const cellVal = Cell.readDisplay(excelCell.value, showFormula, {
+                        dateFormat,
+                        cellNumFmt: excelCell.numFmt,
+                    });
+                    rowData[headerKey] = cellVal;
+                    if (showStyle) {
+                        const style = Cell.extractStyle(excelCell);
+                        if (style) {
+                            rowData[`__style_${headerKey}`] = JSON.parse(JSON.stringify(style));
+                        }
+                    }
+                    const validation = excelCell
+                        .dataValidation;
+                    if (validation) {
+                        rowData[`__validation_${headerKey}`] = JSON.parse(JSON.stringify(validation));
+                    }
+                    if (cellVal !== null && cellVal !== undefined && cellVal !== "") {
+                        hasValue = true;
+                    }
+                }
+                if (hasValue || rangeStr) {
+                    allRows.push(rowData);
+                }
+            }
+            const totalRows = allRows.length;
+            const off = offset ?? 0;
+            const lim = limit ?? totalRows;
+            const paginatedRows = allRows.slice(off, off + lim);
+            const mergedCells = (worksheet.model.merges ?? []).map((m) => String(m));
+            return {
+                sheetName: worksheet.name,
+                headers: headerRowIdx > 0 ? headers : null,
+                rows: paginatedRows,
+                totalRows,
+                mergedCells,
+                previewOnly,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to read sheet: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_read_sheet.js.map

package/dist/tools/excel_read_sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_read_sheet.js","sourceRoot":"","sources":["../../src/tools/excel_read_sheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE3F,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,iBAAiB;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACnF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6FAA6F,CAC9F;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4IAA4I,CAC7I;CACJ,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,SAAS,oBAAoB,CAC3B,KAAc,EACd,SAAkB,EAClB,OAAgB;IAEhB,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,SAAS,IAAI,OAAO;QAAE,OAAO,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;IAC3D,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;IACzC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,gNAAgN;IAClN,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,oBAAoB;IAClC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EACJ,QAAQ,EACR,SAAS,EACT,SAAS,GAAG,CAAC,EACb,KAAK,EACL,MAAM,EACN,WAAW,GAAG,KAAK,EACnB,SAAS,GAAG,KAAK,EACjB,WAAW,GAAG,KAAK,EACnB,UAAU,GACX,GAAG,IAAI,CAAC;YAET,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAChF,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC;YAE5B,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,IAAI,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;YAChC,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,IAAI,MAAM,GAAG,SAAS,CAAC,iBAAiB,IAAI,CAAC,CAAC;YAE9C,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC1C,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;gBAChC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;gBAC5B,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;gBAChC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;YAC9B,CAAC;YAED,MAAM,SAAS,GAAG,CAAC,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC;YACpE,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,SAAS,GAAG,WAAW,IAAI,CAAC,WAAW,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACnE,MAAM,IAAI,KAAK,CACb,+BAA+B,SAAS,YAAY,WAAW,KAAK;oBAClE,iEAAiE,CACpE,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,SAAS,CAAC;YAE/B,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBAC3D,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC3C,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;oBACpE,OAAO,CAAC,IAAI,CACV,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE;wBACzD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;wBACjB,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CACzB,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAgC,EAAE,CAAC;YAChD,MAAM,YAAY,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YACxF,MAAM,eAAe,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAElF,KAAK,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrD,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM,OAAO,GAA8B,EAAE,CAAC;gBAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC;gBAErB,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBACjC,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;oBACxC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE;wBAC7D,UAAU;wBACV,UAAU,EAAE,SAAS,CAAC,MAAM;qBAC7B,CAAC,CAAC;oBACH,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;oBAE7B,IAAI,SAAS,EAAE,CAAC;wBACd,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;wBAC3C,IAAI,KAAK,EAAE,CAAC;4BACV,OAAO,CAAC,WAAW,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAc,CAAC;wBACnF,CAAC;oBACH,CAAC;oBAED,MAAM,UAAU,GAAI,SAAyD;yBAC1E,cAAc,CAAC;oBAClB,IAAI,UAAU,EAAE,CAAC;wBACf,OAAO,CAAC,gBAAgB,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAC/C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CACd,CAAC;oBACjB,CAAC;oBAED,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;wBAChE,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC;gBACH,CAAC;gBAED,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;oBACzB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;YACjC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC;YACxB,MAAM,GAAG,GAAG,KAAK,IAAI,SAAS,CAAC;YAC/B,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;YAEpD,MAAM,WAAW,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAEzE,OAAO;gBACL,SAAS,EAAE,SAAS,CAAC,IAAI;gBACzB,OAAO,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;gBAC1C,IAAI,EAAE,aAAa;gBACnB,SAAS;gBACT,WAAW;gBACX,WAAW;aACZ,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,wBAAwB,GAAG,GAAG,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/excel_rename_sheet.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_rename_sheet: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_rename_sheet.d.ts.map

package/dist/tools/excel_rename_sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_rename_sheet.d.ts","sourceRoot":"","sources":["../../src/tools/excel_rename_sheet.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,kBAAkB,mDAuB7B,CAAC"}

package/dist/tools/excel_rename_sheet.js

@@ -0,0 +1,37 @@
+import { defineTool, ToolError } from "@achmadya-dev/mcp-core";
+import { z } from "zod";
+import { Excel } from "../excel/excel.js";
+const filePathField = z.string().describe("Absolute path to the local Excel file (.xlsx)");
+const renameSheetInputSchema = z.object({
+    filePath: filePathField,
+    oldName: z.string(),
+    newName: z.string(),
+});
+const operationResultOutputShape = z.object({
+    success: z.boolean(),
+    message: z.string(),
+});
+export const excel_rename_sheet = defineTool({
+    name: "excel_rename_sheet",
+    description: "Rename a worksheet.",
+    inputSchema: renameSheetInputSchema,
+    outputSchema: operationResultOutputShape,
+    handler: async (args) => {
+        try {
+            const { filePath, oldName, newName } = args;
+            const excel = await Excel.open(filePath);
+            const sheet = excel.sheet(oldName);
+            if (excel.hasSheet(newName)) {
+                throw new Error(`Worksheet already exists: "${newName}"`);
+            }
+            sheet.raw.name = newName;
+            await excel.save();
+            return { success: true, message: `Sheet renamed from '${oldName}' to '${newName}'` };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new ToolError("Failed to rename sheet: " + msg);
+        }
+    },
+});
+//# sourceMappingURL=excel_rename_sheet.js.map

package/dist/tools/excel_rename_sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_rename_sheet.js","sourceRoot":"","sources":["../../src/tools/excel_rename_sheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE3F,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;IAC3C,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,qBAAqB;IAClC,WAAW,EAAE,sBAAsB;IACnC,YAAY,EAAE,0BAA0B;IACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEnC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,GAAG,CAAC,CAAC;YAC5D,CAAC;YAED,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;YACzB,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,IAAa,EAAE,OAAO,EAAE,uBAAuB,OAAO,SAAS,OAAO,GAAG,EAAE,CAAC;QAChG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,0BAA0B,GAAG,GAAG,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/excel_set_data_validation.d.ts

@@ -0,0 +1,2 @@
+export declare const excel_set_data_validation: import("@achmadya-dev/mcp-core").RegisterableTool;
+//# sourceMappingURL=excel_set_data_validation.d.ts.map

package/dist/tools/excel_set_data_validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel_set_data_validation.d.ts","sourceRoot":"","sources":["../../src/tools/excel_set_data_validation.ts"],"names":[],"mappings":"AA4GA,eAAO,MAAM,yBAAyB,mDAgEpC,CAAC"}