@rowsncolumns/toolkit 24.4.1 → 24.4.3

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

@@ -3,6 +3,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";
 const BLANK_LABEL = "(Blanks)";
@@ -80,6 +81,24 @@ const outlineGroupOpenTag = (span, tag) => {
 };
 const XML_DECLARATION = `<?xml version="1.0" encoding="UTF-8"?>`;
 const 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.
+ */
+const closeRowWrappers = (chunks, rowIndex, closesAt, headerRowsCloseAt, headerRowsOpen) => {
+    let open = headerRowsOpen;
+    const closes = closesAt.get(rowIndex) ?? [];
+    if (open && (rowIndex === headerRowsCloseAt || closes.length)) {
+        chunks.push("</table:table-header-rows>");
+        open = false;
+    }
+    for (const _ of closes) {
+        chunks.push("</table:table-row-group>");
+    }
+    return open;
+};
 const CREATOR = "Rows n Columns";
 const PIXELS_PER_INCH = 96;
 const CM_PER_INCH = 2.54;
@@ -127,14 +146,18 @@ class OdsStyleBuilder {
     usedStyleNames = new Set();
     rowStyles = new Map();
     columnStyles = new Map();
+    rtlTableStyleName;
     textStyles = new Map();
     numberStyles = new Map();
     styleXmlChunks = [];
     numberXmlChunks = [];
     // NEW: separate storage for conditional format styles (go to styles.xml)
     conditionalStyleXmlChunks = [];
+    pageLayoutXmlChunks = [];
+    masterPageXmlChunks = [];
     styleIndex = 1;
     numberIndex = 1;
+    pageLayoutIndex = 0;
     constructor(theme) {
         this.theme = theme;
     }
@@ -147,32 +170,73 @@ class OdsStyleBuilder {
             return existing;
         return this.registerCellWithName(format, key);
     }
-    registerRow(heightPx, hidden) {
-        if (!heightPx && !hidden)
+    registerRow(heightPx, hidden, breakBefore = false) {
+        if (!heightPx && !hidden && !breakBefore)
             return undefined;
-        const key = stableStringify({ heightPx, hidden });
+        const key = stableStringify({ heightPx, hidden, breakBefore });
         const existing = this.rowStyles.get(key);
         if (existing)
             return existing;
         const styleName = `ro${this.styleIndex++}`;
-        const styleXml = buildRowStyleXml(styleName, heightPx, hidden);
+        const styleXml = buildRowStyleXml(styleName, heightPx, hidden, breakBefore);
         this.rowStyles.set(key, styleName);
         this.styleXmlChunks.push(styleXml);
         return styleName;
     }
-    registerColumn(widthPx, hidden) {
-        if (!widthPx && !hidden)
+    registerColumn(widthPx, hidden, breakBefore = false) {
+        if (!widthPx && !hidden && !breakBefore)
             return undefined;
-        const key = stableStringify({ widthPx, hidden });
+        const key = stableStringify({ widthPx, hidden, breakBefore });
         const existing = this.columnStyles.get(key);
         if (existing)
             return existing;
         const styleName = `co${this.styleIndex++}`;
-        const styleXml = buildColumnStyleXml(styleName, widthPx, hidden);
+        const 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.
+     */
+    registerTable(print, rightToLeft) {
+        const pageLayoutXml = buildOdsPageLayoutXml(print);
+        const headerFooter = print?.headerFooter;
+        const 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.
+        const writingMode = rightToLeft ? "rl-tb" : "lr-tb";
+        if (!hasPrintSettings) {
+            if (!rightToLeft)
+                return undefined;
+            if (this.rtlTableStyleName)
+                return this.rtlTableStyleName;
+            const styleName = `ta${this.styleIndex++}`;
+            this.rtlTableStyleName = styleName;
+            this.styleXmlChunks.push(`<style:style style:name="${styleName}" style:family="table" style:master-page-name="Default"><style:table-properties table:display="true" style:writing-mode="${writingMode}"/></style:style>`);
+            return styleName;
+        }
+        const index = ++this.pageLayoutIndex;
+        const layoutName = `Mpm${index}`;
+        const masterName = `Mp${index}`;
+        const tableStyleName = `ta${this.styleIndex++}`;
+        this.pageLayoutXmlChunks.push(`<style:page-layout style:name="${layoutName}">${pageLayoutXml ?? "<style:page-layout-properties/>"}</style:page-layout>`);
+        this.masterPageXmlChunks.push(`<style:master-page style:name="${masterName}" style:page-layout-name="${layoutName}">${buildOdsHeaderFooterXml("style:header", headerFooter?.oddHeader)}${buildOdsHeaderFooterXml("style:footer", headerFooter?.oddFooter)}</style:master-page>`);
+        this.styleXmlChunks.push(`<style:style style:name="${tableStyleName}" style:family="table" style:master-page-name="${masterName}"><style:table-properties table:display="true" style:writing-mode="${writingMode}"/></style:style>`);
+        return tableStyleName;
+    }
+    /** `<style:page-layout>` entries for styles.xml `<office:automatic-styles>`. */
+    toPageLayoutStylesXml() {
+        return this.pageLayoutXmlChunks.join("");
+    }
+    /** `<style:master-page>` entries for styles.xml `<office:master-styles>`. */
+    toMasterPagesXml() {
+        return this.masterPageXmlChunks.join("");
+    }
     registerText(format) {
         if (!format || Object.keys(format).length === 0)
             return undefined;
@@ -353,7 +417,7 @@ export const createODSFile = async ({ conditionalFormats: _conditionalFormats, d
         automaticStylesXml: styleBuilder.toAutomaticStylesXml(),
         calculationSettingsXml,
     });
-    const stylesXml = buildStylesXml(styleBuilder.toConditionalStylesXml());
+    const stylesXml = buildStylesXml(styleBuilder.toConditionalStylesXml(), styleBuilder.toPageLayoutStylesXml(), styleBuilder.toMasterPagesXml());
     const metaXml = buildMetaXml();
     const settingsXml = buildSettingsXml(sortedSheets, _theme ?? defaultSpreadsheetTheme);
     const chartObjects = sheetXmlEntries.flatMap((entry) => entry.chartObjects);
@@ -393,7 +457,18 @@ const buildWorksheetXml = async ({ sheet, sheetName, rows, sourceSharedStrings,
         maxColumn: 0,
     };
     const rowMetadata = sheet.rowMetadata ?? [];
-    const maxRows = Math.max(rows.length, rowMetadata.length);
+    const print = sheet.printSettings;
+    // Manual breaks ride on the row AFTER the break (`fo:break-before`), and
+    // print-title rows need a real `<table:table-row>` to wrap — so both
+    // extend the emitted row range past the data.
+    const rowBreakSet = new Set((print?.rowBreaks ?? []).filter((n) => Number.isInteger(n) && n >= 1));
+    const titleRows = print?.printTitles?.rowStart != null && print.printTitles.rowEnd != null
+        ? {
+            start: Math.max(1, print.printTitles.rowStart),
+            end: Math.max(print.printTitles.rowStart, print.printTitles.rowEnd),
+        }
+        : undefined;
+    const maxRows = Math.max(rows.length, rowMetadata.length, rowBreakSet.size ? Math.max(...rowBreakSet) + 2 : 0, titleRows ? titleRows.end + 1 : 0);
     const rowXmlEntries = [];
     const mergeState = buildMergeState(sheet.merges ?? []);
     // Build annotations map from citations
@@ -431,6 +506,7 @@ const buildWorksheetXml = async ({ sheet, sheetName, rows, sourceSharedStrings,
             rowNumber: rowIndex,
             row,
             rowMetadata: metadata,
+            breakBefore: rowBreakSet.has(rowIndex - 1),
             sourceSharedStrings,
             cellXfs,
             styleBuilder,
@@ -478,19 +554,41 @@ const buildWorksheetXml = async ({ sheet, sheetName, rows, sourceSharedStrings,
     const rowSpans = findOutlineGroupSpans(rowMetadata, maxRowIndex, summaryBelow);
     const { opensAt: rowOpensAt, closesAt: rowClosesAt } = buildOutlineGroupIndex(rowSpans);
     const rowXmlChunks = [];
+    // Print titles: `<table:table-header-rows>` wraps the repeated band. ODF
+    // only allows plain rows inside it, so — like LibreOffice's writer — the
+    // wrapper is closed before any `<table:table-row-group>` opens or closes
+    // inside the band and re-opened on the next band row; the importer unions
+    // the segments back into one band.
+    const headerRowsOpenAt = titleRows?.start;
+    const headerRowsCloseAt = titleRows?.end;
+    let headerRowsOpen = false;
     for (let index = 0; index < rowXmlEntries.length; index++) {
         const rowIndex = index + 1;
-        for (const span of rowOpensAt.get(rowIndex) ?? []) {
+        const opens = rowOpensAt.get(rowIndex) ?? [];
+        if (opens.length && headerRowsOpen) {
+            rowXmlChunks.push("</table:table-header-rows>");
+            headerRowsOpen = false;
+        }
+        for (const span of opens) {
             rowXmlChunks.push(outlineGroupOpenTag(span, "table:table-row-group"));
         }
+        if (!headerRowsOpen &&
+            headerRowsOpenAt != null &&
+            headerRowsCloseAt != null &&
+            rowIndex >= headerRowsOpenAt &&
+            rowIndex <= headerRowsCloseAt) {
+            rowXmlChunks.push("<table:table-header-rows>");
+            headerRowsOpen = true;
+        }
         const entry = rowXmlEntries[index];
         if (entry) {
             rowXmlChunks.push(entry.xml);
         }
         else {
             // Aggregate consecutive empty rows into `number-rows-repeated`, but
-            // never cross a group boundary or include a row that any group
-            // opens/closes at — that would put a row inside the wrong wrapper.
+            // never cross a group / header-rows boundary or include a row that
+            // any group opens/closes at — that would put a row inside the wrong
+            // wrapper.
             let repeat = 1;
             while (index + repeat < rowXmlEntries.length &&
                 !rowXmlEntries[index + repeat]) {
@@ -498,6 +596,10 @@ const buildWorksheetXml = async ({ sheet, sheetName, rows, sourceSharedStrings,
                 if (rowOpensAt.has(nextRowIndex) || rowClosesAt.has(nextRowIndex - 1)) {
                     break;
                 }
+                if (nextRowIndex === headerRowsOpenAt ||
+                    nextRowIndex - 1 === headerRowsCloseAt) {
+                    break;
+                }
                 repeat += 1;
             }
             rowXmlChunks.push(repeat > 1
@@ -506,15 +608,11 @@ const buildWorksheetXml = async ({ sheet, sheetName, rows, sourceSharedStrings,
             // The break condition keeps closes from landing on any row except
             // the last in the repetition, so we only need to emit them once.
             const lastInRepeat = rowIndex + repeat - 1;
-            for (const _ of rowClosesAt.get(lastInRepeat) ?? []) {
-                rowXmlChunks.push(`</table:table-row-group>`);
-            }
+            headerRowsOpen = closeRowWrappers(rowXmlChunks, lastInRepeat, rowClosesAt, headerRowsCloseAt, headerRowsOpen);
             index += repeat - 1;
             continue;
         }
-        for (const _ of rowClosesAt.get(rowIndex) ?? []) {
-            rowXmlChunks.push(`</table:table-row-group>`);
-        }
+        headerRowsOpen = closeRowWrappers(rowXmlChunks, rowIndex, rowClosesAt, headerRowsCloseAt, headerRowsOpen);
     }
     const embedFrames = embeds.length
         ? await buildEmbedFramesXml({
@@ -536,10 +634,28 @@ const buildWorksheetXml = async ({ sheet, sheetName, rows, sourceSharedStrings,
     const shapesXml = embedFrames.length || chartFramesResult.frames.length
         ? `<table:shapes>${[...embedFrames, ...chartFramesResult.frames].join("")}</table:shapes>`
         : "";
-    const columnsXml = buildColumnsXml(sheet, styleBuilder, bounds);
+    const columnsXml = buildColumnsXml(sheet, styleBuilder, bounds, print);
     // Build sparkline XML from SPARKLINE formulas
     const sparklineXml = buildOdsSparklineGroupsXml(sheet, sheetName, rowDataMap) ?? "";
-    const sheetXml = `<table:table table:name="${escapeXml(sheetName)}">${shapesXml}${columnsXml}${rowXmlChunks.join("")}${conditionalFormattingXml}${sparklineXml}</table:table>`;
+    // ODF has no allow-edit `<protectedRange>` equivalent, so only the sheet-level
+    // switch is written; protected ranges degrade to unprotected on ODS export.
+    const protectedAttr = sheet.sheetProtection?.sheet
+        ? ' table:protected="true"'
+        : "";
+    // Page setup / margins / header-footer ride on the table style's master
+    // page (right-to-left is the same style's writing mode); the print area
+    // is `table:print-ranges` (space-separated).
+    const tableStyleName = styleBuilder.registerTable(print, sheet.rightToLeft ?? undefined);
+    const tableStyleAttr = tableStyleName
+        ? ` table:style-name="${tableStyleName}"`
+        : "";
+    const printRanges = (print?.printArea ?? [])
+        .map((range) => buildOdsRangeAddress(range, sheetName))
+        .filter((address) => Boolean(address));
+    const printRangesAttr = printRanges.length
+        ? ` table:print-ranges="${escapeXml(printRanges.join(" "))}"`
+        : "";
+    const sheetXml = `<table:table table:name="${escapeXml(sheetName)}"${tableStyleAttr}${protectedAttr}${printRangesAttr}>${shapesXml}${columnsXml}${rowXmlChunks.join("")}${conditionalFormattingXml}${sparklineXml}</table:table>`;
     return {
         xml: sheetXml,
         databaseRanges: buildDatabaseRangeEntries(tables, sheetName, sheet, rows),
@@ -547,7 +663,7 @@ const buildWorksheetXml = async ({ sheet, sheetName, rows, sourceSharedStrings,
         nextChartObjectIndex: chartFramesResult.nextIndex,
     };
 };
-const buildWorksheetRow = async ({ rowNumber, row, rowMetadata, sourceSharedStrings, cellXfs, styleBuilder, mergeState, dataValidationsById, mediaEntries, sheet, namedRangeNames, tables, ignoreFormulaPatterns, annotationsMap, sheetData, sheets, locale, }) => {
+const buildWorksheetRow = async ({ rowNumber, row, rowMetadata, breakBefore = false, sourceSharedStrings, cellXfs, styleBuilder, mergeState, dataValidationsById, mediaEntries, sheet, namedRangeNames, tables, ignoreFormulaPatterns, annotationsMap, sheetData, sheets, locale, }) => {
     const values = row?.values ?? [];
     const cellXmlChunks = [];
     let minColumn = Number.POSITIVE_INFINITY;
@@ -557,7 +673,7 @@ const buildWorksheetRow = async ({ rowNumber, row, rowMetadata, sourceSharedStri
     const rowSize = rowMetadata?.size && rowMetadata.size > 0 ? rowMetadata.size : undefined;
     const hasExplicitHeight = Boolean(rowSize && Math.abs(rowSize - defaultRowHeightPx) > 0.01);
     const hasCustomHeight = Boolean(rowSize && rowMetadata?.resizedByUser);
-    const rowStyle = styleBuilder.registerRow(rowSize && (hasExplicitHeight || hasCustomHeight) ? rowSize : undefined, hasHiddenFlag);
+    const rowStyle = styleBuilder.registerRow(rowSize && (hasExplicitHeight || hasCustomHeight) ? rowSize : undefined, hasHiddenFlag, breakBefore);
     const maxColumnIndex = Math.max(values.length - 1, mergeState.maxColumnByRow.get(rowNumber) ?? 0);
     for (let columnIndex = 1; columnIndex <= maxColumnIndex; columnIndex++) {
         if (mergeState.coveredCells.has(`${rowNumber}:${columnIndex}`)) {
@@ -594,7 +710,7 @@ const buildWorksheetRow = async ({ rowNumber, row, rowMetadata, sourceSharedStri
         maxColumn = Math.max(maxColumn, columnIndex);
     }
     const hasCells = cellXmlChunks.length > 0;
-    const needsMetadata = hasHiddenFlag || hasExplicitHeight || hasCustomHeight;
+    const needsMetadata = hasHiddenFlag || hasExplicitHeight || hasCustomHeight || breakBefore;
     if (!hasCells && !needsMetadata) {
         return null;
     }
@@ -962,8 +1078,110 @@ const buildCalculationSettingsXml = (iterativeCalculationOptions) => {
 const buildContentXml = ({ sheetsXml, databaseRangesXml, namedRangesXml, contentValidationsXml, automaticStylesXml, calculationSettingsXml, }) => {
     return `${XML_DECLARATION}<office:document-content xmlns:office="${ODS_NS.office}" xmlns:style="${ODS_NS.style}" xmlns:text="${ODS_NS.text}" xmlns:table="${ODS_NS.table}" xmlns:draw="${ODS_NS.draw}" xmlns:fo="${ODS_NS.fo}" xmlns:xlink="${ODS_NS.xlink}" xmlns:svg="${ODS_NS.svg}" xmlns:number="${ODS_NS.number}" xmlns:of="${ODS_NS.of}" xmlns:calcext="${ODS_NS.calcext}" xmlns:dc="${ODS_NS.dc}" office:version="1.2"><office:scripts/><office:automatic-styles>${automaticStylesXml}</office:automatic-styles><office:body><office:spreadsheet>${calculationSettingsXml}${contentValidationsXml}${sheetsXml}${namedRangesXml}${databaseRangesXml}</office:spreadsheet></office:body></office:document-content>`;
 };
-const buildStylesXml = (conditionalStylesXml = "") => {
-    return `${XML_DECLARATION}<office:document-styles xmlns:office="${ODS_NS.office}" xmlns:style="${ODS_NS.style}" xmlns:text="${ODS_NS.text}" xmlns:table="${ODS_NS.table}" xmlns:draw="${ODS_NS.draw}" xmlns:fo="${ODS_NS.fo}" xmlns:xlink="${ODS_NS.xlink}" xmlns:svg="${ODS_NS.svg}" xmlns:number="${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>${conditionalStylesXml}</office:styles><office:automatic-styles/><office:master-styles/></office:document-styles>`;
+const buildStylesXml = (conditionalStylesXml = "", pageLayoutsXml = "", masterPagesXml = "") => {
+    const automaticStyles = pageLayoutsXml
+        ? `<office:automatic-styles>${pageLayoutsXml}</office:automatic-styles>`
+        : "<office:automatic-styles/>";
+    const masterStyles = masterPagesXml
+        ? `<office:master-styles>${masterPagesXml}</office:master-styles>`
+        : "<office:master-styles/>";
+    return `${XML_DECLARATION}<office:document-styles xmlns:office="${ODS_NS.office}" xmlns:style="${ODS_NS.style}" xmlns:text="${ODS_NS.text}" xmlns:table="${ODS_NS.table}" xmlns:draw="${ODS_NS.draw}" xmlns:fo="${ODS_NS.fo}" xmlns:xlink="${ODS_NS.xlink}" xmlns:svg="${ODS_NS.svg}" xmlns:number="${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>${conditionalStylesXml}</office:styles>${automaticStyles}${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.
+ */
+const buildOdsPageLayoutXml = (print) => {
+    const setup = print?.pageSetup;
+    const margins = print?.pageMargins;
+    const options = print?.printOptions;
+    if (!setup && !margins && !options)
+        return undefined;
+    const attrs = [];
+    const landscape = setup?.orientation === "landscape";
+    const paper = paperSizeToCm(setup?.paperSize);
+    if (paper) {
+        const width = landscape ? paper.height : paper.width;
+        const height = landscape ? paper.width : paper.height;
+        attrs.push(`fo:page-width="${width.toFixed(3)}cm"`, `fo:page-height="${height.toFixed(3)}cm"`);
+    }
+    if (setup?.orientation) {
+        attrs.push(`style:print-orientation="${setup.orientation}"`);
+    }
+    const left = margins?.left ?? DEFAULT_PAGE_MARGINS_IN.left;
+    const right = margins?.right ?? DEFAULT_PAGE_MARGINS_IN.right;
+    const top = margins?.top ?? DEFAULT_PAGE_MARGINS_IN.top;
+    const bottom = margins?.bottom ?? DEFAULT_PAGE_MARGINS_IN.bottom;
+    const header = Math.min(margins?.header ?? DEFAULT_PAGE_MARGINS_IN.header, top);
+    const footer = Math.min(margins?.footer ?? DEFAULT_PAGE_MARGINS_IN.footer, bottom);
+    attrs.push(`fo:margin-top="${inchesToOdsCm(header)}"`, `fo:margin-bottom="${inchesToOdsCm(footer)}"`, `fo:margin-left="${inchesToOdsCm(left)}"`, `fo:margin-right="${inchesToOdsCm(right)}"`);
+    if (setup?.fitToPage) {
+        // LibreOffice's per-axis fit (`loext:scale-to-X/Y`); 0 = automatic.
+        attrs.push(`loext:scale-to-X="${setup.fitToWidth ?? 1}"`, `loext:scale-to-Y="${setup.fitToHeight ?? 1}"`);
+    }
+    else if (typeof setup?.scale === "number" && setup.scale > 0) {
+        attrs.push(`style:scale-to="${setup.scale}%"`);
+    }
+    const centering = odsTableCentering(options);
+    if (centering)
+        attrs.push(`style:table-centering="${centering}"`);
+    attrs.push(`style:print="${buildOdsPrintTokens(options)}"`);
+    if (setup?.pageOrder === "overThenDown") {
+        attrs.push(`style:print-page-order="ltr"`);
+    }
+    if (typeof setup?.firstPageNumber === "number" &&
+        setup.useFirstPageNumber !== false) {
+        attrs.push(`style:first-page-number="${setup.firstPageNumber}"`);
+    }
+    const headerStyle = `<style:header-style><style:header-footer-properties fo:min-height="${inchesToOdsCm(Math.max(0, top - header))}" fo:margin-bottom="0cm"/></style:header-style>`;
+    const footerStyle = `<style:footer-style><style:header-footer-properties fo:min-height="${inchesToOdsCm(Math.max(0, bottom - footer))}" fo:margin-top="0cm"/></style:footer-style>`;
+    return `<style:page-layout-properties ${attrs.join(" ")}/>${headerStyle}${footerStyle}`;
+};
+const odsFieldXml = (token) => {
+    if (token.type === "text") {
+        return token.text
+            .split("\n")
+            .map((line) => 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 "";
+    }
+};
+const odsHeaderZoneXml = (code) => code
+    ? `<text:p>${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.
+ */
+const buildOdsHeaderFooterXml = (tag, code) => {
+    if (!code)
+        return `<${tag} style:display="false"/>`;
+    const zones = splitHeaderFooterZones(code);
+    if (!zones.left && !zones.right) {
+        return `<${tag}>${odsHeaderZoneXml(zones.center)}</${tag}>`;
+    }
+    return `<${tag}><style:region-left>${odsHeaderZoneXml(zones.left)}</style:region-left><style:region-center>${odsHeaderZoneXml(zones.center)}</style:region-center><style:region-right>${odsHeaderZoneXml(zones.right)}</style:region-right></${tag}>`;
 };
 const buildMetaXml = () => {
     const now = new Date().toISOString();
@@ -1024,29 +1242,57 @@ const buildFreezeCell = (rows, columns) => {
     const row = Math.max(1, rows + 1);
     return `${col}${row}`;
 };
-const buildColumnsXml = (sheet, styleBuilder, bounds) => {
+const buildColumnsXml = (sheet, styleBuilder, bounds, print) => {
     const metadata = sheet.columnMetadata ?? [];
-    const maxColumns = Math.max(metadata.length - 1, bounds.maxColumn || 0);
+    const columnBreakSet = new Set((print?.columnBreaks ?? []).filter((n) => Number.isInteger(n) && n >= 1));
+    const titles = print?.printTitles;
+    const titleColumns = titles?.columnStart != null && titles.columnEnd != null
+        ? {
+            start: Math.max(1, titles.columnStart),
+            end: Math.max(titles.columnStart, titles.columnEnd),
+        }
+        : undefined;
+    const maxColumns = Math.max(metadata.length - 1, bounds.maxColumn || 0, columnBreakSet.size ? Math.max(...columnBreakSet) + 1 : 0, titleColumns?.end ?? 0);
     if (!maxColumns)
         return "";
     const summaryRight = sheet.outlinePr?.summaryRight !== false;
     const spans = findOutlineGroupSpans(metadata, maxColumns, summaryRight);
     const { opensAt, closesAt } = buildOutlineGroupIndex(spans);
     const 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.
+    let headerColumnsOpen = false;
     for (let index = 1; index <= maxColumns; index++) {
-        for (const span of opensAt.get(index) ?? []) {
+        const opens = opensAt.get(index) ?? [];
+        if (opens.length && headerColumnsOpen) {
+            parts.push("</table:table-header-columns>");
+            headerColumnsOpen = false;
+        }
+        for (const span of opens) {
             parts.push(outlineGroupOpenTag(span, "table:table-column-group"));
         }
+        if (!headerColumnsOpen &&
+            titleColumns &&
+            index >= titleColumns.start &&
+            index <= titleColumns.end) {
+            parts.push("<table:table-header-columns>");
+            headerColumnsOpen = true;
+        }
         const props = metadata[index];
         const widthPx = getColumnWidthPx(sheet, index);
         const hidden = Boolean(props?.hiddenByUser || props?.hiddenByFilter);
-        const styleName = styleBuilder.registerColumn(widthPx, hidden);
+        const styleName = styleBuilder.registerColumn(widthPx, hidden, columnBreakSet.has(index - 1));
         const attrs = [];
         if (styleName) {
             attrs.push(`table:style-name="${styleName}"`);
         }
         parts.push(`<table:table-column${attrs.length ? " " + attrs.join(" ") : ""}/>`);
-        for (const _ of closesAt.get(index) ?? []) {
+        const closes = closesAt.get(index) ?? [];
+        if (headerColumnsOpen && (index === titleColumns?.end || closes.length)) {
+            parts.push("</table:table-header-columns>");
+            headerColumnsOpen = false;
+        }
+        for (const _ of closes) {
             parts.push(`</table:table-column-group>`);
         }
     }
@@ -1208,7 +1454,7 @@ const buildRichTextParagraph = (text, runs, styleBuilder) => {
     }
     return `<text:p>${parts.join("")}</text:p>`;
 };
-const buildRowStyleXml = (name, heightPx, hidden) => {
+const buildRowStyleXml = (name, heightPx, hidden, breakBefore = false) => {
     const props = [];
     if (heightPx) {
         props.push(`style:row-height="${pxToCm(heightPx).toFixed(2)}cm"`);
@@ -1216,9 +1462,12 @@ const buildRowStyleXml = (name, heightPx, hidden) => {
     if (hidden) {
         props.push(`style:visibility="collapse"`);
     }
+    if (breakBefore) {
+        props.push(`fo:break-before="page"`);
+    }
     return `<style:style style:name="${name}" style:family="table-row"><style:table-row-properties${props.length ? " " + props.join(" ") : ""}/></style:style>`;
 };
-const buildColumnStyleXml = (name, widthPx, hidden) => {
+const buildColumnStyleXml = (name, widthPx, hidden, breakBefore = false) => {
     const props = [];
     if (widthPx) {
         props.push(`style:column-width="${pxToCm(widthPx).toFixed(2)}cm"`);
@@ -1226,6 +1475,9 @@ const buildColumnStyleXml = (name, widthPx, hidden) => {
     if (hidden) {
         props.push(`style:visibility="collapse"`);
     }
+    if (breakBefore) {
+        props.push(`fo:break-before="page"`);
+    }
     return `<style:style style:name="${name}" style:family="table-column"><style:table-column-properties${props.length ? " " + props.join(" ") : ""}/></style:style>`;
 };
 const buildNumberStyleXml = (name, format) => {
@@ -2727,7 +2979,26 @@ const buildChartObjectXml = (chart, sheetNameById) => {
         scatter: "chart:scatter",
         area: "chart:area",
     };
-    const chartClass = typeMap[spec.chartType] ?? "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.
+    const sourceChartType = String(spec.sourceChartType ?? "").toUpperCase();
+    const 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.
+    const threeDimensional = sourceChartType === "SURFACE_3D" ||
+        sourceChartType === "BAR_3D" ||
+        sourceChartType === "LINE_3D" ||
+        sourceChartType === "PIE_3D" ||
+        sourceChartType === "AREA_3D";
+    const chartClass = isSurface
+        ? "chart:surface"
+        : (typeMap[spec.chartType] ?? "chart:bar");
+    const plotStyleProps = threeDimensional
+        ? `<style:chart-properties chart:three-dimensional="true"/>`
+        : "";
     const title = spec.title
         ? `<chart:title><text:p>${escapeXml(String(spec.title))}</text:p></chart:title>`
         : "";
@@ -2810,7 +3081,7 @@ const buildChartObjectXml = (chart, sheetNameById) => {
     const legendXml = chartClass === "chart:circle"
         ? ""
         : `<chart:legend chart:legend-position="end" chart:legend-align="center" chart:style-name="legend1"/>`;
-    return `${XML_DECLARATION}<office:document-content xmlns:office="${ODS_NS.office}" xmlns:chart="${ODS_NS.chart}" xmlns:table="${ODS_NS.table}" xmlns:text="${ODS_NS.text}" xmlns:style="${ODS_NS.style}" xmlns:draw="${ODS_NS.draw}" xmlns:svg="${ODS_NS.svg}" xmlns:fo="${ODS_NS.fo}" office:version="1.2"><office:automatic-styles>${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>${seriesStyles}</office:automatic-styles><office:body><office:chart><chart:chart chart:class="${chartClass}" chart:style-name="ch1">${title}${legendXml}<chart:plot-area chart:style-name="plot1"${plotAreaAttrs}>${axisXml}${seriesXml}${wallFloor}</chart:plot-area></chart:chart></office:chart></office:body></office:document-content>`;
+    return `${XML_DECLARATION}<office:document-content xmlns:office="${ODS_NS.office}" xmlns:chart="${ODS_NS.chart}" xmlns:table="${ODS_NS.table}" xmlns:text="${ODS_NS.text}" xmlns:style="${ODS_NS.style}" xmlns:draw="${ODS_NS.draw}" xmlns:svg="${ODS_NS.svg}" xmlns:fo="${ODS_NS.fo}" office:version="1.2"><office:automatic-styles>${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">${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>${seriesStyles}</office:automatic-styles><office:body><office:chart><chart:chart chart:class="${chartClass}" chart:style-name="ch1">${title}${legendXml}<chart:plot-area chart:style-name="plot1"${plotAreaAttrs}>${axisXml}${seriesXml}${wallFloor}</chart:plot-area></chart:chart></office:chart></office:body></office:document-content>`;
 };
 const buildChartRangeAddress = (range, sheetNameById) => {
     const sheetName = sheetNameById.get(range.sheetId);

package/dist/esm/exporter/xlsx/chart-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/chart-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EAEd,MAAM,2BAA2B,CAAC;AAovCnC,eAAO,MAAM,aAAa,GACxB,OAAO,aAAa,EACpB,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,MAAM,GAAG,SAsnBX,CAAC"}
+{"version":3,"file":"chart-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/chart-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EAEd,MAAM,2BAA2B,CAAC;AAovCnC,eAAO,MAAM,aAAa,GACxB,OAAO,aAAa,EACpB,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,MAAM,GAAG,SAgoBX,CAAC"}