@harbortouch/skytab-analytics-report-utils 0.16.0 → 0.17.0

package/README.md

@@ -41,6 +41,76 @@ import {
 } from '@harbortouch/skytab-analytics-report-utils';
 ```
 
+### Exporting report data to PDF
+
+Import from the `/pdf` sub-path. This keeps `pdfkit` out of frontend bundles — it is only included when this import is actually used.
+
+```typescript
+import { PdfExporter } from '@harbortouch/skytab-analytics-report-utils/pdf';
+
+const exporter = new PdfExporter();
+
+const buffer = await exporter.generate({
+	pages: [
+		{
+			filters: [
+				{ label: 'Date Range', value: 'Jan 1 – Jan 31' },
+				{ label: 'Location', value: 'Downtown' },
+			],
+			table: {
+				columns: [
+					{ header: 'Item', key: 'name' },
+					{ header: 'Net Sales', key: 'netSales' },
+					{ header: 'Qty', key: 'qty' },
+				],
+				rows: reportRows,
+			},
+		},
+	],
+});
+
+// buffer is a Node.js Buffer containing the PDF binary
+fs.writeFileSync('report.pdf', buffer);
+```
+
+`PdfExporter.generate()` returns a `Promise<Buffer>`. Each entry in `pages` produces one PDF page (additional pages are added automatically when table rows overflow).
+
+**`PdfPage`**
+
+| Field     | Type          | Description                                    |
+| --------- | ------------- | ---------------------------------------------- |
+| `filters` | `PdfFilter[]` | Optional applied-filters block above the table |
+| `table`   | `PdfTable`    | Optional table to render on the page           |
+
+**`PdfTable`**
+
+| Field     | Type                        | Description                              |
+| --------- | --------------------------- | ---------------------------------------- |
+| `columns` | `PdfTableColumn[]`          | Column definitions (order preserved)     |
+| `rows`    | `Record<string, unknown>[]` | Row data — keyed by `PdfTableColumn.key` |
+
+**`PdfTableColumn`**
+
+| Field    | Type     | Description                                             |
+| -------- | -------- | ------------------------------------------------------- |
+| `header` | `string` | Column header label                                     |
+| `key`    | `string` | Field name used to look up the value in each row object |
+| `width`  | `number` | Optional hint — auto-sized from content if omitted      |
+
+**Behaviour notes**
+
+- Output is A4 landscape with 30 pt margins.
+- Column widths are auto-calculated from header and cell content; columns are scaled down proportionally if they exceed the usable page width.
+- Font size scales with column count (7–11 pt) so wide tables remain readable.
+- Numeric cell values are right-aligned; text values are left-aligned.
+- Alternating rows use a light grey background (`#F5F5F5`); the header row uses `#D3D3D3`.
+- Emojis are stripped from all text automatically (pdfkit's built-in fonts do not support them).
+- When a table spans multiple pages the header row is repeated at the top of each new page.
+
+> **Note:** `pdfkit` is a dependency of this library — consuming projects do not need to install it separately.
+
+---
+
 ### Exporting report data to CSV
 
 Import from the `/csv` sub-path. This keeps `csv-stringify` out of frontend bundles — it is only included when this import is actually used.
@@ -93,6 +163,9 @@ src/
 │   └── index.ts            — ReportColumnKey union type + COLUMN_REGISTRY (i18n keys)
 ├── csv/
 │   └── index.ts            — CsvExporter — published as the ./csv sub-path export
+├── pdf/
+│   ├── index.ts            — PdfExporter — published as the ./pdf sub-path export
+│   └── pdf.utils.ts        — stripEmojis() helper
 ├── reports/
 │   ├── salesSummary.ts
 │   ├── ticketSummary.ts

package/dist/pdf/index.cjs

@@ -0,0 +1,235 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/pdf/index.ts
+var pdf_exports = {};
+__export(pdf_exports, {
+  PdfExporter: () => PdfExporter
+});
+module.exports = __toCommonJS(pdf_exports);
+var import_pdfkit = __toESM(require("pdfkit"), 1);
+
+// src/pdf/pdf.utils.ts
+var stripEmojis = (text) => {
+  if (!text) {
+    return text;
+  }
+  return text.replace(
+    /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{26FF}]|[\u{2700}-\u{27BF}]|[\u{1F1E0}-\u{1F1FF}]|[\u{1F600}-\u{1F64F}]|[\u{1F680}-\u{1F6FF}]|[\u{1F900}-\u{1F9FF}]|[\u{1FA00}-\u{1FA6F}]|[\u{1FA70}-\u{1FAFF}]|[\u{FE00}-\u{FE0F}]|[\u{1F004}]|[\u{1F0CF}]|[\u{1F18E}]|[\u{1F191}-\u{1F19A}]|[\u{1F1E6}-\u{1F1FF}]|[\u{1F201}-\u{1F251}]/gu,
+    ""
+  ).replace(/\s+/g, " ").trim();
+};
+
+// src/pdf/index.ts
+var FONT_BOLD = "Helvetica-Bold";
+var FONT_REGULAR = "Helvetica";
+var COLOR_BLACK = "#000000";
+var COLOR_HEADER_BACKGROUND = "#D3D3D3";
+var COLOR_ROW_BACKGROUND_ALTERNATE = "#F5F5F5";
+var PdfExporter = class {
+  generate(content) {
+    const doc = new import_pdfkit.default({ margin: 30, size: "A4", layout: "landscape" });
+    const buffers = [];
+    return new Promise((resolve, reject) => {
+      doc.on("data", (chunk) => buffers.push(chunk));
+      doc.on("end", () => resolve(Buffer.concat(buffers)));
+      doc.on("error", reject);
+      try {
+        content.pages.forEach((section, index) => {
+          const sanitizedSections = this.sanitizeSections(section);
+          if (index > 0) {
+            doc.addPage();
+          }
+          let currentY = doc.y;
+          if (sanitizedSections.filters && sanitizedSections.filters.length > 0) {
+            currentY = this.drawFilters(doc, sanitizedSections.filters);
+          }
+          if (sanitizedSections.table) {
+            this.drawTable(doc, sanitizedSections.table, currentY);
+          }
+        });
+        doc.end();
+      } catch (err) {
+        reject(err instanceof Error ? err : new Error(String(err)));
+      }
+    });
+  }
+  sanitizeSections(sections) {
+    const sanitized = {};
+    if (sections.filters) {
+      sanitized.filters = sections.filters.map((filter) => ({
+        label: stripEmojis(filter.label),
+        value: stripEmojis(filter.value)
+      }));
+    }
+    if (sections.table) {
+      sanitized.table = {
+        columns: sections.table.columns.map((col) => ({
+          ...col,
+          header: stripEmojis(col.header)
+        })),
+        rows: sections.table.rows.map((row) => {
+          const sanitizedRow = {};
+          for (const [key, value] of Object.entries(row)) {
+            sanitizedRow[key] = typeof value === "string" ? stripEmojis(value) : value;
+          }
+          return sanitizedRow;
+        })
+      };
+    }
+    return sanitized;
+  }
+  drawFilters(doc, filters) {
+    doc.fillColor(COLOR_BLACK).font(FONT_BOLD).fontSize(11).text("Applied Filters", { align: "left" });
+    doc.moveDown(0.5);
+    filters.forEach((filter) => {
+      doc.font(FONT_BOLD).fontSize(11).text(filter.label, { continued: true });
+      doc.font(FONT_REGULAR).text(`: ${filter.value}`);
+    });
+    doc.moveDown(1);
+    return doc.y;
+  }
+  drawTable(doc, table, startY = doc.y) {
+    const columns = table.columns.length > 0 ? table.columns.map((c) => ({ ...c })) : [{ header: "No data", key: "no_data", width: 100 }];
+    const rows = table.rows ?? [];
+    const baseCellPadding = 4;
+    const minColumnWidth = 35;
+    const columnCount = columns.length;
+    const headerFontSize = columnCount > 13 ? 8 : columnCount > 10 ? 9 : columnCount > 7 ? 10 : 11;
+    const dataFontSize = columnCount > 13 ? 7 : columnCount > 10 ? 8 : columnCount > 7 ? 9 : 10;
+    columns.forEach((col) => {
+      doc.font(FONT_BOLD).fontSize(headerFontSize);
+      let maxWidth = doc.widthOfString(col.header);
+      doc.font(FONT_REGULAR).fontSize(dataFontSize);
+      rows.forEach((row) => {
+        const rv = row[col.key];
+        const cellValue = typeof rv === "string" || typeof rv === "number" || typeof rv === "boolean" ? String(rv) : "";
+        const textWidth = doc.widthOfString(cellValue);
+        if (textWidth > maxWidth) {
+          maxWidth = textWidth;
+        }
+      });
+      col.width = Math.max(maxWidth + baseCellPadding * 2, minColumnWidth);
+    });
+    const usableWidth = doc.page.width - doc.page.margins.left - doc.page.margins.right;
+    const totalColumnWidth = columns.reduce((sum, c) => sum + (c.width ?? minColumnWidth), 0);
+    if (totalColumnWidth > usableWidth) {
+      const scale = usableWidth / totalColumnWidth;
+      columns.forEach((c) => {
+        c.width = Math.max(Math.floor((c.width ?? minColumnWidth) * scale), minColumnWidth);
+      });
+    }
+    const tableWidth = columns.reduce((sum, c) => sum + (c.width ?? minColumnWidth), 0);
+    const pageBottom = doc.page.height - doc.page.margins.bottom;
+    const calculateRowHeight = (row, isHeader = false) => {
+      const fontSize = isHeader ? headerFontSize : dataFontSize;
+      doc.font(isHeader ? FONT_BOLD : FONT_REGULAR).fontSize(fontSize);
+      let maxLines = 1;
+      columns.forEach((col) => {
+        const cellValue = isHeader ? col.header : row?.[col.key] !== void 0 ? String(row[col.key]) : "";
+        const textWidth = doc.widthOfString(cellValue);
+        const availableWidth = (col.width ?? minColumnWidth) - baseCellPadding * 2;
+        const lines = Math.ceil(textWidth / availableWidth);
+        if (lines > maxLines) {
+          maxLines = lines;
+        }
+      });
+      return Math.max(maxLines * (fontSize + 2) + baseCellPadding * 2, 25);
+    };
+    const headerHeight = calculateRowHeight(null, true);
+    const drawTableHeader = (y) => this.drawHeader(doc, columns, y, tableWidth, headerHeight, baseCellPadding, headerFontSize, minColumnWidth);
+    let currentY = drawTableHeader(startY);
+    doc.font(FONT_REGULAR).fontSize(dataFontSize);
+    rows.forEach((row, rowIndex) => {
+      const currentRowHeight = calculateRowHeight(row, false);
+      if (currentY + currentRowHeight > pageBottom) {
+        doc.addPage();
+        currentY = drawTableHeader(doc.page.margins.top);
+        doc.font(FONT_REGULAR).fontSize(dataFontSize);
+      }
+      currentY = this.drawRow(
+        doc,
+        row,
+        rowIndex,
+        columns,
+        currentY,
+        tableWidth,
+        currentRowHeight,
+        baseCellPadding,
+        dataFontSize,
+        minColumnWidth
+      );
+    });
+  }
+  drawHeader(doc, columns, startY, tableWidth, headerHeight, cellPadding, headerFontSize, minColumnWidth) {
+    doc.strokeColor(COLOR_BLACK).lineWidth(0.5).moveTo(doc.page.margins.left, startY).lineTo(doc.page.margins.left + tableWidth, startY).stroke();
+    doc.fillColor(COLOR_HEADER_BACKGROUND).rect(doc.page.margins.left, startY, tableWidth, headerHeight).fill();
+    let xPosition = doc.page.margins.left;
+    doc.fillColor(COLOR_BLACK).font(FONT_BOLD).fontSize(headerFontSize);
+    columns.forEach((col) => {
+      doc.strokeColor(COLOR_BLACK).lineWidth(0.5).moveTo(xPosition, startY).lineTo(xPosition, startY + headerHeight).stroke();
+      doc.text(col.header, xPosition + cellPadding, startY + cellPadding, {
+        width: (col.width ?? minColumnWidth) - cellPadding * 2,
+        align: "left",
+        lineBreak: false
+      });
+      xPosition += col.width ?? minColumnWidth;
+    });
+    doc.moveTo(xPosition, startY).lineTo(xPosition, startY + headerHeight).stroke();
+    doc.moveTo(doc.page.margins.left, startY + headerHeight).lineTo(xPosition, startY + headerHeight).stroke();
+    return startY + headerHeight;
+  }
+  drawRow(doc, row, rowIndex, columns, currentY, tableWidth, rowHeight, cellPadding, dataFontSize, minColumnWidth) {
+    doc.font(FONT_REGULAR).fontSize(dataFontSize);
+    if (rowIndex % 2 === 0) {
+      doc.fillColor(COLOR_ROW_BACKGROUND_ALTERNATE).rect(doc.page.margins.left, currentY, tableWidth, rowHeight).fill();
+    }
+    let xPosition = doc.page.margins.left;
+    doc.fillColor(COLOR_BLACK);
+    columns.forEach((col) => {
+      doc.strokeColor(COLOR_BLACK).lineWidth(0.5).moveTo(xPosition, currentY).lineTo(xPosition, currentY + rowHeight).stroke();
+      const rawValue = row[col.key];
+      const cellValue = typeof rawValue === "string" || typeof rawValue === "number" || typeof rawValue === "boolean" ? String(rawValue) : "";
+      const isNumeric = typeof rawValue === "number" || typeof rawValue === "string" && rawValue !== "" && !isNaN(Number(rawValue));
+      doc.text(cellValue, xPosition + cellPadding, currentY + cellPadding, {
+        width: (col.width ?? minColumnWidth) - cellPadding * 2,
+        align: isNumeric ? "right" : "left",
+        lineBreak: false
+      });
+      xPosition += col.width ?? minColumnWidth;
+    });
+    doc.moveTo(xPosition, currentY).lineTo(xPosition, currentY + rowHeight).stroke();
+    doc.moveTo(doc.page.margins.left, currentY + rowHeight).lineTo(xPosition, currentY + rowHeight).stroke();
+    return currentY + rowHeight;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PdfExporter
+});

