@rowsncolumns/toolkit 24.4.4 → 24.5.0

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

@@ -1,7 +1,9 @@
-import { __assign, __awaiter, __generator, __values } from "tslib";
+import { __assign, __awaiter, __generator, __read, __spreadArray, __values } from "tslib";
 import { generateSelectionsFromFormula } from "@rowsncolumns/utils";
 import { uuid } from "@rowsncolumns/utils";
+import { XMLParser } from "fast-xml-parser";
 import { get } from "lodash-es";
+import { anchorPlacementFromEditAs } from "./drawing";
 /**
  * Pick the data sheetId for a parsed selection. Honours the explicit
  * sheet prefix in the chart's formula reference (cross-sheet charts);
@@ -50,12 +52,13 @@ function toInt(value) {
 }
 export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParser, xmlParser, sheetDimensions, resolveSheetId) {
     return __awaiter(this, void 0, void 0, function () {
-        var chartPath, drawingDir, chartContent, chartXml, chart, chartSpaceRoot, roundedCornersRaw, roundedCornersVal, roundedCorners, chartId, title, titleTextFormat, chartType, plotArea, series, domains, dataRange, bubbleSizes, scatterStyle, hiddenDimensionStrategy, position, legend, dataLabels, _a, valueAxisOptions, secondaryValueAxisOptions, categoryAxisOptions, doughnutHoleSize, ofPieOptions, threeDSourceChartType, radarStyle, binCount, barLayout, err_1;
-        var _b;
-        return __generator(this, function (_c) {
-            switch (_c.label) {
+        var chartPath, drawingDir, chartContent, chartXml, chart, chartSpaceRoot, roundedCornersRaw, roundedCornersVal, roundedCorners, chartStyle, pivotSourceName, pivotSourceFormatId, pivotFormats, pivotFieldButtons, chartSpacePr, chartAreaFill, chartAreaBorder, chartId, title, titleTextFormat, chartType, plotArea, series, domains, dataRange, bubbleSizes, scatterStyle, hiddenDimensionStrategy, emptyCells, showNaAsEmpty, position, legend, dataLabels, _a, valueAxisOptions, secondaryValueAxisOptions, categoryAxisOptions, doughnutHoleSize, explosion, ofPieOptions, threeDSourceChartType, radarStyle, binCount, barLayout, lineLayout, stockVariant, err_1;
+        var _b, _c;
+        var _d, _e, _f, _g;
+        return __generator(this, function (_h) {
+            switch (_h.label) {
                 case 0:
-                    _c.trys.push([0, 2, , 3]);
+                    _h.trys.push([0, 2, , 3]);
                     chartPath = chartTarget;
                     drawingDir = drawingPath.substring(0, drawingPath.lastIndexOf("/"));
                     if (chartPath.startsWith("../")) {
@@ -66,7 +69,7 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                     }
                     return [4 /*yield*/, zipParser.getText(chartPath)];
                 case 1:
-                    chartContent = _c.sent();
+                    chartContent = _h.sent();
                     if (!chartContent) {
                         return [2 /*return*/, null];
                     }
@@ -90,12 +93,22 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                         "c:roundedCorners",
                         "roundedCorners",
                     ]);
-                    roundedCornersVal = (_b = roundedCornersRaw === null || roundedCornersRaw === void 0 ? void 0 : roundedCornersRaw.a$) === null || _b === void 0 ? void 0 : _b.val;
+                    roundedCornersVal = (_d = roundedCornersRaw === null || roundedCornersRaw === void 0 ? void 0 : roundedCornersRaw.a$) === null || _d === void 0 ? void 0 : _d.val;
                     roundedCorners = roundedCornersVal === "1" ||
                         roundedCornersVal === "true" ||
                         roundedCornersVal === true
                         ? true
                         : undefined;
+                    chartStyle = extractChartStyle(chartSpaceRoot);
+                    pivotSourceName = extractPivotSourceName(chartSpaceRoot);
+                    pivotSourceFormatId = extractPivotSourceFormatId(chartSpaceRoot);
+                    pivotFormats = extractPivotFormats(chart);
+                    if (pivotFormats)
+                        attachPivotFormatBodies(pivotFormats, chartContent);
+                    pivotFieldButtons = extractPivotFieldButtons(chartSpaceRoot);
+                    chartSpacePr = (_e = get(chartSpaceRoot, "c:spPr")) !== null && _e !== void 0 ? _e : get(chartSpaceRoot, "spPr");
+                    chartAreaFill = extractSrgbHex((_f = get(chartSpacePr, "a:solidFill")) !== null && _f !== void 0 ? _f : get(chartSpacePr, "solidFill"));
+                    chartAreaBorder = extractSrgbHex((_g = get(chartSpacePr, "a:ln.a:solidFill")) !== null && _g !== void 0 ? _g : get(chartSpacePr, "ln.solidFill"));
                     chartId = uuid();
                     title = extractChartTitle(chart);
                     titleTextFormat = extractChartTitleTextFormat(chart);
@@ -109,6 +122,8 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                         : undefined;
                     scatterStyle = chartType === "scatter" ? extractScatterStyle(plotArea) : undefined;
                     hiddenDimensionStrategy = extractHiddenDimensionStrategy(chart);
+                    emptyCells = extractEmptyCellsPolicy(chart);
+                    showNaAsEmpty = extractShowNaAsEmpty(chart);
                     position = extractChartPosition(anchor, sheetId, sheetDimensions);
                     if (!position) {
                         console.log("Could not extract chart position");
@@ -118,6 +133,9 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                     dataLabels = extractDataLabelsOptions(plotArea, chartType);
                     _a = extractAxisOptions(plotArea), valueAxisOptions = _a.valueAxisOptions, secondaryValueAxisOptions = _a.secondaryValueAxisOptions, categoryAxisOptions = _a.categoryAxisOptions;
                     doughnutHoleSize = chartType === "doughnut" ? extractDoughnutHoleSize(plotArea) : undefined;
+                    explosion = chartType === "pie" || chartType === "doughnut"
+                        ? extractExplosion(plotArea, chartType)
+                        : undefined;
                     ofPieOptions = chartType === "pie" ? extractOfPieOptions(plotArea) : undefined;
                     threeDSourceChartType = extractThreeDSourceChartType(plotArea);
                     radarStyle = chartType === "radar" ? extractRadarStyle(plotArea) : undefined;
@@ -127,9 +145,9 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                     barLayout = chartType === "bar" || chartType === "column"
                         ? extractBarLayoutOptions(plotArea)
                         : undefined;
-                    return [2 /*return*/, {
-                            chartId: chartId,
-                            spec: __assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({ title: title }, (titleTextFormat ? { titleTextFormat: titleTextFormat } : {})), { chartType: chartType, domains: domains, series: series, dataRange: dataRange, hiddenDimensionStrategy: hiddenDimensionStrategy }), (chartType === "scatter" || chartType === "bubble"
+                    lineLayout = chartType === "line" ? extractLineChartOptions(plotArea, series) : undefined;
+                    stockVariant = chartType === "stock" ? extractStockVariant(plotArea) : undefined;
+                    return [2 /*return*/, __assign(__assign({ chartId: chartId, spec: __assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({ title: title }, (titleTextFormat ? { titleTextFormat: titleTextFormat } : {})), { chartType: chartType, domains: domains, series: series, dataRange: dataRange, hiddenDimensionStrategy: hiddenDimensionStrategy }), (emptyCells && emptyCells !== "gaps" ? { emptyCells: emptyCells } : {})), (showNaAsEmpty === false ? { showNaAsEmpty: showNaAsEmpty } : {})), (chartType === "scatter" || chartType === "bubble"
                                 ? { bubbleLabels: [] }
                                 : {})), (bubbleSizes && bubbleSizes.length ? { bubbleSizes: bubbleSizes } : {})), (scatterStyle
                                 ? { scatterStyle: scatterStyle }
@@ -137,7 +155,7 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                                 ? { secondaryValueAxisOptions: secondaryValueAxisOptions }
                                 : {})), (categoryAxisOptions ? { categoryAxisOptions: categoryAxisOptions } : {})), (typeof doughnutHoleSize === "number"
                                 ? { doughnutHoleSize: doughnutHoleSize }
-                                : {})), (ofPieOptions
+                                : {})), (typeof explosion === "number" ? { explosion: explosion } : {})), (ofPieOptions
                                 ? __assign({ sourceChartType: "OF_PIE" }, ofPieOptions) : {})), (threeDSourceChartType && !ofPieOptions
                                 ? { sourceChartType: threeDSourceChartType }
                                 : {})), (radarStyle ? { radarStyle: radarStyle } : {})), (typeof binCount === "number" ? { binCount: binCount } : {})), ((barLayout === null || barLayout === void 0 ? void 0 : barLayout.stackedType)
@@ -146,13 +164,12 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                                 ? { overlap: barLayout.overlap }
                                 : {})), (typeof (barLayout === null || barLayout === void 0 ? void 0 : barLayout.gapWidth) === "number"
                                 ? { gapWidth: barLayout.gapWidth }
-                                : {})), (roundedCorners ? { roundedCorners: roundedCorners } : {})),
-                            position: position,
-                            id: chartId,
-                            type: "chart",
-                        }];
+                                : {})), ((lineLayout === null || lineLayout === void 0 ? void 0 : lineLayout.stackedType)
+                                ? { stackedType: lineLayout.stackedType }
+                                : {})), ((lineLayout === null || lineLayout === void 0 ? void 0 : lineLayout.showMarkers) ? { showMarkers: true } : {})), (stockVariant ? { stockVariant: stockVariant } : {})), (roundedCorners ? { roundedCorners: roundedCorners } : {})), (chartStyle !== undefined ? { chartStyle: chartStyle } : {})), (chartAreaFill ? { backgroundColor: chartAreaFill } : {})), (pivotSourceName ? (_b = {}, _b[PIVOT_SOURCE_NAME_KEY] = pivotSourceName, _b) : {})), (pivotSourceFormatId
+                                ? (_c = {}, _c[PIVOT_SOURCE_FORMAT_ID_KEY] = pivotSourceFormatId, _c) : {})), (pivotFormats ? { pivotFormats: pivotFormats } : {})), (pivotFieldButtons ? { pivotFieldButtons: pivotFieldButtons } : {})), position: position }, (chartAreaBorder ? { borderColor: chartAreaBorder } : {})), { id: chartId, type: "chart" })];
                 case 2:
-                    err_1 = _c.sent();
+                    err_1 = _h.sent();
                     console.log("Error processing chart:", err_1);
                     return [2 /*return*/, null];
                 case 3: return [2 /*return*/];
@@ -220,8 +237,19 @@ function getSeriesElements(plotArea, chartType) {
             ]);
         case "radar":
             return getWithFallback(plotArea, ["c:radarChart.c:ser", "radarChart.ser"]);
