docs(testing): #132 — judge menu geometry by rendering; "just measure" was the trap
All checks were successful
Check / eval (push) Successful in 4m7s

The guest's unfaithful rofi geometry was already documented in TESTING.md
§5. What was not, and what this closes, is that the bullet's fallback
advice — "measure text against the 40% window width instead" — is exactly
how #131 stayed wrong for weeks, and my own #131 fix made it stale on top
of that (the width is calc( 84ch min 65% ) now).

Measuring needs a width and a font, and both are per-theme: text menus
render through themes/<slug>/rofi.rasi, where boreal + neon-glass pinned a
fixed 620px while the rest used 40%, in fonts from Inter 11 to
JetBrainsMono 14. The item measured one combination no theme ships,
concluded "only truncates below 1920", and the truncation was live on a
2560 panel.

So §5 now says: judge by rendering — hardware, or `rofi -dmenu -theme <the
built rasi>` + `hyprctl layers` for the real width — and notes
checks.rofi-text-width guards the invariant that makes it fit, never how it
looks. Declined the other half (fixing the guest's fontconfig/icon cache):
the screenshots are useful as content checks, and a guest that lied
convincingly about spacing would be worse than one that obviously cannot.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-16 13:32:49 +01:00
parent ff0f9d6359
commit 3cc644edd9
3 changed files with 29 additions and 15 deletions

View File

@@ -148,9 +148,21 @@ Hyprland's headless backend otherwise aborts in a VM-only zero-output state.
- **Menu geometry does not survive the guest**: the rofi picker draws with
icons at roughly a quarter of `ui.iconSize` and rows short enough that a
6-row root clips its last entry behind a scrollbar (`lines = 8` should
fit it). Menu screenshots are evidence for **which rows appear**, never
for spacing, icon size or label truncation — measure text against the
40% window width instead, or check on hardware (BACKLOG #132).
fit it) — the guest's font/icon environment, not a regression. Menu
screenshots are evidence for **which rows appear**, never for spacing,
icon size or label truncation.
**And do not "just measure" instead** — that is how #131 stayed wrong for
weeks. Measuring needs a width and a font, and both are per-theme: text
menus render through `themes/<slug>/rofi.rasi`, where boreal and
neon-glass pinned a fixed `620px` while the rest used `40%`, in fonts from
Inter 11 to JetBrainsMono 14. The item measured one combination that no
theme actually shipped, concluded "only truncates below 1920", and the
truncation was live on a 2560 panel. Since #131 the width is
`calc( 84ch min 65% )` — font-relative by design, so the arithmetic is
even less predictable from a spec sheet. **Judge it by rendering**: on
hardware, or with `rofi -dmenu -theme <the built rasi>` plus
`hyprctl layers` for the real width. `checks.rofi-text-width` guards the
invariant that makes it fit; nothing guards how it looks.
## 6. When something fails