build: make ui deps optional

Author: mrinalwadhwa

implementations/rust/ockam/ockam_api/Cargo.toml

@@ -44,6 +44,7 @@ storage = ["ockam/storage"]
 aws-lc = ["ockam_vault/aws-lc", "ockam_transport_tcp/aws-lc"]
 rust-crypto = ["ockam_vault/rust-crypto", "ockam_transport_tcp/ring"]
 privileged_portals = ["ockam_transport_tcp/privileged_portals"]
+ui = ["r3bl_rs_utils_core", "r3bl_tui", "r3bl_tuify"]
 
 [[bin]]
 name = "node_control_api_schema"
@@ -92,9 +93,9 @@ opentelemetry-proto = { version = "0.27", features = ["full"] }
 opentelemetry-semantic-conventions = { version = "0.28", features = ["semconv_experimental"] }
 opentelemetry_sdk = { version = "0.27", features = ["logs", "metrics", "trace", "rt-tokio", "rt-tokio-current-thread", "testing"], default-features = false }
 petname = { version = "2.0.2", default-features = false, features = ["default-rng", "default-words"] }
-r3bl_rs_utils_core = "0.9"
-r3bl_tui = "0.5"
-r3bl_tuify = "0.1"
+r3bl_rs_utils_core = { version = "0.9", optional = true }
+r3bl_tui = { version = "0.5", optional = true }
+r3bl_tuify = { version = "0.1", optional = true }
 rand = "0.8"
 regex = "1.10.6"
 reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls-native-roots"] }

implementations/rust/ockam/ockam_api/src/lib.rs

@@ -19,6 +19,10 @@
 #[macro_use]
 extern crate tracing;
 
+#[cfg(not(feature = "ui"))]
+// The color! macro is already exported at the crate root via #[macro_export] in ui::colors (fallback),
+// so we don't re-export it here to avoid duplicate definition and unused import warnings.
+
 pub mod address;
 pub mod authenticator;
 pub mod cli_state;

implementations/rust/ockam/ockam_api/src/ui/mod.rs

@@ -1,4 +1,91 @@
+#[cfg(feature = "ui")]
 pub mod colors;
+
+#[cfg(not(feature = "ui"))]
+pub mod colors {
+    use colorful::{core::color_string::CString, Colorful, RGB};
+    use std::fmt::Display;
+
+    #[derive(Copy, Clone, PartialEq, Eq, Debug)]
+    pub enum OckamColor {
+        OckamBlue,
+        HeaderGradient,
+        PrimaryResource,
+        Success,
+        Failure,
+        FmtOKBackground,
+        FmtINFOBackground,
+        FmtWARNBackground,
+        FmtERRORBackground,
+        FmtLISTBackground,
+    }
+
+    impl OckamColor {
+        /// Hex string value for this color (kept consistent w/ full UI feature version).
+        pub fn value(&self) -> &'static str {
+            match self {
+                OckamColor::OckamBlue => "#52c7ea",
+                OckamColor::HeaderGradient => "#4FDAB8",
+                OckamColor::PrimaryResource => "#4FDAB8",
+                OckamColor::Success => "#A8C97D",
+                OckamColor::Failure => "#ff0000",
+                OckamColor::FmtOKBackground => "#A8C97D",
+                OckamColor::FmtINFOBackground => "#0DCAF0",
+                OckamColor::FmtWARNBackground => "#ff9a00",
+                OckamColor::FmtERRORBackground => "#FF0000",
+                OckamColor::FmtLISTBackground => "#0DCAF0",
+            }
+        }
+        pub fn color(&self) -> RGB {
+            // Provide simple, hard-coded fallback colors that don't require r3bl_* crates.
+            match self {
+                OckamColor::OckamBlue => RGB::new(0x52, 0xC7, 0xEA),
+                OckamColor::HeaderGradient => RGB::new(0x4F, 0xDA, 0xB8),
+                OckamColor::PrimaryResource => RGB::new(0x4F, 0xDA, 0xB8),
+                OckamColor::Success => RGB::new(0xA8, 0xC9, 0x7D),
+                OckamColor::Failure => RGB::new(0xFF, 0x00, 0x00),
+                OckamColor::FmtOKBackground => RGB::new(0xA8, 0xC9, 0x7D),
+                OckamColor::FmtINFOBackground => RGB::new(0x0D, 0xCA, 0xF0),
+                OckamColor::FmtWARNBackground => RGB::new(0xFF, 0x9A, 0x00),
+                OckamColor::FmtERRORBackground => RGB::new(0xFF, 0x00, 0x00),
+                OckamColor::FmtLISTBackground => RGB::new(0x0D, 0xCA, 0xF0),
+            }
+        }
+    }
+
+    // Re-exported macro to keep parity w/ full UI feature.
+    #[macro_export]
+    macro_rules! color {
+        ($text:expr, $color:expr) => {
+            $text.to_string().color($color.color())
+        };
+    }
+
+    pub fn color_primary(input: impl Display) -> CString {
+        input.to_string().color(OckamColor::PrimaryResource.color())
+    }
+    pub fn color_primary_alt(input: impl Display) -> String {
+        // Fallback: no gradient, just plain text
+        input.to_string()
+    }
+    pub fn color_ok(input: impl Display) -> CString {
+        input.to_string().color(OckamColor::FmtOKBackground.color())
+    }
+    pub fn color_warn(input: impl Display) -> CString {
+        input.to_string().color(OckamColor::FmtWARNBackground.color())
+    }
+    pub fn color_error(input: impl Display) -> CString {
+        input.to_string().color(OckamColor::FmtERRORBackground.color())
+    }
+    pub fn color_email(input: impl Display) -> CString {
+        input.to_string().color(OckamColor::PrimaryResource.color())
+    }
+    pub fn color_uri(input: impl Display) -> String {
+        // Fallback: no gradient
+        input.to_string()
+    }
+}
+
 pub mod command;
 pub mod output;
 pub mod terminal;

