@rowsncolumns/toolkit 24.4.2 → 24.4.4

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

@@ -2,17 +2,21 @@ import { cellRangeToAddress, cellToAddress, escapeCharacters, getCellEffectiveFo
 import { zipSync } from "fflate";
 import { omitInvalidDataValidationError } from "../invalid-data-validation";
 import { buildAutoFilterConditionXml } from "../../autofilter-condition";
+import { buildControlElementXml, buildControlsXml, buildCtrlPropXml, buildFormControlVmlShape, buildVmlDrawingXml, CTRL_PROP_CONTENT_TYPE, CTRL_PROP_REL_TYPE, FORM_CONTROL_VML_SHAPETYPE, } from "./form-controls-builder";
+import { buildChartExGraphicFrameXml, buildChartExXml, CHART_EX_CONTENT_TYPE, CHART_EX_REL_TYPE, isChartExType, } from "./chartex-builder";
 import { applyPowerQueryParts } from "./power-query-builder";
+import { encodeImplicitIntersection } from "../../helpers/implicit-intersection";
 import { qualifyFutureFunctions } from "./future-functions";
 import { PERSON_CONTENT_TYPE, PERSON_REL_TYPE, PersonRegistry, THREADED_COMMENT_REL_TYPE, THREADED_COMMENTS_CONTENT_TYPE, ThreadedCommentsCollector, } from "./threaded-comments-builder";
 import { CFBEncryptor } from "../../excel-parser/cfb-encryptor";
 import { columnPixelToChars, imageUrlToBase64 } from "../../helpers";
+import { buildPrintAreaFormula, buildPrintTitlesFormula, isBuiltinPrintName, isHeaderFooterEmpty, PRINT_AREA_NAME, PRINT_TITLES_NAME, } from "../../print-settings";
 import { generateThemeXml } from "../../helpers/theme-xml-generator";
 import theme1Xml from "../../theme1";
 import { tokenize as defaultTokenizer } from "@rowsncolumns/calculator";
 import { CellXfsRegistry, deriveEffectiveNumberFormatFromFormula, } from "@rowsncolumns/spreadsheet-state";
 import { buildChartXml } from "./chart-builder";
-import { buildPivotCacheDefinitionXml, buildPivotTableRelsXml, buildPivotTableXml, } from "./pivot-builder";
+import { buildPivotCacheDefinitionXml, buildPivotTableRelsXml, buildPivotTableXml, calculatedFieldReferences, } from "./pivot-builder";
 import { buildSlicerCacheXml, buildSlicerXml } from "./slicer-builder";
 import { buildSparklineGroupsXml } from "./sparkline-builder";
 import { StyleBuilder } from "./style-builder";
@@ -21,7 +25,7 @@ const isStyleReference = (value) => !!value && typeof value === "object" && "sid
 const DEFAULT_COLUMN_WIDTH_PX = 100;
 const DEFAULT_ROW_HEIGHT_PX = 21;
 const pixelToPoints = (px) => Math.max(1, Number(((px * 72) / 96).toFixed(2)));
-export const createExcelFile = async ({ conditionalFormats: _conditionalFormats, dataValidations: _dataValidations, sheets, sheetData, sharedStrings: sourceSharedStrings, tables: _tables = [], cellXfs, theme, defaultFont, embeds = [], charts = [], slicers = [], pivotTables = [], externalLinks = [], namedRanges = [], namedCellStyles, customTableStyles, iterativeCalculationOptions, ignoreFormulaPatterns, citations, comments, password, locale, use1904 = false, properties, powerQuery, }) => {
+export const createExcelFile = async ({ conditionalFormats: _conditionalFormats, dataValidations: _dataValidations, sheets, sheetData, sharedStrings: sourceSharedStrings, tables: _tables = [], cellXfs, theme, defaultFont, embeds = [], charts = [], slicers = [], pivotTables = [], externalLinks = [], namedRanges = [], protectedRanges = [], namedCellStyles, customTableStyles, iterativeCalculationOptions, ignoreFormulaPatterns, citations, comments, password, locale, use1904 = false, properties, powerQuery, }) => {
     const sortedSheets = sortSheetsByIndex(sheets, true);
     const sharedStrings = new SharedStrings();
     // Workbook-scoped author registry shared across every sheet's threaded
@@ -51,6 +55,8 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
     const embedsBySheet = groupEmbedsBySheet(embeds ?? []);
     const textBoxesBySheet = groupTextBoxesBySheet(embeds ?? []);
     const shapesBySheet = groupShapesBySheet(embeds ?? []);
+    const formControlsBySheet = groupFormControlsBySheet(embeds ?? []);
+    const ctrlProps = { parts: [] };
     const chartsBySheet = groupChartsBySheet(charts ?? []);
     // Remap slicer tableIds to match prepared table IDs
     const remappedSlicers = slicers.map((slicer) => {
@@ -116,6 +122,7 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
         const embedImages = embedsBySheet.get(sheet.sheetId) ?? [];
         const textBoxes = textBoxesBySheet.get(sheet.sheetId) ?? [];
         const sheetShapes = shapesBySheet.get(sheet.sheetId) ?? [];
+        const sheetFormControls = formControlsBySheet.get(sheet.sheetId) ?? [];
         const sheetCharts = chartsBySheet.get(sheet.sheetId) ?? [];
         const sheetSlicers = slicersBySheet.get(sheet.sheetId) ?? [];
         const worksheetSlicerRelIds = [];
@@ -183,12 +190,26 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
                 fieldIndex.set(name, fieldNameList.length);
                 fieldNameList.push(name);
             };
+            const calculatedNames = new Set((pivot.calculatedFields ?? []).map((c) => c.name));
             for (const r of pivot.rows ?? [])
                 registerField(r.field);
             for (const c of pivot.columns ?? [])
                 registerField(c.field);
-            for (const v of pivot.values ?? [])
-                registerField(v.field);
+            for (const v of pivot.values ?? []) {
+                if (!calculatedNames.has(v.field))
+                    registerField(v.field);
+            }
+            // Source fields a calculated field reads must exist in the cache
+            // for Excel to evaluate the formula; the calculated fields
+            // themselves come last, as Excel orders them.
+            for (const c of pivot.calculatedFields ?? []) {
+                for (const ref of calculatedFieldReferences(c.formula)) {
+                    if (!calculatedNames.has(ref))
+                        registerField(ref);
+                }
+            }
+            for (const c of pivot.calculatedFields ?? [])
+                registerField(c.name);
             const cacheXml = buildPivotCacheDefinitionXml(pivot, sourceSheetName, fieldNameList);
             const tableXml = buildPivotTableXml(pivot, cacheIndex, fieldIndex);
             if (!cacheXml || !tableXml)
@@ -233,6 +254,9 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
             sheetData,
             sheets: sortedSheets,
             locale,
+            protectedRanges,
+            formControls: sheetFormControls,
+            ctrlProps,
         });
         return {
             index,
@@ -305,6 +329,10 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
     const drawingSheets = [];
     const imageExtensions = new Set();
     const chartEntries = [];
+    // Excel 2016+ chartex parts (treemap / sunburst) — numbered apart from
+    // `chart{N}.xml`, as Excel does.
+    const chartExEntries = [];
+    let globalChartExIndex = 1;
     for (const entry of worksheetEntries) {
         const placements = [...entry.cellImages, ...entry.embedImages];
         const textBoxesForSheet = entry.textBoxes ?? [];
@@ -324,6 +352,7 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
             shapes: shapesForSheet,
             startImageIndex: globalImageIndex,
             startChartIndex: globalChartIndex,
+            startChartExIndex: globalChartExIndex,
             charts: chartsForSheet,
             slicers: slicersForSheet,
             sheetNameById,
@@ -341,13 +370,20 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
         for (const chartEntry of drawingParts.charts) {
             chartEntries.push(chartEntry);
         }
+        for (const chartExEntry of drawingParts.chartExs) {
+            chartExEntries.push(chartExEntry);
+        }
         globalImageIndex = drawingParts.nextImageIndex;
         globalChartIndex = drawingParts.nextChartIndex;
+        globalChartExIndex = drawingParts.nextChartExIndex;
         drawingSheets.push(entry.index + 1);
     }
     for (const chartEntry of chartEntries) {
         files[chartEntry.path] = encodeXml(chartEntry.xml);
     }
+    for (const chartExEntry of chartExEntries) {
+        files[chartExEntry.path] = encodeXml(chartExEntry.xml);
+    }
     for (const slicerCacheEntry of slicerCacheEntries) {
         files[slicerCacheEntry.path] = encodeXml(slicerCacheEntry.xml);
     }
@@ -381,6 +417,10 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
     const commentsSheets = worksheetEntries
         .filter((entry) => entry.commentsXml)
         .map((entry) => entry.sheet.sheetId ?? entry.index + 1);
+    const hasVmlDrawings = worksheetEntries.some((entry) => entry.vmlDrawingXml);
+    for (const part of ctrlProps.parts) {
+        files[part.path] = encodeXml(part.xml);
+    }
     const threadedCommentsSheets = worksheetEntries
         .filter((entry) => entry.threadedCommentsXml)
         .map((entry) => entry.sheet.sheetId ?? entry.index + 1);
@@ -390,6 +430,7 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
         drawingSheets,
         mediaExtensions: Array.from(imageExtensions),
         chartCount: chartEntries.length,
+        chartExCount: chartExEntries.length,
         slicerCount: slicerEntries.length,
         slicerCacheCount: slicerCacheEntries.length,
         pivotTableCount: pivotTableEntries.length,
@@ -398,6 +439,8 @@ export const createExcelFile = async ({ conditionalFormats: _conditionalFormats,
         threadedCommentsSheets,
         hasPersons: !personRegistry.isEmpty(),
         externalLinkCount: externalLinks.length,
+        hasVmlDrawings,
+        ctrlPropCount: ctrlProps.parts.length,
     });
     files["[Content_Types].xml"] = encodeXml(contentTypesXml);
     // Preserved Power Query machinery (DataMashup customXml, connections.xml, queryTable parts) is
@@ -546,6 +589,8 @@ class DataValidationCollector {
         return `<dataValidations count="${this.entries.size}">${items.join("")}</dataValidations>`;
     }
 }
+/** First VML shape id the note shapes take (`_x0000_s1026`, `_x0000_s1027`, …). */
+const NOTE_VML_SHAPE_ID_BASE = 1026;
 class CommentsCollector {
     entries = [];
     add(address, text, author = "System") {
@@ -570,13 +615,18 @@ class CommentsCollector {
             .join("");
         return `${XML_DECLARATION}<comments xmlns="${WORKSHEET_NS}"><authors>${authorsXml}</authors><commentList>${commentsXml}</commentList></comments>`;
     }
-    toVmlXml() {
-        if (!this.entries.length) {
-            return undefined;
-        }
-        const shapes = this.entries
-            .map((entry, index) => {
-            const shapeId = `_x0000_s${1026 + index}`;
+    /**
+     * VML shape ids the note shapes occupy. Excel allocates notes and form
+     * controls from one per-sheet counter, so the form-control allocator must
+     * never hand these out again.
+     */
+    vmlShapeIds() {
+        return this.entries.map((_, index) => NOTE_VML_SHAPE_ID_BASE + index);
+    }
+    /** One `<v:shape>` per note (Excel's hidden `Note` object). */
+    toVmlShapes() {
+        return this.entries.map((entry, index) => {
+            const shapeId = `_x0000_s${NOTE_VML_SHAPE_ID_BASE + index}`;
             // Parse cell address to get row and column
             const match = entry.address.match(/^([A-Z]+)(\d+)$/);
             if (!match)
@@ -587,11 +637,11 @@ class CommentsCollector {
                 .split("")
                 .reduce((acc, char) => acc * 26 + (char.charCodeAt(0) - 64), 0) - 1;
             return `<v:shape id="${shapeId}" type="#_x0000_t202" style='position:absolute;margin-left:59.25pt;margin-top:1.5pt;width:108pt;height:59.25pt;z-index:${index + 1};visibility:hidden' fillcolor="#ffffe1" o:insetmode="auto"><v:fill color2="#ffffe1"/><v:shadow on="t" color="black" obscured="t"/><v:path o:connecttype="none"/><v:textbox style='mso-direction-alt:auto'><div style='text-align:left'></div></v:textbox><x:ClientData ObjectType="Note"><x:MoveWithCells/><x:SizeWithCells/><x:Anchor>1, 15, 0, 2, 3, 15, 3, 16</x:Anchor><x:AutoFill>False</x:AutoFill><x:Row>${row - 1}</x:Row><x:Column>${colIndex}</x:Column></x:ClientData></v:shape>`;
-        })
-            .join("");
-        return `<xml xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:x="urn:schemas-microsoft-com:office:excel"><o:shapelayout v:ext="edit"><o:idmap v:ext="edit" data="1"/></o:shapelayout><v:shapetype id="_x0000_t202" coordsize="21600,21600" o:spt="202" path="m,l,21600r21600,l21600,xe"><v:stroke joinstyle="miter"/><v:path gradientshapeok="t" o:connecttype="rect"/></v:shapetype>${shapes}</xml>`;
+        }).filter(Boolean);
     }
 }
+/** VML `<v:shapetype>` for legacy notes (`#_x0000_t202`). */
+const NOTE_VML_SHAPETYPE = `<v:shapetype id="_x0000_t202" coordsize="21600,21600" o:spt="202" path="m,l,21600r21600,l21600,xe"><v:stroke joinstyle="miter"/><v:path gradientshapeok="t" o:connecttype="rect"/></v:shapetype>`;
 const INVALID_XML_CHAR_REGEX = /[\u0000-\u0008\u000B\u000C\u000E-\u001F]/g;
 const sanitizeXmlText = (value) => {
     if (!value)
@@ -643,7 +693,7 @@ const getRowsForSheet = (sheetData, sheetId) => {
         sheetData[Number(sheetId)] ??
         []);
 };
-const buildWorksheetXml = ({ sheet, rows, sharedStrings, sourceSharedStrings, cellXfs, styleBuilder, tables, relationships, drawingContext, conditionalFormats, dataValidationsById, dataValidations, ignoreFormulaPatterns, citations, comments, personRegistry, slicerRelIds, sheetData, sheets, locale, }) => {
+const buildWorksheetXml = ({ sheet, rows, sharedStrings, sourceSharedStrings, cellXfs, styleBuilder, tables, relationships, drawingContext, conditionalFormats, dataValidationsById, dataValidations, ignoreFormulaPatterns, citations, comments, personRegistry, slicerRelIds, sheetData, sheets, locale, protectedRanges, formControls = [], ctrlProps = { parts: [] }, }) => {
     const tableNameMap = buildTableNameMap(tables);
     const bounds = {
         minRow: Number.POSITIVE_INFINITY,
@@ -806,14 +856,36 @@ const buildWorksheetXml = ({ sheet, rows, sharedStrings, sourceSharedStrings, ce
     }
     // Generate comments XML (notes) and add relationships if there are comments
     const commentsXml = commentsCollector.toXml();
-    let legacyDrawingXml = "";
     if (commentsXml) {
         relationships.add(COMMENTS_REL_TYPE, `../comments${sheet.sheetId}.xml`);
+    }
+    // Notes and form controls share the sheet's one legacy VML part
+    // (`<legacyDrawing>`); a control without its VML shape is dropped by Excel.
+    const noteVmlShapes = commentsCollector.toVmlShapes();
+    const formControlBuild = buildSheetFormControls({
+        sheet,
+        controls: formControls,
+        relationships,
+        ctrlProps,
+        zIndexStart: noteVmlShapes.length,
+        reservedShapeIds: commentsCollector.vmlShapeIds(),
+    });
+    const vmlDrawingXml = buildVmlDrawingXml({
+        shapeTypes: [
+            ...(noteVmlShapes.length ? [NOTE_VML_SHAPETYPE] : []),
+            ...(formControlBuild.vmlShapes.length ? [FORM_CONTROL_VML_SHAPETYPE] : []),
+        ],
+        shapes: [...noteVmlShapes, ...formControlBuild.vmlShapes],
+    });
+    let legacyDrawingXml = "";
+    if (vmlDrawingXml) {
         const legacyDrawingRelId = relationships.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing", `../drawings/vmlDrawing${sheet.sheetId}.vml`);
         legacyDrawingXml = `<legacyDrawing r:id="${legacyDrawingRelId}"/>`;
     }
+    const controlsXml = formControlBuild.controlsXml;
     const sheetDataXml = `<sheetData>${rowXmlChunks.join("")}</sheetData>`;
-    const pageMargins = DEFAULT_PAGE_MARGINS;
+    const protectionXml = buildSheetProtectionXml(sheet, protectedRanges);
+    const printSettingsXml = buildPrintSettingsXml(sheet.printSettings);
     // Build row data map for sparkline detection
     const rowDataMap = {};
     for (let rowIndex = 1; rowIndex < maxRows; rowIndex++) {
@@ -847,13 +919,13 @@ const buildWorksheetXml = ({ sheet, rows, sharedStrings, sourceSharedStrings, ce
         explicitDefaultColumnWidthPx > 0) {
         sheetFormatPrAttrs.push(`defaultColWidth="${columnPixelToChars(explicitDefaultColumnWidthPx).toFixed(2)}"`);
     }
-    const worksheetXml = `${XML_DECLARATION}<worksheet xmlns="${WORKSHEET_NS}" xmlns:r="${REL_NS}">${sheetPrXml}<dimension ref="${dimension}"/>${sheetViews}<sheetFormatPr ${sheetFormatPrAttrs.join(" ")}/>${columnXml}${sheetDataXml}${basicFilterXml}${mergeXml}${conditionalFormattingXml}${dataValidationsXml}${hyperlinksXml}${pageMargins}${drawingXml}${legacyDrawingXml}${tablePartsXml}${extLstXml}</worksheet>`;
+    const worksheetXml = `${XML_DECLARATION}<worksheet xmlns="${WORKSHEET_NS}" xmlns:r="${REL_NS}">${sheetPrXml}<dimension ref="${dimension}"/>${sheetViews}<sheetFormatPr ${sheetFormatPrAttrs.join(" ")}/>${columnXml}${sheetDataXml}${protectionXml}${basicFilterXml}${mergeXml}${conditionalFormattingXml}${dataValidationsXml}${hyperlinksXml}${printSettingsXml}${drawingXml}${legacyDrawingXml}${controlsXml}${tablePartsXml}${extLstXml}</worksheet>`;
     return {
         xml: worksheetXml,
         relationshipsXml: relationships.toXml(),
         images: collectedImages,
         commentsXml,
-        vmlDrawingXml: commentsCollector.toVmlXml(),
+        vmlDrawingXml,
         threadedCommentsXml,
     };
 };
@@ -1814,7 +1886,9 @@ function rewriteStructuredReferenceFormula(formula, tableNameMap, tables, rowNum
 }
 function sanitizeFormulaText(formula) {
     const normalized = sanitizeXmlText(formula);
-    return qualifyFutureFunctions(normalized.replace(/\r\n|\r|\n/g, " "));
+    // `@x` is persisted as `_xlfn.SINGLE(x)`; encoding first lets the
+    // future-function pass add the prefix.
+    return qualifyFutureFunctions(encodeImplicitIntersection(normalized.replace(/\r\n|\r|\n/g, " ")));
 }
 function escapeXmlBase(value) {
     return sanitizeXmlText(value)
@@ -1976,6 +2050,11 @@ const buildSheetViewsXml = (sheet) => {
         zoomScale !== 100) {
         attrs.push(`zoomScale="${zoomScale}"`);
     }
+    // `rightToLeft` — only an explicit true is written (Excel's default is
+    // LTR and the attribute is omitted), mirroring the Rust exporter.
+    if (sheet.rightToLeft) {
+        attrs.push(`rightToLeft="1"`);
+    }
     const panes = [];
     const frozenRows = sheet.frozenRowCount ?? 0;
     const frozenColumns = sheet.frozenColumnCount ?? 0;
@@ -2230,6 +2309,57 @@ const sanitizeTableName = (name) => {
     }
     return cleaned;
 };
+/**
+ * `SUBTOTAL()` function numbers (the 101+ "ignore hidden rows" family Excel
+ * writes into totals-row cells) → `totalsRowFunction`.
+ */
+const SUBTOTAL_TOTALS_ROW_FUNCTIONS = {
+    "101": "average",
+    "102": "countNums",
+    "103": "count",
+    "104": "max",
+    "105": "min",
+    "107": "stdDev",
+    "109": "sum",
+    "110": "var",
+};
+/**
+ * Totals-row metadata for one `<tableColumn>`. Explicit column metadata
+ * (imported from Excel, or set by the host) wins — an explicit `none` means
+ * "no totals function" and is not second-guessed from the cell (the Rust
+ * exporter's `totals_for_column` agrees). Otherwise it is derived from the
+ * totals-row cell so tables whose totals row was added in-app (a "Total"
+ * label + `=SUBTOTAL(109,[Col])` per numeric column) open in Excel with the
+ * matching function selected in the totals dropdown. A formula that is not
+ * a plain `SUBTOTAL(n, ref)` is left to the cell.
+ */
+const resolveTableColumnTotals = (column, totalsCell) => {
+    if (column?.totalsRowLabel) {
+        return { totalsRowLabel: column.totalsRowLabel };
+    }
+    if (column?.totalsRowFunction) {
+        if (column.totalsRowFunction === "none") {
+            return undefined;
+        }
+        if (column.totalsRowFunction === "custom" && !column.totalsRowFormula) {
+            return undefined;
+        }
+        return {
+            totalsRowFunction: column.totalsRowFunction,
+            totalsRowFormula: column.totalsRowFormula ?? undefined,
+        };
+    }
+    if (!totalsCell)
+        return undefined;
+    const formula = getExtendedValueFormula(getCellUserEnteredValue(totalsCell));
+    if (formula) {
+        const match = /^=?\s*SUBTOTAL\(\s*(\d{3})\s*,[^,]*\)\s*$/i.exec(formula);
+        const fn = match ? SUBTOTAL_TOTALS_ROW_FUNCTIONS[match[1]] : undefined;
+        return fn ? { totalsRowFunction: fn } : undefined;
+    }
+    const label = getExtendedValueString(getCellUserEnteredValue(totalsCell));
+    return label && label.trim() !== "" ? { totalsRowLabel: label } : undefined;
+};
 const buildTableXml = (table, rows, sourceSharedStrings, styleBuilder) => {
     const rangeRef = table.ref;
     const columnCount = Math.max(table.columns?.length ?? 0, (table.range.endColumnIndex ?? table.range.startColumnIndex) -
@@ -2275,6 +2405,7 @@ const buildTableXml = (table, rows, sourceSharedStrings, styleBuilder) => {
         // Fallback to table.columns name or generic name
         return table.columns?.[index]?.name ?? `Column${index + 1}`;
     });
+    const totalsRowIndex = table.range.endRowIndex;
     const tableColumns = `<tableColumns count="${columnCount}">${columnNames
         .map((name, idx) => {
         const columnFormula = table.columns?.[idx]?.formula;
@@ -2284,7 +2415,22 @@ const buildTableXml = (table, rows, sourceSharedStrings, styleBuilder) => {
         const formulaXml = normalizedFormula
             ? `<calculatedColumnFormula>${escapeXmlText(stripFormula(normalizedFormula))}</calculatedColumnFormula>`
             : "";
-        return `<tableColumn id="${idx + 1}" name="${escapeXmlAttr(name)}">${formulaXml}</tableColumn>`;
+        // Explicit per-column totals metadata exports whether or not the totals
+        // row is shown: Excel keeps it on a table whose totals row is toggled
+        // off so re-enabling restores each column's choice. Deriving it from
+        // the last row only applies when that row IS the totals row.
+        const totals = resolveTableColumnTotals(table.columns?.[idx], totalsRowCount > 0
+            ? rows[totalsRowIndex]?.values?.[table.range.startColumnIndex + idx]
+            : undefined);
+        const totalsAttrs = totals?.totalsRowLabel
+            ? ` totalsRowLabel="${escapeXmlAttr(totals.totalsRowLabel)}"`
+            : totals?.totalsRowFunction
+                ? ` totalsRowFunction="${totals.totalsRowFunction}"`
+                : "";
+        const totalsFormulaXml = totals?.totalsRowFunction === "custom" && totals.totalsRowFormula
+            ? `<totalsRowFormula>${escapeXmlText(stripFormula(normalizeCalculatedColumnFormula(totals.totalsRowFormula, table)))}</totalsRowFormula>`
+            : "";
+        return `<tableColumn id="${idx + 1}" name="${escapeXmlAttr(name)}"${totalsAttrs}>${formulaXml}${totalsFormulaXml}</tableColumn>`;
     })
         .join("")}</tableColumns>`;
     const isBuiltInStyle = table.theme && /^TableStyle(Light|Medium|Dark)\d+$/.test(table.theme);
@@ -2332,6 +2478,106 @@ const buildWorksheetAutoFilterXml = (sheet, rows, styleBuilder) => {
     }
     return `<autoFilter ref="${ref}"/>`;
 };
+/** `CT_SheetProtection` boolean attributes in Excel's attribute order. */
+const SHEET_PROTECTION_FLAG_ATTRS = [
+    "sheet",
+    "objects",
+    "scenarios",
+    "formatCells",
+    "formatColumns",
+    "formatRows",
+    "insertColumns",
+    "insertRows",
+    "insertHyperlinks",
+    "deleteColumns",
+    "deleteRows",
+    "selectLockedCells",
+    "sort",
+    "autoFilter",
+    "pivotTables",
+    "selectUnlockedCells",
+];
+/**
+ * `<sheetProtection …/>` from `Sheet.sheetProtection`: the password hash first
+ * (legacy `password` or the agile quartet, verbatim), then only the action
+ * flags the model carries (`true` → `"1"`, `false` → `"0"`, absent → omitted so
+ * Excel's schema default applies). Mirrors `rnc-export`'s `sheet_protection_xml`.
+ */
+const buildSheetProtectionElementXml = (protection) => {
+    const attrs = [];
+    if (protection.algorithmName) {
+        attrs.push(`algorithmName="${escapeXmlAttr(protection.algorithmName)}"`);
+    }
+    if (protection.hashValue) {
+        attrs.push(`hashValue="${escapeXmlAttr(protection.hashValue)}"`);
+    }
+    if (protection.saltValue) {
+        attrs.push(`saltValue="${escapeXmlAttr(protection.saltValue)}"`);
+    }
+    if (protection.spinCount != null) {
+        attrs.push(`spinCount="${protection.spinCount}"`);
+    }
+    if (protection.password) {
+        attrs.push(`password="${escapeXmlAttr(protection.password)}"`);
+    }
+    for (const flag of SHEET_PROTECTION_FLAG_ATTRS) {
+        const value = protection[flag];
+        if (typeof value === "boolean") {
+            attrs.push(`${flag}="${value ? 1 : 0}"`);
+        }
+    }
+    return attrs.length ? `<sheetProtection ${attrs.join(" ")}/>` : "";
+};
+/**
+ * The sheet's protection block — `<sheetProtection>` followed by
+ * `<protectedRanges>` — or `""` when the sheet is unprotected and has no
+ * allow-edit ranges. Ranges missing a bound (a sheet-wide `protect-sheet`
+ * entry only carries `sheetId`) have no `sqref` and are skipped; the `name`
+ * is the range's id, synthesized as `Range{n}` when absent (schema requires it).
+ */
+const buildSheetProtectionXml = (sheet, protectedRanges) => {
+    const protectionXml = sheet.sheetProtection
+        ? buildSheetProtectionElementXml(sheet.sheetProtection)
+        : "";
+    const rangeItems = [];
+    for (const protectedRange of protectedRanges ?? []) {
+        const range = protectedRange.range;
+        if (range.sheetId !== sheet.sheetId)
+            continue;
+        if (range.startRowIndex == null ||
+            range.endRowIndex == null ||
+            range.startColumnIndex == null ||
+            range.endColumnIndex == null) {
+            continue;
+        }
+        // Excel writes a single cell as `D10`, a block as `A2:C5`.
+        const isSingleCell = range.startRowIndex === range.endRowIndex &&
+            range.startColumnIndex === range.endColumnIndex;
+        const sqref = isSingleCell
+            ? cellToAddress({
+                rowIndex: range.startRowIndex,
+                columnIndex: range.startColumnIndex,
+            })
+            : cellRangeToAddress(undefined, {
+                startRowIndex: range.startRowIndex,
+                endRowIndex: range.endRowIndex,
+                startColumnIndex: range.startColumnIndex,
+                endColumnIndex: range.endColumnIndex,
+            });
+        if (!sqref)
+            continue;
+        const id = protectedRange.protectedRangeId;
+        const name = id != null && String(id) !== "" ? String(id) : `Range${rangeItems.length + 1}`;
+        const securityDescriptor = protectedRange.securityDescriptor
+            ? ` securityDescriptor="${escapeXmlAttr(protectedRange.securityDescriptor)}"`
+            : "";
+        rangeItems.push(`<protectedRange sqref="${escapeXmlAttr(sqref)}" name="${escapeXmlAttr(name)}"${securityDescriptor}/>`);
+    }
+    const rangesXml = rangeItems.length
+        ? `<protectedRanges>${rangeItems.join("")}</protectedRanges>`
+        : "";
+    return `${protectionXml}${rangesXml}`;
+};
 const buildSheetPropertiesXml = (sheet) => {
     const tabColor = serializeColorXml(sheet.tabColor ?? undefined);
     // <outlinePr> mirrors the sheet's `outlinePr` setting; both attrs
@@ -2348,11 +2594,105 @@ const buildSheetPropertiesXml = (sheet) => {
     const outlineXml = outlineAttrs.length
         ? `<outlinePr ${outlineAttrs.join(" ")}/>`
         : "";
-    if (!tabColor && !outlineXml)
+    // `<pageSetUpPr fitToPage="1">` is what makes Excel honour
+    // `<pageSetup fitToWidth/fitToHeight>` instead of `scale`.
+    const pageSetUpPrXml = sheet.printSettings?.pageSetup?.fitToPage
+        ? `<pageSetUpPr fitToPage="1"/>`
+        : "";
+    if (!tabColor && !outlineXml && !pageSetUpPrXml)
         return "";
-    const inner = `${tabColor ? `<tabColor ${tabColor}/>` : ""}${outlineXml}`;
+    const inner = `${tabColor ? `<tabColor ${tabColor}/>` : ""}${outlineXml}${pageSetUpPrXml}`;
     return `<sheetPr>${inner}</sheetPr>`;
 };
+const xmlBoolAttr = (name, value) => value == null ? "" : ` ${name}="${value ? "1" : "0"}"`;
+const xmlNumAttr = (name, value) => typeof value === "number" && Number.isFinite(value)
+    ? ` ${name}="${value}"`
+    : "";
+/**
+ * The `CT_Worksheet` print tail — `<printOptions>`, `<pageMargins>`,
+ * `<pageSetup>`, `<headerFooter>`, `<rowBreaks>`, `<colBreaks>` — in schema
+ * order (after `<hyperlinks>`, before `<drawing>`). `<pageMargins>` is
+ * mandatory in practice (Excel always writes it), so the default margins go
+ * out when the sheet has none of its own.
+ */
+const buildPrintSettingsXml = (print) => {
+    const parts = [];
+    const options = print?.printOptions;
+    const optionAttrs = xmlBoolAttr("horizontalCentered", options?.horizontalCentered) +
+        xmlBoolAttr("verticalCentered", options?.verticalCentered) +
+        xmlBoolAttr("headings", options?.headings) +
+        xmlBoolAttr("gridLines", options?.gridLines);
+    if (optionAttrs)
+        parts.push(`<printOptions${optionAttrs}/>`);
+    const margins = print?.pageMargins;
+    parts.push(margins &&
+        Object.values(margins).some((v) => typeof v === "number")
+        ? `<pageMargins left="${margins.left ?? 0.7}" right="${margins.right ?? 0.7}" top="${margins.top ?? 0.75}" bottom="${margins.bottom ?? 0.75}" header="${margins.header ?? 0.3}" footer="${margins.footer ?? 0.3}"/>`
+        : DEFAULT_PAGE_MARGINS);
+    const setup = print?.pageSetup;
+    if (setup) {
+        // Excel keeps `firstPageNumber` as a dormant value until the user picks
+        // a first page number (`useFirstPageNumber="1"`); a bare number means
+        // "Auto", so the flag is written only when the model has it on.
+        const useFirst = setup.useFirstPageNumber === true ? true : undefined;
+        const setupAttrs = xmlNumAttr("paperSize", setup.paperSize) +
+            xmlNumAttr("scale", setup.scale) +
+            xmlNumAttr("firstPageNumber", setup.firstPageNumber) +
+            xmlNumAttr("fitToWidth", setup.fitToWidth) +
+            xmlNumAttr("fitToHeight", setup.fitToHeight) +
+            (setup.pageOrder ? ` pageOrder="${setup.pageOrder}"` : "") +
+            (setup.orientation ? ` orientation="${setup.orientation}"` : "") +
+            xmlBoolAttr("blackAndWhite", setup.blackAndWhite) +
+            xmlBoolAttr("draft", setup.draft) +
+            xmlBoolAttr("useFirstPageNumber", useFirst);
+        if (setupAttrs)
+            parts.push(`<pageSetup${setupAttrs}/>`);
+    }
+    const hf = print?.headerFooter;
+    if (hf && !isHeaderFooterEmpty(hf)) {
+        const hfAttrs = xmlBoolAttr("differentOddEven", hf.differentOddEven) +
+            xmlBoolAttr("differentFirst", hf.differentFirst) +
+            xmlBoolAttr("scaleWithDoc", hf.scaleWithDoc) +
+            xmlBoolAttr("alignWithMargins", hf.alignWithMargins);
+        const children = [
+            "oddHeader",
+            "oddFooter",
+            "evenHeader",
+            "evenFooter",
+            "firstHeader",
+            "firstFooter",
+        ]
+            .map((key) => {
+            const text = hf[key];
+            return typeof text === "string" && text
+                ? `<${key}>${escapeXmlText(text)}</${key}>`
+                : "";
+        })
+            .join("");
+        parts.push(children
+            ? `<headerFooter${hfAttrs}>${children}</headerFooter>`
+            : `<headerFooter${hfAttrs}/>`);
+    }
+    const breaks = (ids, max) => {
+        const valid = Array.from(new Set((ids ?? []).filter((id) => Number.isInteger(id) && id > 0))).sort((a, b) => a - b);
+        if (!valid.length)
+            return "";
+        return valid
+            .map((id) => `<brk id="${id}" max="${max}" man="1"/>`)
+            .join("");
+    };
+    const rowBrks = breaks(print?.rowBreaks, 16383);
+    if (rowBrks) {
+        const count = rowBrks.split("<brk ").length - 1;
+        parts.push(`<rowBreaks count="${count}" manualBreakCount="${count}">${rowBrks}</rowBreaks>`);
+    }
+    const colBrks = breaks(print?.columnBreaks, 1048575);
+    if (colBrks) {
+        const count = colBrks.split("<brk ").length - 1;
+        parts.push(`<colBreaks count="${count}" manualBreakCount="${count}">${colBrks}</colBreaks>`);
+    }
+    return parts.join("");
+};
 const buildFilterColumnsXml = (filterSpecs, range, rows, headerRow = true, totalRow = false, styleBuilder) => {
     if (!filterSpecs?.length)
         return "";
@@ -2420,15 +2760,26 @@ const gridRangeToRef = (range) => {
 };
 const groupEmbedsBySheet = (embeds) => {
     const result = new Map();
-    for (const embed of embeds ?? []) {
+    (embeds ?? []).forEach((embed, order) => {
         if (!embed.position?.overlayPosition)
-            continue;
+            return;
         if (embed.spec?.type !== "image")
-            continue;
+            return;
         const overlay = embed.position.overlayPosition;
+        const imageSpec = embed.spec;
+        const adjustments = {
+            crop: imageSpec.crop ?? undefined,
+            brightness: imageSpec.brightness ?? undefined,
+            contrast: imageSpec.contrast ?? undefined,
+            transparency: imageSpec.transparency ?? undefined,
+        };
         const placement = {
             kind: "embed",
-            imageUrl: embed.spec.imageUrl,
+            imageUrl: imageSpec.imageUrl,
+            adjustments: Object.values(adjustments).some((v) => v !== undefined)
+                ? adjustments
+                : undefined,
+            order,
             rowIndex: overlay.anchorCell.rowIndex,
             columnIndex: overlay.anchorCell.columnIndex,
             offsetX: overlay.offsetXPixels ?? 0,
@@ -2439,19 +2790,20 @@ const groupEmbedsBySheet = (embeds) => {
         const list = result.get(embed.position.sheetId) ?? [];
         list.push(placement);
         result.set(embed.position.sheetId, list);
-    }
+    });
     return result;
 };
 const groupTextBoxesBySheet = (embeds) => {
     const result = new Map();
-    for (const embed of embeds ?? []) {
+    (embeds ?? []).forEach((embed, order) => {
         if (!embed.position?.overlayPosition)
-            continue;
+            return;
         if (embed.spec?.type !== "textbox")
-            continue;
+            return;
         const overlay = embed.position.overlayPosition;
         const placement = {
             textBox: embed,
+            order,
             rowIndex: overlay.anchorCell.rowIndex,
             columnIndex: overlay.anchorCell.columnIndex,
             offsetX: overlay.offsetXPixels ?? 0,
@@ -2462,19 +2814,144 @@ const groupTextBoxesBySheet = (embeds) => {
         const list = result.get(embed.position.sheetId) ?? [];
         list.push(placement);
         result.set(embed.position.sheetId, list);
-    }
+    });
     return result;
 };
+/** Form-control embeds (`spec.type === "formControl"`) by sheet, in host order. */
+const groupFormControlsBySheet = (embeds) => {
+    const result = new Map();
+    (embeds ?? []).forEach((embed, order) => {
+        if (!embed.position?.overlayPosition)
+            return;
+        if (embed.spec?.type !== "formControl")
+            return;
+        const overlay = embed.position.overlayPosition;
+        const placement = {
+            shape: embed,
+            order,
+            rowIndex: overlay.anchorCell.rowIndex,
+            columnIndex: overlay.anchorCell.columnIndex,
+            offsetX: overlay.offsetXPixels ?? 0,
+            offsetY: overlay.offsetYPixels ?? 0,
+            width: overlay.widthPixels ?? 120,
+            height: overlay.heightPixels ?? 20,
+        };
+        const list = result.get(embed.position.sheetId) ?? [];
+        list.push(placement);
+        result.set(embed.position.sheetId, list);
+    });
+    return result;
+};
+/**
+ * Write a sheet's form controls: one ctrlProp part + sheet relationship per
+ * control, the `<controls>` worksheet element, and the VML shapes Excel
+ * draws them with (merged into the sheet's `vmlDrawing` alongside notes).
+ */
+const buildSheetFormControls = ({ sheet, controls, relationships, ctrlProps, zIndexStart, reservedShapeIds, }) => {
+    if (!controls.length)
+        return { controlsXml: "", vmlShapes: [] };
+    const controlElements = [];
+    const vmlShapes = [];
+    // Excel numbers notes and form-control shapes from one per-sheet counter
+    // (1025 upward); a control that arrived with its own id keeps it unless it
+    // collides with a note shape or another control.
+    const usedShapeIds = new Set(reservedShapeIds);
+    let nextShapeId = 1025;
+    const allocateShapeId = (wanted) => {
+        if (wanted && Number.isInteger(wanted) && !usedShapeIds.has(wanted)) {
+            usedShapeIds.add(wanted);
+            return wanted;
+        }
+        while (usedShapeIds.has(nextShapeId))
+            nextShapeId += 1;
+        usedShapeIds.add(nextShapeId);
+        return nextShapeId++;
+    };
+    const sumSizes = (count, getSize) => {
+        let total = 0;
+        for (let index = 0; index < count; index++)
+            total += getSize(index);
+        return total;
+    };
+    controls.forEach((placement, position) => {
+        const spec = placement.shape.spec;
+        const fromRow = Math.max(0, placement.rowIndex - 1);
+        const fromColumn = Math.max(0, placement.columnIndex - 1);
+        const offsetX = Math.max(0, placement.offsetX ?? 0);
+        const offsetY = Math.max(0, placement.offsetY ?? 0);
+        const widthPx = Math.max(5, placement.width ?? 120);
+        const heightPx = Math.max(5, placement.height ?? 20);
+        const columnSize = (index) => getColumnWidthPx(sheet, index, true);
+        const rowSize = (index) => getRowHeightPx(sheet, index, true);
+        const toColumn = resolveAnchorEndpoint({
+            startIndex: fromColumn,
+            startOffset: offsetX,
+            span: widthPx,
+            getSize: columnSize,
+        });
+        const toRow = resolveAnchorEndpoint({
+            startIndex: fromRow,
+            startOffset: offsetY,
+            span: heightPx,
+            getSize: rowSize,
+        });
+        const partIndex = ctrlProps.parts.length + 1;
+        const path = `xl/ctrlProps/ctrlProp${partIndex}.xml`;
+        ctrlProps.parts.push({ path, xml: buildCtrlPropXml(spec) });
+        const relId = relationships.add(CTRL_PROP_REL_TYPE, `../ctrlProps/ctrlProp${partIndex}.xml`);
+        const shapeId = allocateShapeId(spec.shapeId);
+        controlElements.push(buildControlElementXml({
+            spec,
+            relId,
+            shapeId,
+            from: {
+                col: fromColumn,
+                colOff: offsetX * EMUS_PER_PIXEL,
+                row: fromRow,
+                rowOff: offsetY * EMUS_PER_PIXEL,
+            },
+            to: {
+                col: toColumn.index,
+                colOff: toColumn.offset * EMUS_PER_PIXEL,
+                row: toRow.index,
+                rowOff: toRow.offset * EMUS_PER_PIXEL,
+            },
+        }));
+        vmlShapes.push(buildFormControlVmlShape({
+            spec,
+            shapeId,
+            zIndex: zIndexStart + position + 1,
+            geometry: {
+                leftPx: sumSizes(fromColumn, columnSize) + offsetX,
+                topPx: sumSizes(fromRow, rowSize) + offsetY,
+                widthPx,
+                heightPx,
+                anchor: [
+                    fromColumn,
+                    Math.round(offsetX),
+                    fromRow,
+                    Math.round(offsetY),
+                    toColumn.index,
+                    Math.round(toColumn.offset),
+                    toRow.index,
+                    Math.round(toRow.offset),
+                ],
+            },
+        }));
+    });
+    return { controlsXml: buildControlsXml(controlElements), vmlShapes };
+};
 const groupShapesBySheet = (embeds) => {
     const result = new Map();
-    for (const embed of embeds ?? []) {
+    (embeds ?? []).forEach((embed, order) => {
         if (!embed.position?.overlayPosition)
-            continue;
+            return;
         if (embed.spec?.type !== "shape")
-            continue;
+            return;
         const overlay = embed.position.overlayPosition;
         const placement = {
             shape: embed,
+            order,
             rowIndex: overlay.anchorCell.rowIndex,
             columnIndex: overlay.anchorCell.columnIndex,
             offsetX: overlay.offsetXPixels ?? 0,
@@ -2485,7 +2962,7 @@ const groupShapesBySheet = (embeds) => {
         const list = result.get(embed.position.sheetId) ?? [];
         list.push(placement);
         result.set(embed.position.sheetId, list);
-    }
+    });
     return result;
 };
 const groupChartsBySheet = (charts) => {
@@ -3077,7 +3554,7 @@ const buildConditionalFormattingRuleXml = ({ rule, styleBuilder, priority, baseC
         rules.push(dataBarXml);
     return rules.length ? rules : undefined;
 };
-const buildDrawingParts = async ({ placements, textBoxes, shapes = [], startImageIndex, startChartIndex, charts, slicers, sheet, sheetNameById, }) => {
+const buildDrawingParts = async ({ placements, textBoxes, shapes = [], startImageIndex, startChartIndex, startChartExIndex = 1, charts, slicers, sheet, sheetNameById, }) => {
     if (!placements.length &&
         !textBoxes.length &&
         !shapes.length &&
@@ -3089,10 +3566,27 @@ const buildDrawingParts = async ({ placements, textBoxes, shapes = [], startImag
     const media = [];
     let imageIndex = startImageIndex;
     let chartIndex = startChartIndex;
+    let chartExIndex = startChartExIndex;
     let pictureId = 1;
     let frameId = 1;
     const chartEntries = [];
+    const chartExEntries = [];
     for (const placement of charts) {
+        if (isChartExType(placement.chart.spec.chartType)) {
+            // Treemap / sunburst live in a chartex part with an mc:AlternateContent anchor.
+            const chartExXml = buildChartExXml(placement.chart, sheetNameById);
+            if (!chartExXml)
+                continue;
+            const relId = relationships.add(CHART_EX_REL_TYPE, `../charts/chartEx${chartExIndex}.xml`);
+            anchors.push(createChartAnchor({ sheet, placement, relId, frameId, chartEx: true }));
+            chartExEntries.push({
+                path: `xl/charts/chartEx${chartExIndex}.xml`,
+                xml: chartExXml,
+            });
+            chartExIndex += 1;
+            frameId += 1;
+            continue;
+        }
         const chartXml = buildChartXml(placement.chart, sheetNameById);
         if (!chartXml)
             continue;
@@ -3118,20 +3612,32 @@ const buildDrawingParts = async ({ placements, textBoxes, shapes = [], startImag
         }));
         frameId += 1;
     }
+    // Embeds (text boxes, shapes, images) keep the host's `embeds` order in the
+    // drawing part — anchor order IS Excel's z-order, so an image drawn over a
+    // shape must be emitted after it regardless of kind. Placements without an
+    // order (in-cell images) go last, in their own order.
+    const embedAnchors = [];
+    const orderOf = (order) => order ?? Number.MAX_SAFE_INTEGER;
     for (const placement of textBoxes) {
-        anchors.push(createTextBoxAnchor({
-            sheet,
-            placement,
-            frameId,
-        }));
+        embedAnchors.push({
+            order: orderOf(placement.order),
+            xml: createTextBoxAnchor({
+                sheet,
+                placement,
+                frameId,
+            }),
+        });
         frameId += 1;
     }
     for (const placement of shapes) {
-        anchors.push(createShapeAnchor({
-            sheet,
-            placement,
-            frameId,
-        }));
+        embedAnchors.push({
+            order: orderOf(placement.order),
+            xml: createShapeAnchor({
+                sheet,
+                placement,
+                frameId,
+            }),
+        });
         frameId += 1;
     }
     for (const placement of placements) {
@@ -3148,23 +3654,31 @@ const buildDrawingParts = async ({ placements, textBoxes, shapes = [], startImag
             extension: buffer.extension,
         });
         const relId = relationships.add(IMAGE_REL_TYPE, `../media/image${imageIndex}.${buffer.extension}`);
-        anchors.push(createTwoCellAnchor({
-            sheet,
-            placement,
-            relId,
-            pictureId,
-        }));
+        embedAnchors.push({
+            order: orderOf(placement.order),
+            xml: createTwoCellAnchor({
+                sheet,
+                placement,
+                relId,
+                pictureId,
+            }),
+        });
         imageIndex += 1;
         pictureId += 1;
     }
+    embedAnchors.sort((a, b) => a.order - b.order);
+    for (const entry of embedAnchors)
+        anchors.push(entry.xml);
     const drawingXml = `${XML_DECLARATION}<xdr:wsDr xmlns:xdr="http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="${REL_NS}">${anchors.join("")}</xdr:wsDr>`;
     return {
         xml: drawingXml,
         relsXml: relationships.toXml(),
         media,
         charts: chartEntries,
+        chartExs: chartExEntries,
         nextImageIndex: imageIndex,
         nextChartIndex: chartIndex,
+        nextChartExIndex: chartExIndex,
     };
 };
 const createTwoCellAnchor = ({ placement, relId, pictureId, sheet, }) => {
@@ -3190,9 +3704,55 @@ const createTwoCellAnchor = ({ placement, relId, pictureId, sheet, }) => {
     });
     const fromXml = `<xdr:from><xdr:col>${fromColumn}</xdr:col><xdr:colOff>${Math.round(offsetX * EMUS_PER_PIXEL)}</xdr:colOff><xdr:row>${fromRow}</xdr:row><xdr:rowOff>${Math.round(offsetY * EMUS_PER_PIXEL)}</xdr:rowOff></xdr:from>`;
     const toXml = `<xdr:to><xdr:col>${toColumn.index}</xdr:col><xdr:colOff>${Math.round(toColumn.offset * EMUS_PER_PIXEL)}</xdr:colOff><xdr:row>${toRow.index}</xdr:row><xdr:rowOff>${Math.round(toRow.offset * EMUS_PER_PIXEL)}</xdr:rowOff></xdr:to>`;
-    return `<xdr:twoCellAnchor editAs="oneCell">${fromXml}${toXml}<xdr:pic><xdr:nvPicPr><xdr:cNvPr id="${pictureId}" name="Picture ${pictureId}"/><xdr:cNvPicPr/></xdr:nvPicPr><xdr:blipFill><a:blip r:embed="${relId}"/><a:stretch><a:fillRect/></a:stretch></xdr:blipFill><xdr:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="${Math.round(widthPx * EMUS_PER_PIXEL)}" cy="${Math.round(heightPx * EMUS_PER_PIXEL)}"/></a:xfrm><a:prstGeom prst="rect"><a:avLst/></a:prstGeom></xdr:spPr></xdr:pic><xdr:clientData/></xdr:twoCellAnchor>`;
+    const { blipChildren, srcRectXml } = buildPictureAdjustmentsXml(placement.adjustments);
+    const blipXml = blipChildren
+        ? `<a:blip r:embed="${relId}">${blipChildren}</a:blip>`
+        : `<a:blip r:embed="${relId}"/>`;
+    return `<xdr:twoCellAnchor editAs="oneCell">${fromXml}${toXml}<xdr:pic><xdr:nvPicPr><xdr:cNvPr id="${pictureId}" name="Picture ${pictureId}"/><xdr:cNvPicPr/></xdr:nvPicPr><xdr:blipFill>${blipXml}${srcRectXml}<a:stretch><a:fillRect/></a:stretch></xdr:blipFill><xdr:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="${Math.round(widthPx * EMUS_PER_PIXEL)}" cy="${Math.round(heightPx * EMUS_PER_PIXEL)}"/></a:xfrm><a:prstGeom prst="rect"><a:avLst/></a:prstGeom></xdr:spPr></xdr:pic><xdr:clientData/></xdr:twoCellAnchor>`;
 };
-const createChartAnchor = ({ placement, relId, frameId, sheet, }) => {
+/** Fraction (0…1) → DrawingML per-mille percent (100000 = 100%). */
+const fractionToPct = (value) => Math.round(Math.max(-1, Math.min(1, value)) * 100000);
+/**
+ * `<a:blip>` children (`<a:alphaModFix>`, `<a:lum>`) and the `<a:srcRect>`
+ * sibling for an image's picture-format adjustments; both empty when the
+ * spec carries none.
+ */
+const buildPictureAdjustmentsXml = (adjustments) => {
+    if (!adjustments)
+        return { blipChildren: "", srcRectXml: "" };
+    let blipChildren = "";
+    const { transparency, brightness, contrast, crop } = adjustments;
+    if (typeof transparency === "number" && transparency > 0) {
+        blipChildren += `<a:alphaModFix amt="${fractionToPct(1 - Math.min(1, transparency))}"/>`;
+    }
+    const hasBrightness = typeof brightness === "number" && brightness !== 0;
+    const hasContrast = typeof contrast === "number" && contrast !== 0;
+    if (hasBrightness || hasContrast) {
+        blipChildren += `<a:lum${hasBrightness ? ` bright="${fractionToPct(brightness)}"` : ""}${hasContrast ? ` contrast="${fractionToPct(contrast)}"` : ""}/>`;
+    }
+    let srcRectXml = "";
+    if (crop) {
+        const edges = ["l", "t", "r", "b"]
+            .map((edge) => {
+            const value = {
+                l: crop.left,
+                t: crop.top,
+                r: crop.right,
+                b: crop.bottom,
+            }[edge];
+            // Negative edges are Excel's "out-crop" (padding around the
+            // bitmap) and round-trip like positive ones.
+            return typeof value === "number" && Number.isFinite(value) && value !== 0
+                ? ` ${edge}="${fractionToPct(value)}"`
+                : "";
+        })
+            .join("");
+        if (edges)
+            srcRectXml = `<a:srcRect${edges}/>`;
+    }
+    return { blipChildren, srcRectXml };
+};
+const createChartAnchor = ({ placement, relId, frameId, sheet, chartEx = false, }) => {
     const fromRow = Math.max(0, placement.rowIndex - 1);
     const fromColumn = Math.max(0, placement.columnIndex - 1);
     const offsetX = Math.max(0, placement.offsetX ?? 0);
@@ -3213,6 +3773,14 @@ const createChartAnchor = ({ placement, relId, frameId, sheet, }) => {
     });
     const fromXml = `<xdr:from><xdr:col>${fromColumn}</xdr:col><xdr:colOff>${Math.round(offsetX * EMUS_PER_PIXEL)}</xdr:colOff><xdr:row>${fromRow}</xdr:row><xdr:rowOff>${Math.round(offsetY * EMUS_PER_PIXEL)}</xdr:rowOff></xdr:from>`;
     const toXml = `<xdr:to><xdr:col>${toColumn.index}</xdr:col><xdr:colOff>${Math.round(toColumn.offset * EMUS_PER_PIXEL)}</xdr:colOff><xdr:row>${toRow.index}</xdr:row><xdr:rowOff>${Math.round(toRow.offset * EMUS_PER_PIXEL)}</xdr:rowOff></xdr:to>`;
+    if (chartEx) {
+        return `<xdr:twoCellAnchor>${fromXml}${toXml}${buildChartExGraphicFrameXml({
+            relId,
+            frameId,
+            widthEmu: Math.round(widthPx * EMUS_PER_PIXEL),
+            heightEmu: Math.round(heightPx * EMUS_PER_PIXEL),
+        })}<xdr:clientData/></xdr:twoCellAnchor>`;
+    }
     return `<xdr:twoCellAnchor>${fromXml}${toXml}<xdr:graphicFrame><xdr:nvGraphicFramePr><xdr:cNvPr id="${frameId}" name="Chart ${frameId}"/><xdr:cNvGraphicFramePr/></xdr:nvGraphicFramePr><xdr:xfrm><a:off x="0" y="0"/><a:ext cx="${Math.round(widthPx * EMUS_PER_PIXEL)}" cy="${Math.round(heightPx * EMUS_PER_PIXEL)}"/></xdr:xfrm><a:graphic><a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/chart"><c:chart xmlns:c="http://schemas.openxmlformats.org/drawingml/2006/chart" xmlns:r="${REL_NS}" r:id="${relId}"/></a:graphicData></a:graphic></xdr:graphicFrame><xdr:clientData/></xdr:twoCellAnchor>`;
 };
 const createSlicerAnchor = ({ placement, frameId, sheet, }) => {
@@ -3857,7 +4425,10 @@ const buildWorkbookXml = (sheets, sheetRelIds, sheetNames, namedRanges, iterativ
     sheets.forEach((sheet, index) => {
         sheetNameById.set(sheet.sheetId ?? index + 1, sheetNames[index]);
     });
-    const definedNamesXml = buildDefinedNamesXml(namedRanges, sheetNameById);
+    const definedNamesXml = buildDefinedNamesXml(namedRanges, sheetNameById, sheets.map((sheet, index) => ({
+        sheetName: sheetNames[index] ?? `Sheet${index + 1}`,
+        printSettings: sheet.printSettings,
+    })));
     const calcPrXml = buildCalcPrXml(iterativeCalculationOptions);
     const slicerCachesXml = buildWorkbookSlicerCachesXml(slicerCacheRelIds);
     // Phase D2 — <pivotCaches> element. Each <pivotCache> pairs a
@@ -3886,12 +4457,48 @@ const buildWorkbookXml = (sheets, sheetRelIds, sheetNames, namedRanges, iterativ
         : `<workbookPr/>`;
     return `${XML_DECLARATION}<workbook xmlns="${WORKSHEET_NS}" xmlns:r="${REL_NS}">${workbookPrXml}${calcPrXml}<bookViews><workbookView activeTab="0" firstSheet="0"/></bookViews><sheets>${sheetEntries}</sheets>${definedNamesXml}${externalReferencesXml}${pivotCachesXml}${slicerCachesXml}</workbook>`;
 };
-const buildDefinedNamesXml = (namedRanges, sheetNameById) => {
-    if (!namedRanges?.length)
-        return "";
+const buildDefinedNamesXml = (namedRanges, sheetNameById, printScopes = []) => {
     const entries = [];
-    for (const namedRange of namedRanges) {
-        if (!namedRange?.name)
+    // The builtin print names are sheet-scoped (`localSheetId` = position in
+    // `<sheets>`); they come from `sheet.printSettings`, never from
+    // `namedRanges` (a global `_xlnm.Print_Area` makes Excel repair the file).
+    // Documents imported before `printSettings` existed still carry the print
+    // area as a `_xlnm.Print_Area` named range on the sheet; it is converted
+    // to the sheet-scoped name here unless the sheet already has a print area.
+    const sheetIndexByName = new Map(printScopes.map(({ sheetName }, index) => [sheetName, index]));
+    const legacyPrintAreas = new Map();
+    for (const namedRange of namedRanges ?? []) {
+        if (namedRange?.name !== PRINT_AREA_NAME || !namedRange.range?.sheetId) {
+            continue;
+        }
+        const sheetName = sheetNameById.get(namedRange.range.sheetId);
+        const index = sheetName ? sheetIndexByName.get(sheetName) : undefined;
+        if (index == null)
+            continue;
+        legacyPrintAreas.set(index, [
+            ...(legacyPrintAreas.get(index) ?? []),
+            namedRange.range,
+        ]);
+    }
+    printScopes.forEach(({ sheetName, printSettings }, index) => {
+        const printArea = printSettings?.printArea?.length
+            ? printSettings.printArea
+            : legacyPrintAreas.get(index);
+        const area = printArea?.length
+            ? buildPrintAreaFormula(sheetName, printArea)
+            : undefined;
+        if (area) {
+            entries.push(`<definedName name="${PRINT_AREA_NAME}" localSheetId="${index}">${escapeXmlText(area)}</definedName>`);
+        }
+        const titles = printSettings?.printTitles
+            ? buildPrintTitlesFormula(sheetName, printSettings.printTitles)
+            : undefined;
+        if (titles) {
+            entries.push(`<definedName name="${PRINT_TITLES_NAME}" localSheetId="${index}">${escapeXmlText(titles)}</definedName>`);
+        }
+    });
+    for (const namedRange of namedRanges ?? []) {
+        if (!namedRange?.name || isBuiltinPrintName(namedRange.name))
             continue;
         const hiddenAttr = namedRange.hidden ? ` hidden="1"` : "";
         if (namedRange.range?.sheetId) {
@@ -3993,7 +4600,7 @@ const buildWorkbookRelationships = (sheetCount, slicerCacheCount = 0, externalLi
         slicerCacheRelationshipIds: slicerCacheRelIds,
     };
 };
-const buildContentTypesXml = ({ sheetCount, tableCount, drawingSheets, mediaExtensions, chartCount, slicerCount = 0, slicerCacheCount = 0, pivotTableCount = 0, pivotCacheCount = 0, commentsSheets = [], threadedCommentsSheets = [], hasPersons = false, externalLinkCount = 0, }) => {
+const buildContentTypesXml = ({ sheetCount, tableCount, drawingSheets, mediaExtensions, chartCount, chartExCount = 0, slicerCount = 0, slicerCacheCount = 0, pivotTableCount = 0, pivotCacheCount = 0, commentsSheets = [], threadedCommentsSheets = [], hasPersons = false, externalLinkCount = 0, hasVmlDrawings = false, ctrlPropCount = 0, }) => {
     const sheetOverrides = Array.from({ length: sheetCount }, (_, index) => {
         return `<Override PartName="/xl/worksheets/sheet${index + 1}.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/>`;
     }).join("");
@@ -4006,6 +4613,9 @@ const buildContentTypesXml = ({ sheetCount, tableCount, drawingSheets, mediaExte
     const chartOverrides = Array.from({ length: chartCount }, (_, index) => {
         return `<Override PartName="/xl/charts/chart${index + 1}.xml" ContentType="application/vnd.openxmlformats-officedocument.drawingml.chart+xml"/>`;
     }).join("");
+    const chartExOverrides = Array.from({ length: chartExCount }, (_, index) => {
+        return `<Override PartName="/xl/charts/chartEx${index + 1}.xml" ContentType="${CHART_EX_CONTENT_TYPE}"/>`;
+    }).join("");
     const slicerOverrides = Array.from({ length: slicerCount }, (_, index) => {
         return `<Override PartName="/xl/slicers/slicer${index + 1}.xml" ContentType="application/vnd.ms-excel.slicer+xml"/>`;
     }).join("");
@@ -4030,10 +4640,11 @@ const buildContentTypesXml = ({ sheetCount, tableCount, drawingSheets, mediaExte
     const mediaDefaults = mediaExtensions
         .map((extension) => `<Default Extension="${extension}" ContentType="image/${extension}"/>`)
         .join("");
-    const vmlDefault = commentsSheets.length
+    const vmlDefault = hasVmlDrawings || commentsSheets.length
         ? `<Default Extension="vml" ContentType="application/vnd.openxmlformats-officedocument.vmlDrawing"/>`
         : "";
-    return `${XML_DECLARATION}<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/>${vmlDefault}${mediaDefaults}<Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/>${sheetOverrides}${tableOverrides}${drawingOverrides}${chartOverrides}${slicerOverrides}${slicerCacheOverrides}${pivotTableOverrides}${pivotCacheOverrides}${externalLinkOverrides}${commentsOverrides}${threadedCommentsOverrides}${personOverride}<Override PartName="/xl/theme/theme1.xml" ContentType="application/vnd.openxmlformats-officedocument.theme+xml"/><Override PartName="/xl/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"/><Override PartName="/xl/sharedStrings.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml"/><Override PartName="/docProps/core.xml" ContentType="application/vnd.openxmlformats-package.core-properties+xml"/><Override PartName="/docProps/app.xml" ContentType="application/vnd.openxmlformats-officedocument.extended-properties+xml"/></Types>`;
+    const ctrlPropOverrides = Array.from({ length: ctrlPropCount }, (_, index) => `<Override PartName="/xl/ctrlProps/ctrlProp${index + 1}.xml" ContentType="${CTRL_PROP_CONTENT_TYPE}"/>`).join("");
+    return `${XML_DECLARATION}<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/>${vmlDefault}${mediaDefaults}<Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/>${sheetOverrides}${tableOverrides}${drawingOverrides}${chartOverrides}${chartExOverrides}${slicerOverrides}${slicerCacheOverrides}${pivotTableOverrides}${pivotCacheOverrides}${externalLinkOverrides}${ctrlPropOverrides}${commentsOverrides}${threadedCommentsOverrides}${personOverride}<Override PartName="/xl/theme/theme1.xml" ContentType="application/vnd.openxmlformats-officedocument.theme+xml"/><Override PartName="/xl/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"/><Override PartName="/xl/sharedStrings.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml"/><Override PartName="/docProps/core.xml" ContentType="application/vnd.openxmlformats-package.core-properties+xml"/><Override PartName="/docProps/app.xml" ContentType="application/vnd.openxmlformats-officedocument.extended-properties+xml"/></Types>`;
 };
 const buildRootRelationshipsXml = () => {
     return `${XML_DECLARATION}<Relationships xmlns="${PACKAGE_REL_NS}"><Relationship Id="rId1" Type="${REL_NS}/officeDocument" Target="xl/workbook.xml"/><Relationship Id="rId2" Type="${REL_NS}/extended-properties" Target="docProps/app.xml"/><Relationship Id="rId3" Type="${REL_NS}/core-properties" Target="docProps/core.xml"/></Relationships>`;