@rowsncolumns/toolkit 24.4.1

package/dist/esm/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/esm/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/esm/excel-parser/plugins/ods/sparklines.js

@@ -0,0 +1,188 @@
+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
+    const cleaned = address.replace(/\$/g, "");
+    // Split by period to separate sheet name and cell reference
+    const parts = cleaned.split(".");
+    let cellRef;
+    let 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")
+    const match = cellRef.match(/^([A-Z]+)(\d+)$/i);
+    if (!match)
+        return null;
+    const colLetters = match[1].toUpperCase();
+    const rowNum = parseInt(match[2], 10);
+    // Convert column letters to 1-indexed number
+    let columnIndex = 0;
+    for (let i = 0; i < colLetters.length; i++) {
+        columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 64);
+    }
+    return { sheetName, 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
+    const cleaned = range.replace(/\$/g, "");
+    // Split by colon to get start and end
+    const colonParts = cleaned.split(":");
+    if (colonParts.length !== 2)
+        return null;
+    const start = parseOdsCellAddress(colonParts[0]);
+    const end = parseOdsCellAddress(colonParts[1]);
+    if (!start || !end)
+        return null;
+    // Check if it's a cross-sheet reference
+    const startSheet = start.sheetName;
+    const endSheet = end.sheetName || startSheet;
+    const isCrossSheet = startSheet !== currentSheetName || endSheet !== currentSheetName;
+    // Convert to Excel-style cell references (e.g., "A1")
+    const colToLetter = (col) => {
+        let result = "";
+        while (col > 0) {
+            col--;
+            result = String.fromCharCode(65 + (col % 26)) + result;
+            col = Math.floor(col / 26);
+        }
+        return result;
+    };
+    const startRef = `${colToLetter(start.columnIndex)}${start.rowIndex}`;
+    const endRef = `${colToLetter(end.columnIndex)}${end.rowIndex}`;
+    // For cross-sheet references, include the sheet name
+    if (isCrossSheet && startSheet) {
+        return {
+            normalizedRange: `${startSheet}!${startRef}:${endRef}`,
+            isCrossSheet: true,
+        };
+    }
+    return { normalizedRange: `${startRef}:${endRef}`, isCrossSheet: false };
+}
+/**
+ * Extract sparklines from ODS sheet nodes
+ * LibreOffice stores sparklines in calcext:sparkline-groups
+ */
+export function extractSparklines(ctx) {
+    const { sheetContexts, getAttributes, toArray } = ctx;
+    const result = new Map();
+    for (const context of sheetContexts) {
+        const { node, sheetId, name: sheetName } = context;
+        // Find sparkline groups - try various namespace patterns
+        const sparklineGroupsContainer = get(node, "calcext:sparkline-groups") ||
+            get(node, "sparkline-groups");
+        if (!sparklineGroupsContainer)
+            continue;
+        const sparklineGroups = toArray(get(sparklineGroupsContainer, "calcext:sparkline-group") ||
+            get(sparklineGroupsContainer, "sparkline-group"));
+        if (!sparklineGroups.length)
+            continue;
+        // Initialize the sheet's sparkline map
+        let sheetSparklines = result.get(sheetId);
+        if (!sheetSparklines) {
+            sheetSparklines = new Map();
+            result.set(sheetId, sheetSparklines);
+        }
+        for (const group of sparklineGroups) {
+            const groupAttrs = getAttributes(group);
+            if (!groupAttrs)
+                continue;
+            // Get sparkline type (line, column, stacked)
+            const typeAttr = groupAttrs["@_calcext:type"] || groupAttrs["@_type"] || "line";
+            const chartType = typeAttr === "stacked" ? "winloss" : typeAttr === "column" ? "column" : "line";
+            // Get color (format: #RRGGBB)
+            const color = groupAttrs["@_calcext:color-series"] || groupAttrs["@_color-series"];
+            // Get individual sparklines
+            const sparklinesContainer = get(group, "calcext:sparklines") || get(group, "sparklines");
+            if (!sparklinesContainer)
+                continue;
+            const sparklines = toArray(get(sparklinesContainer, "calcext:sparkline") ||
+                get(sparklinesContainer, "sparkline"));
+            for (const sparkline of sparklines) {
+                const sparklineAttrs = getAttributes(sparkline);
+                if (!sparklineAttrs)
+                    continue;
+                // Get cell address where sparkline is displayed
+                const cellAddress = sparklineAttrs["@_calcext:cell-address"] ||
+                    sparklineAttrs["@_cell-address"];
+                // Get data range
+                const dataRangeRaw = sparklineAttrs["@_calcext:data-range"] ||
+                    sparklineAttrs["@_data-range"];
+                if (!cellAddress || !dataRangeRaw)
+                    continue;
+                // Parse the target cell
+                const targetCell = parseOdsCellAddress(cellAddress);
+                if (!targetCell)
+                    continue;
+                // Parse the data range
+                const parsedRange = parseOdsRange(dataRangeRaw, sheetName);
+                if (!parsedRange)
+                    continue;
+                // Build the SPARKLINE formula
+                let formula = `=SPARKLINE(${parsedRange.normalizedRange}`;
+                const options = [];
+                if (chartType !== "line") {
+                    options.push(`"charttype"`, `"${chartType}"`);
+                }
+                if (color) {
+                    options.push(`"color"`, `"${color}"`);
+                }
+                if (options.length > 0) {
+                    formula += `,{${options.join(",")}}`;
+                }
+                formula += ")";
+                // Add to the row map
+                let rowMap = sheetSparklines.get(targetCell.rowIndex);
+                if (!rowMap) {
+                    rowMap = new Map();
+                    sheetSparklines.set(targetCell.rowIndex, rowMap);
+                }
+                rowMap.set(targetCell.columnIndex, {
+                    formula,
+                    dataRange: parsedRange.normalizedRange,
+                    chartType,
+                    color,
+                });
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Extract sparkline data values from the current row for immediate rendering
+ */
+export function extractSparklineData(sparkline, rowIndex, rowValues) {
+    const sparklineData = [];
+    // Skip cross-sheet references
+    if (sparkline.dataRange.includes("!")) {
+        return sparklineData;
+    }
+    // Parse range using addressToSelection for robust handling
+    const selection = addressToSelection(sparkline.dataRange);
+    if (!selection)
+        return sparklineData;
+    const { startRowIndex, endRowIndex, startColumnIndex, endColumnIndex, } = selection.range;
+    // Only extract data for same-row horizontal ranges
+    if (startRowIndex === endRowIndex && startRowIndex === rowIndex) {
+        for (let col = startColumnIndex; col <= endColumnIndex; col++) {
+            const cell = rowValues[col];
+            const value = cell?.ev?.nv ?? cell?.ue?.nv;
+            if (typeof value === "number" && !isNaN(value)) {
+                sparklineData.push(value);
+            }
+        }
+    }
+    return sparklineData;
+}

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