cotis-modules-debug 0.1.0-alpha

//! Capture and replay layout-module output for debugging.
//!
//! - [`store_computed_layout`] / [`load_computed_layout`] — JSON file I/O for layout output.
//! - [`capture::LayoutModuleCapture`] — wraps a [`LayoutManager`](cotis::layout::LayoutManager)
//!   and records per-frame output (stage 1).
//! - [`isolated_replay::LayoutModuleReplay`] — replays a stored declaration through a layout
//!   module without [`CotisApp`](cotis::cotis_app::CotisApp) (alternative to stage-2 `UiFn`).

use std::path::Path;

use serde::Serialize;
use serde::de::DeserializeOwned;

pub mod capture;

pub mod isolated_replay;

/// Writes a vector of layout outputs to a JSON file.
///
/// Typically used after a record pass to persist
/// [`LayoutModuleCapture::output`](capture::LayoutModuleCapture::output).
///
/// # Errors
///
/// Returns an error if JSON serialization or file writing fails.
pub fn store_computed_layout<ElementsOutput: Clone + Serialize>(
    res: &Vec<ElementsOutput>,
    file: &Path,
) -> Result<(), Box<dyn std::error::Error>> {
    let bytes = serde_json::to_vec(res)?;
    std::fs::write(file, bytes)?;
    Ok(())
}

/// Loads a vector of layout outputs from a JSON file.
///
/// Used in stage 3 (render-only) to skip the layout manager and feed precomputed output
/// directly into a render pipe.
///
/// # Errors
///
/// Returns an error if file reading or JSON deserialization fails.
pub fn load_computed_layout<ElementsOutput: Clone + DeserializeOwned>(
    file: &Path,
) -> Result<Vec<ElementsOutput>, Box<dyn std::error::Error>> {
    let bytes = std::fs::read(file)?;
    let serialized: Vec<ElementsOutput> = serde_json::from_slice(&bytes)?;
    Ok(serialized)
}