windui 0.8.3

//! 跨线程唤醒原语：Waker 延迟绑定平台句柄，窗口建好前的 wake 走 pending 兜底。
use std::sync::atomic::{AtomicBool, Ordering};
use std::sync::{Arc, Mutex};

/// 平台唤醒句柄：win32 持 HWND 数值并 post 自定义消息、macOS dispatch。Send 由各实现保证。
pub(crate) trait RawWakeSignal: Send {
    fn signal(&self);
}
pub(crate) type RawWake = Box<dyn RawWakeSignal>;

pub use std::sync::mpsc::SendError;

/// 跨线程消息发送端：Send + Sync + Clone。send = 入队 + 唤醒 UI 一帧。
pub struct Sender<Msg> {
    tx: std::sync::mpsc::Sender<Msg>,
    waker: Waker,
}

impl<Msg> Clone for Sender<Msg> {
    fn clone(&self) -> Self {
        Self {
            tx: self.tx.clone(),
            waker: self.waker.clone(),
        }
    }
}

impl<Msg> Sender<Msg> {
    /// 入队一条消息并唤醒 UI 一帧。接收端（窗口）已关闭时返回 Err。
    pub fn send(&self, msg: Msg) -> Result<(), SendError<Msg>> {
        self.tx.send(msg)?;
        self.waker.wake();
        Ok(())
    }
}

/// 建一个 typed channel：返回发送端 + 类型擦除的排空 pump（供 UiHost 每帧调用）。
pub(crate) fn new_channel<Msg: Send + 'static>(
    waker: Waker,
    mut on_message: impl FnMut(Msg) + 'static,
) -> (Sender<Msg>, Box<dyn FnMut()>) {
    let (tx, rx) = std::sync::mpsc::channel::<Msg>();
    let pump: Box<dyn FnMut()> = Box::new(move || {
        while let Ok(m) = rx.try_recv() {
            on_message(m);
        }
    });
    (Sender { tx, waker }, pump)
}

pub(crate) struct WakerShared {
    raw: Mutex<Option<RawWake>>,
    pending: AtomicBool,
}

/// 跨线程唤醒句柄：Send + Sync + Clone，交后台线程。
#[derive(Clone)]
pub struct Waker {
    inner: Arc<WakerShared>,
}

impl WakerShared {
    pub(crate) fn new() -> Arc<Self> {
        Arc::new(Self {
            raw: Mutex::new(None),
            pending: AtomicBool::new(false),
        })
    }
    /// 窗口建好后回填平台句柄；若此前有积压 wake，立即补发一次。
    pub(crate) fn bind(self: &Arc<Self>, raw: RawWake) {
        // 全程持锁：与同样持锁的 wake() 串行化 raw 的读写，消除「pending 已读、raw 未装」的窗口。
        let mut guard = self.raw.lock().unwrap();
        *guard = Some(raw);
        if self.pending.swap(false, Ordering::SeqCst) {
            guard.as_ref().unwrap().signal();
        }
    }
    pub(crate) fn waker(self: &Arc<Self>) -> Waker {
        Waker {
            inner: self.clone(),
        }
    }
}

impl Waker {
    /// 唤醒 UI 一帧。句柄未绑定（run 前）时置 pending，绑定时补发。
    pub fn wake(&self) {
        let guard = self.inner.raw.lock().unwrap();
        match guard.as_ref() {
            Some(raw) => raw.signal(),
            None => self.inner.pending.store(true, Ordering::SeqCst),
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::sync::atomic::AtomicU32;

    struct CountSignal(Arc<AtomicU32>);
    impl RawWakeSignal for CountSignal {
        fn signal(&self) {
            self.0.fetch_add(1, Ordering::SeqCst);
        }
    }

    #[test]
    fn wake_before_bind_is_pending_then_flushed() {
        let shared = WakerShared::new();
        let waker = shared.waker();
        waker.wake(); // 未绑定 → pending
        let count = Arc::new(AtomicU32::new(0));
        shared.bind(Box::new(CountSignal(count.clone())));
        assert_eq!(count.load(Ordering::SeqCst), 1, "绑定时补发积压 wake");
        waker.wake(); // 已绑定 → 直接 signal
        assert_eq!(count.load(Ordering::SeqCst), 2);
    }

    #[test]
    fn waker_is_send_sync() {
        fn assert_send_sync<T: Send + Sync>() {}
        assert_send_sync::<Waker>();
    }

    #[test]
    fn channel_pump_drains_in_order_across_thread() {
        let shared = WakerShared::new();
        let got = std::rc::Rc::new(std::cell::RefCell::new(Vec::<u32>::new()));
        let g2 = got.clone();
        let (tx, mut pump) = new_channel::<u32>(shared.waker(), move |m| g2.borrow_mut().push(m));
        let t = std::thread::spawn(move || {
            tx.send(1).unwrap();
            tx.send(2).unwrap();
            tx.send(3).unwrap();
        });
        t.join().unwrap();
        pump();
        assert_eq!(*got.borrow(), vec![1, 2, 3]);
    }

    #[test]
    fn send_after_receiver_dropped_errs() {
        let shared = WakerShared::new();
        let (tx, pump) = new_channel::<u32>(shared.waker(), |_| {});
        drop(pump); // 接收端 rx 随 pump 一起销毁
        assert!(tx.send(9).is_err(), "接收端关闭后 send 返回 Err");
    }
}