cvkg-compositor 0.3.4

//! # CVKG Compositor
//!
//! Retained-mode layer orchestration engine for the CVKG UI framework.
//!
//! The compositor sits between `cvkg-vdom` and `cvkg-render-gpu`, providing:
//! - **Material Routing**: Organizes draw calls into GPU pass buckets (scene, glass, overlay).
//! - **Damage Tracking**: Tracks which layers changed to avoid re-recording static content.
//! - **Layer Orchestration**: Maintains a retained `LayerTree` with Z-sorting and hierarchy.
//!
//! ## Architecture
//!
//! ```text
//! VDom → LayerTreeBuilder → CompositorEngine → GpuRenderer
//!                                    │
//!                          ┌─────────┼─────────┐
//!                          ▼         ▼         ▼
//!                     scene_cmds  glass_cmds  overlay_cmds
//!                          │         │         │
//!                          ▼         ▼         ▼
//!                     ┌─────────────────────────────┐
//!                     │  Backdrop Capture Pipeline  │
//!                     │  (Scene→Blur→Composite→UI)  │
//!                     └─────────────────────────────┘
//! ```

pub mod engine;
pub mod layer;
pub mod template;

// Re-export primary types for convenience.
pub use engine::{CommandBuckets, CompositorEngine, DamageInfo, RenderCommand, RoutedDrawCommand};
pub use layer::{DrawCommand, Layer, LayerId, LayerTree, Material};
pub use template::{RenderTemplate, TemplateError};

/// Current version of the cvkg-compositor crate.
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

#[cfg(test)]
mod smoke_tests {
    use super::*;

    #[test]
    fn compositor_engine_constructs() {
        let engine = CompositorEngine::new();
        let _ = engine; // just verify it constructs without panicking
    }

    #[test]
    fn command_buckets_default_is_empty() {
        let buckets = CommandBuckets::default();
        assert!(buckets.is_empty());
        assert_eq!(buckets.total_count(), 0);
    }

    #[test]
    fn damage_info_default() {
        let damage = DamageInfo::default();
        assert!(damage.dirty_layers.is_empty());
        assert_eq!(damage.frame_generation, 0);
        assert!(!damage.full_rebuild_needed);
    }
}