add circular menu style and hud zoom

[vgreg]

Custom menus can now be drawn as a circular "wheel" instead of the vertical list, and every HUD scales with a single config key.

Config

{
  "menu_style": "list",
  "hud_zoom": 1.0,

  "menus": {
    "git": [ ... ],

    "window": {
      "style": "wheel",
      "items": [ ... ]
    }
  }
}

• menu_style — "list" (default) or "wheel"; "donut" and "radial" are accepted aliases.
• hud_zoom — multiplier for every HUD, default 1.0, clamped to 0.75–3.0.
• Menus accept both the original bare-array form (inherits the global style) and a new object form with a per-menu style. Both can be mixed freely.

Unknown style strings warn and fall back to the list rather than throwing, so a typo cannot blank the whole config on hot-reload.

Wheel interaction

Two ways to drive it, both live at once:

• Either thumbstick aims — the ring stays still and the highlight follows the item under the stick. Returning to centre keeps the last selection.
• Dpad left/right rotates — the ring turns and the highlight stays on the fixed marker at 12 o'clock.

Selection (A/RT) and cancellation (B/X/LT) are unchanged from the list. Menus over 16 items fall back to the list with a warning.

Notable implementation points

Analog input inside an overlay did not previously exist. pollControllers dropped all axis input whenever an overlay was visible. That branch now forwards the dominant thumbstick to the menu before returning, with its own larger deadzone (0.4 vs the 0.1 tuned for pointer drift) so the highlight does not jitter near centre. Mouse and scroll emission stays suppressed exactly as before.

HUDZoom uses a Layout, not scaleEffect alone. scaleEffect is render-only and leaves the reported layout size untouched — and the panels size themselves from NSHostingView.fittingSize, so they would stay unscaled and clip their contents. Reporting zoom × the ideal size is synchronous and correct on the first layout pass. At zoom == 1 the content is returned untouched, so the default appearance is unchanged.

Also fixes two pre-existing sizing bugs the zoom work surfaced: CustomMenuController.show sized its panel without a layout pass, and HelpController.show never re-fitted at all.

Verification

Automated: config decoding (both menu forms, aliases, bad-value fallback, zoom clamping), 15 assertions on the wheel's aim and rotation math, offscreen renders of both styles, Xcode build, mkdocs build --strict, and a launch smoke test.

Rendering the wheel offscreen caught the hub hints crowding the chips at 3 and 9 o'clock, which is why the ring radius and hub inset are wider than first drafted.

Anything needing a physical controller or a live NSPanel — stick aiming, dpad rotation, on-screen panel sizing at zoom — is listed as a checklist in TO_VERIFY.md.

🤖 Generated with Claude Code