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, 8 insertions, 13 deletions

diff --git a/include/yasl/vulkan.h b/include/yasl/vulkan.h
index 1a1c5be..079c866 100644
--- a/include/yasl/vulkan.h
+++ b/include/yasl/vulkan.h
@@ -1,4 +1,4 @@
-/** @file Vulkan WSI; YASL tracks the WSI handle, the application owns rendering. */
+/** @file Vulkan window surfaces; the application owns devices and swapchains. */
 #ifndef YASL_VULKAN_H
 #define YASL_VULKAN_H
 #include "yasl/yasl.h"
@@ -6,26 +6,21 @@
 #ifdef __cplusplus
 extern "C" {
 #endif
-YASL_API int yasl_vulkan_init(PFN_vkGetInstanceProcAddr loader);
+/** Instance extensions and flags YASL needs, borrowed until shutdown. Merge
+ * them into your VkInstanceCreateInfo. */
 struct yasl_vulkan_requirements {
     const char *const *extensions;
     uint32_t extension_count;
     VkInstanceCreateFlags flags;
 };
-/** Initialize the loader first. Borrowed extensions live through shutdown;
- * merge them with application extensions before creating the instance.
- * Clears out on failure. */
-YASL_API int yasl_vulkan_get_requirements(const yasl_surface *surface,
-                                          struct yasl_vulkan_requirements *out);
-/** WSI creation retains VkResult semantics. Uses the injected loader.
- * One live VkSurfaceKHR per window; destroy it with yasl_vulkan_destroy_surface
- * before destroying the YASL surface. The application owns swapchains/devices. */
+/** Records the loader and reports the requirements, initializing YASL if needed.
+ * Call before creating the instance. EBUSY while a Vulkan surface exists. */
+YASL_API int yasl_vulkan_init(PFN_vkGetInstanceProcAddr loader, struct yasl_vulkan_requirements *out);
+/** One surface per NATIVE window; returns the VkResult, with errno set on failure. */
 YASL_API VkResult yasl_vulkan_create_surface(yasl_surface *surface, VkInstance instance,
                                              const VkAllocationCallbacks *allocator,
                                              VkSurfaceKHR *out);
-/** Destroy the WSI surface (including while disconnected), releasing the window
- * for another renderer. Destroy dependent swapchains first. Uses the instance
- * and allocation callbacks recorded at creation. No live WSI surface is a no-op. */
+/** Destroy swapchains first. Also works after DISPLAY_LOST; no surface is a no-op. */
 YASL_API int yasl_vulkan_destroy_surface(yasl_surface *surface);
 #ifdef __cplusplus
 }