support-step-recorder-core 0.1.2

//! Modèle de données d'une session de capture.

use serde::{Deserialize, Serialize};

use crate::i18n::Lang;
use crate::input::Button;

/// Informations sur la fenêtre active au moment d'une action.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct WindowInfo {
    pub title: String,
    pub app_name: String,
    pub pid: u32,
    pub x: i32,
    pub y: i32,
    pub width: u32,
    pub height: u32,
}

/// Nature d'une étape enregistrée.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum Action {
    /// Clic souris. Coordonnées globales et relatives à la fenêtre — `None`
    /// quand la plateforme ne les fournit pas (Wayland/evdev).
    Click {
        button: Button,
        #[serde(skip_serializing_if = "Option::is_none")]
        x: Option<i32>,
        #[serde(skip_serializing_if = "Option::is_none")]
        y: Option<i32>,
        #[serde(skip_serializing_if = "Option::is_none")]
        rel_x: Option<i32>,
        #[serde(skip_serializing_if = "Option::is_none")]
        rel_y: Option<i32>,
    },
    /// Texte saisi au clavier (agrégé entre deux clics).
    Text { content: String },
}

/// Une étape de la session : une action, son contexte et sa capture éventuelle.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Step {
    pub index: usize,
    /// Horodatage absolu (ms depuis l'epoch Unix).
    pub timestamp_ms: u128,
    /// Temps écoulé depuis le début de la session (ms).
    pub elapsed_ms: u128,
    pub action: Action,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub window: Option<WindowInfo>,
    /// Nom du fichier WebP de la capture, relatif au dossier de session.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub screenshot: Option<String>,
    /// Description lisible de l'étape, façon MS PSR (dans la langue de la session).
    pub description: String,
}

impl Step {
    /// Construit la description lisible à partir de l'action et du contexte,
    /// dans la langue donnée.
    pub fn build_description(action: &Action, window: Option<&WindowInfo>, lang: Lang) -> String {
        let target = window
            .map(|w| {
                if w.app_name.is_empty() {
                    format!("« {} »", w.title)
                } else {
                    format!("« {} » ({})", w.title, w.app_name)
                }
            })
            .unwrap_or_else(|| match lang {
                Lang::Fr => "la fenêtre active".to_string(),
                Lang::En => "the active window".to_string(),
            });

        match action {
            Action::Click { button, .. } => {
                let b = button.label(lang);
                match lang {
                    Lang::Fr => format!("Clic {b} sur {target}"),
                    Lang::En => format!("{} click on {target}", capitalize(&b)),
                }
            }
            Action::Text { content } => {
                let shown = content.replace('\n', "⏎");
                match lang {
                    Lang::Fr => format!("Saisie « {shown} » dans {target}"),
                    Lang::En => format!("Typed “{shown}” in {target}"),
                }
            }
        }
    }
}

/// Met la première lettre en majuscule (« left » → « Left »).
fn capitalize(s: &str) -> String {
    let mut c = s.chars();
    match c.next() {
        Some(f) => f.to_uppercase().collect::<String>() + c.as_str(),
        None => String::new(),
    }
}