Auto-generated API doc: doxygen → custom Python emitter → doc/api/.

`cmake --build build --target doc` runs Doxygen to produce XML, then
`doc/gen_api_md.py` (~330 lines, stdlib-only) emits a Markdown tree
under `doc/api/` that gitea renders directly in its file browser.

- 24 class/struct pages + 51 source-file pages + indices, with source
  links of the form `../../../../src/...#L42` that gitea turns into
  clickable line-anchored links.
- Doxyfile.in templated by CMake (XML-only output to build/doc/xml/).
- Pure Python emitter, zero external deps — no doxybook2 (not packaged
  on Arch) and no moxygen (avoids Node).
- Target gracefully disabled if Doxygen or Python 3 is missing at
  configure time; regular build target unaffected.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

doc/api/classes/Tui.md

@@ -0,0 +1,397 @@
+# Tui
+
+`class Tui`
+
+Defined in [tui.hpp:17](../../../../src/tui/tui.hpp#L17)
+
+## Private type
+
+### `enum Completion`
+
+📍 [tui.hpp:18](../../../../src/tui/tui.hpp#L18)
+
+## Private Attributes
+
+### `std::vector< std::string > history`
+
+📍 [tui.hpp:40](../../../../src/tui/tui.hpp#L40)
+
+### `std::vector< std::string > recorded`
+
+📍 [tui.hpp:41](../../../../src/tui/tui.hpp#L41)
+
+### `std::vector< std::string > output`
+
+📍 [tui.hpp:42](../../../../src/tui/tui.hpp#L42)
+
+### `std::string input`
+
+📍 [tui.hpp:43](../../../../src/tui/tui.hpp#L43)
+
+### `int cursor_pos`
+
+📍 [tui.hpp:44](../../../../src/tui/tui.hpp#L44)
+
+### `int history_idx`
+
+📍 [tui.hpp:45](../../../../src/tui/tui.hpp#L45)
+
+### `int scroll_offset`
+
+📍 [tui.hpp:46](../../../../src/tui/tui.hpp#L46)
+
+Lines scrolled up from the tail; 0 = follow newest output.
+
+### `bool quit`
+
+📍 [tui.hpp:47](../../../../src/tui/tui.hpp#L47)
+
+### `bool in_source`
+
+📍 [tui.hpp:48](../../../../src/tui/tui.hpp#L48)
+
+### `std::unique_ptr< System > sys`
+
+📍 [tui.hpp:50](../../../../src/tui/tui.hpp#L50)
+
+### `std::deque< Prompt > pending`
+
+📍 [tui.hpp:51](../../../../src/tui/tui.hpp#L51)
+
+### `std::map< std::string, CommandSpec > commands`
+
+📍 [tui.hpp:52](../../../../src/tui/tui.hpp#L52)
+
+### `std::map< std::string, std::string > vars`
+
+📍 [tui.hpp:53](../../../../src/tui/tui.hpp#L53)
+
+$var-style substitution table.
+
+### `int screen_idx`
+
+📍 [tui.hpp:56](../../../../src/tui/tui.hpp#L56)
+
+### `std::vector< std::string > search_modules`
+
+📍 [tui.hpp:59](../../../../src/tui/tui.hpp#L59)
+
+### `std::vector< std::string > search_types`
+
+📍 [tui.hpp:60](../../../../src/tui/tui.hpp#L60)
+
+### `int search_module_idx`
+
+📍 [tui.hpp:61](../../../../src/tui/tui.hpp#L61)
+
+### `int search_type_idx`
+
+📍 [tui.hpp:62](../../../../src/tui/tui.hpp#L62)
+
+### `int search_focus_idx`
+
+📍 [tui.hpp:63](../../../../src/tui/tui.hpp#L63)
+
+### `std::string search_query`
+
+📍 [tui.hpp:64](../../../../src/tui/tui.hpp#L64)
+
+### `std::vector< std::string > connect_modules`
+
+📍 [tui.hpp:67](../../../../src/tui/tui.hpp#L67)
+
+### `int connect_m1_idx`
+
+📍 [tui.hpp:68](../../../../src/tui/tui.hpp#L68)
+
+### `int connect_m2_idx`
+
+📍 [tui.hpp:69](../../../../src/tui/tui.hpp#L69)
+
+### `std::string connect_p1_filter`
+
+📍 [tui.hpp:70](../../../../src/tui/tui.hpp#L70)
+
+### `std::string connect_p2_filter`
+
+📍 [tui.hpp:71](../../../../src/tui/tui.hpp#L71)
+
+### `std::vector< std::string > connect_p1_list`
+
+📍 [tui.hpp:72](../../../../src/tui/tui.hpp#L72)
+
+### `std::vector< std::string > connect_p2_list`
+
+📍 [tui.hpp:73](../../../../src/tui/tui.hpp#L73)
+
+### `int connect_p1_idx`
+
+📍 [tui.hpp:74](../../../../src/tui/tui.hpp#L74)
+
+### `int connect_p2_idx`
+
+📍 [tui.hpp:75](../../../../src/tui/tui.hpp#L75)
+
+### `int connect_focus_idx`
+
+📍 [tui.hpp:76](../../../../src/tui/tui.hpp#L76)
+
+### `std::vector< std::string > explore_modules`
+
+📍 [tui.hpp:79](../../../../src/tui/tui.hpp#L79)
+
+### `int explore_module_idx`
+
+📍 [tui.hpp:80](../../../../src/tui/tui.hpp#L80)
+
+### `std::vector< std::string > explore_types`
+
+📍 [tui.hpp:81](../../../../src/tui/tui.hpp#L81)
+
+### `int explore_type_idx`
+
+📍 [tui.hpp:82](../../../../src/tui/tui.hpp#L82)
+
+### `std::vector< std::string > explore_children`
+
+📍 [tui.hpp:83](../../../../src/tui/tui.hpp#L83)
+
+### `int explore_child_idx`
+
+📍 [tui.hpp:84](../../../../src/tui/tui.hpp#L84)
+
+### `std::string explore_child_filter`
+
+📍 [tui.hpp:85](../../../../src/tui/tui.hpp#L85)
+
+### `std::string explore_detail_filter`
+
+📍 [tui.hpp:86](../../../../src/tui/tui.hpp#L86)
+
+### `std::vector< std::string > explore_detail`
+
+📍 [tui.hpp:87](../../../../src/tui/tui.hpp#L87)
+
+### `int explore_detail_idx`
+
+📍 [tui.hpp:88](../../../../src/tui/tui.hpp#L88)
+
+### `std::string explore_header`
+
+📍 [tui.hpp:89](../../../../src/tui/tui.hpp#L89)
+
+### `int explore_focus_idx`
+
+📍 [tui.hpp:90](../../../../src/tui/tui.hpp#L90)
+
+### `std::atomic< bool > loading`
+
+📍 [tui.hpp:93](../../../../src/tui/tui.hpp#L93)
+
+true while a script is being processed; read by tick thread.
+
+### `std::atomic< bool > tick_in_flight`
+
+📍 [tui.hpp:94](../../../../src/tui/tui.hpp#L94)
+
+main thread acks each tick by clearing this; ticker waits.
+
+### `std::string loading_filename`
+
+📍 [tui.hpp:95](../../../../src/tui/tui.hpp#L95)
+
+### `std::vector< std::string > loading_lines`
+
+📍 [tui.hpp:96](../../../../src/tui/tui.hpp#L96)
+
+### `size_t loading_idx`
+
+📍 [tui.hpp:97](../../../../src/tui/tui.hpp#L97)
+
+### `int loading_executed`
+
+📍 [tui.hpp:98](../../../../src/tui/tui.hpp#L98)
+
+### `int loading_lineno`
+
+📍 [tui.hpp:99](../../../../src/tui/tui.hpp#L99)
+
+### `bool loading_prev_in_source`
+
+📍 [tui.hpp:100](../../../../src/tui/tui.hpp#L100)
+
+### `ftxui::ScreenInteractive * screen_ptr`
+
+📍 [tui.hpp:101](../../../../src/tui/tui.hpp#L101)
+
+set in `Run()` so Source() can post events. so Source() can post events.
+
+### `std::vector< std::string > net_modules`
+
+📍 [tui.hpp:104](../../../../src/tui/tui.hpp#L104)
+
+### `int net_module_idx`
+
+📍 [tui.hpp:105](../../../../src/tui/tui.hpp#L105)
+
+### `std::string net_sig_filter`
+
+📍 [tui.hpp:106](../../../../src/tui/tui.hpp#L106)
+
+### `std::vector< std::string > net_sigs`
+
+📍 [tui.hpp:107](../../../../src/tui/tui.hpp#L107)
+
+rebuilt every frame from filter
+
+### `int net_sig_idx`
+
+📍 [tui.hpp:108](../../../../src/tui/tui.hpp#L108)
+
+### `int net_focus_idx`
+
+📍 [tui.hpp:109](../../../../src/tui/tui.hpp#L109)
+
+### `std::vector< std::string > settype_modules`
+
+📍 [tui.hpp:112](../../../../src/tui/tui.hpp#L112)
+
+### `int settype_m_idx`
+
+📍 [tui.hpp:113](../../../../src/tui/tui.hpp#L113)
+
+### `std::string settype_p_filter`
+
+📍 [tui.hpp:114](../../../../src/tui/tui.hpp#L114)
+
+### `std::vector< std::string > settype_p_list`
+
+📍 [tui.hpp:115](../../../../src/tui/tui.hpp#L115)
+
+### `int settype_p_idx`
+
+📍 [tui.hpp:116](../../../../src/tui/tui.hpp#L116)
+
+### `std::string settype_type`
+
+📍 [tui.hpp:117](../../../../src/tui/tui.hpp#L117)
+
+### `std::string settype_status`
+
+📍 [tui.hpp:118](../../../../src/tui/tui.hpp#L118)
+
+### `int settype_focus_idx`
+
+📍 [tui.hpp:119](../../../../src/tui/tui.hpp#L119)
+
+## Public Functions
+
+### `Tui()`
+
+📍 [tui.hpp:122](../../../../src/tui/tui.hpp#L122)
+
+### `~Tui()`
+
+📍 [tui.hpp:123](../../../../src/tui/tui.hpp#L123)
+
+### `void Run()`
+
+📍 [tui.hpp:124](../../../../src/tui/tui.hpp#L124)
+
+## Private Functions
+
+### `void RegisterCommands()`
+
+📍 [tui.hpp:128](../../../../src/tui/tui.hpp#L128)
+
+### `void Print(const std::string &line)`
+
+📍 [tui.hpp:131](../../../../src/tui/tui.hpp#L131)
+
+### `void Submit()`
+
+📍 [tui.hpp:132](../../../../src/tui/tui.hpp#L132)
+
+### `void Dispatch(const std::string &raw)`
+
+📍 [tui.hpp:133](../../../../src/tui/tui.hpp#L133)
+
+### `void Finalize(const std::string &name, const CommandSpec &spec, const std::vector< std::string > &args)`
+
+📍 [tui.hpp:134](../../../../src/tui/tui.hpp#L134)
+
+### `void HistoryUp()`
+
+📍 [tui.hpp:137](../../../../src/tui/tui.hpp#L137)
+
+### `void HistoryDown()`
+
+📍 [tui.hpp:138](../../../../src/tui/tui.hpp#L138)
+
+### `void CancelPending()`
+
+📍 [tui.hpp:139](../../../../src/tui/tui.hpp#L139)
+
+### `void LoadHistory()`
+
+📍 [tui.hpp:140](../../../../src/tui/tui.hpp#L140)
+
+### `void AppendHistory(const std::string &cmd)`
+
+📍 [tui.hpp:141](../../../../src/tui/tui.hpp#L141)
+
+### `void Source(const std::string &filename)`
+
+📍 [tui.hpp:142](../../../../src/tui/tui.hpp#L142)
+
+### `void ProcessNextSourceLine()`
+
+📍 [tui.hpp:143](../../../../src/tui/tui.hpp#L143)
+
+### `std::string ExpandVars(const std::string &s) const`
+
+📍 [tui.hpp:144](../../../../src/tui/tui.hpp#L144)
+
+### `void CompleteCommand(size_t start=0)`
+
+📍 [tui.hpp:147](../../../../src/tui/tui.hpp#L147)
+
+### `void CompletePath(size_t start=0)`
+
+📍 [tui.hpp:148](../../../../src/tui/tui.hpp#L148)
+
+### `void CompleteInline()`
+
+📍 [tui.hpp:149](../../../../src/tui/tui.hpp#L149)
+
+### `void RefreshFilteredPartList(const std::vector< std::string > &modules, int m_idx, const std::string &filter, std::vector< std::string > &out, int &sel_idx)`
+
+📍 [tui.hpp:152](../../../../src/tui/tui.hpp#L152)
+
+### `ftxui::Component BuildMainScreen(ftxui::ScreenInteractive &screen)`
+
+📍 [tui.hpp:159](../../../../src/tui/tui.hpp#L159)
+
+### `ftxui::Component BuildSearchScreen()`
+
+📍 [tui.hpp:160](../../../../src/tui/tui.hpp#L160)
+
+### `ftxui::Component BuildConnectScreen()`
+
+📍 [tui.hpp:161](../../../../src/tui/tui.hpp#L161)
+
+### `ftxui::Component BuildSettypeScreen()`
+
+📍 [tui.hpp:162](../../../../src/tui/tui.hpp#L162)
+
+### `ftxui::Component BuildExploreScreen()`
+
+📍 [tui.hpp:163](../../../../src/tui/tui.hpp#L163)
+
+### `ftxui::Component BuildNetScreen()`
+
+📍 [tui.hpp:164](../../../../src/tui/tui.hpp#L164)
+
+---
+
+← [Back to classes](index.md) · [Top](../index.md)