implementations/rust/ockam/ockam_api/src/ui/terminal/fmt.rs

@@ -8,16 +8,24 @@ pub const MIETTE_PADDING: &str = "  ";
 pub const INDENTATION: &str = "  ";
 
 pub fn get_separator_width() -> usize {
-    // If we can't get the terminal width, use the default width
-    let mut terminal_width = r3bl_tuify::get_terminal_width();
-    if terminal_width == 0 {
-        terminal_width = r3bl_tuify::DEFAULT_WIDTH;
+    // When the full UI feature is enabled, use dynamic terminal sizing from r3bl_tuify.
+    #[cfg(feature = "ui")]
+    {
+        let mut terminal_width = r3bl_tuify::get_terminal_width();
+        if terminal_width == 0 {
+            terminal_width = r3bl_tuify::DEFAULT_WIDTH;
+        }
+        let terminal_width = std::cmp::max(terminal_width, 2 * PADDING.len());
+        return std::cmp::min(terminal_width - PADDING.len(), r3bl_tuify::DEFAULT_WIDTH);
+    }
+
+    // Fallback when `ui` feature (and thus r3bl_tuify) is disabled: use a fixed width.
+    #[cfg(not(feature = "ui"))]
+    {
+        // Pick a sane default (80 cols) minus left padding, but never under 10.
+        let width = 80usize.saturating_sub(PADDING.len());
+        std::cmp::max(width, 10)
     }
-    // Make sure the separator width is at least twice the length of the padding.
-    // We want to show a small separator even if the terminal is too narrow.
-    let terminal_width = std::cmp::max(terminal_width, 2 * PADDING.len());
-    // Limit the separator width to the default width
-    std::cmp::min(terminal_width - PADDING.len(), r3bl_tuify::DEFAULT_WIDTH)
 }
 
 #[test]

implementations/rust/ockam/ockam_api/src/ui/terminal/mod.rs

@@ -15,8 +15,23 @@ use indicatif::{ProgressBar, ProgressDrawTarget, ProgressStyle};
 use jaq_interpret::{Ctx, FilterT, ParseCtx, RcIter, Val};
 use miette::{miette, IntoDiagnostic};
 use ockam_core::env::get_env_with_default;
+#[cfg(feature = "ui")]
 use r3bl_rs_utils_core::{ch, ChUnit};
+
+
+#[cfg(feature = "ui")]
 use r3bl_tuify::{get_size, select_from_list, SelectionMode, StyleSheet};
+#[cfg(not(feature = "ui"))]
+#[allow(dead_code)]
+pub(crate) fn get_size() -> (usize, usize) {
+    (80, 24)
+}
+#[cfg(not(feature = "ui"))]
+#[allow(dead_code)]
+pub(crate) fn select_from_list<T: Clone>(_: &str, items: &[T]) -> Option<T> {
+    items.first().cloned()
+}
+
 use serde::Serialize;
 use std::fmt::Write as _;
 use std::fmt::{Debug, Display};
@@ -139,7 +154,13 @@ impl<W: TerminalWriter + Debug> Terminal<W> {
         let no_input = Self::should_disable_user_input(no_input);
         let stdout = W::stdout(no_color, OutputBranding::default());
         let stderr = W::stderr(no_color, OutputBranding::default());
-        let max_width_col_count = get_size().map(|it| it.col_count).unwrap_or(ch!(80)).into();
+        #[cfg(feature = "ui")]
+        let max_width_col_count = get_size().map(|it| it.col_count).unwrap_or(80).into();
+        #[cfg(not(feature = "ui"))]
+        let max_width_col_count = {
+            let (cols, _rows) = get_size();
+            cols
+        };
         Self {
             stdout,
             stderr,
@@ -186,6 +207,7 @@ impl<W: TerminalWriter + Debug> Terminal<W> {
         }
     }
 
+    #[cfg(feature = "ui")]
     pub fn confirm_interactively(&self, header: String) -> bool {
         let user_input = select_from_list(
             header,
@@ -202,8 +224,15 @@ impl<W: TerminalWriter + Debug> Terminal<W> {
         }
     }
 
+    #[cfg(not(feature = "ui"))]
+    pub fn confirm_interactively(&self, header: String) -> bool {
+        let user_input = select_from_list(&header, &["YES".to_string(), "NO".to_string()]);
+        matches!(user_input, Some(ref it) if it == "YES")
+    }
+
     /// Returns the selected items by the user, or an empty `Vec` if the user did not select any item
     /// or if the user is not able to select an item (e.g. not a TTY, `--no-input` flag, etc.).
+    #[cfg(feature = "ui")]
     pub fn select_multiple(&self, header: String, items: Vec<String>) -> Vec<String> {
         if !self.can_ask_for_user_input() {
             return Vec::new();
@@ -221,6 +250,12 @@ impl<W: TerminalWriter + Debug> Terminal<W> {
         user_selected_list.unwrap_or_default()
     }
 
+    #[cfg(not(feature = "ui"))]
+    pub fn select_multiple(&self, _header: String, _items: Vec<String>) -> Vec<String> {
+        // Fallback: interactive multi-selection unavailable without `ui` feature.
+        Vec::new()
+    }
+
     pub fn can_ask_for_user_input(&self) -> bool {
         !self.no_input && self.stderr.is_tty() && !self.quiet
     }