Resolution-flexible UI: render SSD1333 (176×176) and SSD1351 (128×128) from shared geometry

[brickbots]

Summary

Adapts the UI to render at the display's resolution instead of a hardcoded 128×128, so the new 1.91″ 176×176 SSD1333 and the existing 1.5″ 128×128 SSD1351 share one codebase. Layout (row counts, line positions, text anchors, image scaling, entry-box grids, scroll bars) derives from display_class.resX/resY + font metrics; a small set of per-display knobs (font sizes, titlebar_height, menu_visible_items) is hand-tuned per panel. The hybrid approach (derive geometry + per-display knobs) is recorded in docs/adr/0009-resolution-flexible-ui-hybrid.md.

What's in it (29 files, +1032 / −423)

• ui/layout.py (new) — the geometry engine: carousel_layout, list_layout, rows_below_titlebar, center_box_row.
• displays.py — Layout176 mixin, DisplayPygame_176 / DisplayHeadless176, the menu_visible_items knob (must be odd).
• Screens derive layout from resolution: base, text_menu, object_list, object_details, chart, preview, align, console, status, sqm, equipment, software, log, location_list, the time/date/location/radec/text entry grids, and the SQM calibration/sweep/correction screens, ui_utils.
• Three 176-panel fixes found during hardware validation:
  • carousel selection box now keeps clearance from the row above (was touching it);
  • help screens normalize to the device resolution (fixes a luma image.size == device.size assert crash on 176);
  • the radial marking-menu radius scales with resolution so the curved labels stay inside their pie slices.
• docs/adr/0009 + docs/ax/ui — the hybrid decision + resolution terminology.

Deferred to new_hardware_features

• Boot splash (splash.py) is intentionally not in this PR. Its panel auto-detection depends on hardware_detect (the rev-4 battery marker), which isn't on main yet; and on main the splash always runs at 128, so the resolution scaling would be a no-op. It lands with NHF.

Validation (at both 128 and 176)

• ruff check + ruff format clean; mypy clean (only pre-existing pandas/requests stub errors in plot.py/comets.py/software.py).
• pytest -m "smoke or unit" → 285 passed.
• A crash-sweep of 16 screens through the real device.display() path renders cleanly at 128 and 176 (every screen produces a resX×resY image the device accepts).

Notes for reviewers

• Built on current main (post the SSD1333 base merge). Independent of new_hardware_features.
• The screens were originally hardware-validated on top of NHF and re-derived onto main's versions here; only preview.py needed manual work (main's focus-strip rework had replaced the reticle the resolution patch targeted). A quick on-panel pass on the re-derived screens is worthwhile before merge.

🤖 Generated with Claude Code