bootstack 0.1.0a10__tar.gz → 0.1.0a11__tar.gz

{bootstack-0.1.0a10/src/bootstack.egg-info → bootstack-0.1.0a11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a10
+Version: 0.1.0a11
 Summary: From idea to a shipped desktop app, fast — a declarative, reactive, batteries-included Python UI framework with 60+ widgets, semantic theming, and built-in packaging.
 Author-email: Israel Dryer <israel.dryer@gmail.com>
 License-Expression: MIT
@@ -134,7 +134,7 @@ app.run()
   <img alt="bootstack quick start example" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-quickstart-light.png">
 </picture>
 
-For navigation-based apps, use `AppShell` — it gives you a command bar, sidebar, and page stack in one call:
+For navigation-based apps, use `AppShell` — it gives you stacked toolbars, a sidebar, and a page stack in one call:
 
 ```python
 import bootstack as bs
@@ -225,13 +225,13 @@ app.run()
 
 | Category | Widgets |
 |----------|---------|
-| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, CommandBar |
+| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, Toolbar |
 | **Inputs** | TextField, PasswordField, PathField, NumberField, SpinnerField, Slider, RangeSlider, TextArea, CodeEditor, DateField, TimeField |
 | **Selection** | Checkbox, Switch, ToggleButton, Radio, RadioGroup, ToggleGroup, Select, SelectButton, Calendar |
 | **Data Display** | Label, Badge, ListView, Tree, DataTable, ProgressBar, Gauge |
 | **Media** | Avatar, Picture, Gallery, Carousel |
 | **Layout** | VStack, HStack, Grid, Card, GroupBox, SplitView, ScrollView, Accordion, Separator |
-| **Navigation** | AppShell, CommandBar, SideNav, StatusBar, Tabs, PageStack |
+| **Navigation** | AppShell, SideNav, StatusBar, Tabs, PageStack |
 | **Dialogs** | `alert()`, `confirm()`, `ask_*()` prompts, FormDialog, FontDialog, FilterDialog |
 | **Overlays** | `toast()`, Notification, Snackbar, Tooltip |
 | **Forms** | Form, with field-level validation |

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/README.md

@@ -89,7 +89,7 @@ app.run()
   <img alt="bootstack quick start example" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-quickstart-light.png">
 </picture>
 
-For navigation-based apps, use `AppShell` — it gives you a command bar, sidebar, and page stack in one call:
+For navigation-based apps, use `AppShell` — it gives you stacked toolbars, a sidebar, and a page stack in one call:
 
 ```python
 import bootstack as bs
@@ -180,13 +180,13 @@ app.run()
 
 | Category | Widgets |
 |----------|---------|
-| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, CommandBar |
+| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, Toolbar |
 | **Inputs** | TextField, PasswordField, PathField, NumberField, SpinnerField, Slider, RangeSlider, TextArea, CodeEditor, DateField, TimeField |
 | **Selection** | Checkbox, Switch, ToggleButton, Radio, RadioGroup, ToggleGroup, Select, SelectButton, Calendar |
 | **Data Display** | Label, Badge, ListView, Tree, DataTable, ProgressBar, Gauge |
 | **Media** | Avatar, Picture, Gallery, Carousel |
 | **Layout** | VStack, HStack, Grid, Card, GroupBox, SplitView, ScrollView, Accordion, Separator |
-| **Navigation** | AppShell, CommandBar, SideNav, StatusBar, Tabs, PageStack |
+| **Navigation** | AppShell, SideNav, StatusBar, Tabs, PageStack |
 | **Dialogs** | `alert()`, `confirm()`, `ask_*()` prompts, FormDialog, FontDialog, FilterDialog |
 | **Overlays** | `toast()`, Notification, Snackbar, Tooltip |
 | **Forms** | Form, with field-level validation |

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.0a10"
+version = "0.1.0a11"
 description = "From idea to a shipped desktop app, fast — a declarative, reactive, batteries-included Python UI framework with 60+ widgets, semantic theming, and built-in packaging."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -100,7 +100,7 @@ where = ["src"]
 ]
 
 [tool.bumpversion]
