pdf-generation

PDF generation design toolkit — analyzes reference templates (PDF/Excel), maps dynamic vs fixed fields with browser preview, recommends libraries (pdfmake, pdf-lib, PDFKit, Puppeteer, @react-pdf) with trade-offs, designs modular section architecture with conditional columns, auto-generated observations, bold markup, and revision control. v1.2.0: three new production-proven pitfalls — cell padding NOT discounted from `widths` (last column silently cuts off A4 with 8+ cols, the most painful pdfmake gotcha); Roboto bundled fi/fl/ffi ligatures drop the f (fiscal→fscal) — v1.2.1 corrects the cause: pdfkit applies the `liga` substitution but fails to embed the glyph (bundled font is current, not old; confirm via SFNT parse; `@fontsource-variable/*` ships only .woff2, unusable by pdfmake); `addFonts()` silently rejects AFM (Helvetica AFM via pdfkit looks like it works but errors 500 on getBuffer). Plus Phase 6 Visual Verification (NON-NEGOTIABLE) — render bugs only surface in the rendered PDF, never in automated tests. v1.3.0: render and inspect EVERY page, not just page 1 — header/footer in `content[]` (vs the `header`/`footer` slots) render once and silently vanish on page 2+ (invisible in a 1-page test); conditional/optional field absence ≠ bug (populate the data to verify it renders); hash-by-input revision cache does NOT regenerate on layout/code changes (bust the cache before re-rendering). v1.4.0: vector-logo (SVG) handling — pdfmake renders SVG natively via the `{ svg, width }` node (no svg-to-pdfkit dependency; the common belief that pdfmake can't do SVG is wrong); an SVG whose fills come from a `<style>`/class block renders with NO color (black/blank) unless each `class` is inlined to a `fill=` attribute — silent, build and unit tests pass, only the visual render reveals it; ship a small default vector as a `.ts` string constant (not an `.svg` file) so it survives `tsc → dist` builds (which don't copy non-`.ts` files) and gitignored runtime asset dirs (which don't exist on a fresh deploy). Triggers — PDF generation, generate PDF, PDF template, PDF layout, pdfmake, commercial proposal PDF, invoice PDF, report PDF, pdfmake column overflow, pdfmake widths padding, Roboto ligature bug, pdfmake AFM rejection, pdfmake header not repeating, PDF multipage verification, PDF revision cache stale, pdfmake SVG logo, vector logo PDF, SVG logo blank/black, SVG fills not rendering, embed SVG as constant.