@rowsncolumns/toolkit 24.4.1 → 24.4.3

package/dist/esm/excel-parser/plugins/ods/styles.d.ts

@@ -1,13 +1,32 @@
-import type { CellFormat, Color, TextFormat } from "@rowsncolumns/spreadsheet";
+import type { CellFormat, Color, PageMargins, PageSetup, PrintOptions, TextFormat } from "@rowsncolumns/spreadsheet";
 type OdsRowStyle = {
     height?: number;
     hidden?: boolean;
     format?: CellFormat;
+    /** `fo:break-before="page"` — a manual page break above this row. */
+    breakBefore?: boolean;
 };
 type OdsColumnStyle = {
     width?: number;
     hidden?: boolean;
     format?: CellFormat;
+    /** `fo:break-before="page"` — a manual page break left of this column. */
+    breakBefore?: boolean;
+};
+/**
+ * `<style:page-layout>` mapped onto the sheet print facets. Margins are
+ * inches; `fo:page-width/height` resolve to the nearest ECMA paper-size code.
+ */
+export type OdsPageLayout = {
+    pageSetup?: PageSetup;
+    pageMargins?: PageMargins;
+    printOptions?: PrintOptions;
+};
+/** `<style:master-page>`: its page layout plus header/footer as Excel codes. */
+export type OdsMasterPage = {
+    pageLayoutName?: string;
+    header?: string;
+    footer?: string;
 };
 export declare class OdsStyles {
     private cellStyles;
@@ -22,9 +41,28 @@ export declare class OdsStyles {
     private automaticTableStyles;
     private numberFormats;
     private chartStyles;
+    /** Table style name → `style:master-page-name`. */
+    private tableMasterPages;
+    private pageLayouts;
+    private masterPages;
+    /** `style:family="table"` styles whose `style:table-properties` carry a right-to-left `style:writing-mode`. */
+    private rightToLeftTableStyles;
+    /** Chart styles whose `style:chart-properties` carry `chart:three-dimensional="true"`. */
+    private threeDimensionalChartStyles;
     constructor();
     reset(): void;
     parseStylesXml(stylesXml: any): void;
+    /**
+     * `<office:master-styles><style:master-page>` from the ORDER-PRESERVING
+     * parse of styles.xml — header/footer paragraphs are mixed content
+     * (`Page <text:page-number/> of <text:page-count/>`), which the unordered
+     * tree cannot represent.
+     */
+    parseMasterPagesOrdered(stylesOrdered: any): void;
+    private processPageLayouts;
+    getTableMasterPageName(styleName: string): string | undefined;
+    getMasterPage(name: string): OdsMasterPage | undefined;
+    getPageLayout(name: string): OdsPageLayout | undefined;
     parseContentXml(contentXml: any): void;
     private processStyles;
     private processNumberStyles;
@@ -33,6 +71,10 @@ export declare class OdsStyles {
     getRowStyle(styleName: string): OdsRowStyle | undefined;
     getColumnStyle(styleName: string): OdsColumnStyle | undefined;
     getChartStyleColor(styleName?: string): Color | undefined;
+    /** Whether a chart style (plot-area) declares `chart:three-dimensional="true"`. */
+    isChartStyleThreeDimensional(styleName?: string): boolean;
+    /** Whether a `style:family="table"` style renders the sheet right-to-left. */
+    isTableStyleRightToLeft(styleName?: string): boolean;
     getTableCellFormat(styleName: string): CellFormat | undefined;
     getTextFormat(styleName?: string): TextFormat | undefined;
     private convertToCellFormat;

package/dist/esm/excel-parser/plugins/ods/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/ods/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,UAAU,EACV,KAAK,EAGL,UAAU,EACX,MAAM,2BAA2B,CAAC;AAGnC,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,mBAAmB,CAA+B;IAC1D,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,kBAAkB,CAAuC;IACjE,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,qBAAqB,CAA0C;IACvE,OAAO,CAAC,UAAU,CAAkD;IACpE,OAAO,CAAC,mBAAmB,CAAkD;IAC7E,OAAO,CAAC,WAAW,CAAkD;IACrE,OAAO,CAAC,oBAAoB,CAAkD;IAC9E,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,WAAW,CAAiC;;IAIpD,KAAK;IAeL,cAAc,CAAC,SAAS,EAAE,GAAG;IAsB7B,eAAe,CAAC,UAAU,EAAE,GAAG;IAc/B,OAAO,CAAC,aAAa;IA4FrB,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,uBAAuB;IAc/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQnD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAMvD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAO7D,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAKzD,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAO7D,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAOzD,OAAO,CAAC,mBAAmB;IAuP3B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,eAAe;IAoCvB,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,sBAAsB;IAuD9B,OAAO,CAAC,kBAAkB;IAkD1B,OAAO,CAAC,oBAAoB;IA+D5B,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,qBAAqB;CAgB9B"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/ods/styles.ts"],"names":[],"mappings":"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"}

package/dist/esm/excel-parser/plugins/ods/styles.js

@@ -1,4 +1,5 @@
 import { get } from "lodash-es";
+import { headerFooterZoneFromTokens, joinHeaderFooterZones, odsLengthToInches, paperSizeFromCm, parseOdsPrintTokens, parseOdsTableCentering, } from "../../../print-settings";
 export class OdsStyles {
     cellStyles = new Map();
     automaticCellStyles = new Map();
@@ -12,6 +13,14 @@ export class OdsStyles {
     automaticTableStyles = new Map();
     numberFormats = new Map();
     chartStyles = new Map();
+    /** Table style name → `style:master-page-name`. */
+    tableMasterPages = new Map();
+    pageLayouts = new Map();
+    masterPages = new Map();
+    /** `style:family="table"` styles whose `style:table-properties` carry a right-to-left `style:writing-mode`. */
+    rightToLeftTableStyles = new Set();
+    /** Chart styles whose `style:chart-properties` carry `chart:three-dimensional="true"`. */
+    threeDimensionalChartStyles = new Set();
     constructor() { }
     reset() {
         this.cellStyles.clear();
@@ -26,6 +35,11 @@ export class OdsStyles {
         this.automaticTableStyles.clear();
         this.numberFormats.clear();
         this.chartStyles.clear();
+        this.tableMasterPages.clear();
+        this.pageLayouts.clear();
+        this.masterPages.clear();
+        this.rightToLeftTableStyles.clear();
+        this.threeDimensionalChartStyles.clear();
     }
     parseStylesXml(stylesXml) {
         if (!stylesXml)
@@ -42,6 +56,138 @@ export class OdsStyles {
         this.processStyles(automaticStyles, false);
         this.processNumberStyles(documentStyles, get(documentStyles, "office:styles") || get(documentStyles, "styles"), get(documentStyles, "office:automatic-styles") ||
             get(documentStyles, "automatic-styles"));
+        this.processPageLayouts(get(documentStyles, "office:automatic-styles.style:page-layout") ||
+            get(documentStyles, "automatic-styles.page-layout"));
+    }
+    /**
+     * `<office:master-styles><style:master-page>` from the ORDER-PRESERVING
+     * parse of styles.xml — header/footer paragraphs are mixed content
+     * (`Page <text:page-number/> of <text:page-count/>`), which the unordered
+     * tree cannot represent.
+     */
+    parseMasterPagesOrdered(stylesOrdered) {
+        const documentStyles = orderedChildren(stylesOrdered, "office:document-styles") ||
+            orderedChildren(stylesOrdered, "document-styles");
+        const masterStyles = orderedChildren(documentStyles, "office:master-styles") ||
+            orderedChildren(documentStyles, "master-styles");
+        if (!Array.isArray(masterStyles))
+            return;
+        for (const node of masterStyles) {
+            const children = node["style:master-page"] || node["master-page"];
+            if (!children)
+                continue;
+            const attrs = node[":@"] || {};
+            const name = attrs["@_style:name"] || attrs["@_name"];
+            if (!name)
+                continue;
+            const header = odsHeaderFooterToCode(orderedChildren(children, "style:header") ||
+                orderedChildren(children, "header"));
+            const footer = odsHeaderFooterToCode(orderedChildren(children, "style:footer") ||
+                orderedChildren(children, "footer"));
+            this.masterPages.set(name, {
+                pageLayoutName: attrs["@_style:page-layout-name"] || attrs["@_page-layout-name"],
+                header,
+                footer,
+            });
+        }
+    }
+    processPageLayouts(layouts) {
+        if (!layouts)
+            return;
+        for (const layout of Array.isArray(layouts) ? layouts : [layouts]) {
+            const name = layout["@_style:name"] || layout["@_name"];
+            if (!name)
+                continue;
+            const props = this.getAttributes(layout["style:page-layout-properties"] ||
+                layout["page-layout-properties"]) || {};
+            const headerProps = this.getAttributes(get(layout, "style:header-style.style:header-footer-properties") ||
+                get(layout, "header-style.header-footer-properties"));
+            const footerProps = this.getAttributes(get(layout, "style:footer-style.style:header-footer-properties") ||
+                get(layout, "footer-style.header-footer-properties"));
+            const pageSetup = {};
+            const orientation = props["@_style:print-orientation"];
+            if (orientation === "landscape" || orientation === "portrait") {
+                pageSetup.orientation = orientation;
+            }
+            const widthIn = odsLengthToInches(props["@_fo:page-width"]);
+            const heightIn = odsLengthToInches(props["@_fo:page-height"]);
+            if (widthIn !== undefined && heightIn !== undefined) {
+                const code = paperSizeFromCm(widthIn * 2.54, heightIn * 2.54);
+                if (code !== undefined)
+                    pageSetup.paperSize = code;
+            }
+            const scale = parseFloat(String(props["@_style:scale-to"] ?? ""));
+            if (Number.isFinite(scale) && scale > 0) {
+                pageSetup.scale = Math.round(scale);
+            }
+            const scaleToX = parseInt(props["@_loext:scale-to-X"] ?? "", 10);
+            const scaleToY = parseInt(props["@_loext:scale-to-Y"] ?? "", 10);
+            const scaleToPages = parseInt(props["@_style:scale-to-pages"] ?? "", 10);
+            if (Number.isFinite(scaleToX) || Number.isFinite(scaleToY)) {
+                pageSetup.fitToPage = true;
+                pageSetup.fitToWidth = Number.isFinite(scaleToX) ? scaleToX : 0;
+                pageSetup.fitToHeight = Number.isFinite(scaleToY) ? scaleToY : 0;
+            }
+            else if (Number.isFinite(scaleToPages)) {
+                // ODF's single "total pages" knob: 1 page ≡ Excel's 1×1 fit.
+                pageSetup.fitToPage = true;
+                pageSetup.fitToWidth = scaleToPages;
+                pageSetup.fitToHeight = scaleToPages === 1 ? 1 : 0;
+            }
+            const pageOrder = props["@_style:print-page-order"];
+            if (pageOrder === "ltr")
+                pageSetup.pageOrder = "overThenDown";
+            const firstPage = parseInt(props["@_style:first-page-number"] ?? "", 10);
+            if (Number.isFinite(firstPage) && firstPage > 0) {
+                pageSetup.firstPageNumber = firstPage;
+                pageSetup.useFirstPageNumber = true;
+            }
+            // ODF: header sits inside `fo:margin-top`; Excel: `header` is the edge
+            // → header distance and `top` the edge → body distance.
+            const marginTop = odsLengthToInches(props["@_fo:margin-top"]);
+            const marginBottom = odsLengthToInches(props["@_fo:margin-bottom"]);
+            const headerHeight = (odsLengthToInches(headerProps?.["@_fo:min-height"]) ?? 0) +
+                (odsLengthToInches(headerProps?.["@_fo:margin-bottom"]) ?? 0);
+            const footerHeight = (odsLengthToInches(footerProps?.["@_fo:min-height"]) ?? 0) +
+                (odsLengthToInches(footerProps?.["@_fo:margin-top"]) ?? 0);
+            const pageMargins = {};
+            const left = odsLengthToInches(props["@_fo:margin-left"]);
+            const right = odsLengthToInches(props["@_fo:margin-right"]);
+            if (left !== undefined)
+                pageMargins.left = roundInches(left);
+            if (right !== undefined)
+                pageMargins.right = roundInches(right);
+            if (marginTop !== undefined) {
+                pageMargins.header = roundInches(marginTop);
+                pageMargins.top = roundInches(marginTop + headerHeight);
+            }
+            if (marginBottom !== undefined) {
+                pageMargins.footer = roundInches(marginBottom);
+                pageMargins.bottom = roundInches(marginBottom + footerHeight);
+            }
+            const printOptions = {
+                ...parseOdsPrintTokens(props["@_style:print"]),
+                ...parseOdsTableCentering(props["@_style:table-centering"]),
+            };
+            const layoutEntry = {};
+            if (Object.keys(pageSetup).length)
+                layoutEntry.pageSetup = pageSetup;
+            if (Object.keys(pageMargins).length)
+                layoutEntry.pageMargins = pageMargins;
+            if (Object.keys(printOptions).length) {
+                layoutEntry.printOptions = printOptions;
+            }
+            this.pageLayouts.set(name, layoutEntry);
+        }
+    }
+    getTableMasterPageName(styleName) {
+        return this.tableMasterPages.get(styleName);
+    }
+    getMasterPage(name) {
+        return this.masterPages.get(name);
+    }
+    getPageLayout(name) {
+        return this.pageLayouts.get(name);
     }
     parseContentXml(contentXml) {
         if (!contentXml)
@@ -76,6 +222,19 @@ export class OdsStyles {
                 continue;
             }
             if (family === "table") {
+                const masterPageName = style["@_style:master-page-name"] || style["@_master-page-name"];
+                if (masterPageName) {
+                    this.tableMasterPages.set(name, masterPageName);
+                }
+                // ODF has no per-sheet flag for right-to-left display; it is the
+                // table style's `style:writing-mode` (`rl-tb` / `rl`), the
+                // counterpart of OOXML `<sheetView rightToLeft="1">`.
+                const tableProps = this.getAttributes(style["style:table-properties"] || style["table-properties"]);
+                const writingMode = tableProps?.["@_style:writing-mode"] ?? tableProps?.["@_writing-mode"];
+                if (typeof writingMode === "string" &&
+                    /^(rl|rl-tb|tb-rl)$/.test(writingMode)) {
+                    this.rightToLeftTableStyles.add(name);
+                }
                 const format = this.normalizeCellFormat(this.convertToCellFormat(style));
                 if (format) {
                     (isAutomatic ? this.automaticTableStyles : this.tableStyles).set(name, format);
@@ -104,6 +263,12 @@ export class OdsStyles {
             }
             if (typeof family === "string" &&
                 (family.startsWith("chart") || family === "graphic")) {
+                const chartProps = this.getAttributes(style["style:chart-properties"] || style["chart:chart-properties"]);
+                const threeDimensional = chartProps?.["@_chart:three-dimensional"] ??
+                    chartProps?.["@_three-dimensional"];
+                if (threeDimensional === "true" || threeDimensional === true) {
+                    this.threeDimensionalChartStyles.add(name);
+                }
                 const color = this.convertChartStyle(style);
                 if (color) {
                     const displayName = style["@_style:display-name"] || style["@_display-name"];
@@ -174,6 +339,14 @@ export class OdsStyles {
             return undefined;
         return this.chartStyles.get(styleName);
     }
+    /** Whether a chart style (plot-area) declares `chart:three-dimensional="true"`. */
+    isChartStyleThreeDimensional(styleName) {
+        return !!styleName && this.threeDimensionalChartStyles.has(styleName);
+    }
+    /** Whether a `style:family="table"` style renders the sheet right-to-left. */
+    isTableStyleRightToLeft(styleName) {
+        return !!styleName && this.rightToLeftTableStyles.has(styleName);
+    }
     getTableCellFormat(styleName) {
         return (this.automaticTableStyles.get(styleName) ||
             this.tableStyles.get(styleName));
@@ -411,14 +584,16 @@ export class OdsStyles {
         const hidden = visibility === "collapse" ||
             visibility === "hidden" ||
             visibility === "none";
+        const breakBefore = rowProps?.["@_fo:break-before"] === "page";
         const format = this.normalizeCellFormat(this.convertToCellFormat(style));
-        if (height === undefined && !hidden && !format) {
+        if (height === undefined && !hidden && !format && !breakBefore) {
             return undefined;
         }
         return {
             height,
             hidden,
             format,
+            ...(breakBefore ? { breakBefore } : {}),
         };
     }
     convertColumnStyle(style) {
@@ -439,14 +614,16 @@ export class OdsStyles {
         const hidden = visibility === "collapse" ||
             visibility === "hidden" ||
             visibility === "none";
+        const breakBefore = columnProps?.["@_fo:break-before"] === "page";
         const format = this.normalizeCellFormat(this.convertToCellFormat(style));
-        if (width === undefined && !hidden && !format) {
+        if (width === undefined && !hidden && !format && !breakBefore) {
             return undefined;
         }
         return {
             width,
             hidden,
             format,
+            ...(breakBefore ? { breakBefore } : {}),
         };
     }
     convertChartStyle(style) {
@@ -730,3 +907,100 @@ export class OdsStyles {
         return undefined;
     }
 }
+const roundInches = (value) => Math.round(value * 1000) / 1000;
+/** Children of the first `tagName` node in an order-preserving node list. */
+const orderedChildren = (nodes, tagName) => {
+    if (!Array.isArray(nodes))
+        return undefined;
+    const found = nodes.find((node) => node && node[tagName]);
+    return found ? found[tagName] : undefined;
+};
+const ODS_FIELD_TAGS = {
+    "text:page-number": "page",
+    "text:page-count": "pages",
+    "text:date": "date",
+    "text:time": "time",
+    "text:sheet-name": "sheet",
+    "text:title": "sheet",
+    "text:file-name": "file",
+};
+/** One `<text:p>` (order-preserving children) → header/footer tokens. */
+const odsParagraphToTokens = (children) => {
+    const tokens = [];
+    for (const child of children ?? []) {
+        if (!child || typeof child !== "object")
+            continue;
+        if (child["#text"] !== undefined) {
+            tokens.push({ type: "text", text: String(child["#text"]) });
+            continue;
+        }
+        const tag = Object.keys(child).find((key) => key !== ":@");
+        if (!tag)
+            continue;
+        const attrs = child[":@"] || {};
+        if (tag === "text:s") {
+            const count = parseInt(attrs["@_text:c"] ?? "1", 10);
+            tokens.push({ type: "text", text: " ".repeat(Number.isFinite(count) ? count : 1) });
+            continue;
+        }
+        if (tag === "text:tab") {
+            tokens.push({ type: "text", text: "\t" });
+            continue;
+        }
+        if (tag === "text:line-break") {
+            tokens.push({ type: "text", text: "\n" });
+            continue;
+        }
+        const field = ODS_FIELD_TAGS[tag];
+        if (field) {
+            // `<text:file-name text:display>`: `path` is the folder (`&Z`), `full`
+            // the folder + name (`&Z&F`); `name` / `name-and-extension` / absent
+            // is the file name (`&F`).
+            const display = field === "file" ? attrs["@_text:display"] : undefined;
+            if (display === "path" || display === "full") {
+                tokens.push({ type: "field", field: "path" });
+            }
+            if (display !== "path") {
+                tokens.push({ type: "field", field });
+            }
+            continue;
+        }
+        // `text:span`, `text:a`, … — descend.
+        tokens.push(...odsParagraphToTokens(child[tag]));
+    }
+    return tokens;
+};
+const odsRegionToCode = (children) => {
+    if (!Array.isArray(children))
+        return undefined;
+    const paragraphs = children
+        .filter((node) => node && (node["text:p"] || node["p"]))
+        .map((node) => headerFooterZoneFromTokens(odsParagraphToTokens(node["text:p"] || node["p"])));
+    const code = paragraphs.join("\n");
+    return code ? code : undefined;
+};
+/**
+ * `<style:header>` / `<style:footer>` (order-preserving children) → Excel
+ * header/footer code. Regions map to `&L` / `&C` / `&R`; paragraphs outside
+ * regions are the centre zone. `style:display="false"` yields nothing.
+ */
+const odsHeaderFooterToCode = (children) => {
+    if (!Array.isArray(children))
+        return undefined;
+    const zones = {};
+    const left = odsRegionToCode(orderedChildren(children, "style:region-left") ||
+        orderedChildren(children, "region-left"));
+    const center = odsRegionToCode(orderedChildren(children, "style:region-center") ||
+        orderedChildren(children, "region-center"));
+    const right = odsRegionToCode(orderedChildren(children, "style:region-right") ||
+        orderedChildren(children, "region-right"));
+    const plain = odsRegionToCode(children);
+    if (left)
+        zones.left = left;
+    if (center || plain)
+        zones.center = center ?? plain;
+    if (right)
+        zones.right = right;
+    const code = joinHeaderFooterZones(zones);
+    return code ? code : undefined;
+};

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

@@ -1,5 +1,13 @@
-import { BaseWorkbookPlugin } from "../base/index";
-export declare class XlsPlugin extends BaseWorkbookPlugin {
-    load(_buffer: ArrayBuffer | File, _password?: string): Promise<void>;
+import { XlsxPlugin } from "../xlsx/index";
+/**
+ * `.xls` handler. The BIFF (Excel 97-2003) binary format is not parsed;
+ * this plugin exists so a `.xls` file gets a clear, actionable error
+ * instead of falling through to the xlsx zip reader (which fails with an
+ * opaque "not a zip" error) or stalling in the password prompt. The one
+ * `.xls` shape that does load is an OOXML package saved with the wrong
+ * extension — Excel opens those too, so they are handed to the xlsx parser.
+ */
+export declare class XlsPlugin extends XlsxPlugin {
+    load(buffer: ArrayBuffer | File, password?: string): Promise<void>;
 }
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xls/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,qBAAa,SAAU,SAAQ,kBAAkB;IACzC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xls/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAoB3C;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACjC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM;CAiBzD"}

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

@@ -1,7 +1,39 @@
-import { BaseWorkbookPlugin } from "../base/index";
-export class XlsPlugin extends BaseWorkbookPlugin {
-    async load(_buffer, _password) {
-        // TODO: Implement XLS loading (CFB format)
-        console.warn("XLS support not implemented yet");
+import { detectCfbContainerKind, LEGACY_XLS_UNSUPPORTED_MESSAGE, XLS_NOT_A_WORKBOOK_MESSAGE, } from "../../cfb-decryptor";
+import { XlsxPlugin } from "../xlsx/index";
+const ZIP_SIGNATURE = [0x50, 0x4b, 0x03, 0x04];
+const CFB_SIGNATURE = [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1];
+const readHeader = async (source, length) => {
+    const slice = source instanceof File
+        ? await source.slice(0, length).arrayBuffer()
+        : source.slice(0, length);
+    return new Uint8Array(slice);
+};
+const startsWith = (header, signature) => header.length >= signature.length &&
+    signature.every((byte, index) => header[index] === byte);
+/**
+ * `.xls` handler. The BIFF (Excel 97-2003) binary format is not parsed;
+ * this plugin exists so a `.xls` file gets a clear, actionable error
+ * instead of falling through to the xlsx zip reader (which fails with an
+ * opaque "not a zip" error) or stalling in the password prompt. The one
+ * `.xls` shape that does load is an OOXML package saved with the wrong
+ * extension — Excel opens those too, so they are handed to the xlsx parser.
+ */
+export class XlsPlugin extends XlsxPlugin {
+    async load(buffer, password) {
+        const header = await readHeader(buffer, CFB_SIGNATURE.length);
+        if (startsWith(header, ZIP_SIGNATURE)) {
+            return super.load(buffer, password);
+        }
+        if (startsWith(header, CFB_SIGNATURE)) {
+            // A CFB container: a BIFF workbook, or (when the caller skipped the
+            // WorkBook-level decryption) an encrypted package. Either way the
+            // legacy-workbook guidance is the actionable one for a .xls name.
+            const kind = await detectCfbContainerKind(buffer);
+            if (kind === "encrypted-ooxml") {
+                throw new Error("PASSWORD_REQUIRED");
+            }
+            throw new Error(LEGACY_XLS_UNSUPPORTED_MESSAGE);
+        }
+        throw new Error(XLS_NOT_A_WORKBOOK_MESSAGE);
     }
 }

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,7 +4,7 @@ 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";
@@ -274,10 +274,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();
@@ -1267,6 +1274,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 +1540,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 +1587,7 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
         const rowMetadata = [];
         const columnMetadata = [];
         let showGridLines;
+        let rightToLeft;
         let frozenRowCount;
         let frozenColumnCount;
         let basicFilterRange;
@@ -1587,6 +1597,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 +1683,7 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
             rowMetadata,
             columnMetadata,
             showGridLines,
+            rightToLeft,
             frozenRowCount,
             frozenColumnCount,
             basicFilterRange,
@@ -1727,6 +1740,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 }
                     : {}),

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

@@ -17,6 +17,16 @@ export declare function extractChartDataRange(plotArea: any, chartType: string,
 export declare function extractHiddenDimensionStrategy(chart: any): HIDDEN_DIMENSION_STRATEGY | undefined;
 export declare function extractChartTitle(chart: any): string;
 export declare function determineChartType(chart: any): "bar" | "column" | "line" | "pie" | "doughnut" | "area" | "radar" | "stock" | "scatter" | "bubble" | "treemap" | "sunburst" | "histogram" | "boxplot" | "waterfall" | "funnel";
+/**
+ * The authored 3-D / surface chart class, when the plot area's chart
+ * element is one of Excel's 3-D variants. These degrade to their 2-D
+ * `chartType` (bar3DChart → bar/column, line3DChart → line, pie3DChart →
+ * pie, area3DChart / surfaceChart / surface3DChart → area) and the
+ * original class is preserved verbatim as `sourceChartType`, matching the
+ * Rust importer, so the renderer's echarts-gl pipeline and the exporter's
+ * 3-D writer can restore it. Undefined for plain 2-D charts.
+ */
+export declare function extractThreeDSourceChartType(plotArea: any): "BAR_3D" | "LINE_3D" | "PIE_3D" | "AREA_3D" | "SURFACE" | "SURFACE_3D" | undefined;
 /**
  * Phase 5.5 — pull binCount out of the c15:histogramChart extension
  * marker. Returns undefined if absent.