From 1ab3e5a123109704789c2768e11a4f9af515821d Mon Sep 17 00:00:00 2001 From: Berke Güzel Date: Wed, 14 Oct 2026 13:13:52 +0300 Subject: Redefine public and rendering APIs with explicit contracts --- include/yasl/native/cocoa.h | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) (limited to 'include/yasl/native/cocoa.h') diff --git a/include/yasl/native/cocoa.h b/include/yasl/native/cocoa.h index bd92c98..2d2d432 100644 --- a/include/yasl/native/cocoa.h +++ b/include/yasl/native/cocoa.h @@ -1,3 +1,4 @@ +/** @file Borrowed cocoa handles for an initialized, connected surface. */ #ifndef YASL_NATIVE_COCOA_H #define YASL_NATIVE_COCOA_H #include "yasl/yasl.h" @@ -13,10 +14,16 @@ typedef struct objc_object NSView; #ifdef __cplusplus extern "C" { #endif -/** Borrowed native objects. Use on main thread, never change native ownership. */ -YASL_API NSApplication *yasl_cocoa_application(void); -YASL_API NSWindow *yasl_cocoa_window(const yasl_surface *surface); -YASL_API NSView *yasl_cocoa_view(const yasl_surface *surface); +struct yasl_cocoa_handles { + NSApplication *application; + NSWindow *window; + NSView *view; +}; +/** Owner thread only. Returns -ENOTSUP for another backend and -ENOTCONN + * while disconnected. Clears out on failure. Handles expire on display loss + * or surface destruction; query again after DISPLAY_RESTORED. Never destroy + * borrowed objects or dispatch/close the connection independently. */ +YASL_API int yasl_cocoa_get_native(const yasl_surface *surface, struct yasl_cocoa_handles *out); #ifdef __cplusplus } #endif -- cgit v1.2.3