martensite-devtools 0.12.0

Tracing spans, Tracy/Chrome GPU timestamps, and in-app F12 developer HUD.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! Telemetry and in-app F12 developer HUD.
//!
//! This crate provides two subsystems for the v0.9.0 Developer Experience
//! milestone:
//!
//! - [`tracy`]: Safe, allocation-free profiling span instrumentation that
//!   records region durations into a thread-local ring buffer. The
//!   DevTools overhead gate requires `< 0.1ms` per 60fps frame.
//! - [`hud`]: In-app diagnostic HUD with a rolling 120-frame timing
//!   histogram, dirty rect visualization, and WidgetArena slot
//!   utilization telemetry.
//!
//! # Example
//!
//! ```
//! use martensite_devtools::{tracy, hud::DiagnosticHud};
//!
//! // Profile a layout pass.
//! let _guard = tracy::span("layout_pass");
//!
//! // Record frame timing for the HUD.
//! let mut hud = DiagnosticHud::new();
//! hud.record_frame(martensite_devtools::hud::FrameTiming {
//!     layout_time_ns: 500_000,
//!     paint_time_ns: 300_000,
//!     gpu_wait_time_ns: 100_000,
//!     total_time_ns: 900_000,
//! });
//! ```

#![forbid(unsafe_code)]
#![deny(missing_docs)]

pub mod hud;
pub mod tracy;

#[cfg(test)]
mod tests {
    /// Smoke test verifying the crate compiles with `#![forbid(unsafe_code)]`.
    #[test]
    fn crate_compiles() {
        // Compilation + test execution is the smoke test.
    }
}