@rowsncolumns/toolkit 24.4.2 → 24.4.4

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,59 @@
+import type { NamedRange, Sheet, TableView } from "@rowsncolumns/spreadsheet";
+import { type DefinedName } from "xlsx/xlsx.mjs";
+import type { ProcessSheetDataResult } from "../../types";
 import { BaseWorkbookPlugin } from "../base/index";
+export declare const ZIP_SIGNATURE: number[];
+export declare const CFB_SIGNATURE: number[];
+export declare const readHeader: (source: ArrayBuffer | File, length: number) => Promise<Uint8Array>;
+export declare const startsWith: (header: Uint8Array, signature: number[]) => boolean;
+/**
+ * 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 declare const mapDefinedNames: (names: ReadonlyArray<DefinedName | undefined>, sheets: ReadonlyArray<{
+    sheetId: number;
+    title: string;
+}>) => 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 declare class XlsPlugin extends BaseWorkbookPlugin {
-    load(_buffer: ArrayBuffer | File, _password?: string): Promise<void>;
+    private sheets;
+    private namedRanges;
+    private cellXfs;
+    private formatIds;
+    private use1904;
+    load(buffer: ArrayBuffer | File, _password?: string): Promise<void>;
+    dispose(): void;
+    getSheetCount(): number;
+    getSheets(minRowCount?: number, minColumnCount?: number): Promise<[Sheet[], TableView[]]>;
+    getCellXfs(): Map<string | number, any>;
+    registerFormat(format: any): string;
+    getNamedRanges(): NamedRange[];
+    /** `WBProps.date1904` — Mac-origin workbooks shift every date serial. */
+    getUse1904Epoch(): boolean;
+    /** Formulas carry their BIFF cached results, so no load-time recalc. */
+    requiresRecalc(): boolean;
+    private toCellData;
+    processSheetData(chunkSize?: number, enableCellXfsRegistry?: boolean, _enableSharedStrings?: boolean): AsyncGenerator<ProcessSheetDataResult, void, unknown>;
 }
 //# 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":"AAEA,OAAO,KAAK,EAIV,UAAU,EACV,KAAK,EACL,SAAS,EACV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAIL,KAAK,WAAW,EAGjB,MAAM,eAAe,CAAC;AAQvB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,eAAO,MAAM,aAAa,UAA2B,CAAC;AACtD,eAAO,MAAM,aAAa,UAAmD,CAAC;AAE9E,eAAO,MAAM,UAAU,GACrB,QAAQ,WAAW,GAAG,IAAI,EAC1B,QAAQ,MAAM,KACb,OAAO,CAAC,UAAU,CAMpB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,UAAU,EAAE,WAAW,MAAM,EAAE,YAER,CAAC;AAqC3D;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,aAAa,CAAC,WAAW,GAAG,SAAS,CAAC,EAC7C,QAAQ,aAAa,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,KACxD,UAAU,EA+BT,CAAC;AAeL;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAU,SAAQ,kBAAkB;IAC/C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,OAAO,CAAS;IAElB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0HzE,OAAO,IAAI,IAAI;IAOf,aAAa,IAAI,MAAM;IAIjB,SAAS,CACb,WAAW,SAAI,EACf,cAAc,SAAI,GACjB,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAiBlC,UAAU,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC;IAIvC,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;IAQnC,cAAc,IAAI,UAAU,EAAE;IAI9B,yEAAyE;IACzE,eAAe,IAAI,OAAO;IAI1B,wEAAwE;IACxE,cAAc,IAAI,OAAO;IAIzB,OAAO,CAAC,UAAU;IAoHX,gBAAgB,CACrB,SAAS,SAAM,EACf,qBAAqB,UAAQ,EAC7B,oBAAoB,CAAC,EAAE,OAAO,GAC7B,cAAc,CAAC,sBAAsB,EAAE,IAAI,EAAE,OAAO,CAAC;CAiEzD"}