-        case "stock":
-            return getWithFallback(plotArea, ["c:stockChart.c:ser", "stockChart.ser"]);
+        case "stock": {
+            // VHLC / VOHLC: the volume series lives in a sibling <c:barChart>
+            // and comes first (utils/stock.ts STOCK_ROLES); the price series
+            // follow in the <c:stockChart>.
+            var toArray = function (value) {
+                return value === undefined || value === null
+                    ? []
+                    : Array.isArray(value)
+                        ? value
+                        : [value];
+            };
+            return __spreadArray(__spreadArray([], __read(toArray(getWithFallback(plotArea, ["c:barChart.c:ser", "barChart.ser"]))), false), __read(toArray(getWithFallback(plotArea, ["c:stockChart.c:ser", "stockChart.ser"]))), false);
+        }
         case "scatter":
             return getWithFallback(plotArea, [
                 "c:scatterChart.c:ser",
@@ -441,6 +469,62 @@ export function extractHiddenDimensionStrategy(chart) {
     var skipHidden = plotVisOnly === "1" || plotVisOnly === "true" || plotVisOnly === true;
     return skipHidden ? "SKIP_HIDDEN_ROWS_AND_COLUMNS" : "SHOW_ALL";
 }
+/**
+ * `<c:dispBlanksAs val="gap|zero|span"/>` — Excel's "Show empty cells as"
+ * (Select Data → Hidden and Empty Cells). `span` is "Connect data points
+ * with line".
+ */
+export function extractEmptyCellsPolicy(chart) {
+    var val = getWithFallback(chart, [
+        "c:dispBlanksAs.a$.val",
+        "dispBlanksAs.a$.val",
+    ]);
+    switch (val) {
+        case "gap":
+            return "gaps";
+        case "zero":
+            return "zero";
+        case "span":
+            return "connect";
+        default:
+            return undefined;
+    }
+}
+/**
+ * Excel 2016+ "Show #N/A as an empty cell":
+ * `<c:chart><c:extLst><c:ext uri="{56B9EC1D-…}"><c16r3:dataDisplayOptions16>
+ * <c16r3:dispNaAsBlank val="0|1"/>`. Undefined when the file predates the
+ * option (Excel then treats #N/A the legacy way — as if `val="0"`, but the
+ * spec leaves the default to the renderer).
+ */
+export function extractShowNaAsEmpty(chart) {
+    var e_4, _a;
+    var extLst = getWithFallback(chart, ["c:extLst", "extLst"]);
+    if (!extLst)
+        return undefined;
+    var extNode = getWithFallback(extLst, ["c:ext", "ext"]);
+    var exts = Array.isArray(extNode) ? extNode : extNode ? [extNode] : [];
+    try {
+        for (var exts_1 = __values(exts), exts_1_1 = exts_1.next(); !exts_1_1.done; exts_1_1 = exts_1.next()) {
+            var ext = exts_1_1.value;
+            var val = getWithFallback(ext, [
+                "c16r3:dataDisplayOptions16.c16r3:dispNaAsBlank.a$.val",
+                "dataDisplayOptions16.dispNaAsBlank.a$.val",
+            ]);
+            if (val !== undefined) {
+                return val === "1" || val === "true" || val === true;
+            }
+        }
+    }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    finally {
+        try {
+            if (exts_1_1 && !exts_1_1.done && (_a = exts_1.return)) _a.call(exts_1);
+        }
+        finally { if (e_4) throw e_4.error; }
+    }
+    return undefined;
+}
 /**
  * Read the chart title's text formatting. Excel chart titles can be
  * styled two ways:
@@ -452,6 +536,58 @@ export function extractHiddenDimensionStrategy(chart) {
  * the more explicit signal). Returns `undefined` when neither carries
  * formatting so the renderer falls back to its theme defaults.
  */
+/**
+ * `<c:chartSpace>` → the Chart Styles id, from `<c14:style>` in the
+ * mc:Choice (id + 100) or the plain `<c:style>`. Excel's unstyled default
+ * (2) is returned as `undefined` so it stays implicit on the spec.
+ */
+function extractChartStyle(chartSpaceRoot) {
+    var e_5, _a;
+    var alternates = [
+        getWithFallback(chartSpaceRoot, ["mc:AlternateContent", "AlternateContent"]),
+    ]
+        .flat()
+        .filter(Boolean);
+    var raw;
+    try {
+        for (var alternates_1 = __values(alternates), alternates_1_1 = alternates_1.next(); !alternates_1_1.done; alternates_1_1 = alternates_1.next()) {
+            var alternate = alternates_1_1.value;
+            var c14 = getWithFallback(alternate, [
+                "mc:Choice.c14:style.a$.val",
+                "Choice.c14:style.a$.val",
+                "Choice.style.a$.val",
+            ]);
+            if (c14 !== undefined) {
+                var value = Number(c14);
+                raw = value > 100 ? value - 100 : value;
+                break;
+            }
+        }
+    }
+    catch (e_5_1) { e_5 = { error: e_5_1 }; }
+    finally {
+        try {
+            if (alternates_1_1 && !alternates_1_1.done && (_a = alternates_1.return)) _a.call(alternates_1);
+        }
+        finally { if (e_5) throw e_5.error; }
+    }
+    if (raw === undefined) {
+        raw = getWithFallback(chartSpaceRoot, ["c:style.a$.val", "style.a$.val"]);
+    }
+    var style = Number(raw);
+    if (!Number.isInteger(style) || style < 1 || style > 48 || style === 2) {
+        return undefined;
+    }
+    return style;
+}
+/** `<a:solidFill><a:srgbClr val="RRGGBB"/>` → `#RRGGBB`; theme fills are ignored. */
+function extractSrgbHex(solidFill) {
+    var _a;
+    var raw = (_a = get(solidFill, "a:srgbClr.a$.val")) !== null && _a !== void 0 ? _a : get(solidFill, "srgbClr.a$.val");
+    return typeof raw === "string" && /^[0-9a-fA-F]{6}$/.test(raw)
+        ? "#".concat(raw.toUpperCase())
+        : undefined;
+}
 function extractChartTitleTextFormat(chart) {
     var _a, _b, _c;
     var title = (_a = get(chart, "c:title")) !== null && _a !== void 0 ? _a : get(chart, "title");
@@ -464,6 +600,416 @@ function extractChartTitleTextFormat(chart) {
     var txPr = (_c = get(title, "c:txPr")) !== null && _c !== void 0 ? _c : get(title, "txPr");
     return extractTextProperties(txPr);
 }
+/**
+ * Transient spec key carrying `<c:pivotSource><c:name>` until the workbook's
+ * pivots are known; `bindPivotChartsToPivotTables` turns it into
+ * `pivotTableId` and removes it.
+ */
+export var PIVOT_SOURCE_NAME_KEY = "__pivotSourceName";
+/**
+ * Transient spec key carrying `<c:pivotSource><c:fmtId>` alongside the
+ * name; becomes `pivotSource.formatId` once the chart binds to its pivot.
+ */
+export var PIVOT_SOURCE_FORMAT_ID_KEY = "__pivotSourceFormatId";
+/**
+ * `<c:pivotSource><c:fmtId val="3"/>` — the id the pivot's `<chartFormats>`
+ * name this chart by. `0` is the exporter's default and stays implicit.
+ */
+export function extractPivotSourceFormatId(chartSpaceRoot) {
+    var raw = getWithFallback(chartSpaceRoot, [
+        "c:pivotSource.c:fmtId.a$.val",
+        "pivotSource.fmtId.a$.val",
+    ]);
+    var id = toInt(raw);
+    return Number.isFinite(id) && id > 0 ? id : undefined;
+}
+/** `<c:pivotSource><c:name>[Book1.xlsx]Sheet1!PivotTable1</c:name>` → the name text. */
+export function extractPivotSourceName(chartSpaceRoot) {
+    var raw = getWithFallback(chartSpaceRoot, [
+        "c:pivotSource.c:name.t$",
+        "c:pivotSource.c:name",
+        "pivotSource.name.t$",
+        "pivotSource.name",
+    ]);
+    var name = typeof raw === "string" ? raw.trim() : undefined;
+    return name ? name : undefined;
+}
+/**
+ * Split a pivotSource name into its sheet and pivot-table parts. The
+ * `[workbook]` prefix is dropped (it names the file the chart lived in);
+ * the sheet may be quoted (`'My Sheet'!PivotTable1`).
+ */
+export function parsePivotSourceName(name) {
+    var withoutBook = name.replace(/^\[[^\]]*\]/, "");
+    var bang = withoutBook.lastIndexOf("!");
+    if (bang === -1) {
+        return withoutBook ? { pivotName: withoutBook } : undefined;
+    }
+    var pivotName = withoutBook.slice(bang + 1);
+    if (!pivotName)
+        return undefined;
+    var sheetTitle = withoutBook.slice(0, bang);
+    if (sheetTitle.startsWith("'") && sheetTitle.endsWith("'")) {
+        sheetTitle = sheetTitle.slice(1, -1).replace(/''/g, "'");
+    }
+    return { sheetTitle: sheetTitle || undefined, pivotName: pivotName };
+}
+/**
+ * Resolve every imported chart's `<c:pivotSource>` name to the id of the
+ * imported PivotTable it names (matched by pivot name, and by the pivot's
+ * target sheet when the name carries one). A name that matches no pivot
+ * leaves a plain chart — Excel converts a PivotChart whose pivot is gone
+ * to a static chart too. The transient key is always removed.
+ */
+export function bindPivotChartsToPivotTables(charts, pivotTables, sheetTitleById) {
+    var e_6, _a;
+    var _b;
+    var _loop_1 = function (chart) {
+        var spec = chart.spec;
+        var raw = spec[PIVOT_SOURCE_NAME_KEY];
+        var formatId = spec[PIVOT_SOURCE_FORMAT_ID_KEY];
+        delete spec[PIVOT_SOURCE_FORMAT_ID_KEY];
+        if (raw === undefined)
+            return "continue";
+        delete spec[PIVOT_SOURCE_NAME_KEY];
+        var parsed = typeof raw === "string" ? parsePivotSourceName(raw) : undefined;
+        if (!parsed)
+            return "continue";
+        var byName = pivotTables.filter(function (pivot) { var _a; return ((_a = pivot.name) !== null && _a !== void 0 ? _a : "PivotTable".concat(pivot.pivotId)) === parsed.pivotName; });
+        var match = (_b = byName.find(function (pivot) {
+            var _a;
+            return parsed.sheetTitle === undefined ||
+                sheetTitleById.get((_a = pivot.targetPosition) === null || _a === void 0 ? void 0 : _a.sheetId) === parsed.sheetTitle;
+        })) !== null && _b !== void 0 ? _b : (parsed.sheetTitle === undefined ? byName[0] : undefined);
+        if (!match)
+            return "continue";
+        spec.pivotTableId = match.pivotId;
+        if (!spec.pivotSource) {
+            spec.pivotSource = { categoryAxis: "rows" };
+        }
+        if (typeof formatId === "number") {
+            spec.pivotSource.formatId = formatId;
+        }
+    };
+    try {
+        for (var charts_1 = __values(charts), charts_1_1 = charts_1.next(); !charts_1_1.done; charts_1_1 = charts_1.next()) {
+            var chart = charts_1_1.value;
+            _loop_1(chart);
+        }
+    }
+    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    finally {
+        try {
+            if (charts_1_1 && !charts_1_1.done && (_a = charts_1.return)) _a.call(charts_1);
+        }
+        finally { if (e_6) throw e_6.error; }
+    }
+}
+/**
+ * `<c:chart><c:pivotFmts><c:pivotFmt><c:idx val/>…` — the per pivot-item
+ * formats Excel re-applies on a re-plot; only the index and a literal
+ * fill colour are kept.
+ */
+export function extractPivotFormats(chart) {
+    var e_7, _a;
+    var raw = getWithFallback(chart, ["c:pivotFmts.c:pivotFmt", "pivotFmts.pivotFmt"]);
+    if (raw === undefined)
+        return undefined;
+    var list = Array.isArray(raw) ? raw : [raw];
+    var formats = [];
+    try {
+        for (var list_1 = __values(list), list_1_1 = list_1.next(); !list_1_1.done; list_1_1 = list_1.next()) {
+            var fmt = list_1_1.value;
+            var idx = toInt(getWithFallback(fmt, ["c:idx.a$.val", "idx.a$.val"]));
+            var fill = getWithFallback(fmt, [
+                "c:spPr.a:solidFill.a:srgbClr.a$.val",
+                "spPr.solidFill.srgbClr.a$.val",
+            ]);
+            formats.push(__assign({ index: idx }, (typeof fill === "string" && fill ? { color: "#".concat(fill.toUpperCase()) } : {})));
+        }
+    }
+    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+    finally {
+        try {
+            if (list_1_1 && !list_1_1.done && (_a = list_1.return)) _a.call(list_1);
+        }
+        finally { if (e_7) throw e_7.error; }
+    }
+    return formats.length ? formats : undefined;
+}
+/**
+ * Namespace URI → the prefix Excel writes for it. Bodies are stored with these
+ * canonical prefixes so a file that declared, say, `xmlns:c="…"` as `cs:` still
+ * round-trips through an exporter that declares `c:` / `a:` at the root.
+ */
+export var CHART_XML_PREFIXES = {
+    "http://schemas.openxmlformats.org/drawingml/2006/chart": "c",
+    "http://schemas.openxmlformats.org/drawingml/2006/main": "a",
+    "http://schemas.openxmlformats.org/officeDocument/2006/relationships": "r",
+    "http://schemas.openxmlformats.org/markup-compatibility/2006": "mc",
+    "http://schemas.microsoft.com/office/drawing/2007/8/2/chart": "c14",
+    "http://schemas.microsoft.com/office/drawing/2012/chart": "c15",
+    "http://schemas.microsoft.com/office/drawing/2014/chart": "c16",
+    "http://schemas.microsoft.com/office/drawing/2015/06/chart": "c16r2",
+    "http://schemas.microsoft.com/office/drawing/2017/03/chart": "c16r3",
+    "http://schemas.microsoft.com/office/drawing/2010/main": "a14",
+    "http://schemas.microsoft.com/office/drawing/2014/main": "a16",
+};
+// Ordered parse of a chart part — the object parse the plugin uses drops the
+// order of differently named siblings, which DrawingML schemas fix
+// (`<a:gsLst>` before `<a:lin>`, `<a:bodyPr>` before `<a:p>`), so the verbatim
+// bodies are read from a `preserveOrder` pass instead.
+var orderedChartParser = new XMLParser({
+    ignoreAttributes: false,
+    preserveOrder: true,
+    attributeNamePrefix: "",
+    textNodeName: "t$",
+    trimValues: false,
+    processEntities: false,
+});
+var localName = function (tag) { return tag.slice(tag.indexOf(":") + 1); };
+/**
+ * `preserveOrder` node → `ChartXmlElement`, prefixes canonicalised through the
+ * `xmlns:*` declarations seen so far (`declared`: prefix → URI); namespace
+ * declarations themselves are dropped — the exporters re-emit them.
+ */
+var toChartXmlElement = function (node, declared) {
+    var e_8, _a, e_9, _b, e_10, _c;
+    var _d;
+    var tag = Object.keys(node).find(function (k) { return k !== ":@"; });
+    if (!tag)
+        return undefined;
+    var rawAttrs = ((_d = node[":@"]) !== null && _d !== void 0 ? _d : {});
+    var scope = new Map(declared);
+    try {
+        for (var _e = __values(Object.entries(rawAttrs)), _f = _e.next(); !_f.done; _f = _e.next()) {
+            var _g = __read(_f.value, 2), k = _g[0], v = _g[1];
+            if (k === "xmlns")
+                scope.set("", String(v));
+            else if (k.startsWith("xmlns:"))
+                scope.set(k.slice(6), String(v));
+        }
+    }
+    catch (e_8_1) { e_8 = { error: e_8_1 }; }
+    finally {
+        try {
+            if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
+        }
+        finally { if (e_8) throw e_8.error; }
+    }
+    var canonical = function (name) {
+        var at = name.indexOf(":");
+        var prefix = at === -1 ? "" : name.slice(0, at);
+        var uri = scope.get(prefix);
+        var known = uri ? CHART_XML_PREFIXES[uri] : undefined;
+        if (!known)
+            return name;
+        return "".concat(known, ":").concat(at === -1 ? name : name.slice(at + 1));
+    };
+    var attributes = {};
+    try {
+        for (var _h = __values(Object.entries(rawAttrs)), _j = _h.next(); !_j.done; _j = _h.next()) {
+            var _k = __read(_j.value, 2), k = _k[0], v = _k[1];
+            if (k === "xmlns" || k.startsWith("xmlns:"))
+                continue;
+            attributes[k.includes(":") ? canonical(k) : k] = String(v);
+        }
+    }
+    catch (e_9_1) { e_9 = { error: e_9_1 }; }
+    finally {
+        try {
+            if (_j && !_j.done && (_b = _h.return)) _b.call(_h);
+        }
+        finally { if (e_9) throw e_9.error; }
+    }
+    var element = { tag: canonical(tag) };
+    if (Object.keys(attributes).length)
+        element.attributes = attributes;
+    var kids = Array.isArray(node[tag]) ? node[tag] : [];
+    var children = [];
+    var text;
+    try {
+        for (var kids_1 = __values(kids), kids_1_1 = kids_1.next(); !kids_1_1.done; kids_1_1 = kids_1.next()) {
+            var kid = kids_1_1.value;
+            if (!kid || typeof kid !== "object")
+                continue;
+            if ("t$" in kid) {
+                text = (text !== null && text !== void 0 ? text : "") + String(kid.t$);
+                continue;
+            }
+            var child = toChartXmlElement(kid, scope);
+            if (child)
+                children.push(child);
+        }
+    }
+    catch (e_10_1) { e_10 = { error: e_10_1 }; }
+    finally {
+        try {
+            if (kids_1_1 && !kids_1_1.done && (_c = kids_1.return)) _c.call(kids_1);
+        }
+        finally { if (e_10) throw e_10.error; }
+    }
+    if (children.length)
+        element.children = children;
+    else if (text !== undefined && text !== "")
+        element.text = text;
+    return element;
+};
+/**
+ * Read every `<c:pivotFmt>` body (its children after `<c:idx>`) verbatim from
+ * the chart part and attach it to the matching `pivotFormats` entry by index
+ * (rowsncolumns/spreadsheet#668 C-83). Gradient fills, theme colours, markers
+ * and data-label formatting Excel keeps per pivot item survive the round-trip
+ * that `color` (a literal solid fill) alone cannot carry.
+ */
+export function attachPivotFormatBodies(formats, chartContent) {
+    var e_11, _a, e_12, _b, e_13, _c;
+    var _d, _e;
+    var ordered;
+    try {
+        ordered = orderedChartParser.parse(chartContent);
+    }
+    catch (_f) {
+        return;
+    }
+    var findPivotFmts = function (nodes, declared) {
+        var e_14, _a, e_15, _b;
+        var _c, _d;
+        try {
+            for (var nodes_1 = __values(nodes), nodes_1_1 = nodes_1.next(); !nodes_1_1.done; nodes_1_1 = nodes_1.next()) {
+                var node = nodes_1_1.value;
+                if (!node || typeof node !== "object")
+                    continue;
+                var tag = Object.keys(node).find(function (k) { return k !== ":@"; });
+                // Text nodes (`{ t$ }`) have no element children to search.
+                if (!tag || !Array.isArray(node[tag]))
+                    continue;
+                var scope = new Map(declared);
+                try {
+                    for (var _e = (e_15 = void 0, __values(Object.entries(((_c = node[":@"]) !== null && _c !== void 0 ? _c : {})))), _f = _e.next(); !_f.done; _f = _e.next()) {
+                        var _g = __read(_f.value, 2), k = _g[0], v = _g[1];
+                        if (k === "xmlns")
+                            scope.set("", String(v));
+                        else if (k.startsWith("xmlns:"))
+                            scope.set(k.slice(6), String(v));
+                    }
+                }
+                catch (e_15_1) { e_15 = { error: e_15_1 }; }
+                finally {
+                    try {
+                        if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+                    }
+                    finally { if (e_15) throw e_15.error; }
+                }
+                if (localName(tag) === "pivotFmts")
+                    return { node: node, declared: scope };
+                var found_1 = findPivotFmts(((_d = node[tag]) !== null && _d !== void 0 ? _d : []), scope);
+                if (found_1)
+                    return found_1;
+            }
+        }
+        catch (e_14_1) { e_14 = { error: e_14_1 }; }
+        finally {
+            try {
+                if (nodes_1_1 && !nodes_1_1.done && (_a = nodes_1.return)) _a.call(nodes_1);
+            }
+            finally { if (e_14) throw e_14.error; }
+        }
+        return undefined;
+    };
+    var found = findPivotFmts(ordered, new Map());
+    if (!found)
+        return;
+    var fmtsTag = Object.keys(found.node).find(function (k) { return k !== ":@"; });
+    var byIndex = new Map();
+    try {
+        for (var _g = __values(((_d = found.node[fmtsTag]) !== null && _d !== void 0 ? _d : [])), _h = _g.next(); !_h.done; _h = _g.next()) {
+            var fmt = _h.value;
+            if (!fmt || typeof fmt !== "object")
+                continue;
+            var fmtTag = Object.keys(fmt).find(function (k) { return k !== ":@"; });
+            if (!fmtTag || localName(fmtTag) !== "pivotFmt" || !Array.isArray(fmt[fmtTag]))
+                continue;
+            var kids = fmt[fmtTag];
+            var index = void 0;
+            var body = [];
+            try {
+                for (var kids_2 = (e_12 = void 0, __values(kids)), kids_2_1 = kids_2.next(); !kids_2_1.done; kids_2_1 = kids_2.next()) {
+                    var kid = kids_2_1.value;
+                    if (!kid || typeof kid !== "object")
+                        continue;
+                    var kidTag = Object.keys(kid).find(function (k) { return k !== ":@"; });
+                    if (!kidTag)
+                        continue;
+                    if (localName(kidTag) === "idx") {
+                        index = toInt((_e = kid[":@"]) === null || _e === void 0 ? void 0 : _e.val);
+                        continue;
+                    }
+                    var element = toChartXmlElement(kid, found.declared);
+                    if (element)
+                        body.push(element);
+                }
+            }
+            catch (e_12_1) { e_12 = { error: e_12_1 }; }
+            finally {
+                try {
+                    if (kids_2_1 && !kids_2_1.done && (_b = kids_2.return)) _b.call(kids_2);
+                }
+                finally { if (e_12) throw e_12.error; }
+            }
+            if (index !== undefined && body.length)
+                byIndex.set(index, body);
+        }
+    }
+    catch (e_11_1) { e_11 = { error: e_11_1 }; }
+    finally {
+        try {
+            if (_h && !_h.done && (_a = _g.return)) _a.call(_g);
+        }
+        finally { if (e_11) throw e_11.error; }
+    }
+    try {
+        for (var formats_1 = __values(formats), formats_1_1 = formats_1.next(); !formats_1_1.done; formats_1_1 = formats_1.next()) {
+            var format = formats_1_1.value;
+            var body = byIndex.get(format.index);
+            if (body)
+                format.body = body;
+        }
+    }
+    catch (e_13_1) { e_13 = { error: e_13_1 }; }
+    finally {
+        try {
+            if (formats_1_1 && !formats_1_1.done && (_c = formats_1.return)) _c.call(formats_1);
+        }
+        finally { if (e_13) throw e_13.error; }
+    }
+}
+var PIVOT_OPTIONS_EXT_URI = "{781A3756-C4B2-4CAC-9D66-4F8BD8637D16}";
+/**
+ * Excel's Field Buttons choices — `<c14:pivotOptions>` in the chartSpace
+ * `<c:extLst>`: `dropZoneFilter` / `dropZoneCategories` / `dropZoneData` /
+ * `dropZoneSeries` / `dropZonesVisible`, each `1` unless hidden. Only the
+ * hidden ones are recorded (every button shows by default).
+ */
+export function extractPivotFieldButtons(chartSpaceRoot) {
+    var extList = getWithFallback(chartSpaceRoot, ["c:extLst.c:ext", "extLst.ext"]);
+    if (extList === undefined)
+        return undefined;
+    var exts = Array.isArray(extList) ? extList : [extList];
+    var ext = exts.find(function (e) { var _a; return ((_a = e === null || e === void 0 ? void 0 : e.a$) === null || _a === void 0 ? void 0 : _a.uri) === PIVOT_OPTIONS_EXT_URI; });
+    var options = getWithFallback(ext, ["c14:pivotOptions", "pivotOptions"]);
+    if (!options)
+        return undefined;
+    var isHidden = function (element) {
+        var val = getWithFallback(options, [
+            "c14:".concat(element, ".a$.val"),
+            "".concat(element, ".a$.val"),
+        ]);
+        return val === "0" || val === "false" || val === false;
+    };
+    var buttons = __assign(__assign(__assign(__assign(__assign({}, (isHidden("dropZonesVisible") ? { visible: false } : {})), (isHidden("dropZoneFilter") ? { reportFilter: false } : {})), (isHidden("dropZoneCategories") ? { axis: false } : {})), (isHidden("dropZoneSeries") ? { legend: false } : {})), (isHidden("dropZoneData") ? { value: false } : {}));
+    return Object.keys(buttons).length ? buttons : undefined;
+}
 export function extractChartTitle(chart) {
     // Try different possible paths for chart title
     var title = 
@@ -518,12 +1064,19 @@ export function determineChartType(chart) {
     var c15Type = detectC15ChartType(plotArea);
     if (c15Type)
         return c15Type;
-    var barChart = getWithFallback(plotArea, [
+    // Excel's VHLC / VOHLC stock charts pair a <c:barChart> (the volume
+    // series) with the <c:stockChart>, so the stock group must win over the
+    // bar scan below.
+    if (getWithFallback(plotArea, ["c:stockChart", "stockChart"]))
+        return "stock";
+    // A chart whose secondary axis group is split into its own container
+    // carries an array here; the primary group comes first.
+    var barChart = firstGroup(getWithFallback(plotArea, [
         "c:barChart",
         "barChart",
         "c:bar3DChart",
         "bar3DChart",
-    ]);
+    ]));
     if (barChart) {
         var direction = get(barChart, "c:barDir.a$.val") ||
             get(barChart, "c:barDir.a$.t$") ||
@@ -571,8 +1124,6 @@ export function determineChartType(chart) {
         return "area";
     if (getWithFallback(plotArea, ["c:radarChart", "radarChart"]))
         return "radar";
-    if (getWithFallback(plotArea, ["c:stockChart", "stockChart"]))
-        return "stock";
     // Scatter and bubble — both use c:xVal/c:yVal series shape (not
     // c:cat/c:val like other charts). Bubble additionally has c:bubbleSize.
     if (getWithFallback(plotArea, ["c:scatterChart", "scatterChart"]))
@@ -618,7 +1169,7 @@ export function extractThreeDSourceChartType(plotArea) {
  * fast-xml-parser normalizes lone children to objects.
  */
 function detectC15ChartType(plotArea) {
-    var e_4, _a, e_5, _b;
+    var e_16, _a, e_17, _b;
     if (!plotArea)
         return null;
     // Empty c15 elements (`<c15:histogramChart/>`) parse to "" — truthy
@@ -650,12 +1201,12 @@ function detectC15ChartType(plotArea) {
                         return "funnel";
                 }
             }
-            catch (e_4_1) { e_4 = { error: e_4_1 }; }
+            catch (e_16_1) { e_16 = { error: e_16_1 }; }
             finally {
                 try {
                     if (choices_1_1 && !choices_1_1.done && (_a = choices_1.return)) _a.call(choices_1);
                 }
-                finally { if (e_4) throw e_4.error; }
+                finally { if (e_16) throw e_16.error; }
             }
         }
     }
@@ -670,8 +1221,8 @@ function detectC15ChartType(plotArea) {
         return null;
     var exts = Array.isArray(extNode) ? extNode : [extNode];
     try {
-        for (var exts_1 = __values(exts), exts_1_1 = exts_1.next(); !exts_1_1.done; exts_1_1 = exts_1.next()) {
-            var ext = exts_1_1.value;
+        for (var exts_2 = __values(exts), exts_2_1 = exts_2.next(); !exts_2_1.done; exts_2_1 = exts_2.next()) {
+            var ext = exts_2_1.value;
             if (!ext)
                 continue;
             if (hasKey(ext, "c15:histogramChart") || hasKey(ext, "histogramChart"))
@@ -684,12 +1235,12 @@ function detectC15ChartType(plotArea) {
                 return "funnel";
         }
     }
-    catch (e_5_1) { e_5 = { error: e_5_1 }; }
+    catch (e_17_1) { e_17 = { error: e_17_1 }; }
     finally {
         try {
-            if (exts_1_1 && !exts_1_1.done && (_b = exts_1.return)) _b.call(exts_1);
+            if (exts_2_1 && !exts_2_1.done && (_b = exts_2.return)) _b.call(exts_2);
         }
-        finally { if (e_5) throw e_5.error; }
+        finally { if (e_17) throw e_17.error; }
     }
     return null;
 }
@@ -698,7 +1249,7 @@ function detectC15ChartType(plotArea) {
  * marker. Returns undefined if absent.
  */
 export function extractC15HistogramBinCount(plotArea) {
-    var e_6, _a, e_7, _b;
+    var e_18, _a, e_19, _b;
     var _c, _d, _e, _f;
     if (!plotArea)
         return undefined;
@@ -733,12 +1284,12 @@ export function extractC15HistogramBinCount(plotArea) {
                     return v;
             }
         }
-        catch (e_6_1) { e_6 = { error: e_6_1 }; }
+        catch (e_18_1) { e_18 = { error: e_18_1 }; }
         finally {
             try {
                 if (choices_2_1 && !choices_2_1.done && (_a = choices_2.return)) _a.call(choices_2);
             }
-            finally { if (e_6) throw e_6.error; }
+            finally { if (e_18) throw e_18.error; }
         }
     }
     // Phase 5.5 (legacy): histogram inside c:extLst > c:ext marker.
@@ -750,20 +1301,20 @@ export function extractC15HistogramBinCount(plotArea) {
         return undefined;
     var exts = Array.isArray(extNode) ? extNode : [extNode];
     try {
-        for (var exts_2 = __values(exts), exts_2_1 = exts_2.next(); !exts_2_1.done; exts_2_1 = exts_2.next()) {
-            var ext = exts_2_1.value;
+        for (var exts_3 = __values(exts), exts_3_1 = exts_3.next(); !exts_3_1.done; exts_3_1 = exts_3.next()) {
+            var ext = exts_3_1.value;
             var hist = (_f = (_e = ext === null || ext === void 0 ? void 0 : ext["c15:histogramChart"]) !== null && _e !== void 0 ? _e : ext === null || ext === void 0 ? void 0 : ext["histogramChart"]) !== null && _f !== void 0 ? _f : null;
             var v = readBinCount(hist);
             if (v !== undefined)
                 return v;
         }
     }
-    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+    catch (e_19_1) { e_19 = { error: e_19_1 }; }
     finally {
         try {
-            if (exts_2_1 && !exts_2_1.done && (_b = exts_2.return)) _b.call(exts_2);
+            if (exts_3_1 && !exts_3_1.done && (_b = exts_3.return)) _b.call(exts_3);
         }
-        finally { if (e_7) throw e_7.error; }
+        finally { if (e_19) throw e_19.error; }
     }
     return undefined;
 }
@@ -807,6 +1358,89 @@ var CHART_TYPE_CONTAINERS = [
         isXY: true,
     },
 ];
+/**
+ * A series' position in the chart — `<c:order>` (Excel's plot / legend
+ * order), falling back to `<c:idx>`; NaN when the series carries neither.
+ */
+function seriesOrderOf(ser) {
+    var _a, _b, _c;
+    var raw = (_c = (_b = (_a = get(ser, "c:order.a$.val")) !== null && _a !== void 0 ? _a : get(ser, "order.a$.val")) !== null && _b !== void 0 ? _b : get(ser, "c:idx.a$.val")) !== null && _c !== void 0 ? _c : get(ser, "idx.a$.val");
+    var n = Number(raw);
+    return raw === undefined || raw === null || raw === "" ? NaN : n;
+}
+/**
+ * Put the collected series back in Excel's `<c:order>`: a chart split into
+ * several containers (one per chart type and per axis group) lists them
+ * container by container, which is not the authored order. Only sorts
+ * when every series carries an order (older / hand-written files without
+ * one keep their document order).
+ */
+function sortSeriesByOrder(series, orders) {
+    if (series.length < 2 || orders.length !== series.length)
+        return series;
+    if (orders.some(function (order) { return !Number.isFinite(order); }))
+        return series;
+    return series
+        .map(function (entry, index) { return ({ entry: entry, order: orders[index], index: index }); })
+        .sort(function (a, b) { return a.order - b.order || a.index - b.index; })
+        .map(function (_a) {
+        var entry = _a.entry;
+        return entry;
+    });
+}
+/**
+ * The first chart-type container of a group that may be split into one
+ * container per axis group (primary first, then the secondary group).
+ */
+function firstGroup(node) {
+    return Array.isArray(node) ? node[0] : node;
+}
+/** `<c:axId val>` values of an axis element or a chart-type container. */
+function axisIdsOf(node) {
+    var raw = getWithFallback(node, ["c:axId", "axId"]);
+    if (!raw)
+        return [];
+    var list = Array.isArray(raw) ? raw : [raw];
+    return list
+        .map(function (entry) { var _a, _b, _c, _d; return (_d = (_b = (_a = entry === null || entry === void 0 ? void 0 : entry.a$) === null || _a === void 0 ? void 0 : _a.val) !== null && _b !== void 0 ? _b : (_c = entry === null || entry === void 0 ? void 0 : entry.a$) === null || _c === void 0 ? void 0 : _c.t$) !== null && _d !== void 0 ? _d : entry; })
+        .filter(function (id) { return id != null; })
+        .map(String);
+}
+/**
+ * The axis ids of the plot area's SECONDARY axis group — every `<c:valAx>`,
+ * `<c:catAx>` and `<c:dateAx>` after the first of its kind. Excel keeps one
+ * category axis and one value axis per axis group; a chart-type container
+ * whose `<c:axId>`s name any of these ids plots its series on the
+ * secondary group (Excel's "Plot Series On: Secondary Axis").
+ */
+function secondaryAxisGroupIds(plotArea) {
+    var e_20, _a;
+    var ids = new Set();
+    try {
+        for (var _b = __values(["c:valAx", "valAx", "c:catAx", "catAx", "c:dateAx", "dateAx"]), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var key = _c.value;
+            var axes = get(plotArea, key);
+            if (!axes)
+                continue;
+            var list = Array.isArray(axes) ? axes : [axes];
+            list.slice(1).forEach(function (axis) { return axisIdsOf(axis).forEach(function (id) { return ids.add(id); }); });
+        }
+    }
+    catch (e_20_1) { e_20 = { error: e_20_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_20) throw e_20.error; }
+    }
+    return ids;
+}
+/** True when a chart-type container's `<c:axId>`s bind it to the secondary axis group. */
+function isSecondaryGroupContainer(container, secondaryIds) {
+    if (!secondaryIds.size)
+        return false;
+    return axisIdsOf(container).some(function (id) { return secondaryIds.has(id); });
+}
 /**
  * Resolve a chart-formula range string (e.g.
  * `'Data for the Chart'!$A$7:$A$26`) into the sources array our chart
@@ -827,7 +1461,7 @@ function resolveSourcesFromRef(ref, hostSheetId, resolveSheetId) {
  * sparse indices). Returns `undefined` when no inline data is present.
  */
 function extractInlineValues(node) {
-    var e_8, _a;
+    var e_21, _a;
     var _b, _c, _d, _e;
     if (!node)
         return undefined;
@@ -864,25 +1498,29 @@ function extractInlineValues(node) {
             indexed.push({ idx: Number.isFinite(idx) ? idx : indexed.length, v: v });
         }
     }
-    catch (e_8_1) { e_8 = { error: e_8_1 }; }
+    catch (e_21_1) { e_21 = { error: e_21_1 }; }
     finally {
         try {
             if (ptArray_1_1 && !ptArray_1_1.done && (_a = ptArray_1.return)) _a.call(ptArray_1);
         }
-        finally { if (e_8) throw e_8.error; }
+        finally { if (e_21) throw e_21.error; }
     }
     indexed.sort(function (a, b) { return a.idx - b.idx; });
     return indexed.map(function (entry) { return entry.v; });
 }
 export function extractChartSeries(plotArea, chartType, sheetId, resolveSheetId) {
-    var e_9, _a, e_10, _b;
+    var e_22, _a, e_23, _b;
     var _c, _d;
     var series = [];
+    var orders = [];
     var seriesIndex = 0;
+    var secondaryIds = secondaryAxisGroupIds(plotArea);
     try {
-        // Iterate through all chart type containers to support combo charts
-        for (var CHART_TYPE_CONTAINERS_1 = __values(CHART_TYPE_CONTAINERS), CHART_TYPE_CONTAINERS_1_1 = CHART_TYPE_CONTAINERS_1.next(); !CHART_TYPE_CONTAINERS_1_1.done; CHART_TYPE_CONTAINERS_1_1 = CHART_TYPE_CONTAINERS_1.next()) {
-            var container = CHART_TYPE_CONTAINERS_1_1.value;
+        // Iterate through all chart type containers to support combo charts.
+        // A stock chart's <c:barChart> is its volume series, not a combo member
+        // — the stock path below reads both groups in role order.
+        for (var _e = __values(chartType === "stock" ? [] : CHART_TYPE_CONTAINERS), _f = _e.next(); !_f.done; _f = _e.next()) {
+            var container = _f.value;
             var chartElement = getWithFallback(plotArea, container.paths);
             if (!chartElement)
                 continue;
@@ -891,8 +1529,11 @@ export function extractChartSeries(plotArea, chartType, sheetId, resolveSheetId)
                 ? chartElement
                 : [chartElement];
             try {
-                for (var chartElements_1 = (e_10 = void 0, __values(chartElements)), chartElements_1_1 = chartElements_1.next(); !chartElements_1_1.done; chartElements_1_1 = chartElements_1.next()) {
+                for (var chartElements_1 = (e_23 = void 0, __values(chartElements)), chartElements_1_1 = chartElements_1.next(); !chartElements_1_1.done; chartElements_1_1 = chartElements_1.next()) {
                     var singleChartElement = chartElements_1_1.value;
+                    // Series in a container bound to the secondary axis group plot on
+                    // the secondary axes (Excel's "Plot Series On: Secondary Axis").
+                    var useSecondaryAxis = isSecondaryGroupContainer(singleChartElement, secondaryIds);
                     // Determine the actual chart type for this container
                     var seriesChartType = container.chartType;
                     if (container.isBar) {
@@ -955,28 +1596,29 @@ export function extractChartSeries(plotArea, chartType, sheetId, resolveSheetId)
                         var categorySources = serCatRef
                             ? resolveSourcesFromRef(serCatRef, sheetId, resolveSheetId)
                             : [];
-                        series.push(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({ dataLabel: seriesTitle || "Series ".concat(seriesIndex + 1) }, (nameRef ? { dataLabelRef: nameRef } : {})), (categorySources.length ? { categorySources: categorySources } : {})), { color: colorInfo.color }), (colorInfo.noFill ? { noFill: true } : {})), { negativeColor: colorInfo.negativeColor, invertIfNegative: colorInfo.invertIfNegative }), (colorInfo.gradient ? { gradient: colorInfo.gradient } : {})), (container.isXY ? {} : { seriesChartType: seriesChartType })), { sources: sources }), (inlineValues && inlineValues.length ? { inlineValues: inlineValues } : {})), (trendlines && trendlines.length ? { trendlines: trendlines } : {})), (errorBars ? { errorBars: errorBars } : {})), (marker ? { marker: marker } : {})), (dataPointColors && dataPointColors.length
+                        orders.push(seriesOrderOf(ser));
+                        series.push(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({ dataLabel: seriesTitle || "Series ".concat(seriesIndex + 1) }, (nameRef ? { dataLabelRef: nameRef } : {})), (categorySources.length ? { categorySources: categorySources } : {})), { color: colorInfo.color }), (colorInfo.noFill ? { noFill: true } : {})), { negativeColor: colorInfo.negativeColor, invertIfNegative: colorInfo.invertIfNegative }), (colorInfo.gradient ? { gradient: colorInfo.gradient } : {})), (container.isXY ? {} : { seriesChartType: seriesChartType })), (useSecondaryAxis ? { useSecondaryAxis: true } : {})), { sources: sources }), (inlineValues && inlineValues.length ? { inlineValues: inlineValues } : {})), (trendlines && trendlines.length ? { trendlines: trendlines } : {})), (errorBars ? { errorBars: errorBars } : {})), (marker ? { marker: marker } : {})), (dataPointColors && dataPointColors.length
                             ? { dataPointColors: dataPointColors }
                             : {})));
                         seriesIndex++;
                     }
                 }
             }
