@rowsncolumns/toolkit 24.4.2 → 24.4.4

package/dist/cjs/excel-parser/plugins/xlsx/index.js

@@ -3,9 +3,10 @@ import { addressToCell, addressToSelection, alpha2number, checkIfStringIsReferen
 import { XMLParser } from "fast-xml-parser";
 import { get } from "lodash-es";
 import { Parser as HtmlParser } from "htmlparser2";
-import { createFilterSpecsFromAutoFilter, excelColumnWidthToPixels, findMax, getRangeFromAddressRef, } from "../../helpers";
+import { createFilterSpecsFromAutoFilter, excelColumnWidthToPixels, findMax, getRangeFromAddressRef, parseTableColumnTotals, } from "../../helpers";
 import { defaultSpreadsheetTheme } from "../../theme-default";
 import { Unescape } from "../../utils";
+import { compactPrintSettings, isBuiltinPrintName, isDefaultPageMargins, parsePrintAreaFormula, parsePrintTitlesFormula, PRINT_AREA_NAME, } from "../../../print-settings";
 import { StreamingZipParser } from "../../zip-parser-streaming";
 import { SheetDataValidationStamper } from "../../dv-cell-stamp";
 import { BaseWorkbookPlugin } from "../base/index";
@@ -13,12 +14,14 @@ import { processChart } from "./charts";
 import { customFiltersToCondition, dynamicFilterToCondition, } from "../../../autofilter-condition";
 import { getConditionalFormattingFromSheet } from "./conditional-formatting";
 import { getDataValidationsForSheet as parseDataValidationsFromSheetData } from "./data-validations";
-import { processAnchors } from "./drawing";
+import { anchorsInDocumentOrder, processAnchors, } from "./drawing";
 import { getRelationsById } from "./relationships";
 import { hasPowerQueryParts, } from "../../../power-query";
 import { extractSheetViewProperties } from "./sheet-views";
 import { EMPTY_SHEET_THREADED_COMMENTS, parsePersons, parseThreadedComments, } from "./threaded-comments";
-import { extractColor, fontNodeToTextFormat, getCellDataForStyleIndex, getCellValueAndFormat, } from "./styles";
+import { getChartExReferenceFromAnchor, processChartEx } from "./chartex";
+import { buildFormControlEmbeds, parseFormControlPr, parseVmlControlCaptions, readLegacyDrawingRelId, readWorksheetControls, } from "./form-controls";
+import { extractColor, fontNodeToTextFormat, getCellDataForStyleIndex, getCellValueAndFormat, resolveNamedCellStyles, } from "./styles";
 import { extractThemeColors, extractThemeFonts, generateDarkThemeColors, } from "./theme";
 export var XMLTagProcessor = function (name, value) {
     return Unescape(value);
@@ -789,6 +792,18 @@ var XlsxPlugin = /** @class */ (function (_super) {
          * `getDataValidations()` aggregates these per-sheet caches, keeping ids
          * stable across per-sheet and workbook-wide callers.
          */
+        /**
+         * `<protectedRanges>` per sheet, populated while `getSheets` builds each
+         * `Sheet` (the element sits after `<sheetData>` in the worksheet part, so it
+         * rides the same geometry pass). Read back via `getProtectedRanges`.
+         */
+        _this.protectedRangesBySheet = new Map();
+        /**
+         * The builtin `_xlnm.Print_Area` / `_xlnm.Print_Titles` defined names,
+         * hoisted out of `namedRanges` (they are sheet-scoped facets, not user
+         * names) and merged into each sheet's `printSettings` by `getSheets()`.
+         */
+        _this.printNamesBySheetId = new Map();
         _this.dataValidationsBySheetCache = new Map();
         /** Per-sheet memo for conditional formatting, mirroring the DV cache. */
         _this.conditionalFormattingBySheetCache = new Map();
@@ -835,7 +850,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
     };
     XlsxPlugin.prototype.parseSheetMetadata = function (rid) {
         return __awaiter(this, void 0, void 0, function () {
-            var path, merges, rowEntries, outlineSummaryBelow, outlineSummaryRight, columnMetadata, colStyleRanges, maxRowIndex, maxColumnIndex, dimensionRange, sheetHasFilterMode, zeroHeight, defaultRowHeightPx, defaultColumnWidthPx, sheetViewAttrs, paneAttrs, tabColor, autoFilterRef, filterColumns, getOrCreateFilterColumn, currentFilterColumn, tablePartIds, lastScannedRowIndex, scanSeqColIndex, normalizeTag, parser, filterSpecs, sheetViewData, autoFilterRange;
+            var path, merges, rowEntries, outlineSummaryBelow, outlineSummaryRight, columnMetadata, colStyleRanges, maxRowIndex, maxColumnIndex, dimensionRange, sheetHasFilterMode, zeroHeight, defaultRowHeightPx, defaultColumnWidthPx, sheetViewAttrs, paneAttrs, tabColor, autoFilterRef, sheetProtection, protectedRangeEntries, pageSetup, pageMargins, printOptions, fitToPage, headerFooter, headerFooterTextTarget, rowBreaks, columnBreaks, breakAxis, filterColumns, getOrCreateFilterColumn, currentFilterColumn, tablePartIds, lastScannedRowIndex, scanSeqColIndex, inCustomSheetViews, normalizeTag, parser, filterSpecs, sheetViewData, autoFilterRange;
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
@@ -849,6 +864,10 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         maxColumnIndex = 0;
                         sheetHasFilterMode = false;
                         zeroHeight = false;
+                        protectedRangeEntries = [];
+                        fitToPage = false;
+                        rowBreaks = [];
+                        columnBreaks = [];
                         filterColumns = new Map();
                         getOrCreateFilterColumn = function (colId) {
                             var entry = filterColumns.get(colId);
@@ -862,13 +881,20 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         tablePartIds = [];
                         lastScannedRowIndex = 0;
                         scanSeqColIndex = 1;
+                        inCustomSheetViews = false;
                         normalizeTag = function (name) {
                             return name.includes(":") ? name.split(":")[1] : name;
                         };
                         parser = new HtmlParser({
                             onopentag: function (tagName, attrs) {
-                                var _a, _b, _c, _d, _e, _f, _g;
+                                var _a, _b, _c, _d, _e, _f, _g, _h;
                                 var name = normalizeTag(tagName);
+                                if (name === "customSheetViews") {
+                                    inCustomSheetViews = true;
+                                    return;
+                                }
+                                if (inCustomSheetViews)
+                                    return;
                                 if (name === "dimension") {
                                     var ref = attrs === null || attrs === void 0 ? void 0 : attrs.ref;
                                     if (typeof ref === "string") {
@@ -914,6 +940,50 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 if (name === "tabColor") {
                                     tabColor = { a$: __assign({}, attrs) };
                                 }
+                                if (name === "sheetProtection") {
+                                    sheetProtection = readSheetProtectionAttrs(attrs);
+                                }
+                                if (name === "protectedRange") {
+                                    var sqref = attrs.sqref;
+                                    if (typeof sqref === "string" && sqref) {
+                                        protectedRangeEntries.push({
+                                            sqref: sqref,
+                                            name: attrs.name,
+                                            securityDescriptor: attrs.securityDescriptor,
+                                        });
+                                    }
+                                }
+                                if (name === "pageSetUpPr") {
+                                    fitToPage = isXmlTrue(attrs === null || attrs === void 0 ? void 0 : attrs.fitToPage);
+                                }
+                                if (name === "pageSetup") {
+                                    pageSetup = readPageSetupAttrs(attrs);
+                                }
+                                if (name === "pageMargins") {
+                                    pageMargins = readPageMarginsAttrs(attrs);
+                                }
+                                if (name === "printOptions") {
+                                    printOptions = readPrintOptionsAttrs(attrs);
+                                }
+                                if (name === "headerFooter") {
+                                    headerFooter = readHeaderFooterAttrs(attrs);
+                                }
+                                if (isHeaderFooterTextKey(name)) {
+                                    headerFooterTextTarget = name;
+                                    headerFooter !== null && headerFooter !== void 0 ? headerFooter : (headerFooter = {});
+                                }
+                                if (name === "rowBreaks")
+                                    breakAxis = "row";
+                                if (name === "colBreaks")
+                                    breakAxis = "column";
+                                if (name === "brk" && breakAxis) {
+                                    // Only manual breaks are user state; Excel drops automatic ones
+                                    // (`man` absent) on save as well.
+                                    var id = parseInt((_a = attrs === null || attrs === void 0 ? void 0 : attrs.id) !== null && _a !== void 0 ? _a : "", 10);
+                                    if (Number.isFinite(id) && id > 0 && isXmlTrue(attrs === null || attrs === void 0 ? void 0 : attrs.man)) {
+                                        (breakAxis === "row" ? rowBreaks : columnBreaks).push(id);
+                                    }
+                                }
                                 if (name === "sheetView" && !sheetViewAttrs) {
                                     sheetViewAttrs = __assign({}, attrs);
                                 }
@@ -924,8 +994,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                     return;
                                 }
                                 if (name === "col") {
-                                    var min = parseInt((_a = attrs.min) !== null && _a !== void 0 ? _a : "0", 10);
-                                    var max = parseInt((_b = attrs.max) !== null && _b !== void 0 ? _b : "0", 10);
+                                    var min = parseInt((_b = attrs.min) !== null && _b !== void 0 ? _b : "0", 10);
+                                    var max = parseInt((_c = attrs.max) !== null && _c !== void 0 ? _c : "0", 10);
                                     // Column default style: cells in these columns without an
                                     // explicit `s` (including cells never written to the XML)
                                     // inherit this xf. Collected separately from DimensionProperties
@@ -984,7 +1054,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                     }
                                 }
                                 if (name === "row") {
-                                    var parsedRowIndex = parseInt((_c = attrs.r) !== null && _c !== void 0 ? _c : "0", 10);
+                                    var parsedRowIndex = parseInt((_d = attrs.r) !== null && _d !== void 0 ? _d : "0", 10);
                                     var rowIndex = parsedRowIndex > 0 ? parsedRowIndex : lastScannedRowIndex + 1;
                                     lastScannedRowIndex = rowIndex;
                                     scanSeqColIndex = 1;
@@ -1024,7 +1094,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 if (name === "mergeCell") {
                                     var ref = attrs.ref;
                                     if (typeof ref === "string") {
-                                        var range = (_d = addressToSelection(ref)) === null || _d === void 0 ? void 0 : _d.range;
+                                        var range = (_e = addressToSelection(ref)) === null || _e === void 0 ? void 0 : _e.range;
                                         if (range)
                                             merges.push(range);
                                     }
@@ -1036,7 +1106,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                     }
                                 }
                                 if (name === "filterColumn") {
-                                    var colId = parseInt((_e = attrs.colId) !== null && _e !== void 0 ? _e : "0", 10);
+                                    var colId = parseInt((_f = attrs.colId) !== null && _f !== void 0 ? _f : "0", 10);
                                     currentFilterColumn = Number.isNaN(colId) ? null : colId;
                                 }
                                 if (name === "filter" && currentFilterColumn !== null) {
@@ -1076,13 +1146,13 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 // operator= val=>. Records the AND flag, then each child below.
                                 if (name === "customFilters" && currentFilterColumn !== null) {
                                     var entry = getOrCreateFilterColumn(currentFilterColumn);
-                                    entry.customFilters = (_f = entry.customFilters) !== null && _f !== void 0 ? _f : [];
+                                    entry.customFilters = (_g = entry.customFilters) !== null && _g !== void 0 ? _g : [];
                                     entry.customFiltersAnd =
                                         attrs.and === "1" || attrs.and === "true";
                                 }
                                 if (name === "customFilter" && currentFilterColumn !== null) {
                                     var entry = getOrCreateFilterColumn(currentFilterColumn);
-                                    entry.customFilters = (_g = entry.customFilters) !== null && _g !== void 0 ? _g : [];
+                                    entry.customFilters = (_h = entry.customFilters) !== null && _h !== void 0 ? _h : [];
                                     entry.customFilters.push({
                                         operator: attrs.operator,
                                         val: attrs.val,
@@ -1102,11 +1172,30 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                     }
                                 }
                             },
+                            ontext: function (text) {
+                                var _a;
+                                if (headerFooterTextTarget && headerFooter) {
+                                    headerFooter[headerFooterTextTarget] =
+                                        "".concat((_a = headerFooter[headerFooterTextTarget]) !== null && _a !== void 0 ? _a : "").concat(text);
+                                }
+                            },
                             onclosetag: function (tagName) {
                                 var name = normalizeTag(tagName);
+                                if (name === "customSheetViews") {
+                                    inCustomSheetViews = false;
+                                    return;
+                                }
+                                if (inCustomSheetViews)
+                                    return;
                                 if (name === "filterColumn") {
                                     currentFilterColumn = null;
                                 }
+                                if (isHeaderFooterTextKey(name)) {
+                                    headerFooterTextTarget = undefined;
+                                }
+                                if (name === "rowBreaks" || name === "colBreaks") {
+                                    breakAxis = undefined;
+                                }
                             },
                             onerror: function (err) {
                                 console.error("Streaming sheet metadata parse error", err);
@@ -1183,6 +1272,18 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 tablePartIds: tablePartIds,
                                 outlineSummaryBelow: outlineSummaryBelow,
                                 outlineSummaryRight: outlineSummaryRight,
+                                sheetProtection: sheetProtection,
+                                protectedRangeEntries: protectedRangeEntries,
+                                printSettings: compactPrintSettings({
+                                    pageSetup: fitToPage ? __assign(__assign({}, pageSetup), { fitToPage: true }) : pageSetup,
+                                    // Every Excel worksheet carries `<pageMargins>`; only non-default
+                                    // margins are user state worth modelling.
+                                    pageMargins: isDefaultPageMargins(pageMargins) ? undefined : pageMargins,
+                                    printOptions: printOptions,
+                                    headerFooter: headerFooter,
+                                    rowBreaks: rowBreaks,
+                                    columnBreaks: columnBreaks,
+                                }),
                             }];
                 }
             });
@@ -1414,6 +1515,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                             conditionalFormatting: false,
                             dataValidations: false,
                             drawing: false,
+                            controls: false,
                         };
                         sheetPath = this.resolveSheetPath(relation.target);
                         sheetRelPath = sheetPath.replace("worksheets", "worksheets/_rels") + ".rels";
@@ -1476,6 +1578,9 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                     case "drawing":
                                         features.drawing = true;
                                         break;
+                                    case "controls":
+                                        features.controls = true;
+                                        break;
                                 }
                                 if (name !== "hyperlink") {
                                     return;
@@ -2004,6 +2109,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         this.sheetMetadataCache.clear();
                         this.dataValidationsBySheetCache.clear();
                         this.conditionalFormattingBySheetCache.clear();
+                        this.protectedRangesBySheet.clear();
                         return [4 /*yield*/, this.loadWorkbookXml()];
                     case 2:
                         _e.sent();
@@ -2041,6 +2147,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
         this.sheetMetadataCache.clear();
         this.dataValidationsBySheetCache.clear();
         this.conditionalFormattingBySheetCache.clear();
+        this.protectedRangesBySheet.clear();
         this.worksheetBySheetId.clear();
     };
     XlsxPlugin.prototype.clearSharedFormula = function () {
@@ -2136,7 +2243,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                                     : [];
                                             columns = columnDefsArray.map(function (colDef) {
                                                 var name = colDef.a$.name || "";
-                                                var columnObj = { name: name };
+                                                var columnObj = __assign({ name: name }, parseTableColumnTotals(colDef));
                                                 // Check for calculated column
                                                 // Handle both with and without namespace prefix
                                                 var calculatedColumnFormula = get(colDef, "calculatedColumnFormula") ||
@@ -3232,14 +3339,29 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                             ? twoCellAnchors
                                             : [twoCellAnchors])), false).filter(Boolean);
                                         _loop_5 = function (anchor) {
-                                            var chartRef, chartRId, chartRel, chart;
+                                            var chartRef, chartExRef, chartExRId_1, chartExRel, chartEx, chartRId, chartRel, chart;
                                             return __generator(this, function (_k) {
                                                 switch (_k.label) {
                                                     case 0:
                                                         chartRef = getChartReferenceFromAnchor(anchor);
-                                                        if (!chartRef) {
-                                                            return [2 /*return*/, "continue"];
-                                                        }
+                                                        if (!!chartRef) return [3 /*break*/, 3];
+                                                        chartExRef = getChartExReferenceFromAnchor(anchor);
+                                                        chartExRId_1 = get(chartExRef, "a$.r:id") || get(chartExRef, "a$.id");
+                                                        chartExRel = chartExRId_1
+                                                            ? drawingRelsArray.find(function (rel) {
+                                                                return get(rel, "a$.Id") === chartExRId_1 ||
+                                                                    get(rel, "a$.id") === chartExRId_1;
+                                                            })
+                                                            : undefined;
+                                                        if (!chartExRel) return [3 /*break*/, 2];
+                                                        return [4 /*yield*/, processChartEx(chartExRel.a$.Target, drawingPath, anchor, sheetId, this_2.zipParser, this_2.xmlParser, sheetDimensions, resolveSheetId)];
+                                                    case 1:
+                                                        chartEx = _k.sent();
+                                                        if (chartEx)
+                                                            charts.push(chartEx);
+                                                        _k.label = 2;
+                                                    case 2: return [2 /*return*/, "continue"];
+                                                    case 3:
                                                         chartRId = get(chartRef, "a$.r:id") ||
                                                             get(chartRef, "a$.id") ||
                                                             get(chartRef, "a$.rId") ||
@@ -3250,15 +3372,15 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                                         chartRel = drawingRelsArray.find(function (rel) {
                                                             return get(rel, "a$.Id") === chartRId || get(rel, "a$.id") === chartRId;
                                                         });
-                                                        if (!chartRel) return [3 /*break*/, 2];
+                                                        if (!chartRel) return [3 /*break*/, 5];
                                                         return [4 /*yield*/, processChart(chartRel.a$.Target, drawingPath, anchor, sheetId, this_2.zipParser, this_2.xmlParser, sheetDimensions, resolveSheetId)];
-                                                    case 1:
+                                                    case 4:
                                                         chart = _k.sent();
                                                         if (chart) {
                                                             charts.push(chart);
                                                         }
-                                                        _k.label = 2;
-                                                    case 2: return [2 /*return*/];
+                                                        _k.label = 5;
+                                                    case 5: return [2 /*return*/];
                                                 }
                                             });
                                         };
@@ -3338,8 +3460,9 @@ var XlsxPlugin = /** @class */ (function (_super) {
         return __awaiter(this, void 0, void 0, function () {
             var images, target, path, drawing, drawings, sheetRelPath, sheetRelContent, sheetRels, drawingRelations, drawingRelationsArray, _loop_6, this_3, drawings_2, drawings_2_1, drawingElement, e_28_1;
             var e_28, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            var _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
                         images = [];
                         target = this.relations[rid].target;
@@ -3356,17 +3479,17 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         sheetRelPath = path.replace("worksheets", "worksheets/_rels") + ".rels";
                         return [4 /*yield*/, this.zipParser.getText(sheetRelPath)];
                     case 1:
-                        sheetRelContent = _b.sent();
+                        sheetRelContent = _c.sent();
                         sheetRels = this.xmlParser.parse(sheetRelContent);
                         drawingRelations = get(sheetRels, "Relationships.Relationship");
                         drawingRelationsArray = Array.isArray(drawingRelations)
                             ? drawingRelations
                             : [drawingRelations];
                         _loop_6 = function (drawingElement) {
-                            var drawingId, drawingRels, drawingRels_2, drawingRels_2_1, drawingRel, drawingPath, drawingContent, drawing_1, twoCellAnchors, oneCellAnchors, absoluteAnchors, _c, _d, image, e_29_1, _e, _f, image, e_30_1, _g, _h, image, e_31_1, e_32_1;
-                            var e_32, _j, e_29, _k, e_30, _l, e_31, _m;
-                            return __generator(this, function (_o) {
-                                switch (_o.label) {
+                            var drawingId, drawingRels, drawingRels_2, drawingRels_2_1, drawingRel, drawingPath, drawingContent, drawing_1, _d, _e, anchor, _f, _g, image, e_29_1, e_30_1, e_31_1;
+                            var e_31, _h, e_30, _j, e_29, _k;
+                            return __generator(this, function (_l) {
+                                switch (_l.label) {
                                     case 0:
                                         drawingId = get(drawingElement, "a$.r:id") || get(drawingElement, "a$.id");
                                         drawingRels = drawingRelationsArray.filter(function (rel) {
@@ -3375,13 +3498,13 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                                 rel.a$.ID === drawingId ||
                                                 (rel.a$.Target && rel.a$.Target.includes("drawing"));
                                         });
-                                        _o.label = 1;
+                                        _l.label = 1;
                                     case 1:
-                                        _o.trys.push([1, 27, 28, 29]);
-                                        drawingRels_2 = (e_32 = void 0, __values(drawingRels)), drawingRels_2_1 = drawingRels_2.next();
-                                        _o.label = 2;
+                                        _l.trys.push([1, 19, 20, 21]);
+                                        drawingRels_2 = (e_31 = void 0, __values(drawingRels)), drawingRels_2_1 = drawingRels_2.next();
+                                        _l.label = 2;
                                     case 2:
-                                        if (!!drawingRels_2_1.done) return [3 /*break*/, 26];
+                                        if (!!drawingRels_2_1.done) return [3 /*break*/, 18];
                                         drawingRel = drawingRels_2_1.value;
                                         drawingPath = drawingRel.a$.Target;
                                         if (drawingPath.startsWith("../")) {
@@ -3400,130 +3523,94 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                         }
                                         return [4 /*yield*/, this_3.zipParser.getText(drawingPath)];
                                     case 3:
-                                        drawingContent = _o.sent();
-                                        drawing_1 = this_3.xmlParser.parse(drawingContent !== null && drawingContent !== void 0 ? drawingContent : "");
-                                        twoCellAnchors = get(drawing_1, "xdr:wsDr.xdr:twoCellAnchor") ||
-                                            get(drawing_1, "wsDr.twoCellAnchor");
-                                        oneCellAnchors = get(drawing_1, "xdr:wsDr.xdr:oneCellAnchor") ||
-                                            get(drawing_1, "wsDr.oneCellAnchor");
-                                        absoluteAnchors = get(drawing_1, "xdr:wsDr.xdr:absoluteAnchor") ||
-                                            get(drawing_1, "wsDr.absoluteAnchor");
-                                        _o.label = 4;
+                                        drawingContent = (_b = (_l.sent())) !== null && _b !== void 0 ? _b : "";
+                                        drawing_1 = this_3.xmlParser.parse(drawingContent);
+                                        _l.label = 4;
                                     case 4:
-                                        _o.trys.push([4, 9, 10, 11]);
-                                        e_29 = void 0;
-                                        return [4 /*yield*/, processAnchors(oneCellAnchors, "oneCellAnchor", drawingPath, sheetId, this_3.zipParser, this_3.xmlParser)];
+                                        _l.trys.push([4, 15, 16, 17]);
+                                        _d = (e_30 = void 0, __values(anchorsInDocumentOrder(drawing_1, drawingContent))), _e = _d.next();
+                                        _l.label = 5;
                                     case 5:
-                                        _c = (__values.apply(void 0, [_o.sent()])), _d = _c.next();
-                                        _o.label = 6;
+                                        if (!!_e.done) return [3 /*break*/, 14];
+                                        anchor = _e.value;
+                                        _l.label = 6;
                                     case 6:
-                                        if (!!_d.done) return [3 /*break*/, 8];
-                                        image = _d.value;
-                                        images.push(image);
-                                        _o.label = 7;
+                                        _l.trys.push([6, 11, 12, 13]);
+                                        e_29 = void 0;
+                                        return [4 /*yield*/, processAnchors(anchor.node, anchor.kind, drawingPath, sheetId, this_3.zipParser, this_3.xmlParser)];
                                     case 7:
-                                        _d = _c.next();
-                                        return [3 /*break*/, 6];
-                                    case 8: return [3 /*break*/, 11];
+                                        _f = (__values.apply(void 0, [_l.sent()])), _g = _f.next();
+                                        _l.label = 8;
+                                    case 8:
+                                        if (!!_g.done) return [3 /*break*/, 10];
+                                        image = _g.value;
+                                        images.push(image);
+                                        _l.label = 9;
                                     case 9:
-                                        e_29_1 = _o.sent();
+                                        _g = _f.next();
+                                        return [3 /*break*/, 8];
+                                    case 10: return [3 /*break*/, 13];
+                                    case 11:
+                                        e_29_1 = _l.sent();
                                         e_29 = { error: e_29_1 };
-                                        return [3 /*break*/, 11];
-                                    case 10:
+                                        return [3 /*break*/, 13];
+                                    case 12:
                                         try {
-                                            if (_d && !_d.done && (_k = _c.return)) _k.call(_c);
+                                            if (_g && !_g.done && (_k = _f.return)) _k.call(_f);
                                         }
                                         finally { if (e_29) throw e_29.error; }
                                         return [7 /*endfinally*/];
-                                    case 11:
-                                        _o.trys.push([11, 16, 17, 18]);
-                                        e_30 = void 0;
-                                        return [4 /*yield*/, processAnchors(twoCellAnchors, "twoCellAnchors", drawingPath, sheetId, this_3.zipParser, this_3.xmlParser)];
-                                    case 12:
-                                        _e = (__values.apply(void 0, [_o.sent()])), _f = _e.next();
-                                        _o.label = 13;
                                     case 13:
-                                        if (!!_f.done) return [3 /*break*/, 15];
-                                        image = _f.value;
-                                        images.push(image);
-                                        _o.label = 14;
-                                    case 14:
-                                        _f = _e.next();
-                                        return [3 /*break*/, 13];
-                                    case 15: return [3 /*break*/, 18];
-                                    case 16:
-                                        e_30_1 = _o.sent();
+                                        _e = _d.next();
+                                        return [3 /*break*/, 5];
+                                    case 14: return [3 /*break*/, 17];
+                                    case 15:
+                                        e_30_1 = _l.sent();
                                         e_30 = { error: e_30_1 };
-                                        return [3 /*break*/, 18];
-                                    case 17:
+                                        return [3 /*break*/, 17];
+                                    case 16:
                                         try {
-                                            if (_f && !_f.done && (_l = _e.return)) _l.call(_e);
+                                            if (_e && !_e.done && (_j = _d.return)) _j.call(_d);
                                         }
                                         finally { if (e_30) throw e_30.error; }
                                         return [7 /*endfinally*/];
-                                    case 18:
-                                        _o.trys.push([18, 23, 24, 25]);
-                                        e_31 = void 0;
-                                        return [4 /*yield*/, processAnchors(absoluteAnchors, "absoluteAnchors", drawingPath, sheetId, this_3.zipParser, this_3.xmlParser)];
+                                    case 17:
+                                        drawingRels_2_1 = drawingRels_2.next();
+                                        return [3 /*break*/, 2];
+                                    case 18: return [3 /*break*/, 21];
                                     case 19:
-                                        _g = (__values.apply(void 0, [_o.sent()])), _h = _g.next();
-                                        _o.label = 20;
-                                    case 20:
-                                        if (!!_h.done) return [3 /*break*/, 22];
-                                        image = _h.value;
-                                        images.push(image);
-                                        _o.label = 21;
-                                    case 21:
-                                        _h = _g.next();
-                                        return [3 /*break*/, 20];
-                                    case 22: return [3 /*break*/, 25];
-                                    case 23:
-                                        e_31_1 = _o.sent();
+                                        e_31_1 = _l.sent();
                                         e_31 = { error: e_31_1 };
-                                        return [3 /*break*/, 25];
-                                    case 24:
+                                        return [3 /*break*/, 21];
+                                    case 20:
                                         try {
-                                            if (_h && !_h.done && (_m = _g.return)) _m.call(_g);
+                                            if (drawingRels_2_1 && !drawingRels_2_1.done && (_h = drawingRels_2.return)) _h.call(drawingRels_2);
                                         }
                                         finally { if (e_31) throw e_31.error; }
                                         return [7 /*endfinally*/];
-                                    case 25:
-                                        drawingRels_2_1 = drawingRels_2.next();
-                                        return [3 /*break*/, 2];
-                                    case 26: return [3 /*break*/, 29];
-                                    case 27:
-                                        e_32_1 = _o.sent();
-                                        e_32 = { error: e_32_1 };
-                                        return [3 /*break*/, 29];
-                                    case 28:
-                                        try {
-                                            if (drawingRels_2_1 && !drawingRels_2_1.done && (_j = drawingRels_2.return)) _j.call(drawingRels_2);
-                                        }
-                                        finally { if (e_32) throw e_32.error; }
-                                        return [7 /*endfinally*/];
-                                    case 29: return [2 /*return*/];
+                                    case 21: return [2 /*return*/];
                                 }
                             });
                         };
                         this_3 = this;
-                        _b.label = 2;
+                        _c.label = 2;
                     case 2:
-                        _b.trys.push([2, 7, 8, 9]);
+                        _c.trys.push([2, 7, 8, 9]);
                         drawings_2 = __values(drawings), drawings_2_1 = drawings_2.next();
-                        _b.label = 3;
+                        _c.label = 3;
                     case 3:
                         if (!!drawings_2_1.done) return [3 /*break*/, 6];
                         drawingElement = drawings_2_1.value;
                         return [5 /*yield**/, _loop_6(drawingElement)];
                     case 4:
-                        _b.sent();
-                        _b.label = 5;
+                        _c.sent();
+                        _c.label = 5;
                     case 5:
                         drawings_2_1 = drawings_2.next();
                         return [3 /*break*/, 3];
                     case 6: return [3 /*break*/, 9];
                     case 7:
-                        e_28_1 = _b.sent();
+                        e_28_1 = _c.sent();
                         e_28 = { error: e_28_1 };
                         return [3 /*break*/, 9];
                     case 8:
@@ -3569,6 +3656,10 @@ var XlsxPlugin = /** @class */ (function (_super) {
         var _a;
         return (_a = this.theme) !== null && _a !== void 0 ? _a : defaultSpreadsheetTheme;
     };
+    /** `<cellStyles>` resolved to cell formats (toolbar "Workbook styles" gallery). */
+    XlsxPlugin.prototype.getNamedCellStyles = function () {
+        return resolveNamedCellStyles(this.workbookStyles);
+    };
     /**
      * The workbook default font — styles.xml fonts[0], the font every cell
      * without an explicit font inherits. Exporters pass this through so the
@@ -3605,9 +3696,46 @@ var XlsxPlugin = /** @class */ (function (_super) {
     XlsxPlugin.prototype._getSheets = function () {
         return this.workSheets;
     };
+    /**
+     * Resolve a builtin print name to its sheet (`localSheetId` indexes the
+     * `<sheets>` order; a name without scope falls back to the sheet named in
+     * the formula) and record the parsed print area / titles for `getSheets()`.
+     */
+    XlsxPlugin.prototype.stashBuiltinPrintName = function (name, expression, localSheetId, sheetIdBySheetName) {
+        var _a, _b;
+        if (!expression || expression.includes("#REF!"))
+            return;
+        var parsed = name === PRINT_AREA_NAME
+            ? parsePrintAreaFormula(expression)
+            : parsePrintTitlesFormula(expression);
+        if (!parsed)
+            return;
+        var sheetId;
+        if (localSheetId !== undefined) {
+            var index = parseInt(localSheetId, 10);
+            var sheetEl = this._getSheets()[index];
+            var id = Number((_a = sheetEl === null || sheetEl === void 0 ? void 0 : sheetEl.a$) === null || _a === void 0 ? void 0 : _a.sheetId);
+            if (Number.isFinite(id))
+                sheetId = id;
+        }
+        if (sheetId === undefined && parsed.sheetName) {
+            sheetId = sheetIdBySheetName[parsed.sheetName];
+        }
+        if (sheetId === undefined)
+            return;
+        var entry = (_b = this.printNamesBySheetId.get(sheetId)) !== null && _b !== void 0 ? _b : {};
+        if ("ranges" in parsed) {
+            entry.printArea = parsed.ranges;
+        }
+        else {
+            entry.printTitles = parsed.titles;
+        }
+        this.printNamesBySheetId.set(sheetId, entry);
+    };
     XlsxPlugin.prototype._getNamedRanges = function () {
-        var e_33, _a, e_34, _b;
-        var _c;
+        var e_32, _a, e_33, _b;
+        var _c, _d;
+        this.printNamesBySheetId.clear();
         var xml = this.workbookXml;
         var sheetIdBySheetName = this._getSheets().reduce(function (acc, element) {
             var _a;
@@ -3632,6 +3760,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                     var name_7 = (_c = defined_name.a$) === null || _c === void 0 ? void 0 : _c.name;
                     var expression = defined_name.t$ || "";
                     var hidden = defined_name.a$.hidden === "1";
+                    // `_xlnm.Print_Area` / `_xlnm.Print_Titles` are sheet-scoped print
+                    // facets, not user names: they land on `sheet.printSettings` (see
+                    // `getSheets()`), never in `namedRanges` — a global copy would make
+                    // Excel repair the file on the next export.
+                    if (isBuiltinPrintName(name_7)) {
+                        this.stashBuiltinPrintName(name_7, typeof expression === "string" ? expression : "", (_d = defined_name.a$) === null || _d === void 0 ? void 0 : _d.localSheetId, sheetIdBySheetName);
+                        continue;
+                    }
                     // Empty defined names are noise; nothing useful to round-trip.
                     // Hidden defined names ARE preserved — Excel uses them as scratch
                     // names for features like print areas and add-ins, and dropping
@@ -3647,7 +3783,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         var pushedRange = false;
                         if (selections.length) {
                             try {
-                                for (var selections_1 = (e_34 = void 0, __values(selections)), selections_1_1 = selections_1.next(); !selections_1_1.done; selections_1_1 = selections_1.next()) {
+                                for (var selections_1 = (e_33 = void 0, __values(selections)), selections_1_1 = selections_1.next(); !selections_1_1.done; selections_1_1 = selections_1.next()) {
                                     var selection = selections_1_1.value;
                                     var sheetId = selection.sheetName
                                         ? sheetIdBySheetName[selection.sheetName]
@@ -3658,12 +3794,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                     }
                                 }
                             }
-                            catch (e_34_1) { e_34 = { error: e_34_1 }; }
+                            catch (e_33_1) { e_33 = { error: e_33_1 }; }
                             finally {
                                 try {
                                     if (selections_1_1 && !selections_1_1.done && (_b = selections_1.return)) _b.call(selections_1);
                                 }
-                                finally { if (e_34) throw e_34.error; }
+                                finally { if (e_33) throw e_33.error; }
                             }
                         }
                         // Reference parsed but no selection bound to a known sheet — most
@@ -3687,12 +3823,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                     }
                 }
             }
-            catch (e_33_1) { e_33 = { error: e_33_1 }; }
+            catch (e_32_1) { e_32 = { error: e_32_1 }; }
             finally {
                 try {
                     if (defined_names_1_1 && !defined_names_1_1.done && (_a = defined_names_1.return)) _a.call(defined_names_1);
                 }
-                finally { if (e_33) throw e_33.error; }
+                finally { if (e_32) throw e_32.error; }
             }
         }
         return namedRanges;
@@ -3751,8 +3887,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
     // INTERFACE IMPLEMENTATION METHODS
     XlsxPlugin.prototype.getSheets = function () {
         return __awaiter(this, arguments, void 0, function (minRowCount, minColumnCount) {
-            var workSheets, sheets, tables, workSheets_1, workSheets_1_1, element, built, e_35_1;
-            var e_35, _a;
+            var workSheets, sheets, tables, workSheets_1, workSheets_1_1, element, built, e_34_1;
+            var e_34, _a;
             var _b;
             if (minRowCount === void 0) { minRowCount = 0; }
             if (minColumnCount === void 0) { minColumnCount = 0; }
@@ -3787,14 +3923,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 2];
                     case 5: return [3 /*break*/, 8];
                     case 6:
-                        e_35_1 = _c.sent();
-                        e_35 = { error: e_35_1 };
+                        e_34_1 = _c.sent();
+                        e_34 = { error: e_34_1 };
                         return [3 /*break*/, 8];
                     case 7:
                         try {
                             if (workSheets_1_1 && !workSheets_1_1.done && (_a = workSheets_1.return)) _a.call(workSheets_1);
                         }
-                        finally { if (e_35) throw e_35.error; }
+                        finally { if (e_34) throw e_34.error; }
                         return [7 /*endfinally*/];
                     case 8: return [2 /*return*/, [sheets, tables]];
                 }
@@ -3852,8 +3988,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
     };
     XlsxPlugin.prototype.buildSheetFromElement = function (element_1) {
         return __awaiter(this, arguments, void 0, function (element, minRowCount, minColumnCount) {
-            var name, state, sheetId, rid, visibility, hidden, sheet_1, metadata, merges, rowEntries, columnMetadata, maxRowIndex, maxColumnIndex, autoFilterRange_1, filterSpecs, sheetViewData, tabColor, sheetHasFilterMode_1, zeroHeight_1, defaultRowHeightPx, defaultColumnWidthPx, tablePartIds, outlineSummaryBelow, outlineSummaryRight, rowCount, sheetTables, rowInTableMap_1, columnCount, _a, frozenRowCount, frozenColumnCount, paneTopLeftCell, showGridLines, showRowColHeaders, showZeros, zoomScale, merges_2, merges_2_1, range, drawingBounds, finalRowCount, finalColumnCount;
-            var e_36, _b;
+            var name, state, sheetId, rid, visibility, hidden, sheet_1, metadata, merges, rowEntries, columnMetadata, maxRowIndex, maxColumnIndex, autoFilterRange_1, filterSpecs, sheetViewData, tabColor, sheetHasFilterMode_1, zeroHeight_1, defaultRowHeightPx, defaultColumnWidthPx, tablePartIds, outlineSummaryBelow, outlineSummaryRight, sheetProtection, protectedRangeEntries, printSettings, printNames, merged, rowCount, sheetTables, rowInTableMap_1, columnCount, _a, frozenRowCount, frozenColumnCount, paneTopLeftCell, showGridLines, showRowColHeaders, showZeros, zoomScale, rightToLeft, merges_2, merges_2_1, range, drawingBounds, finalRowCount, finalColumnCount;
+            var e_35, _b;
             var _c;
             if (minRowCount === void 0) { minRowCount = 0; }
             if (minColumnCount === void 0) { minColumnCount = 0; }
@@ -3885,7 +4021,17 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [4 /*yield*/, this.getSheetMetadata(rid)];
                     case 1:
                         metadata = _d.sent();
-                        merges = metadata.merges, rowEntries = metadata.rowEntries, columnMetadata = metadata.columnMetadata, maxRowIndex = metadata.maxRowIndex, maxColumnIndex = metadata.maxColumnIndex, autoFilterRange_1 = metadata.autoFilterRange, filterSpecs = metadata.filterSpecs, sheetViewData = metadata.sheetViewData, tabColor = metadata.tabColor, sheetHasFilterMode_1 = metadata.sheetHasFilterMode, zeroHeight_1 = metadata.zeroHeight, defaultRowHeightPx = metadata.defaultRowHeightPx, defaultColumnWidthPx = metadata.defaultColumnWidthPx, tablePartIds = metadata.tablePartIds, outlineSummaryBelow = metadata.outlineSummaryBelow, outlineSummaryRight = metadata.outlineSummaryRight;
+                        merges = metadata.merges, rowEntries = metadata.rowEntries, columnMetadata = metadata.columnMetadata, maxRowIndex = metadata.maxRowIndex, maxColumnIndex = metadata.maxColumnIndex, autoFilterRange_1 = metadata.autoFilterRange, filterSpecs = metadata.filterSpecs, sheetViewData = metadata.sheetViewData, tabColor = metadata.tabColor, sheetHasFilterMode_1 = metadata.sheetHasFilterMode, zeroHeight_1 = metadata.zeroHeight, defaultRowHeightPx = metadata.defaultRowHeightPx, defaultColumnWidthPx = metadata.defaultColumnWidthPx, tablePartIds = metadata.tablePartIds, outlineSummaryBelow = metadata.outlineSummaryBelow, outlineSummaryRight = metadata.outlineSummaryRight, sheetProtection = metadata.sheetProtection, protectedRangeEntries = metadata.protectedRangeEntries, printSettings = metadata.printSettings;
+                        if (sheetProtection) {
+                            sheet_1.sheetProtection = sheetProtection;
+                        }
+                        {
+                            printNames = this.printNamesBySheetId.get(sheetId);
+                            merged = compactPrintSettings(__assign(__assign({}, printSettings), { printArea: printNames === null || printNames === void 0 ? void 0 : printNames.printArea, printTitles: printNames === null || printNames === void 0 ? void 0 : printNames.printTitles }));
+                            if (merged)
+                                sheet_1.printSettings = merged;
+                        }
+                        this.protectedRangesBySheet.set(sheetId, protectedRangesFromEntries(sheetId, protectedRangeEntries));
                         if (defaultRowHeightPx !== undefined) {
                             sheet_1.defaultRowHeight = defaultRowHeightPx;
                         }
@@ -3917,7 +4063,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                             }
                         });
                         columnCount = 0;
-                        _a = extractSheetViewProperties(sheetViewData), frozenRowCount = _a.frozenRowCount, frozenColumnCount = _a.frozenColumnCount, paneTopLeftCell = _a.paneTopLeftCell, showGridLines = _a.showGridLines, showRowColHeaders = _a.showRowColHeaders, showZeros = _a.showZeros, zoomScale = _a.zoomScale;
+                        _a = extractSheetViewProperties(sheetViewData), frozenRowCount = _a.frozenRowCount, frozenColumnCount = _a.frozenColumnCount, paneTopLeftCell = _a.paneTopLeftCell, showGridLines = _a.showGridLines, showRowColHeaders = _a.showRowColHeaders, showZeros = _a.showZeros, zoomScale = _a.zoomScale, rightToLeft = _a.rightToLeft;
                         sheet_1.frozenRowCount = frozenRowCount;
                         sheet_1.frozenColumnCount = frozenColumnCount;
                         if (paneTopLeftCell) {
@@ -3933,6 +4079,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         if (zoomScale !== undefined && zoomScale !== 100) {
                             sheet_1.zoomScale = zoomScale;
                         }
+                        if (rightToLeft)
+                            sheet_1.rightToLeft = true;
                         // tab color
                         if (tabColor) {
                             sheet_1.tabColor = extractColor(tabColor, this.workbookStyles.indexedColors);
@@ -3952,12 +4100,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 sheet_1.merges.push(range);
                             }
                         }
-                        catch (e_36_1) { e_36 = { error: e_36_1 }; }
+                        catch (e_35_1) { e_35 = { error: e_35_1 }; }
                         finally {
                             try {
                                 if (merges_2_1 && !merges_2_1.done && (_b = merges_2.return)) _b.call(merges_2);
                             }
-                            finally { if (e_36) throw e_36.error; }
+                            finally { if (e_35) throw e_35.error; }
                         }
                         columnCount = findMax([maxColumnIndex, minColumnCount]);
                         rowEntries.forEach(function (entry, rowIndex) {
@@ -4045,8 +4193,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
     };
     XlsxPlugin.prototype.processSheetData = function () {
         return __asyncGenerator(this, arguments, function processSheetData_1(chunkSize, enableCellXfsRegistry, _enableSharedStrings, onPhase) {
-            var workSheets, totalSheets, currentSheetIndex, workSheets_2, workSheets_2_1, element, e_37_1;
-            var e_37, _a;
+            var workSheets, totalSheets, currentSheetIndex, workSheets_2, workSheets_2_1, element, e_36_1;
+            var e_36, _a;
             var _b;
             if (chunkSize === void 0) { chunkSize = 100; }
             if (enableCellXfsRegistry === void 0) { enableCellXfsRegistry = false; }
@@ -4085,14 +4233,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 2];
                     case 6: return [3 /*break*/, 9];
                     case 7:
-                        e_37_1 = _c.sent();
-                        e_37 = { error: e_37_1 };
+                        e_36_1 = _c.sent();
+                        e_36 = { error: e_36_1 };
                         return [3 /*break*/, 9];
                     case 8:
                         try {
                             if (workSheets_2_1 && !workSheets_2_1.done && (_a = workSheets_2.return)) _a.call(workSheets_2);
                         }
-                        finally { if (e_37) throw e_37.error; }
+                        finally { if (e_36) throw e_36.error; }
                         return [7 /*endfinally*/];
                     case 9: return [2 /*return*/];
                 }
@@ -4142,10 +4290,10 @@ var XlsxPlugin = /** @class */ (function (_super) {
     };
     XlsxPlugin.prototype.processOneSheet = function (element_1, _a) {
         return __asyncGenerator(this, arguments, function processOneSheet_1(element, _b) {
-            var name_8, sheetId_1, rid, metadata, materializeMaxColumn, colStyleByColumn_1, _c, _d, _e, min, max, styleIndex, clampedMax, col, styleCellTemplates_1, getTemplateForStyleIndex, styleMaterializeBudget, mergeRangesByRow_1, getMergeRangeForCell, sheetComments, sheetThreadedComments_1, commentsByRow_1, threadsByRow_1, hyperlinksByRow, sparklinesByRow, dvFeatures, dvStamper, _f, _g, CHUNK_SIZE, chunkIndex_1, totalRowsProcessed_1, totalRowsKnown_1, lastRowIndex, currentChunk_1, currentChunkRowIndices_1, startRowIndex_1, endRowIndex_1, flushChunk, _loop_7, this_4, _h, _j, _k, e_38_1, _l, _m, trailing, payload, e_39_1, finalPayload;
-            var e_40, _o, e_39, _p;
+            var name_8, sheetId_1, rid, metadata, materializeMaxColumn, colStyleByColumn_1, _c, _d, _e, min, max, styleIndex, clampedMax, col, styleCellTemplates_1, getTemplateForStyleIndex, styleMaterializeBudget, mergeRangesByRow_1, getMergeRangeForCell, sheetComments, sheetThreadedComments_1, commentsByRow_1, threadsByRow_1, hyperlinksByRow, sparklinesByRow, dvFeatures, dvStamper, _f, _g, CHUNK_SIZE, chunkIndex_1, totalRowsProcessed_1, totalRowsKnown_1, lastRowIndex, currentChunk_1, currentChunkRowIndices_1, startRowIndex_1, endRowIndex_1, flushChunk, _loop_7, this_4, _h, _j, _k, e_37_1, _l, _m, trailing, payload, e_38_1, finalPayload;
+            var e_39, _o, e_38, _p;
             var _this = this;
-            var _q, e_38, _r, _s;
+            var _q, e_37, _r, _s;
             var _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4;
             var chunkSize = _b.chunkSize, enableCellXfsRegistry = _b.enableCellXfsRegistry, _enableSharedStrings = _b.enableSharedStrings, onPhase = _b.onPhase, currentSheetIndex = _b.currentSheetIndex, totalSheets = _b.totalSheets;
             return __generator(this, function (_5) {
@@ -4175,12 +4323,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 }
                             }
                         }
-                        catch (e_40_1) { e_40 = { error: e_40_1 }; }
+                        catch (e_39_1) { e_39 = { error: e_39_1 }; }
                         finally {
                             try {
                                 if (_d && !_d.done && (_o = _c.return)) _o.call(_c);
                             }
-                            finally { if (e_40) throw e_40.error; }
+                            finally { if (e_39) throw e_39.error; }
                         }
                         styleCellTemplates_1 = new Map();
                         getTemplateForStyleIndex = function (styleIndex) {
@@ -4194,7 +4342,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         styleMaterializeBudget = STYLE_MATERIALIZE_CELL_BUDGET;
                         mergeRangesByRow_1 = this.buildMergeRangesByRow(metadata.merges);
                         getMergeRangeForCell = function (rowIndex, columnIndex) {
-                            var e_41, _a;
+                            var e_40, _a;
                             var ranges = mergeRangesByRow_1.get(rowIndex);
                             if (!ranges)
                                 return undefined;
@@ -4207,12 +4355,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                     }
                                 }
                             }
-                            catch (e_41_1) { e_41 = { error: e_41_1 }; }
+                            catch (e_40_1) { e_40 = { error: e_40_1 }; }
                             finally {
                                 try {
                                     if (ranges_1_1 && !ranges_1_1.done && (_a = ranges_1.return)) _a.call(ranges_1);
                                 }
-                                finally { if (e_41) throw e_41.error; }
+                                finally { if (e_40) throw e_40.error; }
                             }
                             return undefined;
                         };
@@ -4312,7 +4460,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         _5.trys.push([9, 15, 16, 21]);
                         _loop_7 = function () {
                             var row, parsedRowIndex, rowIndex, rowData, rowAttrs, hasRowCustomFormat, parsedRowStyle, rowStyleIndex, getInheritedStyleIndex, cells, rowComments, rowThreads, rowHyperlinks, rowCellsByColumnIndex, cellArray, seqColIndex, cellArray_1, cellArray_1_1, cell, cellRef, columnIndex, colStr, inherited, k, cell, cellRef, columnIndex, colStr, mergeRange, cellValue, hyperlink, comment, threadId, columnIndex, inherited, template, _6, _7, _8, columnIndex, hyperlink, _9, _10, _11, columnIndex, text, _12, _13, _14, columnIndex, threadId, rowSparklines, _15, _16, _17, columnIndex, sparkline, existingCell, preserveGaps, sparklineData, selection, _18, startRowIndex_2, endRowIndex_2, startColumnIndex, endColumnIndex, col, cell, value, sparklineOptions, cellData, payload;
-                            var e_42, _19, e_43, _20, e_44, _21, e_45, _22, e_46, _23;
+                            var e_41, _19, e_42, _20, e_43, _21, e_44, _22, e_45, _23;
                             return __generator(this, function (_24) {
                                 switch (_24.label) {
                                     case 0:
@@ -4354,7 +4502,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                             cellArray = Array.isArray(cells) ? cells : [cells];
                                             seqColIndex = 1;
                                             try {
-                                                for (cellArray_1 = (e_42 = void 0, __values(cellArray)), cellArray_1_1 = cellArray_1.next(); !cellArray_1_1.done; cellArray_1_1 = cellArray_1.next()) {
+                                                for (cellArray_1 = (e_41 = void 0, __values(cellArray)), cellArray_1_1 = cellArray_1.next(); !cellArray_1_1.done; cellArray_1_1 = cellArray_1.next()) {
                                                     cell = cellArray_1_1.value;
                                                     if (!cell || !cell.a$) {
                                                         seqColIndex++;
@@ -4381,12 +4529,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                                     rowCellsByColumnIndex.set(columnIndex, cell);
                                                 }
                                             }
-                                            catch (e_42_1) { e_42 = { error: e_42_1 }; }
+                                            catch (e_41_1) { e_41 = { error: e_41_1 }; }
                                             finally {
                                                 try {
                                                     if (cellArray_1_1 && !cellArray_1_1.done && (_19 = cellArray_1.return)) _19.call(cellArray_1);
                                                 }
-                                                finally { if (e_42) throw e_42.error; }
+                                                finally { if (e_41) throw e_41.error; }
                                             }
                                             // Second pass: process each cell
                                             seqColIndex = 1;
@@ -4460,7 +4608,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                         }
                                         if (rowHyperlinks) {
                                             try {
-                                                for (_6 = (e_43 = void 0, __values(rowHyperlinks.entries())), _7 = _6.next(); !_7.done; _7 = _6.next()) {
+                                                for (_6 = (e_42 = void 0, __values(rowHyperlinks.entries())), _7 = _6.next(); !_7.done; _7 = _6.next()) {
                                                     _8 = __read(_7.value, 2), columnIndex = _8[0], hyperlink = _8[1];
                                                     if (rowData.values[columnIndex]) {
                                                         if (!((_y = rowData.values[columnIndex]) === null || _y === void 0 ? void 0 : _y.hyperlink)) {
@@ -4472,18 +4620,18 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                                     }
                                                 }
                                             }
-                                            catch (e_43_1) { e_43 = { error: e_43_1 }; }
+                                            catch (e_42_1) { e_42 = { error: e_42_1 }; }
                                             finally {
                                                 try {
                                                     if (_7 && !_7.done && (_20 = _6.return)) _20.call(_6);
                                                 }
-                                                finally { if (e_43) throw e_43.error; }
+                                                finally { if (e_42) throw e_42.error; }
                                             }
                                             hyperlinksByRow.delete(rowIndex);
                                         }
                                         if (rowComments) {
                                             try {
-                                                for (_9 = (e_44 = void 0, __values(rowComments.entries())), _10 = _9.next(); !_10.done; _10 = _9.next()) {
+                                                for (_9 = (e_43 = void 0, __values(rowComments.entries())), _10 = _9.next(); !_10.done; _10 = _9.next()) {
                                                     _11 = __read(_10.value, 2), columnIndex = _11[0], text = _11[1];
                                                     if (rowData.values[columnIndex]) {
                                                         if (!((_z = rowData.values[columnIndex]) === null || _z === void 0 ? void 0 : _z.note)) {
@@ -4495,18 +4643,18 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                                     }
                                                 }
                                             }
-                                            catch (e_44_1) { e_44 = { error: e_44_1 }; }
+                                            catch (e_43_1) { e_43 = { error: e_43_1 }; }
                                             finally {
                                                 try {
                                                     if (_10 && !_10.done && (_21 = _9.return)) _21.call(_9);
                                                 }
-                                                finally { if (e_44) throw e_44.error; }
+                                                finally { if (e_43) throw e_43.error; }
                                             }
                                             commentsByRow_1.delete(rowIndex);
                                         }
                                         if (rowThreads) {
                                             try {
-                                                for (_12 = (e_45 = void 0, __values(rowThreads.entries())), _13 = _12.next(); !_13.done; _13 = _12.next()) {
+                                                for (_12 = (e_44 = void 0, __values(rowThreads.entries())), _13 = _12.next(); !_13.done; _13 = _12.next()) {
                                                     _14 = __read(_13.value, 2), columnIndex = _14[0], threadId = _14[1];
                                                     if (rowData.values[columnIndex]) {
                                                         if (!((_0 = rowData.values[columnIndex]) === null || _0 === void 0 ? void 0 : _0.commentThreadId)) {
@@ -4520,19 +4668,19 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                                     }
                                                 }
                                             }
-                                            catch (e_45_1) { e_45 = { error: e_45_1 }; }
+                                            catch (e_44_1) { e_44 = { error: e_44_1 }; }
                                             finally {
                                                 try {
                                                     if (_13 && !_13.done && (_22 = _12.return)) _22.call(_12);
                                                 }
-                                                finally { if (e_45) throw e_45.error; }
+                                                finally { if (e_44) throw e_44.error; }
                                             }
                                             threadsByRow_1.delete(rowIndex);
                                         }
                                         rowSparklines = sparklinesByRow.get(rowIndex);
                                         if (rowSparklines) {
                                             try {
-                                                for (_15 = (e_46 = void 0, __values(rowSparklines.entries())), _16 = _15.next(); !_16.done; _16 = _15.next()) {
+                                                for (_15 = (e_45 = void 0, __values(rowSparklines.entries())), _16 = _15.next(); !_16.done; _16 = _15.next()) {
                                                     _17 = __read(_16.value, 2), columnIndex = _17[0], sparkline = _17[1];
                                                     existingCell = rowData.values[columnIndex];
                                                     // Only set formula if cell doesn't already have one
@@ -4627,12 +4775,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                                     rowData.values[columnIndex] = cellData;
                                                 }
                                             }
-                                            catch (e_46_1) { e_46 = { error: e_46_1 }; }
+                                            catch (e_45_1) { e_45 = { error: e_45_1 }; }
                                             finally {
                                                 try {
                                                     if (_16 && !_16.done && (_23 = _15.return)) _23.call(_15);
                                                 }
-                                                finally { if (e_46) throw e_46.error; }
+                                                finally { if (e_45) throw e_45.error; }
                                             }
                                             sparklinesByRow.delete(rowIndex);
                                         }
@@ -4667,8 +4815,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 10];
                     case 14: return [3 /*break*/, 21];
                     case 15:
-                        e_38_1 = _5.sent();
-                        e_38 = { error: e_38_1 };
+                        e_37_1 = _5.sent();
+                        e_37 = { error: e_37_1 };
                         return [3 /*break*/, 21];
                     case 16:
                         _5.trys.push([16, , 19, 20]);
@@ -4679,7 +4827,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         _5.label = 18;
                     case 18: return [3 /*break*/, 20];
                     case 19:
-                        if (e_38) throw e_38.error;
+                        if (e_37) throw e_37.error;
                         return [7 /*endfinally*/];
                     case 20: return [7 /*endfinally*/];
                     case 21:
@@ -4712,14 +4860,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 23];
                     case 27: return [3 /*break*/, 30];
                     case 28:
-                        e_39_1 = _5.sent();
-                        e_39 = { error: e_39_1 };
+                        e_38_1 = _5.sent();
+                        e_38 = { error: e_38_1 };
                         return [3 /*break*/, 30];
                     case 29:
                         try {
                             if (_m && !_m.done && (_p = _l.return)) _p.call(_l);
                         }
-                        finally { if (e_39) throw e_39.error; }
+                        finally { if (e_38) throw e_38.error; }
                         return [7 /*endfinally*/];
                     case 30:
                         finalPayload = flushChunk(true);
@@ -4736,58 +4884,180 @@ var XlsxPlugin = /** @class */ (function (_super) {
     };
     XlsxPlugin.prototype.getDrawings = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var workSheets, allDrawings, workSheets_3, workSheets_3_1, element, sheetId, rid, features, sheet_data, drawings, e_47_1;
-            var e_47, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            var workSheets, allDrawings, workSheets_3, workSheets_3_1, element, sheetId, rid, features, sheet_data, drawings, _a, _b, _c, _d, e_46_1;
+            var e_46, _e;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
                     case 0:
                         workSheets = this._getSheets();
                         allDrawings = [];
-                        _b.label = 1;
+                        _f.label = 1;
                     case 1:
-                        _b.trys.push([1, 7, 8, 9]);
+                        _f.trys.push([1, 9, 10, 11]);
                         workSheets_3 = __values(workSheets), workSheets_3_1 = workSheets_3.next();
-                        _b.label = 2;
+                        _f.label = 2;
                     case 2:
-                        if (!!workSheets_3_1.done) return [3 /*break*/, 6];
+                        if (!!workSheets_3_1.done) return [3 /*break*/, 8];
                         element = workSheets_3_1.value;
                         sheetId = Number(element.a$.sheetId);
                         rid = element.a$["r:id"];
                         features = this.sheetFeatures.get(rid);
-                        if (features && !features.drawing) {
-                            return [3 /*break*/, 5];
+                        if (features && !features.drawing && !features.controls) {
+                            return [3 /*break*/, 7];
                         }
                         return [4 /*yield*/, this.getSheetData(rid)];
                     case 3:
-                        sheet_data = _b.sent();
+                        sheet_data = _f.sent();
+                        if (!(!features || features.drawing)) return [3 /*break*/, 5];
                         return [4 /*yield*/, this._getDrawings(rid, sheetId, sheet_data)];
                     case 4:
-                        drawings = _b.sent();
+                        drawings = _f.sent();
                         allDrawings.push.apply(allDrawings, __spreadArray([], __read(drawings), false));
-                        _b.label = 5;
+                        _f.label = 5;
                     case 5:
+                        if (!(!features || features.controls)) return [3 /*break*/, 7];
+                        _b = (_a = allDrawings.push).apply;
+                        _c = [allDrawings];
+                        _d = [[]];
+                        return [4 /*yield*/, this._getFormControls(rid, sheetId, sheet_data)];
+                    case 6:
+                        _b.apply(_a, _c.concat([__spreadArray.apply(void 0, _d.concat([__read.apply(void 0, [(_f.sent())]), false]))]));
+                        _f.label = 7;
+                    case 7:
                         workSheets_3_1 = workSheets_3.next();
                         return [3 /*break*/, 2];
-                    case 6: return [3 /*break*/, 9];
+                    case 8: return [3 /*break*/, 11];
+                    case 9:
+                        e_46_1 = _f.sent();
+                        e_46 = { error: e_46_1 };
+                        return [3 /*break*/, 11];
+                    case 10:
+                        try {
+                            if (workSheets_3_1 && !workSheets_3_1.done && (_e = workSheets_3.return)) _e.call(workSheets_3);
+                        }
+                        finally { if (e_46) throw e_46.error; }
+                        return [7 /*endfinally*/];
+                    case 11: return [2 /*return*/, allDrawings];
+                }
+            });
+        });
+    };
+    /**
+     * Form controls: `<controls><control r:id>` → `xl/ctrlProps/ctrlPropN.xml`
+     * (+ the caption from the sheet's legacy VML part), as `formControl`
+     * embeds. Nothing is rendered interactively — they round-trip.
+     */
+    XlsxPlugin.prototype._getFormControls = function (rid, sheetId, sheetData) {
+        return __awaiter(this, void 0, void 0, function () {
+            var controls, target, sheetPath, sheetRelPath, relTargets, sheetRels, _a, _b, list, _c, _d, rel, id, relTarget, _e, ctrlProps, controls_1, controls_1_1, control, relTarget, xml, _f, e_47_1, captions, legacyRelId, vmlTarget, _g, _h;
+            var e_48, _j, e_47, _k;
+            var _l, _m;
+            return __generator(this, function (_o) {
+                switch (_o.label) {
+                    case 0:
+                        controls = readWorksheetControls(sheetData);
+                        if (!controls.length)
+                            return [2 /*return*/, []];
+                        target = this.relations[rid].target;
+                        sheetPath = target.startsWith("/xl")
+                            ? target.replace(/^\//gi, "")
+                            : "xl/".concat(target);
+                        sheetRelPath = sheetPath.replace("worksheets", "worksheets/_rels") + ".rels";
+                        relTargets = new Map();
+                        _o.label = 1;
+                    case 1:
+                        _o.trys.push([1, 3, , 4]);
+                        _b = (_a = this.xmlParser).parse;
+                        return [4 /*yield*/, this.zipParser.getText(sheetRelPath)];
+                    case 2:
+                        sheetRels = _b.apply(_a, [_o.sent()]);
+                        list = get(sheetRels, "Relationships.Relationship");
+                        try {
+                            for (_c = __values(Array.isArray(list) ? list : list ? [list] : []), _d = _c.next(); !_d.done; _d = _c.next()) {
+                                rel = _d.value;
+                                id = (_l = rel === null || rel === void 0 ? void 0 : rel.a$) === null || _l === void 0 ? void 0 : _l.Id;
+                                relTarget = (_m = rel === null || rel === void 0 ? void 0 : rel.a$) === null || _m === void 0 ? void 0 : _m.Target;
+                                if (typeof id === "string" && typeof relTarget === "string") {
+                                    relTargets.set(id, relTarget);
+                                }
+                            }
+                        }
+                        catch (e_48_1) { e_48 = { error: e_48_1 }; }
+                        finally {
+                            try {
+                                if (_d && !_d.done && (_j = _c.return)) _j.call(_c);
+                            }
+                            finally { if (e_48) throw e_48.error; }
+                        }
+                        return [3 /*break*/, 4];
+                    case 3:
+                        _e = _o.sent();
+                        return [2 /*return*/, []];
+                    case 4:
+                        ctrlProps = new Map();
+                        _o.label = 5;
+                    case 5:
+                        _o.trys.push([5, 12, 13, 14]);
+                        controls_1 = __values(controls), controls_1_1 = controls_1.next();
+                        _o.label = 6;
+                    case 6:
+                        if (!!controls_1_1.done) return [3 /*break*/, 11];
+                        control = controls_1_1.value;
+                        if (!control.relId || ctrlProps.has(control.relId))
+                            return [3 /*break*/, 10];
+                        relTarget = relTargets.get(control.relId);
+                        if (!relTarget)
+                            return [3 /*break*/, 10];
+                        _o.label = 7;
                     case 7:
-                        e_47_1 = _b.sent();
-                        e_47 = { error: e_47_1 };
-                        return [3 /*break*/, 9];
+                        _o.trys.push([7, 9, , 10]);
+                        return [4 /*yield*/, this.zipParser.getText(this.resolveRelationshipTarget(sheetPath, relTarget))];
                     case 8:
+                        xml = _o.sent();
+                        ctrlProps.set(control.relId, parseFormControlPr(this.xmlPreserveValueParser.parse(xml)));
+                        return [3 /*break*/, 10];
+                    case 9:
+                        _f = _o.sent();
+                        return [3 /*break*/, 10];
+                    case 10:
+                        controls_1_1 = controls_1.next();
+                        return [3 /*break*/, 6];
+                    case 11: return [3 /*break*/, 14];
+                    case 12:
+                        e_47_1 = _o.sent();
+                        e_47 = { error: e_47_1 };
+                        return [3 /*break*/, 14];
+                    case 13:
                         try {
-                            if (workSheets_3_1 && !workSheets_3_1.done && (_a = workSheets_3.return)) _a.call(workSheets_3);
+                            if (controls_1_1 && !controls_1_1.done && (_k = controls_1.return)) _k.call(controls_1);
                         }
                         finally { if (e_47) throw e_47.error; }
                         return [7 /*endfinally*/];
-                    case 9: return [2 /*return*/, allDrawings];
+                    case 14:
+                        captions = new Map();
+                        legacyRelId = readLegacyDrawingRelId(sheetData);
+                        vmlTarget = legacyRelId ? relTargets.get(legacyRelId) : undefined;
+                        if (!vmlTarget) return [3 /*break*/, 18];
+                        _o.label = 15;
+                    case 15:
+                        _o.trys.push([15, 17, , 18]);
+                        _g = parseVmlControlCaptions;
+                        return [4 /*yield*/, this.zipParser.getText(this.resolveRelationshipTarget(sheetPath, vmlTarget))];
+                    case 16:
+                        captions = _g.apply(void 0, [_o.sent()]);
+                        return [3 /*break*/, 18];
+                    case 17:
+                        _h = _o.sent();
+                        return [3 /*break*/, 18];
+                    case 18: return [2 /*return*/, buildFormControlEmbeds({ controls: controls, sheetId: sheetId, ctrlProps: ctrlProps, captions: captions })];
                 }
             });
         });
     };
     XlsxPlugin.prototype.getCharts = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var allCharts, workSheets, workSheets_4, workSheets_4_1, element, sheetId, rid, features, sheet_data, charts, e_48_1;
-            var e_48, _a;
+            var allCharts, workSheets, workSheets_4, workSheets_4_1, element, sheetId, rid, features, sheet_data, charts, e_49_1;
+            var e_49, _a;
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
@@ -4820,14 +5090,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 2];
                     case 6: return [3 /*break*/, 9];
                     case 7:
-                        e_48_1 = _b.sent();
-                        e_48 = { error: e_48_1 };
+                        e_49_1 = _b.sent();
+                        e_49 = { error: e_49_1 };
                         return [3 /*break*/, 9];
                     case 8:
                         try {
                             if (workSheets_4_1 && !workSheets_4_1.done && (_a = workSheets_4.return)) _a.call(workSheets_4);
                         }
-                        finally { if (e_48) throw e_48.error; }
+                        finally { if (e_49) throw e_49.error; }
                         return [7 /*endfinally*/];
                     case 9: return [2 /*return*/, allCharts];
                 }
@@ -4842,8 +5112,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
      */
     XlsxPlugin.prototype.getPivotTables = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var parsePivotTablesForSheet, all, workSheets, sheetNameToId, workSheets_5, workSheets_5_1, ws, name_9, id, pivotIdCounter, nextPivotId, workSheets_6, workSheets_6_1, element, sheetId, rid, target, path, sheetRelPath, sheetRelContent, _a, sheetRels, relList, relArray, pivotRels, pivots, e_49_1;
-            var e_50, _b, e_49, _c;
+            var parsePivotTablesForSheet, all, workSheets, sheetNameToId, workSheets_5, workSheets_5_1, ws, name_9, id, pivotIdCounter, nextPivotId, workSheets_6, workSheets_6_1, element, sheetId, rid, target, path, sheetRelPath, sheetRelContent, _a, sheetRels, relList, relArray, pivotRels, pivots, e_50_1;
+            var e_51, _b, e_50, _c;
             var _d, _e, _f;
             return __generator(this, function (_g) {
                 switch (_g.label) {
@@ -4862,12 +5132,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                     sheetNameToId.set(name_9, id);
                             }
                         }
-                        catch (e_50_1) { e_50 = { error: e_50_1 }; }
+                        catch (e_51_1) { e_51 = { error: e_51_1 }; }
                         finally {
                             try {
                                 if (workSheets_5_1 && !workSheets_5_1.done && (_b = workSheets_5.return)) _b.call(workSheets_5);
                             }
-                            finally { if (e_50) throw e_50.error; }
+                            finally { if (e_51) throw e_51.error; }
                         }
                         pivotIdCounter = 1;
                         nextPivotId = function () { return "imported-pivot-".concat(pivotIdCounter++); };
@@ -4936,14 +5206,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 3];
                     case 10: return [3 /*break*/, 13];
                     case 11:
-                        e_49_1 = _g.sent();
-                        e_49 = { error: e_49_1 };
+                        e_50_1 = _g.sent();
+                        e_50 = { error: e_50_1 };
                         return [3 /*break*/, 13];
                     case 12:
                         try {
                             if (workSheets_6_1 && !workSheets_6_1.done && (_c = workSheets_6.return)) _c.call(workSheets_6);
                         }
-                        finally { if (e_49) throw e_49.error; }
+                        finally { if (e_50) throw e_50.error; }
                         return [7 /*endfinally*/];
                     case 13: return [2 /*return*/, all];
                 }
@@ -4960,8 +5230,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
      */
     XlsxPlugin.prototype.getPowerQuery = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var customXmlParts, connectionsXml, _a, _b, rel, type, itemPath, itemXml, propsXml, itemRelsPath, itemRels, _c, _d, relList, relArray, propsRel, propsPath, path, e_51_1, queryTables, _e, _f, element, rid, target, sheetPath, sheetRelsPath, sheetRels, _g, _h, relList, relArray, relArray_1, relArray_1_1, r, relType, tablePath, tableRelsPath, tableRels, _j, _k, tableRelList, tableRelArray, qtRel, qtPath, partXml, tableData, _l, _m, tableDefinition, attrs, tableTitle, colDefs, colArray, columns, e_52_1, e_53_1, parts;
-            var e_51, _o, e_53, _p, e_52, _q;
+            var customXmlParts, connectionsXml, _a, _b, rel, type, itemPath, itemXml, propsXml, itemRelsPath, itemRels, _c, _d, relList, relArray, propsRel, propsPath, path, e_52_1, queryTables, _e, _f, element, rid, target, sheetPath, sheetRelsPath, sheetRels, _g, _h, relList, relArray, relArray_1, relArray_1_1, r, relType, tablePath, tableRelsPath, tableRels, _j, _k, tableRelList, tableRelArray, qtRel, qtPath, partXml, tableData, _l, _m, tableDefinition, attrs, tableTitle, colDefs, colArray, columns, e_53_1, e_54_1, parts;
+            var e_52, _o, e_54, _p, e_53, _q;
             var _r, _s, _t, _u, _v, _w;
             return __generator(this, function (_x) {
                 switch (_x.label) {
@@ -5023,14 +5293,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 2];
                     case 10: return [3 /*break*/, 13];
                     case 11:
-                        e_51_1 = _x.sent();
-                        e_51 = { error: e_51_1 };
+                        e_52_1 = _x.sent();
+                        e_52 = { error: e_52_1 };
                         return [3 /*break*/, 13];
                     case 12:
                         try {
                             if (_b && !_b.done && (_o = _a.return)) _o.call(_a);
                         }
-                        finally { if (e_51) throw e_51.error; }
+                        finally { if (e_52) throw e_52.error; }
                         return [7 /*endfinally*/];
                     case 13:
                         queryTables = [];
@@ -5059,7 +5329,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         _x.label = 17;
                     case 17:
                         _x.trys.push([17, 24, 25, 26]);
-                        relArray_1 = (e_52 = void 0, __values(relArray)), relArray_1_1 = relArray_1.next();
+                        relArray_1 = (e_53 = void 0, __values(relArray)), relArray_1_1 = relArray_1.next();
                         _x.label = 18;
                     case 18:
                         if (!!relArray_1_1.done) return [3 /*break*/, 23];
@@ -5121,28 +5391,28 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 18];
                     case 23: return [3 /*break*/, 26];
                     case 24:
-                        e_52_1 = _x.sent();
-                        e_52 = { error: e_52_1 };
+                        e_53_1 = _x.sent();
+                        e_53 = { error: e_53_1 };
                         return [3 /*break*/, 26];
                     case 25:
                         try {
                             if (relArray_1_1 && !relArray_1_1.done && (_q = relArray_1.return)) _q.call(relArray_1);
                         }
-                        finally { if (e_52) throw e_52.error; }
+                        finally { if (e_53) throw e_53.error; }
                         return [7 /*endfinally*/];
                     case 26:
                         _f = _e.next();
                         return [3 /*break*/, 15];
                     case 27: return [3 /*break*/, 30];
                     case 28:
-                        e_53_1 = _x.sent();
-                        e_53 = { error: e_53_1 };
+                        e_54_1 = _x.sent();
+                        e_54 = { error: e_54_1 };
                         return [3 /*break*/, 30];
                     case 29:
                         try {
                             if (_f && !_f.done && (_p = _e.return)) _p.call(_e);
                         }
-                        finally { if (e_53) throw e_53.error; }
+                        finally { if (e_54) throw e_54.error; }
                         return [7 /*endfinally*/];
                     case 30:
                         parts = {};
@@ -5159,8 +5429,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
     };
     XlsxPlugin.prototype.getConditionalFormatting = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var conditionalFormatting, _a, _b, element, _c, _d, _e, _f, e_54_1;
-            var e_54, _g;
+            var conditionalFormatting, _a, _b, element, _c, _d, _e, _f, e_55_1;
+            var e_55, _g;
             return __generator(this, function (_h) {
                 switch (_h.label) {
                     case 0:
@@ -5185,14 +5455,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 2];
                     case 5: return [3 /*break*/, 8];
                     case 6:
-                        e_54_1 = _h.sent();
-                        e_54 = { error: e_54_1 };
+                        e_55_1 = _h.sent();
+                        e_55 = { error: e_55_1 };
                         return [3 /*break*/, 8];
                     case 7:
                         try {
                             if (_b && !_b.done && (_g = _a.return)) _g.call(_a);
                         }
-                        finally { if (e_54) throw e_54.error; }
+                        finally { if (e_55) throw e_55.error; }
                         return [7 /*endfinally*/];
                     case 8: return [2 /*return*/, conditionalFormatting];
                 }
@@ -5232,8 +5502,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
     };
     XlsxPlugin.prototype.getDataValidations = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var dataValidations, _a, _b, element, _c, _d, _e, _f, e_55_1;
-            var e_55, _g;
+            var dataValidations, _a, _b, element, _c, _d, _e, _f, e_56_1;
+            var e_56, _g;
             return __generator(this, function (_h) {
                 switch (_h.label) {
                     case 0:
@@ -5258,14 +5528,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 2];
                     case 5: return [3 /*break*/, 8];
                     case 6:
-                        e_55_1 = _h.sent();
-                        e_55 = { error: e_55_1 };
+                        e_56_1 = _h.sent();
+                        e_56 = { error: e_56_1 };
                         return [3 /*break*/, 8];
                     case 7:
                         try {
                             if (_b && !_b.done && (_g = _a.return)) _g.call(_a);
                         }
-                        finally { if (e_55) throw e_55.error; }
+                        finally { if (e_56) throw e_56.error; }
                         return [7 /*endfinally*/];
                     case 8: return [2 /*return*/, dataValidations];
                 }
@@ -5305,6 +5575,19 @@ var XlsxPlugin = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Allow-edit ranges (`<protectedRanges>/<protectedRange>`) in the model the
+     * `protect-range` command writes: `protectedRangeId` = the source `name`,
+     * `range` = the first `sqref` area plus `sheetId`. Available after
+     * `getSheets()`; sheet-level `<sheetProtection>` rides `Sheet.sheetProtection`.
+     */
+    XlsxPlugin.prototype.getProtectedRanges = function (sheetId) {
+        var _a;
+        if (sheetId !== undefined) {
+            return (_a = this.protectedRangesBySheet.get(sheetId)) !== null && _a !== void 0 ? _a : [];
+        }
+        return Array.from(this.protectedRangesBySheet.values()).flat();
+    };
     XlsxPlugin.prototype.getNamedRanges = function () {
         return this.namedRanges;
     };
@@ -5317,7 +5600,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
     XlsxPlugin.prototype.getProperties = function () {
         return __awaiter(this, void 0, void 0, function () {
             var props, tryRead, coreXml, parsed, root, textOf_1, appXml, parsed, root, textOf, _a, _b, key;
-            var e_56, _c;
+            var e_57, _c;
             var _this = this;
             var _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
             return __generator(this, function (_r) {
@@ -5401,12 +5684,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 }
                             }
                         }
-                        catch (e_56_1) { e_56 = { error: e_56_1 }; }
+                        catch (e_57_1) { e_57 = { error: e_57_1 }; }
                         finally {
                             try {
                                 if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
                             }
-                            finally { if (e_56) throw e_56.error; }
+                            finally { if (e_57) throw e_57.error; }
                         }
                         return [2 /*return*/, Object.keys(props).length ? props : undefined];
                 }
@@ -5422,8 +5705,8 @@ var XlsxPlugin = /** @class */ (function (_super) {
     };
     XlsxPlugin.prototype.getSlicersForWorkbook = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var slicers, workbookRelsPath, workbookRelsContent, workbookRels, relationships, relationshipsArray, slicerRels, slicerCacheRels, toArray_1, slicerPathToSheetIds_2, addSlicerPath, slicerRels_1, slicerRels_1_1, slicerRel, target, workSheets, sheetRelContext, workSheets_7, workSheets_7_1, sheet, rid, currentSheetId, relation, sheetPath, sheetRelPath, sheetRelContent, sheetRels, sheetRelations, sheetRelationsArray, drawingRel, drawingPath, sheetSlicerRels, sheetSlicerRels_1, sheetSlicerRels_1_1, rel, target, _a, e_57_1, slicerCacheMap, slicerCacheRels_1, slicerCacheRels_1_1, cacheRel, cachePath, cacheContent, cacheXml, cacheDefinition, cacheName, title, extList, extArray, extArray_2, extArray_2_1, ext, tableSlicerCache, tableIdRaw, tableId, columnIndex, err_6, e_58_1, slicerPathToSheetIds_1, slicerPathToSheetIds_1_1, _b, slicerPath, linkedSheetIds, slicerContent, slicerXml, slicerDefinitionNode, slicerDefinition, slicerAttrs, cacheName, caption, cacheInfo, position, sheetId, workSheets_8, workSheets_8_1, sheet, currentSheetId, context, drawingContent, drawingXml, wsDr, anchors, firstSlicerAnchor, anchors_2, anchors_2_1, anchor, alternateContent, choices, graphicFrames, graphicFrames_1, graphicFrames_1_1, graphicFrame, graphicData, uri, isSlicerGraphic, nvGraphicFramePr, cNvPr, shapeName, e_59_1, slicer, err_7, e_60_1, err_8;
-            var e_61, _c, e_57, _d, e_62, _e, e_58, _f, e_63, _g, e_60, _h, e_59, _j, e_64, _k, e_65, _l;
+            var slicers, workbookRelsPath, workbookRelsContent, workbookRels, relationships, relationshipsArray, slicerRels, slicerCacheRels, toArray_1, slicerPathToSheetIds_2, addSlicerPath, slicerRels_1, slicerRels_1_1, slicerRel, target, workSheets, sheetRelContext, workSheets_7, workSheets_7_1, sheet, rid, currentSheetId, relation, sheetPath, sheetRelPath, sheetRelContent, sheetRels, sheetRelations, sheetRelationsArray, drawingRel, drawingPath, sheetSlicerRels, sheetSlicerRels_1, sheetSlicerRels_1_1, rel, target, _a, e_58_1, slicerCacheMap, slicerCacheRels_1, slicerCacheRels_1_1, cacheRel, cachePath, cacheContent, cacheXml, cacheDefinition, cacheName, title, extList, extArray, extArray_2, extArray_2_1, ext, tableSlicerCache, tableIdRaw, tableId, columnIndex, err_6, e_59_1, slicerPathToSheetIds_1, slicerPathToSheetIds_1_1, _b, slicerPath, linkedSheetIds, slicerContent, slicerXml, slicerDefinitionNode, slicerDefinition, slicerAttrs, cacheName, caption, cacheInfo, position, sheetId, workSheets_8, workSheets_8_1, sheet, currentSheetId, context, drawingContent, drawingXml, wsDr, anchors, firstSlicerAnchor, anchors_2, anchors_2_1, anchor, alternateContent, choices, graphicFrames, graphicFrames_1, graphicFrames_1_1, graphicFrame, graphicData, uri, isSlicerGraphic, nvGraphicFramePr, cNvPr, shapeName, e_60_1, slicer, err_7, e_61_1, err_8;
+            var e_62, _c, e_58, _d, e_63, _e, e_59, _f, e_64, _g, e_61, _h, e_60, _j, e_65, _k, e_66, _l;
             var _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
             return __generator(this, function (_0) {
                 switch (_0.label) {
@@ -5472,12 +5755,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 addSlicerPath(this.resolveSheetPath(target));
                             }
                         }
-                        catch (e_61_1) { e_61 = { error: e_61_1 }; }
+                        catch (e_62_1) { e_62 = { error: e_62_1 }; }
                         finally {
                             try {
                                 if (slicerRels_1_1 && !slicerRels_1_1.done && (_c = slicerRels_1.return)) _c.call(slicerRels_1);
                             }
-                            finally { if (e_61) throw e_61.error; }
+                            finally { if (e_62) throw e_62.error; }
                         }
                         workSheets = this._getSheets();
                         sheetRelContext = new Map();
@@ -5524,7 +5807,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 "http://schemas.microsoft.com/office/2007/relationships/slicer";
                         });
                         try {
-                            for (sheetSlicerRels_1 = (e_62 = void 0, __values(sheetSlicerRels)), sheetSlicerRels_1_1 = sheetSlicerRels_1.next(); !sheetSlicerRels_1_1.done; sheetSlicerRels_1_1 = sheetSlicerRels_1.next()) {
+                            for (sheetSlicerRels_1 = (e_63 = void 0, __values(sheetSlicerRels)), sheetSlicerRels_1_1 = sheetSlicerRels_1.next(); !sheetSlicerRels_1_1.done; sheetSlicerRels_1_1 = sheetSlicerRels_1.next()) {
                                 rel = sheetSlicerRels_1_1.value;
                                 target = (_r = rel === null || rel === void 0 ? void 0 : rel.a$) === null || _r === void 0 ? void 0 : _r.Target;
                                 if (!target)
@@ -5532,12 +5815,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 addSlicerPath(this.resolveRelationshipTarget(sheetRelPath, target), currentSheetId);
                             }
                         }
-                        catch (e_62_1) { e_62 = { error: e_62_1 }; }
+                        catch (e_63_1) { e_63 = { error: e_63_1 }; }
                         finally {
                             try {
                                 if (sheetSlicerRels_1_1 && !sheetSlicerRels_1_1.done && (_e = sheetSlicerRels_1.return)) _e.call(sheetSlicerRels_1);
                             }
-                            finally { if (e_62) throw e_62.error; }
+                            finally { if (e_63) throw e_63.error; }
                         }
                         return [3 /*break*/, 8];
                     case 7:
@@ -5549,14 +5832,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 4];
                     case 9: return [3 /*break*/, 12];
                     case 10:
-                        e_57_1 = _0.sent();
-                        e_57 = { error: e_57_1 };
+                        e_58_1 = _0.sent();
+                        e_58 = { error: e_58_1 };
                         return [3 /*break*/, 12];
                     case 11:
                         try {
                             if (workSheets_7_1 && !workSheets_7_1.done && (_d = workSheets_7.return)) _d.call(workSheets_7);
                         }
-                        finally { if (e_57) throw e_57.error; }
+                        finally { if (e_58) throw e_58.error; }
                         return [7 /*endfinally*/];
                     case 12:
                         if (slicerPathToSheetIds_2.size === 0) {
@@ -5602,7 +5885,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         ]);
                         extArray = toArray_1(extList);
                         try {
-                            for (extArray_2 = (e_63 = void 0, __values(extArray)), extArray_2_1 = extArray_2.next(); !extArray_2_1.done; extArray_2_1 = extArray_2.next()) {
+                            for (extArray_2 = (e_64 = void 0, __values(extArray)), extArray_2_1 = extArray_2.next(); !extArray_2_1.done; extArray_2_1 = extArray_2.next()) {
                                 ext = extArray_2_1.value;
                                 tableSlicerCache = getWithFallback(ext, [
                                     "x15:tableSlicerCache",
@@ -5620,12 +5903,12 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 }
                             }
                         }
-                        catch (e_63_1) { e_63 = { error: e_63_1 }; }
+                        catch (e_64_1) { e_64 = { error: e_64_1 }; }
                         finally {
                             try {
                                 if (extArray_2_1 && !extArray_2_1.done && (_g = extArray_2.return)) _g.call(extArray_2);
                             }
-                            finally { if (e_63) throw e_63.error; }
+                            finally { if (e_64) throw e_64.error; }
                         }
                         return [3 /*break*/, 18];
                     case 17:
@@ -5637,14 +5920,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 14];
                     case 19: return [3 /*break*/, 22];
                     case 20:
-                        e_58_1 = _0.sent();
-                        e_58 = { error: e_58_1 };
+                        e_59_1 = _0.sent();
+                        e_59 = { error: e_59_1 };
                         return [3 /*break*/, 22];
                     case 21:
                         try {
                             if (slicerCacheRels_1_1 && !slicerCacheRels_1_1.done && (_f = slicerCacheRels_1.return)) _f.call(slicerCacheRels_1);
                         }
-                        finally { if (e_58) throw e_58.error; }
+                        finally { if (e_59) throw e_59.error; }
                         return [7 /*endfinally*/];
                     case 22:
                         _0.trys.push([22, 38, 39, 40]);
@@ -5687,7 +5970,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         _0.label = 26;
                     case 26:
                         _0.trys.push([26, 32, 33, 34]);
-                        workSheets_8 = (e_59 = void 0, __values(workSheets)), workSheets_8_1 = workSheets_8.next();
+                        workSheets_8 = (e_60 = void 0, __values(workSheets)), workSheets_8_1 = workSheets_8.next();
                         _0.label = 27;
                     case 27:
                         if (!!workSheets_8_1.done) return [3 /*break*/, 31];
@@ -5713,7 +5996,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                 anchors = __spreadArray(__spreadArray([], __read(toArray_1(wsDr["xdr:oneCellAnchor"] || wsDr["oneCellAnchor"])), false), __read(toArray_1(wsDr["xdr:twoCellAnchor"] || wsDr["twoCellAnchor"])), false);
                                 firstSlicerAnchor = null;
                                 try {
-                                    for (anchors_2 = (e_64 = void 0, __values(anchors)), anchors_2_1 = anchors_2.next(); !anchors_2_1.done; anchors_2_1 = anchors_2.next()) {
+                                    for (anchors_2 = (e_65 = void 0, __values(anchors)), anchors_2_1 = anchors_2.next(); !anchors_2_1.done; anchors_2_1 = anchors_2.next()) {
                                         anchor = anchors_2_1.value;
                                         alternateContent = getWithFallback(anchor, [
                                             "mc:AlternateContent",
@@ -5730,7 +6013,7 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                             ]));
                                         })), false);
                                         try {
-                                            for (graphicFrames_1 = (e_65 = void 0, __values(graphicFrames)), graphicFrames_1_1 = graphicFrames_1.next(); !graphicFrames_1_1.done; graphicFrames_1_1 = graphicFrames_1.next()) {
+                                            for (graphicFrames_1 = (e_66 = void 0, __values(graphicFrames)), graphicFrames_1_1 = graphicFrames_1.next(); !graphicFrames_1_1.done; graphicFrames_1_1 = graphicFrames_1.next()) {
                                                 graphicFrame = graphicFrames_1_1.value;
                                                 graphicData = getWithFallback(graphicFrame, [
                                                     "a:graphic.a:graphicData",
@@ -5763,23 +6046,23 @@ var XlsxPlugin = /** @class */ (function (_super) {
                                                 }
                                             }
                                         }
-                                        catch (e_65_1) { e_65 = { error: e_65_1 }; }
+                                        catch (e_66_1) { e_66 = { error: e_66_1 }; }
                                         finally {
                                             try {
                                                 if (graphicFrames_1_1 && !graphicFrames_1_1.done && (_l = graphicFrames_1.return)) _l.call(graphicFrames_1);
                                             }
-                                            finally { if (e_65) throw e_65.error; }
+                                            finally { if (e_66) throw e_66.error; }
                                         }
                                         if (position)
                                             break;
                                     }
                                 }
-                                catch (e_64_1) { e_64 = { error: e_64_1 }; }
+                                catch (e_65_1) { e_65 = { error: e_65_1 }; }
                                 finally {
                                     try {
                                         if (anchors_2_1 && !anchors_2_1.done && (_k = anchors_2.return)) _k.call(anchors_2);
                                     }
-                                    finally { if (e_64) throw e_64.error; }
+                                    finally { if (e_65) throw e_65.error; }
                                 }
                                 if (!position && firstSlicerAnchor) {
                                     position = this.extractSlicerPosition(firstSlicerAnchor, currentSheetId);
@@ -5793,14 +6076,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 27];
                     case 31: return [3 /*break*/, 34];
                     case 32:
-                        e_59_1 = _0.sent();
-                        e_59 = { error: e_59_1 };
+                        e_60_1 = _0.sent();
+                        e_60 = { error: e_60_1 };
                         return [3 /*break*/, 34];
                     case 33:
                         try {
                             if (workSheets_8_1 && !workSheets_8_1.done && (_j = workSheets_8.return)) _j.call(workSheets_8);
                         }
-                        finally { if (e_59) throw e_59.error; }
+                        finally { if (e_60) throw e_60.error; }
                         return [7 /*endfinally*/];
                     case 34:
                         // Create default position if we couldn't find one
@@ -5842,14 +6125,14 @@ var XlsxPlugin = /** @class */ (function (_super) {
                         return [3 /*break*/, 23];
                     case 37: return [3 /*break*/, 40];
                     case 38:
-                        e_60_1 = _0.sent();
-                        e_60 = { error: e_60_1 };
+                        e_61_1 = _0.sent();
+                        e_61 = { error: e_61_1 };
                         return [3 /*break*/, 40];
                     case 39:
                         try {
                             if (slicerPathToSheetIds_1_1 && !slicerPathToSheetIds_1_1.done && (_h = slicerPathToSheetIds_1.return)) _h.call(slicerPathToSheetIds_1);
                         }
-                        finally { if (e_60) throw e_60.error; }
+                        finally { if (e_61) throw e_61.error; }
                         return [7 /*endfinally*/];
                     case 40: return [3 /*break*/, 42];
                     case 41:
@@ -6054,3 +6337,200 @@ var XlsxPlugin = /** @class */ (function (_super) {
     return XlsxPlugin;
 }(BaseWorkbookPlugin));
 export { XlsxPlugin };
+/** `CT_SheetProtection` boolean attributes, in OOXML order (camelCase = model key). */
+var SHEET_PROTECTION_FLAGS = [
+    "sheet",
+    "objects",
+    "scenarios",
+    "formatCells",
+    "formatColumns",
+    "formatRows",
+    "insertColumns",
+    "insertRows",
+    "insertHyperlinks",
+    "deleteColumns",
+    "deleteRows",
+    "selectLockedCells",
+    "sort",
+    "autoFilter",
+    "pivotTables",
+    "selectUnlockedCells",
+];
+/**
+ * `<sheetProtection …>` attributes → `Sheet.sheetProtection`. Only attributes
+ * present in the source are set (`"1"|"true"` → true, anything else → false),
+ * so an explicit flag round-trips without inventing schema defaults; the
+ * password hash (legacy `password` or the agile quartet) rides along verbatim.
+ * Mirrors `rnc-import`'s `read_sheet_protection`.
+ */
+var readSheetProtectionAttrs = function (attrs) {
+    var e_67, _a;
+    var protection = {};
+    try {
+        for (var SHEET_PROTECTION_FLAGS_1 = __values(SHEET_PROTECTION_FLAGS), SHEET_PROTECTION_FLAGS_1_1 = SHEET_PROTECTION_FLAGS_1.next(); !SHEET_PROTECTION_FLAGS_1_1.done; SHEET_PROTECTION_FLAGS_1_1 = SHEET_PROTECTION_FLAGS_1.next()) {
+            var flag = SHEET_PROTECTION_FLAGS_1_1.value;
+            var value = attrs[flag];
+            if (value !== undefined) {
+                protection[flag] = value === "1" || value === "true";
+            }
+        }
+    }
+    catch (e_67_1) { e_67 = { error: e_67_1 }; }
+    finally {
+        try {
+            if (SHEET_PROTECTION_FLAGS_1_1 && !SHEET_PROTECTION_FLAGS_1_1.done && (_a = SHEET_PROTECTION_FLAGS_1.return)) _a.call(SHEET_PROTECTION_FLAGS_1);
+        }
+        finally { if (e_67) throw e_67.error; }
+    }
+    if (attrs.password)
+        protection.password = attrs.password;
+    if (attrs.algorithmName)
+        protection.algorithmName = attrs.algorithmName;
+    if (attrs.hashValue)
+        protection.hashValue = attrs.hashValue;
+    if (attrs.saltValue)
+        protection.saltValue = attrs.saltValue;
+    if (attrs.spinCount !== undefined) {
+        var spinCount = parseInt(attrs.spinCount, 10);
+        if (Number.isFinite(spinCount))
+            protection.spinCount = spinCount;
+    }
+    return protection;
+};
+/**
+ * `<protectedRange sqref name>` entries → `ProtectedRange[]` for one sheet. The
+ * `name` becomes the `protectedRangeId` so it keys the stored facet and
+ * re-exports under the same name; only the first `sqref` area is modeled
+ * (Excel writes one per element in practice).
+ */
+var protectedRangesFromEntries = function (sheetId, entries) {
+    var e_68, _a;
+    var ranges = [];
+    try {
+        for (var entries_1 = __values(entries), entries_1_1 = entries_1.next(); !entries_1_1.done; entries_1_1 = entries_1.next()) {
+            var entry = entries_1_1.value;
+            var first = entry.sqref.trim().split(/\s+/)[0];
+            var range = first ? getRangeFromAddressRef(first) : undefined;
+            if (!range)
+                continue;
+            var protectedRange = {
+                range: __assign({ sheetId: sheetId }, range),
+            };
+            if (entry.name)
+                protectedRange.protectedRangeId = entry.name;
+            if (entry.securityDescriptor) {
+                protectedRange.securityDescriptor = entry.securityDescriptor;
+            }
+            ranges.push(protectedRange);
+        }
+    }
+    catch (e_68_1) { e_68 = { error: e_68_1 }; }
+    finally {
+        try {
+            if (entries_1_1 && !entries_1_1.done && (_a = entries_1.return)) _a.call(entries_1);
+        }
+        finally { if (e_68) throw e_68.error; }
+    }
+    return ranges;
+};
+var isXmlTrue = function (value) {
+    return value === "1" || value === "true";
+};
+/** `"1"|"true"|"0"|"false"` → boolean; absent stays undefined. */
+var xmlBoolOpt = function (value) {
+    return value === undefined ? undefined : isXmlTrue(value);
+};
+var xmlIntOpt = function (value) {
+    if (value === undefined)
+        return undefined;
+    var n = parseInt(value, 10);
+    return Number.isFinite(n) ? n : undefined;
+};
+var xmlFloatOpt = function (value) {
+    if (value === undefined)
+        return undefined;
+    var n = parseFloat(value);
+    return Number.isFinite(n) ? n : undefined;
+};
+var stripUndefined = function (value) {
+    var e_69, _a;
+    try {
+        for (var _b = __values(Object.keys(value)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var key = _c.value;
+            if (value[key] === undefined)
+                delete value[key];
+        }
+    }
+    catch (e_69_1) { e_69 = { error: e_69_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_69) throw e_69.error; }
+    }
+    return value;
+};
+/** `<headerFooter>` children whose text is a header/footer code string. */
+var HEADER_FOOTER_TEXT_ELEMENTS = [
+    "oddHeader",
+    "oddFooter",
+    "evenHeader",
+    "evenFooter",
+    "firstHeader",
+    "firstFooter",
+];
+var isHeaderFooterTextKey = function (name) {
+    return HEADER_FOOTER_TEXT_ELEMENTS.includes(name);
+};
+/**
+ * `<pageSetup …>` → `PageSetup` (present attributes only; `fitToPage` is
+ * filled from `<sheetPr><pageSetUpPr>` by the caller). Mirrors
+ * `rnc-import`'s `read_page_setup`.
+ */
+var readPageSetupAttrs = function (attrs) {
+    var orientation = attrs.orientation;
+    var pageOrder = attrs.pageOrder;
+    return stripUndefined({
+        orientation: orientation === "landscape" || orientation === "portrait"
+            ? orientation
+            : undefined,
+        paperSize: xmlIntOpt(attrs.paperSize),
+        scale: xmlIntOpt(attrs.scale),
+        fitToWidth: xmlIntOpt(attrs.fitToWidth),
+        fitToHeight: xmlIntOpt(attrs.fitToHeight),
+        firstPageNumber: xmlIntOpt(attrs.firstPageNumber),
+        useFirstPageNumber: xmlBoolOpt(attrs.useFirstPageNumber),
+        pageOrder: pageOrder === "overThenDown" || pageOrder === "downThenOver"
+            ? pageOrder
+            : undefined,
+        blackAndWhite: xmlBoolOpt(attrs.blackAndWhite),
+        draft: xmlBoolOpt(attrs.draft),
+    });
+};
+var readPageMarginsAttrs = function (attrs) {
+    return stripUndefined({
+        left: xmlFloatOpt(attrs.left),
+        right: xmlFloatOpt(attrs.right),
+        top: xmlFloatOpt(attrs.top),
+        bottom: xmlFloatOpt(attrs.bottom),
+        header: xmlFloatOpt(attrs.header),
+        footer: xmlFloatOpt(attrs.footer),
+    });
+};
+var readPrintOptionsAttrs = function (attrs) {
+    return stripUndefined({
+        gridLines: xmlBoolOpt(attrs.gridLines),
+        headings: xmlBoolOpt(attrs.headings),
+        horizontalCentered: xmlBoolOpt(attrs.horizontalCentered),
+        verticalCentered: xmlBoolOpt(attrs.verticalCentered),
+    });
+};
+/** `<headerFooter …>` attributes; the child texts stream in via `ontext`. */
+var readHeaderFooterAttrs = function (attrs) {
+    return stripUndefined({
+        differentOddEven: xmlBoolOpt(attrs.differentOddEven),
+        differentFirst: xmlBoolOpt(attrs.differentFirst),
+        scaleWithDoc: xmlBoolOpt(attrs.scaleWithDoc),
+        alignWithMargins: xmlBoolOpt(attrs.alignWithMargins),
+    });
+};