@lichens-innovation/ts-common 1.7.0 → 1.9.0

package/dist/pdf.js

@@ -0,0 +1,264 @@
+import { jsPDF } from 'jspdf';
+import { autoTable } from 'jspdf-autotable';
+import { format } from 'date-fns';
+
+// src/utils/types.utils.ts
+var isNullish = (value) => value === null || value === void 0;
+var DEFAULT_REPORT_FILENAME = "report.pdf";
+var IMAGE_GAP = 0.5;
+var DEFAULT_THEME = {
+  primaryColor: { r: 0, g: 0, b: 0 },
+  // black
+  fontSize: {
+    title: 16,
+    header: 10,
+    normal: 9,
+    small: 8,
+    tiny: 7
+  }
+};
+var DEFAULT_FOOTER_CELL_BUILDER = ({ align, currentPage, totalPages }) => {
+  if (align === "left") return format(/* @__PURE__ */ new Date(), "yyyy-MM-dd HH:mm");
+  if (align === "center") return "";
+  return `Page ${currentPage}/${totalPages}`;
+};
+var DEFAULT_OPTIONS = {
+  orientation: "portrait",
+  paperFormat: "letter",
+  filename: DEFAULT_REPORT_FILENAME,
+  theme: DEFAULT_THEME,
+  margin: 0.5,
+  displayAvailableAreaRectangle: false,
+  hasFooter: true,
+  footerCellBuilder: DEFAULT_FOOTER_CELL_BUILDER
+};
+var Gaps = {
+  TINY: 0.02,
+  SMALL: 0.04,
+  MEDIUM: 0.08,
+  LARGE: 0.16,
+  X_LARGE: 0.32
+};
+var PdfColors = {
+  LIGHT_GRAY: [240, 240, 240]
+};
+
+// src/pdf/pdf-generator.ts
+var PdfGenerator = class {
+  doc;
+  options;
+  _currentY;
+  constructor(options = {}) {
+    this.options = {
+      ...DEFAULT_OPTIONS,
+      ...options
+    };
+    const { orientation, paperFormat } = this.options;
+    this.doc = new jsPDF({ orientation, format: paperFormat, unit: "in" });
+    this.doc.setFont("helvetica");
+    this._currentY = this.margin;
+  }
+  get font() {
+    return this.doc.getFont().fontName;
+  }
+  set font(font) {
+    this.doc.setFont(font);
+  }
+  get theme() {
+    return this.options.theme;
+  }
+  get filename() {
+    return this.options.filename;
+  }
+  get margin() {
+    return this.options.margin;
+  }
+  get pageSize() {
+    return this.doc.internal.pageSize;
+  }
+  get pageWidth() {
+    return this.pageSize.width;
+  }
+  get pageHeight() {
+    return this.pageSize.height;
+  }
+  get fullImageHeight() {
+    return this.availableHeight - this.footerHeight - IMAGE_GAP;
+  }
+  get availableWidth() {
+    return this.pageWidth - 2 * this.margin;
+  }
+  get availableHeight() {
+    return this.pageHeight - 2 * this.margin;
+  }
+  get footerFontSizePoints() {
+    return this.theme.fontSize.tiny;
+  }
+  /** Current Y position (in doc units) for layout. */
+  get currentY() {
+    return this._currentY;
+  }
+  /** Set current Y position (e.g. after custom content like header or chart). */
+  setCurrentY(y) {
+    this._currentY = y;
+  }
+  addVerticalGap(delta) {
+    this._currentY += delta;
+  }
+  checkTableOverflow(columnWidths) {
+    const computedSum = columnWidths.reduce((acc, width) => acc + width, 0);
+    if (computedSum <= this.availableWidth) return;
+    const infos = {
+      availableWidth: this.availableWidth,
+      computedSum,
+      columnWidths: JSON.stringify(columnWidths)
+    };
+    console.warn("[checkTableOverflow] table overflow", infos);
+  }
+  addTable(addTableArgs) {
+    const {
+      lineWidth = 5e-3,
+      lineColor = 0,
+      drawLineForTable = true,
+      drawLineForCells = true,
+      head,
+      body,
+      startY = this._currentY,
+      columnWidths
+    } = addTableArgs;
+    if (body.length === 0) {
+      this._currentY = startY;
+      return startY;
+    }
+    const cellPadding = 0.05;
+    const fontSize = this.theme.fontSize.small;
+    const colCount = columnWidths?.length ?? Math.max(...body.map((row) => row.length), 0);
+    const widths = columnWidths ?? Array(colCount).fill(this.availableWidth / colCount);
+    const columnStyles = {};
+    widths.forEach((cellWidth, i) => {
+      columnStyles[i] = { cellWidth, ...addTableArgs.columnStyles?.[i] };
+    });
+    const tableLineWidth = drawLineForTable ? lineWidth : 0;
+    const cellLineWidth = drawLineForCells ? lineWidth : 0;
+    autoTable(this.doc, {
+      startY,
+      head: !isNullish(head) ? [head] : void 0,
+      body,
+      theme: "grid",
+      tableLineWidth,
+      tableLineColor: lineColor,
+      margin: { left: this.margin, right: this.margin },
+      bodyStyles: { fontSize, font: this.font, cellPadding, lineWidth: cellLineWidth, lineColor },
+      headStyles: { fontSize, font: this.font, cellPadding, lineWidth: cellLineWidth, lineColor },
+      columnStyles
+    });
+    const finalY = this.doc.lastAutoTable?.finalY ?? startY;
+    this._currentY = finalY;
+  }
+  /**
+   * Add an image at the given position and size. Does not update currentY.
+   */
+  addImage({ dataUri, x, y, width, height }) {
+    const imageFormat = "PNG";
+    const imageCompression = "NONE";
+    this.doc.addImage(dataUri, imageFormat, x, y, width, height, void 0, imageCompression);
+  }
+  /** Exposes the jsPDF document for custom drawing (e.g. header text, status badge, certification). */
+  getDoc() {
+    return this.doc;
+  }
+  addPage() {
+    this.doc.addPage();
+  }
+  addFullPagePNG(dataURI, aspectRatio) {
+    const imageFormat = "PNG";
+    const imageCompression = "NONE";
+    const alias = void 0;
+    const x = this.margin;
+    const y = this.margin;
+    const { width, height } = this.calculateImageDimensions(aspectRatio);
+    this.doc.addImage(dataURI, imageFormat, x, y, width, height, alias, imageCompression);
+    this._currentY = this.margin + height + IMAGE_GAP;
+  }
+  calculateImageDimensions(aspectRatio) {
+    const width = this.availableWidth;
+    const height = width / aspectRatio;
+    const maxHeight = this.availableHeight - this.footerHeight - IMAGE_GAP;
+    const finalHeight = Math.min(height, maxHeight);
+    const finalWidth = finalHeight < height ? finalHeight * aspectRatio : width;
+    return { width: finalWidth, height: finalHeight };
+  }
+  save() {
+    this.doc.save(this.filename);
+  }
+  buildFooterColumnStyles() {
+    const cellWidth = this.availableWidth / 3;
+    return {
+      0: { cellWidth, halign: "left" },
+      1: { cellWidth, halign: "center" },
+      2: { cellWidth, halign: "right" }
+    };
+  }
+  renderFooters() {
+    if (!this.options.hasFooter) {
+      console.warn("[renderFooters] Footer is disabled");
+      return;
+    }
+    const totalPages = this.doc.getNumberOfPages();
+    const columnStyles = this.buildFooterColumnStyles();
+    const startY = this.pageHeight - this.margin - this.footerHeight;
+    const footerCellBuilder = this.options.footerCellBuilder ?? DEFAULT_FOOTER_CELL_BUILDER;
+    for (let currentPage = 1; currentPage <= totalPages; currentPage++) {
+      this.doc.setPage(currentPage);
+      this.drawAvailableAreaRectangle();
+      const footerCells = ["left", "center", "right"].map((align) => ({
+        content: footerCellBuilder({ align, currentPage, totalPages })
+      }));
+      autoTable(this.doc, {
+        startY,
+        body: [footerCells],
+        theme: "plain",
+        bodyStyles: { fontSize: this.footerFontSizePoints, font: this.font },
+        margin: { left: this.margin, right: this.margin },
+        columnStyles
+      });
+    }
+  }
+  /** Footer is a single line; height derived from font size and table padding. */
+  get footerHeight() {
+    if (!this.options.hasFooter) {
+      return 0;
+    }
+    const fontSizeInches = this.footerFontSizePoints / 72;
+    const lineHeight = fontSizeInches * 1.5;
+    return lineHeight + 0.2;
+  }
+  drawAvailableAreaRectangle() {
+    if (!this.options.displayAvailableAreaRectangle) {
+      return;
+    }
+    const currentDrawColor = this.doc.getDrawColor();
+    const currentLineWidth = this.doc.getLineWidth();
+    try {
+      this.doc.setDrawColor(200, 200, 200);
+      this.doc.setLineWidth(0.01);
+      this.doc.rect(
+        this.margin,
+        this.margin,
+        this.availableWidth,
+        this.availableHeight,
+        "S"
+        // Stroke only, no fill
+      );
+    } catch (error) {
+      console.error("[drawAvailableAreaRectangle] Error drawing available area rect", error);
+    } finally {
+      this.doc.setDrawColor(currentDrawColor);
+      this.doc.setLineWidth(currentLineWidth);
+    }
+  }
+};
+
+export { DEFAULT_FOOTER_CELL_BUILDER, DEFAULT_OPTIONS, DEFAULT_REPORT_FILENAME, DEFAULT_THEME, Gaps, IMAGE_GAP, PdfColors, PdfGenerator };
+//# sourceMappingURL=pdf.js.map
+//# sourceMappingURL=pdf.js.map

