feat(console): full gamepad shell — hosts, PIN pairing, settings, OSK, screen transitions

The Skia console UI grows from the single library coverflow into a complete
couch shell (Apple gamepad-UI parity), so a Deck/gamescope session is
self-sufficient end to end:

- Home: host carousel (saved + discovered + Add Host tile) with presence
  pips, paired locks, wake & connect; A/Y/X/B per the Apple launcher.
- In-console SPAKE2 PIN pairing (previously needed the Decky plugin or a
  desktop), add-host with a controller keyboard, couch settings over the
  shared Settings store, wake-on-LAN overlay with retry, cancelable dials.
- Shell chrome: screen stack with push/pop entrance/exit choreography
  (slide + fade + recede; aurora↔form backdrop crossfade), per-pad button
  glyphs (PS shapes vs ABXY, keycaps with no pad), menu haptics, toasts,
  embedded Geist typography, in-stream start banner.
- Steam Deck: our OSK never draws — fields start SDL text input (the new
  Overlay::text_input_active hook) and Steam's keyboard types; a hint chip
  points at STEAM + X. Other Linux gets the full gamepad keyboard tray.
- punktfunk-session: bare --browse opens Home; --browse host opens that
  host's library with Home behind it (Decky launches keep working, B now
  pops instead of quitting). Service threads run discovery, 10 s probes,
  pairing, wake loops, fetches, and known-hosts persistence.
- Presenter contract: Launch actions carry the host, CancelConnect never
  engages a won race, pad kind/list ride FrameCtx, menu events flow while
  dialing so B can cancel.

Every screen renders to PNG on CPU raster for review
(PF_CONSOLE_DUMP=<dir> cargo test -p pf-console-ui -- --ignored dump).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

crates/pf-presenter/src/overlay.rs

@@ -7,6 +7,7 @@
 
 use ash::vk;
 use pf_client_core::gamepad::{MenuEvent, MenuPulse};
+use punktfunk_core::config::GamepadPref;
 
 /// The presenter's device, shared with the overlay so its renderer (Skia's
 /// `DirectContext`) creates resources on the same VkDevice/queue. Handles stay valid for
@@ -34,6 +35,11 @@ pub struct FrameCtx<'a> {
     pub hint: Option<&'a str>,
     /// The active gamepad's name (the console library's controller chip).
     pub pad: Option<&'a str>,
+    /// The active pad's resolved kind — drives the console UI's button glyphs
+    /// (PlayStation shapes for DualSense/DualShock, ABXY letters otherwise).
+    pub pad_pref: Option<GamepadPref>,
+    /// Every connected pad (the console settings' "Use controller" row).
+    pub pads: &'a [pf_client_core::gamepad::PadInfo],
 }
 
 /// One overlay image ready to composite: RGBA, PREMULTIPLIED alpha, already in
@@ -46,13 +52,22 @@ pub struct OverlayFrame {
     pub height: u32,
 }
 
-/// An action the overlay raises out of its input handling (browse mode: the console
-/// library's A/B/retry). The run loop hands each to the session binary's callback.
+/// An action the overlay raises out of its input handling (browse mode). Only actions
+/// the RUN LOOP must act on live here — starting/canceling sessions and quitting; data
+/// work (pairing, discovery, library fetches…) rides the console command bus instead.
 pub enum OverlayAction {
-    /// Launch this library title as a session (`id` rides the Hello).
-    Launch { id: String, title: String },
-    /// Retry whatever failed (the library fetch).
-    Retry,
+    /// Start a session on this host. `launch` carries a library title id on the Hello
+    /// (`None` streams the desktop); `title` is display-only (window title).
+    Launch {
+        addr: String,
+        port: u16,
+        fp_hex: String,
+        launch: Option<String>,
+        title: String,
+    },
+    /// Abort an in-flight connect (B while Connecting) — the console keeps browsing.
+    /// The run loop stops the pump; a dial that already won the race is quit-closed.
+    CancelConnect,
     /// Quit the launcher (B at the root) — ends the process, Gaming Mode returns.
     Quit,
 }
@@ -95,6 +110,13 @@ pub trait Overlay {
     /// A session lifecycle edge (browse mode scene driving).
     fn session_phase(&mut self, _phase: SessionPhase) {}
 
+    /// True while a text field is being edited — the run loop starts/stops SDL text
+    /// input to match (IME + `Event::TextInput` delivery on desktop; under gamescope
+    /// this is also what lets Steam's on-screen keyboard type into the app).
+    fn text_input_active(&self) -> bool {
+        false
+    }
+
     /// Once per presenter iteration. Damage-driven: re-render (flush + transition to
     /// SHADER_READ_ONLY) only when the content or size changed, else return the previous
     /// image. `None` = nothing to composite. The returned image must stay untouched