Widgets & Modules

A reference of every public header under include/toolkit/ (plus db/ and i18n/), grouped by area. All widget classes live in the toolkit namespace unless noted otherwise.

Linked class names have their own API reference page. Most widgets derive from Widget and share a common base API: set_enabled()/is_enabled(), set_visible()/is_visible()/show()/hide(), set_focusable()/ is_focusable(), set_tooltip(), set_background_color(), rect(), size_hint(), set_min_size()/set_max_size().

Core & application

Header	Provides
application.hpp	Application — event loop, window creation, run()
window.hpp	Window — widget tree root, events, timers, tooltips
widget.hpp	Widget — base class all widgets derive from
platform.hpp	PlatformApplication / PlatformWindow backend interfaces
painter.hpp	Cairo-based Painter drawing API
pixel_format.hpp	Pixel format / surface format definitions
clipboard.hpp	System clipboard access (copy/paste)
events.hpp	MouseEvent, KeyEvent types
types.hpp	Point, Size, Rect, Color, CursorShape, Key
window_title_bar.hpp	Client-side decoration title bar

Layouts

Header	Provides
layout.hpp	Layouts — VBoxLayout, HBoxLayout, GridLayout, StackedLayout, FormLayout

Widgets

Header	Provides
button.hpp	Button
button_group.hpp	ButtonGroup — exclusive/grouped button behavior
label.hpp	Label — multi-line, shrinkable
checkbox.hpp	Checkbox
radio_button.hpp	RadioButton + RadioGroup
combobox.hpp	Combobox — dropdown selection
line_input.hpp	LineInput — single-line text input with selection
text_edit.hpp	TextEdit — multi-line text editor
spin_box.hpp	SpinBox — numeric input
slider.hpp	Slider
progress_bar.hpp	ProgressBar
icon_grid.hpp	IconGrid — grid-of-icons widget
html_view.hpp	HtmlView — Markdown/HTML rendering via litehtml
rich_label.hpp	RichLabel — inline rich text label
image_widget.hpp	ImageWidget — display a bitmap with zoom/pan
toast_widget.hpp	ToastWidget — transient notification popup

Containers & navigation

Header	Provides
tab_widget.hpp	TabWidget — tabbed container
splitter.hpp	Splitter — resizable split panes
scroll_area.hpp	ScrollArea
scrollable_widget.hpp	ScrollableWidget base for scrollable content
scrollbar.hpp	Scrollbar
dock_area.hpp	DockArea — dockable panel layout
status_bar.hpp	StatusBar

Data & views

Header	Provides
item_model.hpp	ItemModel — base data model for views
list_view.hpp	ListView — scrollable list with filterable adapters and async progress
tree_view.hpp	TreeView
table_view.hpp	TableView
file_tree_model.hpp	FileTreeModel — filesystem-backed tree model
file_browser_widget.hpp	FileBrowserWidget

Menus, toolbars & commands

Header	Provides
menubar.hpp	MenuBar
menu.hpp	Menu
context_menu.hpp	ContextMenu — popup context menu
toolbar.hpp	Toolbar
command.hpp	Command — keyboard shortcut / action commands

Dialogs & system integration

Header	Provides
file_dialog.hpp	FileDialog — native or toolkit file picker
directory_dialog.hpp	DirectoryDialog
message_box.hpp	MessageBox
tray_icon.hpp	TrayIcon — system tray integration

Charts (toolkit/charts/)

See the charts overview for the shared data and interaction model.

Header	Provides
line_chart.hpp	LineChart
bar_chart.hpp	BarChart
stacked_bar_chart.hpp	StackedBarChart
area_chart.hpp	AreaChart
pie_chart.hpp	PieChart
scatter_plot.hpp	ScatterPlot
histogram.hpp	Histogram
candlestick_chart.hpp	CandlestickChart
chart_defaults.hpp	Shared default styling/config for charts
chart_interaction.hpp	Zoom/pan/hover interaction helpers

Text & rendering

Header	Provides
text_rasterizer.hpp	TextRasterizer interface (platform-specific glyph rasterization)
text/text_layout.hpp	Text shaping and line-layout
text/bidi.hpp	Bidirectional (RTL/LTR) text support
utf8.hpp	UTF-8 string helpers

html_view.hpp (HtmlView) is listed under Widgets above, since it's a widget you place directly in a UI.

Theming

Header	Provides
theme.hpp	Theme — active theme access
theme_base.hpp	ThemeBase — base class for theme implementations
theme_factory.hpp	Runtime theme selection
theme_macos.hpp	macOS-style theme
theme_win11.hpp	Windows 11-style theme
theme_win95.hpp	Windows 95-style theme
theme_plasma.hpp	Linux/Plasma-style theme

Each theme supports both light and dark color schemes.

Images & icons

Header	Provides
image.hpp	Image — decoded image data
stb_image_loader.hpp	Image loading via STB
xdg_image_loader.hpp	XDG-themed image loading
lunasvg_image_loader.hpp	SVG image loading via lunasvg
xdg_icons.hpp	XDG icon theme lookup (works on Windows/macOS too)
xdg_icon_names.hpp	Standard XDG icon name constants

Data & networking

Header	Provides
db/connection.hpp	SQLite-backed Connection (API designed to support other DBMS)
toolkit/net/http.hpp	Http client

Internationalization

Header	Provides
i18n/catalog.hpp	Catalog — gettext-style translation lookup
i18n/builtin.hpp	Built-in translation catalogs

Utilities

Header	Provides
stopwatch.hpp	Stopwatch — high-resolution timer
undo_stack.hpp	UndoStack
undo_command.hpp	UndoCommand base class
widget_loader.hpp	Dump/reload widget-tree state to and from JSON

---

Header paths are relative to include/toolkit/ unless prefixed otherwise. For platform-backend internals (X11, Win32, Wayland, macOS), see the src/toolkit/platform/ implementation directories in the repository.