feat(cli): add tui dashboards

Author: WendellXY

langcodec-cli/Cargo.toml

@@ -15,8 +15,9 @@ documentation = "https://docs.rs/langcodec-cli"
 langcodec = { path = "../langcodec", version = "0.9.1" }
 clap = { version = "4", features = ["derive"] }
 clap_complete = "4"
-unicode-width = "0.2.1"
+unicode-width = "0.2.0"
 crossterm = "0.29.0"
+ratatui = "0.29"
 atty = "0.2.14"
 async-trait = "0.1.89"
 mentra = "0.3.0"

langcodec-cli/src/convert.rs

@@ -240,10 +240,7 @@ pub fn run_unified_convert_command(
             }
             println!(
                 "{}",
-                ui::status_line_stdout(
-                    ui::Tone::Success,
-                    "Successfully converted in strict mode",
-                )
+                ui::status_line_stdout(ui::Tone::Success, "Successfully converted in strict mode",)
             );
             return;
         }
@@ -270,10 +267,7 @@ pub fn run_unified_convert_command(
             }
             println!(
                 "{}",
-                ui::status_line_stdout(
-                    ui::Tone::Success,
-                    "Successfully converted in strict mode",
-                )
+                ui::status_line_stdout(ui::Tone::Success, "Successfully converted in strict mode",)
             );
             return;
         }
@@ -295,10 +289,7 @@ pub fn run_unified_convert_command(
         }
         println!(
             "{}",
-            ui::status_line_stdout(
-                ui::Tone::Success,
-                "Successfully converted in strict mode",
-            )
+            ui::status_line_stdout(ui::Tone::Success, "Successfully converted in strict mode",)
         );
         return;
     }
