Struct UiState 

#[non_exhaustive]
pub struct UiState {
    pub render_settings: RenderSettings,
    pub message_verbosity: MessageLevel,
    pub debug_verbosity: u8,
}

Derived presentation/runtime state for the active config snapshot.

This is cached host state, not a second source of truth. Recompute it when the resolved config changes so renderers and message surfaces all read the same derived values.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

render_settings: RenderSettings

Render settings derived from the current config snapshot.

message_verbosity: MessageLevel

Default message verbosity derived from the current runtime config.

debug_verbosity: u8

Numeric debug verbosity used for trace-style host output.

Implementations

impl UiState

pub fn from_resolved_config( context: &RuntimeContext, config: &ResolvedConfig, ) -> Result<Self>

Derives UI state from a resolved config snapshot and runtime context.

Examples

use osp_cli::app::{RuntimeContext, TerminalKind, UiState};
use osp_cli::config::{ConfigLayer, ConfigResolver, ResolveOptions};

let mut defaults = ConfigLayer::default();
defaults.set("profile.default", "default");
defaults.set("ui.message.verbosity", "info");

let mut resolver = ConfigResolver::default();
resolver.set_defaults(defaults);
let config = resolver.resolve(ResolveOptions::new().with_terminal("cli")).unwrap();

let ui = UiState::from_resolved_config(
    &RuntimeContext::new(None, TerminalKind::Cli, Some("xterm-256color".to_string())),
    &config,
)
.unwrap();

assert_eq!(ui.message_verbosity.as_env_str(), "info");
assert_eq!(ui.render_settings.runtime.terminal.as_deref(), Some("xterm-256color"));

pub fn new( render_settings: RenderSettings, message_verbosity: MessageLevel, debug_verbosity: u8, ) -> Self

Creates the UI state snapshot used for one resolved config revision.

Examples

use osp_cli::app::UiState;
use osp_cli::ui::RenderSettings;
use osp_cli::ui::messages::MessageLevel;
use osp_cli::core::output::OutputFormat;

let ui = UiState::new(
    RenderSettings::test_plain(OutputFormat::Json),
    MessageLevel::Success,
    2,
);

assert_eq!(ui.message_verbosity, MessageLevel::Success);
assert_eq!(ui.debug_verbosity, 2);

pub fn with_render_settings(self, render_settings: RenderSettings) -> Self

Replaces the render-settings baseline used by this UI state.

pub fn with_message_verbosity(self, message_verbosity: MessageLevel) -> Self

Replaces the message verbosity used for buffered UI messages.

pub fn with_debug_verbosity(self, debug_verbosity: u8) -> Self

Replaces the numeric debug verbosity.

Trait Implementations

impl Clone for UiState

fn clone(&self) -> UiState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UiState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.