@sme.up/doc-alchemist 1.2.0-SNAPSHOT-20250627103210 → 1.2.0-SNAPSHOT-20250704074443

package/dist/{images → converters/images}/charts-generator.d.ts

@@ -1,5 +1,5 @@
-import { ChartOptions } from "../types/index.js";
-import { SmeupDataTable } from "../types/data-structures/smeupDataTable.js";
+import { SmeupDataTable } from "../../types/data-structures/smeupDataTable.js";
+import { ChartOptions } from "../../types/index.js";
 /**
  * Converts SmeupDataTable to chart image buffer
  * @param dataTable - SmeupDataTable containing the data

package/dist/converters/images/charts-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts-generator.js","sourceRoot":"","sources":["../../../src/converters/images/charts-generator.ts"],"names":[],"mappings":"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","sourcesContent":["import * as echarts from \"echarts\";\nimport type { EChartsOption } from \"echarts\";\nimport { SmeupDataTable } from \"../../types/data-structures/smeupDataTable.js\";\nimport { ChartOptions } from \"../../types/index.js\";\n\n/**\n * Converts SmeupDataTable to chart image buffer\n * @param dataTable - SmeupDataTable containing the data\n * @param chartType - Type of chart (bar, line, pie, scatter)\n * @returns Promise<Buffer> containing the chart image\n */\nexport const dataTableToChart = async (\n  dataTable: SmeupDataTable,\n  chartType: string,\n  chartOptions: ChartOptions,\n): Promise<Buffer> => {\n  // Check if we're in Node.js or browser environment\n  const isNode = typeof window === \"undefined\";\n\n  if (isNode) {\n    return await generateChartInNode(dataTable, chartType, chartOptions);\n  } else {\n    return generateChartInBrowser(dataTable, chartType, chartOptions);\n  }\n};\n\n/**\n * Generate chart in Node.js environment using canvas\n */\nasync function generateChartInNode(\n  dataTable: SmeupDataTable,\n  chartType: string,\n  chartOptions: ChartOptions,\n): Promise<Buffer> {\n  try {\n    // Dynamic import for Node.js canvas\n    const { createCanvas } = await import(\"canvas\");\n\n    const width = Number(chartOptions.Width);\n    const height = Number(chartOptions.Height);\n\n    // Create canvas\n    const canvas = createCanvas(width, height);\n\n    // Create a minimal DOM-like environment for ECharts\n    const mockElement = {\n      clientWidth: width,\n      clientHeight: width,\n      style: {},\n      addEventListener: () => {},\n      removeEventListener: () => {},\n      getAttribute: () => null,\n      setAttribute: () => {},\n      getContext: (type: string) => {\n        if (type === \"2d\") {\n          return canvas.getContext(\"2d\");\n        }\n        return null;\n      },\n      appendChild: () => {},\n      removeChild: () => {},\n      ownerDocument: {\n        createElement: (tagName: string) => {\n          if (tagName === \"canvas\") {\n            return createCanvas(width, height);\n          }\n          return mockElement;\n        },\n        createElementNS: () => mockElement,\n        defaultView: {\n          getComputedStyle: () => ({ getPropertyValue: () => \"\" }),\n        },\n      },\n    };\n\n    // Initialize ECharts with the mock element\n    const chart = echarts.init(mockElement as unknown as HTMLElement, null, {\n      renderer: \"canvas\",\n      useDirtyRect: false,\n      width: width,\n      height: height,\n    });\n\n    // Convert data table to chart configuration\n    const config = convertDataTableToChartConfig(\n      dataTable,\n      chartType,\n      chartOptions,\n    );\n\n    // Set chart options\n    chart.setOption(config as EChartsOption);\n\n    // Force render by calling resize\n    chart.resize();\n\n    // Get image buffer from canvas\n    const imageBuffer = canvas.toBuffer(\"image/jpeg\");\n\n    // Cleanup\n    chart.dispose();\n\n    return imageBuffer;\n  } catch (error) {\n    console.error(\"Error generating chart in Node.js:\", error);\n    throw new Error(\n      `Failed to generate chart: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n    );\n  }\n}\n\n/**\n * Generate chart in browser environment\n */\nfunction generateChartInBrowser(\n  dataTable: SmeupDataTable,\n  chartType: string,\n  chartOptions: ChartOptions,\n): Buffer {\n  try {\n    const width = Number(chartOptions.Width);\n    const height = Number(chartOptions.height);\n    // Create temporary canvas element\n    const canvas = document.createElement(\"canvas\");\n    canvas.width = width;\n    canvas.height = height;\n    canvas.style.position = \"absolute\";\n    canvas.style.left = \"-9999px\";\n    document.body.appendChild(canvas);\n\n    // Initialize ECharts with canvas\n    const chart = echarts.init(canvas, null, {\n      renderer: \"canvas\",\n      useDirtyRect: false,\n      width: width,\n      height: height,\n    });\n\n    // Convert data table to chart configuration\n    const config = convertDataTableToChartConfig(\n      dataTable,\n      chartType,\n      chartOptions,\n    );\n\n    // Set chart options\n    chart.setOption(config as EChartsOption);\n\n    // Get image data\n    const imageDataUrl = chart.getDataURL({\n      type: \"jpeg\",\n      pixelRatio: 1,\n      backgroundColor: \"#fff\",\n    });\n\n    // Convert data URL to buffer\n    const base64Data = imageDataUrl.replace(/^data:image\\/jpeg;base64,/, \"\");\n    const imageBuffer = Buffer.from(base64Data, \"base64\");\n\n    // Cleanup\n    chart.dispose();\n    document.body.removeChild(canvas);\n\n    return imageBuffer;\n  } catch (error) {\n    console.error(\"Error generating chart in browser:\", error);\n    throw new Error(\n      `Failed to generate chart: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n    );\n  }\n}\n\n/**\n * Convert SmeupDataTable to ECharts configuration\n */\nfunction convertDataTableToChartConfig(\n  dataTable: SmeupDataTable,\n  chartType: string,\n  chartOptions: ChartOptions,\n): EChartsOption {\n  if (!dataTable.columns || !dataTable.rows || dataTable.rows.length === 0) {\n    throw new Error(\"Invalid data table: missing columns or rows\");\n  }\n\n  // Get visible columns\n  const visibleColumns = dataTable.columns.filter(col => col.visible !== false);\n\n  if (visibleColumns.length < 2) {\n    throw new Error(\n      \"Data table must have at least 2 visible columns for chart generation\",\n    );\n  }\n\n  // First column is typically used for categories/labels\n  const categoryColumn = visibleColumns[0];\n  const seriesColumns = chartOptions.Series?.split(\"|\");\n  if (!seriesColumns || seriesColumns.length === 0) {\n    throw new Error(\"Chart options must specify at least one series\");\n  }\n  const dataColumns = seriesColumns\n    .map(name => visibleColumns.find(col => col.name === name))\n    .filter(\n      (column): column is NonNullable<typeof column> => column !== undefined,\n    );\n\n  if (dataColumns.length === 0) {\n    throw new Error(\"No valid data columns found for chart series\");\n  }\n\n  // Extract categories from first column\n  const categories = dataTable.rows.map(\n    row => row.cells?.[categoryColumn.name]?.value?.toString() || \"\",\n  );\n\n  // Extract data series from remaining columns\n  const normalizedType = normalizeChartType(chartType);\n  const series = dataColumns.map(column => {\n    const data = dataTable.rows.map(row => {\n      const cellValue = row.cells?.[column.name]?.value;\n      return parseFloat(cellValue?.toString() || \"0\") || 0;\n    });\n\n    const seriesData =\n      chartType.toLowerCase() === \"pie\"\n        ? data.map((value, index) => ({ value, name: categories[index] }))\n        : data;\n\n    // Create properly typed series based on chart type\n    switch (normalizedType) {\n      case \"pie\":\n        return {\n          name: column.title || column.name,\n          type: \"pie\" as const,\n          data: seriesData,\n        };\n      case \"line\":\n        return {\n          name: column.title || column.name,\n          type: \"line\" as const,\n          data: seriesData,\n          lineStyle: { width: 8 },\n        };\n      case \"bar\":\n        return {\n          name: column.title || column.name,\n          type: \"bar\" as const,\n          data: seriesData,\n        };\n      case \"scatter\":\n        return {\n          name: column.title || column.name,\n          type: \"scatter\" as const,\n          data: seriesData,\n        };\n      default:\n        return {\n          name: column.title || column.name,\n          type: \"bar\" as const,\n          data: seriesData,\n        };\n    }\n  });\n\n  // Build chart configuration based on type\n  const config: EChartsOption = {\n    tooltip: {\n      trigger: chartType.toLowerCase() === \"pie\" ? \"item\" : \"axis\",\n    },\n    series,\n    backgroundColor: \"#fff\",\n    textStyle: {\n      fontSize: 36,\n    },\n  };\n  // Add legend for multiple series or pie charts\n  if (series.length > 1 || chartType.toLowerCase() === \"pie\") {\n    config.legend = {\n      data: series.map(s => s.name),\n      textStyle: { fontSize: 32 },\n    };\n  }\n\n  // Add axes for non-pie charts\n  if (chartType.toLowerCase() !== \"pie\") {\n    config.xAxis = {\n      type: \"category\",\n      data: categories,\n      axisLabel: { fontSize: 32 },\n    };\n    config.yAxis = {\n      type: \"value\",\n      axisLabel: { fontSize: 32 },\n    };\n  }\n\n  return config;\n}\n\n/**\n * Normalize chart type to ECharts supported types\n */\nfunction normalizeChartType(chartType: string): string {\n  const type = chartType.toLowerCase();\n  switch (type) {\n    case \"bar\":\n    case \"column\":\n      return \"bar\";\n    case \"line\":\n      return \"line\";\n    case \"pie\":\n      return \"pie\";\n    case \"scatter\":\n      return \"scatter\";\n    default:\n      console.warn(`Unknown chart type: ${chartType}, defaulting to bar`);\n      return \"bar\";\n  }\n}\n"]}

package/dist/converters/pdf/autotable-renderer.d.ts

@@ -0,0 +1,3 @@
+import { UserOptions } from "jspdf-autotable";
+import { CellStyleData, CellValueProps } from "./pdf-converter.types.js";
+export declare const getAutoTableOptions: (visibleHeaders: string[], data: CellValueProps[][], optimalFontSize: number, cellStyles: CellStyleData[][], logoBase64?: string) => UserOptions;

package/dist/converters/pdf/autotable-renderer.js

@@ -0,0 +1,89 @@
+export const getAutoTableOptions = (visibleHeaders, data, optimalFontSize, cellStyles, logoBase64) => {
+    const { styles, columnStyles, headStyles } = getTableStyles(visibleHeaders, optimalFontSize);
+    return {
+        head: [visibleHeaders],
+        body: data.map(row => row.map(cell => cell.text)),
+        startY: 25,
+        margin: { left: 5, right: 5, top: 25, bottom: 10 },
+        styles,
+        columnStyles,
+        headStyles,
+        didDrawPage: dataArg => didDrawPageHandler(dataArg, logoBase64),
+        didParseCell: dataArg => didParseCellHandler(dataArg, cellStyles),
+    };
+};
+const getTableStyles = (visibleHeaders, optimalFontSize) => {
+    const styles = {
+        font: "helvetica",
+        fontSize: optimalFontSize + 1,
+        cellPadding: 1,
+        overflow: "visible",
+        cellWidth: "auto",
+        minCellWidth: 5,
+    };
+    const columnStyles = {
+        ...Object.fromEntries(visibleHeaders.map((_, index) => [
+            index,
+            {
+                cellWidth: "wrap",
+                halign: "left",
+                overflow: "visible",
+                cellPadding: { top: 1, right: 1, bottom: 1, left: 1 },
+            },
+        ])),
+    };
+    const headStyles = {
+        fillColor: [255, 0, 0],
+        textColor: [255, 255, 255],
+        fontStyle: "bold",
+        halign: "center",
+    };
+    return { styles, columnStyles, headStyles };
+};
+const didParseCellHandler = (dataArg, cellStyles) => {
+    if (dataArg.section === "body") {
+        const rowIndex = dataArg.row.index;
+        const colIndex = dataArg.column.index;
+        const cellStyle = cellStyles[rowIndex]?.[colIndex];
+        if (cellStyle) {
+            // Apply styles from the Excel cell
+            if (cellStyle.fontStyle) {
+                dataArg.cell.styles.fontStyle = cellStyle.fontStyle;
+            }
+            if (cellStyle.textColor) {
+                dataArg.cell.styles.textColor = cellStyle.textColor;
+            }
+            if (cellStyle.fillColor) {
+                dataArg.cell.styles.fillColor = cellStyle.fillColor;
+            }
+            if (cellStyle.halign === "right") {
+                dataArg.cell.styles.halign = "right";
+            }
+        }
+    }
+};
+const didDrawPageHandler = (dataArg, logoBase64) => {
+    // Add the logo on each page
+    if (logoBase64) {
+        const pageWidth = dataArg.doc.internal.pageSize.getWidth();
+        const logoWidth = 40; // Logo width in mm
+        const logoHeight = 15; // Logo height in mm
+        const logoX = pageWidth - logoWidth - 10; // 10mm from the right margin
+        const logoY = 5; // 5mm from the top margin
+        // Add the text "Intestazione" aligned to the left margin
+        const text = "Intestazione";
+        const textFontSize = 14;
+        const textX = 5;
+        const textY = 10;
+        dataArg.doc.setFontSize(textFontSize);
+        dataArg.doc.setFont("helvetica", "normal");
+        dataArg.doc.text(text, textX, textY, { align: "left" });
+        try {
+            dataArg.doc.addImage(logoBase64, "PNG", logoX, logoY, logoWidth, logoHeight);
+        }
+        catch (error) {
+            console.warn("Error adding logo:", error);
+        }
+    }
+};
+//# sourceMappingURL=autotable-renderer.js.map

package/dist/converters/pdf/autotable-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autotable-renderer.js","sourceRoot":"","sources":["../../../src/converters/pdf/autotable-renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import { UserOptions } from \"jspdf-autotable\";\nimport { CellStyleData, CellValueProps } from \"./pdf-converter.types.js\";\nimport type {\n  Styles,\n  OverflowType,\n  FontStyle,\n  CellHookData,\n  HookData,\n} from \"jspdf-autotable\";\n\ntype TableStyles = {\n  styles: Partial<Styles>;\n  columnStyles: Record<string, Partial<Styles>>;\n  headStyles: Partial<Styles>;\n};\n\nexport const getAutoTableOptions = (\n  visibleHeaders: string[],\n  data: CellValueProps[][],\n  optimalFontSize: number,\n  cellStyles: CellStyleData[][],\n  logoBase64?: string,\n): UserOptions => {\n  const { styles, columnStyles, headStyles } = getTableStyles(\n    visibleHeaders,\n    optimalFontSize,\n  );\n  return {\n    head: [visibleHeaders],\n    body: data.map(row => row.map(cell => cell.text)),\n    startY: 25,\n    margin: { left: 5, right: 5, top: 25, bottom: 10 },\n    styles,\n    columnStyles,\n    headStyles,\n    didDrawPage: dataArg => didDrawPageHandler(dataArg, logoBase64),\n    didParseCell: dataArg => didParseCellHandler(dataArg, cellStyles),\n  };\n};\n\nconst getTableStyles = (\n  visibleHeaders: string[],\n  optimalFontSize: number,\n): TableStyles => {\n  const styles: Partial<Styles> = {\n    font: \"helvetica\",\n    fontSize: optimalFontSize + 1,\n    cellPadding: 1,\n    overflow: \"visible\" as OverflowType,\n    cellWidth: \"auto\",\n    minCellWidth: 5,\n  };\n\n  const columnStyles: { [key: string]: Partial<Styles> } = {\n    ...Object.fromEntries(\n      visibleHeaders.map((_, index) => [\n        index,\n        {\n          cellWidth: \"wrap\",\n          halign: \"left\",\n          overflow: \"visible\" as OverflowType,\n          cellPadding: { top: 1, right: 1, bottom: 1, left: 1 },\n        },\n      ]),\n    ),\n  };\n\n  const headStyles: Partial<Styles> = {\n    fillColor: [255, 0, 0],\n    textColor: [255, 255, 255],\n    fontStyle: \"bold\" as FontStyle,\n    halign: \"center\",\n  };\n\n  return { styles, columnStyles, headStyles };\n};\n\nconst didParseCellHandler = (\n  dataArg: CellHookData,\n  cellStyles: CellStyleData[][],\n) => {\n  if (dataArg.section === \"body\") {\n    const rowIndex = dataArg.row.index;\n    const colIndex = dataArg.column.index;\n    const cellStyle = cellStyles[rowIndex]?.[colIndex];\n\n    if (cellStyle) {\n      // Apply styles from the Excel cell\n      if (cellStyle.fontStyle) {\n        dataArg.cell.styles.fontStyle = cellStyle.fontStyle;\n      }\n      if (cellStyle.textColor) {\n        dataArg.cell.styles.textColor = cellStyle.textColor;\n      }\n      if (cellStyle.fillColor) {\n        dataArg.cell.styles.fillColor = cellStyle.fillColor;\n      }\n      if (cellStyle.halign === \"right\") {\n        dataArg.cell.styles.halign = \"right\";\n      }\n    }\n  }\n};\n\nconst didDrawPageHandler = (dataArg: HookData, logoBase64?: string) => {\n  // Add the logo on each page\n  if (logoBase64) {\n    const pageWidth = dataArg.doc.internal.pageSize.getWidth();\n    const logoWidth = 40; // Logo width in mm\n    const logoHeight = 15; // Logo height in mm\n    const logoX = pageWidth - logoWidth - 10; // 10mm from the right margin\n    const logoY = 5; // 5mm from the top margin\n\n    // Add the text \"Intestazione\" aligned to the left margin\n    const text = \"Intestazione\";\n    const textFontSize = 14;\n    const textX = 5;\n    const textY = 10;\n    dataArg.doc.setFontSize(textFontSize);\n    dataArg.doc.setFont(\"helvetica\", \"normal\");\n    dataArg.doc.text(text, textX, textY, { align: \"left\" });\n\n    try {\n      dataArg.doc.addImage(\n        logoBase64,\n        \"PNG\",\n        logoX,\n        logoY,\n        logoWidth,\n        logoHeight,\n      );\n    } catch (error) {\n      console.warn(\"Error adding logo:\", error);\n    }\n  }\n};\n"]}

