@rowsncolumns/toolkit 24.4.1

package/dist/esm/exporter/ods/sparkline-builder.d.ts

@@ -0,0 +1,33 @@
+import type { CellData, Sheet } from "@rowsncolumns/spreadsheet";
+export type DetectedSparkline = {
+    targetCell: string;
+    dataRange: string;
+    type: "line" | "column" | "stacked";
+    color?: string;
+    rowIndex: number;
+    columnIndex: number;
+};
+/**
+ * Parse a SPARKLINE formula to extract data range and options
+ * Formula format: =SPARKLINE(A1:E1,{"charttype","column","color","#FF0000"})
+ */
+export declare function parseSparklineFormula(formula: string, sheetName: string): {
+    dataRange: string;
+    chartType: "line" | "column" | "stacked";
+    color?: string;
+} | null;
+/**
+ * Detect SPARKLINE formulas in a sheet and extract sparkline info
+ */
+export declare function detectSparklines(sheet: Sheet, sheetName: string, rowData: Record<number, Record<number, CellData>>): DetectedSparkline[];
+/**
+ * Build sparkline groups XML for ODS table element
+ * Returns null if no sparklines detected
+ */
+export declare function buildOdsSparklineGroupsXml(sheet: Sheet, sheetName: string, rowData: Record<number, Record<number, CellData>>): string | null;
+/**
+ * Check if a cell has a SPARKLINE formula and should NOT be exported as a formula
+ * (the formula will be converted to native ODS sparkline instead)
+ */
+export declare function isSparklineCell(cell: CellData | null | undefined): boolean;
+//# sourceMappingURL=sparkline-builder.d.ts.map

package/dist/esm/exporter/ods/sparkline-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparkline-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/ods/sparkline-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAIjE,MAAM,MAAM,iBAAiB,GAAG;IAE9B,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAEpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,QAAQ,EAAE,MAAM,CAAC;IAEjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAsDF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuCxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GAChD,iBAAiB,EAAE,CAmCrB;AAyBD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GAChD,MAAM,GAAG,IAAI,CAmCf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAM1E"}

package/dist/esm/exporter/ods/sparkline-builder.js

