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, 5 insertions, 1 deletions

diff --git a/src/common/public_internal.h b/src/common/public_internal.h
index 95ecb6d..65be842 100644
--- a/src/common/public_internal.h
+++ b/src/common/public_internal.h
@@ -3,11 +3,15 @@
 #include "yasl/yasl.h"
 #include "common/backend.h"
 struct yasl_private_display *yasl_public_display(void);
+/* Initializes with defaults when needed; false with errno otherwise. */
+bool yasl_public_initialize(void);
 bool yasl_public_owner(void);
+/* Validates a live surface on the owner thread; mutation also refuses inside a refresh callback. */
 bool yasl_public_surface(yasl_surface *, bool mutation);
+/* yasl_public_surface plus a connected display, for requests sent to the server. */
+bool yasl_public_connected(yasl_surface *);
 bool yasl_public_fail(int error);
 int yasl_public_status(bool success);
 int yasl_public_error(int error);
-void yasl_public_register_surface(yasl_surface *, unsigned flags, yasl_surface *parent);
 void yasl_private_surface_notify_refresh(struct yasl_surface *);
 #endif