config

type Config struct {
	Telegram      TelegramConfig     `toml:"telegram"`
	Storage       StorageConfig      `toml:"storage"`
	UI            UIConfig           `toml:"ui"`
	Media         MediaConfig        `toml:"media"`
	Notifications NotificationConfig `toml:"notifications"`
	Keys          KeyConfig          `toml:"keys"`
}

type KeyConfig struct {
	Quit string `toml:"quit"`
	// QuitBrowsing quits from the chat list and the chat view only, where
	// a bare letter cannot be mistaken for typing — the composer owns
	// printables and never sees it. Quit (and the hardcoded
	// ctrl+q) work from everywhere including the composer. Default "q".
	//
	// An unsent draft or a pending attachment turns it into a confirm
	// rather than an immediate exit, so a single keystroke cannot discard
	// a message being written.
	QuitBrowsing  string `toml:"quit_browsing"`
	FocusChatList string `toml:"focus_chat_list"`
	FocusChatView string `toml:"focus_chat_view"`
	FocusComposer string `toml:"focus_composer"`
	Search        string `toml:"search"`
	Contacts      string `toml:"contacts"`
	// ContactsAlt is a second, alt-free binding for the contacts overlay,
	// so the overlay stays reachable on terminals that cannot report Alt
	// (see the macOS notes below). Default f4.
	ContactsAlt string `toml:"contacts_alt"`
	// Help opens the keybinding overlay. Default "?".
	Help string `toml:"help"`
	// GlobalSearch searches every chat. Search ("/") does the same from
	// every panel except the chat view, where vi convention makes "/" mean
	// "find in this buffer"; GlobalSearch is the panel-independent binding.
	// Default ctrl+g.
	GlobalSearch  string `toml:"global_search"`
	NextChat      string `toml:"next_chat"`
	PrevChat      string `toml:"prev_chat"`
	Reply         string `toml:"reply"`
	EditMessage   string `toml:"edit_message"`
	DeleteMessage string `toml:"delete_message"`
	Forward       string `toml:"forward"`
	ScrollUp      string `toml:"scroll_up"`
	ScrollDown    string `toml:"scroll_down"`
	PageUp        string `toml:"page_up"`
	PageDown      string `toml:"page_down"`
	// NextFolder/PrevFolder cycle the chat list's folder tabs.
	NextFolder string `toml:"next_folder"`
	PrevFolder string `toml:"prev_folder"`
}

type MediaConfig struct {
	ImageProtocol       string `toml:"image_protocol"`
	MaxImageWidth       int    `toml:"max_image_width"`
	MaxImageHeight      int    `toml:"max_image_height"`
	VoicePlayer         string `toml:"voice_player"`
	VideoPlayer         string `toml:"video_player"`
	AutoDownloadPhotos  bool   `toml:"auto_download_photos"`
	AutoDownloadLimitMB int    `toml:"auto_download_limit_mb"`

	// AutoDownloadVoice is read back and written out, and nothing consults
	// it. Voice notes are never prefetched: one is fetched when you press
	// space on it, which is the only moment anybody wants the bytes, and
	// turning that off would mean a key that does nothing. Kept for config
	// round-tripping — see TimestampFormat for the same reasoning at
	// length.
	AutoDownloadVoice bool `toml:"auto_download_voice"`
}

type MigrationChange struct {
	// Field is the TOML key, qualified by its table (e.g. "keys.contacts").
	Field string
	// Old is the value the config carried, empty when Absent.
	Old string
	// Absent distinguishes a key the file never had from one it set to the
	// empty string. Both read as "" in Old, but they are different
	// mistakes: the first is an old config missing a field added since, the
	// second is someone who wrote `contacts = ""` and deserves to see that
	// their (broken) setting was replaced rather than merely filled in.
	Absent bool
	// New is the value written in its place.
	New string
	// Removed marks a field the client no longer has. The key is dropped
	// from the rewritten file rather than replaced, and the summary says so
	// — a user who tuned it deserves to learn it stopped doing anything,
	// which is not the same news as a value being changed.
	Removed bool
}

type NotificationConfig struct {
	Enabled     bool `toml:"enabled"`
	Sound       bool `toml:"sound"`
	ShowPreview bool `toml:"show_preview"`

	// Method is who posts the notification: "auto" (the default — the
	// terminal where it is known to understand the sequence, the system
	// otherwise), "terminal", or "system". See internal/notification for
	// why the terminal is usually the right answer, and why macOS labels
	// the system path "Script Editor".
	Method string `toml:"method"`
}

