pdf-export

name	pdf-export
scope	co-deck
version	2.1.0
description	Generates PDF from slide data using pdf-lib. Extracts slidedata.json, runs sample (5-slide) then full PDF generation scripts, reviews results. Reads the 4-layer spec merge (base → theme → style → overrides) directly — no Playwright measurement required. Responds to "make PDF", "export PDF", "convert to PDF". Stage 11 of the lecture workflow.
status	active
owner	pdf-export
last_reviewed	"2026-06-23T00:00:00.000Z"
prerequisites	prep-pdf

Context

Generates the final lecture PDF from slide content using pdf-lib. The PDF renderer uses a 4-layer spec merge (layout_base.json → theme pdf_layout_spec.json → style pdf_color_spec.json → lecture-profile.md layout_overrides). No Playwright measurement is required — the theme JSON files contain all calibrated layout values.

Runs a 5-slide sample first for Gate 5 review, then generates the full PDF after user approval. Invoked at Stage 11, after the prep-pdf skill completes.

When to Use

• PM Agent dispatches after prep-pdf skill completes
• User says "make PDF", "export PDF", "convert to PDF"
• After HTML or layout changes require PDF regeneration

---

Execution Steps

Step 1: Confirm Required Inputs

All inputs must exist before starting:

File	Produced by
slidedata.json	extract_slidedata.mjs (or prep-pdf --sample)
presentations/assets/fonts/<FontName>-Regular.ttf	download-font.ts (or prep-pdf)
presentations/assets/fonts/<FontName>-Bold.ttf	download-font.ts (or prep-pdf)
HTML file	Build Agent
image-manifest.json (optional)	Image Curator — background_image paths
assets/images/bg-*.<ext> (optional)	Image Curator — background image files

Dependencies (pre-installed via bun install):

• pdf-lib — PDF generation
• fflate — compression
• @pdf-lib/fontkit — Korean font embedding

---

Step 2: Extract slideData

If slidedata.json does not exist yet:

bun scripts/co-deck/extract_slidedata.mjs "path/to/lecture.html"

→ Produces slidedata.json

---

Step 3: Generate Sample PDF (5 slides)

Before the full run, generate a 5-slide sample for layout sanity check.

bun scripts/co-deck/gen-slides-pdf.ts --project presentations/<project> --sample 5

Share the sample with the user for review. If approved, proceed to Step 4 (★ Gate 5: approval required before full PDF).

---

Step 4: Generate Full PDF

bun scripts/co-deck/gen-slides-pdf.ts --project presentations/<project>

# Custom output filename:
bun scripts/co-deck/gen-slides-pdf.ts --project presentations/<project> --out <filename>.pdf

Layout customization — edit lecture-profile.md → layout_overrides:

layout_overrides:
  fonts:
    title_pt: 28
    bullet_pt: 13
  line_heights:
    title_px: 48
    bullet_px: 28

The --auto-calibrate flag can suggest starting values:

bun scripts/co-deck/gen-slides-pdf.ts --auto-calibrate --project presentations/<project>

Background image rendering (v1.7.0):

When lecture-profile.md has background_image.enabled: true, the PDF renderer applies image backgrounds per the configured scope:

Scope	Slides affected
all	Every slide
divider-cover	Title, divider, and punchline slides only
individual	Per-slide entries from image-manifest.json

Rendering pipeline: full-bleed cover-crop → semi-transparent overlay (configured by overlay.color and overlay.opacity). Image paths are resolved from image-manifest.json first, then slideData.backgroundImage, then fallback_color solid fill.

---

Output Format

• presentations/<project>/[project]_v[version].pdf — full presentation PDF
• presentations/<project>/sample_5slides.pdf — sample for Gate 5 review

Related Skills

• prep-pdf — prepares fonts, validates spec merge, generates sample
• version — snapshot the HTML and layout files before regenerating the PDF