Repository source: docs/plans/gallery_caption_zoom/gallery_caption_zoom_one_shot.md
Cycle: v3/gallery_caption_zoom; Mode: one-shot; Record: this file; Index: plans index
Debug mode: enabled (project marker .railspike_debug_on); log: gallery_caption_zoom_debug_log.md
Effort study: railspike-effort / v3/gallery_caption_zoom — host ledger; standing enrollment under protocol P2
Extended estimates: enabled (no real alternatives or work units; no unit estimates)
Cycle estimate: 0.05
Status: implemented and verified locally; next permitted action: push and PR (merge and deploy need the maintainer)
Original request
2026-11-14, after PR #249 (gallery_compact_captions) was merged, with a phone screenshot of /gallery/ where caption text is large next to small tiles: "can you please add another PR that makes the font zoom at the same time".
Authorization
That message asks for a separate PR; read as the go-ahead for a bounded one-shot cycle with a PR. Merge and deploy not covered.
Outcome and work type
Application change, follow-up to v3/gallery_zoom and v3/gallery_compact_captions (PF-20261114-F02). Normal entry: /gallery/ with Smaller / Larger or a phone pinch.
Outcome: gallery caption text scales with --gallery-zoom, clamped to 0.75x–1.25x (below 0.7 captions are already hidden). Phones get a smaller base caption size (0.8rem) to match their smaller rows. Word97 and Midnight caption/meta sizes scale the same way.
Excluded: zoom range, steps, caption content.
Approach and risks
One custom property, --gallery-text-scale: clamp(0.75, var(--gallery-zoom, 1), 1.25), on .gallery-grid; caption font-size multiplies by it, caption padding moves to em so it follows. Theme caption rules multiply their existing rem sizes by it. Pure CSS; no script or before-paint change (the zoom variable is already restored before paint).
Risk: text too small on phones at 0.8x zoom (about 10px); acceptable for a dense image view and reversible by one constant.
Reuse decisions
The existing
--gallery-zoomvariable and.gallery-grid/.gallery-tile__captionrules inpublic/assets/site.css, and the theme caption rules intheme-word97.css/theme-midnight.css. No new component.
Concepts touched
None.
Verification and recovery plan
Browser check (static harness with the real CSS and script) at 390px in Gloss Dark, Word97 and Midnight: caption font size at zoom 0.8, 1, 1.25, 2.
Smoke set plus
GalleryPageTest; full suite not run.
Starting revisions and branch
Host main at 0443804; branch feat/gallery_caption_zoom.
Planning commit
fd909f9 (plan only; see chronology note below).
Study history
2026-11-15T04:00Z intake: whole-cycle projection 0.05, scope v1, R1, P2, single exposed rater Claude (claude-opus-5-5). Exposure: rated after working on the gallery zoom code; no pristine intake.
Execution entry: 0.05 reaffirmed.
Dated execution history
2026-11-14: chronology disclosure: the CSS edits were first written before this plan was committed; they were stashed, this plan committed, then restored. No implementation was committed before the plan.
2026-11-14: implemented as planned in
site.css,theme-word97.css,theme-midnight.css.
Verification
./v3 test --smoke GalleryPageTest: 467/467 pass. Full suite not run.Browser (Chrome, static harness with the real CSS, head restore and
gallery_zoom.js), title font size at zoom 0.8 / 1 / 1.25 / 2: Gloss Dark 390px 10.2 / 12.8 / 16 / 16px; 1200px 12.8 / 16 / 20 / 20px; Word97 and Midnight 11 / 13.8 / 17.2 / 17.2px at both widths. No page errors. Not checked on a real iPhone.
Final review
Diff limited to the three CSS files, this record, the plans index, PF-20261114-F02 and the ledger. No new components.
Study closeout
Intake 0.05; execution entry reaffirmed; retrospective 0.05. Single exposed rater Claude (claude-opus-5-5), R1/P2. Maintainer acceptance pending.
Outcome
Caption text follows the gallery zoom; awaiting review, merge and deployment.
_Claude (claude-opus-5-5), 2026-11-15_