@rowsncolumns/toolkit 24.4.1

package/dist/cjs/excel-parser/plugins/ods/sparklines.d.ts

@@ -0,0 +1,25 @@
+import type { SheetContext, ToArrayFn } from "./types";
+export type ParsedOdsSparkline = {
+    formula: string;
+    dataRange: string;
+    chartType: "line" | "column" | "winloss";
+    color?: string;
+};
+export type SparklinesBySheet = Map<number, Map<number, Map<number, ParsedOdsSparkline>>>;
+type SparklineExtractionContext = {
+    sheetContexts: SheetContext[];
+    sheetNameMap: Map<string, number>;
+    getAttributes: (node: any) => any;
+    toArray: ToArrayFn;
+};
+/**
+ * Extract sparklines from ODS sheet nodes
+ * LibreOffice stores sparklines in calcext:sparkline-groups
+ */
+export declare function extractSparklines(ctx: SparklineExtractionContext): SparklinesBySheet;
+/**
+ * Extract sparkline data values from the current row for immediate rendering
+ */
+export declare function extractSparklineData(sparkline: ParsedOdsSparkline, rowIndex: number, rowValues: Record<number, any>): number[];
+export {};
+//# sourceMappingURL=sparklines.d.ts.map

package/dist/cjs/excel-parser/plugins/ods/sparklines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparklines.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/ods/sparklines.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF,MAAM,MAAM,iBAAiB,GAAG,GAAG,CACjC,MAAM,EACN,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAC7C,CAAC;AAEF,KAAK,0BAA0B,GAAG;IAChC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;IAClC,OAAO,EAAE,SAAS,CAAC;CACpB,CAAC;AA4FF;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,0BAA0B,GAC9B,iBAAiB,CA+GnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,kBAAkB,EAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,MAAM,EAAE,CA+BV"}

package/dist/cjs/excel-parser/plugins/ods/sparklines.js