package/dist/converters/pdf/cover-renderer.d.ts

@@ -0,0 +1 @@
+export declare const createCoverPdf: (title: string, subtitle: string, subtitle2?: string) => ArrayBuffer;

package/dist/converters/pdf/cover-renderer.js

@@ -0,0 +1,26 @@
+import * as jsPDFModule from "jspdf";
+export const createCoverPdf = (title, subtitle, subtitle2) => {
+    const doc = new jsPDFModule.jsPDF("landscape");
+    const pageWidth = doc.internal.pageSize.getWidth();
+    const titleFontSize = 24;
+    const subtitleFontSize = 16;
+    const subtitle2FontSize = 14;
+    let currentY = 45;
+    doc.setFont("helvetica", "bold");
+    doc.setFontSize(titleFontSize);
+    doc.text(title, pageWidth / 2, currentY, { align: "center" });
+    currentY += 1;
+    if (subtitle) {
+        doc.setFont("helvetica", "normal");
+        doc.setFontSize(subtitleFontSize);
+        currentY += subtitleFontSize - 8;
+        doc.text(subtitle, pageWidth / 2, currentY, { align: "center" });
+    }
+    if (subtitle2) {
+        doc.setFontSize(subtitle2FontSize);
+        currentY += subtitle2FontSize;
+        doc.text(subtitle2, pageWidth / 2, currentY, { align: "center" });
+    }
+    return doc.output("arraybuffer");
+};
+//# sourceMappingURL=cover-renderer.js.map

