Feature Requests & Feedback

This phase focuses on making pagination smarter and more predictable for complex documents without breaking the existing public API. Planned work: Add smart split controls Add data-pdf-split="avoid" Keep a block together when it fits on one page Avoid awkward page breaks inside important sections Preserve existing behavior when the attribute is not used Add container-aware splitting Add data-pdf-split="container" Allow large containers to split across pages intelligently Preserve child structure where possible Avoid unnecessary blank space Add explicit page-break controls Add break-before support Add break-after support Keep compatibility with existing html2pdf__page-break behavior Make page-break rules consistent across supported render modes Handle oversized elements safely Detect elements larger than a single PDF page Prevent infinite pagination loops Fall back to safe splitting when a block cannot fit on one page Keep generation recoverable for extreme layouts Improve table pagination Support repeated table headers across pages Reduce broken rows where possible Improve long-table readability Keep behavior predictable for large datasets Add pagination diagnostics Add an optional pagination debug overlay Show detected page boundaries Highlight forced and automatic breaks Help developers understand why content moved to a new page Add page-break diagnostic events and metadata Expose useful pagination information for debugging Report split decisions when diagnostics are enabled Keep diagnostics opt-in Avoid changing generated PDF output by default Expand regression and stress coverage Add unit tests for new pagination rules Add browser E2E coverage Test portrait and landscape layouts Test long documents and stress presets Verify existing users are not affected Primary goals: improve pagination quality reduce awkward content splitting improve long-document reliability improve table handling give developers more control over page breaks make pagination easier to debug preserve backward compatibility avoid unnecessary runtime overhead when advanced pagination features are not used This phase should be implemented incrementally with regression tests after each step. Status: Planned

This phase focuses on strengthening vue-pdf-export without breaking the existing public API. Planned work: Fix selectable-text Print properly - Repair Print behavior in renderMode="text" - Keep Canvas-mode Print working - Improve browser E2E coverage for Print Introduce a unified generation result and timing foundation - Add a common internal result model - Preserve the current GeneratePdfResult API - Prepare the package for richer output and telemetry later Expose total generation time in the playground - Add overall generation duration - Add stage-level timing - Add per-page timing instrumentation - Surface useful performance information without changing generated PDFs by default Expose stress-test page-count presets in the playground - 5 - 10 - 25 - 50 - 100 - 200 - 500 - 1000 - Custom page count / multiplier - Include safe warnings for heavy and extreme tests - Preserve cancellation and recovery Add package-manager consumer compatibility fixtures - npm - pnpm - Yarn - Yarn Plug'n'Play - Bun - Verify install, TypeScript resolution, production build, CSS import, and runtime PDF generation Add Nuxt 3 and Nuxt 4 SSR compatibility fixtures - Ensure package imports do not crash during SSR - Audit browser-only globals and imports - Add explicit Nuxt integration guidance - Add <ClientOnly> integration blueprint - Keep actual PDF generation browser-side Add data-pdf-ignore - Allow developers to exclude elements from generated PDFs - Apply exclusion only in the export/staging copy - Avoid permanently mutating the live application DOM Add page/body styling APIs - Page background color - Body background color - Page CSS/classes - Body CSS/classes - Per-page style customization - Keep behavior predictable across Canvas and selectable-text rendering modes Primary goals: improve reliability improve browser compatibility improve package-manager compatibility improve Nuxt SSR safety improve playground diagnostics add low-risk customization features avoid breaking existing users This phase should be implemented incrementally with regression tests after each step.

Improve vue3-pdf-export for large and complex documents, especially 50–100+ page PDFs with images, headers, footers, watermarks, security, and mixed content. Planned work includes: benchmark 10 / 25 / 50 / 100 page documents measure generation time, PDF size, and browser memory usage detect and prevent memory leaks during repeated generation reduce peak memory usage for canvas rendering explore page-by-page / low-memory rendering improve image optimization and repeated asset caching add cancellation for long-running PDF generation expose current-page / total-page progress warn developers when a document may exceed safe browser limits improve browser responsiveness during long generation stress-test complex HTML layouts expand Playwright E2E coverage for large documents and cleanup The goal is to make large PDF generation safer, faster, and more reliable across desktop and lower-memory devices without changing the existing HTML-to-PDF developer experience.

Currently, PDF content is generated using a canvas-based rendering approach, so the text is not selectable. It would be useful to have an optional selectable-text rendering mode for cases where users need to search, copy, or select text inside the generated PDF. The existing canvas mode could remain the default for better visual fidelity, while selectable-text mode could be enabled as an optional feature.