Skip to content

Commit 56c46ad

Browse files
committed
fix: Cosmos-Roadmap.pdf was blank — defeat scroll-reveal in print export
The roadmap's phases/stages are JS-generated and hidden (opacity:0) until an IntersectionObserver adds .in on scroll; a headless print never scrolls, so the PDF came out empty (13 blank pages). Regenerate with the print wrapper forcing .phase/.stage visible + expand-all + title override. Now 13 pages of full content (1.6 MB). Documented the gotcha in the handoff. Live interactive artifact was unaffected.
1 parent db676d2 commit 56c46ad

2 files changed

Lines changed: 10 additions & 0 deletions

File tree

SESSION-HANDOFF.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,16 @@ begins with `<div class="stage-banner" id="sN">…</div>` followed by its `<sect
7171
4. Copy both into `docs/`, `git add`, commit on `main`, `git checkout dev && git merge main --ff-only`,
7272
push both, then **re-publish the notes artifact** (same file path, or url + force).
7373

74+
> ⚠️ **Interactive-doc PDFs (roadmap, architecture) — print-snapshot gotcha.** Their content is
75+
> JS-generated and hidden until a scroll-reveal fires (`IntersectionObserver` adds `.in`; base state is
76+
> `opacity:0; transform:translateY(...)`). A headless print/screenshot never scrolls, so the export comes
77+
> out **blank**. When regenerating those PDFs the print wrapper MUST force the revealed state, e.g.
78+
> roadmap: `.phase,.stage{opacity:1!important;transform:none!important}` + `*{animation:none!important}`
79+
> + on-load JS `document.querySelectorAll('.phase').forEach(p=>p.classList.add('in'))`, click `#expandAll`,
80+
> and add `.open` to every `.stage`; architecture: `.band{opacity:1!important;transform:none!important}`.
81+
> Also override the gradient-clipped title (`.wordmark`/`h1.title`) to a solid color or it prints as a box.
82+
> The live HTML artifacts are unaffected (scroll-reveal works in a real browser) — this is PDF-only.
83+
7484
## 7. Housekeeping still open (optional)
7585
- Stray file `Desktop` at repo root = byte-identical duplicate of `README.md` (untracked) → can delete.
7686
- `.DS_Store` untracked → ignore/delete.

docs/Cosmos-Roadmap.pdf

977 KB
Binary file not shown.

0 commit comments

Comments
 (0)