package/dist/converters/pdf/cover-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cover-renderer.js","sourceRoot":"","sources":["../../../src/converters/pdf/cover-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,OAAO,CAAC;AAErC,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAa,EACb,QAAgB,EAChB,SAAkB,EAClB,EAAE;IACF,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACnD,MAAM,aAAa,GAAG,EAAE,CAAC;IACzB,MAAM,gBAAgB,GAAG,EAAE,CAAC;IAC5B,MAAM,iBAAiB,GAAG,EAAE,CAAC;IAC7B,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,QAAQ,IAAI,CAAC,CAAC;IAEd,IAAI,QAAQ,EAAE,CAAC;QACb,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACnC,GAAG,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QAClC,QAAQ,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,GAAG,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QACnC,QAAQ,IAAI,iBAAiB,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC,CAAC","sourcesContent":["import * as jsPDFModule from \"jspdf\";\n\nexport const createCoverPdf = (\n  title: string,\n  subtitle: string,\n  subtitle2?: string,\n) => {\n  const doc = new jsPDFModule.jsPDF(\"landscape\");\n  const pageWidth = doc.internal.pageSize.getWidth();\n  const titleFontSize = 24;\n  const subtitleFontSize = 16;\n  const subtitle2FontSize = 14;\n  let currentY = 45;\n\n  doc.setFont(\"helvetica\", \"bold\");\n  doc.setFontSize(titleFontSize);\n  doc.text(title, pageWidth / 2, currentY, { align: \"center\" });\n  currentY += 1;\n\n  if (subtitle) {\n    doc.setFont(\"helvetica\", \"normal\");\n    doc.setFontSize(subtitleFontSize);\n    currentY += subtitleFontSize - 8;\n    doc.text(subtitle, pageWidth / 2, currentY, { align: \"center\" });\n  }\n\n  if (subtitle2) {\n    doc.setFontSize(subtitle2FontSize);\n    currentY += subtitle2FontSize;\n    doc.text(subtitle2, pageWidth / 2, currentY, { align: \"center\" });\n  }\n\n  return doc.output(\"arraybuffer\");\n};\n"]}

