feat(pdf-export): add per-column styles, grouped column headers, configurable colors, document properties, and autoTableOptions callback

[jr01]

Summary

This PR adds several PDF export enhancements as discussed in #2406:

Per-column text alignment

• Columns can now specify pdfExportOptions: { textAlign: 'right' } to control alignment individually
• Works in both AutoTable (via columnStyles + didParseCell for headers) and manual fallback paths

Grouped column headers (pre-header row)

• When createPreHeaderPanel and showPreHeaderPanel are enabled, the PDF export now renders grouped column headers with proper colSpan merging in the AutoTable path

Configurable styling

• headerBackgroundColor / headerTextColor — header row colors (RGB tuples)
• preHeaderBackgroundColor / preHeaderTextColor — pre-header row colors
• alternateRowColor — alternate (odd) row background color
• cellPadding — cell padding in pt

Document properties (metadata)

• documentProperties option to set PDF metadata (title, author, subject, keywords, creator) via doc.setDocumentProperties()

AutoTable options callback

• autoTableOptions callback to customize jsPDF-AutoTable options before rendering

Tests

• 110 tests total (28 new), all passing
• Covers both AutoTable and manual fallback paths

Screenshot

Showing grouped column headers, alignment (in header and row values), alternate styling & document properties:

Remarks

Fully vibe coded, including most of this comment as well 😁

Closes #2406

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.0%. Comparing base (bbb5b70) to head (ccd46d1).
⚠️ Report is 48 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff            @@
##           master    #2413    +/-   ##
========================================
  Coverage   100.0%   100.0%            
========================================
  Files         196      196            
  Lines       24248    24375   +127     
  Branches     8488     8543    +55     
========================================
+ Hits        24248    24375   +127     

Flag	Coverage Δ
angular	100.0% <ø> (ø)
universal	100.0% <100.0%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[pkg-pr-new]

angular-slickgrid

npm i https://pkg.pr.new/angular-slickgrid@2413

aurelia-slickgrid

npm i https://pkg.pr.new/aurelia-slickgrid@2413

slickgrid-react

npm i https://pkg.pr.new/slickgrid-react@2413

slickgrid-vue

npm i https://pkg.pr.new/slickgrid-vue@2413

@slickgrid-universal/angular-row-detail-plugin

npm i https://pkg.pr.new/@slickgrid-universal/angular-row-detail-plugin@2413

@slickgrid-universal/aurelia-row-detail-plugin

npm i https://pkg.pr.new/@slickgrid-universal/aurelia-row-detail-plugin@2413

@slickgrid-universal/react-row-detail-plugin

npm i https://pkg.pr.new/@slickgrid-universal/react-row-detail-plugin@2413

@slickgrid-universal/vue-row-detail-plugin

npm i https://pkg.pr.new/@slickgrid-universal/vue-row-detail-plugin@2413

@slickgrid-universal/binding

npm i https://pkg.pr.new/@slickgrid-universal/binding@2413

@slickgrid-universal/common

npm i https://pkg.pr.new/@slickgrid-universal/common@2413

@slickgrid-universal/composite-editor-component

npm i https://pkg.pr.new/@slickgrid-universal/composite-editor-component@2413

@slickgrid-universal/custom-footer-component

npm i https://pkg.pr.new/@slickgrid-universal/custom-footer-component@2413

@slickgrid-universal/custom-tooltip-plugin

npm i https://pkg.pr.new/@slickgrid-universal/custom-tooltip-plugin@2413

@slickgrid-universal/empty-warning-component

npm i https://pkg.pr.new/@slickgrid-universal/empty-warning-component@2413

@slickgrid-universal/event-pub-sub

npm i https://pkg.pr.new/@slickgrid-universal/event-pub-sub@2413

@slickgrid-universal/excel-export

npm i https://pkg.pr.new/@slickgrid-universal/excel-export@2413

@slickgrid-universal/graphql

npm i https://pkg.pr.new/@slickgrid-universal/graphql@2413

@slickgrid-universal/odata

npm i https://pkg.pr.new/@slickgrid-universal/odata@2413

@slickgrid-universal/pagination-component

npm i https://pkg.pr.new/@slickgrid-universal/pagination-component@2413

@slickgrid-universal/pdf-export

npm i https://pkg.pr.new/@slickgrid-universal/pdf-export@2413

@slickgrid-universal/row-detail-view-plugin

npm i https://pkg.pr.new/@slickgrid-universal/row-detail-view-plugin@2413

@slickgrid-universal/rxjs-observable

npm i https://pkg.pr.new/@slickgrid-universal/rxjs-observable@2413

@slickgrid-universal/text-export

npm i https://pkg.pr.new/@slickgrid-universal/text-export@2413

@slickgrid-universal/utils

npm i https://pkg.pr.new/@slickgrid-universal/utils@2413

@slickgrid-universal/vanilla-bundle

npm i https://pkg.pr.new/@slickgrid-universal/vanilla-bundle@2413

@slickgrid-universal/vanilla-force-bundle

npm i https://pkg.pr.new/@slickgrid-universal/vanilla-force-bundle@2413

commit: 2e4037c

[ghiscoding]

this readme should be a very basic instructions of how to install it and add it as a resource. But more in-depth documentation like this should be moved to the online docs, there's a file named export-to-pdf.md and you should move that full docs to that file so that we can see it from the official GitBook docs. Also note that there's 5x files (4x frameworks + 1x native usage)

[jr01]

agree that would be better, didn't think about it. will fix it

[ghiscoding]

wow that is a lot of configs, do we really need all of this? Are you expecting to use this in the future? All I have in Excel is the filename that can be customized

[jr01]

PDFs are often sent by our customers to their customers, so they need to look more official. Spreadsheets are only used internally by our customers. So, yes being able to set documentProperties is very nice to have. But we can do it by subclassing or the autoTableOptions callback 😏
You have the final say 🥺

[ghiscoding]

you can keep them if you intend to use them, I was just making sure that we're not going crazy with implementing every possible option because of the vibe coding (sometime copilot is a little too excited lol). So if you use them and want to keep them that's fine.

[ghiscoding]

there's missing coverage it seems, 1 of them is partial coverage

partial

and missing

[ghiscoding]

@jr01 will you be able to update the PR today? I was waiting for this PR before releasing v10, so if you can make the update today that would be great. Thanks

[jr01]

@ghiscoding No, sorry, unfortunately don't have the time today. Even though it should just be a some minutes. But I think this PR is not important for v10. So please go ahead with releasing v10 and sorry if I held you up with that. I'll fix this PR this week.

[jr01]

hey @ghiscoding - I did some rework per your review comments, can you take a swing at this PR again? No hurry!

[github-actions]

🎉 This pull request is included in version 10.1.0 📦
🔗 The release notes are available at: GitHub Release 🚀