blinc_app 0.5.1

//! Fuchsia application runner
//!
//! Provides a unified API for running Blinc applications on Fuchsia OS.
//!
//! # Example
//!
//! ```ignore
//! use blinc_app::prelude::*;
//! use blinc_app::fuchsia::FuchsiaApp;
//!
//! #[no_mangle]
//! fn main() {
//!     FuchsiaApp::run(|ctx| {
//!         div().w(ctx.width).h(ctx.height)
//!             .bg([0.1, 0.1, 0.15, 1.0])
//!             .flex_center()
//!             .child(text("Hello Fuchsia!").size(48.0))
//!     }).unwrap();
//! }
//! ```
//!
//! # Architecture
//!
//! Fuchsia applications integrate with the system through:
//!
//! - **Scenic/Flatland** - Window compositing via Views
//! - **fuchsia-async** - Async executor for event handling
//! - **FIDL** - IPC with system services
//! - **Vulkan** - GPU rendering via ImagePipe2
//!
//! # Building
//!
//! Requires the Fuchsia SDK and target:
//!
//! ```bash
//! rustup target add x86_64-unknown-fuchsia
//! cargo build --target x86_64-unknown-fuchsia --features fuchsia
//! ```

use blinc_layout::prelude::*;
use blinc_platform_fuchsia::FuchsiaPlatform;

use crate::error::{BlincError, Result};
use crate::windowed::WindowedContext;

/// Fuchsia application runner
///
/// Provides a simple way to run a Blinc application on Fuchsia OS
/// with automatic event handling and rendering via Scenic.
pub struct FuchsiaApp;

impl FuchsiaApp {
    /// Run a Fuchsia Blinc application
    ///
    /// This is the main entry point for Fuchsia applications. It sets up
    /// the GPU renderer via Scenic, handles lifecycle events, and runs the event loop.
    ///
    /// # Arguments
    ///
    /// * `ui_builder` - Function that builds the UI tree given the window context
    ///
    /// # Example
    ///
    /// ```ignore
    /// FuchsiaApp::run(|ctx| {
    ///     div()
    ///         .w(ctx.width).h(ctx.height)
    ///         .bg([0.1, 0.1, 0.15, 1.0])
    ///         .flex_center()
    ///         .child(text("Hello Fuchsia!").size(32.0))
    /// })
    /// ```
    #[cfg(target_os = "fuchsia")]
    pub fn run<F, E>(mut ui_builder: F) -> Result<()>
    where
        F: FnMut(&mut WindowedContext) -> E + 'static,
        E: ElementBuilder + 'static,
    {
        // Initialize logging
        let _ = tracing_subscriber::fmt()
            .with_max_level(tracing::Level::INFO)
            .try_init();

        tracing::info!("FuchsiaApp::run starting");
        tracing::info!("Fuchsia platform support is currently a stub implementation");
        tracing::info!("Full Fuchsia integration requires building within the Fuchsia tree");

        // For now, print a message and return success
        // Full implementation requires:
        // 1. Scenic/Flatland integration for window compositing
        // 2. FIDL bindings for system services
        // 3. Vulkan surface via ImagePipe2
        // 4. async event loop with fuchsia-async

        // Placeholder: just log that we'd run the UI
        tracing::info!("Would run UI with dimensions from Scenic view properties");
        tracing::info!("Touch/mouse input would come from fuchsia.ui.pointer");
        tracing::info!("Frame scheduling via Flatland.OnNextFrameBegin");

        // Return success - app "ran" (stub)
        Ok(())
    }

    /// Placeholder for non-Fuchsia builds
    #[cfg(not(target_os = "fuchsia"))]
    pub fn run<F, E>(_ui_builder: F) -> Result<()>
    where
        F: FnMut(&mut WindowedContext) -> E + 'static,
        E: ElementBuilder + 'static,
    {
        Err(BlincError::PlatformUnsupported(
            "Fuchsia apps can only run on Fuchsia OS".to_string(),
        ))
    }

    /// Get the system font paths for Fuchsia
    pub fn system_font_paths() -> &'static [&'static str] {
        FuchsiaPlatform::system_font_paths()
    }
}