package/dist/converters/pdf/formulas-helper.d.ts

@@ -0,0 +1,40 @@
+import { WebupManagerData } from "../../types/index.js";
+import { CellValueProps } from "./pdf-converter.types.js";
+import ExcelJS from "exceljs";
+/**
+ * Handles the calculation of Excel-like SUBTOTAL formulas for a given cell and range.
+ *
+ * Supports various SUBTOTAL types such as SUM, AVERAGE, COUNTA, MAX, and MIN.
+ * The function extracts the relevant range from the worksheet, computes the result
+ * based on the subtotal type, and formats the output as needed (including date and number formatting).
+ *
+ * @param cell - The ExcelJS cell object where the formula is applied.
+ * @param worksheet - The ExcelJS worksheet containing the data range.
+ * @param webupManagerData - Additional data/context used for formatting numbers and dates.
+ * @param subtotalMatch - The RegExp match array containing the parsed SUBTOTAL formula components:
+ *   - [1]: The subtotal type (e.g., 1 for AVERAGE, 3 for COUNTA, 4 for MAX, 5 for MIN, 9 for SUM).
+ *   - [2]: The start cell reference of the range.
+ *   - [3]: The end cell reference of the range.
+ * @returns An object containing the computed value and its type ("number" or "string").
+ */
+export declare const handleSubtotalFormula: (cell: ExcelJS.Cell, worksheet: ExcelJS.Worksheet, webupManagerData: WebupManagerData, subtotalMatch: RegExpMatchArray) => CellValueProps;
+/**
+ * Evaluates a standard Excel formula from a given cell by replacing cell references
+ * with their actual values from the worksheet and then computing the result.
+ *
+ * - Replaces cell references (e.g., "A1") in the formula with their corresponding values.
+ * - Handles different cell value types: number, string, formula result, and date.
+ * - Evaluates the resulting formula string using a safe function context.
+ * - Applies number formatting if the result is numeric and a format is specified.
+ * - Returns the computed value and its type ("number" or "string").
+ *
+ * @param cell - The ExcelJS cell containing the formula to evaluate.
+ * @param worksheet - The ExcelJS worksheet object for resolving cell references.
+ * @param webupManagerData - Additional data used for number formatting.
+ * @returns An object containing the evaluated value and its type.
+ */
+export declare const evaluateStandardFormula: (cell: ExcelJS.Cell, worksheet: ExcelJS.Worksheet, webupManagerData: WebupManagerData) => CellValueProps;
+/**
+ * Extracts and formats the value of a given ExcelJS cell based on its type.
+ */
+export declare const getCellValueData: (cell: ExcelJS.Cell, worksheet: ExcelJS.Worksheet, webupManagerData: WebupManagerData) => CellValueProps;

