fix(pdf): stop logo from overlapping donor block on EOY receipts

[EssentialsDev]

Summary

• The EOY receipt header was positioning the donor block (ISSUED TO / ISSUED) based on text-line advance, so a 64pt logo extended past the bottom of the header text and overlapped the row below. Shrunk the default logo slot to 48pt, constrained the org-name and receipt-label text widths to the column right of the logo, and explicitly advanced doc.y past the logo bottom before the donor block.
• Added a sample receipt to the README (PNG preview inline + downloadable PDF) so the rendered layout is visible without cloning the repo. Regeneration script lives at examples/gen-sample-receipt.mjs.

Preview

Test plan

• pnpm test — 21/21 passing
• Visually verified the regenerated examples/sample-receipt.pdf — logo no longer overlaps donor block
• Reviewer: open examples/sample-receipt.pdf to sanity-check the new layout at print size

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR adjusts the PDF end-of-year receipt header layout to prevent a logo from overlapping the donor block, and adds a visible sample receipt (with a regeneration script) to make the rendered output easy to review.

Changes:

• Reduce the default PDF logo slot size (64pt → 48pt) and constrain header text to the non-logo column.
• Ensure the PDF cursor (doc.y) advances past the bottom of the logo before rendering the donor block.
• Add sample receipt assets + a generator script and link them from the README.

Reviewed changes

Copilot reviewed 3 out of 5 changed files in this pull request and generated 3 comments.

File	Description
src/report/formats/pdf.ts	Shrinks default logo size and adjusts header text positioning / doc.y advancement to avoid overlap.
README.md	Updates --logo-size default docs and embeds a sample receipt preview + download link.
examples/gen-sample-receipt.mjs	Adds a script to regenerate the sample receipt PDF using the built renderer.

Comments suppressed due to low confidence (1)

src/report/formats/pdf.ts:185

• The header layout reserves logoGutter and later advances doc.y by logoSize whenever opts.logoPath is set, even if doc.image(...) throws and the logo is not actually rendered. That leaves an unnecessary blank gutter and can push the donor block down despite a text-only header. Track whether the image render succeeded (or compute gutter/logoBottom inside the try) and only apply the gutter and doc.y advance when the logo was drawn.

    const logoSize = opts.logoSize ?? DEFAULT_LOGO_SIZE;
    const logoGutter = opts.logoPath ? logoSize + 14 : 0;
    if (opts.logoPath) {
      try {
        doc.image(opts.logoPath, left, headerY, { fit: [logoSize, logoSize] });
      } catch {
        /* fall through to text-only header */

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.