@angular-bootstrap/ngbootstrap 2.0.2 → 2.0.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 2.0.3 - 2026-07-05
+
+### Fixed
+
+- Replaced the default PDF export implementation with a dependency-free browser PDF writer so Angular apps do not need jsPDF optional HTML/canvas dependencies for basic table export.
+- Removed `jspdf` and `jspdf-autotable` from optional peer dependencies.
+
 ## 2.0.2 - 2026-07-05
 
 ### Fixed

package/README.md

@@ -29,15 +29,21 @@ npm install @angular-bootstrap/ngbootstrap bootstrap bootstrap-icons
 Optional integrations are installed only when you use those features:
 
 ```bash
-npm install chart.js jspdf jspdf-autotable
+npm install chart.js
 ```
 
+PDF and Excel export are dependency-free by default.
+
 Excel export is dependency-free by default. The built-in `BrowserExcelExportAdapter`
 generates an Excel-compatible workbook in the browser and avoids unmaintained
 spreadsheet writer dependencies. It is intended for visible column values and
 basic scalar cell types; use a custom `ExcelExportAdapter` for formulas, charts,
 multiple sheets, workbook styling, or other advanced workbook features.
 
+The built-in PDF adapter generates a simple table PDF in the browser. Provide a custom
+`PdfExportAdapter` when your product needs branded PDFs, images, charts, advanced layout,
+rich typography, headers, footers, or more precise pagination.
+
 ## Use
 
 Import standalone components directly in your Angular component.

package/RELEASE_NOTES.md

@@ -1,18 +1,15 @@
-# @angular-bootstrap/ngbootstrap 2.0.2
+# @angular-bootstrap/ngbootstrap 2.0.3
 
-This patch fixes PDF export bundling for Angular browser apps.
+This patch makes the default PDF export path dependency-free.
 
 ## Fixed
 
-- `JsPdfAdapter` now loads jsPDF from its browser UMD bundle.
-- This avoids forcing consuming apps to resolve jsPDF optional ESM dependencies such as HTML/canvas sanitization helpers when they only need table PDF export.
+- `JsPdfAdapter` now generates a simple table PDF directly in the browser.
+- Removed `jspdf` and `jspdf-autotable` from optional peer dependencies.
+- Angular apps no longer need jsPDF optional HTML/canvas dependencies for basic DataGrid PDF export.
 
 ## Notes
 
-Applications using PDF export should keep both maintained PDF integrations installed:
+PDF and Excel export are dependency-free by default. The built-in PDF adapter is intended for simple table export only.
 
-```bash
-npm install jspdf jspdf-autotable
-```
-
-Excel export remains dependency-free through `BrowserExcelExportAdapter`.
+Use a custom `PdfExportAdapter` for branded layouts, images, charts, rich typography, or advanced pagination.

package/fesm2022/angular-bootstrap-ngbootstrap.mjs

@@ -1249,13 +1249,104 @@ class NgbDatagridDefaultEditService {
     }
 }
 
