@rowsncolumns/toolkit 24.4.2 → 24.4.4

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,SAsnBX,CAAC"}
+{"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"}

package/dist/cjs/exporter/xlsx/chart-builder.js

@@ -1053,7 +1053,7 @@ var buildDoughnutChart = function (domainRef, valueRef, title, subtitle) {
 };
 export var buildChartXml = function (chart, sheetNameById) {
     var e_3, _a, e_4, _b, e_5, _c;
-    var _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10;
+    var _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8;
     var series = (_e = (_d = chart.spec) === null || _d === void 0 ? void 0 : _d.series) !== null && _e !== void 0 ? _e : [];
     if (!series.length)
         return undefined;
@@ -1093,7 +1093,7 @@ export var buildChartXml = function (chart, sheetNameById) {
         try {
             // Add chart type containers for each group
             for (var groups_1 = __values(groups), groups_1_1 = groups_1.next(); !groups_1_1.done; groups_1_1 = groups_1.next()) {
-                var _11 = __read(groups_1_1.value, 2), groupType = _11[0], groupSeries = _11[1];
+                var _9 = __read(groups_1_1.value, 2), groupType = _9[0], groupSeries = _9[1];
                 if (groupType === "bar" || groupType === "column") {
                     var barChartNode = {
                         "c:barDir": { a$: { val: groupType === "bar" ? "bar" : "col" } },
@@ -1104,7 +1104,7 @@ export var buildChartXml = function (chart, sheetNameById) {
                         "c:axId": axisIds,
                     };
                     for (var i = 0; i < groupSeries.length; i++) {
-                        var _12 = groupSeries[i], index = _12.index, ref = _12.ref, data = _12.data;
+                        var _10 = groupSeries[i], index = _10.index, ref = _10.ref, data = _10.data;
                         var seriesNode = buildBarSeriesNode(index, ref, data, (_o = seriesCatRefs[index]) !== null && _o !== void 0 ? _o : domainRef, sheetName, i === 0);
                         barChartNode["c:ser"].push(seriesNode);
                     }
@@ -1120,7 +1120,7 @@ export var buildChartXml = function (chart, sheetNameById) {
                     };
                     try {
                         for (var groupSeries_1 = (e_4 = void 0, __values(groupSeries)), groupSeries_1_1 = groupSeries_1.next(); !groupSeries_1_1.done; groupSeries_1_1 = groupSeries_1.next()) {
-                            var _13 = groupSeries_1_1.value, index = _13.index, ref = _13.ref, data = _13.data;
+                            var _11 = groupSeries_1_1.value, index = _11.index, ref = _11.ref, data = _11.data;
                             var seriesNode = buildLineSeriesNode(index, ref, data, (_p = seriesCatRefs[index]) !== null && _p !== void 0 ? _p : domainRef, sheetName, smooth);
                             lineChartNode["c:ser"].push(seriesNode);
                         }
@@ -1144,7 +1144,7 @@ export var buildChartXml = function (chart, sheetNameById) {
                     };
                     try {
                         for (var groupSeries_2 = (e_5 = void 0, __values(groupSeries)), groupSeries_2_1 = groupSeries_2.next(); !groupSeries_2_1.done; groupSeries_2_1 = groupSeries_2.next()) {
-                            var _14 = groupSeries_2_1.value, index = _14.index, ref = _14.ref, data = _14.data;
+                            var _12 = groupSeries_2_1.value, index = _12.index, ref = _12.ref, data = _12.data;
                             var seriesNode = buildAreaSeriesNode(index, ref, data, (_q = seriesCatRefs[index]) !== null && _q !== void 0 ? _q : domainRef, sheetName);
                             areaChartNode["c:ser"].push(seriesNode);
                         }
@@ -1529,34 +1529,6 @@ export var buildChartXml = function (chart, sheetNameById) {
         targetChart["c:ser"] = seriesContainer_5;
         chartSpace["c:chartSpace"]["c:chart"] = chartDoc;
     }
-    else if (chartType === "treemap" || chartType === "sunburst") {
-        var treeSpec = chart.spec;
-        var labelRef = formatRangeRef(getPrimarySource((_9 = treeSpec.labels) === null || _9 === void 0 ? void 0 : _9[0]), sheetNameById);
-        var sizeRef = formatRangeRef(getPrimarySource((_10 = treeSpec.sizeData) === null || _10 === void 0 ? void 0 : _10[0]), sheetNameById);
-        if (!labelRef || !sizeRef)
-            return undefined;
-        if (chartType === "sunburst") {
-            var pieChart = buildPieChart(labelRef, sizeRef, chartTitle, chartSubtitle);
-            chartSpace["c:chartSpace"]["c:chart"] = pieChart;
-        }
-        else {
-            var columnChart = cloneTemplate(column_json);
-            applyChartTitle(columnChart, chartTitle, chartTitleFmt, chartSubtitle);
-            var bar = columnChart["c:plotArea"]["c:barChart"];
-            var seriesContainer = bar["c:ser"];
-            var seriesNode = cloneTemplate(column_series);
-            seriesNode["c:idx"] = { a$: { val: "0" } };
-            seriesNode["c:order"] = { a$: { val: "0" } };
-            seriesNode["c:cat"] = {
-                "c:strRef": {
-                    "c:f": labelRef,
-                },
-            };
-            seriesNode["c:val"]["c:numRef"]["c:f"] = sizeRef;
-            seriesContainer.push(seriesNode);
-            chartSpace["c:chartSpace"]["c:chart"] = columnChart;
-        }
-    }
     else {
         return undefined;
     }
@@ -1565,6 +1537,12 @@ export var buildChartXml = function (chart, sheetNameById) {
     // chartType-agnostic and intentionally run last so per-type branches
     // don't have to know about them.
     applyChartFormatting(chartSpace, chart.spec, sheetNameById);
+    // 3-D / surface variants (sourceChartType BAR_3D, LINE_3D, PIE_3D,
+    // AREA_3D, SURFACE, SURFACE_3D) — swap the 2-D chart group for its
+    // OOXML 3-D element and add `<c:view3D>`. Runs after the formatting
+    // pass so data labels / overlays land in the container first and are
+    // carried across by the rename.
+    applyThreeDChartType(chartSpace["c:chartSpace"]["c:chart"], chart.spec.sourceChartType);
     // `<c:roundedCorners val="1"/>` lives at the chartSpace root (sibling
     // of `<c:chart>`). Default per OOXML §21.2.2.183 is `false`; only
     // emit when the spec opted in so files imported without the element
@@ -1575,6 +1553,204 @@ export var buildChartXml = function (chart, sheetNameById) {
     var xml = chartBuilder.build(chartSpace);
     return "".concat(XML_DECLARATION).concat(xml);
 };
+// -------------------------- 3-D / surface --------------------------
+/** Series-axis id for the 3-D chart groups that take a third axis. */
+var SER_AX_ID = "1789284465";
+/**
+ * How each 3-D class maps onto its 2-D chart group: which container it
+ * replaces, the element it becomes, and how many `<c:axId>` refs the
+ * schema wants (0 = no axes, 3 = adds a series axis).
+ */
+var THREE_D_CHART_GROUPS = {
+    BAR_3D: { from: "c:barChart", to: "c:bar3DChart", axes: 2 },
+    LINE_3D: { from: "c:lineChart", to: "c:line3DChart", axes: 3 },
+    PIE_3D: { from: "c:pieChart", to: "c:pie3DChart", axes: 0 },
+    AREA_3D: { from: "c:areaChart", to: "c:area3DChart", axes: 2 },
+    SURFACE: { from: "c:areaChart", to: "c:surfaceChart", axes: 2 },
+    SURFACE_3D: { from: "c:areaChart", to: "c:surface3DChart", axes: 3 },
+};
+var normalizeThreeDToken = function (value) {
+    if (typeof value !== "string")
+        return undefined;
+    var token = value.trim().toUpperCase();
+    return token in THREE_D_CHART_GROUPS ? token : undefined;
+};
+/** Copy `keys` (in order) from `source` into `target`, skipping absent ones. */
+var pickKeys = function (target, source, keys) {
+    var e_6, _a;
+    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;
+            if (source[key] !== undefined)
+                target[key] = source[key];
+        }
+    }
+    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    finally {
+        try {
+            if (keys_1_1 && !keys_1_1.done && (_a = keys_1.return)) _a.call(keys_1);
+        }
+        finally { if (e_6) throw e_6.error; }
+    }
+};
+/**
+ * Rebuild the 2-D chart group as its 3-D element with the CT_*3DChart
+ * child sequence. Element order matters to Excel, so each shape is
+ * written out explicitly rather than renaming the key in place:
+ *   bar3DChart:     barDir, grouping, varyColors, ser, dLbls, gapWidth, shape, axId
+ *   line3DChart:    grouping, varyColors, ser, dLbls, axId×3
+ *   pie3DChart:     varyColors, ser, dLbls
+ *   area3DChart:    grouping, varyColors, ser, dLbls, axId
+ *   surfaceChart:   wireframe, ser, axId          (surface3DChart: axId×3)
+ */
+var buildThreeDChartGroup = function (token, group, axIds) {
+    var node = {};
+    switch (token) {
+        case "BAR_3D":
+            pickKeys(node, group, ["c:barDir", "c:grouping", "c:varyColors"]);
+            pickKeys(node, group, ["c:ser", "c:dLbls", "c:gapWidth"]);
+            node["c:shape"] = { a$: { val: "box" } };
+            node["c:axId"] = axIds;
+            return node;
+        case "LINE_3D":
+        case "AREA_3D":
+            pickKeys(node, group, ["c:grouping", "c:varyColors", "c:ser", "c:dLbls"]);
+            node["c:axId"] = axIds;
+            return node;
+        case "PIE_3D":
+            pickKeys(node, group, ["c:varyColors", "c:ser", "c:dLbls"]);
+            return node;
+        case "SURFACE":
+        case "SURFACE_3D":
+            node["c:wireframe"] = { a$: { val: "0" } };
+            pickKeys(node, group, ["c:ser"]);
+            node["c:axId"] = axIds;
+            return node;
+    }
+};
+/** `<c:serAx>` for the 3-D groups whose schema takes a third (depth) axis. */
+var buildSerAxNode = function (valAxId) { return ({
+    "c:axId": { a$: { val: SER_AX_ID } },
+    "c:scaling": { "c:orientation": { a$: { val: "minMax" } } },
+    "c:delete": { a$: { val: "0" } },
+    "c:axPos": { a$: { val: "b" } },
+    "c:majorTickMark": { a$: { val: "out" } },
+    "c:minorTickMark": { a$: { val: "none" } },
+    "c:tickLblPos": { a$: { val: "nextTo" } },
+    "c:crossAx": { a$: { val: valAxId } },
+    "c:crosses": { a$: { val: "autoZero" } },
+}); };
+/** `<c:view3D>` — Excel's default camera for each class (CT_View3D order). */
+var buildView3DNode = function (token) {
+    if (token === "PIE_3D") {
+        return {
+            "c:rotX": { a$: { val: "30" } },
+            "c:rotY": { a$: { val: "0" } },
+            "c:rAngAx": { a$: { val: "0" } },
+        };
+    }
+    if (token === "SURFACE" || token === "SURFACE_3D") {
+        // Right-angle axes are not allowed on surfaces; use a perspective view.
+        return {
+            "c:rotX": { a$: { val: "15" } },
+            "c:rotY": { a$: { val: "20" } },
+            "c:rAngAx": { a$: { val: "0" } },
+            "c:perspective": { a$: { val: "30" } },
+        };
+    }
+    return {
+        "c:rotX": { a$: { val: "15" } },
+        "c:rotY": { a$: { val: "20" } },
+        "c:rAngAx": { a$: { val: "1" } },
+    };
+};
+/**
+ * Turn an assembled 2-D `<c:chart>` into its 3-D variant when the spec
+ * carries a 3-D `sourceChartType`: the chart group is swapped for the
+ * matching `c:*3DChart` / `c:surfaceChart` element, a `<c:serAx>` is
+ * added where the schema takes three axes, and `<c:view3D>` is inserted
+ * before `<c:plotArea>`. No-op for 2-D specs or when the token doesn't
+ * match the emitted chart group (the 2-D chart is left untouched).
+ */
+var applyThreeDChartType = function (chartNode, sourceChartType) {
+    var e_7, _a, e_8, _b, e_9, _c;
+    var _d, _e, _f, _g, _h, _j;
+    var token = normalizeThreeDToken(sourceChartType);
+    if (!token || !chartNode)
+        return;
+    var plotArea = chartNode["c:plotArea"];
+    if (!plotArea)
+        return;
+    var _k = THREE_D_CHART_GROUPS[token], from = _k.from, to = _k.to, axes = _k.axes;
+    var group = plotArea[from];
+    if (!group || Array.isArray(group))
+        return;
+    var existingAxIds = Array.isArray(group["c:axId"])
+        ? group["c:axId"]
+        : group["c:axId"]
+            ? [group["c:axId"]]
+            : [];
+    var valAxId = (_j = (_f = (_e = (_d = existingAxIds[1]) === null || _d === void 0 ? void 0 : _d.a$) === null || _e === void 0 ? void 0 : _e.val) !== null && _f !== void 0 ? _f : (_h = (_g = existingAxIds[0]) === null || _g === void 0 ? void 0 : _g.a$) === null || _h === void 0 ? void 0 : _h.val) !== null && _j !== void 0 ? _j : "0";
+    var axIds = axes === 3
+        ? __spreadArray(__spreadArray([], __read(existingAxIds.slice(0, 2)), false), [{ a$: { val: SER_AX_ID } }], false) : existingAxIds.slice(0, 2);
+    // Rebuild plotArea preserving element order, swapping the chart group
+    // and appending the series axis after the value axis when needed.
+    var rebuiltPlotArea = {};
+    try {
+        for (var _l = __values(Object.entries(plotArea)), _m = _l.next(); !_m.done; _m = _l.next()) {
+            var _o = __read(_m.value, 2), key = _o[0], value = _o[1];
+            if (key === from) {
+                rebuiltPlotArea[to] = buildThreeDChartGroup(token, group, axIds);
+                continue;
+            }
+            rebuiltPlotArea[key] = value;
+            if (key === "c:valAx" && axes === 3) {
+                rebuiltPlotArea["c:serAx"] = buildSerAxNode(valAxId);
+            }
+        }
+    }
+    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+    finally {
+        try {
+            if (_m && !_m.done && (_a = _l.return)) _a.call(_l);
+        }
+        finally { if (e_7) throw e_7.error; }
+    }
+    // Rebuild the chart node so `<c:view3D>` lands before `<c:plotArea>`.
+    var rebuiltChart = {};
+    try {
+        for (var _p = __values(Object.entries(chartNode)), _q = _p.next(); !_q.done; _q = _p.next()) {
+            var _r = __read(_q.value, 2), key = _r[0], value = _r[1];
+            if (key === "c:plotArea") {
+                rebuiltChart["c:view3D"] = buildView3DNode(token);
+                rebuiltChart[key] = rebuiltPlotArea;
+                continue;
+            }
+            rebuiltChart[key] = value;
+        }
+    }
+    catch (e_8_1) { e_8 = { error: e_8_1 }; }
+    finally {
+        try {
+            if (_q && !_q.done && (_b = _p.return)) _b.call(_p);
+        }
+        finally { if (e_8) throw e_8.error; }
+    }
+    try {
+        for (var _s = __values(Object.keys(chartNode)), _t = _s.next(); !_t.done; _t = _s.next()) {
+            var key = _t.value;
+            delete chartNode[key];
+        }
+    }
+    catch (e_9_1) { e_9 = { error: e_9_1 }; }
+    finally {
+        try {
+            if (_t && !_t.done && (_c = _s.return)) _c.call(_s);
+        }
+        finally { if (e_9) throw e_9.error; }
+    }
+    Object.assign(chartNode, rebuiltChart);
+};
 // -------------------------- Phase 5 helpers --------------------------
 var LEGEND_POS = {
     top: "t",
@@ -1622,7 +1798,7 @@ var SERIES_CONTAINER_KEYS = [
  * matches the order emitted by the builder, so we index by position.
  */
 var applySeriesOverlays = function (plotArea, series, sheetNameById) {
-    var e_6, _a, e_7, _b;
+    var e_10, _a, e_11, _b;
     if (!Array.isArray(series) || !series.length)
         return;
     var seriesIndex = 0;
@@ -1637,7 +1813,7 @@ var applySeriesOverlays = function (plotArea, series, sheetNameById) {
                 continue;
             var list = Array.isArray(ser) ? ser : [ser];
             try {
-                for (var list_1 = (e_7 = void 0, __values(list)), list_1_1 = list_1.next(); !list_1_1.done; list_1_1 = list_1.next()) {
+                for (var list_1 = (e_11 = void 0, __values(list)), list_1_1 = list_1.next(); !list_1_1.done; list_1_1 = list_1.next()) {
                     var node = list_1_1.value;
                     var data = series[seriesIndex++];
                     if (!data)
@@ -1657,21 +1833,21 @@ var applySeriesOverlays = function (plotArea, series, sheetNameById) {
                     }
                 }
             }
-            catch (e_7_1) { e_7 = { error: e_7_1 }; }
+            catch (e_11_1) { e_11 = { error: e_11_1 }; }
             finally {
                 try {
                     if (list_1_1 && !list_1_1.done && (_b = list_1.return)) _b.call(list_1);
                 }
-                finally { if (e_7) throw e_7.error; }
+                finally { if (e_11) throw e_11.error; }
             }
         }
     }
-    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    catch (e_10_1) { e_10 = { error: e_10_1 }; }
     finally {
         try {
             if (SERIES_CONTAINER_KEYS_1_1 && !SERIES_CONTAINER_KEYS_1_1.done && (_a = SERIES_CONTAINER_KEYS_1.return)) _a.call(SERIES_CONTAINER_KEYS_1);
         }
-        finally { if (e_6) throw e_6.error; }
+        finally { if (e_10) throw e_10.error; }
     }
 };
 var buildTrendlineNode = function (t) {

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

@@ -0,0 +1,36 @@
+import type { EmbeddedChart, SheetRange, TreemapChart } from "@rowsncolumns/spreadsheet";
+/**
+ * Excel 2016+ "chartex" writer (`xl/charts/chartEx{N}.xml`) — the inverse
+ * of `excel-parser/plugins/xlsx/chartex.ts`. Treemap and sunburst have no
+ * `c:chartSpace` representation; Excel stores them as a `cx:chartSpace`
+ * whose series `layoutId` names the chart and whose data is a hierarchy
+ * `strDim type="cat"` (parent columns first, leaf last) plus a
+ * `numDim type="size"`. Anchored through `mc:AlternateContent` requiring the
+ * `cx1` namespace.
+ */
+export declare const CHART_EX_REL_TYPE = "http://schemas.microsoft.com/office/2014/relationships/chartEx";
+export declare const CHART_EX_CONTENT_TYPE = "application/vnd.ms-office.chartex+xml";
+export declare const CHART_EX_NS = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+/** Chart types that live in a chartex part rather than a `c:chartSpace`. */
+export declare const isChartExType: (chartType: string | undefined | null) => chartType is "treemap" | "sunburst";
+/**
+ * The hierarchy reference: parent columns + the leaf column merged into one
+ * contiguous range when they sit side by side on the same sheet over the same
+ * rows (how Excel lays a treemap out); otherwise the leaf labels alone.
+ */
+export declare const hierarchyRange: (spec: TreemapChart) => SheetRange | undefined;
+/** `xl/charts/chartEx{N}.xml` for a treemap / sunburst; undefined when the spec has no data. */
+export declare const buildChartExXml: (chart: EmbeddedChart, sheetNameById: Map<number, string>) => string | undefined;
+/**
+ * The drawing anchor body for a chartex part: Excel's `mc:AlternateContent`
+ * with a `cx1`-requiring choice holding the graphic frame. No `mc:Fallback`
+ * is written — Excel opens the file without one, and a fallback text box
+ * would import as a stray shape in consumers that do not know chartex.
+ */
+export declare const buildChartExGraphicFrameXml: ({ relId, frameId, widthEmu, heightEmu, }: {
+    relId: string;
+    frameId: number;
+    widthEmu: number;
+    heightEmu: number;
+}) => string;
+//# sourceMappingURL=chartex-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chartex-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/chartex-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,UAAU,EACV,YAAY,EACb,MAAM,2BAA2B,CAAC;AAGnC;;;;;;;;GAQG;AAEH,eAAO,MAAM,iBAAiB,mEACoC,CAAC;AACnE,eAAO,MAAM,qBAAqB,0CAA0C,CAAC;AAC7E,eAAO,MAAM,WAAW,6DAA6D,CAAC;AAyBtF,4EAA4E;AAC5E,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,GAAG,SAAS,GAAG,IAAI,wCACb,CAAC;AAItD;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,YAAY,KAAG,UAAU,GAAG,SAsBhE,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,eAAe,GAC1B,OAAO,aAAa,EACpB,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,MAAM,GAAG,SAkCX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAI,0CAKzC;IACD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,WACkhB,CAAC"}

package/dist/cjs/exporter/xlsx/chartex-builder.js

@@ -0,0 +1,109 @@
+import { __assign, __read, __spreadArray } from "tslib";
+import { cellRangeToAddress } from "@rowsncolumns/utils";
+/**
+ * Excel 2016+ "chartex" writer (`xl/charts/chartEx{N}.xml`) — the inverse
+ * of `excel-parser/plugins/xlsx/chartex.ts`. Treemap and sunburst have no
+ * `c:chartSpace` representation; Excel stores them as a `cx:chartSpace`
+ * whose series `layoutId` names the chart and whose data is a hierarchy
+ * `strDim type="cat"` (parent columns first, leaf last) plus a
+ * `numDim type="size"`. Anchored through `mc:AlternateContent` requiring the
+ * `cx1` namespace.
+ */
+export var CHART_EX_REL_TYPE = "http://schemas.microsoft.com/office/2014/relationships/chartEx";
+export var CHART_EX_CONTENT_TYPE = "application/vnd.ms-office.chartex+xml";
+export var CHART_EX_NS = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+var CHART_EX_1_NS = "http://schemas.microsoft.com/office/drawing/2015/9/8/chartex";
+var A_NS = "http://schemas.openxmlformats.org/drawingml/2006/main";
+var R_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+var MC_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+var XML_DECLARATION = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n";
+/** `{XXXXXXXX-XXXX-4XXX-XXXX-XXXXXXXXXXXX}` — the series `uniqueId` Excel expects. */
+var guid = function () {
+    var hex = function () { return Math.floor(Math.random() * 16).toString(16).toUpperCase(); };
+    var block = function (n) { return Array.from({ length: n }, hex).join(""); };
+    return "{".concat(block(8), "-").concat(block(4), "-4").concat(block(3), "-").concat(block(4), "-").concat(block(12), "}");
+};
+/** `'Sheet'!A2:B9` → `'Sheet'!$A$2:$B$9` — Excel writes chart data references absolute. */
+var absoluteRef = function (ref) {
+    var bang = ref.lastIndexOf("!");
+    var sheetPart = bang >= 0 ? ref.slice(0, bang + 1) : "";
+    var cells = bang >= 0 ? ref.slice(bang + 1) : ref;
+    return "".concat(sheetPart).concat(cells.replace(/\$?([A-Z]+)\$?(\d+)/g, "$$$1$$$2"));
+};
+var escapeText = function (value) {
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+};
+/** Chart types that live in a chartex part rather than a `c:chartSpace`. */
+export var isChartExType = function (chartType) {
+    return chartType === "treemap" || chartType === "sunburst";
+};
+var primarySource = function (entry) { var _a; return (_a = entry === null || entry === void 0 ? void 0 : entry.sources) === null || _a === void 0 ? void 0 : _a[0]; };
+/**
+ * The hierarchy reference: parent columns + the leaf column merged into one
+ * contiguous range when they sit side by side on the same sheet over the same
+ * rows (how Excel lays a treemap out); otherwise the leaf labels alone.
+ */
+export var hierarchyRange = function (spec) {
+    var _a, _b;
+    var leaf = primarySource((_a = spec.labels) === null || _a === void 0 ? void 0 : _a[0]);
+    if (!leaf)
+        return undefined;
+    var parents = ((_b = spec.parentLabels) !== null && _b !== void 0 ? _b : [])
+        .map(function (entry) { return primarySource(entry); })
+        .filter(function (range) { return Boolean(range); });
+    if (!parents.length)
+        return leaf;
+    var sameRows = parents.every(function (p) {
+        return p.sheetId === leaf.sheetId &&
+            p.startRowIndex === leaf.startRowIndex &&
+            p.endRowIndex === leaf.endRowIndex;
+    });
+    if (!sameRows)
+        return leaf;
+    var columns = __spreadArray(__spreadArray([], __read(parents), false), [leaf], false).map(function (r) { return r.startColumnIndex; }).sort(function (a, b) { return a - b; });
+    var contiguous = columns.every(function (c, i) { return i === 0 || c === columns[i - 1] + 1; });
+    if (!contiguous || columns[columns.length - 1] !== leaf.startColumnIndex) {
+        return leaf;
+    }
+    return __assign(__assign({}, leaf), { startColumnIndex: columns[0], endColumnIndex: leaf.endColumnIndex });
+};
+/** `xl/charts/chartEx{N}.xml` for a treemap / sunburst; undefined when the spec has no data. */
+export var buildChartExXml = function (chart, sheetNameById) {
+    var _a;
+    var spec = chart.spec;
+    if (!isChartExType(spec.chartType))
+        return undefined;
+    var cat = hierarchyRange(spec);
+    var size = primarySource((_a = spec.sizeData) === null || _a === void 0 ? void 0 : _a[0]);
+    if (!cat || !size)
+        return undefined;
+    var catAddress = cellRangeToAddress(sheetNameById.get(cat.sheetId), cat);
+    var sizeAddress = cellRangeToAddress(sheetNameById.get(size.sheetId), size);
+    if (!catAddress || !sizeAddress)
+        return undefined;
+    var catRef = absoluteRef(catAddress);
+    var sizeRef = absoluteRef(sizeAddress);
+    var title = chart.spec.title;
+    var titleXml = title
+        ? "<cx:title pos=\"t\" align=\"ctr\" overlay=\"0\"><cx:tx><cx:txData><cx:v>".concat(escapeText(title), "</cx:v></cx:txData></cx:tx></cx:title>")
+        : "";
+    var isTreemap = spec.chartType === "treemap";
+    var dataLabels = isTreemap
+        ? "<cx:dataLabels pos=\"inEnd\"><cx:visibility seriesName=\"0\" categoryName=\"1\" value=\"0\"/></cx:dataLabels>"
+        : "<cx:dataLabels><cx:visibility seriesName=\"0\" categoryName=\"1\" value=\"0\"/></cx:dataLabels>";
+    var layoutPr = isTreemap
+        ? "<cx:layoutPr><cx:parentLabelLayout val=\"banner\"/></cx:layoutPr>"
+        : "";
+    var legend = isTreemap ? "<cx:legend pos=\"t\" align=\"ctr\" overlay=\"0\"/>" : "";
+    return "".concat(XML_DECLARATION, "<cx:chartSpace xmlns:a=\"").concat(A_NS, "\" xmlns:r=\"").concat(R_NS, "\" xmlns:cx=\"").concat(CHART_EX_NS, "\"><cx:chartData><cx:data id=\"0\"><cx:strDim type=\"cat\"><cx:f>").concat(escapeText(catRef), "</cx:f></cx:strDim><cx:numDim type=\"size\"><cx:f>").concat(escapeText(sizeRef), "</cx:f></cx:numDim></cx:data></cx:chartData><cx:chart>").concat(titleXml, "<cx:plotArea><cx:plotAreaRegion><cx:series layoutId=\"").concat(spec.chartType, "\" uniqueId=\"").concat(guid(), "\">").concat(dataLabels, "<cx:dataId val=\"0\"/>").concat(layoutPr, "</cx:series></cx:plotAreaRegion></cx:plotArea>").concat(legend, "</cx:chart></cx:chartSpace>");
+};
+/**
+ * The drawing anchor body for a chartex part: Excel's `mc:AlternateContent`
+ * with a `cx1`-requiring choice holding the graphic frame. No `mc:Fallback`
+ * is written — Excel opens the file without one, and a fallback text box
+ * would import as a stray shape in consumers that do not know chartex.
+ */
+export var buildChartExGraphicFrameXml = function (_a) {
+    var relId = _a.relId, frameId = _a.frameId, widthEmu = _a.widthEmu, heightEmu = _a.heightEmu;
+    return "<mc:AlternateContent xmlns:mc=\"".concat(MC_NS, "\"><mc:Choice xmlns:cx1=\"").concat(CHART_EX_1_NS, "\" Requires=\"cx1\"><xdr:graphicFrame macro=\"\"><xdr:nvGraphicFramePr><xdr:cNvPr id=\"").concat(frameId, "\" name=\"Chart ").concat(frameId, "\"/><xdr:cNvGraphicFramePr/></xdr:nvGraphicFramePr><xdr:xfrm><a:off x=\"0\" y=\"0\"/><a:ext cx=\"").concat(widthEmu, "\" cy=\"").concat(heightEmu, "\"/></xdr:xfrm><a:graphic><a:graphicData uri=\"").concat(CHART_EX_NS, "\"><cx:chart xmlns:cx=\"").concat(CHART_EX_NS, "\" xmlns:r=\"").concat(R_NS, "\" r:id=\"").concat(relId, "\"/></a:graphicData></a:graphic></xdr:graphicFrame></mc:Choice></mc:AlternateContent>");
+};

package/dist/cjs/exporter/xlsx/form-controls-builder.d.ts

@@ -0,0 +1,61 @@
+import type { EmbedFormControlSpec } from "@rowsncolumns/spreadsheet";
+/**
+ * Excel form-control writers — the inverse of
+ * `excel-parser/plugins/xlsx/form-controls.ts`. A control is three parts:
+ * the worksheet `<controls><control>` entry (anchor + `<controlPr>`), its
+ * `xl/ctrlProps/ctrlPropN.xml` (`<formControlPr>`), and the legacy VML shape
+ * Excel actually draws (`<v:shape type="#_x0000_t201"><x:ClientData
+ * ObjectType="Checkbox">`). All three are written; Excel drops a control
+ * whose VML shape is missing.
+ */
+export declare const CTRL_PROP_CONTENT_TYPE = "application/vnd.ms-excel.controlproperties+xml";
+export declare const CTRL_PROP_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp";
+export declare const FORM_CONTROL_NS = "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main";
+/** `xl/ctrlProps/ctrlPropN.xml` body. */
+export declare const buildCtrlPropXml: (spec: EmbedFormControlSpec) => string;
+/** A cell anchor in OOXML units: 0-based cell + EMU offsets. */
+export type ControlCellAnchor = {
+    col: number;
+    colOff: number;
+    row: number;
+    rowOff: number;
+};
+/** One `<control>` element (inside the `<controls>` wrapper). */
+export declare const buildControlElementXml: ({ spec, relId, shapeId, from, to, }: {
+    spec: EmbedFormControlSpec;
+    relId: string;
+    shapeId: number;
+    from: ControlCellAnchor;
+    to: ControlCellAnchor;
+}) => string;
+/**
+ * The worksheet `<controls>` element. Excel wraps controls in an
+ * `mc:AlternateContent` whose `Choice` requires the `x14` namespace; the
+ * namespaces the wrapper and the `xdr:` anchor cells need are declared on
+ * the element so the worksheet root stays untouched.
+ */
+export declare const buildControlsXml: (controlElements: string[]) => string;
+/** VML `<v:shapetype>` every form control references (`#_x0000_t201`). */
+export declare const FORM_CONTROL_VML_SHAPETYPE = "<v:shapetype id=\"_x0000_t201\" coordsize=\"21600,21600\" o:spt=\"201\" path=\"m,l,21600r21600,l21600,xe\"><v:stroke joinstyle=\"miter\"/><v:path shadowok=\"f\" o:extrusionok=\"f\" strokeok=\"f\" fillok=\"f\" o:connecttype=\"rect\"/><o:lock v:ext=\"edit\" shapetype=\"t\"/></v:shapetype>";
+/** Pixel geometry the VML shape needs (absolute position + cell-span anchor). */
+export type FormControlVmlGeometry = {
+    leftPx: number;
+    topPx: number;
+    widthPx: number;
+    heightPx: number;
+    /** `x:Anchor` — from col, from col px offset, from row, from row px offset, to …  */
+    anchor: [number, number, number, number, number, number, number, number];
+};
+/** One `<v:shape>` drawing a form control. */
+export declare const buildFormControlVmlShape: ({ spec, shapeId, zIndex, geometry, }: {
+    spec: EmbedFormControlSpec;
+    shapeId: number;
+    zIndex: number;
+    geometry: FormControlVmlGeometry;
+}) => string;
+/** Wrap note + control shapes into one `vmlDrawing` part. */
+export declare const buildVmlDrawingXml: ({ shapeTypes, shapes, }: {
+    shapeTypes: string[];
+    shapes: string[];
+}) => string | undefined;
+//# sourceMappingURL=form-controls-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-controls-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/form-controls-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;;;;GAQG;AAEH,eAAO,MAAM,sBAAsB,mDACe,CAAC;AACnD,eAAO,MAAM,kBAAkB,iFACiD,CAAC;AACjF,eAAO,MAAM,eAAe,kEACqC,CAAC;AAuBlE,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,GAAI,MAAM,oBAAoB,KAAG,MAU7D,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AASF,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,GAAI,qCAMpC;IACD,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC;IACxB,EAAE,EAAE,iBAAiB,CAAC;CACvB,KAAG,MAaH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,iBAAiB,MAAM,EAAE,KAAG,MAK5D,CAAC;AAmEF,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,oSAA4Q,CAAC;AAEpT,iFAAiF;AACjF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1E,CAAC;AAIF,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,GAAI,sCAKtC;IACD,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,sBAAsB,CAAC;CAClC,KAAG,MAmBH,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,GAAI,yBAGhC;IACD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,KAAG,MAAM,GAAG,SAKZ,CAAC"}