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, 29 insertions, 23 deletions

diff --git a/examples/simple_window.c b/examples/simple_window.c
index 4b4b552..f85abd4 100644
--- a/examples/simple_window.c
+++ b/examples/simple_window.c
@@ -1,51 +1,57 @@
 /* Mouse and pen input on a CPU surface. */
 #include <yasl/yasl.h>
-#include <yasl/cpu.h>
 #include <string.h>
 
 int main(int argc, char **argv)
 {
     bool smoke = argc == 2 && !strcmp(argv[1], "--smoke-test");
-    yasl_surface *s = yasl_surface_create(&(struct yasl_surface_options){.title="YASL input", .width=640, .height=480, .type=YASL_SURFACE_CPU, .flags=0});
-    if (!s) return 1;
+    yasl_surface *s = yasl_surface_create(
+        &(struct yasl_surface_options){.title = "YASL input", .width = 640, .height = 480});
+    if (!s)
+        return 1;
     double px = -100, py = -100, pressure = 0;
     bool dirty = false;
     int frames = 0, result = 1;
     yasl_event e;
     for (;;) {
         int n = yasl_wait_event(&e, smoke ? 20 : -1);
-        if (n < 0) break;
+        if (n < 0)
+            break;
         if (e.type == YASL_EVENT_CLOSE || e.type == YASL_EVENT_QUIT ||
-            (e.type == YASL_EVENT_KEY && e.key.key == YASL_KEY_ESCAPE)) { result = 0; break; }
-        if (e.type == YASL_EVENT_POINTER) {
-            px = e.pointer.x; py = e.pointer.y;
-            pressure = (e.pointer.buttons & YASL_BUTTON_BIT(YASL_BUTTON_PRIMARY)) ? 0.5 : 0;
-            dirty = true;
+            (e.type == YASL_EVENT_KEY && e.key.key == YASL_KEY_ESCAPE)) {
+            result = 0;
+            break;
         }
-        if (e.type == YASL_EVENT_PEN) {
-            px = e.pen.x; py = e.pen.y;
-            pressure = (e.pen.axes_valid & YASL_PEN_PRESSURE) ? e.pen.pressure : 0;
+        if (e.type == YASL_EVENT_POINTER || e.type == YASL_EVENT_PEN) {
+            px = e.x;
+            py = e.y;
+            pressure = e.type == YASL_EVENT_PEN ? ((e.pen.axes & YASL_PEN_PRESSURE) ? e.pen.pressure : 0)
+                       : (e.pointer.buttons & YASL_BUTTON_BIT(YASL_BUTTON_PRIMARY)) ? 0.5
+                                                                                      : 0;
             dirty = true;
         }
-        if (e.type == YASL_EVENT_REFRESH) dirty = true;
+        if (e.type == YASL_EVENT_REFRESH)
+            dirty = true;
         if (dirty) {
-            struct yasl_cpu_buffer buffer;
-            int acquired = yasl_cpu_acquire(s, &buffer);
-            int w = buffer.width, h = buffer.height;
-            uint32_t *pixels = acquired == 0 ? buffer.pixels : NULL;
-            if (!pixels) break;
-            double scale = yasl_surface_get_scale(s), radius = (8 + pressure * 48) * scale;
-            for (int y = 0; y < h; y++) {
+            int w, h;
+            uint32_t *pixels = yasl_cpu_pixels(s, &w, &h);
+            if (!pixels)
+                break;
+            double scale = yasl_surface_get_info(s).scale, radius = (8 + pressure * 48) * scale;
+            for (int y = 0; y < h; y++)
                 for (int x = 0; x < w; x++) {
                     double dx = x - px * scale, dy = y - py * scale;
                     pixels[(size_t)y * w + x] = dx * dx + dy * dy < radius * radius ? 0xffffc060u : 0xff203040u;
                 }
-            }
-            if ((yasl_cpu_present(s, &buffer) < 0)) break;
+            if (yasl_cpu_present(s) < 0)
+                break;
             dirty = false;
             frames++;
         }
-        if (smoke && frames && n == 0) { result = 0; break; }
+        if (smoke && frames && n == 0) {
+            result = 0;
+            break;
+        }
     }
     yasl_shutdown();
     return result;