@rowsncolumns/toolkit 24.4.1 → 24.4.3

package/dist/cjs/exporter/ods/ods-export.js

@@ -4,6 +4,7 @@ import { CellXfsRegistry, deriveEffectiveNumberFormatFromFormula, } from "@rowsn
 import { cellRangeToAddress, cellToAddress, getCellEffectiveFormat, getCellEffectiveValue, getCellFormattedValue, getCellUserEnteredFormat, getCellUserEnteredValue, getExtendedValueBool, getExtendedValueError, getExtendedValueFormula, getExtendedValueNumber, getExtendedValueString, escapeCharacters, isNil, sortSheetsByIndex, addressToSelection, } from "@rowsncolumns/utils";
 import { defaultSpreadsheetTheme } from "../../excel-parser/theme-default";
 import { imageUrlToBase64 } from "../../helpers";
+import { buildOdsPrintTokens, DEFAULT_PAGE_MARGINS_IN, inchesToOdsCm, isHeaderFooterEmpty, odsTableCentering, paperSizeToCm, splitHeaderFooterZones, tokenizeHeaderFooterZone, } from "../../print-settings";
 import { omitInvalidDataValidationError } from "../invalid-data-validation";
 import { buildOdsSparklineGroupsXml } from "./sparkline-builder";
 var BLANK_LABEL = "(Blanks)";
@@ -116,6 +117,36 @@ var outlineGroupOpenTag = function (span, tag) {
 };
 var XML_DECLARATION = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>";
 var ODS_MIMETYPE = "application/vnd.oasis.opendocument.spreadsheet";
+/**
+ * Emit the wrappers that end at `rowIndex`: the header-rows band (when this
+ * is its last row) and any outline groups. A group may not close inside
+ * `<table:table-header-rows>`, so an open band is closed first — the caller
+ * re-opens it on the next band row. Returns the band's open state.
+ */
+var closeRowWrappers = function (chunks, rowIndex, closesAt, headerRowsCloseAt, headerRowsOpen) {
+    var e_4, _a;
+    var _b;
+    var open = headerRowsOpen;
+    var closes = (_b = closesAt.get(rowIndex)) !== null && _b !== void 0 ? _b : [];
+    if (open && (rowIndex === headerRowsCloseAt || closes.length)) {
+        chunks.push("</table:table-header-rows>");
+        open = false;
+    }
+    try {
+        for (var closes_1 = __values(closes), closes_1_1 = closes_1.next(); !closes_1_1.done; closes_1_1 = closes_1.next()) {
+            var _1 = closes_1_1.value;
+            chunks.push("</table:table-row-group>");
+        }
+    }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    finally {
+        try {
+            if (closes_1_1 && !closes_1_1.done && (_a = closes_1.return)) _a.call(closes_1);
+        }
+        finally { if (e_4) throw e_4.error; }
+    }
+    return open;
+};
 var CREATOR = "Rows n Columns";
 var PIXELS_PER_INCH = 96;
 var CM_PER_INCH = 2.54;
