xlsx-to-markdown 0.1.1

package/dist/sheet-converter.js

@@ -0,0 +1,299 @@
+"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.convertSheet = convertSheet;
+const XLSX = __importStar(require("xlsx"));
+const region_detector_js_1 = require("./region-detector.js");
+const table_renderer_js_1 = require("./table-renderer.js");
+const paragraph_renderer_js_1 = require("./paragraph-renderer.js");
+/**
+ * Convert a single worksheet to Markdown.
+ */
+function convertSheet(ws, sheetName, sheetIndex, opts) {
+    const ref = ws["!ref"];
+    if (!ref) {
+        return { name: sheetName, index: sheetIndex, markdown: "", regions: [] };
+    }
+    const range = XLSX.utils.decode_range(ref);
+    const merges = ws["!merges"] ?? [];
+    const mergedCellInfo = buildMergedCellInfo(merges);
+    // Excel ListObject tables always have an autofilter; use that range to treat
+    // all cells within it as non-empty regardless of their value.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const autofilterRef = ws["!autofilter"]?.ref;
+    const autofilterRange = autofilterRef ? XLSX.utils.decode_range(autofilterRef) : null;
+    // Issue 1: Build sets of hidden row/column indices for use in detection and rendering
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const rowsConfig = ws["!rows"] ?? [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const colsConfig = ws["!cols"] ?? [];
+    const hiddenRows = new Set();
+    const hiddenCols = new Set();
+    for (let r = range.s.r; r <= range.e.r; r++) {
+        if (rowsConfig[r]?.hidden)
+            hiddenRows.add(r);
+    }
+    for (let c = range.s.c; c <= range.e.c; c++) {
+        if (colsConfig[c]?.hidden)
+            hiddenCols.add(c);
+    }
+    // Collect RowInfo for each row in the sheet.
+    // For the blank-separator-column detection (below), we also track two extra
+    // per-row sets that are NOT part of the public RowInfo type:
+    //   borderPromotedCols — columns added to filledCols solely by the LR-border rule
+    //   borderTopBottomCols — columns that have a top or bottom border in this row
+    const rowInfos = [];
+    const rowBorderPromotedCols = []; // parallel to rowInfos
+    const rowBorderTopBottomCols = []; // parallel to rowInfos
+    for (let r = range.s.r; r <= range.e.r; r++) {
+        if (hiddenRows.has(r))
+            continue; // Issue 1: skip hidden rows
+        let filledCount = 0;
+        let hasBorder = false;
+        let hasVerticalBorder = false;
+        const filledCols = new Set();
+        const borderPromotedCols = new Set();
+        const borderTopBottomCols = new Set();
+        for (let c = range.s.c; c <= range.e.c; c++) {
+            if (hiddenCols.has(c))
+                continue; // Issue 1: skip hidden columns
+            const addr = XLSX.utils.encode_cell({ r, c });
+            if (mergedCellInfo.childCells.has(addr)) {
+                // Issue 2: check master cell's borders for this merged child
+                const masterAddr = mergedCellInfo.childToMaster.get(addr);
+                if (masterAddr) {
+                    const masterCell = ws[masterAddr];
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const style = masterCell?.s;
+                    if (style?.border) {
+                        const b = style.border;
+                        if (b.top?.style || b.bottom?.style || b.left?.style || b.right?.style) {
+                            hasBorder = true;
+                        }
+                        if (b.top?.style || b.bottom?.style) {
+                            borderTopBottomCols.add(c);
+                        }
+                        if (b.left?.style || b.right?.style) {
+                            hasVerticalBorder = true;
+                        }
+                    }
+                }
+                // Vertical rowspan: the master cell is in a previous row and spans into
+                // this row. Count this column as filled so that rows under a rowspan are
+                // not penalised in the density check (which would cause the band to be
+                // classified as a paragraph instead of a table).
+                if (!filledCols.has(c)) {
+                    const masterAddr = mergedCellInfo.childToMaster.get(addr);
+                    if (masterAddr) {
+                        const masterPos = XLSX.utils.decode_cell(masterAddr);
+                        if (masterPos.r < r) {
+                            const masterCell = ws[masterAddr];
+                            const masterHasValue = masterCell !== undefined &&
+                                masterCell.v !== undefined &&
+                                masterCell.v !== null &&
+                                masterCell.v !== "";
+                            if (masterHasValue) {
+                                filledCols.add(c);
+                                filledCount++;
+                            }
+                        }
+                    }
+                }
+                continue;
+            }
+            const cell = ws[addr];
+            const hasValue = cell !== undefined && cell.v !== undefined && cell.v !== null && cell.v !== "";
+            const inAutofilter = autofilterRange !== null &&
+                r >= autofilterRange.s.r &&
+                r <= autofilterRange.e.r &&
+                c >= autofilterRange.s.c &&
+                c <= autofilterRange.e.c;
+            if (hasValue) {
+                filledCols.add(c);
+                filledCount++;
+                // Issue 6: for horizontally merged master cells, count all spanned
+                // columns so that density reflects the visual column footprint
+                const colEnd = mergedCellInfo.masterColEnd.get(addr);
+                if (colEnd !== undefined) {
+                    for (let sc = c + 1; sc <= colEnd; sc++) {
+                        if (hiddenCols.has(sc))
+                            continue; // Issue 1
+                        filledCols.add(sc);
+                        filledCount++;
+                    }
+                }
+            }
+            else if (inAutofilter && !filledCols.has(c)) {
+                // Cells within an Excel table (autofilter) range are treated as non-empty
+                // so that empty cells in a ListObject do not break table detection.
+                filledCols.add(c);
+                filledCount++;
+            }
+            // Check for borders on any cell (including empty cells)
+            if (cell) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const style = cell.s;
+                if (style?.border) {
+                    const b = style.border;
+                    if (b.top?.style || b.bottom?.style || b.left?.style || b.right?.style) {
+                        hasBorder = true;
+                    }
+                    if (b.top?.style || b.bottom?.style) {
+                        borderTopBottomCols.add(c);
+                    }
+                    if (b.left?.style || b.right?.style) {
+                        hasVerticalBorder = true;
+                        // When useBorders is enabled, treat cells with BOTH left and right
+                        // vertical borders as non-empty so that bordered-but-valueless cells
+                        // (common in Excel table formatting) contribute to column density.
+                        // Whether this promotion should be rolled back for blank separator
+                        // columns is decided after band identification (see below).
+                        if (opts.tableDetection.useBorders &&
+                            b.left?.style &&
+                            b.right?.style &&
+                            !filledCols.has(c)) {
+                            filledCols.add(c);
+                            filledCount++;
+                            borderPromotedCols.add(c);
+                        }
+                    }
+                }
+            }
+        }
+        rowInfos.push({
+            index: r,
+            filledCols,
+            minCol: filledCols.size > 0 ? Math.min(...filledCols) : -1,
+            maxCol: filledCols.size > 0 ? Math.max(...filledCols) : -1,
+            filledCount,
+            hasBorder,
+            hasVerticalBorder,
+        });
+        rowBorderPromotedCols.push(borderPromotedCols);
+        rowBorderTopBottomCols.push(borderTopBottomCols);
+    }
+    // --- Blank-separator-column rollback (band-local check) ---
+    //
+    // ADR-0014 Condition A promotes empty cells with both left and right borders.
+    // Exception: if a column qualifies as a "blank separator" within a row-band —
+    // meaning no cell in that band has an actual value/autofilter fill AND no cell
+    // has a top or bottom border — the promotion is rolled back so the column
+    // acts as a visual gap between side-by-side tables.
+    //
+    // The check is intentionally band-local (not sheet-global) so that a column
+    // that is a real table column in one band is not affected by another band where
+    // it happens to be empty.
+    if (opts.tableDetection.useBorders) {
+        // Identify bands: consecutive rowInfos with filledCount > 0.
+        let bandStart = 0;
+        while (bandStart < rowInfos.length) {
+            if (rowInfos[bandStart].filledCount === 0) {
+                bandStart++;
+                continue;
+            }
+            let bandEnd = bandStart;
+            while (bandEnd + 1 < rowInfos.length && rowInfos[bandEnd + 1].filledCount > 0) {
+                bandEnd++;
+            }
+            // Collect band-local evidence for each column.
+            const bandColHasTopBottom = new Set();
+            const bandColHasRealFill = new Set();
+            for (let bi = bandStart; bi <= bandEnd; bi++) {
+                for (const c of rowBorderTopBottomCols[bi])
+                    bandColHasTopBottom.add(c);
+                for (const c of rowInfos[bi].filledCols) {
+                    if (!rowBorderPromotedCols[bi].has(c))
+                        bandColHasRealFill.add(c);
+                }
+            }
+            // Roll back border promotion for blank separator columns.
+            for (let bi = bandStart; bi <= bandEnd; bi++) {
+                const row = rowInfos[bi];
+                for (const c of rowBorderPromotedCols[bi]) {
+                    if (!bandColHasTopBottom.has(c) && !bandColHasRealFill.has(c)) {
+                        row.filledCols.delete(c);
+                        row.filledCount--;
+                    }
+                }
+                if (rowBorderPromotedCols[bi].size > 0) {
+                    row.minCol = row.filledCols.size > 0 ? Math.min(...row.filledCols) : -1;
+                    row.maxCol = row.filledCols.size > 0 ? Math.max(...row.filledCols) : -1;
+                }
+            }
+            bandStart = bandEnd + 1;
+        }
+    }
+    const rawRegions = (0, region_detector_js_1.detectRegions)(rowInfos, opts);
+    // Render each region
+    const regions = rawRegions.map((raw) => {
+        let markdown = "";
+        if (raw.type === "table" &&
+            !(0, table_renderer_js_1.isSingleCellPerRow)(raw.startRow, raw.endRow, raw.startCol, raw.endCol, merges, hiddenRows, hiddenCols)) {
+            markdown = (0, table_renderer_js_1.renderTable)(ws, raw.startRow, raw.endRow, raw.startCol, raw.endCol, merges, opts, hiddenRows, hiddenCols);
+        }
+        else {
+            markdown = (0, paragraph_renderer_js_1.renderParagraph)(ws, raw.startRow, raw.endRow, raw.startCol, raw.endCol, merges, opts, hiddenRows, hiddenCols);
+        }
+        return { ...raw, markdown };
+    });
+    const separator = "\n".repeat(opts.blankLinesBetweenRegions + 1);
+    const markdown = regions
+        .map((r) => r.markdown)
+        .filter(Boolean)
+        .join(separator);
+    return { name: sheetName, index: sheetIndex, markdown, regions };
+}
+function buildMergedCellInfo(merges) {
+    const childCells = new Set();
+    const childToMaster = new Map();
+    const masterColEnd = new Map();
+    for (const m of merges) {
+        const masterAddr = XLSX.utils.encode_cell({ r: m.s.r, c: m.s.c });
+        if (m.e.c > m.s.c) {
+            masterColEnd.set(masterAddr, m.e.c);
+        }
+        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;
+                const childAddr = XLSX.utils.encode_cell({ r, c });
+                childCells.add(childAddr);
+                childToMaster.set(childAddr, masterAddr);
+            }
+        }
+    }
+    return { childCells, childToMaster, masterColEnd };
+}
+//# sourceMappingURL=sheet-converter.js.map

