@rowsncolumns/toolkit 24.4.1 → 24.4.3

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

@@ -1,19 +1,68 @@
 import { __awaiter, __extends, __generator } from "tslib";
-import { BaseWorkbookPlugin } from "../base/index";
+import { detectCfbContainerKind, LEGACY_XLS_UNSUPPORTED_MESSAGE, XLS_NOT_A_WORKBOOK_MESSAGE, } from "../../cfb-decryptor";
+import { XlsxPlugin } from "../xlsx/index";
+var ZIP_SIGNATURE = [0x50, 0x4b, 0x03, 0x04];
+var CFB_SIGNATURE = [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1];
+var readHeader = function (source, length) { return __awaiter(void 0, void 0, void 0, function () {
+    var slice, _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                if (!(source instanceof File)) return [3 /*break*/, 2];
+                return [4 /*yield*/, source.slice(0, length).arrayBuffer()];
+            case 1:
+                _a = _b.sent();
+                return [3 /*break*/, 3];
+            case 2:
+                _a = source.slice(0, length);
+                _b.label = 3;
+            case 3:
+                slice = _a;
+                return [2 /*return*/, new Uint8Array(slice)];
+        }
+    });
+}); };
+var startsWith = function (header, signature) {
+    return header.length >= signature.length &&
+        signature.every(function (byte, index) { return header[index] === byte; });
+};
+/**
+ * `.xls` handler. The BIFF (Excel 97-2003) binary format is not parsed;
+ * this plugin exists so a `.xls` file gets a clear, actionable error
+ * instead of falling through to the xlsx zip reader (which fails with an
+ * opaque "not a zip" error) or stalling in the password prompt. The one
+ * `.xls` shape that does load is an OOXML package saved with the wrong
+ * extension — Excel opens those too, so they are handed to the xlsx parser.
+ */
 var XlsPlugin = /** @class */ (function (_super) {
     __extends(XlsPlugin, _super);
     function XlsPlugin() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
-    XlsPlugin.prototype.load = function (_buffer, _password) {
+    XlsPlugin.prototype.load = function (buffer, password) {
         return __awaiter(this, void 0, void 0, function () {
+            var header, kind;
             return __generator(this, function (_a) {
-                // TODO: Implement XLS loading (CFB format)
-                console.warn("XLS support not implemented yet");
-                return [2 /*return*/];
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, readHeader(buffer, CFB_SIGNATURE.length)];
+                    case 1:
+                        header = _a.sent();
+                        if (startsWith(header, ZIP_SIGNATURE)) {
+                            return [2 /*return*/, _super.prototype.load.call(this, buffer, password)];
+                        }
+                        if (!startsWith(header, CFB_SIGNATURE)) return [3 /*break*/, 3];
+                        return [4 /*yield*/, detectCfbContainerKind(buffer)];
+                    case 2:
+                        kind = _a.sent();
+                        if (kind === "encrypted-ooxml") {
+                            throw new Error("PASSWORD_REQUIRED");
+                        }
+                        throw new Error(LEGACY_XLS_UNSUPPORTED_MESSAGE);
+                    case 3: throw new Error(XLS_NOT_A_WORKBOOK_MESSAGE);
+                }
             });
         });
     };
     return XlsPlugin;
-}(BaseWorkbookPlugin));
+}(XlsxPlugin));
 export { XlsPlugin };

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

@@ -2,6 +2,10 @@ import type { Color, IterativeCalculationOptions } from "@rowsncolumns/common-ty
 import type { BorderStyle, ConditionalFormatRule, DataValidationRuleRecord, EmbeddedChart, NamedRange, Sheet, SpreadsheetTheme, TableView } from "@rowsncolumns/spreadsheet";
 import type { EmbeddedObjectWithPosition, ProcessSheetDataResult } from "../../types";
 import { BaseWorkbookPlugin } from "../base/index";
+export declare const parseBrtWsViewPayload: (payload: Uint8Array) => {
+    showGridLines: boolean;
+    rightToLeft: boolean;
+};
 export declare const parseBrtNamePayload: (payload: Uint8Array, resolveSheetNameByXti?: (ixti: number) => string | undefined) => {
     name: string;
     formula: string;

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

@@ -5,7 +5,7 @@ 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";
@@ -300,10 +300,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();
@@ -1299,6 +1306,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 +1739,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 +1794,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 +1818,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 +1909,7 @@ var XlsbPlugin = /** @class */ (function (_super) {
                                 rowMetadata: rowMetadata,
                                 columnMetadata: columnMetadata,
                                 showGridLines: showGridLines,
+                                rightToLeft: rightToLeft,
                                 frozenRowCount: frozenRowCount,
                                 frozenColumnCount: frozenColumnCount,
                                 basicFilterRange: basicFilterRange,
@@ -1962,9 +1974,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 }

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

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

@@ -1 +1 @@
-{"version":3,"file":"drawing.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/drawing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,cAAc,EAEd,cAAc,EAWf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAoDrE,MAAM,MAAM,0BAA0B,GAAG,cAAc,GAAG;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,0BAA0B,EAAE,CAAC,CA6dvC;AA6OD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CASlD;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,cAAc,CA8CzD;AA8MD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAqBT"}
+{"version":3,"file":"drawing.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/xlsx/drawing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,cAAc,EAEd,cAAc,EACd,cAAc,EAYf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAoDrE,MAAM,MAAM,0BAA0B,GAAG,cAAc,GAAG;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,4EAA4E;AAC5E,QAAA,MAAM,sBAAsB;;;;CAIlB,CAAC;AAEX,KAAK,iBAAiB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAK7D;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IACP,IAAI,EAAE,CAAC,OAAO,sBAAsB,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACzD,IAAI,EAAE,GAAG,CAAC;CACX,CAAC,CAkCD;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,0BAA0B,EAAE,CAAC,CA8dvC;AASD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,GAAG,GACX,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,CAAC,CAuC3E;AA6OD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CASlD;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,cAAc,CA8CzD;AA8MD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAqBT"}