@rowsncolumns/toolkit 24.5.3 → 24.5.5

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

@@ -1,5 +1,5 @@
 import { __assign, __awaiter, __generator, __read, __spreadArray, __values } from "tslib";
-import { cellRangeToAddress, cellToAddress, escapeCharacters, getCellEffectiveFormat, getCellEffectiveValue, getCellFormattedValue, getCellUserEnteredFormat, getCellUserEnteredValue, getExtendedValueBool, getExtendedValueError, getExtendedValueFormula, getExtendedValueNumber, getExtendedValueString, isNil, sortSheetsByIndex, } from "@rowsncolumns/utils";
+import { cellRangeToAddress, cellToAddress, escapeCharacters, getCellEffectiveFormat, getCellEffectiveValue, getCellFormattedValue, getCellUserEnteredFormat, getCellUserEnteredValue, getExtendedValueBool, getExtendedValueError, getExtendedValueFormula, getExtendedValueNumber, getExtendedValueString, isNil, sortSheetsByIndex, conditionOperandToFormulaText, } from "@rowsncolumns/utils";
 import { zipSync } from "fflate";
 import { omitInvalidDataValidationError } from "../invalid-data-validation";
 import { buildAutoFilterCriteriaXml } from "../../autofilter-condition";
@@ -31,10 +31,10 @@ var pixelToPoints = function (px) {
     return Math.max(1, Number(((px * 72) / 96).toFixed(2)));
 };
 export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var sortedSheets, sharedStrings, personRegistry, styleBuilder, customTableStyleRecords, customTableStyleNames, exportableTables, tableIdMap, preparedTables, chartCount, embedsBySheet, textBoxesBySheet, shapesBySheet, formControlsBySheet, ctrlProps, chartsBySheet, remappedSlicers, slicersBySheet, workbookSheetNames, sheetNameById, dataValidationsById, globalSlicerIndex, slicerCacheEntries, slicerEntries, globalPivotIndex, pivotCacheEntries, pivotCacheRelsEntries, pivotTableEntries, pivotTableRelsEntries, pivotSourceNameById, _loop_1, pivotTables_1, pivotTables_1_1, p, resolvePivotSourceName, pivotsByTargetSheet, pivotTables_2, pivotTables_2_1, p, sid, list, workbookPivotCacheRefs, worksheetCount, chartsheetCount, worksheetEntries, _d, workbookRelationshipsXml, sheetRelationshipIds, slicerCacheRelationshipIds, pivotCacheRelationshipIds, externalLinkRelationshipIds, workbookXml, sharedStringsXml, rootRelationshipsXml, appXml, coreXml, tablePartFiles, preparedTables_1, preparedTables_1_1, table, rows, tableXml, stylesXml, themeXml, files, worksheetEntries_1, worksheetEntries_1_1, entry, personsXml, globalImageIndex, globalChartIndex, drawingSheets, imageExtensions, chartEntries, chartExEntries, globalChartExIndex, worksheetEntries_2, worksheetEntries_2_1, entry, placements, textBoxesForSheet, shapesForSheet, chartsForSheet, slicersForSheet, drawingParts, _e, _f, media, _g, _h, chartEntry, _j, _k, chartExEntry, e_1_1, chartEntries_1, chartEntries_1_1, chartEntry, chartExEntries_1, chartExEntries_1_1, chartExEntry, 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, hasVmlDrawings, _l, _m, part, threadedCommentsSheets, contentTypesXml, zipBytes;
+    var sortedSheets, sharedStrings, personRegistry, styleBuilder, customTableStyleRecords, customTableStyleNames, exportableTables, tableIdMap, preparedTables, chartCount, embedsBySheet, textBoxesBySheet, shapesBySheet, formControlsBySheet, ctrlProps, chartsBySheet, remappedSlicers, slicersBySheet, workbookSheetNames, sheetNameById, dataValidationsById, globalSlicerIndex, slicerCacheEntries, slicerEntries, globalPivotIndex, pivotCacheEntries, pivotCacheRelsEntries, pivotTableEntries, pivotTableRelsEntries, pivotSourceNameById, _loop_1, pivotTables_1, pivotTables_1_1, p, resolvePivotSourceName, pivotsByTargetSheet, pivotTables_2, pivotTables_2_1, p, sid, list, workbookPivotCacheRefs, worksheetCount, chartsheetCount, worksheetEntries, hasDynamicArrays, _d, workbookRelationshipsXml, sheetRelationshipIds, slicerCacheRelationshipIds, pivotCacheRelationshipIds, externalLinkRelationshipIds, workbookXml, sharedStringsXml, rootRelationshipsXml, appXml, coreXml, tablePartFiles, preparedTables_1, preparedTables_1_1, table, rows, tableXml, stylesXml, themeXml, files, worksheetEntries_1, worksheetEntries_1_1, entry, personsXml, globalImageIndex, globalChartIndex, drawingSheets, imageExtensions, chartEntries, chartExEntries, globalChartExIndex, worksheetEntries_2, worksheetEntries_2_1, entry, placements, textBoxesForSheet, shapesForSheet, chartsForSheet, slicersForSheet, drawingParts, _e, _f, media, _g, _h, chartEntry, _j, _k, chartExEntry, e_1_1, chartEntries_1, chartEntries_1_1, chartEntry, chartExEntries_1, chartExEntries_1_1, chartExEntry, 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, hasVmlDrawings, _l, _m, part, threadedCommentsSheets, contentTypesXml, zipBytes;
     var e_2, _o, e_3, _p, e_4, _q, e_5, _s, e_1, _t, e_6, _u, e_7, _v, e_8, _w, e_9, _x, e_10, _y, e_11, _z, e_12, _0, e_13, _1, e_14, _2, e_15, _3, e_16, _4, e_17, _5;
     var _6, _7, _8, _9, _10, _11, _12, _13, _14;
-    var _conditionalFormats = _b.conditionalFormats, _dataValidations = _b.dataValidations, sheets = _b.sheets, sheetData = _b.sheetData, sourceSharedStrings = _b.sharedStrings, _15 = _b.tables, _tables = _15 === void 0 ? [] : _15, cellXfs = _b.cellXfs, theme = _b.theme, defaultFont = _b.defaultFont, _16 = _b.embeds, embeds = _16 === void 0 ? [] : _16, _17 = _b.charts, charts = _17 === void 0 ? [] : _17, _18 = _b.slicers, slicers = _18 === void 0 ? [] : _18, _19 = _b.pivotTables, pivotTables = _19 === void 0 ? [] : _19, _20 = _b.externalLinks, externalLinks = _20 === void 0 ? [] : _20, _21 = _b.namedRanges, namedRanges = _21 === void 0 ? [] : _21, _22 = _b.protectedRanges, protectedRanges = _22 === void 0 ? [] : _22, namedCellStyles = _b.namedCellStyles, customTableStyles = _b.customTableStyles, iterativeCalculationOptions = _b.iterativeCalculationOptions, ignoreFormulaPatterns = _b.ignoreFormulaPatterns, citations = _b.citations, comments = _b.comments, password = _b.password, locale = _b.locale, _23 = _b.use1904, use1904 = _23 === void 0 ? false : _23, properties = _b.properties, powerQuery = _b.powerQuery;
+    var _conditionalFormats = _b.conditionalFormats, _dataValidations = _b.dataValidations, sheets = _b.sheets, sheetData = _b.sheetData, sourceSharedStrings = _b.sharedStrings, _15 = _b.tables, _tables = _15 === void 0 ? [] : _15, cellXfs = _b.cellXfs, theme = _b.theme, defaultFont = _b.defaultFont, _16 = _b.embeds, embeds = _16 === void 0 ? [] : _16, _17 = _b.charts, charts = _17 === void 0 ? [] : _17, _18 = _b.slicers, slicers = _18 === void 0 ? [] : _18, _19 = _b.pivotTables, pivotTables = _19 === void 0 ? [] : _19, _20 = _b.externalLinks, externalLinks = _20 === void 0 ? [] : _20, _21 = _b.namedRanges, namedRanges = _21 === void 0 ? [] : _21, _22 = _b.protectedRanges, protectedRanges = _22 === void 0 ? [] : _22, namedCellStyles = _b.namedCellStyles, customTableStyles = _b.customTableStyles, iterativeCalculationOptions = _b.iterativeCalculationOptions, workbookProtection = _b.workbookProtection, ignoreFormulaPatterns = _b.ignoreFormulaPatterns, citations = _b.citations, comments = _b.comments, password = _b.password, locale = _b.locale, _23 = _b.use1904, use1904 = _23 === void 0 ? false : _23, properties = _b.properties, powerQuery = _b.powerQuery;
     return __generator(this, function (_24) {
         switch (_24.label) {
             case 0:
@@ -411,13 +411,15 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                         commentsXml: result.commentsXml,
                         vmlDrawingXml: result.vmlDrawingXml,
                         threadedCommentsXml: result.threadedCommentsXml,
+                        hasDynamicArrays: result.hasDynamicArrays,
                     };
                 });
+                hasDynamicArrays = worksheetEntries.some(function (entry) { return entry.hasDynamicArrays; });
                 _d = buildWorkbookRelationships(worksheetEntries.map(function (entry) { return ({
                     chartsheet: entry.isChartsheet,
                     target: entry.path.replace(/^xl\//, ""),
-                }); }), slicerCacheEntries.length, externalLinks.length, pivotCacheEntries.length, !personRegistry.isEmpty()), workbookRelationshipsXml = _d.xml, sheetRelationshipIds = _d.sheetRelationshipIds, slicerCacheRelationshipIds = _d.slicerCacheRelationshipIds, pivotCacheRelationshipIds = _d.pivotCacheRelationshipIds, externalLinkRelationshipIds = _d.externalLinkRelationshipIds;
-                workbookXml = buildWorkbookXml(sortedSheets, sheetRelationshipIds, workbookSheetNames, namedRanges, iterativeCalculationOptions, slicerCacheRelationshipIds, use1904, externalLinkRelationshipIds, pivotCacheRelationshipIds);
+                }); }), slicerCacheEntries.length, externalLinks.length, pivotCacheEntries.length, !personRegistry.isEmpty(), hasDynamicArrays), workbookRelationshipsXml = _d.xml, sheetRelationshipIds = _d.sheetRelationshipIds, slicerCacheRelationshipIds = _d.slicerCacheRelationshipIds, pivotCacheRelationshipIds = _d.pivotCacheRelationshipIds, externalLinkRelationshipIds = _d.externalLinkRelationshipIds;
+                workbookXml = buildWorkbookXml(sortedSheets, sheetRelationshipIds, workbookSheetNames, namedRanges, iterativeCalculationOptions, slicerCacheRelationshipIds, use1904, externalLinkRelationshipIds, pivotCacheRelationshipIds, workbookProtection);
                 sharedStringsXml = buildSharedStringsXml(sharedStrings);
                 rootRelationshipsXml = buildRootRelationshipsXml();
                 appXml = buildAppXml(workbookSheetNames, sortedSheets.map(function (sheet) { return sheet.type === "chartsheet"; }), properties);
