deb: change ui/ux of pkh deb

src/ui.rs

@@ -1,3 +1,11 @@
+//! Terminal UI helpers: progress bars, interactive prompts and live build
+//! views.
+
+/// Live build view for `pkh deb` (status bar + rolling log pane)
+pub mod deb;
+/// Line classifiers rewriting raw subprocess output for the live views
+pub mod logfmt;
+
 use crossterm::{
     cursor, event, execute,
     style::{self, Color, Print, SetForegroundColor},
@@ -7,6 +15,8 @@ use indicatif::{MultiProgress, ProgressBar, ProgressStyle};
 use std::io::{self, Write};
 use std::time::Duration;
 
+/// Create a spinner-style progress bar attached to `multi`, returning the bar
+/// and a callback compatible with [`crate::ProgressCallback`]
 pub fn create_progress_bar(
     multi: &MultiProgress,
 ) -> (ProgressBar, impl Fn(&str, &str, usize, usize) + '_) {