@rowsncolumns/toolkit 24.4.3 → 24.4.4

package/dist/esm/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/esm/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/esm/exporter/xlsx/chartex-builder.js

@@ -0,0 +1,97 @@
+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 const CHART_EX_REL_TYPE = "http://schemas.microsoft.com/office/2014/relationships/chartEx";
+export const CHART_EX_CONTENT_TYPE = "application/vnd.ms-office.chartex+xml";
+export const CHART_EX_NS = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+const CHART_EX_1_NS = "http://schemas.microsoft.com/office/drawing/2015/9/8/chartex";
+const A_NS = "http://schemas.openxmlformats.org/drawingml/2006/main";
+const R_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+const MC_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+const XML_DECLARATION = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n`;
+/** `{XXXXXXXX-XXXX-4XXX-XXXX-XXXXXXXXXXXX}` — the series `uniqueId` Excel expects. */
+const guid = () => {
+    const hex = () => Math.floor(Math.random() * 16).toString(16).toUpperCase();
+    const block = (n) => Array.from({ length: n }, hex).join("");
+    return `{${block(8)}-${block(4)}-4${block(3)}-${block(4)}-${block(12)}}`;
+};
+/** `'Sheet'!A2:B9` → `'Sheet'!$A$2:$B$9` — Excel writes chart data references absolute. */
+const absoluteRef = (ref) => {
+    const bang = ref.lastIndexOf("!");
+    const sheetPart = bang >= 0 ? ref.slice(0, bang + 1) : "";
+    const cells = bang >= 0 ? ref.slice(bang + 1) : ref;
+    return `${sheetPart}${cells.replace(/\$?([A-Z]+)\$?(\d+)/g, "$$$1$$$2")}`;
+};
+const escapeText = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+/** Chart types that live in a chartex part rather than a `c:chartSpace`. */
+export const isChartExType = (chartType) => chartType === "treemap" || chartType === "sunburst";
+const primarySource = (entry) => entry?.sources?.[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 const hierarchyRange = (spec) => {
+    const leaf = primarySource(spec.labels?.[0]);
+    if (!leaf)
+        return undefined;
+    const parents = (spec.parentLabels ?? [])
+        .map((entry) => primarySource(entry))
+        .filter((range) => Boolean(range));
+    if (!parents.length)
+        return leaf;
+    const sameRows = parents.every((p) => p.sheetId === leaf.sheetId &&
+        p.startRowIndex === leaf.startRowIndex &&
+        p.endRowIndex === leaf.endRowIndex);
+    if (!sameRows)
+        return leaf;
+    const columns = [...parents, leaf].map((r) => r.startColumnIndex).sort((a, b) => a - b);
+    const contiguous = columns.every((c, i) => i === 0 || c === columns[i - 1] + 1);
+    if (!contiguous || columns[columns.length - 1] !== leaf.startColumnIndex) {
+        return leaf;
+    }
+    return { ...leaf, startColumnIndex: columns[0], endColumnIndex: leaf.endColumnIndex };
+};
+/** `xl/charts/chartEx{N}.xml` for a treemap / sunburst; undefined when the spec has no data. */
+export const buildChartExXml = (chart, sheetNameById) => {
+    const spec = chart.spec;
+    if (!isChartExType(spec.chartType))
+        return undefined;
+    const cat = hierarchyRange(spec);
+    const size = primarySource(spec.sizeData?.[0]);
+    if (!cat || !size)
+        return undefined;
+    const catAddress = cellRangeToAddress(sheetNameById.get(cat.sheetId), cat);
+    const sizeAddress = cellRangeToAddress(sheetNameById.get(size.sheetId), size);
+    if (!catAddress || !sizeAddress)
+        return undefined;
+    const catRef = absoluteRef(catAddress);
+    const sizeRef = absoluteRef(sizeAddress);
+    const title = chart.spec.title;
+    const titleXml = title
+        ? `<cx:title pos="t" align="ctr" overlay="0"><cx:tx><cx:txData><cx:v>${escapeText(title)}</cx:v></cx:txData></cx:tx></cx:title>`
+        : "";
+    const isTreemap = spec.chartType === "treemap";
+    const 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>`;
+    const layoutPr = isTreemap
+        ? `<cx:layoutPr><cx:parentLabelLayout val="banner"/></cx:layoutPr>`
+        : "";
+    const legend = isTreemap ? `<cx:legend pos="t" align="ctr" overlay="0"/>` : "";
+    return `${XML_DECLARATION}<cx:chartSpace xmlns:a="${A_NS}" xmlns:r="${R_NS}" xmlns:cx="${CHART_EX_NS}"><cx:chartData><cx:data id="0"><cx:strDim type="cat"><cx:f>${escapeText(catRef)}</cx:f></cx:strDim><cx:numDim type="size"><cx:f>${escapeText(sizeRef)}</cx:f></cx:numDim></cx:data></cx:chartData><cx:chart>${titleXml}<cx:plotArea><cx:plotAreaRegion><cx:series layoutId="${spec.chartType}" uniqueId="${guid()}">${dataLabels}<cx:dataId val="0"/>${layoutPr}</cx:series></cx:plotAreaRegion></cx:plotArea>${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 const buildChartExGraphicFrameXml = ({ relId, frameId, widthEmu, heightEmu, }) => `<mc:AlternateContent xmlns:mc="${MC_NS}"><mc:Choice xmlns:cx1="${CHART_EX_1_NS}" Requires="cx1"><xdr:graphicFrame macro=""><xdr:nvGraphicFramePr><xdr:cNvPr id="${frameId}" name="Chart ${frameId}"/><xdr:cNvGraphicFramePr/></xdr:nvGraphicFramePr><xdr:xfrm><a:off x="0" y="0"/><a:ext cx="${widthEmu}" cy="${heightEmu}"/></xdr:xfrm><a:graphic><a:graphicData uri="${CHART_EX_NS}"><cx:chart xmlns:cx="${CHART_EX_NS}" xmlns:r="${R_NS}" r:id="${relId}"/></a:graphicData></a:graphic></xdr:graphicFrame></mc:Choice></mc:AlternateContent>`;

package/dist/esm/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/esm/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/esm/exporter/xlsx/form-controls-builder.js

@@ -0,0 +1,173 @@
+/**
+ * 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 const CTRL_PROP_CONTENT_TYPE = "application/vnd.ms-excel.controlproperties+xml";
+export const CTRL_PROP_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp";
+export const FORM_CONTROL_NS = "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main";
+const MC_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+const XDR_NS = "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing";
+const XML_DECLARATION = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n`;
+const escapeAttr = (value) => value
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+const escapeText = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+const attrsXml = (attrs) => Object.entries(attrs ?? {})
+    .filter(([key, value]) => key && value != null)
+    .map(([key, value]) => ` ${key}="${escapeAttr(String(value))}"`)
+    .join("");
+/** `xl/ctrlProps/ctrlPropN.xml` body. */
+export const buildCtrlPropXml = (spec) => {
+    const { objectType: _ignored, ...rest } = spec.properties ?? {};
+    const items = (spec.listItems ?? [])
+        .map((item) => `<item val="${escapeAttr(item)}"/>`)
+        .join("");
+    const body = items ? `<itemLst>${items}</itemLst>` : "";
+    const open = `<formControlPr xmlns="${FORM_CONTROL_NS}" objectType="${escapeAttr(spec.objectType)}"${attrsXml(rest)}`;
+    return `${XML_DECLARATION}${body ? `${open}>${body}</formControlPr>` : `${open}/>`}`;
+};
+const cellAnchorXml = (tag, anchor) => `<${tag}><xdr:col>${anchor.col}</xdr:col><xdr:colOff>${Math.round(anchor.colOff)}</xdr:colOff><xdr:row>${anchor.row}</xdr:row><xdr:rowOff>${Math.round(anchor.rowOff)}</xdr:rowOff></${tag}>`;
+/** One `<control>` element (inside the `<controls>` wrapper). */
+export const buildControlElementXml = ({ spec, relId, shapeId, from, to, }) => {
+    const name = spec.name ?? `${spec.objectType} ${shapeId}`;
+    const anchorAttrs = (spec.moveWithCells ? ' moveWithCells="1"' : "") +
+        (spec.sizeWithCells ? ' sizeWithCells="1"' : "");
+    return `<control shapeId="${shapeId}" r:id="${relId}" name="${escapeAttr(name)}"><controlPr${attrsXml(spec.controlProperties)}><anchor${anchorAttrs}>${cellAnchorXml("from", from)}${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 const buildControlsXml = (controlElements) => {
+    if (!controlElements.length)
+        return "";
+    return `<controls xmlns:mc="${MC_NS}" xmlns:xdr="${XDR_NS}" xmlns:x14="${FORM_CONTROL_NS}"><mc:AlternateContent><mc:Choice Requires="x14">${controlElements.join("")}</mc:Choice></mc:AlternateContent></controls>`;
+};
+/** `formControlPr/@objectType` → VML `x:ClientData/@ObjectType`. */
+const VML_OBJECT_TYPE = {
+    CheckBox: "Checkbox",
+    EditBox: "Edit",
+};
+const truthy = (value) => 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.
+ */
+const clientDataChildrenXml = (spec) => {
+    const p = spec.properties ?? {};
+    const c = spec.controlProperties ?? {};
+    const out = [];
+    const push = (tag, value) => {
+        if (value === undefined)
+            out.push(`<x:${tag}/>`);
+        else
+            out.push(`<x:${tag}>${escapeText(value)}</x:${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 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>`;
+const toPt = (px) => `${(px * 0.75).toFixed(2).replace(/\.?0+$/, "")}pt`;
+/** One `<v:shape>` drawing a form control. */
+export const buildFormControlVmlShape = ({ spec, shapeId, zIndex, geometry, }) => {
+    const objectType = VML_OBJECT_TYPE[spec.objectType] ?? spec.objectType;
+    const caption = spec.text
+        ? `<div style="text-align:left"><font face="Tahoma" size="160" color="auto">${escapeText(spec.text)}</font></div>`
+        : "";
+    const clientData = clientDataChildrenXml(spec).replace("__ANCHOR__", `<x:Anchor>${geometry.anchor.join(", ")}</x:Anchor>`);
+    const style = `position:absolute;margin-left:${toPt(geometry.leftPx)};margin-top:${toPt(geometry.topPx)};width:${toPt(geometry.widthPx)};height:${toPt(geometry.heightPx)};z-index:${zIndex};mso-wrap-style:tight`;
+    return `<v:shape id="_x0000_s${shapeId}" type="#_x0000_t201" style="${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">${caption}</v:textbox><x:ClientData ObjectType="${escapeAttr(objectType)}">${clientData}</x:ClientData></v:shape>`;
+};
+/** Wrap note + control shapes into one `vmlDrawing` part. */
+export const buildVmlDrawingXml = ({ shapeTypes, 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>${shapeTypes.join("")}${shapes.join("")}</xml>`;
+};

package/dist/esm/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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"}