-            catch (e_10_1) { e_10 = { error: e_10_1 }; }
+            catch (e_23_1) { e_23 = { error: e_23_1 }; }
             finally {
                 try {
                     if (chartElements_1_1 && !chartElements_1_1.done && (_b = chartElements_1.return)) _b.call(chartElements_1);
                 }
-                finally { if (e_10) throw e_10.error; }
+                finally { if (e_23) throw e_23.error; }
             }
         }
     }
-    catch (e_9_1) { e_9 = { error: e_9_1 }; }
+    catch (e_22_1) { e_22 = { error: e_22_1 }; }
     finally {
         try {
-            if (CHART_TYPE_CONTAINERS_1_1 && !CHART_TYPE_CONTAINERS_1_1.done && (_a = CHART_TYPE_CONTAINERS_1.return)) _a.call(CHART_TYPE_CONTAINERS_1);
+            if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
         }
-        finally { if (e_9) throw e_9.error; }
+        finally { if (e_22) throw e_22.error; }
     }
     // Fallback: pie/doughnut/radar/stock/ofPie/etc. aren't in
     // CHART_TYPE_CONTAINERS; they're single-container, type-specific,
@@ -1018,13 +1660,16 @@ export function extractChartSeries(plotArea, chartType, sheetId, resolveSheetId)
                 var categorySources = serCatRef
                     ? resolveSourcesFromRef(serCatRef, sheetId, resolveSheetId)
                     : [];
