Simplify the public API into one dense header

yasl.h now holds everything except Vulkan: 45 functions instead of 62,
and three installed headers instead of ten.

- One constructor: yasl_surface_create takes CPU, GL or NATIVE, with
  zero-initialized GL options meaning 3.2 core, RGBA8, D24S8.
- Events carry action, mods, x, y and text at the top level; pen
  positions are now logical like pointer positions.
- yasl_cpu_pixels/yasl_cpu_present draw into one persistent canvas,
  cutting three full-frame copies per frame.
- yasl_surface_get_info, yasl_surface_request, YASL_CURSOR_LOCKED,
  yasl_surface_set_text_input, yasl_surface_begin_move_resize and
  yasl_surface_get_native replace groups of narrower calls.
- Interactive calls drop the decorative trigger event argument.
- yasl_wait_event returns 0 only on timeout or yasl_wake, the refresh
  callback runs only in native modal loops, focus loss sends
  INPUT_RESET, and a lost event no longer fails every later wait.
- Unsupported operations and bad arguments report ENOTSUP and EINVAL
  instead of EIO; the keycodes header no longer needs C23.
- The shared library gets a versioned SONAME and version macros.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 27 insertions, 17 deletions

diff --git a/examples/game.c b/examples/game.c
index 850b39b..89b9f3a 100644
--- a/examples/game.c
+++ b/examples/game.c
@@ -1,8 +1,8 @@
 /* GPU example: the application owns context binding, drawing and swap pacing. */
 #include <yasl/yasl.h>
-#include <yasl/gl.h>
-#include <stdio.h>
+#include <errno.h>
 #include <math.h>
+#include <stdio.h>
 #include <string.h>
 
 typedef void (*clear_color_fn)(float, float, float, float);
@@ -12,11 +12,10 @@ typedef void (*viewport_fn)(int, int, int, int);
 int main(int argc, char **argv)
 {
     bool smoke = argc == 2 && !strcmp(argv[1], "--smoke-test");
-    yasl_surface *s = yasl_gl_surface_create(&(struct yasl_surface_options){.title="YASL OpenGL", .width=800, .height=600, .type=YASL_SURFACE_NATIVE, .flags=0}, NULL);
-    if (!s || (yasl_gl_make_current(s) < 0)) {
-        const char *error;
-        error = strerror(errno);
-        fprintf(stderr, "%s\n", error);
+    yasl_surface *s = yasl_surface_create(&(struct yasl_surface_options){
+        .title = "YASL OpenGL", .width = 800, .height = 600, .type = YASL_SURFACE_GL});
+    if (!s || yasl_gl_make_current(s) < 0) {
+        fprintf(stderr, "%s\n", strerror(errno));
         yasl_shutdown();
         return 1;
     }
@@ -34,23 +33,34 @@ int main(int argc, char **argv)
         /* Drain events before each frame; while the display is gone, block until it returns. */
         yasl_event e;
         int n = yasl_wait_event(&e, online ? 0 : -1);
-        if (n < 0) { result = 1; break; }
+        if (n < 0) {
+            result = 1;
+            break;
+        }
         if (e.type == YASL_EVENT_CLOSE || e.type == YASL_EVENT_QUIT ||
-            (e.type == YASL_EVENT_KEY && e.key.key == YASL_KEY_ESCAPE)) running = false;
-        if (e.type == YASL_EVENT_DISPLAY_LOST) online = false;
+            (e.type == YASL_EVENT_KEY && e.key.key == YASL_KEY_ESCAPE))
+            running = false;
+        if (e.type == YASL_EVENT_DISPLAY_LOST) {
+            yasl_gl_make_current(NULL);
+            online = false;
+        }
         if (e.type == YASL_EVENT_DISPLAY_RESTORED) {
             /* The context is new: bind it again and restore GL state here. */
-            online = (yasl_gl_make_current(s) == 0) && (yasl_gl_set_swap_interval(s, 1) == 0);
+            online = yasl_gl_make_current(s) == 0 && yasl_gl_set_swap_interval(s, 1) == 0;
         }
-        if (n > 0 || !online || !running) continue;
-        int w, h;
-        yasl_surface_get_framebuffer_size(s, &w, &h);
-        viewport(0, 0, w, h);
+        if (n > 0 || !online || !running)
+            continue;
+        struct yasl_surface_info info = yasl_surface_get_info(s);
+        viewport(0, 0, info.pixel_width, info.pixel_height);
         double t = yasl_time_ns() / 1e9;
         clear_color((float)(0.3 + 0.2 * sin(t)), 0.2f, 0.4f, 1);
         clear(0x00004000u);
-        if ((yasl_gl_present(s) < 0)) { result = 1; break; }
-        if (smoke && ++frames == 3) break;
+        if (yasl_gl_present(s) < 0) {
+            result = 1;
+            break;
+        }
+        if (smoke && ++frames == 3)
+            break;
     }
     yasl_gl_make_current(NULL);
     yasl_shutdown();