@rowsncolumns/toolkit 24.4.3 → 24.4.5

package/dist/esm/excel-parser/plugins/xlsb/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsb/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsb/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/excel-parser/plugins/xlsb/index.js

@@ -11,6 +11,7 @@ import { processChart } from "../xlsx/charts";
 import { processAnchors } from "../xlsx/drawing";
 import { readAllRecordHeaders } from "./biff-record-reader";
 import { standardExcelFormatCodeById } from "../xlsx/numfmt";
+import { DATE_1904_OFFSET_DAYS, isEpochShiftedFormat } from "../xlsx/styles";
 import { extractThemeColors, extractThemeFonts, generateDarkThemeColors, } from "../xlsx/theme";
 const RT = {
     BrtCellRk: 0x0002,
@@ -939,7 +940,7 @@ const resolveXf = (styles, xfIndex) => {
         indent: xf.indent ?? parent.indent,
     };
 };
-const toCellData = (parsed, styles, sharedStrings, enableCellXfsRegistry, enableSharedStrings, cellXfs) => {
+const toCellData = (parsed, styles, sharedStrings, enableCellXfsRegistry, enableSharedStrings, cellXfs, use1904) => {
     const xf = resolveXf(styles, parsed.styleRef);
     const format = {};
     const pattern = xf
@@ -1052,7 +1053,13 @@ const toCellData = (parsed, styles, sharedStrings, enableCellXfsRegistry, enable
         };
     }
     if (parsed.kind === "n") {
-        const value = Number(parsed.value);
+        // A 1904-system workbook (`BrtWbProp.fDate1904`) stores date serials
+        // 1462 days below the engine's 1900 system; date-formatted numbers are
+        // converted on the way in, like the XLSX importer does.
+        const value = Number(parsed.value) +
+            (use1904 && isEpochShiftedFormat(format.numberFormat?.type)
+                ? DATE_1904_OFFSET_DAYS
+                : 0);
         const pattern = format.numberFormat?.pattern ?? "GENERAL";
         const fv = ssfFormat(pattern, value);
         // If there's a formula, use it in ue.fv, otherwise use the numeric value
@@ -1861,7 +1868,7 @@ export class XlsbPlugin extends BaseWorkbookPlugin {
                     row = { values: [] };
                     rows.set(parsed.row, row);
                 }
-                row.values[parsed.col] = toCellData(parsed, this.styles, this.sharedStrings, enableCellXfsRegistry, enableSharedStrings, this.cellXfs);
+                row.values[parsed.col] = toCellData(parsed, this.styles, this.sharedStrings, enableCellXfsRegistry, enableSharedStrings, this.cellXfs, this.use1904);
             }
             // Apply merge cell formatting
             // In Excel, merged cells should have formatting from the top-left (anchor) cell

package/dist/esm/excel-parser/plugins/xlsx/chartex.d.ts

@@ -0,0 +1,37 @@
+import type { EmbeddedChart, SheetRange } from "@rowsncolumns/spreadsheet";
+import type { StreamingZipParser } from "../../zip-parser-streaming";
+import { type ResolveSheetId, type SheetDimensions } from "./charts";
+/**
+ * Excel 2016+ "chartex" charts (`xl/charts/chartEx{N}.xml`, namespace
+ * `http://schemas.microsoft.com/office/drawing/2014/chartex`): treemap,
+ * sunburst, histogram / pareto, box & whisker, waterfall, funnel. They are
+ * anchored through an `mc:AlternateContent` whose `Choice` graphic frame
+ * carries `<cx:chart r:id>` instead of `<c:chart>`, and their data lives in
+ * `<cx:chartData><cx:data>` dimensions (`strDim type="cat"` for the
+ * hierarchy, `numDim type="size"|"val"` for the numbers) referenced by the
+ * series through `<cx:dataId>`.
+ *
+ * The exporter counterpart is `exporter/xlsx/chartex-builder.ts`.
+ */
+export declare const CHART_EX_REL_TYPE = "http://schemas.microsoft.com/office/2014/relationships/chartEx";
+export declare const CHART_EX_GRAPHIC_URI = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+/**
+ * `<cx:chart r:id>` inside an anchor's `mc:AlternateContent` choice (Excel
+ * also writes a plain `xdr:graphicFrame` for some producers — both forms are
+ * checked). Returns the `cx:chart` node or undefined for non-chartex anchors.
+ */
+export declare function getChartExReferenceFromAnchor(anchor: any): any;
+/**
+ * Split a multi-column hierarchy range (Excel lays the treemap hierarchy out
+ * as columns, top level first, leaf last) into `parentLabels` (one entry per
+ * parent column) and `labels` (the leaf column).
+ */
+export declare const splitHierarchyRange: (range: SheetRange) => {
+    parentLabels: SheetRange[];
+    labels: SheetRange;
+};
+/** Parse a `cx:chartSpace` DOM into an `EmbeddedChart` spec (null when unsupported). */
+export declare function parseChartExSpec(chartSpaceDom: any, sheetId: number, resolveSheetId?: ResolveSheetId): EmbeddedChart["spec"] | null;
+/** Resolve + parse one chartex part referenced from a drawing anchor. */
+export declare function processChartEx(chartTarget: string, drawingPath: string, anchor: any, sheetId: number, zipParser: StreamingZipParser, xmlParser: any, sheetDimensions?: SheetDimensions, resolveSheetId?: ResolveSheetId): Promise<EmbeddedChart | null>;
+//# sourceMappingURL=chartex.d.ts.map

package/dist/esm/excel-parser/plugins/xlsx/chartex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartex.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/chartex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,UAAU,EACX,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,iBAAiB,mEACoC,CAAC;AACnE,eAAO,MAAM,oBAAoB,6DAC2B,CAAC;AAyB7D;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAoB9D;AA8BD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,UAAU,KAChB;IAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAalD,CAAC;AAWF,wFAAwF;AACxF,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,GAAG,EAClB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,cAAc,GAC9B,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CA0D9B;AAED,yEAAyE;AACzE,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,GAAG,EACd,eAAe,CAAC,EAAE,eAAe,EACjC,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAsB/B"}

package/dist/esm/excel-parser/plugins/xlsx/chartex.js

@@ -0,0 +1,199 @@
+import { generateSelectionsFromFormula, uuid } from "@rowsncolumns/utils";
+import { get } from "lodash-es";
+import { extractChartPosition, } from "./charts";
+/**
+ * Excel 2016+ "chartex" charts (`xl/charts/chartEx{N}.xml`, namespace
+ * `http://schemas.microsoft.com/office/drawing/2014/chartex`): treemap,
+ * sunburst, histogram / pareto, box & whisker, waterfall, funnel. They are
+ * anchored through an `mc:AlternateContent` whose `Choice` graphic frame
+ * carries `<cx:chart r:id>` instead of `<c:chart>`, and their data lives in
+ * `<cx:chartData><cx:data>` dimensions (`strDim type="cat"` for the
+ * hierarchy, `numDim type="size"|"val"` for the numbers) referenced by the
+ * series through `<cx:dataId>`.
+ *
+ * The exporter counterpart is `exporter/xlsx/chartex-builder.ts`.
+ */
+export const CHART_EX_REL_TYPE = "http://schemas.microsoft.com/office/2014/relationships/chartEx";
+export const CHART_EX_GRAPHIC_URI = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+const asArray = (value) => value == null ? [] : Array.isArray(value) ? value : [value];
+/** Read a child by local name, tolerating any namespace prefix. */
+const child = (node, localName) => {
+    if (!node || typeof node !== "object")
+        return undefined;
+    if (node[localName] !== undefined)
+        return node[localName];
+    for (const key of Object.keys(node)) {
+        const colon = key.indexOf(":");
+        if (colon >= 0 && key.slice(colon + 1) === localName)
+            return node[key];
+    }
+    return undefined;
+};
+const textOf = (node) => {
+    if (node == null)
+        return undefined;
+    if (typeof node === "object") {
+        const inner = node.t$;
+        return inner == null ? undefined : String(inner);
+    }
+    return String(node);
+};
+/**
+ * `<cx:chart r:id>` inside an anchor's `mc:AlternateContent` choice (Excel
+ * also writes a plain `xdr:graphicFrame` for some producers — both forms are
+ * checked). Returns the `cx:chart` node or undefined for non-chartex anchors.
+ */
+export function getChartExReferenceFromAnchor(anchor) {
+    const frames = [];
+    for (const alternate of asArray(child(anchor, "AlternateContent"))) {
+        for (const choice of asArray(child(alternate, "Choice"))) {
+            frames.push(...asArray(child(choice, "graphicFrame")));
+        }
+    }
+    frames.push(...asArray(child(anchor, "graphicFrame")));
+    for (const frame of frames) {
+        const graphicData = child(child(frame, "graphic"), "graphicData");
+        if (!graphicData)
+            continue;
+        const uri = get(graphicData, "a$.uri");
+        const cxChart = child(graphicData, "chart");
+        if (uri === CHART_EX_GRAPHIC_URI && cxChart)
+            return cxChart;
+        // A `cx:`-prefixed chart element without the uri attribute (defensive).
+        if (cxChart && Object.keys(graphicData).some((k) => k.startsWith("cx:"))) {
+            return cxChart;
+        }
+    }
+    return undefined;
+}
+/** `layoutId` → engine chart type. Unknown layouts are not imported. */
+const CHART_TYPE_BY_LAYOUT = {
+    treemap: "treemap",
+    sunburst: "sunburst",
+    waterfall: "waterfall",
+    funnel: "funnel",
+    boxWhisker: "boxplot",
+    // `clusteredColumn` is a histogram / pareto only when it carries `<cx:binning>`.
+};
+const sourcesFromRef = (ref, hostSheetId, resolveSheetId) => {
+    if (!ref)
+        return [];
+    const selections = generateSelectionsFromFormula(`=${ref}`);
+    return selections.map((sel) => ({
+        ...sel.range,
+        sheetId: (sel.sheetName ? resolveSheetId?.(sel.sheetName) : undefined) ??
+            hostSheetId,
+    }));
+};
+const chartData = (sources) => ({ sources });
+/**
+ * Split a multi-column hierarchy range (Excel lays the treemap hierarchy out
+ * as columns, top level first, leaf last) into `parentLabels` (one entry per
+ * parent column) and `labels` (the leaf column).
+ */
+export const splitHierarchyRange = (range) => {
+    const parentLabels = [];
+    for (let c = range.startColumnIndex; c < range.endColumnIndex; c++) {
+        parentLabels.push({ ...range, startColumnIndex: c, endColumnIndex: c });
+    }
+    return {
+        parentLabels,
+        labels: {
+            ...range,
+            startColumnIndex: range.endColumnIndex,
+            endColumnIndex: range.endColumnIndex,
+        },
+    };
+};
+const dimensionRef = (data, dimTag, type) => {
+    const dims = asArray(child(data, dimTag)).filter((dim) => get(dim, "a$.type") === type);
+    const dim = dims[0] ?? (dimTag === "numDim" ? asArray(child(data, dimTag))[0] : undefined);
+    const f = child(dim, "f");
+    return textOf(Array.isArray(f) ? f[0] : f)?.trim() || undefined;
+};
+/** Parse a `cx:chartSpace` DOM into an `EmbeddedChart` spec (null when unsupported). */
+export function parseChartExSpec(chartSpaceDom, sheetId, resolveSheetId) {
+    const chartSpace = child(chartSpaceDom, "chartSpace") ?? chartSpaceDom;
+    const chart = child(chartSpace, "chart");
+    if (!chart)
+        return null;
+    const region = child(child(chart, "plotArea"), "plotAreaRegion");
+    const series = asArray(child(region, "series"))[0];
+    if (!series)
+        return null;
+    const layoutId = String(get(series, "a$.layoutId") ?? "");
+    // Excel nests `<cx:binning>` in `<cx:layoutPr>`; tolerate it directly on the series too.
+    const binning = child(child(series, "layoutPr"), "binning") ?? child(series, "binning");
+    const chartType = layoutId === "clusteredColumn" && binning
+        ? "histogram"
+        : CHART_TYPE_BY_LAYOUT[layoutId];
+    if (!chartType)
+        return null;
+    const dataId = String(get(child(series, "dataId"), "a$.val") ?? "0");
+    const data = asArray(child(child(chartSpace, "chartData"), "data")).find((d) => String(get(d, "a$.id")) === dataId) ?? asArray(child(child(chartSpace, "chartData"), "data"))[0];
+    if (!data)
+        return null;
+    const title = textOf(child(child(child(child(chart, "title"), "tx"), "txData"), "v"));
+    const catRef = dimensionRef(data, "strDim", "cat");
+    const catSources = sourcesFromRef(catRef, sheetId, resolveSheetId);
+    if (chartType === "treemap" || chartType === "sunburst") {
+        const sizeRef = dimensionRef(data, "numDim", "size");
+        const sizeSources = sourcesFromRef(sizeRef, sheetId, resolveSheetId);
+        if (!catSources.length || !sizeSources.length)
+            return null;
+        const hierarchy = splitHierarchyRange(catSources[0]);
+        return {
+            chartType,
+            ...(title ? { title } : {}),
+            labels: [chartData([hierarchy.labels])],
+            parentLabels: hierarchy.parentLabels.map((range) => chartData([range])),
+            sizeData: [chartData(sizeSources)],
+        };
+    }
+    const valRef = dimensionRef(data, "numDim", "val");
+    const valSources = sourcesFromRef(valRef, sheetId, resolveSheetId);
+    if (!valSources.length)
+        return null;
+    const spec = {
+        chartType,
+        ...(title ? { title } : {}),
+        series: [chartData(valSources)],
+        ...(catSources.length ? { domains: [chartData(catSources)] } : {}),
+    };
+    if (chartType === "histogram") {
+        const binCount = Number(get(child(binning, "binCount"), "a$.val"));
+        if (Number.isFinite(binCount) && binCount > 0)
+            spec.binCount = binCount;
+    }
+    return spec;
+}
+/** Resolve + parse one chartex part referenced from a drawing anchor. */
+export async function processChartEx(chartTarget, drawingPath, anchor, sheetId, zipParser, xmlParser, sheetDimensions, resolveSheetId) {
+    let chartPath = chartTarget;
+    const drawingDir = drawingPath.substring(0, drawingPath.lastIndexOf("/"));
+    if (chartPath.startsWith("/")) {
+        chartPath = chartPath.slice(1);
+    }
+    else if (chartPath.startsWith("../")) {
+        chartPath = `xl/${chartPath.replace("../", "")}`;
+    }
+    else if (!chartPath.startsWith("xl/")) {
+        chartPath = `${drawingDir}/${chartPath}`;
+    }
+    let content;
+    try {
+        content = await zipParser.getText(chartPath);
+    }
+    catch {
+        return null;
+    }
+    if (!content)
+        return null;
+    const spec = parseChartExSpec(xmlParser.parse(content), sheetId, resolveSheetId);
+    if (!spec)
+        return null;
+    const position = extractChartPosition(anchor, sheetId, sheetDimensions);
+    if (!position)
+        return null;
+    return { chartId: uuid(), spec, position };
+}

package/dist/esm/excel-parser/plugins/xlsx/form-controls.d.ts

@@ -0,0 +1,70 @@
+import type { EmbeddedObject } from "@rowsncolumns/spreadsheet";
+export declare const CTRL_PROP_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp";
+export declare const VML_DRAWING_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing";
+type CellAnchor = {
+    col: number;
+    colOff: number;
+    row: number;
+    rowOff: number;
+};
+/**
+ * `<controlPr><anchor><from>…</from><to>…</to></anchor>` → the engine's
+ * pixel overlay position (1-based anchor cell, EMU offsets → px, size from
+ * the cell span at the grid defaults — the same approximation the drawing
+ * importer uses for `twoCellAnchor`s).
+ */
+export declare const controlAnchorToOverlayPosition: (from: CellAnchor, to: CellAnchor | undefined) => {
+    anchorCell: {
+        rowIndex: number;
+        columnIndex: number;
+    };
+    offsetXPixels?: number;
+    offsetYPixels?: number;
+    widthPixels?: number;
+    heightPixels?: number;
+};
+/**
+ * Parse an `xl/ctrlProps/ctrlPropN.xml` part: `objectType`, every other
+ * `formControlPr` attribute verbatim, and the literal `itemLst` items.
+ */
+export declare const parseFormControlPr: (ctrlPropDom: any) => {
+    objectType: string;
+    properties: Record<string, string>;
+    listItems?: string[];
+} | undefined;
+/**
+ * Captions live only in the legacy VML part: `<v:shape id="_x0000_s1025">
+ * … <v:textbox><div>Check Box 1</div></v:textbox>`. Returns shapeId → text.
+ * VML is scanned textually — Excel's VML is not reliably well-formed XML.
+ */
+export declare const parseVmlControlCaptions: (vml: string | undefined) => Map<number, string>;
+export type RawWorksheetControl = {
+    shapeId?: number;
+    name?: string;
+    relId?: string;
+    controlProperties: Record<string, string>;
+    moveWithCells?: boolean;
+    sizeWithCells?: boolean;
+    from?: CellAnchor;
+    to?: CellAnchor;
+};
+/**
+ * `<controls>` from a worksheet DOM, whether wrapped in
+ * `<mc:AlternateContent><mc:Choice Requires="x14">` (Excel) or bare.
+ */
+export declare const readWorksheetControls: (sheetDom: any) => RawWorksheetControl[];
+/**
+ * Assemble the sheet's form controls. `loadCtrlProp` resolves a control's
+ * `r:id` to its parsed `ctrlProp` DOM (undefined when the part is missing —
+ * the control is then skipped, Excel would repair it the same way).
+ */
+export declare const buildFormControlEmbeds: ({ controls, sheetId, ctrlProps, captions, }: {
+    controls: RawWorksheetControl[];
+    sheetId: number;
+    ctrlProps: Map<string, ReturnType<typeof parseFormControlPr>>;
+    captions: Map<number, string>;
+}) => EmbeddedObject[];
+/** The `r:id` of a worksheet's `<legacyDrawing>` (VML part), if any. */
+export declare const readLegacyDrawingRelId: (sheetDom: any) => string | undefined;
+export {};
+//# sourceMappingURL=form-controls.d.ts.map

package/dist/esm/excel-parser/plugins/xlsx/form-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-controls.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/form-controls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2BAA2B,CAAC;AAgBnC,eAAO,MAAM,kBAAkB,iFACiD,CAAC;AACjF,eAAO,MAAM,oBAAoB,mFACiD,CAAC;AA6CnF,KAAK,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAe/E;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,GACzC,MAAM,UAAU,EAChB,IAAI,UAAU,GAAG,SAAS;gBAKZ;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;oBACrC,MAAM;oBACN,MAAM;kBACR,MAAM;mBACL,MAAM;CAiBxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,GAAG,KACf;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,GAAG,SAkBH,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,KAAK,MAAM,GAAG,SAAS,KACtB,GAAG,CAAC,MAAM,EAAE,MAAM,CAwBpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,EAAE,CAAC,EAAE,UAAU,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,GAAG,KAAG,mBAAmB,EA+BxE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,6CAKpC;IACD,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAC9D,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B,KAAG,cAAc,EA+BjB,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,GAAI,UAAU,GAAG,KAAG,MAAM,GAAG,SAK/D,CAAC"}

package/dist/esm/excel-parser/plugins/xlsx/form-controls.js

@@ -0,0 +1,246 @@
+/**
+ * Excel form controls (`<controls>` in the worksheet + `xl/ctrlProps/*` +
+ * the legacy VML shape). Parsed into `EmbeddedObject`s with an
+ * {@link EmbedFormControlSpec} so the exporter can write the same three
+ * parts back (`exporter/xlsx/form-controls-builder.ts`). The grid does not
+ * run the control; the spec is a faithful, opaque carrier of what Excel
+ * stored.
+ */
+const EMU_PER_PIXEL = 9525;
+/** Grid defaults used to size a control from its cell-span anchor. */
+const DEFAULT_COLUMN_WIDTH_PX = 100;
+const DEFAULT_ROW_HEIGHT_PX = 20;
+export const CTRL_PROP_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp";
+export const VML_DRAWING_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing";
+const asArray = (value) => value == null ? [] : Array.isArray(value) ? value : [value];
+/** Read a child by local name, tolerating any namespace prefix. */
+const childByLocalName = (node, localName) => {
+    if (!node || typeof node !== "object")
+        return undefined;
+    if (node[localName] !== undefined)
+        return node[localName];
+    for (const key of Object.keys(node)) {
+        const colon = key.indexOf(":");
+        if (colon >= 0 && key.slice(colon + 1) === localName) {
+            return node[key];
+        }
+    }
+    return undefined;
+};
+/** Text of a leaf element (`t$` when it carries attributes, else the value). */
+const textOf = (node) => {
+    if (node == null)
+        return undefined;
+    if (typeof node === "object") {
+        const inner = node.t$;
+        return inner == null ? undefined : String(inner);
+    }
+    return String(node);
+};
+const numberOf = (node) => {
+    const text = textOf(node);
+    const value = text == null ? Number.NaN : Number(text);
+    return Number.isFinite(value) ? value : 0;
+};
+const attrs = (node) => {
+    const raw = node?.a$;
+    const out = {};
+    if (!raw || typeof raw !== "object")
+        return out;
+    for (const [key, value] of Object.entries(raw)) {
+        if (value == null)
+            continue;
+        out[key] = String(value);
+    }
+    return out;
+};
+const readCellAnchor = (node) => {
+    if (!node)
+        return undefined;
+    const col = childByLocalName(node, "col");
+    const row = childByLocalName(node, "row");
+    if (col === undefined || row === undefined)
+        return undefined;
+    return {
+        col: numberOf(col),
+        colOff: numberOf(childByLocalName(node, "colOff")),
+        row: numberOf(row),
+        rowOff: numberOf(childByLocalName(node, "rowOff")),
+    };
+};
+/**
+ * `<controlPr><anchor><from>…</from><to>…</to></anchor>` → the engine's
+ * pixel overlay position (1-based anchor cell, EMU offsets → px, size from
+ * the cell span at the grid defaults — the same approximation the drawing
+ * importer uses for `twoCellAnchor`s).
+ */
+export const controlAnchorToOverlayPosition = (from, to) => {
+    const offsetXPixels = Math.round(from.colOff / EMU_PER_PIXEL);
+    const offsetYPixels = Math.round(from.rowOff / EMU_PER_PIXEL);
+    const overlay = {
+        anchorCell: { rowIndex: from.row + 1, columnIndex: from.col + 1 },
+    };
+    if (offsetXPixels)
+        overlay.offsetXPixels = offsetXPixels;
+    if (offsetYPixels)
+        overlay.offsetYPixels = offsetYPixels;
+    if (to) {
+        const width = (to.col - from.col) * DEFAULT_COLUMN_WIDTH_PX +
+            (to.colOff - from.colOff) / EMU_PER_PIXEL;
+        const height = (to.row - from.row) * DEFAULT_ROW_HEIGHT_PX +
+            (to.rowOff - from.rowOff) / EMU_PER_PIXEL;
+        if (width > 0)
+            overlay.widthPixels = Math.round(width);
+        if (height > 0)
+            overlay.heightPixels = Math.round(height);
+    }
+    return overlay;
+};
+/**
+ * Parse an `xl/ctrlProps/ctrlPropN.xml` part: `objectType`, every other
+ * `formControlPr` attribute verbatim, and the literal `itemLst` items.
+ */
+export const parseFormControlPr = (ctrlPropDom) => {
+    const root = childByLocalName(ctrlPropDom, "formControlPr");
+    if (!root)
+        return undefined;
+    const { objectType, ...properties } = attrs(root);
+    if (!objectType)
+        return undefined;
+    // Namespace declarations ride along as attributes in fast-xml-parser.
+    for (const key of Object.keys(properties)) {
+        if (key === "xmlns" || key.startsWith("xmlns:"))
+            delete properties[key];
+    }
+    const itemLst = childByLocalName(root, "itemLst");
+    const listItems = asArray(childByLocalName(itemLst, "item"))
+        .map((item) => attrs(item).val)
+        .filter((val) => typeof val === "string");
+    return {
+        objectType,
+        properties,
+        ...(listItems.length ? { listItems } : {}),
+    };
+};
+/**
+ * Captions live only in the legacy VML part: `<v:shape id="_x0000_s1025">
+ * … <v:textbox><div>Check Box 1</div></v:textbox>`. Returns shapeId → text.
+ * VML is scanned textually — Excel's VML is not reliably well-formed XML.
+ */
+export const parseVmlControlCaptions = (vml) => {
+    const captions = new Map();
+    if (!vml)
+        return captions;
+    const shapeRe = /<v:shape\b([^>]*)>([\s\S]*?)<\/v:shape>/g;
+    let match;
+    while ((match = shapeRe.exec(vml))) {
+        const idMatch = /\bid="_x0000_s(\d+)"/.exec(match[1]);
+        if (!idMatch)
+            continue;
+        const body = match[2];
+        if (!/<x:ClientData\b/.test(body))
+            continue;
+        const textbox = /<v:textbox\b[^>]*>([\s\S]*?)<\/v:textbox>/.exec(body);
+        if (!textbox)
+            continue;
+        const text = textbox[1]
+            .replace(/<br\s*\/?>/gi, "\n")
+            .replace(/<[^>]+>/g, "")
+            .replace(/&amp;/g, "&")
+            .replace(/&lt;/g, "<")
+            .replace(/&gt;/g, ">")
+            .replace(/&quot;/g, '"')
+            .replace(/&#(\d+);/g, (_, code) => String.fromCodePoint(Number(code)))
+            .trim();
+        if (text)
+            captions.set(Number(idMatch[1]), text);
+    }
+    return captions;
+};
+/**
+ * `<controls>` from a worksheet DOM, whether wrapped in
+ * `<mc:AlternateContent><mc:Choice Requires="x14">` (Excel) or bare.
+ */
+export const readWorksheetControls = (sheetDom) => {
+    const worksheet = childByLocalName(sheetDom, "worksheet") ?? sheetDom;
+    const controls = childByLocalName(worksheet, "controls");
+    if (!controls)
+        return [];
+    const controlNodes = [...asArray(childByLocalName(controls, "control"))];
+    for (const alternate of asArray(childByLocalName(controls, "AlternateContent"))) {
+        for (const choice of asArray(childByLocalName(alternate, "Choice"))) {
+            controlNodes.push(...asArray(childByLocalName(choice, "control")));
+        }
+    }
+    return controlNodes.map((node) => {
+        const a = attrs(node);
+        const controlPr = childByLocalName(node, "controlPr");
+        const anchor = childByLocalName(controlPr, "anchor");
+        const anchorAttrs = attrs(anchor);
+        const shapeId = Number(a.shapeId);
+        return {
+            ...(Number.isFinite(shapeId) && a.shapeId ? { shapeId } : {}),
+            ...(a.name ? { name: a.name } : {}),
+            ...(a["r:id"] ?? a.id ? { relId: a["r:id"] ?? a.id } : {}),
+            controlProperties: attrs(controlPr),
+            ...(anchorAttrs.moveWithCells !== undefined
+                ? { moveWithCells: anchorAttrs.moveWithCells === "1" || anchorAttrs.moveWithCells === "true" }
+                : {}),
+            ...(anchorAttrs.sizeWithCells !== undefined
+                ? { sizeWithCells: anchorAttrs.sizeWithCells === "1" || anchorAttrs.sizeWithCells === "true" }
+                : {}),
+            from: readCellAnchor(childByLocalName(anchor, "from")),
+            to: readCellAnchor(childByLocalName(anchor, "to")),
+        };
+    });
+};
+/**
+ * Assemble the sheet's form controls. `loadCtrlProp` resolves a control's
+ * `r:id` to its parsed `ctrlProp` DOM (undefined when the part is missing —
+ * the control is then skipped, Excel would repair it the same way).
+ */
+export const buildFormControlEmbeds = ({ controls, sheetId, ctrlProps, captions, }) => {
+    const embeds = [];
+    controls.forEach((control, index) => {
+        const parsed = control.relId ? ctrlProps.get(control.relId) : undefined;
+        if (!parsed || !control.from)
+            return;
+        const spec = {
+            type: "formControl",
+            objectType: parsed.objectType,
+            properties: parsed.properties,
+        };
+        if (control.name)
+            spec.name = control.name;
+        if (control.shapeId !== undefined)
+            spec.shapeId = control.shapeId;
+        const caption = control.shapeId !== undefined ? captions.get(control.shapeId) : undefined;
+        if (caption)
+            spec.text = caption;
+        if (parsed.listItems)
+            spec.listItems = parsed.listItems;
+        if (Object.keys(control.controlProperties).length) {
+            spec.controlProperties = control.controlProperties;
+        }
+        if (control.moveWithCells !== undefined)
+            spec.moveWithCells = control.moveWithCells;
+        if (control.sizeWithCells !== undefined)
+            spec.sizeWithCells = control.sizeWithCells;
+        embeds.push({
+            embedId: `control-${sheetId}-${control.shapeId ?? index + 1}`,
+            spec,
+            position: {
+                sheetId,
+                overlayPosition: controlAnchorToOverlayPosition(control.from, control.to),
+            },
+        });
+    });
+    return embeds;
+};
+/** The `r:id` of a worksheet's `<legacyDrawing>` (VML part), if any. */
+export const readLegacyDrawingRelId = (sheetDom) => {
+    const worksheet = childByLocalName(sheetDom, "worksheet") ?? sheetDom;
+    const legacy = childByLocalName(worksheet, "legacyDrawing");
+    const a = attrs(legacy);
+    return a["r:id"] ?? a.id;
+};

package/dist/esm/excel-parser/plugins/xlsx/index.d.ts

@@ -1,5 +1,5 @@
 import type { CellFormat, ConditionalFormatRule, DataValidationRuleRecord, EmbeddedChart, EmbeddedObject, NamedRange, ProtectedRange, Sheet, Slicer, SpreadsheetTheme, TableView } from "@rowsncolumns/spreadsheet";
-import type { CommentThread, TextFormat, TextFormatRun } from "@rowsncolumns/common-types";
+import type { NamedCellStyle, CommentThread, TextFormat, TextFormatRun } from "@rowsncolumns/common-types";
 import { XMLParser } from "fast-xml-parser";
 import type { IWorkbookPlugin } from "../../interface";
 import type { ExternalLink, ProcessSheetDataForSheetOptions, ProcessSheetDataResult, SheetCatalogEntry, WorkbookProperties } from "../../types";
@@ -252,6 +252,8 @@ export declare class XlsxPlugin extends BaseWorkbookPlugin implements IWorkbookP
     getSheetData(rid: string): Promise<any>;
     getStyles(): any;
     getTheme(): SpreadsheetTheme;
+    /** `<cellStyles>` resolved to cell formats (toolbar "Workbook styles" gallery). */
+    getNamedCellStyles(): NamedCellStyle[];
     /**
      * The workbook default font — styles.xml fonts[0], the font every cell
      * without an explicit font inherits. Exporters pass this through so the
@@ -294,6 +296,12 @@ export declare class XlsxPlugin extends BaseWorkbookPlugin implements IWorkbookP
     releaseSheetCaches(sheetId: number): void;
     private processOneSheet;
     getDrawings(): Promise<EmbeddedObjectWithPosition[]>;
+    /**
+     * Form controls: `<controls><control r:id>` → `xl/ctrlProps/ctrlPropN.xml`
+     * (+ the caption from the sheet's legacy VML part), as `formControl`
+     * embeds. Nothing is rendered interactively — they round-trip.
+     */
+    _getFormControls(rid: string, sheetId: number, sheetData: any): Promise<EmbeddedObject[]>;
     getCharts(): Promise<EmbeddedChart[]>;
     /**
      * Phase D1 — extract every pivot table across every worksheet.