API Reference#

The complete reference for the public API, grouped by concept. Every public class, function, and type has exactly one page here, titled by its full import path — so you can confirm an exact signature, read the full member list, or discover what lives alongside what.

Everything exposed at the top level — every widget, the application shells, reactive Signal state, and the dialog and theme verbs — is public and importable directly as bootstack.<name> (commonly import bootstack as bs). The following submodules are also public; import the names you need from each (e.g. from bootstack.data import col):

  • bootstack.data — Data sources and the col() query language behind tables, lists, and trees.

  • bootstack.events — Event objects and the typed payloads on_* handlers receive.

  • bootstack.streams — Composable event pipelines — debounce, filter, map.

  • bootstack.images — Image handles, themed icons, and application icons.

  • bootstack.style — Color themes, runtime theme switching, and fonts.

  • bootstack.validation — Rules that validate what a user enters.

  • bootstack.i18n — Translatable text and locale-aware formatting.

  • bootstack.scheduling — Running work after a delay or on a repeating interval.

  • bootstack.shortcuts — Registering application keyboard shortcuts.

  • bootstack.store — A small file-backed preferences store.

  • bootstack.errors — The exception types the framework raises.

  • bootstack.types — Token and keyword types for annotating your own code.

  • bootstack.dialogs — Reusable dialog classes, when a one-shot verb isn’t enough.

Everything else is internal. Modules and names beginning with an underscore — _core, _impl, _runtime, and the like — are implementation detail and may change at any time; the public API is exactly what this reference documents.

This is the lookup layer. For task-oriented introductions and worked examples, start from the Widgets catalog and the User Guide, which cross-link into the pages here.

Building the interface#

Application

The app frame — App, AppShell, and secondary windows.

Application
Widgets

Every visual component — actions, inputs, selection controls, data displays, layout containers, and navigation.

Widgets
Reactivity

Signals and event streams — bind application state to widgets and compose change pipelines.

Reactivity
Events

The typed payloads every on_* handler receives.

Events
Dialogs

One-shot prompt verbs (alert, confirm, ask_*) and the dialog classes behind them.

Dialogs

Data and validation#

Data

Data sources, the col() query language, and the file reader/writer registry behind tables, lists, and trees.

Data
Validation

Field validation rules and the results they produce.

Validation

Appearance and locale#

Images

Image handles, theme-aware icons, and generated application icons.

Images
Theming

Color themes, runtime theme switching, and fonts.

Theming
Localization

Translatable strings and locale-aware formatting.

Localization (i18n)

Services and reference#

Scheduling

Run callbacks after a delay or on a repeating interval.

Scheduling
Shortcuts

Register and query application keyboard shortcuts.

Shortcuts
Storage

A persistent, file-backed preferences store.

Storage
Errors

The exception types bootstack raises.

Errors
Types

Token and keyword types for annotating your own code.

Types