@rowsncolumns/toolkit 24.4.1 → 24.4.3

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

@@ -4,16 +4,18 @@ import { zipSync } from "fflate";
 import { omitInvalidDataValidationError } from "../invalid-data-validation";
 import { buildAutoFilterConditionXml } from "../../autofilter-condition";
 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";
@@ -30,9 +32,9 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
     var sortedSheets, sharedStrings, personRegistry, styleBuilder, exportableTables, tableIdMap, preparedTables, embedsBySheet, textBoxesBySheet, shapesBySheet, chartsBySheet, remappedSlicers, slicersBySheet, workbookSheetNames, sheetNameById, dataValidationsById, globalSlicerIndex, slicerCacheEntries, slicerEntries, globalPivotIndex, pivotCacheEntries, pivotCacheRelsEntries, pivotTableEntries, pivotTableRelsEntries, pivotsByTargetSheet, pivotTables_1, pivotTables_1_1, p, sid, list, workbookPivotCacheRefs, worksheetEntries, _d, workbookRelationshipsXml, sheetRelationshipIds, slicerCacheRelationshipIds, pivotCacheRelationshipIds, externalLinkRelationshipIds, workbookXml, sharedStringsXml, rootRelationshipsXml, appXml, coreXml, stylesXml, themeXml, files, worksheetEntries_1, worksheetEntries_1_1, entry, personsXml, preparedTables_1, preparedTables_1_1, table, rows, tableXml, globalImageIndex, globalChartIndex, drawingSheets, imageExtensions, chartEntries, worksheetEntries_2, worksheetEntries_2_1, entry, placements, textBoxesForSheet, shapesForSheet, chartsForSheet, slicersForSheet, drawingParts, _e, _f, media, _g, _h, chartEntry, e_1_1, chartEntries_1, chartEntries_1_1, chartEntry, slicerCacheEntries_1, slicerCacheEntries_1_1, slicerCacheEntry, slicerEntries_1, slicerEntries_1_1, slicerEntry, pivotCacheEntries_1, pivotCacheEntries_1_1, cacheEntry, pivotCacheRelsEntries_1, pivotCacheRelsEntries_1_1, cacheRels, pivotTableEntries_1, pivotTableEntries_1_1, tableEntry, pivotTableRelsEntries_1, pivotTableRelsEntries_1_1, tableRels, i, link, linkPath, relsPath, commentsSheets, threadedCommentsSheets, contentTypesXml, zipBytes;
     var e_2, _j, e_3, _k, e_4, _l, e_1, _m, e_5, _o, e_6, _p, e_7, _q, e_8, _s, e_9, _t, e_10, _u, e_11, _v, e_12, _w, e_13, _x;
     var _y, _z, _0, _1, _2, _3;
