saccade 0.3.0

Visual-regression CLI for renderers and graphics code, built on NVIDIA FLIP
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

//! Automatic accessibility CLI policy mirror.
use crate::agent::CliError;
use std::path::PathBuf;
#[derive(clap::Args)]
pub(crate) struct Args {
    #[command(subcommand)]
    command: Command,
}
#[derive(clap::Subcommand)]
enum Command {
    /// Detect text/UI candidates and check contrast, legibility, glyphs and colour loss offline.
    Auto(AutoArgs),
}
#[derive(Clone, Copy, clap::ValueEnum)]
enum Level {
    Aa,
    Aaa,
}
#[derive(clap::Args)]
struct AutoArgs {
    /// Opaque sRGB image or directory; no regions required.
    input: PathBuf,
    /// Report artifacts directory.
    #[arg(long)]
    out: PathBuf,
    /// Authoritative declared regions, checked separately and overriding overlap.
    #[arg(long)]
    config: Option<PathBuf>,
    /// WCAG text contrast target.
    #[arg(long, value_enum, ignore_case = true, default_value = "AA")]
    level: Level,
    /// Capture pixels per typographic point; omitted scale uses normal-text threshold.
    #[arg(long)]
    px_per_pt: Option<f64>,
    /// Provisioned PaddleOCR cache (default: existing model cache); never downloads.
    #[arg(long)]
    model_cache: Option<PathBuf>,
    /// Print versioned JSON evidence.
    #[arg(long)]
    json: bool,
    /// Optional JUnit (unknown evidence is skipped).
    #[arg(long)]
    junit: Option<PathBuf>,
}
pub(crate) fn run(args: Args) -> Result<u8, CliError> {
    let Command::Auto(a) = args.command;
    #[allow(unused_mut)]
    let mut model_cache = a.model_cache.clone();
    #[cfg(feature = "ocr")]
    if model_cache.is_none() {
        model_cache = Some(saccade_core::media::default_model_dir());
    }
    let options = saccade_a11y::Options {
        config: a.config.clone(),
        level: match a.level {
            Level::Aa => saccade_a11y::auto::Level::AA,
            Level::Aaa => saccade_a11y::auto::Level::AAA,
        },
        px_per_pt: a.px_per_pt.unwrap_or(96. / 72.),
        scale_known: a.px_per_pt.is_some(),
        model_cache: model_cache.clone(),
    };
    let report = saccade_a11y::run(&a.input, &a.out, &options)?;
    if let Some(path) = a.junit.as_deref() {
        let mut inputs = vec![a.input.as_path(), a.out.as_path()];
        if let Some(c) = a.config.as_deref() {
            inputs.push(c);
        }
        if let Some(c) = model_cache.as_deref() {
            inputs.push(c);
        }
        report.junit(path, &inputs)?;
    }
    if a.json {
        let value = summary_result(&serde_json::to_value(&report)?, &a.out)?;
        crate::local_cmd::print(&value, true)?;
    } else {
        crate::emit(&report.text())?;
    }
    Ok(match report.verdict {
        saccade_a11y::auto::Verdict::Pass | saccade_a11y::auto::Verdict::Warn => 0,
        saccade_a11y::auto::Verdict::Fail => 1,
        saccade_a11y::auto::Verdict::Unmeasurable => 4,
    })
}

/// Common CLI/MCP transport: summary in data, full region evidence in the artifact.
pub(crate) fn summary_result(
    value: &serde_json::Value,
    out: &std::path::Path,
) -> Result<serde_json::Value, CliError> {
    let mut result = crate::local_cmd::analysis_result(value, out)?;
    result["data"] = serde_json::json!({
        "verdict": value["verdict"], "scope": value["scope"],
        "images": value["images"].as_array().into_iter().flatten().map(|image| serde_json::json!({
            "name": image["name"], "verdict": image["verdict"], "summary": image["summary"],
            "scope": image["scope"], "limitations": image["limitations"],
        })).collect::<Vec<_>>()
    });
    Ok(result)
}