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.clipboard — Read and write the system clipboard.

  • 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
Clipboard

Read and write the system clipboard.

Clipboard
Errors

The exception types bootstack raises.

Errors
Types

Token and keyword types for annotating your own code.

Types
Developer Tools

Hot reload for the development loop (provisional).

Developer Tools