@rowsncolumns/toolkit 24.4.2 → 24.4.4

package/dist/esm/excel-parser/plugins/xls/index.js

@@ -1,7 +1,445 @@
+import { getCellXfsKey, ssfFormat, uuid } from "@rowsncolumns/utils";
+import { read as readSheetJsWorkbook, utils as sheetJsUtils, } from "xlsx/xlsx.mjs";
+import { detectCfbContainerKind, LEGACY_XLS_UNSUPPORTED_MESSAGE, XLS_NOT_A_WORKBOOK_MESSAGE, } from "../../cfb-decryptor";
+import { excelColumnWidthToPixels, getRangeFromAddressRef } from "../../helpers";
 import { BaseWorkbookPlugin } from "../base/index";
+export const ZIP_SIGNATURE = [0x50, 0x4b, 0x03, 0x04];
+export const CFB_SIGNATURE = [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1];
+export const readHeader = async (source, length) => {
+    const slice = source instanceof File
+        ? await source.slice(0, length).arrayBuffer()
+        : source.slice(0, length);
+    return new Uint8Array(slice);
+};
+export const startsWith = (header, signature) => header.length >= signature.length &&
+    signature.every((byte, index) => header[index] === byte);
+/**
+ * BIFF8 error codes (MS-XLS 2.5.97 `BErr`) → Excel error literals. SheetJS
+ * surfaces an error cell as `{ t: "e", v: <code>, w: "#DIV/0!" }`.
+ */
+const BIFF_ERROR_CODES = {
+    0x00: "#NULL!",
+    0x07: "#DIV/0!",
+    0x0f: "#VALUE!",
+    0x17: "#REF!",
+    0x1d: "#NAME?",
+    0x24: "#NUM!",
+    0x2a: "#N/A",
+    0x2b: "#GETTING_DATA",
+};
+const getNumberFormatType = (pattern) => {
+    const lower = pattern.toLowerCase();
+    if (lower.includes("yy") || lower.includes("dd"))
+        return "DATE";
+    if (lower.includes("h:") || lower.includes("am/pm"))
+        return "TIME";
+    if (lower.includes("%"))
+        return "PERCENT";
+    // Excel's builtin 49 (`@`) and any text-placeholder format — same facet
+    // type the xlsx styles reader yields for the cell.
+    if (lower.includes("@"))
+        return "TEXT";
+    if (lower.includes("$") ||
+        lower.includes("€") ||
+        lower.includes("£") ||
+        lower.includes("¥")) {
+        return "CURRENCY";
+    }
+    if (lower.includes("0") || lower.includes("#"))
+        return "NUMBER";
+    return "GENERAL";
+};
+/**
+ * BIFF `NAME` records (SheetJS `Workbook.Names`) → `NamedRange`s. Builtin
+ * names (`_xlnm.Print_Area`, `_xlnm._FilterDatabase`, …) are print / filter
+ * metadata, not user names, and are skipped. A reference that parses as a
+ * range becomes `range` (pinned to the sheet the ref names, else the name's
+ * own sheet scope, else the first sheet); anything else is kept as a
+ * formula `value`.
+ */
+export const mapDefinedNames = (names, sheets) => names.flatMap((name) => {
+    if (!name?.Name || !name.Ref)
+        return [];
+    if (name.Name.startsWith("_xlnm."))
+        return [];
+    const namedRange = {
+        namedRangeId: uuid(),
+        name: name.Name,
+    };
+    const scopedSheetId = name.Sheet != null ? sheets[name.Sheet]?.sheetId : undefined;
+    const ref = name.Ref.replace(/^=/, "");
+    const bang = ref.lastIndexOf("!");
+    const sheetPart = bang >= 0 ? ref.slice(0, bang) : undefined;
+    const refPart = bang >= 0 ? ref.slice(bang + 1) : ref;
+    const targetTitle = sheetPart
+        ?.replace(/^'(.*)'$/, "$1")
+        .replace(/''/g, "'");
+    const targetSheetId = (targetTitle
+        ? sheets.find((s) => s.title === targetTitle)?.sheetId
+        : undefined) ??
+        scopedSheetId ??
+        sheets[0]?.sheetId ??
+        1;
+    const gridRange = getRangeFromAddressRef(refPart);
+    if (gridRange) {
+        namedRange.range = { ...gridRange, sheetId: targetSheetId };
+    }
+    else {
+        namedRange.value = `=${ref}`;
+    }
+    return [namedRange];
+});
+/**
+ * Legacy `.xls` (BIFF8, Excel 97-2003) reader.
+ *
+ * The BIFF record stream is decoded by SheetJS (`xlsx`, already a toolkit
+ * dependency for the CFB container reader used by the password decryptor),
+ * and the decoded workbook is mapped onto the same plugin contract the
+ * xlsx / xlsb readers implement: sheet names + visibility, cell values with
+ * their number formats, formulas with their cached results, merges, column
+ * widths / row heights, hyperlinks, cell notes, defined names and the 1904
+ * date-system flag. Cell fonts / fills / borders are not decoded (BIFF XF
+ * styling is outside SheetJS's open-source decoder), so a `.xls` opens with
+ * its data and number formatting; export goes through XLSX like XLSB.
+ *
+ * `load` also keeps the previous routing guards: an OOXML package saved with a
+ * `.xls` name is rejected here so `WorkBook` hands it to the xlsx parser, an
+ * encrypted container still asks for a password, and an HTML / text export
+ * saved as `.xls` fails with an actionable message.
+ */
 export class XlsPlugin extends BaseWorkbookPlugin {
-    async load(_buffer, _password) {
-        // TODO: Implement XLS loading (CFB format)
-        console.warn("XLS support not implemented yet");
+    sheets = [];
+    namedRanges = [];
+    cellXfs = new Map();
+    formatIds = new Map();
+    use1904 = false;
+    async load(buffer, _password) {
+        const header = await readHeader(buffer, CFB_SIGNATURE.length);
+        if (startsWith(header, ZIP_SIGNATURE)) {
+            // An OOXML package mislabelled `.xls` — `WorkBook.load` routes these
+            // to the xlsx parser before reaching here; guard direct callers.
+            throw new Error("NOT_A_BIFF_WORKBOOK");
+        }
+        if (!startsWith(header, CFB_SIGNATURE)) {
+            throw new Error(XLS_NOT_A_WORKBOOK_MESSAGE);
+        }
+        const kind = await detectCfbContainerKind(buffer);
+        if (kind === "encrypted-ooxml") {
+            throw new Error("PASSWORD_REQUIRED");
+        }
+        if (kind !== "legacy-xls") {
+            throw new Error(XLS_NOT_A_WORKBOOK_MESSAGE);
+        }
+        const bytes = new Uint8Array(buffer instanceof File ? await buffer.arrayBuffer() : buffer);
+        let workbook;
+        try {
+            workbook = readSheetJsWorkbook(bytes, {
+                type: "array",
+                cellNF: true,
+                cellStyles: true,
+                cellDates: false,
+                cellText: false,
+                sheetStubs: false,
+                dense: false,
+            });
+        }
+        catch (error) {
+            // A password-protected BIFF workbook (RC4 / XOR obfuscation) surfaces
+            // here — SheetJS refuses it. There is no BIFF decryptor, so the only
+            // actionable guidance is the save-as-xlsx one.
+            const message = error instanceof Error ? error.message : String(error);
+            if (/password/i.test(message) || /encrypt/i.test(message)) {
+                throw new Error(LEGACY_XLS_UNSUPPORTED_MESSAGE);
+            }
+            throw new Error(`${LEGACY_XLS_UNSUPPORTED_MESSAGE} (${message})`);
+        }
+        this.use1904 = Boolean(workbook.Workbook?.WBProps?.date1904);
+        this.sheets = workbook.SheetNames.map((title, index) => {
+            const worksheet = workbook.Sheets[title] ?? {};
+            const props = workbook.Workbook?.Sheets?.[index];
+            const hiddenState = props?.Hidden ?? 0;
+            const visibility = hiddenState === 2
+                ? "veryHidden"
+                : hiddenState === 1
+                    ? "hidden"
+                    : "visible";
+            const ref = worksheet["!ref"];
+            const range = ref ? sheetJsUtils.decode_range(ref) : undefined;
+            const rowCount = range ? range.e.r + 1 : 0;
+            const columnCount = range ? range.e.c + 1 : 0;
+            const merges = (worksheet["!merges"] ?? []).map((merge) => ({
+                startRowIndex: merge.s.r + 1,
+                endRowIndex: merge.e.r + 1,
+                startColumnIndex: merge.s.c + 1,
+                endColumnIndex: merge.e.c + 1,
+            }));
+            const columnMetadata = [];
+            (worksheet["!cols"] ?? []).forEach((col, colIndex) => {
+                if (!col)
+                    return;
+                const props = {};
+                if (col.hidden)
+                    props.hiddenByUser = true;
+                const size = col.wpx ??
+                    (col.wch != null ? excelColumnWidthToPixels(col.wch) : undefined) ??
+                    (col.width != null ? excelColumnWidthToPixels(col.width) : undefined);
+                if (size != null && size > 0) {
+                    props.size = size;
+                    props.resizedByUser = true;
+                }
+                if (Object.keys(props).length > 0) {
+                    columnMetadata[colIndex + 1] = props;
+                }
+            });
+            const rowMetadata = [];
+            (worksheet["!rows"] ?? []).forEach((row, rowIndex) => {
+                if (!row)
+                    return;
+                const props = {};
+                if (row.hidden)
+                    props.hiddenByUser = true;
+                const size = row.hpx ?? (row.hpt != null ? (row.hpt * 96) / 72 : undefined);
+                if (size != null && size > 0) {
+                    props.size = Math.round(size);
+                    props.resizedByUser = true;
+                }
+                if (Object.keys(props).length > 0) {
+                    rowMetadata[rowIndex + 1] = props;
+                }
+            });
+            return {
+                sheetId: index + 1,
+                title,
+                hidden: visibility !== "visible",
+                visibility,
+                worksheet,
+                rowCount,
+                columnCount,
+                merges,
+                rowMetadata,
+                columnMetadata,
+            };
+        });
+        this.namedRanges = mapDefinedNames(workbook.Workbook?.Names ?? [], this.sheets.map((s) => ({ sheetId: s.sheetId, title: s.title })));
+    }
+    dispose() {
+        this.sheets = [];
+        this.namedRanges = [];
+        this.cellXfs.clear();
+        this.formatIds.clear();
+    }
+    getSheetCount() {
+        return this.sheets.length;
+    }
+    async getSheets(minRowCount = 0, minColumnCount = 0) {
+        const sheets = this.sheets.map((sheet) => ({
+            sheetId: sheet.sheetId,
+            title: sheet.title,
+            hidden: sheet.hidden,
+            ...(sheet.visibility !== "visible"
+                ? { visibility: sheet.visibility }
+                : {}),
+            rowCount: Math.max(minRowCount, sheet.rowCount),
+            columnCount: Math.max(minColumnCount, sheet.columnCount),
+            rowMetadata: sheet.rowMetadata,
+            columnMetadata: sheet.columnMetadata,
+            merges: sheet.merges,
+        }));
+        return [sheets, []];
+    }
+    getCellXfs() {
+        return this.cellXfs;
+    }
+    registerFormat(format) {
+        const key = getCellXfsKey(format);
+        if (!this.cellXfs.has(key)) {
+            this.cellXfs.set(key, format);
+        }
+        return key;
+    }
+    getNamedRanges() {
+        return this.namedRanges;
+    }
+    /** `WBProps.date1904` — Mac-origin workbooks shift every date serial. */
+    getUse1904Epoch() {
+        return this.use1904;
+    }
+    /** Formulas carry their BIFF cached results, so no load-time recalc. */
+    requiresRecalc() {
+        return false;
+    }
+    toCellData(cell, enableCellXfsRegistry) {
+        const format = {};
+        const pattern = typeof cell.z === "string" && cell.z.toLowerCase() !== "general"
+            ? cell.z
+            : undefined;
+        if (pattern) {
+            format.numberFormat = { type: getNumberFormatType(pattern), pattern };
+        }
+        const hasFormat = Object.keys(format).length > 0;
+        let style;
+        if (enableCellXfsRegistry && hasFormat && pattern) {
+            let id = this.formatIds.get(pattern);
+            if (id === undefined) {
+                id = this.formatIds.size;
+                this.formatIds.set(pattern, id);
+            }
+            style = { sid: `xls:${id}` };
+            if (!this.cellXfs.has(style.sid)) {
+                this.cellXfs.set(style.sid, format);
+            }
+        }
+        const formatFields = style
+            ? { ef: style, uf: style }
+            : hasFormat
+                ? { ef: format, uf: format }
+                : {};
+        const formula = typeof cell.f === "string" && cell.f.length > 0
+            ? `=${cell.f.replace(/^=/, "")}`
+            : undefined;
+        let cellData = null;
+        switch (cell.t) {
+            case "s":
+            case "d": {
+                const text = cell.v == null ? "" : String(cell.v);
+                cellData = {
+                    ...formatFields,
+                    ue: formula ? { fv: formula } : { sv: text },
+                    ev: { sv: text },
+                    ...(formula ? {} : { fv: text }),
+                };
+                break;
+            }
+            case "n": {
+                const value = Number(cell.v);
+                if (!Number.isFinite(value))
+                    return null;
+                cellData = {
+                    ...formatFields,
+                    ue: formula ? { fv: formula } : { nv: value },
+                    ev: { nv: value },
+                    ...(formula ? {} : { fv: ssfFormat(pattern ?? "GENERAL", value) }),
+                };
+                break;
+            }
+            case "b": {
+                const value = Boolean(cell.v);
+                cellData = {
+                    ...formatFields,
+                    ue: formula ? { fv: formula } : { bv: value },
+                    ev: { bv: value },
+                    ...(formula ? {} : { fv: value ? "TRUE" : "FALSE" }),
+                };
+                break;
+            }
+            case "e": {
+                const code = (typeof cell.v === "number" ? BIFF_ERROR_CODES[cell.v] : undefined) ??
+                    (typeof cell.w === "string" && cell.w.startsWith("#")
+                        ? cell.w
+                        : "#VALUE!");
+                const errorValue = {
+                    ev: { type: "Error", name: code, message: code },
+                };
+                cellData = {
+                    ...formatFields,
+                    ue: formula ? { fv: formula } : errorValue,
+                    ev: errorValue,
+                    ...(formula ? {} : { fv: code }),
+                };
+                break;
+            }
+            case "z":
+            default: {
+                if (formula) {
+                    cellData = { ...formatFields, ue: { fv: formula } };
+                }
+                else if (hasFormat) {
+                    cellData = { ...formatFields };
+                }
+                else {
+                    return null;
+                }
+            }
+        }
+        if (cell.l?.Target) {
+            const target = cell.l.Target;
+            const tooltip = cell.l.Tooltip ? { tooltip: cell.l.Tooltip } : {};
+            cellData.hyperlink = target.startsWith("#")
+                ? { kind: "internal", location: target.slice(1), ...tooltip }
+                : { kind: "external", url: target, ...tooltip };
+        }
+        if (Array.isArray(cell.c) && cell.c.length > 0) {
+            const note = cell.c
+                .map((comment) => comment?.t ?? "")
+                .filter((text) => text.length > 0)
+                .join("\n");
+            if (note)
+                cellData.note = note;
+        }
+        return cellData;
+    }
+    async *processSheetData(chunkSize = 100, enableCellXfsRegistry = false, _enableSharedStrings) {
+        const totalSheets = this.sheets.length;
+        for (let index = 0; index < this.sheets.length; index++) {
+            const sheet = this.sheets[index];
+            const rows = new Map();
+            for (const address of Object.keys(sheet.worksheet)) {
+                if (address.startsWith("!"))
+                    continue;
+                const cell = sheet.worksheet[address];
+                if (!cell || typeof cell !== "object")
+                    continue;
+                const { r, c } = sheetJsUtils.decode_cell(address);
+                if (r < 0 || c < 0)
+                    continue;
+                const cellData = this.toCellData(cell, enableCellXfsRegistry);
+                if (!cellData)
+                    continue;
+                let row = rows.get(r + 1);
+                if (!row) {
+                    row = { values: [] };
+                    rows.set(r + 1, row);
+                }
+                row.values[c + 1] = cellData;
+            }
+            const sortedRows = Array.from(rows.entries()).sort((a, b) => a[0] - b[0]);
+            let chunkRows = [];
+            let chunkRowIndices = [];
+            let chunkIndex = 0;
+            let startRowIndex = -1;
+            let endRowIndex = -1;
+            const emit = (isLastChunk) => ({
+                sheetId: sheet.sheetId,
+                title: sheet.title,
+                currentSheetIndex: index,
+                totalSheets,
+                chunkIndex,
+                rows: chunkRows,
+                rowIndices: chunkRowIndices,
+                startRowIndex,
+                endRowIndex,
+                totalRows: sheet.rowCount,
+                isLastChunk,
+                cellXfs: this.cellXfs,
+            });
+            for (const [rowIndex, rowData] of sortedRows) {
+                if (chunkRows.length === 0)
+                    startRowIndex = rowIndex;
+                chunkRows.push(rowData);
+                chunkRowIndices.push(rowIndex);
+                endRowIndex = rowIndex;
+                if (chunkRows.length >= chunkSize) {
+                    yield emit(false);
+                    chunkRows = [];
+                    chunkRowIndices = [];
+                    chunkIndex += 1;
+                    startRowIndex = -1;
+                    endRowIndex = -1;
+                }
+            }
+            if (chunkRows.length) {
+                yield emit(true);
+            }
+        }
     }
 }

package/dist/esm/excel-parser/plugins/xlsb/index.d.ts

@@ -2,6 +2,10 @@ import type { Color, IterativeCalculationOptions } from "@rowsncolumns/common-ty
 import type { BorderStyle, ConditionalFormatRule, DataValidationRuleRecord, EmbeddedChart, NamedRange, Sheet, SpreadsheetTheme, TableView } from "@rowsncolumns/spreadsheet";
 import type { EmbeddedObjectWithPosition, ProcessSheetDataResult } from "../../types";
 import { BaseWorkbookPlugin } from "../base/index";
+export declare const parseBrtWsViewPayload: (payload: Uint8Array) => {
+    showGridLines: boolean;
+    rightToLeft: boolean;
+};
 export declare const parseBrtNamePayload: (payload: Uint8Array, resolveSheetNameByXti?: (ixti: number) => string | undefined) => {
     name: string;
     formula: string;

package/dist/esm/excel-parser/plugins/xlsb/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsb/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsb/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/excel-parser/plugins/xlsb/index.js

@@ -4,13 +4,14 @@ import { XMLParser } from "fast-xml-parser";
 import { get } from "lodash-es";
 import { parseRgce } from "./rgce-parser";
 import { StreamingZipParser } from "../../zip-parser-streaming";
-import { createFilterSpecsFromAutoFilter, excelColumnWidthToPixels, getRangeFromAddressRef, } from "../../helpers";
+import { createFilterSpecsFromAutoFilter, excelColumnWidthToPixels, getRangeFromAddressRef, parseTableColumnTotals, } from "../../helpers";
 import { defaultSpreadsheetTheme } from "../../theme-default";
 import { BaseWorkbookPlugin } from "../base/index";
 import { processChart } from "../xlsx/charts";
 import { processAnchors } from "../xlsx/drawing";
 import { readAllRecordHeaders } from "./biff-record-reader";
 import { standardExcelFormatCodeById } from "../xlsx/numfmt";
+import { DATE_1904_OFFSET_DAYS, isEpochShiftedFormat } from "../xlsx/styles";
 import { extractThemeColors, extractThemeFonts, generateDarkThemeColors, } from "../xlsx/theme";
 const RT = {
     BrtCellRk: 0x0002,
@@ -274,10 +275,17 @@ const parseBrtShrFmla = (payload) => {
 const parseWsView = (payload) => {
     const reader = new Reader(payload);
     const flags = reader.readUInt16LE();
-    // Bit 1 (0x0002): fShowGridLines - if 0, gridlines are hidden
-    const showGridLines = (flags & 0x0002) !== 0;
-    return { showGridLines };
+    // MS-XLSB 2.4.865 BrtWsView flag word: A fWnProt (0x0001), B fDspFmla
+    // (0x0002), C fDspGrid (0x0004), D fDspRwCol (0x0008), E fDspZeros
+    // (0x0010), F fRightToLeft (0x0020), G fSelected (0x0040), … Excel writes
+    // 0x039c for a plain sheet and 0x0398 for `showGridLines="0"`: gridlines
+    // are bit C, not bit B (which is "show formulas" and is normally clear).
+    const showGridLines = (flags & 0x0004) !== 0;
+    // OOXML `<sheetView rightToLeft="1">`.
+    const rightToLeft = (flags & 0x0020) !== 0;
+    return { showGridLines, rightToLeft };
 };
+export const parseBrtWsViewPayload = parseWsView;
 const parsePane = (payload) => {
     const reader = new Reader(payload);
     const xSplit = reader.readFloat64LE();
@@ -932,7 +940,7 @@ const resolveXf = (styles, xfIndex) => {
         indent: xf.indent ?? parent.indent,
     };
 };
-const toCellData = (parsed, styles, sharedStrings, enableCellXfsRegistry, enableSharedStrings, cellXfs) => {
+const toCellData = (parsed, styles, sharedStrings, enableCellXfsRegistry, enableSharedStrings, cellXfs, use1904) => {
     const xf = resolveXf(styles, parsed.styleRef);
     const format = {};
     const pattern = xf
@@ -1045,7 +1053,13 @@ const toCellData = (parsed, styles, sharedStrings, enableCellXfsRegistry, enable
         };
     }
     if (parsed.kind === "n") {
-        const value = Number(parsed.value);
+        // A 1904-system workbook (`BrtWbProp.fDate1904`) stores date serials
+        // 1462 days below the engine's 1900 system; date-formatted numbers are
+        // converted on the way in, like the XLSX importer does.
+        const value = Number(parsed.value) +
+            (use1904 && isEpochShiftedFormat(format.numberFormat?.type)
+                ? DATE_1904_OFFSET_DAYS
+                : 0);
         const pattern = format.numberFormat?.pattern ?? "GENERAL";
         const fv = ssfFormat(pattern, value);
         // If there's a formula, use it in ue.fv, otherwise use the numeric value
@@ -1267,6 +1281,7 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
             sheet.rowMetadata = stats.rowMetadata;
             sheet.columnMetadata = stats.columnMetadata;
             sheet.showGridLines = stats.showGridLines;
+            sheet.rightToLeft = stats.rightToLeft;
             sheet.frozenRowCount = stats.frozenRowCount;
             sheet.frozenColumnCount = stats.frozenColumnCount;
             sheet.basicFilterRange = stats.basicFilterRange;
@@ -1532,12 +1547,13 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
                     : [];
             const columns = columnDefsArray.map((colDef) => {
                 const name = colDef?.a$?.name || "";
+                const totals = parseTableColumnTotals(colDef);
                 const calculatedColumnFormula = get(colDef, "calculatedColumnFormula") ||
                     get(colDef, "x:calculatedColumnFormula");
                 if (calculatedColumnFormula) {
-                    return { name, formula: calculatedColumnFormula };
+                    return { name, ...totals, formula: calculatedColumnFormula };
                 }
-                return { name };
+                return { name, ...totals };
             });
             const autoFilter = tableDefinition.autoFilter ?? tableDefinition["x:autoFilter"];
             const filterSpecs = createFilterSpecsFromAutoFilter(autoFilter);
@@ -1578,6 +1594,7 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
         const rowMetadata = [];
         const columnMetadata = [];
         let showGridLines;
+        let rightToLeft;
         let frozenRowCount;
         let frozenColumnCount;
         let basicFilterRange;
@@ -1587,6 +1604,8 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
             if (record.type === RT.BrtWsView) {
                 const view = parseWsView(payload);
                 showGridLines = view.showGridLines;
+                if (view.rightToLeft)
+                    rightToLeft = true;
                 continue;
             }
             if (record.type === RT.BrtPane) {
@@ -1671,6 +1690,7 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
             rowMetadata,
             columnMetadata,
             showGridLines,
+            rightToLeft,
             frozenRowCount,
             frozenColumnCount,
             basicFilterRange,
@@ -1727,6 +1747,7 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
                 ...(sheet.showGridLines !== undefined
                     ? { showGridLines: sheet.showGridLines }
                     : {}),
+                ...(sheet.rightToLeft ? { rightToLeft: true } : {}),
                 ...(sheet.frozenRowCount !== undefined && sheet.frozenRowCount > 0
                     ? { frozenRowCount: sheet.frozenRowCount }
                     : {}),
@@ -1847,7 +1868,7 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
                     row = { values: [] };
                     rows.set(parsed.row, row);
                 }
-                row.values[parsed.col] = toCellData(parsed, this.styles, this.sharedStrings, enableCellXfsRegistry, enableSharedStrings, this.cellXfs);
+                row.values[parsed.col] = toCellData(parsed, this.styles, this.sharedStrings, enableCellXfsRegistry, enableSharedStrings, this.cellXfs, this.use1904);
             }
             // Apply merge cell formatting
             // In Excel, merged cells should have formatting from the top-left (anchor) cell

package/dist/esm/excel-parser/plugins/xlsx/chartex.d.ts

@@ -0,0 +1,37 @@
+import type { EmbeddedChart, SheetRange } from "@rowsncolumns/spreadsheet";
+import type { StreamingZipParser } from "../../zip-parser-streaming";
+import { type ResolveSheetId, type SheetDimensions } from "./charts";
+/**
+ * Excel 2016+ "chartex" charts (`xl/charts/chartEx{N}.xml`, namespace
+ * `http://schemas.microsoft.com/office/drawing/2014/chartex`): treemap,
+ * sunburst, histogram / pareto, box & whisker, waterfall, funnel. They are
+ * anchored through an `mc:AlternateContent` whose `Choice` graphic frame
+ * carries `<cx:chart r:id>` instead of `<c:chart>`, and their data lives in
+ * `<cx:chartData><cx:data>` dimensions (`strDim type="cat"` for the
+ * hierarchy, `numDim type="size"|"val"` for the numbers) referenced by the
+ * series through `<cx:dataId>`.
+ *
+ * The exporter counterpart is `exporter/xlsx/chartex-builder.ts`.
+ */
+export declare const CHART_EX_REL_TYPE = "http://schemas.microsoft.com/office/2014/relationships/chartEx";
+export declare const CHART_EX_GRAPHIC_URI = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+/**
+ * `<cx:chart r:id>` inside an anchor's `mc:AlternateContent` choice (Excel
+ * also writes a plain `xdr:graphicFrame` for some producers — both forms are
+ * checked). Returns the `cx:chart` node or undefined for non-chartex anchors.
+ */
+export declare function getChartExReferenceFromAnchor(anchor: any): any;
+/**
+ * Split a multi-column hierarchy range (Excel lays the treemap hierarchy out
+ * as columns, top level first, leaf last) into `parentLabels` (one entry per
+ * parent column) and `labels` (the leaf column).
+ */
+export declare const splitHierarchyRange: (range: SheetRange) => {
+    parentLabels: SheetRange[];
+    labels: SheetRange;
+};
+/** Parse a `cx:chartSpace` DOM into an `EmbeddedChart` spec (null when unsupported). */
+export declare function parseChartExSpec(chartSpaceDom: any, sheetId: number, resolveSheetId?: ResolveSheetId): EmbeddedChart["spec"] | null;
+/** Resolve + parse one chartex part referenced from a drawing anchor. */
+export declare function processChartEx(chartTarget: string, drawingPath: string, anchor: any, sheetId: number, zipParser: StreamingZipParser, xmlParser: any, sheetDimensions?: SheetDimensions, resolveSheetId?: ResolveSheetId): Promise<EmbeddedChart | null>;
+//# sourceMappingURL=chartex.d.ts.map

package/dist/esm/excel-parser/plugins/xlsx/chartex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartex.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/chartex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,UAAU,EACX,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,iBAAiB,mEACoC,CAAC;AACnE,eAAO,MAAM,oBAAoB,6DAC2B,CAAC;AAyB7D;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAoB9D;AA8BD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,UAAU,KAChB;IAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAalD,CAAC;AAWF,wFAAwF;AACxF,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,GAAG,EAClB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,cAAc,GAC9B,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CA0D9B;AAED,yEAAyE;AACzE,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,GAAG,EACd,eAAe,CAAC,EAAE,eAAe,EACjC,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAsB/B"}