@@ -332,10 +323,7 @@ pub fn run_unified_convert_command(
         if input.ends_with(".json") && options.input_format.is_none() {
             println!(
                 "{}",
-                ui::status_line_stdout(
-                    ui::Tone::Info,
-                    "Trying standard JSON format detection...",
-                )
+                ui::status_line_stdout(ui::Tone::Info, "Trying standard JSON format detection...",)
             );
             // Try to use the standard format detection which will show proper JSON parsing errors
             if let Err(e) = convert_auto(&input, &output) {
@@ -375,10 +363,7 @@ pub fn run_unified_convert_command(
             if let Err(e) = try_custom_format_conversion(&input, &output, &options.input_format) {
                 println!(
                     "{}",
-                    ui::status_line_stdout(
-                        ui::Tone::Error,
-                        "Custom format conversion failed",
-                    )
+                    ui::status_line_stdout(ui::Tone::Error, "Custom format conversion failed",)
                 );
                 eprintln!("Error: {}", e);
                 std::process::exit(1);
@@ -405,10 +390,7 @@ pub fn run_unified_convert_command(
         if let Err(e) = try_explicit_format_conversion(&input, &output, &input_fmt, &output_fmt) {
             println!(
                 "{}",
-                ui::status_line_stdout(
-                    ui::Tone::Error,
-                    "Explicit format conversion failed",
-                )
+                ui::status_line_stdout(ui::Tone::Error, "Explicit format conversion failed",)
             );
             eprintln!("Error: {}", e);
             std::process::exit(1);

langcodec-cli/src/diff.rs

@@ -42,13 +42,14 @@ fn print_or_write(output: Option<&String>, content: &str) -> Result<(), String>
 
 fn render_human(report: &DiffReport) -> String {
     if ui::stdout_styled() {
-        let mut lines = Vec::new();
-        lines.push(ui::header("Diff"));
-        lines.push(ui::key_value("Languages", report.summary.languages));
-        lines.push(ui::key_value("Added", report.summary.added));
-        lines.push(ui::key_value("Removed", report.summary.removed));
-        lines.push(ui::key_value("Changed", report.summary.changed));
-        lines.push(ui::key_value("Unchanged", report.summary.unchanged));
+        let mut lines = vec![
+            ui::header("Diff"),
+            ui::key_value("Languages", report.summary.languages),
+            ui::key_value("Added", report.summary.added),
+            ui::key_value("Removed", report.summary.removed),
+            ui::key_value("Changed", report.summary.changed),
+            ui::key_value("Unchanged", report.summary.unchanged),
+        ];
 
         for lang in &report.languages {
             lines.push(ui::section(&format!("Language {}", lang.language)));

langcodec-cli/src/edit.rs

@@ -268,7 +268,10 @@ fn apply_set_to_file(
                     "{}",
                     ui::status_line_stdout(
                         ui::Tone::Info,
-                        &format!("Key '{}' not found in {} ({}); nothing to remove", key, l, input),
+                        &format!(
+                            "Key '{}' not found in {} ({}); nothing to remove",
+                            key, l, input
+                        ),
                     )
                 );
             }
@@ -413,10 +416,7 @@ fn apply_set_to_file(
         } else {
             println!(
                 "{}",
-                ui::status_line_stdout(
-                    ui::Tone::Accent,
-                    &format!("Updated {} in place", input),
-                )
+                ui::status_line_stdout(ui::Tone::Accent, &format!("Updated {} in place", input),)
             );
         }
     }

langcodec-cli/src/lib.rs

@@ -7,6 +7,7 @@ pub mod formats;
 pub mod merge;
 pub mod transformers;
 pub mod translate;
+pub mod tui;
 pub mod ui;
 pub mod validation;
 
@@ -15,3 +16,4 @@ pub use formats::{CustomFormat, parse_custom_format};
 pub use langcodec::Codec;
 pub use transformers::custom_format_to_resource;
 pub use translate::{TranslateOptions, run_translate_command};
+pub use tui::UiMode;

langcodec-cli/src/main.rs

@@ -13,6 +13,7 @@ mod stats;
 mod sync;
 mod transformers;
 mod translate;
+mod tui;
 mod ui;
 mod validation;
 mod view;
@@ -26,6 +27,7 @@ use crate::merge::{ConflictStrategy, run_merge_command};
 use crate::normalize::{NormalizeCliOptions, run_normalize_command};
 use crate::sync::{SyncOptions, run_sync_command};
 use crate::translate::{TranslateOptions, run_translate_command};
+use crate::tui::UiMode;
 use crate::validation::{ValidationContext, validate_context, validate_language_code};
 use crate::view::{ViewOptions, print_view, validate_status_filter};
 use clap::{CommandFactory, Parser, Subcommand};
@@ -306,6 +308,10 @@ enum Commands {
         /// Preview the translation run without writing files
         #[arg(long, default_value_t = false)]
         dry_run: bool,
+
+        /// Terminal UI mode: auto, plain, or tui
+        #[arg(long = "ui", value_enum, default_value_t = UiMode::Auto)]
+        ui_mode: UiMode,
     },
 
     /// Generate translator-facing xcstrings comments from source usage with a Mentra agent.
@@ -349,6 +355,10 @@ enum Commands {
         /// Exit non-zero if comments would be added or refreshed
         #[arg(long, default_value_t = false)]
         check: bool,
+
+        /// Terminal UI mode: auto, plain, or tui
+        #[arg(long = "ui", value_enum, default_value_t = UiMode::Auto)]
+        ui_mode: UiMode,
     },
 
     /// Debug: Read a localization file and output as JSON.
@@ -829,6 +839,7 @@ fn main() {
             concurrency,
             config,
             dry_run,
+            ui_mode,
         } => {
             let mut context = ValidationContext::new();
             if let Some(source_path) = &source {
@@ -880,6 +891,7 @@ fn main() {
                 config,
                 dry_run,
                 strict,
+                ui_mode,
             }) {
                 eprintln!(
                     "{}",
@@ -899,6 +911,7 @@ fn main() {
             config,
             dry_run,
             check,
+            ui_mode,
         } => {
             let mut context = ValidationContext::new();
             if let Some(input_path) = &input {
@@ -929,6 +942,7 @@ fn main() {
                 config,
                 dry_run,
                 check,
+                ui_mode,
             }) {
                 eprintln!(
                     "{}",

langcodec-cli/src/merge.rs

@@ -29,7 +29,10 @@ pub fn run_merge_command(
     if inputs.is_empty() {
         eprintln!(
             "{}",
-            ui::status_line_stderr(ui::Tone::Error, "Error: At least one input file is required.")
+            ui::status_line_stderr(
+                ui::Tone::Error,
+                "Error: At least one input file is required."
+            )
         );
         std::process::exit(1);
     }

langcodec-cli/src/stats.rs

@@ -106,7 +106,10 @@ pub fn print_stats(
                 (stats.translated as f64) * 100.0 / (stats.denominator as f64)
             };
 
-            println!("{}", ui::section(&format!("Language {}", res.metadata.language)));
+            println!(
+                "{}",
+                ui::section(&format!("Language {}", res.metadata.language))
+            );
             println!("{}", ui::divider(28));
             println!("{}", ui::key_value("Total", stats.total));
             println!(
@@ -161,7 +164,12 @@ pub fn print_stats(
                 ui::key_value(
                     "stale",
                     ui::tone_text(
-                        &stats.by_status.get("stale").copied().unwrap_or(0).to_string(),
+                        &stats
+                            .by_status
+                            .get("stale")
+                            .copied()
+                            .unwrap_or(0)
+                            .to_string(),
                         ui::Tone::Error,
                     ),
                 )

langcodec-cli/src/sync.rs

@@ -158,7 +158,10 @@ pub fn run_sync_command(opts: SyncOptions) -> Result<(), String> {
 
     if ui::stdout_styled() {
         println!("{}", ui::header("Sync"));
-        println!("{}", ui::key_value("Sync match language", &report.match_language));
+        println!(
+            "{}",
+            ui::key_value("Sync match language", &report.match_language)
+        );
         println!(
             "{}",
             ui::key_value("Total target entries considered", report.total_entries)
@@ -248,7 +251,10 @@ pub fn run_sync_command(opts: SyncOptions) -> Result<(), String> {
         "{}",
         ui::status_line_stdout(
             ui::Tone::Success,
-            &format!("Sync complete: {}", opts.output.as_deref().unwrap_or(&opts.target)),
+            &format!(
+                "Sync complete: {}",
+                opts.output.as_deref().unwrap_or(&opts.target)
+            ),
         )
     );
     Ok(())