@rowsncolumns/toolkit 24.4.1 → 24.4.3

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

@@ -1,5 +1,6 @@
-import { __assign, __values } from "tslib";
+import { __assign, __read, __spreadArray, __values } from "tslib";
 import { get } from "lodash-es";
+import { headerFooterZoneFromTokens, joinHeaderFooterZones, odsLengthToInches, paperSizeFromCm, parseOdsPrintTokens, parseOdsTableCentering, } from "../../../print-settings";
 var OdsStyles = /** @class */ (function () {
     function OdsStyles() {
         this.cellStyles = new Map();
@@ -14,6 +15,14 @@ var OdsStyles = /** @class */ (function () {
         this.automaticTableStyles = new Map();
         this.numberFormats = new Map();
         this.chartStyles = new Map();
+        /** Table style name → `style:master-page-name`. */
+        this.tableMasterPages = new Map();
+        this.pageLayouts = new Map();
+        this.masterPages = new Map();
+        /** `style:family="table"` styles whose `style:table-properties` carry a right-to-left `style:writing-mode`. */
+        this.rightToLeftTableStyles = new Set();
+        /** Chart styles whose `style:chart-properties` carry `chart:three-dimensional="true"`. */
+        this.threeDimensionalChartStyles = new Set();
     }
     OdsStyles.prototype.reset = function () {
         this.cellStyles.clear();
@@ -28,6 +37,11 @@ var OdsStyles = /** @class */ (function () {
         this.automaticTableStyles.clear();
         this.numberFormats.clear();
         this.chartStyles.clear();
+        this.tableMasterPages.clear();
+        this.pageLayouts.clear();
+        this.masterPages.clear();
+        this.rightToLeftTableStyles.clear();
+        this.threeDimensionalChartStyles.clear();
     };
     OdsStyles.prototype.parseStylesXml = function (stylesXml) {
         if (!stylesXml)
@@ -44,6 +58,158 @@ var OdsStyles = /** @class */ (function () {
         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.
+     */
+    OdsStyles.prototype.parseMasterPagesOrdered = function (stylesOrdered) {
+        var e_1, _a;
+        var documentStyles = orderedChildren(stylesOrdered, "office:document-styles") ||
+            orderedChildren(stylesOrdered, "document-styles");
+        var masterStyles = orderedChildren(documentStyles, "office:master-styles") ||
+            orderedChildren(documentStyles, "master-styles");
+        if (!Array.isArray(masterStyles))
+            return;
+        try {
+            for (var masterStyles_1 = __values(masterStyles), masterStyles_1_1 = masterStyles_1.next(); !masterStyles_1_1.done; masterStyles_1_1 = masterStyles_1.next()) {
+                var node = masterStyles_1_1.value;
+                var children = node["style:master-page"] || node["master-page"];
+                if (!children)
+                    continue;
+                var attrs = node[":@"] || {};
+                var name_1 = attrs["@_style:name"] || attrs["@_name"];
+                if (!name_1)
+                    continue;
+                var header = odsHeaderFooterToCode(orderedChildren(children, "style:header") ||
+                    orderedChildren(children, "header"));
+                var footer = odsHeaderFooterToCode(orderedChildren(children, "style:footer") ||
+                    orderedChildren(children, "footer"));
+                this.masterPages.set(name_1, {
+                    pageLayoutName: attrs["@_style:page-layout-name"] || attrs["@_page-layout-name"],
+                    header: header,
+                    footer: footer,
+                });
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (masterStyles_1_1 && !masterStyles_1_1.done && (_a = masterStyles_1.return)) _a.call(masterStyles_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    };
+    OdsStyles.prototype.processPageLayouts = function (layouts) {
+        var e_2, _a;
+        var _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        if (!layouts)
+            return;
+        try {
+            for (var _l = __values(Array.isArray(layouts) ? layouts : [layouts]), _m = _l.next(); !_m.done; _m = _l.next()) {
+                var layout = _m.value;
+                var name_2 = layout["@_style:name"] || layout["@_name"];
+                if (!name_2)
+                    continue;
+                var props = this.getAttributes(layout["style:page-layout-properties"] ||
+                    layout["page-layout-properties"]) || {};
+                var headerProps = this.getAttributes(get(layout, "style:header-style.style:header-footer-properties") ||
+                    get(layout, "header-style.header-footer-properties"));
+                var footerProps = this.getAttributes(get(layout, "style:footer-style.style:header-footer-properties") ||
+                    get(layout, "footer-style.header-footer-properties"));
+                var pageSetup = {};
+                var orientation_1 = props["@_style:print-orientation"];
+                if (orientation_1 === "landscape" || orientation_1 === "portrait") {
+                    pageSetup.orientation = orientation_1;
+                }
+                var widthIn = odsLengthToInches(props["@_fo:page-width"]);
+                var heightIn = odsLengthToInches(props["@_fo:page-height"]);
+                if (widthIn !== undefined && heightIn !== undefined) {
+                    var code = paperSizeFromCm(widthIn * 2.54, heightIn * 2.54);
+                    if (code !== undefined)
+                        pageSetup.paperSize = code;
+                }
+                var scale = parseFloat(String((_b = props["@_style:scale-to"]) !== null && _b !== void 0 ? _b : ""));
+                if (Number.isFinite(scale) && scale > 0) {
+                    pageSetup.scale = Math.round(scale);
+                }
+                var scaleToX = parseInt((_c = props["@_loext:scale-to-X"]) !== null && _c !== void 0 ? _c : "", 10);
+                var scaleToY = parseInt((_d = props["@_loext:scale-to-Y"]) !== null && _d !== void 0 ? _d : "", 10);
+                var scaleToPages = parseInt((_e = props["@_style:scale-to-pages"]) !== null && _e !== void 0 ? _e : "", 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;
+                }
+                var pageOrder = props["@_style:print-page-order"];
+                if (pageOrder === "ltr")
+                    pageSetup.pageOrder = "overThenDown";
+                var firstPage = parseInt((_f = props["@_style:first-page-number"]) !== null && _f !== void 0 ? _f : "", 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.
+                var marginTop = odsLengthToInches(props["@_fo:margin-top"]);
+                var marginBottom = odsLengthToInches(props["@_fo:margin-bottom"]);
+                var headerHeight = ((_g = odsLengthToInches(headerProps === null || headerProps === void 0 ? void 0 : headerProps["@_fo:min-height"])) !== null && _g !== void 0 ? _g : 0) +
+                    ((_h = odsLengthToInches(headerProps === null || headerProps === void 0 ? void 0 : headerProps["@_fo:margin-bottom"])) !== null && _h !== void 0 ? _h : 0);
+                var footerHeight = ((_j = odsLengthToInches(footerProps === null || footerProps === void 0 ? void 0 : footerProps["@_fo:min-height"])) !== null && _j !== void 0 ? _j : 0) +
+                    ((_k = odsLengthToInches(footerProps === null || footerProps === void 0 ? void 0 : footerProps["@_fo:margin-top"])) !== null && _k !== void 0 ? _k : 0);
+                var pageMargins = {};
+                var left = odsLengthToInches(props["@_fo:margin-left"]);
+                var 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);
+                }
+                var printOptions = __assign(__assign({}, parseOdsPrintTokens(props["@_style:print"])), parseOdsTableCentering(props["@_style:table-centering"]));
+                var 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_2, layoutEntry);
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (_m && !_m.done && (_a = _l.return)) _a.call(_l);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+    };
+    OdsStyles.prototype.getTableMasterPageName = function (styleName) {
+        return this.tableMasterPages.get(styleName);
+    };
+    OdsStyles.prototype.getMasterPage = function (name) {
+        return this.masterPages.get(name);
+    };
+    OdsStyles.prototype.getPageLayout = function (name) {
+        return this.pageLayouts.get(name);
     };
     OdsStyles.prototype.parseContentXml = function (contentXml) {
         if (!contentXml)
@@ -55,46 +221,60 @@ var OdsStyles = /** @class */ (function () {
         this.processNumberStyles(contentXml, autoStylesContainer);
     };
     OdsStyles.prototype.processStyles = function (styles, isAutomatic) {
-        var e_1, _a;
+        var e_3, _a;
+        var _b, _c;
         if (!styles)
             return;
         var styleArray = Array.isArray(styles) ? styles : [styles];
         try {
             for (var styleArray_1 = __values(styleArray), styleArray_1_1 = styleArray_1.next(); !styleArray_1_1.done; styleArray_1_1 = styleArray_1.next()) {
                 var style = styleArray_1_1.value;
-                var name_1 = style["@_style:name"] || style["@_name"];
-                if (!name_1)
+                var name_3 = style["@_style:name"] || style["@_name"];
+                if (!name_3)
                     continue;
                 var family = style["@_style:family"] || style["@_family"];
                 if (family === "table-row") {
                     var props = this.convertRowStyle(style);
                     if (props) {
-                        (isAutomatic ? this.automaticRowStyles : this.rowStyles).set(name_1, props);
+                        (isAutomatic ? this.automaticRowStyles : this.rowStyles).set(name_3, props);
                     }
                     continue;
                 }
                 if (family === "table-column") {
                     var props = this.convertColumnStyle(style);
                     if (props) {
-                        (isAutomatic ? this.automaticColumnStyles : this.columnStyles).set(name_1, props);
+                        (isAutomatic ? this.automaticColumnStyles : this.columnStyles).set(name_3, props);
                     }
                     continue;
                 }
                 if (family === "table") {
+                    var masterPageName = style["@_style:master-page-name"] || style["@_master-page-name"];
+                    if (masterPageName) {
+                        this.tableMasterPages.set(name_3, 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">`.
+                    var tableProps = this.getAttributes(style["style:table-properties"] || style["table-properties"]);
+                    var writingMode = (_b = tableProps === null || tableProps === void 0 ? void 0 : tableProps["@_style:writing-mode"]) !== null && _b !== void 0 ? _b : tableProps === null || tableProps === void 0 ? void 0 : tableProps["@_writing-mode"];
+                    if (typeof writingMode === "string" &&
+                        /^(rl|rl-tb|tb-rl)$/.test(writingMode)) {
+                        this.rightToLeftTableStyles.add(name_3);
+                    }
                     var format = this.normalizeCellFormat(this.convertToCellFormat(style));
                     if (format) {
-                        (isAutomatic ? this.automaticTableStyles : this.tableStyles).set(name_1, format);
+                        (isAutomatic ? this.automaticTableStyles : this.tableStyles).set(name_3, format);
                     }
                     continue;
                 }
                 if (family === "text") {
                     var format = this.normalizeCellFormat(this.convertToCellFormat(style));
-                    (isAutomatic ? this.automaticTextStyles : this.textStyles).set(name_1, format);
+                    (isAutomatic ? this.automaticTextStyles : this.textStyles).set(name_3, format);
                     continue;
                 }
                 if (family === "table-cell") {
                     var displayName = style["@_style:display-name"] || style["@_display-name"];
-                    var key = displayName || name_1;
+                    var key = displayName || name_3;
                     if (!key) {
                         continue;
                     }
@@ -102,21 +282,26 @@ var OdsStyles = /** @class */ (function () {
                         ? this.automaticCellStyles
                         : this.cellStyles;
                     targetMap.set(key, style);
-                    if (displayName && name_1 && name_1 !== key && !targetMap.has(name_1)) {
-                        targetMap.set(name_1, style);
+                    if (displayName && name_3 && name_3 !== key && !targetMap.has(name_3)) {
+                        targetMap.set(name_3, style);
                     }
                     continue;
                 }
                 if (typeof family === "string" &&
                     (family.startsWith("chart") || family === "graphic")) {
+                    var chartProps = this.getAttributes(style["style:chart-properties"] || style["chart:chart-properties"]);
+                    var threeDimensional = (_c = chartProps === null || chartProps === void 0 ? void 0 : chartProps["@_chart:three-dimensional"]) !== null && _c !== void 0 ? _c : chartProps === null || chartProps === void 0 ? void 0 : chartProps["@_three-dimensional"];
+                    if (threeDimensional === "true" || threeDimensional === true) {
+                        this.threeDimensionalChartStyles.add(name_3);
+                    }
                     var color = this.convertChartStyle(style);
                     if (color) {
                         var displayName = style["@_style:display-name"] || style["@_display-name"];
-                        var key = displayName || name_1;
+                        var key = displayName || name_3;
                         if (key) {
                             this.chartStyles.set(key, color);
-                            if (displayName && name_1 && name_1 !== key) {
-                                this.chartStyles.set(name_1, color);
+                            if (displayName && name_3 && name_3 !== key) {
+                                this.chartStyles.set(name_3, color);
                             }
                         }
                     }
@@ -124,16 +309,16 @@ var OdsStyles = /** @class */ (function () {
                 }
             }
         }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        catch (e_3_1) { e_3 = { error: e_3_1 }; }
         finally {
             try {
                 if (styleArray_1_1 && !styleArray_1_1.done && (_a = styleArray_1.return)) _a.call(styleArray_1);
             }
-            finally { if (e_1) throw e_1.error; }
+            finally { if (e_3) throw e_3.error; }
         }
     };
     OdsStyles.prototype.processNumberStyles = function () {
-        var e_2, _a, e_3, _b;
+        var e_4, _a, e_5, _b;
         var _c, _d;
         var containers = [];
         for (var _i = 0; _i < arguments.length; _i++) {
@@ -154,31 +339,31 @@ var OdsStyles = /** @class */ (function () {
                 if (!container)
                     continue;
                 try {
-                    for (var definitions_1 = (e_3 = void 0, __values(definitions)), definitions_1_1 = definitions_1.next(); !definitions_1_1.done; definitions_1_1 = definitions_1.next()) {
+                    for (var definitions_1 = (e_5 = void 0, __values(definitions)), definitions_1_1 = definitions_1.next(); !definitions_1_1.done; definitions_1_1 = definitions_1.next()) {
                         var _e = definitions_1_1.value, key = _e.key, kind = _e.kind;
                         var nodes = (_d = (_c = (container && container[key])) !== null && _c !== void 0 ? _c : get(container, key)) !== null && _d !== void 0 ? _d : get(container, key.replace("number:", ""));
                         this.processNumberStyleNodes(nodes, kind);
                     }
                 }
-                catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                catch (e_5_1) { e_5 = { error: e_5_1 }; }
                 finally {
                     try {
                         if (definitions_1_1 && !definitions_1_1.done && (_b = definitions_1.return)) _b.call(definitions_1);
                     }
-                    finally { if (e_3) throw e_3.error; }
+                    finally { if (e_5) throw e_5.error; }
                 }
             }
         }
-        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        catch (e_4_1) { e_4 = { error: e_4_1 }; }
         finally {
             try {
                 if (containers_1_1 && !containers_1_1.done && (_a = containers_1.return)) _a.call(containers_1);
             }
-            finally { if (e_2) throw e_2.error; }
+            finally { if (e_4) throw e_4.error; }
         }
     };
     OdsStyles.prototype.processNumberStyleNodes = function (nodes, kind) {
-        var e_4, _a;
+        var e_6, _a;
         if (!nodes)
             return;
         var arr = Array.isArray(nodes) ? nodes : [nodes];
@@ -187,21 +372,21 @@ var OdsStyles = /** @class */ (function () {
                 var node = arr_1_1.value;
                 if (!node)
                     continue;
-                var name_2 = node["@_style:name"] || node["@_name"];
-                if (!name_2)
+                var name_4 = node["@_style:name"] || node["@_name"];
+                if (!name_4)
                     continue;
                 var numberFormat = this.convertNumberStyleNode(node, kind);
                 if (numberFormat) {
-                    this.numberFormats.set(name_2, numberFormat);
+                    this.numberFormats.set(name_4, numberFormat);
                 }
             }
         }
-        catch (e_4_1) { e_4 = { error: e_4_1 }; }
+        catch (e_6_1) { e_6 = { error: e_6_1 }; }
         finally {
             try {
                 if (arr_1_1 && !arr_1_1.done && (_a = arr_1.return)) _a.call(arr_1);
             }
-            finally { if (e_4) throw e_4.error; }
+            finally { if (e_6) throw e_6.error; }
         }
     };
     OdsStyles.prototype.getStyle = function (styleName) {
@@ -222,6 +407,14 @@ var OdsStyles = /** @class */ (function () {
             return undefined;
         return this.chartStyles.get(styleName);
     };
+    /** Whether a chart style (plot-area) declares `chart:three-dimensional="true"`. */
+    OdsStyles.prototype.isChartStyleThreeDimensional = function (styleName) {
+        return !!styleName && this.threeDimensionalChartStyles.has(styleName);
+    };
+    /** Whether a `style:family="table"` style renders the sheet right-to-left. */
+    OdsStyles.prototype.isTableStyleRightToLeft = function (styleName) {
+        return !!styleName && this.rightToLeftTableStyles.has(styleName);
+    };
     OdsStyles.prototype.getTableCellFormat = function (styleName) {
         return (this.automaticTableStyles.get(styleName) ||
             this.tableStyles.get(styleName));
@@ -234,7 +427,7 @@ var OdsStyles = /** @class */ (function () {
         return (_a = format === null || format === void 0 ? void 0 : format.textFormat) !== null && _a !== void 0 ? _a : undefined;
     };
     OdsStyles.prototype.convertToCellFormat = function (style) {
-        var e_5, _a, e_6, _b;
+        var e_7, _a, e_8, _b;
         var _c;
         var cellFormat = {};
         var textPropsNode = style["style:text-properties"] || style["text-properties"];
@@ -349,12 +542,12 @@ var OdsStyles = /** @class */ (function () {
                     cellFormat.borders[key] = parsedBorder;
                 }
             }
-            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+            catch (e_7_1) { e_7 = { error: e_7_1 }; }
             finally {
                 try {
                     if (sideMap_1_1 && !sideMap_1_1.done && (_a = sideMap_1.return)) _a.call(sideMap_1);
                 }
-                finally { if (e_5) throw e_5.error; }
+                finally { if (e_7) throw e_7.error; }
             }
             // ODS diagonals: `style:diagonal-bl-tr` = bottom-left → top-right
             // (= our diagonalUp). `style:diagonal-tl-br` = top-left → bottom-right
@@ -385,12 +578,12 @@ var OdsStyles = /** @class */ (function () {
                     cellFormat.borders[key] = parsedBorder;
                 }
             }
-            catch (e_6_1) { e_6 = { error: e_6_1 }; }
+            catch (e_8_1) { e_8 = { error: e_8_1 }; }
             finally {
                 try {
                     if (diagonalMap_1_1 && !diagonalMap_1_1.done && (_b = diagonalMap_1.return)) _b.call(diagonalMap_1);
                 }
-                finally { if (e_6) throw e_6.error; }
+                finally { if (e_8) throw e_8.error; }
             }
             var verticalAlign = cellProps["@_style:vertical-align"] ||
                 cellProps["@_vertical-align"] ||
@@ -482,15 +675,12 @@ var OdsStyles = /** @class */ (function () {
         var hidden = visibility === "collapse" ||
             visibility === "hidden" ||
             visibility === "none";
+        var breakBefore = (rowProps === null || rowProps === void 0 ? void 0 : rowProps["@_fo:break-before"]) === "page";
         var format = this.normalizeCellFormat(this.convertToCellFormat(style));
-        if (height === undefined && !hidden && !format) {
+        if (height === undefined && !hidden && !format && !breakBefore) {
             return undefined;
         }
-        return {
-            height: height,
-            hidden: hidden,
-            format: format,
-        };
+        return __assign({ height: height, hidden: hidden, format: format }, (breakBefore ? { breakBefore: breakBefore } : {}));
     };
     OdsStyles.prototype.convertColumnStyle = function (style) {
         var columnPropsNode = style["style:table-column-properties"] ||
@@ -510,15 +700,12 @@ var OdsStyles = /** @class */ (function () {
         var hidden = visibility === "collapse" ||
             visibility === "hidden" ||
             visibility === "none";
+        var breakBefore = (columnProps === null || columnProps === void 0 ? void 0 : columnProps["@_fo:break-before"]) === "page";
         var format = this.normalizeCellFormat(this.convertToCellFormat(style));
-        if (width === undefined && !hidden && !format) {
+        if (width === undefined && !hidden && !format && !breakBefore) {
             return undefined;
         }
-        return {
-            width: width,
-            hidden: hidden,
-            format: format,
-        };
+        return __assign({ width: width, hidden: hidden, format: format }, (breakBefore ? { breakBefore: breakBefore } : {}));
     };
     OdsStyles.prototype.convertChartStyle = function (style) {
         var graphicProps = style["style:graphic-properties"] || style["graphic-properties"];
@@ -806,3 +993,114 @@ var OdsStyles = /** @class */ (function () {
     return OdsStyles;
 }());
 export { OdsStyles };
+var roundInches = function (value) { return Math.round(value * 1000) / 1000; };
+/** Children of the first `tagName` node in an order-preserving node list. */
+var orderedChildren = function (nodes, tagName) {
+    if (!Array.isArray(nodes))
+        return undefined;
+    var found = nodes.find(function (node) { return node && node[tagName]; });
+    return found ? found[tagName] : undefined;
+};
+var 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. */
+var odsParagraphToTokens = function (children) {
+    var e_9, _a;
+    var _b;
+    var tokens = [];
+    try {
+        for (var _c = __values(children !== null && children !== void 0 ? children : []), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var child = _d.value;
+            if (!child || typeof child !== "object")
+                continue;
+            if (child["#text"] !== undefined) {
+                tokens.push({ type: "text", text: String(child["#text"]) });
+                continue;
+            }
+            var tag = Object.keys(child).find(function (key) { return key !== ":@"; });
+            if (!tag)
+                continue;
+            var attrs = child[":@"] || {};
+            if (tag === "text:s") {
+                var count = parseInt((_b = attrs["@_text:c"]) !== null && _b !== void 0 ? _b : "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;
+            }
+            var 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`).
+                var 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: field });
+                }
+                continue;
+            }
+            // `text:span`, `text:a`, … — descend.
+            tokens.push.apply(tokens, __spreadArray([], __read(odsParagraphToTokens(child[tag])), false));
+        }
+    }
+    catch (e_9_1) { e_9 = { error: e_9_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+        }
+        finally { if (e_9) throw e_9.error; }
+    }
+    return tokens;
+};
+var odsRegionToCode = function (children) {
+    if (!Array.isArray(children))
+        return undefined;
+    var paragraphs = children
+        .filter(function (node) { return node && (node["text:p"] || node["p"]); })
+        .map(function (node) {
+        return headerFooterZoneFromTokens(odsParagraphToTokens(node["text:p"] || node["p"]));
+    });
+    var 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.
+ */
+var odsHeaderFooterToCode = function (children) {
+    if (!Array.isArray(children))
+        return undefined;
+    var zones = {};
+    var left = odsRegionToCode(orderedChildren(children, "style:region-left") ||
+        orderedChildren(children, "region-left"));
+    var center = odsRegionToCode(orderedChildren(children, "style:region-center") ||
+        orderedChildren(children, "region-center"));
+    var right = odsRegionToCode(orderedChildren(children, "style:region-right") ||
+        orderedChildren(children, "region-right"));
+    var plain = odsRegionToCode(children);
+    if (left)
+        zones.left = left;
+    if (center || plain)
+        zones.center = center !== null && center !== void 0 ? center : plain;
+    if (right)
+        zones.right = right;
+    var code = joinHeaderFooterZones(zones);
+    return code ? code : undefined;
+};

package/dist/cjs/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/cjs/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"}