Skip to main content

qualia_client_core/
canvas_state.rs

1//! Runtime Chora navigation state (active world + temporal scrub position).
2
3use std::fs;
4use std::path::{Path, PathBuf};
5
6use serde::{Deserialize, Serialize};
7
8pub const STATE_FILE: &str = "wellfair/canvas_state.json";
9
10#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
11pub struct CanvasNavigationState {
12    pub active_world_id: String,
13    /// Current temporal scrub position (unix seconds).
14    pub temporal_t: u64,
15    /// Spawn/decay ramp duration (seconds).
16    #[serde(default = "default_ramp")]
17    pub ramp_secs: u64,
18}
19
20fn default_ramp() -> u64 {
21    86_400 // one day fade
22}
23
24impl Default for CanvasNavigationState {
25    fn default() -> Self {
26        Self {
27            active_world_id: "q42:world:demo-offline".to_string(),
28            temporal_t: 1_750_000_000,
29            ramp_secs: default_ramp(),
30        }
31    }
32}
33
34/// Loads.
35pub fn load(storage_root: impl AsRef<Path>) -> CanvasNavigationState {
36    let path = storage_root.as_ref().join(STATE_FILE);
37    match fs::read(&path) {
38        Ok(bytes) => serde_json::from_slice(&bytes).unwrap_or_default(),
39        Err(_) => CanvasNavigationState::default(),
40    }
41}
42
43/// Saves.
44pub fn save(storage_root: impl AsRef<Path>, state: &CanvasNavigationState) -> std::io::Result<()> {
45    let path: PathBuf = storage_root.as_ref().join(STATE_FILE);
46    if let Some(parent) = path.parent() {
47        fs::create_dir_all(parent)?;
48    }
49    let tmp = path.with_extension("json.tmp");
50    let json =
51        serde_json::to_vec_pretty(state).map_err(|e| std::io::Error::other(e.to_string()))?;
52    fs::write(&tmp, &json)?;
53    fs::rename(&tmp, &path)?;
54    Ok(())
55}
56
57#[cfg(test)]
58mod tests {
59    use super::*;
60
61    #[test]
62    fn roundtrip() {
63        let dir = std::env::temp_dir().join(format!("chora-state-{}", std::process::id()));
64        let _ = fs::remove_dir_all(&dir);
65        let mut s = CanvasNavigationState::default();
66        s.temporal_t = 999;
67        save(&dir, &s).unwrap();
68        assert_eq!(load(&dir).temporal_t, 999);
69        let _ = fs::remove_dir_all(&dir);
70    }
71}