package/dist/sheet-converter.js.map

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

package/dist/table-renderer.d.ts

@@ -0,0 +1,22 @@
+import * as XLSX from "xlsx";
+import type { ResolvedOptions } from "./types.js";
+/**
+ * Return true if every visible row in the region renders as a single cell.
+ * This happens when every row has a colspan that spans the entire column range,
+ * leaving no structural tabular information. Such regions should be rendered
+ * as paragraphs rather than tables.
+ */
+export declare function isSingleCellPerRow(startRow: number, endRow: number, startCol: number, endCol: number, merges: XLSX.Range[], hiddenRows?: Set<number>, hiddenCols?: Set<number>): boolean;
+/**
+ * Render a table region as an HTML table with full colspan/rowspan support.
+ *
+ * @param ws       - The worksheet
+ * @param startRow - First row (0-based, inclusive)
+ * @param endRow   - Last row (0-based, inclusive)
+ * @param startCol - First column (0-based, inclusive)
+ * @param endCol   - Last column (0-based, inclusive)
+ * @param merges   - Merged cell ranges from ws['!merges']
+ * @param opts     - Resolved options
+ */
+export declare function renderTable(ws: XLSX.WorkSheet, startRow: number, endRow: number, startCol: number, endCol: number, merges: XLSX.Range[], opts: ResolvedOptions, hiddenRows?: Set<number>, hiddenCols?: Set<number>): string;
+//# sourceMappingURL=table-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table-renderer.d.ts","sourceRoot":"","sources":["../src/table-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAY,eAAe,EAAE,MAAM,YAAY,CAAC;AAQ5D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,EACpB,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,EACnC,UAAU,GAAE,GAAG,CAAC,MAAM,CAAa,GAClC,OAAO,CAwBT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,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,CA6ER"}