package/dist/converters/pdf/formulas-helper.js

@@ -0,0 +1,227 @@
+import { getCellsFromRange } from "../excel/commons.js";
+import { areAllValuesDates } from "../../utils/dates-utility.js";
+import { formatDate, formatNumber } from "../../utils/formatter-utility.js";
+import ExcelJS from "exceljs";
+import { calculateExpression } from "../../utils/math-utility.js";
+/**
+ * Handles the calculation of Excel-like SUBTOTAL formulas for a given cell and range.
+ *
+ * Supports various SUBTOTAL types such as SUM, AVERAGE, COUNTA, MAX, and MIN.
+ * The function extracts the relevant range from the worksheet, computes the result
+ * based on the subtotal type, and formats the output as needed (including date and number formatting).
+ *
+ * @param cell - The ExcelJS cell object where the formula is applied.
+ * @param worksheet - The ExcelJS worksheet containing the data range.
+ * @param webupManagerData - Additional data/context used for formatting numbers and dates.
+ * @param subtotalMatch - The RegExp match array containing the parsed SUBTOTAL formula components:
+ *   - [1]: The subtotal type (e.g., 1 for AVERAGE, 3 for COUNTA, 4 for MAX, 5 for MIN, 9 for SUM).
+ *   - [2]: The start cell reference of the range.
+ *   - [3]: The end cell reference of the range.
+ * @returns An object containing the computed value and its type ("number" or "string").
+ */
+export const handleSubtotalFormula = (cell, worksheet, webupManagerData, subtotalMatch) => {
+    const subtotalType = parseInt(subtotalMatch[1], 10);
+    const startRef = subtotalMatch[2];
+    const endRef = subtotalMatch[3];
+    const cells = getCellsFromRange(worksheet, startRef, endRef).filter(cell => cell.type !== ExcelJS.ValueType.Formula);
+    let result;
+    const areAllDates = areAllValuesDates(cells);
+    switch (subtotalType) {
+        case 3: // COUNTA
+            result = cells.length;
+            break;
+        case 9: // SUM
+            result = cells.reduce((sum, cell) => {
+                const n = typeof cell.value === "number"
+                    ? cell.value
+                    : typeof cell.value === "string"
+                        ? parseFloat(cell.value)
+                        : NaN;
+                return !isNaN(n)
+                    ? (typeof sum === "number"
+                        ? sum
+                        : typeof sum === "string"
+                            ? parseFloat(sum)
+                            : 0) + n
+                    : sum;
+            }, 0);
+            break;
+        case 4: // MAX
+            result = cells.length
+                ? Math.max(...cells.map(cell => {
+                    if (cell.type === ExcelJS.ValueType.Date) {
+                        return cell.value instanceof Date
+                            ? cell.value.getTime()
+                            : -Infinity;
+                    }
+                    return typeof cell.value === "number"
+                        ? cell.value
+                        : (typeof cell.value === "string"
+                            ? parseFloat(cell.value)
+                            : -Infinity) || -Infinity;
+                }))
+                : "";
+            break;
+        case 5: // MIN
+            result = cells.length
+                ? Math.min(...cells.map(cell => {
+                    if (cell.type === ExcelJS.ValueType.Date) {
+                        return cell.value instanceof Date
+                            ? cell.value.getTime()
+                            : Infinity;
+                    }
+                    return typeof cell.value === "number"
+                        ? cell.value
+                        : (typeof cell.value === "string"
+                            ? parseFloat(cell.value)
+                            : Infinity) || Infinity;
+                }))
+                : "";
+            break;
+        case 1: {
+            // AVERAGE
+            const nums = cells
+                .map(cell => typeof cell.value === "number"
+                ? cell.value
+                : typeof cell.value === "string"
+                    ? parseFloat(cell.value)
+                    : NaN)
+                .filter(v => !isNaN(v));
+            result = nums.length ? nums.reduce((a, b) => a + b, 0) / nums.length : "";
+            break;
+        }
+        default: {
+            if (cell.result != null && typeof cell.result !== "object") {
+                result = cell.result;
+            }
+            else {
+                result =
+                    cell.text ||
+                        (typeof cell.value === "string" || typeof cell.value === "number"
+                            ? cell.value
+                            : "") ||
+                        "";
+            }
+            break;
+        }
+    }
+    if (areAllDates) {
+        return {
+            value: result,
+            text: formatDate(new Date(result), webupManagerData),
+            type: "date",
+        };
+    }
+    else if (typeof result === "number" && cell.numFmt) {
+        return {
+            value: result,
+            text: formatNumber(result, cell.numFmt, webupManagerData),
+            type: "number",
+        };
+    }
+    return {
+        value: result,
+        text: result.toString(),
+        type: typeof result === "number" ? "number" : "string",
+    };
+};
+/**
+ * Evaluates a standard Excel formula from a given cell by replacing cell references
+ * with their actual values from the worksheet and then computing the result.
+ *
+ * - Replaces cell references (e.g., "A1") in the formula with their corresponding values.
+ * - Handles different cell value types: number, string, formula result, and date.
+ * - Evaluates the resulting formula string using a safe function context.
+ * - Applies number formatting if the result is numeric and a format is specified.
+ * - Returns the computed value and its type ("number" or "string").
+ *
+ * @param cell - The ExcelJS cell containing the formula to evaluate.
+ * @param worksheet - The ExcelJS worksheet object for resolving cell references.
+ * @param webupManagerData - Additional data used for number formatting.
+ * @returns An object containing the evaluated value and its type.
+ */
+export const evaluateStandardFormula = (cell, worksheet, webupManagerData) => {
+    const formula = cell.formula;
+    const formulaWithSolvedVariables = formula.replace(/([A-Z]+\d+)/g, ref => {
+        try {
+            const refCell = worksheet.getCell(ref);
+            if (refCell) {
+                if (refCell.type === ExcelJS.ValueType.Number) {
+                    return refCell.value?.toString() ?? "0";
+                }
+                else if (refCell.type === ExcelJS.ValueType.String) {
+                    // If the cell contains text, return as is (no quotes) for JS compatibility
+                    return refCell.value?.toString() ?? "";
+                }
+                else if (refCell.type === ExcelJS.ValueType.Formula) {
+                    return getCellValueData(refCell, worksheet, webupManagerData).value.toString();
+                }
+                else if (refCell.type === ExcelJS.ValueType.Date &&
+                    refCell.value instanceof Date) {
+                    return refCell.value.getTime().toString();
+                }
+                else {
+                    return refCell.value?.toString() ?? "0";
+                }
+            }
+        }
+        catch {
+            return "0";
+        }
+        return "0";
+    });
+    const result = calculateExpression(formulaWithSolvedVariables);
+    // If the result is a number and a format is specified, apply it
+    if (typeof result === "number" && cell.numFmt) {
+        return {
+            value: result,
+            text: formatNumber(result, cell.numFmt, webupManagerData),
+            type: "number",
+        };
+    }
+    return {
+        value: result,
+        text: result != null ? result.toString() : cell.formula,
+        type: typeof result === "number" ? "number" : "string",
+    };
+};
+/**
+ * Extracts and formats the value of a given ExcelJS cell based on its type.
+ */
+export const getCellValueData = (cell, worksheet, webupManagerData) => {
+    if (cell.type === ExcelJS.ValueType.Formula &&
+        typeof cell.formula === "string") {
+        const subtotalMatch = cell.formula.match(/^SUBTOTAL\((\d+)\s*,\s*([A-Z]+\d+):([A-Z]+\d+)\)/i);
+        if (subtotalMatch) {
+            return handleSubtotalFormula(cell, worksheet, webupManagerData, subtotalMatch);
+        }
+        else {
+            return evaluateStandardFormula(cell, worksheet, webupManagerData);
+        }
+    }
+    else if (cell.type === ExcelJS.ValueType.Date &&
+        cell.value instanceof Date) {
+        return {
+            value: cell.value,
+            text: formatDate(cell.value, webupManagerData),
+            type: "date",
+        };
+    }
+    else if (cell.type === ExcelJS.ValueType.Number) {
+        return {
+            value: cell.value,
+            text: formatNumber(cell.value, cell.numFmt ?? 0, webupManagerData),
+            type: "number",
+        };
+    }
+    else {
+        // Fallback to text or value if available, otherwise empty string
+        const value = cell?.text || cell?.value?.toString() || "";
+        return {
+            value: value,
+            text: value,
+            type: "string",
+        };
+    }
+};
+//# sourceMappingURL=formulas-helper.js.map