-    var _conditionalFormats = _b.conditionalFormats, _dataValidations = _b.dataValidations, sheets = _b.sheets, sheetData = _b.sheetData, sourceSharedStrings = _b.sharedStrings, _4 = _b.tables, _tables = _4 === void 0 ? [] : _4, cellXfs = _b.cellXfs, theme = _b.theme, defaultFont = _b.defaultFont, _5 = _b.embeds, embeds = _5 === void 0 ? [] : _5, _6 = _b.charts, charts = _6 === void 0 ? [] : _6, _7 = _b.slicers, slicers = _7 === void 0 ? [] : _7, _8 = _b.pivotTables, pivotTables = _8 === void 0 ? [] : _8, _9 = _b.externalLinks, externalLinks = _9 === void 0 ? [] : _9, _10 = _b.namedRanges, namedRanges = _10 === void 0 ? [] : _10, namedCellStyles = _b.namedCellStyles, customTableStyles = _b.customTableStyles, iterativeCalculationOptions = _b.iterativeCalculationOptions, ignoreFormulaPatterns = _b.ignoreFormulaPatterns, citations = _b.citations, comments = _b.comments, password = _b.password, locale = _b.locale, _11 = _b.use1904, use1904 = _11 === void 0 ? false : _11, properties = _b.properties, powerQuery = _b.powerQuery;
-    return __generator(this, function (_12) {
-        switch (_12.label) {
+    var _conditionalFormats = _b.conditionalFormats, _dataValidations = _b.dataValidations, sheets = _b.sheets, sheetData = _b.sheetData, sourceSharedStrings = _b.sharedStrings, _4 = _b.tables, _tables = _4 === void 0 ? [] : _4, cellXfs = _b.cellXfs, theme = _b.theme, defaultFont = _b.defaultFont, _5 = _b.embeds, embeds = _5 === void 0 ? [] : _5, _6 = _b.charts, charts = _6 === void 0 ? [] : _6, _7 = _b.slicers, slicers = _7 === void 0 ? [] : _7, _8 = _b.pivotTables, pivotTables = _8 === void 0 ? [] : _8, _9 = _b.externalLinks, externalLinks = _9 === void 0 ? [] : _9, _10 = _b.namedRanges, namedRanges = _10 === void 0 ? [] : _10, _11 = _b.protectedRanges, protectedRanges = _11 === void 0 ? [] : _11, namedCellStyles = _b.namedCellStyles, customTableStyles = _b.customTableStyles, iterativeCalculationOptions = _b.iterativeCalculationOptions, ignoreFormulaPatterns = _b.ignoreFormulaPatterns, citations = _b.citations, comments = _b.comments, password = _b.password, locale = _b.locale, _12 = _b.use1904, use1904 = _12 === void 0 ? false : _12, properties = _b.properties, powerQuery = _b.powerQuery;
+    return __generator(this, function (_13) {
+        switch (_13.label) {
             case 0:
                 sortedSheets = sortSheetsByIndex(sheets, true);
                 sharedStrings = new SharedStrings();
@@ -110,7 +112,7 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                 workbookPivotCacheRefs = [];
                 worksheetEntries = sortedSheets.map(function (sheet, index) {
                     var e_14, _a, e_15, _b;
-                    var _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+                    var _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _s, _t;
                     var rows = getRowsForSheet(sheetData, sheet.sheetId);
                     var sheetRelationships = new RelationshipsBuilder();
                     var sheetTables = preparedTables.filter(function (table) { return table.sheetId === sheet.sheetId; });
@@ -179,7 +181,7 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                     // this loop).
                     var sheetPivots = (_j = pivotsByTargetSheet.get(sheet.sheetId)) !== null && _j !== void 0 ? _j : [];
                     var _loop_1 = function (pivot) {
-                        var e_16, _q, e_17, _s, e_18, _t;
+                        var e_16, _u, e_17, _v, e_18, _w, e_19, _x, e_20, _y, e_21, _z;
                         var cacheIndex = globalPivotIndex;
                         var tableIndex = globalPivotIndex;
                         var sourceSheet = sortedSheets.find(function (s) { var _a; return s.sheetId === ((_a = pivot.source) === null || _a === void 0 ? void 0 : _a.sheetId); });
@@ -195,45 +197,89 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                             fieldIndex.set(name, fieldNameList.length);
                             fieldNameList.push(name);
                         };
+                        var calculatedNames = new Set(((_m = pivot.calculatedFields) !== null && _m !== void 0 ? _m : []).map(function (c) { return c.name; }));
                         try {
-                            for (var _u = (e_16 = void 0, __values((_m = pivot.rows) !== null && _m !== void 0 ? _m : [])), _v = _u.next(); !_v.done; _v = _u.next()) {
-                                var r = _v.value;
+                            for (var _0 = (e_16 = void 0, __values((_o = pivot.rows) !== null && _o !== void 0 ? _o : [])), _1 = _0.next(); !_1.done; _1 = _0.next()) {
+                                var r = _1.value;
                                 registerField(r.field);
                             }
                         }
                         catch (e_16_1) { e_16 = { error: e_16_1 }; }
                         finally {
                             try {
-                                if (_v && !_v.done && (_q = _u.return)) _q.call(_u);
+                                if (_1 && !_1.done && (_u = _0.return)) _u.call(_0);
                             }
                             finally { if (e_16) throw e_16.error; }
                         }
                         try {
-                            for (var _w = (e_17 = void 0, __values((_o = pivot.columns) !== null && _o !== void 0 ? _o : [])), _x = _w.next(); !_x.done; _x = _w.next()) {
-                                var c = _x.value;
+                            for (var _2 = (e_17 = void 0, __values((_p = pivot.columns) !== null && _p !== void 0 ? _p : [])), _3 = _2.next(); !_3.done; _3 = _2.next()) {
+                                var c = _3.value;
                                 registerField(c.field);
                             }
                         }
                         catch (e_17_1) { e_17 = { error: e_17_1 }; }
                         finally {
                             try {
-                                if (_x && !_x.done && (_s = _w.return)) _s.call(_w);
+                                if (_3 && !_3.done && (_v = _2.return)) _v.call(_2);
                             }
                             finally { if (e_17) throw e_17.error; }
                         }
                         try {
-                            for (var _y = (e_18 = void 0, __values((_p = pivot.values) !== null && _p !== void 0 ? _p : [])), _z = _y.next(); !_z.done; _z = _y.next()) {
-                                var v = _z.value;
-                                registerField(v.field);
+                            for (var _4 = (e_18 = void 0, __values((_q = pivot.values) !== null && _q !== void 0 ? _q : [])), _5 = _4.next(); !_5.done; _5 = _4.next()) {
+                                var v = _5.value;
+                                if (!calculatedNames.has(v.field))
+                                    registerField(v.field);
                             }
                         }
                         catch (e_18_1) { e_18 = { error: e_18_1 }; }
                         finally {
                             try {
-                                if (_z && !_z.done && (_t = _y.return)) _t.call(_y);
+                                if (_5 && !_5.done && (_w = _4.return)) _w.call(_4);
                             }
                             finally { if (e_18) throw e_18.error; }
                         }
+                        try {
+                            // 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 (var _6 = (e_19 = void 0, __values((_s = pivot.calculatedFields) !== null && _s !== void 0 ? _s : [])), _7 = _6.next(); !_7.done; _7 = _6.next()) {
+                                var c = _7.value;
+                                try {
+                                    for (var _8 = (e_20 = void 0, __values(calculatedFieldReferences(c.formula))), _9 = _8.next(); !_9.done; _9 = _8.next()) {
+                                        var ref = _9.value;
+                                        if (!calculatedNames.has(ref))
+                                            registerField(ref);
+                                    }
+                                }
+                                catch (e_20_1) { e_20 = { error: e_20_1 }; }
+                                finally {
+                                    try {
+                                        if (_9 && !_9.done && (_y = _8.return)) _y.call(_8);
+                                    }
+                                    finally { if (e_20) throw e_20.error; }
+                                }
+                            }
+                        }
+                        catch (e_19_1) { e_19 = { error: e_19_1 }; }
+                        finally {
+                            try {
+                                if (_7 && !_7.done && (_x = _6.return)) _x.call(_6);
+                            }
+                            finally { if (e_19) throw e_19.error; }
+                        }
+                        try {
+                            for (var _10 = (e_21 = void 0, __values((_t = pivot.calculatedFields) !== null && _t !== void 0 ? _t : [])), _11 = _10.next(); !_11.done; _11 = _10.next()) {
+                                var c = _11.value;
+                                registerField(c.name);
+                            }
+                        }
+                        catch (e_21_1) { e_21 = { error: e_21_1 }; }
+                        finally {
+                            try {
+                                if (_11 && !_11.done && (_z = _10.return)) _z.call(_10);
+                            }
+                            finally { if (e_21) throw e_21.error; }
+                        }
                         var cacheXml = buildPivotCacheDefinitionXml(pivot, sourceSheetName, fieldNameList);
                         var tableXml = buildPivotTableXml(pivot, cacheIndex, fieldIndex);
                         if (!cacheXml || !tableXml)
@@ -291,6 +337,7 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                         sheetData: sheetData,
                         sheets: sortedSheets,
                         locale: locale,
+                        protectedRanges: protectedRanges,
                     });
                     return {
                         index: index,
@@ -382,11 +429,11 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                 drawingSheets = [];
                 imageExtensions = new Set();
                 chartEntries = [];
-                _12.label = 1;
+                _13.label = 1;
             case 1:
-                _12.trys.push([1, 6, 7, 8]);
+                _13.trys.push([1, 6, 7, 8]);
                 worksheetEntries_2 = __values(worksheetEntries), worksheetEntries_2_1 = worksheetEntries_2.next();
-                _12.label = 2;
+                _13.label = 2;
             case 2:
                 if (!!worksheetEntries_2_1.done) return [3 /*break*/, 5];
                 entry = worksheetEntries_2_1.value;
@@ -413,7 +460,7 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                         sheetNameById: sheetNameById,
                     })];
             case 3:
-                drawingParts = _12.sent();
+                drawingParts = _13.sent();
                 if (!drawingParts)
                     return [3 /*break*/, 4];
                 files[entry.drawingPath] = encodeXml(drawingParts.xml);
@@ -450,13 +497,13 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                 globalImageIndex = drawingParts.nextImageIndex;
                 globalChartIndex = drawingParts.nextChartIndex;
                 drawingSheets.push(entry.index + 1);
-                _12.label = 4;
+                _13.label = 4;
             case 4:
                 worksheetEntries_2_1 = worksheetEntries_2.next();
                 return [3 /*break*/, 2];
             case 5: return [3 /*break*/, 8];
             case 6:
-                e_1_1 = _12.sent();
+                e_1_1 = _13.sent();
                 e_1 = { error: e_1_1 };
                 return [3 /*break*/, 8];
             case 7:
@@ -863,9 +910,9 @@ var getRowsForSheet = function (sheetData, sheetId) {
     return ((_d = (_b = (_a = sheetData[sheetId]) !== null && _a !== void 0 ? _a : sheetData[String(sheetId)]) !== null && _b !== void 0 ? _b : sheetData[Number(sheetId)]) !== null && _d !== void 0 ? _d : []);
 };
 var buildWorksheetXml = function (_a) {
-    var e_19, _b, e_20, _d, e_21, _e, e_22, _f, e_23, _g, e_24, _h;
+    var e_22, _b, e_23, _d, e_24, _e, e_25, _f, e_26, _g, e_27, _h;
     var _j, _k;
-    var sheet = _a.sheet, rows = _a.rows, sharedStrings = _a.sharedStrings, sourceSharedStrings = _a.sourceSharedStrings, cellXfs = _a.cellXfs, styleBuilder = _a.styleBuilder, tables = _a.tables, relationships = _a.relationships, drawingContext = _a.drawingContext, conditionalFormats = _a.conditionalFormats, dataValidationsById = _a.dataValidationsById, dataValidations = _a.dataValidations, ignoreFormulaPatterns = _a.ignoreFormulaPatterns, citations = _a.citations, comments = _a.comments, personRegistry = _a.personRegistry, slicerRelIds = _a.slicerRelIds, sheetData = _a.sheetData, sheets = _a.sheets, locale = _a.locale;
+    var sheet = _a.sheet, rows = _a.rows, sharedStrings = _a.sharedStrings, sourceSharedStrings = _a.sourceSharedStrings, cellXfs = _a.cellXfs, styleBuilder = _a.styleBuilder, tables = _a.tables, relationships = _a.relationships, drawingContext = _a.drawingContext, conditionalFormats = _a.conditionalFormats, dataValidationsById = _a.dataValidationsById, dataValidations = _a.dataValidations, ignoreFormulaPatterns = _a.ignoreFormulaPatterns, citations = _a.citations, comments = _a.comments, personRegistry = _a.personRegistry, slicerRelIds = _a.slicerRelIds, sheetData = _a.sheetData, sheets = _a.sheets, locale = _a.locale, protectedRanges = _a.protectedRanges;
     var tableNameMap = buildTableNameMap(tables);
     var bounds = {
         minRow: Number.POSITIVE_INFINITY,
@@ -900,12 +947,12 @@ var buildWorksheetXml = function (_a) {
                 }
             }
         }
-        catch (e_19_1) { e_19 = { error: e_19_1 }; }
+        catch (e_22_1) { e_22 = { error: e_22_1 }; }
         finally {
             try {
                 if (citations_1_1 && !citations_1_1.done && (_b = citations_1.return)) _b.call(citations_1);
             }
-            finally { if (e_19) throw e_19.error; }
+            finally { if (e_22) throw e_22.error; }
         }
     }
     if (dataValidations) {
@@ -915,7 +962,7 @@ var buildWorksheetXml = function (_a) {
                 if (!rule.ranges)
                     continue;
                 try {
-                    for (var _l = (e_21 = void 0, __values(rule.ranges)), _m = _l.next(); !_m.done; _m = _l.next()) {
+                    for (var _l = (e_24 = void 0, __values(rule.ranges)), _m = _l.next(); !_m.done; _m = _l.next()) {
                         var range = _m.value;
                         if (range.sheetId !== sheet.sheetId)
                             continue;
@@ -929,21 +976,21 @@ var buildWorksheetXml = function (_a) {
                         }
                     }
                 }
-                catch (e_21_1) { e_21 = { error: e_21_1 }; }
+                catch (e_24_1) { e_24 = { error: e_24_1 }; }
                 finally {
                     try {
                         if (_m && !_m.done && (_e = _l.return)) _e.call(_l);
                     }
-                    finally { if (e_21) throw e_21.error; }
+                    finally { if (e_24) throw e_24.error; }
                 }
             }
         }
-        catch (e_20_1) { e_20 = { error: e_20_1 }; }
+        catch (e_23_1) { e_23 = { error: e_23_1 }; }
         finally {
             try {
                 if (dataValidations_1_1 && !dataValidations_1_1.done && (_d = dataValidations_1.return)) _d.call(dataValidations_1);
             }
-            finally { if (e_20) throw e_20.error; }
+            finally { if (e_23) throw e_23.error; }
         }
     }
     // Pre-scan for valid shared-formula leaders in this sheet. The cell-emit
@@ -963,7 +1010,7 @@ var buildWorksheetXml = function (_a) {
         if (!Array.isArray(rowValues))
             continue;
         try {
-            for (var rowValues_1 = (e_22 = void 0, __values(rowValues)), rowValues_1_1 = rowValues_1.next(); !rowValues_1_1.done; rowValues_1_1 = rowValues_1.next()) {
+            for (var rowValues_1 = (e_25 = void 0, __values(rowValues)), rowValues_1_1 = rowValues_1.next(); !rowValues_1_1.done; rowValues_1_1 = rowValues_1.next()) {
                 var cell = rowValues_1_1.value;
                 var sf = cell === null || cell === void 0 ? void 0 : cell.sf;
                 if (sf && sf.ref && Number.isFinite(sf.si)) {
@@ -971,12 +1018,12 @@ var buildWorksheetXml = function (_a) {
                 }
             }
         }
-        catch (e_22_1) { e_22 = { error: e_22_1 }; }
+        catch (e_25_1) { e_25 = { error: e_25_1 }; }
         finally {
             try {
                 if (rowValues_1_1 && !rowValues_1_1.done && (_f = rowValues_1.return)) _f.call(rowValues_1);
             }
-            finally { if (e_22) throw e_22.error; }
+            finally { if (e_25) throw e_25.error; }
         }
     }
     for (var rowIndex = 1; rowIndex < maxRows; rowIndex++) {
@@ -1067,12 +1114,12 @@ var buildWorksheetXml = function (_a) {
                 commentsCollector.add(entry.address, entry.text, entry.author);
             }
         }
-        catch (e_23_1) { e_23 = { error: e_23_1 }; }
+        catch (e_26_1) { e_26 = { error: e_26_1 }; }
         finally {
             try {
                 if (_p && !_p.done && (_g = _o.return)) _g.call(_o);
             }
-            finally { if (e_23) throw e_23.error; }
+            finally { if (e_26) throw e_26.error; }
         }
         relationships.add(THREADED_COMMENT_REL_TYPE, "../threadedComments/threadedComment".concat(sheet.sheetId, ".xml"));
     }
@@ -1085,7 +1132,8 @@ var buildWorksheetXml = function (_a) {
         legacyDrawingXml = "<legacyDrawing r:id=\"".concat(legacyDrawingRelId, "\"/>");
     }
     var sheetDataXml = "<sheetData>".concat(rowXmlChunks.join(""), "</sheetData>");
-    var pageMargins = DEFAULT_PAGE_MARGINS;
+    var protectionXml = buildSheetProtectionXml(sheet, protectedRanges);
+    var printSettingsXml = buildPrintSettingsXml(sheet.printSettings);
     // Build row data map for sparkline detection
     var rowDataMap = {};
     for (var rowIndex = 1; rowIndex < maxRows; rowIndex++) {
@@ -1093,19 +1141,19 @@ var buildWorksheetXml = function (_a) {
         if (row === null || row === void 0 ? void 0 : row.values) {
             var rowValues = {};
             try {
-                for (var _q = (e_24 = void 0, __values(Object.entries(row.values))), _s = _q.next(); !_s.done; _s = _q.next()) {
+                for (var _q = (e_27 = void 0, __values(Object.entries(row.values))), _s = _q.next(); !_s.done; _s = _q.next()) {
                     var _t = __read(_s.value, 2), colIndex = _t[0], cell = _t[1];
                     if (cell) {
                         rowValues[parseInt(colIndex, 10)] = cell;
                     }
                 }
             }
-            catch (e_24_1) { e_24 = { error: e_24_1 }; }
+            catch (e_27_1) { e_27 = { error: e_27_1 }; }
             finally {
                 try {
                     if (_s && !_s.done && (_h = _q.return)) _h.call(_q);
                 }
-                finally { if (e_24) throw e_24.error; }
+                finally { if (e_27) throw e_27.error; }
             }
             if (Object.keys(rowValues).length > 0) {
                 rowDataMap[rowIndex] = rowValues;
@@ -1128,7 +1176,7 @@ var buildWorksheetXml = function (_a) {
         explicitDefaultColumnWidthPx > 0) {
         sheetFormatPrAttrs.push("defaultColWidth=\"".concat(columnPixelToChars(explicitDefaultColumnWidthPx).toFixed(2), "\""));
     }
-    var worksheetXml = "".concat(XML_DECLARATION, "<worksheet xmlns=\"").concat(WORKSHEET_NS, "\" xmlns:r=\"").concat(REL_NS, "\">").concat(sheetPrXml, "<dimension ref=\"").concat(dimension, "\"/>").concat(sheetViews, "<sheetFormatPr ").concat(sheetFormatPrAttrs.join(" "), "/>").concat(columnXml).concat(sheetDataXml).concat(basicFilterXml).concat(mergeXml).concat(conditionalFormattingXml).concat(dataValidationsXml).concat(hyperlinksXml).concat(pageMargins).concat(drawingXml).concat(legacyDrawingXml).concat(tablePartsXml).concat(extLstXml, "</worksheet>");
+    var worksheetXml = "".concat(XML_DECLARATION, "<worksheet xmlns=\"").concat(WORKSHEET_NS, "\" xmlns:r=\"").concat(REL_NS, "\">").concat(sheetPrXml, "<dimension ref=\"").concat(dimension, "\"/>").concat(sheetViews, "<sheetFormatPr ").concat(sheetFormatPrAttrs.join(" "), "/>").concat(columnXml).concat(sheetDataXml).concat(protectionXml).concat(basicFilterXml).concat(mergeXml).concat(conditionalFormattingXml).concat(dataValidationsXml).concat(hyperlinksXml).concat(printSettingsXml).concat(drawingXml).concat(legacyDrawingXml).concat(tablePartsXml).concat(extLstXml, "</worksheet>");
     return {
         xml: worksheetXml,
         relationshipsXml: relationships.toXml(),
@@ -1189,7 +1237,7 @@ var sanitizeIndex = function (value) {
     return Math.max(1, Math.floor(value));
 };
 var normalizeMergeRanges = function (ranges) {
-    var e_25, _a;
+    var e_28, _a;
     if (!(ranges === null || ranges === void 0 ? void 0 : ranges.length))
         return [];
     var sanitized = ranges
@@ -1231,12 +1279,12 @@ var normalizeMergeRanges = function (ranges) {
             _loop_3(merge);
         }
     }
-    catch (e_25_1) { e_25 = { error: e_25_1 }; }
+    catch (e_28_1) { e_28 = { error: e_28_1 }; }
     finally {
         try {
             if (sorted_1_1 && !sorted_1_1.done && (_a = sorted_1.return)) _a.call(sorted_1);
         }
-        finally { if (e_25) throw e_25.error; }
+        finally { if (e_28) throw e_28.error; }
     }
     return valid;
 };
@@ -1603,7 +1651,7 @@ var buildWorksheetRow = function (_a) {
     };
 };
 var buildCellXml = function (_a) {
-    var e_26, _b;
+    var e_29, _b;
     var _d, _e, _f, _g, _h, _j, _k, _l;
     var rowNumber = _a.rowNumber, columnIndex = _a.columnIndex, cell = _a.cell, sharedStrings = _a.sharedStrings, sourceSharedStrings = _a.sourceSharedStrings, cellXfs = _a.cellXfs, styleBuilder = _a.styleBuilder, onImage = _a.onImage, onHyperlink = _a.onHyperlink, dataValidationsById = _a.dataValidationsById, onDataValidation = _a.onDataValidation, tableNameMap = _a.tableNameMap, tables = _a.tables, ignoreFormulaPatterns = _a.ignoreFormulaPatterns, commentsCollector = _a.commentsCollector, onCommentThread = _a.onCommentThread, sheetId = _a.sheetId, sheetData = _a.sheetData, sheets = _a.sheets, locale = _a.locale, validSharedFormulaLeaders = _a.validSharedFormulaLeaders;
     var normalizedCell = cell;
@@ -1700,12 +1748,12 @@ var buildCellXml = function (_a) {
                     sheetIdByName_1.set(s.title, s.sheetId);
             }
         }
-        catch (e_26_1) { e_26 = { error: e_26_1 }; }
+        catch (e_29_1) { e_29 = { error: e_29_1 }; }
         finally {
             try {
                 if (sheets_1_1 && !sheets_1_1.done && (_b = sheets_1.return)) _b.call(sheets_1);
             }
-            finally { if (e_26) throw e_26.error; }
+            finally { if (e_29) throw e_29.error; }
         }
         // A real CellXfsRegistry so `SheetCell.assign` inside the derive
         // helper can resolve precedent cells whose `uf` is a `{ sid }` style
@@ -1942,7 +1990,7 @@ function isValidExcelDateSerial(value) {
     return value >= MIN_EXCEL_DATE_SERIAL && value <= MAX_EXCEL_DATE_SERIAL;
 }
 function rewriteTableNamesInFormula(formula, tableNameMap) {
-    var e_27, _a;
+    var e_30, _a;
     if (!(tableNameMap === null || tableNameMap === void 0 ? void 0 : tableNameMap.size))
         return formula;
     var normalized = formula;
@@ -1957,12 +2005,12 @@ function rewriteTableNamesInFormula(formula, tableNameMap) {
             normalized = normalized.replace(new RegExp("".concat(escaped, "(?=\\[)"), "g"), exportedName);
         }
     }
-    catch (e_27_1) { e_27 = { error: e_27_1 }; }
+    catch (e_30_1) { e_30 = { error: e_30_1 }; }
     finally {
         try {
             if (tableNameMap_1_1 && !tableNameMap_1_1.done && (_a = tableNameMap_1.return)) _a.call(tableNameMap_1);
         }
-        finally { if (e_27) throw e_27.error; }
+        finally { if (e_30) throw e_30.error; }
     }
     return normalized;
 }
@@ -2060,7 +2108,9 @@ function rewriteStructuredReferenceFormula(formula, tableNameMap, tables, rowNum
 }
 function sanitizeFormulaText(formula) {
     var 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)
@@ -2224,6 +2274,11 @@ var buildSheetViewsXml = function (sheet) {
         zoomScale !== 100) {
         attrs.push("zoomScale=\"".concat(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\"");
+    }
     var panes = [];
     var frozenRows = (_e = sheet.frozenRowCount) !== null && _e !== void 0 ? _e : 0;
     var frozenColumns = (_f = sheet.frozenColumnCount) !== null && _f !== void 0 ? _f : 0;
@@ -2355,7 +2410,7 @@ var buildRichRunProperties = function (format) {
  * style flag, but that's a cell-style concern, not a sharedString one.
  */
 var buildRichTextRuns = function (text, runs) {
-    var e_28, _a;
+    var e_31, _a;
     var sorted = __spreadArray([], __read(runs), false).sort(function (a, b) { return a.startIndex - b.startIndex; });
     var out = [];
     var cursor = 0;
@@ -2388,12 +2443,12 @@ var buildRichTextRuns = function (text, runs) {
                 cursor = end;
         }
     }
-    catch (e_28_1) { e_28 = { error: e_28_1 }; }
+    catch (e_31_1) { e_31 = { error: e_31_1 }; }
     finally {
         try {
             if (sorted_2_1 && !sorted_2_1.done && (_a = sorted_2.return)) _a.call(sorted_2);
         }
-        finally { if (e_28) throw e_28.error; }
+        finally { if (e_31) throw e_31.error; }
     }
     if (cursor < text.length) {
         emit(text.slice(cursor), "");
@@ -2414,7 +2469,7 @@ var buildSharedStringsXml = function (sharedStrings) {
     return "".concat(XML_DECLARATION, "<sst xmlns=\"").concat(WORKSHEET_NS, "\" count=\"").concat(sharedStrings.totalCount, "\" uniqueCount=\"").concat(sharedStrings.entries.length, "\">").concat(entries, "</sst>");
 };
 var buildTableNameMap = function (tables) {
-    var e_29, _a;
+    var e_32, _a;
     var _b;
     var map = new Map();
     try {
@@ -2426,12 +2481,12 @@ var buildTableNameMap = function (tables) {
             map.set(tableTitle, table.name);
         }
     }
-    catch (e_29_1) { e_29 = { error: e_29_1 }; }
+    catch (e_32_1) { e_32 = { error: e_32_1 }; }
     finally {
         try {
             if (tables_1_1 && !tables_1_1.done && (_a = tables_1.return)) _a.call(tables_1);
         }
-        finally { if (e_29) throw e_29.error; }
+        finally { if (e_32) throw e_32.error; }
     }
     return map;
 };
@@ -2439,7 +2494,7 @@ var buildTableNameMap = function (tables) {
 // whose box intersects another table on the same sheet. Drop both before
 // emitting so the workbook opens without "We found a problem" recovery prompts.
 var filterExportableTables = function (tables) {
-    var e_30, _a;
+    var e_33, _a;
     var _b;
     var isValidBox = function (range) {
         if (!range)
@@ -2482,12 +2537,12 @@ var filterExportableTables = function (tables) {
             _loop_4(table);
         }
     }
-    catch (e_30_1) { e_30 = { error: e_30_1 }; }
+    catch (e_33_1) { e_33 = { error: e_33_1 }; }
     finally {
         try {
             if (tables_2_1 && !tables_2_1.done && (_a = tables_2.return)) _a.call(tables_2);
         }
-        finally { if (e_30) throw e_30.error; }
+        finally { if (e_33) throw e_33.error; }
     }
     return result;
 };
@@ -2511,6 +2566,58 @@ var sanitizeTableName = function (name) {
     }
     return cleaned;
 };
+/**
+ * `SUBTOTAL()` function numbers (the 101+ "ignore hidden rows" family Excel
+ * writes into totals-row cells) → `totalsRowFunction`.
+ */
+var 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.
+ */
+var resolveTableColumnTotals = function (column, totalsCell) {
+    var _a;
+    if (column === null || column === void 0 ? void 0 : column.totalsRowLabel) {
+        return { totalsRowLabel: column.totalsRowLabel };
+    }
+    if (column === null || column === void 0 ? void 0 : column.totalsRowFunction) {
+        if (column.totalsRowFunction === "none") {
+            return undefined;
+        }
+        if (column.totalsRowFunction === "custom" && !column.totalsRowFormula) {
+            return undefined;
+        }
+        return {
+            totalsRowFunction: column.totalsRowFunction,
+            totalsRowFormula: (_a = column.totalsRowFormula) !== null && _a !== void 0 ? _a : undefined,
+        };
+    }
+    if (!totalsCell)
+        return undefined;
+    var formula = getExtendedValueFormula(getCellUserEnteredValue(totalsCell));
+    if (formula) {
+        var match = /^=?\s*SUBTOTAL\(\s*(\d{3})\s*,[^,]*\)\s*$/i.exec(formula);
+        var fn = match ? SUBTOTAL_TOTALS_ROW_FUNCTIONS[match[1]] : undefined;
+        return fn ? { totalsRowFunction: fn } : undefined;
+    }
+    var label = getExtendedValueString(getCellUserEnteredValue(totalsCell));
+    return label && label.trim() !== "" ? { totalsRowLabel: label } : undefined;
+};
 var buildTableXml = function (table, rows, sourceSharedStrings, styleBuilder) {
     var _a, _b, _d;
     var rangeRef = table.ref;
@@ -2558,9 +2665,10 @@ var buildTableXml = function (table, rows, sourceSharedStrings, styleBuilder) {
         // Fallback to table.columns name or generic name
         return (_f = (_e = (_d = table.columns) === null || _d === void 0 ? void 0 : _d[index]) === null || _e === void 0 ? void 0 : _e.name) !== null && _f !== void 0 ? _f : "Column".concat(index + 1);
     });
+    var totalsRowIndex = table.range.endRowIndex;
     var tableColumns = "<tableColumns count=\"".concat(columnCount, "\">").concat(columnNames
         .map(function (name, idx) {
-        var _a, _b;
+        var _a, _b, _d, _e, _f;
         var columnFormula = (_b = (_a = table.columns) === null || _a === void 0 ? void 0 : _a[idx]) === null || _b === void 0 ? void 0 : _b.formula;
         var normalizedFormula = columnFormula
             ? normalizeCalculatedColumnFormula(columnFormula, table)
@@ -2568,7 +2676,22 @@ var buildTableXml = function (table, rows, sourceSharedStrings, styleBuilder) {
         var formulaXml = normalizedFormula
             ? "<calculatedColumnFormula>".concat(escapeXmlText(stripFormula(normalizedFormula)), "</calculatedColumnFormula>")
             : "";
-        return "<tableColumn id=\"".concat(idx + 1, "\" name=\"").concat(escapeXmlAttr(name), "\">").concat(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.
+        var totals = resolveTableColumnTotals((_d = table.columns) === null || _d === void 0 ? void 0 : _d[idx], totalsRowCount > 0
+            ? (_f = (_e = rows[totalsRowIndex]) === null || _e === void 0 ? void 0 : _e.values) === null || _f === void 0 ? void 0 : _f[table.range.startColumnIndex + idx]
+            : undefined);
+        var totalsAttrs = (totals === null || totals === void 0 ? void 0 : totals.totalsRowLabel)
+            ? " totalsRowLabel=\"".concat(escapeXmlAttr(totals.totalsRowLabel), "\"")
+            : (totals === null || totals === void 0 ? void 0 : totals.totalsRowFunction)
+                ? " totalsRowFunction=\"".concat(totals.totalsRowFunction, "\"")
+                : "";
+        var totalsFormulaXml = (totals === null || totals === void 0 ? void 0 : totals.totalsRowFunction) === "custom" && totals.totalsRowFormula
+            ? "<totalsRowFormula>".concat(escapeXmlText(stripFormula(normalizeCalculatedColumnFormula(totals.totalsRowFormula, table))), "</totalsRowFormula>")
+            : "";
+        return "<tableColumn id=\"".concat(idx + 1, "\" name=\"").concat(escapeXmlAttr(name), "\"").concat(totalsAttrs, ">").concat(formulaXml).concat(totalsFormulaXml, "</tableColumn>");
     })
         .join(""), "</tableColumns>");
     var isBuiltInStyle = table.theme && /^TableStyle(Light|Medium|Dark)\d+$/.test(table.theme);
@@ -2618,8 +2741,130 @@ var buildWorksheetAutoFilterXml = function (sheet, rows, styleBuilder) {
     }
     return "<autoFilter ref=\"".concat(ref, "\"/>");
 };
+/** `CT_SheetProtection` boolean attributes in Excel's attribute order. */
+var 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`.
+ */
+var buildSheetProtectionElementXml = function (protection) {
+    var e_34, _a;
+    var attrs = [];
+    if (protection.algorithmName) {
+        attrs.push("algorithmName=\"".concat(escapeXmlAttr(protection.algorithmName), "\""));
+    }
+    if (protection.hashValue) {
+        attrs.push("hashValue=\"".concat(escapeXmlAttr(protection.hashValue), "\""));
+    }
+    if (protection.saltValue) {
+        attrs.push("saltValue=\"".concat(escapeXmlAttr(protection.saltValue), "\""));
+    }
+    if (protection.spinCount != null) {
+        attrs.push("spinCount=\"".concat(protection.spinCount, "\""));
+    }
+    if (protection.password) {
+        attrs.push("password=\"".concat(escapeXmlAttr(protection.password), "\""));
+    }
+    try {
+        for (var SHEET_PROTECTION_FLAG_ATTRS_1 = __values(SHEET_PROTECTION_FLAG_ATTRS), SHEET_PROTECTION_FLAG_ATTRS_1_1 = SHEET_PROTECTION_FLAG_ATTRS_1.next(); !SHEET_PROTECTION_FLAG_ATTRS_1_1.done; SHEET_PROTECTION_FLAG_ATTRS_1_1 = SHEET_PROTECTION_FLAG_ATTRS_1.next()) {
+            var flag = SHEET_PROTECTION_FLAG_ATTRS_1_1.value;
+            var value = protection[flag];
+            if (typeof value === "boolean") {
+                attrs.push("".concat(flag, "=\"").concat(value ? 1 : 0, "\""));
+            }
+        }
+    }
+    catch (e_34_1) { e_34 = { error: e_34_1 }; }
+    finally {
+        try {
+            if (SHEET_PROTECTION_FLAG_ATTRS_1_1 && !SHEET_PROTECTION_FLAG_ATTRS_1_1.done && (_a = SHEET_PROTECTION_FLAG_ATTRS_1.return)) _a.call(SHEET_PROTECTION_FLAG_ATTRS_1);
+        }
+        finally { if (e_34) throw e_34.error; }
+    }
+    return attrs.length ? "<sheetProtection ".concat(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).
+ */
+var buildSheetProtectionXml = function (sheet, protectedRanges) {
+    var e_35, _a;
+    var protectionXml = sheet.sheetProtection
+        ? buildSheetProtectionElementXml(sheet.sheetProtection)
+        : "";
+    var rangeItems = [];
+    try {
+        for (var _b = __values(protectedRanges !== null && protectedRanges !== void 0 ? protectedRanges : []), _d = _b.next(); !_d.done; _d = _b.next()) {
+            var protectedRange = _d.value;
+            var 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`.
+            var isSingleCell = range.startRowIndex === range.endRowIndex &&
+                range.startColumnIndex === range.endColumnIndex;
+            var 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;
+            var id = protectedRange.protectedRangeId;
+            var name_1 = id != null && String(id) !== "" ? String(id) : "Range".concat(rangeItems.length + 1);
+            var securityDescriptor = protectedRange.securityDescriptor
+                ? " securityDescriptor=\"".concat(escapeXmlAttr(protectedRange.securityDescriptor), "\"")
+                : "";
+            rangeItems.push("<protectedRange sqref=\"".concat(escapeXmlAttr(sqref), "\" name=\"").concat(escapeXmlAttr(name_1), "\"").concat(securityDescriptor, "/>"));
+        }
+    }
+    catch (e_35_1) { e_35 = { error: e_35_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_35) throw e_35.error; }
+    }
+    var rangesXml = rangeItems.length
+        ? "<protectedRanges>".concat(rangeItems.join(""), "</protectedRanges>")
+        : "";
+    return "".concat(protectionXml).concat(rangesXml);
+};
 var buildSheetPropertiesXml = function (sheet) {
-    var _a;
+    var _a, _b, _d;
     var tabColor = serializeColorXml((_a = sheet.tabColor) !== null && _a !== void 0 ? _a : undefined);
     // <outlinePr> mirrors the sheet's `outlinePr` setting; both attrs
     // default to true in Excel, so only emit when explicitly false. If
@@ -2635,11 +2880,110 @@ var buildSheetPropertiesXml = function (sheet) {
     var outlineXml = outlineAttrs.length
         ? "<outlinePr ".concat(outlineAttrs.join(" "), "/>")
         : "";
-    if (!tabColor && !outlineXml)
+    // `<pageSetUpPr fitToPage="1">` is what makes Excel honour
+    // `<pageSetup fitToWidth/fitToHeight>` instead of `scale`.
+    var pageSetUpPrXml = ((_d = (_b = sheet.printSettings) === null || _b === void 0 ? void 0 : _b.pageSetup) === null || _d === void 0 ? void 0 : _d.fitToPage)
+        ? "<pageSetUpPr fitToPage=\"1\"/>"
+        : "";
+    if (!tabColor && !outlineXml && !pageSetUpPrXml)
         return "";
-    var inner = "".concat(tabColor ? "<tabColor ".concat(tabColor, "/>") : "").concat(outlineXml);
+    var inner = "".concat(tabColor ? "<tabColor ".concat(tabColor, "/>") : "").concat(outlineXml).concat(pageSetUpPrXml);
     return "<sheetPr>".concat(inner, "</sheetPr>");
 };
+var xmlBoolAttr = function (name, value) {
+    return value == null ? "" : " ".concat(name, "=\"").concat(value ? "1" : "0", "\"");
+};
+var xmlNumAttr = function (name, value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? " ".concat(name, "=\"").concat(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.
+ */
+var buildPrintSettingsXml = function (print) {
+    var _a, _b, _d, _e, _f, _g;
+    var parts = [];
+    var options = print === null || print === void 0 ? void 0 : print.printOptions;
+    var optionAttrs = xmlBoolAttr("horizontalCentered", options === null || options === void 0 ? void 0 : options.horizontalCentered) +
+        xmlBoolAttr("verticalCentered", options === null || options === void 0 ? void 0 : options.verticalCentered) +
+        xmlBoolAttr("headings", options === null || options === void 0 ? void 0 : options.headings) +
+        xmlBoolAttr("gridLines", options === null || options === void 0 ? void 0 : options.gridLines);
+    if (optionAttrs)
+        parts.push("<printOptions".concat(optionAttrs, "/>"));
+    var margins = print === null || print === void 0 ? void 0 : print.pageMargins;
+    parts.push(margins &&
+        Object.values(margins).some(function (v) { return typeof v === "number"; })
+        ? "<pageMargins left=\"".concat((_a = margins.left) !== null && _a !== void 0 ? _a : 0.7, "\" right=\"").concat((_b = margins.right) !== null && _b !== void 0 ? _b : 0.7, "\" top=\"").concat((_d = margins.top) !== null && _d !== void 0 ? _d : 0.75, "\" bottom=\"").concat((_e = margins.bottom) !== null && _e !== void 0 ? _e : 0.75, "\" header=\"").concat((_f = margins.header) !== null && _f !== void 0 ? _f : 0.3, "\" footer=\"").concat((_g = margins.footer) !== null && _g !== void 0 ? _g : 0.3, "\"/>")
+        : DEFAULT_PAGE_MARGINS);
+    var setup = print === null || print === void 0 ? void 0 : 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.
+        var useFirst = setup.useFirstPageNumber === true ? true : undefined;
+        var setupAttrs = xmlNumAttr("paperSize", setup.paperSize) +
+            xmlNumAttr("scale", setup.scale) +
+            xmlNumAttr("firstPageNumber", setup.firstPageNumber) +
+            xmlNumAttr("fitToWidth", setup.fitToWidth) +
+            xmlNumAttr("fitToHeight", setup.fitToHeight) +
+            (setup.pageOrder ? " pageOrder=\"".concat(setup.pageOrder, "\"") : "") +
+            (setup.orientation ? " orientation=\"".concat(setup.orientation, "\"") : "") +
+            xmlBoolAttr("blackAndWhite", setup.blackAndWhite) +
+            xmlBoolAttr("draft", setup.draft) +
+            xmlBoolAttr("useFirstPageNumber", useFirst);
+        if (setupAttrs)
+            parts.push("<pageSetup".concat(setupAttrs, "/>"));
+    }
+    var hf = print === null || print === void 0 ? void 0 : print.headerFooter;
+    if (hf && !isHeaderFooterEmpty(hf)) {
+        var hfAttrs = xmlBoolAttr("differentOddEven", hf.differentOddEven) +
+            xmlBoolAttr("differentFirst", hf.differentFirst) +
+            xmlBoolAttr("scaleWithDoc", hf.scaleWithDoc) +
+            xmlBoolAttr("alignWithMargins", hf.alignWithMargins);
+        var children = [
+            "oddHeader",
+            "oddFooter",
+            "evenHeader",
+            "evenFooter",
+            "firstHeader",
+            "firstFooter",
+        ]
+            .map(function (key) {
+            var text = hf[key];
+            return typeof text === "string" && text
+                ? "<".concat(key, ">").concat(escapeXmlText(text), "</").concat(key, ">")
+                : "";
+        })
+            .join("");
+        parts.push(children
+            ? "<headerFooter".concat(hfAttrs, ">").concat(children, "</headerFooter>")
+            : "<headerFooter".concat(hfAttrs, "/>"));
+    }
+    var breaks = function (ids, max) {
+        var valid = Array.from(new Set((ids !== null && ids !== void 0 ? ids : []).filter(function (id) { return Number.isInteger(id) && id > 0; }))).sort(function (a, b) { return a - b; });
+        if (!valid.length)
+            return "";
+        return valid
+            .map(function (id) { return "<brk id=\"".concat(id, "\" max=\"").concat(max, "\" man=\"1\"/>"); })
+            .join("");
+    };
+    var rowBrks = breaks(print === null || print === void 0 ? void 0 : print.rowBreaks, 16383);
+    if (rowBrks) {
+        var count = rowBrks.split("<brk ").length - 1;
+        parts.push("<rowBreaks count=\"".concat(count, "\" manualBreakCount=\"").concat(count, "\">").concat(rowBrks, "</rowBreaks>"));
+    }
+    var colBrks = breaks(print === null || print === void 0 ? void 0 : print.columnBreaks, 1048575);
+    if (colBrks) {
+        var count = colBrks.split("<brk ").length - 1;
+        parts.push("<colBreaks count=\"".concat(count, "\" manualBreakCount=\"").concat(count, "\">").concat(colBrks, "</colBreaks>"));
+    }
+    return parts.join("");
+};
 var buildFilterColumnsXml = function (filterSpecs, range, rows, headerRow, totalRow, styleBuilder) {
     if (headerRow === void 0) { headerRow = true; }
     if (totalRow === void 0) { totalRow = false; }
@@ -2712,113 +3056,93 @@ var gridRangeToRef = function (range) {
     }
 };
 var groupEmbedsBySheet = function (embeds) {
-    var e_31, _a;
-    var _b, _d, _e, _f, _g, _h, _j;
     var result = new Map();
-    try {
-        for (var _k = __values(embeds !== null && embeds !== void 0 ? embeds : []), _l = _k.next(); !_l.done; _l = _k.next()) {
-            var embed = _l.value;
-            if (!((_b = embed.position) === null || _b === void 0 ? void 0 : _b.overlayPosition))
-                continue;
-            if (((_d = embed.spec) === null || _d === void 0 ? void 0 : _d.type) !== "image")
-                continue;
-            var overlay = embed.position.overlayPosition;
-            var placement = {
-                kind: "embed",
-                imageUrl: embed.spec.imageUrl,
-                rowIndex: overlay.anchorCell.rowIndex,
-                columnIndex: overlay.anchorCell.columnIndex,
-                offsetX: (_e = overlay.offsetXPixels) !== null && _e !== void 0 ? _e : 0,
-                offsetY: (_f = overlay.offsetYPixels) !== null && _f !== void 0 ? _f : 0,
-                width: (_g = overlay.widthPixels) !== null && _g !== void 0 ? _g : 120,
-                height: (_h = overlay.heightPixels) !== null && _h !== void 0 ? _h : 120,
-            };
-            var list = (_j = result.get(embed.position.sheetId)) !== null && _j !== void 0 ? _j : [];
-            list.push(placement);
-            result.set(embed.position.sheetId, list);
-        }
-    }
-    catch (e_31_1) { e_31 = { error: e_31_1 }; }
-    finally {
-        try {
-            if (_l && !_l.done && (_a = _k.return)) _a.call(_k);
-        }
-        finally { if (e_31) throw e_31.error; }
-    }
+    (embeds !== null && embeds !== void 0 ? embeds : []).forEach(function (embed, order) {
+        var _a, _b, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        if (!((_a = embed.position) === null || _a === void 0 ? void 0 : _a.overlayPosition))
+            return;
+        if (((_b = embed.spec) === null || _b === void 0 ? void 0 : _b.type) !== "image")
+            return;
+        var overlay = embed.position.overlayPosition;
+        var imageSpec = embed.spec;
+        var adjustments = {
+            crop: (_d = imageSpec.crop) !== null && _d !== void 0 ? _d : undefined,
+            brightness: (_e = imageSpec.brightness) !== null && _e !== void 0 ? _e : undefined,
+            contrast: (_f = imageSpec.contrast) !== null && _f !== void 0 ? _f : undefined,
+            transparency: (_g = imageSpec.transparency) !== null && _g !== void 0 ? _g : undefined,
+        };
+        var placement = {
+            kind: "embed",
+            imageUrl: imageSpec.imageUrl,
+            adjustments: Object.values(adjustments).some(function (v) { return v !== undefined; })
+                ? adjustments
+                : undefined,
+            order: order,
+            rowIndex: overlay.anchorCell.rowIndex,
+            columnIndex: overlay.anchorCell.columnIndex,
+            offsetX: (_h = overlay.offsetXPixels) !== null && _h !== void 0 ? _h : 0,
+            offsetY: (_j = overlay.offsetYPixels) !== null && _j !== void 0 ? _j : 0,
+            width: (_k = overlay.widthPixels) !== null && _k !== void 0 ? _k : 120,
+            height: (_l = overlay.heightPixels) !== null && _l !== void 0 ? _l : 120,
+        };
+        var list = (_m = result.get(embed.position.sheetId)) !== null && _m !== void 0 ? _m : [];
+        list.push(placement);
+        result.set(embed.position.sheetId, list);
+    });
     return result;
 };
 var groupTextBoxesBySheet = function (embeds) {
-    var e_32, _a;
-    var _b, _d, _e, _f, _g, _h, _j;
     var result = new Map();
-    try {
-        for (var _k = __values(embeds !== null && embeds !== void 0 ? embeds : []), _l = _k.next(); !_l.done; _l = _k.next()) {
-            var embed = _l.value;
-            if (!((_b = embed.position) === null || _b === void 0 ? void 0 : _b.overlayPosition))
-                continue;
-            if (((_d = embed.spec) === null || _d === void 0 ? void 0 : _d.type) !== "textbox")
-                continue;
-            var overlay = embed.position.overlayPosition;
-            var placement = {
-                textBox: embed,
-                rowIndex: overlay.anchorCell.rowIndex,
-                columnIndex: overlay.anchorCell.columnIndex,
-                offsetX: (_e = overlay.offsetXPixels) !== null && _e !== void 0 ? _e : 0,
-                offsetY: (_f = overlay.offsetYPixels) !== null && _f !== void 0 ? _f : 0,
-                width: (_g = overlay.widthPixels) !== null && _g !== void 0 ? _g : 120,
-                height: (_h = overlay.heightPixels) !== null && _h !== void 0 ? _h : 60,
-            };
-            var list = (_j = result.get(embed.position.sheetId)) !== null && _j !== void 0 ? _j : [];
-            list.push(placement);
-            result.set(embed.position.sheetId, list);
-        }
-    }
-    catch (e_32_1) { e_32 = { error: e_32_1 }; }
-    finally {
-        try {
-            if (_l && !_l.done && (_a = _k.return)) _a.call(_k);
-        }
-        finally { if (e_32) throw e_32.error; }
-    }
+    (embeds !== null && embeds !== void 0 ? embeds : []).forEach(function (embed, order) {
+        var _a, _b, _d, _e, _f, _g, _h;
+        if (!((_a = embed.position) === null || _a === void 0 ? void 0 : _a.overlayPosition))
+            return;
+        if (((_b = embed.spec) === null || _b === void 0 ? void 0 : _b.type) !== "textbox")
+            return;
+        var overlay = embed.position.overlayPosition;
+        var placement = {
+            textBox: embed,
+            order: order,
+            rowIndex: overlay.anchorCell.rowIndex,
+            columnIndex: overlay.anchorCell.columnIndex,
+            offsetX: (_d = overlay.offsetXPixels) !== null && _d !== void 0 ? _d : 0,
+            offsetY: (_e = overlay.offsetYPixels) !== null && _e !== void 0 ? _e : 0,
+            width: (_f = overlay.widthPixels) !== null && _f !== void 0 ? _f : 120,
+            height: (_g = overlay.heightPixels) !== null && _g !== void 0 ? _g : 60,
+        };
+        var list = (_h = result.get(embed.position.sheetId)) !== null && _h !== void 0 ? _h : [];
+        list.push(placement);
+        result.set(embed.position.sheetId, list);
+    });
     return result;
 };
 var groupShapesBySheet = function (embeds) {
-    var e_33, _a;
-    var _b, _d, _e, _f, _g, _h, _j;
     var result = new Map();
-    try {
-        for (var _k = __values(embeds !== null && embeds !== void 0 ? embeds : []), _l = _k.next(); !_l.done; _l = _k.next()) {
-            var embed = _l.value;
-            if (!((_b = embed.position) === null || _b === void 0 ? void 0 : _b.overlayPosition))
-                continue;
-            if (((_d = embed.spec) === null || _d === void 0 ? void 0 : _d.type) !== "shape")
-                continue;
-            var overlay = embed.position.overlayPosition;
-            var placement = {
-                shape: embed,
-                rowIndex: overlay.anchorCell.rowIndex,
-                columnIndex: overlay.anchorCell.columnIndex,
-                offsetX: (_e = overlay.offsetXPixels) !== null && _e !== void 0 ? _e : 0,
-                offsetY: (_f = overlay.offsetYPixels) !== null && _f !== void 0 ? _f : 0,
-                width: (_g = overlay.widthPixels) !== null && _g !== void 0 ? _g : 120,
-                height: (_h = overlay.heightPixels) !== null && _h !== void 0 ? _h : 60,
-            };
-            var list = (_j = result.get(embed.position.sheetId)) !== null && _j !== void 0 ? _j : [];
-            list.push(placement);
-            result.set(embed.position.sheetId, list);
-        }
-    }
-    catch (e_33_1) { e_33 = { error: e_33_1 }; }
-    finally {
-        try {
-            if (_l && !_l.done && (_a = _k.return)) _a.call(_k);
-        }
-        finally { if (e_33) throw e_33.error; }
-    }
+    (embeds !== null && embeds !== void 0 ? embeds : []).forEach(function (embed, order) {
+        var _a, _b, _d, _e, _f, _g, _h;
+        if (!((_a = embed.position) === null || _a === void 0 ? void 0 : _a.overlayPosition))
+            return;
+        if (((_b = embed.spec) === null || _b === void 0 ? void 0 : _b.type) !== "shape")
+            return;
+        var overlay = embed.position.overlayPosition;
+        var placement = {
+            shape: embed,
+            order: order,
+            rowIndex: overlay.anchorCell.rowIndex,
+            columnIndex: overlay.anchorCell.columnIndex,
+            offsetX: (_d = overlay.offsetXPixels) !== null && _d !== void 0 ? _d : 0,
+            offsetY: (_e = overlay.offsetYPixels) !== null && _e !== void 0 ? _e : 0,
+            width: (_f = overlay.widthPixels) !== null && _f !== void 0 ? _f : 120,
+            height: (_g = overlay.heightPixels) !== null && _g !== void 0 ? _g : 60,
+        };
+        var list = (_h = result.get(embed.position.sheetId)) !== null && _h !== void 0 ? _h : [];
+        list.push(placement);
+        result.set(embed.position.sheetId, list);
+    });
     return result;
 };
 var groupChartsBySheet = function (charts) {
-    var e_34, _a;
+    var e_36, _a;
     var _b, _d, _e, _f, _g, _h;
     var result = new Map();
     try {
@@ -2841,17 +3165,17 @@ var groupChartsBySheet = function (charts) {
             result.set(chart.position.sheetId, list);
         }
     }
-    catch (e_34_1) { e_34 = { error: e_34_1 }; }
+    catch (e_36_1) { e_36 = { error: e_36_1 }; }
     finally {
         try {
             if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
         }
-        finally { if (e_34) throw e_34.error; }
+        finally { if (e_36) throw e_36.error; }
     }
     return result;
 };
 var groupSlicersBySheet = function (slicers) {
-    var e_35, _a;
+    var e_37, _a;
     var _b, _d, _e, _f, _g, _h;
     var result = new Map();
     try {
@@ -2874,17 +3198,17 @@ var groupSlicersBySheet = function (slicers) {
             result.set(slicer.position.sheetId, list);
         }
     }
-    catch (e_35_1) { e_35 = { error: e_35_1 }; }
+    catch (e_37_1) { e_37 = { error: e_37_1 }; }
     finally {
         try {
             if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
         }
-        finally { if (e_35) throw e_35.error; }
+        finally { if (e_37) throw e_37.error; }
     }
     return result;
 };
 var buildConditionalFormattingXml = function (_a) {
-    var e_36, _b;
+    var e_38, _b;
     var _d, _e, _f;
     var conditionalFormats = _a.conditionalFormats, sheetId = _a.sheetId, styleBuilder = _a.styleBuilder;
     if (!(conditionalFormats === null || conditionalFormats === void 0 ? void 0 : conditionalFormats.length)) {
@@ -2948,12 +3272,12 @@ var buildConditionalFormattingXml = function (_a) {
             parts.push("<conditionalFormatting sqref=\"".concat(sqrefParts.join(" "), "\">").concat(ruleXmlEntries.join(""), "</conditionalFormatting>"));
         }
     }
-    catch (e_36_1) { e_36 = { error: e_36_1 }; }
+    catch (e_38_1) { e_38 = { error: e_38_1 }; }
     finally {
         try {
             if (orderedRules_1_1 && !orderedRules_1_1.done && (_b = orderedRules_1.return)) _b.call(orderedRules_1);
         }
-        finally { if (e_36) throw e_36.error; }
+        finally { if (e_38) throw e_38.error; }
     }
     return parts.join("");
 };
@@ -3449,11 +3773,11 @@ var buildConditionalFormattingRuleXml = function (_a) {
     return rules.length ? rules : undefined;
 };
 var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var anchors, relationships, media, imageIndex, chartIndex, pictureId, frameId, chartEntries, charts_1, charts_1_1, placement, chartXml, relId, slicers_1, slicers_1_1, placement, textBoxes_1, textBoxes_1_1, placement, shapes_1, shapes_1_1, placement, placements_1, placements_1_1, placement, dataUrl, buffer, mediaPath, relId, e_37_1, drawingXml;
-    var e_38, _d, e_39, _e, e_40, _f, e_41, _g, e_37, _h;
-    var placements = _b.placements, textBoxes = _b.textBoxes, _j = _b.shapes, shapes = _j === void 0 ? [] : _j, startImageIndex = _b.startImageIndex, startChartIndex = _b.startChartIndex, charts = _b.charts, slicers = _b.slicers, sheet = _b.sheet, sheetNameById = _b.sheetNameById;
-    return __generator(this, function (_k) {
-        switch (_k.label) {
+    var anchors, relationships, media, imageIndex, chartIndex, pictureId, frameId, chartEntries, charts_1, charts_1_1, placement, chartXml, relId, slicers_1, slicers_1_1, placement, embedAnchors, orderOf, textBoxes_1, textBoxes_1_1, placement, shapes_1, shapes_1_1, placement, placements_1, placements_1_1, placement, dataUrl, buffer, mediaPath, relId, e_39_1, embedAnchors_1, embedAnchors_1_1, entry, drawingXml;
+    var e_40, _d, e_41, _e, e_42, _f, e_43, _g, e_39, _h, e_44, _j;
+    var placements = _b.placements, textBoxes = _b.textBoxes, _k = _b.shapes, shapes = _k === void 0 ? [] : _k, startImageIndex = _b.startImageIndex, startChartIndex = _b.startChartIndex, charts = _b.charts, slicers = _b.slicers, sheet = _b.sheet, sheetNameById = _b.sheetNameById;
+    return __generator(this, function (_l) {
+        switch (_l.label) {
             case 0:
                 if (!placements.length &&
                     !textBoxes.length &&
@@ -3490,12 +3814,12 @@ var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         frameId += 1;
                     }
                 }
-                catch (e_38_1) { e_38 = { error: e_38_1 }; }
+                catch (e_40_1) { e_40 = { error: e_40_1 }; }
                 finally {
                     try {
                         if (charts_1_1 && !charts_1_1.done && (_d = charts_1.return)) _d.call(charts_1);
                     }
-                    finally { if (e_38) throw e_38.error; }
+                    finally { if (e_40) throw e_40.error; }
                 }
                 try {
                     for (slicers_1 = __values(slicers), slicers_1_1 = slicers_1.next(); !slicers_1_1.done; slicers_1_1 = slicers_1.next()) {
@@ -3508,60 +3832,70 @@ var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         frameId += 1;
                     }
                 }
-                catch (e_39_1) { e_39 = { error: e_39_1 }; }
+                catch (e_41_1) { e_41 = { error: e_41_1 }; }
                 finally {
                     try {
                         if (slicers_1_1 && !slicers_1_1.done && (_e = slicers_1.return)) _e.call(slicers_1);
                     }
-                    finally { if (e_39) throw e_39.error; }
+                    finally { if (e_41) throw e_41.error; }
                 }
+                embedAnchors = [];
+                orderOf = function (order) {
+                    return order !== null && order !== void 0 ? order : Number.MAX_SAFE_INTEGER;
+                };
                 try {
                     for (textBoxes_1 = __values(textBoxes), textBoxes_1_1 = textBoxes_1.next(); !textBoxes_1_1.done; textBoxes_1_1 = textBoxes_1.next()) {
                         placement = textBoxes_1_1.value;
-                        anchors.push(createTextBoxAnchor({
-                            sheet: sheet,
-                            placement: placement,
-                            frameId: frameId,
-                        }));
+                        embedAnchors.push({
+                            order: orderOf(placement.order),
+                            xml: createTextBoxAnchor({
+                                sheet: sheet,
+                                placement: placement,
+                                frameId: frameId,
+                            }),
+                        });
                         frameId += 1;
                     }
                 }
-                catch (e_40_1) { e_40 = { error: e_40_1 }; }
+                catch (e_42_1) { e_42 = { error: e_42_1 }; }
                 finally {
                     try {
                         if (textBoxes_1_1 && !textBoxes_1_1.done && (_f = textBoxes_1.return)) _f.call(textBoxes_1);
                     }
-                    finally { if (e_40) throw e_40.error; }
+                    finally { if (e_42) throw e_42.error; }
                 }
                 try {
                     for (shapes_1 = __values(shapes), shapes_1_1 = shapes_1.next(); !shapes_1_1.done; shapes_1_1 = shapes_1.next()) {
                         placement = shapes_1_1.value;
-                        anchors.push(createShapeAnchor({
-                            sheet: sheet,
-                            placement: placement,
-                            frameId: frameId,
-                        }));
+                        embedAnchors.push({
+                            order: orderOf(placement.order),
+                            xml: createShapeAnchor({
+                                sheet: sheet,
+                                placement: placement,
+                                frameId: frameId,
+                            }),
+                        });
                         frameId += 1;
                     }
                 }
-                catch (e_41_1) { e_41 = { error: e_41_1 }; }
+                catch (e_43_1) { e_43 = { error: e_43_1 }; }
                 finally {
                     try {
                         if (shapes_1_1 && !shapes_1_1.done && (_g = shapes_1.return)) _g.call(shapes_1);
                     }
-                    finally { if (e_41) throw e_41.error; }
+                    finally { if (e_43) throw e_43.error; }
                 }
-                _k.label = 1;
+                _l.label = 1;
             case 1:
-                _k.trys.push([1, 6, 7, 8]);
+                _l.trys.push([1, 6, 7, 8]);
                 placements_1 = __values(placements), placements_1_1 = placements_1.next();
-                _k.label = 2;
+                _l.label = 2;
             case 2:
                 if (!!placements_1_1.done) return [3 /*break*/, 5];
                 placement = placements_1_1.value;
                 return [4 /*yield*/, resolveImageDataUrl(placement.imageUrl)];
             case 3:
-                dataUrl = _k.sent();
+                dataUrl = _l.sent();
                 if (!dataUrl)
                     return [3 /*break*/, 4];
                 buffer = dataUriToBuffer(dataUrl, placement.imageUrl);
@@ -3574,30 +3908,47 @@ var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, f
                     extension: buffer.extension,
                 });
                 relId = relationships.add(IMAGE_REL_TYPE, "../media/image".concat(imageIndex, ".").concat(buffer.extension));
-                anchors.push(createTwoCellAnchor({
-                    sheet: sheet,
-                    placement: placement,
-                    relId: relId,
-                    pictureId: pictureId,
-                }));
+                embedAnchors.push({
+                    order: orderOf(placement.order),
+                    xml: createTwoCellAnchor({
+                        sheet: sheet,
+                        placement: placement,
+                        relId: relId,
+                        pictureId: pictureId,
+                    }),
+                });
                 imageIndex += 1;
                 pictureId += 1;
-                _k.label = 4;
+                _l.label = 4;
             case 4:
                 placements_1_1 = placements_1.next();
                 return [3 /*break*/, 2];
             case 5: return [3 /*break*/, 8];
             case 6:
-                e_37_1 = _k.sent();
-                e_37 = { error: e_37_1 };
+                e_39_1 = _l.sent();
+                e_39 = { error: e_39_1 };
                 return [3 /*break*/, 8];
             case 7:
                 try {
                     if (placements_1_1 && !placements_1_1.done && (_h = placements_1.return)) _h.call(placements_1);
                 }
-                finally { if (e_37) throw e_37.error; }
+                finally { if (e_39) throw e_39.error; }
                 return [7 /*endfinally*/];
             case 8:
+                embedAnchors.sort(function (a, b) { return a.order - b.order; });
+                try {
+                    for (embedAnchors_1 = __values(embedAnchors), embedAnchors_1_1 = embedAnchors_1.next(); !embedAnchors_1_1.done; embedAnchors_1_1 = embedAnchors_1.next()) {
+                        entry = embedAnchors_1_1.value;
+                        anchors.push(entry.xml);
+                    }
+                }
+                catch (e_44_1) { e_44 = { error: e_44_1 }; }
+                finally {
+                    try {
+                        if (embedAnchors_1_1 && !embedAnchors_1_1.done && (_j = embedAnchors_1.return)) _j.call(embedAnchors_1);
+                    }
+                    finally { if (e_44) throw e_44.error; }
+                }
                 drawingXml = "".concat(XML_DECLARATION, "<xdr:wsDr xmlns:xdr=\"http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\" xmlns:r=\"").concat(REL_NS, "\">").concat(anchors.join(""), "</xdr:wsDr>");
                 return [2 /*return*/, {
                         xml: drawingXml,
@@ -3635,7 +3986,55 @@ var createTwoCellAnchor = function (_a) {
     });
     var fromXml = "<xdr:from><xdr:col>".concat(fromColumn, "</xdr:col><xdr:colOff>").concat(Math.round(offsetX * EMUS_PER_PIXEL), "</xdr:colOff><xdr:row>").concat(fromRow, "</xdr:row><xdr:rowOff>").concat(Math.round(offsetY * EMUS_PER_PIXEL), "</xdr:rowOff></xdr:from>");
     var toXml = "<xdr:to><xdr:col>".concat(toColumn.index, "</xdr:col><xdr:colOff>").concat(Math.round(toColumn.offset * EMUS_PER_PIXEL), "</xdr:colOff><xdr:row>").concat(toRow.index, "</xdr:row><xdr:rowOff>").concat(Math.round(toRow.offset * EMUS_PER_PIXEL), "</xdr:rowOff></xdr:to>");
-    return "<xdr:twoCellAnchor editAs=\"oneCell\">".concat(fromXml).concat(toXml, "<xdr:pic><xdr:nvPicPr><xdr:cNvPr id=\"").concat(pictureId, "\" name=\"Picture ").concat(pictureId, "\"/><xdr:cNvPicPr/></xdr:nvPicPr><xdr:blipFill><a:blip r:embed=\"").concat(relId, "\"/><a:stretch><a:fillRect/></a:stretch></xdr:blipFill><xdr:spPr><a:xfrm><a:off x=\"0\" y=\"0\"/><a:ext cx=\"").concat(Math.round(widthPx * EMUS_PER_PIXEL), "\" cy=\"").concat(Math.round(heightPx * EMUS_PER_PIXEL), "\"/></a:xfrm><a:prstGeom prst=\"rect\"><a:avLst/></a:prstGeom></xdr:spPr></xdr:pic><xdr:clientData/></xdr:twoCellAnchor>");
+    var _g = buildPictureAdjustmentsXml(placement.adjustments), blipChildren = _g.blipChildren, srcRectXml = _g.srcRectXml;
+    var blipXml = blipChildren
+        ? "<a:blip r:embed=\"".concat(relId, "\">").concat(blipChildren, "</a:blip>")
+        : "<a:blip r:embed=\"".concat(relId, "\"/>");
+    return "<xdr:twoCellAnchor editAs=\"oneCell\">".concat(fromXml).concat(toXml, "<xdr:pic><xdr:nvPicPr><xdr:cNvPr id=\"").concat(pictureId, "\" name=\"Picture ").concat(pictureId, "\"/><xdr:cNvPicPr/></xdr:nvPicPr><xdr:blipFill>").concat(blipXml).concat(srcRectXml, "<a:stretch><a:fillRect/></a:stretch></xdr:blipFill><xdr:spPr><a:xfrm><a:off x=\"0\" y=\"0\"/><a:ext cx=\"").concat(Math.round(widthPx * EMUS_PER_PIXEL), "\" cy=\"").concat(Math.round(heightPx * EMUS_PER_PIXEL), "\"/></a:xfrm><a:prstGeom prst=\"rect\"><a:avLst/></a:prstGeom></xdr:spPr></xdr:pic><xdr:clientData/></xdr:twoCellAnchor>");
+};
+/** Fraction (0…1) → DrawingML per-mille percent (100000 = 100%). */
+var fractionToPct = function (value) {
+    return 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.
+ */
+var buildPictureAdjustmentsXml = function (adjustments) {
+    if (!adjustments)
+        return { blipChildren: "", srcRectXml: "" };
+    var blipChildren = "";
+    var transparency = adjustments.transparency, brightness = adjustments.brightness, contrast = adjustments.contrast, crop = adjustments.crop;
+    if (typeof transparency === "number" && transparency > 0) {
+        blipChildren += "<a:alphaModFix amt=\"".concat(fractionToPct(1 - Math.min(1, transparency)), "\"/>");
+    }
+    var hasBrightness = typeof brightness === "number" && brightness !== 0;
+    var hasContrast = typeof contrast === "number" && contrast !== 0;
+    if (hasBrightness || hasContrast) {
+        blipChildren += "<a:lum".concat(hasBrightness ? " bright=\"".concat(fractionToPct(brightness), "\"") : "").concat(hasContrast ? " contrast=\"".concat(fractionToPct(contrast), "\"") : "", "/>");
+    }
+    var srcRectXml = "";
+    if (crop) {
+        var edges = ["l", "t", "r", "b"]
+            .map(function (edge) {
+            var 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
+                ? " ".concat(edge, "=\"").concat(fractionToPct(value), "\"")
+                : "";
+        })
+            .join("");
+        if (edges)
+            srcRectXml = "<a:srcRect".concat(edges, "/>");
+    }
+    return { blipChildren: blipChildren, srcRectXml: srcRectXml };
 };
 var createChartAnchor = function (_a) {
     var _b, _d, _e, _f;
@@ -3900,7 +4299,7 @@ var buildTextWithTabs = function (text, rPrXml) {
         .join("");
 };
 var buildTextBodyXml = function (spec) {
-    var e_42, _a;
+    var e_45, _a;
     var richText = spec.richText || [];
     var plainText = spec.text || "";
     // Build vertical alignment and wrap attributes
@@ -3941,12 +4340,12 @@ var buildTextBodyXml = function (spec) {
                 }
             }
         }
-        catch (e_42_1) { e_42 = { error: e_42_1 }; }
+        catch (e_45_1) { e_45 = { error: e_45_1 }; }
         finally {
             try {
                 if (richText_1_1 && !richText_1_1.done && (_a = richText_1.return)) _a.call(richText_1);
             }
-            finally { if (e_42) throw e_42.error; }
+            finally { if (e_45) throw e_45.error; }
         }
         paragraphsXml = paragraphs
             .filter(function (runs) { return runs.length > 0; })
@@ -4352,7 +4751,13 @@ var buildWorkbookXml = function (sheets, sheetRelIds, sheetNames, namedRanges, i
         var _a;
         sheetNameById.set((_a = sheet.sheetId) !== null && _a !== void 0 ? _a : index + 1, sheetNames[index]);
     });
-    var definedNamesXml = buildDefinedNamesXml(namedRanges, sheetNameById);
+    var definedNamesXml = buildDefinedNamesXml(namedRanges, sheetNameById, sheets.map(function (sheet, index) {
+        var _a;
+        return ({
+            sheetName: (_a = sheetNames[index]) !== null && _a !== void 0 ? _a : "Sheet".concat(index + 1),
+            printSettings: sheet.printSettings,
+        });
+    }));
     var calcPrXml = buildCalcPrXml(iterativeCalculationOptions);
     var slicerCachesXml = buildWorkbookSlicerCachesXml(slicerCacheRelIds);
     // Phase D2 — <pivotCaches> element. Each <pivotCache> pairs a
@@ -4383,19 +4788,70 @@ var buildWorkbookXml = function (sheets, sheetRelIds, sheetNames, namedRanges, i
         : "<workbookPr/>";
     return "".concat(XML_DECLARATION, "<workbook xmlns=\"").concat(WORKSHEET_NS, "\" xmlns:r=\"").concat(REL_NS, "\">").concat(workbookPrXml).concat(calcPrXml, "<bookViews><workbookView activeTab=\"0\" firstSheet=\"0\"/></bookViews><sheets>").concat(sheetEntries, "</sheets>").concat(definedNamesXml).concat(externalReferencesXml).concat(pivotCachesXml).concat(slicerCachesXml, "</workbook>");
 };
-var buildDefinedNamesXml = function (namedRanges, sheetNameById) {
-    var e_43, _a;
-    var _b;
-    if (!(namedRanges === null || namedRanges === void 0 ? void 0 : namedRanges.length))
-        return "";
+var buildDefinedNamesXml = function (namedRanges, sheetNameById, printScopes) {
+    var e_46, _a, e_47, _b;
+    var _d, _e, _f;
+    if (printScopes === void 0) { printScopes = []; }
     var entries = [];
+    // 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.
+    var sheetIndexByName = new Map(printScopes.map(function (_a, index) {
+        var sheetName = _a.sheetName;
+        return [sheetName, index];
+    }));
+    var legacyPrintAreas = new Map();
+    try {
+        for (var _g = __values(namedRanges !== null && namedRanges !== void 0 ? namedRanges : []), _h = _g.next(); !_h.done; _h = _g.next()) {
+            var namedRange = _h.value;
+            if ((namedRange === null || namedRange === void 0 ? void 0 : namedRange.name) !== PRINT_AREA_NAME || !((_d = namedRange.range) === null || _d === void 0 ? void 0 : _d.sheetId)) {
+                continue;
+            }
+            var sheetName = sheetNameById.get(namedRange.range.sheetId);
+            var index = sheetName ? sheetIndexByName.get(sheetName) : undefined;
+            if (index == null)
+                continue;
+            legacyPrintAreas.set(index, __spreadArray(__spreadArray([], __read(((_e = legacyPrintAreas.get(index)) !== null && _e !== void 0 ? _e : [])), false), [
+                namedRange.range,
+            ], false));
+        }
+    }
+    catch (e_46_1) { e_46 = { error: e_46_1 }; }
+    finally {
+        try {
+            if (_h && !_h.done && (_a = _g.return)) _a.call(_g);
+        }
+        finally { if (e_46) throw e_46.error; }
+    }
+    printScopes.forEach(function (_a, index) {
+        var _b;
+        var sheetName = _a.sheetName, printSettings = _a.printSettings;
+        var printArea = ((_b = printSettings === null || printSettings === void 0 ? void 0 : printSettings.printArea) === null || _b === void 0 ? void 0 : _b.length)
+            ? printSettings.printArea
+            : legacyPrintAreas.get(index);
+        var area = (printArea === null || printArea === void 0 ? void 0 : printArea.length)
+            ? buildPrintAreaFormula(sheetName, printArea)
+            : undefined;
+        if (area) {
+            entries.push("<definedName name=\"".concat(PRINT_AREA_NAME, "\" localSheetId=\"").concat(index, "\">").concat(escapeXmlText(area), "</definedName>"));
+        }
+        var titles = (printSettings === null || printSettings === void 0 ? void 0 : printSettings.printTitles)
+            ? buildPrintTitlesFormula(sheetName, printSettings.printTitles)
+            : undefined;
+        if (titles) {
+            entries.push("<definedName name=\"".concat(PRINT_TITLES_NAME, "\" localSheetId=\"").concat(index, "\">").concat(escapeXmlText(titles), "</definedName>"));
+        }
+    });
     try {
-        for (var namedRanges_1 = __values(namedRanges), namedRanges_1_1 = namedRanges_1.next(); !namedRanges_1_1.done; namedRanges_1_1 = namedRanges_1.next()) {
-            var namedRange = namedRanges_1_1.value;
-            if (!(namedRange === null || namedRange === void 0 ? void 0 : namedRange.name))
+        for (var _j = __values(namedRanges !== null && namedRanges !== void 0 ? namedRanges : []), _k = _j.next(); !_k.done; _k = _j.next()) {
+            var namedRange = _k.value;
+            if (!(namedRange === null || namedRange === void 0 ? void 0 : namedRange.name) || isBuiltinPrintName(namedRange.name))
                 continue;
             var hiddenAttr = namedRange.hidden ? " hidden=\"1\"" : "";
-            if ((_b = namedRange.range) === null || _b === void 0 ? void 0 : _b.sheetId) {
+            if ((_f = namedRange.range) === null || _f === void 0 ? void 0 : _f.sheetId) {
                 var sheetName = sheetNameById.get(namedRange.range.sheetId);
                 if (!sheetName)
                     continue;
@@ -4416,12 +4872,12 @@ var buildDefinedNamesXml = function (namedRanges, sheetNameById) {
             entries.push("<definedName name=\"".concat(escapeXmlAttr(namedRange.name), "\"").concat(hiddenAttr, ">").concat(escapeXmlText(expression), "</definedName>"));
         }
     }
-    catch (e_43_1) { e_43 = { error: e_43_1 }; }
+    catch (e_47_1) { e_47 = { error: e_47_1 }; }
     finally {
         try {
-            if (namedRanges_1_1 && !namedRanges_1_1.done && (_a = namedRanges_1.return)) _a.call(namedRanges_1);
+            if (_k && !_k.done && (_b = _j.return)) _b.call(_j);
         }
-        finally { if (e_43) throw e_43.error; }
+        finally { if (e_47) throw e_47.error; }
     }
     if (!entries.length)
         return "";