+                orders.push(seriesOrderOf(ser));
                 series.push(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({ dataLabel: seriesTitle || "Series ".concat(index + 1) }, (nameRef ? { dataLabelRef: nameRef } : {})), (categorySources.length ? { categorySources: categorySources } : {})), { color: colorInfo.color }), (colorInfo.noFill ? { noFill: true } : {})), { negativeColor: colorInfo.negativeColor, invertIfNegative: colorInfo.invertIfNegative }), (colorInfo.gradient ? { gradient: colorInfo.gradient } : {})), { sources: sources }), (inlineValues && inlineValues.length ? { inlineValues: inlineValues } : {})), (marker ? { marker: marker } : {})), (dataPointColors && dataPointColors.length
                     ? { dataPointColors: dataPointColors }
                     : {})));
             });
         }
     }
-    return series;
+    // Stock charts read their price roles in document order; every other
+    // chart lists its series in Excel's <c:order>.
+    return chartType === "stock" ? series : sortSeriesByOrder(series, orders);
 }
 /**
  * Extract per-data-point color overrides — `<c:dPt>` array inside
@@ -1034,7 +1679,7 @@ export function extractChartSeries(plotArea, chartType, sheetId, resolveSheetId)
  * are no overrides.
  */
 function extractSeriesDataPointColors(ser) {
-    var e_11, _a;
+    var e_24, _a;
     var _b, _c, _d;
     var raw = (_b = get(ser, "c:dPt")) !== null && _b !== void 0 ? _b : get(ser, "dPt");
     if (!raw)
@@ -1042,8 +1687,8 @@ function extractSeriesDataPointColors(ser) {
     var list = Array.isArray(raw) ? raw : [raw];
     var result = [];
     try {
-        for (var list_1 = __values(list), list_1_1 = list_1.next(); !list_1_1.done; list_1_1 = list_1.next()) {
-            var dPt = list_1_1.value;
+        for (var list_2 = __values(list), list_2_1 = list_2.next(); !list_2_1.done; list_2_1 = list_2.next()) {
+            var dPt = list_2_1.value;
             var idxRaw = (_c = get(dPt, "c:idx.a$.val")) !== null && _c !== void 0 ? _c : get(dPt, "idx.a$.val");
             var idx = idxRaw !== undefined ? Number(idxRaw) : NaN;
             if (!Number.isFinite(idx))
@@ -1055,12 +1700,12 @@ function extractSeriesDataPointColors(ser) {
             result.push({ idx: idx, color: color });
         }
     }
-    catch (e_11_1) { e_11 = { error: e_11_1 }; }
+    catch (e_24_1) { e_24 = { error: e_24_1 }; }
     finally {
         try {
-            if (list_1_1 && !list_1_1.done && (_a = list_1.return)) _a.call(list_1);
+            if (list_2_1 && !list_2_1.done && (_a = list_2.return)) _a.call(list_2);
         }
-        finally { if (e_11) throw e_11.error; }
+        finally { if (e_24) throw e_24.error; }
     }
     return result.length ? result : undefined;
 }
@@ -1276,7 +1921,9 @@ function extractTextProperties(txPr) {
  */
 function extractBarLayoutOptions(plotArea) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
-    var bar = (_c = (_b = (_a = get(plotArea, "c:barChart")) !== null && _a !== void 0 ? _a : get(plotArea, "barChart")) !== null && _b !== void 0 ? _b : get(plotArea, "c:bar3DChart")) !== null && _c !== void 0 ? _c : get(plotArea, "bar3DChart");
+    // The primary axis group's container when the secondary group is split
+    // into its own (Excel writes one container per axis group).
+    var bar = firstGroup((_c = (_b = (_a = get(plotArea, "c:barChart")) !== null && _a !== void 0 ? _a : get(plotArea, "barChart")) !== null && _b !== void 0 ? _b : get(plotArea, "c:bar3DChart")) !== null && _c !== void 0 ? _c : get(plotArea, "bar3DChart"));
     if (!bar)
         return undefined;
     // `<c:grouping val="clustered|stacked|percentStacked|standard"/>`.
@@ -1307,6 +1954,61 @@ function extractBarLayoutOptions(plotArea) {
         result.gapWidth = gapWidthVal;
     return Object.keys(result).length ? result : undefined;
 }
+/**
+ * Read `<c:lineChart>` / `<c:line3DChart>` `<c:grouping>` (standard /
+ * stacked / percentStacked → `stackedType`) and the chart-level
+ * `<c:marker val>` flag. Excel writes `<c:marker val="1"/>` on every line
+ * chart and hides a plain "Line"'s markers per series through
+ * `<c:marker><c:symbol val="none"/>`, so `showMarkers` is only reported
+ * when the flag is set and at least one series is not "none".
+ */
+function extractLineChartOptions(plotArea, series) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    // The primary axis group's container when the secondary group is split
+    // into its own (Excel writes one container per axis group).
+    var line = firstGroup((_c = (_b = (_a = get(plotArea, "c:lineChart")) !== null && _a !== void 0 ? _a : get(plotArea, "lineChart")) !== null && _b !== void 0 ? _b : get(plotArea, "c:line3DChart")) !== null && _c !== void 0 ? _c : get(plotArea, "line3DChart"));
+    if (!line)
+        return undefined;
+    var groupingVal = (_f = (_e = (_d = get(line, "c:grouping.a$.val")) !== null && _d !== void 0 ? _d : get(line, "grouping.a$.val")) !== null && _e !== void 0 ? _e : get(line, "c:grouping.a$.t$")) !== null && _f !== void 0 ? _f : get(line, "grouping.a$.t$");
+    var result = {};
+    switch (groupingVal) {
+        case "stacked":
+            result.stackedType = "STACKED";
+            break;
+        case "percentStacked":
+            result.stackedType = "PERCENT_STACKED";
+            break;
+        case "standard":
+            result.stackedType = "UNSTACKED";
+            break;
+    }
+    var markerVal = (_g = get(line, "c:marker.a$.val")) !== null && _g !== void 0 ? _g : get(line, "marker.a$.val");
+    var markerFlag = markerVal === "1" ||
+        markerVal === 1 ||
+        markerVal === "true" ||
+        markerVal === true;
+    if (markerFlag &&
+        series.length > 0 &&
+        series.some(function (entry) { var _a; return ((_a = entry.marker) === null || _a === void 0 ? void 0 : _a.symbol) !== "none"; })) {
+        result.showMarkers = true;
+    }
+    return Object.keys(result).length ? result : undefined;
+}
+/**
+ * Which of Excel's four stock layouts a `<c:stockChart>` is: a sibling
+ * `<c:barChart>` carries the volume series (V-variants), and four price
+ * series (open/high/low/close) instead of three mean OHLC.
+ */
+function extractStockVariant(plotArea) {
+    var prices = getWithFallback(plotArea, [
+        "c:stockChart.c:ser",
+        "stockChart.ser",
+    ]);
+    var priceCount = Array.isArray(prices) ? prices.length : prices ? 1 : 0;
+    var hasVolume = Boolean(getWithFallback(plotArea, ["c:barChart", "barChart"]));
+    var body = priceCount >= 4 ? "OHLC" : "HLC";
+    return hasVolume ? "V".concat(body) : body;
+}
 /**
  * Extract chart-level `<c:scatterStyle val=…>`. Excel default is
  * "lineMarker" (straight lines + markers). Returns undefined for
@@ -1318,7 +2020,7 @@ function extractScatterStyle(plotArea) {
     return typeof val === "string" && val ? val : undefined;
 }
 function extractSeriesTitleFromSeries(ser) {
-    var e_12, _a;
+    var e_25, _a;
     // Prefer cached textual value if present
     var cacheEntries = get(ser, "c:tx.c:strRef.c:strCache.c:pt");
     if (cacheEntries) {
@@ -1334,12 +2036,12 @@ function extractSeriesTitleFromSeries(ser) {
                 }
             }
         }
-        catch (e_12_1) { e_12 = { error: e_12_1 }; }
+        catch (e_25_1) { e_25 = { error: e_25_1 }; }
         finally {
             try {
                 if (pts_1_1 && !pts_1_1.done && (_a = pts_1.return)) _a.call(pts_1);
             }
-            finally { if (e_12) throw e_12.error; }
+            finally { if (e_25) throw e_25.error; }
         }
     }
     // Fall back to literal
@@ -1365,7 +2067,7 @@ function coerceTitleText(value) {
     return undefined;
 }
 function extractRichText(node) {
-    var e_13, _a, e_14, _b;
+    var e_26, _a, e_27, _b;
     if (!node) {
         return undefined;
     }
@@ -1382,7 +2084,7 @@ function extractRichText(node) {
             var runs = getWithFallback(paragraph, ["a:r", "r"]);
             var runArray = Array.isArray(runs) ? runs : runs ? [runs] : [paragraph];
             try {
-                for (var runArray_1 = (e_14 = void 0, __values(runArray)), runArray_1_1 = runArray_1.next(); !runArray_1_1.done; runArray_1_1 = runArray_1.next()) {
+                for (var runArray_1 = (e_27 = void 0, __values(runArray)), runArray_1_1 = runArray_1.next(); !runArray_1_1.done; runArray_1_1 = runArray_1.next()) {
                     var run = runArray_1_1.value;
                     var text = getWithFallback(run, ["a:t.t$", "a:t"]) ||
                         getWithFallback(run, ["t$", "t"]);
@@ -1391,21 +2093,21 @@ function extractRichText(node) {
                     }
                 }
             }
-            catch (e_14_1) { e_14 = { error: e_14_1 }; }
+            catch (e_27_1) { e_27 = { error: e_27_1 }; }
             finally {
                 try {
                     if (runArray_1_1 && !runArray_1_1.done && (_b = runArray_1.return)) _b.call(runArray_1);
                 }
-                finally { if (e_14) throw e_14.error; }
+                finally { if (e_27) throw e_27.error; }
             }
         }
     }
-    catch (e_13_1) { e_13 = { error: e_13_1 }; }
+    catch (e_26_1) { e_26 = { error: e_26_1 }; }
     finally {
         try {
             if (paragraphArray_1_1 && !paragraphArray_1_1.done && (_a = paragraphArray_1.return)) _a.call(paragraphArray_1);
         }
-        finally { if (e_13) throw e_13.error; }
+        finally { if (e_26) throw e_26.error; }
     }
     if (fragments.length > 0) {
         return fragments.join("");
@@ -1428,7 +2130,7 @@ function normalizeHexColor(value) {
     return undefined;
 }
 function extractSeriesColorInfo(ser) {
-    var e_15, _a, e_16, _b;
+    var e_28, _a, e_29, _b;
     var _c, _d, _e, _f;
     var result = {};
     // <a:noFill/> on the series shape properties — transparent series.
@@ -1510,12 +2212,12 @@ function extractSeriesColorInfo(ser) {
                 stops.push({ position: position, color: color });
             }
         }
-        catch (e_15_1) { e_15 = { error: e_15_1 }; }
+        catch (e_28_1) { e_28 = { error: e_28_1 }; }
         finally {
             try {
                 if (stopList_1_1 && !stopList_1_1.done && (_a = stopList_1.return)) _a.call(stopList_1);
             }
-            finally { if (e_15) throw e_15.error; }
+            finally { if (e_28) throw e_28.error; }
         }
         if (stops.length > 0) {
             stops.sort(function (a, b) { return a.position - b.position; });
@@ -1598,26 +2300,32 @@ function extractSeriesColorInfo(ser) {
                 }
             }
         }
-        catch (e_16_1) { e_16 = { error: e_16_1 }; }
+        catch (e_29_1) { e_29 = { error: e_29_1 }; }
         finally {
             try {
                 if (extArray_1_1 && !extArray_1_1.done && (_b = extArray_1.return)) _b.call(extArray_1);
             }
-            finally { if (e_16) throw e_16.error; }
+            finally { if (e_29) throw e_29.error; }
         }
     }
     return result;
 }
 export function extractChartDomains(plotArea, chartType, sheetId, resolveSheetId) {
-    var e_17, _a, e_18, _b, e_19, _c, e_20, _d;
+    var e_30, _a, e_31, _b, e_32, _c, e_33, _d;
     var _e, _f;
     var domains = [];
+    // Non-XY: Excel keeps one category axis per axis group. The primary
+    // group's first `<c:cat>` is domains[0]; when a container bound to the
+    // secondary axis group carries a different `<c:cat>`, that list is
+    // domains[1] — the secondary group's category axis.
+    var secondaryIds = secondaryAxisGroupIds(plotArea);
+    var primaryRef;
     try {
         // Search all chart type containers for domains. For XY charts the
         // "domain" is the X values (c:xVal); for everything else it's the
         // category axis (c:cat). Per-container loop covers combo charts.
-        for (var CHART_TYPE_CONTAINERS_2 = __values(CHART_TYPE_CONTAINERS), CHART_TYPE_CONTAINERS_2_1 = CHART_TYPE_CONTAINERS_2.next(); !CHART_TYPE_CONTAINERS_2_1.done; CHART_TYPE_CONTAINERS_2_1 = CHART_TYPE_CONTAINERS_2.next()) {
-            var container = CHART_TYPE_CONTAINERS_2_1.value;
+        for (var CHART_TYPE_CONTAINERS_1 = __values(CHART_TYPE_CONTAINERS), CHART_TYPE_CONTAINERS_1_1 = CHART_TYPE_CONTAINERS_1.next(); !CHART_TYPE_CONTAINERS_1_1.done; CHART_TYPE_CONTAINERS_1_1 = CHART_TYPE_CONTAINERS_1.next()) {
+            var container = CHART_TYPE_CONTAINERS_1_1.value;
             var chartElement = getWithFallback(plotArea, container.paths);
             if (!chartElement)
                 continue;
@@ -1625,7 +2333,7 @@ export function extractChartDomains(plotArea, chartType, sheetId, resolveSheetId
                 ? chartElement
                 : [chartElement];
             try {
-                for (var chartElements_2 = (e_18 = void 0, __values(chartElements)), chartElements_2_1 = chartElements_2.next(); !chartElements_2_1.done; chartElements_2_1 = chartElements_2.next()) {
+                for (var chartElements_2 = (e_31 = void 0, __values(chartElements)), chartElements_2_1 = chartElements_2.next(); !chartElements_2_1.done; chartElements_2_1 = chartElements_2.next()) {
                     var singleChartElement = chartElements_2_1.value;
                     var seriesElements_1 = getWithFallback(singleChartElement, [
                         "c:ser",
@@ -1636,25 +2344,44 @@ export function extractChartDomains(plotArea, chartType, sheetId, resolveSheetId
                     var seriesArray = Array.isArray(seriesElements_1)
                         ? seriesElements_1
                         : [seriesElements_1];
+                    var secondaryGroup = !container.isXY &&
+                        isSecondaryGroupContainer(singleChartElement, secondaryIds);
                     try {
-                        for (var seriesArray_2 = (e_19 = void 0, __values(seriesArray)), seriesArray_2_1 = seriesArray_2.next(); !seriesArray_2_1.done; seriesArray_2_1 = seriesArray_2.next()) {
+                        for (var seriesArray_2 = (e_32 = void 0, __values(seriesArray)), seriesArray_2_1 = seriesArray_2.next(); !seriesArray_2_1.done; seriesArray_2_1 = seriesArray_2.next()) {
                             var ser = seriesArray_2_1.value;
                             var domainRef = container.isXY
                                 ? getWithFallback(ser, X_VAL_REF_PATHS)
                                 : getWithFallback(ser, CAT_REF_PATHS);
                             if (domainRef) {
+                                if (!container.isXY && domains.length) {
+                                    // Primary already found: only a secondary-group container
+                                    // with a different category list adds domains[1].
+                                    if (secondaryGroup && domainRef !== primaryRef) {
+                                        var sources_1 = resolveSourcesFromRef(domainRef, sheetId, resolveSheetId);
+                                        if (sources_1.length) {
+                                            domains.push({ sources: sources_1 });
+                                            return domains;
+                                        }
+                                    }
+                                    break;
+                                }
                                 var sources = resolveSourcesFromRef(domainRef, sheetId, resolveSheetId);
                                 if (sources.length) {
                                     domains.push({ sources: sources });
                                     // XY charts may carry per-series domains that differ — keep
                                     // the first one we encounter for the dataRange anchor, but
                                     // continue collecting so the renderer has a per-series X
-                                    // when it needs one. For non-XY, first-found is enough.
-                                    if (!container.isXY)
-                                        return domains;
+                                    // when it needs one. For non-XY, remember the primary ref
+                                    // and keep scanning for a secondary group's own list.
+                                    if (!container.isXY) {
+                                        primaryRef = domainRef;
+                                        if (!secondaryIds.size)
+                                            return domains;
+                                        break;
+                                    }
                                 }
                             }
-                            else if (!container.isXY) {
+                            else if (!container.isXY && !domains.length) {
                                 // No cell ref — check for an inline `<c:strLit>`/`<c:numLit>`
                                 // category list (e.g. `["Estimated", "Actual"]` embedded
                                 // directly in the chart XML). Same for the series val side,
@@ -1668,32 +2395,32 @@ export function extractChartDomains(plotArea, chartType, sheetId, resolveSheetId
                             }
                         }
                     }
-                    catch (e_19_1) { e_19 = { error: e_19_1 }; }
+                    catch (e_32_1) { e_32 = { error: e_32_1 }; }
                     finally {
                         try {
                             if (seriesArray_2_1 && !seriesArray_2_1.done && (_c = seriesArray_2.return)) _c.call(seriesArray_2);
                         }
-                        finally { if (e_19) throw e_19.error; }
+                        finally { if (e_32) throw e_32.error; }
                     }
                     if (domains.length && container.isXY)
                         return domains;
                 }
             }
-            catch (e_18_1) { e_18 = { error: e_18_1 }; }
+            catch (e_31_1) { e_31 = { error: e_31_1 }; }
             finally {
                 try {
                     if (chartElements_2_1 && !chartElements_2_1.done && (_b = chartElements_2.return)) _b.call(chartElements_2);
                 }
-                finally { if (e_18) throw e_18.error; }
+                finally { if (e_31) throw e_31.error; }
             }
         }
     }
-    catch (e_17_1) { e_17 = { error: e_17_1 }; }
+    catch (e_30_1) { e_30 = { error: e_30_1 }; }
     finally {
         try {
-            if (CHART_TYPE_CONTAINERS_2_1 && !CHART_TYPE_CONTAINERS_2_1.done && (_a = CHART_TYPE_CONTAINERS_2.return)) _a.call(CHART_TYPE_CONTAINERS_2);
+            if (CHART_TYPE_CONTAINERS_1_1 && !CHART_TYPE_CONTAINERS_1_1.done && (_a = CHART_TYPE_CONTAINERS_1.return)) _a.call(CHART_TYPE_CONTAINERS_1);
         }
-        finally { if (e_17) throw e_17.error; }
+        finally { if (e_30) throw e_30.error; }
     }
     // Fallback for chart types not in CHART_TYPE_CONTAINERS
     // (pie/doughnut/radar/stock/ofPie/scatter/bubble outside combos).
@@ -1726,12 +2453,12 @@ export function extractChartDomains(plotArea, chartType, sheetId, resolveSheetId
                 }
             }
         }
-        catch (e_20_1) { e_20 = { error: e_20_1 }; }
+        catch (e_33_1) { e_33 = { error: e_33_1 }; }
         finally {
             try {
                 if (seriesArray_3_1 && !seriesArray_3_1.done && (_d = seriesArray_3.return)) _d.call(seriesArray_3);
             }
-            finally { if (e_20) throw e_20.error; }
+            finally { if (e_33) throw e_33.error; }
         }
     }
     return domains;
@@ -1743,7 +2470,7 @@ export function extractChartDomains(plotArea, chartType, sheetId, resolveSheetId
  * `series`).
  */
 export function extractChartBubbleSizes(plotArea, sheetId, resolveSheetId) {
-    var e_21, _a;
+    var e_34, _a;
     var sizes = [];
     var seriesElements = getSeriesElements(plotArea, "bubble");
     if (!seriesElements)
@@ -1762,24 +2489,48 @@ export function extractChartBubbleSizes(plotArea, sheetId, resolveSheetId) {
                 sizes.push({ sources: sources });
         }
     }
-    catch (e_21_1) { e_21 = { error: e_21_1 }; }
+    catch (e_34_1) { e_34 = { error: e_34_1 }; }
     finally {
         try {
             if (seriesArray_4_1 && !seriesArray_4_1.done && (_a = seriesArray_4.return)) _a.call(seriesArray_4);
         }
-        finally { if (e_21) throw e_21.error; }
+        finally { if (e_34) throw e_34.error; }
     }
     return sizes;
 }
 export function extractChartPosition(anchor, sheetId, sheetDimensions) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     try {
         // Handle oneCellAnchor
         var oneCellFrom = (_a = getWithFallback(anchor, ["xdr:from", "from"])) !== null && _a !== void 0 ? _a : undefined;
         var hasTwoCellTarget = getWithFallback(anchor, ["xdr:to", "to"]) !== undefined;
+        // absoluteAnchor: `<xdr:pos>` + `<xdr:ext>` — "Don't move or size with
+        // cells"; kept as A1-relative pixel offsets (#668 C-06)
+        var absolutePos = getWithFallback(anchor, ["xdr:pos", "pos"]);
+        if (!oneCellFrom && absolutePos) {
+            var posAttributes = (_b = absolutePos.a$) !== null && _b !== void 0 ? _b : absolutePos;
+            var extNode = getWithFallback(anchor, ["xdr:ext", "ext"]);
+            var extAttributes = (extNode && ((_c = extNode.a$) !== null && _c !== void 0 ? _c : extNode)) || undefined;
+            var emuToPx = function (value, fallback) {
+                return value !== undefined && value !== null
+                    ? Math.round(parseInt(String(value), 10) / 9525)
+                    : fallback;
+            };
+            return {
+                sheetId: sheetId,
+                overlayPosition: {
+                    anchorCell: { rowIndex: 1, columnIndex: 1 },
+                    offsetXPixels: emuToPx(posAttributes === null || posAttributes === void 0 ? void 0 : posAttributes.x, 0),
+                    offsetYPixels: emuToPx(posAttributes === null || posAttributes === void 0 ? void 0 : posAttributes.y, 0),
+                    widthPixels: emuToPx(extAttributes === null || extAttributes === void 0 ? void 0 : extAttributes.cx, 400),
+                    heightPixels: emuToPx(extAttributes === null || extAttributes === void 0 ? void 0 : extAttributes.cy, 300),
+                    placement: "absolute",
+                },
+            };
+        }
         if (oneCellFrom && !hasTwoCellTarget) {
             var extNode = getWithFallback(anchor, ["xdr:ext", "ext"]);
-            var extAttributes = (extNode && ((_b = extNode.a$) !== null && _b !== void 0 ? _b : extNode)) || undefined;
+            var extAttributes = (extNode && ((_d = extNode.a$) !== null && _d !== void 0 ? _d : extNode)) || undefined;
             var col = toInt(getWithFallback(oneCellFrom, ["xdr:col", "col"]));
             var row = toInt(getWithFallback(oneCellFrom, ["xdr:row", "row"]));
             var colOff = toInt(getWithFallback(oneCellFrom, ["xdr:colOff", "colOff"]));
@@ -1802,12 +2553,13 @@ export function extractChartPosition(anchor, sheetId, sheetDimensions) {
                     offsetYPixels: Math.round(rowOff / 9525),
                     widthPixels: width,
                     heightPixels: height,
+                    placement: "moveOnly",
                 },
             };
         }
         // Handle twoCellAnchor
-        var fromCell = (_c = getWithFallback(anchor, ["xdr:from", "from"])) !== null && _c !== void 0 ? _c : undefined;
-        var toCell = (_d = getWithFallback(anchor, ["xdr:to", "to"])) !== null && _d !== void 0 ? _d : undefined;
+        var fromCell = (_e = getWithFallback(anchor, ["xdr:from", "from"])) !== null && _e !== void 0 ? _e : undefined;
+        var toCell = (_f = getWithFallback(anchor, ["xdr:to", "to"])) !== null && _f !== void 0 ? _f : undefined;
         if (fromCell && toCell) {
             var col = toInt(getWithFallback(fromCell, ["xdr:col", "col"]));
             var row = toInt(getWithFallback(fromCell, ["xdr:row", "row"]));
@@ -1818,8 +2570,8 @@ export function extractChartPosition(anchor, sheetId, sheetDimensions) {
             var toColOff = toInt(getWithFallback(toCell, ["xdr:colOff", "colOff"]));
             var toRowOff = toInt(getWithFallback(toCell, ["xdr:rowOff", "rowOff"]));
             // Default cell dimensions in pixels
-            var DEFAULT_COL_WIDTH_PX_1 = (_e = sheetDimensions === null || sheetDimensions === void 0 ? void 0 : sheetDimensions.defaultColumnWidth) !== null && _e !== void 0 ? _e : 64;
-            var DEFAULT_ROW_HEIGHT_PX_1 = (_f = sheetDimensions === null || sheetDimensions === void 0 ? void 0 : sheetDimensions.defaultRowHeight) !== null && _f !== void 0 ? _f : 20;
+            var DEFAULT_COL_WIDTH_PX_1 = (_g = sheetDimensions === null || sheetDimensions === void 0 ? void 0 : sheetDimensions.defaultColumnWidth) !== null && _g !== void 0 ? _g : 64;
+            var DEFAULT_ROW_HEIGHT_PX_1 = (_h = sheetDimensions === null || sheetDimensions === void 0 ? void 0 : sheetDimensions.defaultRowHeight) !== null && _h !== void 0 ? _h : 20;
             // Helper to get column width in pixels
             var getColWidth = function (colIndex) {
                 var _a, _b;
@@ -1849,18 +2601,22 @@ export function extractChartPosition(anchor, sheetId, sheetDimensions) {
             heightPx += Math.round(toRowOff / 9525);
             var width = Math.max(widthPx, 100);
             var height = Math.max(heightPx, 100);
+            // `editAs` is the placement mode; the default "Move and size with
+            // cells" keeps `to` as the second anchor so the frame follows the
+            // cells between the corners (#668 C-06)
+            var placement = anchorPlacementFromEditAs(getWithFallback(anchor, ["a$.editAs"]));
             return {
                 sheetId: sheetId,
-                overlayPosition: {
-                    anchorCell: {
+                overlayPosition: __assign({ anchorCell: {
                         rowIndex: row + 1,
                         columnIndex: col + 1,
-                    },
-                    offsetXPixels: Math.round(colOff / 9525),
-                    offsetYPixels: Math.round(rowOff / 9525),
-                    widthPixels: width,
-                    heightPixels: height,
-                },
+                    }, offsetXPixels: Math.round(colOff / 9525), offsetYPixels: Math.round(rowOff / 9525), widthPixels: width, heightPixels: height }, (placement === "moveAndSize"
+                    ? {
+                        toCell: { rowIndex: toRow + 1, columnIndex: toCol + 1 },
+                        toOffsetXPixels: Math.round(toColOff / 9525),
+                        toOffsetYPixels: Math.round(toRowOff / 9525),
+                    }
+                    : { placement: placement })),
             };
         }
         return null;
@@ -1941,7 +2697,7 @@ var mapDataLabelPosition = function (val) {
     }
 };
 function extractDataLabelsOptions(plotArea, chartType) {
-    var e_22, _a;
+    var e_35, _a;
     var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
     // Look for <c:dLbls> inside the chartType-specific container. We pick
     // the first one we find — chart-level labels apply to all series.
@@ -1968,15 +2724,15 @@ function extractDataLabelsOptions(plotArea, chartType) {
     try {
         for (var keys_1 = __values(keys), keys_1_1 = keys_1.next(); !keys_1_1.done; keys_1_1 = keys_1.next()) {
             var key = keys_1_1.value;
-            container = container !== null && container !== void 0 ? container : get(plotArea, key);
+            container = container !== null && container !== void 0 ? container : firstGroup(get(plotArea, key));
         }
     }
-    catch (e_22_1) { e_22 = { error: e_22_1 }; }
+    catch (e_35_1) { e_35 = { error: e_35_1 }; }
     finally {
         try {
             if (keys_1_1 && !keys_1_1.done && (_a = keys_1.return)) _a.call(keys_1);
         }
-        finally { if (e_22) throw e_22.error; }
+        finally { if (e_35) throw e_35.error; }
     }
     var dLbls = (_e = (_d = (_c = get(container, "c:dLbls")) !== null && _c !== void 0 ? _c : get(container, "dLbls")) !== null && _d !== void 0 ? _d : get(plotArea, "c:dLbls")) !== null && _e !== void 0 ? _e : get(plotArea, "dLbls");
     if (!dLbls)
@@ -2024,7 +2780,7 @@ function extractDataLabelsOptions(plotArea, chartType) {
     return Object.keys(result).length ? result : undefined;
 }
 function readAxis(axis) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
     if (!axis)
         return undefined;
     var result = {};
@@ -2055,6 +2811,17 @@ function readAxis(axis) {
     var textFormat = extractTextProperties((_g = get(axis, "c:txPr")) !== null && _g !== void 0 ? _g : get(axis, "txPr"));
     if (textFormat)
         result.textFormat = textFormat;
+    // <c:numFmt formatCode="…" sourceLinked="0"/> — an explicit tick-label
+    // format. `sourceLinked="1"` (Excel's default) means the axis inherits
+    // the source cells' format, which the renderer resolves at draw time,
+    // so it is intentionally NOT copied into the spec.
+    var numFmt = (_h = get(axis, "c:numFmt.a$")) !== null && _h !== void 0 ? _h : get(axis, "numFmt.a$");
+    var formatCode = (_j = numFmt === null || numFmt === void 0 ? void 0 : numFmt.formatCode) !== null && _j !== void 0 ? _j : numFmt === null || numFmt === void 0 ? void 0 : numFmt.t$;
+    if (typeof formatCode === "string" &&
+        formatCode &&
+        !readBoolean(numFmt === null || numFmt === void 0 ? void 0 : numFmt.sourceLinked)) {
+        result.numberFormatPattern = formatCode;
+    }
     return Object.keys(result).length ? result : undefined;
 }
 export function extractAxisOptions(plotArea) {
@@ -2107,6 +2874,37 @@ function extractDoughnutHoleSize(plotArea) {
         return undefined;
     return Math.min(0.9, Math.max(0, holeSize / 100));
 }
+/**
+ * Exploded pie / doughnut — `<c:ser><c:explosion val="25"/>` is the
+ * slice offset as a percentage of the radius. Excel writes it on every
+ * series of an exploded chart; the spec keeps one chart-level value, so
+ * the largest authored explosion wins. Undefined when no series is
+ * exploded (Excel omits the element for a plain pie).
+ */
+function extractExplosion(plotArea, chartType) {
+    var e_36, _a;
+    var _b;
+    var sers = getSeriesElements(plotArea, chartType);
+    var list = Array.isArray(sers) ? sers : sers ? [sers] : [];
+    var explosion;
+    try {
+        for (var list_3 = __values(list), list_3_1 = list_3.next(); !list_3_1.done; list_3_1 = list_3.next()) {
+            var ser = list_3_1.value;
+            var value = readNumber((_b = get(ser, "c:explosion.a$.val")) !== null && _b !== void 0 ? _b : get(ser, "explosion.a$.val"));
+            if (typeof value === "number" && value > 0) {
+                explosion = Math.max(explosion !== null && explosion !== void 0 ? explosion : 0, value);
+            }
+        }
+    }
+    catch (e_36_1) { e_36 = { error: e_36_1 }; }
+    finally {
+        try {
+            if (list_3_1 && !list_3_1.done && (_a = list_3.return)) _a.call(list_3);
+        }
+        finally { if (e_36) throw e_36.error; }
+    }
+    return explosion;
+}
 // -------------------------- Phase 5.2 helpers --------------------------
 var mapTrendlineType = function (val) {
     switch (val) {
@@ -2126,7 +2924,7 @@ var mapTrendlineType = function (val) {
     }
 };
 function extractTrendlines(ser) {
-    var e_23, _a;
+    var e_37, _a;
     var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
     // <c:trendline> can appear multiple times under a single series; the
     // parser may surface either an array or a single object.
@@ -2136,8 +2934,8 @@ function extractTrendlines(ser) {
     var list = Array.isArray(raw) ? raw : [raw];
     var results = [];
     try {
-        for (var list_2 = __values(list), list_2_1 = list_2.next(); !list_2_1.done; list_2_1 = list_2.next()) {
-            var t = list_2_1.value;
+        for (var list_4 = __values(list), list_4_1 = list_4.next(); !list_4_1.done; list_4_1 = list_4.next()) {
+            var t = list_4_1.value;
             var type = mapTrendlineType((_c = get(t, "c:trendlineType.a$.val")) !== null && _c !== void 0 ? _c : get(t, "trendlineType.a$.val"));
             var order = readNumber((_d = get(t, "c:order.a$.val")) !== null && _d !== void 0 ? _d : get(t, "order.a$.val"));
             var period = readNumber((_e = get(t, "c:period.a$.val")) !== null && _e !== void 0 ? _e : get(t, "period.a$.val"));
@@ -2164,12 +2962,12 @@ function extractTrendlines(ser) {
             results.push(entry);
         }
     }
-    catch (e_23_1) { e_23 = { error: e_23_1 }; }
+    catch (e_37_1) { e_37 = { error: e_37_1 }; }
     finally {
         try {
-            if (list_2_1 && !list_2_1.done && (_a = list_2.return)) _a.call(list_2);
+            if (list_4_1 && !list_4_1.done && (_a = list_4.return)) _a.call(list_4);
         }
-        finally { if (e_23) throw e_23.error; }
+        finally { if (e_37) throw e_37.error; }
     }
     return results;
 }