@@ -174,8 +205,11 @@ var OdsStyleBuilder = /** @class */ (function () {
         this.numberXmlChunks = [];
         // NEW: separate storage for conditional format styles (go to styles.xml)
         this.conditionalStyleXmlChunks = [];
+        this.pageLayoutXmlChunks = [];
+        this.masterPageXmlChunks = [];
         this.styleIndex = 1;
         this.numberIndex = 1;
+        this.pageLayoutIndex = 0;
     }
     OdsStyleBuilder.prototype.registerCell = function (format) {
         if (!format)
@@ -186,32 +220,75 @@ var OdsStyleBuilder = /** @class */ (function () {
             return existing;
         return this.registerCellWithName(format, key);
     };
-    OdsStyleBuilder.prototype.registerRow = function (heightPx, hidden) {
-        if (!heightPx && !hidden)
+    OdsStyleBuilder.prototype.registerRow = function (heightPx, hidden, breakBefore) {
+        if (breakBefore === void 0) { breakBefore = false; }
+        if (!heightPx && !hidden && !breakBefore)
             return undefined;
-        var key = stableStringify({ heightPx: heightPx, hidden: hidden });
+        var key = stableStringify({ heightPx: heightPx, hidden: hidden, breakBefore: breakBefore });
         var existing = this.rowStyles.get(key);
         if (existing)
             return existing;
         var styleName = "ro".concat(this.styleIndex++);
-        var styleXml = buildRowStyleXml(styleName, heightPx, hidden);
+        var styleXml = buildRowStyleXml(styleName, heightPx, hidden, breakBefore);
         this.rowStyles.set(key, styleName);
         this.styleXmlChunks.push(styleXml);
         return styleName;
     };
-    OdsStyleBuilder.prototype.registerColumn = function (widthPx, hidden) {
-        if (!widthPx && !hidden)
+    OdsStyleBuilder.prototype.registerColumn = function (widthPx, hidden, breakBefore) {
+        if (breakBefore === void 0) { breakBefore = false; }
+        if (!widthPx && !hidden && !breakBefore)
             return undefined;
-        var key = stableStringify({ widthPx: widthPx, hidden: hidden });
+        var key = stableStringify({ widthPx: widthPx, hidden: hidden, breakBefore: breakBefore });
         var existing = this.columnStyles.get(key);
         if (existing)
             return existing;
         var styleName = "co".concat(this.styleIndex++);
-        var styleXml = buildColumnStyleXml(styleName, widthPx, hidden);
+        var styleXml = buildColumnStyleXml(styleName, widthPx, hidden, breakBefore);
         this.columnStyles.set(key, styleName);
         this.styleXmlChunks.push(styleXml);
         return styleName;
     };
+    /**
+     * A sheet's print settings → a `table` automatic style (content.xml)
+     * pointing at a master page whose page layout + header/footer live in
+     * styles.xml. Returns the table style name, or undefined when the sheet
+     * has no page-level print settings to carry.
+     */
+    OdsStyleBuilder.prototype.registerTable = function (print, rightToLeft) {
+        var pageLayoutXml = buildOdsPageLayoutXml(print);
+        var headerFooter = print === null || print === void 0 ? void 0 : print.headerFooter;
+        var hasPrintSettings = !!pageLayoutXml || !isHeaderFooterEmpty(headerFooter);
+        // Right-to-left is the table style's `style:writing-mode="rl-tb"`, the
+        // ODF counterpart of `<sheetView rightToLeft="1">`. A sheet with only
+        // that flag shares one RTL style on the default master page.
+        var writingMode = rightToLeft ? "rl-tb" : "lr-tb";
+        if (!hasPrintSettings) {
+            if (!rightToLeft)
+                return undefined;
+            if (this.rtlTableStyleName)
+                return this.rtlTableStyleName;
+            var styleName = "ta".concat(this.styleIndex++);
+            this.rtlTableStyleName = styleName;
+            this.styleXmlChunks.push("<style:style style:name=\"".concat(styleName, "\" style:family=\"table\" style:master-page-name=\"Default\"><style:table-properties table:display=\"true\" style:writing-mode=\"").concat(writingMode, "\"/></style:style>"));
+            return styleName;
+        }
+        var index = ++this.pageLayoutIndex;
+        var layoutName = "Mpm".concat(index);
+        var masterName = "Mp".concat(index);
+        var tableStyleName = "ta".concat(this.styleIndex++);
+        this.pageLayoutXmlChunks.push("<style:page-layout style:name=\"".concat(layoutName, "\">").concat(pageLayoutXml !== null && pageLayoutXml !== void 0 ? pageLayoutXml : "<style:page-layout-properties/>", "</style:page-layout>"));
+        this.masterPageXmlChunks.push("<style:master-page style:name=\"".concat(masterName, "\" style:page-layout-name=\"").concat(layoutName, "\">").concat(buildOdsHeaderFooterXml("style:header", headerFooter === null || headerFooter === void 0 ? void 0 : headerFooter.oddHeader)).concat(buildOdsHeaderFooterXml("style:footer", headerFooter === null || headerFooter === void 0 ? void 0 : headerFooter.oddFooter), "</style:master-page>"));
+        this.styleXmlChunks.push("<style:style style:name=\"".concat(tableStyleName, "\" style:family=\"table\" style:master-page-name=\"").concat(masterName, "\"><style:table-properties table:display=\"true\" style:writing-mode=\"").concat(writingMode, "\"/></style:style>"));
+        return tableStyleName;
+    };
+    /** `<style:page-layout>` entries for styles.xml `<office:automatic-styles>`. */
+    OdsStyleBuilder.prototype.toPageLayoutStylesXml = function () {
+        return this.pageLayoutXmlChunks.join("");
+    };
+    /** `<style:master-page>` entries for styles.xml `<office:master-styles>`. */
+    OdsStyleBuilder.prototype.toMasterPagesXml = function () {
+        return this.masterPageXmlChunks.join("");
+    };
     OdsStyleBuilder.prototype.registerText = function (format) {
         if (!format || Object.keys(format).length === 0)
             return undefined;
@@ -322,8 +399,8 @@ var buildConditionalCellStyleXml = function (name, format, theme) {
     return "<style:style style:name=\"".concat(name, "\" style:family=\"table-cell\" style:parent-style-name=\"Default\"><style:table-cell-properties").concat(cellProps.length ? " " + cellProps.join(" ") : "", "/><style:text-properties").concat(textProps.length ? " " + textProps.join(" ") : "", "/></style:style>");
 };
 export var createODSFile = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var sortedSheets, styleBuilder, preparedTables, embedsBySheet, chartsBySheet, namedRangeNames, sheetNameById, dataValidationsById, mediaEntries, sheetXmlEntries, chartObjectIndex, _loop_1, sortedSheets_1, sortedSheets_1_1, sheet, e_4_1, validationEntries, contentValidationsXml, calculationSettingsXml, contentXml, stylesXml, metaXml, settingsXml, chartObjects, manifestXml, files, chartObjects_1, chartObjects_1_1, chartObject, mediaEntries_1, mediaEntries_1_1, entry, orderedEntries;
-    var e_4, _c, e_5, _d, e_6, _e;
+    var sortedSheets, styleBuilder, preparedTables, embedsBySheet, chartsBySheet, namedRangeNames, sheetNameById, dataValidationsById, mediaEntries, sheetXmlEntries, chartObjectIndex, _loop_1, sortedSheets_1, sortedSheets_1_1, sheet, e_5_1, validationEntries, contentValidationsXml, calculationSettingsXml, contentXml, stylesXml, metaXml, settingsXml, chartObjects, manifestXml, files, chartObjects_1, chartObjects_1_1, chartObject, mediaEntries_1, mediaEntries_1_1, entry, orderedEntries;
+    var e_5, _c, e_6, _d, e_7, _e;
     var _f, _g, _h, _j, _k, _l;
     var _conditionalFormats = _b.conditionalFormats, _dataValidations = _b.dataValidations, sheets = _b.sheets, sheetData = _b.sheetData, sourceSharedStrings = _b.sharedStrings, _m = _b.tables, _tables = _m === void 0 ? [] : _m, cellXfs = _b.cellXfs, _theme = _b.theme, _o = _b.embeds, embeds = _o === void 0 ? [] : _o, _p = _b.charts, charts = _p === void 0 ? [] : _p, _q = _b.namedRanges, namedRanges = _q === void 0 ? [] : _q, iterativeCalculationOptions = _b.iterativeCalculationOptions, ignoreFormulaPatterns = _b.ignoreFormulaPatterns, citations = _b.citations, locale = _b.locale;
     return __generator(this, function (_r) {
@@ -417,14 +494,14 @@ export var createODSFile = function (_a) { return __awaiter(void 0, [_a], void 0
                 return [3 /*break*/, 2];
             case 5: return [3 /*break*/, 8];
             case 6:
-                e_4_1 = _r.sent();
-                e_4 = { error: e_4_1 };
+                e_5_1 = _r.sent();
+                e_5 = { error: e_5_1 };
                 return [3 /*break*/, 8];
             case 7:
                 try {
                     if (sortedSheets_1_1 && !sortedSheets_1_1.done && (_c = sortedSheets_1.return)) _c.call(sortedSheets_1);
                 }
-                finally { if (e_4) throw e_4.error; }
+                finally { if (e_5) throw e_5.error; }
                 return [7 /*endfinally*/];
             case 8:
                 validationEntries = buildAllDataValidationEntries(_dataValidations !== null && _dataValidations !== void 0 ? _dataValidations : [], sheetNameById);
@@ -440,7 +517,7 @@ export var createODSFile = function (_a) { return __awaiter(void 0, [_a], void 0
                     automaticStylesXml: styleBuilder.toAutomaticStylesXml(),
                     calculationSettingsXml: calculationSettingsXml,
                 });
-                stylesXml = buildStylesXml(styleBuilder.toConditionalStylesXml());
+                stylesXml = buildStylesXml(styleBuilder.toConditionalStylesXml(), styleBuilder.toPageLayoutStylesXml(), styleBuilder.toMasterPagesXml());
                 metaXml = buildMetaXml();
                 settingsXml = buildSettingsXml(sortedSheets, _theme !== null && _theme !== void 0 ? _theme : defaultSpreadsheetTheme);
                 chartObjects = sheetXmlEntries.flatMap(function (entry) { return entry.chartObjects; });
@@ -460,12 +537,12 @@ export var createODSFile = function (_a) { return __awaiter(void 0, [_a], void 0
                         files["".concat(chartObject.folder, "/content.xml")] = encodeXml(chartObject.contentXml);
                     }
                 }
-                catch (e_5_1) { e_5 = { error: e_5_1 }; }
+                catch (e_6_1) { e_6 = { error: e_6_1 }; }
                 finally {
                     try {
                         if (chartObjects_1_1 && !chartObjects_1_1.done && (_d = chartObjects_1.return)) _d.call(chartObjects_1);
                     }
-                    finally { if (e_5) throw e_5.error; }
+                    finally { if (e_6) throw e_6.error; }
                 }
                 try {
                     for (mediaEntries_1 = __values(mediaEntries), mediaEntries_1_1 = mediaEntries_1.next(); !mediaEntries_1_1.done; mediaEntries_1_1 = mediaEntries_1.next()) {
@@ -473,12 +550,12 @@ export var createODSFile = function (_a) { return __awaiter(void 0, [_a], void 0
                         files[entry.path] = entry.data;
                     }
                 }
-                catch (e_6_1) { e_6 = { error: e_6_1 }; }
+                catch (e_7_1) { e_7 = { error: e_7_1 }; }
                 finally {
                     try {
                         if (mediaEntries_1_1 && !mediaEntries_1_1.done && (_e = mediaEntries_1.return)) _e.call(mediaEntries_1);
                     }
-                    finally { if (e_6) throw e_6.error; }
+                    finally { if (e_7) throw e_7.error; }
                 }
                 orderedEntries = __spreadArray([
                     { name: "mimetype", data: new TextEncoder().encode(ODS_MIMETYPE) }
@@ -495,12 +572,12 @@ var getRowsForSheet = function (sheetData, sheetId) {
     return ((_c = (_b = (_a = sheetData[sheetId]) !== null && _a !== void 0 ? _a : sheetData[String(sheetId)]) !== null && _b !== void 0 ? _b : sheetData[Number(sheetId)]) !== null && _c !== void 0 ? _c : []);
 };
 var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var bounds, rowMetadata, maxRows, rowXmlEntries, mergeState, annotationsMap, citations_1, citations_1_1, citation, rowIndex, colIndex, address, conditionalFormattingXml, rowDataMap, rowIndex, row, metadata, rowXml, rowValues, _c, _d, _e, colIndex, cell, maxRowIndex, summaryBelow, rowSpans, _f, rowOpensAt, rowClosesAt, rowXmlChunks, index, rowIndex, _g, _h, span, entry, repeat, nextRowIndex, lastInRepeat, _j, _k, _1, _l, _m, _2, embedFrames, _o, chartFramesResult, _p, shapesXml, columnsXml, sparklineXml, sheetXml;
-    var e_7, _q, e_8, _r, e_9, _s, e_10, _t, e_11, _u;
-    var _v, _w, _x, _y, _z, _0, _1;
+    var bounds, rowMetadata, print, rowBreakSet, titleRows, maxRows, rowXmlEntries, mergeState, annotationsMap, citations_1, citations_1_1, citation, rowIndex, colIndex, address, conditionalFormattingXml, rowDataMap, rowIndex, row, metadata, rowXml, rowValues, _c, _d, _e, colIndex, cell, maxRowIndex, summaryBelow, rowSpans, _f, rowOpensAt, rowClosesAt, rowXmlChunks, headerRowsOpenAt, headerRowsCloseAt, headerRowsOpen, index, rowIndex, opens, opens_1, opens_1_1, span, entry, repeat, nextRowIndex, lastInRepeat, embedFrames, _g, chartFramesResult, _h, shapesXml, columnsXml, sparklineXml, protectedAttr, tableStyleName, tableStyleAttr, printRanges, printRangesAttr, sheetXml;
+    var e_8, _j, e_9, _k, e_10, _l;
+    var _m, _o, _p, _q, _r, _s, _t, _u, _v, _w;
     var sheet = _b.sheet, sheetName = _b.sheetName, rows = _b.rows, sourceSharedStrings = _b.sourceSharedStrings, cellXfs = _b.cellXfs, styleBuilder = _b.styleBuilder, tables = _b.tables, conditionalFormats = _b.conditionalFormats, dataValidationsById = _b.dataValidationsById, embeds = _b.embeds, charts = _b.charts, mediaEntries = _b.mediaEntries, namedRangeNames = _b.namedRangeNames, sheetNameById = _b.sheetNameById, chartObjectIndex = _b.chartObjectIndex, ignoreFormulaPatterns = _b.ignoreFormulaPatterns, citations = _b.citations, sheetData = _b.sheetData, sheets = _b.sheets, locale = _b.locale;
-    return __generator(this, function (_3) {
-        switch (_3.label) {
+    return __generator(this, function (_x) {
+        switch (_x.label) {
             case 0:
                 bounds = {
                     minRow: Number.POSITIVE_INFINITY,
@@ -508,10 +585,18 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
                     minColumn: Number.POSITIVE_INFINITY,
                     maxColumn: 0,
                 };
-                rowMetadata = (_v = sheet.rowMetadata) !== null && _v !== void 0 ? _v : [];
-                maxRows = Math.max(rows.length, rowMetadata.length);
+                rowMetadata = (_m = sheet.rowMetadata) !== null && _m !== void 0 ? _m : [];
+                print = sheet.printSettings;
+                rowBreakSet = new Set(((_o = print === null || print === void 0 ? void 0 : print.rowBreaks) !== null && _o !== void 0 ? _o : []).filter(function (n) { return Number.isInteger(n) && n >= 1; }));
+                titleRows = ((_p = print === null || print === void 0 ? void 0 : print.printTitles) === null || _p === void 0 ? void 0 : _p.rowStart) != null && print.printTitles.rowEnd != null
+                    ? {
+                        start: Math.max(1, print.printTitles.rowStart),
+                        end: Math.max(print.printTitles.rowStart, print.printTitles.rowEnd),
+                    }
+                    : undefined;
+                maxRows = Math.max(rows.length, rowMetadata.length, rowBreakSet.size ? Math.max.apply(Math, __spreadArray([], __read(rowBreakSet), false)) + 2 : 0, titleRows ? titleRows.end + 1 : 0);
                 rowXmlEntries = [];
-                mergeState = buildMergeState((_w = sheet.merges) !== null && _w !== void 0 ? _w : []);
+                mergeState = buildMergeState((_q = sheet.merges) !== null && _q !== void 0 ? _q : []);
                 annotationsMap = new Map();
                 if (citations) {
                     try {
@@ -531,12 +616,12 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
                             }
                         }
                     }
-                    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+                    catch (e_8_1) { e_8 = { error: e_8_1 }; }
                     finally {
                         try {
-                            if (citations_1_1 && !citations_1_1.done && (_q = citations_1.return)) _q.call(citations_1);
+                            if (citations_1_1 && !citations_1_1.done && (_j = citations_1.return)) _j.call(citations_1);
                         }
-                        finally { if (e_7) throw e_7.error; }
+                        finally { if (e_8) throw e_8.error; }
                     }
                 }
                 conditionalFormattingXml = conditionalFormats.length
@@ -549,7 +634,7 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
                     : "";
                 rowDataMap = {};
                 rowIndex = 1;
-                _3.label = 1;
+                _x.label = 1;
             case 1:
                 if (!(rowIndex < maxRows)) return [3 /*break*/, 4];
                 row = rows[rowIndex];
@@ -558,6 +643,7 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         rowNumber: rowIndex,
                         row: row,
                         rowMetadata: metadata,
+                        breakBefore: rowBreakSet.has(rowIndex - 1),
                         sourceSharedStrings: sourceSharedStrings,
                         cellXfs: cellXfs,
                         styleBuilder: styleBuilder,
@@ -574,25 +660,25 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         locale: locale,
                     })];
             case 2:
-                rowXml = _3.sent();
+                rowXml = _x.sent();
                 rowXmlEntries.push(rowXml);
                 // Collect row data for sparkline detection
                 if (row === null || row === void 0 ? void 0 : row.values) {
                     rowValues = {};
                     try {
-                        for (_c = (e_8 = void 0, __values(Object.entries(row.values))), _d = _c.next(); !_d.done; _d = _c.next()) {
+                        for (_c = (e_9 = void 0, __values(Object.entries(row.values))), _d = _c.next(); !_d.done; _d = _c.next()) {
                             _e = __read(_d.value, 2), colIndex = _e[0], cell = _e[1];
                             if (cell) {
                                 rowValues[parseInt(colIndex, 10)] = cell;
                             }
                         }
                     }
-                    catch (e_8_1) { e_8 = { error: e_8_1 }; }
+                    catch (e_9_1) { e_9 = { error: e_9_1 }; }
                     finally {
                         try {
-                            if (_d && !_d.done && (_r = _c.return)) _r.call(_c);
+                            if (_d && !_d.done && (_k = _c.return)) _k.call(_c);
                         }
-                        finally { if (e_8) throw e_8.error; }
+                        finally { if (e_9) throw e_9.error; }
                     }
                     if (Object.keys(rowValues).length > 0) {
                         rowDataMap[rowIndex] = rowValues;
@@ -608,31 +694,47 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
                 }
                 bounds.minRow = Math.min(bounds.minRow, rowIndex);
                 bounds.maxRow = Math.max(bounds.maxRow, rowIndex);
-                _3.label = 3;
+                _x.label = 3;
             case 3:
                 rowIndex++;
                 return [3 /*break*/, 1];
             case 4:
                 updateBoundsForMerges(bounds, mergeState);
                 maxRowIndex = rowXmlEntries.length;
-                summaryBelow = ((_x = sheet.outlinePr) === null || _x === void 0 ? void 0 : _x.summaryBelow) !== false;
+                summaryBelow = ((_r = sheet.outlinePr) === null || _r === void 0 ? void 0 : _r.summaryBelow) !== false;
                 rowSpans = findOutlineGroupSpans(rowMetadata, maxRowIndex, summaryBelow);
                 _f = buildOutlineGroupIndex(rowSpans), rowOpensAt = _f.opensAt, rowClosesAt = _f.closesAt;
                 rowXmlChunks = [];
+                headerRowsOpenAt = titleRows === null || titleRows === void 0 ? void 0 : titleRows.start;
+                headerRowsCloseAt = titleRows === null || titleRows === void 0 ? void 0 : titleRows.end;
+                headerRowsOpen = false;
                 for (index = 0; index < rowXmlEntries.length; index++) {
                     rowIndex = index + 1;
+                    opens = (_s = rowOpensAt.get(rowIndex)) !== null && _s !== void 0 ? _s : [];
+                    if (opens.length && headerRowsOpen) {
+                        rowXmlChunks.push("</table:table-header-rows>");
+                        headerRowsOpen = false;
+                    }
                     try {
-                        for (_g = (e_9 = void 0, __values((_y = rowOpensAt.get(rowIndex)) !== null && _y !== void 0 ? _y : [])), _h = _g.next(); !_h.done; _h = _g.next()) {
-                            span = _h.value;
+                        for (opens_1 = (e_10 = void 0, __values(opens)), opens_1_1 = opens_1.next(); !opens_1_1.done; opens_1_1 = opens_1.next()) {
+                            span = opens_1_1.value;
                             rowXmlChunks.push(outlineGroupOpenTag(span, "table:table-row-group"));
                         }
                     }
-                    catch (e_9_1) { e_9 = { error: e_9_1 }; }
+                    catch (e_10_1) { e_10 = { error: e_10_1 }; }
                     finally {
                         try {
-                            if (_h && !_h.done && (_s = _g.return)) _s.call(_g);
+                            if (opens_1_1 && !opens_1_1.done && (_l = opens_1.return)) _l.call(opens_1);
                         }
-                        finally { if (e_9) throw e_9.error; }
+                        finally { if (e_10) throw e_10.error; }
+                    }
+                    if (!headerRowsOpen &&
+                        headerRowsOpenAt != null &&
+                        headerRowsCloseAt != null &&
+                        rowIndex >= headerRowsOpenAt &&
+                        rowIndex <= headerRowsCloseAt) {
+                        rowXmlChunks.push("<table:table-header-rows>");
+                        headerRowsOpen = true;
                     }
                     entry = rowXmlEntries[index];
                     if (entry) {
@@ -646,41 +748,21 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
                             if (rowOpensAt.has(nextRowIndex) || rowClosesAt.has(nextRowIndex - 1)) {
                                 break;
                             }
+                            if (nextRowIndex === headerRowsOpenAt ||
+                                nextRowIndex - 1 === headerRowsCloseAt) {
+                                break;
+                            }
                             repeat += 1;
                         }
                         rowXmlChunks.push(repeat > 1
                             ? "<table:table-row table:number-rows-repeated=\"".concat(repeat, "\"/>")
                             : "<table:table-row/>");
                         lastInRepeat = rowIndex + repeat - 1;
-                        try {
-                            for (_j = (e_10 = void 0, __values((_z = rowClosesAt.get(lastInRepeat)) !== null && _z !== void 0 ? _z : [])), _k = _j.next(); !_k.done; _k = _j.next()) {
-                                _1 = _k.value;
-                                rowXmlChunks.push("</table:table-row-group>");
-                            }
-                        }
-                        catch (e_10_1) { e_10 = { error: e_10_1 }; }
-                        finally {
-                            try {
-                                if (_k && !_k.done && (_t = _j.return)) _t.call(_j);
-                            }
-                            finally { if (e_10) throw e_10.error; }
-                        }
+                        headerRowsOpen = closeRowWrappers(rowXmlChunks, lastInRepeat, rowClosesAt, headerRowsCloseAt, headerRowsOpen);
                         index += repeat - 1;
                         continue;
                     }
-                    try {
-                        for (_l = (e_11 = void 0, __values((_0 = rowClosesAt.get(rowIndex)) !== null && _0 !== void 0 ? _0 : [])), _m = _l.next(); !_m.done; _m = _l.next()) {
-                            _2 = _m.value;
-                            rowXmlChunks.push("</table:table-row-group>");
-                        }
-                    }
-                    catch (e_11_1) { e_11 = { error: e_11_1 }; }
-                    finally {
-                        try {
-                            if (_m && !_m.done && (_u = _l.return)) _u.call(_l);
-                        }
-                        finally { if (e_11) throw e_11.error; }
-                    }
+                    headerRowsOpen = closeRowWrappers(rowXmlChunks, rowIndex, rowClosesAt, headerRowsCloseAt, headerRowsOpen);
                 }
                 if (!embeds.length) return [3 /*break*/, 6];
                 return [4 /*yield*/, buildEmbedFramesXml({
@@ -690,13 +772,13 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         sheet: sheet,
                     })];
             case 5:
-                _o = _3.sent();
+                _g = _x.sent();
                 return [3 /*break*/, 7];
             case 6:
-                _o = [];
-                _3.label = 7;
+                _g = [];
+                _x.label = 7;
             case 7:
-                embedFrames = _o;
+                embedFrames = _g;
                 if (!charts.length) return [3 /*break*/, 9];
                 return [4 /*yield*/, buildChartFramesXml({
                         charts: charts,
@@ -706,19 +788,32 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         startIndex: chartObjectIndex,
                     })];
             case 8:
-                _p = _3.sent();
+                _h = _x.sent();
                 return [3 /*break*/, 10];
             case 9:
-                _p = { frames: [], chartObjects: [], nextIndex: chartObjectIndex };
-                _3.label = 10;
+                _h = { frames: [], chartObjects: [], nextIndex: chartObjectIndex };
+                _x.label = 10;
             case 10:
-                chartFramesResult = _p;
+                chartFramesResult = _h;
                 shapesXml = embedFrames.length || chartFramesResult.frames.length
                     ? "<table:shapes>".concat(__spreadArray(__spreadArray([], __read(embedFrames), false), __read(chartFramesResult.frames), false).join(""), "</table:shapes>")
                     : "";
-                columnsXml = buildColumnsXml(sheet, styleBuilder, bounds);
-                sparklineXml = (_1 = buildOdsSparklineGroupsXml(sheet, sheetName, rowDataMap)) !== null && _1 !== void 0 ? _1 : "";
-                sheetXml = "<table:table table:name=\"".concat(escapeXml(sheetName), "\">").concat(shapesXml).concat(columnsXml).concat(rowXmlChunks.join("")).concat(conditionalFormattingXml).concat(sparklineXml, "</table:table>");
+                columnsXml = buildColumnsXml(sheet, styleBuilder, bounds, print);
+                sparklineXml = (_t = buildOdsSparklineGroupsXml(sheet, sheetName, rowDataMap)) !== null && _t !== void 0 ? _t : "";
+                protectedAttr = ((_u = sheet.sheetProtection) === null || _u === void 0 ? void 0 : _u.sheet)
+                    ? ' table:protected="true"'
+                    : "";
+                tableStyleName = styleBuilder.registerTable(print, (_v = sheet.rightToLeft) !== null && _v !== void 0 ? _v : undefined);
+                tableStyleAttr = tableStyleName
+                    ? " table:style-name=\"".concat(tableStyleName, "\"")
+                    : "";
+                printRanges = ((_w = print === null || print === void 0 ? void 0 : print.printArea) !== null && _w !== void 0 ? _w : [])
+                    .map(function (range) { return buildOdsRangeAddress(range, sheetName); })
+                    .filter(function (address) { return Boolean(address); });
+                printRangesAttr = printRanges.length
+                    ? " table:print-ranges=\"".concat(escapeXml(printRanges.join(" ")), "\"")
+                    : "";
+                sheetXml = "<table:table table:name=\"".concat(escapeXml(sheetName), "\"").concat(tableStyleAttr).concat(protectedAttr).concat(printRangesAttr, ">").concat(shapesXml).concat(columnsXml).concat(rowXmlChunks.join("")).concat(conditionalFormattingXml).concat(sparklineXml, "</table:table>");
                 return [2 /*return*/, {
                         xml: sheetXml,
                         databaseRanges: buildDatabaseRangeEntries(tables, sheetName, sheet, rows),
@@ -731,9 +826,9 @@ var buildWorksheetXml = function (_a) { return __awaiter(void 0, [_a], void 0, f
 var buildWorksheetRow = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var values, cellXmlChunks, minColumn, maxColumn, hasHiddenFlag, defaultRowHeightPx, rowSize, hasExplicitHeight, hasCustomHeight, rowStyle, maxColumnIndex, columnIndex, cell, mergeSpan, cellXml, hasCells, needsMetadata, attrs, rowXml;
     var _c, _d;
-    var rowNumber = _b.rowNumber, row = _b.row, rowMetadata = _b.rowMetadata, sourceSharedStrings = _b.sourceSharedStrings, cellXfs = _b.cellXfs, styleBuilder = _b.styleBuilder, mergeState = _b.mergeState, dataValidationsById = _b.dataValidationsById, mediaEntries = _b.mediaEntries, sheet = _b.sheet, namedRangeNames = _b.namedRangeNames, tables = _b.tables, ignoreFormulaPatterns = _b.ignoreFormulaPatterns, annotationsMap = _b.annotationsMap, sheetData = _b.sheetData, sheets = _b.sheets, locale = _b.locale;
-    return __generator(this, function (_e) {
-        switch (_e.label) {
+    var rowNumber = _b.rowNumber, row = _b.row, rowMetadata = _b.rowMetadata, _e = _b.breakBefore, breakBefore = _e === void 0 ? false : _e, sourceSharedStrings = _b.sourceSharedStrings, cellXfs = _b.cellXfs, styleBuilder = _b.styleBuilder, mergeState = _b.mergeState, dataValidationsById = _b.dataValidationsById, mediaEntries = _b.mediaEntries, sheet = _b.sheet, namedRangeNames = _b.namedRangeNames, tables = _b.tables, ignoreFormulaPatterns = _b.ignoreFormulaPatterns, annotationsMap = _b.annotationsMap, sheetData = _b.sheetData, sheets = _b.sheets, locale = _b.locale;
+    return __generator(this, function (_f) {
+        switch (_f.label) {
             case 0:
                 values = (_c = row === null || row === void 0 ? void 0 : row.values) !== null && _c !== void 0 ? _c : [];
                 cellXmlChunks = [];
@@ -744,10 +839,10 @@ var buildWorksheetRow = function (_a) { return __awaiter(void 0, [_a], void 0, f
                 rowSize = (rowMetadata === null || rowMetadata === void 0 ? void 0 : rowMetadata.size) && rowMetadata.size > 0 ? rowMetadata.size : undefined;
                 hasExplicitHeight = Boolean(rowSize && Math.abs(rowSize - defaultRowHeightPx) > 0.01);
                 hasCustomHeight = Boolean(rowSize && (rowMetadata === null || rowMetadata === void 0 ? void 0 : rowMetadata.resizedByUser));
-                rowStyle = styleBuilder.registerRow(rowSize && (hasExplicitHeight || hasCustomHeight) ? rowSize : undefined, hasHiddenFlag);
+                rowStyle = styleBuilder.registerRow(rowSize && (hasExplicitHeight || hasCustomHeight) ? rowSize : undefined, hasHiddenFlag, breakBefore);
                 maxColumnIndex = Math.max(values.length - 1, (_d = mergeState.maxColumnByRow.get(rowNumber)) !== null && _d !== void 0 ? _d : 0);
                 columnIndex = 1;
-                _e.label = 1;
+                _f.label = 1;
             case 1:
                 if (!(columnIndex <= maxColumnIndex)) return [3 /*break*/, 4];
                 if (mergeState.coveredCells.has("".concat(rowNumber, ":").concat(columnIndex))) {
@@ -776,7 +871,7 @@ var buildWorksheetRow = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         locale: locale,
                     })];
             case 2:
-                cellXml = _e.sent();
+                cellXml = _f.sent();
                 if (!cellXml) {
                     cellXmlChunks.push("<table:table-cell/>");
                     return [3 /*break*/, 3];
@@ -784,13 +879,13 @@ var buildWorksheetRow = function (_a) { return __awaiter(void 0, [_a], void 0, f
                 cellXmlChunks.push(cellXml);
                 minColumn = Math.min(minColumn, columnIndex);
                 maxColumn = Math.max(maxColumn, columnIndex);
-                _e.label = 3;
+                _f.label = 3;
             case 3:
                 columnIndex++;
                 return [3 /*break*/, 1];
             case 4:
                 hasCells = cellXmlChunks.length > 0;
-                needsMetadata = hasHiddenFlag || hasExplicitHeight || hasCustomHeight;
+                needsMetadata = hasHiddenFlag || hasExplicitHeight || hasCustomHeight || breakBefore;
                 if (!hasCells && !needsMetadata) {
                     return [2 /*return*/, null];
                 }
@@ -809,7 +904,7 @@ var buildWorksheetRow = function (_a) { return __awaiter(void 0, [_a], void 0, f
 }); };
 var buildCellXml = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var normalizedCell, userEnteredValue, effectiveValue, resolveStyleRef, effectiveFormat, formattedValue, richTextRuns, valueSource, numberValue, boolValue, rawFormulaValue, formulaValue, errorValue, stringValue, sharedStringIndex, sharedStringValue, isDateLike, hasExplicitValue, formatForExport, sheetIdByName_1, sheets_1, sheets_1_1, s, cellXfsRegistry, derived, cellStyle, address, validationRule, validationId, validationAttr, attrs, valueAttr, textNode, errorText, text, resolvedFormula, formulaAttr, arrayRef, spill, cols, rows, hyperlinkValue, href, display, imageXml, annotationXml, annotation, now;
-    var e_12, _c;
+    var e_11, _c;
     var _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
     var rowNumber = _b.rowNumber, columnIndex = _b.columnIndex, cell = _b.cell, sourceSharedStrings = _b.sourceSharedStrings, cellXfs = _b.cellXfs, styleBuilder = _b.styleBuilder, dataValidationsById = _b.dataValidationsById, mergeSpan = _b.mergeSpan, mediaEntries = _b.mediaEntries, sheet = _b.sheet, namedRangeNames = _b.namedRangeNames, tables = _b.tables, ignoreFormulaPatterns = _b.ignoreFormulaPatterns, annotationsMap = _b.annotationsMap, sheetData = _b.sheetData, sheets = _b.sheets, locale = _b.locale;
     return __generator(this, function (_p) {
@@ -887,12 +982,12 @@ var buildCellXml = function (_a) { return __awaiter(void 0, [_a], void 0, functi
                                 sheetIdByName_1.set(s.title, s.sheetId);
                         }
                     }
-                    catch (e_12_1) { e_12 = { error: e_12_1 }; }
+                    catch (e_11_1) { e_11 = { error: e_11_1 }; }
                     finally {
                         try {
                             if (sheets_1_1 && !sheets_1_1.done && (_c = sheets_1.return)) _c.call(sheets_1);
                         }
-                        finally { if (e_12) throw e_12.error; }
+                        finally { if (e_11) throw e_11.error; }
                     }
                     cellXfsRegistry = cellXfs ? new CellXfsRegistry(cellXfs) : undefined;
                     derived = (_k = deriveEffectiveNumberFormatFromFormula(formulaValue, sheet.sheetId, rowNumber, columnIndex, sheetData, function (input) { return defaultTokenizer(input); }, function (name) { var _a; return (_a = sheetIdByName_1.get(name)) !== null && _a !== void 0 ? _a : sheet.sheetId; }, locale, cellXfsRegistry, undefined, typeof numberValue === "number" ? numberValue : null)) !== null && _k !== void 0 ? _k : undefined;
@@ -1068,7 +1163,7 @@ var resolveStructuredReferencesForOds = function (formula, tables, rowNumber, co
     return result;
 };
 var resolveStructuredRefsInSegment = function (segment, tables, rowNumber, columnIndex) {
-    var e_13, _a, e_14, _b, e_15, _c, e_16, _d;
+    var e_12, _a, e_13, _b, e_14, _c, e_15, _d;
     var _e, _f;
     if (!segment)
         return segment;
@@ -1092,7 +1187,7 @@ var resolveStructuredRefsInSegment = function (segment, tables, rowNumber, colum
                 if (!escapedColumn)
                     continue;
                 try {
-                    for (var nameVariants_1 = (e_14 = void 0, __values(nameVariants)), nameVariants_1_1 = nameVariants_1.next(); !nameVariants_1_1.done; nameVariants_1_1 = nameVariants_1.next()) {
+                    for (var nameVariants_1 = (e_13 = void 0, __values(nameVariants)), nameVariants_1_1 = nameVariants_1.next(); !nameVariants_1_1.done; nameVariants_1_1 = nameVariants_1.next()) {
                         var tableName = nameVariants_1_1.value;
                         var escapedTable = escapeCharacters(tableName);
                         if (!escapedTable)
@@ -1103,26 +1198,26 @@ var resolveStructuredRefsInSegment = function (segment, tables, rowNumber, colum
                             "".concat(escapedTable, "\\[\\@").concat(escapedColumn, "\\]"),
                         ];
                         try {
-                            for (var patterns_1 = (e_15 = void 0, __values(patterns)), patterns_1_1 = patterns_1.next(); !patterns_1_1.done; patterns_1_1 = patterns_1.next()) {
+                            for (var patterns_1 = (e_14 = void 0, __values(patterns)), patterns_1_1 = patterns_1.next(); !patterns_1_1.done; patterns_1_1 = patterns_1.next()) {
                                 var pattern = patterns_1_1.value;
                                 normalized = normalized.replace(new RegExp(pattern, "g"), cellRef);
                             }
                         }
-                        catch (e_15_1) { e_15 = { error: e_15_1 }; }
+                        catch (e_14_1) { e_14 = { error: e_14_1 }; }
                         finally {
                             try {
                                 if (patterns_1_1 && !patterns_1_1.done && (_c = patterns_1.return)) _c.call(patterns_1);
                             }
-                            finally { if (e_15) throw e_15.error; }
+                            finally { if (e_14) throw e_14.error; }
                         }
                     }
                 }
-                catch (e_14_1) { e_14 = { error: e_14_1 }; }
+                catch (e_13_1) { e_13 = { error: e_13_1 }; }
                 finally {
                     try {
                         if (nameVariants_1_1 && !nameVariants_1_1.done && (_b = nameVariants_1.return)) _b.call(nameVariants_1);
                     }
-                    finally { if (e_14) throw e_14.error; }
+                    finally { if (e_13) throw e_13.error; }
                 }
                 if ((tableForCell === null || tableForCell === void 0 ? void 0 : tableForCell.id) !== table.id) {
                     continue;
@@ -1133,27 +1228,27 @@ var resolveStructuredRefsInSegment = function (segment, tables, rowNumber, colum
                     "\\[\\@".concat(escapedColumn, "\\]"),
                 ];
                 try {
-                    for (var unqualifiedPatterns_1 = (e_16 = void 0, __values(unqualifiedPatterns)), unqualifiedPatterns_1_1 = unqualifiedPatterns_1.next(); !unqualifiedPatterns_1_1.done; unqualifiedPatterns_1_1 = unqualifiedPatterns_1.next()) {
+                    for (var unqualifiedPatterns_1 = (e_15 = void 0, __values(unqualifiedPatterns)), unqualifiedPatterns_1_1 = unqualifiedPatterns_1.next(); !unqualifiedPatterns_1_1.done; unqualifiedPatterns_1_1 = unqualifiedPatterns_1.next()) {
                         var pattern = unqualifiedPatterns_1_1.value;
                         normalized = normalized.replace(new RegExp(pattern, "g"), cellRef);
                     }
                 }
-                catch (e_16_1) { e_16 = { error: e_16_1 }; }
+                catch (e_15_1) { e_15 = { error: e_15_1 }; }
                 finally {
                     try {
                         if (unqualifiedPatterns_1_1 && !unqualifiedPatterns_1_1.done && (_d = unqualifiedPatterns_1.return)) _d.call(unqualifiedPatterns_1);
                     }
-                    finally { if (e_16) throw e_16.error; }
+                    finally { if (e_15) throw e_15.error; }
                 }
             }
         }
     }
-    catch (e_13_1) { e_13 = { error: e_13_1 }; }
+    catch (e_12_1) { e_12 = { error: e_12_1 }; }
     finally {
         try {
             if (tables_1_1 && !tables_1_1.done && (_a = tables_1.return)) _a.call(tables_1);
         }
-        finally { if (e_13) throw e_13.error; }
+        finally { if (e_12) throw e_12.error; }
     }
     return normalized;
 };
@@ -1204,9 +1299,116 @@ var buildContentXml = function (_a) {
     var sheetsXml = _a.sheetsXml, databaseRangesXml = _a.databaseRangesXml, namedRangesXml = _a.namedRangesXml, contentValidationsXml = _a.contentValidationsXml, automaticStylesXml = _a.automaticStylesXml, calculationSettingsXml = _a.calculationSettingsXml;
     return "".concat(XML_DECLARATION, "<office:document-content xmlns:office=\"").concat(ODS_NS.office, "\" xmlns:style=\"").concat(ODS_NS.style, "\" xmlns:text=\"").concat(ODS_NS.text, "\" xmlns:table=\"").concat(ODS_NS.table, "\" xmlns:draw=\"").concat(ODS_NS.draw, "\" xmlns:fo=\"").concat(ODS_NS.fo, "\" xmlns:xlink=\"").concat(ODS_NS.xlink, "\" xmlns:svg=\"").concat(ODS_NS.svg, "\" xmlns:number=\"").concat(ODS_NS.number, "\" xmlns:of=\"").concat(ODS_NS.of, "\" xmlns:calcext=\"").concat(ODS_NS.calcext, "\" xmlns:dc=\"").concat(ODS_NS.dc, "\" office:version=\"1.2\"><office:scripts/><office:automatic-styles>").concat(automaticStylesXml, "</office:automatic-styles><office:body><office:spreadsheet>").concat(calculationSettingsXml).concat(contentValidationsXml).concat(sheetsXml).concat(namedRangesXml).concat(databaseRangesXml, "</office:spreadsheet></office:body></office:document-content>");
 };
-var buildStylesXml = function (conditionalStylesXml) {
+var buildStylesXml = function (conditionalStylesXml, pageLayoutsXml, masterPagesXml) {
     if (conditionalStylesXml === void 0) { conditionalStylesXml = ""; }
-    return "".concat(XML_DECLARATION, "<office:document-styles xmlns:office=\"").concat(ODS_NS.office, "\" xmlns:style=\"").concat(ODS_NS.style, "\" xmlns:text=\"").concat(ODS_NS.text, "\" xmlns:table=\"").concat(ODS_NS.table, "\" xmlns:draw=\"").concat(ODS_NS.draw, "\" xmlns:fo=\"").concat(ODS_NS.fo, "\" xmlns:xlink=\"").concat(ODS_NS.xlink, "\" xmlns:svg=\"").concat(ODS_NS.svg, "\" xmlns:number=\"").concat(ODS_NS.number, "\" office:version=\"1.2\"><office:styles><style:style style:name=\"Default\" style:family=\"table-cell\"><style:paragraph-properties fo:margin-left=\"0cm\" fo:margin-right=\"0cm\"/></style:style>").concat(conditionalStylesXml, "</office:styles><office:automatic-styles/><office:master-styles/></office:document-styles>");
+    if (pageLayoutsXml === void 0) { pageLayoutsXml = ""; }
+    if (masterPagesXml === void 0) { masterPagesXml = ""; }
+    var automaticStyles = pageLayoutsXml
+        ? "<office:automatic-styles>".concat(pageLayoutsXml, "</office:automatic-styles>")
+        : "<office:automatic-styles/>";
+    var masterStyles = masterPagesXml
+        ? "<office:master-styles>".concat(masterPagesXml, "</office:master-styles>")
+        : "<office:master-styles/>";
+    return "".concat(XML_DECLARATION, "<office:document-styles xmlns:office=\"").concat(ODS_NS.office, "\" xmlns:style=\"").concat(ODS_NS.style, "\" xmlns:text=\"").concat(ODS_NS.text, "\" xmlns:table=\"").concat(ODS_NS.table, "\" xmlns:draw=\"").concat(ODS_NS.draw, "\" xmlns:fo=\"").concat(ODS_NS.fo, "\" xmlns:xlink=\"").concat(ODS_NS.xlink, "\" xmlns:svg=\"").concat(ODS_NS.svg, "\" xmlns:number=\"").concat(ODS_NS.number, "\" xmlns:loext=\"urn:org:documentfoundation:names:experimental:office:xmlns:loext:1.0\" office:version=\"1.2\"><office:styles><style:style style:name=\"Default\" style:family=\"table-cell\"><style:paragraph-properties fo:margin-left=\"0cm\" fo:margin-right=\"0cm\"/></style:style>").concat(conditionalStylesXml, "</office:styles>").concat(automaticStyles).concat(masterStyles, "</office:document-styles>");
+};
+/**
+ * `<style:page-layout-properties>` (+ header/footer styles) for a sheet's
+ * page setup, margins and print options. ODF keeps the header INSIDE the
+ * top margin, so Excel's `header` (edge → header) becomes `fo:margin-top`
+ * and `top - header` the header's `fo:min-height`; footer likewise.
+ */
+var buildOdsPageLayoutXml = function (print) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var setup = print === null || print === void 0 ? void 0 : print.pageSetup;
+    var margins = print === null || print === void 0 ? void 0 : print.pageMargins;
+    var options = print === null || print === void 0 ? void 0 : print.printOptions;
+    if (!setup && !margins && !options)
+        return undefined;
+    var attrs = [];
+    var landscape = (setup === null || setup === void 0 ? void 0 : setup.orientation) === "landscape";
+    var paper = paperSizeToCm(setup === null || setup === void 0 ? void 0 : setup.paperSize);
+    if (paper) {
+        var width = landscape ? paper.height : paper.width;
+        var height = landscape ? paper.width : paper.height;
+        attrs.push("fo:page-width=\"".concat(width.toFixed(3), "cm\""), "fo:page-height=\"".concat(height.toFixed(3), "cm\""));
+    }
+    if (setup === null || setup === void 0 ? void 0 : setup.orientation) {
+        attrs.push("style:print-orientation=\"".concat(setup.orientation, "\""));
+    }
+    var left = (_a = margins === null || margins === void 0 ? void 0 : margins.left) !== null && _a !== void 0 ? _a : DEFAULT_PAGE_MARGINS_IN.left;
+    var right = (_b = margins === null || margins === void 0 ? void 0 : margins.right) !== null && _b !== void 0 ? _b : DEFAULT_PAGE_MARGINS_IN.right;
+    var top = (_c = margins === null || margins === void 0 ? void 0 : margins.top) !== null && _c !== void 0 ? _c : DEFAULT_PAGE_MARGINS_IN.top;
+    var bottom = (_d = margins === null || margins === void 0 ? void 0 : margins.bottom) !== null && _d !== void 0 ? _d : DEFAULT_PAGE_MARGINS_IN.bottom;
+    var header = Math.min((_e = margins === null || margins === void 0 ? void 0 : margins.header) !== null && _e !== void 0 ? _e : DEFAULT_PAGE_MARGINS_IN.header, top);
+    var footer = Math.min((_f = margins === null || margins === void 0 ? void 0 : margins.footer) !== null && _f !== void 0 ? _f : DEFAULT_PAGE_MARGINS_IN.footer, bottom);
+    attrs.push("fo:margin-top=\"".concat(inchesToOdsCm(header), "\""), "fo:margin-bottom=\"".concat(inchesToOdsCm(footer), "\""), "fo:margin-left=\"".concat(inchesToOdsCm(left), "\""), "fo:margin-right=\"".concat(inchesToOdsCm(right), "\""));
+    if (setup === null || setup === void 0 ? void 0 : setup.fitToPage) {
+        // LibreOffice's per-axis fit (`loext:scale-to-X/Y`); 0 = automatic.
+        attrs.push("loext:scale-to-X=\"".concat((_g = setup.fitToWidth) !== null && _g !== void 0 ? _g : 1, "\""), "loext:scale-to-Y=\"".concat((_h = setup.fitToHeight) !== null && _h !== void 0 ? _h : 1, "\""));
+    }
+    else if (typeof (setup === null || setup === void 0 ? void 0 : setup.scale) === "number" && setup.scale > 0) {
+        attrs.push("style:scale-to=\"".concat(setup.scale, "%\""));
+    }
+    var centering = odsTableCentering(options);
+    if (centering)
+        attrs.push("style:table-centering=\"".concat(centering, "\""));
+    attrs.push("style:print=\"".concat(buildOdsPrintTokens(options), "\""));
+    if ((setup === null || setup === void 0 ? void 0 : setup.pageOrder) === "overThenDown") {
+        attrs.push("style:print-page-order=\"ltr\"");
+    }
+    if (typeof (setup === null || setup === void 0 ? void 0 : setup.firstPageNumber) === "number" &&
+        setup.useFirstPageNumber !== false) {
+        attrs.push("style:first-page-number=\"".concat(setup.firstPageNumber, "\""));
+    }
+    var headerStyle = "<style:header-style><style:header-footer-properties fo:min-height=\"".concat(inchesToOdsCm(Math.max(0, top - header)), "\" fo:margin-bottom=\"0cm\"/></style:header-style>");
+    var footerStyle = "<style:footer-style><style:header-footer-properties fo:min-height=\"".concat(inchesToOdsCm(Math.max(0, bottom - footer)), "\" fo:margin-top=\"0cm\"/></style:footer-style>");
+    return "<style:page-layout-properties ".concat(attrs.join(" "), "/>").concat(headerStyle).concat(footerStyle);
+};
+var odsFieldXml = function (token) {
+    if (token.type === "text") {
+        return token.text
+            .split("\n")
+            .map(function (line) { return escapeXml(line); })
+            .join("<text:line-break/>");
+    }
+    switch (token.field) {
+        case "page":
+            return "<text:page-number>1</text:page-number>";
+        case "pages":
+            return "<text:page-count>1</text:page-count>";
+        case "date":
+            return "<text:date/>";
+        case "time":
+            return "<text:time/>";
+        case "sheet":
+            return "<text:sheet-name/>";
+        case "file":
+            return '<text:file-name text:display="name"/>';
+        case "path":
+            return '<text:file-name text:display="path"/>';
+        default:
+            return "";
+    }
+};
+var odsHeaderZoneXml = function (code) {
+    return code
+        ? "<text:p>".concat(tokenizeHeaderFooterZone(code).map(odsFieldXml).join(""), "</text:p>")
+        : "";
+};
+/**
+ * Excel header/footer code → `<style:header>` / `<style:footer>` with
+ * `&L` / `&C` / `&R` zones as ODF regions and field macros as `<text:*>`
+ * fields. Formatting codes have no ODF counterpart and are dropped; an
+ * absent code yields a hidden (`style:display="false"`) element.
+ */
+var buildOdsHeaderFooterXml = function (tag, code) {
+    if (!code)
+        return "<".concat(tag, " style:display=\"false\"/>");
+    var zones = splitHeaderFooterZones(code);
+    if (!zones.left && !zones.right) {
+        return "<".concat(tag, ">").concat(odsHeaderZoneXml(zones.center), "</").concat(tag, ">");
+    }
+    return "<".concat(tag, "><style:region-left>").concat(odsHeaderZoneXml(zones.left), "</style:region-left><style:region-center>").concat(odsHeaderZoneXml(zones.center), "</style:region-center><style:region-right>").concat(odsHeaderZoneXml(zones.right), "</style:region-right></").concat(tag, ">");
 };
 var buildMetaXml = function () {
     var now = new Date().toISOString();
@@ -1272,52 +1474,80 @@ var buildFreezeCell = function (rows, columns) {
     var row = Math.max(1, rows + 1);
     return "".concat(col).concat(row);
 };
-var buildColumnsXml = function (sheet, styleBuilder, bounds) {
-    var e_17, _a, e_18, _b;
-    var _c, _d, _e, _f;
+var buildColumnsXml = function (sheet, styleBuilder, bounds, print) {
+    var e_16, _a, e_17, _b;
+    var _c, _d, _e, _f, _g, _h;
     var metadata = (_c = sheet.columnMetadata) !== null && _c !== void 0 ? _c : [];
-    var maxColumns = Math.max(metadata.length - 1, bounds.maxColumn || 0);
+    var columnBreakSet = new Set(((_d = print === null || print === void 0 ? void 0 : print.columnBreaks) !== null && _d !== void 0 ? _d : []).filter(function (n) { return Number.isInteger(n) && n >= 1; }));
+    var titles = print === null || print === void 0 ? void 0 : print.printTitles;
+    var titleColumns = (titles === null || titles === void 0 ? void 0 : titles.columnStart) != null && titles.columnEnd != null
+        ? {
+            start: Math.max(1, titles.columnStart),
+            end: Math.max(titles.columnStart, titles.columnEnd),
+        }
+        : undefined;
+    var maxColumns = Math.max(metadata.length - 1, bounds.maxColumn || 0, columnBreakSet.size ? Math.max.apply(Math, __spreadArray([], __read(columnBreakSet), false)) + 1 : 0, (_e = titleColumns === null || titleColumns === void 0 ? void 0 : titleColumns.end) !== null && _e !== void 0 ? _e : 0);
     if (!maxColumns)
         return "";
-    var summaryRight = ((_d = sheet.outlinePr) === null || _d === void 0 ? void 0 : _d.summaryRight) !== false;
+    var summaryRight = ((_f = sheet.outlinePr) === null || _f === void 0 ? void 0 : _f.summaryRight) !== false;
     var spans = findOutlineGroupSpans(metadata, maxColumns, summaryRight);
-    var _g = buildOutlineGroupIndex(spans), opensAt = _g.opensAt, closesAt = _g.closesAt;
+    var _j = buildOutlineGroupIndex(spans), opensAt = _j.opensAt, closesAt = _j.closesAt;
     var parts = [];
+    // Same rule as the row band: `<table:table-header-columns>` holds plain
+    // columns only, so it closes around a column-group edge and re-opens.
+    var headerColumnsOpen = false;
     for (var index = 1; index <= maxColumns; index++) {
+        var opens = (_g = opensAt.get(index)) !== null && _g !== void 0 ? _g : [];
+        if (opens.length && headerColumnsOpen) {
+            parts.push("</table:table-header-columns>");
+            headerColumnsOpen = false;
+        }
         try {
-            for (var _h = (e_17 = void 0, __values((_e = opensAt.get(index)) !== null && _e !== void 0 ? _e : [])), _j = _h.next(); !_j.done; _j = _h.next()) {
-                var span = _j.value;
+            for (var opens_2 = (e_16 = void 0, __values(opens)), opens_2_1 = opens_2.next(); !opens_2_1.done; opens_2_1 = opens_2.next()) {
+                var span = opens_2_1.value;
                 parts.push(outlineGroupOpenTag(span, "table:table-column-group"));
             }
         }
-        catch (e_17_1) { e_17 = { error: e_17_1 }; }
+        catch (e_16_1) { e_16 = { error: e_16_1 }; }
         finally {
             try {
-                if (_j && !_j.done && (_a = _h.return)) _a.call(_h);
+                if (opens_2_1 && !opens_2_1.done && (_a = opens_2.return)) _a.call(opens_2);
             }
-            finally { if (e_17) throw e_17.error; }
+            finally { if (e_16) throw e_16.error; }
+        }
+        if (!headerColumnsOpen &&
+            titleColumns &&
+            index >= titleColumns.start &&
+            index <= titleColumns.end) {
+            parts.push("<table:table-header-columns>");
+            headerColumnsOpen = true;
         }
         var props = metadata[index];
         var widthPx = getColumnWidthPx(sheet, index);
         var hidden = Boolean((props === null || props === void 0 ? void 0 : props.hiddenByUser) || (props === null || props === void 0 ? void 0 : props.hiddenByFilter));
-        var styleName = styleBuilder.registerColumn(widthPx, hidden);
+        var styleName = styleBuilder.registerColumn(widthPx, hidden, columnBreakSet.has(index - 1));
         var attrs = [];
         if (styleName) {
             attrs.push("table:style-name=\"".concat(styleName, "\""));
         }
         parts.push("<table:table-column".concat(attrs.length ? " " + attrs.join(" ") : "", "/>"));
+        var closes = (_h = closesAt.get(index)) !== null && _h !== void 0 ? _h : [];
+        if (headerColumnsOpen && (index === (titleColumns === null || titleColumns === void 0 ? void 0 : titleColumns.end) || closes.length)) {
+            parts.push("</table:table-header-columns>");
+            headerColumnsOpen = false;
+        }
         try {
-            for (var _k = (e_18 = void 0, __values((_f = closesAt.get(index)) !== null && _f !== void 0 ? _f : [])), _l = _k.next(); !_l.done; _l = _k.next()) {
-                var _3 = _l.value;
+            for (var closes_2 = (e_17 = void 0, __values(closes)), closes_2_1 = closes_2.next(); !closes_2_1.done; closes_2_1 = closes_2.next()) {
+                var _2 = closes_2_1.value;
                 parts.push("</table:table-column-group>");
             }
         }
-        catch (e_18_1) { e_18 = { error: e_18_1 }; }
+        catch (e_17_1) { e_17 = { error: e_17_1 }; }
         finally {
             try {
-                if (_l && !_l.done && (_b = _k.return)) _b.call(_k);
+                if (closes_2_1 && !closes_2_1.done && (_b = closes_2.return)) _b.call(closes_2);
             }
-            finally { if (e_18) throw e_18.error; }
+            finally { if (e_17) throw e_17.error; }
         }
     }
     return parts.join("");
@@ -1452,7 +1682,7 @@ var buildTextStyleXml = function (name, textFormat, theme) {
     return "<style:style style:name=\"".concat(name, "\" style:family=\"text\"><style:text-properties").concat(textProps.length ? " " + textProps.join(" ") : "", "/></style:style>");
 };
 var buildRichTextParagraph = function (text, runs, styleBuilder) {
-    var e_19, _a;
+    var e_18, _a;
     if (!(runs === null || runs === void 0 ? void 0 : runs.length)) {
         return "<text:p>".concat(escapeXml(String(text)), "</text:p>");
     }
@@ -1479,19 +1709,20 @@ var buildRichTextParagraph = function (text, runs, styleBuilder) {
             cursor = endIndex;
         }
     }
-    catch (e_19_1) { e_19 = { error: e_19_1 }; }
+    catch (e_18_1) { e_18 = { error: e_18_1 }; }
     finally {
         try {
             if (sortedRuns_1_1 && !sortedRuns_1_1.done && (_a = sortedRuns_1.return)) _a.call(sortedRuns_1);
         }
-        finally { if (e_19) throw e_19.error; }
+        finally { if (e_18) throw e_18.error; }
     }
     if (cursor < text.length) {
         parts.push(escapeXml(text.slice(cursor)));
     }
     return "<text:p>".concat(parts.join(""), "</text:p>");
 };
-var buildRowStyleXml = function (name, heightPx, hidden) {
+var buildRowStyleXml = function (name, heightPx, hidden, breakBefore) {
+    if (breakBefore === void 0) { breakBefore = false; }
     var props = [];
     if (heightPx) {
         props.push("style:row-height=\"".concat(pxToCm(heightPx).toFixed(2), "cm\""));
@@ -1499,9 +1730,13 @@ var buildRowStyleXml = function (name, heightPx, hidden) {
     if (hidden) {
         props.push("style:visibility=\"collapse\"");
     }
+    if (breakBefore) {
+        props.push("fo:break-before=\"page\"");
+    }
     return "<style:style style:name=\"".concat(name, "\" style:family=\"table-row\"><style:table-row-properties").concat(props.length ? " " + props.join(" ") : "", "/></style:style>");
 };
-var buildColumnStyleXml = function (name, widthPx, hidden) {
+var buildColumnStyleXml = function (name, widthPx, hidden, breakBefore) {
+    if (breakBefore === void 0) { breakBefore = false; }
     var props = [];
     if (widthPx) {
         props.push("style:column-width=\"".concat(pxToCm(widthPx).toFixed(2), "cm\""));
@@ -1509,6 +1744,9 @@ var buildColumnStyleXml = function (name, widthPx, hidden) {
     if (hidden) {
         props.push("style:visibility=\"collapse\"");
     }
+    if (breakBefore) {
+        props.push("fo:break-before=\"page\"");
+    }
     return "<style:style style:name=\"".concat(name, "\" style:family=\"table-column\"><style:table-column-properties").concat(props.length ? " " + props.join(" ") : "", "/></style:style>");
 };
 var buildNumberStyleXml = function (name, format) {
@@ -1574,7 +1812,7 @@ var buildAllDataValidationEntries = function (rules, sheetNameById) {
     return entries;
 };
 var buildConditionalFormattingXml = function (_a) {
-    var e_20, _b;
+    var e_19, _b;
     var _c, _d, _e, _f, _g, _h, _j, _k;
     var conditionalFormats = _a.conditionalFormats, sheetName = _a.sheetName, styleBuilder = _a.styleBuilder, namedRangeNames = _a.namedRangeNames;
     var entries = [];
@@ -2016,12 +2254,12 @@ var buildConditionalFormattingXml = function (_a) {
             _loop_2(rule);
         }
     }
-    catch (e_20_1) { e_20 = { error: e_20_1 }; }
+    catch (e_19_1) { e_19 = { error: e_19_1 }; }
     finally {
         try {
             if (orderedRules_1_1 && !orderedRules_1_1.done && (_b = orderedRules_1.return)) _b.call(orderedRules_1);
         }
-        finally { if (e_20) throw e_20.error; }
+        finally { if (e_19) throw e_19.error; }
     }
     if (!entries.length)
         return "";
@@ -2048,7 +2286,7 @@ var getFilterVisibleValues = function (spec, range, rows, headerRow, totalRow) {
     return __spreadArray([], __read(values), false);
 };
 var buildDatabaseRangeEntries = function (tables, sheetName, sheet, rows) {
-    var e_21, _a;
+    var e_20, _a;
     var _b, _c, _d, _e, _f, _g, _h, _j, _k;
     var entries = [];
     var basicFilter = sheet.basicFilter;
@@ -2079,12 +2317,12 @@ var buildDatabaseRangeEntries = function (tables, sheetName, sheet, rows) {
             entries.push("<table:database-range ".concat(attrs.join(" "), ">").concat(filterXml).concat(sortXml, "</table:database-range>"));
         }
     }
-    catch (e_21_1) { e_21 = { error: e_21_1 }; }
+    catch (e_20_1) { e_20 = { error: e_20_1 }; }
     finally {
         try {
             if (tables_2_1 && !tables_2_1.done && (_a = tables_2.return)) _a.call(tables_2);
         }
-        finally { if (e_21) throw e_21.error; }
+        finally { if (e_20) throw e_20.error; }
     }
     if (basicFilter &&
         !tables.some(function (table) { return rangesEqual(table.range, basicFilter.range); })) {
@@ -2104,7 +2342,7 @@ var buildDatabaseRangesXml = function (entries) {
     return "<table:database-ranges>".concat(entries.join(""), "</table:database-ranges>");
 };
 var buildNamedRangesXml = function (namedRanges, sheetNameById, namedRangeNames) {
-    var e_22, _a;
+    var e_21, _a;
     var _b;
     if (!(namedRanges === null || namedRanges === void 0 ? void 0 : namedRanges.length))
         return "";
@@ -2141,19 +2379,19 @@ var buildNamedRangesXml = function (namedRanges, sheetNameById, namedRangeNames)
             }
         }
     }
-    catch (e_22_1) { e_22 = { error: e_22_1 }; }
+    catch (e_21_1) { e_21 = { error: e_21_1 }; }
     finally {
         try {
             if (namedRanges_1_1 && !namedRanges_1_1.done && (_a = namedRanges_1.return)) _a.call(namedRanges_1);
         }
-        finally { if (e_22) throw e_22.error; }
+        finally { if (e_21) throw e_21.error; }
     }
     if (!ranges.length && !expressions.length)
         return "";
     return "<table:named-expressions>".concat(ranges.join("")).concat(expressions.join(""), "</table:named-expressions>");
 };
 var buildFilterXml = function (filterSpecs, range, rows, headerRow, totalRow) {
-    var e_23, _a, e_24, _b, e_25, _c;
+    var e_22, _a, e_23, _b, e_24, _c;
     var _d, _e, _f;
     if (headerRow === void 0) { headerRow = true; }
     if (totalRow === void 0) { totalRow = false; }
@@ -2188,39 +2426,39 @@ var buildFilterXml = function (filterSpecs, range, rows, headerRow, totalRow) {
             var visibleValues = (_e = criteria === null || criteria === void 0 ? void 0 : criteria.visibleValues) !== null && _e !== void 0 ? _e : getFilterVisibleValues(spec, range, rows, headerRow, totalRow);
             var hiddenValues = (_f = criteria === null || criteria === void 0 ? void 0 : criteria.hiddenValues) !== null && _f !== void 0 ? _f : [];
             try {
-                for (var visibleValues_1 = (e_24 = void 0, __values(visibleValues)), visibleValues_1_1 = visibleValues_1.next(); !visibleValues_1_1.done; visibleValues_1_1 = visibleValues_1.next()) {
+                for (var visibleValues_1 = (e_23 = void 0, __values(visibleValues)), visibleValues_1_1 = visibleValues_1.next(); !visibleValues_1_1.done; visibleValues_1_1 = visibleValues_1.next()) {
                     var value = visibleValues_1_1.value;
                     conditions.push("<table:filter-condition table:field-number=\"".concat(spec.columnIndex, "\" table:operator=\"=\" table:value=\"").concat(escapeXml(value), "\"/>"));
                 }
             }
-            catch (e_24_1) { e_24 = { error: e_24_1 }; }
+            catch (e_23_1) { e_23 = { error: e_23_1 }; }
             finally {
                 try {
                     if (visibleValues_1_1 && !visibleValues_1_1.done && (_b = visibleValues_1.return)) _b.call(visibleValues_1);
                 }
-                finally { if (e_24) throw e_24.error; }
+                finally { if (e_23) throw e_23.error; }
             }
             try {
-                for (var hiddenValues_1 = (e_25 = void 0, __values(hiddenValues)), hiddenValues_1_1 = hiddenValues_1.next(); !hiddenValues_1_1.done; hiddenValues_1_1 = hiddenValues_1.next()) {
+                for (var hiddenValues_1 = (e_24 = void 0, __values(hiddenValues)), hiddenValues_1_1 = hiddenValues_1.next(); !hiddenValues_1_1.done; hiddenValues_1_1 = hiddenValues_1.next()) {
                     var value = hiddenValues_1_1.value;
                     conditions.push("<table:filter-condition table:field-number=\"".concat(spec.columnIndex, "\" table:operator=\"!=\" table:value=\"").concat(escapeXml(value), "\"/>"));
                 }
             }
-            catch (e_25_1) { e_25 = { error: e_25_1 }; }
+            catch (e_24_1) { e_24 = { error: e_24_1 }; }
             finally {
                 try {
                     if (hiddenValues_1_1 && !hiddenValues_1_1.done && (_c = hiddenValues_1.return)) _c.call(hiddenValues_1);
                 }
-                finally { if (e_25) throw e_25.error; }
+                finally { if (e_24) throw e_24.error; }
             }
         }
     }
-    catch (e_23_1) { e_23 = { error: e_23_1 }; }
+    catch (e_22_1) { e_22 = { error: e_22_1 }; }
     finally {
         try {
             if (filterSpecs_1_1 && !filterSpecs_1_1.done && (_a = filterSpecs_1.return)) _a.call(filterSpecs_1);
         }
-        finally { if (e_23) throw e_23.error; }
+        finally { if (e_22) throw e_22.error; }
     }
     if (!conditions.length)
         return "";
@@ -2300,7 +2538,7 @@ var resolveCellDataValidation = function (cell, map) {
     return raw;
 };
 var buildMergeState = function (ranges) {
-    var e_26, _a;
+    var e_25, _a;
     var _b;
     var normalized = normalizeMergeRanges(ranges);
     var anchorSpans = new Map();
@@ -2327,17 +2565,17 @@ var buildMergeState = function (ranges) {
             }
         }
     }
-    catch (e_26_1) { e_26 = { error: e_26_1 }; }
+    catch (e_25_1) { e_25 = { error: e_25_1 }; }
     finally {
         try {
             if (normalized_1_1 && !normalized_1_1.done && (_a = normalized_1.return)) _a.call(normalized_1);
         }
-        finally { if (e_26) throw e_26.error; }
+        finally { if (e_25) throw e_25.error; }
     }
     return { anchorSpans: anchorSpans, coveredCells: coveredCells, maxColumnByRow: maxColumnByRow, ranges: normalized };
 };
 var updateBoundsForMerges = function (bounds, state) {
-    var e_27, _a;
+    var e_26, _a;
     try {
         for (var _b = __values(state.ranges), _c = _b.next(); !_c.done; _c = _b.next()) {
             var range = _c.value;
@@ -2347,12 +2585,12 @@ var updateBoundsForMerges = function (bounds, state) {
             bounds.maxColumn = Math.max(bounds.maxColumn, range.endColumnIndex);
         }
     }
-    catch (e_27_1) { e_27 = { error: e_27_1 }; }
+    catch (e_26_1) { e_26 = { error: e_26_1 }; }
     finally {
         try {
             if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
         }
-        finally { if (e_27) throw e_27.error; }
+        finally { if (e_26) throw e_26.error; }
     }
 };
 var sanitizeMergeRange = function (range) {
@@ -2385,7 +2623,7 @@ var sanitizeIndex = function (value) {
     return Math.max(1, Math.floor(value));
 };
 var normalizeMergeRanges = function (ranges) {
-    var e_28, _a;
+    var e_27, _a;
     if (!(ranges === null || ranges === void 0 ? void 0 : ranges.length))
         return [];
     var sanitized = ranges
@@ -2427,12 +2665,12 @@ var normalizeMergeRanges = function (ranges) {
             _loop_3(merge);
         }
     }
-    catch (e_28_1) { e_28 = { error: e_28_1 }; }
+    catch (e_27_1) { e_27 = { error: e_27_1 }; }
     finally {
         try {
             if (sorted_1_1 && !sorted_1_1.done && (_a = sorted_1.return)) _a.call(sorted_1);
         }
-        finally { if (e_28) throw e_28.error; }
+        finally { if (e_27) throw e_27.error; }
     }
     return valid;
 };
@@ -2682,7 +2920,7 @@ var mapVerticalAlignment = function (value) {
     return value !== null && value !== void 0 ? value : "bottom";
 };
 var buildZipStore = function (entries) {
-    var e_29, _a, e_30, _b;
+    var e_28, _a, e_29, _b;
     var normalized = entries.map(function (entry) {
         var nameBytes = textEncoder.encode(entry.name);
         var data = entry.data;
@@ -2725,12 +2963,12 @@ var buildZipStore = function (entries) {
             cursor += entry.data.length;
         }
     }
-    catch (e_29_1) { e_29 = { error: e_29_1 }; }
+    catch (e_28_1) { e_28 = { error: e_28_1 }; }
     finally {
         try {
             if (normalized_2_1 && !normalized_2_1.done && (_a = normalized_2.return)) _a.call(normalized_2);
         }
-        finally { if (e_29) throw e_29.error; }
+        finally { if (e_28) throw e_28.error; }
     }
     var centralOffset = cursor;
     try {
@@ -2757,12 +2995,12 @@ var buildZipStore = function (entries) {
             cursor += entry.nameBytes.length;
         }
     }
-    catch (e_30_1) { e_30 = { error: e_30_1 }; }
+    catch (e_29_1) { e_29 = { error: e_29_1 }; }
     finally {
         try {
             if (normalized_3_1 && !normalized_3_1.done && (_b = normalized_3.return)) _b.call(normalized_3);
         }
-        finally { if (e_30) throw e_30.error; }
+        finally { if (e_29) throw e_29.error; }
     }
     var centralSize = cursor - centralOffset;
     cursor = writeUint32(view, cursor, 0x06054b50);
@@ -2963,7 +3201,7 @@ var formatOdsSheetName = function (sheet) {
     return normalized;
 };
 var groupEmbedsBySheet = function (embeds) {
-    var e_31, _a;
+    var e_30, _a;
     var _b, _c, _d, _e, _f, _g, _h;
     var result = new Map();
     try {
@@ -2989,17 +3227,17 @@ var groupEmbedsBySheet = function (embeds) {
             result.set(embed.position.sheetId, list);
         }
     }
-    catch (e_31_1) { e_31 = { error: e_31_1 }; }
+    catch (e_30_1) { e_30 = { error: e_30_1 }; }
     finally {
         try {
             if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
         }
-        finally { if (e_31) throw e_31.error; }
+        finally { if (e_30) throw e_30.error; }
     }
     return result;
 };
 var groupChartsBySheet = function (charts) {
-    var e_32, _a;
+    var e_31, _a;
     var _b, _c, _d, _e, _f, _g;
     var result = new Map();
     try {
@@ -3022,18 +3260,18 @@ var groupChartsBySheet = function (charts) {
             result.set(chart.position.sheetId, list);
         }
     }
-    catch (e_32_1) { e_32 = { error: e_32_1 }; }
+    catch (e_31_1) { e_31 = { error: e_31_1 }; }
     finally {
         try {
             if (_j && !_j.done && (_a = _h.return)) _a.call(_h);
         }
-        finally { if (e_32) throw e_32.error; }
+        finally { if (e_31) throw e_31.error; }
     }
     return result;
 };
 var buildEmbedFramesXml = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var frames, embeds_1, embeds_1_1, placement, dataUrl, buffer, mediaPath, widthPx, heightPx, offsetXPx, offsetYPx, width, height, origin_1, offsetX, offsetY, anchorRef, anchorCell, anchorAttr, endColumn, endRow, endRef, endCell, endCellAttr, endX, endY, e_33_1;
-    var e_33, _c;
+    var frames, embeds_1, embeds_1_1, placement, dataUrl, buffer, mediaPath, widthPx, heightPx, offsetXPx, offsetYPx, width, height, origin_1, offsetX, offsetY, anchorRef, anchorCell, anchorAttr, endColumn, endRow, endRef, endCell, endCellAttr, endX, endY, e_32_1;
+    var e_32, _c;
     var _d, _e, _f, _g;
     var embeds = _b.embeds, mediaEntries = _b.mediaEntries, sheetName = _b.sheetName, sheet = _b.sheet;
     return __generator(this, function (_h) {
@@ -3110,14 +3348,14 @@ var buildEmbedFramesXml = function (_a) { return __awaiter(void 0, [_a], void 0,
                 return [3 /*break*/, 2];
             case 5: return [3 /*break*/, 8];
             case 6:
-                e_33_1 = _h.sent();
-                e_33 = { error: e_33_1 };
+                e_32_1 = _h.sent();
+                e_32 = { error: e_32_1 };
                 return [3 /*break*/, 8];
             case 7:
                 try {
                     if (embeds_1_1 && !embeds_1_1.done && (_c = embeds_1.return)) _c.call(embeds_1);
                 }
-                finally { if (e_33) throw e_33.error; }
+                finally { if (e_32) throw e_32.error; }
                 return [7 /*endfinally*/];
             case 8: return [2 /*return*/, frames];
         }
@@ -3200,7 +3438,7 @@ var resolveAnchorEndpoint = function (_a) {
     return { index: index, offset: offset };
 };
 var buildChartObjectXml = function (chart, sheetNameById) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     var spec = chart.spec;
     var series = (_a = spec === null || spec === void 0 ? void 0 : spec.series) !== null && _a !== void 0 ? _a : [];
     if (!series.length)
@@ -3225,7 +3463,26 @@ var buildChartObjectXml = function (chart, sheetNameById) {
         scatter: "chart:scatter",
         area: "chart:area",
     };
-    var chartClass = (_e = typeMap[spec.chartType]) !== null && _e !== void 0 ? _e : "chart:bar";
+    // 3-D / surface classes degrade to a 2-D `chartType` with the authored
+    // class kept as `sourceChartType` (BAR_3D, LINE_3D, PIE_3D, AREA_3D,
+    // SURFACE, SURFACE_3D). ODF expresses the same thing as
+    // `chart:three-dimensional="true"` on the plot-area style (plus the
+    // `chart:surface` class for surfaces), so the flag round-trips.
+    var sourceChartType = String((_e = spec.sourceChartType) !== null && _e !== void 0 ? _e : "").toUpperCase();
+    var isSurface = sourceChartType === "SURFACE" || sourceChartType === "SURFACE_3D";
+    // A plain SURFACE is Excel's contour (top-down) view, so only SURFACE_3D
+    // carries the three-dimensional flag.
+    var threeDimensional = sourceChartType === "SURFACE_3D" ||
+        sourceChartType === "BAR_3D" ||
+        sourceChartType === "LINE_3D" ||
+        sourceChartType === "PIE_3D" ||
+        sourceChartType === "AREA_3D";
+    var chartClass = isSurface
+        ? "chart:surface"
+        : ((_f = typeMap[spec.chartType]) !== null && _f !== void 0 ? _f : "chart:bar");
+    var plotStyleProps = threeDimensional
+        ? "<style:chart-properties chart:three-dimensional=\"true\"/>"
+        : "";
     var title = spec.title
         ? "<chart:title><text:p>".concat(escapeXml(String(spec.title)), "</text:p></chart:title>")
         : "";
@@ -3310,7 +3567,7 @@ var buildChartObjectXml = function (chart, sheetNameById) {
     var legendXml = chartClass === "chart:circle"
         ? ""
         : "<chart:legend chart:legend-position=\"end\" chart:legend-align=\"center\" chart:style-name=\"legend1\"/>";
-    return "".concat(XML_DECLARATION, "<office:document-content xmlns:office=\"").concat(ODS_NS.office, "\" xmlns:chart=\"").concat(ODS_NS.chart, "\" xmlns:table=\"").concat(ODS_NS.table, "\" xmlns:text=\"").concat(ODS_NS.text, "\" xmlns:style=\"").concat(ODS_NS.style, "\" xmlns:draw=\"").concat(ODS_NS.draw, "\" xmlns:svg=\"").concat(ODS_NS.svg, "\" xmlns:fo=\"").concat(ODS_NS.fo, "\" office:version=\"1.2\"><office:automatic-styles>").concat(gradientDefsXml, "<style:style style:name=\"ch1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\"/></style:style><style:style style:name=\"plot1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\" svg:stroke-color=\"#b3b3b3\"/></style:style><style:style style:name=\"wall1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\" svg:stroke-color=\"#b3b3b3\" svg:stroke-width=\"0.01cm\"/></style:style><style:style style:name=\"floor1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"none\" svg:stroke-color=\"#b3b3b3\"/></style:style><style:style style:name=\"legend1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"none\" svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"10pt\"/></style:style><style:style style:name=\"axisx\" style:family=\"chart\"><style:chart-properties chart:display-label=\"true\" chart:tick-marks-major-inner=\"false\" chart:tick-marks-major-outer=\"true\"/><style:graphic-properties svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"9pt\"/></style:style><style:style style:name=\"axisy\" style:family=\"chart\"><style:chart-properties chart:display-label=\"true\" chart:tick-marks-major-inner=\"false\" chart:tick-marks-major-outer=\"true\"/><style:graphic-properties svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"9pt\"/></style:style>").concat(seriesStyles, "</office:automatic-styles><office:body><office:chart><chart:chart chart:class=\"").concat(chartClass, "\" chart:style-name=\"ch1\">").concat(title).concat(legendXml, "<chart:plot-area chart:style-name=\"plot1\"").concat(plotAreaAttrs, ">").concat(axisXml).concat(seriesXml).concat(wallFloor, "</chart:plot-area></chart:chart></office:chart></office:body></office:document-content>");
+    return "".concat(XML_DECLARATION, "<office:document-content xmlns:office=\"").concat(ODS_NS.office, "\" xmlns:chart=\"").concat(ODS_NS.chart, "\" xmlns:table=\"").concat(ODS_NS.table, "\" xmlns:text=\"").concat(ODS_NS.text, "\" xmlns:style=\"").concat(ODS_NS.style, "\" xmlns:draw=\"").concat(ODS_NS.draw, "\" xmlns:svg=\"").concat(ODS_NS.svg, "\" xmlns:fo=\"").concat(ODS_NS.fo, "\" office:version=\"1.2\"><office:automatic-styles>").concat(gradientDefsXml, "<style:style style:name=\"ch1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\"/></style:style><style:style style:name=\"plot1\" style:family=\"chart\">").concat(plotStyleProps, "<style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\" svg:stroke-color=\"#b3b3b3\"/></style:style><style:style style:name=\"wall1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\" svg:stroke-color=\"#b3b3b3\" svg:stroke-width=\"0.01cm\"/></style:style><style:style style:name=\"floor1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"none\" svg:stroke-color=\"#b3b3b3\"/></style:style><style:style style:name=\"legend1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"none\" svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"10pt\"/></style:style><style:style style:name=\"axisx\" style:family=\"chart\"><style:chart-properties chart:display-label=\"true\" chart:tick-marks-major-inner=\"false\" chart:tick-marks-major-outer=\"true\"/><style:graphic-properties svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"9pt\"/></style:style><style:style style:name=\"axisy\" style:family=\"chart\"><style:chart-properties chart:display-label=\"true\" chart:tick-marks-major-inner=\"false\" chart:tick-marks-major-outer=\"true\"/><style:graphic-properties svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"9pt\"/></style:style>").concat(seriesStyles, "</office:automatic-styles><office:body><office:chart><chart:chart chart:class=\"").concat(chartClass, "\" chart:style-name=\"ch1\">").concat(title).concat(legendXml, "<chart:plot-area chart:style-name=\"plot1\"").concat(plotAreaAttrs, ">").concat(axisXml).concat(seriesXml).concat(wallFloor, "</chart:plot-area></chart:chart></office:chart></office:body></office:document-content>");
 };
 var buildChartRangeAddress = function (range, sheetNameById) {
     var sheetName = sheetNameById.get(range.sheetId);
@@ -3364,7 +3621,7 @@ var buildChartLabelAddressFromRange = function (range, sheetNameById) {
 };
 var buildChartFramesXml = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
     var frames, chartObjects, index, charts_1, charts_1_1, placement, chartXml, folder, widthPx, heightPx, offsetXPx, offsetYPx, width, height, origin_2, offsetX, offsetY, anchorRef, anchorCell, anchorAttr, endColumn, endRow, endRef, endCell, endCellAttr, endX, endY;
-    var e_34, _c;
+    var e_33, _c;
     var _d, _e, _f, _g;
     var charts = _b.charts, sheet = _b.sheet, sheetName = _b.sheetName, sheetNameById = _b.sheetNameById, startIndex = _b.startIndex;
     return __generator(this, function (_h) {
@@ -3425,12 +3682,12 @@ var buildChartFramesXml = function (_a) { return __awaiter(void 0, [_a], void 0,
                 index += 1;
             }
         }
-        catch (e_34_1) { e_34 = { error: e_34_1 }; }
+        catch (e_33_1) { e_33 = { error: e_33_1 }; }
         finally {
             try {
                 if (charts_1_1 && !charts_1_1.done && (_c = charts_1.return)) _c.call(charts_1);
             }
-            finally { if (e_34) throw e_34.error; }
+            finally { if (e_33) throw e_33.error; }
         }
         return [2 /*return*/, { frames: frames, chartObjects: chartObjects, nextIndex: index }];
     });