package/dist/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/types.utils.ts","../src/pdf/pdf-generator.types.ts","../src/pdf/pdf-generator.ts"],"names":[],"mappings":"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","file":"pdf.js","sourcesContent":["export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { format } from \"date-fns\";\nimport type { jsPDF, jsPDFOptions } from \"jspdf\";\n\ninterface FontSize {\n  title: number;\n  header: number;\n  normal: number;\n  small: number;\n  tiny: number;\n}\n\ninterface RgbColor {\n  r: number;\n  g: number;\n  b: number;\n}\n\nexport interface ThemeConfig {\n  primaryColor: RgbColor;\n  fontSize: FontSize;\n}\n\nexport type PageSize = jsPDF[\"internal\"][\"pageSize\"];\nexport type PageOrientation = jsPDFOptions[\"orientation\"];\nexport type PaperFormat = jsPDFOptions[\"format\"];\n\nexport const DEFAULT_REPORT_FILENAME = \"report.pdf\";\nexport const IMAGE_GAP = 0.5; // space in inches between image and footer\n\nexport const DEFAULT_THEME: ThemeConfig = {\n  primaryColor: { r: 0, g: 0, b: 0 }, // black\n  fontSize: {\n    title: 16,\n    header: 10,\n    normal: 9,\n    small: 8,\n    tiny: 7,\n  },\n};\n\nexport interface FooterCellArgs {\n  align: TableCellHalign;\n  currentPage: number;\n  totalPages: number;\n}\nexport type FooterCellBuilder = (footerCellArgs: FooterCellArgs) => string;\n\nexport interface PdfOptions {\n  orientation?: PageOrientation;\n  paperFormat?: PaperFormat;\n  hasFooter?: boolean;\n  filename?: string;\n  theme?: ThemeConfig;\n  margin?: number;\n  displayAvailableAreaRectangle?: boolean;\n  footerCellBuilder?: FooterCellBuilder;\n}\n\nexport const DEFAULT_FOOTER_CELL_BUILDER = ({ align, currentPage, totalPages }: FooterCellArgs): string => {\n  if (align === \"left\") return format(new Date(), \"yyyy-MM-dd HH:mm\");\n  if (align === \"center\") return \"\";\n  return `Page ${currentPage}/${totalPages}`;\n};\n\nexport const DEFAULT_OPTIONS: Readonly<Required<PdfOptions>> = {\n  orientation: \"portrait\",\n  paperFormat: \"letter\",\n  filename: DEFAULT_REPORT_FILENAME,\n  theme: DEFAULT_THEME,\n  margin: 0.5,\n  displayAvailableAreaRectangle: false,\n  hasFooter: true,\n  footerCellBuilder: DEFAULT_FOOTER_CELL_BUILDER,\n};\n\nexport const Gaps = {\n  TINY: 0.02,\n  SMALL: 0.04,\n  MEDIUM: 0.08,\n  LARGE: 0.16,\n  X_LARGE: 0.32,\n};\n\nexport const PdfColors: Record<string, FillColorRgbTuple> = {\n  LIGHT_GRAY: [240, 240, 240],\n};\n\nexport type TableCellHalign = \"left\" | \"center\" | \"right\";\nexport type TableCellValign = \"top\" | \"middle\" | \"bottom\";\nexport type FontStyle = \"normal\" | \"bold\";\nexport type FillColorRgbTuple = [number, number, number];\n\nexport type CellStyle = {\n  cellWidth?: number;\n  halign?: TableCellHalign;\n  valign?: TableCellValign;\n  fontStyle?: FontStyle;\n  fillColor?: FillColorRgbTuple;\n};\n\nexport type CellValue = string | number;\n\n/** Cell with rowSpan/colSpan for merged cells (passed through to autoTable). */\nexport interface TableCellDef {\n  content: string | string[] | number;\n  rowSpan?: number;\n  colSpan?: number;\n}\n\nexport type TableCellInput = CellValue | TableCellDef;\n\n/** Parameters for adding a table (generic API, no jspdf-autotable leak). */\nexport interface AddTableArgs {\n  /** Each row is an array of cell values or cell defs (with rowSpan/colSpan). */\n  body: TableCellInput[][];\n  /** Optional header row (single row of cell values). */\n  head?: CellValue[];\n  /** Y position to start the table (uses generator currentY if omitted). */\n  startY?: number;\n\n  /** Optional column widths (in same units as doc, e.g. inches). Sum should match available width. */\n  columnWidths?: number[];\n  /** Optional per-column styles (e.g. halign, fontStyle). Merged with auto-generated cellWidth. */\n  columnStyles?: Record<number, CellStyle>;\n\n  /** Whether to draw the table outer border (default true). */\n  drawLineForTable?: boolean;\n  /** Whether to draw cell borders (default true). */\n  drawLineForCells?: boolean;\n  /** Table border line width (default 0.005). */\n  lineWidth?: number;\n  /** Table border color as a grayscale value: 0 = black, 200 = light gray, 255 = white (default 0). */\n  lineColor?: number;\n}\n\nexport interface AddImageArgs {\n  dataUri: string;\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n","import { isNullish, type Dimensions } from \"../utils\";\nimport { jsPDF, type ImageCompression, type ImageFormat } from \"jspdf\";\nimport { autoTable } from \"jspdf-autotable\";\nimport {\n  DEFAULT_FOOTER_CELL_BUILDER,\n  DEFAULT_OPTIONS,\n  IMAGE_GAP,\n  type AddImageArgs,\n  type AddTableArgs,\n  type CellStyle,\n  type PageSize,\n  type PdfOptions,\n  type ThemeConfig,\n} from \"./pdf-generator.types\";\n\nexport class PdfGenerator {\n  private doc: jsPDF;\n  private options: Required<PdfOptions>;\n  private _currentY: number;\n\n  constructor(options: PdfOptions = {}) {\n    this.options = {\n      ...DEFAULT_OPTIONS,\n      ...options,\n    };\n\n    const { orientation, paperFormat } = this.options;\n    this.doc = new jsPDF({ orientation, format: paperFormat, unit: \"in\" });\n    this.doc.setFont(\"helvetica\");\n\n    this._currentY = this.margin;\n  }\n\n  get font(): string {\n    return this.doc.getFont().fontName;\n  }\n\n  set font(font: string) {\n    this.doc.setFont(font);\n  }\n\n  get theme(): ThemeConfig {\n    return this.options.theme;\n  }\n\n  get filename(): string {\n    return this.options.filename;\n  }\n\n  get margin(): number {\n    return this.options.margin;\n  }\n\n  get pageSize(): PageSize {\n    return this.doc.internal.pageSize;\n  }\n\n  get pageWidth(): number {\n    return this.pageSize.width;\n  }\n\n  get pageHeight(): number {\n    return this.pageSize.height;\n  }\n\n  get fullImageHeight(): number {\n    return this.availableHeight - this.footerHeight - IMAGE_GAP;\n  }\n\n  get availableWidth(): number {\n    return this.pageWidth - 2 * this.margin;\n  }\n\n  get availableHeight(): number {\n    return this.pageHeight - 2 * this.margin;\n  }\n\n  get footerFontSizePoints(): number {\n    return this.theme.fontSize.tiny;\n  }\n\n  /** Current Y position (in doc units) for layout. */\n  get currentY(): number {\n    return this._currentY;\n  }\n\n  /** Set current Y position (e.g. after custom content like header or chart). */\n  public setCurrentY(y: number): void {\n    this._currentY = y;\n  }\n\n  public addVerticalGap(delta: number): void {\n    this._currentY += delta;\n  }\n\n  public checkTableOverflow(columnWidths: number[]): void {\n    const computedSum = columnWidths.reduce((acc, width) => acc + width, 0);\n    if (computedSum <= this.availableWidth) return;\n\n    const infos = {\n      availableWidth: this.availableWidth,\n      computedSum,\n      columnWidths: JSON.stringify(columnWidths),\n    };\n    console.warn(\"[checkTableOverflow] table overflow\", infos);\n  }\n\n  public addTable(addTableArgs: AddTableArgs) {\n    const {\n      lineWidth = 0.005,\n      lineColor = 0,\n      drawLineForTable = true,\n      drawLineForCells = true,\n      head,\n      body,\n      startY = this._currentY,\n      columnWidths,\n    } = addTableArgs;\n\n    if (body.length === 0) {\n      this._currentY = startY;\n      return startY;\n    }\n\n    const cellPadding = 0.05;\n    const fontSize = this.theme.fontSize.small;\n    const colCount = columnWidths?.length ?? Math.max(...body.map((row) => row.length), 0);\n    const widths = columnWidths ?? Array(colCount).fill(this.availableWidth / colCount);\n    const columnStyles: Record<number, CellStyle> = {};\n    widths.forEach((cellWidth, i) => {\n      columnStyles[i] = { cellWidth, ...addTableArgs.columnStyles?.[i] };\n    });\n\n    const tableLineWidth = drawLineForTable ? lineWidth : 0;\n    const cellLineWidth = drawLineForCells ? lineWidth : 0;\n\n    autoTable(this.doc, {\n      startY,\n      head: !isNullish(head) ? [head] : undefined,\n      body,\n      theme: \"grid\",\n      tableLineWidth,\n      tableLineColor: lineColor,\n      margin: { left: this.margin, right: this.margin },\n      bodyStyles: { fontSize, font: this.font, cellPadding, lineWidth: cellLineWidth, lineColor },\n      headStyles: { fontSize, font: this.font, cellPadding, lineWidth: cellLineWidth, lineColor },\n      columnStyles,\n    });\n\n    const finalY = (this.doc as unknown as { lastAutoTable: { finalY: number } }).lastAutoTable?.finalY ?? startY;\n    this._currentY = finalY;\n  }\n\n  /**\n   * Add an image at the given position and size. Does not update currentY.\n   */\n  public addImage({ dataUri, x, y, width, height }: AddImageArgs): void {\n    const imageFormat: ImageFormat = \"PNG\";\n    const imageCompression: ImageCompression = \"NONE\";\n    this.doc.addImage(dataUri, imageFormat, x, y, width, height, undefined, imageCompression);\n  }\n\n  /** Exposes the jsPDF document for custom drawing (e.g. header text, status badge, certification). */\n  public getDoc(): jsPDF {\n    return this.doc;\n  }\n\n  public addPage() {\n    this.doc.addPage();\n  }\n\n  public addFullPagePNG(dataURI: string, aspectRatio: number): void {\n    const imageFormat: ImageFormat = \"PNG\";\n    const imageCompression: ImageCompression = \"NONE\";\n\n    const alias = undefined;\n    const x = this.margin;\n    const y = this.margin;\n    const { width, height } = this.calculateImageDimensions(aspectRatio);\n\n    this.doc.addImage(dataURI, imageFormat, x, y, width, height, alias, imageCompression);\n\n    this._currentY = this.margin + height + IMAGE_GAP;\n  }\n\n  private calculateImageDimensions(aspectRatio: number): Dimensions {\n    const width = this.availableWidth;\n\n    // Calculate height based on canvas aspect ratio to maintain proper proportions\n    const height = width / aspectRatio;\n\n    // Ensure the image doesn't exceed available space (accounting for footer)\n    const maxHeight = this.availableHeight - this.footerHeight - IMAGE_GAP;\n    const finalHeight = Math.min(height, maxHeight);\n\n    // If image is reduced, adjust width to maintain aspect ratio\n    const finalWidth = finalHeight < height ? finalHeight * aspectRatio : width;\n\n    return { width: finalWidth, height: finalHeight };\n  }\n\n  public save(): void {\n    this.doc.save(this.filename);\n  }\n\n  private buildFooterColumnStyles() {\n    const cellWidth = this.availableWidth / 3;\n\n    return {\n      0: { cellWidth, halign: \"left\" as const },\n      1: { cellWidth, halign: \"center\" as const },\n      2: { cellWidth, halign: \"right\" as const },\n    };\n  }\n\n  public renderFooters(): void {\n    if (!this.options.hasFooter) {\n      console.warn(\"[renderFooters] Footer is disabled\");\n      return;\n    }\n\n    const totalPages = this.doc.getNumberOfPages();\n    const columnStyles = this.buildFooterColumnStyles();\n    const startY = this.pageHeight - this.margin - this.footerHeight;\n\n    const footerCellBuilder = this.options.footerCellBuilder ?? DEFAULT_FOOTER_CELL_BUILDER;\n\n    for (let currentPage = 1; currentPage <= totalPages; currentPage++) {\n      this.doc.setPage(currentPage);\n      this.drawAvailableAreaRectangle();\n      const footerCells = ([\"left\", \"center\", \"right\"] as const).map((align) => ({\n        content: footerCellBuilder({ align, currentPage, totalPages }),\n      }));\n\n      autoTable(this.doc, {\n        startY,\n        body: [footerCells],\n        theme: \"plain\",\n        bodyStyles: { fontSize: this.footerFontSizePoints, font: this.font },\n        margin: { left: this.margin, right: this.margin },\n        columnStyles,\n      });\n    }\n  }\n\n  /** Footer is a single line; height derived from font size and table padding. */\n  get footerHeight(): number {\n    if (!this.options.hasFooter) {\n      return 0;\n    }\n\n    const fontSizeInches = this.footerFontSizePoints / 72; // 1 inch = 72 points\n    const lineHeight = fontSizeInches * 1.5; // autoTable line height\n    return lineHeight + 0.2; // table borders and minimal padding\n  }\n\n  private drawAvailableAreaRectangle(): void {\n    if (!this.options.displayAvailableAreaRectangle) {\n      return;\n    }\n\n    // Save current style state\n    const currentDrawColor = this.doc.getDrawColor();\n    const currentLineWidth = this.doc.getLineWidth();\n\n    try {\n      this.doc.setDrawColor(200, 200, 200); // Light gray\n      this.doc.setLineWidth(0.01);\n      this.doc.rect(\n        this.margin,\n        this.margin,\n        this.availableWidth,\n        this.availableHeight,\n        \"S\" // Stroke only, no fill\n      );\n    } catch (error) {\n      console.error(\"[drawAvailableAreaRectangle] Error drawing available area rect\", error);\n    } finally {\n      // Restore previous state\n      this.doc.setDrawColor(currentDrawColor);\n      this.doc.setLineWidth(currentLineWidth);\n    }\n  }\n}\n"]}