package/dist/table-renderer.js

@@ -0,0 +1,236 @@
+"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.isSingleCellPerRow = isSingleCellPerRow;
+exports.renderTable = renderTable;
+const XLSX = __importStar(require("xlsx"));
+const cell_formatter_js_1 = require("./cell-formatter.js");
+/**
+ * Return true if every visible row in the region renders as a single cell.
+ * This happens when every row has a colspan that spans the entire column range,
+ * leaving no structural tabular information. Such regions should be rendered
+ * as paragraphs rather than tables.
+ */
+function isSingleCellPerRow(startRow, endRow, startCol, endCol, merges, hiddenRows = new Set(), hiddenCols = new Set()) {
+    // Build the set of merge child addresses inside this region
+    const mergeChildSet = new Set();
+    for (const m of merges) {
+        if (m.s.r < startRow || m.s.r > endRow || m.s.c < startCol || m.s.c > endCol)
+            continue;
+        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;
+                mergeChildSet.add(XLSX.utils.encode_cell({ r, c }));
+            }
+        }
+    }
+    for (let r = startRow; r <= endRow; r++) {
+        if (hiddenRows.has(r))
+            continue;
+        let cellCount = 0;
+        for (let c = startCol; c <= endCol; c++) {
+            if (hiddenCols.has(c))
+                continue;
+            if (mergeChildSet.has(XLSX.utils.encode_cell({ r, c })))
+                continue;
+            cellCount++;
+        }
+        if (cellCount > 1)
+            return false;
+    }
+    return true;
+}
+/**
+ * Render a table region as an HTML table with full colspan/rowspan support.
+ *
+ * @param ws       - The worksheet
+ * @param startRow - First row (0-based, inclusive)
+ * @param endRow   - Last row (0-based, inclusive)
+ * @param startCol - First column (0-based, inclusive)
+ * @param endCol   - Last column (0-based, inclusive)
+ * @param merges   - Merged cell ranges from ws['!merges']
+ * @param opts     - Resolved options
+ */
+function renderTable(ws, startRow, endRow, startCol, endCol, merges, opts, hiddenRows = new Set(), hiddenCols = new Set()) {
+    // Build merge maps for cells inside this table region
+    const mergeSpanMap = new Map(); // master address → span
+    const mergeChildSet = new Set(); // child addresses to skip
+    for (const m of merges) {
+        // Only handle merges whose master cell is inside the table region
+        if (m.s.r < startRow || m.s.r > endRow || m.s.c < startCol || m.s.c > endCol)
+            continue;
+        const masterAddr = XLSX.utils.encode_cell({ r: m.s.r, c: m.s.c });
+        const colspan = Math.min(m.e.c, endCol) - m.s.c + 1;
+        const rowspan = Math.min(m.e.r, endRow) - m.s.r + 1;
+        mergeSpanMap.set(masterAddr, { colspan, rowspan });
+        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;
+                mergeChildSet.add(XLSX.utils.encode_cell({ r, c }));
+            }
+        }
+    }
+    // Infer column alignments from data rows
+    const alignments = inferColumnAlignments(ws, startRow, endRow, startCol, endCol, mergeChildSet, opts, hiddenRows, hiddenCols);
+    const lines = ["<table>"];
+    // --- header row ---
+    if (opts.headerRow && !hiddenRows.has(startRow)) {
+        lines.push(renderHtmlRow(ws, startRow, startCol, endCol, mergeSpanMap, mergeChildSet, alignments, opts, "th", hiddenCols));
+    }
+    // --- data rows ---
+    const dataStartRow = opts.headerRow ? startRow + 1 : startRow;
+    for (let r = dataStartRow; r <= endRow; r++) {
+        if (hiddenRows.has(r))
+            continue;
+        lines.push(renderHtmlRow(ws, r, startCol, endCol, mergeSpanMap, mergeChildSet, alignments, opts, "td", hiddenCols));
+    }
+    lines.push("</table>");
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function renderHtmlRow(ws, row, startCol, endCol, mergeSpanMap, mergeChildSet, alignments, opts, tag, hiddenCols = new Set()) {
+    const cells = [];
+    for (let c = startCol; c <= endCol; c++) {
+        if (hiddenCols.has(c))
+            continue;
+        const addr = XLSX.utils.encode_cell({ r: row, c });
+        // Skip child cells of a merge
+        if (mergeChildSet.has(addr))
+            continue;
+        const cell = ws[addr];
+        const data = (0, cell_formatter_js_1.extractCellData)(cell, mergeChildSet, addr, opts);
+        // Build attribute string
+        const attrs = [];
+        const span = mergeSpanMap.get(addr);
+        if (span) {
+            if (span.colspan > 1)
+                attrs.push(`colspan="${span.colspan}"`);
+            if (span.rowspan > 1)
+                attrs.push(`rowspan="${span.rowspan}"`);
+        }
+        // Alignment: explicit cell alignment takes priority, then column-level inference
+        const explicitAlign = data.alignment;
+        const colAlign = alignments[c - startCol];
+        const align = explicitAlign ?? colAlign;
+        if (align && align !== "left") {
+            attrs.push(`style="text-align: ${align}"`);
+        }
+        const attrStr = attrs.length > 0 ? ` ${attrs.join(" ")}` : "";
+        const content = formatCellHtml(data, opts);
+        cells.push(`    <${tag}${attrStr}>${content}</${tag}>`);
+    }
+    return `    <tr>\n${cells.join("\n")}\n    </tr>`;
+}
+/**
+ * Format a cell's content as HTML.
+ * Uses rawValue so that we apply HTML tags rather than Markdown syntax.
+ */
+function formatCellHtml(data, opts) {
+    // Inline rich text: use pre-built per-run HTML (ADR-0019)
+    if (opts.richText && data.richTextHtml !== undefined) {
+        const val = data.richTextHtml;
+        if (!val)
+            return opts.emptyCell ? (0, cell_formatter_js_1.escapeHtml)(opts.emptyCell) : "";
+        return data.hyperlink ? `<a href="${(0, cell_formatter_js_1.escapeHtml)(data.hyperlink)}">${val}</a>` : val;
+    }
+    let val = (0, cell_formatter_js_1.escapeHtml)(data.rawValue);
+    // Newlines inside cells → <br>
+    val = val.replace(/\n/g, "<br>");
+    if (!val)
+        return opts.emptyCell ? (0, cell_formatter_js_1.escapeHtml)(opts.emptyCell) : "";
+    if (!opts.richText)
+        return val;
+    // Apply HTML inline formatting (cell-level bold/italic)
+    if (data.bold && data.italic)
+        val = `<strong><em>${val}</em></strong>`;
+    else if (data.bold)
+        val = `<strong>${val}</strong>`;
+    else if (data.italic)
+        val = `<em>${val}</em>`;
+    if (data.hyperlink)
+        val = `<a href="${(0, cell_formatter_js_1.escapeHtml)(data.hyperlink)}">${val}</a>`;
+    return val;
+}
+/**
+ * Infer the best alignment for each column.
+ * Priority: explicit cell alignment > all-numeric column content > left (default).
+ */
+function inferColumnAlignments(ws, startRow, endRow, startCol, endCol, mergeChildSet, opts, hiddenRows = new Set(), hiddenCols = new Set()) {
+    const dataStartRow = opts.headerRow ? startRow + 1 : startRow;
+    const colCount = endCol - startCol + 1;
+    const result = [];
+    for (let ci = 0; ci < colCount; ci++) {
+        const c = startCol + ci;
+        if (hiddenCols.has(c)) {
+            result.push("left");
+            continue;
+        }
+        let explicit;
+        let hasValue = false;
+        let allNumeric = true;
+        for (let r = dataStartRow; r <= endRow; r++) {
+            if (hiddenRows.has(r))
+                continue;
+            const addr = XLSX.utils.encode_cell({ r, c });
+            if (mergeChildSet.has(addr))
+                continue;
+            const cell = ws[addr];
+            const data = (0, cell_formatter_js_1.extractCellData)(cell, mergeChildSet, addr, opts);
+            if (!explicit && data.alignment)
+                explicit = data.alignment;
+            const v = data.rawValue.trim();
+            if (v) {
+                hasValue = true;
+                // Use SheetJS cell type as the primary numeric signal so that values
+                // displayed with currency symbols (¥1,000, $100) are still right-aligned.
+                const numericByType = cell?.t === "n";
+                if (!numericByType && !/^-?[\d,]+(\.\d+)?%?$/.test(v))
+                    allNumeric = false;
+            }
+        }
+        if (explicit) {
+            result.push(explicit);
+        }
+        else {
+            result.push(hasValue && allNumeric ? "right" : "left");
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=table-renderer.js.map

package/dist/table-renderer.js.map

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