package/dist/pdf/index.d.cts

@@ -0,0 +1,29 @@
+interface PdfTableColumn {
+    header: string;
+    key: string;
+    width?: number;
+}
+interface PdfTable {
+    columns: PdfTableColumn[];
+    rows: Record<string, unknown>[];
+}
+interface PdfFilter {
+    label: string;
+    value: string;
+}
+interface PdfPage {
+    table?: PdfTable;
+    filters?: PdfFilter[];
+}
+declare class PdfExporter {
+    generate(content: {
+        pages: PdfPage[];
+    }): Promise<Buffer>;
+    private sanitizeSections;
+    drawFilters(doc: PDFKit.PDFDocument, filters: PdfFilter[]): number;
+    drawTable(doc: PDFKit.PDFDocument, table: PdfTable, startY?: number): void;
+    drawHeader(doc: PDFKit.PDFDocument, columns: PdfTableColumn[], startY: number, tableWidth: number, headerHeight: number, cellPadding: number, headerFontSize: number, minColumnWidth: number): number;
+    drawRow(doc: PDFKit.PDFDocument, row: Record<string, unknown>, rowIndex: number, columns: PdfTableColumn[], currentY: number, tableWidth: number, rowHeight: number, cellPadding: number, dataFontSize: number, minColumnWidth: number): number;
+}
+
+export { PdfExporter, type PdfFilter, type PdfPage, type PdfTable, type PdfTableColumn };