@@ -0,0 +1,221 @@
+import { __values } from "tslib";
+import { get } from "lodash-es";
+import { addressToSelection } from "@rowsncolumns/utils";
+/**
+ * Parse ODS cell address format (e.g., "Sheet1.A1" or "$Sheet1.$A$1")
+ * Returns { sheetName, columnIndex, rowIndex } where indices are 1-indexed
+ */
+function parseOdsCellAddress(address) {
+    // Remove $ signs used for absolute references
+    var cleaned = address.replace(/\$/g, "");
+    // Split by period to separate sheet name and cell reference
+    var parts = cleaned.split(".");
+    var cellRef;
+    var sheetName;
+    if (parts.length >= 2) {
+        sheetName = parts.slice(0, -1).join("."); // Handle sheet names with periods
+        cellRef = parts[parts.length - 1];
+    }
+    else {
+        cellRef = parts[0];
+    }
+    // Parse cell reference (e.g., "A1")
+    var match = cellRef.match(/^([A-Z]+)(\d+)$/i);
+    if (!match)
+        return null;
+    var colLetters = match[1].toUpperCase();
+    var rowNum = parseInt(match[2], 10);
+    // Convert column letters to 1-indexed number
+    var columnIndex = 0;
+    for (var i = 0; i < colLetters.length; i++) {
+        columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 64);
+    }
+    return { sheetName: sheetName, columnIndex: columnIndex, rowIndex: rowNum };
+}
+/**
+ * Parse ODS range format (e.g., "Sheet1.A1:Sheet1.E1" or "Sheet1.A1:E1")
+ * Returns normalized Excel-style range without sheet name (e.g., "A1:E1")
+ */
+function parseOdsRange(range, currentSheetName) {
+    // Remove $ signs
+    var cleaned = range.replace(/\$/g, "");
+    // Split by colon to get start and end
+    var colonParts = cleaned.split(":");
+    if (colonParts.length !== 2)
+        return null;
+    var start = parseOdsCellAddress(colonParts[0]);
+    var end = parseOdsCellAddress(colonParts[1]);
+    if (!start || !end)
+        return null;
+    // Check if it's a cross-sheet reference
+    var startSheet = start.sheetName;
+    var endSheet = end.sheetName || startSheet;
+    var isCrossSheet = startSheet !== currentSheetName || endSheet !== currentSheetName;
+    // Convert to Excel-style cell references (e.g., "A1")
+    var colToLetter = function (col) {
+        var result = "";
+        while (col > 0) {
+            col--;
+            result = String.fromCharCode(65 + (col % 26)) + result;
+            col = Math.floor(col / 26);
+        }
+        return result;
+    };
+    var startRef = "".concat(colToLetter(start.columnIndex)).concat(start.rowIndex);
+    var endRef = "".concat(colToLetter(end.columnIndex)).concat(end.rowIndex);
+    // For cross-sheet references, include the sheet name
+    if (isCrossSheet && startSheet) {
+        return {
+            normalizedRange: "".concat(startSheet, "!").concat(startRef, ":").concat(endRef),
+            isCrossSheet: true,
+        };
+    }
+    return { normalizedRange: "".concat(startRef, ":").concat(endRef), isCrossSheet: false };
+}
+/**
+ * Extract sparklines from ODS sheet nodes
+ * LibreOffice stores sparklines in calcext:sparkline-groups
+ */
+export function extractSparklines(ctx) {
+    var e_1, _a, e_2, _b, e_3, _c;
+    var sheetContexts = ctx.sheetContexts, getAttributes = ctx.getAttributes, toArray = ctx.toArray;
+    var result = new Map();
+    try {
+        for (var sheetContexts_1 = __values(sheetContexts), sheetContexts_1_1 = sheetContexts_1.next(); !sheetContexts_1_1.done; sheetContexts_1_1 = sheetContexts_1.next()) {
+            var context = sheetContexts_1_1.value;
+            var node = context.node, sheetId = context.sheetId, sheetName = context.name;
+            // Find sparkline groups - try various namespace patterns
+            var sparklineGroupsContainer = get(node, "calcext:sparkline-groups") ||
+                get(node, "sparkline-groups");
+            if (!sparklineGroupsContainer)
+                continue;
+            var sparklineGroups = toArray(get(sparklineGroupsContainer, "calcext:sparkline-group") ||
+                get(sparklineGroupsContainer, "sparkline-group"));
+            if (!sparklineGroups.length)
+                continue;
+            // Initialize the sheet's sparkline map
+            var sheetSparklines = result.get(sheetId);
+            if (!sheetSparklines) {
+                sheetSparklines = new Map();
+                result.set(sheetId, sheetSparklines);
+            }
+            try {
+                for (var sparklineGroups_1 = (e_2 = void 0, __values(sparklineGroups)), sparklineGroups_1_1 = sparklineGroups_1.next(); !sparklineGroups_1_1.done; sparklineGroups_1_1 = sparklineGroups_1.next()) {
+                    var group = sparklineGroups_1_1.value;
+                    var groupAttrs = getAttributes(group);
+                    if (!groupAttrs)
+                        continue;
+                    // Get sparkline type (line, column, stacked)
+                    var typeAttr = groupAttrs["@_calcext:type"] || groupAttrs["@_type"] || "line";
+                    var chartType = typeAttr === "stacked" ? "winloss" : typeAttr === "column" ? "column" : "line";
+                    // Get color (format: #RRGGBB)
+                    var color = groupAttrs["@_calcext:color-series"] || groupAttrs["@_color-series"];
+                    // Get individual sparklines
+                    var sparklinesContainer = get(group, "calcext:sparklines") || get(group, "sparklines");
+                    if (!sparklinesContainer)
+                        continue;
+                    var sparklines = toArray(get(sparklinesContainer, "calcext:sparkline") ||
+                        get(sparklinesContainer, "sparkline"));
+                    try {
+                        for (var sparklines_1 = (e_3 = void 0, __values(sparklines)), sparklines_1_1 = sparklines_1.next(); !sparklines_1_1.done; sparklines_1_1 = sparklines_1.next()) {
+                            var sparkline = sparklines_1_1.value;
+                            var sparklineAttrs = getAttributes(sparkline);
+                            if (!sparklineAttrs)
+                                continue;
+                            // Get cell address where sparkline is displayed
+                            var cellAddress = sparklineAttrs["@_calcext:cell-address"] ||
+                                sparklineAttrs["@_cell-address"];
+                            // Get data range
+                            var dataRangeRaw = sparklineAttrs["@_calcext:data-range"] ||
+                                sparklineAttrs["@_data-range"];
+                            if (!cellAddress || !dataRangeRaw)
+                                continue;
+                            // Parse the target cell
+                            var targetCell = parseOdsCellAddress(cellAddress);
+                            if (!targetCell)
+                                continue;
+                            // Parse the data range
+                            var parsedRange = parseOdsRange(dataRangeRaw, sheetName);
+                            if (!parsedRange)
+                                continue;
+                            // Build the SPARKLINE formula
+                            var formula = "=SPARKLINE(".concat(parsedRange.normalizedRange);
+                            var options = [];
+                            if (chartType !== "line") {
+                                options.push("\"charttype\"", "\"".concat(chartType, "\""));
+                            }
+                            if (color) {
+                                options.push("\"color\"", "\"".concat(color, "\""));
+                            }
+                            if (options.length > 0) {
+                                formula += ",{".concat(options.join(","), "}");
+                            }
+                            formula += ")";
+                            // Add to the row map
+                            var rowMap = sheetSparklines.get(targetCell.rowIndex);
+                            if (!rowMap) {
+                                rowMap = new Map();
+                                sheetSparklines.set(targetCell.rowIndex, rowMap);
+                            }
+                            rowMap.set(targetCell.columnIndex, {
+                                formula: formula,
+                                dataRange: parsedRange.normalizedRange,
+                                chartType: chartType,
+                                color: color,
+                            });
+                        }
+                    }
+                    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                    finally {
+                        try {
+                            if (sparklines_1_1 && !sparklines_1_1.done && (_c = sparklines_1.return)) _c.call(sparklines_1);
+                        }
+                        finally { if (e_3) throw e_3.error; }
+                    }
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (sparklineGroups_1_1 && !sparklineGroups_1_1.done && (_b = sparklineGroups_1.return)) _b.call(sparklineGroups_1);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (sheetContexts_1_1 && !sheetContexts_1_1.done && (_a = sheetContexts_1.return)) _a.call(sheetContexts_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return result;
+}
+/**
+ * Extract sparkline data values from the current row for immediate rendering
+ */
+export function extractSparklineData(sparkline, rowIndex, rowValues) {
+    var _a, _b, _c;
+    var sparklineData = [];
+    // Skip cross-sheet references
+    if (sparkline.dataRange.includes("!")) {
+        return sparklineData;
+    }
+    // Parse range using addressToSelection for robust handling
+    var selection = addressToSelection(sparkline.dataRange);
+    if (!selection)
+        return sparklineData;
+    var _d = selection.range, startRowIndex = _d.startRowIndex, endRowIndex = _d.endRowIndex, startColumnIndex = _d.startColumnIndex, endColumnIndex = _d.endColumnIndex;
+    // Only extract data for same-row horizontal ranges
+    if (startRowIndex === endRowIndex && startRowIndex === rowIndex) {
+        for (var col = startColumnIndex; col <= endColumnIndex; col++) {
+            var cell = rowValues[col];
+            var value = (_b = (_a = cell === null || cell === void 0 ? void 0 : cell.ev) === null || _a === void 0 ? void 0 : _a.nv) !== null && _b !== void 0 ? _b : (_c = cell === null || cell === void 0 ? void 0 : cell.ue) === null || _c === void 0 ? void 0 : _c.nv;
+            if (typeof value === "number" && !isNaN(value)) {
+                sparklineData.push(value);
+            }
+        }
+    }
+    return sparklineData;
+}

package/dist/cjs/excel-parser/plugins/ods/styles.d.ts

@@ -0,0 +1,60 @@
+import type { CellFormat, Color, TextFormat } from "@rowsncolumns/spreadsheet";
+type OdsRowStyle = {
+    height?: number;
+    hidden?: boolean;
+    format?: CellFormat;
+};
+type OdsColumnStyle = {
+    width?: number;
+    hidden?: boolean;
+    format?: CellFormat;
+};
+export declare class OdsStyles {
+    private cellStyles;
+    private automaticCellStyles;
+    private rowStyles;
+    private automaticRowStyles;
+    private columnStyles;
+    private automaticColumnStyles;
+    private textStyles;
+    private automaticTextStyles;
+    private tableStyles;
+    private automaticTableStyles;
+    private numberFormats;
+    private chartStyles;
+    constructor();
+    reset(): void;
+    parseStylesXml(stylesXml: any): void;
+    parseContentXml(contentXml: any): void;
+    private processStyles;
+    private processNumberStyles;
+    private processNumberStyleNodes;
+    getStyle(styleName: string): CellFormat | undefined;
+    getRowStyle(styleName: string): OdsRowStyle | undefined;
+    getColumnStyle(styleName: string): OdsColumnStyle | undefined;
+    getChartStyleColor(styleName?: string): Color | undefined;
+    getTableCellFormat(styleName: string): CellFormat | undefined;
+    getTextFormat(styleName?: string): TextFormat | undefined;
+    private convertToCellFormat;
+    private normalizeCellFormat;
+    private convertRowStyle;
+    private convertColumnStyle;
+    private convertChartStyle;
+    private extractChartColor;
+    private convertNumberStyleNode;
+    private buildNumberPattern;
+    private buildDateTimePattern;
+    private toArray;
+    private first;
+    private extractText;
+    private getAttributes;
+    private createBorders;
+    private parseBorder;
+    private getNodeAttributes;
+    private parseColor;
+    private mapBorderStyle;
+    private mapBorderWidth;
+    private convertLengthToPixels;
+}
+export {};
+//# sourceMappingURL=styles.d.ts.map

package/dist/cjs/excel-parser/plugins/ods/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../excel-parser/plugins/ods/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,UAAU,EACV,KAAK,EAGL,UAAU,EACX,MAAM,2BAA2B,CAAC;AAGnC,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,mBAAmB,CAA+B;IAC1D,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,kBAAkB,CAAuC;IACjE,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,qBAAqB,CAA0C;IACvE,OAAO,CAAC,UAAU,CAAkD;IACpE,OAAO,CAAC,mBAAmB,CAAkD;IAC7E,OAAO,CAAC,WAAW,CAAkD;IACrE,OAAO,CAAC,oBAAoB,CAAkD;IAC9E,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,WAAW,CAAiC;;IAIpD,KAAK;IAeL,cAAc,CAAC,SAAS,EAAE,GAAG;IAsB7B,eAAe,CAAC,UAAU,EAAE,GAAG;IAc/B,OAAO,CAAC,aAAa;IA4FrB,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,uBAAuB;IAc/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQnD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAMvD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAO7D,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAKzD,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAO7D,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAOzD,OAAO,CAAC,mBAAmB;IAuP3B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,eAAe;IAoCvB,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,sBAAsB;IAuD9B,OAAO,CAAC,kBAAkB;IAkD1B,OAAO,CAAC,oBAAoB;IA+D5B,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,qBAAqB;CAgB9B"}