@@ -0,0 +1,165 @@
+import { cellToAddress } from "@rowsncolumns/utils";
+/**
+ * Convert column number (1-indexed) to letters (A, B, ..., Z, AA, etc.)
+ */
+function columnToLetter(col) {
+    let result = "";
+    while (col > 0) {
+        col--;
+        result = String.fromCharCode(65 + (col % 26)) + result;
+        col = Math.floor(col / 26);
+    }
+    return result;
+}
+/**
+ * Convert Excel-style range (e.g., "A1:B1" or "Sheet1!A1:B1") to ODS format
+ * ODS format: "Sheet1.A1:Sheet1.B1" or "$Sheet1.$A$1:.$B$1"
+ */
+function excelRangeToOdsRange(range, currentSheetName) {
+    // Check if range has a sheet prefix
+    const sheetMatch = range.match(/^([^!]+)!(.+)$/);
+    let sheetName = currentSheetName;
+    let cellRange = range;
+    if (sheetMatch) {
+        sheetName = sheetMatch[1];
+        cellRange = sheetMatch[2];
+    }
+    // Parse the cell range (e.g., "A1:B1")
+    const rangeMatch = cellRange.match(/^([A-Z]+)(\d+):([A-Z]+)(\d+)$/i);
+    if (!rangeMatch) {
+        // Single cell or invalid format, return as-is with sheet prefix
+        return `${sheetName}.${cellRange}`;
+    }
+    const [, startCol, startRow, endCol, endRow] = rangeMatch;
+    // ODS format uses "SheetName.A1:SheetName.B1" for same-sheet ranges
+    // or just "SheetName.A1:.B1" if start and end sheets are the same
+    return `${sheetName}.${startCol}${startRow}:${sheetName}.${endCol}${endRow}`;
+}
+/**
+ * Parse a SPARKLINE formula to extract data range and options
+ * Formula format: =SPARKLINE(A1:E1,{"charttype","column","color","#FF0000"})
+ */
+export function parseSparklineFormula(formula, sheetName) {
+    // Match SPARKLINE formula
+    const sparklineMatch = formula.match(/^=SPARKLINE\s*\(\s*([^,)]+)(?:\s*,\s*\{([^}]*)\})?\s*\)$/i);
+    if (!sparklineMatch)
+        return null;
+    const excelRange = sparklineMatch[1].trim();
+    const optionsStr = sparklineMatch[2];
+    // Convert Excel range to ODS format
+    const dataRange = excelRangeToOdsRange(excelRange, sheetName);
+    // Parse options
+    let chartType = "line";
+    let color;
+    if (optionsStr) {
+        // Parse key-value pairs from options like "charttype","column","color","#FF0000"
+        const tokens = optionsStr.split(",").map((t) => t.trim().replace(/"/g, ""));
+        for (let i = 0; i < tokens.length - 1; i += 2) {
+            const key = tokens[i].toLowerCase();
+            const value = tokens[i + 1];
+            if (key === "charttype") {
+                if (value === "column") {
+                    chartType = "column";
+                }
+                else if (value === "winloss") {
+                    chartType = "stacked"; // ODS uses "stacked" for win/loss
+                }
+            }
+            else if (key === "color") {
+                color = value;
+            }
+        }
+    }
+    return { dataRange, chartType, color };
+}
+/**
+ * Detect SPARKLINE formulas in a sheet and extract sparkline info
+ */
+export function detectSparklines(sheet, sheetName, rowData) {
+    const sparklines = [];
+    for (const [rowIndexStr, row] of Object.entries(rowData)) {
+        const rowIndex = parseInt(rowIndexStr, 10);
+        for (const [colIndexStr, cell] of Object.entries(row)) {
+            const columnIndex = parseInt(colIndexStr, 10);
+            const formula = cell?.ue?.fv || cell?.userEnteredValue?.formulaValue;
+            if (formula && formula.toUpperCase().startsWith("=SPARKLINE(")) {
+                const parsed = parseSparklineFormula(formula, sheetName);
+                if (parsed) {
+                    // Convert cell position to ODS address format (e.g., "Sheet1.C1")
+                    const excelAddress = cellToAddress({
+                        rowIndex,
+                        columnIndex,
+                    });
+                    const targetCell = `${sheetName}.${excelAddress}`;
+                    sparklines.push({
+                        targetCell,
+                        dataRange: parsed.dataRange,
+                        type: parsed.chartType,
+                        color: parsed.color,
+                        rowIndex,
+                        columnIndex,
+                    });
+                }
+            }
+        }
+    }
+    return sparklines;
+}
+/**
+ * Group sparklines by their style (type and color)
+ */
+function groupSparklines(sparklines) {
+    const groups = new Map();
+    for (const sparkline of sparklines) {
+        const key = `${sparkline.type}|${sparkline.color || ""}`;
+        if (!groups.has(key)) {
+            groups.set(key, {
+                type: sparkline.type,
+                color: sparkline.color,
+                sparklines: [],
+            });
+        }
+        groups.get(key).sparklines.push(sparkline);
+    }
+    return Array.from(groups.values());
+}
+/**
+ * Build sparkline groups XML for ODS table element
+ * Returns null if no sparklines detected
+ */
+export function buildOdsSparklineGroupsXml(sheet, sheetName, rowData) {
+    const sparklines = detectSparklines(sheet, sheetName, rowData);
+    if (sparklines.length === 0) {
+        return null;
+    }
+    const groups = groupSparklines(sparklines);
+    let groupsXml = "";
+    for (const group of groups) {
+        // Build sparkline group attributes
+        let groupAttrs = "";
+        // Type attribute (line is default in ODS too)
+        if (group.type !== "line") {
+            groupAttrs += ` calcext:type="${group.type}"`;
+        }
+        // Color attribute
+        if (group.color) {
+            groupAttrs += ` calcext:color-series="${group.color}"`;
+        }
+        // Build individual sparklines
+        let sparklinesXml = "";
+        for (const sparkline of group.sparklines) {
+            sparklinesXml += `<calcext:sparkline calcext:cell-address="${sparkline.targetCell}" calcext:data-range="${sparkline.dataRange}"/>`;
+        }
+        groupsXml += `<calcext:sparkline-group${groupAttrs}><calcext:sparklines>${sparklinesXml}</calcext:sparklines></calcext:sparkline-group>`;
+    }
+    return `<calcext:sparkline-groups>${groupsXml}</calcext:sparkline-groups>`;
+}
+/**
+ * Check if a cell has a SPARKLINE formula and should NOT be exported as a formula
+ * (the formula will be converted to native ODS sparkline instead)
+ */
+export function isSparklineCell(cell) {
+    const formula = cell?.ue?.fv || cell?.userEnteredValue?.formulaValue;
+    return (typeof formula === "string" &&
+        formula.toUpperCase().startsWith("=SPARKLINE("));
+}

package/dist/esm/exporter/xlsx/chart-builder.d.ts

@@ -0,0 +1,3 @@
+import type { EmbeddedChart } from "@rowsncolumns/spreadsheet";
+export declare const buildChartXml: (chart: EmbeddedChart, sheetNameById: Map<number, string>) => string | undefined;
+//# sourceMappingURL=chart-builder.d.ts.map

package/dist/esm/exporter/xlsx/chart-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-builder.d.ts","sourceRoot":"","sources":["../../../../exporter/xlsx/chart-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EAEd,MAAM,2BAA2B,CAAC;AAovCnC,eAAO,MAAM,aAAa,GACxB,OAAO,aAAa,EACpB,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,MAAM,GAAG,SAsnBX,CAAC"}