@rowsncolumns/toolkit 24.4.4 → 24.5.0

package/dist/cjs/exporter/ods/ods-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ods-export.d.ts","sourceRoot":"","sources":["../../../../exporter/ods/ods-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,wBAAwB,EAMxB,SAAS,EAET,2BAA2B,EAC3B,QAAQ,EACT,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAGV,qBAAqB,EAErB,aAAa,EACb,cAAc,EAGd,UAAU,EACV,KAAK,EAGL,gBAAgB,EAChB,SAAS,EAGV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,4BAA4B,CAAC;AA+HzE,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,KAAK,EACf,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,QAAQ,IAChB;IACF,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,kBAAkB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC7C,eAAe,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;IAC1D,qBAAqB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1C,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AA+XF,eAAO,MAAM,aAAa,GACxB,CAAC,SAAS,KAAK,EACf,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,QAAQ,EAClB,qRAgBC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,yBA6JzB,CAAC"}
+{"version":3,"file":"ods-export.d.ts","sourceRoot":"","sources":["../../../../exporter/ods/ods-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,wBAAwB,EAMxB,SAAS,EAET,2BAA2B,EAC3B,QAAQ,EACT,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAGV,qBAAqB,EAErB,aAAa,EACb,cAAc,EAGd,UAAU,EAEV,KAAK,EAGL,gBAAgB,EAChB,SAAS,EAGV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,4BAA4B,CAAC;AA+HzE,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,KAAK,EACf,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,QAAQ,IAChB;IACF,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,kBAAkB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC7C,eAAe,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;IAC1D,qBAAqB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1C,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAiYF,eAAO,MAAM,aAAa,GACxB,CAAC,SAAS,KAAK,EACf,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,QAAQ,EAClB,qRAgBC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,yBA6JzB,CAAC"}

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

@@ -1753,6 +1753,18 @@ var buildNumberStyleXml = function (name, format) {
     if (!format)
         return "";
     var type = format.type;
+    // The authored pattern decides the symbol, its side, the decimals and the
+    // thousands separator (the same numeric grammar the chart axes convert);
+    // the per-type defaults below only cover a format without a pattern.
+    if (format.pattern &&
+        (type === "PERCENT" ||
+            type === "CURRENCY" ||
+            type === "ACCOUNTING" ||
+            type === "NUMBER")) {
+        var fromPattern = numericPatternToOdsStyle(name, format.pattern);
+        if (fromPattern)
+            return fromPattern;
+    }
     if (type === "PERCENT") {
         return "<number:percentage-style style:name=\"".concat(name, "\"><number:number number:min-integer-digits=\"1\" number:decimal-places=\"2\"/></number:percentage-style>");
     }
@@ -2392,39 +2404,68 @@ var buildNamedRangesXml = function (namedRanges, sheetNameById, namedRangeNames)
 };
 var buildFilterXml = function (filterSpecs, range, rows, headerRow, totalRow) {
     var e_22, _a, e_23, _b, e_24, _c;
-    var _d, _e, _f;
+    var _d, _e, _f, _g;
     if (headerRow === void 0) { headerRow = true; }
     if (totalRow === void 0) { totalRow = false; }
     if (!(filterSpecs === null || filterSpecs === void 0 ? void 0 : filterSpecs.length))
         return "";
     var conditions = [];
+    var filterConditionXml = function (columnIndex, mapped) {
+        var attrs = [
+            "table:field-number=\"".concat(columnIndex, "\""),
+            "table:operator=\"".concat(mapped.operator, "\""),
+        ];
+        if (mapped.value !== undefined) {
+            attrs.push("table:value=\"".concat(escapeXml(mapped.value), "\""));
+        }
+        if (mapped.value2 !== undefined) {
+            attrs.push("table:value2=\"".concat(escapeXml(mapped.value2), "\""));
+        }
+        return "<table:filter-condition ".concat(attrs.join(" "), "/>");
+    };
     try {
         for (var filterSpecs_1 = __values(filterSpecs), filterSpecs_1_1 = filterSpecs_1.next(); !filterSpecs_1_1.done; filterSpecs_1_1 = filterSpecs_1.next()) {
             var spec = filterSpecs_1_1.value;
             var criteria = spec.filterCriteria;
-            // A condition filter (greater-than / contains / between / blank / …) takes
-            // precedence over a value list, and is emitted as a single operator-based
-            // <table:filter-condition>. Otherwise fall back to value-list entries.
+            // A condition filter (greater-than / contains / between / blank / Top 10
+            // / …) takes precedence over a value list, and is emitted as an
+            // operator-based <table:filter-condition>. Excel's Custom AutoFilter
+            // second clause joins it inside <table:filter-or> (Or) or beside it in
+            // the enclosing <table:filter-and> (And). Otherwise fall back to
+            // value-list entries.
             var condition = criteria === null || criteria === void 0 ? void 0 : criteria.condition;
             var mapped = (condition === null || condition === void 0 ? void 0 : condition.type)
                 ? mapConditionToFilterCondition(condition.type, (_d = condition.values) !== null && _d !== void 0 ? _d : [])
                 : undefined;
             if (mapped) {
-                var attrs = [
-                    "table:field-number=\"".concat(spec.columnIndex, "\""),
-                    "table:operator=\"".concat(mapped.operator, "\""),
-                ];
-                if (mapped.value !== undefined) {
-                    attrs.push("table:value=\"".concat(escapeXml(mapped.value), "\""));
+                var first = filterConditionXml(spec.columnIndex, mapped);
+                var condition2 = criteria === null || criteria === void 0 ? void 0 : criteria.condition2;
+                var mapped2 = (condition2 === null || condition2 === void 0 ? void 0 : condition2.type)
+                    ? mapConditionToFilterCondition(condition2.type, (_e = condition2.values) !== null && _e !== void 0 ? _e : [])
+                    : undefined;
+                if (mapped2) {
+                    var second = filterConditionXml(spec.columnIndex, mapped2);
+                    conditions.push((criteria === null || criteria === void 0 ? void 0 : criteria.conditionJoin) === "OR"
+                        ? "<table:filter-or>".concat(first).concat(second, "</table:filter-or>")
+                        : "".concat(first).concat(second));
                 }
-                if (mapped.value2 !== undefined) {
-                    attrs.push("table:value2=\"".concat(escapeXml(mapped.value2), "\""));
+                else {
+                    if (condition2 === null || condition2 === void 0 ? void 0 : condition2.type) {
+                        conditions.push(unsupportedConditionComment(spec.columnIndex, condition2.type));
+                    }
+                    conditions.push(first);
                 }
-                conditions.push("<table:filter-condition ".concat(attrs.join(" "), "/>"));
                 continue;
             }
-            var visibleValues = (_e = criteria === null || criteria === void 0 ? void 0 : criteria.visibleValues) !== null && _e !== void 0 ? _e : getFilterVisibleValues(spec, range, rows, headerRow, totalRow);
-            var hiddenValues = (_f = criteria === null || criteria === void 0 ? void 0 : criteria.hiddenValues) !== null && _f !== void 0 ? _f : [];
+            if (condition === null || condition === void 0 ? void 0 : condition.type) {
+                // A criterion ODF cannot express (relative-date periods, above /
+                // below average, custom formulas): degrade explicitly instead of
+                // flattening the column into an all-values list.
+                conditions.push(unsupportedConditionComment(spec.columnIndex, condition.type));
+                continue;
+            }
+            var visibleValues = (_f = criteria === null || criteria === void 0 ? void 0 : criteria.visibleValues) !== null && _f !== void 0 ? _f : getFilterVisibleValues(spec, range, rows, headerRow, totalRow);
+            var hiddenValues = (_g = criteria === null || criteria === void 0 ? void 0 : criteria.hiddenValues) !== null && _g !== void 0 ? _g : [];
             try {
                 for (var visibleValues_1 = (e_23 = void 0, __values(visibleValues)), visibleValues_1_1 = visibleValues_1.next(); !visibleValues_1_1.done; visibleValues_1_1 = visibleValues_1.next()) {
                     var value = visibleValues_1_1.value;
@@ -2464,6 +2505,14 @@ var buildFilterXml = function (filterSpecs, range, rows, headerRow, totalRow) {
         return "";
     return "<table:filter><table:filter-and>".concat(conditions.join(""), "</table:filter-and></table:filter>");
 };
+/**
+ * An XML comment recording a criterion ODF has no shape for (a dynamic
+ * period such as DATE_THIS_MONTH, above/below average, a custom formula).
+ * Readers ignore it; the column exports with no criterion on that clause.
+ */
+var unsupportedConditionComment = function (columnIndex, type) {
+    return "<!-- rnc: ".concat(type.replace(/-/g, ""), " filter on field ").concat(columnIndex, " has no ODF equivalent; exported without that criterion -->");
+};
 var buildSortXml = function (sortSpecs) {
     if (!(sortSpecs === null || sortSpecs === void 0 ? void 0 : sortSpecs.length))
         return "";
@@ -2522,6 +2571,16 @@ var mapConditionToFilterCondition = function (type, values) {
             return { operator: "non-empty" };
         case "BOOLEAN":
             return { operator: "=", value: "TRUE" };
+        // Excel's "Top 10…" AutoFilter — ODF 1.2 `table:operator` has native
+        // top / bottom values / percent forms.
+        case "NUMBER_TOP_N":
+            return { operator: "top values", value: first !== null && first !== void 0 ? first : "" };
+        case "NUMBER_BOTTOM_N":
+            return { operator: "bottom values", value: first !== null && first !== void 0 ? first : "" };
+        case "NUMBER_TOP_PERCENT":
+            return { operator: "top percent", value: first !== null && first !== void 0 ? first : "" };
+        case "NUMBER_BOTTOM_PERCENT":
+            return { operator: "bottom percent", value: first !== null && first !== void 0 ? first : "" };
         default:
             return undefined;
     }
@@ -3221,6 +3280,7 @@ var groupEmbedsBySheet = function (embeds) {
                 offsetY: (_e = overlay.offsetYPixels) !== null && _e !== void 0 ? _e : 0,
                 width: (_f = overlay.widthPixels) !== null && _f !== void 0 ? _f : 120,
                 height: (_g = overlay.heightPixels) !== null && _g !== void 0 ? _g : 120,
+                overlay: overlay,
             };
             var list = (_h = result.get(embed.position.sheetId)) !== null && _h !== void 0 ? _h : [];
             list.push(placement);
@@ -3270,7 +3330,7 @@ var groupChartsBySheet = function (charts) {
     return result;
 };
 var buildEmbedFramesXml = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var frames, embeds_1, embeds_1_1, placement, dataUrl, buffer, mediaPath, widthPx, heightPx, offsetXPx, offsetYPx, width, height, origin_1, offsetX, offsetY, anchorRef, anchorCell, anchorAttr, endColumn, endRow, endRef, endCell, endCellAttr, endX, endY, e_32_1;
+    var frames, embeds_1, embeds_1_1, placement, dataUrl, buffer, mediaPath, widthPx, heightPx, offsetXPx, offsetYPx, width, height, origin_1, offsetX, offsetY, anchorRef, anchorCell, anchorAttr, endAttrs, e_32_1;
     var e_32, _c;
     var _d, _e, _f, _g;
     var embeds = _b.embeds, mediaEntries = _b.mediaEntries, sheetName = _b.sheetName, sheet = _b.sheet;
@@ -3319,29 +3379,17 @@ var buildEmbedFramesXml = function (_a) { return __awaiter(void 0, [_a], void 0,
                 anchorAttr = anchorCell
                     ? " table:anchor-cell-address=\"".concat(escapeXmlAddress(anchorCell), "\"")
                     : "";
-                endColumn = resolveAnchorEndpoint({
-                    startIndex: placement.columnIndex,
-                    startOffset: offsetXPx,
-                    span: widthPx,
-                    getSize: function (index) { return getColumnWidthPx(sheet, index); },
-                });
-                endRow = resolveAnchorEndpoint({
-                    startIndex: placement.rowIndex,
-                    startOffset: offsetYPx,
-                    span: heightPx,
-                    getSize: function (index) { return getRowHeightPx(sheet, index); },
-                });
-                endRef = cellToAddress({
-                    rowIndex: endRow.index,
-                    columnIndex: endColumn.index,
+                endAttrs = buildFrameEndCellAttrs({
+                    sheet: sheet,
+                    overlay: placement.overlay,
+                    rowIndex: placement.rowIndex,
+                    columnIndex: placement.columnIndex,
+                    offsetXPx: offsetXPx,
+                    offsetYPx: offsetYPx,
+                    widthPx: widthPx,
+                    heightPx: heightPx,
                 });
-                endCell = endRef !== null && endRef !== void 0 ? endRef : undefined;
-                endCellAttr = endCell
-                    ? " table:end-cell-address=\"".concat(escapeXmlAddress(endCell), "\"")
-                    : "";
-                endX = pxToCm(endColumn.offset).toFixed(2);
-                endY = pxToCm(endRow.offset).toFixed(2);
-                frames.push("<draw:frame draw:name=\"Image".concat(mediaEntries.length, "\" svg:width=\"").concat(width, "cm\" svg:height=\"").concat(height, "cm\" svg:x=\"").concat(offsetX, "cm\" svg:y=\"").concat(offsetY, "cm\" table:anchor-type=\"cell\"").concat(anchorAttr).concat(endCellAttr, " table:end-x=\"").concat(endX, "cm\" table:end-y=\"").concat(endY, "cm\"><draw:image xlink:href=\"").concat(mediaPath, "\" xlink:type=\"simple\" xlink:show=\"embed\" xlink:actuate=\"onLoad\"/></draw:frame>"));
+                frames.push("<draw:frame draw:name=\"Image".concat(mediaEntries.length, "\" svg:width=\"").concat(width, "cm\" svg:height=\"").concat(height, "cm\" svg:x=\"").concat(offsetX, "cm\" svg:y=\"").concat(offsetY, "cm\" table:anchor-type=\"cell\"").concat(anchorAttr).concat(endAttrs, "><draw:image xlink:href=\"").concat(mediaPath, "\" xlink:type=\"simple\" xlink:show=\"embed\" xlink:actuate=\"onLoad\"/></draw:frame>"));
                 _h.label = 4;
             case 4:
                 embeds_1_1 = embeds_1.next();
@@ -3417,6 +3465,46 @@ var getCellOriginPx = function (sheet, rowIndex, columnIndex) {
     }
     return { x: x, y: y };
 };
+/**
+ * `table:end-cell-address` + `table:end-x/y` for a frame — ODS's shape of
+ * Excel's "Move and size with cells": the persisted second anchor when the
+ * object carries one, else the cell its pixel extent reaches. ODS has no
+ * placement mode, so "Move but don't size" / "Don't move or size" frames
+ * degrade to a fixed-size cell-anchored frame (no end cell) — the closest
+ * ODS reading; the mode itself is not round-tripped through ODS (#668 C-06).
+ */
+var buildFrameEndCellAttrs = function (_a) {
+    var _b, _c, _d;
+    var sheet = _a.sheet, overlay = _a.overlay, rowIndex = _a.rowIndex, columnIndex = _a.columnIndex, offsetXPx = _a.offsetXPx, offsetYPx = _a.offsetYPx, widthPx = _a.widthPx, heightPx = _a.heightPx;
+    if (((_b = overlay === null || overlay === void 0 ? void 0 : overlay.placement) !== null && _b !== void 0 ? _b : "moveAndSize") !== "moveAndSize")
+        return "";
+    var endColumn = (overlay === null || overlay === void 0 ? void 0 : overlay.toCell)
+        ? { index: overlay.toCell.columnIndex, offset: (_c = overlay.toOffsetXPixels) !== null && _c !== void 0 ? _c : 0 }
+        : resolveAnchorEndpoint({
+            startIndex: columnIndex,
+            startOffset: offsetXPx,
+            span: widthPx,
+            getSize: function (index) { return getColumnWidthPx(sheet, index); },
+        });
+    var endRow = (overlay === null || overlay === void 0 ? void 0 : overlay.toCell)
+        ? { index: overlay.toCell.rowIndex, offset: (_d = overlay.toOffsetYPixels) !== null && _d !== void 0 ? _d : 0 }
+        : resolveAnchorEndpoint({
+            startIndex: rowIndex,
+            startOffset: offsetYPx,
+            span: heightPx,
+            getSize: function (index) { return getRowHeightPx(sheet, index); },
+        });
+    var endRef = cellToAddress({
+        rowIndex: endRow.index,
+        columnIndex: endColumn.index,
+    });
+    var endCellAttr = endRef
+        ? " table:end-cell-address=\"".concat(escapeXmlAddress(endRef), "\"")
+        : "";
+    var endX = pxToCm(endColumn.offset).toFixed(2);
+    var endY = pxToCm(endRow.offset).toFixed(2);
+    return "".concat(endCellAttr, " table:end-x=\"").concat(endX, "cm\" table:end-y=\"").concat(endY, "cm\"");
+};
 var resolveAnchorEndpoint = function (_a) {
     var startIndex = _a.startIndex, startOffset = _a.startOffset, span = _a.span, getSize = _a.getSize;
     var remaining = Math.max(0, span);
@@ -3437,8 +3525,14 @@ var resolveAnchorEndpoint = function (_a) {
     }
     return { index: index, offset: offset };
 };
+/** `ChartSpec.emptyCells` → ODF `chart:treat-empty-cells`. */
+var ODS_TREAT_EMPTY_CELLS = {
+    gaps: "leave-gap",
+    zero: "use-zero",
+    connect: "ignore",
+};
 var buildChartObjectXml = function (chart, sheetNameById) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g;
     var spec = chart.spec;
     var series = (_a = spec === null || spec === void 0 ? void 0 : spec.series) !== null && _a !== void 0 ? _a : [];
     if (!series.length)
@@ -3460,6 +3554,7 @@ var buildChartObjectXml = function (chart, sheetNameById) {
         column: "chart:bar",
         line: "chart:line",
         pie: "chart:circle",
+        doughnut: "chart:ring",
         scatter: "chart:scatter",
         area: "chart:area",
     };
@@ -3480,20 +3575,52 @@ var buildChartObjectXml = function (chart, sheetNameById) {
     var chartClass = isSurface
         ? "chart:surface"
         : ((_f = typeMap[spec.chartType]) !== null && _f !== void 0 ? _f : "chart:bar");
-    var plotStyleProps = threeDimensional
-        ? "<style:chart-properties chart:three-dimensional=\"true\"/>"
+    // Pie and doughnut (ODF `chart:ring`) share the slice model — no axes,
+    // walls or legend block, and the per-series slice offset.
+    var isCircular = chartClass === "chart:circle" || chartClass === "chart:ring";
+    // Excel's "Show empty cells as" has a native ODF shape on the plot-area
+    // style (`chart:treat-empty-cells`: leave-gap / use-zero / ignore, the
+    // last being "continue the line"); "Show #N/A as an empty cell" has none
+    // and degrades on ODS export.
+    var treatEmptyCells = ODS_TREAT_EMPTY_CELLS[String((_g = spec.emptyCells) !== null && _g !== void 0 ? _g : "")];
+    var plotChartProps = [
+        threeDimensional ? "chart:three-dimensional=\"true\"" : "",
+        treatEmptyCells ? "chart:treat-empty-cells=\"".concat(treatEmptyCells, "\"") : "",
+    ].filter(Boolean);
+    var plotStyleProps = plotChartProps.length
+        ? "<style:chart-properties ".concat(plotChartProps.join(" "), "/>")
         : "";
     var title = spec.title
         ? "<chart:title><text:p>".concat(escapeXml(String(spec.title)), "</text:p></chart:title>")
         : "";
-    var seriesPalette = [
-        "#4285f4",
-        "#ea4335",
-        "#fbbc04",
-        "#34a853",
-        "#ff6d01",
-        "#46bdc6",
-    ];
+    // Axis tick-label formats. Excel's explicit `<c:numFmt sourceLinked="0">`
+    // is an ODF data style on the axis style with the link to the source
+    // severed (`chart:link-data-style-to-source="false"`); without one the
+    // axis keeps ODF's default and stays linked to its source cells.
+    var axisStyle = function (name, options) {
+        var dataStyleName = "".concat(name, "N");
+        var pattern = options === null || options === void 0 ? void 0 : options.numberFormatPattern;
+        var numberStyle = typeof pattern === "string" && pattern.trim()
+            ? buildAxisNumberStyleXml(dataStyleName, pattern)
+            : undefined;
+        var dataStyleAttr = numberStyle
+            ? " style:data-style-name=\"".concat(dataStyleName, "\"")
+            : "";
+        var linkAttr = numberStyle
+            ? " chart:link-data-style-to-source=\"false\""
+            : "";
+        return {
+            numberStyle: numberStyle !== null && numberStyle !== void 0 ? numberStyle : "",
+            style: "<style:style style:name=\"".concat(name, "\" style:family=\"chart\"").concat(dataStyleAttr, "><style:chart-properties chart:display-label=\"true\" chart:tick-marks-major-inner=\"false\" chart:tick-marks-major-outer=\"true\"").concat(linkAttr, "/><style:graphic-properties svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"9pt\"/></style:style>"),
+        };
+    };
+    var axisX = axisStyle("axisx", spec.categoryAxisOptions);
+    var axisY = axisStyle("axisy", spec.valueAxisOptions);
+    // Change Colors palette when set (ODF has no chart-style id — it
+    // degrades to the resolved series colours); else the default cycle.
+    var seriesPalette = Array.isArray(spec.palette) && spec.palette.length > 0
+        ? spec.palette
+        : ["#4285f4", "#ea4335", "#fbbc04", "#34a853", "#ff6d01", "#46bdc6"];
     // Series chart styles + (optional) gradient defs. When a series
     // carries an explicit gradient we emit a `<draw:gradient>` def
     // alongside it and reference the def via `draw:fill-gradient-name`
@@ -3501,6 +3628,14 @@ var buildChartObjectXml = function (chart, sheetNameById) {
     // for `draw:angle` (so a 90° XLSX gradient is `900` here) and
     // `linear` / `radial` for the two flavors we round-trip.
     var gradientDefs = [];
+    // Exploded pie / doughnut — ODF keeps the slice offset on the series
+    // style (`chart:pie-offset`, a percentage of the radius) like OOXML's
+    // per-series `<c:explosion>`.
+    var explosion = isCircular &&
+        typeof spec.explosion === "number" &&
+        spec.explosion > 0
+        ? "<style:chart-properties chart:pie-offset=\"".concat(Math.round(spec.explosion), "\"/>")
+        : "";
     var seriesStyles = seriesRanges
         .map(function (_range, index) {
         var _a, _b, _c, _d, _e, _f;
@@ -3527,10 +3662,10 @@ var buildChartObjectXml = function (chart, sheetNameById) {
                 var angle = Math.round(((_f = gradient.degree) !== null && _f !== void 0 ? _f : 0) * 10);
                 gradientDefs.push("<draw:gradient draw:name=\"".concat(gradName, "\" draw:style=\"linear\" draw:start-color=\"").concat(startColor, "\" draw:end-color=\"").concat(endColor, "\" draw:start-intensity=\"100%\" draw:end-intensity=\"100%\" draw:angle=\"").concat(angle, "\"/>"));
             }
-            return "<style:style style:name=\"series".concat(index, "\" style:family=\"chart\"><style:graphic-properties svg:stroke-color=\"").concat(startColor, "\" svg:stroke-width=\"0.08cm\" draw:fill=\"gradient\" draw:fill-gradient-name=\"").concat(gradName, "\"/></style:style>");
+            return "<style:style style:name=\"series".concat(index, "\" style:family=\"chart\">").concat(explosion, "<style:graphic-properties svg:stroke-color=\"").concat(startColor, "\" svg:stroke-width=\"0.08cm\" draw:fill=\"gradient\" draw:fill-gradient-name=\"").concat(gradName, "\"/></style:style>");
         }
         var fillColor = (seriesData === null || seriesData === void 0 ? void 0 : seriesData.color) || color;
-        return "<style:style style:name=\"series".concat(index, "\" style:family=\"chart\"><style:graphic-properties svg:stroke-color=\"").concat(fillColor, "\" svg:stroke-width=\"0.08cm\" draw:fill=\"none\"/></style:style>");
+        return "<style:style style:name=\"series".concat(index, "\" style:family=\"chart\">").concat(explosion, "<style:graphic-properties svg:stroke-color=\"").concat(fillColor, "\" svg:stroke-width=\"0.08cm\" draw:fill=\"none\"/></style:style>");
     })
         .join("");
     var gradientDefsXml = gradientDefs.join("");
@@ -3553,7 +3688,7 @@ var buildChartObjectXml = function (chart, sheetNameById) {
         return "<chart:series chart:class=\"".concat(chartClass, "\" chart:style-name=\"series").concat(index, "\" chart:values-cell-range-address=\"").concat(escapeXmlAddress(range), "\"").concat(labelAttr, ">").concat(pointsXml, "</chart:series>");
     })
         .join("");
-    var axisXml = chartClass === "chart:circle"
+    var axisXml = isCircular
         ? ""
         : "<chart:axis chart:dimension=\"x\" chart:name=\"primary-x\" chart:style-name=\"axisx\"><chart:title/></chart:axis><chart:axis chart:dimension=\"y\" chart:name=\"primary-y\" chart:style-name=\"axisy\"><chart:title/></chart:axis>";
     var categoriesAttr = domainRange
@@ -3561,14 +3696,66 @@ var buildChartObjectXml = function (chart, sheetNameById) {
         : "";
     var labelMode = domainRange ? "both" : hasSeriesLabels ? "row" : "none";
     var plotAreaAttrs = " chart:data-source-has-labels=\"".concat(labelMode, "\"").concat(categoriesAttr);
-    var wallFloor = chartClass === "chart:circle"
+    var wallFloor = isCircular
         ? ""
         : "<chart:wall chart:style-name=\"wall1\"/><chart:floor chart:style-name=\"floor1\"/>";
-    var legendXml = chartClass === "chart:circle"
+    var legendXml = isCircular
         ? ""
         : "<chart:legend chart:legend-position=\"end\" chart:legend-align=\"center\" chart:style-name=\"legend1\"/>";
-    return "".concat(XML_DECLARATION, "<office:document-content xmlns:office=\"").concat(ODS_NS.office, "\" xmlns:chart=\"").concat(ODS_NS.chart, "\" xmlns:table=\"").concat(ODS_NS.table, "\" xmlns:text=\"").concat(ODS_NS.text, "\" xmlns:style=\"").concat(ODS_NS.style, "\" xmlns:draw=\"").concat(ODS_NS.draw, "\" xmlns:svg=\"").concat(ODS_NS.svg, "\" xmlns:fo=\"").concat(ODS_NS.fo, "\" office:version=\"1.2\"><office:automatic-styles>").concat(gradientDefsXml, "<style:style style:name=\"ch1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\"/></style:style><style:style style:name=\"plot1\" style:family=\"chart\">").concat(plotStyleProps, "<style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\" svg:stroke-color=\"#b3b3b3\"/></style:style><style:style style:name=\"wall1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\" svg:stroke-color=\"#b3b3b3\" svg:stroke-width=\"0.01cm\"/></style:style><style:style style:name=\"floor1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"none\" svg:stroke-color=\"#b3b3b3\"/></style:style><style:style style:name=\"legend1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"none\" svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"10pt\"/></style:style><style:style style:name=\"axisx\" style:family=\"chart\"><style:chart-properties chart:display-label=\"true\" chart:tick-marks-major-inner=\"false\" chart:tick-marks-major-outer=\"true\"/><style:graphic-properties svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"9pt\"/></style:style><style:style style:name=\"axisy\" style:family=\"chart\"><style:chart-properties chart:display-label=\"true\" chart:tick-marks-major-inner=\"false\" chart:tick-marks-major-outer=\"true\"/><style:graphic-properties svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"9pt\"/></style:style>").concat(seriesStyles, "</office:automatic-styles><office:body><office:chart><chart:chart chart:class=\"").concat(chartClass, "\" chart:style-name=\"ch1\">").concat(title).concat(legendXml, "<chart:plot-area chart:style-name=\"plot1\"").concat(plotAreaAttrs, ">").concat(axisXml).concat(seriesXml).concat(wallFloor, "</chart:plot-area></chart:chart></office:chart></office:body></office:document-content>");
+    return "".concat(XML_DECLARATION, "<office:document-content xmlns:office=\"").concat(ODS_NS.office, "\" xmlns:chart=\"").concat(ODS_NS.chart, "\" xmlns:table=\"").concat(ODS_NS.table, "\" xmlns:text=\"").concat(ODS_NS.text, "\" xmlns:style=\"").concat(ODS_NS.style, "\" xmlns:draw=\"").concat(ODS_NS.draw, "\" xmlns:svg=\"").concat(ODS_NS.svg, "\" xmlns:fo=\"").concat(ODS_NS.fo, "\" xmlns:number=\"").concat(ODS_NS.number, "\" office:version=\"1.2\"><office:automatic-styles>").concat(axisX.numberStyle).concat(axisY.numberStyle).concat(gradientDefsXml, "<style:style style:name=\"ch1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\"/></style:style><style:style style:name=\"plot1\" style:family=\"chart\">").concat(plotStyleProps, "<style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\" svg:stroke-color=\"#b3b3b3\"/></style:style><style:style style:name=\"wall1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"solid\" draw:fill-color=\"#ffffff\" svg:stroke-color=\"#b3b3b3\" svg:stroke-width=\"0.01cm\"/></style:style><style:style style:name=\"floor1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"none\" svg:stroke-color=\"#b3b3b3\"/></style:style><style:style style:name=\"legend1\" style:family=\"chart\"><style:graphic-properties draw:fill=\"none\" svg:stroke-color=\"#b3b3b3\"/><style:text-properties fo:font-size=\"10pt\"/></style:style>").concat(axisX.style).concat(axisY.style).concat(seriesStyles, "</office:automatic-styles><office:body><office:chart><chart:chart chart:class=\"").concat(chartClass, "\" chart:style-name=\"ch1\">").concat(title).concat(legendXml, "<chart:plot-area chart:style-name=\"plot1\"").concat(plotAreaAttrs, ">").concat(axisXml).concat(seriesXml).concat(wallFloor, "</chart:plot-area></chart:chart></office:chart></office:body></office:document-content>");
 };
+/**
+ * A numeric format pattern as an ODF data style — shared by cell number
+ * formats and the chart axes' tick-label patterns. Only the numeric grammar
+ * converts — digit placeholders, grouping, decimals, `%`, and a quoted /
+ * bare currency literal before or after the digits (as a
+ * `number:currency-style`; whitespace between the symbol and the digits is
+ * kept as a `number:text` so `€ #,##0.00` and `€#,##0.00` stay distinct).
+ * Dates, fractions, scientific and text patterns have no shape the ODS
+ * parser reads back, so they return `undefined` and the caller degrades
+ * (the axis stays linked to its source, a cell falls back to its type's
+ * default style — both stated in the compatibility table).
+ */
+var numericPatternToOdsStyle = function (name, pattern) {
+    var _a;
+    // The first (positive) section; a `[$€-2]` currency token keeps its symbol
+    // as a literal, the other bracket tokens (colours, conditions) drop.
+    var section = pattern
+        .split(";")[0]
+        .replace(/\[\$([^\]-]*)(?:-[^\]]*)?\]/g, '"$1"')
+        .replace(/\[[^\]]*\]/g, "")
+        .trim();
+    var match = section.match(/^((?:"[^"]*"|\\.|[^#0?.,%"\\])*)([#0?][#0?,]*(?:\.[#0?]+)?)((?:"[^"]*"|\\.|[^#0?"\\])*)$/);
+    if (!match)
+        return undefined;
+    var unquote = function (literal) {
+        return literal.replace(/"([^"]*)"/g, "$1").replace(/\\(.)/g, "$1");
+    };
+    var rawPrefix = unquote(match[1]);
+    var rawSuffix = unquote(match[3]);
+    var prefix = rawPrefix.trim();
+    var digits = match[2];
+    var suffix = rawSuffix.trim();
+    var _b = __read(digits.split("."), 2), _c = _b[0], integerPart = _c === void 0 ? "" : _c, _d = _b[1], fractionPart = _d === void 0 ? "" : _d;
+    var numberXml = "<number:number number:min-integer-digits=\"".concat(((_a = integerPart.match(/0/g)) !== null && _a !== void 0 ? _a : []).length, "\" number:decimal-places=\"").concat(fractionPart.length, "\" number:grouping=\"").concat(integerPart.includes(","), "\"/>");
+    if (suffix.includes("%")) {
+        return "<number:percentage-style style:name=\"".concat(name, "\">").concat(numberXml, "<number:text>%</number:text></number:percentage-style>");
+    }
+    var gap = function (literal) {
+        return /\s$/.test(literal) || /^\s/.test(literal)
+            ? "<number:text> </number:text>"
+            : "";
+    };
+    if (prefix) {
+        return "<number:currency-style style:name=\"".concat(name, "\"><number:currency-symbol>").concat(escapeXml(prefix), "</number:currency-symbol>").concat(gap(rawPrefix)).concat(numberXml, "</number:currency-style>");
+    }
+    if (suffix) {
+        return "<number:currency-style style:name=\"".concat(name, "\">").concat(numberXml).concat(gap(rawSuffix), "<number:currency-symbol>").concat(escapeXml(suffix), "</number:currency-symbol></number:currency-style>");
+    }
+    return "<number:number-style style:name=\"".concat(name, "\">").concat(numberXml, "</number:number-style>");
+};
+/** A chart axis' explicit tick-label pattern as an ODF data style (see `numericPatternToOdsStyle`). */
+var buildAxisNumberStyleXml = numericPatternToOdsStyle;
 var buildChartRangeAddress = function (range, sheetNameById) {
     var sheetName = sheetNameById.get(range.sheetId);
     if (!sheetName)
@@ -3620,11 +3807,11 @@ var buildChartLabelAddressFromRange = function (range, sheetNameById) {
     return "".concat(escapeSheetName(sheetName), ".").concat(labelRef);
 };
 var buildChartFramesXml = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
-    var frames, chartObjects, index, charts_1, charts_1_1, placement, chartXml, folder, widthPx, heightPx, offsetXPx, offsetYPx, width, height, origin_2, offsetX, offsetY, anchorRef, anchorCell, anchorAttr, endColumn, endRow, endRef, endCell, endCellAttr, endX, endY;
+    var frames, chartObjects, index, charts_1, charts_1_1, placement, chartXml, folder, widthPx, heightPx, offsetXPx, offsetYPx, width, height, origin_2, offsetX, offsetY, anchorRef, anchorCell, anchorAttr, endAttrs;
     var e_33, _c;
-    var _d, _e, _f, _g;
+    var _d, _e, _f, _g, _h;
     var charts = _b.charts, sheet = _b.sheet, sheetName = _b.sheetName, sheetNameById = _b.sheetNameById, startIndex = _b.startIndex;
-    return __generator(this, function (_h) {
+    return __generator(this, function (_j) {
         if (!charts.length) {
             return [2 /*return*/, { frames: [], chartObjects: [], nextIndex: startIndex }];
         }
@@ -3656,29 +3843,17 @@ var buildChartFramesXml = function (_a) { return __awaiter(void 0, [_a], void 0,
                 anchorAttr = anchorCell
                     ? " table:anchor-cell-address=\"".concat(escapeXmlAddress(anchorCell), "\"")
                     : "";
-                endColumn = resolveAnchorEndpoint({
-                    startIndex: placement.columnIndex,
-                    startOffset: offsetXPx,
-                    span: widthPx,
-                    getSize: function (index) { return getColumnWidthPx(sheet, index); },
-                });
-                endRow = resolveAnchorEndpoint({
-                    startIndex: placement.rowIndex,
-                    startOffset: offsetYPx,
-                    span: heightPx,
-                    getSize: function (index) { return getRowHeightPx(sheet, index); },
-                });
-                endRef = cellToAddress({
-                    rowIndex: endRow.index,
-                    columnIndex: endColumn.index,
+                endAttrs = buildFrameEndCellAttrs({
+                    sheet: sheet,
+                    overlay: (_h = placement.chart.position) === null || _h === void 0 ? void 0 : _h.overlayPosition,
+                    rowIndex: placement.rowIndex,
+                    columnIndex: placement.columnIndex,
+                    offsetXPx: offsetXPx,
+                    offsetYPx: offsetYPx,
+                    widthPx: widthPx,
+                    heightPx: heightPx,
                 });
-                endCell = endRef !== null && endRef !== void 0 ? endRef : undefined;
-                endCellAttr = endCell
-                    ? " table:end-cell-address=\"".concat(escapeXmlAddress(endCell), "\"")
-                    : "";
-                endX = pxToCm(endColumn.offset).toFixed(2);
-                endY = pxToCm(endRow.offset).toFixed(2);
-                frames.push("<draw:frame draw:name=\"Chart".concat(index, "\" svg:width=\"").concat(width, "cm\" svg:height=\"").concat(height, "cm\" svg:x=\"").concat(offsetX, "cm\" svg:y=\"").concat(offsetY, "cm\" table:anchor-type=\"cell\"").concat(anchorAttr).concat(endCellAttr, " table:end-x=\"").concat(endX, "cm\" table:end-y=\"").concat(endY, "cm\"><draw:object xlink:href=\"").concat(folder, "\" xlink:type=\"simple\"/></draw:frame>"));
+                frames.push("<draw:frame draw:name=\"Chart".concat(index, "\" svg:width=\"").concat(width, "cm\" svg:height=\"").concat(height, "cm\" svg:x=\"").concat(offsetX, "cm\" svg:y=\"").concat(offsetY, "cm\" table:anchor-type=\"cell\"").concat(anchorAttr).concat(endAttrs, "><draw:object xlink:href=\"").concat(folder, "\" xlink:type=\"simple\"/></draw:frame>"));
                 index += 1;
             }
         }

package/dist/cjs/exporter/xlsx/chart-builder.d.ts

@@ -1,3 +1,9 @@
 import type { EmbeddedChart } from "@rowsncolumns/spreadsheet";
-export declare const buildChartXml: (chart: EmbeddedChart, sheetNameById: Map<number, string>) => string | undefined;
+/**
+ * Resolves a chart's `pivotTableId` to the `<c:pivotSource><c:name>` Excel
+ * expects (`[Workbook]Sheet!PivotTable1`); `undefined` when the pivot is
+ * not exported, in which case the chart is written as a plain chart.
+ */
+export type ResolvePivotSourceName = (pivotTableId: string | number) => string | undefined;
+export declare const buildChartXml: (input: EmbeddedChart, sheetNameById: Map<number, string>, resolvePivotSourceName?: ResolvePivotSourceName) => string | undefined;
 //# sourceMappingURL=chart-builder.d.ts.map

package/dist/cjs/exporter/xlsx/chart-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/chart-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EAEd,MAAM,2BAA2B,CAAC;AAovCnC,eAAO,MAAM,aAAa,GACxB,OAAO,aAAa,EACpB,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,MAAM,GAAG,SA+lBX,CAAC"}
+{"version":3,"file":"chart-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/chart-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,aAAa,EAEd,MAAM,2BAA2B,CAAC;AA63CnC;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,YAAY,EAAE,MAAM,GAAG,MAAM,KAC1B,MAAM,GAAG,SAAS,CAAC;AAExB,eAAO,MAAM,aAAa,GACxB,OAAO,aAAa,EACpB,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,yBAAyB,sBAAsB,KAC9C,MAAM,GAAG,SAqqBX,CAAC"}