Struct ConfigState 

pub struct ConfigState {
    config: RwLock<Arc<FullConfigType>>,
}

Thread-safe in-memory holder for the live configuration.

This does not watch anything. It was called ConfigWatcher until 2026-09-06, on the strength of a comment promising that “the actual file system watching will be integrated with the event loop in a later phase” — which never happened. Watching was instead built separately in backend::config_watcher_fs, on top of the shared fs_watch::pool, and the two have coexisted since: similar names, one module doing the thing the other is named for. That cost real time while tracing the settings-reload path; see docs/reports/REPORT_NETWORK_ARCHITECTURE_DRYNESS_AND_ROBUST_LAN_2026_09_06.md §7.

Readers get a cheap Arc clone of the current snapshot; writers swap the whole Arc under the lock, so no reader ever observes a half-applied config.

Fields

config: RwLock<Arc<FullConfigType>>

Implementations

impl ConfigState

pub fn new() -> Self

Create a new config watcher with default config.

pub fn with_config(config: FullConfigType) -> Self

Create a new config watcher with initial config.

pub fn get_full_config(&self) -> Arc<FullConfigType>

Get a snapshot of the current config.

pub fn get_settings(&self) -> SettingsType

Get just the settings.

pub fn update_settings(&self, settings: SettingsType)

Update just the settings portion, and the per-connection settings that live inside it (settings.json → connections): every per-connection reader looks at FullConfigType::connections.

pub fn update_widgets(&self, widgets: HashMap<String, WidgetConfigType>)

Replace the widget set (the built-ins merged with the user’s own widgets.json — backend::user_widgets).

pub fn update_browser_start_page(&self, url: Option<String>)

Update just the browser start page. Mirrors update_settings exactly — see backend::browser_start_page for the load/watch wiring that calls this.

Trait Implementations

impl Default for ConfigState

fn default() -> Self

Returns the “default value” for a type.