@rowsncolumns/toolkit 24.4.2 → 24.4.4

package/dist/cjs/exporter/xlsx/form-controls-builder.js

@@ -0,0 +1,197 @@
+import { __read, __rest } from "tslib";
+/**
+ * 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 var CTRL_PROP_CONTENT_TYPE = "application/vnd.ms-excel.controlproperties+xml";
+export var CTRL_PROP_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp";
+export var FORM_CONTROL_NS = "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main";
+var MC_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+var XDR_NS = "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing";
+var XML_DECLARATION = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n";
+var escapeAttr = function (value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+};
+var escapeText = function (value) {
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+};
+var attrsXml = function (attrs) {
+    return Object.entries(attrs !== null && attrs !== void 0 ? attrs : {})
+        .filter(function (_a) {
+        var _b = __read(_a, 2), key = _b[0], value = _b[1];
+        return key && value != null;
+    })
+        .map(function (_a) {
+        var _b = __read(_a, 2), key = _b[0], value = _b[1];
+        return " ".concat(key, "=\"").concat(escapeAttr(String(value)), "\"");
+    })
+        .join("");
+};
+/** `xl/ctrlProps/ctrlPropN.xml` body. */
+export var buildCtrlPropXml = function (spec) {
+    var _a, _b;
+    var _c = (_a = spec.properties) !== null && _a !== void 0 ? _a : {}, _ignored = _c.objectType, rest = __rest(_c, ["objectType"]);
+    var items = ((_b = spec.listItems) !== null && _b !== void 0 ? _b : [])
+        .map(function (item) { return "<item val=\"".concat(escapeAttr(item), "\"/>"); })
+        .join("");
+    var body = items ? "<itemLst>".concat(items, "</itemLst>") : "";
+    var open = "<formControlPr xmlns=\"".concat(FORM_CONTROL_NS, "\" objectType=\"").concat(escapeAttr(spec.objectType), "\"").concat(attrsXml(rest));
+    return "".concat(XML_DECLARATION).concat(body ? "".concat(open, ">").concat(body, "</formControlPr>") : "".concat(open, "/>"));
+};
+var cellAnchorXml = function (tag, anchor) {
+    return "<".concat(tag, "><xdr:col>").concat(anchor.col, "</xdr:col><xdr:colOff>").concat(Math.round(anchor.colOff), "</xdr:colOff><xdr:row>").concat(anchor.row, "</xdr:row><xdr:rowOff>").concat(Math.round(anchor.rowOff), "</xdr:rowOff></").concat(tag, ">");
+};
+/** One `<control>` element (inside the `<controls>` wrapper). */
+export var buildControlElementXml = function (_a) {
+    var _b;
+    var spec = _a.spec, relId = _a.relId, shapeId = _a.shapeId, from = _a.from, to = _a.to;
+    var name = (_b = spec.name) !== null && _b !== void 0 ? _b : "".concat(spec.objectType, " ").concat(shapeId);
+    var anchorAttrs = (spec.moveWithCells ? ' moveWithCells="1"' : "") +
+        (spec.sizeWithCells ? ' sizeWithCells="1"' : "");
+    return "<control shapeId=\"".concat(shapeId, "\" r:id=\"").concat(relId, "\" name=\"").concat(escapeAttr(name), "\"><controlPr").concat(attrsXml(spec.controlProperties), "><anchor").concat(anchorAttrs, ">").concat(cellAnchorXml("from", from)).concat(cellAnchorXml("to", to), "</anchor></controlPr></control>");
+};
+/**
+ * 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 var buildControlsXml = function (controlElements) {
+    if (!controlElements.length)
+        return "";
+    return "<controls xmlns:mc=\"".concat(MC_NS, "\" xmlns:xdr=\"").concat(XDR_NS, "\" xmlns:x14=\"").concat(FORM_CONTROL_NS, "\"><mc:AlternateContent><mc:Choice Requires=\"x14\">").concat(controlElements.join(""), "</mc:Choice></mc:AlternateContent></controls>");
+};
+/** `formControlPr/@objectType` → VML `x:ClientData/@ObjectType`. */
+var VML_OBJECT_TYPE = {
+    CheckBox: "Checkbox",
+    EditBox: "Edit",
+};
+var truthy = function (value) {
+    return value === "1" || value === "true";
+};
+/**
+ * `x:ClientData` children derived from the `formControlPr` / `controlPr`
+ * attributes — Excel reads the control's state (checked, linked cell, list
+ * range, selection, scroll values) from the VML, the ctrlProp part is the
+ * x14 mirror.
+ */
+var clientDataChildrenXml = function (spec) {
+    var _a, _b;
+    var p = (_a = spec.properties) !== null && _a !== void 0 ? _a : {};
+    var c = (_b = spec.controlProperties) !== null && _b !== void 0 ? _b : {};
+    var out = [];
+    var push = function (tag, value) {
+        if (value === undefined)
+            out.push("<x:".concat(tag, "/>"));
+        else
+            out.push("<x:".concat(tag, ">").concat(escapeText(value), "</x:").concat(tag, ">"));
+    };
+    if (spec.moveWithCells)
+        push("MoveWithCells");
+    if (spec.sizeWithCells)
+        push("SizeWithCells");
+    // Anchor is inserted by the caller (needs sheet geometry).
+    out.push("__ANCHOR__");
+    if (c.locked === "0")
+        push("Locked", "False");
+    if (c.defaultSize === "0")
+        push("DefaultSize", "False");
+    if (c.print === "0")
+        push("PrintObject", "False");
+    if (c.autoFill === "0")
+        push("AutoFill", "False");
+    if (c.autoLine === "0")
+        push("AutoLine", "False");
+    if (c.autoPict === "0")
+        push("AutoPict", "False");
+    if (c.macro)
+        push("FmlaMacro", c.macro);
+    if (p.textHAlign)
+        push("TextHAlign", p.textHAlign);
+    if (p.textVAlign)
+        push("TextVAlign", p.textVAlign);
+    if (truthy(p.lockText))
+        push("LockText");
+    if (truthy(p.justLastX))
+        push("JustLastX");
+    if (truthy(p.passwordEdit))
+        push("SecretEdit");
+    if (truthy(p.multiLine))
+        push("MultiLine");
+    if (truthy(p.verticalBar))
+        push("VScroll");
+    if (p.fmlaRange)
+        push("FmlaRange", p.fmlaRange);
+    if (p.widthMin)
+        push("WidthMin", p.widthMin);
+    if (p.sel)
+        push("Sel", p.sel);
+    if (p.seltype)
+        push("SelType", p.seltype);
+    if (p.multiSel)
+        push("MultiSel", p.multiSel);
+    if (p.dropStyle)
+        push("DropStyle", p.dropStyle);
+    if (truthy(p.colored))
+        push("Colored");
+    if (p.dropLines)
+        push("DropLines", p.dropLines);
+    if (p.checked === "Checked")
+        push("Checked", "1");
+    else if (p.checked === "Mixed")
+        push("Checked", "2");
+    if (p.fmlaLink)
+        push("FmlaLink", p.fmlaLink);
+    if (truthy(p.noThreeD))
+        push("NoThreeD");
+    if (truthy(p.firstButton))
+        push("FirstButton");
+    if (p.fmlaGroup)
+        push("FmlaGroup", p.fmlaGroup);
+    if (p.val)
+        push("Val", p.val);
+    if (p.min)
+        push("Min", p.min);
+    if (p.max)
+        push("Max", p.max);
+    if (p.inc)
+        push("Inc", p.inc);
+    if (p.page)
+        push("Page", p.page);
+    if (truthy(p.horiz))
+        push("Horiz");
+    if (p.dx)
+        push("Dx", p.dx);
+    return out.join("");
+};
+/** VML `<v:shapetype>` every form control references (`#_x0000_t201`). */
+export var 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>";
+var toPt = function (px) { return "".concat((px * 0.75).toFixed(2).replace(/\.?0+$/, ""), "pt"); };
+/** One `<v:shape>` drawing a form control. */
+export var buildFormControlVmlShape = function (_a) {
+    var _b;
+    var spec = _a.spec, shapeId = _a.shapeId, zIndex = _a.zIndex, geometry = _a.geometry;
+    var objectType = (_b = VML_OBJECT_TYPE[spec.objectType]) !== null && _b !== void 0 ? _b : spec.objectType;
+    var caption = spec.text
+        ? "<div style=\"text-align:left\"><font face=\"Tahoma\" size=\"160\" color=\"auto\">".concat(escapeText(spec.text), "</font></div>")
+        : "";
+    var clientData = clientDataChildrenXml(spec).replace("__ANCHOR__", "<x:Anchor>".concat(geometry.anchor.join(", "), "</x:Anchor>"));
+    var style = "position:absolute;margin-left:".concat(toPt(geometry.leftPx), ";margin-top:").concat(toPt(geometry.topPx), ";width:").concat(toPt(geometry.widthPx), ";height:").concat(toPt(geometry.heightPx), ";z-index:").concat(zIndex, ";mso-wrap-style:tight");
+    return "<v:shape id=\"_x0000_s".concat(shapeId, "\" type=\"#_x0000_t201\" style=\"").concat(style, "\" filled=\"f\" fillcolor=\"window [65]\" stroked=\"f\" strokecolor=\"windowText [64]\" o:insetmode=\"auto\"><v:path shadowok=\"f\" o:extrusionok=\"f\" strokeok=\"f\" fillok=\"f\" o:connecttype=\"rect\"/><v:textbox style=\"mso-direction-alt:auto\" o:singleclick=\"f\">").concat(caption, "</v:textbox><x:ClientData ObjectType=\"").concat(escapeAttr(objectType), "\">").concat(clientData, "</x:ClientData></v:shape>");
+};
+/** Wrap note + control shapes into one `vmlDrawing` part. */
+export var buildVmlDrawingXml = function (_a) {
+    var shapeTypes = _a.shapeTypes, shapes = _a.shapes;
+    if (!shapes.length)
+        return undefined;
+    return "<xml xmlns:v=\"urn:schemas-microsoft-com:vml\" xmlns:o=\"urn:schemas-microsoft-com:office:office\" xmlns:x=\"urn:schemas-microsoft-com:office:excel\"><o:shapelayout v:ext=\"edit\"><o:idmap v:ext=\"edit\" data=\"1\"/></o:shapelayout>".concat(shapeTypes.join("")).concat(shapes.join(""), "</xml>");
+};

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

