Сохрани накопленные исправления аудио, async и диагностики

lib/u_async.h

@@ -90,6 +90,7 @@ static inline int uasync_is_running(struct UASYNC* ua) {
 
 // Instance API - основной API для работы с uasync
 struct UASYNC* uasync_create(void);
+// Уничтожение только вне callbacks, после возврата из poll/mainloop.
 void uasync_destroy(struct UASYNC* ua, int close_fds);
 void uasync_mark_running(struct UASYNC* ua);
 void uasync_mark_stopped(struct UASYNC* ua);
@@ -127,14 +128,14 @@ err_t uasync_set_socket_write(struct UASYNC* ua, void* s_id, int enable);
 void uasync_poll(struct UASYNC* ua, int timeout_tb);
 void uasync_drain_immediate(struct UASYNC* ua);
 
-// Mainloop (бесконечный цикл, __noreturn)
+// Цикл до uasync_stop (возвращается после остановки).
 void uasync_mainloop(struct UASYNC* ua);
 void uasync_stop(struct UASYNC* ua);
 
 // Debug statistics
 void uasync_get_stats(struct UASYNC* ua, size_t* timer_alloc, size_t* timer_free, size_t* socket_alloc, size_t* socket_free);
 
-// Lookup socket by file descriptor - returns current pointer even after realloc
+// Handle — кодированный индекс; сохраняется при расширении массива сокетов.
 int uasync_lookup_socket(struct UASYNC* ua, int fd, void** socket_id);
 
 // Print all resources (timers, sockets) for debugging