@sme.up/doc-alchemist 1.1.0-SNAPSHOT-20250623155458 → 1.2.0-20250805123329

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

@@ -0,0 +1,83 @@
+import { getLogoPositionAndDimension } from "../../utils/image-utils.js";
+export const getAutoTableOptions = (visibleHeaders, data, optimalFontSize, cellStyles, context) => {
+    const { styles, columnStyles, headStyles } = getTableStyles(visibleHeaders, optimalFontSize);
+    return {
+        head: [visibleHeaders],
+        body: data.map(row => row.map(cell => cell.text)),
+        startY: 20,
+        margin: { left: 5, right: 5, top: 20, bottom: 10 },
+        styles,
+        columnStyles,
+        headStyles,
+        didDrawPage: dataArg => didDrawPageHandler(dataArg, context),
+        didParseCell: dataArg => didParseCellHandler(dataArg, cellStyles),
+    };
+};
+const getTableStyles = (visibleHeaders, optimalFontSize) => {
+    const styles = {
+        font: "helvetica",
+        fontSize: optimalFontSize + 1,
+        cellPadding: 1,
+        overflow: "linebreak",
+        cellWidth: "auto",
+        minCellWidth: 5,
+    };
+    const columnStyles = {
+        ...Object.fromEntries(visibleHeaders.map((_, index) => [
+            index,
+            {
+                cellWidth: "auto",
+                halign: "left",
+                overflow: "linebreak",
+                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
+            Object.assign(dataArg.cell.styles, cellStyle);
+        }
+    }
+};
+const didDrawPageHandler = (dataArg, context) => {
+    const pageWidth = dataArg.doc.internal.pageSize.getWidth();
+    // Add the logo on each page
+    if (context?.logoBase64) {
+        const { logoWidth, logoHeight, logoX, logoY } = getLogoPositionAndDimension(dataArg.doc, context.logoBase64);
+        try {
+            dataArg.doc.addImage(context.logoBase64, "PNG", logoX, logoY, logoWidth, logoHeight);
+        }
+        catch (error) {
+            console.warn("Error adding logo:", error);
+        }
+    }
+    const textFontSize = 13;
+    const textX = 5;
+    let textY = 10;
+    // at this point I believe that, since the limited vertical space, if text is too long to be fit into one line, it should be trimmed (first element of split is taken into account)
+    if (context?.title) {
+        const title = dataArg.doc.splitTextToSize(context.title, pageWidth * 0.65)[0];
+        dataArg.doc.setFontSize(textFontSize);
+        dataArg.doc.setFont("helvetica", "normal");
+        dataArg.doc.text(title, textX, textY, { align: "left" });
+    }
+    if (context?.subtitle) {
+        textY += textFontSize / 2;
+        const subtitle = dataArg.doc.splitTextToSize(context.subtitle, pageWidth * 0.65)[0];
+        dataArg.doc.text(subtitle, textX, textY, { align: "left" });
+    }
+};
+//# 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\";\nimport { getLogoPositionAndDimension } from \"../../utils/image-utils.js\";\nimport { ConverterContext } from \"../../types/converter.js\";\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  context: ConverterContext,\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: 20,\n    margin: { left: 5, right: 5, top: 20, bottom: 10 },\n    styles,\n    columnStyles,\n    headStyles,\n    didDrawPage: dataArg => didDrawPageHandler(dataArg, context),\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: \"linebreak\" 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: \"auto\",\n          halign: \"left\",\n          overflow: \"linebreak\" 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      Object.assign(dataArg.cell.styles, cellStyle);\n    }\n  }\n};\n\nconst didDrawPageHandler = (dataArg: HookData, context: ConverterContext) => {\n  const pageWidth = dataArg.doc.internal.pageSize.getWidth();\n\n  // Add the logo on each page\n  if (context?.logoBase64) {\n    const { logoWidth, logoHeight, logoX, logoY } = getLogoPositionAndDimension(\n      dataArg.doc,\n      context.logoBase64,\n    );\n\n    try {\n      dataArg.doc.addImage(\n        context.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  const textFontSize = 13;\n  const textX = 5;\n  let textY = 10;\n\n  // at this point I believe that, since the limited vertical space, if text is too long to be fit into one line, it should be trimmed (first element of split is taken into account)\n\n  if (context?.title) {\n    const title = dataArg.doc.splitTextToSize(\n      context.title,\n      pageWidth * 0.65,\n    )[0];\n    dataArg.doc.setFontSize(textFontSize);\n    dataArg.doc.setFont(\"helvetica\", \"normal\");\n    dataArg.doc.text(title, textX, textY, { align: \"left\" });\n  }\n\n  if (context?.subtitle) {\n    textY += textFontSize / 2;\n    const subtitle = dataArg.doc.splitTextToSize(\n      context.subtitle,\n      pageWidth * 0.65,\n    )[0];\n    dataArg.doc.text(subtitle, textX, textY, { align: \"left\" });\n  }\n};\n"]}

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

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

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

@@ -0,0 +1,50 @@
+import * as jsPDFModule from "jspdf";
+import { getLogoPositionAndDimension } from "../../utils/image-utils.js";
+export const createCoverPdf = (image, logo, title, subtitle, subtitle2) => {
+    const doc = new jsPDFModule.jsPDF("landscape");
+    const pageWidth = doc.internal.pageSize.getWidth();
+    const pageHeight = doc.internal.pageSize.getHeight();
+    const { logoWidth, logoHeight, logoX, logoY } = getLogoPositionAndDimension(doc, logo);
+    const titleFontSize = 24;
+    const subtitleFontSize = 16;
+    const subtitle2FontSize = 14;
+    let currentY = 45;
+    // background should be applied before any other element
+    if (image) {
+        try {
+            doc.addImage(image, "PNG", 0, 0, pageWidth, pageHeight);
+        }
+        catch (error) {
+            console.warn("Error adding image:", error);
+        }
+    }
+    try {
+        doc.addImage(logo, "PNG", logoX, logoY, logoWidth, logoHeight);
+    }
+    catch (error) {
+        console.warn("Error adding logo:", error);
+    }
+    // slices calculations should be made after setting font size!
+    let titleSlices = [];
+    let subtitleSlices = [];
+    let subtitle2Slices = [];
+    doc.setFont("helvetica", "bold");
+    doc.setFontSize(titleFontSize);
+    titleSlices = doc.splitTextToSize(title, pageWidth - 20);
+    doc.text(titleSlices, pageWidth / 2, currentY, { align: "center" });
+    if (subtitle) {
+        doc.setFont("helvetica", "normal");
+        doc.setFontSize(subtitleFontSize);
+        subtitleSlices = doc.splitTextToSize(subtitle, pageWidth - 20);
+        currentY += subtitleFontSize * Math.max(titleSlices.length, 1);
+        doc.text(subtitleSlices, pageWidth / 2, currentY, { align: "center" });
+    }
+    if (subtitle2) {
+        doc.setFontSize(subtitle2FontSize);
+        subtitle2Slices = doc.splitTextToSize(subtitle2, pageWidth - 20);
+        currentY += subtitle2FontSize * Math.max(subtitleSlices.length, 1);
+        doc.text(subtitle2Slices, 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":"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","sourcesContent":["import * as jsPDFModule from \"jspdf\";\nimport { getLogoPositionAndDimension } from \"../../utils/image-utils.js\";\n\nexport const createCoverPdf = (\n  image: string,\n  logo: string,\n  title: string,\n  subtitle: string,\n  subtitle2?: string,\n): ArrayBuffer => {\n  const doc = new jsPDFModule.jsPDF(\"landscape\");\n  const pageWidth = doc.internal.pageSize.getWidth();\n  const pageHeight = doc.internal.pageSize.getHeight();\n  const { logoWidth, logoHeight, logoX, logoY } = getLogoPositionAndDimension(\n    doc,\n    logo,\n  );\n  const titleFontSize = 24;\n  const subtitleFontSize = 16;\n  const subtitle2FontSize = 14;\n  let currentY = 45;\n\n  // background should be applied before any other element\n  if (image) {\n    try {\n      doc.addImage(image, \"PNG\", 0, 0, pageWidth, pageHeight);\n    } catch (error) {\n      console.warn(\"Error adding image:\", error);\n    }\n  }\n\n  try {\n    doc.addImage(logo, \"PNG\", logoX, logoY, logoWidth, logoHeight);\n  } catch (error) {\n    console.warn(\"Error adding logo:\", error);\n  }\n\n  // slices calculations should be made after setting font size!\n  let titleSlices: string[] = [];\n  let subtitleSlices: string[] = [];\n  let subtitle2Slices: string[] = [];\n\n  doc.setFont(\"helvetica\", \"bold\");\n  doc.setFontSize(titleFontSize);\n  titleSlices = doc.splitTextToSize(title, pageWidth - 20);\n  doc.text(titleSlices, pageWidth / 2, currentY, { align: \"center\" });\n\n  if (subtitle) {\n    doc.setFont(\"helvetica\", \"normal\");\n    doc.setFontSize(subtitleFontSize);\n    subtitleSlices = doc.splitTextToSize(subtitle, pageWidth - 20);\n    currentY += subtitleFontSize * Math.max(titleSlices.length, 1);\n    doc.text(subtitleSlices, pageWidth / 2, currentY, { align: \"center\" });\n  }\n\n  if (subtitle2) {\n    doc.setFontSize(subtitle2FontSize);\n    subtitle2Slices = doc.splitTextToSize(subtitle2, pageWidth - 20);\n    currentY += subtitle2FontSize * Math.max(subtitleSlices.length, 1);\n    doc.text(subtitle2Slices, 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,17 @@
+import * as jsPDFModule from "jspdf";
+import ExcelJS from "exceljs";
+import { WebupManagerData } from "../../index.js";
+import { ConverterContext } from "../../types/converter.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, context: ConverterContext) => Promise<jsPDFModule.jsPDF>;