@@ -452,6 +454,9 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                     "xl/styles.xml": encodeXml(stylesXml),
                     "xl/theme/theme1.xml": encodeXml(themeXml),
                 };
+                if (hasDynamicArrays) {
+                    files["xl/metadata.xml"] = encodeXml(DYNAMIC_ARRAY_METADATA_XML);
+                }
                 try {
                     for (worksheetEntries_1 = __values(worksheetEntries), worksheetEntries_1_1 = worksheetEntries_1.next(); !worksheetEntries_1_1.done; worksheetEntries_1_1 = worksheetEntries_1.next()) {
                         entry = worksheetEntries_1_1.value;
@@ -744,6 +749,7 @@ export var createExcelFile = function (_a) { return __awaiter(void 0, [_a], void
                     externalLinkCount: externalLinks.length,
                     hasVmlDrawings: hasVmlDrawings,
                     ctrlPropCount: ctrlProps.parts.length,
+                    hasSheetMetadata: hasDynamicArrays,
                 });
                 files["[Content_Types].xml"] = encodeXml(contentTypesXml);
                 // Preserved Power Query machinery (DataMashup customXml, connections.xml, queryTable parts) is
@@ -882,11 +888,12 @@ export var normalizeSqrefMembers = function (refs) {
     return out;
 };
 var DataValidationCollector = /** @class */ (function () {
-    function DataValidationCollector() {
+    function DataValidationCollector(locale) {
+        this.locale = locale;
         this.entries = new Map();
     }
     DataValidationCollector.prototype.add = function (address, rule) {
-        var config = convertDataValidationRule(rule);
+        var config = convertDataValidationRule(rule, this.locale);
         if (!config)
             return;
         var key = getDataValidationKey(config);
@@ -1040,7 +1047,7 @@ var buildWorksheetXml = function (_a) {
     var defaultRowHeightPx = getDefaultRowHeightPx(sheet);
     var rowXmlChunks = [];
     var collectedImages = [];
-    var dataValidationCollector = new DataValidationCollector();
+    var dataValidationCollector = new DataValidationCollector(locale);
     var hyperlinkEntries = [];
     var commentsCollector = new CommentsCollector();
     var threadedCommentsCollector = new ThreadedCommentsCollector(comments, personRegistry !== null && personRegistry !== void 0 ? personRegistry : new PersonRegistry());
@@ -1119,6 +1126,8 @@ var buildWorksheetXml = function (_a) {
     // see `<f t="shared" si="N"/>` with no corresponding leader and read the
     // cell as having no formula at all.
     var validSharedFormulaLeaders = new Set();
+    // Any `cm="1"` anchor on this sheet makes the workbook carry xl/metadata.xml.
+    var hasDynamicArrays = false;
     for (var rowIndex = 1; rowIndex < maxRows; rowIndex++) {
         var row = rows[rowIndex];
         var rowValues = row === null || row === void 0 ? void 0 : row.values;
@@ -1163,6 +1172,9 @@ var buildWorksheetXml = function (_a) {
             sheets: sheets,
             locale: locale,
             validSharedFormulaLeaders: validSharedFormulaLeaders,
+            onDynamicArray: function () {
+                hasDynamicArrays = true;
+            },
             onImage: function (image) {
                 collectedImages.push(image);
                 drawingContext.ensureRel();
@@ -1212,6 +1224,7 @@ var buildWorksheetXml = function (_a) {
         sheetId: sheet.sheetId,
         conditionalFormats: conditionalFormats,
         styleBuilder: styleBuilder,
+        locale: locale,
     });
     var tablePartsXml = buildTablePartsXml(tables, relationships);
     var drawingXml = drawingContext.hasDrawing()
@@ -1307,7 +1320,7 @@ var buildWorksheetXml = function (_a) {
     var sheetFormatPrAttrs = ["defaultRowHeight=\"".concat(defaultRowHeightPt, "\"")];
     if (typeof explicitDefaultColumnWidthPx === "number" &&
         explicitDefaultColumnWidthPx > 0) {
-        sheetFormatPrAttrs.push("defaultColWidth=\"".concat(columnPixelToChars(explicitDefaultColumnWidthPx).toFixed(2), "\""));
+        sheetFormatPrAttrs.push("defaultColWidth=\"".concat(columnPixelToChars(explicitDefaultColumnWidthPx), "\""));
     }
     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(controlsXml).concat(tablePartsXml).concat(extLstXml, "</worksheet>");
     return {
@@ -1317,6 +1330,7 @@ var buildWorksheetXml = function (_a) {
         commentsXml: commentsXml,
         vmlDrawingXml: vmlDrawingXml,
         threadedCommentsXml: threadedCommentsXml,
+        hasDynamicArrays: hasDynamicArrays,
     };
 };
 /**
@@ -1340,6 +1354,7 @@ var buildChartsheetXml = function (_a) {
         commentsXml: undefined,
         vmlDrawingXml: undefined,
         threadedCommentsXml: undefined,
+        hasDynamicArrays: false,
     };
 };
 /**
@@ -1549,7 +1564,7 @@ var normalizeXlsxSourceListFormula1 = function (formula1) {
         return trimmed;
     return "\"".concat(escapeFormulaText(trimmed), "\"");
 };
-var convertDataValidationRule = function (rule) {
+var convertDataValidationRule = function (rule, locale) {
     var _a, _b, _d, _e, _f, _g;
     if (!rule)
         return undefined;
@@ -1592,7 +1607,7 @@ var convertDataValidationRule = function (rule) {
             rejectedListSource = normalizeXlsxSourceListFormula1(src.formula1);
         }
     }
-    var synthesized = convertDataValidationCondition(rule, baseConfig);
+    var synthesized = convertDataValidationCondition(rule, baseConfig, locale);
     if (synthesized)
         return synthesized;
     // A rejected `list` source with no usable condition is still kept — its
@@ -1606,7 +1621,7 @@ var convertDataValidationRule = function (rule) {
 // The condition-based synthesizer: the Excel config for a rule that has no
 // replayable `xlsxSource` (UI-authored, edited after import, or rejected by
 // the round-trip guard above).
-var convertDataValidationCondition = function (rule, baseConfig) {
+var convertDataValidationCondition = function (rule, baseConfig, locale) {
     var _a, _b, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _s, _t, _u, _v, _w, _x, _y, _z;
     if (!((_a = rule.condition) === null || _a === void 0 ? void 0 : _a.type)) {
         // Prompt-only DV (no validation rule, just an input-message tooltip
@@ -1619,10 +1634,9 @@ var convertDataValidationCondition = function (rule, baseConfig) {
     }
     var condition = rule.condition;
     var values = (_b = condition.values) !== null && _b !== void 0 ? _b : [];
+    // OOXML `<formula1>` carries the formula text WITHOUT a leading `=` — Excel
+    // never writes one (the xlsxSource replay path strips it the same way).
     var currentCell = 'INDIRECT("RC",FALSE)';
-    var ensureFormula = function (value) {
-        return value.startsWith("=") ? value : "=".concat(value);
-    };
     var ifErrorWrap = function (formula) { return "IFERROR(".concat(formula, ",TRUE)"); };
     if (condition.type === "ONE_OF_LIST") {
         var entries = values
@@ -1639,62 +1653,61 @@ var convertDataValidationCondition = function (rule, baseConfig) {
             .filter(function (value) { return typeof value === "string"; });
         if (!references.length)
             return undefined;
-        var formula1 = references.join(",");
-        return __assign({ type: "list", formula1: formula1.startsWith("=") ? formula1 : "=".concat(formula1), showDropDown: rule.displayStyle === "plain" ? true : undefined }, baseConfig);
+        return __assign({ type: "list", formula1: stripLeadingEquals(references.join(",")), showDropDown: rule.displayStyle === "plain" ? true : undefined }, baseConfig);
     }
     if (condition.type === "CUSTOM_FORMULA") {
         var raw = (_e = (_d = values[0]) === null || _d === void 0 ? void 0 : _d.userEnteredValue) !== null && _e !== void 0 ? _e : "";
         if (!raw)
             return undefined;
-        return __assign({ type: "custom", formula1: ensureFormula(raw) }, baseConfig);
+        return __assign({ type: "custom", formula1: stripLeadingEquals(raw) }, baseConfig);
     }
     if (condition.type === "BOOLEAN") {
-        return __assign({ type: "custom", formula1: "=OR(".concat(currentCell, "=TRUE,").concat(currentCell, "=FALSE)") }, baseConfig);
+        return __assign({ type: "custom", formula1: "OR(".concat(currentCell, "=TRUE,").concat(currentCell, "=FALSE)") }, baseConfig);
     }
     if (condition.type === "BLANK") {
-        return __assign({ type: "custom", formula1: "=".concat(currentCell, "=\"\"") }, baseConfig);
+        return __assign({ type: "custom", formula1: "".concat(currentCell, "=\"\"") }, baseConfig);
     }
     if (condition.type === "NOT_BLANK") {
-        return __assign({ type: "custom", formula1: "=".concat(currentCell, "<>\"\"") }, baseConfig);
+        return __assign({ type: "custom", formula1: "".concat(currentCell, "<>\"\"") }, baseConfig);
     }
     if (condition.type === "TEXT_EQ" || condition.type === "TEXT_NOT_EQ") {
         var raw = (_g = (_f = values[0]) === null || _f === void 0 ? void 0 : _f.userEnteredValue) !== null && _g !== void 0 ? _g : "";
         if (!raw)
             return undefined;
         var op = condition.type === "TEXT_EQ" ? "=" : "<>";
-        return __assign({ type: "custom", formula1: "=".concat(currentCell).concat(op, "\"").concat(escapeFormulaText(raw), "\"") }, baseConfig);
+        return __assign({ type: "custom", formula1: "".concat(currentCell).concat(op, "\"").concat(escapeFormulaText(raw), "\"") }, baseConfig);
     }
     if (condition.type === "TEXT_CONTAINS") {
         var raw = (_j = (_h = values[0]) === null || _h === void 0 ? void 0 : _h.userEnteredValue) !== null && _j !== void 0 ? _j : "";
         if (!raw)
             return undefined;
-        return __assign({ type: "custom", formula1: "=ISNUMBER(SEARCH(\"".concat(escapeFormulaText(raw), "\",").concat(currentCell, "))") }, baseConfig);
+        return __assign({ type: "custom", formula1: "ISNUMBER(SEARCH(\"".concat(escapeFormulaText(raw), "\",").concat(currentCell, "))") }, baseConfig);
     }
     if (condition.type === "TEXT_NOT_CONTAINS") {
         var raw = (_l = (_k = values[0]) === null || _k === void 0 ? void 0 : _k.userEnteredValue) !== null && _l !== void 0 ? _l : "";
         if (!raw)
             return undefined;
-        return __assign({ type: "custom", formula1: "=ISERROR(SEARCH(\"".concat(escapeFormulaText(raw), "\",").concat(currentCell, "))") }, baseConfig);
+        return __assign({ type: "custom", formula1: "ISERROR(SEARCH(\"".concat(escapeFormulaText(raw), "\",").concat(currentCell, "))") }, baseConfig);
     }
     if (condition.type === "TEXT_STARTS_WITH") {
         var raw = (_o = (_m = values[0]) === null || _m === void 0 ? void 0 : _m.userEnteredValue) !== null && _o !== void 0 ? _o : "";
         if (!raw)
             return undefined;
         var text = escapeFormulaText(raw);
-        return __assign({ type: "custom", formula1: "=LEFT(".concat(currentCell, ",LEN(\"").concat(text, "\"))=\"").concat(text, "\"") }, baseConfig);
+        return __assign({ type: "custom", formula1: "LEFT(".concat(currentCell, ",LEN(\"").concat(text, "\"))=\"").concat(text, "\"") }, baseConfig);
     }
     if (condition.type === "TEXT_ENDS_WITH") {
         var raw = (_q = (_p = values[0]) === null || _p === void 0 ? void 0 : _p.userEnteredValue) !== null && _q !== void 0 ? _q : "";
         if (!raw)
             return undefined;
         var text = escapeFormulaText(raw);
-        return __assign({ type: "custom", formula1: "=RIGHT(".concat(currentCell, ",LEN(\"").concat(text, "\"))=\"").concat(text, "\"") }, baseConfig);
+        return __assign({ type: "custom", formula1: "RIGHT(".concat(currentCell, ",LEN(\"").concat(text, "\"))=\"").concat(text, "\"") }, baseConfig);
     }
     if (condition.type === "TEXT_IS_EMAIL") {
-        return __assign({ type: "custom", formula1: "=AND(ISNUMBER(SEARCH(\"@\",".concat(currentCell, ")),ISNUMBER(SEARCH(\".\",").concat(currentCell, ")))") }, baseConfig);
+        return __assign({ type: "custom", formula1: "AND(ISNUMBER(SEARCH(\"@\",".concat(currentCell, ")),ISNUMBER(SEARCH(\".\",").concat(currentCell, ")))") }, baseConfig);
     }
     if (condition.type === "TEXT_IS_URL") {
-        return __assign({ type: "custom", formula1: "=OR(LEFT(".concat(currentCell, ",7)=\"http://\",LEFT(").concat(currentCell, ",8)=\"https://\")") }, baseConfig);
+        return __assign({ type: "custom", formula1: "OR(LEFT(".concat(currentCell, ",7)=\"http://\",LEFT(").concat(currentCell, ",8)=\"https://\")") }, baseConfig);
     }
     if (condition.type === "NUMBER_BETWEEN" ||
         condition.type === "NUMBER_NOT_BETWEEN" ||
@@ -1718,9 +1731,12 @@ var convertDataValidationCondition = function (rule, baseConfig) {
             NUMBER_LESS: "lessThan",
             NUMBER_LESS_THAN_EQ: "lessThanOrEqual",
         };
-        return __assign({ type: "decimal", operator: operatorMap[condition.type], formula1: first, formula2: condition.type === "NUMBER_BETWEEN" ||
+        // Bounds are written the way Excel stores them: typed literals normalized
+        // (`50%` → `0.5`, a typed date → its serial), formulas without their `=`,
+        // references / names / function calls verbatim.
+        return __assign({ type: "decimal", operator: operatorMap[condition.type], formula1: conditionOperandToFormulaText(first, locale), formula2: condition.type === "NUMBER_BETWEEN" ||
                 condition.type === "NUMBER_NOT_BETWEEN"
-                ? second
+                ? conditionOperandToFormulaText(second, locale)
                 : undefined }, baseConfig);
     }
     if (condition.type === "NUMBER_GREATER_THAN_PREVIOUS" ||
@@ -1734,7 +1750,7 @@ var convertDataValidationCondition = function (rule, baseConfig) {
             NUMBER_LESS_THAN_EQ_PREVIOUS: "<=",
         };
         var op = opMap[condition.type];
-        return __assign({ type: "custom", formula1: "=".concat(ifErrorWrap("".concat(currentCell).concat(op, "INDIRECT(\"R[-1]C\",FALSE)"))) }, baseConfig);
+        return __assign({ type: "custom", formula1: "".concat(ifErrorWrap("".concat(currentCell).concat(op, "INDIRECT(\"R[-1]C\",FALSE)"))) }, baseConfig);
     }
     if (condition.type === "DATE_EQ" ||
         condition.type === "DATE_NOT_EQ" ||
@@ -1758,13 +1774,13 @@ var convertDataValidationCondition = function (rule, baseConfig) {
             DATE_BETWEEN: "between",
             DATE_NOT_BETWEEN: "notBetween",
         };
-        return __assign({ type: "date", operator: operatorMap[condition.type], formula1: first, formula2: condition.type === "DATE_BETWEEN" ||
+        return __assign({ type: "date", operator: operatorMap[condition.type], formula1: conditionOperandToFormulaText(first, locale), formula2: condition.type === "DATE_BETWEEN" ||
                 condition.type === "DATE_NOT_BETWEEN"
-                ? second
+                ? conditionOperandToFormulaText(second, locale)
                 : undefined }, baseConfig);
     }
     if (condition.type === "DATE_IS_VALID") {
-        return __assign({ type: "custom", formula1: "=ISNUMBER(".concat(currentCell, ")") }, baseConfig);
+        return __assign({ type: "custom", formula1: "ISNUMBER(".concat(currentCell, ")") }, baseConfig);
     }
     return undefined;
 };
@@ -1845,7 +1861,7 @@ var resolveCellDataValidation = function (cell, map) {
 };
 var buildWorksheetRow = function (_a) {
     var _b, _d;
-    var rowNumber = _a.rowNumber, row = _a.row, rowMetadata = _a.rowMetadata, defaultRowHeightPx = _a.defaultRowHeightPx, 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 rowNumber = _a.rowNumber, row = _a.row, rowMetadata = _a.rowMetadata, defaultRowHeightPx = _a.defaultRowHeightPx, 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, onDynamicArray = _a.onDynamicArray;
     var values = (_b = row === null || row === void 0 ? void 0 : row.values) !== null && _b !== void 0 ? _b : [];
     var cellXmlChunks = [];
     var minColumn = Number.POSITIVE_INFINITY;
@@ -1874,6 +1890,7 @@ var buildWorksheetRow = function (_a) {
             sheets: sheets,
             locale: locale,
             validSharedFormulaLeaders: validSharedFormulaLeaders,
+            onDynamicArray: onDynamicArray,
         });
         if (!cellXml)
             continue;
@@ -1946,8 +1963,8 @@ var buildWorksheetRow = function (_a) {
 };
 var buildCellXml = function (_a) {
     var e_33, _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 _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    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, onDynamicArray = _a.onDynamicArray;
     var normalizedCell = cell;
     if (!normalizedCell)
         return undefined;
@@ -2091,12 +2108,25 @@ var buildCellXml = function (_a) {
     }
     var xmlParts = [];
     var typeAttr = "";
+    var dynamicArrayAttr = "";
     if (exportedFormulaValue) {
         // Array formula anchor: emit <f t="array" ref="..."/>. Spilled cells in
         // the range carry no `ue` formula (they're populated by the calculator
         // as side-effects of the anchor's evaluation), so they never reach this
-        // branch and correctly emit only <v>.
-        var arrayRef = normalizedCell.af;
+        // branch and correctly emit only <v>. `af` is stamped by the calculator
+        // on every spilling anchor and captured from `<f t="array" ref>` on
+        // import; a bare array constant (`={1,2;3,4}`) that never went through
+        // the calculator still gets its range from the constant's own shape.
+        var arrayRef = (_m = normalizedCell.af) !== null && _m !== void 0 ? _m : arrayConstantSpillRef(exportedFormulaValue, rowNumber, columnIndex);
+        // Excel distinguishes the two kinds of `<f t="array">`: a dynamic array
+        // carries `cm="1"` on the `<c>` (pointing at the XLDAPR record in
+        // xl/metadata.xml) and re-opens as a spilling formula; without `cm` Excel
+        // reads a legacy Ctrl+Shift+Enter array (`{=…}`). Only an anchor imported
+        // as a CSE array (`cse`) is written back that way.
+        if (arrayRef && !(normalizedCell.af && normalizedCell.cse)) {
+            dynamicArrayAttr = " cm=\"1\"";
+            onDynamicArray === null || onDynamicArray === void 0 ? void 0 : onDynamicArray();
+        }
         // Shared formula: emit `<f t="shared" si="N" ref="A1:A10">FORMULA</f>`
         // on the leader cell (carries both `si` and `ref`) and
         // `<f t="shared" si="N"/>` on followers (carries only `si` — no formula
@@ -2181,7 +2211,7 @@ var buildCellXml = function (_a) {
         }
         return "<c r=\"".concat(address, "\"").concat(styleAttr, "/>");
     }
-    return "<c r=\"".concat(address, "\"").concat(typeAttr).concat(styleAttr, ">").concat(xmlParts.join(""), "</c>");
+    return "<c r=\"".concat(address, "\"").concat(typeAttr).concat(styleAttr).concat(dynamicArrayAttr, ">").concat(xmlParts.join(""), "</c>");
 };
 var normalizeHyperlinkValue = function (hyperlink) {
     if (!hyperlink) {
@@ -2267,6 +2297,56 @@ function stripFormula(formula) {
     var trimmed = formula.startsWith("=") ? formula.slice(1) : formula;
     return sanitizeFormulaText(trimmed);
 }
+/**
+ * The A1 range an array constant spills over from its anchor: `={1,2;3,4}` at
+ * B3 → `B3:C4`. `undefined` for anything that is not exactly one array
+ * constant (a constant nested in a larger expression, a malformed literal).
+ * Separators inside string elements are skipped.
+ */
+function arrayConstantSpillRef(formula, rowNumber, columnIndex) {
+    var e_34, _a;
+    var body = (formula.startsWith("=") ? formula.slice(1) : formula).trim();
+    if (!body.startsWith("{") || !body.endsWith("}"))
+        return undefined;
+    var rows = 1;
+    var columns = 1;
+    var inString = false;
+    try {
+        for (var _b = __values(body.slice(1, -1)), _d = _b.next(); !_d.done; _d = _b.next()) {
+            var char = _d.value;
+            if (char === '"') {
+                inString = !inString;
+            }
+            else if (inString) {
+                continue;
+            }
+            else if (char === "{" || char === "}") {
+                return undefined;
+            }
+            else if (char === "," && rows === 1) {
+                columns++;
+            }
+            else if (char === ";") {
+                rows++;
+            }
+        }
+    }
+    catch (e_34_1) { e_34 = { error: e_34_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_34) throw e_34.error; }
+    }
+    if (inString)
+        return undefined;
+    return cellRangeToAddress(undefined, {
+        startRowIndex: rowNumber,
+        startColumnIndex: columnIndex,
+        endRowIndex: rowNumber + rows - 1,
+        endColumnIndex: columnIndex + columns - 1,
+    });
+}
 function hasPropertyReference(formula) {
     if (!formula)
         return false;
@@ -2284,7 +2364,7 @@ function isValidExcelDateSerial(value) {
     return value >= MIN_EXCEL_DATE_SERIAL && value <= MAX_EXCEL_DATE_SERIAL;
 }
 function rewriteTableNamesInFormula(formula, tableNameMap) {
-    var e_34, _a;
+    var e_35, _a;
     if (!(tableNameMap === null || tableNameMap === void 0 ? void 0 : tableNameMap.size))
         return formula;
     var normalized = formula;
@@ -2299,12 +2379,12 @@ function rewriteTableNamesInFormula(formula, tableNameMap) {
             normalized = normalized.replace(new RegExp("".concat(escaped, "(?=\\[)"), "g"), exportedName);
         }
     }
-    catch (e_34_1) { e_34 = { error: e_34_1 }; }
+    catch (e_35_1) { e_35 = { error: e_35_1 }; }
     finally {
         try {
             if (tableNameMap_1_1 && !tableNameMap_1_1.done && (_a = tableNameMap_1.return)) _a.call(tableNameMap_1);
         }
-        finally { if (e_34) throw e_34.error; }
+        finally { if (e_35) throw e_35.error; }
     }
     return normalized;
 }
@@ -2400,6 +2480,30 @@ function rewriteStructuredReferenceFormula(formula, tableNameMap, tables, rowNum
     var qualified = prefixUnqualifiedStructuredReferences(normalized, table.name);
     return normalizeThisRowStructuredReferences(qualified, table.name);
 }
+/**
+ * `xl/metadata.xml` for a workbook with dynamic-array anchors — one XLDAPR
+ * (dynamic array properties) record every `cm="1"` cell points at, exactly as
+ * Excel 365 writes it. `fDynamic="1"` marks the anchor as a spilling formula;
+ * `fCollapsed="0"` says the spill is shown expanded.
+ */
+var DYNAMIC_ARRAY_METADATA_XML = "".concat(XML_DECLARATION, "<metadata xmlns=\"").concat(WORKSHEET_NS, "\" xmlns:xda=\"http://schemas.microsoft.com/office/spreadsheetml/2017/dynamicarray\"><metadataTypes count=\"1\"><metadataType name=\"XLDAPR\" minSupportedVersion=\"120000\" copy=\"1\" pasteAll=\"1\" pasteValues=\"1\" merge=\"1\" splitFirst=\"1\" rowColShift=\"1\" clearFormats=\"1\" clearComments=\"1\" assign=\"1\" coerce=\"1\" cellMeta=\"1\"/></metadataTypes><futureMetadata name=\"XLDAPR\" count=\"1\"><bk><extLst><ext uri=\"{bdbb8cdc-fa1e-496e-a857-3c3f30c029c3}\"><xda:dynamicArrayProperties fDynamic=\"1\" fCollapsed=\"0\"/></ext></extLst></bk></futureMetadata><cellMetadata count=\"1\"><bk><rc t=\"1\" v=\"0\"/></bk></cellMetadata></metadata>");
+/**
+ * A defined-name expression that is a formula rather than a constant: a
+ * function call, an operator expression, a reference. Constants (`123`,
+ * `"text"`, `TRUE`) are written verbatim.
+ */
+function isAFormulaExpression(expression) {
+    var trimmed = expression.trim();
+    if (!trimmed)
+        return false;
+    if (/^"(?:[^"]|"")*"$/.test(trimmed))
+        return false;
+    if (/^-?\d+(?:\.\d+)?(?:e[+-]?\d+)?%?$/i.test(trimmed))
+        return false;
+    if (/^(?:TRUE|FALSE)$/i.test(trimmed))
+        return false;
+    return true;
+}
 function sanitizeFormulaText(formula) {
     var normalized = sanitizeXmlText(formula);
     // `@x` is persisted as `_xlfn.SINGLE(x)`; encoding first lets the
@@ -2514,8 +2618,11 @@ var buildColumnsXml = function (sheet, bounds) {
             continue;
         var attributes = ["min=\"".concat(columnIndex, "\""), "max=\"".concat(columnIndex, "\"")];
         if (hasExplicitSize) {
+            // Full precision on purpose: the stored value is a multiple of 1/256
+            // (Excel writes e.g. 9.140625), and rounding to two decimals would
+            // break the exact export → import pixel fixed point.
             var width = columnPixelToChars(getColumnWidthPx(sheet, columnIndex - 1));
-            attributes.push("width=\"".concat(width.toFixed(2), "\""));
+            attributes.push("width=\"".concat(width, "\""));
             attributes.push("customWidth=\"1\"");
         }
         if (hasHiddenFlag) {
@@ -2704,7 +2811,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_35, _a;
+    var e_36, _a;
     var sorted = __spreadArray([], __read(runs), false).sort(function (a, b) { return a.startIndex - b.startIndex; });
     var out = [];
     var cursor = 0;
@@ -2737,12 +2844,12 @@ var buildRichTextRuns = function (text, runs) {
                 cursor = end;
         }
     }
-    catch (e_35_1) { e_35 = { error: e_35_1 }; }
+    catch (e_36_1) { e_36 = { error: e_36_1 }; }
     finally {
         try {
             if (sorted_2_1 && !sorted_2_1.done && (_a = sorted_2.return)) _a.call(sorted_2);
         }
-        finally { if (e_35) throw e_35.error; }
+        finally { if (e_36) throw e_36.error; }
     }
     if (cursor < text.length) {
         emit(text.slice(cursor), "");
@@ -2763,7 +2870,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_36, _a;
+    var e_37, _a;
     var _b;
     var map = new Map();
     try {
@@ -2775,12 +2882,12 @@ var buildTableNameMap = function (tables) {
             map.set(tableTitle, table.name);
         }
     }
-    catch (e_36_1) { e_36 = { error: e_36_1 }; }
+    catch (e_37_1) { e_37 = { error: e_37_1 }; }
     finally {
         try {
             if (tables_1_1 && !tables_1_1.done && (_a = tables_1.return)) _a.call(tables_1);
         }
-        finally { if (e_36) throw e_36.error; }
+        finally { if (e_37) throw e_37.error; }
     }
     return map;
 };
@@ -2788,7 +2895,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_37, _a;
+    var e_38, _a;
     var _b;
     var isValidBox = function (range) {
         if (!range)
@@ -2831,12 +2938,12 @@ var filterExportableTables = function (tables) {
             _loop_5(table);
         }
     }
-    catch (e_37_1) { e_37 = { error: e_37_1 }; }
+    catch (e_38_1) { e_38 = { error: e_38_1 }; }
     finally {
         try {
             if (tables_2_1 && !tables_2_1.done && (_a = tables_2.return)) _a.call(tables_2);
         }
-        finally { if (e_37) throw e_37.error; }
+        finally { if (e_38) throw e_38.error; }
     }
     return result;
 };
@@ -3000,11 +3107,17 @@ var buildTableXml = function (table, rows, sourceSharedStrings, styleBuilder, cu
         .filter(function (idx) { var _a, _b; return ((_b = (_a = table.columns) === null || _a === void 0 ? void 0 : _a[idx]) === null || _b === void 0 ? void 0 : _b.filterButton) === false; }));
     var autoFilter = headerRowCount > 0 && table.filterButton !== false
         ? (function () {
-            var _a, _b, _d;
+            var _a, _b, _d, _e;
             var filterColumns = buildFilterColumnsXml((_a = table.filterSpecs) !== null && _a !== void 0 ? _a : [], table.range, rows, (_b = table.headerRow) !== null && _b !== void 0 ? _b : true, (_d = table.totalRow) !== null && _d !== void 0 ? _d : false, styleBuilder, hiddenButtonColumns);
+            // Excel's table `<autoFilter ref>` spans the header and data rows
+            // only — a ref that reaches into the totals row makes Excel repair
+            // the table (the totals row is never filtered or sorted).
+            var filterRef = totalsRowCount > 0
+                ? ((_e = gridRangeToRef(__assign(__assign({}, table.range), { endRowIndex: table.range.endRowIndex - totalsRowCount }))) !== null && _e !== void 0 ? _e : rangeRef)
+                : rangeRef;
             return filterColumns
-                ? "<autoFilter ref=\"".concat(rangeRef, "\">").concat(filterColumns, "</autoFilter>")
-                : "<autoFilter ref=\"".concat(rangeRef, "\"/>");
+                ? "<autoFilter ref=\"".concat(filterRef, "\">").concat(filterColumns, "</autoFilter>")
+                : "<autoFilter ref=\"".concat(filterRef, "\"/>");
         })()
         : "";
     var sortState = buildTableSortStateXml(table, headerRowCount, totalsRowCount, styleBuilder);
@@ -3119,7 +3232,7 @@ var SHEET_PROTECTION_FLAG_ATTRS = [
  * Excel's schema default applies). Mirrors `rnc-export`'s `sheet_protection_xml`.
  */
 var buildSheetProtectionElementXml = function (protection) {
-    var e_38, _a;
+    var e_39, _a;
     var attrs = [];
     if (protection.algorithmName) {
         attrs.push("algorithmName=\"".concat(escapeXmlAttr(protection.algorithmName), "\""));
@@ -3145,12 +3258,12 @@ var buildSheetProtectionElementXml = function (protection) {
             }
         }
     }
-    catch (e_38_1) { e_38 = { error: e_38_1 }; }
+    catch (e_39_1) { e_39 = { error: e_39_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_38) throw e_38.error; }
+        finally { if (e_39) throw e_39.error; }
     }
     return attrs.length ? "<sheetProtection ".concat(attrs.join(" "), "/>") : "";
 };
@@ -3162,7 +3275,7 @@ var buildSheetProtectionElementXml = function (protection) {
  * is the range's id, synthesized as `Range{n}` when absent (schema requires it).
  */
 var buildSheetProtectionXml = function (sheet, protectedRanges) {
-    var e_39, _a;
+    var e_40, _a;
     var protectionXml = sheet.sheetProtection
         ? buildSheetProtectionElementXml(sheet.sheetProtection)
         : "";
@@ -3203,12 +3316,12 @@ var buildSheetProtectionXml = function (sheet, protectedRanges) {
             rangeItems.push("<protectedRange sqref=\"".concat(escapeXmlAttr(sqref), "\" name=\"").concat(escapeXmlAttr(name_1), "\"").concat(securityDescriptor, "/>"));
         }
     }
-    catch (e_39_1) { e_39 = { error: e_39_1 }; }
+    catch (e_40_1) { e_40 = { error: e_40_1 }; }
     finally {
         try {
             if (_d && !_d.done && (_a = _b.return)) _a.call(_b);
         }
-        finally { if (e_39) throw e_39.error; }
+        finally { if (e_40) throw e_40.error; }
     }
     var rangesXml = rangeItems.length
         ? "<protectedRanges>".concat(rangeItems.join(""), "</protectedRanges>")
@@ -3341,7 +3454,7 @@ var buildPrintSettingsXml = function (print) {
 var buildFilterColumnsXml = function (filterSpecs, range, rows, headerRow, totalRow, styleBuilder, 
 /** Table-relative column ids whose header hides its filter button. */
 hiddenButtonColumns) {
-    var e_40, _a;
+    var e_41, _a;
     if (headerRow === void 0) { headerRow = true; }
     if (totalRow === void 0) { totalRow = false; }
     var entries = new Map();
@@ -3353,12 +3466,12 @@ hiddenButtonColumns) {
                 entries.set(spec.columnIndex, xml);
         }
     }
-    catch (e_40_1) { e_40 = { error: e_40_1 }; }
+    catch (e_41_1) { e_41 = { error: e_41_1 }; }
     finally {
         try {
             if (_d && !_d.done && (_a = _b.return)) _a.call(_b);
         }
-        finally { if (e_40) throw e_40.error; }
+        finally { if (e_41) throw e_41.error; }
     }
     // `hiddenButton="1"` rides the column's criteria element when it has one,
     // else a bare `<filterColumn/>` carries it.
@@ -3379,55 +3492,99 @@ hiddenButtonColumns) {
     })
         .join("");
 };
+/**
+ * One `<filterColumn colId=…>`, or `""` when the criteria have no autoFilter
+ * representation. `CT_FilterColumn` is a CHOICE of exactly one of `filters` /
+ * `top10` / `customFilters` / `dynamicFilter` / `colorFilter` / `iconFilter` —
+ * a second child is a schema violation Excel repairs — so the first
+ * representable criterion wins: colorFilter, iconFilter, condition(s), then
+ * the value list (`<filters>`: the checked values, `blank="1"` for the
+ * "(Blanks)" entry, and Excel's `<dateGroupItem>` date-tree entries). The
+ * Rust exporter (`rnc-export` `filter_column_xml`) uses the same precedence.
+ */
 var buildFilterColumnXml = function (spec, range, rows, headerRow, totalRow, styleBuilder) {
     var _a, _b, _d, _e, _f;
     if (headerRow === void 0) { headerRow = true; }
     if (totalRow === void 0) { totalRow = false; }
-    var parts = [];
-    // <colorFilter dxfId="N" cellColor="1|0"/> — Excel matches against the
-    // dxf table. We register the color as a dxf and emit the resulting id.
-    var colorFilter = (_a = spec.filterCriteria) === null || _a === void 0 ? void 0 : _a.colorFilter;
-    if (colorFilter && styleBuilder) {
-        var dxfId = colorFilter.mode === "cellColor"
-            ? styleBuilder.registerDifferentialFormat({
-                backgroundColor: colorFilter.color,
-            })
-            : styleBuilder.registerDifferentialFormat({
-                textFormat: { color: colorFilter.color },
-            });
-        if (typeof dxfId === "number") {
-            var cellColorAttr = colorFilter.mode === "cellColor" ? "1" : "0";
-            parts.push("<colorFilter dxfId=\"".concat(dxfId, "\" cellColor=\"").concat(cellColorAttr, "\"/>"));
-        }
-    }
-    // <iconFilter iconSet="…" iconId="…"/>
-    var iconFilter = (_b = spec.filterCriteria) === null || _b === void 0 ? void 0 : _b.iconFilter;
-    if (iconFilter === null || iconFilter === void 0 ? void 0 : iconFilter.iconSet) {
-        parts.push("<iconFilter iconSet=\"".concat(escapeXmlAttr(iconFilter.iconSet), "\" iconId=\"").concat((_d = iconFilter.iconId) !== null && _d !== void 0 ? _d : 0, "\"/>"));
-    }
-    // A condition filter (greater-than / contains / between / relative-date /
-    // above-average …) takes precedence over a value-list and is emitted as
-    // <customFilters> or <dynamicFilter>. Falls back to the value list when the
-    // condition has no AutoFilter representation.
-    var conditionXml = spec.filterCriteria
+    var child = (_f = (_e = (_b = buildColorFilterXml((_a = spec.filterCriteria) === null || _a === void 0 ? void 0 : _a.colorFilter, styleBuilder)) !== null && _b !== void 0 ? _b : buildIconFilterXml((_d = spec.filterCriteria) === null || _d === void 0 ? void 0 : _d.iconFilter)) !== null && _e !== void 0 ? _e : (spec.filterCriteria
         ? buildAutoFilterCriteriaXml(spec.filterCriteria)
-        : null;
-    if (conditionXml) {
-        parts.push(conditionXml);
-    }
-    else {
-        // <filters><filter val=…/></filters>
-        var values = (_f = (_e = spec.filterCriteria) === null || _e === void 0 ? void 0 : _e.visibleValues) !== null && _f !== void 0 ? _f : getFilterVisibleValues(spec, range, rows, headerRow, totalRow);
-        if (values === null || values === void 0 ? void 0 : values.length) {
-            var filters = values
-                .map(function (value) { return "<filter val=\"".concat(escapeXmlAttr(value), "\"/>"); })
-                .join("");
-            parts.push("<filters>".concat(filters, "</filters>"));
-        }
-    }
-    if (!parts.length)
+        : null)) !== null && _f !== void 0 ? _f : buildFilterValueListXml(spec, range, rows, headerRow, totalRow);
+    if (!child)
         return "";
-    return "<filterColumn colId=\"".concat(spec.columnIndex, "\">").concat(parts.join(""), "</filterColumn>");
+    return "<filterColumn colId=\"".concat(spec.columnIndex, "\">").concat(child, "</filterColumn>");
+};
+/**
+ * `<colorFilter dxfId="N" cellColor="1|0"/>` — Excel matches against the dxf
+ * table; the color is registered as a dxf and referenced by id.
+ */
+var buildColorFilterXml = function (colorFilter, styleBuilder) {
+    if (!colorFilter || !styleBuilder)
+        return null;
+    var dxfId = colorFilter.mode === "cellColor"
+        ? styleBuilder.registerDifferentialFormat({
+            backgroundColor: colorFilter.color,
+        })
+        : styleBuilder.registerDifferentialFormat({
+            textFormat: { color: colorFilter.color },
+        });
+    if (typeof dxfId !== "number")
+        return null;
+    var cellColorAttr = colorFilter.mode === "cellColor" ? "1" : "0";
+    return "<colorFilter dxfId=\"".concat(dxfId, "\" cellColor=\"").concat(cellColorAttr, "\"/>");
+};
+/** `<iconFilter iconSet="…" iconId="…"/>`. */
+var buildIconFilterXml = function (iconFilter) {
+    var _a;
+    if (!(iconFilter === null || iconFilter === void 0 ? void 0 : iconFilter.iconSet))
+        return null;
+    return "<iconFilter iconSet=\"".concat(escapeXmlAttr(iconFilter.iconSet), "\" iconId=\"").concat((_a = iconFilter.iconId) !== null && _a !== void 0 ? _a : 0, "\"/>");
+};
+/**
+ * `<filters>` — the checked values (`blank="1"` for the engine's "(Blanks)"
+ * sentinel; Excel never writes it as a `<filter val>`) plus the date-grouped
+ * `<dateGroupItem>` entries. Without explicit `visibleValues` the list is
+ * derived from the column's cells (every value visible).
+ */
+var buildFilterValueListXml = function (spec, range, rows, headerRow, totalRow) {
+    var _a, _b, _d, _e;
+    var dateGroups = (_b = (_a = spec.filterCriteria) === null || _a === void 0 ? void 0 : _a.dateGroups) !== null && _b !== void 0 ? _b : [];
+    var values = (_e = (_d = spec.filterCriteria) === null || _d === void 0 ? void 0 : _d.visibleValues) !== null && _e !== void 0 ? _e : (dateGroups.length
+        ? []
+        : getFilterVisibleValues(spec, range, rows, headerRow, totalRow));
+    if (!values.length && !dateGroups.length)
+        return null;
+    var showBlanks = values.includes(BLANK_LABEL);
+    var filters = values
+        .filter(function (value) { return value !== BLANK_LABEL; })
+        .map(function (value) { return "<filter val=\"".concat(escapeXmlAttr(value), "\"/>"); })
+        .join("");
+    var groups = dateGroups
+        .map(function (group) {
+        var e_42, _a;
+        var _b;
+        var attrs = ["year=\"".concat(group.year, "\"")];
+        try {
+            for (var _d = __values(["month", "day", "hour", "minute", "second"]), _e = _d.next(); !_e.done; _e = _d.next()) {
+                var name_2 = _e.value;
+                var value = group[name_2];
+                if (value !== undefined && value !== null) {
+                    attrs.push("".concat(name_2, "=\"").concat(value, "\""));
+                }
+            }
+        }
+        catch (e_42_1) { e_42 = { error: e_42_1 }; }
+        finally {
+            try {
+                if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+            }
+            finally { if (e_42) throw e_42.error; }
+        }
+        attrs.push("dateTimeGrouping=\"".concat(escapeXmlAttr((_b = group.dateTimeGrouping) !== null && _b !== void 0 ? _b : "day"), "\""));
+        return "<dateGroupItem ".concat(attrs.join(" "), "/>");
+    })
+        .join("");
+    var blankAttr = showBlanks ? " blank=\"1\"" : "";
+    return "<filters".concat(blankAttr, ">").concat(filters).concat(groups, "</filters>");
 };
 var gridRangeToRef = function (range) {
     if (!range)
@@ -3695,7 +3852,7 @@ var groupChartsBySheet = function (charts) {
     return result;
 };
 var groupSlicersBySheet = function (slicers) {
-    var e_41, _a;
+    var e_43, _a;
     var _b, _d, _e, _f, _g, _h;
     var result = new Map();
     try {
@@ -3718,19 +3875,19 @@ var groupSlicersBySheet = function (slicers) {
             result.set(slicer.position.sheetId, list);
         }
     }
-    catch (e_41_1) { e_41 = { error: e_41_1 }; }
+    catch (e_43_1) { e_43 = { error: e_43_1 }; }
     finally {
         try {
             if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
         }
-        finally { if (e_41) throw e_41.error; }
+        finally { if (e_43) throw e_43.error; }
     }
     return result;
 };
 var buildConditionalFormattingXml = function (_a) {
-    var e_42, _b;
+    var e_44, _b;
     var _d, _e, _f;
-    var conditionalFormats = _a.conditionalFormats, sheetId = _a.sheetId, styleBuilder = _a.styleBuilder;
+    var conditionalFormats = _a.conditionalFormats, sheetId = _a.sheetId, styleBuilder = _a.styleBuilder, locale = _a.locale;
     if (!(conditionalFormats === null || conditionalFormats === void 0 ? void 0 : conditionalFormats.length)) {
         return "";
     }
@@ -3782,6 +3939,7 @@ var buildConditionalFormattingXml = function (_a) {
                 styleBuilder: styleBuilder,
                 priority: basePriority,
                 baseCellAddress: baseCellAddress,
+                locale: locale,
             });
             if (!(cfRulesXml === null || cfRulesXml === void 0 ? void 0 : cfRulesXml.length))
                 continue;
@@ -3792,12 +3950,12 @@ var buildConditionalFormattingXml = function (_a) {
             parts.push("<conditionalFormatting sqref=\"".concat(sqrefParts.join(" "), "\">").concat(ruleXmlEntries.join(""), "</conditionalFormatting>"));
         }
     }
-    catch (e_42_1) { e_42 = { error: e_42_1 }; }
+    catch (e_44_1) { e_44 = { error: e_44_1 }; }
     finally {
         try {
             if (orderedRules_1_1 && !orderedRules_1_1.done && (_b = orderedRules_1.return)) _b.call(orderedRules_1);
         }
-        finally { if (e_42) throw e_42.error; }
+        finally { if (e_44) throw e_44.error; }
     }
     return parts.join("");
 };
@@ -3897,7 +4055,7 @@ var buildXlsxSourceCfRuleXml = function (rule, styleBuilder, priority) {
 };
 var buildConditionalFormattingRuleXml = function (_a) {
     var _b;
-    var rule = _a.rule, styleBuilder = _a.styleBuilder, priority = _a.priority, baseCellAddress = _a.baseCellAddress;
+    var rule = _a.rule, styleBuilder = _a.styleBuilder, priority = _a.priority, baseCellAddress = _a.baseCellAddress, locale = _a.locale;
     // Round-trip via xlsxSource when present (imported rules). Falls through
     // to synthesizer for rules without source metadata (UI-created).
     if ((_b = rule.xlsxSource) === null || _b === void 0 ? void 0 : _b.type) {
@@ -4035,8 +4193,11 @@ var buildConditionalFormattingRuleXml = function (_a) {
                 NUMBER_LESS_THAN_EQ: "lessThanOrEqual",
             };
             var operator = operatorMap[condition.type];
-            var first = stripFormula(firstRaw);
-            var second = stripFormula(secondRaw);
+            // Typed literals are written the way Excel stores them (`50%` → `0.5`,
+            // a typed date → its serial); formulas lose their `=`; references, names
+            // and function calls are written verbatim.
+            var first = conditionOperandToFormulaText(stripFormula(firstRaw), locale);
+            var second = conditionOperandToFormulaText(stripFormula(secondRaw), locale);
             if ((operator === "between" || operator === "notBetween") && !secondRaw) {
                 return undefined;
             }
@@ -4066,17 +4227,12 @@ var buildConditionalFormattingRuleXml = function (_a) {
                 DATE_BETWEEN: "between",
                 DATE_NOT_BETWEEN: "notBetween",
             };
+            // A typed date (`2024-01-05`, `1/5/2024` in the document locale) is
+            // exported as its serial — what Excel itself stores; the bare text would
+            // be the arithmetic 2024-01-05 = 2022. Formulas lose their `=`;
+            // references and function calls are written verbatim.
             var normalizeDateValue = function (raw) {
-                var trimmed = raw.trim();
-                if (!trimmed)
-                    return "";
-                if (trimmed.startsWith("=")) {
-                    return stripFormula(trimmed);
-                }
-                if (!isNaN(Number(trimmed))) {
-                    return trimmed;
-                }
-                return "DATEVALUE(\"".concat(escapeFormulaText(trimmed), "\")");
+                return conditionOperandToFormulaText(stripFormula(raw), locale);
             };
             var first = normalizeDateValue(firstRaw);
             var second = normalizeDateValue(secondRaw);
@@ -4293,8 +4449,8 @@ 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, chartExIndex, pictureId, frameId, chartEntries, chartExEntries, orderedAnchors, orderOf, charts_1, charts_1_1, placement, chartExXml, relId_1, 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_43_1, orderedAnchors_1, orderedAnchors_1_1, entry, drawingXml;
-    var e_44, _d, e_45, _e, e_46, _f, e_47, _g, e_43, _h, e_48, _j;
+    var anchors, relationships, media, imageIndex, chartIndex, chartExIndex, pictureId, frameId, chartEntries, chartExEntries, orderedAnchors, orderOf, charts_1, charts_1_1, placement, chartExXml, relId_1, 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_45_1, orderedAnchors_1, orderedAnchors_1_1, entry, drawingXml;
+    var e_46, _d, e_47, _e, e_48, _f, e_49, _g, e_45, _h, e_50, _j;
     var placements = _b.placements, textBoxes = _b.textBoxes, _k = _b.shapes, shapes = _k === void 0 ? [] : _k, startImageIndex = _b.startImageIndex, startChartIndex = _b.startChartIndex, _l = _b.startChartExIndex, startChartExIndex = _l === void 0 ? 1 : _l, charts = _b.charts, slicers = _b.slicers, sheet = _b.sheet, sheetNameById = _b.sheetNameById, resolvePivotSourceName = _b.resolvePivotSourceName;
     return __generator(this, function (_m) {
         switch (_m.label) {
@@ -4366,12 +4522,12 @@ var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         frameId += 1;
                     }
                 }
-                catch (e_44_1) { e_44 = { error: e_44_1 }; }
+                catch (e_46_1) { e_46 = { error: e_46_1 }; }
                 finally {
                     try {
                         if (charts_1_1 && !charts_1_1.done && (_d = charts_1.return)) _d.call(charts_1);
                     }
-                    finally { if (e_44) throw e_44.error; }
+                    finally { if (e_46) throw e_46.error; }
                 }
                 try {
                     for (slicers_1 = __values(slicers), slicers_1_1 = slicers_1.next(); !slicers_1_1.done; slicers_1_1 = slicers_1.next()) {
@@ -4384,12 +4540,12 @@ var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         frameId += 1;
                     }
                 }
-                catch (e_45_1) { e_45 = { error: e_45_1 }; }
+                catch (e_47_1) { e_47 = { error: e_47_1 }; }
                 finally {
                     try {
                         if (slicers_1_1 && !slicers_1_1.done && (_e = slicers_1.return)) _e.call(slicers_1);
                     }
-                    finally { if (e_45) throw e_45.error; }
+                    finally { if (e_47) throw e_47.error; }
                 }
                 try {
                     for (textBoxes_1 = __values(textBoxes), textBoxes_1_1 = textBoxes_1.next(); !textBoxes_1_1.done; textBoxes_1_1 = textBoxes_1.next()) {
@@ -4405,12 +4561,12 @@ var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         frameId += 1;
                     }
                 }
-                catch (e_46_1) { e_46 = { error: e_46_1 }; }
+                catch (e_48_1) { e_48 = { error: e_48_1 }; }
                 finally {
                     try {
                         if (textBoxes_1_1 && !textBoxes_1_1.done && (_f = textBoxes_1.return)) _f.call(textBoxes_1);
                     }
-                    finally { if (e_46) throw e_46.error; }
+                    finally { if (e_48) throw e_48.error; }
                 }
                 try {
                     for (shapes_1 = __values(shapes), shapes_1_1 = shapes_1.next(); !shapes_1_1.done; shapes_1_1 = shapes_1.next()) {
@@ -4426,12 +4582,12 @@ var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         frameId += 1;
                     }
                 }
-                catch (e_47_1) { e_47 = { error: e_47_1 }; }
+                catch (e_49_1) { e_49 = { error: e_49_1 }; }
                 finally {
                     try {
                         if (shapes_1_1 && !shapes_1_1.done && (_g = shapes_1.return)) _g.call(shapes_1);
                     }
-                    finally { if (e_47) throw e_47.error; }
+                    finally { if (e_49) throw e_49.error; }
                 }
                 _m.label = 1;
             case 1:
@@ -4473,14 +4629,14 @@ var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, f
                 return [3 /*break*/, 2];
             case 5: return [3 /*break*/, 8];
             case 6:
-                e_43_1 = _m.sent();
-                e_43 = { error: e_43_1 };
+                e_45_1 = _m.sent();
+                e_45 = { error: e_45_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_43) throw e_43.error; }
+                finally { if (e_45) throw e_45.error; }
                 return [7 /*endfinally*/];
             case 8:
                 orderedAnchors.sort(function (a, b) { return a.order - b.order; });
@@ -4490,12 +4646,12 @@ var buildDrawingParts = function (_a) { return __awaiter(void 0, [_a], void 0, f
                         anchors.push(entry.xml);
                     }
                 }
-                catch (e_48_1) { e_48 = { error: e_48_1 }; }
+                catch (e_50_1) { e_50 = { error: e_50_1 }; }
                 finally {
                     try {
                         if (orderedAnchors_1_1 && !orderedAnchors_1_1.done && (_j = orderedAnchors_1.return)) _j.call(orderedAnchors_1);
                     }
-                    finally { if (e_48) throw e_48.error; }
+                    finally { if (e_50) throw e_50.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*/, {
@@ -4866,7 +5022,7 @@ var buildTextWithTabs = function (text, rPrXml) {
         .join("");
 };
 var buildTextBodyXml = function (spec) {
-    var e_49, _a;
+    var e_51, _a;
     var richText = spec.richText || [];
     var plainText = spec.text || "";
     // Build vertical alignment and wrap attributes
@@ -4907,12 +5063,12 @@ var buildTextBodyXml = function (spec) {
                 }
             }
         }
-        catch (e_49_1) { e_49 = { error: e_49_1 }; }
+        catch (e_51_1) { e_51 = { error: e_51_1 }; }
         finally {
             try {
                 if (richText_1_1 && !richText_1_1.done && (_a = richText_1.return)) _a.call(richText_1);
             }
-            finally { if (e_49) throw e_49.error; }
+            finally { if (e_51) throw e_51.error; }
         }
         paragraphsXml = paragraphs
             .filter(function (runs) { return runs.length > 0; })
@@ -5340,7 +5496,7 @@ var buildCalcPrXml = function (iterativeCalculationOptions) {
     }
     return "<calcPr ".concat(attrs.join(" "), "/>");
 };
-var buildWorkbookXml = function (sheets, sheetRelIds, sheetNames, namedRanges, iterativeCalculationOptions, slicerCacheRelIds, use1904, externalLinkRelIds, pivotCacheRelIds) {
+var buildWorkbookXml = function (sheets, sheetRelIds, sheetNames, namedRanges, iterativeCalculationOptions, slicerCacheRelIds, use1904, externalLinkRelIds, pivotCacheRelIds, workbookProtection) {
     if (slicerCacheRelIds === void 0) { slicerCacheRelIds = []; }
     if (use1904 === void 0) { use1904 = false; }
     if (externalLinkRelIds === void 0) { externalLinkRelIds = []; }
@@ -5409,10 +5565,57 @@ var buildWorkbookXml = function (sheets, sheetRelIds, sheetNames, namedRanges, i
     var workbookPrXml = use1904
         ? "<workbookPr date1904=\"1\"/>"
         : "<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>");
+    // `CT_Workbook` puts `<workbookProtection>` right after `<workbookPr>`.
+    var workbookProtectionXml = buildWorkbookProtectionXml(workbookProtection);
+    return "".concat(XML_DECLARATION, "<workbook xmlns=\"").concat(WORKSHEET_NS, "\" xmlns:r=\"").concat(REL_NS, "\">").concat(workbookPrXml).concat(workbookProtectionXml).concat(calcPrXml, "<bookViews><workbookView activeTab=\"0\" firstSheet=\"0\"/></bookViews><sheets>").concat(sheetEntries, "</sheets>").concat(definedNamesXml).concat(externalReferencesXml).concat(pivotCachesXml).concat(slicerCachesXml, "</workbook>");
+};
+/**
+ * `<workbookProtection …/>` from the `workbookProtection` export prop: the
+ * agile hash quartets first, then the legacy password hashes, then the lock
+ * flags — Excel's own attribute order — writing only what the model carries
+ * (flags as `"1"` / `"0"`), so an imported element round-trips verbatim. An
+ * absent model or one with no attribute at all writes nothing. Twin of
+ * `rnc-export`'s `workbook_protection_xml`.
+ */
+var buildWorkbookProtectionXml = function (protection) {
+    if (!protection)
+        return "";
+    var attrs = [];
+    var text = function (name) {
+        var value = protection[name];
+        if (typeof value === "string" && value) {
+            attrs.push("".concat(name, "=\"").concat(escapeXmlAttr(value), "\""));
+        }
+    };
+    var count = function (name) {
+        var value = protection[name];
+        if (typeof value === "number" && Number.isFinite(value)) {
+            attrs.push("".concat(name, "=\"").concat(Math.trunc(value), "\""));
+        }
+    };
+    var flag = function (name) {
+        var value = protection[name];
+        if (typeof value === "boolean") {
+            attrs.push("".concat(name, "=\"").concat(value ? 1 : 0, "\""));
+        }
+    };
+    text("workbookAlgorithmName");
+    text("workbookHashValue");
+    text("workbookSaltValue");
+    count("workbookSpinCount");
+    text("revisionsAlgorithmName");
+    text("revisionsHashValue");
+    text("revisionsSaltValue");
+    count("revisionsSpinCount");
+    text("workbookPassword");
+    text("revisionsPassword");
+    flag("lockStructure");
+    flag("lockWindows");
+    flag("lockRevision");
+    return attrs.length ? "<workbookProtection ".concat(attrs.join(" "), "/>") : "";
 };
 var buildDefinedNamesXml = function (namedRanges, sheetNameById, printScopes) {
-    var e_50, _a, e_51, _b;
+    var e_52, _a, e_53, _b;
     var _d, _e, _f;
     if (printScopes === void 0) { printScopes = []; }
     var entries = [];
@@ -5442,12 +5645,12 @@ var buildDefinedNamesXml = function (namedRanges, sheetNameById, printScopes) {
             ], false));
         }
     }
-    catch (e_50_1) { e_50 = { error: e_50_1 }; }
+    catch (e_52_1) { e_52 = { error: e_52_1 }; }
     finally {
         try {
             if (_h && !_h.done && (_a = _g.return)) _a.call(_g);
         }
-        finally { if (e_50) throw e_50.error; }
+        finally { if (e_52) throw e_52.error; }
     }
     printScopes.forEach(function (_a, index) {
         var _b;
@@ -5468,12 +5671,35 @@ var buildDefinedNamesXml = function (namedRanges, sheetNameById, printScopes) {
             entries.push("<definedName name=\"".concat(PRINT_TITLES_NAME, "\" localSheetId=\"").concat(index, "\">").concat(escapeXmlText(titles), "</definedName>"));
         }
     });
+    // A sheet-scoped name (`scopeSheetId`) is written with `localSheetId` = the
+    // sheet's position in `<sheets>`; a scope that names no exported sheet
+    // falls back to workbook scope. Excel allows one entry per (name, scope)
+    // pair and repairs the workbook when a pair repeats, so a duplicate (two
+    // scoped `LocalRange`s that both lost their scope, or a multi-area name
+    // imported as one range per area) is written once.
+    var localSheetIdAttr = function (namedRange) {
+        var scope = namedRange.scopeSheetId;
+        if (scope === undefined || scope === null)
+            return "";
+        var sheetName = sheetNameById.get(scope);
+        var index = sheetName ? sheetIndexByName.get(sheetName) : undefined;
+        return index == null ? "" : " localSheetId=\"".concat(index, "\"");
+    };
+    var seenNameScopes = new Set();
+    var claimNameScope = function (name, localSheetId) {
+        var key = "".concat(name.toLowerCase(), "|").concat(localSheetId);
+        if (seenNameScopes.has(key))
+            return false;
+        seenNameScopes.add(key);
+        return true;
+    };
     try {
         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\"" : "";
+            var scopeAttr = localSheetIdAttr(namedRange);
             if ((_f = namedRange.range) === null || _f === void 0 ? void 0 : _f.sheetId) {
                 var sheetName = sheetNameById.get(namedRange.range.sheetId);
                 if (!sheetName)
@@ -5481,26 +5707,42 @@ var buildDefinedNamesXml = function (namedRanges, sheetNameById, printScopes) {
                 var ref = cellRangeToAddress(undefined, namedRange.range);
                 if (!ref)
                     continue;
+                if (!claimNameScope(namedRange.name, scopeAttr))
+                    continue;
                 var address = "".concat(escapeSheetName(sheetName), "!").concat(toAbsoluteRef(ref));
-                entries.push("<definedName name=\"".concat(escapeXmlAttr(namedRange.name), "\"").concat(hiddenAttr, ">").concat(escapeXmlText(address), "</definedName>"));
+                entries.push("<definedName name=\"".concat(escapeXmlAttr(namedRange.name), "\"").concat(scopeAttr).concat(hiddenAttr, ">").concat(escapeXmlText(address), "</definedName>"));
                 continue;
             }
+            // A constant name reaches us as text (`"Hello"`, `0.2`) or, when the
+            // XML layer coerced it, as a number / boolean — both are the same
+            // `<definedName>` body in Excel.
             var rawValue = namedRange.value;
-            if (typeof rawValue !== "string")
+            var valueText = typeof rawValue === "string"
+                ? rawValue
+                : typeof rawValue === "number" || typeof rawValue === "boolean"
+                    ? String(rawValue)
+                    : undefined;
+            if (valueText === undefined)
                 continue;
-            var trimmed = rawValue.trim();
+            var trimmed = valueText.trim();
             if (!trimmed)
                 continue;
             var expression = trimmed.startsWith("=") ? trimmed.slice(1) : trimmed;
-            entries.push("<definedName name=\"".concat(escapeXmlAttr(namedRange.name), "\"").concat(hiddenAttr, ">").concat(escapeXmlText(expression), "</definedName>"));
+            if (!claimNameScope(namedRange.name, scopeAttr))
+                continue;
+            // A formula-valued name (`Dbl` = `LAMBDA(x,x*2)`) is stored with the same
+            // markers as a cell formula: `_xlfn.LAMBDA(_xlpm.x,_xlpm.x*2)`.
+            entries.push("<definedName name=\"".concat(escapeXmlAttr(namedRange.name), "\"").concat(scopeAttr).concat(hiddenAttr, ">").concat(escapeXmlText(isAFormulaExpression(expression)
+                ? sanitizeFormulaText(expression)
+                : expression), "</definedName>"));
         }
     }
-    catch (e_51_1) { e_51 = { error: e_51_1 }; }
+    catch (e_53_1) { e_53 = { error: e_53_1 }; }
     finally {
         try {
             if (_k && !_k.done && (_b = _j.return)) _b.call(_j);
         }
-        finally { if (e_51) throw e_51.error; }
+        finally { if (e_53) throw e_53.error; }
     }
     if (!entries.length)
         return "";
@@ -5535,11 +5777,12 @@ var buildWorkbookSlicerCachesXml = function (slicerCacheRelIds) {
 };
 var buildWorkbookRelationships = function (
 /** One entry per sheet in `<sheets>` order; `target` is relative to `xl/`. */
-sheetParts, slicerCacheCount, externalLinkCount, pivotCacheCount, hasPersons) {
+sheetParts, slicerCacheCount, externalLinkCount, pivotCacheCount, hasPersons, hasSheetMetadata) {
     if (slicerCacheCount === void 0) { slicerCacheCount = 0; }
     if (externalLinkCount === void 0) { externalLinkCount = 0; }
     if (pivotCacheCount === void 0) { pivotCacheCount = 0; }
     if (hasPersons === void 0) { hasPersons = false; }
+    if (hasSheetMetadata === void 0) { hasSheetMetadata = false; }
     var relationships = [];
     var sheetRelIds = [];
     var slicerCacheRelIds = [];
@@ -5556,6 +5799,9 @@ sheetParts, slicerCacheCount, externalLinkCount, pivotCacheCount, hasPersons) {
     relationships.push("<Relationship Id=\"".concat(themeId, "\" Type=\"").concat(REL_NS, "/theme\" Target=\"theme/theme1.xml\"/>"));
     relationships.push("<Relationship Id=\"".concat(sharedStringsId, "\" Type=\"").concat(REL_NS, "/sharedStrings\" Target=\"sharedStrings.xml\"/>"));
     var nextRelId = sheetCount + 4;
+    if (hasSheetMetadata) {
+        relationships.push("<Relationship Id=\"rId".concat(nextRelId++, "\" Type=\"").concat(REL_NS, "/sheetMetadata\" Target=\"metadata.xml\"/>"));
+    }
     for (var i = 0; i < slicerCacheCount; i++) {
         var relId = "rId".concat(nextRelId++);
         slicerCacheRelIds.push(relId);
@@ -5593,7 +5839,10 @@ sheetParts, slicerCacheCount, externalLinkCount, pivotCacheCount, hasPersons) {
     };
 };
 var buildContentTypesXml = function (_a) {
-    var worksheetCount = _a.worksheetCount, _b = _a.chartsheetCount, chartsheetCount = _b === void 0 ? 0 : _b, tableCount = _a.tableCount, drawingSheets = _a.drawingSheets, mediaExtensions = _a.mediaExtensions, chartCount = _a.chartCount, _d = _a.chartExCount, chartExCount = _d === void 0 ? 0 : _d, _e = _a.slicerCount, slicerCount = _e === void 0 ? 0 : _e, _f = _a.slicerCacheCount, slicerCacheCount = _f === void 0 ? 0 : _f, _g = _a.pivotTableCount, pivotTableCount = _g === void 0 ? 0 : _g, _h = _a.pivotCacheCount, pivotCacheCount = _h === void 0 ? 0 : _h, _j = _a.commentsSheets, commentsSheets = _j === void 0 ? [] : _j, _k = _a.threadedCommentsSheets, threadedCommentsSheets = _k === void 0 ? [] : _k, _l = _a.hasPersons, hasPersons = _l === void 0 ? false : _l, _m = _a.externalLinkCount, externalLinkCount = _m === void 0 ? 0 : _m, _o = _a.hasVmlDrawings, hasVmlDrawings = _o === void 0 ? false : _o, _p = _a.ctrlPropCount, ctrlPropCount = _p === void 0 ? 0 : _p;
+    var worksheetCount = _a.worksheetCount, _b = _a.chartsheetCount, chartsheetCount = _b === void 0 ? 0 : _b, tableCount = _a.tableCount, drawingSheets = _a.drawingSheets, mediaExtensions = _a.mediaExtensions, chartCount = _a.chartCount, _d = _a.chartExCount, chartExCount = _d === void 0 ? 0 : _d, _e = _a.slicerCount, slicerCount = _e === void 0 ? 0 : _e, _f = _a.slicerCacheCount, slicerCacheCount = _f === void 0 ? 0 : _f, _g = _a.pivotTableCount, pivotTableCount = _g === void 0 ? 0 : _g, _h = _a.pivotCacheCount, pivotCacheCount = _h === void 0 ? 0 : _h, _j = _a.commentsSheets, commentsSheets = _j === void 0 ? [] : _j, _k = _a.threadedCommentsSheets, threadedCommentsSheets = _k === void 0 ? [] : _k, _l = _a.hasPersons, hasPersons = _l === void 0 ? false : _l, _m = _a.externalLinkCount, externalLinkCount = _m === void 0 ? 0 : _m, _o = _a.hasVmlDrawings, hasVmlDrawings = _o === void 0 ? false : _o, _p = _a.ctrlPropCount, ctrlPropCount = _p === void 0 ? 0 : _p, _q = _a.hasSheetMetadata, hasSheetMetadata = _q === void 0 ? false : _q;
+    var metadataOverride = hasSheetMetadata
+        ? "<Override PartName=\"/xl/metadata.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheetMetadata+xml\"/>"
+        : "";
     var sheetOverrides = Array.from({ length: worksheetCount }, function (_, index) {
         return "<Override PartName=\"/xl/worksheets/sheet".concat(index + 1, ".xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml\"/>");
     }).join("");
@@ -5654,7 +5903,7 @@ var buildContentTypesXml = function (_a) {
     var ctrlPropOverrides = Array.from({ length: ctrlPropCount }, function (_, index) {
         return "<Override PartName=\"/xl/ctrlProps/ctrlProp".concat(index + 1, ".xml\" ContentType=\"").concat(CTRL_PROP_CONTENT_TYPE, "\"/>");
     }).join("");
-    return "".concat(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\"/>").concat(vmlDefault).concat(mediaDefaults, "<Override PartName=\"/xl/workbook.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml\"/>").concat(sheetOverrides).concat(chartsheetOverrides).concat(tableOverrides).concat(drawingOverrides).concat(chartOverrides).concat(chartExOverrides).concat(slicerOverrides).concat(slicerCacheOverrides).concat(pivotTableOverrides).concat(pivotCacheOverrides).concat(externalLinkOverrides).concat(ctrlPropOverrides).concat(commentsOverrides).concat(threadedCommentsOverrides).concat(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>");
+    return "".concat(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\"/>").concat(vmlDefault).concat(mediaDefaults, "<Override PartName=\"/xl/workbook.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml\"/>").concat(sheetOverrides).concat(chartsheetOverrides).concat(tableOverrides).concat(drawingOverrides).concat(chartOverrides).concat(chartExOverrides).concat(slicerOverrides).concat(slicerCacheOverrides).concat(pivotTableOverrides).concat(pivotCacheOverrides).concat(externalLinkOverrides).concat(ctrlPropOverrides).concat(commentsOverrides).concat(threadedCommentsOverrides).concat(personOverride).concat(metadataOverride, "<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>");
 };
 var buildRootRelationshipsXml = function () {
     return "".concat(XML_DECLARATION, "<Relationships xmlns=\"").concat(PACKAGE_REL_NS, "\"><Relationship Id=\"rId1\" Type=\"").concat(REL_NS, "/officeDocument\" Target=\"xl/workbook.xml\"/><Relationship Id=\"rId2\" Type=\"").concat(REL_NS, "/extended-properties\" Target=\"docProps/app.xml\"/><Relationship Id=\"rId3\" Type=\"").concat(REL_NS, "/core-properties\" Target=\"docProps/core.xml\"/></Relationships>");