@rowsncolumns/toolkit 24.4.2 → 24.4.4

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

@@ -5,13 +5,14 @@ import { XMLParser } from "fast-xml-parser";
 import { get } from "lodash-es";
 import { parseRgce } from "./rgce-parser";
 import { StreamingZipParser } from "../../zip-parser-streaming";
-import { createFilterSpecsFromAutoFilter, excelColumnWidthToPixels, getRangeFromAddressRef, } from "../../helpers";
+import { createFilterSpecsFromAutoFilter, excelColumnWidthToPixels, getRangeFromAddressRef, parseTableColumnTotals, } from "../../helpers";
 import { defaultSpreadsheetTheme } from "../../theme-default";
 import { BaseWorkbookPlugin } from "../base/index";
 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";
 var RT = {
     BrtCellRk: 0x0002,
@@ -300,10 +301,17 @@ var parseBrtShrFmla = function (payload) {
 var parseWsView = function (payload) {
     var reader = new Reader(payload);
     var flags = reader.readUInt16LE();
-    // Bit 1 (0x0002): fShowGridLines - if 0, gridlines are hidden
-    var showGridLines = (flags & 0x0002) !== 0;
-    return { showGridLines: showGridLines };
+    // MS-XLSB 2.4.865 BrtWsView flag word: A fWnProt (0x0001), B fDspFmla
+    // (0x0002), C fDspGrid (0x0004), D fDspRwCol (0x0008), E fDspZeros
+    // (0x0010), F fRightToLeft (0x0020), G fSelected (0x0040), … Excel writes
+    // 0x039c for a plain sheet and 0x0398 for `showGridLines="0"`: gridlines
+    // are bit C, not bit B (which is "show formulas" and is normally clear).
+    var showGridLines = (flags & 0x0004) !== 0;
+    // OOXML `<sheetView rightToLeft="1">`.
+    var rightToLeft = (flags & 0x0020) !== 0;
+    return { showGridLines: showGridLines, rightToLeft: rightToLeft };
 };
+export var parseBrtWsViewPayload = parseWsView;
 var parsePane = function (payload) {
     var reader = new Reader(payload);
     var xSplit = reader.readFloat64LE();
@@ -962,8 +970,8 @@ var resolveXf = function (styles, xfIndex) {
         indent: (_e = xf.indent) !== null && _e !== void 0 ? _e : parent.indent,
     };
 };
-var toCellData = function (parsed, styles, sharedStrings, enableCellXfsRegistry, enableSharedStrings, cellXfs) {
-    var _a, _b, _c, _d, _e;
+var toCellData = function (parsed, styles, sharedStrings, enableCellXfsRegistry, enableSharedStrings, cellXfs, use1904) {
+    var _a, _b, _c, _d, _e, _f;
     var xf = resolveXf(styles, parsed.styleRef);
     var format = {};
     var pattern = xf
@@ -1053,8 +1061,14 @@ var toCellData = function (parsed, styles, sharedStrings, enableCellXfsRegistry,
                 : {})), { ue: ue, ev: { sv: text } }), (parsed.formula ? {} : { fv: text }));
     }
     if (parsed.kind === "n") {
-        var value = Number(parsed.value);
-        var pattern_1 = (_e = (_d = format.numberFormat) === null || _d === void 0 ? void 0 : _d.pattern) !== null && _e !== void 0 ? _e : "GENERAL";
+        // 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.
+        var value = Number(parsed.value) +
+            (use1904 && isEpochShiftedFormat((_d = format.numberFormat) === null || _d === void 0 ? void 0 : _d.type)
+                ? DATE_1904_OFFSET_DAYS
+                : 0);
+        var pattern_1 = (_f = (_e = format.numberFormat) === null || _e === void 0 ? void 0 : _e.pattern) !== null && _f !== void 0 ? _f : "GENERAL";
         var fv = ssfFormat(pattern_1, value);
         // If there's a formula, use it in ue.fv, otherwise use the numeric value
         var ue = parsed.formula ? { fv: "=".concat(parsed.formula) } : { nv: value };
@@ -1299,6 +1313,7 @@ var XlsbPlugin = /** @class */ (function (_super) {
                         sheet.rowMetadata = stats.rowMetadata;
                         sheet.columnMetadata = stats.columnMetadata;
                         sheet.showGridLines = stats.showGridLines;
+                        sheet.rightToLeft = stats.rightToLeft;
                         sheet.frozenRowCount = stats.frozenRowCount;
                         sheet.frozenColumnCount = stats.frozenColumnCount;
                         sheet.basicFilterRange = stats.basicFilterRange;
@@ -1731,12 +1746,13 @@ var XlsbPlugin = /** @class */ (function (_super) {
                         columns = columnDefsArray.map(function (colDef) {
                             var _a;
                             var name = ((_a = colDef === null || colDef === void 0 ? void 0 : colDef.a$) === null || _a === void 0 ? void 0 : _a.name) || "";
+                            var totals = parseTableColumnTotals(colDef);
                             var calculatedColumnFormula = get(colDef, "calculatedColumnFormula") ||
                                 get(colDef, "x:calculatedColumnFormula");
                             if (calculatedColumnFormula) {
-                                return { name: name, formula: calculatedColumnFormula };
+                                return __assign(__assign({ name: name }, totals), { formula: calculatedColumnFormula });
                             }
-                            return { name: name };
+                            return __assign({ name: name }, totals);
                         });
                         autoFilter = (_d = tableDefinition.autoFilter) !== null && _d !== void 0 ? _d : tableDefinition["x:autoFilter"];
                         filterSpecs = createFilterSpecsFromAutoFilter(autoFilter);
@@ -1785,7 +1801,7 @@ var XlsbPlugin = /** @class */ (function (_super) {
     };
     XlsbPlugin.prototype.scanSheetStats = function (path) {
         return __awaiter(this, void 0, void 0, function () {
-            var binary, records, currentRow, maxRow, maxCol, prevCol, merges, rowMetadata, columnMetadata, showGridLines, frozenRowCount, frozenColumnCount, basicFilterRange, tablePartRelIds, records_5, records_5_1, record, payload, view, pane, relId, parsedRow, parsedCol, col, dimensionProps, merge, parsed;
+            var binary, records, currentRow, maxRow, maxCol, prevCol, merges, rowMetadata, columnMetadata, showGridLines, rightToLeft, frozenRowCount, frozenColumnCount, basicFilterRange, tablePartRelIds, records_5, records_5_1, record, payload, view, pane, relId, parsedRow, parsedCol, col, dimensionProps, merge, parsed;
             var e_14, _a;
             var _this = this;
             return __generator(this, function (_b) {
@@ -1809,6 +1825,8 @@ var XlsbPlugin = /** @class */ (function (_super) {
                                 if (record.type === RT.BrtWsView) {
                                     view = parseWsView(payload);
                                     showGridLines = view.showGridLines;
+                                    if (view.rightToLeft)
+                                        rightToLeft = true;
                                     continue;
                                 }
                                 if (record.type === RT.BrtPane) {
@@ -1898,6 +1916,7 @@ var XlsbPlugin = /** @class */ (function (_super) {
                                 rowMetadata: rowMetadata,
                                 columnMetadata: columnMetadata,
                                 showGridLines: showGridLines,
+                                rightToLeft: rightToLeft,
                                 frozenRowCount: frozenRowCount,
                                 frozenColumnCount: frozenColumnCount,
                                 basicFilterRange: basicFilterRange,
@@ -1962,9 +1981,9 @@ var XlsbPlugin = /** @class */ (function (_super) {
                                                     sheet.basicFilterRange.startColumnIndex &&
                                                 t.range.endColumnIndex === sheet.basicFilterRange.endColumnIndex;
                                         })) === null || _d === void 0 ? void 0 : _d.filterSpecs;
-                                        sheets.push(__assign(__assign(__assign(__assign({ sheetId: sheet.sheetId, title: sheet.title, hidden: sheet.hidden, rowCount: Math.max(minRowCount, sheet.rowCount), columnCount: Math.max(minColumnCount, sheet.columnCount), rowMetadata: sheet.rowMetadata, columnMetadata: sheet.columnMetadata, merges: sheet.merges }, (sheet.showGridLines !== undefined
+                                        sheets.push(__assign(__assign(__assign(__assign(__assign({ sheetId: sheet.sheetId, title: sheet.title, hidden: sheet.hidden, rowCount: Math.max(minRowCount, sheet.rowCount), columnCount: Math.max(minColumnCount, sheet.columnCount), rowMetadata: sheet.rowMetadata, columnMetadata: sheet.columnMetadata, merges: sheet.merges }, (sheet.showGridLines !== undefined
                                             ? { showGridLines: sheet.showGridLines }
-                                            : {})), (sheet.frozenRowCount !== undefined && sheet.frozenRowCount > 0
+                                            : {})), (sheet.rightToLeft ? { rightToLeft: true } : {})), (sheet.frozenRowCount !== undefined && sheet.frozenRowCount > 0
                                             ? { frozenRowCount: sheet.frozenRowCount }
                                             : {})), (sheet.frozenColumnCount !== undefined && sheet.frozenColumnCount > 0
                                             ? { frozenColumnCount: sheet.frozenColumnCount }
@@ -2156,7 +2175,7 @@ var XlsbPlugin = /** @class */ (function (_super) {
                                                 row = { values: [] };
                                                 rows.set(parsed.row, row);
                                             }
-                                            row.values[parsed.col] = toCellData(parsed, this_2.styles, this_2.sharedStrings, enableCellXfsRegistry, enableSharedStrings, this_2.cellXfs);
+                                            row.values[parsed.col] = toCellData(parsed, this_2.styles, this_2.sharedStrings, enableCellXfsRegistry, enableSharedStrings, this_2.cellXfs, this_2.use1904);
                                         };
                                         try {
                                             for (records_7 = (e_19 = void 0, __values(records)), records_7_1 = records_7.next(); !records_7_1.done; records_7_1 = records_7.next()) {

package/dist/cjs/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/cjs/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/cjs/excel-parser/plugins/xlsx/chartex.js

@@ -0,0 +1,244 @@
+import { __assign, __awaiter, __generator, __read, __spreadArray, __values } from "tslib";
+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 var CHART_EX_REL_TYPE = "http://schemas.microsoft.com/office/2014/relationships/chartEx";
+export var CHART_EX_GRAPHIC_URI = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+var asArray = function (value) {
+    return value == null ? [] : Array.isArray(value) ? value : [value];
+};
+/** Read a child by local name, tolerating any namespace prefix. */
+var child = function (node, localName) {
+    var e_1, _a;
+    if (!node || typeof node !== "object")
+        return undefined;
+    if (node[localName] !== undefined)
+        return node[localName];
+    try {
+        for (var _b = __values(Object.keys(node)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var key = _c.value;
+            var colon = key.indexOf(":");
+            if (colon >= 0 && key.slice(colon + 1) === localName)
+                return node[key];
+        }
+    }
+    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 undefined;
+};
+var textOf = function (node) {
+    if (node == null)
+        return undefined;
+    if (typeof node === "object") {
+        var 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) {
+    var e_2, _a, e_3, _b, e_4, _c;
+    var frames = [];
+    try {
+        for (var _d = __values(asArray(child(anchor, "AlternateContent"))), _e = _d.next(); !_e.done; _e = _d.next()) {
+            var alternate = _e.value;
+            try {
+                for (var _f = (e_3 = void 0, __values(asArray(child(alternate, "Choice")))), _g = _f.next(); !_g.done; _g = _f.next()) {
+                    var choice = _g.value;
+                    frames.push.apply(frames, __spreadArray([], __read(asArray(child(choice, "graphicFrame"))), false));
+                }
+            }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
+                }
+                finally { if (e_3) throw e_3.error; }
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    frames.push.apply(frames, __spreadArray([], __read(asArray(child(anchor, "graphicFrame"))), false));
+    try {
+        for (var frames_1 = __values(frames), frames_1_1 = frames_1.next(); !frames_1_1.done; frames_1_1 = frames_1.next()) {
+            var frame = frames_1_1.value;
+            var graphicData = child(child(frame, "graphic"), "graphicData");
+            if (!graphicData)
+                continue;
+            var uri = get(graphicData, "a$.uri");
+            var 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(function (k) { return k.startsWith("cx:"); })) {
+                return cxChart;
+            }
+        }
+    }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    finally {
+        try {
+            if (frames_1_1 && !frames_1_1.done && (_c = frames_1.return)) _c.call(frames_1);
+        }
+        finally { if (e_4) throw e_4.error; }
+    }
+    return undefined;
+}
+/** `layoutId` → engine chart type. Unknown layouts are not imported. */
+var 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>`.
+};
+var sourcesFromRef = function (ref, hostSheetId, resolveSheetId) {
+    if (!ref)
+        return [];
+    var selections = generateSelectionsFromFormula("=".concat(ref));
+    return selections.map(function (sel) {
+        var _a;
+        return (__assign(__assign({}, sel.range), { sheetId: (_a = (sel.sheetName ? resolveSheetId === null || resolveSheetId === void 0 ? void 0 : resolveSheetId(sel.sheetName) : undefined)) !== null && _a !== void 0 ? _a : hostSheetId }));
+    });
+};
+var chartData = function (sources) {
+    return ({ 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 var splitHierarchyRange = function (range) {
+    var parentLabels = [];
+    for (var c = range.startColumnIndex; c < range.endColumnIndex; c++) {
+        parentLabels.push(__assign(__assign({}, range), { startColumnIndex: c, endColumnIndex: c }));
+    }
+    return {
+        parentLabels: parentLabels,
+        labels: __assign(__assign({}, range), { startColumnIndex: range.endColumnIndex, endColumnIndex: range.endColumnIndex }),
+    };
+};
+var dimensionRef = function (data, dimTag, type) {
+    var _a, _b;
+    var dims = asArray(child(data, dimTag)).filter(function (dim) { return get(dim, "a$.type") === type; });
+    var dim = (_a = dims[0]) !== null && _a !== void 0 ? _a : (dimTag === "numDim" ? asArray(child(data, dimTag))[0] : undefined);
+    var f = child(dim, "f");
+    return ((_b = textOf(Array.isArray(f) ? f[0] : f)) === null || _b === void 0 ? void 0 : _b.trim()) || undefined;
+};
+/** Parse a `cx:chartSpace` DOM into an `EmbeddedChart` spec (null when unsupported). */
+export function parseChartExSpec(chartSpaceDom, sheetId, resolveSheetId) {
+    var _a, _b, _c, _d, _e;
+    var chartSpace = (_a = child(chartSpaceDom, "chartSpace")) !== null && _a !== void 0 ? _a : chartSpaceDom;
+    var chart = child(chartSpace, "chart");
+    if (!chart)
+        return null;
+    var region = child(child(chart, "plotArea"), "plotAreaRegion");
+    var series = asArray(child(region, "series"))[0];
+    if (!series)
+        return null;
+    var layoutId = String((_b = get(series, "a$.layoutId")) !== null && _b !== void 0 ? _b : "");
+    // Excel nests `<cx:binning>` in `<cx:layoutPr>`; tolerate it directly on the series too.
+    var binning = (_c = child(child(series, "layoutPr"), "binning")) !== null && _c !== void 0 ? _c : child(series, "binning");
+    var chartType = layoutId === "clusteredColumn" && binning
+        ? "histogram"
+        : CHART_TYPE_BY_LAYOUT[layoutId];
+    if (!chartType)
+        return null;
+    var dataId = String((_d = get(child(series, "dataId"), "a$.val")) !== null && _d !== void 0 ? _d : "0");
+    var data = (_e = asArray(child(child(chartSpace, "chartData"), "data")).find(function (d) { return String(get(d, "a$.id")) === dataId; })) !== null && _e !== void 0 ? _e : asArray(child(child(chartSpace, "chartData"), "data"))[0];
+    if (!data)
+        return null;
+    var title = textOf(child(child(child(child(chart, "title"), "tx"), "txData"), "v"));
+    var catRef = dimensionRef(data, "strDim", "cat");
+    var catSources = sourcesFromRef(catRef, sheetId, resolveSheetId);
+    if (chartType === "treemap" || chartType === "sunburst") {
+        var sizeRef = dimensionRef(data, "numDim", "size");
+        var sizeSources = sourcesFromRef(sizeRef, sheetId, resolveSheetId);
+        if (!catSources.length || !sizeSources.length)
+            return null;
+        var hierarchy = splitHierarchyRange(catSources[0]);
+        return __assign(__assign({ chartType: chartType }, (title ? { title: title } : {})), { labels: [chartData([hierarchy.labels])], parentLabels: hierarchy.parentLabels.map(function (range) { return chartData([range]); }), sizeData: [chartData(sizeSources)] });
+    }
+    var valRef = dimensionRef(data, "numDim", "val");
+    var valSources = sourcesFromRef(valRef, sheetId, resolveSheetId);
+    if (!valSources.length)
+        return null;
+    var spec = __assign(__assign(__assign({ chartType: chartType }, (title ? { title: title } : {})), { series: [chartData(valSources)] }), (catSources.length ? { domains: [chartData(catSources)] } : {}));
+    if (chartType === "histogram") {
+        var 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 function processChartEx(chartTarget, drawingPath, anchor, sheetId, zipParser, xmlParser, sheetDimensions, resolveSheetId) {
+    return __awaiter(this, void 0, void 0, function () {
+        var chartPath, drawingDir, content, _a, spec, position;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    chartPath = chartTarget;
+                    drawingDir = drawingPath.substring(0, drawingPath.lastIndexOf("/"));
+                    if (chartPath.startsWith("/")) {
+                        chartPath = chartPath.slice(1);
+                    }
+                    else if (chartPath.startsWith("../")) {
+                        chartPath = "xl/".concat(chartPath.replace("../", ""));
+                    }
+                    else if (!chartPath.startsWith("xl/")) {
+                        chartPath = "".concat(drawingDir, "/").concat(chartPath);
+                    }
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, zipParser.getText(chartPath)];
+                case 2:
+                    content = _b.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    _a = _b.sent();
+                    return [2 /*return*/, null];
+                case 4:
+                    if (!content)
+                        return [2 /*return*/, null];
+                    spec = parseChartExSpec(xmlParser.parse(content), sheetId, resolveSheetId);
+                    if (!spec)
+                        return [2 /*return*/, null];
+                    position = extractChartPosition(anchor, sheetId, sheetDimensions);
+                    if (!position)
+                        return [2 /*return*/, null];
+                    return [2 /*return*/, { chartId: uuid(), spec: spec, position: position }];
+            }
+        });
+    });
+}

package/dist/cjs/excel-parser/plugins/xlsx/charts.d.ts

@@ -17,6 +17,16 @@ export declare function extractChartDataRange(plotArea: any, chartType: string,
 export declare function extractHiddenDimensionStrategy(chart: any): HIDDEN_DIMENSION_STRATEGY | undefined;
 export declare function extractChartTitle(chart: any): string;
 export declare function determineChartType(chart: any): "bar" | "column" | "line" | "pie" | "doughnut" | "area" | "radar" | "stock" | "scatter" | "bubble" | "treemap" | "sunburst" | "histogram" | "boxplot" | "waterfall" | "funnel";
+/**
+ * The authored 3-D / surface chart class, when the plot area's chart
+ * element is one of Excel's 3-D variants. These degrade to their 2-D
+ * `chartType` (bar3DChart → bar/column, line3DChart → line, pie3DChart →
+ * pie, area3DChart / surfaceChart / surface3DChart → area) and the
+ * original class is preserved verbatim as `sourceChartType`, matching the
+ * Rust importer, so the renderer's echarts-gl pipeline and the exporter's
+ * 3-D writer can restore it. Undefined for plain 2-D charts.
+ */
+export declare function extractThreeDSourceChartType(plotArea: any): "BAR_3D" | "LINE_3D" | "PIE_3D" | "AREA_3D" | "SURFACE" | "SURFACE_3D" | undefined;
 /**
  * Phase 5.5 — pull binCount out of the c15:histogramChart extension
  * marker. Returns undefined if absent.

package/dist/cjs/excel-parser/plugins/xlsx/charts.d.ts.map

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

package/dist/cjs/excel-parser/plugins/xlsx/charts.js

@@ -50,7 +50,7 @@ function toInt(value) {
 }
 export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParser, xmlParser, sheetDimensions, resolveSheetId) {
     return __awaiter(this, void 0, void 0, function () {
-        var chartPath, drawingDir, chartContent, chartXml, chart, chartSpaceRoot, roundedCornersRaw, roundedCornersVal, roundedCorners, chartId, title, titleTextFormat, chartType, plotArea, series, domains, dataRange, bubbleSizes, scatterStyle, hiddenDimensionStrategy, position, legend, dataLabels, _a, valueAxisOptions, secondaryValueAxisOptions, categoryAxisOptions, doughnutHoleSize, ofPieOptions, radarStyle, binCount, barLayout, err_1;
+        var chartPath, drawingDir, chartContent, chartXml, chart, chartSpaceRoot, roundedCornersRaw, roundedCornersVal, roundedCorners, chartId, title, titleTextFormat, chartType, plotArea, series, domains, dataRange, bubbleSizes, scatterStyle, hiddenDimensionStrategy, position, legend, dataLabels, _a, valueAxisOptions, secondaryValueAxisOptions, categoryAxisOptions, doughnutHoleSize, ofPieOptions, threeDSourceChartType, radarStyle, binCount, barLayout, err_1;
         var _b;
         return __generator(this, function (_c) {
             switch (_c.label) {
@@ -119,6 +119,7 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                     _a = extractAxisOptions(plotArea), valueAxisOptions = _a.valueAxisOptions, secondaryValueAxisOptions = _a.secondaryValueAxisOptions, categoryAxisOptions = _a.categoryAxisOptions;
                     doughnutHoleSize = chartType === "doughnut" ? extractDoughnutHoleSize(plotArea) : undefined;
                     ofPieOptions = chartType === "pie" ? extractOfPieOptions(plotArea) : undefined;
+                    threeDSourceChartType = extractThreeDSourceChartType(plotArea);
                     radarStyle = chartType === "radar" ? extractRadarStyle(plotArea) : undefined;
                     binCount = chartType === "histogram"
                         ? extractC15HistogramBinCount(plotArea)
@@ -128,7 +129,7 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                         : undefined;
                     return [2 /*return*/, {
                             chartId: chartId,
-                            spec: __assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({ title: title }, (titleTextFormat ? { titleTextFormat: titleTextFormat } : {})), { chartType: chartType, domains: domains, series: series, dataRange: dataRange, hiddenDimensionStrategy: hiddenDimensionStrategy }), (chartType === "scatter" || chartType === "bubble"
+                            spec: __assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({ title: title }, (titleTextFormat ? { titleTextFormat: titleTextFormat } : {})), { chartType: chartType, domains: domains, series: series, dataRange: dataRange, hiddenDimensionStrategy: hiddenDimensionStrategy }), (chartType === "scatter" || chartType === "bubble"
                                 ? { bubbleLabels: [] }
                                 : {})), (bubbleSizes && bubbleSizes.length ? { bubbleSizes: bubbleSizes } : {})), (scatterStyle
                                 ? { scatterStyle: scatterStyle }
@@ -137,7 +138,9 @@ export function processChart(chartTarget, drawingPath, anchor, sheetId, zipParse
                                 : {})), (categoryAxisOptions ? { categoryAxisOptions: categoryAxisOptions } : {})), (typeof doughnutHoleSize === "number"
                                 ? { doughnutHoleSize: doughnutHoleSize }
                                 : {})), (ofPieOptions
-                                ? __assign({ sourceChartType: "OF_PIE" }, ofPieOptions) : {})), (radarStyle ? { radarStyle: radarStyle } : {})), (typeof binCount === "number" ? { binCount: binCount } : {})), ((barLayout === null || barLayout === void 0 ? void 0 : barLayout.stackedType)
+                                ? __assign({ sourceChartType: "OF_PIE" }, ofPieOptions) : {})), (threeDSourceChartType && !ofPieOptions
+                                ? { sourceChartType: threeDSourceChartType }
+                                : {})), (radarStyle ? { radarStyle: radarStyle } : {})), (typeof binCount === "number" ? { binCount: binCount } : {})), ((barLayout === null || barLayout === void 0 ? void 0 : barLayout.stackedType)
                                 ? { stackedType: barLayout.stackedType }
                                 : {})), (typeof (barLayout === null || barLayout === void 0 ? void 0 : barLayout.overlap) === "number"
                                 ? { overlap: barLayout.overlap }
@@ -208,6 +211,12 @@ function getSeriesElements(plotArea, chartType) {
                 "areaChart.ser",
                 "c:area3DChart.c:ser",
                 "area3DChart.ser",
+                // Surface / contour charts degrade to area (sourceChartType
+                // SURFACE / SURFACE_3D); their series carry the same cat/val shape.
+                "c:surfaceChart.c:ser",
+                "surfaceChart.ser",
+                "c:surface3DChart.c:ser",
+                "surface3DChart.ser",
             ]);
         case "radar":
             return getWithFallback(plotArea, ["c:radarChart.c:ser", "radarChart.ser"]);
@@ -552,6 +561,12 @@ export function determineChartType(chart) {
         "areaChart",
         "c:area3DChart",
         "area3DChart",
+        // Surface / contour degrade to area — the same 2-D base the Rust
+        // importer and the renderer's surface pipeline use.
+        "c:surfaceChart",
+        "surfaceChart",
+        "c:surface3DChart",
+        "surface3DChart",
     ]))
         return "area";
     if (getWithFallback(plotArea, ["c:radarChart", "radarChart"]))
@@ -566,6 +581,31 @@ export function determineChartType(chart) {
         return "bubble";
     return "column"; // default
 }
+/**
+ * The authored 3-D / surface chart class, when the plot area's chart
+ * element is one of Excel's 3-D variants. These degrade to their 2-D
+ * `chartType` (bar3DChart → bar/column, line3DChart → line, pie3DChart →
+ * pie, area3DChart / surfaceChart / surface3DChart → area) and the
+ * original class is preserved verbatim as `sourceChartType`, matching the
+ * Rust importer, so the renderer's echarts-gl pipeline and the exporter's
+ * 3-D writer can restore it. Undefined for plain 2-D charts.
+ */
+export function extractThreeDSourceChartType(plotArea) {
+    var has = function (paths) { return Boolean(getWithFallback(plotArea, paths)); };
+    if (has(["c:bar3DChart", "bar3DChart"]))
+        return "BAR_3D";
+    if (has(["c:line3DChart", "line3DChart"]))
+        return "LINE_3D";
+    if (has(["c:pie3DChart", "pie3DChart"]))
+        return "PIE_3D";
+    if (has(["c:area3DChart", "area3DChart"]))
+        return "AREA_3D";
+    if (has(["c:surface3DChart", "surface3DChart"]))
+        return "SURFACE_3D";
+    if (has(["c:surfaceChart", "surfaceChart"]))
+        return "SURFACE";
+    return undefined;
+}
 /**
  * Phase 5.5 — detect the c15 extension marker our exporter writes on
  * the plotArea. Returns the originating chart type (histogram /
@@ -744,7 +784,16 @@ var CHART_TYPE_CONTAINERS = [
         chartType: "line",
     },
     {
-        paths: ["c:areaChart", "areaChart", "c:area3DChart", "area3DChart"],
+        paths: [
+            "c:areaChart",
+            "areaChart",
+            "c:area3DChart",
+            "area3DChart",
+            "c:surfaceChart",
+            "surfaceChart",
+            "c:surface3DChart",
+            "surface3DChart",
+        ],
         chartType: "area",
     },
     {
@@ -1896,13 +1945,23 @@ function extractDataLabelsOptions(plotArea, chartType) {
     var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
     // Look for <c:dLbls> inside the chartType-specific container. We pick
     // the first one we find — chart-level labels apply to all series.
+    // The 3-D classes (bar3DChart / line3DChart / pie3DChart / area3DChart)
+    // degrade to the same `chartType` and carry `<c:dLbls>` in the same slot
+    // of their group, so they are looked up alongside the 2-D container.
     var containerKeys = {
-        bar: ["c:barChart", "barChart"],
-        column: ["c:barChart", "barChart"],
-        line: ["c:lineChart", "lineChart"],
-        pie: ["c:pieChart", "pieChart", "c:ofPieChart", "ofPieChart"],
+        bar: ["c:barChart", "barChart", "c:bar3DChart", "bar3DChart"],
+        column: ["c:barChart", "barChart", "c:bar3DChart", "bar3DChart"],
+        line: ["c:lineChart", "lineChart", "c:line3DChart", "line3DChart"],
+        pie: [
+            "c:pieChart",
+            "pieChart",
+            "c:ofPieChart",
+            "ofPieChart",
+            "c:pie3DChart",
+            "pie3DChart",
+        ],
         doughnut: ["c:doughnutChart", "doughnutChart"],
-        area: ["c:areaChart", "areaChart"],
+        area: ["c:areaChart", "areaChart", "c:area3DChart", "area3DChart"],
     };
     var keys = (_b = containerKeys[chartType]) !== null && _b !== void 0 ? _b : [];
     var container;

package/dist/cjs/excel-parser/plugins/xlsx/drawing.d.ts

@@ -1,9 +1,28 @@
-import type { EmbeddedObject, EmbedShapeSpec } from "@rowsncolumns/spreadsheet";
+import type { EmbeddedObject, EmbedImageSpec, EmbedShapeSpec } from "@rowsncolumns/spreadsheet";
 import { type XMLParser } from "fast-xml-parser";
 import { type StreamingZipParser } from "../../zip-parser-streaming";
 export type EmbeddedObjectWithPosition = EmbeddedObject & {
     isInsideCell?: boolean;
 };
+/** `processAnchors` anchor-type tags, keyed by the drawing element name. */
+declare const ANCHOR_KIND_BY_ELEMENT: {
+    readonly oneCellAnchor: "oneCellAnchor";
+    readonly twoCellAnchor: "twoCellAnchors";
+    readonly absoluteAnchor: "absoluteAnchors";
+};
+type AnchorElementName = keyof typeof ANCHOR_KIND_BY_ELEMENT;
+/**
+ * The `<xdr:wsDr>` anchors in document order — Excel's z-order (first is
+ * the back-most object). The unordered parse keeps document order within one
+ * element name but groups the three anchor kinds apart, so the kind sequence
+ * is read off the raw part and the parsed nodes are dealt out in that order.
+ * Anchors the scan does not account for (namespace quirks) trail in their
+ * parsed order, so nothing is ever dropped.
+ */
+export declare function anchorsInDocumentOrder(drawing: any, drawingXml: string): Array<{
+    kind: (typeof ANCHOR_KIND_BY_ELEMENT)[AnchorElementName];
+    node: any;
+}>;
 /**
  * Process different types of image anchors
  * @param anchors The anchor elements from the drawing
@@ -15,6 +34,13 @@ export type EmbeddedObjectWithPosition = EmbeddedObject & {
  * @returns An array of image objects with their properties and binary data
  */
 export declare function processAnchors(anchors: any, anchorType: string, drawingPath: string, sheetId: number, zipParser: StreamingZipParser, xmlParser: XMLParser): Promise<EmbeddedObjectWithPosition[]>;
+/**
+ * Picture-format adjustments off an `<xdr:pic>`: `<a:blipFill><a:srcRect>`
+ * (crop), `<a:blip><a:lum bright contrast>` (brightness / contrast) and
+ * `<a:blip><a:alphaModFix amt>` (opacity → `transparency`). Only present
+ * values are returned so an untouched picture stays a bare image spec.
+ */
+export declare function parsePictureAdjustments(picture: any): Pick<EmbedImageSpec, "crop" | "brightness" | "contrast" | "transparency">;
 /**
  * Whether an `<xdr:sp>` should import as a drawing shape (`EmbedShapeSpec`)
  * rather than a textbox. Text boxes are excluded explicitly (`txBox="1"`), and
@@ -36,4 +62,5 @@ export declare function parseShapeSpec(shape: any): EmbedShapeSpec;
  * @returns Boolean indicating if the image is inside a cell
  */
 export declare function determineIfOneCellInsideCell(fromColOff: number, fromRowOff: number, fLocksWithSheet: string, cx: number, cy: number): boolean;
+export {};
 //# sourceMappingURL=drawing.d.ts.map