day-cli 0.3.0

Declarative app development API using native UI toolkits
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

// Copyright © The Daybrite Project
// SPDX-License-Identifier: MPL-2.0

//! Centralized terminal styling for the day CLI.
//!
//! A single palette, referenced everywhere instead of inline `\x1b[..m` escape codes. Built on
//! [`anstyle`] — the styling vocabulary clap itself uses, already in our dependency tree — so the
//! CLI's own output shares clap's color system. Print styled text with the [`anstream`]
//! `eprintln!`/`println!` macros in the `{STYLE}text{STYLE:#}` form (the `:#` alternate flag emits
//! the reset):
//!
//! ```ignore
//! use anstream::eprintln;
//! use crate::term::{ERROR, WARN};
//! eprintln!("  {ERROR}✗{ERROR:#} {WARN}{}{WARN:#}", msg);
//! ```
//!
//! `anstream` strips the escapes automatically when the destination isn't a color-capable terminal
//! (a pipe, a file, `NO_COLOR`, `TERM=dumb`, or a legacy Windows console), so styled call sites
//! stay honest without each one probing the tty. For richer terminal UI later (progress bars,
//! concurrent task spinners) the intended companions are `indicatif` + `console` — see the CLI
//! output notes in AGENTS.md.

use anstyle::{AnsiColor, Color, Effects, Style};

/// A plain foreground color on the default background — the building block for the palette.
const fn fg(color: AnsiColor) -> Style {
    Style::new().fg_color(Some(Color::Ansi(color)))
}

/// cargo-style status header — bold green (`   Launching`, `  Building`); the caller right-aligns.
pub const HEADER: Style = fg(AnsiColor::Green).effects(Effects::BOLD);
/// Success — green (`✓`, "no findings").
pub const SUCCESS: Style = fg(AnsiColor::Green);
/// Emphatic success — bold green (summary "✓ all good").
pub const SUCCESS_BOLD: Style = fg(AnsiColor::Green).effects(Effects::BOLD);
/// Warning / advisory — yellow (`⚠`, "warning", the `▸` keep-alive note, the update banner).
pub const WARN: Style = fg(AnsiColor::Yellow);
/// Failure — red (`✗`).
pub const ERROR: Style = fg(AnsiColor::Red);
/// Emphatic failure — bold red (summary "✗ N error(s)").
pub const ERROR_BOLD: Style = fg(AnsiColor::Red).effects(Effects::BOLD);
/// De-emphasized — dimmed (setup hints, "n/a" lines, the scan preamble).
pub const DIM: Style = Style::new().effects(Effects::DIMMED);
/// Emphasis without color — bold (group labels).
pub const BOLD: Style = Style::new().effects(Effects::BOLD);
/// Forwarded app **stdout** line prefix `[target]` — blue. Used only for a line that isn't in
/// Day's `LEVEL target: message` format; anything that is gets colored by level instead.
pub const LOG_OUT: Style = fg(AnsiColor::Blue);
/// Forwarded app **stderr** line prefix `[target]` — yellow. Same fallback role as [`LOG_OUT`].
pub const LOG_ERR: Style = fg(AnsiColor::Yellow);

// Forwarded app log lines, colored by level (`ops::format_log`). This is `env_logger`'s palette
// rather than a new one, so a Day app's terminal reads like any other Rust app's.
/// A forwarded `ERROR` line — red.
pub const LOG_ERROR: Style = fg(AnsiColor::Red);
/// A forwarded `WARN` line — yellow.
pub const LOG_WARN: Style = fg(AnsiColor::Yellow);
/// A forwarded `INFO` line — green.
pub const LOG_INFO: Style = fg(AnsiColor::Green);
/// A forwarded `DEBUG` line — blue.
pub const LOG_DEBUG: Style = fg(AnsiColor::Blue);
/// A forwarded `TRACE` line — cyan.
pub const LOG_TRACE: Style = fg(AnsiColor::Cyan);