package/dist/web.cjs

@@ -0,0 +1,235 @@
+'use strict';
+
+// src/web/browser.utils.ts
+var getCurrentUrl = () => {
+  if (typeof window === "undefined") {
+    return "";
+  }
+  return window.location.href;
+};
+
+// src/utils/errors.utils.ts
+var getErrorMessage = (error) => {
+  if (!error) {
+    return "";
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  if (typeof error === "object" && "message" in error) {
+    return error.message;
+  }
+  return JSON.stringify(error);
+};
+
+// src/web/fetch.utils.ts
+var blobToDataUri = (blob) => {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onerror = () => reject(reader.error);
+    reader.onloadend = () => {
+      const { result } = reader;
+      resolve(typeof result === "string" ? result : null);
+    };
+    reader.readAsDataURL(blob);
+  });
+};
+var fetchUrlAsDataUri = async (url) => {
+  try {
+    const response = await fetch(url);
+    if (!response.ok) {
+      console.warn(`[fetchUrlAsDataUri] Response not ok (${response.status}). url: "${url}"`);
+      return null;
+    }
+    const blob = await response.blob();
+    return blobToDataUri(blob);
+  } catch (e) {
+    const message = getErrorMessage(e);
+    console.error(`[fetchUrlAsDataUri] "${message}". url: "${url}"`, e);
+    return null;
+  }
+};
+
+// src/web/image.utils.ts
+var hasRechartsElements = (svg) => {
+  return svg.querySelector("g.recharts-layer") !== null || svg.querySelector("g.recharts-cartesian-axis") !== null || svg.querySelector("g.recharts-cartesian-grid") !== null || svg.querySelector("path.recharts-curve") !== null;
+};
+var findRechartsSvg = (svgs) => {
+  for (const svg of Array.from(svgs)) {
+    if (hasRechartsElements(svg)) {
+      return svg;
+    }
+  }
+  return null;
+};
+var getElement = (id) => {
+  const element = document?.getElementById(id);
+  if (!element) {
+    console.info(`[getElement] Element with id "${id}" not found`);
+    return null;
+  }
+  return element;
+};
+var getRechartsSvgFromElement = ({
+  chartElement,
+  chartElementId
+}) => {
+  const allSvgs = chartElement.querySelectorAll("svg");
+  if (allSvgs.length === 0) {
+    console.info(`[getRechartsSvgFromElement] SVG element not found inside element with id "${chartElementId}"`);
+    return null;
+  }
+  const rechartSvg = findRechartsSvg(allSvgs);
+  if (!rechartSvg) {
+    console.info(`[getRechartsSvgFromElement] No Recharts SVG element found inside element with id "${chartElementId}"`);
+    return null;
+  }
+  return rechartSvg;
+};
+var getSvgDimensions = (svgElement) => {
+  const width = svgElement.clientWidth || parseInt(svgElement.getAttribute("width") || "800", 10);
+  const height = svgElement.clientHeight || parseInt(svgElement.getAttribute("height") || "600", 10);
+  return { width, height };
+};
+var prepareSvgClone = ({ svgElement, dimensions }) => {
+  const clonedSvg = svgElement.cloneNode(true);
+  if (!clonedSvg.hasAttribute("width")) {
+    clonedSvg.setAttribute("width", dimensions.width.toString());
+  }
+  if (!clonedSvg.hasAttribute("height")) {
+    clonedSvg.setAttribute("height", dimensions.height.toString());
+  }
+  return clonedSvg;
+};
+var convertSvgToDataUri = (svgXml) => {
+  const encoder = new TextEncoder();
+  const data = encoder.encode(svgXml);
+  let binaryString = "";
+  for (let i = 0; i < data.length; i++) {
+    binaryString += String.fromCharCode(data[i]);
+  }
+  const base64 = btoa(binaryString);
+  return `data:image/svg+xml;base64,${base64}`;
+};
+var resizeSvgXml = ({ svgXml, targetWidth, targetHeight }) => {
+  const widthAttr = `width="${targetWidth}"`;
+  const heightAttr = `height="${targetHeight}"`;
+  let result = svgXml.replace(/\bwidth=["'][^"']*["']/, widthAttr);
+  if (!/\bwidth\s*=/.test(result)) {
+    result = result.replace(/<svg/, `<svg ${widthAttr}`);
+  }
+  result = result.replace(/\bheight=["'][^"']*["']/, heightAttr);
+  if (!/\bheight\s*=/.test(result)) {
+    result = result.replace(/<svg/, `<svg ${heightAttr}`);
+  }
+  return result;
+};
+var getChartAsPngDataUri = async ({
+  chartElementId,
+  width,
+  height
+}) => {
+  if (!chartElementId) {
+    return null;
+  }
+  const chartElement = getElement(chartElementId);
+  if (!chartElement) {
+    return null;
+  }
+  const svgElement = getRechartsSvgFromElement({ chartElement, chartElementId });
+  if (!svgElement) {
+    return null;
+  }
+  const svgXml = new XMLSerializer().serializeToString(svgElement);
+  const resizedXml = resizeSvgXml({ svgXml, targetWidth: width, targetHeight: height });
+  const svgDataUri = convertSvgToDataUri(resizedXml);
+  return svgToPngDataUri({
+    svgDataUri,
+    dimensions: { width, height },
+    backgroundColor: "white"
+  });
+};
+var getSvgAsBase64DataUri = (chartElementId) => {
+  const svgXml = getRechartSvgXml(chartElementId);
+  if (!svgXml) {
+    return null;
+  }
+  return convertSvgToDataUri(svgXml);
+};
+var getRechartSvgXml = (chartElementId) => {
+  if (!chartElementId) {
+    console.info(`[getRechartSvgXml] No chart element id provided`);
+    return null;
+  }
+  const chartElement = getElement(chartElementId);
+  if (!chartElement) {
+    console.info(`[getRechartSvgXml] Element with id "${chartElementId}" not found`);
+    return null;
+  }
+  const svgElement = getRechartsSvgFromElement({ chartElement, chartElementId });
+  if (!svgElement) {
+    console.info(`[getRechartSvgXml] No SVG element found inside element with id "${chartElementId}"`);
+    return null;
+  }
+  const dimensions = getSvgDimensions(svgElement);
+  const clonedSvg = prepareSvgClone({ svgElement, dimensions });
+  const svgXml = new XMLSerializer().serializeToString(clonedSvg);
+  return svgXml;
+};
+var svgToPngDataUri = async ({
+  svgDataUri,
+  dimensions,
+  backgroundColor
+}) => {
+  if (!svgDataUri) {
+    return null;
+  }
+  const { width, height } = dimensions;
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    img.onload = () => {
+      try {
+        const canvas = document.createElement("canvas");
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext("2d");
+        if (!ctx) {
+          reject(new Error("Failed to get canvas 2D context"));
+          return;
+        }
+        if (backgroundColor) {
+          ctx.fillStyle = backgroundColor;
+          ctx.fillRect(0, 0, width, height);
+        }
+        ctx.drawImage(img, 0, 0, width, height);
+        const pngDataUri = canvas.toDataURL("image/png");
+        resolve(pngDataUri);
+      } catch (error) {
+        reject(error);
+      }
+    };
+    img.onerror = (error) => {
+      const message = getErrorMessage(error);
+      reject(new Error(`Failed to load SVG image: ${message}`));
+    };
+    img.src = svgDataUri;
+  });
+};
+
+exports.blobToDataUri = blobToDataUri;
+exports.convertSvgToDataUri = convertSvgToDataUri;
+exports.fetchUrlAsDataUri = fetchUrlAsDataUri;
+exports.findRechartsSvg = findRechartsSvg;
+exports.getChartAsPngDataUri = getChartAsPngDataUri;
+exports.getCurrentUrl = getCurrentUrl;
+exports.getElement = getElement;
+exports.getRechartSvgXml = getRechartSvgXml;
+exports.getRechartsSvgFromElement = getRechartsSvgFromElement;
+exports.getSvgAsBase64DataUri = getSvgAsBase64DataUri;
+exports.getSvgDimensions = getSvgDimensions;
+exports.hasRechartsElements = hasRechartsElements;
+exports.prepareSvgClone = prepareSvgClone;
+exports.resizeSvgXml = resizeSvgXml;
+exports.svgToPngDataUri = svgToPngDataUri;
+//# sourceMappingURL=web.cjs.map
+//# sourceMappingURL=web.cjs.map

