@harbortouch/skytab-analytics-report-utils 0.16.1 → 0.18.0

package/README.md

@@ -41,6 +41,155 @@ 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 Excel
+
+Import from the `/excel` sub-path. This keeps `exceljs` out of frontend bundles — it is only included when this import is actually used.
+
+```typescript
+import { ExcelExporter } from '@harbortouch/skytab-analytics-report-utils/excel';
+
+const exporter = new ExcelExporter();
+
+const buffer = await exporter.generate({
+	sheets: [
+		{
+			sheetName: 'Sales Summary',
+			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 .xlsx binary
+fs.writeFileSync('report.xlsx', buffer);
+```
+
+`ExcelExporter.generate()` returns a `Promise<Buffer>`. Each entry in `sheets` produces one worksheet tab in the workbook.
+
+**`ExcelSheet`**
+
+| Field       | Type            | Description                                             |
+| ----------- | --------------- | ------------------------------------------------------- |
+| `sheetName` | `string`        | Optional worksheet name (defaults to `'Report'`)        |
+| `filters`   | `ExcelFilter[]` | Optional applied-filters block rendered above the table |
+| `table`     | `ExcelTable`    | Optional table to render on the sheet                   |
+
+**`ExcelTable`**
+
+| Field     | Type                        | Description                                |
+| --------- | --------------------------- | ------------------------------------------ |
+| `columns` | `ExcelTableColumn[]`        | Column definitions (order preserved)       |
+| `rows`    | `Record<string, unknown>[]` | Row data — keyed by `ExcelTableColumn.key` |
+
+**`ExcelTableColumn`**
+
+| 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      |
+
+**`ExcelFilter`**
+
+| Field   | Type     | Description  |
+| ------- | -------- | ------------ |
+| `label` | `string` | Filter label |
+| `value` | `string` | Filter value |
+
+**Behaviour notes**
+
+- Each `ExcelSheet` entry produces one worksheet tab in the workbook.
+- Applied filters are rendered as `Label: value` rows above the table, separated from it by a blank row.
+- The header row is bold with a grey fill (`#D3D3D3`) and has Excel auto-filter enabled.
+- Alternating data rows use a light grey background (`#F5F5F5`).
+- Numeric cell values are right-aligned; all other values are left-aligned.
+- Column widths are auto-calculated from header and cell content; the optional `width` field overrides the auto-calculation for a specific column.
+- `null` and `undefined` cell values are rendered as empty cells.
+
+> **Note:** `exceljs` 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.
@@ -91,8 +240,15 @@ src/
 ├── types.ts                — Core interfaces (FieldType, ColumnPresentationConfig, ReportConfig, …)
 ├── columns/
 │   └── index.ts            — ReportColumnKey union type + COLUMN_REGISTRY (i18n keys)
