@rowsncolumns/toolkit 24.4.1

package/dist/cjs/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/cjs/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/cjs/exporter/ods/sparkline-builder.js

@@ -0,0 +1,221 @@
+import { __read, __values } from "tslib";
+import { cellToAddress } from "@rowsncolumns/utils";
+/**
+ * Convert column number (1-indexed) to letters (A, B, ..., Z, AA, etc.)
+ */
+function columnToLetter(col) {
+    var 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
+    var sheetMatch = range.match(/^([^!]+)!(.+)$/);
+    var sheetName = currentSheetName;
+    var cellRange = range;
+    if (sheetMatch) {
+        sheetName = sheetMatch[1];
+        cellRange = sheetMatch[2];
+    }
+    // Parse the cell range (e.g., "A1:B1")
+    var rangeMatch = cellRange.match(/^([A-Z]+)(\d+):([A-Z]+)(\d+)$/i);
+    if (!rangeMatch) {
+        // Single cell or invalid format, return as-is with sheet prefix
+        return "".concat(sheetName, ".").concat(cellRange);
+    }
+    var _a = __read(rangeMatch, 5), startCol = _a[1], startRow = _a[2], endCol = _a[3], endRow = _a[4];
+    // 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 "".concat(sheetName, ".").concat(startCol).concat(startRow, ":").concat(sheetName, ".").concat(endCol).concat(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
+    var sparklineMatch = formula.match(/^=SPARKLINE\s*\(\s*([^,)]+)(?:\s*,\s*\{([^}]*)\})?\s*\)$/i);
+    if (!sparklineMatch)
+        return null;
+    var excelRange = sparklineMatch[1].trim();
+    var optionsStr = sparklineMatch[2];
+    // Convert Excel range to ODS format
+    var dataRange = excelRangeToOdsRange(excelRange, sheetName);
+    // Parse options
+    var chartType = "line";
+    var color;
+    if (optionsStr) {
+        // Parse key-value pairs from options like "charttype","column","color","#FF0000"
+        var tokens = optionsStr.split(",").map(function (t) { return t.trim().replace(/"/g, ""); });
+        for (var i = 0; i < tokens.length - 1; i += 2) {
+            var key = tokens[i].toLowerCase();
+            var 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: dataRange, chartType: chartType, color: color };
+}
+/**
+ * Detect SPARKLINE formulas in a sheet and extract sparkline info
+ */
+export function detectSparklines(sheet, sheetName, rowData) {
+    var e_1, _a, e_2, _b;
+    var _c, _d;
+    var sparklines = [];
+    try {
+        for (var _e = __values(Object.entries(rowData)), _f = _e.next(); !_f.done; _f = _e.next()) {
+            var _g = __read(_f.value, 2), rowIndexStr = _g[0], row = _g[1];
+            var rowIndex = parseInt(rowIndexStr, 10);
+            try {
+                for (var _h = (e_2 = void 0, __values(Object.entries(row))), _j = _h.next(); !_j.done; _j = _h.next()) {
+                    var _k = __read(_j.value, 2), colIndexStr = _k[0], cell = _k[1];
+                    var columnIndex = parseInt(colIndexStr, 10);
+                    var formula = ((_c = cell === null || cell === void 0 ? void 0 : cell.ue) === null || _c === void 0 ? void 0 : _c.fv) || ((_d = cell === null || cell === void 0 ? void 0 : cell.userEnteredValue) === null || _d === void 0 ? void 0 : _d.formulaValue);
+                    if (formula && formula.toUpperCase().startsWith("=SPARKLINE(")) {
+                        var parsed = parseSparklineFormula(formula, sheetName);
+                        if (parsed) {
+                            // Convert cell position to ODS address format (e.g., "Sheet1.C1")
+                            var excelAddress = cellToAddress({
+                                rowIndex: rowIndex,
+                                columnIndex: columnIndex,
+                            });
+                            var targetCell = "".concat(sheetName, ".").concat(excelAddress);
+                            sparklines.push({
+                                targetCell: targetCell,
+                                dataRange: parsed.dataRange,
+                                type: parsed.chartType,
+                                color: parsed.color,
+                                rowIndex: rowIndex,
+                                columnIndex: columnIndex,
+                            });
+                        }
+                    }
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (_j && !_j.done && (_b = _h.return)) _b.call(_h);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return sparklines;
+}
+/**
+ * Group sparklines by their style (type and color)
+ */
+function groupSparklines(sparklines) {
+    var e_3, _a;
+    var groups = new Map();
+    try {
+        for (var sparklines_1 = __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 key = "".concat(sparkline.type, "|").concat(sparkline.color || "");
+            if (!groups.has(key)) {
+                groups.set(key, {
+                    type: sparkline.type,
+                    color: sparkline.color,
+                    sparklines: [],
+                });
+            }
+            groups.get(key).sparklines.push(sparkline);
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (sparklines_1_1 && !sparklines_1_1.done && (_a = sparklines_1.return)) _a.call(sparklines_1);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+    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) {
+    var e_4, _a, e_5, _b;
+    var sparklines = detectSparklines(sheet, sheetName, rowData);
+    if (sparklines.length === 0) {
+        return null;
+    }
+    var groups = groupSparklines(sparklines);
+    var groupsXml = "";
+    try {
+        for (var groups_1 = __values(groups), groups_1_1 = groups_1.next(); !groups_1_1.done; groups_1_1 = groups_1.next()) {
+            var group = groups_1_1.value;
+            // Build sparkline group attributes
+            var groupAttrs = "";
+            // Type attribute (line is default in ODS too)
+            if (group.type !== "line") {
+                groupAttrs += " calcext:type=\"".concat(group.type, "\"");
+            }
+            // Color attribute
+            if (group.color) {
+                groupAttrs += " calcext:color-series=\"".concat(group.color, "\"");
+            }
+            // Build individual sparklines
+            var sparklinesXml = "";
+            try {
+                for (var _c = (e_5 = void 0, __values(group.sparklines)), _d = _c.next(); !_d.done; _d = _c.next()) {
+                    var sparkline = _d.value;
+                    sparklinesXml += "<calcext:sparkline calcext:cell-address=\"".concat(sparkline.targetCell, "\" calcext:data-range=\"").concat(sparkline.dataRange, "\"/>");
+                }
+            }
+            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+            finally {
+                try {
+                    if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+                }
+                finally { if (e_5) throw e_5.error; }
+            }
+            groupsXml += "<calcext:sparkline-group".concat(groupAttrs, "><calcext:sparklines>").concat(sparklinesXml, "</calcext:sparklines></calcext:sparkline-group>");
+        }
+    }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    finally {
+        try {
+            if (groups_1_1 && !groups_1_1.done && (_a = groups_1.return)) _a.call(groups_1);
+        }
+        finally { if (e_4) throw e_4.error; }
+    }
+    return "<calcext:sparkline-groups>".concat(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) {
+    var _a, _b;
+    var formula = ((_a = cell === null || cell === void 0 ? void 0 : cell.ue) === null || _a === void 0 ? void 0 : _a.fv) || ((_b = cell === null || cell === void 0 ? void 0 : cell.userEnteredValue) === null || _b === void 0 ? void 0 : _b.formulaValue);
+    return (typeof formula === "string" &&
+        formula.toUpperCase().startsWith("=SPARKLINE("));
+}

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