package/dist/web.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/web/browser.utils.ts","../src/utils/errors.utils.ts","../src/web/fetch.utils.ts","../src/web/image.utils.ts"],"names":[],"mappings":"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","file":"web.cjs","sourcesContent":["export const getCurrentUrl = (): string => {\n  if (typeof window === \"undefined\") {\n    return \"\";\n  }\n\n  return window.location.href;\n};\n","export const getErrorMessage = (error: unknown): string => {\n  if (!error) {\n    return \"\";\n  }\n\n  if (typeof error === \"string\") {\n    return error;\n  }\n\n  if (typeof error === \"object\" && \"message\" in error) {\n    return (error as { message: string }).message;\n  }\n\n  return JSON.stringify(error);\n};\n","import { getErrorMessage } from \"../utils\";\n\n/**\n * Converts a Blob to a data URI string.\n */\nexport const blobToDataUri = (blob: Blob): Promise<string | null> => {\n  return new Promise((resolve, reject) => {\n    const reader = new FileReader();\n\n    reader.onerror = () => reject(reader.error);\n    reader.onloadend = () => {\n      const { result } = reader;\n      resolve(typeof result === \"string\" ? result : null);\n    };\n\n    reader.readAsDataURL(blob);\n  });\n};\n\n/**\n * Fetches a resource by URL and returns its content as a data URI.\n * Content type is inferred from the response Content-Type header when possible.\n */\nexport const fetchUrlAsDataUri = async (url: string): Promise<string | null> => {\n  try {\n    const response = await fetch(url);\n    if (!response.ok) {\n      console.warn(`[fetchUrlAsDataUri] Response not ok (${response.status}). url: \"${url}\"`);\n      return null;\n    }\n\n    const blob = await response.blob();\n    return blobToDataUri(blob);\n  } catch (e: unknown) {\n    const message = getErrorMessage(e);\n    console.error(`[fetchUrlAsDataUri] \"${message}\". url: \"${url}\"`, e);\n    return null;\n  }\n};\n","import { getErrorMessage, type Dimensions } from \"../utils\";\n\nexport const hasRechartsElements = (svg: SVGSVGElement): boolean => {\n  return (\n    svg.querySelector(\"g.recharts-layer\") !== null ||\n    svg.querySelector(\"g.recharts-cartesian-axis\") !== null ||\n    svg.querySelector(\"g.recharts-cartesian-grid\") !== null ||\n    svg.querySelector(\"path.recharts-curve\") !== null\n  );\n};\n\nexport const findRechartsSvg = (svgs: NodeListOf<SVGSVGElement> | SVGSVGElement[]): SVGSVGElement | null => {\n  for (const svg of Array.from(svgs)) {\n    if (hasRechartsElements(svg)) {\n      return svg;\n    }\n  }\n\n  return null;\n};\n\nexport const getElement = (id: string): HTMLElement | null => {\n  const element = document?.getElementById(id);\n  if (!element) {\n    console.info(`[getElement] Element with id \"${id}\" not found`);\n    return null;\n  }\n\n  return element;\n};\n\nexport interface GetRechartsSvgFromElementArgs {\n  chartElement: HTMLElement;\n  chartElementId: string;\n}\n\nexport const getRechartsSvgFromElement = ({\n  chartElement,\n  chartElementId,\n}: GetRechartsSvgFromElementArgs): SVGSVGElement | null => {\n  const allSvgs = chartElement.querySelectorAll<SVGSVGElement>(\"svg\");\n  if (allSvgs.length === 0) {\n    console.info(`[getRechartsSvgFromElement] SVG element not found inside element with id \"${chartElementId}\"`);\n    return null;\n  }\n\n  const rechartSvg = findRechartsSvg(allSvgs);\n  if (!rechartSvg) {\n    console.info(`[getRechartsSvgFromElement] No Recharts SVG element found inside element with id \"${chartElementId}\"`);\n    return null;\n  }\n\n  return rechartSvg;\n};\n\nexport const getSvgDimensions = (svgElement: SVGSVGElement): Dimensions => {\n  const width = svgElement.clientWidth || parseInt(svgElement.getAttribute(\"width\") || \"800\", 10);\n  const height = svgElement.clientHeight || parseInt(svgElement.getAttribute(\"height\") || \"600\", 10);\n  return { width, height };\n};\n\nexport interface PrepareSvgCloneArgs {\n  svgElement: SVGSVGElement;\n  dimensions: Dimensions;\n}\n\n/**\n * Clones an SVG element and ensures it has the required width and height attributes.\n *\n * This function is necessary for two main reasons:\n *\n * 1. **Defensive cloning**: Cloning prevents modifying the original SVG element in the DOM.\n *    Although `XMLSerializer.serializeToString()` does not modify the element, cloning ensures\n *    that no accidental modifications are made to the source element.\n *\n * 2. **Required width/height attributes**: When converting SVG → PNG via `svgToPngDataUri`,\n *    the HTML Image element requires the SVG to have explicit intrinsic dimensions.\n *    Without width/height attributes, the SVG may not render correctly on the canvas,\n *    resulting in an incorrect or empty PNG image.\n *\n * @param svgElement - The original SVG element to clone\n * @param dimensions - The dimensions to apply to the cloned SVG if attributes are missing\n * @returns A new cloned SVG element with guaranteed width/height attributes\n */\nexport const prepareSvgClone = ({ svgElement, dimensions }: PrepareSvgCloneArgs): SVGSVGElement => {\n  const clonedSvg = svgElement.cloneNode(true) as SVGSVGElement;\n\n  if (!clonedSvg.hasAttribute(\"width\")) {\n    clonedSvg.setAttribute(\"width\", dimensions.width.toString());\n  }\n  if (!clonedSvg.hasAttribute(\"height\")) {\n    clonedSvg.setAttribute(\"height\", dimensions.height.toString());\n  }\n\n  return clonedSvg;\n};\n\nexport const convertSvgToDataUri = (svgXml: string): string => {\n  const encoder = new TextEncoder();\n  const data = encoder.encode(svgXml);\n  let binaryString = \"\";\n  for (let i = 0; i < data.length; i++) {\n    binaryString += String.fromCharCode(data[i]);\n  }\n  const base64 = btoa(binaryString);\n  return `data:image/svg+xml;base64,${base64}`;\n};\n\nexport interface ResizeSvgXmlArgs {\n  svgXml: string;\n  targetWidth: number;\n  targetHeight: number;\n}\n\n/**\n * Modifies SVG XML to set the root <svg> width and height attributes.\n * Used to resize the SVG before converting to PNG at target dimensions (e.g. from PDF layout).\n */\nexport const resizeSvgXml = ({ svgXml, targetWidth, targetHeight }: ResizeSvgXmlArgs): string => {\n  const widthAttr = `width=\"${targetWidth}\"`;\n  const heightAttr = `height=\"${targetHeight}\"`;\n\n  let result = svgXml.replace(/\\bwidth=[\"'][^\"']*[\"']/, widthAttr);\n  if (!/\\bwidth\\s*=/.test(result)) {\n    result = result.replace(/<svg/, `<svg ${widthAttr}`);\n  }\n\n  result = result.replace(/\\bheight=[\"'][^\"']*[\"']/, heightAttr);\n  if (!/\\bheight\\s*=/.test(result)) {\n    result = result.replace(/<svg/, `<svg ${heightAttr}`);\n  }\n\n  return result;\n};\n\nexport interface GetChartAsPngDataUriArgs {\n  chartElementId: string;\n  width: number;\n  height: number;\n}\n\n/**\n * Gets the Recharts chart as a PNG data URI at the given dimensions (e.g. from PDF zone).\n * Resizes the SVG via resizeSvgXml before conversion; does not use the SVG's intrinsic dimensions.\n */\nexport const getChartAsPngDataUri = async ({\n  chartElementId,\n  width,\n  height,\n}: GetChartAsPngDataUriArgs): Promise<string | null> => {\n  if (!chartElementId) {\n    return null;\n  }\n\n  const chartElement: HTMLElement | null = getElement(chartElementId);\n  if (!chartElement) {\n    return null;\n  }\n\n  const svgElement: SVGSVGElement | null = getRechartsSvgFromElement({ chartElement, chartElementId });\n  if (!svgElement) {\n    return null;\n  }\n\n  const svgXml: string = new XMLSerializer().serializeToString(svgElement);\n  const resizedXml: string = resizeSvgXml({ svgXml, targetWidth: width, targetHeight: height });\n  const svgDataUri: string = convertSvgToDataUri(resizedXml);\n\n  return svgToPngDataUri({\n    svgDataUri,\n    dimensions: { width, height },\n    backgroundColor: \"white\",\n  });\n};\n\n/**\n * Retrieves the SVG from a Recharts chart element and converts it to SVG base64\n * @param chartElementId - The ID of the element containing the chart\n * @returns The SVG encoded in base64 with data URI prefix (data:image/svg+xml;base64,...), or null if an error occurs\n */\nexport const getSvgAsBase64DataUri = (chartElementId: string): string | null => {\n  const svgXml = getRechartSvgXml(chartElementId);\n  if (!svgXml) {\n    return null;\n  }\n\n  return convertSvgToDataUri(svgXml);\n};\n\nexport const getRechartSvgXml = (chartElementId: string): string | null => {\n  if (!chartElementId) {\n    console.info(`[getRechartSvgXml] No chart element id provided`);\n    return null;\n  }\n\n  const chartElement: HTMLElement | null = getElement(chartElementId);\n  if (!chartElement) {\n    console.info(`[getRechartSvgXml] Element with id \"${chartElementId}\" not found`);\n    return null;\n  }\n\n  const svgElement: SVGSVGElement | null = getRechartsSvgFromElement({ chartElement, chartElementId });\n  if (!svgElement) {\n    console.info(`[getRechartSvgXml] No SVG element found inside element with id \"${chartElementId}\"`);\n    return null;\n  }\n\n  const dimensions = getSvgDimensions(svgElement);\n  const clonedSvg: SVGSVGElement = prepareSvgClone({ svgElement, dimensions });\n  const svgXml: string = new XMLSerializer().serializeToString(clonedSvg);\n\n  return svgXml;\n};\n\nexport interface SvgToPngArgs {\n  svgDataUri?: string | null;\n  dimensions: Dimensions;\n  backgroundColor?: string;\n}\n\nexport const svgToPngDataUri = async ({\n  svgDataUri,\n  dimensions,\n  backgroundColor,\n}: SvgToPngArgs): Promise<string | null> => {\n  if (!svgDataUri) {\n    return null;\n  }\n\n  const { width, height } = dimensions;\n\n  return new Promise((resolve, reject) => {\n    const img = new Image();\n\n    img.onload = () => {\n      try {\n        const canvas = document.createElement(\"canvas\");\n        canvas.width = width;\n        canvas.height = height;\n\n        const ctx = canvas.getContext(\"2d\");\n        if (!ctx) {\n          reject(new Error(\"Failed to get canvas 2D context\"));\n          return;\n        }\n\n        if (backgroundColor) {\n          ctx.fillStyle = backgroundColor;\n          ctx.fillRect(0, 0, width, height);\n        }\n\n        ctx.drawImage(img, 0, 0, width, height);\n        const pngDataUri = canvas.toDataURL(\"image/png\");\n        resolve(pngDataUri);\n      } catch (error) {\n        reject(error);\n      }\n    };\n\n    img.onerror = (error) => {\n      const message = getErrorMessage(error);\n      reject(new Error(`Failed to load SVG image: ${message}`));\n    };\n\n    img.src = svgDataUri;\n  });\n};\n"]}