package/dist/pdf/index.d.ts

@@ -0,0 +1,29 @@
+interface PdfTableColumn {
+    header: string;
+    key: string;
+    width?: number;
+}
+interface PdfTable {
+    columns: PdfTableColumn[];
+    rows: Record<string, unknown>[];
+}
+interface PdfFilter {
+    label: string;
+    value: string;
+}
+interface PdfPage {
+    table?: PdfTable;
+    filters?: PdfFilter[];
+}
+declare class PdfExporter {
+    generate(content: {
+        pages: PdfPage[];
+    }): Promise<Buffer>;
+    private sanitizeSections;
+    drawFilters(doc: PDFKit.PDFDocument, filters: PdfFilter[]): number;
+    drawTable(doc: PDFKit.PDFDocument, table: PdfTable, startY?: number): void;
+    drawHeader(doc: PDFKit.PDFDocument, columns: PdfTableColumn[], startY: number, tableWidth: number, headerHeight: number, cellPadding: number, headerFontSize: number, minColumnWidth: number): number;
+    drawRow(doc: PDFKit.PDFDocument, row: Record<string, unknown>, rowIndex: number, columns: PdfTableColumn[], currentY: number, tableWidth: number, rowHeight: number, cellPadding: number, dataFontSize: number, minColumnWidth: number): number;
+}
+
+export { PdfExporter, type PdfFilter, type PdfPage, type PdfTable, type PdfTableColumn };