type RawFile struct {
	// Config is the file parsed with no defaults applied.
	Config *Config
	// contains filtered or unexported fields
}

type StorageConfig struct {
	SessionFile string `toml:"session_file"`

	// FilesDir is the media CACHE: where downloads land so a photo drawn
	// twice is fetched once. It is not where "save this" saves to — see
	// DownloadDir — and a user who set files_dir expecting the latter got
	// a cache directory full of files with server-side names.
	FilesDir string `toml:"files_dir"`

	// DownloadDir is where `s` puts a copy, under the sender's own
	// filename. Defaults to the platform download folder, because that is
	// where a person looks for a thing they just saved.
	DownloadDir string `toml:"download_dir"`
	// StateFile is the bbolt database holding the update-sequence state
	// (pts/qts/seq/date) and the peer access-hash cache, so updates that
	// arrived while the app was offline can be recovered on the next start.
	// Empty (the default) means "state.db" next to SessionFile.
	StateFile string `toml:"state_file"`
}

type TelegramConfig struct {
	APIID   int32  `toml:"api_id"`
	APIHash string `toml:"api_hash"`
	Phone   string `toml:"phone"`
}

type UIConfig struct {
	Theme string `toml:"theme"`

	// TimestampFormat and DateFormat are READ BACK AND WRITTEN OUT, and
	// nothing consults them. Every time on screen has a fixed form chosen
	// for the column it sits in: the thread's clock is 15:04 because the
	// grid gives it five cells and puts the date in a day divider, the
	// chat list is relative because a chat list is read for recency, and a
	// day divider names the day. A Go layout string cannot express those,
	// and one that overrode all three would break the column widths the
	// frame is built on.
	//
	// Kept so an existing config round-trips rather than losing keys on
	// -migrate-config. Marked here, and in config.example.toml, so nobody
	// spends an afternoon finding out they do nothing.
	TimestampFormat string `toml:"timestamp_format"`
	DateFormat      string `toml:"date_format"`

	// InlineImages governs WHERE a photo is drawn:
	// [InlineImagesNever], [InlineImagesOnOpen] (the default), or
	// [InlineImagesAlways]. Only the last puts art in the thread, and only
	// bounded — see render.inlineArtRows for why the bound is not
	// negotiable.
	InlineImages string `toml:"inline_images"`

	// Hyperlinks governs OSC 8 terminal hyperlinks on links in a message:
	// [HyperlinksAuto] (the default), [HyperlinksNever], or
	// [HyperlinksAlways].
	Hyperlinks string `toml:"hyperlinks"`

	// EmojiWidth declares how this terminal draws emoji sequences that
	// have a composition rule: [EmojiWidthAuto] (the default),
	// [EmojiWidthComposed], or [EmojiWidthSeparate]. It is a declaration
	// because it cannot be detected — see internal/ui/cell for why.
	EmojiWidth string `toml:"emoji_width"`

	// Rail shows the right-hand context rail — pinned message, members,
	// shared files — on a terminal wide enough for it. Off by default: it
	// costs 30 columns, and they come out of the thread.
	Rail bool `toml:"rail"`
	// ComposeEditing selects the composer's line-editing keymap:
	// [ComposeEditingEmacs], [ComposeEditingVi], or [ComposeEditingAuto]
	// (the default) to infer it from $VISUAL/$EDITOR. Resolve it with
	// [ResolveComposeEditing]; never read the raw value.
	ComposeEditing string `toml:"compose_editing"`
	// ParseMarkdown enables the Telegram Desktop markdown subset in
	// outgoing messages and captions (**bold**, __italic__, `code`,
	// “`pre“`, ~~strike~~, ||spoiler||, [text](url)).
	//
	// Defaults to FALSE: what you typed is what gets sent. The composer has
	// no preview, so with parsing on silently by default the first time a
	// user notices is when a message has already left — and the syntax
	// overlaps with things people paste verbatim. __init__ arrives as
	// init, a snippet full of ** loses it, a table of || collapses. Opting
	// in means knowing that transformation happens.
	//
	// -migrate-config turns it on for existing configs, where it reports
	// the change, so upgraders get the feature but are told about it.
	ParseMarkdown bool `toml:"parse_markdown"`
}