package/dist/converters/pdf/formulas-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formulas-helper.js","sourceRoot":"","sources":["../../../src/converters/pdf/formulas-helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { getCellsFromRange } from \"../excel/commons.js\";\nimport { WebupManagerData } from \"../../types/index.js\";\nimport { areAllValuesDates } from \"../../utils/dates-utility.js\";\nimport { formatDate, formatNumber } from \"../../utils/formatter-utility.js\";\nimport { CellValueProps } from \"./pdf-converter.types.js\";\nimport ExcelJS from \"exceljs\";\nimport { calculateExpression } from \"../../utils/math-utility.js\";\n\n/**\n * Handles the calculation of Excel-like SUBTOTAL formulas for a given cell and range.\n *\n * Supports various SUBTOTAL types such as SUM, AVERAGE, COUNTA, MAX, and MIN.\n * The function extracts the relevant range from the worksheet, computes the result\n * based on the subtotal type, and formats the output as needed (including date and number formatting).\n *\n * @param cell - The ExcelJS cell object where the formula is applied.\n * @param worksheet - The ExcelJS worksheet containing the data range.\n * @param webupManagerData - Additional data/context used for formatting numbers and dates.\n * @param subtotalMatch - The RegExp match array containing the parsed SUBTOTAL formula components:\n *   - [1]: The subtotal type (e.g., 1 for AVERAGE, 3 for COUNTA, 4 for MAX, 5 for MIN, 9 for SUM).\n *   - [2]: The start cell reference of the range.\n *   - [3]: The end cell reference of the range.\n * @returns An object containing the computed value and its type (\"number\" or \"string\").\n */\nexport const handleSubtotalFormula = (\n  cell: ExcelJS.Cell,\n  worksheet: ExcelJS.Worksheet,\n  webupManagerData: WebupManagerData,\n  subtotalMatch: RegExpMatchArray,\n): CellValueProps => {\n  const subtotalType = parseInt(subtotalMatch[1], 10);\n  const startRef = subtotalMatch[2];\n  const endRef = subtotalMatch[3];\n  const cells = getCellsFromRange(worksheet, startRef, endRef).filter(\n    cell => cell.type !== ExcelJS.ValueType.Formula,\n  );\n  let result: number | string | \"\";\n  const areAllDates = areAllValuesDates(cells);\n  switch (subtotalType) {\n    case 3: // COUNTA\n      result = cells.length;\n      break;\n    case 9: // SUM\n      result = cells.reduce((sum, cell) => {\n        const n =\n          typeof cell.value === \"number\"\n            ? cell.value\n            : typeof cell.value === \"string\"\n              ? parseFloat(cell.value)\n              : NaN;\n        return !isNaN(n)\n          ? (typeof sum === \"number\"\n              ? sum\n              : typeof sum === \"string\"\n                ? parseFloat(sum)\n                : 0) + n\n          : sum;\n      }, 0);\n      break;\n    case 4: // MAX\n      result = cells.length\n        ? Math.max(\n            ...cells.map(cell => {\n              if (cell.type === ExcelJS.ValueType.Date) {\n                return cell.value instanceof Date\n                  ? cell.value.getTime()\n                  : -Infinity;\n              }\n              return typeof cell.value === \"number\"\n                ? cell.value\n                : (typeof cell.value === \"string\"\n                    ? parseFloat(cell.value)\n                    : -Infinity) || -Infinity;\n            }),\n          )\n        : \"\";\n      break;\n    case 5: // MIN\n      result = cells.length\n        ? Math.min(\n            ...cells.map(cell => {\n              if (cell.type === ExcelJS.ValueType.Date) {\n                return cell.value instanceof Date\n                  ? cell.value.getTime()\n                  : Infinity;\n              }\n              return typeof cell.value === \"number\"\n                ? cell.value\n                : (typeof cell.value === \"string\"\n                    ? parseFloat(cell.value)\n                    : Infinity) || Infinity;\n            }),\n          )\n        : \"\";\n      break;\n    case 1: {\n      // AVERAGE\n      const nums = cells\n        .map(cell =>\n          typeof cell.value === \"number\"\n            ? cell.value\n            : typeof cell.value === \"string\"\n              ? parseFloat(cell.value)\n              : NaN,\n        )\n        .filter(v => !isNaN(v));\n      result = nums.length ? nums.reduce((a, b) => a + b, 0) / nums.length : \"\";\n      break;\n    }\n    default: {\n      if (cell.result != null && typeof cell.result !== \"object\") {\n        result = cell.result;\n      } else {\n        result =\n          cell.text ||\n          (typeof cell.value === \"string\" || typeof cell.value === \"number\"\n            ? cell.value\n            : \"\") ||\n          \"\";\n      }\n      break;\n    }\n  }\n\n  if (areAllDates) {\n    return {\n      value: result,\n      text: formatDate(new Date(result), webupManagerData),\n      type: \"date\",\n    };\n  } else if (typeof result === \"number\" && cell.numFmt) {\n    return {\n      value: result,\n      text: formatNumber(result, cell.numFmt, webupManagerData),\n      type: \"number\",\n    };\n  }\n  return {\n    value: result,\n    text: result.toString(),\n    type: typeof result === \"number\" ? \"number\" : \"string\",\n  };\n};\n\n/**\n * Evaluates a standard Excel formula from a given cell by replacing cell references\n * with their actual values from the worksheet and then computing the result.\n *\n * - Replaces cell references (e.g., \"A1\") in the formula with their corresponding values.\n * - Handles different cell value types: number, string, formula result, and date.\n * - Evaluates the resulting formula string using a safe function context.\n * - Applies number formatting if the result is numeric and a format is specified.\n * - Returns the computed value and its type (\"number\" or \"string\").\n *\n * @param cell - The ExcelJS cell containing the formula to evaluate.\n * @param worksheet - The ExcelJS worksheet object for resolving cell references.\n * @param webupManagerData - Additional data used for number formatting.\n * @returns An object containing the evaluated value and its type.\n */\nexport const evaluateStandardFormula = (\n  cell: ExcelJS.Cell,\n  worksheet: ExcelJS.Worksheet,\n  webupManagerData: WebupManagerData,\n): CellValueProps => {\n  const formula = cell.formula;\n  const formulaWithSolvedVariables = formula.replace(/([A-Z]+\\d+)/g, ref => {\n    try {\n      const refCell = worksheet.getCell(ref);\n      if (refCell) {\n        if (refCell.type === ExcelJS.ValueType.Number) {\n          return refCell.value?.toString() ?? \"0\";\n        } else if (refCell.type === ExcelJS.ValueType.String) {\n          // If the cell contains text, return as is (no quotes) for JS compatibility\n          return refCell.value?.toString() ?? \"\";\n        } else if (refCell.type === ExcelJS.ValueType.Formula) {\n          return getCellValueData(\n            refCell,\n            worksheet,\n            webupManagerData,\n          ).value.toString();\n        } else if (\n          refCell.type === ExcelJS.ValueType.Date &&\n          refCell.value instanceof Date\n        ) {\n          return refCell.value.getTime().toString();\n        } else {\n          return refCell.value?.toString() ?? \"0\";\n        }\n      }\n    } catch {\n      return \"0\";\n    }\n    return \"0\";\n  });\n  const result = calculateExpression(formulaWithSolvedVariables);\n  // If the result is a number and a format is specified, apply it\n  if (typeof result === \"number\" && cell.numFmt) {\n    return {\n      value: result,\n      text: formatNumber(result, cell.numFmt, webupManagerData),\n      type: \"number\",\n    };\n  }\n  return {\n    value: result,\n    text: result != null ? result.toString() : cell.formula,\n    type: typeof result === \"number\" ? \"number\" : \"string\",\n  };\n};\n\n/**\n * Extracts and formats the value of a given ExcelJS cell based on its type.\n */\nexport const getCellValueData = (\n  cell: ExcelJS.Cell,\n  worksheet: ExcelJS.Worksheet,\n  webupManagerData: WebupManagerData,\n): CellValueProps => {\n  if (\n    cell.type === ExcelJS.ValueType.Formula &&\n    typeof cell.formula === \"string\"\n  ) {\n    const subtotalMatch = cell.formula.match(\n      /^SUBTOTAL\\((\\d+)\\s*,\\s*([A-Z]+\\d+):([A-Z]+\\d+)\\)/i,\n    );\n    if (subtotalMatch) {\n      return handleSubtotalFormula(\n        cell,\n        worksheet,\n        webupManagerData,\n        subtotalMatch,\n      );\n    } else {\n      return evaluateStandardFormula(cell, worksheet, webupManagerData);\n    }\n  } else if (\n    cell.type === ExcelJS.ValueType.Date &&\n    cell.value instanceof Date\n  ) {\n    return {\n      value: cell.value,\n      text: formatDate(cell.value, webupManagerData),\n      type: \"date\",\n    };\n  } else if (cell.type === ExcelJS.ValueType.Number) {\n    return {\n      value: cell.value as number,\n      text: formatNumber(\n        cell.value as number,\n        cell.numFmt ?? 0,\n        webupManagerData,\n      ),\n      type: \"number\",\n    };\n  } else {\n    // Fallback to text or value if available, otherwise empty string\n    const value = cell?.text || cell?.value?.toString() || \"\";\n    return {\n      value: value,\n      text: value,\n      type: \"string\",\n    };\n  }\n};\n"]}

package/dist/converters/pdf/matrix-converter.d.ts

@@ -0,0 +1,16 @@
+import * as jsPDFModule from "jspdf";
+import ExcelJS from "exceljs";
+import { WebupManagerData } from "../../index.js";
+/**
+ * Converts an ExcelJS worksheet into a PDF document using jsPDF and autoTable.
+ *
+ * This function extracts visible headers and data from the provided worksheet,
+ * applies cell styles, simulates Excel cell overflow, and calculates the optimal
+ * font size for the table. It then generates a PDF document with the formatted
+ * table and returns the resulting jsPDF instance.
+ *
+ * @param worksheet - The ExcelJS worksheet to convert to PDF.
+ * @param webupManagerData - Additional data required for extracting worksheet content.
+ * @returns A Promise that resolves to a jsPDF document containing the worksheet data as a table.
+ */
+export declare const dataTableToPdfDoc: (worksheet: ExcelJS.Worksheet, webupManagerData: WebupManagerData) => Promise<jsPDFModule.jsPDF>;