-current_version = "0.1.0a10"
+current_version = "0.1.0a11"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)((?P<pre>a|b|rc)(?P<pre_n>\\d+))?"
 serialize = [
     "{major}.{minor}.{patch}{pre}{pre_n}",

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/__init__.py

@@ -63,6 +63,7 @@ from bootstack.widgets.window import Window
 from bootstack.widgets.stacks import HStack, VStack
 from bootstack.widgets.grid import Grid
 from bootstack.widgets.boolean_controls import Checkbox, Switch, ToggleButton
+from bootstack.widgets.theme_toggle import ThemeToggle
 from bootstack.widgets.button import Button
 from bootstack.widgets.card import Card
 from bootstack.widgets.buttongroup import ButtonGroup
@@ -101,7 +102,7 @@ from bootstack.widgets.tree import Tree, TreeNode
 from bootstack.widgets.textfield import TextField
 from bootstack.widgets.toast import toast, Notification, Snackbar, snackbar
 from bootstack.widgets.togglegroup import ToggleGroup
-from bootstack.widgets.commandbar import CommandBar
+from bootstack.widgets.toolbar import Toolbar
 from bootstack.widgets.statusbar import StatusBar
 from bootstack.widgets.tooltip import Tooltip
 
@@ -131,7 +132,7 @@ __all__ = [
     "HStack", "VStack", "Grid", "Card", "GroupBox", "Separator", "ScrollView",
     "SplitView", "SplitPane", "Accordion", "AccordionSection",
     # Actions
-    "Button", "ButtonGroup", "MenuButton", "CommandBar", "StatusBar",
+    "Button", "ButtonGroup", "ThemeToggle", "MenuButton", "Toolbar", "StatusBar",
     "ContextMenu", "ContextMenuItem",
     # Inputs
     "TextField", "PasswordField", "NumberField", "PathField", "SpinnerField",

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/_core/__init__.py

@@ -4,14 +4,9 @@ from __future__ import annotations
 
 from . import colorutils, publisher, capabilities
 from bootstack._core.exceptions import (
-    TTKBootstrapError,
-    LayoutError,
     ThemeError,
-    ConfigError,
-    StateError,
     NavigationError,
-    BootstyleBuilderError,
-    BootstyleParsingError,
+    StyleBuilderError,
     ConfigurationWarning,
 )
 
@@ -19,13 +14,8 @@ __all__ = [
     "colorutils",
     "publisher",
     "capabilities",
-    "TTKBootstrapError",
-    "LayoutError",
     "ThemeError",
-    "ConfigError",
-    "StateError",
     "NavigationError",
-    "BootstyleBuilderError",
-    "BootstyleParsingError",
+    "StyleBuilderError",
     "ConfigurationWarning",
-]
+]

bootstack-0.1.0a11/src/bootstack/_core/exceptions.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+# These are defined in the public `bootstack.errors` home and re-exported here
+# for the internal call sites that import from `bootstack._core`.
+from bootstack.errors import (
+    NavigationError,
+    StyleBuilderError,
+    ThemeError,
+)
+
+
+class ConfigurationWarning(Warning):
+    """Issued when a widget receives a deprecated or questionable configuration option.
+
+    Examples: supplying an unsupported value for a configuration key, or
+    passing mutually exclusive options.
+    """
+
+
+__all__ = [
+    "ConfigurationWarning",
+    "NavigationError",
+    "StyleBuilderError",
+    "ThemeError",
+]

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/_runtime/tk_patch.py

@@ -9,7 +9,7 @@ from __future__ import annotations
 
 import tkinter as tk
 
-from bootstack.style.bootstyle import Bootstyle
+from bootstack.style.style_resolver import StyleResolver
 
 # Native Tk widget classes whose constructors get the autostyle wrapper.
 # Limited to the raw Tk widgets the framework actually instantiates or
@@ -26,7 +26,7 @@ _TK_WIDGETS = (
 
 
 def install_tk_autostyle() -> None:
-    """Patch Tk widgets to enable autostyle via Bootstyle.
+    """Patch Tk widgets to enable autostyle via StyleResolver.
 
     - Wraps Tk widget `__init__` with surface color inheritance and theme
       background application using registered Tk builders.
@@ -36,7 +36,7 @@ def install_tk_autostyle() -> None:
     import bootstack.style.builders_tk  # noqa: F401
 
     for widget in _TK_WIDGETS:
-        _init = Bootstyle.override_tk_widget_constructor(widget.__init__)
+        _init = StyleResolver.override_tk_widget_constructor(widget.__init__)
         widget.__init__ = _init
 
 

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/_runtime/utility.py

@@ -283,11 +283,11 @@ def scale_size(widget=None, size=None):
 def _debug_enabled() -> bool:
     """Return True if debug logging is enabled.
 
-    Controlled via the environment variable `TTKBOOTSTRAP_DEBUG`.
+    Controlled via the environment variable `BOOTSTACK_DEBUG`.
     Accepts: "1", "true", "yes" (case-insensitive) as truthy values.
     """
     import os
-    return str(os.environ.get("TTKBOOTSTRAP_DEBUG", "")).lower() in {"1", "true", "yes"}
+    return str(os.environ.get("BOOTSTACK_DEBUG", "")).lower() in {"1", "true", "yes"}
 
 
 def debug_log_exception(message: str = "") -> None:
@@ -301,7 +301,7 @@ def debug_log_exception(message: str = "") -> None:
     try:
         import traceback
         if message:
-            print(f"TTKBootstrap DEBUG: {message}")
+            print(f"bootstack DEBUG: {message}")
         traceback.print_exc()
     except Exception:
         # Never raise from debug logging

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/cli/appicon.py

@@ -9,6 +9,7 @@ from __future__ import annotations
 import argparse
 
 from bootstack.widgets.types import IconSpec
+from bootstack.clipboard import set_clipboard
 
 
 def add_parser(subparsers: argparse._SubParsersAction) -> None:
@@ -266,7 +267,7 @@ def run_appicon() -> None:
             f'foreground = "{fg_sig()}"\n'
             f"radius = {round(radius_sig(), 3)}\n"
         )
-        app.set_clipboard(snippet)
+        set_clipboard(snippet)
         status_sig.set("Copied [build.icon] snippet to the clipboard.")
 
     _build_preview()

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/cli/demo.py

@@ -751,7 +751,7 @@ def _build_theme_page():
 
             with bs.HStack(gap=8):
                 bs.Label("Quick:", width=10)
-                bs.Button("Toggle Light / Dark", on_click=bs.toggle_theme)
+                bs.ThemeToggle()
 
         with bs.GroupBox("Accent Colors", fill="horizontal"):
             with bs.HStack(gap=4, fill="horizontal", fill_items="horizontal", expand_items=True):
@@ -807,20 +807,116 @@ def _build_media_page():
             bs.Picture(photos[1]["image"], width=180, height=120, fit="contain")
             bs.Picture(photos[2]["image"], width=120, height=120, fit="cover", corner_radius=60)
 
-        with bs.GroupBox("Gallery", fill="both", expand=True):
-            bs.Gallery(items=photos, image_field="image", caption_field="title",
-                       tile_size=(120, 120), fill="both", expand=True)
-
         with bs.GroupBox("Carousel", fill="horizontal"):
             bs.Carousel(items=photos, image_field="image", caption_field="title",
                         fit="cover", fill="horizontal")
 
+        # Gallery last: it scrolls internally and swallows the wheel event, so
+        # keeping it at the bottom leaves the carousel/picture rows above it as
+        # places to grab and scroll the page itself.
+        with bs.GroupBox("Gallery", fill="both", expand=True):
+            bs.Gallery(items=photos, image_field="image", caption_field="title",
+                       tile_size=(120, 120), fill="both", expand=True)
+
 
 # =============================================================================
 # Gallery app
 # =============================================================================
 
 
+def build_gallery_shell(shell) -> None:
+    """Populate a Widget Gallery `AppShell` (toolbar, status bar, and pages).
+
+    Shared by `run_demo()` and the docs gallery screenshot so the captured
+    gallery always matches the live demo. Pages are lazy-built on first visit.
+    """
+    with shell.add_toolbar() as bar:
+        with bar.add_menu("File") as file_menu:
+            file_menu.add_action("Quit", shortcut="Mod+Q", on_click=shell.close)
+        with bar.add_menu("View") as view_menu:
+            view_menu.add_action("Toggle theme", on_click=bs.toggle_theme)
+        bar.add_spacer()
+        bar.add_theme_toggle()
+
+    shell.statusbar.add_text("Ready")
+    shell.statusbar.add_spacer()
+    shell.statusbar.add_text(f"bootstack v{bs.__version__}")
+
+    # Page registry: key → (page_frame, builder)
+    _pages: dict[str, tuple[object, object]] = {}
+
+    def _register(key, builder, *, text, icon, scrollable=False):
+        page = shell.add_page(key, text=text, icon=icon, scrollable=scrollable)
+        _pages[key] = (page, builder)
+
+    _register("home",       _build_home_page,       text="Home",        icon="house")
+
+    shell.add_separator()
+    shell.add_header("Actions")
+    _register("buttons",    _build_buttons_page,    text="Buttons",     icon="hand-index-thumb",   scrollable=True)
+
+    shell.add_separator()
+    shell.add_header("Inputs")
+    _register("text-inputs",  _build_text_inputs_page,  text="Text Inputs",  icon="input-cursor-text", scrollable=True)
+    _register("numeric",      _build_numeric_page,      text="Numeric & Date", icon="123",             scrollable=True)
+    _register("forms",        _build_forms_page,        text="Forms",        icon="journal-text",      scrollable=True)
+    _register("code-editor",  _build_code_editor_page,  text="Code Editor",  icon="code-slash",        scrollable=True)
+
+    shell.add_separator()
+    shell.add_header("Selection")
+    _register("selection",  _build_selection_page,  text="Selection",   icon="ui-checks",          scrollable=True)
+    _register("calendar",   _build_calendar_page,   text="Calendar",    icon="calendar3",          scrollable=True)
+
+    shell.add_separator()
+    shell.add_header("Data Display")
+    _register("data",       _build_data_page,       text="Data Tables", icon="table",              scrollable=True)
+    _register("progress",   _build_progress_page,   text="Progress",    icon="speedometer2",       scrollable=True)
+
+    shell.add_separator()
+    shell.add_header("Media")
+    _register("media",      _build_media_page,      text="Media",       icon="images",             scrollable=True)
+
+    shell.add_separator()
+    shell.add_header("Layout")
+    _register("layout",     _build_layout_page,     text="Containers",  icon="layout-wtf",         scrollable=True)
+    _register("navigation", _build_navigation_page, text="Navigation",  icon="window-stack",       scrollable=True)
+
+    shell.add_separator()
+    shell.add_header("Overlays & Dialogs")
+    _register("overlays",   _build_overlays_page,   text="Overlays",    icon="layers",             scrollable=True)
+    _register("dialogs",    _build_dialogs_page,    text="Dialogs",     icon="chat-square-text",   scrollable=True)
+
+    shell.add_separator()
+    shell.add_header("Design System")
+    _register("themes",     _build_theme_page,      text="Themes",      icon="palette",            scrollable=True)
+    _register("typography", _build_typography_page, text="Typography",  icon="fonts",              scrollable=True)
+    _register("icons",      _build_icons_page,      text="Icons",       icon="grid-3x3-gap",       scrollable=True)
+
+    # Lazy-build: construct page content only on first visit
+    _built: set[str] = set()
+
+    def _build_page(key: str) -> None:
+        if key in _built or key not in _pages:
+            return
+        page, builder = _pages[key]
+        with page:
+            builder()
+        _built.add(key)
+
+    # Build home page immediately; all others on first navigation
+    _build_page("home")
+
+    def _on_page_change(event) -> None:
+        # on_page_change delivers a PageChangeEvent (unpacked); .page is the
+        # key of the now-active page.
+        key = getattr(event, "page", None)
+        if key:
+            _build_page(key)
+
+    shell.on_page_change(_on_page_change)
+    shell.navigate("home")
+
+
 def run_demo():
     """Run the bootstack widget gallery as an AppShell application."""
     with bs.AppShell(
@@ -828,89 +924,7 @@ def run_demo():
         theme="bootstrap-light",
         size=(1100, 750),
     ) as shell:
-
-        shell.commandbar.add_label("Widget Gallery")
-        shell.commandbar.add_spacer()
-        shell.commandbar.add_button(icon="circle-half", on_click=bs.toggle_theme)
-
-        shell.statusbar.add_text("Ready")
-        shell.statusbar.add_spacer()
-        shell.statusbar.add_text(f"bootstack v{bs.__version__}")
-
-        # Page registry: key → (page_frame, builder)
-        _pages: dict[str, tuple[object, object]] = {}
-
-        def _register(key, builder, *, text, icon, scrollable=False):
-            page = shell.add_page(key, text=text, icon=icon, scrollable=scrollable)
-            _pages[key] = (page, builder)
-
-        _register("home",       _build_home_page,       text="Home",        icon="house")
-
-        shell.add_separator()
-        shell.add_header("Actions")
-        _register("buttons",    _build_buttons_page,    text="Buttons",     icon="hand-index-thumb",   scrollable=True)
-
-        shell.add_separator()
-        shell.add_header("Inputs")
-        _register("text-inputs",  _build_text_inputs_page,  text="Text Inputs",  icon="input-cursor-text", scrollable=True)
-        _register("numeric",      _build_numeric_page,      text="Numeric & Date", icon="123",             scrollable=True)
-        _register("forms",        _build_forms_page,        text="Forms",        icon="journal-text",      scrollable=True)
-        _register("code-editor",  _build_code_editor_page,  text="Code Editor",  icon="code-slash",        scrollable=True)
-
-        shell.add_separator()
-        shell.add_header("Selection")
-        _register("selection",  _build_selection_page,  text="Selection",   icon="ui-checks",          scrollable=True)
-        _register("calendar",   _build_calendar_page,   text="Calendar",    icon="calendar3",          scrollable=True)
-
-        shell.add_separator()
-        shell.add_header("Data Display")
-        _register("data",       _build_data_page,       text="Data Tables", icon="table",              scrollable=True)
-        _register("progress",   _build_progress_page,   text="Progress",    icon="speedometer2",       scrollable=True)
-
-        shell.add_separator()
-        shell.add_header("Media")
-        _register("media",      _build_media_page,      text="Media",       icon="images",             scrollable=True)
-
-        shell.add_separator()
-        shell.add_header("Layout")
-        _register("layout",     _build_layout_page,     text="Containers",  icon="layout-wtf",         scrollable=True)
-        _register("navigation", _build_navigation_page, text="Navigation",  icon="window-stack",       scrollable=True)
-
-        shell.add_separator()
-        shell.add_header("Overlays & Dialogs")
-        _register("overlays",   _build_overlays_page,   text="Overlays",    icon="layers",             scrollable=True)
-        _register("dialogs",    _build_dialogs_page,    text="Dialogs",     icon="chat-square-text",   scrollable=True)
-
-        shell.add_separator()
-        shell.add_header("Design System")
-        _register("themes",     _build_theme_page,      text="Themes",      icon="palette",            scrollable=True)
-        _register("typography", _build_typography_page, text="Typography",  icon="fonts",              scrollable=True)
-        _register("icons",      _build_icons_page,      text="Icons",       icon="grid-3x3-gap",       scrollable=True)
-
-        # Lazy-build: construct page content only on first visit
-        _built: set[str] = set()
-
-        def _build_page(key: str) -> None:
-            if key in _built or key not in _pages:
-                return
-            page, builder = _pages[key]
-            with page:
-                builder()
-            _built.add(key)
-
-        # Build home page immediately; all others on first navigation
-        _build_page("home")
-
-        def _on_page_change(event) -> None:
-            # on_page_change delivers a PageChangeEvent (unpacked); .page is the
-            # key of the now-active page.
-            key = getattr(event, "page", None)
-            if key:
-                _build_page(key)
-
-        shell.on_page_change(_on_page_change)
-        shell.navigate("home")
-
+        build_gallery_shell(shell)
     shell.run()
 
 

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/cli/templates/__init__.py

@@ -290,20 +290,20 @@ Application settings are defined in `bootstack.toml`:
 # =============================================================================
 
 def _appshell_chrome(app_name: str) -> str:
-    """The shared menu bar, command bar, and status bar baseline for AppShell
+    """The shared toolbar (menus + commands) and status bar baseline for AppShell
     scaffolds. Delete what you do not need."""
     return f'''\
-        # --- Menu bar -------------------------------------------------------
-        with shell.menubar.add_menu("File") as file_menu:
-            file_menu.add_action("Quit", shortcut="Mod+Q", on_click=shell.close)
-        with shell.menubar.add_menu("Help") as help_menu:
-            help_menu.add_action(
-                "About",
-                on_click=lambda: bs.alert("{app_name}", title="About"),
-            )
-
-        # --- Command bar ----------------------------------------------------
-        shell.commandbar.add_button(icon="circle-half", on_click=bs.toggle_theme)
+        # --- Toolbar (menus + commands) -------------------------------------
+        with shell.add_toolbar() as bar:
+            with bar.add_menu("File") as file_menu:
+                file_menu.add_action("Quit", shortcut="Mod+Q", on_click=shell.close)
+            with bar.add_menu("Help") as help_menu:
+                help_menu.add_action(
+                    "About",
+                    on_click=lambda: bs.alert("{app_name}", title="About"),
+                )
+            bar.add_spacer()
+            bar.add_theme_toggle()
 
         # --- Status bar -----------------------------------------------------
         shell.statusbar.add_text("Ready")
@@ -536,7 +536,7 @@ class SettingsPage:
         with bs.GroupBox("Preferences", fill="both", expand=True):
             with bs.HStack(gap=8):
                 bs.Label("Theme:")
-                bs.Button("Toggle Light / Dark", on_click=bs.toggle_theme)
+                bs.ThemeToggle()
 '''
 
 

bootstack-0.1.0a11/src/bootstack/clipboard.py

@@ -0,0 +1,48 @@
+"""System clipboard helpers.
+
+The clipboard is global to the running application, so these are module-level
+functions rather than per-widget methods. They operate on the current `App`'s
+clipboard, so **an `App` must exist when they are called** (i.e. call them from
+within your app's runtime, not at import time).
+
+    from bootstack.clipboard import get_clipboard, set_clipboard
+
+    set_clipboard("hello")
+    text = get_clipboard()
+
+Platform note: on Linux/X11 the clipboard is owned by the running process, so its
+contents are cleared when the `App` exits unless a system clipboard manager is
+running. On Windows and macOS the operating system owns the clipboard, so contents
+persist after the app closes.
+"""
+
+from __future__ import annotations
+
+from bootstack._runtime.app import get_current_app
+
+__all__ = ["get_clipboard", "set_clipboard"]
+
+
+def set_clipboard(text: str) -> None:
+    """Replace the system clipboard contents with `text`.
+
+    Args:
+        text: The text to place on the clipboard.
+
+    Raises:
+        RuntimeError: If called when no `App` is running.
+    """
+    get_current_app().clipboard_set(text)
+
+
+def get_clipboard() -> str:
+    """Return the current text contents of the system clipboard.
+
+    Returns:
+        The clipboard text, or an empty string when the clipboard is empty,
+        holds non-text data, or no `App` is running.
+    """
+    try:
+        return get_current_app().clipboard_get()
+    except Exception:
+        return ""

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/constants.py

@@ -32,7 +32,6 @@ from bootstack.widgets.types import (
     Sticky,
     AccentToken,
     SurfaceToken,
-    VariantToken,
     WidgetDensity,
     WidgetState,
 )
@@ -276,7 +275,7 @@ INDETERMINATE: Final[ProgressMode] = 'indeterminate'
 __all__ = [
     # Re-exported type aliases (canonical source: bootstack.widgets.types)
     'Anchor', 'AccentToken', 'BorderMode', 'CompoundMode', 'Fill', 'Justify',
-    'Orient', 'Relief', 'Side', 'Sticky', 'SurfaceToken', 'VariantToken',
+    'Orient', 'Relief', 'Side', 'Sticky', 'SurfaceToken',
     'WidgetDensity', 'WidgetState',
     # Literal types canonical to this module
     'ActiveStyle', 'Align', 'IndexPos', 'LineJoin', 'LineCap', 'MenuItemType',

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/dialogs/_impl/dialog.py

@@ -15,7 +15,7 @@ from typing import Any, Callable, Iterable, Literal, Mapping, Optional, Tuple, T
 from bootstack.widgets._impl.primitives.button import Button as _Button
 from bootstack.widgets._impl.primitives.frame import Frame as _Frame
 from bootstack.widgets._impl.primitives.separator import Separator as _Separator
-from bootstack.widgets.types import Master, AccentToken, VariantToken, SurfaceToken, WindowStyle
+from bootstack.widgets.types import Master, AccentToken, ButtonVariant, SurfaceToken, WindowStyle
 from bootstack._runtime.toplevel import Toplevel
 from bootstack._runtime.window_utilities import AnchorPoint, WindowPositioning
 
@@ -56,8 +56,8 @@ class DialogButton:
     accent: AccentToken | str | None = None
     """Accent token for styling (e.g. `'primary'`, `'danger'`)."""
 
-    variant: VariantToken | str | None = None
-    """Style variant (e.g. `'outline'`, `'link'`)."""
+    variant: ButtonVariant | str | None = None
+    """Button style variant — `'default'`, `'solid'`, `'outline'`, or `'ghost'`."""
 
     icon: str | dict[str, Any] | None = None  # passed straight to _Button(icon=...)
     """Optional icon specification for the button."""

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/dialogs/_impl/message.py

@@ -49,14 +49,14 @@ class MessageDialog:
         Args:
             message: The message text to display. Supports multiline strings.
             title: The dialog window title.
-            buttons: List of button labels. Can specify color as "label:color".
-                If None, defaults to ["Cancel", "OK"]. Legacy "bootstyle" syntax
-                is still supported (e.g., "OK:primary").
+            buttons: List of button labels. Can specify an accent as
+                "label:accent" (e.g., "OK:primary"). If None, defaults to
+                ["Cancel", "OK"].
             command: Optional callback function to execute when any button is pressed.
             width: Maximum width in characters for text wrapping.
             master: Parent widget for the dialog.
             alert: If True, rings the system bell when shown.
-            default: The button label to use as default. Receives primary bootstyle and focus.
+            default: The button label to use as default. Receives the primary accent and focus.
             padding: Padding around the message content.
             icon: Optional icon specification. Can be a string (icon name) or dict with
                 keys: 'name' (required), 'size' (default 32), 'color' (optional).
@@ -139,7 +139,7 @@ class MessageDialog:
         button_specs: List[DialogButton] = []
 
         for i, button in enumerate(button_labels):
-            # Parse "text:bootstyle" format
+            # Parse "text:accent" format
             cnf = button.split(":")
             text = cnf[0]
 

{bootstack-0.1.0a10 → bootstack-0.1.0a11}/src/bootstack/errors.py

@@ -31,10 +31,37 @@ class SerializationError(BootstackError):
     """
 
 
+class NavigationError(BootstackError):
+    """Raised when a navigation operation references a wrong key.
+
+    Examples: adding a page, tab, or workspace whose key already exists, or
+    selecting, looking up, or removing one whose key does not exist.
+    """
+
+
+class ThemeError(BootstackError):
+    """Raised when a theme-related operation fails.
+
+    Examples: requesting an unknown theme name, or loading a malformed theme
+    definition.
+    """
+
+
+class StyleBuilderError(BootstackError):
+    """Raised when a widget style cannot be built.
+
+    Examples: an unsupported `variant` for a widget, or a missing required
+    theme color token.
+    """
+
+
 __all__ = [
     "BootstackError",
     "DuplicateIdError",
+    "NavigationError",
     "ParentResolutionError",
     "SerializationError",
+    "StyleBuilderError",
+    "ThemeError",
     "UnknownEventError",
 ]