Struct TuiConfig 

pub struct TuiConfig {
    pub confirm_countdown_secs: u32,
    pub auto_refresh_secs: u64,
    pub open: TuiOpenConfig,
    pub sidebar_position: SidebarPosition,
    pub keys: TuiKeysConfig,
    pub macro1: Option<TuiMacroConfig>,
    pub macro2: Option<TuiMacroConfig>,
}

[tui] table — runtime knobs for the worktree TUI. Currently exposes the safety countdown on the delete-confirm overlay (issue #30): when delete_branch_on_remove has been toggled ON, the modal forces the user to wait N seconds (visualised by a progress bar) before the destructive action actually fires. 0 disables the countdown and falls back to the classic single-keystroke confirm even when delete- branch is armed; the value is clamped to 5 at read time so a typo like confirm_countdown_secs = 300 can never strand a destructive path behind a 300-second wait.

Fields

confirm_countdown_secs: u32

Safety countdown (in seconds) applied to the confirm overlay when delete_branch_on_remove is ON. Accepts any non-negative integer; values above Self::MAX_CONFIRM_COUNTDOWN_SECS are clamped on read via Self::effective_confirm_countdown_secs. The field is u32 (rather than u8) so a typo like confirm_countdown_secs = 300 still round-trips through TOML deserialization and reaches the clamp instead of erroring out at parse time.

auto_refresh_secs: u64

Periodic worktree-list refresh interval in seconds. Default 60 keeps Issue/PR table state reasonably fresh; 0 disables the automatic refresh loop.

open: TuiOpenConfig

[tui.open] sub-table — drives the dispatch of the o key in the list view. Default mode is shell (lazygit-like worktree-manager workflow); pre-#73 behaviour (open / xdg-open / explorer) is kept available under mode = "finder".

sidebar_position: SidebarPosition

Which side the worktree-details sidebar sits on in the side-by-side layout (issue #188). Default right preserves pre-#188 behaviour; left flips the split. Toggled live in the TUI with H. Ignored by the stacked (narrow-terminal) layout, where the sidebar is always at the bottom.

keys: TuiKeysConfig

[tui.keys] sub-table (issue #87) — user overrides for the remappable keymap. Absent → keymap stays at the built-in defaults. Present → every listed action replaces its default binding set; actions left unmentioned keep their defaults. An empty array (down = []) unbinds the action entirely.

macro1: Option<TuiMacroConfig>

[tui.macro1] — user-defined command bound to h by default (#290). Absent → the key does nothing.

macro2: Option<TuiMacroConfig>

[tui.macro2] — user-defined command bound to H by default (#290). Absent → the key does nothing.

Implementations

impl TuiConfig

pub const MAX_CONFIRM_COUNTDOWN_SECS: u32 = 5

Documented range cap. Centralised so the TUI and the doctor share the same clamp logic.

pub fn effective_confirm_countdown_secs(&self) -> u32

Effective countdown value used by the TUI, clamped to [0, MAX_CONFIRM_COUNTDOWN_SECS]. The raw field stays at the user’s value so a future doctor check can surface “your config asked for X but we capped at 5”.

Trait Implementations

impl Clone for TuiConfig

fn clone(&self) -> TuiConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TuiConfig

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

Formats the value using the given formatter.

impl Default for TuiConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TuiConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TuiConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.