package/dist/pdf/index.js

@@ -0,0 +1,200 @@
+// src/pdf/index.ts
+import PDFDocument from "pdfkit";
+
+// src/pdf/pdf.utils.ts
+var stripEmojis = (text) => {
+  if (!text) {
+    return text;
+  }
+  return text.replace(
+    /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{26FF}]|[\u{2700}-\u{27BF}]|[\u{1F1E0}-\u{1F1FF}]|[\u{1F600}-\u{1F64F}]|[\u{1F680}-\u{1F6FF}]|[\u{1F900}-\u{1F9FF}]|[\u{1FA00}-\u{1FA6F}]|[\u{1FA70}-\u{1FAFF}]|[\u{FE00}-\u{FE0F}]|[\u{1F004}]|[\u{1F0CF}]|[\u{1F18E}]|[\u{1F191}-\u{1F19A}]|[\u{1F1E6}-\u{1F1FF}]|[\u{1F201}-\u{1F251}]/gu,
+    ""
+  ).replace(/\s+/g, " ").trim();
+};
+
+// src/pdf/index.ts
+var FONT_BOLD = "Helvetica-Bold";
+var FONT_REGULAR = "Helvetica";
+var COLOR_BLACK = "#000000";
+var COLOR_HEADER_BACKGROUND = "#D3D3D3";
+var COLOR_ROW_BACKGROUND_ALTERNATE = "#F5F5F5";
+var PdfExporter = class {
+  generate(content) {
+    const doc = new PDFDocument({ margin: 30, size: "A4", layout: "landscape" });
+    const buffers = [];
+    return new Promise((resolve, reject) => {
+      doc.on("data", (chunk) => buffers.push(chunk));
+      doc.on("end", () => resolve(Buffer.concat(buffers)));
+      doc.on("error", reject);
+      try {
+        content.pages.forEach((section, index) => {
+          const sanitizedSections = this.sanitizeSections(section);
+          if (index > 0) {
+            doc.addPage();
+          }
+          let currentY = doc.y;
+          if (sanitizedSections.filters && sanitizedSections.filters.length > 0) {
+            currentY = this.drawFilters(doc, sanitizedSections.filters);
+          }
+          if (sanitizedSections.table) {
+            this.drawTable(doc, sanitizedSections.table, currentY);
+          }
+        });
+        doc.end();
+      } catch (err) {
+        reject(err instanceof Error ? err : new Error(String(err)));
+      }
+    });
+  }
+  sanitizeSections(sections) {
+    const sanitized = {};
+    if (sections.filters) {
+      sanitized.filters = sections.filters.map((filter) => ({
+        label: stripEmojis(filter.label),
+        value: stripEmojis(filter.value)
+      }));
+    }
+    if (sections.table) {
+      sanitized.table = {
+        columns: sections.table.columns.map((col) => ({
+          ...col,
+          header: stripEmojis(col.header)
+        })),
+        rows: sections.table.rows.map((row) => {
+          const sanitizedRow = {};
+          for (const [key, value] of Object.entries(row)) {
+            sanitizedRow[key] = typeof value === "string" ? stripEmojis(value) : value;
+          }
+          return sanitizedRow;
+        })
+      };
+    }
+    return sanitized;
+  }
+  drawFilters(doc, filters) {
+    doc.fillColor(COLOR_BLACK).font(FONT_BOLD).fontSize(11).text("Applied Filters", { align: "left" });
+    doc.moveDown(0.5);
+    filters.forEach((filter) => {
+      doc.font(FONT_BOLD).fontSize(11).text(filter.label, { continued: true });
+      doc.font(FONT_REGULAR).text(`: ${filter.value}`);
+    });
+    doc.moveDown(1);
+    return doc.y;
+  }
+  drawTable(doc, table, startY = doc.y) {
+    const columns = table.columns.length > 0 ? table.columns.map((c) => ({ ...c })) : [{ header: "No data", key: "no_data", width: 100 }];
+    const rows = table.rows ?? [];
+    const baseCellPadding = 4;
+    const minColumnWidth = 35;
+    const columnCount = columns.length;
+    const headerFontSize = columnCount > 13 ? 8 : columnCount > 10 ? 9 : columnCount > 7 ? 10 : 11;
+    const dataFontSize = columnCount > 13 ? 7 : columnCount > 10 ? 8 : columnCount > 7 ? 9 : 10;
+    columns.forEach((col) => {
+      doc.font(FONT_BOLD).fontSize(headerFontSize);
+      let maxWidth = doc.widthOfString(col.header);
+      doc.font(FONT_REGULAR).fontSize(dataFontSize);
+      rows.forEach((row) => {
+        const rv = row[col.key];
+        const cellValue = typeof rv === "string" || typeof rv === "number" || typeof rv === "boolean" ? String(rv) : "";
+        const textWidth = doc.widthOfString(cellValue);
+        if (textWidth > maxWidth) {
+          maxWidth = textWidth;
+        }
+      });
+      col.width = Math.max(maxWidth + baseCellPadding * 2, minColumnWidth);
+    });
+    const usableWidth = doc.page.width - doc.page.margins.left - doc.page.margins.right;
+    const totalColumnWidth = columns.reduce((sum, c) => sum + (c.width ?? minColumnWidth), 0);
+    if (totalColumnWidth > usableWidth) {
+      const scale = usableWidth / totalColumnWidth;
+      columns.forEach((c) => {
+        c.width = Math.max(Math.floor((c.width ?? minColumnWidth) * scale), minColumnWidth);
+      });
+    }
+    const tableWidth = columns.reduce((sum, c) => sum + (c.width ?? minColumnWidth), 0);
+    const pageBottom = doc.page.height - doc.page.margins.bottom;
+    const calculateRowHeight = (row, isHeader = false) => {
+      const fontSize = isHeader ? headerFontSize : dataFontSize;
+      doc.font(isHeader ? FONT_BOLD : FONT_REGULAR).fontSize(fontSize);
+      let maxLines = 1;
+      columns.forEach((col) => {
+        const cellValue = isHeader ? col.header : row?.[col.key] !== void 0 ? String(row[col.key]) : "";
+        const textWidth = doc.widthOfString(cellValue);
+        const availableWidth = (col.width ?? minColumnWidth) - baseCellPadding * 2;
+        const lines = Math.ceil(textWidth / availableWidth);
+        if (lines > maxLines) {
+          maxLines = lines;
+        }
+      });
+      return Math.max(maxLines * (fontSize + 2) + baseCellPadding * 2, 25);
+    };
+    const headerHeight = calculateRowHeight(null, true);
+    const drawTableHeader = (y) => this.drawHeader(doc, columns, y, tableWidth, headerHeight, baseCellPadding, headerFontSize, minColumnWidth);
+    let currentY = drawTableHeader(startY);
+    doc.font(FONT_REGULAR).fontSize(dataFontSize);
+    rows.forEach((row, rowIndex) => {
+      const currentRowHeight = calculateRowHeight(row, false);
+      if (currentY + currentRowHeight > pageBottom) {
+        doc.addPage();
+        currentY = drawTableHeader(doc.page.margins.top);
+        doc.font(FONT_REGULAR).fontSize(dataFontSize);
+      }
+      currentY = this.drawRow(
+        doc,
+        row,
+        rowIndex,
+        columns,
+        currentY,
+        tableWidth,
+        currentRowHeight,
+        baseCellPadding,
+        dataFontSize,
+        minColumnWidth
+      );
+    });
+  }
+  drawHeader(doc, columns, startY, tableWidth, headerHeight, cellPadding, headerFontSize, minColumnWidth) {
+    doc.strokeColor(COLOR_BLACK).lineWidth(0.5).moveTo(doc.page.margins.left, startY).lineTo(doc.page.margins.left + tableWidth, startY).stroke();
+    doc.fillColor(COLOR_HEADER_BACKGROUND).rect(doc.page.margins.left, startY, tableWidth, headerHeight).fill();
+    let xPosition = doc.page.margins.left;
+    doc.fillColor(COLOR_BLACK).font(FONT_BOLD).fontSize(headerFontSize);
+    columns.forEach((col) => {
+      doc.strokeColor(COLOR_BLACK).lineWidth(0.5).moveTo(xPosition, startY).lineTo(xPosition, startY + headerHeight).stroke();
+      doc.text(col.header, xPosition + cellPadding, startY + cellPadding, {
+        width: (col.width ?? minColumnWidth) - cellPadding * 2,
+        align: "left",
+        lineBreak: false
+      });
+      xPosition += col.width ?? minColumnWidth;
+    });
+    doc.moveTo(xPosition, startY).lineTo(xPosition, startY + headerHeight).stroke();
+    doc.moveTo(doc.page.margins.left, startY + headerHeight).lineTo(xPosition, startY + headerHeight).stroke();
+    return startY + headerHeight;
+  }
+  drawRow(doc, row, rowIndex, columns, currentY, tableWidth, rowHeight, cellPadding, dataFontSize, minColumnWidth) {
+    doc.font(FONT_REGULAR).fontSize(dataFontSize);
+    if (rowIndex % 2 === 0) {
+      doc.fillColor(COLOR_ROW_BACKGROUND_ALTERNATE).rect(doc.page.margins.left, currentY, tableWidth, rowHeight).fill();
+    }
+    let xPosition = doc.page.margins.left;
+    doc.fillColor(COLOR_BLACK);
+    columns.forEach((col) => {
+      doc.strokeColor(COLOR_BLACK).lineWidth(0.5).moveTo(xPosition, currentY).lineTo(xPosition, currentY + rowHeight).stroke();
+      const rawValue = row[col.key];
+      const cellValue = typeof rawValue === "string" || typeof rawValue === "number" || typeof rawValue === "boolean" ? String(rawValue) : "";
+      const isNumeric = typeof rawValue === "number" || typeof rawValue === "string" && rawValue !== "" && !isNaN(Number(rawValue));
+      doc.text(cellValue, xPosition + cellPadding, currentY + cellPadding, {
+        width: (col.width ?? minColumnWidth) - cellPadding * 2,
+        align: isNumeric ? "right" : "left",
+        lineBreak: false
+      });
+      xPosition += col.width ?? minColumnWidth;
+    });
+    doc.moveTo(xPosition, currentY).lineTo(xPosition, currentY + rowHeight).stroke();
+    doc.moveTo(doc.page.margins.left, currentY + rowHeight).lineTo(xPosition, currentY + rowHeight).stroke();
+    return currentY + rowHeight;
+  }
+};
+export {
+  PdfExporter
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@harbortouch/skytab-analytics-report-utils",
-	"version": "0.16.0",
+	"version": "0.17.0",
 	"description": "Centralized report column presentation configuration for SkyTab Analytics",
 	"engines": {
 		"node": ">=22.6.0",
@@ -19,6 +19,11 @@
 			"types": "./dist/csv/index.d.ts",
 			"import": "./dist/csv/index.js",
 			"require": "./dist/csv/index.cjs"
+		},
+		"./pdf": {
+			"types": "./dist/pdf/index.d.ts",
+			"import": "./dist/pdf/index.js",
+			"require": "./dist/pdf/index.cjs"
 		}
 	},
 	"files": [
@@ -36,6 +41,8 @@
 		"prepare": "husky"
 	},
 	"devDependencies": {
+		"@types/node": "^26.0.1",
+		"@types/pdfkit": "^0.17.6",
 		"eslint": "^9.39.2",
 		"eslint-config-prettier": "^10.1.8",
 		"eslint-import-resolver-typescript": "^4.2.2",
@@ -52,6 +59,7 @@
 	},
 	"packageManager": "pnpm@10.24.0+sha512.01ff8ae71b4419903b65c60fb2dc9d34cf8bb6e06d03bde112ef38f7a34d6904c424ba66bea5cdcf12890230bf39f9580473140ed9c946fef328b6e5238a345a",
 	"dependencies": {
-		"csv-stringify": "^6.8.1"
+		"csv-stringify": "^6.8.0",
+		"pdfkit": "^0.19.1"
 	}
 }