teksilo-async-std 0.12.0

// SPDX-License-Identifier: MPL-2.0
// SPDX-FileCopyrightText: 2026 FernTech

//! # teksilo-async-std — async-std reactor for Teksilo's async executor
//!
//! Thin adapter over [`teksilo-async`](teksilo_async). Unlike Tokio, async-std
//! runs a **global** reactor that starts lazily on first use, so no per-tick
//! runtime-context guard is needed: `install_async_async_std()` is exactly
//! [`install_async`](teksilo_async::TeksiloAppBuilderAsyncExt::install_async)
//! plus the async-std dependency in the tree. Native async-std futures
//! (`async_std::task::sleep`, async-std sockets, …) can be `.await`ed directly
//! inside `ctx.spawn_local(...)` bodies — when a leaf future is ready, the
//! global reactor wakes the executor's `Waker` and the loop ticks again.
//!
//! ```ignore
//! use teksilo_async_std::TeksiloAppBuilderAsyncStdExt;
//! TeksiloAppBuilder::new().install_async_async_std() /* ... */ .run();
//!
//! ctx.spawn_local(async move {
//!     async_std::task::sleep(std::time::Duration::from_secs(1)).await;
//!     status.set("done".into());
//! })
//! .detach();
//! ```

use teksilo_app::TeksiloAppBuilder;
use teksilo_async::TeksiloAppBuilderAsyncExt;

// Re-export the spawn surface so `use teksilo_async_std::*;` is enough for
// crate users that don't go through the `teksilo` umbrella prelude.
pub use teksilo_async::{EventContextAsyncExt, TaskHandle, spawn_blocking};

/// Adds [`install_async_async_std`](TeksiloAppBuilderAsyncStdExt::install_async_async_std)
/// to the app builder.
pub trait TeksiloAppBuilderAsyncStdExt {
    /// Install the main-thread executor for use with async-std futures. Since
    /// async-std's reactor is global and auto-starting, this is `install_async`
    /// — the value of this crate is pulling async-std into the dependency tree
    /// and providing a discoverable, parallel entry point to `teksilo-tokio`.
    fn install_async_async_std(self) -> Self;
}

impl TeksiloAppBuilderAsyncStdExt for TeksiloAppBuilder {
    fn install_async_async_std(self) -> Self {
        self.install_async()
    }
}