@@ -26,6 +26,14 @@
  * + ~100 lines in xlsx-export.ts) is the closest reference template.
  */
 import type { PivotTable } from "@rowsncolumns/spreadsheet";
+/**
+ * Distinct source fields a calculated-field formula references —
+ * single-quoted names (`'Unit Price'`, `''` escapes a quote) or bare
+ * identifiers; numeric literals (incl. `1e5`) and operators are skipped.
+ * Mirrors `@rowsncolumns/pivot`'s tokenizer without pulling in the
+ * DuckDB-backed pivot package.
+ */
+export declare const calculatedFieldReferences: (formula: string) => string[];
 /**
  * Build pivotCacheDefinition XML for a pivot. The cacheSource
  * points at the live worksheet range; `refreshOnLoad="1"` makes

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

@@ -1 +1 @@
-{"version":3,"file":"pivot-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/pivot-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AA4D5D;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,UAAU,EACjB,WAAW,MAAM,EACjB,YAAY,MAAM,EAAE,KACnB,MAAM,GAAG,IAgCX,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,UAAU,EACjB,SAAS,MAAM,EACf,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAChC,MAAM,GAAG,IAkHX,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,aAAa,MAAM,KAClB,MAcF,CAAC"}
+{"version":3,"file":"pivot-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/pivot-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,2BAA2B,CAAC;AAqBxE;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,MAAM,KAAG,MAAM,EAYjE,CAAC;AA2DF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,UAAU,EACjB,WAAW,MAAM,EACjB,YAAY,MAAM,EAAE,KACnB,MAAM,GAAG,IAuCX,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,UAAU,EACjB,SAAS,MAAM,EACf,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAChC,MAAM,GAAG,IA2JX,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,EAChB,aAAa,MAAM,KAClB,MAcF,CAAC"}

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

@@ -1,5 +1,55 @@
 import { __read, __spreadArray, __values } from "tslib";
 import { XMLBuilder } from "fast-xml-parser";
+/**
+ * `PivotValue.showAs` → `dataField@showDataAs` (ECMA-376) or, for the
+ * rank modes Excel only knows through its 2010 extension,
+ * `x14:dataField@pivotShowAs`.
+ */
+var SHOW_DATA_AS = {
+    pct_of_total: "percentOfTotal",
+    pct_of_row: "percentOfRow",
+    pct_of_column: "percentOfCol",
+    running_total: "runTotal",
+};
+var X14_PIVOT_SHOW_AS = {
+    rank_asc: "rankAscending",
+    rank_desc: "rankDescending",
+};
+var X14_DATA_FIELD_EXT_URI = "{E15A36E0-9728-4e99-A89B-3F7291B0FE68}";
+var X14_NS = "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main";
+/**
+ * Distinct source fields a calculated-field formula references —
+ * single-quoted names (`'Unit Price'`, `''` escapes a quote) or bare
+ * identifiers; numeric literals (incl. `1e5`) and operators are skipped.
+ * Mirrors `@rowsncolumns/pivot`'s tokenizer without pulling in the
+ * DuckDB-backed pivot package.
+ */
+export var calculatedFieldReferences = function (formula) {
+    var e_1, _a;
+    var out = [];
+    var push = function (name) {
+        if (name && !out.includes(name))
+            out.push(name);
+    };
+    var re = /'((?:[^']|'')*)'|(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?|([A-Za-z_\u00C0-\uFFFF][A-Za-z0-9_.\u00C0-\uFFFF]*)/g;
+    try {
+        for (var _b = __values(formula.replace(/^\s*=/, "").matchAll(re)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var m = _c.value;
+            if (m[1] !== undefined)
+                push(m[1].replace(/''/g, "'"));
+            else if (m[2] !== undefined)
+                push(m[2]);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return out;
+};
 var xmlBuilder = new XMLBuilder({
     ignoreAttributes: false,
     attributeNamePrefix: "@_",
@@ -55,13 +105,19 @@ var aggToSubtotal = function (agg) {
  * @param fieldNames  All source column headers (becomes <cacheFields>)
  */
 export var buildPivotCacheDefinitionXml = function (pivot, sheetName, fieldNames) {
+    var _a;
     if (!pivot.source)
         return null;
     var sourceRef = rangeRef(pivot.source);
-    var cacheFields = fieldNames.map(function (name) { return ({
-        "@_name": name,
-        sharedItems: { "@_count": "0" },
-    }); });
+    // Calculated fields are cache fields too (`databaseField="0"` +
+    // `formula`), listed after the source columns like Excel does.
+    var calculatedByName = new Map(((_a = pivot.calculatedFields) !== null && _a !== void 0 ? _a : []).map(function (c) { return [c.name, c.formula]; }));
+    var cacheFields = fieldNames.map(function (name) {
+        var formula = calculatedByName.get(name);
+        return formula !== undefined
+            ? { "@_name": name, "@_formula": formula, "@_databaseField": "0" }
+            : { "@_name": name, sharedItems: { "@_count": "0" } };
+    });
     var doc = {
         "?xml": { "@_version": "1.0", "@_encoding": "UTF-8", "@_standalone": "yes" },
         pivotCacheDefinition: {
@@ -96,112 +152,155 @@ export var buildPivotCacheDefinitionXml = function (pivot, sheetName, fieldNames
  * @param fieldIndices  Maps row/col/value field names → cacheField indices
  */
 export var buildPivotTableXml = function (pivot, cacheId, fieldIndices) {
-    var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
-    var _e, _f, _g, _h, _j, _k, _l;
+    var e_2, _a, e_3, _b, e_4, _c, e_5, _d;
+    var _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
     if (!pivot.pivotRange)
         return null;
     var ref = rangeRef(pivot.pivotRange);
-    // pivotFields: one entry per cacheField, with axis attribute
-    // (axisRow / axisCol / dataField). Order = cacheField order.
+    // pivotFields: one entry per cacheField, with the axis attribute
+    // (axisRow / axisCol) and/or `dataField="1"` for value fields
+    // (`ST_Axis` has no "dataField" value — a field can sit on an axis
+    // AND be a data field). Order = cacheField order.
     var pivotFields = [];
     // We don't know the full field universe here without the source
     // schema. Best-effort: declare entries for the union of row/col/
     // value fields and tag with the appropriate axis.
     var fieldAxis = new Map();
     try {
-        for (var _m = __values((_e = pivot.rows) !== null && _e !== void 0 ? _e : []), _o = _m.next(); !_o.done; _o = _m.next()) {
-            var r = _o.value;
+        for (var _t = __values((_e = pivot.rows) !== null && _e !== void 0 ? _e : []), _u = _t.next(); !_u.done; _u = _t.next()) {
+            var r = _u.value;
             var idx = fieldIndices.get(r.field);
             if (idx != null)
                 fieldAxis.set(idx, "axisRow");
         }
     }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
     finally {
         try {
-            if (_o && !_o.done && (_a = _m.return)) _a.call(_m);
+            if (_u && !_u.done && (_a = _t.return)) _a.call(_t);
         }
-        finally { if (e_1) throw e_1.error; }
+        finally { if (e_2) throw e_2.error; }
     }
     try {
-        for (var _p = __values((_f = pivot.columns) !== null && _f !== void 0 ? _f : []), _q = _p.next(); !_q.done; _q = _p.next()) {
-            var c = _q.value;
+        for (var _v = __values((_f = pivot.columns) !== null && _f !== void 0 ? _f : []), _w = _v.next(); !_w.done; _w = _v.next()) {
+            var c = _w.value;
             var idx = fieldIndices.get(c.field);
             if (idx != null)
                 fieldAxis.set(idx, "axisCol");
         }
     }
-    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
     finally {
         try {
-            if (_q && !_q.done && (_b = _p.return)) _b.call(_p);
+            if (_w && !_w.done && (_b = _v.return)) _b.call(_v);
         }
-        finally { if (e_2) throw e_2.error; }
+        finally { if (e_3) throw e_3.error; }
     }
+    var dataFieldIndices = new Set();
     try {
-        for (var _r = __values((_g = pivot.values) !== null && _g !== void 0 ? _g : []), _s = _r.next(); !_s.done; _s = _r.next()) {
-            var v = _s.value;
+        for (var _x = __values((_g = pivot.values) !== null && _g !== void 0 ? _g : []), _y = _x.next(); !_y.done; _y = _x.next()) {
+            var v = _y.value;
             var idx = fieldIndices.get(v.field);
             if (idx != null)
-                fieldAxis.set(idx, "dataField");
+                dataFieldIndices.add(idx);
         }
     }
-    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
     finally {
         try {
-            if (_s && !_s.done && (_c = _r.return)) _c.call(_r);
+            if (_y && !_y.done && (_c = _x.return)) _c.call(_x);
         }
-        finally { if (e_3) throw e_3.error; }
+        finally { if (e_4) throw e_4.error; }
     }
+    var calculatedNames = new Set(((_h = pivot.calculatedFields) !== null && _h !== void 0 ? _h : []).map(function (c) { return c.name; }));
     // Need to emit one <pivotField> per cacheField in order, even
     // for unused fields (Excel requires the array shapes match).
     // Caller passes us the full field set via fieldIndices.
     var sortedFieldIndices = __spreadArray([], __read(fieldIndices.entries()), false).sort(function (a, b) { return a[1] - b[1]; });
     try {
         for (var sortedFieldIndices_1 = __values(sortedFieldIndices), sortedFieldIndices_1_1 = sortedFieldIndices_1.next(); !sortedFieldIndices_1_1.done; sortedFieldIndices_1_1 = sortedFieldIndices_1.next()) {
-            var _t = __read(sortedFieldIndices_1_1.value, 2), idx = _t[1];
+            var _z = __read(sortedFieldIndices_1_1.value, 2), name_1 = _z[0], idx = _z[1];
             var axis = fieldAxis.get(idx);
-            if (axis) {
-                pivotFields.push({ "@_axis": axis, "@_compact": "0", items: {} });
+            var entry = {};
+            if (axis)
+                entry["@_axis"] = axis;
+            if (dataFieldIndices.has(idx))
+                entry["@_dataField"] = "1";
+            if (calculatedNames.has(name_1)) {
+                // Excel pins calculated fields to the values area.
+                entry["@_dragToRow"] = "0";
+                entry["@_dragToCol"] = "0";
+                entry["@_dragToPage"] = "0";
+                entry["@_showAll"] = "0";
+                entry["@_defaultSubtotal"] = "0";
             }
             else {
-                pivotFields.push({ "@_compact": "0" });
+                entry["@_compact"] = "0";
+                if (axis)
+                    entry.items = {};
             }
+            pivotFields.push(entry);
         }
     }
-    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    catch (e_5_1) { e_5 = { error: e_5_1 }; }
     finally {
         try {
             if (sortedFieldIndices_1_1 && !sortedFieldIndices_1_1.done && (_d = sortedFieldIndices_1.return)) _d.call(sortedFieldIndices_1);
         }
-        finally { if (e_4) throw e_4.error; }
+        finally { if (e_5) throw e_5.error; }
     }
-    var rowFields = ((_h = pivot.rows) !== null && _h !== void 0 ? _h : [])
+    var rowFields = ((_j = pivot.rows) !== null && _j !== void 0 ? _j : [])
         .map(function (r) { return fieldIndices.get(r.field); })
         .filter(function (i) { return i != null; })
         .map(function (i) { return ({ "@_x": String(i) }); });
-    var colFields = ((_j = pivot.columns) !== null && _j !== void 0 ? _j : [])
+    var colFields = ((_k = pivot.columns) !== null && _k !== void 0 ? _k : [])
         .map(function (c) { return fieldIndices.get(c.field); })
         .filter(function (i) { return i != null; })
         .map(function (i) { return ({ "@_x": String(i) }); });
-    var dataFields = ((_k = pivot.values) !== null && _k !== void 0 ? _k : [])
+    // Running totals need a base field: Excel defaults to the first row
+    // field (falls back to the first column field / field 0).
+    var runTotalBase = (_p = (_m = (_l = rowFields[0]) === null || _l === void 0 ? void 0 : _l["@_x"]) !== null && _m !== void 0 ? _m : (_o = colFields[0]) === null || _o === void 0 ? void 0 : _o["@_x"]) !== null && _p !== void 0 ? _p : "0";
+    var dataFields = ((_q = pivot.values) !== null && _q !== void 0 ? _q : [])
         .map(function (v) {
         var _a;
         var idx = fieldIndices.get(v.field);
         if (idx == null)
             return null;
-        return {
+        var entry = {
             "@_name": (_a = v.displayName) !== null && _a !== void 0 ? _a : "".concat(v.aggFunc, " of ").concat(v.field),
             "@_fld": String(idx),
-            "@_subtotal": aggToSubtotal(v.aggFunc),
+            "@_subtotal": calculatedNames.has(v.field)
+                ? "sum"
+                : aggToSubtotal(v.aggFunc),
         };
+        var showDataAs = v.showAs ? SHOW_DATA_AS[v.showAs] : undefined;
+        if (showDataAs) {
+            entry["@_showDataAs"] = showDataAs;
+            if (showDataAs === "runTotal")
+                entry["@_baseField"] = runTotalBase;
+        }
+        var pivotShowAs = v.showAs ? X14_PIVOT_SHOW_AS[v.showAs] : undefined;
+        if (pivotShowAs) {
+            entry.extLst = {
+                ext: {
+                    "@_uri": X14_DATA_FIELD_EXT_URI,
+                    "@_xmlns:x14": X14_NS,
+                    "x14:dataField": { "@_pivotShowAs": pivotShowAs },
+                },
+            };
+        }
+        return entry;
     })
         .filter(function (d) { return d !== null; });
+    var styleInfo = (_r = pivot.styleInfo) !== null && _r !== void 0 ? _r : {};
+    var styleFlag = function (value, fallback) {
+        return value === undefined ? fallback : value ? "1" : "0";
+    };
     var doc = {
         "?xml": { "@_version": "1.0", "@_encoding": "UTF-8", "@_standalone": "yes" },
         pivotTableDefinition: {
             "@_xmlns": "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
-            "@_name": (_l = pivot.name) !== null && _l !== void 0 ? _l : "PivotTable".concat(pivot.pivotId),
+            "@_name": (_s = pivot.name) !== null && _s !== void 0 ? _s : "PivotTable".concat(pivot.pivotId),
             "@_cacheId": String(cacheId),
             "@_dataOnRows": "0",
             "@_applyNumberFormats": "0",
@@ -242,12 +341,12 @@ export var buildPivotTableXml = function (pivot, cacheId, fieldIndices) {
                 ? { "@_count": String(dataFields.length), dataField: dataFields }
                 : undefined,
             pivotTableStyleInfo: {
-                "@_name": "PivotStyleLight16",
-                "@_showRowHeaders": "1",
-                "@_showColHeaders": "1",
-                "@_showRowStripes": "0",
-                "@_showColStripes": "0",
-                "@_showLastColumn": "1",
+                "@_name": styleInfo.name || "PivotStyleLight16",
+                "@_showRowHeaders": styleFlag(styleInfo.showRowHeaders, "1"),
+                "@_showColHeaders": styleFlag(styleInfo.showColHeaders, "1"),
+                "@_showRowStripes": styleFlag(styleInfo.showRowStripes, "0"),
+                "@_showColStripes": styleFlag(styleInfo.showColStripes, "0"),
+                "@_showLastColumn": styleFlag(styleInfo.showLastColumn, "1"),
             },
         },
     };

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

@@ -716,10 +716,16 @@ var serializeAlignment = function (record) {
         attrs.push("relativeIndent=\"".concat(record.relativeIndent, "\""));
     }
     if (record.textRotation !== undefined && record.textRotation !== null) {
-        // Excel encodes "vertical (stacked)" text as the magic value 255.
-        var rotation = record.textRotation === "vertical" ? 255 : record.textRotation;
+        // Excel encodes "vertical (stacked)" text as the magic value 255 and
+        // clockwise rotation as 90 + degrees (91–180); the engine keeps signed
+        // counter-clockwise degrees.
+        var rotation = record.textRotation === "vertical"
+            ? 255
+            : record.textRotation < 0
+                ? 90 - record.textRotation
+                : record.textRotation;
         if (Number.isFinite(rotation) && rotation !== 0) {
-            attrs.push("textRotation=\"".concat(rotation, "\""));
+            attrs.push("textRotation=\"".concat(Math.round(rotation), "\""));
         }
     }
     if (record.shrinkToFit) {

package/dist/cjs/exporter/xlsx/threaded-comments-builder.d.ts

@@ -10,6 +10,7 @@ export declare const PERSON_CONTENT_TYPE = "application/vnd.ms-excel.person+xml"
  * scoping author/comment ids within a single workbook.
  */
 export declare const deterministicGuid: (seed: string) => string;
+export declare const isBracedGuid: (id: string) => boolean;
 /**
  * Workbook-scoped author registry. Shared across every sheet's collector so
  * an author who comments on multiple sheets maps to a single `person` entry
@@ -35,7 +36,12 @@ export declare class ThreadedCommentsCollector {
     /** Anchor a thread to a cell. No-op if the id is unknown or empty. */
     addCell(address: string, threadId: string | number | null | undefined): void;
     isEmpty(): boolean;
-    /** Braced root GUID for a thread — used as both the root `id` and `tc=`. */
+    /**
+     * Braced root GUID for a thread — used as both the root `id` and `tc=`.
+     * An id that already is a braced GUID (what Excel and both importers
+     * produce) passes through, so a re-exported thread keeps the identity
+     * Excel assigned it; anything else is hashed deterministically.
+     */
     private rootGuid;
     /**
      * Legacy `xl/comments{N}.xml` mirror entries. Feed these into the existing

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

@@ -1 +1 @@
-{"version":3,"file":"threaded-comments-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/threaded-comments-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAyBhE,eAAO,MAAM,yBAAyB,8EACuC,CAAC;AAC9E,eAAO,MAAM,eAAe,qEACwC,CAAC;AACrE,eAAO,MAAM,8BAA8B,kDACM,CAAC;AAClD,eAAO,MAAM,mBAAmB,wCAAwC,CAAC;AAsBzE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MAiBhD,CAAC;AAEF;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGlB;IAEJ,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS;IAWtE,OAAO;IAIP,KAAK;CAYN;AAQD;;;;GAIG;AACH,qBAAa,yBAAyB;IAMlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAG3C,OAAO,EAAE,aAAa,EAAE,GAAG,SAAS,EACnB,OAAO,EAAE,cAAc;IAO1C,sEAAsE;IACtE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS;IAQrE,OAAO;IAIP,4EAA4E;IAC5E,OAAO,CAAC,QAAQ;IAIhB;;;;;OAKG;IACH,aAAa,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE;IAcpE;;;;OAIG;IACH,KAAK,IAAI,MAAM,GAAG,SAAS;CA+B5B"}
+{"version":3,"file":"threaded-comments-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/threaded-comments-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAyBhE,eAAO,MAAM,yBAAyB,8EACuC,CAAC;AAC9E,eAAO,MAAM,eAAe,qEACwC,CAAC;AACrE,eAAO,MAAM,8BAA8B,kDACM,CAAC;AAClD,eAAO,MAAM,mBAAmB,wCAAwC,CAAC;AAsBzE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MAiBhD,CAAC;AAKF,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,YAAyB,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGlB;IAEJ,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS;IAWtE,OAAO;IAIP,KAAK;CAYN;AAQD;;;;GAIG;AACH,qBAAa,yBAAyB;IAMlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAG3C,OAAO,EAAE,aAAa,EAAE,GAAG,SAAS,EACnB,OAAO,EAAE,cAAc;IAO1C,sEAAsE;IACtE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS;IAQrE,OAAO;IAIP;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAMhB;;;;;OAKG;IACH,aAAa,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE;IAcpE;;;;OAIG;IACH,KAAK,IAAI,MAAM,GAAG,SAAS;CAiC5B"}

package/dist/cjs/exporter/xlsx/threaded-comments-builder.js

@@ -62,6 +62,9 @@ export var deterministicGuid = function (seed) {
     var p5 = all.slice(20, 32);
     return "{".concat(p1, "-").concat(p2, "-").concat(p3, "-").concat(p4, "-").concat(p5, "}");
 };
+/** `{8-4-4-4-12}` hex, the braced RFC-4122 form Excel writes for comment and person ids. */
+var BRACED_GUID = /^\{[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}\}$/;
+export var isBracedGuid = function (id) { return BRACED_GUID.test(id); };
 /**
  * Workbook-scoped author registry. Shared across every sheet's collector so
  * an author who comments on multiple sheets maps to a single `person` entry
@@ -125,9 +128,16 @@ var ThreadedCommentsCollector = /** @class */ (function () {
     ThreadedCommentsCollector.prototype.isEmpty = function () {
         return this.placed.length === 0;
     };
-    /** Braced root GUID for a thread — used as both the root `id` and `tc=`. */
+    /**
+     * Braced root GUID for a thread — used as both the root `id` and `tc=`.
+     * An id that already is a braced GUID (what Excel and both importers
+     * produce) passes through, so a re-exported thread keeps the identity
+     * Excel assigned it; anything else is hashed deterministically.
+     */
     ThreadedCommentsCollector.prototype.rootGuid = function (thread) {
-        return deterministicGuid("tc:".concat(thread.id));
+        return isBracedGuid(thread.id)
+            ? thread.id.toUpperCase()
+            : deterministicGuid("tc:".concat(thread.id));
     };
     /**
      * Legacy `xl/comments{N}.xml` mirror entries. Feed these into the existing
@@ -169,7 +179,9 @@ var ThreadedCommentsCollector = /** @class */ (function () {
                 var personId = _this.persons.register(msg.authorId, msg.authorName);
                 var id = index === 0
                     ? root
-                    : deterministicGuid("c:".concat(thread.id, ":").concat(msg.id));
+                    : isBracedGuid(msg.id)
+                        ? msg.id.toUpperCase()
+                        : deterministicGuid("c:".concat(thread.id, ":").concat(msg.id));
                 var parent = index === 0 ? "" : " parentId=\"".concat(root, "\"");
                 // Resolved state rides on the root as `done="1"` (MS-XLSX);
                 // replies never carry it.

package/dist/cjs/exporter/xlsx/xlsx-export.d.ts

@@ -1,5 +1,5 @@
 import type { CellData, Citation, CommentThread, DataValidationRuleRecord, IterativeCalculationOptions, SheetData, TextFormat } from "@rowsncolumns/common-types";
-import type { Color, ConditionalFormatRule, EmbeddedChart, EmbeddedObject, NamedRange, PivotTable, Sheet, Slicer, SpreadsheetTheme, TableView } from "@rowsncolumns/spreadsheet";
+import type { Color, ConditionalFormatRule, EmbeddedChart, EmbeddedObject, NamedRange, PivotTable, ProtectedRange, Sheet, Slicer, SpreadsheetTheme, TableView } from "@rowsncolumns/spreadsheet";
 import type { CellXfs, SharedStrings as SharedStringsType } from "@rowsncolumns/spreadsheet-state";
 import type { PowerQueryParts } from "../../power-query";
 import type { ExternalLink, WorkbookProperties } from "../../excel-parser/types";
@@ -32,6 +32,15 @@ export type ExportExcelProps<S extends Sheet, T extends CellData, C extends Cita
     pivotTables?: PivotTable[];
     externalLinks?: ExternalLink[];
     namedRanges?: NamedRange[];
+    /**
+     * Allow-edit ranges (`useSpreadsheetState`'s `protectedRanges`), written as
+     * `<protectedRanges>/<protectedRange sqref name>` on the sheet each range's
+     * `range.sheetId` names. Sheet-level protection is read from
+     * `Sheet.sheetProtection` and written as `<sheetProtection …>`; both sit
+     * right after `<sheetData>` per `CT_Worksheet`, the position the parser and
+     * `rnc-import` read them back from.
+     */
+    protectedRanges?: ProtectedRange[];
     /**
      * Workbook-wide named cell styles to round-trip into the
      * `<cellStyles>` block of styles.xml. Parsed by the importer as
@@ -109,7 +118,7 @@ export type ExportExcelProps<S extends Sheet, T extends CellData, C extends Cita
      */
     properties?: WorkbookProperties;
 };
-export declare const createExcelFile: <S extends Sheet, T extends CellData, C extends Citation>({ conditionalFormats: _conditionalFormats, dataValidations: _dataValidations, sheets, sheetData, sharedStrings: sourceSharedStrings, tables: _tables, cellXfs, theme, defaultFont, embeds, charts, slicers, pivotTables, externalLinks, namedRanges, namedCellStyles, customTableStyles, iterativeCalculationOptions, ignoreFormulaPatterns, citations, comments, password, locale, use1904, properties, powerQuery, }: ExportExcelProps<S, T, C>) => Promise<Uint8Array<ArrayBufferLike>>;
+export declare const createExcelFile: <S extends Sheet, T extends CellData, C extends Citation>({ conditionalFormats: _conditionalFormats, dataValidations: _dataValidations, sheets, sheetData, sharedStrings: sourceSharedStrings, tables: _tables, cellXfs, theme, defaultFont, embeds, charts, slicers, pivotTables, externalLinks, namedRanges, protectedRanges, namedCellStyles, customTableStyles, iterativeCalculationOptions, ignoreFormulaPatterns, citations, comments, password, locale, use1904, properties, powerQuery, }: ExportExcelProps<S, T, C>) => Promise<Uint8Array<ArrayBufferLike>>;
 /**
  * Normalize a dataValidation sqref list: collapse degenerate ranges
  * (`C7:C7` → `C7`), drop exact duplicates, and drop members fully contained