refactor: simplify public API and isolate native extensions

Separate loop/timer and native interoperability APIs from the portable surface header. Unify dispatch, geometry queries, and timer callbacks; keep framebuffer bookkeeping and frame clocks private, and hide implementation symbols.

Update backends, documentation, examples, and API/integration coverage. Verify exports, strict C/C++ installed consumers, and normal plus ASan/UBSan suites.

1 files changed, 8 insertions, 1 deletions

diff --git a/tests/helpers/run_backends.py b/tests/helpers/run_backends.py
index 9ad9b0d..8c5428a 100644
--- a/tests/helpers/run_backends.py
+++ b/tests/helpers/run_backends.py
@@ -21,7 +21,7 @@ def wait_for(process, ready):
 
 
 def main():
-    weston, xwayland, test = sys.argv[1:]
+    weston, xwayland, test, timers = sys.argv[1:]
     servers = []
     with tempfile.TemporaryDirectory(prefix="yasl-backends-") as directory:
         root = Path(directory)
@@ -73,6 +73,13 @@ def main():
                 run("failure", 2, DISPLAY=":59999")
                 run("failure", 0, WAYLAND_DISPLAY="missing-socket", DISPLAY=":59999")
                 run("mixed")
+                print("Test: Wayland surface timers", flush=True)
+                subprocess.run([timers], env=env, check=True, timeout=8)
+                x_env = env.copy()
+                x_env.pop("WAYLAND_DISPLAY", None)
+                x_env["XDG_SESSION_TYPE"] = "x11"
+                print("Test: X11 surface timers", flush=True)
+                subprocess.run([timers], env=x_env, check=True, timeout=8)
             except BaseException:
                 for log in (wl_log, x_log):
                     log.flush()