Struct AppSettings 

pub struct AppSettings {

    pub port_mode: PortMode,
    pub port: u16,
    pub host: String,
    pub theme: String,
    pub language: String,
    pub web_theme: String,
    pub web_language: String,
    pub db_path: Option<String>,
    pub salt: String,
    pub workspaces: Vec<WorkspaceSettings>,
    pub tray_resident: bool,
    pub default_search: bool,
    pub default_viewed: bool,
    pub default_live: bool,
    pub default_edit: bool,
    pub default_chat: bool,
    pub default_chat_mode: String,
    pub default_shared_annotation: bool,
    pub print_collapsed_content: bool,
    pub chat: ChatSettings,
    pub web_styles: HashMap<String, String>,
    pub shortcuts: HashMap<String, Value>,
    pub auto_update: bool,
    pub update_channel: String,
    pub window_width: Option<u32>,
    pub window_height: Option<u32>,
}

Fields

port_mode: PortMode

port: u16

host: String

theme: String

language: String

web_theme: String

web_language: String

db_path: Option<String>

salt: String

Per-install random salt for workspace-id hashing. Empty on first run; load() lazily generates one and persists it. Keeping it stable across restarts means bookmarked workspace URLs survive; randomizing per install means the URL is not derivable from the file path alone.

workspaces: Vec<WorkspaceSettings>

tray_resident: bool

default_search: bool

default_viewed: bool

default_live: bool

default_edit: bool

default_chat: bool

default_chat_mode: String

Default chat surface form: “in_page” (floating panel embedded in the markdown view) or “popout” (a standalone window opened via window.open). Drives: • sphere click → expand panel vs spawn popout • selection chat button → quote into in-page chat vs popout • TOGGLE_CHAT shortcut In every case Shift inverts the choice for that single click/press.

default_shared_annotation: bool

print_collapsed_content: bool

When false (default), <details>-style collapsed sections are hidden in print and replaced by a small placeholder; when true the collapsed content is forced visible so it shows up in the printed output.

chat: ChatSettings

web_styles: HashMap<String, String>

shortcuts: HashMap<String, Value>

auto_update: bool

update_channel: String

window_width: Option<u32>

window_height: Option<u32>

Implementations

impl AppSettings

pub fn load() -> Self

pub fn save(&self) -> Result<(), String>

pub fn to_server_config(&self, port: u16) -> ServerConfig

pub fn effective_web_language(&self) -> Option<String>

pub fn persist_hook(settings: Arc<Mutex<AppSettings>>) -> PersistHook

Build a registry persist-hook that mirrors every registry mutation back into the shared AppSettings and writes to disk. CLI daemon and GUI both wire this so workspace changes initiated from either side end up with the same persistent state.

pub fn render_shortcuts_json(&self) -> Option<String>

pub fn render_styles_css(&self) -> Option<String>

Render web_styles (GUI-supplied overrides) as a complete CSS block targeting the --markon-* design tokens defined in editor.css.

Storage convention from the GUI panel (STYLE_DEFS in index.html): • duo-color entries are keyed <base>.light / <base>.dark (e.g. primary.light, muted.dark) • single-value entries are keyed by the bare token name (ui-font, ui-font-size, panel-opacity)

Routing rules: • <base>.light → :root as --markon-<base> • <base>.dark → html[data-theme="dark"] as --markon-<base> • bare key → :root as --markon-<key> • unknown suffix (anything other than .light/.dark) is treated as a single value and routed to :root so malformed/legacy storage doesn’t panic.

Selector blocks are emitted in a fixed order — :root first, then the dark override — so callers/tests get stable framing even though HashMap iteration over individual properties is unordered. Returns None when neither selector would have any content.

Trait Implementations

impl Clone for AppSettings

fn clone(&self) -> AppSettings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AppSettings

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

Formats the value using the given formatter.

impl Default for AppSettings

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AppSettings

where AppSettings: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AppSettings

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

where __S: Serializer,

Serialize this value into the given Serde serializer.