feat(gui): Sorry -- an apology app with a live parametric heart

A new desktop app whose whole point is to say sorry, and to look like
saying it took effort. Nothing in it is a static bitmap.

The heart is the classic parametric heart curve, x = 16sin^3(t) and
y = 13cos(t) - 5cos(2t) - 2cos(3t) - cos(4t), precomputed as a 96-point
integer polygon normalised to a half-width of 1000 and scanline-filled at
whatever size the beat currently has it at. Even-odd crossing counting is
what keeps the notch between the lobes open. The beat is a two-thump
cardiac envelope -- a strong systolic beat and a softer echo -- and the
fill carries a vertical gradient, a soft specular highlight on the upper
lobe, and a six-layer glow. The kernel is built -mno-sse with no floating
point, so every curve, gradient, easing and physics step is integer-only
and needs no trigonometry at runtime.

Around it: three apology letters that type themselves out a character at
a time, and a slow drift of small hearts using the same fill routine.
Answering "I forgive you" brightens the heart and bursts the drift
outward; answering "Not yet" dims it, slows the beat, and starts an
honest count of how long it has been waiting. Neither answer is an exit.

Supporting changes, all of them general rather than app-specific:

  - gui_desktop_request_animation_frame(), so an app can opt into
    full-rate recompositing instead of the ~10 Hz live-content
    heartbeat. It is renewed per paint, so it lapses by itself when the
    app stops animating or its window closes.
  - gui_button_styled() and gui_hitzone() in SUB-WT, letting an app with
    its own palette keep the toolkit's click handling. gui_button_colored
    is now a thin wrapper over the former.
  - A heart glyph in the icon set.

The glow layers skip whatever the heart body is about to cover, which
cuts their blended-pixel cost by roughly 3.5x and pays for the extra
layers that turn contour rings into a smooth halo.

Verified in QEMU on x86_64: all three states driven by real clicks --
hover, forgiveness (brighter heart, burst, live typewriter) and waiting
(dimmed heart, slower beat, running counter). Builds clean on x86_64,
aarch64 and armv8i.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Fh5z6V7nGPbHvqVG5p4CXX

include/gui/gui_apps.h

@@ -14,5 +14,6 @@ void gui_app_rustlab_launch(int x, int y, int w, int h);
 void gui_app_objbrowse_launch(int x, int y, int w, int h);
 void gui_app_regedit_launch(int x, int y, int w, int h);
 void gui_app_analytics_launch(int x, int y, int w, int h);
+void gui_app_sorry_launch(int x, int y, int w, int h);
 
 #endif // _GUI_APPS_H

include/gui/gui_desktop.h

@@ -32,6 +32,13 @@ bool gui_desktop_handle_click(int mx, int my);
 // Height of the area windows may occupy (screen minus taskbar).
 int  gui_desktop_workarea_height(void);
 
+// An app that animates continuously calls this from its paint routine to ask
+// for a full-rate recomposite instead of the ~10 Hz live-content heartbeat.
+// The request covers only the next frame, so it has to be renewed on every
+// paint; it therefore lapses by itself when the app stops animating or its
+// window closes, and the compositor goes straight back to idling cheaply.
+void gui_desktop_request_animation_frame(void);
+
 // Wallpaper grid overlay (also toggled from the desktop context menu).
 void gui_desktop_set_grid(bool on);
 bool gui_desktop_get_grid(void);

include/gui/gui_icons.h

@@ -25,6 +25,7 @@ typedef enum {
     GUI_ICON_FILE,
     GUI_ICON_POWER,
     GUI_ICON_WARNING,
+    GUI_ICON_HEART,
     GUI_ICON_COUNT
 } gui_icon_id_t;
 

include/gui/gui_widgets.h

@@ -75,6 +75,18 @@ void gui_badge(int x, int y, const char* text, uint32_t bg, uint32_t fg);
 // within one window.
 bool gui_button(int id, int x, int y, int w, int h, const char* label);
 bool gui_button_colored(int id, int x, int y, int w, int h, const char* label, uint32_t accent);
+
+// Fully styled variant, for apps that paint their own palette instead of
+// inheriting the desktop's slate theme. The three faces cover the idle,
+// hovered and pressed states.
+bool gui_button_styled(int id, int x, int y, int w, int h, const char* label,
+                       uint32_t face, uint32_t face_hover, uint32_t face_press,
+                       uint32_t border, uint32_t text);
+
+// Claims a click inside a rectangle without drawing anything, so an app can
+// make a custom-drawn region clickable. Place it after the real controls: a
+// widget only ever sees a click no earlier widget already claimed.
+bool gui_hitzone(int id, int x, int y, int w, int h);
 bool gui_checkbox(int id, int x, int y, const char* label, bool* value);
 bool gui_radio(int id, int x, int y, const char* label, int* selected, int this_value);
 bool gui_slider(int id, int x, int y, int w, int* value, int min_val, int max_val);