xlsx-to-markdown 0.1.1

package/dist/cell-formatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import * as XLSX from "xlsx";
+import type { ConvertOptions, ConvertResult } from "./types.js";
+export type { ConvertOptions, ConvertResult, SheetResult, Region, RegionType } from "./types.js";
+/**
+ * Convert an XLSX file (given as a file path or a Buffer/Uint8Array) to Markdown.
+ *
+ * @example
+ * ```ts
+ * import { convertXlsxToMarkdown } from 'xlsx-to-markdown';
+ *
+ * const result = await convertXlsxToMarkdown('report.xlsx');
+ * console.log(result.markdown);
+ * ```
+ */
+export declare function convertXlsxToMarkdown(input: string | Buffer | Uint8Array, options?: ConvertOptions): Promise<ConvertResult>;
+/**
+ * Convert an already-parsed XLSX.WorkBook to Markdown.
+ * Useful when you have already read the workbook using SheetJS.
+ */
+export declare function convertWorkbook(workbook: XLSX.WorkBook, options?: ConvertOptions): ConvertResult;
+//# 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":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjG;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,EACnC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,EACvB,OAAO,GAAE,cAAmB,GAC3B,aAAa,CAGf"}

package/dist/index.js

@@ -0,0 +1,129 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertXlsxToMarkdown = convertXlsxToMarkdown;
+exports.convertWorkbook = convertWorkbook;
+const fs = __importStar(require("fs"));
+const XLSX = __importStar(require("xlsx"));
+const options_js_1 = require("./options.js");
+const sheet_converter_js_1 = require("./sheet-converter.js");
+/**
+ * Convert an XLSX file (given as a file path or a Buffer/Uint8Array) to Markdown.
+ *
+ * @example
+ * ```ts
+ * import { convertXlsxToMarkdown } from 'xlsx-to-markdown';
+ *
+ * const result = await convertXlsxToMarkdown('report.xlsx');
+ * console.log(result.markdown);
+ * ```
+ */
+async function convertXlsxToMarkdown(input, options = {}) {
+    const opts = (0, options_js_1.resolveOptions)(options);
+    let workbook;
+    if (typeof input === "string") {
+        const buffer = await fs.promises.readFile(input);
+        workbook = XLSX.read(buffer, { type: "buffer", cellStyles: true, cellDates: false });
+    }
+    else {
+        workbook = XLSX.read(input, { type: "buffer", cellStyles: true, cellDates: false });
+    }
+    return _convert(workbook, opts);
+}
+/**
+ * Convert an already-parsed XLSX.WorkBook to Markdown.
+ * Useful when you have already read the workbook using SheetJS.
+ */
+function convertWorkbook(workbook, options = {}) {
+    const opts = (0, options_js_1.resolveOptions)(options);
+    return _convert(workbook, opts);
+}
+// ---------------------------------------------------------------------------
+// Internal
+// ---------------------------------------------------------------------------
+/**
+ * Escape Markdown inline special characters in a sheet name used as a heading.
+ * Prevents characters like *, _, `, [, ] from being interpreted as Markdown syntax.
+ */
+function escapeMarkdownHeading(name) {
+    return name.replace(/[\\*_`[\]<>!]/g, "\\$&");
+}
+function _convert(workbook, opts) {
+    const allSheetNames = workbook.SheetNames;
+    // Filter sheets
+    let sheetNames;
+    if (opts.sheets && opts.sheets.length > 0) {
+        // When an explicit filter is given, honour it regardless of sheet visibility.
+        sheetNames = opts.sheets.map((s) => {
+            if (typeof s === "number") {
+                const name = allSheetNames[s];
+                if (!name)
+                    throw new Error(`Sheet index ${s} is out of range`);
+                return name;
+            }
+            if (!allSheetNames.includes(s))
+                throw new Error(`Sheet "${s}" not found`);
+            return s;
+        });
+    }
+    else {
+        // Default: process only visible sheets (ADR-0021).
+        sheetNames = allSheetNames.filter((_, i) => {
+            const meta = workbook.Workbook?.Sheets?.[i];
+            return !meta?.Hidden; // Hidden=0 visible, Hidden=1 hidden, Hidden=2 very hidden
+        });
+    }
+    // Resolve heading behaviour
+    const addSheetHeadings = opts.sheetHeadings === "auto" ? sheetNames.length > 1 : opts.sheetHeadings;
+    const sheetResults = sheetNames.map((name) => {
+        const ws = workbook.Sheets[name];
+        return (0, sheet_converter_js_1.convertSheet)(ws, name, allSheetNames.indexOf(name), opts);
+    });
+    // Combine sheets
+    const parts = [];
+    for (const sheet of sheetResults) {
+        if (addSheetHeadings) {
+            // Escape special characters so sheet names don't break Markdown inline syntax (ADR-0020).
+            parts.push(`## ${escapeMarkdownHeading(sheet.name)}\n\n${sheet.markdown}`);
+        }
+        else {
+            parts.push(sheet.markdown);
+        }
+    }
+    const separator = "\n".repeat(opts.blankLinesBetweenRegions + 2);
+    const markdown = parts.filter(Boolean).join(separator);
+    return { markdown, sheets: sheetResults };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/options.d.ts

@@ -0,0 +1,3 @@
+import type { ConvertOptions, ResolvedOptions } from "./types.js";
+export declare function resolveOptions(opts?: ConvertOptions): ResolvedOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,wBAAgB,cAAc,CAAC,IAAI,GAAE,cAAmB,GAAG,eAAe,CAezE"}

package/dist/options.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOptions = resolveOptions;
+function resolveOptions(opts = {}) {
+    return {
+        sheets: opts.sheets,
+        sheetHeadings: opts.sheetHeadings ?? "auto",
+        headerRow: opts.headerRow ?? true,
+        tableDetection: {
+            minColumns: opts.tableDetection?.minColumns ?? 2,
+            minRows: opts.tableDetection?.minRows ?? 2,
+            useBorders: opts.tableDetection?.useBorders ?? true,
+        },
+        richText: opts.richText ?? true,
+        emptyCell: opts.emptyCell ?? "",
+        dateFormat: opts.dateFormat ?? "YYYY-MM-DD",
+        blankLinesBetweenRegions: opts.blankLinesBetweenRegions ?? 1,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":";;AAEA,wCAeC;AAfD,SAAgB,cAAc,CAAC,OAAuB,EAAE;IACtD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,MAAM;QAC3C,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,cAAc,EAAE;YACd,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,IAAI,CAAC;YAChD,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,IAAI,CAAC;YAC1C,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,IAAI,IAAI;SACpD;QACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,YAAY;QAC3C,wBAAwB,EAAE,IAAI,CAAC,wBAAwB,IAAI,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/paragraph-renderer.d.ts

@@ -0,0 +1,14 @@
+import * as XLSX from "xlsx";
+import type { ResolvedOptions } from "./types.js";
+/**
+ * Render a paragraph region as a Markdown paragraph.
+ *
+ * For each non-empty cell in the region (scanned left-to-right, top-to-bottom),
+ * the text content is collected.  Multiple cells in the same row are joined
+ * with a space.  Each row becomes one "line" in the paragraph block.
+ * Consecutive non-empty lines are separated by a blank line only when a
+ * completely empty row appears between them; otherwise they are joined as a
+ * single paragraph.
+ */
+export declare function renderParagraph(ws: XLSX.WorkSheet, startRow: number, endRow: number, startCol: number, endCol: number, merges: XLSX.Range[], opts: ResolvedOptions, hiddenRows?: Set<number>, hiddenCols?: Set<number>): string;
+//# sourceMappingURL=paragraph-renderer.d.ts.map

package/dist/paragraph-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph-renderer.d.ts","sourceRoot":"","sources":["../src/paragraph-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,IAAI,CAAC,SAAS,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,EACpB,IAAI,EAAE,eAAe,EACrB,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,EACnC,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,GAClC,MAAM,CAuBR"}

package/dist/paragraph-renderer.js

@@ -0,0 +1,85 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderParagraph = renderParagraph;
+const XLSX = __importStar(require("xlsx"));
+const cell_formatter_js_1 = require("./cell-formatter.js");
+/**
+ * Render a paragraph region as a Markdown paragraph.
+ *
+ * For each non-empty cell in the region (scanned left-to-right, top-to-bottom),
+ * the text content is collected.  Multiple cells in the same row are joined
+ * with a space.  Each row becomes one "line" in the paragraph block.
+ * Consecutive non-empty lines are separated by a blank line only when a
+ * completely empty row appears between them; otherwise they are joined as a
+ * single paragraph.
+ */
+function renderParagraph(ws, startRow, endRow, startCol, endCol, merges, opts, hiddenRows = new Set(), hiddenCols = new Set()) {
+    const mergedChildCells = buildMergedChildSet(merges);
+    const lines = [];
+    for (let r = startRow; r <= endRow; r++) {
+        if (hiddenRows.has(r))
+            continue;
+        const parts = [];
+        for (let c = startCol; c <= endCol; c++) {
+            if (hiddenCols.has(c))
+                continue;
+            const addr = XLSX.utils.encode_cell({ r, c });
+            const cell = ws[addr];
+            const data = (0, cell_formatter_js_1.extractCellData)(cell, mergedChildCells, addr, opts);
+            if (!data.isMergedChild && data.value.trim()) {
+                parts.push(data.value.trim());
+            }
+        }
+        if (parts.length > 0) {
+            lines.push(parts.join(" "));
+        }
+    }
+    return lines.join("\n\n");
+}
+function buildMergedChildSet(merges) {
+    const set = new Set();
+    for (const m of merges) {
+        for (let r = m.s.r; r <= m.e.r; r++) {
+            for (let c = m.s.c; c <= m.e.c; c++) {
+                if (r === m.s.r && c === m.s.c)
+                    continue;
+                set.add(XLSX.utils.encode_cell({ r, c }));
+            }
+        }
+    }
+    return set;
+}
+//# sourceMappingURL=paragraph-renderer.js.map

package/dist/paragraph-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph-renderer.js","sourceRoot":"","sources":["../src/paragraph-renderer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,0CAiCC;AA/CD,2CAA6B;AAE7B,2DAAsD;AAEtD;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAC7B,EAAkB,EAClB,QAAgB,EAChB,MAAc,EACd,QAAgB,EAChB,MAAc,EACd,MAAoB,EACpB,IAAqB,EACrB,aAA0B,IAAI,GAAG,EAAE,EACnC,aAA0B,IAAI,GAAG,EAAE;IAEnC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAErD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAChC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAgC,EAAE,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,IAAA,mCAAe,EAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACjE,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAoB;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBAAE,SAAS;gBACzC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/region-detector.d.ts

@@ -0,0 +1,19 @@
+import type { RowInfo, RegionType, ResolvedOptions } from "./types.js";
+export interface RawRegion {
+    type: RegionType;
+    startRow: number;
+    endRow: number;
+    startCol: number;
+    endCol: number;
+}
+/**
+ * Detect content regions from a list of RowInfo objects.
+ *
+ * Algorithm (recursive):
+ * 1. Split rows by empty rows → "bands" of consecutive non-empty rows
+ * 2. Within each band, find contiguous column groups (split at all-empty columns)
+ * 3. If multiple column groups exist → recurse into each (handles side-by-side tables)
+ * 4. If a single column group → classify rows as table or paragraph by density
+ */
+export declare function detectRegions(rows: RowInfo[], opts: ResolvedOptions): RawRegion[];
+//# sourceMappingURL=region-detector.d.ts.map

package/dist/region-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-detector.d.ts","sourceRoot":"","sources":["../src/region-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,eAAe,GAAG,SAAS,EAAE,CAMjF"}

package/dist/region-detector.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRegions = detectRegions;
+/**
+ * Detect content regions from a list of RowInfo objects.
+ *
+ * Algorithm (recursive):
+ * 1. Split rows by empty rows → "bands" of consecutive non-empty rows
+ * 2. Within each band, find contiguous column groups (split at all-empty columns)
+ * 3. If multiple column groups exist → recurse into each (handles side-by-side tables)
+ * 4. If a single column group → classify rows as table or paragraph by density
+ */
+function detectRegions(rows, opts) {
+    const nonEmpty = rows.filter((r) => r.filledCount > 0);
+    if (nonEmpty.length === 0)
+        return [];
+    const colStart = Math.min(...nonEmpty.map((r) => r.minCol));
+    const colEnd = Math.max(...nonEmpty.map((r) => r.maxCol));
+    return detectInRange(rows, colStart, colEnd, opts);
+}
+// ---------------------------------------------------------------------------
+// Core recursive implementation
+// ---------------------------------------------------------------------------
+function detectInRange(rows, colStart, colEnd, opts) {
+    const regions = [];
+    let i = 0;
+    while (i < rows.length) {
+        if (countInRange(rows[i].filledCols, colStart, colEnd) === 0) {
+            i++;
+            continue;
+        }
+        // Collect a band: consecutive rows with ≥1 filled cell in [colStart, colEnd]
+        const band = [];
+        let j = i;
+        while (j < rows.length && countInRange(rows[j].filledCols, colStart, colEnd) > 0) {
+            band.push(rows[j]);
+            j++;
+        }
+        // Build the set of filled columns within this band
+        const bandFilledCols = new Set();
+        for (const r of band) {
+            for (const c of r.filledCols) {
+                if (c >= colStart && c <= colEnd)
+                    bandFilledCols.add(c);
+            }
+        }
+        // Split the band by column gaps
+        const subRanges = findColSubRanges(bandFilledCols);
+        if (subRanges.length > 1) {
+            // Multiple column groups → recurse into each (separates side-by-side tables)
+            for (const [sc, ec] of subRanges) {
+                regions.push(...detectInRange(band, sc, ec, opts));
+            }
+        }
+        else {
+            // Single column group → classify rows by density
+            const [sc, ec] = subRanges[0] ?? [colStart, colEnd];
+            regions.push(...classifyBand(band, sc, ec, opts));
+        }
+        i = j;
+    }
+    return regions;
+}
+/**
+ * Classify a band of rows (no empty rows) within a fixed column range into
+ * table and paragraph regions based on row density.
+ *
+ * When useBorders is enabled two extra rules apply:
+ * 1. Table-start boundary: all rows before the first row that has a vertical
+ *    border (left or right) are emitted as paragraphs, regardless of density.
+ *    This lets a caption/title row sitting directly above a bordered table
+ *    be correctly classified as a paragraph even when it is "dense".
+ * 2. Table-row criterion: within the density loop, a row is treated as a
+ *    table-candidate when it has vertical borders, even if its filled-column
+ *    count is below minColumns.  This ensures that rows with only vertical
+ *    cell borders (no horizontal borders) are still included in the table.
+ */
+function classifyBand(band, colStart, colEnd, opts) {
+    const { minColumns, minRows, useBorders } = opts.tableDetection;
+    const regions = [];
+    let i = 0;
+    // Border-based table-start detection: emit leading rows without vertical
+    // borders as paragraphs so that the table starts at the first row that has
+    // vertical (column-structure) borders.
+    if (useBorders) {
+        const firstVerticalBorderIdx = band.findIndex((r) => r.hasVerticalBorder);
+        if (firstVerticalBorderIdx > 0) {
+            const paraRows = band.slice(0, firstVerticalBorderIdx);
+            regions.push({
+                type: "paragraph",
+                startRow: paraRows[0].index,
+                endRow: paraRows[paraRows.length - 1].index,
+                startCol: colStart,
+                endCol: colEnd,
+            });
+            i = firstVerticalBorderIdx;
+        }
+    }
+    // Helper: is this row a table candidate?
+    // When useBorders is on, vertical borders are sufficient even without density.
+    const isTableCandidate = (row) => {
+        if (countInRange(row.filledCols, colStart, colEnd) >= minColumns)
+            return true;
+        if (useBorders && row.hasVerticalBorder)
+            return true;
+        return false;
+    };
+    while (i < band.length) {
+        if (isTableCandidate(band[i])) {
+            // Table candidate row — try to extend a table downward
+            const tableRows = [band[i]];
+            let j = i + 1;
+            while (j < band.length && isTableCandidate(band[j])) {
+                tableRows.push(band[j]);
+                j++;
+            }
+            if (tableRows.length >= minRows) {
+                regions.push({
+                    type: "table",
+                    startRow: tableRows[0].index,
+                    endRow: tableRows[tableRows.length - 1].index,
+                    startCol: colStart,
+                    endCol: colEnd,
+                });
+            }
+            else {
+                // Below minRows → demote each row to its own paragraph
+                for (const r of tableRows) {
+                    regions.push({
+                        type: "paragraph",
+                        startRow: r.index,
+                        endRow: r.index,
+                        startCol: colStart,
+                        endCol: colEnd,
+                    });
+                }
+            }
+            i = j;
+        }
+        else {
+            // Non-candidate rows → paragraph
+            const paraRows = [band[i]];
+            let j = i + 1;
+            while (j < band.length && !isTableCandidate(band[j])) {
+                paraRows.push(band[j]);
+                j++;
+            }
+            regions.push({
+                type: "paragraph",
+                startRow: paraRows[0].index,
+                endRow: paraRows[paraRows.length - 1].index,
+                startCol: colStart,
+                endCol: colEnd,
+            });
+            i = j;
+        }
+    }
+    return regions;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Find contiguous column sub-ranges from a set of filled column indices.
+ * Columns with a gap (≥2 apart) start a new sub-range.
+ */
+function findColSubRanges(filledCols) {
+    const sorted = [...filledCols].sort((a, b) => a - b);
+    if (sorted.length === 0)
+        return [];
+    const ranges = [];
+    let rangeStart = sorted[0];
+    let prev = sorted[0];
+    for (let i = 1; i < sorted.length; i++) {
+        if (sorted[i] > prev + 1) {
+            ranges.push([rangeStart, prev]);
+            rangeStart = sorted[i];
+        }
+        prev = sorted[i];
+    }
+    ranges.push([rangeStart, prev]);
+    return ranges;
+}
+function countInRange(filledCols, colStart, colEnd) {
+    let count = 0;
+    for (const c of filledCols) {
+        if (c >= colStart && c <= colEnd)
+            count++;
+    }
+    return count;
+}
+//# sourceMappingURL=region-detector.js.map

package/dist/region-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-detector.js","sourceRoot":"","sources":["../src/region-detector.ts"],"names":[],"mappings":";;AAmBA,sCAMC;AAfD;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,IAAe,EAAE,IAAqB;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,OAAO,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,SAAS,aAAa,CACpB,IAAe,EACf,QAAgB,EAChB,MAAc,EACd,IAAqB;IAErB,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,6EAA6E;QAC7E,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACjF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC,EAAE,CAAC;QACN,CAAC;QAED,mDAAmD;QACnD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBAC7B,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,MAAM;oBAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAEnD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,6EAA6E;YAC7E,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,iDAAiD;YACjD,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,CAAC,GAAG,CAAC,CAAC;IACR,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,YAAY,CACnB,IAAe,EACf,QAAgB,EAChB,MAAc,EACd,IAAqB;IAErB,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC;IAChE,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,yEAAyE;IACzE,2EAA2E;IAC3E,uCAAuC;IACvC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,sBAAsB,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC1E,IAAI,sBAAsB,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK;gBAC3B,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK;gBAC3C,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,MAAM;aACf,CAAC,CAAC;YACH,CAAC,GAAG,sBAAsB,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,+EAA+E;IAC/E,MAAM,gBAAgB,GAAG,CAAC,GAAY,EAAW,EAAE;QACjD,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,UAAU;YAAE,OAAO,IAAI,CAAC;QAC9E,IAAI,UAAU,IAAI,GAAG,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9B,uDAAuD;YACvD,MAAM,SAAS,GAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxB,CAAC,EAAE,CAAC;YACN,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK;oBAC5B,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK;oBAC7C,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,MAAM;iBACf,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,uDAAuD;gBACvD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;oBAC1B,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,WAAW;wBACjB,QAAQ,EAAE,CAAC,CAAC,KAAK;wBACjB,MAAM,EAAE,CAAC,CAAC,KAAK;wBACf,QAAQ,EAAE,QAAQ;wBAClB,MAAM,EAAE,MAAM;qBACf,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,CAAC,GAAG,CAAC,CAAC;QACR,CAAC;aAAM,CAAC;YACN,iCAAiC;YACjC,MAAM,QAAQ,GAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvB,CAAC,EAAE,CAAC;YACN,CAAC;YACD,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK;gBAC3B,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK;gBAC3C,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,MAAM;aACf,CAAC,CAAC;YACH,CAAC,GAAG,CAAC,CAAC;QACR,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,gBAAgB,CAAC,UAAuB;IAC/C,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,IAAI,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;YAChC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,UAAuB,EAAE,QAAgB,EAAE,MAAc;IAC7E,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,MAAM;YAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/sheet-converter.d.ts

@@ -0,0 +1,7 @@
+import * as XLSX from "xlsx";
+import type { ResolvedOptions, SheetResult } from "./types.js";
+/**
+ * Convert a single worksheet to Markdown.
+ */
+export declare function convertSheet(ws: XLSX.WorkSheet, sheetName: string, sheetIndex: number, opts: ResolvedOptions): SheetResult;
+//# sourceMappingURL=sheet-converter.d.ts.map

package/dist/sheet-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-converter.d.ts","sourceRoot":"","sources":["../src/sheet-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAU,eAAe,EAAW,WAAW,EAAE,MAAM,YAAY,CAAC;AAKhF;;GAEG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,IAAI,CAAC,SAAS,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,eAAe,GACpB,WAAW,CA6Rb"}