-├── csv/
-│   └── index.ts            — CsvExporter — published as the ./csv sub-path export
+├── exporters/
+│   ├── types.ts            — Shared ExportTableColumn / ExportTable / ExportFilter interfaces
+│   ├── csv/
+│   │   └── index.ts        — CsvExporter — published as the ./csv sub-path export
+│   ├── excel/
+│   │   └── index.ts        — ExcelExporter — published as the ./excel 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/{csv → exporters/csv}/index.cjs

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/csv/index.ts
+// src/exporters/csv/index.ts
 var csv_exports = {};
 __export(csv_exports, {
   CsvExporter: () => CsvExporter

package/dist/{csv → exporters/csv}/index.js

@@ -1,4 +1,4 @@
-// src/csv/index.ts
+// src/exporters/csv/index.ts
 import { stringify } from "csv-stringify/sync";
 var CsvExporter = class {
   constructor(options = {}) {

package/dist/exporters/excel/index.cjs

@@ -0,0 +1,101 @@
+"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/exporters/excel/index.ts
+var excel_exports = {};
+__export(excel_exports, {
+  ExcelExporter: () => ExcelExporter
+});
+module.exports = __toCommonJS(excel_exports);
+var import_exceljs = __toESM(require("exceljs"), 1);
+var GRAY_FILL = {
+  type: "pattern",
+  pattern: "solid",
+  fgColor: { argb: "FFD9D9D9" }
+};
+var toCell = (value) => {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  return null;
+};
+var ExcelExporter = class {
+  async generate(content) {
+    const workbook = new import_exceljs.default.Workbook();
+    const usedNames = /* @__PURE__ */ new Set();
+    for (const section of content.sections) {
+      let sheetName = section.sheetName.slice(0, 31);
+      if (usedNames.has(sheetName.toLowerCase())) {
+        let suffix = 2;
+        let candidate = `${sheetName.slice(0, 28)}_${suffix}`;
+        while (usedNames.has(candidate.toLowerCase())) {
+          suffix++;
+          candidate = `${sheetName.slice(0, 28)}_${suffix}`;
+        }
+        sheetName = candidate;
+      }
+      usedNames.add(sheetName.toLowerCase());
+      const sheet = workbook.addWorksheet(sheetName);
+      if (section.filters && section.filters.length > 0) {
+        const titleRow = sheet.addRow(["Applied Filters"]);
+        titleRow.getCell(1).font = { bold: true };
+        titleRow.getCell(1).fill = GRAY_FILL;
+        for (const filter of section.filters) {
+          const row = sheet.addRow([filter.label, filter.value]);
+          row.getCell(1).font = { bold: true };
+        }
+        sheet.addRow([]);
+      }
+      if (section.table) {
+        const headerRow = sheet.addRow(section.table.columns.map((col) => col.header));
+        headerRow.font = { bold: true };
+        headerRow.eachCell((cell) => {
+          cell.fill = GRAY_FILL;
+        });
+        section.table.columns.forEach((col, i) => {
+          if (col.width) {
+            sheet.getColumn(i + 1).width = col.width / 7;
+          }
+        });
+        for (const row of section.table.rows) {
+          sheet.addRow(section.table.columns.map((col) => toCell(row[col.key])));
+        }
+      }
+    }
+    const buf = await workbook.xlsx.writeBuffer();
+    return Buffer.from(buf);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExcelExporter
+});

package/dist/exporters/excel/index.d.cts

@@ -0,0 +1,15 @@
+import { E as ExportTable, a as ExportFilter } from '../../types-BzLsgnfc.cjs';
+export { b as XlsxTableColumn } from '../../types-BzLsgnfc.cjs';
+
+interface XlsxDocumentSection {
+    sheetName: string;
+    table?: ExportTable;
+    filters?: ExportFilter[];
+}
+declare class ExcelExporter {
+    generate(content: {
+        sections: XlsxDocumentSection[];
+    }): Promise<Buffer>;
+}
+
+export { ExcelExporter, type XlsxDocumentSection, ExportFilter as XlsxFilter, ExportTable as XlsxTable };

package/dist/exporters/excel/index.d.ts

@@ -0,0 +1,15 @@
+import { E as ExportTable, a as ExportFilter } from '../../types-BzLsgnfc.js';
+export { b as XlsxTableColumn } from '../../types-BzLsgnfc.js';
+
+interface XlsxDocumentSection {
+    sheetName: string;
+    table?: ExportTable;
+    filters?: ExportFilter[];
+}
+declare class ExcelExporter {
+    generate(content: {
+        sections: XlsxDocumentSection[];
+    }): Promise<Buffer>;
+}
+
+export { ExcelExporter, type XlsxDocumentSection, ExportFilter as XlsxFilter, ExportTable as XlsxTable };

package/dist/exporters/excel/index.js

@@ -0,0 +1,66 @@
+// src/exporters/excel/index.ts
+import ExcelJS from "exceljs";
+var GRAY_FILL = {
+  type: "pattern",
+  pattern: "solid",
+  fgColor: { argb: "FFD9D9D9" }
+};
+var toCell = (value) => {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  return null;
+};
+var ExcelExporter = class {
+  async generate(content) {
+    const workbook = new ExcelJS.Workbook();
+    const usedNames = /* @__PURE__ */ new Set();
+    for (const section of content.sections) {
+      let sheetName = section.sheetName.slice(0, 31);
+      if (usedNames.has(sheetName.toLowerCase())) {
+        let suffix = 2;
+        let candidate = `${sheetName.slice(0, 28)}_${suffix}`;
+        while (usedNames.has(candidate.toLowerCase())) {
+          suffix++;
+          candidate = `${sheetName.slice(0, 28)}_${suffix}`;
+        }
+        sheetName = candidate;
+      }
+      usedNames.add(sheetName.toLowerCase());
+      const sheet = workbook.addWorksheet(sheetName);
+      if (section.filters && section.filters.length > 0) {
+        const titleRow = sheet.addRow(["Applied Filters"]);
+        titleRow.getCell(1).font = { bold: true };
+        titleRow.getCell(1).fill = GRAY_FILL;
+        for (const filter of section.filters) {
+          const row = sheet.addRow([filter.label, filter.value]);
+          row.getCell(1).font = { bold: true };
+        }
+        sheet.addRow([]);
+      }
+      if (section.table) {
+        const headerRow = sheet.addRow(section.table.columns.map((col) => col.header));
+        headerRow.font = { bold: true };
+        headerRow.eachCell((cell) => {
+          cell.fill = GRAY_FILL;
+        });
+        section.table.columns.forEach((col, i) => {
+          if (col.width) {
+            sheet.getColumn(i + 1).width = col.width / 7;
+          }
+        });
+        for (const row of section.table.rows) {
+          sheet.addRow(section.table.columns.map((col) => toCell(row[col.key])));
+        }
+      }
+    }
+    const buf = await workbook.xlsx.writeBuffer();
+    return Buffer.from(buf);
+  }
+};
+export {
+  ExcelExporter
+};

package/dist/exporters/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/exporters/pdf/index.ts
+var pdf_exports = {};
+__export(pdf_exports, {
+  PdfExporter: () => PdfExporter
+});
+module.exports = __toCommonJS(pdf_exports);
+var import_pdfkit = __toESM(require("pdfkit"), 1);
+
+// src/exporters/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/exporters/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.sections.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/exporters/pdf/index.d.cts

@@ -0,0 +1,18 @@
+import { E as ExportTable, a as ExportFilter, b as ExportTableColumn } from '../../types-BzLsgnfc.cjs';
+
+interface PdfSection {
+    table?: ExportTable;
+    filters?: ExportFilter[];
+}
+declare class PdfExporter {
+    generate(content: {
+        sections: PdfSection[];
+    }): Promise<Buffer>;
+    private sanitizeSections;
+    drawFilters(doc: PDFKit.PDFDocument, filters: ExportFilter[]): number;
+    drawTable(doc: PDFKit.PDFDocument, table: ExportTable, startY?: number): void;
+    drawHeader(doc: PDFKit.PDFDocument, columns: ExportTableColumn[], startY: number, tableWidth: number, headerHeight: number, cellPadding: number, headerFontSize: number, minColumnWidth: number): number;
+    drawRow(doc: PDFKit.PDFDocument, row: Record<string, unknown>, rowIndex: number, columns: ExportTableColumn[], currentY: number, tableWidth: number, rowHeight: number, cellPadding: number, dataFontSize: number, minColumnWidth: number): number;
+}
+
+export { PdfExporter, ExportFilter as PdfFilter, type PdfSection, ExportTable as PdfTable, ExportTableColumn as PdfTableColumn };

package/dist/exporters/pdf/index.d.ts

@@ -0,0 +1,18 @@
+import { E as ExportTable, a as ExportFilter, b as ExportTableColumn } from '../../types-BzLsgnfc.js';
+
+interface PdfSection {
+    table?: ExportTable;
+    filters?: ExportFilter[];
+}
+declare class PdfExporter {
+    generate(content: {
+        sections: PdfSection[];
+    }): Promise<Buffer>;
+    private sanitizeSections;
+    drawFilters(doc: PDFKit.PDFDocument, filters: ExportFilter[]): number;
+    drawTable(doc: PDFKit.PDFDocument, table: ExportTable, startY?: number): void;
+    drawHeader(doc: PDFKit.PDFDocument, columns: ExportTableColumn[], startY: number, tableWidth: number, headerHeight: number, cellPadding: number, headerFontSize: number, minColumnWidth: number): number;
+    drawRow(doc: PDFKit.PDFDocument, row: Record<string, unknown>, rowIndex: number, columns: ExportTableColumn[], currentY: number, tableWidth: number, rowHeight: number, cellPadding: number, dataFontSize: number, minColumnWidth: number): number;
+}
+
+export { PdfExporter, ExportFilter as PdfFilter, type PdfSection, ExportTable as PdfTable, ExportTableColumn as PdfTableColumn };

package/dist/exporters/pdf/index.js

@@ -0,0 +1,200 @@
+// src/exporters/pdf/index.ts
+import PDFDocument from "pdfkit";
+
+// src/exporters/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/exporters/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.sections.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/dist/types-BzLsgnfc.d.cts

@@ -0,0 +1,15 @@
+interface ExportTableColumn {
+    header: string;
+    key: string;
+    width?: number;
+}
+interface ExportTable {
+    columns: ExportTableColumn[];
+    rows: Record<string, unknown>[];
+}
+interface ExportFilter {
+    label: string;
+    value: string;
+}
+
+export type { ExportTable as E, ExportFilter as a, ExportTableColumn as b };

package/dist/types-BzLsgnfc.d.ts

@@ -0,0 +1,15 @@
+interface ExportTableColumn {
+    header: string;
+    key: string;
+    width?: number;
+}
+interface ExportTable {
+    columns: ExportTableColumn[];
+    rows: Record<string, unknown>[];
+}
+interface ExportFilter {
+    label: string;
+    value: string;
+}
+
+export type { ExportTable as E, ExportFilter as a, ExportTableColumn as b };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@harbortouch/skytab-analytics-report-utils",
-	"version": "0.16.1",
+	"version": "0.18.0",
 	"description": "Centralized report column presentation configuration for SkyTab Analytics",
 	"engines": {
 		"node": ">=22.6.0",
@@ -16,9 +16,19 @@
 			"require": "./dist/index.cjs"
 		},
 		"./csv": {
-			"types": "./dist/csv/index.d.ts",
-			"import": "./dist/csv/index.js",
-			"require": "./dist/csv/index.cjs"
+			"types": "./dist/exporters/csv/index.d.ts",
+			"import": "./dist/exporters/csv/index.js",
+			"require": "./dist/exporters/csv/index.cjs"
+		},
+		"./pdf": {
+			"types": "./dist/exporters/pdf/index.d.ts",
+			"import": "./dist/exporters/pdf/index.js",
+			"require": "./dist/exporters/pdf/index.cjs"
+		},
+		"./excel": {
+			"types": "./dist/exporters/excel/index.d.ts",
+			"import": "./dist/exporters/excel/index.js",
+			"require": "./dist/exporters/excel/index.cjs"
 		}
 	},
 	"files": [
@@ -36,6 +46,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 +64,8 @@
 	},
 	"packageManager": "pnpm@10.24.0+sha512.01ff8ae71b4419903b65c60fb2dc9d34cf8bb6e06d03bde112ef38f7a34d6904c424ba66bea5cdcf12890230bf39f9580473140ed9c946fef328b6e5238a345a",
 	"dependencies": {
-		"csv-stringify": "^6.8.0"
+		"csv-stringify": "^6.8.0",
+		"exceljs": "^4.4.0",
+		"pdfkit": "^0.19.1"
 	}
 }