+const PAGE_SIZES = {
+    A4: [595.28, 841.89],
+    Letter: [612, 792],
+};
 class JsPdfAdapter {
-    async export({ fileName, columns, rows, options }) {
-        const { jsPDF } = await import('jspdf/dist/jspdf.umd.min.js');
-        const autoTable = (await import('jspdf-autotable')).default;
-        const doc = new jsPDF({ orientation: options?.landscape ? 'landscape' : 'portrait' });
-        autoTable(doc, { head: [columns], body: rows.map(r => columns.map(k => r[k])), margin: options?.margins });
-        doc.save(`${fileName}.pdf`);
+    async export(payload) {
+        const pdf = this.createPdf(payload);
+        const blob = new Blob([pdf], { type: 'application/pdf' });
+        const url = URL.createObjectURL(blob);
+        const link = document.createElement('a');
+        link.href = url;
+        link.download = `${payload.fileName}.pdf`;
+        link.click();
+        URL.revokeObjectURL(url);
+    }
+    createPdf({ fileName, columns, rows, options }) {
+        const requestedSize = String(options?.pageSize || 'A4');
+        const baseSize = PAGE_SIZES[requestedSize] || PAGE_SIZES.A4;
+        const landscape = Boolean(options?.landscape);
+        const [pageWidth, pageHeight] = landscape ? [baseSize[1], baseSize[0]] : baseSize;
+        const margin = this.resolveMargin(options?.margins);
+        const lineHeight = 14;
+        const maxLines = Math.max(1, Math.floor((pageHeight - margin.top - margin.bottom - 52) / lineHeight));
+        const tableLines = this.toTableLines(columns, rows);
+        const pages = this.chunk(tableLines, maxLines);
+        const objects = [];
+        const pageIds = [];
+        objects.push('<< /Type /Catalog /Pages 2 0 R >>');
+        objects.push('');
+        for (const [index, lines] of pages.entries()) {
+            const pageObjectId = objects.length + 1;
+            const contentObjectId = pageObjectId + 1;
+            pageIds.push(pageObjectId);
+            objects.push(`<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ${pageWidth} ${pageHeight}] /Resources << /Font << /F1 ${pages.length * 2 + 3} 0 R >> >> /Contents ${contentObjectId} 0 R >>`);
+            objects.push(this.contentStream(fileName, lines, index + 1, pages.length, pageHeight, margin, lineHeight));
+        }
+        objects[1] = `<< /Type /Pages /Kids [${pageIds.map(id => `${id} 0 R`).join(' ')}] /Count ${pageIds.length} >>`;
+        objects.push('<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>');
+        return this.serializePdf(objects);
+    }
+    resolveMargin(margins) {
+        if (!Array.isArray(margins) || margins.length !== 4) {
+            return { top: 40, right: 40, bottom: 40, left: 40 };
+        }
+        const [top, right, bottom, left] = margins.map(value => Math.max(16, Number(value) || 40));
+        return { top, right, bottom, left };
+    }
+    toTableLines(columns, rows) {
+        const headers = columns.map(column => this.printable(column));
+        const body = rows.map(row => columns.map(column => this.printable(row?.[column])));
+        const widths = headers.map((header, index) => Math.min(24, Math.max(header.length, ...body.map(values => values[index]?.length || 0))));
+        const format = (values) => values.map((value, index) => value.padEnd(widths[index]).slice(0, widths[index])).join('  ');
+        return [
+            format(headers),
+            widths.map(width => '-'.repeat(width)).join('  '),
+            ...body.map(format),
+        ];
+    }
+    contentStream(fileName, lines, page, totalPages, pageHeight, margin, lineHeight) {
+        const commands = [
+            'BT',
+            `/F1 16 Tf ${margin.left} ${pageHeight - margin.top} Td (${this.pdfText(fileName)}) Tj`,
+            `/F1 9 Tf 0 -24 Td (${this.pdfText(`Page ${page} of ${totalPages}`)}) Tj`,
+            ...lines.map(line => `0 -${lineHeight} Td (${this.pdfText(line)}) Tj`),
+            'ET',
+        ].join('\n');
+        return `<< /Length ${commands.length} >>\nstream\n${commands}\nendstream`;
+    }
+    chunk(items, size) {
+        const pages = [];
+        for (let index = 0; index < items.length; index += size) {
+            pages.push(items.slice(index, index + size));
+        }
+        return pages.length ? pages : [[]];
+    }
+    printable(value) {
+        if (value === null || value === undefined) {
+            return '';
+        }
+        return String(value).replace(/[^\x20-\x7E]/g, '?').replace(/\s+/g, ' ').trim();
+    }
+    pdfText(value) {
+        return value.replace(/\\/g, '\\\\').replace(/\(/g, '\\(').replace(/\)/g, '\\)');
+    }
+    serializePdf(objects) {
+        let pdf = '%PDF-1.4\n';
+        const offsets = [0];
+        for (const [index, object] of objects.entries()) {
+            offsets[index + 1] = pdf.length;
+            pdf += `${index + 1} 0 obj\n${object}\nendobj\n`;
+        }
+        const xrefOffset = pdf.length;
+        pdf += `xref\n0 ${objects.length + 1}\n0000000000 65535 f \n`;
+        for (let index = 1; index <= objects.length; index++) {
+            pdf += `${String(offsets[index]).padStart(10, '0')} 00000 n \n`;
+        }
+        pdf += `trailer\n<< /Size ${objects.length + 1} /Root 1 0 R >>\nstartxref\n${xrefOffset}\n%%EOF`;
+        return pdf;
     }
 }
 
@@ -14254,8 +14345,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.0", ngImpor
                 args: ['nodeBtn', { read: ElementRef }]
             }] } });
 
-/// <reference path="./types/optional-peer-deps.d.ts" />
-
 /**
  * Generated bundle index. Do not edit.
  */