package/dist/web.d.cts

@@ -0,0 +1,82 @@
+import { D as Dimensions } from './dimensions.utils-BwIBA5op.cjs';
+
+declare const getCurrentUrl: () => string;
+
+/**
+ * Converts a Blob to a data URI string.
+ */
+declare const blobToDataUri: (blob: Blob) => Promise<string | null>;
+/**
+ * Fetches a resource by URL and returns its content as a data URI.
+ * Content type is inferred from the response Content-Type header when possible.
+ */
+declare const fetchUrlAsDataUri: (url: string) => Promise<string | null>;
+
+declare const hasRechartsElements: (svg: SVGSVGElement) => boolean;
+declare const findRechartsSvg: (svgs: NodeListOf<SVGSVGElement> | SVGSVGElement[]) => SVGSVGElement | null;
+declare const getElement: (id: string) => HTMLElement | null;
+interface GetRechartsSvgFromElementArgs {
+    chartElement: HTMLElement;
+    chartElementId: string;
+}
+declare const getRechartsSvgFromElement: ({ chartElement, chartElementId, }: GetRechartsSvgFromElementArgs) => SVGSVGElement | null;
+declare const getSvgDimensions: (svgElement: SVGSVGElement) => Dimensions;
+interface PrepareSvgCloneArgs {
+    svgElement: SVGSVGElement;
+    dimensions: Dimensions;
+}
+/**
+ * Clones an SVG element and ensures it has the required width and height attributes.
+ *
+ * This function is necessary for two main reasons:
+ *
+ * 1. **Defensive cloning**: Cloning prevents modifying the original SVG element in the DOM.
+ *    Although `XMLSerializer.serializeToString()` does not modify the element, cloning ensures
+ *    that no accidental modifications are made to the source element.
+ *
+ * 2. **Required width/height attributes**: When converting SVG → PNG via `svgToPngDataUri`,
+ *    the HTML Image element requires the SVG to have explicit intrinsic dimensions.
+ *    Without width/height attributes, the SVG may not render correctly on the canvas,
+ *    resulting in an incorrect or empty PNG image.
+ *
+ * @param svgElement - The original SVG element to clone
+ * @param dimensions - The dimensions to apply to the cloned SVG if attributes are missing
+ * @returns A new cloned SVG element with guaranteed width/height attributes
+ */
+declare const prepareSvgClone: ({ svgElement, dimensions }: PrepareSvgCloneArgs) => SVGSVGElement;
+declare const convertSvgToDataUri: (svgXml: string) => string;
+interface ResizeSvgXmlArgs {
+    svgXml: string;
+    targetWidth: number;
+    targetHeight: number;
+}
+/**
+ * Modifies SVG XML to set the root <svg> width and height attributes.
+ * Used to resize the SVG before converting to PNG at target dimensions (e.g. from PDF layout).
+ */
+declare const resizeSvgXml: ({ svgXml, targetWidth, targetHeight }: ResizeSvgXmlArgs) => string;
+interface GetChartAsPngDataUriArgs {
+    chartElementId: string;
+    width: number;
+    height: number;
+}
+/**
+ * Gets the Recharts chart as a PNG data URI at the given dimensions (e.g. from PDF zone).
+ * Resizes the SVG via resizeSvgXml before conversion; does not use the SVG's intrinsic dimensions.
+ */
+declare const getChartAsPngDataUri: ({ chartElementId, width, height, }: GetChartAsPngDataUriArgs) => Promise<string | null>;
+/**
+ * Retrieves the SVG from a Recharts chart element and converts it to SVG base64
+ * @param chartElementId - The ID of the element containing the chart
+ * @returns The SVG encoded in base64 with data URI prefix (data:image/svg+xml;base64,...), or null if an error occurs
+ */
+declare const getSvgAsBase64DataUri: (chartElementId: string) => string | null;
+declare const getRechartSvgXml: (chartElementId: string) => string | null;
+interface SvgToPngArgs {
+    svgDataUri?: string | null;
+    dimensions: Dimensions;
+    backgroundColor?: string;
+}
+declare const svgToPngDataUri: ({ svgDataUri, dimensions, backgroundColor, }: SvgToPngArgs) => Promise<string | null>;
+
+export { type GetChartAsPngDataUriArgs, type GetRechartsSvgFromElementArgs, type PrepareSvgCloneArgs, type ResizeSvgXmlArgs, type SvgToPngArgs, blobToDataUri, convertSvgToDataUri, fetchUrlAsDataUri, findRechartsSvg, getChartAsPngDataUri, getCurrentUrl, getElement, getRechartSvgXml, getRechartsSvgFromElement, getSvgAsBase64DataUri, getSvgDimensions, hasRechartsElements, prepareSvgClone, resizeSvgXml, svgToPngDataUri };