@rowsncolumns/toolkit 24.4.3 → 24.4.5

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"}

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/xlsx-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xlsx-export.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/xlsx-export.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xlsx-export.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/xlsx-export.ts"],"names":[],"mappings":"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"}